Apache HTTP Server Version 2.4
Apache HTTP Server Version 2.4
| : | HTTP |
|---|---|
| : | Base |
| : | asis_module |
| ҽ: | mod_asis.c |
ġ Ϲ HTTP κ ߰ʰ
send-as-is ڵ鷯
Ѵ.
cgi ũƮ nph ũƮ ʰ ̷ǰ ٸ Ư HTTP ڷᵵ ִ.
ſ mime type httpd/send-as-is
ϵ óߴ.
þ ϴ.
Ͽ ϰ send-as-is ڵ鷯
Ѵ.
AddHandler send-as-is asis
ġ .asis Ȯڸ
ʰ Ŭ̾Ʈ . Ŭ̾Ʈ HTTP
ʿϹǷ . Status: ʿϴ.
ڸ HTTP ڵ ̴.
״ Ŭ̾Ʈ ̷¼ǵǾٰ ˸ ̴.
Status: 301 Now where did I leave that URL
Location: http://xyz.abc.com/foo/bar.html
Content-type: text/html
<html>
<head>
<title>Lame excuses'R'us</title>
</head>
<body>
<h1>Fred's exceptionally wonderful page has moved to
<a href="http://xyz.abc.com/foo/bar.html">Joe's</a>
site.
</h1>
</body>
</html>
ڷḦ Ŭ̾Ʈ Date:
Server: ߰ϹǷ, Ͽ
ȵȴ. Last-Modified
߰ ʴ´. Ƹ ؾ
Ѵ.
Apache HTTP サーバ バージョン 2.4
| 説明: | プレーンテキストファイルを用いたグループ承認 |
|---|---|
| ステータス: | Base |
| モジュール識別子: | authz_groupfile_module |
| ソースファイル: | mod_authz_groupfile.c |
| 互換性: | Apache 2.1 以降 |
このモジュールは認証されたユーザがグループのメンバーか
否かによってウェブサイトの一部へのアクセスを許可するか拒否するかの
承認機能を提供します。同様の機能は mod_authz_dbm
によっても提供されています。
| 説明: | 証認に使用するユーザグループの一覧が格納されている、 テキストファイルの名前を設定する |
|---|---|
| 構文: | AuthGroupFile file-path |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Base |
| モジュール: | mod_authz_groupfile |
AuthGroupFile ディレクティブは、
証認に使用するユーザグループの一覧が格納されている、
テキストファイルの名前を設定します。
file-path はグループファイルへのパスです。
絶対パスでなければ、
ServerRoot
からの相対パスとして扱われます。
グループファイル各行は、グループ名、コロン、そして スペース区切りでそのメンバーのユーザ名を記述します。
mygroup: bob joe anne
大きなファイルを探索するのは、非常に効率が悪いという点に
注意してください。そのような場合は、
AuthDBMGroupFile
の方がずっと良い性能を発揮します。
AuthGroupFile は、
ウェブサーバのドキュメントツリーの外側に
保管するようにしてください。
保護しようとしているディレクトリ以下には、置かないで下さい。
そうしないとクライアントが AuthGroupFile を
ダウンロードできてしまう可能性があります。
Apache HTTP サーバ バージョン 2.4
| 説明: | テキストファイルを用いたユーザ認証 |
|---|---|
| ステータス: | Base |
| モジュール識別子: | authn_file_module |
| ソースファイル: | mod_authn_file.c |
| 互換性: | Apache 2.1 以降 |
本モジュールは mod_auth_digest や
mod_auth_basic といった認証フロントエンドに対して、
プレインテキストのパスワードファイル内からユーザを検索することで、
ユーザ認証機能を提供します。似たような機能は mod_authn_dbm
でも提供されています。
mod_auth_basic や mod_auth_digest
を使用する際には、
AuthBasicProvider や
AuthDigestPrivider
で file と指定することでこのモジュールは起動されます。
| 説明: | 認証に使用するユーザとパスワードの一覧が格納されている、 テキストファイルの名前を設定する |
|---|---|
| 構文: | AuthUserFile file-path |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Base |
| モジュール: | mod_authn_file |
AuthUserFile ディレクティブは、
ユーザ認証のためのユーザとパスワードの一覧を格納した
テキストファイルの名前を設定します。file-path
はユーザファイルへのパスです。
もし絶対パスでなければ、
ServerRoot
からの相対パスとして扱われます。
ユーザファイルの各行には、ユーザ名、コロン、
暗号化したパスワードを記述します。
同一ユーザ ID が複数回登録された時は、
mod_authn_file
は最初に見つかったパスワードを使用して認証します。
バイナリ配布の一部としてインストールされるか、
あるいは src/support にある
htpasswd
ユーティリティで、この HTTP 基本認証
用パスワードファイルをメインテナンスします。
詳細は man
ページをご覧頂くとして、簡単には:
初期 ID username で、Filename
というパスワードファイルを生成します。
次のコマンドを発行するとパスワードが要求されます:
htpasswd -c Filename username
パスワードファイル Filename に、username2
を追加したり修正したりします:
htpasswd Filename username2
(訳注: 非常に多くのユーザを登録すると大きなファイルになりますが)
大きなテキストファイルを検索するのは非常に効率が悪い
ということに注意してください。そのような必要のある時は、
AuthDBMUserFile
を代わりに使ってください。
HTTP ダイジェスト認証を使用する場合は、
htpasswd
プログラムでは不十分です。その代わりに
htdigest
を使用してください。ダイジェスト認証用のデータと
基本認証用のデータを同一ファイルに混ぜて保存できない、
ということに注意してください。
AuthUserFile
は、ウェブサーバのドキュメントツリーの外側に保管するようにしてください。
保護しようとしているディレクトリ以下には、置かないで下さい。
そうしないと AuthUserFile は
ダウンロードできてしまいます。
Apache HTTP サーバ バージョン 2.4
標準 Apache 配布にあるすべての Apache のディレクティブの一覧です。 これらは一貫した形式で書かれていて、使われている用語の 用語集 も用意されています。
各ディレクティブの概要を説明した ディレクティブクイックリファレンスも あります。
A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X
Serveur HTTP Apache Version 2.4
| Description: | Module de passerelle UWSGI pour mod_proxy |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_uwsgi_module |
| Fichier Source: | mod_proxy_uwsgi.c |
| Compatibilité: | Disponible à partir de la version 2.4.30 du serveur HTTP Apache. |
Pour pouvoir fonctionner, ce module requiert le chargement préalable de
mod_proxy. Il fournit le support du protocole
UWSGI.
Pour être en mesure de gérer le protocole UWSGI, le serveur doit donc
pouvoir disposer des modules mod_proxy et
mod_proxy_uwsgi.
N'activez le mandatement que si vous avez sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux pour votre réseau, mais aussi pour Internet en général.
Ce module ne fournit aucune directive.
Il est rappelé que vous devez charger les modules
mod_proxy et mod_proxy_uwsgi pour que les
exemples suivants fonctionnent.
ProxyPass "/uwsgi-bin/" "uwsgi://localhost:4000/"
La passerelle à répartition de charge nécessite
mod_proxy_balancer et au moins un module implémentant un
algorithme de répartition de charge comme
mod_lbmethod_byrequests, en plus des modules de mandatement
listés ci-dessus. Par défaut, c'est mod_lbmethod_byrequests
qui sera utilisé, et c'est donc ce dernier qui sera utilisé dans l'exemple
suivant :
ProxyPass "/uwsgi-bin/" "balancer://somecluster/"
<Proxy balancer://somecluster>
BalancerMember uwsgi://localhost:4000
BalancerMember uwsgi://localhost:4001
</Proxy>
Apache HTTP サーバ バージョン 2.4
| 説明: | ユーザ承認 |
|---|---|
| ステータス: | Base |
| モジュール識別子: | authz_user_module |
| ソースファイル: | mod_authz_user.c |
| 互換性: | Apache 2.1 以降で使用可能 |
このモジュールは、認証されたユーザにウェブサイトの一部への
アクセスを許可したり拒否したりするための承認機能を提供します。
mod_authz_user は認証されたユーザが
Require user ディレクティブに書かれていれば
アクセスを認めます。認証に成功したユーザすべてにアクセスを
許可するには、代わりに Require valid-user を
使うことができます。
このモジュールにディレクティブはありません。
Apache HTTP Server Version 2.4
| Description: | Support for the HTTP/2 transport layer |
|---|---|
| Status: | Extension |
| Module Identifier: | http2_module |
| Source File: | mod_http2.c |
| Compatibility: | Available in version 2.4.17 and later |
This module provides HTTP/2 (RFC 7540) support for the Apache HTTP Server.
This module relies on libnghttp2 to provide the core http/2 engine.
You must enable HTTP/2 via Protocols
in order to use the functionality described in this document. The
HTTP/2 protocol does not require the use of encryption so two schemes are available:
h2 (HTTP/2 over TLS) and h2c (HTTP/2 over TCP).
Two useful configuration schemes are:
Protocols h2 http/1.1
Allows HTTP/2 negotiation (h2) via TLS ALPN in a secure
<VirtualHost>.
HTTP/2 preamble checking (Direct mode, see H2Direct) is disabled by default for h2.
Protocols h2 h2c http/1.1
Allows HTTP/2 negotiation (h2) via TLS ALPN for secure
<VirtualHost>. Allows
HTTP/2 cleartext negotiation (h2c) upgrading from an initial HTTP/1.1
connection or via HTTP/2 preamble checking (Direct mode, see
H2Direct).
Refer to the official HTTP/2 FAQ for any doubt about the protocol.
H2CopyFiles H2Direct H2EarlyHint H2EarlyHints H2MaxDataFrameLen H2MaxHeaderBlockLen H2MaxSessionStreams H2MaxWorkerIdleSeconds H2MaxWorkers H2MinWorkers H2ModernTLSOnly H2OutputBuffering H2Padding H2ProxyRequests H2Push H2PushDiarySize H2PushPriority H2PushResource H2SerializeHeaders H2StreamMaxMemSize H2StreamTimeout H2TLSCoolDownSecs H2TLSWarmUpSize H2Upgrade H2WebSockets H2WindowSizeEnabling HTTP/2 on your Apache Server has impact on the resource consumption and if you have a busy site, you may need to consider carefully the implications.
The first noticeable thing after enabling HTTP/2 is that your server processes will start additional threads. The reason for this is that HTTP/2 gives all requests that it receives to its own Worker threads for processing, collects the results and streams them out to the client.
In the current implementation, these workers use a separate thread
pool from the MPM workers that you might be familiar with. This is
just how things are right now and not intended to be like this forever.
(It might be forever for the 2.4.x release line, though.) So, HTTP/2
workers, or shorter H2Workers, will not show up in mod_status. They
are also not counted against directives such as ThreadsPerChild. However
they take ThreadsPerChild
as default if you have not configured something
else via H2MinWorkers and
H2MaxWorkers.
Another thing to watch out for is is memory consumption. Since HTTP/2
keeps more state on the server to manage all the open request, priorities
for and dependencies between them, it will always need more memory
than HTTP/1.1 processing. There are three directives which steer the
memory footprint of a HTTP/2 connection:
H2MaxSessionStreams,
H2WindowSize and
H2StreamMaxMemSize.
H2MaxSessionStreams limits the
number of parallel requests that a client can make on a HTTP/2 connection.
It depends on your site how many you should allow. The default is 100 which
is plenty and unless you run into memory problems, I would keep it this
way. Most requests that browsers send are GETs without a body, so they
use up only a little bit of memory until the actual processing starts.
H2WindowSize controls how much
the client is allowed to send as body of a request, before it waits
for the server to encourage more. Or, the other way around, it is the
amount of request body data the server needs to be able to buffer. This
is per request.
And last, but not least, H2StreamMaxMemSize
controls how much response data shall be buffered. The request sits in
a H2Worker thread and is producing data, the HTTP/2 connection tries
to send this to the client. If the client does not read fast enough,
the connection will buffer this amount of data and then suspend the
H2Worker.
Many sites use the same TLS certificate for multiple virtual hosts. The certificate either has a wildcard name, such as '*.example.org' or carries several alternate names. Browsers using HTTP/2 will recognize that and reuse an already opened connection for such hosts.
While this is great for performance, it comes at a price: such vhosts need more care in their configuration. The problem is that you will have multiple requests for multiple hosts on the same TLS connection. And that makes renegotiation impossible, in face the HTTP/2 standard forbids it.
So, if you have several virtual hosts using the same certificate and want to use HTTP/2 for them, you need to make sure that all vhosts have exactly the same SSL configuration. You need the same protocol, ciphers and settings for client verification.
If you mix things, Apache httpd will detect it and return a special response code, 421 Misdirected Request, to the client.
This module can be configured to provide HTTP/2 related information
as additional environment variables to the SSI and CGI namespace, as well
as in custom log configurations (see %{VAR_NAME}e).
| Variable Name: | Value Type: | Description: |
|---|---|---|
HTTP2 | flag | HTTP/2 is being used. |
H2PUSH | flag | HTTP/2 Server Push is enabled for this connection and also supported by the client. |
H2_PUSH | flag | alternate name for H2PUSH |
H2_PUSHED | string | empty or PUSHED for a request being pushed by the server. |
H2_PUSHED_ON | number | HTTP/2 stream number that triggered the push of this request. |
H2_STREAM_ID | number | HTTP/2 stream number of this request. |
H2_STREAM_TAG | string | HTTP/2 process unique stream identifier, consisting of connection id and stream id separated by -. |
| Description: | Determine file handling in responses |
|---|---|
| Syntax: | H2CopyFiles on|off |
| Default: | H2CopyFiles off |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.24 and later. |
This directive influences how file content is handled in
responses. When off, which is the default, file handles
are passed from the requestion processing down to the main
connection, using the usual Apache setaside handling for
managing the lifetime of the file.
When set to on, file content is copied while the
request is still being processed and the buffered data is passed
on to the main connection. This is better if a third party
module is injecting files with different lifetimes into the response.
An example for such a module is mod_wsgi that may place
Python file handles into the response. Those files get close down when
Python thinks processing has finished. That may be well before
mod_http2 is done with them.
| Description: | H2 Direct Protocol Switch |
|---|---|
| Syntax: | H2Direct on|off |
| Default: | H2Direct on for h2c, off for h2 protocol |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
This directive toggles the usage of the HTTP/2 Direct Mode. This
should be used inside a
<VirtualHost>
section to enable direct HTTP/2 communication for that virtual host.
Direct communication means that if the first bytes received by the server on a connection match the HTTP/2 preamble, the HTTP/2 protocol is switched to immediately without further negotiation. This mode is defined in RFC 7540 for the cleartext (h2c) case. Its use on TLS connections not mandated by the standard.
When a server/vhost does not have h2 or h2c enabled via
Protocols,
the connection is never inspected for a HTTP/2 preamble.
H2Direct
does not matter then. This is important for connections that
use protocols where an initial read might hang indefinitely, such
as NNTP.
For clients that have out-of-band knowledge about a server supporting h2c, direct HTTP/2 saves the client from having to perform an HTTP/1.1 upgrade, resulting in better performance and avoiding the Upgrade restrictions on request bodies.
This makes direct h2c attractive for server to server communication as well, when the connection can be trusted or is secured by other means.
H2Direct on
| Description: | Add a response header to be picked up in 103 Early Hints |
|---|---|
| Syntax: | H2EarlyHint name value |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.58 and later. |
H2EarlyHint allows adding a response
header before the real request processing is started. Such headers
are picked up for "103 Early Hints" intermediate responses. The main
purpose is to send "preload" information to client browsers.
name and value must be valid HTTP header fields
or will lead to failed responses. H2EarlyHints
must still be enabled to allow 103 intermediate responses to be sent.
This directive can be repeated several times and header fields of the
same names add.
H2EarlyHint Link "</my.css>;rel=preload;as=style"
| Description: | Determine sending of 103 status codes |
|---|---|
| Syntax: | H2EarlyHints on|off |
| Default: | H2EarlyHints off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.24 and later. |
This setting controls if HTTP status 103 interim responses are forwarded to the client or not. By default, this is currently not the case since a range of clients still have trouble with unexpected interim responses.
When set to on, PUSH resources announced with
H2PushResource will
trigger an interim 103 response
before the final response. The 103 response will carry Link
headers that advise the preload of such resources.
| Description: | Maximum bytes inside a single HTTP/2 DATA frame |
|---|---|
| Syntax: | H2MaxDataFrameLen n |
| Default: | H2MaxDataFrameLen 0 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.58 and later. |
H2MaxDataFrameLen limits the maximum
amount of response body bytes placed into a single HTTP/2 DATA
frame. Setting this to 0 places no limit (but the max size
allowed by the protocol is observed).
The module, by default, tries to use the maximum size possible, which is somewhat around 16KB. This sets the maximum. When less response data is availble, smaller frames will be sent.
| Description: | Maximum size of response headers |
|---|---|
| Syntax: | H2MaxHeaderBlockLen n |
| Default: | H2MaxHeaderBlockLen 0 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.64 and later. |
H2MaxHeaderBlockLen sets the limit
on the overall size of response headers. A setting of 0
will leave this at the default of 64 KB in nghttp2.
Responses with headers larger than this (adding all headers) will not be processed and result in a reset of the stream.
| Description: | Maximum number of active streams per HTTP/2 session. |
|---|---|
| Syntax: | H2MaxSessionStreams n |
| Default: | H2MaxSessionStreams 100 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
This directive sets the maximum number of active streams per HTTP/2 session (e.g. connection)
that the server allows. A stream is active if it is not idle or
closed according to RFC 7540.
H2MaxSessionStreams 20
| Description: | Maximum number of seconds h2 workers remain idle until shut down. |
|---|---|
| Syntax: | H2MaxWorkerIdleSeconds n |
| Default: | H2MaxWorkerIdleSeconds 600 |
| Context: | server config |
| Status: | Extension |
| Module: | mod_http2 |
This directive sets the maximum number of seconds a h2 worker may
idle until it shuts itself down. This only happens while the number of
h2 workers exceeds H2MinWorkers.
H2MaxWorkerIdleSeconds 20
| Description: | Maximum number of worker threads to use per child process. |
|---|---|
| Syntax: | H2MaxWorkers n |
| Context: | server config |
| Status: | Extension |
| Module: | mod_http2 |
This directive sets the maximum number of worker threads to spawn
per child process for HTTP/2 processing. If this directive is not used,
mod_http2 will chose a value suitable for the mpm
module loaded.
H2MaxWorkers 20
| Description: | Minimal number of worker threads to use per child process. |
|---|---|
| Syntax: | H2MinWorkers n |
| Context: | server config |
| Status: | Extension |
| Module: | mod_http2 |
This directive sets the minimum number of worker threads to spawn
per child process for HTTP/2 processing. If this directive is not used,
mod_http2 will chose a value suitable for the mpm
module loaded.
H2MinWorkers 10
| Description: | Require HTTP/2 connections to be "modern TLS" only |
|---|---|
| Syntax: | H2ModernTLSOnly on|off |
| Default: | H2ModernTLSOnly on |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.18 and later. |
This directive toggles the security checks on HTTP/2 connections
in TLS mode (https:). This can be used server wide or for specific
<VirtualHost>s.
The security checks require that the TSL protocol is at least TLSv1.2 and that none of the ciphers listed in RFC 7540, Appendix A is used. These checks will be extended once new security requirements come into place.
The name stems from the Security/Server Side TLS definitions at mozilla where "modern compatibility" is defined. Mozilla Firefox and other browsers require modern compatibility for HTTP/2 connections. As everything in OpSec, this is a moving target and can be expected to evolve in the future.
One purpose of having these checks in mod_http2 is to enforce this
security level for all connections, not only those from browsers. The other
purpose is to prevent the negotiation of HTTP/2 as a protocol should
the requirements not be met.
Ultimately, the security of the TLS connection is determined by the
server configuration directives for mod_ssl.
H2ModernTLSOnly off
| Description: | Determine buffering behaviour of output |
|---|---|
| Syntax: | H2OutputBuffering on|off |
| Default: | H2OutputBuffering on |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.48 and later. |
The directive H2OutputBuffering controls the buffering of stream output.
The default is on, which is the behaviour of previous versions. When off, all
bytes are made available immediately to the main connection for sending them
out to the client. This fixes interop issues with certain flavours of gRPC.
| Description: | Determine the range of padding bytes added to payload frames |
|---|---|
| Syntax: | H2Padding numbits |
| Default: | H2Padding 0 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.39 and later. |
With the default 0, no padding bytes are added to any payload frames, e.g. HEADERS, DATA and PUSH_PROMISE. This is the behaviour of previous versions. It means that under certain conditions, an observer of network traffic can see the length of those frames in the TLS stream.
When configuring numbits of 1-8, a random number in range [0, 2^numbits[ are added to each frame. The random value is chosen independently for each frame that the module sends back to the client.
While more padding bytes give better message length obfuscation, they are also additional traffic. The optimal number therefore depends on the kind of web traffic the server carries.
The default of 0, e.g. no padding, was chosen for maximum backward compatibility. There might be deployments where padding bytes are unwanted or do harm. The most likely cause would be a client that has a faults implementation.
| Description: | En-/Disable forward proxy requests via HTTP/2 |
|---|---|
| Syntax: | H2ProxyRequests on|off |
| Default: | H2ProxyRequests off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.58 and later. |
Use H2ProxyRequests to enable or disable
handling of HTTP/2 requests in a forward proxy configuration.
Similar to ProxyRequests, this
triggers the needed treatment of requests when HTTP/2 is enabled
in a forward proxy configuration. Both directive should be enabled.
| Description: | H2 Server Push Switch |
|---|---|
| Syntax: | H2Push on|off |
| Default: | H2Push on |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.18 and later. |
This directive toggles the usage of the HTTP/2 server push protocol feature.
The HTTP/2 protocol allows the server to push other resources to a client when it asked for a particular one. This is helpful if those resources are connected in some way and the client can be expected to ask for it anyway. The pushing then saves the time it takes the client to ask for the resources itself. On the other hand, pushing resources the client never needs or already has is a waste of bandwidth.
Server pushes are detected by inspecting the Link headers of
responses (see https://tools.ietf.org/html/rfc5988 for the
specification). When a link thus specified has the rel=preload
attribute, it is treated as a resource to be pushed.
Link headers in responses are either set by the application or
can be configured via H2PushResource or
using mod_headers as:
<Location /index.html>
Header add Link "</css/site.css>;rel=preload"
Header add Link "</images/logo.jpg>;rel=preload"
</Location>
As the example shows, there can be several link headers added to a response, resulting in several pushes being triggered. There are no checks in the module to avoid pushing the same resource twice or more to one client. Use with care.
HTTP/2 server pushes are enabled by default. On a server or virtual host, you may enable/disable this feature for any connection to the host. In addition, you may disable PUSH for a set of resources in a Directory/Location. This controls which resources may cause a PUSH, not which resources may be sent via PUSH.
H2Push off
Last but not least, pushes happen only when the client signals its willingness to accept those. Most browsers do, some, like Safari 9, do not. Also, pushes also only happen for resources from the same authority as the original response is for.
| Description: | H2 Server Push Diary Size |
|---|---|
| Syntax: | H2PushDiarySize n |
| Default: | H2PushDiarySize 256 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.19 and later. |
This directive toggles the maximum number of HTTP/2 server pushes
that are remembered per HTTP/2 connection. This can be used inside the
<VirtualHost>
section to influence the number for all connections to that virtual host.
The push diary records a digest of pushed resources (their URL) to avoid duplicate pushes on the same connection. These value are not persisted, so clients opening a new connection will experience known pushes again.
If the maximum size is reached, newer entries replace the oldest ones. A diary entry uses 8 bytes, letting a default diary with 256 entries consume around 2 KB of memory.
A size of 0 will effectively disable the push diary.
| Description: | H2 Server Push Priority |
|---|---|
| Syntax: | H2PushPriority mime-type [after|before|interleaved] [weight] |
| Default: | H2PushPriority * After 16 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.18 and later. For having an effect, a nghttp2 library version 1.5.0 or newer is necessary. |
This directive defines the priority handling of pushed responses based on the content-type of the response. This is usually defined per server config, but may also appear in a virtual host.
HTTP/2 server pushes are always related to a client request. Each such request/response pairs, or streams have a dependency and a weight, together defining the priority of a stream.
When a stream depends on another, say X depends on Y, then Y gets all bandwidth before X gets any. Note that this does not mean that Y will block X. If Y has no data to send, all bandwidth allocated to Y can be used by X.
When a stream has more than one dependent, say X1 and X2 both depend on Y, the weight determines the bandwidth allocation. If X1 and X2 have the same weight, they both get half of the available bandwidth. If the weight of X1 is twice as large as that for X2, X1 gets twice the bandwidth of X2.
Ultimately, every stream depends on the root stream which gets all the bandwidth available, but never sends anything. So all its bandwidth is distributed by weight among its children. Which either have data to send or distribute the bandwidth to their own children. And so on. If none of the children have data to send, that bandwidth get distributed somewhere else according to the same rules.
The purpose of this priority system is to always make use of available bandwidth while allowing precedence and weight to be given to specific streams. Since, normally, all streams are initiated by the client, it is also the one that sets these priorities.
Only when such a stream results in a PUSH, gets the server to decide what the initial priority of such a pushed stream is. In the examples below, X is the client stream. It depends on Y and the server decides to PUSH streams P1 and P2 onto X.
The default priority rule is:
H2PushPriority * After 16
which reads as 'Send a pushed stream of any content-type depending on the client stream with weight 16'. And so P1 and P2 will be send after X and, as they have equal weight, share bandwidth equally among themselves.
H2PushPriority text/css Interleaved 256
which reads as 'Send any CSS resource on the same dependency and
weight as the client stream'. If P1 has content-type 'text/css',
it will depend on Y (as does X) and its effective weight will be
calculated as P1ew = Xw * (P1w / 256). With P1w being
256, this will make the effective weight the same as the weight
of X. If both X and P1 have data to send, bandwidth will be allocated
to both equally.
With Pw specified as 512, a pushed, interleaved stream would get double the weight of X. With 128 only half as much. Note that effective weights are always capped at 256.
H2PushPriority application/json Before
This says that any pushed stream of content type 'application/json' should be send out before X. This makes P1 dependent on Y and X dependent on P1. So, X will be stalled as long as P1 has data to send. The effective weight is inherited from the client stream. Specifying a weight is not allowed.
Be aware that the effect of priority specifications is limited by the available server resources. If a server does not have workers available for pushed streams, the data for the stream may only ever arrive when other streams have been finished.
Last, but not least, there are some specifics of the syntax to be used in this directive:
H2PushPriority application/json 32 # an After rule H2PushPriority image/jpeg before # weight inherited H2PushPriority text/css interleaved # weight 256 default
| Description: | Declares resources for early pushing to the client |
|---|---|
| Syntax: | H2PushResource [add] path [critical] |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.24 and later. |
When added to a directory/location HTTP/2 PUSHes will be attempted for all paths added via this directive. This directive can be used several times for the same location.
This directive pushes resources much earlier than adding
Link headers via mod_headers.
mod_http2 announces these resources in a
103 Early Hints interim response to the client.
That means that clients not supporting PUSH will still get
early preload hints.
In contrast to setting Link response headers
via mod_headers, this directive will only
take effect on HTTP/2 connections.
By adding critical to such a resource, the server
will give processing it more preference and send its data, once
available, before the data from the main request.
| Description: | Serialize Request/Response Processing Switch |
|---|---|
| Syntax: | H2SerializeHeaders on|off |
| Default: | H2SerializeHeaders off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
This directive toggles if HTTP/2 requests shall be serialized in
HTTP/1.1 format for processing by httpd core or if
received binary data shall be passed into the request_recs
directly.
Serialization will lower performance, but gives more backward compatibility in case custom filters/hooks need it.
H2SerializeHeaders on
| Description: | Maximum amount of output data buffered per stream. |
|---|---|
| Syntax: | H2StreamMaxMemSize bytes |
| Default: | H2StreamMaxMemSize 65536 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
This directive sets the maximum number of outgoing data bytes buffered in memory for an active streams. This memory is not allocated per stream as such. Allocations are counted against this limit when they are about to be done. Stream processing freezes when the limit has been reached and will only continue when buffered data has been sent out to the client.
H2StreamMaxMemSize 128000
| Description: | Maximum time waiting when sending/receiving data to stream processing |
|---|---|
| Syntax: | H2StreamTimeout time-interval[s] |
| Default: | Value of |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.55 and later. |
H2StreamTimeout specifies the maximum time that
a stream being processed will wait for its data to be sent/received.
| Description: | Configure the number of seconds of idle time on TLS before shrinking writes |
|---|---|
| Syntax: | H2TLSCoolDownSecs seconds |
| Default: | H2TLSCoolDownSecs 1 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.18 and later. |
This directive sets the number of seconds of idle time on a TLS
connection before the TLS write size falls back to small (~1300 bytes)
length.
This can be used server wide or for specific
<VirtualHost>s.
See H2TLSWarmUpSize for a
description of TLS warmup. H2TLSCoolDownSecs reflects the fact
that connections may deteriorate over time (and TCP flow adjusts)
for idle connections as well. It is beneficial to overall performance
to fall back to the pre-warmup phase after a number of seconds that
no data has been sent.
In deployments where connections can be considered reliable, this timer can be disabled by setting it to 0.
The following example sets the seconds to zero, effectively disabling any cool down. Warmed up TLS connections stay on maximum record size.
H2TLSCoolDownSecs 0
| Description: | Configure the number of bytes on TLS connection before doing max writes |
|---|---|
| Syntax: | H2TLSWarmUpSize amount |
| Default: | H2TLSWarmUpSize 1048576 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.18 and later. |
This directive sets the number of bytes to be sent in small
TLS records (~1300 bytes) until doing maximum sized writes (16k)
on https: HTTP/2 connections.
This can be used server wide or for specific
<VirtualHost>s.
Measurements by google performance labs show that best performance on TLS connections is reached, if initial record sizes stay below the MTU level, to allow a complete record to fit into an IP packet.
While TCP adjust its flow-control and window sizes, longer TLS records can get stuck in queues or get lost and need retransmission. This is of course true for all packets. TLS however needs the whole record in order to decrypt it. Any missing bytes at the end will stall usage of the received ones.
After a sufficient number of bytes have been send successfully, the TCP state of the connection is stable and maximum TLS record sizes (16 KB) can be used for optimal performance.
In deployments where servers are reached locally or over reliable connections only, the value might be decreased with 0 disabling any warmup phase altogether.
The following example sets the size to zero, effectively disabling any warmup phase.
H2TLSWarmUpSize 0
| Description: | H2 Upgrade Protocol Switch |
|---|---|
| Syntax: | H2Upgrade on|off |
| Default: | H2Upgrade on for h2c, off for h2 protocol |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_http2 |
This directive toggles the usage of the HTTP/1.1 Upgrade method
for switching to HTTP/2. This
should be used inside a
<VirtualHost>
section to enable Upgrades to HTTP/2 for that virtual host.
This method of switching protocols is defined in HTTP/1.1 and uses the "Upgrade" header (thus the name) to announce willingness to use another protocol. This may happen on any request of a HTTP/1.1 connection.
This method of protocol switching is enabled by default on cleartext (potential h2c) connections and disabled on TLS (potential h2), as mandated by RFC 7540.
Please be aware that Upgrades are only accepted for requests
that carry no body. POSTs and PUTs with content will never
trigger an upgrade to HTTP/2.
See H2Direct for an
alternative to Upgrade.
This mode only has an effect when h2 or h2c is enabled via
the Protocols.
H2Upgrade on
| Description: | En-/Disable WebSockets via HTTP/2 |
|---|---|
| Syntax: | H2WebSockets on|off |
| Default: | H2WebSockets off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
| Compatibility: | Available in version 2.4.58 and later. |
Use H2WebSockets to enable or disable
bootstrapping of WebSockets via the HTTP/2 protocol. This
protocol extension is defined in RFC 8441.
Such requests come as a CONNECT with an extra ':protocol' header. Such requests are transformed inside the module to their HTTP/1.1 equivalents before passing it to internal processing.
This means that HTTP/2 WebSockets can be used for a
ProxyPass with
'upgrade=websocket' parameter without further changes.
For (3rd party) modules that handle WebSockets directly in the server, the protocol bootstrapping itself will also work. However the transfer of data does require extra support in case of HTTP/2. The negotiated WebSocket will not be able to use the client connection socket for polling IO related events.
Because enabling this feature might break backward compatibility for such 3rd party modules, it is not enabled by default.
| Description: | Size of Stream Window for upstream data. |
|---|---|
| Syntax: | H2WindowSize bytes |
| Default: | H2WindowSize 65535 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_http2 |
This directive sets the size of the window that is used for flow control from client to server and limits the amount of data the server has to buffer. The client will stop sending on a stream once the limit has been reached until the server announces more available space (as it has processed some of the data).
This limit affects only request bodies, not its meta data such as headers. Also, it has no effect on response bodies as the window size for those are managed by the clients.
H2WindowSize 128000
Apache HTTP サーバ バージョン 2.4
| 説明: | サーバへのリクエストのロギング |
|---|---|
| ステータス: | Base |
| モジュール識別子: | log_config_module |
| ソースファイル: | mod_log_config.c |
このモジュールはクライアントのリクエストを柔軟にログ収集する機能を 提供します。ログはカスタマイズ可能な書式で書かれ、ファイルに直接 書いたり、外部プログラムに渡したりすることができます。個々のリクエストを 特徴に応じてログに書いたり書かなかったりできるように、条件による ログ収集も提供されています。
このモジュールは三つのディレクティブ提供します:
ログファイルを作成するための TransferLog,
新しい書式を 定義する LogFormat,
ログファイルと 書式を一度に定義する CustomLog です。
各リクエストが複数回ログ収集されるようにするために
TransferLog ディレクティブと
CustomLog
ディレクティブは複数回使用することができます。
LogFormat ディレクティブと
CustomLog
ディレクティブの書式を指定する引数は文字列です。この文字列を使ってそれぞれの
リクエストがログファイルにログ収集されます。その文字列には
ログファイルにそのまま
書かれる文字列や、それぞれ改行とタブを表す C 言語
形式の制御文字 "\n" と "\t"
とを含めることができます。そのまま出力させたい引用符とバックスラッシュは
バックスラッシュでエスケープする必要があります。
リクエストの特徴そのものは "%"
ディレクティブを書式の文字列に書くことで
ログ収集されます。"%"
ディレクティブはログファイル中では以下のような
値で置換されます:
| フォーマット文字列 | 説明 | ||||||
|---|---|---|---|---|---|---|---|
%% |
パーセント記号 | ||||||
%a |
リモート IP アドレス | ||||||
%A |
ローカル IP アドレス | ||||||
%B |
レスポンスのバイト数。HTTP ヘッダは除く。 | ||||||
%b |
レスポンスのバイト数。HTTP ヘッダは除く。CLF 書式。
すなわち、1 バイトも送られなかったときは 0 ではなく、
'-' になる | ||||||
%{Foobar}C |
サーバに送られたリクエスト中のクッキー Foobar の値 | ||||||
%D |
リクエストを処理するのにかかった時間、マイクロ秒単位 | ||||||
%{FOOBAR}e |
環境変数 FOOBAR の内容 | ||||||
%f |
ファイル名 | ||||||
%h |
リモートホスト | ||||||
%H |
リクエストプロトコル | ||||||
%{Foobar}i |
サーバに送られたリクエストの Foobar:
ヘッダの内容 | ||||||
%l |
(identd からもし提供されていれば) リモートログ名。
これは mod_ident がサーバに存在して、
IdentityCheck
ディレクティブが On に設定されていない限り、
- になります。 | ||||||
%m |
リクエストメソッド | ||||||
%{Foobar}n |
他のモジュールからのメモ Foobar の内容 | ||||||
%{Foobar}o |
応答の Foobar: ヘッダの内容 | ||||||
%p |
リクエストを扱っているサーバの正式なポート | ||||||
%{format}p |
サーバがリクエストを処理しているポートの公式
(訳注: canonical) のポート番号か、
サーバの実際のポート番号か、クライアント側の実際のポート番号かです。
format に使える文字列は canonical, local,
remote になります。
| ||||||
%P |
リクエストを扱った子プロセスのプロセス ID | ||||||
%{format}P |
リクエストを扱ったワーカーのプロセス ID かスレッド ID。
format として有効な値は pid, tid,
hextid です。hextid を使うには
APR 1.2.0 以降が必要です。
| ||||||
%q |
問い合せ文字列 (存在する場合は前に ? が追加される。
そうでない場合は空文字列) | ||||||
%r |
リクエストの最初の行 | ||||||
%s |
ステータス。内部でリダイレクトされたリクエストは、元々の
リクエストのステータス --- 最後のステータスは %>s
| ||||||
%t |
リクエストを受付けた時刻。 CLF の時刻の書式 (標準の英語の書式) | ||||||
%{format}t |
format で与えられた書式による時刻。format は
strftime (3) の
書式である必要がある。(地域化されている可能性がある) | ||||||
%T |
リクエストを扱うのにかかった時間、秒単位 | ||||||
%u |
リモートユーザ (認証によるもの。ステータス (%s) が
401 のときは意味がないものである可能性がある)
| ||||||
%U |
リクエストされた URL パス。クエリ文字列は含まない | ||||||
%v |
リクエストを扱っているサーバの正式な ServerName | ||||||
%V |
UseCanonicalName の設定によるサーバ名 | ||||||
%X |
応答が完了したときの接続ステータス:
(このディレクティブは Apache
1.3 の後期のバージョンでは | ||||||
%I |
リクエストとヘッダを含む、受け取ったバイト数。
0 にはならない。
これを使用するためには mod_logio が必要 | ||||||
%O |
ヘッダを含む、送信したバイト数。0 にはならない。
これを使用するためには mod_logio が必要 |
特定の要素は "%" の直後に HTTP ステータスコードをカンマ区切りで
指定することで、表示を制限することができます。例えば
"%400,501{User-agent}i" では、
400 と 500 番エラーでのみ User-agent をログします。
他のステータスコードでは "-" という文字列が
ログされます。ステータスコードのリストは "!"
で否定を指定することができます :
"%!200,304,302{Referer}i" は、指定された
3 つのコードのどれにも該当しないリクエスト全てで
Referer をログします。
修飾子 "<" と ">" は内部リダイレクトされたリクエストのログに
元のリクエストか最終的なリクエストのどちらを使用するかを
指定するために使います。デフォルトでは、% ディレクティブの
%s, %U, %T, %D, %r は元のリクエストを、他は最終的なリクエストを
使用します。例えば、リクエストの最終ステータスを記録するには
%>s を、内部的に認証されていないリソースへリダイレクトされた
リクエストで元のリクエストで認証されたユーザを記録するためには
%<u を使うことができます。
セキュリティ上の理由により 2.0.46 より、
%r, %i, %o に入っている、
印字不可能な文字と他の特別な文字は、\xhh
という形式の文字列でエスケープされるようになりました。hh は
そのままのバイトの値の 16 進での値です。この規則の例外には、
バックスラッシュを使ってエスケープされる " と \ と、
C 形式の表記法が使われる空白文字 (\n, \t など)
があります。2.0.46 以前のバージョンではエスケープ処理は行われませんので、
生ログファイルを扱う際に注意が必要です。
httpd 2.0 では 1.3 とは異なり、%b と %B
フォーマット文字列はクライアントに送信されたバイト数そのものではなく、
HTTP レスポンスのバイト数です (これらは異なるもので、たとえば、
コネクションが途中で破棄された場合や、SSL 使用時に一致しません) 。
mod_logio で提供されている %O
フォーマット文字列で、ネットワーク経由で実際に転送されたバイト数を
記録できます。
よく使われるフォーマット文字列は:
"%h %l %u %t \"%r\" %>s %b""%v %h %l %u %t \"%r\" %>s %b""%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\"""%{Referer}i -> %U""%{User-agent}i"ログファイルが保存されているディレクトリがサーバを起動した以外のユーザで 書き込み可能なときにセキュリティの問題が発生する理由の詳細はセキュリティのこつ を参照してください。
| 説明: | ディスクに書き出す前にメモリにログエントリをバッファする |
|---|---|
| 構文: | BufferedLogs On|Off |
| デフォルト: | BufferedLogs Off |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Base |
| モジュール: | mod_log_config |
| 互換性: | 2.0.41 以降 |
BufferedLogs ディレクティブを使うと
mod_log_config の挙動が変化して、
複数のログを書き出す際に、それぞれのリクエスト処理後毎に
書き出すのではなく、いったんメモリに蓄えてから、
まとめてディスクに書き出すようになります。
この結果ディスクアクセスがより効率的になり、
高いパフォーマンスの得られるシステムもあるでしょう。
このディレクティブはサーバ全体で一度だけ設定できます;
バーチャルホストごとに設定することはできません。
| 説明: | ログファイルの名前と書式を設定する |
|---|---|
| 構文: | CustomLog file|pipe
format|nickname
[env=[!]environment-variable] |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_log_config |
CustomLog ディレクティブはサーバへのリクエストを
ログ収集するために使われます。ログの書式が指定され、
環境変数を使ってロギングが条件に応じて行なわれるようにすることもできます。
ログが書かれる場所を指定する最初の引数は以下の二つの形式の値を とることができます:
ServerRoot
からの相対パスで表されるファイル名。|" と、その後に標準入力からログの
情報を受けとるプログラムへのパスが続いたもの。
もしプログラムが使用された場合、
httpd が起動されたユーザとして実行されます。これはサーバが
root によって起動された場合は root になります。プログラムが
安全であるように留意してください。
Unix でないプラットフォームでファイルのパスを入力しているときは、 使用しているプラットフォームがバックスラッシュの使用を許可していた として、通常のスラッシュだけを使うように気をつけてください。 一般的に、設定ファイル中では常に普通のスラッシュのみを使うようにする 方が良いです。
二つめの引数はログファイルに何が書かれるかを指定します。
前にある LogFormat ディレクティブにより
定義された nickname か、ログの書式
のところで説明されている、明示的な format 文字列の
どちらかを指定することができます。
例えば、以下の二つのディレクティブ群は全く同じ効果をもたらします:
# CustomLog with format nickname
LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common
# CustomLog with explicit format string
CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b"
三つ目の引数は省略可能で、サーバの環境にある変数があるかないかに
応じてリクエストをログ収集するかどうかを制御するために使うことができます。
指定された環境変数がリクエストに対して
設定されていた場合 ('env=!name' 文が使われたときは
設定されていない場合)、リクエストがログ収集されます。
環境変数は mod_setenvif モジュールと
mod_rewrite モジュールの両方もしくは
片方を用いてリクエストごとに設定することができます。
例えば、サーバにあるすべての GIF 画像へのリクエストを別のログファイル
には記録したいけれど、メインログには記録したくない、というときは
以下のものを使うことができます:
SetEnvIf Request_URI \.gif$ gif-image
CustomLog gif-requests.log common env=gif-image
CustomLog nongif-requests.log common env=!gif-image
古い RefererIgnore ディレクティブと同じ挙動をさせたい場合は、 次のようにします:
SetEnvIf Referer example\.com localreferer
CustomLog referer.log referer env=!localreferer
| 説明: | Sets filename and format of log file |
|---|---|
| 構文: | GlobalLogfile|pipe
format|nickname
[env=[!]environment-variable|
expr=expression] |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Base |
| モジュール: | mod_log_config |
| 互換性: | Available in Apache HTTP Server 2.4.19 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | ログファイルで使用する書式を設定する |
|---|---|
| 構文: | LogFormat format|nickname
[nickname] |
| デフォルト: | LogFormat "%h %l %u %t \"%r\" %>s %b" |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_log_config |
このディレクティブはアクセスログファイルの書式を指定します。
LogFormat ディレクティブは二つの形式のどちらかを
とることができます。最初の形式では一つの引数のみが指定され、
続く TransferLog
で指定されたログで使われるログの書式を設定します。この単独の引数では
上のカスタムログ書式で説明されているように
format を明示的に指定することができます。
もしくは、下で説明されているように前に LogFormat
ディレクティブで定義されたログの書式を nicknameを使って
参照することもできます。
LogFormat ディレクティブの二つめの形式は
format に nickname を与えます。
フォーマット文字列全体を再び書くかわりに、
この nickname を続きの LogFormat ディレクティブや
CustomLog ディレクティブで使うことができます。
Nickname を定義する LogFormat ディレクティブは
他には何もしません -- すなわち、ニックネームを定義
するだけで、実際に書式を適用してデフォルトにするということは行ないません。
ですから、これは続く TransferLog
ディレクティブには影響を与えません。
さらに、LogFormat ディレクティブは既存の nickname を
使って別の nickname を定義することはできません。Nickname には
パーセント記号 (%) が含まれていてはいけないことにも注意
してください。
LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common
| 説明: | ログファイルの位置を指定 |
|---|---|
| 構文: | TransferLog file|pipe |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_log_config |
このディレクティブは、ログ書式を直接指定できないことと、
条件付きロギングが無いことを除くと、CustomLog と全く同じ引数と効果があります。
直接ログ書式を指定する代わりに、ログの書式はそこまでで一番最後に指定された
ニックネームを定義しない
LogFormat ディレクティブ
で定義されたものを使います。
もし他の書式が全く指定されていないときは Common Log Format
が使われます。
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
TransferLog logs/access_log
Serveur HTTP Apache Version 2.4
| Description: | Illustration de l'API des modules Apache |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | example_hooks_module |
| Fichier Source: | mod_example_hooks.c |
Certains fichiers situés dans le répertoire
modules/examples de l'arborescence de la
distribution d'Apache sont fournis à titre d'exemples pour ceux qui
souhaitent écrire des modules qui utilisent l'API d'Apache.
Le fichier principal est mod_example_hooks.c, qui
constitue une illustration exhaustive des différents mécanismes et
syntaxes d'appels. En aucun cas un module additionnel n'aura à
inclure des routines pour tous les appels - il n'en nécessitera au
contraire qu'un petit nombre !
Le module example_hooks fonctionne réellement. Si vous le chargez dans votre serveur, activez le gestionnaire "example-hooks-handler" dans une section location, et essayez d'accéder à la zone du site web correspondante, vous verrez s'afficher certaines sorties que le module example_hooks produit au cours des différents appels.
Pour inclure le module example_hooks dans votre serveur, effectuez les étapes suivantes :
configure avec l'option
--enable-example-hooks.make").Pour ajouter votre propre module :
cp modules/examples/mod_example_hooks.c
modules/nouveau_module/mod_monexemple.cmodules/nouveau_module/config.m4.
APACHE_MODPATH_INIT(nouveau_module).modules/examples/config.m4.configure --help.config.m4 des répertoires des autres modules pour
plus d'exemples.APACHE_MODPATH_FINISH.module/nouveau_module/Makefile.in.
Si la compilation de votre module ne nécessite pas d'instructions
particulières, ce fichier ne doit contenir que la ligne
include $(top_srcdir)/build/special.mk.mod_example_hooksPour activer le module example_hooks, ajoutez à votre fichier
httpd.conf un bloc du style :
<Location "/example-hooks-info"> SetHandler example-hooks-handler </Location>
Vous pouvez aussi ajouter ce qui suit dans un fichier .htaccess, puis
accéder au fichier "test.example" à partir du répertoire
correspondant :
AddHandler example-hooks-handler ".example"
Après avoir rechargé la configuration ou redémarré votre serveur, vous devriez pouvoir accéder à ce fichier et voir s'afficher ce qui a été décrit plus haut.
| Description: | Directive de démonstration pour illustrer l'API des modules Apache |
|---|---|
| Syntaxe: | Example |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Expérimental |
| Module: | mod_example_hooks |
La directive Example n'a pour fonction que
de définir un drapeau de démonstration que le gestionnaire de
contenu du module example_hooks va afficher. Elle ne possède aucun
argument. Si vous naviguez vers une URL à laquelle le gestionnaire
de contenu example_hooks s'applique, vous verrez s'afficher les routines
du module, ainsi que l'ordre dans lequel elles ont été appelées pour
servir le document demandé. On peut observer l'effet de cette
directive dans la phrase "Example
directive declared here: YES/NO".
Apache HTTP サーバ バージョン 2.4
| 説明: | リクエスト毎に入力バイト数と出力バイト数とをロギング |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | logio_module |
| ソースファイル: | mod_logio.c |
このモジュールはリクエストごとに受け取ったバイト数と 送信したバイト数のロギングを行なう機能を提供します。 記録される数字はリクエストのヘッダとレスポンスの本体を 反映した、実際にネットワークで受け取ったバイト値です。 入力では SSL/TLS の前に、出力では SSL/TLS の後に数えるので、 数字は暗号による変化も正しく反映したものになります。
このモジュールの使用には mod_log_config モジュールが
必要です。
このモジュールは新しいロギング用ディレクティブを加えます。
リクエスト自身の特徴はフォーマット文字列に、以下の様に置換される
"%" ディレクティブを
入れることでログ収集されます:
| フォーマット文字列 | 説明 |
|---|---|
%...I |
リクエストとヘッダを含む、受け取ったバイト数。 0 にはならない。 |
%...O |
ヘッダを含む、送信したバイト数。0 にはならない。 |
通常、この機能は以下の様に使用されます:
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\" %I %O"Serveur HTTP Apache Version 2.4
| Description: | Module multi-processus implémentant un serveur web hybride multi-processus multi-thread |
|---|---|
| Statut: | MPM |
| Identificateur de Module: | mpm_worker_module |
| Fichier Source: | worker.c |
Ce module multi-processus (MPM) implémente un serveur hybride multi-processus multi-thread. En utilisant les threads pour servir les requêtes, il peut en traiter un grand nombre tout en consommant moins de ressources qu'un serveur à base de processus. Cependant, il conserve une grande partie de la stabilité d'un serveur à base de processus en maintenant plusieurs processus disponibles, chacun de ces derniers possédant de nombreux threads.
Les directives les plus importantes qui permettent de contrôler
ce MPM sont ThreadsPerChild, qui définit le
nombre de threads lancés par chaque processus enfant et MaxRequestWorkers, qui définit le nombre
global maximum de threads qui peuvent être lancés.
CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers ThreadLimit ThreadsPerChild ThreadStackSize UserUn processus de contrôle unique (le parent) a pour tâche de
lancer les processus enfants. Chaque processus enfant crée un nombre
fixe de threads serveurs selon la valeur de la directive ThreadsPerChild, ainsi
qu'un thread chargé d'attendre les connexions et de les passer à un
thread serveur pour traitement au fur et à mesure de leur arrivée.
Le serveur HTTP Apache essaie toujours de maintenir un jeu de
threads serveurs
inactifs ou en réserve, qui se tiennent prêts à traiter
les requêtes entrantes. De cette façon, les clients n'ont pas besoin
d'attendre la création d'un nouveau thread ou d'un nouveau processus
pour que leurs requêtes puissent être traitées. Le nombre de
processus lancés initialement est défini par la directive StartServers. En cours de
fonctionnement, le serveur évalue le nombre total de threads inactifs
dans tous les processus, et en crée ou en arrête de façon à
maintenir ce nombre à l'intérieur des limites définies par les
directives MinSpareThreads et MaxSpareThreads. Comme ce module
s'auto-contrôle de manière efficace, on peut en général conserver
les valeurs par défaut. Le nombre maximum de clients pouvant être
servis simultanément (c'est à dire le nombre global maximum de
threads pour tous les processus) est défini par la directive
MaxRequestWorkers. Le nombre
maximum de processus enfants actifs est défini par la valeur de la
directive MaxRequestWorkers
divisée par la valeur de la directive
ThreadsPerChild.
Deux directives permettent de fixer des limites absolues pour le
nombre de processus enfants actifs et le nombre de threads serveurs
par processus enfant, et ne peuvent être modifiées qu'en
arrêtant complètement le serveur et en le démarrant à nouveau.
La valeur de la directive ServerLimit constitue une limite
absolue pour le nombre de processus enfants actifs, et doit être
supérieure ou égale à la valeur de la directive MaxRequestWorkers divisée par la valeur de
la directive
ThreadsPerChild. La valeur de la directive ThreadLimit constitue une limite
absolue pour le nombre de threads par processus enfant, et doit être
supérieure ou égale à la valeur de la directive ThreadsPerChild.
En plus du jeu de processus enfants actifs, il peut exister
quelques processus enfants en cours d'arrêt, mais dont au moins un
thread serveur est encore en train de traiter une connexion client
existante. Il peut subsister en théorie jusqu'à MaxRequestWorkers processus en cours
d'arrêt, bien qu'en réalité, ce nombre sera en général beaucoup plus
petit. Ce comportement peut être évité en désactivant l'arrêt de
processus enfants individuels de la manière suivante :
MaxConnectionsPerChild à zéro
MaxSpareThreads à la même valeur que MaxRequestWorkersVoici un exemple typique de configuration du contrôle
processus-thread pour le MPM worker :
ServerLimit 16 StartServers 2 MaxRequestWorkers 150 MinSpareThreads 25 MaxSpareThreads 75 ThreadsPerChild 25
Alors que le processus parent est en général démarré en tant que
root sous Unix afin de se mettre en écoute du port 80,
les processus enfants et les threads sont lancés par le serveur sous un
utilisateur avec privilèges restreints. On peut utiliser les
directives User et Group pour définir les privilèges
des processus enfants. Les processus enfants doivent pouvoir être en
mesure de lire tous les contenus destinés à être servis, mais
doivent avoir des privilèges aussi bas que possible. De plus, ces
directives définissent également les privilèges dont vont hériter les
scripts CGI (sauf si on utilise suexec).
La directive MaxConnectionsPerChild permet de
définir la fréquence à laquelle le serveur recycle ses processus en
arrêtant les plus anciens et en en lançant de nouveaux.
Ce module MPM utilise le mutex mpm-accept pour
sérialiser l'accès aux connexions entrantes lorsqu'un problème
d'afflux de requêtes peut survenir (en général, lorsqu'il y a
plusieurs sockets en écoute). Les différents aspects de
l'implémentation de ce mutex peuvent être configurés via la
directive Mutex. Vous
trouverez des informations plus détaillées à propos de ce mutex dans
la documentation sur les conseils en matière de
performances.
Versión 2.4 del Servidor HTTP Apache
| Descripción: | Funcionalides básicas del Servidor HTTP Apache que siempre están presentes. |
|---|---|
| Estado: | Core |
AcceptFilter AcceptPathInfo AccessFileName AddDefaultCharset AllowEncodedSlashes AllowOverride AllowOverrideList CGIMapExtension CGIPassAuth CGIVar ContentDigest DefaultRuntimeDir DefaultType Define <Directory> <DirectoryMatch> DocumentRoot <Else> <ElseIf> EnableMMAP EnableSendfile Error ErrorDocument ErrorLog ErrorLogFormat ExtendedStatus FileETag <Files> <FilesMatch> FlushMaxPipelined FlushMaxThreshold ForceType GprofDir HostnameLookups HttpProtocolOptions <If> <IfDefine> <IfDirective> <IfFile> <IfModule> <IfSection> Include IncludeOptional KeepAlive KeepAliveTimeout <Limit> <LimitExcept> LimitInternalRecursion LimitRequestBody LimitRequestFields LimitRequestFieldSize LimitRequestLine LimitXMLRequestBody <Location> <LocationMatch> LogLevel MaxKeepAliveRequests MaxRangeOverlaps MaxRangeReversals MaxRanges MergeSlashes MergeTrailers Mutex NameVirtualHost Options Protocol Protocols ProtocolsHonorOrder QualifyRedirectURL ReadBufferSize RegexDefaultOptions RegisterHttpMethod RLimitCPU RLimitMEM RLimitNPROC ScriptInterpreterSource SeeRequestTail ServerAdmin ServerAlias ServerName ServerPath ServerRoot ServerSignature ServerTokens SetHandler SetInputFilter SetOutputFilter StrictHostCheck TimeOut TraceEnable UNCList UnDefine UseCanonicalName UseCanonicalPhysicalPort <VirtualHost>| Descripción: | Configura mejoras para un Protocolo de Escucha de Sockets |
|---|---|
| Sintaxis: | AcceptFilter protocol accept_filter |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Disponible en Apache httpd 2.1.5 y posteriores. En Windows desde Apache httpd 2.3.3 y posteriores. |
Esta directiva hace posible mejoras específicas a nivel de sistema operativo
y a través del tipo de Protocolo para un socket que escucha.
La premisa básica es que el kernel no envíe un socket al servidor
hasta que o bien los datos se hayan recibido o bien se haya almacenado
en el buffer una Respuesta HTTP completa.
Actualmente sólo están soportados
Accept Filters sobre FreeBSD, TCP_DEFER_ACCEPT sobre Linux,
y AcceptEx() sobre Windows.
El uso de none para un argumento desactiva cualquier filtro
aceptado para ese protocolo. Esto es útil para protocolos que requieren que un
servidor envíe datos primeros, tales como ftp: o nntp:
AcceptFilter nntp none
Los nombres de protocolo por defecto son https para el puerto 443
y http para todos los demás puertos. Para especificar que se está
utilizando otro protocolo con un puerto escuchando, añade el argumento protocol
a la directiva Listen.
Sobre FreeBDS los valores por defecto:
AcceptFilter http httpready
AcceptFilter https dataready
El filtro httpready almacena en el buffer peticiones HTTP completas
a nivel de kernel. Una vez que la petición es recibida, el kernel la envía al servidor.
Consulta la página man de
accf_http(9) para más detalles. Puesto que las peticiones HTTPS
están encriptadas, sólo se utiliza el filtro
accf_data(9).
Sobre Linux los valores por defecto son:
AcceptFilter http data
AcceptFilter https data
En Linux, TCP_DEFER_ACCEPT no soporta el buffering en peticiones http.
Cualquier valor además de none habilitará
TCP_DEFER_ACCEPT en ese socket. Para más detalles
ver la página man de Linux
tcp(7).
Sobre Windows los valores por defecto son:
AcceptFilter http data
AcceptFilter https data
Sobre Windows mpm_winnt interpreta el argumento AcceptFilter para conmutar la API
AcceptEx(), y no soporta el buffering sobre el protocolo http. Hay dos valores
que utilizan la API Windows AcceptEx() y que recuperan sockets de red
entre conexciones. data espera hasta que los datos han sido
transmitidos como se comentaba anteriormente, y el buffer inicial de datos y las
direcciones de red son recuperadas a partir de una única llamada AcceptEx().
connect utiliza la API AcceptEx() API, y recupera también
las direcciones de red, pero a diferencia de none
la opción connect no espera a la transmisión inicial de los datos.
Sobre Windows, none prefiere accept() antes que AcceptEx()
y no recuperará sockets entre las conexiones. Lo que es útil para los adaptadores de
red con un soporte precario de drivers, así como para algunos proveedores de red
tales como drivers vpn, o filtros de spam, de virus o de spyware.
Protocol| Descripción: | Los recursos aceptan información sobre su ruta |
|---|---|
| Sintaxis: | AcceptPathInfo On|Off|Default |
| Valor por defecto: | AcceptPathInfo Default |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Disponible en Apache httpd 2.0.30 y posteriores |
Esta directiva controla si las peticiones que contienen información sobre la ruta
que sigue un fichero que existe (o un fichero que no existe pero en un directorio que
sí existe) serán aceptadas o denegadas. La información de ruta puede estar disponible
para los scripts en la variable de entorno PATH_INFO.
Por ejemplo, asumamos que la ubicación /test/ apunta a
un directorio que contiene únicamente el fichero
here.html. Entonces, las peticiones tanto para
/test/here.html/more como para
/test/nothere.html/more recogen
/more como PATH_INFO.
Los tres posibles argumentos para la directiva
AcceptPathInfo son los siguientes:
Off/test/here.html/more en el ejemplo anterior devolverá
un error 404 NOT FOUND.On/test/here.html/more será aceptado si
/test/here.html corresponde a un fichero válido.DefaultPATH_INFO. Los controladores que sirven scripts, tales como cgi-script e isapi-handler, normalmente aceptan
PATH_INFO por defecto.El objetivo principal de la directiva AcceptPathInfo
es permitirte sobreescribir la opción del controlador
de aceptar or rechazar PATH_INFO. Este tipo de sobreescritura se necesita,
por ejemplo, cuando utilizas un filtro, tal como
INCLUDES, para generar contenido
basado en PATH_INFO. El controlador principal normalmente rechazaría
la petición, de modo que puedes utilizar la siguiente configuración para habilitarla
como script:
<Files "mypaths.shtml">
Options +Includes
SetOutputFilter INCLUDES
AcceptPathInfo On
</Files>
| Descripción: | Nombre del fichero distribuido de configuración |
|---|---|
| Sintaxis: | AccessFileName filename [filename] ... |
| Valor por defecto: | AccessFileName .htaccess |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
Mientras que procesa una petición el servidor busca el primer fichero de configuración existente dentro de un listado de nombres en cada directorio de la ruta del documento, si los ficheros distribuidos de configuración están habilitados para ese directorio. Por ejemplo:
AccessFileName .acl
antes de servir el documento
/usr/local/web/index.html, el servidor leerá
/.acl, /usr/.acl,
/usr/local/.acl and /usr/local/web/.acl
para las directivas, salvo que estén deshabilitadas with
<Directory />
AllowOverride None
</Directory>
| Descripción: | Default charset parameter to be added when a response
content-type is text/plain or text/html |
|---|---|
| Sintaxis: | AddDefaultCharset On|Off|charset |
| Valor por defecto: | AddDefaultCharset Off |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
This directive specifies a default value for the media type
charset parameter (the name of a character encoding) to be added
to a response if and only if the response's content-type is either
text/plain or text/html. This should override
any charset specified in the body of the response via a META
element, though the exact behavior is often dependent on the user's client
configuration. A setting of AddDefaultCharset Off
disables this functionality. AddDefaultCharset On enables
a default charset of iso-8859-1. Any other value is assumed
to be the charset to be used, which should be one of the
IANA registered
charset values for use in Internet media types (MIME types).
For example:
AddDefaultCharset utf-8
AddDefaultCharset should only be used when all
of the text resources to which it applies are known to be in that
character encoding and it is too inconvenient to label their charset
individually. One such example is to add the charset parameter
to resources containing generated content, such as legacy CGI
scripts, that might be vulnerable to cross-site scripting attacks
due to user-provided data being included in the output. Note, however,
that a better solution is to just fix (or delete) those scripts, since
setting a default charset does not protect users that have enabled
the "auto-detect character encoding" feature on their browser.
| Descripción: | Determines whether encoded path separators in URLs are allowed to be passed through |
|---|---|
| Sintaxis: | AllowEncodedSlashes On|Off |
| Valor por defecto: | AllowEncodedSlashes Off |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache httpd 2.0.46 and later |
The AllowEncodedSlashes directive allows URLs
which contain encoded path separators (%2F for /
and additionally %5C for \ on according systems)
to be used. Normally such URLs are refused with a 404 (Not found) error.
Turning AllowEncodedSlashes On is
mostly useful when used in conjunction with PATH_INFO.
Allowing encoded slashes does not imply decoding.
Occurrences of %2F or %5C (only on
according systems) will be left as such in the otherwise decoded URL
string.
| Descripción: | Types of directives that are allowed in
.htaccess files |
|---|---|
| Sintaxis: | AllowOverride All|None|directive-type
[directive-type] ... |
| Valor por defecto: | AllowOverride None (2.3.9 and later), AllowOverride All (2.3.8 and earlier) |
| Contexto: | directory |
| Estado: | Core |
| Módulo: | core |
When the server finds an .htaccess file (as
specified by AccessFileName)
it needs to know which directives declared in that file can override
earlier configuration directives.
AllowOverride is valid only in
<Directory>
sections specified without regular expressions, not in <Location>, <DirectoryMatch> or
<Files> sections.
When this directive is set to None, then
.htaccess files are completely ignored.
In this case, the server will not even attempt to read
.htaccess files in the filesystem.
When this directive is set to All, then any
directive which has the .htaccess Context is allowed in
.htaccess files.
The directive-type can be one of the following groupings of directives.
AuthDBMGroupFile,
AuthDBMUserFile,
AuthGroupFile,
AuthName,
AuthType, AuthUserFile, Require, etc.).ErrorDocument,
ForceType,
LanguagePriority,
SetHandler,
SetInputFilter,
SetOutputFilter, and
mod_mime Add* and Remove* directives),
document meta data (Header, RequestHeader, SetEnvIf, SetEnvIfNoCase, BrowserMatch, CookieExpires, CookieDomain, CookieStyle, CookieTracking, CookieName),
mod_rewrite directives RewriteEngine, RewriteOptions, RewriteBase, RewriteCond, RewriteRule) and
Action from
mod_actions.
AddDescription,
AddIcon, AddIconByEncoding,
AddIconByType,
DefaultIcon, DirectoryIndex, FancyIndexing, HeaderName, IndexIgnore, IndexOptions, ReadmeName,
etc.).Allow, Deny and Order).Options and
XBitHack).
An equal sign may be given followed by a comma (but no spaces)
separated lists of options that may be set using the Options command.Example:
AllowOverride AuthConfig Indexes
In the example above all directives that are neither in the group
AuthConfig nor Indexes cause an internal
server error.
For security and performance reasons, do not set
AllowOverride to anything other than None
in your <Directory /> block. Instead, find (or
create) the <Directory> block that refers to the
directory where you're actually planning to place a
.htaccess file.
| Descripción: | Individual directives that are allowed in
.htaccess files |
|---|---|
| Sintaxis: | AllowOverrideList None|directive
[directive-type] ... |
| Valor por defecto: | AllowOverrideList None |
| Contexto: | directory |
| Estado: | Core |
| Módulo: | core |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Technique for locating the interpreter for CGI scripts |
|---|---|
| Sintaxis: | CGIMapExtension cgi-path .extension |
| Contexto: | directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | NetWare only |
This directive is used to control how Apache httpd finds the
interpreter used to run CGI scripts. For example, setting
CGIMapExtension sys:\foo.nlm .foo will
cause all CGI script files with a .foo extension to
be passed to the FOO interpreter.
| Descripción: | Enables passing HTTP authorization headers to scripts as CGI variables |
|---|---|
| Sintaxis: | CGIPassAuth On|Off |
| Valor por defecto: | CGIPassAuth Off |
| Contexto: | directory, .htaccess |
| Anula: | AuthConfig |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache HTTP Server 2.4.13 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Controls how some CGI variables are set |
|---|---|
| Sintaxis: | CGIVar variable rule |
| Contexto: | directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache HTTP Server 2.4.21 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Enables the generation of Content-MD5 HTTP Response
headers |
|---|---|
| Sintaxis: | ContentDigest On|Off |
| Valor por defecto: | ContentDigest Off |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | Options |
| Estado: | Core |
| Módulo: | core |
This directive enables the generation of
Content-MD5 headers as defined in RFC1864
respectively RFC2616.
MD5 is an algorithm for computing a "message digest" (sometimes called "fingerprint") of arbitrary-length data, with a high degree of confidence that any alterations in the data will be reflected in alterations in the message digest.
The Content-MD5 header provides an end-to-end
message integrity check (MIC) of the entity-body. A proxy or
client may check this header for detecting accidental
modification of the entity-body in transit. Example header:
Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
Note that this can cause performance problems on your server since the message digest is computed on every request (the values are not cached).
Content-MD5 is only sent for documents served
by the core, and not by any module. For example,
SSI documents, output from CGI scripts, and byte range responses
do not have this header.
| Descripción: | Base directory for the server run-time files |
|---|---|
| Sintaxis: | DefaultRuntimeDir directory-path |
| Valor por defecto: | DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/) |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache 2.4.2 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
ServerRoot| Descripción: | This directive has no effect other than to emit warnings
if the value is not none. In prior versions, DefaultType
would specify a default media type to assign to response content for
which no other media type configuration could be found.
|
|---|---|
| Sintaxis: | DefaultType media-type|none |
| Valor por defecto: | DefaultType none |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | The argument none is available in Apache httpd 2.2.7 and later. All other choices are DISABLED for 2.3.x and later. |
This directive has been disabled. For backwards compatibility
of configuration files, it may be specified with the value
none, meaning no default media type. For example:
DefaultType None
DefaultType None is only available in
httpd-2.2.7 and later.
Use the mime.types configuration file and the
AddType to configure media
type assignments via file extensions, or the
ForceType directive to configure
the media type for specific resources. Otherwise, the server will
send the response without a Content-Type header field and the
recipient may attempt to guess the media type.
| Descripción: | Define the existence of a variable |
|---|---|
| Sintaxis: | Define parameter-name |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
Equivalent to passing the -D argument to httpd.
This directive can be used to toggle the use of <IfDefine> sections without needing to alter
-D arguments in any startup scripts.
| Descripción: | Enclose a group of directives that apply only to the named file-system directory, sub-directories, and their contents. |
|---|---|
| Sintaxis: | <Directory directory-path>
... </Directory> |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
<Directory> and
</Directory> are used to enclose a group of
directives that will apply only to the named directory,
sub-directories of that directory, and the files within the respective
directories. Any directive that is allowed
in a directory context may be used. Directory-path is
either the full path to a directory, or a wild-card string using
Unix shell-style matching. In a wild-card string, ? matches
any single character, and * matches any sequences of
characters. You may also use [] character ranges. None
of the wildcards match a `/' character, so <Directory
/*/public_html> will not match
/home/user/public_html, but <Directory
/home/*/public_html> will match. Example:
<Directory /usr/local/httpd/htdocs>
Options Indexes FollowSymLinks
</Directory>
Be careful with the directory-path arguments:
They have to literally match the filesystem path which Apache httpd uses
to access the files. Directives applied to a particular
<Directory> will not apply to files accessed from
that same directory via a different path, such as via different symbolic
links.
Regular
expressions can also be used, with the addition of the
~ character. For example:
<Directory ~ "^/www/.*/[0-9]{3}">
would match directories in /www/ that consisted of
three numbers.
If multiple (non-regular expression) <Directory> sections
match the directory (or one of its parents) containing a document,
then the directives are applied in the order of shortest match
first, interspersed with the directives from the .htaccess files. For example,
with
<Directory />
AllowOverride None
</Directory>
<Directory /home/>
AllowOverride FileInfo
</Directory>
for access to the document /home/web/dir/doc.html
the steps are:
AllowOverride None
(disabling .htaccess files).AllowOverride FileInfo (for
directory /home).FileInfo directives in
/home/.htaccess, /home/web/.htaccess and
/home/web/dir/.htaccess in that order.Regular expressions are not considered until after all of the normal sections have been applied. Then all of the regular expressions are tested in the order they appeared in the configuration file. For example, with
<Directory ~ abc$>
# ... directives here ...
</Directory>
the regular expression section won't be considered until after
all normal <Directory>s and
.htaccess files have been applied. Then the regular
expression will match on /home/abc/public_html/abc and
the corresponding <Directory> will
be applied.
Note that the default access for
<Directory /> is Allow from All.
This means that Apache httpd will serve any file mapped from an URL. It is
recommended that you change this with a block such
as
<Directory />
Order Deny,Allow
Deny from All
</Directory>
and then override this for directories you want accessible. See the Security Tips page for more details.
The directory sections occur in the httpd.conf file.
<Directory> directives
cannot nest, and cannot appear in a <Limit> or <LimitExcept> section.
| Descripción: | Enclose directives that apply to the contents of file-system directories matching a regular expression. |
|---|---|
| Sintaxis: | <DirectoryMatch regex>
... </DirectoryMatch> |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
<DirectoryMatch> and
</DirectoryMatch> are used to enclose a group
of directives which will apply only to the named directory (and the files within),
the same as <Directory>.
However, it takes as an argument a
regular expression. For example:
<DirectoryMatch "^/www/(.+/)?[0-9]{3}">
would match directories in /www/ that consisted of three
numbers.
<Directory>) and
could not match the end of line symbol ($). In 2.3.9 and later,
only directories that match the expression are affected by the enclosed
directives.
<Directory> for
a description of how regular expressions are mixed in with normal
<Directory>s| Descripción: | Directory that forms the main document tree visible from the web |
|---|---|
| Sintaxis: | DocumentRoot directory-path |
| Valor por defecto: | DocumentRoot /usr/local/apache/htdocs |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
This directive sets the directory from which httpd
will serve files. Unless matched by a directive like Alias, the server appends the
path from the requested URL to the document root to make the
path to the document. Example:
DocumentRoot /usr/web
then an access to
http://www.my.host.com/index.html refers to
/usr/web/index.html. If the directory-path is
not absolute then it is assumed to be relative to the ServerRoot.
The DocumentRoot should be specified without
a trailing slash.
| Descripción: | Contains directives that apply only if the condition of a
previous <If> or
<ElseIf> section is not
satisfied by a request at runtime |
|---|---|
| Sintaxis: | <Else> ... </Else> |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Nested conditions are evaluated in 2.4.26 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
<If><ElseIf><If>,
<ElseIf>, and
<Else> are applied last.| Descripción: | Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
<If> or
<ElseIf> section is not
satisfied |
|---|---|
| Sintaxis: | <ElseIf expression> ... </ElseIf> |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Nested conditions are evaluated in 2.4.26 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
<If><Else><If>,
<ElseIf>, and
<Else> are applied last.| Descripción: | Use memory-mapping to read files during delivery |
|---|---|
| Sintaxis: | EnableMMAP On|Off |
| Valor por defecto: | EnableMMAP On |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
This directive controls whether the httpd may use
memory-mapping if it needs to read the contents of a file during
delivery. By default, when the handling of a request requires
access to the data within a file -- for example, when delivering a
server-parsed file using mod_include -- Apache httpd
memory-maps the file if the OS supports it.
This memory-mapping sometimes yields a performance improvement. But in some environments, it is better to disable the memory-mapping to prevent operational problems:
httpd.httpd
has it memory-mapped can cause httpd to
crash with a segmentation fault.
For server configurations that are vulnerable to these problems, you should disable memory-mapping of delivered files by specifying:
EnableMMAP Off
For NFS mounted files, this feature may be disabled explicitly for the offending files by specifying:
<Directory "/path-to-nfs-files">
EnableMMAP Off
</Directory>
| Descripción: | Use the kernel sendfile support to deliver files to the client |
|---|---|
| Sintaxis: | EnableSendfile On|Off |
| Valor por defecto: | EnableSendfile Off |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in version 2.0.44 and later. Default changed to Off in version 2.3.9. |
This directive controls whether httpd may use the
sendfile support from the kernel to transmit file contents to the client.
By default, when the handling of a request requires no access
to the data within a file -- for example, when delivering a
static file -- Apache httpd uses sendfile to deliver the file contents
without ever reading the file if the OS supports it.
This sendfile mechanism avoids separate read and send operations, and buffer allocations. But on some platforms or within some filesystems, it is better to disable this feature to avoid operational problems:
DocumentRoot (e.g., NFS, SMB, CIFS, FUSE),
the kernel may be unable to serve the network file through
its own cache.For server configurations that are not vulnerable to these problems, you may enable this feature by specifying:
EnableSendfile On
For network mounted files, this feature may be disabled explicitly for the offending files by specifying:
<Directory "/path-to-nfs-files">
EnableSendfile Off
</Directory>
Please note that the per-directory and .htaccess configuration
of EnableSendfile is not supported by
mod_cache_disk.
Only global definition of EnableSendfile
is taken into account by the module.
| Descripción: | Abort configuration parsing with a custom error message |
|---|---|
| Sintaxis: | Error message |
| Contexto: | server config, virtual host, directory, .htaccess |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | 2.3.9 and later |
If an error can be detected within the configuration, this directive can be used to generate a custom error message, and halt configuration parsing. The typical use is for reporting required modules which are missing from the configuration.
# ensure that mod_include is loaded
<IfModule !include_module>
Error mod_include is required by mod_foo. Load it with LoadModule.
</IfModule>
# ensure that exactly one of SSL,NOSSL is defined
<IfDefine SSL>
<IfDefine NOSSL>
Error Both SSL and NOSSL are defined. Define only one of them.
</IfDefine>
</IfDefine>
<IfDefine !SSL>
<IfDefine !NOSSL>
Error Either SSL or NOSSL must be defined.
</IfDefine>
</IfDefine>
| Descripción: | What the server will return to the client in case of an error |
|---|---|
| Sintaxis: | ErrorDocument error-code document |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
In the event of a problem or error, Apache httpd can be configured to do one of four things,
The first option is the default, while options 2-4 are
configured using the ErrorDocument
directive, which is followed by the HTTP response code and a URL
or a message. Apache httpd will sometimes offer additional information
regarding the problem/error.
URLs can begin with a slash (/) for local web-paths (relative
to the DocumentRoot), or be a
full URL which the client can resolve. Alternatively, a message
can be provided to be displayed by the browser. Examples:
ErrorDocument 500 http://foo.example.com/cgi-bin/tester
ErrorDocument 404 /cgi-bin/bad_urls.pl
ErrorDocument 401 /subscription_info.html
ErrorDocument 403 "Sorry can't allow you access today"
Additionally, the special value default can be used
to specify Apache httpd's simple hardcoded message. While not required
under normal circumstances, default will restore
Apache httpd's simple hardcoded message for configurations that would
otherwise inherit an existing ErrorDocument.
ErrorDocument 404 /cgi-bin/bad_urls.pl
<Directory /web/docs>
ErrorDocument 404 default
</Directory>
Note that when you specify an ErrorDocument
that points to a remote URL (ie. anything with a method such as
http in front of it), Apache HTTP Server will send a redirect to the
client to tell it where to find the document, even if the
document ends up being on the same server. This has several
implications, the most important being that the client will not
receive the original error status code, but instead will
receive a redirect status code. This in turn can confuse web
robots and other clients which try to determine if a URL is
valid using the status code. In addition, if you use a remote
URL in an ErrorDocument 401, the client will not
know to prompt the user for a password since it will not
receive the 401 status code. Therefore, if you use an
ErrorDocument 401 directive then it must refer to a local
document.
Microsoft Internet Explorer (MSIE) will by default ignore server-generated error messages when they are "too small" and substitute its own "friendly" error messages. The size threshold varies depending on the type of error, but in general, if you make your error document greater than 512 bytes, then MSIE will show the server-generated error rather than masking it. More information is available in Microsoft Knowledge Base article Q294807.
Although most error messages can be overriden, there are certain
circumstances where the internal messages are used regardless of the
setting of ErrorDocument. In
particular, if a malformed request is detected, normal request processing
will be immediately halted and the internal error message returned.
This is necessary to guard against security problems caused by
bad requests.
If you are using mod_proxy, you may wish to enable
ProxyErrorOverride so that you can provide
custom error messages on behalf of your Origin servers. If you don't enable ProxyErrorOverride,
Apache httpd will not generate custom error documents for proxied content.
| Descripción: | Location where the server will log errors |
|---|---|
| Sintaxis: | ErrorLog file-path|syslog[:facility] |
| Valor por defecto: | ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2) |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
The ErrorLog directive sets the name of
the file to which the server will log any errors it encounters. If
the file-path is not absolute then it is assumed to be
relative to the ServerRoot.
ErrorLog /var/log/httpd/error_log
If the file-path
begins with a pipe character "|" then it is assumed to be a
command to spawn to handle the error log.
ErrorLog "|/usr/local/bin/httpd_errors"
See the notes on piped logs for more information.
Using syslog instead of a filename enables logging
via syslogd(8) if the system supports it. The default is to use
syslog facility local7, but you can override this by
using the syslog:facility syntax where
facility can be one of the names usually documented in
syslog(1). The facility is effectively global, and if it is changed
in individual virtual hosts, the final facility specified affects the
entire server.
ErrorLog syslog:user
SECURITY: See the security tips document for details on why your security could be compromised if the directory where log files are stored is writable by anyone other than the user that starts the server.
When entering a file path on non-Unix platforms, care should be taken to make sure that only forward slashed are used even though the platform may allow the use of back slashes. In general it is a good idea to always use forward slashes throughout the configuration files.
| Descripción: | Format specification for error log entries |
|---|---|
| Sintaxis: | ErrorLog [connection|request] format |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache httpd 2.3.9 and later |
ErrorLogFormat allows to specify what
supplementary information is logged in the error log in addition to the
actual log message.
ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"
Specifying connection or request as first
paramter allows to specify additional formats, causing additional
information to be logged when the first message is logged for a specific
connection or request, respectivly. This additional information is only
logged once per connection/request. If a connection or request is processed
without causing any log message, the additional information is not logged
either.
It can happen that some format string items do not produce output. For
example, the Referer header is only present if the log message is
associated to a request and the log message happens at a time when the
Referer header has already been read from the client. If no output is
produced, the default behaviour is to delete everything from the preceeding
space character to the next space character. This means the log line is
implicitly divided into fields on non-whitespace to whitespace transitions.
If a format string item does not produce output, the whole field is
ommitted. For example, if the remote address %a in the log
format [%t] [%l] [%a] %M is not available, the surrounding
brackets are not logged either. Space characters can be escaped with a
backslash to prevent them from delimiting a field. The combination '% '
(percent space) is a zero-witdh field delimiter that does not produce any
output.
The above behaviour can be changed by adding modifiers to the format
string item. A - (minus) modifier causes a minus to be logged if the
respective item does not produce any output. In once-per-connection/request
formats, it is also possible to use the + (plus) modifier. If an
item with the plus modifier does not produce any output, the whole line is
ommitted.
A number as modifier can be used to assign a log severity level to a format item. The item will only be logged if the severity of the log message is not higher than the specified log severity level. The number can range from 1 (alert) over 4 (warn) and 7 (debug) to 15 (trace8).
Some format string items accept additional parameters in braces.
| Format String | Description |
|---|---|
%% |
The percent sign |
%...a |
Remote IP-address and port |
%...A |
Local IP-address and port |
%...{name}e |
Request environment variable name |
%...E |
APR/OS error status code and string |
%...F |
Source file name and line number of the log call |
%...{name}i |
Request header name |
%...k |
Number of keep-alive requests on this connection |
%...l |
Loglevel of the message |
%...L |
Log ID of the request |
%...{c}L |
Log ID of the connection |
%...{C}L |
Log ID of the connection if used in connection scope, empty otherwise |
%...m |
Name of the module logging the message |
%M |
The actual log message |
%...{name}n |
Request note name |
%...P |
Process ID of current process |
%...T |
Thread ID of current thread |
%...t |
The current time |
%...{u}t |
The current time including micro-seconds |
%...{cu}t |
The current time in compact ISO 8601 format, including micro-seconds |
%...v |
The canonical ServerName
of the current server. |
%...V |
The server name of the server serving the request according to the
UseCanonicalName
setting. |
\ (backslash space) |
Non-field delimiting space |
% (percent space) |
Field delimiter (no output) |
The log ID format %L produces a unique id for a connection
or request. This can be used to correlate which log lines belong to the
same connection or request, which request happens on which connection.
A %L format string is also available in
mod_log_config, to allow to correlate access log entries
with error log lines. If mod_unique_id is loaded, its
unique id will be used as log ID for requests.
ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P] %7F: %E: [client\ %a]
%M% ,\ referer\ %{Referer}i"
ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a]
%M% ,\ referer\ %{Referer}i"
ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"
ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"
ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"
ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"
ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"
| Descripción: | Keep track of extended status information for each request |
|---|---|
| Sintaxis: | ExtendedStatus On|Off |
| Valor por defecto: | ExtendedStatus Off[*] |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
This option tracks additional data per worker about the
currently executing request, and a utilization summary; you
can see these variables during runtime by configuring
mod_status. Note that other modules may
rely on this scoreboard.
This setting applies to the entire server, and cannot be enabled or disabled on a virtualhost-by-virtualhost basis. The collection of extended status information can slow down the server. Also note that this setting cannot be changed during a graceful restart.
Note that loading mod_status will change
the default behavior to ExtendedStatus On, while other
third party modules may do the same. Such modules rely on
collecting detailed information about the state of all workers.
The default is changed by mod_status beginning
with version 2.3.6; the previous default was always Off.
| Descripción: | File attributes used to create the ETag HTTP response header for static files |
|---|---|
| Sintaxis: | FileETag component ... |
| Valor por defecto: | FileETag INode MTime Size |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
The FileETag directive configures the file
attributes that are used to create the ETag (entity
tag) response header field when the document is based on a static file.
(The ETag value is used in cache management to save
network bandwidth.) The
FileETag directive allows you to choose
which of these -- if any -- should be used. The recognized keywords are:
FileETag INode MTime Size
ETag field will be
included in the responseThe INode, MTime, and Size
keywords may be prefixed with either + or -,
which allow changes to be made to the default setting inherited
from a broader scope. Any keyword appearing without such a prefix
immediately and completely cancels the inherited setting.
If a directory's configuration includes
FileETag INode MTime Size, and a
subdirectory's includes FileETag -INode,
the setting for that subdirectory (which will be inherited by
any sub-subdirectories that don't override it) will be equivalent to
FileETag MTime Size.
mod_dav_fs as a storage provider.
mod_dav_fs uses INode MTime Size
as a fixed format for ETag comparisons on conditional requests.
These conditional requests will break if the ETag format is
changed via FileETag.
mod_include,
since the response entity can change without a change of the INode, MTime, or Size
of the static file with embedded SSI directives.
| Descripción: | Contains directives that apply to matched filenames |
|---|---|
| Sintaxis: | <Files filename> ... </Files> |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
The <Files> directive
limits the scope of the enclosed directives by filename. It is comparable
to the <Directory>
and <Location>
directives. It should be matched with a </Files>
directive. The directives given within this section will be applied to
any object with a basename (last component of filename) matching the
specified filename. <Files>
sections are processed in the order they appear in the
configuration file, after the <Directory> sections and
.htaccess files are read, but before <Location> sections. Note
that <Files> can be nested
inside <Directory> sections to restrict the
portion of the filesystem they apply to.
The filename argument should include a filename, or
a wild-card string, where ? matches any single character,
and * matches any sequences of characters.
Regular expressions
can also be used, with the addition of the
~ character. For example:
<Files ~ "\.(gif|jpe?g|png)$">
would match most common Internet graphics formats. <FilesMatch> is preferred,
however.
Note that unlike <Directory> and <Location> sections, <Files> sections can be used inside
.htaccess files. This allows users to control access to
their own files, at a file-by-file level.
| Descripción: | Contains directives that apply to regular-expression matched filenames |
|---|---|
| Sintaxis: | <FilesMatch regex> ... </FilesMatch> |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
The <FilesMatch> directive
limits the scope of the enclosed directives by filename, just as the
<Files> directive
does. However, it accepts a regular
expression. For example:
<FilesMatch "\.(gif|jpe?g|png)$">
would match most common Internet graphics formats.
| Descripción: | Maximum number of pipelined responses above which they are flushed to the network |
|---|---|
| Sintaxis: | FlushMaxPipelined number |
| Valor por defecto: | FlushMaxPipelined 5 |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | 2.4.47 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Threshold above which pending data are flushed to the network |
|---|---|
| Sintaxis: | FlushMaxThreshold number-of-bytes |
| Valor por defecto: | FlushMaxThreshold 65535 |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | 2.4.47 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Forces all matching files to be served with the specified media type in the HTTP Content-Type header field |
|---|---|
| Sintaxis: | ForceType media-type|None |
| Contexto: | directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Moved to the core in Apache httpd 2.0 |
When placed into an .htaccess file or a
<Directory>, or
<Location> or
<Files>
section, this directive forces all matching files to be served
with the content type identification given by
media-type. For example, if you had a directory full of
GIF files, but did not want to label them all with .gif,
you might want to use:
ForceType image/gif
Note that this directive overrides other indirect media type
associations defined in mime.types or via the
AddType.
You can also override more general
ForceType settings
by using the value of None:
# force all files to be image/gif:
<Location /images>
ForceType image/gif
</Location>
# but normal mime-type associations here:
<Location /images/mixed>
ForceType None
</Location>
This directive primarily overrides the content types generated for static files served out of the filesystem. For resources other than static files, where the generator of the response typically specifies a Content-Type, this directive has no effect.
| Descripción: | Directory to write gmon.out profiling data to. |
|---|---|
| Sintaxis: | GprofDir /tmp/gprof/|/tmp/gprof/% |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
When the server has been compiled with gprof profiling support,
GprofDir causes gmon.out files to
be written to the specified directory when the process exits. If the
argument ends with a percent symbol ('%'), subdirectories are created
for each process id.
This directive currently only works with the prefork
MPM.
| Descripción: | Enables DNS lookups on client IP addresses |
|---|---|
| Sintaxis: | HostnameLookups On|Off|Double |
| Valor por defecto: | HostnameLookups Off |
| Contexto: | server config, virtual host, directory |
| Estado: | Core |
| Módulo: | core |
This directive enables DNS lookups so that host names can be
logged (and passed to CGIs/SSIs in REMOTE_HOST).
The value Double refers to doing double-reverse
DNS lookup. That is, after a reverse lookup is performed, a forward
lookup is then performed on that result. At least one of the IP
addresses in the forward lookup must match the original
address. (In "tcpwrappers" terminology this is called
PARANOID.)
Regardless of the setting, when mod_authz_host is
used for controlling access by hostname, a double reverse lookup
will be performed. This is necessary for security. Note that the
result of this double-reverse isn't generally available unless you
set HostnameLookups Double. For example, if only
HostnameLookups On and a request is made to an object
that is protected by hostname restrictions, regardless of whether
the double-reverse fails or not, CGIs will still be passed the
single-reverse result in REMOTE_HOST.
The default is Off in order to save the network
traffic for those sites that don't truly need the reverse
lookups done. It is also better for the end users because they
don't have to suffer the extra latency that a lookup entails.
Heavily loaded sites should leave this directive
Off, since DNS lookups can take considerable
amounts of time. The utility logresolve, compiled by
default to the bin subdirectory of your installation
directory, can be used to look up host names from logged IP addresses
offline.
| Descripción: | Modify restrictions on HTTP Request Messages |
|---|---|
| Sintaxis: | HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods]
[Allow0.9|Require1.0] |
| Valor por defecto: | HttpProtocolOptions Strict LenientMethods Allow0.9 |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | 2.2.32 or 2.4.24 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Contains directives that apply only if a condition is satisfied by a request at runtime |
|---|---|
| Sintaxis: | <If expression> ... </If> |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
The <If> directive
evaluates an expression at runtime, and applies the enclosed
directives if and only if the expression evaluates to true.
For example:
<If "$req{Host} = ''">
would match HTTP/1.0 requests without a Host: header.
You may compare the value of any variable in the request headers ($req), response headers ($resp) or environment ($env) in your expression.
Apart from =, If can use the IN
operator to compare if the expression is in a given range:
<If %{REQUEST_METHOD} IN GET,HEAD,OPTIONS>
<If> has the same precedence
and usage as <Files>| Descripción: | Encloses directives that will be processed only if a test is true at startup |
|---|---|
| Sintaxis: | <IfDefine [!]parameter-name> ...
</IfDefine> |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
The <IfDefine test>...</IfDefine>
section is used to mark directives that are conditional. The
directives within an <IfDefine>
section are only processed if the test is true. If
test is false, everything between the start and end markers is
ignored.
The test in the <IfDefine> section directive can be one of two forms:
!parameter-nameIn the former case, the directives between the start and end markers are only processed if the parameter named parameter-name is defined. The second format reverses the test, and only processes the directives if parameter-name is not defined.
The parameter-name argument is a define as given on the
httpd command line via -Dparameter
at the time the server was started or by the Define directive.
<IfDefine> sections are
nest-able, which can be used to implement simple
multiple-parameter tests. Example:
httpd -DReverseProxy -DUseCache -DMemCache ...
# httpd.conf
<IfDefine ReverseProxy>
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
<IfDefine UseCache>
LoadModule cache_module modules/mod_cache.so
<IfDefine MemCache>
LoadModule mem_cache_module modules/mod_mem_cache.so
</IfDefine>
<IfDefine !MemCache>
LoadModule cache_disk_module modules/mod_cache_disk.so
</IfDefine>
</IfDefine>
</IfDefine>
| Descripción: | Encloses directives that are processed conditional on the presence or absence of a specific directive |
|---|---|
| Sintaxis: | <IfDirective [!]directive-name> ...
</IfDirective> |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in 2.4.34 and later. |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Encloses directives that will be processed only if file exists at startup |
|---|---|
| Sintaxis: | <IfFile [!]filename> ...
</IfFile> |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in 2.4.34 and later. |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Encloses directives that are processed conditional on the presence or absence of a specific module |
|---|---|
| Sintaxis: | <IfModule [!]module-file|module-identifier> ...
</IfModule> |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Module identifiers are available in version 2.1 and later. |
The <IfModule test>...</IfModule>
section is used to mark directives that are conditional on the presence of
a specific module. The directives within an <IfModule> section are only processed if the test
is true. If test is false, everything between the start and
end markers is ignored.
The test in the <IfModule> section directive can be one of two forms:
In the former case, the directives between the start and end
markers are only processed if the module named module
is included in Apache httpd -- either compiled in or
dynamically loaded using LoadModule. The second format reverses the test,
and only processes the directives if module is
not included.
The module argument can be either the module identifier or
the file name of the module, at the time it was compiled. For example,
rewrite_module is the identifier and
mod_rewrite.c is the file name. If a module consists of
several source files, use the name of the file containing the string
STANDARD20_MODULE_STUFF.
<IfModule> sections are
nest-able, which can be used to implement simple multiple-module
tests.
<IfModule>
sections.| Descripción: | Encloses directives that are processed conditional on the presence or absence of a specific section directive |
|---|---|
| Sintaxis: | <IfSection [!]section-name> ...
</IfSection> |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in 2.4.34 and later. |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Includes other configuration files from within the server configuration files |
|---|---|
| Sintaxis: | Include [optional|strict] file-path|directory-path|wildcard |
| Contexto: | server config, virtual host, directory |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Wildcard matching available in 2.0.41 and later, directory wildcard matching available in 2.3.6 and later |
This directive allows inclusion of other configuration files from within the server configuration files.
Shell-style (fnmatch()) wildcard characters can be used
in the filename or directory parts of the path to include several files
at once, in alphabetical order. In addition, if
Include points to a directory, rather than a file,
Apache httpd will read all files in that directory and any subdirectory.
However, including entire directories is not recommended, because it is
easy to accidentally leave temporary files in a directory that can cause
httpd to fail. Instead, we encourage you to use the
wildcard syntax shown below, to include files that match a particular
pattern, such as *.conf, for example.
When a wildcard is specified for a file component of
the path, and no file matches the wildcard, the
Include
directive will be silently ignored. When a wildcard is
specified for a directory component of the path, and
no directory matches the wildcard, the
Include directive will
fail with an error saying the directory cannot be found.
For further control over the behaviour of the server when no files or directories match, prefix the path with the modifiers optional or strict. If optional is specified, any wildcard file or directory that does not match will be silently ignored. If strict is specified, any wildcard file or directory that does not match at least one file will cause server startup to fail.
When a directory or file component of the path is
specified exactly, and that directory or file does not exist,
Include directive will fail with an
error saying the file or directory cannot be found.
The file path specified may be an absolute path, or may be relative
to the ServerRoot directory.
Examples:
Include /usr/local/apache2/conf/ssl.conf
Include /usr/local/apache2/conf/vhosts/*.conf
Or, providing paths relative to your ServerRoot directory:
Include conf/ssl.conf
Include conf/vhosts/*.conf
Wildcards may be included in the directory or file portion of the path. In the following example, the server will fail to load if no directories match conf/vhosts/*, but will load successfully if no files match *.conf.
Include conf/vhosts/*/vhost.conf
Include conf/vhosts/*/*.conf
In this example, the server will fail to load if either conf/vhosts/* matches no directories, or if *.conf matches no files:
Include strict conf/vhosts/*/*.conf
In this example, the server load successfully if either conf/vhosts/* matches no directories, or if *.conf matches no files:
Include optional conf/vhosts/*/*.conf
| Descripción: | Includes other configuration files from within the server configuration files |
|---|---|
| Sintaxis: | IncludeOptional file-path|directory-path|wildcard |
| Contexto: | server config, virtual host, directory |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in 2.3.6 and later. Not existent file paths without wildcards do not cause SyntaxError after 2.4.30 |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Enables HTTP persistent connections |
|---|---|
| Sintaxis: | KeepAlive On|Off |
| Valor por defecto: | KeepAlive On |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
The Keep-Alive extension to HTTP/1.0 and the persistent
connection feature of HTTP/1.1 provide long-lived HTTP sessions
which allow multiple requests to be sent over the same TCP
connection. In some cases this has been shown to result in an
almost 50% speedup in latency times for HTML documents with
many images. To enable Keep-Alive connections, set
KeepAlive On.
For HTTP/1.0 clients, Keep-Alive connections will only be used if they are specifically requested by a client. In addition, a Keep-Alive connection with an HTTP/1.0 client can only be used when the length of the content is known in advance. This implies that dynamic content such as CGI output, SSI pages, and server-generated directory listings will generally not use Keep-Alive connections to HTTP/1.0 clients. For HTTP/1.1 clients, persistent connections are the default unless otherwise specified. If the client requests it, chunked encoding will be used in order to send content of unknown length over persistent connections.
When a client uses a Keep-Alive connection it will be counted
as a single "request" for the MaxConnectionsPerChild directive, regardless
of how many requests are sent using the connection.
| Descripción: | Amount of time the server will wait for subsequent requests on a persistent connection |
|---|---|
| Sintaxis: | KeepAliveTimeout num[ms] |
| Valor por defecto: | KeepAliveTimeout 5 |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Specifying a value in milliseconds is available in Apache httpd 2.3.2 and later |
The number of seconds Apache httpd will wait for a subsequent
request before closing the connection. By adding a postfix of ms the
timeout can be also set in milliseconds. Once a request has been
received, the timeout value specified by the
Timeout directive applies.
Setting KeepAliveTimeout to a high value
may cause performance problems in heavily loaded servers. The
higher the timeout, the more server processes will be kept
occupied waiting on connections with idle clients.
In a name-based virtual host context, the value of the first
defined virtual host (the default host) in a set of NameVirtualHost will be used.
The other values will be ignored.
| Descripción: | Restrict enclosed access controls to only certain HTTP methods |
|---|---|
| Sintaxis: | <Limit method [method] ... > ...
</Limit> |
| Contexto: | directory, .htaccess |
| Anula: | AuthConfig, Limit |
| Estado: | Core |
| Módulo: | core |
Access controls are normally effective for
all access methods, and this is the usual
desired behavior. In the general case, access control
directives should not be placed within a
<Limit> section.
The purpose of the <Limit>
directive is to restrict the effect of the access controls to the
nominated HTTP methods. For all other methods, the access
restrictions that are enclosed in the <Limit> bracket will have no
effect. The following example applies the access control
only to the methods POST, PUT, and
DELETE, leaving all other methods unprotected:
<Limit POST PUT DELETE>
Require valid-user
</Limit>
The method names listed can be one or more of: GET,
POST, PUT, DELETE,
CONNECT, OPTIONS,
PATCH, PROPFIND, PROPPATCH,
MKCOL, COPY, MOVE,
LOCK, and UNLOCK. The method name is
case-sensitive. If GET is used it will also
restrict HEAD requests. The TRACE method
cannot be limited (see TraceEnable).
<LimitExcept> section should always be
used in preference to a <Limit>
section when restricting access, since a <LimitExcept> section provides protection
against arbitrary methods.The <Limit> and
<LimitExcept>
directives may be nested. In this case, each successive level of
<Limit> or <LimitExcept> directives must
further restrict the set of methods to which access controls apply.
<Limit> or
<LimitExcept> directives with
the Require directive,
note that the first Require
to succeed authorizes the request, regardless of the presence of other
Require directives.For example, given the following configuration, all users will
be authorized for POST requests, and the
Require group editors directive will be ignored
in all cases:
<LimitExcept GET>
Require valid-user
</LimitExcept>
<Limit POST>
Require group editors
</Limit>
| Descripción: | Restrict access controls to all HTTP methods except the named ones |
|---|---|
| Sintaxis: | <LimitExcept method [method] ... > ...
</LimitExcept> |
| Contexto: | directory, .htaccess |
| Anula: | AuthConfig, Limit |
| Estado: | Core |
| Módulo: | core |
<LimitExcept> and
</LimitExcept> are used to enclose
a group of access control directives which will then apply to any
HTTP access method not listed in the arguments;
i.e., it is the opposite of a <Limit> section and can be used to control
both standard and nonstandard/unrecognized methods. See the
documentation for <Limit> for more details.
For example:
<LimitExcept POST GET>
Require valid-user
</LimitExcept>
| Descripción: | Determine maximum number of internal redirects and nested subrequests |
|---|---|
| Sintaxis: | LimitInternalRecursion number [number] |
| Valor por defecto: | LimitInternalRecursion 10 |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache httpd 2.0.47 and later |
An internal redirect happens, for example, when using the Action directive, which internally
redirects the original request to a CGI script. A subrequest is Apache httpd's
mechanism to find out what would happen for some URI if it were requested.
For example, mod_dir uses subrequests to look for the
files listed in the DirectoryIndex
directive.
LimitInternalRecursion prevents the server
from crashing when entering an infinite loop of internal redirects or
subrequests. Such loops are usually caused by misconfigurations.
The directive stores two different limits, which are evaluated on per-request basis. The first number is the maximum number of internal redirects, that may follow each other. The second number determines, how deep subrequests may be nested. If you specify only one number, it will be assigned to both limits.
LimitInternalRecursion 5
| Descripción: | Restricts the total size of the HTTP request body sent from the client |
|---|---|
| Sintaxis: | LimitRequestBody bytes |
| Valor por defecto: | LimitRequestBody 0 |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
This directive specifies the number of bytes from 0 (meaning unlimited) to 2147483647 (2GB) that are allowed in a request body. See the note below for the limited applicability to proxy requests.
The LimitRequestBody directive allows
the user to set a limit on the allowed size of an HTTP request
message body within the context in which the directive is given
(server, per-directory, per-file or per-location). If the client
request exceeds that limit, the server will return an error
response instead of servicing the request. The size of a normal
request message body will vary greatly depending on the nature of
the resource and the methods allowed on that resource. CGI scripts
typically use the message body for retrieving form information.
Implementations of the PUT method will require
a value at least as large as any representation that the server
wishes to accept for that resource.
This directive gives the server administrator greater control over abnormal client request behavior, which may be useful for avoiding some forms of denial-of-service attacks.
If, for example, you are permitting file upload to a particular location, and wish to limit the size of the uploaded file to 100K, you might use the following directive:
LimitRequestBody 102400
For a full description of how this directive is interpreted by
proxy requests, see the mod_proxy documentation.
| Descripción: | Limits the number of HTTP request header fields that will be accepted from the client |
|---|---|
| Sintaxis: | LimitRequestFields number |
| Valor por defecto: | LimitRequestFields 100 |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
Number is an integer from 0 (meaning unlimited) to
32767. The default value is defined by the compile-time
constant DEFAULT_LIMIT_REQUEST_FIELDS (100 as
distributed).
The LimitRequestFields directive allows
the server administrator to modify the limit on the number of
request header fields allowed in an HTTP request. A server needs
this value to be larger than the number of fields that a normal
client request might include. The number of request header fields
used by a client rarely exceeds 20, but this may vary among
different client implementations, often depending upon the extent
to which a user has configured their browser to support detailed
content negotiation. Optional HTTP extensions are often expressed
using request header fields.
This directive gives the server administrator greater control over abnormal client request behavior, which may be useful for avoiding some forms of denial-of-service attacks. The value should be increased if normal clients see an error response from the server that indicates too many fields were sent in the request.
For example:
LimitRequestFields 50
When name-based virtual hosting is used, the value for this
directive is taken from the default (first-listed) virtual host for the
NameVirtualHost the connection was mapped to.
| Descripción: | Limits the size of the HTTP request header allowed from the client |
|---|---|
| Sintaxis: | LimitRequestFieldSize bytes |
| Valor por defecto: | LimitRequestFieldSize 8190 |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
This directive specifies the number of bytes that will be allowed in an HTTP request header.
The LimitRequestFieldSize directive
allows the server administrator to reduce or increase the limit
on the allowed size of an HTTP request header field. A server
needs this value to be large enough to hold any one header field
from a normal client request. The size of a normal request header
field will vary greatly among different client implementations,
often depending upon the extent to which a user has configured
their browser to support detailed content negotiation. SPNEGO
authentication headers can be up to 12392 bytes.
This directive gives the server administrator greater control over abnormal client request behavior, which may be useful for avoiding some forms of denial-of-service attacks.
For example:
LimitRequestFieldSize 4094
When name-based virtual hosting is used, the value for this
directive is taken from the default (first-listed) virtual host for the
NameVirtualHost the connection was mapped to.
| Descripción: | Limit the size of the HTTP request line that will be accepted from the client |
|---|---|
| Sintaxis: | LimitRequestLine bytes |
| Valor por defecto: | LimitRequestLine 8190 |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
This directive sets the number of bytes that will be allowed on the HTTP request-line.
The LimitRequestLine directive allows
the server administrator to reduce or increase the limit on the allowed size
of a client's HTTP request-line. Since the request-line consists of the
HTTP method, URI, and protocol version, the
LimitRequestLine directive places a
restriction on the length of a request-URI allowed for a request
on the server. A server needs this value to be large enough to
hold any of its resource names, including any information that
might be passed in the query part of a GET request.
This directive gives the server administrator greater control over abnormal client request behavior, which may be useful for avoiding some forms of denial-of-service attacks.
For example:
LimitRequestLine 4094
When name-based virtual hosting is used, the value for this
directive is taken from the default (first-listed) virtual host for the
NameVirtualHost the connection was mapped to.
| Descripción: | Limits the size of an XML-based request body |
|---|---|
| Sintaxis: | LimitXMLRequestBody bytes |
| Valor por defecto: | LimitXMLRequestBody 1000000 |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
Limit (in bytes) on maximum size of an XML-based request
body. A value of 0 will disable any checking.
Example:
LimitXMLRequestBody 0
| Descripción: | Applies the enclosed directives only to matching URLs |
|---|---|
| Sintaxis: | <Location
URL-path|URL> ... </Location> |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
The <Location> directive
limits the scope of the enclosed directives by URL. It is similar to the
<Directory>
directive, and starts a subsection which is terminated with a
</Location> directive. <Location> sections are processed in the
order they appear in the configuration file, after the <Directory> sections and
.htaccess files are read, and after the <Files> sections.
<Location> sections operate
completely outside the filesystem. This has several consequences.
Most importantly, <Location>
directives should not be used to control access to filesystem
locations. Since several different URLs may map to the same
filesystem location, such access controls may by circumvented.
The enclosed directives will be applied to the request if the path component of the URL meets any of the following criteria:
In the example below, where no trailing slash is used, requests to /private1, /private1/ and /private1/file.txt will have the enclosed directives applied, but /private1other would not.
<Location /private1>
...
In the example below, where a trailing slash is used, requests to /private2/ and /private2/file.txt will have the enclosed directives applied, but /private2 and /private2other would not.
<Location /private2/>
...
<Location>Use <Location> to apply
directives to content that lives outside the filesystem. For
content that lives in the filesystem, use <Directory> and <Files>. An exception is
<Location />, which is an easy way to
apply a configuration to the entire server.
For all origin (non-proxy) requests, the URL to be matched is a
URL-path of the form /path/. No scheme, hostname,
port, or query string may be included. For proxy requests, the
URL to be matched is of the form
scheme://servername/path, and you must include the
prefix.
The URL may use wildcards. In a wild-card string, ? matches
any single character, and * matches any sequences of
characters. Neither wildcard character matches a / in the URL-path.
Regular expressions
can also be used, with the addition of the ~
character. For example:
<Location ~ "/(extra|special)/data">
would match URLs that contained the substring /extra/data
or /special/data. The directive <LocationMatch> behaves
identical to the regex version of <Location>, and is preferred, for the
simple reason that ~ is hard to distinguish from
- in many fonts.
The <Location>
functionality is especially useful when combined with the
SetHandler
directive. For example, to enable status requests, but allow them
only from browsers at example.com, you might use:
<Location /status>
SetHandler server-status
Require host example.com
</Location>
The slash character has special meaning depending on where in a
URL it appears. People may be used to its behavior in the filesystem
where multiple adjacent slashes are frequently collapsed to a single
slash (i.e., /home///foo is the same as
/home/foo). In URL-space this is not necessarily true.
The <LocationMatch>
directive and the regex version of <Location> require you to explicitly specify multiple
slashes if that is your intention.
For example, <LocationMatch ^/abc> would match
the request URL /abc but not the request URL
//abc. The (non-regex) <Location> directive behaves similarly when used for
proxy requests. But when (non-regex) <Location> is used for non-proxy requests it will
implicitly match multiple slashes with a single slash. For example,
if you specify <Location /abc/def> and the
request is to /abc//def then it will match.
LocationMatch| Descripción: | Applies the enclosed directives only to regular-expression matching URLs |
|---|---|
| Sintaxis: | <LocationMatch
regex> ... </LocationMatch> |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
The <LocationMatch> directive
limits the scope of the enclosed directives by URL, in an identical manner
to <Location>. However,
it takes a regular expression
as an argument instead of a simple string. For example:
<LocationMatch "/(extra|special)/data">
would match URLs that contained the substring /extra/data
or /special/data.
| Descripción: | Controls the verbosity of the ErrorLog |
|---|---|
| Sintaxis: | LogLevel [module:]level
[module:level] ...
|
| Valor por defecto: | LogLevel warn |
| Contexto: | server config, virtual host, directory |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Per-module and per-directory configuration is available in Apache HTTP Server 2.3.6 and later |
LogLevel adjusts the verbosity of the
messages recorded in the error logs (see ErrorLog directive). The following
levels are available, in order of decreasing
significance:
| Level | Description | Example |
|---|---|---|
emerg |
Emergencies - system is unusable. | "Child cannot open lock file. Exiting" |
alert |
Action must be taken immediately. | "getpwuid: couldn't determine user name from uid" |
crit |
Critical Conditions. | "socket: Failed to get a socket, exiting child" |
error |
Error conditions. | "Premature end of script headers" |
warn |
Warning conditions. | "child process 1234 did not exit, sending another SIGHUP" |
notice |
Normal but significant condition. | "httpd: caught SIGBUS, attempting to dump core in ..." |
info |
Informational. | "Server seems busy, (you may need to increase StartServers, or Min/MaxSpareServers)..." |
debug |
Debug-level messages | "Opening config file ..." |
trace1 |
Trace messages | "proxy: FTP: control connection complete" |
trace2 |
Trace messages | "proxy: CONNECT: sending the CONNECT request to the remote proxy" |
trace3 |
Trace messages | "openssl: Handshake: start" |
trace4 |
Trace messages | "read from buffered SSL brigade, mode 0, 17 bytes" |
trace5 |
Trace messages | "map lookup FAILED: map=rewritemap key=keyname" |
trace6 |
Trace messages | "cache lookup FAILED, forcing new map lookup" |
trace7 |
Trace messages, dumping large amounts of data | "| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |" |
trace8 |
Trace messages, dumping large amounts of data | "| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |" |
When a particular level is specified, messages from all
other levels of higher significance will be reported as well.
E.g., when LogLevel info is specified,
then messages with log levels of notice and
warn will also be posted.
Using a level of at least crit is
recommended.
For example:
LogLevel notice
When logging to a regular file messages of the level
notice cannot be suppressed and thus are always
logged. However, this doesn't apply when logging is done
using syslog.
Specifying a level without a module name will reset the level
for all modules to that level. Specifying a level with a module
name will set the level for that module only. It is possible to
use the module source file name, the module identifier, or the
module identifier with the trailing _module omitted
as module specification. This means the following three specifications
are equivalent:
LogLevel info ssl:warn
LogLevel info mod_ssl.c:warn
LogLevel info ssl_module:warn
It is also possible to change the level per directory:
LogLevel info
<Directory /usr/local/apache/htdocs/app>
LogLevel debug
</Files>
| Descripción: | Number of requests allowed on a persistent connection |
|---|---|
| Sintaxis: | MaxKeepAliveRequests number |
| Valor por defecto: | MaxKeepAliveRequests 100 |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
The MaxKeepAliveRequests directive
limits the number of requests allowed per connection when
KeepAlive is on. If it is
set to 0, unlimited requests will be allowed. We
recommend that this setting be kept to a high value for maximum
server performance.
For example:
MaxKeepAliveRequests 500
| Descripción: | Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete
resource |
|---|---|
| Sintaxis: | MaxRangeOverlaps default | unlimited | none | number-of-ranges |
| Valor por defecto: | MaxRangeOverlaps 20 |
| Contexto: | server config, virtual host, directory |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache HTTP Server 2.3.15 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Number of range reversals (eg: 100-200,50-70) allowed before returning the complete
resource |
|---|---|
| Sintaxis: | MaxRangeReversals default | unlimited | none | number-of-ranges |
| Valor por defecto: | MaxRangeReversals 20 |
| Contexto: | server config, virtual host, directory |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache HTTP Server 2.3.15 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Number of ranges allowed before returning the complete resource |
|---|---|
| Sintaxis: | MaxRanges default | unlimited | none | number-of-ranges |
| Valor por defecto: | MaxRanges 200 |
| Contexto: | server config, virtual host, directory |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache HTTP Server 2.3.15 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Controls whether the server merges consecutive slashes in URLs. |
|---|---|
| Sintaxis: | MergeSlashes ON|OFF |
| Valor por defecto: | MergeSlashes ON |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Added in 2.4.39 |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Determines whether trailers are merged into headers |
|---|---|
| Sintaxis: | MergeTrailers [on|off] |
| Valor por defecto: | MergeTrailers off |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | 2.4.11 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Configures mutex mechanism and lock file directory for all or specified mutexes |
|---|---|
| Sintaxis: | Mutex mechanism [default|mutex-name] ... [OmitPID] |
| Valor por defecto: | Mutex default |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache HTTP Server 2.3.4 and later |
The Mutex directive sets the mechanism,
and optionally the lock file location, that httpd and modules use
to serialize access to resources. Specify default as
the first argument to change the settings for all mutexes; specify
a mutex name (see table below) as the first argument to override
defaults only for that mutex.
The Mutex directive is typically used in
the following exceptional situations:
This directive only configures mutexes which have been registered
with the core server using the ap_mutex_register() API.
All modules bundled with httpd support the Mutex
directive, but third-party modules may not. Consult the documentation
of the third-party module, which must indicate the mutex name(s) which
can be configured if this directive is supported.
The following mutex mechanisms are available:
default | yes
This selects the default locking implementation, as determined by
APR. The default locking implementation can
be displayed by running httpd with the
-V option.
none | no
This effectively disables the mutex, and is only allowed for a mutex if the module indicates that it is a valid choice. Consult the module documentation for more information.
posixsem
This is a mutex variant based on a Posix semaphore.
The semaphore ownership is not recovered if a thread in the process holding the mutex segfaults, resulting in a hang of the web server.
sysvsem
This is a mutex variant based on a SystemV IPC semaphore.
It is possible to "leak" SysV semaphores if processes crash before the semaphore is removed.
The semaphore API allows for a denial of service attack by any
CGIs running under the same uid as the webserver (i.e.,
all CGIs, unless you use something like suexec
or cgiwrapper).
sem
This selects the "best" available semaphore implementation, choosing between Posix and SystemV IPC semaphores, in that order.
pthread
This is a mutex variant based on cross-process Posix thread mutexes.
On most systems, if a child process terminates abnormally while holding a mutex that uses this implementation, the server will deadlock and stop responding to requests. When this occurs, the server will require a manual restart to recover.
Solaris is a notable exception as it provides a mechanism which usually allows the mutex to be recovered after a child process terminates abnormally while holding a mutex.
If your system implements the
pthread_mutexattr_setrobust_np() function, you may be able
to use the pthread option safely.
fcntl:/path/to/mutex
This is a mutex variant where a physical (lock-)file and the
fcntl() function are used as the mutex.
When multiple mutexes based on this mechanism are used within
multi-threaded, multi-process environments, deadlock errors (EDEADLK)
can be reported for valid mutex operations if fcntl()
is not thread-aware, such as on Solaris.
flock:/path/to/mutex
This is similar to the fcntl:/path/to/mutex method
with the exception that the flock() function is used to
provide file locking.
file:/path/to/mutex
This selects the "best" available file locking implementation,
choosing between fcntl and flock, in that
order.
Most mechanisms are only available on selected platforms, where the underlying platform and APR support it. Mechanisms which aren't available on all platforms are posixsem, sysvsem, sem, pthread, fcntl, flock, and file.
With the file-based mechanisms fcntl and flock,
the path, if provided, is a directory where the lock file will be created.
The default directory is httpd's run-time file directory relative to
ServerRoot. Always use a local disk
filesystem for /path/to/mutex and never a directory residing
on a NFS- or AFS-filesystem. The basename of the file will be the mutex
type, an optional instance string provided by the module, and unless the
OmitPID keyword is specified, the process id of the httpd
parent process will be appended to to make the file name unique, avoiding
conflicts when multiple httpd instances share a lock file directory. For
example, if the mutex name is mpm-accept and the lock file
directory is /var/httpd/locks, the lock file name for the
httpd instance with parent process id 12345 would be
/var/httpd/locks/mpm-accept.12345.
It is best to avoid putting mutex files in a world-writable
directory such as /var/tmp because someone could create
a denial of service attack and prevent the server from starting by
creating a lockfile with the same name as the one the server will try
to create.
The following table documents the names of mutexes used by httpd and bundled modules.
| Mutex name | Module(s) | Protected resource |
|---|---|---|
mpm-accept |
prefork and worker MPMs |
incoming connections, to avoid the thundering herd problem; for more information, refer to the performance tuning documentation |
authdigest-client |
mod_auth_digest |
client list in shared memory |
authdigest-opaque |
mod_auth_digest |
counter in shared memory |
ldap-cache |
mod_ldap |
LDAP result cache |
rewrite-map |
mod_rewrite |
communication with external mapping programs, to avoid intermixed I/O from multiple requests |
ssl-cache |
mod_ssl |
SSL session cache |
ssl-stapling |
mod_ssl |
OCSP stapling response cache |
watchdog-callback |
mod_watchdog |
callback function of a particular client module |
The OmitPID keyword suppresses the addition of the httpd
parent process id from the lock file name.
In the following example, the mutex mechanism for the MPM accept
mutex will be changed from the compiled-in default to fcntl,
with the associated lock file created in directory
/var/httpd/locks. The mutex mechanism for all other mutexes
will be changed from the compiled-in default to sysvsem.
Mutex default sysvsem
Mutex mpm-accept fcntl:/var/httpd/locks
| Descripción: | Designates an IP address for name-virtual hosting |
|---|---|
| Sintaxis: | NameVirtualHost addr[:port] |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
A single NameVirtualHost directive
identifies a set of identical virtual hosts on which the server will
further select from on the basis of the hostname
requested by the client. The NameVirtualHost
directive is a required directive if you want to configure
name-based virtual hosts.
This directive, and the corresponding VirtualHost,
must be qualified with a port number if the server supports both HTTP
and HTTPS connections.
Although addr can be a hostname, it is recommended that you always use an IP address or a wildcard. A wildcard NameVirtualHost matches only virtualhosts that also have a literal wildcard as their argument.
In cases where a firewall or other proxy receives the requests and forwards them on a different IP address to the server, you must specify the IP address of the physical interface on the machine which will be servicing the requests.
In the example below, requests received on interface 192.0.2.1 and port 80 will only select among the first two virtual hosts. Requests received on port 80 on any other interface will only select among the third and fourth virtual hosts. In the common case where the interface isn't important to the mapping, only the "*:80" NameVirtualHost and VirtualHost directives are necessary.
NameVirtualHost 192.0.2.1:80
NameVirtualHost *:80
<VirtualHost 192.0.2.1:80>
ServerName namebased-a.example.com
</VirtualHost>
<VirtualHost 192.0.2.1:80>
Servername namebased-b.example.com
</VirtualHost>
<VirtualHost *:80>
ServerName namebased-c.example.com
</VirtualHost>
<VirtualHost *:80>
ServerName namebased-d.example.com
</VirtualHost>
If no matching virtual host is found, then the first listed virtual host that matches the IP address and port will be used.
IPv6 addresses must be enclosed in square brackets, as shown in the following example:
NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
<VirtualHost>
directiveNote that the argument to the <VirtualHost> directive must
exactly match the argument to the NameVirtualHost directive.
NameVirtualHost 192.0.2.2:80
<VirtualHost 192.0.2.2:80>
# ...
</VirtualHost>
| Descripción: | Configures what features are available in a particular directory |
|---|---|
| Sintaxis: | Options
[+|-]option [[+|-]option] ... |
| Valor por defecto: | Options All |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | Options |
| Estado: | Core |
| Módulo: | core |
The Options directive controls which
server features are available in a particular directory.
option can be set to None, in which
case none of the extra features are enabled, or one or more of
the following:
AllMultiViews. This is the default
setting.ExecCGImod_cgi
is permitted.FollowSymLinksEven though the server follows the symlink it does not
change the pathname used to match against <Directory> sections.
Note also, that this option gets ignored if set
inside a <Location>
section.
Omitting this option should not be considered a security restriction, since symlink testing is subject to race conditions that make it circumventable.
Includesmod_include
are permitted.IncludesNOEXEC#exec
cmd and #exec cgi are disabled. It is still
possible to #include virtual CGI scripts from
ScriptAliased
directories.IndexesDirectoryIndex
(e.g., index.html) in that directory, then
mod_autoindex will return a formatted listing
of the directory.MultiViewsmod_negotiation.
This option gets ignored if set
anywhere other than <Directory>, as mod_negotiation
needs real resources to compare against and evaluate from.
SymLinksIfOwnerMatchThis option gets ignored if
set inside a <Location> section.
This option should not be considered a security restriction, since symlink testing is subject to race conditions that make it circumventable.
Normally, if multiple Options could
apply to a directory, then the most specific one is used and
others are ignored; the options are not merged. (See how sections are merged.)
However if all the options on the
Options directive are preceded by a
+ or - symbol, the options are
merged. Any options preceded by a + are added to the
options currently in force, and any options preceded by a
- are removed from the options currently in
force.
Mixing Options with a + or
- with those without is not valid syntax, and is likely
to cause unexpected results.
For example, without any + and - symbols:
<Directory /web/docs>
Options Indexes FollowSymLinks
</Directory>
<Directory /web/docs/spec>
Options Includes
</Directory>
then only Includes will be set for the
/web/docs/spec directory. However if the second
Options directive uses the + and
- symbols:
<Directory /web/docs>
Options Indexes FollowSymLinks
</Directory>
<Directory /web/docs/spec>
Options +Includes -Indexes
</Directory>
then the options FollowSymLinks and
Includes are set for the /web/docs/spec
directory.
Using -IncludesNOEXEC or
-Includes disables server-side includes completely
regardless of the previous setting.
The default in the absence of any other settings is
All.
| Descripción: | Protocol for a listening socket |
|---|---|
| Sintaxis: | Protocol protocol |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache 2.1.5 and later. On Windows from Apache 2.3.3 and later. |
This directive specifies the protocol used for a specific listening socket.
The protocol is used to determine which module should handle a request, and
to apply protocol specific optimizations with the AcceptFilter
directive.
You only need to set the protocol if you are running on non-standard ports, otherwise http is assumed for port 80 and https for port 443.
For example, if you are running https on a non-standard port, specify the protocol explicitly:
Protocol https
You can also specify the protocol using the Listen directive.
AcceptFilterListen| Descripción: | Protocols available for a server/virtual host |
|---|---|
| Sintaxis: | Protocols protocol ... |
| Valor por defecto: | Protocols http/1.1 |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Only available from Apache 2.4.17 and later. |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Determines if order of Protocols determines precedence during negotiation |
|---|---|
| Sintaxis: | ProtocolsHonorOrder On|Off |
| Valor por defecto: | ProtocolsHonorOrder On |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Only available from Apache 2.4.17 and later. |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Controls whether the REDIRECT_URL environment variable is fully qualified |
|---|---|
| Sintaxis: | QualifyRedirectURL On|Off |
| Valor por defecto: | QualifyRedirectURL Off |
| Contexto: | server config, virtual host, directory |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Directive supported in 2.4.18 and later. 2.4.17 acted as if 'QualifyRedirectURL On' was configured. |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Size of the buffers used to read data |
|---|---|
| Sintaxis: | ReadBufferSize bytes |
| Valor por defecto: | ReadBufferSize 8192 |
| Contexto: | server config, virtual host, directory |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | 2.4.27 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Allow to configure global/default options for regexes |
|---|---|
| Sintaxis: | RegexDefaultOptions [none] [+|-]option [[+|-]option] ... |
| Valor por defecto: | RegexDefaultOptions DOTALL DOLLAR_ENDONLY |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Only available from Apache 2.4.30 and later. |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Register non-standard HTTP methods |
|---|---|
| Sintaxis: | RegisterHttpMethod method [method [...]] |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache HTTP Server 2.4.24 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Limits the CPU consumption of processes launched by Apache httpd children |
|---|---|
| Sintaxis: | RLimitCPU seconds|max [seconds|max] |
| Valor por defecto: | Unset; uses operating system defaults |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
Takes 1 or 2 parameters. The first parameter sets the soft
resource limit for all processes and the second parameter sets
the maximum resource limit. Either parameter can be a number,
or max to indicate to the server that the limit should
be set to the maximum allowed by the operating system
configuration. Raising the maximum resource limit requires that
the server is running as root, or in the initial startup
phase.
This applies to processes forked off from Apache httpd children servicing requests, not the Apache httpd children themselves. This includes CGI scripts and SSI exec commands, but not any processes forked off from the Apache httpd parent such as piped logs.
CPU resource limits are expressed in seconds per process.
| Descripción: | Limits the memory consumption of processes launched by Apache httpd children |
|---|---|
| Sintaxis: | RLimitMEM bytes|max [bytes|max] |
| Valor por defecto: | Unset; uses operating system defaults |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
Takes 1 or 2 parameters. The first parameter sets the soft
resource limit for all processes and the second parameter sets
the maximum resource limit. Either parameter can be a number,
or max to indicate to the server that the limit should
be set to the maximum allowed by the operating system
configuration. Raising the maximum resource limit requires that
the server is running as root, or in the initial startup
phase.
This applies to processes forked off from Apache httpd children servicing requests, not the Apache httpd children themselves. This includes CGI scripts and SSI exec commands, but not any processes forked off from the Apache httpd parent such as piped logs.
Memory resource limits are expressed in bytes per process.
| Descripción: | Limits the number of processes that can be launched by processes launched by Apache httpd children |
|---|---|
| Sintaxis: | RLimitNPROC number|max [number|max] |
| Valor por defecto: | Unset; uses operating system defaults |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
Takes 1 or 2 parameters. The first parameter sets the soft
resource limit for all processes and the second parameter sets
the maximum resource limit. Either parameter can be a number,
or max to indicate to the server that the limit
should be set to the maximum allowed by the operating system
configuration. Raising the maximum resource limit requires that
the server is running as root, or in the initial startup
phase.
This applies to processes forked off from Apache httpd children servicing requests, not the Apache httpd children themselves. This includes CGI scripts and SSI exec commands, but not any processes forked off from the Apache httpd parent such as piped logs.
Process limits control the number of processes per user.
If CGI processes are not running
under user ids other than the web server user id, this directive
will limit the number of processes that the server itself can
create. Evidence of this situation will be indicated by
cannot fork messages in the
error_log.
| Descripción: | Technique for locating the interpreter for CGI scripts |
|---|---|
| Sintaxis: | ScriptInterpreterSource Registry|Registry-Strict|Script |
| Valor por defecto: | ScriptInterpreterSource Script |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Win32 only;
option Registry-Strict is available in Apache HTTP Server 2.0 and
later |
This directive is used to control how Apache httpd finds the
interpreter used to run CGI scripts. The default setting is
Script. This causes Apache httpd to use the interpreter pointed to
by the shebang line (first line, starting with #!) in the
script. On Win32 systems this line usually looks like:
#!C:/Perl/bin/perl.exe
or, if perl is in the PATH, simply:
#!perl
Setting ScriptInterpreterSource Registry will
cause the Windows Registry tree HKEY_CLASSES_ROOT to be
searched using the script file extension (e.g., .pl) as a
search key. The command defined by the registry subkey
Shell\ExecCGI\Command or, if it does not exist, by the subkey
Shell\Open\Command is used to open the script file. If the
registry keys cannot be found, Apache httpd falls back to the behavior of the
Script option.
Be careful when using ScriptInterpreterSource
Registry with ScriptAlias'ed directories, because
Apache httpd will try to execute every file within this
directory. The Registry setting may cause undesired
program calls on files which are typically not executed. For
example, the default open command on .htm files on
most Windows systems will execute Microsoft Internet Explorer, so
any HTTP request for an .htm file existing within the
script directory would start the browser in the background on the
server. This is a good way to crash your system within a minute or
so.
The option Registry-Strict which is new in Apache HTTP Server
2.0 does the same thing as Registry but uses only the
subkey Shell\ExecCGI\Command. The
ExecCGI key is not a common one. It must be
configured manually in the windows registry and hence prevents
accidental program calls on your system.
| Descripción: | Determine if mod_status displays the first 63 characters of a request or the last 63, assuming the request itself is greater than 63 chars. |
|---|---|
| Sintaxis: | SeeRequestTail On|Off |
| Valor por defecto: | SeeRequestTail Off |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache httpd 2.2.7 and later. |
mod_status with ExtendedStatus On
displays the actual request being handled.
For historical purposes, only 63 characters of the request
are actually stored for display purposes. This directive
controls whether the 1st 63 characters are stored (the previous
behavior and the default) or if the last 63 characters are. This
is only applicable, of course, if the length of the request is
64 characters or greater.
If Apache httpd is handling GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1 mod_status displays as follows:
| Off (default) | GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples |
|---|---|
| On | orage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1 |
| Descripción: | Email address that the server includes in error messages sent to the client |
|---|---|
| Sintaxis: | ServerAdmin email-address|URL |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
The ServerAdmin sets the contact address
that the server includes in any error messages it returns to the
client. If the httpd doesn't recognize the supplied argument
as an URL, it
assumes, that it's an email-address and prepends it with
mailto: in hyperlink targets. However, it's recommended to
actually use an email address, since there are a lot of CGI scripts that
make that assumption. If you want to use an URL, it should point to another
server under your control. Otherwise users may not be able to contact you in
case of errors.
It may be worth setting up a dedicated address for this, e.g.
ServerAdmin www-admin@foo.example.com
as users do not always mention that they are talking about the server!
| Descripción: | Alternate names for a host used when matching requests to name-virtual hosts |
|---|---|
| Sintaxis: | ServerAlias hostname [hostname] ... |
| Contexto: | virtual host |
| Estado: | Core |
| Módulo: | core |
The ServerAlias directive sets the
alternate names for a host, for use with name-based virtual hosts. The
ServerAlias may include wildcards, if appropriate.
<VirtualHost *:80>
ServerName server.domain.com
ServerAlias server server2.domain.com server2
ServerAlias *.example.com
UseCanonicalName Off
# ...
</VirtualHost>
| Descripción: | Hostname and port that the server uses to identify itself |
|---|---|
| Sintaxis: | ServerName [scheme://]fully-qualified-domain-name[:port] |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
The ServerName directive sets the
request scheme, hostname and
port that the server uses to identify itself. This is used when
creating redirection URLs.
Additionally, ServerName is used (possibly
in conjunction with ServerAlias) to uniquely
identify a virtual host, when using name-based virtual hosts.
For example, if the name of the
machine hosting the web server is simple.example.com,
but the machine also has the DNS alias www.example.com
and you wish the web server to be so identified, the following
directive should be used:
ServerName www.example.com:80
The ServerName directive
may appear anywhere within the definition of a server. However,
each appearance overrides the previous appearance (within that
server).
If no ServerName is specified, then the
server attempts to deduce the hostname by performing a reverse
lookup on the IP address. If no port is specified in the
ServerName, then the server will use the
port from the incoming request. For optimal reliability and
predictability, you should specify an explicit hostname and port
using the ServerName directive.
If you are using name-based virtual hosts,
the ServerName inside a
<VirtualHost>
section specifies what hostname must appear in the request's
Host: header to match this virtual host.
Sometimes, the server runs behind a device that processes SSL,
such as a reverse proxy, load balancer or SSL offload
appliance. When this is the case, specify the
https:// scheme and the port number to which the
clients connect in the ServerName directive
to make sure that the server generates the correct
self-referential URLs.
See the description of the
UseCanonicalName and
UseCanonicalPhysicalPort directives for
settings which determine whether self-referential URLs (e.g., by the
mod_dir module) will refer to the
specified port, or to the port number given in the client's request.
Failure to set ServerName to a name that
your server can resolve to an IP address will result in a startup
warning. httpd will then use whatever hostname it can
determine, using the system's hostname command. This
will almost never be the hostname you actually want.
httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName
| Descripción: | Legacy URL pathname for a name-based virtual host that is accessed by an incompatible browser |
|---|---|
| Sintaxis: | ServerPath URL-path |
| Contexto: | virtual host |
| Estado: | Core |
| Módulo: | core |
The ServerPath directive sets the legacy
URL pathname for a host, for use with name-based virtual hosts.
| Descripción: | Base directory for the server installation |
|---|---|
| Sintaxis: | ServerRoot directory-path |
| Valor por defecto: | ServerRoot /usr/local/apache |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
The ServerRoot directive sets the
directory in which the server lives. Typically it will contain the
subdirectories conf/ and logs/. Relative
paths in other configuration directives (such as Include or LoadModule, for example) are taken as
relative to this directory.
ServerRoot /home/httpd
-d
option to httpdServerRoot| Descripción: | Configures the footer on server-generated documents |
|---|---|
| Sintaxis: | ServerSignature On|Off|EMail |
| Valor por defecto: | ServerSignature Off |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | All |
| Estado: | Core |
| Módulo: | core |
The ServerSignature directive allows the
configuration of a trailing footer line under server-generated
documents (error messages, mod_proxy ftp directory
listings, mod_info output, ...). The reason why you
would want to enable such a footer line is that in a chain of proxies,
the user often has no possibility to tell which of the chained servers
actually produced a returned error message.
The Off
setting, which is the default, suppresses the footer line (and is
therefore compatible with the behavior of Apache-1.2 and
below). The On setting simply adds a line with the
server version number and ServerName of the serving virtual host,
and the EMail setting additionally creates a
"mailto:" reference to the ServerAdmin of the referenced
document.
After version 2.0.44, the details of the server version number
presented are controlled by the ServerTokens directive.
| Descripción: | Configures the Server HTTP response
header |
|---|---|
| Sintaxis: | ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full |
| Valor por defecto: | ServerTokens Full |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
This directive controls whether Server response
header field which is sent back to clients includes a
description of the generic OS-type of the server as well as
information about compiled-in modules.
ServerTokens Full (or not specified)Server: Apache/2.4.1
(Unix) PHP/4.2.2 MyMod/1.2ServerTokens Prod[uctOnly]Server:
ApacheServerTokens MajorServer:
Apache/2ServerTokens MinorServer:
Apache/2.4ServerTokens Min[imal]Server:
Apache/2.4.1ServerTokens OSServer: Apache/2.4.1
(Unix)This setting applies to the entire server, and cannot be enabled or disabled on a virtualhost-by-virtualhost basis.
After version 2.0.44, this directive also controls the
information presented by the ServerSignature directive.
ServerTokens to less than
minimal is not recommended because it makes it more
difficult to debug interoperational problems. Also note that
disabling the Server: header does nothing at all to make your
server more secure; the idea of "security through obscurity"
is a myth and leads to a false sense of safety.| Descripción: | Forces all matching files to be processed by a handler |
|---|---|
| Sintaxis: | SetHandler handler-name|None |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Moved into the core in Apache httpd 2.0 |
When placed into an .htaccess file or a
<Directory> or
<Location>
section, this directive forces all matching files to be parsed
through the handler given by
handler-name. For example, if you had a directory you
wanted to be parsed entirely as imagemap rule files, regardless
of extension, you might put the following into an
.htaccess file in that directory:
SetHandler imap-file
Another example: if you wanted to have the server display a
status report whenever a URL of
http://servername/status was called, you might put
the following into httpd.conf:
<Location /status>
SetHandler server-status
</Location>
You can override an earlier defined SetHandler
directive by using the value None.
Note: because SetHandler overrides default handlers, normal behaviour such as handling of URLs ending in a slash (/) as directories or index files is suppressed.
| Descripción: | Sets the filters that will process client requests and POST input |
|---|---|
| Sintaxis: | SetInputFilter filter[;filter...] |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
The SetInputFilter directive sets the
filter or filters which will process client requests and POST
input when they are received by the server. This is in addition to
any filters defined elsewhere, including the
AddInputFilter
directive.
If more than one filter is specified, they must be separated by semicolons in the order in which they should process the content.
| Descripción: | Sets the filters that will process responses from the server |
|---|---|
| Sintaxis: | SetOutputFilter filter[;filter...] |
| Contexto: | server config, virtual host, directory, .htaccess |
| Anula: | FileInfo |
| Estado: | Core |
| Módulo: | core |
The SetOutputFilter directive sets the filters
which will process responses from the server before they are
sent to the client. This is in addition to any filters defined
elsewhere, including the
AddOutputFilter
directive.
For example, the following configuration will process all files
in the /www/data/ directory for server-side
includes.
<Directory /www/data/>
SetOutputFilter INCLUDES
</Directory>
If more than one filter is specified, they must be separated by semicolons in the order in which they should process the content.
| Descripción: | Controls whether the server requires the requested hostname be listed enumerated in the virtual host handling the request |
|---|---|
| Sintaxis: | StrictHostCheck ON|OFF |
| Valor por defecto: | StrictHostCheck OFF |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Added in 2.4.49 |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Amount of time the server will wait for certain events before failing a request |
|---|---|
| Sintaxis: | TimeOut seconds |
| Valor por defecto: | TimeOut 60 |
| Contexto: | server config, virtual host |
| Estado: | Core |
| Módulo: | core |
The TimeOut directive defines the length
of time Apache httpd will wait for I/O in various circumstances:
mod_cgi, the length of time to wait for
output from a CGI script.mod_ext_filter, the length of time to
wait for output from a filtering process.mod_proxy, the default timeout value if
ProxyTimeout is not
configured.| Descripción: | Determines the behaviour on TRACE requests |
|---|---|
| Sintaxis: | TraceEnable [on|off|extended] |
| Valor por defecto: | TraceEnable on |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Available in Apache HTTP Server 1.3.34, 2.0.55 and later |
This directive overrides the behavior of TRACE for both
the core server and mod_proxy. The default
TraceEnable on permits TRACE requests per
RFC 2616, which disallows any request body to accompany the request.
TraceEnable off causes the core server and
mod_proxy to return a 405 (Method not
allowed) error to the client.
Finally, for testing and diagnostic purposes only, request
bodies may be allowed using the non-compliant TraceEnable
extended directive. The core (as an origin server) will
restrict the request body to 64k (plus 8k for chunk headers if
Transfer-Encoding: chunked is used). The core will
reflect the full headers and all chunk headers with the response
body. As a proxy server, the request body is not restricted to 64k.
| Descripción: | Controls what UNC host names can be accessed by the server |
|---|---|
| Sintaxis: | UNCList hostname [hostname...] |
| Valor por defecto: | unset |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
| Compatibilidad: | Added in 2.4.60, Windows only. |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| Descripción: | Undefine the existence of a variable |
|---|---|
| Sintaxis: | UnDefine parameter-name |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
Undoes the effect of a Define or
of passing a -D argument to httpd.
This directive can be used to toggle the use of <IfDefine> sections without needing to alter
-D arguments in any startup scripts.
| Descripción: | Configures how the server determines its own name and port |
|---|---|
| Sintaxis: | UseCanonicalName On|Off|DNS |
| Valor por defecto: | UseCanonicalName Off |
| Contexto: | server config, virtual host, directory |
| Estado: | Core |
| Módulo: | core |
In many situations Apache httpd must construct a self-referential
URL -- that is, a URL that refers back to the same server. With
UseCanonicalName On Apache httpd will use the hostname and port
specified in the ServerName
directive to construct the canonical name for the server. This name
is used in all self-referential URLs, and for the values of
SERVER_NAME and SERVER_PORT in CGIs.
With UseCanonicalName Off Apache httpd will form
self-referential URLs using the hostname and port supplied by
the client if any are supplied (otherwise it will use the
canonical name, as defined above). These values are the same
that are used to implement name-based virtual hosts,
and are available with the same clients. The CGI variables
SERVER_NAME and SERVER_PORT will be
constructed from the client supplied values as well.
An example where this may be useful is on an intranet server
where you have users connecting to the machine using short
names such as www. You'll notice that if the users
type a shortname, and a URL which is a directory, such as
http://www/splat, without the trailing
slash then Apache httpd will redirect them to
http://www.domain.com/splat/. If you have
authentication enabled, this will cause the user to have to
authenticate twice (once for www and once again
for www.domain.com -- see the
FAQ on this subject for more information). But if
UseCanonicalName is set Off, then
Apache httpd will redirect to http://www/splat/.
There is a third option, UseCanonicalName DNS,
which is intended for use with mass IP-based virtual hosting to
support ancient clients that do not provide a
Host: header. With this option Apache httpd does a
reverse DNS lookup on the server IP address that the client
connected to in order to work out self-referential URLs.
If CGIs make assumptions about the values of SERVER_NAME
they may be broken by this option. The client is essentially free
to give whatever value they want as a hostname. But if the CGI is
only using SERVER_NAME to construct self-referential URLs
then it should be just fine.
| Descripción: | Configures how the server determines its own name and port |
|---|---|
| Sintaxis: | UseCanonicalPhysicalPort On|Off |
| Valor por defecto: | UseCanonicalPhysicalPort Off |
| Contexto: | server config, virtual host, directory |
| Estado: | Core |
| Módulo: | core |
In many situations Apache httpd must construct a self-referential
URL -- that is, a URL that refers back to the same server. With
UseCanonicalPhysicalPort On Apache httpd will, when
constructing the canonical port for the server to honor
the UseCanonicalName directive,
provide the actual physical port number being used by this request
as a potential port. With UseCanonicalPhysicalPort Off
Apache httpd will not ever use the actual physical port number, instead
relying on all configured information to construct a valid port number.
The ordering of when the physical port is used is as follows:
UseCanonicalName On
ServernameUseCanonicalName Off | DNS
Host: headerServernameWith UseCanonicalPhysicalPort Off, the
physical ports are removed from the ordering.
| Descripción: | Contains directives that apply only to a specific hostname or IP address |
|---|---|
| Sintaxis: | <VirtualHost
addr[:port] [addr[:port]]
...> ... </VirtualHost> |
| Contexto: | server config |
| Estado: | Core |
| Módulo: | core |
<VirtualHost> and
</VirtualHost> are used to enclose a group of
directives that will apply only to a particular virtual host. Any
directive that is allowed in a virtual host context may be
used. When the server receives a request for a document on a
particular virtual host, it uses the configuration directives
enclosed in the <VirtualHost>
section. Addr can be:
*, which is used only in combination with
NameVirtualHost * to match all IP addresses; or_default_, which is used only
with IP virtual hosting to catch unmatched IP addresses.
<VirtualHost 10.1.2.3>
ServerAdmin webmaster@host.example.com
DocumentRoot /www/docs/host.example.com
ServerName host.example.com
ErrorLog logs/host.example.com-error_log
TransferLog logs/host.example.com-access_log
</VirtualHost>
IPv6 addresses must be specified in square brackets because the optional port number could not be determined otherwise. An IPv6 example is shown below:
<VirtualHost [2001:db8::a00:20ff:fea7:ccea]>
ServerAdmin webmaster@host.example.com
DocumentRoot /www/docs/host.example.com
ServerName host.example.com
ErrorLog logs/host.example.com-error_log
TransferLog logs/host.example.com-access_log
</VirtualHost>
Each Virtual Host must correspond to a different IP address,
different port number or a different host name for the server,
in the former case the server machine must be configured to
accept IP packets for multiple addresses. (If the machine does
not have multiple network interfaces, then this can be
accomplished with the ifconfig alias command -- if
your OS supports it).
The use of <VirtualHost> does
not affect what addresses Apache httpd listens on. You
may need to ensure that Apache httpd is listening on the correct addresses
using Listen.
When using IP-based virtual hosting, the special name
_default_ can be specified in
which case this virtual host will match any IP address that is
not explicitly listed in another virtual host. In the absence
of any _default_ virtual host the "main" server config,
consisting of all those definitions outside any VirtualHost
section, is used when no IP-match occurs.
You can specify a :port to change the port that is
matched. If unspecified then it defaults to the same port as the
most recent Listen
statement of the main server. You may also specify :*
to match all ports on that address. (This is recommended when used
with _default_.)
A ServerName should be
specified inside each <VirtualHost> block. If it is absent, the
ServerName from the "main"
server configuration will be inherited.
If no matching virtual host is found, then the first listed virtual host that matches the IP address will be used. As a consequence, the first listed virtual host is the default virtual host.
See the security tips document for details on why your security could be compromised if the directory where log files are stored is writable by anyone other than the user that starts the server.
Serveur HTTP Apache Version 2.4
| Description: | Journalisation supplémentaire à des fins de débogage |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | log_debug_module |
| Fichier Source: | mod_log_debug.c |
| Compatibilité: | Disponible depuis la version 2.3.14 d'Apache |
<Location "/foo/"> LogMessage "/foo/ has been requested" </Location>
<Location "/foo/">
LogMessage "subrequest to /foo/" hook=type_checker "expr=-T %{IS_SUBREQ}"
</Location>
Le branchement (hook) par défaut log_transaction n'est pas
exécuté pour les sous-requêtes ; nous devons donc en utiliser un
autre.
LogMessage "IPv6 timeout from %{REMOTE_ADDR}" "expr=-T %{IPV6} && %{REQUEST_STATUS} = 408"
Notez l'emplacement des guillemets pour l'argument
expr=.
<Location "/">
LogMessage "%{reqenv:X-Foo}" hook=all
</Location>
En association avec les repères de temps en microsecondes du journal des erreurs,
hook=all permet aussi de déterminer la durée d'exécution des
différentes phases du traitement de la requête.
| Description: | Enregistre des messages personnalisés dans le journal des erreurs |
|---|---|
| Syntaxe: | LogMessage message
[hook=hook] [expr=expression]
|
| Défaut: | Non défini |
| Contexte: | répertoire |
| Statut: | Expérimental |
| Module: | mod_log_debug |
Cette directive permet d'enregistrer un message personnalisé dans le journal des erreurs. Ce message peut utiliser des variables et des fonctions dans la syntaxe ap_expr. D'éventuelles références à des en-têtes HTTP dans l'expression rationnelle n'entraîneront pas l'ajout des noms d'en-tête correspondants à l'en-tête Vary. Les messages sont enregistrés au loglevel info.
Le branchement (hook) précise la phase du traitement de la requête avant laquelle le message sera enregistré. Les branchements suivants sont supportés :
| Nom |
|---|
pre_translate_name |
translate_name |
type_checker |
quick_handler |
map_to_storage |
check_access |
check_access_ex |
insert_filter |
check_authn |
check_authz |
fixups |
handler |
log_transaction |
Le branchement par défaut est log_transaction. La
valeur spéciale all est également supportée ; dans ce cas,
le message sera enregistré à chaque phase. Tous les branchements ne
sont pas exécutés pour chaque requête.
L'expression optionnelle permet de restreindre l'enregistrement du message en fonction d'une certaine condition. La syntaxe de l'expression est décrite dans la documentation ap_expr. D'éventuelles références à des en-têtes HTTP dans l'expression rationnelle n'entraîneront pas l'ajout des noms d'en-tête correspondants à l'en-tête Vary.
Serveur HTTP Apache Version 2.4
| Description: | Traitement des cartes des zones interactives d'une image (imagemaps) au niveau du serveur |
|---|---|
| Statut: | Base |
| Identificateur de Module: | imagemap_module |
| Fichier Source: | mod_imagemap.c |
Ce module traite les fichiers .map, et remplace
ainsi la fonctionnalité du programme CGI imagemap. Tout
répertoire ou type de document configuré pour utiliser le
gestionnaire imap-file (à l'aide des directives
AddHandler ou SetHandler), sera traité par ce
module.
La directive suivante confère aux fichiers possèdant l'extension
.map le statut de fichiers imagemap :
AddHandler imap-file map
Notez que la syntaxe suivante reste encore supportée :
AddType application/x-httpd-imap map
Cependant, nous essayons d'abandonner progressivement les "types MIME magiques", et cette syntaxe est sur le point de devenir obsolète.
Nouvelles fonctionnalités Fichier imagemap Exemple de fichier imagemap Référencement de votre fichier
imagemapLe module imagemap propose quelques nouvelles fonctionnalités qui n'étaient pas disponibles avec les programmes imagemap précédemment distribués.
<base> par défaut via la
nouvelle directive base.imagemap.conf non requis.Les lignes d'un fichier imagemap peuvent se présenter sous plusieurs formats :
directive valeur [x,y ...]
directive valeur "Texte de menu" [x,y
...]
directive valeur x,y ... "Texte de menu"
Les directives sont base, default,
poly, circle, rect, ou
point. valeur est une URL absolue ou relative, ou une
des valeurs spéciales énumérées ci-dessous. Les coordonnées sont des
paires x,y séparées par des
espaces. Le texte entre guillemets est le texte du lien si un menu
imagemap est généré. Les lignes commençant par '#' sont des
commentaires.
Les directives autorisées dans un fichier imagemap sont au nombre de six. Elles peuvent se trouver à n'importe quelle position dans le fichier, mais sont traitées dans l'ordre selon lequel elles sont enregistrées dans le fichier imagemap.
baseElle a le même effet que <base
href="valeur">. Les URLs non absolues du
fichier imagemap sont considérées comme relatives à cette valeur.
La directive base l'emporte sur une directive
ImapBase définie dans
un fichier .htaccess ou dans le fichier de
configuration du serveur. En l'absence de directive de
configuration ImapBase, la valeur par
défaut de base est
http://nom_serveur/.
base_uri est un synonyme de base.
Notez que la présence ou l'absence d'un slash de fin dans l'URL
est importante.
defaultpoly,
circle, ou rect, et si aucune directive
point n'est présente. En l'absence de définition
d'une directive de configuration ImapDefault, la valeur par défaut est
nocontent et provoque l'envoi d'un code de statut
204 No Content. Le client verra toujours la même
page s'afficher.polycirclerectpointdefault ne sera pas suivie si une directive
point est présente et si des coordonnées valides sont
fournies.Les valeurs passées aux directives peuvent contenir :
L'URL peut être absolue ou relative. Les URLs relatives
peuvent contenir '..' et seront considérées comme relatives à la
valeur de base.
base en lui-même, ne sera pas résolu en fonction
de la valeur courante. Cependant, une directive base
mailto: fonctionnera correctement.
mapImapMenu n'ait été définie à
none.menumap.refererhttp://nom_serveur/ si aucun en-tête
Referer: n'est présent.nocontent204 No Content,
indiquant au client qu'il doit continuer à afficher la même page.
Valide pour toutes les directives, sauf base.error500 Server
Error. Valide pour toutes les directives, sauf
base, mais n'a de sens qu'avec la directive
default.0,0 200,2000,0 a le même effet que
si aucune coordonnée n'a été sélectionnée."Texte du menu"Après la valeur ou les coordonnées, la ligne peut éventuellement contenir un texte entre guillemets. Cette chaîne constitue le texte du lien si un menu est généré :
<a href="http://example.com/">Texte de
menu</a>
Si aucun texte entre guillemets n'est présent, le texte sera constitué du nom du lien :
<a href="http://example.com/">http://example.com</a>
Si vous voulez insérer des guillemets dans le texte, vous devez
les inscrire sous la forme ".
#Les commentaires sont affichés dans un menu 'formaté' ou
#'semi-formaté'.
#Et peuvent contenir des balises html. <hr>
base referer
poly map "Puis-je avoir un menu, s'il vous plait ?" 0,0 0,10 10,10 10,0
rect .. 0,0 77,27 "le répertoire du référant"
circle http://www.inetnebr.example.com/lincoln/feedback/ 195,0 305,27
rect autre_fichier "dans le même répertoire que le référant" 306,0 419,27
point http://www.zyzzyva.example.com/ 100,100
point http://www.tripod.example.com/ 200,200
rect mailto:nate@tripod.example.com 100,150 200,0 "Bogues?"
<a href="/maps/imagemap1.map">
<img ismap src="/images/imagemap1.gif">
</a>
<a href="/maps/imagemap1.map">
<img ismap="ismap" src="/images/imagemap1.gif" />
</a>
| Description: | Valeur par défaut de la directive base des
fichiers imagemap |
|---|---|
| Syntaxe: | ImapBase map|referer|URL |
| Défaut: | ImapBase http://nom_serveur/ |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_imagemap |
La directive ImapBase permet de définir la
valeur par défaut de la directive base des fichiers
imagemap. Sa valeur est écrasée par la présence éventuelle d'une
directive base dans le fichier imagemap. Si cette
directive est absente, la valeur par défaut de la directive
base est
http://nom_serveur/.
| Description: | Action à entreprendre par défaut lorsqu'un fichier imagemap est invoqué avec des coordonnées qui ne correspondent à aucune cible |
|---|---|
| Syntaxe: | ImapDefault error|nocontent|map|referer|URL |
| Défaut: | ImapDefault nocontent |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_imagemap |
La directive ImapDefault permet de définir
la valeur par défaut de la directive default utilisée
dans les fichiers imagemap. Sa valeur est écrasée par la présence
éventuelle d'une directive default dans le fichier
imagemap. Si cette directive est absente, l'action associée à
default est nocontent, ce qui implique
l'envoi d'un code de statut 204 No Content au client.
Dans ce cas, le client doit continuer à afficher la même page.
| Description: | Action à entreprendre si aucune coordonnée n'est fournie lorsqu'on invoque un fichier imagemap |
|---|---|
| Syntaxe: | ImapMenu none|formatted|semiformatted|unformatted |
| Défaut: | ImapMenu formatted |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_imagemap |
La directive ImapMenu permet de spécifier
l'action à entreprendre lorsqu'un fichier imagemap est invoqué sans
coordonnées valides.
nonenone, aucun menu
n'est généré, et l'action default est effectuée.formattedformatted est le menu le plus simple. Les
commentaires du fichier imagemap sont ignorés. Un en-tête de
niveau un est affiché, puis un séparateur horizontal, puis chacun
des liens sur une ligne séparée. L'aspect du menu est similaire à
celui d'un listing de répertoire.semiformattedsemiformatted, les commentaires sont
affichés au moment où ils apparaissent dans le fichier imagemap.
Les lignes vides sont interprètées comme des lignes de séparation
HTML. Aucun en-tête ni séparateur horizontal n'est affiché. À part
ces différences, le menu semiformatted est identique
au menu formatted.unformattedApache HTTP Server Version 2.4
| : | Basic authentication |
|---|---|
| : | Base |
| : | auth_basic_module |
| ҽ: | mod_auth_basic.c |
| : | ġ 2.1 ĺ |
ش (provider) Ͽ ں
ϴ HTTP Basic Authentication Ѵ.
HTTP Digest Authentication mod_auth_digest
Ѵ.
| : | Ѻο Ѱ Ѵ |
|---|---|
| : | AuthBasicAuthoritative On|Off |
| ⺻: | AuthBasicAuthoritative On |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Base |
| : | mod_auth_basic |
AuthBasicAuthoritative þ
Off ϸ ־ ̵ شϴ
̵ Ģ
ã Ѻο θ (modules.c
Ͽ ) Ѱش. ־
̵ Ģ ãҴٸ 붧 ȣ 뿩θ
˻ϰ, ϸ "Authentication Required ( ʿ)"
Ѵ.
ͺ̽ ̵ ְų
ȿ Require þ
ϸ, ù° ڸ ˻ϰ,
AuthBasicAuthoritative
ѱʴ´.
⺻ ѱʰ, ̵ Ģ "Authentication Required ( ʿ)" Ѵ. þ ý ϰ Ǹ, NCSA Ѵ.
| : | Fake basic authentication using the given expressions for username and password |
|---|---|
| : | AuthBasicFake off|username [password] |
| ⺻: | none |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Base |
| : | mod_auth_basic |
| : | Apache HTTP Server 2.4.5 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | ġ ڸ Ѵ |
|---|---|
| : | AuthBasicProvider On|Off|provider-name
[provider-name] ... |
| ⺻: | AuthBasicProvider On |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Base |
| : | mod_auth_basic |
AuthBasicProvider þ
ġ ڸ ڸ Ѵ.
On̸ ⺻(file) Ѵ.
mod_authn_file file
ڸ ϱ ִ Ȯؾ
Ѵ.
<Location /secure>
AuthBasicProvider dbm
AuthDBMType SDBM
AuthDBMUserFile /www/etc/dbmpasswd
Require valid-user
</Location>
ڴ mod_authn_dbm
mod_authn_file ϶.
Off̸ ⺻·
ư.
| : | Check passwords against the authentication providers as if Digest Authentication was in force instead of Basic Authentication. |
|---|---|
| : | AuthBasicUseDigestAlgorithm MD5|Off |
| ⺻: | AuthBasicUseDigestAlgorithm Off |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Base |
| : | mod_auth_basic |
| : | Apache HTTP Server 2.4.7 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
Apache HTTP 服务器版本 2.4
下面是 Apache HTTP 服务器发行版中的所有模块列表。参见按照字母顺序罗列的所有 Apache HTTP 服务器指令。
worker MPM with the goal
of consuming threads only for connections with active processingA | B | C | D | E | F | H | I | L | M | N | P | R | S | U | V | W | X
ls command or the
Win32 dir shell commandmod_davmod_davExpires and
Cache-Control HTTP headers according to user-specified
criteriamod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxymod_proxy extension for load balancing mod_proxy extension for
CONNECT request handlingmod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxysed syntaxApache HTTP サーバ バージョン 2.4
| 説明: | ユーザ専用のディレクトリを提供 |
|---|---|
| ステータス: | Base |
| モジュール識別子: | userdir_module |
| ソースファイル: | mod_userdir.c |
このモジュールは、
http://example.com/~user/
構文を使ってユーザ専用ディレクトリにアクセスできるようにします。
| 説明: | ユーザ専用ディレクトリの位置 |
|---|---|
| 構文: | UserDir directory-filename [directory-filename] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_userdir |
UserDir ディレクティブは、
ユーザのドキュメントへのリクエストを受けた時に使う
ユーザのホームディレクトリ中の、実際のディレクトリを
設定します。
directory-filename には次のどれかを指定します:
disabled キーワード。
enabled キーワード (下記参照) で明示的に
指定されたユーザ以外の
全てのユーザ名-ディレクトリ変換を
しないようにします。disabled キーワードと、スペース区切りのユーザ名リスト。
このリスト中に含まれるユーザ名に対しては、たとえ
enabled 節にあったとしても、
決してディレクトリ変換は行われません。enabled キーワードとスペース区切りのユーザ名リスト。
全体では変換が無効になっていたとしても、
これらのユーザ名にはディレクトリ変換が行われます。
ただし、disabled 節にもあれば変換はされません。
もし enabled も disabled
キーワードも UserDir に現われていなければ、
引数はファイル名パターンとして扱われ、
名前からディレクトリへの変換の指定を行なう時に使われます。
http://www.example.com/~bob/one/two.html
へのリクエストは次のように変換されます:
| UserDir ディレクティブ | 変換後のパス |
|---|---|
| UserDir public_html | ~bob/public_html/one/two.html |
| UserDir /usr/web | /usr/web/bob/one/two.html |
| UserDir /home/*/www | /home/bob/www/one/two.html |
次のディレクティブはクライアントに対してリダイレクトを 送信します:
| UserDir ディレクティブ | 変換後のパス |
|---|---|
| UserDir http://www.example.com/users | http://www.example.com/users/bob/one/two.html |
| UserDir http://www.example.com/*/usr | http://www.example.com/bob/usr/one/two.html |
| UserDir http://www.example.com/~*/ | http://www.example.com/~bob/one/two.html |
UserDir ./" は
"/~root" から "/" へマップしますが、
これは望ましい動作ではないでしょう。
"UserDir disabled root" 宣言を
設定の中に含めておくことを強くお薦めします。
追加情報に Directory
ディレクティブや
セキュリティ
Tips のページもご覧下さい。
追加の例:
少数のユーザのみが UserDir
ディレクトリを利用し、それ以外には利用させたくない場合は
次を使いましょう:
UserDir disabled
UserDir enabled user1 user2 user3
大部分のユーザは UserDir ディレクトリを利用するけれど、
少数の人は不許可にしたい場合は、次を使いましょう:
UserDir enabled
UserDir disabled user4 user5 user6
他のユーザディレクトリを指定することもできます。 次のようなコマンドを使うと:
Userdir public_html /usr/web http://www.example.com/
http://www.example.com/~bob/one/two.html へのリクエストはまず ~bob/public_html/one/two.html のページを調べ、その次に /usr/web/bob/one/two.html を調べ、最後に http://www.example.com/bob/one/two.html へのリダイレクトを送ります。
リダイレクトを加える場合は、リストの最後の選択肢でなければなりません。 Apache はリダイレクトが成功するかどうかを決めることはできませんので、 リストの前の方にリダイレクトを書くと、それが必ず使用される選択肢に なってしまいます。
2.1.4 以降では、ユーザディレクトリ置換機能はデフォルトでは起動しません。
それ以前のバージョンでは、UserDir
ディレクティブが存在しなければ、UserDir public_html
であると仮定されていました。
Apache HTTP Server Version 2.4
Each Apache directive available in the standard Apache distribution is listed here. They are described using a consistent format, and there is a dictionary of the terms used in their descriptions available.
A Directive Quick-Reference is also available giving details about each directive in a summary form.
A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X
Apache HTTP Sunucusu Sürüm 2.4
Bu belgede Apache yapılandırma yönergelerini tanımlamakta kullanılan terimler açıklanmıştır.
Yönergenin kullanım amacının kısa bir açıklaması.
Yönergenin bir yapılandırma dosyasında hangi söz dizimiyle görünebileceği belirtilir. Bu sözdizimi yönergeye özeldir ve ayrıntıları yönerge tanımında açıklanır. Genelde yönerge ismini aralarında boşluklar bırakılmış bir dizi argüman izler. Eğer argümanlardan biri kendi içinde boşluk içeriyorsa çift tırnak içine alınır. İsteğe bağlı argümanlar sözdiziminde köşeli ayraçların arasında gösterilmiştir. Birden fazla olası değeri olan argümanlarda değerler aralarına | karakteri konarak ayrılmıştır. Değerin yerine ismi belirtilen argümanlarda bu isimler eğik yazılırken, kendisi değer olan dizgeler öntanımlı yazıtipi ile gösterilmiştir. Değişik sayıda argüman alan yönergelerde bu durum son argümanı takibeden “...” ile belirtilmiştir.
Yönergelerde kullanılan argüman türleri çok çeşitlidir. Çok kullanılanlardan bazıları aşağıda tanımlanmıştır.
http://host.example.com/yol/yordam/dosya.html
örneğindeki gibi protokol şeması ve konak ismini isteğe bağlı bir dosya
yolunun izlediği, açılımı “Uniform Resource Locator” olan ve Türkçe’ye
“Tektip Özkaynak Konumlayıcı” şeklinde çevrilebilecek adresleri
betimler./yol/yordam/dosya.html örneğindeki gibi bir
url’nin parçası olarak protokol şeması ve konak ismini izleyen
bir yol dizgesini betimler. url-yolu, bir dosya sisteminin kök
dizinine göre değil, DocumentRoot
ile belirtilen dizine göre bir dosya yolu betimler./usr/local/apache/htdocs/yol/yordam/dosya.html
örneğindeki gibi yerel dosya sisteminin kök dizini ile başlayan bir
dosya yolunu betimler. Aksi belirtilmedikçe, bir / ile başlamayan bir
dosya-yolu ServerRoot ile
belirtilen dizine göre ele alınır./usr/local/apache/htdocs/yol/yordam/ örneğindeki gibi
kök dizin ile başlayan, yerel dosya sistemindeki bir dizin yolunu
betimler.dosya.html örneğindeki gibi dizin yolu içermeyen bir
dosya ismini betimler.dosya.html.tr değeri iki uzantı içerir:
.html ve .tr. Apache yönergelerinde
uzantı’ları başında noktası olmaksızın da belirtebilirsiniz.
Ayrıca, uzantı’lar harf büyüklüğüne de duyarlı değildir.text/html örneğindeki gibi aralarına
bir / konulmuş asıl ve alt biçimler şeklinde açıklandığı yönteme göre
belirtileceğini betimler.Eğer yönerge öntanımlı bir değere sahipse o burada belirtilir (öntanımlı değer, yönergede kullanıcı tarafından belirtilmediği halde Apache tarafından belirtildiği varsayılarak işlem yapılan değerdir). Eğer öntanımlı bir değer yoksa bu bölümde bu durum “Yok” şeklinde belirtilir. Burada belirtilen öntanımlı değerin sunucu ile dağıtılan öntanımlı httpd.conf içindeki yönergede kullanılan değerle aynı olmasının gerekmediğine dikkat ediniz.
Yönergenin sunucunun yapılandırma dosyalarının nerelerinde meşru kabul edildiği aşağıdaki değerlerin virgül ayraçlı bir listesi halinde burada belirtilir.
httpd.conf gibi) yapılandırma
dosyalarında <VirtualHost> ve <Directory> bölümleri dışında
her yerde kullanılabileceğini belirtir. Ayrıca, .htaccess
dosyalarında bulunmasına da izin verilmez.<VirtualHost> bölümlerinde
kullanıldığında geçerli kabul edileceğini belirtir.<Directory>, <Location>, <Files>, <If> ve <Proxy> bölümlerinde
kullanıldığında geçerli kabul edileceğini belirtir. Bu bağlama konu
sınırlamaların çerçevesi Yapılandırma
Bölümleri içinde çizilmiştir..htaccess dosyalarında görüldüğü zaman işleme sokulur.
Üzerinde bir geçersizleştirme etkin kılınmışsa
yönerge her şeye rağmen işleme sokulmayabilir.Yönergeye sadece tasarlandığı bağlam içinde izin verilir; başka bir yerde kullanmayı denerseniz ya sunucunun bu bağlamı doğru şekilde işlemesine engel olan ya da sunucunun tamamen işlevsiz kalmasına sebep olan -- sunucu hiç başlatılamayabilir -- bir yapılandırma hatası alırsınız.
Yönergenin geçerli olacağı konumlar, aslında, listelenen bağlamların
tamamına mantıksal VEYA uygulanarak bulunur. Başka bir deyişle, bir
yönergenin geçerli olacağı yerler "sunucu geneli, .htaccess"
şeklinde belirtilmişse yönerge httpd.conf dosyasında ve
.htaccess dosyalarında, <Directory> veya <VirtualHost> bölümleri haricinde her yerde
kullanılabilir.
Bir .htaccess dosyasında göründüğü takdirde yönerge
işlenirken hangi yapılandırma geçersizleşirmesinin etkin olacağı burada
belirtilir. Eğer yönerge bağlamının
.htaccess dosyalarında görünmesine izin verilmiyorsa hiçbir
bağlam listelenmez.
Geçersizleştirmeler AllowOverride
yönergesi tarafından etkinleştirilir ve belli bir bağlama ve alt
seviyelerde başka AllowOverride
yönergeleri ile değiştirilmedikçe tüm çocuklarına uygulanır. Yönergenin
belgesinde ayrıca kullanılabilecek tüm olası geçersizleştirme isimleri
belirtilir.
Yönergenin Apache HTTP sunucusuna ne kadar sıkı bağlı olduğunu belirtir. Başka bir deyişle, yönergeye ve işlevselliğine erişim kazanmak için sunucuyu belli bir modül kümesiyle yeniden derlemek gerekip gerekmediği ile ilgili durumu belirtir. Bu özniteliğin olası değerleri şunlardır:
Burada sadece yönergeyi tanımlayan kaynak modülün ismi yazılır.
Eğer yönerge Apache’nin 2. sürüm dağıtımının özgün parçası değilse söz konusu sürüm burada belirtilir. Ayrıca, yönergenin kullanımı belli platformlarla sınırlıysa bunun ayrıntıları da burada belirtilir.
Versión 2.4 del Servidor HTTP Apache
Todas las directivas disponibles en la distribución estándar de Apache están en la lista que se muestra más abajo. Cada una se describe usando un formato uniforme, y existe un glosario de los términos usados en las descripciones que puede consultar.
También existe una Guía Rápida de Referencia de Directivas con información de cada directiva de forma resumida.
A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X
Serveur HTTP Apache Version 2.4
Toutes les directives Apache disponibles dans la distribution standard d'Apache sont référencées ici. Elles sont décrites en utilisant un format normalisé, et un dictionnaire des termes utilisés dans leurs descriptions est disponible.
Un Document de référence rapide des directives est également disponible. Il donne des détails à propos de chaque directive sous une forme abrégée.
A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X
Serveur HTTP Apache Version 2.4
| Description: | Gestion des domaines au sein des serveurs virtuels et obtention de certificats via le protocole ACME |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | md_module |
| Fichier Source: | mod_md.c |
| Compatibilité: | Disponible à partir de la version 2.4.30 du serveur HTTP Apache |
Ce module permet de gérer les propriétés courantes des domaines pour un ou plusieurs serveurs virtuels. Il fournit deux fonctionnalités principales : la première permet la supervision et le renouvellement des certificats TLS via le protocole ACME (RFC 8555). Le module effectue le renouvellement des certificats avant leur expiration afin d'éviter une interruption des services internet. Il est possible de monitorer l'état de tous les certificats gérés par mod_md et de configurer le serveur de façon à ce qu'il envoie des notifications de renouvellement, d'expiration ou d'erreur personnalisées.
La seconde fonctionnalité principale fournit une implémentation alternative de l'agrafage OCSP, et ceci aussi bien pour les certificats gérés par mod_md que pour les certificats que vous gérez vous-même. Composant nécessaire pour tout site https, l'agrafage OCSP influence la vitesse de chargement des pages et suivant la configuration, la disponibilité de ces dernières. Vous trouverez plus de détails dans la section agrafage ci-dessous.
L'autorité ACME par défaut pour la gestion des certificats est Let's Encrypt, mais il est possible de configurer une autre CA si cette dernière supporte le protocole.
Exemple de configuration simple :
MDomain example.org
<VirtualHost *:443>
ServerName example.org
DocumentRoot htdocs/a
SSLEngine on
# aucun certificat spécifié
</VirtualHost>
Au démarrage, un serveur ainsi configuré contactera Let's Encrypt pour demander un
certificat pour le domaine considéré. Si Let's Encrypt peut vérifier
le propriétaire du domaine, le module obtiendra le certificat et sa
chaîne de certification, le stockera dans son système de fichiers
(voir la directive MDStoreDir) et le proposera au prochain
redémarrage à mod_ssl.
Ce processus se déroule pendant l'exécution du serveur. Tous les autres serveurs virtuels continueront à fonctionner normalement, mais tant que le certificat ne sera pas disponible, toute requête pour le domaine considéré génèrera une réponse du type '503 Service Unavailable'.
Pour pouvoir être utilisé, ce module nécessite le chargement
préalable du module mod_watchdog.
Pour que Let's Encrypt puisse signer et renouveler votre certificat, votre serveur doit être accessible depuis l'internet public sur le port 80 (http:) et/ou 443 (https:), à moins que votre serveur soit configuré pour utiliser les vérifications DNS - pour plus de détails, voir "certificats génériques".
Le module choisit une des méthodes proposées par Let's Encrypt. En général, LE propose des méthodes de vérification sur les ports ou le DNS et Apache choisit une des méthodes disponibles.
Pour déterminer quelles méthodes sont disponibles, le module
consulte les ports sur lesquels écoute Apache httpd. Si le port 80 en
fait partie, le module supposera que la vérification http: nommée
http-01 est disponible. Si le port 443 en fait aussi partie, la
vérification https: nommée tls-alpn-01 sera ajoutée à la liste des
méthodes disponibles. Enfin, si la directive MDChallengeDns01 est définie, la méthode
de vérification dns-01 sera aussi ajoutée.
Si votre configuration est plus complexe, deux méthodes permettent
d'orienter ce choix. En premier lieu, voyez du côté de la directive
MDPortMap si le serveur se
trouve derrière un redirecteur de port comme un pare-feu. En second
lieu, vous pouvez court-circuiter entièrement le processus de choix
du module en définissant directement la directive MDCAChallenges.
Pour la vérification de domaine via le protocole TLS, le nom de la
méthode correspondante est "tls-alpn-01". Le serveur Apache doit
alors être en écoute sur le port 443 (voir la directive MDPortMap si vous redirigez ce port vers
un autre).
Let's Encrypt ouvrira alors une connexion TLS avec Apache en utilisant l'indicateur spécial "acme-tls/1" (cette portion indication de TLS se nomme ALPN, d'où le nom de la méthode de vérification. ALPN est aussi utilisé par les navigateurs pour ouvrir une connexion HTTP/2.
Si vous ne souhaitez cependant qu'aucun de vos sites ne soit
accessible sur le port 80, vous pouvez laiser ce dernier ouvert et
rediriger toutes les requêtes vers vos sites en https:. Pour
ce faire, utilisez la directive MDRequireHttps décrite plus loin. Votre
serveur pourra alors continuer à répondre au requêtes en http: en
provenance de Let's Encrypt.
Comme dans le cas du protocole HTTP/2, vous pouvez configurer ceci
de la manière suivante :
Protocols h2 http/1.1 acme-tls/1
La méthode de vérification "tls-alpn-01" sera alors disponible.
Les certificats génériques sont supportés à partir de la version 2.x de mod_md, mais leur obtention n'est pas triviale. Let's Encrypt impose pour ces derniers la vérification "dns-01". Aucune autre n'est considérée comme suffisamment efficace.
Apache ne peut cependant pas implémenter cette vérification de lui-même . Comme son nom l'indique, "dns-01" vous demande de présenter certains enregistrement DNS spécifiques à votre domaine qui doivent contenir certaines données de vérification. Vous devez donc être en mesure d'éditer et modifier les enregistrements DNS de votre domaine.
Si c'est le cas, vous pouvez procéder via mod_md. Supposons que vous disposiez pour cela du script /usr/bin/acme-setup-dns ; vous configurez alors Apache comme suit :
MDChallengeDns01 /usr/bin/acme-setup-dns
Apache fera alors appel à ce script lorsqu'il aura besoin de définir ou détruire un enregistrement DNS de vérification pour le domaine considéré.
Supposons ainsi que vous souhaitiez obtenir un certificat pour *.mydomain.com ; mod_md va appeler :
/usr/bin/acme-setup-dns setup mydomain.com challenge-data # ceci nécessite de supprimer tout enregistrement DNS TXT pour # _acme-challenge.mydomain.com et d'en créer un nouveau dont le contenu sera # "challenge-data"
il appellera ensuite :
/usr/bin/acme-setup-dns teardown mydomain.com # ceci nécessite de supprimer tout enregistrement DNS TXT pour # _acme-challenge.mydomain.com
Apache possède un module de monitoring standard :
mod_status. mod_md y ajoute une section et facilite
le monitoring de votre domaine.
Vous pouvez alors visualiser tous vos domaines gérés par ordre alphabétique, les noms de domaine qu'ils contiennent, un état global, les date d'expiration ainsi que des paramètres spécifiques. Ces derniers comprennent la périodicité de renouvellement que vous avez sélectionnée (ou la valeur par défaut), la CA (autorité de certification) utilisée, etc...
La colonne "Renewal" montre des rapports d'activité ou d'erreur à propos des renouvellements de certificats, ce qui devrait faciliter la vie des utilisateurs qui souhaitent savoir si tout fonctionne correctement ou si des problèmes se produisent.
Si un des domaines gérés provoque une erreur, elle apparaîtra aussi ici, ce qui vous permettra de visualiser les éventuels problèmes sans devoir vous plonger dans les journaux du serveur.
Il existe aussi un nouveau gestionnaire, "md-status", qui peut vous fournir les informations à propos des domaines gérés à partir de "server-status" et au format JSON. Vous pouvez le configurer comme suit sur votre serveur :
<Location "/md-status"> SetHandler md-status </Location>
Comme pour "server-status", vous devez ajouter les autorisations nécessaires.
Si vous ne souhaitez recevoir l'état JSON que pour un domaine spécifique, ajoutez le simplement à votre URL d'état :
> curl https://<yourhost>/md-status/another-domain.org
{
"name": "another-domain.org",
"domains": [
"another-domain.org",
"www.another-domain.org"
],
...
Cet état JSON montre aussi un journal des renouvellements de certificats :
{
"when": "Wed, 19 Jun 2019 14:45:58 GMT",
"type": "progress", "detail": "The certificate for the managed domain has been renewed successfully and can be used. A graceful server restart now is recommended."
},{
"when": "Wed, 19 Jun 2019 14:45:58 GMT",
"type": "progress", "detail": "Retrieving certificate chain for test-901-003-1560955549.org"
},{
"when": "Wed, 19 Jun 2019 14:45:58 GMT",
"type": "progress", "detail": "Waiting for finalized order to become valid"
},{
"when": "Wed, 19 Jun 2019 14:45:50 GMT",
"type": "progress", "detail": "Submitting CSR to CA for test-901-003-1560955549.org"
},
...
Vous trouverez aussi ces informations dans le fichier "job.json" dans votre répertoire de test et, s'il est activé, dans le répertoire des domaines. Vous pourrez ainsi les consulter à tout moment.
Enfin, la directive MDCertificateStatus donne accès au
informations à propos du certificat spécifié au format JSON.
Si vous voulez commencer par tester l'agrafage pour un seul domaine géré, utilisez cette configuration :
<MDomain mydomain.net> MDStapling on </MDomain>
et utilisez 'server-status' et/ou MDMessageCmd pour voir comment tout
cela fonctionne. Vous pourrez alors vérifier si l'information
d'agrafage est présente, sa durée de validité, son origine et à
quel moment elle sera rafraîchie.
Si tout fonctionne comme vous le souhaitez, vous pouvez définir cette configuration pour tous les certificats ou seulement vos certificats gérés.
De nombreux sites utilisent l'implémentation d'agrafage existante de mod_ssl depuis des années. Les implémentations par mod-ssl et mod_md présentent deux différences principales :
Si par malchance vous redémarrez votre serveur alors que le service OCSP de votre CA est en panne, les utilisateurs ne pourront plus atteindre vos sites. Sans persistance des informations, votre serveur n'est plus en mesure de fournir au client les données nécessaires, et le navigateur client ne peut pas les obtenir lui-même car le service OCSP ne répond pas.
Avec l'implémentation de mod_md, l'information d'agrafage est stockée de manière persistante, et elle peut donc être réchargée au démarrage du serveur et être ainsi disponible pour les connexions entrantes. Un jour ou deux avant expiration des informations, mod_md va les renouveler, ce qui permet de faire face à un temps d'indisponibilité du service OCSP assez long.
Pour conserver une compatibilité ascendante, l'implémentation de mod_ssl n'a pas pu être modifiée en profondeur. Par exemple, mod_ssl est incapable d'ajouter une dépendance à mod_watchdog sans rendre inutilisables de nombreuses configurations existantes qui ne chargent pas ce module.
Depuis la version 2.4.14 du module, vous pouvez l'utiliser pour obtenir des certificats pour vos domaines tailscale.
<MDomain mydomain.some-thing.ts.net> MDCertificateProtocol tailscale MDCertificateAuthority file://localhost/var/run/tailscale/tailscaled.sock", </MDomain>
Tailscale permet des communications sécurisées entre vos machines, où qu'elles se trouvent, et peut leur fournir des noms de domaine dans l'espace *.ts.net. Pour ceux-ci, il fournira aussi ensuite des certificats Let's Encrypt de façon à ce que vous puissiez ouvrir ces domaines dans votre navigateur en toute sécurité.
Apache va contacter le démon tailscale local à l'aide des directives listées ci-dessous pour obtenir et renouveler les certificats. Ceci ne fonctionnera cependant que pour les noms de domaine que tailscale aura assigné à votre machine.
Dans le cas contraire, ces certificats fonctionneront exactement de la même façon que ceux qui auront été obtenus à l'aide du protocole ACME de Lets Encrypt. Vous les verrez dans le rapport d'état et les directives MDMessageCmd seront aussi exécutées pour eux.
Vous trouverez plus de détails dans la documentation github de mod_md.
Notez que cette fonctionnalité n'est disponible que sur les machines où le démon tailscale fournit un socket de domaine unix. Jusqu'à présent, ceci ne semble être le cas que sur les systèmes de style Unix.
MDActivationDelay MDBaseServer MDCAChallenges MDCertificateAgreement MDCertificateAuthority MDCertificateCheck MDCertificateFile MDCertificateKeyFile MDCertificateMonitor MDCertificateProtocol MDCertificateStatus MDChallengeDns01 MDChallengeDns01Version MDCheckInterval MDContactEmail MDDriveMode MDExternalAccountBinding MDHttpProxy MDMatchNames MDMember MDMembers MDMessageCmd MDMustStaple MDNotifyCmd MDomain <MDomainSet> MDPortMap MDPrivateKeys MDProfile MDProfileMandatory MDRenewMode MDRenewWindow MDRequireHttps MDRetryDelay MDRetryFailover MDServerStatus MDStapleOthers MDStapling MDStaplingKeepResponse MDStaplingRenewWindow MDStoreDir MDStoreLocks MDWarnWindow| Description: | Définit le délai d'activation des nouveaux certificats |
|---|---|
| Syntaxe: | MDActivationDelay duration |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache |
| Description: | Définit si le serveur global peut être géré ou seulement les serveurs virtuels. |
|---|---|
| Syntaxe: | MDBaseServer on|off |
| Défaut: | MDBaseServer off |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de définir si le serveur global, autrement dit la partie du serveur située en dehors de tout serveur virtuel, doit être géré par mod_md ou non. Par défaut il ne le sera pas car cela provoquerait des effets de bord générateurs de confusion. Il est donc recommandé de définir des serveurs virtuels pour tous les domaines gérés, et d'exclure des domaines gérés le serveur global (serveur par défaut).
| Description: | Type de négociation ACME utilisée pour prouver l'appartenance du domaine. |
|---|---|
| Syntaxe: | MDCAChallenges name [ name ... ] |
| Défaut: | MDCAChallenges tls-alpn-01 http-01 dns-01 |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de définir les types de négociation utilisés (par ordre de préférences) pour prouver l'appartenance du domaine. Les types de négociation supportés par le module sont 'tls-alpn-01', 'dns-01' et 'http-01'. Le module parcourt toute la configuration du serveur pour déterminer quelles méthodes peuvent être utilisées.
Si par exemple le serveur est en écoute sur le port 80, c'est la
méthode 'http-01' qui sera disponible. Pour 'dns-01', une
commande MDChallengeDns01
définie sera requise. La méthode 'tls-alpn-01' est décrite
ci-dessus dans 'https: Challenges'.
Cette sélection automatique fonctionne pour la plupart des configurations. Mais comme Apache est un serveur très puissant avec de nombreuses options de configuration, certains cas pourront poser des problèmes. Par exemple, il peut être en écoute sur plusieurs adresses IP, certaines étant accessibles en https: et d'autres non.
Si vous définissez MDCAChallenges
directement, la sélection automatique est désactivée. A la
place, le module va utiliser la liste de méthodes de négociation
spécifiée pour dialoguer avec le serveur ACME (un type de
négociation doit aussi être proposé par le serveur). Ces
méthodes de négociation sont examinées dans l'ordre selon lequel
elles sont spécifiées.
| Description: | Acceptation des conditions d'utilisation de l'autorité de certification. |
|---|---|
| Syntaxe: | MDCertificateAgreement accepted |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Lorsque vous utilisez mod_md pour obtenir un certificat, vous devenez un client de l'autorité de certification (par exemple Let's Encrypt). Cela signifie que vous devez lire et approuver leurs conditions d'utilisation, et donc que vous avez compris ce qu'ils ont à offrir, ce qu'ils ne fournissent pas, et ce que vous devez vous-même fournir. mod_md ne peut pas de lui-même procéder à cet agrément à votre place.
| Description: | Les URLs du service ACME de l'autorité de certification. |
|---|---|
| Syntaxe: | MDCertificateAuthority url |
| Défaut: | MDCertificateAuthority letsencrypt |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Les URLs auxquelles l'autorité de certication offre son service. Plutôt que l'URL proprement dite, vous pouvez spécifier 'letsencrypt' ou 'buypass'.
Si vous spécifiez plusieurs URLs, chacune d'entre elles est
testée en mode tourniquet ("round-robin") après un certain
nombre d'échecs. Vous pouvez définir la rapidité de ce processus
à l'aide des directives MDRetryDelay et
MDRetryFailover. Par défaut, une demie
journée d'essais infructueux est considérée comme un échec.
Tous les autres réglages s'appliquent à chacune de ces URLs. Il
est ainsi par exemple impossible d'en avoir deux avec des
directives MDExternalAccountBinding
différentes.
A des fins de test, les CAs fournissent en général une seconde URL de service. Le service 'test' ne fournit pas de certificat valable pour un navigateur, mais il est moins regardant vis à vis des limites de vitesse. Il permet de tester votre configuration avant de passer à l'URL de service de production.
MDCertificateAuthority https://acme-staging-v02.api.letsencrypt.org/directory
| Description: | Définit le motif de nom et d’URL pour un nom de site de vérification de certificat. |
|---|---|
| Syntaxe: | MDCertificateCheck name url |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache |
| Description: | Définit un fichier de certificat statique pour le domaine géré. |
|---|---|
| Syntaxe: | MDCertificateFile path-to-pem-file |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive s'utilise dans une section MDomainSet et permet de spécifier le
nom du fichier qui contiendra le certificat pour le
domaine géré. La clé correspondante est spécifiée via la
directive MDCertificateKeyFile.
<MDomain mydomain.com> MDCertificateFile /etc/ssl/my.cert MDCertificateKeyFile /etc/ssl/my.key </MDomain>
Cette directive est équivalente à la directive SSLCertificateFile de mod_ssl. Elle
s'utilise dans de nombreuses applications.
Une première application est la migration de la gestion des
certificats d'un domaine existant depuis le mode statique via des
fichiers vers le mode automatique via Let's Encrypt. A cet
effet, vous définissez tout d'abord la section MDomainSet dans laquelle vous
spécifiez les fichiers, puis supprimez la directive SSLCertificateFile de la
configuration de vos serveurs virtuels.
Avec cette configuration, votre serveur fonctionnera comme
avant, avec probablement moins de lignes répétitives. Vous
pouvez alors ajouter la directive MDRenewMode avec pour valeur
"always", et le module obtiendra un nouveau cerificat avant que
celui du fichier considéré n'arrive à expiration. Une fois le
certificat renouvelé, vous pouvez supprimer la directive
MDCertificateFile et
recharger la configuration.
Une autre application est le renouvellement de vos certificats Let's Encrypt avec d'autres clients ACME comme l'excellent certbot. A cet effet, faites pointer vos domaines gérés vers les fichiers de certbot et ils travaillerons alors ensemble.
| Description: | Définit une clé privée statique pour le certificat statique. |
|---|---|
| Syntaxe: | MDCertificateKeyFile path-to-file |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive s'utilise dans une section MDomainSet et permet de spécifier le
nom du fichier contenant la clé privée pour le domaine géré. Le
certificat correspondant est spécifié via la directive
MDCertificateFile.
Cette directive est équivalente à la directive SSLCertificateKeyFile de mod_ssl.
| Description: | L'URL d'un moniteur d'enregistrement de certificat. |
|---|---|
| Syntaxe: | MDCertificateMonitor name url |
| Défaut: | MDCertificateMonitor crt.sh https://crt.sh?q= |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive impacte l'interface utilisateur HTML 'server-status' et n'a rien à voir avec le fonctionnement de mod_md proprement dit. Elle permet de définir le lien qui s'affiche sur cette interface pour accéder facilement à un moniteur de certificat. L'empreinte SHA256 du certificat doit être ajoutée à l'URL spécifié.
Les moniteurs de certificat donnent accès aux enregistrements de la Certificate Transparency (CT) afin de tracer l'utilisation des certificats pour les domaines. Vous pourrez au moins vérifier si Let's Encrypt (ou tout autre CA que vous aurez défini) a bien inscrit votre certificat dans les enregistrements de CT.
Avertissement : La mise à jour des enregistrements des certificats et leur prise en compte par les moniteurs peut prendre un certain temps. Ce dernier varie en fonction des enregistreurs et des moniteurs. Un nouveau certificat ne sera donc pas connu immédiatement.
| Description: | Le protocole à utiliser avec l'autorité de certification. |
|---|---|
| Syntaxe: | MDCertificateProtocol protocol |
| Défaut: | MDCertificateProtocol ACME |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de spécifier le protocole à utiliser.
Pour l'heure, seul le protocole ACME est supporté.
| Description: | Extrait les informations publiques du certificat au format JSON. |
|---|---|
| Syntaxe: | MDCertificateStatus on|off |
| Défaut: | MDCertificateStatus on |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Lorsque cette directive est à "on", vous disposez d'une ressource pour les domaines gérés à https://domain/.httpd/certificate-status qui renvoie un document au format JSON contenant une liste de propriétés concernant les clés, le certificat courant et, s'il est disponible, le certificat renouvelé.
{
"valid-until": "Thu, 29 Aug 2019 16:06:35 GMT",
"valid-from": "Fri, 31 May 2019 16:06:35 GMT",
"serial": "03039C464D454EDE79FCD2CAE859F668F269",
"sha256-fingerprint": "1ff3bfd2c7c199489ed04df6e29a9b4ea6c015fe8a1b0ce3deb88afc751e352d"
"renewal" : { ...renewed cert information... }
}
| Description: | Définit la commande d'activation/désactivation des vérifications dns-01 |
|---|---|
| Syntaxe: | MDChallengeDns01 path-to-command |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de définir le programme à appeler
lorsque la vérification "dns-01" doit être activée/désactivée. Le
programme prend respectivement comme arguments "setup" ou
"teardown" suivi du nom de domaine. Pour "setup", le programme
prend comme argument supplémentaire les données de vérification
"dns-01". Lorsque MDChallengeDns01Version est définie
à 2, `teardown` prend aussi comme argument le contenu de la
vérification.
Tant que la méthode de vérification "http:" ou "https:" est valable, vous n'avez pas besoin de définir cette directive. Cependant, Let's Encrypt n'accepte que "dns-01" comme méthode de vérification valide pour les certificats génériques. Si vous avez besoin d'un tel certificat, vous devez alors définir cette directive.
Il est maintenant possible d'utiliser cette directive dans une
section MDomain pour
spécifier une commande spécifique au domaine considéré. Cela
permet de configurer un script spécifique au fournisseur de DNS
concerné.
Reportez vous à la section sur les certificats génériques pour plus de détails.
| Description: | Définit le type des arguments avec lesquels appeler MDChallengeDns01 |
|---|---|
| Syntaxe: | MDChallengeDns01Version 1|2 |
| Défaut: | MDChallengeDns01Version 1 |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.58 du serveur HTTP Apache |
Cette directive permet de définir de quelle manière est invoquée
la commande MDChallengeDns01, à savoir le nombre et le type de
ses arguments. Voir MDChallengeDns01 pour les
différences.
Cette définition est globale et ne peut pas s'appliquer
différemment pour chaque domaine.
| Description: | Détermine la périodicité de la vérification des certificats |
|---|---|
| Syntaxe: | MDCheckInterval duration |
| Défaut: | MDCheckInterval 12h |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.60 du serveur HTTP Apache |
Cette option permet de définir l’intervalle entre deux vérifications de certificat. Par défaut, la validité et le besoin de renouvellement sont vérifiés deux fois par jour. Cet intervalle n’est cependant pas appliqué avec précision. En effet, le module lui applique une plage de variation aléatoire de +/- 50%. Avec l’intervalle par défaut de 12 heures, cela signifie que l’intervalle réel entre deux vérifications varie entre 6 et 18 heures, la variation s’appliquant à nouveau à chaque vérification. Cela permet d’atténuer les pics de trafic sur les serveurs ACME.
La valeur minimale pouvant être définie pour l’intervalle est de 1 seconde. Il est cependant déconseillé de définir un intervalle aussi court sur un serveur en production.
| Description: | Adresse Email pour l'enregistrement du compte |
|---|---|
| Syntaxe: | MDContactEmail address |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache |
Lors de votre inscription, vous devez fournir une url de contact
pour le protocole ACME. Actuellement, Let's Encrypt exige une
adresse Email qu'il utilisera pour vous informer des
renouvellements de certificats ou de toute modification des
conditions d'utilisation. Pour obtenir cette adresse, mod_md
utilise l'email spécifiée par la directive MDContactEmail dans
votre configuration de httpd ; veillez par conséquent à bien
spécifier une adresse correcte à ce niveau. Si la directive
MDContactEmail n'est pas définie, mod_md utilisera l'email
spécifiée via la directive ServerAdmin.
| Description: | Ancien nom de MDRenewMode. |
|---|---|
| Syntaxe: | MDDriveMode always|auto|manual |
| Défaut: | MDDriveMode auto |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive est l'ancien nom de la directive MDRenewMode, et n'est encore supportée
qu'à titre de compatibilité ascendante.
| Description: | Définit les valeurs keyid et hmac de liaison avec les comptes externes à utiliser dans les CA |
|---|---|
| Syntaxe: | MDExternalAccountBinding key-id hmac-64 | none | file |
| Défaut: | MDExternalAccountBinding none |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.52 du serveur HTTP Apache |
Cette directive permet de définir des valeurs pour associer des comptes externes avec ACME ("External Account Binding") ; c'est une fonctionnalité de la norme ACME qui permet à des clients d'associer des inscriptions à un compte client existant sur les serveurs ACME.
Certains CAs ACME ont besoin de ces valeurs, mais ce n'est pas le cas pour Let's Encrypt. Vérifiez avec votre CA ACME si vous avez besoin de ces valeurs et la manière de les obtenir. Ces dernières se composent de deux chaînes : un identifiant de clé et une valeur 'hmac' codée en base64.
Vous pouvez définir ces valeurs de manière globale ou pour un MDomain spécifique. Comme ces valeurs permettent à n'importe qui de s'inscrire sous le même compte, il est conseillé de restreindre les permissions d'accès au fichier de configuration (à root seulement, par exemple).
Les valeurs peuvent aussi être extraites d'un fichier JSON pour conserver l'ouverture des permissions au niveau de la configuration du serveur et restreindre celles de ce fichier. Le fichier JSON sera du style :
{"kid": "kid-1", "hmac": "zWND..."}
Si vous modifiez les valeurs EAB, ce sont les nouvelles valeurs qui seront utilisées lors du prochain renouvellement de certificat.
| Description: | Spécifie un serveur mandataire pour les connexions sortantes. |
|---|---|
| Syntaxe: | MDHttpProxy url |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de spécifier un serveur http mandataire
pour se connecter à l'autorité de certification spécifiée via
MDCertificateAuthority. Vous
devez la définir si votre serveur web ne peut atteindre internet que
via un serveur mandataire.
| Description: | Définit comment les noms DNS sont comparés aux vhosts |
|---|---|
| Syntaxe: | MDMatchNames all|servernames |
| Défaut: | MDMatchNames all |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.58 du serveur HTTP Apache |
Le mode `all` correspond au comportement de toutes les versions précédentes. ServerName et ServerAlias sont inspectés pour trouver le MDomain qui correspond à un serveur virtuel. Les recouvrements sont automatiquement détectés, même si vous n'avez ajouté qu'un des noms à un MDomain.
Cet automatisme présente cependant des inconvénients avec les configurations plus complexes. Si vous définissez cette directive à `servernames`, seul le ServerName d'un serveur virtuel est inspecté pour la correspondance et les ServerAliases sont donc ignorés. Les Aliases seront tout de même ajoutés au certificat obtenu, à moins que vous ne spécifiiez aussi `MDMembers manual`.
`servernames` possède un autre avantage : il vous confère plus de souplesse avec les sous-domaines et les caractères génériques. Vous pouvez ainsi définir un MDomain avec un caractère générique et avoir d'autres MDomains pour des noms de sous-domaines spécifiques.
| Description: | Nom d'hôte additionnel pour le domaine géré. |
|---|---|
| Syntaxe: | MDMember hostname |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Plutôt que de lister tous les noms DNS sur la même ligne, vous
pouvez utiliser la directive MDMember pour
ajouter des noms d'hôte à un domaine géré.
<MDomain example.org>
MDMember www.example.org
MDMember mail.example.org
</MDomain>
Si vous utilisez cette directive au niveau de la configuration
globale, en dehors de tout serveur virtuel correspondant à un
domaine géré, vous ne pouvez spécifier qu'une valeur, 'auto' ou
'manual' comme mode par défaut pour tous les autres domaines
gérés. Voir la directive MDomain pour une description de ces
valeurs.
| Description: | Définit si les alias de noms de domaines sont automatiquement ajoutés. |
|---|---|
| Syntaxe: | MDMembers auto|manual |
| Défaut: | MDMembers auto |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de définir si les valeurs de ServerName et ServerAlias sont automatiquement ajoutées
en tant que membres d'un domaine géré.
| Description: | Gère les évènements pour les domaines gérés |
|---|---|
| Syntaxe: | MDMessageCmd path-to-cmd optional-args |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de définir la commande à appeler lorsqu'un des évènements "renewed", "installed", "expiring" ou "errored" se produit pour un domaine géré. La commande sera probablement invoquée pour d'autres évènements dans le futur et ignorera les évènements pour lesquels elle n'aura pas été préparée.
Il s'agit d'une version plus souple de la directive
MDNotifyCmd.
MDMessageCmd /etc/apache/md-message
# sera invoquée sous la forme "/etc/apache/md-message renewed mydomain.com"
# lorsqu'un nouveau certificat sera disponible pour le domaine mydomain.com
Le programme ne doit pas être bloquant car le module attend qu'il se termine. Un code de retour autre que 0 doit indiquer une erreur d'exécution.
"errored" n'est pas l'évènement à surveiller en priorité car le renouvellement du certificat est censé se produire suffisammant tôt pour éviter toute interruption de service. Cet évènement est signalé au plus une fois par heure.
L'évènement "expiring", quant à lui, doit être pris au sérieux.
Il se produit lorsque la valeur de MDWarnWindow est atteinte. Par
défaut, cette valeur correspond à 10% de la durée de vie du
certificat, donc actuellement pour Let's Encrypt, 9 jours avant
expiration du certificat. Le message d'avertissement est répété
au plus une fois par jour.
'renewed' indique qu'un nouveau certificat a été obtenu et se trouve dans la zone intermédiaire du magasin MD. Il sera activé au prochain restart/reload du serveur.
'installed' indique qu'un nouveau certificat a été transféré
depuis la zone intermédiaire vers la zone des domaines du
magasin MD. Cet évènement se produit lors d'un restart/reload du
serveur. A la différence des autres commandes,
MDMessageCmd s'exécute avec les
permissions de root (sur les systèmes *nix) et a donc accès aux
fichiers de certificats (et aux clés). Les certificats
nécessaires à d'autres applications ou possédant des formats
différents peuvent être traités suite à cet évènement.
Un évènement de type 'renewing' est déclenché avant le démarrage du processus de renouvellement pour le domaine géré. Si dans ce cas la commande renvoie une valeur non nulle, le renouvellement sera interrompu et tenté à nouveau au cycle suivant. Certaines configurations de clusters l'utilisent pour n'effectuer le renouvellement que sur un seul noeud.
Un évènement de type 'challenge-setup:type:domain' est déclenché lorsque les données de vérification pour un domaine ont été créées. Il est invoqué avant qu'il soit demandé au serveur ACME de les vérifier. type contient une des méthodes de vérification ACME. Il est invoqué pour chaque nom DNS d'un MDomain. Les configurations de clusters peuvent utiliser cet évènement pour distribuer les fichiers de vérification à tous les noeuds.
Un évènement de type ocsp-errored est déclenché lorsque le
MDStapling est activé
pour un domaine, et indique qu'une erreur s'est produite en
essayant d'obtenir la réponse OCSP de l'autorité de
certification. mod_md essaiera à nouveau d'obtenir cette
réponse.
| Description: | Définit si les nouveaux certificats doivent avoir le drapeau OCSP Must Staple activé. |
|---|---|
| Syntaxe: | MDMustStaple on|off |
| Défaut: | MDMustStaple off |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de définir si les nouveaux certificats
doivent avoir le drapeau OCSP Must Staple activé ou non. Si un
certificat possède ce drapeau, le serveur devra envoyer une réponse
avec agrafage OCSP à chaque client. Ceci ne fonctionne que si vous
configurez mod_ssl pour générer cette agrafe (voir la
directive SSLUseStapling et
ses directives dérivées).
| Description: | Lance un programme lorsqu'un domaine géré est opérationnel. |
|---|---|
| Syntaxe: | MDNotifyCmd path [ args ] |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de définir un programme à lancer lorsqu'un domaine géré a obtenu ou renouvelé son certificat. Ce programme reçoit le nom de domaine géré concerné comme argument additionnel (après les paramètres spécifiés ici). Il doit renvoyer un code d'état de 0 s'il s'est exécuté avec succès.
| Description: | Définit une liste de noms de domaines qui appartiennent à un groupe. |
|---|---|
| Syntaxe: | MDomain dns-name [ other-dns-name... ] [auto|manual] |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Tous les domaines de la liste seront gérés par
mod_md comme un seul domaine géré (Managed Domain - MD).
mod_md ne demandera qu'un seul certificat qui
sera valide pour tous ces noms de domaine. Cette directive
s'utilise au niveau de la configuration globale (voir plus loin
les autres directives MD). Si un domaine nécessite une
configuration particulière, utilisez la directive <MDomainSet>.
Deux définitions supplémentaires sont nécessaires pour un
domaine géré : une adresse Email de contact (via MDContactEmail ou ServerAdmin) et MDCertificateAgreement. L'adresse
électronique du ServerAdmin
permet de s'enregistrer auprès de l'autorité de certification
(par défaut Let's Encrypt). L'autorité de certification
l'utilisera pour vous informer à propos du statut de vos
certificats ou d'éventuelles modifications de ses services.
La seconde définition, MDCertificateAgreement doit avoir
pour valeur "accepted". Vous confirmez ainsi que vous acceptez
les conditions d'utilisation du CA.
MDContactEmail admin@example.org
MDCertificateAgreement accepted
MDomain example.org www.example.org
<VirtualHost *:443>
ServerName example.org
DocumentRoot htdocs/root
SSLEngine on
</VirtualHost>
<VirtualHost *:443>
ServerName www.example.org
DocumentRoot htdocs/www
SSLEngine on
</VirtualHost>
En plus de la liste des domaines gérés, cette directive accepte un paramètre supplémentaire qui peut prendre pour valeur 'manual' ou 'auto'. Ce paramètre permet de définir si un domaine sera géré sous le nom spécifié dans la liste seul ('manual'), ou si tous les noms du serveur virtuel correspondant seront gérés ('auto'). C'est d'ailleurs cette dernière valeur qui est la valeur par défaut.
MDomain example.org
<VirtualHost *:443>
ServerName example.org
ServerAlias www.example.org
DocumentRoot htdocs/root
SSLEngine on
</VirtualHost>
MDomain example2.org auto
<VirtualHost *:443>
ServerName example2.org
ServerAlias www.example2.org
...
</VirtualHost>
Dans cet exemple, le domaine 'www.example.org' est automatiquement ajouté à la liste MD 'example.org'. De manière similaire, le domaine 'www.example2.org' sera automatiquement ajouté à la liste MD 'example2.org' pour laquelle 'auto' est explicitement spécifié. Chaque fois que vous ajouterez des noms à ces serveurs virtuels via ServerAlias, ils seront ajoutés à la liste MD correspondante.
Si vous préférez déclarer explicitement tous les noms de domaines, utilisez le mode 'manual'. Une erreur sera enregistrée dans le journal si les noms ne correspondent pas à ceux attendus.
| Description: | Conteneur de directives à appliquer à un ou plusieurs domaines gérés. |
|---|---|
| Syntaxe: | <MDomainSet dns-name [ other-dns-name... ]>...</MDomainSet> |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive est équivalente à la directive MDomain avec la possibilité
supplémentaire d'ajouter des paramètres seulement pour le
domaine géré considéré. En fait, vous pouvez aussi utiliser
"<MDomain ..>" à titre de raccourci.
Cette directive permet de configurer un domaine géré en spécifiant un autre CA, ou d'autres paramètres de renouvellement des certificats, etc...
<MDomain sandbox.example.org>
MDCertificateAuthority https://someotherca.com/ACME
</MDomain>
Cette configuration est souvent utilisée pour définir des paramètres https: spécifiques à votre domaine.
<MDomain example.org>
MDRequireHttps temporary
</MDomain>
| Description: | Mappage des ports externes avec les ports internes pour vérifier à qui appartient le domaine. |
|---|---|
| Syntaxe: | MDPortMap map1 [ map2 ] |
| Défaut: | MDPortMap http:80 https:443 |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Le protocole ACME propose deux méthodes pour vérifier à qui
appartient le domaine via HTTP : la première utilise les URLs en
"http:" (port 80) et la deuxième les URLs en "https:" (port
443). Si votre serveur n'est accessible sur aucun
de ces ports, ACME ne pourra fonctionner que si vous configurez
votre serveur DNS de manière adéquate (voir la directive MDChallengeDns01).
Sur la plupart des serveurs publics, "http:" arrive sur le port 80 et "https:" sur le port 443. Ce module vérifie les ports sur lesquels votre serveur Apache est en écoute et suppose qu'ils sont disponibles. Autrement dit, si votre serveur n'est pas en écoute sur le port 80, le module suppose que les requêtes en "http:" en provenance d'internet ne seront pas traitées.
Ce raisonnement est légitime, mais il peut s'avérer faux. Par exemple, même si votre serveur est effectivement en écoute sur le port 80, votre pare-feu peut bloquer ce dernier. "http:" ne sera alors disponible que sur votre intranet. Dans ce cas, le module va supposer de manière erronée que Let's Encrypt peut effectuer des vérifications en "http:" avec votre serveur. Ces dernières échouerons car elles auront été rejetées par votre pare-feu.
MDPortMap http:- https:8433
L'exemple précédent montre comment spécifier que les requêtes en "http:" en provenance d'internet n'arriveront jamais. En outre, il indique que les requêtes en "https:" arriveront sur le port 8433.
Cette définition peut s'avérer nécessaire si vous faites de la redirection de port ; votre serveur peut ainsi être accessible depuis l' Internet sur le port 443, alors que le port local utilisé par httpd sera différent. Par exemple, votre serveur peut n'être en écoute que sur les ports 8443 et 8000, mais accessible depuis internet sur les ports 443 et 80.
| Description: | Définit le type et la taille des clés privées générées. |
|---|---|
| Syntaxe: | MDPrivateKeys type [ params... ] |
| Défaut: | MDPrivateKeys RSA 2048 |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de définir les paramètres de construction des clés privées pour les domaines gérés. Vous pouvez configurer plusieurs types de clés privées et le module obtiendra un certificat pour chaque clé.
La recommandation actuelle (en 2017) est de 2048 bits au minimum, et une valeur inférieure ne sera pas acceptée. Des valeurs supérieures offriront une plus grande sécurité mais seront plus gourmandes en ressources, et augmenteront donc la charge de votre serveur, ce qui pourra (ou non) être gênant pour vous.
D'autres types de clés seront supportés dans le futur. Vous pouvez par exemple configurer une clé RSA et une clé Elliptic Curve (EC) de façon à ce que deux certificats soient créés pour le domaine concerné. Lors d'une connexion avec un client, c'est la première clé supportée par ce dernier qui sera utilisée.
Comme les clés et certificats EC sont plus petits, vous pouvez les proposer en premier pour tous les clients modernes compatibles, ce qui peut accélérer la phase de négociation. Ajoutez tout de même une clé RSA pour supporter les clients plus anciens.
MDPrivateKeys secp256r1 rsa3072
Les types EC supportés dépendent du CA que vous utilisez. Par exemple, Let's encrypt supporte les courbes elliptiques 'secp256r1' et 'secp384r1'.
Chaque type de clé et certificat est stocké dans son fichier propre au sein de l'espace de stockage MD. Le type de clé constitue une partie du nom de fichier avec une convention de nommage présentant une compatibilité ascendante avec les certificats RSA. Vous pouvez ainsi continuer à partager ces fichiers avec les autres applications.
Notez que cette directive n'aura d'effet que sur les nouvelles clés. Toute clé préexistante ne sera pas affectée. En outre, seules les clés privées générées pour les certificats sont concernées, les clés de comptes ACME n'étant pas affectées.
| Description: | Utiliser un profile ACME spécifique depuis le CA |
|---|---|
| Syntaxe: | MDProfile name |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.64 du serveur HTTP Apache |
Il s’agit d’une extension non standard d’ACME par Let's Encrypt.
Lets Encrypt a annoncé qu’ils allaient ajouter la prise en charge des profiles de certificat à leurs CA courant 2025, en commençant par leurs serveurs de test. Cette fonctionnalité, entre autres détails, vous permettra de définir la durée de validité des certificats que vous recevez. À ce titre, le profile « default » conservera la valeur de 90 jours, alors que le profile « tlsserver » délivrera des certificats dont la durée de validité sera de 6 jours seulement.
Si vous ne modifiez pas la configuration de votre module mod_md, vous continuerez à recevoir des certificats d’une durée de validité de 90 jours. Si vous pensez qu’une durée de validité plus courte convient mieux à votre situation (et acceptez le risque que le temps de renouvellement soit beaucoup plus court), vous pouvez définir le profile à utiliser à l’aide de « MDProfile tlsserver ».
Les noms de profile sont définis par le CA. Si vous tentez de définie un profile non valable, aucun profile ne sera utilisé, et le certificat sera délivré avec les valeurs par défaut du CA.
Voir la directive MDProfileMandatory pour la manière
de désactiver les valeurs par défaut pour les profiles.
| Description: | Contrôler si un MDProfile est obligatoire. |
|---|---|
| Syntaxe: | MDProfileMandatory on|off |
| Défaut: | MDProfileMandatory off |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de contrôler si un MDProfile que vous définissez est
obligatoire ou non. S’il est obligatoire et si le CA ne propose
pas de profile configuré, le renouvellement du certificat
échouera.
S’il n’est pas obligatoire et si le CA ne propose pas de profile, les renouvellements seront effectués sans profile particulier et le CA délivrera les certificats avec les valeurs par défaut.
| Description: | Contrôle le renouvellement des certificats. |
|---|---|
| Syntaxe: | MDRenewMode always|auto|manual |
| Défaut: | MDRenewMode auto |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
En mode "auto" (mode par défaut), le module va agir de la manière la plus opportune pour chaque domaine géré. Si un domaine ne possède pas de certificat, le module en demandera un à l'autorité de certification.
Si par contre vous avez défini un domaine géré qui n'est utilisé
par aucun serveur virtuel, le module n'effectuera aucune demande
de renouvellement. De même, pour les domaines gérés avec des
fichiers de certificats statiques (voir MDCertificateFile), le module
supposera que vous avez votre propre source et n'effectuera
aucune demande de renouvellement.
Avec le mode "always", le module renouvellera les certificats des modules gérés, même s'il ne sont pas utilisés ou possèdent un fichier de certificats statique.
A l'opposé, avec le mode "manual", mod_md n'effectuera aucune demande automatique de renouvellement pour aucun domaine géré.
| Description: | Définit le moment auquel un certificat doit être renouvelé. |
|---|---|
| Syntaxe: | MDRenewWindow duration |
| Défaut: | MDRenewWindow 33% |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Lorsqu'un certificat arrive à expiration, mod_md va tenter d'en obtenir un nouveau signé.
Normalement, les certificats ont une validité de 90 jours, et mod_md les renouvelle lorsqu'il leur reste 33% de durée de vie (soit 30 jours pour une durée de vie de 90 jours). Si cela ne correspond pas à ce que vous souhaitez, vous pouvez spécifier une autre valeur comme dans les exemples suivants :
# 21 jours avant expiration MDRenewWindow 21d # 30 secondes (peut-être un peu juste !) MDRenewWindow 30s # lorsqu'il reste 10% de durée de vie au certificat MDRenewWindow 10%
En mode pilotage automatique, le module va vérifier le statut des domaines gérés au moins toutes les 12 heures pour voir s'il y a quelque chose à faire. En cas d'erreur, par exemple lorsque le CA est inaccessible, il va dans un premier temps réessayer après quelques secondes. Si l'erreur persiste, il va réduire son intervalle de vérification de 12 à 1 heure.
| Description: | Redirige le trafic http: vers https: pour les domaines gérés. |
|---|---|
| Syntaxe: | MDRequireHttps off|temporary|permanent |
| Défaut: | MDRequireHttps off |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive facilite la migration de vos domaines gérés de http: vers https:. Dans l'exemple suivant,
MDRequireHttps temporary
vous indiquez que vous désirez que pour l'instant, tout le trafic via des URLs en http: doit être redirigé vers des URLs en https:. Cette directive est sans risque et vous pouvez la désactiver à tout moment.
Ce qui suit par contre, a des conséquences : si vous souhaitez que les clients n'utilisent plus d'URLs en http:, spécifiez :
MDRequireHttps permanent
Cette directive a deux effets :
http:
sont redirigées vers la même requête en remplaçant le protocole
http: par https: et en renvoyant le code
d'état 301. Ce dernier indique aux clients que
cette modification est permanente et qu'ils doivent mettre à
jour leurs liens en conséquence.
https:
comporteront l'en-tête Strict-Transport-Security
avec une durée de vie de six mois. Cela indique au navigateur
qu'il ne devra jamais utiliser
http: (pendant six mois) lorsqu'il formulera une
requête pour le domaine concerné. Avec cette information, les
navigateurs refuseront de contacter votre site en mode non
chiffré. Ceci interdit à des middlewares malicieux de dégrader
les connexions et d'écouter/manipuler le trafic. C'est une bonne
chose, mais cette configuration ne peut pas être désactivée
aussi simplement que la configuration temporaire ci-dessus.
Vous pouvez obtenir le même résultat de manière simple avec
mod_alias et une configuration basée sur la
directive Redirect. Si
vous le faites vous-même, assurez-vous d'exclure les chemins
/.well-known/* de votre redirection, sinon mod_md
aura des difficultés pour signer les nouveaux certificats.
Si vous effectuez cette configuration au niveau global, elle s'appliquera à tous les domaines gérés. Si vous souhaitez qu'elle ne s'applique qu'à un domaine spécifique, utilisez :
<MDomain xxx.yyy> MDRequireHttps temporary </MDomain>
| Description: | Temps d'attente avant de réessayer, doublé à chaque erreur consécutive |
|---|---|
| Syntaxe: | MDRetryDelay duration |
| Défaut: | MDRetryDelay 5s |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.54 du serveur HTTP Apache |
Le temps d'attente après une erreur avant de tenter à nouveau le renouvellement d'un certificat. Ce temps est doublé après chaque erreur consécutive avec un maximum de 24 heures.
Ce temps d'attente est spécifique à chaque renouvellement de certificat. Autrement dit, une erreur sur un MDomain ne retarde pas les renouvellements des autres domaines.
| Description: | Le nombre d'erreurs avant de se tourner vers un autre CA |
|---|---|
| Syntaxe: | MDRetryFailover number |
| Défaut: | MDRetryFailover 13 |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.54 du serveur HTTP Apache |
Le nombre d'erreurs consécutives lors du renouvellement d'un
certificat avant la sélection d'une autre CA. Ne s'applique
qu'aux configurations pour lesquelles plusieurs
MDCertificateAuthority ont été
spécifiées.
| Description: | Définit si les informations à propos des domaines gérés sont ajoutés ou non à server-status. |
|---|---|
| Syntaxe: | MDServerStatus on|off |
| Défaut: | MDServerStatus on |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Le gestionnaire d'Apache "server-status" vous permet de configurer une ressource pour monitorer le fonctionnement du serveur. Cette ressource inclut maintenant une section indiquant tous les domaines gérés avec leur nom DNS, l'état de renouvellement du certificat, la durée de vie de ce dernier, ainsi que d'autres propriétés fondamentales.
Cette directive permet d'activer/désactiver cette ressource.
| Description: | Active l'agrafage pour les certificats non gérés par mod_md. |
|---|---|
| Syntaxe: | MDStapleOthers on|off |
| Défaut: | MDStapleOthers on |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache |
Cette directive n'a d'effet que si MDStapling est activée. Elle permet
de contrôler si mod_md doit aussi fournir les
informations d'agrafage pour les certificats qu'il ne gère pas
directement (autrement dit pour les certificats non renouvelés
via le protocole ACME).
| Description: | Active l'agrafage pour un ou plusieurs domaines. |
|---|---|
| Syntaxe: | MDStapling on|off |
| Défaut: | MDStapling off |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache |
mod_md permet l'obtention des informations
d'agrafage OCSP. Cette fonctionnalité est une alternative à
celle fournie par mod_ssl. Elle est désactivée
par défaut à des fins de compatibilité ascendante.
La fonctionnalité peut être activée pour tous les certificats du
serveur ou pour un MDomain seulement, ce qui aura pour effet
de remplacer toute configuration d'agrafage au niveau de
mod_ssl pour ce(s) domaine(s). Lorsqu'elle est désactivée,
l'agrafage de mod_ssl se chargera du travail (s'il a été
lui-même activé, bien entendu). Ceci permet de basculer de
manière graduée d'une implémentation à l'autre.
L'agrafage fonctionne aussi pour les domaines non gérés par
mod_md (voir à ce sujet la directive MDStapleOthers). En fait, l'agrafage
OCSP peut très bien être utilisé en l'absence de tout certificat
géré via le protocole ACME.
| Description: | Contrôle la durée au bout de laquelle les anciennes réponses doivent être supprimées. |
|---|---|
| Syntaxe: | MDStaplingKeepResponse duration |
| Défaut: | MDStaplingKeepResponse 7d |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache |
Cette directive permet de spécifier la durée au bout de laquelle les données OCSP utilisées pour l'agrafage doivent être supprimées du magasin. Par défaut, ces informations sont supprimées lors d'un restart/reload du serveur si elles ont plus de sept jours. Ceci permet de limiter la taille du magasin lorsque les certificats sont renouvelés et/ou reconfigurés fréquemment.
| Description: | Contrôle l'ancienneté des réponses OCSP au dela de laquelle ces dernières seront renouvelées. |
|---|---|
| Syntaxe: | MDStaplingRenewWindow duration |
| Défaut: | MDStaplingRenewWindow 33% |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache |
Si la durée de validité d'un réponse OCSP passe en dessous de
duration, mod_md va tenter de la
renouveler.
La CA à l'origine du certificat fournit aussi en général le service de réponse OCSP et détermine la durée de validité de sa réponse signée à propos de la validité du certificat. Plus longtemps une réponse sera valide, plus longtemps elle pourra être mise en cache, ce qui arrange tout le monde en matière de performances. Plus courte sera la validité d'une réponse, plus vite seront envoyées des révocations de certificats aux clients. Il est donc important de prendre en compte la qualité de service.
En ajustant la durée de validité des réponses vous-même, vous pouvez contrôler une partie du processus. Si vous spécifiez une durée de vie importante (autrement dit si vous spécifiez un petit pourcentage de validité avant que l'information n'expire), vous assurer un temps de mise en cache maximal, mais une interruption du service OCSP (par exemple un arrêt pour maintenance) aura plus de chance de vous affecter. Si vous spécifiez un pourcentage de temps avant expiration plus important, les mises à jour seront plus fréquentes, ce qui va augmenter la charge de l'infrastructure de serveurs du CA et nécessiter d'avantage de coordination entre les processus enfants de votre propre serveur.
La valeur par défaut choisie est de 33%, ce qui signifie que la demande de renouvellement interviendra lorsque la durée de vie de la réponse OCSP passera en dessous de 33%. Pour une CA qui fournit des réponses OCSP avec une durée de vie de 3 jours, cela implique 2 jours de mise en cache et 1 jour pour les tentatives de renouvellement. Pour affecter votre domaine, une interruption de service devra donc avoir une durée supérieure à 1 jour.
Vous pouvez aussi définir de manière absolue la durée de vie restante, par exemple `2d` pour 2 jours.
| Description: | Chemin dans le système de fichiers local du répertoire où seront stockées les données à propos des domaines gérés. |
|---|---|
| Syntaxe: | MDStoreDir path |
| Défaut: | MDStoreDir md |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Cette directive permet de définir le répertoire dans le système de fichiers local où seront stockées les données à propos des domaines gérés. Il s'agit d'un chemin absolu ou relatif à la racine du serveur. Par défaut, le répertoire "md" sera créé à la racine de votre serveur.
Si vous souhaitez changer de répertoire et si ce dernier contient déjà des données, copiez tout d'abord les données vers le nouveau répertoire, puis modifier la configuration et redémarrez le serveur. Si vous commencez par modifier la configuration et redémarrer le serveur sans copier les données, ce dernier croira que les certificats sont absents et il tentera d'en obtenir de nouveaux.
| Description: | Configure le verrouillage du magasin pour les mises à jour |
|---|---|
| Syntaxe: | MDStoreLocks on|off|duration |
| Défaut: | MDStoreLocks off |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
| Compatibilité: | Disponible à partir de la version 2.4.55 du serveur HTTP Apache |
Définissez cette directive pour utiliser un fichier verrou au
démarrage du serveur lorsque MDStoreDir
est synchronisé avec la configuration du serveur et si les
certificats renouvelés sont activés.
Le verrouillage a été implémenté pour les configurations de cluster où MDStoreDir appartient à un système de fichiers partagé. L'activation des certificats renouvelés sera alors protégée lorsque plusieurs noeuds du cluster sont redémarrés ou reconfigurés simultanément ; ceci à condition bien entendu que le système de fichiers partagé prenne en charge le verrouillage de fichier.
Le temps d'attente par défaut pour obtenir le verrou est de 5 secondes. Si le verrou ne peut pas être obtenu, une erreur est enregistrée dans le journal et le démarrage du serveur se poursuit ; de ce fait, un des noeuds du cluster pourra encore utiliser les anciens certificats par la suite.
Un délai d'attente plus long réduira cette probabilité, mais pourra aussi retarder les redémarrages et reconfigurations du serveur dans le cas où les verrous ne sont pas correctement gérés dans le système de fichiers sous-jacent. Un verrou ne doit être maintenu par une instance de httpd que pendant une courte durée.
| Description: | Définit la fenêtre de temps pendant laquelle vous serez informé de l'expiration prochaine d'un certificat. |
|---|---|
| Syntaxe: | MDWarnWindow duration |
| Défaut: | MDWarnWindow 10% |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_md |
Voir la directive MDRenewWindow pour une description
de la méthode à employer pour spécifier cette durée.
Le module inspecte la durée de vie restante des certificats et
invoque MDMessageCmd
lorsqu'une de ces durées devient inférieure à la fenêtre de
temps spécifiée. Si l'on conserve la valeur par défaut, cette
durée correspond à 9 jours pour les certificats de Let's
Encrypt.
Cette directive s'applique aussi aux domaines gérés via des
fichiers de certificats statiques (voir la directive MDCertificateFile).
Apache HTTP Server Version 2.4
| Beschreibung: | Das Multi-Processing-Modul ist optimiert für Windows NT. |
|---|---|
| Status: | MPM |
| Modulbezeichner: | mpm_winnt_module |
| Quelltext-Datei: | mpm_winnt.c |
Dieses Multi-Processing-Modul (MPM) ist die Voreinstellung für das Betriebssystem Windows NT. Es verwendet einen einzelnen Steuerprozess, der einen einzelnen Kindprozess startet, welcher wiederum Threads zur Bedienung von Anfragen erstellt.
Serveur HTTP Apache Version 2.4
| Description: | Chiffrement de haut niveau basé sur les protocoles Secure Sockets Layer (SSL) et Transport Layer Security (TLS) |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | ssl_module |
| Fichier Source: | mod_ssl.c |
Ce module fournit le support SSL v3 et TLS v1 au serveur HTTP Apache. SSL v2 n'est plus supporté.
Ce module s'appuie sur OpenSSL pour fournir le moteur de chiffrement.
D'autres détails, discussions et exemples sont fournis dans la documentation SSL.
Variables d'environnement Formats de journaux
personnalisés Information à propos de la requête Extension pour l'interprétation
des expressions Fournisseurs d'autorisation
disponibles avec Require SSLCACertificateFile SSLCACertificatePath SSLCADNRequestFile SSLCADNRequestPath SSLCARevocationCheck SSLCARevocationFile SSLCARevocationPath SSLCertificateChainFile SSLCertificateFile SSLCertificateKeyFile SSLCipherSuite SSLCompression SSLCryptoDevice SSLEngine SSLFIPS SSLHonorCipherOrder SSLInsecureRenegotiation SSLOCSPDefaultResponder SSLOCSPEnable SSLOCSPNoverify SSLOCSPOverrideResponder SSLOCSPProxyURL SSLOCSPResponderCertificateFile SSLOCSPResponderTimeout SSLOCSPResponseMaxAge SSLOCSPResponseTimeSkew SSLOCSPUseRequestNonce SSLOpenSSLConfCmd SSLOptions SSLPassPhraseDialog SSLProtocol SSLProxyCACertificateFile SSLProxyCACertificatePath SSLProxyCARevocationCheck SSLProxyCARevocationFile SSLProxyCARevocationPath SSLProxyCheckPeerCN SSLProxyCheckPeerExpire SSLProxyCheckPeerName SSLProxyCipherSuite SSLProxyEngine SSLProxyMachineCertificateChainFile SSLProxyMachineCertificateFile SSLProxyMachineCertificatePath SSLProxyProtocol SSLProxyVerify SSLProxyVerifyDepth SSLRandomSeed SSLRenegBufferSize SSLRequire SSLRequireSSL SSLSessionCache SSLSessionCacheTimeout SSLSessionTicketKeyFile SSLSessionTickets SSLSRPUnknownUserSeed SSLSRPVerifierFile SSLStaplingCache SSLStaplingErrorCacheTimeout SSLStaplingFakeTryLater SSLStaplingForceURL SSLStaplingResponderTimeout SSLStaplingResponseMaxAge SSLStaplingResponseTimeSkew SSLStaplingReturnResponderErrors SSLStaplingStandardCacheTimeout SSLStrictSNIVHostCheck SSLUserName SSLUseStapling SSLVerifyClient SSLVerifyDepthCe module peut être configuré pour fournir aux espaces de nommage SSI
et CGI de nombreux éléments d'informations concernant SSL par le biais
de variables d'environnement supplémentaires. Par défaut, sauf pour
HTTPS et SSL_TLS_SNI qui sont toujours définies, ces
informations ne sont pas fournies pour des raisons de performances (Voir
la directive SSLOptions
StdEnvVars ci-dessous).
Les variables générées se trouvent dans la table ci-dessous.
Ces informations peuvent également être disponible sous des noms différents
à des fins de compatibilité ascendante. Reportez-vous au chapitre Compatibilité pour plus de détails à
propos des variables de compatibilité.
| Nom de la variable | Type de valeur | Description |
|---|---|---|
HTTPS | drapeau | HTTPS est utilisé. |
SSL_PROTOCOL | chaîne | La version du protocole SSL (SSLv3, TLSv1, TLSv1.1, TLSv1.2) |
SSL_SESSION_ID | chaîne | L'identifiant de session SSL codé en hexadécimal |
SSL_SESSION_RESUMED | chaîne | Session SSL initiale ou reprise. Note : plusieurs requêtes peuvent être servies dans le cadre de la même session SSL (initiale ou reprise) si les connexions persistantes (HTTP KeepAlive) sont utilisées |
SSL_SECURE_RENEG | chaîne | true si la renégociation sécurisée est supportée,
false dans le cas contraire |
SSL_CIPHER | chaîne | Le nom de l'algorithme de chiffrement |
SSL_CIPHER_EXPORT | chaîne | true si l'algorithme de chiffrement est un algorithme
exporté |
SSL_CIPHER_USEKEYSIZE | nombre | Nombre de bits de chiffrement (réellement utilisés) |
SSL_CIPHER_ALGKEYSIZE | nombre | Nombre de bits de chiffrement (possible) |
SSL_COMPRESS_METHOD | chaîne | Méthode de compression SSL négociée |
SSL_VERSION_INTERFACE | chaîne | La version du programme mod_ssl |
SSL_VERSION_LIBRARY | chaîne | La version du programme OpenSSL |
SSL_CLIENT_M_VERSION | chaîne | La version du certificat client |
SSL_CLIENT_M_SERIAL | chaîne | Le numéro de série du certificat client |
SSL_CLIENT_S_DN | chaîne | Le DN sujet du certificat client |
SSL_CLIENT_S_DN_x509 | chaîne | Elément du DN sujet du client |
SSL_CLIENT_SAN_Email_n | chaîne | Les entrées d'extension subjectAltName du certificat client de type rfc822Name |
SSL_CLIENT_SAN_DNS_n | chaîne | Les entrées d'extension subjectAltName du certificat client de type dNSName |
SSL_CLIENT_SAN_OTHER_msUPN_n |
chaîne | Extensions subjectAltName de type otherName du certificat client, forme Microsoft du nom principal de l'utilisateur (OID 1.3.6.1.4.1.311.20.2.3) |
SSL_CLIENT_I_DN | chaîne | DN de l'émetteur du certificat du client |
SSL_CLIENT_I_DN_x509 | chaîne | Elément du DN de l'émetteur du certificat du client |
SSL_CLIENT_V_START | chaîne | Validité du certificat du client (date de début) |
SSL_CLIENT_V_END | chaîne | Validité du certificat du client (date de fin) |
SSL_CLIENT_V_REMAIN | chaîne | Nombre de jours avant expiration du certificat du client |
SSL_CLIENT_A_SIG | chaîne | Algorithme utilisé pour la signature du certificat du client |
SSL_CLIENT_A_KEY | chaîne | Algorithme utilisé pour la clé publique du certificat du client |
SSL_CLIENT_CERT | chaîne | Certificat du client au format PEM |
SSL_CLIENT_CERT_CHAIN_n |
chaîne | Certificats de la chaîne de certification du client au format PEM |
SSL_CLIENT_CERT_RFC4523_CEA | chaîne | Numéro de série et fournisseur du certificat. le format correspond à celui de la CertificateExactAssertion dans la RFC4523 |
SSL_CLIENT_VERIFY | chaîne | NONE, SUCCESS, GENEROUS ou
FAILED:raison |
SSL_SERVER_M_VERSION | chaîne | La version du certificat du serveur |
SSL_SERVER_M_SERIAL | chaîne | The serial of the server certificate |
SSL_SERVER_S_DN | chaîne | DN sujet du certificat du serveur |
SSL_SERVER_S_DN_x509 | chaîne | Elément du DN sujet du certificat du serveur |
SSL_SERVER_SAN_Email_n |
chaîne | Les entrées d'extension subjectAltName du certificat de serveur de type rfc822Name |
SSL_SERVER_SAN_DNS_n | chaîne | Les entrées d'extension subjectAltName du certificat de serveur de type dNSName |
SSL_SERVER_SAN_OTHER_dnsSRV_n |
chaîne | Extensions subjectAltName de type otherName du certificat serveur, sous la forme SRVName (OID 1.3.6.1.5.5.7.8.7, RFC 4985) |
SSL_SERVER_I_DN | chaîne | DN de l'émetteur du certificat du serveur |
SSL_SERVER_I_DN_x509 | chaîne | Elément du DN de l'émetteur du certificat du serveur |
SSL_SERVER_V_START | chaîne | Validité du certificat du serveur (date de dédut) |
SSL_SERVER_V_END | chaîne | Validité du certificat du serveur (date de fin) |
SSL_SERVER_A_SIG | chaîne | Algorithme utilisé pour la signature du certificat du serveur |
SSL_SERVER_A_KEY | chaîne | Algorithme utilisé pour la clé publique du certificat du serveur |
SSL_SERVER_CERT | chaîne | Certificat du serveur au format PEM |
SSL_SRP_USER | chaîne | nom d'utilisateur SRP |
SSL_SRP_USERINFO | chaîne | informations sur l'utilisateur SRP |
SSL_TLS_SNI | string | Contenu de l'extension SNI TLS (si supporté par ClientHello) |
x509 spécifie un élément de DN X.509 parmi
C,ST,L,O,OU,CN,T,I,G,S,D,UID,Email. A partir de la version
2.2.0 d'Apache, x509 peut aussi comporter un suffixe numérique
_n. Si le DN en question comporte plusieurs attributs de
noms identiques, ce suffixe constitue un index débutant à zéro et
permettant de sélectionner un
attribut particulier. Par exemple, si le DN sujet du certificat du
serveur comporte deux champs OU, on peut utiliser
SSL_SERVER_S_DN_OU_0 et SSL_SERVER_S_DN_OU_1
pour référencer chacun d'entre eux. Un nom de variable sans suffixe
_n est équivalent au même nom avec le suffixe
_0, ce qui correspond au premier attribut (ou au seul)
caractérisant le DN.
Lorsque la table d'environnement est remplie en utilisant l'option
StdEnvVars de la directive SSLOptions, le premier attribut (ou le
seul) caractérisant le DN est enregistré avec un nom sans suffixe ;
autrement dit, aucune entrée possédant comme suffixe _0
n'est enregistrée.
A partir de la version 2.4.32 de httpd, on peut ajouter le suffixe
_RAW à x509 dans un composant DN afin d'empêcher la conversion
de la valeur de l'attribut en UTF-8. Il doit être placé après le suffixe index
(s'il existe). On utilisera par exemple SSL_SERVER_S_DN_OU_RAW ou
SSL_SERVER_S_DN_OU_0_RAW.
Le format des variables *_DN a changé depuis la version
2.3.11 d'Apache HTTPD. Voir l'option LegacyDNStringFormat
de la directive SSLOptions pour
plus de détails.
SSL_CLIENT_V_REMAIN n'est disponible qu'à partir de la
version 2.1.
Plusieurs variables d'environnement additionnelles peuvent être
utilisées dans les expressions SSLRequire, ou
dans les formats de journalisation personnalisés :
HTTP_USER_AGENT PATH_INFO AUTH_TYPE HTTP_REFERER QUERY_STRING SERVER_SOFTWARE HTTP_COOKIE REMOTE_HOST API_VERSION HTTP_FORWARDED REMOTE_IDENT TIME_YEAR HTTP_HOST IS_SUBREQ TIME_MON HTTP_PROXY_CONNECTION DOCUMENT_ROOT TIME_DAY HTTP_ACCEPT SERVER_ADMIN TIME_HOUR THE_REQUEST SERVER_NAME TIME_MIN REQUEST_FILENAME SERVER_PORT TIME_SEC REQUEST_METHOD SERVER_PROTOCOL TIME_WDAY REQUEST_SCHEME REMOTE_ADDR TIME REQUEST_URI REMOTE_USER
Dans ces contextes, deux formats spéciaux peuvent aussi être utilisés :
ENV:nom_variableHTTP:nom_en-têteLorsque mod_ssl est compilé dans le serveur Apache
ou même chargé (en mode DSO), des fonctions supplémentaires sont
disponibles pour le Format de journal personnalisé du
module mod_log_config. A ce titre, la fonction de
format d'eXtension ``%{nom-var}x''
peut être utilisée pour présenter en extension toute variable fournie
par tout module, et en particulier celles fournies par mod_ssl et que
vous trouverez dans la table ci-dessus.
A des fins de compatibilité ascendante, il existe une fonction de format
cryptographique supplémentaire
``%{nom}c''. Vous trouverez toutes
les informations à propos de cette fonction dans le chapitre Compatibilité.
CustomLog "logs/ssl_request_log" "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
Ces formats sont disponibles même si l'option StdEnvVars de la
directive SSLOptions n'a pas été
définie.
mod_ssl enregistre des informations à propos de la
requête que l'on peut restituer dans les journaux avec la chaîne de
format %{nom}n via le module
mod_log_config.
Les informations enregistrées sont les suivantes :
ssl-access-forbidden1 si l'accès a
été refusé suite à une directive SSLRequire ou
SSLRequireSSL.ssl-secure-renegmod_ssl a été compilé avec une version
d'OpenSSL qui supporte la renégociation sécurisée, si SSL est utilisé
pour la connexion courante et si le client supporte lui aussi la
renégociation sécurisée, cette information contiendra la valeur
1. Si le client ne supporte pas la renégociation
sécurisée, l'information contiendra la valeur 0. Si
mod_ssl n'a pas été compilé avec une version
d'OpenSSL qui supporte la renégociation sécurisée, ou si SSL n'est pas
utilisé pour la connexion courante, le contenu de l'information ne
sera pas défini.Lorsque mod_ssl est compilé statiquement avec
Apache, ou même chargé dynamiquement (en tant que module DSO), toute variable en provenance de mod_ssl peut
être utilisée pour l'interprétation des
expression ap_expr. Les variables peuvent être référencées en
utilisant la syntaxe ``%{varname}''.
A partir de la version 2.4.18, on peut aussi utiliser la syntaxe de
style mod_rewrite
``%{SSL:varname}'', ou la syntaxe de
style fonction ``ssl(varname)''.
mod_headers)Header set X-SSL-PROTOCOL "expr=%{SSL_PROTOCOL}"
Header set X-SSL-CIPHER "expr=%{SSL:SSL_CIPHER}"
Cette fonctionnalité est disponible même si l'option
StdEnvVars de la directive SSLOptions n'a pas été définie.
mod_ssl propose quelques fournisseurs
d'autorisation à utiliser avec la directive Require du module
mod_authz_core.
Le fournisseur ssl refuse l'accès si une connexion
n'est pas chiffrée avec SSL. L'effet est similaire à celui de la
directive SSLRequireSSL.
Require ssl
Le fournisseur ssl autorise l'accès si
l'utilisateur est authentifié via un certificat client valide. Ceci
n'a un effet que si SSLVerifyClient optional est actif.
Dans l'exemple suivant, l'accès est autorisé si le client est authentifié via un certificat client ou par nom d'utilisateur/mot de passe :
Require ssl-verify-client Require valid-user
| Description: | Fichier contenant une concaténation des certificats de CA codés en PEM pour l'authentification des clients |
|---|---|
| Syntaxe: | SSLCACertificateFile file-path |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet de définir le fichier tout-en-un où vous
pouvez rassembler les certificats des Autorités de Certification (CAs)
pour les clients auxquels vous avez à faire. On les utilise pour
l'authentification des clients. Un tel fichier contient la simple
concaténation des différents fichiers de certificats codés en PEM, par
ordre de préférence. Cette directive peut être utilisée à la place et/ou
en complément de la directive SSLCACertificatePath.
SSLCACertificateFile "/usr/local/apache2/conf/ssl.crt/ca-bundle-client.crt"
| Description: | Répertoire des certificats de CA codés en PEM pour l'authentification des clients |
|---|---|
| Syntaxe: | SSLCACertificatePath chemin-répertoire |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet de définir le répertoire où sont stockés les certificats des Autorités de Certification (CAs) pour les clients auxquels vous avez à faire. On les utilise pour vérifier le certificat du client au cours de l'authentification de ce dernier.
Les fichiers de ce répertoire doivent être codés en PEM et ils sont
accédés via des noms de fichier sous forme de condensés ou hash. Il ne
suffit donc pas de placer les fichiers de certificats dans ce répertoire
: vous devez aussi créer des liens symboliques nommés
valeur-de-hashage.N, et vous devez toujours vous
assurer que ce répertoire contient les liens symboliques appropriés.
SSLCACertificatePath "/usr/local/apache2/conf/ssl.crt/"
| Description: | Fichier contenant la concaténation des certificats de CA codés en PEM pour la définition de noms de CA acceptables |
|---|---|
| Syntaxe: | SSLCADNRequestFile file-path |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Lorsque mod_ssl demande un certificat client, une liste de noms d'Autorités de Certification acceptables est envoyée au client au cours de la phase d'initialisation de la connexion SSL. Le client peut alors utiliser cette liste de noms de CA pour sélectionner un certificat client approprié parmi ceux dont il dispose.
Si aucune des directives SSLCADNRequestPath ou SSLCADNRequestFile n'est définie, la liste
de noms de CsA acceptables envoyée au client est la liste des noms de
tous les certificats de CA spécifiés par les directives SSLCACertificateFile et SSLCACertificatePath ; en d'autres termes,
c'est la liste des noms de CAs qui sera effectivement utilisée pour
vérifier le certificat du client.
Dans certaines situations, il est utile de pouvoir envoyer
une liste de noms de CA acceptables qui diffère de la liste des CAs
effectivement utilisés pour vérifier le certificat du client ;
considérons par exemple le cas où le certificat du client est signé par
des CAs intermédiaires. On peut ici utiliser les directives SSLCADNRequestPath et/ou SSLCADNRequestFile, et les noms de CA
acceptables seront alors extraits de l'ensemble des certificats contenus
dans le répertoire et/ou le fichier définis par cette paire de
directives.
SSLCADNRequestFile doit
spécifier un fichier tout-en-un contenant une concaténation des
certificats de CA codés en PEM.
SSLCADNRequestFile "/usr/local/apache2/conf/ca-names.crt"
| Description: | Répertoire contenant des fichiers de certificats de CA codés en PEM pour la définition de noms de CA acceptables |
|---|---|
| Syntaxe: | SSLCADNRequestPath chemin-répertoire |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive optionnelle permet de définir la liste de noms de
CAs acceptables qui sera envoyée au client lorsqu'un certificat de
client est demandé. Voir la directive SSLCADNRequestFile pour plus de
détails.
Les fichiers de ce répertoire doivent être codés en PEM et ils sont
accédés via des noms de fichier sous forme de condensés ou hash. Il ne
suffit donc pas de placer les fichiers de certificats dans ce répertoire
: vous devez aussi créer des liens symboliques nommés
valeur-de-hashage.N, et vous devez toujours vous
assurer que ce répertoire contient les liens symboliques appropriés.
SSLCADNRequestPath "/usr/local/apache2/conf/ca-names.crt/"
| Description: | Active la vérification des révocations basée sur les CRL |
|---|---|
| Syntaxe: | SSLCARevocationCheck chain|leaf|none [flags ...] |
| Défaut: | SSLCARevocationCheck none |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le drapeau optionnel flags est disponible à partir de la version 2.4.21 du serveur HTTP Apache |
Active la vérification des révocations basée sur les Listes de
Révocations de Certificats (CRL). Au moins une des directives SSLCARevocationFile ou SSLCARevocationPath doit être définie.
Lorsque cette directive est définie à chain (valeur
recommandée), les vérifications CRL sont effectuées sur tous les
certificats de la chaîne, alors que la valeur leaf limite
la vérification au certificat hors chaîne (la feuille).
flags peut prendre comme valeurs
no_crl_for_cert_ok
Avant la version 2.3.15, les vérifications CRL dans mod_ssl
réussissaient même si aucune CRL n'était trouvée dans les chemins
définis par les directives SSLCARevocationFile ou SSLCARevocationPath.
Le comportement a
changé avec l'introduction de la directive
SSLCARevocationFile : par défaut avec
chain ou leaf, les CRLs doivent être présentes pour que la
validation réussisse ; dans le cas contraire, elle échouera avec une
erreur "unable to get certificate CRL".
La valeur no_crl_for_cert_ok du drapeau flag permet de
retrouver le comportement précédent.
SSLCARevocationCheck chain
SSLCARevocationCheck chain no_crl_for_cert_ok
| Description: | Fichier contenant la concaténation des CRLs des CA codés en PEM pour l'authentification des clients |
|---|---|
| Syntaxe: | SSLCARevocationFile file-path |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet de définir le fichier tout-en-un où sont
rassemblées les Listes de Révocation de Certificats (CRLs) des Autorités
de certification (CAs) pour les clients auxquels vous avez à faire. On
les utilise pour l'authentification des clients. Un tel fichier contient
la simple concaténation des différents fichiers de CRLs codés en PEM,
dans l'ordre de préférence. Cette directive peut être utilisée à la
place et/ou en complément de la directive SSLCARevocationPath.
SSLCARevocationFile "/usr/local/apache2/conf/ssl.crl/ca-bundle-client.crl"
| Description: | Répertoire des CRLs de CA codés en PEM pour l'authentification des clients |
|---|---|
| Syntaxe: | SSLCARevocationPath chemin-répertoire |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet de définir le répertoire où sont stockées les Listes de Révocation de Certificats (CRL) des Autorités de Certification (CAs) pour les clients auxquels vous avez à faire. On les utilise pour révoquer les certificats des clients au cours de l'authentification de ces derniers.
Les fichiers de ce répertoire doivent être codés en PEM et ils sont
accédés via des noms de fichier sous forme de condensés ou hash. Il ne
suffit donc pas de placer les fichiers de CRL dans ce répertoire
: vous devez aussi créer des liens symboliques nommés
valeur-de-hashage.N, et vous devez toujours vous
assurer que ce répertoire contient les liens symboliques appropriés.
SSLCARevocationPath "/usr/local/apache2/conf/ssl.crl/"
| Description: | Fichier contenant les certificats de CA du serveur codés en PEM |
|---|---|
| Syntaxe: | SSLCertificateChainFile file-path |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
SSLCertificateChainFile est devenue obsolète avec la
version 2.4.8, lorsque la directive
SSLCertificateFile a été étendue
pour supporter aussi les certificats de CA intermédiaires dans le
fichier de certificats du serveur.
Cette directive permet de définir le fichier optionnel tout-en-un où vous pouvez rassembler les certificats des Autorités de Certification (CA) qui forment la chaîne de certification du certificat du serveur. Cette chaîne débute par le certificat de la CA qui a délivré le certificat du serveur et peut remonter jusqu'au certificat de la CA racine. Un tel fichier contient la simple concaténation des différents certificats de CA codés en PEM, en général dans l'ordre de la chaîne de certification.
Elle doit être utilisée à la place et/ou en complément de la
directive SSLCACertificatePath
pour construire explicitement la chaîne de certification du serveur qui
est envoyée au navigateur en plus du certificat du serveur. Elle s'avère
particulièrement utile pour éviter les conflits avec les certificats de
CA lorsqu'on utilise l'authentification du client. Comme le fait de
placer un certificat de CA de la chaîne de certification du serveur dans
la directive SSLCACertificatePath produit le même effet
pour la construction de la chaîne de certification, cette directive a
pour effet colatéral de faire accepter les certificats clients fournis
par cette même CA, au cours de l'authentification du client.
Soyez cependant prudent : fournir la chaîne de certification ne fonctionne que si vous utilisez un simple certificat de serveur RSA ou DSA. Si vous utilisez une paire de certificats couplés RSA+DSA , cela ne fonctionnera que si les deux certificats utilisent vraiment la même chaîne de certification. Dans le cas contraire, la confusion risque de s'installer au niveau des navigateurs.
SSLCertificateChainFile "/usr/local/apache2/conf/ssl.crt/ca.crt"
| Description: | Fichier de données contenant les informations de certificat X.509 du serveur codées au format PEM ou identificateur de jeton |
|---|---|
| Syntaxe: | SSLCertificateFile file-path|certid |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | L'option certid est disponible à partir de la version 2.4.42 du serveur HTTP Apache. |
Cette directive permet de définir le fichier de données contenant les
informations de certificat X.509 du serveur codées au format PEM ou
l'identificateur de certificat via un jeton cryptographique. Si on utilise un
fichier au format PEM, ce dernier doit contenir au minimum un certificat
d'entité finale (feuille).
La directive peut être utilisée plusieurs fois (elle référence des
fichiers différents) pour accepter plusieurs algorithmes
d'authentification au niveau du serveur - souvent RSA, DSA et ECC. Le
nombre d'algorithmes supportés dépend de la version d'OpenSSL utilisée
avec mod_ssl : à partir de la version 1.0.0, la commande openssl
list-public-key-algorithms affiche la liste des algorithmes
supportés. Voir aussi la note ci-dessous à propos des limitations des versions
d'OpenSSL antérieures à 1.0.2 et la manière de les contourner.
Les fichiers peuvent aussi contenir des certificats de CA
intermédiaires triés depuis la feuille vers la racine. Cette
fonctionnalité est disponible depuis la version 2.4.8 du serveur HTTP
Apache, et rend obsolète la directive SSLCertificateChainFile. A partir de la
version 1.0.2 d'OpenSSL, il est alors possible de configurer la chaîne
de certification en fonction du certificat.
Depuis la version 2.4.7 du serveur HTTP Apache, on peut aussi ajouter
des paramètres DH personnalisés et un nom EC
curve pour les clés éphémères à la fin du premier fichier défini par la
directive SSLCertificateFile.
Ces paramètres peuvent être générés avec les commandes openssl
dhparam et openssl ecparam, et ils peuvent être
ajoutés tel quel à la fin du premier fichier de certificat. En effet,
seul le premier fichier de certificat défini peut être utilisé pour
enregistrer des paramètres personnalisés, car ces derniers s'appliquent
indépendamment de l'algorithme d'authentification utilisé.
Enfin, il est aussi possible d'ajouter la clé privée du certificat de
l'entité finale au fichier de certificat, ce qui permet de se passer
d'une directive SSLCertificateKeyFile séparée. Cette
pratique est cependant fortement déconseillée. Dans ce cas, les fichiers de
certificat qui contiennent de telles clés embarquées doivent être définis
après les certificats qui utilisent un fichier de clé séparé. En outre,
si la clé est chiffrée, une boîte de dialogue pour entrer le mot de
passe de la clé s'ouvre au démarrage du serveur.
Plutôt que de stocker les certificats et les clés privées dans des fichiers,
on peut utiliser un identificateur de certificat pour identifier un certificat
stocké dans un jeton. Actuellement, seuls les URIs PKCS#11 sont reconnus comme
identificateurs de certificats et peuvent être utilisés en conjonction avec le
moteur ou le fournisseur OpenSSL pkcs11. Si la directive SSLCertificateKeyFile est absente, le certificat et
la clé privée peuvent être chargés avec l'identificateur spécifié via la
directive SSLCertificateFile.
Depuis la version 2.4.7, mod_ssl utilise des paramètres DH standardisés avec des nombres premiers de 2048, 3072 et 4096 bits, et avec des nombres premiers de 6144 et 8192 bits depuis la version 2.4.10 (voir RFC 3526), et les fournit aux clients en fonction de la longueur de la clé du certificat RSA/DSA. En particulier avec les clients basés sur Java (versions 7 et antérieures), ceci peut provoquer des erreurs au cours de la négociation - voir cette réponse de la FAQ SSL pour contourner les problèmes de ce genre.
Lorsqu'on utilise plusieurs certificats pour supporter différents algorithmes
d'authentification (comme RSA, DSA, mais principalement ECC) et une
version d'OpenSSL antérieure à 1.0.2, il est recommandé soit d'utiliser des
paramètres DH spécifiques (solution à privilégier) en les ajoutant au premier
fichier certificat (comme décrit ci-dessus), soit d'ordonner les directives
SSLCertificateFile de façon à ce que les certificats
RSA/DSA soit placés après les certificats ECC.
Cette limitation est présente dans les anciennes versions d'OpenSSL qui présentent toujours le dernier certificat configuré, au lieu de laisser le serveur HTTP Apache déterminer le certificat sélectionné lors de la phase de négociation de la connexion (lorsque les paramètres DH doivent être envoyés à l'hôte distant). De ce fait, le serveur peut sélectionner des paramètres DH par défaut basés sur la longueur de la clé du mauvais certificat (les clés ECC sont beaucoup plus petites que les clés RSA/DSA et leur longueur n'est pas pertinente pour la sélection des nombres premiers DH).
Ce problème peut être résolu en créant et configurant des paramètres DH spécifiques (comme décrit ci-dessus), car ils l'emportent toujours sur les paramètres DH par défaut, et vous pourrez ainsi utiliser une longueur spécifique et appropriée.
# Exemple utilisant un fichier codé en PEM. SSLCertificateFile "/usr/local/apache2/conf/ssl.crt/server.crt" # Exemple d'utilisation d'un certificat et d'une clé privés issus d'un jeton # PKCS#11 : SSLCertificateFile "pkcs11:token=My%20Token%20Name;id=45"
| Description: | Fichier contenant la clé privée du serveur codée en PEM |
|---|---|
| Syntaxe: | SSLCertificateKeyFile file-path|keyid |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | keyid est disponible à partir de la version 2.4.42 du serveur HTTP Apache. |
Cette directive permet de définir le fichier contenant la clé privée du serveur codée en PEM ou l'identifiant de la clé via un jeton cryptographique défini. Si la clé privée est chiffrée, une boîte de dialogue demandant le mot de passe de cette dernière s'ouvre au démarrage du serveur.
Cette directive peut être utilisée plusieurs fois pour référencer
différents noms de fichiers, afin de supporter plusieurs algorithmes
pour l'authentification du serveur. A chaque directive SSLCertificateKeyFile doit être associée
une directive SSLCertificateFile correspondante.
La clé privée peut aussi être ajoutée au fichier défini par la directive
SSLCertificateFile, mais cette
pratique est fortement déconseillée. Dans ce cas, les fichiers de
certificats qui comportent une telle clé doivent être définis après les
certificats qui utilisent un fichier de clé séparé.
Plutôt que de stocker des clés privées dans des fichiers, il est possible
d'identifier une clé privée via un identifiant stocké dans un jeton.
Actuellement, seuls les PKCS#11
URIs sont reconnus comme identifiants de clés privées et peuvent être
utilisés en conjonction avec le moteur ou le fournisseur OpenSSL
pkcs11.
# Pour utiliser une clé privée stockée dans fichier encodé PEM : SSLCertificateKeyFile "/usr/local/apache2/conf/ssl.key/server.key" # Pour utiliser une clé privée à partir d'un jeton PKCS#11 : SSLCertificateKeyFile "pkcs11:token=My%20Token%20Name;id=45"
| Description: | Algorithmes de chiffrement disponibles pour la négociation au cours de l'initialisation de la connexion SSL |
|---|---|
| Syntaxe: | SSLCipherSuite [protocol] cipher-spec |
| Défaut: | SSLCipherSuite DEFAULT (dépend de la version d'OpenSSL
installée) |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive complexe utilise la chaîne cipher-spec contenant la liste des algorithmes de chiffrement OpenSSL que le client peut utiliser au cours de la phase d'initialisation de la connexion SSL. La spécification optionnelle du protocole permet de configurer la suite d'algorithmes de chiffrement pour une version spécifique de SSL. Une des valeurs possibles est "SSL" pour toutes les versions du protocole SSL jusqu'à TLSv1.2 compris.
Notez que cette directive peut être utilisée aussi bien dans un contexte de serveur que dans un contexte de répertoire. Dans un contexte de serveur, elle s'applique à l'initialisation SSL standard lorsqu'une connexion est établie. Dans un contexte de répertoire, elle force une renégociation SSL avec la liste d'algorithmes de chiffrement spécifiée après la lecture d'une requête HTTP, mais avant l'envoi de la réponse HTTP.
Si la bibliothèque SSL supporte TLSv1.3 (versions d'OpenSSL 1.1.1 et supérieures), il est possible de spécifier le paramètre "TLSv1.3" pour configurer la suite d'algorithmes de chiffrement pour ce protocole. Comme TLSv1.3 n'autorise pas la renégociation, spécifier pour lui des algorithmes de chiffrement dans un contexte de répertoire n'est pas autorisé
Pour obtenir la liste des noms d'algorithmes de chiffrement pour TLSv1.3, se référer à la documentation OpenSSL.
La liste d'algorithmes de chiffrement SSL spécifiée par l'argument cipher-spec comporte quatre attributs principaux auxquels s'ajoutent quelques attributs secondaires :
L'algorithme de chiffrement peut aussi provenir de l'extérieur. Les algorithmes SSLv2 ne sont plus supportés. Pour définir les algorithmes à utiliser, on peut soit spécifier tous les algorithmes à la fois, soit utiliser des alias pour spécifier une liste d'algorithmes dans leur ordre de préférence (voir Table 1). Les algorithmes et alias effectivement disponibles dépendent de la version d'openssl utilisée. Les versions ultérieures d'openssl sont susceptibles d'inclure des algorithmes supplémentaires.
| Symbole | Description |
|---|---|
| Algorithme d'échange de clés : | |
kRSA | Echange de clés RSA |
kDHr | Echange de clés Diffie-Hellman avec clé RSA |
kDHd | Echange de clés Diffie-Hellman avec clé DSA |
kEDH | Echange de clés Diffie-Hellman temporaires (pas de certificat) |
kSRP | échange de clés avec mot de passe distant sécurisé (SRP) |
| Algorithmes d'authentification : | |
aNULL | Pas d'authentification |
aRSA | Authentification RSA |
aDSS | Authentification DSS |
aDH | Authentification Diffie-Hellman |
| Algorithmes de chiffrement : | |
eNULL | Pas de chiffrement |
NULL | alias pour eNULL |
AES | Chiffrement AES |
DES | Chiffrement DES |
3DES | Chiffrement Triple-DES |
RC4 | Chiffrement RC4 |
RC2 | Chiffrement RC2 |
IDEA | Chiffrement IDEA |
| Algorithmes de condensés MAC : | |
MD5 | Fonction de hashage MD5 |
SHA1 | Fonction de hashage SHA1 |
SHA | alias pour SHA1 |
SHA256 | Fonction de hashage SHA256 |
SHA384 | Fonction de hashage SHA384 |
| Alias : | |
SSLv3 | tous les algorithmes de chiffrement SSL version 3.0 |
TLSv1 | tous les algorithmes de chiffrement TLS version 1.0 |
EXP | tous les algorithmes de chiffrement externes |
EXPORT40 | tous les algorithmes de chiffrement externes limités à 40 bits |
EXPORT56 | tous les algorithmes de chiffrement externes limités à 56 bits |
LOW | tous les algorithmes de chiffrement faibles (non externes, DES simple) |
MEDIUM | tous les algorithmes avec chiffrement 128 bits |
HIGH | tous les algorithmes utilisant Triple-DES |
RSA | tous les algorithmes utilisant l'échange de clés RSA |
DH | tous les algorithmes utilisant l'échange de clés Diffie-Hellman |
EDH | tous les algorithmes utilisant l'échange de clés Diffie-Hellman temporaires |
ECDH | Echange de clés Elliptic Curve Diffie-Hellman |
ADH | tous les algorithmes utilisant l'échange de clés Diffie-Hellman anonymes |
AECDH | tous les algorithmes utilisant l'échange de clés Elliptic Curve Diffie-Hellman |
SRP | tous les algorithmes utilisant l'échange de clés avec mot de passe distant sécurisé (SRP) |
DSS | tous les algorithmes utilisant l'authentification DSS |
ECDSA | tous les algorithmes utilisant l'authentification ECDSA |
aNULL | tous les algorithmes n'utilisant aucune authentification |
Cela devient intéressant lorsque tous ces symboles sont combinés
ensemble pour spécifier les algorithmes disponibles et l'ordre dans
lequel vous voulez les utiliser. Pour simplifier tout cela, vous
disposez aussi d'alias (SSLv3, TLSv1, EXP, LOW, MEDIUM,
HIGH) pour certains groupes d'algorithmes. Ces symboles peuvent
être reliés par des préfixes pour former la chaîne algorithmes.
Les préfixes disponibles sont :
+: déplace les algorithmes qui conviennent à la
place courante dans la liste-: supprime l'algorithme de la liste (peut être rajouté
plus tard)!: supprime définitivement l'algorithme de la liste (ne
peut plus y être rajouté plus tard)aNULL, eNULL et
EXP sont toujours désactivésDepuis la version 2.4.7, les
algorithmes de type null ou destinés à l'exportation sont toujours
désactivés car mod_ssl ajoute obligatoirement
!aNULL:!eNULL:!EXP à toute chaîne d'algorithme de
chiffrement à l'initialisation.
Pour vous simplifier la vie, vous pouvez utiliser la commande
``openssl ciphers -v'' qui vous fournit un moyen simple de
créer la chaîne algorithmes avec succès. La chaîne
algorithmes par défaut dépend de la version des bibliothèques
SSL installées. Supposons qu'elle contienne
``RC4-SHA:AES128-SHA:HIGH:MEDIUM:!aNULL:!MD5'', ce qui
stipule de mettre RC4-SHA et AES128-SHA en
premiers, car ces algorithmes présentent un bon compromis entre vitesse
et sécurité. Viennent ensuite les algorithmes de sécurité élevée et
moyenne. En fin de compte, les algorithmes qui n'offrent aucune
authentification sont exclus, comme les algorithmes anonymes
Diffie-Hellman pour SSL, ainsi que tous les algorithmes qui utilisent
MD5 pour le hashage, car celui-ci est reconnu comme
insuffisant.
$ openssl ciphers -v 'RC4-SHA:AES128-SHA:HIGH:MEDIUM:!aNULL:!MD5' RC4-SHA SSLv3 Kx=RSA Au=RSA Enc=RC4(128) Mac=SHA1 AES128-SHA SSLv3 Kx=RSA Au=RSA Enc=AES(128) Mac=SHA1 DHE-RSA-AES256-SHA SSLv3 Kx=DH Au=RSA Enc=AES(256) Mac=SHA1 ... ... ... ... ... SEED-SHA SSLv3 Kx=RSA Au=RSA Enc=SEED(128) Mac=SHA1 PSK-RC4-SHA SSLv3 Kx=PSK Au=PSK Enc=RC4(128) Mac=SHA1 KRB5-RC4-SHA SSLv3 Kx=KRB5 Au=KRB5 Enc=RC4(128) Mac=SHA1
Vous trouverez la liste complète des algorithmes RSA & DH spécifiques à SSL dans la Table 2.
SSLCipherSuite RSA:!EXP:!NULL:+HIGH:+MEDIUM:-LOW
| Symbole algorithme | Protocole | Echange de clés | Authentification | Chiffrement | Condensé MAC | Type |
|---|---|---|---|---|---|---|
| Algorithmes RSA : | ||||||
DES-CBC3-SHA | SSLv3 | RSA | RSA | 3DES(168) | SHA1 | |
IDEA-CBC-SHA | SSLv3 | RSA | RSA | IDEA(128) | SHA1 | |
RC4-SHA | SSLv3 | RSA | RSA | RC4(128) | SHA1 | |
RC4-MD5 | SSLv3 | RSA | RSA | RC4(128) | MD5 | |
DES-CBC-SHA | SSLv3 | RSA | RSA | DES(56) | SHA1 | |
EXP-DES-CBC-SHA | SSLv3 | RSA(512) | RSA | DES(40) | SHA1 | export |
EXP-RC2-CBC-MD5 | SSLv3 | RSA(512) | RSA | RC2(40) | MD5 | export |
EXP-RC4-MD5 | SSLv3 | RSA(512) | RSA | RC4(40) | MD5 | export |
NULL-SHA | SSLv3 | RSA | RSA | None | SHA1 | |
NULL-MD5 | SSLv3 | RSA | RSA | None | MD5 | |
| Algorithmes Diffie-Hellman : | ||||||
ADH-DES-CBC3-SHA | SSLv3 | DH | None | 3DES(168) | SHA1 | |
ADH-DES-CBC-SHA | SSLv3 | DH | None | DES(56) | SHA1 | |
ADH-RC4-MD5 | SSLv3 | DH | None | RC4(128) | MD5 | |
EDH-RSA-DES-CBC3-SHA | SSLv3 | DH | RSA | 3DES(168) | SHA1 | |
EDH-DSS-DES-CBC3-SHA | SSLv3 | DH | DSS | 3DES(168) | SHA1 | |
EDH-RSA-DES-CBC-SHA | SSLv3 | DH | RSA | DES(56) | SHA1 | |
EDH-DSS-DES-CBC-SHA | SSLv3 | DH | DSS | DES(56) | SHA1 | |
EXP-EDH-RSA-DES-CBC-SHA | SSLv3 | DH(512) | RSA | DES(40) | SHA1 | export |
EXP-EDH-DSS-DES-CBC-SHA | SSLv3 | DH(512) | DSS | DES(40) | SHA1 | export |
EXP-ADH-DES-CBC-SHA | SSLv3 | DH(512) | None | DES(40) | SHA1 | export |
EXP-ADH-RC4-MD5 | SSLv3 | DH(512) | None | RC4(40) | MD5 | export |
| Description: | Permet d'activer la compression au niveau SSL |
|---|---|
| Syntaxe: | SSLCompression on|off |
| Défaut: | SSLCompression off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible à partir de la version 2.4.3 du serveur HTTP
Apache, si on utilise une version d'OpenSSL 0.9.8 ou supérieure ;
l'utilisation dans un contexte de serveur virtuel n'est disponible que
si on utilise une version d'OpenSSL 1.0.0 ou supérieure. La valeur par
défaut était on dans la version 2.4.3. |
Cette directive permet d'activer la compression au niveau SSL.
L'activation de la compression est à l'origine de problèmes de sécurité dans la plupart des configurations (l'attaque nommée CRIME).
| Description: | Active l'utilisation d'un accélérateur matériel de chiffrement |
|---|---|
| Syntaxe: | SSLCryptoDevice moteur |
| Défaut: | SSLCryptoDevice builtin |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet d'activer l'utilisation d'une carte accélératrice de chiffrement qui prendra en compte certaines parties du traitement relatif à SSL. Cette directive n'est utilisable que si la boîte à outils SSL à été compilée avec le support "engine" ; les versions 0.9.7 et supérieures d'OpenSSL possèdent par défaut le support "engine", alors qu'avec la version 0.9.6, il faut utiliser les distributions séparées "-engine".
Pour déterminer les moteurs supportés, exécutez la commande
"openssl engine".
# Pour un accélérateur Broadcom : SSLCryptoDevice ubsec
À partir de la version 3.0 d'OpenSSL, si aucun moteur n'est spécifié alors que la clé ou le certificat sont spécifiés à l'aide d'URIs PKCS#11, le chargement de la clé et du certificat est tenté à partir d'un fournisseur OpenSSL. Le fournisseur OpenSSL à utiliser doit être défini et configuré dans le fichier de configuration d'OpenSSL et il doit prendre en charge la méthode STORE pour les URIs PKCS#11.
| Description: | Interrupteur marche/arrêt du moteur SSL |
|---|---|
| Syntaxe: | SSLEngine on|off|optional |
| Défaut: | SSLEngine off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet d'activer/désactiver le moteur du protocole
SSL/TLS. Elle doit être utilisée dans une section <VirtualHost> pour activer
SSL/TLS pour ce serveur virtuel particulier. Par défaut, le moteur du
protocole SSL/TLS est désactivé pour le serveur principal et tous les
serveurs virtuels configurés.
<VirtualHost _default_:443> SSLEngine on #... </VirtualHost>
Depuis la version 2.1 d'Apache, la directive
SSLEngine peut être définie à
optional, ce qui active le support de RFC 2817, Upgrading to
TLS Within HTTP/1.1. Pour le moment, aucun navigateur web ne supporte
RFC 2817.
| Description: | Coimmutateur du mode SSL FIPS |
|---|---|
| Syntaxe: | SSLFIPS on|off |
| Défaut: | SSLFIPS off |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet d'activer/désactiver l'utilisation du drapeau FIPS_mode de la bibliothèque SSL. Elle doit être définie dans le contexte du serveur principal, et n'accepte pas les configurations sources de conflits (SSLFIPS on suivi de SSLFIPS off par exemple). Le mode s'applique à toutes les opérations de la bibliothèque SSL.
Si httpd a été compilé avec une bibliothèque SSL qui ne supporte pas le
drapeau FIPS_mode, la directive SSLFIPS on échouera.
Reportez-vous au document sur la politique de sécurité FIPS 140-2 de la
bibliothèque du fournisseur SSL, pour les prérequis spécifiques
nécessaires à l'utilisation de mod_ssl selon un mode d'opération
approuvé par FIPS 140-2 ; notez que mod_ssl en lui-même n'est pas
validé, mais peut être décrit comme utilisant un module de chiffrement
validé par FIPS 140-2, lorsque tous les composants sont assemblés et mis
en oeuvre selon les recommandations de la politique de sécurité
applicable.
| Description: | Option permettant de classer les algorithmes de chiffrement du serveur par ordre de préférence |
|---|---|
| Syntaxe: | SSLHonorCipherOrder on|off |
| Défaut: | SSLHonorCipherOrder off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Normalement, ce sont les préférences du client qui sont prises en compte lors du choix d'un algorithme de chiffrement au cours d'une négociation SSLv3 ou TLSv1. Si cette directive est activée, ce sont les préférences du serveur qui seront prises en compte à la place.
SSLHonorCipherOrder on
| Description: | Option permettant d'activer le support de la renégociation non sécurisée |
|---|---|
| Syntaxe: | SSLInsecureRenegotiation on|off |
| Défaut: | SSLInsecureRenegotiation off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible depuis httpd 2.2.15, si une version 0.9.8m ou supérieure d'OpenSSL est utilisée |
Comme il a été spécifié, toutes les versions des protocoles SSL et TLS (jusqu'à la version 1.2 de TLS incluse) étaient vulnérables à une attaque de type Man-in-the-Middle (CVE-2009-3555) au cours d'une renégociation. Cette vulnérabilité permettait à un attaquant de préfixer la requête HTTP (telle qu'elle était vue du serveur) avec un texte choisi. Une extension du protocole a été développée pour corriger cette vulnérabilité, sous réserve qu'elle soit supportée par le client et le serveur.
Si mod_ssl est lié à une version 0.9.8m ou
supérieure d'OpenSSL, par défaut, la renégociation n'est accordée qu'aux
clients qui supportent la nouvelle extension du protocole. Si
cette directive est activée, la renégociation sera accordée aux anciens
clients (non patchés), quoique de manière non sécurisée
Si cette directive est activée, les connexions SSL seront vulnérables aux attaques de type préfixe Man-in-the-Middle comme décrit dans CVE-2009-3555.
SSLInsecureRenegotiation on
La variable d'environnement SSL_SECURE_RENEG peut être
utilisée dans un script SSI ou CGI pour déterminer si la renégociation
sécurisée est supportée pour une connexion SSL donnée.
| Description: | Définit l'URI du répondeur par défaut pour la validation OCSP |
|---|---|
| Syntaxe: | SSLOCSPDefaultResponder uri |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet de définir le répondeur OCSP par défaut. Si la
directive SSLOCSPOverrideResponder n'est pas activée,
l'URI spécifié ne sera utilisé que si aucun URI de répondeur n'est
spécifié dans le certificat en cours de vérification.
| Description: | Active la validation OCSP de la chaîne de certificats du client |
|---|---|
| Syntaxe: | SSLOCSPEnable on|leaf|off |
| Défaut: | SSLOCSPEnable off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le mode leaf est disponible à partir de la version 2.4.34 du serveur HTTP Apache |
Cette directive permet d'activer la validation OCSP de la chaîne de certificats du client. Si elle est activée, les certificats de la chaîne de certificats du client seront validés auprès d'un répondeur OCSP, une fois la vérification normale effectuée (vérification des CRLs incluse). En mode 'leaf', seul le certificat du client sera validé.
Le répondeur OCSP utilisé est soit extrait du certificat lui-même,
soit spécifié dans la configuration ; voir les directives SSLOCSPDefaultResponder et SSLOCSPOverrideResponder.
SSLVerifyClient on SSLOCSPEnable on SSLOCSPDefaultResponder "http://responder.example.com:8888/responder" SSLOCSPOverrideResponder on
| Description: | Evite la vérification des certificats des répondeurs OCSP |
|---|---|
| Syntaxe: | SSLOCSPNoverify on|off |
| Défaut: | SSLOCSPNoverify off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible à partir de la version 2.4.26 du serveur HTTP Apache, sous réserve d'utiliser une version 0.9.7 ou supérieure d'OpenSSL |
Cette directive permet d'éviter la vérification des certificats des répondeurs OCSP, ce qui peut s'avérer utile lorsqu'on teste un serveur OCSP.
| Description: | Force l'utilisation de l'URI du répondeur par défaut pour la validation OCSP |
|---|---|
| Syntaxe: | SSLOCSPOverrideResponder on|off |
| Défaut: | SSLOCSPOverrideResponder off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Force l'utilisation, au cours d'une validation OCSP de certificat, du répondeur OCSP par défaut spécifié dans la configuration, que le certificat en cours de vérification fasse mention d'un répondeur OCSP ou non.
| Description: | Adresse de mandataire à utiliser pour les requêtes OCSP |
|---|---|
| Syntaxe: | SSLOCSPProxyURL url |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible à partir de la version 2.4.19 du serveur HTTP Apache |
Cette directive permet de définir l'URL d'un mandataire HTTP qui devra être utilisé pour toutes les requêtes vers un répondeur OCSP.
| Description: | Fournit un jeu de certificats de confiance du répondeur OCSP avec encodage PEM |
|---|---|
| Syntaxe: | SSLOCSPResponderCertificateFile file |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible à partir de la version 2.4.26 du serveur HTTP Apache, sous réserve d'utiliser une version 0.9.7 ou supérieure d'OpenSSL |
Cette directive permet de définir un fichier contenant une liste de certificats de confiance du répondeur OCSP à utiliser au cours de la validation du certificat du répondeur OCSP. Les certificats fournis peuvent être considérés comme de confiance sans avoir à effectuer de vérifications supplémentaires. Ce processus de validation du certificat du répondeur OCSP intervient en général lorsque ce dernier est autosigné ou tout simplement absent de la réponse OCSP.
| Description: | Délai d'attente pour les requêtes OCSP |
|---|---|
| Syntaxe: | SSLOCSPResponderTimeout secondes |
| Défaut: | SSLOCSPResponderTimeout 10 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Cette option permet de définir le délai d'attente pour les requêtes à
destination des répondeurs OCSP, lorsque la directive SSLOCSPEnable est à on.
| Description: | Age maximum autorisé pour les réponses OCSP |
|---|---|
| Syntaxe: | SSLOCSPResponseMaxAge secondes |
| Défaut: | SSLOCSPResponseMaxAge -1 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Cette option permet de définir l'âge maximum autorisé (la
"fraicheur") des réponses OCSP. La valeur par défault (-1)
signifie qu'aucun âge maximum n'est défini ; autrement dit, les
réponses OCSP sont considérées comme valides tant que la valeur de leur
champ nextUpdate se situe dans le futur.
| Description: | Dérive temporelle maximale autorisée pour la validation des réponses OCSP |
|---|---|
| Syntaxe: | SSLOCSPResponseTimeSkew secondes |
| Défaut: | SSLOCSPResponseTimeSkew 300 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Cette option permet de définir la dérive temporelle maximale
autorisée pour les réponses OCSP (lors de la vérification des champs
thisUpdate et nextUpdate).
| Description: | Use a nonce within OCSP queries |
|---|---|
| Syntaxe: | SSLOCSPUseRequestNonce on|off |
| Défaut: | SSLOCSPUseRequestNonce on |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Available in httpd 2.4.10 and later |
La documentation de cette directive n'a pas encore t traduite. Veuillez vous reporter la version en langue anglaise.
| Description: | Configuration des paramètres d'OpenSSL via son API SSL_CONF |
|---|---|
| Syntaxe: | SSLOpenSSLConfCmd commande valeur |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible depuis la version 2.4.8 du serveur HTTP Apache avec OpenSSL 1.0.2 ou supérieur |
Cette directive permet à mod_ssl d'accéder à l'API SSL_CONF
d'OpenSSL. Il n'est ainsi plus nécessaire d'implémenter des
directives supplémentaires pour mod_ssl lorsque de nouvelles
fonctionnalités sont ajoutées à OpenSSL, ce qui rend la configuration de
ce dernier beaucoup plus souple.
Le jeu de commandes disponibles pour la directive
SSLOpenSSLConfCmd dépend de la version d'OpenSSL
utilisée pour mod_ssl (la version minimale 1.0.2 est un
prérequis). Pour obtenir la liste des commandes supportées, voir la
section Supported configuration file commands de la page de
manuel d'OpenSSL SSL_CONF_cmd(3).
Certaines commandes peuvent remplacer des directives existantes
(comme SSLCipherSuite ou
SSLProtocol) ; notez cependant
que la syntaxe et/ou les valeurs possibles peuvent différer.
SSLOpenSSLConfCmd Options -SessionTicket,ServerPreference SSLOpenSSLConfCmd ECDHParameters brainpoolP256r1 SSLOpenSSLConfCmd ServerInfoFile "/usr/local/apache2/conf/server-info.pem" SSLOpenSSLConfCmd Protocol "-ALL, TLSv1.2" SSLOpenSSLConfCmd SignatureAlgorithms RSA+SHA384:ECDSA+SHA256
| Description: | Configure différentes options d'exécution du moteur SSL |
|---|---|
| Syntaxe: | SSLOptions [+|-]option ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet de contrôler différentes options d'exécution du
moteur SSL dans un contexte de répertoire. Normalement, si plusieurs
SSLOptions peuvent s'appliquer à un répertoire, c'est la
plus spécifique qui est véritablement prise en compte ; les options ne
se combinent pas entre elles. Elles se combinent cependant entre elles
si elles sont toutes précédées par un symbole plus
(+) ou moins (-). Toute option précédée d'un
+ est ajoutée aux options actuellement en vigueur, et toute
option précédée d'un - est supprimée de ces mêmes
options.
Les options disponibles sont :
StdEnvVars
Lorsque cette option est activée, le jeu standard de variables d'environnement SSL relatives à CGI/SSI est créé. Cette option est désactivée par défaut pour des raisons de performances, car l'extraction des informations constitue une opération assez coûteuse en ressources. On n'active donc en général cette option que pour les requêtes CGI et SSI.
ExportCertData
Lorsque cette option est activée, des variables d'environnement
CGI/SSI supplémentaires sont créées : SSL_SERVER_CERT,
SSL_CLIENT_CERT et
SSL_CLIENT_CERT_CHAIN_n (avec n =
0,1,2,..). Elles contiennent les certificats X.509 codés en PEM du
serveur et du client pour la connexion HTTPS courante, et peuvent
être utilisées par les scripts CGI pour une vérification de
certificat plus élaborée. De plus, tous les autres certificats de la
chaîne de certificats du client sont aussi fournis. Tout ceci gonfle
un peu l'environnement, et c'est la raison pour laquelle vous ne
devez activer cette option qu'à la demande.
FakeBasicAuth
Lorsque cette option est activée, le Nom Distinctif (DN) sujet du
certificat client X509 est traduit en un nom d'utilisateur pour
l'autorisation HTTP de base. Cela signifie que les méthodes
d'authentification standard d'Apache peuvent être utilisées pour le
contrôle d'accès. Le nom d'utilisateur est tout simplement le Sujet
du certificat X509 du client (il peut être déterminé en utilisant la
commande OpenSSL openssl x509 : openssl x509
-noout -subject -in certificat.crt).
Notez qu'aucun mot de passe n'est envoyé par l'utilisateur. Chaque
entrée du fichier des utilisateurs doit comporter ce mot de passe :
``xxj31ZMTZzkVA'', qui est la version chiffrée en DES
du mot ``password''. Ceux qui travaillent avec un
chiffrement basé sur MD5 (par exemple sous FreeBSD ou BSD/OS,
etc...) doivent utiliser le condensé MD5 suivant pour le même mot :
``$1$OXLyS...$Owx8s2/m9/gfkcRVXzgoE/''.
Notez que la directive AuthBasicFake implémentée par le
module mod_auth_basic peut être utilisée d'une
manière plus générale comme simulation d'authentification basique,
ce qui permet de contrôler la structure nom utilisateur/mot de
passe.
StrictRequire
Cette option force l'interdiction d'accès lorsque
SSLRequireSSL ou SSLRequire a décidé que
l'accès devait être interdit. Par défaut, dans le cas où
une directive ``Satisfy any'' est utilisée, et si
d'autres restrictions d'accès ont été franchies, on passe en général
outre l'interdiction d'accès due à SSLRequireSSL ou
SSLRequire (parce que c'est ainsi que le mécanisme
Satisfy d'Apache doit fonctionner). Pour des
restrictions d'accès plus strictes, vous pouvez cependant utiliser
SSLRequireSSL et/ou SSLRequire en
combinaison avec une option ``SSLOptions
+StrictRequire''. Une directive ``Satisfy Any''
n'a alors aucune chance d'autoriser l'accès si mod_ssl a décidé de
l'interdire.
OptRenegotiate
Cette option active la gestion optimisée de la renégociation des connexions SSL intervenant lorsque les directives SSL sont utilisées dans un contexte de répertoire. Par défaut un schéma strict est appliqué, et chaque reconfiguration des paramètres SSL au niveau du répertoire implique une phase de renégociation SSL complète. Avec cette option, mod_ssl essaie d'éviter les échanges non nécessaires en effectuant des vérifications de paramètres plus granulaires (mais tout de même efficaces). Néanmoins, ces vérifications granulaires peuvent ne pas correspondre à ce qu'attend l'utilisateur, et il est donc recommandé de n'activer cette option que dans un contexte de répertoire.
LegacyDNStringFormat
Cette option permet d'agir sur la manière dont les valeurs des
variables SSL_{CLIENT,SERVER}_{I,S}_DN sont formatées.
Depuis la version 2.3.11, Apache HTTPD utilise par défaut un format
compatible avec la RFC 2253. Ce format utilise des virgules comme
délimiteurs entre les attributs, permet l'utilisation de caractères
non-ASCII (qui sont alors convertis en UTF8), échappe certains
caractères spéciaux avec des slashes inversés, et trie les attributs
en plaçant l'attribut "C" en dernière position.
Si l'option LegacyDNStringFormat est présente, c'est
l'ancien format qui sera utilisé : les attributs sont triés avec
l'attribut "C" en première position, les séparateurs sont des
slashes non inversés, les caractères non-ASCII ne sont pas supportés
et le support des caractères spéciaux n'est pas fiable.
SSLOptions +FakeBasicAuth -StrictRequire
<Files ~ "\.(cgi|shtml)$">
SSLOptions +StdEnvVars -ExportCertData
</Files>
| Description: | Méthode utilisée pour entrer le mot de passe pour les clés privées chiffrées |
|---|---|
| Syntaxe: | SSLPassPhraseDialog type |
| Défaut: | SSLPassPhraseDialog builtin |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ssl |
Lors de son démarrage, Apache doit lire les différents fichiers de
certificats (voir la directive SSLCertificateFile) et de clés privées
(voir la directive SSLCertificateKeyFile) des serveurs
virtuels où SSL est activé. Comme, pour des raisons de sécurité, les
fichiers de clés privées sont en général chiffrés, mod_ssl doit
demander à l'administrateur un mot de passe pour déchiffrer ces
fichiers. L'argument type permet de choisir la manière dont
cette demande peut être formulée parmi les trois suivantes :
builtin
C'est la méthode par défaut, et un dialogue interactive de terminal s'ouvre au cours du démarrage juste avant qu'Apache ne se détache du terminal. A ce moment, l'administrateur doit entrer manuellement un mot de passe pour chaque fichier de clé privée chiffré. Etant donné qu'il peut y avoir un grand nombre de serveurs virtuels configurés avec SSL activé, le protocole de réutilisation suivant est utilisé pour minimiser le dialogue : lorsqu'un fichier de clé privée est chiffré, tous les mots de passe connus (au début, il n'y en a aucun, bien entendu) sont essayés. Si l'un de ces mots de passe connus convient, aucun dialogue ne s'ouvrira pour ce fichier de clé privée particulier. Si aucun ne convient, un autre mot de passe sera demandé à partir du terminal et sera mis en mémoire pour le fichier de clé privée suivant (pour lequel il pourra éventuellement être réutilisé).
Cette méthode confère à mod_ssl une grande souplesse (car pour N fichiers de clé privée chiffrés, vous pouvez utiliser N mots de passe différents - mais vous devrez alors tous les fournir, bien entendu), tout en minimisant le dialogue de terminal (vous pouvez en effet utiliser un seul mot de passe pour les N fichiers de clé privée et vous n'aurez alors à l'entrer qu'une seule fois).
|/chemin/vers/programme [arguments...]
Ce mode permet d'utiliser un programme externe qui va se présenter
comme une redirection vers un périphérique d'entrée particulier ; le
texte de prompt standard utilisé pour le mode builtin
est envoyé au programme sur stdin, et celui-ci doit
renvoyer des mots de passe sur stdout. Si
plusieurs mots de passe sont requis (ou si un mot de passe incorrect
a été entré), un texte de prompt supplémentaire sera écrit après le
retour du premier mot de passe, et d'autres mots de passe devront
alors être réécrits.
exec:/chemin/vers/programme
Ici, un programme externe est appelé au démarrage du serveur pour
chaque fichier de clé privée chiffré.Il est appelé avec deux
arguments (le premier est de la forme
``nom-serveur:port'', le second
est ``RSA'', ``DSA'', ``ECC''
ou un index entier commençant à 3 si plus de 3 clés ont été
configurées), qui
indiquent pour quels serveur et algorithme il doit écrire le mot de
passe correspondant sur stdout. Avec les versions 2.4.8
(non réalisée) et
2.4.9, il est appelé avec un seul argument, une chaîne de la forme
"servername:portnumber:index" (où index
est un nombre entier commençant à zéro), qui spécifie le serveur,
le port TCP et un numéro de certificat. Le but recherché est
l'exécution de vérifications de sécurité préalables permettant de
s'assurer que le système n'est pas victime d'une attaque, et de ne
fournir le mot de passe que si toutes les vérifications ont été
effectuées avec succès.
Ces vérifications de sécurité, ainsi que la manière dont le mot de
passe est déterminé peuvent être aussi sophistiqués que vous le
désirez. Mod_ssl ne définit que l'interface : un programme
exécutable qui écrit le mot de passe sur stdout. Ni
plus, ni moins ! Ainsi, si vous êtes vraiment paranoïaque en matière
de sécurité, voici votre interface. Tout le reste doit être confié à
l'administrateur à titre d'exercice, car les besoins en sécurité
locale sont très différents.
L'algorithme de réutilisation est utilisé ici aussi. En d'autres termes, le programme externe n'est appelé qu'une fois par mot de passe unique.
SSLPassPhraseDialog "exec:/usr/local/apache/sbin/pp-filter"
| Description: | Indique les versions du protocole SSL/TLS disponibles |
|---|---|
| Syntaxe: | SSLProtocol [+|-]protocole ... |
| Défaut: | SSLProtocol all -SSLv3 (jusqu'à la version 2.4.16 : all) |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet de définir quelles versions du protocole SSL/TLS seront acceptées lors de l'initialisation d'une nouvelle connexion.
Les protocoles disponibles sont les suivants (sensibles à la casse) :
SSLv3
Il s'agit du protocole Secure Sockets Layer (SSL) version 3.0 de Netscape Corporation. C'est le successeur de SSLv2 et le prédécesseur de TLSv1, mais est considéré comme obsolète dans la RFC 7568
TLSv1
Il s'agit du protocole Transport Layer Security (TLS) version 1.0. C'est le successeur de SSLv3, et il est défini dans la RFC2246. Il est supporté par la plupart des clients.
TLSv1.1 (à partir de la version 1.0.1 d'OpenSSL)
Une révision du protocole TLS 1.0 définie dans la RFC 4346.
TLSv1.2 (à partir de la version 1.0.1 d'OpenSSL)
Une révision du protocole TLS 1.1 définie dans la RFC 5246.
TLSv1.3 (à partir de la version 1.1.1 d'OpenSSL)
Une nouvelle version du protocole TLS définie dans la RFC 8446.
all
C'est un raccourci pour ``+SSLv3 +TLSv1'' ou - à partir
de la version 1.0.1 d'OpenSSL - ``+SSLv3 +TLSv1 +TLSv1.1
+TLSv1.2'' (sauf si OpenSSL a été compilé avec l'option
``no-ssl3'', auquel cas all n'inclura pas
+SSLv3).
SSLProtocol TLSv1
SSLProtocol et les serveurs virtuels
basés sur le nom
Avant OpenSSL 1.1.1, et même si l'indication du nom de serveur (Server Name
Indication ou SNI) permettait de déterminer le serveur virtuel cible assez tôt
au cours de la négociation TLS, il était impossible de changer de version de
protocole TLS à ce point, si bien que le SSLProtocol
négocié se basait toujours sur celui du serveur virtuel de base (le
premier serveur virtuel déclaré avec le couple IP:port de la
connexion).
A partir de la version 2.4.42, si le serveur HTTP Apache est compilé avec une
version 1.1.1. ou supérieure d'OpenSSL, et si le client fournit la SNI dans la
négociation TLS, le SSLProtocol de chaque serveur virtuel
(basé sur le nom) pourra être pris en compte et le sera.
A des fins de compatibilité avec les versions précédentes, si un serveur virtuel
basé sur le nom n'a aucune directive SSLProtocol définie,
c'est le protocole du serveur virtuel de base qui s'appliquera, à
moins qu'une directive SSLProtocol ne soit
configurée au niveau global, auquel cas c'est le protocole défini par cette
directive qui s'appliquera (ce dernier cas relève cependant plus d'un
comportement logique que d'un souci de compatibilité).
| Description: | Fichier contenant la concaténation des certificats de CA codés en PEM pour l'authentification des serveurs distants |
|---|---|
| Syntaxe: | SSLProxyCACertificateFile file-path |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet de définir le fichier tout-en-un où sont
stockés les certificats des Autorités de Certification (CA) pour les
serveurs distants auxquels vous avez à faire. On les utilise
lors de l'authentification du serveur distant. Un tel fichier contient
la simple concaténation des différents fichiers de certificats codés en
PEM, classés par ordre de préférence. On peut utiliser cette directive à
la place et/ou en complément de la directive SSLProxyCACertificatePath.
SSLProxyCACertificateFile "/usr/local/apache2/conf/ssl.crt/ca-bundle-serveur.distant.crt"
| Description: | Répertoire des certificats de CA codés en PEM pour l'authentification des serveurs distants |
|---|---|
| Syntaxe: | SSLProxyCACertificatePath chemin-répertoire |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet de spécifier le répertoire où sont stockés les certificats des Autorités de Certification (CAs) pour les serveurs distants auxquels vous avez à faire. On les utilise pour vérifier le certificat du serveur distant lors de l'authentification de ce dernier.
Les fichiers de ce répertoire doivent être codés en PEM et ils sont
accédés via des noms de fichier sous forme de condensés ou hash. Il ne
suffit donc pas de placer les fichiers de certificats dans ce répertoire
: vous devez aussi créer des liens symboliques nommés
valeur-de-hashage.N, et vous devez toujours vous
assurer que ce répertoire contient les liens symboliques appropriés.
SSLProxyCACertificatePath "/usr/local/apache2/conf/ssl.crt/"
| Description: | Active la vérification des révocations basée sur les CRLs pour l'authentification du serveur distant |
|---|---|
| Syntaxe: | SSLProxyCARevocationCheck chain|leaf|none |
| Défaut: | SSLProxyCARevocationCheck none |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Active la vérification des révocations basée sur les Listes de
révocations de Certificats (CRL) pour les serveurs distants
auxquels vous vous connectez. A moins une des directives SSLProxyCARevocationFile ou SSLProxyCARevocationPath doit être définie.
Lorsque cette directive est définie à chain (valeur
recommandée), les vérifications CRL sont effectuées sur tous les
certificats de la chaîne, alors que la valeur leaf limite
la vérification au certificat hors chaîne (la feuille).
chain ou
leaf, les CRLs doivent être disponibles pour que la
validation réussisse
Avant la version 2.3.15, les vérifications CRL dans mod_ssl
réussissaient même si aucune CRL n'était trouvée dans les chemins
définis par les directives SSLProxyCARevocationFile ou SSLProxyCARevocationPath. Le comportement a
changé avec l'introduction de cette directive : lorsque la vérification
est activée, les CRLs doivent être présentes pour que la
validation réussisse ; dans le cas contraire, elle échouera avec une
erreur "CRL introuvable".
SSLProxyCARevocationCheck chain
| Description: | Fichier contenant la concaténation des CRLs de CA codés en PEM pour l'authentification des serveurs distants |
|---|---|
| Syntaxe: | SSLProxyCARevocationFile file-path |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet de définir le fichier tout-en-un où sont
rassemblées les Listes de Révocation de Certificats (CRLs) des Autorités
de certification (CAs) pour les serveurs distants auxquels vous
avez à faire. On les utilise pour l'authentification des serveurs
distants. Un tel fichier contient la simple concaténation des différents
fichiers de CRLs codés en PEM, classés par ordre de préférence. Cette
directive peut être utilisée à la place et/ou en complément de la
directive SSLProxyCARevocationPath.
SSLProxyCARevocationFile "/usr/local/apache2/conf/ssl.crl/ca-bundle-serveur.distant.crl"
| Description: | Répertoire des CRLs de CA codés en PEM pour l'authentification des serveurs distants |
|---|---|
| Syntaxe: | SSLProxyCARevocationPath chemin-répertoire |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet de définir le répertoire où sont stockées les Listes de Révocation de Certificats (CRL) des Autorités de Certification (CAs) pour les serveurs distants auxquels vous avez à faire. On les utilise pour révoquer les certificats des serveurs distants au cours de l'authentification de ces derniers.
Les fichiers de ce répertoire doivent être codés en PEM et ils sont
accédés via des noms de fichier sous forme de condensés ou hash. Il ne
suffit donc pas de placer les fichiers de CRL dans ce répertoire
: vous devez aussi créer des liens symboliques nommés
valeur-de-hashage.rN, et vous devez toujours vous
assurer que ce répertoire contient les liens symboliques appropriés.
SSLProxyCARevocationPath "/usr/local/apache2/conf/ssl.crl/"
| Description: | Configuration de la vérification du champ CN du certificat du serveur distant |
|---|---|
| Syntaxe: | SSLProxyCheckPeerCN on|off |
| Défaut: | SSLProxyCheckPeerCN on |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet de définir si le champ CN du certificat du serveur
distant doit être comparé au nom de serveur de l'URL de la requête. S'ils ne
correspondent pas, un code d'état 502 (Bad Gateway) est envoyé. A partir de la
version 2.4.5, SSLProxyCheckPeerCN a été remplacé par SSLProxyCheckPeerName.
De la version 2.4.5 à la version 2.4.20, spécifier SSLProxyCheckPeerName
off était suffisant pour obtenir ce comportement (car la valeur par
défaut de SSLProxyCheckPeerCN était on). Avec ces
versions, les deux directives doivent être définies à off pour
éviter toute validation du nom de certificat du serveur distant, et de
nombreux utilisateurs ont signalé ce comportement comme très perturbant.
A partir de la version 2.4.21, toutes les configurations qui activent au moins
une des deux directives SSLProxyCheckPeerName ou
SSLProxyCheckPeerCN adopteront le nouveau comportement de la
directive SSLProxyCheckPeerName, et
toutes les configurations qui désactivent une des deux directives
SSLProxyCheckPeerName ou SSLProxyCheckPeerCN
éviteront toute validation du nom de certificat du serveur distant. Seule la
configuration suivante permettra de retrouver la comparaison de CN
traditionnelle pour les versions 2.4.21 et supérieures :
SSLProxyCheckPeerCN on SSLProxyCheckPeerName off
| Description: | Configuration de la vérification de l'expiration du certificat du serveur distant |
|---|---|
| Syntaxe: | SSLProxyCheckPeerExpire on|off |
| Défaut: | SSLProxyCheckPeerExpire on |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet de définir si l'expiration du certificat du serveur distant doit être vérifiée ou non. Si la vérification échoue, un code d'état 502 (Bad Gateway) est envoyé.
SSLProxyCheckPeerExpire on
| Description: | Configure la vérification du nom d'hôte dans les certificats serveur distants |
|---|---|
| Syntaxe: | SSLProxyCheckPeerName on|off |
| Défaut: | SSLProxyCheckPeerName on |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP
Apache Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet de configurer la vérification du nom d'hôte pour les certificats serveur lorsque mod_ssl agit en tant que client SSL. La vérification réussit si le nom d'hôte de l'URI de la requête correspond à un des attributs CN du sujet du certificat, ou à l'extension subjectAltName. Si la vérification échoue, la requête SSL avorte, et un code d'erreur 502 (Bad Gateway) est renvoyé.
Les caractères génériques sont supportés dans certains cas bien spécifiques :
une entrée subjectAltName de type dNSName ou les attributs CN
commençant par *. correspondront à tout nom d'hôte comportant
le même nombre de champs et le même suffixe ; par exemple,
*.example.org correspondra à foo.example.org,
mais pas à foo.bar.example.org car le nombre d'éléments dans les
nom est différent.
Cette fonctionnalité a été introduite avec la version 2.4.5 et l'emporte sur la
directive SSLProxyCheckPeerCN qui ne
comparait que la valeur exacte du premier attribut CN avec le nom d'hôte.
Cependant, de nombreux utilisateurs étaient déconcertés par le comportement
induit par l'utilisation de ces deux directives individuellement, si bien que ce
comportement a été amélioré avec la version 2.4.21. Voir la description de la
directive SSLProxyCheckPeerCN pour le
comportement original et des détails à propos de ces améliorations.
| Description: | Algorithmes de chiffrement disponibles pour la négociation lors de l'initialisation d'une connexion SSL de mandataire |
|---|---|
| Syntaxe: | SSLProxyCipherSuite [protocol] cipher-spec |
| Défaut: | SSLProxyCipherSuite ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:+LOW:+EXP |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive est équivalente à la directive SSLCipherSuite, mais s'applique à une connexion de
mandataire. Veuillez vous reporter à la directive SSLCipherSuite pour plus d'informations.
| Description: | Interrupteur marche/arrêt du moteur de mandataire SSL |
|---|---|
| Syntaxe: | SSLProxyEngine on|off |
| Défaut: | SSLProxyEngine off |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet d'activer/désactiver l'utilisation du moteur de
protocole SSL/TLS pour le mandataire. On l'utilise en général à
l'intérieur d'une section <VirtualHost> pour activer le protocole SSL/TLS
dans le cadre d'un mandataire pour un serveur virtuel particulier. Par
défaut, le moteur de protocole SSL/TLS est désactivé pour la fonction de
mandataire du serveur principal et de tous les serveurs virtuels
configurés.
Notez que la directive SSLProxyEngine ne doit
généralement pas être utilisée dans le cadre d'un serveur virtuel qui agit en
tant que mandataire direct (via les directives <Proxy> ou ProxyRequests).
SSLProxyEngine n'est pas nécessaire pour activer un
serveur mandataire direct pour les requêtes SSL/TLS.
<VirtualHost _default_:443>
SSLProxyEngine on
#...
</VirtualHost>
| Description: | Fichier de certificats de CA encodés PEM concaténés permettant au mandataire de choisir un certificat |
|---|---|
| Syntaxe: | SSLProxyMachineCertificateChainFile nom-fichier |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet de définir le fichier global où est enregistrée la chaîne de certification pour tous les certificats clients utilisés. Elle est nécessaire si le serveur distant présente une liste de certificats de CA qui ne sont pas les signataires directs d'un des certificats clients configurés.
Ce fichier contient tout simplement la concaténation des différents fichiers de certificats encodés PEM. Au démarrage, chaque certificat client configuré est examiné et une chaîne de certification est construite.
Si cette directive est définie, tous les certificats contenus dans le
fichier spécifié seront considérés comme étant de confiance, comme s'ils
étaient aussi désignés dans la directive SSLProxyCACertificateFile.
SSLProxyMachineCertificateChainFile "/usr/local/apache2/conf/ssl.crt/proxyCA.pem"
| Description: | Fichier contenant la concaténation des clés et certificats clients codés en PEM que le mandataire doit utiliser |
|---|---|
| Syntaxe: | SSLProxyMachineCertificateFile chemin-fichier |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est pris en charge à partir de la
version 2.4.30 du serveur HTTP Apache L'inclusion de certificats non-feuilles (CA) est prise en charge à partir de la version 2.4.59. |
Cette directive permet de définir le fichier tout-en-un où sont stockés les clés et certificats permettant au serveur mandataire de s'authentifier auprès des serveurs distants.
Le fichier spécifié est la simple concaténation des différents fichiers de
certificats codés en PEM. Cette directive s'utilise à la place ou en complément
de la directive SSLProxyMachineCertificatePath. Le fichier spécifié
peut contenir un nombre quelconque de paires certificat client/clé privée
associée, et chaque paire peut être spécifiée selon l'ordre (certificat, clé) ou
(clé, certificat). Des certificats non-feuilles (CA) peuvent aussi être inclus
dans le fichier et sont traités comme s'ils avaient été définis à l'aide de la
directive SSLProxyMachineCertificateChainFile.
Lorsqu'un serveur distant sollicite le serveur pour obtenir un certificat
client, ce dernier doit fournir une liste de noms d'autorités de
certification acceptables au cours de la négociation. Si cette liste n'est
pas fournie, mod_ssl utilisera la première paire certificat/clé
client définie. Si par contre cette liste est fournie,
mod_ssl va la parcourir afin de trouver un certificat client
défini qui a été fourni soit directement par l'autorité de certification
considérée, soit indirectement via un nombre quelconque de certificats d'autorités de
certification intermédiaires. La chaîne de certificats d'autorités de
certification intermédiaires peut être construite à partir de ceux qui sont
inclus dans le fichier ou configurés
à l'aide de la directive SSLProxyMachineCertificateChainFile. Le premier
certificat défini correspondant sera alors fourni comme réponse au cours de la
négociation
Si la liste de noms de CA est fournie au serveur distant, et si
aucun certificat client correspondant n'est trouvé, aucun certificat
client ne sera fourni par mod_ssl, ce qui fera probablement
échouer la négociation SSL/TLS (en fonction de la configuration du serveur
distant).
Actuellement, les clés privées chiffrées ne sont pas supportées.
Seules les clés au format PKCS1 RSA, DSA ou EC sont supportées. Les clés
au format PKCS8, autrement dit celles commençant par "-----BEGIN
PRIVATE KEY-----", doivent être converties via une commande du style
"openssl rsa -in private-pkcs8.pem -outform pem".
SSLProxyMachineCertificateFile "/usr/local/apache2/conf/ssl.crt/proxy.pem"
| Description: | Répertoire des clés et certificats clients codés en PEM que le mandataire doit utiliser |
|---|---|
| Syntaxe: | SSLProxyMachineCertificatePath chemin-répertoire |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet de définir le répertoire où sont stockés les clés et certificats clients permettant au serveur mandataire de s'authentifier auprès des serveurs distants.
mod_ssl va essayer de charger tous les fichiers contenus dans le répertoire
spécifié, comme si ces derniers étaient définis individuellement via la
directive SSLProxyMachineCertificateFile.
Actuellement, les clés privées chiffrées ne sont pas supportées.
Seules les clés au format PKCS1 RSA, DSA ou EC sont supportées. Les clés
au format PKCS8, autrement dit celles commençant par "-----BEGIN
PRIVATE KEY-----", doivent être converties via une commande du style
"openssl rsa -in private-pkcs8.pem -outform pem".
SSLProxyMachineCertificatePath "/usr/local/apache2/conf/proxy.crt/"
| Description: | Définit les protocoles SSL disponibles pour la fonction de mandataire |
|---|---|
| Syntaxe: | SSLProxyProtocol [+|-]protocole ... |
| Défaut: | SSLProxyProtocol all -SSLv3 (jusqu'à la version 2.4.16: all) |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet de définir les protocoles SSL que mod_ssl peut utiliser lors de l'élaboration de son environnement de serveur pour la fonction de mandataire. Il ne se connectera qu'aux serveurs utilisant un des protocoles spécifiés.
Veuillez vous reporter à la directive SSLProtocol pour plus d'informations.
| Description: | Niveau de vérification du certificat du serveur distant |
|---|---|
| Syntaxe: | SSLProxyVerify niveau |
| Défaut: | SSLProxyVerify none |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Lorsqu'un mandataire est configuré pour faire suivre les requêtes vers un serveur SSL distant, cette directive permet de configurer la vérification du certificat de ce serveur distant.
Les valeurs de niveaux disponibles sont les suivantes :
En pratique, seuls les niveaux none et require sont vraiment intéressants, car le niveau optional ne fonctionne pas avec tous les serveurs, et le niveau optional_no_ca va tout à fait à l'encontre de l'idée que l'on peut se faire de l'authentification (mais peut tout de même être utilisé pour établir des pages de test SSL, etc...).
SSLProxyVerify require
| Description: | Niveau de profondeur maximum dans les certificats de CA lors de la vérification du certificat du serveur distant |
|---|---|
| Syntaxe: | SSLProxyVerifyDepth niveau |
| Défaut: | SSLProxyVerifyDepth 1 |
| Contexte: | configuration globale, serveur virtuel, section proxy |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Le contexte d'une section proxy est supporté à partir de la version 2.4.30 du serveur HTTP Apache |
Cette directive permet de définir le niveau de profondeur maximum jusqu'auquel mod_ssl doit aller au cours de sa vérification avant de décider que le serveur distant ne possède pas de certificat valide.
La profondeur correspond en fait au nombre maximum de fournisseurs de
certificats intermédiaires, c'est à dire le nombre maximum de
certificats
de CA que l'on peut consulter lors de la vérification du certificat du
serveur distant. Une profondeur de 0 signifie que seuls les certificats
de serveurs distants auto-signés sont acceptés, et la profondeur par
défaut de 1 que le certificat du serveur distant peut être soit
auto-signé, soit signé par une CA connue directement du serveur (en
d'autres termes, le certificat de CA est référencé par la directive
SSLProxyCACertificatePath),
etc...
SSLProxyVerifyDepth 10
| Description: | Source de déclenchement du Générateur de Nombres Pseudo-Aléatoires (PRNG) |
|---|---|
| Syntaxe: | SSLRandomSeed contexte source
[nombre] |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet de définir une ou plusieurs sources de
déclenchement du Générateur de Nombres Pseudo-Aléatoires (PRNG) dans
OpenSSL au démarrage du serveur (si contexte a pour valeur
startup) et/ou juste avant l'établissement d'une nouvelle
connexion SSL (si contexte a pour valeur connect).
Cette directive ne peut être utilisée qu'au niveau du serveur global car
le PRNG est un service global.
Les différentes valeurs de source disponibles sont :
builtin
Cette source de déclenchement intégrée est toujours disponible. Son utilisation consomme un minimum de cycles CPU en cours d'exécution, et son utilisation ne présente de ce fait aucun problème. La source utilisée pour déclencher le PRNG contient la date courante, l'identifiant du processus courant et un extrait de 128 octets aléatoirement choisi dans la pile. Ceci présente un inconvénient car le caractère aléatoire de cette source n'est pas vraiment fort, et au démarrage (lorsque la structure d'échanges n'est pas encore disponible), cette source ne produit que quelques octets d'entropie. Vous devez donc toujours utiliser une source de déclenchement additionnelle, au moins pour le démarrage.
file:/chemin/vers/source
Cette variante utilise un fichier externe
file:/chemin/vers/source comme source de déclenchement
du PRNG. Lorsque nombre est spécifié, seuls les
nombre premiers octets du fichier forment l'entropie (et
nombre est fourni comme premier argument à
/chemin/vers/source). Lorsque nombre n'est pas
spécifié, l'ensemble du fichier forme l'entropie (et 0
est fourni comme premier argument à
/chemin/vers/source). Utilisez cette source en
particulier au démarrage, par exemple avec un fichier de
périphérique /dev/random et/ou
/dev/urandom (qui sont en général présent sur les
plate-formes dérivées d'Unix modernes comme FreeBSD et Linux).
Soyez cependant prudent : en général,
/dev/random ne fournit que l'entropie dont il dispose
réellement ; en d'autres termes, lorsque vous demandez 512 octets
d'entropie, si le périphérique ne dispose que de 100 octets, deux
choses peuvent se produire : sur certaines plates-formes, vous ne
recevez que les 100 octets, alors que sur d'autres, la lecture se
bloque jusqu'à ce qu'un nombre suffisant d'octets soit disponible
(ce qui peut prendre beaucoup de temps). Il est préférable ici
d'utiliser le périphérique /dev/urandom, car il ne se
bloque jamais et fournit vraiment la quantité de données demandées.
Comme inconvénient, les données reçues ne sont pas forcément de la
meilleure qualité.
exec:/chemin/vers/programme
Cette variante utilise un exécutable externe
/chemin/vers/programme comme source de déclenchement du
PRNG. Lorsque nombre est spécifié, seules les
nombre premiers octets de son flux stdout
forment l'entropie. Lorsque nombre n'est pas spécifié,
l'intégralité des données produites sur stdout forment
l'entropie. N'utilisez cette variante qu'au démarrage où une source
de déclenchement fortement aléatoire est nécessaire, en utilisant
un programme externe (comme dans l'exemple
ci-dessous avec l'utilitaire truerand basé sur la
bibliothèque truerand de AT&T que vous trouverez
dans la distribution de mod_ssl). Bien entendu, l'utilisation de
cette variante dans un contexte "connection" ralentit le serveur de
manière trop importante, et en général, vous devez donc éviter
d'utiliser des programmes externes dans ce contexte.
egd:/chemin/vers/socket-egd (Unix seulement)
Cette variante utilise le socket de domaine Unix du Démon Générateur d'Entropie externe ou Entropy Gathering Daemon ou EGD (voir http://www.lothar.com/tech /crypto/) pour déclencher le PRNG. N'utilisez cette variante que si votre plate-forme ne possède pas de périphérique random ou urandom.
SSLRandomSeed startup builtin SSLRandomSeed startup "file:/dev/random" SSLRandomSeed startup "file:/dev/urandom" 1024 SSLRandomSeed startup "exec:/usr/local/bin/truerand" 16 SSLRandomSeed connect builtin SSLRandomSeed connect "file:/dev/random" SSLRandomSeed connect "file:/dev/urandom" 1024
| Description: | Définit la taille du tampon de renégociation SSL |
|---|---|
| Syntaxe: | SSLRenegBufferSize taille |
| Défaut: | SSLRenegBufferSize 131072 |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_ssl |
Si une renégociation SSL est requise dans un contexte de répertoire,
par exemple avec l'utilisation de SSLVerifyClient dans un bloc Directory ou
Location, mod_ssl doit mettre en tampon en mémoire tout corps de requête
HTTP en attendant qu'une nouvelle initialisation de connexion SSL puisse
être effectuée. Cette directive permet de définir la quantité de mémoire
à allouer pour ce tampon.
Notez que dans de nombreuses configurations, le client qui envoie un corps de requête n'est pas forcément digne de confiance, et l'on doit par conséquent prendre en considération la possibilité d'une attaque de type déni de service lorsqu'on modifie la valeur de cette directive.
SSLRenegBufferSize 262144
| Description: | N'autorise l'accès que lorsqu'une expression booléenne complexe et arbitraire est vraie |
|---|---|
| Syntaxe: | SSLRequire expression |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_ssl |
SSLRequire est obsolète et doit en général être
remplacée par l'expression Require. La syntaxe ap_expr de l'expression Require est
une extension de la syntaxe de SSLRequire, avec les
différences suivantes :
Avec SSLRequire, les opérateurs de comparaison
<, <=, ... sont strictement équivalents
aux opérateurs lt, le, ... , et fonctionnent
selon une méthode qui compare tout d'abord la longueur des deux chaînes,
puis l'ordre alphabétique. Les expressions ap_expr, quant à elles, possèdent deux jeux
d'opérateurs de comparaison : les opérateurs <,
<=, ... effectuent une comparaison alphabétique de
chaînes, alors que les opérateurs -lt, -le,
... effectuent une comparaison d'entiers. Ces derniers possèdent aussi
des alias sans tiret initial : lt, le, ...
Cette directive permet de spécifier une condition générale d'accès qui doit être entièrement satisfaite pour que l'accès soit autorisé. C'est une directive très puissante, car la condition d'accès spécifiée est une expression booléenne complexe et arbitraire contenant un nombre quelconque de vérifications quant aux autorisations d'accès.
L'expression doit respecter la syntaxe suivante (fournie ici sous la forme d'une notation dans le style de la grammaire BNF) :
expr ::= "true" | "false"
| "!" expr
| expr "&&" expr
| expr "||" expr
| "(" expr ")"
| comp
comp ::= word "==" word | word "eq" word
| word "!=" word | word "ne" word
| word "<" word | word "lt" word
| word "<=" word | word "le" word
| word ">" word | word "gt" word
| word ">=" word | word "ge" word
| word "in" "{" wordlist "}"
| word "in" "PeerExtList(" word ")"
| word "=~" regex
| word "!~" regex
wordlist ::= word
| wordlist "," word
word ::= digit
| cstring
| variable
| function
digit ::= [0-9]+
cstring ::= "..."
variable ::= "%{" varname "}"
function ::= funcname "(" funcargs ")"
Pour varname, toute variable décrite dans Variables d'environnement pourra être utilisée.
Pour funcname, vous trouverez la liste des fonctions
disponibles dans la documentation
ap_expr.
expression est interprétée et traduite sous une forme machine interne lors du chargement de la configuration, puis évaluée lors du traitement de la requête. Dans le contexte des fichiers .htaccess, expression est interprétée et exécutée chaque fois que le fichier .htaccess intervient lors du traitement de la requête.
SSLRequire ( %{SSL_CIPHER} !~ m/^(EXP|NULL)-/ \
and %{SSL_CLIENT_S_DN_O} eq "Snake Oil, Ltd." \
and %{SSL_CLIENT_S_DN_OU} in {"Staff", "CA", "Dev"} \
and %{TIME_WDAY} -ge 1 and %{TIME_WDAY} -le 5 \
and %{TIME_HOUR} -ge 8 and %{TIME_HOUR} -le 20 ) \
or %{REMOTE_ADDR} =~ m/^192\.76\.162\.[0-9]+$/
La fonction PeerExtList(identifiant objet)
recherche une instance d'extension de certificat X.509 identifiée par
identifiant objet (OID) dans le certificat client. L'expression est
évaluée à true si la partie gauche de la chaîne correspond exactement à
la valeur d'une extension identifiée par cet OID (Si plusieurs
extensions possèdent le même OID, l'une d'entre elles au moins doit
correspondre).
SSLRequire "foobar" in PeerExtList("1.2.3.4.5.6")
L'identifiant objet peut être spécifié soit comme un nom
descriptif reconnu par la bibliothèque SSL, tel que
"nsComment", soit comme un OID numérique tel que
"1.2.3.4.5.6".
Les expressions contenant des types connus de la bibliothèque SSL sont transformées en chaînes avant comparaison. Pour les extensions contenant un type non connu de la bibliothèque SSL, mod_ssl va essayer d'interpréter la valeur s'il s'agit d'un des types ASN.1 primaires UTF8String, IA5String, VisibleString, ou BMPString. Si l'extension correspond à un de ces types, la chaîne sera convertie en UTF-8 si nécessaire, puis comparée avec la partie gauche de l'expression.
| Description: | Interdit l'accès lorsque la requête HTTP n'utilise pas SSL |
|---|---|
| Syntaxe: | SSLRequireSSL |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive interdit l'accès si HTTP sur SSL (c'est à dire HTTPS) n'est pas activé pour la connexion courante. Ceci est très pratique dans un serveur virtuel où SSL est activé ou dans un répertoire pour se protéger des erreurs de configuration qui pourraient donner accès à des ressources protégées. Lorsque cette directive est présente, toutes les requêtes qui n'utilisent pas SSL sont rejetées.
SSLRequireSSL
| Description: | Type du cache de session SSL global et inter-processus |
|---|---|
| Syntaxe: | SSLSessionCache type |
| Défaut: | SSLSessionCache none |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet de configurer le type de stockage du cache de session SSL global et inter-processus. Ce cache est une fonctionnalité optionnelle qui accélère le traitement parallèle des requêtes. Pour ce qui est des requêtes vers un même processus du serveur (via HTTP keep-alive), OpenSSL met en cache les informations de session SSL en interne. Mais comme les clients modernes demandent des images en ligne et d'autres données via des requêtes parallèles (un nombre de quatre requêtes parallèles est courant), ces requêtes vont être servies par plusieurs processus du serveur pré-déclenchés. Ici, un cache inter-processus permet d'éviter des négociations de session inutiles.
Les quatre types de stockage suivants sont actuellement supportés :
none
Cette valeur désactive le cache de session global et inter-processus, ce qui va ralentir le serveur de manière sensible et peut poser problème avec certains navigateurs, en particulier si les certificats clients sont activés. Cette configuration n'est pas recommandée.
nonenotnull
Cette valeur désactive tout cache de session global et inter-processus. Cependant, elle force OpenSSL à envoyer un identifiant de session non nul afin de s'adapter aux clients bogués qui en nécessitent un.
dbm:/chemin/vers/fichier-données
Cette valeur utilise un fichier de hashage DBM sur disque local
pour synchroniser les caches OpenSSL locaux en mémoire des processus
du serveur. Ce cache de session peut être sujet à des problèmes de
fiabilité sous forte charge. Pour l'utiliser, le module
mod_socache_dbm doit être chargé.
shmcb:/chemin/vers/fichier-données[(nombre)]
Cette valeur utilise un tampon cyclique à hautes performances
(d'une taille d'environ nombre octets) dans un segment de
mémoire partagée en RAM (établi via
/chemin/vers/fichier-données, pour synchroniser les
caches OpenSSL locaux en mémoire des processus du serveur. C'est le
type de cache de session recommandé. Pour l'utiliser, le module
mod_socache_shmcb doit être chargé.
dc:UNIX:/chemin/vers/socket
Cette valeur utilise les bibliothèques de mise en cache de
sessions distribuée sur distcache.
L'argument doit spécifier le serveur ou mandataire à utiliser en
utilisant la syntaxe d'adressage distcache ; par exemple,
UNIX:/chemin/vers/socket spécifie une socket de domaine
Unix (en général un mandataire de dc_client local) ;
IP:serveur.example.com:9001 spécifie une adresse IP.
Pour l'utiliser, le module mod_socache_dc doit être
chargé.
SSLSessionCache "dbm:/usr/local/apache/logs/ssl_gcache_data" SSLSessionCache "shmcb:/usr/local/apache/logs/ssl_gcache_data(512000)"
Le mutex ssl-cache permet de sérialiser l'accès au cache
de session afin d'éviter toute corruption. Ce mutex peut être configuré
via la directive Mutex.
| Description: | Nombre de secondes avant l'expiration d'une session SSL dans le cache de sessions |
|---|---|
| Syntaxe: | SSLSessionCacheTimeout secondes |
| Défaut: | SSLSessionCacheTimeout 300 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | S'applique aussi à la reprise de session TLS (RFC 5077) à partir de la version 2.4.10 du serveur HTTP Apache |
Cette directive permet de définir la durée de vie en secondes des informations stockées dans le cache de sessions SSL global et inter-processus, dans le cache OpenSSL interne en mémoire et pour les sessions réinitialisées par la reprise de session TLS (RFC 5077). elle peut être définie à une valeur d'environ 15 à des fins de test, mais à une valeur très supérieure comme 300 en production.
SSLSessionCacheTimeout 600
| Description: | Clé de chiffrement/déchiffrement permanente pour les tickets de session TLS |
|---|---|
| Syntaxe: | SSLSessionTicketKeyFile file-path |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible depuis la version 2.4.0 du serveur HTTP Apache, sous réserve que l'on utilise une version 0.9.8h ou supérieure d'OpenSSL |
Cette directive permet de définir une clé secrète pour le chiffrement et le déchiffrement des tickets de session TLS selon les préconisations de la RFC 5077. Elle a été conçue à l'origine pour les environnements de clusters où les données des sessions TLS doivent être partagées entre plusieurs noeuds. Pour les configurations ne comportant qu'une seule instance de httpd, il est préférable d'utiliser les clés (aléatoires) générées par mod_ssl au démarrage du serveur.
Le fichier doit contenir 48 octets de données aléatoires créées de préférence par une source à haute entropie. Sur un système de type UNIX, il est possible de créer le fichier contenant la clé de la manière suivante :
dd if=/dev/random of=/chemin/vers/fichier.tkey bs=1 count=48
Ces clés doivent être renouvelées fréquemment, car il s'agit du seul moyen d'invalider un ticket de session existant - OpenSSL ne permet pas actuellement de spécifier une limite à la durée de vie des tickets. Une nouvelle clé ne peut être utilisée qu'après avoir redémarré le serveur. Tous les tickets de session existants deviennent invalides après le redémarrage du serveur.
Ce fichier contient des données sensibles et doit donc être protégé
par des permissions similaires à celles du fichier spécifié par la
directive SSLCertificateKeyFile.
| Description: | Active ou désactive les tickets de session TLS |
|---|---|
| Syntaxe: | SSLSessionTickets on|off |
| Défaut: | SSLSessionTickets on |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible à partir de la version 2.4.11 du serveur HTTP Apache, sous réserve d'utiliser OpenSSL version 0.9.8f ou supérieure. |
Cette directive permet d'activer ou de désactiver l'utilisation des tickets de session TLS (RFC 5077).
Les tickets de session TLS sont activés par défaut. Les utiliser sans redémarrer le serveur selon une périodicité appropriée (par exemple quotidiennement) compromet cependant le niveau de confidentialité.
| Description: | Source d'aléa pour utilisateur SRP inconnu |
|---|---|
| Syntaxe: | SSLSRPUnknownUserSeed secret-string |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible depuis la version 2.4.4 du serveur HTTP Apache, si la version 1.0.1 ou supérieure d'OpenSSL est utilisée. |
Cette directive permet de définir la source d'aléa à utiliser pour les utilisateurs SRP inconnus, ceci afin de combler les manques en cas d'existence d'un tel utilisateur. Elle définit une chaîne secrète. Si cette directive n'est pas définie, Apache renverra une alerte UNKNOWN_PSK_IDENTITY aux clients qui fournissent un nom d'utilisateur inconnu.
SSLSRPUnknownUserSeed "secret"
| Description: | Chemin du fichier de vérification SRP |
|---|---|
| Syntaxe: | SSLSRPVerifierFile file-path |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible depuis la version 2.4.4 du serveur HTTP Apache, si la version 1.0.1 ou supérieure d'OpenSSL est utilisée. |
Cette directive permet d'activer TLS-SRP et de définir le chemin du fichier de vérification OpenSSL SRP (Mot de passe distant sécurisé) contenant les noms d'utilisateurs TLS-SRP, les vérificateurs, les "grains de sel" (salts), ainsi que les paramètres de groupe.
SSLSRPVerifierFile "/path/to/file.srpv"
Le fichier de vérification peut être créé via l'utilitaire en ligne de
commande openssl :
openssl srp -srpvfile passwd.srpv -userinfo "some info" -add username
La valeur affectée au paramètre optionnel -userinfo est
enregistrée dans la variable d'environnement
SSL_SRP_USERINFO.
| Description: | Configuration du cache pour l'agrafage OCSP |
|---|---|
| Syntaxe: | SSLStaplingCache type |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible si on utilise OpenSSL version 0.9.8h ou supérieure |
Si SSLUseStapling est à "on",
cette directive permet de configurer le cache destiné à stocker les
réponses OCSP incluses dans la négociation TLS. La configuration d'un
cache est obligatoire pour pouvoir utiliser l'agrafage OCSP. A
l'exception de none et nonenotnull, cette
directive supporte les mêmes types de stockage que la directive
SSLSessionCache.
| Description: | Durée de vie des réponses invalides dans le cache pour agrafage OCSP |
|---|---|
| Syntaxe: | SSLStaplingErrorCacheTimeout secondes |
| Défaut: | SSLStaplingErrorCacheTimeout 600 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible si on utilise OpenSSL version 0.9.8h ou supérieure |
Cette directive permet de définir la durée de vie des réponses
invalides dans le cache pour agrafage OCSP configuré via la
directive SSLStaplingCache. Pour
définir la durée de vie des réponses valides, voir la directive
SSLStaplingStandardCacheTimeout.
| Description: | Génère une réponse "tryLater" pour les requêtes OCSP échouées |
|---|---|
| Syntaxe: | SSLStaplingFakeTryLater on|off |
| Défaut: | SSLStaplingFakeTryLater on |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible si on utilise OpenSSL version 0.9.8h ou supérieure |
Lorsque cette directive est activée, et si une requête vers un
serveur OCSP à des fins d'inclusion dans une négociation TLS échoue,
mod_ssl va générer une réponse "tryLater" pour le client (SSLStaplingReturnResponderErrors doit être
activée).
| Description: | Remplace l'URI du serveur OCSP spécifié dans l'extension AIA du certificat |
|---|---|
| Syntaxe: | SSLStaplingForceURL uri |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible si on utilise OpenSSL version 0.9.8h ou supérieure |
Cette directive permet de remplacer l'URI du serveur OCSP extraite de l'extension authorityInfoAccess (AIA) du certificat. Elle peut s'avérer utile lorsqu'on passe par un mandataire
| Description: | Temps d'attente maximum pour les requêtes vers les serveurs OCSP |
|---|---|
| Syntaxe: | SSLStaplingResponderTimeout secondes |
| Défaut: | SSLStaplingResponderTimeout 10 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible si on utilise OpenSSL version 0.9.8h ou supérieure |
Cette directive permet de définir le temps d'attente maximum lorsque
mod_ssl envoie une requête vers un serveur OCSP afin d'obtenir une
réponse destinée à être incluse dans les négociations TLS avec les
clients (SSLUseStapling doit
avoir été activée au préalable).
| Description: | Age maximum autorisé des réponses OCSP incluses dans la négociation TLS |
|---|---|
| Syntaxe: | SSLStaplingResponseMaxAge secondes |
| Défaut: | SSLStaplingResponseMaxAge -1 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible si on utilise OpenSSL version 0.9.8h ou supérieure |
Cette directive permet de définir l'âge maximum autorisé
("fraîcheur") des réponses OCSP incluses dans la négociation TLS
(SSLUseStapling doit
avoir été activée au préalable). La valeur par défaut (-1)
ne définit aucun âge maximum, ce qui signifie que les réponses OCSP sont
considérées comme valides à partir du moment où le contenu de leur champ
nextUpdate se trouve dans le futur.
| Description: | Durée de vie maximale autorisée des réponses OCSP incluses dans la négociation TLS |
|---|---|
| Syntaxe: | SSLStaplingResponseTimeSkew secondes |
| Défaut: | SSLStaplingResponseTimeSkew 300 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible si on utilise OpenSSL version 0.9.8h ou supérieure |
Cette directive permet de spécifier l'intervalle de temps maximum que
mod_ssl va calculer en faisant la différence entre les contenus des
champs nextUpdate et thisUpdate des réponses
OCSP incluses dans la négociation TLS. Pour pouvoir utiliser cette
directive, SSLUseStapling doit
être à "on".
| Description: | Transmet au client les erreurs survenues lors des requêtes OCSP |
|---|---|
| Syntaxe: | SSLStaplingReturnResponderErrors on|off |
| Défaut: | SSLStaplingReturnResponderErrors on |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible si on utilise OpenSSL version 0.9.8h ou supérieure |
Lorsque cette directive est activée, mod_ssl va transmettre au client les
réponses concernant les requêtes OCSP
échouées (comme les réponses avec un statut général autre que
"successful", les réponses avec un statut de certificat autre que
"good", les réponses arrivées à expiration, etc...).
Lorsqu'elle est à off, seules les réponses avec un
statut de certificat égal à "good" seront incluses dans la négociation
TLS.
| Description: | Durée de vie des réponses OCSP dans le cache |
|---|---|
| Syntaxe: | SSLStaplingStandardCacheTimeout secondes |
| Défaut: | SSLStaplingStandardCacheTimeout 3600 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible si on utilise OpenSSL version 0.9.8h ou supérieure |
Cette directive permet de définir la durée de vie des réponses OCSP
dans le cache configuré via la directive SSLStaplingCache. Elle ne s'applique qu'aux
réponse valides, alors que la directive SSLStaplingErrorCacheTimeout s'applique aux
réponses invalides ou non disponibles.
| Description: | Contrôle de l'accès des clients non-SNI à un serveur virtuel à base de nom. |
|---|---|
| Syntaxe: | SSLStrictSNIVHostCheck on|off |
| Défaut: | SSLStrictSNIVHostCheck off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible depuis la version 2.2.12 d'Apache |
Cette directive permet de contrôler l'accès des clients non-SNI à un serveur
virtuel à base de nom. Si elle est définie à on dans le
serveur virtuel à base de nom par défaut, les
clients non-SNI ne seront autorisés à accéder à aucun serveur virtuel
appartenant à cette combinaison IP/port. Par
contre, si elle est définie à on dans un serveur virtuel
quelconque, les clients non-SNI ne se verront interdire l'accès qu'à ce
serveur.
Cette option n'est disponible que si httpd a été compilé avec une version d'OpenSSL supportant SNI.
SSLStrictSNIVHostCheck on
| Description: | Nom de la variable servant à déterminer le nom de l'utilisateur |
|---|---|
| Syntaxe: | SSLUserName nom-var |
| Contexte: | configuration globale, répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_ssl |
Cette variable permet de définir le champ "user" de l'objet de la
requête Apache. Ce champ est utilisé par des modules de plus bas niveau
pour identifier l'utilisateur avec une chaîne de caractères. En
particulier, l'utilisation de cette directive peut provoquer la
définition de la variable d'environnement REMOTE_USER.
La valeur de l'argument nom-var peut correspondre à toute variable d'environnement SSL.
Notez que cette directive est sans effet si l'option
FakeBasicAuth est utilisée (voir SSLOptions).
SSLUserName SSL_CLIENT_S_DN_CN
| Description: | Active l'ajout des réponses OCSP à la négociation TLS |
|---|---|
| Syntaxe: | SSLUseStapling on|off |
| Défaut: | SSLUseStapling off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ssl |
| Compatibilité: | Disponible si on utilise OpenSSL version 0.9.8h ou supérieure |
Cette directive permet d'activer l'"Agrafage OCSP" (OCSP stapling)
selon la définition de l'extension TLS "Certificate Status Request"
fournie dans la RFC 6066. Si elle est activée et si le client le
demande, mod_ssl va inclure une réponse OCSP à propos de son propre
certificat dans la négociation TLS. Pour pouvoir activer l'Agrafage
OCSP, il est nécessaire de configurer un SSLStaplingCache.
L'agrafage OCSP dispense le client de requérir le serveur OCSP
directement ; il faut cependant noter que selon les spécifications de la
RFC 6066, la réponse CertificateStatus du serveur ne peut
inclure une réponse OCSP que pour un seul certificat. Pour les
certificats de serveur comportant des certificats de CA intermédiaires
dans leur chaîne (c'est un cas typique de nos jours), l'implémentation
actuelle de l'agrafage OCSP n'atteint que partiellement l'objectif d'
"économie en questions/réponse et en ressources". Pour plus de détails,
voir la RFC 6961 (TLS
Multiple Certificate Status Extension).
Lorsque l'agrafage OCSP est activé, le mutex
ssl-stapling contrôle l'accès au cache de l'agrafage OCSP
afin de prévenir toute corruption, et le mutex
sss-stapling-refresh contrôle le raffraîchissement des
réponses OCSP. Ces mutex peuvent être configurés via la directive
Mutex.
| Description: | Niveau de vérification du certificat client |
|---|---|
| Syntaxe: | SSLVerifyClient niveau |
| Défaut: | SSLVerifyClient none |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet de définir le niveau de vérification du certificat pour l'authentification du client. Notez que cette directive peut être utilisée à la fois dans les contextes du serveur principal et du répertoire. Dans le contexte du serveur principal, elle s'applique au processus d'authentification du client utilisé au cours de la négociation SSL standard lors de l'établissement d'une connexion. Dans un contexte de répertoire, elle force une renégociation SSL avec le niveau de vérification du client spécifié, après la lecture d'une requête HTTP, mais avant l'envoi de la réponse HTTP.
Les valeurs de niveau disponibles sont les suivantes :
SSLVerifyClient require
| Description: | Profondeur maximale des certificats de CA pour la vérification des certificats clients |
|---|---|
| Syntaxe: | SSLVerifyDepth nombre |
| Défaut: | SSLVerifyDepth 1 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_ssl |
Cette directive permet de spécifier la profondeur maximale à laquelle mod_ssl va effectuer sa vérification avant de décider que le client ne possède pas de certificat valide. Notez que cette directive peut être utilisée à la fois dans les contextes du serveur principal et de répertoire. Dans le contexte du serveur principal, elle s'applique au processus d'authentification du client utilisé au cours de la négociation SSL standard lors de l'établissement d'une connexion. Dans un contexte de répertoire, elle force une renégociation SSL avec le client selon la nouvelle profondeur spécifiée, après la lecture d'une requête HTTP, mais avant l'envoi de la réponse HTTP.
La profondeur correspond au nombre maximum de fournisseurs de
certificats intermédiaires, c'est à dire le nombre maximum de
certificats de CA que l'on est autorisé à suivre lors de la vérification
du certificat du client. Une profondeur de 0 signifie que seuls les
certificats clients auto-signés sont acceptés ; la profondeur par défaut
de 1 signifie que le certificat client peut être soit auto-signé, soit
signé par une CA connue directement du serveur (c'est à dire que le
certificat de la CA doit être référencé par la directive SSLCACertificatePath), etc...
SSLVerifyDepth 10
Apache HTTP Server Version 2.4
| Beschreibung: | Ständig verfügbare Kernfunktionen des Apache HTTP Servers |
|---|---|
| Status: | Core |
AcceptFilter AcceptPathInfo AccessFileName AddDefaultCharset AllowEncodedSlashes AllowOverride AllowOverrideList CGIMapExtension CGIPassAuth CGIVar ContentDigest DefaultRuntimeDir DefaultType Define <Directory> <DirectoryMatch> DocumentRoot <Else> <ElseIf> EnableMMAP EnableSendfile Error ErrorDocument ErrorLog ErrorLogFormat ExtendedStatus FileETag <Files> <FilesMatch> FlushMaxPipelined FlushMaxThreshold ForceType GprofDir HostnameLookups HttpProtocolOptions <If> <IfDefine> <IfDirective> <IfFile> <IfModule> <IfSection> Include IncludeOptional KeepAlive KeepAliveTimeout <Limit> <LimitExcept> LimitInternalRecursion LimitRequestBody LimitRequestFields LimitRequestFieldSize LimitRequestLine LimitXMLRequestBody <Location> <LocationMatch> LogLevel MaxKeepAliveRequests MaxRangeOverlaps MaxRangeReversals MaxRanges MergeSlashes MergeTrailers Mutex NameVirtualHost Options Protocol Protocols ProtocolsHonorOrder QualifyRedirectURL ReadBufferSize RegexDefaultOptions RegisterHttpMethod RLimitCPU RLimitMEM RLimitNPROC ScriptInterpreterSource SeeRequestTail ServerAdmin ServerAlias ServerName ServerPath ServerRoot ServerSignature ServerTokens SetHandler SetInputFilter SetOutputFilter StrictHostCheck TimeOut TraceEnable UNCList UnDefine UseCanonicalName UseCanonicalPhysicalPort <VirtualHost>| Beschreibung: | Konfiguriert Optimierungen für lauschende Sockets bestimmter Protokolle |
|---|---|
| Syntax: | AcceptFilter Protokoll Filter |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Verfügbar ab Apache 2.1.5 |
Diese Direktive aktiviert betriebssystemspezifische Optimierungen
für lauschende Sockets anhand des Protokolltyps. Der grundlegende
Ansatz ist, dass der Kernel das Socket nicht an den Serverprozess
übergibt, bis entweder Daten verfügbar sind oder eine komplette
HTTP-Anfrage zwischengespeichert wurde. Derzeit werden
ausschließlich die Accept-Filter von FreeBSD und das primitivere
TCP_DEFER_ACCEPT von Linux unterstützt.
Die Standardeinstellungen für FreeBSD sind:
AcceptFilter http httpready
AcceptFilter https dataready
Der httpready-Accept-Filter puffert komplette
HTTP-Anfragen auf Kernelebene. Sobald eine Anfrage vollständig
vorliegt, schickt der Kernel sie an den Server weiter. Bitte schlagen Sie
in der accf_http(9)-Manpage für weitere Details nach. HTTPS-Anfragen
sind verschlüsselt. Daher wird dafür nur der accf_data(9)-Filter verwendet.
Die Standardeinstellungen für Linux sind:
AcceptFilter http data
AcceptFilter https data
TCP_DEFER_ACCEPT unter Linux unterstützt keine
Zwischenspeicherung von HTTP-Anfragen. Jeder andere Wert als
none aktiviert TCP_DEFER_ACCEPT auf dem
Lauschsocket. Mehr Details finden Sie in der tcp(7)-Manpage von Linux.
Wenn Sie none als Argument verwenden, werden alle
Accept-Filter für das Protokoll abgeschaltet. Das ist sinnvoll
für Protokolle, bei denen der Server zuerst Daten senden muss,
wie zum Beispiel nntp:
AcceptFilter nttp none
| Beschreibung: | Ressourcen lassen angehängte Pfadangaben zu |
|---|---|
| Syntax: | AcceptPathInfo On|Off|Default |
| Voreinstellung: | AcceptPathInfo Default |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Verfügbar ab Apache 2.0.30 |
Die Direktive steuert, ob Anfragen akzeptiert oder
abgewiesen werden, bei denen nach der tatsächlichen
Datei (oder einer nicht existierenden Datei in einem existierenden
Verzeichnis) zusätzliche Pfadangaben folgen. Die angehängte
Pfadangabe kann Skripten in der Umgebungsvariable PATH_INFO
verfügbar gemacht werden.
Nehmen wir beispielsweise an, dass /test/ auf ein
Verzeichnis zeigt, welches lediglich eine Datei here.html
enthält. Dann wird bei Anfragen nach
/test/here.html/more und
/test/nothere.html/more beides Mal /more
als PATH_INFO ermittelt.
Die drei möglichen Argumente für die Direktive
AcceptPathInfo sind:
Off/test/here.html/more im obigen Beispiel, den Fehler
404 NOT FOUND (Anm.d.Ü.: nicht gefunden)
zurückgeben.On/test/here.html/more wird akzeptiert,
wenn /test/here.html auf eine gültige Datei
zeigt.DefaultPATH_INFO-Zugriffe
standardmäßig zurück. Handler, die Skripte bedienen,
wie z.B. cgi-script und
isapi-handler, sind im Allgemeinen darauf
voreingestellt, PATH_INFO zu akzeptieren.Das eigentliche Ziel von AcceptPathInfo ist es, Ihnen
das Überschreiben der Voreinstellung der Handler bezüglich
der Akzeptanz oder Ablehnung von PATH_INFO zu erlauben.
Eine solche Änderung ist zum Beispiel notwendig, wenn Sie einen
Filter wie INCLUDES verwenden, um Inhalte
abhängig von PATH_INFO zu generieren. Der
Core-Handler würde die Anfrage normalerweise abweisen. Verwenden
Sie die folgende Konfiguration, um dennoch solch ein Skript zu
ermöglichen.
<Files "mypaths.shtml">
Options +Includes
SetOutputFilter INCLUDES
AcceptPathInfo On
</Files>
| Beschreibung: | Name der dezentralen Konfigurationsdateien |
|---|---|
| Syntax: | AccessFileName Dateiname [Dateiname] ... |
| Voreinstellung: | AccessFileName .htaccess |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
Aus dieser Namensliste sucht der Server während der Bearbeitung einer Anfrage in jedem Verzeichnis nach der ersten existierenden Datei, sofern im betreffenden Verzeichnis dezentrale Konfigurationsdateien erlaubt sind. Beispiel:
AccessFileName .acl
Vor der Rücksendung des Dokuments
/usr/local/web/index.html wird der Server
/.acl, /usr/.acl,
/usr/local/.acl und /usr/local/web/.acl
einlesen, solange diese nicht mit
<Directory />
AllowOverride None
</Directory>
deaktiviert wurden.
| Beschreibung: | Standard-Charset-Parameter, der bei Antworten vom Content-Type
text/plain oder text/html hinzugefügt wird
|
|---|---|
| Syntax: | AddDefaultCharset On|Off|Zeichenkodierung |
| Voreinstellung: | AddDefaultCharset Off |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
Die Direktive gibt einen Standardwert für den Charset-Paramter des
Medientyps (den Namen einer Zeichencodierung) an, der einer Antwort
genau dann hinzugefügt wird, wenn der Content-Type der Antwort entweder
text/plain oder text/html ist. Dies sollte jedes
mittels META-Element im Datenteil der Antwort angegebene
Charset überschreiben. Das genaue Verhalten hängt jedoch oft von
der Client-Konfiguration des Benutzers ab. Die Einstellung
AddDefaultCharset Off deaktiviert diese Funktionalität.
AddDefaultCharset On aktiviert die Standard-Zeichenkodierung
iso-8859-1. Jeder andere Wert wird als die zu verwendende
Zeichenkodierung aufgefaßt, die eines der bei IANA registrierten
Charset-Werte zur Verwendung in MIME-Medientypen sein sollte. Zum
Beispiel:
AddDefaultCharset utf-8
AddDefaultCharset sollte nur verwendet werden,
wenn von allen Textressourcen, für die es gilt, bekannt ist, dass sie
in dieser Zeichkodierung vorliegen, oder wenn es zu unbequem ist, ihre
Zeichenkodierung indivuell zu benennen. Ein solches Beispiel ist das
Hinzufügen des Charset-Parameters zu Ressourcen, die generierte
Inhalte enthalten. Ein Beispiel sind CGI-Skript-Altlasten, die aufgrund von
in die Ausgabe integrierten Daten, die durch den Benutzer übermittelt
wurden, gegen Cross-Site-Scripting-Angriffe verwundbar sind. Eine bessere
Lösung wäre jedoch, diese Skripte zu korrigieren (oder zu
löschen), da die Angabe einer Standard-Zeichencodierung keine
Anwender schützt, die in ihrem Browser die Funktion zur
automatischen Erkennung der Zeichenkodierung aktiviert haben.
| Beschreibung: | Legt fest, ob kodierte Pfadtrennzeichen in URLs durchgereicht werden dürfen |
|---|---|
| Syntax: | AllowEncodedSlashes On|Off |
| Voreinstellung: | AllowEncodedSlashes Off |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Verfügbar ab Apache 2.0.46 |
Die AllowEncodedSlashes-Direktive erlaubt die
Verwendung von URLs, welche kodierte Pfadtrennzeichen (%2F
für / und auf entsprechenden Systemen zusätzlich
%5C für \) enthalten. Normalerweise werden
derartige URLs mit einem 404-Fehler (Nicht gefunden) abgewiesen.
AllowEncodedSlashes On ist
vor allem in Verbindung mit PATH_INFO hilfreich.
Das Erlauben von Schrägstrichen impliziert nicht deren
Dekodierung. Vorkommen von %2F oder %5C
(nur auf entsprechenden Systemen) werden unverändert in der
ansonsten dekodierten URL belassen.
| Beschreibung: | Direktiven-Typen, die in .htaccess-Dateien
erlaubt sind. |
|---|---|
| Syntax: | AllowOverride All|None|Direktiven-Typ
[Direktiven-Typ] ... |
| Voreinstellung: | AllowOverride None (2.3.9 und später), AllowOverride All (2.3.8 und früher) |
| Kontext: | Verzeichnis |
| Status: | Core |
| Modul: | core |
Wenn der Server eine .htaccess-Datei (wie durch
AccessFileName definiert)
findet, muss er wissen, welche in der Datei angegebenen Direktiven
frühere Konfigurationsanweisungen überschreiben
dürfen.
AllowOverride ist nur in <Directory>-Abschnitten
gültig, die ohne reguläre Ausdrücke definiert wurden, nicht
in <Location>-,
<DirectoryMatch>- oder
<Files>-Abschnitten.
Wenn diese Anweisung auf None gesetzt wird, dann
werden .htaccess-Dateien komplett
ignoriert. In diesem Fall wird der Server nicht einmal versuchen,
die .htaccess-Dateien im Dateisystem zu lesen.
Wenn diese Anweisung auf All gesetzt wird, dann
ist jede Direktive in den .htaccess-Dateien erlaubt,
die den Kontext
.htaccess besitzt.
Der Direktiven-Typ kann eine der folgenden Anweisungsgruppen sein.
AuthDBMGroupFile,
AuthDBMUserFile,
AuthGroupFile,
AuthName,
AuthType, AuthUserFile, Require usw.).DefaultType, ErrorDocument, ForceType, LanguagePriority,
SetHandler, SetInputFilter, SetOutputFilter, und
mod_mime-Direktiven Add* und Remove*
usw.), Metadaten (Header, RequestHeader, SetEnvIf, SetEnvIfNoCase, BrowserMatch, CookieExpires, CookieDomain, CookieStyle, CookieTracking, CookieName),
mod_rewrite-Direktiven RewriteEngine, RewriteOptions, RewriteBase, RewriteCond, RewriteRule) und
Action aus
mod_actions.
AddDescription,
AddIcon, AddIconByEncoding,
AddIconByType,
DefaultIcon, DirectoryIndex,
FancyIndexing, HeaderName, IndexIgnore, IndexOptions, ReadmeName
usw.).Allow, Deny und Order).Options
und XBitHack). Sie
können mit einem Gleichheitszeichen gefolgt von einer
kommaseparierten Liste (ohne Leerzeichen) angeben, welche Optionen mit
der Options-Direktive gesetzt
werden dürfen.Beispiel:
AllowOverride AuthConfig Indexes
Im obigen Beispiel erzeugen alle Direktiven einen internal server
error (Anm.d.Ü.: Server-interner Fehler), die weder der
Gruppe AuthConfig noch der Gruppe Indexes
angehören.
| Beschreibung: | Individual directives that are allowed in
.htaccess files |
|---|---|
| Syntax: | AllowOverrideList None|directive
[directive-type] ... |
| Voreinstellung: | AllowOverrideList None |
| Kontext: | Verzeichnis |
| Status: | Core |
| Modul: | core |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Technik zur Bestimmung des Interpreters für CGI-Skripte |
|---|---|
| Syntax: | CGIMapExtension CGI-Pfad .Endung |
| Kontext: | Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | ausschließlich NetWare |
Die Direktive wird zur Steuerung verwendet, wie Apache
den Interpreter ermittelt, der zur Ausführung von
CGI-Skripten verwendet wird. Beispielsweise bestimmt die Angabe
von CGIMapExtension sys:\foo.nlm .foo, dass
alle CGI-Scripte mit der Endung .foo an den
FOO-Interpreter übergeben werden.
| Beschreibung: | Enables passing HTTP authorization headers to scripts as CGI variables |
|---|---|
| Syntax: | CGIPassAuth On|Off |
| Voreinstellung: | CGIPassAuth Off |
| Kontext: | Verzeichnis, .htaccess |
| AllowOverride: | AuthConfig |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in Apache HTTP Server 2.4.13 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Controls how some CGI variables are set |
|---|---|
| Syntax: | CGIVar variable rule |
| Kontext: | Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in Apache HTTP Server 2.4.21 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Aktiviert die Generierung von Content-MD5
HTTP-Response-Headern |
|---|---|
| Syntax: | ContentDigest On|Off |
| Voreinstellung: | ContentDigest Off |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | Options |
| Status: | Core |
| Modul: | core |
Die Direktive aktiviert die Generierung von
Content-MD5-Headern, wie sie in RFC1864 bzw. RFC2616
definiert sind.
MD5 ist ein Algorithmus zur Berechnung eines "Datenextrakts" (zuweilen "Fingerabdruck" genannt) (Anm.d.Ü.: Der "Datenextrakt" wird im Englischen als "message digest" oder "fingerprint" bezeichnet.) aus beliebig langen Daten. Es gilt als zuverlässig, dass Veränderungen an den Daten sich in Veränderungen des Extrakts wiederspiegeln.
Der Content-MD5-Header bietet eine
End-to-End-Integritätsprüfung (MIC) (Anm.d.Ü.: MIC steht für
"message integrity check".) des Daten-Inhalts. Ein Proxy oder
Client kann diesen Header prüfen, um zufällige Veränderungen
des Entity-Inhalts bei der Übertragung festzustellen.
Beispielheader:
Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
Beachten Sie bitte, dass dies Performanceprobleme auf Ihrem System verursachen kann, da der Extrakt bei jeder Anfrage berechnet wird (der Wert wird nicht zwischengespeichert).
Content-MD5 wird nur für Dokumente gesendet,
die von core bedient werden, nicht jedoch bei
Modulen. SSI-Dokumente, CGI-Skript-Ausgaben und Byte-Range-Antworten
besitzen diesen Header beispielsweise nicht.
| Beschreibung: | Base directory for the server run-time files |
|---|---|
| Syntax: | DefaultRuntimeDir directory-path |
| Voreinstellung: | DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/) |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in Apache 2.4.2 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
ServerRoot| Beschreibung: | MIME-Content-Type, der gesendet wird, wenn der Server den Typ nicht auf andere Weise ermitteln kann. |
|---|---|
| Syntax: | DefaultType MIME-Type |
| Voreinstellung: | DefaultType text/plain |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
Es kann vorkommen, dass der Server ein Dokument ausliefern muss, dessen Typ er nicht mit Hilfe seiner MIME-Type-Zuordnungen bestimmen kann.
Der Server muss den Client über den Content-Type des
Dokumentes informieren. Daher verwendet er im Falle eines
unbekannten Typs die DefaultType-Einstellung.
Zum Beispiel:
DefaultType image/gif
wäre angemessen für ein Verzeichnis, das viele GIF-Bilder
enthält, deren Dateinamen nicht Endung .gif
besitzen.
Beachten Sie bitte, dass die Direktive anders als ForceType lediglich den Standard-MIME-Type
bestimmt. Alle anderen MIME-Type-Definitionen, einschließlich
Dateierweiterungen, die den Medien-Typ anzeigen können,
überschreiben diese Voreinstellung.
| Beschreibung: | Define the existence of a variable |
|---|---|
| Syntax: | Define Parametername |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
Equivalent zum übergeben von Parametername mittels des
-D Arguments an httpd.
Diese Directive kann verwendet werden, um die Nutzung von <IfDefine> Sectionen umzuschalten, ohne die
-D Argumentente in etwaigen Start-Skripten ändern
zu müssen.
| Beschreibung: | Umschließt eine Gruppe von Direktiven, die nur auf das genannte Verzeichnis des Dateisystems und Unterverzeichnisse angewendet werden |
|---|---|
| Syntax: | <Directory Verzeichnispfad>
... </Directory> |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
<Directory> und
</Directory> werden dazu verwendet, eine Gruppe
von Direktiven zusammenzufassen, die nur für das genannte
Verzeichnis und dessen Unterverzeichnisse gelten. Jede Direktive,
die im Verzeichnis-Kontext erlaubt ist, kann verwendet werden.
Verzeichnispfad ist entweder der vollständige Pfad zu
einem Verzeichnis oder eine Zeichenkette mit Platzhaltern wie sie von der
Unix-Shell zum Abgleich verwendet werden. In einer Zeichenkette
mit Platzhaltern (Anm.d.Ü.: sogenannte wild-cards) entspricht
? einem einzelnen Zeichen und * einer
Zeichenkette beliebiger Länge. Sie können auch auch
[]-Zeichenbereiche verwenden. Keiner der Platzhalter
entspricht dem Zeichen "/". Daher passt <Directory
/*/public_html> nicht auf /home/user/public_html,
<Directory /home/*/public_html> jedoch tut es.
Beispiel:
<Directory /usr/local/httpd/htdocs>
Options Indexes FollowSymLinks
</Directory>
Seien Sie vorsichtig mit den Verzeichnispfad-Argumenten. Sie müssen buchstäblich mit dem Dateisystempfad übereinstimmen, den der Apache für den Zugriff auf die Dateien verwendet. Direktiven, die für ein bestimmtes Verzeichnis gelten, gelten nicht für Dateien in dem Verzeichnis, auf die über einen anderen Pfad zugegriffen wird, wie z.B. über verschiedene symbolische Links.
Erweiterte reguläre Ausdrücke können ebenfalls
verwendet werden, indem das Zeichen ~ hinzugefügt
wird. Beispielsweise würde
<Directory ~ "^/www/.*/[0-9]{3}">
auf Verzeichnisse in /www/ passen, die aus drei
Zahlen bestehen.
Wenn mehrere <Directory>-Abschnitte
(ohne reguläre Ausdrücke) auf ein Verzeichnis (oder
ein ihm übergeordnetes Verzeichnis) passen, welches ein Dokument
enthält, dann werden die Direktiven der Reihe nach, angefangen
beim kürzesten passenden Muster, vermischt mit den Direktiven
aus den .htaccess-Dateien, angewendet.
Beispiel:
<Directory />
AllowOverride None
</Directory>
<Directory /home/>
AllowOverride FileInfo
</Directory>
Beim Zugriff auf das Dokument /home/web/dir/doc.html
sind die einzelnen Schritte:
AllowOverride None an
(deaktiviere .htaccess-Dateien).AllowOverride FileInfo
(auf das Verzeichnis /home) an.FileInfo-Direktive aus
/home/.htaccess, /home/web/.htaccess und
/home/web/dir/.htaccess der Reihe nach an.Reguläre Ausdrücke werden solange nicht berücksichtigt, bis alle normalen Abschnitte angewendet wurden. Anschließend werden alle regulären Ausdrücke in der Reihenfolge geprüft, in der sie in der Konfigurationsdatei auftauchen. Beispielsweise wird bei
<Directory ~ abc$>
# ... hier die Direktiven ...
</Directory>
der Abschnitt mit dem regulären Ausdruck nicht
berücksichtigt, bis alle normalen
<Directory>-Abschnitte und
.htaccess-Dateien angewendet wurden. Dann erst wird
der reguläre Ausdruck mit /home/abc/public_html/abc
abgeglichen und der entsprechende <Directory>-Abschnitt angewendet.
Beachten Sie bitte, dass der vom Apache voreingestellte
Zugriff für <Directory />
Allow from All ist. Das bedeutet, dass der Apache
jede Datei ausliefert, die durch eine URL abgebildet wird. Es wird
empfohlen, dass Sie dies durch einen Block wie
<Directory />
Order Deny,Allow
Deny from All
</Directory>
ändern und anschließend für Verzeichnisse überschreiben, die Sie verfügbar machen wollen. Für weitere Einzelheiten lesen Sie bitte die Seite zu den Sicherheitshinweisen.
Die Verzeichnisabschnitte erscheinen in der Datei
httpd.conf. <Directory>-Direktiven dürfen nicht
ineinander verschachtelt werden oder innerhalb von <Limit>- oder <LimitExcept>-Abschnitten auftauchen.
| Beschreibung: | Umschließt eine Gruppe von Direktiven, die auf Verzeichnisse des Dateisystems und ihre Unterverzeichnisse abgebildet werden, welche auf einen regulären Ausdruck passen |
|---|---|
| Syntax: | <DirectoryMatch regex>
... </DirectoryMatch> |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
<DirectoryMatch> und
</DirectoryMatch> werden dazu verwendet, eine
Gruppe von Direktiven zusammenzufassen, die nur für das
genannte Verzeichnis und dessen Unterverzeichnisse gelten, genauso
wie bei <Directory>.
Als Argument dient jedoch ein regulärer
Ausdruck. Beispielsweise würde
<DirectoryMatch "^/www/.*/[0-9]{3}">
auf Verzeichnisse in /www/ passen, die aus drei
Zeichen bestehen.
<Directory>
für eine Beschreibung, wie reguläre Ausdrücke mit
normalen <Directory>-Anweisungen
vermischt werden.| Beschreibung: | Verzeichnis, welches den Haupt-Dokumentenbaum bildet, der im Web sichtbar ist. |
|---|---|
| Syntax: | DocumentRoot Verzeichnis |
| Voreinstellung: | DocumentRoot /usr/local/apache/htdocs |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
Die Direktive setzt das Verzeichnis, von dem aus
httpd Dateien ausliefert. Sofern nicht eine Direktive
wie Alias greift, hängt
der Server Pfade aus der angeforderten URL an das Wurzelverzeichnis
an, um den Pfad zum Dokument zu bilden. Beispiel:
DocumentRoot /usr/web
Damit bezieht sich ein Zugriff auf
http://www.my.host.com/index.html auf
/usr/web/index.html. Wenn das Verzeichnis nicht
absolut angegeben ist, wird es relativ zu ServerRoot betrachtet.
DocumentRoot sollte ohne einen
Schrägstrich am Ende angegeben werden.
| Beschreibung: | Contains directives that apply only if the condition of a
previous <If> or
<ElseIf> section is not
satisfied by a request at runtime |
|---|---|
| Syntax: | <Else> ... </Else> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Nested conditions are evaluated in 2.4.26 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
<If><ElseIf><If>,
<ElseIf>, and
<Else> are applied last.| Beschreibung: | Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
<If> or
<ElseIf> section is not
satisfied |
|---|---|
| Syntax: | <ElseIf expression> ... </ElseIf> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Nested conditions are evaluated in 2.4.26 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
<If><Else><If>,
<ElseIf>, and
<Else> are applied last.| Beschreibung: | Verwende Memory-Mapping, um Dateien während der Auslieferung zu lesen |
|---|---|
| Syntax: | EnableMMAP On|Off |
| Voreinstellung: | EnableMMAP On |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
Die Direktive steuert, ob httpd Memory-Mapping
verwenden darf, wenn er während der Auslieferung den Inhalt einer
Datei lesen muss. Wenn die Bearbeitung einer Anfrage es erfordert,
auf die Daten in einer Datei zuzugreifen -- zum Beispiel bei der
Auslieferung einer mittels mod_include serverseitig
analysierten Datei --, dann verwendet der Apache standardmäßig
Memory-Mapping für diese Datei, sofern das Betriebssystem es
unterstützt.
Memory-Mapping bedeutet zuweilen eine Performanceverbesserung. In einigen Umgebungen ist es jedoch besser, Memory-Mapping zu deaktivieren, um Problemen während des Betriebs vorzubeugen:
httpd reduzieren.DocumentRoot kann httpd mit
einem Speicherzugriffsfehler (Anm.d.Ü.: ein so genannter "segmentation
fault") abstürzen, wenn eine Datei gelöscht oder
gekürzt wird, während httpd sie im Speicher
abbildet.Bei Serverkonfigurationen, die für dieses Problem anfällig sind, sollten Sie das Memory-Mapping für auszuliefernde Dateien deaktivieren, indem Sie schreiben:
EnableMMAP Off
Bei per NFS eingebundenen Dateien kann diese Funktion explizit für die störenden Dateien deaktiviert werden, indem Sie angeben:
<Directory "/pfad-zu-den-nfs-dateien">
EnableMMAP Off
</Directory>
| Beschreibung: | Verwende die sendfile-Unterstützung des Kernels, um Dateien an den Client auszuliefern |
|---|---|
| Syntax: | EnableSendfile On|Off |
| Voreinstellung: | EnableSendfile On |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Verfügbar ab Apache Version 2.0.44 |
Die Direktive steuert, ob httpd die
sendfile-Unterstützung des Kernels verwenden kann, um
Dateiinhalte an den Client zu übermitteln. Wenn die Bearbeitung
einer Anfrage keinen Zugriff auf die Daten in der Datei erfordert --
zum Beispiel bei der Auslieferung einer statischen Datei -- und das
Betriebssystem es unterstützt, verwendet der Apache
standardmäßig sendfile, um den Dateiinhalt zu
übertragen, ohne die Datei jemals zu lesen.
Der sendfile-Mechanismus vermeidet getrennte Lese- und Sendeoperationen sowie Puffer-Zuweisungen. Bei einigen Plattformen bzw. Dateisystemen deaktivieren Sie diese Funktion jedoch besser, um Probleme während des Betriebs zu vermeiden:
DocumentRoot (z.B. NFS oder SMB) ist der
Kernel möglicherweise nicht in der Lage, die Netzwerkdatei
über seinen eigenen Cache zu bedienen.sendfile
in Verbindung mit bestimmten Netzwerkkarten und IPv6
TCP-Checksummenfehler aus.Bei Serverkonfigurationen, die für dieses Problam anfällig sind, sollten die diese Funktion deaktivieren, indem Sie schreiben:
EnableSendfile Off
Bei per NFS oder SMB eingebundenen Dateien kann diese Funktion explizit für die störenden Dateien deaktiviert werden, indem Sie angeben:
<Directory "/pfad-zu-den-nfs-dateien">
EnableSendfile Off
</Directory>
Beachten Sie bitte, dass die verzeichnisbasierte und
.htaccess-Konfiguration von EnableSendfile
nicht vom mod_cache_disk-Modul unterstützt wird.
Nur die globale Konfiguration von EnableSendfile
wird vom Modul beachtet.
| Beschreibung: | Abort configuration parsing with a custom error message |
|---|---|
| Syntax: | Error message |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | 2.3.9 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Das, was der Server im Fehlerfall an den Client zurückgibt |
|---|---|
| Syntax: | ErrorDocument Fehlercode Dokument |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Die Syntax der Anführungszeichen bei Textnachrichten hat sich im Apache 2.0 geändert |
Im Falle eines Problems oder Fehlers kann der Apache konfiguriert werden, eine der vier Aktionen auszuführen:
Die erste Option ist Voreinstellung, während die Optionen
2 bis 4 über die Direktive ErrorDocument
eingestellt werden, welcher der HTTP-Statuscode und eine
URL oder Nachricht folgen. Abhängig vom Problem bzw. Fehler bietet
der Apache manchmal zusätzliche Informationen an.
URLs können bei lokalen Webpfaden mit einem Schrägstrich
(/) beginnen (relativ zum DocumentRoot-Verzeichnis) oder eine vollständige URL
bilden, die der Client auflösen kann. Alternativ kann eine
Nachricht für die Anzeige im Browser angeboten werden. Beispiel:
ErrorDocument 500 http://foo.example.com/cgi-bin/tester
ErrorDocument 404 /cgi-bin/falsche_urls.pl
ErrorDocument 401 /info_zur_anmeldung.html
ErrorDocument 403 "Der Zugriff ist nicht erlaubt."
Außerdem kann der spezielle Wert default angegeben
werden, um die schlichte, hartkodierte Nachricht des Apache zu verwenden.
Es wird normalerweise nicht benötigt, doch default
stellt die einfach, im Apache hartkodierte Meldung in Konfigurationen
wieder her, die ansonsten von einem existierenden (Anm.d.Ü.: zuvor
konfigurierten) ErrorDocument erben
würden.
ErrorDocument 404 /cgi-bin/bad_urls.pl
<Directory /web/docs>
ErrorDocument 404 default
</Directory>
Wenn Sie eine ErrorDocument-Anweisung
angeben, die auf eine entfernte URL weist (d.h. irgendetwas mit der
Methode http davor), beachten Sie bitte, dass der Apache
eine Umleitung zum Client sendet, um diesem mitzuteilen, wo das
Dokument zu finden ist, auch wenn das Dokument letztlich wieder zum
gleichen Server führt. Das hat mehrere Auswirkungen. Die
wichtigste ist, dass der Client nicht den Original-Statuscode
erhält sondern statt dessen einen Umleitungs-Statuscode. Dies
wiederum kann Web-Robots und andere Clients verwirren, die den
Statuscode dazu verwenden, herauszufinden ob eine URL gültig ist.
Wenn Sie eine entfernte URL in einer Anweisung
ErrorDocument 401 verwenden, wird der Client
darüber hinaus nicht wissen, dass er den Benutzer zur Eingabe
eines Passwortes auffordern muss, da er den Statuscode 401 nicht
erhält. Deshalb müssen Sie sich auf ein lokales
Dokument beziehen, wenn Sie eine Anweisung ErrorDocument
401 verwenden.
Der Microsoft Internet Explorer (MSIE) ignoriert standardmäßig serverseitig generierte Fehlermeldungen, wenn sie "zu kurz" sind und ersetzt sie durch eigene "freundliche" Fehlermeldungen. Die Größe variiert abhängig von der Art des Fehlers, im Allgemeinen zeigt der MSIE jedoch den serverseitig generierten Fehler, anstatt ihn zu verstecken, wenn Ihr Fehlerdokument größer als 512 Bytes ist. Weitere Informationen sind im Artikel Q294807 in der Microsoft Knowledgebase verfügbar.
Obwohl die meisten Fehlermeldungen überschrieben werden
können, werden unter bestimmten Umständen die internen
Meldungen ungeachtet der Einstellung der ErrorDocument-Direktive verwendet. Insbesondere bei
einer fehlerhaften Anfrage werden der normale Bearbeitungsprozess sofort
beendet und die interne Meldung zurückgegeben. Das ist notwendig, um
Sicherheitsprobleme zu vermeiden, die auf Grund fehlerhafter Anfragen
entstehen.
In Versionen vor 2.0 wurden Meldungen durch ein einzelnes vorangestelltes Anführungszeichen (") erkannt.
| Beschreibung: | Ablageort, an dem der Server Fehler protokolliert |
|---|---|
| Syntax: | ErrorLog Dateiname|syslog[:facility] |
| Voreinstellung: | ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and
OS/2) |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
Die Direktive ErrorLog bestimmt den Namen
der Datei, in welcher der Server alle auftretenden Fehler protokolliert.
Wenn Dateiname nicht absolut ist, wird er relativ zu ServerRoot betrachtet.
ErrorLog /var/log/httpd/error_log
Wenn der Dateiname mit einem senkrechten Strich (|, engl.: Pipe) beginnt, wird angenommen, dass es sich um einen Befehl handelt, der ausgeführt wird, um das Fehlerprotokolls zu verarbeiten.
ErrorLog "|/usr/local/bin/httpd_errors"
Die Verwendung von syslog anstelle eines Dateinamens
aktiviert die Protokollierung mittels syslogd(8), sofern das System
es unterstützt. Als Voreinstellung wird der syslog-Typ (syslog
facility) local7 verwendet, Sie können dies jedoch
auch überschreiben, indem Sie die Syntax
syslog:facility verwenden, wobei
facility einer der Namen sein kann, die üblicherweise
in syslog(1) dokumentiert sind.
ErrorLog syslog:user
SICHERHEITSHINWEIS: Lesen Sie das Dokument Sicherheitshinweise zu Einzelheiten darüber, warum Ihre Sicherheit gefährdet sein kann, wenn das Verzeichnis, in dem die Log-Dateien gespeichert werden, für jemand anderen, als den Benutzer, der den Server gestartet hat, beschreibbar ist.
Bei der Eingabe eines Dateipfads auf nicht-Unix-Plattformen sollte darauf geachtet werden, nur (Vorwärts-)Schrägstriche zu verwenden, auch wenn die Plattform rückwärts gerichtete Schrägstriche (Backslashes) erlaubt. Im Allgemeinen ist es eine gute Idee, innerhalb der Konfigurationsdateien immer Vorwärts-Schrägstriche zu verwenden.
| Beschreibung: | Format specification for error log entries |
|---|---|
| Syntax: | ErrorLogFormat [connection|request] format |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Keep track of extended status information for each request |
|---|---|
| Syntax: | ExtendedStatus On|Off |
| Voreinstellung: | ExtendedStatus Off[*] |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Dateiattribute, die zur Erstellung des HTTP-Response-Headers ETag verwendet werden |
|---|---|
| Syntax: | FileETag Komponente ... |
| Voreinstellung: | FileETag INode MTime Size |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
Wenn dem Dokument eine Datei zugrundeliegt, bestimmt die Direktive
FileETag die Dateiattribute, die zur Erstellung
des HTTP-Response-Headers ETag (Entity-Tag) verwendet
werden. (Der Wert von ETag wird bei der Cache-Verwaltung
zur Einsparung von Netzwerk-Bandbreite benutzt.) Im Apache 1.3.22 und
früher wurde der ETag-Wert stets aus
der I-Node, der Größe und dem Datum der letzten
Änderung (mtime) der Datei gebildet. Die Direktive
FileETag erlaubt es Ihnen, zu bestimmen,
welche dieser Eigenschaften -- falls überhaupt -- verwendet
werden sollen. Die gültigen Schlüsselworte lauten:
FileETag INode MTime Size
ETag-Angabe in die Antwort eingefügt,
wenn dem Dokument eine Datei zugrundeliegt.Den Schlüsselwörtern INode, MTime
und Size kann entweder ein + oder ein
- vorangestellt werden, was die Änderung einer
Vorgabe erlaubt, die von einem größeren Umfeld
geerbt wurde. Jedes Schlüselwort ohne ein solches Prefix
hebt die ererbte Einstellung sofort und vollständig auf.
Wenn die Konfiguration für ein Verzeichnis
FileETag INode MTime Size enthält
und die eines Unterverzeichnisses FileETag -INode,
dann ist die Einstellung für das Unterverzeichnis (die an
jedes Unter-Unterverzeichnis weitervererbt wird, welches dies nicht
überschreibt) äquivalent mit
FileETag MTime Size.
| Beschreibung: | Enthält Direktiven, die sich nur auf passende Dateinamen beziehen |
|---|---|
| Syntax: | <Files Dateiname> ... </Files> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
Die Direktive <Files>
begrenzt die Reichweite der enthaltenen Anweisungen auf Dateinamen.
Sie ist vergleichbar mit den Direktiven <Directory> und <Location>. Sie muss eine
passende </Files>-Anweisung besitzen.
Die innerhalb dieses Abschnittes angegebenen Direktiven werden auf
jedes Objekt mit einem Basisnamen (letzte Komponente des Dateinamens)
angewendet, der auf die angegebenen Dateinamen passt. <Files>-Container werden, nachdem die
<Directory>-Container
und .htaccess-Dateien gelesen sind, jedoch vor den
<Location>-Containern,
in der Reihenfolge ihres Auftretens ausgeführt. Beachten Sie, dass
<Files>-Anweisungen innerhalb von
<Directory>-Containern
auftreten können, um den Teil des Dateisystems einzuschränken,
den sie betreffen.
Das Argument Dateiname kann einen Dateinamen oder eine
Zeichenkette mit Platzhaltern enthalten, wobei ? auf ein
einzelnes Zeichen passt und * auf eine beliebige Folge von
Zeichen. Erweiterte reguläre
Ausdrücke können ebenfalls verwendet werden, indem
das Zeichen ~ hinzugefügt wird. Beispielsweise
würde
<Files ~ "\.(gif|jpe?g|png)$">
auf die gebräuchlichsten Grafikformate im Internet passen.
<FilesMatch> wird
jedoch bevorzugt.
Beachten Sie bitte, dass die <Files>-Container anders als <Directory>- und <Location>-Container innerhalb
von .htaccess-Dateien verwendet werden können.
Dies erlaubt den Anwendern auf Dateiebene die Kontrolle über ihre
eigenen Dateien.
| Beschreibung: | Enthält Direktiven, die für Dateinamen gelten, die auf einen regulären Ausdruck passen |
|---|---|
| Syntax: | <FilesMatch regex> ... </FilesMatch> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
Die Direktive <FilesMatch>
begrenzt wie die Direktive <Files> die enthaltenen Anweisungen auf
Dateinamen. Sie akzeptiert jedoch reguläre
Ausdrücke. Beispielsweise würde
<FilesMatch "\.(gif|jpe?g|png)$">
auf die gebräuchlichsten Grafikformate im Internet passen.
| Beschreibung: | Maximum number of pipelined responses above which they are flushed to the network |
|---|---|
| Syntax: | FlushMaxPipelined number |
| Voreinstellung: | FlushMaxPipelined 5 |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | 2.4.47 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Threshold above which pending data are flushed to the network |
|---|---|
| Syntax: | FlushMaxThreshold number-of-bytes |
| Voreinstellung: | FlushMaxThreshold 65535 |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | 2.4.47 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Erzwingt die Auslieferung aller passendenden Dateien mit dem angegebenen MIME-Content-Type |
|---|---|
| Syntax: | ForceType MIME-Type|None |
| Kontext: | Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Wurde im Apache 2.0 in den Core verschoben |
Wenn sie innerhalb einer .htaccess-Datei, eines
<Directory>-,
<Location>-
<Files>-Containers
angegeben wird, erzwingt die Direktive die Auslieferung aller
entsprechenden Dateien mit dem Content-Type, der durch
MIME-Type definiert wurde. Wenn Sie zum Beispiel ein
Verzeichnis voller GIF-Dateien haben, die Sie nicht alle durch
.gif kennzeichnen wollen, können Sie angeben:
ForceType image/gif
Beachten Sie bitte, dass die Direktive anders als DefaultType alle MIME-Type-Zuordnungen
überschreibt, einschließlich Dateiendungen, die einen
Medientyp bezeichnen könnten.
Sie können jede ForceType-Angabe
durch die Verwendung des Wertes None überschreiben:
# erzwinge image/gif für alle Dateien:
<Location /images>
ForceType image/gif
</Location>
# hier jedoch normale MIME-Type-Zuordnungen:
<Location /images/mixed>
ForceType None
</Location>
| Beschreibung: | Directory to write gmon.out profiling data to. |
|---|---|
| Syntax: | GprofDir /tmp/gprof/|/tmp/gprof/% |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Aktiviert DNS-Lookups auf Client-IP-Adressen |
|---|---|
| Syntax: | HostnameLookups On|Off|Double |
| Voreinstellung: | HostnameLookups Off |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
| Status: | Core |
| Modul: | core |
Diese Direktive aktiviert die DNS-Abfrage (Anm.d.Ü.: ein sogenannter
DNS-Lookup), so dass Hostnamen protokolliert (und in
REMOTE_HOST an CGIs/SSIs übergeben) werden könnnen.
Der Wert Double bezieht sich auf ein
Double-Reverse-DNS-Lookup. D.h. nachdem ein Reverse-Lookup
durchgeführt wurde, wird dann auf dem Ergebnis ein
Forward-Lookup ausgeführt. Wenigstens eine der IP-Adressen
aus dem Forward-Lookup muss der Originaladresse entsprechen.
(In der "tcpwrappers"-Terminologie wird dies PARANOID
genannt.)
Unabhängig von der Einstellung wird ein Double-Reverse-Lookup
durchgeführt, wenn mod_authz_host zur
Zugriffskontrolle per Hostnamen eingesetzt wird. Dies ist aus
Sicherheitsgründen notwendig. Beachten Sie, dass das Ergebnis dieses
Double-Reverse-Lookups nicht generell verfügbar ist, solange Sie
nicht HostnameLookups Double setzen. Wenn beispielsweise
nur HostnameLookups On angegeben ist und eine Anfrage
für ein Objekt erfolgt, welches durch Hostnamen-Beschränkungen
geschützt ist, dann wird CGIs nur das Ergebnis des
Singel-Reverse-Lookups in REMOTE_HOST übergeben,
egal ob das Doble-Reverse-Lookup fehlschlug oder nicht.
Die Voreinstellung ist Off, um Netzwerktraffic bei den
Angeboten einzusparen, die nicht tatsächlich Reverse-Lookups
benötigen. Es ist auch für die Endanwender besser, da sie nicht
die zusätzliche Wartezeit ertragen müssen, die ein Lookup mit
sich bringt. Hoch frequentierte Angebote sollten diese Direktive auf
Offlassen. Das Hilfsprogramm logresolve, das standardmäßig in das
Unterverzeichnis bin Ihres Installationsverzeichnisses
kompiliert wird, kann dazu verwendet werden, um offline Hostnamen von
protokollierten IP-Adressen nachzuschlagen.
| Beschreibung: | Modify restrictions on HTTP Request Messages |
|---|---|
| Syntax: | HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods]
[Allow0.9|Require1.0] |
| Voreinstellung: | HttpProtocolOptions Strict LenientMethods Allow0.9 |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | 2.2.32 or 2.4.24 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Contains directives that apply only if a condition is satisfied by a request at runtime |
|---|---|
| Syntax: | <If expression> ... </If> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Nested conditions are evaluated in 2.4.26 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
<ElseIf><Else><If>,
<ElseIf>, and
<Else> are applied last.| Beschreibung: | Schließt Direktiven ein, die nur ausgeführt werden, wenn eine Testbedingung beim Start wahr ist |
|---|---|
| Syntax: | <IfDefine [!]Parametername> ...
</IfDefine> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
Der Container <IfDefine Test>...</IfDefine>
wird dazu verwendet, Direktiven als bedingt zu kennzeichnen.
Die Direktiven innerhalb eines <IfDefine>-Abschnittes werden nur ausgeführt,
wenn Test wahr ist. Ist Test falsch, wird alles
zwischen der Start- und Endemarkierung ignoriert.
In der <IfDefine>-Anweisung kann
Test eine von zwei Formen annehmen:
!ParameternameIm ersten Fall werden die Direktiven zwischen der Start- und Endemarkierung nur ausgeführt, wenn der Parameter namens Parametername definiert ist. Die zweite Form kehrt den Test um und führt die Direktiven nur dann aus, wenn Parametername nicht definiert ist.
Das Argument Parametername ist ein sogenanntes
"Define", das beim beim Start des Servers in der
httpd-Befehlszeile durch
-DParameter angegeben wird.
<IfDefine>-Container können
ineinander verschachtelt werden, um einfache Multi-Parameter-Tests
zu implementieren. Beispiel:
httpd -DReverseProxy ...
# httpd.conf
<IfDefine ReverseProxy>
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule proxy_module modules/libproxy.so
</IfDefine>
| Beschreibung: | Encloses directives that are processed conditional on the presence or absence of a specific directive |
|---|---|
| Syntax: | <IfDirective [!]directive-name> ...
</IfDirective> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in 2.4.34 and later. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Encloses directives that will be processed only if file exists at startup |
|---|---|
| Syntax: | <IfFile [!]filename> ...
</IfFile> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in 2.4.34 and later. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Schließt Direktiven ein, die abhängig vom Vorhandensein oder Fehlen eines speziellen Moduls ausgeführt werden |
|---|---|
| Syntax: | <IfModule [!]Modulname|Modulbezeichner>
... </IfModule> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Modulbezeichner sind ab Version 2.1 verfügbar. |
Der Container <IfModule
Test>...</IfModule> wird dazu verwendet,
Direktiven als abhängig von dem Vorhandensein eines speziellen
Moduls zu kennzeichnen. Die Direktiven innerhalb eines <IfModule>-Abschnitts werden nur
ausgeführt, wenn Test wahr ist. Ist Test
falsch, wird alles zwischen der Start- und Endemarkierung ignoriert.
In der <IfModule>-Anweisung
kann Test eine von zwei Formen annehmen:
!ModulIm ersten Fall werden die Direktiven zwischen der Start- und
Endemarkierung nur ausgeführt, das Modul namens
Modul im Apache enthalten ist -- entweder einkompiliert
oder mittels LoadModule
dynamisch geladen. Die zweite Form dreht den Test um und führt die
Direktiven nur aus, wenn Modul nicht
enthalten ist.
Das Argument Modul kann entweder der Modulbezeichner oder
der Dateiname des Moduls zum Zeitpunkt seiner Kompilierung sein.
rewrite_module beispielsweise ist der Bezeichner und
mod_rewrite.c ist der Dateiname. Wenn ein Modul aus mehreren
Quelltext-Dateien besteht, verwenden Sie den Namen der Datei, welche die
Zeichenfolge STANDARD20_MODULE_STUFF enthält.
<IfModule>-Container können
inneinander verschachtelt werden, um einfache Multi-Modul-Tests
durchzuführen.
Dieser Container sollte verwendet werden, wenn Sie eine
Konfigurationsdatei benötigen, die unabhängig davon funktioniert,
ob ein bestimmtes Modul verfügbar ist oder nicht. Normalerweise
ist es nicht notwendig, Direktiven in <IfModule>-Containern unterzubringen.
| Beschreibung: | Encloses directives that are processed conditional on the presence or absence of a specific section directive |
|---|---|
| Syntax: | <IfSection [!]section-name> ...
</IfSection> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in 2.4.34 and later. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Fügt andere Konfigurationsdateien innerhalb der Server-Konfigurationsdatei ein |
|---|---|
| Syntax: | Include Dateiname|Verzeichnis |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Die Platzhalter-Suche ist verfügbar seit 2.0.41 |
Die Direktive erlaubt das Einfügen anderer Konfigurationsdateien in die Konfigurationsdatei des Servers.
Shell-typische (fnmatch()) Platzhlaterzeichen können
dazu verwendet werden, mehrere Dateien auf einmal in alphabetischer
Reihenfolge einzufügen. Wenn Include
darüber hinaus auf ein Verzeichnis anstatt auf eine Datei zeigt,
liest der Apache alle Dateien in diesem Verzeichnis und allen
Unterverzeichnissen ein. Das Einfügen ganzer Verzeichnisse ist
jedoch nicht empfehlenswert, da temporäre Dateien sehr leicht
versehentlich in einem Verzeichnis zurückgelassen werden, was
httpd scheitern lassen kann.
Der angegebene Dateiname kann ein absoluter Pfad sein oder relativ zum
ServerRoot-Verzeichnis angegeben
werden.
Beispiele:
Include /usr/local/apache2/conf/ssl.conf
Include /usr/local/apache2/conf/vhosts/*.conf
Oder Sie geben Pfade relativ zu Ihrem ServerRoot-Verzeichnis an:
Include conf/ssl.conf
Include conf/vhosts/*.conf
Der Aufruf von apachectl configtest liefert eine Liste
der Dateien, die während des Konfigurations-Tests verarbeitet
werden:
root@host# apachectl configtest
Processing config file: /usr/local/apache2/conf/ssl.conf
Processing config file: /usr/local/apache2/conf/vhosts/vhost1.conf
Processing config file: /usr/local/apache2/conf/vhosts/vhost2.conf
Syntax OK
| Beschreibung: | Includes other configuration files from within the server configuration files |
|---|---|
| Syntax: | IncludeOptional file-path|directory-path|wildcard |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in 2.3.6 and later. Not existent file paths without wildcards do not cause SyntaxError after 2.4.30 |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Aktiviert persistente HTTP-Verbindungen |
|---|---|
| Syntax: | KeepAlive On|Off |
| Voreinstellung: | KeepAlive On |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
Die Keep-Alive-Erweiterung von HTTP/1.0 und die
HTTP/1.1-Funktionalität persistenter Verbindungen unterstützt
langlebige HTTP-Sitzungen, die es erlauben, mehrere Anfragen über
die gleich TCP-Verbindung zu senden. In einigen Fällen wurde eine
Beschleunigung der Wartezeiten von beinahe 50% für HTML-Dokumente
mit vielen Bildern festgestellt. Um Keep-Alive-Verbindungen zu aktivieren,
setzen Sie KeepAlive On.
Bei HTTP/1.0-Clients werden Keep-Alive-Verbindungen nur dann verwendet, wenn sie vom Client eigens angefordert werden. Desweiteren können Keep-Alive-Verbindungen bei einem HTTP/1.0-Client nur dann verwendet werden, wenn die Länge des Inhalts im Voraus bekannt ist. Dies impliziert, dass dynamische Inhalte wie CGI-Ausgaben, SSI-Seiten und servergenerierte Verzeichnisauflistungen im Allgemeinen keine Keep-Alive-Verbindungen mit HTTP/1.0-Clients verwenden. Bei HTTP/1.1-Clients sind Keep-Alive-Verbindungen Voreinstellung, solange nichts anderes angegeben ist. Wenn der Client es anfordert, wird Chunked-Encoding verwendet, um Inhalte mit unbekannter Länge über persistente Verbindungen zu senden.
| Beschreibung: | Zeitspanne, die der Server während persistenter Verbindungen auf nachfolgende Anfragen wartet |
|---|---|
| Syntax: | KeepAliveTimeout Sekunden |
| Voreinstellung: | KeepAliveTimeout 5 |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
Dies legt die Anzahl der Sekunden fest, die der Apache auf weitere
Anfragen wartet, bevor er die Verbindung schließt. Nachdem einmal
eine Anfrage entgegen genommen wurde, wird die durch die Direktive
Timeout festgelegte Auszeit
angewendet.
Auf stark belasteten Servern kann ein hoher
KeepAliveTimeout-Wert zu Durchsatzminderungen
führen. Je höher die Auszeit angegeben ist, desto länger
ist der Apache damit beschäftigt, auf untätige Clients zu
warten.
| Beschreibung: | Beschränkt die eingeschlossenen Zugriffskontrollen auf bestimmte HTTP-Methoden |
|---|---|
| Syntax: | <Limit Methode [Methode] ... > ...
</Limit> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
Zugriffskontrollen gelten normalerweise für alle
Zugriffsmethoden, was normalerweise auch das gewünschte Verhalten ist.
Im Allgemeinen sollten Zugriffskontrollen nicht in einen
<Limit>-Container gepackt
werden.
Der Sinn der Direktive <Limit>
ist es, den Effekt der Zugriffskontrollen auf die angegebenen
HTTP-Methoden zu beschränken. Bei allen anderen Methoden haben
die in der <Limit>-Gruppe
enthaltenen Zugriffsbeschränkungen keine Wirkung.
Im folgenden Beispiel gilt die Zugriffskontrolle nur für die
Methoden POST, PUT und DELETE.
Alle anderen Methoden bleiben ungeschützt:
<Limit POST PUT DELETE>
Require valid-user
</Limit>
Sie können eine oder mehrere der folgenden Methoden angeben:
GET, POST, PUT, DELETE,
CONNECT, OPTIONS,
PATCH, PROPFIND, PROPPATCH,
MKCOL, COPY, MOVE,
LOCK und UNLOCK. Die Methodennamen
unterscheiden zwischen Groß- und Kleinschreibung. Wenn
GET verwendet wird, sind HEAD-Anfragen
ebenfalls eingeschränkt. Die TRACE-Methode kann nicht
limitiert werden.
<LimitExcept>-Container sollte immer einem <Limit>-Container vorgezogen
werden, da <LimitExcept>
einen Schutz gegen beliebige Methoden bietet.
| Beschreibung: | Beschränkt Zugriffskontrollen auf alle HTTP-Methoden außer den genannten |
|---|---|
| Syntax: | <LimitExcept Methode [Methode] ... > ...
</LimitExcept> |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
<LimitExcept> und
</LimitExcept> werden dazu verwendet, eine Gruppe
von Anweisungen zur Zugriffskontrolle zusammenzufassen, die dann auf
jede HTTP-Methode angewendet werden, die nicht
als Argument angegeben ist. D.h. dies ist das Gegenteil des
<Limit>-Containers
und kann zur Steuerung von Standard- und nicht-Standard-/unbekannten
Methoden verwendet werden. Für weitere Einzelheiten lesen Sie bitte
die Beschreibung zu <Limit>.
Beispiel:
<LimitExcept POST GET>
Require valid-user
</LimitExcept>
| Beschreibung: | Bestimmt die maximale Anzahl interner Umleitungen und verschachtelter Unteranfragen |
|---|---|
| Syntax: | LimitInternalRecursion Zahl [Zahl] |
| Voreinstellung: | LimitInternalRecursion 10 |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Verfügbar ab Apache 2.0.47 |
Eine interne Umleitung erfolgt beispielsweise, wenn die Direktive
Action verwendet wird, welche
die Originalanfrage intern zu einem CGI-Skript weiterleitet. Eine
Unteranfrage (Anm.d.Ü.: engl. Subrequest) ist ein Mechanismus des
Apache, um herauszufinden, was bei einer URI geschehen würde, wäre
sie angefordert worden. mod_dir z.B. verwendet
Unteranfragen, um nach den Dateien zu suchen, die in der DirectoryIndex-Anweisung aufgeführt
sind.
LimitInternalRecursion bewahrt den Server vor
einem Absturz, wenn er in eine Endlosschleife aus internen Umleitungen
oder Unteranfragen hineinläuft. Derartige Schleifen werden
gewöhnlich durch Fehlkonfiguration verursacht.
Die Direktive setzt zwei verschiedene Begrenzungen, welche je Anfrage ausgewertet werden. Die erste Zahl bestimmt die maximale Anzahl der Umleitungen, die aufeinander folgen dürfen. Die zweite Zahl legt fest, wie tief Unteranfragen ineinander verschachtelt werden dürfen. Wenn Sie lediglich eine Zahl angeben, wird sie beiden Begrenzungen zugewiesen.
LimitInternalRecursion 5
| Beschreibung: | Begrenzt die Gesamtgröße des vom Client gesendeten HTTP-Request-Body |
|---|---|
| Syntax: | LimitRequestBody Bytes |
| Voreinstellung: | LimitRequestBody 0 |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
Die Direktive gibt die Anzahl der Bytes zwischen 0 (unbegrenzt) und 2147483647 (2GB) an, die im Request-Body (Datenteil der Anfrage) erlaubt sind.
Die Direktive LimitRequestBody erlaubt es dem
Benutzer, die Größe des HTTP-Request-Bodys in dem Kontext zu
begrenzen, in dem die Anweisung angegeben ist (Server, pro Verzeichnis,
pro Datei oder pro Adresse). Wenn die Anfrage des Clients dieses Limit
überschreitet, gibt der Server einen Fehler zurück anstatt die
Anfrage zu bearbeiten. Die Größe des Datenteils einer Anfrage
kann sehr stark variieren, abhängig von der Art der Ressource und
den für diese Ressource erlaubten Methoden. CGI-Skripte verwenden
den Datenteil üblicherweise zum Empfang von Formulardaten. Wird
die PUT-Methode angewendet, dann muss der Wert mindestens
so groß sein wie irgendeine Darstellungsform, die der Server
für diese Ressource akzeptieren soll.
Die Direktive gibt dem Serveradministrator eine größere Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich sein kann.
Wenn Sie beispielsweise das Hochladen von Dateien zu einer bestimmten Adresse erlauben, aber die Größe der hochgeladenen Dateien auf 100K beschränken wollen, können Sie die folgende Anweisung verwenden:
LimitRequestBody 102400
| Beschreibung: | Begrenzt die Anzahl der HTTP-Request-Header, die vom Client entgegengenommen werden |
|---|---|
| Syntax: | LimitRequestFields Anzahl |
| Voreinstellung: | LimitRequestFields 100 |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
Anzahl ist ein Integer-Wert (eine positive Ganzzahl)
zwischen 0 (unbegrenzt) und 32767. Die Voreinstellung wird durch die
Konstante DEFAULT_LIMIT_REQUEST_FIELDS (100
bei der Auslieferung) zur Kompilierungszeit gesetzt.
Die Direktive LimitRequestFields erlaubt es
dem Serveradministrator, die maximale Anzahl der in einem HTTP-Request
erlaubten HTTP-Request-Header zu verändern. Für den Server
muss dieser Wert größer sein als die Anzahl der Headerzeilen,
die ein normaler Client senden könnte. Die Anzahl der Request-Header,
die ein gewöhnlicher Client verwendet, überschreitet selten 20
Zeilen. Allerdings kann dies zwischen den verschiedenen
Client-Ausführungen variieren, oft abhängig vom Ausmaß,
mit dem der Anwender die genaue Content-Negotiation-Unterstützung
seines Browsers konfiguriert hat. Optionale HTTP-Erweiterungen
äußern sich oft in Form von HTTP-Headern.
Die Direktive gibt dem Serveradministrator eine größere Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich sein kann. Der Wert sollte erhöht werden, wenn normale Clients eine Fehlermeldung vom Server erhalten, die besagt, dass mit der Anfrage zu viele Headerzeilen gesendet wurden.
Beispiel:
LimitRequestFields 50
| Beschreibung: | Begrenzt die Länge des vom Client gesendeten HTTP-Request-Headers |
|---|---|
| Syntax: | LimitRequestFieldsize Bytes |
| Voreinstellung: | LimitRequestFieldsize 8190 |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
Die Direktive gibt die Anzahl der Bytes an, die in einem HTTP-Header erlaubt sind.
Die Direktive LimitRequestFieldsize erlaubt es
dem Serveradministrator, die maximale Größe eines
HTTP-Request-Headers zu verringern oder erhöhen. Für den Server
muss der Wert groß genug sein, um eine beliebige Headerzeile einer
normalen Client-Anfrage vorzuhalten. Die Größe variiert stark
zwischen den verschiedenen Client-Ausführungen, oft abhängig vom
Ausmaß, mit dem der Anwender die genaue
Content-Negotiation-Unterstützung seines Browsers konfiguriert hat.
SPNEGO-Authentisierungs-Header können bis zu 12392 Bytes lang
sein.
Die Direktive gibt dem Serveradministrator eine größere Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich sein kann.
Beispiel:
LimitRequestFieldSize 4094
| Beschreibung: | Begrenzt die Länge der vom Client entgegengenommenen HTTP-Anfragezeile |
|---|---|
| Syntax: | LimitRequestLine Bytes |
| Voreinstellung: | LimitRequestLine 8190 |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
Die Direktive legt die Anzahl der Bytes fest, die in der HTTP-Anfragezeile erlaubt sind.
Die Direktive LimitRequestLine erlaubt es dem
Serveradministrator, die maximale Größe der
HTTP-Anfragezeile zu verringern oder erhöhen. Da
die Anfragezeile aus der HTTP-Methode, der URI und der Protokollversion
besteht, bedeutet die LimitRequestLine-Direktive
eine Beschränkung der Länge der für eine Anfrage an den
Server erlaubten Anfrage-URI. Für den Server muss der Wert groß
genug sein, um jeden seiner Ressourcennamen vorzuhalten,
einschließlich aller Informationen, die im Query-String einer
GET-Anfrage übergeben werden können.
Die Direktive gibt dem Serveradministrator eine größere Kontrolle gegenüber abnormalem Verhalten von Clients, was bei der Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich sein kann.
Beispiel:
LimitRequestLine 4094
| Beschreibung: | Begrenzt die Größe eines XML-basierten Request-Bodys |
|---|---|
| Syntax: | LimitXMLRequestBody Bytes |
| Voreinstellung: | LimitXMLRequestBody 1000000 |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
Dies gibt die Grenze für die maximale Größe (in Bytes)
des XML-basierten Request-Bodys an. Der Wert 0 deaktiviert
diese Prüfung.
Beispiel:
LimitXMLRequestBody 0
| Beschreibung: | Wendet die enthaltenen Direktiven nur auf die entsprechenden URLs an |
|---|---|
| Syntax: | <Location
URL-Pfad|URL> ... </Location> |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
Die Direktive <Location>
begrenzt die Reichweite der enthaltenen Anweisungen auf URLs.
Sie ist der Direktive <Directory> ähnlich und startet einen
Abschnitt, der mit der Anweisung </Location>
abgeschlossen wird. <Location>-Container werden, nachdem die
<Directory>-Container
und .htaccess-Dateien gelesen wurden, und nach den
<Files>-Containern, in
der Reihenfolge ausgeführt, in der sie in der Konfigurationsdatei
erscheinen.
<Location>-Abschnitte operieren
vollständig außerhalb des Dateisystems. Dies hat mehrere
Konsequenzen. An Wichtigsten, <Location>-Anweisungen sollten nicht dafür
verwendet werden, den Zugriff zu Teilen des Dateisystems zu steuern. Da
mehrere unterschiedliche URLs auf die gleiche Stelle des Dateisystems
zeigen können, könnte eine solche Zugriffskontrolle u.U.
umgangen werden.
<Location> verwendet werdenVerwenden Sie <Location>, um
Anweisungen auf Inhalte anzuwenden, die außerhalb des Dateisystems
abgelegt sind. Benutzen Sie <Directory> und <Files> für Inhalte, die
innerhalb des Dateisystems abgelegt sind. Eine Ausnahme bildet
<Location />, welches ein einfacher Weg ist, um eine
Konfiguration auf den gesamten Server anzuwenden.
Für alle nicht-Proxy-Anfragen ist die entsprechende URL
ein URL-Pfad in der Form /path/. Es dürfen weder ein
Schema, noch ein Hostname, noch ein Port, noch ein Query-String einbezogen
werden. Für Proxy-Anfragen hat die Vergleichs-URL die Form
schema://servername/path. Das Präfix muss angegeben
werden.
Die URL kann Platzhalter verwenden. In einer Zeichenfolge mit
Platzhaltern entspricht ? einem einzelnen Zeichen und
*einer beliebigen Zeichenfolge.
Erweiterte reguläre
Ausdrücke können ebenfalls verwendet werden, indem
das Zeichen ~ hinzugefügt wird. Beispielsweise
würde
<Location ~ "/(extra|special)/data">
auf URLs passen, welche die Zeichenfolge /extra/data
oder /special/data enthalten. Die Direktive <LocationMatch> verhält sich
genauso wie <Location> mit
regulären Ausdrücken.
Die Funktionalität von <Location> ist insbesondere dann nützlich,
wenn sie mit der SetHandler-Direktive
kombiniert wird. Um zum Beispiel Statusabfragen zu aktivieren, sie aber
nur von Browsern aus foo.com zuzulassen, könnten Sie
schreiben:
<Location /status>
SetHandler server-status
Order Deny,Allow
Deny from all
Allow from .foo.com
</Location>
Das Slash-Zeichen hat eine besondere Bedeutung, je nachdem, wo es
in der URL erscheint. Manche werden sein Verhalten vom Dateisystem
gewohnt sein, wo mehrere aufeinanderfolgende Schrägstriche
häufig zu einem Schrägstrich zusammengefaßt werden
(d.h. /home///foo ist das gleiche wie
/home/foo). Im URL-Raum ist dies nicht notwendigerweise
genauso. Bei der Direktive <LocationMatch> und der <Location>-Version mit regulären Ausdrücken
müssen Sie explizit mehrere Schrägstriche angeben, wenn Sie
genau dies beabsichtigen.
Beispielsweise würde <LocationMatch ^/abc>
auf die angeforderte URL /abc passen, nicht aber auf
//abc. Die Direktive <Location> (ohne reguläre Ausdrücke) verhält
sich ähnlich, wenn sie für Proxy-Anfragen verwendet wird.
Wenn <Location> (ohne
reguläre Ausdrücke) jedoch für nicht-Proxy-Anfragen
verwendet wird, werden stillscheigend mehrere Schrächstriche mit
mit einem einzigen Schrägstrich gleichgesetzt. Geben Sie
beispielsweise <Location /abc/def> an und die
Anfrage lautet auf /abc//def, dann greift die Anweisung.
| Beschreibung: | Wendet die enthaltenen Direktiven nur auf URLs an, die auf reguläre Ausdrücke passen |
|---|---|
| Syntax: | <LocationMatch
regex> ... </LocationMatch> |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
Die Direktive <LocationMatch>
begrenzt die Reichweite der enthaltenen Anweisungen in der gleichen Weise
wie <Location> auf URLs.
Sie verwendet jedoch reguläre
Ausdrücke als Argument anstelle einer einfachen
Zeichenkette. Beispielsweise würde
<LocationMatch "/(extra|special)/data">
auf URLs passen, welche die Zeichenfolge /extra/data
oder /special/data enthalten.
| Beschreibung: | Steuert die Ausführlichkeit des Fehlerprotokolls |
|---|---|
| Syntax: | LogLevel Level |
| Voreinstellung: | LogLevel warn |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
LogLevel stellt die Ausführlichkeit
der Nachrichten ein, die im Fehlerprotokoll aufgezeichnet werden (siehe
Direktive ErrorLog). Die folgenden,
nach absteigender Aussagekraft sortierten Level sind
verfügbar:
| Level | Beschreibung | Beispiel |
|---|---|---|
emerg |
Notfall - das System ist unbenutzbar. | "Child cannot open lock file. Exiting" (Anm.d.Ü.: "Kindprozess kann die Lock-Datei nicht öffnen. Beende Programm") |
alert |
Maßnahmen müssen unverzüglich ergriffen werden. | "getpwuid: couldn't determine user name from uid" (Anm.d.Ü.: "getpwuid: kann keinen Benutzernamen aus der UID ermitteln") |
crit |
Kritischer Zustand. | "socket: Failed to get a socket, exiting child" (Anm.d.Ü.: "socket: Socket-Zuweisung fehlgeschlagen, beende Kindprozess") |
error |
Fehlerbedingung. | "Premature end of script headers" (Anm.d.Ü.: "Vorzeitiges Ende der Skript-Header") |
warn |
Warnung. | "child process 1234 did not exit, sending another SIGHUP" (Anm.d.Ü.: "Kindprozess 1234 nicht beendet, sende ein weiteres SIGHUP") |
notice |
Normaler, aber signifikanter Zustand. | "httpd: caught SIGBUS, attempting to dump core in ..." (Anm.d.Ü.: "httpd: SIGBUS empfangen, versuche Speicherabbild nach ... zu schreiben") |
info |
Information. | "Server seems busy, (you may need to increase StartServers, or Min/MaxSpareServers)..." (Anm.d.Ü.: "Server scheint beschäftigt zu sein, (möglicherweise müssen Sie StartServers oder Min/MaxSpareServers erhöhen)") |
debug |
Debug-Level-Nachrichten | "Opening config file ..." (Anm.d.Ü.: "Öffne Konfigurationsdatei ...") |
Geben Sie einen bestimmten Level an, denn werden Nachrichten von
allen höheren Leveln ebenso angezeigt. Z.B.: Wenn
LogLevel info eingestellt ist, dann werden Nachrichten der
Log-Level notice und warn ebenso eingetragen.
Es wird empfohlen, mindestens den Level crit zu
verwenden.
Beispiel:
LogLevel notice
Beim Protokollieren in eine reguläre Datei können
Nachrichten des Levels notice nicht unterdrückt
werden und werden daher immer protokolliert. Dies trifft allerdings
nicht zu, wenn mittels syslog protokolliert wird.
| Beschreibung: | Anzahl der Anfragen, die bei einer persistenten Verbindung zulässig sind |
|---|---|
| Syntax: | MaxKeepAliveRequests Anzahl |
| Voreinstellung: | MaxKeepAliveRequests 100 |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
Die Direktive MaxKeepAliveRequests
begrenzt die Anzahl der Anfragen, die pro Verbindung zulässig sind,
wenn KeepAlive eingeschaltet ist.
Bei der Einstellung 0 sind unbegrenzt viele Anfragen
erlaubt. Wir empfehlen für diese Einstellung einen hohen Wert
für eine maximale Serverleistung.
Beispiel:
MaxKeepAliveRequests 500
| Beschreibung: | Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete
resource |
|---|---|
| Syntax: | MaxRangeOverlaps default | unlimited | none | number-of-ranges |
| Voreinstellung: | MaxRangeOverlaps 20 |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in Apache HTTP Server 2.3.15 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Number of range reversals (eg: 100-200,50-70) allowed before returning the complete
resource |
|---|---|
| Syntax: | MaxRangeReversals default | unlimited | none | number-of-ranges |
| Voreinstellung: | MaxRangeReversals 20 |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in Apache HTTP Server 2.3.15 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Number of ranges allowed before returning the complete resource |
|---|---|
| Syntax: | MaxRanges default | unlimited | none | number-of-ranges |
| Voreinstellung: | MaxRanges 200 |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in Apache HTTP Server 2.3.15 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Controls whether the server merges consecutive slashes in URLs. |
|---|---|
| Syntax: | MergeSlashes ON|OFF |
| Voreinstellung: | MergeSlashes ON |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Added in 2.4.39 |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Determines whether trailers are merged into headers |
|---|---|
| Syntax: | MergeTrailers [on|off] |
| Voreinstellung: | MergeTrailers off |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | 2.4.11 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Configures mutex mechanism and lock file directory for all or specified mutexes |
|---|---|
| Syntax: | Mutex mechanism [default|mutex-name] ... [OmitPID] |
| Voreinstellung: | Mutex default |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in Apache HTTP Server 2.3.4 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Bestimmt eine IP-Adresse für den Betrieb namensbasierter virtueller Hosts |
|---|---|
| Syntax: | NameVirtualHost Adresse[:Port] |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
Die Direktive NameVirtualHost ist erforderlich,
wenn Sie namensbasierte virtuelle Hosts
konfigurieren möchten.
Obwohl Adresse eine Hostname sein kann, wird empfohlen, dass Sie stets eine IP-Adresse verwenden, z.B.:
NameVirtualHost 111.22.33.44
Mit der NameVirtualHost-Anweisung geben Sie
die IP-Adresse an, unter der der Server Anfragen für
namensbasierte virtuelle Hosts entgegennimmt. Das ist üblicherweise
die Adresse, zu der die Namen Ihrer namensbasierten virtuellen Hosts
aufgelöst werden. Falls eine Firewall oder ein anderer Proxy die
Anfrage in Empfang nimmt und Sie zu einer weiteren IP-Adresse des Servers
weiterleitet, müssen Sie die IP-Adresse der physikalischen
Schnittstelle der Maschine angeben, welche die Anfragen bedient.
Wenn Sie mehrere namensbasierte Hosts an verschiedenen Adressen
betreiben, wiederholen Sie einfach die Anweisung für jede
Adresse.
Beachten Sie, dass der "Hauptserver" und jeder
_default_-Server niemals bei einer
Anfrage an einer NameVirtualHost-IP-Adresse
bedient wird (es sei denn, Sie geben aus irgendwelchen Gründen
NameVirtualHost an, definieren dann aber keine
VirtualHosts für diese Adresse).
Optional können Sie die Nummer eines Ports angeben, an dem namensbasierte virtuelle Hosts verwendet werden sollen. Beispiel:
NameVirtualHost 111.22.33.44:8080
IPv6-Adressen müssen, wie im folgenden Beispiel angegeben, in eckige Klammern eingeschlossen werden:
NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
Um an allen Schnittstellen Anfragen zu empfangen, können Sie
* als Argument verwenden.
NameVirtualHost *
<VirtualHost>Beachten Sie, dass das Argument der <VirtualHost>-Anweisung exakt auf das Argument
der NameVirtualHost-Anweisung passen muss.
NameVirtualHost 1.2.3.4
<VirtualHost 1.2.3.4>
# ...
</VirtualHost>
| Beschreibung: | Definiert, welche Eigenschaften oder Funktionen in einem bestimmten Verzeichnis verfügbar sind |
|---|---|
| Syntax: | Options
[+|-]Option [[+|-]Option] ... |
| Voreinstellung: | Options All |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | Options |
| Status: | Core |
| Modul: | core |
Die Direktive Options steuert, welche
Eigenschaften bzw. Funktionen in einem bestimmten Verzeichnis
verfügbar sind.
Option kann auf None gesetzt werden, wobei
keine der besonderen Eigenschaften verfügbar sind, oder auf eines
oder mehrere der folgenden:
AllMultiViews. Dies ist
die Voreinstellung.ExecCGImod_cgi
verwenden, ist erlaubt.FollowSymLinksAuch wenn der Server symbolischen Links folgt, bedeutet dies
nicht, dass der zum Abgleich gegen <Directory>-Abschnitte verwendete Pfadname
wechselt.
Beachten Sie auch, dass diese Option innerhalb eines
<Location>-Abschnitts
ignoriert wird.
Includesmod_include bereitgestellt
werden, sind erlaubt.IncludesNOEXEC#exec cmd
und #exec cgi sind jedoch deaktiviert. Es ist aber noch
möglich, CGI-Skripte aus
ScriptAlias-Verzeichnissen mittels
#include virtual einzubinden.IndexesDirectoryIndex definierte
Indexdatei (z.B. index.html) befindet, dann liefert
mod_autoindex eine formatierte Auflistung des
Verzeichnisses zurück.MultiViewsmod_negotiation erlaubt (siehe Content-Negotiation).SymLinksIfOwnerMatch<Location>-Abschnitts
ignoriert.Wenn mehrere Options auf ein Verzeichnis
angewandt werden können, dann wird normalerweise die
spezifischste (Anm.d.Ü.: Gemeint ist die zuletzt
ausgeführte Option.) verwendet und alle anderen werden
ignoriert; die Optionen werden nicht vermischt. (Siehe auch Wie Abschnitte zusammengeführt
werden..) Wenn jedoch allen Optionen der
Options-Anweisung eines der Zeichen
+ oder - vorangestellt wird, werden die Optionen
zusammengemischt. Jede Option mit vorangestelltem + wird
zu den momentan gültigen Optionen hinzugefügt und jede Option
mit vorangestelltem - wird aus den derzeit gültigen
Optionen entfernt.
Die Vermischung von Optionen mit + oder - mit
Optionen ohne diese (Zeichen) ist keine gültige Syntax und führt
mit hoher Wahrscheinlichkeit zu unerwarteten Effekten.
So wird zum Beispiel ohne die Zeichen + und
-
<Directory /web/docs>
Options Indexes FollowSymLinks
</Directory>
<Directory /web/docs/spec>
Options Includes
</Directory>
für das Verzeichnis /web/docs/spec wird jetzt
lediglich Includes gesetzt. Wenn die zweite
Options-Anweisung jedoch +-
und --Zeichen verwenden würde,
<Directory /web/docs>
Options Indexes FollowSymLinks
</Directory>
<Directory /web/docs/spec>
Options +Includes -Indexes
</Directory>
dann würden die Optionen FollowSymLinks und
Includes für das Verzeichnis /web/docs/spec
gesetzt.
Die Verwendung von -IncludesNOEXEC oder
-Includes deaktiviert Server Side Includes unabhängig
von der vorigen Einstellung vollständig.
Die Voreinstellung ist All, sofern keine anderen Angaben
gemacht wurden.
| Beschreibung: | Protocol for a listening socket |
|---|---|
| Syntax: | Protocol protocol |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in Apache 2.1.5 and later. On Windows, from Apache 2.3.3 and later. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Protocols available for a server/virtual host |
|---|---|
| Syntax: | Protocols protocol ... |
| Voreinstellung: | Protocols http/1.1 |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Only available from Apache 2.4.17 and later. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Determines if order of Protocols determines precedence during negotiation |
|---|---|
| Syntax: | ProtocolsHonorOrder On|Off |
| Voreinstellung: | ProtocolsHonorOrder On |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Only available from Apache 2.4.17 and later. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Controls whether the REDIRECT_URL environment variable is fully qualified |
|---|---|
| Syntax: | QualifyRedirectURL On|Off |
| Voreinstellung: | QualifyRedirectURL Off |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Directive supported in 2.4.18 and later. 2.4.17 acted as if 'QualifyRedirectURL On' was configured. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Size of the buffers used to read data |
|---|---|
| Syntax: | ReadBufferSize bytes |
| Voreinstellung: | ReadBufferSize 8192 |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | 2.4.27 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Allow to configure global/default options for regexes |
|---|---|
| Syntax: | RegexDefaultOptions [none] [+|-]option [[+|-]option] ... |
| Voreinstellung: | RegexDefaultOptions DOTALL DOLLAR_ENDONLY |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Only available from Apache 2.4.30 and later. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Register non-standard HTTP methods |
|---|---|
| Syntax: | RegisterHttpMethod method [method [...]] |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in Apache HTTP Server 2.4.24 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Begrenzt den CPU-Verbrauch von Prozessen, die von Apache-Kindprozessen gestartet wurden |
|---|---|
| Syntax: | RLimitCPU Sekunden|max [Sekunden|max] |
| Voreinstellung: | unbestimmt; verwendet die Voreinstellung des Systems |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
Parameter kann eine Zahl oder max sein. max
zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
erfordert, dass der Server als root läuft, zumindest in
der anfänglichen Startphase.
Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden Apache-Kindprozessen abgespalten werden, nicht auf die Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess abgespalten werden, wie z.B. Protokollierung.
CPU-Ressourcenbegrenzung wird in Sekunden pro Prozess ausgedrückt.
| Beschreibung: | Begrenzt den Speicherverbrauch von Prozessen, die von Apache-Kindprozessen gestartet wurden |
|---|---|
| Syntax: | RLimitMEM Bytes|max [Bytes|max] |
| Voreinstellung: | unbestimmt; verwendet die Voreinstellung des Systems |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
Parameter kann eine Zahl oder max sein. max
zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
erfordert, dass der Server als root läuft, zumindest in
der anfänglichen Startphase.
Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden Apache-Kindprozessen abgespalten werden, nicht auf die Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess abgespalten werden, wie z.B. Protokollierung.
Die Begrenzung des Speicherverbrauchs wird in Bytes pro Prozess ausgedrückt.
| Beschreibung: | Begrenzt die Anzahl der Prozesse, die von Prozessen gestartet werden können, der ihrerseits von Apache-Kinprozessen gestartet wurden |
|---|---|
| Syntax: | RLimitNPROC Zahl|max [Zahl|max] |
| Voreinstellung: | unbestimmt; verwendet die Voreinstellung des Systems |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
weiche Ressourcenbegrenzung für alle Prozesse, der zweite Parameter
setzt die Maximalgrenze für die Ressourcennutzung. Jeder der
Parameter kann eine Zahl oder max sein. max
zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
erfordert, dass der Server als root läuft, zumindest in
der anfänglichen Startphase.
Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden Apache-Kindprozessen abgespalten werden, nicht auf die Apache-Kindprozesse selbst. Dies beinhaltet CGI-Skripte und SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess abgespalten werden, wie z.B. Protokollierung.
Prozessbegrenzungen steuern die Anzahl der Prozesse pro Benutzer.
Wenn CGI-Prozesse nicht unter anderen Benutzerkennungen als der
User-ID des Webservers laufen, dann beschränkt diese Direktive
die Anzahl der Prozesse, die der Server selbst erstellen kann.
Kennzeichen einer solchen Situation sind
cannot fork-Meldungen
(Anm.d.Ü.: kann nicht abspalten) in der
Datei error_log.
| Beschreibung: | Methode zur Ermittlung des Interpreters von CGI-Skripten |
|---|---|
| Syntax: | ScriptInterpreterSource Registry|Registry-Strict|Script |
| Voreinstellung: | ScriptInterpreterSource Script |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | ausschließlich Win32;
Die Option Registry-Strict ist verfügbar seit Apache
2.0. |
Die Direktive steuert, wie der Apache den Interpreter zur Ausführung
von CGI-Skripten bestimmt. Die Voreinstellung ist Script. Dies
veranlaßt den Apache, den Interpreter zu verwenden, auf den die
Shebang-Zeile (erste Zeile, beginnt mit #!) im Skript zeigt.
Auf Win32-Systemen sieht diese Zeile üblicherweise so aus:
#!C:/Perl/bin/perl.exe
oder, wenn perl im Pfad (Umgebungsvariable PATH) liegt,
einfach:
#!perl
Die Einstellung ScriptInterpreterSource Registry
veranlaßt eine Suche in HKEY_CLASSES_ROOT der
Windows-Registrierungsdatenbank und verwendet die Endung der Skript-Datei
(z.B. .pl) als Suchargument. Der durch den Unterschlüssel
Shell\ExecCGI\Command oder, falls dieser nicht existiert,
Shell\Open\Command definierte Befehl wird zum Öffnen der
Skript-Datei verwendet. Wenn der Schlüssel zur Dateiendung oder
beide Unterschlüssel fehlen, dann verwendet der Apache die Option
Script.
Seien Sie vorsichtig, ScriptInterpreterSource Registry bei
Verzeichnissen zu verwenden, auf die eine ScriptAlias-Anweisung zeigt, denn der
Apache versucht jede Datei innerhalb des Verzeichnisses
auszuführen. Die Einstellung Registry kann
unerwünschte Programmaufrufe bei Dateien verursachen, die
üblicherweise nicht ausgeführt werden. Auf den meisten
Windows-Systemen beispielsweise startet der voreingestellte
Öffnen-Befehl für .htm-Dateien den Microsoft
Internet Explorer, so dass jede HTTP-Anfrage nach einer existierenden
.htm-Datei im Skript-Verzeichnis den Browser im Hintergrund
starten würde. Dies ist eine wirksame Methode, Ihr System binnen
etwa einer Minute zum Absturz zu bringen.
Die seit Apache 2.0 neue Option Registry-Strict
macht das gleiche wie Registry, verwendet jedoch nur den
Unterschlüssel Shell\ExecCGI\Command. Der Schlüssel
ExecCGI ist gewöhnlich nicht voreingestellt. Er muss
manuell eingerichtet werden und schützt Ihr System so for
versehentlichen Programmaufrufen.
| Beschreibung: | Determine if mod_status displays the first 63 characters of a request or the last 63, assuming the request itself is greater than 63 chars. |
|---|---|
| Syntax: | SeeRequestTail On|Off |
| Voreinstellung: | SeeRequestTail Off |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Available in Apache httpd 2.2.7 and later. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | E-Mail-Adresse, die der Server in Fehlermeldungen einfügt, welche an den Client gesendet werden |
|---|---|
| Syntax: | ServerAdmin E-Mail-Adresse|URL |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
ServerAdmin legt die Kontaktadresse fest,
die der Server in jede Fehlermeldung einfügt, die er an den
Client zurückschickt. Wenn httpd das übergebene
Argument nicht als URL erkennt, nimmt er an, dess es sich um eine
E-Mail-Adresse handelt und stellt in Hyperlinks
mailto: voran. Es ist jedoch sogar sinnvoll, eine
E-Mail-Adresse zu verwenden, da viele CGI-Skripte davon ausgehen. Wenn Sie
eine URL verwenden möchten, sollten Sie auf einem anderen unter Ihrer
Kontrolle stehenden Server verweisen. Andernfalls können Besucher Sie
im Fehlerfall möglicherweise nicht kontaktieren.
Es kann sich lohnen, hierfür eine reservierte Adresse anzugeben, z.B.
ServerAdmin www-admin@foo.example.com
da Anwender nicht unbedingt erwähnen, dass sie vom Server sprechen!
| Beschreibung: | Alternativer Name für einen Host, der verwendet wird, wenn Anfragen einem namensbasierten virtuellen Host zugeordnet werden |
|---|---|
| Syntax: | ServerAlias Hostname [Hostname] ... |
| Kontext: | Virtual Host |
| Status: | Core |
| Modul: | core |
Die Direktive ServerAlias bestimmt die
alternativen Namen eines Hosts zur Verwendung mit namensbasierten virtuellen Hosts.
<VirtualHost *>
ServerName server.domain.com
ServerAlias server server2.domain.com server2
# ...
</VirtualHost>
| Beschreibung: | Rechnername und Port, die der Server dazu verwendet, sich selbst zu identifizieren |
|---|---|
| Syntax: | ServerName
voll-qualifizierter-Domainname[:port] |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Diese Direktive löst in Version 2.0 die
Funktionalität der Direktive Port aus
Version 1.3 ab. |
Die Direktive ServerName bestimmt den
Rechnernamen und Port, den der Server dazu verwendet, sich selbst
zu identifizieren. Diese werden bei der Erstellung von Umleitungs-URLs
benötigt. Wenn beispielsweise der Name der Maschine, die den Webserver
beherbergt, simple.example.com lautet, die Maschine jedoch
auch einen DNS-Alias www.example.com besitzt und Sie den
Webserver so identifizieren möchten, sollten Sie die folgende
Anweisung verwenden:
ServerName www.example.com:80
Wenn kein ServerName angegeben wurde,
dann versucht der Server den Rechnernamen mittels eines Reverse-Lookup
herzuleiten. Wenn kein Port in der
ServerName-Anweisung angegeben wurde, dann
verwendet der Server den Port der eingegangenen Anfrage. Für eine
optimale Zuverlässigkeit und Berechenbarkeit sollten Sie einen
eindeutigen Rechnernamen und Port angeben, in dem Sie die Direktive
ServerName verwenden.
Wenn Sie namensbasierte
virtuelle Hosts verwenden, gibt ServerName
innerhalb eines <VirtualHost>-Abschnitts an, welcher
Hostname im Host:-Header der Anfrage auftauchen muss,
damit sie diesem virtuellen Host zugeordnet wird.
Lesen Sie bitte die Beschreibung der Direktiven UseCanonicalName und UseCanonicalPhysicalPort für Einstellungen, die
bestimmen, ob selbstreferenzierende URLs (z.B. vom Modul
mod_dir) auf den angegebenen Port zeigen oder auf die
Portnummern die in der Anfrage des Clients angegeben ist.
| Beschreibung: | Veralteter URL-Pfad für einen namensbasierten virtuellen Host, auf den von einem inkompatiblen Browser zugegriffen wird |
|---|---|
| Syntax: | ServerPath URL-Pfad |
| Kontext: | Virtual Host |
| Status: | Core |
| Modul: | core |
Die Direktive ServerPath legt den
veralteten (Anm.d.Ü.: Gemeint ist eigentlich "Altlast" aufgrund
antiquierter Clients.) URL-Pfad eines Hosts zur Verwendung mit
namensbasierten virtuellen Hosts fest.
| Beschreibung: | Basisverzeichnis der Serverinstallation |
|---|---|
| Syntax: | ServerRoot Verzeichnis |
| Voreinstellung: | ServerRoot /usr/local/apache |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
Die Direktive ServerRoot bestimmt das
Verzeichnis, in dem der Server installiert ist. Üblicherweise
enthält es die Unterverzeichnisse conf/ und
logs/. Relative Pfadangaben anderer Direktiven (wie z.B.
Include oder LoadModule) werden relativ zu diesem
Verzeichnis betrachtet.
ServerRoot /home/httpd
httpd-Option
-dServerRoot-Verzeichnis richtig gesetzt werden| Beschreibung: | Konfiguriert die Fußzeile von servergenerierten Dokumenten |
|---|---|
| Syntax: | ServerSignature On|Off|EMail |
| Voreinstellung: | ServerSignature Off |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | All |
| Status: | Core |
| Modul: | core |
Die Direktive ServerSignature ermöglicht
die Gestaltung einer unter servergenerierten Dokumenten (z.B.
Fehlerdokumente, FTP-Verzeichnislisten von mod_proxy,
mod_info-Ausgaben, ...) angefügten
Fußzeile. Ein möglicher Grund für die Aktivierung einer
solchen Fußzeile ist, dass der Anwender bei einer Kette von
Proxy-Servern oft keine Möglichkeit hat, zu erkennen, welcher der
verketteten Server gegenwärtig die zurückgegebene Fehlermeldung
produziert hat.
Die (Vor-)Einstellung Off unterdrückt die
Fußzeile (und ist damit kompatibel zum Verhalten des Apache 1.2 und
früher). Die Einstellung On fügt schlicht eine
Zeile mit der Versionsnummer des Servers und dem Servernamen (ServerName) des bedienenden virtuellen Hosts an.
Die Einstellung EMail erstellt zusätzlich einen
"mailto:"-Verweis zum Serveradministrator (ServerAdmin) des referenzierten Dokuments.
Ab Version 2.0.44 werden die Details der angegebenen Versionsnummer des
Servers von der Direktive ServerTokens kontrolliert.
| Beschreibung: | Konfiguriert den HTTP-Response-Header
Server |
|---|---|
| Syntax: | ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full |
| Voreinstellung: | ServerTokens Full |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
die Direktive steuert, ob der Response-Header Server,
der an den Client zurückgesendet wird, eine Beschreibung des
allgemeinen Betriesbsystemtyps des Servers wie auch Informationen
über einkompilierte Module enthält.
ServerTokens Prod[uctOnly]Server:
ApacheServerTokens MajorServer:
Apache/2ServerTokens MinorServer:
Apache/2.0ServerTokens Min[imal]Server:
Apache/2.0.41ServerTokens OSServer: Apache/2.0.41
(Unix)ServerTokens Full (oder nicht angegeben)Server: Apache/2.0.41
(Unix) PHP/4.2.2 MyMod/1.2Diese Einstellung gilt für den gesamten Server und kann nicht auf Virtual-Host-Basis aktiviert oder deaktiviert werden.
Ab Version 2.0.44 steuert diese Direktive auch die Informationen, die
durch die Direktive ServerSignature
angeboten werden.
| Beschreibung: | Erzwingt die Verarbeitung aller passenden Dateien durch einen Handler |
|---|---|
| Syntax: | SetHandler Handlername|None |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Seit Apache 2.0 im Core |
Wenn die Direktive innerhalb einer .htaccess-Datei
oder in einem <Directory>- oder
<Location>-Abschnitt
angegeben wird, erzwingt sie, dass alle entsprechenden Dateien von dem
durch Handlername angegebenen Handler analysiert werden. Wenn Sie
beispielsweise ein Verzeichnis haben, dessen Dateien unabhängig von
der Endung gänzlich als Image-Maps interpretiert werden sollen,
können Sie folgendes in eine .htaccess-Datei in
dem Verzeichnis schreiben:
SetHandler imap-file
Noch ein Beispiel: wenn Sie den Server immer, wenn die URL
http://servername/status aufgerufen wird, einen
Statusbericht anzeigen lassen möchten, dann können
Sie folgendes in die httpd.conf schreiben:
<Location /status>
SetHandler server-status
</Location>
Sie können eine zuvor definierte
SetHandler-Anweisung aufheben, indem Sie den Wert
None verwenden.
Hinweis: SetHandler setzt die Standard-Handler außer Kraft und unterdrückt gewohnte Verhaltensweisen, wie beispielsweise die Behandlung von URLs, die auf einen Schrägstrich (/) enden als Verzeichnisse oder (die Auslieferung von) Index-Dateien.
| Beschreibung: | Bestimmt die Filter, die Client-Anfragen und POST-Eingaben verarbeiten |
|---|---|
| Syntax: | SetInputFilter Filter[;Filter...] |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
Die Direktive SetInputFilter bestimmt den oder
die Filter, die Client-Anfragen und POST-Eingaben verarbeiten, wenn
sie vom Server empfangen werden. Diese gelten zusätzlich zu
anderweitig definierten Filtern, einschließlich denen der Direktive
AddInputFilter.
Wenn mehr als ein Filter angegeben wird, dann müssen diese durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden, in der sie die Daten verarbeiten sollen.
| Beschreibung: | Bestimmt die Filter, die Antworten des Servers verarbeiten |
|---|---|
| Syntax: | SetOutputFilter Filter[;Filter...] |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Core |
| Modul: | core |
Die Direktive SetOutputFilter bestimmt
die Filter, die Antworten des Servers verarbeiten, bevor sie an den
Client gesendet werden. Diese gelten zusätzlich zu anderweitig
definierten Filtern, einschließlich denen der Direktive
AddOutputFilter.
Die folgende Konfiguration verarbeitet zum Beispiel alle Dateien
im Verzeichnis /www/data als Server Side Includes.
<Directory /www/data/>
SetOutputFilter INCLUDES
</Directory>
Wenn mehr als ein Filter angegeben wird, dann müssen diese durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden, in der sie die Daten verarbeiten sollen.
| Beschreibung: | Controls whether the server requires the requested hostname be listed enumerated in the virtual host handling the request |
|---|---|
| Syntax: | StrictHostCheck ON|OFF |
| Voreinstellung: | StrictHostCheck OFF |
| Kontext: | Serverkonfiguration, Virtual Host |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Added in 2.4.49 |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Zeitspanne, die der Server auf verschiedene Ereignisse wartet, bevor er die Anfrage abbricht |
|---|---|
| Syntax: | TimeOut Sekunden |
| Voreinstellung: | TimeOut 60 |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
Die Direktive TimeOut definiert derzeit die
Zeitspanne, die der Apache auf drei Dinge wartet:
Wir haben vor, diese Zeitspannen in Zukunft separat konfigurierbar zu machen. Vor Version 1.2 war der Zeitgeber auf 1200 voreingestellt, wurde dann aber auf 300 herabgesetzt, was immer noch weit mehr ist, als in den meisten Situationen benötigt wird. Die Voreinstellung wurde nicht weiter herabgesetzt, da gelegentlich noch Stellen im Code existieren können, wo der Zeitgeber nicht zurückgesetzt wird, wenn ein Paket verschickt wird. Seit Apache 2.4 ist die Voreinstellung 60.
| Beschreibung: | Legt das Verhalten von TRACE-Anfragen fest |
|---|---|
| Syntax: | TraceEnable [on|off|extended] |
| Voreinstellung: | TraceEnable on |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Verfügbar ab Apache 1.3.34 und 2.0.55 |
Diese Direktive beeinflusst das Verhalten von TRACE sowohl
für den Server selbst als auch mod_proxy. Die
Voreinstellung TraceEnable on erlaubt
TRACE-Anfragen gemäß RFC 2616. Dort werden
nur Anfragen ohne Datenteil zugelassen. TraceEnable off
sorgt dafür, dass der Serverkern und mod_proxy den
Fehler 405 (Zugriffsmethode nicht erlaubt) an den Client
senden.
Zu Test- und Diagnosezwecken können Sie auch
nicht-standardkonforme Anfragen mit Datenteil erlauben, indem Sie die
Direktive TraceEnable extended verwenden. Der Server (als
Ursprungsserver) beschränkt den Anfrageinhalt auf 64k. (Wenn
Transfer-Encoding: chunked benutzt wird, können
weitere 8k für die Chunk-Kopfzeilen verwendet werden.) Der
Server selbst reflektiert dann die vollständigen HTTP- und
Chunk-Kopfzeilen in seiner Antwort. Die Einschränkung auf 64k gilt
nicht, wenn der Server als Proxy arbeitet.
| Beschreibung: | Controls what UNC host names can be accessed by the server |
|---|---|
| Syntax: | UNCList hostname [hostname...] |
| Voreinstellung: | unset |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
| Kompatibilität: | Added in 2.4.60, Windows only. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Undefine the existence of a variable |
|---|---|
| Syntax: | UnDefine parameter-name |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Bestimmt, wie der Server seinen eigenen Namen und Port ermittelt |
|---|---|
| Syntax: | UseCanonicalName On|Off|DNS |
| Voreinstellung: | UseCanonicalName Off |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
| Status: | Core |
| Modul: | core |
In vielen Situationen muss der Apache eine
selbstreferenzierende URL -- d.h. eine URL, die auf den selben
Server zurück verweist -- zusammenbauen. Bei UseCanonicalName
On verwendet der Apache den Hostnamen und Port, der in der
ServerName-Anweisung angegeben ist,
um den kanonischen Namen des Servers zu erstellen. Dieser Name wird in
allen selbstreferenzierenden URLs sowie in CGI-Skripten für die
Werte von SERVER_NAME und SERVER_PORT
verwendet.
Bei UseCanonicalName Off bildet der Apache
selbstreferenzierende URLs, indem er den vom Client übermittelten
Hostnamen und Port verwendet, sofern diese vorhanden sind (andernfalls
wird der kanonische Name, wie oben beschrieben, benutzt). Die Werte
sind die gleichen, die zur Anwendung von namensbasierten virtuellen Hosts
verwendet werden, und sie sind mit den gleichen Clients verfügbar
(Anm.d.Ü.: , die auch in der Lage sind, auf namensbasierte virtuelle Hosts
zuzugreifen, d.h. einen Host-Header mitschicken).
Die CGI-Variablen SERVER_NAME und SERVER_PORT
werden ebenfalls aus den vom Client angeboten Werten erstellt.
Ein Intranet-Server, auf den Anwender mit kurzen Namen wie
www zugreifen, ist ein Beispiel, wo dies sinnvoll sein kann.
Sie werden bemerken, dass der Apache den Benutzer auf
http://www.domain.com/splat/ umleitet, wenn dieser einen
Kurznamen und eine URL, die einem Verzeichnis entspricht, ohne
abschließenden Schrägstrich eingibt, wie z.B.
http://www/splat. Wenn Sie Authentisierung aktiviert haben,
bewirkt dies, dass der Benutzer sich zweimal identifizieren muss
(einmal für www und noch einmal für
www.domain.com -- lesen Sie für weitere Informationen die
FAQ zu diesem Thema). Wenn UseCanonicalName
jedoch auf Off gesetzt ist, denn wird der Apache zu
http://www/splat/ umleiten.
Es existiert noch eine dritte Option, UseCanonicalName DNS,
die für den Betrieb von IP-basierten Massen-Virtual-Hosts gedacht ist,
um antiquierte Clients zu unterstützen, die keinen
Host:-Header bereit stellen. Um selbstreferenzierende
URLs zu ermitteln, führt der Apache bei dieser Option ein
Reverse-DNS-Lookup auf die IP-Adresse des Servers aus, zu der der Client
Verbindung aufgenommen hat.
Wenn CGI-Skripte Vermutungen aufgrund des Wertes von
SERVER_NAME anstellen, können sie durch diese
Option fehlschlagen. Clients steht es im Wesentlichen frei, einen Wert
für den Hostnamen anzugeben, wie er will. Wenn das
CGI-Skript SERVER_NAME jedoch lediglich dazu verwendet,
selbstreferenzierende URLs zu erstellen, sollte das gerade noch
in Ordnung sein.
| Beschreibung: | Bestimmt, wie der Server seinen eigenen Namen und Port ermittelt |
|---|---|
| Syntax: | UseCanonicalPhysicalPort On|Off |
| Voreinstellung: | UseCanonicalPhysicalPort Off |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
| Status: | Core |
| Modul: | core |
In vielen Situationen muss der Apache eine
selbstreferenzierende URL zusammenbauen, d.h. eine URL, die auf
den selben Server zurück verweist. Wenn der Apache für die
UseCanonicalName-Direktive den Port
bestimmt, wird mit UseCanonicalPhysicalPort On die
tatsächlich für die Anfrage verwendete physische Portnummer
in Betracht gezogen. Mit UseCanonicalPhysicalPort Off
verläßt sich der Apache nur auf die Konfiguration, um eine
gültige Portnummer zu bestimmen und läßt die
physische Portnummer außer acht.
Wenn der physische Port verwendet wird, ist die Reihenfolge wie
folgt:
UseCanonicalName On
Servername angegebene PortUseCanonicalName Off | DNS
Host:-Header gewonnen wurdeServername angegebene PortBei UseCanonicalPhysicalPort Off werden die physischen
Ports aus der Suchreihe entfernt.
| Beschreibung: | Enthält Direktiven, die nur auf bestimmte Hostnamen oder IP-Adressen angewendet werden |
|---|---|
| Syntax: | <VirtualHost
Adresse[:Port] [Adresse[:Port]]
...> ... </VirtualHost> |
| Kontext: | Serverkonfiguration |
| Status: | Core |
| Modul: | core |
<VirtualHost> und
</VirtualHost> werden dazu verwendet, eine Gruppe
von Direktiven zusammenzufassen, die nur auf einen bestimmten virtuellen
Host angewendet werden. Jede Direktive, die im Virtual-Host-Kontext
zulässig ist, kann verwendet werden. Wenn der Server eine Anfrage
für ein bestimmtes Dokument eines bestimmten virtuellen Hosts
empfängt, dann benutzt er die im
<VirtualHost>-Container enthaltenen
Konfigurationsanweisungen. Adresse kann sein:
*, welches nur in Kombination mit
NameVirtualHost * verwendet wird, um allen IP-Adressen
zu entsprechen._default_, die nur mit IP-basierten
virtuellen Hosts verwendet wird, um nicht zugewiesene IP-Adressen
aufzufangen.
<VirtualHost 10.1.2.3>
ServerAdmin webmaster@host.foo.com
DocumentRoot /www/docs/host.foo.com
ServerName host.foo.com
ErrorLog logs/host.foo.com-error_log
TransferLog logs/host.foo.com-access_log
</VirtualHost>
IPv6-Adressen müssen in eckigen Klammern angegeben werden, da die optionale Portnummer sonst nicht erkannt werden kann. Hier ein IPv6-Beispiel:
<VirtualHost [2001:db8::a00:20ff:fea7:ccea]>
ServerAdmin webmaster@host.example.com
DocumentRoot /www/docs/host.example.com
ServerName host.example.com
ErrorLog logs/host.example.com-error_log
TransferLog logs/host.example.com-access_log
</VirtualHost>
Jeder virtuelle Host muss einer anderen IP-Adresse, einem anderen Port
oder einem anderen Hostnamen für den Server entsprechen. Im ersten
Fall muss die Servermaschine so eingerichtet sein, dass sie IP-Pakete
für mehrere Adressen akzeptiert. (Wenn der Rechner nicht mehrere
Netzwerkkarten besitzt, kann dies mit dem Befehl ifconfig
alias durchgeführt werden -- sofern Ihr Betriebssystem das
unterstützt).
Die Verwendung von <VirtualHost>
beeinflusst nicht, an welchen Adressen der Apache
lauscht. Sie müssen mit Listen sicherstellen, dass der Apache
an der richtigen Adresse lauscht.
Bei der Verwendung IP-basierter virtuellen Hosts kann der spezielle
Name _default_ benutzt werden. In diesem Fall weist
der Apache jede IP-Adresse diesem virtuellen Host zu, die nicht explizit in
einem anderen virtuellen Host angegeben ist. Falls kein virtueller Host
_default_ angegeben ist, wird die "Hauptserver"-Konfiguration,
die aus allen Definitionen außerhalb der Virtual-Host-Abschnitte
besteht, für nicht passende IPs verwendet. (Beachten Sie jedoch,
dass eine IP-Adressen die zu einer NameVirtualHost-Anweisung passt, weder den
"Hauptserver" noch den virtuellen Host _default_ verwendet.
Lesen Sie für weitere Details die Dokumentation zu namensbasierten virtuell Hosts.)
Sie können einen speziellen :Port angeben,
um den entsprechenden Port zu wechseln. Falls nicht angegeben, wird
er auf den gleichen Port voreingestellt, wie die letzte
Listen-Anweisung des
Hauptservers. Sie können auch :* angeben, um alle
Ports dieser Adresse zu akzeptieren. (Dies wird zusammen mit
_default_ empfohlen.)
Lesen Sie das Dokument Sicherheitshinweise für Details, warum Ihre Sicherheit gefährdet sein kann, wenn das Verzeichnis, in dem Protokolldateien gespeichert werden, für jemanden anderes als den Benutzer beschreibbar ist, der den Server gestartet hat.
Apache HTTP Server Version 2.4
| Description: | Strong cryptography using the Secure Sockets Layer (SSL) and Transport Layer Security (TLS) protocols |
|---|---|
| Status: | Extension |
| Module Identifier: | ssl_module |
| Source File: | mod_ssl.c |
This module provides SSL v3 and TLS v1.x support for the Apache HTTP Server. SSL v2 is no longer supported.
This module relies on OpenSSL to provide the cryptography engine.
Further details, discussion, and examples are provided in the SSL documentation.
Environment Variables Custom Log Formats Request Notes Expression Parser Extension Authorization providers for use with Require SSLCACertificateFile SSLCACertificatePath SSLCADNRequestFile SSLCADNRequestPath SSLCARevocationCheck SSLCARevocationFile SSLCARevocationPath SSLCertificateChainFile SSLCertificateFile SSLCertificateKeyFile SSLCipherSuite SSLCompression SSLCryptoDevice SSLEngine SSLFIPS SSLHonorCipherOrder SSLInsecureRenegotiation SSLOCSPDefaultResponder SSLOCSPEnable SSLOCSPNoverify SSLOCSPOverrideResponder SSLOCSPProxyURL SSLOCSPResponderCertificateFile SSLOCSPResponderTimeout SSLOCSPResponseMaxAge SSLOCSPResponseTimeSkew SSLOCSPUseRequestNonce SSLOpenSSLConfCmd SSLOptions SSLPassPhraseDialog SSLProtocol SSLProxyCACertificateFile SSLProxyCACertificatePath SSLProxyCARevocationCheck SSLProxyCARevocationFile SSLProxyCARevocationPath SSLProxyCheckPeerCN SSLProxyCheckPeerExpire SSLProxyCheckPeerName SSLProxyCipherSuite SSLProxyEngine SSLProxyMachineCertificateChainFile SSLProxyMachineCertificateFile SSLProxyMachineCertificatePath SSLProxyProtocol SSLProxyVerify SSLProxyVerifyDepth SSLRandomSeed SSLRenegBufferSize SSLRequire SSLRequireSSL SSLSessionCache SSLSessionCacheTimeout SSLSessionTicketKeyFile SSLSessionTickets SSLSRPUnknownUserSeed SSLSRPVerifierFile SSLStaplingCache SSLStaplingErrorCacheTimeout SSLStaplingFakeTryLater SSLStaplingForceURL SSLStaplingResponderTimeout SSLStaplingResponseMaxAge SSLStaplingResponseTimeSkew SSLStaplingReturnResponderErrors SSLStaplingStandardCacheTimeout SSLStrictSNIVHostCheck SSLUserName SSLUseStapling SSLVerifyClient SSLVerifyDepthThis module can be configured to provide several items of SSL information
as additional environment variables to the SSI and CGI namespace. Except for
HTTPS and SSL_TLS_SNI which are always defined, this
information is not provided by default for performance reasons. (See
SSLOptions StdEnvVars, below)
The generated variables
are listed in the table below. For backward compatibility the information can
be made available under different names, too. Look in the Compatibility chapter for details on the
compatibility variables.
| Variable Name | Value Type | Description |
|---|---|---|
HTTPS | flag | HTTPS is being used. |
SSL_PROTOCOL | string | The SSL protocol version (SSLv3, TLSv1, TLSv1.1, TLSv1.2) |
SSL_SESSION_ID | string | The hex-encoded SSL session id |
SSL_SESSION_RESUMED | string | Initial or Resumed SSL Session. Note: multiple requests may be served over the same (Initial or Resumed) SSL session if HTTP KeepAlive is in use |
SSL_SECURE_RENEG | string | true if secure renegotiation is supported, else false |
SSL_CIPHER | string | The cipher specification name |
SSL_CIPHER_EXPORT | string | true if cipher is an export cipher |
SSL_CIPHER_USEKEYSIZE | number | Number of cipher bits (actually used) |
SSL_CIPHER_ALGKEYSIZE | number | Number of cipher bits (possible) |
SSL_COMPRESS_METHOD | string | SSL compression method negotiated |
SSL_VERSION_INTERFACE | string | The mod_ssl program version |
SSL_VERSION_LIBRARY | string | The OpenSSL program version |
SSL_CLIENT_M_VERSION | string | The version of the client certificate |
SSL_CLIENT_M_SERIAL | string | The serial of the client certificate |
SSL_CLIENT_S_DN | string | Subject DN in client's certificate |
SSL_CLIENT_S_DN_x509 | string | Component of client's Subject DN |
SSL_CLIENT_SAN_Email_n | string | Client certificate's subjectAltName extension entries of type rfc822Name |
SSL_CLIENT_SAN_DNS_n | string | Client certificate's subjectAltName extension entries of type dNSName |
SSL_CLIENT_SAN_OTHER_msUPN_n | string | Client certificate's subjectAltName extension entries of type otherName, Microsoft User Principal Name form (OID 1.3.6.1.4.1.311.20.2.3) |
SSL_CLIENT_I_DN | string | Issuer DN of client's certificate |
SSL_CLIENT_I_DN_x509 | string | Component of client's Issuer DN |
SSL_CLIENT_V_START | string | Validity of client's certificate (start time) |
SSL_CLIENT_V_END | string | Validity of client's certificate (end time) |
SSL_CLIENT_V_REMAIN | string | Number of days until client's certificate expires |
SSL_CLIENT_A_SIG | string | Algorithm used for the signature of client's certificate |
SSL_CLIENT_A_KEY | string | Algorithm used for the public key of client's certificate |
SSL_CLIENT_CERT | string | PEM-encoded client certificate |
SSL_CLIENT_CERT_CHAIN_n | string | PEM-encoded certificates in client certificate chain |
SSL_CLIENT_CERT_RFC4523_CEA | string | Serial number and issuer of the certificate. The format matches that of the CertificateExactAssertion in RFC4523 |
SSL_CLIENT_VERIFY | string | NONE, SUCCESS, GENEROUS or FAILED:reason |
SSL_SERVER_M_VERSION | string | The version of the server certificate |
SSL_SERVER_M_SERIAL | string | The serial of the server certificate |
SSL_SERVER_S_DN | string | Subject DN in server's certificate |
SSL_SERVER_SAN_Email_n | string | Server certificate's subjectAltName extension entries of type rfc822Name |
SSL_SERVER_SAN_DNS_n | string | Server certificate's subjectAltName extension entries of type dNSName |
SSL_SERVER_SAN_OTHER_dnsSRV_n | string | Server certificate's subjectAltName extension entries of type otherName, SRVName form (OID 1.3.6.1.5.5.7.8.7, RFC 4985) |
SSL_SERVER_S_DN_x509 | string | Component of server's Subject DN |
SSL_SERVER_I_DN | string | Issuer DN of server's certificate |
SSL_SERVER_I_DN_x509 | string | Component of server's Issuer DN |
SSL_SERVER_V_START | string | Validity of server's certificate (start time) |
SSL_SERVER_V_END | string | Validity of server's certificate (end time) |
SSL_SERVER_A_SIG | string | Algorithm used for the signature of server's certificate |
SSL_SERVER_A_KEY | string | Algorithm used for the public key of server's certificate |
SSL_SERVER_CERT | string | PEM-encoded server certificate |
SSL_SRP_USER | string | SRP username |
SSL_SRP_USERINFO | string | SRP user info |
SSL_TLS_SNI | string | Contents of the SNI TLS extension (if supplied with ClientHello) |
x509 specifies a component of an X.509 DN; one of
C,ST,L,O,OU,CN,T,I,G,S,D,UID,Email. In httpd 2.2.0 and
later, x509 may also include a numeric _n
suffix. If the DN in question contains multiple attributes of the
same name, this suffix is used as a zero-based index to select a
particular attribute. For example, where the server certificate
subject DN included two OU attributes, SSL_SERVER_S_DN_OU_0
and
SSL_SERVER_S_DN_OU_1 could be used to reference each. A
variable name without a _n suffix is equivalent to that
name with a _0 suffix; the first (or only) attribute.
When the environment table is populated using
the StdEnvVars option of
the SSLOptions directive, the
first (or only) attribute of any DN is added only under a non-suffixed
name; i.e. no _0 suffixed entries are added.
In httpd 2.4.32 and later, an optional _RAW suffix may be
added to x509 in a DN component, to suppress conversion of
the attribute value to UTF-8. This must be placed after the index
suffix (if any). For example, SSL_SERVER_S_DN_OU_RAW or
SSL_SERVER_S_DN_OU_0_RAW could be used.
The format of the *_DN variables has changed in Apache HTTPD
2.3.11. See the LegacyDNStringFormat option for
SSLOptions for details.
SSL_CLIENT_V_REMAIN is only available in version 2.1
and later.
A number of additional environment variables can also be used
in SSLRequire expressions, or in custom log
formats:
HTTP_USER_AGENT PATH_INFO AUTH_TYPE HTTP_REFERER QUERY_STRING SERVER_SOFTWARE HTTP_COOKIE REMOTE_HOST API_VERSION HTTP_FORWARDED REMOTE_IDENT TIME_YEAR HTTP_HOST IS_SUBREQ TIME_MON HTTP_PROXY_CONNECTION DOCUMENT_ROOT TIME_DAY HTTP_ACCEPT SERVER_ADMIN TIME_HOUR THE_REQUEST SERVER_NAME TIME_MIN REQUEST_FILENAME SERVER_PORT TIME_SEC REQUEST_METHOD SERVER_PROTOCOL TIME_WDAY REQUEST_SCHEME REMOTE_ADDR TIME REQUEST_URI REMOTE_USER
In these contexts, two special formats can also be used:
ENV:variablenameHTTP:headernameWhen mod_ssl is built into Apache or at least
loaded (under DSO situation) additional functions exist for the Custom Log Format of
mod_log_config. First there is an
additional ``%{varname}x''
eXtension format function which can be used to expand any variables
provided by any module, especially those provided by mod_ssl which can
you find in the above table.
For backward compatibility there is additionally a special
``%{name}c'' cryptography format function
provided. Information about this function is provided in the Compatibility chapter.
CustomLog "logs/ssl_request_log" "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
These formats even work without setting the StdEnvVars
option of the SSLOptions
directive.
mod_ssl sets "notes" for the request which can be
used in logging with the %{name}n format
string in mod_log_config.
The notes supported are as follows:
ssl-access-forbidden1 if access was
denied due to an SSLRequire
or SSLRequireSSL directive.ssl-secure-renegmod_ssl is built against a version of
OpenSSL which supports the secure renegotiation extension, this note
is set to the value 1 if SSL is in used for the current
connection, and the client also supports the secure renegotiation
extension. If the client does not support the secure renegotiation
extension, the note is set to the value 0.
If mod_ssl is not built against a version of
OpenSSL which supports secure renegotiation, or if SSL is not in use
for the current connection, the note is not set.When mod_ssl is built into Apache or at least
loaded (under DSO situation) any variables
provided by mod_ssl can be used in expressions
for the ap_expr Expression Parser.
The variables can be referenced using the syntax
``%{varname}''. Starting
with version 2.4.18 one can also use the
mod_rewrite style syntax
``%{SSL:varname}'' or
the function style syntax
``ssl(varname)''.
mod_headers)Header set X-SSL-PROTOCOL "expr=%{SSL_PROTOCOL}"
Header set X-SSL-CIPHER "expr=%{SSL:SSL_CIPHER}"
This feature even works without setting the StdEnvVars
option of the SSLOptions
directive.
mod_ssl provides a few authentication providers for use
with mod_authz_core's
Require directive.
The ssl provider denies access if a connection is not
encrypted with SSL. This is similar to the
SSLRequireSSL directive.
Require ssl
The ssl provider allows access if the user is
authenticated with a valid client certificate. This is only
useful if SSLVerifyClient optional is in effect.
The following example grants access if the user is authenticated either with a client certificate or by username and password.
Require ssl-verify-client Require valid-user
| Description: | File of concatenated PEM-encoded CA Certificates for Client Auth |
|---|---|
| Syntax: | SSLCACertificateFile file-path |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This directive sets the all-in-one file where you can assemble the
Certificates of Certification Authorities (CA) whose clients you deal
with. These are used for Client Authentication. Such a file is simply the
concatenation of the various PEM-encoded Certificate files, in order of
preference. This can be used alternatively and/or additionally to
SSLCACertificatePath.
SSLCACertificateFile "/usr/local/apache2/conf/ssl.crt/ca-bundle-client.crt"
| Description: | Directory of PEM-encoded CA Certificates for Client Auth |
|---|---|
| Syntax: | SSLCACertificatePath directory-path |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This directive sets the directory where you keep the Certificates of Certification Authorities (CAs) whose clients you deal with. These are used to verify the client certificate on Client Authentication.
The files in this directory have to be PEM-encoded and are accessed through
hash filenames. So usually you can't just place the Certificate files
there: you also have to create symbolic links named
hash-value.N. And you should always make sure this directory
contains the appropriate symbolic links.
SSLCACertificatePath "/usr/local/apache2/conf/ssl.crt/"
| Description: | File of concatenated PEM-encoded CA Certificates for defining acceptable CA names |
|---|---|
| Syntax: | SSLCADNRequestFile file-path |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
When a client certificate is requested by mod_ssl, a list of acceptable Certificate Authority names is sent to the client in the SSL handshake. These CA names can be used by the client to select an appropriate client certificate out of those it has available.
If neither of the directives SSLCADNRequestPath or SSLCADNRequestFile are given, then the
set of acceptable CA names sent to the client is the names of all the
CA certificates given by the SSLCACertificateFile and SSLCACertificatePath directives; in other
words, the names of the CAs which will actually be used to verify the
client certificate.
In some circumstances, it is useful to be able to send a set of
acceptable CA names which differs from the actual CAs used to verify
the client certificate - for example, if the client certificates are
signed by intermediate CAs. In such cases, SSLCADNRequestPath and/or SSLCADNRequestFile can be used; the
acceptable CA names are then taken from the complete set of
certificates in the directory and/or file specified by this pair of
directives.
SSLCADNRequestFile must
specify an all-in-one file containing a concatenation of
PEM-encoded CA certificates.
SSLCADNRequestFile "/usr/local/apache2/conf/ca-names.crt"
| Description: | Directory of PEM-encoded CA Certificates for defining acceptable CA names |
|---|---|
| Syntax: | SSLCADNRequestPath directory-path |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This optional directive can be used to specify the set of
acceptable CA names which will be sent to the client when a
client certificate is requested. See the SSLCADNRequestFile directive for more
details.
The files in this directory have to be PEM-encoded and are accessed
through hash filenames. So usually you can't just place the
Certificate files there: you also have to create symbolic links named
hash-value.N. And you should always make sure
this directory contains the appropriate symbolic links.
SSLCADNRequestPath "/usr/local/apache2/conf/ca-names.crt/"
| Description: | Enable CRL-based revocation checking |
|---|---|
| Syntax: | SSLCARevocationCheck chain|leaf|none [flags ...] |
| Default: | SSLCARevocationCheck none |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Optional flags available in httpd 2.4.21 or later |
Enables certificate revocation list (CRL) checking. At least one of
SSLCARevocationFile
or SSLCARevocationPath must be
configured. When set to chain (recommended setting),
CRL checks are applied to all certificates in the chain, while setting it to
leaf limits the checks to the end-entity cert.
The available flags are:
no_crl_for_cert_ok
Prior to version 2.3.15, CRL checking in mod_ssl also succeeded when
no CRL(s) for the checked certificate(s) were found in any of the locations
configured with SSLCARevocationFile
or SSLCARevocationPath.
With the introduction of SSLCARevocationFile,
the behavior has been changed: by default with chain or
leaf, CRLs must be present for the
validation to succeed - otherwise it will fail with an
"unable to get certificate CRL" error.
The flag no_crl_for_cert_ok allows to restore
previous behaviour.
SSLCARevocationCheck chain
SSLCARevocationCheck chain no_crl_for_cert_ok
| Description: | File of concatenated PEM-encoded CA CRLs for Client Auth |
|---|---|
| Syntax: | SSLCARevocationFile file-path |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This directive sets the all-in-one file where you can
assemble the Certificate Revocation Lists (CRL) of Certification
Authorities (CA) whose clients you deal with. These are used
for Client Authentication. Such a file is simply the concatenation of
the various PEM-encoded CRL files, in order of preference. This can be
used alternatively and/or additionally to SSLCARevocationPath.
SSLCARevocationFile "/usr/local/apache2/conf/ssl.crl/ca-bundle-client.crl"
| Description: | Directory of PEM-encoded CA CRLs for Client Auth |
|---|---|
| Syntax: | SSLCARevocationPath directory-path |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This directive sets the directory where you keep the Certificate Revocation Lists (CRL) of Certification Authorities (CAs) whose clients you deal with. These are used to revoke the client certificate on Client Authentication.
The files in this directory have to be PEM-encoded and are accessed through
hash filenames. So usually you have not only to place the CRL files there.
Additionally you have to create symbolic links named
hash-value.rN. And you should always make sure this directory
contains the appropriate symbolic links.
SSLCARevocationPath "/usr/local/apache2/conf/ssl.crl/"
| Description: | File of PEM-encoded Server CA Certificates |
|---|---|
| Syntax: | SSLCertificateChainFile file-path |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
SSLCertificateChainFile became obsolete with version 2.4.8,
when SSLCertificateFile
was extended to also load intermediate CA certificates from the server
certificate file.
This directive sets the optional all-in-one file where you can assemble the certificates of Certification Authorities (CA) which form the certificate chain of the server certificate. This starts with the issuing CA certificate of the server certificate and can range up to the root CA certificate. Such a file is simply the concatenation of the various PEM-encoded CA Certificate files, usually in certificate chain order.
This should be used alternatively and/or additionally to SSLCACertificatePath for explicitly
constructing the server certificate chain which is sent to the browser
in addition to the server certificate. It is especially useful to
avoid conflicts with CA certificates when using client
authentication. Because although placing a CA certificate of the
server certificate chain into SSLCACertificatePath has the same effect
for the certificate chain construction, it has the side-effect that
client certificates issued by this same CA certificate are also
accepted on client authentication.
But be careful: Providing the certificate chain works only if you are using a single RSA or DSA based server certificate. If you are using a coupled RSA+DSA certificate pair, this will work only if actually both certificates use the same certificate chain. Else the browsers will be confused in this situation.
SSLCertificateChainFile "/usr/local/apache2/conf/ssl.crt/ca.crt"
| Description: | Server PEM-encoded X.509 certificate data file or token identifier |
|---|---|
| Syntax: | SSLCertificateFile file-path|certid |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | certid available in 2.4.42 and later. |
This directive points to a file with certificate data in PEM format, or the certificate identifier through a configured cryptographic token.
If using a PEM file, at minimum, the file must include an end-entity (leaf) certificate.
The directive can be used multiple times (referencing different filenames)
to support multiple algorithms for server authentication - typically
RSA, DSA, and ECC. The number of supported algorithms depends on the
OpenSSL version being used for mod_ssl: with version 1.0.0 or later,
openssl list-public-key-algorithms will output a list
of supported algorithms, see also the note below about limitations
of OpenSSL versions prior to 1.0.2 and the ways to work around them.
The files may also include intermediate CA certificates, sorted from
leaf to root. This is supported with version 2.4.8 and later,
and obsoletes SSLCertificateChainFile.
When running with OpenSSL 1.0.2 or later, this allows
to configure the intermediate CA chain on a per-certificate basis.
Custom DH parameters and an EC curve name for ephemeral keys,
can also be added to end of the first file configured using
SSLCertificateFile.
This is supported in version 2.4.7 or later.
Such parameters can be generated using the commands
openssl dhparam and openssl ecparam.
The parameters can be added as-is to the end of the first
certificate file. Only the first file can be used for custom
parameters, as they are applied independently of the authentication
algorithm type.
Finally the end-entity certificate's private key can also be
added to the certificate file instead of using a separate
SSLCertificateKeyFile
directive. This practice is highly discouraged. If it is used,
the certificate files using such an embedded key must be configured
after the certificates using a separate key file. If the private
key is encrypted, the pass phrase dialog is forced at startup time.
As an alternative to storing certificates and private keys in
files, a certificate identifier can be used to identify a certificate
stored in a token. Currently, only PKCS#11 URIs are
recognized as certificate identifiers, and can be used in conjunction
with the OpenSSL pkcs11 engine or provider. If SSLCertificateKeyFile is omitted, the
certificate and private key can be loaded through the single
identifier specified with SSLCertificateFile.
Beginning with version 2.4.7, mod_ssl makes use of standardized DH parameters with prime lengths of 2048, 3072 and 4096 bits and with additional prime lengths of 6144 and 8192 bits beginning with version 2.4.10 (from RFC 3526), and hands them out to clients based on the length of the certificate's RSA/DSA key. With Java-based clients in particular (Java 7 or earlier), this may lead to handshake failures - see this FAQ answer for working around such issues.
When using multiple certificates to support different authentication algorithms
(like RSA, DSA, but mainly ECC) and OpenSSL prior to 1.0.2, it is recommended
to either use custom DH parameters (preferably) by adding them to the
first certificate file (as described above), or to order the
SSLCertificateFile directives such that RSA/DSA
certificates are placed after the ECC one.
This is due to a limitation in older versions of OpenSSL which don't let the Apache HTTP Server determine the currently selected certificate at handshake time (when the DH parameters must be sent to the peer) but instead always provide the last configured certificate. Consequently, the server may select default DH parameters based on the length of the wrong certificate's key (ECC keys are much smaller than RSA/DSA ones and their length is not relevant for selecting DH primes).
Since custom DH parameters always take precedence over the default ones, this issue can be avoided by creating and configuring them (as described above), thus using a custom/suitable length.
# Example using a PEM-encoded file. SSLCertificateFile "/usr/local/apache2/conf/ssl.crt/server.crt" # Example use of a certificate and private key from a PKCS#11 token: SSLCertificateFile "pkcs11:token=My%20Token%20Name;id=45"
| Description: | Server PEM-encoded private key file |
|---|---|
| Syntax: | SSLCertificateKeyFile file-path|keyid |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | keyid available in 2.4.42 and later. |
This directive points to the PEM-encoded private key file for the server, or the key ID through a configured cryptographic token. If the contained private key is encrypted, the pass phrase dialog is forced at startup time.
The directive can be used multiple times (referencing different filenames)
to support multiple algorithms for server authentication. For each
SSLCertificateKeyFile
directive, there must be a matching SSLCertificateFile
directive.
The private key may also be combined with the certificate in the file given by
SSLCertificateFile, but this practice
is highly discouraged. If it is used, the certificate files using such
an embedded key must be configured after the certificates using a separate
key file.
As an alternative to storing private keys in files, a key
identifier can be used to identify a private key stored in a
token. Currently, only PKCS#11 URIs are recognized as private key
identifiers, and can be used in conjunction with the OpenSSL
pkcs11 engine or provider.
# To use a private key from a PEM-encoded file: SSLCertificateKeyFile "/usr/local/apache2/conf/ssl.key/server.key" # To use a private key from a PKCS#11 token: SSLCertificateKeyFile "pkcs11:token=My%20Token%20Name;id=45"
| Description: | Cipher Suite available for negotiation in SSL handshake |
|---|---|
| Syntax: | SSLCipherSuite [protocol] cipher-spec |
| Default: | SSLCipherSuite DEFAULT (depends on OpenSSL version) |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_ssl |
This complex directive uses a colon-separated cipher-spec string consisting of OpenSSL cipher specifications to configure the Cipher Suite the client is permitted to negotiate in the SSL handshake phase. The optional protocol specifier can configure the Cipher Suite for a specific SSL version. Possible values include "SSL" for all SSL Protocols up to and including TLSv1.2.
Notice that this directive can be used both in per-server and per-directory context. In per-server context it applies to the standard SSL handshake when a connection is established. In per-directory context it forces a SSL renegotiation with the reconfigured Cipher Suite after the HTTP request was read but before the HTTP response is sent.
If the SSL library supports TLSv1.3 (OpenSSL 1.1.1 and later), the protocol specifier "TLSv1.3" can be used to configure the cipher suites for that protocol. Since TLSv1.3 does not offer renegotiations, specifying ciphers for it in a directory context is not allowed.
For a list of TLSv1.3 cipher names, see the OpenSSL documentation.
An SSL cipher specification in cipher-spec is composed of 4 major attributes plus a few extra minor ones:
An SSL cipher can also be an export cipher. SSLv2 ciphers are no longer supported. To specify which ciphers to use, one can either specify all the Ciphers, one at a time, or use aliases to specify the preference and order for the ciphers (see Table 1). The actually available ciphers and aliases depends on the used openssl version. Newer openssl versions may include additional ciphers.
| Tag | Description |
|---|---|
| Key Exchange Algorithm: | |
kRSA | RSA key exchange |
kDHr | Diffie-Hellman key exchange with RSA key |
kDHd | Diffie-Hellman key exchange with DSA key |
kEDH | Ephemeral (temp.key) Diffie-Hellman key exchange (no cert) |
kSRP | Secure Remote Password (SRP) key exchange |
| Authentication Algorithm: | |
aNULL | No authentication |
aRSA | RSA authentication |
aDSS | DSS authentication |
aDH | Diffie-Hellman authentication |
| Cipher Encoding Algorithm: | |
eNULL | No encryption |
NULL | alias for eNULL |
AES | AES encryption |
DES | DES encryption |
3DES | Triple-DES encryption |
RC4 | RC4 encryption |
RC2 | RC2 encryption |
IDEA | IDEA encryption |
| MAC Digest Algorithm: | |
MD5 | MD5 hash function |
SHA1 | SHA1 hash function |
SHA | alias for SHA1 |
SHA256 | SHA256 hash function |
SHA384 | SHA384 hash function |
| Aliases: | |
SSLv3 | all SSL version 3.0 ciphers |
TLSv1 | all TLS version 1.0 ciphers |
EXP | all export ciphers |
EXPORT40 | all 40-bit export ciphers only |
EXPORT56 | all 56-bit export ciphers only |
LOW | all low strength ciphers (no export, single DES) |
MEDIUM | all ciphers with 128 bit encryption |
HIGH | all ciphers using Triple-DES |
RSA | all ciphers using RSA key exchange |
DH | all ciphers using Diffie-Hellman key exchange |
EDH | all ciphers using Ephemeral Diffie-Hellman key exchange |
ECDH | Elliptic Curve Diffie-Hellman key exchange |
ADH | all ciphers using Anonymous Diffie-Hellman key exchange |
AECDH | all ciphers using Anonymous Elliptic Curve Diffie-Hellman key exchange |
SRP | all ciphers using Secure Remote Password (SRP) key exchange |
DSS | all ciphers using DSS authentication |
ECDSA | all ciphers using ECDSA authentication |
aNULL | all ciphers using no authentication |
Now where this becomes interesting is that these can be put together
to specify the order and ciphers you wish to use. To speed this up
there are also aliases (SSLv3, TLSv1, EXP, LOW, MEDIUM,
HIGH) for certain groups of ciphers. These tags can be joined
together with prefixes to form the cipher-spec. Available
prefixes are:
+: move matching ciphers to the current location in list-: remove cipher from list (can be added later again)!: kill cipher from list completely (can not be added later again)aNULL, eNULL and EXP
ciphers are always disabledBeginning with version 2.4.7, null and export-grade
ciphers are always disabled, as mod_ssl unconditionally adds
!aNULL:!eNULL:!EXP to any cipher string at initialization.
A simpler way to look at all of this is to use the ``openssl ciphers
-v'' command which provides a nice way to successively create the
correct cipher-spec string. The default cipher-spec string
depends on the version of the OpenSSL libraries used. Let's suppose it is
``RC4-SHA:AES128-SHA:HIGH:MEDIUM:!aNULL:!MD5'' which
means the following: Put RC4-SHA and AES128-SHA at
the beginning. We do this, because these ciphers offer a good compromise
between speed and security. Next, include high and medium security ciphers.
Finally, remove all ciphers which do not authenticate, i.e. for SSL the
Anonymous Diffie-Hellman ciphers, as well as all ciphers which use
MD5 as hash algorithm, because it has been proven insufficient.
$ openssl ciphers -v 'RC4-SHA:AES128-SHA:HIGH:MEDIUM:!aNULL:!MD5' RC4-SHA SSLv3 Kx=RSA Au=RSA Enc=RC4(128) Mac=SHA1 AES128-SHA SSLv3 Kx=RSA Au=RSA Enc=AES(128) Mac=SHA1 DHE-RSA-AES256-SHA SSLv3 Kx=DH Au=RSA Enc=AES(256) Mac=SHA1 ... ... ... ... ... SEED-SHA SSLv3 Kx=RSA Au=RSA Enc=SEED(128) Mac=SHA1 PSK-RC4-SHA SSLv3 Kx=PSK Au=PSK Enc=RC4(128) Mac=SHA1 KRB5-RC4-SHA SSLv3 Kx=KRB5 Au=KRB5 Enc=RC4(128) Mac=SHA1
The complete list of particular RSA & DH ciphers for SSL is given in Table 2.
SSLCipherSuite RSA:!EXP:!NULL:+HIGH:+MEDIUM:-LOW
| Cipher-Tag | Protocol | Key Ex. | Auth. | Enc. | MAC | Type |
|---|---|---|---|---|---|---|
| RSA Ciphers: | ||||||
DES-CBC3-SHA | SSLv3 | RSA | RSA | 3DES(168) | SHA1 | |
IDEA-CBC-SHA | SSLv3 | RSA | RSA | IDEA(128) | SHA1 | |
RC4-SHA | SSLv3 | RSA | RSA | RC4(128) | SHA1 | |
RC4-MD5 | SSLv3 | RSA | RSA | RC4(128) | MD5 | |
DES-CBC-SHA | SSLv3 | RSA | RSA | DES(56) | SHA1 | |
EXP-DES-CBC-SHA | SSLv3 | RSA(512) | RSA | DES(40) | SHA1 | export |
EXP-RC2-CBC-MD5 | SSLv3 | RSA(512) | RSA | RC2(40) | MD5 | export |
EXP-RC4-MD5 | SSLv3 | RSA(512) | RSA | RC4(40) | MD5 | export |
NULL-SHA | SSLv3 | RSA | RSA | None | SHA1 | |
NULL-MD5 | SSLv3 | RSA | RSA | None | MD5 | |
| Diffie-Hellman Ciphers: | ||||||
ADH-DES-CBC3-SHA | SSLv3 | DH | None | 3DES(168) | SHA1 | |
ADH-DES-CBC-SHA | SSLv3 | DH | None | DES(56) | SHA1 | |
ADH-RC4-MD5 | SSLv3 | DH | None | RC4(128) | MD5 | |
EDH-RSA-DES-CBC3-SHA | SSLv3 | DH | RSA | 3DES(168) | SHA1 | |
EDH-DSS-DES-CBC3-SHA | SSLv3 | DH | DSS | 3DES(168) | SHA1 | |
EDH-RSA-DES-CBC-SHA | SSLv3 | DH | RSA | DES(56) | SHA1 | |
EDH-DSS-DES-CBC-SHA | SSLv3 | DH | DSS | DES(56) | SHA1 | |
EXP-EDH-RSA-DES-CBC-SHA | SSLv3 | DH(512) | RSA | DES(40) | SHA1 | export |
EXP-EDH-DSS-DES-CBC-SHA | SSLv3 | DH(512) | DSS | DES(40) | SHA1 | export |
EXP-ADH-DES-CBC-SHA | SSLv3 | DH(512) | None | DES(40) | SHA1 | export |
EXP-ADH-RC4-MD5 | SSLv3 | DH(512) | None | RC4(40) | MD5 | export |
| Description: | Enable compression on the SSL level |
|---|---|
| Syntax: | SSLCompression on|off |
| Default: | SSLCompression off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in httpd 2.4.3 and later, if using OpenSSL 0.9.8 or later;
virtual host scope available if using OpenSSL 1.0.0 or later.
The default used to be on in version 2.4.3. |
This directive allows to enable compression on the SSL level.
Enabling compression causes security issues in most setups (the so called CRIME attack).
| Description: | Enable use of a cryptographic hardware accelerator |
|---|---|
| Syntax: | SSLCryptoDevice engine |
| Default: | SSLCryptoDevice builtin |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ssl |
This directive enables use of a cryptographic hardware accelerator board to offload some of the SSL processing overhead. This directive can only be used if the SSL toolkit is built with "engine" support; OpenSSL 0.9.7 and later releases have "engine" support by default, the separate "-engine" releases of OpenSSL 0.9.6 must be used.
To discover which engine names are supported, run the command
"openssl engine".
# For a Broadcom accelerator: SSLCryptoDevice ubsec
With OpenSSL 3.0 or later, if no engine is specified but the key or certificate is specified using a PKCS#11 URIs then it is tried to load the key and certificate from an OpenSSL provider. The OpenSSL provider to use must be defined and configured in the OpenSSL config file, and it must support the STORE method for PKCS#11 URIs.
| Description: | SSL Engine Operation Switch |
|---|---|
| Syntax: | SSLEngine on|off|optional |
| Default: | SSLEngine off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This directive toggles the usage of the SSL/TLS Protocol Engine. This
is should be used inside a <VirtualHost> section to enable SSL/TLS for a
that virtual host. By default the SSL/TLS Protocol Engine is
disabled for both the main server and all configured virtual hosts.
<VirtualHost _default_:443> SSLEngine on #... </VirtualHost>
In Apache 2.1 and later, SSLEngine can be set to
optional. This enables support for
RFC 2817, Upgrading to TLS
Within HTTP/1.1. At this time no web browsers support RFC 2817.
| Description: | SSL FIPS mode Switch |
|---|---|
| Syntax: | SSLFIPS on|off |
| Default: | SSLFIPS off |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ssl |
This directive toggles the usage of the SSL library FIPS_mode flag. It must be set in the global server context and cannot be configured with conflicting settings (SSLFIPS on followed by SSLFIPS off or similar). The mode applies to all SSL library operations.
If httpd was compiled against an SSL library which did not support
the FIPS_mode flag, SSLFIPS on will fail. Refer to the
FIPS 140-2 Security Policy document of the SSL provider library for
specific requirements to use mod_ssl in a FIPS 140-2 approved mode
of operation; note that mod_ssl itself is not validated, but may be
described as using FIPS 140-2 validated cryptographic module, when
all components are assembled and operated under the guidelines imposed
by the applicable Security Policy.
| Description: | Option to prefer the server's cipher preference order |
|---|---|
| Syntax: | SSLHonorCipherOrder on|off |
| Default: | SSLHonorCipherOrder off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
When choosing a cipher during an SSLv3 or TLSv1 handshake, normally the client's preference is used. If this directive is enabled, the server's preference will be used instead.
SSLHonorCipherOrder on
| Description: | Option to enable support for insecure renegotiation |
|---|---|
| Syntax: | SSLInsecureRenegotiation on|off |
| Default: | SSLInsecureRenegotiation off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in httpd 2.2.15 and later, if using OpenSSL 0.9.8m or later |
As originally specified, all versions of the SSL and TLS protocols (up to and including TLS/1.2) were vulnerable to a Man-in-the-Middle attack (CVE-2009-3555) during a renegotiation. This vulnerability allowed an attacker to "prefix" a chosen plaintext to the HTTP request as seen by the web server. A protocol extension was developed which fixed this vulnerability if supported by both client and server.
If mod_ssl is linked against OpenSSL version 0.9.8m
or later, by default renegotiation is only supported with
clients supporting the new protocol extension. If this directive is
enabled, renegotiation will be allowed with old (unpatched) clients,
albeit insecurely.
If this directive is enabled, SSL connections will be vulnerable to the Man-in-the-Middle prefix attack as described in CVE-2009-3555.
SSLInsecureRenegotiation on
The SSL_SECURE_RENEG environment variable can be used
from an SSI or CGI script to determine whether secure renegotiation is
supported for a given SSL connection.
| Description: | Set the default responder URI for OCSP validation |
|---|---|
| Syntax: | SSLOCSPDefaultResponder uri |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This option sets the default OCSP responder to use. If SSLOCSPOverrideResponder is not enabled,
the URI given will be used only if no responder URI is specified in
the certificate being verified.
| Description: | Enable OCSP validation of the client certificate chain |
|---|---|
| Syntax: | SSLOCSPEnable on|leaf|off |
| Default: | SSLOCSPEnable off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Mode leaf available in httpd 2.4.34 and later |
This option enables OCSP validation of the client certificate chain. If this option is enabled, certificates in the client's certificate chain will be validated against an OCSP responder after normal verification (including CRL checks) have taken place. In mode 'leaf', only the client certificate itself will be validated.
The OCSP responder used is either extracted from the certificate
itself, or derived by configuration; see the
SSLOCSPDefaultResponder and
SSLOCSPOverrideResponder
directives.
SSLVerifyClient on SSLOCSPEnable on SSLOCSPDefaultResponder "http://responder.example.com:8888/responder" SSLOCSPOverrideResponder on
| Description: | skip the OCSP responder certificates verification |
|---|---|
| Syntax: | SSLOCSPNoverify on|off |
| Default: | SSLOCSPNoverify off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in httpd 2.4.26 and later, if using OpenSSL 0.9.7 or later |
Skip the OCSP responder certificates verification, mostly useful when testing an OCSP server.
| Description: | Force use of the default responder URI for OCSP validation |
|---|---|
| Syntax: | SSLOCSPOverrideResponder on|off |
| Default: | SSLOCSPOverrideResponder off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This option forces the configured default OCSP responder to be used during OCSP certificate validation, regardless of whether the certificate being validated references an OCSP responder.
| Description: | Proxy URL to use for OCSP requests |
|---|---|
| Syntax: | SSLOCSPProxyURL url |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in httpd 2.4.19 and later |
This option allows to set the URL of a HTTP proxy that should be used for all queries to OCSP responders.
| Description: | Set of trusted PEM encoded OCSP responder certificates |
|---|---|
| Syntax: | SSLOCSPResponderCertificateFile file |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in httpd 2.4.26 and later, if using OpenSSL 0.9.7 or later |
This supplies a list of trusted OCSP responder certificates to be used during OCSP responder certificate validation. The supplied certificates are implicitly trusted without any further validation. This is typically used where the OCSP responder certificate is self signed or omitted from the OCSP response.
| Description: | Timeout for OCSP queries |
|---|---|
| Syntax: | SSLOCSPResponderTimeout seconds |
| Default: | SSLOCSPResponderTimeout 10 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This option sets the timeout for queries to OCSP responders, when
SSLOCSPEnable is turned on.
| Description: | Maximum allowable age for OCSP responses |
|---|---|
| Syntax: | SSLOCSPResponseMaxAge seconds |
| Default: | SSLOCSPResponseMaxAge -1 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This option sets the maximum allowable age ("freshness") for OCSP responses.
The default value (-1) does not enforce a maximum age,
which means that OCSP responses are considered valid as long as their
nextUpdate field is in the future.
| Description: | Maximum allowable time skew for OCSP response validation |
|---|---|
| Syntax: | SSLOCSPResponseTimeSkew seconds |
| Default: | SSLOCSPResponseTimeSkew 300 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This option sets the maximum allowable time skew for OCSP responses
(when checking their thisUpdate and nextUpdate fields).
| Description: | Use a nonce within OCSP queries |
|---|---|
| Syntax: | SSLOCSPUseRequestNonce on|off |
| Default: | SSLOCSPUseRequestNonce on |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in httpd 2.4.10 and later |
This option determines whether queries to OCSP responders should contain
a nonce or not. By default, a query nonce is always used and checked against
the response's one. When the responder does not use nonces (e.g. Microsoft OCSP
Responder), this option should be turned off.
| Description: | Configure OpenSSL parameters through its SSL_CONF API |
|---|---|
| Syntax: | SSLOpenSSLConfCmd command-name command-value |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in httpd 2.4.8 and later, if using OpenSSL 1.0.2 or later |
This directive exposes OpenSSL's SSL_CONF API to mod_ssl,
allowing a flexible configuration of OpenSSL parameters without the need
of implementing additional mod_ssl directives when new
features are added to OpenSSL.
The set of available SSLOpenSSLConfCmd commands
depends on the OpenSSL version being used for mod_ssl
(at least version 1.0.2 is required). For a list of supported command
names, see the section Supported configuration file commands in the
SSL_CONF_cmd(3) manual page for OpenSSL.
Some of the SSLOpenSSLConfCmd commands can be used
as an alternative to existing directives (such as
SSLCipherSuite or
SSLProtocol),
though it should be noted that the syntax / allowable values for the parameters
may sometimes differ.
SSLOpenSSLConfCmd Options -SessionTicket,ServerPreference SSLOpenSSLConfCmd ECDHParameters brainpoolP256r1 SSLOpenSSLConfCmd ServerInfoFile "/usr/local/apache2/conf/server-info.pem" SSLOpenSSLConfCmd Protocol "-ALL, TLSv1.2" SSLOpenSSLConfCmd SignatureAlgorithms RSA+SHA384:ECDSA+SHA256
| Description: | Configure various SSL engine run-time options |
|---|---|
| Syntax: | SSLOptions [+|-]option ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Extension |
| Module: | mod_ssl |
This directive can be used to control various run-time options on a
per-directory basis. Normally, if multiple SSLOptions
could apply to a directory, then the most specific one is taken
completely; the options are not merged. However if all the
options on the SSLOptions directive are preceded by a
plus (+) or minus (-) symbol, the options
are merged. Any options preceded by a + are added to the
options currently in force, and any options preceded by a
- are removed from the options currently in force.
The available options are:
StdEnvVars
When this option is enabled, the standard set of SSL related CGI/SSI environment variables are created. This per default is disabled for performance reasons, because the information extraction step is a rather expensive operation. So one usually enables this option for CGI and SSI requests only.
ExportCertData
When this option is enabled, additional CGI/SSI environment variables are
created: SSL_SERVER_CERT, SSL_CLIENT_CERT and
SSL_CLIENT_CERT_CHAIN_n (with n = 0,1,2,..).
These contain the PEM-encoded X.509 Certificates of server and client for
the current HTTPS connection and can be used by CGI scripts for deeper
Certificate checking. Additionally all other certificates of the client
certificate chain are provided, too. This bloats up the environment a
little bit which is why you have to use this option to enable it on
demand.
FakeBasicAuth
When this option is enabled, the Subject Distinguished Name (DN) of the
Client X509 Certificate is translated into a HTTP Basic Authorization
username. This means that the standard Apache authentication methods can
be used for access control. The user name is just the Subject of the
Client's X509 Certificate (can be determined by running OpenSSL's
openssl x509 command: openssl x509 -noout -subject -in
certificate.crt). Note that no password is
obtained from the user. Every entry in the user file needs this password:
``xxj31ZMTZzkVA'', which is the DES-encrypted version of the
word `password''. Those who live under MD5-based encryption
(for instance under FreeBSD or BSD/OS, etc.) should use the following MD5
hash of the same word: ``$1$OXLyS...$Owx8s2/m9/gfkcRVXzgoE/''.
Note that the AuthBasicFake
directive within mod_auth_basic can be used as a more
general mechanism for faking basic authentication, giving control over the
structure of both the username and password.
StrictRequire
This forces forbidden access when SSLRequireSSL or
SSLRequire successfully decided that access should be
forbidden. Usually the default is that in the case where a ``Satisfy
any'' directive is used, and other access restrictions are passed,
denial of access due to SSLRequireSSL or
SSLRequire is overridden (because that's how the Apache
Satisfy mechanism should work.) But for strict access restriction
you can use SSLRequireSSL and/or SSLRequire in
combination with an ``SSLOptions +StrictRequire''. Then an
additional ``Satisfy Any'' has no chance once mod_ssl has
decided to deny access.
OptRenegotiate
This enables optimized SSL connection renegotiation handling when SSL directives are used in per-directory context. By default a strict scheme is enabled where every per-directory reconfiguration of SSL parameters causes a full SSL renegotiation handshake. When this option is used mod_ssl tries to avoid unnecessary handshakes by doing more granular (but still safe) parameter checks. Nevertheless these granular checks sometimes may not be what the user expects, so enable this on a per-directory basis only, please.
LegacyDNStringFormat
This option influences how values of the
SSL_{CLIENT,SERVER}_{I,S}_DN variables are formatted. Since
version 2.3.11, Apache HTTPD uses a RFC 2253 compatible format by
default. This uses commas as delimiters between the attributes, allows the
use of non-ASCII characters (which are converted to UTF8), escapes
various special characters with backslashes, and sorts the attributes
with the "C" attribute last.
If LegacyDNStringFormat is set, the old format will be
used which sorts the "C" attribute first, uses slashes as separators, and
does not handle non-ASCII and special characters in any consistent way.
SSLOptions +FakeBasicAuth -StrictRequire
<Files ~ "\.(cgi|shtml)$">
SSLOptions +StdEnvVars -ExportCertData
</Files>
| Description: | Type of pass phrase dialog for encrypted private keys |
|---|---|
| Syntax: | SSLPassPhraseDialog type |
| Default: | SSLPassPhraseDialog builtin |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ssl |
When Apache starts up it has to read the various Certificate (see
SSLCertificateFile) and
Private Key (see SSLCertificateKeyFile) files of the
SSL-enabled virtual servers. Because for security reasons the Private
Key files are usually encrypted, mod_ssl needs to query the
administrator for a Pass Phrase in order to decrypt those files. This
query can be done in two ways which can be configured by
type:
builtin
This is the default where an interactive terminal dialog occurs at startup time just before Apache detaches from the terminal. Here the administrator has to manually enter the Pass Phrase for each encrypted Private Key file. Because a lot of SSL-enabled virtual hosts can be configured, the following reuse-scheme is used to minimize the dialog: When a Private Key file is encrypted, all known Pass Phrases (at the beginning there are none, of course) are tried. If one of those known Pass Phrases succeeds no dialog pops up for this particular Private Key file. If none succeeded, another Pass Phrase is queried on the terminal and remembered for the next round (where it perhaps can be reused).
This scheme allows mod_ssl to be maximally flexible (because for N encrypted Private Key files you can use N different Pass Phrases - but then you have to enter all of them, of course) while minimizing the terminal dialog (i.e. when you use a single Pass Phrase for all N Private Key files this Pass Phrase is queried only once).
|/path/to/program [args...]
This mode allows an external program to be used which acts as a
pipe to a particular input device; the program is sent the standard
prompt text used for the builtin mode on
stdin, and is expected to write password strings on
stdout. If several passwords are needed (or an
incorrect password is entered), additional prompt text will be
written subsequent to the first password being returned, and more
passwords must then be written back.
exec:/path/to/program
Here an external program is configured which is called at startup for each
encrypted Private Key file. It is called with two arguments (the first is
of the form ``servername:portnumber'', the second is either
``RSA'', ``DSA'', ``ECC'' or an
integer index starting at 3 if more than three keys are configured), which
indicate for which server and algorithm it has to print the corresponding
Pass Phrase to stdout. In versions 2.4.8 (unreleased)
and 2.4.9, it is called with one argument, a string of the
form ``servername:portnumber:index'' (with index
being a zero-based integer number), which indicate the server, TCP port
and certificate number. The intent is that this external
program first runs security checks to make sure that the system is not
compromised by an attacker, and only when these checks were passed
successfully it provides the Pass Phrase.
Both these security checks, and the way the Pass Phrase is determined, can
be as complex as you like. Mod_ssl just defines the interface: an
executable program which provides the Pass Phrase on stdout.
Nothing more or less! So, if you're really paranoid about security, here
is your interface. Anything else has to be left as an exercise to the
administrator, because local security requirements are so different.
The reuse-algorithm above is used here, too. In other words: The external program is called only once per unique Pass Phrase.
SSLPassPhraseDialog "exec:/usr/local/apache/sbin/pp-filter"
| Description: | Configure usable SSL/TLS protocol versions |
|---|---|
| Syntax: | SSLProtocol [+|-]protocol ... |
| Default: | SSLProtocol all -SSLv3 (up to 2.4.16: all) |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
This directive can be used to control which versions of the SSL/TLS protocol will be accepted in new connections.
The available (case-insensitive) protocols are:
SSLv3
This is the Secure Sockets Layer (SSL) protocol, version 3.0, from the Netscape Corporation. It is the successor to SSLv2 and the predecessor to TLSv1, but is deprecated in RFC 7568.
TLSv1
This is the Transport Layer Security (TLS) protocol, version 1.0. It is the successor to SSLv3 and is defined in RFC 2246. It is supported by nearly every client.
TLSv1.1 (when using OpenSSL 1.0.1 and later)
A revision of the TLS 1.0 protocol, as defined in RFC 4346.
TLSv1.2 (when using OpenSSL 1.0.1 and later)
A revision of the TLS 1.1 protocol, as defined in RFC 5246.
TLSv1.3 (when using OpenSSL 1.1.1 and later)
A new version of the TLS protocol, as defined in RFC 8446.
all
This is a shortcut for ``+SSLv3 +TLSv1'' or
- when using OpenSSL 1.0.1 and later -
``+SSLv3 +TLSv1 +TLSv1.1 +TLSv1.2'', respectively
(except for OpenSSL versions compiled with the ``no-ssl3'' configuration
option, where all does not include +SSLv3).
SSLProtocol TLSv1
SSLProtocol for name-based virtual hosts
Before OpenSSL 1.1.1, even though the Server Name Indication (SNI) allowed to
determine the targeted virtual host early in the TLS handshake, it was not
possible to switch the TLS protocol version of the connection at this point,
and thus the SSLProtocol negotiated was always based off
the one of the base virtual host (first virtual host declared on the
listening IP:port of the connection).
Beginning with Apache HTTP server version 2.4.42, when built/linked against
OpenSSL 1.1.1 or later, and when the SNI is provided by the client in the TLS
handshake, the SSLProtocol of each (name-based) virtual
host can and will be honored.
For compatibility with previous versions, if no
SSLProtocol is configured in a name-based virtual host,
the one from the base virtual host still applies, unless
SSLProtocol is configured globally in which case the
global value applies (this latter exception is more sensible than compatible,
though).
| Description: | File of concatenated PEM-encoded CA Certificates for Remote Server Auth |
|---|---|
| Syntax: | SSLProxyCACertificateFile file-path |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
This directive sets the all-in-one file where you can assemble the
Certificates of Certification Authorities (CA) whose remote servers you deal
with. These are used for Remote Server Authentication. Such a file is simply the
concatenation of the various PEM-encoded Certificate files, in order of
preference. This can be used alternatively and/or additionally to
SSLProxyCACertificatePath.
SSLProxyCACertificateFile "/usr/local/apache2/conf/ssl.crt/ca-bundle-remote-server.crt"
| Description: | Directory of PEM-encoded CA Certificates for Remote Server Auth |
|---|---|
| Syntax: | SSLProxyCACertificatePath directory-path |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
This directive sets the directory where you keep the Certificates of Certification Authorities (CAs) whose remote servers you deal with. These are used to verify the remote server certificate on Remote Server Authentication.
The files in this directory have to be PEM-encoded and are accessed through
hash filenames. So usually you can't just place the Certificate files
there: you also have to create symbolic links named
hash-value.N. And you should always make sure this directory
contains the appropriate symbolic links.
SSLProxyCACertificatePath "/usr/local/apache2/conf/ssl.crt/"
| Description: | Enable CRL-based revocation checking for Remote Server Auth |
|---|---|
| Syntax: | SSLProxyCARevocationCheck chain|leaf|none |
| Default: | SSLProxyCARevocationCheck none |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
Enables certificate revocation list (CRL) checking for the
remote servers you deal with. At least one of
SSLProxyCARevocationFile
or SSLProxyCARevocationPath must be
configured. When set to chain (recommended setting),
CRL checks are applied to all certificates in the chain, while setting it to
leaf limits the checks to the end-entity cert.
chain or leaf,
CRLs must be available for successful validation
Prior to version 2.3.15, CRL checking in mod_ssl also succeeded when
no CRL(s) were found in any of the locations configured with
SSLProxyCARevocationFile
or SSLProxyCARevocationPath.
With the introduction of this directive, the behavior has been changed:
when checking is enabled, CRLs must be present for the validation
to succeed - otherwise it will fail with an
"unable to get certificate CRL" error.
SSLProxyCARevocationCheck chain
| Description: | File of concatenated PEM-encoded CA CRLs for Remote Server Auth |
|---|---|
| Syntax: | SSLProxyCARevocationFile file-path |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
This directive sets the all-in-one file where you can
assemble the Certificate Revocation Lists (CRL) of Certification
Authorities (CA) whose remote servers you deal with. These are used
for Remote Server Authentication. Such a file is simply the concatenation of
the various PEM-encoded CRL files, in order of preference. This can be
used alternatively and/or additionally to SSLProxyCARevocationPath.
SSLProxyCARevocationFile "/usr/local/apache2/conf/ssl.crl/ca-bundle-remote-server.crl"
| Description: | Directory of PEM-encoded CA CRLs for Remote Server Auth |
|---|---|
| Syntax: | SSLProxyCARevocationPath directory-path |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
This directive sets the directory where you keep the Certificate Revocation Lists (CRL) of Certification Authorities (CAs) whose remote servers you deal with. These are used to revoke the remote server certificate on Remote Server Authentication.
The files in this directory have to be PEM-encoded and are accessed through
hash filenames. So usually you have not only to place the CRL files there.
Additionally you have to create symbolic links named
hash-value.rN. And you should always make sure this directory
contains the appropriate symbolic links.
SSLProxyCARevocationPath "/usr/local/apache2/conf/ssl.crl/"
| Description: | Whether to check the remote server certificate's CN field |
|---|---|
| Syntax: | SSLProxyCheckPeerCN on|off |
| Default: | SSLProxyCheckPeerCN on |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
This directive sets whether the remote server certificate's CN field is
compared against the hostname of the request URL. If both are not equal
a 502 status code (Bad Gateway) is sent. SSLProxyCheckPeerCN is
superseded by SSLProxyCheckPeerName
in release 2.4.5 and later.
In all releases 2.4.5 through 2.4.20, setting
SSLProxyCheckPeerName off was sufficient to enable this behavior
(as the SSLProxyCheckPeerCN default was on.) In
these releases, both directives must be set to off to completely
avoid remote server certificate name validation. Many users reported this
to be very confusing.
As of release 2.4.21, all configurations which enable either one of the
SSLProxyCheckPeerName or SSLProxyCheckPeerCN options
will use the new SSLProxyCheckPeerName
behavior, and all configurations which disable either one of the
SSLProxyCheckPeerName or SSLProxyCheckPeerCN options
will suppress all remote server certificate name validation. Only the following
configuration will trigger the legacy certificate CN comparison in 2.4.21 and
later releases;
SSLProxyCheckPeerCN on SSLProxyCheckPeerName off
| Description: | Whether to check if remote server certificate is expired |
|---|---|
| Syntax: | SSLProxyCheckPeerExpire on|off |
| Default: | SSLProxyCheckPeerExpire on |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
This directive sets whether it is checked if the remote server certificate is expired or not. If the check fails a 502 status code (Bad Gateway) is sent.
SSLProxyCheckPeerExpire on
| Description: | Configure host name checking for remote server certificates |
|---|---|
| Syntax: | SSLProxyCheckPeerName on|off |
| Default: | SSLProxyCheckPeerName on |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Apache HTTP Server 2.4.5 and later The proxy section context is allowed in httpd 2.4.30 and later |
This directive configures host name checking for server certificates when mod_ssl is acting as an SSL client. The check will succeed if the host name from the request URI matches one of the CN attribute(s) of the certificate's subject, or matches the subjectAltName extension. If the check fails, the SSL request is aborted and a 502 status code (Bad Gateway) is returned.
Wildcard matching is supported for specific cases: an subjectAltName entry
of type dNSName, or CN attributes starting with *. will match
with any host name of the same number of name elements and the same suffix.
E.g. *.example.org will match foo.example.org,
but will not match foo.bar.example.org, because the number of
elements in the respective host names differs.
This feature was introduced in 2.4.5 and superseded the behavior of the
SSLProxyCheckPeerCN directive, which
only tested the exact value in the first CN attribute against the host name.
However, many users were confused by the behavior of using these directives
individually, so the mutual behavior of SSLProxyCheckPeerName
and SSLProxyCheckPeerCN directives were improved in release
2.4.21. See the SSLProxyCheckPeerCN
directive description for the original behavior and details of these
improvements.
| Description: | Cipher Suite available for negotiation in SSL proxy handshake |
|---|---|
| Syntax: | SSLProxyCipherSuite [protocol] cipher-spec |
| Default: | SSLProxyCipherSuite ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:+LOW:+EXP |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
Equivalent to SSLCipherSuite, but
for the proxy connection.
Please refer to SSLCipherSuite
for additional information.
| Description: | SSL Proxy Engine Operation Switch |
|---|---|
| Syntax: | SSLProxyEngine on|off |
| Default: | SSLProxyEngine off |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
This directive toggles the usage of the SSL/TLS Protocol Engine for proxy. This
is usually used inside a <VirtualHost> section to enable SSL/TLS for proxy
usage in a particular virtual host. By default the SSL/TLS Protocol Engine is
disabled for proxy both for the main server and all configured virtual hosts.
Note that the SSLProxyEngine directive should not, in
general, be included in a virtual host that will be acting as a
forward proxy (using <Proxy>
or ProxyRequests directives).
SSLProxyEngine is not required to enable a forward proxy
server to proxy SSL/TLS requests.
<VirtualHost _default_:443>
SSLProxyEngine on
#...
</VirtualHost>
| Description: | File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate |
|---|---|
| Syntax: | SSLProxyMachineCertificateChainFile filename |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
This directive sets the all-in-one file where you keep the certificate chain for all of the client certs in use. This directive will be needed if the remote server presents a list of CA certificates that are not direct signers of one of the configured client certificates.
This referenced file is simply the concatenation of the various PEM-encoded certificate files. Upon startup, each client certificate configured will be examined and a chain of trust will be constructed.
If this directive is enabled, all of the certificates in the file will be
trusted as if they were also in
SSLProxyCACertificateFile.
SSLProxyMachineCertificateChainFile "/usr/local/apache2/conf/ssl.crt/proxyCA.pem"
| Description: | File of concatenated PEM-encoded client certificates and keys to be used by the proxy |
|---|---|
| Syntax: | SSLProxyMachineCertificateFile filename |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later Inclusion of non-leaf (CA) certificates is permitted only in httpd 2.4.59 and later. |
This directive sets the all-in-one file where you keep the certificates and keys used for authentication of the proxy server to remote servers.
This referenced file is simply the concatenation of the various
PEM-encoded certificate files. Use this directive alternatively or
additionally to SSLProxyMachineCertificatePath. The referenced file can contain any number of pairs of client
certificate and associated private key. Each pair can be specified in
either (certificate, key) or (key, certificate) order. Non-leaf (CA) certificates can
also be included in the file, and are treated as if configured with SSLProxyMachineCertificateChainFile.
When challenged to provide a client certificate by a remote server,
the server should provide a list of acceptable certificate
authority names in the challenge. If such a list is not
provided, mod_ssl will use the first configured
client cert/key. If a list of CA names is provided,
mod_ssl will iterate through that list, and attempt
to find a configured client cert which was issued either directly by
that CA, or indirectly via any number of intermediary CA certificates.
The chain of intermediate CA certificates can be built from those
included in the file, or configured with SSLProxyMachineCertificateChainFile. The
first configured matching certificate will then be supplied in
response to the challenge.
If the list of CA names is provided by the remote server,
and no matching client certificate can be found, no client
certificate will be provided by mod_ssl, which will
likely fail the SSL/TLS handshake (depending on the remote server
configuration).
Currently there is no support for encrypted private keys
Only keys encoded in PKCS1 RSA, DSA or EC format are supported.
Keys encoded in PKCS8 format, ie. starting with
"-----BEGIN PRIVATE KEY-----",
must be converted, eg. using
"openssl rsa -in private-pkcs8.pem -outform pem".
SSLProxyMachineCertificateFile "/usr/local/apache2/conf/ssl.crt/proxy.pem"
| Description: | Directory of PEM-encoded client certificates and keys to be used by the proxy |
|---|---|
| Syntax: | SSLProxyMachineCertificatePath directory |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
This directive sets the directory where you keep the client certificates and keys used for authentication of the proxy server to remote servers.
mod_ssl will attempt to load every file inside the specified directory
as if it was configured individually with SSLProxyMachineCertificateFile.
Currently there is no support for encrypted private keys
Only keys encoded in PKCS1 RSA, DSA or EC format are supported.
Keys encoded in PKCS8 format, ie. starting with
"-----BEGIN PRIVATE KEY-----",
must be converted, eg. using
"openssl rsa -in private-pkcs8.pem -outform pem".
SSLProxyMachineCertificatePath "/usr/local/apache2/conf/proxy.crt/"
| Description: | Configure usable SSL protocol flavors for proxy usage |
|---|---|
| Syntax: | SSLProxyProtocol [+|-]protocol ... |
| Default: | SSLProxyProtocol all -SSLv3 (up to 2.4.16: all) |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
This directive can be used to control the SSL protocol flavors mod_ssl should use when establishing its server environment for proxy . It will only connect to servers using one of the provided protocols.
Please refer to SSLProtocol
for additional information.
| Description: | Type of remote server Certificate verification |
|---|---|
| Syntax: | SSLProxyVerify level |
| Default: | SSLProxyVerify none |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
When a proxy is configured to forward requests to a remote SSL server, this directive can be used to configure certificate verification of the remote server.
The following levels are available for level:
In practice only levels none and require are really interesting, because level optional doesn't work with all servers and level optional_no_ca is actually against the idea of authentication (but can be used to establish SSL test pages, etc.)
SSLProxyVerify require
| Description: | Maximum depth of CA Certificates in Remote Server Certificate verification |
|---|---|
| Syntax: | SSLProxyVerifyDepth number |
| Default: | SSLProxyVerifyDepth 1 |
| Context: | server config, virtual host, proxy section |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | The proxy section context is allowed in httpd 2.4.30 and later |
This directive sets how deeply mod_ssl should verify before deciding that the remote server does not have a valid certificate.
The depth actually is the maximum number of intermediate certificate issuers,
i.e. the number of CA certificates which are max allowed to be followed while
verifying the remote server certificate. A depth of 0 means that self-signed
remote server certificates are accepted only, the default depth of 1 means
the remote server certificate can be self-signed or has to be signed by a CA
which is directly known to the server (i.e. the CA's certificate is under
SSLProxyCACertificatePath), etc.
SSLProxyVerifyDepth 10
| Description: | Pseudo Random Number Generator (PRNG) seeding source |
|---|---|
| Syntax: | SSLRandomSeed context source
[bytes] |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ssl |
This configures one or more sources for seeding the Pseudo Random Number
Generator (PRNG) in OpenSSL at startup time (context is
startup) and/or just before a new SSL connection is established
(context is connect). This directive can only be used
in the global server context because the PRNG is a global facility.
The following source variants are available:
builtin
This is the always available builtin seeding source. Its usage consumes minimum CPU cycles under runtime and hence can be always used without drawbacks. The source used for seeding the PRNG contains of the current time, the current process id and a randomly chosen 128 bytes extract of the stack. The drawback is that this is not really a strong source and at startup time (where the scoreboard is still not available) this source just produces a few bytes of entropy. So you should always, at least for the startup, use an additional seeding source.
file:/path/to/source
This variant uses an external file /path/to/source as the
source for seeding the PRNG. When bytes is specified, only the
first bytes number of bytes of the file form the entropy (and
bytes is given to /path/to/source as the first
argument). When bytes is not specified the whole file forms the
entropy (and 0 is given to /path/to/source as
the first argument). Use this especially at startup time, for instance
with an available /dev/random and/or
/dev/urandom devices (which usually exist on modern Unix
derivatives like FreeBSD and Linux).
But be careful: Usually /dev/random provides only as
much entropy data as it actually has, i.e. when you request 512 bytes of
entropy, but the device currently has only 100 bytes available two things
can happen: On some platforms you receive only the 100 bytes while on
other platforms the read blocks until enough bytes are available (which
can take a long time). Here using an existing /dev/urandom is
better, because it never blocks and actually gives the amount of requested
data. The drawback is just that the quality of the received data may not
be the best.
exec:/path/to/program
This variant uses an external executable
/path/to/program as the source for seeding the
PRNG. When bytes is specified, only the first
bytes number of bytes of its stdout contents
form the entropy. When bytes is not specified, the
entirety of the data produced on stdout form the
entropy. Use this only at startup time when you need a very strong
seeding with the help of an external program (for instance as in
the example above with the truerand utility you can
find in the mod_ssl distribution which is based on the AT&T
truerand library). Using this in the connection context
slows down the server too dramatically, of course. So usually you
should avoid using external programs in that context.
egd:/path/to/egd-socket (Unix only)
This variant uses the Unix domain socket of the external Entropy Gathering Daemon (EGD) (see http://www.lothar.com/tech /crypto/) to seed the PRNG. Use this if no random device exists on your platform.
SSLRandomSeed startup builtin SSLRandomSeed startup "file:/dev/random" SSLRandomSeed startup "file:/dev/urandom" 1024 SSLRandomSeed startup "exec:/usr/local/bin/truerand" 16 SSLRandomSeed connect builtin SSLRandomSeed connect "file:/dev/random" SSLRandomSeed connect "file:/dev/urandom" 1024
| Description: | Set the size for the SSL renegotiation buffer |
|---|---|
| Syntax: | SSLRenegBufferSize bytes |
| Default: | SSLRenegBufferSize 131072 |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_ssl |
If an SSL renegotiation is required in per-location context, for
example, any use of SSLVerifyClient in a Directory or
Location block, then mod_ssl must buffer any HTTP
request body into memory until the new SSL handshake can be performed.
This directive can be used to set the amount of memory that will be
used for this buffer.
Note that in many configurations, the client sending the request body will be untrusted so a denial of service attack by consumption of memory must be considered when changing this configuration setting.
SSLRenegBufferSize 262144
| Description: | Allow access only when an arbitrarily complex boolean expression is true |
|---|---|
| Syntax: | SSLRequire expression |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_ssl |
SSLRequire is deprecated and should in general be replaced
by Require expr. The so called
ap_expr syntax of Require expr is
a superset of the syntax of SSLRequire, with the following
exception:
In SSLRequire, the comparison operators <,
<=, ... are completely equivalent to the operators
lt, le, ... and work in a somewhat peculiar way that
first compares the length of two strings and then the lexical order.
On the other hand, ap_expr has two sets of
comparison operators: The operators <,
<=, ... do lexical string comparison, while the operators
-lt, -le, ... do integer comparison.
For the latter, there are also aliases without the leading dashes:
lt, le, ...
This directive specifies a general access requirement which has to be fulfilled in order to allow access. It is a very powerful directive because the requirement specification is an arbitrarily complex boolean expression containing any number of access checks.
The expression must match the following syntax (given as a BNF grammar notation):
expr ::= "true" | "false"
| "!" expr
| expr "&&" expr
| expr "||" expr
| "(" expr ")"
| comp
comp ::= word "==" word | word "eq" word
| word "!=" word | word "ne" word
| word "<" word | word "lt" word
| word "<=" word | word "le" word
| word ">" word | word "gt" word
| word ">=" word | word "ge" word
| word "in" "{" wordlist "}"
| word "in" "PeerExtList(" word ")"
| word "=~" regex
| word "!~" regex
wordlist ::= word
| wordlist "," word
word ::= digit
| cstring
| variable
| function
digit ::= [0-9]+
cstring ::= "..."
variable ::= "%{" varname "}"
function ::= funcname "(" funcargs ")"
For varname any of the variables described in Environment Variables can be used. For
funcname the available functions are listed in
the ap_expr documentation.
The expression is parsed into an internal machine representation when the configuration is loaded, and then evaluated during request processing. In .htaccess context, the expression is both parsed and executed each time the .htaccess file is encountered during request processing.
SSLRequire ( %{SSL_CIPHER} !~ m/^(EXP|NULL)-/ \
and %{SSL_CLIENT_S_DN_O} eq "Snake Oil, Ltd." \
and %{SSL_CLIENT_S_DN_OU} in {"Staff", "CA", "Dev"} \
and %{TIME_WDAY} -ge 1 and %{TIME_WDAY} -le 5 \
and %{TIME_HOUR} -ge 8 and %{TIME_HOUR} -le 20 ) \
or %{REMOTE_ADDR} =~ m/^192\.76\.162\.[0-9]+$/
The PeerExtList(object-ID) function expects
to find zero or more instances of the X.509 certificate extension
identified by the given object ID (OID) in the client certificate.
The expression evaluates to true if the left-hand side string matches
exactly against the value of an extension identified with this OID.
(If multiple extensions with the same OID are present, at least one
extension must match).
SSLRequire "foobar" in PeerExtList("1.2.3.4.5.6")
The object ID can be specified either as a descriptive
name recognized by the SSL library, such as "nsComment",
or as a numeric OID, such as "1.2.3.4.5.6".
Expressions with types known to the SSL library are rendered to a string before comparison. For an extension with a type not recognized by the SSL library, mod_ssl will parse the value if it is one of the primitive ASN.1 types UTF8String, IA5String, VisibleString, or BMPString. For an extension of one of these types, the string value will be converted to UTF-8 if necessary, then compared against the left-hand-side expression.
| Description: | Deny access when SSL is not used for the HTTP request |
|---|---|
| Syntax: | SSLRequireSSL |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_ssl |
This directive forbids access unless HTTP over SSL (i.e. HTTPS) is enabled for the current connection. This is very handy inside the SSL-enabled virtual host or directories for defending against configuration errors that expose stuff that should be protected. When this directive is present all requests are denied which are not using SSL.
SSLRequireSSL
| Description: | Type of the global/inter-process SSL Session Cache |
|---|---|
| Syntax: | SSLSessionCache type |
| Default: | SSLSessionCache none |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ssl |
This configures the storage type of the global/inter-process SSL Session Cache. This cache is an optional facility which speeds up parallel request processing. For requests to the same server process (via HTTP keep-alive), OpenSSL already caches the SSL session information locally. But because modern clients request inlined images and other data via parallel requests (usually up to four parallel requests are common) those requests are served by different pre-forked server processes. Here an inter-process cache helps to avoid unnecessary session handshakes.
The following five storage types are currently supported:
none
This disables the global/inter-process Session Cache. This will incur a noticeable speed penalty and may cause problems if using certain browsers, particularly if client certificates are enabled. This setting is not recommended.
nonenotnull
This disables any global/inter-process Session Cache. However it does force OpenSSL to send a non-null session ID to accommodate buggy clients that require one.
dbm:/path/to/datafile
This makes use of a DBM hashfile on the local disk to
synchronize the local OpenSSL memory caches of the server
processes. This session cache may suffer reliability issues under
high load. To use this, ensure that
mod_socache_dbm is loaded.
shmcb:/path/to/datafile[(size)]
This makes use of a high-performance cyclic buffer
(approx. size bytes in size) inside a shared memory
segment in RAM (established via /path/to/datafile) to
synchronize the local OpenSSL memory caches of the server
processes. This is the recommended session cache. To use this,
ensure that mod_socache_shmcb is loaded.
dc:UNIX:/path/to/socket
This makes use of the distcache distributed session
caching libraries. The argument should specify the location of
the server or proxy to be used using the distcache address syntax;
for example, UNIX:/path/to/socket specifies a UNIX
domain socket (typically a local dc_client proxy);
IP:server.example.com:9001 specifies an IP
address. To use this, ensure that
mod_socache_dc is loaded.
SSLSessionCache "dbm:/usr/local/apache/logs/ssl_gcache_data" SSLSessionCache "shmcb:/usr/local/apache/logs/ssl_gcache_data(512000)"
The ssl-cache mutex is used to serialize access to
the session cache to prevent corruption. This mutex can be configured
using the Mutex directive.
| Description: | Number of seconds before an SSL session expires in the Session Cache |
|---|---|
| Syntax: | SSLSessionCacheTimeout seconds |
| Default: | SSLSessionCacheTimeout 300 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Applies also to RFC 5077 TLS session resumption in Apache 2.4.10 and later |
This directive sets the timeout in seconds for the information stored in the global/inter-process SSL Session Cache, the OpenSSL internal memory cache and for sessions resumed by TLS session resumption (RFC 5077). It can be set as low as 15 for testing, but should be set to higher values like 300 in real life.
SSLSessionCacheTimeout 600
| Description: | Persistent encryption/decryption key for TLS session tickets |
|---|---|
| Syntax: | SSLSessionTicketKeyFile file-path |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in httpd 2.4.0 and later, if using OpenSSL 0.9.8h or later |
Optionally configures a secret key for encrypting and decrypting TLS session tickets, as defined in RFC 5077. Primarily suitable for clustered environments where TLS sessions information should be shared between multiple nodes. For single-instance httpd setups, it is recommended to not configure a ticket key file, but to rely on (random) keys generated by mod_ssl at startup, instead.
The ticket key file must contain 48 bytes of random data, preferably created from a high-entropy source. On a Unix-based system, a ticket key file can be created as follows:
dd if=/dev/random of=/path/to/file.tkey bs=1 count=48
Ticket keys should be rotated (replaced) on a frequent basis, as this is the only way to invalidate an existing session ticket - OpenSSL currently doesn't allow to specify a limit for ticket lifetimes. A new ticket key only gets used after restarting the web server. All existing session tickets become invalid after a restart.
The ticket key file contains sensitive keying material and should
be protected with file permissions similar to those used for
SSLCertificateKeyFile.
| Description: | Enable or disable use of TLS session tickets |
|---|---|
| Syntax: | SSLSessionTickets on|off |
| Default: | SSLSessionTickets on |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in httpd 2.4.11 and later, if using OpenSSL 0.9.8f or later. |
This directive allows to enable or disable the use of TLS session tickets (RFC 5077).
TLS session tickets are enabled by default. Using them without restarting the web server with an appropriate frequency (e.g. daily) compromises perfect forward secrecy.
| Description: | SRP unknown user seed |
|---|---|
| Syntax: | SSLSRPUnknownUserSeed secret-string |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in httpd 2.4.4 and later, if using OpenSSL 1.0.1 or later |
This directive sets the seed used to fake SRP user parameters for unknown users, to avoid leaking whether a given user exists. Specify a secret string. If this directive is not used, then Apache will return the UNKNOWN_PSK_IDENTITY alert to clients who specify an unknown username.
SSLSRPUnknownUserSeed "secret"
| Description: | Path to SRP verifier file |
|---|---|
| Syntax: | SSLSRPVerifierFile file-path |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in httpd 2.4.4 and later, if using OpenSSL 1.0.1 or later |
This directive enables TLS-SRP and sets the path to the OpenSSL SRP (Secure Remote Password) verifier file containing TLS-SRP usernames, verifiers, salts, and group parameters.
SSLSRPVerifierFile "/path/to/file.srpv"
The verifier file can be created with the openssl command line
utility:
openssl srp -srpvfile passwd.srpv -userinfo "some info" -add username
The value given with the optional -userinfo parameter is
available in the SSL_SRP_USERINFO request environment variable.
| Description: | Configures the OCSP stapling cache |
|---|---|
| Syntax: | SSLStaplingCache type |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available if using OpenSSL 0.9.8h or later |
Configures the cache used to store OCSP responses which get included
in the TLS handshake if SSLUseStapling
is enabled. Configuration of a cache is mandatory for OCSP stapling.
With the exception of none and nonenotnull,
the same storage types are supported as with
SSLSessionCache.
| Description: | Number of seconds before expiring invalid responses in the OCSP stapling cache |
|---|---|
| Syntax: | SSLStaplingErrorCacheTimeout seconds |
| Default: | SSLStaplingErrorCacheTimeout 600 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available if using OpenSSL 0.9.8h or later |
Sets the timeout in seconds before invalid responses
in the OCSP stapling cache (configured through SSLStaplingCache) will expire.
To set the cache timeout for valid responses, see
SSLStaplingStandardCacheTimeout.
| Description: | Synthesize "tryLater" responses for failed OCSP stapling queries |
|---|---|
| Syntax: | SSLStaplingFakeTryLater on|off |
| Default: | SSLStaplingFakeTryLater on |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available if using OpenSSL 0.9.8h or later |
When enabled and a query to an OCSP responder for stapling
purposes fails, mod_ssl will synthesize a "tryLater" response for the
client. Only effective if SSLStaplingReturnResponderErrors
is also enabled.
| Description: | Override the OCSP responder URI specified in the certificate's AIA extension |
|---|---|
| Syntax: | SSLStaplingForceURL uri |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available if using OpenSSL 0.9.8h or later |
This directive overrides the URI of an OCSP responder as obtained from the authorityInfoAccess (AIA) extension of the certificate. One potential use is when a proxy is used for retrieving OCSP queries.
| Description: | Timeout for OCSP stapling queries |
|---|---|
| Syntax: | SSLStaplingResponderTimeout seconds |
| Default: | SSLStaplingResponderTimeout 10 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available if using OpenSSL 0.9.8h or later |
This option sets the timeout for queries to OCSP responders when
SSLUseStapling is enabled
and mod_ssl is querying a responder for OCSP stapling purposes.
| Description: | Maximum allowable age for OCSP stapling responses |
|---|---|
| Syntax: | SSLStaplingResponseMaxAge seconds |
| Default: | SSLStaplingResponseMaxAge -1 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available if using OpenSSL 0.9.8h or later |
This option sets the maximum allowable age ("freshness") when
considering OCSP responses for stapling purposes, i.e. when
SSLUseStapling is turned on.
The default value (-1) does not enforce a maximum age,
which means that OCSP responses are considered valid as long as their
nextUpdate field is in the future.
| Description: | Maximum allowable time skew for OCSP stapling response validation |
|---|---|
| Syntax: | SSLStaplingResponseTimeSkew seconds |
| Default: | SSLStaplingResponseTimeSkew 300 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available if using OpenSSL 0.9.8h or later |
This option sets the maximum allowable time skew when mod_ssl checks the
thisUpdate and nextUpdate fields of OCSP responses
which get included in the TLS handshake (OCSP stapling). Only applicable
if SSLUseStapling is turned on.
| Description: | Pass stapling related OCSP errors on to client |
|---|---|
| Syntax: | SSLStaplingReturnResponderErrors on|off |
| Default: | SSLStaplingReturnResponderErrors on |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available if using OpenSSL 0.9.8h or later |
When enabled, mod_ssl will pass responses from unsuccessful
stapling related OCSP queries (such as responses with an overall status
other than "successful", responses with a certificate status other than
"good", expired responses etc.) on to the client.
If set to off, only responses indicating a certificate status
of "good" will be included in the TLS handshake.
| Description: | Number of seconds before expiring responses in the OCSP stapling cache |
|---|---|
| Syntax: | SSLStaplingStandardCacheTimeout seconds |
| Default: | SSLStaplingStandardCacheTimeout 3600 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available if using OpenSSL 0.9.8h or later |
Sets the timeout in seconds before responses in the OCSP stapling cache
(configured through SSLStaplingCache)
will expire. This directive applies to valid responses, while
SSLStaplingErrorCacheTimeout is
used for controlling the timeout for invalid/unavailable responses.
| Description: | Whether to allow non-SNI clients to access a name-based virtual host. |
|---|---|
| Syntax: | SSLStrictSNIVHostCheck on|off |
| Default: | SSLStrictSNIVHostCheck off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available in Apache 2.2.12 and later |
This directive sets whether a non-SNI client is allowed to access a name-based
virtual host. If set to on in the default name-based virtual
host, clients that are SNI unaware will not be allowed to access any
virtual host, belonging to this particular IP / port combination.
If set to on in any other virtual host, SNI unaware clients
are not allowed to access this particular virtual host.
This option is only available if httpd was compiled against an SNI capable version of OpenSSL.
SSLStrictSNIVHostCheck on
| Description: | Variable name to determine user name |
|---|---|
| Syntax: | SSLUserName varname |
| Context: | server config, directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_ssl |
This directive sets the "user" field in the Apache request object.
This is used by lower modules to identify the user with a character
string. In particular, this may cause the environment variable
REMOTE_USER to be set. The varname can be
any of the SSL environment variables.
Note that this directive has no effect if the
FakeBasicAuth option is used (see SSLOptions).
SSLUserName SSL_CLIENT_S_DN_CN
| Description: | Enable stapling of OCSP responses in the TLS handshake |
|---|---|
| Syntax: | SSLUseStapling on|off |
| Default: | SSLUseStapling off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ssl |
| Compatibility: | Available if using OpenSSL 0.9.8h or later |
This option enables OCSP stapling, as defined by the "Certificate
Status Request" TLS extension specified in RFC 6066. If enabled (and
requested by the client), mod_ssl will include an OCSP response
for its own certificate in the TLS handshake. Configuring an
SSLStaplingCache is a
prerequisite for enabling OCSP stapling.
OCSP stapling relieves the client of querying the OCSP responder
on its own, but it should be noted that with the RFC 6066 specification,
the server's CertificateStatus reply may only include an
OCSP response for a single cert. For server certificates with intermediate
CA certificates in their chain (the typical case nowadays),
stapling in its current implementation therefore only partially achieves the
stated goal of "saving roundtrips and resources" - see also
RFC 6961
(TLS Multiple Certificate Status Extension).
When OCSP stapling is enabled, the ssl-stapling mutex is used
to control access to the OCSP stapling cache in order to prevent corruption,
and the sss-stapling-refresh mutex is used to control refreshes
of OCSP responses. These mutexes can be configured using the
Mutex directive.
| Description: | Type of Client Certificate verification |
|---|---|
| Syntax: | SSLVerifyClient level |
| Default: | SSLVerifyClient none |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_ssl |
This directive sets the Certificate verification level for the Client Authentication. Notice that this directive can be used both in per-server and per-directory context. In per-server context it applies to the client authentication process used in the standard SSL handshake when a connection is established. In per-directory context it forces a SSL renegotiation with the reconfigured client verification level after the HTTP request was read but before the HTTP response is sent.
The following levels are available for level:
SSLVerifyClient require
| Description: | Maximum depth of CA Certificates in Client Certificate verification |
|---|---|
| Syntax: | SSLVerifyDepth number |
| Default: | SSLVerifyDepth 1 |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_ssl |
This directive sets how deeply mod_ssl should verify before deciding that the clients don't have a valid certificate. Notice that this directive can be used both in per-server and per-directory context. In per-server context it applies to the client authentication process used in the standard SSL handshake when a connection is established. In per-directory context it forces a SSL renegotiation with the reconfigured client verification depth after the HTTP request was read but before the HTTP response is sent.
The depth actually is the maximum number of intermediate certificate issuers,
i.e. the number of CA certificates which are max allowed to be followed while
verifying the client certificate. A depth of 0 means that self-signed client
certificates are accepted only, the default depth of 1 means the client
certificate can be self-signed or has to be signed by a CA which is directly
known to the server (i.e. the CA's certificate is under
SSLCACertificatePath), etc.
SSLVerifyDepth 10
Apache HTTP Server Version 2.4
| Beschreibung: | Eine Sammlung von Direktiven, die in mehr als einem Multi-Processing-Modul (MPM) implementiert sind. |
|---|---|
| Status: | MPM |
CoreDumpDirectory EnableExceptionHook GracefulShutdownTimeout Listen ListenBackLog ListenCoresBucketsRatio MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers StartThreads ThreadLimit ThreadsPerChild ThreadStackSize| Beschreibung: | Verzeichnis, in das der Apache zu wechseln versucht, bevor er einen Hauptspeicherauszug erstellt |
|---|---|
| Syntax: | CoreDumpDirectory Verzeichnis |
| Voreinstellung: | Für die Voreinstellung siehe Beschreibung |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | beos, leader, mpm_winnt, perchild, prefork, threadpool, worker |
Dies beeinflusst das Verzeichnis, in welches der Apache zu wechseln
versucht, bevor er einen Hauptspeicherauszug (Anm.d.Ü.: einen
so genannten Core-Dump) erstellt. Die Voreinstellung ist das
ServerRoot-Verzeichnis. Da dieses
jedoch nicht für den Benutzer beschreibbar sein soll, unter dem
der Server läuft, werden normalerweise keine
Hauptspeicherauszüge geschrieben. Wenn Sie zum Debuggen
einen Hauptspeicherauszug haben möchten, können Sie
ihn mit dieser Direktive an einem anderen Ort ablegen lassen.
Wenn Apache als root startet und zu einem anderen Benutzer
wechselt, deaktiviert der Linux-Kernel Hauptspeicherauszüge
auch dann, wenn der Prozess in dem Verzeichnis schreiben darf. Ab Linux
2.4 reaktiviert Apache (ab 2.0.46) Hauptspeicherauszüge wieder,
jedoch nur dann, wenn Sie explizit
CoreDumpDirectory konfigurieren.
| Beschreibung: | Aktiviert einen Hook, der nach einem Absturz noch Ausnahmefehler behandeln lassen kann |
|---|---|
| Syntax: | EnableExceptionHook On|Off |
| Voreinstellung: | EnableExceptionHook Off |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | leader, perchild, prefork, threadpool, worker |
| Kompatibilität: | Verfügbar seit Version 2.0.49 |
Diese Direktive ist aus Sicherheitsgründen nur verfügbar,
wenn der Server mit der Option --enable-exception-hook
konfiguriert wurde. Sie aktiviert einen Hook, der es externen Modulen
erlaubt, sich dort einzuhängen und nach dem Absturz eines
Kindprozesses noch Aktionen durchzuführen.
Es existieren bereits zwei Module, mod_whatkilledus und
mod_backtrace, welche diesen Hook verwenden. Weitere
Informationen hierzu finden Sie auf Jeff Trawicks EnableExceptionHook-Seite.
| Beschreibung: | Specify a timeout after which a gracefully shutdown server will exit. |
|---|---|
| Syntax: | GracefulShutdownTimeout seconds |
| Voreinstellung: | GracefulShutdownTimeout 0 |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | event, worker, prefork |
| Kompatibilität: | Available in version 2.2 and later |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | IP-Adressen und Ports, an denen der Server lauscht |
|---|---|
| Syntax: | Listen [IP-Addresse:]Port |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | beos, leader, mpm_netware, mpm_winnt, mpmt_os2, perchild, prefork, threadpool, worker |
| Kompatibilität: | Seit Apache 2.0 vorgeschrieben |
Die Direktive Listen weist den Apache an,
nur an den angegebenen IP-Adressen oder Ports zu lauschen.
Standardmäßig antwortet er auf alle Anfragen an allen
IP-Interfaces. Listen ist nun eine notwendige
Anweisung. Wenn sie nicht in der Konfigurationsdatei enthalten ist,
wird der Server-Start fehlschlagen. Dies ist eine Änderung
gegenüber früheren Versionen des Apache.
Die Direktive Listen weist den Server an,
ankommende Anfragen am angegebenen Port oder der
Kombination aus Adresse und Port entgegenzunehmen. Wenn nur eine Portnummer
angegeben ist, dann lauscht der Server am angegebenen Port an allen
Interfaces. Wenn sowohl eine IP-Adresse als auch ein Port angegeben
sind, dann lauscht der Server am angegeben Port und Interface.
Es können mehrere Listen-Anweisungen
verwendet werden, um eine Reihe von Adressen und Port anzugeben, an
denen gelauscht werden soll. Der Server antwortet auf Anfragen von
jedem der aufgeführten Adressen und Ports.
Um beispielsweise den Server Verbindungen an den beiden Ports 80 und 8000 annehmen zu lassen, verwenden Sie:
Listen 80
Listen 8000
Um den Server Verbindungen an zwei angegebenen Interfaces und Ports annehmen zu lassen, verwenden Sie:
Listen 192.170.2.1:80
Listen 192.170.2.5:8000
IPv6-Adressen müssen wie in dem folgenden Beispiel in eckige Klammern eingeschlossen werden:
Listen [2001:db8::a00:20ff:fea7:ccea]:80
Listen-Direktiven für gleiche
IP-Adresse und Port führen zur Fehlermeldung
Address already in use (Anm.d.Ü.: Adresse schon in
Benutzung).
| Beschreibung: | Maximale Länge der Warteschlange schwebender Verbindungen |
|---|---|
| Syntax: | ListenBacklog backlog |
| Voreinstellung: | ListenBacklog 511 |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | beos, leader, mpm_netware, mpm_winnt, mpmt_os2, perchild, prefork, threadpool, worker |
Die maximale Länge der Warteschlange schwebender Verbindungen.
Üblicherweise ist keine Feineinstellung notwendig oder sinnvoll,
auf einigen System kann es jedoch gewünscht sein, diesen Wert bei
TCP-SYN-Angriffen zu erhöhen. Beachten Sie auch die Beschreibung des
backlog-Parameters der Systemfunktion listen(2).
Der Wert wird vom Betriebssystem oft auf eine niedrigere Einstellung begrenzt. Dies variiert von Betriebssystem zu Betriebssystem. Beachten Sie auch, dass viele Betriebssyteme nicht genau beachten, was für backlog angegeben ist, jedoch einen Wert basierend auf der Angabe (normalerweiseweise jedoch größer als diese) verwenden.
| Beschreibung: | Ratio between the number of CPU cores (online) and the number of listeners' buckets |
|---|---|
| Syntax: | ListenCoresBucketsRatio ratio |
| Voreinstellung: | ListenCoresBucketsRatio 0 (disabled) |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | event, worker, prefork |
| Kompatibilität: | Available in Apache HTTP Server 2.4.17, with a kernel supporting
the socket option SO_REUSEPORT and distributing new connections
evenly across listening processes' (or threads') sockets using it (eg. Linux
3.9 and later, but not the current implementations of SO_REUSEPORT
in *BSDs. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Limit on the number of connections that an individual child server will handle during its life |
|---|---|
| Syntax: | MaxConnectionsPerChild number |
| Voreinstellung: | MaxConnectionsPerChild 0 |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
| Kompatibilität: | Available Apache HTTP Server 2.3.9 and later. The old name
MaxRequestsPerChild is still supported. |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Maximale Menge des Arbeitsspeichers, den die
Haupt-Zuteilungsroutine verwalten darf, ohne free()
aufzurufen |
|---|---|
| Syntax: | MaxMemFree KBytes |
| Voreinstellung: | MaxMemFree 0 |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | beos, leader, mpm_netware, prefork, threadpool, worker, mpm_winnt |
Die Direktive MaxMemFree gibt die maximale
Menge freier Kilobytes an, welche die Haupt-Zuteilungsroutine verwalten
darf, ohne free() aufzurufen. Wenn keine Angabe gemacht wird,
oder Null angegeben ist, wird dieser Wert nicht eingeschränkt.
| Beschreibung: | Maximum number of connections that will be processed simultaneously |
|---|---|
| Syntax: | MaxRequestWorkers number |
| Voreinstellung: | See usage for details |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | event, worker, prefork |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Maximale Anzahl unbeschäftigter Threads |
|---|---|
| Syntax: | MaxSpareThreads Anzahl |
| Voreinstellung: | Für Details siehe Beschreibung |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | beos, leader, mpm_netware, mpmt_os2, perchild, threadpool, worker |
Maximale Anzahl unbeschäftigter Threads. Die verschiedenen MPMs behandeln diese Anweisung unterschiedlich.
Die Voreinstellung für perchild ist
MaxSpareThreads 10. Das MPM überwacht die Anzahl der
unbeschäftigten Threads auf der Basis einzelner Kindprozesse. Wenn
zu viele unbeschäftigte Threads in einem Kindprozess existieren,
beendet der Server Threads innerhalb dieses Kindprozesses.
Die Voreinstellung für worker,
leader und threadpool ist
MaxSpareThreads 250. Diese MPMs behandeln Threads
auf einer serverweiten Basis. Wenn zu viele unbeschäftigte Threads
im Server existieren, dann werden solange Kindprozesse beendet, bis
die Anzahl der unbeschäftigten Threads kleiner als der
angegebene Wert ist.
Die Voreinstellung für mpm_netware ist
MaxSpareThreads 100. Da dieses MPM nur einen einzigen
Prozess ausführt, ist die Zählung überschüssiger
Threads ebenfalls serverweit.
beos and mpmt_os2 arbeiten
ähnlich wie mpm_netware. Die Voreinstellung
für beos ist MaxSpareThreads 50.
Die Voreinstellung für mpmt_os2 ist
10.
Der Wertebereich von MaxSpareThreads
ist eingeschränkt. Apache korrigiert den angegebenen Wert
automatisch gemäß den folgenden Regeln:
perchild verlangt, dass MaxSpareThreads kleiner oder gleich ThreadLimit ist.mpm_netware verlangt einen Wert größer
als MinSpareThreads.leader, threadpool und
worker muss der Wert größer oder gleich
der Summe aus MinSpareThreads und
ThreadsPerChild sein.| Beschreibung: | Minimale Anzahl unbeschäftigter Threads, die zur Bedienung von Anfragespitzen zur Verfügung stehen |
|---|---|
| Syntax: | MinSpareThreads Anzahl |
| Voreinstellung: | Für Details siehe Beschreibung |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | beos, leader, mpm_netware, mpmt_os2, perchild, threadpool, worker |
Minimale Anzahl unbeschäftigter Threads, um Anfragespitzen zu bedienen. Die verschiedenen MPMs behandeln die Anweisung unterschiedlich.
perchild verwendet die Voreinstellung
MinSpareThreads 5 und überwacht die Anzahl der
unbeschäftigten Threads auf der Basis einzelner Kindprozesse. Wenn
in einem Kindprozess nicht genügend unbeschäftigte
Threads vorhanden sind, erstellt der Server neue Threads innerhalb
dieses Kindprozesses. Wenn Sie also NumServers auf 10 und MinSpareThreads auf einen Wert von 5 setzen,
haben Sie mindestens 50 unbeschäftigte Threads auf Ihrem
System.
worker, leader und
threadpool verwenden eine Voreinstellung von
MinSpareThreads 75 und behandeln unbeschäftigte
Threads auf serverweiter Basis. Wenn nicht genügend
unbeschäftigte Threads im Server vorhanden sind, dann
werden solange Kindprozesse erzeugt, bis die Anzahl unbeschäftigter
Threads größer als der angegebene Wert ist.
mpm_netware verwendet die Voreinstellung
MinSpareThreads 10 und verfolgt dies serverweit, da
es ein Einzelprozess-MPM ist.
beos und mpmt_os2 arbeiten
ähnlich wie mpm_netware. Die Voreinstellung
für beos ist MinSpareThreads 1.
Die Voreinstellung für mpmt_os2 ist
5.
| Beschreibung: | Datei, in welcher der Server die Prozess-ID des Daemons ablegt |
|---|---|
| Syntax: | PidFile Dateiname |
| Voreinstellung: | PidFile logs/httpd.pid |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | beos, leader, mpm_winnt, mpmt_os2, perchild, prefork, threadpool, worker |
Die Direktive PidFile bestimmt die Datei,
in welcher der Server die Prozess-ID des Daemons ablegt. Wenn der
Dateiname nicht absolut angegeben wird, wird er relativ zu
ServerRoot interpretiert.
PidFile /var/run/apache.pid
Es ist oft hilfreich, dem Server ein Signal senden zu können,
damit er seine ErrorLogs und
TransferLogs
schließt und dann neu öffnet und seine
Konfigurationsdateien neu einliest. Dies kann durch Senden eines
SIGHUP-Signals (kill -1) an die Prozess-ID geschehen, die im
PidFile eingetragen ist.
Die PidFile-Datei unterliegt den
gleichen Warnungen über die Ablage von Protokolldateien
und Sicherheit.
Ab Apache 2 wird empfohlen, nur das Skript apachectl zum (Neu-)Starten und Stoppen des Servers zu
verwenden.
| Beschreibung: | TCP receive buffer size |
|---|---|
| Syntax: | ReceiveBufferSize bytes |
| Voreinstellung: | ReceiveBufferSize 0 |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
Die Dokumentation zu dieser Direktive wurde noch nicht übersetzt. Bitte schauen Sie in die englische Version.
| Beschreibung: | Ablageort der Datei, die zur Speicherung von Daten zur Koordinierung der Kindprozesse verwendet wird |
|---|---|
| Syntax: | ScoreBoardFile Dateipfad |
| Voreinstellung: | ScoreBoardFile logs/apache_status |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | beos, leader, mpm_winnt, perchild, prefork, threadpool, worker |
Apache verwendet ein Scoreboard zur Kommunikation zwischen seinen Eltern- und Kindprozessen. Einige Architekturen erfordern eine Datei zur Unterstützung der Kommunikation. Wenn die Datei undefiniert bleibt, versucht der Apache zuerst, das Scoreboard im Arbeitsspeicher zu erstellen (Verwendung von anonymem Shared-Memory), und versucht bei einem Fehlschlag anschließend die Datei auf der Festplatte zu erstellen (Verwendung von Datei-basiertem Shared-Memory). Die Angabe dieser Direktive veranlaßt den Apache stets, die Datei auf der Festplatte zu erstellen.
ScoreBoardFile /var/run/apache_status
Datei-basiertes Shared-Memory ist für Applikationen von Drittanbietern hilfreich, die direkten Zugriff auf das Scoreboard benötigen.
Wenn Sie eine ScoreBoardFile-Anweisung
verwenden, erreichen Sie eventuell eine höhere Geschwindigkeit, wenn
Sie die Datei auf einer RAM-Disk ablegen. Achten Sie darauf, die
gleichen Warnungen wie über die Ablage von Protokolldateien und
Sicherheit zu beherzigen.
| Beschreibung: | Größe des TCP-Puffers |
|---|---|
| Syntax: | SendBufferSize Bytes |
| Voreinstellung: | SendBufferSize 0 |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | beos, leader, mpm_netware, mpm_winnt, mpmt_os2, perchild, prefork, threadpool, worker |
Der Server setzt die Größe des TCP-Puffers auf die angegebene Anzahl Bytes. Dies ist sehr hilfreich, um Voreinstellungen alter Standardbetriebssysteme für Hochgeschwindigkeitsverbindungen mit hoher Latenzzeit anzuheben (d.h. 100ms oder so, wie bei Interkontinentalverbindungen).
Wird der Wert auf 0 gesetzt, dann verwendet der Server
die Voreinstellung des Betriebssystems.
| Beschreibung: | Obergrenze für die konfigurierbare Anzahl von Prozessen |
|---|---|
| Syntax: | ServerLimit Anzahl |
| Voreinstellung: | Für Details siehe Beschreibung |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | leader, perchild, prefork, threadpool, worker |
Bei dem MPM prefork bestimmt die Direktive
den während der Lebensdauer des Apache-Prozesses maximal
einstellbaren Wert für MaxClients. Beim MPM
worker bestimmt die Direktive in Verbindung mit
ThreadLimit den Maximalwert
für MaxClients
für die Lebensdauer des Apache-Prozesses. Jeder Versuch, diese
Anweisung während eines Neustarts zu ändern, wird ignoriert.
MaxClients kann jedoch
während eines Neustarts geändert werden.
Lassen Sie besondere Vorsicht bei der Verwendung dieser Direktive
walten. Wenn ServerLimit auf einen Wert deutlich
höher als notwendig gesetzt wird, wird zusätzliches,
unbenutztes Shared-Memory belegt. Wenn sowohl
ServerLimit als auch MaxClients auf Werte gesetzt werden, die
größer sind, als das System sie handhaben kann, dann kann
der Apache möglicherweise nicht starten, oder das System kann
instabil werden.
Verwenden Sie die Direktive bei dem MPM prefork
nur, wenn Sie MaxClients
auf mehr als 256 (Voreinstellung) setzen müssen. Setzen Sie den
Wert nicht höher als den Wert, den Sie für MaxClients angeben möchten.
Verwenden Sie die Direktive bei worker,
leader und threadpool nur, wenn Ihre
MaxClients- und
ThreadsPerChild-Einstellungen
mehr als 16 Serverprozesse (Voreinstellung) erfordern. Setzen Sie den
Wert dieser Direktive nicht höher, als die Anzahl der Serverprozesse,
die dafür erforderlich ist, was Sie bei MaxClients und
ThreadsPerChild angeben
möchten.
Verwenden Sie die Direktive beim MPM perchild nur,
wenn Sie NumServers auf einen
Wert größer als 8 (Voreinstellung) setzen müssen.
Eine feste Begrenzung von ServerLimit 20000 ist in den
Server einkompiliert (bei dem MPM prefork 200000).
Dies soll unangenehme Effekte durch Tippfehler verhindern.
| Beschreibung: | Anzahl der Kindprozesse des Servers, die beim Start erstellt werden |
|---|---|
| Syntax: | StartServers Anzahl |
| Voreinstellung: | Für Details siehe Beschreibung |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | leader, mpmt_os2, prefork, threadpool, worker |
Die Direktive StartServers bestimmt
die Anzahl der Kindprozesse des Servers, die beim Start erstellt
werden. Da die Anzahl der Prozesse abhängig von der Last
dynamisch kontrolliert wird, besteht normalerweise wenig
Grund für eine Änderung dieses Parameters.
Die Voreinstellung unterscheidet sich von MPM zu MPM. Bei
leader, threadpool und
worker ist die Voreinstellung
StartServers 3. Die Voreinstellung bei
prefork ist 5 und bei
mpmt_os2 2.
| Beschreibung: | Anzahl der Threads, die beim Start erstellt werden |
|---|---|
| Syntax: | StartThreads Anzahl |
| Voreinstellung: | Für Details siehe Beschreibung |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | beos, mpm_netware, perchild |
Anzahl der Threads, die beim Start erstellt werden. Da die Anzahl der Threads abhängig von der Last dynamisch kontrolliert wird, besteht normalerweise wenig Grund für eine Änderung dieses Parameters.
Die Voreinstellung für perchild ist
StartThreads 5. Die Direktive setzt während des
Starts die Anzahl der Threads pro Prozess.
Die Voreinstellung bei mpm_netware ist
StartThreads 50. Da hier lediglich ein einzelner Prozess
existiert, ist dies die Gesamtzahl der Threads, die beim Start
erstellt wird, um Anfragen zu bedienen.
Die Voreinstellung für beos ist StartThreads
10. Die Einstellung reflektiert ebenfalls die Gesamtzahl der Threads, die
beim Start erstellt werden, um Anfragen zu bedienen.
| Beschreibung: | Bestimmt die Obergrenze der konfigurierbaren Anzahl von Threads pro Kindprozess |
|---|---|
| Syntax: | ThreadLimit Anzahl |
| Voreinstellung: | Für Details siehe Beschreibung |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | leader, mpm_winnt, perchild, threadpool, worker |
| Kompatibilität: | Verfügbar für mpm_winnt ab
Apache 2.0.41 |
Die Direktive bestimmt den während der Lebensdauer des
Apache-Prozesses maximal einstellbaren Wert für
ThreadsPerChild. Jeder
Versuch, diese Direktive während eines Neustarts zu ändern,
wird ignoriert. ThreadsPerChild
kann jedoch während eines Neustarts modifiziert werden bis zu dem
Wert dieser Anweisung.
Lassen Sie besondere Vorsicht bei der Verwendung dieser Direktive
walten. Wenn ThreadLimit auf einen Wert
deutlich höher als ThreadsPerChild gesetzt wird, wird
zusätzliches, ungenutztes Shared-Memory belegt. Wenn sowohl
ThreadLimit als auch ThreadsPerChild auf Werte gesetzt werden,
die größer sind, als das System sie handhaben kann, dann kann
der Apache möglicherweise nicht starten oder das System kann
instabil werden. Setzen Sie den Wert dieser Direktive nicht höher
als Ihre größte erwartete Einstellung für
ThreadsPerChild
während der aktuellen Ausführung des Apache.
Die Voreinstellung für ThreadLimit ist
1920 wenn sie zusammen mit mpm_winnt
verwendet wird, und 64 bei der Verwendung mit anderen
MPMs.
Eine feste Begrenzung von ThreadLimit 20000
(oder ThreadLimit 15000 bei mpm_winnt)
ist in den Server einkompiliert. Dies soll unangenehme Effekte durch
Tippfehler verhindern.
| Beschreibung: | Anzahl der Threads, die mit jedem Kindprozess gestartet werden |
|---|---|
| Syntax: | ThreadsPerChild Anzahl |
| Voreinstellung: | Für Details siehe Beschreibung |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | leader, mpm_winnt, threadpool, worker |
Die Direktive legt die Anzahl der Threads fest, die mit jedem
Kindprozess gestartet werden. Der Kindprozess erstellt diese Threads
beim Start und erstellt später keine weiteren mehr. Wenn Sie ein
MPM wie mpm_winnt verwenden, wo nur ein
Kindprozess existiert, dann sollte diese Angabe hoch genug sein,
die gesamte Last des Servers zu bewältigen. Wenn Sie ein MPM
wie worker verwenden, wo mehrere Kindprozesse
existieren, dann sollte die Gesamtzahl der Thread groß
genug sein, die übliche Last auf dem Server zu bewältigen.
Die Voreinstellung für ThreadsPerChild ist
64, wenn mpm_winnt verwendet wird, und
25 bei der Verwendung der anderen MPMs.
| Beschreibung: | Die Größe des Stacks in Bytes, der von Threads verwendet wird, die Client-Verbindungen bearbeiten. |
|---|---|
| Syntax: | ThreadStackSize size |
| Voreinstellung: | 65536 unter NetWare; variiert bei anderen Betriebssystemen. |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | leader, mpm_netware, mpm_winnt, perchild, threadpool, worker |
| Kompatibilität: | Verfügbar seit Version 2.1 |
Die Direktive ThreadStackSize legt die
Größe des Stacks (für Autodaten) der Threads fest, die
Client-Verbindungen bearbeiten und Module aufrufen, welche bei der
Verarbeitung dieser Verbindungen helfen. In den meisten Fällen ist die
Voreinstellung des Betriebssystems angemessen, doch unter bestimmten
Umständen kann es sinnvoll sein, den Wert anzupassen:
ThreadStackSize auf einen höheren Wert als die
Betriebssystemvoreinstellung setzen. Eine solche Anpassung ist nur
notwendig, wenn es vom Anbieter des Moduls so spezifiziert wurde oder die
Diagnose eines Apache-Absturzes ergeben hat, das die
Thread-Stackgröße zu klein war.ThreadStackSize
auf einen Wert kleiner als die Betriebssystemvoreinstellung gesetzt wird.
Da es einzelne Anfragen geben kann, die mehr Stack zur Verarbeitung
benötigen, sollte eine derartige Korrektur ausschließlich in
Testumgebungen zum Einsatz kommen, auf denen die gesamte
Webserververarbeitung ausprobiert werden kann. Eine Änderung der
Webserverkonfiguration kann den aktuellen Wert der
ThreadStackSize ungültig machen.Apache HTTP Server Version 2.4
| Beschreibung: | Multi-Processing-Modul, das einen Hybrid-Webserver mit Multi-Thread und Multi-Prozess-Unterstützung implementiert |
|---|---|
| Status: | MPM |
| Modulbezeichner: | mpm_worker_module |
| Quelltext-Datei: | worker.c |
Dieses Multi-Processing-Modul (MPM) implementiert einen Hybrid-Server mit Multi-Thread und Multi-Prozess-Unterstützung. Durch die Verwendung von Threads für die Bedienung von Anfragen ist er in der Lage, eine große Anzahl von Anfragen mit weniger Systemressourcen als ein Prozess-basierter Server zu bedienen. Er behält jedoch viel von der Stabilität eines Prozess-basierten Servers bei, indem er mehrere Prozesse verfügbar hält, jeden mit etlichen Threads.
Die wichtigsten Direktiven zur Steuerung des MPMs sind ThreadsPerChild, welche die Anzahl
der Threads beeinflusst, die von jedem Kindprozess verwendet werden, und
MaxClients, welche die
maximale Gesamtzahl an Threads regelt, die gestartet werden
können.
CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers ThreadLimit ThreadsPerChild ThreadStackSize UserEin einzelner Steuerprozess (der Elternprozess) ist für den
Start der Kindprozesse verantwortlich. Jeder Kindprozess erstellt eine
feste Anzahl von Server-Threads, wie durch die ThreadsPerChild-Direktive
angegeben, sowie einen "Listener-Thread", der auf Verbindungen wartet und
diese an einen Server-Thread zur Bearbeitung weiterreicht, sobald sie
eintreffen.
Der Apache versucht immer, einen Vorrat von freien oder
unbeschäftigten Threads zu verwalten, die zur Bedienung
hereinkommender Anfragen bereit stehen. Auf diese Weise brauchen
Clients nicht auf die Erstellung eines neuen Threads oder Prozesses
zu warten, bevor ihre Anfrage bedient werden kann. Die Anzahl der
Prozesse, die anfangs gestartet wird, wird mit der Direktive
StartServers festgelegt.
Dann, während des Betriebes, berechnet der Apache die Gesamtzahl
der unbeschäftigten Threads und forkt oder beendet Prozesse, um diese
Anzahl innerhalb der durch MinSpareThreads und MaxSpareThreads angegebenen Grenzen
zu halten. Da dieser Prozess sehr selbstregulierend ist, ist es nur selten
notwendig, die Voreinstellung dieser Direktiven zu ändern. Die
maximale Anzahl Clients, die gleichzeitig bedient werden kann (d.h.
die maximale Gesamtzahl der Threads in allen Prozessen), wird mit der
Direktive MaxClients
festgelegt. Die maximale Anzahl der aktiven Kindprozesse ergibt sich aus
MaxClients dividiert durch
ThreadsPerChild.
Zwei Direktiven legen harte Limits für die Anzahl der aktiven
Kindprozesse fest und können nur geändert werden, indem der Server
komplett gestoppt und dann wieder neu gestartet wird. ServerLimit stellt die obere Grenze für
die Anzahl der aktiven Kindprozesse dar und muss größer oder
gleich dem Quotienten aus MaxClients und ThreadsPerChild sein. ThreadLimit ist die obere Grenze für
die Anzahl der Server-Threads und muss größer oder gleich
ThreadsPerChild sein. Sofern für
diese Direktiven keine Voreinstellungen verwendet werden, sollten sie vor
allen anderen worker-Direktiven platziert werden.
Neben den normalen aktiven Kindprozessen gibt es möglicherweise noch
zusätzliche Kindprozesse, welche gerade beendet werden, wo allerdings
zumindest noch ein Server-Thread eine existierende Verbindung bearbeitet.
Obwohl die tatsächlich zu erwartende Anzahl deutlich kleiner ist,
können bis zu MaxClients
solcher Prozesse auftreten. Dieses Verhalten können Sie vermeiden,
indem Sie die Terminierung einzelner Kindprozesse wie folgt abschalten:
MaxRequestsPerChild auf NullMaxSpareThreads auf den gleichen Wert wie MaxClientsEine typische Konfiguration der Prozess-Thread-Steuerung für
das MPM worker könnte wie folgt aussehen:
ServerLimit 16
StartServers 2
MaxClients 150
MinSpareThreads 25
MaxSpareThreads 75
ThreadsPerChild 25
Während der Elternprozess unter Unix normalerweise als
root gestartet wird, um sich an Port 80 binden zu können,
werden die Kindprozesse und Threads unter einem weniger privilegierten
Benutzer gestartet. Die Direktiven User und Group werden dazu verwendet, die
Privilegien der Apache-Kindprozesse festzulegen. Die Kindprozesse
müssen in der Lage sein, alle Inhalte zu lesen, die sie ausliefern
sollen, sollten darüber hinaus jedoch so wenig wie möglich Rechte
besitzen. Zusätzlich, solange nicht suexec verwendet wird, legen diese
Direktiven auch die Privilegien fest, die von CGI-Skripts
geerbt werden.
MaxRequestsPerChild
bestimmt, wie häufig der Server Prozesse erneuert, indem er alte
beendet und neue startet.
Serveur HTTP Apache Version 2.4
| Description: | Journalisation des requêtes envoyées au serveur |
|---|---|
| Statut: | Base |
| Identificateur de Module: | log_config_module |
| Fichier Source: | mod_log_config.c |
Ce module apporte une grande souplesse dans la journalisation des requêtes des clients. Les journaux sont écrits sous un format personnalisable, et peuvent être enregistrés directement dans un fichier, ou redirigés vers un programme externe. La journalisation conditionnelle est supportée, si bien que des requêtes individuelles peuvent être incluses ou exclues des journaux en fonction de leur caractéristiques.
Ce module fournit trois directives : TransferLog crée un fichier
journal, LogFormat
définit un format personnalisé, et CustomLog définit un fichier journal et un format en
une seule étape. Pour journaliser les requêtes dans plusieurs
fichiers, vous pouvez utiliser plusieurs fois les directives
TransferLog et
CustomLog dans chaque serveur.
L'argument format des directives LogFormat et CustomLog est une chaîne de
caractères. Cette chaîne définit le format de la journalisation des
requêtes dans le fichier journal. Elle peut contenir des caractères
littéraux qui seront reproduits dans le fichier journal, et les
caractères de contrôle de style C "\n" et "\t" représentant
respectivement une nouvelle ligne et une tabulation. Les guillemets
et les anti-slashes littéraux doivent être échappés à l'aide
d'anti-slashes.
Les caractéristiques de la requête en elle-même sont journalisées
en insérant des directives "%" dans la chaîne de
format, celles-ci étant remplacées dans le fichier journal par
certaines valeurs comme suit :
| Chaîne de format | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
%% |
Le signe "pourcentage" | ||||||||||
%a |
L'adresse IP distante (voir le module
mod_remoteip). | ||||||||||
%{c}a |
Adresse IP distante de la connexion(voir le module
mod_remoteip) | ||||||||||
%A |
L'adresse IP locale | ||||||||||
%B |
La taille de la réponse en octets, en excluant les en-têtes HTTP. | ||||||||||
%b |
La taille de la réponse en octets, en excluant les en-têtes
HTTP. Au format CLF , c'est à dire un '-' à la
place d'un 0 lorsqu'aucun octet n'est renvoyé. | ||||||||||
%{NOMVAR}C |
Le contenu du cookie NOMVAR dans la requête envoyée au serveur. Seuls les cookies version 0 sont pleinement supportés. | ||||||||||
%D |
Le temps mis à servir la requête, en microsecondes. | ||||||||||
%{NOMVAR}e |
Le contenu de la variable d'environnement NOMVAR | ||||||||||
%f |
Nom de fichier | ||||||||||
%h |
Serveur distant. Contiendra l'adresse IP si la directive
HostnameLookups est définie
à Off, ce qui est sa valeur par défaut. Si cette
adresse IP n'est enregistrée que pour certains serveurs, vous
avez probablement défini des directives de contrôle d'accès qui
mentionnent ces derniers par leurs noms. Voir la documentation de Require
host. | ||||||||||
%{c}h |
Semblable à %h, mais exploite toujours le nom d'hôte de
la connection TCP sous-jacente, en ignorant toute modification réalisée
sur le nom d'hôte distant par des modules tels que
mod_remoteip. | ||||||||||
%H |
Le protocole de la requête | ||||||||||
%{NOMVAR}i |
Le contenu des lignes d'en-tête
NOMVAR: dans la requête envoyée au
serveur. Ces en-têtes sont ajoutés par d'autres modules (par
exemple mod_headers). Si vous êtes intéressé
par ce qu'était l'en-tête de la requête avant d'être modifié
par la plupart des modules, utilisez
mod_setenvif pour copier l'en-tête dans une
variable d'environnement interne et journaliser sa valeur via
le champ %{VARNAME}e décrit plus haut.
| ||||||||||
%k |
Nombre de requêtes persistantes en cours pour cette
connexion. Interessant si la directive KeepAlive est utilisée ; par exemple,
'1' signifie la première requête après la requête initiale, '2'
la seconde, etc... ; autrement, il s'agit toujours de 0
(indiquant la requête initiale). | ||||||||||
%l |
Le nom de connexion distant (en provenance d'identd, si
disponible). Affiche un tiret, sauf si
mod_ident est présent et si IdentityCheck est à
On. | ||||||||||
%L |
L'identifiant du message de journalisation de la requête dans le journal des erreurs (ou '-' si aucun message n'a été enregistré dans le journal des erreurs pour cette requête) | ||||||||||
%m |
La méthode de la requête | ||||||||||
%{NOMVAR}n |
Le contenu de la note NOMVAR en provenance d'un autre module. | ||||||||||
%{NOMVAR}o |
Le contenu de la ligne d'en-tête
NOMVAR: de la réponse. | ||||||||||
%p |
Le port canonique du serveur servant la requête | ||||||||||
%{format}p |
Le port canonique du serveur servant la requête ou le
véritable port du serveur ou le véritable port du client. les
formats valides sont canonical, local,
ou remote.
| ||||||||||
%P |
Le numéro de processus du processus enfant qui a servi la requête. | ||||||||||
%{format}P |
Le numéro de processus ou le numéro de thread du processus
enfant qui a servi la requête. Les formats valides sont
pid, tid, et hextid.
| ||||||||||
%q |
La chaîne d'arguments (préfixée par un ? si une
chaîne d'arguments existe, sinon une chaîne vide) | ||||||||||
%r |
La première ligne de la requête | ||||||||||
%R |
Le gestionnaire qui génère la réponse (s'il y en a un). | ||||||||||
%s |
Statut. Pour les requêtes redirigées en interne, il s'agit
du statut de la requête *originale* --- %>s pour
la dernière. | ||||||||||
%t |
Date à laquelle la requête a été reçue (au format anglais standard) | ||||||||||
%{format}t |
La date, sous la forme spécifiée par format, qui devrait
être au format étendu strftime(3) (éventuellement
localisé). Si le format commence par begin: (valeur
par défaut), la date est extraite au début du traitement de la
requête ; s'il commence par end:, la date
correspond au moment où l'entrée du journal est inscrite, par
conséquent vers la fin du traitement de la requête. Hormis les
formats supportés par strftime(3), les formats
suivants sont aussi disponibles :
strftime(3) dans la même chaîne de
format. Par contre, vous pouvez utiliser plusieurs symboles
%{format}t. | ||||||||||
%T |
Le temps mis pour servir la requête, en secondes. | ||||||||||
%{UNIT}T |
Le temps mis pour traiter la requête dans une unité définie
par UNIT. Les valeurs d'unité valides sont
ms pour millisecondes, us pour
microsecondes et s pour secondes. Si
UNIT est omis, la valeur de l'unité par défaut est
la seconde ; spécifier la valeur d'unité us revient
à utiliser le format %D. La possibilité de
spécifier une valeur d'unité avec le format %T est
disponible depuis la version 2.4.13 du serveur HTTP Apache. | ||||||||||
%u |
L'utilisateur distant (en provenance d'auth ; peut être faux
si le statut de retour (%s) est 401). | ||||||||||
%U |
Le chemin de la requête, à l'exclusion de toute chaîne d'arguments. | ||||||||||
%v |
Le nom canonique du serveur qui a servi la requête, défini
par la directive ServerName. | ||||||||||
%V |
La nom du serveur en tenant compte de la définition de la
directive UseCanonicalName. | ||||||||||
%X |
Statut de la connexion lorsque la réponse a été renvoyée
:
| ||||||||||
%I |
Le nombre d'octets reçus, en comptant la requête et les
en-têtes, ne peut être nul. Nécessite l'activation de
mod_logio. | ||||||||||
%O |
Nombre d'octets envoyés, y compris les en-têtes. Peut être
nul dans les rares cas où une requête est avortée avant que la
réponse ne soit envoyée. Nécessite l'activation de
mod_logio. | ||||||||||
%S |
Nombre d'octets transmis (en émission et réception), y
compris corps et en-têtes de requête. Ce nombre ne peut pas être
nul, et il correspond à la combinaison des formats %I et %O.
mod_logio doit être chargé pour pouvoir
utiliser ce format. | ||||||||||
%{VARNAME}^ti |
Le contenu de VARNAME: dans les
paramètres de la requête envoyée au serveur. | ||||||||||
%{VARNAME}^to |
Le contenu de VARNAME: dans les
paramètres de la réponse envoyée par le serveur. |
Il est possible de restreindre l'enregistrement de certains
éléments
en fonction du code de statut de la réponse, en insérant une liste
de codes de statut séparés par des virgules immédiatement après le
caractère "%". Par exemple, "%400,501{User-agent}i"
n'enregistrera l'en-tête User-agent que dans le cas
d'une erreur 400 ou 501. Avec les autres codes de statut, c'est la
chaîne littérale "-" qui sera enregistrée. La liste
de codes peut être précédée d'un "!" pour inverser la
condition : "%!200,304,302{Referer}i" enregistre
l'en-tête Referer pour toutes les requêtes qui
ne renvoient pas un des trois codes spécifiés.
Les modificateurs "<" et ">" peuvent être utilisés pour
les requêtes qui ont été redirigées en interne afin de choisir si
c'est respectivement la requête originale ou finale qui doit être
consultée. Par défaut, les directives %s, %U, %T, %D,
et %r consultent la requête originale, alors que
toutes les autres consultent la requête finale. Ainsi, par
exemple, on peut utiliser %>s pour enregistrer le
statut final de la requête, et %<u pour
enregistrer l'utilisateur authentifié à l'origine pour une requête
redirigée en interne vers une ressource sans authentification.
Pour des raisons de sécurité, à partir de la version 2.0.46,
les caractères non imprimables et autres caractères spéciaux dans
les directives %r, %i et %o
doivent être échappés à l'aide des séquences
\xhh,
où hh est le code hexadécimal du caractère spécial.
Comme exceptions à cette règle, les caractères " et
\ doivent être échappés par un anti-slash, et tous
les "blancs" doivent être écrits selon leur notation de style C
(\n, \t, etc...). Avant la version
2.0.46, aucun échappement n'était effectué sur ces chaînes, et il
fallait être très prudent lors de l'exploitation des journaux
bruts.
A la différence de la version 1.3, depuis httpd 2.0, les chaînes
de format %b et %B ne représentent pas
le nombre d'octets envoyés au client, mais simplement la taille en
octets de la réponse HTTP (les deux étant différents, par exemple,
si la connexion est abandonnée, ou si SSL est utilisé). Le format
%O fourni par mod_logio,
enregistrera le nombre réel d'octets envoyés sur le réseau.
Note : mod_cache est implémenté en tant que
gestionnaire basique et non en tant que gestionnaire standard.
C'est pourquoi la chaîne de format %R ne renverra pas
d'information à propos du gestionnaire lorsqu'une mise en cache de
contenu entre en jeu.
Quelques chaînes de format couramment utilisées :
"%h %l %u %t \"%r\" %>s %b""%v %h %l %u %t \"%r\" %>s %b""%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\"""%{Referer}i -> %U""%{User-agent}i"Vous pouvez utiliser plusieurs fois la directive
%{format}t pour construire un format de temps
utilisant les symboles de format étendus tels que
msec_frac :
"%{%d/%b/%Y %T}t.%{msec_frac}t %{%z}t"Voir le document conseils à matière de sécurité pour plus de détails sur les raisons pour lesquelles votre sécurité pourrait être compromise, si le répertoire où sont stockés les fichiers journaux sont inscriptibles par tout autre utilisateur que celui qui démarre le serveur.
| Description: | Enregistre les entrées du journal dans un tampon en mémoire avant de les écrire sur disque |
|---|---|
| Syntaxe: | BufferedLogs On|Off |
| Défaut: | BufferedLogs Off |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_log_config |
Lorsque la directive BufferedLogs est à
"on", mod_log_config stocke de nombreuses entrées
du journal en mémoire, et les écrit d'un seul bloc sur disque,
plutôt que de les écrire après chaque requête. Sur certains
systèmes, ceci peut améliorer l'efficacité des accès disque, et par
conséquent les performances. La directive ne peut être définie
qu'une seule fois pour l'ensemble du serveur ; elle ne peut pas être
définie au niveau d'un serveur virtuel.
| Description: | Définit le nom et le format du fichier journal |
|---|---|
| Syntaxe: | CustomLog fichier|pipe
format|alias
[env=[!]variable-environnement|
expr=expression] |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_log_config |
La directive CustomLog permet de contrôler
la journalisation des requêtes destinées au serveur. Un format de
journal est spécifié, et la journalisation peut s'effectuer de
manière conditionnelle en fonction des caractéristiques de la
requête en utilisant des variables d'environnement.
Le premier argument, qui spécifie l'emplacement où les journaux seront écrits, accepte deux types de valeurs :
ServerRoot.|", suivi du chemin vers un
programme qui recevra les informations de la journalisation sur
son entrée standard. Voir les notes à propos de la journalisation redirigée pour plus
d'informations.
Si les journaux sont redirigés vers un programme, ce dernier
s'exécutera sous l'utilisateur qui a démarré
httpd. Ce sera l'utilisateur root si le serveur
a été démarré par root ; vérifiez que le programme est
sécurisé.
Lors de la spécification d'un chemin de fichier sur les plate-formes non-Unix, il faut prendre soin de ne pas oublier que seuls les slashes directs doivent être utilisés, même si la plate-forme autorise l'emploi d'anti-slashes. D'une manière générale, c'est une bonne idée que de n'utiliser que des slashes directs dans les fichiers de configuration.
Le second argument permet de définir ce qui va être écrit dans le
fichier journal. Il peut contenir soit un alias prédéfini
par une directive LogFormat, soit une chaîne de
format explicite comme décrit dans la section formats de journaux.
Par exemple, les deux blocs de directives suivants produisent le même effet :
# Journal personnalisé avec alias de format LogFormat "%h %l %u %t \"%r\" %>s %b" common CustomLog "logs/access_log" common # Journal personnalisé avec chaîne de format explicite CustomLog "logs/access_log" "%h %l %u %t \"%r\" %>s %b"
Le troisième argument est optionnel et permet de contrôler si une
requête doit être ou non journalisée. Dans le cas d'une clause
'env=!nom', la condition peut être la
présence ou l'absence d'une variable particulière dans
l'environnement du serveur. Dans le cas
d'une clause 'expr=expression', la condition consiste
en une expression booléenne
quelconque. Si la condition n'est pas vérifiée, la requête ne sera
pas journalisée. D'éventuelles références à des en-têtes HTTP dans
l'expression rationnelle n'entraîneront pas l'ajout des noms
d'en-tête correspondants à l'en-tête Vary.
Les variables d'environnement peuvent être définies au niveau de
chaque requête en utilisant les modules
mod_setenvif et/ou mod_rewrite.
Par exemple, si vous voulez enregistrer les requêtes pour toutes les
images GIF sur votre serveur dans un fichier journal séparé, et pas
dans votre journal principal, vous pouvez utiliser :
SetEnvIf Request_URI \.gif$ gif-image CustomLog "gif-requests.log" common env=gif-image CustomLog "nongif-requests.log" common env=!gif-image
Ou, pour reproduire le comportement de l'ancienne directive RefererIgnore, vous pouvez utiliser :
SetEnvIf Referer example\.com localreferer CustomLog "referer.log" referer env=!localreferer
| Description: | Définit le nom et le format du fichier journal |
|---|---|
| Syntaxe: | GlobalLogfile|pipe
format|nickname
[env=[!]environment-variable|
expr=expression] |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_log_config |
| Compatibilité: | Disponible à partir de la version 2.4.19 du serveur HTTP Apache |
La directive GlobalLog permet de spécifier un
journal partagé entre le serveur principal et tous les serveurs virtuels
définis.
Elle est identique à la directive CustomLog à ces
différences près :
CustomLog
définie globalement, elle est prise en compte par les serveurs virtuels
qui définissent leur propre directive CustomLog.| Description: | Décrit un format utilisable dans un fichier journal |
|---|---|
| Syntaxe: | LogFormat format|alias
[alias] |
| Défaut: | LogFormat "%h %l %u %t \"%r\" %>s %b" |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_log_config |
Cette directive permet de spécifier le format du fichier journal des accès.
La directive LogFormat se présente sous
deux formes. Sous la première forme, qui ne possède qu'un seul
argument, la directive définit le format qui sera utilisé dans les
journaux spécifiés par les directives
TransferLog ultérieures. L'argument unique
peut contenir un format explicite comme décrit dans la
section formats de journaux personnalisés
ci-dessus. Il peut aussi contenir un alias faisant
référence à un format de journal prédéfini par une directive
LogFormat comme décrit plus loin.
Sous sa seconde forme, la directive
LogFormat associe un format
explicite à un alias. Cet alias peut
ensuite s'utiliser dans les directives
LogFormat ou CustomLog ultérieures, ce qui
évite d'avoir à répéter l'ensemble de la chaîne de format. Une
directive LogFormat qui définit un alias
ne fait rien d'autre -- c'est à dire qu'elle ne
fait que définir l'alias, elle n'applique pas le format et n'en
fait pas le format par défaut. Par conséquent, elle n'affecte pas
les directives TransferLog ultérieures. En
outre, la directive LogFormat ne peut pas
utiliser un alias pour en définir un autre. Notez que l'alias ne
doit pas contenir de caractère pourcent (%).
LogFormat "%v %h %l %u %t \"%r\" %>s %b" serveur_virtuel_commun
| Description: | Spécifie l'emplacement d'un fichier journal |
|---|---|
| Syntaxe: | TransferLog fichier|pipe |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_log_config |
Cette directive possède exactement les mêmes arguments et produit
les mêmes effets que la directive CustomLog, à l'exception qu'elle
ne permet pas de spécifier un format de journal explicite ou la
journalisation conditionnelle des requêtes. En l'occurrence, le
format de journal est déterminé par la dernière définition d'une
directive LogFormat
qui ne définit pas d'alias. Si aucun format particulier n'a été
spécifié, c'est le Common Log Format qui sera utilisé.
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
TransferLog logs/access_log
Apache HTTP Server Version 2.4
| Description: | Execution of CGI scripts using an external CGI daemon |
|---|---|
| Status: | Base |
| Module Identifier: | cgid_module |
| Source File: | mod_cgid.c |
| Compatibility: | Unix threaded MPMs only |
Except for the optimizations and the additional ScriptSock directive noted below,
mod_cgid behaves similarly to mod_cgi.
See the mod_cgi summary for additional details
about Apache and CGI.
On certain unix operating systems, forking a process from a
multi-threaded server is a very expensive operation because the
new process will replicate all the threads of the parent
process. In order to avoid incurring this expense on each CGI
invocation, mod_cgid creates an external daemon that is
responsible for forking child processes to run CGI scripts. The
main server communicates with this daemon using a unix domain
socket.
This module is used by default instead of
mod_cgi whenever a multi-threaded MPM
is selected during the compilation process. At the user level,
this module is identical in configuration and operation to
mod_cgi. The only exception is the
additional directive ScriptSock which gives the
name of the socket to use for communication with the cgi
daemon.
| Description: | The length of time to wait for more output from the CGI program |
|---|---|
| Syntax: | CGIDScriptTimeout time[s|ms] |
| Default: | value of |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Base |
| Module: | mod_cgid |
| Compatibility: | Available in httpd 2.4.10 and later; in prior releases no timeout was applied |
This directive limits the length of time to wait for more output from the CGI program. If the time is exceeded, the request and CGI are terminated.
CGIDScriptTimeout 20
| Description: | The filename prefix of the socket to use for communication with the cgi daemon |
|---|---|
| Syntax: | ScriptSock file-path |
| Default: | ScriptSock cgisock |
| Context: | server config |
| Status: | Base |
| Module: | mod_cgid |
This directive sets the filename prefix of the socket to use for communication with the CGI daemon, an extension corresponding to the process ID of the server will be appended. The socket will be opened using the permissions of the user who starts Apache (usually root). To maintain the security of communications with CGI scripts, it is important that no other user has permission to write in the directory where the socket is located.
If file-path is not an absolute path, the location specified
will be relative to the value of
DefaultRuntimeDir.
ScriptSock /var/run/cgid.sock
Serveur HTTP Apache Version 2.4
| Description: | Authentification utilisateur à l'aide d'une base de données SQL |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | authn_dbd_module |
| Fichier Source: | mod_authn_dbd.c |
| Compatibilité: | Disponible depuis la version 2.1 d'Apache |
Ce module permet aux frontaux d'authentification comme
mod_auth_digest et mod_auth_basic
d'authentifier les utilisateurs en les recherchant dans une base de
données SQL. mod_authn_file, par exemple, fournit
une fonctionnalité similaire.
Ce module s'appuie sur mod_dbd pour spécifier le
pilote de la base de données sous-jacente et les paramètres de
connexion, mais aussi pour gérer les connexions à la base de
données.
Si l'on utilise mod_auth_basic ou
mod_auth_digest, on peut invoquer ce module en
affectant la valeur dbd à la directive AuthBasicProvider ou AuthDigestProvider.
Performances et mise en cache Exemple de configuration Mise à disposition des informations de connexionCertains utilisateurs de l'authentification DBD sous HTTPD 2.2/2.4 ont
signalé une charge problématique au niveau de la base de données. Cela
se produit en général lorsqu'une page HTML contient des centaines d'objets
(comme des images, des scripts, etc...), chacun d'entre eux nécessitant
une authentification. Les utilisateurs qui rencontrent ce genre de
problème peuvent utiliser le module mod_authn_socache
qui permet de mettre les données d'authentification en cache, et
soulager ainsi la base de données de la plus grande partie de la charge.
Voici un exemple simple d'utilisation de ce module dans un contexte d'authentification et de bases de données.
# configuration de mod_dbd # MISE À JOUR pour inclure la mise en cache de l'authentification DBDriver pgsql DBDParams "dbname=apacheauth user=apache password=xxxxxx" DBDMin 4 DBDKeep 8 DBDMax 20 DBDExptime 300 <Directory "/usr/www/mon-serveur/private"> # configuration de mod_authn_core et mod_auth_basic # pour mod_authn_dbd AuthType Basic AuthName "Mon serveur" # Pour mettre en cache les données d'authentification, placez socache # avant dbd AuthBasicProvider socache dbd # Aussi nécessaire à la mise en cache : dire au cache de mettre en # cache les recherches dbd ! AuthnCacheProvideFor dbd AuthnCacheContext mon-serveur # configuration de mod_authz_core Require valid-user # la requête SQL de mod_authn_dbd pour authentifier un utilisateur AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s" </Directory>
Pour chaque requête envoyée au serveur de base de données, toutes les valeurs de colonnes du premier enregistrement renvoyé par la requête sont affectées à des variables d'environnement avec le préfixe "AUTHENTICATE_".
Par exemple, si une requête renvoie un nom d'utilisateur, un nom complet et un numéro de téléphone, un programme CGI pourra accéder à ces informations sans avoir besoin d'effectuer une deuxième requête vers la base de données.
Ceci va entraîner une simplification considérable du code et de la configuration nécessaire de certaines applications web.
| Description: | Requête SQL servant à vérifier le mot de passe d'un utilisateur |
|---|---|
| Syntaxe: | AuthDBDUserPWQuery requête |
| Contexte: | répertoire |
| Statut: | Extension |
| Module: | mod_authn_dbd |
La directive AuthDBDUserPWQuery permet de
spécifier une requête servant à vérifier le mot de passe d'un
utilisateur donné. L'identifiant utilisateur sera transmis comme
paramètre sous forme d'une seule chaîne de caractères lorsque la
requête sera exécutée. Cet identifiant est référencé dans la requête
en utilisant le spécificateur de format %s.
AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
La première colonne du premier enregistrement renvoyé par la
requête se présentera sous la forme d'une chaîne de caractères
contenant le mot de passe chiffré. Les enregistrements suivants sont
ignorés. Si aucun enregistrement n'est renvoyé, l'utilisateur ne
sera pas authentifié par mod_authn_dbd.
Toute valeur de colonne supplémentaire
du premier enregistrement renvoyé par la requête sera stockée dans
une variable d'environnement dont le nom aura la forme
AUTHENTICATE_valeur-colonne.
Le format du mot de passe chiffré dépend du frontal
d'authentification utilisé (par exemple
mod_auth_basic ou
mod_auth_digest). Voir la documentation sur les Formats de mots de passe pour
plus de détails.
| Description: | Requête SQL servant à vérifier une empreinte de mot de passe pour un utilisateur et un identifiant d'authentification. |
|---|---|
| Syntaxe: | AuthDBDUserRealmQuery requête |
| Contexte: | répertoire |
| Statut: | Extension |
| Module: | mod_authn_dbd |
La directive AuthDBDUserRealmQuery permet
de spécifier une requête SQL servant à vérifier une empreinte de mot
de passe pour un utilisateur et un identifiant d'authentification
donnés au cours d'un processus d'authentification digest. Les
identifiants de l'utilisateur et de l'authentification
sont passés dans cet ordre comme paramètres à l'exécution de la
requête. Ils sont référencés dans la chaîne de la requête en
utilisant des spécificateurs de format %s.
AuthDBDUserRealmQuery "SELECT password FROM authn WHERE user = %s AND realm = %s"
La première colonne du premier enregistrement renvoyé par la
requête se présentera sous la forme d'une chaîne de caractères
contenant le mot de passe chiffré. Les enregistrements suivants
seront ignorés. Si aucun enregistrement n'est renvoyé, l'utilisateur
ne sera pas authentifié par mod_authn_dbd.
Toute valeur de colonne supplémentaire
du premier enregistrement renvoyé par la requête sera stockée dans
une variable d'environnement avec un nom de la forme
AUTHENTICATE_COLONNE.
Le format du mot de passe chiffré dépend du frontal
d'authentification utilisé (par exemple
mod_auth_basic ou
mod_auth_digest). Voir la documentation sur les Formats de mots de passe pour
plus de détails.
Apache HTTP サーバ バージョン 2.4
| 説明: | バージョン依存の設定 |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | version_module |
| ソースファイル: | mod_version.c |
様々なバージョンの httpd の異なる設定を扱うことになる、
テストスイートや大規模ネットワークでの使用のために設計されています。
このモジュールは新しいコンテナ ― <IfVersion> を
提供します。これを使うと、数字の比較や正規表現による柔軟な
バージョンチェックができるようになります。
<IfVersion 2.4.2>
# current httpd version is exactly 2.4.2
</IfVersion>
<IfVersion >= 2.5>
# use really new features :-)
</IfVersion>
詳細は以下を読んでください。
| 説明: | バージョン依存の設定を入れる |
|---|---|
| 構文: | <IfVersion [[!]operator] version> ...
</IfVersion> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Extension |
| モジュール: | mod_version |
<IfVersion> は httpd のバージョン
が基準を満たしたときにのみ実行させたいディレクティブを囲みます。
通常の (数値) 比較のときは version 引数は
major[.minor[.patch]] という
形式、例えば、2.1.0 や 2.2 となります。
minor と patch は省略可能です。省略された場合は、
0 を指定したものとみなされます。比較には次の数値 operator を
指定できます:
| operator | 説明 |
|---|---|
= と == |
同じ httpd バージョン |
> |
より大きい httpd バージョン |
>= |
指定以上の httpd バージョン |
< |
指定未満の httpd バージョン |
<= |
指定以下の httpd バージョン |
<IfVersion >= 2.3>
# this happens only in versions greater or
# equal 2.3.0.
</IfVersion>
数値比較に加えて、http のバージョン番号に対して 正規表現による マッチングができます。二種類の書き方があります:
| operator | 説明 |
|---|---|
= or == |
version は
/regex/ 形式 |
~ |
version は
regex 形式 |
<IfVersion = /^2.4.[01234]$/>
# e.g. workaround for buggy versions
</IfVersion>
マッチングの否定を表現するために、すべてのオペレータは前に
感嘆符 (!)を付けることができます:
<IfVersion !~ ^2.4.[01234]$>
# not for those versions
</IfVersion>
operator が省略されたときは = と
みなされます。
Apache HTTP Server Version 2.4
| Description: | Core Apache HTTP Server features that are always available |
|---|---|
| Status: | Core |
AcceptFilter AcceptPathInfo AccessFileName AddDefaultCharset AllowEncodedSlashes AllowOverride AllowOverrideList CGIMapExtension CGIPassAuth CGIVar ContentDigest DefaultRuntimeDir DefaultType Define <Directory> <DirectoryMatch> DocumentRoot <Else> <ElseIf> EnableMMAP EnableSendfile Error ErrorDocument ErrorLog ErrorLogFormat ExtendedStatus FileETag <Files> <FilesMatch> FlushMaxPipelined FlushMaxThreshold ForceType GprofDir HostnameLookups HttpProtocolOptions <If> <IfDefine> <IfDirective> <IfFile> <IfModule> <IfSection> Include IncludeOptional KeepAlive KeepAliveTimeout <Limit> <LimitExcept> LimitInternalRecursion LimitRequestBody LimitRequestFields LimitRequestFieldSize LimitRequestLine LimitXMLRequestBody <Location> <LocationMatch> LogLevel MaxKeepAliveRequests MaxRangeOverlaps MaxRangeReversals MaxRanges MergeSlashes MergeTrailers Mutex NameVirtualHost Options Protocol Protocols ProtocolsHonorOrder QualifyRedirectURL ReadBufferSize RegexDefaultOptions RegisterHttpMethod RLimitCPU RLimitMEM RLimitNPROC ScriptInterpreterSource SeeRequestTail ServerAdmin ServerAlias ServerName ServerPath ServerRoot ServerSignature ServerTokens SetHandler SetInputFilter SetOutputFilter StrictHostCheck TimeOut TraceEnable UNCList UnDefine UseCanonicalName UseCanonicalPhysicalPort <VirtualHost>| Description: | Configures optimizations for a Protocol's Listener Sockets |
|---|---|
| Syntax: | AcceptFilter protocol accept_filter |
| Context: | server config |
| Status: | Core |
| Module: | core |
This directive enables operating system specific optimizations for a
listening socket by the Protocol type.
The basic premise is for the kernel to not send a socket to the server
process until either data is received or an entire HTTP Request is buffered.
Only
FreeBSD's Accept Filters, Linux's more primitive
TCP_DEFER_ACCEPT, and Windows' optimized AcceptEx()
are currently supported.
Using none for an argument will disable any accept filters
for that protocol. This is useful for protocols that require a server
send data first, such as ftp: or nntp:
AcceptFilter nntp none
The default protocol names are https for port 443
and http for all other ports. To specify that another
protocol is being used with a listening port, add the protocol
argument to the Listen
directive.
The default values on FreeBSD are:
AcceptFilter http httpready AcceptFilter https dataready
The httpready accept filter buffers entire HTTP requests at
the kernel level. Once an entire request is received, the kernel then
sends it to the server. See the
accf_http(9) man page for more details. Since HTTPS requests are
encrypted, only the
accf_data(9) filter is used.
The default values on Linux are:
AcceptFilter http data AcceptFilter https data
Linux's TCP_DEFER_ACCEPT does not support buffering http
requests. Any value besides none will enable
TCP_DEFER_ACCEPT on that listener. For more details
see the Linux
tcp(7) man page.
The default values on Windows are:
AcceptFilter http connect AcceptFilter https connect
Window's mpm_winnt interprets the AcceptFilter to toggle the AcceptEx()
API, and does not support http protocol buffering. connect
will use the AcceptEx() API, also retrieve the network endpoint
addresses, but like none the connect option
does not wait for the initial data transmission.
On Windows, none uses accept() rather than AcceptEx()
and will not recycle sockets between connections. This is useful for
network adapters with broken driver support, as well as some virtual
network providers such as vpn drivers, or spam, virus or spyware
filters.
data AcceptFilter (Windows)For versions 2.4.23 and prior, the Windows data accept
filter waited until data had been transmitted and the initial data
buffer and network endpoint addresses had been retrieved from the
single AcceptEx() invocation. This implementation was subject to a
denial of service attack and has been disabled.
Current releases of httpd default to the connect filter
on Windows, and will fall back to connect if
data is specified. Users of prior releases are encouraged
to add an explicit setting of connect for their
AcceptFilter, as shown above.
| Description: | Resources accept trailing pathname information |
|---|---|
| Syntax: | AcceptPathInfo On|Off|Default |
| Default: | AcceptPathInfo Default |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
This directive controls whether requests that contain trailing
pathname information that follows an actual filename (or
non-existent file in an existing directory) will be accepted or
rejected. The trailing pathname information can be made
available to scripts in the PATH_INFO environment
variable.
For example, assume the location /test/ points to
a directory that contains only the single file
here.html. Then requests for
/test/here.html/more and
/test/nothere.html/more both collect
/more as PATH_INFO.
The three possible arguments for the
AcceptPathInfo directive are:
Off/test/here.html/more in the above example will return
a 404 NOT FOUND error.On/test/here.html/more will be accepted if
/test/here.html maps to a valid file.DefaultPATH_INFO requests. Handlers that serve scripts, such as cgi-script and isapi-handler, generally accept
PATH_INFO by default.The primary purpose of the AcceptPathInfo
directive is to allow you to override the handler's choice of
accepting or rejecting PATH_INFO. This override is required,
for example, when you use a filter, such
as INCLUDES, to generate content
based on PATH_INFO. The core handler would usually reject
the request, so you can use the following configuration to enable
such a script:
<Files "mypaths.shtml"> Options +Includes SetOutputFilter INCLUDES AcceptPathInfo On </Files>
| Description: | Name of the distributed configuration file |
|---|---|
| Syntax: | AccessFileName filename [filename] ... |
| Default: | AccessFileName .htaccess |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
While processing a request, the server looks for the first existing configuration file from this list of names in every directory of the path to the document, if distributed configuration files are enabled for that directory. For example:
AccessFileName .acl
Before returning the document
/usr/local/web/index.html, the server will read
/.acl, /usr/.acl,
/usr/local/.acl and /usr/local/web/.acl
for directives unless they have been disabled with:
<Directory "/">
AllowOverride None
</Directory>
| Description: | Default charset parameter to be added when a response
content-type is text/plain or text/html |
|---|---|
| Syntax: | AddDefaultCharset On|Off|charset |
| Default: | AddDefaultCharset Off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
This directive specifies a default value for the media type
charset parameter (the name of a character encoding) to be added
to a response if and only if the response's content-type is either
text/plain or text/html. This should override
any charset specified in the body of the response via a META
element, though the exact behavior is often dependent on the user's client
configuration. A setting of AddDefaultCharset Off
disables this functionality. AddDefaultCharset On enables
a default charset of iso-8859-1. Any other value is assumed
to be the charset to be used, which should be one of the
IANA registered
charset values for use in Internet media types (MIME types).
For example:
AddDefaultCharset utf-8
AddDefaultCharset should only be used when all
of the text resources to which it applies are known to be in that
character encoding and it is too inconvenient to label their charset
individually. One such example is to add the charset parameter
to resources containing generated content, such as legacy CGI
scripts, that might be vulnerable to cross-site scripting attacks
due to user-provided data being included in the output. Note, however,
that a better solution is to just fix (or delete) those scripts, since
setting a default charset does not protect users that have enabled
the "auto-detect character encoding" feature on their browser.
| Description: | Determines whether encoded path separators in URLs are allowed to be passed through |
|---|---|
| Syntax: | AllowEncodedSlashes On|Off|NoDecode |
| Default: | AllowEncodedSlashes Off |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
| Compatibility: | NoDecode option available in 2.3.12 and later. |
The AllowEncodedSlashes directive allows URLs
which contain encoded path separators (%2F for /
and additionally %5C for \ on accordant systems)
to be used in the path info.
With the default value, Off, such URLs are refused
with a 404 (Not found) error.
With the value On, such URLs are accepted, and encoded
slashes are decoded like all other encoded characters.
With the value NoDecode, such URLs are accepted, but
encoded slashes are not decoded but left in their encoded state.
Turning AllowEncodedSlashes On is
mostly useful when used in conjunction with PATH_INFO.
If encoded slashes are needed in path info, use of NoDecode is
strongly recommended as a security measure. Allowing slashes
to be decoded could potentially allow unsafe paths.
| Description: | Types of directives that are allowed in
.htaccess files |
|---|---|
| Syntax: | AllowOverride All|None|directive-type
[directive-type] ... |
| Default: | AllowOverride None (2.3.9 and later), AllowOverride All (2.3.8 and earlier) |
| Context: | directory |
| Status: | Core |
| Module: | core |
When the server finds an .htaccess file (as
specified by AccessFileName),
it needs to know which directives declared in that file can override
earlier configuration directives.
AllowOverride is valid only in
<Directory>
sections specified without regular expressions, not in <Location>, <DirectoryMatch> or
<Files> sections.
When this directive is set to None and AllowOverrideList is set to
None, .htaccess files are
completely ignored. In this case, the server will not even attempt
to read .htaccess files in the filesystem.
When this directive is set to All, then any
directive which has the .htaccess Context is allowed in
.htaccess files.
The directive-type can be one of the following groupings of directives. (See the override class index for an up-to-date listing of which directives are enabled by each directive-type.)
AuthDBMGroupFile,
AuthDBMUserFile,
AuthGroupFile,
AuthName,
AuthType, AuthUserFile, Require, etc.).ErrorDocument,
ForceType,
LanguagePriority,
SetHandler,
SetInputFilter,
SetOutputFilter, and
mod_mime Add* and Remove* directives),
document meta data (Header, RequestHeader, SetEnvIf, SetEnvIfNoCase, BrowserMatch, CookieExpires, CookieDomain, CookieStyle, CookieTracking, CookieName),
mod_rewrite directives (RewriteEngine, RewriteOptions, RewriteBase, RewriteCond, RewriteRule),
mod_alias directives (Redirect, RedirectTemp, RedirectPermanent, RedirectMatch), and
Action from
mod_actions.
AddDescription,
AddIcon, AddIconByEncoding,
AddIconByType,
DefaultIcon, DirectoryIndex, FancyIndexing, HeaderName, IndexIgnore, IndexOptions, ReadmeName,
etc.).Allow, Deny and Order).Note that a syntax error in a valid directive will still cause an internal server error.
Options and
XBitHack).
An equal sign may be given followed by a comma-separated list, without
spaces, of options that may be set using the Options command.
Even though the list of options that may be used in .htaccess files
can be limited with this directive, as long as any Options directive is allowed any
other inherited option can be disabled by using the non-relative
syntax. In other words, this mechanism cannot force a specific option
to remain set while allowing any others to be set.
AllowOverride Options=Indexes,MultiViews
Example:
AllowOverride AuthConfig Indexes
In the example above, all directives that are neither in the group
AuthConfig nor Indexes cause an internal
server error.
For security and performance reasons, do not set
AllowOverride to anything other than None
in your <Directory "/"> block. Instead, find (or
create) the <Directory> block that refers to the
directory where you're actually planning to place a
.htaccess file.
| Description: | Individual directives that are allowed in
.htaccess files |
|---|---|
| Syntax: | AllowOverrideList None|directive
[directive-type] ... |
| Default: | AllowOverrideList None |
| Context: | directory |
| Status: | Core |
| Module: | core |
When the server finds an .htaccess file (as
specified by AccessFileName),
it needs to know which directives declared in that file can override
earlier configuration directives.
AllowOverrideList is valid only in
<Directory>
sections specified without regular expressions, not in <Location>, <DirectoryMatch> or
<Files> sections.
When this directive is set to None and AllowOverride is set to None,
then .htaccess files are completely
ignored. In this case, the server will not even attempt to read
.htaccess files in the filesystem.
Example:
AllowOverride None AllowOverrideList Redirect RedirectMatch
In the example above, only the Redirect and
RedirectMatch directives are allowed. All others will
cause an internal server error.
Example:
AllowOverride AuthConfig AllowOverrideList CookieTracking CookieName
In the example above, AllowOverride
grants permission to the AuthConfig
directive grouping and AllowOverrideList grants
permission to only two directives from the FileInfo directive
grouping. All others will cause an internal server error.
| Description: | Technique for locating the interpreter for CGI scripts |
|---|---|
| Syntax: | CGIMapExtension cgi-path .extension |
| Context: | directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
| Compatibility: | NetWare only |
This directive is used to control how Apache httpd finds the
interpreter used to run CGI scripts. For example, setting
CGIMapExtension sys:\foo.nlm .foo will
cause all CGI script files with a .foo extension to
be passed to the FOO interpreter.
| Description: | Enables passing HTTP authorization headers to scripts as CGI variables |
|---|---|
| Syntax: | CGIPassAuth On|Off |
| Default: | CGIPassAuth Off |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in Apache HTTP Server 2.4.13 and later |
CGIPassAuth allows scripts access to HTTP
authorization headers such as Authorization, which is
required for scripts that implement HTTP Basic authentication.
Normally these HTTP headers are hidden from scripts. This is to disallow
scripts from seeing user ids and passwords used to access the server when
HTTP Basic authentication is enabled in the web server. This directive
should be used when scripts are allowed to implement HTTP Basic
authentication.
This directive can be used instead of the compile-time setting
SECURITY_HOLE_PASS_AUTHORIZATION which has been available
in previous versions of Apache HTTP Server.
The setting is respected by any modules which use
ap_add_common_vars(), such as mod_cgi,
mod_cgid, mod_proxy_fcgi,
mod_proxy_scgi, and so on. Notably, it affects
modules which don't handle the request in the usual sense but
still use this API; examples of this are mod_include
and mod_ext_filter. Third-party modules that don't
use ap_add_common_vars() may choose to respect the setting
as well.
| Description: | Controls how some CGI variables are set |
|---|---|
| Syntax: | CGIVar variable rule |
| Context: | directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in Apache HTTP Server 2.4.21 and later |
This directive controls how some CGI variables are set.
REQUEST_URI rules:
original-uri (default)current-uri| Description: | Enables the generation of Content-MD5 HTTP Response
headers |
|---|---|
| Syntax: | ContentDigest On|Off |
| Default: | ContentDigest Off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Core |
| Module: | core |
This directive enables the generation of
Content-MD5 headers as defined in RFC1864
respectively RFC2616.
MD5 is an algorithm for computing a "message digest" (sometimes called "fingerprint") of arbitrary-length data, with a high degree of confidence that any alterations in the data will be reflected in alterations in the message digest.
The Content-MD5 header provides an end-to-end
message integrity check (MIC) of the entity-body. A proxy or
client may check this header for detecting accidental
modification of the entity-body in transit. Example header:
Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
Note that this can cause performance problems on your server since the message digest is computed on every request (the values are not cached).
Content-MD5 is only sent for documents served
by the core, and not by any module. For example,
SSI documents, output from CGI scripts, and byte range responses
do not have this header.
| Description: | Base directory for the server run-time files |
|---|---|
| Syntax: | DefaultRuntimeDir directory-path |
| Default: | DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/) |
| Context: | server config |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in Apache 2.4.2 and later |
The DefaultRuntimeDir directive sets the
directory in which the server will create various run-time files
(shared memory, locks, etc.). If set as a relative path, the full path
will be relative to ServerRoot.
Example
DefaultRuntimeDir scratch/
The default location of DefaultRuntimeDir may be
modified by changing the DEFAULT_REL_RUNTIMEDIR #define
at build time.
Note: ServerRoot should be specified before this
directive is used. Otherwise, the default value of ServerRoot
would be used to set the base directory.
ServerRoot| Description: | This directive has no effect other than to emit warnings
if the value is not none. In prior versions, DefaultType
would specify a default media type to assign to response content for
which no other media type configuration could be found.
|
|---|---|
| Syntax: | DefaultType media-type|none |
| Default: | DefaultType none |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
| Compatibility: | The argument none is available in Apache httpd 2.2.7 and later. All other choices are DISABLED for 2.3.x and later. |
This directive has been disabled. For backwards compatibility
of configuration files, it may be specified with the value
none, meaning no default media type. For example:
DefaultType None
DefaultType None is only available in
httpd-2.2.7 and later.
Use the mime.types configuration file and the
AddType to configure media
type assignments via file extensions, or the
ForceType directive to configure
the media type for specific resources. Otherwise, the server will
send the response without a Content-Type header field and the
recipient may attempt to guess the media type.
| Description: | Define a variable |
|---|---|
| Syntax: | Define parameter-name [parameter-value] |
| Context: | server config, virtual host, directory |
| Status: | Core |
| Module: | core |
In its one parameter form, Define is
equivalent to passing the -D argument to
httpd. It can be used to toggle the use of
<IfDefine>
sections without needing to alter -D arguments in any
startup scripts.
In addition to that, if the second parameter is given, a config variable
is set to this value. The variable can be used in the configuration using
the ${VAR} syntax. The variable is always globally defined
and not limited to the scope of the surrounding config section.
<IfDefine TEST>
Define servername test.example.com
</IfDefine>
<IfDefine !TEST>
Define servername www.example.com
Define SSL
</IfDefine>
DocumentRoot "/var/www/${servername}/htdocs"
Variable names may not contain colon ":" characters, to avoid clashes
with RewriteMap's syntax.
While this directive is supported in virtual host context, the changes it makes are visible to any later configuration directives, beyond any enclosing virtual host.
| Description: | Enclose a group of directives that apply only to the named file-system directory, sub-directories, and their contents. |
|---|---|
| Syntax: | <Directory directory-path>
... </Directory> |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
<Directory> and
</Directory> are used to enclose a group of
directives that will apply only to the named directory,
sub-directories of that directory, and the files within the respective
directories. Any directive that is allowed
in a directory context may be used. Directory-path is
either the full path to a directory, or a wild-card string using
Unix shell-style matching. In a wild-card string, ? matches
any single character, and * matches any sequences of
characters. You may also use [] character ranges. None
of the wildcards match a `/' character, so <Directory
"/*/public_html"> will not match
/home/user/public_html, but <Directory
"/home/*/public_html"> will match. Example:
<Directory "/usr/local/httpd/htdocs"> Options Indexes FollowSymLinks </Directory>
Directory paths may be quoted, if you like, however, it must be quoted if the path contains spaces. This is because a space would otherwise indicate the end of an argument.
Be careful with the directory-path arguments:
They have to literally match the filesystem path which Apache httpd uses
to access the files. Directives applied to a particular
<Directory> will not apply to files accessed from
that same directory via a different path, such as via different symbolic
links.
Regular
expressions can also be used, with the addition of the
~ character. For example:
<Directory ~ "^/www/[0-9]{3}">
</Directory>
would match directories in /www/ that consisted of
three numbers.
If multiple (non-regular expression) <Directory> sections
match the directory (or one of its parents) containing a document,
then the directives are applied in the order of shortest match
first, interspersed with the directives from the .htaccess files. For example,
with
<Directory "/"> AllowOverride None </Directory> <Directory "/home"> AllowOverride FileInfo </Directory>
for access to the document /home/web/dir/doc.html
the steps are:
AllowOverride None
(disabling .htaccess files).AllowOverride FileInfo (for
directory /home).FileInfo directives in
/home/.htaccess, /home/web/.htaccess and
/home/web/dir/.htaccess in that order.Regular expressions are not considered until after all of the normal sections have been applied. Then all of the regular expressions are tested in the order they appeared in the configuration file. For example, with
<Directory ~ "abc$"> # ... directives here ... </Directory>
the regular expression section won't be considered until after
all normal <Directory>s and
.htaccess files have been applied. Then the regular
expression will match on /home/abc/public_html/abc and
the corresponding <Directory> will
be applied.
Note that the default access for
<Directory "/"> is to permit all access.
This means that Apache httpd will serve any file mapped from an URL. It is
recommended that you change this with a block such
as
<Directory "/"> Require all denied </Directory>
and then override this for directories you want accessible. See the Security Tips page for more details.
The directory sections occur in the httpd.conf file.
<Directory> directives
cannot nest, and cannot appear in a <Limit> or <LimitExcept> section.
| Description: | Enclose directives that apply to the contents of file-system directories matching a regular expression. |
|---|---|
| Syntax: | <DirectoryMatch regex>
... </DirectoryMatch> |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
<DirectoryMatch> and
</DirectoryMatch> are used to enclose a group
of directives which will apply only to the named directory (and the files within),
the same as <Directory>.
However, it takes as an argument a
regular expression. For example:
<DirectoryMatch "^/www/(.+/)?[0-9]{3}/">
# ...
</DirectoryMatch>
matches directories in /www/ (or any subdirectory thereof)
that consist of three numbers.
<Directory>) and
could not match the end of line symbol ($). In 2.3.9 and later,
only directories that match the expression are affected by the enclosed
directives.
From 2.4.8 onwards, named groups and backreferences are captured and
written to the environment with the corresponding name prefixed with
"MATCH_" and in upper case. This allows elements of paths to be referenced
from within expressions and modules like
mod_rewrite. In order to prevent confusion, numbered
(unnamed) backreferences are ignored. Use named groups instead.
<DirectoryMatch "^/var/www/combined/(?<sitename>[^/]+)">
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</DirectoryMatch>
<Directory> for
a description of how regular expressions are mixed in with normal
<Directory>s| Description: | Directory that forms the main document tree visible from the web |
|---|---|
| Syntax: | DocumentRoot directory-path |
| Default: | DocumentRoot "/usr/local/apache/htdocs" |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
This directive sets the directory from which httpd
will serve files. Unless matched by a directive like Alias, the server appends the
path from the requested URL to the document root to make the
path to the document. Example:
DocumentRoot "/usr/web"
then an access to
http://my.example.com/index.html refers to
/usr/web/index.html. If the directory-path is
not absolute then it is assumed to be relative to the ServerRoot.
The DocumentRoot should be specified without
a trailing slash.
| Description: | Contains directives that apply only if the condition of a
previous <If> or
<ElseIf> section is not
satisfied by a request at runtime |
|---|---|
| Syntax: | <Else> ... </Else> |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
| Compatibility: | Nested conditions are evaluated in 2.4.26 and later |
The <Else> applies the enclosed
directives if and only if the most recent
<If> or
<ElseIf> section
in the same scope has not been applied.
For example: In
<If "-z req('Host')">
# ...
</If>
<Else>
# ...
</Else>
The <If> would match HTTP/1.0
requests without a Host: header and the
<Else> would match requests
with a Host: header.
<If><ElseIf><If>,
<ElseIf>, and
<Else> are applied last.| Description: | Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
<If> or
<ElseIf> section is not
satisfied |
|---|---|
| Syntax: | <ElseIf expression> ... </ElseIf> |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
| Compatibility: | Nested conditions are evaluated in 2.4.26 and later |
The <ElseIf> applies the enclosed
directives if and only if both the given condition evaluates to true and
the most recent <If> or
<ElseIf> section in the same scope has
not been applied. For example: In
<If "-R '10.1.0.0/16'"> #... </If> <ElseIf "-R '10.0.0.0/8'"> #... </ElseIf> <Else> #... </Else>
The <ElseIf> would match if
the remote address of a request belongs to the subnet 10.0.0.0/8 but
not to the subnet 10.1.0.0/16.
<If><Else><If>,
<ElseIf>, and
<Else> are applied last.| Description: | Use memory-mapping to read files during delivery |
|---|---|
| Syntax: | EnableMMAP On|Off |
| Default: | EnableMMAP On |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
This directive controls whether the httpd may use
memory-mapping if it needs to read the contents of a file during
delivery. By default, when the handling of a request requires
access to the data within a file -- for example, when delivering a
server-parsed file using mod_include -- Apache httpd
memory-maps the file if the OS supports it.
This memory-mapping sometimes yields a performance improvement. But in some environments, it is better to disable the memory-mapping to prevent operational problems:
httpd.httpd
has it memory-mapped can cause httpd to
crash with a segmentation fault.
For server configurations that are vulnerable to these problems, you should disable memory-mapping of delivered files by specifying:
EnableMMAP Off
For NFS mounted files, this feature may be disabled explicitly for the offending files by specifying:
<Directory "/path-to-nfs-files"> EnableMMAP Off </Directory>
| Description: | Use the kernel sendfile support to deliver files to the client |
|---|---|
| Syntax: | EnableSendfile On|Off |
| Default: | EnableSendfile Off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
| Compatibility: | Default changed to Off in version 2.3.9. |
This directive controls whether httpd may use the
sendfile support from the kernel to transmit file contents to the client.
By default, when the handling of a request requires no access
to the data within a file -- for example, when delivering a
static file -- Apache httpd uses sendfile to deliver the file contents
without ever reading the file if the OS supports it.
This sendfile mechanism avoids separate read and send operations, and buffer allocations. But on some platforms or within some filesystems, it is better to disable this feature to avoid operational problems:
sendfile may be unable to handle
files over 2GB in size.DocumentRoot (e.g., NFS, SMB, CIFS, FUSE),
the kernel may be unable to serve the network file through
its own cache.For server configurations that are not vulnerable to these problems, you may enable this feature by specifying:
EnableSendfile On
For network mounted files, this feature may be disabled explicitly for the offending files by specifying:
<Directory "/path-to-nfs-files"> EnableSendfile Off </Directory>
Please note that the per-directory and .htaccess configuration
of EnableSendfile is not supported by
mod_cache_disk.
Only global definition of EnableSendfile
is taken into account by the module.
| Description: | Abort configuration parsing with a custom error message |
|---|---|
| Syntax: | Error message |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Core |
| Module: | core |
| Compatibility: | 2.3.9 and later |
If an error can be detected within the configuration, this directive can be used to generate a custom error message, and halt configuration parsing. The typical use is for reporting required modules which are missing from the configuration.
# Example # ensure that mod_include is loaded <IfModule !include_module> Error "mod_include is required by mod_foo. Load it with LoadModule." </IfModule> # ensure that exactly one of SSL,NOSSL is defined <IfDefine SSL> <IfDefine NOSSL> Error "Both SSL and NOSSL are defined. Define only one of them." </IfDefine> </IfDefine> <IfDefine !SSL> <IfDefine !NOSSL> Error "Either SSL or NOSSL must be defined." </IfDefine> </IfDefine>
This directive is evaluated and configuration processing time,
not at runtime. As a result, this directive cannot be conditonally
evaluated by enclosing it in an <If> section.
| Description: | What the server will return to the client in case of an error |
|---|---|
| Syntax: | ErrorDocument error-code document |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
In the event of a problem or error, Apache httpd can be configured to do one of four things,
The first option is the default, while options 2-4 are
configured using the ErrorDocument
directive, which is followed by the HTTP response code and a URL
or a message. Apache httpd will sometimes offer additional information
regarding the problem/error.
From 2.4.13, expression syntax can be used inside the directive to produce dynamic strings and URLs.
URLs can begin with a slash (/) for local web-paths (relative
to the DocumentRoot), or be a
full URL which the client can resolve. Alternatively, a message
can be provided to be displayed by the browser. Note that deciding
whether the parameter is an URL, a path or a message is performed
before any expression is parsed. Examples:
ErrorDocument 500 http://example.com/cgi-bin/server-error.cgi
ErrorDocument 404 /errors/bad_urls.php
ErrorDocument 401 /subscription_info.html
ErrorDocument 403 "Sorry, can't allow you access today"
ErrorDocument 403 Forbidden!
ErrorDocument 403 /errors/forbidden.py?referrer=%{escape:%{HTTP_REFERER}}
Additionally, the special value default can be used
to specify Apache httpd's simple hardcoded message. While not required
under normal circumstances, default will restore
Apache httpd's simple hardcoded message for configurations that would
otherwise inherit an existing ErrorDocument.
ErrorDocument 404 /cgi-bin/bad_urls.pl <Directory "/web/docs"> ErrorDocument 404 default </Directory>
Note that when you specify an ErrorDocument
that points to a remote URL (ie. anything with a method such as
http in front of it), Apache HTTP Server will send a redirect to the
client to tell it where to find the document, even if the
document ends up being on the same server. This has several
implications, the most important being that the client will not
receive the original error status code, but instead will
receive a redirect status code. This in turn can confuse web
robots and other clients which try to determine if a URL is
valid using the status code. In addition, if you use a remote
URL in an ErrorDocument 401, the client will not
know to prompt the user for a password since it will not
receive the 401 status code. Therefore, if you use an
ErrorDocument 401 directive, then it must refer to a local
document.
Microsoft Internet Explorer (MSIE) will by default ignore server-generated error messages when they are "too small" and substitute its own "friendly" error messages. The size threshold varies depending on the type of error, but in general, if you make your error document greater than 512 bytes, then MSIE will show the server-generated error rather than masking it. More information is available in Microsoft Knowledge Base article Q294807.
Although most error messages can be overridden, there are certain
circumstances where the internal messages are used regardless of the
setting of ErrorDocument. In
particular, if a malformed request is detected, normal request processing
will be immediately halted and the internal error message returned.
This is necessary to guard against security problems caused by
bad requests.
If you are using mod_proxy, you may wish to enable
ProxyErrorOverride so that you can provide
custom error messages on behalf of your Origin servers. If you don't enable ProxyErrorOverride,
Apache httpd will not generate custom error documents for proxied content.
| Description: | Location where the server will log errors |
|---|---|
| Syntax: | ErrorLog file-path|syslog[:[facility][:tag]] |
| Default: | ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2) |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
The ErrorLog directive sets the name of
the file to which the server will log any errors it encounters. If
the file-path is not absolute then it is assumed to be
relative to the ServerRoot.
ErrorLog "/var/log/httpd/error_log"
If the file-path
begins with a pipe character "|" then it is assumed to be a
command to spawn to handle the error log.
ErrorLog "|/usr/local/bin/httpd_errors"
See the notes on piped logs for more information.
Using syslog instead of a filename enables logging
via syslogd(8) if the system supports it. The default is to use
syslog facility local7, but you can override this by
using the syslog:facility syntax where
facility can be one of the names usually documented in
syslog(1). The facility is effectively global, and if it is changed
in individual virtual hosts, the final facility specified affects the
entire server. Same rules apply for the syslog tag, which by default
uses the Apache binary name, httpd in most cases. You can
also override this by using the syslog::tag
syntax.
ErrorLog syslog:user ErrorLog syslog:user:httpd.srv1 ErrorLog syslog::httpd.srv2
SECURITY: See the security tips document for details on why your security could be compromised if the directory where log files are stored is writable by anyone other than the user that starts the server.
When entering a file path on non-Unix platforms, care should be taken to make sure that only forward slashes are used even though the platform may allow the use of back slashes. In general it is a good idea to always use forward slashes throughout the configuration files.
| Description: | Format specification for error log entries |
|---|---|
| Syntax: | ErrorLogFormat [connection|request] format |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
ErrorLogFormat allows to specify what
supplementary information is logged in the error log in addition to the
actual log message.
#Simple example ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"
Specifying connection or request as first
parameter allows to specify additional formats, causing additional
information to be logged when the first message is logged for a specific
connection or request, respectively. This additional information is only
logged once per connection/request. If a connection or request is processed
without causing any log message, the additional information is not logged
either.
It can happen that some format string items do not produce output. For
example, the Referer header is only present if the log message is
associated to a request and the log message happens at a time when the
Referer header has already been read from the client. If no output is
produced, the default behavior is to delete everything from the preceding
space character to the next space character. This means the log line is
implicitly divided into fields on non-whitespace to whitespace transitions.
If a format string item does not produce output, the whole field is
omitted. For example, if the remote address %a in the log
format [%t] [%l] [%a] %M is not available, the surrounding
brackets are not logged either. Space characters can be escaped with a
backslash to prevent them from delimiting a field. The combination '% '
(percent space) is a zero-width field delimiter that does not produce any
output.
The above behavior can be changed by adding modifiers to the format
string item. A - (minus) modifier causes a minus to be logged if the
respective item does not produce any output. In once-per-connection/request
formats, it is also possible to use the + (plus) modifier. If an
item with the plus modifier does not produce any output, the whole line is
omitted.
A number as modifier can be used to assign a log severity level to a format item. The item will only be logged if the severity of the log message is not higher than the specified log severity level. The number can range from 1 (alert) over 4 (warn) and 7 (debug) to 15 (trace8).
For example, here's what would happen if you added modifiers to
the %{Referer}i token, which logs the
Referer request header.
| Modified Token | Meaning |
|---|---|
%-{Referer}i |
Logs a - if Referer is not set. |
%+{Referer}i |
Omits the entire line if Referer is not set. |
%4{Referer}i |
Logs the Referer only if the log message severity
is higher than 4. |
Some format string items accept additional parameters in braces.
| Format String | Description |
|---|---|
%% |
The percent sign |
%a |
Client IP address and port of the request |
%{c}a |
Underlying peer IP address and port of the connection (see the
mod_remoteip module) |
%A |
Local IP-address and port |
%{name}e |
Request environment variable name |
%E |
APR/OS error status code and string |
%F |
Source file name and line number of the log call |
%{name}i |
Request header name |
%k |
Number of keep-alive requests on this connection |
%l |
Loglevel of the message |
%L |
Log ID of the request |
%{c}L |
Log ID of the connection |
%{C}L |
Log ID of the connection if used in connection scope, empty otherwise |
%m |
Name of the module logging the message |
%M |
The actual log message |
%{name}n |
Request note name |
%P |
Process ID of current process |
%T |
Thread ID of current thread |
%{g}T |
System unique thread ID of current thread (the same ID as
displayed by e.g. top; currently Linux only) |
%t |
The current time |
%{u}t |
The current time including micro-seconds |
%{cu}t |
The current time in ISO 8601 extended format (compact), including micro-seconds |
%{cuz}t |
The current time in ISO 8601 extended format (compact), including micro-seconds and time zone in the ISO 8601:2000 standard format. Available since 2.4.58 only |
%{%-format}t |
The current time formatted per the strftime(3) function.
Available since 2.4.58 only |
%v |
The canonical ServerName
of the current server. |
%V |
The server name of the server serving the request according to the
UseCanonicalName
setting. |
\ (backslash space) |
Non-field delimiting space |
% (percent space) |
Field delimiter (no output) |
The log ID format %L produces a unique id for a connection
or request. This can be used to correlate which log lines belong to the
same connection or request, which request happens on which connection.
A %L format string is also available in
mod_log_config to allow to correlate access log entries
with error log lines. If mod_unique_id is loaded, its
unique id will be used as log ID for requests.
#Example (default format for threaded MPMs)
ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"
This would result in error messages such as:
[Thu May 12 08:28:57.652118 2011] [core:error] [pid 8777:tid 4326490112] [client ::1:58619] File does not exist: /usr/local/apache2/htdocs/favicon.ico
Notice that, as discussed above, some fields are omitted entirely because they are not defined.
#Example (similar to the 2.2.x format)
ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"
#Advanced example with request/connection log IDs
ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"
ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"
ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"
ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"
ErrorLogFormat connection "[%{uc}t] [C:%{c}L] remote\ %a local\ %A"
| Description: | Keep track of extended status information for each request |
|---|---|
| Syntax: | ExtendedStatus On|Off |
| Default: | ExtendedStatus Off[*] |
| Context: | server config |
| Status: | Core |
| Module: | core |
This option tracks additional data per worker about the
currently executing request and creates a utilization summary.
You can see these variables during runtime by configuring
mod_status. Note that other modules may
rely on this scoreboard.
This setting applies to the entire server and cannot be enabled or disabled on a virtualhost-by-virtualhost basis. The collection of extended status information can slow down the server. Also note that this setting cannot be changed during a graceful restart.
Note that loading mod_status will change
the default behavior to ExtendedStatus On, while other
third party modules may do the same. Such modules rely on
collecting detailed information about the state of all workers.
The default is changed by mod_status beginning
with version 2.3.6. The previous default was always Off.
| Description: | File attributes used to create the ETag HTTP response header for static files |
|---|---|
| Syntax: | FileETag component ... |
| Default: | FileETag MTime Size |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
| Compatibility: | The default used to be "INode MTime Size" in 2.3.14 and earlier. |
The FileETag directive configures the file
attributes that are used to create the ETag (entity
tag) response header field when the document is based on a static file.
(The ETag value is used in cache management to save
network bandwidth.) The
FileETag directive allows you to choose
which of these -- if any -- should be used. The recognized keywords are:
FileETag INode MTime Size
ETag field will be
calculated by taking the digest over the file.ETag field will be
included in the responseThe INode, MTime, Size and
Digest keywords may be prefixed with either +
or -, which allow changes to be made to the default setting
inherited from a broader scope. Any keyword appearing without such a prefix
immediately and completely cancels the inherited setting.
If a directory's configuration includes
FileETag INode MTime Size, and a
subdirectory's includes FileETag -INode,
the setting for that subdirectory (which will be inherited by
any sub-subdirectories that don't override it) will be equivalent to
FileETag MTime Size.
mod_include
since the response entity can change without a change of the INode, MTime,
Size or Digest of the static file with embedded SSI directives.
| Description: | Contains directives that apply to matched filenames |
|---|---|
| Syntax: | <Files filename> ... </Files> |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
The <Files> directive
limits the scope of the enclosed directives by filename. It is comparable
to the <Directory>
and <Location>
directives. It should be matched with a </Files>
directive. The directives given within this section will be applied to
any object with a basename (last component of filename) matching the
specified filename. <Files>
sections are processed in the order they appear in the
configuration file, after the <Directory> sections and
.htaccess files are read, but before <Location> sections. Note
that <Files> can be nested
inside <Directory> sections to restrict the
portion of the filesystem they apply to.
The filename argument should include a filename, or
a wild-card string, where ? matches any single character,
and * matches any sequences of characters.
<Files "cat.html">
# Insert stuff that applies to cat.html here
</Files>
<Files "?at.*">
# This would apply to cat.html, bat.html, hat.php and so on.
</Files>
Regular expressions
can also be used, with the addition of the
~ character. For example:
<Files ~ "\.(gif|jpe?g|png)$">
#...
</Files>
would match most common Internet graphics formats. <FilesMatch> is preferred,
however.
Note that unlike <Directory> and <Location> sections, <Files> sections can be used inside
.htaccess files. This allows users to control access to
their own files, at a file-by-file level.
| Description: | Contains directives that apply to regular-expression matched filenames |
|---|---|
| Syntax: | <FilesMatch regex> ... </FilesMatch> |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
The <FilesMatch> directive
limits the scope of the enclosed directives by filename, just as the
<Files> directive
does. However, it accepts a regular
expression. For example:
<FilesMatch ".+\.(gif|jpe?g|png)$">
# ...
</FilesMatch>
would match most common Internet graphics formats.
.+ at the start of the regex ensures that
files named .png, or .gif, for example,
are not matched.From 2.4.8 onwards, named groups and backreferences are captured and
written to the environment with the corresponding name prefixed with
"MATCH_" and in upper case. This allows elements of files to be referenced
from within expressions and modules like
mod_rewrite. In order to prevent confusion, numbered
(unnamed) backreferences are ignored. Use named groups instead.
<FilesMatch "^(?<sitename>[^/]+)">
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</FilesMatch>
| Description: | Maximum number of pipelined responses above which they are flushed to the network |
|---|---|
| Syntax: | FlushMaxPipelined number |
| Default: | FlushMaxPipelined 5 |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
| Compatibility: | 2.4.47 and later |
This directive allows to configure the maximum number of pipelined responses, which remain pending so long as pipelined request are received. When the limit is reached, responses are forcibly flushed to the network in blocking mode, until passing under the limit again.
FlushMaxPipelined helps constraining memory
usage. When set to 0 pipelining is disabled, when set to
-1 there is no limit (FlushMaxThreshold
still applies).
| Description: | Threshold above which pending data are flushed to the network |
|---|---|
| Syntax: | FlushMaxThreshold number-of-bytes |
| Default: | FlushMaxThreshold 65535 |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
| Compatibility: | 2.4.47 and later |
This directive allows to configure the threshold for pending output data (in bytes). When the limit is reached, data are forcibly flushed to the network in blocking mode, until passing under the limit again.
FlushMaxThreshold helps constraining memory
usage. When set to 0 or a too small value there are actually
no pending data, but for threaded MPMs there can be more threads busy
waiting for the network thus less ones available to handle the other
simultaneous connections.
| Description: | Forces all matching files to be served with the specified media type in the HTTP Content-Type header field |
|---|---|
| Syntax: | ForceType media-type|None |
| Context: | directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
When placed into an .htaccess file or a
<Directory>, or
<Location> or
<Files>
section, this directive forces all matching files to be served
with the content type identification given by
media-type. For example, if you had a directory full of
GIF files, but did not want to label them all with .gif,
you might want to use:
ForceType image/gif
Note that this directive overrides other indirect media type
associations defined in mime.types or via the
AddType.
You can also override more general
ForceType settings
by using the value of None:
# force all files to be image/gif: <Location "/images"> ForceType image/gif </Location> # but normal mime-type associations here: <Location "/images/mixed"> ForceType None </Location>
This directive primarily overrides the content types generated for static files served out of the filesystem. For resources other than static files, where the generator of the response typically specifies a Content-Type, this directive has no effect.
When explicit directives such as
SetHandler or
AddHandler do not apply
to the current request, the internal handler name normally set by those
directives is set to match the content type specified by this directive.
This is a historical behavior that some third-party modules
(such as mod_php) may use "magic" content types used only to signal the
module to take responsibility for the matching request. Configurations
that rely on such "magic" types should be avoided by the use of
SetHandler or
AddHandler.
| Description: | Directory to write gmon.out profiling data to. |
|---|---|
| Syntax: | GprofDir /tmp/gprof/|/tmp/gprof/% |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
When the server has been compiled with gprof profiling support,
GprofDir causes gmon.out files to
be written to the specified directory when the process exits. If the
argument ends with a percent symbol ('%'), subdirectories are created
for each process id.
This directive currently only works with the prefork
MPM.
| Description: | Enables DNS lookups on client IP addresses |
|---|---|
| Syntax: | HostnameLookups On|Off|Double |
| Default: | HostnameLookups Off |
| Context: | server config, virtual host, directory |
| Status: | Core |
| Module: | core |
This directive enables DNS lookups so that host names can be
logged (and passed to CGIs/SSIs in REMOTE_HOST).
The value Double refers to doing double-reverse
DNS lookup. That is, after a reverse lookup is performed, a forward
lookup is then performed on that result. At least one of the IP
addresses in the forward lookup must match the original
address. (In "tcpwrappers" terminology this is called
PARANOID.)
Regardless of the setting, when mod_authz_host is
used for controlling access by hostname, a double reverse lookup
will be performed. This is necessary for security. Note that the
result of this double-reverse isn't generally available unless you
set HostnameLookups Double. For example, if only
HostnameLookups On and a request is made to an object
that is protected by hostname restrictions, regardless of whether
the double-reverse fails or not, CGIs will still be passed the
single-reverse result in REMOTE_HOST.
The default is Off in order to save the network
traffic for those sites that don't truly need the reverse
lookups done. It is also better for the end users because they
don't have to suffer the extra latency that a lookup entails.
Heavily loaded sites should leave this directive
Off, since DNS lookups can take considerable
amounts of time. The utility logresolve, compiled by
default to the bin subdirectory of your installation
directory, can be used to look up host names from logged IP addresses
offline.
Finally, if you have hostname-based Require
directives, a hostname lookup will be performed regardless of
the setting of HostnameLookups.
| Description: | Modify restrictions on HTTP Request Messages |
|---|---|
| Syntax: | HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods]
[Allow0.9|Require1.0] |
| Default: | HttpProtocolOptions Strict LenientMethods Allow0.9 |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
| Compatibility: | 2.2.32 or 2.4.24 and later |
This directive changes the rules applied to the HTTP Request Line
(RFC 7230 §3.1.1) and the HTTP Request Header Fields
(RFC 7230 §3.2), which are now applied by default or using
the Strict option. Due to legacy modules, applications or
custom user-agents which must be deprecated the Unsafe
option has been added to revert to the legacy behaviors.
These rules are applied prior to request processing, so must be configured at the global or default (first) matching virtual host section, by IP/port interface (and not by name) to be honored.
The directive accepts three parameters from the following list of choices, applying the default to the ones not specified:
Prior to the introduction of this directive, the Apache HTTP Server
request message parsers were tolerant of a number of forms of input
which did not conform to the protocol.
RFC 7230 §9.4 Request Splitting and
§9.5 Response Smuggling call out only two of the potential
risks of accepting non-conformant request messages, while
RFC 7230 §3.5 "Message Parsing Robustness" identify the
risks of accepting obscure whitespace and request message formatting.
As of the introduction of this directive, all grammar rules of the
specification are enforced in the default Strict operating
mode, and the strict whitespace suggested by section 3.5 is enforced
and cannot be relaxed.
Users are strongly cautioned against toggling the Unsafe
mode of operation, particularly on outward-facing, publicly accessible
server deployments. If an interface is required for faulty monitoring
or other custom service consumers running on an intranet, users should
toggle the Unsafe option only on a specific virtual host configured
to service their internal private network.
# Missing CRLF
GET / HTTP/1.0\n\n
Some tools need to be forced to use CRLF, otherwise httpd will return a HTTP 400 response like described in the above use case. For example, the OpenSSL s_client needs the -crlf parameter to work properly.
The DumpIOInput directive
can help while reviewing the HTTP request to identify issues like the
absence of CRLF.
RFC 7231 §4.1 "Request Methods" "Overview" requires that
origin servers shall respond with a HTTP 501 status code when an
unsupported method is encountered in the request line.
This already happens when the LenientMethods option is used,
but administrators may wish to toggle the RegisteredMethods
option and register any non-standard methods using the
RegisterHttpMethod
directive, particularly if the Unsafe
option has been toggled.
The RegisteredMethods option should not
be toggled for forward proxy hosts, as the methods supported by the
origin servers are unknown to the proxy server.
# Unknown HTTP method
WOW / HTTP/1.0\r\n\r\n
# Lowercase HTTP method
get / HTTP/1.0\r\n\r\n
RFC 2616 §19.6 "Compatibility With Previous Versions" had
encouraged HTTP servers to support legacy HTTP/0.9 requests. RFC 7230
supersedes this with "The expectation to support HTTP/0.9 requests has
been removed" and offers additional comments in
RFC 7230 Appendix A. The Require1.0 option allows
the user to remove support of the default Allow0.9 option's
behavior.
# Unsupported HTTP version
GET /\r\n\r\n
Reviewing the messages logged to the
ErrorLog, configured with
LogLevel debug level,
can help identify such faulty requests along with their origin.
Users should pay particular attention to the 400 responses in the access
log for invalid requests which were unexpectedly rejected.
| Description: | Contains directives that apply only if a condition is satisfied by a request at runtime |
|---|---|
| Syntax: | <If expression> ... </If> |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
| Compatibility: | Nested conditions are evaluated in 2.4.26 and later |
The <If> directive
evaluates an expression at runtime, and applies the enclosed
directives if and only if the expression evaluates to true.
For example:
<If "-z req('Host')">
would match HTTP/1.0 requests without a Host: header.
Expressions may contain various shell-like operators for string
comparison (==, !=, <, ...),
integer comparison (-eq, -ne, ...),
and others (-n, -z, -f, ...).
It is also possible to use regular expressions,
<If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/">
shell-like pattern matches and many other operations. These operations
can be done on request headers (req), environment variables
(env), and a large number of other properties. The full
documentation is available in Expressions in
Apache HTTP Server.
Only directives that support the directory context can be used within this configuration section.
CONTENT_TYPE and other
response headers, are set after <If> conditions have already
been evaluated, and so will not be available to use in this
directive.
Define, Include, and
Error cannot be made conditional by enclosing
them in an if <If> configuration
section. These sections are always part of the configuration,
regardless of how they evaluate at runtime.
<ElseIf><Else><If>,
<ElseIf>, and
<Else> are applied last.| Description: | Encloses directives that will be processed only if a test is true at startup |
|---|---|
| Syntax: | <IfDefine [!]parameter-name> ...
</IfDefine> |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
The <IfDefine test>...</IfDefine>
section is used to mark directives that are conditional. The
directives within an <IfDefine>
section are only processed if the test is true. If
test is false, everything between the start and end markers is
ignored.
The test in the <IfDefine> section directive can be one of two forms:
!parameter-nameIn the former case, the directives between the start and end markers are only processed if the parameter named parameter-name is defined. The second format reverses the test, and only processes the directives if parameter-name is not defined.
The parameter-name argument is a define as given on the
httpd command line via -Dparameter
at the time the server was started or by the Define directive.
<IfDefine> sections are
nest-able, which can be used to implement simple
multiple-parameter tests. Example:
httpd -DReverseProxy -DUseCache -DMemCache ...
<IfDefine ReverseProxy>
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
<IfDefine UseCache>
LoadModule cache_module modules/mod_cache.so
<IfDefine MemCache>
LoadModule mem_cache_module modules/mod_mem_cache.so
</IfDefine>
<IfDefine !MemCache>
LoadModule cache_disk_module modules/mod_cache_disk.so
</IfDefine>
</IfDefine>
</IfDefine>
| Description: | Encloses directives that are processed conditional on the presence or absence of a specific directive |
|---|---|
| Syntax: | <IfDirective [!]directive-name> ...
</IfDirective> |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in 2.4.34 and later. |
The <IfDirective test>...</IfDirective>
section is used to mark directives that are conditional on the presence of
a specific directive. The directives within an <IfDirective> section are only processed if the test
is true. If test is false, everything between the start and
end markers is ignored.
The test in the <IfDirective> section can be one of two forms:
In the former case, the directives between the start and end markers are only processed if a directive of the given name is available at the time of processing. The second format reverses the test, and only processes the directives if directive-name is not available.
httpd, regardless of whether a particular
directive is available. In normal operation, directives need not
be placed in <IfDirective>
sections.| Description: | Encloses directives that will be processed only if file exists at startup |
|---|---|
| Syntax: | <IfFile [!]filename> ...
</IfFile> |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in 2.4.34 and later. |
The <IfFile filename>...</IfFile>
section is used to mark directives that are conditional on
the existence of a file on disk. The directives within an
<IfFile> section are only
processed if filename exists. If filename
doesn't exist, everything between the start and end markers is
ignored. filename can be an absolute path or a path
relative to the server root.
The filename in the <IfFile> section directive can take the same forms as the
test variable in the <IfDefine> section, i.e. the test can be negated if the
! character is placed directly before filename.
If a relative filename is supplied, the check is
ServerRoot relative. In the case where
this directive occurs before the ServerRoot,
the path will be checked relative to the compiled-in server root or
the server root passed in on the command line via the -d
parameter.
| Description: | Encloses directives that are processed conditional on the presence or absence of a specific module |
|---|---|
| Syntax: | <IfModule [!]module-file|module-identifier> ...
</IfModule> |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
| Compatibility: | Module identifiers are available in version 2.1 and later. |
The <IfModule test>...</IfModule>
section is used to mark directives that are conditional on the presence of
a specific module. The directives within an <IfModule> section are only processed if the test
is true. If test is false, everything between the start and
end markers is ignored.
The test in the <IfModule> section directive can be one of two forms:
In the former case, the directives between the start and end
markers are only processed if the module named module
is included in Apache httpd -- either compiled in or
dynamically loaded using LoadModule. The second format reverses the test,
and only processes the directives if module is
not included.
The module argument can be either the module identifier or
the file name of the module, at the time it was compiled. For example,
rewrite_module is the identifier and
mod_rewrite.c is the file name. If a module consists of
several source files, use the name of the file containing the string
STANDARD20_MODULE_STUFF.
<IfModule> sections are
nest-able, which can be used to implement simple multiple-module
tests.
<IfModule>
sections.| Description: | Encloses directives that are processed conditional on the presence or absence of a specific section directive |
|---|---|
| Syntax: | <IfSection [!]section-name> ...
</IfSection> |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in 2.4.34 and later. |
The <IfSection
test>...</IfSection> section is used
to mark directives that are conditional on the presence of a
specific section directive. A section directive is any directive
such as <VirtualHost> which
encloses other directives, and has a directive name with a leading
"<".
The directives within an <IfSection> section are only processed if the test
is true. If test is false, everything between the start and
end markers is ignored.
The section-name must be specified without either
the leading "<" or closing ">". The test in the
<IfSection> section can be one
of two forms:
In the former case, the directives between the start and end markers are only processed if a section directive of the given name is available at the time of processing. The second format reverses the test, and only processes the directives if section-name is not an available section directive.
For example:
<IfSection VirtualHost> ... </IfSection>
httpd,
regardless of whether a particular section directive is
available. In normal operation, directives need not be placed in
<IfSection> sections.| Description: | Includes other configuration files from within the server configuration files |
|---|---|
| Syntax: | Include file-path|directory-path|wildcard |
| Context: | server config, virtual host, directory |
| Status: | Core |
| Module: | core |
| Compatibility: | Directory wildcard matching available in 2.3.6 and later |
This directive allows inclusion of other configuration files from within the server configuration files.
Shell-style (fnmatch()) wildcard characters can be used
in the filename or directory parts of the path to include several files
at once, in alphabetical order. In addition, if
Include points to a directory, rather than a file,
Apache httpd will read all files in that directory and any subdirectory.
However, including entire directories is not recommended, because it is
easy to accidentally leave temporary files in a directory that can cause
httpd to fail. Instead, we encourage you to use the
wildcard syntax shown below, to include files that match a particular
pattern, such as *.conf, for example.
The Include directive will
fail with an error if a wildcard expression does not
match any file. The IncludeOptional
directive can be used if non-matching wildcards should be ignored.
The file path specified may be an absolute path, or may be relative
to the ServerRoot directory.
Examples:
Include /usr/local/apache2/conf/ssl.conf Include /usr/local/apache2/conf/vhosts/*.conf
Or, providing paths relative to your ServerRoot directory:
Include conf/ssl.conf Include conf/vhosts/*.conf
Wildcards may be included in the directory or file portion of the path. This example will fail if there is no subdirectory in conf/vhosts that contains at least one *.conf file:
Include conf/vhosts/*/*.conf
Alternatively, the following command will just be ignored in case of missing files or directories:
IncludeOptional conf/vhosts/*/*.conf
| Description: | Includes other configuration files from within the server configuration files |
|---|---|
| Syntax: | IncludeOptional file-path|directory-path|wildcard |
| Context: | server config, virtual host, directory |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in 2.3.6 and later. Not existent file paths without wildcards do not cause SyntaxError after 2.4.30 |
This directive allows inclusion of other configuration files
from within the server configuration files. It works identically to the
Include directive, but it will be
silently ignored (instead of causing an error) if wildcards are used and
they do not match any file or directory or if a file path does not exist
on the file system.
| Description: | Enables HTTP persistent connections |
|---|---|
| Syntax: | KeepAlive On|Off |
| Default: | KeepAlive On |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
The Keep-Alive extension to HTTP/1.0 and the persistent
connection feature of HTTP/1.1 provide long-lived HTTP sessions
which allow multiple requests to be sent over the same TCP
connection. In some cases this has been shown to result in an
almost 50% speedup in latency times for HTML documents with
many images. To enable Keep-Alive connections, set
KeepAlive On.
For HTTP/1.0 clients, Keep-Alive connections will only be used if they are specifically requested by a client. In addition, a Keep-Alive connection with an HTTP/1.0 client can only be used when the length of the content is known in advance. This implies that dynamic content such as CGI output, SSI pages, and server-generated directory listings will generally not use Keep-Alive connections to HTTP/1.0 clients. For HTTP/1.1 clients, persistent connections are the default unless otherwise specified. If the client requests it, chunked encoding will be used in order to send content of unknown length over persistent connections.
When a client uses a Keep-Alive connection, it will be counted
as a single "request" for the MaxConnectionsPerChild directive, regardless
of how many requests are sent using the connection.
| Description: | Amount of time the server will wait for subsequent requests on a persistent connection |
|---|---|
| Syntax: | KeepAliveTimeout num[ms] |
| Default: | KeepAliveTimeout 5 |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
The number of seconds Apache httpd will wait for a subsequent
request before closing the connection. By adding a postfix of ms the
timeout can be also set in milliseconds. Once a request has been
received, the timeout value specified by the
Timeout directive applies.
Setting KeepAliveTimeout to a high value
may cause performance problems in heavily loaded servers. The
higher the timeout, the more server processes will be kept
occupied waiting on connections with idle clients.
If KeepAliveTimeout is not
set for a name-based virtual host, the value of the first defined
virtual host best matching the local IP and port will be used.
| Description: | Restrict enclosed access controls to only certain HTTP methods |
|---|---|
| Syntax: | <Limit method [method] ... > ...
</Limit> |
| Context: | directory, .htaccess |
| Override: | AuthConfig, Limit |
| Status: | Core |
| Module: | core |
Access controls are normally effective for
all access methods, and this is the usual
desired behavior. In the general case, access control
directives should not be placed within a
<Limit> section.
The purpose of the <Limit>
directive is to restrict the effect of the access controls to the
nominated HTTP methods. For all other methods, the access
restrictions that are enclosed in the <Limit> bracket will have no
effect. The following example applies the access control
only to the methods POST, PUT, and
DELETE, leaving all other methods unprotected:
<Limit POST PUT DELETE> Require valid-user </Limit>
The method names listed can be one or more of: GET,
POST, PUT, DELETE,
CONNECT, OPTIONS,
PATCH, PROPFIND, PROPPATCH,
MKCOL, COPY, MOVE,
LOCK, and UNLOCK. The method name is
case-sensitive. If GET is used, it will also
restrict HEAD requests. The TRACE method
cannot be limited (see TraceEnable).
<LimitExcept> section should always be
used in preference to a <Limit>
section when restricting access, since a <LimitExcept> section provides protection
against arbitrary methods.The <Limit> and
<LimitExcept>
directives may be nested. In this case, each successive level of
<Limit> or <LimitExcept> directives must
further restrict the set of methods to which access controls apply.
<Limit> or
<LimitExcept> directives with
the Require directive,
note that the first Require
to succeed authorizes the request, regardless of the presence of other
Require directives.For example, given the following configuration, all users will
be authorized for POST requests, and the
Require group editors directive will be ignored
in all cases:
<LimitExcept GET> Require valid-user </LimitExcept> <Limit POST> Require group editors </Limit>
| Description: | Restrict access controls to all HTTP methods except the named ones |
|---|---|
| Syntax: | <LimitExcept method [method] ... > ...
</LimitExcept> |
| Context: | directory, .htaccess |
| Override: | AuthConfig, Limit |
| Status: | Core |
| Module: | core |
<LimitExcept> and
</LimitExcept> are used to enclose
a group of access control directives which will then apply to any
HTTP access method not listed in the arguments;
i.e., it is the opposite of a <Limit> section and can be used to control
both standard and nonstandard/unrecognized methods. See the
documentation for <Limit> for more details.
For example:
<LimitExcept POST GET> Require valid-user </LimitExcept>
| Description: | Determine maximum number of internal redirects and nested subrequests |
|---|---|
| Syntax: | LimitInternalRecursion number [number] |
| Default: | LimitInternalRecursion 10 |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
An internal redirect happens, for example, when using the Action directive, which internally
redirects the original request to a CGI script. A subrequest is Apache httpd's
mechanism to find out what would happen for some URI if it were requested.
For example, mod_dir uses subrequests to look for the
files listed in the DirectoryIndex
directive.
LimitInternalRecursion prevents the server
from crashing when entering an infinite loop of internal redirects or
subrequests. Such loops are usually caused by misconfigurations.
The directive stores two different limits, which are evaluated on per-request basis. The first number is the maximum number of internal redirects that may follow each other. The second number determines how deeply subrequests may be nested. If you specify only one number, it will be assigned to both limits.
LimitInternalRecursion 5
| Description: | Restricts the total size of the HTTP request body sent from the client |
|---|---|
| Syntax: | LimitRequestBody bytes |
| Default: | LimitRequestBody 1073741824 |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
| Compatibility: | In Apache HTTP Server 2.4.53 and earlier, the default value was 0 (unlimited) |
This directive specifies the number of bytes that are allowed in a request body. A value of 0 means unlimited.
The LimitRequestBody directive allows
the user to set a limit on the allowed size of an HTTP request
message body within the context in which the directive is given
(server, per-directory, per-file or per-location). If the client
request exceeds that limit, the server will return an error
response instead of servicing the request. The size of a normal
request message body will vary greatly depending on the nature of
the resource and the methods allowed on that resource. CGI scripts
typically use the message body for retrieving form information.
Implementations of the PUT method will require
a value at least as large as any representation that the server
wishes to accept for that resource.
This directive gives the server administrator greater control over abnormal client request behavior, which may be useful for avoiding some forms of denial-of-service attacks.
If, for example, you are permitting file upload to a particular location and wish to limit the size of the uploaded file to 100K, you might use the following directive:
LimitRequestBody 102400
| Description: | Limits the number of HTTP request header fields that will be accepted from the client |
|---|---|
| Syntax: | LimitRequestFields number |
| Default: | LimitRequestFields 100 |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
Setting number at 0 means unlimited.
The default value is defined by the compile-time
constant DEFAULT_LIMIT_REQUEST_FIELDS (100 as
distributed).
The LimitRequestFields directive allows
the server administrator to modify the limit on the number of
request header fields allowed in an HTTP request. A server needs
this value to be larger than the number of fields that a normal
client request might include. The number of request header fields
used by a client rarely exceeds 20, but this may vary among
different client implementations, often depending upon the extent
to which a user has configured their browser to support detailed
content negotiation. Optional HTTP extensions are often expressed
using request header fields.
This directive gives the server administrator greater control over abnormal client request behavior, which may be useful for avoiding some forms of denial-of-service attacks. The value should be increased if normal clients see an error response from the server that indicates too many fields were sent in the request.
For example:
LimitRequestFields 50
When name-based virtual hosting is used, the value for this directive is taken from the default (first-listed) virtual host for the local IP and port combination.
| Description: | Limits the size of the HTTP request header allowed from the client |
|---|---|
| Syntax: | LimitRequestFieldSize bytes |
| Default: | LimitRequestFieldSize 8190 |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
This directive specifies the number of bytes that will be allowed in an HTTP request header.
The LimitRequestFieldSize directive
allows the server administrator to set the limit
on the allowed size of an HTTP request header field. A server
needs this value to be large enough to hold any one header field
from a normal client request. The size of a normal request header
field will vary greatly among different client implementations,
often depending upon the extent to which a user has configured
their browser to support detailed content negotiation. SPNEGO
authentication headers can be up to 12392 bytes.
This directive gives the server administrator greater control over abnormal client request behavior, which may be useful for avoiding some forms of denial-of-service attacks.
For example:
LimitRequestFieldSize 4094
When name-based virtual hosting is used, the value for this directive is taken from the default (first-listed) virtual host best matching the current IP address and port combination.
| Description: | Limit the size of the HTTP request line that will be accepted from the client |
|---|---|
| Syntax: | LimitRequestLine bytes |
| Default: | LimitRequestLine 8190 |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
This directive sets the number of bytes that will be allowed on the HTTP request-line.
The LimitRequestLine directive allows
the server administrator to set the limit on the allowed size
of a client's HTTP request-line. Since the request-line consists of the
HTTP method, URI, and protocol version, the
LimitRequestLine directive places a
restriction on the length of a request-URI allowed for a request
on the server. A server needs this value to be large enough to
hold any of its resource names, including any information that
might be passed in the query part of a GET request.
This directive gives the server administrator greater control over abnormal client request behavior, which may be useful for avoiding some forms of denial-of-service attacks.
For example:
LimitRequestLine 4094
When name-based virtual hosting is used, the value for this directive is taken from the default (first-listed) virtual host best matching the current IP address and port combination.
| Description: | Limits the size of an XML-based request body |
|---|---|
| Syntax: | LimitXMLRequestBody bytes |
| Default: | LimitXMLRequestBody 1000000 |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
Limit (in bytes) on the maximum size of an XML-based request
body. A value of 0 will apply a hard limit (depending on
32bit vs 64bit system) allowing for XML escaping within the bounds of
the system addressable memory, but it exists for compatibility only
and is not recommended since it does not account for memory consumed
elsewhere or concurrent requests, which might result in an overall
system out-of-memory.
Example:
# Limit of 1 MiB LimitXMLRequestBody 1048576
| Description: | Applies the enclosed directives only to matching URLs |
|---|---|
| Syntax: | <Location
URL-path|URL> ... </Location> |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
The <Location> directive
limits the scope of the enclosed directives by URL. It is similar to the
<Directory>
directive, and starts a subsection which is terminated with a
</Location> directive. <Location> sections are processed in the
order they appear in the configuration file, after the <Directory> sections and
.htaccess files are read, and after the <Files> sections.
<Location> sections operate
completely outside the filesystem. This has several consequences.
Most importantly, <Location>
directives should not be used to control access to filesystem
locations. Since several different URLs may map to the same
filesystem location, such access controls may by circumvented.
The enclosed directives will be applied to the request if the path component of the URL meets any of the following criteria:
In the example below, where no trailing slash is used, requests to /private1, /private1/ and /private1/file.txt will have the enclosed directives applied, but /private1other would not.
<Location "/private1">
# ...
</Location>
In the example below, where a trailing slash is used, requests to /private2/ and /private2/file.txt will have the enclosed directives applied, but /private2 and /private2other would not.
<Location "/private2/">
# ...
</Location>
<Location>Use <Location> to apply
directives to content that lives outside the filesystem. For
content that lives in the filesystem, use <Directory> and <Files>. An exception is
<Location "/">, which is an easy way to
apply a configuration to the entire server.
For all origin (non-proxy) requests, the URL to be matched is a
URL-path of the form /path/. No scheme, hostname,
port, or query string may be included. For proxy requests, the
URL to be matched is of the form
scheme://servername/path, and you must include the
prefix.
The URL may use wildcards. In a wild-card string, ? matches
any single character, and * matches any sequences of
characters. Neither wildcard character matches a / in the URL-path.
Regular expressions
can also be used, with the addition of the ~
character. For example:
<Location ~ "/(extra|special)/data">
#...
</Location>
would match URLs that contained the substring /extra/data
or /special/data. The directive <LocationMatch> behaves
identical to the regex version of <Location>, and is preferred, for the
simple reason that ~ is hard to distinguish from
- in many fonts.
The <Location>
functionality is especially useful when combined with the
SetHandler
directive. For example, to enable status requests but allow them
only from browsers at example.com, you might use:
<Location "/status"> SetHandler server-status Require host example.com </Location>
The slash character has special meaning depending on where in a
URL it appears. People may be used to its behavior in the filesystem
where multiple adjacent slashes are frequently collapsed to a single
slash (i.e., /home///foo is the same as
/home/foo). In URL-space this is not necessarily true if
directive MergeSlashes has been set
to "OFF".
The <LocationMatch>
directive and the regex version of <Location> require you to explicitly specify multiple
slashes if the slashes are not being merged.
For example, <LocationMatch "^/abc"> would match
the request URL /abc but not the request URL
//abc. The (non-regex) <Location> directive behaves similarly when used for
proxy requests. But when (non-regex) <Location> is used for non-proxy requests it will
implicitly match multiple slashes with a single slash. For example,
if you specify <Location "/abc/def"> and the
request is to /abc//def then it will match.
LocationMatch| Description: | Applies the enclosed directives only to regular-expression matching URLs |
|---|---|
| Syntax: | <LocationMatch
regex> ... </LocationMatch> |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
The <LocationMatch> directive
limits the scope of the enclosed directives by URL, in an identical manner
to <Location>. However,
it takes a regular expression
as an argument instead of a simple string. For example:
<LocationMatch "/(extra|special)/data">
# ...
</LocationMatch>
would match URLs that contained the substring /extra/data
or /special/data.
If the intent is that a URL starts with
/extra/data, rather than merely
contains /extra/data, prefix the
regular expression with a ^ to require this.
<LocationMatch "^/(extra|special)/data">
From 2.4.8 onwards, named groups and backreferences are captured and
written to the environment with the corresponding name prefixed with
"MATCH_" and in upper case. This allows elements of URLs to be referenced
from within expressions and modules like
mod_rewrite. In order to prevent confusion, numbered
(unnamed) backreferences are ignored. Use named groups instead.
<LocationMatch "^/combined/(?<sitename>[^/]+)">
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</LocationMatch>
The slash character has special meaning depending on where in a
URL it appears. People may be used to its behavior in the filesystem
where multiple adjacent slashes are frequently collapsed to a single
slash (i.e., /home///foo is the same as
/home/foo). In URL-space this is not necessarily true if
directive MergeSlashes has been set
to "OFF".
The <LocationMatch>
directive and the regex version of <Location> require you to explicitly specify multiple
slashes if the slashes are not being merged.
For example, <LocationMatch "^/abc"> would match
the request URL /abc but not the request URL
//abc. The (non-regex) <Location> directive behaves similarly when used for
proxy requests. But when (non-regex) <Location> is used for non-proxy requests it will
implicitly match multiple slashes with a single slash. For example,
if you specify <Location "/abc/def"> and the
request is to /abc//def then it will match.
| Description: | Controls the verbosity of the ErrorLog |
|---|---|
| Syntax: | LogLevel [module:]level
[module:level] ...
|
| Default: | LogLevel warn |
| Context: | server config, virtual host, directory |
| Status: | Core |
| Module: | core |
| Compatibility: | Per-module and per-directory configuration is available in Apache HTTP Server 2.3.6 and later |
LogLevel adjusts the verbosity of the
messages recorded in the error logs (see ErrorLog directive). The following
levels are available, in order of decreasing
significance:
| Level | Description | Example |
|---|---|---|
emerg |
Emergencies - system is unusable. | "Child cannot open lock file. Exiting" |
alert |
Action must be taken immediately. | "getpwuid: couldn't determine user name from uid" |
crit |
Critical Conditions. | "socket: Failed to get a socket, exiting child" |
error |
Error conditions. | "Premature end of script headers" |
warn |
Warning conditions. | "child process 1234 did not exit, sending another SIGHUP" |
notice |
Normal but significant condition. | "httpd: caught SIGBUS, attempting to dump core in ..." |
info |
Informational. | "Server seems busy, (you may need to increase StartServers, or Min/MaxSpareServers)..." |
debug |
Debug-level messages | "Opening config file ..." |
trace1 |
Trace messages | "proxy: FTP: control connection complete" |
trace2 |
Trace messages | "proxy: CONNECT: sending the CONNECT request to the remote proxy" |
trace3 |
Trace messages | "openssl: Handshake: start" |
trace4 |
Trace messages | "read from buffered SSL brigade, mode 0, 17 bytes" |
trace5 |
Trace messages | "map lookup FAILED: map=rewritemap key=keyname" |
trace6 |
Trace messages | "cache lookup FAILED, forcing new map lookup" |
trace7 |
Trace messages, dumping large amounts of data | "| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |" |
trace8 |
Trace messages, dumping large amounts of data | "| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |" |
When a particular level is specified, messages from all
other levels of higher significance will be reported as well.
E.g., when LogLevel info is specified,
then messages with log levels of notice and
warn will also be posted.
Using a level of at least crit is
recommended.
For example:
LogLevel notice
When logging to a regular file, messages of the level
notice cannot be suppressed and thus are always
logged. However, this doesn't apply when logging is done
using syslog.
Specifying a level without a module name will reset the level
for all modules to that level. Specifying a level with a module
name will set the level for that module only. It is possible to
use the module source file name, the module identifier, or the
module identifier with the trailing _module omitted
as module specification. This means the following three specifications
are equivalent:
LogLevel info ssl:warn LogLevel info mod_ssl.c:warn LogLevel info ssl_module:warn
It is also possible to change the level per directory:
LogLevel info <Directory "/usr/local/apache/htdocs/app"> LogLevel debug </Directory>
| Description: | Number of requests allowed on a persistent connection |
|---|---|
| Syntax: | MaxKeepAliveRequests number |
| Default: | MaxKeepAliveRequests 100 |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
The MaxKeepAliveRequests directive
limits the number of requests allowed per connection when
KeepAlive is on. If it is
set to 0, unlimited requests will be allowed. We
recommend that this setting be kept to a high value for maximum
server performance.
For example:
MaxKeepAliveRequests 500
| Description: | Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete
resource |
|---|---|
| Syntax: | MaxRangeOverlaps default | unlimited | none | number-of-ranges |
| Default: | MaxRangeOverlaps 20 |
| Context: | server config, virtual host, directory |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in Apache HTTP Server 2.3.15 and later |
The MaxRangeOverlaps directive
limits the number of overlapping HTTP ranges the server is willing to
return to the client. If more overlapping ranges than permitted are requested,
the complete resource is returned instead.
| Description: | Number of range reversals (eg: 100-200,50-70) allowed before returning the complete
resource |
|---|---|
| Syntax: | MaxRangeReversals default | unlimited | none | number-of-ranges |
| Default: | MaxRangeReversals 20 |
| Context: | server config, virtual host, directory |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in Apache HTTP Server 2.3.15 and later |
The MaxRangeReversals directive
limits the number of HTTP Range reversals the server is willing to
return to the client. If more ranges reversals than permitted are requested,
the complete resource is returned instead.
| Description: | Number of ranges allowed before returning the complete resource |
|---|---|
| Syntax: | MaxRanges default | unlimited | none | number-of-ranges |
| Default: | MaxRanges 200 |
| Context: | server config, virtual host, directory |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in Apache HTTP Server 2.3.15 and later |
The MaxRanges directive
limits the number of HTTP ranges the server is willing to
return to the client. If more ranges than permitted are requested,
the complete resource is returned instead.
| Description: | Controls whether the server merges consecutive slashes in URLs. |
|---|---|
| Syntax: | MergeSlashes ON|OFF |
| Default: | MergeSlashes ON |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
| Compatibility: | Added in 2.4.39 |
By default, the server merges (or collapses) multiple consecutive slash ('/') characters in the path component of the request URL.
When mapping URL's to the filesystem, these multiple slashes are not
significant. However, URL's handled other ways, such as by CGI or proxy,
might prefer to retain the significance of multiple consecutive slashes.
In these cases MergeSlashes can be set to
OFF to retain the multiple consecutive slashes, which is the legacy behavior.
When set to "OFF", regular expressions used in the configuration file that match
the path component of the URL (LocationMatch,
RewriteRule, ...) need to take into account multiple
consecutive slashes. Non regular expression based Location always
operate against a URL with merged slashes and cannot differentiate between multiple slashes.
| Description: | Determines whether trailers are merged into headers |
|---|---|
| Syntax: | MergeTrailers [on|off] |
| Default: | MergeTrailers off |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
| Compatibility: | 2.4.11 and later |
This directive controls whether HTTP trailers are copied into the internal representation of HTTP headers. This merging occurs when the request body has been completely consumed, long after most header processing would have a chance to examine or modify request headers.
This option is provided for compatibility with releases prior to 2.4.11, where trailers were always merged.
| Description: | Configures mutex mechanism and lock file directory for all or specified mutexes |
|---|---|
| Syntax: | Mutex mechanism [default|mutex-name] ... [OmitPID] |
| Default: | Mutex default |
| Context: | server config |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in Apache HTTP Server 2.3.4 and later |
The Mutex directive sets the mechanism,
and optionally the lock file location, that httpd and modules use
to serialize access to resources. Specify default as
the second argument to change the settings for all mutexes; specify
a mutex name (see table below) as the second argument to override
defaults only for that mutex.
The Mutex directive is typically used in
the following exceptional situations:
This directive only configures mutexes which have been registered
with the core server using the ap_mutex_register() API.
All modules bundled with httpd support the Mutex
directive, but third-party modules may not. Consult the documentation
of the third-party module, which must indicate the mutex name(s) which
can be configured if this directive is supported.
The following mutex mechanisms are available:
default | yes
This selects the default locking implementation, as determined by
APR. The default locking implementation can
be displayed by running httpd with the
-V option.
none | no
This effectively disables the mutex, and is only allowed for a mutex if the module indicates that it is a valid choice. Consult the module documentation for more information.
posixsem
This is a mutex variant based on a Posix semaphore.
The semaphore ownership is not recovered if a thread in the process holding the mutex segfaults, resulting in a hang of the web server.
sysvsem
This is a mutex variant based on a SystemV IPC semaphore.
It is possible to "leak" SysV semaphores if processes crash before the semaphore is removed.
The semaphore API allows for a denial of service attack by any
CGIs running under the same uid as the webserver (i.e.,
all CGIs, unless you use something like suexec
or cgiwrapper).
sem
This selects the "best" available semaphore implementation, choosing between Posix and SystemV IPC semaphores, in that order.
pthread
This is a mutex variant based on cross-process Posix thread mutexes.
On most systems, if a child process terminates abnormally while holding a mutex that uses this implementation, the server will deadlock and stop responding to requests. When this occurs, the server will require a manual restart to recover.
Solaris and Linux are notable exceptions as they provide a mechanism which usually allows the mutex to be recovered after a child process terminates abnormally while holding a mutex.
If your system is POSIX compliant or if it implements the
pthread_mutexattr_setrobust_np() function, you may be able
to use the pthread option safely.
fcntl:/path/to/mutex
This is a mutex variant where a physical (lock-)file and the
fcntl() function are used as the mutex.
When multiple mutexes based on this mechanism are used within
multi-threaded, multi-process environments, deadlock errors (EDEADLK)
can be reported for valid mutex operations if fcntl()
is not thread-aware, such as on Solaris.
flock:/path/to/mutex
This is similar to the fcntl:/path/to/mutex method
with the exception that the flock() function is used to
provide file locking.
file:/path/to/mutex
This selects the "best" available file locking implementation,
choosing between fcntl and flock, in that
order.
Most mechanisms are only available on selected platforms, where the underlying platform and APR support it. Mechanisms which aren't available on all platforms are posixsem, sysvsem, sem, pthread, fcntl, flock, and file.
With the file-based mechanisms fcntl and flock,
the path, if provided, is a directory where the lock file will be created.
The default directory is httpd's run-time file directory relative to
ServerRoot. Always use a local disk
filesystem for /path/to/mutex and never a directory residing
on a NFS- or AFS-filesystem. The basename of the file will be the mutex
type, an optional instance string provided by the module, and unless the
OmitPID keyword is specified, the process id of the httpd
parent process will be appended to make the file name unique, avoiding
conflicts when multiple httpd instances share a lock file directory. For
example, if the mutex name is mpm-accept and the lock file
directory is /var/httpd/locks, the lock file name for the
httpd instance with parent process id 12345 would be
/var/httpd/locks/mpm-accept.12345.
It is best to avoid putting mutex files in a world-writable
directory such as /var/tmp because someone could create
a denial of service attack and prevent the server from starting by
creating a lockfile with the same name as the one the server will try
to create.
The following table documents the names of mutexes used by httpd and bundled modules.
| Mutex name | Module(s) | Protected resource |
|---|---|---|
mpm-accept |
prefork and worker MPMs |
incoming connections, to avoid the thundering herd problem; for more information, refer to the performance tuning documentation |
authdigest-client |
mod_auth_digest |
client list in shared memory |
authdigest-opaque |
mod_auth_digest |
counter in shared memory |
ldap-cache |
mod_ldap |
LDAP result cache |
rewrite-map |
mod_rewrite |
communication with external mapping programs, to avoid intermixed I/O from multiple requests |
ssl-cache |
mod_ssl |
SSL session cache |
ssl-stapling |
mod_ssl |
OCSP stapling response cache |
watchdog-callback |
mod_watchdog |
callback function of a particular client module |
The OmitPID keyword suppresses the addition of the httpd
parent process id from the lock file name.
In the following example, the mutex mechanism for the MPM accept
mutex will be changed from the compiled-in default to fcntl,
with the associated lock file created in directory
/var/httpd/locks. The mutex mechanism for all other mutexes
will be changed from the compiled-in default to sysvsem.
Mutex sysvsem default Mutex fcntl:/var/httpd/locks mpm-accept
| Description: | DEPRECATED: Designates an IP address for name-virtual hosting |
|---|---|
| Syntax: | NameVirtualHost addr[:port] |
| Context: | server config |
| Status: | Core |
| Module: | core |
Prior to 2.3.11, NameVirtualHost was required
to instruct the server that a particular IP address and port combination
was usable as a name-based virtual host. In 2.3.11 and later,
any time an IP address and port combination is used in multiple virtual
hosts, name-based virtual hosting is automatically enabled for that address.
This directive currently has no effect.
| Description: | Configures what features are available in a particular directory |
|---|---|
| Syntax: | Options
[+|-]option [[+|-]option] ... |
| Default: | Options FollowSymlinks |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Core |
| Module: | core |
| Compatibility: | The default was changed from All to FollowSymlinks in 2.3.11 |
The Options directive controls which
server features are available in a particular directory.
option can be set to None, in which
case none of the extra features are enabled, or one or more of
the following:
AllMultiViews.ExecCGImod_cgi
is permitted.FollowSymLinksEven though the server follows the symlink it does not
change the pathname used to match against <Directory> sections.
The FollowSymLinks and
SymLinksIfOwnerMatch Options work only in <Directory> sections or
.htaccess files.
Omitting this option should not be considered a security restriction, since symlink testing is subject to race conditions that make it circumventable.
Includesmod_include
are permitted.IncludesNOEXEC#exec
cmd and #exec cgi are disabled. It is still
possible to #include virtual CGI scripts from
ScriptAliased
directories.IndexesDirectoryIndex
(e.g., index.html) in that directory, then
mod_autoindex will return a formatted listing
of the directory.MultiViewsmod_negotiation.
This option gets ignored if set
anywhere other than <Directory>, as mod_negotiation
needs real resources to compare against and evaluate from.
SymLinksIfOwnerMatchThe FollowSymLinks and
SymLinksIfOwnerMatch Options work only in <Directory> sections or
.htaccess files.
This option should not be considered a security restriction, since symlink testing is subject to race conditions that make it circumventable.
Normally, if multiple Options could
apply to a directory, then the most specific one is used and
others are ignored; the options are not merged. (See how sections are merged.)
However if all the options on the
Options directive are preceded by a
+ or - symbol, the options are
merged. Any options preceded by a + are added to the
options currently in force, and any options preceded by a
- are removed from the options currently in
force.
Mixing Options with a + or
- with those without is not valid syntax and will be
rejected during server startup by the syntax check with an abort.
For example, without any + and - symbols:
<Directory "/web/docs"> Options Indexes FollowSymLinks </Directory> <Directory "/web/docs/spec"> Options Includes </Directory>
then only Includes will be set for the
/web/docs/spec directory. However if the second
Options directive uses the + and
- symbols:
<Directory "/web/docs"> Options Indexes FollowSymLinks </Directory> <Directory "/web/docs/spec"> Options +Includes -Indexes </Directory>
then the options FollowSymLinks and
Includes are set for the /web/docs/spec
directory.
Using -IncludesNOEXEC or
-Includes disables server-side includes completely
regardless of the previous setting.
The default in the absence of any other settings is
FollowSymlinks.
| Description: | Protocol for a listening socket |
|---|---|
| Syntax: | Protocol protocol |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in Apache 2.1.5 and later. On Windows, from Apache 2.3.3 and later. |
This directive specifies the protocol used for a specific listening socket.
The protocol is used to determine which module should handle a request and
to apply protocol specific optimizations with the AcceptFilter
directive.
This directive not required for most
configurations. If not specified, https is the default for
port 443 and http the default for all other ports. The
protocol is used to determine which module should handle a request, and
to apply protocol specific optimizations with the
AcceptFilter directive.
For example, if you are running https on a non-standard port,
specify the protocol explicitly:
Protocol https
You can also specify the protocol using the Listen directive.
| Description: | Protocols available for a server/virtual host |
|---|---|
| Syntax: | Protocols protocol ... |
| Default: | Protocols http/1.1 |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
| Compatibility: | Only available from Apache 2.4.17 and later. |
This directive specifies the list of protocols supported for a server/virtual host. The list determines the allowed protocols a client may negotiate for this server/host.
You need to set protocols if you want to extend the available protocols for a server/host. By default, only the http/1.1 protocol (which includes the compatibility with 1.0 and 0.9 clients) is allowed.
For example, if you want to support HTTP/2 for a server with TLS, specify:
Protocols h2 http/1.1
Valid protocols are http/1.1 for http and https connections,
h2 on https connections and h2c for http
connections. Modules may enable more protocols.
It is safe to specify protocols that are unavailable/disabled. Such protocol names will simply be ignored.
Protocols specified in base servers are inherited for virtual hosts only if the virtual host has no own Protocols directive. Or, the other way around, Protocols directives in virtual hosts replace any such directive in the base server.
| Description: | Determines if order of Protocols determines precedence during negotiation |
|---|---|
| Syntax: | ProtocolsHonorOrder On|Off |
| Default: | ProtocolsHonorOrder On |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
| Compatibility: | Only available from Apache 2.4.17 and later. |
This directive specifies if the server should honor the order in which
the Protocols directive lists protocols.
If configured Off, the client supplied list order of protocols has precedence over the order in the server configuration.
With ProtocolsHonorOrder set to on
(default), the client ordering does not matter and only the ordering
in the server settings influences the outcome of the protocol
negotiation.
| Description: | Controls whether the REDIRECT_URL environment variable is fully qualified |
|---|---|
| Syntax: | QualifyRedirectURL On|Off |
| Default: | QualifyRedirectURL Off |
| Context: | server config, virtual host, directory |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
| Compatibility: | Directive supported in 2.4.18 and later. 2.4.17 acted as if 'QualifyRedirectURL On' was configured. |
This directive controls whether the server will ensure that the
REDIRECT_URL environment variable is fully qualified. By default,
the variable contains the verbatim URL requested by the client,
such as "/index.html". With QualifyRedirectURL On, the same request would result in a
value such as "http://www.example.com/index.html".
Even without this directive set, when a request is issued against a fully qualified URL, REDIRECT_URL will remain fully qualified.
| Description: | Size of the buffers used to read data |
|---|---|
| Syntax: | ReadBufferSize bytes |
| Default: | ReadBufferSize 8192 |
| Context: | server config, virtual host, directory |
| Status: | Core |
| Module: | core |
| Compatibility: | 2.4.27 and later |
This directive allows to configure the size (in bytes) of the memory buffer used to read data from the network or files.
A larger buffer can increase peformances with larger data, but consumes more memory per connection. The minimum configurable size is 1024.
| Description: | Allow to configure global/default options for regexes |
|---|---|
| Syntax: | RegexDefaultOptions [none] [+|-]option [[+|-]option] ... |
| Default: | RegexDefaultOptions DOTALL DOLLAR_ENDONLY |
| Context: | server config |
| Status: | Core |
| Module: | core |
| Compatibility: | Only available from Apache 2.4.30 and later. |
This directive adds some default behavior to ANY regular expression used afterwards.
Any option preceded by a '+' is added to the already set options.
Any option preceded by a '-' is removed from the already set options.
Any option without a '+' or a '-' will be set, removing any other
already set option.
The none keyword resets any already set options.
option can be:
ICASEEXTENDEDDOTALLDOLLAR_ENDONLY# Add the ICASE option for all regexes by default RegexDefaultOptions +ICASE ... # Remove the default DOLLAR_ENDONLY option, but keep any other one RegexDefaultOptions -DOLLAR_ENDONLY ... # Set the DOTALL option only, resetting any other one RegexDefaultOptions DOTALL ... # Reset all defined options RegexDefaultOptions none ...
| Description: | Register non-standard HTTP methods |
|---|---|
| Syntax: | RegisterHttpMethod method [method [...]] |
| Context: | server config |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in Apache HTTP Server 2.4.24 and later |
This directive may be used to register additional HTTP methods. This is necessary if non-standard methods need to be used with directives that accept method names as parameters, or to allow particular non-standard methods to be used via proxy or CGI script when the server has been configured to only pass recognized methods to modules.
| Description: | Limits the CPU consumption of processes launched by Apache httpd children |
|---|---|
| Syntax: | RLimitCPU seconds|max [seconds|max] |
| Default: | Unset; uses operating system defaults |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
Takes 1 or 2 parameters. The first parameter sets the soft
resource limit for all processes and the second parameter sets
the maximum resource limit. Either parameter can be a number,
or max to indicate to the server that the limit should
be set to the maximum allowed by the operating system
configuration. Raising the maximum resource limit requires that
the server is running as root or in the initial startup
phase.
This applies to processes forked from Apache httpd children servicing requests, not the Apache httpd children themselves. This includes CGI scripts and SSI exec commands, but not any processes forked from the Apache httpd parent, such as piped logs.
CPU resource limits are expressed in seconds per process.
| Description: | Limits the memory consumption of processes launched by Apache httpd children |
|---|---|
| Syntax: | RLimitMEM bytes|max [bytes|max] |
| Default: | Unset; uses operating system defaults |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
Takes 1 or 2 parameters. The first parameter sets the soft
resource limit for all processes and the second parameter sets
the maximum resource limit. Either parameter can be a number,
or max to indicate to the server that the limit should
be set to the maximum allowed by the operating system
configuration. Raising the maximum resource limit requires that
the server is running as root or in the initial startup
phase.
This applies to processes forked from Apache httpd children servicing requests, not the Apache httpd children themselves. This includes CGI scripts and SSI exec commands, but not any processes forked from the Apache httpd parent, such as piped logs.
Memory resource limits are expressed in bytes per process.
| Description: | Limits the number of processes that can be launched by processes launched by Apache httpd children |
|---|---|
| Syntax: | RLimitNPROC number|max [number|max] |
| Default: | Unset; uses operating system defaults |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
Takes 1 or 2 parameters. The first parameter sets the soft
resource limit for all processes, and the second parameter sets
the maximum resource limit. Either parameter can be a number,
or max to indicate to the server that the limit
should be set to the maximum allowed by the operating system
configuration. Raising the maximum resource limit requires that
the server is running as root or in the initial startup
phase.
This applies to processes forked from Apache httpd children servicing requests, not the Apache httpd children themselves. This includes CGI scripts and SSI exec commands, but not any processes forked from the Apache httpd parent, such as piped logs.
Process limits control the number of processes per user.
If CGI processes are not running
under user ids other than the web server user id, this directive
will limit the number of processes that the server itself can
create. Evidence of this situation will be indicated by
cannot fork messages in the
error_log.
| Description: | Technique for locating the interpreter for CGI scripts |
|---|---|
| Syntax: | ScriptInterpreterSource Registry|Registry-Strict|Script |
| Default: | ScriptInterpreterSource Script |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
| Compatibility: | Win32 only. |
This directive is used to control how Apache httpd finds the
interpreter used to run CGI scripts. The default setting is
Script. This causes Apache httpd to use the interpreter pointed to
by the shebang line (first line, starting with #!) in the
script. On Win32 systems this line usually looks like:
#!C:/Perl/bin/perl.exe
or, if perl is in the PATH, simply:
#!perl
Setting ScriptInterpreterSource Registry will
cause the Windows Registry tree HKEY_CLASSES_ROOT to be
searched using the script file extension (e.g., .pl) as a
search key. The command defined by the registry subkey
Shell\ExecCGI\Command or, if it does not exist, by the subkey
Shell\Open\Command is used to open the script file. If the
registry keys cannot be found, Apache httpd falls back to the behavior of the
Script option.
Be careful when using ScriptInterpreterSource
Registry with ScriptAlias'ed directories, because
Apache httpd will try to execute every file within this
directory. The Registry setting may cause undesired
program calls on files which are typically not executed. For
example, the default open command on .htm files on
most Windows systems will execute Microsoft Internet Explorer, so
any HTTP request for an .htm file existing within the
script directory would start the browser in the background on the
server. This is a good way to crash your system within a minute or
so.
The option Registry-Strict
does the same thing as Registry but uses only the
subkey Shell\ExecCGI\Command. The
ExecCGI key is not a common one. It must be
configured manually in the windows registry and hence prevents
accidental program calls on your system.
| Description: | Determine if mod_status displays the first 63 characters of a request or the last 63, assuming the request itself is greater than 63 chars. |
|---|---|
| Syntax: | SeeRequestTail On|Off |
| Default: | SeeRequestTail Off |
| Context: | server config |
| Status: | Core |
| Module: | core |
| Compatibility: | Available in Apache httpd 2.2.7 and later. |
mod_status with ExtendedStatus On
displays the actual request being handled.
For historical purposes, only 63 characters of the request
are actually stored for display purposes. This directive
controls whether the first 63 characters are stored (the previous
behavior and the default) or if the last 63 characters are. This
is only applicable, of course, if the length of the request is
64 characters or greater.
If Apache httpd is handling GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1 mod_status displays as follows:
| Off (default) | GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples |
|---|---|
| On | orage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1 |
| Description: | Email address that the server includes in error messages sent to the client |
|---|---|
| Syntax: | ServerAdmin email-address|URL |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
The ServerAdmin sets the contact address
that the server includes in any error messages it returns to the
client. If the httpd doesn't recognize the supplied argument
as an URL, it
assumes, that it's an email-address and prepends it with
mailto: in hyperlink targets. However, it's recommended to
actually use an email address, since there are a lot of CGI scripts that
make that assumption. If you want to use an URL, it should point to another
server under your control. Otherwise users may not be able to contact you in
case of errors.
It may be worth setting up a dedicated address for this, e.g.
ServerAdmin www-admin@foo.example.com
as users do not always mention that they are talking about the server!
| Description: | Alternate names for a host used when matching requests to name-virtual hosts |
|---|---|
| Syntax: | ServerAlias hostname [hostname] ... |
| Context: | virtual host |
| Status: | Core |
| Module: | core |
The ServerAlias directive sets the
alternate names for a host, for use with name-based virtual hosts. The
ServerAlias may include wildcards, if appropriate.
<VirtualHost *:80> ServerName server.example.com ServerAlias server server2.example.com server2 ServerAlias *.example.com UseCanonicalName Off # ... </VirtualHost>
Name-based virtual hosts for the best-matching set of <virtualhost>s are processed
in the order they appear in the configuration. The first matching ServerName or ServerAlias is used, with no different precedence for wildcards
(nor for ServerName vs. ServerAlias).
The complete list of names in the <VirtualHost>
directive are treated just like a (non wildcard)
ServerAlias.
| Description: | Hostname and port that the server uses to identify itself |
|---|---|
| Syntax: | ServerName [scheme://]domain-name|ip-address[:port] |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
The ServerName directive sets the
request scheme, hostname and port that the server uses to identify itself.
ServerName is used (possibly
in conjunction with ServerAlias) to uniquely
identify a virtual host, when using name-based virtual hosts.
Additionally, this is used when
creating self-referential redirection URLs when
UseCanonicalName is set to a non-default
value.
For example, if the name of the
machine hosting the web server is simple.example.com,
but the machine also has the DNS alias www.example.com
and you wish the web server to be so identified, the following
directive should be used:
ServerName www.example.com
The ServerName directive
may appear anywhere within the definition of a server. However,
each appearance overrides the previous appearance (within that
server).
If no ServerName is specified, the
server attempts to deduce the client visible hostname by first asking
the operating system for the system hostname, and if that fails,
performing a reverse lookup on an IP address present on the system.
If no port is specified in the
ServerName, then the server will use the
port from the incoming request. For optimal reliability and
predictability, you should specify an explicit hostname and port
using the ServerName directive.
If you are using name-based virtual hosts,
the ServerName inside a
<VirtualHost>
section specifies what hostname must appear in the request's
Host: header to match this virtual host.
Sometimes, the server runs behind a device that processes SSL,
such as a reverse proxy, load balancer or SSL offload
appliance. When this is the case, specify the
https:// scheme and the port number to which the
clients connect in the ServerName directive
to make sure that the server generates the correct
self-referential URLs.
See the description of the
UseCanonicalName and
UseCanonicalPhysicalPort directives for
settings which determine whether self-referential URLs (e.g., by the
mod_dir module) will refer to the
specified port, or to the port number given in the client's request.
Failure to set ServerName to a name that
your server can resolve to an IP address will result in a startup
warning. httpd will then use whatever hostname it can
determine, using the system's hostname command. This
will almost never be the hostname you actually want.
httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName
| Description: | Legacy URL pathname for a name-based virtual host that is accessed by an incompatible browser |
|---|---|
| Syntax: | ServerPath URL-path |
| Context: | virtual host |
| Status: | Core |
| Module: | core |
The ServerPath directive sets the legacy
URL pathname for a host, for use with name-based virtual hosts.
| Description: | Base directory for the server installation |
|---|---|
| Syntax: | ServerRoot directory-path |
| Default: | ServerRoot /usr/local/apache |
| Context: | server config |
| Status: | Core |
| Module: | core |
The ServerRoot directive sets the
directory in which the server lives. Typically it will contain the
subdirectories conf/ and logs/. Relative
paths in other configuration directives (such as Include or LoadModule, for example) are taken as
relative to this directory.
ServerRoot "/home/httpd"
The default location of ServerRoot may be
modified by using the --prefix argument to
configure, and
most third-party distributions of the server have a different
default location from the one listed above.
-d
option to httpdServerRoot| Description: | Configures the footer on server-generated documents |
|---|---|
| Syntax: | ServerSignature On|Off|EMail |
| Default: | ServerSignature Off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Core |
| Module: | core |
The ServerSignature directive allows the
configuration of a trailing footer line under server-generated
documents (error messages, mod_proxy ftp directory
listings, mod_info output, ...). The reason why you
would want to enable such a footer line is that in a chain of proxies,
the user often has no possibility to tell which of the chained servers
actually produced a returned error message.
The Off
setting, which is the default, suppresses the footer line.
The On setting simply adds a line with the
server version number and ServerName of the serving virtual host,
and the EMail setting additionally creates a
"mailto:" reference to the ServerAdmin of the referenced
document.
The details of the server version number
presented are controlled by the ServerTokens directive.
| Description: | Configures the Server HTTP response
header |
|---|---|
| Syntax: | ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full |
| Default: | ServerTokens Full |
| Context: | server config |
| Status: | Core |
| Module: | core |
This directive controls whether Server response
header field which is sent back to clients includes a
description of the generic OS-type of the server as well as
information about compiled-in modules.
ServerTokens Full (or not specified)Server: Apache/2.4.2
(Unix) PHP/4.2.2 MyMod/1.2ServerTokens Prod[uctOnly]Server:
ApacheServerTokens MajorServer:
Apache/2ServerTokens MinorServer:
Apache/2.4ServerTokens Min[imal]Server:
Apache/2.4.2ServerTokens OSServer: Apache/2.4.2
(Unix)This setting applies to the entire server, and cannot be enabled or disabled on a virtualhost-by-virtualhost basis.
This directive also controls the
information presented by the ServerSignature directive.
ServerTokens to less than
minimal is not recommended because it makes it more
difficult to debug interoperational problems. Also note that
disabling the Server: header does nothing at all to make your
server more secure. The idea of "security through obscurity"
is a myth and leads to a false sense of safety.| Description: | Forces all matching files to be processed by a handler |
|---|---|
| Syntax: | SetHandler handler-name|none|expression |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
| Compatibility: | expression argument 2.4.19 and later |
When placed into an .htaccess file or a
<Directory> or
<Location>
section, this directive forces all matching files to be parsed
through the handler given by
handler-name. For example, if you had a directory you
wanted to be parsed entirely as imagemap rule files, regardless
of extension, you might put the following into an
.htaccess file in that directory:
SetHandler imap-file
Another example: if you wanted to have the server display a
status report whenever a URL of
http://servername/status was called, you might put
the following into httpd.conf:
<Location "/status"> SetHandler server-status </Location>
You could also use this directive to configure a particular handler for files with a particular file extension. For example:
<FilesMatch "\.php$">
SetHandler application/x-httpd-php
</FilesMatch>
String-valued expressions can be used to reference per-request variables, including backreferences to named regular expressions:
<LocationMatch ^/app/(?<sub>[^/]+)/>
SetHandler "proxy:unix:/var/run/app_%{env:MATCH_sub}.sock|fcgi://localhost:8080"
</LocationMatch>
You can override an earlier defined SetHandler
directive by using the value None.
Because SetHandler overrides default handlers,
normal behavior such as handling of URLs ending in a slash (/) as
directories or index files is suppressed.
| Description: | Sets the filters that will process client requests and POST input |
|---|---|
| Syntax: | SetInputFilter filter[;filter...] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
The SetInputFilter directive sets the
filter or filters which will process client requests and POST
input when they are received by the server. This is in addition to
any filters defined elsewhere, including the
AddInputFilter
directive.
If more than one filter is specified, they must be separated by semicolons in the order in which they should process the content.
| Description: | Sets the filters that will process responses from the server |
|---|---|
| Syntax: | SetOutputFilter filter[;filter...] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Core |
| Module: | core |
The SetOutputFilter directive sets the filters
which will process responses from the server before they are
sent to the client. This is in addition to any filters defined
elsewhere, including the
AddOutputFilter
directive.
For example, the following configuration will process all files
in the /www/data/ directory for server-side
includes.
<Directory "/www/data/"> SetOutputFilter INCLUDES </Directory>
If more than one filter is specified, they must be separated by semicolons in the order in which they should process the content.
| Description: | Controls whether the server requires the requested hostname be listed enumerated in the virtual host handling the request |
|---|---|
| Syntax: | StrictHostCheck ON|OFF |
| Default: | StrictHostCheck OFF |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
| Compatibility: | Added in 2.4.49 |
By default, the server will respond to requests for any hostname, including requests addressed to unexpected or unconfigured hostnames. While this is convenient, it is sometimes desirable to limit what hostnames a backend application handles since it will often generate self-referential responses.
By setting StrictHostCheck to ON,
the server will return an HTTP 400 error if the requested hostname
hasn't been explicitly listed by either ServerName or ServerAlias in the virtual host that best matches the
details of the incoming connection.
This directive also allows matching of the requested hostname to hostnames
specified within the opening VirtualHost
tag, which is a relatively obscure configuration mechanism that acts like
additional ServerAlias entries.
This directive has no affect in non-default virtual hosts. The value inherited from the global server configuration, or the default virtualhost for the ip:port the underlying connection, determine the effective value.
| Description: | Amount of time the server will wait for certain events before failing a request |
|---|---|
| Syntax: | TimeOut seconds |
| Default: | TimeOut 60 |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
The TimeOut directive defines the length
of time Apache httpd will wait for I/O in various circumstances:
When reading data from the client, the length of time to wait for a TCP packet to arrive if the read buffer is empty.
For initial data on a new connection, this directive doesn't
take effect until after any configured
AcceptFilter has passed the new connection to the server.
mod_cgi and mod_cgid,
the length of time to wait for any individual block of output
from a CGI script.mod_ext_filter, the length of time to
wait for output from a filtering process.mod_proxy, the default timeout value if
ProxyTimeout is not
configured.| Description: | Determines the behavior on TRACE requests |
|---|---|
| Syntax: | TraceEnable [on|off|extended] |
| Default: | TraceEnable on |
| Context: | server config, virtual host |
| Status: | Core |
| Module: | core |
This directive overrides the behavior of TRACE for both
the core server and mod_proxy. The default
TraceEnable on permits TRACE requests per
RFC 2616, which disallows any request body to accompany the request.
TraceEnable off causes the core server and
mod_proxy to return a 405 (Method not
allowed) error to the client.
Finally, for testing and diagnostic purposes only, request
bodies may be allowed using the non-compliant TraceEnable
extended directive. The core (as an origin server) will
restrict the request body to 64Kb (plus 8Kb for chunk headers if
Transfer-Encoding: chunked is used). The core will
reflect the full headers and all chunk headers with the response
body. As a proxy server, the request body is not restricted to 64Kb.
Despite claims to the contrary, enabling the TRACE
method does not expose any security vulnerability in Apache httpd.
The TRACE method is defined by the HTTP/1.1
specification and implementations are expected to support it.
| Description: | Controls what UNC host names can be accessed by the server |
|---|---|
| Syntax: | UNCList hostname [hostname...] |
| Default: | unset |
| Context: | server config |
| Status: | Core |
| Module: | core |
| Compatibility: | Added in 2.4.60, Windows only. |
During request processing, requests to access a filesystem path that resolves to a UNC path will fail unless the hostname in the UNC path has been specified by this directive. The intent is to limit access to paths derived from untrusted inputs.
UNCList example.com other.example.com
The values specified by this directive are only checked by some components of the server, prior to accessing filesystem paths that may be inadvertently derived from untrusted inputs.
Windows systems should be isolated at the network layer from making outbound SMB/NTLM calls to unexpected destinations as a more comprehensive and pre-emptive measure.
This directive should be placed before UNC paths used in httpd.conf. Multiple occurrences of the directive reset the list.
| Description: | Undefine the existence of a variable |
|---|---|
| Syntax: | UnDefine parameter-name |
| Context: | server config |
| Status: | Core |
| Module: | core |
Undoes the effect of a Define or
of passing a -D argument to httpd.
This directive can be used to toggle the use of <IfDefine> sections without needing to alter
-D arguments in any startup scripts.
Variable names may not contain colon ":" characters, to avoid clashes
with RewriteMap's syntax.
While this directive is supported in virtual host context, the changes it makes are visible to any later configuration directives, beyond any enclosing virtual host.
| Description: | Configures how the server determines its own name and port |
|---|---|
| Syntax: | UseCanonicalName On|Off|DNS |
| Default: | UseCanonicalName Off |
| Context: | server config, virtual host, directory |
| Status: | Core |
| Module: | core |
In many situations Apache httpd must construct a self-referential
URL -- that is, a URL that refers back to the same server. With
UseCanonicalName On Apache httpd will use the hostname and port
specified in the ServerName
directive to construct the canonical name for the server. This name
is used in all self-referential URLs, and for the values of
SERVER_NAME and SERVER_PORT in CGIs.
With UseCanonicalName Off Apache httpd will form
self-referential URLs using the hostname and port supplied by
the client if any are supplied (otherwise it will use the
canonical name, as defined above). These values are the same
that are used to implement name-based virtual hosts
and are available with the same clients. The CGI variables
SERVER_NAME and SERVER_PORT will be
constructed from the client supplied values as well.
An example where this may be useful is on an intranet server
where you have users connecting to the machine using short
names such as www. You'll notice that if the users
type a shortname and a URL which is a directory, such as
http://www/splat, without the trailing
slash, then Apache httpd will redirect them to
http://www.example.com/splat/. If you have
authentication enabled, this will cause the user to have to
authenticate twice (once for www and once again
for www.example.com -- see
the FAQ on this subject for more information). But if
UseCanonicalName is set Off, then
Apache httpd will redirect to http://www/splat/.
There is a third option, UseCanonicalName DNS,
which is intended for use with mass IP-based virtual hosting to
support ancient clients that do not provide a
Host: header. With this option, Apache httpd does a
reverse DNS lookup on the server IP address that the client
connected to in order to work out self-referential URLs.
If CGIs make assumptions about the values of SERVER_NAME,
they may be broken by this option. The client is essentially free
to give whatever value they want as a hostname. But if the CGI is
only using SERVER_NAME to construct self-referential URLs,
then it should be just fine.
| Description: | Configures how the server determines its own port |
|---|---|
| Syntax: | UseCanonicalPhysicalPort On|Off |
| Default: | UseCanonicalPhysicalPort Off |
| Context: | server config, virtual host, directory |
| Status: | Core |
| Module: | core |
In many situations Apache httpd must construct a self-referential
URL -- that is, a URL that refers back to the same server. With
UseCanonicalPhysicalPort On, Apache httpd will, when
constructing the canonical port for the server to honor
the UseCanonicalName directive,
provide the actual physical port number being used by this request
as a potential port. With UseCanonicalPhysicalPort Off,
Apache httpd will not ever use the actual physical port number, instead
relying on all configured information to construct a valid port number.
The ordering of the lookup when the physical port is used is as follows:
UseCanonicalName OnServernameUseCanonicalName Off | DNSHost: headerServernameWith UseCanonicalPhysicalPort Off, the
physical ports are removed from the ordering.
| Description: | Contains directives that apply only to a specific hostname or IP address |
|---|---|
| Syntax: | <VirtualHost
addr[:port] [addr[:port]]
...> ... </VirtualHost> |
| Context: | server config |
| Status: | Core |
| Module: | core |
<VirtualHost> and
</VirtualHost> are used to enclose a group of
directives that will apply only to a particular virtual host. Any
directive that is allowed in a virtual host context may be
used. When the server receives a request for a document on a
particular virtual host, it uses the configuration directives
enclosed in the <VirtualHost>
section. Addr can be any of the following, optionally followed by
a colon and a port number (or *):
*, which acts as a wildcard and matches
any IP address._default_, which is an alias for *<VirtualHost 10.1.2.3:80> ServerAdmin webmaster@host.example.com DocumentRoot "/www/docs/host.example.com" ServerName host.example.com ErrorLog "logs/host.example.com-error_log" TransferLog "logs/host.example.com-access_log" </VirtualHost>
IPv6 addresses must be specified in square brackets because the optional port number could not be determined otherwise. An IPv6 example is shown below:
<VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80> ServerAdmin webmaster@host.example.com DocumentRoot "/www/docs/host.example.com" ServerName host.example.com ErrorLog "logs/host.example.com-error_log" TransferLog "logs/host.example.com-access_log" </VirtualHost>
Each Virtual Host must correspond to a different IP address,
different port number, or a different host name for the server,
in the former case the server machine must be configured to
accept IP packets for multiple addresses. (If the machine does
not have multiple network interfaces, then this can be
accomplished with the ifconfig alias command -- if
your OS supports it).
The use of <VirtualHost> does
not affect what addresses Apache httpd listens on. You
may need to ensure that Apache httpd is listening on the correct addresses
using Listen.
A ServerName should be
specified inside each <VirtualHost> block. If it is absent, the
ServerName from the "main"
server configuration will be inherited.
When a request is received, the server first maps it to the best matching
<VirtualHost> based on the local
IP address and port combination only. Non-wildcards have a higher
precedence. If no match based on IP and port occurs at all, the
"main" server configuration is used.
If multiple virtual hosts contain the best matching IP address and port, the server selects from these virtual hosts the best match based on the requested hostname. If no matching name-based virtual host is found, then the first listed virtual host that matched the IP address will be used. As a consequence, the first listed virtual host for a given IP address and port combination is the default virtual host for that IP and port combination.
See the security tips document for details on why your security could be compromised if the directory where log files are stored is writable by anyone other than the user that starts the server.
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Apache HTTP Sunucusunda daima mevcut olan çekirdek özellikler |
|---|---|
| Durum: | Çekirdek |
AcceptFilter AcceptPathInfo AccessFileName AddDefaultCharset AllowEncodedSlashes AllowOverride AllowOverrideList CGIMapExtension CGIPassAuth CGIVar ContentDigest DefaultRuntimeDir DefaultType Define <Directory> <DirectoryMatch> DocumentRoot <Else> <ElseIf> EnableMMAP EnableSendfile Error ErrorDocument ErrorLog ErrorLogFormat ExtendedStatus FileETag <Files> <FilesMatch> FlushMaxPipelined FlushMaxThreshold ForceType GprofDir HostnameLookups HttpProtocolOptions <If> <IfDefine> <IfDirective> <IfFile> <IfModule> <IfSection> Include IncludeOptional KeepAlive KeepAliveTimeout <Limit> <LimitExcept> LimitInternalRecursion LimitRequestBody LimitRequestFields LimitRequestFieldSize LimitRequestLine LimitXMLRequestBody <Location> <LocationMatch> LogLevel MaxKeepAliveRequests MaxRangeOverlaps MaxRangeReversals MaxRanges MergeSlashes MergeTrailers Mutex NameVirtualHost Options Protocol Protocols ProtocolsHonorOrder QualifyRedirectURL ReadBufferSize RegexDefaultOptions RegisterHttpMethod RLimitCPU RLimitMEM RLimitNPROC ScriptInterpreterSource SeeRequestTail ServerAdmin ServerAlias ServerName ServerPath ServerRoot ServerSignature ServerTokens SetHandler SetInputFilter SetOutputFilter StrictHostCheck TimeOut TraceEnable UNCList UnDefine UseCanonicalName UseCanonicalPhysicalPort <VirtualHost>| Açıklama: | Bir protokolün dinleyici soketleri için en iyilemeleri ayarlar |
|---|---|
| Sözdizimi: | AcceptFilter |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
Bu yönerge Protocol yönergesinde belirtilen
protokol türüne göre bir dinleme soketinin işletim
sistemine özgü en iyilemelerini etkin kılar. İşletim sistemi çekirdeği
için temel önerme veri alınıncaya kadar veya HTTP isteğinin tamamı
tamponlanana kadar sunucu sürecine bir soket tahsis etmemektir.
Şimdilik sadece FreeBSD’nin Kabul Süzgeçleri ve Linux’un soket seçeneklerinden
TCP_DEFER_ACCEPT ve Windows'un en iyilenmiş
AcceptEx() işlevi desteklenmektedir.
Değiştirge olarak none kullanımı, protokolün kabul
süzgeçlerini iptal edecektir. ftp: veya nntp
gibi sunucunun baştan bir veri göndermesinin gerekli olduğu
protokoller için kullanışlıdır. Örnek:
AcceptFilter nntp none
Öntanımlı protokol isimleri port 443 için https ve tüm
diğer portlar için http'dir. Dinlenmesi için başka bir port
ile ilgili bir protokol belirtmek isterseniz Listen yönergesine protokol
argümanını ekleyin.
FreeBSD için öntanımlı değerler:
AcceptFilter http httpready AcceptFilter https dataready
httpready kabul süzgeci HTTP isteklerinin tamamını
işletim sistemi çekirdeği seviyesinde tamponlar. Çekirdek isteğin
tamamını alır almaz sunucuya gönderir. Ayrıntılar için accf_http(9) kılavuz sayfasına bakınız. HTTPS istekleri
şifrelenmiş olduğundan sadece accf_data(9) süzgeci kullanılır.
Linux’taki öntanımlı değerler:
AcceptFilter http data AcceptFilter https data
Linux’un TCP_DEFER_ACCEPT soket seçeneği HTTP isteklerinin
tamponlanmasını desteklemez. none dahil her değer
dinleyici üzerinde TCP_DEFER_ACCEPT seçeneğini etkin kılar.
Daha ayrıntılı bilgi edinmek için Linux
tcp(7) kılavuz sayfasına bakınız.
Windows’taki öntanımlı değerler::
AcceptFilter http connect AcceptFilter https connect
Windows'un mpm_winnt modülü AcceptEx()
arayüzünü açıp kapamak için AcceptFilter'i yorumlar ve
http protokol tamponlamasını desteklemez. connect, AcceptEx() arayüzünü kullanacak, ayrıca uç ağ adresleri de alınacak, fakat none gibi connect seçeneği de ilk veri aktarımını beklemeyecektir.
Windows'ta none AcceptEx()'ten ziyade
accept() kullanır ve ağ soketlerini bağlantılar arasında
yer değiştirmez. Sürücü desteği bozuk ağ bağdaştırıcılarından başka
vpn sürücüleri gibi bazı sanal ağ sağlayıcılar veya spam, virus veya
casus yazılım süzgeçleri için kullanışlıdır.
data AcceptFilter (Windows)2.4.23 ve öncesi sürümlerde, Windows data accept
süzgeci veri aktarılana kadar bekletildikten sonra ilk veri
tamponlanır ve uç ağ adresi için tek bir AcceptEx() çağrısı yapılır.
Bu gerçeklenim hizmet reddi saldırısına konu olduğundan iptal
edilmiştir.
httpd'nin şu anki dağıtımları için Windows'da connect
süzgeci öntanımlıdır ve data belirtilmiş olsa dahi
connect belirtilmiş gibi davranılır. Önceki sürümleri
kullananların AcceptFilter satırını yukarıdaki gibi
connect süzgecine ayarlamaları gerekmektedir.
| Açıklama: | Dosya isminden sonra belirtilen yol verisini kabul veya reddeder. |
|---|---|
| Sözdizimi: | AcceptPathInfo On|Off|Default |
| Öntanımlı: | AcceptPathInfo Default |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
Bu yönerge, istekte dosya isminden sonra (dizinde belirtilen dosya
bulunmayabilir) belirtilen yol verisinin kabul edilip edilmeyeceğini
denetler. Dosya isminden sonra belirtilen yol verisi
PATH_INFO ortam değişkeninde betiklerin kullanımına
sunulabilir.
Örneğin, içinde sadece here.html dosyası bulunan bir
/test/ dizinimiz olsun. /test/here.html/more
ve /test/nothere.html/more isteklerinin her ikisi de
PATH_INFO değişkenine /more verisinin
atanmasını sağlar.
AcceptPathInfo yönergesine atanabilecek argüman
sayısı üçtür:
Off/test/here.html/more şeklindeki istekler bir 404 (Nesne
bulunamadı) hatasıyla sonuçlanır.On/test/here.html/more şeklindeki
istekler, /test/here.html geçerli bir dosya olduğu
takdirde kabul edilir.DefaultPATH_INFO
isteklerini reddeder. cgi-script ve isapi-handler gibi betiklere
hizmet eden eylemciler ise genellikle PATH_INFO
isteklerini öntanımlı olarak kabul ederler.AcceptPathInfo yönergesinin birincil amacı eylemcinin
PATH_INFO istekleri hakkında verdiği kabul veya red
kararını geçersiz kılabilmenizi sağlamaktır. Örneğin,
PATH_INFO’ya dayalı olarak içerik üretmek için INCLUDES gibi bir süzgeç kullandığınız takdirde bu
geçersizleştirme zorunlu olur. Normal dosyalar için çekirdek eylemci
normal olarak isteği reddederdi, böyle bir durumda bir betiği etkin
kılmak için aşağıdaki gibi bir yapılandırma kullanabilirsiniz:
<Files "mypaths.shtml"> Options +Includes SetOutputFilter INCLUDES AcceptPathInfo On </Files>
| Açıklama: | Dağıtık yapılandırma dosyasının ismi belirtilir. |
|---|---|
| Sözdizimi: | AccessFileName |
| Öntanımlı: | AccessFileName .htaccess |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
Belge yolu üzerindeki dizinlerde dağıtık yapılandırma dosyalarının bulunmasına izin verilmişse sunucu bir isteği işlerken önce bu dizinlerde bu yönergede belirtilmiş yapılandırma dosyasını arar. Örnek:
AccessFileName .acl
Sunucu, /usr/local/web/index.html belgesini döndürmeden
önce,
<Directory "/">
AllowOverride None
</Directory>
şeklinde bir yapılandırma ile iptal edilmiş olmadıkça yönergeler için
/.acl, /usr/.acl,
/usr/local/.acl ve /usr/local/web/.acl
dosyalarını okur.
| Açıklama: | Bir yanıtın içerik türü text/plain veya
text/html olduğunda eklenecek öntanımlı karakter kümesi
parametresini belirler. |
|---|---|
| Sözdizimi: | AddDefaultCharset On|Off| |
| Öntanımlı: | AddDefaultCharset Off |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
Bu yönerge, yanıtın içerik türü text/plain veya
text/html olmak şartıyla yanıta eklenecek karakter
kümesini (karakter kodlamasınının ismini) belirler. Bu, asıl davranış
çoğunlukla kullanıcının istemci yapılandırmasına bağlı olmakla
birlikte, yanıtın gövdesinde META elemanı vasıtasıyla
belirtilmiş karakter kümesini geçersiz kılar. AddDefaultCharset
Off şeklinde bir atama bu işlevselliği iptal eder.
AddDefaultCharset On ile bu işlevsellik etkin kılınmaktan
başka iso-8859-1 karakter kümesini öntanımlı olarak yanıta
eklenir. Yönergede karküm olarak belirtilecek değerler,
Genel Ağ ortam türlerinde (MIME türlerinde) kullanmak üzere IANA’da kayıtlı
karakter kümesi değerlerinden biri olmalıdır. Örnek:
AddDefaultCharset utf-8
AddDefaultCharset yönergesi sadece, metin
kaynaklarının hepsinin aynı karakter kümesine sahip olduğu bilindiği
takdirde ve her birinde ayrı ayrı karakter kümesi belirtmek çok
külfetli olacaksa kullanılmalıdır. Buna bir örnek, CGI betikleri
tarafından üretilmiş içeriğe sahip kaynaklara karakter kümesinin
eklenmesidir; böyle kaynaklar çıktıda kullanıcı tarafından sağlanmış
veri içermeleri nedeniyle karşı siteden kaynaklanan betikli
saldırılardan zarar görebilir. Bununla birlikte, bir öntanımlı karakter
kümesi belirtmek, tarayıcılarında “karakter kodlamasını kendiliğinden
sapta” özelliğini etkin kılmış kullanıcıları korumayacağından daha iyi
bir çözüm bu betikleri bu tür saldırılara karşı düzeltmek veya en iyisi
silmektir.
| Açıklama: | Kodlanmış dosya yolu ayracı içeren URL’lere izin verilip verilmeyeceğini belirler. |
|---|---|
| Sözdizimi: | AllowEncodedSlashes On|Off|NoDecode |
| Öntanımlı: | AllowEncodedSlashes Off |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | NoDecode seçeneği Apache httpd 2.3.12 ve sonrasında mevcuttur. |
AllowEncodedSlashes yönergesi kodlanmış dosya
yolu ayracı içeren URL’lere izin verir (/ yerine
%2F ve ek olarak \ için ilgili sistemlerde
%5C kullanılmış URL’ler).
Off öntanımlı değeriyle, böyle URL’ler bir 404
(Nesne bulunamadı) hatasıyla reddedilirler.
On değeriyle, böyle URL’ler kabul edilir ve kodlanmış
dosya yolu ayraçları kodlanmış diğer karakterler gibi çözümlenir.
NoDecode değeriyle, böyle URL’ler kabul edilir fakat
kodlanmış dosya yolu ayraçları çözümlenmeden kodlanmış halde
bırakılır.
AllowEncodedSlashes On, çoğunlukla
PATH_INFO ile bir arada kullanıldığı zaman
kullanışlıdır.
Kodlanmış bölü çizgileri yol bilgisi için gerekliyse bir güvenlik
ölçütü olarak NoDecode kullanımı şiddetle önerilir.
Kodlanmış bölü çizgilerinin çözümlenmesine izin vermek güvensiz olması
olası yollara izin vermek olurdu.
| Açıklama: | .htaccess dosyalarında bulunmasına izin verilen
yönerge türleri belirtilir. |
|---|---|
| Sözdizimi: | AllowOverride All|None| |
| Öntanımlı: | AllowOverride None (2.3.9 ve sonrası), AllowOverride All (2.3.8 ve öncesi) |
| Bağlam: | dizin |
| Durum: | Çekirdek |
| Modül: | core |
Sunucu AccessFileName yönergesi
ile belirtildiği şekilde bir .htaccess dosyasına rastlarsa
önceki yapılandırma yönergelerinin hangilerinin geçersiz kılınmak üzere
bildirildiğini bilmek ister.
AllowOverride yönergesi, <Location>, <DirectoryMatch> veya <Files> bölümlerinde değil,
sadece düzenli ifade içermeyen <Directory> bölümlerinde geçerlidir.
Bu yönergeye ve AllowOverrideList
yönergesine değer olarak None belirtilirse
.htaccess dosyaları tamamen yok sayılır.
Bu durumda, sunucu dosya sisteminde rastladığı .htaccess
dosyalarını okumaya dahi çalışmayacaktır.
Bu yönergeye All değeri atanırsa, .htaccess bağlamında kullanılabilecek her
yönergeye .htaccess dosyalarında izin verilir. (Hangi
yönerge-türü türü için hangi yönergelerin etkin olduğunu görmek
için .htaccess için Geçersizleştirme Sınıfları
sayfasına bakınız)
yönerge-türü
AuthDBMGroupFile,
AuthDBMUserFile,
AuthGroupFile,
AuthName,
AuthType,
AuthUserFile,
Require
ve benzeri yetkilendirme yönergelerinin kullanımını izin
verilir.mod_mime
Add* ve Remove* yönergeleri,
ErrorDocument,
ForceType,
LanguagePriority,
SetHandler,
SetInputFilter,
SetOutputFilter
yönergeleri ve benzerleri ile
Header,
RequestHeader,
SetEnvIf,
SetEnvIfNoCase,
BrowserMatch,
CookieExpires,
CookieDomain,
CookieStyle,
CookieTracking,
CookieName
belge meta veri yönergelerinin,
mod_rewrite modülündeki
RewriteEngine,
RewriteOptions,
RewriteBase,
RewriteCond,
RewriteRule
yönergelerinin, mod_alias modülündeki
Redirect,
RedirectTemp,
RedirectPermanent,
RedirectMatch)
yönergelerinin ve mod_actions modülündeki
Action
yönergesinin kullanımına izin verilir.
AddDescription,
AddIcon,
AddIconByEncoding,
AddIconByType,
DefaultIcon,
DirectoryIndex,
FancyIndexing,
HeaderName,
IndexIgnore,
IndexOptions,
ReadmeName
yönergelerinin ve benzerlerinin kullanımına izin
verilir.Allow,
Deny ve
Order
yönergelerinin kullanımına izin verilir.AllowOverride yönergesinin kullanımına izin verir; bunun
yerine bir dahili sunucu hatasına sebep olur, izin verilmeyen veya
tanınmayan yönergeler yoksayılır ve günlüğe bir uyarı çıktılanır:
AllowOverride tarafından yasaklanmış yönergeler
ölümcül olarak ele alınmaz.Geçerli bir yönergedeki yazım hatalarının hala dahili bir sunucu hatasına sebep olacağına dikkat ediniz.
AllowOverride AuthConfig'e izin vermezse kullanıcıların
siteye erişimini kısıtlayan yapılandırma iptal edilmiş olur.
seçenek,...]Options ve
XBitHack yönergelerinin
kullanımına izin verilir. Options komutunda belirtilecek seçenekler
bir eşit işaretinden sonra aralarına sadece virgül konarak,
fakat virgülden sonra boşluk bırakmadan belirtilebilir.
.htaccess dosyalarında kullanılabilen
seçenek listesi bu yönergeyle sınırlanabilirse de herhangi bir
Options yönergesine izin
verildiği sürece miras alınmış diğer seçenekler göreli olmayan
sözdizimi kullanılarak iptal edilebilir. Başka bir deyişle, bu
mekanizma diğerlerinin değerlerini korumasına izin verirken belli bir
seçeneği değerini korumaya zorlayamaz.
AllowOverride Options=Indexes,MultiViews
Örnek:
AllowOverride AuthConfig Indexes
Bu örnekte AuthConfig ve Indexes grubundaki
yönergeler bir dahili sunucu hatasına yol açmayacaktır.
Güvenlik ve başarımı arttırmak için
<Directory "/">
bloğu içinde AllowOverride yönergesine None
dışında bir değer atamayın. Böyle yapmak yerine bir .htaccess
dosyası yerleştirmeyi düşündüğünüz dizine ait bir
<Directory> bloğu olması daha iyidir.
| Açıklama: | .htaccess dosyalarında izin verilecek yönergeler tek tek belirtilir |
|---|---|
| Sözdizimi: | AllowOverrideList None| |
| Öntanımlı: | AllowOverrideList None |
| Bağlam: | dizin |
| Durum: | Çekirdek |
| Modül: | core |
Sunucu bir .htaccess dosyası (AccessFileName tarafından belirtildiği gibi)
bulduğunda önceki yapılandırma yönergelerini geçersiz kılabilen bu
dosyada hangi yönergelerin bildirildiğini bilmek ister.
AllowOverrideList sadece <Directory> bölümlerinde düzenli
ifadeler olmaksızın belirtilmişse kullanılabilir; <Location>, <DirectoryMatch> veya <Files> bölümlerinde değil.
Bu yönergeye ve AllowOverride
yönergesine None atanmışsa
.htaccess dosyaları tamamen yoksayılır. Bu
durumda sunucu dosya sistemindeki .htaccess dosyalarını
okumaya bile çalışmayacaktır.
Örnek:
AllowOverride None AllowOverrideList Redirect RedirectMatch
Yukarıdaki örnekte sadece Redirect ve
RedirectMatch yönergelerine izin verilmektedir. Tüm
diğerleri dahili bir sunucu hatasına sebep olacaktır.
Örnek:
AllowOverride AuthConfig AllowOverrideList CookieTracking CookieName
Yukarıdaki örnekte AllowOverride
yönergesi AuthConfig yönerge grubuna izin
verirken AllowOverrideList yönergesi
FileInfo yönerge grubundan yalnız iki yönergeye izin
vermektedir. Tüm diğerleri dahili bir sunucu hatasına sebep
olacaktır.
| Açıklama: | CGI betik yorumlayıcısını saptama tekniğini belirler. |
|---|---|
| Sözdizimi: | CGIMapExtension |
| Bağlam: | dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Sadece NetWare’de geçerlidir. |
Bu yönerge Apache httpd’nin CGI bekitlerini çalıştırmak için
kullanacağı yorumlayıcıyı nasıl bulacağını denetlemek için kullanılır.
Örneğin, CGIMapExtension sys:\foo.nlm .foo satırı
.foo uzantılı CGI betik dosyalarının FOO yorumlayıcıya
aktarılmasını sağlar.
| Açıklama: | HTTP yetkilendirme başlıklarının betiklere CGI değişkenleri olarak aktarılmasını etkin kılar |
|---|---|
| Sözdizimi: | CGIPassAuth On|Off |
| Öntanımlı: | CGIPassAuth Off |
| Bağlam: | dizin, .htaccess |
| Geçersizleştirme: | AuthConfig |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache HTTP Sunucusunun 2.4.13 ve sonraki sürümlerinde kullanılabilmektedir |
CGIPassAuth yönergesi, HTTP Temel kimlik
doğrulamasını gerçekleştiren betikler için gereken
Authorization gibi HTTP yetkilendirme başlıklarına
betiklerin erişebilmesini sağlar. Normalde bu HTTP başlıkları
betiklerden gizli olup sunucuda HTTP Temel kimlik kanıtlaması etkin
kılındığında sunucuya erişmekte kullanılan kullanıcı kimliklerinin ve
parolalarının betikler tarafından görülmemesini mümkün kılar. Bu yönerge,
HTTP Temel kimlik kanıtlamasını betiklerin gerçekleştirmesini sağlamak
için kullanılmalıdır.
Apache HTTP Sunucusunun önceki sürümlerinde derleme sırasında
kullanılabilen SECURITY_HOLE_PASS_AUTHORIZATION sabitinin
yerine bu yönerge kullanılabilir.
Bu ayarlama mod_cgi, mod_cgid,
mod_proxy_fcgi, mod_proxy_scgi ve
benzerleri gibi ap_add_common_vars() kullanan modüller
tarafından kabul görür. Özellikle, isteği alışılmış tarzda işleme
sokmayıp bu arayüzü kullanan modülleri etkiler. Ayrıca,
ap_add_common_vars() kullanmayan üçüncü parti modüller de
bu ayarlamayı kullanmayı tercih edebilir.
| Açıklama: | Bazı CGI değişkenlerinin nasıl atanacağını belirler |
|---|---|
| Sözdizimi: | CGIVar |
| Bağlam: | dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache HTTP Server 2.4.21 ve sonrasında kullanılabilir |
Bu yönerge bazı CGI değişkenlerinin nasıl atanacağını belirler.
REQUEST_URI kuralları:
original-uri (default)current-uri| Açıklama: | Content-MD5 HTTP yanıt başlıklarının üretimini
etkin kılar. |
|---|---|
| Sözdizimi: | ContentDigest On|Off |
| Öntanımlı: | ContentDigest Off |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Options |
| Durum: | Çekirdek |
| Modül: | core |
Bu yönerge RFC2616 ve RFC1864’te tanımlandığı gibi
Content-MD5 üretimini etkin kılar.
MD5, verideki herhangi bir değişikliğin ileti özetinin değişmesi olarak yansıması nedeniyle yüksek derecede itimat sağlayan keyfi uzunlukta bir "ileti özeti" (bazen "parmakizi" dendiği de olur) hesaplama algoritmasıdır.
Content-MD5 başlığı öğe gövdesinin iki uç arasında ileti
bütünlük sınamasının yapılabilmesini sağlar. Bir istemci veya vekil
aktarılan öğe gövdesinde rastlantısal bir değişiklik olup olmadığını
saptamak için bu başlığın doğruluğunu sınayabilir. Başlık örneği:
Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
Her istekte ileti özeti hesaplanacağından (değerler saklanmaz), bu yönergenin sunucunuzda başarım sorunlarına yol açacağına dikkat ediniz.
Content-MD5, herhangi bir modül değil, sadece
core modülü tarafından sunulan belgeler için
gönderilir. Örneğin, SSI belgeleri CGI betikleri tarafından
çıktılanırlar ve bayt seviyesinden çıktılar bu başlığa sahip
olmazlar.
| Açıklama: | Sunucunun çalışma anı dosyaları için temel dizin |
|---|---|
| Sözdizimi: | DefaultRuntimeDir |
| Öntanımlı: | DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/) |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache 2.4.2 ve sonrasında kullanılabilmektedir. |
DefaultRuntimeDir yönergesi sunucunun çalışma
anında oluşturacağı dosyaların (paylaşımlı bellek, kilitler, vb.)
saklanacağı dizini belirtmekte kullanılır. Göreli bir yol belirtilirse
tam yol ServerRoot yönergesinde belirtilene
göreli olacaktır.
Örnek
DefaultRuntimeDir scratch/
DefaultRuntimeDir için öntanımlı yer derleme
sırasında DEFAULT_REL_RUNTIMEDIR #define satırı ile
değiştirilebilir.
Bilgi: ServerRoot bu yönergeden önce belirtilmiş
olmalıdır, aksi takdirde temel dizin için öntanımlı
ServerRoot kullanılır.
ServerRoot üzerindeki izinlerin düzgün olarak
nasıl ayarlanacağını öğrenmek için:
güvenlik ipuçları| Açıklama: | Değeri none olduğu takdirde, bu yönergenin bir
uyarı vermekten başka bir etkisi yoktur. Önceki sürümlerde, bu yönerge,
sunucunun ortam türünü saptayamadığı durumda göndereceği öntanımlı ortam
türünü belirlerdi. |
|---|---|
| Sözdizimi: | DefaultType |
| Öntanımlı: | DefaultType none |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | none değeri Apache httpd 2.2.7 ve sonrasında
mevcuttur. Diğer tüm seçenekler Apache httpd'nin 2.3.x ve sonraki sürümleri
için iptal edilmiştir. |
Bu yönerge iptal edilmiştir. Yapılandırma dosyalarının geriye
uyumluluğunu sağlamak için, öntanımlı bir ortam türünün olmadığını
belirten none değeriyle belirtilebilir. Örnek:
DefaultType None
DefaultType None sadece httpd-2.2.7 ve sonrasında
mevcuttur.
Ortam türlerini dosya uzantıları üzerinden yapılandırmak için
AddType yönergesini ve
mime.types yapılandırma dosyasını veya belli özkaynak
türleri için ortam türlerini yapılandırmak için ForceType yönergesini kullanın.
| Açıklama: | Bir değişken tanımlar |
|---|---|
| Sözdizimi: | Define |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Çekirdek |
| Modül: | core |
Tek değiştirgeli biçemi httpd’yi -D
seçeneğiyle çalıştırmaya eşdeğerdir. Bu yönerge, başlatma betiğinde
-D seçeneğinin argümanlarını değiştirme gereği duymaksızın
<IfDefine> bölümlerini
kullanıma sokmak için kullanılabilir.
Buna ek olarak, ikinci değiştirge belirtilirse yapılandırma değişkenine
bu değer atanır. Değişken yapılandırmada ${VAR} sözdizimi
ile kullanılabilir. Değişken daima küresel olarak tanımlı olup
yapılandırma bölümünü sarmalayan etki alanı ile sınırlanmaz.
<IfDefine TEST>
Define servername test.example.com
</IfDefine>
<IfDefine !TEST>
Define servername www.example.com
Define SSL
</IfDefine>
DocumentRoot "/var/www/${servername}/htdocs"
RewriteMap sözdizimi ile
karışmalardan kaçınmak için değişken isimleri ikinokta ":" karakterleri
içeremez.
Bu yönerge sanal konakta ve dizin içeriğinde desteklendiğinden yapılan değişiklikler (eşleşsin eşleşmesin) yönergeyi sarmalayan yapılandırma bölümünden başka, sonraki yapılandırma yönergelerine de görünür olur.
| Açıklama: | Sadece ismi belirtilen dosya sistemi dizininde ve bunun altdizinlerinde ve bunların içeriğinde uygulanacak bir yönerge grubunu sarmalar. |
|---|---|
| Sözdizimi: | <Directory |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
<Directory> ve
</Directory> sadece ismi belirtilen dosya sistemi
dizininde, bunun altdizinlerinde ve bu dizinlerin içindeki dosyalara
uygulanacak bir yönerge grubunu
sarmalamakta kullanılır. Bir dizin bağlamında kullanılabilecek her
yönergeye izin verilir. dizin-yolu bir dizinin tam yolu
olabileceği gibi Unix kabuk tarzı bir dosya ismi eşleştirme kalıbı da
olabilir. Kalıp dizgesinde, ? herhangi bir tek karakterle,
* herhangi bir karakter dizisiyle eşleşir. Ayrıca
[] karakter aralıkları da kullanılabilir. ‘/’ karakteri
ile hiçbir kalıp karakteri eşleşmez, bu bakımdan <Directory
"/*/public_html"> ile /home/user/public_html
değil, ama <Directory "/home/*/public_html">
eşleşecektir. Örnek:
<Directory "/usr/local/httpd/htdocs"> Options Indexes FollowSymLinks </Directory>
Dizin yollarında isterseniz önceleme kullanabilirsiniz, ancak eğer yol bazı boşluklar içeriyorsa mutlaka kullanmanız gerekir. Bir boşluk aksi belirtilmedikçe bir ifadenin sonunu belirlediğinden bu gereklidir.
dizin-yolu argümanlarını belirtirken dikkatli
olmalısınız: Apache httpd’nin dosyalara erişmekte kullandığı dosya
sistemi yolu ile bire bir eşleşmelidir. Belli bir
<Directory> dizinine uygulanan yönergeler, aynı
dizine farklı bir yoldan, örneğin başka bir sembolik bağ üzerinden
erişilen dosyalara uygulanmayacaktır.
~ karakterine ek olarak düzenli
ifadeler de kullanılabilir. Örnek:
<Directory ~ "^/www/[0-9]{3}">
</Directory>
yönergesi /www/ içindeki üç rakamdan oluşan dizinlerle
eşleşecektir.
Eğer çok sayıda (düzenli ifade olmayan) <Directory> bölümü, bir dosyayı içeren bir
dizinle veya üst dizinlerinden biri ile eşleşiyorsa, uygulama en kısa
eşleşmedeki yönergelerden başlayarak .htaccess dosyalarındaki yönergelere kadar
genişletilir. Örneğin,
<Directory "/"> AllowOverride None </Directory> <Directory "/home"> AllowOverride FileInfo </Directory>
bölümleri ile /home/web/dir/doc.html belgesine erişirken
şu aşamalardan geçilir:
AllowOverride None yönergesi uygulanır
(.htaccess dosyaları iptal edilir).AllowOverride FileInfo yönergesi uygulanır
(/home dizini için)./home/.htaccess,
/home/web/.htaccess ve
/home/web/dir/.htaccess dosyaları içindeki
FileInfo yönergeleri uygulanır.Normal bölümlerin tamamı uygulanıncaya kadar düzenli ifadeler değerlendirilmez. Düzenli ifadelerin tamamı yapılandırma dosyasında görüldükleri sıraya göre sınanırlar. Örneğin,
<Directory ~ "abc$"> # ... yönergeler burada ... </Directory>
düzenli ifadeli bölümü, tüm normal <Directory> bölümleri ve
.htaccess dosyaları uygulanıncaya kadar
değerlendirilmeyecektir. Düzenli ifadeleri değerlendirmeye sıra gelince
düzenli ifade /home/abc/public_html/abc ile eşleştirilecek
ve buna ilişkin <Directory>
uygulanacaktır.
<Directory "/"> için öntanımlı erişimin tüm
erişime izin vermek oluşuna dikkat ediniz. Bunu şöyle bir blokla
değiştirmeniz,
<Directory "/"> Require all denied </Directory>
ve erişilebilir olmasını istediğiniz dizinleri ayrıca belirtmeniz önerilir. Daha ayrıntılı bilgi edinmek için Güvenlik İpuçları belgesine bakınız.
Dizin bölümleri httpd.conf dosyasında yer alır.
<Directory> yönergeleri iç içe
olamazlar ve bir <Limit> veya <LimitExcept> bölümü içinde bulunamazlar.
| Açıklama: | Bir düzenli ifade ile eşleşen dosya sistemi dizinlerinin içeriklerine uygulanacak bir yönerge grubunu sarmalar. |
|---|---|
| Sözdizimi: | <DirectoryMatch |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
<DirectoryMatch> and
</DirectoryMatch> yönergeleri <Directory> gibi sadece ismi
belirtilen dosya sistemi dizininde ve içindeki dosyalarda uygulanacak
bir yönerge grubunu sarmalamakta kullanılır. Tek farkla argüman olarak
bir düzenli ifade alır. Örnek:
<DirectoryMatch "^/www/(.+/)?[0-9]{3}/">
# ...
</DirectoryMatch>
yönergesi /www/ içindeki (veya alt dizinlerindeki) üç
rakamdan oluşan dizinlerle eşleşecektir.
<Directory> gibi) alt dizinlere de uygulanırdı
ve satır sonu simgesi ($) ile eşleşemezdi. 2.3.9 ve sonrasında, sadece
ifade ile eşleşen dizinler sarmalanan yönerge grubundan etkilenmektedir.
2.4.8 itibariyle, isimli gruplar ve geriye başvurular elde edilmekte
olup ilgili isim büyük harfe çevrildikren sonra "MATCH_" ile
öncelendikten sonra ortama yazılmaktadır. Böylece yol elemanlarına
mod_rewrite gibi modüllerden veya düzenli ifadelerden başvurmak mümkün
kılınmıştır. Karışıklığı önlemek için, numaralı (isimsiz) geriye
başvurular yoksayılmaktadır. Bunların yerine isimli geriye başvurular
kullanılmalıdır.
<DirectoryMatch "^/var/www/combined/(?<sitename>[^/]+)">
require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</DirectoryMatch>
<Directory>
bölümlerindeki yönergelerle düzenli ifadelerin nasıl karıştırıldığının bir
açıklaması için <Directory> yönergesine bakınız.| Açıklama: | İstemciye görünür olan ana belge ağacının kök dizinini belirler. |
|---|---|
| Sözdizimi: | DocumentRoot |
| Öntanımlı: | DocumentRoot "/usr/local/apache/htdocs" |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
Bu yönerge httpd tarafından dosyalarının sunulacağı
dizini belirler. Alias
benzeri bir yönerge ile eşleşmedikçe, sunucu istenen URL’deki yolu,
belge yolu haline getirmek için belge kök dizinine ekler. Örnek:
DocumentRoot "/usr/web"
yapılandırması ile http://my.example.com/index.html
isteği /usr/web/index.html ile eşleştirilir.
dizin-yolu ile göreli dosya yolu belirtildiği takdirde belge
kök dizininin ServerRoot ile
belirtilen sunucu kök dizinine göre belirtildiği varsayılır.
DocumentRoot ile belirtilen dizin bir bölü
çizgisi ile bitirilmemelidir.
| Açıklama: | Önceki bir <If> veya <ElseIf> bölümünün koşulu, çalışma anında bir istek tarafından yerine getirilmediği takdirde uygulanacak yönergeleri içerir |
|---|---|
| Sözdizimi: | <Else> ... </Else> |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | İç içe geçmiş koşullar 2.4.26 ve sonrasında değerlendirilmeye alınır |
<Else> sadece ve sadece aynı etki
alanındaki en son <If> veya
<ElseIf> bölümü uygulanmamışsa
kapsadığı yönergeleri uygular. Örneğin:
<If "-z req('Host')">
# ...
</If>
<Else>
# ...
</Else>
Burada, <If> yönergesi
Host: başlıksız HTTP/1.0 istekleriyle eşleşirken <Else> Host: başlıklılarla
eşleşir.
<If><ElseIf><If>,
<ElseIf> ve
<Else> son olarak uygulanır.| Açıklama: | İçerdiği koşulun bir istek tarafınan sağlandığı ancak daha önceki bir <If> veya
<ElseIf> bölümlerininkilerin sağlanmadığı durumda kapsadığı yönergelerin uygulanmasını sağlar |
|---|---|
| Sözdizimi: | <ElseIf |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | İç içe geçmiş koşullar 2.4.26 ve sonrasında değerlendirilmeye alınır |
<ElseIf> kapsadığı yönergeleri
sadece ve sadece belirtilen koşulun doğrulandığı ancak aynı etki
alanında hemen önceki <If> veya
<ElseIf> yönergesinin uygulanmadığı
takdirde uygular. Örnek:
<If "-R '10.1.0.0/16'"> #... </If> <ElseIf "-R '10.0.0.0/8'"> #... </ElseIf> <Else> #... </Else>
<ElseIf> bir isteğin uzak adresi
10.0.0.0/8 ağına aitse ama 10.1.0.0/16 ağına ait değilse içerdiği
yönergelerin uygulanmasını sağlar.
<If><Else><If>,
<ElseIf> ve
<Else> son olarak uygulanır.| Açıklama: | Teslimat sırasında okunacak dosyalar için bellek eşlemeyi etkin kılar. |
|---|---|
| Sözdizimi: | EnableMMAP On|Off |
| Öntanımlı: | EnableMMAP On |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | none değeri Apache 2.2.7 ve sonrasında mevcuttur.
|
Bu yönerge, sunucunun teslimat sırasında gerektiği takdirde bir dosya
içeriğinin okunması için bellek eşleme kullanıp kullanmayacağını
belirler. Öntanımlı olarak, bir isteğin yerine getirilmesi,
mod_include kullanarak sunucu tarafından çözümlenen
bir dosyanın teslimatı sırasında olduğu gibi, bir dosya içindeki veriye
erişilmesini gerektirdiğinde Apache httpd, işletim sistemi tarafından
desteklendiği takdirde dosyayı belleğe eşler.
Böyle bellek eşleme kimi zaman başarım artışını beraberinde getirirse de bazen sorunlardan kaçınmak için bellek eşlemeyi kapatmak daha iyi sonuç verir:
httpd’nin başarımını düşürebilmektedir.httpd bellek eşlemli çalışırken bir dosyanın
silinmesi veya boyutunun küçültülmesi httpd'nin
parçalama arızası vererek çökmesine yol açabilir.Bu tür sorunlardan dolayı zarar görülebilecek sunucu yapılandırmalarında dosya teslimatında bellek eşlemlerinin kullanımını şu şekilde iptal etmeniz gerekir:
EnableMMAP Off
Bu özellik, sadece NFS dosya sistemi üzerinde sunulan dosyaları kapsamak üzere şu şekilde kolayca kapatılabilir:
<Directory "/nfs-dosyaları-yolu"> EnableMMAP Off </Directory>
| Açıklama: | Dosyaların istemciye tesliminde çekirdeğin dosya gönderme desteğinin kullanımını etkin kılar. |
|---|---|
| Sözdizimi: | EnableSendfile On|Off |
| Öntanımlı: | EnableSendfile Off |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Öntanımlı değer 2.3.9 sürümünde Off olarak değişti. |
Bu yönerge, dosya içeriğinin istemciye teslimi için
httpd’nin çekirdeğin dosya gönderme desteğini
kullanıp kullanmayacağını belirler. Öntanımlı olarak, bir isteğin
yerine getirilmesi, bir durağan dosyanın teslimatı sırasında olduğu
gibi, bir dosya içindeki veriye erişilmesini gerektirmediği takdirde
Apache httpd, işletim sistemi tarafından destekleniyorsa dosyayı
istemciye teslim etmek için çekirdeğin dosya gönderme özelliğini
kullanır.
Çekirdeğin dosya gönderme mekanizması, okuma, gönderme ve tampon ayırma işlemlerini ayrı ayrı yapmaktan kaçınır. Fakat bazı platformlarda veya bazı dosya sistemlerinde aşağıda belirtilen işlemsel sorunlardan kaçınmak için bu özelliği iptal etmek daha iyidir:
sendfile) 2GB’tan büyük dosyalarla çalışamamaktadır.DocumentRoot ağ dosya sistemi
(NFS, SMB, CIFS, FUSE gibi) üzerinde olduğu durumda çekirdek ağ
dosyalarını kendi arabelleği üzerinden sunamayabilir.Bu sorunlardan muzdarip sunucu yapılandırmaları için bu özelliği şöyle etkin kılabilirsiniz:
EnableSendfile On
Bu özellik, sadece bir ağ dosya sistemi üzerinde sunulan dosyaları kapsamak üzere şu şekilde kolayca kapatılabilir:
<Directory "/nfs-dosyaları-yolu"> EnableSendfile Off </Directory>
EnableSendfile yönergesinin .htaccess ve
diziniçi yapılandırmalarının mod_cache_disk tarafından
desteklenmediğini lütfen aklınızdan çıkarmayın.
EnableSendfile yönergesinin sadece küresel
tanımları hesaba katılır.
| Açıklama: | Özel bir hata iletisiyle yapılandırma çözümlemesini durdurur |
|---|---|
| Sözdizimi: | Error |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.3.9 ve sonrası |
Yapılandırmada bir hatanın saptanması istenirse, bu yönerge yapılandırma çözümlemesinin durdurulması ve özel bir hata iletisi üretilmesi için kullanılabilir. Genelde kullanıldığı durum, gerekli modüllerin yapılandırmada bulunmadığının raporlanmasıdır.
# Örnek # mod_include yüklü değilse bilelim <IfModule !include_module> Error "Hata: mod_include mod_foo için gerekiyor. LoadModule ile yükleyin." </IfModule> # SSL veya NOSSL tanımlı mı bilelim <IfDefine SSL> <IfDefine NOSSL> Error "Ne SSL ne de NOSSL tanımlı. Sadece biri tanımlı olsa yeter." </IfDefine> </IfDefine> <IfDefine !SSL> <IfDefine !NOSSL> Error "Ya SSL ya da NOSSL tanımlı olmalı." </IfDefine> </IfDefine>
Bu yönerge, çalışma zamanında değil, yapılandırma işlemi sırasında
değerlendirilir. Sonuç olarak, bu yönerge bir <If> bölümü içine alınarak koşullu olarak
değerlendirilemez.
| Açıklama: | Bir hata durumunda sunucunun istemciye ne döndüreceğini belirler. |
|---|---|
| Sözdizimi: | ErrorDocument |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
Bir sorun çıktığında veya hata oluştuğunda Apache httpd şu dört işlemden birini yapacak şekilde yapılandırılabilir:
URL-yoluna dahili bir
yönlendirme yapılır.URL-yoluna
yönlendirme yapılır.İlk seçenek öntanımlıdır. Diğer üç seçenek
ErrorDocument yönergesinin argümanları (hata
kodundan sonra bir URL veya hata iletisi) ile belirtilir. Apache httpd
bazı durumlarda sorun/hata ile ilgili ek bilgi verecektir.
2.4.13 itibariyle, özdevinimli dizgeler ve URLler üretmek için yönerge içinde ifade sözdizimi kullanılabilir.
URL’ler yerel yollarda (DocumentRoot’a göre) bir bölü çizgisi (/) ile
başlatılabileceği gibi istemci tarafından çözümlenecek tam bir URL
şeklinde de belirtilebilir. Bunlar yerine, tarayıcıda gösterilmek üzere
bir ileti de belirtilebilir. Örnekler:
ErrorDocument 500 http://example.com/cgi-bin/server-error.cgi
ErrorDocument 404 /errors/bad_urls.php
ErrorDocument 401 /subscription_info.html
ErrorDocument 403 "Kusura bakmayın, bugün hizmet veremiyoruz."
ErrorDocument 403 /errors/forbidden.pl?referrer=%{escape:%{HTTP_REFERER}}
Bunlardan başka, Apache httpd’nin kendi hata iletilerinin kullanılacağı
özel default değeri ile belirtilebilir. Normal şartlar
altında gerekmese de, bir şey belirtilmediği takdirde mevcut bir
ErrorDocument yönergesini miras alan
yapılandırmalarda Apache httpd’nin kendi hata iletilerinin kullanımı
default değeri açıkça belirtilerek örnekteki gibi
zorlanabilir:
ErrorDocument 404 /cgi-bin/bad_urls.pl <Directory "/web/docs"> ErrorDocument 404 default </Directory>
ErrorDocument yönergesinde bir uzak URL (önünde
http bulunan bir yol) belirtildiğinde, belge aynı sunucuda
olsa bile, Apache HTTP Sunucusunun istemciye belgeyi bulacağı yer için bir
yönlendirme göndereceğine dikkat ediniz. Bunun bazı istenmeyen etkileri
vardır; en önemlilerinden biri istemcinin hata kodu yerine bir
yönlendirme durum kodu alacak olmasıdır. Bu, bir URL’nin geçerliliğini
durum koduna göre saptayan istemciler veya robotlar için yanıltıcı
olacaktır. Buna ek olarak, ErrorDocument 401 için bir uzak
URL belirttiğiniz durumda istemci 401 durum kodunu almayacağı için
kullanıcıdan parola isteğinde bulunamayacaktır. Bu bakımdan,
ihtiyaç duyduğunuz takdirde, ErrorDocument 401
yönergesine yerel bir belge belirtmelisiniz.
Sunucunun ürettiği hata iletileri "çok kısa" olduğu takdirde, Microsoft Internet Explorer (MSIE) öntanımlı olarak bu hata iletilerini yoksayar ve bunun yerine kendi "kullanıcı dostu" hata iletilerini kullanır. "Çok kısa" eşiği duruma göre değişmekle birlikte, genellikle, hata iletileriniz 512 bayttan büyük olduğu takdirde MSIE kendi hata iletileri yerine sunucunun ürettiği hata iletilerini gösterecektir. Bu konuda daha fazla bilgiyi Q294807 kodlu Microsoft Knowledge Base makalesinde bulabilirsiniz.
Çoğu yerleşik hata iletisi özel iletilerle değiştirilebilse de bazı
durumlarda ErrorDocument ile ne
belirtildiğine bakılmaksızın yerleşik hata iletileri kullanılır.
Özellikle, bozuk bir istek saptandığında normal istek işleme hemen
devre dışı bırakılır ve yerleşik hata iletisi döndürülür. Bu, hatalı
istekler yaparak güvenlik sorunlarına yol açılmak istenmesi
durumlarında gereklidir.
mod_proxy kullanıyorsanız,
ProxyErrorOverride yönergesini
etkin kılmak isteyebilirsiniz, böylece asıl sunucular adına özel hata
iletileri üretebilirsiniz. ProxyErrorOverride etkin
kılınmak istenmezse, Apache httpd vekalet edilen içerik için özel hata
belgeleri üretmeyecektir.
| Açıklama: | Sunucunun hata günlüğünü tutacağı yeri belirler. |
|---|---|
| Sözdizimi: | ErrorLog |
| Öntanımlı: | ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows ve OS/2) |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
ErrorLog yönergesi sunucunun saptadığı hataları
kaydedeceği dosyanın ismini belirtmek için kullanılır.
dosya-yolu ile göreli dosya yolu belirtildiği takdirde
dizininin ServerRoot ile
belirtilen sunucu kök dizinine göre belirtildiği varsayılır.
ErrorLog "/var/log/httpd/error_log"
dosya-yolu bir boru imi "|" ile başlatıldığı
takdirde hata iletilerinin hata günlüğünü işleme sokacak komuta
borulanacağı varsayılır.
ErrorLog "|/usr/local/bin/httpd_errors"
Daha fazla bilgi için borulu günlüklere bakınız.
Dosya adı yerine syslog kullanılırsa, sistem desteklediği
takdirde günlük kaydı syslogd(8) üzerinden yürütülür. Öntanımlı olarak
local7 syslog oluşumu kullanılır. Bunu
syslog: sözdizimini kullanarak
değiştirebilirsiniz. Buradaki oluşumoluşumetikethttpd kullanılır. Öntanımlı etiketi
syslog:: sözdizimini kullanarak
değiştirebilirsiniz etiket
ErrorLog syslog:user ErrorLog syslog:user:httpd.srv1 ErrorLog syslog::httpd.srv2
GÜVENLİK: Günlük dosyalarının saklandığı dizin, sunucuyu başlatan kullanıcı dışındakiler tarafından yazılabilir olduğu takdirde güvenliğinizin nasıl tehlikeye gireceği güvenlik ipuçları belgesinde ayrıntılı olarak açıklanmıştır.
Unix-dışı platformlarda dosya yolunu girerken, platform ters bölü çizgilerini desteklese bile normal bölü çizgileri kullanmaya özen göstermelisiniz. Genel olarak, dosya yollarını belirtirken yapılandırma dosyası boyunca normal bölü çizgisi kullanmak her zaman daha iyidir.
| Açıklama: | Hata günlüğü girdileri için biçem belirtimi |
|---|---|
| Sözdizimi: | ErrorLogFormat [connection|request] |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
ErrorLogFormat yönergesi, hata günlüğünde asıl
hata iletisine ek olarak günlüklenecek ek bilgiyi belirtmek için
kullanılabilir.
#Basit örnek ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"
İlk değiştirge olarak connection veya request
belirtilmesi ek biçemlerin belirtilebilmesini sağlar. Böylece, belli bir
bağlantı ya da istek için ilk ileti günlüklendiğinde ek bilgininde
günlüklenmesi sağlanır. Bu ek bilgi sadece bağlantı/istek başına bir
kere günlüklenir. herhangi bir günlük iletisine sebep olmadan işlenmişse
ek bilgi de günlüklenmez.
Bu, bazı biçem dizgesi öğeleri çıktı üretmediğinde olur. Örneğin,
Referer başlığı sadece günlük iletisi bir istekle
ilişkilendirilmişse mevcuttur ve hata iletisi Referer
başlığı istemcide okunduğu anda oluşur. Eğer bir çıktı üretilmezse,
öntanımlı davranış önceki boşluk karakterinden sonraki boşluk
karakterine kadar herşeyi silmektir. Yani, günlük satırı örtük olarak
boşluklarla ayrılmış alanlara bölünür. Bir biçem dizgesi öğesi çıktı
üretmezse alanın tamamı çıktılanmaz. Örneğin, [%t] [%l] [%a]
%M günlük biçeminde uzak adres %a
kullanılamazsa sarmalayıcı köşeli ayraçlar da günlüklenmeyecektir.
Boşluk karakterleri ters bölülerle öncelenerek bir alanı sınırlaması
önlenebilir. '% ' (yüzde boşluk) çifti sıfır genişlikte bir alan
ayracı olup herhangi bir çıktı üretmez.
Yukarıdaki davranış, biçem dizgesi öğesine değiştirciler eklenerek
değiştirilebilir. - (tire) değiştircisi ilgili öğe bir
çıktı üretmediğinde tire iminin günlüklenmesine sebep olur.
Bağlantı/istek başına bir kere biçemlerinde + (artı)
değiştircisini de kullanmak mümkündür.Artı değiştiricili bir öğe
herhangi bir çıktı üretmezse satırın tamamı günlüklenmez.
Bir biçem öğesine günlük önem derecesi atamak için değiştirici olarak bir sayı kullanılabilir. Bu öğenin günlüklenebilmesi için günlük iletisinin önem derecesinin belirtilen günlük önem derecesinden daha yüksek olmaması gerekir. Sayı 1'den (alarm) 4'e (uyarı) ve 7'den (hata ayıklama) 15'e (trace8) kadar olabilir.
Örneğin, Referer istek başlığını günlükleyen
%{Referer}i dizgeciğine değiştirciler eklendiğinde neler
olduğunu burada görebilirsiniz:
| Değiştirlen Dizgecik | Anlamı |
|---|---|
%-{Referer}i |
Referer atanmamışsa bir - günüklenir. |
%+{Referer}i |
Referer atanmamışsa satırın tamamı çıktılanmaz. |
%4{Referer}i |
Sadece hata iletisinin önemi 4'ten yüksek olduğu durumda
Referer günlüklenir. |
Bazı biçem dizfesi öğeleri ayraç içine alınmış ek değiştirgeler kabul eder.
| Biçem Dizgesi | Açıklama |
|---|---|
%% |
Yüzde imi |
%a |
İstekteki istemci IP adresi ve portu |
%{c}a |
Bağlantının emsal IP adresi and portu
(mod_remoteip modülüne bakın) |
%A |
Yerel IP adresi ve portu |
%{isim}e |
İstek ortam değişkeni isim |
%E |
APR/OS hata durum kodu ve iletisi |
%F |
Günlük çağrısının kaynak dosya ismi ve satır numarası |
%{isim}i |
İstek başlığı isim |
%k |
Bağlantıdaki keep-alive isteklerinin sayısı |
%l |
İletinin günlük seviyesi |
%L |
İsteğin günlük kimliği |
%{c}L |
Bağlantının günlük kimliği |
%{C}L |
Bağlantı etki alanında kullanılmışsa bağlantının günlük kimliği, aksi takdirde boş |
%m |
İletiyi günlükleyen modülün ismi |
%M |
Asıl günlük iletisi |
%{isim}n |
istek notu isim |
%P |
Geçerli sürecin süreç kimliği (PID'i) |
%T |
Geçerli evrenin evre kimliği |
%{g}T |
Geçerli evrenin eşsiz sistem evre kimliği (örn, top
tarafınan gösterilenle aynı kimlik: şimdilik sadece Linux'a
özgü) |
%t |
geçerli zaman |
%{u}t |
Mikro saniyeler dahil geçerli zaman |
%{cu}t |
ISO 8601 biçemiyle uyumlu mikro saniyeleri de içeren geçerli zaman |
%v |
Geçerli sunucunun kurallı ServerName |
%V |
UseCanonicalName ayarına
uygun olarak isteği sunan sunucunun sunucu ismi |
\ (tersbölü boşluk) |
Alan ayracı olmayan boşluk |
% (yüzde boşluk) |
Alan ayracı (çıktısız) |
The log ID format %L günlük kimliği biçemi bağlantı veya
istek için eşsiz bir kimlik üretir. Bu, bağlantı üzerinden gelen istek
durumunda günlük satırlarının ait olduğu bağlantı veya isteği
bağdaştırmak için kullanılabilir. %L biçem dizgesi ayrıca
mod_log_config modülünde erişim günlüğü iletilerini
hata günlüğü iletileriyle ilişklendirmek için de kullanılabilmektedir.
mod_unique_id modülü yüklüyse onun eşsiz kimliği
istekler için günlük kimliği olarak kullanılacaktır.
#Örnek (Evreli MPM'ler için öntanımlı biçim)
ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"
Bunun hata iletilerindeki sonuçları şöyle olabilir:
[Thu May 12 08:28:57.652118 2011] [core:error] [pid 8777:tid 4326490112] [client ::1:58619] File does not exist: /usr/local/apache2/htdocs/favicon.ico
Dikkat edin, yukarıda açıklandığı gibi, bazı alanlar tanımlanmadıklarından tamamen yoksayılır.
#Örnek (2.2.x biçimine benzer)
ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"
#İstek/bağlantı günlük kimlikli gelişkin bir örnek
ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"
ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"
ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"
ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"
ErrorLogFormat connection "[%{uc}t] [C:%{c}L] remote\ %a local\ %A"
| Açıklama: | Her istekte ek durum bilgisinin izini sürer |
|---|---|
| Sözdizimi: | ExtendedStatus On|Off |
| Öntanımlı: | ExtendedStatus Off[*] |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
Bu yönerge, o an işlenmekte olan istek hakkında evre başına ek veriyi
ve kullanım özetini izler; mod_status modülünü
yapılandırarak bu değişkenleri çalışma anında görebilirsiniz. Diğer
modüllerin bu sonuçlara bel bağlayabileceğini unutmayın.
Bu ayarlar sunucunun tamamına uygulanır ve bir sanal konakta etkin başka bir sanal konakta etkisiz kılınamaz. Ek durum bilgisinin toplanması sunucuyu yavaşlatabilir. Ayrıca, bu ayarın nazikçe yeniden başlatma sırasında değiştirilemeyeceğine dikkat ediniz.
Diğer üçüncü parti modüller aynısını yaparken
mod_status modülünün yüklenmesi ExtendedStatus
On için öntanımlı davranışı değiştirecektir. Böyle modüller,
tüm evrelerin durumu hakkında ayrıntılı bilgi toplanmasına bel bağlar.
Öntanımlı değer sürüm 2.3.6 itibariyle mod_status
tarafından değiştirilmiştir. Önceki sürümlerde öntanımlı değer daima
Off idi.
| Açıklama: | Duruk dosyalar için ETag HTTP yanıt başlığını oluşturmakta kullanılacak dosya özniteliklerini belirler. |
|---|---|
| Sözdizimi: | FileETag |
| Öntanımlı: | FileETag MTime Size |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.3.14 ve öncesinde öntanımlı değer "INode MTime Size" idi. |
FileETag yönergesi, belge bir duruk dosyaya
dayandığı takdirde ETag (Entity Tag - öğe etiketi
kısaltması) yanıt başlığı alanını oluşturmakta kullanılacak dosya
özniteliklerini yapılandırır. (ETag değeri, ağ band
genişliğinden kazanmak için arabellek yönetiminde kullanılır.)
FileETagyönergesi ne kullanılması gerektiğini
belirleyebilmenizi sağlar. Değer olarak belirtilebilecek anahtar
sözcükler şunlardır:
FileETag INode MTime Size
ETag alanı dosyanın özeti
alınarak hesaplanır.ETag
alanı dahil edilmez.Öntanımlı ayarları miras alıp bunların kapsamını genişletmek/daraltmak
için INode, MTime, Size ve
Digest anahtar sözcüklerinin önüne + veya
- imi konabilir. Bu imlerin bulunmadığı bir anahtar
sözcüğün varlığı halinde hiçbir değer miras alınmaz.
Eğer bir dizinin yapılandırması
FileETag INode MTime Size ve alt dizini
FileETag -INode içeriyorsa bu alt dizinin (ve bir
geçersizleştirme olmadığı takdirde onun alt dizinlerinin) ayarları
FileETag MTime Size yapılandırmasına eşdeğer
olacaktır.
FileETag,
MTime, Size ve Digest değerleri
değişmeksizin yanıt öğesi değişebileceğinden mod_include
tarafından çözümlenen yanıtlar için bir ETag üretilmez.
| Açıklama: | Dosya isimleriyle eşleşme halinde uygulanacak yönergeleri içerir. |
|---|---|
| Sözdizimi: | <Files |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
<Files> yönergesi, içerdiği
yönergelerin etki alanını dosya isimlerine göre sınırlandırır.
<Directory> ve
<Location> bölümleri
ile karşılaştırılabilir. Bir </Files> yönergesi ile
sonlandırılması gerekir. Bu bölüm içinde belirtilen yönergeler,
<Files> yönergesinde belirtilen
dosya-adı’nın son bileşeniyle (dizinler atıldıktan sonda
kalan dosya ismi) eşleşen nesnelere uygulanır. <Files> bölümleri yapılandırma dosyasında,
<Directory> bölümleri
ve .htaccess dosyaları okunduktan sonra fakat <Location> yönergelerinden önce
göründükleri sıraya göre işleme sokulurlar. <Files> bölümlerinin <Directory> bölümlerinin içinde uygulama
alanını sınırlamak amacıyla kullanılabileceğine dikkat ediniz.
dosya-adı argümanının bir dosya ismi veya bir dosya ismi
kalıbı içermesi gerekir. Bir dosya ismi kalıbındaki her ?
imi bir karakterle eşleştirilirken * imi karakter dizileri
ile eşleştirilir.
<Files "zat.html">
# zat.html dosyasına uygulanacakları buraya koy
</Files>
<Files "?at.*">
# Buradakiler hat.html, kat.html, tat.html ve benzerlerine uygulanır.
</Files>
~ imine ek olarak düzenli ifadeler de kullanılabilir. Örneğin
<Files ~ "\.(gif|jpe?g|png)$">
#...
</Files>
satırı en bilinen resim dosyası biçimleriyle eşleşecektir. Bunun
yerine <FilesMatch>
yönergesi de tercih edilebilirdi.
<Directory> ve
<Location>
bölümlerinin aksine, <Files>
bölümleri .htaccess dosyaları içinde kullanılabilir. Bu
sayede kullanıcıların kendi dosyalarına erişimi dosya seviyesinde
denetlemelerine imkan sağlanmış olur.
| Açıklama: | Düzenli ifadelerin dosya isimleriyle eşleşmesi halinde uygulanacak yönergeleri içerir. |
|---|---|
| Sözdizimi: | <FilesMatch |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
<FilesMatch> yönergesi, içerdiği
yönergelerin etki alanını <Files> yönergesinin yaptığı gibi dosya
isimlerine göre sınırlandırır. Ancak, argüman olarak bir düzenli ifade kabul eder. Örneğin
<FilesMatch "\.(gif|jpe?g|png)$">
# ...
</FilesMatch>
satırı en bilinen resim dosyası biçimleriyle eşleşecektir.
.+
.pngveya .gif dosyalarının, örnek olarak,
eşleşmemesini garanti eder.2.4.8 itibariyle, isimli gruplar ve geriye başvurular elde edilmekte
olup ilgili isim büyük harfe çevrildikren sonra "MATCH_" ile
öncelendikten sonra ortama yazılmaktadır. Böylece yol elemanlarına
mod_rewrite gibi modüllerden veya düzenli ifadelerden başvurmak mümkün
kılınmıştır. Karışıklığı önlemek için, numaralı (isimsiz) geriye
başvurular yoksayılmaktadır. Bunların yerine isimli geriye başvurular
kullanılmalıdır.
<FilesMatch "^(?<sitename>[^/]+)">
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</FilesMatch>
| Açıklama: | Ağa akıtılacak azami ardışık yanıt sayısı |
|---|---|
| Sözdizimi: | FlushMaxPipelined |
| Öntanımlı: | FlushMaxPipelined 5 |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.4.47 ve sonrası |
Bu yönerge, ardışık düzenli istek alındığı sürece beklemede kalan azami ardışık yanıt sayısını yapılandırmaya izin verir. Sınıra ulaşıldığında, yanıtlar tekrar sınırın altına inene kadar engelleme kipinde ağa zorla boşaltılır.
FlushMaxPipelined, bellek kullanımını
kısıtlamaya yardımcı olur. 0 olarak ayarlandığında ardışık
düzen devre dışı bırakılır, -1 olarak ayarlandığında sınır
yoktur (FlushMaxThreshold hala geçerlidir).
| Açıklama: | Bekleyen verilerin ağa boşaltılacağı eşik değer |
|---|---|
| Sözdizimi: | FlushMaxThreshold |
| Öntanımlı: | FlushMaxThreshold 65536 |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.4.47 ve sonrası |
Bu yönerge, bekleyen çıktı verileri için eşiği (bayt cinsinden) yapılandırmaya izin verir. Sınıra ulaşıldığında, veriler tekrar sınırın altına inene kadar engelleme kipinde ağa zorla boşaltılır.
FlushMaxThreshold, bellek kullanımını kısıtlamaya
yardımcı olur. 0'a veya çok küçük bir değere ayarlandığında,
gerçekte hiç bekleyen veri yoktur, ancak iş parçacıklı MPM'ler için ağı
bekleyen daha fazla iş parçacığı olabilir, dolayısıyla diğer eşzamanlı
bağlantıları işlemek için daha az sayıda kullanılabilir.
| Açıklama: | Bütün dosyaların belirtilen ortam türüyle sunulmasına sebep olur. |
|---|---|
| Sözdizimi: | ForceType |
| Bağlam: | dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache httpd 2.0’da core modülüne taşındı. |
Bu yönerge, bir .htaccess dosyası veya bir
<Directory>,
<Location> veya
<Files> bölümüne
yerleştirildiği zaman, eşleşen tüm dosyaların ortam-türü ile
belirtilen içerik türüyle sunulmasına sebep olur. Örneğin, altında
sadece GIF dosyaları bulunan bir dizininiz varsa ve bunlara tek tek
.gif uzantısı belirtmek istemiyorsanız şu yapılandırmayı
kullanabilirsiniz:
ForceType image/gif
Bu yönerge, AddType yönergesi
üzerinden ve mime.types dosyasında örtük olarak
tanımlanmış ortam türü/dosya uzantısı ilişkilerini geçersiz kılar.
Ayrıca, daha genel ForceType ayarlarını da
None değeriyle geçersiz kılabilirsiniz:
# tüm dosyaların image/gif olarak sunulması için: <Location "/images"> ForceType image/gif </Location> # normal MIME-türüne geri dönmek için: <Location "/images/mixed"> ForceType None </Location>
Bu yönerge, öncelikle dosya sisteminden sunulan duruk dosyalar için
üretilen içerik türlerini geçersiz kılar. Duruk dosyaların haricindeki
özkaynaklar için yanıt üretecinin genelde bir Content-Type
belirttiği durumda bu yönerge etkisizdir.
SetHandler veya
AddHandler gibi örtük yönergeler
geçerli isteğe uygulanmadığı takdirde, normalde bu yönergeler tarafından
belirlenen dahili eylemcinin ismi ForceType
yönergesi tarafından belirtilen içerik türü ile eşleşecek şekilde
belirlenir. Bu, bazı üçüncü parti modüller (mod_php gibi) tarafından
kullanılan tarihi bir uygulama olup, bu modüller istekle eşleşecek
modüllerin sorumluluğu almasını sağlamak için "sihirli" içerik türleri
kullanabilir. Bu tür "sihirli" içerik türlerini kullanan
yapılandırmalarda SetHandler veya
AddHandler kullanımından
kaçınılmalıdır.
| Açıklama: | gmon.out ayrıntılı inceleme verisinin yazılacağı dizin |
|---|---|
| Sözdizimi: | GprofDir |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
Sunucu gprof ayrıntılı inceleme desteği ile derlenmişse,
GprofDir yönergesi gmon.out
dosyalarının süreç çıktığında belirtilen dizine yazılmasını sağlar. Eğer
değiştirge bir yüzde simgesi ('%') ile bitiyorsa her süreç kimliği için
alt dizinler oluşturulur.
Bu yönerge şimdilik sadece prefork MPM'i ile
çalışmaktadır.
| Açıklama: | İstemci IP adresleri üzerinde DNS sorgularını etkin kılar. |
|---|---|
| Sözdizimi: | HostnameLookups On|Off|Double |
| Öntanımlı: | HostnameLookups Off |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Çekirdek |
| Modül: | core |
Bu yönerge oturum açabilecek konak isimlerini tespit edebilmek için
DNS sorgularını etkin kılar (ve sonuç REMOTE_HOST’ta
belirtilerek CGI/SSI’lere aktarılır). Double değeri
sorgunun çift yönlü yapılacağını belirtir. Yani, bir tersine sorgunun
ardından bir normal sorgu yapılır. Normal sorguda elde edilen IP
adreslerinden birinin istek yapan IP adresi ile eşleşmesi gerekir.
("tcpwrappers" terminolojisinde buna PARANOID adı
verilir.)
Konak ismine göre erişimi denetlemek için
mod_authz_host kullanıldığında, nasıl bir ayar
yapıldığına bakılmaksızın, çift yönlü sorgulama yapılır. Bu güvenlik
için gereklidir. Bunun dışında açıkça HostnameLookups
Double belirtilmedikçe genellikle çift yönlü sorgulama yapılmaz.
Örneğin, sadece HostnameLookups On belirtilmiş ve konak
ismi kısıtlamalarıyla korunmuş bir nesne için bir istek yapılmışsa çift
yönlü sorgunun başarısına bakılmaksızın CGI’lere
REMOTE_HOST olarak tek yönlü sorgu sonucu aktarılır.
Gerçekte ters yönlü sorguya gerek duyulmayan sitelerde ağ trafiğini
yormamak için Off, öntanımlı değerdir. Ayrıca, son
kullanıcıların DNS sorguları nedeniyle gereksiz yere bir beklemeye
maruz kalmaması için de bu daha iyidir. Yükü zaten ağır olan sitelerde,
DNS sorgularının görece uzun zaman alması nedeniyle bu yönergenin
değeri Off olarak bırakılmalıdır. Öntanımlı olarak kurulum
dizininizin bin alt dizinine kurulan
logresolve uygulaması kullanılarak oturum açan IP
adresleri için isim sorguları çevrim dışıyken yapılabilir.
Son olarak, konak ismine dayalı
Require yönergelerine sahipseniz konak ismi araması
HostnameLookups ayarına bakılmaksızın
gerçekleştirilecektir.
| Açıklama: | HTTP İstek İletilerindeki sınırlamalarda değişiklik yapar |
|---|---|
| Sözdizimi: | HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods]
[Allow0.9|Require1.0] |
| Öntanımlı: | HttpProtocolOptions Strict LenientMethods Allow0.9 |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.2.32 veya 2.4.24 ve sonrası |
Bu yönerge HTTP istek satırına
(RFC 7230 §3.1.1) ve the HTTP istek başlığı alanlarına
(RFC 7230 §3.2) uygulanmış kuralları öntanımlı olarak veya
Strict seçeneği kullanılarak değiştirir. Eski modüller,
uygulamalar veya kullanımı önerilmeyen özel istemciler için eski davranışlara
dönmeyi sağlamak üzere Unsafe seçeneği eklenmiştir.
Bu kurallar istek işlenmeden önce uygulanır. Dolayısıyla yönerge, IP/port arabirimine göre ana bölümde veya öntanımlı (ilk) eşleşen sanal konak bölümünde yapılandırılmalıdır.
Bu yönergeye aşağıdaki parametrelerden seçilen üç tanesi uygulanabilir. Belirtilmeyenlerin yerine öntanımlılar uygulanır.
Bu yönerge devreye girmeden önce, Apache HTTP Sunucusunun istek iletisi
ayrıştırıcıları protokolle uyumlu olmayan bir dizi girdi şekline
toleranslıydı. RFC 7230 §9.4 İstek bölme ve
§9.5 Yanıt kaçırma çağrıları uyumsuz istek iletilerinin
kabulündeki olası risklerden yalnızca iki tanesidir.
RFC 7230
§3.5 "İleti Ayrıştırma Sağlamlığı" belirsiz boşlukların kabul ve
istek iletisi biçimleme risklerini tanımlar. Bu yönergenin devreye
girmesini takiben belirtimin tüm imla kurallarına öntanımlı
Strict işlem kipi ve 3.5 bölümünde tavsiye edilen hoşgörüsüz
boşluk uygulanır ve esnekliğe müsamaha edilmez.
Kullanıcılar, özellikle dışa bakan, herkes tarafından erişilebilen
sunucu konuşlandırmalarında Unsafe işlem kipine geçiş
yapmaya karşı kesinlikle uyarılır. Eğer bir arayüz hataları izlemek
veya bir intranette çalışan özel hizmet tüketicileri için gerekliyse,
kullanıcılar, sadece, dahili özel ağlarına hizmet etmek üzere
yapılandırılmış özel bir sanal konak üzerinde Unsafe işlem
kipine geçiş yapmalıdır.
# Eksik CRLF
GET / HTTP/1.0\n\n
Bazı araçların CRLF kullanmaya zorlanması gerekir, aksi takdirde httpd yukarıdaki örnekte belirtildiği gibi bir HTTP 400 yanıtı ile döner. Örneğin, OpenSSL s_client düzgün çalışmak için -crlf değiştirgesine ihtiyaç duyar.
CRLF yokluğu gibi durumları saptamak için HTTP isteğini görünümlemek
isterseniz DumpIOInput
yönergesi yardımcı olabilir.
RFC 7231
§4.1 "İstek Yöntemleri" "Genel Bakış" bölümlerinde bir istek
satırında desteklenmeyen bir yöntem saptadığında özgün sunucuların bir
hatayla yanıt vermesini gerekli görmüştür. LenientMethods
seçeneği kullanıldığında olan zaten budur. RegisteredMethods
seçeneğine geçiş yapmak isteyen yöneticiler
RegisterHttpMethod yönergesini kullanarak standart
olmayan yöntemleri belirlemelidir. Özellikle Unsafe seçeneğine
geçiş yapılacaksa bu yol izlenmelidir.
Özgün sunucunun kullandığı yöntemleri vekil sunucu bilemeyeceği için
ileri vekil konaklarda RegisteredMethods seçeneğine geçiş
yapılmamalıdır.
# Unknown HTTP method
WOW / HTTP/1.0\r\n\r\n
# Lowercase HTTP method
get / HTTP/1.0\r\n\r\n
RFC 2616
§19.6 "Önceki Sürümlerle Uyumluluk" bölümünde HTTP sunucularının
eski HTTP/0.9 isteklerini desteklemesi tavsiye edilmektedir. RFC 7230
"HTTP/0.9 isteklerini destekleme beklentisi kaldırılmıştır." cümlesiyle
bunu geçersiz kılmış ve RFC 7230 Ek A bölümünde bununla ilgili yorumlar yer almıştır.
Require1.0 seçeneği kullanıcıya öntanımlı
Allow0.9 seçeneğinin davranışına verilen desteği kaldırma
imkanını vermektedir.
# Desteklenmeyen HTTP sürümü
GET /\r\n\r\n
LogLevel debug seviyesiyle
yapılandırılmış ErrorLog ile kaydedilmiş günlüklerin
gözden geçirilmesi, böyle hatalı isteklerin kaynaklandıkları yerle birlikte
belirlenmesine yardımcı olabilir. Kullanıcılar, beklenmedik bir şekilde
reddedilmiş geçersiz istekleri bulmak için erişim günlüklerindeki 400
yanıtlarına özellikle dikkat etmelidir.
| Açıklama: | Çalışma anında bir koşul bir istek tarafından yerine getirildiği takdirde uygulanacak yönergeleri barındırır. |
|---|---|
| Sözdizimi: | <If |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | İç içe geçmiş koşullar 2.4.26 ve sonrasında değerlendirilmeye alınır |
<If> yönergesi bir ifadeyi çalışma
anında değerlendirir ve ifadenin sonucu doğru olduğu takdirde içerdiği
yönergeleri uygular. Örnek:
<If "-z req('Host')">
Bir Host: başlığı içermeyen HTTP/1.0 istekleriyle
eşleşir. İfadeler, dizge karşılaştırması (==,
!=, <, ...), tamsayı karşılaştırması
(-eq, -ne, ...) ve diğerleri (-n,
-z, -f, ...) için kabuktakilere benzer çeşitli
işleçler içerebilir. Ayrıca, düzenli ifadeleri,
<If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/">
kabuk tarzı kalıp eşleştirme ve birçok başka işlemi kullanmak da
mümkündür. Bu işlemler istek başlıklarında (req), ortam
değişkenlerinde (env) ve çok sayıda başka niteliklerin
üstünde yapılabilir. Apache HTTP Sunucusundaki
İfadeler belgesinde daha ayrıntılı bilgi bulabilirsiniz.
Bu yapılandırma bölümünün içinde sadece dizin bağlamını destekleyen yönergeler kullanılabilir.
CONTENT_TYPE gibi belli
değişkenler ve diğer yanıt başlıkları zaten yorumlanmış olacaklarından bu
yönerge için kullanılabilir olmayacaktır.
Define,
Include ve Error gibi
yapılandırma ayrıştırılırken etkili olan yönergeler, bir <If> yapılandırma bölümü içine alınarak koşullu
hale getirilemez. Bu bölümler, çalışma anında nasıl değerlendirildiklerine
bakılmaksızın, her zaman yapılandırmanın bir parçasıdır.
<ElseIf><Else><If>,
<ElseIf> ve
<Else> son olarak uygulanır.| Açıklama: | Başlatma sırasında bir doğruluk sınamasından sonra işleme sokulacak yönergeleri sarmalar. |
|---|---|
| Sözdizimi: | <IfDefine [!] |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
<IfDefine bölümü koşullu olarak işleme sokulacak yönergeleri içerir.
Bir sınama>...</IfDefine>
<IfDefine> bölümü içindeki
yönergeler sadece sınama doğru sonuç verirse işleme sokulur.
Aksi takdirde, bölüm içinde kalan her şey yok sayılır.
<IfDefine> bölüm yönergesinde
sınama için belirtilebilecek iki biçim vardır:
parametre-adı!parametre-adıBirinci durumda bölüm içinde kalan yönergeler sadece
parametre-adı ile belirtilen parametre tanımlı ise işleme
sokulur. İkinci durumda ise tersi yapılır, yani sadece
parametre-adı ile belirtilen parametre tanımlı
değil ise yönergeler işleme sokulur.
parametre-adı argümanı sunucu başlatılırken
httpd komut satırında
-D ile
veya parametreDefine yönergesi ile
belirtilerek tanımlı hale getirilebilir.
<IfDefine> bölümleri iç içe
olabilir, dolayısıyla çok parametreli basit sınamalar gerçeklenebilir.
Örnek:
httpd -DReverseProxy -DUseCache -DMemCache ...
<IfDefine ReverseProxy>
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
<IfDefine UseCache>
LoadModule cache_module modules/mod_cache.so
<IfDefine MemCache>
LoadModule mem_cache_module modules/mod_mem_cache.so
</IfDefine>
<IfDefine !MemCache>
LoadModule cache_disk_module modules/mod_cache_disk.so
</IfDefine>
</IfDefine>
</IfDefine>
| Açıklama: | Belirtilen yönerge adının varlığı veya yokluğuna bağlı olarak çalıştırılacak yönergeleri sarmalar. |
|---|---|
| Sözdizimi: | <IfDirective [!] |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.4.34 ve sonrasında kullanılabilir. |
<IfDirective bölümü içindeki yönergeler
yönerge-adı>
...</IfDirective>yönerge-adı ile belirtilen yönerge mevcutsa çalıştırılır yoksa
yok sayılır.
<IfDirective> yönergenide sınama iki türlü yapılır:
yönerge-adıyönerge-adıİlk durumda bölüm içinde kalan yönergeler, yönerge başlangıç satırına belirtilen yönerge işlem sırasında mevcutsa çalıştırılır, değilse çalıştırılmaz. İkinci durumda ise, bölüm içinde kalan yönergeler, yönerge başlangıç satırına belirtilen yönerge işlem sırasında mevcut değilse çalıştırılır, mevcutsa çalıştırılmaz.
httpd tek bir yapılandırma dosyası ile çalıştırılmak
zorundaysa ortaya çıkar. Böyle bir ihtiyacın olmadığı normal durumlarda
yönergelerin <IfDirective> bölümlerine
yerleştirlmesine gerek yoktur.| Açıklama: | Başlatma sırasında bir dosyanın varlığı durumunda işleme sokulacak yönergeleri sarmalar. |
|---|---|
| Sözdizimi: | <IfFile [!] |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.4.34 ve sonrsında kullanılabilir. |
<IfFile bölümü bir dosyanın diskteki mevcudiyetine bağlı olarak
çalıştırılacak yönergeleri belirtmekte kullanılır.
dosyaadı>...</IfFile>
<IfFile> bölümü içindeki yönergeler
sadece diskte dosyaadı mevcutsa çalıştırılır. dosyaadı
mevcut değilse bölüm içindeki yönergeler yok sayılır. dosyaadı
sunucu kök dizinine göreli veya mutlak bir yol olarak belirtilebilir.
<IfFile> bölüm yönergesindeki
dosyaadı, <IfDefine> yönergesindeki sınama değişkenindeki gibi
ele alınır, yani dosyaadı bir ! ile öncelenirse bölüm içindeki
yonergeler dosyanın yokluğu durumunda çalıştırılır.
Göreli bir dosyaadı belirtilmişse sınama ServerRoot yönergesinde belirtilen dizinde göre
yapılır. <IfFile> yönergesinin
ServerRoot yönergesinde önce yer alması
durumunda dosya yolu derleme sırasında kullanılan sunucu köküne veya komut
satırında -d seçeneği ile belirtilen dizine göre sınanır.
dosyaadı'nı tırnak içinde belirtmek mümkün
değildi. Bu, başlatma sırasında çözümleme hatasına sebep oluyordu. Bunun
başlıca etkisi, boşluklu dosya adlarının kullanılamamasıdır. Bu sorun,
2.4.35 sürümünde düzeltildi.| Açıklama: | Belli bir modülün varlığına veya yokluğuna göre işleme sokulacak yönergeleri sarmalar. |
|---|---|
| Sözdizimi: | <IfModule [!] |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Modül betimleyiciler 2.1 sürümünde ve sonrası için geçerlidir. |
<IfModule
bölümü belli bir modülün varlığına veya yokluğuna göre işleme sokulacak
yönergeleri içerir. Bir sınama>...</IfModule><IfModule>
bölümü içindeki yönergeler sadece sınama doğru sonuç verirse
işleme sokulur. Aksi takdirde, bölüm içinde kalan her şey yok sayılır.
<IfModule> bölüm yönergesinde
sınama için belirtilebilecek iki biçim vardır:
modülmodülBirinci durumda bölüm içinde kalan yönergeler sadece modül
ile belirtilen modül Apache httpd içine dahil edilmişse veya
LoadModule yönergesi ile devingen
olarak yüklenmişse işleme sokulur. İkinci durumda ise tersi yapılır, yani
sadece modül içerilmiş değil ise yönergeler
işleme sokulur.
modül argümanında bir modül betimleyici veya modülün derleme
sırasındaki dosya adı belirtilebilir. Örneğin, rewrite_module
bir betimleyici, mod_rewrite.c ise bir dosya ismidir. Eğer
modül çok sayıda kaynak dosyasından oluşuyorsa
STANDARD20_MODULE_STUFF dizgesini içeren dosyanın ismi
kullanılır.
<IfModule> bölümleri iç içe
olabilir, dolayısıyla çok parametreli basit sınamalar gerçeklenebilir.
<IfModule> bölümlerine yerleştirilmeleri
gerekmez.| Açıklama: | Belirtilen bölüm adının varlığı veya yokluğuna bağlı olarak çalıştırılacak yönergeleri sarmalar. |
|---|---|
| Sözdizimi: | <IfSection [!] |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.4.34 ve sonrasında kullanılabilir. |
<IfSection bölümü içindeki yönergeler
bölüm-adı>
...</IfSection>bölüm-adı ile belirtilen bölüm mevcutsa çalıştırılır yoksa
yok sayılır. Bir bölüm yönergesi "<" ile öncelenmiş bir yönerge adına
sahip olmalı ve <VirtualHost> gibi başka
yönergeleri sarmalayan bir yönerge olmalıdır.
<IfSection> bölümü içindeki
yönergeler sadece sınama doğru ise çalıştırılır,
sınama yanlışsa çalıştırılmaz.
bölüm-adı başında "<" veya sonunda ">" olmaksızın
belirtilmelidir. <IfSection>
yönergesindeki bölüm-adı iki türlü ele alınır:
bölüm-adıbölüm-adıİlk durumda bölüm içinde kalan yönergeler, yönerge başlangıç satırına belirtilen bölüm işlem sırasında mevcutsa çalıştırılır, değilse çalıştırılmaz. İkinci durumda ise, bölüm içinde kalan yönergeler, yönerge başlangıç satırına belirtilen bölüm işlem sırasında mevcut değilse çalıştırılır, mevcutsa çalıştırılmaz.
Örnek:
<IfSection VirtualHost> ... </IfSection>
httpd tek bir yapılandırma dosyası ile (belli bir bölüm
yönergesinin var olup olmamasına bakmaksızın) çalıştırılmak
zorundaysa ortaya çıkar. Böyle bir ihtiyacın olmadığı normal durumlarda
yönergelerin <IfSection> bölümlerine
yerleştirlmesine gerek yoktur.| Açıklama: | Sunucu yapılandırma dosyalarının başka dosyaları içermesini sağlar. |
|---|---|
| Sözdizimi: | Include |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Dizin kalıbıyla eşleşme ise 2.3.6 ve sonrasında mevcuttur. |
Bu yönerge sunucu yapılandırma dosyalarının başka dosyaları içermesini mümkün kılar.
Çok sayıda dosyayı bir kerede alfabetik sırada içermek için yolun dosya
ismi ve dizin parçalarında kabuk tarzı (fnmatch()) dosya
ismi kalıp karakterleri kullanılabilir. Ayrıca, eğer
Include yönergesi bir dosya değil de bir dizin
gösteriyorsa Apache httpd bu dizindeki ve alt dizinlerindeki bütün
dosyaları okuyacaktır. Bunula birlikte, dizinin bir bütün olarak
okutulması önerilmez, çünkü dizinde httpd programının
çökmesine sebep olabilecek geçici dosyalar unutulabilir. Bunun yerine,
belli bir şablona uyan dosyaları seçebilmek için, örneğin *.conf gibi
dosya kalıplarının kullanılmasını öneriyoruz.
Include yönergesi, bir dosya
kalıbı ifadesi hiçbir dosyayla eşleşmezse bir hatayla
başarısız olacaktır. Eşleşmeyen dosya kalıbı ifadelerinin
yoksayılması gerekiyorsa IncludeOptional yönergesi kullanılabilir.
Dosya yolu mutlak bir dosya yolu olarak belirtilebileceği gibi
ServerRoot dizinine göreli olarak
da belirtilebilir.
Örnekler:
Include /usr/local/apache2/conf/ssl.conf Include /usr/local/apache2/conf/vhosts/*.conf
Veya dizinler ServerRoot dizinine
göre belirtilebilir:
Include conf/ssl.conf Include conf/vhosts/*.conf
Dosya kalıbı karakterleri yolun dizin ve dosya parçalarına
yerleştirilebilir. conf/vhosts altında en azından bir
*.conf içeren hiçbir alt dizin yoksa bu örnek başarısız
olacaktır:
Include conf/vhosts/*/*.conf
Bunun yerine, dizin ve dosyaların eksikliği durumunda aşağıdaki komut sadece yoksayılır:
IncludeOptional conf/vhosts/*/*.conf
| Açıklama: | Diğer yapılandırma dosyalarının sunucu yapılandırma dosyasına dahil edilmesini sağlar |
|---|---|
| Sözdizimi: | IncludeOptional |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.3.6 ve sonrasına kullanılabilmektedir. Dosya kalıp karakterleri içermeyen dosya yollarından mevcut olmayanlar 2.4.30 sürümünden itibaren sözdizimi hatalarına sebep olmamaktadır. |
Bu yönerge, diğer yapılandırma dosyalarının sunucu yapılandırma
dosyasında içerilmesini sağlar. Çalışması Include yönergesi ile bir istisna dışında
aynıdır. Dosya kalıp karakterlerinin hiçbir dosya veya dizinle
eşleşmemesi veya dosya yolunun dosya sisteminde mevcut olmaması durumunda
bir hata oluşmayacak ve bu durum sadece yoksayılacaktır.
| Açıklama: | HTTP kalıcı bağlantılarını etkin kılar |
|---|---|
| Sözdizimi: | KeepAlive On|Off |
| Öntanımlı: | KeepAlive On |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
Keep-Alive yönergesi HTTP/1.0 protokolüne bir eklenti olup
HTTP/1.1 protokolünün kalıcı bağlantı özelliği aynı TCP bağlantısı
üzerinden çok sayıda isteğin gönderilmesini mümkün kılan uzun süreli HTTP
oturumları açılmasını sağlar. Bunun, çok sayıda resim içeren HTML
belgelerin yanıt zamanlarında bazı durumlarda %50’lik bir hızlanmayla
sonuçlandığı gösterilmiştir. Kalıcı bağlantıları etkin kılmak için
yönerge KeepAlive On şeklinde kullanılır.
HTTP/1.0 istemcileri için kalıcı bağlantılar sadece bir istemci tarafından özellikle istendiği takdirde kullanılabilir. Ek olarak, HTTP/1.0 istemci kalıcı bağlantıları sadece içerik uzunluğu baştan bilindiği zaman kullanılabilir. Bu, CGI çıktısı, SSI sayfaları ve sunucunun ürettiği dizin listeleri gibi genellikle HTTP/1.0 istemcilere kalıcı bağlantılar kullanmayan devingen içeriklere uygulanır. HTTP/1.1 istemciler için kalıcı bağlantılar aksi belirtilmedikçe öntanımlıdır. İstemci istediği takdirde, uzunluğu bilinmeyen içerik kalıcı bağlantılar üzerinden gönderilirken parçalı kodlama kullanılacaktır.
Bir istemci kalıcı bağlantı kullandığı takdirde, bağlantı üzerinden kaç
istek gönderilirse gönderilsin,
MaxConnectionsPerChild
yönergesi bakımından tek bir istek olarak değerlendirilir.
| Açıklama: | Bir kalıcı bağlantıda sunucunun bir sonraki isteği bekleme süresi |
|---|---|
| Sözdizimi: | KeepAliveTimeout |
| Öntanımlı: | KeepAliveTimeout 5 |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
Sunucunun kalıcı bir bağlantıyı kapatmadan önce bir sonraki isteği kaç
saniye bekleyeceğini belirler. Ayrıca, ms soneki kullanılarak süreyi
milisaniye olarak belirtmek de mümkündür. İstek alındıktan sonra
Timeout yönergesiyle belirtilen
zaman aşımı değeri uygulanır.
KeepAliveTimeout için yüksek bir değer belirtmek
ağır yüklü sunucularda başarım sorunlarına yol açar. Daha yüksek bir
zaman aşımı, boştaki istemcilerin bulunduğu bağlantıları bekleyen daha
fazla sunucu sürecini meşgul edecektir.
İsme dayalı sanal konak için KeepAliveTimeout
atanmamışsa, yerel IP adresi ve portu ile en iyi eşleşen ilk sanal
konağın değeri kullanılır.
| Açıklama: | Erişimi sınırlanacak HTTP yöntemleri için erişim sınırlayıcıları sarmalar. |
|---|---|
| Sözdizimi: | <Limit |
| Bağlam: | dizin, .htaccess |
| Geçersizleştirme: | AuthConfig, Limit |
| Durum: | Çekirdek |
| Modül: | core |
Erişim denetleyicileri normalde tüm erişim yöntemleri
için etkindir ve olağan olanı da budur. Genel durum olarak,
erişim denetim yönergeleri bir <Limit> bölümüne
yerleştirilmemelidir.
<Limit> bölümünün amacı, erişim
denetleyicilerinin etkilerini belli HTTP yöntemleri için sınırlamaktır.
<Limit> bölümü içinde listelenen
erişim sınırlamaları, kalan tüm diğer yöntemler için etkisiz
olacaktır. Aşağıdaki örnekte, erişim sınırlaması
POST, PUT ve DELETE yöntemleri
için uygulanmakta, diğer tüm yöntemler korumasız bırakılmaktadır:
<Limit POST PUT DELETE> Require valid-user </Limit>
Birden fazla bölümde kullanılabilecek yöntem isimleri: GET,
POST, PUT, DELETE,
CONNECT, OPTIONS,
PATCH, PROPFIND, PROPPATCH,
MKCOL, COPY, MOVE,
LOCK ve UNLOCK. Yöntem isimleri harf
büyüklüğüne duyarlıdır. GET yöntemi sınırlanırsa
HEAD istekleri de sınırlanmış olur. TRACE
yöntemi sınırlanamaz (bkz, TraceEnable).
<Limit> bölümü yerine daima bir <LimitExcept> bölümünü tercih
etmelisiniz, çünkü <LimitExcept> bölümü belirtilen yöntemler dışında kalanlara
erişim koruması sağlar.<Limit> ve
<LimitExcept>
yönergeleri iç içe olabilirler. Bu durumda, başarılı her
<Limit> veya <LimitExcept> seviyesi, erişim
denetimlerinin uygulanacağı yöntemlerle sınırlı kalmalıdır.
<Limit> veya
<LimitExcept> yönergelerini
Require yönergesi ile
birlikte kullanılırken, ilk Require yönergesinin bir başka Require yönergesinin varlığından
bağımsız olarak isteği başarıyla yetkilendirdiğine dikkat ediniz.Örneğin, aşağıdaki yapılandırmayı ele alalım; tüm kullanıcılar
POST istekleri için yetkilendirilecek ve tüm durumlarda
Require group editors yönergesi yoksayılacaktır:
<LimitExcept GET> Require valid-user </LimitExcept> <Limit POST> Require group editors </Limit>
| Açıklama: | İsimleri belirtilenler dışında kalan HTTP yöntemleri için kullanılacak erişim sınırlayıcıları sarmalar. |
|---|---|
| Sözdizimi: | <LimitExcept |
| Bağlam: | dizin, .htaccess |
| Geçersizleştirme: | AuthConfig, Limit |
| Durum: | Çekirdek |
| Modül: | core |
<LimitExcept> ve
</LimitExcept> argüman olarak belirtilenler
dışında kalan HTTP yöntemleri için kullanılacak erişim
sınırlayıcıları gruplamakta kullanılır. Yani, <Limit> bölümünün tersine, standart olsun olmasın
bütün yöntemler için erişimi kısıtlamakta kullanılabilir. Daha ayrıntılı
bilgi edinmek için <Limit> yönergesinin açıklamasına bakınız.
Örnek:
<LimitExcept POST GET> Require valid-user </LimitExcept>
| Açıklama: | Dahili yönlendirmelerin ve istek içi isteklerin azami sayısını belirler. |
|---|---|
| Sözdizimi: | LimitInternalRecursion |
| Öntanımlı: | LimitInternalRecursion 10 |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
Örneğin, özgün istekleri dahili olarak bir CGI betiğine yönlendiren
Action yönergesi
kullanıldığında bir dahili yönlendirme oluşur. İstek içi istekler ise
bazı URI’ler için istek yapıldığında ne olacağını bulmak için Apache
httpd’nin kullandığı bir mekanizmadır. Örneğin,
mod_dir, DirectoryIndex yönergesinde listelenen dosyalara bakmak
için istek içi istekler kullanır.
LimitInternalRecursion yönergesi sunucunun dahili
yönlendirmeler ve istek içi isteklerin oluşturduğu döngülerden dolayı
çökmemesini sağlar. Böyle döngüler genellikle yanlış yapılandırma sonucu
ortaya çıkarlar.
Yönerge her istek için değerlendirmeye alınacak iki farklı sınırlama
için kullanılabilir. İlk sayı ardarda gelebilen dahili
yönlendirmelerin azami sayısını, ikinci sayı ise istek içi
isteklerin ne kadar iç içe olabileceğini belirler. Tek bir
sayı belirtilirse iki sınırlama için de aynı değer
kullanılır.
LimitInternalRecursion 5
| Açıklama: | İstemci tarafından gönderilen HTTP istek gövdesinin toplam uzunluğunu sınırlar. |
|---|---|
| Sözdizimi: | LimitRequestBody |
| Öntanımlı: | LimitRequestBody 1073741824 |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache HTTP Sunucusu 2.4.53 ve öncesinde, öntanımlı değer 0 idi (sınırsız) |
Bu yönerge, bir istek gövdesinde izin verilen bayt sayısını sınırlamak için kullanılır. 0 sınırsız anlamına gelir.
LimitRequestBody yönergesi kullanıcıya yönergenin
kullanıldığı bağlam (sunucu, belli bir dizin, belli bir dosya, belli bir
yer) dahilinde bir HTTP istek iletisi gövdesinin izin verilen uzunluğu
için bir sınır belirleme imkanı verir. Eğer istemcinin isteği bu sınırı
aşarsa sunucu isteği sunmak yerine bir hata iletisi döndürecektir. Normal
bir istek ileti gövdesinin uzunluğu büyük oranda özkaynağın doğasına ve
bu özkaynak üzerinde izin verilen yöntemlere bağlıdır. CGI betikleri
genellikle ileti gövdesini form bilgisini almak için kullanır.
PUT yöntemi gerçeklenimleri, en azından, sunucunun o
özkaynak için kabul etmek isteyeceği herhangi bir gösterim kadar büyük
bir değer gerektirecektir.
Bu yönerge, bazı hizmet reddi (DoS) saldırılarından kaçınmak için sunucu yöneticilerine, anormal istemci istekleri üzerinde daha iyi denetim imkanı sağlar.
Eğer, örneğin, belli bir yere dosya yükleme izni verir ve buraya yüklenebilecek dosya boyutunu 100 kB ile sınırlamak isterseniz yönergeyi şöyle kullanabilirsiniz:
LimitRequestBody 102400
| Açıklama: | İstemciden kabul edilecek HTTP isteği başlık alanlarının sayısını sınırlar. |
|---|---|
| Sözdizimi: | LimitRequestFields |
| Öntanımlı: | LimitRequestFields 100 |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
sayıya 0 atanması sınırsız anlamına gelir.
Öntanımlı değer bir derleme zamanı sabiti olan
DEFAULT_LIMIT_REQUEST_FIELDS ile belirlenir (dağıtımla gelen
değeri 100’dür).
LimitRequestFields yönergesi sunucu
yöneticilerine bir HTTP isteğinde izin verilen istek başlık alanlarının
sayısı üzerindeki sınırı değiştirebilme imkanı verir. Sunucu bu değerin,
normal bir istemci isteğinin içerebileceği alan sayısından daha büyük
olmasına ihtiyaç duyar. Bir istemci tarafından kullanılan istek başlık
alanlarının sayısı nadiren 20’yi geçer, fakat bu farklı istemci
gerçeklenimleri için değişiklik gösterir ve çoğunlukla kullanıcının
tarayıcısını ayrıntılı içerik müzakeresini desteklemek için nasıl
yapılandırdığıyla ilgilidir. İsteğe bağlı HTTP eklentileri çoğunlukla
istek başlık alanları kullanılarak ifade edilir.
Bu yönerge, bazı hizmet reddi (DoS) saldırılarından kaçınmak için sunucu yöneticilerine, anormal istemci istekleri üzerinde daha iyi denetim imkanı sağlar. Eğer normal istemciler sunucudan istekte bulunurken çok fazla başlık alanı gönderildiğine dair bir hata iletisi alırlarsa bu değerin arttırılması gerekir.
Örnek:
LimitRequestFields 50
İsme dayalı sanal konaklar kullanıldığında, bu yönergenin değeri, yerel IP adresi ve port çifti için öntanımlı olan (listedeki ilk) sanal konaktan alınır.
.| Açıklama: | İstemciden kabul edilecek HTTP isteği başlık uzunluğunu sınırlar. |
|---|---|
| Sözdizimi: | LimitRequestFieldSize |
| Öntanımlı: | LimitRequestFieldSize 8190 |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
Bu yönerge, HTTP istek başlığında izin verilecek bayt sayısını belirler.
LimitRequestFieldSize yönergesi, sunucu
yöneticilerine HTTP istek başlık alanının azami uzunluğunu ayarlama
imkanı verir. Sunucu bu değerin, normal bir istemci isteğinin
içerebileceği herhangi bir başlık alanını tutabilecek kadar büyük
olmasını gerektirir. Normal bir istek başlık alanı uzunluğu kullanıcının
tarayıcısını ayrıntılı içerik müzakeresini desteklemek için nasıl
yapılandırdığıyla ilgilidir. SPNEGO kimlik doğrulama başlıkları 12392
baytlık olabilir.
Bu yönerge, bazı hizmet reddi (DoS) saldırılarından kaçınmak için sunucu yöneticilerine, anormal istemci istekleri üzerinde daha iyi denetim imkanı sağlar.
Örnek:
LimitRequestFieldSize 4094
İsme dayalı sanal konaklar kullanıldığında, bu yönergenin değeri, yerel IP adresi ve port çifti için öntanımlı olan (listedeki ilk) sanal konaktan alınır.
| Açıklama: | İstemciden kabul edilecek HTTP istek satırının uzunluğunu sınırlar. |
|---|---|
| Sözdizimi: | LimitRequestLine |
| Öntanımlı: | LimitRequestLine 8190 |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
Bu yönerge, HTTP istek satırında izin verilecek bayt sayısını belirler.
LimitRequestLine yönergesi, sunucu yöneticilerine
bir istemcinin HTTP istek satırının azami uzunluğunu ayarlama
imkanı verir. İstek satırının içeriği HTTP yöntemi, URI ve protokol
sürümünden oluştuğundan LimitRequestLine
yönergesi, sunucudan bir istek için kullanılan istek adresinin uzunluğunu
sınırlamış olur. Sunucu bu değerin, bir GET isteğinin sorgu
kısmında aktarılabilen her bilgi dahil, özkaynak isimlerinden her birini
tutabilecek kadar büyük olmasını gerektirir.
Bu yönerge, bazı hizmet reddi (DoS) saldırılarından kaçınmak için sunucu yöneticilerine, anormal istemci istekleri üzerinde daha iyi denetim imkanı sağlar.
Örnek:
LimitRequestLine 4094
İsme dayalı sanal konaklar kullanıldığında, bu yönergenin değeri, yerel IP adresi ve port çifti için öntanımlı olan (listedeki ilk) sanal konaktan alınır.
| Açıklama: | Bir XML temelli istek gövdesinin uzunluğunu sınırlar. |
|---|---|
| Sözdizimi: | LimitXMLRequestBody |
| Öntanımlı: | LimitXMLRequestBody 1000000 |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
Bir XML temelli istek gövdesinin azami bayt sayısını belirler.
0 değeri, XML'in sistem adreslenebilir belleğinin sınırları
içinde sarmalanmasına izin veren (32bit ve 64bit sisteme bağlı olarak)
katı bir sınırlama uygular, ancak yalnızca uyumluluk için vardır ve
önerilmez, çünkü genel sistemde belleğin yetersiz kalmasına neden
olabilecek eşzamanlı istekleri veya başka bir yerde tüketilen belleği
hesaba katmaz.
Örnek:
# 1 MiB'lık sınırlama LimitXMLRequestBody 1073741824
| Açıklama: | İçerdiği yönergeler sadece eşleşen URL’lere uygulanır. |
|---|---|
| Sözdizimi: | <Location |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
<Location> bölüm yönergesi kapsadığı
yönergelerin etki alanını belirtilen URL’lerle sınırlar. Bu yönerge,
<Directory> yönergesine
benzer ve </Location> yönergesi ile biten bir alt
bölüm başlatır. <Location> bölümleri
yapılandırma dosyasında göründükleri sıraya göre, <Directory> bölümleri ve
.htaccess dosyaları okunup <Files> bölümleri de işlendikten sonra işleme
sokulurlar.
<Location> bölümleri dosya
sisteminin tamamen dışında işlem görürler. Bunun çeşitli sonuçları olur.
En önemlisi, <Location>
yönergelerinin dosya sistemi konumlarına erişimi denetim altına almak
için kullanılmaması gerekliliğidir. Aynı dosya sistemi konumuna farklı
URL’lerle erişmek mümkün olduğundan bu tür erişim denetimleri hile ile
atlatılabilir olacaktır.
URL'nin yol bileşeni aşağıdaki koşullardan herhangi birini sağlıyorsa sarmalanan yönergeler isteğe uygulanır:
Aşağıdaki örnekte yer belirtimi bir bölü çizgisi ile bitirilmemiştir.
/private1, /private1/ ve
/private1/file.txt istekleri için sarmalanan yönergeler
uygulanacaktır, fakat /private1other isteğine
uygulanmayacaktır.
<Location "/private1">
# ...
</Location>
Aşağıdaki örnekte yer belirtimi bir bölü çizgisi ile bitirilmiştir.
/private2/ ve /private2/file.txt istekleri
için sarmalanan yönergeler uygulanacaktır, fakat /private2
ve /private2other isteklerine uygulanmayacaktır.
<Location "/private2/">
# ...
</Location>
<Location> ne zaman
kullanılmalı<Location> yönergesini dosya sistemi
dışındaki içeriğe çeşitli yönergeler uygulamak için kullanın. Dosya
sisteminde bulunan içerik için <Directory> ve <Files> bölümlerini kullanın. Bunun istisnası,
sunucunun tamamına bir yapılandırma uygulamak için kolay bir yol olan
<Location "/"> kullanımıdır.
Kaynağa yapılan (vekil olmayan) tüm istekler için eşleşecek URL,
/yol/ şeklinde bir URL yolu olmalı; ne şema, ne konak ismi
ne port ne de sorgu dizgesi içermelidir. Vekil istekleri için eşleşecek
URL ise şema://sunucuadı/dosya-yolu şeklinde olmalı ve önek
içermelidir.
URL içinde dosya kalıp karakterleri kullanılabilir. Dosya kalıp
karakterleri bulunan bir dizgede bulunan ? karakteri
herhangi bir tek karakterle eşleşirken * karakteri herhangi
bir karakter dizisi ile eşleşecektir. URL yolu içindeki / karakterleri
ile hiçbir dosya kalıp karakteri eşleşmez.
Ayrıca, ~ karakteri eşliğinde
düzenli ifadeler de kullanılabilir.
Örneğin,
<Location ~ "/(ek|hususi)/veri">
#...
</Location>
yönergesi /ek/veri ve /hususi/veri alt
dizgeleriyle eşleşecektir. <LocationMatch> yönergesi <Location> yönergesinin düzenli ifade sürümüne
eşdeğer davranır ve bir çok yazı tipinde ~ karakterini
- karakterinden ayırmak zor olduğu için tercih edilir.
<Location> işlevselliği özellikle
SetHandler yönergesi ile birlikte
kullanışlı olur. Örneğin, durum isteklerini etkin kılmak ama sadece
example.com’dan gelen isteklere izin vermek için şöyle bir
uygulama yapabilirsiniz:
<Location "/status"> SetHandler server-status Require host example.com </Location>
Bölü çizgisinin URL içinde bulunduğu yere bağlı olarak özel anlamları
vardır. Dosya sistemindeki çok sayıda yanyana kullanımının tek bir bölü
çizgisi olarak ele alındığı duruma alışkın olanlar olabilir (yani,
/home///foo ile /home/foo aynıdır).
MergeSlashes yönergesine OFF
atanmışsa URL uzayında bunun böyle olması gerekli değildir.
Eğer çok sayıda bölü çizgisinin birleştirilmeden yanyana belirtilmesi
gerekiyorsa
<LocationMatch>
yönergesinde ve <Location>
yönergesinin düzenli ifadeli kullanımında bunun açıkça belirtilmesi
gerekir.
Örneğin, <LocationMatch "^/abc"> yönergesi
/abc ile eşleşecek ama //abc ile
eşleşmeyecektir. <Location>
yönergesinin düzenli ifade içermeyen kullanımındaki davranış vekil
isteklerinde kullanılana benzer ve doğrudan kaynağa yapılan (vekil
olmayan) isteklerde çok sayıda bölü çizgisi dolaylı olarak tek bir bölü
çizgisiyle eşleşecektir. Örneğin, <Location
"/abc/def"> belirtirseniz ve istek /abc//def
şeklinde olursa bu ikisi eşleşir.
| Açıklama: | İçerdiği yönergeler sadece düzenli ifadelerle eşleşen URL’lere uygulanır. |
|---|---|
| Sözdizimi: | <LocationMatch
|
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
<LocationMatch> yönergesi içerdiği
yönergelerin etki alanını <Location> yönergesinin yaptığı gibi belirtilen URL’lerle
sınırlar. Ancak argüman olarak basit bir dizge değil bir düzenli ifade alır. Örneğin,
<LocationMatch "/(ek|hususi)/veri">
# ...
</LocationMatch>
yönergesi /ek/veri ve /hususi/veri alt
dizgeleriyle eşleşecektir.
Eğer hedef, /ek/veri içeren değil de
/ek/veri ile başlayan bir URL ise düzenli ifadenin önüne
^ getirmek gerekir.
<LocationMatch "^/(ek|hususi)/veri">
2.4.8 itibariyle, isimli gruplar ve geriye başvurular elde edilmekte
olup ilgili isim büyük harfe çevrildikren sonra "MATCH_" ile
öncelendikten sonra ortama yazılmaktadır. Böylece yol elemanlarına
mod_rewrite gibi modüllerden veya düzenli ifadelerden başvurmak mümkün
kılınmıştır. Karışıklığı önlemek için, numaralı (isimsiz) geriye
başvurular yoksayılmaktadır. Bunların yerine isimli geriye başvurular
kullanılmalıdır.
<LocationMatch "^/combined/(?<sitename>[^/]+)">
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</LocationMatch>
Bölü çizgisi karakteri URL üzerinde göründüğü yere bağlı olarak
farklı anlamlar içerir. İnsanlar, birden çok bitişik bölü çizgisinin sık
sık tek bir bölü çizgisine daraltıldığı dosya sistemindeki davranışına
alışkın olabilir (örn, /home///foo ile
/home/foo aynıdır).
MergeSlashes yönergesine OFF
atanmışsa URL uzayında bunun böyle olması gerekli değildir.
Eğer çok sayıda bölü çizgisinin birleştirilmeden yanyana belirtilmesi
gerekiyorsa
<LocationMatch>
yönergesinde ve <Location>
yönergesinin düzenli ifadeli kullanımında bunun açıkça belirtilmesi
gerekir.
Örneğin, <LocationMatch "^/abc"> ile
/abc isteği eşleşirken //abc isteği
eşleşmez. <Location> yönergesinin
regex olmayan kullanımı vekil isteklerindeki gibi davranır. Fakat
vekil harici işlemlerde <Location>
yönergesinin regex olmayan kullanımında çok sayıda bölü çizgisi örtük
olarak tek bölü çizgisiyle eşleşir. Örneğin,
<Location "/abc/def"> belirtirseniz
/abc//def isteği bu ifade ile eşleşecektir.
| Açıklama: | Hata günlüklerinin ayrıntı seviyesini belirler. |
|---|---|
| Sözdizimi: | LogLevel [ |
| Öntanımlı: | LogLevel warn |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Modül ve dizin bağlamındaki yapılandırmalar Apache HTTP Sunucusunun 2.3.6 ve sonraki sürümlerinde kullanılabilmektedir. |
LogLevel yönergesi hata günlüklerine kaydedilen
hata iletilerinde hangi ayrıntılara yer verileceğini belirler (ErrorLog yönergesine bakınız). En yüksek önem
derecesinden başlayarak olası seviye değerleri aşağıda
sıralanmıştır:
| Seviye | Açıklama | Örnek |
|---|---|---|
emerg |
Acil durumlar - sistem kullanışsız. | "Child cannot open lock file. Exiting" (Alt süreç kilit dosyasını açamıyor. Çıkılıyor) |
alert |
Ne yapılacaksa beklemeden yapılmalı. | "getpwuid: couldn't determine user name from uid" (getpwuid: Kullanıcı ismi numarasından saptanamadı) |
crit |
Kriz durumları. | "socket: Failed to get a socket, exiting child" (socket: bir soket alınamadı, alt süreç çıkıyor) |
error |
Hata durumları. | "Premature end of script headers" (Betik başlıkları beklenmedik şekilde bitti) |
warn |
Uyarı durumları. | "child process 1234 did not exit, sending another
SIGHUP" (1234 alt süreci çıkmadı, başka bir SIGHUP gönderiliyor) |
notice |
Normal fakat önemli durum. | "httpd: caught SIGBUS, attempting to dump core in
..." (httpd: SIGBUS alındı, core dökümlenmeye çalışılıyor: ...) |
info |
Bilgilendirme. | "Server seems busy, (you may need to increase
StartServers, or Min/MaxSpareServers)..." (Sunucu meşgul görünüyor, (StartServers veya Min/MaxSpareServers değerlerini arttırmanız gerekebilir)...) |
debug |
Hata ayıklama seviyesi iletileri | "Opening config file ..." (... yapılandırma dosyası açılıyor) |
trace1 |
İz sürme iletileri | "proxy: FTP: control connection complete" (vekil: FTP: denetim bağlantısı sağlandı) |
trace2 |
İz sürme iletileri | "proxy: CONNECT: sending the CONNECT request to the remote
proxy" (vekil: CONNECT: uzak vekile CONNECT isteği gönderiliyor) |
trace3 |
İz sürme iletileri | "openssl: Handshake: start" |
trace4 |
İz sürme iletileri | "read from buffered SSL brigade, mode 0, 17 bytes" (tamponlu SSL gruplamasından okuma, kip 0, 17 baytİz sürme iletileri |
trace5 |
İz sürme iletileri | "map lookup FAILED: map=rewritemap key=keyname" (eşleşme araması BAŞARISIZ: map=rewritemap key=keyname) |
trace6 |
İz sürme iletileri | "cache lookup FAILED, forcing new map lookup" (arabellek araması BAŞARISIZ, yeni bir eşleşme araması başlatılıyor) |
trace7 |
İz sürme iletileri, büyük miktarda veri dökümü | "| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |" |
trace8 |
İz sürme iletileri, büyük miktarda veri dökümü | "| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |" |
Belli bir seviye belirtildiğinde daha yüksek seviyeden iletiler de
raporlanır. Örneğin, LogLevel info belirtildiğinde
notice ve warn günlük seviyelerinin iletileri
ayrıca raporlanacaktır.
En az crit seviyesinin kullanılması önerilir.
Örnek:
LogLevel notice
Günlük iletileri normal bir dosyaya yazılırken notice
seviyesinden iletiler engellenemez ve dolayısıyla daima raporlanırlar.
Ancak, günlük kaydı syslog kullanılarak yapılıyorsa bu
uygulanmaz.
Bir modül ismi olmaksızın bir seviye belirtmek seviyeyi bu seviyedeki
tüm modüller için sıfırlayacaktır. Bir seviyyi bir modül ismiyle
birlikte belirtmek seviyeyi sadece bu modül için sıfırlayacaktır. Modül
ismi olarak, modülün kaynak dosyası ismini, modül kimliği veya
_module sonekli modül ismi belirtmek mümkündür.
Yani, aşağıdaki üç belirtim eşdeğerdedir:
LogLevel info ssl:warn LogLevel info mod_ssl.c:warn LogLevel info ssl_module:warn
Ayrıca seviyeyi dizin bağlamında değiştirmek de mümkündür:
LogLevel info <Directory "/usr/local/apache/htdocs/app"> LogLevel debug </Directory>
| Açıklama: | Bir kalıcı bağlantıda izin verilen istek sayısı |
|---|---|
| Sözdizimi: | MaxKeepAliveRequests |
| Öntanımlı: | MaxKeepAliveRequests 100 |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
MaxKeepAliveRequests yönergesi KeepAlive etkinken bağlantı başına izin
verilecek istek sayısını sınırlar. Değer olarak 0
belirtilirse istek sayısı sınırsız olur. Sunucu başarımını yüksek tutmak
için yüksekçe bir değer belirtmenizi öneririz.
Örnek:
MaxKeepAliveRequests 500
| Açıklama: | Özkaynağın tamamını döndürmeden önce izin verilen üst üste binen
aralık sayısı (100-200,150-300 gibi) |
|---|---|
| Sözdizimi: | MaxRangeOverlaps default | unlimited | none |
|
| Öntanımlı: | MaxRangeOverlaps 20 |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache HTTP Sunucusunun 2.3.15 ve sonraki sürümlerinde kullanılabilmektedir. |
MaxRangeOverlaps yönergesi, sunucunun istemciye
göndermeye gönüllü olacağı üst üste binen HTTP Range'lerinin sayısını
sınırlar. İzin verilenden daha fazlası istenmişse özkaynağın tamamı
döndürülür.
aralık sayısı| Açıklama: | Özkaynağın tamamını döndürmeden önce izin verilen ters sıralı
aralık sayısı (100-200,50-70 gibi) |
|---|---|
| Sözdizimi: | MaxRangeReversals default | unlimited | none |
|
| Öntanımlı: | MaxRangeReversals 20 |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache HTTP Sunucusunun 2.3.15 ve sonraki sürümlerinde kullanılabilmektedir. |
The MaxRangeReversals yönergesi, sunucunun
istemciye göndermeye gönüllü olacağı ter sıralı HTTP Range'lerinin
sayısını sınırlar. İzin verilenden daha fazlası istenmişse
özkaynağın tamamı döndürülür.
aralık-sayısı| Açıklama: | Özkaynağın tamamını döndürmeden önce izin verilen aralık sayısı |
|---|---|
| Sözdizimi: | MaxRanges default | unlimited | none |
|
| Öntanımlı: | MaxRanges 200 |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache HTTP Sunucusunun 2.3.15 ve sonraki sürümlerinde kullanılabilmektedir. |
MaxRanges yönergesi, sunucunun istemciye
göndermeye gönüllü olacağı HTTP Range'lerinin sayısını sınırlar. İzin
verilenden daha fazlası istenmişse özkaynağın tamamı döndürülür.
aralık-sayısı| Açıklama: | Sunucunun URL’lerde ardışık bölü çizgilerini birleştirip birleştirmeyeceğini denetler. |
|---|---|
| Sözdizimi: | MergeSlashes ON|OFF |
| Öntanımlı: | MergeSlashes ON |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.4.39 sürümünde eklendi |
Öntanımlı olarak, sunucu istek adresinin yol bileşenindeki ardışık bölü çizgilerini ('/') birleştirip tek bölü çizgisi olarak ele alır.
Bu adresleri dosya sistemi ile eşleştirirken, bu ardışık bölü
çizgilerinin önemi yoktur. Ancak, bu adresler CGI veya vekil gibi başka
yollardan değerlendiriliyorsa bu ardışık bölü çizgilerinin olduğu gibi
kalması tercih edilebilir. Bu durumlarda ardışık bölü çizgilerinin
birleştirilmesini önlemek için, eskiden, MergeSlashes
yönergesine OFF atanabiliyordu.
OFF atanması durumunda, yapılandırma dosyasında, adresin yol
bileşeni ile eşleşen düzenli ifadelerde
(LocationMatch, RewriteRule,
...) ardışık bölü çizgilerinin hesaba katılması gerekir. Düzenli ifade
içermeyen Location yönergeleri daima birleştirilmiş
bölü çizgileri içeren bir URL'ye karşı çalışır ve çok sayıdaki bölü
çizgileri arasında bir ayrım yapamaz.
| Açıklama: | Trailer alanlarının başlığa dahil edilip edilmeyeceğini belirler |
|---|---|
| Sözdizimi: | MergeTrailers [on|off] |
| Öntanımlı: | MergeTrailers off |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.4.11 ve sonrası |
Bu yönerge HTTP Trailer alanlarının dahili HTTP başlıklarına kopyalanıp kopyalanmayacağını belirler. Kopyalama işlemi istek gövdesi tamamen alındığında gerçekleşir, çoğu başlık işleminin çok sonra istek başlıklarını inceleme veya değiştirme şansı olur.
Bu seçenek, Trailer alanlarını daima kopyalayan 2.4.11 öncesi dağıtımlarla uyumluluk için vardır.
| Açıklama: | Muteks mekanizmasını ve kilit dosyası dizinini tüm muteksler veya belirtilenler için yapılandırır |
|---|---|
| Sözdizimi: | Mutex |
| Öntanımlı: | Mutex default |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache HTTP Sunucusunun 2.3.4 ve sonraki sürümlerinde kullanılabilmektedir. |
Mutex yönergesi httpd ve diğer modüllerin
özkaynaklara erişimi dizgeleştirmekte kullandıkları mekanizmanın yanında
isteğe bağlı olarak kilit dosyasının yerini belirler. İlk değiştirge
olarak default belirtilirse tüm mutekslerin ayarları
değişir; ikinci değiştirge olarak bir muteks ismi belirtilirse (aşağıdaki
tabloya bakın) yalnızca bu muteksin öntanımlıları değişir.
Mutex yönergesi genelde aşağıdaki istisnai
durumlarda kullanılır:
Bu yönerge sadece ap_mutex_register() API'si kullanılarak
çekirdek sunucuda imlenmiş muteksleri yapılandırır. httpd ile birlikte
dağıtılan tüm modüller Mutex yönergesini
destekler, fakat üçüncü parti modüllerin hepsi desteklemeyebilir. Bu
yönergenin desteklenip desteklenmediğini öğrenmek için üçüncü parti
modülün belgelerini inceleyin; destekliyorsa muteks ad(lar)ı
belirtilmiştir.
Kullanılabilen muteks mekanizmaları:
default | yes
APR tarafından saptanan öntanımlı kilitleme
gerçeklenimini seçer. Öntanımlı kilitleme gerçeklenimi
httpd -V seçeneği ile çalıştırılarak
öğrenilebilir.
none | no
Muteksi etkin şekilde iptal eder. Buna bir mutekste izin verilebilmesi için modülün bunun geçerli bir seçim olduğunu belirtmesi gerekir. Daha fazla bilgi için modül belgelerini inceleyin.
posixsem
POSIX semaforuna dayalı bir muteks çeşididir.
Süreçteki bir evre muteks parçalama arızalarını tutuyorsa, httpd'nin çökmesi sonucu, semafor sahipliği geri kazanılmaz.
sysvsem
SystemV IPC semaforuna dayalı bir muteks çeşididir.
Semafor geri kazanılmadan süreçler çökerse SysV semaforlarının "sızıntı" yapması mümkündür.
Semafor API'si, HTTP sunucusu ile aynı kullanıcı kimliği altında
çalışan bir CGI (örn, suexec veya
cgiwrapper gibi bir araç kullanmıyorsanız bütün
CGI'ler) tarafından hizmet reddi saldırısı yapılmasına izin
verir.
sem
POSIX ve SystemV IPC semaforları arasından kullanılabilir "en iyi" semafor gerçeklenimini seçer.
pthread
Süreç çaprazlamalı POSIX evre mutekslerine dayalı bir muteks çeşididir.
Çoğu sistemde, bir çocuk süreç bu gerçeklenim tarafından kullanılan bir muteksi tutarken olağandışı bir şekilde sonlanırsa httpd donar ve isteklere yanıt vermeyi durdurur. Bu olduğunda sunucuyu bu durumdan kurtarmak için elle yeniden başlatmak gerekir.
Bu duruma karşı bir mekanizma sağlayan Solaris ve Linux dikkate değer bir istisnadır. Bu mekanizma, bir muteksi tutan bir çocuk süreç olağandışı bir şekilde sonlandıktan sonra muteksin kurtarılmasını sağlar.
Sisteminiz POSIX uyumluysa veya
pthread_mutexattr_setrobust_np() işlevini
sağlıyorsa pthread seçeneğini rahatça
kullanabilirsiniz.
fcntl:/path/to/mutex
Muteks olarak fcntl() işlevini ve fiziksel bir (lock-)
dosyasını kullanan bir muteks çeşididir.
Bu mekanizmaya dayalı çok sayıda muteks, çok evreli ve çok süreçli
ortamlarda kullanıldığında, örneğin Solaris'te olduğu gibi
fcntl() evrelerden bihaberse, geçerli muteks
işlemlerinde donma hataları (EDEADLK) raporlanabilir.
flock:/path/to/mutex
flock() işlevinin dosya kilitlemeyi sağlaması dışında
fcntl:/path/to/mutex yöntemine benzer.
file:/path/to/mutex
fcntl ve flock arasından kullanılabilir
"en iyi" dosya kilitleme gerçeklenimini seçer.
Çoğu mekanizma, yalnız kendilerini destekleyen platformlarda APR tarafından da destekleniyorsa kullanılabilir. Tüm platformlarda kullanılamayan mekanizmalar posixsem, sysvsem, sem, pthread, fcntl, flock ve file mekanizmalarıdır.
fcntl ve flock dosya tabanlı mekanizmaları ile bir
yol sağlandığı takdirde bu, kilit dosyasının oluşturulacağı dizindir.
Öntanımlı dizin, httpd'nin çalışma anı dizini ServerRoot'a görelidir.
/path/to/mutex için daima bir yerel diskteki dosya sistemi
kullanılır, asla NFS- veya AFS gibi bir ağ dosya sistemi kullanılmaz.
Dosya ismi daima muteks ismi ile başlar, buna modül tarafından sağlanan
isteğe bağlı bir aşama dizgesi eklenebilir, OmitPID değeri
belirtilmemişse httpd ebeveyn sürecinin süreç kimliği buna eklenerek
dosya ismi eşsiz kılınır. Böylece, çok sayıda httpd süreci aynı kilit
dosyası dizinini paylaştığı durumda çakışmalar önlenmiş olur. Örneğin,
muteks ismi mpm-accept ise ve kilit dosyası dizini
/var/httpd/locks ise ve ebeveyn süreç kimliği 12345 ise bu
httpd sürecine ait kilit dosyası ismi
/var/httpd/locks/mpm-accept.12345 olurdu.
Muteks dosyalarını herkesin yazabildiği /var/tmp gibi
dizinlere koymaktan kaçınmak en iyisidir. Örneğin, birinin aynı
dizinde oluşturmaya çalıştığı bir dosya ile aynı isimde bir kilit
dosyasını sunucunun da oluşturmaya çalıştığı durumda sunucu engellenerek
bir hizmet reddi saldırısı gerçekleştirilmiş gibi olur.
httpd ve birlikte dağıtılan modüller tarafından kullanılan mutekslerin isimleri:
| Muteks ismi | Modül(ler) | Korunan özkaynak |
|---|---|---|
mpm-accept |
prefork ve worker MPM'leri
|
Gürleyen sürü sorunundan kaçınmak için gelen bağlantılar; daha fazla bilgi için başarımın arttırılması belgesine bakın. |
authdigest-client |
mod_auth_digest |
Paylaşımlı bellekteki istemci listesi |
authdigest-opaque |
mod_auth_digest |
Paylaşımlı bellekteki sayaç |
ldap-cache |
mod_ldap |
LDAP sonuç arabelleği |
rewrite-map |
mod_rewrite |
Çoklu isteklerdeki birbirine karışmış G/Ç'tan kaçınmak için harici eşleştirme progamlarıyla iletişim |
ssl-cache |
mod_ssl |
SSL oturum arabelleği |
ssl-stapling |
mod_ssl |
OCSP zımbalama yanıtı arabelleği |
watchdog-callback |
mod_watchdog |
Bir istemci modülünün geri çağırım işlevi |
OmitPID seçeneği, httpd ebeveyn süreç kimliğinin kilit
dosyası ismine eklenmesini engeller.
Aşağıdaki örnekte, mpm-accept muteksinin mekanizmasının
derleme sırasındaki öntanımlısı, kilit dosyasının oluşturulacağı dizinin
/var/httpd/locks olarak belirtildiği fcntl
mekanizmasıyla değiştirilmektedir.Tüm diğer mutekslerin derleme anı
öntanımlı mekanizması ise sysvsem ile
değiştirilmektedir.
Mutex sysvsem default Mutex fcntl:/var/httpd/locks mpm-accept
| Açıklama: | ÖNERİLMİYOR: İsme dayalı sanal konaklar için IP adresi belirtir |
|---|---|
| Sözdizimi: | NameVirtualHost |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
2.3.11 öncesinde, NameVirtualHost yönergesi,
isme dayalı sanal konaklar için belli bir IP adresi ve port çiftini
sunucuya tanıtmak için gerekliydi. 2.3.11 ve sonrasında, bir IP adresi
ve port çifti her zaman çok sayıda sanal konakta kullanılabilmekte,
isme dayalı sanal barındırma bu adres için özdevinimli olarak etkin
kılınmaktadır.
Bu yönerge şu an etkisizdir.
| Açıklama: | Belli bir dizinde geçerli olacak özellikleri yapılandırır. |
|---|---|
| Sözdizimi: | Options
[+|-] |
| Öntanımlı: | Options FollowSymlinks |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Options |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.3.11 sürümünde öntanımlı değer All değiştirilip FollowSymlinks yapıldı. |
Options yönergesi belli bir dizinde hangi
sunucu özelliklerinin etkin olacağını (veya olmayacağını)
belirler.
seçenek olarak hiçbir ek özellik etkin olmayacaksa
None, aksi takdirde aşağıdakilerden biri veya bir kaçı
belirtilir:
AllMultiViews hariç tüm seçenekler.ExecCGImod_cgi kullanan CGI betiklerinin çalışmasına izin
verilir.FollowSymLinksSembolik bağlar izlense bile <Directory> bölümleriyle eşleşen dosya
yolları değiştirilmez.
FollowSymLinks ve
SymLinksIfOwnerMatch Options sadece <Directory> bölümlerinde veya
.htaccess dosyaları içinde çalışır.
Sembolik bağ sınamaları, atlatılabilir yarış koşullarına konu olduğundan bu seçeneğin yokluğu bir güvenlik sınırlaması olarak değerlendirilmemelidir.
Includesmod_include tarafından sağlanan sunucu taraflı
içeriklere izin verilir.IncludesNOEXEC#exec cmd
ve #exec cgi iptal edilir. Ancak, ScriptAlias’lı dizinlerdeki CGI
betikleri için #include virtual hala mümkün olacaktır.IndexesDirectoryIndex (index.html
gibi) belirtilmemişse mod_autoindex bu dizinin
biçimlenmiş bir listesini döndürecektir.MultiViewsmod_negotiation kullanılarak içerik uzlaştırmalı çok
görünümlü içeriğe izin verilir.
mod_negotiation
karşılaştırmak değerlendirmek için gerçek özkaynaklara ihtiyaç
duyduğundan <Directory> yönergesinde belirtilendan farklı bir yer
ayarlanırsa bu seçenek yoksayılır.
SymLinksIfOwnerMatchFollowSymLinks ve
SymLinksIfOwnerMatch Options sadece <Directory> bölümlerinde veya
.htaccess dosyaları içinde çalışır.
Sembolik bağ sınamaları, atlatılabilir yarış koşullarına konu olduğundan bu seçenek bir güvenlik sınırlaması olarak değerlendirilmemelidir.
Normalde, bir dizine çok sayıda Options
uygulanabilirse de, dizine en uygun olanı uygulanıp diğerleri yok
sayılır; seçenekler katıştırılmaz (bkz, Bölümler Nasıl Katıştırılır?). Bununla birlikte, önüne bir
+ veya - simgesi konmuş seçenekler varsa, o
seçenekler katıştırılır. Önüne + konmuş seçenekler
mevcutlara eklenirken - konmuş seçenekler silinir.
+ veya - imli seçenekler içeren
Options ile imsiz seçenekler içerenlerin karışık
olarak kullanılması aslında geçersiz bir sözdizimi olup sunucunun
başlatılması sırasında sözdizimi denetiminin çıkmasıyla reddedilir.
Örneğin, + ve - imleri olmaksızın,
<Directory "/web/docs"> Options Indexes FollowSymLinks </Directory> <Directory "/web/docs/spec"> Options Includes </Directory>
yapılandırmasıyla /web/docs/spec dizininde sadece
Includes seçeneği etkin olacaktır. Bununla birlikte, ikinci
Options yönergesinde + ve
- imleri kullanılırsa,
<Directory "/web/docs"> Options Indexes FollowSymLinks </Directory> <Directory "/web/docs/spec"> Options +Includes -Indexes </Directory>
yapılandırmasıyla /web/docs/spec dizininde
FollowSymLinks ve Includes seçenekleri etkin
olacaktır.
-IncludesNOEXEC veya -Includes kullanımı,
önceki ayarların ne olduğuna bakılmaksızın sunucu taraflı içeriğin
tamamen iptaline sebep olur.
Herhangi bir başka değer belirtilmedikçe FollowSymlinks
öntanımlıdır.
| Açıklama: | Dinlenen bir soket için protokol |
|---|---|
| Sözdizimi: | Protocol |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache httpd 2.1.5 ve sonrasında kullanılabilmektedir. Windows'ta ise Apache httpd 2.3.3 ve sonrasında kullanılabilmektedir. |
Bu yönerge dinlenen belli bir soket için kullanılacak protokolü
belirler. Belirtilen protokol bir isteği hangi modülün ele alacağını ve
AcceptFilter yönergesiyle yapılan özel
eniyilemelere uygulanacak protokolü belirler.
Bu yönerge çoğu yapılandırma için gerekli değildir. Belirtilmezse,
port 443 için https öntanımlıdır ve diğer tüm portlar
için http ntanımlıdır. Protokol, hangi modülün bir isteği
işleyeceğini belirlemek ve AcceptFilter yönergesi ile protokole özgü
eniyilemeleri uygulamak için kullanılır.
Örneğin, https'i standartdışı bir portta çalıştırmak
isterseniz protokolü şöyle belirtebilirsiniz:
Protocol https
Protokolü Listen
yönergesini kullanarak da belirtebilirsiniz.
AcceptFilterAcceptFilterListen| Açıklama: | Sunucu/sanal konak için kullanılabilecek protokoller |
|---|---|
| Sözdizimi: | Protocols |
| Öntanımlı: | Protocols http/1.1 |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Sadece Apache 2.4.17 ve sonrasında kullanılabilir. |
Bu yönerge bir sunucu/sanal konak için kullanılabilecek protokolleri belirtmekte kullanılır. Bu liste, bir istemcinin bir sanal konak veya sunucu ile uzlaşabilmesini sağlayan prokolleri belirler.
Bir sanal konak veya sunucuda kullanılabilecek protolleri çeşitlendirmek isterseniz bu protokolleri belirtmeniz gerekir. 1.0 ve 0.9 istemcilerle uyumlu olan http/1.1 protokolü öntanımlıdır.
Örneğin, bir sunucunun TLS'li HTTP/2 protokolünü desteklemesini şöyle sağlayabilirsiniz:
Protocols h2 http/1.1
Geçerli protokoller, http ve https bağlantıları için
http/1.1 htps bağlantıları için h2 ve
http bağlantıları için h2c protokolleridir. Modüller
başka protokollerin de etkinleştirilmesini gerektirebilir.
Kullanımından vazgeçilmiş protokollerin silinmesi gerekmez. Böyle protokol isimleri basitçe yoksayılır.
Ana sunucu için belirtilen protokoller, kendi protokol yönergesi olmayan sanal konaklar için de geçerlidir. Diğer yandan sanal konaklarda protokol belirtilmesi ana sunucuda belirtien protollerin bu sanal konaklarda geçersiz olmasına sebep olur.
| Açıklama: | Uzlaşma sırasında protokollerin öncelik sırasını belirler |
|---|---|
| Sözdizimi: | ProtocolsHonorOrder On|Off |
| Öntanımlı: | ProtocolsHonorOrder On |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Sadece Apache 2.4.17 ve sonrasında kullanılabilir. |
Sunucuda Protocols yönergesinde listelemiş
protokollerin mi yoksa istemcinin protokol listesinin mi öncelikli
olacağı bu yönerge ile belirtilir.
Off belirtilirse, istemcinin protokol listesi sunucu yapılandırmasındaki sıralamanın önüne geçer.
ProtocolsHonorOrder yönergesine on
belirtilirse (öntanımlıdır), istemicinin protokol sıralaması dikkate
alınmaz ve protokol uzlaşımının sonucunu sunucu ayarlarındaki
sıralama belirler.
| Açıklama: | REDIRECT_URL ortam değişkeninin tamamen nitelenmiş olup olmayacağını denetler |
|---|---|
| Sözdizimi: | QualifyRedirectURL On|Off |
| Öntanımlı: | QualifyRedirectURL Off |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Yönerge 2.4.18 ve sonrasında desteklenmektedir. 2.4.17 sürümünde 'QualifyRedirectURL On' yapılandırması mevcutmuş gibi davranılır. |
Bu yönerge sunucuya REDIRECT_URL ortam değişkenin tamamen nitelenmiş
olacağını temin eder. Değişken öntanımlı olarak istemci tarafından talep
edilen URL'yi harfi harfine içerir, "/index.html" gibi.
QualifyRedirectURL On belirtilseydi
aynı istek "http://www.example.com/index.html" gibi bir değerle
sonuçlanırdı.
Böyle belirtilmemiş olsa bile, istek tam nitelenmiş bir URL içerseydi REDIRECT_URL de tam nitelenmiş URL'yi içerirdi.
| Açıklama: | Veriyi okumakta kullanılacak tampon sayısı |
|---|---|
| Sözdizimi: | ReadBufferSize |
| Öntanımlı: | ReadBufferSize 8192 |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.4.27 ve sonrası |
Bu yönerge, ağdan veya dosyalardan veri okumak için kullanılan bellek tamponunun boyutunu (bayt cinsinden) yapılandırmaya izin verir.
Daha büyük bir arabellek, daha büyük verilerle başarımı artırabilir,
ancak bağlantı başına tüketilen bellek artar. Yapılandırılabilir en küçük
boyut 1024'tür.
| Açıklama: | Regex düzenli ifadeleri için öntanımlı/küresel seçenekleri yapılandırır |
|---|---|
| Sözdizimi: | RegexDefaultOptions [none] [+|-] |
| Öntanımlı: | RegexDefaultOptions DOTALL DOLLAR_ENDONLY |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Sadece Apache 2.4.30 ve sonrasında kullanılabilmektedir. |
Bu yönerge kendisinden sonra kullanılan bütün düzenli ifsdelerin davranışını etkiler.
'+' ile öncelenmiş bütün seçenekler önceden atanmış seçeneklere
eklenir.
'-' ile öncelenmiş bütün seçenekler önceden atanmış seçeneklerden
çıkarılır.
'+' veya '-' ile öncelenmemiş her seçenek önceden atanmış seçenekleri
silerek onların yerini alır.
none ile önceden atanmış tüm seçenekler sıfırlanır.
seçenek şunlardan biri olabilir:
ICASEEXTENDEDDOTALLDOLLAR_ENDONLY# Tüm düzenli ifadeler için öntanımlı olarak ICASE seçeneğini ekler: RegexDefaultOptions +ICASE ... # Öntanımlı DOLLAR_ENDONLY seçeneği silinir, diğer seçenekler tutulur: RegexDefaultOptions -DOLLAR_ENDONLY ... # Atanmış seçenekler silinir, DOTALL öntanımlı seçenek yapılır: RegexDefaultOptions DOTALL ... # Tüm seçenekler silinir, öntanımlı seçenek kalmaz. RegexDefaultOptions none ...
| Açıklama: | Standart olmayan HTTP yöntemlerini devreye alır |
|---|---|
| Sözdizimi: | RegisterHttpMethod |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache HTTP Sunucusunun 2.4.24 ve sonraki sürümlerinde kullanılabilmektedir. |
Bu yönerge sunucunun standatta bulunmayan ek HTTP yöntemlerini kullanabilmesini sağlar. Yönergelerde standartta olmayan yöntem isimleri kullanmak gerektiğinde veya sunucunun modüllere sadece standart yöntemleri aktaracak şekilde yapılandırıldığı durumlarda bazı standart-dışı yöntemleri vekil veya CGI betikleriyle aktarmayı mümkün kılmak için bu gereklidir.
| Açıklama: | Apache httpd alt süreçleri tarafından çalıştırılan süreçlerin işlemci tüketimine sınırlama getirir. |
|---|---|
| Sözdizimi: | RLimitCPU |
| Öntanımlı: | Bir değer belirtilmemiştir; işletim sistemi öntanımlıları kullanılır
|
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
1 veya 2 değer alır. İlk değer bütün süreçler için sanal özkaynak
sınırını, ikinci değer ise kesin özkaynak sınırını belirler. İki değer de
birer sayı olabileceği gibi bu sınırın işletim sistemi yapılandırmasında
izin verilen üst sınıra ayarlanacağını belirtmek üzere max
olabilir. Kesin özkaynak sınırını yükseltmek için sunucunun
root olarak veya sistem açılışı sırasında çalıştırılması
gerekir.
Bu sınırlar Apache httpd’nin kendi alt süreçlerine değil, isteklere yanıt verirken Apache httpd alt süreçlerinin çatalladıkları süreçlere uygulanır. Bunlar CGI betikleri ve SSI çalıştırma komutları olabilir fakat borulu günlük kaydı gibi ana Apache httpd süreci tarafından çatallanmış süreçler olmazlar.
İşlemci özkaynak sınırları saniye cinsinden ifade edilir.
| Açıklama: | Apache httpd alt süreçleri tarafından çalıştırılan süreçlerin bellek tüketimine sınırlama getirir. |
|---|---|
| Sözdizimi: | RLimitMEM |
| Öntanımlı: | Bir değer belirtilmemiştir; işletim sistemi öntanımlıları kullanılır
|
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
1 veya 2 değer alır. İlk değer bütün süreçler için sanal özkaynak
sınırını, ikinci değer ise kesin özkaynak sınırını belirler. İki değer de
birer sayı olabileceği gibi bu sınırın işletim sistemi yapılandırmasında
izin verilen üst sınıra ayarlanacağını belirtmek üzere max
olabilir. Kesin özkaynak sınırını yükseltmek için sunucunun
root olarak veya sistem açılışı sırasında çalıştırılması
gerekir.
Bu sınırlar Apache httpd’nin kendi alt süreçlerine değil, isteklere yanıt verirken Apache httpd alt süreçlerinin çatalladıkları süreçlere uygulanır. Bunlar CGI betikleri ve SSI çalıştırma komutları olabilir fakat borulu günlük kaydı gibi ana Apache httpd süreci tarafından çatallanmış süreçler olmazlar.
Bellek özkaynak sınırları süreç başına bayt sayısı olarak ifade edilir.
| Açıklama: | Apache httpd alt süreçleri tarafından çalıştırılabilecek süreç sayısına sınırlama getirir. |
|---|---|
| Sözdizimi: | RLimitNPROC |
| Öntanımlı: | Bir değer belirtilmemiştir; işletim sistemi öntanımlıları kullanılır
|
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
1 veya 2 değer alır. İlk değer bütün süreçler için sanal özkaynak
sınırını, ikinci değer ise kesin özkaynak sınırını belirler. İki değer de
birer sayı olabileceği gibi bu sınırın işletim sistemi yapılandırmasında
izin verilen üst sınıra ayarlanacağını belirtmek üzere max
olabilir. Kesin özkaynak sınırını yükseltmek için sunucunun
root olarak veya sistem açılışı sırasında çalıştırılması
gerekir.
Bu sınırlar Apache httpd’nin kendi alt süreçlerine değil, isteklere yanıt verirken Apache httpd alt süreçlerinin çatalladıkları süreçlere uygulanır. Bunlar CGI betikleri ve SSI çalıştırma komutları olabilir fakat borulu günlük kaydı gibi ana Apache httpd süreci tarafından çatallanmış süreçler olmazlar.
Süreç sayısı sınırı kullanıcı başına süreç sayısına sınırlama getirir.
CGI süreçleri sunucu kullanıcı kimliğinden farklı bir kullanıcı
kimliği altında çalışmıyorsa bu yönerge sunucunun kendi oluşturduğu
süreç sayısını sınırlayacaktır. Bunun kanıtı error_log’da
iletilerin çatallanamamasıdır.
| Açıklama: | CGI betikleri için yorumlayıcı belirleme tekniği |
|---|---|
| Sözdizimi: | ScriptInterpreterSource Registry|Registry-Strict|Script |
| Öntanımlı: | ScriptInterpreterSource Script |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Sadece Win32 için. |
Bu yönerge Apache httpd’nin CGI betiklerini çalıştıracak yorumlayıcıyı
nasıl tespit edeceğini belirler. Script öntanımlı olup
Apache httpd’nin yorumlayıcı olarak betiğin diyezli ünlem satırında
(#! ile başlayan ilk satır) belirtilen yorumlayıcıyı
kullanacağını belirtir. Win32 sistemlerinde bu satır genellikle
şöyledir:
#!C:/Perl/bin/perl.exe
perl yorumlayıcının yeri PATH değişkeninde
kayıtlı ise şöyle de olabilir:
#!perl
ScriptInterpreterSource Registry değeri ise betik dosyası
uzantısının (.pl gibi) Windows Sicili içindeki
HKEY_CLASSES_ROOT ağacında arama yapmak için bir arama
anahtarı olarak kullanılmasını sağlar. Betik dosyasını çalıştırmak için
tanımlanmış komutu bulmak için Shell\ExecCGI\Command yoluna,
orada yoksa Shell\Open\Command yoluna bakılır. İkisi de
yoksa son çare olarak Script seçeneğinin davranışına
dönülür.
ScriptAlias’lı dizinlerde
Apache httpd bulduğu her dosyayı çalıştırmayı deneyeceğinden
ScriptInterpreterSource Registry yapılandırmasını
kullanırken dikkatli olun. Registry seçeneği genellikle
çalıştırılmayacak dosyalar için istenmeyen program çağrılarına sebep
olabilir. Örneğin, çoğu Windows sisteminde .htm dosyaları
için ön tanımlı "open" komutu Microsoft Internet Explorer’ın
çalıştırılmasına sebep olur; bu bakımdan, betik dizininde bulunan bir
.htm dosyası için yapılan bir HTTP isteği tarayıcının sunucu
artalanında çalıştırılmasına sebep olacaktır. Bu, sistemi bir kaç dakika
içinde çökertmek için iyi bir yoldur.
Registry-Strict seçeneği Registry
seçeneğinin yaptığını
Shell\ExecCGI\Command yolu için yapar. ExecCGI
sistem tarafından bilinen bir anahtar olmadığından Windows Siciline elle
kaydedilmesi gerekir ve dolayısıyla sisteminiz üzerinde istenmeyen
program çağrılarına sebep olmaz.
| Açıklama: | İsteğin 63 karakterden büyük olduğu varsayımıyla, mod_status'un ilk 63 karakteri mi yoksa son 63 karakteri mi göstereceğini belirler. |
|---|---|
| Sözdizimi: | SeeRequestTail On|Off |
| Öntanımlı: | SeeRequestTail Off |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Apache httpd 2.2.7 ve sonrasında kullanılabilmektedir. |
mod_status modülü ExtendedStatus On
ile işleme alınan asıl isteği gösterir. Tarihsel amaçlarla, isteğin
sadece 63 karakteri gösterme amacıyla saklanır. Bu yönerge ilk 63
karakterin mi (önceki davranış ve öntanımlı durum) yoksa son 63
karakterin mi saklanacağını belirler. Bu, şüphesiz, isteğin uzunluğu 64
karakter veya daha fazlaysa uygulanabilirdir.
Apache httpd'ye gelen istek GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1
ise mod_status şunu gösterir:
| Off (öntanımlı) | GET /disk1/storage/apache/htdocs/images/imagestore1/food/apples |
|---|---|
| On | orage/apache/htdocs/images/imagestore1/food/apples.jpg HTTP/1.1 |
| Açıklama: | Sunucunun hata iletilerinde istemciye göstereceği eposta adresi |
|---|---|
| Sözdizimi: | ServerAdmin |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
ServerAdmin yönergesi, sunucunun bir hata
durumunda istemciye döndüreceği hata iletilerinde içereceği iletişim
adresini belirtmek için kullanılır. Eğer httpd
sağlanan değerin bir URL olmadığını saptarsa değerin bir eposta adresi
olduğuna hükmeder ve önüne mailto: getirerek onu bir hiper
bağ hedefi olarak kullanır. Çoğu CGI betiği bir eposta adresi
belirtildiği kabulünü yaptığından değer olarak bir URL değil bir eposta
adresi belirtmeniz önerilir. Eğer bir URL belirtecekseniz hedef sizin
denetiminizde olan başka bir sunucuda bulunmalıdır, yoksa kullanıcılar
hata durumunda bu adrese erişemeyebilirler.
Kullanıcıların sunucu hakkında konuşurken isminizden bahsetmemeleri için burada belirtilecek adresin sırf bu işe adanmış bir adres olması daha iyidir. Örnek:
ServerAdmin www-admin@foo.example.com
| Açıklama: | İstekleri isme dayalı sanal konaklarla eşleştirilirken kullanılacak konak adları için başka isimler belirtebilmeyi sağlar. |
|---|---|
| Sözdizimi: | ServerAlias |
| Bağlam: | sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
ServerAlias yönergesi, istekleri isme dayalı sanal konaklarla
eşleştirilirken kullanılacak konak adları için başka isimler
belirtebilmeyi sağlar. ServerAlias dosya adı kalıp
karakterleri içerebilir.
<VirtualHost *:80> ServerName server.example.com ServerAlias server server2.example.com server2 ServerAlias *.example.com UseCanonicalName Off # ... </VirtualHost>
İsme dayalı sanal konaklardan en iyi eşleşme kümesinde olanlar
yapılandırmada göründükleri sıraya göre işleme sokulur. Joker
kullanımları arasında fark gözetilmeksizin ServerName veya ServerAlias yönergesi eşleşen ilk sanal konak
kullanılır.
<VirtualHost>
bölümü içindeki isimlerin sırası (jokersiz)
ServerAlias yönergesindeki gibi ele
alınır.
| Açıklama: | Sunucunun özdeşleşeceği konak ismi ve port. |
|---|---|
| Sözdizimi: | ServerName [ |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
ServerName yönergesi, sunucunun kendini
betimlemekte kullanacağı şema, konak adı ve port değerlerini belirler.
isme dayalı sanal
konaklar kullanılırken bir sanal konağı eşsiz bir şekilde betimlemek
için ServerName kullanılır (muhtemelen
ServerAlias ile birlikte).
Ek olarak, UseCanonicalName
yönergesine öntanımlı olmayan bir değer atanarak özüne yönlendiren
URL'ler oluştururken de bu yönerge kullanılır.
Örneğin, HTTP
sunucusunun barındırıldığı makinenin ismi mail.example.com
olduğu halde makinenin bir de www.example.com diye bir de
DNS rumuzu varsa ve HTTP sunucunuzun bu rumuzla kendini
özdeşleştirmesini isterseniz bunu şöyle belirtebilirsiniz:
ServerName www.example.com
ServerName yönergesi sunucu tanımının içinde
herhangi bir yerde görünebilirse de her göründüğü yerde bir öncekini
iptal eder.
Bir ServerName ataması yapılmamışsa sunucu
istemciye görünen sunucu ismini anlamak için önce işletim sistemine
sistemin konak adını sorar. Bu başarılı olmazsa sistem üzerinde IP
adresine bir ters DNS sorgusu yapar.
ServerName yönergesinde bir port belirtilmediği
takdirde sunucu, isteğin geldiği portu kullanacaktır. Öngörülebilirlik ve
güvenilirlik açısından en iyisi ServerName
yönergesini kullanarak açıkça bir konak ismi ve port belirtmektir.
İsme dayalı sanal konaklar
kullanıyorsanız, <VirtualHost> bölümü içindeki
ServerName yönergesi, isteğin Host:
başlığında bu sanal konakla eşleşecek konak ismini belirler.
Bazen sunucu, bir ters vekil, yük dengeleyici veya SSL yük aktarım
uygulaması gibi bir aygıtın arkasında çalışır. Böyle durumlarda sunucunun
kendine yönelik URL’leri doğru üretebildiğinden emin olmak için
ServerName yönergesinde istemcinin bağlanacağı
https:// şeması ve port numarası belirtilir.
Sunucunun kendine yönelik URL’lerin belirtilen portu içerip içermediğini
veya istemcinin yaptığı istekte belirtilen port numarasının verilip
verilmediğinin saptamasını sağlayan (örneğin, mod_dir
modülü tarafından) ayarlar için UseCanonicalName ve
UseCanonicalPhysicalPort
yönergelerinin açıklamalarına bakınız.
ServerName yönergesine isim atamadaki bir
başarısızlık, sunucu başlatılırken isim bir IP adresine
çözümlenebileceğinden bir uyarı çıktılanmasına sebep olur.
httpd böyle bir durumda sistemin hostname
komutunu kullanarak saptadığı konak ismini kullanacaktır. Bu konak ismi
hemen hemen daima sizin istediğiniz isim olmayacaktır.
httpd: Could not reliably determine the server's fully qualified domain name, using belgeler.yerel for ServerName
Çevirisi: Sunucunun tamamen nitelenmiş alan adı gerektiği gibi saptanamadı, ServerName için belgeler.yerel kullanılıyor
| Açıklama: | Uyumsuz bir tarayıcı tarafından erişilmesi için bir isme dayalı sanal konak için meşru URL yolu |
|---|---|
| Sözdizimi: | ServerPath |
| Bağlam: | sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
ServerPath yönergesi isme
dayalı sanal konaklarda kullanmak için konağa meşru bir URL yolu
belirler.
| Açıklama: | Sunucu yapılandırması için kök dizin |
|---|---|
| Sözdizimi: | ServerRoot |
| Öntanımlı: | ServerRoot /usr/local/apache |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
ServerRoot yönergesi sunucu yapılandırmasını
içeren dizinin yerini belirtir. Genellikle conf/ ve
logs/ gibi alt dizinler içerir. Include, LoadModule gibi diğer yapılandırma
yönergelerindeki göreli yollar bu dizine göre ele alınır.
ServerRoot "/home/httpd"
ServerRoot için öntanımlı yer configure betiğinin
--prefix seçeneği ile değiştirilebilir ve sunucunun çoğu
üçüncü parti dağıtıcısı öntanımlı yeri yukardakilerden farklı bir yere
ayarlar.
httpd için -d seçeneğiServerRoot dizininin erişim izinlerinin nasıl
ayarlanması gerektiğini öğrenmek için güvenlik ipuçları| Açıklama: | Sunucu tarafından üretilen belgelerin dipnotunu ayarlar. |
|---|---|
| Sözdizimi: | ServerSignature On|Off|EMail |
| Öntanımlı: | ServerSignature Off |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Çekirdek |
| Modül: | core |
ServerSignature yönergesi, sunucu tarafından
üretilen belgelerin (hata iletileri, mod_proxy ftp dizin
listeleri, mod_info çıktısı, vs.) altındaki dipnot
satırını yapılandırabilmenizi sağlar. Böyle bir dipnot satırın
istenmesinin sebebi vekil zincirlerinde istemciye dönen hata iletisinin
aslında hangi sunucu tarafından üretildiğini kullanıcıya bildirmektir.
Off değeri öntanımlı değer olup dipnot satırının
gösterilmemesini sağlar.
On değeri, sunucu sürüm numarası ve hizmeti sunan sanal
konağın isminden (ServerName) oluşan
bir dipnot satırı oluşturulmasını sağlar; EMail değeri bu
ikisine ek olarak satıra ServerAdmin
ile belirtilen adres için bir "mailto:" bağı ekler.
Sunucu sürüm numarasının ayrıntıları ServerTokens yönergesi ile belirlenmektedir.
| Açıklama: | Server HTTP yanıt başlığını yapılandırır.
|
|---|---|
| Sözdizimi: | ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full |
| Öntanımlı: | ServerTokens Full |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
Bu yönerge Server HTTP yanıt başlığı alanında istemcilere
sunucunun işletim sistemi, sunucuyla derlenmiş modüller, vs. hakkında
bilgi verilip verilmeyeceğini belirler.
ServerTokens Full (veya belirtilmezse)Server: Apache/2.4.2
(Unix) PHP/4.2.2 MyMod/1.2ServerTokens Prod[uctOnly]Server:
ApacheServerTokens MajorServer:
Apache/2ServerTokens MinorServer:
Apache/2.4ServerTokens Min[imal]Server:
Apache/2.4.2ServerTokens OSServer: Apache/2.4.2
(Unix)Bu ayarlama sunucunun tamamını etkiler ve her sanal konak için farklılaştırılamaz.
Bu yönerge ServerSignature
yönergesi tarafından sunulan bilgiyi de etkilemektedir.
ServerTokens yönergesinde
minimal'den azının belirtilmesi önerilmez. Bunun sebebi ara
işlemlerle ilgili hata ayıklamasını zorlaştırmasıdır. Ayrıca,
Server: başlığının iptal edilmesinin sunucunuzu daha güvenli
yapmayacağına dikkat ediniz; "çapraşıklıkla sağlanan güvenlik" düşüncesi
gerçekle bağdaşmaz ve güvenliği olumsuz etkiler.| Açıklama: | Eşleşen tüm dosyaların belli bir eylemci tarafından işlenmesine sebep olur. |
|---|---|
| Sözdizimi: | SetHandler |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | ifade seçeneği 2.4.19 sürümünde eklendi |
Bir .htaccess dosyasına veya bir <Directory> ya da <Location> bölümüne yerleştirildiğinde, eşleşen
tüm dosyaların, ismi eylemci-ismi ile belirtilen eylemci tarafından çözümlenmesine sebep olur.
Örneğin, bir dizin içindeki bütün dosyaların, uzantılarına bakılmaksızın
birer imagemap kural dosyası olarak çözümlenmesini istersiniz, bu dizin
içindeki bir .htaccess dosyasına şöyle bir satır
koyabilirsiniz:
SetHandler imap-file
Başka bir örnek: http://localhost/status gibi bir istek
yapıldığında sunucunun bir durum bilgisi göstermesi için
httpd.conf dosyasına şöyle bir satır koyabilirsiniz:
<Location "/status"> SetHandler server-status </Location>
Bu yönergeyi ayrıca, belli bir dosya uzantısına sahip dosyalara uygun bir eylemci atamak için de kullanabilirsiniz. örnek:
<FilesMatch "\.php$">
SetHandler application/x-httpd-php
</FilesMatch>
Dizge değerli ifadeler istek öncesi değişkenleri içerecek şekilde düzenlenebilir. Buna ismli düzenli ifadelere yapılan geriye başvurular dahildir:
<LocationMatch ^/app/(?<sub>[^/]+)/>
SetHandler "proxy:unix:/var/run/app_%{env:MATCH_sub}.sock|fcgi://localhost:8080"
</LocationMatch>
Evvelce tanımlanmış bir SetHandler yönergesini
None değeriyle geçersiz hale getirebilirsiniz.
SetHandler yönergesi,
öntanımlı eylemcileri geçersiz kıldığından, index dosyaları ve dizinleri
belirtmek için URL’nin sonuna bölü çizgisi (/) getirmek şeklindeki
normal davranış baskılanır.
| Açıklama: | POST girdilerini ve istemci isteklerini işleyecek süzgeçleri belirler. |
|---|---|
| Sözdizimi: | SetInputFilter |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
SetInputFilter yönergesi, istemci isteklerini
ve sunucu tarafından alındığı takdirde POST girdisini işleyecek süzgeç
veya süzgeçleri belirler. Bu, diğer AddInputFilter yönergeleri dahil evvelce tanımlanmış
süzgeçlere eklenir.
Birden fazla süzgeç belirtilmek istenirse birbirlerinden noktalı virgüllerle ayrılmalı ve çıktıyı işleyecekleri sıraya uygun olarak sıralanmalıdırlar.
| Açıklama: | Sunucunun yanıtlarını işleyecek süzgeçleri belirler. |
|---|---|
| Sözdizimi: | SetOutputFilter |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Çekirdek |
| Modül: | core |
SetOutputFilter yönergesi, istemciye
gönderilmeden önce sunucunun yanıtlarını işleyecek süzgeçleri belirler.
Bu, diğer AddOutputFilter
yönergeleri dahil evvelce tanımlanmış süzgeçlere eklenir.
Örneğin, aşağıdaki yapılandırma ile /www/data/ dizinindeki
bütün dosyalar sunucu taraflı içerik kapsamında ele alınacaktır.
<Directory "/www/data/"> SetOutputFilter INCLUDES </Directory>
Birden fazla süzgeç belirtilmek istenirse birbirlerinden noktalı virgüllerle ayrılmalı ve çıktıyı işleyecekleri sıraya uygun olarak sıralanmalıdırlar.
| Açıklama: | Sunucunun, istenen konak adının, isteği işleyen sanal konakta listelenmesini gerektirip gerektirmediğini denetler |
|---|---|
| Sözdizimi: | StrictHostCheck ON|OFF |
| Öntanımlı: | StrictHostCheck OFF |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | 2.4.49'da eklendi. |
Öntanımlı olarak sunucu, beklenmeyen veya yapılandırılmamış konak adlarına yönelik istekler de dahil olmak üzere her konak adı isteğine yanıt verir. Bu uygun olsa da, genellikle kendine dönen yanıtlar üretileceğinden, arkada çalışan bir uygulamanın işlenen konak adlarını bazı durumlarda sınırlaması istenebilir.
StrictHostCheck yönergesine ON,
atanarak, gelen bağlantıyla en iyi eşleşen sanal konaktaki
ServerName veya
ServerAlias yönergesinde istenen
konak adı açıkça listelenmemişse, sunucunun HTTP 400 hatası döndürmesi
sağlanabilir.
Bu yönerge ayrıca, istenen konak adının, ek ServerAlias girdileri gibi davranan ve nispeten
belirsiz bir yapılandırma mekanizması olan, VirtualHost açılış etiketinde belirtilen konak
adlarıyla eşleşmesini de sağlar.
Bu yönergenin öntanımlı olmayan sanal konaklarda hiçbir etkisi yoktur. Etkin değeri, genel sunucu yapılandırmasından devralınan değer veya ilgili bağlantının ip:port'u için öntanımlı olan sanal konak belirler.
| Açıklama: | Bir istek için başarısız olmadan önce belirli olayların gerçekleşmesi için sunucunun geçmesini bekleyeceği süre. |
|---|---|
| Sözdizimi: | TimeOut |
| Öntanımlı: | TimeOut 60 |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
TimeOut yönergesi Apache httpd’nin aşağıdaki
durumlarda G/Ç için bekleyeceği süreyi belirler:
Veriyi istemciden okurken, okuma tamponu boş olduğu takdirde bir TCP paketinin gelmesini bekleyeceği süre.
Yeni bir bağlantıda ilk veri için, sunucuya yeni bağlantıyı aktaran
bir AcceptFilter yönergesi ile
ilgili yapılandırma ele alınıncaya kadar bu yönerge etkilenmez.
mod_cgi ve mod_cgid modülünde, bir CGI
betiğinden belli bir çıktı kümesi için beklenecek süre.mod_ext_filter modülünde, bir süzme işleminden çıktı
almak için beklenecek süre.mod_proxy modülünde, ProxyTimeout yönergesi
yapılandırılmamışsa öntanımlı zaman aşımı değeri.| Açıklama: | TRACE isteklerinde davranış şeklini belirler
|
|---|---|
| Sözdizimi: | TraceEnable |
| Öntanımlı: | TraceEnable on |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Çekirdek |
| Modül: | core |
Bu yönerge çekirdek ve vekil (mod_proxy) sunucuların
her ikisi için öntanımlı TRACE davranışını değiştirir.
Öntanımlı olan TraceEnable on ile RFC 2616’dan kaynaklanan
ve isteğe herhangi bir istek gövdesinin eşlik etmesine izin vermeyen
TRACE isteklerine izin verilir. TraceEnable off
ile çekirdek ve vekil (mod_proxy) sunucuların her ikisi
de TRACE isteklerine yanıt olarak bir 405
(Yönteme izin verilmiyor) hatası döndürür.
TraceEnable extended ile sadece sınama ve tanı koyma
amaçlarına yönelik olarak istek gövdelerine izin verilir. Asıl sunucu
istek gövdesini 64kB ile sınırlar (Transfer-Encoding: chunked
kullanılmışsa bölüm başlıkları için 8kB daha). Asıl sunucu yanıt
gövdesinde tüm başlıkları ve bölüm başlıklarının tamamını yansıtacaktır.
Vekil sunucuda ise istek gövdesi için 64kB’lık sınır yoktur.
Aksine iddialara rağmen, TRACE yöntemini etkinleştirmek
Apache httpd'de bir güvenlik açığı değildir. TRACE yöntemi
HTTP/1.1 belirtiminde tanımlanmış olup desteklenmesi umulmuştur.
| Açıklama: | Controls what UNC host names can be accessed by the server |
|---|---|
| Sözdizimi: | UNCList hostname [hostname...] |
| Öntanımlı: | unset |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
| Uyumluluk: | Added in 2.4.60, Windows only. |
Bu yönergenin belgesi henüz Türkçeye çevrilmedi. Lütfen İngilizce sürümüne bakınız.
| Açıklama: | Bir değişkeni tanımsız yapar |
|---|---|
| Sözdizimi: | UnDefine |
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
Define yönergesinde veya
httpd'nin -D seçeneğiyle belirtileni
geri alır.
RewriteMap yönergesinin
sözdizimi ile çatışmalardan kaçınmak için değişken isimleri iki nokta
üst üste ":" karakterlerini içerebilir.
Bu yönerge başlatma betiklerinde -D seçeneğinin
argümanını değiştirmek gerekmeksizin <IfDefine> bölümlerinin kullanımını
değiştirmek için kullanılabilir.
| Açıklama: | Sunucunun kendi adını ve portunu nasıl belirleyeceğini ayarlar |
|---|---|
| Sözdizimi: | UseCanonicalName On|Off|DNS |
| Öntanımlı: | UseCanonicalName Off |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Çekirdek |
| Modül: | core |
Apache httpd‘nin çoğu durumda özüne yönelik URL‘ler (isteğin tekrar
aynı sunucuya yapıldığı bir URL türü) oluşturması gerekir.
UseCanonicalName On ile Apache httpd, sunucu için meşru
ismi ve portu oluşturmak için
ServerName
yönergesinde belirtilen ismi ve portu kullanır. Bu isim CGI'lerde
SERVER_NAME ve SERVER_PORT değerlerinde ve tüm
özüne yönelik URL’lerde kullanılır.
UseCanonicalName Off ile Apache httpd, özüne yönelik URL’leri
varsa istemci tarafından sağlanan konak ismini ve portu kullanarak
oluşturur; bunlar istemci tarafından sağlanmamışsa yukarıda tanımlanan
işleme başvurulur. Bu değerler, isme
dayalı sanal konakları gerçekleştirirken kullanılan değerlerle aynı
olup aynı istemcilerle kullanılabilir. SERVER_NAME ve
SERVER_PORT CGI değişkenleri de istemci tarafından sağlanan
isim ve portla oluşturulur.
Bir örnek olarak, iç ağdaki istemcilerin sunucuya www gibi
bir kısa isim kullanarak bağlandığı durumu ele alırsak daha yararlı
olur. Kullanıcılar bir kısa isim ve bir dizin isminden oluşan ve bir
/ ile sonlandırılmamış http://www/splat şeklinde bir
istek yaparlarsa, Apache httpd onları
http://www.example.com/splat/ adresine yönlendirecektir.
Eğer kimlik doğrulama da etkinse bu kullanıcının iki defa kimlik
doğrulamasına sokulmasına sebep olacaktır (bir kere www
için bir kere de www.example.com için; daha fazla bilgi için SSS’ye bakınız). Fakat UseCanonicalName Off
olsaydı Apache httpd isteği http://www/splat/ adresine
yönlendirecekti.
UseCanonicalName DNS diye üçüncü bir seçenek daha vardır ve
istek yaparken Host: başlığını kullanmayan eski istemcileri
desteklemek amacıyla IP’ye dayalı sanal konaklarla kullanmak için
tasarlanmıştır. Bu seçenek etkin olduğunda Apache httpd, istemciyi özüne
yönelik URL’lerle doğru yere bağlamak için sunucu IP adresi üzerinde bir
ters DNS sorgusu yapar.
Eğer CGI’ler SERVER_NAME değerleri için önkabuller
yapıyorlarsa bu seçenek işlerinin bozulmasına yol açabilir. Aslında
istemciler konak ismi olarak istedikleri değeri vermekte özgürdürler.
Fakat eğer CGI, özüne yönelik URL’leri oluştururken sadece
SERVER_NAME değerini kullanıyorsa bu istendiği gibi
çalışacaktır.
| Açıklama: | Sunucunun kendi adını ve portunu nasıl belirleyeceğini ayarlar |
|---|---|
| Sözdizimi: | UseCanonicalPhysicalPort On|Off |
| Öntanımlı: | UseCanonicalPhysicalPort Off |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Çekirdek |
| Modül: | core |
Apache httpd‘nin çoğu durumda özüne yönelik URL‘ler (isteğin tekrar
aynı sunucuya yapıldığı bir URL türü) oluşturması gerekir. Apache httpd
UseCanonicalName yönergesine bağlı
olarak sunucu için meşru portu oluştururken
UseCanonicalPhysicalPort On ile olası port olarak istek
tarafından kullanılmakta olan fiziksel portu kullanacaktır.
UseCanonicalPhysicalPort Off olduğunda ise geçerli bir port
numarası oluşturmak için asıl fiziksel port yerine yapılandırma bilgisi
kullanılır.
Fiziksel port kullanımı etkin olduğunda işlemler şu sırayla yürütülür:
UseCanonicalName OnServername ile sağlanan port
UseCanonicalName Off | DNSHost: başlığından çözümlenen portServername yönergesinde
belirtilen portUseCanonicalPhysicalPort Off olduğunda işlem sırasında
fiziksel port adımları atlanır.
| Açıklama: | Sadece belli bir konak ismine ve porta uygulanacak yönergeleri barındırır. |
|---|---|
| Sözdizimi: | <VirtualHost
|
| Bağlam: | sunucu geneli |
| Durum: | Çekirdek |
| Modül: | core |
<VirtualHost> ve
</VirtualHost> birlikte sadece belli bir sanal konağa
uygulanacak yönergeleri sarmalamakta kullanılırlar. Bir sanal konak
kapsamında belirtilebilecek her yönerge kullanılabilir. Sunucu belli bir
sanal konak üzerindeki bir belge için bir istek aldığında <VirtualHost> bölümünde bulunan yapılandırma
yönergelerini kullanır. adres şunlardan biri olabilir,
istemlik olarak ikinokta imi ve bir port numarası (veya *)
eklenebilir:
* karakteri.* için bir takma ad olarak _default_
dizgesi.<VirtualHost 10.1.2.3:80> ServerAdmin webmaster@host.example.com DocumentRoot "/www/docs/host.example.com" ServerName host.example.com ErrorLog "logs/host.example.com-error_log" TransferLog "logs/host.example.com-access_log" </VirtualHost>
İsteğe bağlı port numarasını belirtmeyi mümkün kılmak için IPv6 adresleri köşeli ayraç içine alınır. IPv6 adresi kullanılan bir örnek:
<VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80> ServerAdmin webmaster@host.example.com DocumentRoot "/www/docs/host.example.com" ServerName host.example.com ErrorLog "logs/host.example.com-error_log" TransferLog "logs/host.example.com-access_log" </VirtualHost>
Her sanal konağın ya farklı bir IP adresi ve port ile ya da farklı bir
konak ismiyle eşleşmesi gerekir. Birinci durumda sunucu makinesinin çok
sayıda adresten IP paketleri kabul edecek şekilde yapılandırılması
gerekir. (Eğer makinede çok sayıda ağ arabirimi yoksa bu, işletim sistemi
desteklediği takdirde ifconfig alias komutuyla
sağlanabilir.)
<VirtualHost> kullanımı Apache
httpd’nin dinleyeceği adresler üzerinde belirleyici değildir. Apache
httpd’nin doğru adresi dinlediğinden emin olmak için Listen kullanmanız gerekebilir.
Her <VirtualHost> bloku içinde bir
ServerName yönergesi mutlaka
olmalıdır. Yokluğu halinde "ana" sunucu yapılandırmasındaki ServerName miras alınacaktır.
Bir istek alındığında, sunucu isteği, sadece yerel IP adresi ve port
çiftine dayalı en iyi eşleşen ilk <VirtualHost> bölümüne eşler. Joker kullanmayanlar daha
yüksek önceliğe sahiptir. IP ve port çiftine dayalı bir eşleşme
bulunamazsa istek için ana sunucu yapılandırması kullanılır.
En iyi eşleşen IP adresi ve port çiftini birden fazla sanal konak kullanıyorsa sunucu bu sanal konaklar (liste) arasından istenen konak ismiyle en iyi eşleşeni seçer. Eşleşen hiçbir isme dayalı sanal konak yoksa listedeki IP adresi ile eşleşen ilk sanal konak kullanılır. Bunun sonucu olarak, belirtilen IP adresi ve port çifti için listedeki ilk sanal konak, bu IP adresi ve port çifti için öntanımlı sanal konaktır.
Günlük dosyalarının sunucuyu çalıştıran kullanıcıdan başka herkes tarafından yazılabilen bir yerde saklanmasından dolayı ortaya çıkabilecek güvenlik sorunları hakkında daha ayrıntılı bilgi için güvenlik ipuçları belgesine bakınız.
Serveur HTTP Apache Version 2.4
| Description: | Fonctionnalités de base du serveur HTTP Apache toujours disponibles |
|---|---|
| Statut: | Noyau httpd |
AcceptFilter AcceptPathInfo AccessFileName AddDefaultCharset AllowEncodedSlashes AllowOverride AllowOverrideList CGIMapExtension CGIPassAuth CGIVar ContentDigest DefaultRuntimeDir DefaultType Define <Directory> <DirectoryMatch> DocumentRoot <Else> <ElseIf> EnableMMAP EnableSendfile Error ErrorDocument ErrorLog ErrorLogFormat ExtendedStatus FileETag <Files> <FilesMatch> FlushMaxPipelined FlushMaxThreshold ForceType GprofDir HostnameLookups HttpProtocolOptions <If> <IfDefine> <IfDirective> <IfFile> <IfModule> <IfSection> Include IncludeOptional KeepAlive KeepAliveTimeout <Limit> <LimitExcept> LimitInternalRecursion LimitRequestBody LimitRequestFields LimitRequestFieldSize LimitRequestLine LimitXMLRequestBody <Location> <LocationMatch> LogLevel MaxKeepAliveRequests MaxRangeOverlaps MaxRangeReversals MaxRanges MergeSlashes MergeTrailers Mutex NameVirtualHost Options Protocol Protocols ProtocolsHonorOrder QualifyRedirectURL ReadBufferSize RegexDefaultOptions RegisterHttpMethod RLimitCPU RLimitMEM RLimitNPROC ScriptInterpreterSource SeeRequestTail ServerAdmin ServerAlias ServerName ServerPath ServerRoot ServerSignature ServerTokens SetHandler SetInputFilter SetOutputFilter StrictHostCheck TimeOut TraceEnable UNCList UnDefine UseCanonicalName UseCanonicalPhysicalPort <VirtualHost>| Description: | Permet d'optimiser la configuration d'une socket pour l'écoute d'un protocole |
|---|---|
| Syntaxe: | AcceptFilter protocole filtre
d'acceptation |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
Cette directive permet d'effectuer une optimisation de la socket
d'écoute d'un type de protocole en fonction du système
d'exploitation. Le but premier est de faire en sorte que le noyau
n'envoie pas de socket au processus du serveur jusqu'à ce que
des données soient reçues, ou qu'une requête HTTP complète soit mise
en tampon. Seuls les Filtres d'acceptation de FreeBSD, le filtre plus
primitif TCP_DEFER_ACCEPT sous Linux, et la version
optimisée d'AcceptEx() de Windows sont actuellement supportés.
L'utilisation de l'argument none va désactiver tout
filtre d'acceptation pour ce protocole. Ceci s'avère utile pour les
protocoles qui nécessitent l'envoi de données par le serveur en
premier, comme ftp: ou nntp:
AcceptFilter nntp none
Les noms de protocoles par défaut sont https pour le
port 443 et http pour tous les autres ports. Pour
spécifier un autre protocole à utiliser avec un port en écoute,
ajoutez l'argument protocol à la directive Listen.
Sous FreeBSD, les valeurs par défaut sont :
AcceptFilter http httpready AcceptFilter https dataready
Le filtre d'acceptation httpready met en tampon des
requêtes HTTP entières au niveau du noyau. Quand une requête
entière a été reçue, le noyau l'envoie au serveur. Voir la page de
manuel de accf_http(9) pour plus de détails. Comme les requêtes
HTTPS sont chiffrées, celles-ci n'autorisent que le filtre accf_data(9).
Sous Linux, les valeurs par défaut sont :
AcceptFilter http data AcceptFilter https data
Le filtre TCP_DEFER_ACCEPT de Linux ne supporte pas
la mise en tampon des requêtes http. Toute valeur autre que
none active le filtre TCP_DEFER_ACCEPT
pour ce protocole. Pour plus de détails, voir la page de
manuel Linux de tcp(7).
Sous Windows, les valeurs par défaut sont :
AcceptFilter http connect AcceptFilter https connect
Le module MPM pour Windows mpm_winnt utilise la directive
AcceptFilter comme commutateur de l'API AcceptEx(), et ne supporte
pas la mise en tampon du protocole http. connect
utilise l'API AcceptEx(), extrait aussi les adresses réseau finales,
mais à l'instar de none, la valeur connect
n'attend pas la transmission des données initiales.
Sous Windows, none utilise accept() au lieu
d'AcceptEx(), et ne recycle pas les sockets entre les connexions.
Ceci s'avère utile pour les interfaces réseau dont le pilote est
défectueux, ainsi que pour certains fournisseurs de réseau comme les
pilotes vpn, ou les filtres anti-spam, anti-virus ou
anti-spyware.
data (Windows)Jusqu'à la version 2.4.23, le filtre d'acceptation data
attendait que des données aient été transmises et que le tampon de données
initial et l'adresse réseau finale aient été déterminés par l'invocation
AcceptEx(). Cette implémentation étant vulnérable à une attaque de type
denial of service, elle a été désactivée.
La version actuelle de httpd prend par défaut le filtre
connect sous Windows, et reprendra la valeur
data si data est spécifié. Il est fortement
conseillé aux utilisateurs des versions plus anciennes de définir
explicitement le filtre connect pour leurs AcceptFilter
comme indiqué plus haut.
| Description: | Les ressources acceptent des informations sous forme d'un nom de chemin en fin de requête. |
|---|---|
| Syntaxe: | AcceptPathInfo On|Off|Default |
| Défaut: | AcceptPathInfo Default |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
Cette directive permet de définir si les requêtes contenant des
informations sous forme d'un nom de chemin suivant le nom d'un
fichier réel (ou un fichier qui n'existe pas dans un répertoire qui
existe) doivent être acceptées ou rejetées. Les scripts peuvent
accéder à cette information via la variable d'environnement
PATH_INFO.
Supposons par exemple que /test/ pointe vers un
répertoire qui ne contient que le fichier here.html.
Les requêtes pour /test/here.html/more et
/test/nothere.html/more vont affecter la valeur
/more à la variable d'environnement
PATH_INFO.
L'argument de la directive AcceptPathInfo
possède trois valeurs possibles :
Off/test/here.html/more dans l'exemple ci-dessus
renverra une erreur "404 NOT FOUND".On/test/here.html/more, la requête
sera acceptée si /test/here.html correspond à un nom de
fichier valide.DefaultPATH_INFO. Les gestionnaires qui
servent des scripts, commecgi-script et isapi-handler, acceptent en général par
défaut les requêtes avec PATH_INFO.Le but premier de la directive AcceptPathInfo est de
vous permettre de remplacer le choix du gestionnaire d'accepter ou
de rejeter PATH_INFO. Ce remplacement est nécessaire
par exemple, lorsque vous utilisez un filtre, comme INCLUDES, pour générer un contenu basé
sur PATH_INFO. Le gestionnaire de base va en général
rejeter la requête, et vous pouvez utiliser la configuration
suivante pour utiliser un tel script :
<Files "mypaths.shtml"> Options +Includes SetOutputFilter INCLUDES AcceptPathInfo On </Files>
| Description: | Nom du fichier de configuration distribué |
|---|---|
| Syntaxe: | AccessFileName nom-du-fichier
[nom-du-fichier] ... |
| Défaut: | AccessFileName .htaccess |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
Au cours du traitement d'une requête, le serveur recherche le premier fichier de configuration existant à partir de la liste de noms dans chaque répertoire composant le chemin du document, à partir du moment où les fichiers de configuration distribués sont activés pour ce répertoire. Par exemple :
AccessFileName .acl
avant de renvoyer le document
/usr/local/web/index.html, le serveur va rechercher les
fichiers /.acl, /usr/.acl,
/usr/local/.acl et /usr/local/web/.acl
pour y lire d'éventuelles directives, à moins quelles n'aient été
désactivées avec
<Directory "/">
AllowOverride None
</Directory>
| Description: | Paramètre jeu de caractères par défaut à ajouter quand le
type de contenu d'une réponse est text/plain ou
text/html |
|---|---|
| Syntaxe: | AddDefaultCharset On|Off|jeu de caractères |
| Défaut: | AddDefaultCharset Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
Cette directive spécifie une valeur par défaut pour le paramètre
jeu de caractères du type de média (le nom d'un codage de
caractères) à ajouter à une réponse, si et seulement si le type de
contenu de la réponse est soit text/plain, soit
text/html. Ceci va remplacer
tout jeu de caractères spécifié dans le corps de la réponse via un
élément META, bien que cet effet dépende en fait
souvent de la configuration du client de l'utilisateur. La
définition de AddDefaultCharset Off désactive cette
fonctionnalité. AddDefaultCharset On ajoute un jeu de
caractères par défaut de iso-8859-1. Toute autre valeur
peut être définie via le paramètre jeu de caractères, qui
doit appartenir à la liste des valeurs de
jeux de caractères enregistrés par l'IANA à utiliser dans les
types de média Internet (types MIME).
Par exemple :
AddDefaultCharset utf-8
La directive AddDefaultCharset ne doit
être utilisée que lorsque toutes les ressources textes auxquelles
elle s'applique possèdent le jeu de caractère spécifié, et qu'il est
trop contraignant de définir leur jeu de caractères
individuellement. Un exemple de ce type est l'ajout du paramètre jeu
de caractères aux ressources comportant un contenu généré, comme les
scripts CGI hérités qui peuvent être vulnérables à des attaques de
type cross-site scripting à cause des données utilisateurs incluses
dans leur sortie. Notez cependant qu'une meilleur solution consiste
à corriger (ou supprimer) ces scripts, car la définition d'un jeu de
caractères par défaut ne protège pas les utilisateurs qui ont activé
la fonctionnalité "Détection automatique de l'encodage des
caractères" dans leur navigateur.
| Description: | Détermine si les séparateurs de chemin encodés sont autorisés à transiter dans les URLs tels quels |
|---|---|
| Syntaxe: | AllowEncodedSlashes On|Off|NoDecode |
| Défaut: | AllowEncodedSlashes Off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | L'option NoDecode est disponible depuis la version 2.3.12. |
La directive AllowEncodedSlashes permet
l'utilisation des URLs contenant des séparateurs de chemin
encodés dans la partie chemin
(%2F pour / et même %5C pour
\ sur les systèmes concernés).
Avec la valeur par défaut, Off, de telles URLs sont
refusées et provoquent le renvoi d'une erreur 404 (Not found).
Avec la valeur On, ces URLs sont acceptées, et les
slashes encodés sont décodés comme tout autre caractère codé.
Avec la valeur NoDecode, ces URLs sont acceptées,
mais les slashes codés ne sont pas décodés et laissés dans leur état
codé.
Définir AllowEncodedSlashes à
On est surtout utile en association avec
PATH_INFO.
Si le codage des slashes dans la partie chemin est nécessaire,
l'utilisation de l'option NoDecode est fortement
recommandée par mesure de sécurité. Permettre le décodage des
slashes pourrait éventuellement induire l'autorisation de chemins
non sûrs.
| Description: | Types de directives autorisées dans les fichiers
.htaccess |
|---|---|
| Syntaxe: | AllowOverride All|None|type directive
[type directive] ... |
| Défaut: | AllowOverride None à partir de la version 2.3.9, AllowOverride
All pour les versions antérieures |
| Contexte: | répertoire |
| Statut: | Noyau httpd |
| Module: | core |
Lorsque le serveur trouve un fichier .htaccess (dont
le nom est défini par la directive AccessFileName), il doit savoir lesquelles
des directives placées dans ce fichier sont autorisées à modifier la
configuration préexistante.
AllowOverride ne peut être
utilisée que dans les sections <Directory> définies sans expressions
rationnelles, et non dans les sections <Location>, <DirectoryMatch> ou
<Files>.
Lorsque cette directive et la directive AllowOverrideList sont définies à None, les
fichiers .htaccess sont totalement
ignorés. Dans ce cas, le serveur n'essaiera même pas de lire les
fichiers .htaccess du système de fichiers.
Lorsque cette directive est définie à All, toute
directive valable dans le Contexte .htaccess sera
autorisée dans les fichiers .htaccess.
L'argument type directive peut contenir les groupements de directives suivants (voir ce document pour obtenir la liste à jour des directives activées pour chaque type de directive) :
AuthDBMGroupFile,
AuthDBMUserFile,
AuthGroupFile,
AuthName,
AuthType, AuthUserFile, Require, etc...).ErrorDocument, ForceType, LanguagePriority,
SetHandler, SetInputFilter, SetOutputFilter, et directives du
module mod_mime Add* et Remove*), des metadonnées
des documents (Header, RequestHeader, SetEnvIf, SetEnvIfNoCase, BrowserMatch, CookieExpires, CookieDomain, CookieStyle, CookieTracking, CookieName), des directives du
module mod_rewrite directives (RewriteEngine, RewriteOptions, RewriteBase, RewriteCond, RewriteRule), des directives du
module mod_alias directives (Redirect, RedirectTemp, RedirectPermanent, RedirectMatch), et de la directive
Action du module
mod_actions.
AddDescription,
AddIcon, AddIconByEncoding,
AddIconByType,
DefaultIcon, DirectoryIndex, FancyIndexing,
HeaderName, IndexIgnore, IndexOptions, ReadmeName,
etc...).Allow, Deny et Order).Notez qu'une erreur de syntaxe dans une directive valide causera toujours une internal server error.
Options et XBitHack). "Options" doit être
suivi d'un signe "égal", puis d'une liste d'options séparées par des
virgules (pas d'espaces) ; ces options doivent être définies à
l'aide de la commande Options.
Bien que la liste des options disponibles dans les fichiers
.htaccess puisse être limitée par cette directive, tant qu'un
directive Options est
autorisée, toute autre option héritée peut être désactivée en
utilisant la syntaxe non-relative. En d'autres termes, ce
mécanisme ne peut pas forcer une option spécifique à rester
activée tout en permettant à toute autre option d'être
activée.
AllowOverride Options=Indexes,MultiViews
Exemple :
AllowOverride AuthConfig Indexes
Dans l'exemple ci-dessus, toutes les directives qui ne font
partie ni du groupe AuthConfig, ni du groupe
Indexes, provoquent une erreur "internal
server error".
Pour des raisons de sécurité et de performance, ne
définissez pas AllowOverride à autre chose que
None dans votre bloc <Directory "/">.
Recherchez plutôt (ou créez) le bloc <Directory>
qui se réfère au répertoire où vous allez précisément placer un
fichier .htaccess.
| Description: | Directives autorisées dans les fichiers .htaccess |
|---|---|
| Syntaxe: | AllowOverrideList None|directive
[directive-type] ... |
| Défaut: | AllowOverrideList None |
| Contexte: | répertoire |
| Statut: | Noyau httpd |
| Module: | core |
Lorsque le serveur trouve un fichier .htaccess
(comme spécifié par la directive AccessFileName), il doit savoir lesquelles
des directives déclarées dans ce fichier peuvent remplacer des
directives des fichiers de configuration du serveur.
AllowOverrideList n'est
disponible que dans les sections <Directory> spécifiées sans expressions
rationnelles.
Lorsque cette directive et la directive AllowOverride sont définies à
None, les fichiers .htaccess sont totalement ignorés. Dans
ce cas, le serveur ne cherchera même pas à lire des fichiers
.htaccess dans le système de fichiers.
Example:
AllowOverride None AllowOverrideList Redirect RedirectMatch
Dans l'exemple ci-dessus, seules les directives
Redirect et RedirectMatch sont autorisées.
Toutes les autres provoqueront une erreur interne du serveur.
Example:
AllowOverride AuthConfig AllowOverrideList CookieTracking CookieName
Dans l'exemple ci-dessus, la directive AllowOverride autorise les directives du
groupement AuthConfig, et
AllowOverrideList n'autorise que deux directives du
groupement FileInfo. Toutes les autres provoqueront une erreur
interne du serveur.
| Description: | Technique permettant de localiser l'interpréteur des scripts CGI |
|---|---|
| Syntaxe: | CGIMapExtension chemin CGI .extension |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | NetWare uniquement |
Cette directive permet de contrôler la manière dont Apache httpd trouve
l'interpréteur servant à exécuter les scripts CGI. Par exemple, avec
la définition CGIMapExtension sys:\foo.nlm .foo, tous
les fichiers scripts CGI possédant une extension .foo
seront passés à l'interpréteur FOO.
| Description: | Active la transmission d'en-têtes d'autorisation HTTP aux scripts en tant que variables CGI |
|---|---|
| Syntaxe: | CGIPassAuth On|Off |
| Défaut: | CGIPassAuth Off |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.13 du serveur HTTP Apache |
La directive CGIPassAuth permet aux
scripts d'accéder aux en-têtes d'autorisation HTTP tels que
Authorization, en-tête nécessaire aux scripts qui
implémente une authentification HTTP de base. Normalement, ces
en-têtes HTTP sont invisibles pour les scripts car ils leurs
permettraient de voir les identifiants et mots de passe
utilisés pour accéder au serveur lorsque l'authentification HTTP de
base est activée au niveau du serveur web. Cette directive doit être
définie à "On" lorsque des scripts sont autorisés à implémenter une
authentification HTTP de base.
Cette directive constitue une alternative à l'option de
compilation SECURITY_HOLE_PASS_AUTHORIZATION qui était
déjà disponible dans les versions précédentes du serveur HTTP
Apache.
Cette option est prise en compte par tout module qui utilise
ap_add_common_vars(), comme mod_cgi,
mod_cgid, mod_proxy_fcgi,
mod_proxy_scgi, etc... En particulier, elle affecte
les modules qui ne traitent pas à proprement parler les requêtes,
mais utilisent quand-même cette API, comme
mod_include ou mod_ext_filter. Les
modules tiers qui n'utilisent pas ap_add_common_vars()
peuvent aussi choisir de prendre en compte cette option.
| Description: | Contrôle la manière dont certaines variables CGI sont définies |
|---|---|
| Syntaxe: | CGIVar variable rule |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.21 du serveur HTTP Apache |
Cette directive permet de contrôler la manière dont certaines variables CGI sont définies.
règles REQUEST_URI :
original-uri (valeur par défaut)current-uri| Description: | Active la génération d'un en-tête Content-MD5
dans la réponse HTTP |
|---|---|
| Syntaxe: | ContentDigest On|Off |
| Défaut: | ContentDigest Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Noyau httpd |
| Module: | core |
Cette directive active la génération d'un en-tête
Content-MD5 selon les définitions des RFC 1864 et
2616.
MD5 est un algorithme permettant de générer un condensé (parfois appelé "empreinte") à partir de données d'une taille aléatoire ; le degré de précision est tel que la moindre altération des données d'origine entraîne une altération de l'empreinte.
L'en-tête Content-MD5 permet de vérifier
l'intégrité de la réponse HTTP dans son ensemble. Un serveur mandataire
ou un client peut utiliser cet en-tête pour rechercher une
éventuelle modification accidentelle de la réponse au cours de sa
transmission. Exemple d'en-tête :
Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
Notez que des problèmes de performances peuvent affecter votre serveur, car l'empreinte est générée pour chaque requête (il n'y a pas de mise en cache).
L'en-tête Content-MD5 n'est envoyé qu'avec les
documents servis par le module core, à l'exclusion
de tout autre module. Ainsi, les documents SSI, les sorties de
scripts CGI, et les réponses à des requêtes partielles (byte range)
ne comportent pas cet en-tête.
| Description: | Répertoire de base des fichiers créés au cours de l'exécution du serveur |
|---|---|
| Syntaxe: | DefaultRuntimeDir chemin-répertoire |
| Défaut: | DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/) |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible depuis la version 2.4.2 du serveur HTTP Apache |
La directive DefaultRuntimeDir permet de
définir le répertoire dans lequel le serveur va créer les différents
fichiers relatifs à son exécution (mémoire partagée, verrous,
etc...). Si le chemin spécifié est relatif, le chemin absolu sera
généré relativement à la valeur de la directive
ServerRoot
Example
DefaultRuntimeDir scratch/
La valeur par défaut de la directive
DefaultRuntimeDir peut être modifiée en
changeant la valeur de la macro DEFAULT_REL_RUNTIMEDIR
définie à la compilation.
Note: si la valeur de ServerRoot n'a pas
été spécifiée avant d'utiliser cette directive, c'est la valeur par
défaut de ServerRoot qui sera utilisée pour
définir la base du répertoire.
ServerRoot| Description: | Les seuls effets de cette directive sont des émissions
d'avertissements si sa valeur est différente de none. Dans
les versions précédentes, DefaultType permettait de spécifier un type de
média à assigner par défaut au contenu d'une réponse pour lequel aucun
autre type de média n'avait été trouvé.
|
|---|---|
| Syntaxe: | DefaultType type média|none |
| Défaut: | DefaultType none |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | L'argument none est disponible dans les
versions d'Apache httpd 2.2.7 et supérieures. Tous les autres choix sont
DESACTIVÉS à partir des version 2.3.x. |
Cette directive a été désactivée. Pour la compatibilité
ascendante avec les anciens fichiers de configuration, elle peut
être spécifiée avec la valeur none, c'est à dire sans
type de médium par défaut. Par exemple :
DefaultType None
DefaultType None n'est disponible que dans les
versions d'Apache 2.2.7 et supérieures.
Utilisez le fichier de configuration mime.types et la directive
AddType pour configurer
l'assignement d'un type de médium via les extensions de fichiers, ou
la directive ForceType pour
attribuer un type de médium à des ressources spécifiques. Dans le
cas contraire, le serveur enverra sa réponse sans champ d'en-tête
Content-Type, et le destinataire devra déterminer lui-même le type
de médium.
| Description: | Permet de définir une variable |
|---|---|
| Syntaxe: | Define nom-paramètre [valeur-paramètre] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Noyau httpd |
| Module: | core |
Avec un seul paramètre, l'effet de la directive
Define est identique à celui de l'argument
-D du programme httpd. Il permet de
modifier le comportement des sections <IfDefine> sans avoir à ajouter d'argument
-D au sein des scripts de démarrage.
De plus, le second paramètre permet d'affecter une valeur à la
variable définie par le premier. Cette variable peut être référencée
dans le fichier de configuration via la syntaxe ${VAR}.
La portée de la variable est toujours globale, et n'est jamais
limitée à la section de configuration courante.
<IfDefine TEST>
Define servername test.example.com
</IfDefine>
<IfDefine !TEST>
Define servername www.example.com
Define SSL
</IfDefine>
DocumentRoot "/var/www/${servername}/htdocs"
Le caractère ":" est interdit dans les noms de variables afin
d'éviter les conflits avec la syntaxe de la directive RewriteMap.
Si cette directive est définie au sein d'un bloc VirtualHost, les changements qu'elle induit sont visibles de toute directive ultérieure, au delà de tout bloc VirtualHost.
| Description: | Regroupe un ensemble de directives qui ne s'appliquent qu'au répertoire concerné du système de fichiers, à ses sous-répertoires, et à leur contenu. |
|---|---|
| Syntaxe: | <Directory chemin répertoire>
... </Directory> |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
Les balises <Directory> et
</Directory> permettent de regrouper un ensemble
de directives qui ne s'appliquent qu'au répertoire précisé,
à ses sous-répertoires, et aux fichiers situés dans ces
sous-répertoires. Toute directive
autorisée dans un contexte de répertoire peut être utilisée.
chemin répertoire est soit le chemin absolu d'un
répertoire, soit une chaîne de caractères avec caractères génériques
utilisant la comparaison Unix de style shell. Dans une chaîne de
caractères avec caractères génériques, ? correspond à
un caractère quelconque, et * à toute chaîne de
caractères. Les intervalles de caractères [] sont aussi
autorisés. Aucun caractère générique ne peut remplacer le caractère
`/', si bien que l'expression <Directory
"/*/public_html"> ne conviendra pas pour le chemin
* /home/user/public_html, alors que <Directory
"/home/*/public_html"> conviendra. Exemple :
<Directory "/usr/local/httpd/htdocs"> Options Indexes FollowSymLinks </Directory>
Les chemins de répertoires contenant des espaces doivent être entourés de guillemets afin d'empêcher l'interprétation de ces espaces comme fins d'arguments.
Soyez prudent avec l'argument chemin répertoire : il
doit correspondre exactement au chemin du système de fichier
qu'Apache httpd utilise pour accéder aux fichiers. Les directives
comprises dans une section <Directory> ne
s'appliqueront pas aux fichiers du même répertoire auxquels on
aura accédé via un chemin différent, per exemple via un lien
symbolique.
Les Expressions rationnelles
peuvent aussi être utilisées en ajoutant le caractère
~. Par exemple :
<Directory ~ "^/www/[0-9]{3}">
</Directory>
pourra correspondre à tout répertoire situé dans /www/ et dont le nom se compose de trois chiffres.
Si plusieurs sections <Directory> (sans expression rationnelle)
correspondent au répertoire (ou à un de ses parents) qui contient le
document, les directives de la section <Directory> dont le chemin est le plus
court sont appliquées en premier, en s'intercalant avec les
directives des fichiers .htaccess. Par
exemple, avec
<Directory "/"> AllowOverride None </Directory> <Directory "/home"> AllowOverride FileInfo </Directory>
l'accès au document /home/web/dir/doc.html emprunte
le chemin suivant :
AllowOverride None
(qui désactive les fichiers .htaccess).AllowOverride
FileInfo (pour le répertoire /home).FileInfo qui se
trouverait dans d'éventuels fichiers /home/.htaccess,
/home/web/.htaccess ou
/home/web/dir/.htaccess, dans cet ordre.Les directives associées aux répertoires sous forme d'expressions rationnelles ne sont prises en compte qu'une fois toutes les directives des sections sans expressions rationnelles appliquées. Alors, tous les répertoires avec expressions rationnelles sont testés selon l'ordre dans lequel ils apparaissent dans le fichier de configuration. Par exemple, avec
<Directory ~ "abc$"> # ... directives ici ... </Directory>
la section avec expression rationnelle ne sera prise en compte
qu'après les sections <Directory> sans expression rationnelle
et les fichiers .htaccess. Alors, l'expression
rationnelle conviendra pour /home/abc/public_html/abc
et la section <Directory>
correspondante s'appliquera.
Notez que la politique d'accès par défaut
dans les sections <Directory "/"> consiste à
autoriser tout accès sans restriction. Ceci signifie qu'Apache httpd va servir tout fichier
correspondant à une URL. Il est recommandé de modifier cette
situation à l'aide d'un bloc du style
<Directory "/"> Require all denied </Directory>
puis d'affiner la configuration pour les répertoires que vous voulez rendre accessibles. Voir la page Conseils à propos de sécurité pour plus de détails.
Les sections <Directory> se situent
dans le fichier httpd.conf. Les directives <Directory> ne peuvent pas être imbriquées
et ne sont pas autorisées dans les sections <Limit> ou <LimitExcept>.
| Description: | Regroupe des directives qui s'appliquent au contenu de répertoires du système de fichiers correspondant à une expression rationnelle |
|---|---|
| Syntaxe: | <DirectoryMatch regex>
... </DirectoryMatch> |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
Les balises <DirectoryMatch>
et </DirectoryMatch> permettent de regrouper un
ensemble de directives qui ne s'appliqueront qu'au répertoire
précisé (et aux fichiers qu'il contient), comme pour la section <Directory>. Cependant, le
répertoire est précisé sous la forme d'une expression rationnelle. Par exemple :
<DirectoryMatch "^/www/(.+/)?[0-9]{3}/">
# ...
</DirectoryMatch>
convient pour les sous-répertoires de /www/ dont
le nom se compose de trois chiffres.
<Directory>), et ne tenait pas compte du
symbole de fin de ligne ($). Depuis la version 2.3.9, seuls les
répertoires qui correspondent à l'expression sont affectés par les
directives contenues dans la section.
A partir de la version 2.4.8, les groupes nommés et les
références arrières sont extraits et enregistrés dans
l'environnement avec leur nom en majuscules et préfixé
par "MATCH_". Ceci permet
de référencer des URLs dans des expressions
ou au sein de modules comme mod_rewrite. Pour
éviter toute confusion, les références arrières numérotées (non
nommées) sont ignorées. Vous devez utiliser à la place des groupes
nommés.
<DirectoryMatch "^/var/www/combined/(?<sitename>[^/]+)">
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</DirectoryMatch>
<Directory>
pour une description de la manière dont les expressions rationnelles
sont traitées en présence d'autres sections <Directory> sans expressions rationnelles| Description: | Racine principale de l'arborescence des documents visible depuis Internet |
|---|---|
| Syntaxe: | DocumentRoot chemin répertoire |
| Défaut: | DocumentRoot "/usr/local/apache/htdocs" |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
Cette directive permet de définir le répertoire à partir duquel
httpd va servir les fichiers. S'il ne correspond
pas à un Alias, le chemin
de l'URL sera ajouté par le serveur à la racine des documents afin
de construire le chemin du document recherché. Exemple :
DocumentRoot "/usr/web"
un accès à http://my.example.com/index.html se
réfère alors à /usr/web/index.html. Si chemin
répertoire n'est pas un chemin absolu, il est considéré comme
relatif au chemin défini par la directive ServerRoot.
Le répertoire défini par la directive
DocumentRoot ne doit pas comporter de slash
final.
| Description: | Contient des directives qui ne s'appliquent que si la
condition correspondant à la section <If> ou <ElseIf> précédente n'est pas satisfaite par la
requête à l'exécution |
|---|---|
| Syntaxe: | <Else> ... </Else> |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Les conditions imbriquées sont supportées à partir de la version 2.4.26 du serveur HTTP Apache |
La section <Else> applique
les directives qu'elle contient si et seulement si les conditions
correspondant à la section <If>
ou <ElseIf> immédiatement
supérieure et dans la même portée n'ont pas été satisfaites. Par
exemple, dans :
<If "-z req('Host')">
# ...
</If>
<Else>
# ...
</Else>
La condition de la section <If> serait satisfaite pour les requêtes
HTTP/1.0 sans en-tête Host:, alors que celle de la section
<Else> le serait pour les
requêtes comportant un en-tête Host:.
<If><ElseIf><If>,
<ElseIf>, et <Else> s'appliquent en dernier.| Description: | Contient des directives qui ne s'appliquent que si la
condition correspondante est satisfaite par une requête à l'exécution,
alors que la condition correspondant à la section <If> ou <ElseIf> précédente ne l'était pas. |
|---|---|
| Syntaxe: | <ElseIf expression> ... </ElseIf> |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Les conditions imbriquées sont supportées à partir de la version 2.4.26 du serveur HTTP Apache |
La section <ElseIf> applique
les directives qu'elle contient si et seulement si d'une part la
condition correspondante est satisfaite, et d'autre part la condition
correspondant à la section <If>
ou <ElseIf> de la même portée ne
l'est pas. Par exemple, dans :
<If "-R '10.1.0.0/16'"> #... </If> <ElseIf "-R '10.0.0.0/8'"> #... </ElseIf> <Else> #... </Else>
La condition correspondant à la section <ElseIf> est satisfaite si l'adresse
distante de la requête appartient au sous-réseau 10.0.0.0/8, mais
pas si elle appartient au sous-réseau 10.1.0.0/16.
<If><Else><If>,
<ElseIf>, et <Else> s'appliquent en dernier.| Description: | Utilise la projection en mémoire (Memory-Mapping) pour lire les fichiers pendant qu'ils sont servis |
|---|---|
| Syntaxe: | EnableMMAP On|Off |
| Défaut: | EnableMMAP On |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
Cette directive définit si httpd peut utiliser
la projection en mémoire (Memory-Mapping) quand il doit lire le contenu
d'un fichier pendant qu'il est servi. Par défaut, lorsque le
traitement d'une requête requiert l'accès aux données contenues dans
un fichier -- par exemple, pour servir un fichier interprété par le
serveur à l'aide de mod_include -- Apache httpd projette
le fichier en mémoire si le système d'exploitation le permet.
Cette projection en mémoire induit parfois une amélioration des performances. Sur certains systèmes cependant, il est préférable de désactiver la projection en mémoire afin d'éviter certains problèmes opérationnels :
httpd.httpd, la suppression ou la troncature d'un
fichier peut provoquer un crash de httpd avec une
erreur de segmentation.Pour les configurations de serveur sujettes à ce genre de problème, il est préférable de désactiver la projection en mémoire des fichiers servis en spécifiant :
EnableMMAP Off
Pour les montages NFS, cette fonctionnalité peut être explicitement désactivée pour les fichiers concernés en spécifiant :
<Directory "/path-to-nfs-files"> EnableMMAP Off </Directory>
| Description: | Utilise le support sendfile du noyau pour servir les fichiers aux clients |
|---|---|
| Syntaxe: | EnableSendfile On|Off |
| Défaut: | EnableSendfile Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Par défaut à Off depuis la version 2.3.9. |
Cette directive définit si le programme httpd
peut utiliser le support sendfile du noyau pour transmettre le
contenu des fichiers aux clients. Par défaut, lorsque le traitement
d'une requête ne requiert pas l'accès aux données contenues dans un
fichier -- par exemple, pour la transmission d'un fichier statique
-- Apache httpd utilise sendfile pour transmettre le contenu du fichier
sans même lire ce dernier, si le système d'exploitation le
permet.
Ce mécanisme sendfile évite la séparation des opérations de lecture et d'envoi, ainsi que les réservations de tampons. sur certains systèmes cependant, ou sous certains systèmes de fichiers, il est préférable de désactiver cette fonctionnalité afin d'éviter certains problèmes opérationnels :
sendfile peut s'avérer incapable de
traiter les fichiers de plus de 2 Go.DocumentRoot (par exemple NFS, SMB, CIFS,
FUSE), le
noyau peut s'avérer incapable de servir un fichier de ce montage
réseau en passant par son propre cache.Pour les configurations de serveur non sujettes à ce genre de problème, vous pouvez activer cette fonctionnalité en spécifiant :
EnableSendfile On
Pour les montages réseau, cette fonctionnalité peut être explicitement désactivée pour les fichiers concernés en spécifiant :
<Directory "/path-to-nfs-files"> EnableSendfile Off </Directory>
Veuillez noter que la configuration de la directive
EnableSendfile dans un contexte de répertoire
ou de fichier .htaccess n'est pas supportée par
mod_cache_disk. Le module ne prend en compte la
définition de EnableSendfile que dans un
contexte global.
| Description: | Interrompt la lecture de la configuration avec un message d'erreur personnalisé |
|---|---|
| Syntaxe: | Error message |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | à partir de la version 2.3.9 |
Si une erreur peut être détectée dans la configuration, souvent un module manquant, cette directive peut être utilisée pour générer un message d'erreur personnalisé, et interrompre la lecture de la configuration.
# Exemple # vérification du chargement de mod_include <IfModule !include_module> Error "mod_include is required by mod_foo. Load it with LoadModule." </IfModule> # vérification de la définition de SSL ou (exclusif) NOSSL <IfDefine SSL> <IfDefine NOSSL> Error "Both SSL and NOSSL are defined. Define only one of them." </IfDefine> </IfDefine> <IfDefine !SSL> <IfDefine !NOSSL> Error "Either SSL or NOSSL must be defined." </IfDefine> </IfDefine>
Cette directive est évaluée lors du traitement de la configuration,
et non à l'exécution. Par conséquent, elle ne peut pas être évaluée de
manière conditionnelle en l'incluant dans une section <If>.
| Description: | Document que le serveur renvoie au client en cas d'erreur |
|---|---|
| Syntaxe: | ErrorDocument code erreur document |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
Apache httpd peut traiter les problèmes et les erreurs de quatre manières,
La première option constitue le comportement par défaut; pour
choisir une des trois autres options, il faut configurer Apache à
l'aide de la directive ErrorDocument, suivie
du code de la réponse HTTP et d'une URL ou d'un message. Apache
httpd fournit parfois des informations supplémentaires à propos du
problème ou de l'erreur.
A partir de la version 2.4.13, il est possible d'utiliser la syntaxe des expressions dans cette directive afin de générer des chaînes et URLs dynamiques.
Les URLs peuvent commencer par un slash (/) pour les chemins web
locaux (relatifs au répertoire défini par la directive DocumentRoot), ou se présenter sous la
forme d'une URL complète que le client pourra résoudre.
Alternativement, un message à afficher par le navigateur pourra être
fourni. Notez que la décision de considérer le paramètre comme URL,
chemin ou message intervient avant toute interprètation
d'expression. Exemples :
ErrorDocument 500 http://example.com/cgi-bin/server-error.cgi
ErrorDocument 404 /errors/bad_urls.php
ErrorDocument 401 /subscription_info.html
ErrorDocument 403 "Sorry can't allow you access today"
ErrorDocument 403 Forbidden!
ErrorDocument 403 /errors/forbidden.py?referrer=%{escape:%{HTTP_REFERER}}
De plus, on peut spécifier la valeur spéciale default
pour indiquer l'utilisation d'un simple message d'Apache httpd codé en
dur. Bien que non nécessaire dans des circonstances normales, la
spécification de la valeur default va permettre de
rétablir l'utilisation du simple message d'Apache httpd codé en dur pour
les configurations qui sans cela, hériteraient d'une directive
ErrorDocument existante.
ErrorDocument 404 /cgi-bin/bad_urls.pl <Directory "/web/docs"> ErrorDocument 404 default </Directory>
Notez que lorsque vous spécifiez une directive
ErrorDocument pointant vers une URL distante
(c'est à dire tout ce qui commence par le préfixe http), le serveur
HTTP Apache va
envoyer une redirection au client afin de lui indiquer où trouver le
document, même dans le cas où ce document se trouve sur le serveur
local. Ceci a de nombreuses conséquences dont la plus importante
réside dans le fait que le client ne recevra pas le code d'erreur
original, mais au contraire un code de statut de redirection. Ceci
peut en retour semer la confusion chez les robots web et divers
clients qui tentent de déterminer la validité d'une URL en examinant
le code de statut. De plus, si vous utilisez une URL distante avec
ErrorDocument 401, le client ne saura pas qu'il doit
demander un mot de passe à l'utilisateur car il ne recevra pas le
code de statut 401. C'est pourquoi, si vous utilisez une
directive ErrorDocument 401, elle devra faire référence
à un document par le biais d'un chemin local.
Microsoft Internet Explorer (MSIE) ignore par défaut les messages d'erreur générés par le serveur lorsqu'ils sont trop courts et remplacent ses propres messages d'erreur "amicaux". Le seuil de taille varie en fonction du type d'erreur, mais en général, si la taille de votre message d'erreur est supérieure à 512 octets, il y a peu de chances pour que MSIE l'occulte, et il sera affiché par ce dernier. Vous trouverez d'avantage d'informations dans l'article de la base de connaissances Microsoft Q294807.
Bien que la plupart des messages d'erreur internes originaux
puissent être remplacés, ceux-ci sont cependant conservés dans
certaines circonstances sans tenir compte de la définition de la
directive ErrorDocument. En
particulier, en cas de détection d'une requête mal formée, le
processus de traitement normal des requêtes est immédiatement
interrompu, et un message d'erreur interne est renvoyé, ceci afin de
se prémunir contre les problèmes de sécurité liés aux requêtes mal
formées.
Si vous utilisez mod_proxy, il est en général préférable
d'activer ProxyErrorOverride afin d'être en
mesure de produire des messages d'erreur personnalisés pour le
compte de votre serveur d'origine. Si vous n'activez pas
ProxyErrorOverride, Apache httpd ne générera pas de messages d'erreur
personnalisés pour le contenu mandaté.
| Description: | Définition du chemin du journal des erreurs |
|---|---|
| Syntaxe: | ErrorLog file-path|syslog[:[facility][:tag]] |
| Défaut: | ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2) |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
La directive ErrorLog permet de définir le
nom du fichier dans lequel le serveur va journaliser toutes les
erreurs qu'il rencontre. Si le file-path n'est pas
absolu, il est considéré comme relatif au chemin défini par la
directive ServerRoot.
ErrorLog "/var/log/httpd/error_log"
Si le file-path commence par une barre verticale
"(|)", il est considéré comme une commande à lancer pour traiter la
journalisation de l'erreur.
ErrorLog "|/usr/local/bin/httpd_errors"
Voir les notes à propos des journaux redirigés pour plus d'informations.
L'utilisation de syslog à la place d'un nom de
fichier active la journalisation via syslogd(8) si le système le
supporte. Le dispositif syslog par défaut est local7,
mais vous pouvez le modifier à l'aide de la syntaxe
syslog:facility, où facility peut
être remplacé par un des noms habituellement documentés dans la page
de man syslog(1). Le dispositif syslog local7 est
global, et si il est modifié dans un serveur virtuel, le dispositif
final spécifié affecte l'ensemble du serveur. La même règle s'applique au
tag syslog qui utilise par défaut le nom du binaire du serveur HTTP Apache
httpd dans la plupart des cas. Vous pouvez aussi modifier cette
valeur en utilisant la syntaxe syslog::tag.
ErrorLog syslog:user ErrorLog syslog:user:httpd.srv1 ErrorLog syslog::httpd.srv2
SECURITE : Voir le document conseils à propos de sécurité pour des détails sur les raisons pour lesquelles votre sécurité peut être compromise si le répertoire contenant les fichiers journaux présente des droits en écriture pour tout autre utilisateur que celui sous lequel le serveur est démarré.
Lors de la spécification d'un chemin de fichier sur les plates-formes non-Unix, on doit veiller à n'utiliser que des slashes (/), même si la plate-forme autorise l'utilisation des anti-slashes (\). Et d'une manière générale, il est recommandé de n'utiliser que des slashes (/) dans les fichiers de configuration.
| Description: | Spécification du format des entrées du journal des erreurs |
|---|---|
| Syntaxe: | ErrorLogFormat [connection|request] format |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
La directive ErrorLogFormat permet de
spécifier quelles informations supplémentaires vont être enregistrées
dans le journal des erreurs en plus du message habituel.
# Exemple simple ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"
La spécification de connection ou
request comme premier paramètre permet de définir des
formats supplémentaires, ce qui a pour effet de journaliser des
informations additionnelles lorsque le premier message est
enregistré respectivement pour une connexion ou une requête
spécifique. Ces informations additionnelles ne sont enregistrées
qu'une seule fois par connexion/requête. Si le traitement d'une
connexion ou d'une requête ne génère aucun message dans le journal,
alors aucune information additionnelle n'est enregistrée.
Il peut arriver que certains items de la chaîne de format ne
produisent aucune sortie. Par exemple, l'en-tête Referer n'est
présent que si le message du journal est associé à une requête et s'il
est généré à un moment où l'en-tête Referer a déjà été lu par le
client. Si aucune sortie n'est générée, le comportement par défaut
consiste à supprimer tout ce qui se trouve entre l'espace précédent
et le suivant. Ceci implique que la ligne de journalisation est
divisée en champs ne contenant pas d'espace séparés par des espaces.
Si un item de la chaîne de format ne génère aucune sortie,
l'ensemble du champ est omis. Par exemple, si l'adresse distante
%a du format [%t] [%l] [%a] %M n'est
pas disponible, les crochets qui l'entourent ne seront eux-mêmes pas
enregistrés. Il est possible d'échapper les espaces par un anti-slash
afin qu'ils ne soient pas considérés comme séparateurs de champs.
La combinaison '% ' (pourcentage espace) est un délimiteur de
champ de taille nulle qui ne génère aucune sortie.
Ce comportement peut être changé en ajoutant des modificateurs à
l'item de la chaîne de format. Le modificateur -
(moins) provoque l'enregistrement d'un signe moins si l'item
considéré ne génère aucune sortie. Pour les formats à enregistrement
unique par connexion/requête, il est aussi possible d'utiliser le
modificateur + (plus). Si un item ne générant aucune
sortie possède le modificateur plus, la ligne dans son ensemble est
omise.
Un modificateur de type entier permet d'assigner un niveau de sévérité à un item de format. L'item considéré ne sera journalisé que si la sévérité du message n'est pas plus haute que le niveau de sévérité spécifié. Les valeurs possibles vont de 1 (alert) à 15 (trace8), en passant par 4 (warn) ou 7 (debug).
Par exemple, voici ce qui arriverait si vous ajoutiez des
modificateurs à l'item %{Referer}i qui enregistre le
contenu de l'en-tête Referer.
| Item modifié | Signification |
|---|---|
%-{Referer}i |
Enregistre le caractère - si l'en-tête
Referer n'est pas défini. |
%+{Referer}i |
N'enregistre rien si l'en-tête
Referer n'est pas défini. |
%4{Referer}i |
N'enregistre le contenu de l'en-tête Referer que si
la sévérité du message de journalisation est supérieure à 4. |
Certains items de format acceptent des paramètres supplémentaires entre accolades.
| Chaîne de format | Description |
|---|---|
%% |
Le signe pourcentage |
%a |
Adresse IP et port clients |
%{c}a |
Port et adresse IP sous-jacents du correspondant pour la
connexion (voir le module
mod_remoteip) |
%A |
Adresse IP et port locaux |
%{name}e |
Variable d'environnement de requête name |
%E |
Etat d'erreur APR/OS et chaîne |
%F |
Nom du fichier source et numéro de ligne de l'appel du journal |
%{name}i |
En-tête de requête name |
%k |
Nombre de requêtes persistantes pour cette connexion |
%l |
Sévérité du message |
%L |
Identifiant journal de la requête |
%{c}L |
Identifiant journal de la connexion |
%{C}L |
Identifiant journal de la connexion si utilisé dans la portée de la connexion, vide sinon |
%m |
Nom du module qui effectue la journalisation du message |
%M |
Le message effectif |
%{name}n |
Note de requête name |
%P |
Identifiant du processus courant |
%T |
Identifiant du thread courant |
%{g}T |
Identifiant unique de thread système du thread courant
(l'identifiant affiché par la commande top par
exemple ; seulement sous Linux pour l'instant) |
%t |
L'heure courante |
%{u}t |
L'heure courante avec les microsecondes |
%{cu}t |
L'heure courante au format ISO 8601 étendu (compact), avec les microsecondes |
%{cuz}t |
L'heure actuelle au format ISO 8601 étendu (compact), avec les microsecondes et la zone horaire au format standard ISO 8601:2000. Disponible depuis la version 2.4.58 seulement |
%{%-format}t |
L'heure actuelle formatée selon la fonction
strftime(3). Disponible depuis la version 2.4.58
seulement |
%v |
Le nom de serveur canonique ServerName du serveur courant. |
%V |
Le nom de serveur du serveur qui sert la requête en accord
avec la définition de la directive UseCanonicalName. |
\ (anti-slash espace) |
Espace non délimiteur |
% (pourcentage espace) |
Délimiteur de champ (aucune sortie) |
L'item de format identifiant journal %L génère un
identifiant unique pour une connexion ou une requête. Il peut servir
à déterminer quelles lignes correspondent à la même connexion ou
requête ou quelle requête est associée à tel connexion. Un item de
format %L est aussi disponible dans le module
mod_log_config, mais il permet dans ce contexte de
corréler les entrées du journal des accès avec celles du journal des
erreurs. Si le module mod_unique_id est chargé,
c'est son identifiant unique qui sera utilisé comme identifiant de
journal pour les requêtes.
# Exemple (format par défaut pour les MPMs threadés)
ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"
Cet exemple renverrait un message d'erreur du style :
[Thu May 12 08:28:57.652118 2011] [core:error] [pid 8777:tid 4326490112] [client ::1:58619] File does not exist: /usr/local/apache2/htdocs/favicon.ico
Notez que, comme indiqué plus haut, certains champs sont totalement supprimés s'ils n'ont pas été définis.
# Exemple (similaire au format 2.2.x)
ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"
# Exemple avancé avec identifiants journal de requête/connexion
ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"
ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"
ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"
ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"
ErrorLogFormat connection "[%{uc}t] [C:%{c}L] remote\ %a local\ %A"
| Description: | Extrait des informations d'état étendues pour chaque requête |
|---|---|
| Syntaxe: | ExtendedStatus On|Off |
| Défaut: | ExtendedStatus Off |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
Cette option permet d'extraire des données supplémentaires
concernant la requête en cours de traitement pour un processus
donné, et crée un résumé d'utilisation ; vous pouvez accéder à
ces variables pendant l'exécution en configurant
mod_status. Notez que d'autres modules sont
susceptibles de s'appuyer sur ce tableau de bord.
Cette directive s'applique au serveur dans son ensemble, et ne peut pas être activée/désactivée pour un serveur virtuel particulier. Notez que l'extraction des informations d'état étendues peut ralentir le serveur. Notez aussi que cette définition ne peut pas être modifiée au cours d'un redémarrage graceful.
Notez que le chargement de mod_status définit
automatiquement ExtendedStatus à On, et que d'autres modules tiers
sont susceptibles d'en faire de même. De tels modules ont besoin
d'informations détaillées à propos de l'état de tous les processus.
Depuis la version 2.3.6, mod_status a définit la
valeur par défaut à On, alors qu'elle était à Off dans les versions
antérieures.
| Description: | Caractéristiques de fichier utilisées lors de la génération de l'en-tête de réponse HTTP ETag pour les fichiers statiques |
|---|---|
| Syntaxe: | FileETag composant ... |
| Défaut: | FileETag MTime Size |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | La valeur par défaut était "INode MTime Size" dans les versions 2.3.14 et antérieures. |
La directive FileETag définit les
caractéristiques de fichier utilisées lors de la génération de
l'en-tête de réponse HTTP ETag (entity tag) quand le
document est contenu dans un fichier statique (la valeur de
ETag
est utilisée dans le cadre de la gestion du cache pour préserver la
bande passante réseau). La directive
FileETag vous permet maintenant de choisir
quelles caractéristiques du fichier vont être utilisées, le cas
échéant. Les mots-clés reconnus sont :
FileETag INode MTime Size
ETag sera
généré à partir du condensé du fichier.ETag ne sera inclus dans la réponseLes mots-clés INode, MTime,
Size et Digest peuvent être préfixés par + ou
-, ce qui permet de modifier les valeurs par défaut
héritées d'un niveau de configuration plus général. Tout mot-clé
apparaissant sans aucun préfixe annule entièrement et immédiatement
les configurations héritées.
Si la configuration d'un répertoire contient
FileETag INode MTime Size, et si un de
ses sous-répertoires contient FileETag -INode, la
configuration de ce sous-répertoire (qui sera propagée vers tout
sous-répertoire qui ne la supplante pas), sera équivalente à
FileETag MTime Size.
mod_include, car l'entité de la réponse peut
changer sans modification de l'INode, MTime, Size ou Digest du
fichier statique contenant les directives SSI.
| Description: | Contient des directives qui s'appliquent aux fichiers précisés |
|---|---|
| Syntaxe: | <Files nom fichier> ... </Files> |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
La directive <Files> limite
la portée des directives qu'elle contient aux fichiers précisés.
Elle est comparable aux directives <Directory> et <Location>. Elle doit se terminer par une
balise </Files>. Les directives contenues dans
cette section s'appliqueront à tout objet dont le nom de base (la
dernière partie du nom de fichier) correspond au fichier spécifié.
Les sections <Files> sont
traitées selon l'ordre dans lequel elles apparaissent dans le
fichier de configuration, après les sections <Directory> et la lecture des fichiers
.htaccess, mais avant les sections <Location>. Notez que les
sections <Files> peuvent être
imbriquées dans les sections <Directory> afin de restreindre la portion
du système de fichiers à laquelle ces dernières vont
s'appliquer.
L'argument filename peut contenir un nom de fichier
ou une chaîne de caractères avec caractères génériques, où
? remplace un caractère, et * toute chaîne
de caractères.
<Files "cat.html">
# Insérer ici des directives qui s'appliquent au fichier cat.html
</Files>
<Files "?at.*">
# Les directives insérées ici s'appliqueront aux fichiers
# cat.html, bat.html, hat.php, et ainsi de suite.
</Files>
On peut aussi utiliser les Expressions rationnelles en ajoutant la
caractère ~. Par exemple :
<Files ~ "\.(gif|jpe?g|png)$">
#...
</Files>
correspondrait à la plupart des formats graphiques de l'Internet.
Il est cependant préférable d'utiliser la directive <FilesMatch>.
Notez qu'à la différence des sections <Directory> et <Location>, les sections <Files> peuvent être utilisées dans les
fichiers .htaccess. Ceci permet aux utilisateurs de
contrôler l'accès à leurs propres ressources, fichier par
fichier.
| Description: | Contient des directives qui s'appliquent à des fichiers spécifiés sous la forme d'expressions rationnelles |
|---|---|
| Syntaxe: | <FilesMatch expression rationnelle> ...
</FilesMatch> |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
La section <FilesMatch>
limite la portée des directives qu'elle contient aux fichiers
spécifiés, tout comme le ferait une section <Files>. Mais elle accepte aussi les
expressions rationnelles. Par
exemple :
<FilesMatch ".+\.(gif|jpe?g|png)$">
# ...
</FilesMatch>
correspondrait à la plupart des formats graphiques de l'Internet.
.+ au début de l'expression
rationnelle permettent de s'assurer que les fichiers de nom
.png, ou .gif, par exemple, ne seront pas
pris en compte.A partir de la version 2.4.8, les groupes nommés et les
références arrières sont extraits et enregistrés dans
l'environnement avec leur nom en majuscules et préfixé
par "MATCH_". Ceci permet
de référencer des URLs dans des expressions
ou au sein de modules comme mod_rewrite. Pour
éviter toute confusion, les références arrières numérotées (non
nommées) sont ignorées. Vous devez utiliser à la place des groupes
nommés.
<FilesMatch "^(?<sitename>[^/]+)">
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</FilesMatch>
| Description: | Nombre maximal de réponses en attente (pipelined) au-delà duquel elles sont envoyées sur le réseau |
|---|---|
| Syntaxe: | FlushMaxPipelined number |
| Défaut: | FlushMaxPipelined 5 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.47 du serveur HTTP Apache |
Cette directive permet de définir le nombre maximal de réponses "pipelinées" qui restent en attente tant que des requêtes "pipelinées" sont reçues. Lorsque cette limite est dépassée, l'envoi des réponses sur le réseau est forcé en mode bloqué jusqu'à ce que leur nombre repasse en dessous de la limite.
La directive FlushMaxPipelined permet de limiter
la consommation de mémoire. Lorsqu'elle est définie à 0, le
pipelining est désactivé, et lorsqu'elle est définie à -1, il n'y
a plus de limite (mais la directive FlushMaxThreshold
s'applique quand-même).
| Description: | Seuil au-delà duquel les données en attente sont envoyées sur le réseau |
|---|---|
| Syntaxe: | FlushMaxThreshold number-of-bytes |
| Défaut: | FlushMaxThreshold 65535 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.47 du serveur HTTP Apache |
Cette directive permet de définir le seuil maximal de données en attente d'envoi (en octets). Lorsque cette limite est dépassée, l'envoi des données sur le réseau est forcé en mode bloqué jusqu'à ce que leur quantité repasse en dessous du seuil spécifié.
La directive FlushMaxThreshold permet de limiter
la consommation de mémoire. Lorsqu'elle est définie à 0 ou à une
valeur trop petite, aucune donnée n'est mise en attente, mais dans le cas
des MPMs threadés, il peut alors y avoir plus de threads occupés en attente du
réseau, ce qui diminue d'autant le nombre de threads disponibles pour
traiter les autres connexions simultanées.
| Description: | Force le type de médium spécifié dans le champ d'en-tête HTTP Content-Type pour les fichiers correspondants |
|---|---|
| Syntaxe: | ForceType type médium|None |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
Lorsqu'elle est placée dans un fichier .htaccess ou
une section <Directory>, <Location>, ou <Files>, cette directive force
l'identification du type MIME des fichiers spécifiés à la valeur de
l'argument type médium. Par exemple, si vous possédez un
répertoire ne contenant que des fichiers GIF, et si vous ne voulez
pas leur ajouter l'extension .gif, vous pouvez utiliser
:
ForceType image/gif
Notez que cette directive l'emporte sur d'autres associations de
type de médium indirectes définies dans mime.types ou via la
directive AddType.
Vous pouvez aussi annuler toute définition plus générale de
ForceType en affectant la valeur
None à l'argument type médium :
# force le type MIME de tous les fichiers à image/gif: <Location "/images"> ForceType image/gif </Location> # mais utilise les méthodes classiques d'attribution du type MIME # dans le sous-répertoire suivant : <Location "/images/mixed"> ForceType None </Location>
A la base, cette directive écrase le type de contenu généré pour les fichiers statiques servis à partir du sytème de fichiers. Pour les ressources autres que les fichiers statiques pour lesquels le générateur de réponse spécifie en général un type de contenu, cette directive est ignorée.
Lorsque des directives explicites comme SetHandler ou
module="mod_mime">AddHandler ne s'appliquent
pas à la requête courante, le nom du gestionnaire interne
normalement défini par ces directives correspondra alors au type de
contenu spécifié par cette directive. Il s'agit d'un
comportement historique que certains modules
tiers, comme mod_php, peuvent interpréter comme un type de contenu
artificiel ne servant qu'à indiquer le module qui doit prendre en
compte la requête considérée. Dans la mesure du
possible, il est conseillé d'éviter les
configurations qui comportent de tels types artificiels en utilisant
les directives SetHandler ou
AddHandler.
| Description: | Répertoire dans lequel écrire les données de profiling gmon.out. |
|---|---|
| Syntaxe: | GprofDir /tmp/gprof/|/tmp/gprof/% |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
Lorsque le serveur a été compilé avec le support du profiling
gprof, la directive GprofDir permet de
spécifier dans quel répertoire les fichiers gmon.out
doivent être écrits lorsque le processus s'arrête. Si l'argument se
termine par un caractère pourcentage ('%'), des sous-répertoires
sont créés pour chaque identifiant de processus.
Cette directive ne fonctionne actuellement qu'avec le MPM
prefork.
| Description: | Active la recherche DNS sur les adresses IP des clients |
|---|---|
| Syntaxe: | HostnameLookups On|Off|Double |
| Défaut: | HostnameLookups Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Noyau httpd |
| Module: | core |
Cette directive active la recherche DNS afin de pouvoir
journaliser les nom d'hôtes (et les passer aux programmes CGI et aux
inclusions SSI via la variable REMOTE_HOST). La valeur
Double déclenche une double recherche DNS inverse. En
d'autres termes, une fois la recherche inverse effectuée, on lance
une recherche directe sur le résultat de cette dernière. Au moins
une des adresses IP fournies par la recherche directe doit
correspondre à l'adresse originale (ce que l'on nomme
PARANOID dans la terminologie "tcpwrappers").
Quelle que soit la configuration, lorsqu'on utilise
mod_authz_host pour contrôler l'accès en fonction
du nom d'hôte, une double recherche DNS inverse est effectuée,
sécurité oblige. Notez cependant que le résultat de cette double
recherche n'est en général pas accessible, à moins que vous n'ayez
spécifié HostnameLookups Double. Par exemple, si vous
n'avez spécifié que HostnameLookups On, et si une
requête concerne un objet protégé par des restrictions en fonction
du nom d'hôte, quel que soit le résultat de la double recherche
inverse, les programmes CGI ne recevront que le résultat de la
recherche inverse simple dans la variable
REMOTE_HOST.
La valeur par défaut est Off afin de préserver le
traffic réseau des sites pour lesquels la recherche inverse n'est
pas vraiment nécessaire. Cette valeur par défaut est aussi bénéfique
pour les utilisateurs finaux car il n'ont ainsi pas à subir de temps
d'attente supplémentaires dus aux recherches DNS. Les sites
fortement chargés devraient laisser cette directive à
Off, car les recherches DNS peuvent prendre des temps
très longs. Vous pouvez éventuellement utiliser hors ligne
l'utilitaire logresolve, compilé par défaut dans
le sous-répertoire bin de votre répertoire
d'installation, afin de déterminer les noms d'hôtes associés aux
adresses IP journalisées.
Enfin, si vous avez des directives Require à base de
nom, une recherche de nom d'hôte sera effectuée quelle que soit
la définition de la directive HostnameLookups.
| Description: | Modifie les contraintes sur les messages des requêtes HTTP |
|---|---|
| Syntaxe: | HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods]
[Allow0.9|Require1.0] |
| Défaut: | HttpProtocolOptions Strict LenientMethods Allow0.9 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir des versions 2.2.32 et 2.4.24 du serveur HTTP Apache |
Cette directive permet de modifier les règles qui s'appliquent à la ligne
de requête HTTP (RFC 7230
§3.1.1) et aux champs des en-têtes des requêtes HTTP (RFC 7230
§3.2), qui s'appliquent maintenant par défaut ou en utilisant
l'option Strict. L'option Unsafe
a été ajoutée pour pouvoir restaurer les anciens
comportements nécessaires aux anciens modules et applications et aux agents
utilisateurs personnalisés considérés comme obsolètes.
Ces règles s'appliquant avant le traitement de la requête, elles doivent, pour être prises en compte, être définies au niveau global ou dans la première section par défaut du serveur virtuel qui correspond à la requête considérée, par interface IP/port et non par nom.
Cette directive accepte trois paramètres issus de la liste suivante, ceux qui ne sont pas spécifiés prenant leur valeur par défaut :
Avant l'introduction de cette directive, les interpréteurs de requêtes du
serveur HTTP Apache toléraient un grand nombre de formats en entrée qui
n'étaient pas forcément conformes au protocole. RFC 7230 §9.4
Request Splitting et §9.5 Response
Smuggling ne rappellent que deux des risques potentiels induits par des
requêtes non conformes, alors que RFC 7230
§3.5 signale les risques encourus par l'acceptation de blancs non
conformes dans les lignes de requête. Avec l'introduction de cette
directive, toutes les règles de grammaire de la spécification doivent être
respectées dans le mode d'opérations par défaut Strict.
Il est fortement déconseillé aux utilisateurs d'utiliser le mode
d'opération Unsafe, ou
UnsafeWhitespace, en particulier pour les déploiements de
serveurs ouverts sur l'extérieur et/ou accessibles au public. Si un moniteur
défectueux ou autre logiciel spécialisé ne s'exécutant que sur un intranet
nécessite une interface, les utilisateurs ne doivent utiliser les options de
type UnSafe qu'en cas de nécessité et uniquement au sein d'un serveur
virtuel bien spécifique et sur un réseau privé.
# Missing CRLF
GET / HTTP/1.0\n\n
Il peut s'avérer nécessaire de forcer certains utilitaires à utiliser CRLF ; si ce n'est pas le cas, httpd reverra une réponse HTTP 400 comme dans le cas précédent. Par exemple, le client OpenSSL s_client doit utiliser le paramètre -crlf pour fonctionner correctement.
Pour détecter des problèmes tels que l'absence de CRLF, vous pouvez
utiliser la directive DumpIOInput qui permet de décortiquer
les requêtes HTTP.
La section de la RFC 7231
§4.1 "Request Methods" "Overview" indique que les serveurs doivent
renvoyer un message d'erreur lorsque la ligne de requête comporte une
méthode non supportée. C'est déjà le cas lorsque l'option
LenientMethods est utilisée, mais les administrateurs ont la
possibilité de limiter les méthodes utilisées via l'option
RegisteredMethods en enregistrant toute méthode non standard
via la directive RegisterHttpMethod, en particulier
si l'option Unsafe est utilisée.
L'option
RegisteredMethods ne doit pas être utilisée
pour les serveurs mandataires car ces derniers ne connaissent pas les
méthodes supportées par les serveurs originaux.
# Méthode HTTP inconnue
WOW / HTTP/1.0\r\n\r\n
# Méthode HTTP spécifiée en minuscules
get / HTTP/1.0\r\n\r\n
La section de la RFC 2616
§19.6 "Compatibility With Previous Versions" encouragait les
serveurs HTTP à supporter les anciennes requêtes HTTP/0.9. La RFC 7230 va
cependant à son encontre via sa préconisation "Le souhait de supporter les
requêtes HTTP/0.9 a été supprimé" et y adjoint des commentaires dans RFC 7230 Appendix
A. A ce titre, l'option Require1.0 permet à l'utilisateur
d'inhiber le comportement induit par l'option par défaut
Allow0.9.
# Version HTTP non supportée
GET /\r\n\r\n
La consultation des messages enregistrés dans le journal
ErrorLog, configuré via la directive
LogLevel avec un niveau info, pourra
vous aider à identifier de telles requêtes non conformes ainsi que leur
provenance. Les utilisateurs devront accorder une attention particulière aux
messages d'erreur de type 400 dans le journal access pour détecter les
requêtes apparemment valides mais rejetées.
| Description: | Contient des directives qui ne s'appliquent que si une condition est satisfaite au cours du traitement d'une requête |
|---|---|
| Syntaxe: | <If expression> ... </If> |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Les conditions imbriquées sont supportées à partir de la version 2.4.26 du serveur HTTP Apache |
La directive <If> évalue une
expression à la volée, et applique les directives qu'elle contient
si et seulement si l'expression renvoie la valeur "vrai". Par
exemple :
<If "-z req('Host')">
serait satisfaite pour les requêtes HTTP/1.0 sans en-tête
Host:. Les expressions peuvent contenir différents
opérateurs de type shell pour la comparaison de chaînes
(==, !=, <, ...), la
comparaison d'entiers (-eq, -ne, ...), ou
à usages divers (-n, -z, -f,
...). Les expressions rationnelles sont aussi supportées,
<If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/">
ainsi que les comparaison de modèles de type shell et de
nombreuses autres opérations. Ces opérations peuvent être effectuées
sur les en-têtes de requêtes (req), les variables
d'environnement (env), et un grand nombre d'autres
propriétés. La documentation complète est disponible dans Les expressions dans le serveur HTTP Apache.
Cette section de configuration ne peut contenir que des directives qui supportent le contexte de répertoire.
CONTENT_TYPE and other
response headers, are set after <If> conditions have already
been evaluated, and so will not be available to use in this
directive.
Define, Include et
Error ne peuvent pas être traitées de manière
conditionnelle en les incluant dans une section de configuration <If>. Ces sections font en effet toujours partie de
la configuration, quelle soit la manière dont elles sont évaluées à
l'exécution.
<ElseIf><Else><If>, <ElseIf>, et <Else> s'appliquent en dernier.| Description: | Contient des directives qui ne s'appliqueront que si un test retourne "vrai" au démarrage du serveur |
|---|---|
| Syntaxe: | <IfDefine [!]paramètre> ...
</IfDefine> |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
La section <IfDefine
test>...</IfDefine> permet de
conférer un caractère conditionnel à un ensemble de directives. Les
directives situées à l'intérieur d'une section <IfDefine> ne s'appliquent que si
test est vrai. Si test est faux, tout ce qui
se trouve entre les balises de début et de fin est ignoré.
test peut se présenter sous deux formes :
!nom paramètreDans le premier cas, les directives situées entre les balises de début et de fin ne s'appliqueront que si le paramètre nommé nom paramètre est défini. Le second format inverse le test, et dans ce cas, les directives ne s'appliqueront que si nom paramètre n'est pas défini.
L'argument nom paramètre est une définition qui peut
être effectuée par la ligne de commande
httpd via le paramètre
-Dparamètre au démarrage du serveur, ou via la
directive Define.
Les sections <IfDefine>
peuvent être imbriquées, ce qui permet d'implémenter un test
multi-paramètres simple. Exemple :
httpd -DReverseProxy -DUseCache -DMemCache ...
<IfDefine ReverseProxy>
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
<IfDefine UseCache>
LoadModule cache_module modules/mod_cache.so
<IfDefine MemCache>
LoadModule mem_cache_module modules/mod_mem_cache.so
</IfDefine>
<IfDefine !MemCache>
LoadModule cache_disk_module modules/mod_cache_disk.so
</IfDefine>
</IfDefine>
</IfDefine>
| Description: | Regroupe des directives dont le traitement est conditionné par la présence ou l'absence d'une directive particulière |
|---|---|
| Syntaxe: | <IfDirective [!]directive-name> ...
</IfDirective> |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.34 du serveur HTTP Apache |
La section <IfDirective
test>...</IfDirective> permet de regrouper des
directives dont le traitement n'est effectué que si une directive
particulière est présente, autrement dit si l'expression test est
évaluée à true. Si l'expression test est évaluée à false, toutes
les lignes qui se trouvent entre les balises de début et de fin de la
section sont ignorées.
L'expression test de la section <IfDirective> peut prendre les deux formes
suivantes :
Dans le premier cas, les directives qui se situent entre les balises de début et de fin de la section ne sont traitées que si une directive de nom directive-name est disponible à cet instant. Dans le second cas, la condition est inversée, et les directives ne sont traitées que si directive-name n'est pas disponible.
httpd, sans tenir compte de la disponibilité de telle ou
telle directive. Dans une configuration standard, il est inutile de placer
les directives dans des sections <IfDirective>.| Description: | Regroupe des directives qui ne seront traitées que si un fichier existe au démarrage |
|---|---|
| Syntaxe: | <IfFile [!]filename> ...
</IfFile> |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.34 du serveur HTTP Apache |
La section <IfFile filename>...</IfFile>
permet de conditionner le traitement de directives à
l'existence d'un fichier sur disque. Ainsi, les directives définies au sein
d'une section <IfFile> ne seront
traitées que si le fichier filename existe. Si le fichier
filename n'existe pas, tout ce qui se trouve entre les marqueurs
start et end sera ignoré. filename peut être un chemin absolu ou
relatif au chemin défini par la directive ServerRoot.
Le paramètre filename de l'en-tête d'une section <IfFile> peut prendre la même forme que la variable
test de la section <IfDefine> ; à ce titre, le résultat du test peut
être inversé en plaçant le caractère ! juste avant
filename.
Si filename est un chemin relatif, il sera généré par rapport
au chemin défini par la directive ServerRoot. Lorsque la directive <IfFile> intervient avant la définition de la
directive ServerRoot,
filename sera relatif au répertoire racine par défaut du serveur
ou au répertoire racine passé dans la ligne de commande via l'option
-d.
| Description: | Contient des directives qui ne s'appliquent qu'en fonction de la présence ou de l'absence d'un module spécifique |
|---|---|
| Syntaxe: | <IfModule [!]fichier module|identificateur
module> ... </IfModule> |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Les identificateurs de modules sont disponibles dans les versions 2.1 et supérieures. |
La section <IfModule
test>...</IfModule> permet de conférer à
des directives un caractère conditionnel basé sur la présence d'un
module spécifique. Les directives situées dans une section
<IfModule> ne s'appliquent que
si test est vrai. Si test est faux, tout ce
qui se trouve entre les balises de début et de fin est ignoré.
test peut se présenter sous deux formes :
Dans le premier cas, les directives situées entre les balises de
début et de fin ne s'appliquent que si le module module
est présent -- soit compilé avec le binaire Apache httpd, soit chargé
dynamiquement via la directive LoadModule. Le second format inverse le test, et dans
ce cas, les directives ne s'appliquent que si module
n'est pas présent.
L'argument module peut contenir soit l'identificateur
du module, soit le nom du fichier source du module. Par exemple,
rewrite_module est un identificateur et
mod_rewrite.c le nom du fichier source
correspondant. Si un module comporte plusieurs fichiers sources,
utilisez le nom du fichier qui contient la chaîne de caractères
STANDARD20_MODULE_STUFF.
Les sections <IfModule>
peuvent être imbriquées, ce qui permet d'implémenter des tests
multi-modules simples.
<IfModule>.| Description: | Regroupe des directives dont le traitement est conditionné par la présence ou l'absence d'une section particulière |
|---|---|
| Syntaxe: | <IfSection [!]section-name> ...
</IfSection> |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.34 du serveur HTTP Apache |
La section <IfSection
test>...</IfSection> permet de regrouper des
directives dont le traitement n'est effectué que si une section de
configuration particulière est présente. Une section, par exemple <VirtualHost>, permet de regrouper des directives
et possède un nom précédé du caractère "<".
Les directives situées à l'intérieur d'une section <IfSection> ne sont traitées que si l'expression
test est évaluée à true. Si l'expression test est
évaluée à false, toutes les lignes situées entre les balises de début et de
fin de la section sont ignorées.
section-name doit être spécifié sans les caractères de début
"<" ou fin ">". L'expression test de la section <IfSection> peut prendre deux formes :
Dans le premier cas, les directives qui se situent entre les balises de début et de fin de la section ne sont traitées que si une section de nom section-name est disponible à cet instant. Dans le second cas, la condition est inversée, et les directives ne sont traitées que si section-name n'est pas disponible.
Par exemple :
<IfSection VirtualHost> ... </IfSection>
httpd, sans tenir compte de la disponibilité de telle ou
telle section. Dans une configuration standard, il est inutile de placer
les directives dans des sections <IfSection>.| Description: | Inclut d'autres fichiers de configuration dans un des fichiers de configuration du serveur |
|---|---|
| Syntaxe: | Include chemin-fichier|chemin-répertoire|wildcard |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Utilisation des caractères génériques dans la partie chemin depuis la version 2.3.6 |
Cette directive permet l'inclusion d'autres fichiers de configuration dans un des fichiers de configuration du serveur.
On peut utiliser des caractères génériques de style Shell
(fnmatch()) aussi bien dans la partie nom de fichier du
chemin que dans la partie répertoires pour inclure plusieurs
fichiers en une
seule fois, selon leur ordre alphabétique. De plus, si la directive
Include pointe vers un répertoire, Apache
httpd inclura tous les fichiers de ce répertoire et de tous ces
sous-répertoires. L'inclusion de répertoires entiers est cependant
déconseillée, car il est fréquent d'oublier des fichiers
temporaires dans un répertoire, ce qui causerait une erreur
httpd en cas d'inclusion. Pour inclure des
fichiers qui correspondent à un certain modèle, comme *.conf par
exemple, nous vous recommandons d'utiliser plutôt la syntaxe avec
caractères génériques comme ci-dessous.
La directive Include
échouera avec un code d'erreur si une expression
contenant des caractères génériques ne correspond à aucun fichier.
Pour ignorer les expressions contenant des caractères génériques ne
correspondant à aucun fichier, utilisez la directive IncludeOptional.
Le chemin fichier spécifié peut être soit un chemin absolu, soit
un chemin relatif au répertoire défini par la directive ServerRoot.
Exemples :
Include /usr/local/apache2/conf/ssl.conf Include /usr/local/apache2/conf/vhosts/*.conf
ou encore, avec des chemins relatifs au répertoire défini par la
directive ServerRoot :
Include conf/ssl.conf Include conf/vhosts/*.conf
On peut aussi insérer des caractères génériques dans la partie répertoires du chemin. Dans l'exemple suivant, la directive échouera si aucun sous-répertoire de conf/vhosts ne contient au moins un fichier *.conf :
Include conf/vhosts/*/*.conf
Par contre, dans l'exemple suivant, la directive sera simplement ignorée si aucun sous-répertoire de conf/vhosts ne contient au moins un fichier *.conf :
IncludeOptional conf/vhosts/*/*.conf
| Description: | Inclusion de fichiers dans le fichier de configuration |
|---|---|
| Syntaxe: | IncludeOptional
file-path|directory-path|wildcard |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.3.6 du serveur HTTP Apache. Après la version 2.4.30, les chemins de fichiers non existants et ne comportant pas de caractères génériques ne génèrent plus d'erreurs de syntaxe |
Cette directive permet d'inclure des fichiers dans les fichiers
de configuration du serveur. Elle fonctionne de manière identique à
la directive Include, mais au lieu de
générer une erreur, elle sera ignorée silensieusement si malgré
l'utilisation de caractères génériques, le chemin de fichier ou de
répertoire spécifié n'existe pas dans le système de fichiers.
| Description: | Active les connexions HTTP persistantes |
|---|---|
| Syntaxe: | KeepAlive On|Off |
| Défaut: | KeepAlive On |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
L'extension Keep-Alive de HTTP/1.0 et l'implémentation des
connexions persistantes dans HTTP/1.1 ont rendu possibles des
sessions HTTP de longue durée, ce qui permet de transmettre
plusieurs requêtes via la même connexion TCP. Dans certains cas, le
gain en rapidité pour des documents comportant de nombreuses images
peut atteindre 50%. Pour activer les connexions persistantes,
définissez KeepAlive On.
Pour les clients HTTP/1.0, les connexions persistantes ne seront mises en oeuvre que si elles ont été spécialement demandées par un client. De plus, une connexion persistante avec un client HTTP/1.0 ne peut être utilisée que si la taille du contenu est connue d'avance. Ceci implique que les contenus dynamiques comme les sorties CGI, les pages SSI, et les listings de répertoires générés par le serveur n'utiliseront en général pas les connexions persistantes avec les clients HTTP/1.0. Avec les clients HTTP/1.1, les connexions persistantes sont utilisées par défaut, sauf instructions contraires. Si le client le demande, le transfert par tronçons de taille fixe (chunked encoding) sera utilisé afin de transmettre un contenu de longueur inconnue via une connexion persistante.
Lorsqu'un client utilise une connexion persistante, elle comptera
pour une seule requête pour la directive MaxConnectionsPerChild, quel
que soit le nombre de requêtes transmises via cette connexion.
| Description: | Durée pendant laquelle le serveur va attendre une requête avant de fermer une connexion persistante |
|---|---|
| Syntaxe: | KeepAliveTimeout nombre[ms] |
| Défaut: | KeepAliveTimeout 5 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
Le nombre de secondes pendant lesquelles Apache httpd va attendre une
requête avant de fermer la connexion. Le délai peut être défini en
millisecondes en suffixant sa valeur par ms. La valeur du délai
spécifiée par la directive Timeout s'applique dès qu'une requête a
été reçue.
Donner une valeur trop élévée à
KeepAliveTimeout peut induire des problèmes
de performances sur les serveurs fortement chargés. Plus le délai
est élévé, plus nombreux seront les processus serveur en attente de
requêtes de la part de clients inactifs.
Si la directive KeepAliveTimeout n'est
pas définie pour un serveur virtuel à base de nom, c'est
la valeur de la paire adresse IP/port du serveur virtuel qui
correspond le mieux qui sera utilisée.
| Description: | Limite les contrôles d'accès que la section contient à certaines méthodes HTTP |
|---|---|
| Syntaxe: | <Limit méthode [méthode] ... > ...
</Limit> |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig, Limit |
| Statut: | Noyau httpd |
| Module: | core |
Les contrôles d'accès s'appliquent normalement à
toutes les méthodes d'accès, et c'est en général le
comportement souhaité. Dans le cas général, les directives
de contrôle d'accès n'ont pas à être placées dans une section
<Limit>.
La directive <Limit> a pour
but de limiter les effets des contrôles d'accès aux méthodes HTTP
spécifiées. Pour toutes les autres méthodes, les restrictions
d'accès contenues dans la section <Limit> n'auront aucun
effet. L'exemple suivant n'applique les contrôles d'accès
qu'aux méthodes POST, PUT, et
DELETE, en laissant les autres méthodes sans protection
:
<Limit POST PUT DELETE> Require valid-user </Limit>
La liste des noms de méthodes peut contenir une ou plusieurs
valeurs parmi les suivantes : GET, POST,
PUT, DELETE, CONNECT,
OPTIONS, PATCH, PROPFIND,
PROPPATCH, MKCOL, COPY,
MOVE, LOCK, et UNLOCK.
Le nom de méthode est sensible à la casse. Si la
valeur GET est présente, les requêtes HEAD
seront aussi concernées. La méthode TRACE ne peut pas
être limitée (voir la directive TraceEnable).
<LimitExcept> doit toujours être préférée à
une section <Limit> pour la
restriction d'accès, car une section <LimitExcept> fournit une protection contre
les méthodes arbitraires.Les directives <Limit> et
<LimitExcept>
peuvent être imbriquées. Dans ce cas, pour chaque niveau des
directives <Limit> ou <LimitExcept>, ces dernières
doivent restreindre l'accès pour les méthodes auxquelles les
contrôles d'accès s'appliquent.
<Limit> ou <LimitExcept> avec la directive Require, la première directive
Require dont la
condition est satisfaite autorise la requête, sans tenir compte de
la présence d'autres directives Require.Par exemple, avec la configuration suivante, tous les
utilisateurs seront autorisés à effectuer des requêtes
POST, et la directive Require group
editors sera ignorée dans tous les cas :
<LimitExcept GET> Require valid-user </LimitExcept> <Limit POST> Require group editors </Limit>
| Description: | Applique les contrôles d'accès à toutes les méthodes HTTP, sauf celles qui sont spécifiées |
|---|---|
| Syntaxe: | <LimitExcept méthode [méthode] ... > ...
</LimitExcept> |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig, Limit |
| Statut: | Noyau httpd |
| Module: | core |
<LimitExcept> et
</LimitExcept> permettent de regrouper des
directives de contrôle d'accès qui s'appliqueront à toutes les
méthodes d'accès HTTP qui ne font pas partie de la
liste des arguments ; en d'autres termes, elles ont un comportement
opposé à celui de la section <Limit>, et on peut les utiliser pour
contrôler aussi bien les méthodes standards que les méthodes non
standards ou non reconnues. Voir la documentation de la section
<Limit> pour plus
de détails.
Par exemple :
<LimitExcept POST GET> Require valid-user </LimitExcept>
| Description: | Détermine le nombre maximal de redirections internes et de sous-requêtes imbriquées |
|---|---|
| Syntaxe: | LimitInternalRecursion nombre [nombre] |
| Défaut: | LimitInternalRecursion 10 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
Une redirection interne survient, par exemple, quand on utilise
la directive Action qui
redirige en interne la requête d'origine vers un script CGI. Une
sous-requête est le mécanisme qu'utilise Apache httpd pour déterminer ce
qui se passerait pour un URI s'il faisait l'objet d'une requête. Par
exemple, mod_dir utilise les sous-requêtes pour
rechercher les fichiers listés dans la directive DirectoryIndex.
La directive LimitInternalRecursion permet
d'éviter un crash du serveur dû à un bouclage infini de redirections
internes ou de sous-requêtes. De tels bouclages sont dus en général
à des erreurs de configuration.
La directive accepte, comme arguments, deux limites qui sont évaluées à chaque requête. Le premier nombre est le nombre maximum de redirections internes qui peuvent se succéder. Le second nombre détermine la profondeur d'imbrication maximum des sous-requêtes. Si vous ne spécifiez qu'un seul nombre, il sera affecté aux deux limites.
LimitInternalRecursion 5
| Description: | limite la taille maximale du corps de la requête HTTP envoyée par le client |
|---|---|
| Syntaxe: | LimitRequestBody octets |
| Défaut: | LimitRequestBody 1073741824 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Dans les versions 2.4.53 et antérieures du serveur HTTP Apache, la valeur par défaut était 0 (aucune limite) |
Cette directive permet de spécifier la taille maximale d'un corps de requête, en octets. Une valeur de 0 signifie « sans limites ».
La directive LimitRequestBody permet de
définir une limite pour la taille maximale autorisée du corps d'une
requête HTTP en tenant compte du contexte dans lequel la directive
a été placée (c'est à dire au niveau du serveur, d'un répertoire,
d'un fichier ou d'une localisation). Si la requête du client dépasse
cette limite, le serveur répondra par un message d'erreur et ne
traitera pas la requête. La taille du corps d'une requête normale va
varier de manière importante en fonction de la nature de la
ressource et des méthodes autorisées pour cette dernière. Les
scripts CGI utilisent souvent le corps du message pour extraire les
informations d'un formulaire. Les implémentations de la méthode
PUT nécessitent une valeur au moins aussi élevée que la
taille maximale des représentations que le serveur désire accepter
pour cette ressource.
L'administrateur du serveur peut utiliser cette directive pour contrôler plus efficacement les comportements anormaux des requêtes des clients, ce qui lui permettra de prévenir certaines formes d'attaques par déni de service.
Si par exemple, vous autorisez le chargement de fichiers vers une localisation particulière, et souhaitez limiter la taille des fichiers chargés à 100Ko, vous pouvez utiliser la directive suivante :
LimitRequestBody 102400
| Description: | Limite le nombre de champs d'en-tête autorisés dans une requête HTTP |
|---|---|
| Syntaxe: | LimitRequestFields nombre |
| Défaut: | LimitRequestFields 100 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
nombre est un entier de 0 à 32767. La valeur 0 signifie un
nombre de champs illimité. La valeur par défaut est définie à la compilation
par la constante DEFAULT_LIMIT_REQUEST_FIELDS (100 selon la
distribution).
La directive LimitRequestFields permet à
l'administrateur du serveur de modifier le nombre maximum de champs
d'en-tête autorisés dans une requête HTTP. Pour un serveur, cette
valeur doit être supérieure au nombre de champs qu'une requête
client normale peut contenir. Le nombre de champs d'en-tête d'une
requête qu'un client utilise dépasse rarement 20, mais ce nombre
peut varier selon les implémentations des clients, et souvent en
fonction des extensions que les utilisateurs configurent dans leurs
navigateurs pour supporter la négociation de contenu détaillée. Les
extensions HTTP optionnelles utilisent souvent les
champs d'en-tête des requêtes.
L'administrateur du serveur peut utiliser cette directive pour contrôler plus efficacement les comportements anormaux des requêtes des clients, ce qui lui permettra de prévenir certaines formes d'attaques par déni de service. La valeur spécifiée doit être augmentée si les clients standards reçoivent une erreur du serveur indiquant que la requête comportait un nombre d'en-têtes trop important.
Par exemple :
LimitRequestFields 50
Dans le cas des serveurs virtuels à base de noms, la valeur de cette directive est extraite du serveur virtuel par défaut (le premier de la liste) pour la paire adresse IP/port.
| Description: | Dédinit la taille maximale autorisée d'un en-tête de requête HTTP |
|---|---|
| Syntaxe: | LimitRequestFieldSize octets |
| Défaut: | LimitRequestFieldSize 8190 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
Cette directive permet de définir le nombre maximum d'octets autorisés dans un en-tête de requête HTTP.
La directive LimitRequestFieldSize permet
à l'administrateur du serveur de définir la taille
maximale autorisée d'un en-tête de requête HTTP. Pour un serveur,
cette valeur doit être suffisamment grande pour contenir tout
en-tête d'une requête client normale. La taille d'un champ d'en-tête
de requête normal va varier selon les implémentations des clients,
et en fonction des extensions que les utilisateurs
configurent dans leurs navigateurs pour supporter la négociation de
contenu détaillée. Les en-têtes d'authentification SPNEGO peuvent
atteindre une taille de 12392 octets.
L'administrateur du serveur peut utiliser cette directive pour contrôler plus efficacement les comportements anormaux des requêtes des clients, ce qui lui permettra de prévenir certaines formes d'attaques par déni de service.
Par exemple :
LimitRequestFieldSize 4094
Dans le cas des serveurs virtuels à base de noms, la valeur de cette directive est extraite du serveur virtuel par défaut (le premier de la liste) pour lequel la paire adresse IP/port correspond le mieux.
| Description: | Définit la taille maximale d'une ligne de requête HTTP |
|---|---|
| Syntaxe: | LimitRequestLine octets |
| Défaut: | LimitRequestLine 8190 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
Cette directive permet de définir la taille maximale autorisée pour une ligne de requête HTTP en octets.
La directive LimitRequestLine permet à
l'administrateur du serveur de définir la taille
maximale autorisée d'une ligne de requête HTTP client. Comme une
requête comporte une méthode HTTP, un URI, et une version de
protocole, la directive LimitRequestLine
impose une restriction sur la longueur maximale autorisée pour un
URI dans une requête au niveau du serveur. Pour un serveur, cette
valeur doit être suffisamment grande pour référencer les noms de
toutes ses ressources, y compris toutes informations pouvant être
ajoutées dans la partie requête d'une méthode GET.
L'administrateur du serveur peut utiliser cette directive pour contrôler plus efficacement les comportements anormaux des requêtes des clients, ce qui lui permettra de prévenir certaines formes d'attaques par déni de service.
Par exemple :
LimitRequestLine 4094
Dans le cas des serveurs virtuels à base de noms, la valeur de cette directive est extraite du serveur virtuel par défaut (le premier de la liste) pour lequel la paire adresse IP/port correspond le mieux.
| Description: | Définit la taille maximale du corps d'une requête au format XML |
|---|---|
| Syntaxe: | LimitXMLRequestBody octets |
| Défaut: | LimitXMLRequestBody 1000000 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
Taille maximale (en octets) du corps d'une requête au format XML. Une
valeur de 0 appliquera une limite physique (différente selon
que le système est sur 32 ou 64 bits) permettant à XML de s'étaler jusqu'aux
limites de la mémoire adressable du système, mais elle n'existe qu'à des
fins de compatibilité et il est déconseillé de l'utiliser car elle ne tient
pas compte de la mémoire consommée ailleurs et des requêtes simultanées, ce
qui pourrait provoquer un dépassement de mémoire global du système.
Exemple :
# Limitation à 1 Mo LimitXMLRequestBody 1048576
| Description: | N'applique les directives contenues qu'aux URLs spécifiées |
|---|---|
| Syntaxe: | <Location
chemin URL|URL> ... </Location> |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
La directive <Location>
limite la portée des directives contenues aux URLs définies par
l'argument URL. Elle est similaire à la directive <Directory>, et marque le
début d'une section qui se termine par une directive
</Location>. Les sections <Location> sont traitées selon l'ordre dans
lequel elles apparaissent dans le fichier de configuration, mais
après les sections <Directory> et la lecture des
fichiers .htaccess, et après les sections <Files>.
Les sections <Location>
agissent complètement en dehors du système de fichiers. Ceci a de
nombreuses conséquences. Parmi les plus importantes, on ne doit pas
utiliser les sections <Location>
pour contrôler l'accès aux répertoires du système de fichiers. Comme
plusieurs URLs peuvent correspondre au même répertoire du système de
fichiers, un tel contrôle d'accès pourrait être contourné.
Les directives que contient cette section seront appliquées aux requêtes si la partie chemin de l'URL satisfait à l'un au moins de ces critères :
Dans l'exemple ci-dessous, où aucun slash de fin n'est utilisé, les directives contenues dans la section s'appliqueront à /private1, /private1/ et /private1/file.txt, mais pas à /private1other.
<Location "/private1">
# ...
</Location>
De même, dans l'exemple ci-dessous, où l'on utilise un slash de fin, les directives contenues dans la section s'appliqueront à /private2/ et à /private2/file.txt, mais pas à /private2other.
<Location "/private2/">
# ...
</Location>
<Location>Vous pouvez utiliser une section <Location> pour appliquer des directives à
des contenus situés en dehors du système de fichiers. Pour les
contenus situés à l'intérieur du système de fichiers, utilisez
plutôt les sections <Directory> et <Files>. <Location
"/"> constitue une exception et permet d'appliquer aisément
une configuration à l'ensemble du serveur.
Pour toutes les requêtes originales (non mandatées), l'argument
URL est un chemin d'URL de la forme
/chemin/. Aucun protocole, nom d'hôte, port, ou chaîne
de requête ne doivent apparaître. Pour les requêtes mandatées, l'URL
spécifiée doit être de la forme
protocole://nom_serveur/chemin, et vous devez inclure
le préfixe.
L'URL peut contenir des caractères génériques. Dans une chaîne
avec caractères génériques, ? correspond à un caractère
quelconque, et * à toute chaîne de caractères. Les
caractères génériques ne peuvent pas remplacer un / dans le chemin
URL.
On peut aussi utiliser les Expressions
rationnelles, moyennant l'addition d'un caractère
~. Par exemple :
<Location ~ "/(extra|special)/data">
#...
</Location>
concernerait les URLs contenant les sous-chaîne
/extra/data ou /special/data. La directive
<LocationMatch>
présente un comportement identique à la version avec expressions
rationnelles de la directive <Location>, et son utilisation est
préférable à l'utilisation de cette dernière pour la simple raison
qu'il est difficile de distinguer ~ de -
dans la plupart des fontes.
La fonctionnalité <Location>
est particulièrement utile avec la directive SetHandler. Par exemple, pour activer les
requêtes d'état, mais ne les autoriser que depuis des navigateurs
appartenant au domaine example.com, vous pouvez
utiliser :
<Location "/status"> SetHandler server-status Require host example.com </Location>
La signification du
caractère slash dépend de l'endroit où il se trouve dans l'URL. Les
utilisateurs peuvent être habitués à son comportement dans le système de
fichiers où plusieurs slashes successifs sont souvent réduits à un slash
unique (en d'autres termes, /home///foo est identique à
/home/foo). Dans l'espace de nommage des URLs, ce n'est
cependant pas toujours vrai si la directive MergeSlashes a été définie à "OFF". Pour la
directive <LocationMatch>
et la version avec expressions rationnelles de la directive <Location>, vous devez spécifier explicitement les
slashes multiples si les slashes ne sont pas fusionnés.
Par exemple, <LocationMatch "^/abc"> va
correspondre à l'URL /abc mais pas à l'URL
//abc. La directive <Location> sans expression rationnelle se comporte de
la même manière lorsqu'elle est utilisée pour des requêtes
mandatées. Par contre, lorsque la directive <Location> sans expression rationnelle
est utilisée pour des requêtes non mandatées, elle fera
correspondre implicitement les slashes multiples à des slashes
uniques. Par exemple, si vous spécifiez <Location
"/abc/def">, une requête de la forme
/abc//def correspondra.
| Description: | N'applique les directives contenues qu'aux URLs correspondant à une expression rationnelle |
|---|---|
| Syntaxe: | <LocationMatch
regex> ... </LocationMatch> |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
La directive <LocationMatch>
limite la portée des directives contenues à l'URL spécifiée, de
manière identique à la directive <Location>. Mais son argument permettant de
spécifier les URLs concernées est une expression rationnelle au lieu d'une simple
chaîne de caractères. Par exemple :
<LocationMatch "/(extra|special)/data">
# ...
</LocationMatch>
correspondrait à toute URL contenant les sous-chaînes
/extra/data ou /special/data.
Si vous recherchez une URL commençant par
plutôt que seulement contenant /extra/data, préfixez
l'expression rationnelle avec un ^.
<LocationMatch "^/(extra|special)/data">
A partir de la version 2.4.8, les groupes nommés et les
références arrières sont extraits et enregistrés dans
l'environnement avec leur nom en majuscules et préfixé
par "MATCH_". Ceci permet
de référencer des URLs dans des expressions
ou au sein de modules comme mod_rewrite. Pour
éviter toute confusion, les références arrières numérotées (non
nommées) sont ignorées. Vous devez utiliser à la place des groupes
nommés.
<LocationMatch "^/combined/(?<sitename>[^/]+)">
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</LocationMatch>
La signification du
caractère slash '/' dépend de l'endroit où il apparaît dans une URL. Les
utilisateurs sont habitués à voir de multiples slashes adjacents réduits à
un seul au sein du système de fichiers (par exemple,
/home///foo est équivalent à /home/foo). Ce n'est
n'est cependant pas toujours vrai au sein des URLs si la directive
MergeSlashes a été définie à "OFF". En
effet, si vous souhaitez spécifier plusieurs slashes, vous devez le faire
explicitement au sein de la directive <LocationMatch> et de la version regex de la
directive <Location>, si les slashes ne
sont pas fusionnés.
Par exemple, <LocationMatch "^/abc"> correspondra à
l'URL /abc, mais pas à l'URL //abc. La directive
(non-regex) <Location> se comporte de
la même manière lorsqu'elle est utilisée dans les requêtes de mandataire.
Par contre, pour les autres types de requêtes, la directive <Location> considérera plusieurs slashes
adjacents comme équivalents à un seul slash. Par exemple, si vous
spécifiez <Location "/abc/def">, une requête pour
/abc//def correspondra.
| Description: | Contrôle la verbosité du journal des erreurs |
|---|---|
| Syntaxe: | LogLevel [module:]niveau
[module:niveau] ...
|
| Défaut: | LogLevel warn |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | La configuration du niveau de journalisation par module et par répertoire est disponible depuis la version 2.3.6 du serveur HTTP Apache |
La directive LogLevel permet d'ajuster la
verbosité des messages enregistrés dans les journaux d'erreur (voir
la directive ErrorLog
directive). Les niveaux disponibles sont présentés
ci-après, par ordre de criticité décroissante :
| Niveau | Description | Exemple |
|---|---|---|
emerg |
Urgences - le système est inutilisable. | "Child cannot open lock file. Exiting" |
alert |
Des mesures doivent être prises immédiatement. | "getpwuid: couldn't determine user name from uid" |
crit |
Conditions critiques. | "socket: Failed to get a socket, exiting child" |
error |
Erreurs. | "Premature end of script headers" |
warn |
Avertissements. | "child process 1234 did not exit, sending another SIGHUP" |
notice |
Evènement important mais normal. | "httpd: caught SIGBUS, attempting to dump core in ..." |
info |
Informations. | "Server seems busy, (you may need to increase StartServers, or Min/MaxSpareServers)..." |
debug |
Messages de débogage. | "Opening config file ..." |
trace1 |
Messages de traces | "proxy: FTP: control connection complete" |
trace2 |
Messages de traces | "proxy: CONNECT: sending the CONNECT request to the remote proxy" |
trace3 |
Messages de traces | "openssl: Handshake: start" |
trace4 |
Messages de traces | "read from buffered SSL brigade, mode 0, 17 bytes" |
trace5 |
Messages de traces | "map lookup FAILED: map=rewritemap key=keyname" |
trace6 |
Messages de traces | "cache lookup FAILED, forcing new map lookup" |
trace7 |
Messages de traces, enregistrement d'une grande quantité de données | "| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |" |
trace8 |
Messages de traces, enregistrement d'une grande quantité de données | "| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |" |
Lorsqu'un niveau particulier est spécifié, les messages de tous
les autres niveaux de criticité supérieure seront aussi enregistrés.
Par exemple, si LogLevel info est spécifié,
les messages de niveaux notice et warn
seront aussi émis.
Il est recommandé d'utiliser un niveau crit ou
inférieur.
Par exemple :
LogLevel notice
Si la journalisation s'effectue directement dans un fichier,
les messages de niveau notice ne peuvent pas être
supprimés et sont donc toujours journalisés. Cependant, ceci ne
s'applique pas lorsque la journalisation s'effectue vers
syslog.
Spécifier un niveau sans nom de module va attribuer ce niveau à
tous les modules. Spécifier un niveau avec nom de module va
attribuer ce niveau à ce module seulement. Il est possible de
spécifier un module par le nom de son fichier source ou par son
identificateur, avec ou sans le suffixe _module. Les
trois spécifications suivantes sont donc équivalentes :
LogLevel info ssl:warn LogLevel info mod_ssl.c:warn LogLevel info ssl_module:warn
Il est aussi possible d'attribuer un niveau de journalisation par répertoire :
LogLevel info <Directory "/usr/local/apache/htdocs/app"> LogLevel debug </Directory>
| Description: | Nombre de requêtes permises pour une connexion persistante |
|---|---|
| Syntaxe: | MaxKeepAliveRequests nombre |
| Défaut: | MaxKeepAliveRequests 100 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
La directive MaxKeepAliveRequests permet
de limiter le nombre de requêtes autorisées par connexion lorsque
KeepAlive est à "on". Si sa
valeur est 0, le nombre de requêtes autorisées est
illimité. Il est recommandé de définir une valeur assez haute pour
des performances du serveur maximales.
Par exemple :
MaxKeepAliveRequests 500
| Description: | Nombre de chevauchements de segments de données autorisé
(par exemple 100-200,150-300) avant le renvoi de la
ressource complète |
|---|---|
| Syntaxe: | MaxRangeOverlaps default | unlimited | none | nombre de
chevauchements |
| Défaut: | MaxRangeOverlaps 20 |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible depuis la version 2.3.15 du serveur HTTP Apache |
La directive MaxRangeOverlaps permet
de limiter le nombre de chevauchements de segments de données HTTP
autorisé par le serveur. Si le nombre de
chevauchements de segments demandé est supérieur au nombre maximal
autorisé, la ressource sera renvoyée dans son intégralité.
| Description: | Nombre d'inversions d'ordre autorisé dans la spécification des
segments de données (par exemple 100-200,50-70) avant le renvoi de la
ressource complète |
|---|---|
| Syntaxe: | MaxRangeReversals default | unlimited | none | nombre
d'inversions |
| Défaut: | MaxRangeReversals 20 |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible depuis la version 2.3.15 du serveur HTTP Apache |
La directive MaxRangeReversals permet
de limiter le nombre d'inversions d'ordre dans la spécification
des segments de données HTTP
autorisé par le serveur. Si le nombre
d'inversions demandé est supérieur au nombre maximal
autorisé, la ressource sera renvoyée dans son intégralité.
| Description: | Nombre de segments de données autorisé avant le renvoi de l'intégralité de la ressource |
|---|---|
| Syntaxe: | MaxRanges default | unlimited | none | nombre de segments |
| Défaut: | MaxRanges 200 |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible depuis la version 2.3.15 du serveur HTTP Apache |
La directive MaxRanges permet de limiter
le nombre de segments de données que le serveur va renvoyer au
client. Si un nombre de segments plus important est demandé, la
ressource sera renvoyée dans son intégralité.
| Description: | Fusion des slashes consécutifs dans les URLs par le serveur. |
|---|---|
| Syntaxe: | MergeSlashes ON|OFF |
| Défaut: | MergeSlashes ON |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.39 du serveur HTTP Apache |
Par défaut, le serveur fusionne les caractères slash ('/') multiples et consécutifs dans la partie chemin de l'URL d'une requête.
Lorsque cette partie chemin de l'URL est appliquée au système de
fichiers, ces slashes multiples sont inutiles. Il peut être cependant
préférable de conserver ces slashes multiples et consécutifs car ils peuvent
avoir une signification dans le cas des URLs gérées différemment, par
exemple par CGI ou par un serveur mandataire. Il convient alors de définir
MergeSlashes à OFF pour conserver les
slashes multiples consécutifs, ce qui correspond au comportement
traditionnel.
Lorsque cette directive est définie à "OFF", les expressions rationnelles utilisées dans le
fichier de configuration pour effectuer une comparaison de la partie chemin
de l'URL ((LocationMatch,
RewriteRule, ...) doivent en effet tenir compte de la
présence éventuelle de slashes multiples et consécutifs. Les sections
Location à base d'expressions non rationnelles
correspondent toujours à des URLs avec slashes fusionnés et ne peuvent pas
tenir compte des slashes multiples.
| Description: | Détermine si les données supplémentaires (trailers) sont fusionnées avec les en-têtes |
|---|---|
| Syntaxe: | MergeTrailers [on|off] |
| Défaut: | MergeTrailers off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.11 du serveur HTTP Apache |
Cette directive permet de contrôler la fusion des données HTTP supplémentaires (trailers) avec la représentation interne des en-têtes. Cette fusion intervient lorsque le corps de la requête a été entièrement reçu, bien longtemps après que la majeure partie du traitement des en-têtes ait une chance de pouvoir examiner ou modifier les en-têtes de la requête.
Cette option a été introduite dans un souci de compatibilité avec les versions antérieures à 2.4.11, où les données supplémentaires étaient systématiquement fusionnées avec les en-têtes de la requête.
| Description: | Définit les mécanismes de mutex et le repertoire du fichier verrou pour tous les mutex ou seulement les mutex spécifiés |
|---|---|
| Syntaxe: | Mutex mécanisme [default|nom-mutex] ... [OmitPID] |
| Défaut: | Mutex default |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible depuis la version 2.3.4 du serveur HTTP Apache |
La directive Mutex permet de définir le
mécanisme de mutex, et éventuellement le répertoire du fichier
verrou que les modules et httpd utilisent pour sérialiser l'accès aux
ressources. Spécifiez default comme second argument
pour modifier la configuration de tous les mutex ; spécifiez un nom
de mutex (voir la table ci-dessous) comme second argument pour
ne modifier que la configuration de ce mutex.
La directive Mutex est typiquement
utilisée dans les situations exceptionnelles suivantes :
Cette directive ne configure que les mutex qui ont été
enregistrés avec le serveur de base via l'API
ap_mutex_register(). Tous les modules fournis avec
httpd supportent la directive Mutex, mais il
n'en sera pas forcément de même pour les modules tiers.
Reportez-vous à la documentation du module tiers considéré afin de
déterminer le(s) nom(s) de mutex qui pourront être définis si la
directive est supportée.
Les mécanismes de mutex disponibles sont les suivants :
default | yes
C'est l'implémentation du verrouillage par défaut, telle
qu'elle est définie par APR. On peut
afficher l'implémentation du verrouillage par défaut via la
commande httpd avec l'option -V.
none | no
Le mutex est désactivé, et cette valeur n'est permise pour un mutex que si le module indique qu'il s'agit d'un choix valide. Consultez la documentation du module pour plus d'informations.
posixsem
Une variante de mutex basée sur un sémaphore Posix.
La propriété du sémaphore n'est pas restituée si un thread du processus gérant le mutex provoque une erreur de segmentation, ce qui provoquera un blocage du serveur web.
sysvsem
Une variante de mutex basée sur un sémaphore IPC SystemV.
Il peut arriver que les sémaphores SysV soient conservés si le processus se crashe avant que le sémaphore ne soit supprimé.
L'API des sémaphores permet les attaques par déni de service
par tout programme CGI s'exécutant sous le même uid que le
serveur web (autrement dit tous les programmes CGI, à moins que
vous n'utilisiez un programme du style suexec
ou cgiwrapper).
sem
Sélection de la "meilleure" implémentation des sémaphores disponible ; le choix s'effectue entre les sémaphores posix et IPC SystemV, dans cet ordre.
pthread
Une variante de mutex à base de mutex de thread Posix inter-processus.
Sur la plupart des systèmes, si un processus enfant se termine anormalement alors qu'il détenait un mutex qui utilise cette implémentation, le serveur va se bloquer et cesser de répondre aux requêtes. Dans ce cas, un redémarrage manuel est nécessaire pour récupérer le mutex.
Solaris et Linux constituent des exceptions notables, en ceci qu'ils fournissent un mécanisme qui permet en général de récupérer le mutex après l'arrêt anormal d'un processus enfant qui détenait le mutex.
Si votre système est compatible POSIX ou implémente la fonction
pthread_mutexattr_setrobust_np(), vous devriez
pouvoir utiliser l'option pthread sans problème.
fcntl:/chemin/vers/mutex
Une variante de mutex utilisant un fichier verrou physique et
la fonction fcntl().
Lorsqu'on utilise plusieurs mutex basés sur ce mécanisme dans
un environnement multi-processus, multi-thread, des erreurs de
blocage (EDEADLK) peuvent être rapportées pour des opérations de
mutex valides si la fonction fcntl() ne gère pas
les threads, comme sous Solaris.
flock:/chemin/vers/mutex
Méthode similaire à fcntl:/chemin/vers/mutex,
mais c'est la fonction flock() qui est utilisée
pour gérer le verrouillage par fichier.
file:/chemin/vers/mutex
Sélection de la "meilleure" implémentation de verrouillage
par fichier disponible ; le choix s'effectue entre
fcntl et flock, dans cet ordre.
La plupart des mécanismes ne sont disponibles que sur les plate-formes où ces dernières et APR les supportent. Les mécanismes qui ne sont pas disponibles sur toutes les plate-formes sont posixsem, sysvsem, sem, pthread, fcntl, flock, et file.
Avec les mécanismes à base de fichier fcntl et
flock, le chemin, s'il est fourni, est un répertoire dans
lequel le fichier verrou sera créé. Le répertoire par
défaut est le répertoire d'exécution de httpd relatif à la
directive ServerRoot.
Utilisez toujours un système
de fichiers local sur disque pour /chemin/vers/mutex et
jamais un répertoire se trouvant dans un système de fichiers NFS ou
AFS. Le nom de base du fichier se composera du type de mutex, d'une
chaîne optionnelle correspondant à l'instance et fournie par le
module ; et, sauf si le mot-clé OmitPID a été spécifié,
l'identificateur du processus parent httpd sera ajouté afin de
rendre le nom du fichier unique, évitant ainsi tout conflit lorsque
plusieurs instances d'httpd partagent le même répertoire de
verrouillage. Par exemple, si le nom de mutex est
mpm-accept, et si le répertoire de verrouillage est
/var/httpd/locks, le nom du fichier verrou pour
l'instance httpd dont le processus parent a pour identifiant 12345
sera /var/httpd/locks/mpm-accept.12345.
Il est conseillé d'éviter de placer les fichiers mutex
dans un répertoire où tout le monde peut écrire comme
/var/tmp, car quelqu'un pourrait initier une attaque
par déni de service et empêcher le serveur de démarrer en créant un
fichier verrou possédant un nom identique à celui que le serveur va
tenter de créer.
La table suivante décrit les noms de mutex utilisés par httpd et ses modules associés.
| Nom mutex | Module(s) | Ressource protégée |
|---|---|---|
mpm-accept |
modules MPM prefork et worker |
connexions entrantes, afin d'éviter le problème de l'afflux de requêtes ; pour plus d'informations, voir la documentation Amélioration des performances |
authdigest-client |
mod_auth_digest |
liste de clients en mémoire partagée |
authdigest-opaque |
mod_auth_digest |
compteur en mémoire partagée |
ldap-cache |
mod_ldap |
cache de résultat de recherche LDAP |
rewrite-map |
mod_rewrite |
communication avec des programmes externes d'associations de valeurs, afin d'éviter les interférences d'entrées/sorties entre plusieurs requêtes |
ssl-cache |
mod_ssl |
cache de session SSL |
ssl-stapling |
mod_ssl |
cache de l'étiquetage OCSP ("OCSP stapling") |
watchdog-callback |
mod_watchdog |
fonction de rappel d'un module client particulier |
Le mot-clé OmitPID permet d'empêcher l'addition de
l'identifiant du processus httpd parent au nom du fichier verrou.
Dans l'exemple suivant, le mécanisme de mutex pour le mutex
mpm-accept est modifié pour passer du mécanisme par défaut au
mécanisme fcntl, avec le fichier verrou associé créé
dans le répertoire /var/httpd/locks. Le mécanisme de
mutex par défaut pour tous les autres mutex deviendra
sysvsem.
Mutex sysvsem default Mutex fcntl:/var/httpd/locks mpm-accept
| Description: | OBSOLETE : Définit une adresse IP pour les serveurs virtuels à base de nom |
|---|---|
| Syntaxe: | NameVirtualHost adresse[:port] |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
Avant la version 2.3.11, il était nécessaire de définir une
directive NameVirtualHost pour indiquer au
serveur qu'une paire adresse IP/port particulière pouvait être
utilisée comme serveur virtuel à base de nom. Depuis la version
2.3.11, chaque fois qu'une paire adresse IP/port est utilisée dans
plusieurs serveurs virtuels, l'hébergement virtuel à base de nom est
automatiquement activé pour cette adresse.
Cette directive n'a actuellement plus aucun effet.
| Description: | Définit les fonctionnalités disponibles pour un répertoire particulier |
|---|---|
| Syntaxe: | Options
[+|-]option [[+|-]option] ... |
| Défaut: | Options FollowSymlinks |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Avec la version 2.3.11, la valeur par défaut passe de All à FollowSymlinks |
La directive Options permet de définir
les fonctionnalités de serveur disponibles pour un répertoire
particulier.
option peut être défini à None, auquel
cas aucune fonctionnalité spécifique n'est activée, ou comprendre
une ou plusieurs des options suivantes :
AllMultiViews.ExecCGImod_cgi est permise.FollowSymLinksBien que le serveur suive les liens symboliques, il ne modifie
pas le nom de chemin concerné défini par la section
<Directory>.
Les options FollowSymLinks et
SymLinksIfOwnerMatch ne fonctionnent que dans les
sections <Directory> ou les fichiers
.htaccess.
Le fait d'omettre cette option ne doit pas être considéré comme une mesure de sécurité efficace, car il existe toujours une situation de compétition (race condition) entre l'instant où l'on vérifie qu'un chemin n'est pas un lien symbolique, et l'instant où l'on utilise effectivement ce chemin.
Includesmod_include sont autorisées.IncludesNOEXEC#exec
cmd et #exec cgi sont désactivés.
L'utilisation de #include virtual pour les scripts
CGI est cependant toujours possible depuis des répertoires
définis par ScriptAlias.IndexesDirectoryIndex (par
exemple index.html) n'est défini pour ce
répertoire, le module mod_autoindex va renvoyer
un listing formaté du répertoire.MultiViewsmod_negotiation sont autorisées.
Cette option est ignorée si elle est
définie en tout autre endroit qu'une section <Directory>, car
mod_negotiation a besoin de ressources réelles
pour effectuer ses comparaisons et ses évaluations.
SymLinksIfOwnerMatchLes options FollowSymLinks et
SymLinksIfOwnerMatch ne fonctionnent que dans les
sections <Directory> ou les fichiers
.htaccess.
Le fait d'omettre cette option ne doit pas être considéré comme une mesure de sécurité efficace, car il existe toujours une situation de compétition (race condition) entre l'instant où l'on vérifie qu'un chemin n'est pas un lien symbolique, et l'instant où l'on utilise effectivement ce chemin.
Normalement, si plusieurs directives
Options peuvent s'appliquer à un répertoire,
c'est la plus spécifique qui est utilisée et les autres sont
ignorées ; les options ne sont pas fusionnées (voir comment les sections sont
fusionnées). Elles le sont cependant si toutes les
options de la directive Options sont
précédées d'un symbole + ou -. Toute
option précédée d'un + est ajoutée à la liste des
options courantes de manière forcée et toute option précédée d'un
- est supprimée de la liste des options courantes de la
même manière.
Mélanger des Options avec +
ou - avec des Options sans
+ ou - constitue une erreur de syntaxe, et
la vérification de la syntaxe au cours du démarrage du serveur fera
échouer ce dernier.
Par exemple, sans aucun symbole + et -
:
<Directory "/web/docs"> Options Indexes FollowSymLinks </Directory> <Directory "/web/docs/spec"> Options Includes </Directory>
ici, seule l'option Includes sera prise en compte
pour le répertoire /web/docs/spec. Par contre, si la
seconde directive Options utilise les
symboles + et - :
<Directory "/web/docs"> Options Indexes FollowSymLinks </Directory> <Directory "/web/docs/spec"> Options +Includes -Indexes </Directory>
alors, les options FollowSymLinks et
Includes seront prises en compte pour le répertoire
/web/docs/spec.
L'utilisation de -IncludesNOEXEC ou
-Includes désactive complètement les inclusions côté
serveur sans tenir compte des définitions précédentes.
En l'absence de toute définition d'options, la valeur par défaut
est FollowSymlinks.
| Description: | Protocole pour une socket d'écoute |
|---|---|
| Syntaxe: | Protocol protocole |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible depuis la version 2.1.5 d'Apache, mais seulement depuis la version 2.3.3 sous Windows. |
Cette directive permet de spécifier le protocole utilisé pour une
socket d'écoute particulière. Le protocole sert à déterminer quel
module doit traiter une requête, et d'appliquer les optimisations
spécifiques au protocole via la directive
AcceptFilter.
Dans la plupart des configurations, cette directive n'est pas nécessaire.
Si elle n'est pas définie, le protocole par défaut pour le port 443 est
https et http pour tous les autres ports. La
connaissance du protocole permet de déterminer quel module doit traiter la
requête, et d'appliquer les optimisations spécifiques au protocole via la
directive AcceptFilter.
Par exemple, si vous travaillez avec le protocole
https sur un port non standard, spécifiez le protocole
de manière explicite :
Protocol https
Vous pouvez aussi spécifier le protocole via la directive
Listen.
| Description: | Protocoles disponibles pour un serveur virtuel ou non |
|---|---|
| Syntaxe: | Protocols protocole ... |
| Défaut: | Protocols http/1.1 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.17 du serveur HTTP Apache. |
Cette directive permet de spécifier la liste des protocoles supportés par un serveur virtuel ou non. Cette liste énumère les protocoles qu'un client sera autorisé à négocier avec ce serveur.
Par défaut, seul le protocole http/1.1 est disponible (compatible avec les clients http/1.0 et http/0.9). Par conséquent, vous devez fournir cette liste si vous voulez étendre les protocoles disponibles pour le serveur.
Par exemple, si vous voulez autoriser le protocole HTTP/2 pour un serveur avec TLS, utilisez cette directive comme suit :
Protocols h2 http/1.1
Les protocoles valides sont http/1.1 pour les
connexions http et https, h2 pour les connections
https et h2c pour les connexions http. D'autres
modules peuvent fournir d'autres protocoles.
Spécifier des protocoles non disponibles ou désactivés n'aura aucun effet, et ceux-ci seront simplement ignorés.
Si un serveur virtuel ne possède pas de directive Protocols propre, il hérite des protocoles spécifiés pour le serveur principal. Autrement dit, les directives Protocols définies au niveau d'un serveur virtuel remplacent celles définies au niveau du serveur principal.
| Description: | Détermine qui du client ou du serveur détermine l'ordre des protocoles au cours de la négociation de la connexion |
|---|---|
| Syntaxe: | ProtocolsHonorOrder On|Off |
| Défaut: | ProtocolsHonorOrder On |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.17 du serveur HTTP Apache. |
Cette directive permet de définir si le serveur doit tenir
compte de l'ordre des protocoles définis par la directive
Protocols.
Si cette directive est définie à Off, l'ordre de la liste des protocoles fournie par le client l'emporte sur l'ordre défini dans la configuration du serveur.
Si la directive ProtocolsHonorOrder
est définie à on (valeur par défaut),
il n'est pas tenu compte de l'ordre de la liste des protocoles
fournie par le client, et seul l'ordre de la liste des protocles
définie au niveau du serveur influera la
négociation du protocole.
| Description: | Vérifie si la variable d'environnement REDIRECT_URL est pleinement qualifiée |
|---|---|
| Syntaxe: | QualifyRedirectURL On|Off |
| Défaut: | QualifyRedirectURL Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Directive supportée à partir de la version 2.4.18 du serveur HTTP Apache. Jusqu'à la version 2.4.17, le serveur se comportait comme si la directive QualifyRedirectURL était définie à On. |
Cette directive permet de s'assurer que le serveur vérifiera que
la variable d'environnement REDIRECT_URL est bien pleinement
qualifiée. Par défaut, cette variable contient l'URL textuellement
demandée par le client, par exemple "/index.html". Avec
QualifyRedirectURL ON, la même requête
affectera à la variable REDIRECT_URL une valeur du style
"http://www.example.com/index.html".
Même si cette directive n'est pas définie, lorsqu'une requête est soumise avec une URL pleinement qualifiée, la variable REDIRECT_URL contiendra quand-même une URL pleinement qualifiée.
| Description: | Taille des tampons utilisés pour lire les données |
|---|---|
| Syntaxe: | ReadBufferSize bytes |
| Défaut: | ReadBufferSize 8192 |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.5 du serveur HTTP Apache. |
Cette directive permet de définir la taille (en octets) du tampon mémoire utilisé pour lire des données depuis le réseau ou un fichier.
Un tampon de grande taille peut améliorer les performances pour les grandes quantités de données, mais consomme d'avantage de mémoire par connexion. La taille minimale du tampon est de 1024 octets.
| Description: | Configuration des options globales par défaut pour les expressions rationnelles |
|---|---|
| Syntaxe: | RegexDefaultOptions [none] [+|-]option [[+|-]option] ... |
| Défaut: | RegexDefaultOptions DOTALL DOLLAR_ENDONLY |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.30 du serveur HTTP Apache. |
Cette directive permet d'ajouter certains comportements par défaut à TOUTES les expressions rationnelles utilisées ultérieurement.
Toute option précédée d'un '+' est ajoutée aux options déjà définies.
Toute option précédée d'un '-' est enlevée des options déjà définies.
Toute option non suffixée par '+' ou '-' sera définie et remplacera
l'option correspondante éventuellement déjà définie.
Le mot-clé none annule toutes les options déjà définies.
option peut être :
ICASEEXTENDEDDOTALLDOLLAR_ENDONLY# Ajoute l'option ICASE par défaut pour toutes les expressions rationnelles RegexDefaultOptions +ICASE ... # Supprime l'option DOLLAR_ENDONLY par défaut et conserve toutes les autres # options RegexDefaultOptions -DOLLAR_ENDONLY ... # Définit l'option DOTALL seule et annule toutes les autres options RegexDefaultOptions DOTALL ... # Annule toutes les options définies RegexDefaultOptions none ...
| Description: | Enregistrement de méthodes HTTP non standards |
|---|---|
| Syntaxe: | RegisterHttpMethod méthode [méthode [...]] |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.24 du serveur HTTP Apache |
Cette directive permet d'enregistrer des méthodes HTTP supplémentaires. Ceci s'avérera nécessaire si l'on doit utiliser des méthodes non standards avec des directives qui acceptent des noms de méthodes en paramètres, ou pour permettre l'utilisation de méthodes particulières non standards en passant par un serveur mandataire ou au sein de scripts CGI, et ceci alors que le serveur a été configuré pour ne transmettre que des méthodes reconnues aux modules.
| Description: | Limite le temps CPU alloué aux processus initiés par les processus enfants d'Apache httpd |
|---|---|
| Syntaxe: | RLimitCPU secondes|max [secondes|max] |
| Défaut: | Non défini ; utilise les valeurs par défaut du système
d'exploitation |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
Prend 1 ou 2 paramètres. Le premier definit la limite de
consommation de ressources pour tous les processus, et le second la
consommation de ressources maximale. Les deux paramètres peuvent
contenir soit un nombre, soit max pour indiquer au
serveur que la limite de consommation correspond à la valeur
maximale autorisée par la configuration du système d'exploitation.
Pour augmenter la consommation maximale de ressources, le serveur
doit s'exécuter en tant que root, ou se trouver dans sa
phase de démarrage.
Cette directive s'applique aux processus initiés par les processus enfants d'Apache httpd qui traitent les requêtes, et non aux processus enfants eux-mêmes. Sont concernés les scripts CGI et les commandes exec des SSI, mais en aucun cas les processus initiés par le processus parent d'Apache httpd comme les journalisations redirigées vers un programme.
Les limites de ressources CPU sont exprimées en secondes par processus.
| Description: | Limite la mémoire allouée aux processus initiés par les processus enfants d'Apache httpd |
|---|---|
| Syntaxe: | RLimitMEM octets|max [octets|max] |
| Défaut: | Non défini ; utilise les valeurs par défaut du système
d'exploitation |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
Prend 1 ou 2 paramètres. Le premier definit la limite de
consommation de ressources pour tous les processus, et le second la
consommation de ressources maximale. Les deux paramètres peuvent
contenir soit un nombre, soit max pour indiquer au
serveur que la limite de consommation correspond à la valeur
maximale autorisée par la configuration du système d'exploitation.
Pour augmenter la consommation maximale de ressources, le serveur
doit s'exécuter en tant que root, ou se trouver dans sa
phase de démarrage.
Cette directive s'applique aux processus initiés par les processus enfants d'Apache httpd qui traitent les requêtes, et non aux processus enfants eux-mêmes. Sont concernés les scripts CGI et les commandes exec des SSI, mais en aucun cas les processus initiés par le processus parent d'Apache httpd comme les journalisations redirigées vers un programme.
Les limites de ressources mémoire sont exprimées en octets par processus.
| Description: | Limite le nombre de processus qui peuvent être initiés par les processus initiés par les processus enfants d'Apache httpd |
|---|---|
| Syntaxe: | RLimitNPROC nombre|max [nombre|max] |
| Défaut: | Unset; uses operating system defaults |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
Prend 1 ou 2 paramètres. Le premier definit la limite de
consommation de ressources pour tous les processus, et le second la
consommation de ressources maximale. Les deux paramètres peuvent
contenir soit un nombre, soit max pour indiquer au
serveur que la limite de consommation correspond à la valeur
maximale autorisée par la configuration du système d'exploitation.
Pour augmenter la consommation maximale de ressources, le serveur
doit s'exécuter en tant que root, ou se trouver dans sa
phase de démarrage.
Cette directive s'applique aux processus initiés par les processus enfants d'Apache httpd qui traitent les requêtes, et non aux processus enfants eux-mêmes. Sont concernés les scripts CGI et les commandes exec des SSI, mais en aucun cas les processus initiés par le processus parent d'Apache httpd comme les journalisations redirigées vers un programme.
Les limites des processus contrôlent le nombre de processus par utilisateur.
Si les processus CGI s'exécutent sous le même
utilisateur que celui du serveur web, cette
directive va limiter le nombre de processus que le serveur
pourra lui-même créer. La présence de messages
cannot fork dans le journal des
erreurs indiquera que la limite est atteinte.
| Description: | Permet de localiser l'interpréteur des scripts CGI |
|---|---|
| Syntaxe: | ScriptInterpreterSource Registry|Registry-Strict|Script |
| Défaut: | ScriptInterpreterSource Script |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Win32 seulement. |
Cette directive permet de contrôler la méthode qu'utilise Apache
httpd pour trouver l'interpréteur destiné à exécuter les scripts CGI. La
définition par défaut est Script : ceci indique à
Apache httpd qu'il doit utiliser l'interpréteur précisé dans la ligne
shebang du script (la première ligne, commençant par
#!). Sur les systèmes Win32, cette ligne ressemble
souvent à ceci :
#!C:/Perl/bin/perl.exe
ou simplement, dans le cas où perl est dans le
PATH :
#!perl
Avec ScriptInterpreterSource Registry, Windows va
effectuer une recherche dans l'arborescence
HKEY_CLASSES_ROOT de la base de registre avec comme
mot-clé l'extension du fichier contenant le script (par exemple
.pl). C'est la commande définie par la sous-clé de
registre Shell\ExecCGI\Command ou, si elle n'existe
pas, la sous-clé Shell\Open\Command qui est utilisée
pour ouvrir le fichier du script. Si ces clés de registre ne sont
pas trouvées, Apache httpd utilise la méthode de l'option
Script.
Soyez prudent si vous utilisez ScriptInterpreterSource
Registry avec des répertoires faisant l'objet d'un ScriptAlias, car Apache httpd va essayer
d'exécuter tous les fichiers contenus dans
celui-ci. L'option Registry peut causer des appels de
programmes non voulus sur des fichiers non destinés à être exécutés.
Par exemple, la commande par défaut open sur les fichiers
.htm sur la plupart des systèmes Windows va lancer
Microsoft Internet Explorer ; ainsi, toute requête HTTP pour un
fichier .htm situé dans le répertoire des scripts
va lancer le navigateur en arrière-plan sur le serveur, ce qui a
toutes les chances de crasher votre système dans les minutes qui
suivent.
L'option Registry-Strict
agit de manière identique à Registry, mais n'utilise
que la sous-clé Shell\ExecCGI\Command. La présence de
la clé ExecCGI n'étant pas systématique, Elle doit être
définie manuellement dans le registre Windows et évite ainsi tout
appel de programme accidentel sur votre système.
| Description: | Détermine si mod_status affiche les 63 premiers caractères d'une requête ou les 63 derniers, en supposant que la requête elle-même possède plus de 63 caractères. |
|---|---|
| Syntaxe: | SeeRequestTail On|Off |
| Défaut: | SeeRequestTail Off |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible depuis la version 2.2.7 d'Apache httpd. |
Avec ExtendedStatus On, mod_status affiche la
véritable requête en cours de traitement. Pour des raisons
historiques, seuls 63 caractères de la requête sont réellement
stockés à des fins d'affichage. Cette directive permet de déterminer
si ce sont les 63 premiers caractères qui seront stockés (c'est le
comportement par défaut),
ou si ce sont les 63 derniers. Ceci ne s'applique bien entendu que
si la taille de la requête est de 64 caractères ou plus.
Si Apache httpd traite la requête GET /disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1
, l'affichage de la requête par mod_status se présentera comme suit :
| Off (défaut) | GET /disque1/stockage/apache/htdocs/images/rep-images1/nourritu |
|---|---|
| On | apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1 |
| Description: | L'adresse électronique que le serveur inclut dans les messages d'erreur envoyés au client |
|---|---|
| Syntaxe: | ServerAdmin adresse électronique|URL |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
La directive ServerAdmin permet de définir
l'adresse de contact que le serveur va inclure dans tout message
d'erreur qu'il envoie au client. Si le programme httpd
ne reconnait pas l'argument fourni comme une URL, il suppose que
c'est une adresse électronique, et lui ajoute le préfixe
mailto: dans les cibles des hyperliens. Il est
cependant recommandé d'utiliser exclusivement une adresse
électronique, car de nombreux scripts CGI considèrent ceci comme
implicite. Si vous utilisez une URL, elle doit pointer vers un autre
serveur que vous contrôlez. Dans le cas contraire, les utilisateurs
seraient dans l'impossibilité de vous contacter en cas de problème.
Il peut s'avérer utile de définir une adresse dédiée à l'administration du serveur, par exemple :
ServerAdmin www-admin@foo.example.com
car les utilisateurs ne mentionnent pas systématiquement le serveur dont ils parlent !
| Description: | Autres noms d'un serveur utilisables pour atteindre des serveurs virtuels à base de nom |
|---|---|
| Syntaxe: | ServerAlias nom serveur [nom serveur]
... |
| Contexte: | serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
La directive ServerAlias permet de définir
les noms alternatifs d'un serveur utilisables pour atteindre des serveurs virtuels à base de
nom. La directive ServerAlias peut
contenir des caractères génériques, si nécessaire.
<VirtualHost *:80> ServerName server.example.com ServerAlias server server2.example.com server2 ServerAlias *.example.com UseCanonicalName Off # ... </VirtualHost>
La recherche du serveur virtuel à base de nom correspondant au
plus près à la requête s'effectue selon l'ordre d'apparition des
directives <virtualhost> dans le fichier de
configuration. Le premier serveur virtuel dont le ServerName ou le ServerAlias correspond est choisi, sans
priorité particulière si le nom contient des caractères génériques
(que ce soit pour ServerName ou ServerAlias).
Tous les noms spécifiés au sein d'une section <VirtualHost> sont traités comme un
ServerAlias (sans caractères génériques).
| Description: | Nom d'hôte et port que le serveur utilise pour s'authentifier lui-même |
|---|---|
| Syntaxe: | ServerName
[protocole://]nom-de-domaine|adresse-ip[:port] |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
La directive ServerName permet de définir
les protocole, nom d'hôte et port d'une requête que le serveur
utilise pour s'authentifier lui-même.
La directive ServerName permet (éventuellement en
conjonction avec la directive ServerAlias) d'identifier de manière unique un
serveur virtuel, lorsqu'elle est utilisée dans un contexte de serveurs virtuels à base de noms.
Cette directive est aussi utilisée lors de la création d'URLs de
redirection relatives quand la directive UseCanonicalName est définie à une valeur autre
que la valeur par défaut.
Par exemple, si le nom de la
machine hébergeant le serveur web est
simple.example.com, la machine possède l'alias
DNS www.example.com, et si vous voulez que le serveur
web s'identifie avec cet alias, vous devez utilisez la définition
suivante :
ServerName www.example.com
La directive ServerName peut apparaître à
toutes les étapes de la définition du serveur. Toute occurrence
annule cependant la précédente (pour ce serveur).
Si la directive ServerName n'est pas
définie, le serveur tente de déterminer le nom
d'hôte visible du point de vue du client en demandant tout d'abord au
système d'exploitation le nom d'hôte système, et en cas d'échec, en effectuant
une recherche DNS inverse sur une adresse IP présente sur le système.
Si la directive
ServerName ne précise pas de port, le serveur
utilisera celui de la requête entrante. Il est recommandé de
spécifier un nom d'hôte et un port spécifiques à l'aide de la
directive ServerName pour une fiabilité
optimale et à titre préventif.
Si vous définissez des serveurs virtuels à base de
nom, une directive ServerName située à
l'intérieur d'une section <VirtualHost> spécifiera quel nom d'hôte
doit apparaître dans l'en-tête de requête Host: pour
pouvoir atteindre ce serveur virtuel.
Parfois, le serveur s'exécute en amont d'un dispositif qui
implémente SSL, comme un mandataire inverse, un répartiteur de
charge ou un boîtier dédié SSL. Dans ce cas, spécifiez le protocole
https:// et le port auquel les clients se connectent
dans la directive ServerName, afin de
s'assurer que le serveur génère correctement ses URLs
d'auto-identification.
Voir la description des directives UseCanonicalName et UseCanonicalPhysicalPort pour les
définitions qui permettent de déterminer si les URLs
auto-identifiantes (par exemple via le module
mod_dir) vont faire référence au port spécifié, ou
au port indiqué dans la requête du client.
Si la valeur de la directive ServerName ne
peut pas être résolue en adresse IP, le démarrage du serveur
provoquera un avertissement. httpd va alors utiliser le
résultat de la commande système hostname pour
déterminer le nom du serveur, ce qui ne correspondra pratiquement
jamais au nom de serveur que vous souhaitez réellement.
httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName
| Description: | Nom de chemin d'URL hérité pour un serveur virtuel à base de nom accédé par un navigateur incompatible |
|---|---|
| Syntaxe: | ServerPath chemin d'URL |
| Contexte: | serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
La directive ServerPath permet de définir
le nom de chemin d'URL hérité d'un hôte, à utiliser avec les serveurs virtuels à base de nom.
| Description: | Racine du répertoire d'installation du serveur |
|---|---|
| Syntaxe: | ServerRoot chemin de répertoire |
| Défaut: | ServerRoot /usr/local/apache |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
La directive ServerRoot permet de définir
le répertoire dans lequel le serveur est installé. En particulier,
il contiendra les sous-répertoires conf/ et
logs/. Les chemins relatifs indiqués dans les autres
directives (comme Include ou LoadModule) seront définis par
rapport à ce répertoire.
ServerRoot "/home/httpd"
La valeur par défaut de ServerRoot peut
être modifiée via l'argument --prefix de la commande configure, et de
nombreuses distributions tierces du serveur proposent une valeur
différente de celles listées ci-dessus.
-d
options de httpdServerRoot| Description: | Définit un pied de page pour les documents générés par le serveur |
|---|---|
| Syntaxe: | ServerSignature On|Off|EMail |
| Défaut: | ServerSignature Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Noyau httpd |
| Module: | core |
La directive ServerSignature permet de
définir une ligne de pied de page fixe pour les documents générés
par le serveur (messages d'erreur, listings de répertoires ftp de
mod_proxy, sorties de mod_info,
etc...). Dans le cas d'une chaîne de mandataires, l'utilisateur n'a
souvent aucun moyen de déterminer lequel des mandataires chaînés a
généré un message d'erreur, et c'est une des raisons pour lesquelles
on peut être amené à ajouter un tel pied de page.
La valeur par défaut Off supprime la ligne de pied
de page. la valeur On
ajoute simplement une ligne contenant le numéro de version du
serveur ainsi que le nom du serveur virtuel issu de la directive
ServerName, alors que la valeur
EMail ajoute en plus une référence "mailto:" à
l'administrateur du document référencé issu la directive
ServerAdmin.
Les détails à propos du numéro de
version du serveur sont contrôlés à l'aide de la directive
ServerTokens.
| Description: | Configure l'en-tête Server de la réponse
HTTP |
|---|---|
| Syntaxe: | ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full |
| Défaut: | ServerTokens Full |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
Cette directive permet de contrôler le contenu de l'en-tête
Server inclus dans la réponse envoyée au client : cet
en-tête peut contenir le type de système d'exploitation du serveur,
ainsi que des informations à propos des modules compilés avec le
serveur.
ServerTokens Full (ou non spécifié)Server: Apache/2.4.2
(Unix) PHP/4.2.2 MyMod/1.2ServerTokens Prod[uctOnly]Server:
ApacheServerTokens MajorServer:
Apache/2ServerTokens MinorServer:
Apache/2.4ServerTokens Min[imal]Server:
Apache/2.4.2ServerTokens OSServer:
Apache/2.4.2 (Unix)Cette définition s'applique à l'ensemble du serveur et ne peut être activée ou désactivée pour tel ou tel serveur virtuel.
Cette directive contrôle
aussi les informations fournies par la directive ServerSignature.
ServerTokens à une
valeur inférieure à minimal n'est pas
recommandé car le débogage des problèmes
interopérationnels n'en sera alors que plus difficile. Notez
aussi que la désactivation de l'en-tête Server:
n'améliore en rien la sécurité de votre
serveur ; le concept de "sécurité par
l'obscurité" est un mythe et conduit à
une mauvaise perception de ce qu'est la sécurité.| Description: | Force le traitement des fichiers spécifiés par un gestionnaire particulier |
|---|---|
| Syntaxe: | SetHandler handler-name|none|expression |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | L'argument expression est disponible à partir de la version 2.4.19 su serveur HTTP Apache |
Lorsqu'elle se situe à l'intérieur d'un fichier
.htaccess, ou d'une section <Directory> ou <Location>, cette directive force le
traitement de tous les fichiers spécifiés par le gestionnaire défini par l'argument
nom gestionnaire. Par exemple, dans le cas d'un
répertoire dont vous voulez interpréter le contenu comme des
fichiers de règles d'images cliquables, sans tenir compte des
extensions, vous pouvez ajouter la ligne suivante dans un fichier
.htaccess de ce répertoire :
SetHandler imap-file
Autre exemple : si vous voulez que le serveur affiche un
compte-rendu d'état chaque fois qu'une URL du type http://nom
serveur/status est appelée, vous pouvez ajouter ceci dans
httpd.conf :
<Location "/status"> SetHandler server-status </Location>
Vous pouvez aussi utiliser cette directive pour associer un gestionnaire à des fichiers possèdant une extension de nom de fichier particulière. Par exemple :
<FilesMatch "\.php$">
SetHandler application/x-httpd-php
</FilesMatch>
Pour référencer des variables spécifiques à une requête, y compris les références arrières vers des expressions rationnelles nommées, vous pouvez utiliser des expressions ayant pour valeur une chaîne :
<LocationMatch ^/app/(?<sub>[^/]+)/>
SetHandler "proxy:unix:/var/run/app_%{env:MATCH_sub}.sock|fcgi://localhost:8080"
</LocationMatch>
Vous pouvez écraser la définition antérieure d'une directive
SetHandler en utilisant la valeur
None.
Comme SetHandler l'emporte sur la
définition des gestionnaires par défaut, le comportement habituel
consistant à traiter les URLs se terminant par un slash (/) comme
des répertoires ou des fichiers index est désactivé.
| Description: | Définit les filtres par lesquels vont passer les requêtes client et les données POST |
|---|---|
| Syntaxe: | SetInputFilter filtre[;filtre...] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
La directive SetInputFilter permet de
définir le ou les filtres par lesquels vont passer les requêtes
client et les données POST au moment où le serveur les reçoit. Cette
définition vient en ajout à tout autre filtre défini en
quelqu'endroit que ce soit, y compris via la directive AddInputFilter.
Si la directive comporte plusieurs filtres, ils doivent être séparés par des points-virgules, et spécifiés selon l'ordre dans lequel vous souhaitez les voir agir sur les contenus.
| Description: | Définit les filtres par lesquels vont passer les réponses du serveur |
|---|---|
| Syntaxe: | SetOutputFilter filtre[;filtre...] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Noyau httpd |
| Module: | core |
La directive SetOutputFilter permet de
définir les filtres par lesquels vont passer les réponses du serveur
avant d'être envoyées au client. Cette définition vient en ajout à
tout autre filtre défini en quelqu'endroit que ce soit, y compris
via la directive AddOutputFilter.
Par exemple, la configuration suivante va traiter tous les
fichiers du répertoire /www/data/ comme des inclusions
côté serveur (SSI) :
<Directory "/www/data/"> SetOutputFilter INCLUDES </Directory>
Si la directive comporte plusieurs filtres, ils doivent être séparés par des points-virgules, et spécifiés selon l'ordre dans lequel vous souhaitez les voir agir sur les contenus.
| Description: | Détermine si le nom d'hôte contenu dans une requête doit être explicitement spécifié au niveau du serveur virtuel qui a pris en compte cette dernière. |
|---|---|
| Syntaxe: | StrictHostCheck ON|OFF |
| Défaut: | StrictHostCheck OFF |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Disponible à partir de la version 2.4.49 du serveur HTTP Apache. |
Par défaut, le serveur répond aux requêtes quel que soit le nom d'hôte qu'elles contiennent, y compris un nom d'hôte non prévu dans la configuration. Bien que cela soit pratique, il peut s'avérer souhaitable de restreindre les noms d'hôte qu'une application sous-jacente devra prendre en compte car elle va souvent générer des réponses en se référençant elle-même.
Si la directive StrictHostCheck est définie à
ON, le serveur générera une erreur HTTP 400 si le nom d'hôte que
contient la requête n'a pas été explicitement spécifié par une directive
ServerName ou ServerAlias au niveau du serveur virtuel qui
correspond le mieux aux caractéristiques de la connexion entrante.
Cette directive permet aussi de rechercher une correspondance entre le nom
d'hôte de la requête et les noms d'hôte spécifiés au sein de la balise
ouvrante VirtualHost. Il s'agit
cependant d'un mécanisme de configuration relativement obscur qui agit comme
une directive ServerAlias
supplémentaire.
Cette directive n'a aucun effet dans les serveurs virtuels qui ne sont pas des serveurs par défaut. La valeur héritée de la configuration globale du serveur ou le serveur virtuel par défaut pour l'adresse IP/port de la connexion sous-jacente déterminent la valeur effective.
| Description: | Temps pendant lequel le serveur va attendre certains évènements avant de considérer qu'une requête a échoué |
|---|---|
| Syntaxe: | TimeOut secondes |
| Défaut: | TimeOut 60 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
La directive TimeOut permet de définir le
temps maximum pendant lequel Apache httpd va attendre des entrées/sorties
selon les circonstances :
Lors de la lecture de données en provenance du client, le temps maximum jusqu'à l'arrivée d'un paquet TCP si le tampon est vide.
Pour les données initiales d'une nouvelle connexion, et tant qu'une
directive AcceptFilter n'aura pas
transmis cette nouvelle connexion au serveur, cette directive n'aura aucun
effet.
mod_cgi et mod_cgid, le temps
d'attente maximum pour un bloc individuel en sortie d'un script CGI.mod_ext_filter, le temps d'attente
maximum des sorties d'un processus de filtrage.mod_proxy, la valeur du délai par défaut
si ProxyTimeout n'est
pas défini.| Description: | Détermine le comportement des requêtes
TRACE |
|---|---|
| Syntaxe: | TraceEnable [on|off|extended] |
| Défaut: | TraceEnable on |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Noyau httpd |
| Module: | core |
Cette directive l'emporte sur le comportement de
TRACE pour le noyau du serveur et
mod_proxy. La définition par défaut
TraceEnable on permet des requêtes TRACE
selon la RFC 2616, qui interdit d'ajouter tout corps à la requête.
La définition TraceEnable off indique au noyau du
serveur et à mod_proxy de retourner un code
d'erreur 405 (Méthode non autorisée) au client.
En fait, et à des fins de test et de diagnostic seulement, on
peut autoriser l'ajout d'un corps de requête à l'aide de la
définition non standard TraceEnable extended. Le noyau
du serveur (dans le cas d'un serveur d'origine) va limiter la taille
du corps de requête à 64Kb (plus 8Kb pour les en-têtes de
fractionnement si Transfer-Encoding: chunked est
utilisé). Le noyau du serveur va reproduire l'ensemble des en-têtes,
y compris les en-têtes de fractionnement avec le corps de la
réponse. Dans le cas d'un serveur mandataire, la taille du corps de
requête n'est pas limitée à 64Kb.
Bien que certains prétendent le contraire, activer la méthode
TRACE ne constitue pas un problème de sécurité dans Apache
httpd. La méthode TRACE est définie par la spécification
HTTP/1.1 et les différentes implémentations sont censées la supporter.
| Description: | Définit quels sont les noms d’hôte UNC auxquels le serveur peut accéder |
|---|---|
| Syntaxe: | UNCList hostname [hostname...] |
| Défaut: | unset |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
| Compatibilité: | Windows seulement. Disponible à partir de la version 2.4.60 du serveur HTTP Apache. |
Au cours de leur traitement, les requêtes pour accéder à un chemin du système de fichiers qui aboutissent à un chemin UNC échoueront si le nom d’hôte dans le chemin UNC n’a pas été spécifié par cette directive. Le but est de limiter l’accès aux chemins dérivés d’entrées non fiables.
UNCList example.com other.example.com
Les chemins UNC accédés en dehors du traitement d’une requête, par exemple au cours du démarrage, ne font pas nécessairement l’objet d’une vérification par rapport aux noms d’hôte configurés avec cette directive.
Cette directive doit être placée avant les chemins UNC utilisés dans le fichier httpd.conf. Plusieurs occurences de la directive redéfinissent la liste.
| Description: | Invalide la définition d'une variable |
|---|---|
| Syntaxe: | UnDefine nom-variable |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
Annule l'effet d'une directive Define ou d'un argument -D de
httpd en invalidant l'existence de la variable
correspondante.
On peut utiliser cette directive pour inverser l'effet d'une
section <IfDefine>
sans avoir à modifier les arguments -D dans les scripts
de démarrage.
Afin d'éviter tout risque de collision avec la syntaxe de la directive
RewriteMap, les noms de
variables ne doivent pas contenir de caractère ":".
Si cette directive est définie au sein d'un bloc VirtualHost, les changements qu'elle induit sont visibles de toute directive ultérieure, au delà de tout bloc VirtualHost.
| Description: | Définit la manière dont le serveur détermine son propre nom et son port |
|---|---|
| Syntaxe: | UseCanonicalName On|Off|DNS |
| Défaut: | UseCanonicalName Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Noyau httpd |
| Module: | core |
Dans de nombreuses situations, Apache httpd doit construire une URL
auto-identifiante -- c'est à dire une URL qui fait
référence au serveur lui-même. Avec UseCanonicalName
On, Apache httpd va utiliser le nom d'hôte et le port spécifiés par
la directive ServerName pour
construire le nom canonique du serveur. Ce nom est utilisé dans
toutes les URLs auto-identifiantes, et affecté aux variables
SERVER_NAME et SERVER_PORT dans les
programmes CGI.
Avec UseCanonicalName Off, Apache httpd va construire ses
URLs auto-identifiantes à l'aide du nom d'hôte et du port fournis
par le client, si ce dernier en a fourni un (dans la négative,
Apache utilisera le nom canonique, de la même manière que
ci-dessus). Ces valeurs sont les mêmes que celles qui sont utilisées
pour implémenter les serveurs virtuels à base de
nom, et sont disponibles avec les mêmes clients. De même, les
variables CGI SERVER_NAME et SERVER_PORT
seront affectées des valeurs fournies par le client.
Cette directive peut s'avérer utile, par exemple, sur un serveur
intranet auquel les utilisateurs se connectent en utilisant des noms
courts tels que www. Si les utilisateurs tapent un nom
court suivi d'une URL qui fait référence à un répertoire, comme
http://www/splat, sans le slash terminal, vous
remarquerez qu'Apache httpd va les rediriger vers
http://www.example.com/splat/. Si vous avez activé
l'authentification, ceci va obliger l'utilisateur à s'authentifier
deux fois (une première fois pour www et une seconde
fois pour www.example.com -- voir la
foire aux questions sur ce sujet pour plus d'informations).
Par contre, si UseCanonicalName est définie à
Off, Apache httpd redirigera l'utilisateur vers
http://www/splat/.
Pour l'hébergement virtuel en masse à base d'adresse IP, on
utilise une troisième option, UseCanonicalName
DNS, pour supporter les clients anciens qui ne
fournissent pas d'en-tête Host:. Apache httpd effectue alors
une recherche DNS inverse sur l'adresse IP du serveur auquel le
client s'est connecté afin de construire ses URLs
auto-identifiantes.
Les programmes CGI risquent d'être perturbés par cette option
s'ils tiennent compte de la variable SERVER_NAME. Le
client est pratiquement libre de fournir la valeur qu'il veut comme
nom d'hôte. Mais si le programme CGI n'utilise
SERVER_NAME que pour construire des URLs
auto-identifiantes, il ne devrait pas y avoir de problème.
| Description: | Définit la manière dont le serveur détermine son propre port |
|---|---|
| Syntaxe: | UseCanonicalPhysicalPort On|Off |
| Défaut: | UseCanonicalPhysicalPort Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Noyau httpd |
| Module: | core |
Dans de nombreuses situations, Apache httpd doit construire une URL
auto-identifiante -- c'est à dire une URL qui fait
référence au serveur lui-même. Avec UseCanonicalPhysicalPort
On, Apache httpd va fournir le numéro de port physique réel utilisé
par la requête en tant que port potentiel, pour construire le port
canonique afin que le serveur puisse alimenter la directive
UseCanonicalName. Avec
UseCanonicalPhysicalPort Off, Apache httpd n'utilisera pas le
numéro de port physique réel, mais au contraire se référera aux
informations de configuration pour construire un numéro de port
valide.
L'ordre dans lequel s'effectue la recherche quand on utilise le port physique est le suivant :
UseCanonicalName OnServernameUseCanonicalName Off | DNSHost:ServernameAvec UseCanonicalPhysicalPort Off, on reprend
l'ordre ci-dessus en supprimant "Port physique".
| Description: | Contient des directives qui ne s'appliquent qu'à un nom d'hôte spécifique ou à une adresse IP |
|---|---|
| Syntaxe: | <VirtualHost
adresse IP[:port] [adresse
IP[:port]] ...> ...
</VirtualHost> |
| Contexte: | configuration globale |
| Statut: | Noyau httpd |
| Module: | core |
Les balises <VirtualHost> et
</VirtualHost> permettent de rassembler un groupe
de directives qui ne s'appliquent qu'à un serveur virtuel
particulier. Toute directive autorisée dans un contexte de serveur
virtuel peut être utilisée. Lorsque le serveur reçoit un requête
pour un document hébergé par un serveur virtuel particulier, il
applique les directives de configuration rassemblées dans la section
<VirtualHost>. adresse
IP peut être une des entités suivantes, éventuellement suivies
d'un caractère ':' et d'un numéro de port (ou *) :
*, qui agit comme un
caractère générique, et correspond à toute adresse IP._default_, dont la signification est
identique à celle du caractère *<VirtualHost 10.1.2.3:80> ServerAdmin webmaster@host.example.com DocumentRoot "/www/docs/host.example.com" ServerName host.example.com ErrorLog "logs/host.example.com-error_log" TransferLog "logs/host.example.com-access_log" </VirtualHost>
Les adresses IPv6 doivent être entourées de crochets car dans le cas contraire, un éventuel port optionnel ne pourrait pas être déterminé. Voici un exemple de serveur virtuel avec adresse IPv6 :
<VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80> ServerAdmin webmaster@host.example.com DocumentRoot "/www/docs/host.example.com" ServerName host.example.com ErrorLog "logs/host.example.com-error_log" TransferLog "logs/host.example.com-access_log" </VirtualHost>
Chaque serveur virtuel doit correspondre à une adresse IP, un
port ou un nom d'hôte spécifique ; dans le premier cas, le serveur
doit être configuré pour recevoir les paquets IP de plusieurs
adresses (si le serveur n'a qu'une interface réseau, on peut
utiliser à cet effet la commande ifconfig alias -- si
votre système d'exploitation le permet).
L'utilisation de la directive <VirtualHost> n'affecte en rien les
adresses IP sur lesquelles Apache httpd est en écoute. Vous devez vous
assurer que les adresses des serveurs virtuels sont bien incluses
dans la liste des adresses précisées par la directive Listen.
Tout bloc <VirtualHost> doit comporter une directive
ServerName. Dans le cas
contraire, le serveur virtuel héritera de la valeur de la directive
ServerName issue de la
configuration du serveur principal.
A l'arrivée d'une requête, le serveur tente de la
faire prendre en compte par la section <VirtualHost> qui correspond le mieux en ne
se basant que sur la paire adresse IP/port. Les chaînes sans
caractères génériques l'emportent sur celles qui en contiennent. Si
aucune correspondance du point de vue de l'adresse IP/port n'est
trouvée, c'est la configuration du serveur "principal" qui sera
utilisée.
Si plusieurs serveurs virtuels correspondent du point de vue de l'adresse IP/port, le serveur sélectionne celui qui correspond le mieux du point de vue du nom d'hôte de la requête. Si aucune correspondance du point de vue du nom d'hôte n'est trouvée, c'est le premier serveur virtuel dont l'adresse IP/port correspond qui sera utilisé. Par voie de conséquence, le premier serveur virtuel comportant une certaine paire adresse IP/port est le serveur virtuel par défaut pour cette paire adresse IP/port.
Voir le document sur les conseils à propos de sécurité pour une description détaillée des raisons pour lesquelles la sécurité de votre serveur pourrait être compromise, si le répertoire contenant les fichiers journaux est inscriptible par tout autre utilisateur que celui qui démarre le serveur.
Apache HTTP サーバ バージョン 2.4
| 説明: | 常に使用可能な Apache HTTP サーバのコア機能 |
|---|---|
| ステータス: | Core |
AcceptFilter AcceptPathInfo AccessFileName AddDefaultCharset AllowEncodedSlashes AllowOverride AllowOverrideList CGIMapExtension CGIPassAuth CGIVar ContentDigest DefaultRuntimeDir DefaultType Define <Directory> <DirectoryMatch> DocumentRoot <Else> <ElseIf> EnableMMAP EnableSendfile Error ErrorDocument ErrorLog ErrorLogFormat ExtendedStatus FileETag <Files> <FilesMatch> FlushMaxPipelined FlushMaxThreshold ForceType GprofDir HostnameLookups HttpProtocolOptions <If> <IfDefine> <IfDirective> <IfFile> <IfModule> <IfSection> Include IncludeOptional KeepAlive KeepAliveTimeout <Limit> <LimitExcept> LimitInternalRecursion LimitRequestBody LimitRequestFields LimitRequestFieldSize LimitRequestLine LimitXMLRequestBody <Location> <LocationMatch> LogLevel MaxKeepAliveRequests MaxRangeOverlaps MaxRangeReversals MaxRanges MergeSlashes MergeTrailers Mutex NameVirtualHost Options Protocol Protocols ProtocolsHonorOrder QualifyRedirectURL ReadBufferSize RegexDefaultOptions RegisterHttpMethod RLimitCPU RLimitMEM RLimitNPROC ScriptInterpreterSource SeeRequestTail ServerAdmin ServerAlias ServerName ServerPath ServerRoot ServerSignature ServerTokens SetHandler SetInputFilter SetOutputFilter StrictHostCheck TimeOut TraceEnable UNCList UnDefine UseCanonicalName UseCanonicalPhysicalPort <VirtualHost>| 説明: | プロトコルを Listen しているソケットの最適化を設定する |
|---|---|
| 構文: | AcceptFilter protocol accept_filter |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | 2.1.5 以降 |
Listen しているソケットに対して、OS が固有に持っているプロトコルについての最適化を
有効にするディレクティブです。大前提となる条件は、データが受信されるか
HTTP リクエスト全体がバッファされるかするまで、カーネルがサーバプロセスに
ソケットを送らないようになっている、ということです。現在サポートされているのは、
FreeBSD の Accept Filter と Linux のプリミティブな
TCP_DEFER_ACCEPT のみです。
FreeBSD のデフォルト値は :
AcceptFilter http httpready
AcceptFilter https dataready
httpready Accept Filter は HTTP リクエスト全体を、
カーネルレベルでバッファリングします。リクエスト全体を受信し終わると、
その後サーバプロセスにそれを送ります。詳細については accf_http(9)
を参照してください。HTTPS のリクエストは暗号化されているので accf_data(9)
フィルタのみが使用されます。
Linux でのデフォルト値は :
AcceptFilter http data
AcceptFilter https data
Linux の TCP_DEFER_ACCEPT は HTTP リクエストのバッファリングを
サポートしていません。none 以外の値で
TCP_DEFER_ACCEPT が有効になります。詳細については Linux
man ページ tcp(7)
を参照してください。
引数に none を指定すると、プロトコルに対する全ての Accept
Filter が無効になります。nntp といった、先にサーバにデータを
送る必要のあるプロトコルに有効です :
AcceptFilter nntp none
| 説明: | 後に続くパス名情報を受け付けるリソースの指定 |
|---|---|
| 構文: | AcceptPathInfo On|Off|Default |
| デフォルト: | AcceptPathInfo Default |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Apache 2.0.30 以降で使用可能 |
このディレクティブは実際のファイル名 (もしくは存在するディレクトリの
存在しないファイル) の後に続くパス名情報があるリクエストを受け付けるか
拒否するかを制御します。続きのパス名情報はスクリプトには PATH_INFO
環境変数として利用可能になります。
例えば、/test/ が、here.html というファイル
一つのみがあるディレクトリを指しているとします。そうすると、
/test/here.html/more と /test/nothere.html/more
へのリクエストは両方とも /more を PATH_INFO とします。
AcceptPathInfo ディレクティブに指定可能な
三つの引数は:
Off/test/here.html/more のように、本当のファイル名の
後にパス名情報が続くリクエストには 404 NOT FOUND エラーが返ります。On/test/here.html/more
は /test/here.html が有効なファイルにマップすれば
受け付けられます。DefaultPATH_INFO を拒否します。
cgi-script や isapi-handler のようにスクリプトを扱うハンドラは
一般的にデフォルトで PATH_INFO を受け付けます。AcceptPathInfo の主な目的はハンドラの PATH_INFO を
受け付けるか拒否するかの選択を上書きできるようにすることです。
例えば、これは例えば INCLUDES のような
フィルタを使って PATH_INFO に
基づいてコンテンツを生成しているときに必要になります。
コアハンドラでは通常拒否されるので、そういったスクリプトを動作させるには
次のような設定を使います。
<Files "mypaths.shtml">
Options +Includes
SetOutputFilter INCLUDES
AcceptPathInfo On
</Files>
| 説明: | 分散設定ファイルの名前 |
|---|---|
| 構文: | AccessFileName filename [filename] ... |
| デフォルト: | AccessFileName .htaccess |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
リクエストを処理するとき、サーバはディレクトリに 対して分散設定ファイルが有効になっていれば、 そのドキュメントへの パス上にある全てのディレクトリから、ここで指定された名前の一覧の中で 最初に見つかったファイルをそれぞれ設定ファイルとして読み込みます。例えば:
AccessFileName .acl
という設定があると、以下のようにして無効にされていない限り、
ドキュメント /usr/local/web/index.html
を返す前に、サーバは /.acl, /usr/.acl,
/usr/local/.acl, /usr/local/web/.acl から
ディレクティブを読み込みます。
<Directory />
AllowOverride None
</Directory>
| 説明: | レスポンスのコンテントタイプが text/plain あるいは
text/html の場合に追加するデフォルトの charset パラメータ |
|---|---|
| 構文: | AddDefaultCharset On|Off|charset |
| デフォルト: | AddDefaultCharset Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
レスポンスのコンテントタイプが text/plain
あるいは text/html
の場合に限りますが、レスポンスに追加するメディアタイプの文字セットパラメータ
(文字エンコーディングの名前) のデフォルト値を、このディレクティブで指定します。
これはレスポンス (訳注: レスポンスの HTML) 内で META
要素で指定された、どのような文字セットも無効にしますが、
最終的な挙動はユーザのクライアント側の設定で決まります。
この機能は AddDefaultCharset Off という設定で無効になります。
AddDefaultCharset On にすれば、
Apache 内部のデフォルト文字セット iso-8859-1 に設定されます。
その他 charset に指定できる値であれば、どんな値でも使えます。
指定する値は、MIME メディアタイプとして使われる
IANA
に登録されている文字セット名のうちの一つにすべきです。
例えば:
AddDefaultCharset utf-8
AddDefaultCharset を使うときは、全てのテキストリソースが
指定する文字エンコードになっていると分かっていて、かつ、
リソースの個々に文字セットを指定するのが大変な場合のみです。
例を挙げると、レガシーな CGI スクリプトなどの、動的に生成される
コンテンツを含むリソースに文字セットパラメータを追加する場合で、
ユーザの入力データが出力に入り、クロスサイトスクリプティングが
引き起こされうる場合です。デフォルト文字セットをセットしたとしても、
ブラウザの "文字エンコードの自動選択" 機能が有効になっているユーザを
守ることにはならないので、もちろんより良い解決策は単にスクリプトを修正
(あるいは削除) することです。
| 説明: | URL 中の符号化されたパス分離文字が先に伝えられるのを許可するかどうかを 決定する |
|---|---|
| 構文: | AllowEncodedSlashes On|Off |
| デフォルト: | AllowEncodedSlashes Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Apache 2.0.46 以降で使用可能 |
AllowEncodedSlashes ディレクティブは符号化された
パス分離文字 (/ は %2F、さらにシステムによっては
\ に対応する %5C) が存在する URL の使用を
許可するかどうかを決定します。通常はそのような URL は 404 (Not found) エラー
で拒否されます。
AllowEncodedSlashes On による
パス分離文字の使用は、PATH_INFO と合わせて
使うときに一番役に立ちます。
符号化されたスラッシュを許可することは、復号をすることを
意味しません。%2F や (関係するシステムでの)
%5C は、他の部分が復号された URL の中でもそのままの形式で
残されます。
| 説明: | .htaccess で許可されるディレクティブの種類 |
|---|---|
| 構文: | AllowOverride All|None|directive-type
[directive-type] ... |
| デフォルト: | AllowOverride All |
| コンテキスト: | ディレクトリ |
| ステータス: | Core |
| モジュール: | core |
サーバが (AccessFileName によって指定された)
.htaccess ファイルを見つけた時、そのファイルの中で
宣言されたどのディレクティブがより前に定義された設定ディレクティブを
上書きできるかを知る必要があります。
AllowOverride は正規表現無しの<Directory>
セクションでのみ有効で、<Location> や <DirectoryMatch>
や <Files> セクションでは無効です。
このディレクティブを None に設定すると、.htaccess ファイルは完全に
無視されます。
この場合、サーバはファイルシステムの .htaccess ファイルを読むことを
試みさえしません。
このディレクティブが All に設定されている時には、
.htaccess という コンテキスト を持つ
全てのディレクティブが利用できます。
directive-type には、以下のディレクティブ群の キーワードのどれかを指定します。
AuthDBMGroupFile,
AuthDBMUserFile,
AuthGroupFile,
AuthName,
AuthType, AuthUserFile, Require など)。DefaultType, ErrorDocument, ForceType, LanguagePriority,
SetHandler, SetInputFilter, SetOutputFilter,
mod_mime の Add* と Remove*
ディレクティブなど),
ドキュメントのメタデータ (Header, RequestHeader, SetEnvIf, SetEnvIfNoCase, BrowserMatch, CookieExpires, CookieDomain, CookieStyle, CookieTracking, CookieName),
mod_rewrite のディレクティブ RewriteEngine, RewriteOptions, RewriteBase, RewriteCond, RewriteRule) と
mod_actions の
Action
ディレクティブ。
AddDescription,
AddIcon, AddIconByEncoding,
AddIconByType,
DefaultIcon, DirectoryIndex, FancyIndexing, HeaderName, IndexIgnore, IndexOptions, ReadmeName
など)。Allow, Deny, Order).Options と
XBitHack)。
Options で設定するオプション
を、(空白を含めない) コンマ区切りのリストにして等号の後に続けることで
設定できます。例:
AllowOverride AuthConfig Indexes
上の例では AuthConfig と Indexes のどちらにも
属さないディレクティブはすべて内部サーバエラーを引き起こします。
| 説明: | Individual directives that are allowed in
.htaccess files |
|---|---|
| 構文: | AllowOverrideList None|directive
[directive-type] ... |
| デフォルト: | AllowOverrideList None |
| コンテキスト: | ディレクトリ |
| ステータス: | Core |
| モジュール: | core |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | CGI スクリプトのインタープリタの位置を調べるための手法 |
|---|---|
| 構文: | CGIMapExtension cgi-path .extension |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | NetWare のみ |
このディレクティブは Apache が CGI スクリプトを実行するための
インタープリタを探す方法を制御します。
例えば、CGIMapExtension sys:\foo.nlm .foo と設定すると
.foo という拡張子のすべての CGI スクリプトは FOO インタープリタに
渡されます。
| 説明: | Enables passing HTTP authorization headers to scripts as CGI variables |
|---|---|
| 構文: | CGIPassAuth On|Off |
| デフォルト: | CGIPassAuth Off |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in Apache HTTP Server 2.4.13 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Controls how some CGI variables are set |
|---|---|
| 構文: | CGIVar variable rule |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in Apache HTTP Server 2.4.21 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Content-MD5 HTTP 応答ヘッダの生成を有効にする |
|---|---|
| 構文: | ContentDigest On|Off |
| デフォルト: | ContentDigest Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Options |
| ステータス: | Core |
| モジュール: | core |
このディレクティブは、RFC1864 及び RFC2616 において定義されている
Content-MD5 ヘッダーの生成を有効にします。
MD5 は、任意長のデータの「メッセージダイジェスト」(「指紋」 と表現されることもある) を計算するアルゴリズムで、 データの変更があった場合には非常に高い信頼度でメッセージダイジェストに変更が 反映されます。
Content-MD5 ヘッダは、エンドツーエンドで
エンティティボディーに含まれるメッセージの完全性チェック
(Message Integrity Check - MIC)を提供します。
このヘッダを調べることで、プロキシやクライアントは、
途中経路におけるエンティティボディの予期せぬ変更などを
検出することができます。ヘッダの例:
Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
リクエスト毎にメッセージダイジェストを計算する (値はキャッシュされません) ことから、 サーバパフォーマンスが低下することについて注意してください。
Content-MD5は、core 機能により処理された
ドキュメントを送るときのみ有効であり、
SSI ドキュメントや CGI スクリプトの出力、バイトレンジを指定した
応答の場合にはこのヘッダは付与されません。
| 説明: | Base directory for the server run-time files |
|---|---|
| 構文: | DefaultRuntimeDir directory-path |
| デフォルト: | DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/) |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in Apache 2.4.2 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
ServerRoot| 説明: | サーバがコンテントタイプを決定できないときに 送られる MIME コンテントタイプ |
|---|---|
| 構文: | DefaultType MIME-type|none |
| デフォルト: | DefaultType text/plain |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | 引数 none は Apache 2.2.7 以降で利用可能 |
サーバは、MIME タイプ のマップからは決定できないドキュメントの送信を要求されることがあります。
サーバは、ドキュメントのコンテントタイプをクライアントに通知するべきです。
サーバで通常の方法ではこれが判定できない場合は、
DefaultType で指定されたタイプを利用します。
例:
DefaultType image/gif
これは .gif という拡張子がファイル名に含まれていない
多くの GIF 画像が含まれているディレクトリに適しているでしょう。
サーバでも管理者でも判定することができない (例えばプロクシの) 場合、 誤った情報を与えるよりは MIME タイプの指定がない状態が望ましいことも あります。この場合は次のようにします :
DefaultType None
DefaultType None は httpd-2.2.7
以降でのみ利用できます。
ForceType ディレクティブと
違って、このディレクティブはデフォルトの MIME タイプを提供するだけで
あることに注意してください。ファイル名の拡張子を含め、
メディアタイプを決定できる他の MIME タイプの定義があれば
このデフォルトは上書きされます。
| 説明: | 変数の存在を宣言する |
|---|---|
| 構文: | Define parameter-name |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
httpd の -D
引数と同じものです。
このディレクティブを使うと、スタートアップスクリプトに
記載されている -D 引数を書き換える必要なく、
<IfDefine>
セクションを切り替えることができます。
| 説明: | 指定のファイルシステムのディレクトリとサブディレクトリとのみに 適用されるディレクティブを囲む |
|---|---|
| 構文: | <Directory directory-path>
... </Directory> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
指定されたディレクトリとそのサブディレクトリにのみ
ディレクティブを適用させるためには、
<Directory> と
</Directory> を対として、ディレクティブ群を囲います。
その中には、ディレクトリコンテキストで許可された全てのディレクティブを
利用できます。
directive-path は、フルパスもしくは Unix のシェル形式の
ワイルドカードを指定します。
? は任意の 1 文字、* は任意の文字列にマッチします。
シェルにおける指定同様、文字の範囲を [] で指定できます。
ワイルドカードは `/' 文字にはマッチしませんので、
/home/user/public_html には
<Directory /*/public_html> はマッチしませんが、
<Directory /home/*/public_html> はマッチします。
例:
<Directory /usr/local/httpd/htdocs>
Options Indexes FollowSymLinks
</Directory>
directory-path 引数には注意してください: その引数は
Apache がファイルをアクセスするために使うファイルシステムのパスに
そのままマッチする必要があります。ある <Directory> に
適用されるディレクティブは、別のシンボリックリンクをたどったりして
同じディレクトリを違うパスでアクセスした場合には適用されません。
~ という文字を
付加することで正規表現を利用することもできます。
例えば:
<Directory ~ "^/www/.*/[0-9]{3}">
といった指定の場合、/www/ 以下にある数字
3 文字のディレクトリにマッチします。
もし複数の (正規表現以外の) <Directory>セクションが
ドキュメントを含むディレクトリ (やその上位ディレクトリのどれか) とマッチしたならば、
.htaccess ファイルのディレクティブも読み込みつつ、
短いパスから順に適用されます。
例えば、
<Directory />
AllowOverride None
</Directory>
<Directory /home/>
AllowOverride FileInfo
</Directory>
と設定し、ドキュメント /home/web/dir/doc.html への
アクセスがあった場合には以下のように動作します:
AllowOverride None が適用される。
(.htaccess ファイルは無効になる)AllowOverride FileInfo が適用される
(/home ディレクトリに対して)。/home/.htaccess, /home/web/.htaccess,
/home/web/dir/.htaccess の順にそれらのファイル中の
FileInfo ディレクティブが適用される。正規表現は、通常のセクションがすべて適用されるまで 考慮されません。 その後、全ての正規表現が設定ファイルに現れた順で試されます。 例えば、以下のような場合に
<Directory ~ abc$>
# ... directives here ...
</Directory>
正規表現のセクションはすべての通常の <Directory> と
.htaccess の適用が終わるまで考慮されません。
その後で、正規表現は /home/abc/public_html/abc にマッチし、
対応する <Directory> が適用されます。
Apache のデフォルトでは <Directory /> へのアクセスは
Allow from All になっていることに注意してください。
これは、URL からマップされたどのファイルでも Apache は送るということです。
これは以下のようにして変更することが推奨されています。
<Directory />
Order Deny,Allow
Deny from All
</Directory>
そしてアクセスを可能にしたいディレクトリに対して 個別に設定すればよいでしょう。 このあたりについては、セキュリティに関するコツを 参照してください。
ディレクトリセクションは httpd.conf ファイルに書きます。
<Directory>
ディレクティブは入れ子にすることができず、
<Limit> や <LimitExcept> セクションの中にも
記述できません。
| 説明: | 正規表現にマッチするファイルシステムのディレクトリと サブディレクトリとのみに適用されるディレクティブを囲む |
|---|---|
| 構文: | <DirectoryMatch regex>
... </DirectoryMatch> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
<Directory>
ディレクティブと同様に、<DirectoryMatch>
と </DirectoryMatch> は指定されたディレクトリと
そのサブディレクトリにのみ適用されるディレクティブ群を囲います。
しかし、このディレクティブは引数として正規表現をとります。例えば:
<DirectoryMatch "^/www/(.+/)?[0-9]{3}">
は /www/ 以下にある数字 3 文字のディレクトリにマッチします。
<Directory> と正規表現の指定が
適用される順番については <Directory>| 説明: | ウェブから見えるメインのドキュメントツリーになる ディレクトリ |
|---|---|
| 構文: | DocumentRoot directory-path |
| デフォルト: | DocumentRoot /usr/local/apache/htdocs |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
このディレクティブは、httpd
がファイルを提供するディレクトリを設定します。
Alias のようなディレクティブにマッチしない場合には、
ドキュメントの (訳注:ファイルシステム上の) パスを生成するために、
リクエストされた URL のパス部分をドキュメントルートに付与します。
例:
DocumentRoot /usr/web
この場合、
http://www.my.host.com/index.html へのアクセスがあれば
/usr/web/index.html が返されます。
directory-path が絶対パスでない場合は、
ServerRoot
からの相対パスとみなされます。
DocumentRoot は最後のスラッシュ無しで
指定する必要があります。
| 説明: | Contains directives that apply only if the condition of a
previous <If> or
<ElseIf> section is not
satisfied by a request at runtime |
|---|---|
| 構文: | <Else> ... </Else> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Nested conditions are evaluated in 2.4.26 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
<If><ElseIf><If>,
<ElseIf>, and
<Else> are applied last.| 説明: | Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
<If> or
<ElseIf> section is not
satisfied |
|---|---|
| 構文: | <ElseIf expression> ... </ElseIf> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Nested conditions are evaluated in 2.4.26 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
<If><Else><If>,
<ElseIf>, and
<Else> are applied last.| 説明: | 配送中にファイルを読み込むためにメモリマッピングを 使うかどうか |
|---|---|
| 構文: | EnableMMAP On|Off |
| デフォルト: | EnableMMAP On |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
このディレクティブは配送中にファイルの内容を読み込む必要があるときに
httpd がメモリマッピングを使うかどうかを制御します。
デフォルトでは、
例えば、mod_include を使って SSI ファイルを配送
するときのように、ファイルの途中のデータをアクセスする必要があるときには
Apache は OS がサポートしていればファイルをメモリにマップします。
このメモリマップは性能の向上をもたらすことがあります。 しかし、環境によっては運用上の問題を防ぐためにメモリマッピングを 使用しないようにした方が良い場合もあります:
httpd の性能が落ちるものがあります。DocumentRoot
では、httpd がメモリマップしている間にファイルが削除されたり
短くなったりしたときに起こるセグメンテーションフォールトのために
httpd がクラッシュする可能性があります。これらの問題に当てはまるサーバの設定の場合は、以下のようにして ファイルの配送時のメモリマッピングを使用不可にしてください:
EnableMMAP Off
NFS マウントされたファイルには、問題のあるファイルにのみ明示的に この機能を使用不可にします:
<Directory "/path-to-nfs-files">
EnableMMAP Off
</Directory>
| 説明: | ファイルのクライアントへの配送時にカーネルの sendfile サポートを 使うかどうか |
|---|---|
| 構文: | EnableSendfile On|Off |
| デフォルト: | EnableSendfile On |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | バージョン 2.0.44 以降で使用可能 |
このディレクティブはクライアントにファイルの内容を送るときに
httpd がカーネルの
sendfile サポートを使うかどうかを制御します。デフォルトでは、
例えば静的なファイルの配送のように、リクエストの処理にファイルの
途中のデータのアクセスを必要としないときには、Apache は OS が
サポートしていればファイルを読み込むことなく sendfile を使って
ファイルの内容を送ります。
sendfile は read と send を別々に行なうことと、バッファの割り当てを 回避します。しかし、プラットフォームやファイルシステムの中には 運用上の問題を避けるためにこの機能を使用不可にした方が良い場合があります:
DocumentRoot
(例えば NFS や SMB)
では、カーネルは自身のキャッシュを使ってネットワークからのファイルを
送ることができないことがあります。これらの問題に当てはまるサーバの設定の場合は、以下のようにして この機能を使用不可にしてください:
EnableSendfile Off
NFS や SMB マウントされたファイルには、問題のあるファイルにのみ明示的に この機能を使用不可にします:
<Directory "/path-to-nfs-files">
EnableSendfile Off
</Directory>
| 説明: | Abort configuration parsing with a custom error message |
|---|---|
| 構文: | Error message |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | 2.3.9 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | エラーが発生したときにサーバがクライアントに送るもの |
|---|---|
| 構文: | ErrorDocument error-code document |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
問題やエラーが発生したときの動作として、 Apache には以下の四つのうち一つの動作を設定することができます。
最初のものがデフォルトの動作で、2 番目から 4 番目は、
ErrorDocumentディレクティブにより、
HTTP のレスポンスコードと、メッセージか URL を指定することで設定します。
Apache が問題もしくはエラーに関する追加情報を提供することがあります。
URL の場合は、スラッシュで始まる (/) ローカルの web-path (
DocumentRoot からの相対パス
) か、クライアントが解決できる完全な URL を指定します。
もしくは、ブラウザに表示されるメッセージを指定できます。
例:
ErrorDocument 500 http://foo.example.com/cgi-bin/tester
ErrorDocument 404 /cgi-bin/bad_urls.pl
ErrorDocument 401 /subscription_info.html
ErrorDocument 403 "Sorry can't allow you access today"
加えて、特別な値 default を使って Apache に
ハードコードされている簡単なメッセージを指定することができます。
通常は必要ではありませんが、default を使うと
既存の ErrorDocument ディレクティブの設定を
継承するところで、Apache のハードコードされた簡単なメッセージに
戻すことができます。
ErrorDocument 404 /cgi-bin/bad_urls.pl
<Directory /web/docs>
ErrorDocument 404 default
</Directory>
リモート URL (例えば、頭に http と付与した方法) を
ErrorDocument に指定するとき、
たとえ文書が同じサーバにあろうとも、ドキュメントがどこにあるかを通知するために、
Apache はリダイレクトをクライアントに送出するということに、注意してください。
これにはいろいろと関連して起こる問題があります。
中でも最も重要なのは、クライアントは元々のエラーステータスコードを受け取らず、
代わりにリダイレクトのステータスコードを受け取るということです。
これにより、ステータスコードを使って URL が有効であるかどうかを決定しようとする
ウェブロボットやその他クライアントを、混乱させるかもしれません。
さらに、ErrorDocument 401 にリモートの URL を指定すると、
クライアントは 401 というステータスコードを受け取らないため、
パスワードをユーザーに入力要求しなければならないことがわかりません。
従って、ErrorDocument 401 というディレクティブを使う場合は、
必ずローカルな文書を参照しなければなりません。
Microsoft Internet Explorer (MSIE) はデフォルトではサーバが生成したエラーメッセージが 「小さすぎる」ときには無視をして自分自身の「やさしい」エラーメッセージで 置換します。サイズのしきい値はエラーの種類によって異なりますが、 一般的にはエラーの文書を 512 バイトよりも大きくすると、MSIE は サーバが生成したエラーを隠さずに表示します。詳しい情報は Microsoft Knowledge Base の記事 Q294807 にあります。
ほとんどのエラーメッセージを上書きすることができますが、特定の状況下では
ErrorDocument の設定にかかわらず
内蔵のメッセージが使われます。
特に、不正な形式のリクエストが検出された場合、通常のリクエスト処理は
即座に中止され、内蔵のエラーメッセージが返されます。
この処置は不正なリクエストによって引き起こされる、セキュリティ問題から
守るために必要な措置です。
2.0 より前のバージョンでは、対になっていない二重引用符を 先頭に付けることによりメッセージであることを指定していました。
| 説明: | サーバがエラーをログ収集する場所 |
|---|---|
| 構文: | ErrorLog file-path|syslog[:facility] |
| デフォルト: | ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2) |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
ErrorLog ディレクティブは、
サーバに生じたさまざまなエラーを
記録する為のファイルの名前を設定します。
file-path が絶対パスでないときは、ServerRoot からの相対パスとみなされます。
ErrorLog /var/log/httpd/error_log
file-path がパイプ (|) から始まる場合は、 エラーログを処理するために実行されるコマンドが 指定されていると解釈されます。
ErrorLog "|/usr/local/bin/httpd_errors"
ファイル名の変わりに syslog と指定することによって、
システムがサポートしていれば syslogd(8) を利用したロギングが有効になります。
デフォルトでは、local7 ファシリティとなりますが、
syslog:facility といった形で記述することにより、
通常 syslog(1) のドキュメントで説明されているファシリティの一つを使うように
することができます。
ErrorLog syslog:user
セキュリティ: ログファイルを格納するディレクトリが、サーバを起動したユーザ以外の ユーザによって書き込める場合にセキュリティが破られる可能性があることに 関する詳細は セキュリティに関するコツ を 参照してください。
Unix 以外のプラットフォームでファイルのパスを入力するときは、 プラットフォームがバックスラッシュの使用を許していたとしても、 確実にスラッシュのみが使用されるように注意してください。一般的には、 設定ファイル全般でスラッシュのみを使う方が良いでしょう。
| 説明: | Format specification for error log entries |
|---|---|
| 構文: | ErrorLogFormat [connection|request] format |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Keep track of extended status information for each request |
|---|---|
| 構文: | ExtendedStatus On|Off |
| デフォルト: | ExtendedStatus Off[*] |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | ETag HTTP 応答ヘッダを作成するために使用される ファイルの属性 |
|---|---|
| 構文: | FileETag component ... |
| デフォルト: | FileETag INode MTime Size |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
FileETag ディレクティブは
ドキュメントがファイルに基づいたものであるときに、
ETag (エンティティタグ) 応答ヘッダフィールドを作成するときに使用する
ファイルの属性を設定します。 (ETag の値はネットワークの帯域を節約するための
キャッシュの管理で使われます。) Apache 1.3.22 以前では、ETag の値は
常にファイルの inode, サイズ、最終修正時刻 (mtime) から作成
されていました。FileETag ディレクティブにより、これらのどれを使うかを
選ぶことができます。認識されるキーワードは:
FileETag INode MTime Size
ETag フィールドを
応答に付加しませんINode, MTime, Size キーワードには
+ や - を前に付けて
指定することもできます。この場合は、より広い範囲から継承された
デフォルトの設定に変更を加えるようになります。そのような接頭辞の
無いキーワードを指定すると、即座に継承した設定を無効にします。
あるディレクトリの設定に
FileETag INode MTime Size があり、
サブディレクトリの設定に FileETag -INode があるときは、
そのサブディレクトリの設定は (設定が上書きされなければサブディレクトリの
サブディレクトリにも継承されます) FileETag MTime Size
と同じになります。
mod_dav_fs をストレージプロバイダとして
使っているような Directory や Location では、デフォルト値を変更しないでください。
mod_dav_fs では、条件付リクエストでの比較演算に
INode MTime Size
の固定フォーマットを使っています。
FileETag で ETag フォーマットを
変更してしまうと、条件付リクエストでうまく動作しなくなります。
| 説明: | マッチするファイル名に適用されるディレクティブを囲む |
|---|---|
| 構文: | <Files filename> ... </Files> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
<Files> ディレクティブは、
その中にあるディレクティブの適用範囲をファイル名で制限します。
<Directory> ディレクティブや <Location> ディレクティブと
同じような機能を持ちます。
これは、</Files> ディレクティブと対に
なっていなければなりません。
このセクション中のディレクティブは、ベース名 (ファイル名の最後の部分)
が指定されたファイル名にマッチするすべてのオブジェクトに適用されます。
<Files> セクションは
<Directory> セクションと
.htaccess が読み込まれた後、
<Location> セクションよりは先に
設定ファイルに現れた順に適用されます。
<Files> は、
<Directory> セクション内に
ネストさせることができ、
ファイルシステムの一部にのみ限定して適用させることができます。
filename 引数は、ファイル名かワイルドカード文字列
で、ワイルドカードでは ? は一つの文字、* は任意の文字列にマッチします。
~ という文字を付加することで正規表現を使うこともできます。
例えば、
<Files ~ "\.(gif|jpe?g|png)$">
とすることにより、一般的なインターネットの画像フォーマットにマッチします。
ただし、
<FilesMatch> を使う方が
推奨されています。
ちなみに、<Directory> と <Location> セクションとは異なり、
<Files>
は .htaccess ファイル内で利用することができます。
これにより、ユーザがファイル毎にアクセスの制御を行なうことができるように
なっています。
| 説明: | 正規表現にマッチするファイル名に適用される ディレクティブを囲む |
|---|---|
| 構文: | <FilesMatch regex> ... </FilesMatch> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
<FilesMatch> ディレクティブは、
<Files>
ディレクティブ同様にその中にあるディレクティブの適用範囲をファイル名で制限します。ただし、
このディレクティブには正規表現を指定します。
例えば:
<FilesMatch "\.(gif|jpe?g|png)$">
は一般的なインターネットの画像形式にマッチします。
| 説明: | Maximum number of pipelined responses above which they are flushed to the network |
|---|---|
| 構文: | FlushMaxPipelined number |
| デフォルト: | FlushMaxPipelined 5 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | 2.4.47 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Threshold above which pending data are flushed to the network |
|---|---|
| 構文: | FlushMaxThreshold number-of-bytes |
| デフォルト: | FlushMaxThreshold 65535 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | 2.4.47 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | すべてのマッチするファイルが指定の MIME コンテントタイプで 送られるようにする |
|---|---|
| 構文: | ForceType MIME-type|None |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Apache 2.0 で core に移動 |
.htaccess や <Directory> セクション、
<Location> セクション、
<Files> セクションに
書かれた場合、このディレクティブはそこにあるすべてのファイルが
MIME-type
で指定されたコンテントタイプとして扱われるようにします。たとえば、
GIF ファイルばかりのディレクトリがあって、すべてのファイルを .gif
で終わらせたくはないときに、以下のものを使用します:
ForceType image/gif
DefaultType と違って
このディレクティブはメディアタイプを決めることができるかもしれない
ファイルの拡張子も含め、すべての MIME タイプの関連付けを
上書きすることに注意してください。
None という値を使うことで ForceType の
設定を無効にできます:
# force all files to be image/gif:
<Location /images>
ForceType image/gif
</Location>
# but normal mime-type associations here:
<Location /images/mixed>
ForceType None
</Location>
| 説明: | Directory to write gmon.out profiling data to. |
|---|---|
| 構文: | GprofDir /tmp/gprof/|/tmp/gprof/% |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | クライアントの IP アドレスの DNS ルックアップを 有効にする |
|---|---|
| 構文: | HostnameLookups On|Off|Double |
| デフォルト: | HostnameLookups Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Core |
| モジュール: | core |
このディレクティブは、ホスト名をログ収集できるように
DNS ルックアップを有効にします
(さらに、CGI/SSI に REMOTE_HOST 変数として渡します)。
Doubleを指定した場合、2 重の逆引きを行ないます。
つまり、逆引きの後に、その結果に対して正引きを行ないます。正引きの
結果の IP アドレスの中にオリジナルのアドレスと一致するものがなければ
なりません。("tcpwrappers" の用語では PARANOID と呼ばれています。)
mod_authz_host でホスト名によるアクセス
制御を行なう場合には、
設定の如何によらず 2 重の逆引きが実行されます。
これは、セキュリティを保つために必要です。
HostnameLookups Double を設定しない限り、
他の部分はこの 2 重逆引きの結果を使うことはできません。
例えば、HostnameLookups On と設定してある状態で、
ホスト名によるアクセス制限を行なったオブジェクトへの
リクエストを受けたとすると、2 重の逆引きが成功するか否かによらず、
REMOTE_HOST には通常の逆引き結果が渡されます。
ディレクティブのデフォルトは
本当に逆引きを必要としているわけではないサイトの
ネットワークトラフィックを低減させるために、Off になっています。
ルックアップによる余計な遅延がなくなるため、
エンドユーザにとっても良いでしょう。
DNS のルックアップには、かなりの時間が必要となる場合が多く、
負荷の高いサイトではこのディレクティブは Off にすべきです。
なお、/support ディレクトリに含まれ、デフォルトでは
インストールディレクトリの bin サブディレクトリに
インストールされる logresolve ユーティリティにより、
Apache の動作とは別に、ログに残されている IP アドレスからホスト名を
ルックアップすることが可能です。
| 説明: | Modify restrictions on HTTP Request Messages |
|---|---|
| 構文: | HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods]
[Allow0.9|Require1.0] |
| デフォルト: | HttpProtocolOptions Strict LenientMethods Allow0.9 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | 2.2.32 or 2.4.24 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | 実行時、リクエストが条件を満たした場合にのみ適用される ディレクティブを包含する |
|---|---|
| 構文: | <If expression> ... </If> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
<If> ディレクティブは
実行時に式を評価し、条件式が真になるときにのみ
内包するディレクティブを適用します。
例えば
<If "$req{Host} = ''">
上記例は Host: ヘッダの存在しない HTTP/1.0 のリクエストに マッチします。
<If> は
<Files>
と同じ処理順と用法になっています。| 説明: | 起動時にテストが真であるときのみに処理されるディレクティブを 囲む |
|---|---|
| 構文: | <IfDefine [!]parameter-name> ...
</IfDefine> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
<IfDefine test>...</IfDefine>
セクションは、
ディレクティブを条件付きで指定するために利用します。
<IfDefine> セクションに
含まれるディレクティブは、testが
定義されているときのみ処理されます。
もし test が定義されていなければ、
開始と終了の指定の間のディレクティブは無視されます。
<IfDefine> セクションディレクティブに
指定する test は、
次の二つの形式のうちの一つをとります:
!parameter-name前者の場合には、parameter-name と名付けられたパラメータが 定義されていれば開始と終了の間のディレクティブが処理されます。 後者の場合は逆で、parameter-name が指定されていない 場合に処理されます。
parameter-name 引数は、サーバを起動する際に
httpd のコマンドラインに
-Dparameter という形で指定するか
あるいは Define
ディレクティブで指定されると定義されます。
<IfDefine> セクションは
入れ子にすることができ、複数のパラメータによるテストをするために使用できます。
例:
httpd -DReverseProxy -DUseCache -DMemCache ...
# httpd.conf
<IfDefine ReverseProxy>
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
<IfDefine UseCache>
LoadModule cache_module modules/mod_cache.so
<IfDefine MemCache>
LoadModule mem_cache_module modules/mod_mem_cache.so
</IfDefine>
<IfDefine !MemCache>
LoadModule cache_disk_module modules/mod_cache_disk.so
</IfDefine>
</IfDefine>
</IfDefine>
| 説明: | Encloses directives that are processed conditional on the presence or absence of a specific directive |
|---|---|
| 構文: | <IfDirective [!]directive-name> ...
</IfDirective> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in 2.4.34 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Encloses directives that will be processed only if file exists at startup |
|---|---|
| 構文: | <IfFile [!]filename> ...
</IfFile> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in 2.4.34 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | モジュールの存在するかしないかに応じて処理される ディレクティブを囲む |
|---|---|
| 構文: | <IfModule [!]module-file|module-identifier> ...
</IfModule> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | モジュール識別子はバージョン 2.1 以降で使用可能。 |
<IfModule test>...</IfModule>
セクションは、モジュールが存在するときに処理されるディレクティブを
指定するために利用します。
<IfModule> セクションに
含まれるディレクティブは、test
で指定するモジュールが組み込まれているときのみ処理されます。
もし test が組み込まれていなければ、開始と終了の間のディレクティブ
は無視されます。
<IfModule> セクションディレクティブに
指定する test は、
次の二つの形式のうちの一つをとります。
前者の場合は、module と名付けられたモジュールが
Apache に組み込まれていれば
(コンパイル済みのものと、LoadModule を利用して
動的に読み込んだものの両方)、
開始と終了の間のディレクティブが処理されます。
後者の場合は逆で、module が組み込まれていない
場合に処理されます。
module 引数は、モジュール識別子か
コンパイルをした時のモジュールのファイル名です。
例えば、rewrite_module は識別子で
mod_rewrite.c はファイル名です。
モジュールが複数のソースファイルから構成されている場合は、文字列
STANDARD20_MODULE_STUFF があるファイルの名前を
使ってください。
<IfModule> セクションは
入れ子にすることが可能であり、
複数のモジュールのテストを行なうために使用できます。
<IfModule> セクションの中に
入れる必要はありません。| 説明: | Encloses directives that are processed conditional on the presence or absence of a specific section directive |
|---|---|
| 構文: | <IfSection [!]section-name> ...
</IfSection> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in 2.4.34 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | サーバ設定ファイル中から他の設定ファイルを取り込む |
|---|---|
| 構文: | Include file-path|directory-path |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | ワイルドカードによるマッチは 2.0.41 以降で使用可能 |
このディレクティブにより、サーバの設定ファイルから 他の設定ファイルをインクルードすることができます。
複数のファイルをアルファベット順に一度に読み込むために、
シェル形式 (fnmatch) のワイルドカード文字を使うことができます。
さらに、Include にディレクトリを指定した場合は、
ディレクトリとそのサブディレクトリ内の全てのファイルを
アルファベット順に読み込んで、設定ファイルとして処理します。
しかし、ディレクトリ全体を読み込むのはお勧めできません。
ふとしたことから httpd が読み込みに失敗するような
一時ファイルをディレクトリに残してしまうようなことがよくあるからです。
指定するファイルパスは絶対パスか、
ServerRoot ディレクトリからの
相対パスか、のどちらかです。
例:
Include /usr/local/apache2/conf/ssl.conf
Include /usr/local/apache2/conf/vhosts/*.conf
ServerRoot からの相対パスの場合は:
Include conf/ssl.conf
Include conf/vhosts/*.conf
| 説明: | Includes other configuration files from within the server configuration files |
|---|---|
| 構文: | IncludeOptional file-path|directory-path|wildcard |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in 2.3.6 and later. Not existent file paths without wildcards do not cause SyntaxError after 2.4.30 |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | HTTP の持続的な接続を有効にする |
|---|---|
| 構文: | KeepAlive On|Off |
| デフォルト: | KeepAlive On |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
HTTP/1.0 の Keep-Alive 拡張と HTTP/1.1 の持続的接続の機能は、
複数のリクエストが同じ TCP の接続で送られる、長時間持続する
HTTP セッションを提供します。たくさんの画像が
含まれる HTML ドキュメントでは場合によっては遅延時間が 50% 短縮される結果も
でています。Keep-Alive 接続を有効にするには
KeepAlive On と設定します。
HTTP/1.0 に対応したクライアントの際には、 クライアントより特に要求があった場合のみ Keep-Alive 接続となります。 さらに、HTTP/1.0 クライアントでは、コンテンツの容量が先に (訳注: 要求に対して応答を返す前に) わかる場合のみ Keep-Alive 接続を利用できます。 これは、CGI の出力や SSI のページ、 サーバが生成したディレクトリのリストのような動的コンテンツを HTTP/1.0 クライアントに送る場合には Keep-Alive 接続を使えないことを意味します。 HTTP/1.1 に対応したクライアントの際には、 特に指定されない限りはデフォルトとして持続的な接続が行なわれます。 クライアントが要求すれば、コンテンツの容量を判別できないものを 持続的な接続を通して送るために、チャンクエンコーディングが用いられます。
クライアントが Keep-Alive コネクションを使用している場合、 そのコネクションを通してどれだけたくさんのリクエストが処理されても、 それは「リクエスト」1 つとして、MaxRequestsPerChild ディレクティブでは 数えられます。
| 説明: | 持続的な接続で次のリクエストが来るまでサーバが待つ時間 |
|---|---|
| 構文: | KeepAliveTimeout seconds |
| デフォルト: | KeepAliveTimeout 5 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
接続を閉じる前に、Apache が次のリクエストを何秒待つかを指定します。
リクエストを受け付けた後は、Timeout ディレクティブによって
指定されたタイムアウト値が使われます。
KeepAliveTimeout を大きな値に設定すると、
負荷の高いサーバにおいてはパフォーマンスの問題を引き起こす場合があります。
タイムアウトが長ければ長いほど、より多くのサーバプロセスが
活性でないクライアントからの接続の終了を待ち続けることになります。
名前ベースのバーチャルホストコンテキストでは、
NameVirtualHost
のセットの中で最初に定義されたバーチャルホストの値
(デフォルトホスト) が使われます。
その他の値は無視されます。
| 説明: | 囲いの中にあるアクセス制御の適用を特定の HTTP メソッドのみに 制限する |
|---|---|
| 構文: | <Limit method [method] ... > ...
</Limit> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
アクセス制御は、通常全てのアクセスメソッドに対して
影響し、普通はこれが望ましい挙動です。
そうしたことから、大部分の場合にはアクセス制御に関わるディレクティブを
<Limit> セクション内に
書くべきではありません。
<Limit> ディレクティブの
目的は、アクセス制御の範囲を
指定された HTTP メソッドに限定するためです。
それ以外のメソッドは、<Limit> で囲われたアクセス制御の
影響を受けません。
以下の例は、POST, PUT, DELETE のメソッドに対してのみアクセスの制御を行ない、
それ以外のメソッドについては制限しません:
<Limit POST PUT DELETE>
Require valid-user
</Limit>
メソッド名には以下の中から一つ以上を列挙することができます:
GET,
POST, PUT, DELETE,
CONNECT, OPTIONS,
PATCH, PROPFIND, PROPPATCH,
MKCOL, COPY, MOVE,
LOCK, UNLOCK. メソッド名は
大文字小文字を区別します。 GET を指定した場合には
HEAD リクエストにも制限がかかります。TRACE
メソッドに制限をかけることはできません
(<TraceEnable> 参照)。
<Limit>
セクションの代わりに <LimitExcept> セクションを使用した方が良いでしょう。
<LimitExcept>
セクションでは不特定のメソッドに対しても防御できるからです。| 説明: | 指定されたもの以外の HTTP メソッドにアクセス制御を 制限する |
|---|---|
| 構文: | <LimitExcept method [method] ... > ...
</LimitExcept> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
<LimitExcept> と
</LimitExcept> は、引数に
含まれていない
HTTP のアクセスメソッドに適用するためのアクセス制御
ディレクティブを括るために利用します。
つまり、<Limit> セクションの反対の動作をし、
標準のメソッドと標準外や未認識のメソッドの場合の両方を設定できます。
<Limit> のドキュメントも
併せて参照してください。
例:
<LimitExcept POST GET>
Require valid-user
</LimitExcept>
| 説明: | 内部リダイレクトと入れ子になったサブリクエストの最大数を決定する |
|---|---|
| 構文: | LimitInternalRecursion number [number] |
| デフォルト: | LimitInternalRecursion 10 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Apache 2.0.47 以降で使用可能 |
内部リダイレクトは例えば Action ディレクティブを
使っているときに起こります。Action ディレクティブは
元々のリクエストを CGI スクリプトに内部リダイレクトを行ないます。
サブリクエストはいくつかの URI に対して、リクエストされたときに
何が起こるかを調べるための Apache の機構です。例えば、mod_dir
は DirectoryIndex ディレクティブ
がリストするファイルを調べるためにサブリクエストを使います。
LimitInternalRecursion は内部リダイレクトや
サブリクエストが無限ループに陥ったときのサーバクラッシュを防ぎます。
普通、そのようなループは設定に失敗したときに発生します。
このディレクティブは、リクエスト毎に評価される、二つの違う限界値を 設定します。最初の number は、起こり得る 内部リクエストの最大値を設定します。二つめの number は サブリクエストが入れ子にできる深さを設定します。number を 一つだけ指定したときは、両方の限界値にその値が設定されます。
LimitInternalRecursion 5
| 説明: | クライアントから送られる HTTP リクエストのボディの 総量を制限する |
|---|---|
| 構文: | LimitRequestBody bytes |
| デフォルト: | LimitRequestBody 0 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
このディレクティブは、リクエストボディに許されるバイト数、bytes を 0 (無制限を意味します) から 2147483647 (2GB) までの数値で指定します。
LimitRequestBody ディレクティブは、
ディレクティブが書かれたコンテキスト
(サーバ全体、ディレクトリ、ファイル、ロケーション) 内で
許容する HTTP リクエストメッセージボディのサイズに制限をかけることができます。
クライアントのリクエストがその制限値を越えていれば、
サーバはリクエストを処理せずにエラーを返します。
普通のリクエストメッセージボディのサイズは、リソースの種類や
許可されているメソッドによって大きく変わります。
CGI スクリプトは、よく情報を受信するために
メッセージボディを使います。
PUT メソッドの実装は、このディレクティブの値として
少なくともあるリソースに対してサーバが受け付けようとする
表現の大きさほどの値を必要とします。
このディレクティブは、 管理者にクライアントからの異常なリクエストを制御できるようにし、 何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。
ある場所へのファイルアップロードを許可する場合に、 アップロードできるファイルのサイズを 100K に制限したければ、 以下のように指定します:
LimitRequestBody 102400
| 説明: | クライアントからの HTTP リクエストのヘッダフィールドの数を 制限する |
|---|---|
| 構文: | LimitRequestFields number |
| デフォルト: | LimitRequestFields 100 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
number には、0 (無制限を意味します) から 32767
までの整数を指定します。
デフォルト値は、定数 DEFAULT_LIMIT_REQUEST_FIELDS
によりコンパイル時に定義されます (配布時には 100 と指定されています)。
LimitRequestBody ディレクティブは、
サーバ管理者が HTTP リクエスト中において許可するリクエストヘッダフィールド数を
指定します。
サーバはこの値には通常のクライアントからのリクエストに含まれるであろう
フィールドの数より大きな値が必要とします。
クライアントにより使われた要求ヘッダーフィールドの数が
20 を超えることはほとんどありませんが、
これは種々のクライアントの実装によって変わり、
詳細なコンテントネゴシエーションをするためのブラウザの設定までにも
影響されることがあります。
オプションの HTTP 拡張はリクエストヘッダフィールドを使って表される場合が
多くあります。
このディレクティブは、 管理者にクライアントからの異常なリクエストを制御できるようにし、 何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。 リクエストのフィールドが多過ぎることを意味するエラー応答が 普通のクライアントに返されるような時はこの値を増やしてください。
例:
LimitRequestFields 50
| 説明: | クライアントからの HTTP リクエストのヘッダの サイズを制限する |
|---|---|
| 構文: | LimitRequestFieldSize bytes |
| デフォルト: | LimitRequestFieldSize 8190 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
このディレクティブは、HTTP リクエストヘッダ一つで受付ける バイト数 bytes を指定します。
LimitRequestFieldSize ディレクティブは、
HTTP リクエストヘッダで許容されるサイズを増減させることができます。
サーバは、このディレクティブの値として、
一般的なクライアントからリクエストが送られた際に、そのリクエストに
付属しているどのヘッダフィールドについても、
十分足りる大きさになっていなければなりません。
一般的なリクエストヘッダのサイズといっても、その大きさは個々の
クライアントの実装によって大きく異なり、
詳細なコンテントネゴシエーションをサポートするかどうかの、
ブラウザの設定にも影響されたりします。
SPNEGO 認証ヘッダでは 12392 バイトにまで及ぶことすらあります。
このディレクティブは、 管理者にクライアントからの異常なリクエストを制御できるようにし、 何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。
例:
LimitRequestFieldSize 4094
| 説明: | クライアントからの HTTP リクエスト行のサイズを制限する |
|---|---|
| 構文: | LimitRequestLine bytes |
| デフォルト: | LimitRequestLine 8190 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
このディレクティブは、HTTP リクエスト行内で許容されるバイト数 bytes を指定します。
LimitRequestLine ディレクティブにより、
クライアントからの HTTP リクエスト行の許容サイズを増減できます。
リクエスト行は、HTTPメソッド、URI、プロトコルバージョンから成っており、
LimitRequestLine はサーバへのリクエストに対して
許容するリクエスト URI の長さを制限することになります。
サーバは、GET リクエストのクエリ部分も含めて、リソースの名前が入るに足る
大きさを必要とします。
このディレクティブは、 管理者にクライアントからの異常なリクエストを制御できるようにし、 何らかの形のサービス拒否攻撃 (訳注:DoS) を避けるのに有効です。
例:
LimitRequestLine 4094
| 説明: | XML 形式のリクエストのボディのサイズを制限する |
|---|---|
| 構文: | LimitXMLRequestBody bytes |
| デフォルト: | LimitXMLRequestBody 1000000 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
XML 形式のリクエストのボディの最大値を (バイト単位で) 制限します。
値に 0 を指定するとチェックを無効にします。
例:
LimitXMLRequestBody 0
| 説明: | 囲んだディレクティブをマッチする URL のみに適用 |
|---|---|
| 構文: | <Location
URL-path|URL> ... </Location> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
<Location> ディレクティブは、
URL により中に書かれたディレクティブの適用範囲を制限します。
<Directory>
ディレクティブと似ていて、
</Location> ディレクティブで終了する
サブセクションを開始します。
<Location> セクションは、
<Directory> セクションと
.htaccess の読み込みの後、
<Files> セクションを
適用した後に、設定ファイルに現れた順に処理されます。
<Location> セクションは
完全にファイルシステムと関連せずに動作します。このことから導かれる
結果にはいくつか注意する点があります。最も重要なものは、
ファイルシステムの位置へのアクセス制御に <Location> ディレクティブを使うべきではない
ということです。複数の URL がファイルシステムの同じ位置にマップされる
可能がありますので、そのようなアクセス制御は回避されてしまう可能性が
あります。
<Location> を使うか<Location> ディレクティブは
ファイルシステム外のコンテンツにディレクティブを適用するときに
使用してください。ファイルシステムに存在するコンテンツに対しては、
<Directory> と <Files> を使ってください。
例外は、<Location /> で、これはサーバ全体に対して
設定を適用する簡単な方法です。
全ての (プロキシ以外の) リクエストに対し、
URL は /path/ という、
接頭辞 http://servername を含まない形でマッチします。
プロキシリクエストの場合には、scheme://servername/path
という接頭辞を含む形でマッチし、接頭辞を含めて指定する必要があります。
URL にはワイルドカードを利用することができます。
? は任意の一文字、* は任意の文字列にマッチします。
どちらのワイルドカードも URL パス中の / にはマッチしません。
~ という文字を追加することで、正規表現を
利用することもできます。
例えば:
<Location ~ "/(extra|special)/data">
は URL に /extra/data か /special/data という文字列が
含まれている場合にマッチします。
<LocationMatch> ディレクティブは
<Location> の正規表現
版とまったく同じ動作をします。
<Location> 機能は、SetHandler ディレクティブと
組合わせて利用すると特に便利です。
例えば、example.com のブラウザからのみステータスの参照を有効にしたければ、
次のようにすれば良いでしょう。
<Location /status>
SetHandler server-status
Order Deny,Allow
Deny from all
Allow from .example.com
</Location>
スラッシュ文字は、URL 内に現れる場所に応じて変化する
特別な意味を持っています。
ファイルシステムにおいて利用する場合には複数のスラッシュでも一つの
スラッシュとして扱われることが多いですが、
(すなわち、/home///foo は
/home/foo と同じといったように)
URL においては必ずしもそうなるわけではありません。
<LocationMatch>
ディレクティブや正規表現を利用した
<Location> ディレクティブで、
複数のスラッシュにマッチさせたいときには、明示的に記述する
必要があります。
例えば、<LocationMatch ^/abc> は、
/abc というリクエスト URL にマッチしますが、
//abc というリクエスト URL にはマッチしません。
(正規表現でない) <Location>
ディレクティブは、
proxy リクエストに対して利用する際には同様の振る舞いをしますが、
(正規表現でない) <Location> を proxy
でないリクエストに対して利用する際には、
一つのスラッシュで複数のスラッシュにマッチします。
例えば、<Location /abc/def> と指定し、
/abc//def というリクエストがあれば、
マッチすることになります。
| 説明: | 囲んだディレクティブを正規表現にマッチする URL のみに 適用 |
|---|---|
| 構文: | <LocationMatch
regex> ... </LocationMatch> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
<LocationMatch> ディレクティブは、
<Location> と同じ様に
URL により中に書かれたディレクティブの適用範囲を制限します。
但し、引数は普通の文字列ではなく、正規表現となります。
例えば、
<LocationMatch "/(extra|special)/data">
は URL に /extra/data か /special/data
という文字列が含まれている場合にマッチします。
| 説明: | ErrorLog の冗長性を制御する |
|---|---|
| 構文: | LogLevel level |
| デフォルト: | LogLevel warn |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
LogLevel は、エラーログ (ErrorLog ディレクティブを
見てください) へ記録するメッセージの冗長性を調整します。
以下の level を指定でき、順に重要度が下がっていきます。
| レベル | 説明 | 例 |
|---|---|---|
emerg |
緊急 - システムが利用できない | Child cannot open lock file. Exiting (子プロセスがロックファイルを開けないため終了した) |
alert |
直ちに対処が必要 | getpwuid: couldn't determine user name from uid (getpwuid: UID からユーザ名を特定できなかった) |
crit |
致命的な状態 | socket: Failed to get a socket, exiting child (socket: ソケットが得られないため、子プロセスを終了させた) |
error |
エラー | Premature end of script headers (スクリプトのヘッダが足りないままで終わった) |
warn |
警告 | child process 1234 did not exit, sending another SIGHUP (子プロセス 1234 が終了しなかった。もう一度 SIGHUP を送る) |
notice |
普通だが、重要な情報 | httpd: caught SIGBUS, attempting to dump core in ... (httpd: SIGBUS シグナルを受け、... へコアダンプをした) |
info |
追加情報 | "Server seems busy, (you may need to increase StartServers, or Min/MaxSpareServers)..." (「サーバは負荷が高い、 (StartServers や Min/MaxSpareServers の値を増やす必要があるかも)」) |
debug |
デバッグメッセージ | "Opening config file ..." (設定ファイルを開いている...) |
特定のレベルが指定された場合、それより高いレベルの全てのメッセージが
報告されます。
例えば、LogLevel info に指定すると、
notice と warn も報告されます。
なお crit 以上のレベルを指定することが推奨されます。
例:
LogLevel notice
ファイルにログを出力する場合、notice
レベルのメッセージは抑制されず、すべてログに出力されます。
しかし syslog を使用している場合は、
これは当てはまりません。
| 説明: | 持続的な接続上で許可されるリクエストの数 |
|---|---|
| 構文: | MaxKeepAliveRequests number |
| デフォルト: | MaxKeepAliveRequests 100 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
MaxKeepAliveRequests ディレクティブは、
KeepAlive が有効な場合に、
一回の接続で受け付け可能なリクエストの数を制限します。
0 に設定していれば、受け付けるリクエストは無制限になります。
この設定は、サーバ性能を向上させるために、大きな数値を指定することを勧めます。
例:
MaxKeepAliveRequests 500
| 説明: | Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete
resource |
|---|---|
| 構文: | MaxRangeOverlaps default | unlimited | none | number-of-ranges |
| デフォルト: | MaxRangeOverlaps 20 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in Apache HTTP Server 2.3.15 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Number of range reversals (eg: 100-200,50-70) allowed before returning the complete
resource |
|---|---|
| 構文: | MaxRangeReversals default | unlimited | none | number-of-ranges |
| デフォルト: | MaxRangeReversals 20 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in Apache HTTP Server 2.3.15 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Number of ranges allowed before returning the complete resource |
|---|---|
| 構文: | MaxRanges default | unlimited | none | number-of-ranges |
| デフォルト: | MaxRanges 200 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in Apache HTTP Server 2.3.15 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Controls whether the server merges consecutive slashes in URLs. |
|---|---|
| 構文: | MergeSlashes ON|OFF |
| デフォルト: | MergeSlashes ON |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Added in 2.4.39 |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Determines whether trailers are merged into headers |
|---|---|
| 構文: | MergeTrailers [on|off] |
| デフォルト: | MergeTrailers off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | 2.4.11 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Configures mutex mechanism and lock file directory for all or specified mutexes |
|---|---|
| 構文: | Mutex mechanism [default|mutex-name] ... [OmitPID] |
| デフォルト: | Mutex default |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in Apache HTTP Server 2.3.4 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | 名前ベースのバーチャルホストのための IP アドレスを指定 |
|---|---|
| 構文: | NameVirtualHost addr[:port] |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
NameVirtualHost ディレクティブは、
名前ベースのバーチャルホストの設定を行ないたい場合に
必要となるものです。
addr にはホスト名を指定できますが、 常に IP アドレスを指定するのが推奨されます。 例えば、
NameVirtualHost 111.22.33.44
NameVirtualHost ディレクティブは、
名前ベースのバーチャルホストを
利用してリクエストを受け付ける IP アドレスを指定します。
これは、普通は名前ベースのバーチャルホストアドレスです。
ただし、ファイアーウォールや他のプロキシがリクエストを受け付け、
違う IP アドレスのサーバにフォワードするという場合は、
リクエストを提供したいマシン上の物理インターフェースの
IP アドレスを指定する必要があります。
複数のアドレスで複数の名前ベースのバーチャルホストを指定する場合は
各アドレスに対してディレクティブを書いてください。
「主サーバ」や、どの _default_ サーバも、
NameVirtualHost で指定した IP アドレスへのリクエスト
を処理することはありません (なぜか
NameVirtualHost を
指定したけどそのアドレスに VirtualHost を定義しなかった場合を除く)。
名前ベースのバーチャルホストにポート番号を指定することも可能です。 例えば
NameVirtualHost 111.22.33.44:8080
IPV6 のアドレスは次の例のように角括弧で囲む必要があります:
NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
すべてのインタフェースへのリクエストを受け取るようにするためには、
引数として * を使います。
NameVirtualHost *
<VirtualHost> ディレクティブの引数<VirtualHost> ディレクティブの引数は NameVirtualHost ディレクティブの引数に正確に
合っている必要があることに注意してください。
NameVirtualHost 1.2.3.4
<VirtualHost 1.2.3.4>
# ...
</VirtualHost>
| 説明: | ディレクトリに対して使用可能な機能を設定する |
|---|---|
| 構文: | Options
[+|-]option [[+|-]option] ... |
| デフォルト: | Options All |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Options |
| ステータス: | Core |
| モジュール: | core |
Options ディレクティブは、特定のディレクトリに対して
どの機能が使用可能かを制御します。
option を Noneに指定すると、
特別な機能は全て無効になります。
また、以下の示す 1 個以上のものを指定できます。
AllMultiViews を除いた全ての機能が有効となります。
これがデフォルトです。ExecCGImod_cgi による CGI スクリプトの実行を許可します。FollowSymLinksサーバがシンボリックリンクをたどる場合でも、
<Directory> セクションに
マッチさせるための
パス名は変更されません。
<Location> 内に
このオプションを指定しても無視されることに
注意してください。
このオプションを省略したからといってセキュリティの強化にはなりません。 なぜなら symlink の検査はレースコンディションを引き起こす可能性があり、 そのため回避可能になるからです。
Includesmod_include が提供する SSI を有効にします。IncludesNOEXEC#exec コマンド と #exec CGI は無効になります。
ただし、#include virtual により、ScriptAlias されたディレクトリで
CGI を実行することは可能です。IndexesDirectoryIndex で指定したファイル (例えば、index.html) が
ディレクトリ内に無ければ、mod_autoindex が
ディレクトリ内の一覧を整形して返します。MultiViewsmod_negotiation による
コンテントネゴシエーション
された "MultiViews" を許可します。SymLinksIfOwnerMatch<Location> 内にこのオプションを
指定しても無視されます。
このオプションはセキュリティの強化にはなりません。 なぜなら symlink の検査はレースコンディションを引き起こす可能性があり、 そのため回避可能になるからです。
通常、ディレクトリに対して複数の Options が
適用可能な場合、
最も近いもの一つのみが適用され、他のものは無視されます。
複数の指定がマージされるわけではありません。(セクションのマージ方法を参照してください。)
しかし、すべての Options ディレクティブが + や - 付きで
指定された場合はオプションの値はマージされます。
+ を頭につければ現在の設定に加えられ、
- を付ければ現在の設定から削除されます。
Options で + や
- のついたものを、つけないものと組み合わせて
指定する構文は正しい構文ではありませんので、期待する結果に
ならないことがあります。
例えば、+ や - を利用しない場合は:
<Directory /web/docs>
Options Indexes FollowSymLinks
</Directory>
<Directory /web/docs/spec>
Options Includes
</Directory>
/web/docs/spec というディレクトリには、
Includes だけが適用されます。
しかし、2 番目の Options で + や - を利用してみると:
<Directory /web/docs>
Options Indexes FollowSymLinks
</Directory>
<Directory /web/docs/spec>
Options +Includes -Indexes
</Directory>
/web/docs/spec というディレクトリには、 FollowSymLinks と
Includes が適用されます。
-IncludesNOEXEC もしくは
-Includes を指定すると、
前の設定がどのようになっていようとも SSI は無効となります。
どのような設定もされていなければ、デフォルトでは All に
なります。
| 説明: | Protocol for a listening socket |
|---|---|
| 構文: | Protocol protocol |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in Apache 2.1.5 and later. On Windows, from Apache 2.3.3 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Protocols available for a server/virtual host |
|---|---|
| 構文: | Protocols protocol ... |
| デフォルト: | Protocols http/1.1 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Only available from Apache 2.4.17 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Determines if order of Protocols determines precedence during negotiation |
|---|---|
| 構文: | ProtocolsHonorOrder On|Off |
| デフォルト: | ProtocolsHonorOrder On |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Only available from Apache 2.4.17 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Controls whether the REDIRECT_URL environment variable is fully qualified |
|---|---|
| 構文: | QualifyRedirectURL On|Off |
| デフォルト: | QualifyRedirectURL Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Directive supported in 2.4.18 and later. 2.4.17 acted as if 'QualifyRedirectURL On' was configured. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Size of the buffers used to read data |
|---|---|
| 構文: | ReadBufferSize bytes |
| デフォルト: | ReadBufferSize 8192 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | 2.4.27 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Allow to configure global/default options for regexes |
|---|---|
| 構文: | RegexDefaultOptions [none] [+|-]option [[+|-]option] ... |
| デフォルト: | RegexDefaultOptions DOTALL DOLLAR_ENDONLY |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Only available from Apache 2.4.30 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Register non-standard HTTP methods |
|---|---|
| 構文: | RegisterHttpMethod method [method [...]] |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in Apache HTTP Server 2.4.24 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Apache の子プロセスから起動されたプロセスの CPU 消費量を 制限する |
|---|---|
| 構文: | RLimitCPU seconds|max [seconds|max] |
| デフォルト: | 未設定。オペレーティングシステムのデフォルトを使用 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
一つか二つのパラメータをとります。
最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2 番目のパラメータは最大のリソースリミットを設定します。
パラメータには数字か、オペレーティングシステムの最大となる
max のどちらかを指定することができます。
最大のリソースリミットを上げるためには、サーバを
root で実行するか起動されなければいけません。
ちなみに、この設定は Apache の子プロセス自体ではなく、 リクエストを受け付けた Apache の子プロセスから fork されたプロセスに 適用されます。 これには CGI や SSI から実行されたコマンドが含まれますが、Apache の 親プロセスから fork されたログのパイププロセスなどには適用されません。
CPU リソースのリミットはプロセスあたりの秒数で表わされます。
| 説明: | Apache の子プロセスから起動されたプロセスのメモリ消費量を 制限する |
|---|---|
| 構文: | RLimitMEM bytes|max [bytes|max] |
| デフォルト: | 未設定。オペレーティングシステムのデフォルトを使用 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
一つか二つのパラメータをとります。
最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2 番目のパラメータは最大のリソースリミットを設定します。
パラメータには数字か、オペレーティングシステムの最大となる
max のどちらかを指定することができます。
最大のリソースリミットを上げるためには、サーバを
root で実行するか起動されなければいけません。
この設定は Apache の子プロセス自体ではなく、 リクエストを受け付けた Apache の子プロセスから fork されたプロセスに 適用されます。 これには CGI や SSI から実行されたコマンドが含まれますが、Apache の 親プロセスから fork されたログのパイププロセスなどには適用されません。
メモリリソースのリミットはプロセスあたりのバイト数で表わされます。
| 説明: | Apache の子プロセスから起動されたプロセスが起動するプロセスの 数を制限する |
|---|---|
| 構文: | RLimitNPROC number|max [number|max] |
| デフォルト: | 未設定。オペレーティングシステムのデフォルトを使用 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
一つか二つのパラメータをとります。
最初のパラメータは全プロセスに対するリソースのソフトリミットを設定し、
2 番目のパラメータは最大のリソースリミットを設定します。
パラメータには数字か、オペレーティングシステムの最大となる
max のどちらかを指定することができます。
最大のリソースリミットを上げるためには、サーバを
root で実行するか起動されなければいけません。
この設定は Apache の子プロセス自体ではなく、 リクエストを受け付けた Apache の子プロセスから fork されたプロセスに 適用されます。 これには CGI や SSI から実行されたコマンドが含まれますが、Apache の 親プロセスから fork されたログのパイププロセスなどには適用されません。
プロセスの制限は、ユーザあたりのプロセス数で制御されます。
CGI プロセスがウェブサーバのユーザ ID 以外で実行されるので
無ければ、
このディレクティブは、サーバ自身が生成できるプロセスの数を制限することになります。
そのような状況になっているかどうかは、error_log 中の
cannot fork というメッセージにより
確認することができます。
| 説明: | CGI スクリプトのインタープリタの位置を調べるための手法 |
|---|---|
| 構文: | ScriptInterpreterSource Registry|Registry-Strict|Script |
| デフォルト: | ScriptInterpreterSource Script |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Win32 のみ。
オプション Registry-Strict は Apache 2.0 以降で使用可能 |
このディレクティブは、Apache で CGI スクリプトを
実行する場合に利用するインタープリタを、
どのように探し出すかについて制御するために使用します。
デフォルトの設定は Script です。これはスクリプトの
shebang 行 (最初の行で #! から始まるもの)
に指されているインタープリタを使用します。Win32 ではその行は
以下の様になります。
#!C:/Perl/bin/perl.exe
もしくは、perl が PATH にある場合は単に:
#!perl
ScriptInterpreterSource Registry を指定すると、
スクリプトファイルの拡張子 (例えば、.pl) を
キーとして、Windows のレジストリツリー HKEY_CLASSES_ROOT
を検索するようになります。レジストリのサブキー
Shell\ExecCGI\Command か、それが存在しない場合は
Shell\Open\Command がスクリプトファイルを開くために
使われます。レジストリキーが見つからないときは、Apache は Script
オプションが指定されたときの動作に戻ります。
ScriptInterpreterSource Registry を ScriptAlias されたディレクトリで使うときは
注意してください。Apache はそのディレクトリ中のすべてのファイルを
実行しようとします。Registry という設定は通常は実行されない
ファイルに対して望ましくないプログラムの実行が発生する可能性があります。
例えば、ほとんどの Windows システムで、
.htm ファイルのデフォルトの「開く」コマンドは
Microsoft Internet Explorer を実行しますので、スクリプトに指定された
ディレクトリにある .htm ファイルへのリクエストはサーバの
バックグラウンドでブラウザを実行することになります。これは、一分内くらいで
システムをクラッシュさるための良い方法です。
Apache 2.0 から導入されたオプション Registry-Strict は
Registry と同じことを行ないますが、サブキー
Shell\ExecCGI\Command のみを使います。
ExecCGI キーは普通に使われるキーではありません。Windows
レジストリに手動で設定する必要がありますので、システムでの偶発的なプログラムの
実行を防ぐことができます。
| 説明: | Determine if mod_status displays the first 63 characters of a request or the last 63, assuming the request itself is greater than 63 chars. |
|---|---|
| 構文: | SeeRequestTail On|Off |
| デフォルト: | SeeRequestTail Off |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Available in Apache httpd 2.2.7 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | サーバがクライアントに送るエラーメッセージに含める電子メールの アドレス |
|---|---|
| 構文: | ServerAdmin email-address|URL |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
ServerAdmin は、クライアントに返すさまざまな
エラーメッセージ中に記述する、
問合せアドレスを設定します。与えられた引数を httpd が
URL と認識しない場合は、email-address だと解釈して、
ハイパーリンクのターゲットに mailto: を付けます。
実際には、ここには電子メールアドレスを使うことが推奨されています。
多くの CGI スクリプトはそうなっていることを仮定しています。
URL を使う場合は、あなたの管理下にある別サーバを指すようにしてください。
そうでないと、エラーが起こったときに連絡をすることができなくなって
しまいます。
その際、これのために専用のアドレスを設定するのが良いでしょう。 例えば、
ServerAdmin www-admin@foo.example.com
といったようにします。ユーザはいつもサーバに関する話であるということを 明記してくるわけではありませんので。
| 説明: | リクエストを名前ベースのバーチャルホストにマッチさせているときに 使用されるホストの別名 |
|---|---|
| 構文: | ServerAlias hostname [hostname] ... |
| コンテキスト: | バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
ServerAlias ディレクティブは、ネームベースのバーチャルホストにおいて
使用するホストの別名を指定します。
適切であれば、ServerAlias ディレクティブでは
ワイルドカードを使うこともできます。
<VirtualHost *>
ServerName server.domain.com
ServerAlias server server2.domain.com server2
# ...
</VirtualHost>
| 説明: | サーバが自分自身を示すときに使うホスト名とポート |
|---|---|
| 構文: | ServerName [scheme://]fully-qualified-domain-name[:port] |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | このディレクティブはバージョン 2.0 ではバージョン 1.3 の
Port ディレクティブの機能も含みます。 |
ServerName ディレクティブは、
サーバが自分自身を示すスキーム名、ホスト名とポート番号を設定します。
これは、リダイレクトする URL を生成する際に利用されます。
例えば、ウェブサーバを動かしているマシンは simple.example.com
で、DNS のエイリアス www.example.com もあるときに、
ウェブサーバが後者として認識されて欲しいときは、以下のようにディレクティブを
使います。
ServerName www.example.com:80
ServerName が指定されていないときは、
サーバは IP アドレスから逆引きを行なうことでホスト名を知ろうとします。
ServerName にポートが指定されていないときは、
サーバはリクエストが来ている
ポートを使います。最高の信頼性と確実性をもたらすためには、
ServerName を使ってホスト名とポートを明示的に
指定してください。
名前ベースのバーチャルホスト
を利用している場合、<VirtualHost> セクション内の
ServerName はこのバーチャルホストにマッチするために
何がリクエストの Host: ヘッダに現れる必要があるのかを指定します。
SSL を処理するデバイス、例えばリバースプロクシやロードバランサや
SSL 処理軽減アプライアンスの裏側でサーバが稼動する場合もあるでしょう。
そういった場合では、クライアントが接続するときに使う
https:// スキームとポート番号を ServerName
ディレクティブで指定して、自己参照 URL が正しく生成できるようにします。
自己参照 URL (例えば mod_dir モジュールによるものなど)
が指定されたポートを使うか、クライアントのリクエストのポート番号を使うかを
決定する設定は UseCanonicalName
ディレクティブと UseCanonicalPhysicalPort
ディレクティブを参照してください。
| 説明: | 非互換のブラウザが名前ベースのバーチャルホストにアクセスしたときの ための互換用 URL パス名 |
|---|---|
| 構文: | ServerPath URL-path |
| コンテキスト: | バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
ServerPath ディレクティブは、ネームベースのバーチャルホストにおいて利用する
互換用 URL パス名を設定します。
| 説明: | インストールされたサーバのベースディレクトリ |
|---|---|
| 構文: | ServerRoot directory-path |
| デフォルト: | ServerRoot /usr/local/apache |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
ServerRoot ディレクティブは、
サーバが存在するディレクトリを設定します。
通常、conf/ や logs/ といったサブディレクトリが
存在します。
また、他の設定ディレクティブ (例えば Include や LoadModule など) における相対パスは、
このディレクトリからの相対位置となります。
ServerRoot /home/httpd
httpd の -d
オプションServerRoot の権限を適切に設定する方法はセキュリティのこつ| 説明: | サーバが生成するドキュメントのフッタを設定 |
|---|---|
| 構文: | ServerSignature On|Off|EMail |
| デフォルト: | ServerSignature Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Core |
| モジュール: | core |
ServerSignature ディレクティブは、
サーバが生成するドキュメント
(エラーメッセージ、mod_proxy における FTP のディレクトリリスト、
mod_info の出力、等々)
の最下行に付与するフッタの設定を行ないます。
そのようなフッタ行を有効にしたい理由には、
プロキシが複数連なっている場合に、ユーザはどのサーバが返した
エラーメッセージかを知る手段がほとんど無いというものがあります。
デフォルトである Off に設定をすると、フッタ行が抑制されます
(そして、Apache-1.2 以前と互換の動作をします)。
On に設定した場合は、単にドキュメントの中に、サーバのバージョン、
稼動中のバーチャルホストの ServerName の書かれた行を追加し、
EMail にした場合はさらに参照されたドキュメントに対する ServerAdmin を指す "mailto:" が追加されます。
バージョン 2.0.44 以降では、表示されるサーバーのバージョン番号の詳細はServerTokens
ディレクティブにより制御されます。
| 説明: | Server HTTP 応答ヘッダを設定する |
|---|---|
| 構文: | ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full |
| デフォルト: | ServerTokens Full |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
このディレクティブは、クライアントに送り返す Server
応答ヘッダ内に、サーバの一般的な OS 種別や、
コンパイルされて組み込まれているモジュールの情報を
含めるかどうかを指定します。
ServerTokens Prod[uctOnly]Server:
Apache といったように送ります。ServerTokens MajorServer:
Apache/2ServerTokens MinorServer:
Apache/2.0ServerTokens Min[imal]Server:
Apache/2.0.41 といったように送ります。ServerTokens OSServer: Apache/2.0.41
(Unix) といったように送ります。ServerTokens Full (もしくは未指定)Server: Apache/2.0.41
(Unix) PHP/4.2.2 MyMod/1.2 といったように送ります。この設定はサーバ全体に適用され、バーチャルホスト上で有効にしたり 無効にしたりはできません。
バージョン 2.0.44 以降ではこのディレクティブは ServerSignature
ディレクティブにより表示される情報も制御します。
| 説明: | マッチするファイルがハンドラで処理されるようにする |
|---|---|
| 構文: | SetHandler handler-name|None |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Apache 2.0 で core に移動 |
.htaccess や <Directory>
セクション、<Location>
セクションに書かれた場合、
このディレクティブはそこにあるすべてのファイルが
handler-name で指定されたハンドラで扱われることを強制します。例えば、拡張子に関わらず、
ディレクトリ全体がイメージマップファイルとして解析して欲しい場合には、
以下をそのディレクトリの .htaccess
ファイルに記述します:
SetHandler imap-file
別の例: URL http://servername/status
が指定されたときにサーバが状態報告をするようにしたいときは、以下を
httpd.conf に記述します:
<Location /status>
SetHandler server-status
</Location>
None という値を設定することで、
前の方の SetHandler で定義された設定を無効にすることが
できます。
注意:SetHandler はデフォルトのハンドラをオーバーライド しますので、通常の挙動、たとえば、スラッシュ (/) で終わる URL が リクエストされたときにディレクトリやインデックスファイルを返すよう取り扱う挙動は、 行われなくなります。
| 説明: | クライアントのリクエストや POST の入力を処理するフィルタを設定する |
|---|---|
| 構文: | SetInputFilter filter[;filter...] |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
SetInputFilter ディレクティブはクライアントの
リクエストや POST の入力をサーバが受け取ったときに処理するフィルタを
設定します。これは AddInputFilter
ディレクティブを含め、他の場所で定義されているフィルタの設定に
追加されます。
複数のフィルタを指定するときは、データを処理する順番に セミコロンで区切る必要があります。
| 説明: | サーバの応答を処理するフィルタを設定する |
|---|---|
| 構文: | SetOutputFilter filter[;filter...] |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Core |
| モジュール: | core |
SetOutputFilter ディレクティブは
サーバの応答をクライアントに送り返される前に処理するフィルタを設定します。
これは AddOutputFilter
ディレクティブを含め、他の場所で定義されているフィルタの設定に
追加されます。
例えば、以下の設定は /www/data/ ディレクトリのすべての
ファイルを SSI で処理します。
<Directory /www/data/>
SetOutputFilter INCLUDES
</Directory>
複数のフィルタを指定するときは、データを処理する順番に セミコロンで区切る必要があります。
| 説明: | Controls whether the server requires the requested hostname be listed enumerated in the virtual host handling the request |
|---|---|
| 構文: | StrictHostCheck ON|OFF |
| デフォルト: | StrictHostCheck OFF |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Added in 2.4.49 |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | 各イベントについて、リクエストを失敗させるまでにサーバが 待つ時間を設定 |
|---|---|
| 構文: | TimeOut seconds |
| デフォルト: | TimeOut 60 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Core |
| モジュール: | core |
TimeOut ディレクティブは、
様々な条件下での I/O 待ち時間を定義します:
mod_cgi 内で、CGI スクリプトが出力を
返すまでの待ち時間の長さmod_ext_filter 内で、フィルタ処理で出力を
待つ時間の長さmod_proxy 内で、
ProxyTimeout
が設定されていない場合のデフォルトの待ち時間| 説明: | TRACE メソッドのリクエストに対する応答方法を決める
|
|---|---|
| 構文: | TraceEnable [on|off|extended] |
| デフォルト: | TraceEnable on |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Apache 1.3.34, 2.0.55 以降 |
Apache のコア機能(訳注: core)と
mod_proxy 両方の TRACE
の挙動をオーバーライドします。デフォルトの TraceEnable on
は、リクエストボディを受け入れないような、RFC2616 に準拠した
TRACE リクエストを受け付けます。
TraceEnable off と設定すると、コアサーバと
mod_proxy は 405 (メソッド不許可)
エラーをクライアントに返します。
最後に、テストや調査目的などの限定用途として、仕様に準拠しない
TraceEnable extended を使って、リクエストボディを
受け付けるように挙動を変更できます。(オリジンサーバとしての)
Apache のコアでは、リクエストボディのサイズは 64k (
Transfer-Encoding: chunked が使われている場合は
chunk ヘッダ用に +8k) に制限されます。
Apache のコアは、ヘッダと全ての chunk ヘッダをレスポンスの
ボディとして返却します。
proxy サーバとしては、リクエストボディのサイズは 64k に制限されません。
| 説明: | Controls what UNC host names can be accessed by the server |
|---|---|
| 構文: | UNCList hostname [hostname...] |
| デフォルト: | unset |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
| 互換性: | Added in 2.4.60, Windows only. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Undefine the existence of a variable |
|---|---|
| 構文: | UnDefine parameter-name |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | サーバが自分自身の名前とポートを決定する方法を設定する |
|---|---|
| 構文: | UseCanonicalName On|Off|Dns |
| デフォルト: | UseCanonicalName Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Core |
| モジュール: | core |
多くの状況で Apache は自己参照 URL、すなわち
同じサーバを指す URL、を作成する必要があります。
UseCanonicalName On の場合は、ServerName ディレクティブで指定されている
ホスト名とポート番号を使って、その正規名 (自己参照の名前) を生成します。
この名前は、すべての自己参照 URL で使われますし、CGI の
SERVER_NAME と SERVER_PORT でも使われます。
UseCanonicalName Off の場合、
クライアントがホスト名とポートを指定したときには、
それらを元に自己参照 URL を作成します (指定がなかったときは
上の定義と同様にして正規名を解決します)。
これらの値は名前ベースの
バーチャルホストを実装で使われているのと同じ値で、
同じクライアントで取得できる値になっています。
CGI 変数 SERVER_NAME と SERVER_PORT
もクライアントから与えられた値から作成されます。
このような挙動が便利な例は、イントラネットのサーバで www
のような短い名前でユーザがマシンに接続するときです。
ユーザの入力で短いホスト名が使われていて、URL が最後のスラッシュ無しの
ディレクトリになっている http://www/splat のようなとき、
Apache はリクエストを http://www.domain.com/splat/
へリダイレクトします。
認証をするように設定していると、この場合
ユーザは 2 回認証をしなければならなくなります (www に
対して 1 回、www.domain.com に対してもう 1 回 --
詳細は この話題の
FAQ を参照してください)。
しかし UseCanonicalName が Off になっていると、
Apache は http://www/splat/ にリダイレクトします。
三つ目のオプション UseCanonicalName DNS は、
大規模な IP ベースのバーチャルホスティングで、
Host: ヘッダを提供しない古いクライアントを
サポートする場合を想定しています。
このオプションでは Apache は、クライアントが接続した IP アドレスに対して
DNS の逆引きを行なって、自己参照 URL を作成します。
CGI が SERVER_NAME に関して何らかの前提条件を
仮定しているときには、このオプションの設定によっては動作しなく
なるかもしれません。クライアントは実質的にはホスト名として
何でも望みの値を指定することができます。CGI が
SERVER_NAME を使って自己参照 URL を作成することしかしない
場合は、どの設定を行なっても大丈夫なはずです。
| 説明: | 自分自身の名前とポート番号を解決する方法を設定する |
|---|---|
| 構文: | UseCanonicalPhysicalPort On|Off |
| デフォルト: | UseCanonicalPhysicalPort Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Core |
| モジュール: | core |
さまざまな局面で 自己参照 URL -- それ自体のサーバを参照する URL
を作ることになります。UseCanonicalPhysicalPort On と設定すると、
UseCanonicalName に従って別名を
生成する場合に、実際の物理ポート番号を使って構成するようになります。
UseCanonicalPhysicalPort Off の場合は、実際の物理ポート番号は
使用せず、設定された情報を元にポート番号を決めます。
物理ポートが使われる場合の順番は次のようになっています:
UseCanonicalName On
ServerName で指定されているポート番号UseCanonicalName Off | DNS
Host: ヘッダをパースして取得されるポート番号ServerName で指定されているポート番号UseCanonicalPhysicalPort Off で、
物理ポート番号が上記の順序付けから除外されます。
| 説明: | 特定のホスト名や IP アドレスのみに適用されるディレクティブを 囲む |
|---|---|
| 構文: | <VirtualHost
addr[:port] [addr[:port]]
...> ... </VirtualHost> |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Core |
| モジュール: | core |
<VirtualHost> 及び
</VirtualHost> は、
特定のバーチャルホストに対してのみ適用されるディレクティブ群を括る
ために使われます。
バーチャルホストコンテキストで許可される全てのディレクティブを指定可能です。
サーバが、指定されたバーチャルホストにあるドキュメントへの
リクエストを受け付けた場合、
<VirtualHost> セクションの中にある
ディレクティブが適用されます。
Addrは、次のものが利用できます:
NameVirtualHost * と共に使われる、
すべての IP アドレスにマッチする文字 *_default_
<VirtualHost 10.1.2.3>
ServerAdmin webmaster@host.example.com
DocumentRoot /www/docs/host.example.com
ServerName host.example.com
ErrorLog logs/host.example.com-error_log
TransferLog logs/host.example.com-access_log
</VirtualHost>
IPv6 アドレスはオプションのポート番号の指定と区別するために、 角括弧で括って指定する必要があります。次は IPv6 の例です:
<VirtualHost [2001:db8::a00:20ff:fea7:ccea]>
ServerAdmin webmaster@host.example.com
DocumentRoot /www/docs/host.example.com
ServerName host.example.com
ErrorLog logs/host.example.com-error_log
TransferLog logs/host.example.com-access_log
</VirtualHost>
各々のバーチャルホストにはそれぞれ違う IP アドレス、ポート番号
もしくはホスト名に対応する必要があり、
1 番目の場合には複数のアドレスで IP パケットを受信できるように
サーバマシンを設定しなければなりません。
(もし、マシンが複数のネットワークインターフェースを持たない場合は、
(OSがサポートしていれば) ifconfig alias コマンドにより
達成できます)。
<VirtualHost> は Apache が Listen する
IP アドレスには影響を与えません。
Listen を
使って Apache が正しいアドレスを listen するように設定する必要があります。
IP ベースのバーチャルホストを使っている場合は、特別な名前
_default_ を指定することができます。その場合は
そのバーチャルホストは他のバーチャルホストで明示的に挙げられていない
すべての IP アドレスにマッチします。_default_ バーチャルホストが無い
場合に IP がバーチャルホストで指定されたものにマッチしないときは、
VirtualHost セクションの外のすべての定義からなる「主」サーバ設定が
使われます。(ただし、NameVirtualHost ディレクティブにマッチする
すべての IP アドレスは「主」サーバ設定も _default_ バーチャルホストも
使わないことに注意してください。詳しくは ネームベースのバーチャルホスト を
参照してください。)
:port といった形式で記述することにより、
マッチさせるポートを変更可能です。
この指定をしない場合には、主サーバ設定における
一番最後に Port で指定されたポートが
デフォルトとなります。
:* を指定することにより、
アドレス上の全てのポートにマッチします。(_default_ のときは
これを使うことが推奨されています。)
<VirtualHost> ブロックごとに
ServerName を指定すべきです。
もしなければ、メインサーバ設定の
ServerName
が継承されます
サーバーを起動した以外のユーザがログファイルが保管されるディレクトリに 書き込み可能なときになぜセキュリティが破られる可能性があるかの詳細は セキュリティに関するコツ を 参照してください。
Apache HTTP サーバ バージョン 2.4
この文書は各 Apache 設定ディレクティブ を説明するために使われている用語を説明します。
ディレクティブの目的の簡単な説明。
設定ファイル中のディレクティブの書式を示します。 この構文はディレクティブ特有なので、詳細はディレクティブの説明を 参照してください。一般的に、ディレクティブ名の後には 空白により分割されたいくつかの引数が続きます。 引数が空白を含むときは二重引用符 (訳注: ") で囲まれています。 オプショナルな引数は括弧 (訳注: []) で囲まれています。 引数が複数の値を取り得る場合は、それらの値は垂直の棒 "|" で 分割されています。 変更されないテキストはデフォルトのフォントで表示され、置換の必要な 引数は強調されて表示されます。 引数の数が変わるディレクティブは最後の 引数が繰り返されることを示すために "..." で終わります。
ディレクティブは多くの違う型の引数をとります。いくつか、良く 使われるものを以下で定義します。
http://www.example.com/path/to/file.html
のように、
スキーム、ホスト名、パス名(省略可能)を含んでいる完全な
Uniform Resource Locator。/path/to/file.html のように、スキームと
ホスト名の後に続く url
の一部。url-path は
ファイルシステムからの視点ではなく、
ウェブからの視点でリソースを表現します。/usr/local/apache/htdocs/path/to/file.html
のように、
ルートディレクトリから始まるローカルのファイルシステム上のファイルへのパス。
通常、スラッシュで始まらない file-path は ServerRoot
からの相対パスとして 扱われます。/usr/local/apache/htdocs/path/to/
のように、
ルートディレクトリから始まるローカルのファイルシステムのディレクトリへの
パス。file.html のように、パス情報の付いていない
ファイル名。file.html.en
には二つの拡張子があります。.html と
.en です。Apache
のディレクティブでは、extension
はドット付きでも無しでも指定できます。さらに、extension
は 大文字小文字を区別しません。text/html のように、スラッシュで分離された
主フォーマットと副フォーマットによってファイルの形式を
表す方法です。ディレクティブにデフォルト値 (すなわち、設定ファイルから 省略されていても、Apache ウェブサーバは特定の値に設定されているかのように 動作します) がある場合はここに記述されます。 デフォルト値の無い場合、ここは "None" と 書かれます。ここで書かれているデフォルトはサーバと共に配布されている デフォルトの httpd.conf 内に書かれているディレクティブの値と 違う可能性があることに注意してください。
これは、サーバの設定ファイル中のどこでディレクティブが有効なのかを示します。 次に示す値が一つ以上カンマ区切りで列挙されています。
httpd.conf,
srm.conf, access.conf)
内では使用できますが、
<VirtualHost> や
<Directory> の中では
使用できないことを示します。
.htaccessファイルでの使用は許可されていません。<VirtualHost>
の中で使用できることを示します。<Directory>,
<Location>,
<Files>,
<If>,
<Proxy>
コンテナの中で、 設定セクション
で説明されている制限の下で使用できることを示します。.htaccess ファイル内で
使用可能であることを示します。 ただ、上書き
の設定によっては、処理されないかもしれません。ディレクティブは指示されたコンテキストでのみ許可されます。 他の場所で使おうとすると、サーバがそのコンテキストを正しく扱えなく なるような設定エラーが発生するか、サーバがまったく動作しなくなる、 すなわち、サーバが起動しなくなるということになります。
ディレクティブの有効な位置は、実際は挙げられているコンテキストの
論理和 (訳注: Boolen OR)
になります。言い換えると、
"サーバ設定ファイル、.htaccess" で有効だと
記されているディレクティブは httpd.conf
ファイルと .htaccess
ファイルとで有効ですが、 <Directory>
や <VirtualHost>
の中では使用できません。
このディレクティブの属性は、.htaccess
ファイル中に
ディレクティブが現れたときに、それの処理を有効にするために
どの設定の上書きが必要かを示します。 ディレクティブの
コンテキスト
が、.htaccess
ファイル中では許可していない場合は、 この属性は
"適用不可" と書かれます。
上書きは、AllowOverride
ディレクティブによって有効にされ、
特定のスコープ(ディレクトリなど)と、
さらに下位のレベルの AllowOverride
で修正されない限り、 その配下に対して適用されます。
ディレクティブのドキュメントは取り得る上書きの名前も挙げます。
これはディレクティブが Apache ウェブサーバにどれくらいきつく組み込まれているかを 示します。言い換えれば、ディレクティブとその機能を利用するために、 モジュールの数を増やして、サーバを再コンパイルする必要があるかもしれない ということを示します。 この属性が取り得る値は以下のものです:
これは単純にディレクティブが定義されているモジュールの名前を記載します。
ディレクティブが Apache 2 の配布に組み込まれていなかった場合、 ディレクティブが導入されたバージョンがここに書かれています。 また、ディレクティブが特定のプラットフォームにのみ存在するときも ここに書かれています。
Apache HTTP Server Version 2.4
Nachfolgend ist eine Liste aller Module angegeben, die als Bestandteil der Distribution des Apache HTTP Servers mitgeliefert werden. Bitte beachten Sie auch die vollständige alphabetische Liste aller Apache-HTTP-Server-Direktiven.
worker MPM with the goal
of consuming threads only for connections with active processingA | B | C | D | E | F | H | I | L | M | N | P | R | S | U | V | W | X
ls command or the
Win32 dir shell commandmod_davmod_davExpires and
Cache-Control HTTP headers according to user-specified
criteriamod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxymod_proxy extension for load balancing mod_proxy extension for
CONNECT request handlingmod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxysed syntaxApache HTTP Server Version 2.4
worker MPM with the goal
of consuming threads only for connections with active processingA | B | C | D | E | F | H | I | L | M | N | P | R | S | U | V | W | X
ls ɾ Win32
dir ɾ 丮 mod_dav Ͻý mod_davExpires
Cache-Control HTTP Ѵmod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxymod_proxy extension for load balancing mod_proxy extension for
CONNECT request handlingmod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxysed syntaxApache HTTP Server Version 2.4
| : | ̵ û忡 CGI ũƮ Ѵ. |
|---|---|
| : | Base |
| : | actions_module |
| ҽ: | mod_actions.c |
ΰ þ ִ. Action þ ûϴ
MIME content type CGI ũƮ Ѵ.
Script þ
û Ư 带 CGI ũƮ Ѵ.
óϴ ũƮ ſ ִ.
| : | Ư ڵ鷯 content-type CGI ũƮ Ѵ |
|---|---|
| : | Action action-type cgi-script [virtual] |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_actions |
| : | virtual ڿ ڵ鷯 ġ
2.1 ߰Ǿ |
þ û action-type̸
cgi-script ϴ ൿ ߰Ѵ.
cgi-script ScriptAlias AddHandler Ͽ CGI
ũƮ ҽ URL̴.
action-type ڵ鷯 MIME content type
ִ. þ PATH_INFO
PATH_TRANSLATED CGI ǥ ȯ溯 û
URL ϰθ Ѵ. REDIRECT_HANDLER
Ư û ڵ鷯 Ѵ.
# Ư MIME content type û:
Action image/gif /cgi-bin/images.cgi
# Ư Ȯڸ
AddHandler my-file-type .xyz
Action my-file-type /cgi-bin/program.cgi
ù° MIME content type image/gif
ûϸ cgi ũƮ /cgi-bin/images.cgi
óѴ.
ι° Ȯڰ .xyz ûϸ
cgi ũƮ /cgi-bin/program.cgi
óѴ.
In the second example, requests for files with a file extension of
.xyz are handled instead by the specified cgi script
/cgi-bin/program.cgi.
virtual ڴ û
ϴ ˻ ʵ Ѵ. ,
ġ Action þ Ϸ
ϴ.
<Location /news>
SetHandler news-handler
Action news-handler /cgi-bin/news.cgi virtual
</Location>
| : | Ư û忡 CGI ũƮ Ѵ. |
|---|---|
| : | Script method cgi-script |
| : | ּ, ȣƮ, directory |
| : | Base |
| : | mod_actions |
þ method 带 Ͽ
ûϸ cgi-script ϴ ൿ
߰Ѵ. cgi-script ScriptAlias AddHandler Ͽ CGI
ũƮ ҽ URL̴. þ
PATH_INFO PATH_TRANSLATED CGI
ǥ ȯ溯 û URL ϰθ Ѵ.
Script PUT
Script put ٸ.
Script ɾ ⺻ ൿ
ó ϶. CGI ũƮ Ҹų, û 带
˾Ƽ ó ִ ҽ ״ óѴ.
GET Script
ǾƱԸƮ (, foo.html?hi)
϶. ǾƱԸƮ ٸ û óѴ.
# <ISINDEX> ˻
Script GET /cgi-bin/search
# CGI PUT ڵ鷯
Script PUT /~bob/put.cgi
Apache HTTP Server Version 2.4
| : | Ŭ̾Ʈ Ѵ |
|---|---|
| : | Extension |
| : | deflate_module |
| ҽ: | mod_deflate.c |
mod_deflate Ʈ
Ŭ̾Ʈ ϴ DEFLATE
Ѵ.
DeflateAlterETag DeflateBufferSize DeflateCompressionLevel DeflateFilterNote DeflateInflateLimitRequestBody DeflateInflateRatioBurst DeflateInflateRatioLimit DeflateMemLevel DeflateWindowSizeߺ ̴.
AddOutputFilterByType DEFLATE text/html text/plain text/xml
Ʒ Ͽ ϴ. ϶.
<Location />
# ߰Ѵ
SetOutputFilter DEFLATE
# Netscape 4.x ִ...
BrowserMatch ^Mozilla/4 gzip-only-text/html
# Netscape 4.06-4.08 ִ
BrowserMatch ^Mozilla/4\.0[678] no-gzip
# MSIE Netscape ڽ ˸,
# BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
# : ġ 2.0.48 mod_setenvif
# ǥ ʴ´. ϴ ȿ
# Ͽ Ѵ:
BrowserMatch \bMSI[E] !no-gzip !gzip-only-text/html
# ̹ ʴ´
SetEnvIfNoCase Request_URI \
\.(?:gif|jpe?g|png)$ no-gzip dont-vary
# Ͻð ߸ ʵ Ѵ
Header append Vary User-Agent env=!dont-vary
</Location>
SetOutputFilter DEFLATE
ϸ ó ϴ ֱ
html ϸ ϱ (Ʒ )
gzip-only-text/html 1
. ̸ 1 ƴ ϸ
Ѵ.
Ư MIME type Ϸ AddOutputFilterByType þ Ѵ.
html ϸ Ѵ:
<Directory "/your-server-root/manual">
AddOutputFilterByType DEFLATE text/html
</Directory>
ó ϴ Դ ʰ
BrowserMatch þ no-gzip
Ѵ. no-gzip
gzip-only-text/html ִ.
ڰ ڸ Ѵ. Ϻθ 캸:
BrowserMatch ^Mozilla/4 gzip-only-text/html
BrowserMatch ^Mozilla/4\.0[678] no-gzip
BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
User-Agent ڿ Netscape
Navigator 4.x ˻Ѵ. text/html
ƴ type ó Ѵ. 4.06, 4.07, 4.08
html óϴ´뵵 ִ. 츮
deflate ʴ´.
° BrowserMatch
þ Microsoft Internet Explorer ڽ "Mozilla/4"
˸ û ó ֱ user agent
Ѵ. User-Agent "MSIE"
(\b "ܾ " Ѵ) ڿ ߰ϸ
տ Ǭ.
DEFLATE ʹ PHP SSI RESOURCE
ڿ . , û(subrequest)
ʴ´.
SetEnv
force-gzip ȯ溯 ϸ
accept-encoding ϰ .
mod_deflate gzip
Ǫ ͵ Ѵ. Ϸ
SetOutputFilter AddOutputFilter Ͽ
ͼ INFLATE ߰Ѵ.
<Location /dav-area>
ProxyPass http://example.com/
SetOutputFilter INFLATE
</Location>
example.com gzip Ǯ, ٸ Ͱ ó ֵ Ѵ.
mod_deflate gzip û
Ǫ ͵ Ѵ. Ϸ
SetInputFilter
AddInputFilter
Ͽ Էͼ DEFLATE
߰Ѵ.
<Location /dav-area>
SetInputFilter DEFLATE
</Location>
û Content-Encoding: gzip ִٸ
ڵ Ǭ. gzip û ִ
幰. WebDAV Ŭ̾Ʈ
Ư α û Ѵ.
û 캻ٸ, Content-Length
! Content-Length Ŭ̾Ʈ
, Ǭ Ʈ
ƴϴ.
mod_deflate Ͻð ڽ ij
Accept-Encoding û
Ŭ̾ƮԸ Vary:
Accept-Encoding HTTP ߰Ѵ.
Ŭ̾Ʈ
ʵ Ѵ.
, User-Agent Ư
Ѵٸ, Ͻÿ ̷ ˷ֱ
Vary ߰ؾ Ѵ. ,
User-Agent DEFLATE
߰Ѵٸ Ѵ:
Header append Vary User-Agent
û ٸ ( , HTTP )
ΰ ȴٸ, Vary
* ؾ Ѵ. ǥ Ͻô
ij ʰ ȴ.
Header set Vary *
| : | How the outgoing ETag header should be modified during compression |
|---|---|
| : | DeflateAlterETag AddSuffix|NoChange|Remove |
| ⺻: | DeflateAlterETag AddSuffix |
| : | ּ, ȣƮ |
| : | Extension |
| : | mod_deflate |
| : | Available in Apache 2.4.58 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | zlib ѹ ũ |
|---|---|
| : | DeflateBufferSize value |
| ⺻: | DeflateBufferSize 8096 |
| : | ּ, ȣƮ |
| : | Extension |
| : | mod_deflate |
DeflateBufferSize þ zlib
ѹ Ʈ Ѵ.
| : | ϴ° |
|---|---|
| : | DeflateCompressionLevel value |
| ⺻: | Zlib's default |
| : | ּ, ȣƮ |
| : | Extension |
| : | mod_deflate |
| : | ġ 2.0.45 |
DeflateCompressionLevel þ
Ѵ. Ŭ ,
CPU Ѵ.
( ) 1 ( ) 9 Ѵ.
| : | α Ѵ |
|---|---|
| : | DeflateFilterNote [type] notename |
| : | ּ, ȣƮ |
| : | Extension |
| : | mod_deflate |
| : | type ġ 2.0.4 |
DeflateFilterNote þ û
α ϴ ȣ Ѵ. ȣ ̸ þ
̴. 踦
α ȣ ִ.
DeflateFilterNote ratio
LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate
CustomLog logs/deflate_log deflate
α Ȯ Ϸ type ƱԸƮ ڷḦ Ѵ. type ϳ̴:
InputOutputRatiooutput/input * 100) Ѵ.
type ƱԸƮ ϸ ϴ ⺻̴. ̷ α ִ:
DeflateFilterNote Input instream
DeflateFilterNote Output outstream
DeflateFilterNote Ratio ratio
LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
CustomLog logs/deflate_log deflate
| : | Maximum size of inflated request bodies |
|---|---|
| : | DeflateInflateLimitRequestBody value |
| ⺻: | None, but LimitRequestBody applies after deflation |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Extension |
| : | mod_deflate |
| : | 2.4.10 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | Maximum number of times the inflation ratio for request bodies can be crossed |
|---|---|
| : | DeflateInflateRatioBurst value |
| ⺻: | DeflateInflateRatioBurst 3 |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Extension |
| : | mod_deflate |
| : | 2.4.10 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | Maximum inflation ratio for request bodies |
|---|---|
| : | DeflateInflateRatioLimit value |
| ⺻: | DeflateInflateRatioLimit 200 |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Extension |
| : | mod_deflate |
| : | 2.4.10 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | zlib Ҷ ϴ |
|---|---|
| : | DeflateMemLevel value |
| ⺻: | DeflateMemLevel 9 |
| : | ּ, ȣƮ |
| : | Extension |
| : | mod_deflate |
DeflateMemLevel þ zlib
Ҷ ŭ Ѵ. (1 9
)
Apache HTTP Server Version 2.4
| : | Content cache storage manager keyed to URIs |
|---|---|
| : | Experimental |
| : | cache_disk_module |
| ҽ: | mod_cache_disk.c |
mod_cache_disk ũ ڸ
Ѵ. ⺻ mod_proxy
Ѵ.
URI Ű ij ϰ ´. ٺȣ ijʴ´.
CacheDirLength CacheDirLevels CacheMaxFileSize CacheMinFileSize CacheReadSize CacheReadTime CacheRoot| : | 丮 ڰ |
|---|---|
| : | CacheDirLength length |
| ⺻: | CacheDirLength 2 |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache_disk |
CacheDirLength þ ij
丮 ڼ Ѵ.
CacheDirLevels
CacheDirLength Ͽ 20
ũ ȵȴ.
CacheDirLength 4
| : | ij 丮 . |
|---|---|
| : | CacheDirLevels levels |
| ⺻: | CacheDirLevels 3 |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache_disk |
CacheDirLevels þ ij
丮 ̸ Ѵ. ij ڷḦ CacheRoot 丮
Ʒ ̱ Ѵ.
CacheDirLevels CacheDirLength
Ͽ 20 ũ ȵȴ.
CacheDirLevels 5
| : | ij ִũ (Ʈ ) |
|---|---|
| : | CacheMaxFileSize bytes |
| ⺻: | CacheMaxFileSize 1000000 |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache_disk |
CacheMaxFileSize þ ij
ִũ⸦ Ʈ Ѵ.
CacheMaxFileSize 64000
| : | ij ּũ (Ʈ ) |
|---|---|
| : | CacheMinFileSize bytes |
| ⺻: | CacheMinFileSize 1 |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache_disk |
CacheMinFileSize þ ij
ּũ⸦ Ʈ Ѵ.
CacheMinFileSize 64
| : | The minimum size (in bytes) of the document to read and be cached before sending the data downstream |
|---|---|
| : | |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Experimental |
| : | mod_cache_disk |
Documentation not yet translated. Please see English version of document.
| : | The minimum time (in milliseconds) that should elapse while reading before data is sent downstream |
|---|---|
| : | |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Experimental |
| : | mod_cache_disk |
Documentation not yet translated. Please see English version of document.
| : | ij 丮 root |
|---|---|
| : | CacheRoot directory |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache_disk |
CacheRoot þ ũ
ij 丮 Ѵ. mod_cache_disk ġ Ͽų
о ݵ þ ؾ Ѵ.
CacheRoot
ó ʴ´. CacheDirLevels CacheDirLength þ
þ root 丮 丮 Ѵ.
CacheRoot c:/cacheroot
Apache HTTP Server Version 2.4
þ .
Ͽ þ ˷ش. þ ſ ٸ, þ ڼ Ѵ. Ϲ þ ̸ ڿ ƱԸƮ ´. ƱԸƮ Ѵٸ ƱԸƮ ֵǥ Ѵ. ƱԸƮ ߰ȣ ´. ƱԸƮ ϳ "|" Ѵ. ڱ״ κ ⺻ ü , ü ƱԸƮ Ѵ. ƱԸƮ þ ƱԸƮ ݺ Ÿ "..." .
þ ſ پ ƱԸƮ ´. ϴ Ʒ .
http://www.example.com/path/to/file.html
Ŵ(scheme), ȣƮ, θ
Uniform Resource Locator/path/to/file.html url
Ŵ ȣƮ ڿ κ. url-path
Ͻýۿ ƴ ڷḦ
Ÿ./usr/local/apache/htdocs/path/to/file.html
root 丮 ϴ Ͻýۻ .
, file-path
ServerRoot η
Ѵ./usr/local/apache/htdocs/path/to/
root 丮 ϴ Ͻýۻ 丮 .file.html ϸ.file.html.en
.html .en̶ ΰ Ȯڸ
. ġ þ extension
տ ħǥ ־ ǰ ȴ. ,
extension ҹڸ ʴ´.text/html major format
type minor format type Ͽ ϴ
.þ ⺻ ִٸ ( , þ ġ Ѵ.) ´. ⺻ ٸ "None"̾ Ѵ. ⺻ Ե ⺻ httpd.conf þ ٸ ϶.
þ ִ ˷ش. ǥ ̴:
httpd.conf) , <VirtualHost>
<Directory>
Ѵ. þ
.htaccess Ͽ .<VirtualHost> ȿ
Ѵ.<Directory>, <Location>, <Files>, <Proxy>
Ѵ..htaccess
Ͽ Ѵ. þ ϴ
overrides õ
ִ.þ ҿ ִ. ٸ ϸ ϰ κп û ùٷ ó ϰų ۵, , ȵ ִ.
þ ִ Ҵ Ҹ
Ҹ(boolean) OR ̴. ,
"server config, .htaccess" ϴٴ
þ httpd.conf ϰ .htaccess
Ͽ , <Directory> <VirtualHost> .
þ .htaccess Ͽ Ϸ
override ɼ ؾ ϴ Ÿ. þ
þ .htaccess
Ͽ ٰ Ѵٸ ҵ
ʴ´.
Overrides AllowOverride þ ϰ,
(丮 ) Ư ٸ AllowOverride þ ٸ
ʾҴٸ ״ ȴ. þ
밡 override ̸ ´.
þ ġ ִ Ÿ. , þ ϱ ٽ ʿ䰡 ִ. :
ܼ þ ҽ Ѵ.
þ ġ 2 Ϻΰ ƴϿٸ, þ ߰ϱ ´. , ÷ 밡 þ ´.
Versión 2.4 del Servidor HTTP Apache
Abajo se muestra una lista con todos los módulos que forman parte de la distribución de Apache. Consulte también la lista alfabética completa de las directivas de Apache.
worker MPM with the goal
of consuming threads only for connections with active processingA | B | C | D | E | F | H | I | L | M | N | P | R | S | U | V | W | X
ls command or the
Win32 dir shell commandmod_davmod_davExpires and
Cache-Control HTTP headers according to user-specified
criteriamod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxymod_proxy extension for load balancing mod_proxy extension for
CONNECT request handlingmod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxysed syntaxServeur HTTP Apache Version 2.4
| Description: | Gère un cache des données d'authentification pour diminuer la charge des serveurs d'arrière-plan |
|---|---|
| Statut: | Base |
| Identificateur de Module: | authn_socache_module |
| Fichier Source: | mod_authn_socache.c |
| Compatibilité: | Versions 2.3 et ultérieures |
Maintient un cache des données d'authentification pour limiter les sollicitations du serveur d'arrière-plan.
Certains utilisateurs qui mettent en oeuvre une authentification
lourde s'appuyant par exemple sur des requêtes SQL
(mod_authn_dbd) ont signalé une charge induite
inacceptable sur leur fournisseur d'authentification. Cela se
produit typiquement dans le cas où une page HTML contient des
centaines d'objets (images, scripts, pages de styles, media,
etc...), et où une requête pour cette page génère des centaines de
sous-requêtes à effet immédiat pour des contenus supplémentaires
authentifiés.
Pour résoudre ce problème, mod_authn_socache fournit une
solution qui permet de maintenir un cache des données
d'authentification.
Le cache d'authentification doit être utilisé lorsque les
requêtes d'authentification induisent une charge significative sur le
serveur, le serveur d'arrière-plan ou le réseau. Cette mise en cache
n'apportera probablement aucune amélioration dans le cas d'une
authentification à base de fichier (mod_authn_file)
ou de base de données dbm (mod_authn_dbm) car ces
méthodes sont de par leur conception rapides et légères (la mise en
cache peut cependant s'avérer utile dans le cas où le fichier est
situé sur un montage réseau). Les fournisseurs d'authentification
basés sur SQL ou LDAP ont plus de chances de tirer parti de cette
mise en cache, en particulier lorsqu'un problème de performances est
détecté. mod_authnz_ldap gérant son propre cache,
seul mod_authn_dbd est concerné par notre sujet.
Les principales règles à appliquer pour la mise en cache sont :
AuthnCacheProvideFor.AuthBasicProvider
ou AuthDigestProvider.Voici un exemple simple permettant d'accélérer
mod_authn_dbd et utilisant dbm comme moteur de la
mise en cache :
#AuthnCacheSOCache est optionnel. S'il est défini, il l'est pour
#l'ensemble du serveur
AuthnCacheSOCache dbm
<Directory "/usr/www/myhost/private">
AuthType Basic
AuthName "Cached Authentication Example"
AuthBasicProvider socache dbd
AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
AuthnCacheProvideFor dbd
Require valid-user
#Optionnel
AuthnCacheContext dbd-authn-example
</Directory>
Les développeurs de modules doivent savoir que la mise en cache
avec mod_authn_socache doit être activée dans leurs modules. La
fonction de l'API ap_authn_cache_store permet de
mettre en cache les données d'authentification qu'un fournisseur
vient de rechercher ou de générer. Vous trouverez des exemples
d'utilisation à r957072, où trois fournisseurs authn sont activés pour la mise
en cache.
| Description: | Spécifie une chaîne de contexte à utiliser dans la clé du cache |
|---|---|
| Syntaxe: | AuthnCacheContext directory|server|custom-string |
| Défaut: | AuthnCacheContext directory |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_authn_socache |
Cette directive permet de spécifier une chaîne à utiliser avec le nom d'utilisateur fourni (et le domaine d'authentification - realm - dans le cas d'une authentification à base de condensés) lors de la construction d'une clé de cache. Ceci permet de lever l'ambiguïté entre plusieurs noms d'utilisateurs identiques servant différentes zones d'authentification sur le serveur.
Il y a deux valeurs spéciales pour le paramètre : directory,
qui utilise le contexte de répertoire de la requête comme chaîne, et
server, qui utilise le nom du serveur virtuel.
La valeur par défaut est directory, qui est aussi la
définition la plus courante. Ceci est cependant loin d'être optimal,
car par exemple, $app-base, $app-base/images,
$app-base/scripts et $app-base/media
possèderont chacun leur propre clé de cache. Il est préférable
d'utiliser le fournisseur de mot de passe : par exemple un fichier
htpasswd ou une table de base de données.
Les contextes peuvent être partagés entre différentes zones du serveur, où les données d'authentification sont partagées. Ceci est cependant susceptible de créer des trous de sécurité de type cross-site ou cross-application, et cette directive n'est donc pas disponible dans les contextes .htaccess.
| Description: | Active la mise en cache de l'authentification en tout endroit |
|---|---|
| Syntaxe: | AuthnCacheEnable |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_authn_socache |
Normalement, cette directive n'est pas nécessaire : l'activation est implicite si la mise en cache de l'authentification a été activée en tout autre endroit du fichier httpd.conf. Par contre, si cette mise en cache n'a pas été activée, par défaut, elle ne sera pas initialisée, et ne sera donc pas disponible dans un contexte de fichier .htaccess. Cette directive permet d'être sûr que la mise en cache a bien été activée et pourra donc être utilisée dans les fichiers .htaccess.
| Description: | Spécifie le fournisseur pour lequel on veut effectuer une mise en cache |
|---|---|
| Syntaxe: | AuthnCacheProvideFor fournisseur-authn [...] |
| Défaut: | None |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_authn_socache |
Cette directive permet de spécifier un ou plusieurs fournisseurs pour
le(s)quel(s) on veut effectuer une mise en cache. Les données
d'authentification trouvées par un fournisseur non spécifié dans une
directive AuthnCacheProvideFor ne seront pas mises en
cache.
Par exemple, pour mettre en cache les données d'authentification
trouvées par mod_authn_dbd ou par un fournisseur
personnalisé mon-fournisseur, et ne pas mettre en cache
celles trouvées par les fournisseurs légers comme file ou dbm :
AuthnCacheProvideFor dbd mon-fournisseur
| Description: | Sélectionne le fournisseur socache d'arrière-plan à utiliser |
|---|---|
| Syntaxe: | AuthnCacheSOCache nom-fournisseur[:arguments-fournisseur] |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_authn_socache |
| Compatibilité: | Les arguments optionnels du fournisseur sont disponibles à partir de la version 2.4.7 du serveur HTTP Apache |
Cette définition s'applique à l'ensemble du serveur et permet de sélectionner un fournisseur pour le cache d'objets partagés, ainsi que des arguments éventuels pour ce fournisseur. Les fournisseurs disponibles sont, entre autres, "dbm", "dc", "memcache", ou "shmcb", chacun d'entre eux nécessitant le chargement du module approprié. Si elle est absente, c'est la valeur par défaut pour votre plate-forme qui sera utilisée.
| Description: | Définit une durée de vie pour les entrées du cache |
|---|---|
| Syntaxe: | AuthnCacheTimeout durée-de-vie (secondes) |
| Défaut: | AuthnCacheTimeout 300 (5 minutes) |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_authn_socache |
La mise en cache des données d'authentification peut constituer un trou de sécurité, bien qu'un mise en cache de courte durée ne posera probablement pas de problème. En général, il est conseillé de conserver les entrées du cache de façon à ce que la charge du serveur d'arrière-plan reste normale, mais pas plus longtemps ; une durée de vie plus longue peut être paramétrée si les changements d'utilisateurs et de mots de passe sont peu fréquents. La durée de vie par défaut de 300 secondes (5 minutes) est à la fois raisonnable et suffisamment importante pour réduire la charge d'un serveur d'arrière-plan comme dbd (requêtes SQL).
Cette durée de vie ne doit pas être confondue avec la durée de vie de session qui est un tout autre sujet. Cependant, vous devez utiliser votre logiciel de gestion de session pour vérifier si les données d'authentification mises en cache peuvent allonger accidentellement une session, et en tenir compte lorsque vous définissez la durée de vie.
Apache HTTP サーバ バージョン 2.4
| 説明: | 認証が必要な領域への "anonymous" ユーザのアクセスを許可する |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | authn_anon_module |
| ソースファイル: | mod_authn_anon.c |
| 互換性: | Apache 2.1 以降 |
このモジュールは mod_auth_basic のような
認証フロントエンドとして、anonymous-ftp サイトのような、「魔法の」ユーザ ID
'anonymous' と電子メールアドレスをパスワードにしたユーザ認証を
行なう機能を提供します。この電子メールアドレスはログ収集することが
できます。
他の (データベースによる) アクセス制御方法と組み合わせることで、 「未登録」ユーザに対してサイトを公開しつつ、効率よくユーザ追跡したり、 ユーザのプロファイルに応じたカスタマイズをしたりできます。 このような認証に基づいたユーザ追跡の利点の一つは、 マジッククッキーに基づくユーザ追跡方法や、 珍妙な URL の接頭辞や接尾辞を利用したユーザ追跡方法とは異なり、 完全にブラウザ非依存であり、ユーザ間で URL を共有することができるという 点です。
mod_auth_basic を使用している場合は、このモジュールは
AuthBasicProvider に
anon という値を設定することで起動されます。
以下の例は「普通」の htpasswd ファイルに基づいた認証と組み合わされて おり、以下の要件を見たすユーザを「ゲスト」として許可します:
Anonymous_NoUserID)Anonymous_MustGiveEmail)Anonymous_VerifyEmail)anonymous guest www test
welcome のどれかでなければなりません。
ユーザ名の比較は大文字小文字を区別しません。Anonymous_LogEmail)<Directory /var/www/html/private>
AuthName "Use 'anonymous' & Email address for guest entry"
AuthType Basic
AuthBasicProvider file anon
AuthUserFile /path/to/your/.htpasswd
Anonymous_NoUserID off
Anonymous_MustGiveEmail on
Anonymous_VerifyEmail on
Anonymous_LogEmail on
Anonymous anonymous guest www test welcome
Require valid-user
</Directory>
| 説明: | パスワードの検査無しでアクセスを許可する userID を指定する |
|---|---|
| 構文: | Anonymous user [user] ... |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Extension |
| モジュール: | mod_authn_anon |
パスワードの検査をしないでアクセスを許可する「魔法の」 userID を 設定します。userID 中に空白を使えるようにするため、 エスケープ文字 \ による方法と、引用符 ' と " によるクオーティング を使うことができます。
ユーザ名の比較は大文字小文字を区別しないことに
注意してください。
魔法のユーザ名 'anonymous' が許可されている userID に
含むようにすることは強く推奨されています。
Anonymous anonymous "Not Registered" "I don't know"
これは、userID "anonymous", "AnonyMous", "Not Registered", "I Don't Know" のどれかを使っても パスワード無しでユーザがサイトに入れるようにします。
Apache 2.1 では userID に "*" を指定することができます。
この場合、すべてのuserID を許可します。
| 説明: | 入力されたパスワードがエラーログにロギングされるかどうかを 設定する |
|---|---|
| 構文: | Anonymous_LogEmail On|Off |
| デフォルト: | Anonymous_LogEmail On |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Extension |
| モジュール: | mod_authn_anon |
デフォルトの On に設定された場合は、
入力された (まっとうな電子メールアドレスであることが
期待される) 「パスワード」がエラーログにロギングされます。
| 説明: | 空パスワードを許可するかどうかを指定する |
|---|---|
| 構文: | Anonymous_MustGiveEmail On|Off |
| デフォルト: | Anonymous_MustGiveEmail On |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Extension |
| モジュール: | mod_authn_anon |
ユーザがパスワードとして電子メールアドレスを指定する必要があるかどうかを 設定します。これは空パスワードを禁止します。
| 説明: | 空 userID を許可するかを指定する |
|---|---|
| 構文: | Anonymous_NoUserID On|Off |
| デフォルト: | Anonymous_NoUserID Off |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Extension |
| モジュール: | mod_authn_anon |
On に設定すると、ユーザは userID (とおそらくは
パスワード欄も) 空にすることができます。これは単にリターンキーを
叩いたり OK ボタンを直接クリックしたりする MS-Explorer ユーザには
非常に便利です。そのような操作はごくごく自然なものでしょう。
| 説明: | パスワード欄が正しい形式の電子メールアドレスであることを 調べるかどうかを設定する |
|---|---|
| 構文: | Anonymous_VerifyEmail On|Off |
| デフォルト: | Anonymous_VerifyEmail Off |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Extension |
| モジュール: | mod_authn_anon |
On に設定されている場合、ユーザが有効な電子メール
アドレスを入力することを推奨するため、入力された「パスワード」は
少なくとも一つの '@' と '.' を含んでいるかどうかを調べます
(上の Anonymous_LogEmail 参照)。
Apache HTTP Sunucusu Sürüm 2.4
Standart Apache dağıtımında bulunan yönergelerin tamamı burada listelenmiştir. Hepsi aralarında şekilsel bir uyum sağlanarak açıklanmışlardır. Açıklamalarında kullanılan terimler için Yönerge Sözlüğüne bakabilirsiniz.
Ayrıca, yönerge ayrıntılarının bir özet olarak listelendiği bir Hızlı Yönerge Kılavuzu da mevcuttur.
A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X
Apache HTTP Sunucusu Sürüm 2.4
Apache HTTP Sunucusu dağıtımının parçası olarak gelen modüllerin tamamı aşağıda listelenmiştir. Ayrıca, tüm Apache HTTP Sunucusu yönergelerinin alfabetik olarak listelendiği bir Yönerge Dizini de mevcuttur.
worker MPM with the goal
of consuming threads only for connections with active processingA | B | C | D | E | F | H | I | L | M | N | P | R | S | U | V | W | X
ls veya Win32 dir kabuk komutunun
yaptığı gibi dizin içeriğini listeler.mod_davmod_davExpires and
Cache-Control HTTP headers according to user-specified
criteriamod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxymod_proxy extension for load balancing mod_proxy extension for
CONNECT request handlingmod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxysed syntaxApache HTTP サーバ バージョン 2.4
| 説明: | ホスト (名前もしくは IP アドレス) に基づいたグループ承認 |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | access_compat_module |
| ソースファイル: | mod_access_compat.c |
| 互換性: | Apache 2.3 (Apache 2.x の以前のバージョンとの互換性のためのモジュールとして)。
このモジュールで提供するディレクティブは、承認の仕組みの一新に伴い、非推奨になったものです。
mod_authz_host も見てください。 |
mod_access_compat により提供されるディレクティブは
サーバの特定の部分への
アクセスを制御するために <Directory>, <Files>, <Location>
と .htaccess ファイルで使用されます。クライアントのホスト名、IP
アドレスや、環境変数などのリクエストの特徴に基づいて
アクセス制御を行なうことができます。Allow と
Deny ディレクティブを使って、
どのようなクライアントにアクセスを
許可する、しないを指定します。また
Order ディレクティブを使って、
デフォルトのアクセス状態と、
Allow ディレクティブと
Deny
ディレクティブとのお互いへの影響の仕方を設定します。
ホストによるアクセス制限とパスワードによる認証を、
同時に組み合わせて使うこともできます。
この場合、その二つの制限の関係を指定するために
Satisfy
ディレクティブを使用します。
mod_access_compatが提供するディレクティブは、
承認の仕組みの一新に伴い、非推奨になったものです。
mod_authz_host も見てください。
デフォルトの承認の取り扱い機能を使用するために
mod_authz_default
モジュールもロードされなければなりません。
一般的には、アクセス制限ディレクティブはすべてのアクセスメソッド
(GET, PUT, POST など)
に適用されます。そして、ほとんどの場合これが望ましい動作です。
しかし、<Limit>
セクションの中にディレクティブを書くことで、
一部のメソッドにのみ制限をかけることもできます。
| 説明: | サーバのある領域にアクセスできるホストを制御する |
|---|---|
| 構文: | Allow from all|host|env=[!]env-variable
[host|env=[!]env-variable] ... |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | Limit |
| ステータス: | Extension |
| モジュール: | mod_access_compat |
Allow ディレクティブは、どのホストが
サーバのある領域にアクセスできるかに影響を与えます。
アクセスはホスト名、IP アドレス、IP アドレスの範囲や、
環境変数などのクライアントのリクエストの
特徴に基づいてアクセス制御することができます。
このディレクティブの最初の引数は常に from です。
それに続く引数は三つの違った形式があります。Allow from
all が指定されていれば、すべてのホストにアクセスを許可し、
アクセス制限は下で説明されているように、
Deny
ディレクティブと Order
ディレクティブの設定で決まります。
特定のホストやホスト群にのみサーバへのアクセスを許可するためには、
以下のどれかの形式で host を指定することができます:
Allow from apache.org
Allow from .net example.edu
この文字列に合うか、これで終わる名前のホストのアクセスが許可されます。
各部分が完全に合うものだけに適用されますので、上の例は
foo.apache.org にはマッチしますが、
fooapache.org にはマッチしません。
この設定をすると、Apache は
HostnameLookups
の設定に関わらず、クライアントの IP アドレスに対して
DNS の 2 重逆引きを行ないます。
ホスト名からオリジナルの IP アドレスを順引きします。
順引きと逆引きが一致し、ホスト名が該当した場合にのみ、
アクセスが許可されます。
Allow from 10.1.2.3
Allow from 192.168.1.104 192.168.1.205
アクセスを許可する IP アドレスです。
Allow from 10.1
Allow from 10 172.20 192.168.2
サブネットの制限用の、IP アドレスの最初の一つから三つまでのバイトです。
Allow from 10.1.0.0/255.255.0.0
ネットワーク a.b.c.d とネットマスク w.x.y.z です。 より細粒度のサブネット制限用です。
Allow from 10.1.0.0/16
ネットマスクが nnn の上位ビットが 1 となっているものからなること以外は前のものと同じです。
注: 最後の三つの例はまったく同じホストに合います。
IPv6 アドレスと IPv6 のサブネットは以下のように指定できます:
Allow from 2001:db8::a00:20ff:fea7:ccea
Allow from 2001:db8::a00:20ff:fea7:ccea/10
Allow ディレクティブの引数の三つ目の形式は、
環境変数
の存在によりアクセスの制御を行なえるようにするものです。
Allow from env=env-variable
が指定されていると、環境変数 env-variable
が存在した場合にリクエストはアクセスを許可されます。
Allow from env=!env-variable
が指定されていると、環境変数 env-variable
が存在しない場合にアクセス許可されます。
サーバは mod_setenvif
のディレクティブにより、クライアントのリクエスト
の特徴に基づいて柔軟に環境変数を設定する機能を提供します。
ですから、このディレクティブはクライアントの
User-Agent (ブラウザの種類)、Referer
や他の HTTP リクエストのヘッダフィールドなどに基づいて
アクセス許可をするために使うことができます。
SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in
<Directory /docroot>
Order Deny,Allow
Deny from all
Allow from env=let_me_in
</Directory>
この場合、user-agent の文字列が KnockKnock/2.0
で始まるブラウザのみがアクセスが許可され、
他のものはアクセスが拒否されます。
| 説明: | サーバがアクセスを拒否するホストを制御する |
|---|---|
| 構文: | Deny from all|host|env=[!]env-variable
[host|env=[!]env-variable] ... |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | Limit |
| ステータス: | Extension |
| モジュール: | mod_access_compat |
このディレクティブはホスト名、IP
アドレス、環境変数に基づいてサーバへのアクセスを制限します。
Deny ディレクティブの引数は Allow
ディレクティブとまったく同じです。
| 説明: | デフォルトのアクセス可能な状態と、Allow と
Deny が評価される順番を制御する |
|---|---|
| 構文: | Order ordering |
| デフォルト: | Order Deny,Allow |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | Limit |
| ステータス: | Extension |
| モジュール: | mod_access_compat |
Order ディレクティブは Allow ディレクティブとDeny と共に"3段階アクセス制御システム"
を制御します。第1段階目では Order ディレクティブで1番目に
指定したディレクティブ(Allow
または Deny)を全て処理します。
第2段階目で、残りのディレクティブ(Deny または Allow)
を全て処理します。第3段階目で、第1段階目と第2段階目で
マッチしなかったリクエストを処理します。
全ての Allow と Deny が処理され、結局のところ最後にマッチ
した条件が有効となることに注意してください。これは最初にマッチした条件だけが有効
となる、典型的なファイアウォールの動作とは異なっています。
また、設定ファイルに書く順番には意味はありません。Allow 行は全部一つのグループとして扱われ、
Deny 行はもう一つのグループとみなされます。
またデフォルト状態は単独で一つのグループとみなされます。
Order 設定は以下のどれかです。
Allow,DenyAllow
ディレクティブが適用されます。どれにもマッチしなかった場合、この時点で
リクエストは拒否されます。次に、全ての
Deny ディレクティブが適用されます。どれか一つでもマッチした場合は、
リクエストは拒否されます。
最後に、 Allow にも Deny にもマッチしなかったリクエストは
デフォルト設定が適用されるので拒否されます。Deny,AllowDeny
ディレクティブが適用されます。どれか一つでもマッチした場合は、
Allow のどれにも
マッチしなければ、アクセスは拒否されます。
どの Allow にも Deny にもマッチしないリクエストは
許可されます。Mutual-failureOrder Allow,Deny と全く同じ効果を持ち、
そのため非推奨となっています。
キーワードの間に置けるのはコンマだけです。 間に空白があってはいけません。
| マッチ | Allow,Deny 時の結果 | Deny,Allow 時の結果 |
|---|---|---|
| Allow だけにマッチ | 許可 | 許可 |
| Deny だけにマッチ | 拒否 | 拒否 |
| どちらにもマッチしない | 2番目のディレクティブがデフォルト: 拒否 | 2番目のディレクティブがデフォルト: 許可 |
| Allow と Deny 両方にマッチ | 最後にマッチしたほう: 拒否 | 最後にマッチしたほう: 許可 |
以下の例では、apache.org ドメインのすべてのホストはアクセスを許可されます。 他のすべてのホストはアクセスを拒否されます。
Order Deny,Allow
Deny from all
Allow from apache.org
次の例では、foo.apache.org サブドメインにあるホスト以外の、
apache.org ドメインのすべてのホストがアクセスを許可されます。
apache.org
ドメインでないホストは、デフォルトの状態が Deny のため、
サーバへのアクセスを拒否されます。
Order Allow,Deny
Allow from apache.org
Deny from foo.apache.org
一方、上の例の Order が Deny,Allow
に変わっていれば、すべのホストにアクセスが許可されます。
これは、設定ファイル中の実際の順番に関わらず、
Allow from apache.org が最後に評価されて、
Deny from foo.apache.org を上書きするからです。
apache.org
ドメインにないホストも、デフォルトの状態が Allow
なので、アクセスを許可されます。
Order
ディレクティブはデフォルトのアクセスの状態に影響を与えるので、
Allow ディレクティブと
Deny
ディレクティブが無くても、サーバのアクセスに影響を与えることができます。
たとえば、
<Directory /www>
Order Allow,Deny
</Directory>
はデフォルトのアクセス状態が
Deny になるため、
/www ディレクトリへのすべてのアクセスを拒否します。
Order
ディレクティブはサーバの設定処理の各段階でだけ
アクセスディレクティブの処理の順番を変更します。これは、たとえば、
Order ディレクティブの設定に関わらず、
<Location> セクションの
Allow ディレクティブや
Deny ディレクティブは、
Directory セクションや
.htaccess ファイルの Allow
ディレクティブや Deny
ディレクティブよりも常に後に評価されるということを意味します。
設定セクションのマージの詳細については、
Directory,Location, Files
セクションの動作方法 を参照してください。
| 説明: | ホストレベルのアクセス制御とユーザ認証との相互作用を指定 |
|---|---|
| 構文: | Satisfy Any|All |
| デフォルト: | Satisfy All |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Extension |
| モジュール: | mod_access_compat |
| 互換性: | バージョン 2.0.51 以降では <Limit> ディレクティブと <LimitExcept> ディレクティブの影響を受ける
|
Allow と
Require の両方が使われているときの
アクセスポリシーを設定します。パラメータは All か Any
です。このディレクティブはある場所へのアクセスがユーザ名/パスワード
とクライアントのホストのアドレスで制限されているときにのみ
役立ちます。デフォルトの動作 (All) はクライアントがアドレスによる
アクセス制限を満たし、かつ正しいユーザ名とパスワードを入力することを
要求します。Any では、クライアントはホストの制限を満たすか、
正しいユーザ名とパスワードの入力をするかをすればアクセスを許可されます。
これは、ある場所をパスワードで保護するけれど、特定のアドレスからの
クライアントにはパスワードの入力を要求せずにアクセスを許可する、
というようなときに使用できます。
例えば、同じネットワーク上にいる人にはウェブサイトのある部分について 無制限のアクセスを許したいけれど、外のネットワークの人には パスワードを提供させるようにするためには、次のような設定をすることが できます:
Require valid-user
Allow from 192.168.1
Satisfy Any
バージョン 2.0.51 からは
<Limit> セクションと
<LimitExcept> セクションを使用することで
Satisfy ディレクティブが
適用されるメソッドを制限することが
できるようになりました。
Apache HTTP サーバ バージョン 2.4
| 説明: | メディアタイプやリクエストメソッドに応じて CGI スクリプトを実行する機能を提供 |
|---|---|
| ステータス: | Base |
| モジュール識別子: | actions_module |
| ソースファイル: | mod_actions.c |
このモジュールには二つのディレクティブがあります。Action
ディレクティブは特定の MIME タイプのファイルをリクエストされた場合に
CGI スクリプトが実行されるようにします。Script
ディレクティブはリクエストで特定のメソッドが使用されたときに CGI
スクリプトが実行されるようにします。
これはファイルを処理するスクリプトの実行をずっと簡単にします。
| 説明: | 特定のハンドラやコンテントタイプに対して CGI を実行するように 設定 |
|---|---|
| 構文: | Action action-type cgi-script [virtual] |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_actions |
| 互換性: | virtual 修飾子とハンドラ渡しは
Apache 2.1 で導入されました |
このディレクティブは action-type
がリクエストされたときに cgi-script
が実行されるという動作を追加します。cgi-script は
ScriptAlias や
AddHandler によって
CGI スクリプトに設定されたリソースへの URL-path です。
Action-type には
handler か MIME
コンテントタイプを指定できます。リクエストされたドキュメントの URL
とファイルのパスは標準 CGI 環境変数 PATH_INFO と
PATH_TRANSLATED を使って伝えられます。
特定のリクエストに対して使用されるハンドラへは、
REDIRECT_HANDLER 変数を使って渡せます。
# Requests for files of a particular MIME content type:
Action image/gif /cgi-bin/images.cgi
# Files of a particular file extension
AddHandler my-file-type .xyz
Action my-file-type /cgi-bin/program.cgi
最初の例では、MIME コンテントタイプが image/gif
のファイルへのリクエストは、指定したスクリプト
/cgi-bin/images.cgi で処理されます。
2 番目の例では、拡張子が .xyz
のファイルへのリクエストは、指定したスクリプト
/cgi-bin/program.cgi で処理されます。
オプションの virtual 修飾子を使用すると、
リクエストされたファイルが実際に存在するかどうかを検査しないようにできます。
これは例えば、Action ディレクティブをバーチャルな
Location に使用したい、といった場合に便利です。
<Location /news>
SetHandler news-handler
Action news-handler /cgi-bin/news.cgi virtual
</Location>
| 説明: | 特定のリクエストメソッドに対して CGI スクリプトを 実行するように設定 |
|---|---|
| 構文: | Script method cgi-script |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Base |
| モジュール: | mod_actions |
このディレクティブは method
というメソッドを使ってリクエストが行なわれたときに
cgi-script を実行するという動作を追加します。
cgi-script は
ScriptAlias や
AddHandler によって
CGI スクリプトに設定されたリソースへの URL-path です。
リクエストされたドキュメントの URL とファイルのパスは標準 CGI
環境変数 PATH_INFO と PATH_TRANSLATED
を使って伝えられます。
Script PUT と Script put
はまったく違った効果になります。
Script コマンドはデフォルトの動作を
追加するだけであることに
注意してください。もし CGI スクリプトが呼ばれたり、リクエストされた
メソッドを内部で扱うことのできる他のリソースがあれば、それが行なわれます。
GET メソッドの Script は問合せ
引数がある場合にのみ
(たとえば、foo.html?hi) 呼ばれるということにも注意してください。
そうでない場合は、リクエストは通常通り処理されます。
# For <ISINDEX>-style searching
Script GET /cgi-bin/search
# A CGI PUT handler
Script PUT /~bob/put.cgi
Apache HTTP サーバ バージョン 2.4
| 説明: | ホストファイルシステム上のいろいろな違う場所を ドキュメントツリーにマップする機能と、 URL のリダイレクトを行なう機能を提供する |
|---|---|
| ステータス: | Base |
| モジュール識別子: | alias_module |
| ソースファイル: | mod_alias.c |
このモジュールのディレクティブはサーバにリクエストが到着したときに
URL の操作や制御をすることを可能にします。Alias
ディレクティブと ScriptAlias
ディレクティブは
URL とファイルシステムのパスをマップするために使用されます。これは
DocumentRoot
の下にないドキュメントをウェブのドキュメントツリーの一部として
送られるようにします。ScriptAlias
ディレクティブにはマップ先のディレクトリが CGI
スクリプトのみであることを示すという追加の効果があります。
Redirect ディレクティブは
クライアントに違った
URL に新しいリクエストを送るように指示します。これは、
リソースが新しい場所に移動したときによく使用されます。
mod_alias は簡単な URL 操作向けに設計されています。
より複雑な操作、クエリーストリングの操作には、mod_rewrite
で提供されるツールを使用してください。
Alias AliasMatch AliasPreservePath Redirect RedirectMatch RedirectPermanent RedirectRelative RedirectTemp ScriptAlias ScriptAliasMatch様々なコンテキスト中での Alias や Redirect は他のディレクティブと
同じように標準の マージ規則 に
従って処理されます。ただし、(例えば <VirtualHost> セクションの中のように) 複数の Alias や Redirect が
同じコンテキスト中に現れた場合は決まった順番で処理されます。
まず、Alias の前にすべての Redirect が処理されます。ですから、Redirect か RedirectMatch にマッチするリクエストには
Alias は決して適用されません。次に、Alias と Redirect が設定ファイル中の
順番に適用され、最初にマッチしたものが優先されます。
ですから、二つ以上のディレクティブが同じパスに適用されるときは、 すべてのディレクティブの効果を得るためにはより詳しいパスを先に書く 必要があります。例えば、次の設定は期待通りの動作をします:
Alias /foo/bar /baz
Alias /foo /gaq
しかし、上記の二つのディレクティブの順番が逆になると、
/foo Alias が
常に /foo/bar Alias より先にマッチしますので、後者は
決して適用されることはありません。
| 説明: | URL をファイルシステムの位置にマップする |
|---|---|
| 構文: | Alias URL-path
file-path|directory-path |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_alias |
Alias ディレクティブはドキュメントを
ローカルファイルシステムの
DocumentRoot
以外の場所に保管することを可能にします。
URL の (% が復号された) パスが url-path で始まるものは
directory-filename
で始まるローカルファイルにマップされます。
Alias /image /ftp/pub/image
http://myserver/image/foo.gif へのリクエストに対して、サーバは ファイル /ftp/pub/image/foo.gif を返します。
もし url-path の最後に /
を書いたなら、サーバがエイリアスを展開するためには、最後の /
が必要になることに注意してください。すなわち、Alias /icons/
/usr/local/apache/icons/ というものを使用している場合は、
/icons という url はエイリアスされません。
エイリアスの行き先を含んでいる <Directory>
セクションを追加する必要があるかもしれないことに注意してください。
エイリアスの展開は <Directory>
セクションを調べる前に行なわれますので、
エイリアスの行き先の <Directory> セクションのみ
効果があります。
(しかし、<Location>
セクションはエイリアスが処理される前に実行されますので、
こちらは適用されます。)
特に、Alias を
DocumentRoot
ディレクトリの外側に配置した場合は、行き先のディレクトリに対する
アクセス権限を明示的に制限しなければならないでしょう。
Alias /image /ftp/pub/image
<Directory /ftp/pub/image>
Order allow,deny
Allow from all
</Directory>
| 説明: | 正規表現を使って URL をファイルシステムの位置にマップする |
|---|---|
| 構文: | AliasMatch regex
file-path|directory-path |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_alias |
このディレクティブは Alias
とほとんど同じですが、簡単な先頭からのマッチを行なうのではなく、
標準正規表現を利用します。ここで指定された正規表現と URL のパス
が合うかどうかを調べ、合う場合は括弧で括られたマッチを
与えられた文字列で置き換え、それをファイル名として使用します。たとえば、
/icons ディレクトリを使う
ためには以下のようなものが使用できます:
AliasMatch ^/icons(.*) /usr/local/apache/icons$1
| 説明: | Map the full path after the alias in a location. |
|---|---|
| 構文: | AliasPreservePath OFF|ON |
| デフォルト: | AliasPreservePath OFF |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Base |
| モジュール: | mod_alias |
| 互換性: | 2.4.58 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | クライアントが違う URL を取得するように外部へのリダイレクトを 送る |
|---|---|
| 構文: | Redirect [status] URL-path
URL |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_alias |
Redirect ディレクティブは古い URL を新しいものへマップします。 新しい URL がクライアントに返されます。そして、 クライアントは新しいアドレスをもう一回取得しようとします。 URL-path (% が復号された) パスで始まるドキュメントへの すべてのリクエストは URL で始まる新しい (% が符号化された) URL へのリダイレクトエラーが返されます。
Redirect /service http://foo2.bar.com/service
クライアントは http://myserver/service/foo.txt へのリクエストを行なうと、代わりに http://foo2.bar.com/service/foo.txt をアクセスするように告げられます。
設定ファイル中の順番に関わらず、
Redirect 系のディレクティブは Alias
ディレクティブと ScriptAlias ディレクティブよりも優先されます。
また、.htaccess ファイルや <Directory>
セクションの中で使われていたとしても、URL-path
は相対パスではなく、完全な URL でなければなりません。
もし status 引数が与えられていなければ、リダイレクトは "temporary" (HTTP ステータス 302) になります。これはクライアントに リソースが一時的に移動したということを示します。Status 引数は 他の HTTP のステータスコードを返すために使用することができます:
Status の値にステータスコードを数値で与えることで
他のステータスコードも返すことができます。ステータスが 300 と 399
の間にある場合、url 引数は存在していなければいけません。
その他の場合は省略されていなければなりません。ただし、
ステータスは Apache のコードが知っているものである必要があります
(http_protocol.c の関数 send_error_response
を見てください)。
例:
Redirect permanent /one http://example.com/two
Redirect 303 /three http://example.com/other
| 説明: | 現在の URL への正規表現のマッチにより 外部へのリダイレクトを送る |
|---|---|
| 構文: | RedirectMatch [status] regex
URL |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_alias |
このディレクティブは Redirect
とほとんど同じですが、簡単な先頭からのマッチを行なうのではなく、
標準正規表現を利用します。ここで指定された正規表現と URL-path
が合うかどうかを調べ、合う場合は括弧で括られたマッチを
与えられた文字列で置き換え、それをファイル名として使用します。
たとえば、すべての GIF ファイルを別サーバの同様な名前の JPEG
ファイルにリダイレクトするには、以下のようなものを使います:
RedirectMatch (.*)\.gif$ http://www.anotherserver.com$1.jpg
| 説明: | クライアントが違う URL を取得するように外部への永久的な リダイレクトを送る |
|---|---|
| 構文: | RedirectPermanent URL-path URL |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_alias |
このディレクティブはクライアントに Redirect が永久的なもの
(ステータス 301) であることを知らせます。
Redirect permanent とまったく同じです。
| 説明: | Allows relative redirect targets. |
|---|---|
| 構文: | RedirectRelative On|Off |
| デフォルト: | RedirectRelative Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Base |
| モジュール: | mod_alias |
| 互換性: | 2.4.58 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | クライアントが違う URL を取得するように外部への一時的な リダイレクトを送る |
|---|---|
| 構文: | RedirectTemp URL-path URL |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_alias |
このディレクティブはクライアントに Redirect
が一時的なものである (ステータス 302) ことを知らせます。
Redirect temp とまったく同じです。
| 説明: | URL をファイルシステムの位置へマップし、マップ先を CGI スクリプトに指定 |
|---|---|
| 構文: | ScriptAlias URL-path
file-path|directory-path |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_alias |
ScriptAlias ディレクティブは、対象ディレクトリに
mod_cgi の cgi-script
ハンドラで処理される CGI
スクリプトがあることを示す以外は
Alias
ディレクティブと同じ振る舞いをします。
URL の (% が復号された) パスが URL-path で始まるものは
ローカルのファイルシステムの
フルパスである二番目の引数にマップされます。
ScriptAlias /cgi-bin/ /web/cgi-bin/
http://myserver/cgi-bin/foo
へのリクエストに対してサーバはスクリプト
/web/cgi-bin/foo を実行します。
| 説明: | URL を正規表現を使ってファイルシステムの位置へマップし、マップ先を CGI スクリプトに指定 |
|---|---|
| 構文: | ScriptAliasMatch regex
file-path|directory-path |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_alias |
このディレクティブは ScriptAlias
とほとんど同じですが、簡単な先頭からのマッチを行なうのではなく、
標準正規表現を利用します。ここで指定された正規表現と URL-path
が合うかどうかを調べ、合う場合は括弧で括られたマッチを
与えられた文字列で置き換え、それをファイル名として使用します。
たとえば、標準の /cgi-bin
を使用するようにするためには、以下のようなものを使います:
ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1
Apache HTTP Server Version 2.4
| : | Ͻý ٸ κе ϰ, URL ̷ Ѵ |
|---|---|
| : | Base |
| : | alias_module |
| ҽ: | mod_alias.c |
ϴ þ Ͽ û
URL ϰų ִ. Alias ScriptAlias þ URL
Ͻý η Ѵ. DocumentRoot Ʒ
ִ. , ScriptAlias þ
丮 CGI ũƮۿ ٰ ˸.
Redirect þ
Ŭ̾Ʈ ٸ URL ο û ϵ Ѵ.
ڿ ο ҷ ű Ѵ.
mod_alias URL
Ǿ. ǹڿ ۰ ۾
mod_rewrite ϴ ̿϶.
Alias AliasMatch AliasPreservePath Redirect RedirectMatch RedirectPermanent RedirectRelative RedirectTemp ScriptAlias ScriptAliasMatch ٸ ҿ Alias Redirect ϸ ٸ þ
ǥ
óѴ. ҿ ( , <VirtualHost> ǿ)
Alias Redirect ϸ Ʒ óѴ.
Redirect ó Alias óѴ.
Redirect RedirectMatch شϴ û
Alias ʴ´. Alias Redirect Ͽ
ù° Ѵ.
þ ο شϴ þ ϱؼ θ ؾ Ѵ. , ǵѴ Ѵ:
Alias /foo/bar /baz
Alias /foo /gaq
| : | URL Ư Ͻý ҷ Ѵ |
|---|---|
| : | Alias URL-path
file-path|directory-path |
| : | ּ, ȣƮ |
| : | Base |
| : | mod_alias |
Alias þ ϸ Ͻýۿ
DocumentRoot ۿ ִ
ִ. url-path ϴ
(% ڵ) URL directory-path ϴ
Ͽ Ѵ.
Alias /image /ftp/pub/image
http://myserver/image/foo.gif ûϸ /ftp/pub/image/foo.gif Ѱش.
url-path / ϸ, URL /
ؾ߸ ϶. , Alias /icons/
/usr/local/apache/icons/ url /icons
谡 .
ϴ <Directory>
ʿ . þ <Directory> ˻ϱ
óϹǷ, ´. (
<Location>
þ óϱ ѹ ˻ϹǷ
URL ü ش.)
Ư DocumentRoot
ۿ ִ 丮 Alias ٸ,
丮 Ѵ.
Alias /image /ftp/pub/image
<Directory /ftp/pub/image>
Order allow,deny
Allow from all
</Directory>
| : | ǥ Ͽ URL Ͻý ҷ Ѵ |
|---|---|
| : | AliasMatch regex
file-path|directory-path |
| : | ּ, ȣƮ |
| : | Base |
| : | mod_alias |
þ Alias
, URL պκи ϴ ǥ ǥ
Ѵ. ǥ URL ο Ͽ ´ٸ,
ȣ κ üϿ ϸ Ѵ.
, /icons 丮
ִ:
AliasMatch ^/icons(.*) /usr/local/apache/icons$1
| : | Map the full path after the alias in a location. |
|---|---|
| : | AliasPreservePath OFF|ON |
| ⺻: | AliasPreservePath OFF |
| : | ּ, ȣƮ, directory |
| : | Base |
| : | mod_alias |
| : | 2.4.58 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | Ŭ̾Ʈ ٸ URL ϵ ûϴ ܺ ̷ |
|---|---|
| : | Redirect [status] URL-path
URL |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_alias |
Redirect þ URL ο URL Ѵ. Ŭ̾Ʈ ο URL , Ŭ̾Ʈ ο ּҷ ٽ ѹ Ѵ. (% ڵ) URL-path ϴ û (% ڵ) URL ϴ ο URL ̷ .
Redirect /service http://foo2.bar.com/service
Ŭ̾Ʈ http://myserver/service/foo.txt ûϸ http://foo2.bar.com/service/foo.txt ϶ ´.
Redirect þ Ͽ
Alias ScriptAlias þ 켱
. , .htaccess ̳ <Directory> ǿ ϴ
URL-path ΰ ƴ϶ ݵ URL
ؾ Ѵ.
status ƱԸƮ , "ӽ (temporary)" (HTTP 302) ̷ . , Ŭ̾Ʈ ڿ ӽ÷ Űٰ ˸. status ƱԸƮ Ͽ ٸ HTTP ڵ带 ȯ ִ:
status ڵ带 Ͽ ٸ ڵ嵵
ȯ ִ. ° 300 399 ̶ URL
ƱԸƮ ؾ ϰ, ƴ϶ ؾ Ѵ. , ġ
ڵ忡 ° ǵ־ Ѵ (http_protocol.c
send_error_response Լ ).
Redirect permanent /one http://example.com/two
Redirect 303 /three http://example.com/other
| : | URL ǥĿ شϸ ܺ ̷ |
|---|---|
| : | RedirectMatch [status] regex
URL |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_alias |
þ Redirect ,
URL պκи ϴ ǥ ǥ Ѵ.
ǥ URL ο Ͽ ´ٸ, ȣ
κ üϿ ϸ Ѵ. ,
GIF û ٸ ̸
JPEG Ϸ ̷ :
RedirectMatch (.*)\.gif$ http://www.anotherserver.com$1.jpg
| : | Ŭ̾Ʈ ٸ URL ϵ ûϴ ܺ ̷ |
|---|---|
| : | RedirectPermanent URL-path URL |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_alias |
þ Ŭ̾Ʈ ̷ (
301) ˸. Redirect permanent Ȯ .
| : | Allows relative redirect targets. |
|---|---|
| : | RedirectRelative On|Off |
| ⺻: | RedirectRelative Off |
| : | ּ, ȣƮ, directory |
| : | Base |
| : | mod_alias |
| : | 2.4.58 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | Ŭ̾Ʈ ٸ URL ϵ ûϴ ܺ ӽ ̷ |
|---|---|
| : | RedirectTemp URL-path URL |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_alias |
þ Ŭ̾Ʈ ̷ ӽ (
302) ˸. Redirect temp Ȯ .
| : | URL Ư Ͻý ҷ ϰ CGI ũƮ ˸ |
|---|---|
| : | ScriptAlias URL-path
file-path|directory-path |
| : | ּ, ȣƮ |
| : | Base |
| : | mod_alias |
ScriptAlias þ Alias þ ,
߰ 丮 mod_cgi cgi-script
ڵ鷯 ó CGI ũƮ ִٰ ˸.
URL-path ϴ (% ڵ) URL Ͻý
ι° ƱԸƮ ϴ ũƮ Ѵ.
ScriptAlias /cgi-bin/ /web/cgi-bin/
http://myserver/cgi-bin/foo ûϸ
/web/cgi-bin/foo ũƮ Ѵ.
| : | ǥ Ͽ URL Ư Ͻý ҷ ϰ CGI ũƮ ˸ |
|---|---|
| : | ScriptAliasMatch regex
file-path|directory-path |
| : | ּ, ȣƮ |
| : | Base |
| : | mod_alias |
þ ScriptAlias ,
URL պκи ϴ ǥ ǥ Ѵ.
ǥ URL ο Ͽ ´ٸ, ȣ
κ üϿ ϸ Ѵ. ,
ǥ /cgi-bin ִ:
ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1
Apache HTTP Server Version 2.4
| : | DBM |
|---|---|
| : | Extension |
| : | authn_dbm_module |
| ҽ: | mod_authn_dbm.c |
| : | ġ 2.1 ĺ |
mod_auth_digest
mod_auth_basic մܸ
dbm ȣϿ ڸ ãƼ Ѵ.
mod_authn_file Ѵ.
mod_auth_basic̳
mod_auth_digest Ҷ AuthBasicProvider
AuthDigestProvider
dbm ϸ Ѵ.
| : | ȣ ϴ ͺ̽ Ѵ |
|---|---|
| : | AuthDBMType default|SDBM|GDBM|NDBM|DB |
| ⺻: | AuthDBMType default |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Extension |
| : | mod_authn_dbm |
ȣ ϴ ͺ̽ Ѵ. ⺻ ͺ̽ ϶ ǴѴ. ִ ٸ ͺ̽ ȴ.
ȣ α ͺ̽ ϵ ؾ Ѵ.
| : | ڿ ȣ ϴ ͺ̽ ϸ Ѵ |
|---|---|
| : | AuthDBMUserFile file-path |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Extension |
| : | mod_authn_dbm |
AuthDBMUserFile þ
ڿ ȣ ϴ DBM ϸ
Ѵ. File-path ̴.
ڸ Ű Ѵ. ڿ ڵ ȣ̴. ȣ ڿ ݷа ִ. ݷа ڿ Ѵ.
AuthDBMUserFile
ۿ Ȯ϶. ȣ 丮 ȿ
. , Ŭ̾Ʈ
AuthDBMUserFile ٿε
ִ.
߿ ȣȯ : ġ dbmopen
ڿ NULL ʰ DBM ڷᱸ
ؽ̰ ڿ ̸ д´. Netscape
α ڿ NULL ٰ ϱ
α DBM ϸ ִ.
ġ dbmmanage Perl ũƮ Ѵ. α DBM ȣ Ѵ.
Apache HTTP Server Version 2.4
þ Ͽ þ ִ.
A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Evresiz ön çatallamalı HTTP sunucusu oluşturur |
|---|---|
| Durum: | MPM |
| Modül Betimleyici: | mpm_prefork_module |
| Kaynak Dosyası: | prefork.c |
Bu çok süreçlilik modülü (MPM) evresiz ve çocuk süreçlerin önceden çatallandığı bir HTTP sunucusu oluşturur. Her çocuk süreç gelen bir isteğe yanıt verirken ebeveyn süreç çocuk süreç havuzunu yönetir. Evresiz kütüphanelerle uyumluluk için evrelemeden kaçınma ihtiyacında olan siteler için uygundur. Ayrıca istekleri birbirlerinden yalıtmak için en iyi MPM’dir, dolayısıyla herhangi bir istekle ilgili bir sorun diğerlerini etkilemez.
Bu MPM kendi kendine her duruma çok iyi uyum sağladığından
yapılandırma yönergeleri ile yapılandırılmaya nadiren ihtiyaç gösterir.
Yönergelerin en önemlisi MaxRequestWorkers olup, değeri aynı anda almayı umduğunuz
istek sayısını işleyebilecek kadar büyük, fiziksel belleğin tüm
süreçlerin ihtiyaçlarını karşılamasına yetecek kadar da küçük olması
gerekir.
CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareServers MinSpareServers PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers UserBağlantıları dinleyip gerektiğinde onlara hizmet sunan çocuk süreçleri devreye almak tek bir denetim sürecinin sorumluluğundadır. Apache httpd daima, gelen isteklere hizmet vermeye hazır bekleyen en fazla sayıda sunucu sürecini yedekte tutmaya veya boşta bekletmeye çalışır. Bu suretle, istemcilere isteklerinin sunulması için yeni çocuk süreçlerin çatallanmasını beklemek gerekmez.
Ana sürecin istekleri sunacak çocuk süreçleri oluşturma işlemini nasıl
gerçekleştireceği StartServers, MinSpareServers, MaxSpareServers ve MaxRequestWorkers yönergeleri ile düzenlenir. Apache httpd
kendiliğinden her duruma çok iyi uyum sağladığından, genelde, çoğu
sitenin bu yönergelerin öntanımlı değerlerini değiştirmesi gerekmez.
Aynı anda 256’dan fazla isteğe hizmet sunacak sitelerin MaxRequestWorkers değerini arttırmaları
gerekebilir. Ancak, fiziksel belleği yeterli olmayan sitelerin de
sunucunun belleği diske takaslamasını önlemek için bu değeri
azaltmaları gerekebilir. Süreç oluşturmanın ayarlanması ile ilgili daha
fazla bilgi edinmek için başarım
arttırma ipuçları belgesine bakınız.
Unix altında 80. portu dinleyebilmek için ana sürecin
root tarafından çalıştırılmış olması gerekirse de çocuk
süreçler Apache httpd tarafından daha az yetkili bir kullanıcının
aidiyetinde çalıştırılırlar. Apache httpd’nin çocuk süreçlerinin
kullanıcı ve gruplarını ayarlamak için User ve Group
yönergeleri kullanılır. Çocuk süreçlerin sunacakları içeriği okumaya
yetkili olmaları gerekir, fakat bu yetkinin mümkün olduğunca kısıtlı
tutulmasına çalışılmalıdır.
MaxConnectionsPerChild
yönergesi ana sunucunun eski süreçleri öldürüp yenilerini oluşturmayı
ne kadar sıklıkla yapacağını denetler.
Bu MPM, gürleyen sürü sorunu ortaya çıktığında (genelde çok sayıda
dinlenen soket varlığında) gelen bağlantılara erişimi dizgileştirmek için
mpm-accept muteksini kullanır. Bu muteksin gerçeklenimle
ilgili hususları Mutex yönergesi ile
yapılandırılabilir. Bu muteks hakkında ek bilgi için başarımın arttırılması
belgesine bakınız.
| Açıklama: | Boştaki çocuk süreçlerin azami sayısı |
|---|---|
| Sözdizimi: | MaxSpareServers sayı |
| Öntanımlı: | MaxSpareServers 10 |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | prefork |
MaxSpareServers yönergesi boştaki
çocuk sunucu süreçlerinin azami sayısını belirler. Boştaki süreç, o an
bir isteğe hizmet sunmayan süreçtir. Eğer
MaxSpareServers sayıda süreçten daha fazla boşta
süreç varsa ana süreç bu fazlalıkları öldürecektir.
Bu parametrenin ayarlanması sadece çok meşgul siteler için gerekli
olabilir. Bu parametreye çok büyük bir değerin atanması oldukça kötü
bir fikirdir. Eğer bu değeri MinSpareServers değerine eşit veya daha küçük bir değere
ayarlarsanız, Apache HTTP Sunucusu bu değeri kendiliğinden MinSpareServers + 1 olarak
değiştirecektir.
| Açıklama: | Boştaki çocuk süreçlerin asgari sayısı |
|---|---|
| Sözdizimi: | MinSpareServers sayı |
| Öntanımlı: | MinSpareServers 5 |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | prefork |
MinSpareServers yönergesi boştaki
çocuk sunucu süreçlerinin asgari sayısını belirler. Boştaki süreç, o an
bir isteğe hizmet sunmayan süreçtir. Eğer
MinSpareServers sayıda süreçten daha az boşta
süreç varsa ana süreç sayıyı tamamlamak için yeni çocuk süreçler
oluşturacaktır: Bir tane oluşturur, 1 saniye bekler, sonra 2 tane
oluşturur, 1 saniye bekler, sonra 4 tane oluşturur ve saniyede 32 çocuk
süreç oluşturuluncaya kadar böyle üstel olarak artar. Artış
MinSpareServers ile belirlenen sayıda
duracaktır.
Bu parametrenin ayarlanması sadece çok meşgul siteler için gerekli olabilir. Bu parametreye çok büyük bir değerin atanması oldukça kötü bir fikirdir.
Apache HTTP サーバ バージョン 2.4
| 説明: | 自分用の HTTP ヘッダの書かれているファイルを送信する |
|---|---|
| ステータス: | Base |
| モジュール識別子: | asis_module |
| ソースファイル: | mod_asis.c |
このモジュールはハンドラ send-as-is
を提供します。このハンドラは通常の HTTP
ヘッダをほとんど追加することなくドキュメントを送信します。
これはサーバからどんな種類のデータを送るときにも使用できます。 Cgi スクリプトや nph スクリプトが無くてもリダイレクトや他の特別な HTTP 応答を送ることができます。
歴史的な理由により、このモジュールは mime タイプ
httpd/send-as-is のファイルも処理します。
このモジュールにディレクティブはありません。
サーバ設定ファイルで、ファイルと send-as-is
ハンドラを例えば以下のように関連付けてください。
AddHandler send-as-is asis
拡張子が .asis のすべてのファイルの内容は Apache
からクライアントへほとんど変更無く送られます。
HTTP ヘッダは特別で、ファイルから mod_cgi
のルールに従って取り出されます。ですから asis ファイルには
正しいヘッダが記載されていなければなりませし、
また CGI での表記法であるところの Status: ヘッダを使って
HTTP レスポンスコードを決めることもできます。
これはクライアントにファイルが移動したことを知らせるために as is (そのまま) で送られるファイルの内容の例です。
Status: 301 Now where did I leave that URL
Location: http://xyz.abc.com/foo/bar.html
Content-type: text/html
<html>
<head>
<title>Lame excuses'R'us</title>
</head>
<body>
<h1>Fred's exceptionally wonderful page has moved to
<a href="http://xyz.abc.com/foo/bar.html">Joe's</a>
site.
</h1>
</body>
</html>
注意: サーバはクライアントに返されるデータに常に Date:
と Server: ヘッダを追加しますので、
それらがファイルに書かれていてはいけません。
サーバは Last-Modified ヘッダを追加しません。
おそらくはそうすべきでしょうけれど。
Apache HTTP サーバ バージョン 2.4
| 説明: | URI をキーにしたコンテンツキャッシュストレージ管理 |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | cache_disk_module |
| ソースファイル: | mod_cache_disk.c |
mod_cache_disk はディスクを使用したストレージ
管理機構を実装しています。主に
mod_cache と組み合わせて使われます。
コンテンツのキャッシュへの保存と取得は URI に基づいたキーが使われます。 アクセス保護のかけられているコンテンツはキャッシュされません。
キャッシュの大きさを最大レベルで維持するために
htcacheclean を使うことができます。
mod_cache_disk は
mod_cache を必要とします
CacheDirLength CacheDirLevels CacheMaxFileSize CacheMinFileSize CacheReadSize CacheReadTime CacheRoot| 説明: | サブディレクトリ名の文字数 |
|---|---|
| 構文: | CacheDirLength length |
| デフォルト: | CacheDirLength 2 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache_disk |
CacheDirLength ディレクティブはキャッシュ
階層の各サブディレクトリの文字数を設定します。
CacheDirLevels と組み合わせて設定することで、
キャッシュ階層のおおよその構造を決めることができます。
CacheDirLength が大きくて
CacheDirLevels が小さい場合、
比較的浅い階層になりますが、
各階層のサブディレクトリの数は多くなります。
CacheDirLevels*
CacheDirLength の
結果は 20 以内でなければなりません。
| 説明: | キャッシュのサブディレクトリの深さの数 |
|---|---|
| 構文: | CacheDirLevels levels |
| デフォルト: | CacheDirLevels 2 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache_disk |
CacheDirLevels ディレクティブはキャッシュの
サブディレクトリの深さを設定します。キャッシュデータは CacheRoot ディレクトリから
このディレクトリの深さ分下のディレクトリに保存されます。
CacheDirLevels が大きくて
CacheDirLength が小さい場合、
比較的深い階層になりますが、
各階層のサブディレクトリの数は少なくなります。
CacheDirLevels*
CacheDirLength の
結果は 20 以内でなければなりません。
| 説明: | キャッシュに保管されるドキュメントの最大の (バイトでの) サイズ |
|---|---|
| 構文: | CacheMaxFileSize bytes |
| デフォルト: | CacheMaxFileSize 1000000 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache_disk |
CacheMaxFileSize ディレクティブは、ドキュメントを
キャッシュするかどうかを判定する、最大のサイズをバイト数で設定します。
CacheMaxFileSize 64000
| 説明: | キャッシュに保管されるドキュメントの最小限の (バイトでの) 大きさ |
|---|---|
| 構文: | CacheMinFileSize bytes |
| デフォルト: | CacheMinFileSize 1 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache_disk |
CacheMinFileSize ディレクティブは、ドキュメントを
キャッシュするかどうかを判定する、最小のサイズをバイト数で設定します。
CacheMinFileSize 64
| 説明: | The minimum size (in bytes) of the document to read and be cached before sending the data downstream |
|---|---|
| 構文: | |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Extension |
| モジュール: | mod_cache_disk |
Documentation not yet translated. Please see English version of document.
| 説明: | The minimum time (in milliseconds) that should elapse while reading before data is sent downstream |
|---|---|
| 構文: | |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Extension |
| モジュール: | mod_cache_disk |
Documentation not yet translated. Please see English version of document.
| 説明: | キャッシュファイルが保管されるルートディレクトリ |
|---|---|
| 構文: | CacheRoot directory |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache_disk |
CacheRoot ディレクティブはキャッシュファイルを
保管するためのディスク上のディレクトリを指定します。mod_cache_disk モジュールが Apache サーバにロードされて
いるか、組み込まれていれば、このディレクティブは必ず
定義しなければなりません。
CacheRoot の値を指定しなければ、
設定ファイルの処理でエラーになります。CacheDirLevels ディレクティブと CacheDirLength ディレクティブが
指定されたルートディレクトリ下のディレクトリ構成を定義します。
CacheRoot c:/cacheroot
Apache HTTP Server Version 2.4
| : | MD5 Digest Authentication . |
|---|---|
| : | Experimental |
| : | auth_digest_module |
| ҽ: | mod_auth_digest.c |
HTTP Digest Authentication Ѵ. Ʈ ġ ̴.
AuthDigestAlgorithm AuthDigestDomain AuthDigestNonceLifetime AuthDigestProvider AuthDigestQop AuthDigestShmemSizeMD5 Digest authentication ſ ִ.
AuthType Basic AuthBasicProvider
AuthType Digest AuthDigestProvider
Ͽ ִ. ּ ȣϷ
⺻ URI AuthDigestDomain þ Ѵ.
htdigest Ͽ () ִ.
<Location /private/>
AuthType Digest
AuthName "private area"
AuthDigestDomain /private/ http://mirror.my.dom/private2/
AuthDigestProvider file
AuthUserFile /web/auth/.digest_pw
Require valid-user
</Location>
Digest authentication Basic authentication , ؾ Ѵ. 2002 11 digest authentication ϴ Amaya, Konqueror, (Windows ǹڿ Բ ϸ ȵ - ذ Ʒ "MS Internet Explorer ذϱ" ) Mac OS X Windows MS Internet Explorer, Mozilla, Netscape 7, Opera, Safari ִ. lynx digest authentication ʴ´. digest authentication basic authentication ŭ θ ʾұ ڰ ϴ ϴ 쿡 ؾ Ѵ.
Windows Internet Explorer Digest authentication
ǹڿ ִ GET û RFC ٸ
óϴ ִ. ذ
ִ.
ù° α ڷḦ Ѱֱ GET
POST û ϴ ̴.
ϴٸ ذå̴.
, ġ 2.0.51 AuthDigestEnableQueryStringHack
ȯ溯 Ͽ ذѴ. û
AuthDigestEnableQueryStringHack ϸ
ġ MSIE ذ ġ ϰ û URI digest
Ѵ. Ѵ.
BrowserMatch "MSIE" AuthDigestEnableQueryStringHack=On
ȯ溯 ڼ BrowserMatch þ
϶.
| : | digest authentication challenge response hash ϴ ˰ Ѵ |
|---|---|
| : | AuthDigestAlgorithm MD5|MD5-sess |
| ⺻: | AuthDigestAlgorithm MD5 |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Experimental |
| : | mod_auth_digest |
AuthDigestAlgorithm þ
challenge response hash ϴ ˰ Ѵ.
MD5-sess ʾҴ.
| : | digest authentication ȣ ϴ URI |
|---|---|
| : | AuthDigestDomain URI [URI] ... |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Experimental |
| : | mod_auth_digest |
AuthDigestDomain þ
ȣ ִ ( ڸ/ȣ
ϴ) URI Ѵ. URI λ
Ѵ. Ŭ̾Ʈ URI "Ʒ" θ
ڸ/ȣ ȣѴٰ Ѵ. URI
(, Ŵ(scheme), ȣƮ, Ʈ ϴ)
URL̰ų URI̴.
þ ؾ ϸ, ּ
⺻ URI() ؾ Ѵ. ϸ Ŭ̾Ʈ
û Authorization
Ѵ. û ũⰡ Ŀ, AuthDigestNcCheck
Ѵٸ ɿ ִ.
ٸ URI ϸ, (̸ ϴ) Ŭ̾Ʈ Ź ڿ ʰ ڸ/ȣ ִ.
| : | nonce ȿ Ⱓ |
|---|---|
| : | AuthDigestNonceLifetime seconds |
| ⺻: | AuthDigestNonceLifetime 300 |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Experimental |
| : | mod_auth_digest |
AuthDigestNonceLifetime þ
nonce ȿ Ⱓ Ѵ. Ŭ̾Ʈ
nonce ϸ stale=true
Բ 401 ȯѴ. seconds 0 ũ nonce
ȿ Ⱓ Ѵ. Ƹ 10 ʺ ۰ ϸ ȵȴ.
seconds 0 nonce
ʴ´.
| : | ġ ڸ Ѵ |
|---|---|
| : | AuthDigestProvider On|Off|provider-name
[provider-name] ... |
| ⺻: | AuthDigestProvider On |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Experimental |
| : | mod_auth_digest |
AuthDigestProvider þ
ġ ڸ ڸ Ѵ.
On̸ ⺻(file) Ѵ.
mod_authn_file file
ڸ ϱ ִ Ȯؾ
Ѵ.
ڴ mod_authn_dbm
mod_authn_file ϶.
Off̸ ⺻·
ư.
| : | digest authentication ȣ(quality-of-protection) Ѵ. |
|---|---|
| : | AuthDigestQop none|auth|auth-int [auth|auth-int] |
| ⺻: | AuthDigestQop auth |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Experimental |
| : | mod_auth_digest |
AuthDigestQop þ
ȣ(quality-of-protection) Ѵ.
auth (ڸ/ȣ) ϰ,
auth-int ϰἺ ˻縦 (MD5 ؽ
Ͽ ˻Ѵ) Ѵ. none (ϰἺ ˻縦
ʴ) RFC-2069 digest ˰ Ѵ.
auth auth-int
ִ. Ѵ.
challenge ʴ´ٸ
none ؾ Ѵ.
auth-int ʾҴ.
| : | Ŭ̾Ʈ ϱ Ҵϴ |
|---|---|
| : | AuthDigestShmemSize size |
| ⺻: | AuthDigestShmemSize 1000 |
| : | ּ |
| : | Experimental |
| : | mod_auth_digest |
AuthDigestShmemSize þ
Ŭ̾Ʈ ϱ Ҷ Ҵϴ
Ѵ. ּ ϳ
Ŭ̾Ʈ ϱ ʿ
϶. ýۿ ٸ. Ȯ ˷
AuthDigestShmemSize 0
ϰ ϶.
size Ʈ , ڿ
K M Ͽ KBytes MBytes
Ÿ ִ. , þ :
AuthDigestShmemSize 1048576
AuthDigestShmemSize 1024K
AuthDigestShmemSize 1M
Apache HTTP サーバ バージョン 2.4
| 説明: | DBM ファイルを用いたユーザ認証 |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | authn_dbm_module |
| ソースファイル: | mod_authn_dbm.c |
| 互換性: | Apache 2.1 以降 |
本モジュールは mod_auth_digest や
mod_auth_basic といった認証フロントエンドに対して、
dbm パスワードファイル内からのユーザ検索による
ユーザ認証機能を提供します。似たような機能は mod_authn_file
でも提供されています。
mod_auth_basic や mod_auth_digest
を使用する際には、このモジュールは
AuthBasicProvider や
AuthDigestPrivider
で dbm と指定することで起動されます。
| 説明: | パスワードを保存するために必要なデータベースファイルの種類を 設定する |
|---|---|
| 構文: | AuthDBMType default|SDBM|GDBM|NDBM|DB |
| デフォルト: | AuthDBMType default |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Extension |
| モジュール: | mod_authn_dbm |
パスワードを保存するために使用するデータベースファイルの種類を 設定します。デフォルトのデータベースの種類はコンパイル時に決まります。 他の種類のデータベースが使用可能かどうかも コンパイル時の設定に依存します。
パスワードファイルを作成するのに使用するプログラムが同じ種類のデータベースを 使用するように設定することは非常に重要です。
| 説明: | 認証用のユーザとパスワードのリストを保持している データベースファイル名を設定する |
|---|---|
| 構文: | AuthDBMUserFile file-path |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Extension |
| モジュール: | mod_authn_dbm |
AuthDBMUserFile ディレクティブは
認証用のユーザとパスワードのリストを保持している DBM ファイルの
名前を設定します。File-path はユーザファイルへの
絶対パスです。
ユーザファイルのキーはユーザ名です。ユーザに対して返される値は 暗号化されたパスワードで、その後に、コロンに続いて任意のデータが 続いていることもあります。コロンとその後のデータはサーバは 無視します。
AuthDBMUserFile は、
ウェブサーバのドキュメントツリーの外側に保管するようにしてください。
保護しようとしているディレクトリ以下には
置かないで下さい。
そうしないとクライアントが AuthUserFile を
ダウンロードできてしまいます。
重要な互換性に関する注意: apache module の dbmopen の実装は
文字列が NULL で終わっていることに依存するのではなく、DBM データストラクチャ
のハッシュ値の文字列の長さを読み取ります。Netscape ウェブサーバなど、
アプリケーションの中には文字列が NULL で終わっていることに依存している
ものがあります。ですから、異なるアプリケーション間での DBM ファイルの
使用に問題がある場合は、これが原因になっている可能性があります。
Apache には dbmmanage という
perl スクリプトが含まれています。このプログラムを使ってこの
モジュールが使用する DBM フォーマットのパスワードファイルを作成したり
更新したりすることができます。
Apache HTTP Server Version 2.4
| : | "(anonymous)" Ѵ |
|---|---|
| : | Extension |
| : | authn_anon_module |
| ҽ: | mod_authn_anon.c |
| : | ġ 2.1 ĺ |
mod_auth_basic մܸ
( 'Ư' ̵ 'anonymous'
ڿ ּҸ ȣ ϴ) -ftp Ʈ
Ѵ. ڿ ּҸ α ִ.
ٸ (ͺ̽) İ Բ Ͽ '' ڿ Ʈ θ鼭 ȿ ǰ ϴ. Ű URL λ/̻ ̰ ڰ URL ִٴ ִ.
mod_auth_basic Ҷ AuthBasicProvider
anon ϸ Ѵ.
"Ϲ" htpasswd-ϱ ߰ ڰ Ѵٸ 'մ(guest)' ֵ Ѵ:
Anonymous_NoUserID)Anonymous_MustGiveEmail)Anonymous_VerifyEmail)anonymous guest www test
welcome ϳ̸, ҹڸ
ʴ´. (Anonymous)Anonymous_LogEmail)
<Directory /foo>
AuthName "մ 湮Ϸ 'anonymous' ڿ ּҸ ϶"
AuthType Basic
AuthBasicProvider file anon
AuthUserFile /path/to/your/.htpasswd
Anonymous_NoUserID off
Anonymous_MustGiveEmail on
Anonymous_VerifyEmail on
Anonymous_LogEmail on
Anonymous anonymous guest www test welcome
Order Deny,Allow
Allow from all
Require valid-user
</Directory>
| : | ȣ˻ ̵ Ѵ |
|---|---|
| : | Anonymous user [user] ... |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Extension |
| : | mod_authn_anon |
ȣ˻ 'Ư' ̵ . ̵ Ѵ. ǥ ' " Ż \ Ͽ ̵ ȿ ִ.
̵ ҹڸ
϶.
̵ Ư ڸ
'anonymous' ϱ Ѵ.
Anonymous anonymous "Not Registered" "I don't know"
"anonymous", "AnonyMous", "Not Registered", "I Don't Know" ̵ ϸ ȣ˻ ڸ Ѵ.
ġ 2.1 ̵ "*"
ִ. ̵
Ƶδ.
| : | Է ȣ α |
|---|---|
| : | Anonymous_LogEmail On|Off |
| ⺻: | Anonymous_LogEmail On |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Extension |
| : | mod_authn_anon |
⺻ On ϸ (Ƹ ڿ
ּ) Է 'ȣ' α Ѵ.
| : | ȣ |
|---|---|
| : | Anonymous_MustGiveEmail On|Off |
| ⺻: | Anonymous_MustGiveEmail On |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Extension |
| : | mod_authn_anon |
ڰ ȣ ڿ ּҸ Էؾ ϴ θ Ѵ. ȣ źѴ.
| : | ̵ |
|---|---|
| : | Anonymous_NoUserID On|Off |
| ⺻: | Anonymous_NoUserID Off |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Extension |
| : | mod_authn_anon |
On ϸ ڴ ̵
(Ƹ ȣ) Է ʾƵ ȴ. ̴ ڿ ׳
return ġų OK ư Ŭϴ MS-Explorer ڿ
ſ ϴ.
| : | ȣ ùٸ ڿ ּ ˻ |
|---|---|
| : | Anonymous_VerifyEmail On|Off |
| ⺻: | Anonymous_VerifyEmail Off |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Extension |
| : | mod_authn_anon |
On ϸ ڰ ùٸ ڿ
ּҸ Էϵ Է 'ȣ' ּ '@' '.' Ѱ
ϴ ˻Ѵ ( Anonymous_LogEmail ).
Apache HTTP Server Version 2.4
Hier sind alle Apache-Direktiven aufgeführt, die in der Standard-Apache-Distribution verfügbar sind. Sie sind in einem einheitlichen Format beschrieben. Ein Glossar erläutert die in der Beschreibung verwendeten Begriffe.
Außerdem existiert eine Kurzreferenz der Direktiven, welche zu jeder Direktive eine Zusammenfassung der Details enthält.
A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Unix ls veya Win32 dir kabuk komutunun
yaptığı gibi dizin içeriğini listeler. |
|---|---|
| Durum: | Temel |
| Modül Betimleyici: | autoindex_module |
| Kaynak Dosyası: | mod_autoindex.c |
Bir dizin içerik dosyası iki kaynaktan gelebilir:
index.html
adında bir dosya olarak. Kullanılan dosyanın veya dosyaların ismi
DirectoryIndex yönergesi ile
belirlenir ve mod_dir tarafından denetlenir.AddIcon, AddIconByEncoding ve AddIconByType yönergeleri ile
belirlenir. Bunlar mod_autoindex tarafından
denetlenir.İki işlev birbirinden ayrı tutulmuştur, böylece kendiliğinden içerik listesi üretimi tamamen iptal edilebilir (veya değiştirilebilir).
Kendiliğinden içerik listesi üretimi Options +Indexes ile
etkin kılınabilir. Daha fazla bilgi için Options yönergesinin açıklamasına bakınız.
IndexOptions yönergesi
FancyIndexing
seçeneği ile kullanılmışsa sütun başlıkları listenin sıralamasını
sütundaki sıralamaya göre değiştirecek hiper bağlar haline getirilir
(süslü liste). Aynı başlığa peşpeşe tıklamak suretiyle sıralamayı
büyükten küçüğe veya tersine değiştirebilirsiniz. Bu sütun başlığı
bağlarının oluşturulması IndexOptions yönergesi SuppressColumnSorting seçeneği ile kullanılarak
engellenebilir.
Boyuta göre sıralamada daima dosyanın asıl boyutuna bakılır. Dolayısıyla ikisi de "1K" olarak gösterilen iki dosyadan 1010 baytlık olanı küçükten büyüğe sıralamada 1011 baytlıktan önce gösterilecektir.
AddAlt AddAltByEncoding AddAltByType AddDescription AddIcon AddIconByEncoding AddIconByType DefaultIcon HeaderName IndexHeadInsert IndexIgnore IndexIgnoreReset IndexOptions IndexOrderDefault IndexStyleSheet ReadmeNameİstemciye, dizin içeriğini listelerken neleri hangi sırada
listeleyeceğini belirleyebilmesi için içerik üzerinde biraz denetim
sağlayabileceği çeşitli sorgu dizgesi bileşenleri sağlanmıştır.
Çıktı üzerinde kullanıcı denetimini tamamen ortadan kaldırmak için
IndexOptions yönergesinin
IgnoreClient
seçeneği kullanılabilir.
Sütun sıralama başlıklarının her biri hedefi kendisi olan birer hiper bağ olup aşağıda sıralanan sorgu seçeneklerini kullanırlar. Bu seçeneklerin her biri her dizin içerik listesi isteğine eklenebilir.
C=N dizini dosya adına göre sıralarC=M dizini son değişiklik zamanına ve ardından dosya
ismine göre sıralar.C=S dizini boyuta ve ardından dosya adına göre
sıralarC=D dizini açıklamaya ve ardından
dosya adına göre sıralar.O=A artan sıralama uygulanır.O=D azalan sıralama uygulanır.F=0 listeleme basit listeleme biçiminde yapılır
(FancyIndexing seçeneği ile etkinleştirilen biçimde
değil)F=1 listeleme FancyIndexing seçeneği ile
etkinleştirilen biçimde yapılırF=2 listeleme FancyIndexing ve
HTMLTable seçeneği
ile etkinleştirilen biçimde yapılır.V=0 sürüme göre sıralama iptal edilir.V=1 sürüme göre sıralama etkin
kılınır.P=kalıp sadece belirtilen
kalıp ile eşleşen dosyalar istelenir.P=kalıp sorgu seçeneğinin normalde IndexIgnore yönergesi işleme
sokulduktan sonra değerlendirildiğine ve dosya isimlerinin diğer
kendiliğinden içerik listeleme koşullarının konusu olmaya devam ettiğine
dikkat ediniz. mod_autoindex modülündeki Sorgu
Seçenekleri çözümleyicisi tanımadığı bir seçeneğe rastlar rastlamaz
işlemi durdurur. Sorgu Seçenekleri yukarıda belirtilene uygun olarak iyi
biçimli olmak zorundadır.
Aşağıdaki basit örnekte sorgu seçeneklerinin kullanımı gösterilmiştir.
Son satırda bulunan "submit" düğmesindeki tanınmayan "X" girdisine
dikkat ediniz. "X=Göster" girdisi tüm seçenekler işlendikten sonra
mod_autoindex tarafından son argüman olarak ele
alınacak ve çözümleme işlemi o noktada duracaktır.
<form action="" method="get">
<input type="text" name="P" value="*" /> ile eşleşen
<select name="C">
<option value="N" selected="selected">isme</option>
<option value="M"> değişiklik tarihine</option>
<option value="S"> boyuta</option>
<option value="D"> açıklamaya</option>
</select> göre
<select name="O">
<option value="A" selected="selected"> artan</option>
<option value="D"> azalan</option>
</select>
<select name="V">
<option value="0" selected="selected">normal</option>
<option value="1"> sürümlü</option>
</select> sıralamayla bir
<select name="F">
<option value="0"> basit liste</option>
<option value="1" selected="selected"> süslü liste</option>
<option value="2"> tablolu liste</option>
</select>
<input type="submit" name="X" value="Göster" />
</form>
| Açıklama: | Dosyaya göre seçilen simgenin yerinde gösterilecek metni belirler. |
|---|---|
| Sözdizimi: | AddAlt metin dosya [dosya] ... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
AddAlt yönergesi, FancyIndexing seçeneğiyle
üretilen dizin listesinde bir dosya simgesinin yerinde gösterilecek
metni belirler. dosya olarak dosya türünü
betimleyecek bir dosya uzantısı, dosya isminin bir kısmı, bir dosya ismi
kalıbı veya tam yoluyla bir dosya ismi belirtilebilir. Eğer
metin boşluk karakterleri içeriyorsa tırnak içine
(" veya ') alınmalıdır. Simge metni, simge
bulunamadığı veya istemci resim gösteremediği takdirde ya da kullanıcı
resim yüklememeyi tercih etmişse gösterilir.
AddAlt "PDF file" *.pdf AddAlt Compressed *.gz *.zip *.Z
| Açıklama: | Dosyanın MIME kodlamasına göre seçilen simgenin yerinde gösterilecek metni belirler. |
|---|---|
| Sözdizimi: | AddAltByEncoding metin MIME-kodlaması
[MIME-kodlaması] ... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
AddAltByEncoding yönergesi, FancyIndexing seçeneğiyle
üretilen dizin listesinde bir dosya simgesinin yerinde gösterilecek
metni belirler. MIME-kodlaması olarak
x-compress gibi geçerli bir içerik kodlaması
belirtilmelidir. Eğer metin boşluk karakterleri
içeriyorsa tırnak içine (" veya ')
alınmalıdır. Simge metni simge bulunamadığı veya istemci resim
gösteremediği takdirde ya da kullanıcı resim yüklememeyi tercih etmişse
gösterilir.
AddAltByEncoding gzip x-gzip
| Açıklama: | Dosyanın MIME türüne göre seçilen simgenin yerinde gösterilecek metni belirler. |
|---|---|
| Sözdizimi: | AddAltByType metin MIME-türü
[MIME-türü] ... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
AddAltByType yönergesi, FancyIndexing seçeneğiyle
üretilen dizin listesinde bir dosya simgesinin yerinde gösterilecek
metni belirler. MIME-türü olarak
text/html gibi geçerli bir içerik türü belirtilmelidir.
Eğer metin boşluk karakterleri içeriyorsa tırnak
içine (" veya ') alınmalıdır. Simge metni
simge bulunamadığı veya istemci resim gösteremediği takdirde ya da
kullanıcı resim yüklememeyi tercih etmişse gösterilir.
AddAltByType 'salt metin' text/plain
| Açıklama: | Bir dosya için gösterilecek açıklama belirtilir. |
|---|---|
| Sözdizimi: | AddDescription metin dosya [dosya] ... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
Yönerge, FancyIndexing seçeneğiyle üretilen dizin listesinde bir
dosya için gösterilecek açıklamayı belirler. dosya
olarak dosya türünü betimleyecek bir dosya uzantısı, dosya isminin bir
kısmı, bir dosya ismi kalıbı veya tam yoluyla bir dosya ismi
belirtilebilir. Eğer dosya açıklamasını içeren
metin boşluk karakterleri içeriyorsa çift tırnak
(") içine alınmalıdır.
AddDescription "Mars Gezegeni" mars.gif
AddDescription "Dostum Marshall" dostlar/mars.gif
Normalde öntanımlı açıklama alanının genişliği 23 bayttır. IndexOptions SuppressIcon
seçeneği buna 6 bayt daha ekler; IndexOptions SuppressSize
seçeneği 7 bayt, IndexOptions SuppressLastModified seçeneği ise 19 bayt
ekler. Böylece en fazla 55 karakterlik öntanımlı sütun genişliğine
ulaşılabilir.
dosya kısmî dosya ismi içerebileceğinden çok kısa dosya ismi
belirtilmesi yüzünden istemeden de olsa başka dosyalarla
eşleşebileceğini unutmayın. Örneğin, le.html doğrudan
le.html ile eşleşebileceği gibi example.html
ile de eşleşecektir. Şüpheli durumların ortaya çıkabileceği durumlarda
mümkün olduğunca dosya isminin tamamını kullanın ve saptanan ilk
eşleşmenin kullanılacağını aklınızdan çıkarmayın ayrıca,
AddDescription listesini de uygun şekilde sıralayın.
Açıklama sütununun öntanımlı genişliği geçersiz kılınabilir hatta
sınırsız açıklama uzunluğu atanabilir. Bu konu için IndexOptions yönergesinin DescriptionWidth
seçeneğinin açıklamasına bakınız.
AddDescription ile tanımlanan açıklama metni
HTML etiketleri ve karakter öğeleri içerebilir. Eğer açıklama
sütununun genişlik sınırlamasından dolayı bir HTML etiketinin içeriği
kırpılırsa bu durum dizin listesinin kalanını etkileyebilir (örneğin,
kalın gösterim listenin kalanına yayılabilir).
Mutlak yollar henüz desteklenmemetedir ve çalışma anında hiçbir şeyle eşleşmeyeceklerdir. Normalde sadece htaccess bağlamında kullanılan, göreli yol bilgisi içeren değiştirgeler, kısmi dizin isimleriyle eşleşmemeleri için örtük olarak '*/' öneki alırlar.
| Açıklama: | Bir dosya için gösterilecek simgeyi dosya adına göre belirler. |
|---|---|
| Sözdizimi: | AddIcon simge isim [isim]
... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
Yönerge, FancyIndexing seçeneğiyle üretilen dizin listesinde adı
isim ile biten bir dosya için gösterilecek simgeyi
belirler. simge ya simgenin göreli URL’si (%
öncelemeli), tam nitelenmiş bir uzak URL ya da
(alt-metin,url)
biçeminde olmalıdır; buradaki alt-metin simge
gösterilemediği durumda tarayıcı tarafından simgenin yerinde
gösterilecek metindir.
isim olarak ya (listeyi düzgün biçemlemek
amacıyla) dizinler için ^^DIRECTORY^^, boş satırlar için
^^BLANKICON^^ ya da dosya türünü betimleyecek bir dosya
uzantısı, dosya isminin bir kısmı, bir dosya ismi kalıbı veya tam
yoluyla bir dosya ismi belirtilebilir.
^^BLANKICON^^ sadece biçemleme için kullanılır,
dolayısıyla IndexOptions HTMLTable kullanıyorsanız
gereksizdir.
#Examples AddIcon (IMG,/icons/image.png) .gif .jpg .png AddIcon /icons/dir.png ^^DIRECTORY^^ AddIcon /icons/backup.png *~
Mümkünse AddIcon yerine AddIconByType yönergesi tercih
edilmelidir.
| Açıklama: | Bir dosya için gösterilecek simgeyi dosyanın MIME kodlamasına göre belirler. |
|---|---|
| Sözdizimi: | AddIconByEncoding simge MIME-kodlaması
[MIME-kodlaması] ... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
Yönerge, FancyIndexing seçeneğiyle üretilen dizin listesinde bir
dosya için gösterilecek simgeyi belirler. simge ya
simgenin göreli URL’si (% öncelemeli), tam nitelenmiş uzak bir URL ya da
(alt-metin,url) biçeminde olmalıdır;
buradaki alt-metin simge gösterilemediği durumda
tarayıcı tarafından simgenin yerinde gösterilecek metindir.
MIME-kodlaması olarak x-compress
gibi geçerli bir içerik kodlaması belirtilmelidir.
AddIconByEncoding /icons/compress.png x-compress
| Açıklama: | Bir dosya için gösterilecek simgeyi dosyanın MIME türüne göre belirler. |
|---|---|
| Sözdizimi: | AddIconByType simge MIME-türü
[MIME-türü] ... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
Yönerge, FancyIndexing seçeneğiyle üretilen dizin listesinde MIME
türü MIME-türü olarak belirtilen bir dosya için
gösterilecek simgeyi belirler. simge ya simgenin
göreli URL’si (% öncelemeli), tam nitelenmiş uzak bir URL ya da
(alt-metin,url) biçeminde olmalıdır;
buradaki alt-metin simge gösterilemediği durumda
tarayıcı tarafından simgenin yerinde gösterilecek metindir.
MIME-türü MIME türleri ile eşleşen bir dosya kalıbı ifadesi olabilir.
AddIconByType (IMG,/icons/image.png) image/*
| Açıklama: | Özel bir simge atanmamış dosyalar için gösterilecek simgeyi belirler. |
|---|---|
| Sözdizimi: | DefaultIcon URL-yolu |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
The DefaultIcon yönergesi FancyIndexing seçeneğiyle
üretilen dizin listesinde özel bir simge atanmamış dosyalar için
gösterilecek simgeyi belirler. URL-yolu simgeye
bir göreli URL (% öncelemeli) veya tam nitelenmiş uzak bir URL
belirtir.
DefaultIcon /icon/unknown.png
| Açıklama: | Dizin listesinin tepesine yerleştirilecek dosyanın ismini belirler. |
|---|---|
| Sözdizimi: | HeaderName dosya-ismi |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
HeaderName yönergesi, dizin listesinin tepesine
yerleştirilecek dosyanın ismini belirler. Dosyanın ismi
dosya-ismi ile belirtilir.
HeaderName HEADER.html
HeaderName and ReadmeName yönergelerinde
dosya-ismi artık içeriği listelenecek dizine
erişmek için kullanılan bir göreli URL yolu olarak ele alınmaktadır.
Eğer dosya-ismi bir bölü çizgisi ("/") ile
başlıyorsa DocumentRoot
yönergesinde belirtilen dizine göre belirtildiği varsayılır.
HeaderName /include/HEADER.html
dosya-ismi, içerik türü text/*
(text/html, text/plain gibi) olan bir belge
olarak çözümlenmelidir. Yani, aşağıdaki örnekteki gibi betiğin asıl
dosya türü text/html olarak imlenmişse
dosya-ismi bir CGI betiğinin ismi bile
olabilir:
AddType text/html .cgi
Options ile
MultiViews etkin kılınmışsa dosyaya içerik dili uzlaşımı da
uygulanabilir. dosya-ismi ile belirtilen dosya
text/html türünde durağan bir belge (bir CGI betiği
değil) ise ve options ile
Includes ve IncludesNOEXEC seçeneklerinden
biri belirtilmişse dosya bir SSI sayfası olarak ele alınır
(mod_include belgesine bakınız).
Eğer yönergede belirtilen dosya bir HTML belge gibi başlıyorsa
(<html>, <head>, vs.) ve bu etiketlerin yinelenmemesini
istiyorsanız IndexOptions +SuppressHTMLPreamble ataması yapmanız
gerekecektir.
| Açıklama: | Bir dizin sayfasının HEAD bölümüne metin yerleştirir. |
|---|---|
| Sözdizimi: | IndexHeadInsert "imlenim ..." |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
IndexHeadInsert yönergesi, dizin listesi için
üretilen HTML’nin <head> bölümüne yerleştirilecek bir
dizge tanımlar.
IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"
| Açıklama: | Dizin içerik listesinden gizlenecek dosyaların listesi belirtilir. |
|---|---|
| Sözdizimi: | IndexIgnore dosya [dosya] ... |
| Öntanımlı: | IndexIgnore "." |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
IndexIgnore yönergesi, dizin içerik listesinden
gizlenecek dosyaların listesini belirtmek için kullanılır.
dosya olarak kabuk tarzı bir dosya ismi kalıbı
veya tam yoluyla bir dosya ismi belirtilebilir. Evvelce yapılmış bir
atamada değişiklik yapmak yerine birden fazla
IndexIgnore ataması yapabilirsiniz. Liste
öntanımlı olarak içinde bulunulan dizini (./) içerir.
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
Bu yönerge, <DirectoryMatch> gibidüzenli ifadeler içeren yapılandırma
bölümlerinde henüz çalışmamaktadır.
| Açıklama: | Bir dizini listelerken gizlenecek dosyalar listesini boşaltır |
|---|---|
| Sözdizimi: | IndexIgnoreReset ON|OFF |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
| Uyumluluk: | Apache HTTP Sunucusunun 2.3.10 ve sonraki sürümlerinde kullanılabilmektedir. |
Bu yönerge, diğer yapılandırma bölümlerince bir şekilde miras alınmayan
ve IndexIgnore tarafından
yoksayılan dosyaları kaldırır.
<Directory "/var/www">
IndexIgnore *.bak .??* *~ *# HEADER* README* RCS CVS *,v *,t
</Directory>
<Directory "/var/www/backups">
IndexIgnoreReset ON
IndexIgnore .??* *# HEADER* README* RCS CVS *,v *,t
</Directory>
Bu yönergeyi kullandıktan sonra, açıkça yoksaymak istediğiniz kalıpların bir listesi için öntanımlı yapılandırmayı gözden geçirin.
| Açıklama: | Dizin içerik listesini yapılandıracak seçenekler belirtilir. |
|---|---|
| Sözdizimi: | IndexOptions [+|-]seçenek [[+|-]seçenek]
... |
| Öntanımlı: | Öntanımlı olarak hiçbir seçenek etkin değildir. |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
IndexOptions yönergesi dizin içerik listesinin
davranışını belirler. seçenek olarak şunlar
belirtilebilir:
IndexOptions HTMLTable etkin ve bir
IndexStyleSheet tanımlı olduğunda dizin listesi
tablosunun her satırına fazladan bir CSS sınıfı bildirimi ekler.
Tablonun her satırına uygulanmaması için standart even ve
odd sınıfları yerine even-ALT ve
odd-ALT bildirimleri kullanılabilir. Burada
ALT ya bir dosya biçimiyle ilişkili standat bir alt
dizgesidir ya da AddAlt* yönergeleriyle tanımlanan bir
alt dizgesidir.
Charset=karakter-kümesiCharset seçeneği üretilen sayfa için bir karakter
kümesi belirtebilmenizi sağlar. Dizinin bulunduğu dosya sisteminin
karakter kodlamasına bağlı olarak öntanımlı değeri Windows ve Mac OS
X'te UTF-8, diğerlerinde ISO-8859-1’dir (İlgili
dosya sisteminin Unicode dosya isimleri kullanıp kullanmamasına
bağlıdır).
IndexOptions Charset=UTF-8
DescriptionWidth=[n | *]DescriptionWidth seçeneği üretilen sayfada açıklama
sütununun genişliğini sizin belirleyebilmenizi sağlar. Bu seçenek
kullanılmadığında veya -DescriptionWidth olarak
belirtildiğinde uygun genişliği mod_autoindex
hesaplar.
DescriptionWidth=n ile açıklama sütununun
genişliği n baytla sınırlanır.
DescriptionWidth=* ile açıklama sütununun genişliği en
uzun açıklama metni sığacak şekilde arttırılır.
Sütun genişliğinin sabitliği nedeniyle metnin
kırpılmasından kaynaklanan sorunlar için AddDescription yönergesinin
açıklamasına bakınız.
FancyIndexingFoldersFirstFoldersFirst etkinse Zed dizini listede
Beta dizininden ve Gamma ve
Alpha dosyalarından önce yer alacaktır. Bu
seçenek sadece FancyIndexing seçeneği etkinse etkili
olacaktır.HTMLTableFancyIndexing
seçeneği ile birlikte süslü listeleme için basit bir tablo oluşturur.
UTF-8'in etkin olduğu platformlarda gereklidir. Bununla birlikte,
Linux, WinNT gibi sağdan sola veya soldan sağa yazım yönünün değiştiği
platformlarda dosya isimleri ve açıklamalar için bu özellikle gerekli
olabilir.IconsAreLinksFancyIndexing seçeneği ile birlikte süslü
listelemede dosya simgesini dosyaya bir hiper bağ haline getirir.IconHeight[=benek-sayısı]IconWidth seçeneği ile
kullanıldığında dosya simgesinin img etiketinin
height ve width özniteliklerini içermesine
sebep olur. Böylece tarayıcının tüm simgelerin yüklenmesini beklemeden
sayfa yerleşimi için bir ön hesaplama yapabilmesi mümkün olur. Seçenek
bir değer belirtilmeksizin kullanıldığında Apache http tarafından
atanmış standart simge yüksekliği öntanımlıdır. Bu
seçenek sadece FancyIndexing seçeneği etkinse etkili
olacaktır.IconWidth[=benek-sayısı]IconHeight seçeneği ile
kullanıldığında dosya simgesinin img etiketinin
height ve width özniteliklerini içermesine
sebep olur. Böylece tarayıcının tüm simgelerin yüklenmesini beklemeden
sayfa yerleşimi için bir ön hesaplama yapabilmesi mümkün olur. Seçenek
bir değer belirtilmeksizin kullanıldığında Apache httpd tarafından
atanmış standart simge genişliği öntanımlıdır.IgnoreCaseIgnoreCase
etkinse Zeta dosyası alfa dosyasından sonra listelenir (Dikkat: GAMMA
daima gamma’dan önce listelenir.)IgnoreClientmod_autoindex’in listenin sıralanmasına
etki edenler dahil tüm sorgu değişkenlerini yoksaymasına sebep olur
(örtük olarak SuppressColumnSorting uygulanır).NameWidth=[n | *]NameWidth seçeneği dosya ismi sütunu için bir
genişlik belirtebilmenizi mümkün kılar.
Hiç belirtilmediğinde veya -NameWidth biçeminde
belirtildiğinde mod_autoindex uygun genişliği kendisi
hesaplayacaktır, fakat en fazla 20 karakter olabilir.
NameWidth=n ile sütun genişliği
n bayt genişlikte sabitlenir.
NameWidth=* olduğunda ise sütun genişliği en geniş
satırın sığacağı kadar arttırılır.
ScanHTMLTitlesAddDescription ile bir açıklama tanımlanmımışsa Apache
httpd belgenin title etiketinin içeriğini okuyacaktır. Bu
seçenek işlemciyi ve diski fazla meşgul eder.ShowForbiddenHTTP_UNAUTHORIZED veya
HTTP_FORBIDDEN döndürdüğünden dolayı normalde gizli olan
dosyalar bu seçenek belirtilmişse listede gösterilir.SuppressColumnSortingIndexOptions IgnoreClient ile sağlanmaktadır.SuppressDescriptionAddDescription
yönergesinin açıklamasına bakınız. Ayrıca, açıklama sütununun
genişliğini ayarlayan DescriptionWidth dizin listeleme seçeneğine de
bakınız. Bu seçenek sadece
FancyIndexing
seçeneği etkinse etkili olacaktır.SuppressHTMLPreambleHeaderName yönergesi ile belirtilmiş bir dosya içeriyorsa
modül normal olarak bu dosyanın içeriğinin öncesine HTML başlangıç
etiketlerini (<html>, <head>,
vs.) yerleştirir. Bu seçenek bu davranışı iptal ederek modülün dosya
içeriğinin başlangıcına bir şey eklememesini sağlar. Bu durumda başlık
dosyasının uygun HTML etiketlerini içermesi gerekir. Böyle bir başlık
dosyası yoksa normal olarak HTML başlangıç etiketleri üretilir. Eğer
bir ReadmeName yönergesi
de belirtilirse ve bu dosya mevcutsa, kapayan
</body></html> etiketleri de çıktı bulunmaz. Buna
dayanarak bu etiketleri de sizin koymanız gerekebilir.SuppressIcon
pre
etiketinin içeriğinde img ve hr
etiketlerinin bulunmasına izin vermediğinden SuppressIcon
ve SuppressRules seçenekleri birlikte kullanılarak HTML
3.2 belirtimine uyum sağlanır.SuppressLastModifiedFancyIndexing
seçeneği etkinse etkili olacaktır.SuppressRules
hr etiketinin kullanımını engeller.
Son belirtim, süslü dizin listelemede kullanılan pre
etiketinin içeriğinde img ve hr
etiketlerinin bulunmasına izin vermediğinden SuppressIcon
ve SuppressRules seçenekleri birlikte kullanılarak HTML
3.2 belirtimine uyum sağlanır. Bu seçenek sadece
FancyIndexing
seçeneği etkinse etkili olacaktır.SuppressSizeFancyIndexing
seçeneği etkinse etkili olacaktır.
TrackModified
Last-Modified ve ETag alanlarının dönmesini
sağlar. Sadece işletim sistemi veya dosya sistemi uygun stat()
sonuçlarını döndürüyorsa bu geçerlidir. Bazı Unix sistemleri ve
OS/2'nin JFS'si ile Win32’nin NTFS’i böyledir. Ancak OS/2 ve Win32 FAT dosya
sistemleri böyle değildir. Bu özellik etkin kılındığında istemci veya
vekil HEAD istekleriyle dosya listesindeki değişiklikleri
izleyebilirler. Yalnız, bazı işletim sistemlerinin yeni ve silinmiş
dosyaların izini iyi sürdüğü halde dizin içindeki dosyaların boyut ve
tarih değişikliklerini izlemediklerine dikkat ediniz. Mevcut
bir dosyanın boyut ve zaman damgasındaki değişiklikler
Last-Modified başlığının güncellenmesini tüm Unix
sistemlerinde sağlamaz. Bu gibi durumlarda bu seçeneğin
kapalı kalması daha iyidir.Type anahtar sözcüğü üretilen sayfanın MIME içerik
türünün belirtilebilmesini sağlar. text/html öntanımlıdır.
IndexOptions Type=text/plain
Last Modified alanı tarafından kullanılan tarih biçemi
"%Y-%m-%d %H:%M" dikkatsizlik sonucu 2.4.0 sürümünde
"%d-%b-%Y %H:%M" olarak değişmiştir. Bu seçenekle tarih
biçemini 2.2 ve öncesindeki biçemiyle kullanabilirsiniz.VersionSort
VersionSort seçeneği isimlerinde sürüm numarası bulunan
dosyaların sayısal sıralamaya uygun olarak sıralanmalarını sağlar.
Normalde sıralama karakter sıralamasına göre yapılır, ardından sürüm
numaralı dosyalar veya açıklamalar kendi aralarında sayısal sıralamaya
tabi tutulur.
foo-1.7
foo-1.7.2
foo-1.7.12
foo-1.8.2
foo-1.8.2a
foo-1.12
Sıfır ile başlalan numaralara ondalık sayı muamelesi yapılır:
foo-1.001
foo-1.002
foo-1.030
foo-1.04
XHTMLXHTML seçeneği mod_autoindex’in kodu
HTML 3.2’ye değil XHTML 1.0’a uygun üretmesini sağlar.
Bu seçenek sadece
FancyIndexing
seçeneği etkinse etkili olacaktır.+ veya - Önekli SeçeneklerÇok sayıda IndexOptions yönergesinin
işlenebileceğine dikkat edin.
IndexOptions
yönergesi belirtilmişse bunlar ayrı ayrı değil birlikte ele alınır.
Yani,
<Directory "/foo">
IndexOptions HTMLTable
IndexOptions SuppressColumnsorting
</Directory>
yapılandırmasındaki IndexOptions
yönergeleri
IndexOptions HTMLTable SuppressColumnsorting
yönergesine eşdeğerdir.
+ veya - önekleri
kullanılabilmektedir.+ veya - önekli seçeneklere rastlandığında
bunlar mevcut (üst dizinden miras alınanlar ve/veya önceki atamalar)
IndexOptions yönergelerine uygulanır. Ancak,
önek kullanılmamış bir seçeneğe raslandığında, o noktada önceki ve
miras alınmış bu tür seçenekler iptal edilir. Şu örneği ele
alalım:
IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing IndexOptions +SuppressSize
Bunun net etkisi
IndexOptions FancyIndexing +SuppressSize
atamasına eşdeğerdir, çünkü öneksiz FancyIndexing
seçeneği kendinden önceki önekli seçenekleri iptal etmiş fakat hemen
ardından eklenmelerine izin vermiştir.
Belli bir dizine önceki seçenekleri temizleyerek koşulsuz olarak
tamamen yeni seçenekler atamak istiyorsanız
IndexOptions yönergesinde seçenekleri
+ veya - öneklerini kullanmadan
belirtiniz.
| Açıklama: | Dizin içerik listesinin öntanımlı sıralamasını belirler. |
|---|---|
| Sözdizimi: | IndexOrderDefault Ascending|Descending
Name|Date|Size|Description |
| Öntanımlı: | IndexOrderDefault Ascending Name |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
IndexOrderDefault yönergesi FancyIndexing seçeneğinin
etkin olduğu durumda işe yarar. Öntanımlı olarak süslü listelemede dizin
içeriği dosya ismine göre artan sıralamayla listelenir.
IndexOrderDefault yönergesi bu öntanımlı
sıralamanın değiştirilmesini mümkün kılar.
IndexOrderDefault yönergesi iki değer alır. İlki
sıralama yönünü belirtmek üzere Ascending (küçükten büyüğe)
veya Descending (büyükten küçüğe) olmak zorundadır. İkinci
değer ise birincil sıralama anahtarını belirtmek üzere
Name, Date, Size ve
Description sözcüklerinden biri olmalıdır (anlamları
sırayla: İsim, Tarih, Boyut, Açıklama). İkincil sıralama anahtarı
daima artan sıralamayla dosya ismidir.
Sütunun tepesindeki sıralama bağını kaldırmak için
SuppressColumnSorting seçeneğinin yanında, sıralama
tercihlerinizi geçersiz kılmak için sorgu dizgesine elle sıralama
seçenekleri eklenmesini engellemek için
IgnoreClient
seçeneğini de kullanarak istemcinin listeyi yeniden sıralamasını
engelleyebilirsiniz.
| Açıklama: | Dizin listesine bir biçembent ekler. |
|---|---|
| Sözdizimi: | IndexStyleSheet url-yolu |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
IndexStyleSheet yönergesi dizin listelemesi için
kullanılacak biçembent dosyasının ismini belirtmek için kullanılır.
IndexStyleSheet "/css/style.css"
Bu yönergenin IndexOptions HTMLTable ile birlikte
kullanılması sonuçlanan HTML dosyasına bir miktar CSS sınıfı ekler.
Tablonun tamamı indexlist için bir CSS kimliği verir ve
aşağıdaki sınıflar listenin çeşitli parçalarıyla ilişkilendirilir:
| Sınıf | Tanım |
|---|---|
| tr.indexhead | Liste satırının başlığı |
| th.indexcolicon and td.indexcolicon | Simge sütunu |
| th.indexcolname and td.indexcolname | Dosya ismi sütunu |
| th.indexcollastmod and td.indexcollastmod | Son değişiklik sütunu |
| th.indexcolsize and td.indexcolsize | Dosya boyutu sütunu |
| th.indexcoldesc and td.indexcoldesc | Açıklama sütunu |
| tr.breakrow | Tablonun altınaki yatay çizgi |
| tr.odd and tr.even | Tek ve çift satırlar |
| Açıklama: | Dizin listesinin sonuna yerleştirilecek dosyanın ismini belirler. |
|---|---|
| Sözdizimi: | ReadmeName dosya-ismi |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_autoindex |
ReadmeName yönergesi dizin listesinin sonuna
eklenecek dosyanın ismini belirler. dosya-ismi ile
listeye dahil edilecek dosyanın ismi listelenen dizine göreli olarak
belirtilir. Eğer dosya ismi 2. örnekteki gibi bir bölü çizgisi ile
başlıyorsa DocumentRoot’a göreli
belirtildiği varsayılır.
# 1. Örnek ReadmeName FOOTER.html
# 2. Örnek ReadmeName /include/FOOTER.html
Ayrıca bu davranışın daha ayrıntılı ele alındığı HeaderName yönergesine de
bakınız.
Apache HTTP サーバ バージョン 2.4
| 説明: | URI をキーにしたコンテンツのキャッシュ |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | cache_module |
| ソースファイル: | mod_cache.c |
Allow や Deny ディレクティブを無視しますので、
注意して使って下さい。クライアントのホスト名、アドレスや環境変数を使って
アクセスを制限したいコンテンツに対してはキャッシュ機能を有効にするべきではありません。
mod_cache はローカルのコンテンツやプロキシされた
コンテンツをキャッシュするために使われる RFC 2616 準拠の
HTTP コンテンツキャッシュを実装しています。mod_cache
の動作にはストレージを管理するモジュールが必要です。標準
Apache 配布には二つストレージ管理モジュールが含まれています:
mod_cache_diskmod_mem_cachemod_mem_cache は次の二つのモードのどちらかで動作する
ように設定できます: オープンされているファイル記述子をキャッシュするモードか、
ヒープ上でのオブジェクトの自体をキャッシュをするモードです。
mod_mem_cache はローカルで生成されるコンテンツや、
mod_proxy が
ProxyPass を使って設定されている
ときの (つまりリバースプロキシ での) バックエンドサーバの
コンテンツをキャッシュするのに使えます。コンテンツのキャッシュへの保存と取得は URI に基づいたキーが使われます。 アクセス保護のかけられているコンテンツはキャッシュされません。
より詳細な解説や例についてはキャッシュ機能 を参照してください。
CacheDefaultExpire CacheDetailHeader CacheDisable CacheEnable CacheHeader CacheIgnoreCacheControl CacheIgnoreHeaders CacheIgnoreNoLastMod CacheIgnoreQueryString CacheIgnoreURLSessionIdentifiers CacheKeyBaseURL CacheLastModifiedFactor CacheLock CacheLockMaxAge CacheLockPath CacheMaxExpire CacheMinExpire CacheQuickHandler CacheStaleOnError CacheStoreExpired CacheStoreNoStore CacheStorePrivate| 関連モジュール | 関連ディレクティブ |
|---|---|
#
# Sample Cache Configuration
#
LoadModule cache_module modules/mod_cache.so
<IfModule mod_cache.c>
#LoadModule cache_disk_module modules/mod_cache_disk.so
# If you want to use mod_cache_disk instead of mod_mem_cache,
# uncomment the line above and comment out the LoadModule line below.
<IfModule mod_cache_disk.c>
CacheRoot c:/cacheroot
CacheEnable disk /
CacheDirLevels 5
CacheDirLength 3
</IfModule>
LoadModule mem_cache_module modules/mod_mem_cache.so
<IfModule mod_mem_cache.c>
CacheEnable mem /
MCacheSize 4096
MCacheMaxObjectCount 100
MCacheMinObjectSize 1
MCacheMaxObjectSize 2048
</IfModule>
# When acting as a proxy, don't cache the list of security updates
CacheDisable http://security.update.server/update-list/
</IfModule>
| 説明: | 期日が指定されていないときにドキュメントをキャッシュするデフォルトの期間 |
|---|---|
| 構文: | CacheDefaultExpire seconds |
| デフォルト: | CacheDefaultExpire 3600 (1時間) |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
CacheDefaultExpire ディレクティブは、ドキュメントに
有効期限 (expiry) や最終修正時刻 (last-modified) が指定されていない場合の
デフォルトの時間を指定します。CacheMaxExpire
ディレクティブで指定された値はこの設定を上書きしません。
CacheDefaultExpire 86400
| 説明: | Add an X-Cache-Detail header to the response. |
|---|---|
| 構文: | CacheDetailHeader on|off |
| デフォルト: | CacheDetailHeader off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Extension |
| モジュール: | mod_cache |
| 互換性: | Available in Apache 2.3.9 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | 特定の URL をキャッシュしない |
|---|---|
| 構文: | CacheDisable url-string |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
CacheDisable ディレクティブで
mod_cache モジュールが url-string 以下の
URL をキャッシュしないようにします。
CacheDisable /local_files
| 説明: | 指定したストレージ管理方式を使ってのキャッシュを有効にする |
|---|---|
| 構文: | CacheEnable cache_type url-string |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
CacheEnable ディレクティブで mod_cache
モジュールが url-string 以下の URL をキャッシュするようにします。
キャッシュストレージ管理方式は cache_type 引数で指定します。
cache_type mem で、
mod_mem_cache で実装されているメモリを使ったストレージ
管理方式を使うように mod_cache に指示します。
cache_type disk で、
mod_cache_disk で実装されているディスクを使ったストレージ
管理を使うように mod_cache に指示します。
cache_type fd は mod_cache に
mod_mem_cache により実装されているファイル記述子の
キャッシュを使うように指示します。
(下の例のように) CacheEnable ディレクティブの
URL 空間が重複しているときは、該当するストレージ方式を順に試して、
実際にリクエストの処理ができると、その方式で処理します。
ストレージ管理方式が実行される順番は設定ファイル中の
CacheEnable の順番により決定されます。
CacheEnable mem /manual
CacheEnable fd /images
CacheEnable disk /
フォワードプロクシサーバとして動作する場合、 url-string を使って、キャッシュを有効にするリモートサイトや プロクシプロトコルを指定することもできます。
# Cache proxied url's
CacheEnable disk /
# Cache FTP-proxied url's
CacheEnable disk ftp://
# Cache content from www.apache.org
CacheEnable disk http://www.apache.org/
| 説明: | Add an X-Cache header to the response. |
|---|---|
| 構文: | CacheHeader on|off |
| デフォルト: | CacheHeader off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Extension |
| モジュール: | mod_cache |
| 互換性: | Available in Apache 2.3.9 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | キャッシュされているコンテンツを返さないようにクライアントから リクエストされても無視する |
|---|---|
| 構文: | CacheIgnoreCacheControl On|Off |
| デフォルト: | CacheIgnoreCacheControl Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
Cache-Control: no-cache ヘッダや Pragma: no-store ヘッダのあるリクエストに
対しては、通常キャッシュを使いません。CacheIgnoreCacheControl
ディレクティブを使うと、この動作を上書きできます。
CacheIgnoreCacheControl On とすると、
リクエストに no-cache という値があっても、キャッシュを使ってドキュメントを
返すようになります。認証を必要とするドキュメントは決して
キャッシュされません。
CacheIgnoreCacheControl On
| 説明: | 指定された HTTP ヘッダをキャッシュに保存しない。 |
|---|---|
| 構文: | CacheIgnoreHeaders header-string [header-string] ... |
| デフォルト: | CacheIgnoreHeaders None |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
RFC 2616 によると、hop-by-hop HTTP ヘッダはキャッシュには保管されません。
以下のヘッダは hop-by-hop ヘッダに該当しますので、
CacheIgnoreHeaders
の設定に関係なくキャッシュには保管されません:
ConnectionKeep-AliveProxy-AuthenticateProxy-AuthorizationTETrailersTransfer-EncodingUpgradeCacheIgnoreHeaders で
キャッシュに保管しない追加の HTTP ヘッダを指定します。
例えば、クッキーをキャッシュに保管しないようにした方がよい場合も
あるでしょう。
CacheIgnoreHeaders の引数は、
キャッシュに保管しない HTTP ヘッダを空白区切りにしたリスト形式です。
キャッシュに保管しないヘッダが hop-by-hop ヘッダだけの場合
(RFC 2616 準拠の動作のとき) は、
CacheIgnoreHeaders を None
に設定できます。
CacheIgnoreHeaders Set-Cookie
CacheIgnoreHeaders None
Expires のような適切のキャッシュ管理のために必要な
ヘッダが CacheIgnoreHeaders の設定により
保管されていないときは、mod_cache の動作は定義されていません。
| 説明: | 応答に Last Modified が無くても気にしないようにする |
|---|---|
| 構文: | CacheIgnoreNoLastMod On|Off |
| デフォルト: | CacheIgnoreNoLastMod Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
通常、Last-Modified による最終修正時刻の無いドキュメントはキャッシュ
されません。(例えば mod_include による処理のときなどに)
Last-Modified 時刻が消去されたり、そもそも最初から提供されていない
状況があります。CacheIgnoreNoLastMod
ディレクティブを使うと、Last-Modified 日時が指定されていない
ドキュメントでもキャッシュするように指定できます。ドキュメントに
最終修正時刻 (Last-Modified) 有効期限 (expiry) がない場合は、有効期限の
生成に CacheDefaultExpire が使われます。
CacheIgnoreNoLastMod On
| 説明: | キャッシュ時にクエリーストリングを無視する |
|---|---|
| 構文: | CacheIgnoreQueryString On|Off |
| デフォルト: | CacheIgnoreQueryString Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
クエリーストリング付のリクエストについては通常、クエリーストリングごとに
個別にキャッシュされます。
キャッシュされるのは有効期限が指定されている場合のみで、これは
RFC 2616/13.9 に従ったものです。
CacheIgnoreQueryString ディレクティブを使うと
有効期限が指定されていなくてもキャッシュしますし、
クエリーストリングが異なっていてもキャッシュを返します。
このディレクティブが有効になっている場合、キャッシュ機能の側面からみると、
あたかもリクエストにクエリーストリングがついていなかったかのように扱います。
CacheIgnoreQueryString On
| 説明: | Ignore defined session identifiers encoded in the URL when caching |
|---|---|
| 構文: | CacheIgnoreURLSessionIdentifiers identifier [identifier] ... |
| デフォルト: | CacheIgnoreURLSessionIdentifiers None |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Override the base URL of reverse proxied cache keys. |
|---|---|
| 構文: | CacheKeyBaseURL URL |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
| 互換性: | Available in Apache 2.3.9 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | LastModified の日付に基づいて有効期限 (expiry) を計算するための重みを指定する |
|---|---|
| 構文: | CacheLastModifiedFactor float |
| デフォルト: | CacheLastModifiedFactor 0.1 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
ドキュメントに Last-Modified の日付が無いけれども有効期限 (expiry)
の日付があるというときに、有効期限を最終修正時刻からの経過時間として
計算するようにできます。有効期限を次の計算式に従って生成するのですが、
そのときに使われる factor を
CacheLastModifiedFactor ディレクティブで指定します。
expiry-period = time-since-last-modified-date * factor
expiry-date = current-date + expiry-period
例えば、ドキュメントが 10 時間前に最後に修正されていて、 factor が 0.1 であれば、期日は 10*0.1 = 1 時間に 設定されます。現在時刻が 3:00pm であれば、計算された期日は 3:00pm + 1hour = 4:00pm になります。
期日が CacheMaxExpire で設定されている値
より大きくなってしまっている場合は、CacheMaxExpire
の設定値が優先されます。
CacheLastModifiedFactor 0.5
| 説明: | Enable the thundering herd lock. |
|---|---|
| 構文: | CacheLock on|off |
| デフォルト: | CacheLock off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
| 互換性: | Available in Apache 2.2.15 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Set the maximum possible age of a cache lock. |
|---|---|
| 構文: | CacheLockMaxAge integer |
| デフォルト: | CacheLockMaxAge 5 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Set the lock path directory. |
|---|---|
| 構文: | CacheLockPath directory |
| デフォルト: | CacheLockPath /tmp/mod_cache-lock |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | ドキュメントをキャッシュする最大時間を秒数で表したもの |
|---|---|
| 構文: | CacheMaxExpire seconds |
| デフォルト: | CacheMaxExpire 86400 (一日) |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
CacheMaxExpire ディレクティブは、
キャッシュする HTTP ドキュメントを、元のサーバに問い合わせないまま最大何秒
保持してもよいかを指定します。つまり、ドキュメントは最大でこの秒数間ぶん古く
なることになります。この最大値は、(訳注: レスポンス中で)ドキュメントと共に
ドキュメントの期日が提供されている場合でも適用されます。
CacheMaxExpire 604800
| 説明: | ドキュメントをキャッシュする最小秒数 |
|---|---|
| 構文: | CacheMinExpire seconds |
| デフォルト: | CacheMinExpire 0 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
キャッシュ可能な HTTP ドキュメントがあったときに、オリジンサーバに問い合わせることなく
保持する秒数の最小値は CacheMinExpire ディレクティブを使って設定します。
この値は、ドキュメントに妥当な有効期限が指定されていなかった場合にのみ使われます。
CacheMinExpire 3600
| 説明: | Run the cache from the quick handler. |
|---|---|
| 構文: | CacheQuickHandler on|off |
| デフォルト: | CacheQuickHandler on |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
| 互換性: | Apache HTTP Server 2.3.3 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Serve stale content in place of 5xx responses. |
|---|---|
| 構文: | CacheStaleOnError on|off |
| デフォルト: | CacheStaleOnError on |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Extension |
| モジュール: | mod_cache |
| 互換性: | Available in Apache 2.3.9 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Attempt to cache responses that the server reports as expired |
|---|---|
| 構文: | CacheStoreExpired On|Off |
| デフォルト: | CacheStoreExpired Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Extension |
| モジュール: | mod_cache |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | no-store と指定されているレスポンスのキャッシュを試みる。 |
|---|---|
| 構文: | CacheStoreNoStore On|Off |
| デフォルト: | CacheStoreNoStore Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
通常 Cache-Control: no-store ヘッダのついているレスポンスは
キャッシュされません。CacheStoreNoCache
ディレクティブでこの挙動を上書きできます。
CacheStoreNoCache On で no-store ヘッダのついている
リソースに対してもキャッシュを試みるようになります。
ただし認証の求められるリソースは 決して キャッシュされません。
CacheStoreNoStore On
| 説明: | private と指定されているレスポンスのキャッシュを試みる。 |
|---|---|
| 構文: | CacheStorePrivate On|Off |
| デフォルト: | CacheStorePrivate Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_cache |
通常 Cache-Control: private ヘッダのついているレスポンスは
キャッシュされません。CacheStorePrivate
ディレクティブでこの挙動を上書きできます。
CacheStorePrivate On で private ヘッダのついている
リソースに対してもキャッシュを試みるようになります。
ただし認証の求められるリソースは 決して キャッシュされません。
CacheStorePrivate On
Apache HTTP サーバ バージョン 2.4
| 説明: | それぞれのリクエストに対する一意な識別子の入った環境変数を 提供する |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | unique_id_module |
| ソースファイル: | mod_unique_id.c |
このモジュールは非常に制限された条件下で、
それぞれのリクエストに「すべて」のリクエストに対して
一意に決まることが保証されている魔法のトークンを提供します。
この一意な識別子は、適切に設定されたクラスタでは複数の
マシンの間でさえも一意になります。それぞれのリクエストに対して環境変数
UNIQUE_ID に識別子が設定されます。
一意な識別子が便利な理由はいろいろありますが、
このドキュメントの目的からは外れるため、ここでは説明しません。
このモジュールにディレクティブはありません。
まずはじめに、Apache サーバが Unix マシンでどのように動作をするかを簡単に説明します。 この機能は現時点では Windows NT ではサポートされていません。 Unix マシンでは Apache はいくつかの子プロセスを作成し、 その子プロセスが一つずつリクエストを処理します。それぞれの子プロセスは、 生存期間中に複数のリクエストを扱うことができます。 この議論では子プロセス間では一切データを共有しないことにします。 以後、この子プロセスのことを httpd プロセス と呼びます。
あなたのウェブサイトにはあなたが管理するいくつかのマシンがあるとします。 それらをまとめてクラスタと呼ぶことにします。それぞれのマシンは複数の Apache を実行することもできます。 これらすべてをまとめたものが「宇宙」であると考えられます。 いくつかの仮定の下で、クラスタのマシン間がたくさん通信をすることなく、 この宇宙の中でそれぞれのリクエストに一意な識別子を生成できることを示します。
クラスタにあるマシンは以下の要求を見たさなければなりません。 (マシンが一つだけだとしても、NTP で時計を合わせる方が良いです。)
オペレーティングシステムにおいては、pid (プロセス ID) が 32 ビットの範囲内であることを仮定します。オペレーティングシステムの pid が 32 ビットを超える場合は、簡単な修正ではありますが、 コードを変更する必要があります。
これらの仮定が満たされていると、ある時点において、 クラスタ内のどのマシンのどの httpd プロセスでも、一意に同定することができます。これはマシンの IP アドレスと httpd プロセスの pid で十分に行なうことができます。 ですから、リクエストに一意な識別子を生成するためには、 時刻を区別する必要があるだけです。
時刻を区別するために、Unix のタイムスタンプ (UTC の 1970 年 1 月 1 日からの秒数) と、16 ビットのカウンタを使います。 タイムスタンプの粒度は一秒ですので、一秒間の 65536 までの値を表現するためにカウンタを使用します。四つの値 ( ip_addr, pid, time_stamp, counter ) で各 httpd プロセスで一秒の間に 65536 リクエストを数えあげることができます。 時間が経つと pid が再利用されるという問題がありますが、 この問題を解決するためにカウンタが使用されます。
httpd の子プロセスが作成されると、カウンタは (その時点のマイクロ秒 ÷ 10) modulo 65536 で初期化されます (この式はいくつかのシステムにある、マイクロ秒の タイマの下位ビットが異なるという問題を解決するために選ばれました)。 一意な識別子が生成されたとき、使用されるタイムスタンプは ウェブサーバにリクエストが到着した時刻になります。 カウンタは識別子が生成されるたびに増加します (あふれた場合は 0 に戻ります)。
カーネルはプロセスをフォークすると、それぞれのプロセスのために pid を生成します。pid は繰り返されることが許可されています (pid の値は多くの Unix では 16 ビットですが、新しいシステムでは 32 ビットに拡張されています)。 ですから、ある程度の時間が経過すると同じ pid が再び使用されます。 しかし、一秒内に再使用されなければ、 四つの値の一意性は保たれます。つまり、我々はシステムが一秒間 に 65536 個のプロセスを起動しないと仮定しています (いくつかの Unix では 32768 プロセスですが、それですらほとんどあり得ないでしょう)。
何らかの理由で、同じ時刻が繰り返されたとしましょう。 つまり、システムの時計が狂っていて、もう一度過去の時刻になってしまった (もしくは進みすぎていたときに、 正しい時刻に戻したために再び将来の時刻になってしまった) とします。 この場合、pid とタイムスタンプが再使用されることが簡単に示されます。 カウンタ初期化用の関数は、この問題の回避を手助けしようと選択されています。 本当はカウンタの初期化をするためにランダムな数字を使いたいのですが、 ほとんどのシステムでは簡単に使用できる数は無いことに注意してください (すなわち、rand ()は使えません。rand () には seed を与える必要があり、seed には時刻を使えません。一秒単位では、 その時刻はすでに繰り返されているからです)。 これは、完璧な対策ではありません。
この対策はどのくらい効果があるでしょうか? ここでは、マシン群の中の一つは最大で一秒に 500 リクエストを扱うと仮定します (これを書いている時点では妥当な上限です。 通常システムがすることは静的なファイルを取りだすだけではありませんから)。 それを行なうために、そのマシンは並行して来るクライアントの数に 応じた数の子プロセスを要求します。 しかしながら、悲観的に考えて、一つの子プロセスが一秒に 500 リクエストを扱えるとします。そうすると、(一秒の精度において) 時刻が同じ時を繰り返すと、この子プロセスがカウンタの値を再び使い、 一意性が壊れる可能性が 1.5% あります。 これは非常に悲観的な例で、実世界の値では、ほとんど起こりそうにありません。 それでもこれが起こる可能性のあるようなシステムなら、 (プログラムコードを編集して) カウンタを 32 ビットにするのが良いでしょう。
サマータイムにより時計が「戻される」ことを気にしている人が いるかもしれません。ここで使用される時間は UTC であり、 それは「常に」進むのでここでは問題になりません。x86 上の Unix はこの条件を満たすために適切な設定が必要かもしれないことに 注意してください。マザーボードの時計は UTC になっていて、 他の時間はそこから適切に補正されることを仮定できるように 設定されなければなりません。そのような場合でさえ、NTP を使っているならばリブート後にすぐ正しい UTC の時間になるでしょう。
UNIQUE_ID 環境変数は 112 ビット (32 ビット IP
アドレス、32 ビット pid, 32 ビットタイムスタンプ、16
ビットカウンタの四つの組) をアルファベット [A-Za-z0-9@-]
を用いて MIME の base64 符号化と同様の方法により符号化し、19
の文字を生成することにより作成されます。MIME の base64
のアルファベットは実際は [A-Za-z0-9+/] ですが、
+ と / とは URL
では特別な符号化が必要なので、あまり望ましくありません。
全ての値はネットワークバイトオーダで符号化されますので、
符号は違ったバイトオーダのアーキテクチャ間で比較可能です。
実際の符号化の順番は: タイムスタンプ、IP アドレス、pid,
カウンタです。この順には目的がありますが、
アプリケーションは符号を解析するべきではないことを強調しておきます。
アプリケーションは符号化された UNIQUE_ID
全体を透過的なトークンとして扱うべきです。
UNIQUE_ID は他の UNIQUE_ID
との等価性を調べるためだけにのみ使用できます。
この順番は将来、既存の UNIQUE_ID
のデータベースとの衝突を心配することなく符号を変更することが
可能になるように選択しています。
新しい符号はタイムスタンプを最初の要素として残すのが望ましく、
それ以外は同じアルファベットとビット長を使うことができます。
タイムスタンプは本質的に増加系列ですので、
クラスタの全てのマシンがリクエストとサーバ機能を停止して、
古い符号化方式を使用するのをやめるフラグ秒があれば十分です。
その後は、リクエストを再開し、
新しい符号を発行することができるようになります。
我々はこれが、 この問題に対する比較的移植性の高い解決法だと考えています。 Windows NT のようなマルチスレッドのシステムに拡張することができますし、 将来必要になればさらに増やすこともできます。 ID は必要に応じて長くすることができますので、生成された ID は実質上、無限に有効です。また、クラスタのマシン間の通信も事実上必要なく (NTP による同期のみが必要で、これはオーバヘッドはあまりありません)、httpd プロセス間の通信も必要ありません (通信はカーネルにより割り当てられた pid の値により暗黙の内に行なわています)。 さらに限られた状況下では、ID はさらに短くすることができますが、 より多くの情報を仮定する必要がでてきます (例えば、32 ビット IP アドレスはどのサイトにおいても過剰な情報ですが、 それの代わりになる移植性のあるものはありません)。
Apache HTTP Server Version 2.4
| : | ̿ |
|---|---|
| : | Base |
| : | authn_file_module |
| ҽ: | mod_authn_file.c |
| : | ġ 2.1 |
mod_auth_digest
mod_auth_basic մܸ
Ϲ ȣϿ ڸ ãƼ Ѵ.
mod_authn_dbm ϴ.
mod_auth_basic̳
mod_auth_digest Ҷ AuthBasicProvider
AuthDigestProvider
file ϸ Ѵ.
| : | ڸ ȣ ϴ ϸ Ѵ |
|---|---|
| : | AuthUserFile file-path |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Base |
| : | mod_authn_file |
AuthUserFile þ
ڸ ȣ ϴ ϸ Ѵ.
File-path ϰ̴. θ
ServerRoot
η óѴ.
ٿ ڸ, ݷ, ڵ ȣ
´. ٿ ̵ ϸ,
mod_authn_file ù° ȣ
Ѵ.
ϵ ̳ src/support ִ htpasswd HTTP
Basic Authentication ȣ Ѵ.
ڼ manpage
϶. ϸ:
ʱ ̵ username ȣ
Filename . ȣ :
htpasswd -c Filename username
ȣ Filename username2
߰ϰų Ѵ:
htpasswd Filename username2
ū ˻ϴ ſ ȿ
϶. ڰ ٸ AuthDBMUserFile ؾ
Ѵ.
HTTP Digest Authentication Ѵٸ htpasswd ȵȴ. htdigest ؾ Ѵ. Digest Authentication Basic Authentication ڷḦ Ͽ ϶.
AuthUserFile
ۿ ġ Ȯ϶. ȣ 丮 ȿ
. , Ŭ̾Ʈ
AuthUserFile ٿε ִ.
Apache HTTP Server Version 2.4
| : | Ϲ ̿ Ѻο |
|---|---|
| : | Base |
| : | authz_groupfile_module |
| ҽ: | mod_authz_groupfile.c |
| : | ġ 2.1 ĺ |
Ʈ Ϻθ
ִ Ͽ Ѻο Ѵ.
mod_authz_dbm ϴ.
| : | ϴ ϸ Ѵ |
|---|---|
| : | AuthGroupFile file-path |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Base |
| : | mod_authz_groupfile |
AuthGroupFile þ
ϴ ϸ
Ѵ. File-path ̴. θ
ServerRoot η Ƶδ.
ٿ , ݷ, ڸ ´.
mygroup: bob joe anne
ū ˻ϴ ſ
ȿ ϶. AuthDBMGroupFile .
AuthGroupFile
ۿ ġ Ȯ϶. ȣ 丮 ȿ
. , Ŭ̾Ʈ
AuthGroupFile ٿε ִ.
Apache HTTP Server Version 2.4
| : | ڵ н ls ɾ Win32
dir ɾ 丮 |
|---|---|
| : | Base |
| : | autoindex_module |
| ҽ: | mod_autoindex.c |
丮 ΰ:
index.html̶ ̸ ڰ
ۼ . ̸ DirectoryIndex þ
Ѵ. ۾ mod_dir Ѵ.AddIcon, AddIconByEncoding,
AddIconByType
ܵ Ѵ. Ͽ
ϴ ù° δ. ۾
mod_autoindex Ѵ., Ѵٸ ڵ (Ȥ ü) ִ.
ڵ Options +Indexes ϴ.
ڼ Options
þ ϶.
IndexOptions
þ FancyIndexing ɼ ָ, ̸
ٲٴ ũ . ̸ ũ ϸ
ٽ . ̸ ݺؼ ϸ
̸ . IndexOptions þ
SuppressColumnSorting ɼ ̷ ̸ ũ
ʴ´.
"Size(ũ)" µǴ ƴ϶ ũ ϶. , 1010 Ʈ ϰ 1011 Ʈ Ѵ "1K" ̴ 1010 Ʈ տ ´.
AddAlt AddAltByEncoding AddAltByType AddDescription AddIcon AddIconByEncoding AddIconByType DefaultIcon HeaderName IndexHeadInsert IndexIgnore IndexIgnoreReset IndexOptions IndexOrderDefault IndexStyleSheet ReadmeNameġ 2.0.23 û ƱԸƮ ϰ,
ο ɼǵ ߰ߴ. Ŭ̾Ʈ
IndexOptions
IgnoreClient ɼ ߰Ǿ.
̸ Ʒ û ɼ ڱ ũ. Ʒ ɼ 丮 ڿ û ִ.
C=N ϸ ̴C=M ֱ , ϸ ̴C=S ũ , ϸ ̴C=D , ϸ
̴O=A ѴO=D ѴF=0 (FancyIndexed ƴ) ̴F=1 FancyIndexed ̴F=2 HTMLTable FancyIndexed
̴V=0 ʴ´V=1 ѴP=pattern ־ pattern
شϴ ϸ 'P'attern ƱԸƮ Ϲ IndexIgnore þ ó Ŀ
˻ϱ, ٸ autoindex ϶.
mod_autoindex û ƱԸƮ о϶
ɼ ߰ϸ ̻ ʴ´. û ƱԸƮ
ǥ Ѵ.
header.html Ͽ ִ Ʒ ɼǵ Ѵ. submit "X" ƱԸƮ mod_autoindex X=Go ƱԸƮ о Ȯϱ ߴ.
<form action="" method="get">
Show me a <select name="F">
<option value="0"> Plain list</option>
<option value="1" selected="selected"> Fancy list</option>
<option value="2"> Table list</option>
</select>
Sorted by <select name="C">
<option value="N" selected="selected"> Name</option>
<option value="M"> Date Modified</option>
<option value="S"> Size</option>
<option value="D"> Description</option>
</select>
<select name="O">
<option value="A" selected="selected"> Ascending</option>
<option value="D"> Descending</option>
</select>
<select name="V">
<option value="0" selected="selected"> in Normal order</option>
<option value="1"> in Version order</option>
</select>
Matching <input type="text" name="P" value="*" />
<input type="submit" name="X" value="Go" />
</form>
| : | ϸ ܴ |
|---|---|
| : | AddAlt string file [file] ... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
AddAlt FancyIndexing
Ͽ ܴ Ѵ. File
Ȯ, ϸ Ϻ, ϵī ǥ,
ü ϸ ִ. String
ٸ ǥ(" Ȥ ')
Ѵ. Ŭ̾Ʈ ̹ ų, ̹
ʰų, ߰ ̰ ȴ.
AddAlt "PDF file" *.pdf
AddAlt Compressed *.gz *.zip *.Z
| : | MIME-encoding ܴ |
|---|---|
| : | AddAltByEncoding string MIME-encoding
[MIME-encoding] ... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
AddAltByEncoding FancyIndexing
Ͽ ܴ Ѵ. MIME-encoding
x-compress ȿ content-encoding̴.
String ٸ ǥ("
Ȥ ') Ѵ. Ŭ̾Ʈ ̹
ų, ̹ ʰų,
߰ ̰ ȴ.
AddAltByEncoding gzip x-gzip
| : | MIME content-type ܴ |
|---|---|
| : | AddAltByType string MIME-type
[MIME-type] ... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
AddAltByType FancyIndexing
Ͽ ܴ Ѵ. MIME-type
text/html ȿ content-type̴.
String ٸ ǥ("
Ȥ ') Ѵ. Ŭ̾Ʈ ̹
ų, ̹ ʰų,
߰ ̰ ȴ.
AddAltByType 'plain text' text/plain
| : | Ͽ |
|---|---|
| : | AddDescription string file [file] ... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
þ FancyIndexing Ͽ Ѵ.
File Ȯ, ϸ Ϻ,
ϵī ǥ, ü ϸ ִ. String
ǥ(") Ѵ.
AddDescription "The planet Mars" /web/pics/mars.gif
⺻ ʵ 23 Ʈ. IndexOptions
SuppressIcon ɼ ϸ ⺻ 6 Ʈ
߰ϰ, IndexOptions SuppressSize ɼ 7 Ʈ,
IndexOptions SuppressLastModified ɼ 19
Ʈ ߰Ѵ. Ƿ 55 Ʈ.
ʵ ٲٰų ̸ Ѵ
DescriptionWidth IndexOptions Ű带 ϶.
AddDescription ۿ
±׳ character entity(; <, &
Ī) HTML ִ.
±װ ִ κ ©ԵǸ ( ü κ
©) 丮 Ͽ ִ.
| : | ̸ Ͽ |
|---|---|
| : | AddIcon icon name [name]
... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
þ FancyIndexing name
Ѵ. Icon
(%-escaped) URL Ȥ
(alttext,url) ̴.
⼭ alttext
ܴ ̴.
Name 丮 Ÿ ^^DIRECTORY^^,
( ùٷ ߱) Ÿ
^^BLANKICON^^, Ȯ, ϵī ǥ,
ϸ Ϻ Ȥ ü ִ.
AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm
AddIcon /icons/dir.xbm ^^DIRECTORY^^
AddIcon /icons/backup.xbm *~
ϸ AddIconٴ AddIconByType ؾ Ѵ.
| : | MIME content-encoding Ͽ |
|---|---|
| : | AddIconByEncoding icon MIME-encoding
[MIME-encoding] ... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
þ FancyIndexing
Ѵ. Icon
(%-escaped) URL Ȥ
(alttext,url) ̴.
⼭ alttext
ܴ ̴.
MIME-encoding content-encoding شϴ ϵī ǥ̴.
AddIconByEncoding /icons/compress.xbm x-compress
| : | MIME content-type Ͽ |
|---|---|
| : | AddIconByType icon MIME-type
[MIME-type] ... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
þ FancyIndexing
MIME-type Ѵ.
Icon (%-escaped) URL Ȥ
(alttext,url) ̴.
⼭ alttext
ܴ ̴.
MIME-type mime type شϴ ϵī ǥ̴.
AddIconByType (IMG,/icons/image.xbm) image/*
| : | Ư Ͽ |
|---|---|
| : | DefaultIcon url-path |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
DefaultIcon þ FancyIndexing
Ư ̴.
Icon (%-escaped) URL̴.
DefaultIcon /icon/unknown.xbm
| : | ϸ ̸ |
|---|---|
| : | HeaderName filename |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
HeaderName þ ϸ տ
̸ Ѵ. Filename
ϸ̴.
HeaderName HEADER.html
HeaderName ReadmeName
Filename Ϸ 丮 URI η
Ƶδ. Filename ϸ DocumentRoot η
Ƶδ.
HeaderName /include/HEADER.html
Filename major content type text/*
( , text/html, text/plain,
) ؾ Ѵ. , ũƮ ( ƴ)
type text/html Ѵٸ
filename CGI ũƮ ִ:
AddType text/html .cgi
Options
MultiViews ϸ Ѵ.
filename (CGI ũƮ ƴ)
text/html ̰ options Includes
IncludesNOEXEC ϳ Ѵٸ
server-side includes óѴ. (mod_include
)
HeaderName Ͽ
(<html>, <head>, ) HTML ۺκ Եִٸ
IndexOptions
+SuppressHTMLPreamble Ͽ κ ߰ʴ
.
| : | Inserts text in the HEAD section of an index page. |
|---|---|
| : | |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Base |
| : | mod_autoindex |
Documentation not yet translated. Please see English version of document.
| : | 丮 Ͽ ϸ ߰Ѵ |
|---|---|
| : | IndexIgnore file [file] ... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
IndexIgnore þ 丮
Ͽ ϸ ߰Ѵ. File
( ϴ) ȭϵī ǥ̳ ü ϸ
ִ. IndexIgnore þ ϸ
ϸ üʰ Ͽ ϵ ߰Ѵ.
⺻ . ( 丮) Ѵ.
IndexIgnore README .htaccess *.bak *~
| : | Empties the list of files to hide when listing a directory |
|---|---|
| : | IndexIgnoreReset ON|OFF |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
| : | 2.3.10 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | 丮 |
|---|---|
| : | IndexOptions [+|-]option [[+|-]option]
... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
IndexOptions þ 丮
Ѵ. Option ϳ̴
DescriptionWidth Ű带 Ͽ ڴ
ִ.-DescriptionWidth ϸ (Ȥ ƹ͵
) mod_autoindex
Ѵ.DescriptionWidth=n
n Ʈ Ѵ.DescriptionWidth=*
ִ¸ŭ ø.AddDescription
϶.FoldersFirst
Ѵٸ 丮 Zed 丮
Beta տ , 丮 Beta
Ϲ Gamma Alpha տ
´. ɼ FancyIndexing Բ Ҷ ȿ
ִ.img ± height width
Ӽ Ѵ. ̹
Ȳ ̸ ִ. ɼǿ
ġ ϴ ǥ ̸ Ѵ.IconHeight ϸ
img ±
height width Ӽ Ѵ.
̹ Ȳ
̸ ִ. ɼǿ ġ
ϴ ǥ Ѵ.mod_autoindex
Ͽ Ŭ̾Ʈ Ǻ Ѵ.
(SuppressColumnSorting Ѵ.)NameWidth Ű Ʈ ϸ
Ѵ.-NameWidth ϸ (Ȥ ƹ͵
) mod_autoindex
Ѵ.NameWidth=n n
Ʈ Ѵ.NameWidth=* ʿѸŭ ø.AddDescription
ٸ title
Ұ оδ. ۾ CPU ũ Ѵ.AddDescription ϶. ũ⸦
ϴ DescriptionWidth
ɼǵ ϶.HeaderName þ
ִ ǥ HTML ۺκ
(<html>, <head>,
et cetera) ڿ ÷Ѵ.
SuppressHTMLPreamble ɼ ϸ ó
header Ѵ. header Ͽ
HTML ־ Ѵ. header ٸ Ϲ
ۺκ .SuppressIcon
SuppressRules ϸ, (FancyIndexed
) pre ȿ img
hr ǥ HTML 3.2
˸ ȴ.hr )
ʴ´. SuppressIcon
SuppressRules ϸ, (FancyIndexed
) pre ȿ img
hr ǥ HTML 3.2
˸ ȴ.HEAD û Ͽ ϸ ȭ
ִ. ü ο ϰ ùٷ
, 丮 ִ ũ⳪ ¥ ȭ
϶. н ÷
ũ⳪ ¥ ȭ Last-Modified
ٲʴ´. ̷ ȭ ߿ϴٸ ɼ
.VersionSort Ű ȣ
ϸ ڿ Ѵ. κ
, ϰ ִ κ ڰ
Ѵ.
foo-1.7
foo-1.7.2
foo-1.7.12
foo-1.8.2
foo-1.8.2a
foo-1.12
0 ϸ, м Ѵ:
foo-1.001
foo-1.002
foo-1.030
foo-1.04
XHTML Ű带 ϸ
mod_autoindex HTML 3.2 XHTML 1.0
ڵ带 Ѵ.ġ 1.3.3 IndexOptions
þ ó ũ ȭǾ. Ư:
IndexOptions þ Ѵ.
:
<Directory /foo>
IndexOptions HTMLTable
IndexOptions SuppressColumnsorting
</Directory>
IndexOptions HTMLTable SuppressColumnsorting
+
- ̴) ߰Ǿ.Ű տ '+' '-' ش Ű尡
( 丮 ӵǾ) IndexOptions
ݿȴ. տ ƹ͵ Ű带
ӵǰų .
캸:
IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing
IndexOptions +SuppressSize
տ ƹ͵ FancyIndexing
ٽ ߰ǿ
IndexOptions FancyIndexing +SuppressSize .
Ư 丮
IndexOptions Ϸ Ű
տ + -
ӵ .
| : | 丮 ⺻ Ѵ |
|---|---|
| : | IndexOrderDefault Ascending|Descending
Name|Date|Size|Description |
| ⺻: | IndexOrderDefault Ascending Name |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
IndexOrderDefault þ FancyIndexing
ɼǰ Բ Ѵ. ⺻ fancyindexed 丮
ϸ ̴. IndexOrderDefault
ʱ ִ.
IndexOrderDefault ƱԸƮ
´. ù° ϴ Ascending
() ̳ Descending () ϳ.
ι° ƱԸƮ Ÿ Ű Name,
Date, Size, Description
ϳ. ϸ ̴.
þ SuppressColumnSorting ɼ ϸ
Ư θ 丮 . Ŭ̾Ʈ
ٸ 丮 û Ѵ.
| : | 丮 Ͽ CSS ŸϽƮ ߰Ѵ |
|---|---|
| : | IndexStyleSheet url-path |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
IndexStyleSheet þ 丮
Ͽ CSS ϸ Ѵ.
IndexStyleSheet "/css/style.css"
| : | ϸ ̸ |
|---|---|
| : | ReadmeName filename |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_autoindex |
ReadmeName þ ϸ
̸ Ѵ. Filename
ϸ̰, ġ η Ƶδ.
Filename ϸ DocumentRoot η Ƶδ.
ReadmeName FOOTER.html
ReadmeName /include/FOOTER.html
ڼ HeaderName ϶.
Apache HTTP Server Version 2.4
| : | ڸ ̿ Ѻο |
|---|---|
| : | Extension |
| : | authz_owner_module |
| ҽ: | mod_authz_owner.c |
| : | ġ 2.1 ĺ |
HTTP ̵(
̵) û Ͻý / Ͽ
ٱ οѴ. ⼭ ڸ ȣ ̹
mod_auth_basic̳
mod_auth_digest Ȯ
ƴ. mod_authz_owner Require þ ƱԸƮ,
file-owner file-group óѴ:
file-ownerjones, Ͽ ϴ ڵ
jones̾ Ѵ.file-groupmod_authz_groupfile̳
mod_authz_dbm ͺ̽
ְ, ڸ ش 쿡 ؾ Ѵ. ,
ü û accounts (ý)
ϰ ִٸ, ͺ̽
accounts ְ û
ڸ 쿡 ؾ Ѵ.mod_authz_owner Ͻýۿ
ʴ ڿ (, ڿ) ѺοѴٸ,
źѴ.
Ư "MultiViews" ڿ Ѻο ʴ´.
ġ ϴ ýۿ ڰ
~/public_html/private ڽ Ѵٰ
. ڸ ϴ AuthDBMUserFile
ͺ̽ ְ, ڸ
ϴ ý ڸ ϴ.
Ʒ ڿԸ Ѵ.
jones jones ƴ
smith ϰ ִ
/home/smith/public_html/private ִ Ͽ
.
<Directory /home/*/public_html/private>
AuthType Basic
AuthName MyPrivateFiles
AuthBasicProvider dbm
AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all
Satisfy All
Require file-owner
</Directory>
Ȳ
~/public_html/project-foo Ʈ
Ѵٰ . ϵ ý foo
ϸ, ڸ ϴ AuthDBMGroupFile
ͺ̽ ִ. , ּ foo
쿡 ִ. jones
smith foo
̶, project-foo 丮
ִ.
<Directory /home/*/public_html/project-foo>
AuthType Basic
AuthName "Project Foo Files"
AuthBasicProvider dbm
# combined user/group database
AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all
AuthDBMGroupFile /usr/local/apache2/etc/.htdbm-all
Satisfy All
Require file-group
</Directory>
Apache HTTP 服务器版本 2.4
每个在 Apache 标准发行版中可用的指令都列在这里。它们使用一致的格式描述，而且有术语字典。
指令快速参考用来以摘要的形式提供有关每个指令的详细信息。
A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X
Apache HTTP サーバ バージョン 2.4
| 説明: | Unix の ls コマンドや
Win32 の dir シェルコマンドに似た
ディレクトリインデックスを生成する |
|---|---|
| ステータス: | Base |
| モジュール識別子: | autoindex_module |
| ソースファイル: | mod_autoindex.c |
ディレクトリのインデックスは二つの情報源のうちの 一つから生成できます:
index.html と呼ばれる
ユーザによって書かれたファイル。
DirectoryIndex
ディレクティブでこのファイル名を設定します。
これは mod_dir で制御されます。AddIcon, AddIconByEncoding と
AddIconByType
を使うことで、様々なファイルタイプに対してアイコン一覧を
セットします。つまり、リストされたファイル毎に、
ファイルにマッチした一番最初のアイコンが表示されます。
これらは mod_autoindex で制御されます。望むならば、自動インデックス生成を完全に除去 (あるいは置換) できるように、この二つの機能は分離されています。
自動インデックス生成は Options +Indexes
を使うことで有効になります。詳細については、
Options
ディレクティブをご覧下さい。
もし FancyIndexingオプションが
IndexOptions
ディレクティブに与えられているならば、
列の先頭は表示の順番を制御するリンクになります。
先頭のリンクを選択すると、一覧は再生成されて
その列の値でソートされます。
同じ先頭を続けて選択すると、交互に昇順と降順とになります。
これらの列の先頭のリンクは、
IndexOptions
ディレクティブの
SuppressColumnSorting
オプションで消すことができます。
"Size" でソートした場合は、用いられるのは 実際のファイルのサイズであって、 表示の値ではないことに注意してください - たとえ両方ともが "1K" と表示されていたとしても、 1010 バイトのファイルは必ず 1011 バイトのファイルよりも前 (昇順の場合) に表示されます。
AddAlt AddAltByEncoding AddAltByType AddDescription AddIcon AddIconByEncoding AddIconByType DefaultIcon HeaderName IndexHeadInsert IndexIgnore IndexIgnoreReset IndexOptions IndexOrderDefault IndexStyleSheet ReadmeNameApache 2.0.23 で、
コラムソートのためにクエリー引数を再編成して、
新しいクエリーオプションのグループを導入しました。
出力に対するクライアントのすべての制御を効率的に抹消
できるように、
IndexOptions
IgnoreClient が導入されました。
コラムソートのヘッダそれ自体が、 下記のソートクエリーオプションを付加する 自分自身を参照するリンクです。 下記のオプションのどれでも、 ディレクトリリソースへのリクエストに加えることができます。
C=N は、ファイル名でソートします。C=M は、更新日時、
ディレクトリ、ファイル名の順でソートします。C=S は、サイズ、
ディレクトリ、ファイル名の順でソートします。C=D は、説明、
ディレクトリ、ファイル名の順でソートします。O=A は、昇順で表をソートします。O=D は、降順で表をソートします。F=0 は、単純な表の書式にします。
(FancyIndex ではありません。)F=1 は、FancyIndex
表示の表の書式にします。F=2 は、表を HTML
のテーブルを使った FancyIndex の書式にします。V=0
は、バージョンによるソートを無効にします。V=1
は、バージョンによるソートを有効にします。P=pattern
は、与えられた pattern
に適合したファイルのみを表示します。"P (パターンの P)" クエリー引数は、
通常の IndexIgnore
ディレクティブが処理された後に検査され、
ファイル名全てが、他の autoindex
リスト処理と同様の判定基準下に置かれ続ける
ことに注意してください。
mod_autoindex のクエリー引数パーサ (解析) は、
認識不能なオプションにぶつかると即座に停止します。
クエリー引数は上の表に従って
正しい形式になっていなければなりません。
下の単純な例は、これらのクエリーオプションを 表します。これをそのまま切り取って HEADER.html ファイルに保存することもできます。 mod_autoindex が X=Go 入力にぶつかる前に 引数が全て解釈されるように、 未知の引数 "X" はリストの最後に置かれています。
<form action="" method="get">
Show me a <select name="F">
<option value="0"> Plain list</option>
<option value="1" selected="selected"> Fancy list</option>
<option value="2"> Table list</option>
</select>
Sorted by <select name="C">
<option value="N" selected="selected"> Name</option>
<option value="M"> Date Modified</option>
<option value="S"> Size</option>
<option value="D"> Description</option>
</select>
<select name="O">
<option value="A" selected="selected"> Ascending</option>
<option value="D"> Descending</option>
</select>
<select name="V">
<option value="0" selected="selected"> in Normal order</option>
<option value="1"> in Version order</option>
</select>
Matching <input type="text" name="P" value="*" />
<input type="submit" name="X" value="Go" />
</form>
| 説明: | アイコンの代わりに 表示される、ファイル名で選択された代替テキスト |
|---|---|
| 構文: | AddAlt string file [file] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
AddAlt は、FancyIndexing
において、アイコンの代わりに表示する代替テキストを提供します。
file は、説明するファイルのファイル拡張子、
ファイル名の一部、ワイルドカード表現、完全なファイル名の
どれかになります。
string に空白がある場合は引用符 ("
か ') で囲む必要があります。
この文字列は、クライアントが画像を表示できない場合や
画像のロードを無効にしている場合や
アイコンの取得に失敗したときに表示されます。
AddAlt "PDF file" *.pdf
AddAlt Compressed *.gz *.zip *.Z
| 説明: | アイコンの代わりに表示される、MIME 符号化方法で選択された 代替テキスト |
|---|---|
| 構文: | AddAltByEncoding string MIME-encoding
[MIME-encoding] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
AddAltByEncoding は、
FancyIndexing
において、アイコンの代わりに表示する代替文字列を提供します。
MIME-encoding は有効な符号化、例えば
x-compress
です。
string に空白があるときは、引用符 (" か
') で囲む必要があります。
この文字列は、クライアントが画像を表示できない場合や
画像のロードを無効にしている場合や
アイコンの取得に失敗したときに表示されます。
AddAltByEncoding gzip x-gzip
| 説明: | アイコンの代わりに 表示される、MIME タイプで選択された代替テキスト |
|---|---|
| 構文: | AddAltByType string MIME-type
[MIME-type] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
AddAltByType は、
FancyIndexing
において、アイコンの代わりに表示する代替文字列を設定します。
MIME-type は有効なタイプ、例えば
text/html
です。
string に空白があるときは、引用符 (" か
') で囲む必要があります。
この文字列は、クライアントが画像を表示できない場合や
画像のロードを無効にしている場合や
アイコンの取得に失敗したときに表示されます。
AddAltByType 'plain text' text/plain
| 説明: | ファイルに対して表示する説明 |
|---|---|
| 構文: | AddDescription string file [file] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
FancyIndexing
において、ファイルに対して表示する説明を設定します。
file は説明するファイルのファイル拡張子、
ファイル名の一部、ワイルドカード表現、完全なファイル名の
どれかになります。
string は二重引用符 (") で囲まれます。
AddDescription "The planet Mars" /web/pics/mars.gif
通常のデフォルトの説明領域は 23 バイトの幅です。
IndexOptions SuppressIcon
オプションで 6 バイト追加、
IndexOptions SuppressSize
オプションで 7 バイト追加、
IndexOptions SuppressLastModified
オプションで 19 バイト追加されます。
ですから、デフォルトの説明コラムの最大幅は
55 バイトになります。
このコラムの大きさを上書きしたり、
説明が無制限長でもよいようにするための詳細に関しては、
DescriptionWidth
という
IndexOptions
のキーワードをご覧下さい。
AddDescription
で定義された説明テキストは、タグや文字列といった
HTML マークアップを含むことができます。
もし、説明コラムの幅によってタグ付けされた要素が丸め込まれた
(太字の語句の最後が切れるといった) 場合、
出力結果は、ディレクトリ一覧の残りの部分に影響を与えるでしょう。
| 説明: | ファイルに表示するアイコンを名前で選択 |
|---|---|
| 構文: | AddIcon icon name
[name] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
FancyIndexing
において、
name で終わるファイルの隣に表示するアイコンを設定します。
icon は、(% でエスケープされた) アイコンへの相対 URL
か、他の書式 (alttext, url) です。
ここで alttext
は、非グラフィカルブラウザ向けにアイコンに付けられたテキストタグです。
name は、ディレクトリに対応する ^^DIRECTORY^^
か、空白行に対応する ^^BLANKICON^^ (一覧が正しく表示されるために) か、
ファイル拡張子か、ワイルドカード表現か、ファイル名の一部か
完全なファイル名です。
AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm
AddIcon /icons/dir.xbm ^^DIRECTORY^^
AddIcon /icons/backup.xbm *~
もし可能なら、
AddIcon
より
AddIconByType
を優先的に使うべきでしょう。
| 説明: | ファイルに表示するアイコンを MIME 符号化方法で選択 |
|---|---|
| 構文: | AddIconByEncoding icon MIME-encoding
[MIME-encoding] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
FancyIndexing
において、ファイルの隣に表示するアイコンを設定します。
icon は、(% でエスケープされた) アイコンへの相対 URL
か、他の書式 (alttext, url) です。
ここで alttext
は、非グラフィカルブラウザ向けにアイコンに付けられたテキストタグです。
MIME-encoding は、有効なコンテントエンコーディング、
例えば x-compressです。
AddIconByEncoding /icons/compress.xbm x-compress
| 説明: | ファイルの隣に表示するアイコンを MIME タイプによって選択 |
|---|---|
| 構文: | AddIconByType icon MIME-type
[MIME-type] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
FancyIndexing
において、ファイルの隣に表示するアイコンを設定します。
icon は、(% でエスケープされた) アイコンへの相対 URL
か、他の書式 (alttext, url) です。
ここで alttext
は、非グラフィカルブラウザ向けにアイコンに付けられたテキストタグです。
MIME-type は、要求されたタイプに該当する ワイルドカード表現です。
AddIconByType (IMG,/icons/image.xbm) image/*
| 説明: | 特定のアイコンが何も設定されていない時に ファイルに表示するアイコン |
|---|---|
| 構文: | DefaultIcon url-path |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
FancyIndexing
において、
特定のアイコンがない場合にファイルに表示するアイコンを設定します。
url-path は、(% でエスケープされた) アイコンへの相対 URL
です。
DefaultIcon /icon/unknown.xbm
| 説明: | インデックス一覧の先頭に挿入されるファイルの名前 |
|---|---|
| 構文: | HeaderName filename |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
HeaderName
ディレクティブは、
インデックス一覧の先頭に挿入するファイルの名前を設定します。
Filename は取り込むファイルの名前です。
HeaderName HEADER.html
HeaderName も ReadmeName
も両方とも現在は、filename
をインデックスされているディレクトリに用いられた URI
に対する相対 URI パスとして扱います。
filename がスラッシュで始まる場合は、
DocumentRoot
からの相対パスとなります。
HeaderName /include/HEADER.html
filename は
メジャーコンテントタイプが "text/*"
(例えば、text/html,
text/plain 等です。)
のドキュメントとして解決
されなければなりません。これはつまり、
もし CGI スクリプトの実際のファイルタイプが
次のディレクティブのようにして実際の出力とは異なって
text/html としてマークされている場合、
filename
は CGI スクリプトを参照するかも知れない、
ということを意味します:
AddType text/html .cgi
Options MultiViews が
有効になっている場合は、
コンテントネゴシエーション
が行なわれます。
もし filename が (CGI スクリプトでない) 静的な
text/html ドキュメントで解決され、
options
Includes か IncludesNOEXEC
が有効になっている場合は、
ファイルはサーバーサイドインクルードで処理されます
(mod_include ドキュメントを参照して下さい)。
もし HeaderName で指定されたファイルが
HTML ドキュメントの開始部分 (<html>, <head>,
等) を含んでいたら、
IndexOptions
+SuppressHTMLPreamble
を設定して、これらのタグが繰り返されないようにしたいと思うでしょう。
| 説明: | インデックスページの HEAD セクションにテキストを挿入する |
|---|---|
| 構文: | IndexHeadInsert "markup ..." |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
IndexHeadInsert ディレクティブを使って
インデックスとして生成されたHTMLの <head> セクションに
挿入する文字列を指定します。
IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"
| 説明: | ディレクトリ一覧を行なう際に無視すべき ファイルリストに追加 |
|---|---|
| 構文: | IndexIgnore file [file] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
IndexIgnore ディレクティブは、
ディレクトリの一覧を行う際に無視すべきファイルリストに追加します。
file は、
シェル形式のワイルドカード表現か完全なファイル名です。
IndexIgnore が複数ある場合は、無視するリストに追加が行われ、
置換は行われません。デフォルトではリストには .
(カレントディレクトリ) が含まれています。
IndexIgnore README .htaccess *.bak *~
| 説明: | Empties the list of files to hide when listing a directory |
|---|---|
| 構文: | IndexIgnoreReset ON|OFF |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
| 互換性: | 2.3.10 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | ディレクトリインデックスの様々な設定項目 |
|---|---|
| 構文: | IndexOptions [+|-]option [[+|-]option] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
IndexOptions
は、ディレクトリインデックスの挙動を指定します。
option は次のどれかです:
Charset キーワードで、
生成されるページの文字セットを指定できます。
下位のファイルシステムが Unicode ベースかどうかに依存しますが、
デフォルト値は ISO-8859-1 か UTF-8
になります。
IndexOptions Charset=UTF-8
Type キーワードで、
生成されるページの MIME コンテントタイプを指定できます。
デフォルト値は text/html になります。
IndexOptions Type=text/plain
DescriptionWidth
キーワードは説明コラムの幅を文字数で指定することができます。-DescriptionWidth (または非設定) で、
mod_autoindex が最適な幅を計算するようにできます。DescriptionWidth=n
で、コラム幅を n バイトに固定します。DescriptionWidth=*
は、最長の説明に合わせて必要な長さまでコラムを延ばします。AddDescription
セクションをお読み下さい。FoldersFirst が有効になっている場合は、
サブディレクトリ Zed はサブディレクトリ
Beta よりも前にリストされ、通常のファイル
Gamma や Alpha
よりも前にリストされます。このオプションは
FancyIndexing
も有効になっているときにのみ有効です。FancyIndexing とともに指定することで、
飾りの付いたディレクトリ一覧のためにテーブルを使った単純な表を作ります。
これは古いブラウザを混乱させるかもしれないことに注意してください。
WinNT やその他 utf-8
が有効なプラットホームのように、ファイル名や説明テキストが
右読みになったり左読みになりえる場合は特に必要です。IconWidth とともに
使われている場合は、サーバはファイルアイコンのための
img タグに height と width
属性を取り込むようになります。
これによって、イメージ全てをロードし終わるまで待たなくても、
ブラウザはページレイアウトをあらかじめ計算することができます。
このオプションに何も値が与えられなければ、Apache
ソフトウェアで提供されているアイコンの標準の高さが
デフォルトなります。IconHeight とともに使われている場合は、
サーバはファイルアイコンのための img
タグに height と width
属性を取り込むようになります。
これによって、イメージ全てをロードし終わるまで待たなくても、
ブラウザはページレイアウトをあらかじめ計算することができます。
このオプションに何も値が与えられなければ、Apache
ソフトウェアで提供されているアイコンの標準の高さが
デフォルトなります。IgnoreCase が有効であれば、
Zeta は alfa の後にリストされます
(注意: GAMMA は常に gamma の前になります)。mod_autoindex は、
クライアントからの全てのクエリー変数を無視するようになります。
これはソート順も含みます。
(つまり SuppressColumnSorting
も有効になります。)NameWidth キーワードでファイル名コラムの幅をバイト数で
指定できます。-NameWidth (または非設定) で、
mod_autoindex が最適な幅を計算するようにできます。NameWidth=n
で、コラム幅を n バイトに固定します。NameWidth=*
は、必要な長さまでコラムを延ばします。AddDescription
で説明が与えられていなければ、
httpd は title タグの値を読むためにドキュメントを読み始めます。
これは CPU や disk に負荷をかけます。HTTP_UNAUTHORIZED や
HTTP_FORBIDDEN のファイルは一覧に表示しません。
このオプションを指定すると、そのようなファイルも一覧に表示します。IndexOptions
IgnoreClient で制御されるようになっています。AddDescription
をご覧下さい。また、説明のコラムサイズを制限する
DescriptionWidth
インデックスオプションもご覧下さい。HeaderName
ディレクティブで指定したファイルを
ディレクトリが実際に含んでいれば、標準的な HTML プリアンブル
(<html>, <head>, 等) の後に、
モジュールはファイルの中身をインクルードします。
SuppressHTMLPreamble オプションは、
この挙動を無効にできて、
モジュールがヘッダーファイルの中身から表示を始めます。
この場合、ヘッダーファイルは正しい HTML
命令を含んでいなければなりません。
ヘッダーファイルが存在しない場合は、プリアンブルは通常通り
生成されます。SuppressIcon と SuppressRules
と組合わせることによって正しい HTML 3.2 の出力が得られます。
HTML 3.2 の最終規格は、 img と hr
が pre ブロックに入る (FancyIndexing 一覧で書式に使われています)
ことを禁止しています。hr タグ) を消去します。
SuppressIcon と SuppressRules
と組合わせることによって正しい HTML 3.2 の出力が得られます。
HTML 3.2 の最終規格は、 img と hr
が pre ブロックに入る (FancyIndexing 一覧で書式に使われています)
ことを禁止しています。Last-Modified や
ETag を含めます。
これは、オペレーティングシステムやファイルシステムが
適切な stat() の返り値を返す場合にのみ有効です。
いくつかの UNIX システム、OS2 の JFS や Win32 の NTFS
ボリュームはそうなっています。
例えば、OS2 と Win32 FAT ボリュームはそうではありません。
この機能が有効になると、クライアントやプロキシは
HEAD リクエストを行うことによって、
ファイル一覧の変化を追跡することができるようになります。
オペレーティングシステムによっては、新規ファイルや
移動ファイルは正しく追跡するけれども、
ディレクトリ中のファイルのサイズや日付は追跡しないということに
注意してください。
既に存在するファイルのサイズや日付のスタンプが変化しても、
全ての Unix プラットホームでは、
Last-Modified ヘッダーを更新しません。
もしこれが重要であれば、
このオプションを無効のままにしてください。VersionSort キーワードはバージョン番号を含んだファイルが
自然な方法でソートされるようにします。
文字列は通常通りソートされ、
それ以外の、説明や名前中の数となる部分文字列は
その数値で比較されます。
foo-1.7
foo-1.7.2
foo-1.7.12
foo-1.8.2
foo-1.8.2a
foo-1.12
番号が 0 から始まる場合は、端数と考えられます
foo-1.001
foo-1.002
foo-1.030
foo-1.04
XHTML キーワードを指定すると、mod_autoindex
は HTML 3.2 の代わりに XHTML 1.0 のコードを出力するようになります。Apache 1.3.3 では、
IndexOptions
ディレクティブの扱いで幾つかの大きな変化が導入されました。
特に、
IndexOptions
ディレクティブは、現在では一つにマージされます。
<Directory /foo>
IndexOptions HTMLTable
IndexOptions SuppressColumnsorting
</Directory>
の結果は、次の指定と同一の結果になります。
IndexOptions HTMLTable SuppressColumnsorting
'+' や '-' 接頭辞の付いたキーワードに出会うとそれは、
その時点での IndexOptions
の設定 (これは上流のディレクトリを受け継ぎます)
に対して適応されます。
しかしながら、接頭辞の付かないキーワードが処理された場合は、
受け継いだオプション全てとそれまで出会った増減設定全てが
消去されます。次の例を考えてみてください:
IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing
IndexOptions +SuppressSize
最終的な効果は
IndexOptions FancyIndexing +SuppressSize
と同一です。
接頭辞の付かない FancyIndexing
でそれ以前の増減キーワードは無効になり、
その後の累積が始まるからです。
あるディレクトリにおいて上位のディレクトリに指定された設定に影響されることなく
IndexOptions を設定したい場合、
+ や -
接頭辞の付かないキーワードで設定してください。
| 説明: | ディレクトリインデックスの標準の順番付けを設定 |
|---|---|
| 構文: | IndexOrderDefault Ascending|Descending
Name|Date|Size|Description |
| デフォルト: | IndexOrderDefault Ascending Name |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
IndexOrderDefault ディレクティブは
FancyIndexing
インデックスオプションと併せて用いられます。
デフォルトでは、FancyIndexing
のディレクトリ一覧はファイル名の昇順で表示されます。
IndexOrderDefault
で、初期状態の表示順番を変えることができます。
IndexOrderDefault
は二つの引数をとります。一つ目はソートの方向を指示する
Ascending か Descending のいずれかです。
二つ目の引数は Name, Date,
Size か Description
のいずれか一つのキーワードであって、1つ目のソートキーを指定します。
2つ目のソートキーは常にファイル名の昇順になります。
このディレクティブと SuppressColumnSorting
インデックスオプションとを組み合わせることで、
ディレクトリ一覧をある特定の順番でのみ表示するようにできます。
これは、
クライアントが別の順番でディレクトリ一覧をリクエストすることを防ぎます。
| 説明: | ディレクトリインデックスに CSS スタイルシートを追加する |
|---|---|
| 構文: | IndexStyleSheet url-path |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
IndexStyleSheet ディレクティブは
インデックス表示に使用される CSS のファイル名を設定します。
IndexStyleSheet "/css/style.css"
| 説明: | インデックス一覧の最後に挿入されるファイルの名前 |
|---|---|
| 構文: | ReadmeName filename |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_autoindex |
ReadmeName ディレクティブは、
インデックスの終わりに付け加えられるファイルの名前を設定します。
filename は挿入するファイルの名前で、
一覧の行われている位置から相対的なものとして解釈されます。
filename がスラッシュで始まる場合は、
DocumentRoot
からの相対パスとなります。
ReadmeName FOOTER.html
ReadmeName /include/FOOTER.html
より詳細にまでこの挙動について記述している HeaderName
もご覧下さい。
Apache HTTP Server Version 2.4
| : | URI Ű Ͽ ijѴ. |
|---|---|
| : | Experimental |
| : | cache_module |
| ҽ: | mod_cache.c |
mod_cache ǻͿ ִ ̳
Ͻõ ij ִ RFC 2616
ȣȯ HTTP ij Ѵ. mod_cache
Ϸ (storage management module) ʿϴ.
⺻ ġ ΰ ִ:
mod_cache_diskmod_mem_cachemod_mem_cache ϱڸ ijϰų
(heap) ü ijϴ ΰ Ѱ
ϵ ִ. mod_mem_cache
ڽ ijϰų, (Ͻ(reverse proxy)
˷) ProxyPass
Ͽ mod_proxy
ij ִ.URI Ű ij ϰ ´. ٺȣ ijʴ´.
CacheDefaultExpire CacheDetailHeader CacheDisable CacheEnable CacheHeader CacheIgnoreCacheControl CacheIgnoreHeaders CacheIgnoreNoLastMod CacheIgnoreQueryString CacheIgnoreURLSessionIdentifiers CacheKeyBaseURL CacheLastModifiedFactor CacheLock CacheLockMaxAge CacheLockPath CacheMaxExpire CacheMinExpire CacheQuickHandler CacheStaleOnError CacheStoreExpired CacheStoreNoStore CacheStorePrivate| õ | õ þ |
|---|---|
#
# ij
#
LoadModule cache_module modules/mod_cache.so
<IfModule mod_cache.c>
#LoadModule cache_disk_module modules/mod_cache_disk.so
<IfModule mod_cache_disk.c>
CacheRoot c:/cacheroot
CacheSize 256
CacheEnable disk /
CacheDirLevels 5
CacheDirLength 3
</IfModule>
LoadModule mem_cache_module modules/mod_mem_cache.so
<IfModule mod_mem_cache.c>
CacheEnable mem /
MCacheSize 4096
MCacheMaxObjectCount 100
MCacheMinObjectSize 1
MCacheMaxObjectSize 2048
</IfModule>
</IfModule>
| : | ð ij ⺻ Ⱓ. |
|---|---|
| : | CacheDefaultExpire seconds |
| ⺻: | CacheDefaultExpire 3600 (one hour) |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
CacheDefaultExpire þ
ð ֱټð ij ʴ
⺻ ð Ѵ. CacheMaxExpire
ʴ´.
CacheDefaultExpire 86400
| : | Add an X-Cache-Detail header to the response. |
|---|---|
| : | |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | Ư URL ij ʴ´ |
|---|---|
| : | CacheDisable url-string |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
CacheDisable þ ϸ
mod_cache url-string
url ij ʴ´.
CacheDisable /local_files
| : | ڸ Ͽ URL ijѴ |
|---|---|
| : | CacheEnable cache_type url-string |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
CacheEnable þ ϸ
mod_cache url-string
url ijѴ. ij ڴ cache_type
ƱԸƮ Ѵ. cache_type mem
mod_mem_cache ϴ
ڸ Ѵ. cache_type disk
mod_cache_disk ϴ ũ
ڸ Ѵ. cache_type fd
mod_mem_cache ϴ ϱ ij
Ѵ.
(Ʒ ) URL ٸ
CacheEnable þ ġ
ڰ û óҶ ڸ
Ѵ. Ͽ CacheEnable
þ ڰ ȴ.
CacheEnable mem /manual
CacheEnable fd /images
CacheEnable disk /
| : | Add an X-Cache header to the response. |
|---|---|
| : | |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | Ŭ̾Ʈ ijʴ û Ѵ. |
|---|---|
| : | CacheIgnoreCacheControl On|Off |
| ⺻: | CacheIgnoreCacheControl Off |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
no-cache no-store ij
ʴ´. CacheIgnoreCacheControl
þ ̷ ൿ Ѵ.
CacheIgnoreCacheControl On ϸ
no-cache no-store ־
ijѴ. ʿ ij
ʴ´.
CacheIgnoreCacheControl On
| : | ij HTTP () ʴ´ |
|---|---|
| : | CacheIgnoreHeaders header-string [header-string] ... |
| ⺻: | CacheIgnoreHeaders None |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
RFC 2616 ȩ(hop-by-hop) HTTP ij
ʴ´. ȩ HTTP ,
CacheIgnoreHeaders
쿡 ij ʴ´.
ConnectionKeep-AliveProxy-AuthenticateProxy-AuthorizationTETrailersTransfer-EncodingUpgradeCacheIgnoreHeaders ij ϸ
ȵǴ HTTP ߰ Ѵ. , Ű(cookie)
ij ϸ ȵǴ 찡 ִ.
CacheIgnoreHeaders ij
HTTP ´. (RFC 2616
) ij ȩ ,
CacheIgnoreHeaders
None Ѵ.
CacheIgnoreHeaders Set-Cookie
CacheIgnoreHeaders None
CacheIgnoreHeaders Ͽ
Expires ij ʿ
, mod_cache Ѵ.
| : | 信 Last Modified ٴ Ѵ. |
|---|---|
| : | CacheIgnoreNoLastMod On|Off |
| ⺻: | CacheIgnoreNoLastMod Off |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
ֱټ ij ʴ´.
ֱټ ( mod_include ó߿)
ų ó ִ.
CacheIgnoreNoLastMod þ ֱټ
ݵ ijϵ . ֱټϰ
ð CacheDefaultExpire
þ ð Ѵ.
CacheIgnoreNoLastMod On
| : | Ignore query string when caching |
|---|---|
| : | |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | Ignore defined session identifiers encoded in the URL when caching |
|---|---|
| : | |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | Override the base URL of reverse proxied cache keys. |
|---|---|
| : | |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | LastModified ð ð ϴµ ϴ . |
|---|---|
| : | CacheLastModifiedFactor float |
| ⺻: | CacheLastModifiedFactor 0.1 |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
ð ֱټ ִ ֱټ
ð ð Ѵ.
CacheLastModifiedFactor þ
ð ϴ Ŀ factor
Ѵ:
expiry-period = time-since-last-modified-date * factor
expiry-date = current-date + expiry-period
, 10 ð Ǿ factor
0.1̶ Ⱓ 10*01 = 1 ð ȴ. ð
3:00pm̶ ð 3:00pm + 1ð = 4:00pm̴.
Ⱓ CacheMaxExpire ٸ
CacheMaxExpire Ѵ.
CacheLastModifiedFactor 0.5
| : | Enable the thundering herd lock. |
|---|---|
| : | |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | Set the maximum possible age of a cache lock. |
|---|---|
| : | |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | Set the lock path directory. |
|---|---|
| : | |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | ijϴ ʴ ִð |
|---|---|
| : | CacheMaxExpire seconds |
| ⺻: | CacheMaxExpire 86400 (Ϸ) |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
CacheMaxExpire þ
˻ʰ ij HTTP ִ ʴ
ִð Ѵ. , ִ ŭ Ǿ.
ð Ͽ ִ밪 Ų.
CacheMaxExpire 604800
| : | The minimum time in seconds to cache a document |
|---|---|
| : | |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | Run the cache from the quick handler. |
|---|---|
| : | |
| : | ּ, ȣƮ |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | Serve stale content in place of 5xx responses. |
|---|---|
| : | |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | Attempt to cache responses that the server reports as expired |
|---|---|
| : | |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
| : | Attempt to cache requests or responses that have been marked as no-store. |
|---|---|
| : | |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Experimental |
| : | mod_cache |
Documentation not yet translated. Please see English version of document.
Apache HTTP Server Version 2.4
| : | CERN Ÿ |
|---|---|
| : | Extension |
| : | cern_meta_module |
| ҽ: | mod_cern_meta.c |
CERN Ÿ 䳻. Ÿ ϴ Ͽ Ϲ ܿ ߰ HTTP ִ. ġ .asis ϰ ϰ, Expires: ϰų ٸ ű ϵ ִ. Ÿ ٷ پ, ̹ ϴ CERN ڵ ߴ.
| : | CERN Ÿ ã 丮 ̸ |
|---|---|
| : | MetaDir directory |
| ⺻: | MetaDir .web |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Extension |
| : | mod_cern_meta |
ġ Ÿ ã 丮 Ѵ.
丮 ִ 丮 ''
丮. "." ϸ 丮
ã´:
MetaDir .
ƴϸ ִ 丮 Ѵ:
MetaDir .meta
| : | CERN Ÿ óѴ |
|---|---|
| : | MetaFiles on|off |
| ⺻: | MetaFiles off |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Extension |
| : | mod_cern_meta |
丮 Ÿ óθ Ѵ.
| : | CERN Ÿ ϴ ̻ |
|---|---|
| : | MetaSuffix suffix |
| ⺻: | MetaSuffix .meta |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Extension |
| : | mod_cern_meta |
Ÿ ϴ ̻縦 Ѵ. ,
þ ⺻
DOCUMENT_ROOT/somedir/index.html ûϸ
DOCUMENT_ROOT/somedir/.web/index.html.meta
Ͽ MIME ߰Ѵ.
MetaSuffix .meta
Apache HTTP Server Version 2.4
| Description: | Managing domains across virtual hosts, certificate provisioning via the ACME protocol |
|---|---|
| Status: | Experimental |
| Module Identifier: | md_module |
| Source File: | mod_md.c |
| Compatibility: | Available in version 2.4.30 and later |
This module manages common properties of domains for one or more virtual hosts. Its serves two main purposes: for one, supervise/renew TLS certificates via the ACME protocol (RFC 8555). Certificates will be renewed by the module ahead of their expiration to account for disruption in internet services. There are ways to monitor the status of all certificates managed this way and configurations that will run your own notification commands on renewal, expiration and errors.
Second, mod_md offers an alternate OCSP Stapling implementation. This works with managed certificates as well as with certificates you configure yourself. OCSP Stapling is a necessary component for any https: site, influencing page load times and, depending on other setups, page availability. More in the stapling section below.
The default ACME Authority for managing certificates is Let's Encrypt, but it is possible to configure another CA that supports the protocol.
Simple configuration example:
MDomain example.org
<VirtualHost *:443>
ServerName example.org
DocumentRoot htdocs/a
SSLEngine on
# no certificates specification
</VirtualHost>
This setup will, on server start, contact
Let's Encrypt
to request a certificate for the domain. If Let's Encrypt can verify the ownership
of the domain, the module will retrieve the certificate and its chain, store it
in the local file system (see MDStoreDir)
and provide it, on next restart, to mod_ssl.
This happens while the server is already running. All other hosts will continue to work as before. While a certificate is not available, requests for the managed domain will be answered with a '503 Service Unavailable'.
This module requires mod_watchdog to be loaded as well.
Certificate sign-up and renewal with Let's Encrypt requires your server to be reachable on port 80 (http:) and/or port 443 (https:) from the public internet. (Unless your server is configured to use DNS for challenges - more on that under 'wildcard certificates')
The module will select from the methods offered by Let's Encrypt. Usually LE offers challenges on both ports and DNS and Apache chooses a method available.
To determine which one is available, the module looks at the ports
Apache httpd listens on. If those include port 80, it assumes that the
http: challenge (named http-01) is available. If the server listens
on port 443, the https: challenge (named tls-alpn-01) is also added to
the list. (And if MDChallengeDns01
is configured, the challenge dns-01 is added as well.)
If your setup is not so straight forward, there are two methods available
to influence this. First, look at MDPortMap
if the server is behind a portmapper, such as a firewall. Second, you may
override the module's guesswork completely by configuring
MDCAChallenges directly.
For domain verification via the TLS protocol `tls-alpn-01` is the name
of the challenge type. It requires the Apache server to listen on port 443
(see MDPortMap if you map that port
to something else).
Let's Encrypt will open a TLS connection to Apache using the special indicator `acme-tls/1` (this indication part of TLS is called ALPN, therefore the name of the challenge. ALPN is also used by browsers to request a HTTP/2 connection).
As with the HTTP/2 protocol, to allow this, you configure:
Protocols h2 http/1.1 acme-tls/1
And the `tls-alpn-01` challenge type is available.
Wildcard certificates are possible, but not straight-forward to use out of the box. Let's Encrypt requires the `dns-01` challenge verification for those. No other is considered good enough.
The difficulty here is that Apache cannot do that on its own. As the name implies, `dns-01` requires you to show some specific DNS records for your domain that contain some challenge data. So you need to _write_ your domain's DNS records.
If you know how to do that, you can integrated this with mod_md. Let's say you have a script for that in `/usr/bin/acme-setup-dns` you configure Apache with:
MDChallengeDns01 /usr/bin/acme-setup-dns
and Apache will call this script when it needs to setup/teardown a DNS challenge record for a domain.
Assuming you want a certificate for `*.mydomain.com`, mod_md will call:
/usr/bin/acme-setup-dns setup mydomain.com challenge-data # this needs to remove all existing DNS TXT records for # _acme-challenge.mydomain.com and create a new one with # content "challenge-data"
and afterwards it will call
/usr/bin/acme-setup-dns teardown mydomain.com # this needs to remove all existing DNS TXT records for # _acme-challenge.mydomain.com
Apache has a standard module for monitoring: mod_status.
mod_md contributes a section and makes monitoring your
domains easy.
You see all your MDs listed alphabetically, the domain names they contain, an overall status, expiration times and specific settings. The settings show your selection of renewal times (or the default), the CA that is used, etc.
The 'Renewal' column will show activity and error descriptions for certificate renewals. This should make life easier for people to find out if everything is all right or what went wrong.
If there is an error with an MD it will be shown here as well. This let's you assess problems without digging through your server logs.
There is also a new 'md-status' handler available to give you the MD information from 'server-status' in JSON format. You configure it as
<Location "/md-status"> SetHandler md-status </Location>
on your server. As with 'server-status' you will want to add authorization for this.
If you just want to check the JSON status of a specific domain, simply append that to your status url:
> curl https://<yourhost>/md-status/another-domain.org
{
"name": "another-domain.org",
"domains": [
"another-domain.org",
"www.another-domain.org"
],
...
This JSON status also shows a log of activities when domains are renewed:
{
"when": "Wed, 19 Jun 2019 14:45:58 GMT",
"type": "progress", "detail": "The certificate for the managed domain has been renewed successfully and can be used. A graceful server restart now is recommended."
},{
"when": "Wed, 19 Jun 2019 14:45:58 GMT",
"type": "progress", "detail": "Retrieving certificate chain for test-901-003-1560955549.org"
},{
"when": "Wed, 19 Jun 2019 14:45:58 GMT",
"type": "progress", "detail": "Waiting for finalized order to become valid"
},{
"when": "Wed, 19 Jun 2019 14:45:50 GMT",
"type": "progress", "detail": "Submitting CSR to CA for test-901-003-1560955549.org"
},
...
You will also find this information in the file `job.json` in your staging and, when activated, domains directory. This allows you to inspect these at any later point in time as well.
In addition, there is MDCertificateStatus which
gives access to relevant certificate information in JSON format.
If you want to try the stapling in one Managed Domain alone at first, configure:
<MDomain mydomain.net> MDStapling on </MDomain>
and use the 'server-status' and/or MDMessageCmd to see how it operates. You will
see if Stapling information is there, how long it is valid, from where it came and
when it will be refreshed.
If this all works to your satisfaction, you can switch it on for all your certificates or just your managed ones.
The existing stapling implementation by mod_ssl is used by many sites for years. There are two main differences between the mod_ssl and mod_md one:
If you are unlucky and restart your server during an outage of your CA's OCSP service, your users may no longer reach your sites. Without persistence your server cannot provide the client with the data and the client browser cannot get it as well, since the OCSP service is not responding.
The implementation in mod_md will have persisted it, load it again after restart and have it available for incoming connections. A day or two before this information expires, it will renew it, making it able to cope with a long OCSP service downtime.
Due to backward compatibility, the existing implementation in mod_ssl could not be changed drastically. For example, mod_ssl is unable to add a dependency to mod_watchdog without braking many existing installations (that do not load it).
Since version 2.4.14 of the module, you can use it to get certificates for your tailscale domains.
<MDomain mydomain.some-thing.ts.net> MDCertificateProtocol tailscale MDCertificateAuthority file://localhost/var/run/tailscale/tailscaled.sock", </MDomain>
Tailscale provides secure networking between your machines, where ever they are, and can provide domain names in the *.ts.net space for them. For those, it will then provide Let's Encrypt certificates as well, so you can open these domains in your browser securely.
The directives listed above tell Apache to contact the local tailscale demon for obtaining and renewing certificates. This will only work for the domain name that tailscale assigns to your machine.
Otherwise, these certificates work exactly like the ones retrieved via the ACME protocol from Lets Encrypt. You see them in status reporting and MDMessageCmd directives are executed for them as well.
More details are available at the mod_md github documentation.
Note that this feature only works on machines where the tailscale demon provides a unix domain socket. This, so far, seems only the case on *nix systems.
MDActivationDelay MDBaseServer MDCAChallenges MDCertificateAgreement MDCertificateAuthority MDCertificateCheck MDCertificateFile MDCertificateKeyFile MDCertificateMonitor MDCertificateProtocol MDCertificateStatus MDChallengeDns01 MDChallengeDns01Version MDCheckInterval MDContactEmail MDDriveMode MDExternalAccountBinding MDHttpProxy MDMatchNames MDMember MDMembers MDMessageCmd MDMustStaple MDNotifyCmd MDomain <MDomainSet> MDPortMap MDPrivateKeys MDProfile MDProfileMandatory MDRenewMode MDRenewWindow MDRequireHttps MDRetryDelay MDRetryFailover MDServerStatus MDStapleOthers MDStapling MDStaplingKeepResponse MDStaplingRenewWindow MDStoreDir MDStoreLocks MDWarnWindow| Description: | How long to delay activation of new certificates |
|---|---|
| Syntax: | MDActivationDelay duration |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.42 and later |
| Description: | Control if base server may be managed or only virtual hosts. |
|---|---|
| Syntax: | MDBaseServer on|off |
| Default: | MDBaseServer off |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Controls if the base server, the one outside all VirtualHosts should be managed by mod_md or not. By default, it will not. For the very reason that it may have confusing side-effects. It is recommended that you have virtual hosts for all managed domains and do not rely on the global, fallback server configuration.
| Description: | Type of ACME challenge used to prove domain ownership. |
|---|---|
| Syntax: | MDCAChallenges name [ name ... ] |
| Default: | MDCAChallenges tls-alpn-01 http-01 dns-01 |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Sets challenge types (in order of preference) when proving domain ownership. Supported by the module are the challenge methods 'tls-alpn-01', 'dns-01' and 'http-01'. The module will look at the overall configuration of the server to find out which methods can be used.
If the server listens on port 80, for example, the 'http-01' method is available.
The prerequisite for 'dns-01' is a configured MDChallengeDns01 command.
'tls-alpn-01' is described above in 'https: Challenges'.
This auto selection works for most setups. But since Apache is a very powerful server with many configuration options, the situation is not clear for all possible cases. For example: it may listen on multiple IP addresses where some are reachable on `https:` and some not.
If you configure MDCAChallenges directly, this auto selection is disabled.
Instead, the module will use the configured challenge list when talking to
the ACME server (a challenge type must be offered by the server as well).
This challenges are examined in the order specified.
| Description: | You confirm that you accepted the Terms of Service of the Certificate Authority. |
|---|---|
| Syntax: | MDCertificateAgreement accepted |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
When you use mod_md to obtain a certificate, you become a customer of the CA (e.g. Let's Encrypt). That means you need to read and agree to their Terms of Service, so that you understand what they offer and what they might exclude or require from you. mod_md cannot, by itself, agree to such a thing.
| Description: | The URL(s) of the ACME Certificate Authority to use. |
|---|---|
| Syntax: | MDCertificateAuthority url |
| Default: | MDCertificateAuthority letsencrypt |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
The URL(s) where the CA offers its service. Instead of the actual URL, you may use 'letsencrypt' or 'buypass'.
If you configure more than one URL, each one is tried in a round-robin
fashion after a number of failures. You can configure how quickly or
delayed that happens via the MDRetryDelay and
MDRetryFailover directives. The default setting
makes a failover after about half a day of trying.
All other settings apply to each of these URLs. It is therefore
not possible to have two with different
MDExternalAccountBindings, for example.
For testing, CAs commonly offer a second service URL. The 'test' service does not give certificates valid in a browser, but are more relaxed in regard to rate limits. This allows for verification of your own setup before switching to the production service URL.
MDCertificateAuthority https://acme-staging-v02.api.letsencrypt.org/directory
| Description: | Set name and URL pattern for a certificate monitoring site. |
|---|---|
| Syntax: | MDCertificateCheck name url |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.42 and later |
| Description: | Specify a static certificate file for the MD. |
|---|---|
| Syntax: | MDCertificateFile path-to-pem-file |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
This is used inside a MDomainSet and specifies
the file holding the certificate chain for the Managed Domain. The matching
key is specified via MDCertificateKeyFile.
<MDomain mydomain.com> MDCertificateFile /etc/ssl/my.cert MDCertificateKeyFile /etc/ssl/my.key </MDomain>
This is that equivalent of the mod_ssl
SSLCertificateFile directive. It
has several uses.
If you want to migrate an existing domain, using static files, to
automated Let's Encrypt certificates, for one. You define the
MDomainSet, add the files here and remove
the SSLCertificateFile from
your VirtualHosts.
This will give you the same as before, with maybe less repeating lines
in your configuration. Then you can add MDRenewMode
'always' to it and the module will get a new certificate before
the one from the file expires. When it has done so, you remove the
MDCertificateFile and reload the server.
Another use case is that you renew your Let's Encrypt certificates with another ACME clients, for example the excellent certbot. Then let your MDs point to the files from certbot and have both working together.
| Description: | Specify a static private key for for the static cerrtificate. |
|---|---|
| Syntax: | MDCertificateKeyFile path-to-file |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
This is used inside a MDomainSet and specifies
the file holding the private key for the Managed Domain. The matching
certificate is specified via MDCertificateFile.
This is that equivalent of the mod_ssl
SSLCertificateKeyFile directive.
| Description: | The URL of a certificate log monitor. |
|---|---|
| Syntax: | MDCertificateMonitor name url |
| Default: | MDCertificateMonitor crt.sh https://crt.sh?q= |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
This is part of the 'server-status' HTML user interface and has nothing to do with the core functioning itself. It defines the link offered on that page for easy checking of a certificate monitor. The SHA256 fingerprint of the certificate is appended to the configured url.
Certificate Monitors offer supervision of Certificate Transparency (CT) Logs to track the use of certificates for domains. The least you may see is that Let's Encrypt (or whichever CA you have configured) has entered your certificates into the CTLogs.
Caveat: certificate logs update and monitor's intakes of those updates suffer some delay. This varies between logs and monitors. A brand new certificate will not be known immediately.
| Description: | The protocol to use with the Certificate Authority. |
|---|---|
| Syntax: | MDCertificateProtocol protocol |
| Default: | MDCertificateProtocol ACME |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Specifies the protocol to use. Currently, only ACME is supported.
| Description: | Exposes public certificate information in JSON. |
|---|---|
| Syntax: | MDCertificateStatus on|off |
| Default: | MDCertificateStatus on |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
When enabled, a resources is available in Managed Domains at 'https://domain/.httpd/certificate-status' that returns a JSON document list key properties of the current and of a renewed certificate - when available.
{
"valid-until": "Thu, 29 Aug 2019 16:06:35 GMT",
"valid-from": "Fri, 31 May 2019 16:06:35 GMT",
"serial": "03039C464D454EDE79FCD2CAE859F668F269",
"sha256-fingerprint": "1ff3bfd2c7c199489ed04df6e29a9b4ea6c015fe8a1b0ce3deb88afc751e352d"
"renewal" : { ...renewed cert information... }
}
| Description: | Set the command for setup/teardown of dns-01 challenges |
|---|---|
| Syntax: | MDChallengeDns01 path-to-command |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Define a program to be called when the `dns-01` challenge needs to be setup/torn down.
The program is given the argument `setup` or `teardown` followed by the domain name.
For `setup` the challenge content is additionally given. When
MDChallengeDns01Version is set to 2,
the `teardown` also gets the challenge content as argument.
You do not need to specify this, as long as a 'http:' or 'https:' challenge method is possible. However, Let's Encrypt makes 'dns-01' the only challenge available for wildcard certificates. If you require one of those, you need to configure this.
It is now possible to use this directive inside a MDomain
section to specify a specific command for that domain. This allows to configure
a script specific for the particular DNS provider involved.
See the section about wildcard certificates above for more details.
| Description: | Set the type of arguments to call MDChallengeDns01 with |
|---|---|
| Syntax: | MDChallengeDns01Version 1|2 |
| Default: | MDChallengeDns01Version 1 |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.58 and later |
Set the way MDChallengeDns01 command is invoked, e.g the number and
types of arguments. See MDChallengeDns01
for the differences.
This setting is global and cannot be varied per domain.
| Description: | Determines how often certificates are checked |
|---|---|
| Syntax: | MDCheckInterval duration |
| Default: | MDCheckInterval 12h |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.60 and later |
The time between certificate checks. By default, the validity and need for renewals is checked twice a day. This interval is not followed precisely. Instead the module randomly applies a +/-50% jitter to it. With the default of 12 hours, this means the actual time between runs varies between 6 and 18 hours, jittered anew every run. This helps to mitigate traffic peaks at ACME servers.
The minimum duration you may configure is 1 second. It is not recommended to use such short times in production.
| Description: | Email address used for account registration |
|---|---|
| Syntax: | MDContactEmail address |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.42 and later |
The ACME protocol requires you to give a contact url when you sign up. Currently,
Let's Encrypt wants an email address (and it will use it to inform you about renewals
or changed terms of service). mod_md uses the MDContactEmail directive email in
your Apache configuration, so please specify the correct address there.
If MDContactEmail is not present, mod_md will use the
ServerAdmin directive.
| Description: | former name of MDRenewMode. |
|---|---|
| Syntax: | MDDriveMode always|auto|manual |
| Default: | MDDriveMode auto |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
This directive exists for backward compatibility as the old name for
MDRenewMode.
| Description: | Set the external account binding keyid and hmac values to use at CA |
|---|---|
| Syntax: | MDExternalAccountBinding key-id hmac-64 | none | file |
| Default: | MDExternalAccountBinding none |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.52 and later |
Configure values for ACME "External Account Binding", a feature of the ACME standard that allows clients to bind registrations to an existing customer account on ACME servers.
Let's Encrypt does not require those, but other ACME CAs do. Check with your ACME CA if you need those and how to obtain the values. They are two strings, a key identifier and a base64 encoded 'hmac' value.
You can configure those globally or for a specific MDomain. Since these values allow anyone to register under the same account, it is advisable to give the configuration file restricted permissions, e.g. root only.
The value can also be taken from a JSON file, to keep more open permissions on the server configuration and restrict the ones on that file. The JSON itself is:
{"kid": "kid-1", "hmac": "zWND..."}
If you change EAB values, the new ones will be used when the next certificate renewal is due.
| Description: | Define a proxy for outgoing connections. |
|---|---|
| Syntax: | MDHttpProxy url |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Use a http proxy to connect to the MDCertificateAuthority. Define this
if your webserver can only reach the internet with a forward proxy.
| Description: | Determines how DNS names are matched to vhosts |
|---|---|
| Syntax: | MDMatchNames all|servernames |
| Default: | MDMatchNames all |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.58 and later |
The mode `all` is the behaviour as in all previous versions. Both ServerName and ServerAlias are inspected to find the MDomain matching a VirtualHost. This automatically detects coverage, even when you only have added one of the names to an MDomain.
However, this auto-magic has drawbacks in more complex setups. If you set this directive to `servernames`, only the ServerName of a virtual host is used for matching. ServerAliases are disregarded then, for matching. Aliases will still be added to the certificate obtained, unless you also run `MDMembers manual`.
Another advantage of `servernames` is that it gives you more flexibility with sub-domains and wildcards. You can define one MDomain with a wildcard and have other MDomains for specific sub-domain names.
| Description: | Additional hostname for the managed domain. |
|---|---|
| Syntax: | MDMember hostname |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Instead of listing all dns names on the same line, you may use
MDMember to add such names
to a managed domain.
<MDomain example.org>
MDMember www.example.org
MDMember mail.example.org
</MDomain>
If you use it in the global context, outside a specific MD, you can only
specify one value, 'auto' or 'manual' as the default for all other MDs. See
MDomain for a
description of these special values.
| Description: | Control if the alias domain names are automatically added. |
|---|---|
| Syntax: | MDMembers auto|manual |
| Default: | MDMembers auto |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Defines if the ServerName and
ServerAlias values of a VirtualHost
are automatically added to the members of a Managed Domain or not.
| Description: | Handle events for Manage Domains |
|---|---|
| Syntax: | MDMessageCmd path-to-cmd optional-args |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
This command gets called when one of the following events happen for a Managed Domain: "renewed", "installed", "expiring", "errored". The command may be invoked for more than these in the future and ignore events it is not prepared to handle.
This is the more flexible companion to MDNotifyCmd.
MDMessageCmd /etc/apache/md-message
# will be invoked when a new certificate for mydomain.org is available as:
/etc/apache/md-message renewed mydomain.com
The program should not block, as the module will wait for it to finish. A return code other than 0 is regarded as an error.
'errored' is no immediate cause for concern since renewal is attempted early enough to allow the internet to come back. This is reported at most once per hour.
'expiring' should be taken serious. It is issued when the
MDWarnWindow is reached. By default this is
10% of the certificate lifetime, so for Let's Encrypt this currently
means 9 days before it expires. The warning is repeated at most once
a day.
'renewed' means that a new certificate has been obtained and is stored in the 'staging' area in the MD store. It will be activated on the next server restart/reload.
'installed' is triggered when a new certificate has been transferred from
staging into the domains location in MD store. This happens at server
startup/reload. Different to all other invocations, MDMessageCmd is run
with root permissions (on *nix systems) and has access to the certificate
files (and keys). Certificates needed for other applications or
in different formats can be processed on this event.
'renewing' event is triggered before starting renew process for the managed domain. Should the command return != 0 for this reason, renew will be aborted and repeated on next cycle. Some cluster setups use this to allow renewals to run only on a single node.
'challenge-setup:type:domain' event is triggered when the challenge data for a domain has been created. This is invoked before the ACME server is told to check for it. The type is one of the ACME challenge types. This is invoked for every DNS name in a MDomain. Cluster setups may use this event to distribute challenge files to all nodes in a cluster.
ocsp-errored happens when MDStapling
is enabled for a domain, this indicates
that an error was encountered retrieving the OCSP response from the
Certificate Authority. mod_md will continue trying.
| Description: | Control if new certificates carry the OCSP Must Staple flag. |
|---|---|
| Syntax: | MDMustStaple on|off |
| Default: | MDMustStaple off |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Defines if newly requested certificate should have the OCSP Must Staple flag
set or not. If a certificate has this flag, the server is required to send a
OCSP stapling response to every client. This only works if you configure
mod_ssl to generate this (see SSLUseStapling
and friends).
| Description: | Run a program when a Managed Domain is ready. |
|---|---|
| Syntax: | MDNotifyCmd path [ args ] |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
The configured executable is run when a Managed Domain has signed up or renewed its certificate. It is given the name of the processed MD as additional arguments (after the parameters specified here). It should return status code 0 to indicate that it has run successfully.
| Description: | Define list of domain names that belong to one group. |
|---|---|
| Syntax: | MDomain dns-name [ other-dns-name... ] [auto|manual] |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
All the names in the list are managed as one Managed Domain (MD).
mod_md will request one single certificate that is valid for all these names. This
directive uses the global settings (see other MD directives below). If you
need specific settings for one MD, use
the <MDomainSet>.
There are 2 additional settings that are necessary for a Managed Domain:
a contact Email address (via MDContactEmail or ServerAdmin)
and MDCertificateAgreement.
The mail address of ServerAdmin
is used to register at the CA (Let's Encrypt by default).
The CA may use it to notify you about
changes in its service or status of your certificates.
The second setting, MDCertificateAgreement,
should have the value "accepted". By specifying this, you confirm that your
accept the Terms of Service of the CA.
MDContactEmail admin@example.org
MDCertificateAgreement accepted
MDomain example.org www.example.org
<VirtualHost *:443>
ServerName example.org
DocumentRoot htdocs/root
SSLEngine on
</VirtualHost>
<VirtualHost *:443>
ServerName www.example.org
DocumentRoot htdocs/www
SSLEngine on
</VirtualHost>
There are two special names that you may use in this directive: 'manual' and 'auto'. This determines if a Managed Domain shall have exactly the name list as is configured ('manual') or offer more convenience. With 'auto' all names of a virtual host are added to a MD. Conveniently, 'auto' is also the default.
MDomain example.org
<VirtualHost *:443>
ServerName example.org
ServerAlias www.example.org
DocumentRoot htdocs/root
SSLEngine on
</VirtualHost>
MDomain example2.org auto
<VirtualHost *:443>
ServerName example2.org
ServerAlias www.example2.org
...
</VirtualHost>
In this example, the domain 'www.example.org' is automatically added to the MD 'example.org'. Similarly for 'example2.org' where 'auto' is configured explicitly. Whenever you add more ServerAlias names to this virtual host, they will be added as well to the Managed Domain.
If you prefer to explicitly declare all the domain names, use 'manual' mode. An error will be logged if the names do not match with the expected ones.
| Description: | Container for directives applied to the same managed domains. |
|---|---|
| Syntax: | <MDomainSet dns-name [ other-dns-name... ]>...</MDomainSet> |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
This is the directive MDomain
with the added possibility to add setting just for this MD. In fact,
you may also use "<MDomain ..>" as a shortcut.
This allows you to configure an MD that uses another Certificate Authority, have other renewal requirements, etc.
<MDomain sandbox.example.org>
MDCertificateAuthority https://someotherca.com/ACME
</MDomain>
A common use case is to configure https: requirements separately for your domains.
<MDomain example.org>
MDRequireHttps temporary
</MDomain>
| Description: | Map external to internal ports for domain ownership verification. |
|---|---|
| Syntax: | MDPortMap map1 [ map2 ] |
| Default: | MDPortMap http:80 https:443 |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
The ACME protocol provides two methods to verify domain ownership via
HTTP: one that uses 'http:' urls (port 80) and one for 'https:' urls
(port 443). If your server is not reachable by at least one
of the two, ACME may only work by configuring your DNS server,
see MDChallengeDns01.
On most public facing servers, 'http:' arrives on port 80 and 'https:' on port 443. The module checks the ports your Apache server is listening on and assumes those are available. This means that when your server does not listen on port 80, it assumes that 'http:' requests from the internet will not work.
This is a good guess, but it may be wrong. For example, your Apache might listen to port 80, but your firewall might block it. 'http:' is only available in your intranet. So, the module will falsely assume that Let's Encrypt can use 'http:' challenges with your server. This will then fail, because your firewall will drop those.
MDPortMap http:- https:8433
The above example shows how you can specify that 'http:' requests from the internet will never arrive. In addition it says that 'https:' requests will arrive on local port 8433.
This is necessary if you have port forwarding in place, your server may be reachable from the Internet on port 443, but the local port that httpd uses is another one. Your server might only listen on ports 8443 and 8000, but be reached on ports 443 and 80 (from the internet).
| Description: | Set type and size of the private keys generated. |
|---|---|
| Syntax: | MDPrivateKeys type [ params... ] |
| Default: | MDPrivateKeys RSA 2048 |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Defines what kind of private keys are generated for a managed domain and with what parameters. You can have more than one private key type configured and the module will obtain a certificate for each key.
For example, you may configure an RSA and an Elliptic Curve (EC) key, so that 2 certificates are created for a domain. On a client connection, the first one supported by the client will then be used.
Since EC keys and certificates are smaller, you might want to offer them first for all compatible (modern) clients. This can enable faster handshakes. Add an RSA key type to support older clients.
MDPrivateKeys secp256r1 rsa3072
The EC types supported depend on the CA you use. For Let's encrypt the supported curves include 'secp256r1' and 'secp384r1'.
Each key and certificate type is stored in its own file in the MD store. The key type is part of the file name with some backward compatible naming for RSA certificates. So you may continue sharing these files with other applications.
Please note that this setting only has an effect on new keys. Any existing private key you have remains unaffected. Also, this only affects private keys generated for certificates. ACME account keys are unaffected by this.
| Description: | Use a specific ACME profile from the CA |
|---|---|
| Syntax: | MDProfile name |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.64 and later |
This about a non-standard ACME extension by Let's Encrypt.
Lets Encrypt announced they will add Certificate Profiles support in their CA during 2025, beginning with their staging servers. This, among some other details, let's you select the lifetime of the certificates you get. The "default" profile will keep the 90 days and a "tlsserver" profile will issue certificates with only 6 days of validity.
If you do not change your mod_md configuration, you will continue to get the 90 days certificates. Should you believe that a shorter lifetime is beneficial for you (and take the risk that the renewal time is way shorter), you can configure the profile to use via 'MDProfile tlsserver'.
The profile names are defined by the CA. If a profile you configure is not available, no profile will be used and the certificate will be issue according to what the CA considers default.
See MDProfileMandatory
on how to disable defaults for profiles.
| Description: | Control if an MDProfile is mandatory. |
|---|---|
| Syntax: | MDProfileMandatory on|off |
| Default: | MDProfileMandatory off |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Controls if a MDProfile
you configure is mandatory or not. When mandatory and the CA
does not offer a configured profile, the certificate
renewal will fail.
When not mandatory and a profile is not offered by the CA, renewals will be performed without specifying a profile and the CA will issue a certificates according to its defaults.
| Description: | Controls if certificates shall be renewed. |
|---|---|
| Syntax: | MDRenewMode always|auto|manual |
| Default: | MDRenewMode auto |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
In the default 'auto' mode, the module will do what makes most sense of each Managed Domain. For a domain without any certificates, it will obtain them from the Certificate Authority.
However, if you have defined an MD that is not used by any of Apache's
VirtualHosts, it will not bother. And for MDs with static certificate
files (see MDCertificateFile),
it assumes that you have your own source, and will not renew them either.
You can override this default in either way. If you specify 'always', the module will renew certificates for an MD, regardless if the domains are in use or if there are static files.
For the opposite effect, configure 'manual' and no renewal will be attempted.
| Description: | Control when a certificate will be renewed. |
|---|---|
| Syntax: | MDRenewWindow duration |
| Default: | MDRenewWindow 33% |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
If the validity of the certificate falls below duration, mod_md will get a new signed certificate.
Normally, certificates are valid for around 90 days and mod_md will renew them the earliest 33% of their complete lifetime before they expire (so for 90 days validity, 30 days before it expires). If you think this is not what you need, you can specify either the exact time, as in:
# 21 days before expiry MDRenewWindow 21d # 30 seconds (might be close) MDRenewWindow 30s # 10% of the cert lifetime MDRenewWindow 10%
When in auto drive mode, the module will check every 12 hours at least what the status of the managed domains is and if it needs to do something. On errors, for example when the CA is unreachable, it will initially retry after some seconds. Should that continue to fail, it will back off to a maximum interval of hourly checks.
| Description: | Redirects http: traffic to https: for Managed Domains. |
|---|---|
| Syntax: | MDRequireHttps off|temporary|permanent |
| Default: | MDRequireHttps off |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
This is a convenience directive to ease http: to https: migration of your Managed Domains. With:
MDRequireHttps temporary
you announce that you want all traffic via http: URLs to be redirected to the https: ones, for now. This is safe and you can remove this again at any time.
The following has consequences: if you want client to no longer use the http: URLs, configure:
MDRequireHttps permanent
This does two things:
http: resources are redirected to the
same url with the https: scheme using the 301
status code. This tells clients that this is intended to be forever and
the should update any links they have accordingly.
https: requests will carry the header
Strict-Transport-Security with a life time of half a year.
This tells the browser that it never (for half a year) shall use http:
when talking to this domain name. Browsers will, after having seen this, refuse
to contact your unencrypted site. This prevents malicious middleware to
downgrade connections and listen/manipulate the traffic. Which is good. But
you cannot simply take it back again.
You can achieve the same with mod_alias and some
Redirect configuration,
basically. If you do it yourself, please make sure to exclude the paths
/.well-known/* from your redirection, otherwise mod_md
might have trouble signing on new certificates.
If you set this globally, it applies to all managed domains. If you want it for a specific domain only, use:
<MDomain xxx.yyy> MDRequireHttps temporary </MDomain>
| Description: | Time length for first retry, doubled on every consecutive error. |
|---|---|
| Syntax: | MDRetryDelay duration |
| Default: | MDRetryDelay 5s |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.54 and later |
The amount of time to wait after an error before trying to renew a certificate again. This duration is doubled after each consecutive error with a maximum of 24 hours.
It is kept separate for each certificate renewal. Meaning an error on one MDomain does not delay the renewals of other domains.
| Description: | The number of errors before a failover to another CA is triggered |
|---|---|
| Syntax: | MDRetryFailover number |
| Default: | MDRetryFailover 13 |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.54 and later |
The number of consecutive errors on renewing a certificate before
another CA is selected. This only applies to configurations that
have more than one MDCertificateAuthority
specified.
| Description: | Control if Managed Domain information is added to server-status. |
|---|---|
| Syntax: | MDServerStatus on|off |
| Default: | MDServerStatus on |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Apaches 'server-status' handler allows you configure a resource to monitor what is going on. This includes now a section listing all Managed Domains with the DNS names, renewal status, lifetimes and main properties.
You can switch that off using this directive.
| Description: | Enable stapling for certificates not managed by mod_md. |
|---|---|
| Syntax: | MDStapleOthers on|off |
| Default: | MDStapleOthers on |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.42 and later |
This setting only takes effect when MDStapling is enabled. It controls
if mod_md should also provide stapling information for certificates
that are not directly controlled by it, e.g. renewed via an ACME CA.
| Description: | Enable stapling for all or a particular MDomain. |
|---|---|
| Syntax: | MDStapling on|off |
| Default: | MDStapling off |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.42 and later |
mod_md offers an implementation for providing OCSP stapling information.
This is an alternative to the one provided by mod_ssl. For backward
compatibility, this is disabled by default.
The stapling can be switched on for all certificates on the server or
for an individual MDomain.
This will replace any stapling configuration
in mod_ssl for these hosts. When disabled, the mod_ssl stapling
will do the work (if it is itself enabled, of course). This allows for
a gradual shift over from one implementation to the other.
The stapling of mod_md will also work for domains where the certificates
are not managed by this module (see MDStapleOthers for how to control this).
This allows use of the new stapling without using any ACME certificate
management.
| Description: | Controls when old responses should be removed. |
|---|---|
| Syntax: | MDStaplingKeepResponse duration |
| Default: | MDStaplingKeepResponse 7d |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.42 and later |
This time window specifies when OCSP response data used in stapling shall be removed from the store again. Response information older than 7 days (default) is deleted on server restart/reload. This keeps the store from growing when certificates are renewed/reconfigured frequently.
| Description: | Control when the stapling responses will be renewed. |
|---|---|
| Syntax: | MDStaplingRenewWindow duration |
| Default: | MDStaplingRenewWindow 33% |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.42 and later |
If the validity of the OCSP response used in stapling falls below duration,
mod_md will obtain a new OCSP response.
The CA issuing a certificate commonly also operates the OCSP responder service and determines how long its signed response about the validity of a certificate are itself valid. The longer a response is valid, the longer it can be cached which mean better overall performance for everyone. The shorter the life time, the more rapidly certificate revocations spread to clients. Also, service reliability is a consideration.
By adjusting the stapling renew window you can control parts of this yourself. If you make the renew time short (e.g. a short time before the current information expires), you gain maximum cache time. But a service outage (down for maintenance, for example) will affect you. If you renew a long time before expiry, updates will be made more frequent, cause more load on the CA server infrastructure and also more coordination between the child processes of your server.
The default is chosen as 33%, which means renewal is started when only a third of the response lifetime is left. For a CA that issues OCSP responses with lifetime of 3 days, this means 2 days of caching and 1 day for renewal attempts. A service outage would have to last full 24 hours to affect your domains.
Setting an absolute renew window, like `2d` (2 days), is also possible.
| Description: | Path on the local file system to store the Managed Domains data. |
|---|---|
| Syntax: | MDStoreDir path |
| Default: | MDStoreDir md |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
Defines where on the local file system the Managed Domain data is stored. This is an absolute path or interpreted relative to the server root. The default will create a directory 'md' in your server root.
If you move this and have already data, be sure to move/copy the data first to the new location, reconfigure and then restart the server. If you reconfigure and restart first, the server will try to get new certificates that it thinks are missing.
| Description: | Configure locking of store for updates |
|---|---|
| Syntax: | MDStoreLocks on|off|duration |
| Default: | MDStoreLocks off |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
| Compatibility: | Available in version 2.4.55 and later |
Enable this to use a lock file on server startup when
MDStoreDir is synchronized with the server
configuration and renewed certificates are activated.
Locking is intended for setups in a cluster that have a shared file system for MDStoreDir. It will protect the activation of renewed certificates when cluster nodes are restarted/reloaded at the same time. Under the condition that the shared file system does support file locking.
The default duration to obtain the lock is 5 seconds. If the log cannot be obtained, an error is logged and the server startup will continue. This may result in a cluster node to still use the previous certificate afterwards.
A higher timeout will reduce that likelihood, but may delay server startups/reloads in case the locks are not properly handled in the underlying file system. A lock should only be held by a httpd instance for a short duration.
| Description: | Define the time window when you want to be warned about an expiring certificate. |
|---|---|
| Syntax: | MDWarnWindow duration |
| Default: | MDWarnWindow 10% |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_md |
See MDRenewWindow for a description on
how you can specify the time.
The modules checks the remaining lifetime of certificates and invokes
MDMessageCmd when there is less than the warn
window left. With the default, this mean 9 days for certificates from
Let's Encrypt.
It also applies to Managed Domains with static certificate files (
see MDCertificateFile).
Apache HTTP サーバ バージョン 2.4
| 説明: | 外部 CGI デーモンを使った CGI スクリプトの実行 |
|---|---|
| ステータス: | Base |
| モジュール識別子: | cgid_module |
| ソースファイル: | mod_cgid.c |
| 互換性: | Unix のスレッド MPM のみ |
最適化が施されていることと、以下で説明されている追加の ScriptSock ディレクティブを除いては、
mod_cgid は mod_cgi と同様の
動作をします。Apache と CGI に関する詳細は
mod_cgi の概要を読んでください。
Unix オペレーティングシステムの中には、マルチスレッドのサーバから
プロセスを fork するのが非常にコストの高い動作になっているものがあります。
理由は、新しいプロセスが親プロセスのスレッドすべてを複製するからです。
各 CGI 起動時にこのコストがかかるのを防ぐために、mod_cgid
は子プロセスを fork して CGI スクリプトを実行するための
外部デーモンを実行します。
主サーバは unix ドメインソケットを使ってこのデーモンと通信します。
コンパイル時にマルチスレッド MPM が選ばれたときは
mod_cgi の代わりに必ずこのモジュールが使用されます。
ユーザのレベルではこのモジュールの設定と動作は mod_cgi
とまったく同じです。唯一の例外は ScriptSock ディレクティブの
追加で、このディレクティブは CGI デーモンとの通信用のソケットの名前を
指定します。
| 説明: | The length of time to wait for more output from the CGI program |
|---|---|
| 構文: | CGIDScriptTimeout time[s|ms] |
| デフォルト: | value of |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Base |
| モジュール: | mod_cgid |
| 互換性: | Available in httpd 2.4.10 and later; in prior releases no timeout was applied |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | CGI デーモンとの通信に使われるソケットのファイル名の接頭辞 |
|---|---|
| 構文: | ScriptSock file-path |
| デフォルト: | ScriptSock logs/cgisock |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Base |
| モジュール: | mod_cgid |
このディレクティブは CGI デーモンとの通信に使われるソケットの ファイル名の接頭辞を設定します。また、ファイル名にはサーバのプロセスIDが 追加されます。ソケットは Apache が起動されたユーザ (通常 root) の パーミッションを用いてオープンされます。CGI スクリプトとの通信の セキュリティを保つために、ソケットの存在するディレクトリに 他のユーザが書き込み権限を持っていないようにすることが重要です。
ScriptSock /var/run/cgid.sock
Apache HTTP Server Version 2.4
| : | CGI ũƮ |
|---|---|
| : | Base |
| : | cgi_module |
| ҽ: | mod_cgi.c |
mime type application/x-httpd-cgḭų
(ġ 1.1 ) ڵ鷯 cgi-script
CGI ũƮ νϿ, ϰ, Ŭ̾Ʈ
. AddType
þ Ȯڸ ų, ScriptAlias 丮 ȿ
CGI óȴ.
CGI ũƮ θ DOCUMENT_ROOT
ȯ溯 ߰Ѵ. DocumentRoot .
ġ CGI ũƮ ϴ Ұ CGI 丮 ϶.
н ߾ MPM Ѵٸ
mod_cgid ؾ Ѵ.
忡 ⺻ ϴ.
CGI ǥ ϴ CGI ȯ溯 Ѵ:
AcceptPathInfo þ off
쿡 Ѵ. AcceptPathInfo ⺻
ִ û 404 NOT FOUND ,
mod_cgi (URI ũƮ
ϸ ڿ /more/path/info) ´.
AcceptPathInfo þ ϸ
mod_cgi û ؼ AcceptPathInfo On
Ͱ .HostnameLookups on̰ (⺻
off), ȣƮ ּҸ DNS ˻Ͽ ȣƮ
ã 쿡 Ѵ.IdentityCheck on̰,
ȣƮ ident ϴ 쿡 Ѵ.
ֱ
ȵǰ, Ŭ̾Ʈ ̿ Ͻð ִٸ
ǹ ϶. ߸ Ǵ ũƮ (ǥ° ǥؿ) CGI ũƮ ϱ . ġ 1.2 Ŀ ߰ þ ϸ ڼ α ִ.
CGI α״ CGI Ѵ. CGI ũƮ α . ù° Ʒ ̴:
%% [ð] û
%% HTTP- CGI-ũƮ-ϸ
CGI ũƮ αϿ ߰ Ѵ:
%%error
ũƮ ( ũƮ ) ߸ ȯϴ , α Ѵ:
%request
HTTP
(ִٸ) POST PUT
%response
CGI ũƮ
%stdout
CGI ǥ
%stderr
CGI ǥؿ
(ũƮ ǥ̳ ǥؿ ƹ 뵵 ʾҴٸ %stdout %stderr κ ִ).
| : | The length of time to wait for more output from the CGI program |
|---|---|
| : | CGIScriptTimeout time[s|ms] |
| ⺻: | value of |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Base |
| : | mod_cgi |
| : | Available in version 2.4.59 and later. |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | CGI ũƮ α ġ |
|---|---|
| : | ScriptLog file-path |
| : | ּ, ȣƮ |
| : | Base |
| : | mod_cgi, mod_cgid |
ScriptLog þ CGI ũƮ
α Ѵ. ScriptLog
α ʴ´. ϸ ƱԸƮ
Ͽ CGI Ѵ. θ ϸ
ServerRoot η
Ƶδ.
ScriptLog logs/cgi_log
ڽ μ ϴ , User þ
α . ڰ ũƮ αװ
ִ 丮 ִ, ̸
ڿ Ѵ. ũƮ α α
丮 дٸ ڽ μ ϴ ڿ
ֱ 丮 .
ũƮ α״ CGI ũƮ ۼҶ 뵵 ϴ ϱ ƴ ϶. ӵ ȿ鿡 ȭ ȵְ, ̿ ϸ Ȼ ִ.
| : | ũƮ α PUT Ȥ POST û ִ뷮 |
|---|---|
| : | ScriptLogBuffer bytes |
| ⺻: | ScriptLogBuffer 1024 |
| : | ּ, ȣƮ |
| : | Base |
| : | mod_cgi, mod_cgid |
ū Ƽ α ʹ Ŀ Ͽ PUT Ȥ POST ũ⸦ Ѵ. ⺻ 1024 Ʈ α , þ Ͽ ִ.
Apache HTTP Server Version 2.4
| : | ȯ |
|---|---|
| : | Experimental |
| : | charset_lite_module |
| ҽ: | mod_charset_lite.c |
̰, ְ
ؾ Ѵ. ϴ ϴ
mod_charset_lite غ.
mod_charset_lite Ͽ
հ Ŭ̾Ʈ ȯ
ִ. mod_charset_lite
ڷḦ ȯʰ ġ ȯ϶ ûѴ.
mod_charset_lite EBCDIC ASCII ȯ濡
ִ. EBCDIC ȯ濡 ġ ġ μ
ڵ ISO-8859-1 ȯѴ.
mod_charset_lite Ͽ ٸ ȯ
ִ. ASCII ȯ濡 ġ ⺻ ȯ
ʱ, ȯ ؼ
mod_charset_lite ʿϴ.
þ ġ mod_charset
ϴ Ϻθ Ѵ.
mod_charset_lite ϴ ý
ARP CharsetSourceEnc
CharsetDefault
Ķ ̸ ó ־ Ѵ.
̸ ǥȭ ʾҰ, http ϴ
ʴ. APR iconv(3) ϱ,
iconv(1) α Ͽ Ư
̸ ִ ִ:
iconv -f charsetsourceenc-value -t charsetdefault-value
ȯĢ Ȳ ȯ ִ:
| : | ȯ |
|---|---|
| : | CharsetDefault charset |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Experimental |
| : | mod_charset_lite |
CharsetDefault þ þ
ġ ִ ȯ Ѵ.
charset ƱԸƮ APR ϴ ̸ ؾ Ѵ. Ϲ iconv ϴ ǹѴ.
<Directory /export/home/trawick/apacheinst/htdocs/convert>
CharsetSourceEnc UTF-16BE
CharsetDefault ISO-8859-1
</Directory>
| : | ȯ |
|---|---|
| : | CharsetOptions option [option] ... |
| ⺻: | CharsetOptions DebugLevel=0 NoImplicitAdd |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Experimental |
| : | mod_charset_lite |
CharsetOptions þ
mod_charset_lite Ѵ.
Option Ʒ ִ
DebugLevel=nDebugLevel Ű
mod_charset_lite ϴ
Ѵ. ⺻ ͵ ʴ´.
̴ DebugLevel=0 . ڸ Ҽ
ϰԵǾ .
ڰ ǹ̴ mod_charset_lite.c պκ
DBGLVL_ Ǹ ϶.ImplicitAdd | NoImplicitAddImplicitAdd Ű ȯ
ϸ ڵ mod_charset_lite
Ϳ ߰Ѵ. AddOutputFilter þ ͼ
Ѵٸ, NoImplicitAdd Ͽ
mod_charset_lite ڵ Ϳ
߰ʵ ؾ Ѵ.| : | |
|---|---|
| : | CharsetSourceEnc charset |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Experimental |
| : | mod_charset_lite |
CharsetSourceEnc þ þ
ġ ִ ϵ Ѵ.
charset ƱԸƮ APR ϴ ̸ ؾ Ѵ. Ϲ iconv ϴ ǹѴ.
<Directory /export/home/trawick/apacheinst/htdocs/convert>
CharsetSourceEnc UTF-16BE
CharsetDefault ISO-8859-1
</Directory>
Solaris 8 iconv Ѵ.
Apache HTTP サーバ バージョン 2.4
| 説明: | 分散オーサリングとバージョン管理 (WebDAV) 機能 |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | dav_module |
| ソースファイル: | mod_dav.c |
このモジュールはクラス 1 とクラス 2 の WebDAV ('ウェブベースの分散オーサリングとバージョン管理') 機能を Apache に提供します。 この HTTP プロトコルの拡張により、リモートのウェブサーバ上にある リソースやコレクションを 作成、移動、複製、削除できるようになります。
mod_dav を有効にするには、httpd.conf
ファイル中のコンテナに次を加えます:
Dav On
これは DAV ファイルシステムプロバイダを有効にします。DAV
ファイルシステムプロバイダは mod_dav_fs
モジュールで実装されています。ですから、このモジュールはコンパイル時に
サーバに組み込まれているか、あるいは
LoadModule
を使用して実行時にロードされている必要があります。
さらに、DAV ロックデータベースの場所が
DavLockDB ディレクティブを使って
httd.conf ファイルのグローバルセクションに指定されている
必要があります。
DavLockDB /usr/local/apache2/var/DavLock
ロックデータベースファイルのあるディレクトリは Apache が実行されている
User と Group に書き込み権限がある必要があります。
<Limit>
節を <Location>
ディレクティブ内部に追加して、DAV が有効な場所への
アクセスを制限することもできます。DAV クライアントが
一度のリクエストで送信できる最大バイト数を指定したいときは、
LimitXMLRequestBody
ディレクティブを使用する必要があります。「通常の」
LimitRequestBody
ディレクティブは DAV リクエストに対しては効力を持ちません。
DavLockDB /usr/local/apache2/var/DavLock
<Directory /usr/local/apache2/htdocs/foo>
Require all granted
Dav On
AuthType Basic
AuthName DAV
AuthUserFile user.passwd
<LimitExcept GET POST OPTIONS>
Require user admin
</LimitExcept>
</Directory>
DAV のアクセスメソッドは遠隔クライアントがサーバのファイルを
操作することを可能にしますので、 mod_dav を使用する
前に、サーバが安全であることを特に注意して確認しなければなりません。
サーバ上の DAV が使用可能になっている場所はすべて認証で保護してください。
HTTP 基本認証の使用は推奨できません。少なくとも
mod_auth_digest モジュールで提供される HTTP
ダイジェスト認証を用いるべきです。WebDAV クライアントのほとんどは
この認証方法に対応しています。代わりに、SSL が
有効なコネクションを通した基本認証を使うこともできます。
mod_dav がファイルを操作できるようにするためには、
管理下のディレクトリとファイルとに Apache が実行されている User と Group で書き込み可能である必要があります。
新しく作成されるファイルもこの User
と Group に所有される
ことになります。この理由から、そのアカウントへのアクセスを制御することは
重要です。DAV リポジトリは Apache 専用のものだとみなされています。
Apache 以外の方法でファイルを修正すること (例えば FTP やファイルシステム
用のツールなどを使って) は許可されていません。
mod_dav はいろいろな種類のサービス拒否攻撃にさらされる
かもしれません。LimitXMLRequestBody ディレクティブを使うと
大きな DAV リクエストを解析するときに消費されるメモリの量を制限することが
できます。DavDepthInfinity ディレクティブは
PROPFIND リクエストが巨大リポジトリで大量のメモリを消費するのを
防ぐことができます。他のサービス拒否攻撃には単純に使用可能なディスク領域を
多くの大きなファイルで埋めてしまうんものがあります。これを直接防ぐ方法は
Apache にはありませんので、信用できないユーザに DAV アクセスを提供するのは
避けた方が良いでしょう。
よくある要求に、mod_dav を使って動的なファイル
(PHP スクリプト、CGI スクリプトなど) を操作したいというものがあります。
これの実現は、GET リクエストはスクリプトの内容をダウンロードさせる
代わりに、スクリプトを常に実行させてしまうので難しくなっています。
これを回避する方法には、二つの違う URL を同じコンテンツにマップし、
一つはスクリプトを実行させ、もう一つはダウンロードさせたり、DAV から
操作されたりするように設定するというものがあります。
Alias /phparea /home/gstein/php_files
Alias /php-source /home/gstein/php_files
<Location /php-source>
Dav On
ForceType text/plain
</Location>
この設定により、http://example.com/phparea を PHP スクリプトの
出力をアクセスするために使うことができ、
http://example.com/php-source を DAV クライアントによる
が操作のために使うことができます。
| 説明: | WebDAV HTTP メソッドを有効にします |
|---|---|
| 構文: | Dav On|Off|provider-name |
| デフォルト: | Dav Off |
| コンテキスト: | ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_dav |
与えられたコンテナで WebDAV HTTP メソッドが使えるようにするには 次のようにします。
<Location /foo>
Dav On
</Location>
On という指定は実際には mod_dav_fs
で提供されているデフォルトのプロバイダ、filesystem
へのエイリアスになっています。一度あるロケーションで DAV
を有効にした後は、そのサブロケーションで無効化することはできない
ということに注意してください。完全な設定例は上記のセクション をご覧下さい。
| 説明: | Configure repository root path |
|---|---|
| 構文: | DavBasePath root-path |
| デフォルト: | None |
| コンテキスト: | ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_dav |
| 互換性: | Available in version 2.4.58 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | PROPFIND, Depth: Infinity リクエストを許可します |
|---|---|
| 構文: | DavDepthInfinity on|off |
| デフォルト: | DavDepthInfinity off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_dav |
'Depth: Infinity' を含んでいる
PROPFIND リクエストを処理できるようにするには、
DavDepthInfinity
ディレクティブを使います。このタイプのリクエストは
denial-of-service アタックとなりうるので、
デフォルトでは許可されていません。
| 説明: | サーバが DAV リソースのロックを維持する最小時間です。 |
|---|---|
| 構文: | DavMinTimeout seconds |
| デフォルト: | DavMinTimeout 0 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_dav |
クライアントが DAV リソースロックを要求した場合、 ロックがサーバによって自動的に解除されるまでの時間を 同時に指定することができます。この値は単なるリクエストであって、 サーバはこれを無視することもできますし、 任意の値をクライアントに通知することもできます。
クライアントに戻すロックタイムアウトの最小時間を、
秒で、指定するために DavMinTimeout
ディレクティブを使います。
マイクロソフトのウェブフォルダのデフォルトでは 120 秒ですが；
ネットワークの遅延のせいでクライアントがロックを失うのを減らすために、
DavMinTimeout を使って
これをもっと大きな値 (例えば 600 秒) に上書きできます。
<Location /MSWord>
DavMinTimeout 600
</Location>
Apache HTTP Server Version 2.4
Die Kurzreferenz der Direktiven zeigt die Verwendung, Voreinstellung, den Status und den Kontext aller Apache-Konfigurationsanweisungen. Für weitergehende Informationen schauen Sie bitte im Verzeichnis der Direktiven.
Die erste Spalte enthält den Namen und die Verwendung. Die zweite Spalte zeigt die Voreinstellung der Direktive, sofern eine Voreinstellung existiert. Wenn die Voreinstellung zu breit für die Anzeige ist, wird sie abgeschnitten und mit einem nachfolgenden "+" versehen.
Die dritte und vierte Spalte geben den Kontext an, in dem die Direktive erlaubt ist, sowie den Status der Direktive entsprechend der Legende.
| A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X |
|
|
| AcceptFilter Protokoll Filter | s | C | |
| Konfiguriert Optimierungen für lauschende Sockets bestimmter Protokolle | |||
| AcceptPathInfo On|Off|Default | Default | svdh | C |
| Ressourcen lassen angehängte Pfadangaben zu | |||
| AccessFileName Dateiname [Dateiname] ... | .htaccess | sv | C |
| Name der dezentralen Konfigurationsdateien | |||
| Action Aktionsart CGI-Skript [virtual] | svdh | B | |
| Aktiviert ein CGI-Skript für einen bestimmten Handler oder Content-Type | |||
| AddAlt string file [file] ... | svdh | B | |
| Alternate text to display for a file, instead of an icon selected by filename | |||
| AddAltByEncoding string MIME-encoding [MIME-encoding] ... | svdh | B | |
| Alternate text to display for a file instead of an icon selected by MIME-encoding | |||
| AddAltByType string MIME-type [MIME-type] ... | svdh | B | |
| Alternate text to display for a file, instead of an icon selected by MIME content-type | |||
| AddCharset charset extension [extension] ... | svdh | B | |
| Maps the given filename extensions to the specified content charset | |||
| AddDefaultCharset On|Off|Zeichenkodierung | Off | svdh | C |
Standard-Charset-Parameter, der bei Antworten vom Content-Type
text/plain oder text/html hinzugefügt wird
| |||
| AddDescription string file [file] ... | svdh | B | |
| Description to display for a file | |||
| AddEncoding encoding extension [extension] ... | svdh | B | |
| Maps the given filename extensions to the specified encoding type | |||
| AddHandler handler-name extension [extension] ... | svdh | B | |
| Maps the filename extensions to the specified handler | |||
| AddIcon icon name [name] ... | svdh | B | |
| Icon to display for a file selected by name | |||
| AddIconByEncoding icon MIME-encoding [MIME-encoding] ... | svdh | B | |
| Icon to display next to files selected by MIME content-encoding | |||
| AddIconByType icon MIME-type [MIME-type] ... | svdh | B | |
| Icon to display next to files selected by MIME content-type | |||
| AddInputFilter filter[;filter...] extension [extension] ... | svdh | B | |
| Maps filename extensions to the filters that will process client requests | |||
| AddLanguage language-tag extension [extension] ... | svdh | B | |
| Maps the given filename extension to the specified content language | |||
| AddModuleInfo module-name string | sv | E | |
| Adds additional information to the module information displayed by the server-info handler | |||
| AddOutputFilter filter[;filter...] extension [extension] ... | svdh | B | |
| Maps filename extensions to the filters that will process responses from the server | |||
| AddOutputFilterByType filter[;filter...] media-type [media-type] ... | svdh | B | |
| assigns an output filter to a particular media-type | |||
| AddType media-type extension [extension] ... | svdh | B | |
| Maps the given filename extensions onto the specified content type | |||
| Alias [URL-path] file-path|directory-path | svd | B | |
| Maps URLs to filesystem locations | |||
| AliasMatch regex file-path|directory-path | sv | B | |
| Maps URLs to filesystem locations using regular expressions | |||
| AliasPreservePath OFF|ON | OFF | svd | B |
| Map the full path after the alias in a location. | |||
| Allow from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts can access an area of the server | |||
| AllowCONNECT port[-port] [port[-port]] ... | 443 563 | sv | E |
Ports that are allowed to CONNECT through the
proxy | |||
| AllowEncodedSlashes On|Off | Off | sv | C |
| Legt fest, ob kodierte Pfadtrennzeichen in URLs durchgereicht werden dürfen | |||
| AllowMethods reset|HTTP-method [HTTP-method]... | reset | d | X |
| Restrict access to the listed HTTP methods | |||
| AllowOverride All|None|Direktiven-Typ [Direktiven-Typ] ... | None (2.3.9 und spä + | d | C |
Direktiven-Typen, die in .htaccess-Dateien
erlaubt sind. | |||
| AllowOverrideList None|directive [directive-type] ... | None | d | C |
Individual directives that are allowed in
.htaccess files | |||
| Anonymous user [user] ... | dh | E | |
| Specifies userIDs that are allowed access without password verification | |||
| Anonymous_LogEmail On|Off | On | dh | E |
| Sets whether the password entered will be logged in the error log | |||
| Anonymous_MustGiveEmail On|Off | On | dh | E |
| Specifies whether blank passwords are allowed | |||
| Anonymous_NoUserID On|Off | Off | dh | E |
| Sets whether the userID field may be empty | |||
| Anonymous_VerifyEmail On|Off | Off | dh | E |
| Sets whether to check the password field for a correctly formatted email address | |||
| AsyncRequestWorkerFactor factor | s | M | |
| Limit concurrent connections per process | |||
| AuthBasicAuthoritative On|Off | On | dh | B |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthBasicFake off|username [password] | dh | B | |
| Fake basic authentication using the given expressions for username and password | |||
| AuthBasicProvider provider-name [provider-name] ... | file | dh | B |
| Sets the authentication provider(s) for this location | |||
| AuthBasicUseDigestAlgorithm MD5|Off | Off | dh | B |
| Check passwords against the authentication providers as if Digest Authentication was in force instead of Basic Authentication. | |||
| AuthDBDUserPWQuery query | d | E | |
| SQL query to look up a password for a user | |||
| AuthDBDUserRealmQuery query | d | E | |
| SQL query to look up a password hash for a user and realm. | |||
| AuthDBMGroupFile file-path | dh | E | |
| Sets the name of the database file containing the list of user groups for authorization | |||
| AuthDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Sets the type of database file that is used to store passwords | |||
| AuthDBMUserFile file-path | dh | E | |
| Sets the name of a database file containing the list of users and passwords for authentication | |||
| AuthDigestAlgorithm MD5|MD5-sess | MD5 | dh | E |
| Selects the algorithm used to calculate the challenge and response hashes in digest authentication | |||
| AuthDigestDomain URI [URI] ... | dh | E | |
| URIs that are in the same protection space for digest authentication | |||
| AuthDigestNonceLifetime seconds | 300 | dh | E |
| How long the server nonce is valid | |||
| AuthDigestProvider provider-name [provider-name] ... | file | dh | E |
| Sets the authentication provider(s) for this location | |||
| AuthDigestQop none|auth|auth-int [auth|auth-int] | auth | dh | E |
| Determines the quality-of-protection to use in digest authentication | |||
| AuthDigestShmemSize size | 1000 | s | E |
| The amount of shared memory to allocate for keeping track of clients | |||
| AuthFormAuthoritative On|Off | On | dh | B |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthFormBody fieldname | httpd_body | d | B |
| The name of a form field carrying the body of the request to attempt on successful login | |||
| AuthFormDisableNoStore On|Off | Off | d | B |
| Disable the CacheControl no-store header on the login page | |||
| AuthFormFakeBasicAuth On|Off | Off | d | B |
| Fake a Basic Authentication header | |||
| AuthFormLocation fieldname | httpd_location | d | B |
| The name of a form field carrying a URL to redirect to on successful login | |||
| AuthFormLoginRequiredLocation url | d | B | |
| The URL of the page to be redirected to should login be required | |||
| AuthFormLoginSuccessLocation url | d | B | |
| The URL of the page to be redirected to should login be successful | |||
| AuthFormLogoutLocation uri | d | B | |
| The URL to redirect to after a user has logged out | |||
| AuthFormMethod fieldname | httpd_method | d | B |
| The name of a form field carrying the method of the request to attempt on successful login | |||
| AuthFormMimetype fieldname | httpd_mimetype | d | B |
| The name of a form field carrying the mimetype of the body of the request to attempt on successful login | |||
| AuthFormPassword fieldname | httpd_password | d | B |
| The name of a form field carrying the login password | |||
| AuthFormProvider provider-name [provider-name] ... | file | dh | B |
| Sets the authentication provider(s) for this location | |||
| AuthFormSitePassphrase secret | d | B | |
| Bypass authentication checks for high traffic sites | |||
| AuthFormSize size | 8192 | d | B |
| The largest size of the form in bytes that will be parsed for the login details | |||
| AuthFormUsername fieldname | httpd_username | d | B |
| The name of a form field carrying the login username | |||
| AuthGroupFile file-path | dh | B | |
| Sets the name of a text file containing the list of user groups for authorization | |||
| AuthLDAPAuthorizePrefix prefix | AUTHORIZE_ | dh | E |
| Specifies the prefix for environment variables set during authorization | |||
| AuthLDAPBindAuthoritative off|on | on | dh | E |
| Determines if other authentication providers are used when a user can be mapped to a DN but the server cannot successfully bind with the user's credentials. | |||
| AuthLDAPBindDN distinguished-name | dh | E | |
| Optional DN to use in binding to the LDAP server | |||
| AuthLDAPBindPassword password | dh | E | |
| Password used in conjunction with the bind DN | |||
| AuthLDAPCharsetConfig file-path | s | E | |
| Language to charset conversion configuration file | |||
| AuthLDAPCompareAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization comparisons | |||
| AuthLDAPCompareDNOnServer on|off | on | dh | E |
| Use the LDAP server to compare the DNs | |||
| AuthLDAPDereferenceAliases never|searching|finding|always | always | dh | E |
| When will the module de-reference aliases | |||
| AuthLDAPGroupAttribute attribute | member uniqueMember + | dh | E |
| LDAP attributes used to identify the user members of groups. | |||
| AuthLDAPGroupAttributeIsDN on|off | on | dh | E |
| Use the DN of the client username when checking for group membership | |||
| AuthLDAPInitialBindAsUser off|on | off | dh | E |
| Determines if the server does the initial DN lookup using the basic authentication users' own username, instead of anonymously or with hard-coded credentials for the server | |||
| AuthLDAPInitialBindPattern regex substitution | (.*) $1 (remote use + | dh | E |
| Specifies the transformation of the basic authentication username to be used when binding to the LDAP server to perform a DN lookup | |||
| AuthLDAPMaxSubGroupDepth Number | 10 | dh | E |
| Specifies the maximum sub-group nesting depth that will be evaluated before the user search is discontinued. | |||
| AuthLDAPRemoteUserAttribute uid | dh | E | |
| Use the value of the attribute returned during the user query to set the REMOTE_USER environment variable | |||
| AuthLDAPRemoteUserIsDN on|off | off | dh | E |
| Use the DN of the client username to set the REMOTE_USER environment variable | |||
| AuthLDAPSearchAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization searches | |||
| AuthLDAPSubGroupAttribute attribute | member uniqueMember + | dh | E |
| Specifies the attribute labels, one value per directive line, used to distinguish the members of the current group that are groups. | |||
| AuthLDAPSubGroupClass LdapObjectClass | groupOfNames groupO + | dh | E |
| Specifies which LDAP objectClass values identify directory objects that are groups during sub-group processing. | |||
| AuthLDAPURL url [NONE|SSL|TLS|STARTTLS] | dh | E | |
| URL specifying the LDAP search parameters | |||
| AuthMerging Off | And | Or | Off | dh | B |
| Controls the manner in which each configuration section's authorization logic is combined with that of preceding configuration sections. | |||
| AuthName auth-domain | dh | B | |
| Authorization realm for use in HTTP authentication | |||
| AuthnCacheContext directory|server|custom-string | directory | d | B |
| Specify a context string for use in the cache key | |||
| AuthnCacheEnable | s | B | |
| Enable Authn caching configured anywhere | |||
| AuthnCacheProvideFor authn-provider [...] | dh | B | |
| Specify which authn provider(s) to cache for | |||
| AuthnCacheSOCache provider-name[:provider-args] | s | B | |
| Select socache backend provider to use | |||
| AuthnCacheTimeout timeout (seconds) | 300 (5 minutes) | dh | B |
| Set a timeout for cache entries | |||
| <AuthnProviderAlias baseProvider Alias> ... </AuthnProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authentication provider and referenced by the specified alias | |||
AuthnzFcgiCheckAuthnProvider provider-name|None
option ... | d | E | |
| Enables a FastCGI application to handle the check_authn authentication hook. | |||
| AuthnzFcgiDefineProvider type provider-name backend-address | s | E | |
| Defines a FastCGI application as a provider for authentication and/or authorization | |||
| AuthType None|Basic|Digest|Form | dh | B | |
| Type of user authentication | |||
| AuthUserFile file-path | dh | B | |
| Sets the name of a text file containing the list of users and passwords for authentication | |||
| AuthzDBDLoginToReferer On|Off | Off | d | E |
Determines whether to redirect the Client to the Referring
page on successful login or logout if a Referer request
header is present | |||
| AuthzDBDQuery query | d | E | |
| Specify the SQL Query for the required operation | |||
| AuthzDBDRedirectQuery query | d | E | |
| Specify a query to look up a login page for the user | |||
| AuthzDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Sets the type of database file that is used to store list of user groups | |||
| <AuthzProviderAlias baseProvider Alias Require-Parameters> ... </AuthzProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authorization provider and referenced by the specified alias | |||
| AuthzSendForbiddenOnFailure On|Off | Off | dh | B |
| Send '403 FORBIDDEN' instead of '401 UNAUTHORIZED' if authentication succeeds but authorization fails | |||
| BalancerGrowth # | 5 | sv | E |
| Number of additional Balancers that can be added Post-configuration | |||
| BalancerInherit On|Off | On | sv | E |
| Inherit ProxyPassed Balancers/Workers from the main server | |||
| BalancerMember [balancerurl] url [key=value [key=value ...]] | d | E | |
| Add a member to a load balancing group | |||
| BalancerPersist On|Off | Off | sv | E |
| Attempt to persist changes made by the Balancer Manager across restarts. | |||
| BrotliAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| BrotliCompressionMaxInputBlock value | sv | E | |
| Maximum input block size | |||
| BrotliCompressionQuality value | 5 | sv | E |
| Compression quality | |||
| BrotliCompressionWindow value | 18 | sv | E |
| Brotli sliding compression window size | |||
| BrotliFilterNote [type] notename | sv | E | |
| Places the compression ratio in a note for logging | |||
| BrowserMatch regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables conditional on HTTP User-Agent | |||
| BrowserMatchNoCase regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables conditional on User-Agent without respect to case | |||
| BufferedLogs On|Off | Off | s | B |
| Buffer log entries in memory before writing to disk | |||
| BufferSize integer | 131072 | svdh | E |
| Maximum size in bytes to buffer by the buffer filter | |||
| CacheDefaultExpire seconds | 3600 (one hour) | svdh | E |
| The default duration to cache a document when no expiry date is specified. | |||
| CacheDetailHeader on|off | off | svdh | E |
| Add an X-Cache-Detail header to the response. | |||
| CacheDirLength length | 2 | sv | E |
| The number of characters in subdirectory names | |||
| CacheDirLevels levels | 2 | sv | E |
| The number of levels of subdirectories in the cache. | |||
| CacheDisable url-string | on | svdh | E | |
| Disable caching of specified URLs | |||
| CacheEnable cache_type [url-string] | svd | E | |
| Enable caching of specified URLs using a specified storage manager | |||
| CacheFile file-path [file-path] ... | s | X | |
| Cache a list of file handles at startup time | |||
| CacheHeader on|off | off | svdh | E |
| Add an X-Cache header to the response. | |||
| CacheIgnoreCacheControl On|Off | Off | sv | E |
| Ignore request to not serve cached content to client | |||
| CacheIgnoreHeaders header-string [header-string] ... | None | sv | E |
| Do not store the given HTTP header(s) in the cache. | |||
| CacheIgnoreNoLastMod On|Off | Off | svdh | E |
| Ignore the fact that a response has no Last Modified header. | |||
| CacheIgnoreQueryString On|Off | Off | sv | E |
| Ignore query string when caching | |||
| CacheIgnoreURLSessionIdentifiers identifier [identifier] ... | None | sv | E |
| Ignore defined session identifiers encoded in the URL when caching | |||
| CacheKeyBaseURL URL | sv | E | |
| Override the base URL of reverse proxied cache keys. | |||
| CacheLastModifiedFactor float | 0.1 | svdh | E |
| The factor used to compute an expiry date based on the LastModified date. | |||
| CacheLock on|off | off | sv | E |
| Enable the thundering herd lock. | |||
| CacheLockMaxAge integer | 5 | sv | E |
| Set the maximum possible age of a cache lock. | |||
| CacheLockPath directory | /tmp/mod_cache-lock + | sv | E |
| Set the lock path directory. | |||
| CacheMaxExpire seconds | 86400 (one day) | svdh | E |
| The maximum time in seconds to cache a document | |||
| CacheMaxFileSize bytes | 1000000 | svdh | E |
| The maximum size (in bytes) of a document to be placed in the cache | |||
| CacheMinExpire seconds | 0 | svdh | E |
| The minimum time in seconds to cache a document | |||
| CacheMinFileSize bytes | 1 | svdh | E |
| The minimum size (in bytes) of a document to be placed in the cache | |||
| CacheNegotiatedDocs On|Off | Off | sv | B |
| Allows content-negotiated documents to be cached by proxy servers | |||
| CacheQuickHandler on|off | on | sv | E |
| Run the cache from the quick handler. | |||
| CacheReadSize bytes | 0 | svdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheReadTime milliseconds | 0 | svdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheRoot directory | sv | E | |
| The directory root under which cache files are stored | |||
| CacheSocache type[:args] | sv | E | |
| The shared object cache implementation to use | |||
| CacheSocacheMaxSize bytes | 102400 | svdh | E |
| The maximum size (in bytes) of an entry to be placed in the cache | |||
| CacheSocacheMaxTime seconds | 86400 | svdh | E |
| The maximum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheMinTime seconds | 600 | svdh | E |
| The minimum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheReadSize bytes | 0 | svdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheSocacheReadTime milliseconds | 0 | svdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheStaleOnError on|off | on | svdh | E |
| Serve stale content in place of 5xx responses. | |||
| CacheStoreExpired On|Off | Off | svdh | E |
| Attempt to cache responses that the server reports as expired | |||
| CacheStoreNoStore On|Off | Off | svdh | E |
| Attempt to cache requests or responses that have been marked as no-store. | |||
| CacheStorePrivate On|Off | Off | svdh | E |
| Attempt to cache responses that the server has marked as private | |||
| CGIDScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIMapExtension CGI-Pfad .Endung | dh | C | |
| Technik zur Bestimmung des Interpreters für CGI-Skripte | |||
| CGIPassAuth On|Off | Off | dh | C |
| Enables passing HTTP authorization headers to scripts as CGI variables | |||
| CGIScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIVar variable rule | dh | C | |
| Controls how some CGI variables are set | |||
| CharsetDefault charset | svdh | E | |
| Charset to translate into | |||
| CharsetOptions option [option] ... | ImplicitAdd | svdh | E |
| Configures charset translation behavior | |||
| CharsetSourceEnc charset | svdh | E | |
| Source charset of files | |||
| CheckBasenameMatch on|off | On | svdh | E |
| Also match files with differing file name extensions. | |||
| CheckCaseOnly on|off | Off | svdh | E |
| Limits the action of the speling module to case corrections | |||
| CheckSpelling on|off | Off | svdh | E |
| Enables the spelling module | |||
| ChrootDir /path/to/directory | s | B | |
| Directory for apache to run chroot(8) after startup. | |||
| ContentDigest On|Off | Off | svdh | C |
Aktiviert die Generierung von Content-MD5
HTTP-Response-Headern | |||
| CookieDomain domain | svdh | E | |
| The domain to which the tracking cookie applies | |||
| CookieExpires expiry-period | svdh | E | |
| Expiry time for the tracking cookie | |||
| CookieHTTPOnly on|off | off | svdh | E |
| Adds the 'HTTPOnly' attribute to the cookie | |||
| CookieName token | Apache | svdh | E |
| Name of the tracking cookie | |||
| CookieSameSite None|Lax|Strict | svdh | E | |
| Adds the 'SameSite' attribute to the cookie | |||
| CookieSecure on|off | off | svdh | E |
| Adds the 'Secure' attribute to the cookie | |||
| CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965 | Netscape | svdh | E |
| Format of the cookie header field | |||
| CookieTracking on|off | off | svdh | E |
| Enables tracking cookie | |||
| CoreDumpDirectory Verzeichnis | s | M | |
| Verzeichnis, in das der Apache zu wechseln versucht, bevor er einen Hauptspeicherauszug erstellt | |||
| CustomLog file|pipe format|nickname [env=[!]environment-variable| expr=expression] | sv | B | |
| Sets filename and format of log file | |||
| Dav On|Off|provider-name | Off | d | E |
| Enable WebDAV HTTP methods | |||
| DavBasePath root-path | d | E | |
| Configure repository root path | |||
| DavDepthInfinity on|off | off | svd | E |
| Allow PROPFIND, Depth: Infinity requests | |||
| DavGenericLockDB file-path | svd | E | |
| Location of the DAV lock database | |||
| DavLockDB file-path | sv | E | |
| Location of the DAV lock database | |||
| DavLockDiscovery on|off | on | svdh | E |
| Enable lock discovery | |||
| DavMinTimeout seconds | 0 | svd | E |
| Minimum amount of time the server holds a lock on a DAV resource | |||
| DBDExptime time-in-seconds | 300 | sv | E |
| Keepalive time for idle connections | |||
| DBDInitSQL "SQL statement" | sv | E | |
| Execute an SQL statement after connecting to a database | |||
| DBDKeep number | 2 | sv | E |
| Maximum sustained number of connections | |||
| DBDMax number | 10 | sv | E |
| Maximum number of connections | |||
| DBDMin number | 1 | sv | E |
| Minimum number of connections | |||
| DBDParams param1=value1[,param2=value2] | sv | E | |
| Parameters for database connection | |||
| DBDPersist On|Off | sv | E | |
| Whether to use persistent connections | |||
| DBDPrepareSQL "SQL statement" label | sv | E | |
| Define an SQL prepared statement | |||
| DBDriver name | sv | E | |
| Specify an SQL driver | |||
| DefaultIcon url-path | svdh | B | |
| Icon to display for files when no specific icon is configured | |||
| DefaultLanguage language-tag | svdh | B | |
| Defines a default language-tag to be sent in the Content-Language header field for all resources in the current context that have not been assigned a language-tag by some other means. | |||
| DefaultRuntimeDir directory-path | DEFAULT_REL_RUNTIME + | s | C |
| Base directory for the server run-time files | |||
| DefaultType MIME-Type | text/plain | svdh | C |
| MIME-Content-Type, der gesendet wird, wenn der Server den Typ nicht auf andere Weise ermitteln kann. | |||
| Define Parametername | s | C | |
| Define the existence of a variable | |||
| DeflateAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| DeflateBufferSize value | 8096 | sv | E |
| Fragment size to be compressed at one time by zlib | |||
| DeflateCompressionLevel value | sv | E | |
| How much compression do we apply to the output | |||
| DeflateFilterNote [type] notename | sv | E | |
| Places the compression ratio in a note for logging | |||
| DeflateInflateLimitRequestBody value | svdh | E | |
| Maximum size of inflated request bodies | |||
| DeflateInflateRatioBurst value | 3 | svdh | E |
| Maximum number of times the inflation ratio for request bodies can be crossed | |||
| DeflateInflateRatioLimit value | 200 | svdh | E |
| Maximum inflation ratio for request bodies | |||
| DeflateMemLevel value | 9 | sv | E |
| How much memory should be used by zlib for compression | |||
| DeflateWindowSize value | 15 | sv | E |
| Zlib compression window size | |||
| Deny from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts are denied access to the server | |||
| <Directory Verzeichnispfad> ... </Directory> | sv | C | |
| Umschließt eine Gruppe von Direktiven, die nur auf das genannte Verzeichnis des Dateisystems und Unterverzeichnisse angewendet werden | |||
| DirectoryCheckHandler On|Off | Off | svdh | B |
| Toggle how this module responds when another handler is configured | |||
| DirectoryIndex disabled | local-url [local-url] ... | index.html | svdh | B |
| List of resources to look for when the client requests a directory | |||
| DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-code | off | svdh | B |
| Configures an external redirect for directory indexes. | |||
| <DirectoryMatch regex> ... </DirectoryMatch> | sv | C | |
| Umschließt eine Gruppe von Direktiven, die auf Verzeichnisse des Dateisystems und ihre Unterverzeichnisse abgebildet werden, welche auf einen regulären Ausdruck passen | |||
| DirectorySlash On|Off | On | svdh | B |
| Toggle trailing slash redirects on or off | |||
| DocumentRoot Verzeichnis | /usr/local/apache/h + | sv | C |
| Verzeichnis, welches den Haupt-Dokumentenbaum bildet, der im Web sichtbar ist. | |||
| DTracePrivileges On|Off | Off | s | X |
| Determines whether the privileges required by dtrace are enabled. | |||
| DumpIOInput On|Off | Off | s | E |
| Dump all input data to the error log | |||
| DumpIOOutput On|Off | Off | s | E |
| Dump all output data to the error log | |||
| <Else> ... </Else> | svdh | C | |
Contains directives that apply only if the condition of a
previous <If> or
<ElseIf> section is not
satisfied by a request at runtime | |||
| <ElseIf expression> ... </ElseIf> | svdh | C | |
Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
<If> or
<ElseIf> section is not
satisfied | |||
| EnableExceptionHook On|Off | Off | s | M |
| Aktiviert einen Hook, der nach einem Absturz noch Ausnahmefehler behandeln lassen kann | |||
| EnableMMAP On|Off | On | svdh | C |
| Verwende Memory-Mapping, um Dateien während der Auslieferung zu lesen | |||
| EnableSendfile On|Off | On | svdh | C |
| Verwende die sendfile-Unterstützung des Kernels, um Dateien an den Client auszuliefern | |||
| Error message | svdh | C | |
| Abort configuration parsing with a custom error message | |||
| ErrorDocument Fehlercode Dokument | svdh | C | |
| Das, was der Server im Fehlerfall an den Client zurückgibt | |||
| ErrorLog Dateiname|syslog[:facility] | logs/error_log (Uni + | sv | C |
| Ablageort, an dem der Server Fehler protokolliert | |||
| ErrorLogFormat [connection|request] format | sv | C | |
| Format specification for error log entries | |||
| Example | svdh | X | |
| Demonstration directive to illustrate the Apache module API | |||
| ExpiresActive On|Off | Off | svdh | E |
Enables generation of Expires
headers | |||
| ExpiresByType MIME-type <code>seconds | svdh | E | |
Value of the Expires header configured
by MIME type | |||
| ExpiresDefault <code>seconds | svdh | E | |
| Default algorithm for calculating expiration time | |||
| ExtendedStatus On|Off | Off[*] | s | C |
| Keep track of extended status information for each request | |||
| ExtFilterDefine filtername parameters | s | E | |
| Define an external filter | |||
| ExtFilterOptions option [option] ... | NoLogStderr | d | E |
Configure mod_ext_filter options | |||
| FallbackResource disabled | local-url | svdh | B | |
| Define a default URL for requests that don't map to a file | |||
| FileETag Komponente ... | INode MTime Size | svdh | C |
| Dateiattribute, die zur Erstellung des HTTP-Response-Headers ETag verwendet werden | |||
| <Files Dateiname> ... </Files> | svdh | C | |
| Enthält Direktiven, die sich nur auf passende Dateinamen beziehen | |||
| <FilesMatch regex> ... </FilesMatch> | svdh | C | |
| Enthält Direktiven, die für Dateinamen gelten, die auf einen regulären Ausdruck passen | |||
| FilterChain [+=-@!]filter-name ... | svdh | B | |
| Configure the filter chain | |||
| FilterDeclare filter-name [type] | svdh | B | |
| Declare a smart filter | |||
| FilterProtocol filter-name [provider-name] proto-flags | svdh | B | |
| Deal with correct HTTP protocol handling | |||
| FilterProvider filter-name provider-name expression | svdh | B | |
| Register a content filter | |||
| FilterTrace filter-name level | svd | B | |
Get debug/diagnostic information from
mod_filter | |||
| FlushMaxPipelined number | 5 | sv | C |
| Maximum number of pipelined responses above which they are flushed to the network | |||
| FlushMaxThreshold number-of-bytes | 65535 | sv | C |
| Threshold above which pending data are flushed to the network | |||
| ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] | Prefer | svdh | B |
| Action to take if a single acceptable document is not found | |||
| ForceType MIME-Type|None | dh | C | |
| Erzwingt die Auslieferung aller passendenden Dateien mit dem angegebenen MIME-Content-Type | |||
| ForensicLog filename|pipe | sv | E | |
| Sets filename of the forensic log | |||
| GlobalLogfile|pipe format|nickname [env=[!]environment-variable| expr=expression] | s | B | |
| Sets filename and format of log file | |||
| GprofDir /tmp/gprof/|/tmp/gprof/% | sv | C | |
| Directory to write gmon.out profiling data to. | |||
| GracefulShutdownTimeout seconds | 0 | s | M |
| Specify a timeout after which a gracefully shutdown server will exit. | |||
| Group unix-group | #-1 | s | B |
| Group under which the server will answer requests | |||
| H2CopyFiles on|off | off | svdh | E |
| Determine file handling in responses | |||
| H2Direct on|off | on for h2c, off for + | sv | E |
| H2 Direct Protocol Switch | |||
| H2EarlyHint name value | svdh | E | |
| Add a response header to be picked up in 103 Early Hints | |||
| H2EarlyHints on|off | off | sv | E |
| Determine sending of 103 status codes | |||
| H2MaxDataFrameLen n | 0 | sv | E |
| Maximum bytes inside a single HTTP/2 DATA frame | |||
| H2MaxHeaderBlockLen n | 0 | sv | E |
| Maximum size of response headers | |||
| H2MaxSessionStreams n | 100 | sv | E |
| Maximum number of active streams per HTTP/2 session. | |||
| H2MaxWorkerIdleSeconds n | 600 | s | E |
| Maximum number of seconds h2 workers remain idle until shut down. | |||
| H2MaxWorkers n | s | E | |
| Maximum number of worker threads to use per child process. | |||
| H2MinWorkers n | s | E | |
| Minimal number of worker threads to use per child process. | |||
| H2ModernTLSOnly on|off | on | sv | E |
| Require HTTP/2 connections to be "modern TLS" only | |||
| H2OutputBuffering on|off | on | sv | E |
| Determine buffering behaviour of output | |||
| H2Padding numbits | 0 | sv | E |
| Determine the range of padding bytes added to payload frames | |||
| H2ProxyRequests on|off | off | sv | E |
| En-/Disable forward proxy requests via HTTP/2 | |||
| H2Push on|off | on | svdh | E |
| H2 Server Push Switch | |||
| H2PushDiarySize n | 256 | sv | E |
| H2 Server Push Diary Size | |||
| H2PushPriority mime-type [after|before|interleaved] [weight] | * After 16 | sv | E |
| H2 Server Push Priority | |||
| H2PushResource [add] path [critical] | svdh | E | |
| Declares resources for early pushing to the client | |||
| H2SerializeHeaders on|off | off | sv | E |
| Serialize Request/Response Processing Switch | |||
| H2StreamMaxMemSize bytes | 65536 | sv | E |
| Maximum amount of output data buffered per stream. | |||
| H2StreamTimeout time-interval[s] | svd | E | |
| Maximum time waiting when sending/receiving data to stream processing | |||
| H2TLSCoolDownSecs seconds | 1 | sv | E |
| Configure the number of seconds of idle time on TLS before shrinking writes | |||
| H2TLSWarmUpSize amount | 1048576 | sv | E |
| Configure the number of bytes on TLS connection before doing max writes | |||
| H2Upgrade on|off | on for h2c, off for + | svdh | E |
| H2 Upgrade Protocol Switch | |||
| H2WebSockets on|off | off | sv | E |
| En-/Disable WebSockets via HTTP/2 | |||
| H2WindowSize bytes | 65535 | sv | E |
| Size of Stream Window for upstream data. | |||
| Header [condition] add|append|echo|edit|edit*|merge|set|setifempty|unset|note header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] | svdh | E | |
| Configure HTTP response headers | |||
| HeaderName filename | svdh | B | |
| Name of the file that will be inserted at the top of the index listing | |||
| HeartbeatAddress addr:port | s | X | |
| Multicast address for heartbeat packets | |||
| HeartbeatListen addr:port | s | X | |
| multicast address to listen for incoming heartbeat requests | |||
| HeartbeatMaxServers number-of-servers | 10 | s | X |
| Specifies the maximum number of servers that will be sending heartbeat requests to this server | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to store heartbeat data when using flat-file storage | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to read heartbeat data | |||
| HostnameLookups On|Off|Double | Off | svd | C |
| Aktiviert DNS-Lookups auf Client-IP-Adressen | |||
| HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods] [Allow0.9|Require1.0] | Strict LenientMetho + | sv | C |
| Modify restrictions on HTTP Request Messages | |||
| IdentityCheck On|Off | Off | svd | E |
| Enables logging of the RFC 1413 identity of the remote user | |||
| IdentityCheckTimeout seconds | 30 | svd | E |
| Determines the timeout duration for ident requests | |||
| <If expression> ... </If> | svdh | C | |
| Contains directives that apply only if a condition is satisfied by a request at runtime | |||
| <IfDefine [!]Parametername> ... </IfDefine> | svdh | C | |
| Schließt Direktiven ein, die nur ausgeführt werden, wenn eine Testbedingung beim Start wahr ist | |||
| <IfDirective [!]directive-name> ... </IfDirective> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific directive | |||
| <IfFile [!]filename> ... </IfFile> | svdh | C | |
| Encloses directives that will be processed only if file exists at startup | |||
| <IfModule [!]Modulname|Modulbezeichner> ... </IfModule> | svdh | C | |
| Schließt Direktiven ein, die abhängig vom Vorhandensein oder Fehlen eines speziellen Moduls ausgeführt werden | |||
| <IfSection [!]section-name> ... </IfSection> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific section directive | |||
| <IfVersion [[!]operator] version> ... </IfVersion> | svdh | E | |
| contains version dependent configuration | |||
| ImapBase map|referer|URL | http://servername/ | svdh | B |
Default base for imagemap files | |||
| ImapDefault error|nocontent|map|referer|URL | nocontent | svdh | B |
| Default action when an imagemap is called with coordinates that are not explicitly mapped | |||
| ImapMenu none|formatted|semiformatted|unformatted | formatted | svdh | B |
| Action if no coordinates are given when calling an imagemap | |||
| Include Dateiname|Verzeichnis | svd | C | |
| Fügt andere Konfigurationsdateien innerhalb der Server-Konfigurationsdatei ein | |||
| IncludeOptional file-path|directory-path|wildcard | svd | C | |
| Includes other configuration files from within the server configuration files | |||
| IndexHeadInsert "markup ..." | svdh | B | |
| Inserts text in the HEAD section of an index page. | |||
| IndexIgnore file [file] ... | "." | svdh | B |
| Adds to the list of files to hide when listing a directory | |||
| IndexIgnoreReset ON|OFF | svdh | B | |
| Empties the list of files to hide when listing a directory | |||
| IndexOptions [+|-]option [[+|-]option] ... | svdh | B | |
| Various configuration settings for directory indexing | |||
| IndexOrderDefault Ascending|Descending Name|Date|Size|Description | Ascending Name | svdh | B |
| Sets the default ordering of the directory index | |||
| IndexStyleSheet url-path | svdh | B | |
| Adds a CSS stylesheet to the directory index | |||
| InputSed sed-command | dh | X | |
Sed command to filter request data (typically POST data) | |||
| ISAPIAppendLogToErrors on|off | off | svdh | B |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the error log | |||
| ISAPIAppendLogToQuery on|off | on | svdh | B |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the query field | |||
| ISAPICacheFile file-path [file-path] ... | sv | B | |
| ISAPI .dll files to be loaded at startup | |||
| ISAPIFakeAsync on|off | off | svdh | B |
| Fake asynchronous support for ISAPI callbacks | |||
| ISAPILogNotSupported on|off | off | svdh | B |
| Log unsupported feature requests from ISAPI extensions | |||
| ISAPIReadAheadBuffer size | 49152 | svdh | B |
| Size of the Read Ahead Buffer sent to ISAPI extensions | |||
| KeepAlive On|Off | On | sv | C |
| Aktiviert persistente HTTP-Verbindungen | |||
| KeepAliveTimeout Sekunden | 5 | sv | C |
| Zeitspanne, die der Server während persistenter Verbindungen auf nachfolgende Anfragen wartet | |||
| KeptBodySize maximum size in bytes | 0 | d | B |
| Keep the request body instead of discarding it up to the specified maximum size, for potential use by filters such as mod_include. | |||
| LanguagePriority MIME-lang [MIME-lang] ... | svdh | B | |
| The precedence of language variants for cases where the client does not express a preference | |||
| LDAPCacheEntries number | 1024 | s | E |
| Maximum number of entries in the primary LDAP cache | |||
| LDAPCacheTTL seconds | 600 | s | E |
| Time that cached items remain valid | |||
| LDAPConnectionPoolTTL n | -1 | sv | E |
| Discard backend connections that have been sitting in the connection pool too long | |||
| LDAPConnectionTimeout seconds | s | E | |
| Specifies the socket connection timeout in seconds | |||
| LDAPLibraryDebug 7 | s | E | |
| Enable debugging in the LDAP SDK | |||
| LDAPOpCacheEntries number | 1024 | s | E |
| Number of entries used to cache LDAP compare operations | |||
| LDAPOpCacheTTL seconds | 600 | s | E |
| Time that entries in the operation cache remain valid | |||
| LDAPReferralHopLimit number | dh | E | |
| The maximum number of referral hops to chase before terminating an LDAP query. | |||
| LDAPReferrals On|Off|default | On | dh | E |
| Enable referral chasing during queries to the LDAP server. | |||
| LDAPRetries number-of-retries | 3 | s | E |
| Configures the number of LDAP server retries. | |||
| LDAPRetryDelay seconds | 0 | s | E |
| Configures the delay between LDAP server retries. | |||
| LDAPSharedCacheFile directory-path/filename | s | E | |
| Sets the shared memory cache file | |||
| LDAPSharedCacheSize bytes | 500000 | s | E |
| Size in bytes of the shared-memory cache | |||
| LDAPTimeout seconds | 60 | s | E |
| Specifies the timeout for LDAP search and bind operations, in seconds | |||
| LDAPTrustedClientCert type directory-path/filename/nickname [password] | dh | E | |
| Sets the file containing or nickname referring to a per connection client certificate. Not all LDAP toolkits support per connection client certificates. | |||
| LDAPTrustedGlobalCert type directory-path/filename [password] | s | E | |
| Sets the file or database containing global trusted Certificate Authority or global client certificates | |||
| LDAPTrustedMode type | sv | E | |
| Specifies the SSL/TLS mode to be used when connecting to an LDAP server. | |||
| LDAPVerifyServerCert On|Off | On | s | E |
| Force server certificate verification | |||
| <Limit Methode [Methode] ... > ... </Limit> | svdh | C | |
| Beschränkt die eingeschlossenen Zugriffskontrollen auf bestimmte HTTP-Methoden | |||
| <LimitExcept Methode [Methode] ... > ... </LimitExcept> | svdh | C | |
| Beschränkt Zugriffskontrollen auf alle HTTP-Methoden außer den genannten | |||
| LimitInternalRecursion Zahl [Zahl] | 10 | sv | C |
| Bestimmt die maximale Anzahl interner Umleitungen und verschachtelter Unteranfragen | |||
| LimitRequestBody Bytes | 0 | svdh | C |
| Begrenzt die Gesamtgröße des vom Client gesendeten HTTP-Request-Body | |||
| LimitRequestFields Anzahl | 100 | s | C |
| Begrenzt die Anzahl der HTTP-Request-Header, die vom Client entgegengenommen werden | |||
| LimitRequestFieldsize Bytes | s | C | |
| Begrenzt die Länge des vom Client gesendeten HTTP-Request-Headers | |||
| LimitRequestLine Bytes | 8190 | s | C |
| Begrenzt die Länge der vom Client entgegengenommenen HTTP-Anfragezeile | |||
| LimitXMLRequestBody Bytes | 1000000 | svdh | C |
| Begrenzt die Größe eines XML-basierten Request-Bodys | |||
| Listen [IP-Addresse:]Port | s | M | |
| IP-Adressen und Ports, an denen der Server lauscht | |||
| ListenBacklog backlog | s | M | |
| Maximale Länge der Warteschlange schwebender Verbindungen | |||
| ListenCoresBucketsRatio ratio | 0 (disabled) | s | M |
| Ratio between the number of CPU cores (online) and the number of listeners' buckets | |||
| LoadFile filename [filename] ... | sv | E | |
| Link in the named object file or library | |||
| LoadModule module filename | sv | E | |
| Links in the object file or library, and adds to the list of active modules | |||
| <Location URL-Pfad|URL> ... </Location> | sv | C | |
| Wendet die enthaltenen Direktiven nur auf die entsprechenden URLs an | |||
| <LocationMatch regex> ... </LocationMatch> | sv | C | |
| Wendet die enthaltenen Direktiven nur auf URLs an, die auf reguläre Ausdrücke passen | |||
| LogFormat format|nickname [nickname] | "%h %l %u %t \"%r\" + | sv | B |
| Describes a format for use in a log file | |||
| LogIOTrackTTFB ON|OFF | OFF | svdh | E |
| Enable tracking of time to first byte (TTFB) | |||
| LogLevel Level | warn | sv | C |
| Steuert die Ausführlichkeit des Fehlerprotokolls | |||
| LogMessage message [hook=hook] [expr=expression] | d | X | |
| Log user-defined message to error log | |||
| LuaAuthzProvider provider_name /path/to/lua/script.lua function_name | s | E | |
Plug an authorization provider function into mod_authz_core
| |||
| LuaCodeCache stat|forever|never | stat | svdh | E |
| Configure the compiled code cache. | |||
| LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the access_checker phase of request processing | |||
| LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the auth_checker phase of request processing | |||
| LuaHookCheckUserID /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the check_user_id phase of request processing | |||
| LuaHookFixups /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the fixups phase of a request processing | |||
| LuaHookInsertFilter /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the insert_filter phase of request processing | |||
| LuaHookLog /path/to/lua/script.lua log_function_name | svdh | E | |
| Provide a hook for the access log phase of a request processing | |||
| LuaHookMapToStorage /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the map_to_storage phase of request processing | |||
| LuaHookPreTranslate /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the pre_translate phase of a request processing | |||
| LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late] | sv | E | |
| Provide a hook for the translate name phase of request processing | |||
| LuaHookTypeChecker /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the type_checker phase of request processing | |||
| LuaInherit none|parent-first|parent-last | parent-first | svdh | E |
| Controls how parent configuration sections are merged into children | |||
| LuaInputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content input filtering | |||
| LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name] | svdh | E | |
| Map a path to a lua handler | |||
| LuaOutputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content output filtering | |||
| LuaPackageCPath /path/to/include/?.soa | svdh | E | |
| Add a directory to lua's package.cpath | |||
| LuaPackagePath /path/to/include/?.lua | svdh | E | |
| Add a directory to lua's package.path | |||
| LuaQuickHandler /path/to/script.lua hook_function_name | sv | E | |
| Provide a hook for the quick handler of request processing | |||
| LuaRoot /path/to/a/directory | svdh | E | |
| Specify the base path for resolving relative paths for mod_lua directives | |||
| LuaScope once|request|conn|thread|server [min] [max] | once | svdh | E |
| One of once, request, conn, thread -- default is once | |||
| <Macro name [par1 .. parN]> ... </Macro> | svd | B | |
| Define a configuration file macro | |||
| MaxConnectionsPerChild number | 0 | s | M |
| Limit on the number of connections that an individual child server will handle during its life | |||
| MaxKeepAliveRequests Anzahl | 100 | sv | C |
| Anzahl der Anfragen, die bei einer persistenten Verbindung zulässig sind | |||
| MaxMemFree KBytes | 0 | s | M |
Maximale Menge des Arbeitsspeichers, den die
Haupt-Zuteilungsroutine verwalten darf, ohne free()
aufzurufen | |||
| MaxRangeOverlaps default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete
resource | |||
| MaxRangeReversals default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of range reversals (eg: 100-200,50-70) allowed before returning the complete
resource | |||
| MaxRanges default | unlimited | none | number-of-ranges | 200 | svd | C |
| Number of ranges allowed before returning the complete resource | |||
| MaxRequestWorkers number | s | M | |
| Maximum number of connections that will be processed simultaneously | |||
| MaxSpareServers Anzahl | 10 | s | M |
| Maximale Anzahl der unbeschäftigten Kindprozesse des Servers | |||
| MaxSpareThreads Anzahl | s | M | |
| Maximale Anzahl unbeschäftigter Threads | |||
| MaxThreads number | 2048 | s | M |
| Set the maximum number of worker threads | |||
| MDActivationDelay duration | s | X | |
| How long to delay activation of new certificates | |||
| MDBaseServer on|off | off | s | X |
| Control if base server may be managed or only virtual hosts. | |||
| MDCAChallenges name [ name ... ] | tls-alpn-01 http-01 + | s | X |
| Type of ACME challenge used to prove domain ownership. | |||
| MDCertificateAgreement accepted | s | X | |
| You confirm that you accepted the Terms of Service of the Certificate Authority. | |||
| MDCertificateAuthority url | letsencrypt | s | X |
| The URL(s) of the ACME Certificate Authority to use. | |||
| MDCertificateCheck name url | s | X | |
| Set name and URL pattern for a certificate monitoring site. | |||
| MDCertificateFile path-to-pem-file | s | X | |
| Specify a static certificate file for the MD. | |||
| MDCertificateKeyFile path-to-file | s | X | |
| Specify a static private key for for the static cerrtificate. | |||
| MDCertificateMonitor name url | crt.sh https://crt. + | s | X |
| The URL of a certificate log monitor. | |||
| MDCertificateProtocol protocol | ACME | s | X |
| The protocol to use with the Certificate Authority. | |||
| MDCertificateStatus on|off | on | s | X |
| Exposes public certificate information in JSON. | |||
| MDChallengeDns01 path-to-command | s | X | |
| Set the command for setup/teardown of dns-01 challenges | |||
| MDChallengeDns01Version 1|2 | 1 | s | X |
| Set the type of arguments to call MDChallengeDns01 with | |||
| MDCheckInterval duration | 12h | s | X |
| Determines how often certificates are checked | |||
| MDContactEmail address | s | X | |
| Email address used for account registration | |||
| MDDriveMode always|auto|manual | auto | s | X |
| former name of MDRenewMode. | |||
| MDExternalAccountBinding key-id hmac-64 | none | file | none | s | X |
| Set the external account binding keyid and hmac values to use at CA | |||
| MDHttpProxy url | s | X | |
| Define a proxy for outgoing connections. | |||
| MDMatchNames all|servernames | all | s | X |
| Determines how DNS names are matched to vhosts | |||
| MDMember hostname | s | X | |
| Additional hostname for the managed domain. | |||
| MDMembers auto|manual | auto | s | X |
| Control if the alias domain names are automatically added. | |||
| MDMessageCmd path-to-cmd optional-args | s | X | |
| Handle events for Manage Domains | |||
| MDMustStaple on|off | off | s | X |
| Control if new certificates carry the OCSP Must Staple flag. | |||
| MDNotifyCmd path [ args ] | s | X | |
| Run a program when a Managed Domain is ready. | |||
| MDomain dns-name [ other-dns-name... ] [auto|manual] | s | X | |
| Define list of domain names that belong to one group. | |||
| <MDomainSet dns-name [ other-dns-name... ]>...</MDomainSet> | s | X | |
| Container for directives applied to the same managed domains. | |||
| MDPortMap map1 [ map2 ] | http:80 https:443 | s | X |
| Map external to internal ports for domain ownership verification. | |||
| MDPrivateKeys type [ params... ] | RSA 2048 | s | X |
| Set type and size of the private keys generated. | |||
| MDProfile name | s | X | |
| Use a specific ACME profile from the CA | |||
| MDProfileMandatory on|off | off | s | X |
| Control if an MDProfile is mandatory. | |||
| MDRenewMode always|auto|manual | auto | s | X |
| Controls if certificates shall be renewed. | |||
| MDRenewWindow duration | 33% | s | X |
| Control when a certificate will be renewed. | |||
| MDRequireHttps off|temporary|permanent | off | s | X |
| Redirects http: traffic to https: for Managed Domains. | |||
| MDRetryDelay duration | 5s | s | X |
| Time length for first retry, doubled on every consecutive error. | |||
| MDRetryFailover number | 13 | s | X |
| The number of errors before a failover to another CA is triggered | |||
| MDServerStatus on|off | on | s | X |
| Control if Managed Domain information is added to server-status. | |||
| MDStapleOthers on|off | on | s | X |
| Enable stapling for certificates not managed by mod_md. | |||
| MDStapling on|off | off | s | X |
| Enable stapling for all or a particular MDomain. | |||
| MDStaplingKeepResponse duration | 7d | s | X |
| Controls when old responses should be removed. | |||
| MDStaplingRenewWindow duration | 33% | s | X |
| Control when the stapling responses will be renewed. | |||
| MDStoreDir path | md | s | X |
| Path on the local file system to store the Managed Domains data. | |||
| MDStoreLocks on|off|duration | off | s | X |
| Configure locking of store for updates | |||
| MDWarnWindow duration | 10% | s | X |
| Define the time window when you want to be warned about an expiring certificate. | |||
| MemcacheConnTTL num[units] | 15s | sv | E |
| Keepalive time for idle connections | |||
| MergeSlashes ON|OFF | ON | sv | C |
| Controls whether the server merges consecutive slashes in URLs. | |||
| MergeTrailers [on|off] | off | sv | C |
| Determines whether trailers are merged into headers | |||
| MetaDir directory | .web | svdh | E |
| Name of the directory to find CERN-style meta information files | |||
| MetaFiles on|off | off | svdh | E |
| Activates CERN meta-file processing | |||
| MetaSuffix suffix | .meta | svdh | E |
| File name suffix for the file containing CERN-style meta information | |||
| MimeMagicFile file-path | sv | E | |
| Enable MIME-type determination based on file contents using the specified magic file | |||
| MinSpareServers Anzahl | 5 | s | M |
| Minimale Anzahl der unbeschäftigten Kindprozesse des Servers | |||
| MinSpareThreads Anzahl | s | M | |
| Minimale Anzahl unbeschäftigter Threads, die zur Bedienung von Anfragespitzen zur Verfügung stehen | |||
| MMapFile file-path [file-path] ... | s | X | |
| Map a list of files into memory at startup time | |||
| ModemStandard V.21|V.26bis|V.32|V.34|V.92 | d | X | |
| Modem standard to simulate | |||
| ModMimeUsePathInfo On|Off | Off | d | B |
Tells mod_mime to treat path_info
components as part of the filename | |||
| MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers [Handlers|Filters] | NegotiatedOnly | svdh | B |
| The types of files that will be included when searching for a matching file with MultiViews | |||
| Mutex mechanism [default|mutex-name] ... [OmitPID] | default | s | C |
| Configures mutex mechanism and lock file directory for all or specified mutexes | |||
| NameVirtualHost Adresse[:Port] | s | C | |
| Bestimmt eine IP-Adresse für den Betrieb namensbasierter virtueller Hosts | |||
| NoProxy host [host] ... | sv | E | |
| Hosts, domains, or networks that will be connected to directly | |||
| NWSSLTrustedCerts filename [filename] ... | s | B | |
| List of additional client certificates | |||
| NWSSLUpgradeable [IP-address:]portnumber | s | B | |
| Allows a connection to be upgraded to an SSL connection upon request | |||
| Options [+|-]Option [[+|-]Option] ... | All | svdh | C |
| Definiert, welche Eigenschaften oder Funktionen in einem bestimmten Verzeichnis verfügbar sind | |||
| Order ordering | Deny,Allow | dh | E |
Controls the default access state and the order in which
Allow and Deny are
evaluated. | |||
| OutputSed sed-command | dh | X | |
| Sed command for filtering response content | |||
| PassEnv env-variable [env-variable] ... | svdh | B | |
| Passes environment variables from the shell | |||
| PidFile Dateiname | logs/httpd.pid | s | M |
| Datei, in welcher der Server die Prozess-ID des Daemons ablegt | |||
| PrivilegesMode FAST|SECURE|SELECTIVE | FAST | svd | X |
| Trade off processing speed and efficiency vs security against malicious privileges-aware code. | |||
| Protocol protocol | sv | C | |
| Protocol for a listening socket | |||
| ProtocolEcho On|Off | Off | sv | X |
| Turn the echo server on or off | |||
| Protocols protocol ... | http/1.1 | sv | C |
| Protocols available for a server/virtual host | |||
| ProtocolsHonorOrder On|Off | On | sv | C |
| Determines if order of Protocols determines precedence during negotiation | |||
| <Proxy wildcard-url> ...</Proxy> | sv | E | |
| Container for directives applied to proxied resources | |||
| Proxy100Continue Off|On | On | svd | E |
| Forward 100-continue expectation to the origin server | |||
| ProxyAddHeaders Off|On | On | svd | E |
| Add proxy information in X-Forwarded-* headers | |||
| ProxyBadHeader IsError|Ignore|StartBody | IsError | sv | E |
| Determines how to handle bad header lines in a response | |||
| ProxyBlock *|word|host|domain [word|host|domain] ... | sv | E | |
| Words, hosts, or domains that are banned from being proxied | |||
| ProxyDomain Domain | sv | E | |
| Default domain name for proxied requests | |||
| ProxyErrorOverride Off|On [code ...] | Off | svd | E |
| Override error pages for proxied content | |||
| ProxyExpressDBMFile pathname | sv | E | |
| Pathname to DBM file. | |||
| ProxyExpressDBMType type | default | sv | E |
| DBM type of file. | |||
| ProxyExpressEnable on|off | off | sv | E |
| Enable the module functionality. | |||
| ProxyFCGIBackendType FPM|GENERIC | FPM | svdh | E |
| Specify the type of backend FastCGI application | |||
| ProxyFCGISetEnvIf conditional-expression [!]environment-variable-name [value-expression] | svdh | E | |
| Allow variables sent to FastCGI servers to be fixed up | |||
| ProxyFtpDirCharset character_set | ISO-8859-1 | svd | E |
| Define the character set for proxied FTP listings | |||
| ProxyFtpEscapeWildcards on|off | on | svd | E |
| Whether wildcards in requested filenames are escaped when sent to the FTP server | |||
| ProxyFtpListOnWildcard on|off | on | svd | E |
| Whether wildcards in requested filenames trigger a file listing | |||
| ProxyHCExpr name {ap_expr expression} | sv | E | |
| Creates a named condition expression to use to determine health of the backend based on its response | |||
| ProxyHCTemplate name parameter=setting [...] | sv | E | |
| Creates a named template for setting various health check parameters | |||
| ProxyHCTPsize size | 16 | s | E |
| Sets the total server-wide size of the threadpool used for the health check workers | |||
| ProxyHTMLBufSize bytes | 8192 | svd | B |
| Sets the buffer size increment for buffering inline scripts and stylesheets. | |||
| ProxyHTMLCharsetOut Charset | * | svd | B | |
| Specify a charset for mod_proxy_html output. | |||
| ProxyHTMLDocType HTML|XHTML [Legacy] OR ProxyHTMLDocType fpi [SGML|XML] | svd | B | |
| Sets an HTML or XHTML document type declaration. | |||
| ProxyHTMLEnable On|Off | Off | svd | B |
| Turns the proxy_html filter on or off. | |||
| ProxyHTMLEvents attribute [attribute ...] | svd | B | |
| Specify attributes to treat as scripting events. | |||
| ProxyHTMLExtended On|Off | Off | svd | B |
| Determines whether to fix links in inline scripts, stylesheets, and scripting events. | |||
| ProxyHTMLFixups [lowercase] [dospath] [reset] | svd | B | |
| Fixes for simple HTML errors. | |||
| ProxyHTMLInterp On|Off | Off | svd | B |
Enables per-request interpolation of
ProxyHTMLURLMap rules. | |||
| ProxyHTMLLinks element attribute [attribute2 ...] | svd | B | |
| Specify HTML elements that have URL attributes to be rewritten. | |||
| ProxyHTMLMeta On|Off | Off | svd | B |
Turns on or off extra pre-parsing of metadata in HTML
<head> sections. | |||
| ProxyHTMLStripComments On|Off | Off | svd | B |
| Determines whether to strip HTML comments. | |||
| ProxyHTMLURLMap from-pattern to-pattern [flags] [cond] | svd | B | |
| Defines a rule to rewrite HTML links | |||
| ProxyIOBufferSize bytes | 8192 | sv | E |
| Determine size of internal data throughput buffer | |||
| <ProxyMatch regex> ...</ProxyMatch> | sv | E | |
| Container for directives applied to regular-expression-matched proxied resources | |||
| ProxyMaxForwards number | -1 | sv | E |
| Maximum number of proxies that a request can be forwarded through | |||
| ProxyPass [path] !|url [key=value [key=value ...]] [nocanon] [interpolate] [noquery] | svd | E | |
| Maps remote servers into the local server URL-space | |||
| ProxyPassInherit On|Off | On | sv | E |
| Inherit ProxyPass directives defined from the main server | |||
| ProxyPassInterpolateEnv On|Off | Off | svd | E |
| Enable Environment Variable interpolation in Reverse Proxy configurations | |||
| ProxyPassMatch [regex] !|url [key=value [key=value ...]] | svd | E | |
| Maps remote servers into the local server URL-space using regular expressions | |||
| ProxyPassReverse [path] url [interpolate] | svd | E | |
| Adjusts the URL in HTTP response headers sent from a reverse proxied server | |||
| ProxyPassReverseCookieDomain internal-domain public-domain [interpolate] | svd | E | |
| Adjusts the Domain string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPassReverseCookiePath internal-path public-path [interpolate] | svd | E | |
| Adjusts the Path string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPreserveHost On|Off | Off | svd | E |
| Use incoming Host HTTP request header for proxy request | |||
| ProxyReceiveBufferSize bytes | 0 | sv | E |
| Network buffer size for proxied HTTP and FTP connections | |||
| ProxyRemote match remote-server [username:password] | sv | E | |
| Remote proxy used to handle certain requests | |||
| ProxyRemoteMatch regex remote-server [username:password] | sv | E | |
| Remote proxy used to handle requests matched by regular expressions | |||
| ProxyRequests On|Off | Off | sv | E |
| Enables forward (standard) proxy requests | |||
| ProxySCGIInternalRedirect On|Off|Headername | On | svd | E |
| Enable or disable internal redirect responses from the backend | |||
| ProxySCGISendfile On|Off|Headername | Off | svd | E |
| Enable evaluation of X-Sendfile pseudo response header | |||
| ProxySet url key=value [key=value ...] | svd | E | |
| Set various Proxy balancer or member parameters | |||
| ProxySourceAddress address | sv | E | |
| Set local IP address for outgoing proxy connections | |||
| ProxyStatus Off|On|Full | Off | sv | E |
| Show Proxy LoadBalancer status in mod_status | |||
| ProxyTimeout seconds | sv | E | |
| Network timeout for proxied requests | |||
| ProxyVia On|Off|Full|Block | Off | sv | E |
Information provided in the Via HTTP response
header for proxied requests | |||
| ProxyWebsocketFallbackToProxyHttp On|Off | On | sv | E |
Instructs this module to let mod_proxy_http handle the request | |||
| QualifyRedirectURL On|Off | Off | svd | C |
| Controls whether the REDIRECT_URL environment variable is fully qualified | |||
| ReadBufferSize bytes | 8192 | svd | C |
| Size of the buffers used to read data | |||
| ReadmeName filename | svdh | B | |
| Name of the file that will be inserted at the end of the index listing | |||
| ReceiveBufferSize bytes | 0 | s | M |
| TCP receive buffer size | |||
| Redirect [status] [URL-path] URL | svdh | B | |
| Sends an external redirect asking the client to fetch a different URL | |||
| RedirectMatch [status] regex URL | svdh | B | |
| Sends an external redirect based on a regular expression match of the current URL | |||
| RedirectPermanent URL-path URL | svdh | B | |
| Sends an external permanent redirect asking the client to fetch a different URL | |||
| RedirectRelative On|Off | Off | svd | B |
| Allows relative redirect targets. | |||
| RedirectTemp URL-path URL | svdh | B | |
| Sends an external temporary redirect asking the client to fetch a different URL | |||
| RedisConnPoolTTL num[units] | 15s | sv | E |
| TTL used for the connection pool with the Redis server(s) | |||
| RedisTimeout num[units] | 5s | sv | E |
| R/W timeout used for the connection with the Redis server(s) | |||
| ReflectorHeader inputheader [outputheader] | svdh | B | |
| Reflect an input header to the output headers | |||
| RegexDefaultOptions [none] [+|-]option [[+|-]option] ... | DOTALL DOLLAR_ENDON + | s | C |
| Allow to configure global/default options for regexes | |||
| RegisterHttpMethod method [method [...]] | s | C | |
| Register non-standard HTTP methods | |||
| RemoteIPHeader header-field | sv | B | |
| Declare the header field which should be parsed for useragent IP addresses | |||
| RemoteIPInternalProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPInternalProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPProxiesHeader HeaderFieldName | sv | B | |
| Declare the header field which will record all intermediate IP addresses | |||
| RemoteIPProxyProtocol On|Off | sv | B | |
| Enable or disable PROXY protocol handling | |||
| RemoteIPProxyProtocolExceptions host|range [host|range] [host|range] | sv | B | |
| Disable processing of PROXY header for certain hosts or networks | |||
| RemoteIPTrustedProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPTrustedProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoveCharset extension [extension] ... | vdh | B | |
| Removes any character set associations for a set of file extensions | |||
| RemoveEncoding extension [extension] ... | vdh | B | |
| Removes any content encoding associations for a set of file extensions | |||
| RemoveHandler extension [extension] ... | vdh | B | |
| Removes any handler associations for a set of file extensions | |||
| RemoveInputFilter extension [extension] ... | vdh | B | |
| Removes any input filter associations for a set of file extensions | |||
| RemoveLanguage extension [extension] ... | vdh | B | |
| Removes any language associations for a set of file extensions | |||
| RemoveOutputFilter extension [extension] ... | vdh | B | |
| Removes any output filter associations for a set of file extensions | |||
| RemoveType extension [extension] ... | vdh | B | |
| Removes any content type associations for a set of file extensions | |||
| RequestHeader add|append|edit|edit*|merge|set|setifempty|unset header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] | svdh | E | |
| Configure HTTP request headers | |||
| RequestReadTimeout [handshake=timeout[-maxtimeout][,MinRate=rate] [header=timeout[-maxtimeout][,MinRate=rate] [body=timeout[-maxtimeout][,MinRate=rate] | handshake=0 header= + | sv | E |
| Set timeout values for completing the TLS handshake, receiving the request headers and/or body from client. | |||
| Require [not] entity-name [entity-name] ... | dh | B | |
| Tests whether an authenticated user is authorized by an authorization provider. | |||
| <RequireAll> ... </RequireAll> | dh | B | |
| Enclose a group of authorization directives of which none must fail and at least one must succeed for the enclosing directive to succeed. | |||
| <RequireAny> ... </RequireAny> | dh | B | |
| Enclose a group of authorization directives of which one must succeed for the enclosing directive to succeed. | |||
| <RequireNone> ... </RequireNone> | dh | B | |
| Enclose a group of authorization directives of which none must succeed for the enclosing directive to not fail. | |||
| RewriteBase URL-path | dh | E | |
| Sets the base URL for per-directory rewrites | |||
| RewriteCond TestString CondPattern [flags] | svdh | E | |
| Defines a condition under which rewriting will take place | |||
| RewriteEngine on|off | off | svdh | E |
| Enables or disables runtime rewriting engine | |||
| RewriteMap MapName MapType:MapSource [MapTypeOptions] | sv | E | |
| Defines a mapping function for key-lookup | |||
| RewriteOptions Options | svdh | E | |
| Sets some special options for the rewrite engine | |||
| RewriteRule Pattern Substitution [flags] | svdh | E | |
| Defines rules for the rewriting engine | |||
| RLimitCPU Sekunden|max [Sekunden|max] | svdh | C | |
| Begrenzt den CPU-Verbrauch von Prozessen, die von Apache-Kindprozessen gestartet wurden | |||
| RLimitMEM Bytes|max [Bytes|max] | svdh | C | |
| Begrenzt den Speicherverbrauch von Prozessen, die von Apache-Kindprozessen gestartet wurden | |||
| RLimitNPROC Zahl|max [Zahl|max] | svdh | C | |
| Begrenzt die Anzahl der Prozesse, die von Prozessen gestartet werden können, der ihrerseits von Apache-Kinprozessen gestartet wurden | |||
| Satisfy Any|All | All | dh | E |
| Interaction between host-level access control and user authentication | |||
| ScoreBoardFile Dateipfad | logs/apache_status | s | M |
| Ablageort der Datei, die zur Speicherung von Daten zur Koordinierung der Kindprozesse verwendet wird | |||
| Script Methode CGI-Skript | svd | B | |
| Aktiviert ein CGI-Skript für eine bestimmte Anfragemethode. | |||
| ScriptAlias [URL-path] file-path|directory-path | svd | B | |
| Maps a URL to a filesystem location and designates the target as a CGI script | |||
| ScriptAliasMatch regex file-path|directory-path | sv | B | |
| Maps a URL to a filesystem location using a regular expression and designates the target as a CGI script | |||
| ScriptInterpreterSource Registry|Registry-Strict|Script | Script | svdh | C |
| Methode zur Ermittlung des Interpreters von CGI-Skripten | |||
| ScriptLog file-path | sv | B | |
| Location of the CGI script error logfile | |||
| ScriptLogBuffer bytes | 1024 | sv | B |
| Maximum amount of PUT or POST requests that will be recorded in the scriptlog | |||
| ScriptLogLength bytes | 10385760 | sv | B |
| Size limit of the CGI script logfile | |||
| ScriptSock file-path | cgisock | s | B |
| The filename prefix of the socket to use for communication with the cgi daemon | |||
| SecureListen [IP-address:]portnumber Certificate-Name [MUTUAL] | s | B | |
| Enables SSL encryption for the specified port | |||
| SeeRequestTail On|Off | Off | s | C |
| Determine if mod_status displays the first 63 characters of a request or the last 63, assuming the request itself is greater than 63 chars. | |||
| SendBufferSize Bytes | 0 | s | M |
| Größe des TCP-Puffers | |||
| ServerAdmin E-Mail-Adresse|URL | sv | C | |
| E-Mail-Adresse, die der Server in Fehlermeldungen einfügt, welche an den Client gesendet werden | |||
| ServerAlias Hostname [Hostname] ... | v | C | |
| Alternativer Name für einen Host, der verwendet wird, wenn Anfragen einem namensbasierten virtuellen Host zugeordnet werden | |||
| ServerLimit Anzahl | s | M | |
| Obergrenze für die konfigurierbare Anzahl von Prozessen | |||
| ServerName voll-qualifizierter-Domainname[:port] | sv | C | |
| Rechnername und Port, die der Server dazu verwendet, sich selbst zu identifizieren | |||
| ServerPath URL-Pfad | v | C | |
| Veralteter URL-Pfad für einen namensbasierten virtuellen Host, auf den von einem inkompatiblen Browser zugegriffen wird | |||
| ServerRoot Verzeichnis | /usr/local/apache | s | C |
| Basisverzeichnis der Serverinstallation | |||
| ServerSignature On|Off|EMail | Off | svdh | C |
| Konfiguriert die Fußzeile von servergenerierten Dokumenten | |||
| ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full | Full | s | C |
Konfiguriert den HTTP-Response-Header
Server | |||
| Session On|Off | Off | svdh | E |
| Enables a session for the current directory or location | |||
| SessionCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session | |||
| SessionCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session | |||
| SessionCookieRemove On|Off | Off | svdh | E |
| Control for whether session cookies should be removed from incoming HTTP headers | |||
| SessionCryptoCipher name | aes256 | svdh | X |
| The crypto cipher to be used to encrypt the session | |||
| SessionCryptoDriver name [param[=value]] | s | X | |
| The crypto driver to be used to encrypt the session | |||
| SessionCryptoPassphrase secret [ secret ... ] | svdh | X | |
| The key used to encrypt the session | |||
| SessionCryptoPassphraseFile filename | svd | X | |
| File containing keys used to encrypt the session | |||
| SessionDBDCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session ID | |||
| SessionDBDCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session ID | |||
| SessionDBDCookieRemove On|Off | On | svdh | E |
| Control for whether session ID cookies should be removed from incoming HTTP headers | |||
| SessionDBDDeleteLabel label | deletesession | svdh | E |
| The SQL query to use to remove sessions from the database | |||
| SessionDBDInsertLabel label | insertsession | svdh | E |
| The SQL query to use to insert sessions into the database | |||
| SessionDBDPerUser On|Off | Off | svdh | E |
| Enable a per user session | |||
| SessionDBDSelectLabel label | selectsession | svdh | E |
| The SQL query to use to select sessions from the database | |||
| SessionDBDUpdateLabel label | updatesession | svdh | E |
| The SQL query to use to update existing sessions in the database | |||
| SessionEnv On|Off | Off | svdh | E |
| Control whether the contents of the session are written to the HTTP_SESSION environment variable | |||
| SessionExclude path | svdh | E | |
| Define URL prefixes for which a session is ignored | |||
| SessionExpiryUpdateInterval interval | 0 (always update) | svdh | E |
| Define the number of seconds a session's expiry may change without the session being updated | |||
| SessionHeader header | svdh | E | |
| Import session updates from a given HTTP response header | |||
| SessionInclude path | svdh | E | |
| Define URL prefixes for which a session is valid | |||
| SessionMaxAge maxage | 0 | svdh | E |
| Define a maximum age in seconds for a session | |||
| SetEnv env-variable [value] | svdh | B | |
| Sets environment variables | |||
| SetEnvIf attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on attributes of the request | |||
| SetEnvIfExpr expr [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on an ap_expr expression | |||
| SetEnvIfNoCase attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on attributes of the request without respect to case | |||
| SetHandler Handlername|None | svdh | C | |
| Erzwingt die Verarbeitung aller passenden Dateien durch einen Handler | |||
| SetInputFilter Filter[;Filter...] | svdh | C | |
| Bestimmt die Filter, die Client-Anfragen und POST-Eingaben verarbeiten | |||
| SetOutputFilter Filter[;Filter...] | svdh | C | |
| Bestimmt die Filter, die Antworten des Servers verarbeiten | |||
| SSIEndTag tag | "-->" | sv | B |
| String that ends an include element | |||
| SSIErrorMsg message | "[an error occurred + | svdh | B |
| Error message displayed when there is an SSI error | |||
| SSIETag on|off | off | dh | B |
| Controls whether ETags are generated by the server. | |||
| SSILastModified on|off | off | dh | B |
Controls whether Last-Modified headers are generated by the
server. | |||
| SSILegacyExprParser on|off | off | dh | B |
| Enable compatibility mode for conditional expressions. | |||
| SSIStartTag tag | "<!--#" | sv | B |
| String that starts an include element | |||
| SSITimeFormat formatstring | "%A, %d-%b-%Y %H:%M + | svdh | B |
| Configures the format in which date strings are displayed | |||
| SSIUndefinedEcho string | "(none)" | svdh | B |
| String displayed when an unset variable is echoed | |||
| SSLCACertificateFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for Client Auth | |||
| SSLCACertificatePath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for Client Auth | |||
| SSLCADNRequestFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCADNRequestPath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCARevocationCheck chain|leaf|none [flags ...] | none | sv | E |
| Enable CRL-based revocation checking | |||
| SSLCARevocationFile file-path | sv | E | |
| File of concatenated PEM-encoded CA CRLs for Client Auth | |||
| SSLCARevocationPath directory-path | sv | E | |
| Directory of PEM-encoded CA CRLs for Client Auth | |||
| SSLCertificateChainFile file-path | sv | E | |
| File of PEM-encoded Server CA Certificates | |||
| SSLCertificateFile file-path|certid | sv | E | |
| Server PEM-encoded X.509 certificate data file or token identifier | |||
| SSLCertificateKeyFile file-path|keyid | sv | E | |
| Server PEM-encoded private key file | |||
| SSLCipherSuite [protocol] cipher-spec | DEFAULT (depends on + | svdh | E |
| Cipher Suite available for negotiation in SSL handshake | |||
| SSLCompression on|off | off | sv | E |
| Enable compression on the SSL level | |||
| SSLCryptoDevice engine | builtin | s | E |
| Enable use of a cryptographic hardware accelerator | |||
| SSLEngine on|off|optional | off | sv | E |
| SSL Engine Operation Switch | |||
| SSLFIPS on|off | off | s | E |
| SSL FIPS mode Switch | |||
| SSLHonorCipherOrder on|off | off | sv | E |
| Option to prefer the server's cipher preference order | |||
| SSLInsecureRenegotiation on|off | off | sv | E |
| Option to enable support for insecure renegotiation | |||
| SSLOCSPDefaultResponder uri | sv | E | |
| Set the default responder URI for OCSP validation | |||
| SSLOCSPEnable on|leaf|off | off | sv | E |
| Enable OCSP validation of the client certificate chain | |||
| SSLOCSPNoverify on|off | off | sv | E |
| skip the OCSP responder certificates verification | |||
| SSLOCSPOverrideResponder on|off | off | sv | E |
| Force use of the default responder URI for OCSP validation | |||
| SSLOCSPProxyURL url | sv | E | |
| Proxy URL to use for OCSP requests | |||
| SSLOCSPResponderCertificateFile file | sv | E | |
| Set of trusted PEM encoded OCSP responder certificates | |||
| SSLOCSPResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP queries | |||
| SSLOCSPResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP responses | |||
| SSLOCSPResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP response validation | |||
| SSLOCSPUseRequestNonce on|off | on | sv | E |
| Use a nonce within OCSP queries | |||
| SSLOpenSSLConfCmd command-name command-value | sv | E | |
| Configure OpenSSL parameters through its SSL_CONF API | |||
| SSLOptions [+|-]option ... | svdh | E | |
| Configure various SSL engine run-time options | |||
| SSLPassPhraseDialog type | builtin | s | E |
| Type of pass phrase dialog for encrypted private keys | |||
| SSLProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | sv | E |
| Configure usable SSL/TLS protocol versions | |||
| SSLProxyCACertificateFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCACertificatePath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCARevocationCheck chain|leaf|none | none | sv | E |
| Enable CRL-based revocation checking for Remote Server Auth | |||
| SSLProxyCARevocationFile file-path | sv | E | |
| File of concatenated PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCARevocationPath directory-path | sv | E | |
| Directory of PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCheckPeerCN on|off | on | sv | E |
| Whether to check the remote server certificate's CN field | |||
| SSLProxyCheckPeerExpire on|off | on | sv | E |
| Whether to check if remote server certificate is expired | |||
| SSLProxyCheckPeerName on|off | on | sv | E |
| Configure host name checking for remote server certificates | |||
| SSLProxyCipherSuite [protocol] cipher-spec | ALL:!ADH:RC4+RSA:+H + | sv | E |
| Cipher Suite available for negotiation in SSL proxy handshake | |||
| SSLProxyEngine on|off | off | sv | E |
| SSL Proxy Engine Operation Switch | |||
| SSLProxyMachineCertificateChainFile filename | sv | E | |
| File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate | |||
| SSLProxyMachineCertificateFile filename | sv | E | |
| File of concatenated PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyMachineCertificatePath directory | sv | E | |
| Directory of PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | sv | E |
| Configure usable SSL protocol flavors for proxy usage | |||
| SSLProxyVerify level | none | sv | E |
| Type of remote server Certificate verification | |||
| SSLProxyVerifyDepth number | 1 | sv | E |
| Maximum depth of CA Certificates in Remote Server Certificate verification | |||
| SSLRandomSeed context source [bytes] | s | E | |
| Pseudo Random Number Generator (PRNG) seeding source | |||
| SSLRenegBufferSize bytes | 131072 | dh | E |
| Set the size for the SSL renegotiation buffer | |||
| SSLRequire expression | dh | E | |
| Allow access only when an arbitrarily complex boolean expression is true | |||
| SSLRequireSSL | dh | E | |
| Deny access when SSL is not used for the HTTP request | |||
| SSLSessionCache type | none | s | E |
| Type of the global/inter-process SSL Session Cache | |||
| SSLSessionCacheTimeout seconds | 300 | sv | E |
| Number of seconds before an SSL session expires in the Session Cache | |||
| SSLSessionTicketKeyFile file-path | sv | E | |
| Persistent encryption/decryption key for TLS session tickets | |||
| SSLSessionTickets on|off | on | sv | E |
| Enable or disable use of TLS session tickets | |||
| SSLSRPUnknownUserSeed secret-string | sv | E | |
| SRP unknown user seed | |||
| SSLSRPVerifierFile file-path | sv | E | |
| Path to SRP verifier file | |||
| SSLStaplingCache type | s | E | |
| Configures the OCSP stapling cache | |||
| SSLStaplingErrorCacheTimeout seconds | 600 | sv | E |
| Number of seconds before expiring invalid responses in the OCSP stapling cache | |||
| SSLStaplingFakeTryLater on|off | on | sv | E |
| Synthesize "tryLater" responses for failed OCSP stapling queries | |||
| SSLStaplingForceURL uri | sv | E | |
| Override the OCSP responder URI specified in the certificate's AIA extension | |||
| SSLStaplingResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP stapling queries | |||
| SSLStaplingResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP stapling responses | |||
| SSLStaplingResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP stapling response validation | |||
| SSLStaplingReturnResponderErrors on|off | on | sv | E |
| Pass stapling related OCSP errors on to client | |||
| SSLStaplingStandardCacheTimeout seconds | 3600 | sv | E |
| Number of seconds before expiring responses in the OCSP stapling cache | |||
| SSLStrictSNIVHostCheck on|off | off | sv | E |
| Whether to allow non-SNI clients to access a name-based virtual host. | |||
| SSLUserName varname | sdh | E | |
| Variable name to determine user name | |||
| SSLUseStapling on|off | off | sv | E |
| Enable stapling of OCSP responses in the TLS handshake | |||
| SSLVerifyClient level | none | svdh | E |
| Type of Client Certificate verification | |||
| SSLVerifyDepth number | 1 | svdh | E |
| Maximum depth of CA Certificates in Client Certificate verification | |||
| StartServers Anzahl | s | M | |
| Anzahl der Kindprozesse des Servers, die beim Start erstellt werden | |||
| StartThreads Anzahl | s | M | |
| Anzahl der Threads, die beim Start erstellt werden | |||
| StrictHostCheck ON|OFF | OFF | sv | C |
| Controls whether the server requires the requested hostname be listed enumerated in the virtual host handling the request | |||
| Substitute s/pattern/substitution/[infq] | dh | E | |
| Pattern to filter the response content | |||
| SubstituteInheritBefore on|off | off | dh | E |
| Change the merge order of inherited patterns | |||
| SubstituteMaxLineLength bytes(b|B|k|K|m|M|g|G) | 1m | dh | E |
| Set the maximum line size | |||
| Suexec On|Off | s | B | |
| Enable or disable the suEXEC feature | |||
| SuexecUserGroup User Group | sv | E | |
| User and group for CGI programs to run as | |||
| ThreadLimit Anzahl | s | M | |
| Bestimmt die Obergrenze der konfigurierbaren Anzahl von Threads pro Kindprozess | |||
| ThreadsPerChild Anzahl | s | M | |
| Anzahl der Threads, die mit jedem Kindprozess gestartet werden | |||
| ThreadStackSize size | s | M | |
| Die Größe des Stacks in Bytes, der von Threads verwendet wird, die Client-Verbindungen bearbeiten. | |||
| TimeOut Sekunden | 60 | s | C |
| Zeitspanne, die der Server auf verschiedene Ereignisse wartet, bevor er die Anfrage abbricht | |||
| TraceEnable [on|off|extended] | on | s | C |
Legt das Verhalten von TRACE-Anfragen fest | |||
| TransferLog file|pipe | sv | B | |
| Specify location of a log file | |||
| TypesConfig file-path | conf/mime.types | s | B |
The location of the mime.types file | |||
| UNCList hostname [hostname...] | s | C | |
| Controls what UNC host names can be accessed by the server | |||
| UnDefine parameter-name | s | C | |
| Undefine the existence of a variable | |||
| UndefMacro name | svd | B | |
| Undefine a macro | |||
| UnsetEnv env-variable [env-variable] ... | svdh | B | |
| Removes variables from the environment | |||
| Use name [value1 ... valueN] | svd | B | |
| Use a macro | |||
| UseCanonicalName On|Off|DNS | Off | svd | C |
| Bestimmt, wie der Server seinen eigenen Namen und Port ermittelt | |||
| UseCanonicalPhysicalPort On|Off | Off | svd | C |
| Bestimmt, wie der Server seinen eigenen Namen und Port ermittelt | |||
| User unix-userid | #-1 | s | B |
| The userid under which the server will answer requests | |||
| UserDir directory-filename [directory-filename] ... | sv | B | |
| Location of the user-specific directories | |||
| VHostCGIMode On|Off|Secure | On | v | X |
| Determines whether the virtualhost can run subprocesses, and the privileges available to subprocesses. | |||
| VHostCGIPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to subprocesses created by a virtual host. | |||
| VHostGroup unix-groupid | v | X | |
| Sets the Group ID under which a virtual host runs. | |||
| VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to a virtual host. | |||
| VHostSecure On|Off | On | v | X |
| Determines whether the server runs with enhanced security for the virtualhost. | |||
| VHostUser unix-userid | v | X | |
| Sets the User ID under which a virtual host runs. | |||
| VirtualDocumentRoot interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| VirtualDocumentRootIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| <VirtualHost Adresse[:Port] [Adresse[:Port]] ...> ... </VirtualHost> | s | C | |
| Enthält Direktiven, die nur auf bestimmte Hostnamen oder IP-Adressen angewendet werden | |||
| VirtualScriptAlias interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| VirtualScriptAliasIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| WatchdogInterval time-interval[s] | 1 | s | B |
| Watchdog interval in seconds | |||
| XBitHack on|off|full | off | svdh | B |
| Parse SSI directives in files with the execute bit set | |||
| xml2EncAlias charset alias [alias ...] | s | B | |
| Recognise Aliases for encoding values | |||
| xml2EncDefault name | svdh | B | |
| Sets a default encoding to assume when absolutely no information can be automatically detected | |||
| xml2StartParse element [element ...] | svdh | B | |
| Advise the parser to skip leading junk. | |||
Apache HTTP サーバ バージョン 2.4
| 説明: | mod_dav のためのファイルシステムプロバイダ |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | dav_fs_module |
| ソースファイル: | mod_dav_fs.c |
このモジュールは mod_dav
のサービスを必要とします。mod_dav
のサポートモジュールとして動作し、サーバファイルシステム上に
位置するリソースへのアクセスを提供します。このプロバイダの正式な名前は
filesystem です。mod_dav
バックエンドプロバイダは Dav
ディレクティブを使用して起動されます。
Dav filesystem
filesystem は mod_dav
のデフォルトプロバイダになっていますから、代わりに単に
On と指定することもできます。
| 説明: | DAV ロックデータベースの位置 |
|---|---|
| 構文: | DavLockDB file-path |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_dav_fs |
ロックデータベースへのフルパスを、拡張子を除いた形で
指定するには、DavLockDB
を使います。パスが絶対パスでなければ、ServerRoot からの相対パスと解釈されます。
mod_dav_fs 実装では、ユーザロックを
追跡するために SDBM データベースを使います。
DavLockDB logs/DavLock
Apache HTTP Server Version 2.4
| : | mod_dav Ͻý |
|---|---|
| : | Extension |
| : | dav_fs_module |
| ҽ: | mod_dav_fs.c |
mod_dav ʿϴ.
mod_dav ϴ Ͻýۿ
ִ ڿ ֵ Ѵ. (provider)
ĸĪ filesystem̴. Dav þ Ͽ
mod_dav ڸ Ѵ:
Dav filesystem
filesystem mod_dav
⺻ ̹Ƿ On ִ.
| : | DAV ͺ̽ ġ |
|---|---|
| : | DavLockDB file-path |
| : | ּ, ȣƮ |
| : | Extension |
| : | mod_dav_fs |
DavLockDB þ ͺ̽
ü θ Ȯڸ ϰ Ѵ. ΰ ƴϸ
ServerRoot η
óѴ. mod_dav_fs SDBM ͺ̽
Ѵ.
DavLockDB var/DavLock
ġ ϴ User
Group
ͺ̽ ִ 丮 Ѵ.
Ȼ 丮 ٲٱ⺸ٴ
ͺ̽ 丮 Ѵ. ġ
ServerRoot Ʒ
var/ 丮 Ȯ
DavLock .
Apache HTTP サーバ バージョン 2.4
| 説明: | クライアントへ送られる前にコンテンツを圧縮する |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | deflate_module |
| ソースファイル: | mod_deflate.c |
mod_deflate モジュールは DEFLATE
出力フィルタを提供します。これはサーバからの出力を、ネットワークを
通してクライアントに送る前に圧縮することを可能にします。
DeflateAlterETag DeflateBufferSize DeflateCompressionLevel DeflateFilterNote DeflateInflateLimitRequestBody DeflateInflateRatioBurst DeflateInflateRatioLimit DeflateMemLevel DeflateWindowSize下にせっかちな人向けの簡単な設定例を示します。
AddOutputFilterByType DEFLATE text/html text/plain text/xml
以下の設定はコンテンツをより圧縮しますが、ずっと複雑な設定になります。 設定の隅々までよく理解しないで使わないでください。
<Location />
# Insert filter
SetOutputFilter DEFLATE
# Netscape 4.x has some problems...
BrowserMatch ^Mozilla/4 gzip-only-text/html
# Netscape 4.06-4.08 have some more problems
BrowserMatch ^Mozilla/4\.0[678] no-gzip
# MSIE masquerades as Netscape, but it is fine
# BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
# Don't compress images
SetEnvIfNoCase Request_URI \
\.(?:gif|jpe?g|png)$ no-gzip dont-vary
# Make sure proxies don't deliver the wrong content
Header append Vary User-Agent env=!dont-vary
</Location>
圧縮機能は DEFLATE フィルタ
により実装されています。以下のディレクティブはそのディレクティブのある
コンテナ中のドキュメントを圧縮するようにします:
SetOutputFilter DEFLATE
よく使われているブラウザでは、すべてのコンテンツに対する
圧縮を扱えるわけではありません。ですから、gzip-only-text/html
ノートを 1 にして、html ファイルに対してのみ
圧縮が働くようにした方がよいかもしれません (以下参照)
この値を 1 以外の値に設定した場合は無視されます。
通常、特定のMIMEタイプについてのみ圧縮したいのであれば、
AddOutputFilterByType
ディレクティブを使用します。次に Apache のドキュメントの html
ファイルのみの圧縮を有効にする例を示します。
<Directory "/your-server-root/manual">
AddOutputFilterByType DEFLATE text/html
</Directory>
全てのファイルタイプでの圧縮に問題を抱えているブラウザに対しては、
BrowserMatch
ディレクティブを使用して、特定のブラウザに no-gzip
ノートをセットし、圧縮が行なわれないようにします。
no-gzip と gzip-only-text/html
を組み合わせることで上手く対処できます。
この場合、前者が後者をオーバーライドします。
上記の設定例の抜粋を
次に示しますのでご覧下さい。
BrowserMatch ^Mozilla/4 gzip-only-text/html
BrowserMatch ^Mozilla/4\.0[678] no-gzip
BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
まず始めに User-Agent 文字列から Netscape Navigator
4.x であるかどうかを調べます。これらのバージョンでは、
text/html 以外のタイプの圧縮を扱うことができません。
4.06, 4.07, 4.08 は html ファイルの伸張にも問題を抱えています。
ですからこれらに対しては、完全に deflate フィルタをオフにします。
3 番目の BrowserMatch
ディレクティブで、推測したユーザーエージェントを修正します。
なぜなら Microsoft Internet Explorer も "Mozilla/4" と特定されますが、
これらは実際には圧縮を扱うことができるからです。
User-Agent ヘッダを "MSIE"
(\b は「単語の境界」を意味します) の追加文字で検査して、
これ以前に設定した制限を再び解除します。
DEFLATE フィルタは必ず、PHP や SSI といった RESOURCE
フィルタの後になります。
DEFLATE フィルタは内部的なサブリクエストを関知しません。
mod_deflate モジュールは、gzip 圧縮されたレスポンス
本文を inflate/uncompress するフィルタも提供しています。
この機能を有効にするには、SetOutputFilter
や AddOutputFilter を使って、
INFLATE フィルタを出力フィルタチェインに挿入します。
例えば次のようにします。
<Location /dav-area>
ProxyPass http://example.com/
SetOutputFilter INFLATE
</Location>
この例では、example.com からの gzip 圧縮された出力を伸長し、 その他のフィルタがさらにその出力を処理できるようにします。
mod_deflate モジュールは、gzip
で圧縮されたリクエスト本体を伸張するフィルタも提供しています。
この機能を有効にするには、SetInputFilter
か AddInputFilter を使用して、
DEFLATE フィルタを入力フィルタチェインに組み込みます。
例えば次のようになります。
<Location /dav-area>
SetInputFilter DEFLATE
</Location>
この設定であれば、Content-Encoding: gzip
ヘッダを含むリクエストが来ると、本体は自動的に伸張されます。
gzip リクエスト本体を送信するブラウザはあまりありません。
しかし、例えば WebDAV
クライアントの幾つかなど、特別なアプリケーションでリクエストの
圧縮を実際にサポートしているものもあります。
リクエスト本体それ自体を評価する場合は、Content-Length
ヘッダを信用しないでください。Content-Length ヘッダは、
クライアントから送信されるデータの長さを反映しているのであって、
伸張されたデータストリームのバイトカウントではありません。
mod_deflate モジュールは Vary: Accept-Encoding
HTTP 応答ヘッダを送信して、適切な Accept-Encoding
リクエストヘッダを送信するクライアントに対してのみ、
プロクシサーバがキャッシュした応答を送信するように注意を喚起します。
このようにして、圧縮を扱うことのできないクライアントに
圧縮された内容が送られることのないようにします。
もし特別に何かに依存して除外したい場合、例えば User-Agent
ヘッダなどに依存している場合、手動で Vary ヘッダを設定して、
追加の制限についてプロクシサーバに注意を行なう必要があります。
例えば User-Agent に依存して DEFLATE
を追加する典型的な設定では、次のように追加することになります。
Header append Vary User-Agent
リクエストヘッダ以外の情報 (例えば HTTP バージョン)
に依存して圧縮するかどうか決める場合、
Vary ヘッダを * に設定する必要があります。
このようにすると、仕様に準拠したプロクシはキャッシュを全く行なわなくなります。
Header set Vary *
| 説明: | How the outgoing ETag header should be modified during compression |
|---|---|
| 構文: | DeflateAlterETag AddSuffix|NoChange|Remove |
| デフォルト: | DeflateAlterETag AddSuffix |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_deflate |
| 互換性: | Available in Apache 2.4.58 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | zlib が一度に圧縮する塊の大きさ |
|---|---|
| 構文: | DeflateBufferSize value |
| デフォルト: | DeflateBufferSize 8096 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_deflate |
DeflateBufferSize ディレクティブは
zlib が一度に圧縮する塊の大きさをバイト単位で指定します。
| 説明: | 出力に対して行なう圧縮の程度 |
|---|---|
| 構文: | DeflateCompressionLevel value |
| デフォルト: | Zlib のデフォルト |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_deflate |
| 互換性: | This directive is available since Apache 2.0.45 |
DeflateCompressionLevel ディレクティブは
圧縮の程度を設定します。大きな値では、より圧縮が行なわれますが、
CPU 資源を消費します。
値は 1 (低圧縮) から 9 (高圧縮) です。
| 説明: | ロギング用に圧縮比をメモに追加 |
|---|---|
| 構文: | DeflateFilterNote [type] notename |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_deflate |
| 互換性: | type is available since Apache 2.0.45 |
DeflateFilterNote ディレクティブは
圧縮比に関するメモがリクエストに付加されることを指定します。
メモ (note) の名前はディレクティブに指定された値です。
メモはアクセスログに
値を記録し、統計を取る目的にも使えます。
DeflateFilterNote ratio
LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate
CustomLog logs/deflate_log deflate
ログからもっと精密な値を抽出したい場合は、type 引数を使用して、データタイプをログのメモとして残すように指定できます。 type は次のうちの一つです。
InputOutputRatio出力 / 入力 * 100) をメモに保存する。
type 引数を省略した場合は、これがデフォルトとなります。まとめると、次のようにログを取ることになるでしょう。
DeflateFilterNote Input instream
DeflateFilterNote Output outstream
DeflateFilterNote Ratio ratio
LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
CustomLog logs/deflate_log deflate
| 説明: | Maximum size of inflated request bodies |
|---|---|
| 構文: | DeflateInflateLimitRequestBody value |
| デフォルト: | None, but LimitRequestBody applies after deflation |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Extension |
| モジュール: | mod_deflate |
| 互換性: | 2.4.10 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Maximum number of times the inflation ratio for request bodies can be crossed |
|---|---|
| 構文: | DeflateInflateRatioBurst value |
| デフォルト: | DeflateInflateRatioBurst 3 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Extension |
| モジュール: | mod_deflate |
| 互換性: | 2.4.10 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Maximum inflation ratio for request bodies |
|---|---|
| 構文: | DeflateInflateRatioLimit value |
| デフォルト: | DeflateInflateRatioLimit 200 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Extension |
| モジュール: | mod_deflate |
| 互換性: | 2.4.10 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | zlib が圧縮に使うメモリのレベルを指定 |
|---|---|
| 構文: | DeflateMemLevel value |
| デフォルト: | DeflateMemLevel 9 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_deflate |
DeflateMemLevel ディレクティブは
zlib が圧縮に使うメモリのレベルを設定します (1 から 9 の間の値)。
(訳注: 2 を底とする対数の値になります。
8 程度が良いでしょう。)
| 説明: | Zlib の圧縮用ウィンドウの大きさ |
|---|---|
| 構文: | DeflateWindowSize value |
| デフォルト: | DeflateWindowSize 15 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_deflate |
DeflateWindowSize ディレクティブは
zlib の圧縮用ウィンドウ (訳注: zlib で使用される履歴バッファ)
の大きさを指定します (1 から 15 の間の値)。
一般的に大きなウィンドウサイズを使用すると圧縮率が向上します。
(訳注: 2 を底とする対数の値になります。
8 から 15 にするのが良いでしょう。)
Apache HTTP Server Version 2.4
| : | " " ̷ ϰ 丮 index Ѵ |
|---|---|
| : | Base |
| : | dir_module |
| ҽ: | mod_dir.c |
丮 index Ѱ ȴ:
index.html̶
. DirectoryIndex
þ ̸ Ѵ. mod_dir
þ Ѵ.mod_autoindex
Ѵ.Ѵٸ ڵ index (Ȥ ü) ִ.
dirname 丮 URL
http://servername/foo/dirname û
" " ̷ . 丮
ʿϴ. mod_dir
http://servername/foo/dirname/ ̷
.
| : | Toggle how this module responds when another handler is configured |
|---|---|
| : | DirectoryCheckHandler On|Off |
| ⺻: | DirectoryCheckHandler Off |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_dir |
| : | Available in 2.4.8 and later. Releases prior to 2.4 implicitly act as if "DirectoryCheckHandler ON" was specified. |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | Ŭ̾Ʈ 丮 ûҶ ãƺ ڿ |
|---|---|
| : | DirectoryIndex
local-url [local-url] ... |
| ⺻: | DirectoryIndex index.html |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_dir |
DirectoryIndex þ Ŭ̾Ʈ
丮 / ٿ 丮 index ûҶ ãƺ
ڿ Ѵ. Local-url û 丮
(% ڵ) URL̴. 丮
ִ ϸ̴. URL ְ,
ù° ã . ڿ ã
Indexes ɼ Ͽٸ 丮
.
DirectoryIndex index.html
http://myserver/docs/ ûҶ
http://myserver/docs/index.html ̸
, ٸ 丮 .
ݵ 丮 ʿ .
DirectoryIndex index.html index.txt /cgi-bin/index.pl
丮 index.html̳
index.txt CGI ũƮ
/cgi-bin/index.pl Ѵ.
| : | Configures an external redirect for directory indexes. |
|---|---|
| : | DirectoryIndexRedirect on | off | permanent | temp | seeother |
3xx-code
|
| ⺻: | DirectoryIndexRedirect off |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_dir |
| : | Available in version 2.3.14 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | ̷ Ű |
|---|---|
| : | DirectorySlash On|Off |
| ⺻: | DirectorySlash On |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_dir |
| : | ġ 2.0.51 ĺ |
DirectorySlash þ
mod_dir 丮 Ű URL
θ Ѵ.
ڰ 丮 شϴ ڿ
ûϸ, mod_dir
ڸ ڿ
̷Ѵ.
mod_autoindex ùٷ Ѵ.
ٸ ũ ߸ θ ȴ.DirectoryIndex
ִ 丮 û óѴ. ʰ ſ ˸ ʴٸ ̷ ִ.
# Ʒ !
<Location /some/path>
DirectorySlash Off
SetHandler some-handler
</Location>
̷ ִ.
(Options +Indexes) mod_autoindex
ϰ DirectoryIndex
(index.html ) ȿ ڿ Ͽ
ش URL ٸ Ư ڵ鷯 Ȳ غ.
ִ û index.html
ش. û
丮 ش.
Apache HTTP サーバ バージョン 2.4
| 説明: | プロトコルモジュールの概要を示すための単純なエコーサーバ |
|---|---|
| ステータス: | Experimental |
| モジュール識別子: | echo_module |
| ソースファイル: | mod_echo.c |
本モジュールはコンセプトを伝えるためのプロトコルモジュールの 実装例となっています。単純なエコーサーバを提供します。 Telnet で接続し、文字列を送信すると、エコーを返します。
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Bölü çizgisiyle biten yönlendirmeleri yapar ve dizin içeriği dosyalarını sunar. |
|---|---|
| Durum: | Temel |
| Modül Betimleyici: | dir_module |
| Kaynak Dosyası: | mod_dir.c |
Bir dizin içerik dosyası şu iki kaynaktan birinden gelebilir:
index.html olan bir dosya. Dosya ismi DirectoryIndex yönergesi ile belirlenir.
Bu, mod_dir modülü tarafından denetlenir.mod_autoindex modülü tarafından sağlanır.Bu iki işlev tamamen birbirinden ayrıdır, dolayısıyla eğer isterseniz kendiliğinden dizin içerik listesi üretimini tamamen iptal edebilirsiniz.
Sunucu http://example.com/filanca/birdizin şeklinde bir
istek aldığında birdizin bir dizinin ismiyse ‘bölü
çizgisiyle biten’ bir yönlendirme söz konusudur. Dizinler URL sonuna bir
bölü çizgisi eklenmesini gerektirir, bu bakımdan mod_dir
modülü isteği http://example.com/filanca/birdizin/ şeklinde
yönlendirir.
| Açıklama: | Başka bir eylemci yapılandırılmışsa bu modülün nasıl yanıt vereceğini belirler |
|---|---|
| Sözdizimi: | DirectoryCheckHandler On|Off |
| Öntanımlı: | DirectoryCheckHandler Off |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_dir |
| Uyumluluk: | 2.4.8 ve sonrasında kullanılabilmektedir. 2.4 öncesi sürümler örtük olarak "DirectoryCheckHandler ON" belirtilmiş gibi davranır. |
DirectoryCheckHandler yönergesi, geçerli URL için
başka bir eylemcinin yapılandırılmış olması durumunda,
mod_dir modülünün index dosyaları için dizine mi
bakacağını yoksa URL'nin sonuna bölü çizgisi mi ekleyeceğini belirler.
Eylemciler SetHandler gibi
yönergelerle atanabileceği gibi dizin işlemleri sırasında
mod_rewrite gibi modüller tarafından da atanabilir.
2.4 öncesi sürümlerde, bir URL için başka bir eylemcinin yapılandılmış
olması durumunda bu modül herhangi bir eylemde bulunmaz ve sonuç olarak,
tüm dizin için bir SetHandler belirtildiği durumda
index dosyalarının sunulmasının yanında mod_rewrite
gibi modüller de ayrıca bazı çelişkili sonuçlar oluşturabilir.
| Açıklama: | İstemci bir dizin istediğinde dizin içeriğini listeler. |
|---|---|
| Sözdizimi: | DirectoryIndex
disabled | yerel-url [yerel-url] ... |
| Öntanımlı: | DirectoryIndex index.html |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_dir |
DirectoryIndex yönergesi, istemci, dizinin
sonuna bir bölü çizgisi ekleyerek dizin içeriğinin listelenmesini
istediğinde bakılmak üzere özkaynakları listeler.
yerel-url, sunucu üstünde istenen dizine göreli
bir belgenin URL’sidir; normal olarak dizin içindeki bir dosyanın
ismidir. Çeşitli URL’ler verilebilirse de sunucu daima ilk bulduğuyla
dönecektir. Eğer özkaynakların hiçbiri yoksa ve Indexes
seçeneği atanmışsa sunucu dizin içeriğinden bir liste üretecektir.
DirectoryIndex index.html
Bu yapılandırmadan sonra yapılan bir
http://sunucum/belgeler/ isteğine karşılık, sunucu,
mevcutsa http://sunucum/belgeler/index.html dosyasını
döndürecek, değilse ürettiği dizin içerik listesini gönderecektir.
Belgelerin dizine göreli olmasının gerekmediğine dikkat ediniz.
DirectoryIndex index.html index.txt /cgi-bin/index.pl
Bu örnekte ise dizin içinde ne index.html ne de
index.txt mevcut olduğunda /cgi-bin/index.pl
CGI betiği çalıştırılacaktır.
disabled değeri tek başına mod_dir’in bir
dizin listesi aramasını engeller. disabled değiştirgesi
öncesinde ve sonrasında başka bir değiştirge hatta bir
disabled daha olsa bile sadece bir disabled
verilmiş gibi yorumlanır.
Bilginize: Aynı
bağlamdaki çok sayıda DirectoryIndex
yönergesi bir öncekini değiştirmek yerine onun bulunduğu listeye
eklenir:
# 1. örnek: İçerik dosyası olarak index.html atayıp sonraki satırda buna
# index.php'yi ekleyebilirsiniz.
<Directory "/foo">
DirectoryIndex index.html
DirectoryIndex index.php
</Directory>
# 2. Örnek: Atamaların tet bir satırda yapıldığı bu örnek 1. örneğe denktir.
<Directory "/foo">
DirectoryIndex index.html index.php
</Directory>
# 3. Örnek: Listeyi tamamen değiştirmek için, listeyi önce sıfırlamalısınız:
# Bu örnekte içerik dosyası olarak listede sadece index.php kalır.
<Directory "/foo">
DirectoryIndex index.html
DirectoryIndex disabled
DirectoryIndex index.php
</Directory>
| Açıklama: | Dizin içerik listeleri için harici bir yönlendirme yapılandırır. |
|---|---|
| Sözdizimi: | DirectoryIndexRedirect on | off | permanent | temp | seeother |
3xx-kodu
|
| Öntanımlı: | DirectoryIndexRedirect off |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_dir |
| Uyumluluk: | Apache HTTP Sunucusunun 2.3.14 ve sonraki sürümlerinde kullanılabilmektedir. |
Öntanımlı olarak, DirectoryIndex listeyi
istemciye şeffaf olarak seçip gönderir.
DirectoryIndexRedirect ise harici bir
yönlendirmeye sebep olur.
Bunlardan biri kullanılabilir:
on: Dizin listesi kaynağına bir 302 yönlendirmesi
yapılır.off: Bir yönlendirme yapılmaz. mod_dir için eski davranış
böyleydi.permanent: Dizin listesi kaynağına bir 301 (kalıcı)
yönlendirmesi yapılır.temp: Bu on ile aynı etkiye sahiptir.seeother: Dizin listesi kaynağına bir 303 yönlendirmesi
("diğerine bak" olarak da bilinir)yapılır.DirectoryIndexRedirect on
http://example.com/docs/ için yapılan bir istek, http://example.com/docs/index.html (mevcutsa) adresine geçici bir
yönlendirme döndürür.
| Açıklama: | Bölü çizgisi ile biten yönlendirmeleri açar/kapar. |
|---|---|
| Sözdizimi: | DirectorySlash On|Off |
| Öntanımlı: | DirectorySlash On |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_dir |
DirectorySlash yönergesi, bir dizin isteğinde
bulunan URL’lerin sonuna mod_dir modülü tarafından bir
bölü çizgisi eklenip eklenmeyeceğini belirler.
Normalde, bir kullanıcı sona bir bölü çizgisi eklemeden bir dizin için
istekte bulunursa mod_dir zaten onu aynı özkaynağa
yönlendirir, fakat isteğin sonuna bir bölü çizgisi eklenmesinin bazı iyi
sebepleri vardır:
mod_autoindex gerektiği gibi çalışır. Yoksa
bağlantıdaki yolu sunamayacağından yanlış yolu gösterirdi.DirectoryIndex yönergesi
sadece bölü çizgisi ile biten dizin istekleri için değerlendirilir.Siz yine de bu etkiyi istemezseniz ve yukarıdaki sebepler de size uygun değilse yönlendirmeyi aşağıdaki gibi kapatabilirsiniz. Ancak bunu yaparken dikkatli olun, bununla ilgili bazı güvenlik sorunları olasılığı vardır.
# Aşağıdaki güvenlik uyarısına bakınız!
<Location "/bir/yol">
DirectorySlash Off
SetHandler bir-eylemci
</Location>
Bölü çizgisi ile biten yönlendirmelerin kapatılması bir bilginin
istemeyek açığa çıkmasına sebep olabilir. mod_autoindex
modülünün etkin olduğunu (Options +Indexes) ve DirectoryIndex ile geçerli bir özkaynağın
(index.html olsun) atandığını ama bu URL için başka hiçbir
özel eylemci tanımlanmadığını varsayalım. Bu durumda bölü çizgisi ile
biten bir istek olduğunda index.html dosyası sunulurdu.
Fakat bölü çizgisi ile bitmeyen bir istek dizin içeriğinin
listelenmesi ile sonuçlanırdı.
Bir yönlendirme sözkonusu olduğunda bazı tarayıcıların yanlışlıkla POST isteklerini GET istekleri haline getirme (böylece POST verisi iptal olur) olasılığı olduğuna da dikkat edin.
| Açıklama: | Bir dosya ile eşleşmeyen istekler için öntanımlı URL tanımlar |
|---|---|
| Sözdizimi: | FallbackResource disabled | yerel-url |
| Öntanımlı: | disabled - httpd 404 döndürecektir (Yok) |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | Indexes |
| Durum: | Temel |
| Modül: | mod_dir |
| Uyumluluk: | disabled değiştirgesi 2.4.4 sürümü ve sonrasında kullanılabilmektedir. |
Dosya sisteminde bulunmayan bir dosya için istek yapıldığında HTTP'nin 404 (Yok) hatasını döndürmemesi için sunulacak dosyanın yolunu tanımlar. Örnek:
FallbackResource /not-404.php
Bu satırla, (mevcut dosyaları etkilemeden) mevcut olmayan dosyaların
yerine not-404.php dosyası sunulacaktır.
Belli bir dizindeki mevcut bir dosya veya betik için yapılanlar dışındaki tüm isteklerin tek bir dosya veya özkaynakla yerine getirilmesi sıkça istenen bir durum olup bu mekanizmaya 'ön denetleyici' adı verilir.
httpd'nin önceki sürümlerinde bir dosya veya dizinin varlığının sınanması
için genellikle mod_rewrite modülü ve -f ve
-d kullanımı gerekirdi. Bunun için şimdi tek satırlık bir
yapılandırma yeterli olmaktadır.
FallbackResource /index.php
Resim, CSS dosyaları gibi mevcut dosyalar normal olarak sunulur.
Üst dizinden hiçbir şeyin miras alınmaması isteniyorsa bu özelliği
kapatmak için disabled değiştirgesini kullanın.
http://example.com/blog/ gibi bir alt URI yerel-url olarak sağlanır:
<Directory "/web/example.com/htdocs/blog"> FallbackResource /blog/index.php </Directory> <Directory "/web/example.com/htdocs/blog/images"> FallbackResource disabled </Directory>
Bir acil durum işleyicisi (yukarıdaki durumda,
/blog/index.php) özgün istek URL'sine sunucu değişkeni
REQUEST_URI üzerinden erişebilir. Örneğin PHP'de bu
değişkene erişmek için $_SERVER['REQUEST_URI']
kullanılır.
Apache HTTP Server Version 2.4
| : | ϱ echo |
|---|---|
| : | Experimental |
| : | echo_module |
| ҽ: | mod_echo.c |
| : | Apache 2.0 ĺ |
ϱ ̴. echo Ѵ. telnetϿ 𰡸 Էϸ, Է ״ ȯѴ.
Apache HTTP Server Version 2.4
The directive quick reference shows the usage, default, status, and context of each Apache configuration directive. For more information about each of these, see the Directive Dictionary.
The first column gives the directive name and usage. The second column shows the default value of the directive, if a default exists. If the default is too large to display, it will be truncated and followed by "+".
The third and fourth columns list the contexts where the directive is allowed and the status of the directive according to the legend tables below.
| A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X |
|
|
| AcceptFilter protocol accept_filter | s | C | |
| Configures optimizations for a Protocol's Listener Sockets | |||
| AcceptPathInfo On|Off|Default | Default | svdh | C |
| Resources accept trailing pathname information | |||
| AccessFileName filename [filename] ... | .htaccess | sv | C |
| Name of the distributed configuration file | |||
| Action action-type cgi-script [virtual] | svdh | B | |
| Activates a CGI script for a particular handler or content-type | |||
| AddAlt string file [file] ... | svdh | B | |
| Alternate text to display for a file, instead of an icon selected by filename | |||
| AddAltByEncoding string MIME-encoding [MIME-encoding] ... | svdh | B | |
| Alternate text to display for a file instead of an icon selected by MIME-encoding | |||
| AddAltByType string MIME-type [MIME-type] ... | svdh | B | |
| Alternate text to display for a file, instead of an icon selected by MIME content-type | |||
| AddCharset charset extension [extension] ... | svdh | B | |
| Maps the given filename extensions to the specified content charset | |||
| AddDefaultCharset On|Off|charset | Off | svdh | C |
Default charset parameter to be added when a response
content-type is text/plain or text/html | |||
| AddDescription string file [file] ... | svdh | B | |
| Description to display for a file | |||
| AddEncoding encoding extension [extension] ... | svdh | B | |
| Maps the given filename extensions to the specified encoding type | |||
| AddHandler handler-name extension [extension] ... | svdh | B | |
| Maps the filename extensions to the specified handler | |||
| AddIcon icon name [name] ... | svdh | B | |
| Icon to display for a file selected by name | |||
| AddIconByEncoding icon MIME-encoding [MIME-encoding] ... | svdh | B | |
| Icon to display next to files selected by MIME content-encoding | |||
| AddIconByType icon MIME-type [MIME-type] ... | svdh | B | |
| Icon to display next to files selected by MIME content-type | |||
| AddInputFilter filter[;filter...] extension [extension] ... | svdh | B | |
| Maps filename extensions to the filters that will process client requests | |||
| AddLanguage language-tag extension [extension] ... | svdh | B | |
| Maps the given filename extension to the specified content language | |||
| AddModuleInfo module-name string | sv | E | |
| Adds additional information to the module information displayed by the server-info handler | |||
| AddOutputFilter filter[;filter...] extension [extension] ... | svdh | B | |
| Maps filename extensions to the filters that will process responses from the server | |||
| AddOutputFilterByType filter[;filter...] media-type [media-type] ... | svdh | B | |
| assigns an output filter to a particular media-type | |||
| AddType media-type extension [extension] ... | svdh | B | |
| Maps the given filename extensions onto the specified content type | |||
| Alias [URL-path] file-path|directory-path | svd | B | |
| Maps URLs to filesystem locations | |||
| AliasMatch regex file-path|directory-path | sv | B | |
| Maps URLs to filesystem locations using regular expressions | |||
| AliasPreservePath OFF|ON | OFF | svd | B |
| Map the full path after the alias in a location. | |||
| Allow from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts can access an area of the server | |||
| AllowCONNECT port[-port] [port[-port]] ... | 443 563 | sv | E |
Ports that are allowed to CONNECT through the
proxy | |||
| AllowEncodedSlashes On|Off|NoDecode | Off | sv | C |
| Determines whether encoded path separators in URLs are allowed to be passed through | |||
| AllowMethods reset|HTTP-method [HTTP-method]... | reset | d | X |
| Restrict access to the listed HTTP methods | |||
| AllowOverride All|None|directive-type [directive-type] ... | None (2.3.9 and lat + | d | C |
Types of directives that are allowed in
.htaccess files | |||
| AllowOverrideList None|directive [directive-type] ... | None | d | C |
Individual directives that are allowed in
.htaccess files | |||
| Anonymous user [user] ... | dh | E | |
| Specifies userIDs that are allowed access without password verification | |||
| Anonymous_LogEmail On|Off | On | dh | E |
| Sets whether the password entered will be logged in the error log | |||
| Anonymous_MustGiveEmail On|Off | On | dh | E |
| Specifies whether blank passwords are allowed | |||
| Anonymous_NoUserID On|Off | Off | dh | E |
| Sets whether the userID field may be empty | |||
| Anonymous_VerifyEmail On|Off | Off | dh | E |
| Sets whether to check the password field for a correctly formatted email address | |||
| AsyncRequestWorkerFactor factor | s | M | |
| Limit concurrent connections per process | |||
| AuthBasicAuthoritative On|Off | On | dh | B |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthBasicFake off|username [password] | dh | B | |
| Fake basic authentication using the given expressions for username and password | |||
| AuthBasicProvider provider-name [provider-name] ... | file | dh | B |
| Sets the authentication provider(s) for this location | |||
| AuthBasicUseDigestAlgorithm MD5|Off | Off | dh | B |
| Check passwords against the authentication providers as if Digest Authentication was in force instead of Basic Authentication. | |||
| AuthDBDUserPWQuery query | d | E | |
| SQL query to look up a password for a user | |||
| AuthDBDUserRealmQuery query | d | E | |
| SQL query to look up a password hash for a user and realm. | |||
| AuthDBMGroupFile file-path | dh | E | |
| Sets the name of the database file containing the list of user groups for authorization | |||
| AuthDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Sets the type of database file that is used to store passwords | |||
| AuthDBMUserFile file-path | dh | E | |
| Sets the name of a database file containing the list of users and passwords for authentication | |||
| AuthDigestAlgorithm MD5|MD5-sess | MD5 | dh | E |
| Selects the algorithm used to calculate the challenge and response hashes in digest authentication | |||
| AuthDigestDomain URI [URI] ... | dh | E | |
| URIs that are in the same protection space for digest authentication | |||
| AuthDigestNonceLifetime seconds | 300 | dh | E |
| How long the server nonce is valid | |||
| AuthDigestProvider provider-name [provider-name] ... | file | dh | E |
| Sets the authentication provider(s) for this location | |||
| AuthDigestQop none|auth|auth-int [auth|auth-int] | auth | dh | E |
| Determines the quality-of-protection to use in digest authentication | |||
| AuthDigestShmemSize size | 1000 | s | E |
| The amount of shared memory to allocate for keeping track of clients | |||
| AuthFormAuthoritative On|Off | On | dh | B |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthFormBody fieldname | httpd_body | d | B |
| The name of a form field carrying the body of the request to attempt on successful login | |||
| AuthFormDisableNoStore On|Off | Off | d | B |
| Disable the CacheControl no-store header on the login page | |||
| AuthFormFakeBasicAuth On|Off | Off | d | B |
| Fake a Basic Authentication header | |||
| AuthFormLocation fieldname | httpd_location | d | B |
| The name of a form field carrying a URL to redirect to on successful login | |||
| AuthFormLoginRequiredLocation url | d | B | |
| The URL of the page to be redirected to should login be required | |||
| AuthFormLoginSuccessLocation url | d | B | |
| The URL of the page to be redirected to should login be successful | |||
| AuthFormLogoutLocation uri | d | B | |
| The URL to redirect to after a user has logged out | |||
| AuthFormMethod fieldname | httpd_method | d | B |
| The name of a form field carrying the method of the request to attempt on successful login | |||
| AuthFormMimetype fieldname | httpd_mimetype | d | B |
| The name of a form field carrying the mimetype of the body of the request to attempt on successful login | |||
| AuthFormPassword fieldname | httpd_password | d | B |
| The name of a form field carrying the login password | |||
| AuthFormProvider provider-name [provider-name] ... | file | dh | B |
| Sets the authentication provider(s) for this location | |||
| AuthFormSitePassphrase secret | d | B | |
| Bypass authentication checks for high traffic sites | |||
| AuthFormSize size | 8192 | d | B |
| The largest size of the form in bytes that will be parsed for the login details | |||
| AuthFormUsername fieldname | httpd_username | d | B |
| The name of a form field carrying the login username | |||
| AuthGroupFile file-path | dh | B | |
| Sets the name of a text file containing the list of user groups for authorization | |||
| AuthLDAPAuthorizePrefix prefix | AUTHORIZE_ | dh | E |
| Specifies the prefix for environment variables set during authorization | |||
| AuthLDAPBindAuthoritative off|on | on | dh | E |
| Determines if other authentication providers are used when a user can be mapped to a DN but the server cannot successfully bind with the user's credentials. | |||
| AuthLDAPBindDN distinguished-name | dh | E | |
| Optional DN to use in binding to the LDAP server | |||
| AuthLDAPBindPassword password | dh | E | |
| Password used in conjunction with the bind DN | |||
| AuthLDAPCharsetConfig file-path | s | E | |
| Language to charset conversion configuration file | |||
| AuthLDAPCompareAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization comparisons | |||
| AuthLDAPCompareDNOnServer on|off | on | dh | E |
| Use the LDAP server to compare the DNs | |||
| AuthLDAPDereferenceAliases never|searching|finding|always | always | dh | E |
| When will the module de-reference aliases | |||
| AuthLDAPGroupAttribute attribute | member uniqueMember + | dh | E |
| LDAP attributes used to identify the user members of groups. | |||
| AuthLDAPGroupAttributeIsDN on|off | on | dh | E |
| Use the DN of the client username when checking for group membership | |||
| AuthLDAPInitialBindAsUser off|on | off | dh | E |
| Determines if the server does the initial DN lookup using the basic authentication users' own username, instead of anonymously or with hard-coded credentials for the server | |||
| AuthLDAPInitialBindPattern regex substitution | (.*) $1 (remote use + | dh | E |
| Specifies the transformation of the basic authentication username to be used when binding to the LDAP server to perform a DN lookup | |||
| AuthLDAPMaxSubGroupDepth Number | 10 | dh | E |
| Specifies the maximum sub-group nesting depth that will be evaluated before the user search is discontinued. | |||
| AuthLDAPRemoteUserAttribute uid | dh | E | |
| Use the value of the attribute returned during the user query to set the REMOTE_USER environment variable | |||
| AuthLDAPRemoteUserIsDN on|off | off | dh | E |
| Use the DN of the client username to set the REMOTE_USER environment variable | |||
| AuthLDAPSearchAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization searches | |||
| AuthLDAPSubGroupAttribute attribute | member uniqueMember + | dh | E |
| Specifies the attribute labels, one value per directive line, used to distinguish the members of the current group that are groups. | |||
| AuthLDAPSubGroupClass LdapObjectClass | groupOfNames groupO + | dh | E |
| Specifies which LDAP objectClass values identify directory objects that are groups during sub-group processing. | |||
| AuthLDAPURL url [NONE|SSL|TLS|STARTTLS] | dh | E | |
| URL specifying the LDAP search parameters | |||
| AuthMerging Off | And | Or | Off | dh | B |
| Controls the manner in which each configuration section's authorization logic is combined with that of preceding configuration sections. | |||
| AuthName auth-domain | dh | B | |
| Authorization realm for use in HTTP authentication | |||
| AuthnCacheContext directory|server|custom-string | directory | d | B |
| Specify a context string for use in the cache key | |||
| AuthnCacheEnable | s | B | |
| Enable Authn caching configured anywhere | |||
| AuthnCacheProvideFor authn-provider [...] | dh | B | |
| Specify which authn provider(s) to cache for | |||
| AuthnCacheSOCache provider-name[:provider-args] | s | B | |
| Select socache backend provider to use | |||
| AuthnCacheTimeout timeout (seconds) | 300 (5 minutes) | dh | B |
| Set a timeout for cache entries | |||
| <AuthnProviderAlias baseProvider Alias> ... </AuthnProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authentication provider and referenced by the specified alias | |||
AuthnzFcgiCheckAuthnProvider provider-name|None
option ... | d | E | |
| Enables a FastCGI application to handle the check_authn authentication hook. | |||
| AuthnzFcgiDefineProvider type provider-name backend-address | s | E | |
| Defines a FastCGI application as a provider for authentication and/or authorization | |||
| AuthType None|Basic|Digest|Form | dh | B | |
| Type of user authentication | |||
| AuthUserFile file-path | dh | B | |
| Sets the name of a text file containing the list of users and passwords for authentication | |||
| AuthzDBDLoginToReferer On|Off | Off | d | E |
Determines whether to redirect the Client to the Referring
page on successful login or logout if a Referer request
header is present | |||
| AuthzDBDQuery query | d | E | |
| Specify the SQL Query for the required operation | |||
| AuthzDBDRedirectQuery query | d | E | |
| Specify a query to look up a login page for the user | |||
| AuthzDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Sets the type of database file that is used to store list of user groups | |||
| <AuthzProviderAlias baseProvider Alias Require-Parameters> ... </AuthzProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authorization provider and referenced by the specified alias | |||
| AuthzSendForbiddenOnFailure On|Off | Off | dh | B |
| Send '403 FORBIDDEN' instead of '401 UNAUTHORIZED' if authentication succeeds but authorization fails | |||
| BalancerGrowth # | 5 | sv | E |
| Number of additional Balancers that can be added Post-configuration | |||
| BalancerInherit On|Off | On | sv | E |
| Inherit ProxyPassed Balancers/Workers from the main server | |||
| BalancerMember [balancerurl] url [key=value [key=value ...]] | d | E | |
| Add a member to a load balancing group | |||
| BalancerPersist On|Off | Off | sv | E |
| Attempt to persist changes made by the Balancer Manager across restarts. | |||
| BrotliAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| BrotliCompressionMaxInputBlock value | sv | E | |
| Maximum input block size | |||
| BrotliCompressionQuality value | 5 | sv | E |
| Compression quality | |||
| BrotliCompressionWindow value | 18 | sv | E |
| Brotli sliding compression window size | |||
| BrotliFilterNote [type] notename | sv | E | |
| Places the compression ratio in a note for logging | |||
| BrowserMatch regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables conditional on HTTP User-Agent | |||
| BrowserMatchNoCase regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables conditional on User-Agent without respect to case | |||
| BufferedLogs On|Off | Off | s | B |
| Buffer log entries in memory before writing to disk | |||
| BufferSize integer | 131072 | svdh | E |
| Maximum size in bytes to buffer by the buffer filter | |||
| CacheDefaultExpire seconds | 3600 (one hour) | svdh | E |
| The default duration to cache a document when no expiry date is specified. | |||
| CacheDetailHeader on|off | off | svdh | E |
| Add an X-Cache-Detail header to the response. | |||
| CacheDirLength length | 2 | sv | E |
| The number of characters in subdirectory names | |||
| CacheDirLevels levels | 2 | sv | E |
| The number of levels of subdirectories in the cache. | |||
| CacheDisable url-string | on | svdh | E | |
| Disable caching of specified URLs | |||
| CacheEnable cache_type [url-string] | svd | E | |
| Enable caching of specified URLs using a specified storage manager | |||
| CacheFile file-path [file-path] ... | s | X | |
| Cache a list of file handles at startup time | |||
| CacheHeader on|off | off | svdh | E |
| Add an X-Cache header to the response. | |||
| CacheIgnoreCacheControl On|Off | Off | sv | E |
| Ignore request to not serve cached content to client | |||
| CacheIgnoreHeaders header-string [header-string] ... | None | sv | E |
| Do not store the given HTTP header(s) in the cache. | |||
| CacheIgnoreNoLastMod On|Off | Off | svdh | E |
| Ignore the fact that a response has no Last Modified header. | |||
| CacheIgnoreQueryString On|Off | Off | sv | E |
| Ignore query string when caching | |||
| CacheIgnoreURLSessionIdentifiers identifier [identifier] ... | None | sv | E |
| Ignore defined session identifiers encoded in the URL when caching | |||
| CacheKeyBaseURL URL | sv | E | |
| Override the base URL of reverse proxied cache keys. | |||
| CacheLastModifiedFactor float | 0.1 | svdh | E |
| The factor used to compute an expiry date based on the LastModified date. | |||
| CacheLock on|off | off | sv | E |
| Enable the thundering herd lock. | |||
| CacheLockMaxAge integer | 5 | sv | E |
| Set the maximum possible age of a cache lock. | |||
| CacheLockPath directory | /tmp/mod_cache-lock + | sv | E |
| Set the lock path directory. | |||
| CacheMaxExpire seconds | 86400 (one day) | svdh | E |
| The maximum time in seconds to cache a document | |||
| CacheMaxFileSize bytes | 1000000 | svdh | E |
| The maximum size (in bytes) of a document to be placed in the cache | |||
| CacheMinExpire seconds | 0 | svdh | E |
| The minimum time in seconds to cache a document | |||
| CacheMinFileSize bytes | 1 | svdh | E |
| The minimum size (in bytes) of a document to be placed in the cache | |||
| CacheNegotiatedDocs On|Off | Off | sv | B |
| Allows content-negotiated documents to be cached by proxy servers | |||
| CacheQuickHandler on|off | on | sv | E |
| Run the cache from the quick handler. | |||
| CacheReadSize bytes | 0 | svdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheReadTime milliseconds | 0 | svdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheRoot directory | sv | E | |
| The directory root under which cache files are stored | |||
| CacheSocache type[:args] | sv | E | |
| The shared object cache implementation to use | |||
| CacheSocacheMaxSize bytes | 102400 | svdh | E |
| The maximum size (in bytes) of an entry to be placed in the cache | |||
| CacheSocacheMaxTime seconds | 86400 | svdh | E |
| The maximum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheMinTime seconds | 600 | svdh | E |
| The minimum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheReadSize bytes | 0 | svdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheSocacheReadTime milliseconds | 0 | svdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheStaleOnError on|off | on | svdh | E |
| Serve stale content in place of 5xx responses. | |||
| CacheStoreExpired On|Off | Off | svdh | E |
| Attempt to cache responses that the server reports as expired | |||
| CacheStoreNoStore On|Off | Off | svdh | E |
| Attempt to cache requests or responses that have been marked as no-store. | |||
| CacheStorePrivate On|Off | Off | svdh | E |
| Attempt to cache responses that the server has marked as private | |||
| CGIDScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIMapExtension cgi-path .extension | dh | C | |
| Technique for locating the interpreter for CGI scripts | |||
| CGIPassAuth On|Off | Off | dh | C |
| Enables passing HTTP authorization headers to scripts as CGI variables | |||
| CGIScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIVar variable rule | dh | C | |
| Controls how some CGI variables are set | |||
| CharsetDefault charset | svdh | E | |
| Charset to translate into | |||
| CharsetOptions option [option] ... | ImplicitAdd | svdh | E |
| Configures charset translation behavior | |||
| CharsetSourceEnc charset | svdh | E | |
| Source charset of files | |||
| CheckBasenameMatch on|off | On | svdh | E |
| Also match files with differing file name extensions. | |||
| CheckCaseOnly on|off | Off | svdh | E |
| Limits the action of the speling module to case corrections | |||
| CheckSpelling on|off | Off | svdh | E |
| Enables the spelling module | |||
| ChrootDir /path/to/directory | s | B | |
| Directory for apache to run chroot(8) after startup. | |||
| ContentDigest On|Off | Off | svdh | C |
Enables the generation of Content-MD5 HTTP Response
headers | |||
| CookieDomain domain | svdh | E | |
| The domain to which the tracking cookie applies | |||
| CookieExpires expiry-period | svdh | E | |
| Expiry time for the tracking cookie | |||
| CookieHTTPOnly on|off | off | svdh | E |
| Adds the 'HTTPOnly' attribute to the cookie | |||
| CookieName token | Apache | svdh | E |
| Name of the tracking cookie | |||
| CookieSameSite None|Lax|Strict | svdh | E | |
| Adds the 'SameSite' attribute to the cookie | |||
| CookieSecure on|off | off | svdh | E |
| Adds the 'Secure' attribute to the cookie | |||
| CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965 | Netscape | svdh | E |
| Format of the cookie header field | |||
| CookieTracking on|off | off | svdh | E |
| Enables tracking cookie | |||
| CoreDumpDirectory directory | s | M | |
| Directory where Apache HTTP Server attempts to switch before dumping core | |||
| CustomLog file|pipe format|nickname [env=[!]environment-variable| expr=expression] | sv | B | |
| Sets filename and format of log file | |||
| Dav On|Off|provider-name | Off | d | E |
| Enable WebDAV HTTP methods | |||
| DavBasePath root-path | d | E | |
| Configure repository root path | |||
| DavDepthInfinity on|off | off | svd | E |
| Allow PROPFIND, Depth: Infinity requests | |||
| DavGenericLockDB file-path | svd | E | |
| Location of the DAV lock database | |||
| DavLockDB file-path | sv | E | |
| Location of the DAV lock database | |||
| DavLockDiscovery on|off | on | svdh | E |
| Enable lock discovery | |||
| DavMinTimeout seconds | 0 | svd | E |
| Minimum amount of time the server holds a lock on a DAV resource | |||
| DBDExptime time-in-seconds | 300 | sv | E |
| Keepalive time for idle connections | |||
| DBDInitSQL "SQL statement" | sv | E | |
| Execute an SQL statement after connecting to a database | |||
| DBDKeep number | 2 | sv | E |
| Maximum sustained number of connections | |||
| DBDMax number | 10 | sv | E |
| Maximum number of connections | |||
| DBDMin number | 1 | sv | E |
| Minimum number of connections | |||
| DBDParams param1=value1[,param2=value2] | sv | E | |
| Parameters for database connection | |||
| DBDPersist On|Off | sv | E | |
| Whether to use persistent connections | |||
| DBDPrepareSQL "SQL statement" label | sv | E | |
| Define an SQL prepared statement | |||
| DBDriver name | sv | E | |
| Specify an SQL driver | |||
| DefaultIcon url-path | svdh | B | |
| Icon to display for files when no specific icon is configured | |||
| DefaultLanguage language-tag | svdh | B | |
| Defines a default language-tag to be sent in the Content-Language header field for all resources in the current context that have not been assigned a language-tag by some other means. | |||
| DefaultRuntimeDir directory-path | DEFAULT_REL_RUNTIME + | s | C |
| Base directory for the server run-time files | |||
| DefaultType media-type|none | none | svdh | C |
This directive has no effect other than to emit warnings
if the value is not none. In prior versions, DefaultType
would specify a default media type to assign to response content for
which no other media type configuration could be found.
| |||
| Define parameter-name [parameter-value] | svd | C | |
| Define a variable | |||
| DeflateAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| DeflateBufferSize value | 8096 | sv | E |
| Fragment size to be compressed at one time by zlib | |||
| DeflateCompressionLevel value | sv | E | |
| How much compression do we apply to the output | |||
| DeflateFilterNote [type] notename | sv | E | |
| Places the compression ratio in a note for logging | |||
| DeflateInflateLimitRequestBody value | svdh | E | |
| Maximum size of inflated request bodies | |||
| DeflateInflateRatioBurst value | 3 | svdh | E |
| Maximum number of times the inflation ratio for request bodies can be crossed | |||
| DeflateInflateRatioLimit value | 200 | svdh | E |
| Maximum inflation ratio for request bodies | |||
| DeflateMemLevel value | 9 | sv | E |
| How much memory should be used by zlib for compression | |||
| DeflateWindowSize value | 15 | sv | E |
| Zlib compression window size | |||
| Deny from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts are denied access to the server | |||
| <Directory directory-path> ... </Directory> | sv | C | |
| Enclose a group of directives that apply only to the named file-system directory, sub-directories, and their contents. | |||
| DirectoryCheckHandler On|Off | Off | svdh | B |
| Toggle how this module responds when another handler is configured | |||
| DirectoryIndex disabled | local-url [local-url] ... | index.html | svdh | B |
| List of resources to look for when the client requests a directory | |||
| DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-code | off | svdh | B |
| Configures an external redirect for directory indexes. | |||
| <DirectoryMatch regex> ... </DirectoryMatch> | sv | C | |
| Enclose directives that apply to the contents of file-system directories matching a regular expression. | |||
| DirectorySlash On|Off | On | svdh | B |
| Toggle trailing slash redirects on or off | |||
| DocumentRoot directory-path | "/usr/local/apache/ + | sv | C |
| Directory that forms the main document tree visible from the web | |||
| DTracePrivileges On|Off | Off | s | X |
| Determines whether the privileges required by dtrace are enabled. | |||
| DumpIOInput On|Off | Off | s | E |
| Dump all input data to the error log | |||
| DumpIOOutput On|Off | Off | s | E |
| Dump all output data to the error log | |||
| <Else> ... </Else> | svdh | C | |
Contains directives that apply only if the condition of a
previous <If> or
<ElseIf> section is not
satisfied by a request at runtime | |||
| <ElseIf expression> ... </ElseIf> | svdh | C | |
Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
<If> or
<ElseIf> section is not
satisfied | |||
| EnableExceptionHook On|Off | Off | s | M |
| Enables a hook that runs exception handlers after a crash | |||
| EnableMMAP On|Off | On | svdh | C |
| Use memory-mapping to read files during delivery | |||
| EnableSendfile On|Off | Off | svdh | C |
| Use the kernel sendfile support to deliver files to the client | |||
| Error message | svdh | C | |
| Abort configuration parsing with a custom error message | |||
| ErrorDocument error-code document | svdh | C | |
| What the server will return to the client in case of an error | |||
| ErrorLog file-path|syslog[:[facility][:tag]] | logs/error_log (Uni + | sv | C |
| Location where the server will log errors | |||
| ErrorLogFormat [connection|request] format | sv | C | |
| Format specification for error log entries | |||
| Example | svdh | X | |
| Demonstration directive to illustrate the Apache module API | |||
| ExpiresActive On|Off | Off | svdh | E |
Enables generation of Expires
headers | |||
| ExpiresByType MIME-type <code>seconds | svdh | E | |
Value of the Expires header configured
by MIME type | |||
| ExpiresDefault <code>seconds | svdh | E | |
| Default algorithm for calculating expiration time | |||
| ExtendedStatus On|Off | Off[*] | s | C |
| Keep track of extended status information for each request | |||
| ExtFilterDefine filtername parameters | s | E | |
| Define an external filter | |||
| ExtFilterOptions option [option] ... | NoLogStderr | d | E |
Configure mod_ext_filter options | |||
| FallbackResource disabled | local-url | svdh | B | |
| Define a default URL for requests that don't map to a file | |||
| FileETag component ... | MTime Size | svdh | C |
| File attributes used to create the ETag HTTP response header for static files | |||
| <Files filename> ... </Files> | svdh | C | |
| Contains directives that apply to matched filenames | |||
| <FilesMatch regex> ... </FilesMatch> | svdh | C | |
| Contains directives that apply to regular-expression matched filenames | |||
| FilterChain [+=-@!]filter-name ... | svdh | B | |
| Configure the filter chain | |||
| FilterDeclare filter-name [type] | svdh | B | |
| Declare a smart filter | |||
| FilterProtocol filter-name [provider-name] proto-flags | svdh | B | |
| Deal with correct HTTP protocol handling | |||
| FilterProvider filter-name provider-name expression | svdh | B | |
| Register a content filter | |||
| FilterTrace filter-name level | svd | B | |
Get debug/diagnostic information from
mod_filter | |||
| FlushMaxPipelined number | 5 | sv | C |
| Maximum number of pipelined responses above which they are flushed to the network | |||
| FlushMaxThreshold number-of-bytes | 65535 | sv | C |
| Threshold above which pending data are flushed to the network | |||
| ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] | Prefer | svdh | B |
| Action to take if a single acceptable document is not found | |||
| ForceType media-type|None | dh | C | |
| Forces all matching files to be served with the specified media type in the HTTP Content-Type header field | |||
| ForensicLog filename|pipe | sv | E | |
| Sets filename of the forensic log | |||
| GlobalLogfile|pipe format|nickname [env=[!]environment-variable| expr=expression] | s | B | |
| Sets filename and format of log file | |||
| GprofDir /tmp/gprof/|/tmp/gprof/% | sv | C | |
| Directory to write gmon.out profiling data to. | |||
| GracefulShutdownTimeout seconds | 0 | s | M |
| Specify a timeout after which a gracefully shutdown server will exit. | |||
| Group unix-group | #-1 | s | B |
| Group under which the server will answer requests | |||
| H2CopyFiles on|off | off | svdh | E |
| Determine file handling in responses | |||
| H2Direct on|off | on for h2c, off for + | sv | E |
| H2 Direct Protocol Switch | |||
| H2EarlyHint name value | svdh | E | |
| Add a response header to be picked up in 103 Early Hints | |||
| H2EarlyHints on|off | off | sv | E |
| Determine sending of 103 status codes | |||
| H2MaxDataFrameLen n | 0 | sv | E |
| Maximum bytes inside a single HTTP/2 DATA frame | |||
| H2MaxHeaderBlockLen n | 0 | sv | E |
| Maximum size of response headers | |||
| H2MaxSessionStreams n | 100 | sv | E |
| Maximum number of active streams per HTTP/2 session. | |||
| H2MaxWorkerIdleSeconds n | 600 | s | E |
| Maximum number of seconds h2 workers remain idle until shut down. | |||
| H2MaxWorkers n | s | E | |
| Maximum number of worker threads to use per child process. | |||
| H2MinWorkers n | s | E | |
| Minimal number of worker threads to use per child process. | |||
| H2ModernTLSOnly on|off | on | sv | E |
| Require HTTP/2 connections to be "modern TLS" only | |||
| H2OutputBuffering on|off | on | sv | E |
| Determine buffering behaviour of output | |||
| H2Padding numbits | 0 | sv | E |
| Determine the range of padding bytes added to payload frames | |||
| H2ProxyRequests on|off | off | sv | E |
| En-/Disable forward proxy requests via HTTP/2 | |||
| H2Push on|off | on | svdh | E |
| H2 Server Push Switch | |||
| H2PushDiarySize n | 256 | sv | E |
| H2 Server Push Diary Size | |||
| H2PushPriority mime-type [after|before|interleaved] [weight] | * After 16 | sv | E |
| H2 Server Push Priority | |||
| H2PushResource [add] path [critical] | svdh | E | |
| Declares resources for early pushing to the client | |||
| H2SerializeHeaders on|off | off | sv | E |
| Serialize Request/Response Processing Switch | |||
| H2StreamMaxMemSize bytes | 65536 | sv | E |
| Maximum amount of output data buffered per stream. | |||
| H2StreamTimeout time-interval[s] | svd | E | |
| Maximum time waiting when sending/receiving data to stream processing | |||
| H2TLSCoolDownSecs seconds | 1 | sv | E |
| Configure the number of seconds of idle time on TLS before shrinking writes | |||
| H2TLSWarmUpSize amount | 1048576 | sv | E |
| Configure the number of bytes on TLS connection before doing max writes | |||
| H2Upgrade on|off | on for h2c, off for + | svdh | E |
| H2 Upgrade Protocol Switch | |||
| H2WebSockets on|off | off | sv | E |
| En-/Disable WebSockets via HTTP/2 | |||
| H2WindowSize bytes | 65535 | sv | E |
| Size of Stream Window for upstream data. | |||
| Header [condition] add|append|echo|edit|edit*|merge|set|setifempty|unset|note header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] | svdh | E | |
| Configure HTTP response headers | |||
| HeaderName filename | svdh | B | |
| Name of the file that will be inserted at the top of the index listing | |||
| HeartbeatAddress addr:port | s | X | |
| Multicast address for heartbeat packets | |||
| HeartbeatListen addr:port | s | X | |
| multicast address to listen for incoming heartbeat requests | |||
| HeartbeatMaxServers number-of-servers | 10 | s | X |
| Specifies the maximum number of servers that will be sending heartbeat requests to this server | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to store heartbeat data when using flat-file storage | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to read heartbeat data | |||
| HostnameLookups On|Off|Double | Off | svd | C |
| Enables DNS lookups on client IP addresses | |||
| HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods] [Allow0.9|Require1.0] | Strict LenientMetho + | sv | C |
| Modify restrictions on HTTP Request Messages | |||
| IdentityCheck On|Off | Off | svd | E |
| Enables logging of the RFC 1413 identity of the remote user | |||
| IdentityCheckTimeout seconds | 30 | svd | E |
| Determines the timeout duration for ident requests | |||
| <If expression> ... </If> | svdh | C | |
| Contains directives that apply only if a condition is satisfied by a request at runtime | |||
| <IfDefine [!]parameter-name> ... </IfDefine> | svdh | C | |
| Encloses directives that will be processed only if a test is true at startup | |||
| <IfDirective [!]directive-name> ... </IfDirective> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific directive | |||
| <IfFile [!]filename> ... </IfFile> | svdh | C | |
| Encloses directives that will be processed only if file exists at startup | |||
| <IfModule [!]module-file|module-identifier> ... </IfModule> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific module | |||
| <IfSection [!]section-name> ... </IfSection> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific section directive | |||
| <IfVersion [[!]operator] version> ... </IfVersion> | svdh | E | |
| contains version dependent configuration | |||
| ImapBase map|referer|URL | http://servername/ | svdh | B |
Default base for imagemap files | |||
| ImapDefault error|nocontent|map|referer|URL | nocontent | svdh | B |
| Default action when an imagemap is called with coordinates that are not explicitly mapped | |||
| ImapMenu none|formatted|semiformatted|unformatted | formatted | svdh | B |
| Action if no coordinates are given when calling an imagemap | |||
| Include file-path|directory-path|wildcard | svd | C | |
| Includes other configuration files from within the server configuration files | |||
| IncludeOptional file-path|directory-path|wildcard | svd | C | |
| Includes other configuration files from within the server configuration files | |||
| IndexHeadInsert "markup ..." | svdh | B | |
| Inserts text in the HEAD section of an index page. | |||
| IndexIgnore file [file] ... | "." | svdh | B |
| Adds to the list of files to hide when listing a directory | |||
| IndexIgnoreReset ON|OFF | svdh | B | |
| Empties the list of files to hide when listing a directory | |||
| IndexOptions [+|-]option [[+|-]option] ... | svdh | B | |
| Various configuration settings for directory indexing | |||
| IndexOrderDefault Ascending|Descending Name|Date|Size|Description | Ascending Name | svdh | B |
| Sets the default ordering of the directory index | |||
| IndexStyleSheet url-path | svdh | B | |
| Adds a CSS stylesheet to the directory index | |||
| InputSed sed-command | dh | X | |
Sed command to filter request data (typically POST data) | |||
| ISAPIAppendLogToErrors on|off | off | svdh | B |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the error log | |||
| ISAPIAppendLogToQuery on|off | on | svdh | B |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the query field | |||
| ISAPICacheFile file-path [file-path] ... | sv | B | |
| ISAPI .dll files to be loaded at startup | |||
| ISAPIFakeAsync on|off | off | svdh | B |
| Fake asynchronous support for ISAPI callbacks | |||
| ISAPILogNotSupported on|off | off | svdh | B |
| Log unsupported feature requests from ISAPI extensions | |||
| ISAPIReadAheadBuffer size | 49152 | svdh | B |
| Size of the Read Ahead Buffer sent to ISAPI extensions | |||
| KeepAlive On|Off | On | sv | C |
| Enables HTTP persistent connections | |||
| KeepAliveTimeout num[ms] | 5 | sv | C |
| Amount of time the server will wait for subsequent requests on a persistent connection | |||
| KeptBodySize maximum size in bytes | 0 | d | B |
| Keep the request body instead of discarding it up to the specified maximum size, for potential use by filters such as mod_include. | |||
| LanguagePriority MIME-lang [MIME-lang] ... | svdh | B | |
| The precedence of language variants for cases where the client does not express a preference | |||
| LDAPCacheEntries number | 1024 | s | E |
| Maximum number of entries in the primary LDAP cache | |||
| LDAPCacheTTL seconds | 600 | s | E |
| Time that cached items remain valid | |||
| LDAPConnectionPoolTTL n | -1 | sv | E |
| Discard backend connections that have been sitting in the connection pool too long | |||
| LDAPConnectionTimeout seconds | s | E | |
| Specifies the socket connection timeout in seconds | |||
| LDAPLibraryDebug 7 | s | E | |
| Enable debugging in the LDAP SDK | |||
| LDAPOpCacheEntries number | 1024 | s | E |
| Number of entries used to cache LDAP compare operations | |||
| LDAPOpCacheTTL seconds | 600 | s | E |
| Time that entries in the operation cache remain valid | |||
| LDAPReferralHopLimit number | dh | E | |
| The maximum number of referral hops to chase before terminating an LDAP query. | |||
| LDAPReferrals On|Off|default | On | dh | E |
| Enable referral chasing during queries to the LDAP server. | |||
| LDAPRetries number-of-retries | 3 | s | E |
| Configures the number of LDAP server retries. | |||
| LDAPRetryDelay seconds | 0 | s | E |
| Configures the delay between LDAP server retries. | |||
| LDAPSharedCacheFile directory-path/filename | s | E | |
| Sets the shared memory cache file | |||
| LDAPSharedCacheSize bytes | 500000 | s | E |
| Size in bytes of the shared-memory cache | |||
| LDAPTimeout seconds | 60 | s | E |
| Specifies the timeout for LDAP search and bind operations, in seconds | |||
| LDAPTrustedClientCert type directory-path/filename/nickname [password] | dh | E | |
| Sets the file containing or nickname referring to a per connection client certificate. Not all LDAP toolkits support per connection client certificates. | |||
| LDAPTrustedGlobalCert type directory-path/filename [password] | s | E | |
| Sets the file or database containing global trusted Certificate Authority or global client certificates | |||
| LDAPTrustedMode type | sv | E | |
| Specifies the SSL/TLS mode to be used when connecting to an LDAP server. | |||
| LDAPVerifyServerCert On|Off | On | s | E |
| Force server certificate verification | |||
| <Limit method [method] ... > ... </Limit> | dh | C | |
| Restrict enclosed access controls to only certain HTTP methods | |||
| <LimitExcept method [method] ... > ... </LimitExcept> | dh | C | |
| Restrict access controls to all HTTP methods except the named ones | |||
| LimitInternalRecursion number [number] | 10 | sv | C |
| Determine maximum number of internal redirects and nested subrequests | |||
| LimitRequestBody bytes | 1073741824 | svdh | C |
| Restricts the total size of the HTTP request body sent from the client | |||
| LimitRequestFields number | 100 | sv | C |
| Limits the number of HTTP request header fields that will be accepted from the client | |||
| LimitRequestFieldSize bytes | 8190 | sv | C |
| Limits the size of the HTTP request header allowed from the client | |||
| LimitRequestLine bytes | 8190 | sv | C |
| Limit the size of the HTTP request line that will be accepted from the client | |||
| LimitXMLRequestBody bytes | 1000000 | svdh | C |
| Limits the size of an XML-based request body | |||
| Listen [IP-address:]portnumber [protocol] | s | M | |
| IP addresses and ports that the server listens to | |||
| ListenBackLog backlog | 511 | s | M |
| Maximum length of the queue of pending connections | |||
| ListenCoresBucketsRatio ratio | 0 (disabled) | s | M |
| Ratio between the number of CPU cores (online) and the number of listeners' buckets | |||
| LoadFile filename [filename] ... | sv | E | |
| Link in the named object file or library | |||
| LoadModule module filename | sv | E | |
| Links in the object file or library, and adds to the list of active modules | |||
| <Location URL-path|URL> ... </Location> | sv | C | |
| Applies the enclosed directives only to matching URLs | |||
| <LocationMatch regex> ... </LocationMatch> | sv | C | |
| Applies the enclosed directives only to regular-expression matching URLs | |||
| LogFormat format|nickname [nickname] | "%h %l %u %t \"%r\" + | sv | B |
| Describes a format for use in a log file | |||
| LogIOTrackTTFB ON|OFF | OFF | svdh | E |
| Enable tracking of time to first byte (TTFB) | |||
| LogLevel [module:]level [module:level] ... | warn | svd | C |
| Controls the verbosity of the ErrorLog | |||
| LogMessage message [hook=hook] [expr=expression] | d | X | |
| Log user-defined message to error log | |||
| LuaAuthzProvider provider_name /path/to/lua/script.lua function_name | s | E | |
Plug an authorization provider function into mod_authz_core
| |||
| LuaCodeCache stat|forever|never | stat | svdh | E |
| Configure the compiled code cache. | |||
| LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the access_checker phase of request processing | |||
| LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the auth_checker phase of request processing | |||
| LuaHookCheckUserID /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the check_user_id phase of request processing | |||
| LuaHookFixups /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the fixups phase of a request processing | |||
| LuaHookInsertFilter /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the insert_filter phase of request processing | |||
| LuaHookLog /path/to/lua/script.lua log_function_name | svdh | E | |
| Provide a hook for the access log phase of a request processing | |||
| LuaHookMapToStorage /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the map_to_storage phase of request processing | |||
| LuaHookPreTranslate /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the pre_translate phase of a request processing | |||
| LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late] | sv | E | |
| Provide a hook for the translate name phase of request processing | |||
| LuaHookTypeChecker /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the type_checker phase of request processing | |||
| LuaInherit none|parent-first|parent-last | parent-first | svdh | E |
| Controls how parent configuration sections are merged into children | |||
| LuaInputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content input filtering | |||
| LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name] | svdh | E | |
| Map a path to a lua handler | |||
| LuaOutputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content output filtering | |||
| LuaPackageCPath /path/to/include/?.soa | svdh | E | |
| Add a directory to lua's package.cpath | |||
| LuaPackagePath /path/to/include/?.lua | svdh | E | |
| Add a directory to lua's package.path | |||
| LuaQuickHandler /path/to/script.lua hook_function_name | sv | E | |
| Provide a hook for the quick handler of request processing | |||
| LuaRoot /path/to/a/directory | svdh | E | |
| Specify the base path for resolving relative paths for mod_lua directives | |||
| LuaScope once|request|conn|thread|server [min] [max] | once | svdh | E |
| One of once, request, conn, thread -- default is once | |||
| <Macro name [par1 .. parN]> ... </Macro> | svd | B | |
| Define a configuration file macro | |||
| MaxConnectionsPerChild number | 0 | s | M |
| Limit on the number of connections that an individual child server will handle during its life | |||
| MaxKeepAliveRequests number | 100 | sv | C |
| Number of requests allowed on a persistent connection | |||
| MaxMemFree KBytes | 2048 | s | M |
Maximum amount of memory that the main allocator is allowed
to hold without calling free() | |||
| MaxRangeOverlaps default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete
resource | |||
| MaxRangeReversals default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of range reversals (eg: 100-200,50-70) allowed before returning the complete
resource | |||
| MaxRanges default | unlimited | none | number-of-ranges | 200 | svd | C |
| Number of ranges allowed before returning the complete resource | |||
| MaxRequestWorkers number | s | M | |
| Maximum number of connections that will be processed simultaneously | |||
| MaxSpareServers number | 10 | s | M |
| Maximum number of idle child server processes | |||
| MaxSpareThreads number | s | M | |
| Maximum number of idle threads | |||
| MaxThreads number | 2048 | s | M |
| Set the maximum number of worker threads | |||
| MDActivationDelay duration | s | X | |
| How long to delay activation of new certificates | |||
| MDBaseServer on|off | off | s | X |
| Control if base server may be managed or only virtual hosts. | |||
| MDCAChallenges name [ name ... ] | tls-alpn-01 http-01 + | s | X |
| Type of ACME challenge used to prove domain ownership. | |||
| MDCertificateAgreement accepted | s | X | |
| You confirm that you accepted the Terms of Service of the Certificate Authority. | |||
| MDCertificateAuthority url | letsencrypt | s | X |
| The URL(s) of the ACME Certificate Authority to use. | |||
| MDCertificateCheck name url | s | X | |
| Set name and URL pattern for a certificate monitoring site. | |||
| MDCertificateFile path-to-pem-file | s | X | |
| Specify a static certificate file for the MD. | |||
| MDCertificateKeyFile path-to-file | s | X | |
| Specify a static private key for for the static cerrtificate. | |||
| MDCertificateMonitor name url | crt.sh https://crt. + | s | X |
| The URL of a certificate log monitor. | |||
| MDCertificateProtocol protocol | ACME | s | X |
| The protocol to use with the Certificate Authority. | |||
| MDCertificateStatus on|off | on | s | X |
| Exposes public certificate information in JSON. | |||
| MDChallengeDns01 path-to-command | s | X | |
| Set the command for setup/teardown of dns-01 challenges | |||
| MDChallengeDns01Version 1|2 | 1 | s | X |
| Set the type of arguments to call MDChallengeDns01 with | |||
| MDCheckInterval duration | 12h | s | X |
| Determines how often certificates are checked | |||
| MDContactEmail address | s | X | |
| Email address used for account registration | |||
| MDDriveMode always|auto|manual | auto | s | X |
| former name of MDRenewMode. | |||
| MDExternalAccountBinding key-id hmac-64 | none | file | none | s | X |
| Set the external account binding keyid and hmac values to use at CA | |||
| MDHttpProxy url | s | X | |
| Define a proxy for outgoing connections. | |||
| MDMatchNames all|servernames | all | s | X |
| Determines how DNS names are matched to vhosts | |||
| MDMember hostname | s | X | |
| Additional hostname for the managed domain. | |||
| MDMembers auto|manual | auto | s | X |
| Control if the alias domain names are automatically added. | |||
| MDMessageCmd path-to-cmd optional-args | s | X | |
| Handle events for Manage Domains | |||
| MDMustStaple on|off | off | s | X |
| Control if new certificates carry the OCSP Must Staple flag. | |||
| MDNotifyCmd path [ args ] | s | X | |
| Run a program when a Managed Domain is ready. | |||
| MDomain dns-name [ other-dns-name... ] [auto|manual] | s | X | |
| Define list of domain names that belong to one group. | |||
| <MDomainSet dns-name [ other-dns-name... ]>...</MDomainSet> | s | X | |
| Container for directives applied to the same managed domains. | |||
| MDPortMap map1 [ map2 ] | http:80 https:443 | s | X |
| Map external to internal ports for domain ownership verification. | |||
| MDPrivateKeys type [ params... ] | RSA 2048 | s | X |
| Set type and size of the private keys generated. | |||
| MDProfile name | s | X | |
| Use a specific ACME profile from the CA | |||
| MDProfileMandatory on|off | off | s | X |
| Control if an MDProfile is mandatory. | |||
| MDRenewMode always|auto|manual | auto | s | X |
| Controls if certificates shall be renewed. | |||
| MDRenewWindow duration | 33% | s | X |
| Control when a certificate will be renewed. | |||
| MDRequireHttps off|temporary|permanent | off | s | X |
| Redirects http: traffic to https: for Managed Domains. | |||
| MDRetryDelay duration | 5s | s | X |
| Time length for first retry, doubled on every consecutive error. | |||
| MDRetryFailover number | 13 | s | X |
| The number of errors before a failover to another CA is triggered | |||
| MDServerStatus on|off | on | s | X |
| Control if Managed Domain information is added to server-status. | |||
| MDStapleOthers on|off | on | s | X |
| Enable stapling for certificates not managed by mod_md. | |||
| MDStapling on|off | off | s | X |
| Enable stapling for all or a particular MDomain. | |||
| MDStaplingKeepResponse duration | 7d | s | X |
| Controls when old responses should be removed. | |||
| MDStaplingRenewWindow duration | 33% | s | X |
| Control when the stapling responses will be renewed. | |||
| MDStoreDir path | md | s | X |
| Path on the local file system to store the Managed Domains data. | |||
| MDStoreLocks on|off|duration | off | s | X |
| Configure locking of store for updates | |||
| MDWarnWindow duration | 10% | s | X |
| Define the time window when you want to be warned about an expiring certificate. | |||
| MemcacheConnTTL num[units] | 15s | sv | E |
| Keepalive time for idle connections | |||
| MergeSlashes ON|OFF | ON | sv | C |
| Controls whether the server merges consecutive slashes in URLs. | |||
| MergeTrailers [on|off] | off | sv | C |
| Determines whether trailers are merged into headers | |||
| MetaDir directory | .web | svdh | E |
| Name of the directory to find CERN-style meta information files | |||
| MetaFiles on|off | off | svdh | E |
| Activates CERN meta-file processing | |||
| MetaSuffix suffix | .meta | svdh | E |
| File name suffix for the file containing CERN-style meta information | |||
| MimeMagicFile file-path | sv | E | |
| Enable MIME-type determination based on file contents using the specified magic file | |||
| MinSpareServers number | 5 | s | M |
| Minimum number of idle child server processes | |||
| MinSpareThreads number | s | M | |
| Minimum number of idle threads available to handle request spikes | |||
| MMapFile file-path [file-path] ... | s | X | |
| Map a list of files into memory at startup time | |||
| ModemStandard V.21|V.26bis|V.32|V.34|V.92 | d | X | |
| Modem standard to simulate | |||
| ModMimeUsePathInfo On|Off | Off | d | B |
Tells mod_mime to treat path_info
components as part of the filename | |||
| MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers [Handlers|Filters] | NegotiatedOnly | svdh | B |
| The types of files that will be included when searching for a matching file with MultiViews | |||
| Mutex mechanism [default|mutex-name] ... [OmitPID] | default | s | C |
| Configures mutex mechanism and lock file directory for all or specified mutexes | |||
| NameVirtualHost addr[:port] | s | C | |
| DEPRECATED: Designates an IP address for name-virtual hosting | |||
| NoProxy host [host] ... | sv | E | |
| Hosts, domains, or networks that will be connected to directly | |||
| NWSSLTrustedCerts filename [filename] ... | s | B | |
| List of additional client certificates | |||
| NWSSLUpgradeable [IP-address:]portnumber | s | B | |
| Allows a connection to be upgraded to an SSL connection upon request | |||
| Options [+|-]option [[+|-]option] ... | FollowSymlinks | svdh | C |
| Configures what features are available in a particular directory | |||
| Order ordering | Deny,Allow | dh | E |
Controls the default access state and the order in which
Allow and Deny are
evaluated. | |||
| OutputSed sed-command | dh | X | |
| Sed command for filtering response content | |||
| PassEnv env-variable [env-variable] ... | svdh | B | |
| Passes environment variables from the shell | |||
| PidFile filename | logs/httpd.pid | s | M |
| File where the server records the process ID of the daemon | |||
| PrivilegesMode FAST|SECURE|SELECTIVE | FAST | svd | X |
| Trade off processing speed and efficiency vs security against malicious privileges-aware code. | |||
| Protocol protocol | sv | C | |
| Protocol for a listening socket | |||
| ProtocolEcho On|Off | Off | sv | X |
| Turn the echo server on or off | |||
| Protocols protocol ... | http/1.1 | sv | C |
| Protocols available for a server/virtual host | |||
| ProtocolsHonorOrder On|Off | On | sv | C |
| Determines if order of Protocols determines precedence during negotiation | |||
| <Proxy wildcard-url> ...</Proxy> | sv | E | |
| Container for directives applied to proxied resources | |||
| Proxy100Continue Off|On | On | svd | E |
| Forward 100-continue expectation to the origin server | |||
| ProxyAddHeaders Off|On | On | svd | E |
| Add proxy information in X-Forwarded-* headers | |||
| ProxyBadHeader IsError|Ignore|StartBody | IsError | sv | E |
| Determines how to handle bad header lines in a response | |||
| ProxyBlock *|word|host|domain [word|host|domain] ... | sv | E | |
| Words, hosts, or domains that are banned from being proxied | |||
| ProxyDomain Domain | sv | E | |
| Default domain name for proxied requests | |||
| ProxyErrorOverride Off|On [code ...] | Off | svd | E |
| Override error pages for proxied content | |||
| ProxyExpressDBMFile pathname | sv | E | |
| Pathname to DBM file. | |||
| ProxyExpressDBMType type | default | sv | E |
| DBM type of file. | |||
| ProxyExpressEnable on|off | off | sv | E |
| Enable the module functionality. | |||
| ProxyFCGIBackendType FPM|GENERIC | FPM | svdh | E |
| Specify the type of backend FastCGI application | |||
| ProxyFCGISetEnvIf conditional-expression [!]environment-variable-name [value-expression] | svdh | E | |
| Allow variables sent to FastCGI servers to be fixed up | |||
| ProxyFtpDirCharset character_set | ISO-8859-1 | svd | E |
| Define the character set for proxied FTP listings | |||
| ProxyFtpEscapeWildcards on|off | on | svd | E |
| Whether wildcards in requested filenames are escaped when sent to the FTP server | |||
| ProxyFtpListOnWildcard on|off | on | svd | E |
| Whether wildcards in requested filenames trigger a file listing | |||
| ProxyHCExpr name {ap_expr expression} | sv | E | |
| Creates a named condition expression to use to determine health of the backend based on its response | |||
| ProxyHCTemplate name parameter=setting [...] | sv | E | |
| Creates a named template for setting various health check parameters | |||
| ProxyHCTPsize size | 16 | s | E |
| Sets the total server-wide size of the threadpool used for the health check workers | |||
| ProxyHTMLBufSize bytes | 8192 | svd | B |
| Sets the buffer size increment for buffering inline scripts and stylesheets. | |||
| ProxyHTMLCharsetOut Charset | * | svd | B | |
| Specify a charset for mod_proxy_html output. | |||
| ProxyHTMLDocType HTML|XHTML [Legacy] OR ProxyHTMLDocType fpi [SGML|XML] | svd | B | |
| Sets an HTML or XHTML document type declaration. | |||
| ProxyHTMLEnable On|Off | Off | svd | B |
| Turns the proxy_html filter on or off. | |||
| ProxyHTMLEvents attribute [attribute ...] | svd | B | |
| Specify attributes to treat as scripting events. | |||
| ProxyHTMLExtended On|Off | Off | svd | B |
| Determines whether to fix links in inline scripts, stylesheets, and scripting events. | |||
| ProxyHTMLFixups [lowercase] [dospath] [reset] | svd | B | |
| Fixes for simple HTML errors. | |||
| ProxyHTMLInterp On|Off | Off | svd | B |
Enables per-request interpolation of
ProxyHTMLURLMap rules. | |||
| ProxyHTMLLinks element attribute [attribute2 ...] | svd | B | |
| Specify HTML elements that have URL attributes to be rewritten. | |||
| ProxyHTMLMeta On|Off | Off | svd | B |
Turns on or off extra pre-parsing of metadata in HTML
<head> sections. | |||
| ProxyHTMLStripComments On|Off | Off | svd | B |
| Determines whether to strip HTML comments. | |||
| ProxyHTMLURLMap from-pattern to-pattern [flags] [cond] | svd | B | |
| Defines a rule to rewrite HTML links | |||
| ProxyIOBufferSize bytes | 8192 | sv | E |
| Determine size of internal data throughput buffer | |||
| <ProxyMatch regex> ...</ProxyMatch> | sv | E | |
| Container for directives applied to regular-expression-matched proxied resources | |||
| ProxyMaxForwards number | -1 | sv | E |
| Maximum number of proxies that a request can be forwarded through | |||
| ProxyPass [path] !|url [key=value [key=value ...]] [nocanon] [interpolate] [noquery] | svd | E | |
| Maps remote servers into the local server URL-space | |||
| ProxyPassInherit On|Off | On | sv | E |
| Inherit ProxyPass directives defined from the main server | |||
| ProxyPassInterpolateEnv On|Off | Off | svd | E |
| Enable Environment Variable interpolation in Reverse Proxy configurations | |||
| ProxyPassMatch [regex] !|url [key=value [key=value ...]] | svd | E | |
| Maps remote servers into the local server URL-space using regular expressions | |||
| ProxyPassReverse [path] url [interpolate] | svd | E | |
| Adjusts the URL in HTTP response headers sent from a reverse proxied server | |||
| ProxyPassReverseCookieDomain internal-domain public-domain [interpolate] | svd | E | |
| Adjusts the Domain string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPassReverseCookiePath internal-path public-path [interpolate] | svd | E | |
| Adjusts the Path string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPreserveHost On|Off | Off | svd | E |
| Use incoming Host HTTP request header for proxy request | |||
| ProxyReceiveBufferSize bytes | 0 | sv | E |
| Network buffer size for proxied HTTP and FTP connections | |||
| ProxyRemote match remote-server [username:password] | sv | E | |
| Remote proxy used to handle certain requests | |||
| ProxyRemoteMatch regex remote-server [username:password] | sv | E | |
| Remote proxy used to handle requests matched by regular expressions | |||
| ProxyRequests On|Off | Off | sv | E |
| Enables forward (standard) proxy requests | |||
| ProxySCGIInternalRedirect On|Off|Headername | On | svd | E |
| Enable or disable internal redirect responses from the backend | |||
| ProxySCGISendfile On|Off|Headername | Off | svd | E |
| Enable evaluation of X-Sendfile pseudo response header | |||
| ProxySet url key=value [key=value ...] | svd | E | |
| Set various Proxy balancer or member parameters | |||
| ProxySourceAddress address | sv | E | |
| Set local IP address for outgoing proxy connections | |||
| ProxyStatus Off|On|Full | Off | sv | E |
| Show Proxy LoadBalancer status in mod_status | |||
| ProxyTimeout seconds | sv | E | |
| Network timeout for proxied requests | |||
| ProxyVia On|Off|Full|Block | Off | sv | E |
Information provided in the Via HTTP response
header for proxied requests | |||
| ProxyWebsocketFallbackToProxyHttp On|Off | On | sv | E |
Instructs this module to let mod_proxy_http handle the request | |||
| QualifyRedirectURL On|Off | Off | svd | C |
| Controls whether the REDIRECT_URL environment variable is fully qualified | |||
| ReadBufferSize bytes | 8192 | svd | C |
| Size of the buffers used to read data | |||
| ReadmeName filename | svdh | B | |
| Name of the file that will be inserted at the end of the index listing | |||
| ReceiveBufferSize bytes | 0 | s | M |
| TCP receive buffer size | |||
| Redirect [status] [URL-path] URL | svdh | B | |
| Sends an external redirect asking the client to fetch a different URL | |||
| RedirectMatch [status] regex URL | svdh | B | |
| Sends an external redirect based on a regular expression match of the current URL | |||
| RedirectPermanent URL-path URL | svdh | B | |
| Sends an external permanent redirect asking the client to fetch a different URL | |||
| RedirectRelative On|Off | Off | svd | B |
| Allows relative redirect targets. | |||
| RedirectTemp URL-path URL | svdh | B | |
| Sends an external temporary redirect asking the client to fetch a different URL | |||
| RedisConnPoolTTL num[units] | 15s | sv | E |
| TTL used for the connection pool with the Redis server(s) | |||
| RedisTimeout num[units] | 5s | sv | E |
| R/W timeout used for the connection with the Redis server(s) | |||
| ReflectorHeader inputheader [outputheader] | svdh | B | |
| Reflect an input header to the output headers | |||
| RegexDefaultOptions [none] [+|-]option [[+|-]option] ... | DOTALL DOLLAR_ENDON + | s | C |
| Allow to configure global/default options for regexes | |||
| RegisterHttpMethod method [method [...]] | s | C | |
| Register non-standard HTTP methods | |||
| RemoteIPHeader header-field | sv | B | |
| Declare the header field which should be parsed for useragent IP addresses | |||
| RemoteIPInternalProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPInternalProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPProxiesHeader HeaderFieldName | sv | B | |
| Declare the header field which will record all intermediate IP addresses | |||
| RemoteIPProxyProtocol On|Off | sv | B | |
| Enable or disable PROXY protocol handling | |||
| RemoteIPProxyProtocolExceptions host|range [host|range] [host|range] | sv | B | |
| Disable processing of PROXY header for certain hosts or networks | |||
| RemoteIPTrustedProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPTrustedProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoveCharset extension [extension] ... | vdh | B | |
| Removes any character set associations for a set of file extensions | |||
| RemoveEncoding extension [extension] ... | vdh | B | |
| Removes any content encoding associations for a set of file extensions | |||
| RemoveHandler extension [extension] ... | vdh | B | |
| Removes any handler associations for a set of file extensions | |||
| RemoveInputFilter extension [extension] ... | vdh | B | |
| Removes any input filter associations for a set of file extensions | |||
| RemoveLanguage extension [extension] ... | vdh | B | |
| Removes any language associations for a set of file extensions | |||
| RemoveOutputFilter extension [extension] ... | vdh | B | |
| Removes any output filter associations for a set of file extensions | |||
| RemoveType extension [extension] ... | vdh | B | |
| Removes any content type associations for a set of file extensions | |||
| RequestHeader add|append|edit|edit*|merge|set|setifempty|unset header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] | svdh | E | |
| Configure HTTP request headers | |||
| RequestReadTimeout [handshake=timeout[-maxtimeout][,MinRate=rate] [header=timeout[-maxtimeout][,MinRate=rate] [body=timeout[-maxtimeout][,MinRate=rate] | handshake=0 header= + | sv | E |
| Set timeout values for completing the TLS handshake, receiving the request headers and/or body from client. | |||
| Require [not] entity-name [entity-name] ... | dh | B | |
| Tests whether an authenticated user is authorized by an authorization provider. | |||
| <RequireAll> ... </RequireAll> | dh | B | |
| Enclose a group of authorization directives of which none must fail and at least one must succeed for the enclosing directive to succeed. | |||
| <RequireAny> ... </RequireAny> | dh | B | |
| Enclose a group of authorization directives of which one must succeed for the enclosing directive to succeed. | |||
| <RequireNone> ... </RequireNone> | dh | B | |
| Enclose a group of authorization directives of which none must succeed for the enclosing directive to not fail. | |||
| RewriteBase URL-path | dh | E | |
| Sets the base URL for per-directory rewrites | |||
| RewriteCond TestString CondPattern [flags] | svdh | E | |
| Defines a condition under which rewriting will take place | |||
| RewriteEngine on|off | off | svdh | E |
| Enables or disables runtime rewriting engine | |||
| RewriteMap MapName MapType:MapSource [MapTypeOptions] | sv | E | |
| Defines a mapping function for key-lookup | |||
| RewriteOptions Options | svdh | E | |
| Sets some special options for the rewrite engine | |||
| RewriteRule Pattern Substitution [flags] | svdh | E | |
| Defines rules for the rewriting engine | |||
| RLimitCPU seconds|max [seconds|max] | svdh | C | |
| Limits the CPU consumption of processes launched by Apache httpd children | |||
| RLimitMEM bytes|max [bytes|max] | svdh | C | |
| Limits the memory consumption of processes launched by Apache httpd children | |||
| RLimitNPROC number|max [number|max] | svdh | C | |
| Limits the number of processes that can be launched by processes launched by Apache httpd children | |||
| Satisfy Any|All | All | dh | E |
| Interaction between host-level access control and user authentication | |||
| ScoreBoardFile file-path | logs/apache_runtime + | s | M |
| Location of the file used to store coordination data for the child processes | |||
| Script method cgi-script | svd | B | |
| Activates a CGI script for a particular request method. | |||
| ScriptAlias [URL-path] file-path|directory-path | svd | B | |
| Maps a URL to a filesystem location and designates the target as a CGI script | |||
| ScriptAliasMatch regex file-path|directory-path | sv | B | |
| Maps a URL to a filesystem location using a regular expression and designates the target as a CGI script | |||
| ScriptInterpreterSource Registry|Registry-Strict|Script | Script | svdh | C |
| Technique for locating the interpreter for CGI scripts | |||
| ScriptLog file-path | sv | B | |
| Location of the CGI script error logfile | |||
| ScriptLogBuffer bytes | 1024 | sv | B |
| Maximum amount of PUT or POST requests that will be recorded in the scriptlog | |||
| ScriptLogLength bytes | 10385760 | sv | B |
| Size limit of the CGI script logfile | |||
| ScriptSock file-path | cgisock | s | B |
| The filename prefix of the socket to use for communication with the cgi daemon | |||
| SecureListen [IP-address:]portnumber Certificate-Name [MUTUAL] | s | B | |
| Enables SSL encryption for the specified port | |||
| SeeRequestTail On|Off | Off | s | C |
| Determine if mod_status displays the first 63 characters of a request or the last 63, assuming the request itself is greater than 63 chars. | |||
| SendBufferSize bytes | 0 | s | M |
| TCP buffer size | |||
| ServerAdmin email-address|URL | sv | C | |
| Email address that the server includes in error messages sent to the client | |||
| ServerAlias hostname [hostname] ... | v | C | |
| Alternate names for a host used when matching requests to name-virtual hosts | |||
| ServerLimit number | s | M | |
| Upper limit on configurable number of processes | |||
| ServerName [scheme://]domain-name|ip-address[:port] | sv | C | |
| Hostname and port that the server uses to identify itself | |||
| ServerPath URL-path | v | C | |
| Legacy URL pathname for a name-based virtual host that is accessed by an incompatible browser | |||
| ServerRoot directory-path | /usr/local/apache | s | C |
| Base directory for the server installation | |||
| ServerSignature On|Off|EMail | Off | svdh | C |
| Configures the footer on server-generated documents | |||
| ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full | Full | s | C |
Configures the Server HTTP response
header | |||
| Session On|Off | Off | svdh | E |
| Enables a session for the current directory or location | |||
| SessionCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session | |||
| SessionCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session | |||
| SessionCookieRemove On|Off | Off | svdh | E |
| Control for whether session cookies should be removed from incoming HTTP headers | |||
| SessionCryptoCipher name | aes256 | svdh | X |
| The crypto cipher to be used to encrypt the session | |||
| SessionCryptoDriver name [param[=value]] | s | X | |
| The crypto driver to be used to encrypt the session | |||
| SessionCryptoPassphrase secret [ secret ... ] | svdh | X | |
| The key used to encrypt the session | |||
| SessionCryptoPassphraseFile filename | svd | X | |
| File containing keys used to encrypt the session | |||
| SessionDBDCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session ID | |||
| SessionDBDCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session ID | |||
| SessionDBDCookieRemove On|Off | On | svdh | E |
| Control for whether session ID cookies should be removed from incoming HTTP headers | |||
| SessionDBDDeleteLabel label | deletesession | svdh | E |
| The SQL query to use to remove sessions from the database | |||
| SessionDBDInsertLabel label | insertsession | svdh | E |
| The SQL query to use to insert sessions into the database | |||
| SessionDBDPerUser On|Off | Off | svdh | E |
| Enable a per user session | |||
| SessionDBDSelectLabel label | selectsession | svdh | E |
| The SQL query to use to select sessions from the database | |||
| SessionDBDUpdateLabel label | updatesession | svdh | E |
| The SQL query to use to update existing sessions in the database | |||
| SessionEnv On|Off | Off | svdh | E |
| Control whether the contents of the session are written to the HTTP_SESSION environment variable | |||
| SessionExclude path | svdh | E | |
| Define URL prefixes for which a session is ignored | |||
| SessionExpiryUpdateInterval interval | 0 (always update) | svdh | E |
| Define the number of seconds a session's expiry may change without the session being updated | |||
| SessionHeader header | svdh | E | |
| Import session updates from a given HTTP response header | |||
| SessionInclude path | svdh | E | |
| Define URL prefixes for which a session is valid | |||
| SessionMaxAge maxage | 0 | svdh | E |
| Define a maximum age in seconds for a session | |||
| SetEnv env-variable [value] | svdh | B | |
| Sets environment variables | |||
| SetEnvIf attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on attributes of the request | |||
| SetEnvIfExpr expr [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on an ap_expr expression | |||
| SetEnvIfNoCase attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on attributes of the request without respect to case | |||
| SetHandler handler-name|none|expression | svdh | C | |
| Forces all matching files to be processed by a handler | |||
| SetInputFilter filter[;filter...] | svdh | C | |
| Sets the filters that will process client requests and POST input | |||
| SetOutputFilter filter[;filter...] | svdh | C | |
| Sets the filters that will process responses from the server | |||
| SSIEndTag tag | "-->" | sv | B |
| String that ends an include element | |||
| SSIErrorMsg message | "[an error occurred + | svdh | B |
| Error message displayed when there is an SSI error | |||
| SSIETag on|off | off | dh | B |
| Controls whether ETags are generated by the server. | |||
| SSILastModified on|off | off | dh | B |
Controls whether Last-Modified headers are generated by the
server. | |||
| SSILegacyExprParser on|off | off | dh | B |
| Enable compatibility mode for conditional expressions. | |||
| SSIStartTag tag | "<!--#" | sv | B |
| String that starts an include element | |||
| SSITimeFormat formatstring | "%A, %d-%b-%Y %H:%M + | svdh | B |
| Configures the format in which date strings are displayed | |||
| SSIUndefinedEcho string | "(none)" | svdh | B |
| String displayed when an unset variable is echoed | |||
| SSLCACertificateFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for Client Auth | |||
| SSLCACertificatePath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for Client Auth | |||
| SSLCADNRequestFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCADNRequestPath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCARevocationCheck chain|leaf|none [flags ...] | none | sv | E |
| Enable CRL-based revocation checking | |||
| SSLCARevocationFile file-path | sv | E | |
| File of concatenated PEM-encoded CA CRLs for Client Auth | |||
| SSLCARevocationPath directory-path | sv | E | |
| Directory of PEM-encoded CA CRLs for Client Auth | |||
| SSLCertificateChainFile file-path | sv | E | |
| File of PEM-encoded Server CA Certificates | |||
| SSLCertificateFile file-path|certid | sv | E | |
| Server PEM-encoded X.509 certificate data file or token identifier | |||
| SSLCertificateKeyFile file-path|keyid | sv | E | |
| Server PEM-encoded private key file | |||
| SSLCipherSuite [protocol] cipher-spec | DEFAULT (depends on + | svdh | E |
| Cipher Suite available for negotiation in SSL handshake | |||
| SSLCompression on|off | off | sv | E |
| Enable compression on the SSL level | |||
| SSLCryptoDevice engine | builtin | s | E |
| Enable use of a cryptographic hardware accelerator | |||
| SSLEngine on|off|optional | off | sv | E |
| SSL Engine Operation Switch | |||
| SSLFIPS on|off | off | s | E |
| SSL FIPS mode Switch | |||
| SSLHonorCipherOrder on|off | off | sv | E |
| Option to prefer the server's cipher preference order | |||
| SSLInsecureRenegotiation on|off | off | sv | E |
| Option to enable support for insecure renegotiation | |||
| SSLOCSPDefaultResponder uri | sv | E | |
| Set the default responder URI for OCSP validation | |||
| SSLOCSPEnable on|leaf|off | off | sv | E |
| Enable OCSP validation of the client certificate chain | |||
| SSLOCSPNoverify on|off | off | sv | E |
| skip the OCSP responder certificates verification | |||
| SSLOCSPOverrideResponder on|off | off | sv | E |
| Force use of the default responder URI for OCSP validation | |||
| SSLOCSPProxyURL url | sv | E | |
| Proxy URL to use for OCSP requests | |||
| SSLOCSPResponderCertificateFile file | sv | E | |
| Set of trusted PEM encoded OCSP responder certificates | |||
| SSLOCSPResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP queries | |||
| SSLOCSPResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP responses | |||
| SSLOCSPResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP response validation | |||
| SSLOCSPUseRequestNonce on|off | on | sv | E |
| Use a nonce within OCSP queries | |||
| SSLOpenSSLConfCmd command-name command-value | sv | E | |
| Configure OpenSSL parameters through its SSL_CONF API | |||
| SSLOptions [+|-]option ... | svdh | E | |
| Configure various SSL engine run-time options | |||
| SSLPassPhraseDialog type | builtin | s | E |
| Type of pass phrase dialog for encrypted private keys | |||
| SSLProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | sv | E |
| Configure usable SSL/TLS protocol versions | |||
| SSLProxyCACertificateFile file-path | svp | E | |
| File of concatenated PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCACertificatePath directory-path | svp | E | |
| Directory of PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCARevocationCheck chain|leaf|none | none | svp | E |
| Enable CRL-based revocation checking for Remote Server Auth | |||
| SSLProxyCARevocationFile file-path | svp | E | |
| File of concatenated PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCARevocationPath directory-path | svp | E | |
| Directory of PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCheckPeerCN on|off | on | svp | E |
| Whether to check the remote server certificate's CN field | |||
| SSLProxyCheckPeerExpire on|off | on | svp | E |
| Whether to check if remote server certificate is expired | |||
| SSLProxyCheckPeerName on|off | on | svp | E |
| Configure host name checking for remote server certificates | |||
| SSLProxyCipherSuite [protocol] cipher-spec | ALL:!ADH:RC4+RSA:+H + | svp | E |
| Cipher Suite available for negotiation in SSL proxy handshake | |||
| SSLProxyEngine on|off | off | svp | E |
| SSL Proxy Engine Operation Switch | |||
| SSLProxyMachineCertificateChainFile filename | svp | E | |
| File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate | |||
| SSLProxyMachineCertificateFile filename | svp | E | |
| File of concatenated PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyMachineCertificatePath directory | svp | E | |
| Directory of PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | svp | E |
| Configure usable SSL protocol flavors for proxy usage | |||
| SSLProxyVerify level | none | svp | E |
| Type of remote server Certificate verification | |||
| SSLProxyVerifyDepth number | 1 | svp | E |
| Maximum depth of CA Certificates in Remote Server Certificate verification | |||
| SSLRandomSeed context source [bytes] | s | E | |
| Pseudo Random Number Generator (PRNG) seeding source | |||
| SSLRenegBufferSize bytes | 131072 | dh | E |
| Set the size for the SSL renegotiation buffer | |||
| SSLRequire expression | dh | E | |
| Allow access only when an arbitrarily complex boolean expression is true | |||
| SSLRequireSSL | dh | E | |
| Deny access when SSL is not used for the HTTP request | |||
| SSLSessionCache type | none | s | E |
| Type of the global/inter-process SSL Session Cache | |||
| SSLSessionCacheTimeout seconds | 300 | sv | E |
| Number of seconds before an SSL session expires in the Session Cache | |||
| SSLSessionTicketKeyFile file-path | sv | E | |
| Persistent encryption/decryption key for TLS session tickets | |||
| SSLSessionTickets on|off | on | sv | E |
| Enable or disable use of TLS session tickets | |||
| SSLSRPUnknownUserSeed secret-string | sv | E | |
| SRP unknown user seed | |||
| SSLSRPVerifierFile file-path | sv | E | |
| Path to SRP verifier file | |||
| SSLStaplingCache type | s | E | |
| Configures the OCSP stapling cache | |||
| SSLStaplingErrorCacheTimeout seconds | 600 | sv | E |
| Number of seconds before expiring invalid responses in the OCSP stapling cache | |||
| SSLStaplingFakeTryLater on|off | on | sv | E |
| Synthesize "tryLater" responses for failed OCSP stapling queries | |||
| SSLStaplingForceURL uri | sv | E | |
| Override the OCSP responder URI specified in the certificate's AIA extension | |||
| SSLStaplingResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP stapling queries | |||
| SSLStaplingResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP stapling responses | |||
| SSLStaplingResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP stapling response validation | |||
| SSLStaplingReturnResponderErrors on|off | on | sv | E |
| Pass stapling related OCSP errors on to client | |||
| SSLStaplingStandardCacheTimeout seconds | 3600 | sv | E |
| Number of seconds before expiring responses in the OCSP stapling cache | |||
| SSLStrictSNIVHostCheck on|off | off | sv | E |
| Whether to allow non-SNI clients to access a name-based virtual host. | |||
| SSLUserName varname | sdh | E | |
| Variable name to determine user name | |||
| SSLUseStapling on|off | off | sv | E |
| Enable stapling of OCSP responses in the TLS handshake | |||
| SSLVerifyClient level | none | svdh | E |
| Type of Client Certificate verification | |||
| SSLVerifyDepth number | 1 | svdh | E |
| Maximum depth of CA Certificates in Client Certificate verification | |||
| StartServers number | s | M | |
| Number of child server processes created at startup | |||
| StartThreads number | s | M | |
| Number of threads created on startup | |||
| StrictHostCheck ON|OFF | OFF | sv | C |
| Controls whether the server requires the requested hostname be listed enumerated in the virtual host handling the request | |||
| Substitute s/pattern/substitution/[infq] | dh | E | |
| Pattern to filter the response content | |||
| SubstituteInheritBefore on|off | off | dh | E |
| Change the merge order of inherited patterns | |||
| SubstituteMaxLineLength bytes(b|B|k|K|m|M|g|G) | 1m | dh | E |
| Set the maximum line size | |||
| Suexec On|Off | s | B | |
| Enable or disable the suEXEC feature | |||
| SuexecUserGroup User Group | sv | E | |
| User and group for CGI programs to run as | |||
| ThreadLimit number | s | M | |
| Sets the upper limit on the configurable number of threads per child process | |||
| ThreadsPerChild number | s | M | |
| Number of threads created by each child process | |||
| ThreadStackSize size | s | M | |
| The size in bytes of the stack used by threads handling client connections | |||
| TimeOut seconds | 60 | sv | C |
| Amount of time the server will wait for certain events before failing a request | |||
| TraceEnable [on|off|extended] | on | sv | C |
Determines the behavior on TRACE requests | |||
| TransferLog file|pipe | sv | B | |
| Specify location of a log file | |||
| TypesConfig file-path | conf/mime.types | s | B |
The location of the mime.types file | |||
| UNCList hostname [hostname...] | s | C | |
| Controls what UNC host names can be accessed by the server | |||
| UnDefine parameter-name | s | C | |
| Undefine the existence of a variable | |||
| UndefMacro name | svd | B | |
| Undefine a macro | |||
| UnsetEnv env-variable [env-variable] ... | svdh | B | |
| Removes variables from the environment | |||
| Use name [value1 ... valueN] | svd | B | |
| Use a macro | |||
| UseCanonicalName On|Off|DNS | Off | svd | C |
| Configures how the server determines its own name and port | |||
| UseCanonicalPhysicalPort On|Off | Off | svd | C |
| Configures how the server determines its own port | |||
| User unix-userid | #-1 | s | B |
| The userid under which the server will answer requests | |||
| UserDir directory-filename [directory-filename] ... | sv | B | |
| Location of the user-specific directories | |||
| VHostCGIMode On|Off|Secure | On | v | X |
| Determines whether the virtualhost can run subprocesses, and the privileges available to subprocesses. | |||
| VHostCGIPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to subprocesses created by a virtual host. | |||
| VHostGroup unix-groupid | v | X | |
| Sets the Group ID under which a virtual host runs. | |||
| VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to a virtual host. | |||
| VHostSecure On|Off | On | v | X |
| Determines whether the server runs with enhanced security for the virtualhost. | |||
| VHostUser unix-userid | v | X | |
| Sets the User ID under which a virtual host runs. | |||
| VirtualDocumentRoot interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| VirtualDocumentRootIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| <VirtualHost addr[:port] [addr[:port]] ...> ... </VirtualHost> | s | C | |
| Contains directives that apply only to a specific hostname or IP address | |||
| VirtualScriptAlias interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| VirtualScriptAliasIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| WatchdogInterval time-interval[s] | 1 | s | B |
| Watchdog interval in seconds | |||
| XBitHack on|off|full | off | svdh | B |
| Parse SSI directives in files with the execute bit set | |||
| xml2EncAlias charset alias [alias ...] | s | B | |
| Recognise Aliases for encoding values | |||
| xml2EncDefault name | svdh | B | |
| Sets a default encoding to assume when absolutely no information can be automatically detected | |||
| xml2StartParse element [element ...] | svdh | B | |
| Advise the parser to skip leading junk. | |||
Apache HTTP Server Version 2.4
| : | CGI ũƮ SSI ȯ溯 Ѵ |
|---|---|
| : | Base |
| : | env_module |
| ҽ: | mod_env.c |
CGI ũƮ SSI ȯ溯 Ѵ. ȯ溯 ִ. ƴϸ ߿ ȯ溯 ϰ ִ.
| : | ȯ溯 ´ |
|---|---|
| : | PassEnv env-variable [env-variable]
... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_env |
Ư ȯ溯 CGI ũƮ SSI Ѵ.
PassEnv LD_LIBRARY_PATH
| : | ȯ溯 Ѵ |
|---|---|
| : | SetEnv env-variable value |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_env |
CGI ũƮ SSI ȯ溯 Ѵ.
SetEnv SPECIAL_PATH /foo/bin
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | CGI betiklerine ve SSI sayfalarına aktarılan değişkenlere müdahale etmek için kullanılır. |
|---|---|
| Durum: | Temel |
| Modül Betimleyici: | env_module |
| Kaynak Dosyası: | mod_env.c |
Bu modül Apache HTTP Sunucusunun çeşitli modülleri tarafınan kullanılan
dahili ortam değişkenlerime müdahale etmeyi mümkün kılar. bu değişkenler
ayrıca, CGI betiklerine yerel ortam değişkenleri olarak sunulur ve SSI
sayfalarında da kullanılabilir. Ortam değişkenleri
httpd süreci başlatılırken kabuktan aktarılabilir.
Bundan başka, yapılandırma
sürecinde tanımlı veya tanımsız yapılabilirler.
| Açıklama: | Ortam değişkenlerini kabuktan aktarır. |
|---|---|
| Sözdizimi: | PassEnv ortam-değişkeni [ortam-değişkeni]
... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_env |
Dahili ortam değişkenleri olarak kullanılmak üzere sistem ortam
değişkenlerini içeri aktarmak için kullanılır. Bunlar daha sonra Apache
HTTP Sunucusunun modüllerinden kullanılabilir, CGI betiklerine ve SSI
sayfalarında aktarılabilir. Değerler httpd süreci
başlatılırken kabuğun işletim sistemi ortamından gelir.
PassEnv LD_LIBRARY_PATH
| Açıklama: | Ortam değişkenlerini tanımlar. |
|---|---|
| Sözdizimi: | SetEnv ortam-değişkeni [değer] |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_env |
CGI betiklerine ve SSI sayfalarına aktarılmak ve Apache HTTP Sunucusu modüllerinde kullanılmak üzere bir dahili ortam değişkeni tanımlanmasını sağlar.
SetEnv SPECIAL_PATH /foo/bin
Bir değer belirtilmezse değişkene boş dizgi atanır.
Bu yönerge tarafından atanan dahili ortam değişkenleri, en başta
işleme sokulan, ereşem denetimi, URI-dosya ismi eşleştirmesi gibi istek
işleme yönergelerinden sonra işleme sokulur. Eğer atadığınız ortam değişkeni,
bir RewriteRule yönergesindeki
gibi erken işlem aşamalarına girdi sağlıyorsa, bu durumda ortam değişkenini
SetEnvIf ile atamalısınız.
| Açıklama: | Ortamdaki değişkenleri tanımsız hale getirir. |
|---|---|
| Sözdizimi: | UnsetEnv ortam-değişkeni [ortam-değişkeni]
... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_env |
CGI betiklerine ve SSI sayfalarına bir daha aktarılmamak üzere bir dahili ortam değişkenini siler.
UnsetEnv LD_LIBRARY_PATH
Apache HTTP サーバ バージョン 2.4
| 説明: | ユーザの指定した基準に基づいた Expires と
Cache-Control HTTP ヘッダの生成 |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | expires_module |
| ソースファイル: | mod_expires.c |
このモジュールはサーバ応答の Expires HTTP ヘッダ
と Cache-Control ヘッダの max-age ディレクティブの
設定を制御します。元のファイルが作成された時刻または
クライアントのアクセス時刻のどちらかに基づいて期限切れ日を
設定することができます。
これらのヘッダはクライアントに文書の 有効性と継続性を指示します。文書がキャッシュされた場合には、 指定時刻に達するまでは、元の場所から取得する代わりに キャッシュされているものを使うことができます。その後は、 キャッシュにあるコピーは期限切れ (expired) で無効であるとされ、 元の場所から新しいものを取得する必要があります。
max-age 以外 (RFC
2616 section 14.9 参照) の Cache-Control のディレクティブを
操作するには Header ディレクティブを
使うことができます。
ExpiresDefault ディレクティブと
ExpiresByType ディレクティブは
以下のより読み易い構文を使って定義することができます:
ExpiresDefault "<base> [plus] {<num>
<type>}*"
ExpiresByType type/encoding "<base> [plus]
{<num> <type>}*"
<base> は以下のどれかです:
accessnow ('access' と等価)modificationplus キーワードは省略可能です。<num>
は (atoi() が受け付ける) 整数値、
<type> は以下のどれかです:
yearsmonthsweeksdayshoursminutesseconds例えば、以下のディレクティブはどれもデフォルトで文書がアクセスの 1 ヶ月後に 期限が切れるようにするために使えます:
ExpiresDefault "access plus 1 month"
ExpiresDefault "access plus 4 weeks"
ExpiresDefault "access plus 30 days"
期限切れ時刻はいくつか '<num> <type>' 節を追加することでより細かく 制御することができます:
ExpiresByType text/html "access plus 1 month 15
days 2 hours"
ExpiresByType image/gif "modification plus 5 hours 3
minutes"
修正時刻に基づいた設定を使用している場合、Expires ヘッダは ディスクのファイル以外のコンテンツには追加されないことに注意 してください。そのようなコンテンツには修正時刻は存在しないからです。
| 説明: | Expires ヘッダの生成を有効にする |
|---|---|
| 構文: | ExpiresActive On|Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Extension |
| モジュール: | mod_expires |
このディレクティブは対応するドキュメントの領域で
Expires と Cache-Controlヘッダを
有効にするか無効にするかを決めます。
(例えば、.htaccess ファイルではそのディレクトリの
文書のみに適用されるということです。) Off に
設定された場合は対応領域でそれらのヘッダは
生成されません (.htaccess がサーバ設定ファイルの設定を
上書きする、というような下位レベルでの上書きがされていなければ)。
On に設定されていれば、ヘッダは ExpiresByType ディレクティブと
ExpiresDefault ディレクティブ
の基準に従って文書にヘッダを追加します (各ディレクティブ参照)。
このディレクティブは Expires と
Cache-Control ヘッダの存在を
保証するわけではないことに注意してください。基準が満たされて
いない場合はヘッダは追加されず、結果としてこのディレクティブが
指定されていなかったかのようにさえ見えることになります。
| 説明: | MIME タイプによって設定される Expires ヘッダの値 |
|---|---|
| 構文: | ExpiresByType MIME-type
<code>seconds |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Extension |
| モジュール: | mod_expires |
このディレクティブは指定されたタイプのドキュメント
(例えば text/html)
に対して生成される Expires ヘッダと Cache-Control
ヘッダの max-age ディレクティブの値を定義します。
二つ目の引数は期限切れの日時を生成するための基準時刻に追加される
秒数を設定します。Cache-Control:
max-age は期限切れの時刻からリクエスト時刻を引いたものを秒で
表すことで生成されます。
基準時刻はファイルの最終修正時刻か、クライアントのドキュメントへの
アクセス時刻です。どちらを使うべきかは <code>
によって指定します。M は基準時刻として
ファイルの最終修正時刻をという意味で、A はクライアントの
アクセス時刻を使うという意味になります。
効果には微妙な違いがあります。M が使用された場合は、
すべてのキャッシュにある現在のドキュメントキャッシュは同時に期限が
切れます。これは同じ URL に毎週常に置かれる報せのようなものには
非常に有効です。A が使用された場合は、期限切れの
時間は各クライアントよって異なります。これはあまり変更されない
画像ファイルなど、特に関連するドキュメント群がすべて同じ画像を
参照するとき (すなわち画像が比較的短い期間内に繰り返し
アクセスされるとき) に有効です。
# enable expirations
ExpiresActive On
# expire GIF images after a month in the client's cache
ExpiresByType image/gif A2592000
# HTML documents are good for a week from the
# time they were changed
ExpiresByType text/html M604800
このディレクティブは ExpiresActive On が指定されている
ときのみ有効であることに注意してください。これは、
指定された MIME タイプに対してのみ ExpiresDefault ディレクティブで
設定された期限切れ期日を上書きします。
この文書の前の方で説明されている代替構文を 使って期限切れ期日の計算方法を指定することもできます。
| 説明: | 期限切れ期日を計算するデフォルトアルゴリズム |
|---|---|
| 構文: | ExpiresDefault <code>seconds |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Extension |
| モジュール: | mod_expires |
このディレクティブは対応する範囲のすべてのドキュメントに対して
デフォルトの期限切れ期日の計算アルゴリズムを設定します。ExpiresByType ディレクティブによって
タイプ毎に上書きすることができます。引数の構文はそのディレクティブの
説明を参照してください。また、代替構文も
参照してください。
Apache HTTP Server Version 2.4
| : | ڰ ؿ Expires
Cache-Control HTTP Ѵ |
|---|---|
| : | Extension |
| : | expires_module |
| ҽ: | mod_expires.c |
Expires HTTP
Cache-Control HTTP max-age
þ Ѵ. ð
Ȥ Ŭ̾Ʈ ð ִ.
HTTP Ŭ̾Ʈ ȿ Ӽ ˷ش. ð ʾҴٸ, ij ͵ ȴ. ٸ ij "ǰ" ȿ ʴٰ Ͽ, ҽ ; Ѵ.
Header þ
Ͽ max-age ٸ
Cache-Control þ(RFC
2616, 14.9 ) ִ.
ExpiresDefault
ExpiresByType
þ б ִ:
ExpiresDefault "<base> [plus] {<num>
<type>}*"
ExpiresByType type/encoding "<base> [plus]
{<num> <type>}*"
<base> ϳ̴:
accessnow ('access' )modificationplus Ű ȴ. <num>
[atoi() ִ] ̴.
<type> ϳ̴:
yearsmonthsweeksdayshoursminutesseconds, δ ⺻ ӵ 1Ŀ ȴٰ Ѵ:
ExpiresDefault "access plus 1 month"
ExpiresDefault "access plus 4 weeks"
ExpiresDefault "access plus 30 days"
'<num> <type>' ݺؼ Ͽ ð ڼ ִ:
ExpiresByType text/html "access plus 1 month 15
days 2 hours"
ExpiresByType image/gif "modification plus 5 hours 3
minutes"
ð(modification) ð ϴ ũ ִ Ͽ ʴ´ٸ Expires ʴ´. 뿡 ð ̴.
| : | Expires Ѵ |
|---|---|
| : | ExpiresActive On|Off |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Extension |
| : | mod_expires |
þ ش (, .htaccess
Ͽ Ѵٸ 丮 Ʒ ִ 鸸 شȴ.)
Expires Cache-Control
Ѵ. (.htaccess
ܰ迡 ʴ )
Off̸ ش ִ ̵
ʴ´. On̸ ExpiresByType ExpiresDefault þ
(ش ϶) Ģ Ϸ
Ѵ.
þ Expires Cache-Control
ʴ´. Ģ ش ʴٸ ġ
þ ó ʴ´.
| : | MIME type Expires Ѵ |
|---|---|
| : | ExpiresByType MIME-type
<code>seconds |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Extension |
| : | mod_expires |
þ Ư ( ,
text/html) Expires
Cache-Control max-age
þ Ѵ. ι° ƱԸƮ ð Ҷ
ð ʴ Ѵ. Cache-Control:
max-age ð û ð ϰ,
ʴ ǥѴ.
ð ֱ ð Ȥ Ŭ̾Ʈ
ð̴. ̶
<code> ʵ ؾ Ѵ.
M ð ֱ ð
ϰ, A Ŭ̾Ʈ ð Ѵ.
̴ ̹ϴ. M ϸ ij ִ
纻 ð ȴ. URL
ãƺ ִ ְ 뵵 . A
ϸ 纻 ð ٸ. ̴ ʴ
Ͽ, Ư Ҷ (
, ̹ ª Ⱓ ݺؼ ٵȴ),
ϴ.
# Ѵ
ExpiresActive On
# Ŭ̾Ʈ ij GIF Ŀ Ѵ
ExpiresByType image/gif A2592000
# HTML ϰ ȿϴ
ExpiresByType text/html M604800
þ ExpiresActive On Ҷ
ȿ ϶. ExpiresDefault þ
Ͽ Ư MIME type ؼ ð
ִ.
տ ٸ Ͽ ð ִ.
| : | ð ϴ ⺻ ˰ |
|---|---|
| : | ExpiresDefault <code>seconds |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Extension |
| : | mod_expires |
þ ش ִ ð
ϴ ⺻ ˰ Ѵ. ExpiresByType þ
Ͽ ִ. ƱԸƮ
ڼ þ ٸ
϶.
Versión 2.4 del Servidor HTTP Apache
La Guía Rápida de Referencia de Directivas muestra el uso, las opciones por defecto, el estado y el contexto de cada directiva de configuración de Apache. Para más información sobre cada directiva, consulte el Diccionario de Directivas.
La primera columna muestra el nombre y el uso de la directiva. La segunda columna muestra el valor por defecto de la directiva, si existe ese valor por defecto. Si el valor por defecto es demasiado largo para mostrarlo, el primer carácter va seguido de un signo "+".
La tercera y la cuarta columna listan los contextos en los que la directiva puede funcionar y el estado de la directiva de acuerdo con las notas que detallan más abajo.
| A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X |
|
|
| AcceptFilter protocol accept_filter | s | C | |
| Configura mejoras para un Protocolo de Escucha de Sockets | |||
| AcceptPathInfo On|Off|Default | Default | svdh | C |
| Los recursos aceptan información sobre su ruta | |||
| AccessFileName filename [filename] ... | .htaccess | sv | C |
| Nombre del fichero distribuido de configuración | |||
| Action action-type cgi-script [virtual] | svdh | B | |
| Activates a CGI script for a particular handler or content-type | |||
| AddAlt string file [file] ... | svdh | B | |
| Alternate text to display for a file, instead of an icon selected by filename | |||
| AddAltByEncoding string MIME-encoding [MIME-encoding] ... | svdh | B | |
| Alternate text to display for a file instead of an icon selected by MIME-encoding | |||
| AddAltByType string MIME-type [MIME-type] ... | svdh | B | |
| Alternate text to display for a file, instead of an icon selected by MIME content-type | |||
| AddCharset charset extension [extension] ... | svdh | B | |
| Maps the given filename extensions to the specified content charset | |||
| AddDefaultCharset On|Off|charset | Off | svdh | C |
Default charset parameter to be added when a response
content-type is text/plain or text/html | |||
| AddDescription string file [file] ... | svdh | B | |
| Description to display for a file | |||
| AddEncoding encoding extension [extension] ... | svdh | B | |
| Maps the given filename extensions to the specified encoding type | |||
| AddHandler handler-name extension [extension] ... | svdh | B | |
| Maps the filename extensions to the specified handler | |||
| AddIcon icon name [name] ... | svdh | B | |
| Icon to display for a file selected by name | |||
| AddIconByEncoding icon MIME-encoding [MIME-encoding] ... | svdh | B | |
| Icon to display next to files selected by MIME content-encoding | |||
| AddIconByType icon MIME-type [MIME-type] ... | svdh | B | |
| Icon to display next to files selected by MIME content-type | |||
| AddInputFilter filter[;filter...] extension [extension] ... | svdh | B | |
| Maps filename extensions to the filters that will process client requests | |||
| AddLanguage language-tag extension [extension] ... | svdh | B | |
| Maps the given filename extension to the specified content language | |||
| AddModuleInfo module-name string | sv | E | |
| Adds additional information to the module information displayed by the server-info handler | |||
| AddOutputFilter filter[;filter...] extension [extension] ... | svdh | B | |
| Maps filename extensions to the filters that will process responses from the server | |||
| AddOutputFilterByType filter[;filter...] media-type [media-type] ... | svdh | B | |
| assigns an output filter to a particular media-type | |||
| AddType media-type extension [extension] ... | svdh | B | |
| Maps the given filename extensions onto the specified content type | |||
| Alias [URL-path] file-path|directory-path | svd | B | |
| Maps URLs to filesystem locations | |||
| AliasMatch regex file-path|directory-path | sv | B | |
| Maps URLs to filesystem locations using regular expressions | |||
| AliasPreservePath OFF|ON | OFF | svd | B |
| Map the full path after the alias in a location. | |||
| Allow from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts can access an area of the server | |||
| AllowCONNECT port[-port] [port[-port]] ... | 443 563 | sv | E |
Ports that are allowed to CONNECT through the
proxy | |||
| AllowEncodedSlashes On|Off | Off | sv | C |
| Determines whether encoded path separators in URLs are allowed to be passed through | |||
| AllowMethods reset|HTTP-method [HTTP-method]... | reset | d | X |
| Restrict access to the listed HTTP methods | |||
| AllowOverride All|None|directive-type [directive-type] ... | None (2.3.9 and lat + | d | C |
Types of directives that are allowed in
.htaccess files | |||
| AllowOverrideList None|directive [directive-type] ... | None | d | C |
Individual directives that are allowed in
.htaccess files | |||
| Anonymous user [user] ... | dh | E | |
| Specifies userIDs that are allowed access without password verification | |||
| Anonymous_LogEmail On|Off | On | dh | E |
| Sets whether the password entered will be logged in the error log | |||
| Anonymous_MustGiveEmail On|Off | On | dh | E |
| Specifies whether blank passwords are allowed | |||
| Anonymous_NoUserID On|Off | Off | dh | E |
| Sets whether the userID field may be empty | |||
| Anonymous_VerifyEmail On|Off | Off | dh | E |
| Sets whether to check the password field for a correctly formatted email address | |||
| AsyncRequestWorkerFactor factor | s | M | |
| Limit concurrent connections per process | |||
| AuthBasicAuthoritative On|Off | On | dh | B |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthBasicFake off|username [password] | dh | B | |
| Fake basic authentication using the given expressions for username and password | |||
| AuthBasicProvider provider-name [provider-name] ... | file | dh | B |
| Sets the authentication provider(s) for this location | |||
| AuthBasicUseDigestAlgorithm MD5|Off | Off | dh | B |
| Check passwords against the authentication providers as if Digest Authentication was in force instead of Basic Authentication. | |||
| AuthDBDUserPWQuery query | d | E | |
| SQL query to look up a password for a user | |||
| AuthDBDUserRealmQuery query | d | E | |
| SQL query to look up a password hash for a user and realm. | |||
| AuthDBMGroupFile file-path | dh | E | |
| Sets the name of the database file containing the list of user groups for authorization | |||
| AuthDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Sets the type of database file that is used to store passwords | |||
| AuthDBMUserFile file-path | dh | E | |
| Sets the name of a database file containing the list of users and passwords for authentication | |||
| AuthDigestAlgorithm MD5|MD5-sess | MD5 | dh | E |
| Selects the algorithm used to calculate the challenge and response hashes in digest authentication | |||
| AuthDigestDomain URI [URI] ... | dh | E | |
| URIs that are in the same protection space for digest authentication | |||
| AuthDigestNonceLifetime seconds | 300 | dh | E |
| How long the server nonce is valid | |||
| AuthDigestProvider provider-name [provider-name] ... | file | dh | E |
| Sets the authentication provider(s) for this location | |||
| AuthDigestQop none|auth|auth-int [auth|auth-int] | auth | dh | E |
| Determines the quality-of-protection to use in digest authentication | |||
| AuthDigestShmemSize size | 1000 | s | E |
| The amount of shared memory to allocate for keeping track of clients | |||
| AuthFormAuthoritative On|Off | On | dh | B |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthFormBody fieldname | httpd_body | d | B |
| The name of a form field carrying the body of the request to attempt on successful login | |||
| AuthFormDisableNoStore On|Off | Off | d | B |
| Disable the CacheControl no-store header on the login page | |||
| AuthFormFakeBasicAuth On|Off | Off | d | B |
| Fake a Basic Authentication header | |||
| AuthFormLocation fieldname | httpd_location | d | B |
| The name of a form field carrying a URL to redirect to on successful login | |||
| AuthFormLoginRequiredLocation url | d | B | |
| The URL of the page to be redirected to should login be required | |||
| AuthFormLoginSuccessLocation url | d | B | |
| The URL of the page to be redirected to should login be successful | |||
| AuthFormLogoutLocation uri | d | B | |
| The URL to redirect to after a user has logged out | |||
| AuthFormMethod fieldname | httpd_method | d | B |
| The name of a form field carrying the method of the request to attempt on successful login | |||
| AuthFormMimetype fieldname | httpd_mimetype | d | B |
| The name of a form field carrying the mimetype of the body of the request to attempt on successful login | |||
| AuthFormPassword fieldname | httpd_password | d | B |
| The name of a form field carrying the login password | |||
| AuthFormProvider provider-name [provider-name] ... | file | dh | B |
| Sets the authentication provider(s) for this location | |||
| AuthFormSitePassphrase secret | d | B | |
| Bypass authentication checks for high traffic sites | |||
| AuthFormSize size | 8192 | d | B |
| The largest size of the form in bytes that will be parsed for the login details | |||
| AuthFormUsername fieldname | httpd_username | d | B |
| The name of a form field carrying the login username | |||
| AuthGroupFile file-path | dh | B | |
| Sets the name of a text file containing the list of user groups for authorization | |||
| AuthLDAPAuthorizePrefix prefix | AUTHORIZE_ | dh | E |
| Specifies the prefix for environment variables set during authorization | |||
| AuthLDAPBindAuthoritative off|on | on | dh | E |
| Determines if other authentication providers are used when a user can be mapped to a DN but the server cannot successfully bind with the user's credentials. | |||
| AuthLDAPBindDN distinguished-name | dh | E | |
| Optional DN to use in binding to the LDAP server | |||
| AuthLDAPBindPassword password | dh | E | |
| Password used in conjunction with the bind DN | |||
| AuthLDAPCharsetConfig file-path | s | E | |
| Language to charset conversion configuration file | |||
| AuthLDAPCompareAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization comparisons | |||
| AuthLDAPCompareDNOnServer on|off | on | dh | E |
| Use the LDAP server to compare the DNs | |||
| AuthLDAPDereferenceAliases never|searching|finding|always | always | dh | E |
| When will the module de-reference aliases | |||
| AuthLDAPGroupAttribute attribute | member uniqueMember + | dh | E |
| LDAP attributes used to identify the user members of groups. | |||
| AuthLDAPGroupAttributeIsDN on|off | on | dh | E |
| Use the DN of the client username when checking for group membership | |||
| AuthLDAPInitialBindAsUser off|on | off | dh | E |
| Determines if the server does the initial DN lookup using the basic authentication users' own username, instead of anonymously or with hard-coded credentials for the server | |||
| AuthLDAPInitialBindPattern regex substitution | (.*) $1 (remote use + | dh | E |
| Specifies the transformation of the basic authentication username to be used when binding to the LDAP server to perform a DN lookup | |||
| AuthLDAPMaxSubGroupDepth Number | 10 | dh | E |
| Specifies the maximum sub-group nesting depth that will be evaluated before the user search is discontinued. | |||
| AuthLDAPRemoteUserAttribute uid | dh | E | |
| Use the value of the attribute returned during the user query to set the REMOTE_USER environment variable | |||
| AuthLDAPRemoteUserIsDN on|off | off | dh | E |
| Use the DN of the client username to set the REMOTE_USER environment variable | |||
| AuthLDAPSearchAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization searches | |||
| AuthLDAPSubGroupAttribute attribute | member uniqueMember + | dh | E |
| Specifies the attribute labels, one value per directive line, used to distinguish the members of the current group that are groups. | |||
| AuthLDAPSubGroupClass LdapObjectClass | groupOfNames groupO + | dh | E |
| Specifies which LDAP objectClass values identify directory objects that are groups during sub-group processing. | |||
| AuthLDAPURL url [NONE|SSL|TLS|STARTTLS] | dh | E | |
| URL specifying the LDAP search parameters | |||
| AuthMerging Off | And | Or | Off | dh | B |
| Controls the manner in which each configuration section's authorization logic is combined with that of preceding configuration sections. | |||
| AuthName auth-domain | dh | B | |
| Authorization realm for use in HTTP authentication | |||
| AuthnCacheContext directory|server|custom-string | directory | d | B |
| Specify a context string for use in the cache key | |||
| AuthnCacheEnable | s | B | |
| Enable Authn caching configured anywhere | |||
| AuthnCacheProvideFor authn-provider [...] | dh | B | |
| Specify which authn provider(s) to cache for | |||
| AuthnCacheSOCache provider-name[:provider-args] | s | B | |
| Select socache backend provider to use | |||
| AuthnCacheTimeout timeout (seconds) | 300 (5 minutes) | dh | B |
| Set a timeout for cache entries | |||
| <AuthnProviderAlias baseProvider Alias> ... </AuthnProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authentication provider and referenced by the specified alias | |||
AuthnzFcgiCheckAuthnProvider provider-name|None
option ... | d | E | |
| Enables a FastCGI application to handle the check_authn authentication hook. | |||
| AuthnzFcgiDefineProvider type provider-name backend-address | s | E | |
| Defines a FastCGI application as a provider for authentication and/or authorization | |||
| AuthType None|Basic|Digest|Form | dh | B | |
| Type of user authentication | |||
| AuthUserFile file-path | dh | B | |
| Sets the name of a text file containing the list of users and passwords for authentication | |||
| AuthzDBDLoginToReferer On|Off | Off | d | E |
Determines whether to redirect the Client to the Referring
page on successful login or logout if a Referer request
header is present | |||
| AuthzDBDQuery query | d | E | |
| Specify the SQL Query for the required operation | |||
| AuthzDBDRedirectQuery query | d | E | |
| Specify a query to look up a login page for the user | |||
| AuthzDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Sets the type of database file that is used to store list of user groups | |||
| <AuthzProviderAlias baseProvider Alias Require-Parameters> ... </AuthzProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authorization provider and referenced by the specified alias | |||
| AuthzSendForbiddenOnFailure On|Off | Off | dh | B |
| Send '403 FORBIDDEN' instead of '401 UNAUTHORIZED' if authentication succeeds but authorization fails | |||
| BalancerGrowth # | 5 | sv | E |
| Number of additional Balancers that can be added Post-configuration | |||
| BalancerInherit On|Off | On | sv | E |
| Inherit ProxyPassed Balancers/Workers from the main server | |||
| BalancerMember [balancerurl] url [key=value [key=value ...]] | d | E | |
| Add a member to a load balancing group | |||
| BalancerPersist On|Off | Off | sv | E |
| Attempt to persist changes made by the Balancer Manager across restarts. | |||
| BrotliAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| BrotliCompressionMaxInputBlock value | sv | E | |
| Maximum input block size | |||
| BrotliCompressionQuality value | 5 | sv | E |
| Compression quality | |||
| BrotliCompressionWindow value | 18 | sv | E |
| Brotli sliding compression window size | |||
| BrotliFilterNote [type] notename | sv | E | |
| Places the compression ratio in a note for logging | |||
| BrowserMatch regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables conditional on HTTP User-Agent | |||
| BrowserMatchNoCase regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables conditional on User-Agent without respect to case | |||
| BufferedLogs On|Off | Off | s | B |
| Buffer log entries in memory before writing to disk | |||
| BufferSize integer | 131072 | svdh | E |
| Maximum size in bytes to buffer by the buffer filter | |||
| CacheDefaultExpire seconds | 3600 (one hour) | svdh | E |
| The default duration to cache a document when no expiry date is specified. | |||
| CacheDetailHeader on|off | off | svdh | E |
| Add an X-Cache-Detail header to the response. | |||
| CacheDirLength length | 2 | sv | E |
| The number of characters in subdirectory names | |||
| CacheDirLevels levels | 2 | sv | E |
| The number of levels of subdirectories in the cache. | |||
| CacheDisable url-string | on | svdh | E | |
| Disable caching of specified URLs | |||
| CacheEnable cache_type [url-string] | svd | E | |
| Enable caching of specified URLs using a specified storage manager | |||
| CacheFile file-path [file-path] ... | s | X | |
| Cache a list of file handles at startup time | |||
| CacheHeader on|off | off | svdh | E |
| Add an X-Cache header to the response. | |||
| CacheIgnoreCacheControl On|Off | Off | sv | E |
| Ignore request to not serve cached content to client | |||
| CacheIgnoreHeaders header-string [header-string] ... | None | sv | E |
| Do not store the given HTTP header(s) in the cache. | |||
| CacheIgnoreNoLastMod On|Off | Off | svdh | E |
| Ignore the fact that a response has no Last Modified header. | |||
| CacheIgnoreQueryString On|Off | Off | sv | E |
| Ignore query string when caching | |||
| CacheIgnoreURLSessionIdentifiers identifier [identifier] ... | None | sv | E |
| Ignore defined session identifiers encoded in the URL when caching | |||
| CacheKeyBaseURL URL | sv | E | |
| Override the base URL of reverse proxied cache keys. | |||
| CacheLastModifiedFactor float | 0.1 | svdh | E |
| The factor used to compute an expiry date based on the LastModified date. | |||
| CacheLock on|off | off | sv | E |
| Enable the thundering herd lock. | |||
| CacheLockMaxAge integer | 5 | sv | E |
| Set the maximum possible age of a cache lock. | |||
| CacheLockPath directory | /tmp/mod_cache-lock + | sv | E |
| Set the lock path directory. | |||
| CacheMaxExpire seconds | 86400 (one day) | svdh | E |
| The maximum time in seconds to cache a document | |||
| CacheMaxFileSize bytes | 1000000 | svdh | E |
| The maximum size (in bytes) of a document to be placed in the cache | |||
| CacheMinExpire seconds | 0 | svdh | E |
| The minimum time in seconds to cache a document | |||
| CacheMinFileSize bytes | 1 | svdh | E |
| The minimum size (in bytes) of a document to be placed in the cache | |||
| CacheNegotiatedDocs On|Off | Off | sv | B |
| Allows content-negotiated documents to be cached by proxy servers | |||
| CacheQuickHandler on|off | on | sv | E |
| Run the cache from the quick handler. | |||
| CacheReadSize bytes | 0 | svdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheReadTime milliseconds | 0 | svdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheRoot directory | sv | E | |
| The directory root under which cache files are stored | |||
| CacheSocache type[:args] | sv | E | |
| The shared object cache implementation to use | |||
| CacheSocacheMaxSize bytes | 102400 | svdh | E |
| The maximum size (in bytes) of an entry to be placed in the cache | |||
| CacheSocacheMaxTime seconds | 86400 | svdh | E |
| The maximum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheMinTime seconds | 600 | svdh | E |
| The minimum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheReadSize bytes | 0 | svdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheSocacheReadTime milliseconds | 0 | svdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheStaleOnError on|off | on | svdh | E |
| Serve stale content in place of 5xx responses. | |||
| CacheStoreExpired On|Off | Off | svdh | E |
| Attempt to cache responses that the server reports as expired | |||
| CacheStoreNoStore On|Off | Off | svdh | E |
| Attempt to cache requests or responses that have been marked as no-store. | |||
| CacheStorePrivate On|Off | Off | svdh | E |
| Attempt to cache responses that the server has marked as private | |||
| CGIDScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIMapExtension cgi-path .extension | dh | C | |
| Technique for locating the interpreter for CGI scripts | |||
| CGIPassAuth On|Off | Off | dh | C |
| Enables passing HTTP authorization headers to scripts as CGI variables | |||
| CGIScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIVar variable rule | dh | C | |
| Controls how some CGI variables are set | |||
| CharsetDefault charset | svdh | E | |
| Charset to translate into | |||
| CharsetOptions option [option] ... | ImplicitAdd | svdh | E |
| Configures charset translation behavior | |||
| CharsetSourceEnc charset | svdh | E | |
| Source charset of files | |||
| CheckBasenameMatch on|off | On | svdh | E |
| Also match files with differing file name extensions. | |||
| CheckCaseOnly on|off | Off | svdh | E |
| Limits the action of the speling module to case corrections | |||
| CheckSpelling on|off | Off | svdh | E |
| Enables the spelling module | |||
| ChrootDir /path/to/directory | s | B | |
| Directory for apache to run chroot(8) after startup. | |||
| ContentDigest On|Off | Off | svdh | C |
Enables the generation of Content-MD5 HTTP Response
headers | |||
| CookieDomain domain | svdh | E | |
| The domain to which the tracking cookie applies | |||
| CookieExpires expiry-period | svdh | E | |
| Expiry time for the tracking cookie | |||
| CookieHTTPOnly on|off | off | svdh | E |
| Adds the 'HTTPOnly' attribute to the cookie | |||
| CookieName token | Apache | svdh | E |
| Name of the tracking cookie | |||
| CookieSameSite None|Lax|Strict | svdh | E | |
| Adds the 'SameSite' attribute to the cookie | |||
| CookieSecure on|off | off | svdh | E |
| Adds the 'Secure' attribute to the cookie | |||
| CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965 | Netscape | svdh | E |
| Format of the cookie header field | |||
| CookieTracking on|off | off | svdh | E |
| Enables tracking cookie | |||
| CoreDumpDirectory directory | s | M | |
| Directory where Apache HTTP Server attempts to switch before dumping core | |||
| CustomLog file|pipe format|nickname [env=[!]environment-variable| expr=expression] | sv | B | |
| Sets filename and format of log file | |||
| Dav On|Off|provider-name | Off | d | E |
| Enable WebDAV HTTP methods | |||
| DavBasePath root-path | d | E | |
| Configure repository root path | |||
| DavDepthInfinity on|off | off | svd | E |
| Allow PROPFIND, Depth: Infinity requests | |||
| DavGenericLockDB file-path | svd | E | |
| Location of the DAV lock database | |||
| DavLockDB file-path | sv | E | |
| Location of the DAV lock database | |||
| DavLockDiscovery on|off | on | svdh | E |
| Enable lock discovery | |||
| DavMinTimeout seconds | 0 | svd | E |
| Minimum amount of time the server holds a lock on a DAV resource | |||
| DBDExptime time-in-seconds | 300 | sv | E |
| Keepalive time for idle connections | |||
| DBDInitSQL "SQL statement" | sv | E | |
| Execute an SQL statement after connecting to a database | |||
| DBDKeep number | 2 | sv | E |
| Maximum sustained number of connections | |||
| DBDMax number | 10 | sv | E |
| Maximum number of connections | |||
| DBDMin number | 1 | sv | E |
| Minimum number of connections | |||
| DBDParams param1=value1[,param2=value2] | sv | E | |
| Parameters for database connection | |||
| DBDPersist On|Off | sv | E | |
| Whether to use persistent connections | |||
| DBDPrepareSQL "SQL statement" label | sv | E | |
| Define an SQL prepared statement | |||
| DBDriver name | sv | E | |
| Specify an SQL driver | |||
| DefaultIcon url-path | svdh | B | |
| Icon to display for files when no specific icon is configured | |||
| DefaultLanguage language-tag | svdh | B | |
| Defines a default language-tag to be sent in the Content-Language header field for all resources in the current context that have not been assigned a language-tag by some other means. | |||
| DefaultRuntimeDir directory-path | DEFAULT_REL_RUNTIME + | s | C |
| Base directory for the server run-time files | |||
| DefaultType media-type|none | none | svdh | C |
This directive has no effect other than to emit warnings
if the value is not none. In prior versions, DefaultType
would specify a default media type to assign to response content for
which no other media type configuration could be found.
| |||
| Define parameter-name | s | C | |
| Define the existence of a variable | |||
| DeflateAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| DeflateBufferSize value | 8096 | sv | E |
| Fragment size to be compressed at one time by zlib | |||
| DeflateCompressionLevel value | sv | E | |
| How much compression do we apply to the output | |||
| DeflateFilterNote [type] notename | sv | E | |
| Places the compression ratio in a note for logging | |||
| DeflateInflateLimitRequestBody value | svdh | E | |
| Maximum size of inflated request bodies | |||
| DeflateInflateRatioBurst value | 3 | svdh | E |
| Maximum number of times the inflation ratio for request bodies can be crossed | |||
| DeflateInflateRatioLimit value | 200 | svdh | E |
| Maximum inflation ratio for request bodies | |||
| DeflateMemLevel value | 9 | sv | E |
| How much memory should be used by zlib for compression | |||
| DeflateWindowSize value | 15 | sv | E |
| Zlib compression window size | |||
| Deny from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts are denied access to the server | |||
| <Directory directory-path> ... </Directory> | sv | C | |
| Enclose a group of directives that apply only to the named file-system directory, sub-directories, and their contents. | |||
| DirectoryCheckHandler On|Off | Off | svdh | B |
| Toggle how this module responds when another handler is configured | |||
| DirectoryIndex disabled | local-url [local-url] ... | index.html | svdh | B |
| List of resources to look for when the client requests a directory | |||
| DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-code | off | svdh | B |
| Configures an external redirect for directory indexes. | |||
| <DirectoryMatch regex> ... </DirectoryMatch> | sv | C | |
| Enclose directives that apply to the contents of file-system directories matching a regular expression. | |||
| DirectorySlash On|Off | On | svdh | B |
| Toggle trailing slash redirects on or off | |||
| DocumentRoot directory-path | /usr/local/apache/h + | sv | C |
| Directory that forms the main document tree visible from the web | |||
| DTracePrivileges On|Off | Off | s | X |
| Determines whether the privileges required by dtrace are enabled. | |||
| DumpIOInput On|Off | Off | s | E |
| Dump all input data to the error log | |||
| DumpIOOutput On|Off | Off | s | E |
| Dump all output data to the error log | |||
| <Else> ... </Else> | svdh | C | |
Contains directives that apply only if the condition of a
previous <If> or
<ElseIf> section is not
satisfied by a request at runtime | |||
| <ElseIf expression> ... </ElseIf> | svdh | C | |
Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
<If> or
<ElseIf> section is not
satisfied | |||
| EnableExceptionHook On|Off | Off | s | M |
| Enables a hook that runs exception handlers after a crash | |||
| EnableMMAP On|Off | On | svdh | C |
| Use memory-mapping to read files during delivery | |||
| EnableSendfile On|Off | Off | svdh | C |
| Use the kernel sendfile support to deliver files to the client | |||
| Error message | svdh | C | |
| Abort configuration parsing with a custom error message | |||
| ErrorDocument error-code document | svdh | C | |
| What the server will return to the client in case of an error | |||
| ErrorLog file-path|syslog[:facility] | logs/error_log (Uni + | sv | C |
| Location where the server will log errors | |||
| ErrorLog [connection|request] format | sv | C | |
| Format specification for error log entries | |||
| Example | svdh | X | |
| Demonstration directive to illustrate the Apache module API | |||
| ExpiresActive On|Off | Off | svdh | E |
Enables generation of Expires
headers | |||
| ExpiresByType MIME-type <code>seconds | svdh | E | |
Value of the Expires header configured
by MIME type | |||
| ExpiresDefault <code>seconds | svdh | E | |
| Default algorithm for calculating expiration time | |||
| ExtendedStatus On|Off | Off[*] | s | C |
| Keep track of extended status information for each request | |||
| ExtFilterDefine filtername parameters | s | E | |
| Define an external filter | |||
| ExtFilterOptions option [option] ... | NoLogStderr | d | E |
Configure mod_ext_filter options | |||
| FallbackResource disabled | local-url | svdh | B | |
| Define a default URL for requests that don't map to a file | |||
| FileETag component ... | INode MTime Size | svdh | C |
| File attributes used to create the ETag HTTP response header for static files | |||
| <Files filename> ... </Files> | svdh | C | |
| Contains directives that apply to matched filenames | |||
| <FilesMatch regex> ... </FilesMatch> | svdh | C | |
| Contains directives that apply to regular-expression matched filenames | |||
| FilterChain [+=-@!]filter-name ... | svdh | B | |
| Configure the filter chain | |||
| FilterDeclare filter-name [type] | svdh | B | |
| Declare a smart filter | |||
| FilterProtocol filter-name [provider-name] proto-flags | svdh | B | |
| Deal with correct HTTP protocol handling | |||
| FilterProvider filter-name provider-name expression | svdh | B | |
| Register a content filter | |||
| FilterTrace filter-name level | svd | B | |
Get debug/diagnostic information from
mod_filter | |||
| FlushMaxPipelined number | 5 | sv | C |
| Maximum number of pipelined responses above which they are flushed to the network | |||
| FlushMaxThreshold number-of-bytes | 65535 | sv | C |
| Threshold above which pending data are flushed to the network | |||
| ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] | Prefer | svdh | B |
| Action to take if a single acceptable document is not found | |||
| ForceType media-type|None | dh | C | |
| Forces all matching files to be served with the specified media type in the HTTP Content-Type header field | |||
| ForensicLog filename|pipe | sv | E | |
| Sets filename of the forensic log | |||
| GlobalLogfile|pipe format|nickname [env=[!]environment-variable| expr=expression] | s | B | |
| Sets filename and format of log file | |||
| GprofDir /tmp/gprof/|/tmp/gprof/% | sv | C | |
| Directory to write gmon.out profiling data to. | |||
| GracefulShutdownTimeout seconds | 0 | s | M |
| Specify a timeout after which a gracefully shutdown server will exit. | |||
| Group unix-group | #-1 | s | B |
| Group under which the server will answer requests | |||
| H2CopyFiles on|off | off | svdh | E |
| Determine file handling in responses | |||
| H2Direct on|off | on for h2c, off for + | sv | E |
| H2 Direct Protocol Switch | |||
| H2EarlyHint name value | svdh | E | |
| Add a response header to be picked up in 103 Early Hints | |||
| H2EarlyHints on|off | off | sv | E |
| Determine sending of 103 status codes | |||
| H2MaxDataFrameLen n | 0 | sv | E |
| Maximum bytes inside a single HTTP/2 DATA frame | |||
| H2MaxHeaderBlockLen n | 0 | sv | E |
| Maximum size of response headers | |||
| H2MaxSessionStreams n | 100 | sv | E |
| Maximum number of active streams per HTTP/2 session. | |||
| H2MaxWorkerIdleSeconds n | 600 | s | E |
| Maximum number of seconds h2 workers remain idle until shut down. | |||
| H2MaxWorkers n | s | E | |
| Maximum number of worker threads to use per child process. | |||
| H2MinWorkers n | s | E | |
| Minimal number of worker threads to use per child process. | |||
| H2ModernTLSOnly on|off | on | sv | E |
| Require HTTP/2 connections to be "modern TLS" only | |||
| H2OutputBuffering on|off | on | sv | E |
| Determine buffering behaviour of output | |||
| H2Padding numbits | 0 | sv | E |
| Determine the range of padding bytes added to payload frames | |||
| H2ProxyRequests on|off | off | sv | E |
| En-/Disable forward proxy requests via HTTP/2 | |||
| H2Push on|off | on | svdh | E |
| H2 Server Push Switch | |||
| H2PushDiarySize n | 256 | sv | E |
| H2 Server Push Diary Size | |||
| H2PushPriority mime-type [after|before|interleaved] [weight] | * After 16 | sv | E |
| H2 Server Push Priority | |||
| H2PushResource [add] path [critical] | svdh | E | |
| Declares resources for early pushing to the client | |||
| H2SerializeHeaders on|off | off | sv | E |
| Serialize Request/Response Processing Switch | |||
| H2StreamMaxMemSize bytes | 65536 | sv | E |
| Maximum amount of output data buffered per stream. | |||
| H2StreamTimeout time-interval[s] | svd | E | |
| Maximum time waiting when sending/receiving data to stream processing | |||
| H2TLSCoolDownSecs seconds | 1 | sv | E |
| Configure the number of seconds of idle time on TLS before shrinking writes | |||
| H2TLSWarmUpSize amount | 1048576 | sv | E |
| Configure the number of bytes on TLS connection before doing max writes | |||
| H2Upgrade on|off | on for h2c, off for + | svdh | E |
| H2 Upgrade Protocol Switch | |||
| H2WebSockets on|off | off | sv | E |
| En-/Disable WebSockets via HTTP/2 | |||
| H2WindowSize bytes | 65535 | sv | E |
| Size of Stream Window for upstream data. | |||
| Header [condition] add|append|echo|edit|edit*|merge|set|setifempty|unset|note header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] | svdh | E | |
| Configure HTTP response headers | |||
| HeaderName filename | svdh | B | |
| Name of the file that will be inserted at the top of the index listing | |||
| HeartbeatAddress addr:port | s | X | |
| Multicast address for heartbeat packets | |||
| HeartbeatListen addr:port | s | X | |
| multicast address to listen for incoming heartbeat requests | |||
| HeartbeatMaxServers number-of-servers | 10 | s | X |
| Specifies the maximum number of servers that will be sending heartbeat requests to this server | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to store heartbeat data when using flat-file storage | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to read heartbeat data | |||
| HostnameLookups On|Off|Double | Off | svd | C |
| Enables DNS lookups on client IP addresses | |||
| HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods] [Allow0.9|Require1.0] | Strict LenientMetho + | sv | C |
| Modify restrictions on HTTP Request Messages | |||
| IdentityCheck On|Off | Off | svd | E |
| Enables logging of the RFC 1413 identity of the remote user | |||
| IdentityCheckTimeout seconds | 30 | svd | E |
| Determines the timeout duration for ident requests | |||
| <If expression> ... </If> | svdh | C | |
| Contains directives that apply only if a condition is satisfied by a request at runtime | |||
| <IfDefine [!]parameter-name> ... </IfDefine> | svdh | C | |
| Encloses directives that will be processed only if a test is true at startup | |||
| <IfDirective [!]directive-name> ... </IfDirective> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific directive | |||
| <IfFile [!]filename> ... </IfFile> | svdh | C | |
| Encloses directives that will be processed only if file exists at startup | |||
| <IfModule [!]module-file|module-identifier> ... </IfModule> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific module | |||
| <IfSection [!]section-name> ... </IfSection> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific section directive | |||
| <IfVersion [[!]operator] version> ... </IfVersion> | svdh | E | |
| contains version dependent configuration | |||
| ImapBase map|referer|URL | http://servername/ | svdh | B |
Default base for imagemap files | |||
| ImapDefault error|nocontent|map|referer|URL | nocontent | svdh | B |
| Default action when an imagemap is called with coordinates that are not explicitly mapped | |||
| ImapMenu none|formatted|semiformatted|unformatted | formatted | svdh | B |
| Action if no coordinates are given when calling an imagemap | |||
| Include [optional|strict] file-path|directory-path|wildcard | svd | C | |
| Includes other configuration files from within the server configuration files | |||
| IncludeOptional file-path|directory-path|wildcard | svd | C | |
| Includes other configuration files from within the server configuration files | |||
| IndexHeadInsert "markup ..." | svdh | B | |
| Inserts text in the HEAD section of an index page. | |||
| IndexIgnore file [file] ... | "." | svdh | B |
| Adds to the list of files to hide when listing a directory | |||
| IndexIgnoreReset ON|OFF | svdh | B | |
| Empties the list of files to hide when listing a directory | |||
| IndexOptions [+|-]option [[+|-]option] ... | svdh | B | |
| Various configuration settings for directory indexing | |||
| IndexOrderDefault Ascending|Descending Name|Date|Size|Description | Ascending Name | svdh | B |
| Sets the default ordering of the directory index | |||
| IndexStyleSheet url-path | svdh | B | |
| Adds a CSS stylesheet to the directory index | |||
| InputSed sed-command | dh | X | |
Sed command to filter request data (typically POST data) | |||
| ISAPIAppendLogToErrors on|off | off | svdh | B |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the error log | |||
| ISAPIAppendLogToQuery on|off | on | svdh | B |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the query field | |||
| ISAPICacheFile file-path [file-path] ... | sv | B | |
| ISAPI .dll files to be loaded at startup | |||
| ISAPIFakeAsync on|off | off | svdh | B |
| Fake asynchronous support for ISAPI callbacks | |||
| ISAPILogNotSupported on|off | off | svdh | B |
| Log unsupported feature requests from ISAPI extensions | |||
| ISAPIReadAheadBuffer size | 49152 | svdh | B |
| Size of the Read Ahead Buffer sent to ISAPI extensions | |||
| KeepAlive On|Off | On | sv | C |
| Enables HTTP persistent connections | |||
| KeepAliveTimeout num[ms] | 5 | sv | C |
| Amount of time the server will wait for subsequent requests on a persistent connection | |||
| KeptBodySize maximum size in bytes | 0 | d | B |
| Keep the request body instead of discarding it up to the specified maximum size, for potential use by filters such as mod_include. | |||
| LanguagePriority MIME-lang [MIME-lang] ... | svdh | B | |
| The precedence of language variants for cases where the client does not express a preference | |||
| LDAPCacheEntries number | 1024 | s | E |
| Maximum number of entries in the primary LDAP cache | |||
| LDAPCacheTTL seconds | 600 | s | E |
| Time that cached items remain valid | |||
| LDAPConnectionPoolTTL n | -1 | sv | E |
| Discard backend connections that have been sitting in the connection pool too long | |||
| LDAPConnectionTimeout seconds | s | E | |
| Specifies the socket connection timeout in seconds | |||
| LDAPLibraryDebug 7 | s | E | |
| Enable debugging in the LDAP SDK | |||
| LDAPOpCacheEntries number | 1024 | s | E |
| Number of entries used to cache LDAP compare operations | |||
| LDAPOpCacheTTL seconds | 600 | s | E |
| Time that entries in the operation cache remain valid | |||
| LDAPReferralHopLimit number | dh | E | |
| The maximum number of referral hops to chase before terminating an LDAP query. | |||
| LDAPReferrals On|Off|default | On | dh | E |
| Enable referral chasing during queries to the LDAP server. | |||
| LDAPRetries number-of-retries | 3 | s | E |
| Configures the number of LDAP server retries. | |||
| LDAPRetryDelay seconds | 0 | s | E |
| Configures the delay between LDAP server retries. | |||
| LDAPSharedCacheFile directory-path/filename | s | E | |
| Sets the shared memory cache file | |||
| LDAPSharedCacheSize bytes | 500000 | s | E |
| Size in bytes of the shared-memory cache | |||
| LDAPTimeout seconds | 60 | s | E |
| Specifies the timeout for LDAP search and bind operations, in seconds | |||
| LDAPTrustedClientCert type directory-path/filename/nickname [password] | dh | E | |
| Sets the file containing or nickname referring to a per connection client certificate. Not all LDAP toolkits support per connection client certificates. | |||
| LDAPTrustedGlobalCert type directory-path/filename [password] | s | E | |
| Sets the file or database containing global trusted Certificate Authority or global client certificates | |||
| LDAPTrustedMode type | sv | E | |
| Specifies the SSL/TLS mode to be used when connecting to an LDAP server. | |||
| LDAPVerifyServerCert On|Off | On | s | E |
| Force server certificate verification | |||
| <Limit method [method] ... > ... </Limit> | dh | C | |
| Restrict enclosed access controls to only certain HTTP methods | |||
| <LimitExcept method [method] ... > ... </LimitExcept> | dh | C | |
| Restrict access controls to all HTTP methods except the named ones | |||
| LimitInternalRecursion number [number] | 10 | sv | C |
| Determine maximum number of internal redirects and nested subrequests | |||
| LimitRequestBody bytes | 0 | svdh | C |
| Restricts the total size of the HTTP request body sent from the client | |||
| LimitRequestFields number | 100 | sv | C |
| Limits the number of HTTP request header fields that will be accepted from the client | |||
| LimitRequestFieldSize bytes | 8190 | sv | C |
| Limits the size of the HTTP request header allowed from the client | |||
| LimitRequestLine bytes | 8190 | sv | C |
| Limit the size of the HTTP request line that will be accepted from the client | |||
| LimitXMLRequestBody bytes | 1000000 | svdh | C |
| Limits the size of an XML-based request body | |||
| Listen [IP-address:]portnumber [protocol] | s | M | |
| IP addresses and ports that the server listens to | |||
| ListenBackLog backlog | 511 | s | M |
| Maximum length of the queue of pending connections | |||
| ListenCoresBucketsRatio ratio | 0 (disabled) | s | M |
| Ratio between the number of CPU cores (online) and the number of listeners' buckets | |||
| LoadFile filename [filename] ... | sv | E | |
| Link in the named object file or library | |||
| LoadModule module filename | sv | E | |
| Links in the object file or library, and adds to the list of active modules | |||
| <Location URL-path|URL> ... </Location> | sv | C | |
| Applies the enclosed directives only to matching URLs | |||
| <LocationMatch regex> ... </LocationMatch> | sv | C | |
| Applies the enclosed directives only to regular-expression matching URLs | |||
| LogFormat format|nickname [nickname] | "%h %l %u %t \"%r\" + | sv | B |
| Describes a format for use in a log file | |||
| LogIOTrackTTFB ON|OFF | OFF | svdh | E |
| Enable tracking of time to first byte (TTFB) | |||
| LogLevel [module:]level [module:level] ... | warn | svd | C |
| Controls the verbosity of the ErrorLog | |||
| LogMessage message [hook=hook] [expr=expression] | d | X | |
| Log user-defined message to error log | |||
| LuaAuthzProvider provider_name /path/to/lua/script.lua function_name | s | E | |
Plug an authorization provider function into mod_authz_core
| |||
| LuaCodeCache stat|forever|never | stat | svdh | E |
| Configure the compiled code cache. | |||
| LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the access_checker phase of request processing | |||
| LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the auth_checker phase of request processing | |||
| LuaHookCheckUserID /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the check_user_id phase of request processing | |||
| LuaHookFixups /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the fixups phase of a request processing | |||
| LuaHookInsertFilter /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the insert_filter phase of request processing | |||
| LuaHookLog /path/to/lua/script.lua log_function_name | svdh | E | |
| Provide a hook for the access log phase of a request processing | |||
| LuaHookMapToStorage /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the map_to_storage phase of request processing | |||
| LuaHookPreTranslate /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the pre_translate phase of a request processing | |||
| LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late] | sv | E | |
| Provide a hook for the translate name phase of request processing | |||
| LuaHookTypeChecker /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the type_checker phase of request processing | |||
| LuaInherit none|parent-first|parent-last | parent-first | svdh | E |
| Controls how parent configuration sections are merged into children | |||
| LuaInputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content input filtering | |||
| LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name] | svdh | E | |
| Map a path to a lua handler | |||
| LuaOutputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content output filtering | |||
| LuaPackageCPath /path/to/include/?.soa | svdh | E | |
| Add a directory to lua's package.cpath | |||
| LuaPackagePath /path/to/include/?.lua | svdh | E | |
| Add a directory to lua's package.path | |||
| LuaQuickHandler /path/to/script.lua hook_function_name | sv | E | |
| Provide a hook for the quick handler of request processing | |||
| LuaRoot /path/to/a/directory | svdh | E | |
| Specify the base path for resolving relative paths for mod_lua directives | |||
| LuaScope once|request|conn|thread|server [min] [max] | once | svdh | E |
| One of once, request, conn, thread -- default is once | |||
| <Macro name [par1 .. parN]> ... </Macro> | svd | B | |
| Define a configuration file macro | |||
| MaxConnectionsPerChild number | 0 | s | M |
| Limit on the number of connections that an individual child server will handle during its life | |||
| MaxKeepAliveRequests number | 100 | sv | C |
| Number of requests allowed on a persistent connection | |||
| MaxMemFree KBytes | 2048 | s | M |
Maximum amount of memory that the main allocator is allowed
to hold without calling free() | |||
| MaxRangeOverlaps default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete
resource | |||
| MaxRangeReversals default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of range reversals (eg: 100-200,50-70) allowed before returning the complete
resource | |||
| MaxRanges default | unlimited | none | number-of-ranges | 200 | svd | C |
| Number of ranges allowed before returning the complete resource | |||
| MaxRequestWorkers number | s | M | |
| Maximum number of connections that will be processed simultaneously | |||
| MaxSpareServers number | 10 | s | M |
| Maximum number of idle child server processes | |||
| MaxSpareThreads number | s | M | |
| Maximum number of idle threads | |||
| MaxThreads number | 2048 | s | M |
| Set the maximum number of worker threads | |||
| MDActivationDelay duration | s | X | |
| How long to delay activation of new certificates | |||
| MDBaseServer on|off | off | s | X |
| Control if base server may be managed or only virtual hosts. | |||
| MDCAChallenges name [ name ... ] | tls-alpn-01 http-01 + | s | X |
| Type of ACME challenge used to prove domain ownership. | |||
| MDCertificateAgreement accepted | s | X | |
| You confirm that you accepted the Terms of Service of the Certificate Authority. | |||
| MDCertificateAuthority url | letsencrypt | s | X |
| The URL(s) of the ACME Certificate Authority to use. | |||
| MDCertificateCheck name url | s | X | |
| Set name and URL pattern for a certificate monitoring site. | |||
| MDCertificateFile path-to-pem-file | s | X | |
| Specify a static certificate file for the MD. | |||
| MDCertificateKeyFile path-to-file | s | X | |
| Specify a static private key for for the static cerrtificate. | |||
| MDCertificateMonitor name url | crt.sh https://crt. + | s | X |
| The URL of a certificate log monitor. | |||
| MDCertificateProtocol protocol | ACME | s | X |
| The protocol to use with the Certificate Authority. | |||
| MDCertificateStatus on|off | on | s | X |
| Exposes public certificate information in JSON. | |||
| MDChallengeDns01 path-to-command | s | X | |
| Set the command for setup/teardown of dns-01 challenges | |||
| MDChallengeDns01Version 1|2 | 1 | s | X |
| Set the type of arguments to call MDChallengeDns01 with | |||
| MDCheckInterval duration | 12h | s | X |
| Determines how often certificates are checked | |||
| MDContactEmail address | s | X | |
| Email address used for account registration | |||
| MDDriveMode always|auto|manual | auto | s | X |
| former name of MDRenewMode. | |||
| MDExternalAccountBinding key-id hmac-64 | none | file | none | s | X |
| Set the external account binding keyid and hmac values to use at CA | |||
| MDHttpProxy url | s | X | |
| Define a proxy for outgoing connections. | |||
| MDMatchNames all|servernames | all | s | X |
| Determines how DNS names are matched to vhosts | |||
| MDMember hostname | s | X | |
| Additional hostname for the managed domain. | |||
| MDMembers auto|manual | auto | s | X |
| Control if the alias domain names are automatically added. | |||
| MDMessageCmd path-to-cmd optional-args | s | X | |
| Handle events for Manage Domains | |||
| MDMustStaple on|off | off | s | X |
| Control if new certificates carry the OCSP Must Staple flag. | |||
| MDNotifyCmd path [ args ] | s | X | |
| Run a program when a Managed Domain is ready. | |||
| MDomain dns-name [ other-dns-name... ] [auto|manual] | s | X | |
| Define list of domain names that belong to one group. | |||
| <MDomainSet dns-name [ other-dns-name... ]>...</MDomainSet> | s | X | |
| Container for directives applied to the same managed domains. | |||
| MDPortMap map1 [ map2 ] | http:80 https:443 | s | X |
| Map external to internal ports for domain ownership verification. | |||
| MDPrivateKeys type [ params... ] | RSA 2048 | s | X |
| Set type and size of the private keys generated. | |||
| MDProfile name | s | X | |
| Use a specific ACME profile from the CA | |||
| MDProfileMandatory on|off | off | s | X |
| Control if an MDProfile is mandatory. | |||
| MDRenewMode always|auto|manual | auto | s | X |
| Controls if certificates shall be renewed. | |||
| MDRenewWindow duration | 33% | s | X |
| Control when a certificate will be renewed. | |||
| MDRequireHttps off|temporary|permanent | off | s | X |
| Redirects http: traffic to https: for Managed Domains. | |||
| MDRetryDelay duration | 5s | s | X |
| Time length for first retry, doubled on every consecutive error. | |||
| MDRetryFailover number | 13 | s | X |
| The number of errors before a failover to another CA is triggered | |||
| MDServerStatus on|off | on | s | X |
| Control if Managed Domain information is added to server-status. | |||
| MDStapleOthers on|off | on | s | X |
| Enable stapling for certificates not managed by mod_md. | |||
| MDStapling on|off | off | s | X |
| Enable stapling for all or a particular MDomain. | |||
| MDStaplingKeepResponse duration | 7d | s | X |
| Controls when old responses should be removed. | |||
| MDStaplingRenewWindow duration | 33% | s | X |
| Control when the stapling responses will be renewed. | |||
| MDStoreDir path | md | s | X |
| Path on the local file system to store the Managed Domains data. | |||
| MDStoreLocks on|off|duration | off | s | X |
| Configure locking of store for updates | |||
| MDWarnWindow duration | 10% | s | X |
| Define the time window when you want to be warned about an expiring certificate. | |||
| MemcacheConnTTL num[units] | 15s | sv | E |
| Keepalive time for idle connections | |||
| MergeSlashes ON|OFF | ON | sv | C |
| Controls whether the server merges consecutive slashes in URLs. | |||
| MergeTrailers [on|off] | off | sv | C |
| Determines whether trailers are merged into headers | |||
| MetaDir directory | .web | svdh | E |
| Name of the directory to find CERN-style meta information files | |||
| MetaFiles on|off | off | svdh | E |
| Activates CERN meta-file processing | |||
| MetaSuffix suffix | .meta | svdh | E |
| File name suffix for the file containing CERN-style meta information | |||
| MimeMagicFile file-path | sv | E | |
| Enable MIME-type determination based on file contents using the specified magic file | |||
| MinSpareServers number | 5 | s | M |
| Minimum number of idle child server processes | |||
| MinSpareThreads number | s | M | |
| Minimum number of idle threads available to handle request spikes | |||
| MMapFile file-path [file-path] ... | s | X | |
| Map a list of files into memory at startup time | |||
| ModemStandard V.21|V.26bis|V.32|V.34|V.92 | d | X | |
| Modem standard to simulate | |||
| ModMimeUsePathInfo On|Off | Off | d | B |
Tells mod_mime to treat path_info
components as part of the filename | |||
| MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers [Handlers|Filters] | NegotiatedOnly | svdh | B |
| The types of files that will be included when searching for a matching file with MultiViews | |||
| Mutex mechanism [default|mutex-name] ... [OmitPID] | default | s | C |
| Configures mutex mechanism and lock file directory for all or specified mutexes | |||
| NameVirtualHost addr[:port] | s | C | |
| Designates an IP address for name-virtual hosting | |||
| NoProxy host [host] ... | sv | E | |
| Hosts, domains, or networks that will be connected to directly | |||
| NWSSLTrustedCerts filename [filename] ... | s | B | |
| List of additional client certificates | |||
| NWSSLUpgradeable [IP-address:]portnumber | s | B | |
| Allows a connection to be upgraded to an SSL connection upon request | |||
| Options [+|-]option [[+|-]option] ... | All | svdh | C |
| Configures what features are available in a particular directory | |||
| Order ordering | Deny,Allow | dh | E |
Controls the default access state and the order in which
Allow and Deny are
evaluated. | |||
| OutputSed sed-command | dh | X | |
| Sed command for filtering response content | |||
| PassEnv env-variable [env-variable] ... | svdh | B | |
| Passes environment variables from the shell | |||
| PidFile filename | logs/httpd.pid | s | M |
| File where the server records the process ID of the daemon | |||
| PrivilegesMode FAST|SECURE|SELECTIVE | FAST | svd | X |
| Trade off processing speed and efficiency vs security against malicious privileges-aware code. | |||
| Protocol protocol | sv | C | |
| Protocol for a listening socket | |||
| ProtocolEcho On|Off | Off | sv | X |
| Turn the echo server on or off | |||
| Protocols protocol ... | http/1.1 | sv | C |
| Protocols available for a server/virtual host | |||
| ProtocolsHonorOrder On|Off | On | sv | C |
| Determines if order of Protocols determines precedence during negotiation | |||
| <Proxy wildcard-url> ...</Proxy> | sv | E | |
| Container for directives applied to proxied resources | |||
| Proxy100Continue Off|On | On | svd | E |
| Forward 100-continue expectation to the origin server | |||
| ProxyAddHeaders Off|On | On | svd | E |
| Add proxy information in X-Forwarded-* headers | |||
| ProxyBadHeader IsError|Ignore|StartBody | IsError | sv | E |
| Determines how to handle bad header lines in a response | |||
| ProxyBlock *|word|host|domain [word|host|domain] ... | sv | E | |
| Words, hosts, or domains that are banned from being proxied | |||
| ProxyDomain Domain | sv | E | |
| Default domain name for proxied requests | |||
| ProxyErrorOverride Off|On [code ...] | Off | svd | E |
| Override error pages for proxied content | |||
| ProxyExpressDBMFile pathname | sv | E | |
| Pathname to DBM file. | |||
| ProxyExpressDBMType type | default | sv | E |
| DBM type of file. | |||
| ProxyExpressEnable on|off | off | sv | E |
| Enable the module functionality. | |||
| ProxyFCGIBackendType FPM|GENERIC | FPM | svdh | E |
| Specify the type of backend FastCGI application | |||
| ProxyFCGISetEnvIf conditional-expression [!]environment-variable-name [value-expression] | svdh | E | |
| Allow variables sent to FastCGI servers to be fixed up | |||
| ProxyFtpDirCharset character_set | ISO-8859-1 | svd | E |
| Define the character set for proxied FTP listings | |||
| ProxyFtpEscapeWildcards on|off | on | svd | E |
| Whether wildcards in requested filenames are escaped when sent to the FTP server | |||
| ProxyFtpListOnWildcard on|off | on | svd | E |
| Whether wildcards in requested filenames trigger a file listing | |||
| ProxyHCExpr name {ap_expr expression} | sv | E | |
| Creates a named condition expression to use to determine health of the backend based on its response | |||
| ProxyHCTemplate name parameter=setting [...] | sv | E | |
| Creates a named template for setting various health check parameters | |||
| ProxyHCTPsize size | 16 | s | E |
| Sets the total server-wide size of the threadpool used for the health check workers | |||
| ProxyHTMLBufSize bytes | 8192 | svd | B |
| Sets the buffer size increment for buffering inline scripts and stylesheets. | |||
| ProxyHTMLCharsetOut Charset | * | svd | B | |
| Specify a charset for mod_proxy_html output. | |||
| ProxyHTMLDocType HTML|XHTML [Legacy] OR ProxyHTMLDocType fpi [SGML|XML] | svd | B | |
| Sets an HTML or XHTML document type declaration. | |||
| ProxyHTMLEnable On|Off | Off | svd | B |
| Turns the proxy_html filter on or off. | |||
| ProxyHTMLEvents attribute [attribute ...] | svd | B | |
| Specify attributes to treat as scripting events. | |||
| ProxyHTMLExtended On|Off | Off | svd | B |
| Determines whether to fix links in inline scripts, stylesheets, and scripting events. | |||
| ProxyHTMLFixups [lowercase] [dospath] [reset] | svd | B | |
| Fixes for simple HTML errors. | |||
| ProxyHTMLInterp On|Off | Off | svd | B |
Enables per-request interpolation of
ProxyHTMLURLMap rules. | |||
| ProxyHTMLLinks element attribute [attribute2 ...] | svd | B | |
| Specify HTML elements that have URL attributes to be rewritten. | |||
| ProxyHTMLMeta On|Off | Off | svd | B |
Turns on or off extra pre-parsing of metadata in HTML
<head> sections. | |||
| ProxyHTMLStripComments On|Off | Off | svd | B |
| Determines whether to strip HTML comments. | |||
| ProxyHTMLURLMap from-pattern to-pattern [flags] [cond] | svd | B | |
| Defines a rule to rewrite HTML links | |||
| ProxyIOBufferSize bytes | 8192 | sv | E |
| Determine size of internal data throughput buffer | |||
| <ProxyMatch regex> ...</ProxyMatch> | sv | E | |
| Container for directives applied to regular-expression-matched proxied resources | |||
| ProxyMaxForwards number | -1 | sv | E |
| Maximum number of proxies that a request can be forwarded through | |||
| ProxyPass [path] !|url [key=value [key=value ...]] [nocanon] [interpolate] [noquery] | svd | E | |
| Maps remote servers into the local server URL-space | |||
| ProxyPassInherit On|Off | On | sv | E |
| Inherit ProxyPass directives defined from the main server | |||
| ProxyPassInterpolateEnv On|Off | Off | svd | E |
| Enable Environment Variable interpolation in Reverse Proxy configurations | |||
| ProxyPassMatch [regex] !|url [key=value [key=value ...]] | svd | E | |
| Maps remote servers into the local server URL-space using regular expressions | |||
| ProxyPassReverse [path] url [interpolate] | svd | E | |
| Adjusts the URL in HTTP response headers sent from a reverse proxied server | |||
| ProxyPassReverseCookieDomain internal-domain public-domain [interpolate] | svd | E | |
| Adjusts the Domain string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPassReverseCookiePath internal-path public-path [interpolate] | svd | E | |
| Adjusts the Path string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPreserveHost On|Off | Off | svd | E |
| Use incoming Host HTTP request header for proxy request | |||
| ProxyReceiveBufferSize bytes | 0 | sv | E |
| Network buffer size for proxied HTTP and FTP connections | |||
| ProxyRemote match remote-server [username:password] | sv | E | |
| Remote proxy used to handle certain requests | |||
| ProxyRemoteMatch regex remote-server [username:password] | sv | E | |
| Remote proxy used to handle requests matched by regular expressions | |||
| ProxyRequests On|Off | Off | sv | E |
| Enables forward (standard) proxy requests | |||
| ProxySCGIInternalRedirect On|Off|Headername | On | svd | E |
| Enable or disable internal redirect responses from the backend | |||
| ProxySCGISendfile On|Off|Headername | Off | svd | E |
| Enable evaluation of X-Sendfile pseudo response header | |||
| ProxySet url key=value [key=value ...] | svd | E | |
| Set various Proxy balancer or member parameters | |||
| ProxySourceAddress address | sv | E | |
| Set local IP address for outgoing proxy connections | |||
| ProxyStatus Off|On|Full | Off | sv | E |
| Show Proxy LoadBalancer status in mod_status | |||
| ProxyTimeout seconds | sv | E | |
| Network timeout for proxied requests | |||
| ProxyVia On|Off|Full|Block | Off | sv | E |
Information provided in the Via HTTP response
header for proxied requests | |||
| ProxyWebsocketFallbackToProxyHttp On|Off | On | sv | E |
Instructs this module to let mod_proxy_http handle the request | |||
| QualifyRedirectURL On|Off | Off | svd | C |
| Controls whether the REDIRECT_URL environment variable is fully qualified | |||
| ReadBufferSize bytes | 8192 | svd | C |
| Size of the buffers used to read data | |||
| ReadmeName filename | svdh | B | |
| Name of the file that will be inserted at the end of the index listing | |||
| ReceiveBufferSize bytes | 0 | s | M |
| TCP receive buffer size | |||
| Redirect [status] [URL-path] URL | svdh | B | |
| Sends an external redirect asking the client to fetch a different URL | |||
| RedirectMatch [status] regex URL | svdh | B | |
| Sends an external redirect based on a regular expression match of the current URL | |||
| RedirectPermanent URL-path URL | svdh | B | |
| Sends an external permanent redirect asking the client to fetch a different URL | |||
| RedirectRelative On|Off | Off | svd | B |
| Allows relative redirect targets. | |||
| RedirectTemp URL-path URL | svdh | B | |
| Sends an external temporary redirect asking the client to fetch a different URL | |||
| RedisConnPoolTTL num[units] | 15s | sv | E |
| TTL used for the connection pool with the Redis server(s) | |||
| RedisTimeout num[units] | 5s | sv | E |
| R/W timeout used for the connection with the Redis server(s) | |||
| ReflectorHeader inputheader [outputheader] | svdh | B | |
| Reflect an input header to the output headers | |||
| RegexDefaultOptions [none] [+|-]option [[+|-]option] ... | DOTALL DOLLAR_ENDON + | s | C |
| Allow to configure global/default options for regexes | |||
| RegisterHttpMethod method [method [...]] | s | C | |
| Register non-standard HTTP methods | |||
| RemoteIPHeader header-field | sv | B | |
| Declare the header field which should be parsed for useragent IP addresses | |||
| RemoteIPInternalProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPInternalProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPProxiesHeader HeaderFieldName | sv | B | |
| Declare the header field which will record all intermediate IP addresses | |||
| RemoteIPProxyProtocol On|Off | sv | B | |
| Enable or disable PROXY protocol handling | |||
| RemoteIPProxyProtocolExceptions host|range [host|range] [host|range] | sv | B | |
| Disable processing of PROXY header for certain hosts or networks | |||
| RemoteIPTrustedProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPTrustedProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoveCharset extension [extension] ... | vdh | B | |
| Removes any character set associations for a set of file extensions | |||
| RemoveEncoding extension [extension] ... | vdh | B | |
| Removes any content encoding associations for a set of file extensions | |||
| RemoveHandler extension [extension] ... | vdh | B | |
| Removes any handler associations for a set of file extensions | |||
| RemoveInputFilter extension [extension] ... | vdh | B | |
| Removes any input filter associations for a set of file extensions | |||
| RemoveLanguage extension [extension] ... | vdh | B | |
| Removes any language associations for a set of file extensions | |||
| RemoveOutputFilter extension [extension] ... | vdh | B | |
| Removes any output filter associations for a set of file extensions | |||
| RemoveType extension [extension] ... | vdh | B | |
| Removes any content type associations for a set of file extensions | |||
| RequestHeader add|append|edit|edit*|merge|set|setifempty|unset header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] | svdh | E | |
| Configure HTTP request headers | |||
| RequestReadTimeout [handshake=timeout[-maxtimeout][,MinRate=rate] [header=timeout[-maxtimeout][,MinRate=rate] [body=timeout[-maxtimeout][,MinRate=rate] | handshake=0 header= + | sv | E |
| Set timeout values for completing the TLS handshake, receiving the request headers and/or body from client. | |||
| Require [not] entity-name [entity-name] ... | dh | B | |
| Tests whether an authenticated user is authorized by an authorization provider. | |||
| <RequireAll> ... </RequireAll> | dh | B | |
| Enclose a group of authorization directives of which none must fail and at least one must succeed for the enclosing directive to succeed. | |||
| <RequireAny> ... </RequireAny> | dh | B | |
| Enclose a group of authorization directives of which one must succeed for the enclosing directive to succeed. | |||
| <RequireNone> ... </RequireNone> | dh | B | |
| Enclose a group of authorization directives of which none must succeed for the enclosing directive to not fail. | |||
| RewriteBase URL-path | dh | E | |
| Sets the base URL for per-directory rewrites | |||
| RewriteCond TestString CondPattern [flags] | svdh | E | |
| Defines a condition under which rewriting will take place | |||
| RewriteEngine on|off | off | svdh | E |
| Enables or disables runtime rewriting engine | |||
| RewriteMap MapName MapType:MapSource [MapTypeOptions] | sv | E | |
| Defines a mapping function for key-lookup | |||
| RewriteOptions Options | svdh | E | |
| Sets some special options for the rewrite engine | |||
| RewriteRule Pattern Substitution [flags] | svdh | E | |
| Defines rules for the rewriting engine | |||
| RLimitCPU seconds|max [seconds|max] | svdh | C | |
| Limits the CPU consumption of processes launched by Apache httpd children | |||
| RLimitMEM bytes|max [bytes|max] | svdh | C | |
| Limits the memory consumption of processes launched by Apache httpd children | |||
| RLimitNPROC number|max [number|max] | svdh | C | |
| Limits the number of processes that can be launched by processes launched by Apache httpd children | |||
| Satisfy Any|All | All | dh | E |
| Interaction between host-level access control and user authentication | |||
| ScoreBoardFile file-path | logs/apache_runtime + | s | M |
| Location of the file used to store coordination data for the child processes | |||
| Script method cgi-script | svd | B | |
| Activates a CGI script for a particular request method. | |||
| ScriptAlias [URL-path] file-path|directory-path | svd | B | |
| Maps a URL to a filesystem location and designates the target as a CGI script | |||
| ScriptAliasMatch regex file-path|directory-path | sv | B | |
| Maps a URL to a filesystem location using a regular expression and designates the target as a CGI script | |||
| ScriptInterpreterSource Registry|Registry-Strict|Script | Script | svdh | C |
| Technique for locating the interpreter for CGI scripts | |||
| ScriptLog file-path | sv | B | |
| Location of the CGI script error logfile | |||
| ScriptLogBuffer bytes | 1024 | sv | B |
| Maximum amount of PUT or POST requests that will be recorded in the scriptlog | |||
| ScriptLogLength bytes | 10385760 | sv | B |
| Size limit of the CGI script logfile | |||
| ScriptSock file-path | cgisock | s | B |
| The filename prefix of the socket to use for communication with the cgi daemon | |||
| SecureListen [IP-address:]portnumber Certificate-Name [MUTUAL] | s | B | |
| Enables SSL encryption for the specified port | |||
| SeeRequestTail On|Off | Off | s | C |
| Determine if mod_status displays the first 63 characters of a request or the last 63, assuming the request itself is greater than 63 chars. | |||
| SendBufferSize bytes | 0 | s | M |
| TCP buffer size | |||
| ServerAdmin email-address|URL | sv | C | |
| Email address that the server includes in error messages sent to the client | |||
| ServerAlias hostname [hostname] ... | v | C | |
| Alternate names for a host used when matching requests to name-virtual hosts | |||
| ServerLimit number | s | M | |
| Upper limit on configurable number of processes | |||
| ServerName [scheme://]fully-qualified-domain-name[:port] | sv | C | |
| Hostname and port that the server uses to identify itself | |||
| ServerPath URL-path | v | C | |
| Legacy URL pathname for a name-based virtual host that is accessed by an incompatible browser | |||
| ServerRoot directory-path | /usr/local/apache | s | C |
| Base directory for the server installation | |||
| ServerSignature On|Off|EMail | Off | svdh | C |
| Configures the footer on server-generated documents | |||
| ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full | Full | s | C |
Configures the Server HTTP response
header | |||
| Session On|Off | Off | svdh | E |
| Enables a session for the current directory or location | |||
| SessionCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session | |||
| SessionCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session | |||
| SessionCookieRemove On|Off | Off | svdh | E |
| Control for whether session cookies should be removed from incoming HTTP headers | |||
| SessionCryptoCipher name | aes256 | svdh | X |
| The crypto cipher to be used to encrypt the session | |||
| SessionCryptoDriver name [param[=value]] | s | X | |
| The crypto driver to be used to encrypt the session | |||
| SessionCryptoPassphrase secret [ secret ... ] | svdh | X | |
| The key used to encrypt the session | |||
| SessionCryptoPassphraseFile filename | svd | X | |
| File containing keys used to encrypt the session | |||
| SessionDBDCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session ID | |||
| SessionDBDCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session ID | |||
| SessionDBDCookieRemove On|Off | On | svdh | E |
| Control for whether session ID cookies should be removed from incoming HTTP headers | |||
| SessionDBDDeleteLabel label | deletesession | svdh | E |
| The SQL query to use to remove sessions from the database | |||
| SessionDBDInsertLabel label | insertsession | svdh | E |
| The SQL query to use to insert sessions into the database | |||
| SessionDBDPerUser On|Off | Off | svdh | E |
| Enable a per user session | |||
| SessionDBDSelectLabel label | selectsession | svdh | E |
| The SQL query to use to select sessions from the database | |||
| SessionDBDUpdateLabel label | updatesession | svdh | E |
| The SQL query to use to update existing sessions in the database | |||
| SessionEnv On|Off | Off | svdh | E |
| Control whether the contents of the session are written to the HTTP_SESSION environment variable | |||
| SessionExclude path | svdh | E | |
| Define URL prefixes for which a session is ignored | |||
| SessionExpiryUpdateInterval interval | 0 (always update) | svdh | E |
| Define the number of seconds a session's expiry may change without the session being updated | |||
| SessionHeader header | svdh | E | |
| Import session updates from a given HTTP response header | |||
| SessionInclude path | svdh | E | |
| Define URL prefixes for which a session is valid | |||
| SessionMaxAge maxage | 0 | svdh | E |
| Define a maximum age in seconds for a session | |||
| SetEnv env-variable [value] | svdh | B | |
| Sets environment variables | |||
| SetEnvIf attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on attributes of the request | |||
| SetEnvIfExpr expr [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on an ap_expr expression | |||
| SetEnvIfNoCase attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on attributes of the request without respect to case | |||
| SetHandler handler-name|None | svdh | C | |
| Forces all matching files to be processed by a handler | |||
| SetInputFilter filter[;filter...] | svdh | C | |
| Sets the filters that will process client requests and POST input | |||
| SetOutputFilter filter[;filter...] | svdh | C | |
| Sets the filters that will process responses from the server | |||
| SSIEndTag tag | "-->" | sv | B |
| String that ends an include element | |||
| SSIErrorMsg message | "[an error occurred + | svdh | B |
| Error message displayed when there is an SSI error | |||
| SSIETag on|off | off | dh | B |
| Controls whether ETags are generated by the server. | |||
| SSILastModified on|off | off | dh | B |
Controls whether Last-Modified headers are generated by the
server. | |||
| SSILegacyExprParser on|off | off | dh | B |
| Enable compatibility mode for conditional expressions. | |||
| SSIStartTag tag | "<!--#" | sv | B |
| String that starts an include element | |||
| SSITimeFormat formatstring | "%A, %d-%b-%Y %H:%M + | svdh | B |
| Configures the format in which date strings are displayed | |||
| SSIUndefinedEcho string | "(none)" | svdh | B |
| String displayed when an unset variable is echoed | |||
| SSLCACertificateFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for Client Auth | |||
| SSLCACertificatePath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for Client Auth | |||
| SSLCADNRequestFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCADNRequestPath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCARevocationCheck chain|leaf|none [flags ...] | none | sv | E |
| Enable CRL-based revocation checking | |||
| SSLCARevocationFile file-path | sv | E | |
| File of concatenated PEM-encoded CA CRLs for Client Auth | |||
| SSLCARevocationPath directory-path | sv | E | |
| Directory of PEM-encoded CA CRLs for Client Auth | |||
| SSLCertificateChainFile file-path | sv | E | |
| File of PEM-encoded Server CA Certificates | |||
| SSLCertificateFile file-path|certid | sv | E | |
| Server PEM-encoded X.509 certificate data file or token identifier | |||
| SSLCertificateKeyFile file-path|keyid | sv | E | |
| Server PEM-encoded private key file | |||
| SSLCipherSuite [protocol] cipher-spec | DEFAULT (depends on + | svdh | E |
| Cipher Suite available for negotiation in SSL handshake | |||
| SSLCompression on|off | off | sv | E |
| Enable compression on the SSL level | |||
| SSLCryptoDevice engine | builtin | s | E |
| Enable use of a cryptographic hardware accelerator | |||
| SSLEngine on|off|optional | off | sv | E |
| SSL Engine Operation Switch | |||
| SSLFIPS on|off | off | s | E |
| SSL FIPS mode Switch | |||
| SSLHonorCipherOrder on|off | off | sv | E |
| Option to prefer the server's cipher preference order | |||
| SSLInsecureRenegotiation on|off | off | sv | E |
| Option to enable support for insecure renegotiation | |||
| SSLOCSPDefaultResponder uri | sv | E | |
| Set the default responder URI for OCSP validation | |||
| SSLOCSPEnable on|leaf|off | off | sv | E |
| Enable OCSP validation of the client certificate chain | |||
| SSLOCSPNoverify on|off | off | sv | E |
| skip the OCSP responder certificates verification | |||
| SSLOCSPOverrideResponder on|off | off | sv | E |
| Force use of the default responder URI for OCSP validation | |||
| SSLOCSPProxyURL url | sv | E | |
| Proxy URL to use for OCSP requests | |||
| SSLOCSPResponderCertificateFile file | sv | E | |
| Set of trusted PEM encoded OCSP responder certificates | |||
| SSLOCSPResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP queries | |||
| SSLOCSPResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP responses | |||
| SSLOCSPResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP response validation | |||
| SSLOCSPUseRequestNonce on|off | on | sv | E |
| Use a nonce within OCSP queries | |||
| SSLOpenSSLConfCmd command-name command-value | sv | E | |
| Configure OpenSSL parameters through its SSL_CONF API | |||
| SSLOptions [+|-]option ... | svdh | E | |
| Configure various SSL engine run-time options | |||
| SSLPassPhraseDialog type | builtin | s | E |
| Type of pass phrase dialog for encrypted private keys | |||
| SSLProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | sv | E |
| Configure usable SSL/TLS protocol versions | |||
| SSLProxyCACertificateFile file-path | svp | E | |
| File of concatenated PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCACertificatePath directory-path | svp | E | |
| Directory of PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCARevocationCheck chain|leaf|none | none | svp | E |
| Enable CRL-based revocation checking for Remote Server Auth | |||
| SSLProxyCARevocationFile file-path | svp | E | |
| File of concatenated PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCARevocationPath directory-path | svp | E | |
| Directory of PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCheckPeerCN on|off | on | svp | E |
| Whether to check the remote server certificate's CN field | |||
| SSLProxyCheckPeerExpire on|off | on | svp | E |
| Whether to check if remote server certificate is expired | |||
| SSLProxyCheckPeerName on|off | on | svp | E |
| Configure host name checking for remote server certificates | |||
| SSLProxyCipherSuite [protocol] cipher-spec | ALL:!ADH:RC4+RSA:+H + | svp | E |
| Cipher Suite available for negotiation in SSL proxy handshake | |||
| SSLProxyEngine on|off | off | svp | E |
| SSL Proxy Engine Operation Switch | |||
| SSLProxyMachineCertificateChainFile filename | svp | E | |
| File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate | |||
| SSLProxyMachineCertificateFile filename | svp | E | |
| File of concatenated PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyMachineCertificatePath directory | svp | E | |
| Directory of PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | svp | E |
| Configure usable SSL protocol flavors for proxy usage | |||
| SSLProxyVerify level | none | svp | E |
| Type of remote server Certificate verification | |||
| SSLProxyVerifyDepth number | 1 | svp | E |
| Maximum depth of CA Certificates in Remote Server Certificate verification | |||
| SSLRandomSeed context source [bytes] | s | E | |
| Pseudo Random Number Generator (PRNG) seeding source | |||
| SSLRenegBufferSize bytes | 131072 | dh | E |
| Set the size for the SSL renegotiation buffer | |||
| SSLRequire expression | dh | E | |
| Allow access only when an arbitrarily complex boolean expression is true | |||
| SSLRequireSSL | dh | E | |
| Deny access when SSL is not used for the HTTP request | |||
| SSLSessionCache type | none | s | E |
| Type of the global/inter-process SSL Session Cache | |||
| SSLSessionCacheTimeout seconds | 300 | sv | E |
| Number of seconds before an SSL session expires in the Session Cache | |||
| SSLSessionTicketKeyFile file-path | sv | E | |
| Persistent encryption/decryption key for TLS session tickets | |||
| SSLSessionTickets on|off | on | sv | E |
| Enable or disable use of TLS session tickets | |||
| SSLSRPUnknownUserSeed secret-string | sv | E | |
| SRP unknown user seed | |||
| SSLSRPVerifierFile file-path | sv | E | |
| Path to SRP verifier file | |||
| SSLStaplingCache type | s | E | |
| Configures the OCSP stapling cache | |||
| SSLStaplingErrorCacheTimeout seconds | 600 | sv | E |
| Number of seconds before expiring invalid responses in the OCSP stapling cache | |||
| SSLStaplingFakeTryLater on|off | on | sv | E |
| Synthesize "tryLater" responses for failed OCSP stapling queries | |||
| SSLStaplingForceURL uri | sv | E | |
| Override the OCSP responder URI specified in the certificate's AIA extension | |||
| SSLStaplingResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP stapling queries | |||
| SSLStaplingResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP stapling responses | |||
| SSLStaplingResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP stapling response validation | |||
| SSLStaplingReturnResponderErrors on|off | on | sv | E |
| Pass stapling related OCSP errors on to client | |||
| SSLStaplingStandardCacheTimeout seconds | 3600 | sv | E |
| Number of seconds before expiring responses in the OCSP stapling cache | |||
| SSLStrictSNIVHostCheck on|off | off | sv | E |
| Whether to allow non-SNI clients to access a name-based virtual host. | |||
| SSLUserName varname | sdh | E | |
| Variable name to determine user name | |||
| SSLUseStapling on|off | off | sv | E |
| Enable stapling of OCSP responses in the TLS handshake | |||
| SSLVerifyClient level | none | svdh | E |
| Type of Client Certificate verification | |||
| SSLVerifyDepth number | 1 | svdh | E |
| Maximum depth of CA Certificates in Client Certificate verification | |||
| StartServers number | s | M | |
| Number of child server processes created at startup | |||
| StartThreads number | s | M | |
| Number of threads created on startup | |||
| StrictHostCheck ON|OFF | OFF | sv | C |
| Controls whether the server requires the requested hostname be listed enumerated in the virtual host handling the request | |||
| Substitute s/pattern/substitution/[infq] | dh | E | |
| Pattern to filter the response content | |||
| SubstituteInheritBefore on|off | off | dh | E |
| Change the merge order of inherited patterns | |||
| SubstituteMaxLineLength bytes(b|B|k|K|m|M|g|G) | 1m | dh | E |
| Set the maximum line size | |||
| Suexec On|Off | s | B | |
| Enable or disable the suEXEC feature | |||
| SuexecUserGroup User Group | sv | E | |
| User and group for CGI programs to run as | |||
| ThreadLimit number | s | M | |
| Sets the upper limit on the configurable number of threads per child process | |||
| ThreadsPerChild number | s | M | |
| Number of threads created by each child process | |||
| ThreadStackSize size | s | M | |
| The size in bytes of the stack used by threads handling client connections | |||
| TimeOut seconds | 60 | sv | C |
| Amount of time the server will wait for certain events before failing a request | |||
| TraceEnable [on|off|extended] | on | s | C |
Determines the behaviour on TRACE requests | |||
| TransferLog file|pipe | sv | B | |
| Specify location of a log file | |||
| TypesConfig file-path | conf/mime.types | s | B |
The location of the mime.types file | |||
| UNCList hostname [hostname...] | s | C | |
| Controls what UNC host names can be accessed by the server | |||
| UnDefine parameter-name | s | C | |
| Undefine the existence of a variable | |||
| UndefMacro name | svd | B | |
| Undefine a macro | |||
| UnsetEnv env-variable [env-variable] ... | svdh | B | |
| Removes variables from the environment | |||
| Use name [value1 ... valueN] | svd | B | |
| Use a macro | |||
| UseCanonicalName On|Off|DNS | Off | svd | C |
| Configures how the server determines its own name and port | |||
| UseCanonicalPhysicalPort On|Off | Off | svd | C |
| Configures how the server determines its own name and port | |||
| User unix-userid | #-1 | s | B |
| The userid under which the server will answer requests | |||
| UserDir directory-filename [directory-filename] ... | sv | B | |
| Location of the user-specific directories | |||
| VHostCGIMode On|Off|Secure | On | v | X |
| Determines whether the virtualhost can run subprocesses, and the privileges available to subprocesses. | |||
| VHostCGIPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to subprocesses created by a virtual host. | |||
| VHostGroup unix-groupid | v | X | |
| Sets the Group ID under which a virtual host runs. | |||
| VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to a virtual host. | |||
| VHostSecure On|Off | On | v | X |
| Determines whether the server runs with enhanced security for the virtualhost. | |||
| VHostUser unix-userid | v | X | |
| Sets the User ID under which a virtual host runs. | |||
| VirtualDocumentRoot interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| VirtualDocumentRootIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| <VirtualHost addr[:port] [addr[:port]] ...> ... </VirtualHost> | s | C | |
| Contains directives that apply only to a specific hostname or IP address | |||
| VirtualScriptAlias interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| VirtualScriptAliasIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| WatchdogInterval time-interval[s] | 1 | s | B |
| Watchdog interval in seconds | |||
| XBitHack on|off|full | off | svdh | B |
| Parse SSI directives in files with the execute bit set | |||
| xml2EncAlias charset alias [alias ...] | s | B | |
| Recognise Aliases for encoding values | |||
| xml2EncDefault name | svdh | B | |
| Sets a default encoding to assume when absolutely no information can be automatically detected | |||
| xml2StartParse element [element ...] | svdh | B | |
| Advise the parser to skip leading junk. | |||
Apache HTTP サーバ バージョン 2.4
ディレクティブ クイックリファレンスでは、各 Apache 設定ディレクティブの 使用方法、デフォルト値、ステータスとコンテキストを示しています。 各ディレクティブの、より詳しい情報に関しては ディレクティブ辞書を ご覧下さい。
第 1 列目はディレクティブの名前と使用方法です。 第 2 列目は (もしあれば) デフォルト値となっています。 デフォルト値が長すぎて表示しきれない場合は、途中まで表示した上で、、 「 + 」で続きがあることを示しています。
第 3, 4 列は、下の表の注釈に従って、 ディレクティブの使用できるコンテキストと、 ディレクティブのステータスが示されています。
| A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X |
|
|
| AcceptFilter protocol accept_filter | s | C | |
| プロトコルを Listen しているソケットの最適化を設定する | |||
| AcceptPathInfo On|Off|Default | Default | svdh | C |
| 後に続くパス名情報を受け付けるリソースの指定 | |||
| AccessFileName filename [filename] ... | .htaccess | sv | C |
| 分散設定ファイルの名前 | |||
| Action action-type cgi-script [virtual] | svdh | B | |
| 特定のハンドラやコンテントタイプに対して CGI を実行するように 設定 | |||
| AddAlt string file [file] ... | svdh | B | |
| アイコンの代わりに 表示される、ファイル名で選択された代替テキスト | |||
| AddAltByEncoding string MIME-encoding [MIME-encoding] ... | svdh | B | |
| アイコンの代わりに表示される、MIME 符号化方法で選択された 代替テキスト | |||
| AddAltByType string MIME-type [MIME-type] ... | svdh | B | |
| アイコンの代わりに 表示される、MIME タイプで選択された代替テキスト | |||
| AddCharset charset extension [extension] ... | svdh | ||
| ファイル名の拡張子を指定された文字セットにマップする | |||
| AddDefaultCharset On|Off|charset | Off | svdh | C |
レスポンスのコンテントタイプが text/plain あるいは
text/html の場合に追加するデフォルトの charset パラメータ | |||
| AddDescription string file [file] ... | svdh | B | |
| ファイルに対して表示する説明 | |||
| AddEncoding MIME-enc extension [extension] ... | svdh | ||
| ファイル名の拡張子を指定されたエンコーディング にマップする | |||
| AddHandler handler-name extension [extension] ... | svdh | ||
| ファイル名の拡張子を指定されたハンドラにマップする | |||
| AddIcon icon name [name] ... | svdh | B | |
| ファイルに表示するアイコンを名前で選択 | |||
| AddIconByEncoding icon MIME-encoding [MIME-encoding] ... | svdh | B | |
| ファイルに表示するアイコンを MIME 符号化方法で選択 | |||
| AddIconByType icon MIME-type [MIME-type] ... | svdh | B | |
| ファイルの隣に表示するアイコンを MIME タイプによって選択 | |||
| AddInputFilter filter[;filter...] extension [extension] ... | svdh | ||
| ファイルの拡張子をクライアントのリクエストを処理する フィルタにマップする | |||
| AddLanguage MIME-lang extension [extension] ... | svdh | ||
| ファイル名を指定された言語にマップ | |||
| AddModuleInfo module-name string | sv | E | |
| server-info ハンドラにより表示されるモジュールの情報に 追加の情報を付け加える | |||
| AddOutputFilter filter[;filter...] extension [extension] ... | svdh | ||
| ファイル名の拡張子をサーバからの応答を処理するフィルタに マップする | |||
| AddOutputFilterByType filter[;filter...] media-type [media-type] ... | svdh | B | |
| assigns an output filter to a particular media-type | |||
| AddType MIME-type extension [extension] ... | svdh | ||
| ファイル名の拡張子を指定されたコンテントタイプにマップ | |||
| Alias URL-path file-path|directory-path | sv | B | |
| URL をファイルシステムの位置にマップする | |||
| AliasMatch regex file-path|directory-path | sv | B | |
| 正規表現を使って URL をファイルシステムの位置にマップする | |||
| AliasPreservePath OFF|ON | OFF | svd | B |
| Map the full path after the alias in a location. | |||
| Allow from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| サーバのある領域にアクセスできるホストを制御する | |||
| AllowCONNECT port[-port] [port[-port]] ... | 443 563 | sv | E |
Ports that are allowed to CONNECT through the
proxy | |||
| AllowEncodedSlashes On|Off | Off | sv | C |
| URL 中の符号化されたパス分離文字が先に伝えられるのを許可するかどうかを 決定する | |||
| AllowMethods reset|HTTP-method [HTTP-method]... | reset | d | X |
| Restrict access to the listed HTTP methods | |||
| AllowOverride All|None|directive-type [directive-type] ... | All | d | C |
.htaccess で許可されるディレクティブの種類 | |||
| AllowOverrideList None|directive [directive-type] ... | None | d | C |
Individual directives that are allowed in
.htaccess files | |||
| Anonymous user [user] ... | dh | E | |
| パスワードの検査無しでアクセスを許可する userID を指定する | |||
| Anonymous_LogEmail On|Off | On | dh | E |
| 入力されたパスワードがエラーログにロギングされるかどうかを 設定する | |||
| Anonymous_MustGiveEmail On|Off | On | dh | E |
| 空パスワードを許可するかどうかを指定する | |||
| Anonymous_NoUserID On|Off | Off | dh | E |
| 空 userID を許可するかを指定する | |||
| Anonymous_VerifyEmail On|Off | Off | dh | E |
| パスワード欄が正しい形式の電子メールアドレスであることを 調べるかどうかを設定する | |||
| AsyncRequestWorkerFactor factor | s | M | |
| Limit concurrent connections per process | |||
| AuthBasicAuthoritative On|Off | On | dh | B |
| 認証と承認を、より低いレベルのモジュールに移行させるかを 設定します。 | |||
| AuthBasicFake off|username [password] | dh | B | |
| Fake basic authentication using the given expressions for username and password | |||
| AuthBasicProvider provider-name [provider-name] ... | file | dh | B |
| この位置に対する認証プロバイダを設定します。 | |||
| AuthBasicUseDigestAlgorithm MD5|Off | Off | dh | B |
| Check passwords against the authentication providers as if Digest Authentication was in force instead of Basic Authentication. | |||
| AuthDBDUserPWQuery query | d | E | |
| SQL query to look up a password for a user | |||
| AuthDBDUserRealmQuery query | d | E | |
| SQL query to look up a password hash for a user and realm. | |||
| AuthDBMGroupFile file-path | dh | E | |
| Sets the name of the database file containing the list of user groups for authorization | |||
| AuthDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| パスワードを保存するために必要なデータベースファイルの種類を 設定する | |||
| AuthDBMUserFile file-path | dh | E | |
| 認証用のユーザとパスワードのリストを保持している データベースファイル名を設定する | |||
| AuthDigestAlgorithm MD5|MD5-sess | MD5 | dh | E |
| Selects the algorithm used to calculate the challenge and response hashes in digest authentication | |||
| AuthDigestDomain URI [URI] ... | dh | E | |
| URIs that are in the same protection space for digest authentication | |||
| AuthDigestNonceLifetime seconds | 300 | dh | E |
| How long the server nonce is valid | |||
| AuthDigestProvider provider-name [provider-name] ... | file | dh | E |
| Sets the authentication provider(s) for this location | |||
| AuthDigestQop none|auth|auth-int [auth|auth-int] | auth | dh | E |
| Determines the quality-of-protection to use in digest authentication | |||
| AuthDigestShmemSize size | 1000 | s | E |
| The amount of shared memory to allocate for keeping track of clients | |||
| AuthFormAuthoritative On|Off | On | dh | B |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthFormBody fieldname | httpd_body | d | B |
| The name of a form field carrying the body of the request to attempt on successful login | |||
| AuthFormDisableNoStore On|Off | Off | d | B |
| Disable the CacheControl no-store header on the login page | |||
| AuthFormFakeBasicAuth On|Off | Off | d | B |
| Fake a Basic Authentication header | |||
| AuthFormLocation fieldname | httpd_location | d | B |
| The name of a form field carrying a URL to redirect to on successful login | |||
| AuthFormLoginRequiredLocation url | d | B | |
| The URL of the page to be redirected to should login be required | |||
| AuthFormLoginSuccessLocation url | d | B | |
| The URL of the page to be redirected to should login be successful | |||
| AuthFormLogoutLocation uri | d | B | |
| The URL to redirect to after a user has logged out | |||
| AuthFormMethod fieldname | httpd_method | d | B |
| The name of a form field carrying the method of the request to attempt on successful login | |||
| AuthFormMimetype fieldname | httpd_mimetype | d | B |
| The name of a form field carrying the mimetype of the body of the request to attempt on successful login | |||
| AuthFormPassword fieldname | httpd_password | d | B |
| The name of a form field carrying the login password | |||
| AuthFormProvider provider-name [provider-name] ... | file | dh | B |
| Sets the authentication provider(s) for this location | |||
| AuthFormSitePassphrase secret | d | B | |
| Bypass authentication checks for high traffic sites | |||
| AuthFormSize size | 8192 | d | B |
| The largest size of the form in bytes that will be parsed for the login details | |||
| AuthFormUsername fieldname | httpd_username | d | B |
| The name of a form field carrying the login username | |||
| AuthGroupFile file-path | dh | B | |
| 証認に使用するユーザグループの一覧が格納されている、 テキストファイルの名前を設定する | |||
| AuthLDAPAuthorizePrefix prefix | AUTHORIZE_ | dh | E |
| Specifies the prefix for environment variables set during authorization | |||
| AuthLDAPBindAuthoritative off|on | on | dh | E |
| Determines if other authentication providers are used when a user can be mapped to a DN but the server cannot successfully bind with the user's credentials. | |||
| AuthLDAPBindDN distinguished-name | dh | E | |
| Optional DN to use in binding to the LDAP server | |||
| AuthLDAPBindPassword password | dh | E | |
| Password used in conjunction with the bind DN | |||
| AuthLDAPCharsetConfig file-path | s | E | |
| Language to charset conversion configuration file | |||
| AuthLDAPCompareAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization comparisons | |||
| AuthLDAPCompareDNOnServer on|off | on | dh | E |
| Use the LDAP server to compare the DNs | |||
| AuthLDAPDereferenceAliases never|searching|finding|always | always | dh | E |
| When will the module de-reference aliases | |||
| AuthLDAPGroupAttribute attribute | member uniqueMember + | dh | E |
| LDAP attributes used to identify the user members of groups. | |||
| AuthLDAPGroupAttributeIsDN on|off | on | dh | E |
| Use the DN of the client username when checking for group membership | |||
| AuthLDAPInitialBindAsUser off|on | off | dh | E |
| Determines if the server does the initial DN lookup using the basic authentication users' own username, instead of anonymously or with hard-coded credentials for the server | |||
| AuthLDAPInitialBindPattern regex substitution | (.*) $1 (remote use + | dh | E |
| Specifies the transformation of the basic authentication username to be used when binding to the LDAP server to perform a DN lookup | |||
| AuthLDAPMaxSubGroupDepth Number | 10 | dh | E |
| Specifies the maximum sub-group nesting depth that will be evaluated before the user search is discontinued. | |||
| AuthLDAPRemoteUserAttribute uid | dh | E | |
| Use the value of the attribute returned during the user query to set the REMOTE_USER environment variable | |||
| AuthLDAPRemoteUserIsDN on|off | off | dh | E |
| Use the DN of the client username to set the REMOTE_USER environment variable | |||
| AuthLDAPSearchAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization searches | |||
| AuthLDAPSubGroupAttribute attribute | member uniqueMember + | dh | E |
| Specifies the attribute labels, one value per directive line, used to distinguish the members of the current group that are groups. | |||
| AuthLDAPSubGroupClass LdapObjectClass | groupOfNames groupO + | dh | E |
| Specifies which LDAP objectClass values identify directory objects that are groups during sub-group processing. | |||
| AuthLDAPURL url [NONE|SSL|TLS|STARTTLS] | dh | E | |
| URL specifying the LDAP search parameters | |||
| AuthMerging Off | And | Or | Off | dh | B |
| Controls the manner in which each configuration section's authorization logic is combined with that of preceding configuration sections. | |||
| AuthName auth-domain | dh | B | |
| Authorization realm for use in HTTP authentication | |||
| AuthnCacheContext directory|server|custom-string | directory | d | B |
| Specify a context string for use in the cache key | |||
| AuthnCacheEnable | s | B | |
| Enable Authn caching configured anywhere | |||
| AuthnCacheProvideFor authn-provider [...] | dh | B | |
| Specify which authn provider(s) to cache for | |||
| AuthnCacheSOCache provider-name[:provider-args] | s | B | |
| Select socache backend provider to use | |||
| AuthnCacheTimeout timeout (seconds) | 300 (5 minutes) | dh | B |
| Set a timeout for cache entries | |||
| <AuthnProviderAlias baseProvider Alias> ... </AuthnProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authentication provider and referenced by the specified alias | |||
AuthnzFcgiCheckAuthnProvider provider-name|None
option ... | d | E | |
| Enables a FastCGI application to handle the check_authn authentication hook. | |||
| AuthnzFcgiDefineProvider type provider-name backend-address | s | E | |
| Defines a FastCGI application as a provider for authentication and/or authorization | |||
| AuthType None|Basic|Digest|Form | dh | B | |
| Type of user authentication | |||
| AuthUserFile file-path | dh | B | |
| 認証に使用するユーザとパスワードの一覧が格納されている、 テキストファイルの名前を設定する | |||
| AuthzDBDLoginToReferer On|Off | Off | d | E |
Determines whether to redirect the Client to the Referring
page on successful login or logout if a Referer request
header is present | |||
| AuthzDBDQuery query | d | E | |
| Specify the SQL Query for the required operation | |||
| AuthzDBDRedirectQuery query | d | E | |
| Specify a query to look up a login page for the user | |||
| AuthzDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Sets the type of database file that is used to store list of user groups | |||
| <AuthzProviderAlias baseProvider Alias Require-Parameters> ... </AuthzProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authorization provider and referenced by the specified alias | |||
| AuthzSendForbiddenOnFailure On|Off | Off | dh | B |
| Send '403 FORBIDDEN' instead of '401 UNAUTHORIZED' if authentication succeeds but authorization fails | |||
| BalancerGrowth # | 5 | sv | E |
| Number of additional Balancers that can be added Post-configuration | |||
| BalancerInherit On|Off | On | sv | E |
| Inherit ProxyPassed Balancers/Workers from the main server | |||
| d | E | ||
| Add a member to a load balancing group | |||
| BalancerPersist On|Off | Off | sv | E |
| Attempt to persist changes made by the Balancer Manager across restarts. | |||
| BrotliAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| BrotliCompressionMaxInputBlock value | sv | E | |
| Maximum input block size | |||
| BrotliCompressionQuality value | 5 | sv | E |
| Compression quality | |||
| BrotliCompressionWindow value | 18 | sv | E |
| Brotli sliding compression window size | |||
| BrotliFilterNote [type] notename | sv | E | |
| Places the compression ratio in a note for logging | |||
| BrowserMatch regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| HTTP User-Agent に基づいて環境変数を設定する | |||
| BrowserMatchNoCase regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| HTTP User-Agent に基づいて大文字小文字を区別せずに 環境変数を設定する | |||
| BufferedLogs On|Off | Off | s | B |
| ディスクに書き出す前にメモリにログエントリをバッファする | |||
| BufferSize integer | 131072 | svdh | E |
| Maximum size in bytes to buffer by the buffer filter | |||
| CacheDefaultExpire seconds | 3600 (1時間) | sv | E |
| 期日が指定されていないときにドキュメントをキャッシュするデフォルトの期間 | |||
| CacheDetailHeader on|off | off | svdh | E |
| Add an X-Cache-Detail header to the response. | |||
| CacheDirLength length | 2 | sv | E |
| サブディレクトリ名の文字数 | |||
| CacheDirLevels levels | 2 | sv | E |
| キャッシュのサブディレクトリの深さの数 | |||
| CacheDisable url-string | sv | E | |
| 特定の URL をキャッシュしない | |||
| CacheEnable cache_type url-string | sv | E | |
| 指定したストレージ管理方式を使ってのキャッシュを有効にする | |||
| CacheFile file-path [file-path] ... | s | X | |
| Cache a list of file handles at startup time | |||
| CacheHeader on|off | off | svdh | E |
| Add an X-Cache header to the response. | |||
| CacheIgnoreCacheControl On|Off | Off | sv | E |
| キャッシュされているコンテンツを返さないようにクライアントから リクエストされても無視する | |||
| CacheIgnoreHeaders header-string [header-string] ... | None | sv | E |
| 指定された HTTP ヘッダをキャッシュに保存しない。 | |||
| CacheIgnoreNoLastMod On|Off | Off | sv | E |
| 応答に Last Modified が無くても気にしないようにする | |||
| CacheIgnoreQueryString On|Off | Off | sv | E |
| キャッシュ時にクエリーストリングを無視する | |||
| CacheIgnoreURLSessionIdentifiers identifier [identifier] ... | None | sv | E |
| Ignore defined session identifiers encoded in the URL when caching | |||
| CacheKeyBaseURL URL | sv | E | |
| Override the base URL of reverse proxied cache keys. | |||
| CacheLastModifiedFactor float | 0.1 | sv | E |
| LastModified の日付に基づいて有効期限 (expiry) を計算するための重みを指定する | |||
| CacheLock on|off | off | sv | E |
| Enable the thundering herd lock. | |||
| CacheLockMaxAge integer | 5 | sv | E |
| Set the maximum possible age of a cache lock. | |||
| CacheLockPath directory | /tmp/mod_cache-lock + | sv | E |
| Set the lock path directory. | |||
| CacheMaxExpire seconds | 86400 (一日) | sv | E |
| ドキュメントをキャッシュする最大時間を秒数で表したもの | |||
| CacheMaxFileSize bytes | 1000000 | sv | E |
| キャッシュに保管されるドキュメントの最大の (バイトでの) サイズ | |||
| CacheMinExpire seconds | 0 | sv | E |
| ドキュメントをキャッシュする最小秒数 | |||
| CacheMinFileSize bytes | 1 | sv | E |
| キャッシュに保管されるドキュメントの最小限の (バイトでの) 大きさ | |||
| CacheNegotiatedDocs On|Off | Off | sv | B |
| コンテントネゴシエーションされたドキュメントをプロキシサーバが キャッシュできるようにする | |||
| CacheQuickHandler on|off | on | sv | E |
| Run the cache from the quick handler. | |||
| svdh | E | ||
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| svdh | E | ||
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheRoot directory | sv | E | |
| キャッシュファイルが保管されるルートディレクトリ | |||
| CacheSocache type[:args] | sv | E | |
| The shared object cache implementation to use | |||
| CacheSocacheMaxSize bytes | 102400 | svdh | E |
| The maximum size (in bytes) of an entry to be placed in the cache | |||
| CacheSocacheMaxTime seconds | 86400 | svdh | E |
| The maximum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheMinTime seconds | 600 | svdh | E |
| The minimum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheReadSize bytes | 0 | svdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheSocacheReadTime milliseconds | 0 | svdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheStaleOnError on|off | on | svdh | E |
| Serve stale content in place of 5xx responses. | |||
| CacheStoreExpired On|Off | Off | svdh | E |
| Attempt to cache responses that the server reports as expired | |||
| CacheStoreNoStore On|Off | Off | sv | E |
| no-store と指定されているレスポンスのキャッシュを試みる。 | |||
| CacheStorePrivate On|Off | Off | sv | E |
| private と指定されているレスポンスのキャッシュを試みる。 | |||
| CGIDScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIMapExtension cgi-path .extension | dh | C | |
| CGI スクリプトのインタープリタの位置を調べるための手法 | |||
| CGIPassAuth On|Off | Off | dh | C |
| Enables passing HTTP authorization headers to scripts as CGI variables | |||
| CGIScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIVar variable rule | dh | C | |
| Controls how some CGI variables are set | |||
| CharsetDefault charset | svdh | E | |
| Charset to translate into | |||
| CharsetOptions option [option] ... | ImplicitAdd | svdh | E |
| Configures charset translation behavior | |||
| CharsetSourceEnc charset | svdh | E | |
| Source charset of files | |||
| CheckBasenameMatch on|off | On | svdh | E |
| Also match files with differing file name extensions. | |||
| CheckCaseOnly on|off | Off | svdh | E |
| 大文字小文字の修正だけ行うようにする | |||
| CheckSpelling on|off | Off | svdh | E |
| spelling モジュールを使用するようにする | |||
| ChrootDir /path/to/directory | s | B | |
| Directory for apache to run chroot(8) after startup. | |||
| ContentDigest On|Off | Off | svdh | C |
Content-MD5 HTTP 応答ヘッダの生成を有効にする | |||
| CookieDomain domain | svdh | E | |
| The domain to which the tracking cookie applies | |||
| CookieExpires expiry-period | svdh | E | |
| Expiry time for the tracking cookie | |||
| CookieHTTPOnly on|off | off | svdh | E |
| Adds the 'HTTPOnly' attribute to the cookie | |||
| CookieName token | Apache | svdh | E |
| Name of the tracking cookie | |||
| CookieSameSite None|Lax|Strict | svdh | E | |
| Adds the 'SameSite' attribute to the cookie | |||
| CookieSecure on|off | off | svdh | E |
| Adds the 'Secure' attribute to the cookie | |||
| CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965 | Netscape | svdh | E |
| Format of the cookie header field | |||
| CookieTracking on|off | off | svdh | E |
| Enables tracking cookie | |||
| CoreDumpDirectory directory | s | M | |
| Apache がコアダンプする前に移動を試みるディレクトリ | |||
| CustomLog file|pipe format|nickname [env=[!]environment-variable] | sv | B | |
| ログファイルの名前と書式を設定する | |||
| Dav On|Off|provider-name | Off | d | E |
| WebDAV HTTP メソッドを有効にします | |||
| DavBasePath root-path | d | E | |
| Configure repository root path | |||
| DavDepthInfinity on|off | off | svd | E |
| PROPFIND, Depth: Infinity リクエストを許可します | |||
| DavGenericLockDB file-path | svd | E | |
| DAV ロックデータベースの場所 | |||
| DavLockDB file-path | sv | E | |
| DAV ロックデータベースの位置 | |||
| DavLockDiscovery on|off | on | svdh | E |
| Enable lock discovery | |||
| DavMinTimeout seconds | 0 | svd | E |
| サーバが DAV リソースのロックを維持する最小時間です。 | |||
| DBDExptime time-in-seconds | 300 | sv | E |
| Keepalive time for idle connections | |||
| DBDInitSQL "SQL statement" | sv | E | |
| Execute an SQL statement after connecting to a database | |||
| DBDKeep number | 2 | sv | E |
| Maximum sustained number of connections | |||
| DBDMax number | 10 | sv | E |
| Maximum number of connections | |||
| DBDMin number | 1 | sv | E |
| Minimum number of connections | |||
| DBDParams param1=value1[,param2=value2] | sv | E | |
| Parameters for database connection | |||
| DBDPersist On|Off | sv | E | |
| Whether to use persistent connections | |||
| DBDPrepareSQL "SQL statement" label | sv | E | |
| Define an SQL prepared statement | |||
| DBDriver name | sv | E | |
| Specify an SQL driver | |||
| DefaultIcon url-path | svdh | B | |
| 特定のアイコンが何も設定されていない時に ファイルに表示するアイコン | |||
| DefaultLanguage MIME-lang | svdh | ||
| あるスコープのすべてのファイルを指定された言語に 設定する | |||
| DefaultRuntimeDir directory-path | DEFAULT_REL_RUNTIME + | s | C |
| Base directory for the server run-time files | |||
| DefaultType MIME-type|none | text/plain | svdh | C |
| サーバがコンテントタイプを決定できないときに 送られる MIME コンテントタイプ | |||
| Define parameter-name | s | C | |
| 変数の存在を宣言する | |||
| DeflateAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| DeflateBufferSize value | 8096 | sv | E |
| zlib が一度に圧縮する塊の大きさ | |||
| DeflateCompressionLevel value | sv | E | |
| 出力に対して行なう圧縮の程度 | |||
| DeflateFilterNote [type] notename | sv | E | |
| ロギング用に圧縮比をメモに追加 | |||
| DeflateInflateLimitRequestBody value | svdh | E | |
| Maximum size of inflated request bodies | |||
| DeflateInflateRatioBurst value | 3 | svdh | E |
| Maximum number of times the inflation ratio for request bodies can be crossed | |||
| DeflateInflateRatioLimit value | 200 | svdh | E |
| Maximum inflation ratio for request bodies | |||
| DeflateMemLevel value | 9 | sv | E |
| zlib が圧縮に使うメモリのレベルを指定 | |||
| DeflateWindowSize value | 15 | sv | E |
| Zlib の圧縮用ウィンドウの大きさ | |||
| Deny from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| サーバがアクセスを拒否するホストを制御する | |||
| <Directory directory-path> ... </Directory> | sv | C | |
| 指定のファイルシステムのディレクトリとサブディレクトリとのみに 適用されるディレクティブを囲む | |||
| DirectoryCheckHandler On|Off | Off | svdh | B |
| Toggle how this module responds when another handler is configured | |||
| DirectoryIndex local-url [local-url] ... | index.html | svdh | B |
| クライアントがディレクトリをリクエストしたときに調べる リソースのリスト | |||
| DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-code | off | svdh | B |
| Configures an external redirect for directory indexes. | |||
| <DirectoryMatch regex> ... </DirectoryMatch> | sv | C | |
| 正規表現にマッチするファイルシステムのディレクトリと サブディレクトリとのみに適用されるディレクティブを囲む | |||
| DirectorySlash On|Off | On | svdh | B |
| パス末尾のスラッシュでリダイレクトするかどうかのオンオフをトグルさせる | |||
| DocumentRoot directory-path | /usr/local/apache/h + | sv | C |
| ウェブから見えるメインのドキュメントツリーになる ディレクトリ | |||
| DTracePrivileges On|Off | Off | s | X |
| Determines whether the privileges required by dtrace are enabled. | |||
| DumpIOInput On|Off | Off | s | E |
| エラーログにすべての入力データをダンプ | |||
| DumpIOOutput On|Off | Off | s | E |
| エラーログにすべての出力データをダンプ | |||
| <Else> ... </Else> | svdh | C | |
Contains directives that apply only if the condition of a
previous <If> or
<ElseIf> section is not
satisfied by a request at runtime | |||
| <ElseIf expression> ... </ElseIf> | svdh | C | |
Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
<If> or
<ElseIf> section is not
satisfied | |||
| EnableExceptionHook On|Off | Off | s | M |
| クラッシュの後に例外ハンドラを実行するフックを有効にする | |||
| EnableMMAP On|Off | On | svdh | C |
| 配送中にファイルを読み込むためにメモリマッピングを 使うかどうか | |||
| EnableSendfile On|Off | On | svdh | C |
| ファイルのクライアントへの配送時にカーネルの sendfile サポートを 使うかどうか | |||
| Error message | svdh | C | |
| Abort configuration parsing with a custom error message | |||
| ErrorDocument error-code document | svdh | C | |
| エラーが発生したときにサーバがクライアントに送るもの | |||
| ErrorLog file-path|syslog[:facility] | logs/error_log (Uni + | sv | C |
| サーバがエラーをログ収集する場所 | |||
| ErrorLogFormat [connection|request] format | sv | C | |
| Format specification for error log entries | |||
| Example | svdh | X | |
| Demonstration directive to illustrate the Apache module API | |||
| ExpiresActive On|Off | svdh | E | |
Expires ヘッダの生成を有効にする | |||
| ExpiresByType MIME-type <code>seconds | svdh | E | |
MIME タイプによって設定される Expires ヘッダの値 | |||
| ExpiresDefault <code>seconds | svdh | E | |
| 期限切れ期日を計算するデフォルトアルゴリズム | |||
| ExtendedStatus On|Off | Off[*] | s | C |
| Keep track of extended status information for each request | |||
| ExtFilterDefine filtername parameters | s | E | |
| 外部フィルタを定義 | |||
| ExtFilterOptions option [option] ... | DebugLevel=0 NoLogS + | d | E |
mod_ext_filter のオプションを設定 | |||
| svdh | B | ||
| Define a default URL for requests that don't map to a file | |||
| FileETag component ... | INode MTime Size | svdh | C |
| ETag HTTP 応答ヘッダを作成するために使用される ファイルの属性 | |||
| <Files filename> ... </Files> | svdh | C | |
| マッチするファイル名に適用されるディレクティブを囲む | |||
| <FilesMatch regex> ... </FilesMatch> | svdh | C | |
| 正規表現にマッチするファイル名に適用される ディレクティブを囲む | |||
| FilterChain [+=-@!]filter-name ... | svdh | B | |
| Configure the filter chain | |||
| FilterDeclare filter-name [type] | svdh | B | |
| Declare a smart filter | |||
| FilterProtocol filter-name [provider-name] proto-flags | svdh | B | |
| Deal with correct HTTP protocol handling | |||
| FilterProvider filter-name provider-name expression | svdh | B | |
| Register a content filter | |||
| FilterTrace filter-name level | svd | B | |
Get debug/diagnostic information from
mod_filter | |||
| FlushMaxPipelined number | 5 | sv | C |
| Maximum number of pipelined responses above which they are flushed to the network | |||
| FlushMaxThreshold number-of-bytes | 65535 | sv | C |
| Threshold above which pending data are flushed to the network | |||
| ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] | Prefer | svdh | B |
| 要求に合う単独のドキュメントが見つからなかったときに行なうことを指定 | |||
| ForceType MIME-type|None | dh | C | |
| すべてのマッチするファイルが指定の MIME コンテントタイプで 送られるようにする | |||
| ForensicLog filename|pipe | sv | E | |
| Forensic ログのファイル名を設定する | |||
| GlobalLogfile|pipe format|nickname [env=[!]environment-variable| expr=expression] | s | B | |
| Sets filename and format of log file | |||
| GprofDir /tmp/gprof/|/tmp/gprof/% | sv | C | |
| Directory to write gmon.out profiling data to. | |||
| GracefulShutDownTimeout seconds | s | M | |
| 穏やかな停止をかけた後、終了するまで待つ時間 | |||
| Group unix-group | #-1 | s | B |
| Group under which the server will answer requests | |||
| H2CopyFiles on|off | off | svdh | E |
| Determine file handling in responses | |||
| H2Direct on|off | on for h2c, off for + | sv | E |
| H2 Direct Protocol Switch | |||
| H2EarlyHint name value | svdh | E | |
| Add a response header to be picked up in 103 Early Hints | |||
| H2EarlyHints on|off | off | sv | E |
| Determine sending of 103 status codes | |||
| H2MaxDataFrameLen n | 0 | sv | E |
| Maximum bytes inside a single HTTP/2 DATA frame | |||
| H2MaxHeaderBlockLen n | 0 | sv | E |
| Maximum size of response headers | |||
| H2MaxSessionStreams n | 100 | sv | E |
| Maximum number of active streams per HTTP/2 session. | |||
| H2MaxWorkerIdleSeconds n | 600 | s | E |
| Maximum number of seconds h2 workers remain idle until shut down. | |||
| H2MaxWorkers n | s | E | |
| Maximum number of worker threads to use per child process. | |||
| H2MinWorkers n | s | E | |
| Minimal number of worker threads to use per child process. | |||
| H2ModernTLSOnly on|off | on | sv | E |
| Require HTTP/2 connections to be "modern TLS" only | |||
| H2OutputBuffering on|off | on | sv | E |
| Determine buffering behaviour of output | |||
| H2Padding numbits | 0 | sv | E |
| Determine the range of padding bytes added to payload frames | |||
| H2ProxyRequests on|off | off | sv | E |
| En-/Disable forward proxy requests via HTTP/2 | |||
| H2Push on|off | on | svdh | E |
| H2 Server Push Switch | |||
| H2PushDiarySize n | 256 | sv | E |
| H2 Server Push Diary Size | |||
| H2PushPriority mime-type [after|before|interleaved] [weight] | * After 16 | sv | E |
| H2 Server Push Priority | |||
| H2PushResource [add] path [critical] | svdh | E | |
| Declares resources for early pushing to the client | |||
| H2SerializeHeaders on|off | off | sv | E |
| Serialize Request/Response Processing Switch | |||
| H2StreamMaxMemSize bytes | 65536 | sv | E |
| Maximum amount of output data buffered per stream. | |||
| H2StreamTimeout time-interval[s] | svd | E | |
| Maximum time waiting when sending/receiving data to stream processing | |||
| H2TLSCoolDownSecs seconds | 1 | sv | E |
| Configure the number of seconds of idle time on TLS before shrinking writes | |||
| H2TLSWarmUpSize amount | 1048576 | sv | E |
| Configure the number of bytes on TLS connection before doing max writes | |||
| H2Upgrade on|off | on for h2c, off for + | svdh | E |
| H2 Upgrade Protocol Switch | |||
| H2WebSockets on|off | off | sv | E |
| En-/Disable WebSockets via HTTP/2 | |||
| H2WindowSize bytes | 65535 | sv | E |
| Size of Stream Window for upstream data. | |||
| Header [condition] set|append|add|unset|echo header [value] [early|env=[!]variable] | svdh | E | |
| HTTP 応答ヘッダの設定 | |||
| HeaderName filename | svdh | B | |
| インデックス一覧の先頭に挿入されるファイルの名前 | |||
| HeartbeatAddress addr:port | s | X | |
| Multicast address for heartbeat packets | |||
| HeartbeatListen addr:port | s | X | |
| multicast address to listen for incoming heartbeat requests | |||
| HeartbeatMaxServers number-of-servers | 10 | s | X |
| Specifies the maximum number of servers that will be sending heartbeat requests to this server | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to store heartbeat data when using flat-file storage | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to read heartbeat data | |||
| HostnameLookups On|Off|Double | Off | svd | C |
| クライアントの IP アドレスの DNS ルックアップを 有効にする | |||
| HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods] [Allow0.9|Require1.0] | Strict LenientMetho + | sv | C |
| Modify restrictions on HTTP Request Messages | |||
| IdentityCheck On|Off | Off | svd | E |
| リモートユーザの RFC 1413 によるアイデンティティのロギングを 有効にする | |||
| IdentityCheckTimeout seconds | 30 | svd | E |
| Ident リクエストがタイムアウトするまでの期間を決める | |||
| <If expression> ... </If> | svdh | C | |
| 実行時、リクエストが条件を満たした場合にのみ適用される ディレクティブを包含する | |||
| <IfDefine [!]parameter-name> ... </IfDefine> | svdh | C | |
| 起動時にテストが真であるときのみに処理されるディレクティブを 囲む | |||
| <IfDirective [!]directive-name> ... </IfDirective> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific directive | |||
| <IfFile [!]filename> ... </IfFile> | svdh | C | |
| Encloses directives that will be processed only if file exists at startup | |||
| <IfModule [!]module-file|module-identifier> ... </IfModule> | svdh | C | |
| モジュールの存在するかしないかに応じて処理される ディレクティブを囲む | |||
| <IfSection [!]section-name> ... </IfSection> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific section directive | |||
| <IfVersion [[!]operator] version> ... </IfVersion> | svdh | E | |
| バージョン依存の設定を入れる | |||
| ImapBase map|referer|URL | http://servername/ | svdh | B |
Default base for imagemap files | |||
| ImapDefault error|nocontent|map|referer|URL | nocontent | svdh | B |
| Default action when an imagemap is called with coordinates that are not explicitly mapped | |||
| ImapMenu none|formatted|semiformatted|unformatted | formatted | svdh | B |
| Action if no coordinates are given when calling an imagemap | |||
| Include file-path|directory-path | svd | C | |
| サーバ設定ファイル中から他の設定ファイルを取り込む | |||
| IncludeOptional file-path|directory-path|wildcard | svd | C | |
| Includes other configuration files from within the server configuration files | |||
| IndexHeadInsert "markup ..." | svdh | B | |
| インデックスページの HEAD セクションにテキストを挿入する | |||
| IndexIgnore file [file] ... | svdh | B | |
| ディレクトリ一覧を行なう際に無視すべき ファイルリストに追加 | |||
| IndexIgnoreReset ON|OFF | svdh | B | |
| Empties the list of files to hide when listing a directory | |||
| IndexOptions [+|-]option [[+|-]option] ... | svdh | B | |
| ディレクトリインデックスの様々な設定項目 | |||
| IndexOrderDefault Ascending|Descending Name|Date|Size|Description | Ascending Name | svdh | B |
| ディレクトリインデックスの標準の順番付けを設定 | |||
| IndexStyleSheet url-path | svdh | B | |
| ディレクトリインデックスに CSS スタイルシートを追加する | |||
| InputSed sed-command | dh | X | |
Sed command to filter request data (typically POST data) | |||
| ISAPIAppendLogToErrors on|off | off | svdh | B |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the error log | |||
| ISAPIAppendLogToQuery on|off | on | svdh | B |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the query field | |||
| ISAPICacheFile file-path [file-path] ... | sv | B | |
| ISAPI .dll files to be loaded at startup | |||
| ISAPIFakeAsync on|off | off | svdh | B |
| Fake asynchronous support for ISAPI callbacks | |||
| ISAPILogNotSupported on|off | off | svdh | B |
| Log unsupported feature requests from ISAPI extensions | |||
| ISAPIReadAheadBuffer size | 49152 | svdh | B |
| Size of the Read Ahead Buffer sent to ISAPI extensions | |||
| KeepAlive On|Off | On | sv | C |
| HTTP の持続的な接続を有効にする | |||
| KeepAliveTimeout seconds | 5 | sv | C |
| 持続的な接続で次のリクエストが来るまでサーバが待つ時間 | |||
| KeptBodySize maximum size in bytes | 0 | d | B |
| Keep the request body instead of discarding it up to the specified maximum size, for potential use by filters such as mod_include. | |||
| LanguagePriority MIME-lang [MIME-lang] ... | svdh | B | |
| クライアントが優先度を示さなかったときの言語の variant の優先度を 指定 | |||
| LDAPCacheEntries number | 1024 | s | E |
| Maximum number of entries in the primary LDAP cache | |||
| LDAPCacheTTL seconds | 600 | s | E |
| Time that cached items remain valid | |||
| LDAPConnectionPoolTTL n | -1 | sv | E |
| Discard backend connections that have been sitting in the connection pool too long | |||
| LDAPConnectionTimeout seconds | s | E | |
| Specifies the socket connection timeout in seconds | |||
| LDAPLibraryDebug 7 | s | E | |
| Enable debugging in the LDAP SDK | |||
| LDAPOpCacheEntries number | 1024 | s | E |
| Number of entries used to cache LDAP compare operations | |||
| LDAPOpCacheTTL seconds | 600 | s | E |
| Time that entries in the operation cache remain valid | |||
| LDAPReferralHopLimit number | dh | E | |
| The maximum number of referral hops to chase before terminating an LDAP query. | |||
| LDAPReferrals On|Off|default | On | dh | E |
| Enable referral chasing during queries to the LDAP server. | |||
| LDAPRetries number-of-retries | 3 | s | E |
| Configures the number of LDAP server retries. | |||
| LDAPRetryDelay seconds | 0 | s | E |
| Configures the delay between LDAP server retries. | |||
| LDAPSharedCacheFile directory-path/filename | s | E | |
| Sets the shared memory cache file | |||
| LDAPSharedCacheSize bytes | 500000 | s | E |
| Size in bytes of the shared-memory cache | |||
| LDAPTimeout seconds | 60 | s | E |
| Specifies the timeout for LDAP search and bind operations, in seconds | |||
| LDAPTrustedClientCert type directory-path/filename/nickname [password] | dh | E | |
| Sets the file containing or nickname referring to a per connection client certificate. Not all LDAP toolkits support per connection client certificates. | |||
| LDAPTrustedGlobalCert type directory-path/filename [password] | s | E | |
| Sets the file or database containing global trusted Certificate Authority or global client certificates | |||
| LDAPTrustedMode type | sv | E | |
| Specifies the SSL/TLS mode to be used when connecting to an LDAP server. | |||
| LDAPVerifyServerCert On|Off | On | s | E |
| Force server certificate verification | |||
| <Limit method [method] ... > ... </Limit> | svdh | C | |
| 囲いの中にあるアクセス制御の適用を特定の HTTP メソッドのみに 制限する | |||
| <LimitExcept method [method] ... > ... </LimitExcept> | svdh | C | |
| 指定されたもの以外の HTTP メソッドにアクセス制御を 制限する | |||
| LimitInternalRecursion number [number] | 10 | sv | C |
| 内部リダイレクトと入れ子になったサブリクエストの最大数を決定する | |||
| LimitRequestBody bytes | 0 | svdh | C |
| クライアントから送られる HTTP リクエストのボディの 総量を制限する | |||
| LimitRequestFields number | 100 | s | C |
| クライアントからの HTTP リクエストのヘッダフィールドの数を 制限する | |||
| LimitRequestFieldSize bytes | 8190 | s | C |
| クライアントからの HTTP リクエストのヘッダの サイズを制限する | |||
| LimitRequestLine bytes | 8190 | s | C |
| クライアントからの HTTP リクエスト行のサイズを制限する | |||
| LimitXMLRequestBody bytes | 1000000 | svdh | C |
| XML 形式のリクエストのボディのサイズを制限する | |||
| Listen [IP-address:]portnumber [protocol] | s | M | |
| サーバが listen するIP アドレスとポート番号 | |||
| ListenBacklog backlog | s | M | |
| 保留状態のコネクションのキューの最大長 | |||
| ListenCoresBucketsRatio ratio | 0 (disabled) | s | M |
| Ratio between the number of CPU cores (online) and the number of listeners' buckets | |||
| LoadFile filename [filename] ... | sv | E | |
| 指定されたオブジェクトファイルやライブラリをリンクする | |||
| LoadModule module filename | sv | E | |
| オブジェクトファイルやライブラリをリンクし、使用モジュールの リストに追加する | |||
| <Location URL-path|URL> ... </Location> | sv | C | |
| 囲んだディレクティブをマッチする URL のみに適用 | |||
| <LocationMatch regex> ... </LocationMatch> | sv | C | |
| 囲んだディレクティブを正規表現にマッチする URL のみに 適用 | |||
| LogFormat format|nickname [nickname] | "%h %l %u %t \"%r\" + | sv | B |
| ログファイルで使用する書式を設定する | |||
| LogIOTrackTTFB ON|OFF | OFF | svdh | E |
| Enable tracking of time to first byte (TTFB) | |||
| LogLevel level | warn | sv | C |
| ErrorLog の冗長性を制御する | |||
| LogMessage message [hook=hook] [expr=expression] | d | X | |
| Log user-defined message to error log | |||
| LuaAuthzProvider provider_name /path/to/lua/script.lua function_name | s | E | |
Plug an authorization provider function into mod_authz_core
| |||
| LuaCodeCache stat|forever|never | stat | svdh | E |
| Configure the compiled code cache. | |||
| LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the access_checker phase of request processing | |||
| LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the auth_checker phase of request processing | |||
| LuaHookCheckUserID /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the check_user_id phase of request processing | |||
| LuaHookFixups /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the fixups phase of a request processing | |||
| LuaHookInsertFilter /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the insert_filter phase of request processing | |||
| LuaHookLog /path/to/lua/script.lua log_function_name | svdh | E | |
| Provide a hook for the access log phase of a request processing | |||
| LuaHookMapToStorage /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the map_to_storage phase of request processing | |||
| LuaHookPreTranslate /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the pre_translate phase of a request processing | |||
| LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late] | sv | E | |
| Provide a hook for the translate name phase of request processing | |||
| LuaHookTypeChecker /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the type_checker phase of request processing | |||
| LuaInherit none|parent-first|parent-last | parent-first | svdh | E |
| Controls how parent configuration sections are merged into children | |||
| LuaInputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content input filtering | |||
| LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name] | svdh | E | |
| Map a path to a lua handler | |||
| LuaOutputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content output filtering | |||
| LuaPackageCPath /path/to/include/?.soa | svdh | E | |
| Add a directory to lua's package.cpath | |||
| LuaPackagePath /path/to/include/?.lua | svdh | E | |
| Add a directory to lua's package.path | |||
| LuaQuickHandler /path/to/script.lua hook_function_name | sv | E | |
| Provide a hook for the quick handler of request processing | |||
| LuaRoot /path/to/a/directory | svdh | E | |
| Specify the base path for resolving relative paths for mod_lua directives | |||
| LuaScope once|request|conn|thread|server [min] [max] | once | svdh | E |
| One of once, request, conn, thread -- default is once | |||
| <Macro name [par1 .. parN]> ... </Macro> | svd | B | |
| Define a configuration file macro | |||
| MaxConnectionsPerChild number | 0 | s | M |
| Limit on the number of connections that an individual child server will handle during its life | |||
| MaxKeepAliveRequests number | 100 | sv | C |
| 持続的な接続上で許可されるリクエストの数 | |||
| MaxMemFree KBytes | 0 | s | M |
free() が呼ばれない限り、
主メモリアロケータが保持し続けられるメモリの最大量 | |||
| MaxRangeOverlaps default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete
resource | |||
| MaxRangeReversals default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of range reversals (eg: 100-200,50-70) allowed before returning the complete
resource | |||
| MaxRanges default | unlimited | none | number-of-ranges | 200 | svd | C |
| Number of ranges allowed before returning the complete resource | |||
| MaxRequestWorkers number | s | M | |
| Maximum number of connections that will be processed simultaneously | |||
| MaxSpareServers number | 10 | s | M |
| アイドルな子サーバプロセスの最大個数 | |||
| MaxSpareThreads number | s | M | |
| アイドルスレッドの最大数 | |||
| MaxThreads number | 2048 | s | M |
| Set the maximum number of worker threads | |||
| MDActivationDelay duration | s | X | |
| How long to delay activation of new certificates | |||
| MDBaseServer on|off | off | s | X |
| Control if base server may be managed or only virtual hosts. | |||
| MDCAChallenges name [ name ... ] | tls-alpn-01 http-01 + | s | X |
| Type of ACME challenge used to prove domain ownership. | |||
| MDCertificateAgreement accepted | s | X | |
| You confirm that you accepted the Terms of Service of the Certificate Authority. | |||
| MDCertificateAuthority url | letsencrypt | s | X |
| The URL(s) of the ACME Certificate Authority to use. | |||
| MDCertificateCheck name url | s | X | |
| Set name and URL pattern for a certificate monitoring site. | |||
| MDCertificateFile path-to-pem-file | s | X | |
| Specify a static certificate file for the MD. | |||
| MDCertificateKeyFile path-to-file | s | X | |
| Specify a static private key for for the static cerrtificate. | |||
| MDCertificateMonitor name url | crt.sh https://crt. + | s | X |
| The URL of a certificate log monitor. | |||
| MDCertificateProtocol protocol | ACME | s | X |
| The protocol to use with the Certificate Authority. | |||
| MDCertificateStatus on|off | on | s | X |
| Exposes public certificate information in JSON. | |||
| MDChallengeDns01 path-to-command | s | X | |
| Set the command for setup/teardown of dns-01 challenges | |||
| MDChallengeDns01Version 1|2 | 1 | s | X |
| Set the type of arguments to call MDChallengeDns01 with | |||
| MDCheckInterval duration | 12h | s | X |
| Determines how often certificates are checked | |||
| MDContactEmail address | s | X | |
| Email address used for account registration | |||
| MDDriveMode always|auto|manual | auto | s | X |
| former name of MDRenewMode. | |||
| MDExternalAccountBinding key-id hmac-64 | none | file | none | s | X |
| Set the external account binding keyid and hmac values to use at CA | |||
| MDHttpProxy url | s | X | |
| Define a proxy for outgoing connections. | |||
| MDMatchNames all|servernames | all | s | X |
| Determines how DNS names are matched to vhosts | |||
| MDMember hostname | s | X | |
| Additional hostname for the managed domain. | |||
| MDMembers auto|manual | auto | s | X |
| Control if the alias domain names are automatically added. | |||
| MDMessageCmd path-to-cmd optional-args | s | X | |
| Handle events for Manage Domains | |||
| MDMustStaple on|off | off | s | X |
| Control if new certificates carry the OCSP Must Staple flag. | |||
| MDNotifyCmd path [ args ] | s | X | |
| Run a program when a Managed Domain is ready. | |||
| MDomain dns-name [ other-dns-name... ] [auto|manual] | s | X | |
| Define list of domain names that belong to one group. | |||
| <MDomainSet dns-name [ other-dns-name... ]>...</MDomainSet> | s | X | |
| Container for directives applied to the same managed domains. | |||
| MDPortMap map1 [ map2 ] | http:80 https:443 | s | X |
| Map external to internal ports for domain ownership verification. | |||
| MDPrivateKeys type [ params... ] | RSA 2048 | s | X |
| Set type and size of the private keys generated. | |||
| MDProfile name | s | X | |
| Use a specific ACME profile from the CA | |||
| MDProfileMandatory on|off | off | s | X |
| Control if an MDProfile is mandatory. | |||
| MDRenewMode always|auto|manual | auto | s | X |
| Controls if certificates shall be renewed. | |||
| MDRenewWindow duration | 33% | s | X |
| Control when a certificate will be renewed. | |||
| MDRequireHttps off|temporary|permanent | off | s | X |
| Redirects http: traffic to https: for Managed Domains. | |||
| MDRetryDelay duration | 5s | s | X |
| Time length for first retry, doubled on every consecutive error. | |||
| MDRetryFailover number | 13 | s | X |
| The number of errors before a failover to another CA is triggered | |||
| MDServerStatus on|off | on | s | X |
| Control if Managed Domain information is added to server-status. | |||
| MDStapleOthers on|off | on | s | X |
| Enable stapling for certificates not managed by mod_md. | |||
| MDStapling on|off | off | s | X |
| Enable stapling for all or a particular MDomain. | |||
| MDStaplingKeepResponse duration | 7d | s | X |
| Controls when old responses should be removed. | |||
| MDStaplingRenewWindow duration | 33% | s | X |
| Control when the stapling responses will be renewed. | |||
| MDStoreDir path | md | s | X |
| Path on the local file system to store the Managed Domains data. | |||
| MDStoreLocks on|off|duration | off | s | X |
| Configure locking of store for updates | |||
| MDWarnWindow duration | 10% | s | X |
| Define the time window when you want to be warned about an expiring certificate. | |||
| MemcacheConnTTL num[units] | 15s | sv | E |
| Keepalive time for idle connections | |||
| MergeSlashes ON|OFF | ON | sv | C |
| Controls whether the server merges consecutive slashes in URLs. | |||
| MergeTrailers [on|off] | off | sv | C |
| Determines whether trailers are merged into headers | |||
| MetaDir directory | .web | svdh | E |
| Name of the directory to find CERN-style meta information files | |||
| MetaFiles on|off | off | svdh | E |
| Activates CERN meta-file processing | |||
| MetaSuffix suffix | .meta | svdh | E |
| File name suffix for the file containing CERN-style meta information | |||
| MimeMagicFile file-path | sv | E | |
| Enable MIME-type determination based on file contents using the specified magic file | |||
| MinSpareServers number | 5 | s | M |
| アイドルな子サーバプロセスの最小個数 | |||
| MinSpareThreads number | s | M | |
| リクエストに応答することのできる アイドルスレッド数の最小数 | |||
| MMapFile file-path [file-path] ... | s | X | |
| Map a list of files into memory at startup time | |||
| ModemStandard V.21|V.26bis|V.32|V.34|V.92 | d | X | |
| Modem standard to simulate | |||
| ModMimeUsePathInfo On|Off | Off | d | |
path_info コンポーネントをファイル名の一部として扱うように
mod_mime に通知する | |||
| MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers [Handlers|Filters] | NegotiatedOnly | svdh | |
| MultiViews でのマッチングの検索に含ませる ファイルのタイプを指定する | |||
| Mutex mechanism [default|mutex-name] ... [OmitPID] | default | s | C |
| Configures mutex mechanism and lock file directory for all or specified mutexes | |||
| NameVirtualHost addr[:port] | s | C | |
| 名前ベースのバーチャルホストのための IP アドレスを指定 | |||
| NoProxy host [host] ... | sv | E | |
| 直接接続する ホスト、ドメイン、ネットワーク | |||
| NWSSLTrustedCerts filename [filename] ... | s | B | |
| List of additional client certificates | |||
| NWSSLUpgradeable [IP-address:]portnumber | s | B | |
| Allows a connection to be upgraded to an SSL connection upon request | |||
| Options [+|-]option [[+|-]option] ... | All | svdh | C |
| ディレクトリに対して使用可能な機能を設定する | |||
| Order ordering | Deny,Allow | dh | E |
デフォルトのアクセス可能な状態と、Allow と
Deny が評価される順番を制御する | |||
| OutputSed sed-command | dh | X | |
| Sed command for filtering response content | |||
| PassEnv env-variable [env-variable] ... | svdh | B | |
| シェルからの環境変数を渡す | |||
| PidFile filename | logs/httpd.pid | s | M |
| デーモンのプロセス ID をサーバが記録するためのファイル | |||
| PrivilegesMode FAST|SECURE|SELECTIVE | FAST | svd | X |
| Trade off processing speed and efficiency vs security against malicious privileges-aware code. | |||
| Protocol protocol | sv | C | |
| Protocol for a listening socket | |||
| ProtocolEcho On|Off | Off | sv | X |
| エコーサーバの有効無効を設定します。 | |||
| Protocols protocol ... | http/1.1 | sv | C |
| Protocols available for a server/virtual host | |||
| ProtocolsHonorOrder On|Off | On | sv | C |
| Determines if order of Protocols determines precedence during negotiation | |||
| <Proxy wildcard-url> ...</Proxy> | sv | E | |
| プロキシされるリソースに適用されるコンテナ | |||
| Proxy100Continue Off|On | On | svd | E |
| Forward 100-continue expectation to the origin server | |||
| ProxyAddHeaders Off|On | On | svd | E |
| Add proxy information in X-Forwarded-* headers | |||
| ProxyBadHeader IsError|Ignore|StartBody | IsError | sv | E |
| 応答におかしなヘッダがある場合の扱い方を決める | |||
| ProxyBlock *|word|host|domain [word|host|domain] ... | sv | E | |
| プロキシ接続を禁止する語句、ホスト名、ドメインを指定する | |||
| ProxyDomain Domain | sv | E | |
| プロキシされたリクエストのデフォルトのドメイン名 | |||
| ProxyErrorOverride On|Off | Off | sv | E |
| プロキシされたコンテンツのエラーページを上書きする | |||
| ProxyExpressDBMFile pathname | sv | E | |
| Pathname to DBM file. | |||
| ProxyExpressDBMType type | default | sv | E |
| DBM type of file. | |||
| ProxyExpressEnable on|off | off | sv | E |
| Enable the module functionality. | |||
| ProxyFCGIBackendType FPM|GENERIC | FPM | svdh | E |
| Specify the type of backend FastCGI application | |||
| ProxyFCGISetEnvIf conditional-expression [!]environment-variable-name [value-expression] | svdh | E | |
| Allow variables sent to FastCGI servers to be fixed up | |||
| ProxyFtpDirCharset character_set | ISO-8859-1 | svd | E |
| Define the character set for proxied FTP listings | |||
| ProxyFtpEscapeWildcards on|off | on | svd | E |
| Whether wildcards in requested filenames are escaped when sent to the FTP server | |||
| ProxyFtpListOnWildcard on|off | on | svd | E |
| Whether wildcards in requested filenames trigger a file listing | |||
| ProxyHCExpr name {ap_expr expression} | sv | E | |
| Creates a named condition expression to use to determine health of the backend based on its response | |||
| ProxyHCTemplate name parameter=setting [...] | sv | E | |
| Creates a named template for setting various health check parameters | |||
| ProxyHCTPsize size | 16 | s | E |
| Sets the total server-wide size of the threadpool used for the health check workers | |||
| ProxyHTMLBufSize bytes | 8192 | svd | B |
| Sets the buffer size increment for buffering inline scripts and stylesheets. | |||
| ProxyHTMLCharsetOut Charset | * | svd | B | |
| Specify a charset for mod_proxy_html output. | |||
| ProxyHTMLDocType HTML|XHTML [Legacy] OR ProxyHTMLDocType fpi [SGML|XML] | svd | B | |
| Sets an HTML or XHTML document type declaration. | |||
| ProxyHTMLEnable On|Off | Off | svd | B |
| Turns the proxy_html filter on or off. | |||
| ProxyHTMLEvents attribute [attribute ...] | svd | B | |
| Specify attributes to treat as scripting events. | |||
| ProxyHTMLExtended On|Off | Off | svd | B |
| Determines whether to fix links in inline scripts, stylesheets, and scripting events. | |||
| ProxyHTMLFixups [lowercase] [dospath] [reset] | svd | B | |
| Fixes for simple HTML errors. | |||
| ProxyHTMLInterp On|Off | Off | svd | B |
Enables per-request interpolation of
ProxyHTMLURLMap rules. | |||
| ProxyHTMLLinks element attribute [attribute2 ...] | svd | B | |
| Specify HTML elements that have URL attributes to be rewritten. | |||
| ProxyHTMLMeta On|Off | Off | svd | B |
Turns on or off extra pre-parsing of metadata in HTML
<head> sections. | |||
| ProxyHTMLStripComments On|Off | Off | svd | B |
| Determines whether to strip HTML comments. | |||
| ProxyHTMLURLMap from-pattern to-pattern [flags] [cond] | svd | B | |
| Defines a rule to rewrite HTML links | |||
| ProxyIOBufferSize bytes | 8192 | sv | E |
| 内部データスループットバッファのサイズを決定する | |||
| <ProxyMatch regex> ...</ProxyMatch> | sv | E | |
| 正規表現でのマッチによるプロキシリソース用のディレクティブコンテナ | |||
| ProxyMaxForwards number | 10 | sv | E |
| リクエストがフォワードされるプロキシの最大数 | |||
| ProxyPass [path] !|url [key=value key=value ...]] | svd | E | |
| リモートサーバをローカルサーバの URL 空間にマップする | |||
| ProxyPassInherit On|Off | On | sv | E |
| Inherit ProxyPass directives defined from the main server | |||
| svd | E | ||
| Enable Environment Variable interpolation in Reverse Proxy configurations | |||
| svd | E | ||
| Maps remote servers into the local server URL-space using regular expressions | |||
| ProxyPassReverse [path] url | svd | E | |
| リバースプロキシされたサーバから送られた HTTP 応答ヘッダの URL を調整する | |||
| ProxyPassReverseCookieDomain internal-domain public-domain | svd | E | |
| リバースプロキシサーバからの Set-Cookie ヘッダの Domain 文字列を 調整する | |||
| ProxyPassReverseCookiePath internal-path public-path | svd | E | |
| Reverse プロキシサーバからの Set-Cookie ヘッダの Path 文字列を 調整する | |||
| ProxyPreserveHost On|Off | Off | sv | E |
| プロキシリクエストに、受け付けた Host HTTP ヘッダを使う | |||
| ProxyReceiveBufferSize bytes | 0 | sv | E |
| プロキシされる HTTP と FTP 接続のためのネットワークバッファサイズ | |||
| ProxyRemote match remote-server | sv | E | |
| 特定のリクエストを扱う時に使われるリモートプロキシを指定する | |||
| ProxyRemoteMatch regex remote-server | sv | E | |
| 正規表現でのマッチによるリクエストを扱うリモートプロキシの指定 | |||
| ProxyRequests On|Off | Off | sv | E |
| フォワード (標準の) プロキシリクエストを有効にする | |||
| ProxySCGIInternalRedirect On|Off|Headername | On | svd | E |
| Enable or disable internal redirect responses from the backend | |||
| ProxySCGISendfile On|Off|Headername | Off | svd | E |
| Enable evaluation of X-Sendfile pseudo response header | |||
| d | E | ||
| Set various Proxy balancer or member parameters | |||
| ProxySourceAddress address | sv | E | |
| Set local IP address for outgoing proxy connections | |||
| sv | E | ||
| Show Proxy LoadBalancer status in mod_status | |||
| ProxyTimeout seconds | 300 | sv | E |
| プロキシされたリクエストのネットワークタイムアウト | |||
| ProxyVia On|Off|Full|Block | Off | sv | E |
プロキシされたリクエストの Via HTTP 応答ヘッダ
により提供される情報 | |||
| ProxyWebsocketFallbackToProxyHttp On|Off | On | sv | E |
Instructs this module to let mod_proxy_http handle the request | |||
| QualifyRedirectURL On|Off | Off | svd | C |
| Controls whether the REDIRECT_URL environment variable is fully qualified | |||
| ReadBufferSize bytes | 8192 | svd | C |
| Size of the buffers used to read data | |||
| ReadmeName filename | svdh | B | |
| インデックス一覧の最後に挿入されるファイルの名前 | |||
| ReceiveBufferSize bytes | 0 | s | M |
| TCP 受信バッファサイズ | |||
| Redirect [status] URL-path URL | svdh | B | |
| クライアントが違う URL を取得するように外部へのリダイレクトを 送る | |||
| RedirectMatch [status] regex URL | svdh | B | |
| 現在の URL への正規表現のマッチにより 外部へのリダイレクトを送る | |||
| RedirectPermanent URL-path URL | svdh | B | |
| クライアントが違う URL を取得するように外部への永久的な リダイレクトを送る | |||
| RedirectRelative On|Off | Off | svd | B |
| Allows relative redirect targets. | |||
| RedirectTemp URL-path URL | svdh | B | |
| クライアントが違う URL を取得するように外部への一時的な リダイレクトを送る | |||
| RedisConnPoolTTL num[units] | 15s | sv | E |
| TTL used for the connection pool with the Redis server(s) | |||
| RedisTimeout num[units] | 5s | sv | E |
| R/W timeout used for the connection with the Redis server(s) | |||
| ReflectorHeader inputheader [outputheader] | svdh | B | |
| Reflect an input header to the output headers | |||
| RegexDefaultOptions [none] [+|-]option [[+|-]option] ... | DOTALL DOLLAR_ENDON + | s | C |
| Allow to configure global/default options for regexes | |||
| RegisterHttpMethod method [method [...]] | s | C | |
| Register non-standard HTTP methods | |||
| RemoteIPHeader header-field | sv | B | |
| Declare the header field which should be parsed for useragent IP addresses | |||
| RemoteIPInternalProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPInternalProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPProxiesHeader HeaderFieldName | sv | B | |
| Declare the header field which will record all intermediate IP addresses | |||
| RemoteIPProxyProtocol On|Off | sv | B | |
| Enable or disable PROXY protocol handling | |||
| RemoteIPProxyProtocolExceptions host|range [host|range] [host|range] | sv | B | |
| Disable processing of PROXY header for certain hosts or networks | |||
| RemoteIPTrustedProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPTrustedProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoveCharset extension [extension] ... | vdh | ||
| ファイルの拡張子に関連付けられたすべての文字セット を解除する | |||
| RemoveEncoding extension [extension] ... | vdh | ||
| ファイルの拡張子に関連付けられたすべてのコンテントエンコーディング を解除する | |||
| RemoveHandler extension [extension] ... | vdh | ||
| ファイルの拡張子に関連付けられたすべてのハンドラを 解除する | |||
| RemoveInputFilter extension [extension] ... | vdh | ||
| ファイル拡張子に関連付けられた入力フィルタを解除する | |||
| RemoveLanguage extension [extension] ... | vdh | ||
| ファイル拡張子に関連付けられた言語を解除する | |||
| RemoveOutputFilter extension [extension] ... | vdh | ||
| ファイル拡張子に関連付けられた出力フィルタを解除する | |||
| RemoveType extension [extension] ... | vdh | ||
| ファイルの拡張子と関連付けられたコンテントタイプを 解除する | |||
| RequestHeader set|append|add|unset header [value] [early|env=[!]variable] | svdh | E | |
| HTTP リクエストヘッダの設定 | |||
| RequestReadTimeout [handshake=timeout[-maxtimeout][,MinRate=rate] [header=timeout[-maxtimeout][,MinRate=rate] [body=timeout[-maxtimeout][,MinRate=rate] | handshake=0 header= + | sv | E |
| Set timeout values for completing the TLS handshake, receiving the request headers and/or body from client. | |||
| Require [not] entity-name [entity-name] ... | dh | B | |
| Tests whether an authenticated user is authorized by an authorization provider. | |||
| <RequireAll> ... </RequireAll> | dh | B | |
| Enclose a group of authorization directives of which none must fail and at least one must succeed for the enclosing directive to succeed. | |||
| <RequireAny> ... </RequireAny> | dh | B | |
| Enclose a group of authorization directives of which one must succeed for the enclosing directive to succeed. | |||
| <RequireNone> ... </RequireNone> | dh | B | |
| Enclose a group of authorization directives of which none must succeed for the enclosing directive to not fail. | |||
| RewriteBase URL-path | dh | E | |
| Sets the base URL for per-directory rewrites | |||
| RewriteCond TestString CondPattern [flags] | svdh | E | |
| Defines a condition under which rewriting will take place | |||
| RewriteEngine on|off | off | svdh | E |
| Enables or disables runtime rewriting engine | |||
| RewriteMap MapName MapType:MapSource [MapTypeOptions] | sv | E | |
| Defines a mapping function for key-lookup | |||
| RewriteOptions Options | svdh | E | |
| Sets some special options for the rewrite engine | |||
| RewriteRule Pattern Substitution [flags] | svdh | E | |
| Defines rules for the rewriting engine | |||
| RLimitCPU seconds|max [seconds|max] | svdh | C | |
| Apache の子プロセスから起動されたプロセスの CPU 消費量を 制限する | |||
| RLimitMEM bytes|max [bytes|max] | svdh | C | |
| Apache の子プロセスから起動されたプロセスのメモリ消費量を 制限する | |||
| RLimitNPROC number|max [number|max] | svdh | C | |
| Apache の子プロセスから起動されたプロセスが起動するプロセスの 数を制限する | |||
| Satisfy Any|All | All | dh | E |
| ホストレベルのアクセス制御とユーザ認証との相互作用を指定 | |||
| ScoreBoardFile file-path | logs/apache_status | s | M |
| 子プロセスと連携するためのデータを保存する ファイルの位置 | |||
| Script method cgi-script | svd | B | |
| 特定のリクエストメソッドに対して CGI スクリプトを 実行するように設定 | |||
| ScriptAlias URL-path file-path|directory-path | sv | B | |
| URL をファイルシステムの位置へマップし、マップ先を CGI スクリプトに指定 | |||
| ScriptAliasMatch regex file-path|directory-path | sv | B | |
| URL を正規表現を使ってファイルシステムの位置へマップし、マップ先を CGI スクリプトに指定 | |||
| ScriptInterpreterSource Registry|Registry-Strict|Script | Script | svdh | C |
| CGI スクリプトのインタープリタの位置を調べるための手法 | |||
| ScriptLog file-path | sv | B | |
| CGI スクリプトのエラーログファイルの場所 | |||
| ScriptLogBuffer bytes | 1024 | sv | B |
| スクリプトログに記録される PUT や POST リクエストの内容の上限 | |||
| ScriptLogLength bytes | 10385760 | sv | B |
| CGI スクリプトのログファイルの大きさの上限 | |||
| ScriptSock file-path | logs/cgisock | s | B |
| CGI デーモンとの通信に使われるソケットのファイル名の接頭辞 | |||
| SecureListen [IP-address:]portnumber Certificate-Name [MUTUAL] | s | B | |
| Enables SSL encryption for the specified port | |||
| SeeRequestTail On|Off | Off | s | C |
| Determine if mod_status displays the first 63 characters of a request or the last 63, assuming the request itself is greater than 63 chars. | |||
| SendBufferSize bytes | 0 | s | M |
| TCP バッファサイズ | |||
| ServerAdmin email-address|URL | sv | C | |
| サーバがクライアントに送るエラーメッセージに含める電子メールの アドレス | |||
| ServerAlias hostname [hostname] ... | v | C | |
| リクエストを名前ベースのバーチャルホストにマッチさせているときに 使用されるホストの別名 | |||
| ServerLimit number | s | M | |
| 設定可能なサーバプロセス数の上限 | |||
| ServerName [scheme://]fully-qualified-domain-name[:port] | sv | C | |
| サーバが自分自身を示すときに使うホスト名とポート | |||
| ServerPath URL-path | v | C | |
| 非互換のブラウザが名前ベースのバーチャルホストにアクセスしたときの ための互換用 URL パス名 | |||
| ServerRoot directory-path | /usr/local/apache | s | C |
| インストールされたサーバのベースディレクトリ | |||
| ServerSignature On|Off|EMail | Off | svdh | C |
| サーバが生成するドキュメントのフッタを設定 | |||
| ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full | Full | s | C |
Server HTTP 応答ヘッダを設定する | |||
| Session On|Off | Off | svdh | E |
| Enables a session for the current directory or location | |||
| SessionCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session | |||
| SessionCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session | |||
| SessionCookieRemove On|Off | Off | svdh | E |
| Control for whether session cookies should be removed from incoming HTTP headers | |||
| SessionCryptoCipher name | aes256 | svdh | X |
| The crypto cipher to be used to encrypt the session | |||
| SessionCryptoDriver name [param[=value]] | s | X | |
| The crypto driver to be used to encrypt the session | |||
| SessionCryptoPassphrase secret [ secret ... ] | svdh | X | |
| The key used to encrypt the session | |||
| SessionCryptoPassphraseFile filename | svd | X | |
| File containing keys used to encrypt the session | |||
| SessionDBDCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session ID | |||
| SessionDBDCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session ID | |||
| SessionDBDCookieRemove On|Off | On | svdh | E |
| Control for whether session ID cookies should be removed from incoming HTTP headers | |||
| SessionDBDDeleteLabel label | deletesession | svdh | E |
| The SQL query to use to remove sessions from the database | |||
| SessionDBDInsertLabel label | insertsession | svdh | E |
| The SQL query to use to insert sessions into the database | |||
| SessionDBDPerUser On|Off | Off | svdh | E |
| Enable a per user session | |||
| SessionDBDSelectLabel label | selectsession | svdh | E |
| The SQL query to use to select sessions from the database | |||
| SessionDBDUpdateLabel label | updatesession | svdh | E |
| The SQL query to use to update existing sessions in the database | |||
| SessionEnv On|Off | Off | svdh | E |
| Control whether the contents of the session are written to the HTTP_SESSION environment variable | |||
| SessionExclude path | svdh | E | |
| Define URL prefixes for which a session is ignored | |||
| SessionExpiryUpdateInterval interval | 0 (always update) | svdh | E |
| Define the number of seconds a session's expiry may change without the session being updated | |||
| SessionHeader header | svdh | E | |
| Import session updates from a given HTTP response header | |||
| SessionInclude path | svdh | E | |
| Define URL prefixes for which a session is valid | |||
| SessionMaxAge maxage | 0 | svdh | E |
| Define a maximum age in seconds for a session | |||
| SetEnv env-variable value | svdh | B | |
| 環境変数を設定する | |||
| SetEnvIf attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| リクエストの属性に基づいて環境変数を設定する | |||
| svdh | B | ||
| Sets environment variables based on an ap_expr expression | |||
| SetEnvIfNoCase attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| リクエストの属性に基づいて大文字小文字を区別せずに環境変数を設定する | |||
| SetHandler handler-name|None | svdh | C | |
| マッチするファイルがハンドラで処理されるようにする | |||
| SetInputFilter filter[;filter...] | svdh | C | |
| クライアントのリクエストや POST の入力を処理するフィルタを設定する | |||
| SetOutputFilter filter[;filter...] | svdh | C | |
| サーバの応答を処理するフィルタを設定する | |||
| SSIEndTag tag | "-->" | sv | B |
| include 要素を終了させる文字列 | |||
| SSIErrorMsg message | "[an error occurred + | svdh | B |
| SSI のエラーがあったときに表示されるエラーメッセージ | |||
| SSIETag on|off | off | dh | B |
| Controls whether ETags are generated by the server. | |||
| SSILastModified on|off | off | dh | B |
Controls whether Last-Modified headers are generated by the
server. | |||
| SSILegacyExprParser on|off | off | dh | B |
| Enable compatibility mode for conditional expressions. | |||
| SSIStartTag tag | "<!--#" | sv | B |
| include 要素を開始する文字列 | |||
| SSITimeFormat formatstring | "%A, %d-%b-%Y %H:%M + | svdh | B |
| 日付けを現す文字列の書式を設定する | |||
| SSIUndefinedEcho string | "(none)" | svdh | B |
| 未定義の変数が echo されたときに表示される文字列 | |||
| SSLCACertificateFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for Client Auth | |||
| SSLCACertificatePath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for Client Auth | |||
| SSLCADNRequestFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCADNRequestPath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCARevocationCheck chain|leaf|none [flags ...] | none | sv | E |
| Enable CRL-based revocation checking | |||
| SSLCARevocationFile file-path | sv | E | |
| File of concatenated PEM-encoded CA CRLs for Client Auth | |||
| SSLCARevocationPath directory-path | sv | E | |
| Directory of PEM-encoded CA CRLs for Client Auth | |||
| SSLCertificateChainFile file-path | sv | E | |
| File of PEM-encoded Server CA Certificates | |||
| SSLCertificateFile file-path|certid | sv | E | |
| Server PEM-encoded X.509 certificate data file or token identifier | |||
| SSLCertificateKeyFile file-path|keyid | sv | E | |
| Server PEM-encoded private key file | |||
| SSLCipherSuite [protocol] cipher-spec | DEFAULT (depends on + | svdh | E |
| Cipher Suite available for negotiation in SSL handshake | |||
| SSLCompression on|off | off | sv | E |
| Enable compression on the SSL level | |||
| SSLCryptoDevice engine | builtin | s | E |
| Enable use of a cryptographic hardware accelerator | |||
| SSLEngine on|off|optional | off | sv | E |
| SSL Engine Operation Switch | |||
| SSLFIPS on|off | off | s | E |
| SSL FIPS mode Switch | |||
| SSLHonorCipherOrder on|off | off | sv | E |
| Option to prefer the server's cipher preference order | |||
| SSLInsecureRenegotiation on|off | off | sv | E |
| Option to enable support for insecure renegotiation | |||
| SSLOCSPDefaultResponder uri | sv | E | |
| Set the default responder URI for OCSP validation | |||
| SSLOCSPEnable on|leaf|off | off | sv | E |
| Enable OCSP validation of the client certificate chain | |||
| SSLOCSPNoverify on|off | off | sv | E |
| skip the OCSP responder certificates verification | |||
| SSLOCSPOverrideResponder on|off | off | sv | E |
| Force use of the default responder URI for OCSP validation | |||
| SSLOCSPProxyURL url | sv | E | |
| Proxy URL to use for OCSP requests | |||
| SSLOCSPResponderCertificateFile file | sv | E | |
| Set of trusted PEM encoded OCSP responder certificates | |||
| SSLOCSPResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP queries | |||
| SSLOCSPResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP responses | |||
| SSLOCSPResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP response validation | |||
| SSLOCSPUseRequestNonce on|off | on | sv | E |
| Use a nonce within OCSP queries | |||
| SSLOpenSSLConfCmd command-name command-value | sv | E | |
| Configure OpenSSL parameters through its SSL_CONF API | |||
| SSLOptions [+|-]option ... | svdh | E | |
| Configure various SSL engine run-time options | |||
| SSLPassPhraseDialog type | builtin | s | E |
| Type of pass phrase dialog for encrypted private keys | |||
| SSLProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | sv | E |
| Configure usable SSL/TLS protocol versions | |||
| SSLProxyCACertificateFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCACertificatePath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCARevocationCheck chain|leaf|none | none | sv | E |
| Enable CRL-based revocation checking for Remote Server Auth | |||
| SSLProxyCARevocationFile file-path | sv | E | |
| File of concatenated PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCARevocationPath directory-path | sv | E | |
| Directory of PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCheckPeerCN on|off | on | sv | E |
| Whether to check the remote server certificate's CN field | |||
| SSLProxyCheckPeerExpire on|off | on | sv | E |
| Whether to check if remote server certificate is expired | |||
| SSLProxyCheckPeerName on|off | on | sv | E |
| Configure host name checking for remote server certificates | |||
| SSLProxyCipherSuite [protocol] cipher-spec | ALL:!ADH:RC4+RSA:+H + | sv | E |
| Cipher Suite available for negotiation in SSL proxy handshake | |||
| SSLProxyEngine on|off | off | sv | E |
| SSL Proxy Engine Operation Switch | |||
| SSLProxyMachineCertificateChainFile filename | sv | E | |
| File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate | |||
| SSLProxyMachineCertificateFile filename | sv | E | |
| File of concatenated PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyMachineCertificatePath directory | sv | E | |
| Directory of PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | sv | E |
| Configure usable SSL protocol flavors for proxy usage | |||
| SSLProxyVerify level | none | sv | E |
| Type of remote server Certificate verification | |||
| SSLProxyVerifyDepth number | 1 | sv | E |
| Maximum depth of CA Certificates in Remote Server Certificate verification | |||
| SSLRandomSeed context source [bytes] | s | E | |
| Pseudo Random Number Generator (PRNG) seeding source | |||
| SSLRenegBufferSize bytes | 131072 | dh | E |
| Set the size for the SSL renegotiation buffer | |||
| SSLRequire expression | dh | E | |
| Allow access only when an arbitrarily complex boolean expression is true | |||
| SSLRequireSSL | dh | E | |
| Deny access when SSL is not used for the HTTP request | |||
| SSLSessionCache type | none | s | E |
| Type of the global/inter-process SSL Session Cache | |||
| SSLSessionCacheTimeout seconds | 300 | sv | E |
| Number of seconds before an SSL session expires in the Session Cache | |||
| SSLSessionTicketKeyFile file-path | sv | E | |
| Persistent encryption/decryption key for TLS session tickets | |||
| SSLSessionTickets on|off | on | sv | E |
| Enable or disable use of TLS session tickets | |||
| SSLSRPUnknownUserSeed secret-string | sv | E | |
| SRP unknown user seed | |||
| SSLSRPVerifierFile file-path | sv | E | |
| Path to SRP verifier file | |||
| SSLStaplingCache type | s | E | |
| Configures the OCSP stapling cache | |||
| SSLStaplingErrorCacheTimeout seconds | 600 | sv | E |
| Number of seconds before expiring invalid responses in the OCSP stapling cache | |||
| SSLStaplingFakeTryLater on|off | on | sv | E |
| Synthesize "tryLater" responses for failed OCSP stapling queries | |||
| SSLStaplingForceURL uri | sv | E | |
| Override the OCSP responder URI specified in the certificate's AIA extension | |||
| SSLStaplingResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP stapling queries | |||
| SSLStaplingResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP stapling responses | |||
| SSLStaplingResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP stapling response validation | |||
| SSLStaplingReturnResponderErrors on|off | on | sv | E |
| Pass stapling related OCSP errors on to client | |||
| SSLStaplingStandardCacheTimeout seconds | 3600 | sv | E |
| Number of seconds before expiring responses in the OCSP stapling cache | |||
| SSLStrictSNIVHostCheck on|off | off | sv | E |
| Whether to allow non-SNI clients to access a name-based virtual host. | |||
| SSLUserName varname | sdh | E | |
| Variable name to determine user name | |||
| SSLUseStapling on|off | off | sv | E |
| Enable stapling of OCSP responses in the TLS handshake | |||
| SSLVerifyClient level | none | svdh | E |
| Type of Client Certificate verification | |||
| SSLVerifyDepth number | 1 | svdh | E |
| Maximum depth of CA Certificates in Client Certificate verification | |||
| StartServers number | s | M | |
| 起動時に生成される子サーバプロセスの数 | |||
| StartThreads number | s | M | |
| 起動時に生成されるスレッドの数 | |||
| StrictHostCheck ON|OFF | OFF | sv | C |
| Controls whether the server requires the requested hostname be listed enumerated in the virtual host handling the request | |||
| Substitute s/pattern/substitution/[infq] | dh | E | |
| Pattern to filter the response content | |||
| SubstituteInheritBefore on|off | off | dh | E |
| Change the merge order of inherited patterns | |||
| SubstituteMaxLineLength bytes(b|B|k|K|m|M|g|G) | 1m | dh | E |
| Set the maximum line size | |||
| Suexec On|Off | s | B | |
| Enable or disable the suEXEC feature | |||
| SuexecUserGroup User Group | sv | E | |
| CGI プログラムのユーザパーミッション、グループパーミッション | |||
| ThreadLimit number | s | M | |
| 設定可能な子プロセス毎のスレッド数の上限を 設定します | |||
| ThreadsPerChild number | s | M | |
| 子プロセスそれぞれに生成されるスレッド数 | |||
| ThreadStackSize size | s | M | |
| クライアントのコネクションを受け持つスレッドが使用する スタックのバイト数 | |||
| TimeOut seconds | 60 | sv | C |
| 各イベントについて、リクエストを失敗させるまでにサーバが 待つ時間を設定 | |||
| TraceEnable [on|off|extended] | on | s | C |
TRACE メソッドのリクエストに対する応答方法を決める
| |||
| TransferLog file|pipe | sv | B | |
| ログファイルの位置を指定 | |||
| TypesConfig file-path | conf/mime.types | s | |
mime.types ファイルの位置 | |||
| UNCList hostname [hostname...] | s | C | |
| Controls what UNC host names can be accessed by the server | |||
| UnDefine parameter-name | s | C | |
| Undefine the existence of a variable | |||
| UndefMacro name | svd | B | |
| Undefine a macro | |||
| UnsetEnv env-variable [env-variable] ... | svdh | B | |
| 環境から変数を取り除く | |||
| Use name [value1 ... valueN] | svd | B | |
| Use a macro | |||
| UseCanonicalName On|Off|Dns | Off | svd | C |
| サーバが自分自身の名前とポートを決定する方法を設定する | |||
| UseCanonicalPhysicalPort On|Off | Off | svd | C |
| 自分自身の名前とポート番号を解決する方法を設定する | |||
| User unix-userid | #-1 | s | B |
| The userid under which the server will answer requests | |||
| UserDir directory-filename [directory-filename] ... | sv | B | |
| ユーザ専用ディレクトリの位置 | |||
| VHostCGIMode On|Off|Secure | On | v | X |
| Determines whether the virtualhost can run subprocesses, and the privileges available to subprocesses. | |||
| VHostCGIPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to subprocesses created by a virtual host. | |||
| VHostGroup unix-groupid | v | X | |
| Sets the Group ID under which a virtual host runs. | |||
| VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to a virtual host. | |||
| VHostSecure On|Off | On | v | X |
| Determines whether the server runs with enhanced security for the virtualhost. | |||
| VHostUser unix-userid | v | X | |
| Sets the User ID under which a virtual host runs. | |||
| VirtualDocumentRoot interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| VirtualDocumentRootIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| <VirtualHost addr[:port] [addr[:port]] ...> ... </VirtualHost> | s | C | |
| 特定のホスト名や IP アドレスのみに適用されるディレクティブを 囲む | |||
| VirtualScriptAlias interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| VirtualScriptAliasIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| WatchdogInterval time-interval[s] | 1 | s | B |
| Watchdog interval in seconds | |||
| XBitHack on|off|full | off | svdh | B |
| 実行ビットが設定されたファイルの SSI ディレクティブを 解析する | |||
| xml2EncAlias charset alias [alias ...] | s | B | |
| Recognise Aliases for encoding values | |||
| xml2EncDefault name | svdh | B | |
| Sets a default encoding to assume when absolutely no information can be automatically detected | |||
| xml2StartParse element [element ...] | svdh | B | |
| Advise the parser to skip leading junk. | |||
Apache HTTP Server Version 2.4
| : | ܺ α ó Ŭ̾Ʈ |
|---|---|
| : | Extension |
| : | ext_filter_module |
| ҽ: | mod_ext_filter.c |
mod_ext_filter ϸ ϰ ͼ
ִ.
ǥԷ¿ а ǥ¿ α(, н
ɾ) ġ ͷ ִ. ̷ ʹ
ġ API ġ μ ȿ Ǵ
Ϳ ſ , ִ:
ϱ ,
mod_ext_filter Ͽ
ִ.
# mod_ext_filter þ
# ܺ α /usr/bin/enscript Ͽ
# ϰ text/c HTML
# type text/html ϴ Ѵ
ExtFilterDefine c-to-html mode=output \
intype=text/c outtype=text/html \
cmd="/usr/bin/enscript --color -W html -Ec -o - -"
<Directory "/export/home/trawick/apacheinst/htdocs/c">
# ¿ ο ϴ core þ
SetOutputFilter c-to-html
# .c type text/c mod_mime
# þ
AddType text/c .c
# û
# ˷ִ α ϴ mod_ext_filter
# þ
ExtFilterOptions DebugLevel=1
</Directory>
Note: Ʒ gzip ̴.
Ϸ mod_deflate
ϱ ٶ.
# ܺ ϴ mod_ext_filter þ
ExtFilterDefine gzip mode=output cmd=/bin/gzip
<Location /gzipped>
# Ҷ gzip ϴ core þ
SetOutputFilter gzip
# "Content-Encoding: gzip" ߰ϴ
# mod_header þ
Header set Content-Encoding gzip
</Location>
# cat ϴ ϴ
# mod_ext_filter þ; cat ƹ͵
# ʴ´; óθ Ͽ ڿ ҸѴ
ExtFilterDefine slowdown mode=output cmd=/bin/cat \
preservescontentlength
<Location />
# Ҷ slowdown ϴ core þ
#
SetOutputFilter slowdown;slowdown;slowdown
</Location>
# 信 üϴ ϴ
# mod_ext_filter þ
#
ExtFilterDefine fixtext mode=output intype=text/html \
cmd="/bin/sed s/verdana/arial/g"
<Location />
# Ҷ fixtext ϴ core þ
SetOutputFilter fixtext
</Location>
# ִ Ư Ŭ̾Ʈ(IP 192.168.1.31)
# mod_deflate а ڷḦ Ѵ.
# ʹ mod_deflate ڷḦ Ѵ.
ExtFilterDefine tracebefore \
cmd="/bin/tracefilter.pl /tmp/tracebefore" \
EnableEnv=trace_this_client
# ʹ mod_deflate ڷḦ Ѵ.
# ftype Ķ ʴ , ⺻
# AP_FTYPE_RESOURCE mod_deflate **
# д. AP_FTYPE_CONTENT_SET ڰ
# ϸ mod_deflate Ŀ Ѵ.
ExtFilterDefine traceafter \
cmd="/bin/tracefilter.pl /tmp/traceafter" \
EnableEnv=trace_this_client ftype=21
<Directory /usr/local/docs>
SetEnvIf Remote_Addr 192.168.1.31 trace_this_client
SetOutputFilter tracebefore;deflate;traceafter
</Directory>
#!/usr/local/bin/perl -w
use strict;
open(SAVE, ">$ARGV[0]")
or die "can't open $ARGV[0]: $?";
while (<STDIN>) {
print SAVE $_;
print $_;
}
close(SAVE);
| : | ܺ Ѵ |
|---|---|
| : | ExtFilterDefine filtername parameters |
| : | ּ |
| : | Extension |
| : | mod_ext_filter |
ExtFilterDefine þ ܺ
α, ƱԸƮ Ѵ.
filtername ̸ Ѵ. ̸ SetOutputFilter þ Ѵ. ͵鰣 ̸ ġ ȵȴ. ͵ API ʴ´. ڴ ̸ ġ Ѵ.
ܺ ɾ ٸ ϴ ƱԸƮ
͵ ϴ. , cmd= Ķʹ
ݵ ʿϴ. ִ Ķʹ :
cmd=cmdlinecmd= Ű ܺ ɾ Ѵ.
α ڿ ƱԸƮ ִٸ ֵǥ
Ѵ ( ,
cmd="/bin/mypgm arg1
arg2"). ġʰ α
ϱ Ϲ ǥ ʿ. α
ƱԸƮ Ѵ. α ƱԸƮ
ִٸ տ 齽 ؾ Ѵ. 齽
ƱԸƮ Ϻζ 齽 ι ؾ Ѵ. α
Ҷ ǥ CGI ȯ溯 ߰ DOCUMENT_URI,
DOCUMENT_PATH_INFO, QUERY_STRING_UNESCAPED Ѵ.mode=modemode=output
Ѵ. û óϴ ʹ mode=input
Ѵ. mode=input ġ 2.1 ߰Ǿ.intype=imtintype= ϸ
ٸ type ͷ ó ʴ´.outtype=imtPreservesContentLengthPreservesContentLength Ű Ͱ
content length ϵ Ѵ. κ Ͱ content
length ϹǷ Ű ⺻ ƴϴ. Ͱ
̸ Ҷ Ű带 ؾ Ѵ.ftype=filtertypedisableenv=envenableenv=env| : | mod_ext_filter ɼ Ѵ |
|---|---|
| : | ExtFilterOptions option [option] ... |
| ⺻: | ExtFilterOptions DebugLevel=0 NoLogStderr |
| : | directory |
| : | Extension |
| : | mod_ext_filter |
ExtFilterOptions þ
mod_ext_filter Ư óɼ Ѵ.
Option ϳ.
DebugLevel=nDebugLevel Ű
mod_ext_filter ϴ
Ѵ. ⺻ ʴ´.
̴ DebugLevel=0 . ڸ
Ҽ, ϵǰ
. ڰ ǹ̴ mod_ext_filter.c
պκп ִ DBGLVL_ ǿ ִ.
: α Ϸ core þ LogLevel Ͽ
ġ α ؾ Ѵ.
LogStderr | NoLogStderrLogStderr Ű ܺ α
ǥؿ ϴ ġ α Ѵ.
NoLogStderr ʴ´.
ExtFilterOptions LogStderr DebugLevel=0
ϸ Ͱ ǥؿ ϴ
ġ α ϰ, mod_ext_filter
ü ʴ´.
Apache HTTP Server Version 2.4
| : | ϵ ij |
|---|---|
| : | Experimental |
| : | file_cache_module |
| ҽ: | mod_file_cache.c |
mod_file_cache
Ͽ Ʈ
IJ б ٶ.
ʰ ûǴ ij
Ͽ ϸ ִ. mod_file_cache
ûǴ ΰ ij
Ѵ. þ Ͽ mod_file_cache
(open) mmap() ƴϸ
ڵ Ѵ.
ϱ ʿ ۾ Ϻθ (Ư
۾) û Ź ϴ Ҷ
ѹ Ͽ ϰ Ѵ.
: CGI α̳ Ư ڵ鷯 ϴ ӵ . ġ core ڵ鷯 ϴ ϹϿ ȴ.
ġ 1.3 ִ mod_mmap_static
Ȯ .
mod_file_cache ּ MMapFile CacheFile þ Ͽ
ϵ ij Ѵ.
÷ þ ϴ ƴϴ.
, ġ MMapStatic þ
, AIX ٸ ÷ θ Ѵ.
ʴ þ α
. ʴ þ ص
ij ʴ´. þ ϴ
÷ Ѵٸ غ.
mod_file_cache MMapFile þ
ϵ mmap() ýȣ
Ͽ Ѵ. ֽ н ü
ýȣ , ü ִ. ,
mmap() ִ ũ ý
Ƿ ̸ غ .
Ҷ Ҷ mmap()Ѵ.
Ͻýۿ ش ϳ Ǹ
ؾ Ѵ (ߴܰ
). ٽ ؼ Ǿµ
̻ϰ û
. (unlink) ڸ ο
ؾ Ѵ. rdist
mv ټ ̷ Ѵ.
Ź ߰ ʿ stat() ˻簡 ʿϰ
Ҷ ǵ ϱ
ȭ Ѵ.
mod_file_cache CacheFile þ
þ ( ϵ)
ڵ(handle) Ȥ (file descriptor)
ij Ѵ. ûϸ ij ڵ
ãƼ API sendfile() (
TransmitFile()) ѱ.
Ҷ Ҷ ڵ ijѴ.
Ͻýۿ ij ϳ Ǹ
ؾ Ѵ (ߴܰ ).
ٽ ؼ Ǿµ
̻ϰ û .
(unlink) ڸ ο
ؾ Ѵ. rdist mv
ټ ̷ Ѵ.
丮 ij ϴ þ
. غ... Include þ Ͽ
ɾ Ѵ:
find /www/htdocs -type f -print \
| sed -e 's/.*/mmapfile &/' > /www/conf/mmap.conf
| : | ۽ ڵ ijѴ |
|---|---|
| : | CacheFile file-path [file-path] ... |
| : | ּ |
| : | Experimental |
| : | mod_file_cache |
CacheFile þ Ҷ
(open) ϵ ڵ ij Ѵ.
ڵ ij ڵ ݴ´(close).
Ͻýۿ Ǹ ٽ ijϱ
ؾ Ѵ.
file-path ƱԸƮ ض. ƱԸƮ
ġ URL-ϸ ȯ ڵ鷯 Ͻý ο
Ȯ ġؾ Ѵ. ѹ ʿ stat()
ýȣ ʿϱ inode ɺũ
θ . mod_alias
mod_rewrite ۼ ϸ ٷ
ֱ ϴ.
CacheFile /usr/local/apache/htdocs/index.html
| : | ۽ Ѵ |
|---|---|
| : | MMapFile file-path [file-path] ... |
| : | ּ |
| : | Experimental |
| : | mod_file_cache |
MMapFile þ Ҷ
( ƱԸƮ )
Ѵ(map). ڵ Ǭ(unmap).
Ͻýۿ Ǹ ϵ ٽ
mmap()ϱ ּ HUP̳
USR1 ñ׳ Ѵ.
file-path ƱԸƮ ض. ƱԸƮ
ġ URL-ϸ ȯ ڵ鷯 Ͻý ο
Ȯ ġؾ Ѵ. ѹ ʿ stat()
ýȣ ʿϱ inode ɺũ
θ . mod_alias
mod_rewrite ۼ ϸ ٷ
ֱ ϴ.
MMapFile /usr/local/apache/htdocs/index.html
Apache HTTP サーバ バージョン 2.4
| 説明: | RFC 1413 ident lookups |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | ident_module |
| ソースファイル: | mod_ident.c |
| 互換性: | Apache 2.1 で使用可能 |
このモジュールはリモートホストの RFC 1413 互換デーモン にコネクションの所有者を訊きます。
| 説明: | リモートユーザの RFC 1413 によるアイデンティティのロギングを 有効にする |
|---|---|
| 構文: | IdentityCheck On|Off |
| デフォルト: | IdentityCheck Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_ident |
| 互換性: | Apache 2.1 で core から移動 |
このディレクティブは、クライアントマシン上で
identd やそれに類似したデーモンが動作しているときに、
それぞれの接続に対して RFC 1413 に準処したリモートユーザの
名前のロギングを行なうようにします。
この情報は、%...l フォーマット文字列を使ってアクセスログに収集されます。
すべてのリクエストに対してルックアップが行なわれますので、
深刻な遅延の問題を起こすかもしれないことに注意してください。
(訳注: 例えばクライアント側に) ファイアウォールやプロキシサーバがあると、
ルックアップが失敗し、各リクエストに IdentityCheckTimeoutで定義されている遅延が加わることに
なる可能性があります。
従って、一般的にはインターネットからアクセス可能なパブリックなサーバで
有益なものではありません。
| 説明: | Ident リクエストがタイムアウトするまでの期間を決める |
|---|---|
| 構文: | IdentityCheckTimeout seconds |
| デフォルト: | IdentityCheckTimeout 30 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_ident |
このディレクティブは ident リクエストのタイムアウト時間を決めます。 デフォルトの値である 30 秒は、主にネットワーク遅延の考慮のために RFC 1413 により 推奨されています。しかし、おそらくローカルネットワークの速度に 合わせてタイムアウト値を調節するのがよいでしょう。
Apache HTTP Server Version 2.4
| : | HTTP û |
|---|---|
| : | Extension |
| : | headers_module |
| ҽ: | mod_headers.c |
| : | RequestHeader ġ 2.0
ִ |
HTTP û ϰ ϴ þ Ѵ. ġų ü, ִ.
mod_headers ϴ þ
ҿ , μ þ
ִ.
RequestHeader append MirrorID "mirror 12"
RequestHeader unset MirrorID
MirrorID
ʴ´. ݴ MirrorID "mirror 12" Ѵ.
mod_headers û ʱ⳪ ߿
ִ. ڸ ϱ û
ϰ Ʈ ϴ (late)
Ѵ. ϴ
϶.
̸(early) ڸ ˻/ .
early Ű带 Ͽ þ û
óϱ Ҷ Ѵ. , ٸ û ǽϰų
˻縦 ϱ , ϱ ٸ
ҽÿ ִ.
ûο 캸 ̸ þ
óϱ ̸ þ ּ̳ ȣƮ
ҿ ִ. ̸ þ ûο
<Directory>
<Location> ҿ
.
Header echo ^TS
MyHeader ߰Ѵ. Ŭ̾Ʈ
ϸ ϰų Ŭ̾Ʈ
ã ִ.
Header add MyHeader "%D %t"
信 .
MyHeader: D=3775428 t=991424704447256
Header add MyHeader "Hello Joe. It took %D microseconds \
for Apache to serve this request."
信 .
MyHeader: Hello Joe. It took D=3775428 microseconds for Apache
to serve this request.
MyHeader . Ư Ŭ̾ƮԸ
信 ߰Ҷ ϴ. Ϸ
mod_setenvif ʿϴ.
SetEnvIf MyRequestHeader value HAVE_MyRequestHeader
Header add MyHeader "%D %t mytext" env=HAVE_MyRequestHeader
HTTP û MyRequestHeader: value
ִٸ, 信 .
MyHeader: D=3775428 t=991424704447256 mytext
| : | HTTP Ѵ |
|---|---|
| : | Header [condition] set|append|add|unset|echo
header [value] [early|env=[!]variable] |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Extension |
| : | mod_headers |
þ HTTP ġų ü, Ѵ. ڵ鷯 Ͱ Ŀ ϱ ִ.
condition ϸ,
onsuccess Ȥ always Ѵ.
̴ ǥ Ѵ.
onsuccess 2xx ڵ带
ϰ, always (2xx
) ڵ带 Ѵ. Ư
ϰ ʹٸ,
Ѵ.
ι° ƱԸƮ ٸ. ι° ƱԸƮ Ʒ ϳ ִ.
setappendaddappend
ؾ Ѵ.unsetechoƱԸƮ ڿ header ̸ ´.
ڿ ݷ , ȴ. set,
append, add, unset
ҹڴ Ѵ. echo header
̸ ڸ ϰ ǥ ִ.
add, append, set
Ҷ ° ƱԸƮ value ʿϴ.
value ȿ ִٸ ֵǥ Ѵ.
value Ϲ ڿ̳ ϴ ڿ̸,
ΰ ִ. value ϴ
ıڴ .
%% |
ۼƮ ȣ |
%t |
û ð ǥؽ÷ epoch (1970 1
1) ũ . տ t=
ٴ´. |
%D |
û ð Ʈ ɸ
ð. û Ⱓ . տ D=
ٴ´. |
%{FOOBAR}e |
ȯ溯 FOOBAR
. |
%{FOOBAR}s |
mod_ssl Ѵٸ, SSL ȯ溯
FOOBAR . |
%s ڴ ġ 2.1 Ŀ ִ.
ڴ SSLOptions +StdEnvVars ϴ
δ %e ִ.
SSLOptions +StdEnvVars ؾ
Ѵٸ, %e %s ξ
ȿ̴.
Header þ ڿ ൿ Ͼ
ϴ ߰ ƱԸƮ ̸ ó
ϴ Ű early ִ.
env=... ƱԸƮ ش
ȯ溯 Ѵٸ (Ȥ
env=!... ȯ溯
ʴٸ) Header þ Ѵ.
þ û ƹ ġ ʴ´.
̸ ƴ϶ Ʈ
Header þ óѴ.
Ͱ ߰ϴ κ
ϰų ִ.
| : | HTTP û Ѵ |
|---|---|
| : | RequestHeader set|append|add|unset header
[value] [early|env=[!]variable] |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Extension |
| : | mod_headers |
þ HTTP û ġų ü, Ѵ. ڵ鷯 ϱ ϱ ִ. ù° ƱԸƮ ٸ. ù° ƱԸƮ Ʒ ϳ ִ.
setappendaddappend
ؾ Ѵ.unsetƱԸƮ ڿ ´. ڿ ݷ
, ȴ. ҹڴ Ѵ. add,
append, set Ҷ °
ƱԸƮ value ʿϴ. value ȿ
ִٸ ֵǥ Ѵ. unset Ҷ
value ȵȴ. value Ϲ
ڿ̳ ϴ ڿ̸, ΰ
ִ. ϴ ıڴ Header Ƿ ڼ
װ ϶.
RequestHeader þ ڿ ൿ
Ͼ ϴ ߰ ƱԸƮ ̸ ó ϴ Ű
early ִ. env=...
ƱԸƮ ش ȯ溯
Ѵٸ (Ȥ env=!...
ȯ溯 ʴٸ) RequestHeader
þ Ѵ. þ û ƹ
ġ ʴ´.
̸ ƴ϶ fixup ܰ迡
û شϴ ڵ鷯 ϱ
RequestHeader þ óѴ.
Ȥ ġ ԷͰ ų
ִ.
Apache HTTP Server Version 2.4
ġ þ 뵵, ⺻, , Ҹ ش. ̵ þ Ѵ.
ù° þ ̸ 뵵 ˷ش. ι° þ ⺻ ִٸ ⺻ ش. ⺻ ʹ ٸ, "+" ȣ ˸.
° ° Ʒ ǥ þ ִ ҿ þ ¸ Ÿ.
| A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X |
|
|
| AcceptFilter protocol accept_filter | s | C | |
| Configures optimizations for a Protocol's Listener Sockets | |||
| AcceptPathInfo On|Off|Default | Default | svdh | C |
| Resources accept trailing pathname information | |||
| AccessFileName filename [filename] ... | .htaccess | sv | C |
| Name of the distributed configuration file | |||
| Action action-type cgi-script [virtual] | svdh | B | |
| Ư ڵ鷯 content-type CGI ũƮ Ѵ | |||
| AddAlt string file [file] ... | svdh | B | |
| ϸ ܴ | |||
| AddAltByEncoding string MIME-encoding [MIME-encoding] ... | svdh | B | |
| MIME-encoding ܴ | |||
| AddAltByType string MIME-type [MIME-type] ... | svdh | B | |
| MIME content-type ܴ | |||
| AddCharset charset extension [extension] ... | svdh | B | |
| Maps the given filename extensions to the specified content charset | |||
| AddDefaultCharset On|Off|charset | Off | svdh | C |
Default charset parameter to be added when a response
content-type is text/plain or text/html | |||
| AddDescription string file [file] ... | svdh | B | |
| Ͽ | |||
| AddEncoding encoding extension [extension] ... | svdh | B | |
| Maps the given filename extensions to the specified encoding type | |||
| AddHandler handler-name extension [extension] ... | svdh | B | |
| Maps the filename extensions to the specified handler | |||
| AddIcon icon name [name] ... | svdh | B | |
| ̸ Ͽ | |||
| AddIconByEncoding icon MIME-encoding [MIME-encoding] ... | svdh | B | |
| MIME content-encoding Ͽ | |||
| AddIconByType icon MIME-type [MIME-type] ... | svdh | B | |
| MIME content-type Ͽ | |||
| AddInputFilter filter[;filter...] extension [extension] ... | svdh | B | |
| Maps filename extensions to the filters that will process client requests | |||
| AddLanguage language-tag extension [extension] ... | svdh | B | |
| Maps the given filename extension to the specified content language | |||
| AddModuleInfo module-name string | sv | E | |
| ߰ server-info ڵ鷯 ֵ ߰Ѵ | |||
| AddOutputFilter filter[;filter...] extension [extension] ... | svdh | B | |
| Maps filename extensions to the filters that will process responses from the server | |||
| AddOutputFilterByType filter[;filter...] media-type [media-type] ... | svdh | B | |
| assigns an output filter to a particular media-type | |||
| AddType media-type extension [extension] ... | svdh | B | |
| Maps the given filename extensions onto the specified content type | |||
| Alias URL-path file-path|directory-path | sv | B | |
| URL Ư Ͻý ҷ Ѵ | |||
| AliasMatch regex file-path|directory-path | sv | B | |
| ǥ Ͽ URL Ͻý ҷ Ѵ | |||
| AliasPreservePath OFF|ON | OFF | svd | B |
| Map the full path after the alias in a location. | |||
| Allow from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts can access an area of the server | |||
| AllowCONNECT port[-port] [port[-port]] ... | 443 563 | sv | E |
Ports that are allowed to CONNECT through the
proxy | |||
| AllowEncodedSlashes On|Off|NoDecode | Off | sv | C |
| Determines whether encoded path separators in URLs are allowed to be passed through | |||
| AllowMethods reset|HTTP-method [HTTP-method]... | reset | d | X |
| Restrict access to the listed HTTP methods | |||
| AllowOverride All|None|directive-type [directive-type] ... | None (2.3.9 and lat + | d | C |
Types of directives that are allowed in
.htaccess files | |||
| AllowOverrideList None|directive [directive-type] ... | None | d | C |
Individual directives that are allowed in
.htaccess files | |||
| Anonymous user [user] ... | dh | E | |
| ȣ˻ ̵ Ѵ | |||
| Anonymous_LogEmail On|Off | On | dh | E |
| Է ȣ α | |||
| Anonymous_MustGiveEmail On|Off | On | dh | E |
| ȣ | |||
| Anonymous_NoUserID On|Off | Off | dh | E |
| ̵ | |||
| Anonymous_VerifyEmail On|Off | Off | dh | E |
| ȣ ùٸ ڿ ּ ˻ | |||
| AsyncRequestWorkerFactor factor | s | M | |
| Limit concurrent connections per process | |||
| AuthBasicAuthoritative On|Off | On | dh | B |
| Ѻο Ѱ Ѵ | |||
| AuthBasicFake off|username [password] | dh | B | |
| Fake basic authentication using the given expressions for username and password | |||
| AuthBasicProvider On|Off|provider-name [provider-name] ... | On | dh | B |
| ġ ڸ Ѵ | |||
| AuthBasicUseDigestAlgorithm MD5|Off | Off | dh | B |
| Check passwords against the authentication providers as if Digest Authentication was in force instead of Basic Authentication. | |||
| AuthDBDUserPWQuery query | d | E | |
| SQL query to look up a password for a user | |||
| AuthDBDUserRealmQuery query | d | E | |
| SQL query to look up a password hash for a user and realm. | |||
| AuthDBMGroupFile file-path | dh | E | |
| ϴ ͺ̽ ϸ Ѵ | |||
| AuthDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| ȣ ϴ ͺ̽ Ѵ | |||
| AuthDBMUserFile file-path | dh | E | |
| ڿ ȣ ϴ ͺ̽ ϸ Ѵ | |||
| AuthDigestAlgorithm MD5|MD5-sess | MD5 | dh | X |
| digest authentication challenge response hash ϴ ˰ Ѵ | |||
| AuthDigestDomain URI [URI] ... | dh | X | |
| digest authentication ȣ ϴ URI | |||
| AuthDigestNonceLifetime seconds | 300 | dh | X |
| nonce ȿ Ⱓ | |||
| AuthDigestProvider On|Off|provider-name [provider-name] ... | On | dh | X |
| ġ ڸ Ѵ | |||
| AuthDigestQop none|auth|auth-int [auth|auth-int] | auth | dh | X |
| digest authentication ȣ(quality-of-protection) Ѵ. | |||
| AuthDigestShmemSize size | 1000 | s | X |
| Ŭ̾Ʈ ϱ Ҵϴ | |||
| AuthFormAuthoritative On|Off | On | dh | B |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthFormBody fieldname | httpd_body | d | B |
| The name of a form field carrying the body of the request to attempt on successful login | |||
| AuthFormDisableNoStore On|Off | Off | d | B |
| Disable the CacheControl no-store header on the login page | |||
| AuthFormFakeBasicAuth On|Off | Off | d | B |
| Fake a Basic Authentication header | |||
| AuthFormLocation fieldname | httpd_location | d | B |
| The name of a form field carrying a URL to redirect to on successful login | |||
| AuthFormLoginRequiredLocation url | d | B | |
| The URL of the page to be redirected to should login be required | |||
| AuthFormLoginSuccessLocation url | d | B | |
| The URL of the page to be redirected to should login be successful | |||
| AuthFormLogoutLocation uri | d | B | |
| The URL to redirect to after a user has logged out | |||
| AuthFormMethod fieldname | httpd_method | d | B |
| The name of a form field carrying the method of the request to attempt on successful login | |||
| AuthFormMimetype fieldname | httpd_mimetype | d | B |
| The name of a form field carrying the mimetype of the body of the request to attempt on successful login | |||
| AuthFormPassword fieldname | httpd_password | d | B |
| The name of a form field carrying the login password | |||
| AuthFormProvider provider-name [provider-name] ... | file | dh | B |
| Sets the authentication provider(s) for this location | |||
| AuthFormSitePassphrase secret | d | B | |
| Bypass authentication checks for high traffic sites | |||
| AuthFormSize size | 8192 | d | B |
| The largest size of the form in bytes that will be parsed for the login details | |||
| AuthFormUsername fieldname | httpd_username | d | B |
| The name of a form field carrying the login username | |||
| AuthGroupFile file-path | dh | B | |
| ϴ ϸ Ѵ | |||
| AuthLDAPAuthorizePrefix prefix | AUTHORIZE_ | dh | E |
| Specifies the prefix for environment variables set during authorization | |||
| AuthLDAPBindAuthoritative off|on | on | dh | E |
| Determines if other authentication providers are used when a user can be mapped to a DN but the server cannot successfully bind with the user's credentials. | |||
| AuthLDAPBindDN distinguished-name | dh | E | |
| Optional DN to use in binding to the LDAP server | |||
| AuthLDAPBindPassword password | dh | E | |
| Password used in conjunction with the bind DN | |||
| AuthLDAPCharsetConfig file-path | s | E | |
| Language to charset conversion configuration file | |||
| AuthLDAPCompareAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization comparisons | |||
| AuthLDAPCompareDNOnServer on|off | on | dh | E |
| Use the LDAP server to compare the DNs | |||
| AuthLDAPDereferenceAliases never|searching|finding|always | always | dh | E |
| When will the module de-reference aliases | |||
| AuthLDAPGroupAttribute attribute | member uniqueMember + | dh | E |
| LDAP attributes used to identify the user members of groups. | |||
| AuthLDAPGroupAttributeIsDN on|off | on | dh | E |
| Use the DN of the client username when checking for group membership | |||
| AuthLDAPInitialBindAsUser off|on | off | dh | E |
| Determines if the server does the initial DN lookup using the basic authentication users' own username, instead of anonymously or with hard-coded credentials for the server | |||
| AuthLDAPInitialBindPattern regex substitution | (.*) $1 (remote use + | dh | E |
| Specifies the transformation of the basic authentication username to be used when binding to the LDAP server to perform a DN lookup | |||
| AuthLDAPMaxSubGroupDepth Number | 10 | dh | E |
| Specifies the maximum sub-group nesting depth that will be evaluated before the user search is discontinued. | |||
| AuthLDAPRemoteUserAttribute uid | dh | E | |
| Use the value of the attribute returned during the user query to set the REMOTE_USER environment variable | |||
| AuthLDAPRemoteUserIsDN on|off | off | dh | E |
| Use the DN of the client username to set the REMOTE_USER environment variable | |||
| AuthLDAPSearchAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization searches | |||
| AuthLDAPSubGroupAttribute attribute | member uniqueMember + | dh | E |
| Specifies the attribute labels, one value per directive line, used to distinguish the members of the current group that are groups. | |||
| AuthLDAPSubGroupClass LdapObjectClass | groupOfNames groupO + | dh | E |
| Specifies which LDAP objectClass values identify directory objects that are groups during sub-group processing. | |||
| AuthLDAPURL url [NONE|SSL|TLS|STARTTLS] | dh | E | |
| URL specifying the LDAP search parameters | |||
| AuthMerging Off | And | Or | Off | dh | B |
| Controls the manner in which each configuration section's authorization logic is combined with that of preceding configuration sections. | |||
| AuthName auth-domain | dh | B | |
| Authorization realm for use in HTTP authentication | |||
| AuthnCacheContext directory|server|custom-string | directory | d | B |
| Specify a context string for use in the cache key | |||
| AuthnCacheEnable | s | B | |
| Enable Authn caching configured anywhere | |||
| AuthnCacheProvideFor authn-provider [...] | dh | B | |
| Specify which authn provider(s) to cache for | |||
| AuthnCacheSOCache provider-name[:provider-args] | s | B | |
| Select socache backend provider to use | |||
| AuthnCacheTimeout timeout (seconds) | 300 (5 minutes) | dh | B |
| Set a timeout for cache entries | |||
| <AuthnProviderAlias baseProvider Alias> ... </AuthnProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authentication provider and referenced by the specified alias | |||
AuthnzFcgiCheckAuthnProvider provider-name|None
option ... | d | E | |
| Enables a FastCGI application to handle the check_authn authentication hook. | |||
| AuthnzFcgiDefineProvider type provider-name backend-address | s | E | |
| Defines a FastCGI application as a provider for authentication and/or authorization | |||
| AuthType None|Basic|Digest|Form | dh | B | |
| Type of user authentication | |||
| AuthUserFile file-path | dh | B | |
| ڸ ȣ ϴ ϸ Ѵ | |||
| AuthzDBDLoginToReferer On|Off | Off | d | E |
Determines whether to redirect the Client to the Referring
page on successful login or logout if a Referer request
header is present | |||
| AuthzDBDQuery query | d | E | |
| Specify the SQL Query for the required operation | |||
| AuthzDBDRedirectQuery query | d | E | |
| Specify a query to look up a login page for the user | |||
| AuthzDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| ȣ ϴ ͺ̽ Ѵ | |||
| <AuthzProviderAlias baseProvider Alias Require-Parameters> ... </AuthzProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authorization provider and referenced by the specified alias | |||
| AuthzSendForbiddenOnFailure On|Off | Off | dh | B |
| Send '403 FORBIDDEN' instead of '401 UNAUTHORIZED' if authentication succeeds but authorization fails | |||
| BalancerGrowth # | 5 | sv | E |
| Number of additional Balancers that can be added Post-configuration | |||
| BalancerInherit On|Off | On | sv | E |
| Inherit ProxyPassed Balancers/Workers from the main server | |||
| BalancerMember [balancerurl] url [key=value [key=value ...]] | d | E | |
| Add a member to a load balancing group | |||
| BalancerPersist On|Off | Off | sv | E |
| Attempt to persist changes made by the Balancer Manager across restarts. | |||
| BrotliAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| BrotliCompressionMaxInputBlock value | sv | E | |
| Maximum input block size | |||
| BrotliCompressionQuality value | 5 | sv | E |
| Compression quality | |||
| BrotliCompressionWindow value | 18 | sv | E |
| Brotli sliding compression window size | |||
| BrotliFilterNote [type] notename | sv | E | |
| Places the compression ratio in a note for logging | |||
| BrowserMatch regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| HTTP User-Agent ȯ溯 Ѵ | |||
| BrowserMatchNoCase regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| ҹڸ ʰ User-Agent ȯ溯 Ѵ | |||
| s | B | ||
| Buffer log entries in memory before writing to disk | |||
| BufferSize integer | 131072 | svdh | E |
| Maximum size in bytes to buffer by the buffer filter | |||
| CacheDefaultExpire seconds | 3600 (one hour) | sv | X |
| ð ij ⺻ Ⱓ. | |||
| svdh | X | ||
| Add an X-Cache-Detail header to the response. | |||
| CacheDirLength length | 2 | sv | X |
| 丮 ڰ | |||
| CacheDirLevels levels | 3 | sv | X |
| ij 丮 . | |||
| CacheDisable url-string | sv | X | |
| Ư URL ij ʴ´ | |||
| CacheEnable cache_type url-string | sv | X | |
| ڸ Ͽ URL ijѴ | |||
| CacheFile file-path [file-path] ... | s | X | |
| ۽ ڵ ijѴ | |||
| svdh | X | ||
| Add an X-Cache header to the response. | |||
| CacheIgnoreCacheControl On|Off | Off | sv | X |
| Ŭ̾Ʈ ijʴ û Ѵ. | |||
| CacheIgnoreHeaders header-string [header-string] ... | None | sv | X |
| ij HTTP () ʴ´ | |||
| CacheIgnoreNoLastMod On|Off | Off | sv | X |
| 信 Last Modified ٴ Ѵ. | |||
| sv | X | ||
| Ignore query string when caching | |||
| sv | X | ||
| Ignore defined session identifiers encoded in the URL when caching | |||
| sv | X | ||
| Override the base URL of reverse proxied cache keys. | |||
| CacheLastModifiedFactor float | 0.1 | sv | X |
| LastModified ð ð ϴµ ϴ . | |||
| sv | X | ||
| Enable the thundering herd lock. | |||
| sv | X | ||
| Set the maximum possible age of a cache lock. | |||
| sv | X | ||
| Set the lock path directory. | |||
| CacheMaxExpire seconds | 86400 (Ϸ) | sv | X |
| ijϴ ʴ ִð | |||
| CacheMaxFileSize bytes | 1000000 | sv | X |
| ij ִũ (Ʈ ) | |||
| svdh | X | ||
| The minimum time in seconds to cache a document | |||
| CacheMinFileSize bytes | 1 | sv | X |
| ij ּũ (Ʈ ) | |||
| CacheNegotiatedDocs On|Off | Off | sv | B |
| Allows content-negotiated documents to be cached by proxy servers | |||
| sv | X | ||
| Run the cache from the quick handler. | |||
| svdh | X | ||
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| svdh | X | ||
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheRoot directory | sv | X | |
| ij 丮 root | |||
| CacheSocache type[:args] | sv | E | |
| The shared object cache implementation to use | |||
| CacheSocacheMaxSize bytes | 102400 | svdh | E |
| The maximum size (in bytes) of an entry to be placed in the cache | |||
| CacheSocacheMaxTime seconds | 86400 | svdh | E |
| The maximum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheMinTime seconds | 600 | svdh | E |
| The minimum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheReadSize bytes | 0 | svdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheSocacheReadTime milliseconds | 0 | svdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| svdh | X | ||
| Serve stale content in place of 5xx responses. | |||
| svdh | X | ||
| Attempt to cache responses that the server reports as expired | |||
| svdh | X | ||
| Attempt to cache requests or responses that have been marked as no-store. | |||
| svdh | X | ||
| Attempt to cache responses that the server has marked as private | |||
| CGIDScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIMapExtension cgi-path .extension | dh | C | |
| Technique for locating the interpreter for CGI scripts | |||
| CGIPassAuth On|Off | Off | dh | C |
| Enables passing HTTP authorization headers to scripts as CGI variables | |||
| CGIScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIVar variable rule | dh | C | |
| Controls how some CGI variables are set | |||
| CharsetDefault charset | svdh | X | |
| ȯ | |||
| CharsetOptions option [option] ... | DebugLevel=0 NoImpl + | svdh | X |
| ȯ | |||
| CharsetSourceEnc charset | svdh | X | |
| CheckBasenameMatch on|off | On | svdh | E |
| Also match files with differing file name extensions. | |||
| svdh | E | ||
| Limits the action of the speling module to case corrections | |||
| CheckSpelling on|off | Off | svdh | E |
| Ѵ | |||
| ChrootDir /path/to/directory | s | B | |
| Directory for apache to run chroot(8) after startup. | |||
| ContentDigest On|Off | Off | svdh | C |
Enables the generation of Content-MD5 HTTP Response
headers | |||
| CookieDomain domain | svdh | E | |
| The domain to which the tracking cookie applies | |||
| CookieExpires expiry-period | svdh | E | |
| Expiry time for the tracking cookie | |||
| CookieHTTPOnly on|off | off | svdh | E |
| Adds the 'HTTPOnly' attribute to the cookie | |||
| CookieName token | Apache | svdh | E |
| Name of the tracking cookie | |||
| CookieSameSite None|Lax|Strict | svdh | E | |
| Adds the 'SameSite' attribute to the cookie | |||
| CookieSecure on|off | off | svdh | E |
| Adds the 'Secure' attribute to the cookie | |||
| CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965 | Netscape | svdh | E |
| Format of the cookie header field | |||
| CookieTracking on|off | off | svdh | E |
| Enables tracking cookie | |||
| CoreDumpDirectory directory | s | M | |
| Directory where Apache HTTP Server attempts to switch before dumping core | |||
| CustomLog file|pipe format|nickname [env=[!]environment-variable] | sv | B | |
| α ̸ Ѵ | |||
| Dav On|Off|provider-name | Off | d | E |
| WebDAV HTTP 带 Ѵ | |||
| DavBasePath root-path | d | E | |
| Configure repository root path | |||
| DavDepthInfinity on|off | off | svd | E |
| PROPFIND Depth: Infinity û 㰡Ѵ | |||
| DavGenericLockDB file-path | svd | E | |
| Location of the DAV lock database | |||
| DavLockDB file-path | sv | E | |
| DAV ͺ̽ ġ | |||
| DavLockDiscovery on|off | on | svdh | E |
| Enable lock discovery | |||
| DavMinTimeout seconds | 0 | svd | E |
| DAV ڿ ּҽð | |||
| DBDExptime time-in-seconds | 300 | sv | E |
| Keepalive time for idle connections | |||
| DBDInitSQL "SQL statement" | sv | E | |
| Execute an SQL statement after connecting to a database | |||
| DBDKeep number | 2 | sv | E |
| Maximum sustained number of connections | |||
| DBDMax number | 10 | sv | E |
| Maximum number of connections | |||
| DBDMin number | 1 | sv | E |
| Minimum number of connections | |||
| DBDParams param1=value1[,param2=value2] | sv | E | |
| Parameters for database connection | |||
| DBDPersist On|Off | sv | E | |
| Whether to use persistent connections | |||
| DBDPrepareSQL "SQL statement" label | sv | E | |
| Define an SQL prepared statement | |||
| DBDriver name | sv | E | |
| Specify an SQL driver | |||
| DefaultIcon url-path | svdh | B | |
| Ư Ͽ | |||
| DefaultLanguage language-tag | svdh | B | |
| Defines a default language-tag to be sent in the Content-Language header field for all resources in the current context that have not been assigned a language-tag by some other means. | |||
| DefaultRuntimeDir directory-path | DEFAULT_REL_RUNTIME + | s | C |
| Base directory for the server run-time files | |||
| DefaultType media-type|none | none | svdh | C |
This directive has no effect other than to emit warnings
if the value is not none. In prior versions, DefaultType
would specify a default media type to assign to response content for
which no other media type configuration could be found.
| |||
| Define parameter-name [parameter-value] | svd | C | |
| Define a variable | |||
| DeflateAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| DeflateBufferSize value | 8096 | sv | E |
| zlib ѹ ũ | |||
| DeflateCompressionLevel value | sv | E | |
| ϴ° | |||
| DeflateFilterNote [type] notename | sv | E | |
| α Ѵ | |||
| DeflateInflateLimitRequestBody value | svdh | E | |
| Maximum size of inflated request bodies | |||
| DeflateInflateRatioBurst value | 3 | svdh | E |
| Maximum number of times the inflation ratio for request bodies can be crossed | |||
| DeflateInflateRatioLimit value | 200 | svdh | E |
| Maximum inflation ratio for request bodies | |||
| DeflateMemLevel value | 9 | sv | E |
| zlib Ҷ ϴ | |||
| DeflateWindowSize value | 15 | sv | E |
| Zlib window size | |||
| Deny from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts are denied access to the server | |||
| <Directory directory-path> ... </Directory> | sv | C | |
| Enclose a group of directives that apply only to the named file-system directory, sub-directories, and their contents. | |||
| DirectoryCheckHandler On|Off | Off | svdh | B |
| Toggle how this module responds when another handler is configured | |||
| DirectoryIndex local-url [local-url] ... | index.html | svdh | B |
| Ŭ̾Ʈ 丮 ûҶ ãƺ ڿ | |||
| DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-code | off | svdh | B |
| Configures an external redirect for directory indexes. | |||
| <DirectoryMatch regex> ... </DirectoryMatch> | sv | C | |
| Enclose directives that apply to the contents of file-system directories matching a regular expression. | |||
| DirectorySlash On|Off | On | svdh | B |
| ̷ Ű | |||
| DocumentRoot directory-path | "/usr/local/apache/ + | sv | C |
| Directory that forms the main document tree visible from the web | |||
| DTracePrivileges On|Off | Off | s | X |
| Determines whether the privileges required by dtrace are enabled. | |||
| DumpIOInput On|Off | Off | s | E |
| Dump all input data to the error log | |||
| DumpIOOutput On|Off | Off | s | E |
| Dump all output data to the error log | |||
| <Else> ... </Else> | svdh | C | |
Contains directives that apply only if the condition of a
previous <If> or
<ElseIf> section is not
satisfied by a request at runtime | |||
| <ElseIf expression> ... </ElseIf> | svdh | C | |
Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
<If> or
<ElseIf> section is not
satisfied | |||
| EnableExceptionHook On|Off | Off | s | M |
| Enables a hook that runs exception handlers after a crash | |||
| EnableMMAP On|Off | On | svdh | C |
| Use memory-mapping to read files during delivery | |||
| EnableSendfile On|Off | Off | svdh | C |
| Use the kernel sendfile support to deliver files to the client | |||
| Error message | svdh | C | |
| Abort configuration parsing with a custom error message | |||
| ErrorDocument error-code document | svdh | C | |
| What the server will return to the client in case of an error | |||
| ErrorLog file-path|syslog[:[facility][:tag]] | logs/error_log (Uni + | sv | C |
| Location where the server will log errors | |||
| ErrorLogFormat [connection|request] format | sv | C | |
| Format specification for error log entries | |||
| Example | svdh | X | |
| ġ API ϱ þ | |||
| ExpiresActive On|Off | svdh | E | |
Expires Ѵ | |||
| ExpiresByType MIME-type <code>seconds | svdh | E | |
MIME type Expires Ѵ | |||
| ExpiresDefault <code>seconds | svdh | E | |
| ð ϴ ⺻ ˰ | |||
| ExtendedStatus On|Off | Off[*] | s | C |
| Keep track of extended status information for each request | |||
| ExtFilterDefine filtername parameters | s | E | |
| ܺ Ѵ | |||
| ExtFilterOptions option [option] ... | DebugLevel=0 NoLogS + | d | E |
mod_ext_filter ɼ Ѵ | |||
| svdh | B | ||
| Define a default URL for requests that don't map to a file | |||
| FileETag component ... | MTime Size | svdh | C |
| File attributes used to create the ETag HTTP response header for static files | |||
| <Files filename> ... </Files> | svdh | C | |
| Contains directives that apply to matched filenames | |||
| <FilesMatch regex> ... </FilesMatch> | svdh | C | |
| Contains directives that apply to regular-expression matched filenames | |||
| FilterChain [+=-@!]filter-name ... | svdh | B | |
| Configure the filter chain | |||
| FilterDeclare filter-name [type] | svdh | B | |
| Declare a smart filter | |||
| FilterProtocol filter-name [provider-name] proto-flags | svdh | B | |
| Deal with correct HTTP protocol handling | |||
| FilterProvider filter-name provider-name expression | svdh | B | |
| Register a content filter | |||
| FilterTrace filter-name level | svd | B | |
Get debug/diagnostic information from
mod_filter | |||
| FlushMaxPipelined number | 5 | sv | C |
| Maximum number of pipelined responses above which they are flushed to the network | |||
| FlushMaxThreshold number-of-bytes | 65535 | sv | C |
| Threshold above which pending data are flushed to the network | |||
| ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] | Prefer | svdh | B |
| Action to take if a single acceptable document is not found | |||
| ForceType media-type|None | dh | C | |
| Forces all matching files to be served with the specified media type in the HTTP Content-Type header field | |||
| ForensicLog filename|pipe | sv | E | |
| Sets filename of the forensic log | |||
| GlobalLogfile|pipe format|nickname [env=[!]environment-variable| expr=expression] | s | B | |
| Sets filename and format of log file | |||
| GprofDir /tmp/gprof/|/tmp/gprof/% | sv | C | |
| Directory to write gmon.out profiling data to. | |||
| GracefulShutdownTimeout seconds | 0 | s | M |
| Specify a timeout after which a gracefully shutdown server will exit. | |||
| Group unix-group | #-1 | s | B |
| Group under which the server will answer requests | |||
| H2CopyFiles on|off | off | svdh | E |
| Determine file handling in responses | |||
| H2Direct on|off | on for h2c, off for + | sv | E |
| H2 Direct Protocol Switch | |||
| H2EarlyHint name value | svdh | E | |
| Add a response header to be picked up in 103 Early Hints | |||
| H2EarlyHints on|off | off | sv | E |
| Determine sending of 103 status codes | |||
| H2MaxDataFrameLen n | 0 | sv | E |
| Maximum bytes inside a single HTTP/2 DATA frame | |||
| H2MaxHeaderBlockLen n | 0 | sv | E |
| Maximum size of response headers | |||
| H2MaxSessionStreams n | 100 | sv | E |
| Maximum number of active streams per HTTP/2 session. | |||
| H2MaxWorkerIdleSeconds n | 600 | s | E |
| Maximum number of seconds h2 workers remain idle until shut down. | |||
| H2MaxWorkers n | s | E | |
| Maximum number of worker threads to use per child process. | |||
| H2MinWorkers n | s | E | |
| Minimal number of worker threads to use per child process. | |||
| H2ModernTLSOnly on|off | on | sv | E |
| Require HTTP/2 connections to be "modern TLS" only | |||
| H2OutputBuffering on|off | on | sv | E |
| Determine buffering behaviour of output | |||
| H2Padding numbits | 0 | sv | E |
| Determine the range of padding bytes added to payload frames | |||
| H2ProxyRequests on|off | off | sv | E |
| En-/Disable forward proxy requests via HTTP/2 | |||
| H2Push on|off | on | svdh | E |
| H2 Server Push Switch | |||
| H2PushDiarySize n | 256 | sv | E |
| H2 Server Push Diary Size | |||
| H2PushPriority mime-type [after|before|interleaved] [weight] | * After 16 | sv | E |
| H2 Server Push Priority | |||
| H2PushResource [add] path [critical] | svdh | E | |
| Declares resources for early pushing to the client | |||
| H2SerializeHeaders on|off | off | sv | E |
| Serialize Request/Response Processing Switch | |||
| H2StreamMaxMemSize bytes | 65536 | sv | E |
| Maximum amount of output data buffered per stream. | |||
| H2StreamTimeout time-interval[s] | svd | E | |
| Maximum time waiting when sending/receiving data to stream processing | |||
| H2TLSCoolDownSecs seconds | 1 | sv | E |
| Configure the number of seconds of idle time on TLS before shrinking writes | |||
| H2TLSWarmUpSize amount | 1048576 | sv | E |
| Configure the number of bytes on TLS connection before doing max writes | |||
| H2Upgrade on|off | on for h2c, off for + | svdh | E |
| H2 Upgrade Protocol Switch | |||
| H2WebSockets on|off | off | sv | E |
| En-/Disable WebSockets via HTTP/2 | |||
| H2WindowSize bytes | 65535 | sv | E |
| Size of Stream Window for upstream data. | |||
| Header [condition] set|append|add|unset|echo header [value] [early|env=[!]variable] | svdh | E | |
| HTTP Ѵ | |||
| HeaderName filename | svdh | B | |
| ϸ ̸ | |||
| HeartbeatAddress addr:port | s | X | |
| Multicast address for heartbeat packets | |||
| HeartbeatListen addr:port | s | X | |
| multicast address to listen for incoming heartbeat requests | |||
| HeartbeatMaxServers number-of-servers | 10 | s | X |
| Specifies the maximum number of servers that will be sending heartbeat requests to this server | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to store heartbeat data when using flat-file storage | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to read heartbeat data | |||
| HostnameLookups On|Off|Double | Off | svd | C |
| Enables DNS lookups on client IP addresses | |||
| HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods] [Allow0.9|Require1.0] | Strict LenientMetho + | sv | C |
| Modify restrictions on HTTP Request Messages | |||
| IdentityCheck On|Off | Off | svd | E |
| RFC 1413 ſ α Ѵ | |||
| IdentityCheckTimeout seconds | 30 | svd | E |
| ident û ð Ѵ | |||
| <If expression> ... </If> | svdh | C | |
| Contains directives that apply only if a condition is satisfied by a request at runtime | |||
| <IfDefine [!]parameter-name> ... </IfDefine> | svdh | C | |
| Encloses directives that will be processed only if a test is true at startup | |||
| <IfDirective [!]directive-name> ... </IfDirective> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific directive | |||
| <IfFile [!]filename> ... </IfFile> | svdh | C | |
| Encloses directives that will be processed only if file exists at startup | |||
| <IfModule [!]module-file|module-identifier> ... </IfModule> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific module | |||
| <IfSection [!]section-name> ... </IfSection> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific section directive | |||
| <IfVersion [[!]operator] version> ... </IfVersion> | svdh | E | |
| ´ | |||
| ImapBase map|referer|URL | http://servername/ | svdh | B |
̹ Ͽ base ⺻ | |||
| ImapDefault error|nocontent|map|referer|URL | nocontent | svdh | B |
| ̹ʿ ش ʴ ǥ ⺻ ൿ | |||
| ImapMenu none|formatted|semiformatted|unformatted | svdh | B | |
| ǥ ̹ û ൿ | |||
| Include file-path|directory-path|wildcard | svd | C | |
| Includes other configuration files from within the server configuration files | |||
| IncludeOptional file-path|directory-path|wildcard | svd | C | |
| Includes other configuration files from within the server configuration files | |||
| svdh | B | ||
| Inserts text in the HEAD section of an index page. | |||
| IndexIgnore file [file] ... | svdh | B | |
| 丮 Ͽ ϸ ߰Ѵ | |||
| IndexIgnoreReset ON|OFF | svdh | B | |
| Empties the list of files to hide when listing a directory | |||
| IndexOptions [+|-]option [[+|-]option] ... | svdh | B | |
| 丮 | |||
| IndexOrderDefault Ascending|Descending Name|Date|Size|Description | Ascending Name | svdh | B |
| 丮 ⺻ Ѵ | |||
| IndexStyleSheet url-path | svdh | B | |
| 丮 Ͽ CSS ŸϽƮ ߰Ѵ | |||
| InputSed sed-command | dh | X | |
Sed command to filter request data (typically POST data) | |||
| ISAPIAppendLogToErrors on|off | off | svdh | B |
ISAPI exntension HSE_APPEND_LOG_PARAMETER
û α Ѵ | |||
| ISAPIAppendLogToQuery on|off | on | svdh | B |
ISAPI exntension HSE_APPEND_LOG_PARAMETER
û ǹڿ Ѵ | |||
| ISAPICacheFile file-path [file-path] ... | sv | B | |
| Ҷ о ISAPI .dll ϵ | |||
| ISAPIFakeAsync on|off | off | svdh | B |
| ISAPI ݹ ϴ ôѴ | |||
| ISAPILogNotSupported on|off | off | svdh | B |
| ISAPI extension ʴ ûϸ α Ѵ | |||
| ISAPIReadAheadBuffer size | 49152 | svdh | B |
| ISAPI extension ̸б(read ahead buffer) ũ | |||
| KeepAlive On|Off | On | sv | C |
| Enables HTTP persistent connections | |||
| KeepAliveTimeout num[ms] | 5 | sv | C |
| Amount of time the server will wait for subsequent requests on a persistent connection | |||
| KeptBodySize maximum size in bytes | 0 | d | B |
| Keep the request body instead of discarding it up to the specified maximum size, for potential use by filters such as mod_include. | |||
| LanguagePriority MIME-lang [MIME-lang] ... | svdh | B | |
| The precedence of language variants for cases where the client does not express a preference | |||
| LDAPCacheEntries number | 1024 | s | E |
| Maximum number of entries in the primary LDAP cache | |||
| LDAPCacheTTL seconds | 600 | s | E |
| Time that cached items remain valid | |||
| LDAPConnectionPoolTTL n | -1 | sv | E |
| Discard backend connections that have been sitting in the connection pool too long | |||
| LDAPConnectionTimeout seconds | s | E | |
| Specifies the socket connection timeout in seconds | |||
| LDAPLibraryDebug 7 | s | E | |
| Enable debugging in the LDAP SDK | |||
| LDAPOpCacheEntries number | 1024 | s | E |
| Number of entries used to cache LDAP compare operations | |||
| LDAPOpCacheTTL seconds | 600 | s | E |
| Time that entries in the operation cache remain valid | |||
| LDAPReferralHopLimit number | dh | E | |
| The maximum number of referral hops to chase before terminating an LDAP query. | |||
| LDAPReferrals On|Off|default | On | dh | E |
| Enable referral chasing during queries to the LDAP server. | |||
| LDAPRetries number-of-retries | 3 | s | E |
| Configures the number of LDAP server retries. | |||
| LDAPRetryDelay seconds | 0 | s | E |
| Configures the delay between LDAP server retries. | |||
| LDAPSharedCacheFile directory-path/filename | s | E | |
| Sets the shared memory cache file | |||
| LDAPSharedCacheSize bytes | 500000 | s | E |
| Size in bytes of the shared-memory cache | |||
| LDAPTimeout seconds | 60 | s | E |
| Specifies the timeout for LDAP search and bind operations, in seconds | |||
| LDAPTrustedClientCert type directory-path/filename/nickname [password] | dh | E | |
| Sets the file containing or nickname referring to a per connection client certificate. Not all LDAP toolkits support per connection client certificates. | |||
| LDAPTrustedGlobalCert type directory-path/filename [password] | s | E | |
| Sets the file or database containing global trusted Certificate Authority or global client certificates | |||
| LDAPTrustedMode type | sv | E | |
| Specifies the SSL/TLS mode to be used when connecting to an LDAP server. | |||
| LDAPVerifyServerCert On|Off | On | s | E |
| Force server certificate verification | |||
| <Limit method [method] ... > ... </Limit> | dh | C | |
| Restrict enclosed access controls to only certain HTTP methods | |||
| <LimitExcept method [method] ... > ... </LimitExcept> | dh | C | |
| Restrict access controls to all HTTP methods except the named ones | |||
| LimitInternalRecursion number [number] | 10 | sv | C |
| Determine maximum number of internal redirects and nested subrequests | |||
| LimitRequestBody bytes | 1073741824 | svdh | C |
| Restricts the total size of the HTTP request body sent from the client | |||
| LimitRequestFields number | 100 | sv | C |
| Limits the number of HTTP request header fields that will be accepted from the client | |||
| LimitRequestFieldSize bytes | 8190 | sv | C |
| Limits the size of the HTTP request header allowed from the client | |||
| LimitRequestLine bytes | 8190 | sv | C |
| Limit the size of the HTTP request line that will be accepted from the client | |||
| LimitXMLRequestBody bytes | 1000000 | svdh | C |
| Limits the size of an XML-based request body | |||
| Listen [IP-address:]portnumber [protocol] | s | M | |
| IP addresses and ports that the server listens to | |||
| ListenBackLog backlog | 511 | s | M |
| Maximum length of the queue of pending connections | |||
| ListenCoresBucketsRatio ratio | 0 (disabled) | s | M |
| Ratio between the number of CPU cores (online) and the number of listeners' buckets | |||
| LoadFile filename [filename] ... | s | E | |
| ̳ ̺귯 оδ | |||
| LoadModule module filename | s | E | |
| ̳ ̺귯 о̰, 밡 Ͽ ߰Ѵ | |||
| <Location URL-path|URL> ... </Location> | sv | C | |
| Applies the enclosed directives only to matching URLs | |||
| <LocationMatch regex> ... </LocationMatch> | sv | C | |
| Applies the enclosed directives only to regular-expression matching URLs | |||
| LogFormat format|nickname [nickname] | "%h %l %u %t \"%r\" + | sv | B |
| αϿ Ѵ | |||
| LogIOTrackTTFB ON|OFF | OFF | svdh | E |
| Enable tracking of time to first byte (TTFB) | |||
| LogLevel [module:]level [module:level] ... | warn | svd | C |
| Controls the verbosity of the ErrorLog | |||
| LogMessage message [hook=hook] [expr=expression] | d | X | |
| Log user-defined message to error log | |||
| LuaAuthzProvider provider_name /path/to/lua/script.lua function_name | s | E | |
Plug an authorization provider function into mod_authz_core
| |||
| LuaCodeCache stat|forever|never | stat | svdh | E |
| Configure the compiled code cache. | |||
| LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the access_checker phase of request processing | |||
| LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the auth_checker phase of request processing | |||
| LuaHookCheckUserID /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the check_user_id phase of request processing | |||
| LuaHookFixups /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the fixups phase of a request processing | |||
| LuaHookInsertFilter /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the insert_filter phase of request processing | |||
| LuaHookLog /path/to/lua/script.lua log_function_name | svdh | E | |
| Provide a hook for the access log phase of a request processing | |||
| LuaHookMapToStorage /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the map_to_storage phase of request processing | |||
| LuaHookPreTranslate /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the pre_translate phase of a request processing | |||
| LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late] | sv | E | |
| Provide a hook for the translate name phase of request processing | |||
| LuaHookTypeChecker /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the type_checker phase of request processing | |||
| LuaInherit none|parent-first|parent-last | parent-first | svdh | E |
| Controls how parent configuration sections are merged into children | |||
| LuaInputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content input filtering | |||
| LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name] | svdh | E | |
| Map a path to a lua handler | |||
| LuaOutputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content output filtering | |||
| LuaPackageCPath /path/to/include/?.soa | svdh | E | |
| Add a directory to lua's package.cpath | |||
| LuaPackagePath /path/to/include/?.lua | svdh | E | |
| Add a directory to lua's package.path | |||
| LuaQuickHandler /path/to/script.lua hook_function_name | sv | E | |
| Provide a hook for the quick handler of request processing | |||
| LuaRoot /path/to/a/directory | svdh | E | |
| Specify the base path for resolving relative paths for mod_lua directives | |||
| LuaScope once|request|conn|thread|server [min] [max] | once | svdh | E |
| One of once, request, conn, thread -- default is once | |||
| <Macro name [par1 .. parN]> ... </Macro> | svd | B | |
| Define a configuration file macro | |||
| MaxConnectionsPerChild number | 0 | s | M |
| Limit on the number of connections that an individual child server will handle during its life | |||
| MaxKeepAliveRequests number | 100 | sv | C |
| Number of requests allowed on a persistent connection | |||
| MaxMemFree KBytes | 2048 | s | M |
Maximum amount of memory that the main allocator is allowed
to hold without calling free() | |||
| MaxRangeOverlaps default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete
resource | |||
| MaxRangeReversals default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of range reversals (eg: 100-200,50-70) allowed before returning the complete
resource | |||
| MaxRanges default | unlimited | none | number-of-ranges | 200 | svd | C |
| Number of ranges allowed before returning the complete resource | |||
| MaxRequestWorkers number | s | M | |
| Maximum number of connections that will be processed simultaneously | |||
| MaxSpareServers number | 10 | s | M |
| Maximum number of idle child server processes | |||
| MaxSpareThreads number | s | M | |
| Maximum number of idle threads | |||
| MaxThreads number | 2048 | s | M |
| Set the maximum number of worker threads | |||
| MDActivationDelay duration | s | X | |
| How long to delay activation of new certificates | |||
| MDBaseServer on|off | off | s | X |
| Control if base server may be managed or only virtual hosts. | |||
| MDCAChallenges name [ name ... ] | tls-alpn-01 http-01 + | s | X |
| Type of ACME challenge used to prove domain ownership. | |||
| MDCertificateAgreement accepted | s | X | |
| You confirm that you accepted the Terms of Service of the Certificate Authority. | |||
| MDCertificateAuthority url | letsencrypt | s | X |
| The URL(s) of the ACME Certificate Authority to use. | |||
| MDCertificateCheck name url | s | X | |
| Set name and URL pattern for a certificate monitoring site. | |||
| MDCertificateFile path-to-pem-file | s | X | |
| Specify a static certificate file for the MD. | |||
| MDCertificateKeyFile path-to-file | s | X | |
| Specify a static private key for for the static cerrtificate. | |||
| MDCertificateMonitor name url | crt.sh https://crt. + | s | X |
| The URL of a certificate log monitor. | |||
| MDCertificateProtocol protocol | ACME | s | X |
| The protocol to use with the Certificate Authority. | |||
| MDCertificateStatus on|off | on | s | X |
| Exposes public certificate information in JSON. | |||
| MDChallengeDns01 path-to-command | s | X | |
| Set the command for setup/teardown of dns-01 challenges | |||
| MDChallengeDns01Version 1|2 | 1 | s | X |
| Set the type of arguments to call MDChallengeDns01 with | |||
| MDCheckInterval duration | 12h | s | X |
| Determines how often certificates are checked | |||
| MDContactEmail address | s | X | |
| Email address used for account registration | |||
| MDDriveMode always|auto|manual | auto | s | X |
| former name of MDRenewMode. | |||
| MDExternalAccountBinding key-id hmac-64 | none | file | none | s | X |
| Set the external account binding keyid and hmac values to use at CA | |||
| MDHttpProxy url | s | X | |
| Define a proxy for outgoing connections. | |||
| MDMatchNames all|servernames | all | s | X |
| Determines how DNS names are matched to vhosts | |||
| MDMember hostname | s | X | |
| Additional hostname for the managed domain. | |||
| MDMembers auto|manual | auto | s | X |
| Control if the alias domain names are automatically added. | |||
| MDMessageCmd path-to-cmd optional-args | s | X | |
| Handle events for Manage Domains | |||
| MDMustStaple on|off | off | s | X |
| Control if new certificates carry the OCSP Must Staple flag. | |||
| MDNotifyCmd path [ args ] | s | X | |
| Run a program when a Managed Domain is ready. | |||
| MDomain dns-name [ other-dns-name... ] [auto|manual] | s | X | |
| Define list of domain names that belong to one group. | |||
| <MDomainSet dns-name [ other-dns-name... ]>...</MDomainSet> | s | X | |
| Container for directives applied to the same managed domains. | |||
| MDPortMap map1 [ map2 ] | http:80 https:443 | s | X |
| Map external to internal ports for domain ownership verification. | |||
| MDPrivateKeys type [ params... ] | RSA 2048 | s | X |
| Set type and size of the private keys generated. | |||
| MDProfile name | s | X | |
| Use a specific ACME profile from the CA | |||
| MDProfileMandatory on|off | off | s | X |
| Control if an MDProfile is mandatory. | |||
| MDRenewMode always|auto|manual | auto | s | X |
| Controls if certificates shall be renewed. | |||
| MDRenewWindow duration | 33% | s | X |
| Control when a certificate will be renewed. | |||
| MDRequireHttps off|temporary|permanent | off | s | X |
| Redirects http: traffic to https: for Managed Domains. | |||
| MDRetryDelay duration | 5s | s | X |
| Time length for first retry, doubled on every consecutive error. | |||
| MDRetryFailover number | 13 | s | X |
| The number of errors before a failover to another CA is triggered | |||
| MDServerStatus on|off | on | s | X |
| Control if Managed Domain information is added to server-status. | |||
| MDStapleOthers on|off | on | s | X |
| Enable stapling for certificates not managed by mod_md. | |||
| MDStapling on|off | off | s | X |
| Enable stapling for all or a particular MDomain. | |||
| MDStaplingKeepResponse duration | 7d | s | X |
| Controls when old responses should be removed. | |||
| MDStaplingRenewWindow duration | 33% | s | X |
| Control when the stapling responses will be renewed. | |||
| MDStoreDir path | md | s | X |
| Path on the local file system to store the Managed Domains data. | |||
| MDStoreLocks on|off|duration | off | s | X |
| Configure locking of store for updates | |||
| MDWarnWindow duration | 10% | s | X |
| Define the time window when you want to be warned about an expiring certificate. | |||
| MemcacheConnTTL num[units] | 15s | sv | E |
| Keepalive time for idle connections | |||
| MergeSlashes ON|OFF | ON | sv | C |
| Controls whether the server merges consecutive slashes in URLs. | |||
| MergeTrailers [on|off] | off | sv | C |
| Determines whether trailers are merged into headers | |||
| MetaDir directory | .web | svdh | E |
| CERN Ÿ ã 丮 ̸ | |||
| MetaFiles on|off | off | svdh | E |
| CERN Ÿ óѴ | |||
| MetaSuffix suffix | .meta | svdh | E |
| CERN Ÿ ϴ ̻ | |||
| MimeMagicFile file-path | sv | E | |
| Enable MIME-type determination based on file contents using the specified magic file | |||
| MinSpareServers number | 5 | s | M |
| Minimum number of idle child server processes | |||
| MinSpareThreads number | s | M | |
| Minimum number of idle threads available to handle request spikes | |||
| MMapFile file-path [file-path] ... | s | X | |
| ۽ Ѵ | |||
| ModemStandard V.21|V.26bis|V.32|V.34|V.92 | d | X | |
| Modem standard to simulate | |||
| ModMimeUsePathInfo On|Off | Off | d | B |
Tells mod_mime to treat path_info
components as part of the filename | |||
| MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers [Handlers|Filters] | NegotiatedOnly | svdh | B |
| The types of files that will be included when searching for a matching file with MultiViews | |||
| Mutex mechanism [default|mutex-name] ... [OmitPID] | default | s | C |
| Configures mutex mechanism and lock file directory for all or specified mutexes | |||
| NameVirtualHost addr[:port] | s | C | |
| DEPRECATED: Designates an IP address for name-virtual hosting | |||
| NoProxy host [host] ... | sv | E | |
| Hosts, domains, or networks that will be connected to directly | |||
| NWSSLTrustedCerts filename [filename] ... | s | B | |
| List of additional client certificates | |||
| NWSSLUpgradeable [IP-address:]portnumber | s | B | |
| Allows a connection to be upgraded to an SSL connection upon request | |||
| Options [+|-]option [[+|-]option] ... | FollowSymlinks | svdh | C |
| Configures what features are available in a particular directory | |||
| Order ordering | Deny,Allow | dh | E |
Controls the default access state and the order in which
Allow and Deny are
evaluated. | |||
| OutputSed sed-command | dh | X | |
| Sed command for filtering response content | |||
| PassEnv env-variable [env-variable] ... | svdh | B | |
| ȯ溯 ´ | |||
| PidFile filename | logs/httpd.pid | s | M |
| File where the server records the process ID of the daemon | |||
| PrivilegesMode FAST|SECURE|SELECTIVE | FAST | svd | X |
| Trade off processing speed and efficiency vs security against malicious privileges-aware code. | |||
| Protocol protocol | sv | C | |
| Protocol for a listening socket | |||
| ProtocolEcho On|Off | sv | X | |
| echo Ű | |||
| Protocols protocol ... | http/1.1 | sv | C |
| Protocols available for a server/virtual host | |||
| ProtocolsHonorOrder On|Off | On | sv | C |
| Determines if order of Protocols determines precedence during negotiation | |||
| <Proxy wildcard-url> ...</Proxy> | sv | E | |
| Container for directives applied to proxied resources | |||
| Proxy100Continue Off|On | On | svd | E |
| Forward 100-continue expectation to the origin server | |||
| ProxyAddHeaders Off|On | On | svd | E |
| Add proxy information in X-Forwarded-* headers | |||
| ProxyBadHeader IsError|Ignore|StartBody | IsError | sv | E |
| Determines how to handle bad header lines in a response | |||
| ProxyBlock *|word|host|domain [word|host|domain] ... | sv | E | |
| Words, hosts, or domains that are banned from being proxied | |||
| ProxyDomain Domain | sv | E | |
| Default domain name for proxied requests | |||
| ProxyErrorOverride Off|On [code ...] | Off | svd | E |
| Override error pages for proxied content | |||
| ProxyExpressDBMFile pathname | sv | E | |
| Pathname to DBM file. | |||
| ProxyExpressDBMType type | default | sv | E |
| DBM type of file. | |||
| ProxyExpressEnable on|off | off | sv | E |
| Enable the module functionality. | |||
| ProxyFCGIBackendType FPM|GENERIC | FPM | svdh | E |
| Specify the type of backend FastCGI application | |||
| ProxyFCGISetEnvIf conditional-expression [!]environment-variable-name [value-expression] | svdh | E | |
| Allow variables sent to FastCGI servers to be fixed up | |||
| ProxyFtpDirCharset character_set | ISO-8859-1 | svd | E |
| Define the character set for proxied FTP listings | |||
| ProxyFtpEscapeWildcards on|off | on | svd | E |
| Whether wildcards in requested filenames are escaped when sent to the FTP server | |||
| ProxyFtpListOnWildcard on|off | on | svd | E |
| Whether wildcards in requested filenames trigger a file listing | |||
| ProxyHCExpr name {ap_expr expression} | sv | E | |
| Creates a named condition expression to use to determine health of the backend based on its response | |||
| ProxyHCTemplate name parameter=setting [...] | sv | E | |
| Creates a named template for setting various health check parameters | |||
| ProxyHCTPsize size | 16 | s | E |
| Sets the total server-wide size of the threadpool used for the health check workers | |||
| ProxyHTMLBufSize bytes | 8192 | svd | B |
| Sets the buffer size increment for buffering inline scripts and stylesheets. | |||
| ProxyHTMLCharsetOut Charset | * | svd | B | |
| Specify a charset for mod_proxy_html output. | |||
| ProxyHTMLDocType HTML|XHTML [Legacy] OR ProxyHTMLDocType fpi [SGML|XML] | svd | B | |
| Sets an HTML or XHTML document type declaration. | |||
| ProxyHTMLEnable On|Off | Off | svd | B |
| Turns the proxy_html filter on or off. | |||
| ProxyHTMLEvents attribute [attribute ...] | svd | B | |
| Specify attributes to treat as scripting events. | |||
| ProxyHTMLExtended On|Off | Off | svd | B |
| Determines whether to fix links in inline scripts, stylesheets, and scripting events. | |||
| ProxyHTMLFixups [lowercase] [dospath] [reset] | svd | B | |
| Fixes for simple HTML errors. | |||
| ProxyHTMLInterp On|Off | Off | svd | B |
Enables per-request interpolation of
ProxyHTMLURLMap rules. | |||
| ProxyHTMLLinks element attribute [attribute2 ...] | svd | B | |
| Specify HTML elements that have URL attributes to be rewritten. | |||
| ProxyHTMLMeta On|Off | Off | svd | B |
Turns on or off extra pre-parsing of metadata in HTML
<head> sections. | |||
| ProxyHTMLStripComments On|Off | Off | svd | B |
| Determines whether to strip HTML comments. | |||
| ProxyHTMLURLMap from-pattern to-pattern [flags] [cond] | svd | B | |
| Defines a rule to rewrite HTML links | |||
| ProxyIOBufferSize bytes | 8192 | sv | E |
| Determine size of internal data throughput buffer | |||
| <ProxyMatch regex> ...</ProxyMatch> | sv | E | |
| Container for directives applied to regular-expression-matched proxied resources | |||
| ProxyMaxForwards number | -1 | sv | E |
| Maximum number of proxies that a request can be forwarded through | |||
| ProxyPass [path] !|url [key=value [key=value ...]] [nocanon] [interpolate] [noquery] | svd | E | |
| Maps remote servers into the local server URL-space | |||
| ProxyPassInherit On|Off | On | sv | E |
| Inherit ProxyPass directives defined from the main server | |||
| ProxyPassInterpolateEnv On|Off | Off | svd | E |
| Enable Environment Variable interpolation in Reverse Proxy configurations | |||
| ProxyPassMatch [regex] !|url [key=value [key=value ...]] | svd | E | |
| Maps remote servers into the local server URL-space using regular expressions | |||
| ProxyPassReverse [path] url [interpolate] | svd | E | |
| Adjusts the URL in HTTP response headers sent from a reverse proxied server | |||
| ProxyPassReverseCookieDomain internal-domain public-domain [interpolate] | svd | E | |
| Adjusts the Domain string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPassReverseCookiePath internal-path public-path [interpolate] | svd | E | |
| Adjusts the Path string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPreserveHost On|Off | Off | svd | E |
| Use incoming Host HTTP request header for proxy request | |||
| ProxyReceiveBufferSize bytes | 0 | sv | E |
| Network buffer size for proxied HTTP and FTP connections | |||
| ProxyRemote match remote-server [username:password] | sv | E | |
| Remote proxy used to handle certain requests | |||
| ProxyRemoteMatch regex remote-server [username:password] | sv | E | |
| Remote proxy used to handle requests matched by regular expressions | |||
| ProxyRequests On|Off | Off | sv | E |
| Enables forward (standard) proxy requests | |||
| ProxySCGIInternalRedirect On|Off|Headername | On | svd | E |
| Enable or disable internal redirect responses from the backend | |||
| ProxySCGISendfile On|Off|Headername | Off | svd | E |
| Enable evaluation of X-Sendfile pseudo response header | |||
| ProxySet url key=value [key=value ...] | svd | E | |
| Set various Proxy balancer or member parameters | |||
| ProxySourceAddress address | sv | E | |
| Set local IP address for outgoing proxy connections | |||
| ProxyStatus Off|On|Full | Off | sv | E |
| Show Proxy LoadBalancer status in mod_status | |||
| ProxyTimeout seconds | sv | E | |
| Network timeout for proxied requests | |||
| ProxyVia On|Off|Full|Block | Off | sv | E |
Information provided in the Via HTTP response
header for proxied requests | |||
| ProxyWebsocketFallbackToProxyHttp On|Off | On | sv | E |
Instructs this module to let mod_proxy_http handle the request | |||
| QualifyRedirectURL On|Off | Off | svd | C |
| Controls whether the REDIRECT_URL environment variable is fully qualified | |||
| ReadBufferSize bytes | 8192 | svd | C |
| Size of the buffers used to read data | |||
| ReadmeName filename | svdh | B | |
| ϸ ̸ | |||
| ReceiveBufferSize bytes | 0 | s | M |
| TCP receive buffer size | |||
| Redirect [status] URL-path URL | svdh | B | |
| Ŭ̾Ʈ ٸ URL ϵ ûϴ ܺ ̷ | |||
| RedirectMatch [status] regex URL | svdh | B | |
| URL ǥĿ شϸ ܺ ̷ | |||
| RedirectPermanent URL-path URL | svdh | B | |
| Ŭ̾Ʈ ٸ URL ϵ ûϴ ܺ ̷ | |||
| RedirectRelative On|Off | Off | svd | B |
| Allows relative redirect targets. | |||
| RedirectTemp URL-path URL | svdh | B | |
| Ŭ̾Ʈ ٸ URL ϵ ûϴ ܺ ӽ ̷ | |||
| RedisConnPoolTTL num[units] | 15s | sv | E |
| TTL used for the connection pool with the Redis server(s) | |||
| RedisTimeout num[units] | 5s | sv | E |
| R/W timeout used for the connection with the Redis server(s) | |||
| ReflectorHeader inputheader [outputheader] | svdh | B | |
| Reflect an input header to the output headers | |||
| RegexDefaultOptions [none] [+|-]option [[+|-]option] ... | DOTALL DOLLAR_ENDON + | s | C |
| Allow to configure global/default options for regexes | |||
| RegisterHttpMethod method [method [...]] | s | C | |
| Register non-standard HTTP methods | |||
| RemoteIPHeader header-field | sv | B | |
| Declare the header field which should be parsed for useragent IP addresses | |||
| RemoteIPInternalProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPInternalProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPProxiesHeader HeaderFieldName | sv | B | |
| Declare the header field which will record all intermediate IP addresses | |||
| RemoteIPProxyProtocol On|Off | sv | B | |
| Enable or disable PROXY protocol handling | |||
| RemoteIPProxyProtocolExceptions host|range [host|range] [host|range] | sv | B | |
| Disable processing of PROXY header for certain hosts or networks | |||
| RemoteIPTrustedProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPTrustedProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoveCharset extension [extension] ... | vdh | B | |
| Removes any character set associations for a set of file extensions | |||
| RemoveEncoding extension [extension] ... | vdh | B | |
| Removes any content encoding associations for a set of file extensions | |||
| RemoveHandler extension [extension] ... | vdh | B | |
| Removes any handler associations for a set of file extensions | |||
| RemoveInputFilter extension [extension] ... | vdh | B | |
| Removes any input filter associations for a set of file extensions | |||
| RemoveLanguage extension [extension] ... | vdh | B | |
| Removes any language associations for a set of file extensions | |||
| RemoveOutputFilter extension [extension] ... | vdh | B | |
| Removes any output filter associations for a set of file extensions | |||
| RemoveType extension [extension] ... | vdh | B | |
| Removes any content type associations for a set of file extensions | |||
| RequestHeader set|append|add|unset header [value] [early|env=[!]variable] | svdh | E | |
| HTTP û Ѵ | |||
| RequestReadTimeout [handshake=timeout[-maxtimeout][,MinRate=rate] [header=timeout[-maxtimeout][,MinRate=rate] [body=timeout[-maxtimeout][,MinRate=rate] | handshake=0 header= + | sv | E |
| Set timeout values for completing the TLS handshake, receiving the request headers and/or body from client. | |||
| Require [not] entity-name [entity-name] ... | dh | B | |
| Tests whether an authenticated user is authorized by an authorization provider. | |||
| <RequireAll> ... </RequireAll> | dh | B | |
| Enclose a group of authorization directives of which none must fail and at least one must succeed for the enclosing directive to succeed. | |||
| <RequireAny> ... </RequireAny> | dh | B | |
| Enclose a group of authorization directives of which one must succeed for the enclosing directive to succeed. | |||
| <RequireNone> ... </RequireNone> | dh | B | |
| Enclose a group of authorization directives of which none must succeed for the enclosing directive to not fail. | |||
| RewriteBase URL-path | dh | E | |
| Sets the base URL for per-directory rewrites | |||
| RewriteCond TestString CondPattern [flags] | svdh | E | |
| Defines a condition under which rewriting will take place | |||
| RewriteEngine on|off | off | svdh | E |
| Enables or disables runtime rewriting engine | |||
| RewriteMap MapName MapType:MapSource [MapTypeOptions] | sv | E | |
| Defines a mapping function for key-lookup | |||
| RewriteOptions Options | svdh | E | |
| Sets some special options for the rewrite engine | |||
| RewriteRule Pattern Substitution [flags] | svdh | E | |
| Defines rules for the rewriting engine | |||
| RLimitCPU seconds|max [seconds|max] | svdh | C | |
| Limits the CPU consumption of processes launched by Apache httpd children | |||
| RLimitMEM bytes|max [bytes|max] | svdh | C | |
| Limits the memory consumption of processes launched by Apache httpd children | |||
| RLimitNPROC number|max [number|max] | svdh | C | |
| Limits the number of processes that can be launched by processes launched by Apache httpd children | |||
| Satisfy Any|All | All | dh | E |
| Interaction between host-level access control and user authentication | |||
| ScoreBoardFile file-path | logs/apache_runtime + | s | M |
| Location of the file used to store coordination data for the child processes | |||
| Script method cgi-script | svd | B | |
| Ư û忡 CGI ũƮ Ѵ. | |||
| ScriptAlias URL-path file-path|directory-path | sv | B | |
| URL Ư Ͻý ҷ ϰ CGI ũƮ ˸ | |||
| ScriptAliasMatch regex file-path|directory-path | sv | B | |
| ǥ Ͽ URL Ư Ͻý ҷ ϰ CGI ũƮ ˸ | |||
| ScriptInterpreterSource Registry|Registry-Strict|Script | Script | svdh | C |
| Technique for locating the interpreter for CGI scripts | |||
| ScriptLog file-path | sv | B | |
| CGI ũƮ α ġ | |||
| ScriptLogBuffer bytes | 1024 | sv | B |
| ũƮ α PUT Ȥ POST û ִ뷮 | |||
| ScriptLogLength bytes | 10385760 | sv | B |
| CGI ũƮ α ũ | |||
| ScriptSock file-path | logs/cgisock | sv | B |
| cgi ̸ | |||
| SecureListen [IP-address:]portnumber Certificate-Name [MUTUAL] | s | B | |
| Enables SSL encryption for the specified port | |||
| SeeRequestTail On|Off | Off | s | C |
| Determine if mod_status displays the first 63 characters of a request or the last 63, assuming the request itself is greater than 63 chars. | |||
| SendBufferSize bytes | 0 | s | M |
| TCP buffer size | |||
| ServerAdmin email-address|URL | sv | C | |
| Email address that the server includes in error messages sent to the client | |||
| ServerAlias hostname [hostname] ... | v | C | |
| Alternate names for a host used when matching requests to name-virtual hosts | |||
| ServerLimit number | s | M | |
| Upper limit on configurable number of processes | |||
| ServerName [scheme://]domain-name|ip-address[:port] | sv | C | |
| Hostname and port that the server uses to identify itself | |||
| ServerPath URL-path | v | C | |
| Legacy URL pathname for a name-based virtual host that is accessed by an incompatible browser | |||
| ServerRoot directory-path | /usr/local/apache | s | C |
| Base directory for the server installation | |||
| ServerSignature On|Off|EMail | Off | svdh | C |
| Configures the footer on server-generated documents | |||
| ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full | Full | s | C |
Configures the Server HTTP response
header | |||
| Session On|Off | Off | svdh | E |
| Enables a session for the current directory or location | |||
| SessionCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session | |||
| SessionCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session | |||
| SessionCookieRemove On|Off | Off | svdh | E |
| Control for whether session cookies should be removed from incoming HTTP headers | |||
| SessionCryptoCipher name | aes256 | svdh | X |
| The crypto cipher to be used to encrypt the session | |||
| SessionCryptoDriver name [param[=value]] | s | X | |
| The crypto driver to be used to encrypt the session | |||
| SessionCryptoPassphrase secret [ secret ... ] | svdh | X | |
| The key used to encrypt the session | |||
| SessionCryptoPassphraseFile filename | svd | X | |
| File containing keys used to encrypt the session | |||
| SessionDBDCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session ID | |||
| SessionDBDCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session ID | |||
| SessionDBDCookieRemove On|Off | On | svdh | E |
| Control for whether session ID cookies should be removed from incoming HTTP headers | |||
| SessionDBDDeleteLabel label | deletesession | svdh | E |
| The SQL query to use to remove sessions from the database | |||
| SessionDBDInsertLabel label | insertsession | svdh | E |
| The SQL query to use to insert sessions into the database | |||
| SessionDBDPerUser On|Off | Off | svdh | E |
| Enable a per user session | |||
| SessionDBDSelectLabel label | selectsession | svdh | E |
| The SQL query to use to select sessions from the database | |||
| SessionDBDUpdateLabel label | updatesession | svdh | E |
| The SQL query to use to update existing sessions in the database | |||
| SessionEnv On|Off | Off | svdh | E |
| Control whether the contents of the session are written to the HTTP_SESSION environment variable | |||
| SessionExclude path | svdh | E | |
| Define URL prefixes for which a session is ignored | |||
| SessionExpiryUpdateInterval interval | 0 (always update) | svdh | E |
| Define the number of seconds a session's expiry may change without the session being updated | |||
| SessionHeader header | svdh | E | |
| Import session updates from a given HTTP response header | |||
| SessionInclude path | svdh | E | |
| Define URL prefixes for which a session is valid | |||
| SessionMaxAge maxage | 0 | svdh | E |
| Define a maximum age in seconds for a session | |||
| SetEnv env-variable value | svdh | B | |
| ȯ溯 Ѵ | |||
| SetEnvIf attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| û ȯ溯 Ѵ | |||
| svdh | B | ||
| Sets environment variables based on an ap_expr expression | |||
| SetEnvIfNoCase attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| ҹڸ ʰ û ȯ溯 Ѵ | |||
| SetHandler handler-name|none|expression | svdh | C | |
| Forces all matching files to be processed by a handler | |||
| SetInputFilter filter[;filter...] | svdh | C | |
| Sets the filters that will process client requests and POST input | |||
| SetOutputFilter filter[;filter...] | svdh | C | |
| Sets the filters that will process responses from the server | |||
| SSIEndTag tag | "-->" | sv | B |
| String that ends an include element | |||
| SSIErrorMsg message | "[an error occurred + | svdh | B |
| Error message displayed when there is an SSI error | |||
| SSIETag on|off | off | dh | B |
| Controls whether ETags are generated by the server. | |||
| SSILastModified on|off | off | dh | B |
Controls whether Last-Modified headers are generated by the
server. | |||
| SSILegacyExprParser on|off | off | dh | B |
| Enable compatibility mode for conditional expressions. | |||
| SSIStartTag tag | "<!--#" | sv | B |
| String that starts an include element | |||
| SSITimeFormat formatstring | "%A, %d-%b-%Y %H:%M + | svdh | B |
| Configures the format in which date strings are displayed | |||
| SSIUndefinedEcho string | "(none)" | svdh | B |
| String displayed when an unset variable is echoed | |||
| SSLCACertificateFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for Client Auth | |||
| SSLCACertificatePath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for Client Auth | |||
| SSLCADNRequestFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCADNRequestPath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCARevocationCheck chain|leaf|none [flags ...] | none | sv | E |
| Enable CRL-based revocation checking | |||
| SSLCARevocationFile file-path | sv | E | |
| File of concatenated PEM-encoded CA CRLs for Client Auth | |||
| SSLCARevocationPath directory-path | sv | E | |
| Directory of PEM-encoded CA CRLs for Client Auth | |||
| SSLCertificateChainFile file-path | sv | E | |
| File of PEM-encoded Server CA Certificates | |||
| SSLCertificateFile file-path|certid | sv | E | |
| Server PEM-encoded X.509 certificate data file or token identifier | |||
| SSLCertificateKeyFile file-path|keyid | sv | E | |
| Server PEM-encoded private key file | |||
| SSLCipherSuite [protocol] cipher-spec | DEFAULT (depends on + | svdh | E |
| Cipher Suite available for negotiation in SSL handshake | |||
| SSLCompression on|off | off | sv | E |
| Enable compression on the SSL level | |||
| SSLCryptoDevice engine | builtin | s | E |
| Enable use of a cryptographic hardware accelerator | |||
| SSLEngine on|off|optional | off | sv | E |
| SSL Engine Operation Switch | |||
| SSLFIPS on|off | off | s | E |
| SSL FIPS mode Switch | |||
| SSLHonorCipherOrder on|off | off | sv | E |
| Option to prefer the server's cipher preference order | |||
| SSLInsecureRenegotiation on|off | off | sv | E |
| Option to enable support for insecure renegotiation | |||
| SSLOCSPDefaultResponder uri | sv | E | |
| Set the default responder URI for OCSP validation | |||
| SSLOCSPEnable on|leaf|off | off | sv | E |
| Enable OCSP validation of the client certificate chain | |||
| SSLOCSPNoverify on|off | off | sv | E |
| skip the OCSP responder certificates verification | |||
| SSLOCSPOverrideResponder on|off | off | sv | E |
| Force use of the default responder URI for OCSP validation | |||
| SSLOCSPProxyURL url | sv | E | |
| Proxy URL to use for OCSP requests | |||
| SSLOCSPResponderCertificateFile file | sv | E | |
| Set of trusted PEM encoded OCSP responder certificates | |||
| SSLOCSPResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP queries | |||
| SSLOCSPResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP responses | |||
| SSLOCSPResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP response validation | |||
| SSLOCSPUseRequestNonce on|off | on | sv | E |
| Use a nonce within OCSP queries | |||
| SSLOpenSSLConfCmd command-name command-value | sv | E | |
| Configure OpenSSL parameters through its SSL_CONF API | |||
| SSLOptions [+|-]option ... | svdh | E | |
| Configure various SSL engine run-time options | |||
| SSLPassPhraseDialog type | builtin | s | E |
| Type of pass phrase dialog for encrypted private keys | |||
| SSLProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | sv | E |
| Configure usable SSL/TLS protocol versions | |||
| SSLProxyCACertificateFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCACertificatePath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCARevocationCheck chain|leaf|none | none | sv | E |
| Enable CRL-based revocation checking for Remote Server Auth | |||
| SSLProxyCARevocationFile file-path | sv | E | |
| File of concatenated PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCARevocationPath directory-path | sv | E | |
| Directory of PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCheckPeerCN on|off | on | sv | E |
| Whether to check the remote server certificate's CN field | |||
| SSLProxyCheckPeerExpire on|off | on | sv | E |
| Whether to check if remote server certificate is expired | |||
| SSLProxyCheckPeerName on|off | on | sv | E |
| Configure host name checking for remote server certificates | |||
| SSLProxyCipherSuite [protocol] cipher-spec | ALL:!ADH:RC4+RSA:+H + | sv | E |
| Cipher Suite available for negotiation in SSL proxy handshake | |||
| SSLProxyEngine on|off | off | sv | E |
| SSL Proxy Engine Operation Switch | |||
| SSLProxyMachineCertificateChainFile filename | sv | E | |
| File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate | |||
| SSLProxyMachineCertificateFile filename | sv | E | |
| File of concatenated PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyMachineCertificatePath directory | sv | E | |
| Directory of PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | sv | E |
| Configure usable SSL protocol flavors for proxy usage | |||
| SSLProxyVerify level | none | sv | E |
| Type of remote server Certificate verification | |||
| SSLProxyVerifyDepth number | 1 | sv | E |
| Maximum depth of CA Certificates in Remote Server Certificate verification | |||
| SSLRandomSeed context source [bytes] | s | E | |
| Pseudo Random Number Generator (PRNG) seeding source | |||
| SSLRenegBufferSize bytes | 131072 | dh | E |
| Set the size for the SSL renegotiation buffer | |||
| SSLRequire expression | dh | E | |
| Allow access only when an arbitrarily complex boolean expression is true | |||
| SSLRequireSSL | dh | E | |
| Deny access when SSL is not used for the HTTP request | |||
| SSLSessionCache type | none | s | E |
| Type of the global/inter-process SSL Session Cache | |||
| SSLSessionCacheTimeout seconds | 300 | sv | E |
| Number of seconds before an SSL session expires in the Session Cache | |||
| SSLSessionTicketKeyFile file-path | sv | E | |
| Persistent encryption/decryption key for TLS session tickets | |||
| SSLSessionTickets on|off | on | sv | E |
| Enable or disable use of TLS session tickets | |||
| SSLSRPUnknownUserSeed secret-string | sv | E | |
| SRP unknown user seed | |||
| SSLSRPVerifierFile file-path | sv | E | |
| Path to SRP verifier file | |||
| SSLStaplingCache type | s | E | |
| Configures the OCSP stapling cache | |||
| SSLStaplingErrorCacheTimeout seconds | 600 | sv | E |
| Number of seconds before expiring invalid responses in the OCSP stapling cache | |||
| SSLStaplingFakeTryLater on|off | on | sv | E |
| Synthesize "tryLater" responses for failed OCSP stapling queries | |||
| SSLStaplingForceURL uri | sv | E | |
| Override the OCSP responder URI specified in the certificate's AIA extension | |||
| SSLStaplingResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP stapling queries | |||
| SSLStaplingResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP stapling responses | |||
| SSLStaplingResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP stapling response validation | |||
| SSLStaplingReturnResponderErrors on|off | on | sv | E |
| Pass stapling related OCSP errors on to client | |||
| SSLStaplingStandardCacheTimeout seconds | 3600 | sv | E |
| Number of seconds before expiring responses in the OCSP stapling cache | |||
| SSLStrictSNIVHostCheck on|off | off | sv | E |
| Whether to allow non-SNI clients to access a name-based virtual host. | |||
| SSLUserName varname | sdh | E | |
| Variable name to determine user name | |||
| SSLUseStapling on|off | off | sv | E |
| Enable stapling of OCSP responses in the TLS handshake | |||
| SSLVerifyClient level | none | svdh | E |
| Type of Client Certificate verification | |||
| SSLVerifyDepth number | 1 | svdh | E |
| Maximum depth of CA Certificates in Client Certificate verification | |||
| StartServers number | s | M | |
| Number of child server processes created at startup | |||
| StartThreads number | s | M | |
| Number of threads created on startup | |||
| StrictHostCheck ON|OFF | OFF | sv | C |
| Controls whether the server requires the requested hostname be listed enumerated in the virtual host handling the request | |||
| Substitute s/pattern/substitution/[infq] | dh | E | |
| Pattern to filter the response content | |||
| SubstituteInheritBefore on|off | off | dh | E |
| Change the merge order of inherited patterns | |||
| SubstituteMaxLineLength bytes(b|B|k|K|m|M|g|G) | 1m | dh | E |
| Set the maximum line size | |||
| Suexec On|Off | s | B | |
| Enable or disable the suEXEC feature | |||
| SuexecUserGroup User Group | sv | E | |
| CGI α ڿ | |||
| ThreadLimit number | s | M | |
| Sets the upper limit on the configurable number of threads per child process | |||
| ThreadsPerChild number | s | M | |
| Number of threads created by each child process | |||
| ThreadStackSize size | s | M | |
| The size in bytes of the stack used by threads handling client connections | |||
| TimeOut seconds | 60 | sv | C |
| Amount of time the server will wait for certain events before failing a request | |||
| TraceEnable [on|off|extended] | on | sv | C |
Determines the behavior on TRACE requests | |||
| TransferLog file|pipe | sv | B | |
| α ġ Ѵ | |||
| TypesConfig file-path | conf/mime.types | s | B |
The location of the mime.types file | |||
| UNCList hostname [hostname...] | s | C | |
| Controls what UNC host names can be accessed by the server | |||
| UnDefine parameter-name | s | C | |
| Undefine the existence of a variable | |||
| UndefMacro name | svd | B | |
| Undefine a macro | |||
| UnsetEnv env-variable [env-variable] ... | svdh | B | |
| ȯ溯 Ѵ | |||
| Use name [value1 ... valueN] | svd | B | |
| Use a macro | |||
| UseCanonicalName On|Off|DNS | Off | svd | C |
| Configures how the server determines its own name and port | |||
| UseCanonicalPhysicalPort On|Off | Off | svd | C |
| Configures how the server determines its own port | |||
| User unix-userid | #-1 | s | B |
| The userid under which the server will answer requests | |||
| UserDir directory-filename | public_html | sv | B |
| ں 丮 ġ | |||
| VHostCGIMode On|Off|Secure | On | v | X |
| Determines whether the virtualhost can run subprocesses, and the privileges available to subprocesses. | |||
| VHostCGIPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to subprocesses created by a virtual host. | |||
| VHostGroup unix-groupid | v | X | |
| Sets the Group ID under which a virtual host runs. | |||
| VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to a virtual host. | |||
| VHostSecure On|Off | On | v | X |
| Determines whether the server runs with enhanced security for the virtualhost. | |||
| VHostUser unix-userid | v | X | |
| Sets the User ID under which a virtual host runs. | |||
| VirtualDocumentRoot interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| VirtualDocumentRootIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| <VirtualHost addr[:port] [addr[:port]] ...> ... </VirtualHost> | s | C | |
| Contains directives that apply only to a specific hostname or IP address | |||
| VirtualScriptAlias interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| VirtualScriptAliasIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| WatchdogInterval time-interval[s] | 1 | s | B |
| Watchdog interval in seconds | |||
| XBitHack on|off|full | off | svdh | B |
| Parse SSI directives in files with the execute bit set | |||
| xml2EncAlias charset alias [alias ...] | s | B | |
| Recognise Aliases for encoding values | |||
| xml2EncDefault name | svdh | B | |
| Sets a default encoding to assume when absolutely no information can be automatically detected | |||
| xml2StartParse element [element ...] | svdh | B | |
| Advise the parser to skip leading junk. | |||
Apache HTTP Server Version 2.4
| : | ̹(imagemap) ó |
|---|---|
| : | Base |
| : | imagemap_module |
| ҽ: | mod_imagemap.c |
imagemap CGI α Ͽ
.map óѴ. (AddHandler SetHandler Ͽ)
imap-file ڵ鷯 ϵ 丮
óѴ.
Ʒ þ .map ̹
Ϸ Ѵ.
AddHandler imap-file map
Ʒ Ѵ.
AddType application/x-httpd-imap map
츮 " Ư ǹ̰ ִ MIME type" Ϸ ϱ ̴.
̹ Ʒ ۼѴ.
directive value [x,y ...]
directive value "Menu text" [x,y
...]
directive value x,y ... "Menu text"
directive base, default,
poly, circle, rect,
point ϳ. value URL̳
URL Ȥ Ʒ Ư Ѵ. ǥ
x,y ̴. ǥ
̹ 鶧 ũ Ѵ.
'#' ϴ ̴ּ.
̹ Ͽ 6 þ ִ. þ Ư , ̹ Ͽ óѴ.
base þ<base href="value">
Ѵ. Ͽ URL URL ƴ϶
URL Ѵ. base þ
.htaccess ̳ Ͽ
ImapBase
Ѵ. ImapBase þ
ٸ ⺻ base
http://server_name/̴.
base_uri base . URL
.
default þpoly, circle,
rect þ ش ʰ point
þ ൿ Ѵ. ImapDefault ٸ
⺻ 204 No Content ڵ带 ȯϴ
nocontent̴. Ŭ̾Ʈ
Ѵ.poly þcirclerect þpoint þpoint þ ϰ ȿ
ǥ default
ʴ´.þ Ʒ value ִ.
URL̳ URL ִ. URL
'..' , base
ã´.
base Ҷ base Ѵ.
, base mailto: ִ.
mapImapMenu none
ƴ϶ .menumap .refererReferer: ٸ ⺻
http://servername/̴.nocontent204 No Content ڵ带 .
base þ ִ.error500 Server Error .
base þ ,
default ܿ .0,0 200,2000,0 ǥ Ͽٸ
ǥ ó Ѵ."Menu Text"value ڳ ǥ ڿ ֵǥ ִ. ڿ 鶧 ũ Ѵ.
<a href="http://foo.com/">Menu text</a>
ǥ ٸ ũ ũ Ѵ.
<a href="http://foo.com/">http://foo.com</a>
ֵǥ "
Ѵ.
#'formatted' 'semiformatted' ּ Ѵ.
# ּ html ± ִ. <hr>
base referer
poly map " ּ." 0,0 0,10 10,10 10,0
rect .. 0,0 77,27 " ִ 丮"
circle http://www.inetnebr.com/lincoln/feedback/ 195,0 305,27
rect another_file " 丮 ִ" 306,0 419,27
point http://www.zyzzyva.com/ 100,100
point http://www.tripod.com/ 200,200
rect mailto:nate@tripod.com 100,150 200,0 "?"
<a href="/maps/imagemap1.map">
<img ismap src="/images/imagemap1.gif">
</a>
<a href="/maps/imagemap1.map">
<img ismap="ismap" src="/images/imagemap1.gif" />
</a>
| : | ̹ Ͽ base ⺻ |
|---|---|
| : | ImapBase map|referer|URL |
| ⺻: | ImapBase http://servername/ |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_imagemap |
ImapBase þ ̹ Ͽ
base ⺻ Ѵ. ̹
ȿ base þ ϸ ⼭
Ѵ. ٸ, base ⺻
http://servername/̴.
| : | ̹ʿ ش ʴ ǥ ⺻ ൿ |
|---|---|
| : | ImapDefault error|nocontent|map|referer|URL |
| ⺻: | ImapDefault nocontent |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_imagemap |
ImapDefault þ ̹
Ͽ default ⺻ Ѵ.
̹ ȿ default þ ϸ
⼭ Ѵ. ٸ, default
ൿ Ŭ̾Ʈ 204 No Content
nocontent̴. Ŭ̾Ʈ
״ Ѵ.
| : | ǥ ̹ û ൿ |
|---|---|
| : | ImapMenu none|formatted|semiformatted|unformatted |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Indexes |
| : | Base |
| : | mod_imagemap |
ImapMenu þ ̹ Ͽ
ȿ ǥ ൿ Ѵ.
nonenone̸, ʰ
default ൿ Ѵ.formattedformatted .
̹ ּ Ѵ. ū ǥ
ϰ, ũ پ Ѵ. ϰǰ ϸ,
丮 ϰ ϴ.semiformattedsemiformatted ̹ Ͽ
ּ Ѵ. HTML ٲ ȯѴ.
ǥ , formatted
.unformattedApache HTTP Server Version 2.4
| : | ش |
|---|---|
| : | Extension |
| : | info_module |
| ҽ: | mod_info.c |
mod_info Ϸ httpd.conf
Ͽ ߰Ѵ.
<Location /server-info>
SetHandler server-info
</Location>
̷ ϸ
http://your.host.example.com/server-info
Ͽ ִ.
ѹ mod_info о̸, 丮
( , .htaccess)
Ͽ ڵ鷯 ִ.
Ʈ Ȱ ִ.
Ư ý , ڸ/ȣ, ͺ̽ ̸ ġ þ ΰ ִ. ؾ ϸ ȯ濡 ؾ Ѵ.
mod_authz_host Ͽ
ִ.
<Location /server-info>
SetHandler server-info
Order allow,deny
# ڽ 㰡
Allow from 127.0.0.1
# ߰, ó ִ ũ̼ 㰡
Allow from 192.168.1.17
</Location>
⺻ ϴ ϰ ⺰ ϴ þ , (hook), þ ִ.
server-info û ǹڿ ٿ
ٸ ִ. ,
http://your.host.example.com/server-info?config
þ ش.
?<module-name>?config?hooks?list?servermod_info ʰ
̹ о Ͽ ش.
Ľϴ Ѱ谡 ִ.
ServerRoot, LoadModule, LoadFile þ
شѴ.Include, <IfModule>, <IfDefine>
ü ϴ þ Ѵ.
ȿ ִ þ ش..htaccess
Ͽ ִ þ Ѵ.<Directory>
þ ,
mod_info ġ </Directory> ٹȣ
.mod_perl ڰ
þ ִ.| : | ߰ server-info ڵ鷯 ֵ ߰Ѵ |
|---|---|
| : | AddModuleInfo module-name string |
| : | ּ, ȣƮ |
| : | Extension |
| : | mod_info |
| : | ġ 1.3 |
module-name ߰ string HTML ش. ,
AddModuleInfo mod_deflate.c 'See <a \
href="http://www.apache.org/docs/2.4/mod/mod_deflate.html">\
http://www.apache.org/docs/docs/2.4/mod/mod_deflate.html</a>'
Apache HTTP サーバ バージョン 2.4
| 説明: | サーバがパースする html ドキュメント (Server Side Includes) |
|---|---|
| ステータス: | Base |
| モジュール識別子: | include_module |
| ソースファイル: | mod_include.c |
| 互換性: | Apache 2.0 から出力フィルタとして実装されました。 |
このモジュールはファイルがクライアントに送られる前に処理するフィルタを 提供します。処理の内容は要素と呼ばれる特別な形式の SGML コメントにより 制御されます。これらの要素は条件分岐や、他のファイルや プログラムの出力の取り込み、環境変数の設定や表示を行なうことが できます。
SSIEndTag SSIErrorMsg SSIETag SSILastModified SSILegacyExprParser SSIStartTag SSITimeFormat SSIUndefinedEcho XBitHackServer Side Includes は INCLUDES
フィルタ により実装されています。
Server-side include のディレクティブを含むドキュメントの拡張子が
.shtml の場合、以下のディレクティブでは Apache がそれらを
パースして、その結果できるドキュメントに text/html の
MIME タイプを割り当てます:
AddType text/html .shtml
AddOutputFilter INCLUDES .shtml
以下のディレクティブは shtml ファイルのあるディレクトリで指定されている
必要があります (通常は <Directory> セクションで指定しますが、
AllowOverride Options
が設定されていると、.htaccess ファイルに書くこともできます):
Options +Includes
互換性を保つために、server-parsed
ハンドラ も INCLUDES フィルタを
有効にします。MIME タイプ text/x-server-parsed-html や
text/x-server-parsed-html3 のドキュメントに対しても
Apache は INCLUDES フィルタを有効にします (出力されるものは
MIME タイプ text/html になります)。
詳しい情報は Tutorial on Server Side Includes.
SSI で処理されるファイルはデフォルトでは PATH_INFO
(後続のパス名情報)
付きのリクエストを受け入れなくなりました。AcceptPathInfo ディレクティブで
PATH_INFO 付きのリクエストを受け入れるようにサーバを
設定できます。
ドキュメントは、SGML のコメントとして特別なコマンドが埋め込まれた HTML ドキュメントとしてパースされます。コマンドの構文は次のように なっています:
<!--#element attribute=value
attribute=value ... -->
値 (訳注: value) は二重引用符で囲むのが一般的ですが、
シングルクオート (') とバッククオート (`) も使用できます。
多くのコマンドは属性-値 (訳注: attribute-value) の組を一つだけ指定できます。
コメントの終わり (-->)
の前には、SSI の句の一部だと解釈されないようにするために空白を
入れてください。最初の <!--# はまとめて一つの
句で、空白をふくんではいけないこと注意してください。
要素 (訳注: element) を以下の表に示します。
| 要素 | 説明 |
|---|---|
config |
configure output formats |
echo |
print variables |
exec |
execute external programs |
fsize |
print size of a file |
flastmod |
print last modification time of a file |
include |
include a file |
printenv |
print all available variables |
set |
set a value of a variable |
SSI 要素は mod_include 以外のモジュールで
定義されることもあります。実際、
exec 要素は
mod_cgi で提供されていて、このモジュールが
ロードされる場合にのみ利用可能となります。
次のコマンドは解析の様々な側面を制御します。属性は次の通りです。
echomsg (Apache 2.1 以降)echo
要素が未定義の変数をエコーしようとした際に、
クライアントに送られるメッセージになります。
SSIUndefinedEcho
ディレクティブを上書きします。errmsgSSIErrorMsg
ディレクティブを上書きします。sizefmtbytesか、Kb や Mb を優先的に使用する
abbrec (例えば 1024 バイトは "1K" と表示されます)
です。timefmtstrftime(3) ライブラリルーチンが
日時をプリントする際に用いられます。このコマンドは以下で定義されている include
変数 を表示します。変数が設定されていない場合は SSIUndefinedEcho ディレクティブで
決定される結果となります。日付はその時点での timefmt に従って
表示されます。属性は次の通りです。
varencoding変数を出力する前に、変数中の特別文字をどのようにエンコードするかを
指定します。none に設定されていると、エンコードは行なわれません。
url に設定されていると、URL エンコード (%-エンコードとも
呼ばれています。これはリンク等の URL の使用に適切です) が
行なわれます。echo 要素の開始時は、デフォルトは
entity に設定されています。これはエンティティエンコード
(段落やテキストなどのブロックレベルの HTML エレメントのコンテキストに
適しています) を行ないます。これは encoding 属性
を加えることで変更できます。変更は次の encoding 属性か、
要素の終了まで効力を持ちます。
encoding 属性はエンコードの変更をしたい var
の前に ある必要があることに注意してください。
また、ISO-8859-1 エンコーディングで
定義されている特別な文字だけがエンコードされます。
別の文字のエンコーディングの場合は、このエンコーディングは
望みの結果にならないかもしれません。
exec コマンドは指定されたシェルコマンドや CGI スクリプトを
実行します。mod_cgi がサーバに組み込まれているいなければ
なりません。Option
IncludesNOEXEC はこのコマンドを無効にします。
使用可能な属性は次の通りです。
cgi値は (%-エンコードされた) URL を指定します。パスが
スラッシュ (/) で始まらないときは、ドキュメントからの
相対パスとして扱われます。このパスで参照されているドキュメントは
サーバが CGI スクリプトとして扱っていなくても CGI スクリプトとして
起動されます。ただし、スクリプトのあるディレクトリでは
(ScriptAlias
や Option ExecCGI
によって) CGI スクリプトの使用が許可されている必要があります。
CGI スクリプトには、クライアントからの元々のリクエストの
PATH_INFO とクエリー文字列 (QUERY_STRING) が渡されます。
これらは URL パスとして特定できないものです。
スクリプトは標準 CGI 環境に加えて、include 変数を
使用することができます。
<!--#exec cgi="/cgi-bin/example.cgi" -->
スクリプトが、出力の代わりに Location: ヘッダを返すと、
HTML のアンカー (訳注: リンク) に変換されます。
exec cgi よりも、
include virtual
の方を使うようにしてください。特に、CGI への追加の引数を
クエリー文字列を使って渡すことは exec cgi は
できませんが、include virtual は以下のようにして
可能です。
<!--#include virtual="/cgi-bin/example.cgi?argument=value" -->
cmdサーバは指定された文字列を /bin/sh を使って
実行します。コマンドは通常の CGI 変数に加えて include 変数も使うことができます。
ほとんどの場合、#include
virtual を使う方が #exec cgi や #exec
cmd を使うよりも良いです。前者 (#include virtual)
は標準の Apache のサブリクエスト機構を使ってファイルやスクリプトの
出力を取り込みます。
こちらの方がよくテストされメンテナンスされた方法です。
さらに、Win32 のようないくつかのプラットフォームや、suexec を使っている unix では、
exec ディレクティブのコマンドに
引数を渡したり、コマンドに空白を入れることはできません。
ですから、以下のものは unix の suexec でない設定では動作しますが、
Win32 や suexec を使っている unix では期待した結果にはなりません:
<!--#exec cmd="perl /path/to/perlscript arg1 arg2" -->
このコマンドは指定されたファイルの大きさを sizefmt の
書式指定に基づいて出力します。属性は次の通りです。
filevirtualこのコマンドは指定されたファイルの最終修正時刻を
timefmt 書式指定に従って表示します。
指定可能な属性は fsize コマンドと同じです。
このコマンドは別の文書やファイルのテキストを解析しているファイルに
挿入します。挿入されるファイルはアクセス制御の管理下にあります。
解析しているファイルの存在するディレクトリに
Option IncludesNOEXEC
が設定されている場合、text MIME タイプ
(text/plain, text/html 等)
のドキュメントのみインクルードが行なわれます。
その他の場合は、クエリー文字列も含め、コマンドで指定された
完全な URL を使って普通に CGI スクリプトが呼び出されます。
属性が文書の位置を指定します。include コマンドに与えられたそれぞれの 属性に対して挿入作業が行なわれます。有効な属性は次の通りです。
file../ を含んでいたり、絶対パスを指定したりはできません。
ですから、ドキュメントルートの外にあるファイルや、ディレクトリ構造で
上位にあるファイルを挿入することはできません。
常にこの属性よりは、virtual 属性を使うようにしてください。
virtual値は解析されているドキュメントからの (% エンコードされた) URL です。URL にはスキームやホスト名を含めることはできません。パスと、 もしあればクエリー文字列を指定できるだけです。スラッシュ (/) から 始まらない場合は、ドキュメントからの相対パスとして扱われます。
URL は属性から作られ、その URL をクライアントがアクセスしたときに 出力される内容が解析後の出力に含められます。ですから、挿入される ファイルは入れ子構造にすることができます。
指定された URL が CGI プログラムであった場合は、 プログラムが実行され、その出力が解析しているファイル中の ディレクティブがあった位置に挿入されます。CGI の url に クエリー URL を入れることもできます。
<!--#include virtual="/cgi-bin/example.cgi?argument=value" -->
HTML ドキュメントに CGI プログラムの出力を含める方法としては、
include virtual の方が exec cgi よりも
好ましい方法です。
KeptBodySize
ディレクティブが設定されていて、かつ、この対象ファイルが
(訳注: POST リクエストを)受け入れできるなら、
POST リクエストを受け取ってサブリクエストを発行する際にも
POST リクエストが渡されます。
このディレクティブが設定されていない場合は、
サブリクエストは GET リクエストとして処理されます。
これは、存在するすべての変数とその値を表示します。Apache 1.3.12 から、
特別な文字は出力される前にエンティティエンコード (詳細は echo 要素を参照)
されるようになりました。属性はありません。
<!--#printenv -->
これは変数の値を設定します。属性は次の通りです。
varvalue
<!--#set var="category" value="help" -->
標準 CGI 環境の変数に加えて、echo コマンドや、
if や elif, それにドキュメントから呼び出される
すべてのプログラムから使用できる変数があります。
DATE_GMTDATE_LOCALDOCUMENT_NAMEDOCUMENT_URILAST_MODIFIEDQUERY_STRING_UNESCAPED&
といった特殊文字にはバックスラッシュが直前に置かれます)。変数置換はたいていの場合 SSI ディレクティブの引数として妥当な場所にある
引用符で囲まれた文字列中で行なわれます。これに該当するものには、
config,
exec, flastmod, fsize,
include, echo, set の
各ディレクティブと、条件分岐用のオペレータへの引数があります。
ドル記号はバックスラッシュを使うことで使うことができます:
<!--#if expr="$a = \$test" -->
変数名としてみなされる文字列の中で変数への参照を置換する必要があるときは、 シェルでの変数置換のように、中括弧で括ることで区別することができます:
<!--#set var="Zed" value="${REMOTE_HOST}_${REQUEST_METHOD}" -->
この例では、REMOTE_HOST が
"X" で REQUEST_METHOD が
"Y" のときに変数 Zed を "X_Y"
に設定します。
以下の例では、DOCUMENT_URI が /foo/file.html
のときに "in foo" を、/bar/file.html のときに "in bar" を、
どちらでもないときには "in neither" を表示します。
<!--#if expr='"$DOCUMENT_URI" = "/foo/file.html"' -->
in foo
<!--#elif expr='"$DOCUMENT_URI" = "/bar/file.html"' -->
in bar
<!--#else -->
in neither
<!--#endif -->
基本的なフローコントロール要素は次の通りです。
<!--#if expr="test_condition" -->
<!--#elif expr="test_condition" -->
<!--#else -->
<!--#endif -->
if 要素はプログラミング言語の
if 文と同じように動作します。条件が評価され、結果が真であれば次の
elif か else か endif
要素までの文字列が出力に挿入されます。
elif や else 文は test_condition
が偽のときにテキストを出力に挿入するために使われます。
これらの要素はあってもなくても構いません。
endif 要素は if
要素を終了させます。この要素は必須です。
test_condition は以下のどれかです:
string-A string(訳注: httpd の)設定を検査して、
文字列で指定した URL にアクセスできる場合 true で、
そうでなければ false になります。
SSIAccessEnable が有効のときにのみ
この検査は行われます。
承認されていないユーザからは隠しておきたい URL についての情報、
たとえば URL へのリンクなどがある場合に、便利です。
検査では URL へアクセスできるかの権限のみが行われ、URL
が存在するかどうかについては検査されないことに注意してください。
<!--#if expr="-A /private" -->
Click <a href="/private">here</a> to access private
information.
<!--#endif -->
string1 = string2
string1 == string2
string1 != string2string1 と string2 を比較します。
string2 が /string/
という形式であれば、正規表現として比較されます。正規表現は
PCRE エンジンで実装されていて、
perl 5 と同じ構文を使用します。
== は単に = の別名で、まったく同じ動作を
します。
正のマッチング (= または ==) の場合は、
正規表現でグループ分けされたパーツをキャプチャすることができます。
キャプチャされた部分は特殊変数 $1 .. $9
に格納されます。
<!--#if expr="$QUERY_STRING = /^sid=([a-zA-Z0-9]+)/" -->
<!--#set var="session" value="$1" -->
<!--#endif -->
string1 < string2
string1 <= string2
string1 > string2
string1 >= string2strcmp(3) を使用)
ことに注意してください。ですから、文字列 "100" は "20"
よりも小さいことになります。( test_condition )! test_conditiontest_condition1 &&
test_condition2test_condition1 ||
test_condition2"=" と "!=" の方が "&&" より きつく束縛します。"!" の束縛が一番きつくなっています。 ですから以下の二つは等価です:
<!--#if expr="$a = test1 && $b = test2" -->
<!--#if expr="($a = test1) && ($b = test2)" -->
真偽値オペレータ && と ||
は同じ優先度です。
これらのオペレータで一方により強い優先度をつけたい場合には、
括弧を使う必要があります。
変数やオペレータとして認識されないものはすべて文字列として
扱われます。文字列は引用符で囲むこともできます: 'string'
のように。引用符で囲まれていない文字列には空白 (スペースとタブ)
を含めることはできません。それらは変数などの句を分離するために
使われているからです。複数の文字列が続いているときは、
空白を間に入れて一つにくっつけられます。ですから、
string1 string2 は string1 string2 になります。
また、
'string1 string2' は string1 string2
になります。
式がもっと複雑になり、処理の速度低下が顕著になった場合は、 評価ルールに従って最適化してみると良いでしょう。
&& と ||)
は、出来る限り短絡評価されます。つまり結果として上記のルールは、
mod_include が左の評価式を評価します。
左側で結果を十分決定できる場合は、評価はそこで停止します。
そうでない場合は右側を評価して、左と右の両方から結果を計算します。$1 .. $9)
を埋めるために、実際に評価する必要があるからです。特定の式がどのように扱われるかを知りたい場合は、
-DDEBUG_INCLUDE コンパイラオプションを付けて
mod_include をリコンパイルすると良いでしょう。
これにより、全てのパースされた式に対して、字句解析情報、
パースツリーと、
それがどのようにクライアントに送られた出力まで評価されたかを
挿入します。
正規表現内でデリミタとして扱いたくない / があれば、それらは全て エスケープしなければなりません。 正規表現の意味がどうであろうとエスケープは必要です。
| 説明: | include 要素を終了させる文字列 |
|---|---|
| 構文: | SSIEndTag tag |
| デフォルト: | SSIEndTag "-->" |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_include |
| 互換性: | 2.0.30 以降で利用可能 |
このディレクティブは mod_include が探す、
include 要素の終了を示す文字列を変更します。
SSIEndTag "%>"
| 説明: | SSI のエラーがあったときに表示されるエラーメッセージ |
|---|---|
| 構文: | SSIErrorMsg message |
| デフォルト: | SSIErrorMsg "[an error occurred while processing this
directive]" |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Base |
| モジュール: | mod_include |
| 互換性: | バージョン 2.0.30 以降で使用可能 |
SSIErrorMsg ディレクティブは mod_include
がエラーが起こったときに表示するメッセージを変更します。プロダクションサーバでは
メッセージがユーザに表示されないようにするために
デフォルトエラーメッセージを "<!-- Error -->"
に変えるというようなことを考えるかもしれません。
このディレクティブは <!--#config
errmsg=message --> 要素と同じ効果になります。
SSIErrorMsg "<!-- Error -->"
| 説明: | Controls whether ETags are generated by the server. |
|---|---|
| 構文: | SSIETag on|off |
| デフォルト: | SSIETag off |
| コンテキスト: | ディレクトリ, .htaccess |
| ステータス: | Base |
| モジュール: | mod_include |
| 互換性: | Available in version 2.2.15 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Controls whether Last-Modified headers are generated by the
server. |
|---|---|
| 構文: | SSILastModified on|off |
| デフォルト: | SSILastModified off |
| コンテキスト: | ディレクトリ, .htaccess |
| ステータス: | Base |
| モジュール: | mod_include |
| 互換性: | Available in version 2.2.15 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Enable compatibility mode for conditional expressions. |
|---|---|
| 構文: | SSILegacyExprParser on|off |
| デフォルト: | SSILegacyExprParser off |
| コンテキスト: | ディレクトリ, .htaccess |
| ステータス: | Base |
| モジュール: | mod_include |
| 互換性: | Available in version 2.3.13 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | include 要素を開始する文字列 |
|---|---|
| 構文: | SSIStartTag tag |
| デフォルト: | SSIStartTag "<!--#" |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_include |
| 互換性: | バージョン 2.0.30 以降で使用可能 |
このディレクティブは mod_include が探す、include
要素の開始を示す文字列を変更します。
二つのサーバで (もしかすると別々の段階で) ファイルの出力を解析していて、 それぞれに違うコマンドを処理させたい、 というようなときにこのオプションを使います。
SSIStartTag "<%"
SSIEndTag "%>"
上の例のように対応する
SSIEndTag を併せて使うと、
下に示す例のように SSI ディレクティブを使えます:
<%printenv %>
| 説明: | 日付けを現す文字列の書式を設定する |
|---|---|
| 構文: | SSITimeFormat formatstring |
| デフォルト: | SSITimeFormat "%A, %d-%b-%Y %H:%M:%S %Z" |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Base |
| モジュール: | mod_include |
| 互換性: | 2.0.30 以降で使用可能 |
このディレクティブは DATE 環境変数を echo して日付を現す文字列が
表示されるときの書式を変更します。formatstring は
C 標準ライブラリの strftime(3) と同じ形式です。
このディレクティブは <!--#config
timefmt=formatstring --> 要素と同じ効果になります。
SSITimeFormat "%R, %B %d, %Y"
上のディレクティブでは、日付は "22:26, June 14, 2002" という 形式で表示されます。
| 説明: | 未定義の変数が echo されたときに表示される文字列 |
|---|---|
| 構文: | SSIUndefinedEcho string |
| デフォルト: | SSIUndefinedEcho "(none)" |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | All |
| ステータス: | Base |
| モジュール: | mod_include |
| 互換性: | 2.0.34 以降で利用可能 |
このディレクティブは変数が定義されていないにも関わらず
"echo" されたときに mod_include
が表示する文字列を変更します。
SSIUndefinedEcho "<!-- undef -->"
| 説明: | 実行ビットが設定されたファイルの SSI ディレクティブを 解析する |
|---|---|
| 構文: | XBitHack on|off|full |
| デフォルト: | XBitHack off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Options |
| ステータス: | Base |
| モジュール: | mod_include |
XBitHack ディレクティブは通常の HTML
ドキュメントの解析を制御します。このディレクティブは MIME タイプ
text/html と関連付けられているファイルにのみ影響します。
XBitHack は以下の値をとることができます。
offontext/html
ファイルは全てサーバで解析する html ドキュメントとして扱われます。fullon と同様ですが、グループ実行ビットもテストします。
もしそれが設定されていれば、返されるファイルの Last-modified の
日付をファイルの最終修正時刻にします。それが設定されていないときは、
last-modified の日付は送られません。このビットを設定すると、
クライアントやプロキシがリクエストをキャッシュできるようになります。
#include
するかもしれないものや、各アクセスに対して違う出力を生成する
(もしくは後のリクエストで変わるかもしれないもの)
すべての SSI スクリプトに対してグループ実行ビットが
設定されていないことを確認できない場合は、full は使わない方が良い
でしょう。Apache HTTP Server Version 2.4
| : | Windows ġ ISAPI Extension |
|---|---|
| : | Base |
| : | isapi_module |
| ҽ: | mod_isapi.c |
| : | Win32 only |
Internet Server extension API Ѵ. Windows ġ Internet Server extension (, ISAPI .dll ) ִ.
ISAPI extension (.dll ) ڰ ۼѴ. Apache Group ̵ ʾ, ʴ´. ISAPI extension 뿡 ISAPI ڿ ϱ ٶ. ̷ ġ ϸƮ ø .
ISAPIAppendLogToErrors ISAPIAppendLogToQuery ISAPICacheFile ISAPIFakeAsync ISAPILogNotSupported ISAPIReadAheadBufferϿ AddHandler þ Ͽ
ISAPI Ȯڿ isapi-handler ڵ鷯 Ѵ.
.dll ISAPI extension óϷ httpd.conf Ͽ
߰Ѵ.
AddHandler isapi-handler .dll
ġ û . httpd.conf Ư ̸ о ִ.
ISAPICacheFile c:/WebWork/Scripts/ISAPI/mytest.dll
ISAPI extension ̸ о̴ ̸ о ʴ
ISAPI extension CGI ũƮ Ѱ
. , ISAPI .dll ִ 丮 Options ExecCGI
ʿϴ.
ġ ISAPI ¿ "ũμƮ
Ư" Ȯ ISAPI 2.0 Ծ Ѵ.
ġ δ ISAPI ִ
. ISA °
ʴ Ϸ Ѵٸ, 뿡 ֱ
α . αװ ſ Ŀ ֱ
ISAPILogNotSupported Off þ ϸ
α ʴ´.
Microsoft IIS ISAPI extension
о鿩 뷮 ſ ʰų Ư
ʴ ״ д. ġ ISAPICacheFile þ
ʴ´ٸ û ISAPI extension о̰
. ȿ, ġ ̰
ȿ ̴. ISAPI ġ ణ
ȣȯ ȸ±
.
, ġ ISAPI Extension , ISAPI Filter ϶. ߿ , ȹ .
ġ 2.0 mod_isapi αѴٸ,
ServerSupportFunction ȣ þ
ؾ Ѵ.
HSE_REQ_SEND_URL_REDIRECT_RESPhttp://server/location).HSE_REQ_SEND_URL/location ).ֱ Microsoft HSE_REQ_SEND_URL
ɰ ̸ ó δ. ġ
ƱԸƮ ǰ ൿ ٸ ó ̴.
HSE_REQ_SEND_RESPONSE_HEADERHSE_REQ_DONE_WITH_SESSIONHSE_REQ_MAP_URL_TO_PATHHSE_APPEND_LOG_PARAMETERCustomLog
þ \"%{isapi-parameter}n\" ISAPIAppendLogToQuery
On þ Ͽ %q
α ISAPIAppendLogToErrors
On þ Ͽ αù° %{isapi-parameter}n
Ѵ.
HSE_REQ_IS_KEEP_CONNHSE_REQ_SEND_RESPONSE_HEADER_EXfKeepConn ɼ ϴ ϰ
µ Ѵ.HSE_REQ_IS_CONNECTED ʴ ServerSupportFunction ȣ
ϸ ġ FALSE ȯϰ
GetLastError
ERROR_INVALID_PARAMETER Ѵ.
ReadClient (ISAPIReadAheadBuffer )
ʱũ⸦ Ѿ û ´.
ISAPIReadAheadBuffer (ISAPI
ڵ鷯 θ Ʈ) ª û extension
θ ȴ. û , ISAPI extension
ReadClient û ; Ѵ.
WriteClient ,
HSE_IO_SYNC ɼǸ ϰų (0
) ƹ ɼǵ ʾƾ Ѵ. ٸ
WriteClient û FALSE ȯϸ
ϰ, GetLastError
ERROR_INVALID_PARAMETER ȴ.
GetServerVariable , (ٸ
ϴ) Ȯ .
GetServerVariable Ϲ ġ
CGI ȯ溯 ALL_HTTP, ALL_RAW
ִ.
ġ 2.0 mod_isapi ISAPI Ծ
߰ ϰ, °
TransmitFile 䳻. , ISAPI
.dll ̸ о鿩 ̴ ġ 1.3
mod_isapi Ѵ.
| : | ISAPI exntension HSE_APPEND_LOG_PARAMETER
û α Ѵ |
|---|---|
| : | ISAPIAppendLogToErrors on|off |
| ⺻: | ISAPIAppendLogToErrors off |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_isapi |
ISAPI exntension HSE_APPEND_LOG_PARAMETER
û α Ѵ.
| : | ISAPI exntension HSE_APPEND_LOG_PARAMETER
û ǹڿ Ѵ |
|---|---|
| : | ISAPIAppendLogToQuery on|off |
| ⺻: | ISAPIAppendLogToQuery on |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_isapi |
ISAPI exntension HSE_APPEND_LOG_PARAMETER
û ǹڿ Ѵ (CustomLog %q
δ).
| : | Ҷ о ISAPI .dll ϵ |
|---|---|
| : | ISAPICacheFile file-path [file-path]
... |
| : | ּ, ȣƮ |
| : | Base |
| : | mod_isapi |
ġ Ҷ о鿩 Ҷ
ϸ Ͽ Ѵ.
þ ISAPI .dll Ϻ ִ.
ü θ ´. ΰ ƴϸ ServerRoot η Ƶδ.
| : | ISAPI ݹ ϴ ôѴ |
|---|---|
| : | ISAPIFakeAsync on|off |
| ⺻: | ISAPIFakeAsync off |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_isapi |
on ϸ ISAPI ݹ 䳻.
| : | ISAPI extension ʴ ûϸ α Ѵ |
|---|---|
| : | ISAPILogNotSupported on|off |
| ⺻: | ISAPILogNotSupported off |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_isapi |
ISAPI extension ʴ ûϸ α Ѵ. ߿ ڰ ϴµ ȴ. ϴ ISAPI ϸ ٽ off ǵ Ѵ.
| : | ISAPI extension ̸б(read ahead buffer) ũ |
|---|---|
| : | ISAPIReadAheadBuffer size |
| ⺻: | ISAPIReadAheadBuffer 49152 |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_isapi |
ISAPI extension ó ȣҶ ̸б ִ ũ⸦
Ѵ. ( ũ⺸ ū) ڷ ReadClient
ݹ Ͽ о Ѵ. ISAPI extension
ReadClient ʴ´.
ISAPI extension ڿ ϶.
Apache HTTP Sunucusu Sürüm 2.4
Bu hızlı yönerge kılavuzunda Apache yapılandırma yönergelerinin kullanımı, öntanımlı değerleri, durumu ve bağlamı gösterilmiştir. Bunların her biri hakkında ayrıntılı bilgi almak için Yönerge Sözlüğüne bakınız.
İlk sütunda yönergenin ismi ve kullanımı belirtilmiştir. İkinci sütunda yönergenin varsa öntanımlı değeri gösterilmiştir. Eğer öntanımlı değer sütuna sığmayacak kadar uzunsa sığmayan kısmı kırpılıp yerine “+” imi konmuştur.
Aşağıda sağdaki gösterge tablolarına uygun olarak, üçüncü sütunda yönergenin kullanımına izin verilen bağlamlar, dördüncü sütunda ise yönergenin durumu gösterilmiştir.
| A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X |
|
|
AcceptFilter protocol kabul_süzgeci | s | Ç | |
| Bir protokolün dinleyici soketleri için en iyilemeleri ayarlar | |||
| AcceptPathInfo On|Off|Default | Default | skdh | Ç |
| Dosya isminden sonra belirtilen yol verisini kabul veya reddeder. | |||
AccessFileName filename [filename] ... | .htaccess | sk | Ç |
| Dağıtık yapılandırma dosyasının ismi belirtilir. | |||
| Action action-type cgi-script [virtual] | skdh | T | |
| Activates a CGI script for a particular handler or content-type | |||
| AddAlt metin dosya [dosya] ... | skdh | T | |
| Dosyaya göre seçilen simgenin yerinde gösterilecek metni belirler. | |||
| AddAltByEncoding metin MIME-kodlaması [MIME-kodlaması] ... | skdh | T | |
| Dosyanın MIME kodlamasına göre seçilen simgenin yerinde gösterilecek metni belirler. | |||
| AddAltByType metin MIME-türü [MIME-türü] ... | skdh | T | |
| Dosyanın MIME türüne göre seçilen simgenin yerinde gösterilecek metni belirler. | |||
| AddCharset charset extension [extension] ... | skdh | T | |
| Maps the given filename extensions to the specified content charset | |||
AddDefaultCharset On|Off|karküm | Off | skdh | Ç |
Bir yanıtın içerik türü text/plain veya
text/html olduğunda eklenecek öntanımlı karakter kümesi
parametresini belirler. | |||
| AddDescription metin dosya [dosya] ... | skdh | T | |
| Bir dosya için gösterilecek açıklama belirtilir. | |||
| AddEncoding encoding extension [extension] ... | skdh | T | |
| Maps the given filename extensions to the specified encoding type | |||
| AddHandler handler-name extension [extension] ... | skdh | T | |
| Maps the filename extensions to the specified handler | |||
| AddIcon simge isim [isim] ... | skdh | T | |
| Bir dosya için gösterilecek simgeyi dosya adına göre belirler. | |||
| AddIconByEncoding simge MIME-kodlaması [MIME-kodlaması] ... | skdh | T | |
| Bir dosya için gösterilecek simgeyi dosyanın MIME kodlamasına göre belirler. | |||
| AddIconByType simge MIME-türü [MIME-türü] ... | skdh | T | |
| Bir dosya için gösterilecek simgeyi dosyanın MIME türüne göre belirler. | |||
| AddInputFilter filter[;filter...] extension [extension] ... | skdh | T | |
| Maps filename extensions to the filters that will process client requests | |||
| AddLanguage language-tag extension [extension] ... | skdh | T | |
| Maps the given filename extension to the specified content language | |||
| AddModuleInfo module-name string | sk | E | |
| Adds additional information to the module information displayed by the server-info handler | |||
| AddOutputFilter filter[;filter...] extension [extension] ... | skdh | T | |
| Maps filename extensions to the filters that will process responses from the server | |||
| AddOutputFilterByType filter[;filter...] media-type [media-type] ... | skdh | T | |
| assigns an output filter to a particular media-type | |||
| AddType media-type extension [extension] ... | skdh | T | |
| Maps the given filename extensions onto the specified content type | |||
| Alias [URL-yolu] dosya-yolu | dizin-yolu | skd | T | |
| URL’leri dosya sistemi konumlarıyla eşler. | |||
| AliasMatch "düzenli-ifade" "dosya-yolu|dizin-yolu" | sk | T | |
| URL’leri dosya sistemi konumlarıyla düzenli ifadeleri kullanarak eşler. | |||
| AliasPreservePath OFF|ON | OFF | skd | T |
| Map the full path after the alias in a location. | |||
| Allow from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts can access an area of the server | |||
| AllowCONNECT port[-port] [port[-port]] ... | 443 563 | sk | E |
Ports that are allowed to CONNECT through the
proxy | |||
| AllowEncodedSlashes On|Off|NoDecode | Off | sk | Ç |
| Kodlanmış dosya yolu ayracı içeren URL’lere izin verilip verilmeyeceğini belirler. | |||
| AllowMethods reset|HTTP-method [HTTP-method]... | reset | d | D |
| Restrict access to the listed HTTP methods | |||
AllowOverride All|None|yönerge-türü
[yönerge-türü] ... | None (2.3.9 ve sonr + | d | Ç |
.htaccess dosyalarında bulunmasına izin verilen
yönerge türleri belirtilir. | |||
AllowOverrideList None|yönerge
[yönerge-türü] ... | None | d | Ç |
.htaccess dosyalarında izin verilecek yönergeler tek tek belirtilir | |||
| Anonymous user [user] ... | dh | E | |
| Specifies userIDs that are allowed access without password verification | |||
| Anonymous_LogEmail On|Off | On | dh | E |
| Sets whether the password entered will be logged in the error log | |||
| Anonymous_MustGiveEmail On|Off | On | dh | E |
| Specifies whether blank passwords are allowed | |||
| Anonymous_NoUserID On|Off | Off | dh | E |
| Sets whether the userID field may be empty | |||
| Anonymous_VerifyEmail On|Off | Off | dh | E |
| Sets whether to check the password field for a correctly formatted email address | |||
| AsyncRequestWorkerFactor factor | s | M | |
| Limit concurrent connections per process | |||
| AuthBasicAuthoritative On|Off | On | dh | T |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthBasicFake off|username [password] | dh | T | |
| Fake basic authentication using the given expressions for username and password | |||
| AuthBasicProvider provider-name [provider-name] ... | file | dh | T |
| Sets the authentication provider(s) for this location | |||
| AuthBasicUseDigestAlgorithm MD5|Off | Off | dh | T |
| Check passwords against the authentication providers as if Digest Authentication was in force instead of Basic Authentication. | |||
| AuthDBDUserPWQuery query | d | E | |
| SQL query to look up a password for a user | |||
| AuthDBDUserRealmQuery query | d | E | |
| SQL query to look up a password hash for a user and realm. | |||
| AuthDBMGroupFile file-path | dh | E | |
| Sets the name of the database file containing the list of user groups for authorization | |||
| AuthDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Sets the type of database file that is used to store passwords | |||
| AuthDBMUserFile file-path | dh | E | |
| Sets the name of a database file containing the list of users and passwords for authentication | |||
| AuthDigestAlgorithm MD5|MD5-sess | MD5 | dh | E |
| Selects the algorithm used to calculate the challenge and response hashes in digest authentication | |||
| AuthDigestDomain URI [URI] ... | dh | E | |
| URIs that are in the same protection space for digest authentication | |||
| AuthDigestNonceLifetime seconds | 300 | dh | E |
| How long the server nonce is valid | |||
| AuthDigestProvider provider-name [provider-name] ... | file | dh | E |
| Sets the authentication provider(s) for this location | |||
| AuthDigestQop none|auth|auth-int [auth|auth-int] | auth | dh | E |
| Determines the quality-of-protection to use in digest authentication | |||
| AuthDigestShmemSize size | 1000 | s | E |
| The amount of shared memory to allocate for keeping track of clients | |||
| AuthFormAuthoritative On|Off | On | dh | T |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthFormBody fieldname | httpd_body | d | T |
| The name of a form field carrying the body of the request to attempt on successful login | |||
| AuthFormDisableNoStore On|Off | Off | d | T |
| Disable the CacheControl no-store header on the login page | |||
| AuthFormFakeBasicAuth On|Off | Off | d | T |
| Fake a Basic Authentication header | |||
| AuthFormLocation fieldname | httpd_location | d | T |
| The name of a form field carrying a URL to redirect to on successful login | |||
| AuthFormLoginRequiredLocation url | d | T | |
| The URL of the page to be redirected to should login be required | |||
| AuthFormLoginSuccessLocation url | d | T | |
| The URL of the page to be redirected to should login be successful | |||
| AuthFormLogoutLocation uri | d | T | |
| The URL to redirect to after a user has logged out | |||
| AuthFormMethod fieldname | httpd_method | d | T |
| The name of a form field carrying the method of the request to attempt on successful login | |||
| AuthFormMimetype fieldname | httpd_mimetype | d | T |
| The name of a form field carrying the mimetype of the body of the request to attempt on successful login | |||
| AuthFormPassword fieldname | httpd_password | d | T |
| The name of a form field carrying the login password | |||
| AuthFormProvider provider-name [provider-name] ... | file | dh | T |
| Sets the authentication provider(s) for this location | |||
| AuthFormSitePassphrase secret | d | T | |
| Bypass authentication checks for high traffic sites | |||
| AuthFormSize size | 8192 | d | T |
| The largest size of the form in bytes that will be parsed for the login details | |||
| AuthFormUsername fieldname | httpd_username | d | T |
| The name of a form field carrying the login username | |||
| AuthGroupFile file-path | dh | T | |
| Sets the name of a text file containing the list of user groups for authorization | |||
| AuthLDAPAuthorizePrefix prefix | AUTHORIZE_ | dh | E |
| Specifies the prefix for environment variables set during authorization | |||
| AuthLDAPBindAuthoritative off|on | on | dh | E |
| Determines if other authentication providers are used when a user can be mapped to a DN but the server cannot successfully bind with the user's credentials. | |||
| AuthLDAPBindDN distinguished-name | dh | E | |
| Optional DN to use in binding to the LDAP server | |||
| AuthLDAPBindPassword password | dh | E | |
| Password used in conjunction with the bind DN | |||
| AuthLDAPCharsetConfig file-path | s | E | |
| Language to charset conversion configuration file | |||
| AuthLDAPCompareAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization comparisons | |||
| AuthLDAPCompareDNOnServer on|off | on | dh | E |
| Use the LDAP server to compare the DNs | |||
| AuthLDAPDereferenceAliases never|searching|finding|always | always | dh | E |
| When will the module de-reference aliases | |||
| AuthLDAPGroupAttribute attribute | member uniqueMember + | dh | E |
| LDAP attributes used to identify the user members of groups. | |||
| AuthLDAPGroupAttributeIsDN on|off | on | dh | E |
| Use the DN of the client username when checking for group membership | |||
| AuthLDAPInitialBindAsUser off|on | off | dh | E |
| Determines if the server does the initial DN lookup using the basic authentication users' own username, instead of anonymously or with hard-coded credentials for the server | |||
| AuthLDAPInitialBindPattern regex substitution | (.*) $1 (remote use + | dh | E |
| Specifies the transformation of the basic authentication username to be used when binding to the LDAP server to perform a DN lookup | |||
| AuthLDAPMaxSubGroupDepth Number | 10 | dh | E |
| Specifies the maximum sub-group nesting depth that will be evaluated before the user search is discontinued. | |||
| AuthLDAPRemoteUserAttribute uid | dh | E | |
| Use the value of the attribute returned during the user query to set the REMOTE_USER environment variable | |||
| AuthLDAPRemoteUserIsDN on|off | off | dh | E |
| Use the DN of the client username to set the REMOTE_USER environment variable | |||
| AuthLDAPSearchAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization searches | |||
| AuthLDAPSubGroupAttribute attribute | member uniqueMember + | dh | E |
| Specifies the attribute labels, one value per directive line, used to distinguish the members of the current group that are groups. | |||
| AuthLDAPSubGroupClass LdapObjectClass | groupOfNames groupO + | dh | E |
| Specifies which LDAP objectClass values identify directory objects that are groups during sub-group processing. | |||
| AuthLDAPURL url [NONE|SSL|TLS|STARTTLS] | dh | E | |
| URL specifying the LDAP search parameters | |||
| AuthMerging Off | And | Or | Off | dh | T |
| Controls the manner in which each configuration section's authorization logic is combined with that of preceding configuration sections. | |||
| AuthName auth-domain | dh | T | |
| Authorization realm for use in HTTP authentication | |||
| AuthnCacheContext directory|server|custom-string | directory | d | T |
| Specify a context string for use in the cache key | |||
| AuthnCacheEnable | s | T | |
| Enable Authn caching configured anywhere | |||
| AuthnCacheProvideFor authn-provider [...] | dh | T | |
| Specify which authn provider(s) to cache for | |||
| AuthnCacheSOCache provider-name[:provider-args] | s | T | |
| Select socache backend provider to use | |||
| AuthnCacheTimeout timeout (seconds) | 300 (5 minutes) | dh | T |
| Set a timeout for cache entries | |||
| <AuthnProviderAlias baseProvider Alias> ... </AuthnProviderAlias> | s | T | |
| Enclose a group of directives that represent an extension of a base authentication provider and referenced by the specified alias | |||
AuthnzFcgiCheckAuthnProvider provider-name|None
option ... | d | E | |
| Enables a FastCGI application to handle the check_authn authentication hook. | |||
| AuthnzFcgiDefineProvider type provider-name backend-address | s | E | |
| Defines a FastCGI application as a provider for authentication and/or authorization | |||
| AuthType None|Basic|Digest|Form | dh | T | |
| Type of user authentication | |||
| AuthUserFile file-path | dh | T | |
| Sets the name of a text file containing the list of users and passwords for authentication | |||
| AuthzDBDLoginToReferer On|Off | Off | d | E |
Determines whether to redirect the Client to the Referring
page on successful login or logout if a Referer request
header is present | |||
| AuthzDBDQuery query | d | E | |
| Specify the SQL Query for the required operation | |||
| AuthzDBDRedirectQuery query | d | E | |
| Specify a query to look up a login page for the user | |||
| AuthzDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Sets the type of database file that is used to store list of user groups | |||
| <AuthzProviderAlias baseProvider Alias Require-Parameters> ... </AuthzProviderAlias> | s | T | |
| Enclose a group of directives that represent an extension of a base authorization provider and referenced by the specified alias | |||
| AuthzSendForbiddenOnFailure On|Off | Off | dh | T |
| Send '403 FORBIDDEN' instead of '401 UNAUTHORIZED' if authentication succeeds but authorization fails | |||
| BalancerGrowth # | 5 | sk | E |
| Number of additional Balancers that can be added Post-configuration | |||
| BalancerInherit On|Off | On | sk | E |
| Inherit ProxyPassed Balancers/Workers from the main server | |||
| BalancerMember [balancerurl] url [key=value [key=value ...]] | d | E | |
| Add a member to a load balancing group | |||
| BalancerPersist On|Off | Off | sk | E |
| Attempt to persist changes made by the Balancer Manager across restarts. | |||
| BrotliAlterETag AddSuffix|NoChange|Remove | AddSuffix | sk | E |
| How the outgoing ETag header should be modified during compression | |||
| BrotliCompressionMaxInputBlock value | sk | E | |
| Maximum input block size | |||
| BrotliCompressionQuality value | 5 | sk | E |
| Compression quality | |||
| BrotliCompressionWindow value | 18 | sk | E |
| Brotli sliding compression window size | |||
| BrotliFilterNote [type] notename | sk | E | |
| Places the compression ratio in a note for logging | |||
| BrowserMatch düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ... | skdh | T | |
| Ortam değişkenlerini HTTP kullanıcı arayüzüne göre belirler. | |||
| BrowserMatchNoCase düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ... | skdh | T | |
| Ortam değişkenlerini HTTP kullanıcı arayüzünün harf büyüklüğüne duyarsız eşleşmelerine bağlı olarak belirler. | |||
| BufferedLogs On|Off | Off | s | T |
| Günlük girdilerini diske yazmadan önce bellekte tamponlar | |||
| BufferSize integer | 131072 | skdh | E |
| Maximum size in bytes to buffer by the buffer filter | |||
| CacheDefaultExpire seconds | 3600 (one hour) | skdh | E |
| The default duration to cache a document when no expiry date is specified. | |||
| CacheDetailHeader on|off | off | skdh | E |
| Add an X-Cache-Detail header to the response. | |||
| CacheDirLength length | 2 | sk | E |
| The number of characters in subdirectory names | |||
| CacheDirLevels levels | 2 | sk | E |
| The number of levels of subdirectories in the cache. | |||
| CacheDisable url-string | on | skdh | E | |
| Disable caching of specified URLs | |||
| CacheEnable cache_type [url-string] | skd | E | |
| Enable caching of specified URLs using a specified storage manager | |||
| CacheFile file-path [file-path] ... | s | D | |
| Cache a list of file handles at startup time | |||
| CacheHeader on|off | off | skdh | E |
| Add an X-Cache header to the response. | |||
| CacheIgnoreCacheControl On|Off | Off | sk | E |
| Ignore request to not serve cached content to client | |||
| CacheIgnoreHeaders header-string [header-string] ... | None | sk | E |
| Do not store the given HTTP header(s) in the cache. | |||
| CacheIgnoreNoLastMod On|Off | Off | skdh | E |
| Ignore the fact that a response has no Last Modified header. | |||
| CacheIgnoreQueryString On|Off | Off | sk | E |
| Ignore query string when caching | |||
| CacheIgnoreURLSessionIdentifiers identifier [identifier] ... | None | sk | E |
| Ignore defined session identifiers encoded in the URL when caching | |||
| CacheKeyBaseURL URL | sk | E | |
| Override the base URL of reverse proxied cache keys. | |||
| CacheLastModifiedFactor float | 0.1 | skdh | E |
| The factor used to compute an expiry date based on the LastModified date. | |||
| CacheLock on|off | off | sk | E |
| Enable the thundering herd lock. | |||
| CacheLockMaxAge integer | 5 | sk | E |
| Set the maximum possible age of a cache lock. | |||
| CacheLockPath directory | /tmp/mod_cache-lock + | sk | E |
| Set the lock path directory. | |||
| CacheMaxExpire seconds | 86400 (one day) | skdh | E |
| The maximum time in seconds to cache a document | |||
| CacheMaxFileSize bytes | 1000000 | skdh | E |
| The maximum size (in bytes) of a document to be placed in the cache | |||
| CacheMinExpire seconds | 0 | skdh | E |
| The minimum time in seconds to cache a document | |||
| CacheMinFileSize bytes | 1 | skdh | E |
| The minimum size (in bytes) of a document to be placed in the cache | |||
| CacheNegotiatedDocs On|Off | Off | sk | T |
| Allows content-negotiated documents to be cached by proxy servers | |||
| CacheQuickHandler on|off | on | sk | E |
| Run the cache from the quick handler. | |||
| CacheReadSize bytes | 0 | skdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheReadTime milliseconds | 0 | skdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheRoot directory | sk | E | |
| The directory root under which cache files are stored | |||
| CacheSocache type[:args] | sk | E | |
| The shared object cache implementation to use | |||
| CacheSocacheMaxSize bytes | 102400 | skdh | E |
| The maximum size (in bytes) of an entry to be placed in the cache | |||
| CacheSocacheMaxTime seconds | 86400 | skdh | E |
| The maximum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheMinTime seconds | 600 | skdh | E |
| The minimum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheReadSize bytes | 0 | skdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheSocacheReadTime milliseconds | 0 | skdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheStaleOnError on|off | on | skdh | E |
| Serve stale content in place of 5xx responses. | |||
| CacheStoreExpired On|Off | Off | skdh | E |
| Attempt to cache responses that the server reports as expired | |||
| CacheStoreNoStore On|Off | Off | skdh | E |
| Attempt to cache requests or responses that have been marked as no-store. | |||
| CacheStorePrivate On|Off | Off | skdh | E |
| Attempt to cache responses that the server has marked as private | |||
| CGIDScriptTimeout time[s|ms] | skdh | T | |
| The length of time to wait for more output from the CGI program | |||
CGIMapExtension cgi-yolu .uzantı | dh | Ç | |
| CGI betik yorumlayıcısını saptama tekniğini belirler. | |||
| CGIPassAuth On|Off | Off | dh | Ç |
| HTTP yetkilendirme başlıklarının betiklere CGI değişkenleri olarak aktarılmasını etkin kılar | |||
| CGIScriptTimeout time[s|ms] | skdh | T | |
| The length of time to wait for more output from the CGI program | |||
CGIVar değişken kural | dh | Ç | |
| Bazı CGI değişkenlerinin nasıl atanacağını belirler | |||
| CharsetDefault charset | skdh | E | |
| Charset to translate into | |||
| CharsetOptions option [option] ... | ImplicitAdd | skdh | E |
| Configures charset translation behavior | |||
| CharsetSourceEnc charset | skdh | E | |
| Source charset of files | |||
| CheckBasenameMatch on|off | On | skdh | E |
| Also match files with differing file name extensions. | |||
| CheckCaseOnly on|off | Off | skdh | E |
| Limits the action of the speling module to case corrections | |||
| CheckSpelling on|off | Off | skdh | E |
| Enables the spelling module | |||
| ChrootDir /dizin/yolu | s | T | |
| Sunucunun başlatıldıktan sonra chroot(8) yapacağı dizini belirler. | |||
| ContentDigest On|Off | Off | skdh | Ç |
Content-MD5 HTTP yanıt başlıklarının üretimini
etkin kılar. | |||
| CookieDomain domain | skdh | E | |
| The domain to which the tracking cookie applies | |||
| CookieExpires expiry-period | skdh | E | |
| Expiry time for the tracking cookie | |||
| CookieHTTPOnly on|off | off | skdh | E |
| Adds the 'HTTPOnly' attribute to the cookie | |||
| CookieName token | Apache | skdh | E |
| Name of the tracking cookie | |||
| CookieSameSite None|Lax|Strict | skdh | E | |
| Adds the 'SameSite' attribute to the cookie | |||
| CookieSecure on|off | off | skdh | E |
| Adds the 'Secure' attribute to the cookie | |||
| CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965 | Netscape | skdh | E |
| Format of the cookie header field | |||
| CookieTracking on|off | off | skdh | E |
| Enables tracking cookie | |||
| CoreDumpDirectory dizin | s | M | |
core dosyasını dökümlemek üzere Apache HTTP
Sunucusunun geçmeye çalışacağı dizin. | |||
| CustomLog dosya|borulu-süreç biçem|takma-ad [env=[!]ortam-değişkeni]| expr=ifade] | sk | T | |
| Günlük dosyasın ismini ve girdi biçemini belirler. | |||
| Dav On|Off|provider-name | Off | d | E |
| Enable WebDAV HTTP methods | |||
| DavBasePath root-path | d | E | |
| Configure repository root path | |||
| DavDepthInfinity on|off | off | skd | E |
| Allow PROPFIND, Depth: Infinity requests | |||
| DavGenericLockDB file-path | skd | E | |
| Location of the DAV lock database | |||
| DavLockDB file-path | sk | E | |
| Location of the DAV lock database | |||
| DavLockDiscovery on|off | on | skdh | E |
| Enable lock discovery | |||
| DavMinTimeout seconds | 0 | skd | E |
| Minimum amount of time the server holds a lock on a DAV resource | |||
| DBDExptime time-in-seconds | 300 | sk | E |
| Keepalive time for idle connections | |||
| DBDInitSQL "SQL statement" | sk | E | |
| Execute an SQL statement after connecting to a database | |||
| DBDKeep number | 2 | sk | E |
| Maximum sustained number of connections | |||
| DBDMax number | 10 | sk | E |
| Maximum number of connections | |||
| DBDMin number | 1 | sk | E |
| Minimum number of connections | |||
| DBDParams param1=value1[,param2=value2] | sk | E | |
| Parameters for database connection | |||
| DBDPersist On|Off | sk | E | |
| Whether to use persistent connections | |||
| DBDPrepareSQL "SQL statement" label | sk | E | |
| Define an SQL prepared statement | |||
| DBDriver name | sk | E | |
| Specify an SQL driver | |||
| DefaultIcon URL-yolu | skdh | T | |
| Özel bir simge atanmamış dosyalar için gösterilecek simgeyi belirler. | |||
| DefaultLanguage language-tag | skdh | T | |
| Defines a default language-tag to be sent in the Content-Language header field for all resources in the current context that have not been assigned a language-tag by some other means. | |||
DefaultRuntimeDir dizin-yolu | DEFAULT_REL_RUNTIME + | s | Ç |
| Sunucunun çalışma anı dosyaları için temel dizin | |||
DefaultType ortam-türü|none | none | skdh | Ç |
Değeri none olduğu takdirde, bu yönergenin bir
uyarı vermekten başka bir etkisi yoktur. Önceki sürümlerde, bu yönerge,
sunucunun ortam türünü saptayamadığı durumda göndereceği öntanımlı ortam
türünü belirlerdi. | |||
Define değişken-ismi [değişken-değeri] | skd | Ç | |
| Bir değişken tanımlar | |||
| DeflateAlterETag AddSuffix|NoChange|Remove | AddSuffix | sk | E |
| How the outgoing ETag header should be modified during compression | |||
| DeflateBufferSize value | 8096 | sk | E |
| Fragment size to be compressed at one time by zlib | |||
| DeflateCompressionLevel value | sk | E | |
| How much compression do we apply to the output | |||
| DeflateFilterNote [type] notename | sk | E | |
| Places the compression ratio in a note for logging | |||
| DeflateInflateLimitRequestBody value | skdh | E | |
| Maximum size of inflated request bodies | |||
| DeflateInflateRatioBurst value | 3 | skdh | E |
| Maximum number of times the inflation ratio for request bodies can be crossed | |||
| DeflateInflateRatioLimit value | 200 | skdh | E |
| Maximum inflation ratio for request bodies | |||
| DeflateMemLevel value | 9 | sk | E |
| How much memory should be used by zlib for compression | |||
| DeflateWindowSize value | 15 | sk | E |
| Zlib compression window size | |||
| Deny from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts are denied access to the server | |||
<Directory dizin-yolu>
... </Directory> | sk | Ç | |
| Sadece ismi belirtilen dosya sistemi dizininde ve bunun altdizinlerinde ve bunların içeriğinde uygulanacak bir yönerge grubunu sarmalar. | |||
| DirectoryCheckHandler On|Off | Off | skdh | T |
| Başka bir eylemci yapılandırılmışsa bu modülün nasıl yanıt vereceğini belirler | |||
| DirectoryIndex disabled | yerel-url [yerel-url] ... | index.html | skdh | T |
| İstemci bir dizin istediğinde dizin içeriğini listeler. | |||
| DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-kodu | off | skdh | T |
| Dizin içerik listeleri için harici bir yönlendirme yapılandırır. | |||
<DirectoryMatch düzifd>
... </DirectoryMatch> | sk | Ç | |
| Bir düzenli ifade ile eşleşen dosya sistemi dizinlerinin içeriklerine uygulanacak bir yönerge grubunu sarmalar. | |||
| DirectorySlash On|Off | On | skdh | T |
| Bölü çizgisi ile biten yönlendirmeleri açar/kapar. | |||
DocumentRoot dizin-yolu | "/usr/local/apache/ + | sk | Ç |
| İstemciye görünür olan ana belge ağacının kök dizinini belirler. | |||
| DTracePrivileges On|Off | Off | s | D |
| Determines whether the privileges required by dtrace are enabled. | |||
| DumpIOInput On|Off | Off | s | E |
| Dump all input data to the error log | |||
| DumpIOOutput On|Off | Off | s | E |
| Dump all output data to the error log | |||
| <Else> ... </Else> | skdh | Ç | |
Önceki bir <If> veya <ElseIf> bölümünün koşulu, çalışma anında bir istek tarafından yerine getirilmediği takdirde uygulanacak yönergeleri içerir | |||
<ElseIf ifade> ... </ElseIf> | skdh | Ç | |
İçerdiği koşulun bir istek tarafınan sağlandığı ancak daha önceki bir <If> veya
<ElseIf> bölümlerininkilerin sağlanmadığı durumda kapsadığı yönergelerin uygulanmasını sağlar | |||
| EnableExceptionHook On|Off | Off | s | M |
| Bir çöküş sonrası olağandışılık eylemcilerini çalıştıracak kancayı etkin kılar. | |||
| EnableMMAP On|Off | On | skdh | Ç |
| Teslimat sırasında okunacak dosyalar için bellek eşlemeyi etkin kılar. | |||
| EnableSendfile On|Off | Off | skdh | Ç |
| Dosyaların istemciye tesliminde çekirdeğin dosya gönderme desteğinin kullanımını etkin kılar. | |||
Error ileti | skdh | Ç | |
| Özel bir hata iletisiyle yapılandırma çözümlemesini durdurur | |||
ErrorDocument hata-kodu belge | skdh | Ç | |
| Bir hata durumunda sunucunun istemciye ne döndüreceğini belirler. | |||
ErrorLog dosya-yolu|syslog[:[oluşum][:etiket]] | logs/error_log (Uni + | sk | Ç |
| Sunucunun hata günlüğünü tutacağı yeri belirler. | |||
ErrorLogFormat [connection|request] biçem | sk | Ç | |
| Hata günlüğü girdileri için biçem belirtimi | |||
| Example | skdh | D | |
| Demonstration directive to illustrate the Apache module API | |||
| ExpiresActive On|Off | Off | skdh | E |
Enables generation of Expires
headers | |||
| ExpiresByType MIME-type <code>seconds | skdh | E | |
Value of the Expires header configured
by MIME type | |||
| ExpiresDefault <code>seconds | skdh | E | |
| Default algorithm for calculating expiration time | |||
| ExtendedStatus On|Off | Off[*] | s | Ç |
| Her istekte ek durum bilgisinin izini sürer | |||
| ExtFilterDefine filtername parameters | s | E | |
| Define an external filter | |||
| ExtFilterOptions option [option] ... | NoLogStderr | d | E |
Configure mod_ext_filter options | |||
| FallbackResource disabled | yerel-url | skdh | T | |
| Bir dosya ile eşleşmeyen istekler için öntanımlı URL tanımlar | |||
FileETag bileşen ... | MTime Size | skdh | Ç |
Duruk dosyalar için ETag HTTP yanıt başlığını oluşturmakta kullanılacak dosya özniteliklerini belirler. | |||
<Files dosya-adı> ... </Files> | skdh | Ç | |
| Dosya isimleriyle eşleşme halinde uygulanacak yönergeleri içerir. | |||
<FilesMatch düzifd> ... </FilesMatch> | skdh | Ç | |
| Düzenli ifadelerin dosya isimleriyle eşleşmesi halinde uygulanacak yönergeleri içerir. | |||
| FilterChain [+=-@!]filter-name ... | skdh | T | |
| Configure the filter chain | |||
| FilterDeclare filter-name [type] | skdh | T | |
| Declare a smart filter | |||
| FilterProtocol filter-name [provider-name] proto-flags | skdh | T | |
| Deal with correct HTTP protocol handling | |||
| FilterProvider filter-name provider-name expression | skdh | T | |
| Register a content filter | |||
| FilterTrace filter-name level | skd | T | |
Get debug/diagnostic information from
mod_filter | |||
FlushMaxPipelined sayı | 5 | sk | Ç |
| Ağa akıtılacak azami ardışık yanıt sayısı | |||
FlushMaxThreshold bayt-sayısı | 65536 | sk | Ç |
| Bekleyen verilerin ağa boşaltılacağı eşik değer | |||
| ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] | Prefer | skdh | T |
| Action to take if a single acceptable document is not found | |||
ForceType ortam-türü|None | dh | Ç | |
| Bütün dosyaların belirtilen ortam türüyle sunulmasına sebep olur. | |||
| ForensicLog dosya-adı|borulu-süreç | sk | E | |
| Adli günlük için dosya ismini belirler. | |||
| GlobalLog dosya|boru|sağlayıcı biçem|takma_ad [env=[!]ortam_değişkeni| expr=ifade] | s | T | |
| Günlük dosyasının ismini ve biçemini belirler | |||
GprofDir /tmp/gprof/|/tmp/gprof/% | sk | Ç | |
| gmon.out ayrıntılı inceleme verisinin yazılacağı dizin | |||
| GracefulShutdownTimeout saniye | 0 | s | M |
| Sunucunun nazikçe kapatılmasının ardından ana süreç çıkana kadar geçecek süre için bir zaman aşımı belirler. | |||
| Group unix-grubu | #-1 | s | T |
| İsteklere yanıt verecek sunucunun ait olacağı grubu belirler. | |||
| H2CopyFiles on|off | off | skdh | E |
| Determine file handling in responses | |||
| H2Direct on|off | on for h2c, off for + | sk | E |
| H2 Direct Protocol Switch | |||
| H2EarlyHint name value | skdh | E | |
| Add a response header to be picked up in 103 Early Hints | |||
| H2EarlyHints on|off | off | sk | E |
| Determine sending of 103 status codes | |||
| H2MaxDataFrameLen n | 0 | sk | E |
| Maximum bytes inside a single HTTP/2 DATA frame | |||
| H2MaxHeaderBlockLen n | 0 | sk | E |
| Maximum size of response headers | |||
| H2MaxSessionStreams n | 100 | sk | E |
| Maximum number of active streams per HTTP/2 session. | |||
| H2MaxWorkerIdleSeconds n | 600 | s | E |
| Maximum number of seconds h2 workers remain idle until shut down. | |||
| H2MaxWorkers n | s | E | |
| Maximum number of worker threads to use per child process. | |||
| H2MinWorkers n | s | E | |
| Minimal number of worker threads to use per child process. | |||
| H2ModernTLSOnly on|off | on | sk | E |
| Require HTTP/2 connections to be "modern TLS" only | |||
| H2OutputBuffering on|off | on | sk | E |
| Determine buffering behaviour of output | |||
| H2Padding numbits | 0 | sk | E |
| Determine the range of padding bytes added to payload frames | |||
| H2ProxyRequests on|off | off | sk | E |
| En-/Disable forward proxy requests via HTTP/2 | |||
| H2Push on|off | on | skdh | E |
| H2 Server Push Switch | |||
| H2PushDiarySize n | 256 | sk | E |
| H2 Server Push Diary Size | |||
| H2PushPriority mime-type [after|before|interleaved] [weight] | * After 16 | sk | E |
| H2 Server Push Priority | |||
| H2PushResource [add] path [critical] | skdh | E | |
| Declares resources for early pushing to the client | |||
| H2SerializeHeaders on|off | off | sk | E |
| Serialize Request/Response Processing Switch | |||
| H2StreamMaxMemSize bytes | 65536 | sk | E |
| Maximum amount of output data buffered per stream. | |||
| H2StreamTimeout time-interval[s] | skd | E | |
| Maximum time waiting when sending/receiving data to stream processing | |||
| H2TLSCoolDownSecs seconds | 1 | sk | E |
| Configure the number of seconds of idle time on TLS before shrinking writes | |||
| H2TLSWarmUpSize amount | 1048576 | sk | E |
| Configure the number of bytes on TLS connection before doing max writes | |||
| H2Upgrade on|off | on for h2c, off for + | skdh | E |
| H2 Upgrade Protocol Switch | |||
| H2WebSockets on|off | off | sk | E |
| En-/Disable WebSockets via HTTP/2 | |||
| H2WindowSize bytes | 65535 | sk | E |
| Size of Stream Window for upstream data. | |||
| Header [condition] add|append|echo|edit|edit*|merge|set|setifempty|unset|note header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] | skdh | E | |
| Configure HTTP response headers | |||
| HeaderName dosya-ismi | skdh | T | |
| Dizin listesinin tepesine yerleştirilecek dosyanın ismini belirler. | |||
| HeartbeatAddress addr:port | s | D | |
| Multicast address for heartbeat packets | |||
| HeartbeatListen addr:port | s | D | |
| multicast address to listen for incoming heartbeat requests | |||
| HeartbeatMaxServers number-of-servers | 10 | s | D |
| Specifies the maximum number of servers that will be sending heartbeat requests to this server | |||
| HeartbeatStorage file-path | logs/hb.dat | s | D |
| Path to store heartbeat data when using flat-file storage | |||
| HeartbeatStorage file-path | logs/hb.dat | s | D |
| Path to read heartbeat data | |||
| HostnameLookups On|Off|Double | Off | skd | Ç |
| İstemci IP adresleri üzerinde DNS sorgularını etkin kılar. | |||
| HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods] [Allow0.9|Require1.0] | Strict LenientMetho + | sk | Ç |
| HTTP İstek İletilerindeki sınırlamalarda değişiklik yapar | |||
| IdentityCheck On|Off | Off | skd | E |
| Enables logging of the RFC 1413 identity of the remote user | |||
| IdentityCheckTimeout seconds | 30 | skd | E |
| Determines the timeout duration for ident requests | |||
<If ifade> ... </If> | skdh | Ç | |
| Çalışma anında bir koşul bir istek tarafından yerine getirildiği takdirde uygulanacak yönergeleri barındırır. | |||
<IfDefine [!]parametre-adı> ...
</IfDefine> | skdh | Ç | |
| Başlatma sırasında bir doğruluk sınamasından sonra işleme sokulacak yönergeleri sarmalar. | |||
<IfDirective [!]yönerge-adı> ...
</IfDirective> | skdh | Ç | |
| Belirtilen yönerge adının varlığı veya yokluğuna bağlı olarak çalıştırılacak yönergeleri sarmalar. | |||
<IfFile [!]dosyaadı> ...
</IfFile> | skdh | Ç | |
| Başlatma sırasında bir dosyanın varlığı durumunda işleme sokulacak yönergeleri sarmalar. | |||
<IfModule [!]modül-dosyası|modül-betimleyici> ...
</IfModule> | skdh | Ç | |
| Belli bir modülün varlığına veya yokluğuna göre işleme sokulacak yönergeleri sarmalar. | |||
<IfSection [!]bölüm-adı> ...
</IfSection> | skdh | Ç | |
| Belirtilen bölüm adının varlığı veya yokluğuna bağlı olarak çalıştırılacak yönergeleri sarmalar. | |||
| <IfVersion [[!]operator] version> ... </IfVersion> | skdh | E | |
| contains version dependent configuration | |||
| ImapBase map|referer|URL | http://servername/ | skdh | T |
Default base for imagemap files | |||
| ImapDefault error|nocontent|map|referer|URL | nocontent | skdh | T |
| Default action when an imagemap is called with coordinates that are not explicitly mapped | |||
| ImapMenu none|formatted|semiformatted|unformatted | formatted | skdh | T |
| Action if no coordinates are given when calling an imagemap | |||
Include dosya-yolu|dizin-yolu|joker | skd | Ç | |
| Sunucu yapılandırma dosyalarının başka dosyaları içermesini sağlar. | |||
IncludeOptional dosya-yolu|dizin-yolu|joker | skd | Ç | |
| Diğer yapılandırma dosyalarının sunucu yapılandırma dosyasına dahil edilmesini sağlar | |||
| IndexHeadInsert "imlenim ..." | skdh | T | |
| Bir dizin sayfasının HEAD bölümüne metin yerleştirir. | |||
| IndexIgnore dosya [dosya] ... | "." | skdh | T |
| Dizin içerik listesinden gizlenecek dosyaların listesi belirtilir. | |||
| IndexIgnoreReset ON|OFF | skdh | T | |
| Bir dizini listelerken gizlenecek dosyalar listesini boşaltır | |||
| IndexOptions [+|-]seçenek [[+|-]seçenek] ... | skdh | T | |
| Dizin içerik listesini yapılandıracak seçenekler belirtilir. | |||
| IndexOrderDefault Ascending|Descending Name|Date|Size|Description | Ascending Name | skdh | T |
| Dizin içerik listesinin öntanımlı sıralamasını belirler. | |||
| IndexStyleSheet url-yolu | skdh | T | |
| Dizin listesine bir biçembent ekler. | |||
| InputSed sed-command | dh | D | |
Sed command to filter request data (typically POST data) | |||
| ISAPIAppendLogToErrors on|off | off | skdh | T |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the error log | |||
| ISAPIAppendLogToQuery on|off | on | skdh | T |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the query field | |||
| ISAPICacheFile file-path [file-path] ... | sk | T | |
| ISAPI .dll files to be loaded at startup | |||
| ISAPIFakeAsync on|off | off | skdh | T |
| Fake asynchronous support for ISAPI callbacks | |||
| ISAPILogNotSupported on|off | off | skdh | T |
| Log unsupported feature requests from ISAPI extensions | |||
| ISAPIReadAheadBuffer size | 49152 | skdh | T |
| Size of the Read Ahead Buffer sent to ISAPI extensions | |||
| KeepAlive On|Off | On | sk | Ç |
| HTTP kalıcı bağlantılarını etkin kılar | |||
KeepAliveTimeout sayı[ms] | 5 | sk | Ç |
| Bir kalıcı bağlantıda sunucunun bir sonraki isteği bekleme süresi | |||
| KeptBodySize azami_bayt_sayısı | 0 | d | T |
| mod_include gibi süzgeçler tarafından kullanılma olasılığına karşı istek gövdesi iptal edilmek yerine belirtilen azami boyutta tutulur. | |||
| LanguagePriority MIME-lang [MIME-lang] ... | skdh | T | |
| The precedence of language variants for cases where the client does not express a preference | |||
| LDAPCacheEntries number | 1024 | s | E |
| Maximum number of entries in the primary LDAP cache | |||
| LDAPCacheTTL seconds | 600 | s | E |
| Time that cached items remain valid | |||
| LDAPConnectionPoolTTL n | -1 | sk | E |
| Discard backend connections that have been sitting in the connection pool too long | |||
| LDAPConnectionTimeout seconds | s | E | |
| Specifies the socket connection timeout in seconds | |||
| LDAPLibraryDebug 7 | s | E | |
| Enable debugging in the LDAP SDK | |||
| LDAPOpCacheEntries number | 1024 | s | E |
| Number of entries used to cache LDAP compare operations | |||
| LDAPOpCacheTTL seconds | 600 | s | E |
| Time that entries in the operation cache remain valid | |||
| LDAPReferralHopLimit number | dh | E | |
| The maximum number of referral hops to chase before terminating an LDAP query. | |||
| LDAPReferrals On|Off|default | On | dh | E |
| Enable referral chasing during queries to the LDAP server. | |||
| LDAPRetries number-of-retries | 3 | s | E |
| Configures the number of LDAP server retries. | |||
| LDAPRetryDelay seconds | 0 | s | E |
| Configures the delay between LDAP server retries. | |||
| LDAPSharedCacheFile directory-path/filename | s | E | |
| Sets the shared memory cache file | |||
| LDAPSharedCacheSize bytes | 500000 | s | E |
| Size in bytes of the shared-memory cache | |||
| LDAPTimeout seconds | 60 | s | E |
| Specifies the timeout for LDAP search and bind operations, in seconds | |||
| LDAPTrustedClientCert type directory-path/filename/nickname [password] | dh | E | |
| Sets the file containing or nickname referring to a per connection client certificate. Not all LDAP toolkits support per connection client certificates. | |||
| LDAPTrustedGlobalCert type directory-path/filename [password] | s | E | |
| Sets the file or database containing global trusted Certificate Authority or global client certificates | |||
| LDAPTrustedMode type | sk | E | |
| Specifies the SSL/TLS mode to be used when connecting to an LDAP server. | |||
| LDAPVerifyServerCert On|Off | On | s | E |
| Force server certificate verification | |||
<Limit yöntem [yöntem] ... > ...
</Limit> | dh | Ç | |
| Erişimi sınırlanacak HTTP yöntemleri için erişim sınırlayıcıları sarmalar. | |||
<LimitExcept yöntem [yöntem] ... > ...
</LimitExcept> | dh | Ç | |
| İsimleri belirtilenler dışında kalan HTTP yöntemleri için kullanılacak erişim sınırlayıcıları sarmalar. | |||
LimitInternalRecursion sayı [sayı] | 10 | sk | Ç |
| Dahili yönlendirmelerin ve istek içi isteklerin azami sayısını belirler. | |||
LimitRequestBody bayt-sayısı | 1073741824 | skdh | Ç |
| İstemci tarafından gönderilen HTTP istek gövdesinin toplam uzunluğunu sınırlar. | |||
LimitRequestFields sayı | 100 | sk | Ç |
| İstemciden kabul edilecek HTTP isteği başlık alanlarının sayısını sınırlar. | |||
LimitRequestFieldSize bayt-sayısı | 8190 | sk | Ç |
| İstemciden kabul edilecek HTTP isteği başlık uzunluğunu sınırlar. | |||
LimitRequestLine bayt-sayısı | 8190 | sk | Ç |
| İstemciden kabul edilecek HTTP istek satırının uzunluğunu sınırlar. | |||
LimitXMLRequestBody bayt-sayısı | 1000000 | skdh | Ç |
| Bir XML temelli istek gövdesinin uzunluğunu sınırlar. | |||
| Listen [IP-adresi:]port-numarası [protokol] | s | M | |
| Sunucunun dinleyeceği IP adresini ve portu belirler. | |||
| ListenBackLog kuyruk-uzunluğu | 511 | s | M |
| Bekleyen bağlantılar kuyruğunun azami uzunluğunu belirler | |||
| ListenCoresBucketsRatio oran | 0 (iptal) | s | M |
| İşlemci çekirdek sayısının dinleyenlerin buket sayısına oranı | |||
| LoadFile dosya-ismi [dosya-ismi] ... | sk | E | |
| Belirtilen nesne dosyasını veya kütüphaneyi sunucu ile ilintiler. | |||
| LoadModule modül dosya-ismi | sk | E | |
| Belirtilen nesne dosyasını veya kütüphaneyi sunucu ile ilintiler ve etkin modül listesine ekler. | |||
<Location URL-yolu|URL> ...
</Location> | sk | Ç | |
| İçerdiği yönergeler sadece eşleşen URL’lere uygulanır. | |||
<LocationMatch
düzifade> ... </LocationMatch> | sk | Ç | |
| İçerdiği yönergeler sadece düzenli ifadelerle eşleşen URL’lere uygulanır. | |||
| LogFormat biçem|takma-ad [takma-ad] | "%h %l %u %t \"%r\" + | sk | T |
| Bir günlük dosyasında kullanılmak üzere girdi biçemi tanımlar. | |||
| LogIOTrackTTFB ON|OFF | OFF | skdh | E |
| İlk baytın yazılmasına kadar geçen süreyi izler | |||
LogLevel [modül:]seviye
[modül:seviye] ...
| warn | skd | Ç |
| Hata günlüklerinin ayrıntı seviyesini belirler. | |||
| LogMessage message [hook=hook] [expr=expression] | d | D | |
| Log user-defined message to error log | |||
| LuaAuthzProvider provider_name /path/to/lua/script.lua function_name | s | E | |
Plug an authorization provider function into mod_authz_core
| |||
| LuaCodeCache stat|forever|never | stat | skdh | E |
| Configure the compiled code cache. | |||
| LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late] | skdh | E | |
| Provide a hook for the access_checker phase of request processing | |||
| LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late] | skdh | E | |
| Provide a hook for the auth_checker phase of request processing | |||
| LuaHookCheckUserID /path/to/lua/script.lua hook_function_name [early|late] | skdh | E | |
| Provide a hook for the check_user_id phase of request processing | |||
| LuaHookFixups /path/to/lua/script.lua hook_function_name | skdh | E | |
| Provide a hook for the fixups phase of a request processing | |||
| LuaHookInsertFilter /path/to/lua/script.lua hook_function_name | skdh | E | |
| Provide a hook for the insert_filter phase of request processing | |||
| LuaHookLog /path/to/lua/script.lua log_function_name | skdh | E | |
| Provide a hook for the access log phase of a request processing | |||
| LuaHookMapToStorage /path/to/lua/script.lua hook_function_name | skdh | E | |
| Provide a hook for the map_to_storage phase of request processing | |||
| LuaHookPreTranslate /path/to/lua/script.lua hook_function_name | skdh | E | |
| Provide a hook for the pre_translate phase of a request processing | |||
| LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late] | sk | E | |
| Provide a hook for the translate name phase of request processing | |||
| LuaHookTypeChecker /path/to/lua/script.lua hook_function_name | skdh | E | |
| Provide a hook for the type_checker phase of request processing | |||
| LuaInherit none|parent-first|parent-last | parent-first | skdh | E |
| Controls how parent configuration sections are merged into children | |||
| LuaInputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content input filtering | |||
| LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name] | skdh | E | |
| Map a path to a lua handler | |||
| LuaOutputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content output filtering | |||
| LuaPackageCPath /path/to/include/?.soa | skdh | E | |
| Add a directory to lua's package.cpath | |||
| LuaPackagePath /path/to/include/?.lua | skdh | E | |
| Add a directory to lua's package.path | |||
| LuaQuickHandler /path/to/script.lua hook_function_name | sk | E | |
| Provide a hook for the quick handler of request processing | |||
| LuaRoot /path/to/a/directory | skdh | E | |
| Specify the base path for resolving relative paths for mod_lua directives | |||
| LuaScope once|request|conn|thread|server [min] [max] | once | skdh | E |
| One of once, request, conn, thread -- default is once | |||
| <Macro name [par1 .. parN]> ... </Macro> | skd | T | |
| Define a configuration file macro | |||
| MaxConnectionsPerChild sayı | 0 | s | M |
| Tek bir çocuk sürecin ömrü boyunca işleme sokabileceği istek sayısını sınırlamakta kullanılır. | |||
MaxKeepAliveRequests sayı | 100 | sk | Ç |
| Bir kalıcı bağlantıda izin verilen istek sayısı | |||
| MaxMemFree kB-sayısı | 2048 | s | M |
free() çağrılmaksızın ana bellek ayırıcının
ayırmasına izin verilen azami bellek miktarını belirler. | |||
MaxRangeOverlaps default | unlimited | none |
aralık-sayısı | 20 | skd | Ç |
Özkaynağın tamamını döndürmeden önce izin verilen üst üste binen
aralık sayısı (100-200,150-300 gibi) | |||
MaxRangeReversals default | unlimited | none |
aralık-sayısı | 20 | skd | Ç |
Özkaynağın tamamını döndürmeden önce izin verilen ters sıralı
aralık sayısı (100-200,50-70 gibi) | |||
MaxRanges default | unlimited | none |
aralık-sayısı | 200 | skd | Ç |
| Özkaynağın tamamını döndürmeden önce izin verilen aralık sayısı | |||
| MaxRequestWorkers sayı | s | M | |
| Aynı anda işleme sokulacak azami bağlantı sayısı | |||
| MaxSpareServers sayı | 10 | s | M |
| Boştaki çocuk süreçlerin azami sayısı | |||
| MaxSpareThreads number | s | M | |
| Boştaki azami evre sayısını belirler | |||
| MaxThreads number | 2048 | s | M |
| Set the maximum number of worker threads | |||
| MDActivationDelay duration | s | D | |
| How long to delay activation of new certificates | |||
| MDBaseServer on|off | off | s | D |
| Control if base server may be managed or only virtual hosts. | |||
| MDCAChallenges name [ name ... ] | tls-alpn-01 http-01 + | s | D |
| Type of ACME challenge used to prove domain ownership. | |||
| MDCertificateAgreement accepted | s | D | |
| You confirm that you accepted the Terms of Service of the Certificate Authority. | |||
| MDCertificateAuthority url | letsencrypt | s | D |
| The URL(s) of the ACME Certificate Authority to use. | |||
| MDCertificateCheck name url | s | D | |
| Set name and URL pattern for a certificate monitoring site. | |||
| MDCertificateFile path-to-pem-file | s | D | |
| Specify a static certificate file for the MD. | |||
| MDCertificateKeyFile path-to-file | s | D | |
| Specify a static private key for for the static cerrtificate. | |||
| MDCertificateMonitor name url | crt.sh https://crt. + | s | D |
| The URL of a certificate log monitor. | |||
| MDCertificateProtocol protocol | ACME | s | D |
| The protocol to use with the Certificate Authority. | |||
| MDCertificateStatus on|off | on | s | D |
| Exposes public certificate information in JSON. | |||
| MDChallengeDns01 path-to-command | s | D | |
| Set the command for setup/teardown of dns-01 challenges | |||
| MDChallengeDns01Version 1|2 | 1 | s | D |
| Set the type of arguments to call MDChallengeDns01 with | |||
| MDCheckInterval duration | 12h | s | D |
| Determines how often certificates are checked | |||
| MDContactEmail address | s | D | |
| Email address used for account registration | |||
| MDDriveMode always|auto|manual | auto | s | D |
| former name of MDRenewMode. | |||
| MDExternalAccountBinding key-id hmac-64 | none | file | none | s | D |
| Set the external account binding keyid and hmac values to use at CA | |||
| MDHttpProxy url | s | D | |
| Define a proxy for outgoing connections. | |||
| MDMatchNames all|servernames | all | s | D |
| Determines how DNS names are matched to vhosts | |||
| MDMember hostname | s | D | |
| Additional hostname for the managed domain. | |||
| MDMembers auto|manual | auto | s | D |
| Control if the alias domain names are automatically added. | |||
| MDMessageCmd path-to-cmd optional-args | s | D | |
| Handle events for Manage Domains | |||
| MDMustStaple on|off | off | s | D |
| Control if new certificates carry the OCSP Must Staple flag. | |||
| MDNotifyCmd path [ args ] | s | D | |
| Run a program when a Managed Domain is ready. | |||
| MDomain dns-name [ other-dns-name... ] [auto|manual] | s | D | |
| Define list of domain names that belong to one group. | |||
| <MDomainSet dns-name [ other-dns-name... ]>...</MDomainSet> | s | D | |
| Container for directives applied to the same managed domains. | |||
| MDPortMap map1 [ map2 ] | http:80 https:443 | s | D |
| Map external to internal ports for domain ownership verification. | |||
| MDPrivateKeys type [ params... ] | RSA 2048 | s | D |
| Set type and size of the private keys generated. | |||
| MDProfile name | s | D | |
| Use a specific ACME profile from the CA | |||
| MDProfileMandatory on|off | off | s | D |
| Control if an MDProfile is mandatory. | |||
| MDRenewMode always|auto|manual | auto | s | D |
| Controls if certificates shall be renewed. | |||
| MDRenewWindow duration | 33% | s | D |
| Control when a certificate will be renewed. | |||
| MDRequireHttps off|temporary|permanent | off | s | D |
| Redirects http: traffic to https: for Managed Domains. | |||
| MDRetryDelay duration | 5s | s | D |
| Time length for first retry, doubled on every consecutive error. | |||
| MDRetryFailover number | 13 | s | D |
| The number of errors before a failover to another CA is triggered | |||
| MDServerStatus on|off | on | s | D |
| Control if Managed Domain information is added to server-status. | |||
| MDStapleOthers on|off | on | s | D |
| Enable stapling for certificates not managed by mod_md. | |||
| MDStapling on|off | off | s | D |
| Enable stapling for all or a particular MDomain. | |||
| MDStaplingKeepResponse duration | 7d | s | D |
| Controls when old responses should be removed. | |||
| MDStaplingRenewWindow duration | 33% | s | D |
| Control when the stapling responses will be renewed. | |||
| MDStoreDir path | md | s | D |
| Path on the local file system to store the Managed Domains data. | |||
| MDStoreLocks on|off|duration | off | s | D |
| Configure locking of store for updates | |||
| MDWarnWindow duration | 10% | s | D |
| Define the time window when you want to be warned about an expiring certificate. | |||
| MemcacheConnTTL num[units] | 15s | sk | E |
| Keepalive time for idle connections | |||
| MergeSlashes ON|OFF | ON | sk | Ç |
| Sunucunun URL’lerde ardışık bölü çizgilerini birleştirip birleştirmeyeceğini denetler. | |||
| MergeTrailers [on|off] | off | sk | Ç |
| Trailer alanlarının başlığa dahil edilip edilmeyeceğini belirler | |||
| MetaDir directory | .web | skdh | E |
| Name of the directory to find CERN-style meta information files | |||
| MetaFiles on|off | off | skdh | E |
| Activates CERN meta-file processing | |||
| MetaSuffix suffix | .meta | skdh | E |
| File name suffix for the file containing CERN-style meta information | |||
| MimeMagicFile file-path | sk | E | |
| Enable MIME-type determination based on file contents using the specified magic file | |||
| MinSpareServers sayı | 5 | s | M |
| Boştaki çocuk süreçlerin asgari sayısı | |||
| MinSpareThreads sayı | s | M | |
| İsteklerin ani artışında devreye girecek boştaki evrelerin asgari sayısını belirler. | |||
| MMapFile file-path [file-path] ... | s | D | |
| Map a list of files into memory at startup time | |||
| ModemStandard V.21|V.26bis|V.32|V.34|V.92 | d | D | |
| Modem standard to simulate | |||
| ModMimeUsePathInfo On|Off | Off | d | T |
Tells mod_mime to treat path_info
components as part of the filename | |||
| MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers [Handlers|Filters] | NegotiatedOnly | skdh | T |
| The types of files that will be included when searching for a matching file with MultiViews | |||
Mutex mekanizma [default|muteks-ismi] ... [OmitPID] | default | s | Ç |
| Muteks mekanizmasını ve kilit dosyası dizinini tüm muteksler veya belirtilenler için yapılandırır | |||
NameVirtualHost adres[:port] | s | Ç | |
| ÖNERİLMİYOR: İsme dayalı sanal konaklar için IP adresi belirtir | |||
| NoProxy host [host] ... | sk | E | |
| Hosts, domains, or networks that will be connected to directly | |||
| NWSSLTrustedCerts filename [filename] ... | s | T | |
| List of additional client certificates | |||
| NWSSLUpgradeable [IP-address:]portnumber | s | T | |
| Allows a connection to be upgraded to an SSL connection upon request | |||
Options
[+|-]seçenek [[+|-]seçenek] ... | FollowSymlinks | skdh | Ç |
| Belli bir dizinde geçerli olacak özellikleri yapılandırır. | |||
| Order ordering | Deny,Allow | dh | E |
Controls the default access state and the order in which
Allow and Deny are
evaluated. | |||
| OutputSed sed-command | dh | D | |
| Sed command for filtering response content | |||
| PassEnv ortam-değişkeni [ortam-değişkeni] ... | skdh | T | |
| Ortam değişkenlerini kabuktan aktarır. | |||
| PidFile dosya | logs/httpd.pid | s | M |
| Ana sürecin süreç kimliğinin (PID) kaydedileceği dosyayı belirler. | |||
| PrivilegesMode FAST|SECURE|SELECTIVE | FAST | skd | D |
| Trade off processing speed and efficiency vs security against malicious privileges-aware code. | |||
Protocol protokol | sk | Ç | |
| Dinlenen bir soket için protokol | |||
| ProtocolEcho On|Off | Off | sk | D |
| Turn the echo server on or off | |||
Protocols protokol ... | http/1.1 | sk | Ç |
| Sunucu/sanal konak için kullanılabilecek protokoller | |||
| ProtocolsHonorOrder On|Off | On | sk | Ç |
| Uzlaşma sırasında protokollerin öncelik sırasını belirler | |||
| <Proxy wildcard-url> ...</Proxy> | sk | E | |
| Container for directives applied to proxied resources | |||
| Proxy100Continue Off|On | On | skd | E |
| Forward 100-continue expectation to the origin server | |||
| ProxyAddHeaders Off|On | On | skd | E |
| Add proxy information in X-Forwarded-* headers | |||
| ProxyBadHeader IsError|Ignore|StartBody | IsError | sk | E |
| Determines how to handle bad header lines in a response | |||
| ProxyBlock *|word|host|domain [word|host|domain] ... | sk | E | |
| Words, hosts, or domains that are banned from being proxied | |||
| ProxyDomain Domain | sk | E | |
| Default domain name for proxied requests | |||
| ProxyErrorOverride Off|On [code ...] | Off | skd | E |
| Override error pages for proxied content | |||
| ProxyExpressDBMFile pathname | sk | E | |
| Pathname to DBM file. | |||
| ProxyExpressDBMType type | default | sk | E |
| DBM type of file. | |||
| ProxyExpressEnable on|off | off | sk | E |
| Enable the module functionality. | |||
| ProxyFCGIBackendType FPM|GENERIC | FPM | skdh | E |
| Specify the type of backend FastCGI application | |||
| ProxyFCGISetEnvIf conditional-expression [!]environment-variable-name [value-expression] | skdh | E | |
| Allow variables sent to FastCGI servers to be fixed up | |||
| ProxyFtpDirCharset character_set | ISO-8859-1 | skd | E |
| Define the character set for proxied FTP listings | |||
| ProxyFtpEscapeWildcards on|off | on | skd | E |
| Whether wildcards in requested filenames are escaped when sent to the FTP server | |||
| ProxyFtpListOnWildcard on|off | on | skd | E |
| Whether wildcards in requested filenames trigger a file listing | |||
| ProxyHCExpr name {ap_expr expression} | sk | E | |
| Creates a named condition expression to use to determine health of the backend based on its response | |||
| ProxyHCTemplate name parameter=setting [...] | sk | E | |
| Creates a named template for setting various health check parameters | |||
| ProxyHCTPsize size | 16 | s | E |
| Sets the total server-wide size of the threadpool used for the health check workers | |||
| ProxyHTMLBufSize bytes | 8192 | skd | T |
| Sets the buffer size increment for buffering inline scripts and stylesheets. | |||
| ProxyHTMLCharsetOut Charset | * | skd | T | |
| Specify a charset for mod_proxy_html output. | |||
| ProxyHTMLDocType HTML|XHTML [Legacy] OR ProxyHTMLDocType fpi [SGML|XML] | skd | T | |
| Sets an HTML or XHTML document type declaration. | |||
| ProxyHTMLEnable On|Off | Off | skd | T |
| Turns the proxy_html filter on or off. | |||
| ProxyHTMLEvents attribute [attribute ...] | skd | T | |
| Specify attributes to treat as scripting events. | |||
| ProxyHTMLExtended On|Off | Off | skd | T |
| Determines whether to fix links in inline scripts, stylesheets, and scripting events. | |||
| ProxyHTMLFixups [lowercase] [dospath] [reset] | skd | T | |
| Fixes for simple HTML errors. | |||
| ProxyHTMLInterp On|Off | Off | skd | T |
Enables per-request interpolation of
ProxyHTMLURLMap rules. | |||
| ProxyHTMLLinks element attribute [attribute2 ...] | skd | T | |
| Specify HTML elements that have URL attributes to be rewritten. | |||
| ProxyHTMLMeta On|Off | Off | skd | T |
Turns on or off extra pre-parsing of metadata in HTML
<head> sections. | |||
| ProxyHTMLStripComments On|Off | Off | skd | T |
| Determines whether to strip HTML comments. | |||
| ProxyHTMLURLMap from-pattern to-pattern [flags] [cond] | skd | T | |
| Defines a rule to rewrite HTML links | |||
| ProxyIOBufferSize bytes | 8192 | sk | E |
| Determine size of internal data throughput buffer | |||
| <ProxyMatch regex> ...</ProxyMatch> | sk | E | |
| Container for directives applied to regular-expression-matched proxied resources | |||
| ProxyMaxForwards number | -1 | sk | E |
| Maximum number of proxies that a request can be forwarded through | |||
| ProxyPass [path] !|url [key=value [key=value ...]] [nocanon] [interpolate] [noquery] | skd | E | |
| Maps remote servers into the local server URL-space | |||
| ProxyPassInherit On|Off | On | sk | E |
| Inherit ProxyPass directives defined from the main server | |||
| ProxyPassInterpolateEnv On|Off | Off | skd | E |
| Enable Environment Variable interpolation in Reverse Proxy configurations | |||
| ProxyPassMatch [regex] !|url [key=value [key=value ...]] | skd | E | |
| Maps remote servers into the local server URL-space using regular expressions | |||
| ProxyPassReverse [path] url [interpolate] | skd | E | |
| Adjusts the URL in HTTP response headers sent from a reverse proxied server | |||
| ProxyPassReverseCookieDomain internal-domain public-domain [interpolate] | skd | E | |
| Adjusts the Domain string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPassReverseCookiePath internal-path public-path [interpolate] | skd | E | |
| Adjusts the Path string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPreserveHost On|Off | Off | skd | E |
| Use incoming Host HTTP request header for proxy request | |||
| ProxyReceiveBufferSize bytes | 0 | sk | E |
| Network buffer size for proxied HTTP and FTP connections | |||
| ProxyRemote match remote-server [username:password] | sk | E | |
| Remote proxy used to handle certain requests | |||
| ProxyRemoteMatch regex remote-server [username:password] | sk | E | |
| Remote proxy used to handle requests matched by regular expressions | |||
| ProxyRequests On|Off | Off | sk | E |
| Enables forward (standard) proxy requests | |||
| ProxySCGIInternalRedirect On|Off|Headername | On | skd | E |
| Enable or disable internal redirect responses from the backend | |||
| ProxySCGISendfile On|Off|Headername | Off | skd | E |
| Enable evaluation of X-Sendfile pseudo response header | |||
| ProxySet url key=value [key=value ...] | skd | E | |
| Set various Proxy balancer or member parameters | |||
| ProxySourceAddress address | sk | E | |
| Set local IP address for outgoing proxy connections | |||
| ProxyStatus Off|On|Full | Off | sk | E |
| Show Proxy LoadBalancer status in mod_status | |||
| ProxyTimeout seconds | sk | E | |
| Network timeout for proxied requests | |||
| ProxyVia On|Off|Full|Block | Off | sk | E |
Information provided in the Via HTTP response
header for proxied requests | |||
| ProxyWebsocketFallbackToProxyHttp On|Off | On | sk | E |
Instructs this module to let mod_proxy_http handle the request | |||
| QualifyRedirectURL On|Off | Off | skd | Ç |
| REDIRECT_URL ortam değişkeninin tamamen nitelenmiş olup olmayacağını denetler | |||
ReadBufferSize bayt-sayısı | 8192 | skd | Ç |
| Veriyi okumakta kullanılacak tampon sayısı | |||
| ReadmeName dosya-ismi | skdh | T | |
| Dizin listesinin sonuna yerleştirilecek dosyanın ismini belirler. | |||
| ReceiveBufferSize bayt-sayısı | 0 | s | M |
| TCP alım tamponu boyu | |||
| Redirect [durum] [URL-yolu] URL | skdh | T | |
| İstemciyi, bir yönlendirme isteği döndürerek farklı bir URL’ye yönlendirir. | |||
| RedirectMatch [durum] düzenli-ifade URL | skdh | T | |
| Geçerli URL ile eşleşen bir düzenli ifadeye dayanarak bir harici yönlendirme gönderir. | |||
| RedirectPermanent URL-yolu URL | skdh | T | |
| İstemciyi, kalıcı bir yönlendirme isteği döndürerek farklı bir URL’ye yönlendirir. | |||
| RedirectRelative On|Off | Off | skd | T |
| Allows relative redirect targets. | |||
| RedirectTemp URL-yolu URL | skdh | T | |
| İstemciyi, geçici bir yönlendirme isteği döndürerek farklı bir URL’ye yönlendirir. | |||
| RedisConnPoolTTL num[units] | 15s | sk | E |
| TTL used for the connection pool with the Redis server(s) | |||
| RedisTimeout num[units] | 5s | sk | E |
| R/W timeout used for the connection with the Redis server(s) | |||
| ReflectorHeader inputheader [outputheader] | skdh | T | |
| Reflect an input header to the output headers | |||
RegexDefaultOptions [none] [+|-]seçenek [[+|-]seçenek] ... | DOTALL DOLLAR_ENDON + | s | Ç |
| Regex düzenli ifadeleri için öntanımlı/küresel seçenekleri yapılandırır | |||
RegisterHttpMethod yöntem [yöntem [...]] | s | Ç | |
| Standart olmayan HTTP yöntemlerini devreye alır | |||
| RemoteIPHeader header-field | sk | T | |
| Declare the header field which should be parsed for useragent IP addresses | |||
| RemoteIPInternalProxy proxy-ip|proxy-ip/subnet|hostname ... | sk | T | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPInternalProxyList filename | sk | T | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPProxiesHeader HeaderFieldName | sk | T | |
| Declare the header field which will record all intermediate IP addresses | |||
| RemoteIPProxyProtocol On|Off | sk | T | |
| Enable or disable PROXY protocol handling | |||
| RemoteIPProxyProtocolExceptions host|range [host|range] [host|range] | sk | T | |
| Disable processing of PROXY header for certain hosts or networks | |||
| RemoteIPTrustedProxy proxy-ip|proxy-ip/subnet|hostname ... | sk | T | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPTrustedProxyList filename | sk | T | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoveCharset extension [extension] ... | kdh | T | |
| Removes any character set associations for a set of file extensions | |||
| RemoveEncoding extension [extension] ... | kdh | T | |
| Removes any content encoding associations for a set of file extensions | |||
| RemoveHandler extension [extension] ... | kdh | T | |
| Removes any handler associations for a set of file extensions | |||
| RemoveInputFilter extension [extension] ... | kdh | T | |
| Removes any input filter associations for a set of file extensions | |||
| RemoveLanguage extension [extension] ... | kdh | T | |
| Removes any language associations for a set of file extensions | |||
| RemoveOutputFilter extension [extension] ... | kdh | T | |
| Removes any output filter associations for a set of file extensions | |||
| RemoveType extension [extension] ... | kdh | T | |
| Removes any content type associations for a set of file extensions | |||
| RequestHeader add|append|edit|edit*|merge|set|setifempty|unset header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] | skdh | E | |
| Configure HTTP request headers | |||
| RequestReadTimeout [handshake=timeout[-maxtimeout][,MinRate=rate] [header=timeout[-maxtimeout][,MinRate=rate] [body=timeout[-maxtimeout][,MinRate=rate] | handshake=0 header= + | sk | E |
| Set timeout values for completing the TLS handshake, receiving the request headers and/or body from client. | |||
| Require [not] entity-name [entity-name] ... | dh | T | |
| Tests whether an authenticated user is authorized by an authorization provider. | |||
| <RequireAll> ... </RequireAll> | dh | T | |
| Enclose a group of authorization directives of which none must fail and at least one must succeed for the enclosing directive to succeed. | |||
| <RequireAny> ... </RequireAny> | dh | T | |
| Enclose a group of authorization directives of which one must succeed for the enclosing directive to succeed. | |||
| <RequireNone> ... </RequireNone> | dh | T | |
| Enclose a group of authorization directives of which none must succeed for the enclosing directive to not fail. | |||
| RewriteBase URL-path | dh | E | |
| Sets the base URL for per-directory rewrites | |||
| RewriteCond TestString CondPattern [flags] | skdh | E | |
| Defines a condition under which rewriting will take place | |||
| RewriteEngine on|off | off | skdh | E |
| Enables or disables runtime rewriting engine | |||
| RewriteMap MapName MapType:MapSource [MapTypeOptions] | sk | E | |
| Defines a mapping function for key-lookup | |||
| RewriteOptions Options | skdh | E | |
| Sets some special options for the rewrite engine | |||
| RewriteRule Pattern Substitution [flags] | skdh | E | |
| Defines rules for the rewriting engine | |||
RLimitCPU saniye|max [saniye|max] | skdh | Ç | |
| Apache httpd alt süreçleri tarafından çalıştırılan süreçlerin işlemci tüketimine sınırlama getirir. | |||
RLimitMEM bayt-sayısı|max [bayt-sayısı|max]
| skdh | Ç | |
| Apache httpd alt süreçleri tarafından çalıştırılan süreçlerin bellek tüketimine sınırlama getirir. | |||
RLimitNPROC sayı|max [sayı|max] | skdh | Ç | |
| Apache httpd alt süreçleri tarafından çalıştırılabilecek süreç sayısına sınırlama getirir. | |||
| Satisfy Any|All | All | dh | E |
| Interaction between host-level access control and user authentication | |||
| ScoreBoardFile dosya-yolu | logs/apache_runtime + | s | M |
| Çocuk süreçler için eşgüdüm verisini saklamakta kullanılan dosyanın yerini belirler. | |||
| Script method cgi-script | skd | T | |
| Activates a CGI script for a particular request method. | |||
| ScriptAlias [URL-yolu] dosya-yolu|dizin-yolu | skd | T | |
| Bir URL’yi dosya sistemindeki bir yere eşler ve hedefi bir CGI betiği olarak çalıştırır. | |||
| ScriptAliasMatch düzenli-ifade dosya-yolu|dizin-yolu | sk | T | |
| Bir URL’yi dosya sistemindeki bir yere düzenli ifade kullanarak eşler ve hedefi bir CGI betiği olarak çalıştırır. | |||
| ScriptInterpreterSource Registry|Registry-Strict|Script | Script | skdh | Ç |
| CGI betikleri için yorumlayıcı belirleme tekniği | |||
| ScriptLog file-path | sk | T | |
| Location of the CGI script error logfile | |||
| ScriptLogBuffer bytes | 1024 | sk | T |
| Maximum amount of PUT or POST requests that will be recorded in the scriptlog | |||
| ScriptLogLength bytes | 10385760 | sk | T |
| Size limit of the CGI script logfile | |||
| ScriptSock file-path | cgisock | s | T |
| The filename prefix of the socket to use for communication with the cgi daemon | |||
| SecureListen [IP-address:]portnumber Certificate-Name [MUTUAL] | s | T | |
| Enables SSL encryption for the specified port | |||
| SeeRequestTail On|Off | Off | s | Ç |
| İsteğin 63 karakterden büyük olduğu varsayımıyla, mod_status'un ilk 63 karakteri mi yoksa son 63 karakteri mi göstereceğini belirler. | |||
| SendBufferSize bayt-sayısı | 0 | s | M |
| TCP tamponu boyu | |||
ServerAdmin eposta-adresi|URL | sk | Ç | |
| Sunucunun hata iletilerinde istemciye göstereceği eposta adresi | |||
ServerAlias konakadı [konakadı] ... | k | Ç | |
| İstekleri isme dayalı sanal konaklarla eşleştirilirken kullanılacak konak adları için başka isimler belirtebilmeyi sağlar. | |||
| ServerLimit sayı | s | M | |
| Ayarlanabilir süreç sayısının üst sınırını belirler. | |||
ServerName [şema://]alan-adı|ip-adresi[:port]
| sk | Ç | |
| Sunucunun özdeşleşeceği konak ismi ve port. | |||
ServerPath URL-yolu | k | Ç | |
| Uyumsuz bir tarayıcı tarafından erişilmesi için bir isme dayalı sanal konak için meşru URL yolu | |||
ServerRoot dizin-yolu | /usr/local/apache | s | Ç |
| Sunucu yapılandırması için kök dizin | |||
| ServerSignature On|Off|EMail | Off | skdh | Ç |
| Sunucu tarafından üretilen belgelerin dipnotunu ayarlar. | |||
| ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full | Full | s | Ç |
Server HTTP yanıt başlığını yapılandırır.
| |||
| Session On|Off | Off | skdh | E |
| Enables a session for the current directory or location | |||
| SessionCookieName name attributes | skdh | E | |
| Name and attributes for the RFC2109 cookie storing the session | |||
| SessionCookieName2 name attributes | skdh | E | |
| Name and attributes for the RFC2965 cookie storing the session | |||
| SessionCookieRemove On|Off | Off | skdh | E |
| Control for whether session cookies should be removed from incoming HTTP headers | |||
| SessionCryptoCipher name | aes256 | skdh | D |
| The crypto cipher to be used to encrypt the session | |||
| SessionCryptoDriver name [param[=value]] | s | D | |
| The crypto driver to be used to encrypt the session | |||
| SessionCryptoPassphrase secret [ secret ... ] | skdh | D | |
| The key used to encrypt the session | |||
| SessionCryptoPassphraseFile filename | skd | D | |
| File containing keys used to encrypt the session | |||
| SessionDBDCookieName name attributes | skdh | E | |
| Name and attributes for the RFC2109 cookie storing the session ID | |||
| SessionDBDCookieName2 name attributes | skdh | E | |
| Name and attributes for the RFC2965 cookie storing the session ID | |||
| SessionDBDCookieRemove On|Off | On | skdh | E |
| Control for whether session ID cookies should be removed from incoming HTTP headers | |||
| SessionDBDDeleteLabel label | deletesession | skdh | E |
| The SQL query to use to remove sessions from the database | |||
| SessionDBDInsertLabel label | insertsession | skdh | E |
| The SQL query to use to insert sessions into the database | |||
| SessionDBDPerUser On|Off | Off | skdh | E |
| Enable a per user session | |||
| SessionDBDSelectLabel label | selectsession | skdh | E |
| The SQL query to use to select sessions from the database | |||
| SessionDBDUpdateLabel label | updatesession | skdh | E |
| The SQL query to use to update existing sessions in the database | |||
| SessionEnv On|Off | Off | skdh | E |
| Control whether the contents of the session are written to the HTTP_SESSION environment variable | |||
| SessionExclude path | skdh | E | |
| Define URL prefixes for which a session is ignored | |||
| SessionExpiryUpdateInterval interval | 0 (always update) | skdh | E |
| Define the number of seconds a session's expiry may change without the session being updated | |||
| SessionHeader header | skdh | E | |
| Import session updates from a given HTTP response header | |||
| SessionInclude path | skdh | E | |
| Define URL prefixes for which a session is valid | |||
| SessionMaxAge maxage | 0 | skdh | E |
| Define a maximum age in seconds for a session | |||
| SetEnv ortam-değişkeni [değer] | skdh | T | |
| Ortam değişkenlerini tanımlar. | |||
| SetEnvIf öznitelik düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ... | skdh | T | |
| Ortam değişkenlerini isteğin özniteliklerine göre atar. | |||
| SetEnvIfExpr ifade [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ... | skdh | T | |
| Bir ap_expr ifadesine dayanarak ortam değişkenlerine değer atar | |||
| SetEnvIfNoCase öznitelik düzifd [!]ort-değişkeni[=değer] [[!]ort-değişkeni[=değer]] ... | skdh | T | |
| Ortam değişkenlerini isteğin özniteliklerinde harf büyüklüğüne bağlı olmaksızın yapılmış tanımlara göre atar. | |||
SetHandler eylemci-ismi|none|ifade | skdh | Ç | |
| Eşleşen tüm dosyaların belli bir eylemci tarafından işlenmesine sebep olur. | |||
SetInputFilter süzgeç[;süzgeç...] | skdh | Ç | |
| POST girdilerini ve istemci isteklerini işleyecek süzgeçleri belirler. | |||
SetOutputFilter süzgeç[;süzgeç...] | skdh | Ç | |
| Sunucunun yanıtlarını işleyecek süzgeçleri belirler. | |||
| SSIEndTag tag | "-->" | sk | T |
| String that ends an include element | |||
| SSIErrorMsg message | "[an error occurred + | skdh | T |
| Error message displayed when there is an SSI error | |||
| SSIETag on|off | off | dh | T |
| Controls whether ETags are generated by the server. | |||
| SSILastModified on|off | off | dh | T |
Controls whether Last-Modified headers are generated by the
server. | |||
| SSILegacyExprParser on|off | off | dh | T |
| Enable compatibility mode for conditional expressions. | |||
| SSIStartTag tag | "<!--#" | sk | T |
| String that starts an include element | |||
| SSITimeFormat formatstring | "%A, %d-%b-%Y %H:%M + | skdh | T |
| Configures the format in which date strings are displayed | |||
| SSIUndefinedEcho string | "(none)" | skdh | T |
| String displayed when an unset variable is echoed | |||
| SSLCACertificateFile file-path | sk | E | |
| File of concatenated PEM-encoded CA Certificates for Client Auth | |||
| SSLCACertificatePath directory-path | sk | E | |
| Directory of PEM-encoded CA Certificates for Client Auth | |||
| SSLCADNRequestFile file-path | sk | E | |
| File of concatenated PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCADNRequestPath directory-path | sk | E | |
| Directory of PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCARevocationCheck chain|leaf|none [flags ...] | none | sk | E |
| Enable CRL-based revocation checking | |||
| SSLCARevocationFile file-path | sk | E | |
| File of concatenated PEM-encoded CA CRLs for Client Auth | |||
| SSLCARevocationPath directory-path | sk | E | |
| Directory of PEM-encoded CA CRLs for Client Auth | |||
| SSLCertificateChainFile file-path | sk | E | |
| File of PEM-encoded Server CA Certificates | |||
| SSLCertificateFile file-path|certid | sk | E | |
| Server PEM-encoded X.509 certificate data file or token identifier | |||
| SSLCertificateKeyFile file-path|keyid | sk | E | |
| Server PEM-encoded private key file | |||
| SSLCipherSuite [protocol] cipher-spec | DEFAULT (depends on + | skdh | E |
| Cipher Suite available for negotiation in SSL handshake | |||
| SSLCompression on|off | off | sk | E |
| Enable compression on the SSL level | |||
| SSLCryptoDevice engine | builtin | s | E |
| Enable use of a cryptographic hardware accelerator | |||
| SSLEngine on|off|optional | off | sk | E |
| SSL Engine Operation Switch | |||
| SSLFIPS on|off | off | s | E |
| SSL FIPS mode Switch | |||
| SSLHonorCipherOrder on|off | off | sk | E |
| Option to prefer the server's cipher preference order | |||
| SSLInsecureRenegotiation on|off | off | sk | E |
| Option to enable support for insecure renegotiation | |||
| SSLOCSPDefaultResponder uri | sk | E | |
| Set the default responder URI for OCSP validation | |||
| SSLOCSPEnable on|leaf|off | off | sk | E |
| Enable OCSP validation of the client certificate chain | |||
| SSLOCSPNoverify on|off | off | sk | E |
| skip the OCSP responder certificates verification | |||
| SSLOCSPOverrideResponder on|off | off | sk | E |
| Force use of the default responder URI for OCSP validation | |||
| SSLOCSPProxyURL url | sk | E | |
| Proxy URL to use for OCSP requests | |||
| SSLOCSPResponderCertificateFile file | sk | E | |
| Set of trusted PEM encoded OCSP responder certificates | |||
| SSLOCSPResponderTimeout seconds | 10 | sk | E |
| Timeout for OCSP queries | |||
| SSLOCSPResponseMaxAge seconds | -1 | sk | E |
| Maximum allowable age for OCSP responses | |||
| SSLOCSPResponseTimeSkew seconds | 300 | sk | E |
| Maximum allowable time skew for OCSP response validation | |||
| SSLOCSPUseRequestNonce on|off | on | sk | E |
| Use a nonce within OCSP queries | |||
| SSLOpenSSLConfCmd command-name command-value | sk | E | |
| Configure OpenSSL parameters through its SSL_CONF API | |||
| SSLOptions [+|-]option ... | skdh | E | |
| Configure various SSL engine run-time options | |||
| SSLPassPhraseDialog type | builtin | s | E |
| Type of pass phrase dialog for encrypted private keys | |||
| SSLProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | sk | E |
| Configure usable SSL/TLS protocol versions | |||
| SSLProxyCACertificateFile file-path | skv | E | |
| File of concatenated PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCACertificatePath directory-path | skv | E | |
| Directory of PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCARevocationCheck chain|leaf|none | none | skv | E |
| Enable CRL-based revocation checking for Remote Server Auth | |||
| SSLProxyCARevocationFile file-path | skv | E | |
| File of concatenated PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCARevocationPath directory-path | skv | E | |
| Directory of PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCheckPeerCN on|off | on | skv | E |
| Whether to check the remote server certificate's CN field | |||
| SSLProxyCheckPeerExpire on|off | on | skv | E |
| Whether to check if remote server certificate is expired | |||
| SSLProxyCheckPeerName on|off | on | skv | E |
| Configure host name checking for remote server certificates | |||
| SSLProxyCipherSuite [protocol] cipher-spec | ALL:!ADH:RC4+RSA:+H + | skv | E |
| Cipher Suite available for negotiation in SSL proxy handshake | |||
| SSLProxyEngine on|off | off | skv | E |
| SSL Proxy Engine Operation Switch | |||
| SSLProxyMachineCertificateChainFile filename | skv | E | |
| File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate | |||
| SSLProxyMachineCertificateFile filename | skv | E | |
| File of concatenated PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyMachineCertificatePath directory | skv | E | |
| Directory of PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | skv | E |
| Configure usable SSL protocol flavors for proxy usage | |||
| SSLProxyVerify level | none | skv | E |
| Type of remote server Certificate verification | |||
| SSLProxyVerifyDepth number | 1 | skv | E |
| Maximum depth of CA Certificates in Remote Server Certificate verification | |||
| SSLRandomSeed context source [bytes] | s | E | |
| Pseudo Random Number Generator (PRNG) seeding source | |||
| SSLRenegBufferSize bytes | 131072 | dh | E |
| Set the size for the SSL renegotiation buffer | |||
| SSLRequire expression | dh | E | |
| Allow access only when an arbitrarily complex boolean expression is true | |||
| SSLRequireSSL | dh | E | |
| Deny access when SSL is not used for the HTTP request | |||
| SSLSessionCache type | none | s | E |
| Type of the global/inter-process SSL Session Cache | |||
| SSLSessionCacheTimeout seconds | 300 | sk | E |
| Number of seconds before an SSL session expires in the Session Cache | |||
| SSLSessionTicketKeyFile file-path | sk | E | |
| Persistent encryption/decryption key for TLS session tickets | |||
| SSLSessionTickets on|off | on | sk | E |
| Enable or disable use of TLS session tickets | |||
| SSLSRPUnknownUserSeed secret-string | sk | E | |
| SRP unknown user seed | |||
| SSLSRPVerifierFile file-path | sk | E | |
| Path to SRP verifier file | |||
| SSLStaplingCache type | s | E | |
| Configures the OCSP stapling cache | |||
| SSLStaplingErrorCacheTimeout seconds | 600 | sk | E |
| Number of seconds before expiring invalid responses in the OCSP stapling cache | |||
| SSLStaplingFakeTryLater on|off | on | sk | E |
| Synthesize "tryLater" responses for failed OCSP stapling queries | |||
| SSLStaplingForceURL uri | sk | E | |
| Override the OCSP responder URI specified in the certificate's AIA extension | |||
| SSLStaplingResponderTimeout seconds | 10 | sk | E |
| Timeout for OCSP stapling queries | |||
| SSLStaplingResponseMaxAge seconds | -1 | sk | E |
| Maximum allowable age for OCSP stapling responses | |||
| SSLStaplingResponseTimeSkew seconds | 300 | sk | E |
| Maximum allowable time skew for OCSP stapling response validation | |||
| SSLStaplingReturnResponderErrors on|off | on | sk | E |
| Pass stapling related OCSP errors on to client | |||
| SSLStaplingStandardCacheTimeout seconds | 3600 | sk | E |
| Number of seconds before expiring responses in the OCSP stapling cache | |||
| SSLStrictSNIVHostCheck on|off | off | sk | E |
| Whether to allow non-SNI clients to access a name-based virtual host. | |||
| SSLUserName varname | sdh | E | |
| Variable name to determine user name | |||
| SSLUseStapling on|off | off | sk | E |
| Enable stapling of OCSP responses in the TLS handshake | |||
| SSLVerifyClient level | none | skdh | E |
| Type of Client Certificate verification | |||
| SSLVerifyDepth number | 1 | skdh | E |
| Maximum depth of CA Certificates in Client Certificate verification | |||
| StartServers sayı | s | M | |
| Sunucunun başlatılması sırasında oluşturulan çocuk süreçlerin sayısını belirler. | |||
| StartThreads sayı | s | M | |
| Sunucunun başlatılması sırasında oluşturulan evrelerin sayısını belirler. | |||
| StrictHostCheck ON|OFF | OFF | sk | Ç |
| Sunucunun, istenen konak adının, isteği işleyen sanal konakta listelenmesini gerektirip gerektirmediğini denetler | |||
| Substitute s/pattern/substitution/[infq] | dh | E | |
| Pattern to filter the response content | |||
| SubstituteInheritBefore on|off | off | dh | E |
| Change the merge order of inherited patterns | |||
| SubstituteMaxLineLength bytes(b|B|k|K|m|M|g|G) | 1m | dh | E |
| Set the maximum line size | |||
| Suexec On|Off | s | T | |
| suEXEC özelliğini etkin veya etkisiz yapar | |||
| SuexecUserGroup Kullanıcı Grup | sk | E | |
| CGI betiklerini çalıştıracak kullanıcı ve grup belirtilir. | |||
| ThreadLimit sayı | s | M | |
| Çocuk süreç başına ayarlanabilir evre sayısının üst sınırını belirler. | |||
| ThreadsPerChild sayı | s | M | |
| Her çocuk süreç tarafından oluşturulan evrelerin sayısını belirler. | |||
| ThreadStackSize boyut | s | M | |
| İstemci bağlantılarını elde eden evreler tarafından kullanılan yığıtın bayt cinsinden uzunluğunu belirler. | |||
TimeOut saniye | 60 | sk | Ç |
| Bir istek için başarısız olmadan önce belirli olayların gerçekleşmesi için sunucunun geçmesini bekleyeceği süre. | |||
TraceEnable [on|off|extended] | on | sk | Ç |
TRACE isteklerinde davranış şeklini belirler
| |||
| TransferLog dosya|borulu-süreç [takma-ad] | sk | T | |
| Bir günlük dosyasının yerini belirtir. | |||
| TypesConfig file-path | conf/mime.types | s | T |
The location of the mime.types file | |||
| UNCList hostname [hostname...] | s | Ç | |
| Controls what UNC host names can be accessed by the server | |||
UnDefine değişken-ismi | s | Ç | |
| Bir değişkeni tanımsız yapar | |||
| UndefMacro name | skd | T | |
| Undefine a macro | |||
| UnsetEnv ortam-değişkeni [ortam-değişkeni] ... | skdh | T | |
| Ortamdaki değişkenleri tanımsız hale getirir. | |||
| Use name [value1 ... valueN] | skd | T | |
| Use a macro | |||
| UseCanonicalName On|Off|DNS | Off | skd | Ç |
| Sunucunun kendi adını ve portunu nasıl belirleyeceğini ayarlar | |||
| UseCanonicalPhysicalPort On|Off | Off | skd | Ç |
| Sunucunun kendi adını ve portunu nasıl belirleyeceğini ayarlar | |||
| User unix-kullanıcısı | #-1 | s | T |
| İsteklere yanıt verecek sunucunun ait olacağı kullanıcıyı belirler. | |||
| UserDir dizin [dizin] ... | sk | T | |
| Kullanıcıya özel dizinlerin yeri | |||
| VHostCGIMode On|Off|Secure | On | k | D |
| Determines whether the virtualhost can run subprocesses, and the privileges available to subprocesses. | |||
| VHostCGIPrivs [+-]?privilege-name [[+-]?privilege-name] ... | k | D | |
| Assign arbitrary privileges to subprocesses created by a virtual host. | |||
| VHostGroup unix-groupid | k | D | |
| Sets the Group ID under which a virtual host runs. | |||
| VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ... | k | D | |
| Assign arbitrary privileges to a virtual host. | |||
| VHostSecure On|Off | On | k | D |
| Determines whether the server runs with enhanced security for the virtualhost. | |||
| VHostUser unix-userid | k | D | |
| Sets the User ID under which a virtual host runs. | |||
| VirtualDocumentRoot hesaplanan-dizin|none | none | sk | E |
| Bir sanal konağın belge kök dizinini devingen olarak yapılandırır. | |||
| VirtualDocumentRootIP hesaplanan-dizin|none | none | sk | E |
| Bir sanal konağın belge kök dizinini devingen olarak yapılandırır. | |||
<VirtualHost
adres[:port] [adres[:port]]
...> ... </VirtualHost> | s | Ç | |
| Sadece belli bir konak ismine ve porta uygulanacak yönergeleri barındırır. | |||
| VirtualScriptAlias hesaplanan-dizin|none | none | sk | E |
| Bir sanal konağın CGI dizinini devingen olarak yapılandırır. | |||
| VirtualScriptAliasIP hesaplanan-dizin|none | none | sk | E |
| Bir sanal konağın CGI dizinini devingen olarak yapılandırır. | |||
| WatchdogInterval time-interval[s] | 1 | s | T |
| Watchdog interval in seconds | |||
| XBitHack on|off|full | off | skdh | T |
| Parse SSI directives in files with the execute bit set | |||
| xml2EncAlias charset alias [alias ...] | s | T | |
| Recognise Aliases for encoding values | |||
| xml2EncDefault name | skdh | T | |
| Sets a default encoding to assume when absolutely no information can be automatically detected | |||
| xml2StartParse element [element ...] | skdh | T | |
| Advise the parser to skip leading junk. | |||
Apache HTTP 服务器版本 2.4
指令快速索引显示指令的用法，默认值，状态和上下文。要获得更多信息，请参见 描述指令的术语。
第一列给出指令的名称与用法。第二列显示指令的默认值(如果有的话)。 如果因为默认值太长而被截断显示，会在最后一个字符之后显示字符 “+”。
第三列显示允许此指令的上下文，第四列显示指令的状态。
| A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X |
|
|
| AcceptFilter protocol accept_filter | s | C | |
| Configures optimizations for a Protocol's Listener Sockets | |||
| AcceptPathInfo On|Off|Default | Default | svdh | C |
| Resources accept trailing pathname information | |||
| AccessFileName filename [filename] ... | .htaccess | sv | C |
| Name of the distributed configuration file | |||
| Action action-type cgi-script [virtual] | svdh | B | |
| Activates a CGI script for a particular handler or content-type | |||
| AddAlt string file [file] ... | svdh | B | |
| Alternate text to display for a file, instead of an icon selected by filename | |||
| AddAltByEncoding string MIME-encoding [MIME-encoding] ... | svdh | B | |
| Alternate text to display for a file instead of an icon selected by MIME-encoding | |||
| AddAltByType string MIME-type [MIME-type] ... | svdh | B | |
| Alternate text to display for a file, instead of an icon selected by MIME content-type | |||
| AddCharset charset extension [extension] ... | svdh | B | |
| Maps the given filename extensions to the specified content charset | |||
| AddDefaultCharset On|Off|charset | Off | svdh | C |
Default charset parameter to be added when a response
content-type is text/plain or text/html | |||
| AddDescription string file [file] ... | svdh | B | |
| Description to display for a file | |||
| AddEncoding encoding extension [extension] ... | svdh | B | |
| Maps the given filename extensions to the specified encoding type | |||
| AddHandler handler-name extension [extension] ... | svdh | B | |
| Maps the filename extensions to the specified handler | |||
| AddIcon icon name [name] ... | svdh | B | |
| Icon to display for a file selected by name | |||
| AddIconByEncoding icon MIME-encoding [MIME-encoding] ... | svdh | B | |
| Icon to display next to files selected by MIME content-encoding | |||
| AddIconByType icon MIME-type [MIME-type] ... | svdh | B | |
| Icon to display next to files selected by MIME content-type | |||
| AddInputFilter filter[;filter...] extension [extension] ... | svdh | B | |
| Maps filename extensions to the filters that will process client requests | |||
| AddLanguage language-tag extension [extension] ... | svdh | B | |
| Maps the given filename extension to the specified content language | |||
| AddModuleInfo module-name string | sv | E | |
| Adds additional information to the module information displayed by the server-info handler | |||
| AddOutputFilter filter[;filter...] extension [extension] ... | svdh | B | |
| Maps filename extensions to the filters that will process responses from the server | |||
| AddOutputFilterByType filter[;filter...] media-type [media-type] ... | svdh | B | |
| assigns an output filter to a particular media-type | |||
| AddType media-type extension [extension] ... | svdh | B | |
| Maps the given filename extensions onto the specified content type | |||
| Alias [URL-path] file-path|directory-path | svd | B | |
| Maps URLs to filesystem locations | |||
| AliasMatch regex file-path|directory-path | sv | B | |
| Maps URLs to filesystem locations using regular expressions | |||
| AliasPreservePath OFF|ON | OFF | svd | B |
| Map the full path after the alias in a location. | |||
| Allow from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts can access an area of the server | |||
| AllowCONNECT port[-port] [port[-port]] ... | 443 563 | sv | E |
Ports that are allowed to CONNECT through the
proxy | |||
| AllowEncodedSlashes On|Off|NoDecode | Off | sv | C |
| Determines whether encoded path separators in URLs are allowed to be passed through | |||
| AllowMethods reset|HTTP-method [HTTP-method]... | reset | d | X |
| Restrict access to the listed HTTP methods | |||
| AllowOverride All|None|directive-type [directive-type] ... | None (2.3.9 and lat + | d | C |
Types of directives that are allowed in
.htaccess files | |||
| AllowOverrideList None|directive [directive-type] ... | None | d | C |
Individual directives that are allowed in
.htaccess files | |||
| Anonymous user [user] ... | dh | E | |
| Specifies userIDs that are allowed access without password verification | |||
| Anonymous_LogEmail On|Off | On | dh | E |
| Sets whether the password entered will be logged in the error log | |||
| Anonymous_MustGiveEmail On|Off | On | dh | E |
| Specifies whether blank passwords are allowed | |||
| Anonymous_NoUserID On|Off | Off | dh | E |
| Sets whether the userID field may be empty | |||
| Anonymous_VerifyEmail On|Off | Off | dh | E |
| Sets whether to check the password field for a correctly formatted email address | |||
| AsyncRequestWorkerFactor factor | s | M | |
| Limit concurrent connections per process | |||
| AuthBasicAuthoritative On|Off | On | dh | B |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthBasicFake off|username [password] | dh | B | |
| Fake basic authentication using the given expressions for username and password | |||
| AuthBasicProvider provider-name [provider-name] ... | file | dh | B |
| Sets the authentication provider(s) for this location | |||
| AuthBasicUseDigestAlgorithm MD5|Off | Off | dh | B |
| Check passwords against the authentication providers as if Digest Authentication was in force instead of Basic Authentication. | |||
| AuthDBDUserPWQuery query | d | E | |
| SQL query to look up a password for a user | |||
| AuthDBDUserRealmQuery query | d | E | |
| SQL query to look up a password hash for a user and realm. | |||
| AuthDBMGroupFile file-path | dh | E | |
| Sets the name of the database file containing the list of user groups for authorization | |||
| AuthDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Sets the type of database file that is used to store passwords | |||
| AuthDBMUserFile file-path | dh | E | |
| Sets the name of a database file containing the list of users and passwords for authentication | |||
| AuthDigestAlgorithm MD5|MD5-sess | MD5 | dh | E |
| Selects the algorithm used to calculate the challenge and response hashes in digest authentication | |||
| AuthDigestDomain URI [URI] ... | dh | E | |
| URIs that are in the same protection space for digest authentication | |||
| AuthDigestNonceLifetime seconds | 300 | dh | E |
| How long the server nonce is valid | |||
| AuthDigestProvider provider-name [provider-name] ... | file | dh | E |
| Sets the authentication provider(s) for this location | |||
| AuthDigestQop none|auth|auth-int [auth|auth-int] | auth | dh | E |
| Determines the quality-of-protection to use in digest authentication | |||
| AuthDigestShmemSize size | 1000 | s | E |
| The amount of shared memory to allocate for keeping track of clients | |||
| AuthFormAuthoritative On|Off | On | dh | B |
| Sets whether authorization and authentication are passed to lower level modules | |||
| AuthFormBody fieldname | httpd_body | d | B |
| The name of a form field carrying the body of the request to attempt on successful login | |||
| AuthFormDisableNoStore On|Off | Off | d | B |
| Disable the CacheControl no-store header on the login page | |||
| AuthFormFakeBasicAuth On|Off | Off | d | B |
| Fake a Basic Authentication header | |||
| AuthFormLocation fieldname | httpd_location | d | B |
| The name of a form field carrying a URL to redirect to on successful login | |||
| AuthFormLoginRequiredLocation url | d | B | |
| The URL of the page to be redirected to should login be required | |||
| AuthFormLoginSuccessLocation url | d | B | |
| The URL of the page to be redirected to should login be successful | |||
| AuthFormLogoutLocation uri | d | B | |
| The URL to redirect to after a user has logged out | |||
| AuthFormMethod fieldname | httpd_method | d | B |
| The name of a form field carrying the method of the request to attempt on successful login | |||
| AuthFormMimetype fieldname | httpd_mimetype | d | B |
| The name of a form field carrying the mimetype of the body of the request to attempt on successful login | |||
| AuthFormPassword fieldname | httpd_password | d | B |
| The name of a form field carrying the login password | |||
| AuthFormProvider provider-name [provider-name] ... | file | dh | B |
| Sets the authentication provider(s) for this location | |||
| AuthFormSitePassphrase secret | d | B | |
| Bypass authentication checks for high traffic sites | |||
| AuthFormSize size | 8192 | d | B |
| The largest size of the form in bytes that will be parsed for the login details | |||
| AuthFormUsername fieldname | httpd_username | d | B |
| The name of a form field carrying the login username | |||
| AuthGroupFile file-path | dh | B | |
| Sets the name of a text file containing the list of user groups for authorization | |||
| AuthLDAPAuthorizePrefix prefix | AUTHORIZE_ | dh | E |
| Specifies the prefix for environment variables set during authorization | |||
| AuthLDAPBindAuthoritative off|on | on | dh | E |
| Determines if other authentication providers are used when a user can be mapped to a DN but the server cannot successfully bind with the user's credentials. | |||
| AuthLDAPBindDN distinguished-name | dh | E | |
| Optional DN to use in binding to the LDAP server | |||
| AuthLDAPBindPassword password | dh | E | |
| Password used in conjunction with the bind DN | |||
| AuthLDAPCharsetConfig file-path | s | E | |
| Language to charset conversion configuration file | |||
| AuthLDAPCompareAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization comparisons | |||
| AuthLDAPCompareDNOnServer on|off | on | dh | E |
| Use the LDAP server to compare the DNs | |||
| AuthLDAPDereferenceAliases never|searching|finding|always | always | dh | E |
| When will the module de-reference aliases | |||
| AuthLDAPGroupAttribute attribute | member uniqueMember + | dh | E |
| LDAP attributes used to identify the user members of groups. | |||
| AuthLDAPGroupAttributeIsDN on|off | on | dh | E |
| Use the DN of the client username when checking for group membership | |||
| AuthLDAPInitialBindAsUser off|on | off | dh | E |
| Determines if the server does the initial DN lookup using the basic authentication users' own username, instead of anonymously or with hard-coded credentials for the server | |||
| AuthLDAPInitialBindPattern regex substitution | (.*) $1 (remote use + | dh | E |
| Specifies the transformation of the basic authentication username to be used when binding to the LDAP server to perform a DN lookup | |||
| AuthLDAPMaxSubGroupDepth Number | 10 | dh | E |
| Specifies the maximum sub-group nesting depth that will be evaluated before the user search is discontinued. | |||
| AuthLDAPRemoteUserAttribute uid | dh | E | |
| Use the value of the attribute returned during the user query to set the REMOTE_USER environment variable | |||
| AuthLDAPRemoteUserIsDN on|off | off | dh | E |
| Use the DN of the client username to set the REMOTE_USER environment variable | |||
| AuthLDAPSearchAsUser on|off | off | dh | E |
| Use the authenticated user's credentials to perform authorization searches | |||
| AuthLDAPSubGroupAttribute attribute | member uniqueMember + | dh | E |
| Specifies the attribute labels, one value per directive line, used to distinguish the members of the current group that are groups. | |||
| AuthLDAPSubGroupClass LdapObjectClass | groupOfNames groupO + | dh | E |
| Specifies which LDAP objectClass values identify directory objects that are groups during sub-group processing. | |||
| AuthLDAPURL url [NONE|SSL|TLS|STARTTLS] | dh | E | |
| URL specifying the LDAP search parameters | |||
| AuthMerging Off | And | Or | Off | dh | B |
| Controls the manner in which each configuration section's authorization logic is combined with that of preceding configuration sections. | |||
| AuthName auth-domain | dh | B | |
| Authorization realm for use in HTTP authentication | |||
| AuthnCacheContext directory|server|custom-string | directory | d | B |
| Specify a context string for use in the cache key | |||
| AuthnCacheEnable | s | B | |
| Enable Authn caching configured anywhere | |||
| AuthnCacheProvideFor authn-provider [...] | dh | B | |
| Specify which authn provider(s) to cache for | |||
| AuthnCacheSOCache provider-name[:provider-args] | s | B | |
| Select socache backend provider to use | |||
| AuthnCacheTimeout timeout (seconds) | 300 (5 minutes) | dh | B |
| Set a timeout for cache entries | |||
| <AuthnProviderAlias baseProvider Alias> ... </AuthnProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authentication provider and referenced by the specified alias | |||
AuthnzFcgiCheckAuthnProvider provider-name|None
option ... | d | E | |
| Enables a FastCGI application to handle the check_authn authentication hook. | |||
| AuthnzFcgiDefineProvider type provider-name backend-address | s | E | |
| Defines a FastCGI application as a provider for authentication and/or authorization | |||
| AuthType None|Basic|Digest|Form | dh | B | |
| Type of user authentication | |||
| AuthUserFile file-path | dh | B | |
| Sets the name of a text file containing the list of users and passwords for authentication | |||
| AuthzDBDLoginToReferer On|Off | Off | d | E |
Determines whether to redirect the Client to the Referring
page on successful login or logout if a Referer request
header is present | |||
| AuthzDBDQuery query | d | E | |
| Specify the SQL Query for the required operation | |||
| AuthzDBDRedirectQuery query | d | E | |
| Specify a query to look up a login page for the user | |||
| AuthzDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Sets the type of database file that is used to store list of user groups | |||
| <AuthzProviderAlias baseProvider Alias Require-Parameters> ... </AuthzProviderAlias> | s | B | |
| Enclose a group of directives that represent an extension of a base authorization provider and referenced by the specified alias | |||
| AuthzSendForbiddenOnFailure On|Off | Off | dh | B |
| Send '403 FORBIDDEN' instead of '401 UNAUTHORIZED' if authentication succeeds but authorization fails | |||
| BalancerGrowth # | 5 | sv | E |
| Number of additional Balancers that can be added Post-configuration | |||
| BalancerInherit On|Off | On | sv | E |
| Inherit ProxyPassed Balancers/Workers from the main server | |||
| BalancerMember [balancerurl] url [key=value [key=value ...]] | d | E | |
| Add a member to a load balancing group | |||
| BalancerPersist On|Off | Off | sv | E |
| Attempt to persist changes made by the Balancer Manager across restarts. | |||
| BrotliAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| BrotliCompressionMaxInputBlock value | sv | E | |
| Maximum input block size | |||
| BrotliCompressionQuality value | 5 | sv | E |
| Compression quality | |||
| BrotliCompressionWindow value | 18 | sv | E |
| Brotli sliding compression window size | |||
| BrotliFilterNote [type] notename | sv | E | |
| Places the compression ratio in a note for logging | |||
| BrowserMatch regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables conditional on HTTP User-Agent | |||
| BrowserMatchNoCase regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables conditional on User-Agent without respect to case | |||
| BufferedLogs On|Off | Off | s | B |
| Buffer log entries in memory before writing to disk | |||
| BufferSize integer | 131072 | svdh | E |
| Maximum size in bytes to buffer by the buffer filter | |||
| CacheDefaultExpire seconds | 3600 (one hour) | svdh | E |
| The default duration to cache a document when no expiry date is specified. | |||
| CacheDetailHeader on|off | off | svdh | E |
| Add an X-Cache-Detail header to the response. | |||
| CacheDirLength length | 2 | sv | E |
| The number of characters in subdirectory names | |||
| CacheDirLevels levels | 2 | sv | E |
| The number of levels of subdirectories in the cache. | |||
| CacheDisable url-string | on | svdh | E | |
| Disable caching of specified URLs | |||
| CacheEnable cache_type [url-string] | svd | E | |
| Enable caching of specified URLs using a specified storage manager | |||
| CacheFile file-path [file-path] ... | s | X | |
| Cache a list of file handles at startup time | |||
| CacheHeader on|off | off | svdh | E |
| Add an X-Cache header to the response. | |||
| CacheIgnoreCacheControl On|Off | Off | sv | E |
| Ignore request to not serve cached content to client | |||
| CacheIgnoreHeaders header-string [header-string] ... | None | sv | E |
| Do not store the given HTTP header(s) in the cache. | |||
| CacheIgnoreNoLastMod On|Off | Off | svdh | E |
| Ignore the fact that a response has no Last Modified header. | |||
| CacheIgnoreQueryString On|Off | Off | sv | E |
| Ignore query string when caching | |||
| CacheIgnoreURLSessionIdentifiers identifier [identifier] ... | None | sv | E |
| Ignore defined session identifiers encoded in the URL when caching | |||
| CacheKeyBaseURL URL | sv | E | |
| Override the base URL of reverse proxied cache keys. | |||
| CacheLastModifiedFactor float | 0.1 | svdh | E |
| The factor used to compute an expiry date based on the LastModified date. | |||
| CacheLock on|off | off | sv | E |
| Enable the thundering herd lock. | |||
| CacheLockMaxAge integer | 5 | sv | E |
| Set the maximum possible age of a cache lock. | |||
| CacheLockPath directory | /tmp/mod_cache-lock + | sv | E |
| Set the lock path directory. | |||
| CacheMaxExpire seconds | 86400 (one day) | svdh | E |
| The maximum time in seconds to cache a document | |||
| CacheMaxFileSize bytes | 1000000 | svdh | E |
| The maximum size (in bytes) of a document to be placed in the cache | |||
| CacheMinExpire seconds | 0 | svdh | E |
| The minimum time in seconds to cache a document | |||
| CacheMinFileSize bytes | 1 | svdh | E |
| The minimum size (in bytes) of a document to be placed in the cache | |||
| CacheNegotiatedDocs On|Off | Off | sv | B |
| Allows content-negotiated documents to be cached by proxy servers | |||
| CacheQuickHandler on|off | on | sv | E |
| Run the cache from the quick handler. | |||
| CacheReadSize bytes | 0 | svdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheReadTime milliseconds | 0 | svdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheRoot directory | sv | E | |
| The directory root under which cache files are stored | |||
| CacheSocache type[:args] | sv | E | |
| The shared object cache implementation to use | |||
| CacheSocacheMaxSize bytes | 102400 | svdh | E |
| The maximum size (in bytes) of an entry to be placed in the cache | |||
| CacheSocacheMaxTime seconds | 86400 | svdh | E |
| The maximum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheMinTime seconds | 600 | svdh | E |
| The minimum time (in seconds) for a document to be placed in the cache | |||
| CacheSocacheReadSize bytes | 0 | svdh | E |
| The minimum size (in bytes) of the document to read and be cached before sending the data downstream | |||
| CacheSocacheReadTime milliseconds | 0 | svdh | E |
| The minimum time (in milliseconds) that should elapse while reading before data is sent downstream | |||
| CacheStaleOnError on|off | on | svdh | E |
| Serve stale content in place of 5xx responses. | |||
| CacheStoreExpired On|Off | Off | svdh | E |
| Attempt to cache responses that the server reports as expired | |||
| CacheStoreNoStore On|Off | Off | svdh | E |
| Attempt to cache requests or responses that have been marked as no-store. | |||
| CacheStorePrivate On|Off | Off | svdh | E |
| Attempt to cache responses that the server has marked as private | |||
| CGIDScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIMapExtension cgi-path .extension | dh | C | |
| Technique for locating the interpreter for CGI scripts | |||
| CGIPassAuth On|Off | Off | dh | C |
| Enables passing HTTP authorization headers to scripts as CGI variables | |||
| CGIScriptTimeout time[s|ms] | svdh | B | |
| The length of time to wait for more output from the CGI program | |||
| CGIVar variable rule | dh | C | |
| Controls how some CGI variables are set | |||
| CharsetDefault charset | svdh | E | |
| Charset to translate into | |||
| CharsetOptions option [option] ... | ImplicitAdd | svdh | E |
| Configures charset translation behavior | |||
| CharsetSourceEnc charset | svdh | E | |
| Source charset of files | |||
| CheckBasenameMatch on|off | On | svdh | E |
| Also match files with differing file name extensions. | |||
| CheckCaseOnly on|off | Off | svdh | E |
| Limits the action of the speling module to case corrections | |||
| CheckSpelling on|off | Off | svdh | E |
| Enables the spelling module | |||
| ChrootDir /path/to/directory | s | B | |
| Directory for apache to run chroot(8) after startup. | |||
| ContentDigest On|Off | Off | svdh | C |
Enables the generation of Content-MD5 HTTP Response
headers | |||
| CookieDomain domain | svdh | E | |
| The domain to which the tracking cookie applies | |||
| CookieExpires expiry-period | svdh | E | |
| Expiry time for the tracking cookie | |||
| CookieHTTPOnly on|off | off | svdh | E |
| Adds the 'HTTPOnly' attribute to the cookie | |||
| CookieName token | Apache | svdh | E |
| Name of the tracking cookie | |||
| CookieSameSite None|Lax|Strict | svdh | E | |
| Adds the 'SameSite' attribute to the cookie | |||
| CookieSecure on|off | off | svdh | E |
| Adds the 'Secure' attribute to the cookie | |||
| CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965 | Netscape | svdh | E |
| Format of the cookie header field | |||
| CookieTracking on|off | off | svdh | E |
| Enables tracking cookie | |||
| CoreDumpDirectory directory | s | M | |
| Directory where Apache HTTP Server attempts to switch before dumping core | |||
| CustomLog file|pipe format|nickname [env=[!]environment-variable| expr=expression] | sv | B | |
| Sets filename and format of log file | |||
| Dav On|Off|provider-name | Off | d | E |
| Enable WebDAV HTTP methods | |||
| DavBasePath root-path | d | E | |
| Configure repository root path | |||
| DavDepthInfinity on|off | off | svd | E |
| Allow PROPFIND, Depth: Infinity requests | |||
| DavGenericLockDB file-path | svd | E | |
| Location of the DAV lock database | |||
| DavLockDB file-path | sv | E | |
| Location of the DAV lock database | |||
| DavLockDiscovery on|off | on | svdh | E |
| Enable lock discovery | |||
| DavMinTimeout seconds | 0 | svd | E |
| Minimum amount of time the server holds a lock on a DAV resource | |||
| DBDExptime time-in-seconds | 300 | sv | E |
| Keepalive time for idle connections | |||
| DBDInitSQL "SQL statement" | sv | E | |
| Execute an SQL statement after connecting to a database | |||
| DBDKeep number | 2 | sv | E |
| Maximum sustained number of connections | |||
| DBDMax number | 10 | sv | E |
| Maximum number of connections | |||
| DBDMin number | 1 | sv | E |
| Minimum number of connections | |||
| DBDParams param1=value1[,param2=value2] | sv | E | |
| Parameters for database connection | |||
| DBDPersist On|Off | sv | E | |
| Whether to use persistent connections | |||
| DBDPrepareSQL "SQL statement" label | sv | E | |
| Define an SQL prepared statement | |||
| DBDriver name | sv | E | |
| Specify an SQL driver | |||
| DefaultIcon url-path | svdh | B | |
| Icon to display for files when no specific icon is configured | |||
| DefaultLanguage language-tag | svdh | B | |
| Defines a default language-tag to be sent in the Content-Language header field for all resources in the current context that have not been assigned a language-tag by some other means. | |||
| DefaultRuntimeDir directory-path | DEFAULT_REL_RUNTIME + | s | C |
| Base directory for the server run-time files | |||
| DefaultType media-type|none | none | svdh | C |
This directive has no effect other than to emit warnings
if the value is not none. In prior versions, DefaultType
would specify a default media type to assign to response content for
which no other media type configuration could be found.
| |||
| Define parameter-name [parameter-value] | svd | C | |
| Define a variable | |||
| DeflateAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| How the outgoing ETag header should be modified during compression | |||
| DeflateBufferSize value | 8096 | sv | E |
| Fragment size to be compressed at one time by zlib | |||
| DeflateCompressionLevel value | sv | E | |
| How much compression do we apply to the output | |||
| DeflateFilterNote [type] notename | sv | E | |
| Places the compression ratio in a note for logging | |||
| DeflateInflateLimitRequestBody value | svdh | E | |
| Maximum size of inflated request bodies | |||
| DeflateInflateRatioBurst value | 3 | svdh | E |
| Maximum number of times the inflation ratio for request bodies can be crossed | |||
| DeflateInflateRatioLimit value | 200 | svdh | E |
| Maximum inflation ratio for request bodies | |||
| DeflateMemLevel value | 9 | sv | E |
| How much memory should be used by zlib for compression | |||
| DeflateWindowSize value | 15 | sv | E |
| Zlib compression window size | |||
| Deny from all|host|env=[!]env-variable [host|env=[!]env-variable] ... | dh | E | |
| Controls which hosts are denied access to the server | |||
| <Directory directory-path> ... </Directory> | sv | C | |
| Enclose a group of directives that apply only to the named file-system directory, sub-directories, and their contents. | |||
| DirectoryCheckHandler On|Off | Off | svdh | B |
| Toggle how this module responds when another handler is configured | |||
| DirectoryIndex disabled | local-url [local-url] ... | index.html | svdh | B |
| List of resources to look for when the client requests a directory | |||
| DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-code | off | svdh | B |
| Configures an external redirect for directory indexes. | |||
| <DirectoryMatch regex> ... </DirectoryMatch> | sv | C | |
| Enclose directives that apply to the contents of file-system directories matching a regular expression. | |||
| DirectorySlash On|Off | On | svdh | B |
| Toggle trailing slash redirects on or off | |||
| DocumentRoot directory-path | "/usr/local/apache/ + | sv | C |
| Directory that forms the main document tree visible from the web | |||
| DTracePrivileges On|Off | Off | s | X |
| Determines whether the privileges required by dtrace are enabled. | |||
| DumpIOInput On|Off | Off | s | E |
| Dump all input data to the error log | |||
| DumpIOOutput On|Off | Off | s | E |
| Dump all output data to the error log | |||
| <Else> ... </Else> | svdh | C | |
Contains directives that apply only if the condition of a
previous <If> or
<ElseIf> section is not
satisfied by a request at runtime | |||
| <ElseIf expression> ... </ElseIf> | svdh | C | |
Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
<If> or
<ElseIf> section is not
satisfied | |||
| EnableExceptionHook On|Off | Off | s | M |
| Enables a hook that runs exception handlers after a crash | |||
| EnableMMAP On|Off | On | svdh | C |
| Use memory-mapping to read files during delivery | |||
| EnableSendfile On|Off | Off | svdh | C |
| Use the kernel sendfile support to deliver files to the client | |||
| Error message | svdh | C | |
| Abort configuration parsing with a custom error message | |||
| ErrorDocument error-code document | svdh | C | |
| What the server will return to the client in case of an error | |||
| ErrorLog file-path|syslog[:[facility][:tag]] | logs/error_log (Uni + | sv | C |
| Location where the server will log errors | |||
| ErrorLogFormat [connection|request] format | sv | C | |
| Format specification for error log entries | |||
| Example | svdh | X | |
| Demonstration directive to illustrate the Apache module API | |||
| ExpiresActive On|Off | Off | svdh | E |
Enables generation of Expires
headers | |||
| ExpiresByType MIME-type <code>seconds | svdh | E | |
Value of the Expires header configured
by MIME type | |||
| ExpiresDefault <code>seconds | svdh | E | |
| Default algorithm for calculating expiration time | |||
| ExtendedStatus On|Off | Off[*] | s | C |
| Keep track of extended status information for each request | |||
| ExtFilterDefine filtername parameters | s | E | |
| Define an external filter | |||
| ExtFilterOptions option [option] ... | NoLogStderr | d | E |
Configure mod_ext_filter options | |||
| FallbackResource disabled | local-url | svdh | B | |
| Define a default URL for requests that don't map to a file | |||
| FileETag component ... | MTime Size | svdh | C |
| File attributes used to create the ETag HTTP response header for static files | |||
| <Files filename> ... </Files> | svdh | C | |
| Contains directives that apply to matched filenames | |||
| <FilesMatch regex> ... </FilesMatch> | svdh | C | |
| Contains directives that apply to regular-expression matched filenames | |||
| FilterChain [+=-@!]filter-name ... | svdh | B | |
| Configure the filter chain | |||
| FilterDeclare filter-name [type] | svdh | B | |
| Declare a smart filter | |||
| FilterProtocol filter-name [provider-name] proto-flags | svdh | B | |
| Deal with correct HTTP protocol handling | |||
| FilterProvider filter-name provider-name expression | svdh | B | |
| Register a content filter | |||
| FilterTrace filter-name level | svd | B | |
Get debug/diagnostic information from
mod_filter | |||
| FlushMaxPipelined number | 5 | sv | C |
| Maximum number of pipelined responses above which they are flushed to the network | |||
| FlushMaxThreshold number-of-bytes | 65535 | sv | C |
| Threshold above which pending data are flushed to the network | |||
| ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] | Prefer | svdh | B |
| Action to take if a single acceptable document is not found | |||
| ForceType media-type|None | dh | C | |
| Forces all matching files to be served with the specified media type in the HTTP Content-Type header field | |||
| ForensicLog filename|pipe | sv | E | |
| Sets filename of the forensic log | |||
| GlobalLogfile|pipe format|nickname [env=[!]environment-variable| expr=expression] | s | B | |
| Sets filename and format of log file | |||
| GprofDir /tmp/gprof/|/tmp/gprof/% | sv | C | |
| Directory to write gmon.out profiling data to. | |||
| GracefulShutdownTimeout seconds | 0 | s | M |
| Specify a timeout after which a gracefully shutdown server will exit. | |||
| Group unix-group | #-1 | s | B |
| Group under which the server will answer requests | |||
| H2CopyFiles on|off | off | svdh | E |
| Determine file handling in responses | |||
| H2Direct on|off | on for h2c, off for + | sv | E |
| H2 Direct Protocol Switch | |||
| H2EarlyHint name value | svdh | E | |
| Add a response header to be picked up in 103 Early Hints | |||
| H2EarlyHints on|off | off | sv | E |
| Determine sending of 103 status codes | |||
| H2MaxDataFrameLen n | 0 | sv | E |
| Maximum bytes inside a single HTTP/2 DATA frame | |||
| H2MaxHeaderBlockLen n | 0 | sv | E |
| Maximum size of response headers | |||
| H2MaxSessionStreams n | 100 | sv | E |
| Maximum number of active streams per HTTP/2 session. | |||
| H2MaxWorkerIdleSeconds n | 600 | s | E |
| Maximum number of seconds h2 workers remain idle until shut down. | |||
| H2MaxWorkers n | s | E | |
| Maximum number of worker threads to use per child process. | |||
| H2MinWorkers n | s | E | |
| Minimal number of worker threads to use per child process. | |||
| H2ModernTLSOnly on|off | on | sv | E |
| Require HTTP/2 connections to be "modern TLS" only | |||
| H2OutputBuffering on|off | on | sv | E |
| Determine buffering behaviour of output | |||
| H2Padding numbits | 0 | sv | E |
| Determine the range of padding bytes added to payload frames | |||
| H2ProxyRequests on|off | off | sv | E |
| En-/Disable forward proxy requests via HTTP/2 | |||
| H2Push on|off | on | svdh | E |
| H2 Server Push Switch | |||
| H2PushDiarySize n | 256 | sv | E |
| H2 Server Push Diary Size | |||
| H2PushPriority mime-type [after|before|interleaved] [weight] | * After 16 | sv | E |
| H2 Server Push Priority | |||
| H2PushResource [add] path [critical] | svdh | E | |
| Declares resources for early pushing to the client | |||
| H2SerializeHeaders on|off | off | sv | E |
| Serialize Request/Response Processing Switch | |||
| H2StreamMaxMemSize bytes | 65536 | sv | E |
| Maximum amount of output data buffered per stream. | |||
| H2StreamTimeout time-interval[s] | svd | E | |
| Maximum time waiting when sending/receiving data to stream processing | |||
| H2TLSCoolDownSecs seconds | 1 | sv | E |
| Configure the number of seconds of idle time on TLS before shrinking writes | |||
| H2TLSWarmUpSize amount | 1048576 | sv | E |
| Configure the number of bytes on TLS connection before doing max writes | |||
| H2Upgrade on|off | on for h2c, off for + | svdh | E |
| H2 Upgrade Protocol Switch | |||
| H2WebSockets on|off | off | sv | E |
| En-/Disable WebSockets via HTTP/2 | |||
| H2WindowSize bytes | 65535 | sv | E |
| Size of Stream Window for upstream data. | |||
| Header [condition] add|append|echo|edit|edit*|merge|set|setifempty|unset|note header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] | svdh | E | |
| Configure HTTP response headers | |||
| HeaderName filename | svdh | B | |
| Name of the file that will be inserted at the top of the index listing | |||
| HeartbeatAddress addr:port | s | X | |
| Multicast address for heartbeat packets | |||
| HeartbeatListen addr:port | s | X | |
| multicast address to listen for incoming heartbeat requests | |||
| HeartbeatMaxServers number-of-servers | 10 | s | X |
| Specifies the maximum number of servers that will be sending heartbeat requests to this server | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to store heartbeat data when using flat-file storage | |||
| HeartbeatStorage file-path | logs/hb.dat | s | X |
| Path to read heartbeat data | |||
| HostnameLookups On|Off|Double | Off | svd | C |
| Enables DNS lookups on client IP addresses | |||
| HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods] [Allow0.9|Require1.0] | Strict LenientMetho + | sv | C |
| Modify restrictions on HTTP Request Messages | |||
| IdentityCheck On|Off | Off | svd | E |
| Enables logging of the RFC 1413 identity of the remote user | |||
| IdentityCheckTimeout seconds | 30 | svd | E |
| Determines the timeout duration for ident requests | |||
| <If expression> ... </If> | svdh | C | |
| Contains directives that apply only if a condition is satisfied by a request at runtime | |||
| <IfDefine [!]parameter-name> ... </IfDefine> | svdh | C | |
| Encloses directives that will be processed only if a test is true at startup | |||
| <IfDirective [!]directive-name> ... </IfDirective> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific directive | |||
| <IfFile [!]filename> ... </IfFile> | svdh | C | |
| Encloses directives that will be processed only if file exists at startup | |||
| <IfModule [!]module-file|module-identifier> ... </IfModule> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific module | |||
| <IfSection [!]section-name> ... </IfSection> | svdh | C | |
| Encloses directives that are processed conditional on the presence or absence of a specific section directive | |||
| <IfVersion [[!]operator] version> ... </IfVersion> | svdh | E | |
| contains version dependent configuration | |||
| ImapBase map|referer|URL | http://servername/ | svdh | B |
Default base for imagemap files | |||
| ImapDefault error|nocontent|map|referer|URL | nocontent | svdh | B |
| Default action when an imagemap is called with coordinates that are not explicitly mapped | |||
| ImapMenu none|formatted|semiformatted|unformatted | formatted | svdh | B |
| Action if no coordinates are given when calling an imagemap | |||
| Include file-path|directory-path|wildcard | svd | C | |
| Includes other configuration files from within the server configuration files | |||
| IncludeOptional file-path|directory-path|wildcard | svd | C | |
| Includes other configuration files from within the server configuration files | |||
| IndexHeadInsert "markup ..." | svdh | B | |
| Inserts text in the HEAD section of an index page. | |||
| IndexIgnore file [file] ... | "." | svdh | B |
| Adds to the list of files to hide when listing a directory | |||
| IndexIgnoreReset ON|OFF | svdh | B | |
| Empties the list of files to hide when listing a directory | |||
| IndexOptions [+|-]option [[+|-]option] ... | svdh | B | |
| Various configuration settings for directory indexing | |||
| IndexOrderDefault Ascending|Descending Name|Date|Size|Description | Ascending Name | svdh | B |
| Sets the default ordering of the directory index | |||
| IndexStyleSheet url-path | svdh | B | |
| Adds a CSS stylesheet to the directory index | |||
| InputSed sed-command | dh | X | |
Sed command to filter request data (typically POST data) | |||
| ISAPIAppendLogToErrors on|off | off | svdh | B |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the error log | |||
| ISAPIAppendLogToQuery on|off | on | svdh | B |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the query field | |||
| ISAPICacheFile file-path [file-path] ... | sv | B | |
| ISAPI .dll files to be loaded at startup | |||
| ISAPIFakeAsync on|off | off | svdh | B |
| Fake asynchronous support for ISAPI callbacks | |||
| ISAPILogNotSupported on|off | off | svdh | B |
| Log unsupported feature requests from ISAPI extensions | |||
| ISAPIReadAheadBuffer size | 49152 | svdh | B |
| Size of the Read Ahead Buffer sent to ISAPI extensions | |||
| KeepAlive On|Off | On | sv | C |
| Enables HTTP persistent connections | |||
| KeepAliveTimeout num[ms] | 5 | sv | C |
| Amount of time the server will wait for subsequent requests on a persistent connection | |||
| KeptBodySize maximum size in bytes | 0 | d | B |
| Keep the request body instead of discarding it up to the specified maximum size, for potential use by filters such as mod_include. | |||
| LanguagePriority MIME-lang [MIME-lang] ... | svdh | B | |
| The precedence of language variants for cases where the client does not express a preference | |||
| LDAPCacheEntries number | 1024 | s | E |
| Maximum number of entries in the primary LDAP cache | |||
| LDAPCacheTTL seconds | 600 | s | E |
| Time that cached items remain valid | |||
| LDAPConnectionPoolTTL n | -1 | sv | E |
| Discard backend connections that have been sitting in the connection pool too long | |||
| LDAPConnectionTimeout seconds | s | E | |
| Specifies the socket connection timeout in seconds | |||
| LDAPLibraryDebug 7 | s | E | |
| Enable debugging in the LDAP SDK | |||
| LDAPOpCacheEntries number | 1024 | s | E |
| Number of entries used to cache LDAP compare operations | |||
| LDAPOpCacheTTL seconds | 600 | s | E |
| Time that entries in the operation cache remain valid | |||
| LDAPReferralHopLimit number | dh | E | |
| The maximum number of referral hops to chase before terminating an LDAP query. | |||
| LDAPReferrals On|Off|default | On | dh | E |
| Enable referral chasing during queries to the LDAP server. | |||
| LDAPRetries number-of-retries | 3 | s | E |
| Configures the number of LDAP server retries. | |||
| LDAPRetryDelay seconds | 0 | s | E |
| Configures the delay between LDAP server retries. | |||
| LDAPSharedCacheFile directory-path/filename | s | E | |
| Sets the shared memory cache file | |||
| LDAPSharedCacheSize bytes | 500000 | s | E |
| Size in bytes of the shared-memory cache | |||
| LDAPTimeout seconds | 60 | s | E |
| Specifies the timeout for LDAP search and bind operations, in seconds | |||
| LDAPTrustedClientCert type directory-path/filename/nickname [password] | dh | E | |
| Sets the file containing or nickname referring to a per connection client certificate. Not all LDAP toolkits support per connection client certificates. | |||
| LDAPTrustedGlobalCert type directory-path/filename [password] | s | E | |
| Sets the file or database containing global trusted Certificate Authority or global client certificates | |||
| LDAPTrustedMode type | sv | E | |
| Specifies the SSL/TLS mode to be used when connecting to an LDAP server. | |||
| LDAPVerifyServerCert On|Off | On | s | E |
| Force server certificate verification | |||
| <Limit method [method] ... > ... </Limit> | dh | C | |
| Restrict enclosed access controls to only certain HTTP methods | |||
| <LimitExcept method [method] ... > ... </LimitExcept> | dh | C | |
| Restrict access controls to all HTTP methods except the named ones | |||
| LimitInternalRecursion number [number] | 10 | sv | C |
| Determine maximum number of internal redirects and nested subrequests | |||
| LimitRequestBody bytes | 1073741824 | svdh | C |
| Restricts the total size of the HTTP request body sent from the client | |||
| LimitRequestFields number | 100 | sv | C |
| Limits the number of HTTP request header fields that will be accepted from the client | |||
| LimitRequestFieldSize bytes | 8190 | sv | C |
| Limits the size of the HTTP request header allowed from the client | |||
| LimitRequestLine bytes | 8190 | sv | C |
| Limit the size of the HTTP request line that will be accepted from the client | |||
| LimitXMLRequestBody bytes | 1000000 | svdh | C |
| Limits the size of an XML-based request body | |||
| Listen [IP-address:]portnumber [protocol] | s | M | |
| IP addresses and ports that the server listens to | |||
| ListenBackLog backlog | 511 | s | M |
| Maximum length of the queue of pending connections | |||
| ListenCoresBucketsRatio ratio | 0 (disabled) | s | M |
| Ratio between the number of CPU cores (online) and the number of listeners' buckets | |||
| LoadFile filename [filename] ... | sv | E | |
| Link in the named object file or library | |||
| LoadModule module filename | sv | E | |
| Links in the object file or library, and adds to the list of active modules | |||
| <Location URL-path|URL> ... </Location> | sv | C | |
| Applies the enclosed directives only to matching URLs | |||
| <LocationMatch regex> ... </LocationMatch> | sv | C | |
| Applies the enclosed directives only to regular-expression matching URLs | |||
| LogFormat format|nickname [nickname] | "%h %l %u %t \"%r\" + | sv | B |
| Describes a format for use in a log file | |||
| LogIOTrackTTFB ON|OFF | OFF | svdh | E |
| Enable tracking of time to first byte (TTFB) | |||
| LogLevel [module:]level [module:level] ... | warn | svd | C |
| Controls the verbosity of the ErrorLog | |||
| LogMessage message [hook=hook] [expr=expression] | d | X | |
| Log user-defined message to error log | |||
| LuaAuthzProvider provider_name /path/to/lua/script.lua function_name | s | E | |
Plug an authorization provider function into mod_authz_core
| |||
| LuaCodeCache stat|forever|never | stat | svdh | E |
| Configure the compiled code cache. | |||
| LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the access_checker phase of request processing | |||
| LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the auth_checker phase of request processing | |||
| LuaHookCheckUserID /path/to/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Provide a hook for the check_user_id phase of request processing | |||
| LuaHookFixups /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the fixups phase of a request processing | |||
| LuaHookInsertFilter /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the insert_filter phase of request processing | |||
| LuaHookLog /path/to/lua/script.lua log_function_name | svdh | E | |
| Provide a hook for the access log phase of a request processing | |||
| LuaHookMapToStorage /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the map_to_storage phase of request processing | |||
| LuaHookPreTranslate /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the pre_translate phase of a request processing | |||
| LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late] | sv | E | |
| Provide a hook for the translate name phase of request processing | |||
| LuaHookTypeChecker /path/to/lua/script.lua hook_function_name | svdh | E | |
| Provide a hook for the type_checker phase of request processing | |||
| LuaInherit none|parent-first|parent-last | parent-first | svdh | E |
| Controls how parent configuration sections are merged into children | |||
| LuaInputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content input filtering | |||
| LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name] | svdh | E | |
| Map a path to a lua handler | |||
| LuaOutputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Provide a Lua function for content output filtering | |||
| LuaPackageCPath /path/to/include/?.soa | svdh | E | |
| Add a directory to lua's package.cpath | |||
| LuaPackagePath /path/to/include/?.lua | svdh | E | |
| Add a directory to lua's package.path | |||
| LuaQuickHandler /path/to/script.lua hook_function_name | sv | E | |
| Provide a hook for the quick handler of request processing | |||
| LuaRoot /path/to/a/directory | svdh | E | |
| Specify the base path for resolving relative paths for mod_lua directives | |||
| LuaScope once|request|conn|thread|server [min] [max] | once | svdh | E |
| One of once, request, conn, thread -- default is once | |||
| <Macro name [par1 .. parN]> ... </Macro> | svd | B | |
| Define a configuration file macro | |||
| MaxConnectionsPerChild number | 0 | s | M |
| Limit on the number of connections that an individual child server will handle during its life | |||
| MaxKeepAliveRequests number | 100 | sv | C |
| Number of requests allowed on a persistent connection | |||
| MaxMemFree KBytes | 2048 | s | M |
Maximum amount of memory that the main allocator is allowed
to hold without calling free() | |||
| MaxRangeOverlaps default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete
resource | |||
| MaxRangeReversals default | unlimited | none | number-of-ranges | 20 | svd | C |
Number of range reversals (eg: 100-200,50-70) allowed before returning the complete
resource | |||
| MaxRanges default | unlimited | none | number-of-ranges | 200 | svd | C |
| Number of ranges allowed before returning the complete resource | |||
| MaxRequestWorkers number | s | M | |
| Maximum number of connections that will be processed simultaneously | |||
| MaxSpareServers number | 10 | s | M |
| Maximum number of idle child server processes | |||
| MaxSpareThreads number | s | M | |
| Maximum number of idle threads | |||
| MaxThreads number | 2048 | s | M |
| Set the maximum number of worker threads | |||
| MDActivationDelay duration | s | X | |
| How long to delay activation of new certificates | |||
| MDBaseServer on|off | off | s | X |
| Control if base server may be managed or only virtual hosts. | |||
| MDCAChallenges name [ name ... ] | tls-alpn-01 http-01 + | s | X |
| Type of ACME challenge used to prove domain ownership. | |||
| MDCertificateAgreement accepted | s | X | |
| You confirm that you accepted the Terms of Service of the Certificate Authority. | |||
| MDCertificateAuthority url | letsencrypt | s | X |
| The URL(s) of the ACME Certificate Authority to use. | |||
| MDCertificateCheck name url | s | X | |
| Set name and URL pattern for a certificate monitoring site. | |||
| MDCertificateFile path-to-pem-file | s | X | |
| Specify a static certificate file for the MD. | |||
| MDCertificateKeyFile path-to-file | s | X | |
| Specify a static private key for for the static cerrtificate. | |||
| MDCertificateMonitor name url | crt.sh https://crt. + | s | X |
| The URL of a certificate log monitor. | |||
| MDCertificateProtocol protocol | ACME | s | X |
| The protocol to use with the Certificate Authority. | |||
| MDCertificateStatus on|off | on | s | X |
| Exposes public certificate information in JSON. | |||
| MDChallengeDns01 path-to-command | s | X | |
| Set the command for setup/teardown of dns-01 challenges | |||
| MDChallengeDns01Version 1|2 | 1 | s | X |
| Set the type of arguments to call MDChallengeDns01 with | |||
| MDCheckInterval duration | 12h | s | X |
| Determines how often certificates are checked | |||
| MDContactEmail address | s | X | |
| Email address used for account registration | |||
| MDDriveMode always|auto|manual | auto | s | X |
| former name of MDRenewMode. | |||
| MDExternalAccountBinding key-id hmac-64 | none | file | none | s | X |
| Set the external account binding keyid and hmac values to use at CA | |||
| MDHttpProxy url | s | X | |
| Define a proxy for outgoing connections. | |||
| MDMatchNames all|servernames | all | s | X |
| Determines how DNS names are matched to vhosts | |||
| MDMember hostname | s | X | |
| Additional hostname for the managed domain. | |||
| MDMembers auto|manual | auto | s | X |
| Control if the alias domain names are automatically added. | |||
| MDMessageCmd path-to-cmd optional-args | s | X | |
| Handle events for Manage Domains | |||
| MDMustStaple on|off | off | s | X |
| Control if new certificates carry the OCSP Must Staple flag. | |||
| MDNotifyCmd path [ args ] | s | X | |
| Run a program when a Managed Domain is ready. | |||
| MDomain dns-name [ other-dns-name... ] [auto|manual] | s | X | |
| Define list of domain names that belong to one group. | |||
| <MDomainSet dns-name [ other-dns-name... ]>...</MDomainSet> | s | X | |
| Container for directives applied to the same managed domains. | |||
| MDPortMap map1 [ map2 ] | http:80 https:443 | s | X |
| Map external to internal ports for domain ownership verification. | |||
| MDPrivateKeys type [ params... ] | RSA 2048 | s | X |
| Set type and size of the private keys generated. | |||
| MDProfile name | s | X | |
| Use a specific ACME profile from the CA | |||
| MDProfileMandatory on|off | off | s | X |
| Control if an MDProfile is mandatory. | |||
| MDRenewMode always|auto|manual | auto | s | X |
| Controls if certificates shall be renewed. | |||
| MDRenewWindow duration | 33% | s | X |
| Control when a certificate will be renewed. | |||
| MDRequireHttps off|temporary|permanent | off | s | X |
| Redirects http: traffic to https: for Managed Domains. | |||
| MDRetryDelay duration | 5s | s | X |
| Time length for first retry, doubled on every consecutive error. | |||
| MDRetryFailover number | 13 | s | X |
| The number of errors before a failover to another CA is triggered | |||
| MDServerStatus on|off | on | s | X |
| Control if Managed Domain information is added to server-status. | |||
| MDStapleOthers on|off | on | s | X |
| Enable stapling for certificates not managed by mod_md. | |||
| MDStapling on|off | off | s | X |
| Enable stapling for all or a particular MDomain. | |||
| MDStaplingKeepResponse duration | 7d | s | X |
| Controls when old responses should be removed. | |||
| MDStaplingRenewWindow duration | 33% | s | X |
| Control when the stapling responses will be renewed. | |||
| MDStoreDir path | md | s | X |
| Path on the local file system to store the Managed Domains data. | |||
| MDStoreLocks on|off|duration | off | s | X |
| Configure locking of store for updates | |||
| MDWarnWindow duration | 10% | s | X |
| Define the time window when you want to be warned about an expiring certificate. | |||
| MemcacheConnTTL num[units] | 15s | sv | E |
| Keepalive time for idle connections | |||
| MergeSlashes ON|OFF | ON | sv | C |
| Controls whether the server merges consecutive slashes in URLs. | |||
| MergeTrailers [on|off] | off | sv | C |
| Determines whether trailers are merged into headers | |||
| MetaDir directory | .web | svdh | E |
| Name of the directory to find CERN-style meta information files | |||
| MetaFiles on|off | off | svdh | E |
| Activates CERN meta-file processing | |||
| MetaSuffix suffix | .meta | svdh | E |
| File name suffix for the file containing CERN-style meta information | |||
| MimeMagicFile file-path | sv | E | |
| Enable MIME-type determination based on file contents using the specified magic file | |||
| MinSpareServers number | 5 | s | M |
| Minimum number of idle child server processes | |||
| MinSpareThreads number | s | M | |
| Minimum number of idle threads available to handle request spikes | |||
| MMapFile file-path [file-path] ... | s | X | |
| Map a list of files into memory at startup time | |||
| ModemStandard V.21|V.26bis|V.32|V.34|V.92 | d | X | |
| Modem standard to simulate | |||
| ModMimeUsePathInfo On|Off | Off | d | B |
Tells mod_mime to treat path_info
components as part of the filename | |||
| MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers [Handlers|Filters] | NegotiatedOnly | svdh | B |
| The types of files that will be included when searching for a matching file with MultiViews | |||
| Mutex mechanism [default|mutex-name] ... [OmitPID] | default | s | C |
| Configures mutex mechanism and lock file directory for all or specified mutexes | |||
| NameVirtualHost addr[:port] | s | C | |
| DEPRECATED: Designates an IP address for name-virtual hosting | |||
| NoProxy host [host] ... | sv | E | |
| Hosts, domains, or networks that will be connected to directly | |||
| NWSSLTrustedCerts filename [filename] ... | s | B | |
| List of additional client certificates | |||
| NWSSLUpgradeable [IP-address:]portnumber | s | B | |
| Allows a connection to be upgraded to an SSL connection upon request | |||
| Options [+|-]option [[+|-]option] ... | FollowSymlinks | svdh | C |
| Configures what features are available in a particular directory | |||
| Order ordering | Deny,Allow | dh | E |
Controls the default access state and the order in which
Allow and Deny are
evaluated. | |||
| OutputSed sed-command | dh | X | |
| Sed command for filtering response content | |||
| PassEnv env-variable [env-variable] ... | svdh | B | |
| Passes environment variables from the shell | |||
| PidFile filename | logs/httpd.pid | s | M |
| File where the server records the process ID of the daemon | |||
| PrivilegesMode FAST|SECURE|SELECTIVE | FAST | svd | X |
| Trade off processing speed and efficiency vs security against malicious privileges-aware code. | |||
| Protocol protocol | sv | C | |
| Protocol for a listening socket | |||
| ProtocolEcho On|Off | Off | sv | X |
| Turn the echo server on or off | |||
| Protocols protocol ... | http/1.1 | sv | C |
| Protocols available for a server/virtual host | |||
| ProtocolsHonorOrder On|Off | On | sv | C |
| Determines if order of Protocols determines precedence during negotiation | |||
| <Proxy wildcard-url> ...</Proxy> | sv | E | |
| Container for directives applied to proxied resources | |||
| Proxy100Continue Off|On | On | svd | E |
| Forward 100-continue expectation to the origin server | |||
| ProxyAddHeaders Off|On | On | svd | E |
| Add proxy information in X-Forwarded-* headers | |||
| ProxyBadHeader IsError|Ignore|StartBody | IsError | sv | E |
| Determines how to handle bad header lines in a response | |||
| ProxyBlock *|word|host|domain [word|host|domain] ... | sv | E | |
| Words, hosts, or domains that are banned from being proxied | |||
| ProxyDomain Domain | sv | E | |
| Default domain name for proxied requests | |||
| ProxyErrorOverride Off|On [code ...] | Off | svd | E |
| Override error pages for proxied content | |||
| ProxyExpressDBMFile pathname | sv | E | |
| Pathname to DBM file. | |||
| ProxyExpressDBMType type | default | sv | E |
| DBM type of file. | |||
| ProxyExpressEnable on|off | off | sv | E |
| Enable the module functionality. | |||
| ProxyFCGIBackendType FPM|GENERIC | FPM | svdh | E |
| Specify the type of backend FastCGI application | |||
| ProxyFCGISetEnvIf conditional-expression [!]environment-variable-name [value-expression] | svdh | E | |
| Allow variables sent to FastCGI servers to be fixed up | |||
| ProxyFtpDirCharset character_set | ISO-8859-1 | svd | E |
| Define the character set for proxied FTP listings | |||
| ProxyFtpEscapeWildcards on|off | on | svd | E |
| Whether wildcards in requested filenames are escaped when sent to the FTP server | |||
| ProxyFtpListOnWildcard on|off | on | svd | E |
| Whether wildcards in requested filenames trigger a file listing | |||
| ProxyHCExpr name {ap_expr expression} | sv | E | |
| Creates a named condition expression to use to determine health of the backend based on its response | |||
| ProxyHCTemplate name parameter=setting [...] | sv | E | |
| Creates a named template for setting various health check parameters | |||
| ProxyHCTPsize size | 16 | s | E |
| Sets the total server-wide size of the threadpool used for the health check workers | |||
| ProxyHTMLBufSize bytes | 8192 | svd | B |
| Sets the buffer size increment for buffering inline scripts and stylesheets. | |||
| ProxyHTMLCharsetOut Charset | * | svd | B | |
| Specify a charset for mod_proxy_html output. | |||
| ProxyHTMLDocType HTML|XHTML [Legacy] OR ProxyHTMLDocType fpi [SGML|XML] | svd | B | |
| Sets an HTML or XHTML document type declaration. | |||
| ProxyHTMLEnable On|Off | Off | svd | B |
| Turns the proxy_html filter on or off. | |||
| ProxyHTMLEvents attribute [attribute ...] | svd | B | |
| Specify attributes to treat as scripting events. | |||
| ProxyHTMLExtended On|Off | Off | svd | B |
| Determines whether to fix links in inline scripts, stylesheets, and scripting events. | |||
| ProxyHTMLFixups [lowercase] [dospath] [reset] | svd | B | |
| Fixes for simple HTML errors. | |||
| ProxyHTMLInterp On|Off | Off | svd | B |
Enables per-request interpolation of
ProxyHTMLURLMap rules. | |||
| ProxyHTMLLinks element attribute [attribute2 ...] | svd | B | |
| Specify HTML elements that have URL attributes to be rewritten. | |||
| ProxyHTMLMeta On|Off | Off | svd | B |
Turns on or off extra pre-parsing of metadata in HTML
<head> sections. | |||
| ProxyHTMLStripComments On|Off | Off | svd | B |
| Determines whether to strip HTML comments. | |||
| ProxyHTMLURLMap from-pattern to-pattern [flags] [cond] | svd | B | |
| Defines a rule to rewrite HTML links | |||
| ProxyIOBufferSize bytes | 8192 | sv | E |
| Determine size of internal data throughput buffer | |||
| <ProxyMatch regex> ...</ProxyMatch> | sv | E | |
| Container for directives applied to regular-expression-matched proxied resources | |||
| ProxyMaxForwards number | -1 | sv | E |
| Maximum number of proxies that a request can be forwarded through | |||
| ProxyPass [path] !|url [key=value [key=value ...]] [nocanon] [interpolate] [noquery] | svd | E | |
| Maps remote servers into the local server URL-space | |||
| ProxyPassInherit On|Off | On | sv | E |
| Inherit ProxyPass directives defined from the main server | |||
| ProxyPassInterpolateEnv On|Off | Off | svd | E |
| Enable Environment Variable interpolation in Reverse Proxy configurations | |||
| ProxyPassMatch [regex] !|url [key=value [key=value ...]] | svd | E | |
| Maps remote servers into the local server URL-space using regular expressions | |||
| ProxyPassReverse [path] url [interpolate] | svd | E | |
| Adjusts the URL in HTTP response headers sent from a reverse proxied server | |||
| ProxyPassReverseCookieDomain internal-domain public-domain [interpolate] | svd | E | |
| Adjusts the Domain string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPassReverseCookiePath internal-path public-path [interpolate] | svd | E | |
| Adjusts the Path string in Set-Cookie headers from a reverse- proxied server | |||
| ProxyPreserveHost On|Off | Off | svd | E |
| Use incoming Host HTTP request header for proxy request | |||
| ProxyReceiveBufferSize bytes | 0 | sv | E |
| Network buffer size for proxied HTTP and FTP connections | |||
| ProxyRemote match remote-server [username:password] | sv | E | |
| Remote proxy used to handle certain requests | |||
| ProxyRemoteMatch regex remote-server [username:password] | sv | E | |
| Remote proxy used to handle requests matched by regular expressions | |||
| ProxyRequests On|Off | Off | sv | E |
| Enables forward (standard) proxy requests | |||
| ProxySCGIInternalRedirect On|Off|Headername | On | svd | E |
| Enable or disable internal redirect responses from the backend | |||
| ProxySCGISendfile On|Off|Headername | Off | svd | E |
| Enable evaluation of X-Sendfile pseudo response header | |||
| ProxySet url key=value [key=value ...] | svd | E | |
| Set various Proxy balancer or member parameters | |||
| ProxySourceAddress address | sv | E | |
| Set local IP address for outgoing proxy connections | |||
| ProxyStatus Off|On|Full | Off | sv | E |
| Show Proxy LoadBalancer status in mod_status | |||
| ProxyTimeout seconds | sv | E | |
| Network timeout for proxied requests | |||
| ProxyVia On|Off|Full|Block | Off | sv | E |
Information provided in the Via HTTP response
header for proxied requests | |||
| ProxyWebsocketFallbackToProxyHttp On|Off | On | sv | E |
Instructs this module to let mod_proxy_http handle the request | |||
| QualifyRedirectURL On|Off | Off | svd | C |
| Controls whether the REDIRECT_URL environment variable is fully qualified | |||
| ReadBufferSize bytes | 8192 | svd | C |
| Size of the buffers used to read data | |||
| ReadmeName filename | svdh | B | |
| Name of the file that will be inserted at the end of the index listing | |||
| ReceiveBufferSize bytes | 0 | s | M |
| TCP receive buffer size | |||
| Redirect [status] [URL-path] URL | svdh | B | |
| Sends an external redirect asking the client to fetch a different URL | |||
| RedirectMatch [status] regex URL | svdh | B | |
| Sends an external redirect based on a regular expression match of the current URL | |||
| RedirectPermanent URL-path URL | svdh | B | |
| Sends an external permanent redirect asking the client to fetch a different URL | |||
| RedirectRelative On|Off | Off | svd | B |
| Allows relative redirect targets. | |||
| RedirectTemp URL-path URL | svdh | B | |
| Sends an external temporary redirect asking the client to fetch a different URL | |||
| RedisConnPoolTTL num[units] | 15s | sv | E |
| TTL used for the connection pool with the Redis server(s) | |||
| RedisTimeout num[units] | 5s | sv | E |
| R/W timeout used for the connection with the Redis server(s) | |||
| ReflectorHeader inputheader [outputheader] | svdh | B | |
| Reflect an input header to the output headers | |||
| RegexDefaultOptions [none] [+|-]option [[+|-]option] ... | DOTALL DOLLAR_ENDON + | s | C |
| Allow to configure global/default options for regexes | |||
| RegisterHttpMethod method [method [...]] | s | C | |
| Register non-standard HTTP methods | |||
| RemoteIPHeader header-field | sv | B | |
| Declare the header field which should be parsed for useragent IP addresses | |||
| RemoteIPInternalProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPInternalProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPProxiesHeader HeaderFieldName | sv | B | |
| Declare the header field which will record all intermediate IP addresses | |||
| RemoteIPProxyProtocol On|Off | sv | B | |
| Enable or disable PROXY protocol handling | |||
| RemoteIPProxyProtocolExceptions host|range [host|range] [host|range] | sv | B | |
| Disable processing of PROXY header for certain hosts or networks | |||
| RemoteIPTrustedProxy proxy-ip|proxy-ip/subnet|hostname ... | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoteIPTrustedProxyList filename | sv | B | |
| Declare client intranet IP addresses trusted to present the RemoteIPHeader value | |||
| RemoveCharset extension [extension] ... | vdh | B | |
| Removes any character set associations for a set of file extensions | |||
| RemoveEncoding extension [extension] ... | vdh | B | |
| Removes any content encoding associations for a set of file extensions | |||
| RemoveHandler extension [extension] ... | vdh | B | |
| Removes any handler associations for a set of file extensions | |||
| RemoveInputFilter extension [extension] ... | vdh | B | |
| Removes any input filter associations for a set of file extensions | |||
| RemoveLanguage extension [extension] ... | vdh | B | |
| Removes any language associations for a set of file extensions | |||
| RemoveOutputFilter extension [extension] ... | vdh | B | |
| Removes any output filter associations for a set of file extensions | |||
| RemoveType extension [extension] ... | vdh | B | |
| Removes any content type associations for a set of file extensions | |||
| RequestHeader add|append|edit|edit*|merge|set|setifempty|unset header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] | svdh | E | |
| Configure HTTP request headers | |||
| RequestReadTimeout [handshake=timeout[-maxtimeout][,MinRate=rate] [header=timeout[-maxtimeout][,MinRate=rate] [body=timeout[-maxtimeout][,MinRate=rate] | handshake=0 header= + | sv | E |
| Set timeout values for completing the TLS handshake, receiving the request headers and/or body from client. | |||
| Require [not] entity-name [entity-name] ... | dh | B | |
| Tests whether an authenticated user is authorized by an authorization provider. | |||
| <RequireAll> ... </RequireAll> | dh | B | |
| Enclose a group of authorization directives of which none must fail and at least one must succeed for the enclosing directive to succeed. | |||
| <RequireAny> ... </RequireAny> | dh | B | |
| Enclose a group of authorization directives of which one must succeed for the enclosing directive to succeed. | |||
| <RequireNone> ... </RequireNone> | dh | B | |
| Enclose a group of authorization directives of which none must succeed for the enclosing directive to not fail. | |||
| RewriteBase URL-path | dh | E | |
| Sets the base URL for per-directory rewrites | |||
| RewriteCond TestString CondPattern [flags] | svdh | E | |
| Defines a condition under which rewriting will take place | |||
| RewriteEngine on|off | off | svdh | E |
| Enables or disables runtime rewriting engine | |||
| RewriteMap MapName MapType:MapSource [MapTypeOptions] | sv | E | |
| Defines a mapping function for key-lookup | |||
| RewriteOptions Options | svdh | E | |
| Sets some special options for the rewrite engine | |||
| RewriteRule Pattern Substitution [flags] | svdh | E | |
| Defines rules for the rewriting engine | |||
| RLimitCPU seconds|max [seconds|max] | svdh | C | |
| Limits the CPU consumption of processes launched by Apache httpd children | |||
| RLimitMEM bytes|max [bytes|max] | svdh | C | |
| Limits the memory consumption of processes launched by Apache httpd children | |||
| RLimitNPROC number|max [number|max] | svdh | C | |
| Limits the number of processes that can be launched by processes launched by Apache httpd children | |||
| Satisfy Any|All | All | dh | E |
| Interaction between host-level access control and user authentication | |||
| ScoreBoardFile file-path | logs/apache_runtime + | s | M |
| Location of the file used to store coordination data for the child processes | |||
| Script method cgi-script | svd | B | |
| Activates a CGI script for a particular request method. | |||
| ScriptAlias [URL-path] file-path|directory-path | svd | B | |
| Maps a URL to a filesystem location and designates the target as a CGI script | |||
| ScriptAliasMatch regex file-path|directory-path | sv | B | |
| Maps a URL to a filesystem location using a regular expression and designates the target as a CGI script | |||
| ScriptInterpreterSource Registry|Registry-Strict|Script | Script | svdh | C |
| Technique for locating the interpreter for CGI scripts | |||
| ScriptLog file-path | sv | B | |
| Location of the CGI script error logfile | |||
| ScriptLogBuffer bytes | 1024 | sv | B |
| Maximum amount of PUT or POST requests that will be recorded in the scriptlog | |||
| ScriptLogLength bytes | 10385760 | sv | B |
| Size limit of the CGI script logfile | |||
| ScriptSock file-path | cgisock | s | B |
| The filename prefix of the socket to use for communication with the cgi daemon | |||
| SecureListen [IP-address:]portnumber Certificate-Name [MUTUAL] | s | B | |
| Enables SSL encryption for the specified port | |||
| SeeRequestTail On|Off | Off | s | C |
| Determine if mod_status displays the first 63 characters of a request or the last 63, assuming the request itself is greater than 63 chars. | |||
| SendBufferSize bytes | 0 | s | M |
| TCP buffer size | |||
| ServerAdmin email-address|URL | sv | C | |
| Email address that the server includes in error messages sent to the client | |||
| ServerAlias hostname [hostname] ... | v | C | |
| Alternate names for a host used when matching requests to name-virtual hosts | |||
| ServerLimit number | s | M | |
| Upper limit on configurable number of processes | |||
| ServerName [scheme://]domain-name|ip-address[:port] | sv | C | |
| Hostname and port that the server uses to identify itself | |||
| ServerPath URL-path | v | C | |
| Legacy URL pathname for a name-based virtual host that is accessed by an incompatible browser | |||
| ServerRoot directory-path | /usr/local/apache | s | C |
| Base directory for the server installation | |||
| ServerSignature On|Off|EMail | Off | svdh | C |
| Configures the footer on server-generated documents | |||
| ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full | Full | s | C |
Configures the Server HTTP response
header | |||
| Session On|Off | Off | svdh | E |
| Enables a session for the current directory or location | |||
| SessionCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session | |||
| SessionCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session | |||
| SessionCookieRemove On|Off | Off | svdh | E |
| Control for whether session cookies should be removed from incoming HTTP headers | |||
| SessionCryptoCipher name | aes256 | svdh | X |
| The crypto cipher to be used to encrypt the session | |||
| SessionCryptoDriver name [param[=value]] | s | X | |
| The crypto driver to be used to encrypt the session | |||
| SessionCryptoPassphrase secret [ secret ... ] | svdh | X | |
| The key used to encrypt the session | |||
| SessionCryptoPassphraseFile filename | svd | X | |
| File containing keys used to encrypt the session | |||
| SessionDBDCookieName name attributes | svdh | E | |
| Name and attributes for the RFC2109 cookie storing the session ID | |||
| SessionDBDCookieName2 name attributes | svdh | E | |
| Name and attributes for the RFC2965 cookie storing the session ID | |||
| SessionDBDCookieRemove On|Off | On | svdh | E |
| Control for whether session ID cookies should be removed from incoming HTTP headers | |||
| SessionDBDDeleteLabel label | deletesession | svdh | E |
| The SQL query to use to remove sessions from the database | |||
| SessionDBDInsertLabel label | insertsession | svdh | E |
| The SQL query to use to insert sessions into the database | |||
| SessionDBDPerUser On|Off | Off | svdh | E |
| Enable a per user session | |||
| SessionDBDSelectLabel label | selectsession | svdh | E |
| The SQL query to use to select sessions from the database | |||
| SessionDBDUpdateLabel label | updatesession | svdh | E |
| The SQL query to use to update existing sessions in the database | |||
| SessionEnv On|Off | Off | svdh | E |
| Control whether the contents of the session are written to the HTTP_SESSION environment variable | |||
| SessionExclude path | svdh | E | |
| Define URL prefixes for which a session is ignored | |||
| SessionExpiryUpdateInterval interval | 0 (always update) | svdh | E |
| Define the number of seconds a session's expiry may change without the session being updated | |||
| SessionHeader header | svdh | E | |
| Import session updates from a given HTTP response header | |||
| SessionInclude path | svdh | E | |
| Define URL prefixes for which a session is valid | |||
| SessionMaxAge maxage | 0 | svdh | E |
| Define a maximum age in seconds for a session | |||
| SetEnv env-variable [value] | svdh | B | |
| Sets environment variables | |||
| SetEnvIf attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on attributes of the request | |||
| SetEnvIfExpr expr [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on an ap_expr expression | |||
| SetEnvIfNoCase attribute regex [!]env-variable[=value] [[!]env-variable[=value]] ... | svdh | B | |
| Sets environment variables based on attributes of the request without respect to case | |||
| SetHandler handler-name|none|expression | svdh | C | |
| Forces all matching files to be processed by a handler | |||
| SetInputFilter filter[;filter...] | svdh | C | |
| Sets the filters that will process client requests and POST input | |||
| SetOutputFilter filter[;filter...] | svdh | C | |
| Sets the filters that will process responses from the server | |||
| SSIEndTag tag | "-->" | sv | B |
| String that ends an include element | |||
| SSIErrorMsg message | "[an error occurred + | svdh | B |
| Error message displayed when there is an SSI error | |||
| SSIETag on|off | off | dh | B |
| Controls whether ETags are generated by the server. | |||
| SSILastModified on|off | off | dh | B |
Controls whether Last-Modified headers are generated by the
server. | |||
| SSILegacyExprParser on|off | off | dh | B |
| Enable compatibility mode for conditional expressions. | |||
| SSIStartTag tag | "<!--#" | sv | B |
| String that starts an include element | |||
| SSITimeFormat formatstring | "%A, %d-%b-%Y %H:%M + | svdh | B |
| Configures the format in which date strings are displayed | |||
| SSIUndefinedEcho string | "(none)" | svdh | B |
| String displayed when an unset variable is echoed | |||
| SSLCACertificateFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for Client Auth | |||
| SSLCACertificatePath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for Client Auth | |||
| SSLCADNRequestFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCADNRequestPath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for defining acceptable CA names | |||
| SSLCARevocationCheck chain|leaf|none [flags ...] | none | sv | E |
| Enable CRL-based revocation checking | |||
| SSLCARevocationFile file-path | sv | E | |
| File of concatenated PEM-encoded CA CRLs for Client Auth | |||
| SSLCARevocationPath directory-path | sv | E | |
| Directory of PEM-encoded CA CRLs for Client Auth | |||
| SSLCertificateChainFile file-path | sv | E | |
| File of PEM-encoded Server CA Certificates | |||
| SSLCertificateFile file-path|certid | sv | E | |
| Server PEM-encoded X.509 certificate data file or token identifier | |||
| SSLCertificateKeyFile file-path|keyid | sv | E | |
| Server PEM-encoded private key file | |||
| SSLCipherSuite [protocol] cipher-spec | DEFAULT (depends on + | svdh | E |
| Cipher Suite available for negotiation in SSL handshake | |||
| SSLCompression on|off | off | sv | E |
| Enable compression on the SSL level | |||
| SSLCryptoDevice engine | builtin | s | E |
| Enable use of a cryptographic hardware accelerator | |||
| SSLEngine on|off|optional | off | sv | E |
| SSL Engine Operation Switch | |||
| SSLFIPS on|off | off | s | E |
| SSL FIPS mode Switch | |||
| SSLHonorCipherOrder on|off | off | sv | E |
| Option to prefer the server's cipher preference order | |||
| SSLInsecureRenegotiation on|off | off | sv | E |
| Option to enable support for insecure renegotiation | |||
| SSLOCSPDefaultResponder uri | sv | E | |
| Set the default responder URI for OCSP validation | |||
| SSLOCSPEnable on|leaf|off | off | sv | E |
| Enable OCSP validation of the client certificate chain | |||
| SSLOCSPNoverify on|off | off | sv | E |
| skip the OCSP responder certificates verification | |||
| SSLOCSPOverrideResponder on|off | off | sv | E |
| Force use of the default responder URI for OCSP validation | |||
| SSLOCSPProxyURL url | sv | E | |
| Proxy URL to use for OCSP requests | |||
| SSLOCSPResponderCertificateFile file | sv | E | |
| Set of trusted PEM encoded OCSP responder certificates | |||
| SSLOCSPResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP queries | |||
| SSLOCSPResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP responses | |||
| SSLOCSPResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP response validation | |||
| SSLOCSPUseRequestNonce on|off | on | sv | E |
| Use a nonce within OCSP queries | |||
| SSLOpenSSLConfCmd command-name command-value | sv | E | |
| Configure OpenSSL parameters through its SSL_CONF API | |||
| SSLOptions [+|-]option ... | svdh | E | |
| Configure various SSL engine run-time options | |||
| SSLPassPhraseDialog type | builtin | s | E |
| Type of pass phrase dialog for encrypted private keys | |||
| SSLProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | sv | E |
| Configure usable SSL/TLS protocol versions | |||
| SSLProxyCACertificateFile file-path | sv | E | |
| File of concatenated PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCACertificatePath directory-path | sv | E | |
| Directory of PEM-encoded CA Certificates for Remote Server Auth | |||
| SSLProxyCARevocationCheck chain|leaf|none | none | sv | E |
| Enable CRL-based revocation checking for Remote Server Auth | |||
| SSLProxyCARevocationFile file-path | sv | E | |
| File of concatenated PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCARevocationPath directory-path | sv | E | |
| Directory of PEM-encoded CA CRLs for Remote Server Auth | |||
| SSLProxyCheckPeerCN on|off | on | sv | E |
| Whether to check the remote server certificate's CN field | |||
| SSLProxyCheckPeerExpire on|off | on | sv | E |
| Whether to check if remote server certificate is expired | |||
| SSLProxyCheckPeerName on|off | on | sv | E |
| Configure host name checking for remote server certificates | |||
| SSLProxyCipherSuite [protocol] cipher-spec | ALL:!ADH:RC4+RSA:+H + | sv | E |
| Cipher Suite available for negotiation in SSL proxy handshake | |||
| SSLProxyEngine on|off | off | sv | E |
| SSL Proxy Engine Operation Switch | |||
| SSLProxyMachineCertificateChainFile filename | sv | E | |
| File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate | |||
| SSLProxyMachineCertificateFile filename | sv | E | |
| File of concatenated PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyMachineCertificatePath directory | sv | E | |
| Directory of PEM-encoded client certificates and keys to be used by the proxy | |||
| SSLProxyProtocol [+|-]protocol ... | all -SSLv3 (up to 2 + | sv | E |
| Configure usable SSL protocol flavors for proxy usage | |||
| SSLProxyVerify level | none | sv | E |
| Type of remote server Certificate verification | |||
| SSLProxyVerifyDepth number | 1 | sv | E |
| Maximum depth of CA Certificates in Remote Server Certificate verification | |||
| SSLRandomSeed context source [bytes] | s | E | |
| Pseudo Random Number Generator (PRNG) seeding source | |||
| SSLRenegBufferSize bytes | 131072 | dh | E |
| Set the size for the SSL renegotiation buffer | |||
| SSLRequire expression | dh | E | |
| Allow access only when an arbitrarily complex boolean expression is true | |||
| SSLRequireSSL | dh | E | |
| Deny access when SSL is not used for the HTTP request | |||
| SSLSessionCache type | none | s | E |
| Type of the global/inter-process SSL Session Cache | |||
| SSLSessionCacheTimeout seconds | 300 | sv | E |
| Number of seconds before an SSL session expires in the Session Cache | |||
| SSLSessionTicketKeyFile file-path | sv | E | |
| Persistent encryption/decryption key for TLS session tickets | |||
| SSLSessionTickets on|off | on | sv | E |
| Enable or disable use of TLS session tickets | |||
| SSLSRPUnknownUserSeed secret-string | sv | E | |
| SRP unknown user seed | |||
| SSLSRPVerifierFile file-path | sv | E | |
| Path to SRP verifier file | |||
| SSLStaplingCache type | s | E | |
| Configures the OCSP stapling cache | |||
| SSLStaplingErrorCacheTimeout seconds | 600 | sv | E |
| Number of seconds before expiring invalid responses in the OCSP stapling cache | |||
| SSLStaplingFakeTryLater on|off | on | sv | E |
| Synthesize "tryLater" responses for failed OCSP stapling queries | |||
| SSLStaplingForceURL uri | sv | E | |
| Override the OCSP responder URI specified in the certificate's AIA extension | |||
| SSLStaplingResponderTimeout seconds | 10 | sv | E |
| Timeout for OCSP stapling queries | |||
| SSLStaplingResponseMaxAge seconds | -1 | sv | E |
| Maximum allowable age for OCSP stapling responses | |||
| SSLStaplingResponseTimeSkew seconds | 300 | sv | E |
| Maximum allowable time skew for OCSP stapling response validation | |||
| SSLStaplingReturnResponderErrors on|off | on | sv | E |
| Pass stapling related OCSP errors on to client | |||
| SSLStaplingStandardCacheTimeout seconds | 3600 | sv | E |
| Number of seconds before expiring responses in the OCSP stapling cache | |||
| SSLStrictSNIVHostCheck on|off | off | sv | E |
| Whether to allow non-SNI clients to access a name-based virtual host. | |||
| SSLUserName varname | sdh | E | |
| Variable name to determine user name | |||
| SSLUseStapling on|off | off | sv | E |
| Enable stapling of OCSP responses in the TLS handshake | |||
| SSLVerifyClient level | none | svdh | E |
| Type of Client Certificate verification | |||
| SSLVerifyDepth number | 1 | svdh | E |
| Maximum depth of CA Certificates in Client Certificate verification | |||
| StartServers number | s | M | |
| Number of child server processes created at startup | |||
| StartThreads number | s | M | |
| Number of threads created on startup | |||
| StrictHostCheck ON|OFF | OFF | sv | C |
| Controls whether the server requires the requested hostname be listed enumerated in the virtual host handling the request | |||
| Substitute s/pattern/substitution/[infq] | dh | E | |
| Pattern to filter the response content | |||
| SubstituteInheritBefore on|off | off | dh | E |
| Change the merge order of inherited patterns | |||
| SubstituteMaxLineLength bytes(b|B|k|K|m|M|g|G) | 1m | dh | E |
| Set the maximum line size | |||
| Suexec On|Off | s | B | |
| Enable or disable the suEXEC feature | |||
| SuexecUserGroup User Group | sv | E | |
| User and group for CGI programs to run as | |||
| ThreadLimit number | s | M | |
| Sets the upper limit on the configurable number of threads per child process | |||
| ThreadsPerChild number | s | M | |
| Number of threads created by each child process | |||
| ThreadStackSize size | s | M | |
| The size in bytes of the stack used by threads handling client connections | |||
| TimeOut seconds | 60 | sv | C |
| Amount of time the server will wait for certain events before failing a request | |||
| TraceEnable [on|off|extended] | on | sv | C |
Determines the behavior on TRACE requests | |||
| TransferLog file|pipe | sv | B | |
| Specify location of a log file | |||
| TypesConfig file-path | conf/mime.types | s | B |
The location of the mime.types file | |||
| UNCList hostname [hostname...] | s | C | |
| Controls what UNC host names can be accessed by the server | |||
| UnDefine parameter-name | s | C | |
| Undefine the existence of a variable | |||
| UndefMacro name | svd | B | |
| Undefine a macro | |||
| UnsetEnv env-variable [env-variable] ... | svdh | B | |
| Removes variables from the environment | |||
| Use name [value1 ... valueN] | svd | B | |
| Use a macro | |||
| UseCanonicalName On|Off|DNS | Off | svd | C |
| Configures how the server determines its own name and port | |||
| UseCanonicalPhysicalPort On|Off | Off | svd | C |
| Configures how the server determines its own port | |||
| User unix-userid | #-1 | s | B |
| The userid under which the server will answer requests | |||
| UserDir directory-filename [directory-filename] ... | sv | B | |
| Location of the user-specific directories | |||
| VHostCGIMode On|Off|Secure | On | v | X |
| Determines whether the virtualhost can run subprocesses, and the privileges available to subprocesses. | |||
| VHostCGIPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to subprocesses created by a virtual host. | |||
| VHostGroup unix-groupid | v | X | |
| Sets the Group ID under which a virtual host runs. | |||
| VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assign arbitrary privileges to a virtual host. | |||
| VHostSecure On|Off | On | v | X |
| Determines whether the server runs with enhanced security for the virtualhost. | |||
| VHostUser unix-userid | v | X | |
| Sets the User ID under which a virtual host runs. | |||
| VirtualDocumentRoot interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| VirtualDocumentRootIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the document root for a given virtual host | |||
| <VirtualHost addr[:port] [addr[:port]] ...> ... </VirtualHost> | s | C | |
| Contains directives that apply only to a specific hostname or IP address | |||
| VirtualScriptAlias interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| VirtualScriptAliasIP interpolated-directory|none | none | sv | E |
| Dynamically configure the location of the CGI directory for a given virtual host | |||
| WatchdogInterval time-interval[s] | 1 | s | B |
| Watchdog interval in seconds | |||
| XBitHack on|off|full | off | svdh | B |
| Parse SSI directives in files with the execute bit set | |||
| xml2EncAlias charset alias [alias ...] | s | B | |
| Recognise Aliases for encoding values | |||
| xml2EncDefault name | svdh | B | |
| Sets a default encoding to assume when absolutely no information can be automatically detected | |||
| xml2StartParse element [element ...] | svdh | B | |
| Advise the parser to skip leading junk. | |||
Apache HTTP Server Version 2.4
| : | û α Ѵ |
|---|---|
| : | Base |
| : | log_config_module |
| ҽ: | mod_log_config.c |
Ŭ̾Ʈ û α Ӱ Ѵ. ڽ ϴ α ְ, ̳ ܺ α α ִ. α ϸ û ݿ û α ߰ϰų ִ.
þ Ѵ. TransferLog α
, LogFormat
ϴ ϰ, CustomLog ѹ αϰ
Ѵ. TransferLog
CustomLog þ ϸ
û Ͽ ִ.
LogFormat
CustomLog
þ ƱԸƮ ڿ̴. ڿ û
αϿ Ѵ. ڿ αϿ ״ Ǵ
ڿ ٲް Ÿ C "\n" "\t" ڸ
ִ. αϿ ǥ 齽 տ
ݵ 齽 Ѵ.
û Ư¡ ڿ "%" þ
Ͽ Ѵ. þ αϿ
ȴ.
| ڿ | |||||||
|---|---|---|---|---|---|---|---|
%% |
ۼƮ ȣ | ||||||
%...a |
IP-ּ | ||||||
%...A |
() IP-ּ | ||||||
%...B |
HTTP Ʈ. | ||||||
%...b |
HTTP Ʈ. CLF İ
0 '-' ´. | ||||||
%...{Foobar}C |
û Foobar Ű . | ||||||
%...D |
û óϴµ ɸ ð (ũ ). | ||||||
%...{FOOBAR}e |
ȯ溯 FOOBAR | ||||||
%...f |
ϸ | ||||||
%...h |
ȣƮ | ||||||
%...H |
û | ||||||
%...{Foobar}i |
û Foobar:
. | ||||||
%...l |
(ִٸ identd ) αθ.
mod_ident ְ IdentityCheck
On ƴϸ ȣ Ѵ. | ||||||
%...m |
û | ||||||
%...{Foobar}n |
ٸ Foobar Ʈ(note) . | ||||||
%...{Foobar}o |
Foobar: . | ||||||
%...p |
û ϴ Ʈ | ||||||
%...P |
û ϴ ڽ μ ID. | ||||||
%...{format}P |
û ϴ ڽ μ ID Ȥ
ID. format pid tid
ϴ.
| ||||||
%...q |
ǹڿ (ǹڿ ִٸ տ ?
̰, ٸ ڿ) | ||||||
%...r |
û ù° | ||||||
%...s |
(status). ̷ǵ û **
û ̴. û ´ %...>s. | ||||||
%...t |
common log format ð (ǥ ) ð | ||||||
%...{format}t |
strftime(3) format ð. (ð
) | ||||||
%...T |
û óϴµ ɸ ð ( ). | ||||||
%...u |
(auth ϸ, (%s)
401 ̻ ) | ||||||
%...U |
ǹڿ û URL . | ||||||
%...v |
û ServerName. | ||||||
%...V |
UseCanonicalName
. | ||||||
%...X |
.
(ġ 1.3 Ĺ þ
| ||||||
%...I |
û Ʈ 0 .
̸ Ϸ mod_logio ʿϴ. | ||||||
%...O |
۽ Ʈ 0 . ̸
Ϸ mod_logio ʿϴ. |
"..." ( ,
"%h %u %r %s %b") ƹ͵ ų,
´ ( ڸ "-" Ѵ).
տ "!" ̰ų Ⱥ HTTP ڵ
ۼѴ. , "%400,501{User-agent}i" 400 (Bad
Request) 501 (Not Implemented) ϶
User-agent: α ,
"%!200,304,302{Referer}i" ° ƴ
û Referer: α .
"<" ">" ̷ǵ û
ó û û Ѵ. ⺻
%s, %U, %T, %D, %r ó û ,
% þ û .
%>s û (status) ϰ,
%<u ȣ ʴ ڿ
̷ǵ 쿡 ó ڸ Ѵ.
2.0.46 httpd 2.0 %...r,
%...i, %...o ڿ ״
ξ. Common Log Format 䱸 ؼ.
, Ŭ̾Ʈ ڸ α ֱ
α ״ ٷ ؾ Ѵ.
Ȼ 2.0.46 ڳ ٸ Ưڸ
\xhh ǥѴ. ⼭ hh
ش Ʈ 16 ǥ Ÿ. Ģ ܴ 齽
տ ̴ " \, C
鹮ڵ(\n, \t )̴.
Ϲ ϴ α .
"%h %l %u %t \"%r\" %>s %b""%v %h %l %u %t \"%r\" %>s %b""%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\"""%{Referer}i -> %U""%{User-agent}i"û ϴ ServerName Listen %v
%p Ѵ. αм α û
ϴ ȣƮ ˱ ȣƮ ã ˰
ʿ ̵ UseCanonicalName ϴ.
| : | Buffer log entries in memory before writing to disk |
|---|---|
| : | |
| : | ּ |
| : | Base |
| : | mod_log_config |
Documentation not yet translated. Please see English version of document.
| : | α ̸ Ѵ |
|---|---|
| : | CustomLog file|pipe
format|nickname
[env=[!]environment-variable] |
| : | ּ, ȣƮ |
| : | Base |
| : | mod_log_config |
û α 涧 CustomLog
þ Ѵ. α ϰ, ȯ溯 Ͽ
û Ư¡ α ִ.
α Ҹ ϴ ù° ƱԸƮ ϳ Ѵ.
ServerRoot
ϸ.|"ڿ α ǥԷ
α θ ´.
α Ѵٸ α ȴ. root Ѵٸ α root ϹǷ α Ȯ϶.
н ƴ ÷ ϰθ ԷҶ ÷ 齽 ϴ ݵ ؾ Ѵ. Ϲ Ͽ ϴ .
ι° ƱԸƮ αϿ Ѵ.
LogFormat
nickname ϰų α format
ڿ ִ.
, þ Ȱ Ѵ.
# Ī CustomLog
LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common
# ڿ CustomLog
CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b"
° ƱԸƮ Ǹ, Ư ȯ溯
û α θ Ѵ. û
ȯ溯 ǵִٸ (Ȥ
'env=!name' ٸ)
û α Ѵ.
mod_setenvif mod_rewrite
Ͽ û ȯ溯 ִ.
, GIF û ּ αװ ƴ
ٸ αϿ Ϸ,
SetEnvIf Request_URI \.gif$ gif-image
CustomLog gif-requests.log common env=gif-image
CustomLog nongif-requests.log common env=!gif-image
| : | Sets filename and format of log file |
|---|---|
| : | GlobalLogfile|pipe
format|nickname
[env=[!]environment-variable|
expr=expression] |
| : | ּ |
| : | Base |
| : | mod_log_config |
| : | Available in Apache HTTP Server 2.4.19 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | αϿ Ѵ |
|---|---|
| : | LogFormat format|nickname
[nickname] |
| ⺻: | LogFormat "%h %l %u %t \"%r\" %>s %b" |
| : | ּ, ȣƮ |
| : | Base |
| : | mod_log_config |
þ α Ѵ.
LogFormat þ ΰ
Ѵ. ù° ƱԸƮ Ѱ Ͽ
TransferLog þ α
Ѵ. ƱԸƮ α
ϱ format
ϰų, LogFormat
þ ̸ (α Īϴ) nickname
ִ.
LogFormat þ ι°
format nickname Ѵ.
ڿ ϴ LogFormat̳ CustomLog þ ݺؼ
ڿ Էϴ nickname
ִ. Ī ϴ LogFormat
þ ܿ ƹ ʴ´.
, Ī ϸ, ϰų
⺻ ʴ´. Ƿ
TransferLog
þ ʴ´. ,
LogFormat Ī ٸ Ī
ִ. Ī ̸ ۼƮ ȣ(%)
϶.
LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Sunucuya yapılan isteklerin günlük kayıtlarının tutulması |
|---|---|
| Durum: | Temel |
| Modül Betimleyici: | log_config_module |
| Kaynak Dosyası: | mod_log_config.c |
Bu modül istemci isteklerinin esnek şekilde günlüklenmesi ile ilgilidir. Günlükler kişiselleştirilebilir biçemdedir ve doğrudan bir dosyaya yazılabileceği gibi boru üzerinden harici bir sürece de yazılabilir. İsteğin özelliklerine bağlı olarak bazı isteklerin günlüklere kaydedilmesi veya kaydedilmemesi mümkün kılınmıştır.
Bu modül üç yönerge içermektedir: Bir günlük dosyası oluşturmak için
TransferLog, günlük
biçemini kişiselleştirmek için LogFormat ve tek başına bir günlük
dosyasını hem tanımlayıp hem de biçemleyen CustomLog yönergesi. Her isteğin
çok sayıda dosyaya günlüklenmesini sağlamak için yapılandırma dosyasında
her sunucu için birden fazla TransferLog ve
CustomLog yönergesi belirtilebilir.
LogFormat ve CustomLog yönergelerinin biçem
argümanı bir dizgedir. Bu dizge her isteği günlük dosyasına günlüklemek
için kullanılır. Doğrudan günlük dosyalarına kopyalanmak üzere dizgesel
sabitler içerebileceği gibi satırsonu ve sekme karakterleri olarak C
tarzı "\n" ve "\t" denetim karakterlerini de içerebilir. Dizgesel sabit
olarak kullanılan tırnak ve tersbölü imlerinin tersbölü ile öncelenmesi
gerekir.
İstek özellikleri biçem dizgesine “%” imli belirteçler
yerleştirilerek günlüklenir. Bu belirteçler ve anlamları:
| Belirteç | Açıklama | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
%% |
Yüzde imi. | ||||||||||
%a |
Uzak IP adresi ve isteğin portu
(mod_remoteip modülüne bakın). | ||||||||||
%{c}a |
bağlantının emsal IP adresi and portu
(mod_remoteip modülüne bakın). | ||||||||||
%A |
Yerel IP adresi. | ||||||||||
%B |
HTTP başlıkları hariç, yanıtın bayt cinsinden uzunluğu. | ||||||||||
%b |
HTTP başlıkları hariç, yanıtın bayt cinsinden uzunluğu. OGB
biçeminde hiç bayt gönderilmemişse günlüğe '-' yerine
'0' çıktılanır. | ||||||||||
%{DEĞİŞKEN}C |
İstek içinde sunucuya gönderilen DEĞİŞKEN çerezinin içeriği. Sadece 0 sürümlü çerezler tam olarak desteklenir. | ||||||||||
%D |
Mikrosaniye cinsinden isteği sunmak için harcanan zaman. | ||||||||||
%{DEĞİŞKEN}e |
DEĞİŞKEN ortam değişkeninin içeriği. | ||||||||||
%f |
Dosya ismi. | ||||||||||
%h |
Uzak konak ismi. HostnameLookups yönergesine öntanımlı olan
Off değeri atanmışsa, IP adresi günlüğe kaydedilir. Bir
kaç konak için konak ismi de günlüğe kaydoluyorsa muhtemelen onların
isimlerini içeren erişim denetim yönergelerine sahipsinizdir. Bak: Require host. | ||||||||||
%{c}h |
%h gibi, ancak her zaman, temel TCP bağlantısının
konak adı kaydedilir, ancak mod_remoteip gibi modüller
tarafından uzak konak adında yapılan değişiklikler kaydedilmez. | ||||||||||
%H |
İstek Protokolü. | ||||||||||
%{DEĞİŞKEN}i |
İstekle birlikte sunucuya gönderilen
DEĞİŞKEN: başlık satır(lar)ının
içeriği. Diğer modüllerde (örn. mod_headers)
yapılan değişikliklerden etkilenir. Modüllerin çoğu bunu
değiştirdiğinde önceki istek başlık isminin ne olduğuyla
ilgileniyorsanız, başlığı bir ortam değişkenine kaydetmek için
mod_setenvif modülünü kullanın ve yukarıda
açıklandığı gibi bu değeri %{DEĞİŞKEN}e ile
günlüğe kaydedin. | ||||||||||
%k |
Bu bağlantıda işlenen isteklerin sayısı; yani örneğin,
'1' değeri bağlantı kurulduktan sonraki ilk kalıcı bağlantıyı,
'2', ikinci bağlantıyı, ..., vb. gösterir;
KeepAlive kullanılmışsa
değer anlamlıdır; aksi takdirde değer daima 0’dır. | ||||||||||
%l |
Uzak kullanıcı kimliği (sağlanmışsa, identd üzerinden).
mod_ident modülü mevcut ve IdentityCheck yönergesine değer
olarak On atanmış olmadıkça bu belirteç için günlüğe
tire imi yazılır. | ||||||||||
%L |
Hata günlüğündeki istek günlük kimliği (veya bu istek için hata günlüğüne hiçbir şey kaydedilmemise '-'). Bu hataya neyin sebep olduğunu öğrenmek için ilgili hata günlüğü satırına bakın. | ||||||||||
%m |
İstek yöntemi. | ||||||||||
%{DEĞİŞKEN}n |
Diğer modüldeki DEĞİŞKEN bilgisinin içeriği. | ||||||||||
%{DEĞİŞKEN}o |
Yanıttaki DEĞİŞKEN: başlık satır(lar)ının
içeriği. | ||||||||||
%p |
Sunucunun isteği sunduğu meşru port. | ||||||||||
%{biçem}p |
Sunucunun veya istemcinin gerçek portu veya sunucunun isteği
sunduğu meşru port. Geçerli biçemler: canonical,
local ve remote (anlamları sırasıyla:
meşru, yerel ve uzak). | ||||||||||
%P |
İsteği sunan çocuk sürecin süreç kimliği. | ||||||||||
%{biçem}P |
İsteği sunan çocuk sürecin süreç kimliği (pid) veya
evre kimliği (tid). Geçerli biçemler: pid,
tid, hextid. | ||||||||||
%q |
Sorgu dizgesi (bir sorgu dizgesi mevcutsa önüne bir ?
eklenir yoksa hiçbir şey eklenmez). | ||||||||||
%r |
İsteğin ilk satırı. | ||||||||||
%s |
Durum. Dahili olarak yönlendirilmiş istekler için isteğin
özgün durumudur. İsteğin son durumu için
%>s kullanınız. | ||||||||||
%t |
[18/Sep/2011:19:18:28 -0400] biçeminde isteğin
alındığı tarih ve saat. Sondaki sayı zaman diliminin GMT'ye
uzaklığıdır. | ||||||||||
%{biçem}t |
İsteğin alındığı tarih ve saat; biçem
uzatılmış strftime(3) biçeminde belirtilmelidir (genelde
yerelleştirme amaçlı). begin: (öntanımlı) ile başlayan
biçemlerde süre isteğin başlangıcına göredir. end: ile
başlayan biçemlerde ise süre isteğin işlenmesinin bi,tmesine yakın,
günlük girdisinin yazılmaya başladığı ana göredir.
strftime(3) tarafından desteklenen biçemlere ek olarak
aşağıdaki biçem dizgecikleri de desteklenmektedir:
strftime(3) biçemlemesiyle birlikte yer alamazlar fakat
çok sayıda %{biçem}t kullanılabilir.
| ||||||||||
%T |
Saniye cinsinden, isteği sunmak için harcanan zaman. | ||||||||||
%{BİRİM}T |
BİRİM ile belirtilen zaman birimi cinsinden, isteği
sunmak için harcanan zaman. Geçerli birimler: milisaniye için
ms, mikrosaniye için us, saniye için
s. s kullanımı birimsiz %T ile
aynı sonucu verir; us kullanımı %D ile aynı
sonucu verir. Birimli %T kullanımı 2.4.13 ve sonrasında
geçerlidir. | ||||||||||
%u |
Uzak kullanıcı (kimlik doğrulaması istenmişse vardır; durum kodu
(%s) 401 ise yanlış olabilir). | ||||||||||
%U |
Herhangi bir sorgu dizgesi içermeksizin istenen URL yolu. | ||||||||||
%v |
İsteği sunan sunucunun meşru sunucu ismi (ServerName). | ||||||||||
%V |
UseCanonicalName ayarı ile
ilgili sunucu ismi. | ||||||||||
%X |
Yanıt tamamlandığında bağlantı durumu:
| ||||||||||
%I |
İstek ve başlıklar dahil alınan bayt sayısı. Sıfır olamaz. Bunu
kullanmak için mod_logio etkin olmalıdır. | ||||||||||
%O |
Başlıklar dahil gönderilen bayt sayısı. Bir yanıtın
gönderilmesinden önce istekten vazgeçilmesi gibi nadir durumlarda
sıfır olabilir. Bunu kullanmak için mod_logio etkin
olmalıdır. | ||||||||||
%S |
Aktarılan bayt sayısı (alınan ve gönderilen), istekler ve başlıklar
dahil; sıfır olamaz. %I ve %O'nun birleşimidir. Bunu kullanmak için
mod_logio etkinleştirilmelidir. | ||||||||||
%{ALANADI}^ti |
Sunucuya gönderilen istekteki ALANADI:
Trailer satır(lar)ının içeriği. | ||||||||||
%{VARNAME}^to |
Sunucudan gönderilen yanıttaki ALANADI:
Trailer satır(lar)ının içeriği. |
Belli öğelerin sadece belli durum kodlarıyla ilgili yanıtlarla
basılabilmesi için bu durum kodları % iminden hemen sonra virgüllerle
ayrılmış olarak yazılabilir. Olumsuzlama belirtmek için durum kodu listesinin önüne bir "!" konabilir.
| Biçem Dizgesi | Anlamı |
|---|---|
%400,501{User-agent}i |
Sadece 400 ve 501 hatalarında User-agent günlüğe
kaydedilir. Diğer durum kodları için günlüğe "-" yazılır.
|
%!200,304,302{Referer}i |
200,304,302 durum kodlarından biriyle dönmeyen tüm istekler için
Referer başlığı durum koduyla birlikte günlüğe
kaydedilir. Aksi takdirde günlüğe "-" yazılır.
|
İsteğin dahili olarak yönlendirilmesinde özgün durumunun mu yoksa son
durumunun mu hesaba katılacağı "<" ve ">" değiştiricileri ile
belirtilebilir. Öntanımlı olarak %s, %U, %T, %D, ve
%r belirteçleri isteğin özgün durumuna bakarken diğerleri
son durumuna bakarlar. Bu bakımdan örneğin, %>s
belirteci, özgün istekteki kimliği doğrulanmış kullanıcının, dahili
olarak kimlik doğrulaması gerekmeyen bir özkaynağa yönlendirilmesi
halinde isteğin son durumunu kaydetmekte kullanılabilir.
Güvenlik nedeniyle, 2.0.46 sürümünden itibaren %r,
%i ve %o belirteçlerinde basılamayan
karakterler ve diğer özel karakterler \xhh
dizilimleri biçeminde öncelenmektedir. Burada hh yerine
karakter numarasının onaltılık gösterimi yazılır. Bir tersbölü ile
öncelenmesi gereken " ve \ ile
\n, \t gibi C tarzı gösterimler bu kuralın
dışındadır. 2.0.46 sürümünün öncesinde bu dizgeler öncelenmezdi ve ham
günlük dosyalarıyla çalışırken dikkatli olmak gerekirdi.
2.0 sürümünden beri 1.3 sürümünün aksine %b ve
%B biçem belirteçleri, istemciye gönderilen bayt sayısını
değil, HTTP yanıtının bayt sayısını ifade ederdi (bu yanıt, örneğin,
SSL kullanıldığında veya bağlantı koptuğunda farklı uzunlukta olur).
Artık, ağa gönderilen gerçek bayt sayısını günlüğe kaydetmek için
mod_logio modülü tarafından sağlanan %O
biçem belirteci kullanılmaktadır.
Ek bilgi: mod_cache standat bir eylemci olarak değil
hızlı bir eylemci olarak gerçeklenmiştir. Bu nedenle, içerik
arabelleklemesi sözkonusu olduğunda %R biçem dizgesi
herhangi bir eylemci bilgisi döndürmeyecektir.
Genelde herkesçe kullanılan günlük kaydı biçemleme dizgelerinden bazıları:
"%h %l %u %t \"%r\" %>s %b""%v %h %l %u %t \"%r\" %>s %b""%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\"""%{Referer}i -> %U""%{User-agent}i"msec_frac gibi ek biçem dizgeciklerini kullanan bir zaman
biçemi belirtmek isterseniz %{format}t biçem dizgesini
defalarca kullanabilirsiniz:
"%{%d/%b/%Y %T}t.%{msec_frac}t %{%z}t"Günlük dosyarının kaydedildiği dizine sunucuyu başlatan kullanıcı dışında diğer kullanıcılar tarafından yazılabiliyor olması halinde güvenliğinizden nasıl feragat etmiş olacağınız güvenlik ipuçları belgesinde açıklanmıştır.
| Açıklama: | Günlük girdilerini diske yazmadan önce bellekte tamponlar |
|---|---|
| Sözdizimi: | BufferedLogs On|Off |
| Öntanımlı: | BufferedLogs Off |
| Bağlam: | sunucu geneli |
| Durum: | Temel |
| Modül: | mod_log_config |
| Uyumluluk: | 2.0.41 ve sonrasında mevcuttur. |
BufferedLogs yönergesi,
mod_log_config modülünün çeşitli günlük girdilerini her
isteğin hemen ardından tek tek değil, bir bütün halinde diske yazılmak
üzere bellekte saklanmasını sağlar. Bu, bazı sistemlerde daha verimli
disk erişimi, dolayısıyla daha yüksek başarım sağlayabilir. Sadece
sunucu geneli için belirtilebilir, sanal konaklar için ayrı ayrı
yapılandırılamaz.
| Açıklama: | Günlük dosyasın ismini ve girdi biçemini belirler. |
|---|---|
| Sözdizimi: | CustomLog dosya|borulu-süreç
biçem|takma-ad
[env=[!]ortam-değişkeni]|
expr=ifade] |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Temel |
| Modül: | mod_log_config |
CustomLog yönergesi istekleri günlüğe kaydetmek
için kullanılır. Yönerge ile bir günlük biçemi belirtilebilir ve günlük
kaydı isteğin özelliklerine bağlı olarak ortam değişkenleri vasıtasıyla
şarta bağlı kılınabilir.
İlk argümanda günlüğün yazılacağı yer belirtilir. İki tür yer belirtilebilir:
ServerRoot yönergesinin
değerine göreli bir dosya ismi.|" boru karakteri ile öncelenmiş olarak günlük
bilgisini standart girdisinden kabul edecek sürecin ismi (veya komut
satırı) Daha fazla bilgi için borulu
günlüklere bakınız.
Bir borulu süreç kullanılmışsa, süreç httpd’yi
başlatan kullanıcı tarafından başlatılacaktır. Sunucu root tarafından
başlatılıyorsa bu root olacaktır; bu bakımdan günlük kaydını alacak
programın güvenilir olması önemlidir.
Dosya yolunu belirtirken tersbölü çizgisi kullanılan Unix dışı platformlarda bile yapılandırma dosyasında bu amaçla normal bölü çizgilerini kullanmaya özen gösterilmelidir.
İkinci argümanda günlüğe ne yazılacağı belirtilir. Ya evvelce
LogFormat yönergesi ile
tanımlanmış bir takma-ad ya da içeriği Günlük Girdilerinin Kişiselleştirilmesi bölümünde
açıklanmış bir biçem dizgesi olabilir.
Örneğin, aşağıdaki iki yönerge kümesi aynı etkiye sahiptir:
# Biçem dizgesi yerine takma ad içeren CustomLog LogFormat "%h %l %u %t \"%r\" %>s %b" common CustomLog "logs/access_log" common # Biçem dizgesinin kendisini içeren CustomLog CustomLog "logs/access_log" "%h %l %u %t \"%r\" %>s %b"
Üçüncü argüman isteğe bağlı olup,belli bir isteğin günlüğe kaydedilip
kaydedilmeyeceğini belirler. Koşul, sunucu ortamında belli bir değişkenin varlığı veya
yokluğu olabilir (bir 'env=!isim' durumu).
İstenirse koşul keyfi bir mantıksal ifade
olarak da belirtilebilir. Eğer koşul sağlanmazsa istek günlüğe
kaydedilmez. İfadede bulunan HTTP başlıklarına başvurular bu başlık
isimlerinin Vary başlığına eklenmesine sebep olmaz.
Ortam değişkenleri mod_setenvif
ve/veya mod_rewrite modülleri kullanılarak her istek
için ayrı ayrı atanabilir. Örneğin, GIF biçemli resimler için yapılan
istekleri ana günlük dosyasına değil de başka bir dosyaya kaydetmek
isterseniz:
SetEnvIf Request_URI \.gif$ gif-image CustomLog "gif-requests.log" common env=gif-image CustomLog "nongif-requests.log" common env=!gif-image
Veya eski RefererIgnore yönergesinin davranışını taklit
etmek isterseniz:
SetEnvIf Referer example\.com localreferer CustomLog "referer.log" referer env=!localreferer
| Açıklama: | Günlük dosyasının ismini ve biçemini belirler |
|---|---|
| Sözdizimi: | GlobalLog dosya|boru|sağlayıcı
biçem|takma_ad
[env=[!]ortam_değişkeni|
expr=ifade] |
| Bağlam: | sunucu geneli |
| Durum: | Temel |
| Modül: | mod_log_config |
| Uyumluluk: | Apache HTTP Sunucusunun 2.4.19 ve sonraki sürümlerinde kullanılabilir. |
GlobalLog yönergesi ana sunucu yapılandırması ve
tüm tanımlı sanal konaklarca paylaşılan bir günlük tanımlar.
GlobalLog yönergesi aşağıdaki farklar dışında
CustomLog yönergesine eşdeğerdir:
GlobalLog sanal konak bağlamında belirtilirse
geçersizdir.CustomLog yönergesinin tersine
GlobalLog yönergesini kendi
CustomLog yönergesiymiş gibi kullanır.| Açıklama: | Bir günlük dosyasında kullanılmak üzere girdi biçemi tanımlar. |
|---|---|
| Sözdizimi: | LogFormat biçem|takma-ad
[takma-ad] |
| Öntanımlı: | LogFormat "%h %l %u %t \"%r\" %>s %b" |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Temel |
| Modül: | mod_log_config |
Bu yönerge erişim günlüğü dosyasının girdi biçemini belirler.
LogFormat yönergesi iki şekilde kullanılabilir.
Tek argüman belirtilebilen ilkinde daha sonra
TransferLog yönergelerinde belirtilen günlüklerde
kullanılmak üzere günlük biçemini belirler. Bu günlük biçemi yukarıda
açıklanan biçem belirteçlerinden
oluşur. Bu tek argüman yerine aşağıda açıklandığı gibi önceki bir
LogFormat yönergesinde tanımlanmış bir günlük
biçemine atıf yapan bir takma-ad da belirtilebilir.
LogFormat yönergesinin ikinci kullanım şeklinde
biçem bir takma-ad için tanımlanır. Bu takma ad
daha sonraki LogFormat veya CustomLog yönergelerinde aynı biçem
dizgesini uzun uzadıya yazmamak için takma-ad olarak
kullanılır. Bir LogFormat yönergesi bir takma ad
tanımlamaktan başka bir şey yapmaz; yani, yaptığı iş
sadece bir takma ad tanımlamaktan ibarettir, biçemi uygulamaz veya
biçemi öntanımlı hale getirmez. Bu bakımdan sonraki TransferLog yönergelerini de
etkilemeyecektir. Ayrıca, LogFormat yönergesi bir
takma ada başka bir takma ad tanımlamakta da kullanılamaz. Bir takma
adın yüzde imi (%) içeremeyeceğine de dikkat ediniz.
LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common
| Açıklama: | Bir günlük dosyasının yerini belirtir. |
|---|---|
| Sözdizimi: | TransferLog dosya|borulu-süreç
[takma-ad] |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Temel |
| Modül: | mod_log_config |
Bir günlük biçemi tanımlanmasını ve şarta bağlı günlük kaydını mümkün
kılmaması haricinde CustomLog yönergesi gibidir. Günlük biçemi yerine kendinden
önce yer alan bir LogFormat yönergesinde tanımlanan
bir takma ad kullanılır. Açıkça bir günlük biçemi takma adı
belirtilmedikçe Ortak Günlük Biçemi öntanımlıdır.
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
TransferLog "logs/access_log"
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Sunucuya yapılan isteklerin adli günlük kayıtlarının tutulması |
|---|---|
| Durum: | Eklenti |
| Modül Betimleyici: | log_forensic_module |
| Kaynak Dosyası: | mod_log_forensic.c |
| Uyumluluk: | 2.1 sürümünden beri mod_unique_id gerekmemektedir. |
Bu modül istemci isteklerinin adli günlük kayıtlarının tutulmasını sağlar. Günlük kaydı bir istek işlenmeden önce ve sonra olmak üzere iki kere yapılır, böylece günlükte her istek için iki girdi bulunur. Adli günlükleyici çok sıkı kurallara tabidir, yani:
CoreDumpDirectory
yapılandırmasına bağlı olarak) bir core dosyası dökümler.Dağıtımın support dizininde bulunan
check_forensic betiği adli günlük dosyalarının
değerlendirilmesinde yardımcı olabilir.
Her istek günlüğe iki defa kaydedilir. İlki, işlemin başlangıcında (yani, başlıklar alındıktan hemen sonra), ikincisi ise istek işlem gördükten sonra normal günlüklemenin yapıldığı sırada yapılır.
Her isteği betimlemek için eşsiz bir istek kimliği atanır. Bu adli
kimliğin normal günlüğe de yazılması istenirse bu
%{forensic-id}n biçem dizgesi ile yapılabilir.
mod_unique_id kullanılıyorsa, onun ürettiği kimlik
kullanılır.
İlk satır günlüğe, adli kimliği, istek satırını ve alınan tüm
başlıkları boru karakterleri (|) ile ayrılmış olarak
kaydeder. Aşağıda bir örneğe yer verilmiştir (hepsi bir satırdadır):
+yQtJf8CoAB4AAFNXBIEAAAAA|GET /manual/de/images/down.gif
HTTP/1.1|Host:localhost%3a8080|User-Agent:Mozilla/5.0 (X11;
U; Linux i686; en-US; rv%3a1.6) Gecko/20040216
Firefox/0.8|Accept:image/png, etc...
Başlangıçtaki artı imi bu günlük satırının istekle ilgili ilk günlük kaydı olduğunu belirtir. İkinci satırda bunun yerini bir eksi imi alır:
-yQtJf8CoAB4AAFNXBIEAAAAA
check_forensic betiği komut satırı argümanı olarak günlük
dosyasının ismini alır. Bu +/- kimlik
çiftlerine bakarak tamamlanmamış istekler varsa bunlar hakkında
uyarır.
Günlük dosyarının kaydedildiği dizine sunucuyu başlatan kullanıcı dışında diğer kullanıcılar tarafından yazılabiliyor olması halinde güvenliğinizden nasıl feragat etmiş olacağınız güvenlik ipuçları belgesinde açıklanmıştır.
Günlük dosyaları, Authorization: başlıklarının (parola
içerebilen) içerikleri gibi hassas veriler içerebileceğinden bunların
sunucuyu başlatan kullanıcıdan başkası tarafından okunamaması sağlanmış
olmalıdır.
| Açıklama: | Adli günlük için dosya ismini belirler. |
|---|---|
| Sözdizimi: | ForensicLog dosya-adı|borulu-süreç |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Eklenti |
| Modül: | mod_log_forensic |
ForensicLog yönergesi adli inceleme için
sunucuya yapılan istekleri günlüğe kaydetmekte kullanılır. Her günlük
girdisine, normal CustomLog yönergesinde kullanılarak istekle
ilişkilendirilebilen eşsiz bir kimlik atanır.
mod_log_forensic modülü, aktarım günlüğünün biçem
dizgesinde %{forensic-id}n şeklinde kullanılmak üzere
forensic-id adı verilen bir dizgecik oluşturur.
Günlüğün yazılacağı yeri belirleyen argüman şu iki değerden birini alabilir:
ServerRoot yönergesinin
değerine göreli bir dosya ismi.|" boru karakteri ile öncelenmiş olarak günlük
bilgisini standart girdisinden kabul edecek sürecin ismi (veya komut
satırı). Program adının ServerRoot yönergesinin değerine göre belirtildiği
varsayılır.
Bir borulu süreç kullanılmışsa, süreç httpd’yi
başlatan kullanıcı tarafından başlatılacaktır. Sunucu root tarafından
başlatılıyorsa bu root olacaktır; bu bakımdan günlük kaydını alacak
programın güvenilir olması veya daha az yetkili bir kullanıcıya geçiş
yapması önemlidir.
Dosya yolunu belirtirken tersbölü çizgisi kullanılan Unix dışı platformlarda bile yapılandırma dosyasında bu amaçla normal bölü çizgilerini kullanmaya özen gösterilmelidir.
Serveur HTTP Apache Version 2.4
| Description: | Support de la couche transport HTTP/2 |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | http2_module |
| Fichier Source: | mod_http2.c |
| Compatibilité: | Disponible à partir de la version 2.4.17 du serveur HTTP Apache |
Ce module ajoute le support de HTTP/2 (RFC 7540) au serveur HTTP Apache.
Il s'appuie sur la bibliothèque libnghttp2 pour implémenter le moteur de base http/2.
Pour mettre en oeuvre les fonctionnalités décrites dans ce
document, vous devez activer HTTP/2 en utilisant la directive
Protocols. HTTP/2 n'imposant
pas de chiffrement, deux protocoles sont disponibles :
h2 (HTTP/2 avec TLS) at h2c (HTTP/2 avec TCP).
Voici deux types de configuration courant :
Protocols h2 http/1.1
Permet une négociation HTTP/2 (h2) via TLS ALPN au sein d'un
<VirtualHost>
sécurisé. La vérification du préambule HTTP/2 (mode direct, voir
H2Direct) est désactivée par
défaut pour h2.
Protocols h2 h2c http/1.1
Permet une négociation HTTP/2 (h2) via TLS ALPN au sein d'un
<VirtualHost>
sécurisé. Permet aussi une négociation HTTP/2 en texte pur (h2c) en
effectuant une mise à jour depuis une connexion initiale HTTP/1.1 ou via
une vérification du préambule HTTP/2 (mode direct, voir
H2Direct).
Si vous avez besoin d'informations supplémentaires à propos du protocole, veuillez vous reporter à la HTTP/2 FAQ.
H2CopyFiles H2Direct H2EarlyHint H2EarlyHints H2MaxDataFrameLen H2MaxHeaderBlockLen H2MaxSessionStreams H2MaxWorkerIdleSeconds H2MaxWorkers H2MinWorkers H2ModernTLSOnly H2OutputBuffering H2Padding H2ProxyRequests H2Push H2PushDiarySize H2PushPriority H2PushResource H2SerializeHeaders H2StreamMaxMemSize H2StreamTimeout H2TLSCoolDownSecs H2TLSWarmUpSize H2Upgrade H2WebSockets H2WindowSizeActiver HTTP/2 sur votre serveur Apache a un impact sur la consommation de ressources, et si votre site est très actif, il est conseillé d'en prendre sérieusement en compte les implications.
HTTP/2 attribue à chaque requête qu'il reçoit son propre thread de travail pour son traitement, la collecte des résultats et l'envoie de ces derniers au client. Pour y parvenir, il lui faut lancer des threads supplémentaires, et ceci constituera le premier effet notable de l'activation de HTTP/2.
Dans l'implémentation actuelle, ces threads de travail font partie
d'un jeu de threads distinct de celui des threads de travail du MPM
avec lequel vous êtes familié. Il s'agit simplement du mode de
fonctionnement actuel, et il n'en sera pas obligatoirement toujours
ainsi (il est cependant probable que la situation restera inchangée
avec la version 2.4.x). De par ce mode de fonctionnement, les
threads de travail HTTP/2, ou plus simplement H2 ne seront pas
affichés par mod_status. De même, ils ne seront pas
pris en compte par les directives du style ThreadsPerChild. Par contre, ils
utilisent par défaut la valeur de ThreadsPerChild si vous n'avez pas
spécifié d'autres valeurs via H2MinWorkers et H2MaxWorkers.
Autre changement à surveiller : la consommation de mémoire. En
effet, comme HTTP/2 conserve plus d'informations sur le serveur pour
gérer toutes les requêtes en cours, leurs priorités et
interdépendances, il aura toujours besoin de plus de mémoire que
pour un traitement en HTTP/1.1. Trois directives permettent de
limiter l'empreinte mémoire d'une connexion HTTP/2 : H2MaxSessionStreams, H2WindowSize et H2StreamMaxMemSize.
La directive H2MaxSessionStreams permet de limiter
le nombre de requêtes simultanées qu'un client peut envoyer sur une
connexion HTTP/2. La valeur que vous allez définir dépend de votre
site. La valeur par défaut qui est de 100 est largement suffisante,
et à moins que vous ne soyez un peu juste en mémoire, je vous
conseille de ne pas la modifier. La plupart des requêtes qu'envoie
un client sont des requêtes de type GET sans corps qui n'utilisent
que très peu de mémoire en attendant le démarrage du traitement.
La directive H2WindowSize
permet de définir la taille maximale que peut avoir le corps d'une
requête que le client envoie avant d'attendre que le serveur
en demande d'avantage. En d'autres termes, il s'agit de la quantité
de données que le serveur peut stocker dans son tampon, valable pour
une requête.
En outre, la directive H2StreamMaxMemSize permet de définir
la quantité de données de la réponse qui doit être mise en tampon.
Chaque requête étant prise en charge par un thread H2Worker et
produisant des données que le serveur tente de transmettre au client
via une connexion HTTP/2, si le client n'est pas en mesure de lire
ces données assez rapidement, la connexion les mettra en tampon et
interrompra l'exécution du thread H2Worker correspondant.
De nombreux site utilisent le même certificat TLS pour plusieurs serveurs virtuels. Ce certificat référence un nom de serveur générique comme '*.example.org' ou plusieurs noms de serveur différents. Les navigateurs qui utilisent HTTP/2 détectent ce comportement et réutilisent une connexion déjà ouverte pour ces serveurs.
Ceci améliore considérablement les performances, mais il y a un prix à payer : il faut accorder un soin tout particulier à la configuration de tels serveurs virtuels. Le problème réside dans le fait que plusieurs requêtes pour plusieurs serveurs virtuels vont se partager la même connexion TLS, et ceci empêche toute renégociation car le standard HTTP/2 l'interdit.
Ainsi, lorsque plusieurs de vos serveurs virtuels utilisent le même certificat et si vous souhaitez utiliser HTTP/2 pour y accéder, vous devez vous assurer que tous vos serveurs virtuels possèdent exactement la même configuration SSL. En particulier, ils doivent utiliser les mêmes protocole, algorithme de chiffrement et configuration pour la vérification du client.
Dans le cas contraire, Apache httpd le détectera et renverra au client un code de réponse spécial, 421 Misdirected Request.
Ce module peut être configuré pour fournir des informations en
rapport avec HTTP/2 sous la forme de variables d'environnement
supplémentaires dans l'espace de nommage SSI et CGI, ainsi que dans les
configurations personnalisées de le journalisation (voir
%{VAR_NAME}e).
| Nom variable : | Type : | Description : |
|---|---|---|
HTTPe | drapeau | HTTP/2 est utilisé. |
H2PUSH | drapeau | La fonctionnalité HTTP/2 Server Push est activée pour cette requête et supportée par le client. |
H2_PUSH | drapeau | autre nom pour H2PUSH |
H2_PUSHED | chaîne | vide ou
PUSHED pour une requête pushée par le serveur. |
H2_PUSHED_ON | nombre | numéro du flux HTTP/2 qui a déclenché le push de cette requête. |
H2_STREAM_ID | nombre | numéro du flux HTTP/2 de cette requête. |
H2_STREAM_TAG | chaîne | identifiant
de flux unique du processus HTTP/2 composé de l'identifiant de la
connexion et de l'identifiant du flux séparés par -. |
| Description: | Contrôle la gestion des fichiers dans les réponses |
|---|---|
| Syntaxe: | H2CopyFiles on|off |
| Défaut: | H2CopyFiles off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.24 du serveur HTTP Apache. |
Cette directive permet de définir la manière de gérer les
contenus de fichiers dans les réponses. Lorsqu'elle est à off
(sa valeur par défaut), les descripteurs de fichiers sont
transmis par le processus de traitement de la requête vers la
connexion principale en utilisant le système habituel de mise en
réserve d'Apache pour gérer le durée de vie du fichier.
Lorsqu'elle est à on, le contenu du fichier est
recopier pendant le traitement de la requête et ces données
mises en tampon sont transmises vers la connexion principale, ce
qui s'avère avantageux lorsqu'un module tiers injecte dans la
réponse des fichiers possédant des durées de vie différentes.
Un exemple de ces modules tiers : mod_wsgi qui peut
injecter des descripteurs de fichiers dans la réponse. Ces
fichiers sont fermés lorsque Python estime que le traitement est
terminé, alors que mod_http2 est probablement
encore loin d'en avoir fini avec eux.
| Description: | Activation du protocole H2 Direct |
|---|---|
| Syntaxe: | H2Direct on|off |
| Défaut: | H2Direct on pour h2c, off pour le protocole h2 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
Cette directive permet d'activer/désactiver
l'utilisation du mode HTTP/2 Direct. Elle doit être
située dans une section <VirtualHost> afin d'activer la
communication directe HTTP/2 pour le serveur virtuel
considéré.
La notion de communication directe signifie que si les premiers octets reçus par le serveur correspondent à un en-tête HTTP/2, le protocole HTTP/2 est utilisé sans négociation supplémentaire. Ce mode est défini pour les transmissions en clair (h2c) dans la RFC 7540. Son utilisation avec les connexions TLS n'est pas officiellement supportée.
Lorsque le protocole h2 ou h2c n'est pas activé via la
directive Protocols, la recherche d'un en-tête HTTP/2 n'est
jamais effectuée au sein d'une connexion. La directive
H2Direct ne produit alors aucun effet. Ceci est
important pour les connexions qui utilisent un protocole
pour lequel une lecture initiale peut entraîner un
blocage définitif comme NNTP.
Pour un client qui sait qu'un serveur supporte h2c, la communication directe HTTP/2 dispense le client d'une mise à jour HTTP/1.1, ce qui entraîne une amélioration des performances et évite les restrictions sur les corps de requête suite à une mise à jour.
Cette directive rend aussi h2c plus attractif pour les communications de serveur à serveur lorsque la connexion est sure ou peut être sécurisée d'une manière ou d'une autre.
H2Direct on
| Description: | Ajoute un en-tête de réponse à consulter dans le code de retour 103 Early Hints |
|---|---|
| Syntaxe: | H2EarlyHint name value |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.58 du serveur HTTP Apache. |
La directive H2EarlyHint permet d'ajouter
un en-tête de réponse avant le démarrage du traitement
proprement dit de la requête. Les en-têtes de ce style sont
consultables dans les réponses intermédiaires "103 Early Hints"
et ils ont pour but principal d'envoyer des informations de
"préchargement" aux navigateurs clients.
name et value doivent être des champs
d'en-tête HTTP valables sous peine de provoquer des échecs de
réponse. La directive H2EarlyHints doit
encore être activée pour permettre l'envoi de réponses
intermédiaires de code 103. Elle peut être répétée plusieurs
fois et les champs d'en-tête de même nom s'ajoutent.
H2EarlyHint Link "</my.css>;rel=preload;as=style"
| Description: | Contrôle l'envoi de codes d'état 103 |
|---|---|
| Syntaxe: | H2EarlyHints on|off |
| Défaut: | H2EarlyHints off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.24 du serveur HTTP Apache. |
Cette directive permet de définir si les réponses intermédiaires contenant un code d'état HTTP 103 doivent être envoyées au client ou non. Par défaut ce n'est actuellement pas le cas car certains clients ont encore des problèmes avec les réponses intermédiaires inattendues.
Lorsque cette directive est définie à on, les
ressources PUSHées définie par la directive H2PushResource déclenchent une
réponse intermédiaire 103 avant la réponse finale. Cette réponse
103 comporte des en-têtes Link qui provoquent le
préchargement des ressources considérées.
| Description: | Nombre maximal d'octets dans une trame HTTP/2 DATA |
|---|---|
| Syntaxe: | H2MaxDataFrameLen n |
| Défaut: | H2MaxDataFrameLen 0 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.58 du serveur HTTP Apache. |
La directive H2MaxDataFrameLen permet de
définir le nombre maximal d'octets du corps de réponse que l'on
peut placer dans une seule trame HTTP/2 DATA. La valeur 0
signifie aucune limite (mais la taille maximale permise par le
protocole est respectée).
Par défaut, le module essaie d'utiliser la taille maximale possible qui est d'environ 16 Ko. Il s'agit cependant de la taille maximale, et lorsque la taille des données de la réponse est inférieure, les trames envoyées sont plus courtes.
| Description: | Taille maximale des en-têtes d’une réponse |
|---|---|
| Syntaxe: | H2MaxHeaderBlockLen n |
| Défaut: | H2MaxHeaderBlockLen 0 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.64 du serveur HTTP Apache. |
La directive H2MaxHeaderBlockLen permet
de définir la taille maximale globale des en-têtes d’une
réponse. Définir cette directive à 0 implique une taille maximale
de 64 ko dans nghttp2, ce qui correspond à la valeur par défaut.
Les réponses dont la somme des tailles de tous les en-têtes est supérieure à la valeur de cette directive ne seront pas traitées et provoqueront une réinitialisation du flux.
| Description: | Nombre maximal de flux actifs par session HTTP/2. |
|---|---|
| Syntaxe: | H2MaxSessionStreams n |
| Défaut: | H2MaxSessionStreams 100 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
Cette directive permet de définir le nombre maximal de flux
actifs par session (connexion) HTTP/2 accepté par le serveur.
Selon la RFC 7540, un flux est considéré comme actif s'il n'est
ni en attente ni fermé.
H2MaxSessionStreams 20
| Description: | Nombre maximal de secondes pendant lequel une unité de traitement h2 pourra rester inactive sans être arrêtée. |
|---|---|
| Syntaxe: | H2MaxWorkerIdleSeconds n |
| Défaut: | H2MaxWorkerIdleSeconds 600 |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_http2 |
Cette directive permet de définir le nombre maximal de secondes
pendant lequel une unité de traitement h2 pourra rester inactive
avant de s'arrêter elle-même. Cet arrêt ne peut cependant se
produire que si le nombre d'unités de traitement h2 dépasse
H2MinWorkers.
H2MaxWorkerIdleSeconds 20
| Description: | Nombre maximal de threads à utiliser pour chaque processus enfant. |
|---|---|
| Syntaxe: | H2MaxWorkers n |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_http2 |
Cette directive permet de définir le nombre maximal de threads à
lancer pour le traitement HTTP/2 de chaque processus enfant. Si
cette directive n'est pas définie, mod_http2
choisira une valeur appropriée en fonction du module mpm
utilisé.
This directive sets the maximum number of worker threads to spawn
per child process for HTTP/2 processing. If this directive is not used,
mod_http2 will chose a value suitable for the mpm
module loaded.
H2MaxWorkers 20
| Description: | Nombre minimal de threads à utiliser pour chaque processus enfant. |
|---|---|
| Syntaxe: | H2MinWorkers n |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_http2 |
Cette directive permet de définir le nombre minimal de threads à
lancer pour le traitement HTTP/2 de chaque processus enfant. Si
cette directive n'est pas définie, mod_http2
choisira une valeur appropriée en fonction du module mpm
utilisé.
H2MinWorkers 10
| Description: | Impose les connexions HTTP/2 en mode "TLS moderne" seulement |
|---|---|
| Syntaxe: | H2ModernTLSOnly on|off |
| Défaut: | H2ModernTLSOnly on |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.18 du serveur HTTP Apache. |
Cette directive permet de définir si les vérifications de
sécurité sur les connexions HTTP/2 doivent être exclusivement en
mode TLS (https:). Elle peut être placée au niveau du serveur
principal ou dans une section <VirtualHost>.
Les vérifications de sécurité nécessitent TLSv1.2 au minimum et l'absence de tout algorithme de chiffrement listé dans la RFC 7540, Appendix A. Ces vérifications seront étendues lorsque de nouveaux prérequis en matière de sécurité seront mis en place.
Le nom provient des définitions Mozilla Security/Server Side TLS où il est question de "modern compatibility". Mozilla Firefox et d'autres navigateurs imposent la "modern compatibility" pour les connexions HTTP/2. Comme toute chose en matière de sécurité opérationnelle, c'est une cible mouvante susceptible d'évoluer dans le futur.
Un des buts de ces vérifications dans mod_http2 tend à imposer
ce niveau de sécurité pour toutes les connexions, et non
seulement celles en provenance des navigateurs web. Un autre but
est l'interdiction d'utiliser HTTP/2 en tant que protocole dans
les négociations si les prérequis ne sont pas respectés.
En fin de compte, la sécurité de la connexion TLS est déterminée
par les directives de configuration du serveur pour mod_ssl.
H2ModernTLSOnly off
| Description: | Contrôle la mise en tampon du flux de sortie |
|---|---|
| Syntaxe: | H2OutputBuffering on|off |
| Défaut: | H2OutputBuffering on |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.48 du serveur HTTP Apache. |
La directive H2OutputBuffering permet de
contrôler la mise en tampon du flux de sortie. La valeur par
défaut est on, ce qui correspond au comportement des versions
précédentes. Lorsqu'elle est à off, chaque octet est
immédiatement disponible pour envoi au client via la connexion
principale. Ceci permet de résoudre les problèmes
d'inter-opérations avec certaines versions de gRPC.
| Description: | Spécifie un intervalle de nombres d'octets de bourrage à ajouter aux trames utiles |
|---|---|
| Syntaxe: | H2Padding numbits |
| Défaut: | H2Padding 0 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.39 du serveur HTTP Apache. |
La valeur par défaut 0 indique qu'aucun octet de bourrage ne sera ajouté aux trames utiles comme HEADERS, DATA et PUSH_PROMISE. Ceci correspond au comportement des versions précédentes. Dans ce cas et sous certaines conditions, un observateur du trafic réseau pourra alors déterminer la longueur de ces trames dans le flux TLS.
Si on attribue à numbits la valeur 1-8, un nombre aléatoire d'octets entre 0 et 2^numbits sont ajoutés à chaque trame. Une valeur aléatoire d'octets de bourrage est attribué indépendamment à chaque trame que le module renvoie au client.
Pour améliorer la dissimulation de la longueur des trames, on peut augmenter le nombre moyen d'octets de bourrage, mais cela augmente d'autant le trafic réseau. Le nombre optimal d'octets de bourrage dépend donc du type de trafic web que le serveur engendre.
La valeur par défaut de 0 (aucun octet de bourrage) a été choisie dans un but de compatibilité ascendante. Il peut en effet exister des installations où les octets de bourrage ne sont pas souhaités ou sont néfastes. La cause principale peut provenir d'un client dont l'implémentation comporte des erreurs.
| Description: | Active/Désactive les requêtes sous mandat direct via HTTP/2 |
|---|---|
| Syntaxe: | H2ProxyRequests on|off |
| Défaut: | H2ProxyRequests off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.58 du serveur HTTP Apache |
La directive H2ProxyRequests permet
d'activer ou de désactiver la gestion des requêtes HTTP/2 dans
un contexte de mandat direct.
Similaire à ProxyRequests,
cette directive déclenche le traitement nécessaire des requêtes
lorsque HTTP/2 est activé dans un contexte de mandat direct.
| Description: | Activation/désactivation du server push H2 |
|---|---|
| Syntaxe: | H2Push on|off |
| Défaut: | H2Push on |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.18 du serveur HTTP Apache. |
Cette directive permet d'activer/désactiver l'utilisation de la fonctionnalité server push du protocole HTTP/2.
Lorsqu'un client demande une ressource particulière, le protocole HTTP/2 permet au serveur de lui fournir des ressources supplémentaires. Ceci s'avère utile lorsque ces ressources sont reliées entre elles, ce qui peut laisser supposer que le client va probablement les demander dans un délai plus ou moins long. Le mécanisme de pushing permet alors au client d'économiser le temps qu'il lui aurait fallu pour demander ces ressources supplémentaires lui-même. Par contre, fournir au client des ressources dont il n'a pas besoin ou qu'il possède déjà constitue une perte de bande passante.
Les server pushes sont détectés en inspectant les
en-têtes Link des réponses (voir
https://tools.ietf.org/html/rfc5988 pour la
spécification). Lorsqu'un lien spécifié de cette manière
possède l'attribut rel=preload, il est
considéré comme devant faire l'objet d'un push.
Les en-têtes link des réponses sont soit définis par
l'application, soit configurés via
H2PushResource ou
mod_headers comme suit :
<Location /index.html>
Header add Link "</css/site.css>;rel=preload"
Header add Link "</images/logo.jpg>;rel=preload"
</Location>
Comme le montre l'exemple, il est possible d'ajouter autant d'en-têtes link que l'on souhaite à une réponse, ce qui déclenchera autant de pushes. Cette fonctionnalité doit donc être utilisée avec prudence car le module ne vérifie pas si une ressource n'a pas déjà été "pushée" vers un client.
Les PUSH HTTP/2 sont activés par défaut. Vous pouvez activer/désactiver cette fonctionnalité pour toute connexion au serveur au niveau global ou serveur virtuel. Vous pouvez en outre désactiver PUSH pour un jeu de ressources dans une section Directory/Location. Notez que ceci permet de contrôler quelles ressources peuvent déclencher un PUSH, mais pas les ressources qui peuvent être envoyées via PUSH.
H2Push off
Enfin, il est important de savoir que les pushes ne se produisent que si le client en manifeste le désir ; la plupart des navigateurs le font, mais certains, comme Safari 9, ne le font pas. En outre, les pushes ne se produisent que pour les ressources de la même autorité que celle de la réponse originale.
| Description: | Taille du journal des Pushes H2 |
|---|---|
| Syntaxe: | H2PushDiarySize n |
| Défaut: | H2PushDiarySize 256 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.19 du serveur HTTP Apache. |
Cette directive permet de définir le nombre maximum de pushes
qui seront enregistrés pour une connexion HTTP/2. Elle peut être
placée dans une section <VirtualHost> afin de définir le nombre
de pushes pour le serveur virtuel considéré.
Le journal des pushes enregistre un condensé des ressources préchargées (leurs URLs) afin d'éviter les duplications de pushes pour une même connexion. Cependant, ces données ne sont pas conservées, et les clients qui ouvrent une nouvelle connexion se verront à nouveau affecter les mêmes pushes.
Si la taille maximale est atteinte, les nouvelles entrées remplacent les plus anciennes. Une entrée du journal nécessitant 8 octets, un journal de 256 entrées consomme 2 Ko de mémoire.
Si cette directive est définie à 0, le journal des pushes est désactivé.
| Description: | Priorité des pushes H2 |
|---|---|
| Syntaxe: | H2PushPriority mime-type [after|before|interleaved] [weight] |
| Défaut: | H2PushPriority * After 16 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.18 du serveur HTTP Apache. Nécessite la bibliothèque nghttp2 version 1.5.0 ou supérieure. |
Cette directive permet de définir une gestion de priorité des pushes en fonction du type de contenu de la réponse. Elle est en général définie au niveau du serveur principal, mais peut aussi l'être au niveau d'un serveur virtuel.
Les pushes HTTP/2 sont toujours liés à une requête client. Chaque paire requête/réponse de cette sorte, ou flux, possède une dépendance et un poids qui définissent la priorité du flux.
Lorsqu'un flux dépend d'un autre, disons X dépend de Y, alors Y reçoit toute la bande passante avant que X n'en reçoive ne serait-ce qu'une partie. Notez que cela ne signifie en rien que Y bloque X ; en effet, si Y n'a aucune donnée à envoyer, toute la bande passante qui lui est allouée peut être utilisée par X.
Lorsque plusieurs flux dépendent d'un même autre flux, disons X1 et X2 dépendent tous deux de Y, le poids détermine la bande passante allouée. Ainsi, si X1 et X2 possèdent le même poids, ils recevront tous deux la moitié de la bande passante disponible. Si le poids de X1 est égal au double de celui de X2, X1 recevra une bande passante double de celle de X2.
En fin de compte, tout flux dépend du flux racine qui reçoit toute la bande passante disponible mais n'envoie jamais de données. Cette bande passante est ainsi répartie entre les flux enfants selon leur poids. Ces derniers l'utilisent alors pour envoyer leurs données ou pour la répartir entre leurs propres flux enfants, et ainsi de suite. Si aucun des flux enfants n'a de données à envoyer, la bande passante est attribuée à d'autres flux selon les mêmes règles.
Ce système de priorités a été conçu de façon a toujours pouvoir utiliser la bande passante disponible tout en définissant des priorités et en attribuant des poids aux différents flux. Ainsi, tous les flux sont en général initialisés par le client qui lui-même définit les priorités.
Seul le fait de savoir qu'un flux implique un PUSH permet au serveur de décider quelle est la priorité initiale d'un tel flux. Dans les exemples ci-dessous, X est le flux client. Il dépend de Y et le serveur décide de "PUSHer" les flux P1 et P2 sur X.
La règle de priorité par défaut est :
H2PushPriority * After 16
Elle peut se traduire par "Envoyer un flux PUSH avec tout type de contenu et dépendant du flux client avec le poids 16". P1 et P2 seront alors envoyés après X, et comme leurs poids sont identiques, il se verront allouer la même quantité de bande passante.
H2PushPriority text/css Interleaved 256
Ce qui peut se traduire par "Envoyer toute ressource CSS dans la
même dépendance et avec le même poids que le flux client". Si le
type de contenu de P1 est "text/css", il dépendra de Y (comme X)
et son poids effectif sera calculé selon la formule : P1ew
= Xw * (P1w / 256). Si P1w est de 256, Le poids effectif
de P1 sera le même que celui de X. Si X et P1 ont des données à
envoyer, il se verront allouer la même quantité de bande
passante.
Avec un Pw de 512, un flux entrelacé et PUSHé aura un poids double de celui de X. Avec un poids de 128, son poids ne sera que la moitié de celui de X. Notez que les poids effectifs sont toujours plafonnés à 256.
H2PushPriority application/json Before
Dans cet exemple, tout flux PUSHé dont le contenu est de type 'application/json' sera envoyé avant X, ce qui rend P1 dépendant de Y et X dépendant de P1. Ainsi, X sera mis en attente aussi longtemps que P1 aura des données à envoyer. Le poids effectif est hérité du flux client, et l'attribution d'un poids spécifique n'est pas autorisée.
Vous devez garder à l'esprit que les spécifications en matière de priorités sont limitées par les ressources disponibles du serveur. Si un serveur ne dispose d'aucun processus/thread de travail pour les flux PUSHés, les données du flux considéré ne seront envoyées que lorsque les autres flux auront terminé l'envoi des leurs.
Enfin et surtout, il convient de tenir compte de certaines particularités de la syntaxe de cette directive :
H2PushPriority application/json 32 # une règle de priorité 'After' H2PushPriority image/jpeg before # poid hérité H2PushPriority text/css interleaved # poids de 256 par défaut
| Description: | Déclare des ressources à proposer ("pusher") au client |
|---|---|
| Syntaxe: | H2PushResource [add] path [critical] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.24 du serveur HTTP Apache. |
Lorsqu'il sont activés pour un répertoire, les PUSHes HTTP/2 seront tentés pour tous les chemins ajoutés via cette directive. Cette dernière peut être utilisée plusieurs fois pour le même répertoire.
Cette directive propose des ressources beaucoup plus tôt que les
en-têtes Link de mod_headers.
mod_http2 présente ces ressources au client via
une réponse intermédiaire 103 Early Hints. Ceci
implique que les clients qui ne supportent pas PUSH recevront
quand-même rapidement des propositions de préchargement.
A la différence de la définition d'en-têtes de réponse
Link via mod_headers, cette
directive n'aura d'effet que pour les connexions HTTP/2.
En ajoutant l'option critical à une telle
ressource, le serveur la traitera prioritairement, et une fois
les données disponibles, ces dernières seront envoyées avant les
données de la requête principale.
| Description: | Active/désactive la sérialisation du traitement des requêtes/réponses |
|---|---|
| Syntaxe: | H2SerializeHeaders on|off |
| Défaut: | H2SerializeHeaders off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
Cette directive permet de définir si les requêtes HTTP/2 doivent
être sérialisées au format HTTP/1.1 pour être traitées par le
noyau de httpd, ou si les données binaires reçues
doivent être passées directement aux request_recs.
La sérialisation dégrade les performances, mais garantit une meilleure compatibilité ascendante lorsque des filtres ou programmes accroche personnalisés en ont besoin.
H2SerializeHeaders on
| Description: | Quantité maximale de données en sortie mises en tampon par flux. |
|---|---|
| Syntaxe: | H2StreamMaxMemSize bytes |
| Défaut: | H2StreamMaxMemSize 65536 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
Cette directive permet de définir la quantité maximale de données en sortie mises en tampon mémoire pour un flux actif. Ce tampon mémoire n'est pas alloué pour chaque flux en tant que tel. Les quantités de mémoire sont définies en fonction de cette limite lorsqu'elles sont sur le point d'être allouées. Le flux s'arrête lorsque la limite a été atteinte, et ne reprendra que lorsque les données du tampon auront été transmises au client.
H2StreamMaxMemSize 128000
| Description: | Temps d'attente maximum lors de l'envoi/réception de données pour le traitement d'un flux |
|---|---|
| Syntaxe: | H2StreamTimeout time-interval[s] |
| Défaut: | La valeur de la directive |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.55 du serveur HTTP Apache. |
H2StreamTimeout permet de spécifier le
temps maximum pendant lequel un flux en cours de traitement
attendra pour l'envoi/réception de ses données.
| Description: | Durée d'inactivité d'une connexion TLS avant diminution de la taille des paquets |
|---|---|
| Syntaxe: | H2TLSCoolDownSecs seconds |
| Défaut: | H2TLSCoolDownSecs 1 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.18 du serveur HTTP Apache. |
Cette directive permet de spécifier le nombre de secondes avant
lequel une connexion TLS inactive va diminuer
la taille des paquets de données à une valeur inférieure (~1300
octets). Elle peut être définie au niveau du serveur principal
ou pour un <serveur
virtuel> spécifique.
Voir la directive H2TLSWarmUpSize pour une description
du "préchauffage" de TLS. La directive H2TLSCoolDownSecs met en
lumière le fait que les connexions peuvent se détériorer au bout
d'un certain temps (et au fur et à mesure des corrections du
flux TCP), et cela même si elle sont inactives. Pour ne pas
détériorer les performances d'une manière générale, il est par
conséquent préférable de revenir à la phase de préchauffage
lorsqu'aucune donnée n'a été transmise pendant un certain nombre
de secondes.
Dans les situations où les connexions peuvent être considérées comme fiables, ce délai peut être désactivé en définissant cette directive à 0.
Dans l'exemple suivant, la directive est définie à 0, ce qui désactive tout retour à une phase de préchauffage des connexions TLS. Les connexions TLS déjà préchauffées conservent donc toujours leur taille de paquet de données maximale.
H2TLSCoolDownSecs 0
| Description: | Taille des paquets durant la phase initiale de la connexion TLS |
|---|---|
| Syntaxe: | H2TLSWarmUpSize amount |
| Défaut: | H2TLSWarmUpSize 1048576 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.18 du serveur HTTP Apache. |
Cette directive permet de définir le nombre d'octets à envoyer
dans les petits enregistrements TLS (~1300 octets) avant
d'atteindre leur taille maximale de 16 ko pour les connexions
https: HTTP/2. Elle peut être définie au niveau du serveur
principal ou pour des <Serveurs virtuels> spécifiques.
Les mesures effectuées par les laboratoires de performances de Google montrent que les meilleurs performances sont atteintes pour les connexions TLS si la taille initiale des enregistrements reste en deça du niveau du MTU afin de permettre à la totatlité d'un enregistrement d'entrer dans un paquet IP.
Comme TCP ajuste son contrôle de flux et sa taille de fenêtre, des enregistrements TLS trop longs peuvent rester en file d'attente ou même être perdus et devoir alors être réémis. Ceci est bien entendu vrai pour tous les paquets ; cependant, TLS a besoin de la totalité de l'enregistrement pour pouvoir le déchiffrer. Tout octet manquant rendra impossible l'utilisation de ceux qui ont été reçus.
Lorqu'un nombre suffisant d'octets a été transmis avec succès, la connexion TCP est stable, et la taille maximale (16 ko) des enregistrements TLS peut être utilisée pour des performances optimales.
Dans les architectures où les serveurs sont atteints par des machines locales ou pour les connexions de confiance seulement, la valeur de cette directive peut être définie à 0, ce qui a pour effet de désactiver la "phase de chauffage".
Dans l'exemple suivant, la phase de chauffage est effectivement désactivée en définissant la directive à 0.
H2TLSWarmUpSize 0
| Description: | Activation/Désactivation du protocole de mise à jour H2 |
|---|---|
| Syntaxe: | H2Upgrade on|off |
| Défaut: | H2Upgrade on pour h2c, off pour h2 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_http2 |
Cette directive permet d'activer/désactiver l'utilisation de la
méthode de mise à jour pour passer de HTTP/1.1 à HTTP/2. Elle
doit être placée dans une section <VirtualHost> afin d'activer la mise à
jour vers HTTP/2 pour le serveur virtuel considéré.
Cette méthode de changement de protocole est définie dans HTTP/1.1 et utilise l'en-tête "Upgrade" (d'où son nom) pour indiquer l'intention d'utiliser un autre protocole. Cet en-tête peut être présent dans toute requête sur une connexion HTTP/1.1.
Elle activée par défaut pour les transmissions en clair (h2c), et désactivée avec TLS (h2), comme préconisé par la RFC 7540.
Sachez cependant que les mises à jour ne sont acceptées que pour
les requêtes qui ne possèdent pas de corps. Le requêtes de type
POST et PUT avec un contenu ne feront jamais l'objet d'une mise
à jour vers HTTP/2. Se référer à la documentation de la
directive H2Direct pour
envisager une alternative à Upgrade.
Cette directive n'a d'effet que si h2 ou h2c est activé via la
directive Protocols.
H2Upgrade on
| Description: | Active/désactive les WebSockets via HTTP/2 |
|---|---|
| Syntaxe: | H2WebSockets on|off |
| Défaut: | H2WebSockets off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
| Compatibilité: | Disponible à partir de la version 2.4.58 du serveur HTTP Apache |
La directive H2WebSockets permet
d'activer ou de désactiver l'amorçage des WebSockets via le
protocole HTTP/2. Cette extension du protocole est définie dans
la RFC 8441.
Ces requêtes sont similaires à CONNECT, mais elles possèdent l'en-tête supplémentaire ':protocol'. Elles sont transformées au sein du module en leurs équivalents HTTP/1.1 avant d'être soumises au traitement interne.
Cela signifie que les WebSockets HTTP/2 peuvent être utilisés
dans le cadre d'une directive ProxyPass avec le paramètre
'upgrade=websocket' sans autres modifications.
Pour les modules tiers qui gèrent les WebSockets directement dans le serveur, l'amorçage du protocole lui-même fonctionnera aussi. Dans le cas de HTTP/2 cependant, le transfert de données nécessite une prise en charge supplémentaire. Le WebSocket négocié sera incapable d'utiliser le socket de connexion du client pour examiner les évènements d'entrée/sortie concernés.
Cette fonctionnalité étant susceptible de briser la compatibilité ascendante pour de tels modules tiers, elle n'est pas activée par défaut.
| Description: | Taille maximale des paquets de données pour les transmissions client vers serveur. |
|---|---|
| Syntaxe: | H2WindowSize bytes |
| Défaut: | H2WindowSize 65535 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_http2 |
Cette directive permet de définir la taille maximale des paquets de données envoyés par le client au serveur, et limite la quantité de données que le serveur doit mettre en tampon. Le client arrêtera d'envoyer des données sur un flux lorsque cette limite sera atteinte jusqu'à ce que le serveur indique qu'il dispose d'un espace suffisant (car il aura traité une partie des données).
Cette limite n'affecte que les corps de requêtes, non les métadonnées comme les en-têtes. Par contre, elle n'affecte pas les corps de réponses car la taille maximale de ces derniers est gérée au niveau des clients.
H2WindowSize 128000
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Her isteğin girdi ve çıktı uzunluklarının günlüklenmesi. |
|---|---|
| Durum: | Eklenti |
| Modül Betimleyici: | logio_module |
| Kaynak Dosyası: | mod_logio.c |
Bu modül her istekte alınan ve gönderilen bayt sayısının günlüklenmesini sağlar. Sayılar, istekte ve yanıtta yer alan başlıklar ve gövdeleri hesaba dahil ederek ağ üzerinde gerçekte gidip gelen bayt sayısını gösterir. Bayt sayımı, girdide SSL/TLS öncesinde ve çıktıda SSL/TLS sonrasında yapılır, böylece sayıların, şifrelemeyle herhangi bir değişikliği doğru olarak yansıtması sağlanmış olur.
Bu modül mod_log_config modülünü gerektirir.
KeepAlive bağlantılar kullanıldığında, SSL
uzlaşımının ek yükü, bağlantı üzerinden yapılan ilk isteğin bayt sayısını
yansıtır. Her dizin için yeniden uzlaşım gerektiği takdirde bayt sayısı
yeniden uzlaşımı tetikleyen istekle ilişkilendirilir.İsteğin belirgin özellikleri için, biçem dizgesinde yer alan % imli biçem belirteçlerinin yerine günlük dosyasında değerleri yazılır. Bu modül üç yeni biçem belirteci ekler:
| Biçem Belirteci | Açıklama |
|---|---|
%I |
İstek gövdesi ve başlıklar dahil alınan bayt sayısı; sıfır olamaz. |
%O |
Başlıklar dahil gönderilen bayt sayısı; sıfır olamaz. |
%S |
Aktarılan bayt sayısı (alınan ve gönderilen), istekler ve başlıklar
dahil; sıfır olamaz. %I ve %O'nun birleşimidir. Apache 2.4.7 ve sonrasında kullanılabilmektedir. |
%^FB |
İstek gelip yanıt başlıklarının ilk baytı yazılana kadar mikrosaniye cinsinden geçen zaman. Sadece LogIOTrackTTFB yönergesine ON atanmışsa kullanılabilir.Apache 2.4.13 ve sonrasında kullanılabilir. |
Genel olarak, işlevsellik şöyle kullanılır:
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\" %I %O"| Açıklama: | İlk baytın yazılmasına kadar geçen süreyi izler |
|---|---|
| Sözdizimi: | LogIOTrackTTFB ON|OFF |
| Öntanımlı: | LogIOTrackTTFB OFF |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | All |
| Durum: | Eklenti |
| Modül: | mod_logio |
| Uyumluluk: | Apache 2.4.13 ve sonrasında kullanılabilir |
Bu yönerge isteğin okunmasından yanıt başlığının ilk baytının
yazılmasına kadar geçen sürenin izlenmesini yapılandırır. Sonuçlanan
değeri %^FB biçemi ile günlüğe kaydettirebilirsiniz.
Apache HTTP サーバ バージョン 2.4
| 説明: | リクエストされたファイルの拡張子とファイルの振る舞い (ハンドラとフィルタ)、内容 (MIME タイプ、言語、文字セット、エンコーディング) とを関連付ける |
|---|---|
| ステータス: | |
| モジュール識別子: | mime_module |
| ソースファイル: | mod_mime.c |
このモジュールは拡張子を使っていろいろな「メタ情報」をファイルに
関連付けるために使用されます。この情報はドキュメントのファイル名と
MIME タイプ、言語、文字セット、エンコーディングとを関連付けます。
この情報はブラウザに送られますし、複数のファイルの中からユーザの好みの
ものが選ばれるように、コンテントネゴシエーションでも使われます。
コンテントネゴシエーション
に関する詳しい情報は mod_negotiation
をご覧下さい。
AddCharset ディレクティブ、
AddEncoding ディレクティブ、
AddHandler ディレクティブ、
AddLanguage ディレクティブ、
AddType ディレクティブはすべて、
ファイルの拡張子をメタ情報にマップするために使用されます。
それぞれ、ドキュメントの文字セット (訳注: charset)、content-encoding,
content-language, MIME タイプ (content-type) を設定します。
TypesConfig ディレクティブは拡張子を
MIME タイプにマップするファイルを指定するために使用されます。
さらに、mod_mime はコンテンツを作成、処理する
ハンドラ と フィルタ
を設定することができます。AddHandler ディレクティブ、AddOutputFilter ディレクティブ、AddInputFilter ディレクティブは
ドキュメントを扱うモジュールやスクリプトを制御します。
MultiviewsMatch ディレクティブは
これらのディレクティブが指定したファイルの拡張子を
mod_negotiation が Multiviews のマッチをとるときに
考慮するようにできます。
mod_mime はメタ情報をファイル名と関連付けますが、
core サーバにはあるコンテナ
(たとえば, <Location>, <Directory>, <Files>) の中のすべてのファイルを特定の
メタ情報と関連付けるディレクティブがあります。これらのディレクティブには
ForceType, SetHandler, SetInputFilter, SetOutputFilter があります。
コアのディレクティブは mod_mime により定義された
ファイル名の拡張子のマッピングすべてを上書きします。
ファイルのメタ情報を変えても Last-Modified
ヘッダの値は変わらないことに注意してください。ですから、
それらを変更した場合は、クライアントやプロキシで以前にキャッシュされた
コピーがそのときのヘッダとともに使われる可能性があります。
メタ情報 (言語、コンテントタイプ、文字セット、エンコーディング) を
変更したときは、すべての訪問者が正しいコンテントヘッダを
受け取るように、影響を受けるファイルに 'touch' コマンドを実行する
(最終更新日を更新する) 必要があるかもしれません。
AddCharset AddEncoding AddHandler AddInputFilter AddLanguage AddOutputFilter AddType DefaultLanguage ModMimeUsePathInfo MultiviewsMatch RemoveCharset RemoveEncoding RemoveHandler RemoveInputFilter RemoveLanguage RemoveOutputFilter RemoveType TypesConfigファイルは複数の拡張子を持つことができ、拡張子の順番は通常は関係ありません。例えば、ファイル welcome.html.fr
がコンテントタイプは text/html
に、言語はフランス語にマップされる場合、welcome.fr.html
もまったく同じ情報にマップされます。
同じメタ情報にマップされる拡張子が複数あるときには、言語と
コンテントエンコーディングを除いて、
右側にあるものが使用されます。たとえば、.gif が MIME タイプ image/gif にマップされ、.html
が MIME タイプ text/html
にマップされる場合は、ファイル welcome.gif.html は
MIME タイプ text/html に関連付けられます。
リソースに複数の言語やエンコーディングを関連付けること
ができるため、
言語とコンテントエンコーディングは前のものに追加されていきます。
たとえば、ファイル welcome.html.en.de は
Content-Language: en, de と Content-Type:
text/html として送信されます。
複数の拡張子のあるファイルが MIME
タイプとハンドラの両方に関連付けられているときは注意する必要があります。
その場合、普通はリクエストがハンドラに関連付けられた
モジュールによって扱われることになります。たとえば、拡張子
.imap が (mod_imagemap の) imap-file
にマップされていて、.html が MIME タイプ text/html
にマップされているときは、ファイル world.imap.html は
imap-file ハンドラと text/html MIME
タイプに関連付けられます。ファイルが処理されるときは imap-file
ハンドラが使用されますので、そのファイルは mod_imagemap
のイメージマップファイルとして扱われることになります。
ファイル名のドット区切りでの最後の部分を使って、
特定の部分のメタデータにマッピングしたい場合は、
Add* ディレクティブは使わないでください。
たとえば foo.html.cgi を CGI スクリプトとして処理したいけれども、
bar.cgi.html は CGI スクリプトとしては処理したくない場合、
AddHandler cgi-script .cgi とする代わりに
次のようにしてください
<FilesMatch \.cgi$>
SetHandler cgi-script
</FilesMatch>
特定の MIME タイプ
のファイルはインターネットでの転送を簡単にするために、
さらに符号化することができます。これは通常は gzip の
ような圧縮のことを指しますが、pgp のような暗号化や、
バイナリファイルを ASCII (テキスト) 形式で送るために考案された
UUencoding のことを指すこともあります。
HTTP/1.1 RFC 14.11 節では次のように記述されています。
Content-Encoding エンティティヘッダフィールドはメディアタイプの 修飾子として使われます。それが存在していれば、値はエンティティボディに どの追加の符号化が適用されたかを示し、Content-Type ヘッダフィールドに 書かれているメディアタイプを得るためにどの復号機構を適用すべきか、も 示していることになります。Content-Encoding は主に、元のメディアタイプの 同一性を失うことなくドキュメントを圧縮することを可能にするために 使用されます。
複数のファイル拡張子 (複数の拡張子については 上の節 を参照) 使うことで、 ファイルのタイプやエンコーディングを指定することが できます。
たとえば、Microsoft Word のドキュメントがあり、サイズを小さくするために
pkzip されているとします。.doc 拡張子が Microsoft Word の
ファイルタイプと関連付けられていて、.zip 拡張子が
pkzip ファイルエンコーディングと関連付けられていると、ファイル
Resume.doc.zip は pkzip された Word ドキュメントである
ということがわかります。
クライアントのブラウザにエンコーディング方法を知らせるために、
Apache はリソースと共に Content-Encoding ヘッダを
送ります。
Content-encoding: pkzip
ファイルタイプとファイルエンコーディングの他に重要な情報は ドキュメントの書かれている言語と、どの文字セットでファイルが表示 されるべきか、というものです。たとえば、ドキュメントはベトナムの アルファベットやキリル文字で書かれていて、そのように表示される 必要があるかもしれません。この情報もまた、HTTP ヘッダで 送信されます。
文字セット、言語、エンコーディング、mime タイプはすべて
コンテントネゴシエーション (mod_negotiation 参照)
の最中に、複数の文字セット、言語、エンコーディング、MIME タイプからなる
代替物があるときにどのドキュメントをクライアントに送るのかを
決定するときに使われます。AddCharset,
AddEncoding, AddLanguage,
AddType の各ディレクティブで作成された
拡張子の関連付け (と MimeMagicFile でリストされている
拡張子) がこの選択に参加します。AddHandler,
AddInputFilter,
AddOutputFilter の
各ディレクティブでのみ関連付けられている拡張子は
MultiviewsMatch ディレクティブを
使うことでマッチの
処理に含めることも外すこともできます。
さらに情報を伝えるために、Apache は文書の言語を
Content-Language ヘッダで送ることもあります。
また、情報を正しく表示するために使用すべき文字セットを示すために
Conten-Type ヘッダに情報を追加することもあります。
Content-Language: en, fr
Content-Type: text/plain; charset=ISO-8859-1
言語の指定は二文字の短縮形で行なわれます。charset が
使用すべき文字セットの名前です。
| 説明: | ファイル名の拡張子を指定された文字セットにマップする |
|---|---|
| 構文: | AddCharset charset extension
[extension] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
AddCharset ディレクティブは、
与えられた拡張子を指定された charset にマップします。charset
は、拡張子 extension を含んでいるファイル名の
MIME charset
パラメータです。新しいマッピングは既にある他のマッピングに追加され、同じ拡張子
extension のためのマッピングを上書きします。
AddLanguage ja .ja
AddCharset EUC-JP .euc
AddCharset ISO-2022-JP .jis
AddCharset SHIFT_JIS .sjis
この場合、ドキュメント xxxx.ja.jis は charset が
ISO-2022-JP の日本語のドキュメントとして扱われます
(xxxx.jis.ja も同様)。AddCharset
ディレクティブは、ドキュメントが適切に解釈され表示されるように、
ドキュメントの charset の情報をクライアントに教えるために役に立ちます。
また、サーバがクライアントの charset
の優先度に基づいて複数のドキュメントの中からドキュメントを選ぶコンテントネゴシエーションのためにも役に立ちます。
引数 extensionは大文字小文字を区別せず、 最初のドットはあってもなくても構いません。 ファイル名は複数の拡張子を持つことができ、 extensionはそれぞれと比較されます。
| 説明: | ファイル名の拡張子を指定されたエンコーディング にマップする |
|---|---|
| 構文: | AddEncoding MIME-enc extension
[extension] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
AddEncoding ディレクティブは、
与えられた拡張子を指定されたエンコーディングにマップします。
MIME-enc は、拡張子 extension
を含んだドキュメントに使用する MIME エンコーディングです。
この新しいマッピングは既にある他のマッピングに追加され、
同じ拡張子 extension のためのマッピングを上書きします。
AddEncoding x-gzip .gz
AddEncoding x-compress .Z
これは、拡張子 .gz を含むファイル名が x-gzip
エンコーディングを使ってエンコードされていることと、拡張子 .Z
を含むファイル名が x-compress
でエンコードされていることを指定します。
古いクライアントは x-zip と x-compress
が返ってくることを期待しますが、標準規格ではそれぞれ
gzip と compress
と等価であることになっています。Apache
は、コンテントエンコーディングの比較をするときには、先頭にある
x- を無視します。Apache
がエンコーディング付きで応答を返すときは、クライアントが要求した形式
(すなわち、x-foo や foo)
を使用します。要するに、この二つのエンコーディングの場合は常に
x-gzip と x-compress
を使うべきである、ということです。deflate
のようなより新しいエンコーディングでは、x-
なしで指定してください。
引数 extension は大文字小文字を区別せず、 最初のドットはあってもなくても構いません。 ファイル名は複数の拡張子を持つことができ、 extensionはそれぞれと比較されます。
| 説明: | ファイル名の拡張子を指定されたハンドラにマップする |
|---|---|
| 構文: | AddHandler handler-name extension
[extension] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
拡張子 extension が名前にあるファイルは指定された handler-name に扱われます。
この新しいマッピングは既にある他のマッピングに追加され、
同じ拡張子 extension
のためのマッピングを上書きします。たとえば、拡張子
".cgi" で終わるファイルを CGI
スクリプトとして扱いたいときは、以下の設定をします。
AddHandler cgi-script .cgi
これを httpd.conf ファイルに記述することで、拡張子
".cgi" のファイルは CGI プログラムとして扱われます。
引数 extension は大文字小文字を区別せず、 最初のドットはあってもなくても構いません。 ファイル名は複数の拡張子を持つことができ、 extensionはそれぞれと比較されます。
| 説明: | ファイルの拡張子をクライアントのリクエストを処理する フィルタにマップする |
|---|---|
| 構文: | AddInputFilter filter[;filter...]
extension [extension] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
| 互換性: | 2.0.26 以降で使用可能 |
AddInputFilter はファイルの拡張子
extension をクライアントのリクエストや POST がサーバに来たときに
処理をするフィルタにマップします。
これは、SetInputFilter ディレクティブも
含め、他の場所で定義されているフィルタに加えられます。
このマッピングはすでにあるものより優先されてマージされ、
同じ extension に対する既存のマッピングを上書きします。
複数のfilterを指定するときは、データを処理する順番にセミコロンで 繋いで書く必要があります。filter は大文字小文字を区別しません。
引数 extension は大文字小文字を区別せず、 最初のドットはあってもなくても構いません。 ファイル名は複数の拡張子を持つことができ、 extensionはそれぞれと比較されます。
| 説明: | ファイル名を指定された言語にマップ |
|---|---|
| 構文: | AddLanguage MIME-lang extension
[extension] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
AddLanguage ディレクティブは、与えられた拡張子を指定された
content language にマップします。MIME-lang は、拡張子
extension を含んでいるファイル名の MIME における言語です。
この新しいマッピングは既にあるマッピングに追加され、同じ拡張子
extension のためのマッピングを上書きします。
AddEncoding x-compress .Z
AddLanguage en .en
AddLanguage fr .fr
この場合、xxxx.en.Z ドキュメントは compress
された英語のドキュメントとして扱われます (xxxx.Z.en
も同様)。content language はクライアントに通知されますが、
ブラウザがこの情報を使うことはおそらくありません。
AddLanguage
ディレクティブは、サーバがクライアントの言語の優先度に基づいて複数の
ドキュメントの中からドキュメントを選ぶコンテントネゴシエーションのためにより役に立ちます。
複数の言語が同じ拡張子に割り当てられているときは、 最後のものが使用されます。すなわち、次のような場合、
AddLanguage en .en
AddLanguage en-gb .en
AddLanguage en-us .en
拡張子 .en のあるドキュメントは
en-us として扱われます。
引数 extension は大文字小文字を区別せず、 最初のドットはあってもなくても構いません。 ファイル名は複数の拡張子を持つことができ、 extensionはそれぞれと比較されます。
| 説明: | ファイル名の拡張子をサーバからの応答を処理するフィルタに マップする |
|---|---|
| 構文: | AddOutputFilter filter[;filter...]
extension [extension] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
| 互換性: | 2.0.26 以降で使用可能 |
AddOutputFilter ディレクティブは
拡張子 extension をサーバの応答がクライアントに送られる
前に処理するフィルタを定義します。
これは SetOutputFilter
ディレクティブと AddOutputFilterByType ディレクティブ
を含め、他の場所で定義されているフィルタに加えられます。
この新しいマッピングは既にあるマッピングに追加され、同じ拡張子
extension のためのマッピングを上書きします。
例えば、以下の設定はすべての .shtml ファイルを SSI で処理し、
その出力を mod_deflate を使って圧縮します。
AddOutputFilter INCLUDES;DEFLATE shtml
複数のフィルタを指定するときは、データを処理する順番にセミコロンで 繋いで書く必要があります。filter は大文字小文字を区別しません。
引数 extension は大文字小文字を区別せず、 最初のドットはあってもなくても構いません。 ファイル名は複数の拡張子を持つことができ、 extensionはそれぞれと比較されます。
| 説明: | ファイル名の拡張子を指定されたコンテントタイプにマップ |
|---|---|
| 構文: | AddType MIME-type extension
[extension] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
AddType ディレクティブは、
与えられた拡張子を指定されたコンテントタイプにマップします。
MIME-type は拡張子 extension
を含んだドキュメントに使用する MIME タイプです。
この新しいマッピングは既にあるマッピングに追加され、同じ拡張子
extension のためのマッピングを上書きします。
このディレクティブは MIME タイプファイル (TypesConfig ディレクティブを参照)
に無いマッピングを追加するために使用することができます。
AddType image/gif .gif
あるいは、ひとつのディレクティブで複数のファイル拡張子を指定する場合:
AddType image/jpeg jpeg jpg jpe
TypesConfig
ファイルを変更するのではなく、AddType
ディレクティブを使って追加することが推奨されています。
引数 extension は大文字小文字を区別せず、 最初のドットはあってもなくても構いません。 ファイル名は複数の拡張子を持つことができ、 extensionはそれぞれと比較されます。
| 説明: | あるスコープのすべてのファイルを指定された言語に 設定する |
|---|---|
| 構文: | DefaultLanguage MIME-lang |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
DefaultLanguage ディレクティブは、Apache
がディレクティブのスコープ (例えば、その時点の
<Directory>
の範囲) にある、明示的な言語拡張子
(AddLanguage で設定される
.fr や .de) のない全てのファイルを、指定された
MIME-lang 言語であるとみなすようにします。
これにより、すべてのファイル名を変えることなく、
ディレクトリがオランダ語のコンテントを含んでいる、
というようなことを指定することができます。
拡張子を使用して言語を指定する方法と違い、
DefaultLanguage
は一つの言語しか指定できないことに注意してください。
DefaultLanguage
ディレクティブが有効でなく、ファイルに
AddLanguage
で設定された言語の拡張子がないときは、
ファイルには言語属性がないとみなされます。
DefaultLanguage en
| 説明: | path_info コンポーネントをファイル名の一部として扱うように
mod_mime に通知する |
|---|---|
| 構文: | ModMimeUsePathInfo On|Off |
| デフォルト: | ModMimeUsePathInfo Off |
| コンテキスト: | ディレクトリ |
| ステータス: | |
| モジュール: | mod_mime |
| 互換性: | Apache 2.0.41 以降 |
ModMimeUsePathInfo ディレクティブは、
mod_mime の持つディレクティブを
リクエストに適用させるために、ファイル名と path_info URL
コンポーネントを結合させるために使用します。
デフォルトでは「 Off 」で、path_info
コンポーネントは無視されます。
このディレクティブは、バーチャルファイルシステムを使用している際に 推奨されるディレクティブです。
ModMimeUsePathInfo On
/bar が存在して (foo.shtml は存在しない)
ModMimeUsePathInfo が On であるとして、
/bar/foo.shtml に対するリクエストを発行した場合、
mod_mime は入ってきたリクエストを
/bar/foo.shtml として扱い、
AddOutputFileter INCLUDES .shtml のようなディレクティブは
INCLUDES フィルタをリクエストに付加させます。
ModMimeUsePathInfo が設定されなければ、
INCLUDES フィルタは付加されません。
| 説明: | MultiViews でのマッチングの検索に含ませる ファイルのタイプを指定する |
|---|---|
| 構文: | MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers
[Handlers|Filters] |
| デフォルト: | MultiviewsMatch NegotiatedOnly |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
| 互換性: | 2.0.26 以降で使用可能 |
MultiviewsMatch を使用することで、
mod_negotiation の
Multiviews に 3 種類の異なる挙動をさせることができます。
Multiviews を使用すると、ファイル (例 index.html)
に対するリクエストに対して、ネゴシエーションする拡張子がベースに付いたもの
(index.html.en, index.html.fr や
index.html.gz)
をマッチさせることができます。
NegotiatedOnly オプションでは、ベース名に続く拡張子全てが
コンテントネゴシエーションで mod_mime
が認識する拡張子 (例 文字セット、コンテントタイプ、言語やエンコーディング)
に関連付けられていなければなりません。これは副作用の最も少ない
最も的確な実装で、デフォルトになっています。
ハンドラとフィルタの両方もしくは片方と関連付けられた拡張子を含めるには、
MultiviewsMatch ディレクティブに Handlers,
Filters またはその両方のオプションをセットします。
もし他の条件が同じであれば、最も小さいファイルが送信されます。
例えば、500 文字の index.html.cgi と 1000 バイトの
index.html.pl であれば、.cgi
のファイルが優先されます。.asis ファイルを利用しているユーザは、
.asis ファイルが asis-handler に関連付けられているときには、
ハンドラオプションの使用を好むでしょう。
最後に、mod_mime が認識しない拡張子であろうとも、
どんな拡張子でもマッチさせる Any が使用できます。
この挙動は Apache 1.3 のときと同じもので、予期しない動作、例えば .old や
.bak ファイルといったウェブマスタが送信を意図していない
ファイルを送信する、といった動作を行なう可能性があります。
例えば次の設定では、ハンドラやフィルタが Multiviews に参加することが できますし、未知のファイルは除外することができます。
MultiviewsMatch Handlers Filters
| 説明: | ファイルの拡張子に関連付けられたすべての文字セット を解除する |
|---|---|
| 構文: | RemoveCharset extension [extension]
... |
| コンテキスト: | バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
| 互換性: | 2.0.24 以降で使用可能 |
RemoveCharset ディレクティブ
は与えられた拡張子に関連付けられた文字セットを取り消します。
これにより、サブディレクトリにある .htaccess
ファイルが親ディレクトリやサーバの設定ファイル
から継承した関連付けを取り消すことができます。例えば:
extension は大文字小文字を区別しません。 また、最初のドットはあってもなくても構いません。
RemoveCharset .html .shtml
| 説明: | ファイルの拡張子に関連付けられたすべてのコンテントエンコーディング を解除する |
|---|---|
| 構文: | RemoveEncoding extension [extension]
... |
| コンテキスト: | バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
RemoveEncoding ディレクティブは、
与えられた拡張子に関連付けられたエンコーディングを取り消します。
これにより、サブディレクトリにある .htaccess
ファイルが親ディレクトリやサーバの設定ファイルから継承した関連付けを
取り消すことができます。
AddEncoding x-gzip .gz
AddType text/plain .asc
<Files *.gz.asc>
RemoveEncoding .gz
</Files>
これは、foo.gz は gzip
でエンコードされていることを指定しますが、foo.gz.asc
はエンコードされていないプレーンテキストの
ファイルであるということを指定します。
RemoveEncoding は
AddEncoding
ディレクティブの後で処理されますので、
同じディレクトリの設定中に両方が現れると、
後者の効果が打ち消される可能性があります。
extension は大文字小文字を区別しません。 また、最初のドットはあってもなくても構いません。
| 説明: | ファイルの拡張子に関連付けられたすべてのハンドラを 解除する |
|---|---|
| 構文: | RemoveHandler extension [extension]
... |
| コンテキスト: | バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
RemoveHandler ディレクティブ
は与えられた拡張子に関連付けられたハンドラを取り消します。
これにより、サブディレクトリにある .htaccess
ファイルが親ディレクトリやサーバの設定ファイル
から継承した関連付けを取り消すことができます。たとえば:
AddHandler server-parsed .html
RemoveHandler .html
これは、/foo/bar ディレクトリの .html
ファイルは SSI (mod_include モジュール参照) ではなく、
普通のファイルとして扱われるようにする効果があります。
extension は大文字小文字を区別しません。 また、最初のドットはあってもなくても構いません。
| 説明: | ファイル拡張子に関連付けられた入力フィルタを解除する |
|---|---|
| 構文: | RemoveInputFilter extension [extension]
... |
| コンテキスト: | バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
| 互換性: | 2.0.26 以降で使用可能 |
RemoveInputFilter ディレクティブは
指定されたファイル拡張子に関連付けられた入力フィルタを解除します。
これを利用することで、親ディレクトリやサーバ設定ファイルから
継承した関連付けを サブディレクトリ内において
.htaccess ファイルで取り消すことができます。
extension 引数は大文字小文字を区別しません。また、 最初のドットはあってもなくても構いません。
| 説明: | ファイル拡張子に関連付けられた言語を解除する |
|---|---|
| 構文: | RemoveLanguage extension [extension]
... |
| コンテキスト: | バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
| 互換性: | 2.0.24 以降で使用可能 |
RemoveLanguage ディレクティブは
指定されたファイル拡張子に関連付けられた言語を解除します。
これを利用することで、親ディレクトリやサーバ設定ファイルから
継承した関連付けを サブディレクトリ内において
.htaccess ファイルで取り消すことができます。
extension 引数は大文字小文字を区別しません。また、 最初のドットはついてもつかなくても構いません。
| 説明: | ファイル拡張子に関連付けられた出力フィルタを解除する |
|---|---|
| 構文: | RemoveOutputFilter extension [extension]
... |
| コンテキスト: | バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
| 互換性: | 2.0.26 以降でのみ使用可能 |
RemoveOutputFilter ディレクティブは
指定されたファイル拡張子に関連付けられた出力フィルタを解除します。
これを利用することで、親ディレクトリやサーバ設定ファイルから
継承した関連付けを サブディレクトリ内において
.htaccess ファイルで取り消すことができます。
extension は大文字小文字を区別しません。 また、最初のドットはあってもなくても構いません。
RemoveOutputFilter shtml
| 説明: | ファイルの拡張子と関連付けられたコンテントタイプを 解除する |
|---|---|
| 構文: | RemoveType extension [extension]
... |
| コンテキスト: | バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | |
| モジュール: | mod_mime |
RemoveType ディレクティブは与えられた拡張子の
MIME タイプ
の関連付けを取り消します。これにより、
サブディレクトリにある .htaccess
ファイルが親ディレクトリやサーバの設定ファイルから継承した
関連付けを取り消すことができます。たとえば:
RemoveType .cgi
これは /foo/ ディレクトリ以下の .cgi
ファイルの特別な扱いを取り消します。ファイルは DefaultType として扱われます。
RemoveType ディレクティブは
AddType
ディレクティブの後に処理されますので、
両方が同じディレクトリの設定中に現れた場合、
後者の効果が打ち消される可能性があります。
extension は大文字小文字を区別しません。 また、最初のドットはあってもなくても構いません。
| 説明: | mime.types ファイルの位置 |
|---|---|
| 構文: | TypesConfig file-path |
| デフォルト: | TypesConfig conf/mime.types |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | |
| モジュール: | mod_mime |
TypesConfig ディレクティブは、
MIME タイプ
設定ファイルの位置を設定します。file-path は
ServerRoot からの相対パスです。
このファイルはファイルの拡張子からコンテントタイプへの
デフォルトのマッピングを設定します。
ほとんどの管理者は、よく使われるファイル名の拡張子を
IANA に登録されたコンテントタイプに関連付けている、
Apache の mime.types ファイルを使います。
現在の一覧は http://www.iana.org/assignments/media-types/index.html
で管理されています。これは、主要なメディアタイプの定義を提供して、
必要ところを AddType で
上書きする、という方法で httpd.conf を簡略にします。
mime.types はサーバをアップグレードしたときに
置き換えられるかもしれないので、そのファイルを直接
編集しないでください。
ファイルは、AddType
ディレクティブの引数と同じ形式の行で構成されます。
MIME-type [extension] ...
拡張子の大文字小文字は区別されません。空行やハッシュ (`#') で始まる行は無視されます。
mime.types
ファイルに新たなものを登録するように
Apache HTTP Server Project にリクエストしないでください。
category/x-subtype のリクエストは自動的に却下されますし、
言語や文字セットの名前空間で既に使用されていて、衝突の可能性のある
2 文字の拡張子も却下されます。
Apache HTTP サーバ バージョン 2.4
| 説明: | HTTP/1.1 プロキシ/ゲートウェイサーバ |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | proxy_module |
| ソースファイル: | mod_proxy.c |
サーバを安全にするまで ProxyRequests は有効にしないでください。
オープンプロキシサーバはあなた自身のネットワークにとっても、
インターネット全体にとっても危険です。
このモジュールは Apache のプロキシ/ゲートウェイ機能を実装しています。
AJP13 (Apache JServe Protocol version 1.3),
FTP, CONNECT (SSL 用),
HTTP/0.9, HTTP/1.0, HTTP/1.1
のプロキシ機能を実装しています。これらのプロトコルやその他のプロトコル用の
プロキシ機能を持った、他のモジュールに接続するようにも設定できます。
Apache のプロキシ機能は mod_proxy の他に、
いくつかのモジュールに分割されています:
mod_proxy_http, mod_proxy_ftp,
mod_proxy_ajp, mod_proxy_balancer,
mod_proxy_connect です。ですから、
特定のプロキシの機能を使いたい場合は、mod_proxy と
該当するモジュールをサーバに (コンパイル時に静的に行なうか
LoadModule で動的に読み込むかして)
組み込む必要があります。
これに加えて、他のモジュールによって拡張機能が提供されています。
キャッシュは mod_cache と関連モジュールで
提供されています。SSL/TLS で遠隔サーバに接続する機能は
mod_ssl の SSLProxy* ディレクティブで
提供されています。これらの機能を利用するためには、該当するモジュールを
組み込んで設定しなければなりません。
BalancerGrowth BalancerInherit BalancerMember BalancerPersist NoProxy <Proxy> Proxy100Continue ProxyAddHeaders ProxyBadHeader ProxyBlock ProxyDomain ProxyErrorOverride ProxyIOBufferSize <ProxyMatch> ProxyMaxForwards ProxyPass ProxyPassInherit ProxyPassInterpolateEnv ProxyPassMatch ProxyPassReverse ProxyPassReverseCookieDomain ProxyPassReverseCookiePath ProxyPreserveHost ProxyReceiveBufferSize ProxyRemote ProxyRemoteMatch ProxyRequests ProxySet ProxySourceAddress ProxyStatus ProxyTimeout ProxyViaApache はフォワードプロキシとしても、 リバースプロキシとしても設定することができます。
通常のフォワードプロキシはクライアントと オリジンサーバ (訳注: コンテンツ生成元のサーバ) の間に位置する中間サーバです。 オリジンサーバからコンテンツを取得する過程では、クライアントは 行き先としてオリジンサーバを指定しつつプロキシにリクエストを送り、 プロキシはオリジンサーバからコンテンツ取得のリクエストを送り、 コンテンツが取得できればそれをクライアントに返します。 クライアントが他のサイトにフォワードプロクシ経由でアクセスするには、 特別にそれ用の設定をしなければなりません。
フォワードプロキシの一般的な使用方法は、ファイアウォールによって
制限されている内部のクライアントにインターネットへのアクセスを
提供するものです。フォワードプロキシはネットワークの使用量を
減らすために (mod_cache で提供されている)
キャッシュ機能を用いることもできます。
フォワードプロキシは ProxyRequests ディレクティブで
有効になります。フォワードプロキシでは、クライアントは本当の身元を
隠して任意のサイトにアクセスできるようになるため、フォワードプロキシを
有効にする前に、承認されたクライアントのみがプロキシにアクセスできるように
サーバを安全にすることが重要です。
一方リバースプロキシは、クライアントには普通の ウェブサーバのように見えます。クライアント側に特別な設定は必要ありません。 クライアントはリバースプロキシの名前空間に対して通常のコンテンツへの リクエストを行ないます。プロキシはリクエストをどこに送れば良いかを判定し、 あたかも自分自身がオリジンサーバであったかのようにクライアントに コンテンツを返します。
リバースプロキシのよくある利用方法は、インターネットユーザに ファイアウォールの中にあるサーバにアクセスを与えるというものです。 リバースプロキシは複数のバックエンドサーバへ負荷分散をするために 使ったり、遅いバックエンドエンドサーバのためにキャッシュ機能を提供したり するために使えます。また、リバースプロキシは複数のサーバを 同じ URL 空間にまとめるために使うこともできます。
リバースプロキシは ProxyPass ディレクティブや
RewriteRule ディレクティブの
[P] フラグを使うことで有効になります。リバースプロキシの
設定のために ProxyRequests を設定する必要は
ありません。
以下の例は手始めの簡単な例です。個々のディレクティブの意味は それぞれの説明をお読みください。
またキャッシュ機能を有効にしたい場合は、mod_cache
の説明を読んでください。
ProxyRequests On
ProxyVia On
<Proxy *>
Order deny,allow
Deny from all
Allow from internal.example.com
</Proxy>
ProxyRequests Off
<Proxy *>
Order deny,allow
Allow from all
</Proxy>
ProxyPass /foo http://foo.example.com/bar
ProxyPassReverse /foo http://foo.example.com/bar
プロキシのアクセスは以下のように <Proxy> コンテナの中に
ディレクティブを書くことで制御できます:
<Proxy *>
Order Deny,Allow
Deny from all
Allow from 192.168.0
</Proxy>
アクセス制御のためのディレクティブのより詳しい情報は
mod_authz_host をお読みください。
(ProxyRequests ディレクティブを
使って) フォワードプロキシを設定している場合は、厳しくアクセス
制限を行なうことが非常に大切です。そうしないと、任意のクライアントが
身元を明かすことなく任意のホストにアクセスするためにサーバを使うことが
できてしまいます。これはあなた自身のネットワークにとっても、インターネット
全体にとっても危険なことです。(ProxyRequests Off にして
ProxyPass ディレクティブを使って)
リバースプロキシを使っている場合には、クライアントはあなたが明示的に
設定したホストにしかアクセスできないため、フォワードプロキシのとき
ほどアクセス制御に力を注がなくても大丈夫です。
ProxyBlock ディレクティブを使っている場合、
後のテストのために起動時にホストの
IP アドレスが調べられてキャッシュされます。ホスト名のルックアップの
速さによっては、数秒 (かそれ以上) かかるかもしれません。
イントラネットにある Apache プロキシサーバは外部へのリクエストを
会社のファイアウォールを通して送らなければなりません。(このためには
個々の scheme についてそれぞれ、ファイアウォールの
プロキシにフォワードされるように
ProxyRemote ディレクティブを
設定してください)。しかしイントラネット内のリソースにアクセスするときは、
ファイアウォールを通さないでもアクセスできます。
どのホストがイントラネットに属し、直接アクセスすべきかを指定するには、
NoProxy ディレクティブが
役に立ちます。
イントラネット内のユーザは WWW のリクエストでローカルドメインを
省略することがよくあります。http://somehost.example.com/
というリクエストの代わりに "http://somehost/" をリクエストしたりします。
このようなリクエストを受け付け、サーバに設定されているローカルドメインが
暗黙のうちに使われていると解釈して、単純にリクエストを処理するものも
商用プロキシサーバの中にはあります。
サーバが プロキシのサービス用に設定されていて
ProxyDomain ディレクティブが
使用された場合には、Apache はクライアントにリダイレクト応答を送って、
正しい、完全な ((訳注: fully qualified))
サーバのアドレスに送ることができます。このように
リダイレクトすると、ユーザのブックマークが正しい完全なホスト名を含む
ことにもなるため、より好ましい方法と言えるでしょう。
Keepalive や HTTP/1.1 を適切に実装していないアプリケーションサーバに対して
mod_proxy がリクエストを送信する場合、
HTTP/1.0 を使って keepalive を無しにしてリクエストを送るようにする
環境変数が二つあります。これらは SetEnv ディレクティブで設定します。
force-proxy-request-1.0 と proxy-nokeepalive
がその環境変数です。
<Location /buggyappserver/>
ProxyPass http://buggyappserver:7001/foo/
SetEnv force-proxy-request-1.0 1
SetEnv proxy-nokeepalive 1
</Location>
POST メソッドなどのリクエストには、リクエストボディがあります。
HTTP プロトコル仕様によると、ボディのあるリクエストは chunked
転送を使うか、Content-Length
ヘッダを送信しなければなりません。
このようなリクエストをオリジンサーバに送信する場合、
mod_proxy_http は常に Content-Length
を送ろうと試みます。しかし。ボディが大きく、オリジナルのリクエストで
chunked 転送が使われている場合、上流へのリクエストに
chunked 転送も使われます。
この挙動は 環境変数で制御できます。
proxy-sendcl を設定すると、可能な限り常に
Content-Length を付与して、
上流サーバに送信するようになります。
逆に proxy-sendchunked を設定すると、リソース消費を抑え、
chnked エンコードを使って送信するようになります。
| 説明: | Number of additional Balancers that can be added Post-configuration |
|---|---|
| 構文: | BalancerGrowth # |
| デフォルト: | BalancerGrowth 5 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | BalancerGrowth is only available in Apache HTTP Server 2.3.13 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Inherit ProxyPassed Balancers/Workers from the main server |
|---|---|
| 構文: | BalancerInherit On|Off |
| デフォルト: | BalancerInherit On |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | BalancerInherit is only available in Apache HTTP Server 2.4.5 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Add a member to a load balancing group |
|---|---|
| 構文: | |
| コンテキスト: | ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy |
Documentation not yet translated. Please see English version of document.
| 説明: | Attempt to persist changes made by the Balancer Manager across restarts. |
|---|---|
| 構文: | BalancerPersist On|Off |
| デフォルト: | BalancerPersist Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | BalancerPersist is only available in Apache HTTP Server 2.4.4 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | 直接接続する ホスト、ドメイン、ネットワーク |
|---|---|
| 構文: | NoProxy host [host] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
このディレクティブはイントラネット中の Apache プロキシサーバにのみ
有用です。NoProxy ディレクティブは空白区切りで、
サブネット、IP アドレス、ホスト、ドメインのリストを指定します。
これらのどれかにマッチするホストへのリクエストは ProxyRemote で設定されたプロキシサーバに
フォワードされず、直接処理されます。
ProxyRemote * http://firewall.mycompany.com:81
NoProxy .mycompany.com 192.168.112.0/21
NoProxy ディレクティブの host 引数は
以下の種類のどれかです:
Domain は先頭にピリオドの着いた部分 DNS ドメイン名です。 同一 DNS ドメイン及びゾーン (すなわち、ホスト名の末尾がすべて Domain で終わっているということ) に属するホストのリストを 表します)。
.com .apache.org.
Domain を Hostname と区別するために (意味的にも構文的にも。DNS ドメインも DNS の A レコードを持つことができるのです!)、Domain は 常にピリオドで始まります。
ドメイン名の比較は大文字小文字を区別せずに行なわれ、Domain
は常に DNS ツリーのルートから始まるものとみなされます。ですから、
次の二つのドメイン .MyDomain.com と
.mydomain.com. (最後のピリオドに注目) は同一であると
みなされます。ドメインの比較は DNS ルックアップなしで行なわれるため、
サブネットの比較よりもずっと効率的です。
SubNet は数値形式 (ドットで区切られた四つの数字) の 部分インターネットアドレスです。後にスラッシュと Subnet の意味のあるビット数を指定するネットマスクとを続けることができます。 共通のネットワークインタフェースを使って到達することのできるサブネットを 表すために使われます。明示的にネットマスクを指定しない場合は 最後の省略された (もしくは値が 0 の) 数字がマスクを指定します。 (この場合は、ネットマスクは 8 ビット単位でしか指定できません。) 例:
192.168 もしくは 192.168.0.0255.255.0.0 というネットマスクの形式で使われることも
あります)192.168.112.0/21192.168.112.0/21 と 21 ビット有効な
ネットマスク (255.255.248.0 という形式で使われることも
あります)特別な場合に、32 ビット有効な SubNet は IPAddr と同等で、 0 ビット有効な SubNet (例えば、0.0.0.0/0) は すべての IP アドレスにマッチする定数 _Default_ と同じです。
IPAddr は数値形式 (ドットで区切られた四つの数字) の 完全インターネットアドレスです。通常はこのアドレスはホストを 表しますが、必ずしもアドレスに対応する DNS ドメイン名があるわけでは ありません。
192.168.123.7
IPAddr は DNS システムにより解決される必要がないので、 apache の性能が向上するかもしれません。
Hostname は DNS ドメインサービスにより一つもしくは 複数の IPAddr に解決可能な 完全な DNS ドメイン名です。これは (Domain と違って、説明は上記を参照) 論理的なホストを表し、少くとも一つの IPAddr (もしくは違う IPAddr のホストのリスト) に解決 されなければなりません)。
prep.ai.mit.edu
www.apache.org
多くの場合、Hostname の代わりに IPAddr を指定した方が、DNS ルックアップを 避けることができるため、効率が良くなります。Apache の名前解決は ネームサーバへの接続が遅い PPP 上の場合などにかなり時間を取られる ことがあります。
Hostname の比較は大文字小文字を区別せずに行なわれ、
Hostname は常に DNS ツリーのルートから始まるものとみなされます。
ですから、二つのドメイン WWW.MyDomain.com と
www.mydomain.com. (最後のピリオドに注目) は同一であると
みなされます。
| 説明: | プロキシされるリソースに適用されるコンテナ |
|---|---|
| 構文: | <Proxy wildcard-url> ...</Proxy> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
<Proxy> セクション中の
ディレクティブはマッチするプロキシされるコンテンツにのみ適用されます。
シェル形式のワイルドカードが使えます。
例えば、次の設定は yournetwork.example.com の
ホストにのみプロキシサーバを経由したアクセスを許可します:
<Proxy *>
Order Deny,Allow
Deny from all
Allow from yournetwork.example.com
</Proxy>
次の例は example.com の foo ディレクトリの
すべてのファイルに対して、プロキシサーバを通して送られたときには
INCLUDES フィルタを通して送るように設定します:
<Proxy http://example.com/foo/*>
SetOutputFilter INCLUDES
</Proxy>
| 説明: | Forward 100-continue expectation to the origin server |
|---|---|
| 構文: | Proxy100Continue Off|On |
| デフォルト: | Proxy100Continue On |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | Available in version 2.4.40 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Add proxy information in X-Forwarded-* headers |
|---|---|
| 構文: | ProxyAddHeaders Off|On |
| デフォルト: | ProxyAddHeaders On |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | Available in version 2.3.10 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | 応答におかしなヘッダがある場合の扱い方を決める |
|---|---|
| 構文: | ProxyBadHeader IsError|Ignore|StartBody |
| デフォルト: | ProxyBadHeader IsError |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | 2.0.44 以降 |
ProxyBadHeader ディレクティブは構文的に
間違ったヘッダ (つまり コロンを含まないもの) を受け取ったときに
mod_proxy がどう振る舞うかを決めます。以下の引数を
取ることができます:
IsErrorIgnoreStartBody| 説明: | プロキシ接続を禁止する語句、ホスト名、ドメインを指定する |
|---|---|
| 構文: | ProxyBlock *|word|host|domain
[word|host|domain] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
ProxyBlock ディレクティブは空白で区切られた
語句、ホスト名、ドメインのリストを指定します。サイト名にその語句、ホスト名、
ドメインを含むサイトへの HTTP、HTTPS、FTP によるドキュメントのリクエストは
プロキシサーバによりブロックされます。プロキシモジュールは
起動時にホスト名と思しき項目の IP アドレスを調べ、後のテストのために
キャッシュします。これにより、サーバの起動が少し遅くなるかもしれません。
ProxyBlock joes-garage.com some-host.co.uk rocky.wotsamattau.edu
rocky.wotsamattau.edu が IP アドレスで参照されたときでも
マッチします。
wotsamattau.edu のマッチには wotsamattau
だけでも十分です。
ProxyBlock *
はすべてのサイトへの接続をブロックすることに注意してください。
| 説明: | プロキシされたリクエストのデフォルトのドメイン名 |
|---|---|
| 構文: | ProxyDomain Domain |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
このディレクティブはイントラネット内の Apache プロキシサーバにのみ
有用です。ProxyDomain ディレクティブは
apache プロキシサーバが属するデフォルトのドメインを指定します。
ドメイン名の無いリクエストを受けた場合、設定された Domain
が追加された同じホストへのリダイレクト応答が返されます。
ProxyRemote * http://firewall.mycompany.com:81
NoProxy .mycompany.com 192.168.112.0/21
ProxyDomain .mycompany.com
| 説明: | プロキシされたコンテンツのエラーページを上書きする |
|---|---|
| 構文: | ProxyErrorOverride On|Off |
| デフォルト: | ProxyErrorOverride Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | バージョン 2.0 以降で使用可能 |
このディレクティブはリバースプロキシを使用していて、
エンドユーザに送られるエラーページの外見を共通のものにしたいときに
有用です。このディレクティブは (mod_include の SSI によって)
インクルードされたファイルがエラーコードを取得して、正しく動作を
するようにもします (デフォルトの動作は、プロキシされたサーバの
エラーページの表示で、このディレクティブを有効にすると SSI のエラー
メッセージを表示します)。
| 説明: | 内部データスループットバッファのサイズを決定する |
|---|---|
| 構文: | ProxyIOBufferSize bytes |
| デフォルト: | ProxyIOBufferSize 8192 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
ProxyIOBufferSize ディレクティブは入力と
出力用の一時メモリとして使われる内部バッファのサイズを調整します。
サイズは 8192 以下でなければなりません。
ほとんどすべての場合、この値を変更する理由はありません。
| 説明: | 正規表現でのマッチによるプロキシリソース用のディレクティブコンテナ |
|---|---|
| 構文: | <ProxyMatch regex> ...</ProxyMatch> |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
<ProxyMatch> は URL のマッチに
正規表現 を用いることを除いて
<Proxy> ディレクティブと同じです。
| 説明: | リクエストがフォワードされるプロキシの最大数 |
|---|---|
| 構文: | ProxyMaxForwards number |
| デフォルト: | ProxyMaxForwards 10 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | Apache 2.0 以降で使用可能 |
ProxyMaxForwards ディレクティブは
リクエストに Max-Forwards ヘッダが指定されていない場合に
リクエストが通過可能なプロキシの最大数を設定します。これは
プロキシの無限ループや DoS 攻撃を防ぐために設定されています。
ProxyMaxForwards 15
| 説明: | リモートサーバをローカルサーバの URL 空間にマップする |
|---|---|
| 構文: | ProxyPass [path] !|url [key=value key=value ...]] |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy |
このディレクティブはリモートサーバをローカルサーバの名前空間に マップできるようにします。ローカルサーバは通常の意味でのプロキシと しては動作せず、リモートサーバのミラーとして振る舞います。 path はローカルの仮想パスの名前です。url は リモートサーバの部分 URL になり、クエリー文字列を含むことはできません。
ProxyPass ディレクティブを
使っているときは ProxyRequests ディレクティブは通常は
off に設定されているべきです。ローカルサーバのアドレスが http://example.com/ であると
します。すると、
ProxyPass /mirror/foo/ http://backend.example.com/
と設定すると http://example.com/mirror/foo/bar への
リクエストが内部的に http://backend.example.com/bar への
プロキシリクエストに変換されることになります。
サブディレクトリをリバースプロキシしたくないときに ! は
役に立ちます。例えば、
ProxyPass /mirror/foo/i !
ProxyPass /mirror/foo http://backend.example.com
は /mirror/foo/i を除く
/mirror/foo へのすべてのリクエストを
backend.example.com にプロキシします。
順番は重要です。一般的な ProxyPass
ディレクティブの前に
除外ディレクティブを置く必要があります。
2.1 の機能で、バックエンドサーバとの接続にプールされたコネクションを
使えるようになりました。key=value 形式のパラメータで
このコネクションプーリングの調整ができます。Hard Maximum
のデフォルト値は、有効になっている MPM でのプロセス当たりのスレッド数と
同じ数のコネクション数です。prefork MPM では通常は 1 で、worker MPM では
ThreadsPerChild で調整されます。
min の設定で、バックエンドサーバとの間に何本のコネクションを
常時開くかが決まります。Soft Maximum smax の数に
達するまで必要に応じてコネクションは生成されます。smax
を超えた数のコネクションは、生存時間 ttl で切断されます。
バックエンドサーバと Hard Maximum max の数以上のコネクションを
生成することはありません。
ProxyPass /example http://backend.example.com smax=5 max=20 ttl=120 retry=300
| パラメータ | デフォルト値 | 説明 |
|---|---|---|
| min | 0 | バックエンドサーバとの接続で 常に開いているコネクション数の最小値 |
| max | 1...n | バックエンドサーバとの接続数の Hard Maximum
(訳注: ハードリミット)。
デフォルト値は、使用している MPM のプロセスあたりのスレッド数になっています。
Prefork MPM では常に 1 で、Worker MPM では ThreadsPerChild
で調節できます。Hard Maximum 以上にバックエンドサーバとのコネクションを
生成することはありません。 |
| smax | max | 接続数の Soft Maximum (訳注: ソフトリミット)まで、
コネクションは必要に応じて生成されます。
smax を超えた数のコネクションは生存時間 ttl
で切断されます。
|
| ttl | - | smax 数を超えた非活動状態のコネクションの生存時間を、
秒で指定します。この期間内に使用されなかったコネクションは、
全て閉じられます。
|
| timeout | Timeout |
コネクションタイムアウトを秒で指定します。特に指定されなければ、
フリーなコネクションを取得できるまで待ちます。このディレクティブは
max パラメータと合わせて使うことで、バックエンドサーバとの
接続数を制御するのに使います。
|
| acquire | - | 設定すると、コネクションプールからフリーのコネクションを取得するために
待機する待ち時間の最大値になります。フリーのコネクションがプールになかった場合は、
SERVER_BUSY ステータスがクライアントに返されます。
|
| keepalive | Off | バックエンドサーバと Apache の間にファイアーウォールがある場合には、
このパラメータを使ってください。ファイアウォールは往々にして、
非活動状態のコネクションを落とそうとします。
このフラグは OS に指示して、KEEP_ALIVE メッセージを非活動状態の
コネクションでも送るようにします (間隔は OS のグローバル設定に依存し、
通常は 120ms 間隔) 。これによってファイアウォールによってコネクションが
落とされることを防げます。keepalive を有効にするには、このプロパティを
On にしてください。
|
| retry | 60 | コネクションをプーリングするための、リトライのタイムアウトを秒で 指定します。バックエンドサーバへのコネクションプーリングが失敗した場合は、 タイムアウトの期間が過ぎるまで、そのサーバにリクエストをフォワードしません。 この機能を使うと、バックエンドサーバをメンテナンスのためにシャットダウンし、 後でオンラインに復帰させるといったことができます。 |
| loadfactor | 1 | ワーカーあたりの負荷係数です。BalancerMember で使います。 1 から 100 までの数字でそのワーカーに対する正規化された負荷率を指定します。 |
| route | - | ロードバランサで使った場合、ワーカーのルーティングをします。 ルートはセッション ID に付加された値になります。 |
| redirect | - | ワーカーのリダイレクション経路です。この値は通常は、 安全にクラスタからノードを取り去る設定を動的に入れるために使います。 セッション ID の無いリクエスト全てを指定した場合は、 この値と同じルーティングパラメータを持つ BalancerMember にリダイレクトされます。 |
Proxy ディレクティブのスキームが balancer:// になっている場合は、
バックエンドサーバと実際には通信しない仮想ワーカーが生成されます。
このワーカーは幾つかの "本物の" ワーカーの管理をつかさどります。
この場合パラメータは、この仮想ワーカーに対して設定されます。
| パラメータ | デフォルト値 | 説明 |
|---|---|---|
| lbmethod | - | Balancer のロードバランス方法。使用するロードバランスの
スケジューリング方法を選びます。処理したリクエストの数で重み付けする
byrequests か、転送量のバイト数で重み付けする
bytraffic を設定できます。デフォルトは
byrequests です。
|
| stickysession | - | バランサーのスティッキーセッション名です。通常はこの値は JSESSIONID
や PHPSESSIONID といったものになりますが、この値は
バックエンドアプリケーションのサポートするセッションに依存します。
|
| nofailover | Off | On になっていると、ワーカーがエラーを起こしたり
無効になっている場合にセッションが切れます。
バックエンドサーバがセッションレプリケーションをサポートしていない場合は、
On にしてください。
|
| timeout | 0 | バランサーのタイムアウトを秒で指定します。 この値を設定すると、フリーのワーカーを取得するまでの最大待機時間になります。 デフォルトでは待機しません。 |
| maxattempts | 1 | フェイルオーバーを試みる最大の回数を指定します。 |
ProxyPass /special-area http://special.example.com/ smax=5 max=10
ProxyPass / balancer://mycluster stickysession=jsessionid nofailover=On
<Proxy balancer://mycluster>
BalancerMember http://1.2.3.4:8009
BalancerMember http://1.2.3.5:8009 smax=10
# Less powerful server, don't send as many requests there
BalancerMember http://1.2.3.6:8009 smax=1 loadfactor=20
</Proxy>
<Location> セクションの中で使われた場合、最初の引数は
省略され、ローカルディレクトリは <Location> から取得されます。
より柔軟なリバースプロキシの設定が必要な場合は、[P]
フラグ付きの RewriteRule
ディレクティブを参照してください。
| 説明: | Inherit ProxyPass directives defined from the main server |
|---|---|
| 構文: | ProxyPassInherit On|Off |
| デフォルト: | ProxyPassInherit On |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | ProxyPassInherit is only available in Apache HTTP Server 2.4.5 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Enable Environment Variable interpolation in Reverse Proxy configurations |
|---|---|
| 構文: | |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy |
Documentation not yet translated. Please see English version of document.
| 説明: | Maps remote servers into the local server URL-space using regular expressions |
|---|---|
| 構文: | |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy |
Documentation not yet translated. Please see English version of document.
| 説明: | リバースプロキシされたサーバから送られた HTTP 応答ヘッダの URL を調整する |
|---|---|
| 構文: | ProxyPassReverse [path] url |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy |
このディレクティブは Apache に HTTP リダイレクト応答の
Location, Content-Location, URI
ヘッダの調整をさせます。これは、Apache がリバースプロキシとして使われている
ときに、リバースプロキシを通さないでアクセスすることを防ぐために
重要です。これによりバックエンドサーバの HTTP リダイレクトが
リバースプロキシとバックエンドの間で扱われるようになります。
ディレクティブで明示されている HTTP 応答ヘッダのみが書き換えられます。 Apache は他の応答ヘッダを書き換えたり、HTML ページの中の URL 参照を 書き換えたりすることはありません。HTML の中を見て、URL 参照を書き換える モジュールに Nick Kew さんの mod_proxy_html があります。
path はローカル仮想パスの名前です。url は
リモートサーバの部分 URL です。これらは ProxyPass ディレクティブと同様です。
例えば、ローカルサーバのアドレスが http://example.com/
だとします。すると
ProxyPass /mirror/foo/ http://backend.example.com/
ProxyPassReverse /mirror/foo/ http://backend.example.com/
ProxyPassReverseCookieDomain backend.example.com public.example.com
ProxyPassReverseCookiePath / /mirror/foo/
という設定をすると、http://example.com/mirror/foo/bar
へのローカルリクエストが http://backend.example.com/bar
へのプロキシリクエストに内部でリダイレクトされるだけではありません
(これは ProxyPass の機能です)。backend.example.com
が送るリダイレクトの面倒もみます。http://backend.example.com/bar
が http://backend.example.com/quux にリダイレクトされたとき、
Apache は HTTP リダイレクト応答をクライアントに送る前に、
http://example.com/mirror/foo/quux に変更します。
URL を構成するのに使われるホスト名は UseCanonicalName の設定に応じて選択されることに
注意してください。
ProxyPassReverse ディレクティブは
対応する ProxyPass ディレクティブには依存しないため、
mod_rewrite のプロキシ通過機能
(RewriteRule ... [P]) と併せて使用することができます。
<Location> セクションの中で使われた場合は、
最初の引数は省略され、ローカルディレクトリは <Location> から取得されます。
| 説明: | リバースプロキシサーバからの Set-Cookie ヘッダの Domain 文字列を 調整する |
|---|---|
| 構文: | ProxyPassReverseCookieDomain internal-domain public-domain |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy |
使用法は基本的に
ProxyPassReverse と同じですが、
ヘッダの URL の代わりに Set-Cookie ヘッダの
domain 文字列を書き換えます。
| 説明: | Reverse プロキシサーバからの Set-Cookie ヘッダの Path 文字列を 調整する |
|---|---|
| 構文: | ProxyPassReverseCookiePath internal-path public-path |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy |
使用法は基本的に
ProxyPassReverse と同じですが、
ヘッダの URL の代わりに Set-Cookie ヘッダの
path 文字列を書き換えます。
| 説明: | プロキシリクエストに、受け付けた Host HTTP ヘッダを使う |
|---|---|
| 構文: | ProxyPreserveHost On|Off |
| デフォルト: | ProxyPreserveHost Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | Apache 2.0.31 以降で使用可能 |
このオプションが有効になっている場合、ProxyPass
で指定したホスト名の代わりに、受け付けたリクエストの Host: 行を
プロキシ先のホストに送ります。
このオプションは通常は Off に設定してください。
ほとんどの場合、これは大量の名前ベースのバーチャルホスティングを行なっていて、
元々の Host ヘッダをバックエンドサーバが解釈する必要のあるときのような、
特別な設定が必要な場合にのみ有用です。
| 説明: | プロキシされる HTTP と FTP 接続のためのネットワークバッファサイズ |
|---|---|
| 構文: | ProxyReceiveBufferSize bytes |
| デフォルト: | ProxyReceiveBufferSize 0 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
ProxyReceiveBufferSize ディレクティブは
スループットを上げるために明示的に (TCP/IP) ネットワークバッファのサイズを
設定します。値は 512 以上か、システムのデフォルトのバッファ
サイズを意味する 0 でなければなりません。
ProxyReceiveBufferSize 2048
| 説明: | 特定のリクエストを扱う時に使われるリモートプロキシを指定する |
|---|---|
| 構文: | ProxyRemote match remote-server |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
このディレクティブはこのプロキシに対するリモートプロキシを定義します。
match はリモートサーバがサポートする URL スキーム、
リモートサーバが使うはずの URL の一部分、サーバがすべての
リクエストに使われることを示す * のどれかになります。
remote-server はリモートサーバの部分 URL です。構文:
remote-server =
scheme://hostname[:port]
scheme は実際上リモートサーバとの通信に使われるプロトコルを
決定します。このモジュールでは http だけがサポートされて
います。
ProxyRemote http://goodguys.com/ http://mirrorguys.com:8000
ProxyRemote * http://cleversite.com
ProxyRemote ftp http://ftpproxy.mydomain.com:8080
この例では、プロキシは FTP リクエストを別の HTTP リクエストで包んで そのようなリクエストを扱える別のプロキシに転送します。
このオプションはリバースプロキシの設定もサポートします。 サーバが別のフォワードプロキシの後ろに隠されている場合でも バックエンドウェブサーバをバーチャルホストの URL 空間に入れることが できます。
| 説明: | 正規表現でのマッチによるリクエストを扱うリモートプロキシの指定 |
|---|---|
| 構文: | ProxyRemoteMatch regex remote-server |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
ProxyRemoteMatch は最初の引数がリクエストされた
URL にマッチする正規表現であることを除けば ProxyRemote ディレクティブと同じです。
| 説明: | フォワード (標準の) プロキシリクエストを有効にする |
|---|---|
| 構文: | ProxyRequests On|Off |
| デフォルト: | ProxyRequests Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
これは Apache のフォワードプロキシサーバとしての動作を
有効もしくは無効にします。(ProxyRequests を Off に
設定しても、ProxyPass
の設定は無効になりません。)
通常のリバースプロキシの設定では、このオプションは Off
に設定してください。
HTTP や FTP サイトへのプロキシの機能を有効にしたい場合は、
mod_proxy_http や mod_proxy_ftp が
サーバに組み込まれていなければなりません。
サーバを安全にするまで ProxyRequests は有効にしないでください。
オープンプロキシサーバはあなた自身のネットワークにとっても、
インターネット全体にとっても危険です。
| 説明: | Set various Proxy balancer or member parameters |
|---|---|
| 構文: | |
| コンテキスト: | ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy |
Documentation not yet translated. Please see English version of document.
| 説明: | Set local IP address for outgoing proxy connections |
|---|---|
| 構文: | ProxySourceAddress address |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | Available in version 2.3.9 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Show Proxy LoadBalancer status in mod_status |
|---|---|
| 構文: | |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
Documentation not yet translated. Please see English version of document.
| 説明: | プロキシされたリクエストのネットワークタイムアウト |
|---|---|
| 構文: | ProxyTimeout seconds |
| デフォルト: | ProxyTimeout 300 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
| 互換性: | Apache 2.0.31 以降で使用可能 |
このディレクティブはユーザがプロキシリクエストのタイムアウトを 指定できるようにします。これはハングしてしまう遅い、もしくは挙動の 怪しいサーバがあり、サーバがデータを返すまでひたすら待ち続けるよりも タイムアウトを返してより緩やかに(訳注: graceful に) 失敗させたい場合に役に立ちます。
| 説明: | プロキシされたリクエストの Via HTTP 応答ヘッダ
により提供される情報 |
|---|---|
| 構文: | ProxyVia On|Off|Full|Block |
| デフォルト: | ProxyVia Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy |
このディレクティブはプロキシの Via: HTTP ヘッダの使用を
制御します。想定されている使い方は、プロキシサーバがいくつも繋がっているときに
プロキシリクエストの流れを制御することです。Via: ヘッダ行の
説明は RFC 2616 (HTTP/1.1)
の 14.45 節を読んでください。
Off に設定されていると、特別な処理は
行なわれません。リクエストやリプライに Via: ヘッダがあれば、
変更されずにそのまま渡します。On に設定されていれば、各リクエストとリプライに
Via: 行が追加されます。Full に設定されていれば、Via: ヘッダは
コメント部分に Apache サーバのバージョンも含むようになります。Block に設定されていれば、すべてのプロキシリクエストから
Via: ヘッダが取り除かれます。新たに Via: が
生成されることはありません。Serveur HTTP Apache Version 2.4
Le document de référence rapide des directives montre l'usage, les valeurs par défaut, le statut, et le contexte de chaque directive de configuration d'Apache. Pour plus d'informations sur chacun de ces termes, voir le Dictionnaire des directives.
La première colonne donne le nom de la directive et son usage. Si la directive possède une valeur par défaut, elle est indiquée dans la deuxième colonne. Si la valeur par défaut est trop grande pour pouvoir être affichée, elle sera tronquée et suivie d'un "+".
La troisième colonne énumère les contextes dans lesquels la directive est applicable, et la quatrième indique son statut en accord avec le tableau des légendes ci-dessous.
| A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X |
|
|
| AcceptFilter protocole filtre d'acceptation | s | C | |
| Permet d'optimiser la configuration d'une socket pour l'écoute d'un protocole | |||
| AcceptPathInfo On|Off|Default | Default | svdh | C |
| Les ressources acceptent des informations sous forme d'un nom de chemin en fin de requête. | |||
| AccessFileName nom-du-fichier [nom-du-fichier] ... | .htaccess | sv | C |
| Nom du fichier de configuration distribué | |||
| Action type d'action script cgi [virtual] | svdh | B | |
| Active un script CGI pour un gestionnaire ou un type de contenu particulier | |||
| AddAlt texte fichier [fichier] ... | svdh | B | |
| Texte optionnel à afficher à la place d'un icône pour un fichier en fonction de son nom | |||
| AddAltByEncoding texte codage MIME [codage MIME] ... | svdh | B | |
| Texte optionnel à afficher à la place d'un icône pour un fichier en fonction de son codage MIME | |||
| AddAltByType texte type MIME [type MIME] ... | svdh | B | |
| Texte optionnel à afficher à la place d'un icône pour un fichier en fonction de son type MIME | |||
| AddCharset jeu-car extension [extension] ... | svdh | B | |
| Associe les extensions de noms de fichiers spécifiées au jeu de caractères spécifié | |||
| AddDefaultCharset On|Off|jeu de caractères | Off | svdh | C |
Paramètre jeu de caractères par défaut à ajouter quand le
type de contenu d'une réponse est text/plain ou
text/html | |||
| AddDescription texte [fichier] ... | svdh | B | |
| Afficher la description d'un fichier | |||
| AddEncoding codage extension [extension] ... | svdh | B | |
| Associe les extensions de noms de fichiers données au type de codage spécifié | |||
| AddHandler nom-gestionnaire extension [extension] ... | svdh | B | |
| Associe les extensions de noms de fichiers données au gestionnaire spécifié | |||
| AddIcon icône nom [nom] ... | svdh | B | |
| Icône à afficher pour un fichier en fonction de son nom | |||
| AddIconByEncoding icône codage MIME [codage MIME] ... | svdh | B | |
| Icône à afficher à côté d'un fichier en fonction de son codage MIME | |||
| AddIconByType icône type MIME [type MIME] ... | svdh | B | |
| Icône à afficher à côté d'un fichier en fonction de son type MIME | |||
| AddInputFilter filtre[;filtre...] extension [extension] ... | svdh | B | |
| Associe les extensions de noms de fichiers aux filtres spécifiés qui traiteront les requêtes clients | |||
| AddLanguage symbole-langue extension [extension] ... | svdh | B | |
| Associe l'extension de nom de fichier donnée à la langue spécifié | |||
| AddModuleInfo nom-module chaîne | sv | E | |
| Ajoute des données supplémentaires aux informations de module affichées par le gestionnaire server-info | |||
| AddOutputFilter filtre[;filtre...] extension [extension] ... | svdh | B | |
| Associe les extensions de noms de fichiers aux filtres spécifiés qui traiteront les réponses en provenance du serveur | |||
| AddOutputFilterByType filtre[;filtre...] type_de_média [type_de_média] ... | svdh | B | |
| assigne un filtre en sortie pour un type de média particulier | |||
| AddType type-médium extension [extension] ... | svdh | B | |
| Associe les extensions de noms de fichiers au type de contenu spécifié | |||
| Alias [chemin URL] chemin fichier|chemin répertoire | sv | B | |
| Met en correspondance des URLs avec des chemins du système de fichiers | |||
| AliasMatch regex chemin fichier|chemin répertoire | sv | B | |
| Met en correspondance des URLs avec le système de fichiers en faisant intervenir les expressions rationnelles | |||
| AliasPreservePath OFF|ON | OFF | svd | B |
| Associer le chemin entier à l'alias dans une section location. | |||
| Allow from all|hôte|env=[!]variable d'environnement [hôte|env=[!]variable d'environnement] ... | dh | E | |
| Spécifie quels hôtes peuvent accéder à une certaine zone du serveur | |||
| AllowCONNECT port[-port] [port[-port]] ... | 443 563 | sv | E |
Ports autorisés à se CONNECTer à travers le
mandataire | |||
| AllowEncodedSlashes On|Off|NoDecode | Off | sv | C |
| Détermine si les séparateurs de chemin encodés sont autorisés à transiter dans les URLs tels quels | |||
| AllowMethods reset|HTTP-method [HTTP-method]... | reset | d | X |
| Restreint l'accès aux méthodes HTTP spécifiées | |||
| AllowOverride All|None|type directive [type directive] ... | None à partir de la + | d | C |
Types de directives autorisées dans les fichiers
.htaccess | |||
| AllowOverrideList None|directive [directive-type] ... | None | d | C |
Directives autorisées dans les fichiers .htaccess | |||
| Anonymous utilisateur [utilisateur] ... | dh | E | |
| Définit la liste des identifiants utilisateur autorisés à accéder sans vérification du mot de passe | |||
| Anonymous_LogEmail On|Off | On | dh | E |
| Détermine si le mot de passe fourni sera enregistré dans le journal des erreurs | |||
| Anonymous_MustGiveEmail On|Off | On | dh | E |
| Détermine si l'abscence de mot de passe est autorisée | |||
| Anonymous_NoUserID On|Off | Off | dh | E |
| Détermine si le champ identifiant peut être vide | |||
| Anonymous_VerifyEmail On|Off | Off | dh | E |
| Détermine s'il faut vérifier que le format de l'adresse email fournie comme mot de passe est correct | |||
| AsyncRequestWorkerFactor facteur | s | M | |
| Limite le nombre de connexions simultanées par thread | |||
| AuthBasicAuthoritative On|Off | On | dh | B |
| Définit si les processus d'autorisation et d'authentification peuvent être confiés à des modules de plus bas niveau | |||
| AuthBasicFake off|username [password] | dh | B | |
| Authentification de base simulée à l'aide des nom d'utilisateur et mot de passe fournis | |||
| AuthBasicProvider nom fournisseur [nom fournisseur] ... | file | dh | B |
| Définit le(les) fournisseur(s) d'authentification pour cette zone du site web | |||
| AuthBasicUseDigestAlgorithm MD5|Off | Off | dh | B |
| Vérifie les mots de passe auprès des fournisseurs d'authentification à la manière de l'authentification de type Digest. | |||
| AuthDBDUserPWQuery requête | d | E | |
| Requête SQL servant à vérifier le mot de passe d'un utilisateur | |||
| AuthDBDUserRealmQuery requête | d | E | |
| Requête SQL servant à vérifier une empreinte de mot de passe pour un utilisateur et un identifiant d'authentification. | |||
| AuthDBMGroupFile chemin-fichier | dh | E | |
| Définit le nom du fichier de base de données contenant la liste des groupes d'utilisateurs permettant de définir les autorisations des utilisateurs | |||
| AuthDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Définit le type de fichier de base de données utilisé pour stocker les mots de passe | |||
| AuthDBMUserFile chemin-fichier | dh | E | |
| Définit le nom d'un fichier de base de données pour l'authentification contenant la liste des utilisateurs et de leurs mots de passe | |||
| AuthDigestAlgorithm MD5|MD5-sess | MD5 | dh | E |
| Sélectionne l'algorithme utilisé pour calculer les condensés du défit et de sa réponse | |||
| AuthDigestDomain URI [URI] ... | dh | E | |
| Les URIs qui se trouvent dans le même espace de protection concernant l'authentification à base de condensés | |||
| AuthDigestNonceLifetime secondes | 300 | dh | E |
| Durée de validité du nombre à valeur unique du serveur (nonce) | |||
| AuthDigestProvider nom fournisseur [nom fournisseur] ... | file | dh | E |
| Définit le(s) fournisseurs(s) d'authentification pour la zone du site web concernée | |||
| AuthDigestQop none|auth|auth-int [auth|auth-int] | auth | dh | E |
| Détermine le niveau de protection fourni par l'authentification à base de condensé | |||
| AuthDigestShmemSize taille | 1000 | s | E |
| La quantité de mémoire partagée à allouer afin de conserver les informations à propos des clients | |||
| AuthFormAuthoritative On|Off | On | dh | B |
| Détermine si l'autorisation et l'authentification sont confiés à des modules de plus bas niveau | |||
| AuthFormBody nom du champ | httpd_body | d | B |
| Le nom du champ de formulaire contenant le corps de la requête à effectuer en cas de connexion réussie | |||
| AuthFormDisableNoStore On|Off | Off | d | B |
| Désactive l'en-tête CacheControl no-store sur la page de connexion | |||
| AuthFormFakeBasicAuth On|Off | Off | d | B |
| Simule une en-tête d'authentification de base | |||
| AuthFormLocation nom du champ | httpd_location | d | B |
| Le nom du champ de formulaire qui contiendra l'URL vers laquelle l'utilisateur sera redirigé en cas de connexion réussie | |||
| AuthFormLoginRequiredLocation url | d | B | |
| L'URL de la page vers laquelle on doit être redirigé si une authentification est requise | |||
| AuthFormLoginSuccessLocation url | d | B | |
| L'URL de la page vers laquelle on doit être redirigé en cas de connexion réussie | |||
| AuthFormLogoutLocation uri | d | B | |
| L'URL vers laquelle un utilisateur devra être redirigé après s'être déconnecté | |||
| AuthFormMethod nom du champ | httpd_method | d | B |
| Le nom du champ de formulaire contenant la méthode de la requête à effectuer en cas de connexion réussie | |||
| AuthFormMimetype nom du champ | httpd_mimetype | d | B |
| Le nom du champ de formulaire contenant le type MIME du corps de la requête à effectuer en cas de connexion réussie | |||
| AuthFormPassword nom du champ | httpd_password | d | B |
| Le nom du champ de formulaire qui contient le mot de passe de connexion | |||
| AuthFormProvider nom fournisseur [nom fournisseur] ... | file | dh | B |
| Définit le(s) fournisseur(s) d'authentification pour la zone concernée | |||
| AuthFormSitePassphrase secret | d | B | |
| Court-circuite l'authentification pour les sites à fort trafic | |||
| AuthFormSize taille | 8192 | d | B |
| La taille maximale en octets du formulaire dont seront extraites les informations de connexion | |||
| AuthFormUsername nom du champ | httpd_username | d | B |
| Le nom du champ de formulaire qui contient le nom de connexion | |||
| AuthGroupFile chemin-fichier | dh | B | |
| Définit le nom d'un fichier texte contenant la liste des groupes d'utilisateurs permettant de définir les autorisations des utilisateurs | |||
| AuthLDAPAuthorizePrefix préfixe | AUTHORIZE_ | dh | E |
| Spécifie le préfixe ajouté aux variables d'environnement durant la phase d'autorisation | |||
| AuthLDAPBindAuthoritative off|on | on | dh | E |
| Détermine si l'on doit utiliser d'autres fournisseurs d'authentification lorsque le serveur ne peut pas valider les données d'authentification de l'utilisateur, alors que ce dernier possède un DN. | |||
| AuthLDAPBindDN dn | dh | E | |
| Un DN optionnel pour se connecter au serveur LDAP | |||
| AuthLDAPBindPassword mot-de-passe | dh | E | |
| Mot de passe à utiliser en conjonction avec le DN de connexion | |||
| AuthLDAPCharsetConfig chemin-fichier | s | E | |
| Chemin du fichier de configuration de la correspondance langage/jeu de caractères | |||
| AuthLDAPCompareAsUser on|off | off | dh | E |
| Utilisation des données d'authentification de l'utilisateur pour effectuer les comparaisons pour l'attribution des autorisations | |||
| AuthLDAPCompareDNOnServer on|off | on | dh | E |
| Utilise le serveur LDAP pour comparer les DNs | |||
| AuthLDAPDereferenceAliases never|searching|finding|always | always | dh | E |
| À quel moment le module va déréférencer les alias | |||
| AuthLDAPGroupAttribute attribut | member uniqueMember + | dh | E |
| L'attribut LDAP utilisé pour vérifier l'appartenance d'un utilisateur à un groupe. | |||
| AuthLDAPGroupAttributeIsDN on|off | on | dh | E |
| Utilise le DN de l'utilisateur pour vérifier son appartenance à un groupe | |||
| AuthLDAPInitialBindAsUser off|on | off | dh | E |
| Détermine si le serveur effectue la recherche initiale du DN en utilisant le nom propre de l'utilisateur pour l'authentification de base et non de manière anonyme, ou en utilisant des données d'authentification codées en dur pour le serveur | |||
| AuthLDAPInitialBindPattern regex substitution | (.*) $1 (nom de l'u + | dh | E |
| Spécifie la modification a apporter au nom d'utilisateur pour l'authentification de base lors de l'authentification auprès du serveur LDAP pour effectuer une recherche de DN | |||
| AuthLDAPMaxSubGroupDepth Nombre | 10 | dh | E |
| Spécifie la profondeur d'imbrication des sous-groupes maximale prise en compte avant l'abandon de la recherche de l'utilisateur. | |||
| AuthLDAPRemoteUserAttribute uid | dh | E | |
| Spécifie l'attribut dont la valeur renvoyée au cours de la requête de l'utilisateur sera utilisée pour définir la variable d'environnement REMOTE_USER | |||
| AuthLDAPRemoteUserIsDN on|off | off | dh | E |
| Utilise le DN de l'utilisateur pour définir la variable d'environnement REMOTE_USER | |||
| AuthLDAPSearchAsUser on|off | off | dh | E |
| Utilise les données d'authentification de l'utilisateur pour la recherche des autorisations | |||
| AuthLDAPSubGroupAttribute attribut | dh | E | |
| Spécifie les noms d'attribut, un par directive, utilisés pour différencier les membres du groupe courant qui sont eux-mêmes des groupes. | |||
| AuthLDAPSubGroupClass ObjectClass-LDAP | groupOfNames groupO + | dh | E |
| Spécifie quelles valeurs d'objectClass LDAP identifient les objets de l'annuaire qui sont des groupes au cours du traitement des sous-groupes. | |||
| AuthLDAPURL url [NONE|SSL|TLS|STARTTLS] | dh | E | |
| URL specifying the LDAP search parameters | |||
| AuthMerging Off | And | Or | Off | dh | B |
| Définit la manière dont chaque logique d'autorisation des sections de configuration se combine avec celles des sections de configuration précédentes. | |||
| AuthName domaine d'autorisation | dh | B | |
| L'identifiant de l'autorisation à utiliser avec l'authentification HTTP | |||
| AuthnCacheContext directory|server|custom-string | directory | d | B |
| Spécifie une chaîne de contexte à utiliser dans la clé du cache | |||
| AuthnCacheEnable | s | B | |
| Active la mise en cache de l'authentification en tout endroit | |||
| AuthnCacheProvideFor fournisseur-authn [...] | dh | B | |
| Spécifie le fournisseur pour lequel on veut effectuer une mise en cache | |||
| AuthnCacheSOCache nom-fournisseur[:arguments-fournisseur] | s | B | |
| Sélectionne le fournisseur socache d'arrière-plan à utiliser | |||
| AuthnCacheTimeout durée-de-vie (secondes) | 300 (5 minutes) | dh | B |
| Définit une durée de vie pour les entrées du cache | |||
| <AuthnProviderAlias alias-fournisseur> ... </AuthnProviderAlias> | s | B | |
| Regroupe un ensemble de directives qui constituent une extension d'un fournisseur d'authentification de base et lui attribue l'alias spécifié | |||
AuthnzFcgiCheckAuthnProvider provider-name|None
option ... | d | E | |
| Permet à une application FastCGI de gérer l'accroche d'authentification check_authn. | |||
| AuthnzFcgiDefineProvider type provider-name backend-address | s | E | |
| Définit une application FastCGI en tant que fournisseur d'authentification et/ou autorisation | |||
| AuthType None|Basic|Digest|Form | dh | B | |
| Type d'authentification utilisateur | |||
| AuthUserFile chemin-fichier | dh | B | |
| Définit le nom d'un fichier texte pour l'authentification contenant la liste des utilisateurs et de leurs mots de passe | |||
| AuthzDBDLoginToReferer On|Off | Off | d | E |
Définit si le client doit être redirigé vers la page
d'origine en cas de connexion ou de déconnexion réussie si un en-tête
de requête Referer est présent | |||
| AuthzDBDQuery requête | d | E | |
| Définit la requête SQL pour l'opération requise | |||
| AuthzDBDRedirectQuery requête | d | E | |
| Définit une requête pour rechercher une page vers laquelle rediriger l'utilisateur après une connexion réussie | |||
| AuthzDBMType default|SDBM|GDBM|NDBM|DB | default | dh | E |
| Définit le type de fichier de base de données contenant la liste des groupes d'utilisateurs | |||
| <AuthzProviderAlias fournisseur-de-base Alias Paramètres-Require> ... </AuthzProviderAlias> | s | B | |
| Regroupe des directives représentant une extension d'un fournisseur d'autorisation de base qui pourra être référencée à l'aide de l'alias spécifié | |||
| AuthzSendForbiddenOnFailure On|Off | Off | dh | B |
| Envoie '403 FORBIDDEN' au lieu de '401 UNAUTHORIZED' si l'authentification réussit et si l'autorisation a été refusée. | |||
| BalancerGrowth # | 5 | sv | E |
| Nombre de membres supplémentaires pouvant être ajoutés après la configuration initiale | |||
| BalancerInherit On|Off | On | sv | E |
| Héritage des membres du groupes de répartition de charge du mandataire définis au niveau du serveur principal | |||
| BalancerMember [balancerurl] url [clé=valeur [clé=valeur ...]] | d | E | |
| Ajoute un membre à un groupe de répartition de charge | |||
| BalancerPersist On|Off | Off | sv | E |
| Tente de conserver les changements effectués par le gestionnaire de répartition de charge après un redémarrage du serveur. | |||
| BrotliAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| Comment l'en-tête de réponse ETag doit être modifié au cours de la compression | |||
| BrotliCompressionMaxInputBlock value | sv | E | |
| Taille maximale du bloc de données en entrée | |||
| BrotliCompressionQuality value | 5 | sv | E |
| Qualité de la compression | |||
| BrotliCompressionWindow value | 18 | sv | E |
| Taille de la fenêtre de compression glissante brotli | |||
| BrotliFilterNote [type] notename | sv | E | |
| Enregistre le taux de compression dans une note à des fins de journalisation | |||
| BrowserMatch regex [!]env-variable[=valeur] [[!]env-variable[=valeur]] ... | svdh | B | |
| Définit des variables d'environnement en fonction du contenu de l'en-tête HTTP User-Agent | |||
| BrowserMatchNoCase regex [!]env-variable[=valeur] [[!]env-variable[=valeur]] ... | svdh | B | |
| Définit des variables d'environnement en fonction du contenu de l'en-tête HTTP User-Agent sans tenir compte de la casse | |||
| BufferedLogs On|Off | Off | s | B |
| Enregistre les entrées du journal dans un tampon en mémoire avant de les écrire sur disque | |||
| BufferSize entier | 131072 | svdh | E |
| Taille maximale en octets du filtre par tampon | |||
| CacheDefaultExpire secondes | 3600 (une heure) | svdh | E |
| La durée par défaut de mise en cache d'un document lorsqu'aucune date d'expiration n'a été spécifiée. | |||
| CacheDetailHeader on|off | off | svdh | E |
| Ajoute un en-tête X-Cache-Detail à la réponse. | |||
| CacheDirLength longueur | 2 | sv | E |
| Le nombre de caractères des noms des sous-répertoires | |||
| CacheDirLevels niveaux | 2 | sv | E |
| Le nombre de niveaux de sous-répertoires que comportera le cache. | |||
| CacheDisable chaîne-url | on | svdh | E | |
| Désactive la mise en cache des URLs spécifiées | |||
| CacheEnable type de cache [chaîne URL] | svd | E | |
| Active la mise en cache des URLs spécifiées en utilisant le gestionnaire de stockage précisé | |||
| CacheFile chemin fichier [chemin fichier] ... | s | X | |
| Met en cache une liste de gestionnaires de fichiers au démarrage | |||
| CacheHeader on|off | off | svdh | E |
| Ajoute un en-tête X-Cache à la réponse. | |||
| CacheIgnoreCacheControl On|Off | Off | sv | E |
| Ignore les en-têtes de requête enjoignant de ne pas servir le contenu au client depuis le cache | |||
| CacheIgnoreHeaders en-tête [en-tête] ... | None | sv | E |
| Ne pas stocker le(s) en-tête(s) spécifié(s) dans le cache. | |||
| CacheIgnoreNoLastMod On|Off | Off | svdh | E |
| Ignore le fait qu'une réponse ne possède pas d'en-tête Last Modified. | |||
| CacheIgnoreQueryString On|Off | Off | sv | E |
| Ignore la chaîne de paramètres lors de la mise en cache | |||
| CacheIgnoreURLSessionIdentifiers identifiant [identifiant] ... | None | sv | E |
| Ignore les identifiants de session définis encodés dans l'URL lors de la mise en cache | |||
| CacheKeyBaseURL URL | sv | E | |
| Remplace l'URL de base des clés du cache mandatées en inverse | |||
| CacheLastModifiedFactor flottant | 0.1 | svdh | E |
| Le facteur utilisé pour générer une date d'expiration en fonction de la date de dernière modification. | |||
| CacheLock on|off | off | sv | E |
| Active la protection contre les tempêtes de requêtes. | |||
| CacheLockMaxAge entier | 5 | sv | E |
| Définit la durée de vie maximale d'un verrou de cache. | |||
| CacheLockPath répertoire | /tmp/mod_cache-lock + | sv | E |
| Définit le répertoire des verrous. | |||
| CacheMaxExpire secondes | 86400 (une journée) + | svdh | E |
| La durée maximale en secondes de mise en cache d'un document | |||
| CacheMaxFileSize octets | 1000000 | svdh | E |
| >La taille maximale (en octets) d'un document pour pouvoir être stocké dans le cache | |||
| CacheMinExpire secondes | 0 | svdh | E |
| La durée minimale en secondes de mise en cache d'un document | |||
| CacheMinFileSize octets | 1 | svdh | E |
| La taille minimale (en octets) d'un document pour pouvoir être stocké dans le cache | |||
| CacheNegotiatedDocs On|Off | Off | sv | B |
| Permet la mise en cache au niveau des serveurs mandataires des documents dont le contenu a été négocié | |||
| CacheQuickHandler on|off | on | sv | E |
| Exécute le cache à partir d'un gestionnaire rapide. | |||
| CacheReadSize octets | 0 | svdh | E |
| La quantité minimale (en octets) de données à lire et à mettre en cache avant de les envoyer au client | |||
| CacheReadTime millisecondes | 0 | svdh | E |
| Le temps minimum (en millisecondes) qui doit s'écouler avant d'envoyer les données au client | |||
| CacheRoot répertoire | sv | E | |
| La racine du répertoire dans lequel les fichiers du cache seront stockés | |||
| CacheSocache type[:args] | sv | E | |
| Implémentation du cache d'objets partagés à utiliser | |||
| CacheSocacheMaxSize octets | 102400 | svdh | E |
| La taille maximale d'une entrée pouvant être placée dans le cache | |||
| CacheSocacheMaxTime secondes | 86400 | svdh | E |
| La durée maximale de stockage d'un document dans le cache avant péremption | |||
| CacheSocacheMinTime seconds | 600 | svdh | E |
| La durée minimale de stockage d'un document dans le cache | |||
| CacheSocacheReadSize octets | 0 | svdh | E |
| La quantité minimale de données du document à lire et mettre en cache avant envoi au client | |||
| CacheSocacheReadTime millisecondes | 0 | svdh | E |
| La durée minimale de lecture avant l'envoi des données | |||
| CacheStaleOnError on|off | on | svdh | E |
| Sert du contenu non à jour à la place de réponses 5xx. | |||
| CacheStoreExpired On|Off | Off | svdh | E |
| Tente de mettre en cache les réponses que le serveur considère comme arrivées à expiration | |||
| CacheStoreNoStore On|Off | Off | svdh | E |
| Tente de mettre en cache les requêtes ou réponses dont l'entête Cache-Control: a pour valeur no-store. | |||
| CacheStorePrivate On|Off | Off | svdh | E |
| Tente de mettre en cache des réponses que le serveur a marquées comme privées | |||
| CGIDScriptTimeout time[s|ms] | svdh | B | |
| Durée maximale d'attente de la prochaine sortie du programme CGI | |||
| CGIMapExtension chemin CGI .extension | dh | C | |
| Technique permettant de localiser l'interpréteur des scripts CGI | |||
| CGIPassAuth On|Off | Off | dh | C |
| Active la transmission d'en-têtes d'autorisation HTTP aux scripts en tant que variables CGI | |||
| CGIScriptTimeout time[s|ms] | svdh | B | |
| Le temps d'attente maximum pour une sortie du programme CGI | |||
| CGIVar variable rule | dh | C | |
| Contrôle la manière dont certaines variables CGI sont définies | |||
| CharsetDefault jeu de caractères | svdh | E | |
| Jeu de caractère vers lequel la traduction doit s'effectuer | |||
| CharsetOptions option [option] ... | ImplicitAdd | svdh | E |
| Précise les détails de la traduction du jeu de caractères | |||
| CharsetSourceEnc jeu de caractères | svdh | E | |
| Jeu de caractères source des fichiers | |||
| CheckBasenameMatch on|off | On | svdh | E |
| Vérifie aussi la correspondance des fichiers, même avec des extensions différentes | |||
| CheckCaseOnly on|off | Off | svdh | E |
| Limite l'action du module aux corrections de majuscules | |||
| CheckSpelling on|off | Off | svdh | E |
| Active le module de correction | |||
| ChrootDir chemin-répertoire | s | B | |
| Répertoire dans lequel Apache doit se positionner au démarrage après avoir effectué un chroot(8). | |||
| ContentDigest On|Off | Off | svdh | C |
Active la génération d'un en-tête Content-MD5
dans la réponse HTTP | |||
| CookieDomain domaine | svdh | E | |
| Le domaine auquel le cookie traceur s'applique | |||
| CookieExpires durée | svdh | E | |
| Durée avant expiration du cookie traceur | |||
| CookieHTTPOnly on|off | off | svdh | E |
| Ajoute l'attribut 'HTTPOnly' au cookie | |||
| CookieName symbole | Apache | svdh | E |
| Nom du cookie traceur | |||
| CookieSameSite None|Lax|Strict | svdh | E | |
| Ajoute l'attribut 'SameSite' au cookie | |||
| CookieSecure on|off | off | svdh | E |
| Ajoute l'attribut 'Secure' au cookie | |||
| CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965 | Netscape | svdh | E |
| Format du champ d'en-tête cookie | |||
| CookieTracking on|off | off | svdh | E |
| Active le cookie traceur | |||
| CoreDumpDirectory répertoire | s | M | |
| Le répertoire dans lequel le serveur HTTP Apache va tenter de se positionner avant d'effectuer un vidage mémoire | |||
| CustomLog fichier|pipe format|alias [env=[!]variable-environnement| expr=expression] | sv | B | |
| Définit le nom et le format du fichier journal | |||
| Dav On|Off|nom fournisseur | Off | d | E |
| Active les méthodes HTTP WebDAV | |||
| DavBasePath root-path | d | E | |
| Définir le chemin de la racine du répertoire | |||
| DavDepthInfinity on|off | off | svd | E |
| Autorise les requêtes PROPFIND avec en-tête Depth: Infinity | |||
| DavGenericLockDB chemin fichier | svd | E | |
| Chemin de la base de données des verrous DAV | |||
| DavLockDB chemin fichier | sv | E | |
| Chemin de la base de données des verrous DAV | |||
| DavLockDiscovery on|off | on | svdh | E |
| Active la découverte des verrous | |||
| DavMinTimeout secondes | 0 | svd | E |
| Durée minimale pendant laquelle le serveur maintient un verrou sur une ressource DAV | |||
| DBDExptime durée en secondes | 300 | sv | E |
| Durée de vie des connexions inactives | |||
| DBDInitSQL "instruction SQL" | sv | E | |
| Exécute une instruction SQL après connexion à une base de données | |||
| DBDKeep nombre | 2 | sv | E |
| Nombre maximum de connexions maintenues | |||
| DBDMax nombre | 10 | sv | E |
| Nombre maximum de connexions | |||
| DBDMin nombre | 1 | sv | E |
| Nombre minimum de connexions | |||
| DBDParams param1=valeur1[,param2=valeur2] | sv | E | |
| Paramètres de la connexion à la base de données | |||
| DBDPersist On|Off | sv | E | |
| Utiliser ou non des connexions persistentes | |||
| DBDPrepareSQL "requête SQL" étiquette | sv | E | |
| Définit une requête SQL préparée | |||
| DBDriver nom | sv | E | |
| Spécifie un pilote SQL | |||
| DefaultIcon chemin URL | svdh | B | |
| Icône à afficher par défaut lorsqu'aucun icône spécifique n'est précisé | |||
| DefaultLanguage symbole-langue | svdh | B | |
| Définit un symbole de langue par défaut à affecter au champ d'en-tête Content-Language pour toutes les ressources dans le contexte courant auxquelles aucun symbole de langue n'a été associé. | |||
| DefaultRuntimeDir chemin-répertoire | DEFAULT_REL_RUNTIME + | s | C |
| Répertoire de base des fichiers créés au cours de l'exécution du serveur | |||
| DefaultType type média|none | none | svdh | C |
Les seuls effets de cette directive sont des émissions
d'avertissements si sa valeur est différente de none. Dans
les versions précédentes, DefaultType permettait de spécifier un type de
média à assigner par défaut au contenu d'une réponse pour lequel aucun
autre type de média n'avait été trouvé.
| |||
| Define nom-paramètre [valeur-paramètre] | svd | C | |
| Permet de définir une variable | |||
| DeflateAlterETag AddSuffix|NoChange|Remove | AddSuffix | sv | E |
| Comment l'en-tête sortant ETag doit être modifié au cours de la compression | |||
| DeflateBufferSize valeur | 8096 | sv | E |
| Taille du fragment que zlib devra comprimer en une seule fois | |||
| DeflateCompressionLevel valeur | sv | E | |
| Le niveau de compression que nous appliquons à la sortie | |||
| DeflateFilterNote [type] nom de la note | sv | E | |
| Enregistre le taux de compression sous la forme d'une note à des fins de journalisation | |||
| DeflateInflateLimitRequestBody value | svdh | E | |
| Taille maximale des corps de requête décompressés | |||
| DeflateInflateRatioBurst value | 3 | svdh | E |
| Nombre maximal de fois que le ratio de décompression d'un corps de requête peut être dépassé | |||
| DeflateInflateRatioLimit value | 200 | svdh | E |
| Ratio de décompression maximum pour les corps de requêtes | |||
| DeflateMemLevel valeur | 9 | sv | E |
| La quantité de mémoire utilisable par zlib pour la compression | |||
| DeflateWindowSize valeur | 15 | sv | E |
| Taille de la fenêtre de compression zlib | |||
| Deny from all|hôte|env=[!]variable d'environnement [hôte|env=[!]variable d'environnement] ... | dh | E | |
| Définit quels hôtes ne sont pas autorisés à accéder au serveur | |||
| <Directory chemin répertoire> ... </Directory> | sv | C | |
| Regroupe un ensemble de directives qui ne s'appliquent qu'au répertoire concerné du système de fichiers, à ses sous-répertoires, et à leur contenu. | |||
| DirectoryCheckHandler On|Off | Off | svdh | B |
| Définit la réponse de ce module lorsqu'un autre gestionnaire est utilisé | |||
| DirectoryIndex disabled | url locale [url locale] ... | index.html | svdh | B |
| Liste des fichiers ressources à rechercher lorsque le client envoie une requête pour un répertoire | |||
| DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-code | off | svdh | B |
| Définit une redirection externe pour les index de répertoires. | |||
| <DirectoryMatch regex> ... </DirectoryMatch> | sv | C | |
| Regroupe des directives qui s'appliquent au contenu de répertoires du système de fichiers correspondant à une expression rationnelle | |||
| DirectorySlash On|Off | On | svdh | B |
| Activation/Désactivation de la redirection "slash de fin" | |||
| DocumentRoot chemin répertoire | "/usr/local/apache/ + | sv | C |
| Racine principale de l'arborescence des documents visible depuis Internet | |||
| DTracePrivileges On|Off | Off | s | X |
| Détermine si les privilèges requis par dtrace sont activés. | |||
| DumpIOInput On|Off | Off | s | E |
| Enregistre toutes les entrées dans le journal des erreurs | |||
| DumpIOOutput On|Off | Off | s | E |
| Enregistre toutes les sorties dans le journal des erreurs | |||
| <Else> ... </Else> | svdh | C | |
Contient des directives qui ne s'appliquent que si la
condition correspondant à la section <If> ou <ElseIf> précédente n'est pas satisfaite par la
requête à l'exécution | |||
| <ElseIf expression> ... </ElseIf> | svdh | C | |
Contient des directives qui ne s'appliquent que si la
condition correspondante est satisfaite par une requête à l'exécution,
alors que la condition correspondant à la section <If> ou <ElseIf> précédente ne l'était pas. | |||
| EnableExceptionHook On|Off | Off | s | M |
| Active un hook ("point d'accrochage logiciel") qui exécute des gestionnaires d'exception après un crash | |||
| EnableMMAP On|Off | On | svdh | C |
| Utilise la projection en mémoire (Memory-Mapping) pour lire les fichiers pendant qu'ils sont servis | |||
| EnableSendfile On|Off | Off | svdh | C |
| Utilise le support sendfile du noyau pour servir les fichiers aux clients | |||
| Error message | svdh | C | |
| Interrompt la lecture de la configuration avec un message d'erreur personnalisé | |||
| ErrorDocument code erreur document | svdh | C | |
| Document que le serveur renvoie au client en cas d'erreur | |||
| ErrorLog file-path|syslog[:[facility][:tag]] | logs/error_log (Uni + | sv | C |
| Définition du chemin du journal des erreurs | |||
| ErrorLogFormat [connection|request] format | sv | C | |
| Spécification du format des entrées du journal des erreurs | |||
| Example | svdh | X | |
| Directive de démonstration pour illustrer l'API des modules Apache | |||
| ExpiresActive On|Off | Off | svdh | E |
Active la génération d'en-têtes
Expires | |||
| ExpiresByType type MIME <code>secondes | svdh | E | |
Définition de la valeur de l'en-tête Expires
en fonction du type MIME | |||
| ExpiresDefault <code>secondes | svdh | E | |
| Mode de calcul par défaut de la date d'expiration | |||
| ExtendedStatus On|Off | Off | s | C |
| Extrait des informations d'état étendues pour chaque requête | |||
| ExtFilterDefine nom_filtre paramètres | s | E | |
| Définit un filtre externe | |||
| ExtFilterOptions option [option] ... | NoLogStderr | d | E |
Configure les options de
mod_ext_filter | |||
| FallbackResource disabled | url-locale | svdh | B | |
| Définit une URL par défaut pour les requêtes qui ne ciblent aucun fichier | |||
| FileETag composant ... | MTime Size | svdh | C |
| Caractéristiques de fichier utilisées lors de la génération de l'en-tête de réponse HTTP ETag pour les fichiers statiques | |||
| <Files nom fichier> ... </Files> | svdh | C | |
| Contient des directives qui s'appliquent aux fichiers précisés | |||
| <FilesMatch expression rationnelle> ... </FilesMatch> | svdh | C | |
| Contient des directives qui s'appliquent à des fichiers spécifiés sous la forme d'expressions rationnelles | |||
| FilterChain [+=-@!]nom_filtre ... | svdh | B | |
| Configure la chaîne de filtrage | |||
| FilterDeclare nom_filtre [type] | svdh | B | |
| Déclare un filtre intelligent | |||
| FilterProtocol nom_filtre [nom_fournisseur] drapeaux_protocole | svdh | B | |
| Vérifie le respect du protocole HTTP | |||
| FilterProvider nom_filtre nom_fournisseur expression | svdh | B | |
| Enregistre un filtre de contenu | |||
| FilterTrace nom_filtre niveau | svd | B | |
Obtention d'informations de débogage/diagnostique en
provenance de mod_filter | |||
| FlushMaxPipelined number | 5 | sv | C |
| Nombre maximal de réponses en attente (pipelined) au-delà duquel elles sont envoyées sur le réseau | |||
| FlushMaxThreshold number-of-bytes | 65535 | sv | C |
| Seuil au-delà duquel les données en attente sont envoyées sur le réseau | |||
| ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] | Prefer | svdh | B |
| Action à entreprendre si un document acceptable unique n'est pas trouvé | |||
| ForceType type médium|None | dh | C | |
| Force le type de médium spécifié dans le champ d'en-tête HTTP Content-Type pour les fichiers correspondants | |||
| ForensicLog nom-fichier|pipe | sv | E | |
| Définit le nom de fichier du journal légal | |||
| GlobalLogfile|pipe format|nickname [env=[!]environment-variable| expr=expression] | s | B | |
| Définit le nom et le format du fichier journal | |||
| GprofDir /tmp/gprof/|/tmp/gprof/% | sv | C | |
| Répertoire dans lequel écrire les données de profiling gmon.out. | |||
| GracefulShutdownTimeout seconds | 0 | s | M |
| Spécifie le délai maximum après lequel le serveur va s'arrêter dans le cas d'un arrêt "en douceur" | |||
| Group groupe unix | #-1 | s | B |
| Groupe sous lequel le serveur va traiter les requêtes | |||
| H2CopyFiles on|off | off | svdh | E |
| Contrôle la gestion des fichiers dans les réponses | |||
| H2Direct on|off | on pour h2c, off po + | sv | E |
| Activation du protocole H2 Direct | |||
| H2EarlyHint name value | svdh | E | |
| Ajoute un en-tête de réponse à consulter dans le code de retour 103 Early Hints | |||
| H2EarlyHints on|off | off | sv | E |
| Contrôle l'envoi de codes d'état 103 | |||
| H2MaxDataFrameLen n | 0 | sv | E |
| Nombre maximal d'octets dans une trame HTTP/2 DATA | |||
| H2MaxHeaderBlockLen n | 0 | sv | E |
| Taille maximale des en-têtes d’une réponse | |||
| H2MaxSessionStreams n | 100 | sv | E |
| Nombre maximal de flux actifs par session HTTP/2. | |||
| H2MaxWorkerIdleSeconds n | 600 | s | E |
| Nombre maximal de secondes pendant lequel une unité de traitement h2 pourra rester inactive sans être arrêtée. | |||
| H2MaxWorkers n | s | E | |
| Nombre maximal de threads à utiliser pour chaque processus enfant. | |||
| H2MinWorkers n | s | E | |
| Nombre minimal de threads à utiliser pour chaque processus enfant. | |||
| H2ModernTLSOnly on|off | on | sv | E |
| Impose les connexions HTTP/2 en mode "TLS moderne" seulement | |||
| H2OutputBuffering on|off | on | sv | E |
| Contrôle la mise en tampon du flux de sortie | |||
| H2Padding numbits | 0 | sv | E |
| Spécifie un intervalle de nombres d'octets de bourrage à ajouter aux trames utiles | |||
| H2ProxyRequests on|off | off | sv | E |
| Active/Désactive les requêtes sous mandat direct via HTTP/2 | |||
| H2Push on|off | on | svdh | E |
| Activation/désactivation du server push H2 | |||
| H2PushDiarySize n | 256 | sv | E |
| Taille du journal des Pushes H2 | |||
| H2PushPriority mime-type [after|before|interleaved] [weight] | * After 16 | sv | E |
| Priorité des pushes H2 | |||
| H2PushResource [add] path [critical] | svdh | E | |
| Déclare des ressources à proposer ("pusher") au client | |||
| H2SerializeHeaders on|off | off | sv | E |
| Active/désactive la sérialisation du traitement des requêtes/réponses | |||
| H2StreamMaxMemSize bytes | 65536 | sv | E |
| Quantité maximale de données en sortie mises en tampon par flux. | |||
| H2StreamTimeout time-interval[s] | svd | E | |
| Temps d'attente maximum lors de l'envoi/réception de données pour le traitement d'un flux | |||
| H2TLSCoolDownSecs seconds | 1 | sv | E |
| Durée d'inactivité d'une connexion TLS avant diminution de la taille des paquets | |||
| H2TLSWarmUpSize amount | 1048576 | sv | E |
| Taille des paquets durant la phase initiale de la connexion TLS | |||
| H2Upgrade on|off | on pour h2c, off po + | svdh | E |
| Activation/Désactivation du protocole de mise à jour H2 | |||
| H2WebSockets on|off | off | sv | E |
| Active/désactive les WebSockets via HTTP/2 | |||
| H2WindowSize bytes | 65535 | sv | E |
| Taille maximale des paquets de données pour les transmissions client vers serveur. | |||
| Header [condition] add|append|echo|edit|edit*|merge|set|setifempty|unset|note en-tête [[expr=]valeur [remplacement] [early|env=[!]variable|expr=expression]] | svdh | E | |
| Configure les en-têtes d'une réponse HTTP | |||
| HeaderName nom fichier | svdh | B | |
| Nom du fichier qui sera inséré au début de la page contenant l'index | |||
| HeartbeatAddress addr:port | s | X | |
| Adresse multicast à laquelle envoyer les requêtes heartbeat | |||
| HeartbeatListen addr:port | s | X | |
| Adresse multicast d'écoute des requêtes entrantes heartbeat | |||
| HeartbeatMaxServers nombre-de-serveurs | 10 | s | X |
| Spécifie le nombre maximal de serveurs qui pourront envoyer des requêtes heartbeat à ce serveur. | |||
| HeartbeatStorage chemin fichier | logs/hb.dat | s | X |
| Chemin vers le stockage des données heartbeat lorsqu'on utilise un fichier bidimensionnel (flat-file) | |||
| HeartbeatStorage chemin-fichier | logs/hb.dat | s | X |
| Indique le chemin permettant de lire les données heartbeat | |||
| HostnameLookups On|Off|Double | Off | svd | C |
| Active la recherche DNS sur les adresses IP des clients | |||
| HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods] [Allow0.9|Require1.0] | Strict LenientMetho + | sv | C |
| Modifie les contraintes sur les messages des requêtes HTTP | |||
| IdentityCheck On|Off | Off | svd | E |
| Active la journalisation de l'identité RFC 1413 de l'utilisateur distant | |||
| IdentityCheckTimeout secondes | 30 | svd | E |
| Détermine le délai d'attente pour les requêtes ident | |||
| <If expression> ... </If> | svdh | C | |
| Contient des directives qui ne s'appliquent que si une condition est satisfaite au cours du traitement d'une requête | |||
| <IfDefine [!]paramètre> ... </IfDefine> | svdh | C | |
| Contient des directives qui ne s'appliqueront que si un test retourne "vrai" au démarrage du serveur | |||
| <IfDirective [!]directive-name> ... </IfDirective> | svdh | C | |
| Regroupe des directives dont le traitement est conditionné par la présence ou l'absence d'une directive particulière | |||
| <IfFile [!]filename> ... </IfFile> | svdh | C | |
| Regroupe des directives qui ne seront traitées que si un fichier existe au démarrage | |||
| <IfModule [!]fichier module|identificateur module> ... </IfModule> | svdh | C | |
| Contient des directives qui ne s'appliquent qu'en fonction de la présence ou de l'absence d'un module spécifique | |||
| <IfSection [!]section-name> ... </IfSection> | svdh | C | |
| Regroupe des directives dont le traitement est conditionné par la présence ou l'absence d'une section particulière | |||
| <IfVersion [[!]opérateur] version> ... </IfVersion> | svdh | E | |
| Contient des portions de configuration dépendantes de la version | |||
| ImapBase map|referer|URL | http://nom_serveur/ + | svdh | B |
Valeur par défaut de la directive base des
fichiers imagemap | |||
| ImapDefault error|nocontent|map|referer|URL | nocontent | svdh | B |
| Action à entreprendre par défaut lorsqu'un fichier imagemap est invoqué avec des coordonnées qui ne correspondent à aucune cible | |||
| ImapMenu none|formatted|semiformatted|unformatted | formatted | svdh | B |
| Action à entreprendre si aucune coordonnée n'est fournie lorsqu'on invoque un fichier imagemap | |||
| Include chemin-fichier|chemin-répertoire|wildcard | svd | C | |
| Inclut d'autres fichiers de configuration dans un des fichiers de configuration du serveur | |||
| IncludeOptional file-path|directory-path|wildcard | svd | C | |
| Inclusion de fichiers dans le fichier de configuration | |||
| IndexHeadInsert "marque ..." | svdh | B | |
| Insère du texte dans la section HEAD de la page d'index. | |||
| IndexIgnore fichier [fichier] ... | "." | svdh | B |
| Ajouts à la liste des fichiers à cacher lors de l'affichage de l'index d'un répertoire | |||
| IndexIgnoreReset ON|OFF | svdh | B | |
| Vide la liste des fichiers à cacher lors de l'affichage du contenu d'un répertoire | |||
| IndexOptions [+|-]option [[+|-]option] ... | svdh | B | |
| Diverses options de configuration pour l'indexation d'un répertoire | |||
| IndexOrderDefault Ascending|Descending Name|Date|Size|Description | Ascending Name | svdh | B |
| Définit l'ordre d'affichage par défaut d'un index de répertoire | |||
| IndexStyleSheet chemin-url | svdh | B | |
| Ajoute une feuille de style CSS à l'index du répertoire | |||
| InputSed commande-sed | dh | ||
Commande sed à exécuter pour le filtrage des données d'une
requête (en général des données POST) | |||
| ISAPIAppendLogToErrors on|off | off | svdh | B |
Enregistrement des requêtes
HSE_APPEND_LOG_PARAMETER de la part des extensions ISAPI
dans le journal des erreurs | |||
| ISAPIAppendLogToQuery on|off | on | svdh | B |
Enregistre les requêtes
HSE_APPEND_LOG_PARAMETER de la part des extensions ISAPI
dans la partie arguments de la requête | |||
| ISAPICacheFile chemin-fichier [chemin-fichier] ... | sv | B | |
| Fichiers .dll ISAPI devant être chargés au démarrage | |||
| ISAPIFakeAsync on|off | off | svdh | B |
| Emulation du support des entrées/sorties asynchrones pour les appels ISAPI | |||
| ISAPILogNotSupported on|off | off | svdh | B |
| Journalisation des demandes de fonctionnalités non supportées de la part des extensions ISAPI | |||
| ISAPIReadAheadBuffer taille | 49152 | svdh | B |
| Taille du tampon de lecture anticipée envoyé aux extensions ISAPI | |||
| KeepAlive On|Off | On | sv | C |
| Active les connexions HTTP persistantes | |||
| KeepAliveTimeout nombre[ms] | 5 | sv | C |
| Durée pendant laquelle le serveur va attendre une requête avant de fermer une connexion persistante | |||
| KeptBodySize taille maximale en octets | 0 | d | B |
| Conserve le corps de la requête à concurrence de la taille maximale spécifiée, pour une utilisation éventuelle par des filtres comme mod_include. | |||
| LanguagePriority langage-MIME [langage-MIME] ... | svdh | B | |
| L'ordre de priorité des variantes de langages pour les cas où le client n'a pas formulé de préférences | |||
| LDAPCacheEntries nombre | 1024 | s | E |
| Nombre maximum d'entrées dans le cache LDAP primaire | |||
| LDAPCacheTTL secondes | 600 | s | E |
| Durée pendant laquelle les entrées du cache restent valides. | |||
| LDAPConnectionPoolTTL n | -1 | sv | E |
| Désactive les connexions d'arrière-plan qui sont restées inactives trop longtemps au sein du jeu de connexions. | |||
| LDAPConnectionTimeout secondes | s | E | |
| Spécifie le délai d'attente en secondes de la socket de connexion | |||
| LDAPLibraryDebug 7 | s | E | |
| Active le débogage dans le SDK LDAP | |||
| LDAPOpCacheEntries nombre | 1024 | s | E |
| Nombre d'entrées utilisées pour mettre en cache les opérations de comparaison LDAP | |||
| LDAPOpCacheTTL secondes | 600 | s | E |
| Durée pendant laquelle les entrées du cache d'opérations restent valides | |||
| LDAPReferralHopLimit nombre | dh | E | |
| Le nombre maximum de redirections vers des serveurs alternatifs (referrals) avant l'abandon de la requête LDAP. | |||
| LDAPReferrals On|Off|default | On | dh | E |
| Active la redirection vers des serveurs alternatifs au cours des requêtes vers le serveur LDAP. | |||
| LDAPRetries nombre d'essais | 3 | s | E |
| Définit le nombre maximum de tentatives de connexions au serveur LDAP. | |||
| LDAPRetryDelay secondes | 0 | s | E |
| Définit le temps d'attente avant un autre essai de connexion au serveur LDAP. | |||
| LDAPSharedCacheFile chemin/fichier | s | E | |
| Définit le fichier du cache en mémoire partagée | |||
| LDAPSharedCacheSize octets | 500000 | s | E |
| Taille en octets du cache en mémoire partagée | |||
| LDAPTimeout secondes | 60 | s | E |
| Spécifie le délai d'attente pour les opérations de recherche et d'identification LDAP en secondes | |||
| LDAPTrustedClientCert type chemin/nom-fichier/alias [mot de passe] | svdh | E | |
| Définit le nom de fichier contenant un certificat client ou un alias renvoyant vers un certificat client spécifique à une connexion. Tous les SDK LDAP ne supportent pas les certificats clients par connexion. | |||
| LDAPTrustedGlobalCert type chemin/nom-fichier [mot de passe] | s | E | |
| Définit le nom de fichier ou la base de données contenant les Autorités de Certification de confiance globales ou les certificats clients globaux | |||
| LDAPTrustedMode type | sv | E | |
| Spécifie le mode (SSL ou TLS) à utiliser lors de la connexion à un serveur LDAP. | |||
| LDAPVerifyServerCert On|Off | On | s | E |
| Force la vérification du certificat du serveur | |||
| <Limit méthode [méthode] ... > ... </Limit> | dh | C | |
| Limite les contrôles d'accès que la section contient à certaines méthodes HTTP | |||
| <LimitExcept méthode [méthode] ... > ... </LimitExcept> | dh | C | |
| Applique les contrôles d'accès à toutes les méthodes HTTP, sauf celles qui sont spécifiées | |||
| LimitInternalRecursion nombre [nombre] | 10 | sv | C |
| Détermine le nombre maximal de redirections internes et de sous-requêtes imbriquées | |||
| LimitRequestBody octets | 1073741824 | svdh | C |
| limite la taille maximale du corps de la requête HTTP envoyée par le client | |||
| LimitRequestFields nombre | 100 | sv | C |
| Limite le nombre de champs d'en-tête autorisés dans une requête HTTP | |||
| LimitRequestFieldSize octets | 8190 | sv | C |
| Dédinit la taille maximale autorisée d'un en-tête de requête HTTP | |||
| LimitRequestLine octets | 8190 | sv | C |
| Définit la taille maximale d'une ligne de requête HTTP | |||
| LimitXMLRequestBody octets | 1000000 | svdh | C |
| Définit la taille maximale du corps d'une requête au format XML | |||
| Listen [adresse IP:]numéro port [protocole] | s | M | |
| Les adresses IP et ports sur lesquels le serveur écoute | |||
| ListenBackLog backlog | 511 | s | M |
| Longueur maximale de la liste d'attente des connexions | |||
| ListenCoresBucketsRatio ratio | 0 (disabled) | s | M |
| Rapport entre le nombre de coeurs de processeur activés et le nombre de segments d'écoute | |||
| LoadFile nom-fichier [nom-fichier] ... | sv | E | |
| Liaison du fichier objet ou de la bibliothèque spécifié | |||
| LoadModule module nom-fichier | sv | E | |
| Liaison avec le serveur du fichier objet ou de la bibliothèque spécifié, et ajout de ce dernier à la liste des modules actifs | |||
| <Location chemin URL|URL> ... </Location> | sv | C | |
| N'applique les directives contenues qu'aux URLs spécifiées | |||
| <LocationMatch regex> ... </LocationMatch> | sv | C | |
| N'applique les directives contenues qu'aux URLs correspondant à une expression rationnelle | |||
| LogFormat format|alias [alias] | "%h %l %u %t \"%r\" + | sv | B |
| Décrit un format utilisable dans un fichier journal | |||
| LogIOTrackTTFB ON|OFF | OFF | svdh | E |
| Permet d'enregistrer le délai avant le premier octet (time to first byte - TTFB) | |||
| LogLevel [module:]niveau [module:niveau] ... | warn | svd | C |
| Contrôle la verbosité du journal des erreurs | |||
| LogMessage message [hook=hook] [expr=expression] | d | X | |
| Enregistre des messages personnalisés dans le journal des erreurs | |||
| LuaAuthzProvider provider_name /path/to/lua/script.lua function_name | s | E | |
Branche une fonction fournisseur d'autorisation dans mod_authz_core
| |||
| LuaCodeCache stat|forever|never | stat | svdh | E |
| Configure le cache de code compilé. | |||
| LuaHookAccessChecker /chemin/vers/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Fournit un point d'entrée pour la phase access_checker du traitement de la requête | |||
| LuaHookAuthChecker /chemin/vers/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Fournit un point d'entrée pour la phase auth_checker du traitement de la requête | |||
| LuaHookCheckUserID /chemin/vers/lua/script.lua hook_function_name [early|late] | svdh | E | |
| Fournit un point d'entrée pour la phase check_user_id du traitement de la requête | |||
| LuaHookFixups /chemin/vers/lua/script.lua hook_function_name | svdh | E | |
| Fournit un point d'entrée pour la phase de correction du traitement de la requête | |||
| LuaHookInsertFilter /chemin/vers/lua/script.lua hook_function_name | svdh | E | |
| Fournit un point d'entrée pour la phase insert_filter du traitement de la requête | |||
| LuaHookLog /path/to/lua/script.lua log_function_name | svdh | E | |
| Permet une insertion dans la phase de journalisation du traitement d'une requête | |||
| LuaHookMapToStorage /chemin/vers/lua/script.lua hook_function_name | svdh | E | |
| Fournit un point d'entrée pour la phase map_to_storage du traitement de la requête | |||
| LuaHookPreTranslate /path/to/lua/script.lua hook_function_name | svdh | E | |
| Fournit un point d'entrée pour la phase de pré-traduction du traitement d'une requête | |||
| LuaHookTranslateName /chemin/vers/lua/script.lua nom_fonction_hook [early|late] | sv | E | |
| Fournit un point d'entrée à la phase du nom de traduction du traitement de la requête | |||
| LuaHookTypeChecker /chemin/vers/lua/script.lua hook_function_name | svdh | E | |
| Fournit un point d'entrée pour la phase type_checker du traitement de la requête | |||
| LuaInherit none|parent-first|parent-last | parent-first | svdh | E |
| Contrôle la manière dont les sections de configuration parentes sont fusionnées dans les enfants | |||
| LuaInputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Fournit une fonction Lua pour le filtrage en entrée | |||
| LuaMapHandler modele-uri /chemin/vers/lua/script.lua [nom-fonction] | svdh | E | |
| Met en correspondance un chemin avec un gestionnaire lua | |||
| LuaOutputFilter filter_name /path/to/lua/script.lua function_name | s | E | |
| Fournit une fonction Lua pour le filtrage de contenu en sortie | |||
| LuaPackageCPath /chemin/vers/include/?.soa | svdh | E | |
| Ajoute un répertoire au package.cpath de lua | |||
| LuaPackagePath /chemin/vers/include/?.lua | svdh | E | |
| Ajoute un répertoire au package.path de lua | |||
| LuaQuickHandler /path/to/script.lua hook_function_name | svdh | E | |
| Fournit un point d'entrée pour la gestion rapide du traitement de la requête | |||
| LuaRoot /chemin/vers/un/répertoire | svdh | E | |
| Spécifie le chemin de base pour la résolution des chemins relatifs dans les directives de mod_lua | |||
| LuaScope once|request|conn|thread|server [min] [max] | once | svdh | E |
| Une valeur parmi once, request, conn, thread -- la valeur par défaut est once | |||
| <Macro nom [par1 .. parN]> ... </Macro> | svd | B | |
| Définition d'une macro dans un fichier de configuration | |||
| MaxConnectionsPerChild number | 0 | s | M |
| Limite le nombre de connexions qu'un processus enfant va traiter au cours de son fonctionnement | |||
| MaxKeepAliveRequests nombre | 100 | sv | C |
| Nombre de requêtes permises pour une connexion persistante | |||
| MaxMemFree KOctets | 2048 | s | M |
Quantité maximale de mémoire que l'allocateur principal est
autorisé à conserver sans appeler free() | |||
| MaxRangeOverlaps default | unlimited | none | nombre de chevauchements | 20 | svd | C |
Nombre de chevauchements de segments de données autorisé
(par exemple 100-200,150-300) avant le renvoi de la
ressource complète | |||
| MaxRangeReversals default | unlimited | none | nombre d'inversions | 20 | svd | C |
Nombre d'inversions d'ordre autorisé dans la spécification des
segments de données (par exemple 100-200,50-70) avant le renvoi de la
ressource complète | |||
| MaxRanges default | unlimited | none | nombre de segments | 200 | svd | C |
| Nombre de segments de données autorisé avant le renvoi de l'intégralité de la ressource | |||
| MaxRequestWorkers nombre | s | M | |
| Nombre maximum de connexions pouvant être traitées simultanément | |||
| MaxSpareServers nombre | 10 | s | M |
| Nombre maximum de processus serveurs enfants inactifs | |||
| MaxSpareThreads nombre | s | M | |
| Nombre maximum de threads inactifs | |||
| MaxThreads nombre | 2048 | s | M |
| Définit le nombre maximum de threads esclaves | |||
| MDActivationDelay duration | s | X | |
| Définit le délai d'activation des nouveaux certificats | |||
| MDBaseServer on|off | off | s | X |
| Définit si le serveur global peut être géré ou seulement les serveurs virtuels. | |||
| MDCAChallenges name [ name ... ] | tls-alpn-01 http-01 + | s | X |
| Type de négociation ACME utilisée pour prouver l'appartenance du domaine. | |||
| MDCertificateAgreement accepted | s | X | |
| Acceptation des conditions d'utilisation de l'autorité de certification. | |||
| MDCertificateAuthority url | letsencrypt | s | X |
| Les URLs du service ACME de l'autorité de certification. | |||
| MDCertificateCheck name url | s | X | |
| Définit le motif de nom et d’URL pour un nom de site de vérification de certificat. | |||
| MDCertificateFile path-to-pem-file | s | X | |
| Définit un fichier de certificat statique pour le domaine géré. | |||
| MDCertificateKeyFile path-to-file | s | X | |
| Définit une clé privée statique pour le certificat statique. | |||
| MDCertificateMonitor name url | crt.sh https://crt. + | s | X |
| L'URL d'un moniteur d'enregistrement de certificat. | |||
| MDCertificateProtocol protocol | ACME | s | X |
| Le protocole à utiliser avec l'autorité de certification. | |||
| MDCertificateStatus on|off | on | s | X |
| Extrait les informations publiques du certificat au format JSON. | |||
| MDChallengeDns01 path-to-command | s | X | |
| Définit la commande d'activation/désactivation des vérifications dns-01 | |||
| MDChallengeDns01Version 1|2 | 1 | s | X |
| Définit le type des arguments avec lesquels appeler MDChallengeDns01 | |||
| MDCheckInterval duration | 12h | s | X |
| Détermine la périodicité de la vérification des certificats | |||
| MDContactEmail address | s | X | |
| Adresse Email pour l'enregistrement du compte | |||
| MDDriveMode always|auto|manual | auto | s | X |
| Ancien nom de MDRenewMode. | |||
| MDExternalAccountBinding key-id hmac-64 | none | file | none | s | X |
| Définit les valeurs keyid et hmac de liaison avec les comptes externes à utiliser dans les CA | |||
| MDHttpProxy url | s | X | |
| Spécifie un serveur mandataire pour les connexions sortantes. | |||
| MDMatchNames all|servernames | all | s | X |
| Définit comment les noms DNS sont comparés aux vhosts | |||
| MDMember hostname | s | X | |
| Nom d'hôte additionnel pour le domaine géré. | |||
| MDMembers auto|manual | auto | s | X |
| Définit si les alias de noms de domaines sont automatiquement ajoutés. | |||
| MDMessageCmd path-to-cmd optional-args | s | X | |
| Gère les évènements pour les domaines gérés | |||
| MDMustStaple on|off | off | s | X |
| Définit si les nouveaux certificats doivent avoir le drapeau OCSP Must Staple activé. | |||
| MDNotifyCmd path [ args ] | s | X | |
| Lance un programme lorsqu'un domaine géré est opérationnel. | |||
| MDomain dns-name [ other-dns-name... ] [auto|manual] | s | X | |
| Définit une liste de noms de domaines qui appartiennent à un groupe. | |||
| <MDomainSet dns-name [ other-dns-name... ]>...</MDomainSet> | s | X | |
| Conteneur de directives à appliquer à un ou plusieurs domaines gérés. | |||
| MDPortMap map1 [ map2 ] | http:80 https:443 | s | X |
| Mappage des ports externes avec les ports internes pour vérifier à qui appartient le domaine. | |||
| MDPrivateKeys type [ params... ] | RSA 2048 | s | X |
| Définit le type et la taille des clés privées générées. | |||
| MDProfile name | s | X | |
| Utiliser un profile ACME spécifique depuis le CA | |||
| MDProfileMandatory on|off | off | s | X |
| Contrôler si un MDProfile est obligatoire. | |||
| MDRenewMode always|auto|manual | auto | s | X |
| Contrôle le renouvellement des certificats. | |||
| MDRenewWindow duration | 33% | s | X |
| Définit le moment auquel un certificat doit être renouvelé. | |||
| MDRequireHttps off|temporary|permanent | off | s | X |
| Redirige le trafic http: vers https: pour les domaines gérés. | |||
| MDRetryDelay duration | 5s | s | X |
| Temps d'attente avant de réessayer, doublé à chaque erreur consécutive | |||
| MDRetryFailover number | 13 | s | X |
| Le nombre d'erreurs avant de se tourner vers un autre CA | |||
| MDServerStatus on|off | on | s | X |
| Définit si les informations à propos des domaines gérés sont ajoutés ou non à server-status. | |||
| MDStapleOthers on|off | on | s | X |
| Active l'agrafage pour les certificats non gérés par mod_md. | |||
| MDStapling on|off | off | s | X |
| Active l'agrafage pour un ou plusieurs domaines. | |||
| MDStaplingKeepResponse duration | 7d | s | X |
| Contrôle la durée au bout de laquelle les anciennes réponses doivent être supprimées. | |||
| MDStaplingRenewWindow duration | 33% | s | X |
| Contrôle l'ancienneté des réponses OCSP au dela de laquelle ces dernières seront renouvelées. | |||
| MDStoreDir path | md | s | X |
| Chemin dans le système de fichiers local du répertoire où seront stockées les données à propos des domaines gérés. | |||
| MDStoreLocks on|off|duration | off | s | X |
| Configure le verrouillage du magasin pour les mises à jour | |||
| MDWarnWindow duration | 10% | s | X |
| Définit la fenêtre de temps pendant laquelle vous serez informé de l'expiration prochaine d'un certificat. | |||
| MemcacheConnTTL num[units] | 15s | sv | E |
| Durée de conservation des connexions inactives | |||
| MergeSlashes ON|OFF | ON | sv | C |
| Fusion des slashes consécutifs dans les URLs par le serveur. | |||
| MergeTrailers [on|off] | off | sv | C |
| Détermine si les données supplémentaires (trailers) sont fusionnées avec les en-têtes | |||
| MetaDir répertoire | .web | svdh | E |
| Le nom du répertoire où trouver les fichiers de métainformations dans le style du CERN | |||
| MetaFiles on|off | off | svdh | E |
| Active le traitement des métafichiers du CERN | |||
| MetaSuffix suffixe | .meta | svdh | E |
| Suffixe du fichier contenant les métainformations dans le style du CERN | |||
| MimeMagicFile chemin-fichier | sv | E | |
| Active la détermination du type MIME en se basant sur le contenu du fichier et en utilisant le fichier magique spécifié | |||
| MinSpareServers nombre | 5 | s | M |
| Nombre minimum de processus serveurs enfants inactifs | |||
| MinSpareThreads nombre | s | M | |
| Nombre minimum de threads inactifs qui seront disponibles pour pouvoir traiter les pics de requêtes | |||
| MMapFile chemin fichier [chemin fichier] ... | s | X | |
| Charge au démarrage une liste de fichiers en mémoire | |||
| ModemStandard V.21|V.26bis|V.32|V.34|V.92 | d | X | |
| Standard de modem à simuler | |||
| ModMimeUsePathInfo On|Off | Off | d | B |
Indique à mod_mime de traiter les éléments
de path_info en tant que parties du nom de
fichier | |||
| MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers [Handlers|Filters] | NegotiatedOnly | svdh | B |
| Les types de fichiers qui seront inclus lors d'une recherche de correspondance de fichier avec les vues multiples (MultiViews) | |||
| Mutex mécanisme [default|nom-mutex] ... [OmitPID] | default | s | C |
| Définit les mécanismes de mutex et le repertoire du fichier verrou pour tous les mutex ou seulement les mutex spécifiés | |||
| NameVirtualHost adresse[:port] | s | C | |
| OBSOLETE : Définit une adresse IP pour les serveurs virtuels à base de nom | |||
| NoProxy domaine [domaine] ... | sv | E | |
| Serveurs, domaines ou réseaux auquels on se connectera directement | |||
| NWSSLTrustedCerts nom-fichier [nom-fichier] ... | s | B | |
| Liste de certificats clients supplémentaires | |||
| NWSSLUpgradeable [adresse-IP:]num-port | s | B | |
| Permet de promouvoir une connexion non SSL au statut de connexion SSL à la demande | |||
| Options [+|-]option [[+|-]option] ... | FollowSymlinks | svdh | C |
| Définit les fonctionnalités disponibles pour un répertoire particulier | |||
| Order ordre | Deny,Allow | dh | E |
Définit le statut d'accès par défaut et l'ordre dans lequel
les directives Allow et
Deny sont évaluées. | |||
| OutputSed commande-sed | dh | ||
| Commande sed pour le filtrage des contenus de type réponse | |||
| PassEnv var-env [var-env] ... | svdh | B | |
| Transmet des variables d'environnement depuis le shell | |||
| PidFile nom fichier | logs/httpd.pid | s | M |
| Ficher dans lequel le serveur enregistre l'identificateur de processus du démon | |||
| PrivilegesMode FAST|SECURE|SELECTIVE | FAST | svd | X |
| Fait un compromis entre d'une part l'efficacité et la vitesse de traitement et d'autre part la sécurité à l'encontre des codes malicieux supportant les privilèges. | |||
| Protocol protocole | sv | C | |
| Protocole pour une socket d'écoute | |||
| ProtocolEcho On|Off | Off | sv | X |
| Active ou désactive le serveur d'écho | |||
| Protocols protocole ... | http/1.1 | sv | C |
| Protocoles disponibles pour un serveur virtuel ou non | |||
| ProtocolsHonorOrder On|Off | On | sv | C |
| Détermine qui du client ou du serveur détermine l'ordre des protocoles au cours de la négociation de la connexion | |||
| <Proxy url-avec-jokers> ...</Proxy> | sv | E | |
| Conteneur de directives s'appliquant à des ressources mandatées | |||
| Proxy100Continue Off|On | On | svd | E |
| Transmission du message "100-continue" au serveur d'origine | |||
| ProxyAddHeaders Off|On | On | svd | E |
| Ajoute des informations à propos du mandataire aux en-têtes X-Forwarded-* | |||
| ProxyBadHeader IsError|Ignore|StartBody | IsError | sv | E |
| Détermine la manière de traiter les lignes d'en-tête incorrectes d'une réponse | |||
| ProxyBlock *|terme|serveur|domaine [terme|serveur|domaine] ... | sv | E | |
| Termes, serveurs ou domaines bloqués par le mandataire | |||
| ProxyDomain Domaine | sv | E | |
| Nom de domaine par défaut pour les requêtes mandatées | |||
| ProxyErrorOverride Off|On [code ...] | Off | svd | E |
| Outrepasser les pages d'erreur pour les contenus mandatés | |||
| ProxyExpressDBMFile pathname | sv | E | |
| Chemin du fichier DBM. | |||
| ProxyExpressDBMType type | default | sv | E |
| Type de fichier DBM. | |||
| ProxyExpressEnable on|off | off | sv | E |
| Active la fonctionnalité du module. | |||
| ProxyFCGIBackendType FPM|GENERIC | FPM | svdh | E |
| Spécifie le type de l'application FastCGI d'arrière-plan | |||
| ProxyFCGISetEnvIf conditional-expression [!]environment-variable-name [value-expression] | svdh | E | |
| Permet d'adapter la valeur des variables envoyées aux serveurs FastCGI | |||
| ProxyFtpDirCharset character_set | ISO-8859-1 | svd | E |
| Définit le jeu de caractères des listings FTP mandatés | |||
| ProxyFtpEscapeWildcards on|off | on | svd | E |
| Les caractères génériques dans les noms de fichiers doivent-ils être échappés lorsqu'ils sont envoyés au serveur FTP ? | |||
| ProxyFtpListOnWildcard on|off | on | svd | E |
| Les caractères génériques dans les noms de fichiers demandés doivent-ils déclencher l'affichage d'un listing ? | |||
| ProxyHCExpr name {ap_expr expression} | sv | E | |
| Crée et nomme une expression conditionnelle à utiliser pour déterminer la santé d'un serveur d'arrière-plan en fonction de sa valeur | |||
| ProxyHCTemplate name parameter=setting [...] | sv | E | |
| Crée et nomme un modèle permettant de définir différents paramètres de check up | |||
| ProxyHCTPsize size | 16 | s | E |
| Définit la taille totale, pour l'ensemble du serveur, du jeu de threads utilisé pour le check up des équipiers | |||
| ProxyHTMLBufSize nb-octets | 8192 | svd | B |
| Définit l'incrément de la taille du tampon, ainsi que sa taille initiale, pour la mise en tampon des scripts en ligne et des feuilles de style. | |||
| ProxyHTMLCharsetOut jeu-de-caractères | * | svd | B | |
| Spécifie un jeu de caractères pour la sortie de mod_proxy_html. | |||
| ProxyHTMLDocType HTML|XHTML [Legacy] OR ProxyHTMLDocType fpi [SGML|XML] | svd | B | |
| Définit une déclaration de type de document HTML ou XHTML. | |||
| ProxyHTMLEnable On|Off | Off | svd | B |
| Permet d'activer/désactiver le filtre proxy_html. | |||
| ProxyHTMLEvents attribut [attribut ...] | svd | B | |
| Spécifie les attributs à traiter comme des évènements de type scripting. | |||
| ProxyHTMLExtended On|Off | Off | svd | B |
| Détermine si l'on doit corriger les liens dans les scripts en ligne, les feuilles de style et les évènements de type scripting. | |||
| ProxyHTMLFixups [lowercase] [dospath] [reset] | svd | B | |
| Corrige les erreurs HTML simples. | |||
| ProxyHTMLInterp On|Off | Off | svd | B |
Active la réinterprétation des règles
ProxyHTMLURLMap pour chaque requête. | |||
| ProxyHTMLLinks élément attribut [attribut2 ...] | svd | B | |
| Spécifie les éléments HTML dont les attributs d'URL doivent être réécrits. | |||
| ProxyHTMLMeta On|Off | Off | svd | B |
Active ou désactive une préinterprétation supplémentaire
des métadonnées dans les sections HTML <head>. | |||
| ProxyHTMLStripComments On|Off | Off | svd | B |
| Détermine si les commentaires HTML doivent être supprimés. | |||
| ProxyHTMLURLMap modèle-source modèle-cible [drapeaux] [cond] | svd | B | |
| Définit une règle de réécriture des liens HTML | |||
| ProxyIOBufferSize octets | 8192 | sv | E |
| Détermine la taille du tampon interne de transfert de données | |||
| <ProxyMatch regex> ...</ProxyMatch> | sv | E | |
| Conteneur de directives s'appliquant à des ressources mandatées correspondant à une expression rationnelle | |||
| ProxyMaxForwards nombre | -1 | sv | E |
| Nombre maximum de mandataires à travers lesquelles une requête peut être redirigée | |||
| ProxyPass [chemin] !|url [clé=valeur [clé=valeur ...]] [nocanon] [interpolate] [noquery] | svd | E | |
| Référencer des serveurs distants depuis l'espace d'URLs du serveur local | |||
| ProxyPassInherit On|Off | On | sv | E |
| Héritage des directives ProxyPass définies au niveau du serveur principal | |||
| ProxyPassInterpolateEnv On|Off | Off | svd | E |
| Active l'interpolation des variables d'environnement dans les configurations de mandataires inverses | |||
| ProxyPassMatch [regex] !|url [key=value [key=value ...]] | svd | E | |
| Fait correspondre des serveurs distants dans l'espace d'URL du serveur local en utilisant des expressions rationnelles | |||
| ProxyPassReverse [chemin] url [interpolate] | svd | E | |
| Ajuste l'URL dans les en-têtes de la réponse HTTP envoyée par un serveur mandaté en inverse | |||
| ProxyPassReverseCookieDomain domaine-interne domaine-public [interpolate] | svd | E | |
| Ajuste la chaîne correspondant au domaine dans les en-têtes Set-Cookie en provenance d'un serveur mandaté | |||
| ProxyPassReverseCookiePath chemin-interne chemin-public [interpolate] | svd | E | |
| Ajuste la chaîne correspondant au chemin dans les en-têtes Set-Cookie en provenance d'un serveur mandaté | |||
| ProxyPreserveHost On|Off | Off | svd | E |
| Utilise l'en-tête de requête entrante Host pour la requête du mandataire | |||
| ProxyReceiveBufferSize octets | 0 | sv | E |
| Taille du tampon réseau pour les connexions mandatées HTTP et FTP | |||
| ProxyRemote match remote-server [username:password] | sv | E | |
| Mandataire distant à utiliser pour traiter certaines requêtes | |||
| ProxyRemoteMatch regex remote-server [username:password] | sv | E | |
| Le mandataire distant à utiliser pour traiter les requêtes correspondant à une expression rationnelle | |||
| ProxyRequests On|Off | Off | sv | E |
| Active la fonctionnalité (standard) de mandataire direct | |||
| ProxySCGIInternalRedirect On|Off|Headername | On | svd | E |
| Active ou désactive les réponses de redirection interne en provenance du serveur cible. | |||
| ProxySCGISendfile On|Off|nom-en-tête | Off | svd | E |
| Active l'évaluation du pseudo en-tête de réponse X-Sendfile | |||
| ProxySet url clé=valeur [clé=valeur ...] | svd | E | |
| Définit différents paramètres relatifs à la répartition de charge des mandataires et aux membres des groupes de répartition de charge | |||
| ProxySourceAddress adresse | sv | E | |
| Définit l'adresse IP locale pour les connexions mandatées sortantes | |||
| ProxyStatus Off|On|Full | Off | sv | E |
| Affiche l'état du répartiteur de charge du mandataire dans mod_status | |||
| ProxyTimeout secondes | sv | E | |
| Délai d'attente réseau pour les requêtes mandatées | |||
| ProxyVia On|Off|Full|Block | Off | sv | E |
Information fournie dans l'en-tête de réponse HTTP
Via pour les requêtes mandatées | |||
| ProxyWebsocketFallbackToProxyHttp On|Off | On | sv | E |
Demande à ce module de laisser mod_proxy_http
gérer la requête | |||
| QualifyRedirectURL On|Off | Off | svd | C |
| Vérifie si la variable d'environnement REDIRECT_URL est pleinement qualifiée | |||
| ReadBufferSize bytes | 8192 | svd | C |
| Taille des tampons utilisés pour lire les données | |||
| ReadmeName nom-fichier | svdh | B | |
| Nom du fichier dont le contenu sera inséré à la fin de l'index | |||
| ReceiveBufferSize octets | 0 | s | M |
| Taille du tampon TCP en entrée | |||
| Redirect [état] [URL-path] URL | svdh | B | |
| Envoie une redirection externe demandant au client d'effectuer une autre requête avec une URL différente | |||
| RedirectMatch [état] regex URL | svdh | B | |
| Envoie une redirection externe faisant appel aux expressions rationnelles pour la mise en correspondance de l'URL courante | |||
| RedirectPermanent chemin URL URL | svdh | B | |
| Envoie une redirection externe permanente demandant au client d'effectuer une nouvelle requête avec une URL différente | |||
| RedirectRelative On|Off | Off | svd | B |
| Redirection relative de cibles. | |||
| RedirectTemp chemin URL URL | svdh | B | |
| Envoie une redirection externe temporaire demandant au client d'effectuer une nouvelle requête avec une URL différente | |||
| RedisConnPoolTTL num[units] | 15s | sv | E |
| Durée de vie du jeu de connexions avec le(s) serveur(s) Redis. | |||
| RedisTimeout num[units] | 5s | sv | E |
| Durée maximale de lecture/écriture sur la connexion avec le(s) serveur(s) Redis. | |||
| ReflectorHeader en-tête-entrée [en-tête-sortie] | svdh | B | |
| Renvoie un en-tête d'entrée dans les en-têtes de sortie | |||
| RegexDefaultOptions [none] [+|-]option [[+|-]option] ... | DOTALL DOLLAR_ENDON + | s | C |
| Configuration des options globales par défaut pour les expressions rationnelles | |||
| RegisterHttpMethod méthode [méthode [...]] | s | C | |
| Enregistrement de méthodes HTTP non standards | |||
| RemoteIPHeader en-tête | sv | B | |
| Définit le champ d'en-tête qui contiendra les adresses IP du client | |||
| RemoteIPInternalProxy ip-mandataire|ip-mandataire/sous-réseau|nom-hôte ... | sv | B | |
| Déclare les adresses IP intranet clients comme dignes de confiance pour présenter la valeur RemoteIPHeader | |||
| RemoteIPInternalProxyList nom-fichier | sv | B | |
| Déclare les adresses IP intranet clients comme dignes de confiance pour présenter la valeur RemoteIPHeader | |||
| RemoteIPProxiesHeader Nom_en-tête | sv | B | |
| Déclare le champ d'en-tête qui contiendra toutes les adresses IP intermédiaires | |||
| RemoteIPProxyProtocol On|Off | sv | B | |
| Active ou désactive la gestion du protocole PROXY | |||
| RemoteIPProxyProtocolExceptions host|range [host|range] [host|range] | sv | B | |
| Désactive la prise en compte de l'en-tête PROXY pour certains hôtes ou réseaux | |||
| RemoteIPTrustedProxy ip-mandataire|ip-mandataire/sous-réseau|nom-hôte ... | sv | B | |
| Déclare les adresses IP clientes de l'intranet dignes de confiance pour présenter la valeur RemoteIPHeader | |||
| RemoteIPTrustedProxyList nom-fichier | sv | B | |
| Déclare les adresses IP intranet clients comme dignes de confiance pour présenter la valeur RemoteIPHeader | |||
| RemoveCharset extension [extension] ... | vdh | B | |
| Supprime toute association de jeu de caractères pour un ensemble d'extensions de noms de fichiers | |||
| RemoveEncoding extension [extension] ... | vdh | B | |
| Supprime toute association de codage de contenu pour un ensemble d'extensions de noms de fichiers | |||
| RemoveHandler extension [extension] ... | vdh | B | |
| Supprime toute association de gestionnaire à un ensemble d'extensions de noms de fichiers | |||
| RemoveInputFilter extension [extension] ... | vdh | B | |
| Supprime toute association de filtre en entrée à un ensemble d'extensions de noms de fichiers | |||
| RemoveLanguage extension [extension] ... | vdh | B | |
| Supprime toute association de langue à un ensemble d'extensions de noms de fichiers | |||
| RemoveOutputFilter extension [extension] ... | vdh | B | |
| Supprime toute association de filtre en sortie à un ensemble d'extensions de noms de fichiers | |||
| RemoveType extension [extension] ... | vdh | B | |
| Supprime toute association de type de contenu à un ensemble d'extensions de noms de fichiers | |||
| RequestHeader add|append|edit|edit*|merge|set|setifempty|unset en-tête [[expr=]valeur [remplacement] [early|env=[!]variable|expr=expression]] | svdh | E | |
| Configure les en-têtes d'une requête HTTP | |||
| RequestReadTimeout [handshake=timeout[-maxtimeout][,MinRate=rate] [header=timeout[-maxtimeout][,MinRate=MinRate] [body=timeout[-maxtimeout][,MinRate=MinRate] | handshake=0 header= + | sv | E |
| Définit des délais maximums pour la négociation TLS, la réception des en-têtes et/ou corps des requêtes en provenance du client. | |||
| Require [not] nom-entité [nom-entité] ... | dh | B | |
| Vérifie si un utilisateur authentifié a une autorisation d'accès accordée par un fournisseur d'autorisation. | |||
| <RequireAll> ... </RequireAll> | dh | B | |
| Regroupe plusieurs directives d'autorisation dont aucune ne doit échouer et dont au moins une doit retourner un résultat positif pour que la directive globale retourne elle-même un résultat positif. | |||
| <RequireAny> ... </RequireAny> | dh | B | |
| Regroupe des directives d'autorisation dont au moins une doit retourner un résultat positif pour que la directive globale retourne elle-même un résultat positif. | |||
| <RequireNone> ... </RequireNone> | dh | B | |
| Regroupe des directives d'autorisation dont aucune ne doit retourner un résultat positif pour que la directive globale n'échoue pas. | |||
| RewriteBase chemin_URL | dh | E | |
| Définit l'URL de base pour les réécritures au niveau répertoire | |||
| RewriteCond chaîne_de_test expression_de_comparaison [drapeaux] | svdh | E | |
| Définit une condition qui devra être satisfaite pour que la réécriture soit effectuée | |||
| RewriteEngine on|off | off | svdh | E |
| Active ou désactive l'exécution du moteur de réécriture | |||
| RewriteMap MapName MapType:MapSource [MapTypeOptions] | sv | E | |
| Définit une fonction de mise en correspondance pour la recherche de mots-clés | |||
| RewriteOptions Options | svdh | E | |
| Configure certaines options spéciales pour le moteur de réécriture | |||
| RewriteRule Modèle Substitution [drapeaux] | svdh | E | |
| Définit les règles pour le moteur de réécriture | |||
| RLimitCPU secondes|max [secondes|max] | svdh | C | |
| Limite le temps CPU alloué aux processus initiés par les processus enfants d'Apache httpd | |||
| RLimitMEM octets|max [octets|max] | svdh | C | |
| Limite la mémoire allouée aux processus initiés par les processus enfants d'Apache httpd | |||
| RLimitNPROC nombre|max [nombre|max] | svdh | C | |
| Limite le nombre de processus qui peuvent être initiés par les processus initiés par les processus enfants d'Apache httpd | |||
| Satisfy Any|All | All | dh | E |
| Interaction entre le contrôle d'accès en fonction de l'hôte et l'authentification utilisateur | |||
| ScoreBoardFile chemin fichier | logs/apache_runtime + | s | M |
| Chemin du fichier où sont stockées les données concernant la coordination des processus enfants | |||
| Script méthode script cgi | svd | B | |
| Active un script CGI dans le cas d'une méthode de requête particulière. | |||
| ScriptAlias [chemin URL] chemin fichier|chemin répertoire | svd | B | |
| Fait correspondre une URL à une zone du système de fichiers et désigne la cible comme script CGI | |||
| ScriptAliasMatch regex chemin fichier|chemin répertoire | sv | B | |
| Fait correspondre une URL à une zone du système de fichiers en faisant appel aux expressions rationnelles et en désignant la cible comme un script CGI | |||
| ScriptInterpreterSource Registry|Registry-Strict|Script | Script | svdh | C |
| Permet de localiser l'interpréteur des scripts CGI | |||
| ScriptLog chemin fichier | sv | B | |
| Chemin du fichier journal des erreurs du script CGI | |||
| ScriptLogBuffer octets | 1024 | sv | B |
| Taille maximale des requêtes PUT ou POST qui seront enregistrées dans le journal du script | |||
| ScriptLogLength octets | 10385760 | sv | B |
| Taille maximale du fichier journal des scripts CGI | |||
| ScriptSock chemin fichier | cgisock | s | B |
| Le préfixe du nom de fichier du socket à utiliser pour communiquer avec le démon CGI | |||
| SecureListen [adresse-IP:]num-port nom-certificat [MUTUAL] | s | B | |
| Active le chiffrement SSL pour le port spécifié | |||
| SeeRequestTail On|Off | Off | s | C |
| Détermine si mod_status affiche les 63 premiers caractères d'une requête ou les 63 derniers, en supposant que la requête elle-même possède plus de 63 caractères. | |||
| SendBufferSize octets | 0 | s | M |
| Taille du tampon TCP en sortie | |||
| ServerAdmin adresse électronique|URL | sv | C | |
| L'adresse électronique que le serveur inclut dans les messages d'erreur envoyés au client | |||
| ServerAlias nom serveur [nom serveur] ... | v | C | |
| Autres noms d'un serveur utilisables pour atteindre des serveurs virtuels à base de nom | |||
| ServerLimit nombre | s | M | |
| Limite supérieure de la définition du nombre de processus | |||
| ServerName [protocole://]nom-de-domaine|adresse-ip[:port] | sv | C | |
| Nom d'hôte et port que le serveur utilise pour s'authentifier lui-même | |||
| ServerPath chemin d'URL | v | C | |
| Nom de chemin d'URL hérité pour un serveur virtuel à base de nom accédé par un navigateur incompatible | |||
| ServerRoot chemin de répertoire | /usr/local/apache | s | C |
| Racine du répertoire d'installation du serveur | |||
| ServerSignature On|Off|EMail | Off | svdh | C |
| Définit un pied de page pour les documents générés par le serveur | |||
| ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full | Full | s | C |
Configure l'en-tête Server de la réponse
HTTP | |||
| Session On|Off | Off | svdh | E |
| Ouvre une session pour le contexte courant | |||
| SessionCookieName nom attributs | svdh | E | |
| Nom et attributs du cookie RFC2109 dans lequel la session est stockée | |||
| SessionCookieName2 nom attributs | svdh | E | |
| Nom et attributs pour le cookie RFC2965 dans lequel est stockée la session | |||
| SessionCookieRemove On|Off | Off | svdh | E |
| Détermine si les cookies de session doivent être supprimés des en-têtes HTTP entrants | |||
| SessionCryptoCipher algorithme | aes256 | svdh | X |
| L'algorithme à utiliser pour le chiffrement de la session | |||
| SessionCryptoDriver nom [param[=valeur]] | s | X | |
| Le pilote de chiffrement à utiliser pour chiffrer les sessions | |||
| SessionCryptoPassphrase secret [ secret ... ] | svdh | X | |
| La clé utilisée pour chiffrer la session | |||
| SessionCryptoPassphraseFile nom-fichier | svd | X | |
| Le fichier contenant les clés utilisées pour chiffrer la session | |||
| SessionDBDCookieName nom attributs | svdh | E | |
| Nom et attributs du cookie RFC2109 qui contient l'identifiant de session | |||
| SessionDBDCookieName2 nom attributs | svdh | E | |
| Nom et attributs du cookie RFC2965 qui contient l'identifiant de session | |||
| SessionDBDCookieRemove On|Off | On | svdh | E |
| Détermine si les cookies de session doivent être supprimés des en-têtes HTTP entrants | |||
| SessionDBDDeleteLabel étiquette | deletesession | svdh | E |
| La requête SQL à utiliser pour supprimer des sessions de la base de données | |||
| SessionDBDInsertLabel étiquette | insertsession | svdh | E |
| La requête SQL à utiliser pour insérer des sessions dans la base de données | |||
| SessionDBDPerUser On|Off | Off | svdh | E |
| Active une session propre à un utilisateur | |||
| SessionDBDSelectLabel étiquette | selectsession | svdh | E |
| La requête SQL à utiliser pour sélectionner des sessions dans la base de données | |||
| SessionDBDUpdateLabel étiquette | updatesession | svdh | E |
| La requête SQL à utiliser pour mettre à jour des sessions préexistantes dans la base de données | |||
| SessionEnv On|Off | Off | svdh | E |
| Définit si le contenu de la session doit être enregistré dans la variable d'environnement HTTP_SESSION | |||
| SessionExclude chemin | svdh | E | |
| Définit les préfixes d'URLs pour lesquels une session sera ignorée | |||
| SessionExpiryUpdateInterval interval | 0 (mise à jour syst + | svdh | E |
| Définit le nombre de secondes dont la durée d'expiration d'une session peut changer sans que cette session soit mise à jour | |||
| SessionHeader en-tête | svdh | E | |
| Importation des mises à jour de session depuis l'en-tête de réponse HTTP spécifié | |||
| SessionInclude chemin | svdh | E | |
| Définit les préfixes d'URL pour lesquels une session est valide | |||
| SessionMaxAge durée de vie maximale | 0 | svdh | E |
| Définit une durée de vie maximale pour la session en secondes | |||
| SetEnv var-env [valeur] | svdh | B | |
| Définit des variables d'environnement | |||
| SetEnvIf attribut regex [!]env-variable[=valeur] [[!]env-variable[=valeur]] ... | svdh | B | |
| Définit des variables d'environnement en fonction des attributs de la requête | |||
| SetEnvIfExpr expr [!]env-variable[=valeur] [[!]env-variable[=valeur]] ... | svdh | B | |
| Définit des variables d'environnement en fonction d'une expression ap_expr | |||
| SetEnvIfNoCase attribut regex [!]env-variable[=valeur] [[!]env-variable[=valeur]] ... | svdh | B | |
| Définit des variables d'environnement en fonction des attributs de la requête sans tenir compte de la casse | |||
| SetHandler handler-name|none|expression | svdh | C | |
| Force le traitement des fichiers spécifiés par un gestionnaire particulier | |||
| SetInputFilter filtre[;filtre...] | svdh | C | |
| Définit les filtres par lesquels vont passer les requêtes client et les données POST | |||
| SetOutputFilter filtre[;filtre...] | svdh | C | |
| Définit les filtres par lesquels vont passer les réponses du serveur | |||
| SSIEndTag tag | "-->" | sv | B |
| Chaîne qui termine l'élément include | |||
| SSIErrorMsg message | "[an error occurred + | svdh | B |
| Message d'erreur affiché lorsqu'une erreur SSI survient | |||
| SSIETag on|off | off | dh | B |
| Définit si des en-têtes ETags sont générés par le serveur. | |||
| SSILastModified on|off | off | dh | B |
Définit si des en-têtes Last-Modified sont
générés par le serveur. | |||
| SSILegacyExprParser on|off | off | dh | B |
| Active le mode de compatibilité pour les expressions conditionnelles. | |||
| SSIStartTag tag | "<!--#" | sv | B |
| Chaîne qui marque le début d'un élément include | |||
| SSITimeFormat chaîne de formatage | "%A, %d-%b-%Y %H:%M + | svdh | B |
| Configuration du format d'affichage des dates | |||
| SSIUndefinedEcho chaîne | "(none)" | svdh | B |
| Chaîne à afficher lorsqu'on tente d'extraire le contenu d'une variable non définie | |||
| SSLCACertificateFile file-path | sv | E | |
| Fichier contenant une concaténation des certificats de CA codés en PEM pour l'authentification des clients | |||
| SSLCACertificatePath chemin-répertoire | sv | E | |
| Répertoire des certificats de CA codés en PEM pour l'authentification des clients | |||
| SSLCADNRequestFile file-path | sv | E | |
| Fichier contenant la concaténation des certificats de CA codés en PEM pour la définition de noms de CA acceptables | |||
| SSLCADNRequestPath chemin-répertoire | sv | E | |
| Répertoire contenant des fichiers de certificats de CA codés en PEM pour la définition de noms de CA acceptables | |||
| SSLCARevocationCheck chain|leaf|none [flags ...] | none | sv | E |
| Active la vérification des révocations basée sur les CRL | |||
| SSLCARevocationFile file-path | sv | E | |
| Fichier contenant la concaténation des CRLs des CA codés en PEM pour l'authentification des clients | |||
| SSLCARevocationPath chemin-répertoire | sv | E | |
| Répertoire des CRLs de CA codés en PEM pour l'authentification des clients | |||
| SSLCertificateChainFile file-path | sv | E | |
| Fichier contenant les certificats de CA du serveur codés en PEM | |||
| SSLCertificateFile file-path|certid | sv | E | |
| Fichier de données contenant les informations de certificat X.509 du serveur codées au format PEM ou identificateur de jeton | |||
| SSLCertificateKeyFile file-path|keyid | sv | E | |
| Fichier contenant la clé privée du serveur codée en PEM | |||
| SSLCipherSuite [protocol] cipher-spec | DEFAULT (dépend de + | svdh | E |
| Algorithmes de chiffrement disponibles pour la négociation au cours de l'initialisation de la connexion SSL | |||
| SSLCompression on|off | off | sv | E |
| Permet d'activer la compression au niveau SSL | |||
| SSLCryptoDevice moteur | builtin | s | E |
| Active l'utilisation d'un accélérateur matériel de chiffrement | |||
| SSLEngine on|off|optional | off | sv | E |
| Interrupteur marche/arrêt du moteur SSL | |||
| SSLFIPS on|off | off | s | E |
| Coimmutateur du mode SSL FIPS | |||
| SSLHonorCipherOrder on|off | off | sv | E |
| Option permettant de classer les algorithmes de chiffrement du serveur par ordre de préférence | |||
| SSLInsecureRenegotiation on|off | off | sv | E |
| Option permettant d'activer le support de la renégociation non sécurisée | |||
| SSLOCSPDefaultResponder uri | sv | E | |
| Définit l'URI du répondeur par défaut pour la validation OCSP | |||
| SSLOCSPEnable on|leaf|off | off | sv | E |
| Active la validation OCSP de la chaîne de certificats du client | |||
| SSLOCSPNoverify on|off | off | sv | E |
| Evite la vérification des certificats des répondeurs OCSP | |||
| SSLOCSPOverrideResponder on|off | off | sv | E |
| Force l'utilisation de l'URI du répondeur par défaut pour la validation OCSP | |||
| SSLOCSPProxyURL url | sv | E | |
| Adresse de mandataire à utiliser pour les requêtes OCSP | |||
| SSLOCSPResponderCertificateFile file | sv | E | |
| Fournit un jeu de certificats de confiance du répondeur OCSP avec encodage PEM | |||
| SSLOCSPResponderTimeout secondes | 10 | sv | E |
| Délai d'attente pour les requêtes OCSP | |||
| SSLOCSPResponseMaxAge secondes | -1 | sv | E |
| Age maximum autorisé pour les réponses OCSP | |||
| SSLOCSPResponseTimeSkew secondes | 300 | sv | E |
| Dérive temporelle maximale autorisée pour la validation des réponses OCSP | |||
| SSLOCSPUseRequestNonce on|off | on | sv | E |
| Use a nonce within OCSP queries | |||
| SSLOpenSSLConfCmd commande valeur | sv | E | |
| Configuration des paramètres d'OpenSSL via son API SSL_CONF | |||
| SSLOptions [+|-]option ... | svdh | E | |
| Configure différentes options d'exécution du moteur SSL | |||
| SSLPassPhraseDialog type | builtin | s | E |
| Méthode utilisée pour entrer le mot de passe pour les clés privées chiffrées | |||
| SSLProtocol [+|-]protocole ... | all -SSLv3 (jusqu'à + | sv | E |
| Indique les versions du protocole SSL/TLS disponibles | |||
| SSLProxyCACertificateFile file-path | svp | E | |
| Fichier contenant la concaténation des certificats de CA codés en PEM pour l'authentification des serveurs distants | |||
| SSLProxyCACertificatePath chemin-répertoire | svp | E | |
| Répertoire des certificats de CA codés en PEM pour l'authentification des serveurs distants | |||
| SSLProxyCARevocationCheck chain|leaf|none | none | svp | E |
| Active la vérification des révocations basée sur les CRLs pour l'authentification du serveur distant | |||
| SSLProxyCARevocationFile file-path | svp | E | |
| Fichier contenant la concaténation des CRLs de CA codés en PEM pour l'authentification des serveurs distants | |||
| SSLProxyCARevocationPath chemin-répertoire | svp | E | |
| Répertoire des CRLs de CA codés en PEM pour l'authentification des serveurs distants | |||
| SSLProxyCheckPeerCN on|off | on | svp | E |
| Configuration de la vérification du champ CN du certificat du serveur distant | |||
| SSLProxyCheckPeerExpire on|off | on | svp | E |
| Configuration de la vérification de l'expiration du certificat du serveur distant | |||
| SSLProxyCheckPeerName on|off | on | svp | E |
| Configure la vérification du nom d'hôte dans les certificats serveur distants | |||
| SSLProxyCipherSuite [protocol] cipher-spec | ALL:!ADH:RC4+RSA:+H + | svp | E |
| Algorithmes de chiffrement disponibles pour la négociation lors de l'initialisation d'une connexion SSL de mandataire | |||
| SSLProxyEngine on|off | off | svp | E |
| Interrupteur marche/arrêt du moteur de mandataire SSL | |||
| SSLProxyMachineCertificateChainFile nom-fichier | svp | E | |
| Fichier de certificats de CA encodés PEM concaténés permettant au mandataire de choisir un certificat | |||
| SSLProxyMachineCertificateFile chemin-fichier | svp | E | |
| Fichier contenant la concaténation des clés et certificats clients codés en PEM que le mandataire doit utiliser | |||
| SSLProxyMachineCertificatePath chemin-répertoire | svp | E | |
| Répertoire des clés et certificats clients codés en PEM que le mandataire doit utiliser | |||
| SSLProxyProtocol [+|-]protocole ... | all -SSLv3 (jusqu'à + | svp | E |
| Définit les protocoles SSL disponibles pour la fonction de mandataire | |||
| SSLProxyVerify niveau | none | svp | E |
| Niveau de vérification du certificat du serveur distant | |||
| SSLProxyVerifyDepth niveau | 1 | svp | E |
| Niveau de profondeur maximum dans les certificats de CA lors de la vérification du certificat du serveur distant | |||
| SSLRandomSeed contexte source [nombre] | s | E | |
| Source de déclenchement du Générateur de Nombres Pseudo-Aléatoires (PRNG) | |||
| SSLRenegBufferSize taille | 131072 | dh | E |
| Définit la taille du tampon de renégociation SSL | |||
| SSLRequire expression | dh | E | |
| N'autorise l'accès que lorsqu'une expression booléenne complexe et arbitraire est vraie | |||
| SSLRequireSSL | dh | E | |
| Interdit l'accès lorsque la requête HTTP n'utilise pas SSL | |||
| SSLSessionCache type | none | s | E |
| Type du cache de session SSL global et inter-processus | |||
| SSLSessionCacheTimeout secondes | 300 | sv | E |
| Nombre de secondes avant l'expiration d'une session SSL dans le cache de sessions | |||
| SSLSessionTicketKeyFile file-path | sv | E | |
| Clé de chiffrement/déchiffrement permanente pour les tickets de session TLS | |||
| SSLSessionTickets on|off | on | sv | E |
| Active ou désactive les tickets de session TLS | |||
| SSLSRPUnknownUserSeed secret-string | sv | E | |
| Source d'aléa pour utilisateur SRP inconnu | |||
| SSLSRPVerifierFile file-path | sv | E | |
| Chemin du fichier de vérification SRP | |||
| SSLStaplingCache type | s | E | |
| Configuration du cache pour l'agrafage OCSP | |||
| SSLStaplingErrorCacheTimeout secondes | 600 | sv | E |
| Durée de vie des réponses invalides dans le cache pour agrafage OCSP | |||
| SSLStaplingFakeTryLater on|off | on | sv | E |
| Génère une réponse "tryLater" pour les requêtes OCSP échouées | |||
| SSLStaplingForceURL uri | sv | E | |
| Remplace l'URI du serveur OCSP spécifié dans l'extension AIA du certificat | |||
| SSLStaplingResponderTimeout secondes | 10 | sv | E |
| Temps d'attente maximum pour les requêtes vers les serveurs OCSP | |||
| SSLStaplingResponseMaxAge secondes | -1 | sv | E |
| Age maximum autorisé des réponses OCSP incluses dans la négociation TLS | |||
| SSLStaplingResponseTimeSkew secondes | 300 | sv | E |
| Durée de vie maximale autorisée des réponses OCSP incluses dans la négociation TLS | |||
| SSLStaplingReturnResponderErrors on|off | on | sv | E |
| Transmet au client les erreurs survenues lors des requêtes OCSP | |||
| SSLStaplingStandardCacheTimeout secondes | 3600 | sv | E |
| Durée de vie des réponses OCSP dans le cache | |||
| SSLStrictSNIVHostCheck on|off | off | sv | E |
| Contrôle de l'accès des clients non-SNI à un serveur virtuel à base de nom. | |||
| SSLUserName nom-var | sdh | E | |
| Nom de la variable servant à déterminer le nom de l'utilisateur | |||
| SSLUseStapling on|off | off | sv | E |
| Active l'ajout des réponses OCSP à la négociation TLS | |||
| SSLVerifyClient niveau | none | svdh | E |
| Niveau de vérification du certificat client | |||
| SSLVerifyDepth nombre | 1 | svdh | E |
| Profondeur maximale des certificats de CA pour la vérification des certificats clients | |||
| StartServers nombre | s | M | |
| Nombre de processus enfants du serveur créés au démarrage | |||
| StartThreads nombre | s | M | |
| Nombre de threads créés au démarrage | |||
| StrictHostCheck ON|OFF | OFF | sv | C |
| Détermine si le nom d'hôte contenu dans une requête doit être explicitement spécifié au niveau du serveur virtuel qui a pris en compte cette dernière. | |||
| Substitute s/modèle/substitution/[infq] | dh | E | |
| Modèle de substition dans le contenu de la réponse | |||
| SubstituteInheritBefore on|off | on | dh | E |
| Modifie l'ordre de fusion des modèles hérités | |||
| SubstituteMaxLineLength octets(b|B|k|K|m|M|g|G) | 1m | dh | E |
| Définit la longueur de ligne maximale | |||
| Suexec On|Off | s | B | |
| Active ou désactive la fonctionnalité suEXEC | |||
| SuexecUserGroup Utilisateur Groupe | sv | E | |
| L'utilisateur et le groupe sous lesquels les programmes CGI doivent s'exécuter | |||
| ThreadLimit nombre | s | M | |
| Le nombre de threads maximum que l'on peut définir par processus enfant | |||
| ThreadsPerChild nombre | s | M | |
| Nombre de threads créés par chaque processus enfant | |||
| ThreadStackSize taille | s | M | |
| La taille en octets de la pile qu'utilisent les threads qui traitent les connexions clients | |||
| TimeOut secondes | 60 | sv | C |
| Temps pendant lequel le serveur va attendre certains évènements avant de considérer qu'une requête a échoué | |||
| TraceEnable [on|off|extended] | on | sv | C |
Détermine le comportement des requêtes
TRACE | |||
| TransferLog fichier|pipe | sv | B | |
| Spécifie l'emplacement d'un fichier journal | |||
| TypesConfig chemin-fichier | conf/mime.types | s | B |
Le chemin du fichier mime.types | |||
| UNCList hostname [hostname...] | s | C | |
| Définit quels sont les noms d’hôte UNC auxquels le serveur peut accéder | |||
| UnDefine nom-variable | s | C | |
| Invalide la définition d'une variable | |||
| UndefMacro nom | svd | B | |
| Supprime une macro | |||
| UnsetEnv var-env [var-env] ... | svdh | B | |
| Supprime des variables de l'environnement | |||
| Use nom [valeur1 ... valeurN] | svd | B | |
| Utilisation d'une macro | |||
| UseCanonicalName On|Off|DNS | Off | svd | C |
| Définit la manière dont le serveur détermine son propre nom et son port | |||
| UseCanonicalPhysicalPort On|Off | Off | svd | C |
| Définit la manière dont le serveur détermine son propre port | |||
| User utilisateur unix | #-1 | s | B |
| L'utilisateur sous lequel le serveur va traiter les requêtes | |||
| UserDir nom-répertoire [nom-répertoire] ... | sv | B | |
| Chemin des répertoires propres à un utilisateur | |||
| VHostCGIMode On|Off|Secure | On | v | X |
| Détermine si le serveur virtuel peut exécuter des sous-processus, et définit les privilèges disponibles pour ces dernier. | |||
| VHostCGIPrivs [+-]?privilege-name [[+-]?privilege-name] ... | v | X | |
| Assigne des privilèges au choix aux sous-processus créés par un serveur virtuel. | |||
| VHostGroup identifiant-groupe-unix | v | X | |
| Définit l'identifiant du groupe sous lequel s'exécute un serveur virtuel. | |||
| VHostPrivs [+-]?nom-privilège [[+-]?nom-privilège] ... | v | X | |
| Assigne des privilèges à un serveur virtuel. | |||
| VHostSecure On|Off | On | v | X |
| Détermine si le serveur s'exécute avec une sécurité avancée pour les serveurs virtuels. | |||
| VHostUser identifiant-utilisateur-unix | v | X | |
| Définit l'identifiant utilisateur sous lequel s'exécute un serveur virtuel. | |||
| VirtualDocumentRoot répertoire-interpolé|none | none | sv | E |
| Permet une configuration dynamique de la racine des documents d'un serveur virtuel donné | |||
| VirtualDocumentRootIP répertoire-interpolé|none | none | sv | E |
| Configuration dynamique de la racine des documents pour un serveur virtuel donné | |||
| <VirtualHost adresse IP[:port] [adresse IP[:port]] ...> ... </VirtualHost> | s | C | |
| Contient des directives qui ne s'appliquent qu'à un nom d'hôte spécifique ou à une adresse IP | |||
| VirtualScriptAlias répertoire-interpolé|none | none | sv | E |
| Configuration dynamique du répertoire des scripts CGI pour un serveur virtuel donné | |||
| VirtualScriptAliasIP répertoire-interpolé|none | none | sv | E |
| Configuration dynamique du répertoire des scripts CGI pour un serveur virtuel donné | |||
| WatchdogInterval time-interval[s] | 1 | s | B |
| Intervalle Watchdog en secondes | |||
| XBitHack on|off|full | off | svdh | B |
| Interprète les directives SSI dans les fichiers dont le bit d'exécution est positionné | |||
| xml2EncAlias jeu-de-caractères alias [alias ...] | s | B | |
| Définit des alias pour les valeurs d'encodage | |||
| xml2EncDefault nom | svdh | B | |
| Définit un encodage par défaut à utiliser lorsqu'aucune information ne peut être automatiquement détectée | |||
| xml2StartParse élément [élément ...] | svdh | B | |
| Indique à l'interpréteur à partir de quelle balise il doit commencer son traitement. | |||
Apache HTTP サーバ バージョン 2.4
| 説明: | CONNECT リクエストを扱う
mod_proxy 用の拡張 |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | proxy_connect_module |
| ソースファイル: | mod_proxy_connect.c |
本モジュールには mod_proxy が必要です。
CONNECT HTTP メソッドをサポートします。
このメソッドは主にプロキシに SSL リクエストを通す
(訳注: SSLトンネリング)に使われます。
CONNECT リクエストを扱えるようにするには
mod_proxy と mod_proxy_connect
をサーバに組み込む必要があります。
安全なサーバにするまでプロキシ機能は有効にしないでください。 オープンプロキシサーバはあなた自身のネットワークにとっても、 インターネット全体にとっても危険です。
| 説明: | Ports that are allowed to CONNECT through the
proxy |
|---|---|
| 構文: | AllowCONNECT port[-port]
[port[-port]] ... |
| デフォルト: | AllowCONNECT 443 563 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_proxy_connect |
| 互換性: | Moved from mod_proxy in Apache 2.3.5.
Port ranges available since Apache 2.3.7. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
Apache HTTP サーバ バージョン 2.4
| 説明: | mod_proxy で AJP
をサポートするためのモジュール |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | proxy_ajp_module |
| ソースファイル: | mod_proxy_ajp.c |
本モジュールには mod_proxy が必要です。
Apache JServ Protocol version 1.3 (以降 AJP13)
をサポートします。
AJP13 プロトコルを扱えるようにするには
mod_proxy と mod_proxy_ajp
をサーバに組み込む必要があります。
安全なサーバにするまでプロクシ機能は有効にしないでください。 オープンプロキシサーバはあなた自身のネットワークにとっても、 インターネット全体にとっても危険です。
このモジュールにディレクティブはありません。
AJP13 プロトコルはパケット指向です。
可読なプレーンテキスト形式ではなくバイナリ形式になったのは、
おそらくパフォーマンス上の理由によります。
ウェブサーバはサーブレットコンテナと TCP コネクションで通信します。
ソケット生成は重い処理なので、負荷を減らすために、サーブレットコンテナとの
TCP 接続を維持し、複数のリクエスト・レスポンス処理サイクルに対して一つの
コネクションを使いまわすようになっています。
あるリクエストにコネクションが割り当てられると、その処理サイクルが 完了するまで他のものに使われることはありません。 つまりコネクション上では、リクエストの同時処理は行われません。 このため、コネクション両端での実行するコードを簡潔にできる一方で、 同時に開くコネクションは多くなっています。
サーブレットコンテナへのコネクションを開いた後は、コネクションの状態は 次のどれかになります:
コネクションが特定のリクエストにアサインされると、基本的な情報 (例えば
HTTP ヘッダ等) が圧縮された形 (例えば通常の文字列は整数にエンコードされます)
で転送されます。詳細は下記の「リクエストパケットの構造」を参照してください。
リクエストにボディが存在 (content-length > 0) すれば、
基本的な情報の直後に別パケットで転送されます。
この時点でおそらく、サーブレットコンテナは処理を開始できるようになります。 ですので、次のメッセージをウェブサーバに戻して知らせられるようになります。
個々のメッセージはそれぞれ異なるデータパケット形式になっています。 後述の「レスポンスパケットの構造」を参照してください。
このプロトコルには XDR から受け継いだ部分が少しありますが、多くの点で 異なります (例えば 4 バイトアライメントでないことなど) 。
バイトオーダー: 個々のバイトのエンディアンがどうなっているかは、 私は詳しくないのですが、リトルエンディアンになっていると思います。 XDR 仕様でそうなっているのと、素晴らしいことに sys/socket ライブラリが (C で) そういう風にできているのでそうなのだと思いました。 ソケット呼び出しの内部についてより詳しい方がいらっしゃいましたら、 ご教授ください。
プロトコルには 4 つのデータタイプがあります: byte, boolean, integer, string です。
1 = true, 0 = false です。
(C のように) 非零を真として扱ってしまうと、ある場合は動くかもしれませんし、
動かないかもしれません。0 から 2^16 (32768) の範囲の数字。高次の 2 バイトが
先に格納されます。strlen と同様です。
これらの終端文字をスキップするために、あまり意味の無いインクリメント文
をたくさん書かないといけないのは、
Java の側から見ると少し紛らわしく感じられるかもしれません。
こうなった理由はおそらく、Servlet コンテナから返される文字列を読み出す時に、
効率よく C のコードを書けるようにする――サーブレットから返される
文字列は \0 文字で終端されているので、C のコードではわざわざコピーをせずに、
一つのバッファへのリファレンスを取り回すように書くことができる――
ためだと思われます。
'\0' 文字がない場合は、C では文字列の規則に合うようにコピーしなければ
いけなくなってしまいます。多くのコードでそうなっているのですが、パケットサイズの最大サイズは
8 * 1024 (8K) です。パケットの実際の長さはヘッダに
エンコードされて入っています。
サーバからコンテナに送出されるパケットは 0x1234 で始まります。
コンテナからサーバに送られるパケットは AB (ASCII コード A と
ASCII コード B) で始まります。この二バイトの後に、ペイロード長が (上記の形式で)
続きます。このため、ペイロード長の最大値は 2^16 にできるように思えますが、
実際にはコードでは最大値は 8K に設定されています。
| パケット形式 (Server->Container) | |||||
| Byte | 0 | 1 | 2 | 3 | 4...(n+3) |
| Contents | 0x12 | 0x34 | データ長 (n) | Data | |
| パケット形式 (Container->Server) | |||||
| Byte | 0 | 1 | 2 | 3 | 4...(n+3) |
| Contents | A | B | データ長 (n) | Data | |
ほとんどのパケットで、ペイロードの最初のバイトがメッセージの型をエンコード
しています。例外はサーバからコンテナに送られるリクエストボディパケットです
――これらは標準的なパケット形式 (0x1234 とパケット長)
ですが、その後に続くプレフィックスコードがありません。
ウェブサーバは次のメッセージをサーブレットコンテナに送出できます。
| コード | パケットの型 | 意味 |
| 2 | Forward Request | リクエスト処理サイクルを後続のデータとともに開始する。 |
| 7 | Shutdown | ウェブサーバがコンテナに、コンテナを終了するように伝える。 |
| 8 | Ping | ウェブサーバがコンテナに制御を受け持つように伝える (セキュアログインフェーズ) 。 |
| 10 | CPing | ウェブサーバがコンテナに CPong で即座に応答するように伝える。 |
| none | Data | サイズ (2 バイト) とそれに続くボディデータ。 |
基本的なセキュリティを確保するため、ホストされているマシンと同一の
マシンからのリクエストに対してのみ、コンテナは実際に Shutdown
を実行します。
最初の Data パケットは、Forward Request
の直後にウェブサーバから送られます。
サーブレットコンテナはウェブサーバに、次のタイプのメッセージを送ることが できます :
| コード | パケットの型 | 意味 |
| 3 | Send Body Chunk | サーブレットコンテナからウェブサーバに (そしておそらくそのままブラウザに)、ボディのチャンクを送る。 |
| 4 | Send Headers | サーブレットコンテナからウェブサーバに (そしておそらくそのままブラウザに) レスポンスヘッダを送る。 |
| 5 | End Response | レスポンス (つまりリクエスト処理サイクル) 終了の目印を送る。 |
| 6 | Get Body Chunk | まだ全て転送されていない場合、残っているリクエストのデータを受け取る。 |
| 9 | CPong 応答 | CPing リクエストに応答する。 |
上記メッセージは、それぞれ内部構造が異なっています。詳細は下記をご覧ください。
サーバからコンテナへ送られるメッセージが Forward Request 型の場合 :
AJP13_FORWARD_REQUEST :=
prefix_code (byte) 0x02 = JK_AJP13_FORWARD_REQUEST
method (byte)
protocol (string)
req_uri (string)
remote_addr (string)
remote_host (string)
server_name (string)
server_port (integer)
is_ssl (boolean)
num_headers (integer)
request_headers *(req_header_name req_header_value)
attributes *(attribut_name attribute_value)
request_terminator (byte) OxFFrequest_headers は次のような構造になっています :
req_header_name :=
sc_req_header_name | (string) [see below for how this is parsed]
sc_req_header_name := 0xA0xx (integer)
req_header_value := (string)属性 はオプションで、次のような構造をしています :
attribute_name := sc_a_name | (sc_a_req_attribute string) attribute_value := (string)
もっとも重要なヘッダは content-length だということに
注意してください。コンテナは次のパケットを探すかどうかを、
それを見て決めるからです。
リクエストについては全て、この値は 2 になります。他の Prefix コードの詳細は 上記をご覧ください。
HTTP メソッドは 1 バイトにエンコードされます :
| Command Name | Code |
| OPTIONS | 1 |
| GET | 2 |
| HEAD | 3 |
| POST | 4 |
| PUT | 5 |
| DELETE | 6 |
| TRACE | 7 |
| PROPFIND | 8 |
| PROPPATCH | 9 |
| MKCOL | 10 |
| COPY | 11 |
| MOVE | 12 |
| LOCK | 13 |
| UNLOCK | 14 |
| ACL | 15 |
| REPORT | 16 |
| VERSION-CONTROL | 17 |
| CHECKIN | 18 |
| CHECKOUT | 19 |
| UNCHECKOUT | 20 |
| SEARCH | 21 |
| MKWORKSPACE | 22 |
| UPDATE | 23 |
| LABEL | 24 |
| MERGE | 25 |
| BASELINE_CONTROL | 26 |
| MKACTIVITY | 27 |
今後の ajp13 バージョンでは、この一覧にない、今後追加されるメソッドを 送るかもしれません。
これらはまさに文字通りのものです。どれも必要で、リクエストの毎回につき 送られます。
request_headers の構造は次のようなものです :
まずヘッダの数 num_headers がエンコードされます。
次にヘッダ名 req_header_name / 値 req_header_value
の組が続きます。効率のため、一般的なヘッダは整数でエンコードして転送します。
ヘッダ名が基本ヘッダの一覧に無い場合は、通常通り (文字列として、長さ
プレフィックス付きで) 転送されます。一般的なヘッダ
sc_req_header_name の一覧とそのコードは次の通りです
(どれも大文字小文字を区別します) :
| 名前 | コードの値 | コード名 |
| accept | 0xA001 | SC_REQ_ACCEPT |
| accept-charset | 0xA002 | SC_REQ_ACCEPT_CHARSET |
| accept-encoding | 0xA003 | SC_REQ_ACCEPT_ENCODING |
| accept-language | 0xA004 | SC_REQ_ACCEPT_LANGUAGE |
| authorization | 0xA005 | SC_REQ_AUTHORIZATION |
| connection | 0xA006 | SC_REQ_CONNECTION |
| content-type | 0xA007 | SC_REQ_CONTENT_TYPE |
| content-length | 0xA008 | SC_REQ_CONTENT_LENGTH |
| cookie | 0xA009 | SC_REQ_COOKIE |
| cookie2 | 0xA00A | SC_REQ_COOKIE2 |
| host | 0xA00B | SC_REQ_HOST |
| pragma | 0xA00C | SC_REQ_PRAGMA |
| referer | 0xA00D | SC_REQ_REFERER |
| user-agent | 0xA00E | SC_REQ_USER_AGENT |
これを読み込む Java のコードでは、最初の 2 バイト整数を取り込み、
目印になるバイト '0xA0' であれば、ヘッダ名の配列の
インデックスを使います。先頭バイトが 0xA0 でない場合は、
先頭 2 バイトは文字列長を表す整数であると解釈し、読み込みはじめます。
ヘッダ名の長さは 0x9999 (==0xA000 -1) 以上にならないという
仮定の下に動いていて、少しあいまいですが合理的な挙動になっています。
content-length ヘッダはとても重要です。
存在していて非ゼロであれば、リクエストにはボディがある (例えば POST
リクエスト) と推測し、そのボディを取り込むために
直後のパケットを入力ストリームから読み込みはじめます。
? プレフィックスで始まる属性 (例 ?context)
は。省略可能です。それぞれ属性の型を示す 1 バイトのコードと、
値(文字列か整数)が続きます。
これらは順不同で送ることができます (C のコードは常に下の一覧順に
送るようですが) 。
オプションの属性のリストの最後には、特別な終了コードが送られます。
コードの一覧は :
| Information | Code Value | Type Of Value | Note |
| ?context | 0x01 | - | 未実装 |
| ?servlet_path | 0x02 | - | 未実装 |
| ?remote_user | 0x03 | String | |
| ?auth_type | 0x04 | String | |
| ?query_string | 0x05 | String | |
| ?jvm_route | 0x06 | String | |
| ?ssl_cert | 0x07 | String | |
| ?ssl_cipher | 0x08 | String | |
| ?ssl_session | 0x09 | String | |
| ?req_attribute | 0x0A | String | Name (the name of the attribute follows) |
| ?ssl_key_size | 0x0B | Integer | |
| are_done | 0xFF | - | request_terminator |
context と servlet_path は現在の C の
コードではセットされていません。また、ほとんどの Java のコードでも、
このフィールドで何が送られても無視されます (これらのコードの後に文字列が
送られると壊れるものもあります)。
これがバグなのか、単に未実装なのか、歴史的経緯で残っているコードなのか
分かりませんが、コネクションの両側ともで見当たりません。
remote_user と auth_type はおそらく
HTTP レベルの認証を参照していて、リモートユーザのユーザ名と認証に使用した
タイプ (例 Basic, Digest) についてやり取りします。
query_string, ssl_cert,
ssl_cipher, ssl_session
は HTTP と HTTPS の対応する部分を参照します。
jvm_route はスティッキーセッションのサポート――
ロードバランスしている複数のサーバ中の特定の Tomcat インスタンスと、
ユーザのセッションとを紐付ける機能――に使われます。
この基本属性一覧に無いものについては、req_attribute
コード 0x0A 経由で属性を何個でも送ることができます。
属性の名前と値の文字列の組を、それぞれこのコードの直後に送ります。
環境変数はこの方法で伝えられます。
最後に属性が全て送信された後に、属性の終端を示す 0xFF
が送出されます。この信号は属性の一覧の終わりを示すと同時に、リクエスト
パケットの終端をも示しています。
コンテナがサーバに送り返すことのできるメッセージ:
AJP13_SEND_BODY_CHUNK :=
prefix_code 3
chunk_length (integer)
chunk *(byte)
chunk_terminator (byte) Ox00
AJP13_SEND_HEADERS :=
prefix_code 4
http_status_code (integer)
http_status_msg (string)
num_headers (integer)
response_headers *(res_header_name header_value)
res_header_name :=
sc_res_header_name | (string) [see below for how this is parsed]
sc_res_header_name := 0xA0 (byte)
header_value := (string)
AJP13_END_RESPONSE :=
prefix_code 5
reuse (boolean)
AJP13_GET_BODY_CHUNK :=
prefix_code 6
requested_length (integer)チャンクは基本的にはバイナリデータで、ブラウザに直接送られます。
ステータスコードとメッセージが通常の HTTP の通信にはあります (例
200 と OK)。レスポンスヘッダ名は、
リクエストヘッダ名と同様の方法でエンコードされます。
コードと文字列の判別方法の詳細に関しては、上記の header_encoding
を参照してください。
一般的なヘッダのコードは :
| 名前 | コードの値 |
| Content-Type | 0xA001 |
| Content-Language | 0xA002 |
| Content-Length | 0xA003 |
| Date | 0xA004 |
| Last-Modified | 0xA005 |
| Location | 0xA006 |
| Set-Cookie | 0xA007 |
| Set-Cookie2 | 0xA008 |
| Servlet-Engine | 0xA009 |
| Status | 0xA00A |
| WWW-Authenticate | 0xA00B |
コードかヘッダ文字列の直後には、ヘッダの値がエンコードされます。
リクエスト処理サイクルの終了を知らせます。reuse フラグが真
(==1) の場合、現在使用している TCP コネクションは次の新しい
リクエストに使えるようになります。reuse が偽 (C のコードでは
1 以外の全て) の場合は、コネクションを閉じることになります。
(ボディのサイズが大きすぎて最初のパケットに収まらない場合や、
リクエストがチャンク転送された場合などには、) コンテナはリクエストからの
データ読み込み要求をします。サーバ側はそれに対して、最小
request_length 最大 (8186 (8 Kbytes - 6))
の範囲で、未転送で残っているリクエストボディの大きさのデータを
送り返します。
ボディにそれ以上データが残っていない場合 (つまりサーブレットが
ボディの最後を超えて読み込もうとした場合) 、サーバは
ペイロード長 0 の空パケット(0x12,0x34,0x00,0x00)
を送り返します。
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | HTTP istek gövdelerini işleme sokup kullanılabilir kılan süzgeçler |
|---|---|
| Durum: | Temel |
| Modül Betimleyici: | request_module |
| Kaynak Dosyası: | mod_request.c |
| Uyumluluk: | Apache 2.3 ve sonrasında mevcuttur. |
| Açıklama: | mod_include gibi süzgeçler tarafından kullanılma olasılığına karşı istek gövdesi iptal edilmek yerine belirtilen azami boyutta tutulur. |
|---|---|
| Sözdizimi: | KeptBodySize azami_bayt_sayısı |
| Öntanımlı: | KeptBodySize 0 |
| Bağlam: | dizin |
| Durum: | Temel |
| Modül: | mod_request |
Normal şartlar altında, durağan dosyaların öntanımlı eylemcileri gibi
istek eylemcileri gerek kalmadığında istek gövdesini iptal ederler. Sonuç
olarak, mod_include gibi süzgeçler, özgün istek (süzme işlemi
gerçekleştikten sonra artık gerekmediğinden istek gövdesini iptal eden)
bir POST isteği olsa bile, GET isteklerinin
yapılmasına sadece diğer URL’lerin alt istekler olarak içerilmesi
şartıyla izin verir.
Bu yönergede belirtilen değer sıfırdan büyük olduğunda, istek
eylemciler, istek gövdesini iptal etmek yerine süzgeçler tarafından
kullanılmak üzere belirtilen azami boyuta ayarlarlar. mod_include
süzgecinin kullanılması durumunda, bir durağan shtml dosyası için bir
POST isteği, ardından gelen isteklerin, önceki gibi
GET istekleri değil, POST istekleri olmasına
yol açacaktır.
Bu özellik, mod_include kullanılarak, karmaşık HTML
sayfalarının ve uygulamalarının küçük küçük bileşenlere bölünüp sonra da
sayfa yapısıyla birlikte sarmalanarak birleştirilmesini mümkün kılar.
Bileşenler, CGI programları veya betik dilleri biçiminde olabileceği
gibi, mod_proxy kullanarak başka bir sunucudaki URL
uzayına ters vekil URL’ler şeklinde bile olabilir.
Bilginize: İstekler tamamlanana kadar alınan istekler geçici RAM içinde biriktirilir. Sonuç olarak, bahsi geçen yükü karşılamak için yeterince RAM’in mevcut olması gerekir. Bu yönergeyi kullanmakla, istek gövdesini saklamaya yetecek olası en düşük değerle bile URL uzayınız için gereken yeri kısıtlamış olursunuz.
Eğer isteğin uzunluğu bu yönerge ile ayrılan azami uzunluğu aşarsa
sunucu yanıt olarak 413 Request Entity Too Large (413
İstenen Öğe Çok Büyük) hatasını döndürür.
İstek gövdesini iptal etmek yerine kendi amaçları doğrultusunda bunları
biriktiren mod_cgi gibi eylemciler bu yönergeyi dikkate
almazlar.
Apache HTTP Server Version 2.4
| : | û ݿ ȯ溯 Ѵ |
|---|---|
| : | Base |
| : | setenvif_module |
| ҽ: | mod_setenvif.c |
mod_setenvif û
ǥĿ شϴ η ȯ溯 Ѵ.
ٸ κ ൿ Ҷ ȯ溯 ִ.
Ͽ þ óѴ.
MSIE ƴ϶ mozilla netscape
ϴ Ʒ þ Բ ִ.
BrowserMatch ^Mozilla netscape
BrowserMatch MSIE !netscape
| : | HTTP User-Agent ȯ溯 Ѵ |
|---|---|
| : | BrowserMatch regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_setenvif |
BrowserMatch SetEnvIf þ Ư
, HTTP û User-Agent ȯ溯
Ѵ. :
BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot
߰ :
BrowserMatch ^Mozilla forms jpeg=yes browser=netscape
BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript
BrowserMatch MSIE !javascript
| : | ҹڸ ʰ User-Agent ȯ溯 Ѵ |
|---|---|
| : | BrowserMatchNoCase regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_setenvif |
BrowserMatchNoCase þ BrowserMatch þ
ǹ̻ . þ ҹڸ ʴ´.
:
BrowserMatchNoCase mac platform=macintosh
BrowserMatchNoCase win platform=windows
BrowserMatch
BrowserMatchNoCase þ
SetEnvIf
SetEnvIfNoCase
þ Ư . :
BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot
| : | û ȯ溯 Ѵ |
|---|---|
| : | SetEnvIf attribute
regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_setenvif |
SetEnvIf þ û
ȯ溯 Ѵ. ù° ƱԸƮ attribute
ϳ:
Host, User-Agent,
Referer, Accept-Language. ǥ
Ͽ û Ī ִ.Remote_Host - (ִٸ) ûϴ Ŭ̾Ʈ
ȣƮRemote_Addr - ûϴ Ŭ̾Ʈ IP ּServer_Addr - û IP ּ
(2.0.43 Ŀ)Request_Method - ̸
(GET, POST, )Request_Protocol - û ̸
( , "HTTP/0.9", "HTTP/1.1", .)Request_URI - HTTP û û ڿ
-- Ϲ URL ǹڿ Ŵ(scheme)
ȣƮ κSetEnvIf
þ þ ˻ ִ.
SetEnvIf[NoCase] þ ȯ溯
˻ ִ. ''̶ ( ) Ȥ
þ Ѵ. û ƴϰ ǥ
ƴ attribute ȯ溯 Ѵ.ι° ƱԸƮ (regex) Perl ȣȯ ǥ̴. ̴ POSIX.2 egrep ǥİ ϴ. regex attribute ϸ ƱԸƮ óѴ.
ƱԸƮ () ̴. ̴
varname, Ȥ!varname, Ȥvarname=valueù° ´ "1" Ѵ. ι° ´
̹ ǵ ϰ, °
value Ѵ. ġ 2.0.51
value ִ $1..$9
regex ȣģ ǥ üѴ.
SetEnvIf Request_URI "\.gif$" object_is_image=gif
SetEnvIf Request_URI "\.jpg$" object_is_image=jpg
SetEnvIf Request_URI "\.xbm$" object_is_image=xbm
:
SetEnvIf Referer www\.mydomain\.com intra_site_referral
:
SetEnvIf object_is_image xbm XBIT_PROCESSING=1
:
SetEnvIf ^TS* ^[a-z].* HAVE_TS
ó ̹ û ȯ溯
object_is_image Ѵ. °
www.mydomain.com Ʈ
intra_site_referral Ѵ.
û ̸ "TS" ϰ [a-z]
ϳ ϴ ִ ȯ溯
HAVE_TS Ѵ.
| : | Sets environment variables based on an ap_expr expression |
|---|---|
| : | |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Base |
| : | mod_setenvif |
Documentation not yet translated. Please see English version of document.
| : | ҹڸ ʰ û ȯ溯 Ѵ |
|---|---|
| : | SetEnvIfNoCase attribute regex
[!]env-variable[=value]
[[!]env-variable[=value]] ... |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | FileInfo |
| : | Base |
| : | mod_setenvif |
SetEnvIfNoCase ǹ̻ SetEnvIf þ ,
ҹڸ ʰ ǥ ã´. :
SetEnvIfNoCase Host Apache\.Org site=apache
HTTP û Host:
Apache.Org, apache.org ϸ
site ȯ溯 "apache" Ѵ.
Apache HTTP Server Version 2.4
| Beschreibung: | Dieses Modul ermöglicht die Ausführung von CGI-Skripten in Abhängigkeit von Medientypen und Anfragemethoden. |
|---|---|
| Status: | Basis |
| Modulbezeichner: | actions_module |
| Quelltext-Datei: | mod_actions.c |
Das Modul besitzt zwei Direktiven. Die Direktive Action erlaubt die Ausführung von
CGI-Skripten immer dann, wenn eine Anfrage zu einem bestimmten MIME-Type erfolgt. Die Direktive Script erlaubt die Ausführung von
CGI-Skripten abhängig von einer bestimmten Methode, die in der
Anfrage verwendet wird. Dies macht es deutlich einfacher, Skripte
auszuführen, die Dateien verarbeiten.
| Beschreibung: | Aktiviert ein CGI-Skript für einen bestimmten Handler oder Content-Type |
|---|---|
| Syntax: | Action Aktionsart CGI-Skript [virtual] |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis, .htaccess |
| AllowOverride: | FileInfo |
| Status: | Basis |
| Modul: | mod_actions |
| Kompatibilität: | Der Schalter virtual und die Übergabe des
Handlers wurden in Apache 2.1 eingeführt. |
Die Direktive fügt eine Aktion hinzu, welche das
CGI-Skript aktiviert, sobald die Aktionsart durch
eine Anfrage ausgelöst wird. CGI-Skript ist der URL-Pfad
zu einer Ressource, die unter Verwendung von ScriptAlias oder AddHandler als CGI-Skript gekennzeichnet
wurde. Die Aktionsart kann entweder ein Handler oder ein MIME-Type sein. Die URL und
den Dateipfad des angeforderten Dokuments in den
Standard-CGI-Umgebungsvariablen PATH_INFO und
PATH_TRANSLATED übergeben. Der für die jeweilige
Anfrage verwendete Handler wird in der Umgebungsvariablen
REDIRECT_HANDLER übergeben.
# Anfragen für Dateien eines bestimmten MIME-Types:
Action image/gif /cgi-bin/images.cgi
# Dateien einer bestimmten Dateiendung
AddHandler my-file-type .xyz
Action my-file-type /cgi-bin/program.cgi
Im ersten Beispiel werden Anfragen für Dateien mit dem MIME-Type
image/gif von dem angegebenen CGI-Skript
/cgi-bin/images.cgi bearbeitet.
Im zweiten Beispiel werden Anfragen für Dateien mit der Dateiendung
.xyz von dem angegebenen CGI-Skript
/cgi-bin/program.cgi bearbeitet.
Der optionale Schalter virtual deaktiviert die Prüfung
auf Existenz der angeforderten Datei. Dies ist beispielsweise
nützlich, wenn Sie die Direktive Action in
Verbindung mit virtuellen Adressräumen verwenden möchten.
<Location /news>
SetHandler news-handler
Action news-handler /cgi-bin/news.cgi virtual
</Location>
| Beschreibung: | Aktiviert ein CGI-Skript für eine bestimmte Anfragemethode. |
|---|---|
| Syntax: | Script Methode CGI-Skript |
| Kontext: | Serverkonfiguration, Virtual Host, Verzeichnis |
| Status: | Basis |
| Modul: | mod_actions |
Die Direktive fügt eine Aktion hinzu, welche das
CGI-Skript aktiviert, wenn eine Datei unter der Verwendung der
Methode Methode angefordert wird. CGI-Skript ist der
URL-Pfad zu einer Ressource, die unter Verwendung von ScriptAlias oder AddHandler als CGI-Skript gekennzeichnet
wurde. Die URL und der Dateipfad des angeforderten Dokuments werden in den
Standard-CGI-Umgebungsvariablen PATH_INFO und
PATH_TRANSLATED übergeben.
Script PUT und Script put zu vollkommen
unterschiedlichen Ergebnissen führen.
Beachten Sie, dass der Script-Befehl nur
Voreinstellungen für Aktionen definiert. Wird ein CGI-Skript
- oder eine andere Ressource, die in der Lage ist, die angeforderte
Methode intern zu bearbeiten - aufgerufen, so wird diese(s) verwendet.
Beachten Sie auch, dass Script mit der Methode
GET nur dann aufgerufen wird, wenn Query-Argumente vorhanden
sind (z.B. foo.html?hi). Andernfalls wird die Anfrage normal
bearbeitet.
# Für <ISINDEX>-ähnliches Suchen
Script GET /cgi-bin/search
# Ein CGI-PUT-Handler
Script PUT /~bob/put.cgi
Apache HTTP Server Version 2.4
| Beschreibung: | Implementiert einen im Voraus forkenden Webserver ohne Thread-Unterstützung |
|---|---|
| Status: | MPM |
| Modulbezeichner: | mpm_prefork_module |
| Quelltext-Datei: | prefork.c |
Dieses Multi-Processing-Modul (MPM) implementiert einen im Voraus forkenden Webserver ohne Thread-Unterstützung, der Anfragen auf ähnliche Weise behandelt wie der Apache 1.3. Es ist für Angebote geeignet, die aus Kompatibilitätsgründen mit nicht-Thread-sicheren Bibliotheken Threading vermeiden müssen. Es ist außerdem das geeignetste MPM, um jede Anfrage isoliert zu bearbeiten, so dass Probleme mit einem einzelnen Prozess keinen anderen beeinflussen.
Das MPM ist stark selbstregulierend, so dass es selten
notwendig ist, seine Konfigurationseinstellungen zu justieren. Das
Wichtigste ist, dass MaxClients
gross genug ist, so viele gleichzeitige Anfragen zu bedienen, wie Sie
erwarten, aber klein genug, um sicherzustellen, dass genug physischer
Arbeitsspeicher für alle Prozesse vorhanden ist.
CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareServers MinSpareServers PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers UserEin einzelner Steuerprozess ist für den Start von Kindprozessen verantwortlich, die auf Verbindungen warten und diese bedienen, sobald sie eintreffen. Der Apache versucht immer, mehrere freie oder unbeschäftigte Serverprozesse vorzuhalten, die zur Bedienung eingehender Anfragen bereit stehen. Auf diese Weise müssen Clients nicht darauf warten, dass neue Kindprozesse geforkt werden, bevor ihre Anfrage bearbeitet werden kann.
StartServers,
MinSpareServers,
MaxSpareServers und
MaxClients regulieren,
wie der Elternprozess Kindprozesse zur Bedienung von Anfragen erstellt.
Im Allgemeinen ist der Apache sehr selbstregulierend, so dass die meisten
Angebote die Voreinstellung dieser Direktiven nicht verändern
müssen. Systeme, die mehr als 256 gleichzeitige Anfragen bedienen
müssen, können MaxClients erhöhen, während
Systeme mit begrenztem Arbeitsspeicher möglicherweise
MaxClients heruntersetzen
müssen, um den Server vor Flatterverhalten (Arbeitsspeicherinhalte auf
Platte auslagern - und zurück) zu schützen. Weitere
Informationen zur Feinabstimmung der Prozesserstellung sind in den
Performance-Hinweisen zu
finden.
Währen der Elternprozess unter Unix normalerweise als
root gestartet wird, um sich an Port 80 binden zu können,
werden die Kindprozesse unter einem weniger privilegierten Benutzer
gestartet. Die Direktiven User
und Group werden dazu
verwendet, die Privilegien der Apache-Kindprozesse festzulegen. Die
Kindprozesse müssen in der Lage sein, alle Inhalte zu lesen, die
sie ausliefern sollen, sollten darüber hinaus jedoch so wenig wie
möglich Rechte besitzen.
MaxRequestsPerChild
bestimmt, wie häufig der Server Prozesse erneuert, indem er alte
beendet und neue startet.
| Beschreibung: | Maximale Anzahl der unbeschäftigten Kindprozesse des Servers |
|---|---|
| Syntax: | MaxSpareServers Anzahl |
| Voreinstellung: | MaxSpareServers 10 |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | prefork |
Die Direktive MaxSpareServers bestimmt das
gewünschte Maximum an unbeschäftigten
Kindprozessen des Servers. Ein unbeschäftiger Prozess ist einer, der
keine Anfrage bedient. Wenn mehr als MaxSpareServers
Prozesse unbeschäftigt sind, wird der Elternprozess die
überschüssigen Prozesse beenden.
Eine Feineinstellung dieses Parameters sollte nur bei sehr
beschäftigten Angeboten notwendig sein. Es ist nahezu immer eine
schlechte Idee, den Parameter auf einen hohen Wert zu setzen. Wenn Sie
versuchen, den Wert kleiner oder gleich MinSpareServers zu setzen, wird der Apache
ihn automatisch auf MinSpareServers + 1
korrigieren.
| Beschreibung: | Minimale Anzahl der unbeschäftigten Kindprozesse des Servers |
|---|---|
| Syntax: | MinSpareServers Anzahl |
| Voreinstellung: | MinSpareServers 5 |
| Kontext: | Serverkonfiguration |
| Status: | MPM |
| Modul: | prefork |
Die Direktive MinSpareServers bestimmt das
gewünschte Minimum der unbeschäftigten
Kindprozesse des Servers. Ein unbeschäftigter Prozess ist einer, der
keine Anfrage bedient. Wenn weniger als
MinSpareServers Prozesse unbeschäftigt sind,
dann erstellt der Elternprozess neue mit einer maximalen Rate von 1
pro Sekunde.
Die Feineinstellung des Parameters sollte nur bei sehr beschäftigten Angeboten notwendig sein. Es ist nahezu immer eine schlechte ide, den Parameter auf einen hohen Wert zu setzen.
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Ortam değişkenlerinin isteğin özelliklerine uygun olarak atanmasını sağlar |
|---|---|
| Durum: | Temel |
| Modül Betimleyici: | setenvif_module |
| Kaynak Dosyası: | mod_setenvif.c |
mod_setenvif modülü dahili ortam değişkenlerinin
isteğin farklı bileşenlerinin belirttiğiniz düzenli ifade ile eşleşmesine
bağlı olarak atanmasını mümkün kılar. Bu ortam değişkenleri sunucunun
çeşitli kısımlarında yapılacak eylemlerin yanında CGI betiklerinde ve SSI
sayfalarında kullanılabilir hale gelmelerine karar verilirken
kullanılır.
Yönergeler yapılandırma dosyasında yer aldıkları sıraya göre ele
alınırlar. Böylece daha karmaşık dizilimler kullanılabilir, bu örnekteki
tarayıcı Mozilla ise netscape ortam değişkeni atanmakta,
MSIE ise atanmamaktadır.
BrowserMatch ^Mozilla netscape BrowserMatch MSIE !netscape
mod_autoindex ile dizin listesi oluşturulması
veya bir DirectoryIndex
için yol aranması gibi bir dahili alt
istek için sunucu yol araması yaparken isteklere özgü
ortam değişkenleri alt istekler tarafından miras alınMAZ. Buna ek
olarak, mod_setenvif modülünün devreye girdiği API
fazlarından dolayı yapılan alt isteklerde
SetEnvIf yönergeleri
ayrı ayrı değerlendirilMEZ.
| Açıklama: | Ortam değişkenlerini HTTP kullanıcı arayüzüne göre belirler. |
|---|---|
| Sözdizimi: | BrowserMatch düzifd [!]ort-değişkeni[=değer]
[[!]ort-değişkeni[=değer]] ... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_setenvif |
BrowserMatch yönergesi SetEnvIf yönergesinin özel bir halidir
ve ortam değişkenlerine User-Agent HTTP istek başlığının
değerine göre atama yapar. Aşağıdaki iki satır aynı etkiye sahiptir:
BrowserMatch Robot is_a_robot SetEnvIf User-Agent Robot is_a_robot
Başka örnekler:
BrowserMatch ^Mozilla forms jpeg=yes browser=netscape BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript BrowserMatch MSIE !javascript
| Açıklama: | Ortam değişkenlerini HTTP kullanıcı arayüzünün harf büyüklüğüne duyarsız eşleşmelerine bağlı olarak belirler. |
|---|---|
| Sözdizimi: | BrowserMatchNoCase düzifd [!]ort-değişkeni[=değer]
[[!]ort-değişkeni[=değer]] ... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_setenvif |
BrowserMatchNoCase yönergesi sözdizimsel ve
anlamsal olarak BrowserMatch yönergesinin eşdeğeridir.
Ancak, eşleşmelerde harf büyüklüğüne duyarsızdır. Örnek:
BrowserMatchNoCase mac platform=macintosh BrowserMatchNoCase win platform=windows
BrowserMatch ve
BrowserMatchNoCase yönergeleri SetEnvIf ve SetEnvIfNoCase yönergelerinin özel
halleridir. Bu bakımda aşağıdaki iki satır aynı etkiye sahiptir:
BrowserMatchNoCase Robot is_a_robot SetEnvIfNoCase User-Agent Robot is_a_robot
| Açıklama: | Ortam değişkenlerini isteğin özniteliklerine göre atar. |
|---|---|
| Sözdizimi: | SetEnvIf öznitelik
düzifd [!]ort-değişkeni[=değer]
[[!]ort-değişkeni[=değer]] ... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_setenvif |
SetEnvIf yönergesi ortam değişkenlerini isteğin
özniteliklerine göre tanımlar. İlk bileşen olarak belirtilen
öznitelik şu dört şeyden biri olabilir:
Host, User-Agent,
Referer ve Accept-Language. Bir düzenli
ifade kullanılarak birden fazla istek başlığı belirtilebilir.Remote_Host - isteği yapan istemcinin konak ismi
(varsa)Remote_Addr -isteği yapan istemcinin IP adresiServer_Addr - isteği alan sunucunun IP adresi
(sadece 2.0.43 sonrası sürümler için)Request_Method - kullanılan yöntemin ismi
(GET, POST, vs.)Request_Protocol - İsteğin yapıldığı protokolün
ismi ve numarası ("HTTP/0.9", "HTTP/1.1" gibi)Request_URI - HTTP istek satırında belirtilen
özkaynak; genellikle sorgu dizgesi olmaksızın şema ve konak ismini
içeren bir URL parçasıdır. Sorgu dizgeleriyle eşleşmeler hakkında
ayrıntılı bilgi edinmek için mod_rewrite
modülünün RewriteCond
yönergesinin açıklamasına bakınız.SetEnvIf[NoCase] yönergeleri ile yapılmış atamalardaki
ortam değişkenleri kullanılabilir. ‘Evvelce’ derken, sunucu genelinde
veya bölüm içinde bu yönergeden önce yer alan
SetEnvIf[NoCase] yönerge satırları kastedilmektedir.
Ortam değişkenlerinin dikkate alınabilmesi için istek öznitelikleri
arasında hiçbir eşleşme olmaması ve öznitelik
olarak bir düzenli ifade belirtilmemiş olması gerekir.İkinci bileşen (düzifd) bir düzenli ifadedir. düzifd
ile öznitelik eşleştiği takdirde yönergenin kalan
bileşenleri değerlendirmeye alınır.
Kalan bileşenler atanacak ortam değişkenlerinin isimleri ve isteğe bağlı olarak bunlara atanacak değerlerden oluşur. Bunlar şöyle belirtilebilir:
değişken-adı veya!değişken-adı ya da değişken-adı=değerİlk biçemde değişkene "1" değeri atanır. İkincisinde atanmış bir
değişken atanmamış yapılır. Üçüncüsünde ise değişkene belirtilen
değer bire bir atanır. 2.0.51 sürümünden itibaren
Apache httpd parantezli düzenli ifadelerin sonuçları ile değiştirilmek
üzere value içinde $1..$9
gösterimleri tanınmaktadır. $0 bu kalıp ile eşleşen tüm dizgeye erişir.
SetEnvIf Request_URI "\.gif$" nesne_bir_resim=gif SetEnvIf Request_URI "\.jpg$" nesne_bir_resim=jpg SetEnvIf Request_URI "\.xbm$" nesne_bir_resim=xbm SetEnvIf Referer belgeler\.alanismi\.example\.com dahili_site_istendi SetEnvIf object_is_image xbm XBIT_PROCESSING=1 SetEnvIf Request_URI "\.(.*)$" EXTENSION=$1 SetEnvIf ^TS ^[a-z] TS_VAR
İlk üçünde istek bir resim dosyası için yapılmışsa
nesne_bir_resim ortam değişkeni atanmakta, dördüncüsünde
istenen sayfa belgeler.alanismi.example.com adlı sitede
bulunuyorsa dahili_site_istendi ortam değişkeni
atanmaktadır.
Son örnekte ise istekte "TS" ile başlayıp [a-z] arasındaki
karakterlerle devam eden bir başlık alanı varsa TS_VAR
ortam değişkeni atanmaktadır.
| Açıklama: | Bir ap_expr ifadesine dayanarak ortam değişkenlerine değer atar |
|---|---|
| Sözdizimi: | SetEnvIfExpr ifade
[!]ort-değişkeni[=değer]
[[!]ort-değişkeni[=değer]] ... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_setenvif |
SetEnvIfExpr yönergesi bir <If> ap_expr
ifadesine dayanarak ortam değişkenlerine değer atar. Bu ifadeler çalışma
anında değerlendirilirerek SetEnvIf yönergesindeki
gibi ort-değişkenine uygulanır.
SetEnvIfExpr "tolower(req('X-Sendfile')) == 'd:\images\very_big.iso')" iso_delivered
Burada uygulamamızın her X-Sendfile göndermeye çalışmasında
ortam değişkenine iso_delivered değeri atanmaktadır.
Uzak IP adresi RFC 1918'e göre özel bir adres ise rfc1918 değişkenine 1 atanması daha kullanışlı bir örnek olurdu:
SetEnvIfExpr "-R '10.0.0.0/8' || -R '172.16.0.0/12' || -R '192.168.0.0/16'" rfc1918
<If> yönergesi kullanılabilir.mod_filter| Açıklama: | Ortam değişkenlerini isteğin özniteliklerinde harf büyüklüğüne bağlı olmaksızın yapılmış tanımlara göre atar. |
|---|---|
| Sözdizimi: | SetEnvIfNoCase öznitelik
düzifd [!]ort-değişkeni[=değer]
[[!]ort-değişkeni[=değer]] ... |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_setenvif |
SetEnvIfNoCase yönergesi sözdizimsel ve anlamsal
olarak SetEnvIf
yönergesinin eşdeğeridir. Ancak, eşleşmelerde harf büyüklüğüne
duyarsızdır. Örnek:
SetEnvIfNoCase Host Example\.Org site=example
Burada, Host: HTTP istek başlığında
Example.Org, example.org veya harf büyüklüğünce
farklı benzerleri belirtilmişse site ortam değişkenine
"example" değeri atanmaktadır.
Apache HTTP Server Version 2.4
| : | Ҷ Ȥ Ҷ డ ڵ оδ |
|---|---|
| : | Extension |
| : | so_module |
| ҽ: | mod_so.c |
| : | ( ϴ) Base ̴. |
ü ġ ü (DSO) Ͽ ٽ ʰ ߿ о ִ.
о ڵ, н (.so Ȯڸ
) Ϲ ṵ̈, .so
Ȥ .dll Ȯڸ .
ġ 1.3 ġ 2.0 . ġ 2.0 о̰ų ġ Ϸ ؾ Ѵ.
ġ 1.3.15 2.0 Ǿ. mod_foo.so̴.
mod_so ApacheModuleFoo.dll о , ο ̸ Ģ ȣѴ. 2.0 ° Ѵٸ ̸ 2.0 Ģ ˸° ġ ٶ.
ġ API н ̰ų ̰ų . API н ϱ , н Ǵ Ȥ Ͽ ִ.
ΰ ߰ ִ. н
ִ. ġ
н Configure α
ҽ ApacheCore Ʈ Ͽ ߰ϰ, ɺ
os\win32\modules.c Ͽ ߰ؾ Ѵ.
ι°
LoadModule
DLL ؼ ҽ ؾ
Ѵ. DLL module record exportؾ Ѵ. (Ʒ )
̸ module record ǿ (ġ Ͽ
ǵ) AP_MODULE_DECLARE_DATA ߰Ѵ.
, ִٸ:
module foo_module;
Ѵ:
module AP_MODULE_DECLARE_DATA foo_module;
κ ϱ Ͽ н
ҽ ״ ִ. , .DEF Ͽ
ͼϴٸ Ͽ module record export
ִ.
DLL . ̸ ̺귯 libhttpd.dll Ҷ libhttpd.lib export ̺귯 ũѴ. ġ ùٷ ã Ϸ ؾ . modules 丮 ̺귯 ã ִ. ȯ ùٷ ϱ .dsp ų .dsp Ϸ/Ŀ ɼ ϴ .
DLL . ̰
modules 丮 ΰ,
LoadModule þ Ͽ оδ.
| : | ̳ ̺귯 оδ |
|---|---|
| : | LoadFile filename [filename] ... |
| : | ּ |
| : | Extension |
| : | mod_so |
LoadFile þ ϰų Ҷ ̳ ̺귯 оδ(link in). þ ϱ ʿ ڵ带 ߰ о϶ Ѵ. Filename ̰ų ServerRoot ̴.
:
LoadFile libexec/libxmlparse.so
Apache HTTP Server Version 2.4
| : | ڰ ҹڸ ߸ ϰų Ʋ ѹ Ͽ ߸ URL ġ õѴ |
|---|---|
| : | Extension |
| : | speling_module |
| ҽ: | mod_speling.c |
Ʋų ҹڸ ߸ Ͽ ġ û 찡 ִ. ٸ û شϴ ã´. û 丮 ȿ ִ û ̸ ҹ ( ÷ / / ü Ȥ ߸ ) ѹ Ʋ ָ Ѵ. ̷ .
丮 캻 Ŀ,
| : | Also match files with differing file name extensions. |
|---|---|
| : | CheckBasenameMatch on|off |
| ⺻: | CheckBasenameMatch On |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Options |
| : | Extension |
| : | mod_speling |
| : | Available in httpd 2.4.50 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | Limits the action of the speling module to case corrections |
|---|---|
| : | |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Extension |
| : | mod_speling |
Documentation not yet translated. Please see English version of document.
| : | Ѵ |
|---|---|
| : | CheckSpelling on|off |
| ⺻: | CheckSpelling Off |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | Options |
| : | Extension |
| : | mod_speling |
| : | ġ 1.1 CheckSpelling Ͽ,
ҹڰ ٸ 츸 ó ־. ġ 1.3 ġ
Ϻΰ Ǿ. ġ 1.3.2
CheckSpelling þ "ּ" "ȣƮ"
ҿ ־. |
þ 뿩θ Ѵ. Ѵٸ ϶
http://my.host/~apahce/ )
Ʋ ڸ Ѵ.<Location /status> û
ģ "/stats.html" Ϸ
ִ.DAV ϴ 丮
mod_speling ϸ ȵȴ. εϷ
doc43.html ϰ
doc34.html Ϸ ̷Ʈϴ , DAV
ҽ ϸ " "
õϱ ̴.
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Modüllerin ve çalıştırılabilir kodun sunucunun başlatılması veya yeniden başlatılması sırasında yüklenmesini sağlar. |
|---|---|
| Durum: | Eklenti |
| Modül Betimleyici: | so_module |
| Kaynak Dosyası: | mod_so.c |
| Uyumluluk: | Windows için bu bir temel modüldür (sunucu bunu daima içerir). |
Seçilen işletim sistemleri üzerinde bu modül Apache HTTP Sunucusunun yeniden derlenmesini gerektirmeden modüllerin Devingen Paylaşımlı Nesne (DSO) mekanizması üzerinden kullanılabilmesini sağlar.
Unix’te yüklenen kod genellikle paylaşımlı nesne dosyalarından
(.so uzantılı dosyalar), Windows’ta ise ya .so
ya da .dll uzantılı dosyalardan gelir.
Apache HTTP Sunucusunun ana sürümlerinden biri (1.3, 2.0, 2.2, 2.4 gibi) için derlenmiş modüller genelde bir diğerinde çalışmaz. Genellikle aralarında API değişikliği sözkonusu olduğundan çalışması için modüllerde yeni sürüme göre değişiklik yapılması gerekir.
Windows üzeinde yüklenebilir dosyalar genelde .dll sonekini
alırlar. Apache httpd modülleri ise diğer platformlardaki gibi
mod_filanca.so biçeminde isimlendirilmektedir. Bununla
birlikte, üçüncü parti modüllerden bazılarının (PHP gibi) hala
.dll sonekini kullandığı görülmektedir.
mod_so modülü ApacheModuleFoo.dll biçeminde
isimlendirilmiş modülleri hala yüklemekteyse de yeni adlandırma uzlaşımı
tercih edilmelidir. Yüklenebilir modülleri 2.0’a dönüştürüyorsanız,
lütfen isimlerini de 2.0 uzlaşımına uygun hale getiriniz.
Apache httpd modül programlama arayüzü Unix ve Windows sürümleri arasında değişiklik göstermez. Unix için kullanılan çoğu modül hiç değişiklik yapmadan ya da çok küçük bir değişiklikle Windows’ta da çalışmaktadır. Çalışmayanlar Unix platformunun sahip olduğu ancak Windows platformunun sahip olmadığı nitelikleri kullanan modüllerdir.
Bir modül Windows’ta çalıştığı zaman, sunucuya iki şekilde
yüklenebilir. Unix’te olduğu gibi, doğrudan sunucunun içinde
derlenebilir. Windows için hazırlanan Apache httpd paketi, Unix için
geçerli olan Configure betiğini içermediğinden modülün
kaynak dosyası ApacheCore proje dosyasına, sembolleri de
os\win32\modules.c dosyasına eklenmelidir.
İkinci yol ise modülü bir paylaşımlı kütüphane olarak çalışma anında
LoadModule yönergesi ile yüklemek
için bir DLL olarak derlemektir. Bu DLL modüller dağıtılabilir ve
sunucuyu yeniden derlemek gerekmeksizin her Windows için Apache httpd
kurulumunda çalışabilir.
Bir modül DLL’i oluşturmak için modülün kaynak dosyasında küçük bir
değişiklik yapmak gerekir: Modül kaydının daha sonra oluşturulacak olan
DLL’den ihraç edilebilmesi gerekir (aşağıya bakınız). Bunu yapmak için
modülün modül kaydı tanımına (Apache httpd başlık dosyalarında
tanımlanmış olan) AP_MODULE_DECLARE_DATA eklenmelidir.
Örneğin, modülünüz
module foo_module;
diye bir satır içeriyorsa bunu,
module AP_MODULE_DECLARE_DATA foo_module;
olarak değiştirmelisiniz. Bunun yalnız Windows üzerinde etkili olduğunu
ve Unix için modül kodunda bir değişiklik gerekmediğini unutmayınız.
Ayrıca, .DEF dosyaları hakkında bilgi sahibi iseniz modül
kodunda değişiklik yapmak yerine modül kaydını bu yöntemle de ihraç
edebilirsiniz.
Artık modülü içeren bir DLL oluşturmaya hazırsınız. Bunu, libhttpd.dll
paylaşımlı kütüphanesi derlenirken oluşturulan libhttpd.lib ihraç
kütüphanesi ile ilintilemeniz gerekecektir. Ayrıca, Apache httpd başlık
dosyalarının doğru konumlandığından emin olmak için derleyici
seçeneklerinde değişiklik yapmanız gerekebilir. Bu kütüphaneyi
sunucunuzun kök dizini altındaki modules dizininde
bulabilirsiniz. En iyisi derleme ortamının doğru yapılandırıldığından
emin olmak için ya ağaçta mevcut modüllerden birinin .dsp
dosyasını gaspedersiniz ya da kendi .dsp dosyanızın
ilintileme seçenekleriyle derleyicininkileri karşılaştırırsınız.
Artık modülünüzün DLL sürümünü oluşturmalısınız. DLL’i sunucunuzun kök
dizininin altında bulunan modules dizinine yerleştirdikten
sonra LoadModule yönergesi ile sunucunuza
yükleyebilirsiniz.
| Açıklama: | Belirtilen nesne dosyasını veya kütüphaneyi sunucu ile ilintiler. |
|---|---|
| Sözdizimi: | LoadFile dosya-ismi [dosya-ismi] ... |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Eklenti |
| Modül: | mod_so |
LoadFile yönergesi ismi belirtilen kütüphaneleri
veya nesne dosyalarını sunucu başlatılırken veya yeniden başlatılırken
sunucu ile ilintiler. Yönerge, bazı modüllerin çalışması sırasında
gereken ek kodların yüklenmesi için kullanılır.
dosya-ismi olarak mutlak bir dosya yolu
belirtilebileceği gibi ServerRoot’a
göreli bir dosya yolu da belirtilebilir.
Örnek:
LoadFile libexec/libxmlparse.so
| Açıklama: | Belirtilen nesne dosyasını veya kütüphaneyi sunucu ile ilintiler ve etkin modül listesine ekler. |
|---|---|
| Sözdizimi: | LoadModule modül dosya-ismi |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Eklenti |
| Modül: | mod_so |
LoadModule yönergesi
dosya-ismi ile belirtilen nesne dosyasını veya
kütüphaneyi sunucu ile ilintiler ve etkin modül listesine belirtilen
modül ismiyle ekler. modül,
modülün kaynak dosyasında module türündeki tek harici
değişkenin ismi olup modül belgelerinde Modül Betimleyici olarak
geçer.
Örneğin,
LoadModule status_module modules/mod_status.so
satırı ile ismi belirtilen dosya ServerRoot dizini altındaki
modules alt dizininden yüklenir.
Versión 2.4 del Servidor HTTP Apache
Este documento describe los términos que se usan para describir cada directiva de configuración de Apache.
Una breve descripción del propósito de la directiva.
Indica el formato de la directiva tal y como aparecería en un fichero de configuración. Esta sintaxis es muy específica de cada directiva, y se describe con detalle en la definición de la directiva. Generalmente, el nombre de la directiva va seguido de una serie de uno o más parámetros separados por un espacio. Si un parámetro contiene un espacio, éste debe especificarse entre comillas dobles. Los parámetros opcionales van especificados entre corchetes. Donde un parámetro puede tener uno o más valores, los valores posibles se separan con barras verticales "|". El Texto Literal se muestra con la fuente por defecto, mientras que los distintos tipos de parámetros para los que una sustitución resulta necesaria son enfatizados. Las directivas que pueden tomar una lista variada de parámetros acaban en "..." indicando que el último parámetro se repite.
Las Directivas usan un gran número de diferentes tipos de parámetros. A continuación definimos algunos de los más comunes.
http://www.example.com/path/to/file.html/path/to/file.html. El
url-path representa una vista-web de un recurso, en
contraposición a una vista de sistema-de-ficheros./usr/local/apache/htdocs/path/to/file.html.
A menos que se especifique, una ruta de fichero que no comienza
con una barra "/" se tratará como una ruta relativa a ServerRoot./usr/local/apache/htdocs/path/to/.file.html.file.html.en
contiene dos extensiones: .html y
.en. Para las directivas de Apache, podrá especificar
la extensiones con o sin el punto inicial. Además, las
extensiones no son sensibles a mayúsculas o minúsculas.text/html.Si la directiva tiene un valor por defecto (p.ej., si la omite de la configuración completamente, el servidor Web Apache se comportará como si la hubiera configurado con un valor en particular), se describe aquí. Si no tiene valor por defecto, esta sección debería indicar "Ninguno". Tenga en cuenta que el valor por defecto listado aquí no es necesariamente el mismo que el valor que toma la directiva en el httpd.conf por defecto distribuido con el servidor.
Esto indica dónde se acepta la directiva en los ficheros de configuración. Es una lista separada por comas para uno o más de los siguientes valores:
httpd.conf),
pero not dentro de cualquier contenedor
<VirtualHost>
o <Directory>.
No se permite en ficheros .htaccess de ninguna
manera.<VirtualHost>
en el fichero de configuración del servidor.<Directory>, <Location>, <Files>, <If>, <Proxy> en los ficheros de
configuración del servidor, sujeta a las restricciones destacadas en
las Secciones de Configuración..htaccess de contexto de
directorio. Aunque podría no ser procesada, dependiendo de la
configuración activa de AllowOverride en ese
momento.La directiva solo se permite dentro del contexto designado; si intenta usarlo en algún otro, obtendrá un error de configuración que impedirá que el servidor gestione correctamente las solicitudes en ese contexto, o impedirá que el servidor pueda funcionar completamente -- p.ej., el servidor no arrancará.
Las ubicaciones válidas para la directiva son actualmente el resultado de
un Boolean OR de todos los contextos listados. En otras palabras, una
directiva que está marcada como válida en
"server config, .htaccess" puede usarse en el fichero
httpd.conf y en ficheros .htaccess, pero no dentro
de contenedores <Directory>
o <VirtualHost>.
Este atributo de directiva indica qué Override de configuración debe
estar activo para que la directiva se procese cuando aparece en un fichero
.htaccess. Si el contexto de la
directiva no permite que aparezca en ficheros .htaccess,
entonces no se listará ningún contexto.
Los Override se activan con la directiva AllowOverride, si se aplican a un ámbito en
particular (como por ejemplo un directorio) y todos sus descendientes, a
menos que se modifique más adelante por otras directivas
AllowOverride en niveles
inferiores. La documentación para la directiva también muestra una lista de
los posibles nombres de Override disponibles.
Esto indica cuan vinculada está esta directiva al servidor Web de Apache; o en otras palabras, puede que necesite recompilar el servidor con un conjunto mejor de módulos para obtener acceso a esta directiva y su funcionalidad. Valores posibles para estar directiva son:
Esto simplemente hace referencia al nombre del módulo original que provee la directiva.
Si la directiva no era parte de la distribución original de Apache versión 2, la versión en la que se introdujo debería estar referida aquí. Además, si la direcitva solo está disponible en ciertas plataformas, se verá anotado aquí.
Apache HTTP サーバ バージョン 2.4
| 説明: | サーバの活動状況と性能に関する情報を提供する |
|---|---|
| ステータス: | Base |
| モジュール識別子: | status_module |
| ソースファイル: | mod_status.c |
この Status モジュールによりサーバ管理者はサーバがどのくらい の性能で動作しているかを知ることができるようになります。 現時点でのサーバの統計情報を読みやすい形式で表した HTML ページが 表示されます。必要であれば、このページは自動的にリフレッシュさせる こともできます (互換性のあるブラウザを使用している場合)。 別に、現時点でのサーバの状態を単純な機械読み取り可能なリストで 表すページもあります。
表示される情報は:
"(*)" の付いている情報を表示するには
ExtendedStatus
が On になっている必要があります。
このモジュールにディレクティブはありません。
example.com ドメインからのブラウザのみに対して
ステータスの報告を使用可能にするには
以下のコードを httpd.conf 設定ファイルに追加します
<Location /server-status>
SetHandler server-status
Order Deny,Allow
Deny from all
Allow from .example.com
</Location>
これで、サーバの統計情報をウェブブラウザを使って
http://your.server.name/server-status をアクセスすることにより
知ることができるようになります。
ブラウザが「リフレッシュ」機能をサポートしていれば、ステータスページを
自動的に更新するようにできます。N 秒毎に更新させるためには
http://your.server.name/server-status?refresh=N
というページをアクセスしてください。
http://your.server.name/server-status?auto を
アクセスすることにより、ステータスファイルの機械読み取り可能なバージョンを
得ることができます。これは自動的に実行されるときに便利です。
Apache の /support ディレクトリにある
Perl プログラム log_server_status を見てください。
mod_status がサーバに組み込まれている
場合、ハンドラの機能はディレクトリ毎のファイル
(すなわち、.htaccess) も含むすべての
設定ファイルで使用可能になることには注意をしておく必要があります。
これは、サイトによってはセキュリティに関する望ましくない結果を
もたらすことがあるかもしれません。
Apache HTTP サーバ バージョン 2.4
| 説明: | 指定されたユーザとグループで CGI スクリプトを実行する |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | suexec_module |
| ソースファイル: | mod_suexec.c |
| 互換性: | Apache 2.0 以降で使用可能 |
このモジュールと suexec サポートプログラム
により、CGI スクリプトが指定されたユーザとグループで
実行されるようにできます。
| 説明: | CGI プログラムのユーザパーミッション、グループパーミッション |
|---|---|
| 構文: | SuexecUserGroup User Group |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_suexec |
| 互換性: | SuexecUserGroup は 2.0 以降でのみ使用可能。 |
SuexecUserGroup ディレクティブは CGI プログラム
が実行されるユーザとグループを指定できるようにします。CGI 以外の
リクエストは User ディレクティブで指定されたユーザのままで処理されます。
このディレクティブは Apache 1.3 における VirtualHosts の中で
User ディレクティブと Group ディレクティブを使う用法の代わりになります。
SuexecUserGroup nobody nogroup
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Sunucu etkinliği ve başarımı hakkında bilgi sağlar. |
|---|---|
| Durum: | Temel |
| Modül Betimleyici: | status_module |
| Kaynak Dosyası: | mod_status.c |
mod_status modülü, sunucu yöneticisinin, HTTP sunucusunun
ne kadar başarılı olduğu hakkında bilgi edinmesini sağlar. Bilgiler,
kolayca okunabilen bir HTML sayfası olarak sunulur ve o anki sunucu
istatistiklerinden oluşur. Gerekirse sayfa kendiliğinden tazelenebilir
(uyumlu bir tarayıcı gerekir). Diğer sayfa o anki sunucu durumunu makine
tarafından okunabilen biçimde listeler.
Sunulan bilgiler şunlardır:
"(*)" imli bilgiler sadece ExtendedStatus yönergesinin değeri On olduğu
takdirde mevcuttur. 2.3.6 sürümünde, bu modulün yüklenmesi öntanımlı
olarak ExtendedStatus yönergesinin
değerini On yapacaktır.
Durum Bilgisi Desteğinin Etkinleştirilmesi Sayfanın Tazelenmesi Makine Tarafından Okunabilen Durum Dosyası Sorun gidermek için server-status kullanımıBu modül yönerge içermez.
Durum raporları, sadece example.com alanından ve sadece tarayıcılar için
etkin kılınmak istenirse httpd.conf dosyasına şu satırlar
eklenebilir:
<Location "/server-status">
SetHandler server-status
Require host example.com
</Location>
Sunucu istatistiklerine tarayıcınızla erişmek isterseniz,
http://sunucunuzun.ismi.buraya/server-status
şeklinde bir istek yapabilirsiniz.
Tarayıcınız “tazeleme” yeteneğine sahipse durum sayfası düzenli
aralıklarla güncellenecektir. Sayfanın N saniyede bir güncellenmesini
isterseniz isteği şöyle yapabilirsiniz:
http://sunucunuzun.ismi.buraya/server-status?refresh=N
Durum dosyasının makine tarafından okunabilen sürümüne
http://sunucunuzun.ismi.buraya/server-status?auto
şeklinde bir istek yaparak erişebilirsiniz. Bu, kendiliğinden çalıştığı
takdirde yararlıdır; Apache HTTP Sunucusu kurulumunuzun
/support dizininde bulunan log_server_status
isimli Perl betiğine bakınız.
mod_status sunucuya yüklendiği takdirde
istatistikleri raporlama yeteneği dizin içi yapılandırma dosyaları
(.htaccess gibi) dahil tüm yapılandırma dosyaları
için kullanılabilir olacaktır. Bu durum güvenlik ile ilgili olarak
siteniz için içinden çıkılması güç durumlara yol açabilir (çapanoğlu
durumu).Sunucunuzun kullanılabilir tüm özkaynakları (işlemci veya bellek)
sömürdüğü ve sizin de bu soruna hangi istemcilerin veya isteklerin yol
açtığını saptamak istediğiniz durumda sorunu gidermek için başlangıç yeri
olarak server-status sayfası kullanılabilir.
Önce ExtendedStatus yönergesine On
atadığınızsan emin olun. Böylece her çocuk süreç veya evre için tüm istek
ve istemci bilgilerini görebilirsiniz.
(top veya benzeri bir süreç izleme aracı kullanarak) Artık
kendi süreç listenize ana zanlılar olan süreçleri bulmak için
bakabilirsiniz. Sorunun çeşidine bağlı olarak top çıktısını
işlemci kullanımına veya bellek kullanımına göre sıralatabilirsiniz.
server-status sayfasını yeniden yükleyip bu süreç
kimliklerine bakın. Böylece, bu süreçler tarafından hangi isteklerin hangi
istemcilere sunulduğunu görebilirsiniz. İstekler kısa sürelerle görünürler,
bu bakımdan iş üstünde yakalamak için çeşitli denemeler yapmanız
gerekebilir.
Bu işlem, yük sorununuzdan birinci derecede sorumlu istek türleri veya istemciler hakkında bir fikir verecektir. Çoğu durumda belli bir HTTP uygulamasının yanlış davrandığını veya belli bir istemcinin sitenize saldırmakta olduğunu farkedersiniz.
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | CGI betiklerinin belli bir kullanıcı ve grubun aidiyetinde çalışmasını mümkün kılar. |
|---|---|
| Durum: | Eklenti |
| Modül Betimleyici: | suexec_module |
| Kaynak Dosyası: | mod_suexec.c |
Bu modül suexec programı ile birlikte CGI
betiklerinin belli bir kullanıcı ve grubun aidiyetinde çalışmasını
mümkün kılar.
| Açıklama: | CGI betiklerini çalıştıracak kullanıcı ve grup belirtilir. |
|---|---|
| Sözdizimi: | SuexecUserGroup Kullanıcı Grup |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Eklenti |
| Modül: | mod_suexec |
SuexecUserGroup yönergesi CGI programlarını
çalıştıracak kullanıcı ve grubu belirtmeye yarar. CGI harici istekler
hala User yönergesinde
belirtilen kullanıcı tarafından yerine getirilir.
SuexecUserGroup nobody nogroup
Bu yönerge belirtildiği halde
Suexec
özelliği etkinleştirilmemişse Apache httpd başlatılamaz.
Apache HTTP サーバ バージョン 2.4
以下は Apache HTTP サーバの配布物に同梱されているモジュールの 一覧です。Apache HTTP サーバ ディレクティブ のアルファベット順のリストもご覧ください。
worker MPM with the goal
of consuming threads only for connections with active processingA | B | C | D | E | F | H | I | L | M | N | P | R | S | U | V | W | X
ls コマンドや
Win32 の dir シェルコマンドに似た
ディレクトリインデックスを生成するmod_dav のためのファイルシステムプロバイダmod_dav 用の汎用ロックモジュールExpires と
Cache-Control HTTP ヘッダの生成mod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxy で AJP
をサポートするためのモジュールmod_proxy 拡張CONNECT リクエストを扱う
mod_proxy 用の拡張mod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxysed syntaxApache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Belge ağacının parçalarının dosya sisteminin parçalarıyla eşlenmesini sağlar ve URL yönlendirmesi yapar. |
|---|---|
| Durum: | Temel |
| Modül Betimleyici: | alias_module |
| Kaynak Dosyası: | mod_alias.c |
Bu modülde bulunan yönergeler sunucuya istek olarak gelen URL’lerin
denetlenmesini ve değiştirilmesini mümkün kılar. Alias ve ScriptAlias yönergeleri URL’lerin dosya sisteminin
dizinlerine eşlenmesini sağlar. Böylece, kök dizini DocumentRoot ile belirtilen site belge ağacı
altında bulunmayan içeriğe erişmek mümkün olur. ScriptAlias yönergesi buna ek olarak
hedef dizini sadece CGI betiklerini içeren dizin olarak imler.
Redirect yönergesi,
farklı bir URL ile yeni bir istek yapmaları için istemcileri
yönlendirmekte kullanılır. Çoğunlukla özkaynak başka bir yere
taşındığında kullanılır.
Alias,
ScriptAlias ve
Redirect yönergeleri
<Location>
veya <LocationMatch>
bölümleri içinde kullanıldığında hedef yolu veya URL'yi betimlemek için
ifade sözdizimi kullanılabilir.
mod_alias modülü basit URL değiştirme görevlerini
yerine getirmek için tasarlanmıştır. Sorgu dizgelerini işleme sokmak
gibi daha karmaşık görevler için mod_rewrite modülü ile
sağlanan araçlar kullanılır.
Alias AliasMatch AliasPreservePath Redirect RedirectMatch RedirectPermanent RedirectRelative RedirectTemp ScriptAlias ScriptAliasMatchFarklı bağlamlarda bulunan Alias ve Redirect
yönergeleri standart katıştırma
kuralları ile ilgili diğer yönergeler gibi işleme sokulur. Fakat
aynı bağlam dahilinde (örneğin, aynı <VirtualHost> bölümünde) çok fazla Alias ve Redirect varsa bunlar belli bir
sıraya göre işleme sokulurlar.
İlk adımda, Alias’lardan önce
bütün Redirect yönergeleri
işleme sokulur. Bu bakımdan bir Redirect veya RedirectMatch ile eşleşen bir istek için
hiçbir Alias
uygulanmayacaktır. İkinci adımda yapılandırma dosyasında yer aldıkları
sıraya göre Redirect ve
Alias yönergeleri işleme
sokulurlar, dolayısıyla ilk eşleşme öncelikli olmuş olur.
İlk eşleşmenin öncelikli olması sebebiyle, bu yönergelerin birden fazlası aynı alt yola uygulandığı takdirde, tüm yönergelerin etkili olabilmesi için en uzun yolu sıralamada en öne almalısınız. Örneğin aşağıdaki yapılandırma beklendiği gibi çalışacaktır:
Alias "/foo/bar" "/baz" Alias "/foo" "/gaq"
Ama yukarıdaki iki satır ters sırada yerleştirilmiş olsaydı,
/foo rumuzu daima /foo/bar rumuzundan önce
eşleşecek, dolayısıyla ikinci yönerge yok sayılacaktı.
Alias,
ScriptAlias ve
Redirect yönergeleri
<Location>
veya <LocationMatch>
bölümleri içinde kullanıldığında bu yönergeler küresel olarak tanımlı
Alias,
ScriptAlias ve
Redirect yönergelerinden öncelikli olur.
| Açıklama: | URL’leri dosya sistemi konumlarıyla eşler. |
|---|---|
| Sözdizimi: | Alias [URL-yolu] dosya-yolu |
dizin-yolu |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Temel |
| Modül: | mod_alias |
Alias yönergesi, belgelerin DocumentRoot dizininden farklı bir yerde
saklanmasını mümkün kılar. URL-yolu ile başlayan
URL’ler (% imlemesi çözüldükten sonra) dizin-yolu
ile başlayan yerel dosyalarla eşlenir. URL-yolu,
harf büyüklüğüne duyarsız sistemlerde bile harf büyüklüğüne
duyarlıdır.
Alias "/image" "/ftp/pub/image"
http://example.com/image/foo.gif şeklinde bir istek,
sunucunun /ftp/pub/image/foo.gif dosyasıyla yanıt vermesine
sebep olurdu. Sadece tam yol parçaları eşleştirilir; bu bakımdan
yukarıdaki Alias yapılandırması
http://example.com/imagefoo.gif ile eşleşmez. Düzenli
ifadelerin kullanıldığı daha karmaşık eşleşmeler için AliasMatch yönergesine bakınız.
URL-yolu’nu bir / ile
sonlandırırsanız Alias yönergesini yorumlarken
sunucunun da sona bir / ekleyeceğine dikkat ediniz. Yani,
eğer
Alias "/icons/" "/usr/local/apache/icons/"
diye bir tanım yaparsanız sona bir / ekleme ihtiyacından dolayı
/icons URL’si için bir Alias
kullanılmayacaktır.
Alias hedefleri için ek <Directory> bölümleri
belirtmeniz gerekebileceğine dikkat ediniz. <Directory> bölümlerinden önce yer alan
Alias yönergelerine özellikle bakılır,
dolayısıyla sadece Alias hedefleri etkilenir.
(Bununla birlikte, Alias yönergelerinden önce
işleme sokulan <Location> bölümlerinin uygulanacağına dikkat
ediniz.)
Özellikle, DocumentRoot dışında
bir dizine bir Alias oluşturuyorsanız hedef
dizine doğrudan erişim izni vermeniz gerekebilir.
Alias "/image" "/ftp/pub/image"
<Directory "/ftp/pub/image">
Require all granted
</Directory>
URL-yolu değiştirgesindeki bölü çizgilerinin sayısı istek URL-yolundakiler kadardır.
Eğer Alias yönergesi
<Location>
veya <LocationMatch>
bölümleri içinde kullanılırsa URL-yolu yoksayılır ve dosya-yolu
ifade sözdizimi kullanılarak yorumlanır.
Bu sözdizimi Apache 2.4.19 ve sonrasında kulanılabilir.
<Location "/image">
Alias "/ftp/pub/image"
</Location>
<LocationMatch "/error/(?<NUMBER>[0-9]+)">
Alias "/usr/local/apache/errors/%{env:MATCH_NUMBER}.html"
</LocationMatch>
| Açıklama: | URL’leri dosya sistemi konumlarıyla düzenli ifadeleri kullanarak eşler. |
|---|---|
| Sözdizimi: | AliasMatch "düzenli-ifade"
"dosya-yolu|dizin-yolu" |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Temel |
| Modül: | mod_alias |
Bu yönerge URL-yolu ile eşleşmek üzere bir
düzenli ifade kabul etmesi dışında
Alias yönergesine eşdeğerdir.
Belirtilen düzenli ifade URL-yolu ile eşleşiyorsa
sunucu parantezli eşleşmeleri belirtilen dizgede kullanarak dosya yolunu
elde eder. Örneğin, /icons dizinini etkinleştirmek için şu
yazılabilir:
AliasMatch "^/icons(.*)" "/usr/local/apache/icons$1"
Düzenli ifadelerin tamamı
kullanılabilmektedir. Örneğin, URL-yolu ile harf
büyüklüğüne duyarsız eşleşmeler sağlayacak takma adlar
kullanılabilir:
AliasMatch "(?i)^/image(.*)" "/ftp/pub/image$1"
Alias
ve AliasMatch yönergeleri
arasındaki başlıca fark Alias
yönergesinin, URI'nin ek parçasını, eşleşen parçayı geçip sağ tarafta
dosya yolunun ucuna kendiliğinden kopyalamasıdır. AliasMatch bunu böyle yapmaz. Yani hemen
her durumda, düzenli ifadenin istenen URI'nin tamamıyla baştan sona
eşleşmesi ve yer değiştirmeyi sağ tarafta yapması istenir.
Başka bir deyişle, basitçe
Alias yerine
AliasMatch yazmakla aynı etkiyi
alamazsınız. En azından düzenli ifadenin başına bir ^ ve
sonuna bir (.*)$, ikinci değiştirgenin sonuna da bir
$1 eklemeniz gerekir.
Örneğin aşağıdakini AliasMatch ile değiştirmek isteyelim:
Alias "/image/" "/ftp/pub/image/"
Bu eşdeğer DEĞİLdir - bunu yapmayın! Bu herhangi bir yerinde /image/ dizgesi bulunan tüm istekleri /ftp/pub/image/ altına gönderecektir:
AliasMatch "/image/" "/ftp/pub/image/"
Aynı etkiyi elde etmek için bu gerekiyor:
AliasMatch "^/image/(.*)$" "/ftp/pub/image/$1"
Şüphesiz, Alias yönergesini
çalıştığı yerde AliasMatch
kullanmanın hiç gereği yoktur. AliasMatch daha karmaşık şeyler yapmamızı sağlar. Örneğin
farklı dosya çeşitlerini farklı dizinlerden sunmak isteyelim:
AliasMatch "^/image/(.*)\.jpg$" "/files/jpg.images/$1.jpg" AliasMatch "^/image/(.*)\.gif$" "/files/gif.images/$1.gif"
İstek URL'sinin başındaki bölü çizgileri, bu modüldeki yönergeler istek URL-yolu ile eşleştirilmeye çalışılmadan önce sunucu tarafından yokedilir.
| Açıklama: | Map the full path after the alias in a location. |
|---|---|
| Sözdizimi: | AliasPreservePath OFF|ON |
| Öntanımlı: | AliasPreservePath OFF |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Temel |
| Modül: | mod_alias |
| Uyumluluk: | 2.4.58 and later |
Bu yönergenin belgesi henüz Türkçeye çevrilmedi. Lütfen İngilizce sürümüne bakınız.
| Açıklama: | İstemciyi, bir yönlendirme isteği döndürerek farklı bir URL’ye yönlendirir. |
|---|---|
| Sözdizimi: | Redirect [durum] [URL-yolu]
URL |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_alias |
Redirect yönergesi istemciye bir yönlendirme
isteği döndürerek eski URL’yi yenisiyle eşler.
Eski URL-yolu bir bölü çizgisi ile başlar ve harf
büyüklüğüne duyarlıdır (% imlemesi çözüldükten sonra).
URL-yolu olarak göreli yollara izin verilmez.
URL ise ya bir şema ve konak ismi ile başlayan
bir mutlak URL ya da bir bölü çizgisi ile başlayan bir URL yolu olabilir.
İkinci durumda URL yolunun başına geçerli sunucu ismi ve şemayı sunucu
ekler.
URL-yolu ile başlayan istekler istemciye hedef
URL konumuna bir yönlendirme isteği olarak
dönecektir. URL-yolu’nun devamı niteliğindeki ek
yol hedef URL’ye eklenir.
# Farklı bir konaktaki bir URL'ye yönlendirme Redirect "/hizmet" "http://iki.example.com/hizmet" # Aynı konak üzerinde yönlendirme Redirect "/bir" "/iki"
İstemcinin yaptığı http://example.com/hizmet/fesmekan.txt
isteğine karşılık istemciye isteği
http://iki.example.com/hizmet/fesmekan.txt olarak yapması
söylenecektir. Bu GET isteklerinde de geçerlidir. Örneğin,
http://example.com/hizmet/foo.pl?q=23&a=42 isteği
http://iki.example.com/hizmet/foo.pl?q=23&a=42 adresine
yönlendirilir. POST'ların iptal edileceğini unutmayın.
Sadece tam yol parçaları eşleştirilir, bu nedenle
http://example.com/hizmetfesmekan.txt isteği yukarıdaki
yönlendirme ile eşleşmeyecektir. İfade
sözdizimi kullanılan daha karmaşık eşleşmeler için URL-yolu seçeneği
aşağıda açıklandığı gibi yoksayılır. Düzenli ifadelerin kullanıldığı daha
karmaşık eşleşmeler için RedirectMatch
yönergesine de bakınız.
Yapılandırma dosyasında yer alış sırasına bakmaksızın
Redirect yönergeleri
Alias ve ScriptAlias
yönergelerinden önce ele alınır. <Location> bölümü içinde kullanılmış bir
Redirect yönergesi URL-yolu belirtilmiş
Redirect ve Alias
yönergelerine göre önceliklidir.
Herhangi bir durum belirtilmemişse "geçici"
yönlendirme (HTTP durum kodu: 302) yapılır. Bu, istemciye özkaynağın
geçici olarak başka yere taşındığını belirtir. Diğer HTTP durum
kodlarını döndürmek için kullanılabilecek durum
değerleri:
permanenttempseeothergoneURL
belirtilmez.Diğer durum kodları için durum değiştirgesiyle
sayısal durum kodu belirtilir. Eğer durum 300 ile 399 arasındaysa bir
URL belirtmek gereklidir. Aksi takdirde,
URL bileşeni ihmal edilmelidir. Belirtilecek durum kodunun
geçerli bir HTTP Status kodu olmalı ve Apache HTTP Sunucusu kodu
bilmelidir (http_protocol.c dosyasında bulunan
send_error_response işlevine bakınız).
Redirect permanent "/bir" "http://example.com/iki" Redirect 30" "/yedi" http://example.com/baskabisey"
Eğer Redirect yönergesi URL-yolu belirtilmemiş
bir <Location>
veya <LocationMatch>
bölümü içinde yer alıyorsa, URL seçeneği ifade
sözdizimi kullanılarak yorumlanır.
Bu sözdizimi Apache 2.4.19 ve sonrasında kullanılabilir.
<Location "/bir">
Redirect permanent "http://example.com/iki"
</Location>
<Location "/yedi">
Redirect 303 "http://example.com/baskabisey"
</Location>
<LocationMatch "/error/(?<NUMBER>[0-9]+)">
Redirect permanent "http://example.com/errors/%{env:MATCH_NUMBER}.html"
</LocationMatch>
| Açıklama: | Geçerli URL ile eşleşen bir düzenli ifadeye dayanarak bir harici yönlendirme gönderir. |
|---|---|
| Sözdizimi: | RedirectMatch [durum] düzenli-ifade
URL |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_alias |
Bu yönerge URL-yolu ile eşleşmek üzere bir
düzenli ifade kabul etmesi dışında
Redirect yönergesine
eşdeğerdir. Belirtilen düzenli ifade URL-yolu ile
eşleşiyorsa sunucu parantezli eşleşmeleri belirtilen dizgede kullanarak
dosya yolunu elde eder. Örneğin, tüm GIF dosyası isteklerini başka bir
sunucudaki aynı isimli JPEG dosyalarına yönlendirmek için şu
yazılabilir:
RedirectMatch "(.*)\.gif$" "http://baska.example.com$1.jpg"
Alias ve
AliasMatch arasındaki farklarla
ilgili hususlar Redirect ve
RedirectMatch arasındakilere de
uygulanır. Ayrıntılar için AliasMatch yönergesine bakınız.
| Açıklama: | İstemciyi, kalıcı bir yönlendirme isteği döndürerek farklı bir URL’ye yönlendirir. |
|---|---|
| Sözdizimi: | RedirectPermanent URL-yolu URL |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_alias |
Bu yönerge istemciye daima kalıcı yönlendirme durumu (301) döndürür.
Yani, Redirect permanent ile aynı işi yapar.
| Açıklama: | Allows relative redirect targets. |
|---|---|
| Sözdizimi: | RedirectRelative On|Off |
| Öntanımlı: | RedirectRelative Off |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Temel |
| Modül: | mod_alias |
| Uyumluluk: | 2.4.58 and later |
Bu yönergenin belgesi henüz Türkçeye çevrilmedi. Lütfen İngilizce sürümüne bakınız.
| Açıklama: | İstemciyi, geçici bir yönlendirme isteği döndürerek farklı bir URL’ye yönlendirir. |
|---|---|
| Sözdizimi: | RedirectTemp URL-yolu URL |
| Bağlam: | sunucu geneli, sanal konak, dizin, .htaccess |
| Geçersizleştirme: | FileInfo |
| Durum: | Temel |
| Modül: | mod_alias |
Bu yönerge istemciye daima geçici yönlendirme durumu (302) döndürür.
Yani, Redirect temp ile aynı işi yapar.
| Açıklama: | Bir URL’yi dosya sistemindeki bir yere eşler ve hedefi bir CGI betiği olarak çalıştırır. |
|---|---|
| Sözdizimi: | ScriptAlias [URL-yolu]
dosya-yolu|dizin-yolu |
| Bağlam: | sunucu geneli, sanal konak, dizin |
| Durum: | Temel |
| Modül: | mod_alias |
Hedef dizini, mod_cgi modülünün CGI betiği
yorumlayıcısı tarafından çalıştırılacak betikleri içeren dizin olarak
imlemesi dışında Alias
yönergesinin yaptığı işi yapar. URL-yolu ile
başlayan harf büyüklüğüne duyarlı URL’ler (% imlemesi çözüldükten
sonra), dosya sistemindeki bir tam yol olarak belirtilmiş
dizin-yolu ile başlayan betiklerle eşlenir.
ScriptAlias "/cgi-bin/" "/siteler/cgi-bin/"
http://example.com/cgi-bin/foo şeklindeki bir istek
sunucunun /siteler/cgi-bin/foo betiğini çalıştırmasına sebep
olur. Bu yapılandırma aslında şuna eşdeğerdir:
Alias "/cgi-bin/" "/siteler/cgi-bin/"
<Location "/cgi-bin">
SetHandler cgi-script
Options +ExecCGI
</Location>
ScriptAlias yönergesini bir betik veya eylemci
ile birlikte de kullanabilirsiniz. Örnek:
ScriptAlias "/cgi-bin/" "/siteler/cgi-handler.pl"
Bu senaryoda /cgi-bin/’den istenen tüm dosyalar sizin
belirttiğiniz dosya tarafından işleme sokulacaktır. Bu yöntemle kendi
özel eylemcinizi kullanabilirsiniz. İsterseniz, bunu içerik eklemek
ya da ısmarlama bir eylem için bir CGI sarmalayıcısı olarak da
kullanabilirsiniz.
DocumentRoot altına koymayınız.
ScriptAlias yönergesi URL’yi doğru yere
eşlemekten başka orayı bir CGI betikleri dizini olarak imler. CGI
betiklerinizi DocumentRoot altına
koyarsanız çalıştırmak için ScriptAlias değil,
<Directory>,
SetHandler ve Options yönergelerini örnekteki gibi kullanın:
<Directory "/usr/local/apache2/htdocs/cgi-bin" >
SetHandler cgi-script
Options ExecCGI
</Directory>
Aynı dosya sistemi konumu ile çok sayıda URL-yolu
eşleşebileceğinden, bir Directory
bölümü ile sınırlanmadığı takdirde CGI betiklerinin kaynak kodları açığa
çıkabilir; bu bakımdan ScriptAlias yönergesini yok
sayan URL yollarının belirtilebilme olasılığı gözardı
edilmemelidir.Eğer ScriptAlias yönergesi URL-yolu belirtilmemiş
bir <Location>
veya <LocationMatch>
bölümü içinde yer alıyorsa, URL seçeneği ifade
sözdizimi kullanılarak yorumlanır.
Bu sözdizimi Apache 2.4.19 ve sonrasında kullanılabilir.
<Location "/cgi-bin">
ScriptAlias "/siteler/cgi-bin/"
</Location>
<LocationMatch "/cgi-bin/errors/(?<NUMBER>[0-9]+)">
ScriptAlias "/siteler/cgi-bin/errors/%{env:MATCH_NUMBER}.cgi"
</LocationMatch>
| Açıklama: | Bir URL’yi dosya sistemindeki bir yere düzenli ifade kullanarak eşler ve hedefi bir CGI betiği olarak çalıştırır. |
|---|---|
| Sözdizimi: | ScriptAliasMatch düzenli-ifade
dosya-yolu|dizin-yolu |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Temel |
| Modül: | mod_alias |
Bu yönerge URL-yolu ile eşleşmek üzere bir
düzenli ifade kabul etmesi dışında
ScriptAlias yönergesine
eşdeğerdir. Belirtilen düzenli ifade URL-yolu ile
eşleşiyorsa sunucu parantezli eşleşmeleri belirtilen dizgede kullanarak
dosya yolunu elde eder. Örneğin, standart /cgi-bin dizinini
etkin kılmak için şu yazılabilir:
ScriptAliasMatch "^/cgi-bin(.*)" "/usr/local/apache/cgi-bin$1"
AliasMatch yönergesindeki gibi, düzenli
ifadelerin tamamı tüm güçleriyle kullanılabilmektedir.
Örneğin, URL-yolu için harf büyüklüğüne duyarsız
eşleşmeli bir takma ad oluşturmak mümkünür:
ScriptAliasMatch "(?i)^/cgi-bin(.*)" "/usr/local/apache/cgi-bin$1"
Alias ve
AliasMatch arasındaki farklarla
ilgili hususlar ScriptAlias ve
ScriptAliasMatch arasındakilere
de uygulanır. Ayrıntılar için AliasMatch yönergesine bakınız.
Apache HTTP サーバ バージョン 2.4
| 説明: | 基本認証 |
|---|---|
| ステータス: | Base |
| モジュール識別子: | auth_basic_module |
| ソースファイル: | mod_auth_basic.c |
| 互換性: | Apache 2.1 以降 |
与えられたプロバイダ (訳注: 認証での照会を行う問い合わせ先)
でユーザを検索し、HTTP 基本認証でアクセス制限できるようになります。
HTTP ダイジェスト認証については mod_auth_digest
で提供されます。このモジュールを使う際はこのモジュールのほかに
mod_authn_file といった認証モジュールと、
mod_authz_user といった承認モジュールとの両方を、
それぞれひとつ以上組み合わせて使うことになります。
AuthNameAuthTypeRequireRejectSatisfy (Deprecated)<SatisfyAll><SatisfyOne>| 説明: | 認証と承認を、より低いレベルのモジュールに移行させるかを 設定します。 |
|---|---|
| 構文: | AuthBasicAuthoritative On|Off |
| デフォルト: | AuthBasicAuthoritative On |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Base |
| モジュール: | mod_auth_basic |
通常は、AuthBasicProvider
ディレクティブで指定した承認モジュールを順に使ってユーザを検査しようとして、
どのプロバイダでもユーザを検査できなかった場合、アクセス拒否します。
AuthBasicAuthoritative を Off
と明示的に設定すると ユーザ ID がなかったり、
ルールがなかったりする際に、認証と承認の両方について、
プロバイダー機構で実装されていないモジュールに処理を移行させることができます。
AuthBasicProvider
ディレクティブで設定できないサードパーティ製のモジュールと、
mod_auth_basic
とを組み合わせるときにのみ必要になるでしょう。
そのようなモジュールを使う場合、処理順序はモジュールのソースコードが
どうなっているかによって決まり、処理順序を指定することはできません。
| 説明: | Fake basic authentication using the given expressions for username and password |
|---|---|
| 構文: | AuthBasicFake off|username [password] |
| デフォルト: | none |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Base |
| モジュール: | mod_auth_basic |
| 互換性: | Apache HTTP Server 2.4.5 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | この位置に対する認証プロバイダを設定します。 |
|---|---|
| 構文: | AuthBasicProvider provider-name
[provider-name] ... |
| デフォルト: | AuthBasicProvider file |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Base |
| モジュール: | mod_auth_basic |
AuthBasicProvider ディレクティブで、
この位置に対するユーザ認証に用いられる認証プロバイダを設定します。
デフォルトになっている file プロバイダは
mod_authn_file モジュールで実装されています。
指定したプロバイダを実装しているモジュールが、
必ずサーバに組み込まれているようにしてください。
<Location /secure>
AuthType basic
AuthName "private area"
AuthBasicProvider dbm
AuthDBMType SDBM
AuthDBMUserFile /www/etc/dbmpasswd
Require valid-user
</Location>
認証プロバイダは mod_authn_dbm,
mod_authn_file,
mod_authn_dbd,
mod_authnz_ldap で実装されています。
| 説明: | Check passwords against the authentication providers as if Digest Authentication was in force instead of Basic Authentication. |
|---|---|
| 構文: | AuthBasicUseDigestAlgorithm MD5|Off |
| デフォルト: | AuthBasicUseDigestAlgorithm Off |
| コンテキスト: | ディレクトリ, .htaccess |
| 上書き: | AuthConfig |
| ステータス: | Base |
| モジュール: | mod_auth_basic |
| 互換性: | Apache HTTP Server 2.4.7 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
Apache HTTP Server Version 2.4
| : | DBM |
|---|---|
| : | Extension |
| : | authz_dbm_module |
| ҽ: | mod_authz_dbm.c |
| : | ġ 2.1 ĺ |
Ϻθ
ִ Ͽ Ѻο Ѵ.
mod_authz_groupfile ϴ.
| : | ϴ ͺ̽ ϸ Ѵ |
|---|---|
| : | AuthDBMGroupFile file-path |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Extension |
| : | mod_authz_dbm |
AuthDBMGroupFile þ
ϴ DBM ϸ Ѵ.
File-path ̴.
ڸ Ű Ѵ. ڿ ǥ ڰ ̴. ̳ ݷ .
AuthDBMGroupFile
ۿ ġ Ȯ϶. ȣ 丮
ȿ . , Ŭ̾Ʈ
AuthDBMGroupFile ٿε
ִ.
DBM ϰ ȣ DBM ϱ: ڿ ȣ θ ͺ̽ ϴ ﶧ ִ. ۼ α . α DBM ϸ װ ȴ. ϰ ȣ DBMϷ ϸ ϴ:
AuthDBMGroupFile /www/userbase
AuthDBMUserFile /www/userbase
DBM Ű ڸ̴.
ڵ ȣ : [ : () ]
ȣ κ ڵ ȣ̴. ݷ ڿ ǥ ´. ٽ ݷ ٸ ִ. κ Ѵ. www.telescope.org ̷ ȣ ͺ̽ ͺ̽ Ѵ.
| : | ȣ ϴ ͺ̽ Ѵ |
|---|---|
| : | AuthzDBMType default|SDBM|GDBM|NDBM|DB |
| ⺻: | AuthzDBMType default |
| : | directory, .htaccess |
| Override ɼ: | AuthConfig |
| : | Extension |
| : | mod_authz_dbm |
ȣ α ͺ̽ ϵ ؾ Ѵ.
Apache HTTP サーバ バージョン 2.4
| 説明: | ファイルの所有者に基づいた承認 |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | authz_owner_module |
| ソースファイル: | mod_authz_owner.c |
| 互換性: | Apache 2.1 以降で使用可能 |
このモジュールはリクエストされたファイルのファイルシステムの
所有者やグループを HTTP 認証に使われたユーザ ID (ウェブユーザ ID) と
比較することでアクセスを承認します。提供されたユーザ名とパスワードは
mod_auth_basic や
mod_auth_digest のような認証モジュールで既に
適切に検証されている必要があります。mod_authz_owner
は以下のように、Require ディレクティブの file-owner と
file-group という二つの引数を認識します:
file-ownerjones により所有されている
と言ったときは、ウェブからのアクセスに使われるユーザ名も
jones でなければなりません。file-groupmod_authz_groupfile や mod_authz_dbm
により提供されるグループデータベースに存在していて、
ウェブユーザ名がそのグループに属していなければなりません。
例えば、オペレーティングシステムがファイルは (システムの) グループ
accounts により所有されていると言ったときは、
accounts がグループデータベースに存在して、
リクエストに使用されたウェブユーザ名がそのグループに属している
必要があります。ファイルシステムに実際には存在しないリソース
(つまり バーチャルなリソース) の承認に
mod_authz_owner が使用されたときは、
アクセスは拒否されます。
特に、コンテント ネゴシエーションされた"MultiViews" のリソースは 決して承認しません。
このモジュールにディレクティブはありません。
複数ユーザのシステムで Apache ウェブサーバが実行されていて、
~/public_html/private に各ユーザがファイルを置いているとします。
AuthDBMUserFile
データベースが一つだけあり、すべてのウェブユーザ名が列挙されており、
このユーザ名がサーバで実際にファイルを所有しているユーザ名と一致している場合、
次の節のような設定で、ユーザが自分自身のファイルにアクセスできるようになります。
/home/smith/public_html/private の中のファイルは、所有者が
smith の代わりに jones になっていない限り、
jones にはアクセスは許可されません。
<Directory /home/*/public_html/private>
AuthType Basic
AuthName MyPrivateFiles
AuthBasicProvider dbm
AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all
Require file-owner
</Directory>
上記のようなシステムで、数人のユーザがプロジェクトのファイルを
~/public_html/project-foo で共有しているとします。
ファイルはシステムのグループ foo に所有されていて、
AuthDBMGroupFile
データベースが一つだけあり、そこにすべてのウェブユーザ名と
グループのメンバが列挙されている、つまり、それらの
ユーザは少なくとも foo というグループに属している、とします。
jones とsmith の二人共がグループ
foo のメンバである場合、どちらの人も両方の
project-foo にアクセスが許可されます。
<Directory /home/*/public_html/project-foo>
AuthType Basic
AuthName "Project Foo Files"
AuthBasicProvider dbm
# combined user/group database
AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all
AuthDBMGroupFile /usr/local/apache2/etc/.htdbm-all
Satisfy All
Require file-group
</Directory>
Apache HTTP Server Version 2.4
Apache HTTP サーバ バージョン 2.4
この文書は Apache の各 モジュール を説明するために 使われている用語を説明します。
モジュールの目的の短い説明。
これは、そのモジュールが Apache ウェブサーバにどれくらい密接に組み込まれているかを示します。 言い換えれば、モジュールを組み込み、その機能を利用するために、 サーバを再コンパイルする必要があるかもしれないということを示します。 この属性が取り得る値は以下のものです:
これは単純に、
そのモジュールに必要なコードを含むソースファイルの名前を列挙したものです。
これは、<IfModule>
ディレクティブで使用される名前でもあります。
この文字列は、モジュールの動的読み込みを行なうときに使用する LoadModule
ディレクティブにおいて使用されるモジュールの識別子です。
詳しく書くと、ソースファイル内の module タイプの外部変数の名前です。
あるモジュールが Apache バージョン 2 の配布に含まれていなかった場合、 そのモジュールが導入されたバージョンがここに書かれています。 また、モジュールが特定のプラットフォームにのみ存在するときも 詳細はここに書かれています。
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Unix ailesi platformlar için temel (gerekli) güvenlik. |
|---|---|
| Durum: | Temel |
| Modül Betimleyici: | unixd_module |
| Kaynak Dosyası: | mod_unixd.c |
| Açıklama: | Sunucunun başlatıldıktan sonra chroot(8) yapacağı dizini belirler. |
|---|---|
| Sözdizimi: | ChrootDir /dizin/yolu |
| Öntanımlı: | none |
| Bağlam: | sunucu geneli |
| Durum: | Temel |
| Modül: | mod_unixd |
| Uyumluluk: | Apache HTTP Sunucusunun 2.2.10 and laterve sonraki sürümlerinde kullanılabilir. |
Bu yönerge sunucuya başlatıldıktan sonra ağdan gelen istekleri kabul etmeden önce belirtilen dizine chroot(8) yapmasını söyler.
Sunucuyu chroot altında çalıştırmanın basit bir işlem olmadığına ve özellikle CGI veya PHP gibi betikler çalıştırıyorsanız ek ayarlamalar yapmanız gerektiğine dikkat ediniz. Lütfen, bu özelliği kullanmaya çalışmadan önce chroot işlemleri hakkında gerektiği kadar bilgi sahibi olduğunuzdan emin olunuz.
| Açıklama: | İsteklere yanıt verecek sunucunun ait olacağı grubu belirler. |
|---|---|
| Sözdizimi: | Group unix-grubu |
| Öntanımlı: | Group #-1 |
| Bağlam: | sunucu geneli |
| Durum: | Temel |
| Modül: | mod_unixd |
Group yönergesi, sunucunun hangi grup altında
isteklere yanıt vereceğini belirler. Bu yönergenin uygulanabilmesi için
sunucunun root olarak çalıştırılmış olması gerekir.
Sunucuyu root dışında bir kullanıcı başlattığı takdirde,
sunucu belirtilen gruba geçemez ve kullanıcının kendi grubunda
çalışmaya devam eder. unix-grubu şunlardan biri olabilir:
# ardından grup numarasıGroup www-group
Çalışan sunucu için özellikle yeni bir grup atamanız önerilir. Bazı
sistem yöneticileri nobody grubunu kullanırlar fakat
bu her zaman mümkün olmadığı gibi arzulanan da değildir.
Ne yaptığınızı ve ne tehlikelere yol açacağınızı bilmiyorsanız
Group (veya User) yönergesine değer olarak
root atamayınız.
| Açıklama: | suEXEC özelliğini etkin veya etkisiz yapar |
|---|---|
| Sözdizimi: | Suexec On|Off |
| Öntanımlı: | suexec çalıştırılabiliri uygun sahip ve kip ile mevcutsa On, değilse
Off |
| Bağlam: | sunucu geneli |
| Durum: | Temel |
| Modül: | mod_unixd |
On olduğunda, suexec çalıştırılabiliri yoksa veya dosya kipi ve sahibi geçersizse httpd başlatılamaz.
Off olduğunda, suexec çalıştırılabiliri varsa ve hatta dosya kipi ve sahibi geçerli olsa bile suEXEC özelliği iptal edilir.
| Açıklama: | İsteklere yanıt verecek sunucunun ait olacağı kullanıcıyı belirler. |
|---|---|
| Sözdizimi: | User unix-kullanıcısı |
| Öntanımlı: | User #-1 |
| Bağlam: | sunucu geneli |
| Durum: | Temel |
| Modül: | mod_unixd |
User yönergesi, sunucunun hangi kullanıcı olarak
isteklere yanıt vereceğini belirler. Bu yönergenin uygulanabilmesi için
sunucunun root olarak çalıştırılmış olması gerekir.
Sunucuyu root dışında bir kullanıcı başlattığı takdirde,
sunucu belirtilen kullanıcıya geçemez ve mevcut kullanıcıyla çalışmaya
devam eder. Eğer sunucuyu root olarak başlatmışsanız ana
süreç root olarak çalışmaya devam edecektir. unix-kullanıcısı
şunlardan biri olabilir:
# ardından kullanıcı numarasıBu yönergede belirtilecek kullanıcının, başkaları tarafından üzerinde
değişiklik yapılabilecek dosyalardan başkasına erişemeyen bir kullanıcı
olmaması gerektiği gibi, HTTP isteklerini işlemek dışında işlemler de
yapabilen bir kullanıcı olmamalıdır.
Çalışan sunucu için özellikle yeni bir grup atamanız önerilir. Bazı
sistem yöneticileri nobody kullanıcısını kullanırlar fakat
nobody kullanıcısı sistemde başka amaçlarla
kullanılabildiğinden bu her zaman mümkün olmadığı gibi arzulanan da
değildir.
Ne yaptığınızı ve ne tehlikelere yol açacağınızı bilmiyorsanız
User (veya Group) yönergesine değer olarak
root atamayınız.
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Kullanıcılara özel dizinler |
|---|---|
| Durum: | Temel |
| Modül Betimleyici: | userdir_module |
| Kaynak Dosyası: | mod_userdir.c |
Bu modül kullanıcılara özel dizinlere
http://example.com/~kullanıcı/ sözdizimi kullanılarak
erişilebilmesini mümkün kılar.
| Açıklama: | Kullanıcıya özel dizinlerin yeri |
|---|---|
| Sözdizimi: | UserDir dizin [dizin] ... |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Temel |
| Modül: | mod_userdir |
UserDir yönergesi, bir kullanıcıya ait bir
belge için bir istek yapıldığında, isteğin kullanıcının ev dizininde
bulunan belli bir dizinden karşılanmasını sağlar.
dizin olarak şunlar belirtilebilir:
disabled anahtar sözcüğü. enabled anahtar
sözcüğü ile sonradan etkin kılınmadıkça tüm kullanıcı-dizin
dönüşümlerini iptal eder (aşağıya bakınız).disabled anahtar sözcüğünü takibeden boşluk ayraçlı
kullanıcı isimleri listesi. Bu listede yer alan kullanıcı isimlerine,
sonradan bir enabled listesinde görünse bile, dizin
dönüşümleri asla uygulanmaz.enabled anahtar sözcüğünü takibeden boşluk ayraçlı
kullanıcı isimleri listesi. Genel bir iptal sözkonusu olsa bile,
kullanıcı ismi bir disabled listesinde yer almadıkça, bu
listede yer alan dizinlere dönüşüm uygulanır.Userdir yönergesinde ne enabled ne de
disabled varsa, argüman bir dosya ismi kalıbı olarak ele
alınır ve kullanıcı belge kök dizininin yolunu oluşturmakta kullanılır.
http://example.com/~ali/bir/iki.html şöyle dönüştürülür:
| Kullanılan UserDir yönergesi | Elde edilen yol |
|---|---|
| UserDir public_html | ~ali/public_html/bir/iki.html |
| UserDir /usr/siteler | /usr/siteler/ali/bir/iki.html |
| UserDir /home/*/htdocs | /home/ali/htdocs/bir/iki.html |
Aşağıdaki yönergelerle istemciye gönderilecek yönlendirmeler:
| Kullanılan UserDir yönergesi | Elde edilen yönlendirme |
|---|---|
| UserDir http://example.com/users | http://example.com/users/ali/bir/iki.html |
| UserDir http://example.com/*/usr | http://example.com/ali/usr/bir/iki.html |
| UserDir http://example.com/~*/ | http://example.com/~ali/bir/iki.html |
"UserDir
./" şeklinde bir atama "/~root" isteklerini
"/" dizinine yönlendirir ki bu elbette istenmez. Bu
bakımdan yapılandırmanızda mutlaka bir "UserDir disabled
root" satırının yer almasını tavsiye ederiz. Daha fazla bilgi
için Directory yönergesine ve Güvenlik İpuçları sayfasına
bakınız.
Diğer örnekler:
Bir kaç kullanıcı hariç kalan herkesin UserDir
dizinlerini iptal etmek için şunu yapabilirsiniz:
UserDir disabled UserDir enabled birey1 birey2 birey3
Bir kaç kullanıcı hariç kalan herkesin UserDir
dizinlerini etkin kılmak için şunu yapabilirsiniz:
UserDir disabled birey4 birey5 birey6
Birden fazla dizin belirtmek de mümkündür:
Userdir "public_html" "/usr/siteler" "http://example.com/"
Bu örneğe göre, http://example.com/~ali/bir/iki.html
şeklinde bir istek alındığında sunucu önce
http://example.com/~ali/bir/iki.html yönlendirmesini
deneyecektir. Onu bulamazsa isteği
/usr/siteler/ali/bir/iki.html dosyasını arayacak onu da
bulamazsa istemciyi http://example.com/ali/bir/iki.html
adresine yönlendirecektir.
Argüman listesine bir yönlendirme ekleyecekseniz, bu, listenin son elemanı olmalıdır. Apache httpd yönlendirmenin başarılı sonuç verip vermediğini bilemeyecektir. Bu bakımdan, listede bu yönlendirmeden sonra bir yönlendirme daha bulunması daha iyi olacaktır.
Kullanıcı dizini dönüşümü Apache 2.1.4 sürümü ve sonrasında öntanımlı
olarak etkin değildir. Daha önceki sürümlerde bir
UserDir yönergesinin yokluğunda
UserDir public_html öntanımlıydı.
Etkinleştirilen ve etkisizleştirilen kullanıcılara özgü listeler küresel etki alanından sanal konak etki alanına aktarılırken yer değiştirme yapılır, mevcutla birleştirilmez.
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Kitlesel sanal konakların devingen olarak yapılandırılmasını sağlar |
|---|---|
| Durum: | Eklenti |
| Modül Betimleyici: | vhost_alias_module |
| Kaynak Dosyası: | mod_vhost_alias.c |
Bu modül, hangi dosyaların sunulacağını saptamak için dosya yolunun
parçası olarak HTTP isteğinin Host: başlığının ve/veya IP
adresinin kullanılmasını mümkün kılarak devingen yapılandırmalı sanal
konaklar oluşturur. Böylece benzer yapılandırmaya sahip çok büyük sayıda
sanal konak kullanımı kolaşlaşır.
URI’leri dosya isimlerine dönüştürmek için mod_alias
veya mod_userdir kullanılmışsa bunlar
mod_vhost_alias yönergeleri tarafından aşağıda
açıklandığı gibi geçersiz kılınırlar. Örneğin, aşağıdaki yapılandırma
her durumda /cgi-bin/script.pl betiğini
/usr/local/apache2/cgi-bin/script.pl betiğine eşleyecektir:
ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/" VirtualScriptAlias "/nerede/bilinmiyor/%0/cgi-bin/"
Bu modüldeki tüm yönergeler bir dizgeyi bir dosya yoluna dönüştürerek
çalışırlar. Dönüşüm dizgesi (bundan sonra “isim” diyeceğiz) ya sunucu
ismi olur (bunun nasıl belirlendiğini öğrenmek için UseCanonicalName yönergesine bakınız) ya da
sunucu üzerindeki sanal konağın IP adresi olur. Dönüşümü,
printf’inkilerin benzeri birkaç biçem belirteci
denetler:
%% |
Bir % imi yerleştirir. |
%p |
Sanal konağın IP adresini yerleştirir. |
%N.M |
İsmin parçalarını yerleştirir. |
N ve M ismin alt dizgelerini belirtmek için
kullanılır. N, ismin noktalarla ayrılmış bileşenlerinden
seçim yaparken M, N ile seçilen parçadan
karakter seçmekte kullanılır. M isteğe bağlı olup mevcut
olmaması halinde öntanımlı olarak sıfırdır. Noktanın varlığı
M’nin varlığına bağlıdır. Dönüşüm şöyle uygulanır:
0 |
ismin tamamı |
1 |
ilk parça |
2 |
ikinci parça |
-1 |
son parça |
-2 |
sondan bir önceki parça |
2+ |
ikinci parça ve sonraki parçaların hepsi |
-2+ |
sondan bir önceki parça ve daha önceki parçaların hepsi |
1+ ve -1+ |
0 ile aynı |
N veya M parça sayısından büyükse dönüşüm
dizgesi sadece alt çizgi karakterini içerir.
Sunucu yapılandırma dosyanızda isme dayalı sanal konaklar için aşağıdaki yönergeler kullanılıyor olsun:
UseCanonicalName Off VirtualDocumentRoot "/usr/local/apache/sankonlar/%0"
http://example.com/dizin/dosya.html için yapılan bir istek
/usr/local/apache/sankonlar/example.com/dizin/dosya.html
dosyası ile yerine getirilecektir.
Çok büyük sayıda sanal konak için sankonlar dizininin
boyutlarını küçük tutmak amacıyla dosyalar düzenlenebilir. Bunu
yapılandırma dosyanızda şöyle yapabilirsiniz:
UseCanonicalName Off VirtualDocumentRoot "/usr/local/apache/sankonlar/%3+/%2.1/%2.2/%2.3/%2"
http://falan.filan.example.com/dizin/dosya.html için
yapılan bir istek
/usr/local/apache/sankonlar/example.com/f/i/l/filan/dizin/dosya.html
ile yerine getirilecektir.
Bu sefer de parçaları ismin sonundan toplayalım:
VirtualDocumentRoot "/usr/local/apache/sankonlar/%3+/%2.-1/%2.-2/%2.-3/%2"
Bu durumda istek
/usr/local/apache/sankonlar/example.com/n/a/l/filan/dizin/dosya.html
ile karşılanırdı.
Şöyle bir şey de yapabilirsiniz:
VirtualDocumentRoot "/usr/local/apache/sankonlar/%3+/%2.1/%2.2/%2.3/%2.4+"
Bu örnek için istek
/usr/local/apache/sankonlar/example.com/f/i/l/an/dizin/dosya.html
dosyasından karşılanırdı.
Kullanıcıların çoğunun ortak isteği, istenen konak adının uzunluğu veya
sayısı için endişelenmeksizin çok sayıda belge köküne çok sayıda alan
adından erişilebilmesidir. Eğer istenen konak adı
www.domain.example.com değil de
sub.www.domain.example.com ise %3+ kullanımı, belge kök
dizininin düşünüldüğü gibi example.com değil
/usr/local/apache/vhosts/domain.example.com/... olmasını
sağlar. Böyle durumlarda, daima alan adı ve tld ile sonuçlanan
%-2.0.%-1.0 birleşiminin kullanımı daha yararlı olabilir.
Böylece, tüm ilk, ikinci ve üçüncü seviye alt alan adlarını aynı dizine
yönlendirecek bir yapılandırma yapılabilir:
VirtualDocumentRoot "/usr/local/apache/vhosts/%-2.0.%-1.0"
Yukarıdaki örnekte, example.com,
www.example.com ve hatta www.sub.example.com
bile /usr/local/apache/vhosts/example.com dizinine
yönlendirilecektir.
IP’ye dayalı sanal konaklar için yapılandırma dosyanızda şu satırlar olabilirdi:
UseCanonicalName DNS VirtualDocumentRootIP "/usr/local/apache/sankonlar/%1/%2/%3/%4/belgeler" VirtualScriptAliasIP "/usr/local/apache/sankonlar/%1/%2/%3/%4/cgi-bin"
http://falan.filan.example.com/dizin/dosya.html için
yapılan bir istek eğer falan.filan.example.com’un IP adresi
10.20.30.40 olsaydı,
/usr/local/apache/sankonlar/10/20/30/40/belgeler/dizin/dosya.html
dosyası ile karşılanırdı.
http://falan.filan.example.com/cgi-bin/betik.pl için yapılan
bir istek ise
/usr/local/apache/sankonlar/10/20/30/40/cgi-bin/betik.pl
betiğinin çalıştırılması ile sağlanırdı.
Bir VirtualDocumentRoot yönergesinin .
karakterini içermesini isterseniz, bir biçem belirteci ile karışıklığa
sebep olmaksızın bunu şöyle sağlayabilirsiniz:
VirtualDocumentRoot "/usr/local/apache/sankonlar/%2.0.%3.0"
Bu durumda http://falan.filan.example.com/dizin/dosya.html
için yapılan bir istek
/usr/local/apache/sankonlar/filan.mesela/dizin/dosya.html
dosyası ile karşılanacaktır.
LogFormat yönergesinin
%V ve %A biçem belirteçleri bu modülle
birlikte kullanıldığında çok yararlı olurlar.
| Açıklama: | Bir sanal konağın belge kök dizinini devingen olarak yapılandırır. |
|---|---|
| Sözdizimi: | VirtualDocumentRoot hesaplanan-dizin|none |
| Öntanımlı: | VirtualDocumentRoot none |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Eklenti |
| Modül: | mod_vhost_alias |
VirtualDocumentRoot yönergesi sunucu ismine göre
belgelerin bulunacağı yeri Apache HTTP Sunucusunun saptamasını sağlar.
hesaplanan-dizin’in dönüşüm sonucu DocumentRoot yönergesinin değeriymiş gibi
belge ağacının kök dizini olarak kullanılır.
hesaplanan-dizin yerine none
belirtilmişse VirtualDocumentRoot iptal edilmiş
olur. Bu yönerge VirtualDocumentRootIP yönergesinin kullanıldığı bağlamda
yer alamaz.
VirtualDocumentRoot yönergesi aynı bağlamda veya
alt bağlamlarda da kullanılabilen DocumentRoot yönergelerini geçersiz kılar.
Genel sunucu etki alanına bir VirtualDocumentRoot
konulması, daha sonra yer alan her sanal konak tanımı içinde
VirtualDocumentRoot yönergesine None
atamadıkça bu sanal konaklarda yapılmış DocumentRoot atamalarını geçersiz kılacaktır.
| Açıklama: | Bir sanal konağın belge kök dizinini devingen olarak yapılandırır. |
|---|---|
| Sözdizimi: | VirtualDocumentRootIP hesaplanan-dizin|none |
| Öntanımlı: | VirtualDocumentRootIP none |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Eklenti |
| Modül: | mod_vhost_alias |
VirtualDocumentRootIP yönergesi, dizinin
saptanmasında sunucu ismi yerine bağlantının sonlandığı sunucunun IP
adresini kullanması dışında VirtualDocumentRoot gibidir.
| Açıklama: | Bir sanal konağın CGI dizinini devingen olarak yapılandırır. |
|---|---|
| Sözdizimi: | VirtualScriptAlias hesaplanan-dizin|none |
| Öntanımlı: | VirtualScriptAlias none |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Eklenti |
| Modül: | mod_vhost_alias |
VirtualScriptAlias yönergesi, CGI betiklerinin
bulunacağı yeri Apache httpd’nin saptamasını sağlamak bakımından
VirtualDocumentRoot
yönergesinin yaptığını yapar. /cgi-bin/ ile başlayan
istekler için ise ScriptAlias
yönergesinin yaptığını yapar.
| Açıklama: | Bir sanal konağın CGI dizinini devingen olarak yapılandırır. |
|---|---|
| Sözdizimi: | VirtualScriptAliasIP hesaplanan-dizin|none |
| Öntanımlı: | VirtualScriptAliasIP none |
| Bağlam: | sunucu geneli, sanal konak |
| Durum: | Eklenti |
| Modül: | mod_vhost_alias |
VirtualScriptAliasIP yönergesi, dizinin
saptanmasında sunucu ismi yerine bağlantının sonlandığı sunucunun IP
adresini kullanması dışında VirtualScriptAlias gibidir.
Apache HTTP Sunucusu Sürüm 2.4
Bu belgede Apache modüllerini tanımlarken kullanılan terimler açıklanmıştır.
Modülün kullanım amacının kısa bir açıklaması.
Modülün Apache HTTP sunucusuna ne kadar sıkı bağlı olduğunu belirtir. Başka bir deyişle, modüle ve işlevselliğine erişim kazanmak için sunucuyu yeniden derlemek gerekip gerekmediği ile ilgili durumu belirtir. Bu özniteliğin olası değerleri şunlardır:
Karşısına modül kodunu içeren kaynak dosyasının ismi yazılır. Bu isim ayrıca <IfModule> yönergesi tarafından da kullanılır.
Modüller devingen olarak yüklenirken LoadModule yönergesinde kullanmak için modülü betimleyen dizgedir. Aslında, kaynak dosyasında module türündeki harici değişkenin ismidir.
Eğer modül Apache’nin 2. sürüm dağıtımının özgün parçası değilse söz konusu sürüm burada belirtilir. Ayrıca, modülün kullanımı belli platformlarla sınırlıysa bunun ayrıntıları da burada belirtilir.
Apache HTTP サーバ バージョン 2.4
Apache HTTP サーバ バージョン 2.4
| 説明: | CGI スクリプトの実行 |
|---|---|
| ステータス: | Base |
| モジュール識別子: | cgi_module |
| ソースファイル: | mod_cgi.c |
ハンドラ cgi-script
が指定されているファイルは CGI スクリプトとして扱われ、
サーバにより実行され、その出力がクライアントに返されます。
ファイルは、AddHandler
ディレクティブに指定された 拡張子を名前に含むか、
ScriptAlias
ディレクトリに存在することによりこのハンドラになります。
Apache で CGI スクリプトを使用するためのイントロダクションは、 CGI による動的コンテンツ を参照してください。
Unix でマルチスレッドの MPM を使っている場合は、このモジュールの
代わりに mod_cgid を使う必要があります。
ユーザレベルではこの二つのモジュールは本質的には同一です。
後方互換性のため、 MIME タイプが application/x-httpd-cgi
であるファイルでも cgi-script ハンドラが有効になります。この特殊な MIME タイプを
使う方法は非推奨です。
サーバは CGI 規格 で決められている CGI 環境変数を設定します。以下のものは、条件付きで設定されます。
AcceptPathInfo ディレクティブが明示的に off
に設定されている場合は設定されません。デフォルトの、
AcceptPathInfo が
指定されていないときの振る舞いでは、mod_cgi はパス情報
(URI のスクリプトのファイル名の後に続く /more/path/info) を
受け付けますが、コアはサーバはパス情報のあるリクエストに
対して 404 NOT FOUND エラーを返します。AcceptPathInfo
ディレクティブを
省略すると、mod_cgi へのリクエストに対して
On を
設定したのと同じ効果になります。HostnameLookups
が on (デフォルトでは off です)
で、アクセスしているホストのアドレスの DNS
の逆引きが実際にホスト名を見つけたときにのみ設定されます。IdentityCheck
が on に設定されていて、アクセスしているホストが
ident プロトコルをサポートしているときにのみ設定されます。
これは簡単に偽ることができ、クライアントとサーバの間に
プロキシがあればまったく役に立たないので、
この変数の値は信用できないということに注意してください。
CGI スクリプトのデバッグは、正しく動作していないスクリプトの出力 (標準出力とエラー) を調べることができないために、難しい状態が続いていました。 これらのディレクティブはより詳細なエラーのログ収集を提供します。
設定されているときには、CGI エラーログは適切に動作しないすべての CGI をログ収集します。それぞれの正しく動作しない CGI スクリプトは 複数の行にわたる情報がログ収集されます。最初の 2 行は常に以下の書式です:
%% [time] request-line
%% HTTP-status CGI-script-filename
エラーが、CGI スクリプトが実行できないというものである場合は、 ログファイルはさらにもう 2 行書かれます:
%%error
error-message
そうではなく、エラーが正しくないヘッダ情報を返す結果である場合 (スクリプトのバグであることがよくあります)、 以下の情報がログ収集されます:
%request
受け取ったすべての HTTP リクエストヘッダ
(もしあれば) POST や PUT の中身
%response
CGI スクリプトにより出力されたすべてのヘッダ
%stdout
CGI 標準出力
%stderr
CGI 標準エラー
(スクリプトが標準出力や標準エラーに何も出力しなかった場合は、 %stdout や %stderr はありません)。
| 説明: | The length of time to wait for more output from the CGI program |
|---|---|
| 構文: | CGIScriptTimeout time[s|ms] |
| デフォルト: | value of |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Base |
| モジュール: | mod_cgi |
| 互換性: | Available in version 2.4.59 and later. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | CGI スクリプトのエラーログファイルの場所 |
|---|---|
| 構文: | ScriptLog file-path |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_cgi, mod_cgid |
ScriptLog ディレクティブは CGI スクリプトの
エラーログファイルを設定します。ScriptLog が
設定されていないときは、
エラーログは作成されません。設定されているときは、CGI
のエラーはすべて引数として与えられているファイル名にログされます。
相対パスで指定されているときは、
ServerRootからの相対パスとして
扱われます。
ScriptLog logs/cgi_log
このログは子プロセスが実行されているユーザとしてオープンされます。
すなわち、User ディレクティブで指定された
ユーザです。これは、スクリプトログが書かれるディレクトリがそのユーザで
書き込み可能か、スクリプトファイルが手動で作成され、そのユーザで
書き込み可能になっている必要があるということです。スクリプトログを
アクセスログなどのためのログディレクトリに書かれるようにしたときは、
そのディレクトリを子プロセスを実行しているユーザの権限で
書き込み可能にはしないようにしてください。
スクリプトのログ収集は CGI スクリプトを書くときの デバッグ用の機能として意図されていて、通常のサーバで 常に使用されるようには意図されていないということに注意してください。 速度や効率は最適化されておらず、設計された以外の方法で使用されると セキュリティの問題があるかもしれません。
| 説明: | スクリプトログに記録される PUT や POST リクエストの内容の上限 |
|---|---|
| 構文: | ScriptLogBuffer bytes |
| デフォルト: | ScriptLogBuffer 1024 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_cgi, mod_cgid |
大きな本体を受け取ったときにログファイルがすぐに大きくなりすぎる 問題を避けるために、ファイルにログ収集される PUT と POST の本体の大きさは制限されています。デフォルトでは、1024 バイトまでがログ収集されますが、 このディレクティブはそれを変更することができます。
| 説明: | CGI スクリプトのログファイルの大きさの上限 |
|---|---|
| 構文: | ScriptLogLength bytes |
| デフォルト: | ScriptLogLength 10385760 |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_cgi, mod_cgid |
ScriptLogLength は CGI スクリプトのログファイル
の大きさを制限するために使用することができます。ログファイルは
CGI のエラー毎に大量の情報 (リクエストのすべてのヘッダ、
すべての出力)をログしますので、すぐに大きなファイルになります。
この大きさの制限がないことによる問題を防ぐために、
このディレクティブを使って CGI のログファイルの
最大のファイルサイズを設定することができます。
ファイルがこの大きさを超えた場合は、それ以上は書き込まれません。
Apache HTTP Server Version 2.4
| : | ܺ CGI Ͽ CGI ũƮ |
|---|---|
| : | Base |
| : | cgid_module |
| ҽ: | mod_cgid.c |
| : | н 带 ϴ MPMs |
Ʒ ϴ ߰ ScriptSock þ ϰ
mod_cgid mod_cgi
ϰ Ѵ. ġ CGI ڼ
mod_cgi ϶.
н ü ߾ μ
ũ(fork)ϸ ο μ θ μ 带
ؾ ϹǷ δ ȴ. CGI ึ ̷ δ
ʱ mod_cgid CGI ũƮ ϴ
ڽ μ ũϴ ܺ . ּ
н(unix domain socket) Ͽ Ѵ.
Ҷ ߾ MPM ϸ ⺻
mod_cgi Ѵ.
忡 mod_cgi
ϴ. cgi
̸ ϴ ScriptSock þ
߰ ̴.
| : | The length of time to wait for more output from the CGI program |
|---|---|
| : | CGIDScriptTimeout time[s|ms] |
| ⺻: | value of |
| : | ּ, ȣƮ, directory, .htaccess |
| : | Base |
| : | mod_cgid |
| : | Available in httpd 2.4.10 and later; in prior releases no timeout was applied |
The documentation for this directive has not been translated yet. Please have a look at the English version.
Apache HTTP Server Version 2.4
| : | Distributed Authoring and Versioning (WebDAV) |
|---|---|
| : | Extension |
| : | dav_module |
| ҽ: | mod_dav.c |
ġ WebDAV ('Web-based Distributed Authoring and Versioning') class 1 class 2 ߰Ѵ. WebDAV ڿ ݷ(collection) (; ݷ Ͻý 丮 ̴) , ű, ϰ, ֵ HTTP Ȯ ̴.
mod_dav Ϸ httpd.conf
Ͽ Ʒ ߰Ѵ:
Dav On
mod_dav_fs ϴ DAV
Ͻý (provider) Ѵ. Ƿ
ϵְų LoadModule þ ߿
о鿩 Ѵ.
, DAV (lock) ͺ̽ ġ httpd.conf
κп DavLockDB þ Ͽ
ؾ Ѵ:
DavLockDB /usr/local/apache2/var/DavLock
DAV ϴ ġ ϱ <Location> þ
ȿ <Limit>
þ ִ. DAV Ŭ̾Ʈ ѹ û
ִ ִ Ʈ Ϸ LimitXMLRequestBody þ Ѵ.
"Ϲ" LimitRequestBody
þ DAV û .
DavLockDB /usr/local/apache2/var/DavLock
<Location /foo>
Dav On
AuthType Basic
AuthName DAV
AuthUserFile user.passwd
<LimitExcept GET OPTIONS>
require user admin
</LimitExcept>
</Location>
mod_dav Greg Stein Apache 1.3 mod_dav
. ڼ Ʈ
϶.
DAV ϸ Ŭ̾Ʈ
ֱ, mod_dav ϱ
Ư Ѵ.
DAV ġ ȣؾ Ѵ.
HTTP Basic Authentication õ ʴ´. ּ
mod_auth_digest ϴ HTTP Digest
Authentication ؾ Ѵ. WebDAV Ŭ̾Ʈ
Ѵ. ƴϸ SSL
ῡ Basic Authentication ִ.
mod_dav Ϸ, ġ
ϴ User
Group ش
丮 Ͽ Ѵ. ,
User
Group ϰ
ȴ. ƹ ϶. DAV
Ҵ ġ ִٰ Ѵ. ġ ʰ
( FTP Ͻý Ͽ)
ϸ ȵȴ.
mod_dav ź
ִ. LimitXMLRequestBody þ
Ͽ ū DAV û ִ.
DavDepthInfinity
þ Ͽ Ҹϱ ſ ū
PROPFIND û ִ. ܼ Ŭ̾Ʈ
ū ϵ ũ ä ź ݵ ϴ.
ġ ̸ . Ƿ ŷʴ
ڿ DAV ʵ϶.
Ϲ ϳ (PHP ũƮ, CGI ũƮ )
۾ mod_dav ϴ
̴. ̴ GET û ٿε
ʰ ũƮ ϹǷ ƴ. ذ ϳ
뿡 ΰ URL ϴ ̴. URL ũƮ
ϰ, ٸ URLδ ٿεϿ DAV ۾
ִ.
Alias /phparea /home/gstein/php_files
Alias /php-source /home/gstein/php_files
<Location /php-source>
DAV On
ForceType text/plain
</Location>
http://example.com/phparea
PHP ũƮ ְ,
http://example.com/php-sourceδ DAV Ŭ̾Ʈ
ũƮ ִ.
| : | WebDAV HTTP 带 Ѵ |
|---|---|
| : | Dav On|Off|provider-name |
| ⺻: | Dav Off |
| : | directory |
| : | Extension |
| : | mod_dav |
ġ WebDAV HTTP 带 Ϸ
Dav þ Ѵ:
<Location /foo>
Dav On
</Location>
On mod_dav_fs
ϴ ⺻ filesystem
Ī̴. ġ DAV ϸ DAV
ϵ ϶.
϶.
| : | Configure repository root path |
|---|---|
| : | DavBasePath root-path |
| ⺻: | None |
| : | directory |
| : | Extension |
| : | mod_dav |
| : | Available in version 2.4.58 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
| : | PROPFIND Depth: Infinity û 㰡Ѵ |
|---|---|
| : | DavDepthInfinity on|off |
| ⺻: | DavDepthInfinity off |
| : | ּ, ȣƮ, directory |
| : | Extension |
| : | mod_dav |
DavDepthInfinity þ ϸ
'Depth: Infinity' PROPFIND û
㰡Ѵ. ̷ û Ͽ ź ϱ
⺻ ʴ´.
| : | DAV ڿ ּҽð |
|---|---|
| : | DavMinTimeout seconds |
| ⺻: | DavMinTimeout 0 |
| : | ּ, ȣƮ, directory |
| : | Extension |
| : | mod_dav |
Ŭ̾Ʈ DAV ڿ (lock) ûҶ ˾Ƽ ִ ð ˷ ִ. ûϻ̸, Ŭ̾Ʈ û ϰ Ŭ̾Ʈ ð ˷ ִ.
DavMinTimeout þ Ŭ̾Ʈ
ּ ð (ʴ) Ѵ. Microsoft Web Folders
⺻ 120 ʸ Ѵ. DavMinTimeout
(600 ʿ ) ϸ Ŭ̾Ʈ Ʈ
ҰԵǴ 츦 ִ.
<Location /MSWord>
DavMinTimeout 600
</Location>
Apache HTTP サーバ バージョン 2.4
| 説明: | mod_dav 用の汎用ロックモジュール |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | dav_lock_module |
| ソースファイル: | mod_dav_lock.c |
| 互換性: | バージョン 2.1 以降 |
このモジュールは mod_dav のどのバックエンド
からでも使える汎用ロック API を提供します。
使用には最低限 mod_dav
を必要としますが、これを利用するバックエンドが存在しないと役に立たないので、
そのような場合はサーバに読み込むべきではありません。
mod_dav_lock
を実際に利用するバックエンドモジュールの例としては subversion
プロバイダモジュールの mod_dav_svn があります。
mod_dav_fs は特化された専用のバージョンを
使うため、この汎用モジュールは必要ないことに注意して
ください。
mod_dav_lock を機能させるには、
以下で説明されている DavGenericLockDB を使って
ロックデータベースの場所を指定するだけです。
ロックを提供している関数へのポインタを取得するためには、
ap_lookup_provider API を、引数 dav-lock,
generic, 0 を指定して使う必要が
あります。
| 説明: | DAV ロックデータベースの場所 |
|---|---|
| 構文: | DavGenericLockDB file-path |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_dav_lock |
DavGenericLockDB ディレクティブを
使って、拡張子を除いたロックデータベースへのフルパスを
指定します。絶対パスでないときは ServerRoot からの相対パスとして
扱われます。mod_dav_lock の実装ではユーザの
ロックを追跡するのに SDBM データベースを使います。
DavGenericLockDB var/DavLock
ロックデータベースファイルのあるディレクトリは
Apache が実行されている User
と Group によって
書き込み可能でなければなりません。セキュリティ上の理由から、
既存のディレクトリのパーミッションを変更するのではなく、
専用のディレクトリを作るのが良いでしょう。上の例では、
Apache は ServerRoot の下の var/
ディレクトリに、ファイル名の本体が DavLock で
サーバが追加する拡張子を持つファイルを作成します。
Apache HTTP サーバ バージョン 2.4
| 説明: | 「最後のスラッシュ」のリダイレクトと、ディレクトリの インデックスファイルを扱う機能を提供する |
|---|---|
| ステータス: | Base |
| モジュール識別子: | dir_module |
| ソースファイル: | mod_dir.c |
ディレクトリインデックスは、次の二つのうちどちらかが利用されます:
index.html というファイル名を使います。このファイル名は、
DirectoryIndex ディレクティブで
指定することができます。この機能は mod_dir
モジュールで提供されます。mod_autoindex
モジュールにより提供されます。自動的なインデックス生成機能を削除 (もしくは交換) できるように、この二つの機能は分離されています。
なお http://servername/foo/dirname という URL
へのリクエストがあった際に、dirname
というディレクトリがあれば、「最後にスラッシュをつけた形」の URL
へのリダイレクトを送出します。
ディレクトリへのアクセスはスラッシュで終わっている必要があり、
mod_dir は、http://servername/foo/dirname/
へのリダイレクトを送出することになります。
| 説明: | Toggle how this module responds when another handler is configured |
|---|---|
| 構文: | DirectoryCheckHandler On|Off |
| デフォルト: | DirectoryCheckHandler Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_dir |
| 互換性: | Available in 2.4.8 and later. Releases prior to 2.4 implicitly act as if "DirectoryCheckHandler ON" was specified. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | クライアントがディレクトリをリクエストしたときに調べる リソースのリスト |
|---|---|
| 構文: | DirectoryIndex
local-url [local-url] ... |
| デフォルト: | DirectoryIndex index.html |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_dir |
クライアントが、ディレクトリ名の最後に「/」
を指定してディレクトリインデックスを要求する場合に探すリソースのリストを
DirectoryIndex ディレクティブで設定します。
Local-url
は、リクエストされたディレクトリに対応する、サーバ上のドキュメントの
(% エンコードされた) URL で、普通はディレクトリ中のファイルの名前です。
複数の URL が設定された場合には、最初に見つかったものを返します。
それらが見つからず、Indexes
オプションがセットされている場合、ディレクトリのリストを生成します。
DirectoryIndex index.html
http://myserver/docs/ へのアクセスがあり、
http://myserver/docs/index.html
が存在すれば、この URL が返されます。
もし存在しなければ、ディレクトリのリストが返されます。
注: ドキュメントが同じディレクトリ内に存在するは必要ありません。
DirectoryIndex index.html index.txt /cgi-bin/index.pl
とした場合、index.html と index.txt
のどちらもディレクトリ内に存在しない場合、CGI スクリプト
/cgi-bin/index.pl が実行されます。
| 説明: | Configures an external redirect for directory indexes. |
|---|---|
| 構文: | DirectoryIndexRedirect on | off | permanent | temp | seeother |
3xx-code
|
| デフォルト: | DirectoryIndexRedirect off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_dir |
| 互換性: | Available in version 2.3.14 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | パス末尾のスラッシュでリダイレクトするかどうかのオンオフをトグルさせる |
|---|---|
| 構文: | DirectorySlash On|Off |
| デフォルト: | DirectorySlash On |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Indexes |
| ステータス: | Base |
| モジュール: | mod_dir |
| 互換性: | 2.0.51 以降 |
要求のあった URL がディレクトリを指すかどうかを、
mod_dir が調整するべきかどうかを
DirectorySlash
ディレクティブで設定します。
典型的には、ユーザが末尾のスラッシュ無しでリソースへのリクエストを発行し、
そして、そのリソースがディレクトリを指していた場合、mod_dir
は、末尾にスラッシュを付加した上で同じリソースにリダイレクトさせます。
この挙動には幾つか理由があります:
mod_autoindex が期待通りに動く。mod_autoindex
の生成するリンクはパスを出力しませんので、スラッシュがない場合は間違ったパスを
指してしまうことになります。DirectoryIndex は、
末尾にスラッシュがついているリクエストについてのみ評価される。とはいえ、もしこういった効果を望まない、かつ、 上記のような理由が当てはまらない場合は、リダイレクトを次のようにしてオフにできます:
# see security warning below!
<Location /some/path>
DirectorySlash Off
SetHandler some-handler
</Location>
末尾のスラッシュでのリダイレクトをオフにすると、結果的に情報漏洩を
招くことになるかもしれません。
mod_autoindex が有効 (Options +Indexes) で、
DirectoryIndex が有効なリソース (例えば
index.html) を指していて、また、要求のあった URL に特別な
ハンドラが設定されていない場合を考えてみてください。
この場合末尾にスラッシュのついているリクエストに対しては index.html
ファイルが返されます。しかしスラッシュのないリクエストに対しては、
ディレクトリの内容一覧を返してしまいます。
Apache HTTP サーバ バージョン 2.4
| 説明: | 望むようにすべての I/O をエラーログにダンプする |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | dumpio_module |
| ソースファイル: | mod_dumpio.c |
mod_dumpio を使うと、Apache が受け取ったすべての入力と
Apache により送られたすべての出力との、両方もしくはどちらか一方を、
エラーログファイルにログ収集 (訳注: ダンプ dump)
できます。
データのロギングは、SSL 復号化の直後 (入力) と SSL 暗号化の直前 (出力) に行なわれます。ご想像の通り、 このモジュールはとてつもないデータ量を出力しますので、 問題をデバッグしているときにのみ使用するようにしてください。
このモジュールを有効にするには、モジュールがコンパイルされていて、 実行する Apache の設定でサーバに組み込まれている必要があります。 ロギング機能は、以下のディレクティブを使って有効にしたり 無効にしたりできます。
| 説明: | エラーログにすべての入力データをダンプ |
|---|---|
| 構文: | DumpIOInput On|Off |
| デフォルト: | DumpIOInput Off |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Extension |
| モジュール: | mod_dumpio |
| 互換性: | DumpIOInput は Apache 2.1.3 以降のみで使用可能 |
すべての入力のダンプを有効にします。
DumpIOInput On
Apache HTTP サーバ バージョン 2.4
| 説明: | CGI スクリプト及び SSI ページに渡される環境変数を変更する機能を提供する |
|---|---|
| ステータス: | Base |
| モジュール識別子: | env_module |
| ソースファイル: | mod_env.c |
このモジュールにより CGI スクリプトと SSI
ページに適用される環境変数を制御することができるようになります。
環境変数は httpd プロセスを起動したシェルから渡されます。また、
設定ファイルで環境変数を設定したり、削除したりすることができます。
| 説明: | シェルからの環境変数を渡す |
|---|---|
| 構文: | PassEnv env-variable [env-variable]
... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_env |
httpd プロセスを起動したシェルの環境から CGI スクリプトと
SSI ページに渡す環境変数を一つ以上指定します。
PassEnv LD_LIBRARY_PATH
| 説明: | 環境変数を設定する |
|---|---|
| 構文: | SetEnv env-variable value |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_env |
環境変数を設定し、それを CGI スクリプトと SSI ページに渡すようにします。
SetEnv SPECIAL_PATH /foo/bin
Apache HTTP Server Version 2.4
| : | ġ API Ѵ |
|---|---|
| : | Experimental |
| : | example_hooks_module |
| ҽ: | mod_example_hooks.c |
ġ modules/examples 丮
ִ ϵ ġ API Ͽ ۼϷ
.
mod_example_hooks.c ݹ(callback)
ȣ ϴ ̴. ݹ
ʿ䰡 . ݴ!
example ϴ ̴. ϰ Ư ġ "example-hooks-handler" ڵ鷯 ҴϿ װ ¡ϸ example ݹ Ȯ ִ.
example Ϸ ģ:
--enable-example-hooks ɼǰ Բ
configure Ѵ.make" Ѵ).ڽ ߰Ϸ:
cp modules/examples/mod_example_hooks.c
modules/new_module/mod_myexample.cmodules/new_module/config.m4 .
APACHE_MODPATH_INIT(new_module)
߰Ѵ.modules/examples/config.m4 Ͽ
"example_hooks" ִ APACHE_MODULE ؿ´.configure --help
ϸ ش.config.m4 ϵ ϶.APACHE_MODPATH_FINISH ߰Ѵ.module/new_module/Makefile.in
. ϴµ Ư ɾ ʿٸ,
Ͽ include $(top_srcdir)/build/special.mk
־ ȴ.mod_example_hooks ϱexample Ϸ httpd.conf Ͽ
߰϶:
<Location /example-hooks-info>
SetHandler example-hooks-handler
</Location>
ƴϸ .htaccess
Ͽ ߰ϰ, ġ "test.example"
û϶:
AddHandler example-hooks-handler .example
ġ ¡ϸ տ Ե ̴.
Apache HTTP サーバ バージョン 2.4
| 説明: | レスポンスのボディをクライアントに送る前に外部プログラムで処理する |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | ext_filter_module |
| ソースファイル: | mod_ext_filter.c |
mod_ext_filter では フィルタ
の慣れ親しんだ単純なプログラミングモデルが提供されます。このモジュールを
使えば、標準入力から読み込んで、標準出力に書き出すプログラム
(すなわち Unix 形式のフィルタコマンド) を Apache のフィルタにすることが
できます。このフィルタの機構は、Apache API 向けに書かれた Apache
サーバプロセス内で実行される専用のフィルタよりもずっと遅いですが、
以下のような利点もあります。
性能の問題により実運用に適さないとしても、フィルタのプロトタイプ用の
環境としては mod_ext_filter は使えます。
# mod_ext_filter directive to define a filter
# to HTML-ize text/c files using the external
# program /usr/bin/enscript, with the type of
# the result set to text/html
ExtFilterDefine c-to-html mode=output \
intype=text/c outtype=text/html \
cmd="/usr/bin/enscript --color -W html -Ec -o - -"
<Directory "/export/home/trawick/apacheinst/htdocs/c">
# core directive to cause the new filter to
# be run on output
SetOutputFilter c-to-html
# mod_mime directive to set the type of .c
# files to text/c
AddType text/c .c
# mod_ext_filter directive to set the debug
# level just high enough to see a log message
# per request showing the configuration in force
ExtFilterOptions DebugLevel=1
</Directory>
注: この gzip の例はデモ用です。実用的な実装は
mod_deflate を参照してください。
# mod_ext_filter directive to define the external filter
ExtFilterDefine gzip mode=output cmd=/bin/gzip
<Location /gzipped>
# core directive to cause the gzip filter to be
# run on output
SetOutputFilter gzip
# mod_header directive to add
# "Content-Encoding: gzip" header field
Header set Content-Encoding gzip
</Location>
# mod_ext_filter directive to define a filter
# which runs everything through cat; cat doesn't
# modify anything; it just introduces extra pathlength
# and consumes more resources
ExtFilterDefine slowdown mode=output cmd=/bin/cat \
preservescontentlength
<Location />
# core directive to cause the slowdown filter to
# be run several times on output
#
SetOutputFilter slowdown;slowdown;slowdown
</Location>
# mod_ext_filter directive to define a filter which
# replaces text in the response
#
ExtFilterDefine fixtext mode=output intype=text/html \
cmd="/bin/sed s/verdana/arial/g"
<Location />
# core directive to cause the fixtext filter to
# be run on output
SetOutputFilter fixtext
</Location>
# Trace the data read and written by mod_deflate
# for a particular client (IP 192.168.1.31)
# experiencing compression problems.
# This filter will trace what goes into mod_deflate.
ExtFilterDefine tracebefore \
cmd="/bin/tracefilter.pl /tmp/tracebefore" \
EnableEnv=trace_this_client
# This filter will trace what goes after mod_deflate.
# Note that without the ftype parameter, the default
# filter type of AP_FTYPE_RESOURCE would cause the
# filter to be placed *before* mod_deflate in the filter
# chain. Giving it a numeric value slightly higher than
# AP_FTYPE_CONTENT_SET will ensure that it is placed
# after mod_deflate.
ExtFilterDefine traceafter \
cmd="/bin/tracefilter.pl /tmp/traceafter" \
EnableEnv=trace_this_client ftype=21
<Directory /usr/local/docs>
SetEnvIf Remote_Addr 192.168.1.31 trace_this_client
SetOutputFilter tracebefore;deflate;traceafter
</Directory>
#!/usr/local/bin/perl -w
use strict;
open(SAVE, ">$ARGV[0]")
or die "can't open $ARGV[0]: $?";
while (<STDIN>) {
print SAVE $_;
print $_;
}
close(SAVE);
| 説明: | 外部フィルタを定義 |
|---|---|
| 構文: | ExtFilterDefine filtername parameters |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | Extension |
| モジュール: | mod_ext_filter |
ExtFilterDefine は、実行するプログラムや
引数など、外部フィルタの特性を定義します。
filtername は定義するフィルタの名前を指定します。
この名前は後で SetOutputFilter
ディレクティブで指定できます。名前は登録されるすべてのフィルタで
一意でなくてはなりません。現時点では、フィルタの登録 API からは
エラーは報告されません。ですから、重複する名前を使ってしまったときでも
ユーザにはそのことは報告されません。
続くパラメータの順番は関係無く、それらは実行する外部コマンドと、
他の特性を定義します。cmd= だけが必須のパラメータです。
指定可能なパラメータは:
cmd=cmdlinecmd= キーワードは実行する外部コマンドを指定します。
プログラム名の後に引数がある場合は、コマンド行は引用符で囲む
必要があります (例えば、cmd="/bin/mypgm
arg1 arg2" のように)。プログラムは
シェル経由でなく、直接実行されますので、通常のシェル用の
エスケープは必要ありません。プログラムの引数は空白で区切られます。
プログラムの引数の一部となる必要のある空白はバックスペースでエスケープ
できます。引数の一部になるバックスラッシュはバックスラッシュで
エスケープする必要があります。標準の CGI 環境変数に加えて、
環境変数 DOCUMENT_URI, DOCUMENT_PATH_INFO, and
QUERY_STRING_UNESCAPED がプログラムのために設定されます。mode=modemode=output (デフォルト)
を使います。リクエストを処理するフィルタには mode=input
を使います。mode=input は Apache 2.1 以降で利用可能です。intype=imtintype= が指定されていれば、フィルタは指定されていない
ドキュメントには適用されなくなります。outtype=imtPreservesContentLengthPreservesContentLength キーワードはフィルタが
content length (訳注: コンテントの長さ)
を変更しないということを指定します。ほとんどのフィルタは
content length を変更するため、これはデフォルトではありません。
フィルタが長さを変えないときは、このキーワードを指定すると
よいでしょう。ftype=filtertypedisableenv=envenableenv=env| 説明: | mod_ext_filter のオプションを設定 |
|---|---|
| 構文: | ExtFilterOptions option [option] ... |
| デフォルト: | ExtFilterOptions DebugLevel=0 NoLogStderr |
| コンテキスト: | ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_ext_filter |
ExtFilterOptions ディレクティブは
mod_ext_filter の特別な処理用のオプションを
指定します。Option には以下のどれかを指定します。
DebugLevel=nDebugLevel で mod_ext_filter
の生成するデバッグメッセージのレベルを設定できます。
デフォルトでは、デバッグメッセージは生成されません。
これは DebugLevel=0 と設定するのと同じです。
数字が大きくなればなるほど、より多くのデバッグメッセージが
生成され、サーバの性能は落ちます。数値の実際の意味は
mod_ext_filter.c の先頭近くの DBGLVL_ 定数の
定義で説明されています。
注: デバッグメッセージを Apache のエラーログに
保存するようにするためには、core のディレクティブ
LogLevel
を使う必要があります。
LogStderr | NoLogStderrLogStderr キーワードは外部フィルタプログラムにより
標準エラー (訳注: stderr) に書かれたメッセージを
Apache のエラーログに保存するようにします。NoLogStderr は
逆に保存しないようにします。
ExtFilterOptions LogStderr DebugLevel=0
この例では、フィルタの標準出力に書かれたメッセージは
Apache のエラーログに保存されます。mod_ext_filter からは
デバッグメッセージは生成されません。
Apache HTTP サーバ バージョン 2.4
| 説明: | 二つ以上のマルチプロセッシングモジュール (MPM) で実装されているディレクティブのコレクション |
|---|---|
| ステータス: | MPM |
CoreDumpDirectory EnableExceptionHook GracefulShutdownTimeout Listen ListenBackLog ListenCoresBucketsRatio MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers StartThreads ThreadLimit ThreadsPerChild ThreadStackSize| 説明: | Apache がコアダンプする前に移動を試みるディレクトリ |
|---|---|
| 構文: | CoreDumpDirectory directory |
| デフォルト: | デフォルトの設定は説明文を読んでください |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | beos, leader, mpm_winnt, perchild, prefork, threadpool, worker |
Apache がコアダンプする前に移動を試みるディレクトリを制御します。
デフォルト値は ServerRoot
ディレクトリですが、このディレクトリはサーバの実行されているユーザ権限で
書き込み可能であるべきではないので、通常はコアダンプは書き込まれません。
デバッグのためにコアダンプが必要であれば、
このディレクティブを使って他の位置にコアダンプを書き出すようにできます。
Apache が root として起動されて、別のユーザの権限に以降した場合は
Linux のカーネルはディレクトリがプロセスの権限で書き込み可能な場合でさえも
コアダンプを無効にします。Apache (2.0.46 以降) は
Linux 2.4 以降ではコアダンプを行なうように再指定しますが、それは
CoreDumpDirectory を明示的に設定したときに
限ります。
| 説明: | クラッシュの後に例外ハンドラを実行するフックを有効にする |
|---|---|
| 構文: | EnableExceptionHook On|Off |
| デフォルト: | EnableExceptionHook Off |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | leader, perchild, prefork, threadpool, worker |
| 互換性: | 2.0.49 以降 |
安全上の理由から、--enable-exception-hook configure
オプションを有効にした場合にのみ、このディレクティブを利用できます。
外部モジュールをプラグインして、子がクラッシュした後に何か実行できるような
フックを有効にします。
このような外部モジュールは、既に二つ存在していて、
mod_whatkilledus と mod_backtrace
がこのフックを活用します。これらの詳細については Jeff Trawick
さんの EnableExceptionHook site を参照してください。
| 説明: | 穏やかな停止をかけた後、終了するまで待つ時間 |
|---|---|
| 構文: | GracefulShutDownTimeout seconds |
| デフォルト: | GracefulShutDownTimeout 0 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | prefork, worker, event |
| 互換性: | 2.2 以降 |
GracefulShutdownTimeout には
サーバーが "graceful-stop" シグナルを受け取ってから現在の
リクエストの処理を最大で何秒間続けるかを指定します。
この値をゼロに設定すると、処理中として残っているリクエストが 全て完了するまでサーバーは終了しません。
| 説明: | サーバが listen するIP アドレスとポート番号 |
|---|---|
| 構文: | Listen [IP-address:]portnumber [protocol] |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | beos, leader, mpm_netware, mpm_winnt, mpmt_os2, perchild, prefork, threadpool, worker, event |
| 互換性: | Apache 2.0 から必須ディレクティブ。protocol 引数は 2.1.5 で追加。 |
Listen ディレクティブは Apache
が特定の IP アドレスやポート番号だけを listen するように指定します。
デフォルトでは全ての IP インターフェースのリクエストに応答します。
Listen ディレクティブは
現在は必須のディレクティブとなりました。
もし設定ファイルになければ、サーバは起動に失敗します。
これは以前のバージョンの Apache から変更のあった部分です。
Listen ディレクティブでは、特定のポートあるいは
アドレスとポートの組み合わせから入ってくるリクエストに対して
応答するように指定します。
もしポート番号だけが指定された場合は、サーバは全インターフェースの
指定されたポート番号に対して listen します。
IP アドレスがポートとともに指定された場合は、
サーバは指定されたポートとインターフェースに対して listen
します。
複数のアドレスとポートに対して listen するように、
複数の Listen ディレクティブを使うこともできます。
サーバは列挙されたアドレスとポート全てからのリクエストに対して
応答します。
例えば、サーバが 80 番ポートと 8000 番ポートの両方の コネクションを受け入れる場合は、次のようにします。
Listen 80
Listen 8000
二つの特定のインターフェースとポート番号からのコネクションを 受け入れるようにするには、次のようにします。
Listen 192.170.2.1:80
Listen 192.170.2.5:8000
IPv6 アドレスは角括弧で囲まなければなりません。 例えば次の例のようにです。
Listen [2001:db8::a00:20ff:fea7:ccea]:80
protocol オプション引数は通常の設定では必要ありません。
無指定の場合、443 番ポートには https が、他のポートには
http がデフォルト値として使用されます。
protocol 指定は、どのモジュールがリクエストを処理するかを決定し、
AcceptFilter
によるプロトコル特有の最適化を行うようにします。
非標準なポートで運用している際にのみ protocol 指定が必要になります。
たとえば https なサイトを 8443 番ポートで運用している場合 :
Listen 192.170.2.1:8443 https
Listen
ディレクティブを指定してしまうと、Address already in use
というエラーメッセージを受けることになります。
| 説明: | 保留状態のコネクションのキューの最大長 |
|---|---|
| 構文: | ListenBacklog backlog |
| デフォルト: | ListenBacklog 511 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | beos, leader, mpm_netware, mpm_winnt, mpmt_os2, perchild, prefork, threadpool, worker |
保留状態のコネクションのキューの最大長です。
一般的には調整する必要はありませんし、調整は望ましくありません。
しかし、TCP SYN フラッドアタックの状況下におかれる場合に、
増やした方が望ましいシステムもあります。
listen(2) システムコールのバックログパラメータを
ご覧下さい。
この値は OS により、小さな数に抑えられます。 値は OS 毎に異なっています。また多くの OS では、 バックログとして指定されている値ちょうどまで使っているわけではなく、 設定されている値に基づいて (通常は設定値よりも大きな値を) 使っていることに注意してください。
| 説明: | Ratio between the number of CPU cores (online) and the number of listeners' buckets |
|---|---|
| 構文: | ListenCoresBucketsRatio ratio |
| デフォルト: | ListenCoresBucketsRatio 0 (disabled) |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | event, worker, prefork |
| 互換性: | Available in Apache HTTP Server 2.4.17, with a kernel supporting
the socket option SO_REUSEPORT and distributing new connections
evenly across listening processes' (or threads') sockets using it (eg. Linux
3.9 and later, but not the current implementations of SO_REUSEPORT
in *BSDs. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | Limit on the number of connections that an individual child server will handle during its life |
|---|---|
| 構文: | MaxConnectionsPerChild number |
| デフォルト: | MaxConnectionsPerChild 0 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
| 互換性: | Available Apache HTTP Server 2.3.9 and later. The old name
MaxRequestsPerChild is still supported. |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | free() が呼ばれない限り、
主メモリアロケータが保持し続けられるメモリの最大量 |
|---|---|
| 構文: | MaxMemFree KBytes |
| デフォルト: | MaxMemFree 0 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | beos, leader, mpm_netware, prefork, threadpool, worker, mpm_winnt |
MaxMemFree ディレクティブは
free() が呼ばれない限り、
主アロケータが保持できる空のメモリの最大値をキロバイト単位で設定します。
設定されていないか、零に設定されているときは、無制限になります。
| 説明: | Maximum number of connections that will be processed simultaneously |
|---|---|
| 構文: | MaxRequestWorkers number |
| デフォルト: | See usage for details |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | event, worker, prefork |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | アイドルスレッドの最大数 |
|---|---|
| 構文: | MaxSpareThreads number |
| デフォルト: | 詳細は使用法をご覧下さい。 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | beos, leader, mpm_netware, mpmt_os2, perchild, threadpool, worker |
アイドルなスレッドの最大数です。異なる MPM ではそれぞれ、 このディレクティブは異なる取り扱われ方をされます。
perchild では、
デフォルトは MaxSpareThreads 10 です。
この MPM はアイドルスレッド数を、それぞれの子プロセスごとに監視します。
子プロセスにアイドルスレッドが多すぎる場合は、
サーバはその子プロセスに含まれるスレッドを終了し始めます。
worker, leader,
threadpool では、
デフォルトは MaxSpareThreads 250 です。
この MPM はアイドルスレッド数をサーバ全体で監視します。
サーバでアイドルスレッド数が多すぎる場合は、
この数字よりも少ない数になるまで子プロセスを終了します。
mpm_netware では、
デフォルトは MaxSpareThreads 100 です。
この MPM はシングルプロセスで実行されますので、
スペアスレッド数もサーバ全体で勘定します。
beos と mpmt_os2 は
mpm_netware と似た挙動をします。
beos でのデフォルト値は MaxSpareThreads 50
です。mpmt_os2 でのデフォルト値は 10
です。
MaxSpareThreads の取る値には制限があります。
Apache は次の規則に従って自動的に補正します。
perchild では、
MaxSpareThreads が
ThreadLimit
と等しいかそれ以下である必要があります。mpm_netware は
MinSpareThreads
よりも大きい必要があります。leader, threadpool,
worker では、
MinSpareThreads と
ThreadsPerChild
で決まる総和と等しいか大きい必要があります。| 説明: | リクエストに応答することのできる アイドルスレッド数の最小数 |
|---|---|
| 構文: | MinSpareThreads number |
| デフォルト: | 詳細は使用方法をご覧下さい。 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | beos, leader, mpm_netware, mpmt_os2, perchild, threadpool, worker |
リクエストに応答するスレッド数の最小値です。 異なる MPM ではそれぞれ、 このディレクティブは異なる取り扱われ方をします。
perchild では、
デフォルトは MinSpareThreads 5 で、
アイドルスレッド数を子プロセス毎に監視します。
もし子プロセスに十分な数のスレッドがなければ、
サーバはその子プロセスに新しいスレッドを作り始めます。
ですから、NumServers
を 10 に、MinSpareThreads を
5 にした場合は、最小でも 50 のアイドルスレッドが
システム上にあることになります。
worker, leader,
threadpool では、
デフォルトは MinSpareThreads 75 で、
アイドルスレッド数をサーバ全体で監視します。
もしサーバに十分な数のアイドルスレッドがなければ、
アイドルスレッド数がこの数 number よりも大きくなるまで
新しい子プロセスが生成されます。
mpm_netware では、
デフォルトは MinSpareThreads 10 で、
シングルプロセス MPM ですので、サーバ全体で管理されます。
beos と mpmt_os2 は、
mpm_netwareによく似ています。
beos でのデフォルトは MinSpareThreads 1
です。mpmt_os2 でのデフォルトは
5 です。
| 説明: | デーモンのプロセス ID をサーバが記録するためのファイル |
|---|---|
| 構文: | PidFile filename |
| デフォルト: | PidFile logs/httpd.pid |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | beos, leader, mpm_winnt, mpmt_os2, perchild, prefork, threadpool, worker |
PidFile ディレクティブで、
デーモンのプロセス ID をサーバが記録するファイルを設定します。
ファイル名が絶対パスでない場合は、
ServerRoot
からの相対的なものとして扱われます。
PidFile /var/run/apache.pid
サーバが ErrorLog
や TransferLog
を閉じて開き直したり、設定ファイルを
再読込したりさせるために、サーバにシグナルを送ることができると
便利なことがあります。
これは SIGHUP (kill -1) シグナルを PidFile
に書かれているプロセス ID に送ることでできます。
PidFile には、ログファイルの設置位置や
セキュリティ
と全く同じ注意点があります。
Apache 2 では、
apachectl
スクリプトのみを使用してサーバの (再) 起動や停止を
行なうことを推奨しています。
| 説明: | TCP 受信バッファサイズ |
|---|---|
| 構文: | ReceiveBufferSize bytes |
| デフォルト: | ReceiveBufferSize 0 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | beos, mpm_netware, mpm_winnt, mpmt_os2, prefork, worker |
サーバは TCP 受信バッファサイズを指定されたバイト数に設定します。
0にした場合、OS のデフォルト値が使用されます。
| 説明: | 子プロセスと連携するためのデータを保存する ファイルの位置 |
|---|---|
| 構文: | ScoreBoardFile file-path |
| デフォルト: | ScoreBoardFile logs/apache_status |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | beos, leader, mpm_winnt, perchild, prefork, threadpool, worker |
Apache は親プロセスと子プロセス間の通信にスコアボードを用います。 この通信機能にファイルを必要とするアーキテクチャもあります。 ファイルが指定されていなければ、Apache はまずメモリ上 (匿名共有メモリ) にスコアボードを作ろうとし、それが失敗すると ディスク上にファイル (ファイルベースの共有メモリ) を作ろうとします。 このディレクティブを指定すると、Apache は必ずディスクにファイルを生成します。
ScoreBoardFile /var/run/apache_status
ファイルベースの共有メモリは、サードパーティー製のアプリケーションで スコアボードに直接アクセスする必要がある場合に役に立ちます。
ScoreBoardFile を使う場合、
RAM ディスク上に置くとスピードが向上するでしょう。
しかし、ログファイルの設置位置や
セキュリティ
と同様の注意点があるので、注意してください。
| 説明: | TCP バッファサイズ |
|---|---|
| 構文: | SendBufferSize bytes |
| デフォルト: | SendBufferSize 0 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | beos, leader, mpm_netware, mpm_winnt, mpmt_os2, perchild, prefork, threadpool, worker |
サーバは TCP 送信バッファサイズを指定されたバイト数に設定します。 高速で高レイテンシな環境で (例 100ms 程度、大陸横断高速通信路など) 古い一般的な OS のデフォルト値を増やすのに非常に便利です。
0にした場合、OS のデフォルト値が使用されます。
| 説明: | 設定可能なサーバプロセス数の上限 |
|---|---|
| 構文: | ServerLimit number |
| デフォルト: | 詳細は使用法を参照 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | leader, perchild, prefork, threadpool, worker |
prefork MPM の場合は、このディレクティブは
Apache プロセス稼働中における
MaxClients
に設定可能な上限値を設定することになります
(訳注: prefork の場合は同時クライアント数 = サーバプロセス数なので)。
worker MPM の場合には、このディレクティブは
ThreadLimit
ディレクティブと組み合わせて、
Apache プロセス稼働中における
MaxClients
に設定可能な上限値を設定することになります。
このディレクティブを変更して再起動(訳注: apachectl
restart)しても無視されますが、
MaxClients
は再起動で変更することができます。
このディレクティブを使用する際は特に注意してください。
ServerLimit が必要以上に大きな値に
設定された場合は、余計な未使用共有メモリが割り当てられます。
ServerLimit と
MaxClients
がシステムの扱える範囲を越えた設定値になっていると、
Apache は起動しないか、起動しても不安定になるでしょう。
prefork MPM では、
MaxClients
を 256 (デフォルト) よりも大きな値に設定する必要がある時にだけ使用してください。
希望の MaxClients
数とくらべて、必要以上に大きな値を指定することは避けてください。
worker, leader,
threadpool MPM では、
MaxClients と
ThreadsPerChild
の設定で 16 サーバプロセス (デフォルト)
以上必要になる場合にのみ使用してください。希望の
MaxClients と
ThreadsPerChild
とくらべて、必要となるサーバプロセス数以上に大きな値を
設定することは避けてください。
perchild MPM では、
NumServers を 8 (デフォルト)
よろいも大きな値に設定する必要があるときにのみ使用してください。
ServerLimit 20000 という制限付きでコンパイルされています
(prefork MPM では 200000) 。
これはスペルミスによって誤って酷い状況になるのを、
回避するための処置です。
| 説明: | 起動時に生成される子サーバプロセスの数 |
|---|---|
| 構文: | StartServers number |
| デフォルト: | 詳細は使用方法を参照 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | leader, mpmt_os2, prefork, threadpool, worker |
StartServers ディレクティブは、
起動時に生成される子サーバプロセスの数を設定します。
プロセス数は負荷に応じて動的に制御されますので、
通常はこの値を調整する理由はあまりないでしょう。
デフォルト値は MPM ごとに異なります。
leader, threadpool,
worker は StartServers 3 です。
prefork は 5 で、
mpmt_os2 は 2 です。
| 説明: | 起動時に生成されるスレッドの数 |
|---|---|
| 構文: | StartThreads number |
| デフォルト: | 詳細は使用方法を参照 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | beos, mpm_netware, perchild |
起動時に生成されるスレッドの数です。 スレッド数は負荷に応じて動的に制御されますので、 通常はこの値を調整する理由はあまりないでしょう。
perchild でのデフォルトは
StartThreads 5 で、このディレクティブは起動時に
プロセス毎のスレッド数を追跡します。
mpm_netware でのデフォルトは
StartThreads 50 で、
この場合プロセスは一つしかないので、
起動時にリクエストに応答するスレッドの総数となります。
beos でのデフォルトは StartThreads
10 です。
また、起動時に生成されるスレッドの総数にも反映されます。
| 説明: | 設定可能な子プロセス毎のスレッド数の上限を 設定します |
|---|---|
| 構文: | ThreadLimit number |
| デフォルト: | 詳細は使用方法を参照 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | leader, mpm_winnt, perchild, threadpool, worker |
| 互換性: | Apache 2.0.41 とそれ以降の mpm_winnt
で利用可能 |
このディレクティブは
Apache プロセス稼働中における
ThreadsPerChild
に設定可能な上限値を設定します。再起動時にこのディレクティブの値を
変更しても無視されますが、
ThreadsPerChild
は再起動中に、このディレクティブで指定された上限値まで
変更することができます。
このディレクティブを使用する際は特に注意してください。
ThreadLimit が
ThreadsPerChild
よりもずっと大きな値に設定された場合は、
余計な未使用共有メモリが割り当てられてしまいます。
ThreadLimit が
ThreadsPerChild
の両方がシステムの扱える範囲を超えている場合は、
Apache は起動しないか、起動したとしても不安定になるでしょう。
このディレクティブの値は今使用している Apache の ThreadsPerChild の予想上限値を
超えた値には設定しないでください。
ThreadLimit のデフォルト値は
mpm_winnt のときは 1920 で、
他の場合は 64 です。
ThreadLimit 20000 (mpm_winnt
の場合は ThreadLimit 15000 )
という制限付きでコンパイルされています。
これはスペルミスによって誤って酷い状況になるのを、
回避するための処置です。
| 説明: | 子プロセスそれぞれに生成されるスレッド数 |
|---|---|
| 構文: | ThreadsPerChild number |
| デフォルト: | 詳細は使用方法を参照 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | leader, mpm_winnt, threadpool, worker |
このディレクティブは、それぞれの子プロセスで生成される
スレッド数を設定します。
子プロセスは開始時にこれらのスレッドを生成して、
その後は生成しません。mpm_winnt のような、
子プロセスが一つしかないような MPM を利用しているのであれば、
この値はサーバの負荷全体を十分取り扱える程度に、
大きくなければなりません。worker のような、
子プロセスが複数あるような MPM を利用しているのであれば、
サーバの通常負荷を十分扱える程度に、
スレッド総数が多くなければなりません。
mpm_winntでの ThreadsPerChild
のデフォルト値は 64 で、他の場合は
25 です。
| 説明: | クライアントのコネクションを受け持つスレッドが使用する スタックのバイト数 |
|---|---|
| 構文: | ThreadStackSize size |
| デフォルト: | NetWare では 65536。他の OS では違った値 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | leader, mpm_netware, mpm_winnt, perchild, threadpool, worker |
| 互換性: | 2.1 以降 |
クライアントコネクションを受け持ち、コネクション処理に必要なモジュールの
呼び出しを行なっているスレッドの、(自動変数用の) スタックサイズは
ThreadStackSize ディレクティブで指定します。
大抵の場合 OS の指定しているスタックサイズのデフォルト値は
適切なものですが、調整が必要になる場合もあります:
ThreadStackSize
で OS のデフォルト値より大きな値を指定することで解決します。
サードパーティ製モジュールでこの処置が必要であると記載されている
場合か、Apache の出力するメッセージでスレッドスタックサイズが
小さすぎると指摘されている場合にのみ、この調整をしてください。ThreadStackSize
を OS のデフォルト値よりも小さな値にすることで、子プロセスあたりの
スレッド数をより多く持たせられるようになります。
このタイプの調整は、テスト環境でウェブサーバを完全に
テストできる場合に限って行なうべきです。
まれに多数のスタックが要求されるリクエストを受けることがあるかも
しれないからです。
Web サーバの設定を変更すると、現在の ThreadStackSize
の設定が取り消される場合があります。Apache HTTP サーバ バージョン 2.4
| 説明: | スレッドを使わず、先行して fork を行なうウェブサーバを実装 |
|---|---|
| ステータス: | MPM |
| モジュール識別子: | mpm_prefork_module |
| ソースファイル: | prefork.c |
このマルチプロセッシングモジュール (MPM) は、 Unix 上での Apache 1.3 のデフォルトの挙動と非常によく似た方法で リクエストを処理する、スレッドを使わず、先行して fork を行なう ウェブサーバを実装しています。 スレッドセーフでないライブラリとの互換性をとるために、 スレッドを避ける必要のあるサイトでは、このモジュールの使用が適切でしょう。 あるリクエストで発生した問題が他のリクエストに影響しないように、 個々のリクエストを単離するのにも、最適な MPM です。
この MPM は非常に自律的なので、この MPM の設定ディレクティブを
調整する必要はほとんどないでしょう。もっとも重要なことは、
MaxClients
が、予想される同時リクエスト数を十分扱えるぐらいは大きいけれども、
全プロセスに十分な物理メモリが確実に行き渡る程度には小さい値にする、
ということです。
CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareServers MinSpareServers PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers User一つのコントロールプロセスが、 コネクションに対して listen して、しかるべき時に応答する 子プロセスを起動します。Apache は常に幾つかのスペア かアイドルなサーバプロセスを維持していて、それらは入ってきた リクエストに応答できるように待機しています。 このようにしてクライアントは、リクエストが応答される前に、 新しい子プロセスが fork されるのを待たなくてもよいように なっています。
親プロセスがリクエストに応答するの子プロセスを
どのように生成するかは、
StartServers,
MinSpareServers,
MaxSpareServers,
MaxClients
で調整します。一般的に、Apache は非常に自律的なので、
大抵のサイトではこれらのディレクティブをデフォルト値から調整する
必要はないでしょう。
同時に 256 を超えるリクエストに応答しないといけないサイトでは、
MaxClients
を増やす必要があるでしょう。
一方、メモリの限られているサイトでは、スラッシング
(メモリとディスク間で何度もスワップ) が起こるのを防ぐために
MaxClients
を減らす必要があるでしょう。プロセス生成のチューニングに関する
詳しい情報は、性能に関するヒント
にあります。
通常 Unix では親プロセスは 80 番ポートにバインドするために
root で起動されますが、子プロセスやスレッドは
もっと低い権限のユーザで Apache によって起動されます。
User と
Group
ディレクティブは
Apache の子プロセスの権限を設定するのに用いられます。
子プロセスはクライアントに送るコンテンツ全てを読めないといけませんが、
可能な限り必要最小限の権限のみを持っているようにするべきです。
MaxRequestsPerChild
は、古いプロセスを停止して新しいプロセスを起動することによって、
どの程度の頻度でサーバがプロセスをリサイクルするかを制御します。
| 説明: | アイドルな子サーバプロセスの最大個数 |
|---|---|
| 構文: | MaxSpareServers number |
| デフォルト: | MaxSpareServers 10 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | prefork |
MaxSpareServers ディレクティブは、
アイドルな子サーバプロセスの希望最大個数を設定します。
アイドルプロセスとは、リクエストを扱っていないプロセスです。
MaxSpareServers よりも多い数がアイドルであれば、
親プロセスは超過プロセスを kill します。
非常に混んでいるサイトでのみ、このパラメータをチューニングするべきです。
このパラメータを大きくするということは、大抵の場合は悪い発想です。
MinSpareServers
以下に設定した場合、MinSpareServers
+1 に自動調整されます。
| 説明: | アイドルな子サーバプロセスの最小個数 |
|---|---|
| 構文: | MinSpareServers number |
| デフォルト: | MinSpareServers 5 |
| コンテキスト: | サーバ設定ファイル |
| ステータス: | MPM |
| モジュール: | prefork |
MaxSpareServers ディレクティブは、
アイドルな子サーバプロセスの希望最小個数を設定します。
アイドルプロセスとは、リクエストを扱っていないプロセスです。
MinSpareServers よりも少ない数がアイドルであれば、
親プロセスは最高で 1 秒につき 1 個の割合で新しい子プロセスを生成します。
非常に混んでいるサイトでのみ、このパラメータをチューニングするべきです。 このパラメータを大きくするということは、大抵の場合は悪い発想です。
Apache HTTP サーバ バージョン 2.4
| 説明: | HTTP リクエストのヘッダと応答のヘッダのカスタマイズ |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | headers_module |
| ソースファイル: | mod_headers.c |
| 互換性: | RequestHeader
は Apache 2.0 以降のみで使用可能 |
このモジュールは HTTP のリクエストヘッダと応答ヘッダを制御し、 変更するためのディレクティブを提供します。ヘッダを追加したり、 置き換えたり、削除したりすることができます。
mod_headers のディレクティブはサーバ設定のほぼどこにでも
書くことができ、影響する範囲を設定用セクションで囲むことで限定する
ことができます。
処理の順番は重要で、設定ファイル中の順番と、設定用セクション内の位置との両方に 影響されます。以下の二つのヘッダは順番が逆になると 違う結果になります:
RequestHeader append MirrorID "mirror 12"
RequestHeader unset MirrorID
この順番の場合は、MirrorID ヘッダは設定されません。
逆になっていると、MirrorID ヘッダは "mirror 12" に設定されます。
mod_headers では、リクエストの早期か後期かの
どちらで適用するかを選べます。通常は後期モードで、
コンテンツ生成が実行される直前にリクエストヘッダがセットされ、
レスポンスとして送出される直前にレスポンスヘッダがセットされます。
運用中のサーバでは必ず後期モードを使ってください。
早期モードは開発者向けのテスト/デバッグ用に設計されています。
early キーワード指定されたディレクティブによって、
リクエスト処理の開始地点になります。
つまり、異なるリクエストを試したりテストケースをセットアップするのに
活用できる一方で、レスポンスを生成する前に他のモジュールによって
ヘッダが書き換えられてしまうかもしれないということを意味します。
early ディレクティブではリクエストパスの設定が解決される前に
処理されるので、メインサーバかバーチャルホストコンテキストでのみ、
早期ヘッダをセットできます。early ディレクティブはリクエストパスに
依存することはできませんので、<Directory> や
<Location> といったコンテキスト内では使用
できません。
Header echo ^TS
MyHeader を応答に追加します。このヘッダはクライアントが
サーバの負荷を直観的に知るためや、クライアント-サーバ間の
ボトルネックを調べるために使うことができます。
Header add MyHeader "%D %t"
上記の設定では、以下のようなヘッダが応答に追加されることになります:
MyHeader: D=3775428 t=991424704447256
Header add MyHeader "Hello Joe. It took %D microseconds for Apache to serve this request."
以下のようなヘッダが応答に追加されることになります
MyHeader: Hello Joe. It took D=3775428 microseconds for Apache to serve this request.
MyHeader を応答に
付けます。これは、クライアントの要求に応えてヘッダを作成するときに
役に立ちます。この例では mod_setenvif モジュールが必要なことに
注意してください。
SetEnvIf MyRequestHeader value HAVE_MyRequestHeader
Header add MyHeader "%D %t mytext" env=HAVE_MyRequestHeader
もし HTTP リクエストに MyRequestHeader: value ヘッダが
あると、応答には以下のようなヘッダが付加されます。
MyHeader: D=3775428 t=991424704447256 mytext
| 説明: | HTTP 応答ヘッダの設定 |
|---|---|
| 構文: | Header [condition] set|append|add|unset|echo
header [value] [early|env=[!]variable] |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Extension |
| モジュール: | mod_headers |
このディレクティブは HTTP 応答ヘッダを置換、追加、削除できます。 ヘッダはコンテントハンドラや出力フィルタが実行された直後に実行され、 出て行くヘッダを変更できるようになっています。
オプションの condition は onsuccess か
always のどちらかを指定できます。これは内部ヘッダテーブルのどれを
操作するかを決定します。onsuccess は 2xx
ステータスコードの、always は全てのステータスコード
(2xx を含む) の意味になります。
あるモジュールでセットされるヘッダをアンセットしたい場合は特に、
どのテーブルが影響を受けるかを実際に試したほうがよいでしょう。
行なう処理は二番目のの引数で決まります。 この引数には次の値を指定できます:
setappendaddappend の方を
使う方が良いでしょう。unsetechoこの引数の後にはヘッダ名 (header) が続きます。
ヘッダ名には最後にコロンを含めることもできますが、無くても構いません。
set, append, add,
unset では大文字小文字は
区別されません。echo の header 名は大文字小文字を区別し、
正規表現を指定することもできます。
add, append,
set では value を三つ目の
引数として指定します。value に空白がある場合は二重引用符で
囲む必要があります。value は文字のみからなる文字列、
フォーマット指示子を含む文字列、もしくは両方からなる文字列を指定できます。
value は以下のフォーマット指示子をサポートします:
| フォーマット | 解説 |
|---|---|
%% |
パーセント記号 |
%t |
リクエストを受け取った時刻を、
Universal Coordinated Time での始まりの時刻 (Jan. 1, 1970) から経過した
時間をマイクロ秒として現したもの。値の最初には
t= が付加されます。 |
%D |
リクエストを受け取った時刻と、ヘッダを送り出した
時間との差。これは、リクエストが存在していた期間を現します。
値の最初には D= が付加されます。 |
%{FOOBAR}e |
環境変数
FOOBAR の値です。 |
%{FOOBAR}s |
mod_ssl が有効な場合、
SSL 環境変数 FOOBAR
の内容 |
%s フォーマット指定子は 2.1 以降でのみ利用できます。
SSLOptions +StdEnvVars を有効にすることによるオーバーヘッドを
避けるため、%e の代わりとして使えます。
他の理由などがあって、どうしても SSLOptions +StdEnvVars
を有効にしなければならない場合は、%e のほうが
%s よりも処理効率は良いです。
Header ディレクティブには追加の引数を持たせることが
できて、どういったアクションが行われたかの条件を指定したり、
早期処理 を指定する early キーワードを
指定できます。
env=... 引数で指定された 環境変数 が存在する (もしくは env=!...
が指定されていて環境変数が存在しない) 場合は、Header
ディレクティブで指定された動作が行なわれます。そうでない場合は、
ディレクティブはそのリクエストには何もしません。
早期処理モードの場合以外では、
Header
ディレクティブは応答がネットワークに送られる直前に
処理されます。これは、ヘッダフィルタにより追加されるヘッダを
除き、ほとんどのヘッダを設定したり上書きしたりすることが
可能、ということです。
| 説明: | HTTP リクエストヘッダの設定 |
|---|---|
| 構文: | RequestHeader set|append|add|unset header
[value] [early|env=[!]variable] |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Extension |
| モジュール: | mod_headers |
このディレクティブは HTTP リクエストヘッダを置換、追加、削除できます。 ヘッダはコンテントハンドラが実行される直前に実行され、 入って来るヘッダを変更することが可能になっています。 行なう処理は第 1 引数により決まります。これには以下の値を指定 することができます:
setappendaddappend の方を
使う方が良いでしょう。unsetこの引数の後にはヘッダ名 (header) が続きます。
ヘッダ名には最後にコロンを含めることもできますが、無くても構いません。
大文字小文字は区別されません。add,
append, set の場合は、value が三つ目の
引数として指定されます。value に空白がある場合は二重引用符で
囲む必要があります。unset の場合は、value は指定しません。
value は文字列、フォーマット指定子、あるいは、その混合です。
使うことのできるフォーマット指定子は、Header と同じですので、
詳細はそちらをご覧ください。
RequestHeader ディレクティブは、
どういった条件下でアクションを行うかを指定する追加引数
あるいは、早期処理 を指定する early
キーワードを設定することができます。
env=... の引数で設定されている
環境変数 が存在している
(あるいは env=!... で指定された環境変数が
存在しない) 場合、RequestHeader ディレクティブは
有効になります。それ以外の場合、ディレクティブは効力を持ちません。
early モードでない場合に限り、
RequestHeader ディレクティブは
fixup フェーズでリクエストがハンドラに扱われる直前に
処理されます。これにより、ブラウザや Apache の入力フィルタにより
生成されたヘッダを上書きしたり修正したりできるようになっています。
Apache HTTP Server Version 2.4
| : | RFC 1413 ident ˻ |
|---|---|
| : | Extension |
| : | ident_module |
| ҽ: | mod_ident.c |
| : | ġ 2.1 ĺ |
ڸ ã ȣƮ ִ RFC 1413 ȣȯ ˻Ѵ.
| : | RFC 1413 ſ α Ѵ |
|---|---|
| : | IdentityCheck On|Off |
| ⺻: | IdentityCheck Off |
| : | ּ, ȣƮ, directory |
| : | Extension |
| : | mod_ident |
| : | ġ 2.1 core Դ |
þ RFC
1413 ̿Ͽ Ŭ̾Ʈ ӽ identd Ѵٸ
ῡ ڸ α Ѵ. Ĺڿ
%...l Ͽ α Ѵ.
û ˻ ؾ ϱ Ǵ
϶. ߰ ȭ̳ Ͻü
ִٸ, Ƹ ˻ ̰ û IdentityCheckTimeout þ
Ѹŭ Ѵ. ͳ
ʴ.
Apache HTTP サーバ バージョン 2.4
| 説明: | サーバの設定の包括的な概観を提供する |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | info_module |
| ソースファイル: | mod_info.c |
mod_info を設定するには、以下を httpd.conf
ファイルに加えます。
<Location /server-info>
SetHandler server-info
</Location>
<Location>
の中で mod_access を使って、サーバ設定情報への
アクセスを制限したいと思うかもしれません :
<Location /server-info>
SetHandler server-info
Order deny,allow
Deny from all
Allow from yourcompany.com
</Location>
一旦設定すると、http://your.host.example.com/server-info
にアクセスすることでサーバの情報を得られるようになります。
一旦 mod_info がサーバに読み込まれると、
提供しているハンドラ機能はディレクトリ毎の設定ファイル (例えば
.htaccess) を含む すべての設定ファイルで有効になります。
このモジュールを有効にするときはセキュリティの問題を考慮する必要が
あるでしょう。
特に、このモジュールはシステムパス、ユーザ名/パスワード、 データベース名など、他の Apache モジュールの設定ディレクティブから セキュリティ上微妙な情報を漏らす可能性があります。 ですから、このモジュールはきちんとアクセス制御された環境でのみ、 注意して使ってください。
設定情報へのアクセスを制限するために、mod_authz_host を
使うのが良いでしょう。
<Location /server-info>
SetHandler server-info
Order allow,deny
# Allow access from server itself
Allow from 127.0.0.1
# Additionally, allow access from local workstation
Allow from 192.168.1.17
</Location>
デフォルトでは、サーバ情報はすべての有効なモジュールと、 各モジュールについて、モジュールが理解するディレクティブ、 実装している、フック、現時点での設定の関連するディレクティブに なっています。
server-info リクエストへクエリーを追加することで、
設定情報の他の表示形式を選ぶことができます。例えば、
http://your.host.example.com/server-info?config は
すべての設定ディレクティブを表示します。
?<module-name>?config?hooks?list?servermod_info は、元の設定ファイルを読むのではなく、
既にパースされた設定を読み込むことで情報を提供します。従って、
パース済みの設定情報の木が生成される方法による制限がいくつかあります:
ServerRoot,
LoadModule,
LoadFile があります。Include,
<IfModule>,
<IfDefine>,
のような設定ファイル自身を制御するディレクティブは表示されません。
そのディレクティブの中にあり、有効になっているディレクティブは
表示されます。.htaccess ファイルの設定ディレクティブは表示されません
(永久的なサーバ設定の一部ではないからです)。<Directory>
のようなコンテナディレクティブは普通に表示されますが、
mod_info は閉じタグの </Directory> などの数を知ることはできません。mod_perl のようなサードパーティモジュール
のディレクティブは表示されないかもしれません。| 説明: | server-info ハンドラにより表示されるモジュールの情報に 追加の情報を付け加える |
|---|---|
| 構文: | AddModuleInfo module-name string |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_info |
| 互換性: | Apache 1.3 以降 |
これは、string の内容がモジュール module-name の追加情報 として HTML として解釈され、表示されるようにします。例:
AddModuleInfo mod_deflate.c 'See <a \
href="http://www.apache.org/docs/2.4/mod/mod_deflate.html">\
http://www.apache.org/docs/2.4/mod/mod_deflate.html</a>'
Apache HTTP サーバ バージョン 2.4
| 説明: | サーバに送られたリクエストの forensic ロギング |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | log_forensic_module |
| ソースファイル: | mod_log_forensic.c |
| 互換性: | mod_unique_id はバージョン 2.1 からは必須では
なくなった |
このモジュールはクライアントリクエストの forensic ロギングを 行ないます。ログ収集はリクエストの処理の前と後に行なわれますので、 forensic ログは各リクエストに対して二行ログ収集します。 Forensic ロガーは非常に厳密です。これは以下のことを意味します:
CoreDumpDirectory ディレクティブの設定に依ります)。Forensic ログの出力を検査するためには、
配布物の support ディレクトリにある check_forensic
スクリプトが役に立つでしょう。
各リクエストは2回ログ収集されます。最初はリクエストが処理される 前 (つまり、ヘッダを受け取った後) です。2度目のログは リクエストが処理された後、通常のログ収集と同じときに 行なわれます。
各リクエストを識別するために、リクエストには
一意なリクエスト ID が割り当てられます。この forensic ID は
フォーマット文字列 %{forensic-id}n を使うことで
通常の transfer ログにログ収集することもできます。
mod_unique_id を使っている場合は、それが生成する
ID が使われます。
最初の行は forensic ID、リクエスト行と受け取ったすべてのヘッダを
パイプ文字 (|) で分離してログ収集します。
例えば以下のようになります (実際はすべて同じ行になります):
+yQtJf8CoAB4AAFNXBIEAAAAA|GET /manual/de/images/down.gif
HTTP/1.1|Host:localhost%3a8080|User-Agent:Mozilla/5.0 (X11;
U; Linux i686; en-US; rv%3a1.6) Gecko/20040216
Firefox/0.8|Accept:image/png, etc...
最初のプラス文字がこのログは最初のログであることを示します。 二番目の行はマイナス文字と ID のみです:
-yQtJf8CoAB4AAFNXBIEAAAAA
check_forensic スクリプトは引数としてログファイルの名前を
取ります。+/- の ID の組を調べ、完了していない
リクエストがある場合は警告を発します。
ログファイルが保存されるディレクトリがサーバを起動したユーザ 以外で書き込み可能になっているときにセキュリティが破られる可能性が あることについての詳細はセキュリティのこつを 参照してください。
| 説明: | Forensic ログのファイル名を設定する |
|---|---|
| 構文: | ForensicLog filename|pipe |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_log_forensic |
ForensicLog ディレクティブは forensic 解析のための
サーバへのリクエストをログ収集に使います。
各ログエントリには、普通の CustomLog ディレクティブを使ってリクエストと関連付けることの
できる
一意な ID が割り当てられます。mod_log_forensic は
forensic-id というトークンを作成し、フォーマット文字列
%{forensic-id}n を使うことでそのトークンを transfer ログに
追加することができます。
引数はログが書き出される位置を指定し、以下の 2種類の値のどちらかを 取ることができます:
ServerRoot からの
相対ファイル名|" と、その後にログ情報を標準入力から
受け取るプログラム。プログラム名は ServerRoot からの相対パスとしても
指定できます。
プログラムを使う場合、そのプログラムは httpd を起動したユーザで
実行されます。つまり、サーバが root で実行された場合は root で
実行されるということです。プログラムが安全であるか、より権限の少ない
ユーザに切り替えるようになっていることを確かめてください。
Unix 以外のプラットフォームでファイル名を入力するときは、 プラットフォームがバックスラッシュの使用を許可している場合でも、 スラッシュのみが使われるように気をつけてください。 普通は設定ファイルすべてにおいて、スラッシュの方を使用するように してください。
Apache HTTP Server Version 2.4
| : | û Ʈ |
|---|---|
| : | Extension |
| : | logio_module |
| ҽ: | mod_logio.c |
û Ʈ Ѵ. ڴ Ʈ ְ Ʈ Ÿ, û Ѵ. Է SSL/TLS , SSL/TLS Ŀ ȣȭ ùٷ ݿȴ.
Ϸ mod_log_config
ʿϴ.
ΰ ο αþ ߰Ѵ. ûü
Ư Ĺڿ "%" þ Ͽ Ѵ.
þ αϿ Ѵ:
| Ĺڿ | |
|---|---|
%...I |
û Ͽ Ʈ. 0 . |
%...O |
Ͽ Ʈ. 0 . |
Ѵ:
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\" %I %O"| : | Enable tracking of time to first byte (TTFB) |
|---|---|
| : | LogIOTrackTTFB ON|OFF |
| ⺻: | LogIOTrackTTFB OFF |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | All |
| : | Extension |
| : | mod_logio |
| : | Apache HTTP Server 2.4.13 and later |
The documentation for this directive has not been translated yet. Please have a look at the English version.
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Çok evreli ve çok süreçli melez bir HTTP sunucusu oluşturan çok süreçlilik modülü. |
|---|---|
| Durum: | MPM |
| Modül Betimleyici: | mpm_worker_module |
| Kaynak Dosyası: | worker.c |
Bu çok süreçlilik modülü (MPM) hem çok süreçli hem de çok evreli olabilen melez bir sunucu oluşturur. İstekleri sunmak için evreleri kullanması sebebiyle çok süreçli bir sunucudan daha az sistem kaynağı harcayarak daha çok isteğe hizmet sunabilir. Bununla birlikte, herbiri çok sayıda evreye sahip çok sayıda süreci canlı tutarak bir çok süreçli sunucu kadar kararlı olur.
Bu MPM’i denetim altında tutmakta kullanılan en önemli yönergeler, her
çocuk süreç için konuşlandırılacak evre sayısını belirleyen ThreadsPerChild yönergesi ile devreye
sokulacak toplam evre sayısının azamisini belirleyen MaxRequestWorkers yönergesidir.
CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers ThreadLimit ThreadsPerChild ThreadStackSize UserÇocuk süreçleri devreye almaktan tek bir süreç (ana süreç) sorumludur.
Her çocuk süreç ThreadsPerChild yönergesinde belirtilen sayıda evre
konuşlandırır. Bunlardan ayrı olarak, bir dinleyici evre bağlantıları
dinleyip gelenleri işlenmek üzere bu sunucu evrelerinden birine
aktarır.
Apache HTTP Sunucusu daima, gelen isteklere hizmet sunmaya hazır
yedek
veya boştaki sunucu evrelerinden oluşan bir havuzu canlı tutmaya
çalışır. Bu suretle, istemcilere isteklerinin sunulması için yeni çocuk
süreçlerin çatallanmasını, dolayısıyla yeni evrelerin
konuşlandırılmasını beklemek gerekmez. Başlangıçta çalıştırılacak çocuk
süreçlerin sayısı StartServers yönergesinde belirtilir.
Apache httpd, çalışma süresi boyunca MinSpareThreads ve MaxSpareThreads yönergeleri ile belirtilen sınırlar
dahilinde kalmak üzere gerektiğinde süreçleri öldürerek gerektiğinde
yenilerini devreye alarak tüm süreçlerdeki toplam evre sayısını sabit
tutmaya çalışır. Bu işlem kendiliğinden çok iyi yürüdüğünden bu
yönergelere öntanımlı değerlerinden farklı değerlerin atanması nadiren
gerekli olur. Aynı anda hizmet sunulabilecek istemcilerin sayısı (yani,
tüm süreçlerin toplam evre sayısı) MaxRequestWorkers yönergesi ile belirlenir. Etkin çocuk
süreçlerin sayısı ise MaxRequestWorkers yönergesindeki değerin ThreadsPerChild yönergesindeki değere
bölünmesi ile elde edilir.
Bu iki yönerge aynı anda etkin olabilecek çocuk süreçlerin ve her
çocuk süreçteki sunucu evreleri sayısının üst sınırını belirler ve bu
sınır sadece ana sunucu tamamen durdurulup yeniden başlatılarak
değiştirilebilir. ServerLimit yönergesinin değeri etkin çocuk süreç
sayısının üst sınırı olup MaxRequestWorkers yönergesindeki değerin ThreadsPerChild yönergesindeki değere
bölünmesi ile elde değere eşit veya bundan küçük olması gerekir.
ThreadLimit yönergesinin
değeri ise sunucu evreleri sayısının üst sınırını belirler ve ThreadsPerChild yönergesindeki değerden
büyük veya ona eşit olması gerekir.
Sonlandırma sırasında etkin çocuk süreçlere ek olarak mevcut istemci
bağlantılarını işleme sokmaya çalışan tek bir sunucu evresinden başka
fazladan bir çocuk süreç etkin kalabileceği gibi sonlandırılacak süreç
sayısının en fazla MaxRequestWorkers olması gerekirse de gerçekte sayı bundan
küçük olabilir. Şöyle bir işlemle tek bir çocuk sürecin sonlandırılması
iptal edilerek bu gibi durumlara karşı önlem alınabilir:
MaxConnectionsPerChild
yönergesinin değeri sıfır yapılır.MaxSpareThreads ve
MaxRequestWorkers
yönergelerinin değerleri birbirine eşitlenir.worker modülünün öntanımlı süreç-evre yapılandırması
genelde şöyledir:
ServerLimit 16 StartServers 2 MaxRequestWorkers 150 MinSpareThreads 25 MaxSpareThreads 75 ThreadsPerChild 25
Unix altında 80. portu dinleyebilmek için ana sürecin root tarafından
çalıştırılmış olması gerekirse de çocuk süreçler ve evreler Apache
httpd tarafından daha az yetkili bir kullanıcının aidiyetinde
çalıştırılırlar. Apache httpd’nin çocuk süreçlerinin kullanıcı ve
gruplarını ayarlamak için User
ve Group yönergeleri
kullanılır.
Çocuk süreçlerin sunacakları içeriği okumaya yetkili olmaları gerekir,
fakat bu yetkinin mümkün olduğunca kısıtlı tutulmasına çalışılmalıdır.
Bundan başka, suexec kullanılmadığı takdirde, bu
yönergeler CGI betikleri tarafından miras alınacak yetkili kullanıcı
ve grubu da ayarlarlar.
MaxConnectionsPerChild
yönergesi ana sunucunun eski süreçleri öldürüp yenilerini oluşturmayı
ne kadar sıklıkla yapacağını denetler.
Bu MPM, gürleyen sürü sorunu ortaya çıktığında (genelde çok sayıda
dinlenen soket varlığında) gelen bağlantılara erişimi dizgileştirmek için
mpm-accept muteksini kullanır. Bu muteksin gerçeklenimle
ilgili hususları Mutex yönergesi ile
yapılandırılabilir. Bu muteks hakkında ek bilgi için başarımın arttırılması
belgesine bakınız.
Apache HTTP サーバ バージョン 2.4
| 説明: | コンテントネゴシエーション 機能を提供する |
|---|---|
| ステータス: | Base |
| モジュール識別子: | negotiation_module |
| ソースファイル: | mod_negotiation.c |
コンテントネゴシエーション、より正確にはコンテンツの選択機能は、 複数用意されているドキュメントから、クライアントの能力に一番合った ドキュメントを選択する機能です。この実装は二つあります。
type-map
ハンドラで扱われるファイル)。これは variants
を含んでいるファイルを明示的に指定します。MultiViews Option で有効になります)。
サーバが暗黙の内にファイル名のパターンマッチを行ない、
その結果から選択します。タイプマップは RFC 822 のメールヘッダに類似した書式です。 ドキュメントの記述が空行で分離されて書かれていて、ハッシュ文字 ('#') で始まる行はコメントとして扱われます。 ドキュメントの説明は複数のヘッダレコードから構成されます。 レコードは、続きの行が空白で始まっていると複数の行にまたがります。 最初の空白が消去されて、前の行とつなげて 1 行として扱われます。 ヘッダレコードはキーワード名の後に値が続くという形式で、 キーワード名は常にコロンで終わります。空白はヘッダ名と値の間、 値のトークンの間に入れることができます。 使用可能なヘッダは以下のとおりです:
Content-Encoding:AddEncoding ディレクティブ
で定義されたエンコーディングだけを認識します。通常 compress
されたファイルのための x-compress と gzip
されたファイルのための x-gzip を含みます。
エンコーディングの比較をするときは、接頭辞 x-
は無視されます。Content-Language:en
は英語を表します。
複数の言語が格納される場合はコンマで区切られます。Content-Length:Content-Type:name=value
で、メディアタイプや他のパラメータとはセミコロンで分離されます。
共通のパラメータは以下のとおり:
leveltext/html では 2 がデフォルトで、その他の場合は
0 がデフォルトです。qsqs
はリソース毎に特有の値を取ります。
Content-Type: image/jpeg; qs=0.8
URI:Body:
Body:----xyz----
<html>
<body>
<p>Content of the page.</p>
</body>
</html>
----xyz----
MultiViews 探索は、Multiviews Options ディレクティブにより有効になります。
サーバが /some/dir/foo
へのリクエストを受け取り、/some/dir/foo が存在
しない場合、サーバはディレクトリを読んで、
foo.* にあてはまる全てのファイルを探し、
事実上それらのファイルをマップするタイプマップを作ります。
そのとき、メディアタイプとコンテントエンコーディングは、
そのファイル名を直接指定したときと同じものが割り当てられます。
それからクライアントの要求に一番合うものを選び、
そのドキュメントを返します。
ファイルを選択する際に、関連するコンテントネゴシエーションの
メタ情報を持たないファイルについて、判定を行うかどうかを
MultiViewsMatch
ディレクティブで設定します。
| 説明: | コンテントネゴシエーションされたドキュメントをプロキシサーバが キャッシュできるようにする |
|---|---|
| 構文: | CacheNegotiatedDocs On|Off |
| デフォルト: | CacheNegotiatedDocs Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Base |
| モジュール: | mod_negotiation |
| 互換性: | バージョン 2.0で構文が変わりました |
このディレクティブが設定されていると、コンテントネゴシエーション をした結果のドキュメントのキャッシュを許可します。 これは、プロキシの後ろにいるクライアントが能力に一番合った ドキュメントではなく、 キャッシュをより効果的にするものを得る可能性があるということです。
このディレクティブは HTTP/1.0 ブラウザからのリクエスト のみに適用されます。HTTP/1.1 は、 交渉されたドキュメントのキャッシュに対してずっとよい制御が可能なので、 このディレクティブは HTTP/1.1 のリクエストには影響しません。
2.0 より前のバージョンでは、
CacheNegotiatedDocs は引数を取らず、
ディレクティブが存在することで on の動作をしていました。
| 説明: | 要求に合う単独のドキュメントが見つからなかったときに行なうことを指定 |
|---|---|
| 構文: | ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] |
| デフォルト: | ForceLanguagePriority Prefer |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_negotiation |
| 互換性: | バージョン 2.0.30 以降で使用可能 |
ForceLanguagePriority ディレクティブは
要求に合うドキュメントを一つだけ返すことができないときに、
LanguagePriority
ディレクティブを使ってネゴシエーションの結果を返します。
ForceLanguagePriority Prefer は、同等の選択肢が
いくつかあるときに、HTTP の 300 (MULTIPLE CHOICES) を返す代わりに、
LanguagePriority を使って一つだけドキュメントを返すように
します。以下のディレクティブが指定されていて、ユーザの Accept-Language
ヘッダでは en と de の品質が共に
.500 (同じくらい許容) であるときは、
最初にマッチする variant の en が送られます。
LanguagePriority en fr de
ForceLanguagePriority Prefer
ForceLanguagePriority Fallback では、HTTP 406
(NOT ACCEPTABLE) を送信する代わりに、
LanguagePriority
が正しい結果を送ります。
以下のディレクティブが指定されていて、ユーザの Accept-Language
が es 言語のみを許可していて、さらにそのような variant がないときには、
以下の LanguagePriority
のリストの最初の variant が送られます。
LanguagePriority en fr de
ForceLanguagePriority Fallback
Prefer と Fallback の両方のオプションを
同時に指定することができます。
ですから、複数の variant があるときは
LanguagePriority の最初の
variant が送られ、クライアントの許容言語に合う vaiant がないときは
存在するドキュメントで最初のものが送られる、という様にすることができます。
| 説明: | クライアントが優先度を示さなかったときの言語の variant の優先度を 指定 |
|---|---|
| 構文: | LanguagePriority MIME-lang [MIME-lang]
... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_negotiation |
LanguagePriority は、MultiViews
リクエストを扱うときに、クライアントが優先順位を提供していない場合の
言語の優先順位を設定します。MIME-lang
のリストが優先度の降順に並びます。
LanguagePriority en fr de
foo.html がリクエストされ、foo.html.fr
と foo.html.de が両方存在し、
ブラウザが言語の優先順位を提供してない場合は
foo.html.fr が返されます。
このディレクティブは他の方法で「最善」
の言語が決定できないときか、ForceLanguagePriority ディレクティブが
None 以外のときにのみ効果があることに注意してください。
一般的には、サーバ側ではなくクライアント側で好みの言語を決定します。
Apache HTTP サーバ バージョン 2.4
| 説明: | マルチスレッドとマルチプロセスのハイブリッド型 ウェブサーバを実装したマルチプロセッシングモジュール |
|---|---|
| ステータス: | MPM |
| モジュール識別子: | mpm_worker_module |
| ソースファイル: | worker.c |
このマルチプロセッシングモジュール (MPM) は、マルチスレッドとマルチプロセスのハイブリッド型サーバを 実装しています。リクエストの応答にスレッドを使うと、 プロセスベースのサーバよりも少ないシステム資源で、 多くのリクエストに応答することができます。 それにもかかわらず、多くのスレッドを持った複数のプロセスを 維持することで、 プロセスベースのサーバの持つ安定性も保持しています。
この MPM を制御するのに使われる最も重要なディレクティブは、
ThreadsPerChild と
MaxClients です。
ThreadsPerChild は
各子プロセスで用意されるスレッド数を制御して、
MaxClients は
起動されるスレッドの総数の最大値を制限します。
CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers ThreadLimit ThreadsPerChild ThreadStackSize User一つの制御用プロセス (親) が子プロセスを起動します。
子プロセスは
ThreadsPerChild
ディレクティブで指定された一定数のサーバスレッドと接続を
listen するスレッドを一つ作ります。
Listener スレッドは接続が来たときにサーバプロセスに渡します。
Apache はスペアの、つまりアイドルなサーバスレッドの
プールを常に維持していて、それらは入ってくるリクエストに
答えられるように待機しています。
このようにして、クライアントはリクエストの応答が得られるようになるために
新しいスレッドやプロセスが生成されるのを
待たなくてもよいようになっています。
起動初期時のプロセス総数は、
StartServers
ディレクティブで設定されます。稼働中に、
Apache は全プロセスのアイドルスレッドの合計数を見積もって、
MinSpareThreads と
MaxSpareThreads
で指定された範囲の中にこの数が収まるように fork したり
kill したりします。この操作は非常に自律的なので、
これらのディレクティブをデフォルト値から変更する必要は
めったにないでしょう。
同時に応答することのできるクライアント数の最大数
(つまり全プロセス中の総スレッド数の最大値) は
MaxClients
ディレクティブで決定されます。
活動中の子プロセス数の最大値は
MaxClients を
ThreadsPerChild で割った
ものになります。
活動中の子プロセスの数と子プロセス中のサーバスレッドの数の越えられない
上限を設定するディレクティブが二つあります。これらはサーバを
完全に停止して、再起動することでしか変更することはできません。
ServerLimit
は活動中の子プロセスの越えられない上限を設定し、
MaxClients ディレクティブ
の値を
ThreadsPerChild の値で割った値以上である
必要があります。ThreadLimit は
サーバスレッドの越えられない上限で、ThreadsPerChild ディレクティブの
値以上である必要があります。
活動中の子プロセス群に加えて、少なくとも一つのサーバスレッドが
既存のクライアントからの接続を扱っている終了しようとしている
子プロセスがある可能性があります。終了中のプロセスは MaxClients で指定された数まで
存在できますが、実際に期待される数はずっと少なくなります。この
振舞いは各子プロセスを終了させないようにすることで回避できます。
これは以下の様にして実現できます。
MaxRequestsPerChild の値を 0 に設定する
MaxSpareThreads の値を
MaxClients
と同じ値にするworker MPM の典型的なプロセス・スレッド制御の
設定では、次のようになります。
ServerLimit 16
StartServers 2
MaxClients 150
MinSpareThreads 25
MaxSpareThreads 75
ThreadsPerChild 25
通常 Unix では親プロセスは 80 番ポートにバインドするために
root で起動されますが、子プロセスやスレッドは
もっと低い権限のユーザで Apache によって起動されます。
User と
Group ディレクティブは
Apache の子プロセスの権限を設定するのに用いられます。
子プロセスはクライアントに送るコンテンツ全てを読めないといけませんが、
可能な限り必要最小限の権限のみを持っているようにするべきです。
さらに、suexec
が使用されていない限り、これらのディレクティブは
CGI スクリプトで継承される権限も設定します。
MaxRequestsPerChild
は、古いプロセスを停止して新しいプロセスを起動することによって、
どの程度の頻度でサーバがプロセスをリサイクルするかを制御します。
Serveur HTTP Apache Version 2.4
Ci-dessous se trouve la liste de tous les modules qui font partie de la distribution du serveur HTTP Apache. Voir aussi la liste alphabétique complète de toutes les directives du serveur HTTP Apache.
worker conçue pour ne
mobiliser des threads que pour les connexions en cours de traitementA | B | C | D | E | F | H | I | L | M | N | P | R | S | U | V | W | X
ls, ou à la commande
shell Win32 dirmod_davmod_davExpires et
Cache-Control en fonction de critères spécifiés par
l'utilisateurmod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxy_balancer basé sur le comptage de trafic Heartbeatmod_proxymod_proxy pour le support de
la répartition de chargemod_proxy pour le traitement
des requêtes CONNECTmod_proxy pour le mandatement
dynamique inverse de massemod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxy supportant les
websocketssedServeur HTTP Apache Version 2.4
| Description: | Une variante du MPM worker conçue pour ne
mobiliser des threads que pour les connexions en cours de traitement |
|---|---|
| Statut: | MPM |
| Identificateur de Module: | mpm_event_module |
| Fichier Source: | event.c |
Le module multi-processus (MPM) event est conçu
pour permettre le traitement d'un nombre accru de requêtes
simultanées en déléguant certaines tâches
aux threads d'écoute, libérant par là-même les
threads de travail et leur permettant de traiter les nouvelles requêtes.
Pour utiliser le MPM event, ajoutez
--with-mpm=event aux arguments du script
configure lorsque vous compilez le programme
httpd.
AsyncRequestWorkerFactor CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ScoreBoardFile SendBufferSize ServerLimit StartServers ThreadLimit ThreadsPerChild ThreadStackSize UserLe MPM event s'inspire du MPM worker qui
implémente un serveur hybride multi-processus et multi-threads. Un processus de
contrôle unique (le parent) est chargé de lancer des processus enfants. Chaque
processus enfant crée un nombre de threads serveurs défini via la directive
ThreadsPerChild, ainsi qu'un thread
d'écoute qui surveille les requêtes entrantes et les distribue aux threads de
travail pour traitement au fur et à mesure de leur arrivée.
Les directives de configuration à l'exécution sont identiques à celles que
propose le MPM worker, avec l'unique addition de la directive
AsyncRequestWorkerFactor.
Ce module MPM tente de résoudre le "problème keep alive" de HTTP. Lorsqu'un client a effectué une première requête, il peut garder la connexion ouverte et envoyer les requêtes suivante en utilisant le même socket, ce qui diminue considérablement la charge qui aurait été induite par la création de nouvelles connexions TCP. Cependant, le fonctionnement du serveur HTTP Apache impose de réserver un couple processus enfant/thread pour attendre les données en provenance du client, ce qui présente certains inconvénients. Pour résoudre ce problème, le MPM Event utilise un thread d'écoute dédié pour chaque processus pour gérer les sockets d'écoute, tous les sockets qui sont dans un état de connexion persistante, les sockets où les filtres de gestionnaire et de protocole ont fait leur travail, et ceux pour lesquels la seule chose restant à faire est l'envoi des données au client.
Cette nouvelle architecture, en exploitant les sockets non blocants et
les fonctionnalités des noyaux modernes mis en valeur par
APR (comme epoll de Linux), n'a plus besoin du
Mutex mpm-accept pour
éviter le problème de "thundering herd".
La directive AsyncRequestWorkerFactor permet de
définir le nombre total de connexions qu'un bloc processus/thread peut
gérer.
Avec les MPM précédents, les connexions asynchrones nécessitaient
un thread de travail dédié, mais ce n'est plus le cas avec le MPM Event.
La page d'état de mod_status montre de nouvelles
colonnes dans la section "Async connections" :
write() vers le socket
renvoie en général EWOULDBLOCK ou EAGAIN
pour que l'on puisse y écrire à nouveau après un certain temps
d'inactivité. Le thread de travail qui utilise le socket doit alors
être en mesure de récupérer la tâche en attente et la restituer au
thread d'écoute qui, à son tour, la réattribuera au premier thread
de travail disponible, lorsqu'un évènement sera généré pour le socket
(par exemple, "il est maintenant possible d'écrire dans le socket").
Veuillez vous reporter à la section à propos des limitations pour
plus de détails.
KeepAliveTimeout est atteint, le socket
sera fermé par le thread d'écoute. Les threads de travail n'ont
donc plus à s'occuper des sockets inactifs et ils peuvent être
réutilisés pour traiter d'autres requêtes.Ces améliorations sont disponible pour les connexions HTTP ou HTTPS.
Ce MPM présentait dans le passé des limitations de montée en
puissance qui
provoquaient l'erreur suivante : "scoreboard is full, not at
MaxRequestWorkers". La directive MaxRequestWorkers permet de limiter le
nombre de requêtes pouvant être servies simultanément à un moment donné
ainsi que le nombre de processus autorisés (MaxRequestWorkers / ThreadsPerChild), alors que le
scoreboard représente l'ensemble des processus en cours d'exécution et
l'état de leurs threads de travail. Si le scoreboard est plein
(autrement dit si aucun des threads n'est dans un état inactif) et si le
nombre de requêtes actives servies est inférieur à MaxRequestWorkers, cela signifie que
certains d'entre eux bloquent les nouvelles requêtes qui pourraient être
servies et sont en l'occurrence mises en attente (dans la limite de la
valeur imposée par la directive ListenBacklog). La plupart du temps, ces
threads sont bloqués dans un état d'arrêt en douceur car ils attendent
de terminer leur travail sur une connexion TCP pour s'arrêter et ainsi libérer
une entrée dans le scoreboard (par exemple dans le cas du traitement des
requêtes de longue durée, des clients lents ou des connexions en
keep-alive). Voici deux scénarios courants :
MaxSpareThreads). Cette situation
est problèmatique car lorsque la charge augmente à nouveau, httpd va
essayer de lancer de nouveaux processus. Si cette situation se
répète, le nombre de processus peut augmenter sensiblement,
aboutissant à un mélange d'anciens processus tentant de s'arrêter et
de nouveaux processus tentant d'effectuer un travail quelconque.
A partir de la version 2.4.24, mpm-event est plus intelligent et peut traiter les arrêts graceful de manière plus efficace. Voici certaines de ces améliorations :
ServerLimit. Les directives
MaxRequestWorkers et
ThreadsPerChild
permettent de limiter le nombre de processus actifs, alors que la
directive ServerLimit
prend aussi en compte les proccessus en arrêt graceful pour
permettre l'utilisation d'entrées supplémentaires du scoreboard en
cas de besoin. L'idée consiste à utiliser ServerLimit pour indiquer à httpd
conbien de processus supplémentaires seront tolérés avant
d'atteindre les limites imposées par les ressources du système.
Le comportement décrit dans le dernier point est bien visible via
mod_status dans la table des connexions avec les deux
nouvelles colonnes "Slot" et "Stopping". La première indique le PID et
la seconde si le processus est en cours d'arrêt ou non ; l'état
supplémentaire "Yes (old gen)" indique un processus encore en exécution
après un redémarrage graceful.
La gestion améliorée des connexions peut ne pas fonctionner pour
certains filtres de connexion qui se sont déclarés eux-mêmes
incompatibles avec le MPM Event. Dans ce cas, le MPM Event réadoptera le
comportement du MPM worker et réservera un thread de
travail par connexion. Notez que tous les modules inclus dans la
distribution du serveur httpd sont compatibles avec le MPM Event.
Une restriction similaire apparaît lorsqu'une requête utilise un
filtre en sortie qui doit pouvoir lire et/ou modifier la totalité du
corps de la réponse. Si la connexion avec le client se bloque pendant
que le filtre traite les données, et si la quantité de données produites
par le filtre est trop importante pour être stockée en mémoire, le
thread utilisé pour la requête n'est pas libéré pendant que httpd attend
que les données soient transmises au client.
Pour illustrer ce cas de figure, nous pouvons envisager les deux
situations suivantes : servir une ressource statique (comme un fichier
CSS) ou servir un contenu issu d'un programme FCGI/CGI ou d'un serveur
mandaté. La première situation est prévisible ; en effet, le MPM Event a
une parfaite visibilité sur la fin du contenu, et il peut utiliser les
évènements : le thread de travail qui sert la réponse peut envoyer les
premiers octets jusqu'à ce que EWOULDBLOCK ou
EAGAIN soit renvoyé, et déléguer le reste de la réponse au thread
d'écoute. Ce dernier en retour attend un évènement sur le socket, et
délègue le reste de la réponse au premier
thread de travail disponible. Dans la deuxième situation par contre
(FCGI/CGI/contenu mandaté), le MPM n'a pas de visibilité sur la fin de
la réponse, et le thread de travail doit terminer sa tâche avant de
rendre le contrôle au thread d'écoute. La seule solution consisterait
alors à stocker la réponse en mémoire, mais ce ne serait pas l'option la
plus sure en matière de stabilité du serveur et d'empreinte mémoire.
Le modèle event a été rendu possible par l'introduction de nouvelles APIs dans les systèmes d'exploitation supportés :
Avant que ces APIs soient mises à disposition, les APIs
traditionnelles select et poll devaient être
utilisées. Ces APIs deviennent lentes si on les utilise pour gérer de
nombreuses connexions ou si le jeu de connexions possède un taux de
renouvellement élevé. Les nouvelles APIs permettent de gérer beaucoup
plus de connexions et leur performances sont meilleures lorsque le jeu
de connexions à gérer change fréquemment. Ces APIs ont donc rendu
possible l'écriture le MPM Event qui est mieux adapté à la situation
HTTP typique où de nombreuses connexions sont inactives.
Le MPM Event suppose que l'implémentation de apr_pollset
sous-jacente est raisonnablement sure avec l'utilisation des threads
(threadsafe). Ceci évite au MPM de devoir effectuer trop verrouillages
de haut niveau, ou d'avoir à réveiller le thread d'écoute pour lui
envoyer un socket keep-alive. Ceci n'est possible qu'avec KQueue et
EPoll.
Ce MPM dépend des opérations atomiques compare-and-swap
d'APR pour la synchronisation des threads. Si
vous compilez pour une plate-forme x86 et n'avez pas besoin du
support 386, ou si vous compilez pour une plate-forme SPARC et
n'avez pas besoin du support pre-UltraSPARC, ajoutez
--enable-nonportable-atomics=yes aux arguments du
script configure. Ceci permettra à APR
d'implémenter les opérations atomiques en utilisant des instructions
performantes indisponibles avec les processeurs plus
anciens.
Ce MPM ne fonctionne pas de manière optimale sur les plates-formes plus anciennes qui ne gèrent pas correctement les threads, mais ce problème est sans objet du fait du prérequis concernant EPoll ou KQueue.
libkse (voir man libmap.conf).glibc a été compilée
avec le support pour EPoll.| Description: | Limite le nombre de connexions simultanées par thread |
|---|---|
| Syntaxe: | AsyncRequestWorkerFactor facteur |
| Défaut: | 2 |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event |
| Compatibilité: | Disponible depuis la version 2.3.13 |
Le MPM event gère certaines connexions de manière asynchrone ; dans ce cas, les threads traitant la requête sont alloués selon les besoins et pour de courtes périodes. Dans les autres cas, un thread est réservé par connexion. Ceci peut conduire à des situations où tous les threads sont saturés et où aucun thread n'est capable d'effectuer de nouvelles tâches pour les connexions asynchrones établies.
Pour minimiser les effets de ce problème, le MPM event utilise deux méthodes :
Cette directive permet de personnaliser finement la limite du nombre de connexions par thread. Un processus n'acceptera de nouvelles connexions que si le nombre actuel de connexions (sans compter les connexions à l'état "closing") est inférieur à :
ThreadsPerChild +
(AsyncRequestWorkerFactor *
nombre de threads inactifs)
Il est possible d'effectuer une estimation du nombre maximum de connexions simultanées pour tous les processus et pour un nombre donné moyen de threads de travail inactifs comme suit :
(ThreadsPerChild +
(AsyncRequestWorkerFactor *
number of idle workers)) *
ServerLimit
ThreadsPerChild = 10
ServerLimit = 4
AsyncRequestWorkerFactor = 2
MaxRequestWorkers = 40
idle_workers = 4 (moyenne pour tous les processus pour faire simple)
max_connections = (ThreadsPerChild + (AsyncRequestWorkerFactor * idle_workers)) * ServerLimit
= (10 + (2 * 4)) * 4 = 72
Lorsque tous les threads de travail sont inactifs, le nombre maximum absolu de connexions simultanées peut être calculé de manière plus simple :
(AsyncRequestWorkerFactor + 1) *
MaxRequestWorkers
ThreadsPerChild = 10 ServerLimit = 4 MaxRequestWorkers = 40 AsyncRequestWorkerFactor = 2
Si tous les threads de tous les processus sont inactifs, alors :
idle_workers = 10
Nous pouvons calculer le nombre maximum absolu de connexions simultanées de deux manières :
max_connections = (ThreadsPerChild + (AsyncRequestWorkerFactor * idle_workers)) * ServerLimit
= (10 + (2 * 10)) * 4 = 120
max_connections = (AsyncRequestWorkerFactor + 1) * MaxRequestWorkers
= (2 + 1) * 40 = 120
Le réglage de la directive
AsyncRequestWorkerFactor nécessite de connaître le
trafic géré par httpd pour chaque style d'utilisation spécifique ; si vous
modifiez la valeur par défaut, vous devrez par conséquent effectuer des
tests approfondis en vous appuyant étroitement sur les données fournies par
mod_status.
La directive MaxRequestWorkers se nommait
MaxClients avant la version 2.3.13. La valeur
ci-dessus montre que cet ancien nom ne correspondait pas à sa
signification exacte pour le MPM event.
La directive AsyncRequestWorkerFactor
accepte des valeurs d'argument de type non entier, comme "1.5".
Serveur HTTP Apache Version 2.4
| Description: | Exécution des scripts CGI en fonction du type de média ou de la méthode de requête. |
|---|---|
| Statut: | Base |
| Identificateur de Module: | actions_module |
| Fichier Source: | mod_actions.c |
Ce module possède deux directives. La directive Action vous permet de lancer
l'exécution de scripts CGI chaque fois qu'un fichier possédant un
certain type de contenu MIME
fait l'objet d'une requête. La directive Script vous permet de lancer
l'exécution de scripts CGI chaque fois que la requête utilise une
méthode particulière. Ceci facilite grandement l'exécution de
scripts qui traitent des fichiers.
| Description: | Active un script CGI pour un gestionnaire ou un type de contenu particulier |
|---|---|
| Syntaxe: | Action type d'action script cgi
[virtual] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_actions |
| Compatibilité: | Le modificateur virtual et le passage de
gestionnaire ont été introduits dans Apache 2.1 |
Cette directive ajoute une action qui va activer script
cgi lorsque type d'action est déclenché par la
requête. script cgi est un chemin URL vers une ressource
qui a été désignée comme script CGI à l'aide des directives
ScriptAlias ou AddHandler. type d'action
peut être soit un gestionnaire, soit
un type de contenu MIME. L'URL
et le chemin du document correspondant sont envoyés en utilisant
les variables d'environnement CGI standards PATH_INFO
et PATH_TRANSLATED. Le gestionnaire utilisé pour cette
requête particulière est transmis à l'aide de la variable
REDIRECT_HANDLER.
# Requests for files of a particular MIME content type: Action image/gif /cgi-bin/images.cgi
Dans cet exemple, les requêtes pour des fichiers possédant
le type de contenu MIME image/gif seront traitées par
le script CGI /cgi-bin/images.cgi.
# Files of a particular file extension AddHandler my-file-type .xyz Action my-file-type "/cgi-bin/program.cgi"
Dans cet exemple, les requêtes pour des fichiers possédant
l'extension .xyz seront traitées par
le script CGI /cgi-bin/programme.cgi.
Le modificateur optionnel virtual permet de
désactiver la vérification de l'existence du fichier demandé. Ceci
peut s'avérer utile, par exemple, si vous voulez utiliser la
directive Action pour des localisations
virtuelles.
<Location "/news">
SetHandler news-handler
Action news-handler "/cgi-bin/news.cgi" virtual
</Location>
| Description: | Active un script CGI dans le cas d'une méthode de requête particulière. |
|---|---|
| Syntaxe: | Script méthode script cgi |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_actions |
Cette directive ajoute une action qui va activer script
cgi lorsqu'un fichier est demandé en utilisant la méthode
méthode. script cgi est le chemin URL d'une
ressource qui a été désignée comme script CGI en utilisant les
directives ScriptAlias ou AddHandler. L'URL et le chemin du
document demandé sont envoyés en utilisant les variables
d'environnement CGI standards PATH_INFO et
PATH_TRANSLATED.
Script PUT et Script put ont des effets
totalement différents.
Notez que la commande Script ne définit
que des actions par défaut. Si un script CGI est appelé, ou toute
autre ressource capable de gérer la méthode de la requête en
interne, il agira en conséquence. Notez aussi que
Script avec une méthode GET ne
sera appelé que si la requête possède des arguments (par exemple
foo.html?hi). Dans le cas contraire, la requête sera traitée
normalement.
# All GET requests go here Script GET "/cgi-bin/search" # A CGI PUT handler Script PUT "/~bob/put.cgi"
Apache HTTP サーバ バージョン 2.4
| 説明: | 負荷分散のための mod_proxy 拡張 |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | proxy_balancer_module |
| ソースファイル: | mod_proxy_balancer.c |
| 互換性: | 2.1 以降 |
本モジュールには mod_proxy が必要です。
HTTP, FTP と AJP13
プロトコルのロードバランス機能を持っています。
ですから、 ロードバランスを有効にする場合 mod_proxy
と mod_proxy_balancer がサーバに組み込まれて
いなければいけません。
安全なサーバにするまでプロクシ機能は有効にしないでください。 オープンプロキシサーバはあなた自身のネットワークにとっても、 インターネット全体にとっても危険です。
このモジュールにディレクティブはありません。
現時点では 2 種類のロードバランサスケジューラアルゴリズムから選べます。
リクエスト回数によるもの (訳注: Request Counting)
と、トラフィック量によるもの (訳注: Weighted Traffic Counting)
があります。バランサの設定 lbmethod 値で、どちらを使うか指定します。
詳細は Proxy ディレクティブを
参照してください。
lbmethod=byrequests で有効になります。
このスケジューラの背景にある考え方は、様々なワーカーがそれぞれ、
設定されている分担リクエスト数をきちんと受け取れるように、
リクエストを扱うという考え方です。次のように動作します:
lbfactor は、どの程度ワーカーに仕事を振るか つまりワーカーのクオータを指します。この値は "分担" 量を表す正規化された値です。
lbstatus は、ワーカーのクオータを満たすために どのぐらい急ぎで働かなければならないかを指します。
ワーカーはロードバランサのメンバで、通常は、 サポートされるプロトコルのうちの一つを提供しているリモートホストです。
まず個々のワーカーにワーカークオータを割り振り、どのワーカーが最も急ぎで 働かなければならないか (lbstatus が最大のもの) を調べます。 次に仕事をするようにこのワーカーを選択し、選択したワーカーの lbstatus を全体に割り振ったぶんだけ差し引きます。ですから、lbstatus の総量は 結果的に変化しません(*)し、リクエストは期待通りに分散されます。
あるワーカーが無効になっても、他のものは正常にスケジュールされ続けます。
for each worker in workers
worker lbstatus += worker lbfactor
total factor += worker lbfactor
if worker lbstatus > candidate lbstatus
candidate = worker
candidate lbstatus -= total factorバランサを次のように設定した場合:
| worker | a | b | c | d |
|---|---|---|---|---|
| lbfactor | 25 | 25 | 25 | 25 |
| lbstatus | 0 | 0 | 0 | 0 |
そして b が無効になった場合、次のようなスケジュールが 行われます。
| worker | a | b | c | d |
|---|---|---|---|---|
| lbstatus | -50 | 0 | 25 | 25 |
| lbstatus | -25 | 0 | -25 | 50 |
| lbstatus | 0 | 0 | 0 | 0 |
| (repeat) | ||||
つまりこのようにスケジュールされます: a c d a c d a c d ... 次の点に注意してください:
| worker | a | b | c | d |
|---|---|---|---|---|
| lbfactor | 25 | 25 | 25 | 25 |
この挙動は、次の設定と全く同じになります:
| worker | a | b | c | d |
|---|---|---|---|---|
| lbfactor | 1 | 1 | 1 | 1 |
This is because all values of lbfactor are normalized with respect to the others. For:
lbfactor は全て正規化されたもので、 他との相対値だからです。次の設定では:
| worker | a | b | c |
|---|---|---|---|
| lbfactor | 1 | 4 | 1 |
ワーカー b は、平均して、a と c の 4 倍の数のリクエストを受け持つことになります。
次のような非対称な設定では、こうなると予想されるでしょう:
| worker | a | b |
|---|---|---|
| lbfactor | 70 | 30 |
| lbstatus | -30 | 30 |
| lbstatus | 40 | -40 |
| lbstatus | 10 | -10 |
| lbstatus | -20 | 20 |
| lbstatus | -50 | 50 |
| lbstatus | 20 | -20 |
| lbstatus | -10 | 10 |
| lbstatus | -40 | 40 |
| lbstatus | 30 | -30 |
| lbstatus | 0 | 0 |
| (repeat) | ||
スケジュールは 10 スケジュール後に繰り返され、a 7 回と b 3 回でまばらに選ばれます。
lbmethod=bytraffic で有効になります。
このスケジューラの背景にある考え方は、Request Counting
と非常に似ていますが、次の違いがあります:
lbfactor は どれだけのバイト数のトラフィック量を、 このワーカーに処理してもらいたいか を表します。 この値も同様に正規化された値で、ワーカー全体のうちでの "分担" 量を表現しています。リクエスト数を単純に数える代わりに、 どれだけの転送量を処理したかを数えます。
次のようにバランサを設定した場合:
| worker | a | b | c |
|---|---|---|---|
| lbfactor | 1 | 2 | 1 |
b には a や c の 2 倍 処理してほしいということになります。 b は 2 倍の I/O を処理するという意味になり、 2 倍のリクエスト数を処理するということにはなりません。 ですからリクエストとレスポンスのサイズが、 重み付けと振り分けのアルゴリズムに効いています。
このモジュールは mod_status のサービスを
必要とします。
バランサマネージャを使うと、バランサのメンバーの動的な更新が
できます。バランサマネージャを使って、バランス係数 (lbfactor)
を変更したり、メンバーを変更したり、特定のメンバーを
オフラインモードにしたりできます。
ですから、ロードバランサ管理機能を使いたければ、
mod_status と mod_proxy_balancer
をサーバに組み込まなければなりません。
foo.com ドメインのブラウザからロードバランサ管理機能を
使えるようにするには、次のようなコードを httpd.conf
に追加します。
<Location /balancer-manager>
SetHandler balancer-manager
Order Deny,Allow
Deny from all
Allow from .foo.com
</Location>
こうすると、http://your.server.name/balancer-manager
のページ経由で、ウェブブラウザからロードバランサマネージャに
アクセスできるようになります。
Apache HTTP サーバ バージョン 2.4
| 説明: | リクエストの特徴に基づいた環境変数の設定を可能にする |
|---|---|
| ステータス: | Base |
| モジュール識別子: | setenvif_module |
| ソースファイル: | mod_setenvif.c |
mod_setenvif
モジュールは、リクエストのある側面が指定された正規表現
に合うかどうかによって環境変数を設定する機能を提供します。
これらの環境変数を使用して、サーバの他の部分がどのような動作をするかを
決定することができます。
このモジュールが提供するディレクティブは、
設定ファイルに現れる順番に適用されます。
それを使って、次の例のようにより複雑な設定をすることができます。
これは、ブラウザが mozilla ではあるけれど、MSIE ではないときに
netscape を設定します。
BrowserMatch ^Mozilla netscape
BrowserMatch MSIE !netscape
| 説明: | HTTP User-Agent に基づいて環境変数を設定する |
|---|---|
| 構文: | BrowserMatch regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_setenvif |
BrowserMatch は
SetEnvIf ディレクティブの
特例で、User-Agent HTTP リクエストヘッダに基づいて
環境変数を設定します。以下の 2 行の効果は同じになります:
BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot
その他の例:
BrowserMatch ^Mozilla forms jpeg=yes browser=netscape
BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript
BrowserMatch MSIE !javascript
| 説明: | HTTP User-Agent に基づいて大文字小文字を区別せずに 環境変数を設定する |
|---|---|
| 構文: | BrowserMatchNoCase regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_setenvif |
BrowserMatchNoCase ディレクティブは
意味的には BrowserMatch ディレクティブと
同じです。ただし、このディレクティブは大文字小文字を区別しない
マッチングを行ないます。例えば:
BrowserMatchNoCase mac platform=macintosh
BrowserMatchNoCase win platform=windows
BrowserMatch ディレクティブと
BrowserMatchNoCase ディレクティブは
SetEnvIf ディレクティブと
SetEnvIfNoCase ディレクティブの
特例です。以下の 2 行の効果は同じです:
BrowserMatchNoCase Robot is_a_robot
SetEnvIfNoCase User-Agent Robot is_a_robot
| 説明: | リクエストの属性に基づいて環境変数を設定する |
|---|---|
| 構文: | SetEnvIf attribute
regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_setenvif |
SetEnvIf
ディレクティブは、リクエストの属性に基づいて環境変数を定義します。
最初の引数で指定できる attribute は以下の 4 つのどれかです:
Host,
User-Agent, Referer,
Accept-Language です。リクエストヘッダの集合を現すために
正規表現を使うこともできます。Remote_Host -
リクエストを行なっているクライアントのホスト名 (もしあれば)Remote_Addr -
リクエストを行なっているクライアントの IP アドレスServer_Addr -
リクエストを受け取ったサーバの IP アドレス
(2.0.43 以降のみ)Request_Method -
使用されているメソッド名 (GET, POST
など)Request_Protocol -
リクエストが行なわれたプロトコルの名前とバージョン
(例えば、"HTTP/0.9", "HTTP/1.1" など。)Request_URI -
URL のスキームとホストの後の部分。
追加の情報として、クエリーストリングにマッチさせる場合については
RewriteCond
ディレクティブを参照してください。SetEnvIf ディレクティブが以前のマッチの結果を
使うことができるようになります。この方法のテストでは前の部分にある
SetEnvIf[NoCase] の結果のみを使用可能です。「前」とは、
より広い範囲に対して定義されている (サーバ全体のように) か、現在のディレクティブの
範囲でより前の部分で定義されているか、ということです。
環境変数である可能性は、リクエストの特性に対するマッチが存在せず、
attribute に正規表現が使われなかったときにのみ考慮されます。',' 区切りで連結されます。
oid は文字列型拡張への参照でなければなりません。
二つ目の引数 (regex) は 正規表現です。 これは POSIX.2 の egrep 形式の正規表現と似ています。regex が attribute にマッチする場合は、残りの引数が評価されます。
残りの引数は設定する変数の名前で、設定される値を指定することもできます。 これは、
varname!varnamevarname=valueのどれかの形式になります。
最初の形式では、値は "1" に設定されます。
二つ目はもし値が定義されていればそれを取り除きます。
三つ目は変数を value の与えられた値に設定します。
2.0.51 以降では、value 内に $1..$9
が存在すればそれを認識し、regex の対応する丸括弧で囲まれた部分で
置換します。
SetEnvIf Request_URI "\.gif$" object_is_image=gif
SetEnvIf Request_URI "\.jpg$" object_is_image=jpg
SetEnvIf Request_URI "\.xbm$" object_is_image=xbm
:
SetEnvIf Referer www\.mydomain\.example\.com intra_site_referral
:
SetEnvIf object_is_image xbm XBIT_PROCESSING=1
:
SetEnvIf OID("2.16.840.1.113730.1.13") "(.*)" NetscapeComment=$1
:
SetEnvIf ^TS* ^[a-z].* HAVE_TS
初めの三つはリクエストが画像であるときに環境変数
object_is_image を設定します。四つ目は
参照元のページがウェブサイト www.mydomain.example.com にあるときに
intra_site_referral を設定します。
6番目の例では環境変数 NetscapeComment を定義して、
その値が SSL クライアント証明書の対応するフィールドの文字列であるようにします。
ただし SSL クライアント証明書の対応するフィールドに文字列が存在する
ときにのみ、環境変数は設定されます。
最後の例は、リクエストに "TS" で始まり、値が集合 [a-z] のどれかで
始まるヘッダがあるときに HAVE_TS を設定します。
| 説明: | Sets environment variables based on an ap_expr expression |
|---|---|
| 構文: | |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| ステータス: | Base |
| モジュール: | mod_setenvif |
Documentation not yet translated. Please see English version of document.
| 説明: | リクエストの属性に基づいて大文字小文字を区別せずに環境変数を設定する |
|---|---|
| 構文: | SetEnvIfNoCase attribute regex
[!]env-variable[=value]
[[!]env-variable[=value]] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | FileInfo |
| ステータス: | Base |
| モジュール: | mod_setenvif |
SetEnvIfNoCase は意味的には
SetEnvIf ディレクティブと
同じです。違いは、正規表現のマッチングが大文字小文字を区別しないで
行なわれることです。例えば:
SetEnvIfNoCase Host Apache\.Org site=apache
これは HTTP リクエストヘッダにフィールド Host: が
あり、その値が Apache.Org や apache.org、
その他の大文字小文字の組み合わせであったときに site
環境変数を "apache" に設定します。
Apache HTTP サーバ バージョン 2.4
| 説明: | 起動時や再起動時に実行コードとモジュールをサーバにロードする |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | so_module |
| ソースファイル: | mod_so.c |
| 互換性: | このモジュールは Window では (常に含まれている) Base モジュールです |
いくつかのオペレーティングシステムでは、サーバの再コンパイルをする代わりに、 このモジュールを使用して 動的共有オブジェクト (DSO) 機構により、実行時に Apache HTTP Server にモジュールを読み込ませることが できます。
Unix 上では、読み込まれるコードは通常は共有オブジェクトファイル
(普通 .so という拡張子が付いています) からです。
Windows 上ではこのモジュールの拡張子は .so か .dll
です。
Apache HTTP Server のあるメジャーバージョン向けにビルドされたモジュールは一般に 他のメジャーバージョンでは動きません。(例えば 1.3 と 2.0、 2.0 と 2.2) またメジャーバージョン間ではAPIの変更がしばしば発生し、そのため新しい メジャーバージョン向けにモジュールの修正が必要になることがあります。
Windows 用のロード可能なモジュールを作成するWindows において動的にロードされるモジュールの拡張子は普通 .dll
ですが、Apache httpd のモジュールは mod_whatever.so
といった名前を持ちます。これは、他のプラットフォームでの通常の形式に
あわせたものです。しかしながら、サードパーティ製モジュール、例えばPHPなど、
は今でも .dll の拡張子を使っています。
まだ mod_so で ApacheModuleFoo.dll という名前の
モジュールもロードされますが、新しい名前の付け方を使う方が好まれます。
モジュールを 2.0 用に移植しているのであれば、2.0 の習慣に合うように名前を
修正してください。
Apache httpd のモジュール API は UNIX と Windows 間では変更されていません。 多くのモジュールは全く変更なし、もしくは簡単な変更により Windows で実行できるようになります。ただし、それ以外の Windows には無い Unix アーキテクチャーの機能に依存したモジュールは動作しません。
モジュールが実際に動作するときは、
二つの方法のどちらかでサーバに追加することができます。まず、Unix
と同様にサーバにコンパイルして組み込むことができます。Windows
用の Apache httpd は Unix 用の Apache にある Configure
プログラムがありませんので、モジュールのソースファイルを
ApacheCore プロジェクトファイルに追加し、シンボルを
os\win32\modules.c ファイルに追加する必要があります。
二つ目はモジュールを DLL としてコンパイルする方法です。
DLL は共有ライブラリで、実行時に
LoadModule
モジュール DLL を作成するためには、
モジュールの作成に小さな変更を行なう必要があります。
つまり、モジュールのレコード (これは後で作成されます。
以下を参照してください) が DLL からエクスポートされなければなりません。
これを行なうには、AP_MODULE_DECLARE_DATA (Apache httpd
のヘッダファイルで定義されています) をモジュールのモジュールレコード
定義の部分に追加してください。たとえば、モジュールに
module foo_module;
があるとすると、それを次のもので置き換えてください。
module AP_MODULE_DECLARE_DATA foo_module;
Unix 上でもこのモジュールを
変更無しで使い続けられるように、このマクロは Windows
上でのみ効力を持ちます。.DEF
ファイルの方を良く知っているという場合は、
代わりにそれを使ってモジュールレコードを
エクスポートすることもできます。
さあ、あなたのモジュールの DLL を作成しましょう。これを、 libhttpd.lib 共有ライブラリがコンパイルされたときに作成された ibhttpd.lib エクスポートライブラリとリンクしてください。この時に、 Apache httpd のヘッダファイルが正しい位置にあるように、 コンパイラの設定を変える必要があるかもしれません。 このライブラリはサーバルートの modules ディレクトリにあります。 ビルド環境が正しく設定されるように、既存のモジュール用の .dsp を 取ってくるのが一番良いでしょう。もしくは、あなたの .dsp と コンパイラとリンクのオプションを比較する、というものでも良いです。
これで DLL 版のモジュールが作成されているはずです。
サーバルートの modules
ディレクトリにモジュールを置いて、
LoadModule
| 説明: | 指定されたオブジェクトファイルやライブラリをリンクする |
|---|---|
| 構文: | LoadFile filename [filename] ... |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_so |
LoadFile ディレクティブは、サーバが起動されたときや再起動されたときに、 指定されたオブジェクトファイルやライブラリをリンクします。 これはモジュールが動作するために必要になるかもしれない追加の コードを読み込むために使用されます。Filename は絶対パスか、ServerRoot からの相対パスです。
例:
LoadFile libexec/libxmlparse.so
| 説明: | オブジェクトファイルやライブラリをリンクし、使用モジュールの リストに追加する |
|---|---|
| 構文: | LoadModule module filename |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト |
| ステータス: | Extension |
| モジュール: | mod_so |
LoadModule ディレクティブは filename
というオブジェクトファイルおよびライブラリをリンクし、module
という名前のモジュールの構造をアクティブなモジュールのリストに追加します。
Module はファイル中の module
型の外部変数の名前で、モジュールのドキュメントに
モジュール識別子として書かれているものです。例 :
LoadModule status_module modules/mod_status.so
これは ServerRoot の modules サブディレクトリから指定された名前の モジュールをロードします。
Apache HTTP サーバ バージョン 2.4
| 説明: | ユーザが入力したであろう間違った URL を、 大文字小文字の区別を無視することと一つ以下の綴り間違いを許容することで 修正を試みる |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | speling_module |
| ソースファイル: | mod_speling.c |
リクエストの綴りが間違っていたり、 大文字小文字が違っていたりするために、Apache のコアサーバが ドキュメントへのリクエストへの応答を正しく提供できないことがあります。 このモジュールは、他のすべてのモジュールがあきらめた後であったとしても、 リクエストに合うドキュメントを見つけようとすることによりこの問題の 解決を試みます。このモジュールはリクエストされたディレクトリにある それぞれのドキュメントの名前と、リクエストされたドキュメントの名前とを 大文字小文字の区別を無視し、一文字までの 綴りの間違い (文字の挿入/省略/隣合う文字の置換、間違った文字) を許可して比較することにより、目的を達成しようとします。 この方法でリクエストに合うドキュメントの一覧が作成されます。
ディレクトリをスキャンした後に、
| 説明: | Also match files with differing file name extensions. |
|---|---|
| 構文: | CheckBasenameMatch on|off |
| デフォルト: | CheckBasenameMatch On |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Options |
| ステータス: | Extension |
| モジュール: | mod_speling |
| 互換性: | Available in httpd 2.4.50 and later |
このディレクティブの解説文書は まだ翻訳されていません。英語版をご覧ください。
| 説明: | 大文字小文字の修正だけ行うようにする |
|---|---|
| 構文: | CheckCaseOnly on|off |
| デフォルト: | CheckCaseOnly Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Options |
| ステータス: | Extension |
| モジュール: | mod_speling |
このディレクティブがセットされると、 綴り訂正機能は大文字小文字の修正のみ働き、他の修正機能は働きません。
| 説明: | spelling モジュールを使用するようにする |
|---|---|
| 構文: | CheckSpelling on|off |
| デフォルト: | CheckSpelling Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ, .htaccess |
| 上書き: | Options |
| ステータス: | Extension |
| モジュール: | mod_speling |
| 互換性: | CheckSpelling は Apache 1.1 では別配布のモジュールで、
大文字小文字の間違いのみの機能でした。Apache 1.3 で Apache の配布に
含まれるようになりました。Apache 1.3.2 より前では CheckSpelling
ディレクティブは「サーバ」と「バーチャルホスト」コンテキストでのみ
使用可能でした |
このディレクティブは綴り用のモジュールを使用するかどうかを 決めます。使用時には、以下のことを覚えておいてください
http://my.host/~apahce/ のように)
を訂正することはできません。
訂正できるのはファイル名とディレクトリ名だけです。<Location /status>
はネゴシエーションの結果のファイル "/stats.html"
として間違って扱われるかもしれません。DAV が有効なディレクトリでは
mod_speling は有効にしないでください。
新しく作成したリソース名を既に存在するファイル名に「修正」しようとする、
例えば、新規ドキュメント doc43.html が既に存在する
doc34.html にリダイレクトされて、
期待とは違う挙動になるからです。
Serveur HTTP Apache Version 2.4
| Description: | Permet d'atteindre différentes parties du système de fichiers depuis l'arborescence des documents du site web, ainsi que la redirection d'URL |
|---|---|
| Statut: | Base |
| Identificateur de Module: | alias_module |
| Fichier Source: | mod_alias.c |
Les directives fournies par ce module permettent de manipuler et
de contrôler les URLs à l'arrivée des requêtes sur le serveur. Les
directives Alias et
ScriptAlias permettent de
faire correspondre des URLs avec des chemins du système de fichiers.
Ceci permet de servir des contenus qui ne sont pas situés dans
l'arborescence de DocumentRoot comme s'ils y étaient
réellement. La directive ScriptAlias a pour effet
supplémentaire de marquer le répertoire cible comme conteneur de
scripts CGI.
Les directives Redirect
indiquent aux clients qu'ils doivent effectuer une nouvelle requête
avec une URL différente. Elles sont souvent utilisées lorsqu'une
ressource a été déplacée.
Lorsque les directives Alias, ScriptAlias ou Redirect sont définies au sein d'une
section <Location>
ou <LocationMatch>, vous pouvez utiliser la syntaxe des expressions pour manipuler l'URL
ou le chemin de destination.
mod_alias est conçu pour traiter des tâches
simples de manipulation d'URL. Pour des tâches plus complexes comme
la manipulation des chaînes d'arguments des requêtes, utilisez
plutôt les outils fournis par le module mod_rewrite
Alias AliasMatch AliasPreservePath Redirect RedirectMatch RedirectPermanent RedirectRelative RedirectTemp ScriptAlias ScriptAliasMatchLes alias et redirections apparaissant dans différents contextes
sont traités comme les autres directives en respectant les règles de fusion standards. Par
contre, ils sont traités selon une chronologie particulière
lorsqu'ils apparaissent dans le même contexte (par exemple, dans la
même section <VirtualHost>).
Premièrement, toutes les redirections sont traitées avant les
alias, et ainsi, une requête qui correspond à une directive
Redirect ou RedirectMatch ne se verra jamais
appliquer d'alias. Deuxièmement, les alias et redirections sont
traités selon l'ordre dans lequel ils apparaissent dans le fichier
de configuration, seule la première correspondance étant prise en
compte.
Ainsi, lorsqu'une ou plusieurs de ces directives s'appliquent au même sous-répertoire, vous devez classer les chemins du plus précis au moins précis afin que toutes les directives puissent éventuellement s'appliquer, comme dans l'exemple suivant :
Alias "/foo/bar" "/baz" Alias "/foo" "/gaq"
Si l'ordre des directives était inversé, la directive Alias ayant pour argument
/foo serait toujours appliquée avant la directive
Alias ayant pour argument
/foo/bar, et cette dernière serait toujours
ignorée.
La définition de directives Alias, ScriptAlias ou Redirect au sein de sections
<Location> ou
<LocationMatch>
l'emporte sur d'autres définitions éventuelles de ces mêmes
directives au niveau de la configuration générale du serveur.
| Description: | Met en correspondance des URLs avec des chemins du système de fichiers |
|---|---|
| Syntaxe: | Alias [chemin URL]
chemin fichier|chemin répertoire |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_alias |
La directive Alias permet de stocker des
documents (destinés à être servis) dans des zones du système de
fichiers situées en dehors de l'arborescence du site web DocumentRoot. Les URLs dont le chemin
(décodé avec caractères %) commence par chemin URL seront
mises en correspondance avec des fichiers locaux dont le chemin
commence par chemin répertoire. Le chemin URL
est sensible à la casse, même sur les systèmes de fichiers
insensibles à la casse.
Alias "/image" "/ftp/pub/image"
Une requête pour http://example.com/image/foo.gif fera
renvoyer par le serveur le fichier
/ftp/pub/image/foo.gif. Seuls les éléments de chemin
complets sont testés ; ainsi l'alias précédent ne conviendra pas
pour une requête du style http://example.com/imagefoo.gif.
Pour des mises en correspondance plus complexes faisant intervenir
les expressions rationnelles, veuillez vous reporter à la directive
AliasMatch.
Notez que si vous ajoutez un slash de fin au chemin URL, vous devrez aussi ajouter un slash de fin au chemin de la requête. Autrement dit, si vous définissez
Alias "/icons/" "/usr/local/apache/icons/"
l'alias précédent ne s'appliquera pas à l'URL
/icons à cause de l'absence du slash final. Ainsi, si
le slash final est absent du chemin de l'URL, il doit
aussi l'être du chemin du fichier.
Notez qu'il pourra s'avérer nécessaire de définir des sections
<Directory>
supplémentaires qui couvriront la destination des alias.
Le traitement des alias intervenant avant le traitement des sections
<Directory>,
seules les cibles des alias sont affectées (Notez cependant
que les sections <Location> sont traitées avant les alias, et
s'appliqueront donc).
En particulier, si vous créez un alias ayant pour cible un
répertoire situé en dehors de l'arborescence de votre site web
DocumentRoot, vous devrez
probablement permettre explicitement l'accès à ce répertoire.
Alias "/image" "/ftp/pub/image"
<Directory "/ftp/pub/image">
Require all granted
</Directory>
Le nombre de slashes dans le paramètre chemin URL doit correspondre au nombre de slashes dans le chemin URL de la requête.
Si la directive Alias est définie au sein
d'une section <Location> ou <LocationMatch>, chemin URL est
omis et chemin fichier est interprété en utilisant la syntaxe des expressions.
Cette syntaxe est disponible à partir de la version 2.4.19 du
serveur HTTP Apache.
<Location "/image">
Alias "/ftp/pub/image"
</Location>
<LocationMatch "/error/(?<NUMBER>[0-9]+)">
Alias "/usr/local/apache/errors/%{env:MATCH_NUMBER}.html"
</LocationMatch>
Notez que lorsque la directive AliasPreservePath
est à "on", la destination contient le chemin entier, alors que lorsque la
directive AliasPreservePath est à "off", tous les
URLs sont associés à l'URL cible unique.
# /files/foo et /files/bar associés à /ftp/pub/files/foo et /ftp/pub/files/bar
<Location "/files">
AliasPreservePath on
Alias "/ftp/pub/files"
</Location>
# /errors/foo et /errors/bar associés à /var/www/errors.html
<Location "/errors">
AliasPreservePath off
Alias "/var/www/errors.html"
</Location>
| Description: | Met en correspondance des URLs avec le système de fichiers en faisant intervenir les expressions rationnelles |
|---|---|
| Syntaxe: | AliasMatch regex
chemin fichier|chemin répertoire |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_alias |
Cette directive est identique à la directive Alias, mais fait appel aux expressions rationnelles, à la place d'une
simple mise en correspondance de préfixe. L'expression rationnelle
fournie est mise en correspondance avec le chemin URL, et si elle
correspond, le serveur va substituer toute partie de chemin
correspondant à l'expression entre parenthèses dans la chaîne
fournie et l'utiliser comme nom de fichier.
Par exemple, pour activer le répertoire /icons, on peut
utiliser :
AliasMatch "^/icons(.*)" "/usr/local/apache/icons$1$2"
Toute la puissance des expressions rationnelles peut être mise à contribution. Par exemple, il est possible de construire un alias avec un modèle de chemin URL insensible à la casse :
AliasMatch "(?i)^/image(.*)" "/ftp/pub/image$1"
Il existe une différence subtile entre Alias et AliasMatch : Alias copie automatiquement toute
portion supplémentaire de l'URI située après la partie du modèle qui
correspond, à la fin du chemin du fichier de la partie droite, alors
que AliasMatch ne le fait
pas. Cela signifie qu'il sera préférable dans la plupart des cas de
comparer l'expression rationnelle du modèle à la totalité de l'URI
de la requête, et d'utiliser les substitutions dans la partie
droite.
En d'autres termes, le remplacement d'Alias par AliasMatch ne produira pas le même
résultat. Au minimum, vous devez ajouter ^ au début de
l'expression rationnelle, (.*)$ à sa fin et
$1 à la fin de la chaîne de remplacement.
Par exemple, supposons que nous voulions reformuler cet alias avec AliasMatch :
Alias "/image/" "/ftp/pub/image/"
Le simple remplacement d'Alias par AliasMatch ne produira pas le même résultat. Ainsi, ce qui suit va rediriger toutes les requêtes qui contiennent /image/ vers /ftp/pub/image/ :
AliasMatch "/image/" "/ftp/pub/image/"
Voici la directive AliasMatch qui produira le même résultat que la directive Alias ci-dessus :
AliasMatch "^/image/(.*)$" "/ftp/pub/image/$1"
Bien entendu, il n'y a aucune raison d'utiliser AliasMatch dans le cas où Alias suffit. AliasMatch vous permet d'effectuer
des choses beaucoup plus sophistiquées. Par exemple, vous pouvez
servir différentes sortes de fichiers à partir de répertoires
différents :
AliasMatch "^/image/(.*)\.jpg$" "/fichiers/jpg.images/$1.jpg"
AliasMatch "^/image/(.*)\.gif$" "/fichiers/gif.images/$1.gif"
Les éventuels slashes de tête multiples seront supprimés par le serveur avant que les directives de ce module n'effectuent des comparaisons avec le chemin URL de la requête.
| Description: | Associer le chemin entier à l'alias dans une section location. |
|---|---|
| Syntaxe: | AliasPreservePath OFF|ON |
| Défaut: | AliasPreservePath OFF |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_alias |
| Compatibilité: | Disponible à partir de la version 2.4.58 du serveur HTTP Apache. |
Lorsqu'on utilise la version à deux paramètres de la directive
Alias, le chemin complet après l'alias est préservé.
Lorsqu'on utilise la version à un paramètre de la directive
Alias dans une section
Location, le chemin entier est supprimé, et tous les
URLs sont associés à l'expression cible.
Pour que la version à un paramètre de la directive
Alias préserve les chemins de la même façon que la
version à deux paramètres, activez cette directive.
| Description: | Envoie une redirection externe demandant au client d'effectuer une autre requête avec une URL différente |
|---|---|
| Syntaxe: | Redirect [état] [URL-path]
URL |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_alias |
La directive Redirect permet de faire correspondre
une ancienne URL à une nouvelle en demandant au client d'aller chercher la
ressource à une autre localisation.
L'ancien URL-path est un chemin sensible à la casse (décodé à l'aide de caractères %) commençant par un slash. Les chemins relatifs ne sont pas autorisés.
La nouvelle URL peut être une URL absolue commençant par un protocole et un nom d'hôte, mais on peut aussi utiliser un chemin URL commençant par un slash, auquel cas le protocole et le nom d'hôte du serveur local seront ajoutés.
Ensuite, toute requête commençant par URL-path va renvoyer une redirection au client vers l'URL cible. Tout élément de chemin supplémentaire situé en aval du URL-path sera ajouté à l'URL cible.
# Redirige vers une URL sur un serveur différent Redirect "/service" "http://foo2.example.com/service" # Redirige vers une URL sur le même serveur Redirect "/one" "/two"
Si le client effectue une requête pour l'URL
http://example.com/service/foo.txt, il lui sera demandé
d'en effectuer une autre pour l'URL
http://foo2.example.com/service/foo.txt. Ceci concerne
les requêtes avec paramètres GET, comme
http://example.com/service/foo.pl?q=23&a=42, qui
seront redirigées vers
http://foo2.example.com/service/foo.pl?q=23&a=42.
Notez que les POSTs seront ignorés.
Seuls les
éléments de chemin complets sont testés, si bien que l'exemple
précédent ne s'appliquera pas à l'URL
http://example.com/servicefoo.txt. Pour des mises en
correspondance plus complexes utilisant la syntaxe des expressions, ne spécifiez pas
d'argument URL-path comme décrit ci-dessous. En outre,
pour une mise en correspondance en utilisant les expressions
rationnelles, veuillez vous reporter à la directive RedirectMatch.
Les directives Redirect ont priorité sur les
directives Alias et ScriptAlias, quel que soit leur ordre
d'apparition dans le fichier de configuration. Les directives
Redirect définies au sein d'une section Location
l'emportent sur les directives Redirect et Alias comportant un argument
URL-path.
Si aucun argument état n'est spécifié, la redirection sera temporaire (code HTTP 302). Le client est alors informé que la ressource a été temporairement déplacée. On peut utiliser l'argument état pour renvoyer d'autres codes HTTP :
On peut renvoyer d'autres codes en spécifiant le code
numérique comme valeur de l'argument of état.
Si le code est compris entre 300 et 399, l'argument
URL doit être présent. Si le code
n'est pas compris entre 300 et 399, l'argument
URL ne doit pas apparaître. Le code doit être un code
HTTP valide, connu du serveur HTTP Apache (voir la
fonction send_error_response dans
http_protocol.c).
Redirect permanent "/one" "http://example.com/two" Redirect 303 "/three" "http://example.com/other"
Si une directive Redirect est définie au
sein d'une section <Location> ou <LocationMatch> et si l'argument URL-path est omis, l'argument URL sera interprété en
utilisant la syntaxe des expressions.
Cette syntaxe est disponible à partir de la version 2.4.19 du
serveur HTTP Apache.
<Location "/one">
Redirect permanent "http://example.com/two"
</Location>
<Location "/three">
Redirect 303 "http://example.com/other"
</Location>
<LocationMatch "/error/(?<NUMBER>[0-9]+)">
Redirect permanent "http://example.com/errors/%{env:MATCH_NUMBER}.html"
</LocationMatch>
| Description: | Envoie une redirection externe faisant appel aux expressions rationnelles pour la mise en correspondance de l'URL courante |
|---|---|
| Syntaxe: | RedirectMatch [état] regex
URL |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_alias |
Cette directive est identique à la directive Redirect, mais fait appel aux
expressions rationnelles, à la
place d'une simple mise en correspondance de préfixe. L'expression
rationnelle fournie est mise en correspondance avec le chemin URL,
et si elle correspond, le serveur va substituer toute partie de
chemin correspondante entre parenthèses dans la chaîne spécifiée et
l'utiliser comme nom de fichier. Par exemple, pour rediriger tous
les fichiers GIF vers les fichiers JPEG de même nom sur un autre
serveur, on peut utiliser :
RedirectMatch "(.*)\.gif$" "http://autre.example.com$1.jpg"
Les remarques à propos de la différence entre Alias et AliasMatch s'appliquent aussi à la
différence entre les directives Redirect et RedirectMatch. Voir la directive
AliasMatch pour plus de
détails.
| Description: | Envoie une redirection externe permanente demandant au client d'effectuer une nouvelle requête avec une URL différente |
|---|---|
| Syntaxe: | RedirectPermanent chemin URL URL |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_alias |
Cette directive informe le client que la redirection est
permanente (code 301). Son comportement est exactement le même
que celui de Redirect permanent.
| Description: | Redirection relative de cibles. |
|---|---|
| Syntaxe: | RedirectRelative On|Off |
| Défaut: | RedirectRelative Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_alias |
| Compatibilité: | Disponible à partir de la version 2.4.58 du serveur HTTP Apache |
Par défaut, si l'URL cible d'une directive Redirect est une URL relative commençant par
un caractère '/', le serveur convertit cette dernière en URL absolue avant
de répondre au client. En définissant
RedirectRelative à "On", l'URL relative est présentée
au client sans modification.
| Description: | Envoie une redirection externe temporaire demandant au client d'effectuer une nouvelle requête avec une URL différente |
|---|---|
| Syntaxe: | RedirectTemp chemin URL URL |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_alias |
Cette directive informe le client que la redirection n'est
que temporaire (code 302). Son comportement est exactement le même
que celui de Redirect temp.
| Description: | Fait correspondre une URL à une zone du système de fichiers et désigne la cible comme script CGI |
|---|---|
| Syntaxe: | ScriptAlias [chemin URL]
chemin fichier|chemin répertoire |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_alias |
La directive ScriptAlias présente le même
comportement que la directive Alias, mais désigne en plus le
répertoire cible comme conteneur de scripts CGI qui seront traitées
par le gestionnaire cgi-script du module mod_cgi.
Les URLs dont le chemin URL sensible à la casse (décodé avec
caractères %) commence par chemin URL seront mises en
correspondance avec les scripts dont le chemin commence par le
second argument, qui est un chemin complet dans le système de
fichiers local.
ScriptAlias "/cgi-bin/" "/web/cgi-bin/"
Une requête pour http://example.com/cgi-bin/foo
ferait exécuter par le serveur le script
/web/cgi-bin/foo. Cette configuration est sensiblement
équivalente à :
Alias "/cgi-bin/" "/web/cgi-bin/"
<Location "/cgi-bin">
SetHandler cgi-script
Options +ExecCGI
</Location>
Vous pouvez aussi utiliser ScriptAlias
avec un script ou gestionnaire de votre cru. Par exemple :
ScriptAlias "/cgi-bin/" "/web/cgi-handler.pl"
Dans ce scénario, tous les fichiers faisant l'objet d'une requête
dans /cgi-bin/ seront traités par le fichier que vous
avez spécifié, ce qui vous permet d'utiliser votre propre
gestionnaire. Vous pouvez l'utiliser comme enveloppe (wrapper) pour
les scripts CGI afin d'ajouter du contenu, ou autre action "maison".
DocumentRoot afin d'éviter de révéler
accidentellement leur code source lors d'une modification de
configuration. On y parvient aisément avec
ScriptAlias en mettant en correspondance une
URL et en désignant la cible comme scripts CGI par la même occasion.
Si vous choisissez de placer vos scripts CGI dans un répertoire
accessible depuis le web, n'utilisez pas
ScriptAlias. Utilisez plutôt <Directory>, SetHandler, et Options comme dans l'exemple suivant :
<Directory "/usr/local/apache2/htdocs/cgi-bin">
SetHandler cgi-script
Options ExecCGI
</Directory>
Ceci est nécessaire car plusieurs chemins URL peuvent
correspondre à la même zone du système de fichiers, court-circuitant
ainsi la directive ScriptAlias et révélant le
code source des scripts CGI s'ils ne sont pas protégés par une
section Directory.Si la directive ScriptAlias est définie au
sein d'une section <Location> ou <LocationMatch> et si l'argument chemin
URL est omis, l'argument URL sera interprété en
utilisant la syntaxe des expressions.
Cette syntaxe est disponible à partir de la version 2.4.19 du
serveur HTTP Apache.
<Location "/cgi-bin">
ScriptAlias "/web/cgi-bin/"
</Location>
<LocationMatch "/cgi-bin/errors/(?<NUMBER>[0-9]+)">
ScriptAlias "/web/cgi-bin/errors/%{env:MATCH_NUMBER}.cgi"
</LocationMatch>
| Description: | Fait correspondre une URL à une zone du système de fichiers en faisant appel aux expressions rationnelles et en désignant la cible comme un script CGI |
|---|---|
| Syntaxe: | ScriptAliasMatch regex
chemin fichier|chemin répertoire |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_alias |
Cette directive est équivalente à la directive ScriptAlias, mais fait appel aux
expressions rationnelles, à la
place d'une simple mise en correspondance de préfixe. L'expression
rationnelle fournie est mise en correspondance avec le chemin URL,
et si elle correspond, le serveur va substituer toute partie de
chemin entre parenthèses dans la chaîne spécifiée et l'utiliser
comme nom de fichier. Par exemple, pour activer le répertoire
standard /cgi-bin, on peut utiliser :
ScriptAliasMatch "^/cgi-bin(.*)" "/usr/local/apache/cgi-bin$1"
Comme dans le cas d'AliasMatch, toute la puissance des expressions rationnelles peut être mise à contribution. Par exemple, il est possible de construire un alias avec une comparaison du modèle du chemin URL insensible à la casse :
ScriptAliasMatch "(?i)^/cgi-bin(.*)" "/usr/local/apache/cgi-bin$1"
Les remarques à propos de la différence entre Alias et AliasMatch s'appliquent aussi à la
différence entre les directives ScriptAlias et ScriptAliasMatch. Voir la directive
AliasMatch pour plus de
détails.
Serveur HTTP Apache Version 2.4
| Description: | Authentification HTTP de base |
|---|---|
| Statut: | Base |
| Identificateur de Module: | auth_basic_module |
| Fichier Source: | mod_auth_basic.c |
| Compatibilité: | Disponible depuis la version 2.1 d'Apache |
Ce module permet d'utiliser l'authentification basique HTTP pour
restreindre l'accès en recherchant les utilisateurs dans les
fournisseurs d'authentification spécifiés. Il est en général
combiné avec au moins un module d'authentification comme
mod_authn_file et un module d'autorisation comme
mod_authz_user. L'authentification HTTP à
base de condensé (digest), quant à elle, est fournie par le module
mod_auth_digest.
| Description: | Définit si les processus d'autorisation et d'authentification peuvent être confiés à des modules de plus bas niveau |
|---|---|
| Syntaxe: | AuthBasicAuthoritative On|Off |
| Défaut: | AuthBasicAuthoritative On |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_auth_basic |
Normalement, chaque module d'autorisation énuméré dans la
directive AuthBasicProvider va tenter de
vérifier l'utilisateur, et si ce dernier n'est trouvé dans aucun des
fournisseurs, l'accès sera refusé. Définir explicitement la
directive AuthBasicAuthoritative à
Off permet de confier l'autorisation et
l'authentification à d'autres modules non basés sur les fournisseurs
si aucun identifiant utilisateur ou aucune
règle ne correspondent à l'identifiant utilisateur
spécifié. Ceci ne peut s'avérer nécessaire que lorsque
mod_auth_basic est combiné avec des modules tiers
qui n'ont pas été configurés à l'aide de la directive AuthBasicProvider. Lorsqu'on
utilise de tels modules, l'ordre dans lequel s'effectue le
traitement est défini dans le code source des modules et n'est pas
configurable.
| Description: | Authentification de base simulée à l'aide des nom d'utilisateur et mot de passe fournis |
|---|---|
| Syntaxe: | AuthBasicFake off|username [password] |
| Défaut: | none |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_auth_basic |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache |
Les nom d'utilisateur et mot de passe spécifiés sont rassemblés dans un en-tête d'autorisation qui est transmis au serveur ou au service sous-jacent au serveur. Ces nom d'utilisateur et mot de passe sont interprétés par l'interpréteur d'expression, ce qui permet de les définir en fonction de paramètres de la requête.
Si aucun mot de passe n'est spécifié, la valeur par défaut "password" sera utilisée. Pour désactiver l'authentification de base simulée pour un espace d'URL, définissez AuthBasicFake à "off".
Dans l'exemple suivant, un nom d'utilisateur et un mot de passe prédéfinis sont transmis à un serveur d'arrière-plan :
<Location "/demo">
AuthBasicFake demo demopass
</Location>
Dans l'exemple suivant, l'adresse email extraite d'un certificat
client est transmise au serveur, étendant par là-même la
fonctionnalité de l'option FakeBasicAuth de la directive SSLOptions. Comme avec l'option
FakeBasicAuth, le mot de passe se voit attribué le contenu fixe de
la chaîne "password".
<Location "/secure">
AuthBasicFake "%{SSL_CLIENT_S_DN_Email}"
</Location>
Pour compléter l'exemple précédent, il est possible de générer la valeur du mot de passe en procédant à un hashage de l'adresse email à partir d'un mot d'une passphrase initial fixée, puis de transmettre le résultat obtenu au serveur d'arrière-plan. Ceci peut s'avérer utile pour donner accès à des serveurs anciens qui ne supportent pas les certificats clients.
<Location "/secure">
AuthBasicFake "%{SSL_CLIENT_S_DN_Email}" "%{sha1:passphrase-%{SSL_CLIENT_S_DN_Email}}"
</Location>
<Location "/public">
AuthBasicFake off
</Location>
| Description: | Définit le(les) fournisseur(s) d'authentification pour cette zone du site web |
|---|---|
| Syntaxe: | AuthBasicProvider nom fournisseur
[nom fournisseur] ... |
| Défaut: | AuthBasicProvider file |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_auth_basic |
La directive AuthBasicProvider permet de
définir le fournisseur utilisé pour authentifier les utilisateurs
pour la zone du site web concernée. Le fournisseur par défaut
file est implémenté par le module
mod_authn_file. Assurez-vous que le module
implémentant le fournisseur choisi soit bien présent dans le
serveur.
<Location "/secure">
AuthType basic
AuthName "private area"
AuthBasicProvider dbm
AuthDBMType SDBM
AuthDBMUserFile "/www/etc/dbmpasswd"
Require valid-user
</Location>
Les fournisseurs sont sollicités dans l'ordre jusqu'à ce que l'un d'entre eux trouve une correspondance pour le nom d'utilisateur de la requête ; alors, ce dernier fournisseur sera le seul à vérifier le mot de passe. Un échec dans la vérification du mot de passe n'entraîne pas le passage du contrôle au fournisseur suivant.
Les différents fournisseurs disponibles sont implémentés par les
modules mod_authn_dbm,
mod_authn_file, mod_authn_dbd,
mod_authnz_ldap et mod_authn_socache.
| Description: | Vérifie les mots de passe auprès des fournisseurs d'authentification à la manière de l'authentification de type Digest. |
|---|---|
| Syntaxe: | AuthBasicUseDigestAlgorithm MD5|Off |
| Défaut: | AuthBasicUseDigestAlgorithm Off |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_auth_basic |
| Compatibilité: | Disponible à partir de la version 2.4.7 du serveur HTTP Apache |
Normalement, lorsqu'on utilise l'authentification basique, les
fournisseurs spécifiés via la directive AuthBasicProvider tentent de
contrôler l'identité d'un utilisateur en recherchant dans leurs
bases de données l'existence d'un couple utilisateur/mot de passe
correspondant. Les mots de passe enregistrés sont en général
chiffrés, mais ce n'est pas systématique ; chaque fournisseur peut
choisir son propre mode de stockage des mots de passe.
Lorsqu'on utilise l'authentification de type Digest, les
fournisseurs spécifiés par la directive AuthDigestProvider effectuent
une recherche similaire dans leurs bases de
données pour trouver un couple utilisateur/mot de passe
correspondant. Cependant, à la différence de l'authentification
basique, les données associées à chaque utilisateur et comportant le
nom d'utilisateur, le domaine de protection (realm) et le mot de
passe doivent être contenues dans une chaîne chiffrée (Voir le
document RFC 2617,
Section 3.2.2.2 pour plus de détails à propos du type de
chiffrement utilisé pour cette chaîne).
A cause de la différence entre les méthodes de stockage des données des authentifications de type basique et digest, le passage d'une méthode d'authentification de type digest à une méthode d'authentification de type basique requiert l'attribution de nouveaux mots de passe à chaque utilisateur, car leur mots de passe existant ne peut pas être extrait à partir du schéma de stockage utilisé par les fournisseurs d'authentification de type digest.
Si la directive AuthBasicUseDigestAlgorithm est
définie à la valeur MD5, le mot de passe d'un
utilisateur dans le cas de l'authentification basique sera vérifié
en utilisant le même format de chiffrement que dans le cas de
l'authentification de type digest. Tout d'abord, une chaîne
comportant le nom d'utilisateur, le domaine de protection (realm) et
le mot de passe est générée sous forme de condensé (hash) en
utilisant l'algorithme MD5 ; puis le nom d'utilisateur et cette
chaîne chiffrée sont transmis aux fournisseurs spécifiés via la
directive AuthBasicProvider comme si la
directive AuthType
était définie à Digest et si l'authentification de type
Digest était utilisée.
Grâce à cette directive, un site peut basculer d'une authentification de type digest à basique sans devoir changer les mots de passe des utilisateurs.
AuthBasicUseDigestAlgorithm
est définie à MD5. L'utilisation d'un autre
fournisseur provoquera un message d'erreur et le client se verra
refuser l'accès.Serveur HTTP Apache Version 2.4
| Description: | Permet un accès "anonyme" à des zones protégées |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | authn_anon_module |
| Fichier Source: | mod_authn_anon.c |
| Compatibilité: | Disponible depuis la version 2.1 d'Apache |
Ce module permet aux frontaux d'authentification comme
mod_auth_basic d'authentifier les utilisateurs
à la manière des sites FTP anonymes, c'est à dire
en fournissant l'identifiant utilisateur spécial 'anonymous' et
l'adresse email comme mot de passe. Ces adresses email peuvent être
journalisées.
En combinaison avec d'autres méthodes de contrôle d'accès (base de données), ce module permet d'effectuer un véritable suivi des utilisateurs et une personnalisation de leurs accès en fonction de leur profil, tout en conservant l'accessibilité du site aux utilisateurs 'non enregistrés'. Un avantage du suivi des utilisateurs basé sur l'authentification réside dans le fait qu'il est, à l'opposé des cookies magiques et des drôles d'URLs avec préfixes ou suffixes, entièrement indépendant du navigateur et qu'il permet de partager des URLs entre plusieurs utilisateurs.
Si l'on utilise le module mod_auth_basic, le
module mod_authn_anon est invoqué en affectant la
valeur anon à la directive AuthBasicProvider.
L'exemple ci-dessous présente un exemple de combinaison avec l'authentification à base de fichier htpasswd "normale", et permet la connexion d'utilisateurs en tant qu'invités avec les propriétés suivantes :
Anonymous_NoUserID)Anonymous_MustGiveEmail)Anonymous_VerifyEmail)anonymous, guest, www, test ou welcome, et la
vérification n'est pas sensible à la casse.
(Anonymous)Anonymous_LogEmail)<Directory "/var/www/html/private">
AuthName "Use 'anonymous' & Email address for guest entry"
AuthType Basic
AuthBasicProvider file anon
AuthUserFile "/path/to/your/.htpasswd"
Anonymous_NoUserID off
Anonymous_MustGiveEmail on
Anonymous_VerifyEmail on
Anonymous_LogEmail on
Anonymous anonymous guest www test welcome
Require valid-user
</Directory>
| Description: | Définit la liste des identifiants utilisateur autorisés à accéder sans vérification du mot de passe |
|---|---|
| Syntaxe: | Anonymous utilisateur [utilisateur]
... |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authn_anon |
Une liste d'un ou plusieurs identifiants utilisateur spéciaux autorisés à accéder sans vérification du mot de passe. Les identifiants doivent être séparés par un espace. Pour spécifier un identifiant contenant un espace, on peut utiliser les guillemets ' ou ", ou le caractère d'échappement \.
Veuillez noter que la vérification n'est pas sensible à
la casse.
Il est fortement conseillé d'intégrer l'utilisateur spécial
'anonymous' dans la liste des identifiants.
Anonymous anonymous "Not Registered" "I don't know"
Dans cet exemple, l'utilisateur peut accéder au site sans vérification du mot de passe en utilisant l'identifiant "anonymous", "Not Registered", "I Don't Know" ou encore "AnonyMous".
Depuis Apache 2.1, il est possible de remplacer la liste des
identifiants autorisés par le caractère "*", ce qui
permet d'utiliser n'importe quel identifiant pour pouvoir
accéder au site.
| Description: | Détermine si le mot de passe fourni sera enregistré dans le journal des erreurs |
|---|---|
| Syntaxe: | Anonymous_LogEmail On|Off |
| Défaut: | Anonymous_LogEmail On |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authn_anon |
Lorsque cette directive est définie à On, valeur
par défaut, le 'mot de passe' fourni (censé contenir une adresse
email valide) est enregistré dans le journal des erreurs.
| Description: | Détermine si l'abscence de mot de passe est autorisée |
|---|---|
| Syntaxe: | Anonymous_MustGiveEmail On|Off |
| Défaut: | Anonymous_MustGiveEmail On |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authn_anon |
Détermine si l'utilisateur doit spécifier une adresse email comme
mot de passe. Lorsque cette directive est définie à On,
l'abscence de mot de passe est interdite.
| Description: | Détermine si le champ identifiant peut être vide |
|---|---|
| Syntaxe: | Anonymous_NoUserID On|Off |
| Défaut: | Anonymous_NoUserID Off |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authn_anon |
Lorsque cette directive est définie à On, les
utilisateurs peuvent laisser le champ identifiant vide (et peut-être
aussi le champ mot de passe selon la définition de la directive
Anonymous_MustGiveEmail). Ceci
peut s'avérer très utile pour les utilisateurs de MS-Explorer qui
n'ont pour seule possibilité que d'appuyer sur Entrée ou de cliquer
directement sur le bouton OK, ce qui semble être une réaction
naturelle.
| Description: | Détermine s'il faut vérifier que le format de l'adresse email fournie comme mot de passe est correct |
|---|---|
| Syntaxe: | Anonymous_VerifyEmail On|Off |
| Défaut: | Anonymous_VerifyEmail Off |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authn_anon |
Lorsque cette directive est définie à On, Apache
vérifie que le 'mot de passe' entré contient au moins un '@' et un
'.' afin d'inciter les utilisateurs à fournir des adresses email
valides (voir ci-dessus la directive Anonymous_LogEmail).
Serveur HTTP Apache Version 2.4
| Description: | Authentification utilisateur utilisant des fichiers DBM |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | authn_dbm_module |
| Fichier Source: | mod_authn_dbm.c |
| Compatibilité: | Disponible depuis les versions 2.1 et supérieures d'Apache |
Ce module permet aux frontaux comme
mod_auth_digest et mod_auth_basic
d'authentifier les utilisateurs en les recherchant dans des fichiers
de mots de passe dbm. mod_authn_file
fournit une fonctionnalité similaire.
Lorsqu'on utilise mod_auth_basic ou
mod_auth_digest, ce module est invoqué en affectant
la valeur dbm à la directive AuthBasicProvider ou AuthDigestProvider.
| Description: | Définit le type de fichier de base de données utilisé pour stocker les mots de passe |
|---|---|
| Syntaxe: | AuthDBMType default|SDBM|GDBM|NDBM|DB |
| Défaut: | AuthDBMType default |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authn_dbm |
Cette directive permet de définir le type de fichier de base de données utilisé pour stocker les mots de passe. Le type de base de données par défaut est défini à la compilation. La liste des autres types de bases de données disponibles dépend aussi de la configuration de la compilation.
Par exemple, pour activer le support de Berkeley DB (correspondant au
type db), il faut ajouter l'option
--with-berkeley-db à la ligne de commande configure de httpd
pour générer le DSO approprié.
Il est impératif que le programme que vous utilisez pour créer vos fichiers de mots de passe soit configuré pour utiliser le même type de base de données.
| Description: | Définit le nom d'un fichier de base de données pour l'authentification contenant la liste des utilisateurs et de leurs mots de passe |
|---|---|
| Syntaxe: | AuthDBMUserFile chemin-fichier |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authn_dbm |
La directive AuthDBMUserFile permet de
définir le nom d'un fichier de base de données pour
l'authentification contenant la liste des utilisateurs et de leurs
mots de passe. chemin-fichier doit être un chemin absolu
vers le fichier de base de données.
La clé du fichier de base de données est le nom de l'utilisateur. La valeur associée est le mot de passe chiffré, éventuellement suivi par un ':' et des données arbitraires. Ce ':' ainsi que les données arbitraires qui suivent seront ignorées par le serveur.
Faites en sorte que le fichier spécifié par la directive
AuthDBMUserFile soit stocké en dehors de
l'arborescence des documents du serveur web ; en particulier, ne
l'enregistrez pas dans le répertoire qu'il protège, faute
de quoi, les clients auraient la possibilité de
télécharger le fichier des mots de passe.
Le format de mot de passe chiffré dépend du frontal
d'authentification utilisé (par exemple
mod_auth_basic ou
mod_auth_digest). Voir la documentation sur les Formats de mots de
passe pour plus de détails.
Note importante concernant la compatibilité : l'implémentation de
dbmopen dans les modules d'Apache lit la longueur de la
chaîne correspondant aux données chiffrées dans la structure des
données DBM, plutôt que de calculer cette longueur en se basant sur
le caractère nul final. Certaines applications par contre, comme le
serveur web Netscape, calculent cette longueur en se basant sur
le caractère nul final ; par conséquent, si vous rencontrez des
difficultés en échangeant des fichiers DBM entre plusieurs
applications, le problème peut éventuellement s'expliquer par cette
différence d'implémentation.
Un script perl nommé dbmmanage est fourni avec
Apache. On peut utiliser ce programme pour créer et mettre à jour
les fichiers de mots de passe au format DBM que ce module
utilise. Il existe également un autre outil pour gérer les fichiers DBM,
inclus dans le programme htdbm.
Serveur HTTP Apache Version 2.4
| Description: | Envoie des fichiers contenant leurs propres en-têtes HTTP |
|---|---|
| Statut: | Base |
| Identificateur de Module: | asis_module |
| Fichier Source: | mod_asis.c |
Ce module fournit le gestionnaire send-as-is qui
permet au serveur HTTP Apache d'envoyer le document sans ajouter la plupart des
en-têtes HTTP habituels.
On peut l'utiliser pour envoyer tous types de données en provenance du serveur, y compris les redirections et autres réponses HTTP spéciales, sans devoir faire appel à un script CGI ou nph.
Pour des raisons historiques, ce module traitera aussi tout
fichier dont le type MIME est httpd/send-as-is.
Ce module ne fournit aucune directive.
Dans le fichier de configuration, associez les fichiers asis au
gestionnaire send-as-is comme ceci :
AddHandler send-as-is asis
Le contenu de tout fichier possédant l'extension
.asis sera envoyé par Apache httpd au client pratiquement tel
quel. En particulier, les en-têtes HTTP seront déduits du fichier
lui-même selon les règles du module mod_cgi, si
bien qu'un fichier asis doit inclure des en-têtes valides, et
utiliser l'en-tête CGI Status: pour déterminer le code de réponse
HTTP. L'en-tête Content-Length: sera automatiquement
inséré ou, s'il est déjà présent, corrigé par httpd.
Voici un exemple de fichier dont le contenu est envoyé tel quel pour informer un client qu'un fichier a été déplacé.
Status: 301 Ou se trouve cette URL maintenant
Location: http://xyz.example.com/foo/bar.html
Content-type: text/html
<html>
<head>
<title>Mauvaises excuses</title>
</head>
<body>
<h1>La merveilleuse page de Fred a été déplacée vers
<a href="http://xyz.example.com/foo/bar.html">le site de
Joe</a>.
</h1>
</body>
</html>
Le serveur ajoute systématiquement les en-têtes
Date: et Server: aux données qu'il envoie
au client, si bien qu'ils n'ont pas besoin d'être inclus dans le
fichier. Le serveur n'ajoute pas d'en-tête
Last-Modified, ce qu'il devrait probablement faire.
Serveur HTTP Apache Version 2.4
| Description: | Authentification à l'aide d'un formulaire |
|---|---|
| Statut: | Base |
| Identificateur de Module: | auth_form_module |
| Fichier Source: | mod_auth_form.c |
| Compatibilité: | Disponible à partir d'Apache 2.3 |
L'authentification à base de formulaire dépend des modules
mod_session qui utilisent les cookies HTTP, et en
tant que tels s'exposent à des attaques de type Cross Site
Scripting, ou risquent de divulguer des informations à caractère
privé aux clients. Assurez-vous que ces risques ont bien été pris
en compte avant d'activer les sessions sur votre serveur.
Ce module permet de restreindre l'accès en recherchant les utilisateurs dans les fournisseurs spécifiés à l'aide d'un formulaire de connexion HTML. Les formulaires HTML requièrent davantage de configuration que les méthodes d'authentification alternatives, mais ils peuvent s'avérer beaucoup plus conviviaux pour les utilisateurs.
L'authentification HTTP de base est fournie par le module
mod_auth_basic, et l'authentification HTTP à base
de condensé par le module mod_auth_digest. Le
module mod_auth_form doit être utilisé avec au
moins un module d'authentification du style
mod_authn_file et un module d'autorisation comme
mod_authz_user.
Lorsque l'utilisateur a été authentifié avec succès, ses
informations de connexion sont stockés dans une session fournie par
le module mod_session.
Configuration de base Page de connexion dédiée Connexion à la volée Connexion à la volée avec
conservation du contenu Déconnexion Noms d'utilisateurs et mots de
passe AuthFormAuthoritative AuthFormBody AuthFormDisableNoStore AuthFormFakeBasicAuth AuthFormLocation AuthFormLoginRequiredLocation AuthFormLoginSuccessLocation AuthFormLogoutLocation AuthFormMethod AuthFormMimetype AuthFormPassword AuthFormProvider AuthFormSitePassphrase AuthFormSize AuthFormUsernamePour protéger une URL particulière avec le module
mod_auth_form, vous devez déterminer l'endroit où
vous allez stocker votre session, ainsi que la méthode
d'authentification. Dans cet exemple simple, les informations de
connexion sont stockées dans une session à l'aide du module
mod_session_cookie, et l'authentification utilise
un fichier en s'appuyant sur le module
mod_authn_file. Si l'authentification échoue,
l'utilisateur dera redirigé vers la page du formulaire de
connexion.
<Location "/admin">
AuthFormProvider file
AuthUserFile "conf/passwd"
AuthType form
AuthName "/admin"
AuthFormLoginRequiredLocation "http://example.com/login.html"
Session On
SessionCookieName session path=/
Require valid-user
</Location>
L'authentification mod_auth_form est activée
en affectant la valeur form à la directive AuthType. Les directives
AuthFormProvider et
AuthUserFile
spécifient que les noms d'utilisateurs et mots de passe seront
vérifiés en utilisant le fichier choisi.
Les directives Session et SessionCookieName créent une
session chiffrée stockée dans un cookie HTTP au niveau
du navigateur. Pour plus d'informations à propos des différentes
options de configuration des sessions, reportez-vous à la
documentation du module mod_session.
Vous pouvez éventuellement ajouter une directive SessionCryptoPassphrase pour créer
un cookie de session chiffré. Pour utiliser cette directive, le module
mod_session_crypto doit avoir été préalablement chargé.
Dans l'exemple simple ci-dessus, une URL a été protégée par
mod_auth_form, mais on doit maintenant fournir
à l'utilisateur un moyen d'entrer un nom et un mot de passe. À cet
effet, on peut soit écrire une page de connexion indépendante
dédiée, soit inclure le formulaire de connexion dans la page
courante.
Le formulaire de connexion peut être contenu dans une page indépendante, ou être inclus dans la page courante.
Lorsque la connexion s'effectue à partir d'une page
indépendante et si la tentative d'authentification échoue,
l'utilisateur doit être redirigé vers un formulaire de connexion,
créé à cet effet sur le site web, en utilisant la directive
AuthFormLoginRequiredLocation.
En général, la page de connexion contiendra un formulaire HTML
demandant à l'utilisateur de fournir un nom et un mot de passe.
<form method="POST" action="/dologin.html"> Username: <input type="text" name="httpd_username" value="" /> Password: <input type="password" name="httpd_password" value="" /> <input type="submit" name="login" value="Login" /> </form>
La partie où s'effectue la connexion proprement dite est traitée par le gestionnaire form-login-handler. L'action de ce formulaire doit pointer vers ce gestionnaire, ce que l'on configure dans Apache httpd comme suit :
<Location "/dologin.html">
SetHandler form-login-handler
AuthFormLoginRequiredLocation "http://example.com/login.html"
AuthFormLoginSuccessLocation "http://example.com/admin/index.html"
AuthFormProvider file
AuthUserFile "conf/passwd"
AuthType form
AuthName /admin
Session On
SessionCookieName session path=/
SessionCryptoPassphrase secret
</Location>
L'URL spécifiée par la directive
AuthFormLoginRequiredLocation
référencera en général une page expliquant à l'utilisateur que sa
tentative de connexion a échoué, et qu'il doit la renouveler. La
directive AuthFormLoginSuccessLocation
spécifie l'URL vers laquelle l'utilisateur doit être redirigé s'il
s'est authentifié avec succès.
Alternativement, l'URL vers laquelle doit être redirigé l'utilisateur s'il s'est authentifié avec succès peut être intégrée dans le formulaire de connexion, comme dans l'exemple ci-dessous. Il en découle que le même gestionnaire form-login-handler pourra être utilisé pour différentes zones du site web.
<form method="POST" action="/dologin.html"> Username: <input type="text" name="httpd_username" value="" /> Password: <input type="password" name="httpd_password" value="" /> <input type="submit" name="login" value="Login" /> <input type="hidden" name="httpd_location" value="http://example.com/success.html" /> </form>
Il existe un risque, dans certaines circonstances, que le formulaire de connexion configuré pour une connexion à la volée soit soumis plusieurs fois, révélant de ce fait les paramètres de connexion à l'application sous-jacente. L'administrateur doit s'assurer que cette dernière est correctement sécurisée afin d'éviter les éventuels abus. En cas de doute, utilisez une page de connexion indépendante dédiée.
Comme alternative à la page de connexion dédiée pour un site
web, il est possible de configurer mod_auth_form
pour authentifier les utilisateurs à la volée, sans les rediriger
vers une autre page, ce qui permet de conserver l'état de la page
courante au cours de la tentative de connexion. Ceci peut s'avérer
utile dans le cas d'une session limitée dans le temps, si le délai
de la session a expiré pendant la requête de l'utilisateur. Ce
dernier peut alors se réauthentifier à la même place, et
poursuivre son activité à partir du point où il en était resté.
Si un utilisateur non authentifié tente d'accéder à une page
protégée par mod_auth_form, et si ce dernier
n'est pas configuré avec une directive AuthFormLoginRequiredLocation,
un code de statut HTTP_UNAUTHORIZED est renvoyé vers le
navigateur, indiquant à l'utilisateur qu'il n'est pas autorisé à
accéder à cette page.
Pour configurer l'authentification à la volée, l'administrateur remplace le message d'erreur renvoyé par le code de statut HTTP_UNAUTHORIZED par un message d'erreur personnalisé contenant le formulaire de connexion comme suit :
AuthFormProvider file ErrorDocument 401 "/login.shtml" AuthUserFile "conf/passwd" AuthType form AuthName realm Session On SessionCookieName session path=/
La page du message d'erreur doit contenir un formulaire de connexion dont la propriété action est vide, comme dans l'exemple ci-dessous. Ceci a pour effet de soumettre le formulaire à l'URL protégée originale, cette dernière n'ayant pas besoin d'être connue de la page en cours.
<form method="POST" action=""> Username: <input type="text" name="httpd_username" value="" /> Password: <input type="password" name="httpd_password" value="" /> <input type="submit" name="login" value="Login" /> </form>
Lorsque l'utilisateur final a entré ses informations de
connexion, le formulaire effectue une requête HTTP POST pour l'URL
originale protégée par mot de passe.
mod_auth_form va alors intercepter cette requête
POST, et dans le cas où des champs HTML Utilisateur et Mot de
passe corrects sont présents, l'utilisateur sera connecté, et
l'URL originale protégée par mot de passe lui sera retournée en
tant que requête GET.
Il existe une limite à la technique de connexion à la volée décrite ci-dessus ; si un formulaire HTML POST entraîne une demande d'authentification ou de réauthentification, le contenu du formulaire original envoyé par le navigateur sera perdu. Cela peut s'avérer plus ou moins gênant pour l'utilisateur final selon la fonction du site web.
Comme solution à ce problème, mod_auth_form
permet d'intégrer la méthode et le contenu de la requête originale
dans le formulaire de connexion. Si l'authentification réussit,
Apache httpd pourra refaire une tentative avec la méthode et le contenu
originaux, tout en conservant l'état de la requête originale.
Pour mettre en oeuvre la conservation du contenu, vous devez ajouter trois champs supplémentaires au formulaire de connexion comme dans l'exemple suivant :
<form method="POST" action=""> Username: <input type="text" name="httpd_username" value="" /> Password: <input type="password" name="httpd_password" value="" /> <input type="submit" name="login" value="Login" />
<input type="hidden" name="httpd_method" value="POST" /> <input type="hidden" name="httpd_mimetype" value="application/x-www-form-urlencoded" /> <input type="hidden" name="httpd_body" value="name1=value1&name2=value2" />
</form>
La manière dont la méthode, le type MIME et le contenu de la requête originale seront intégrés dans le formulaire de connexion vont dépendre de la plate-forme et de la technologie utilisées au sein du site web.
Une option consiste à utiliser le module
mod_include en association avec la directive
KeptBodySize, ainsi
qu'un script CGI adapté pour intégrer les variables dans le
formulaire.
Une autre option consiste à présenter le formulaire de connexion en utilisant un script CGI ou une autre technologie dynamique.
AuthFormProvider file
ErrorDocument 401 "/cgi-bin/login.cgi"
...
Pour permettre à un utilisateur de se déconnecter d'une session particulière, vous devez configurer une page pour qu'elle soit traitée par le gestionnaire form-logout-handler. Tout accès à cette URL va entraîner la suppression de l'Utilisateur et du Mot de passe de la session courante, ce qui aura pour effet de déconnecter l'utilisateur.
Vous pouvez spécifier une URL vers laquelle le navigateur sera
redirigé en cas de déconnection réussie, en définissant la
directive AuthFormLogoutLocation. Cette
URL devra expliquer à l'utilisateur qu'il a été déconnecté, et lui
donner la possibilité de se connecter à nouveau.
SetHandler form-logout-handler AuthName realm AuthFormLogoutLocation "http://example.com/loggedout.html" Session On SessionCookieName session path=/
Notez que la déconnexion d'un utilisateur ne supprime pas la
session ; elle supprime seulement l'utilisateur et le mot de passe
de la session. Si la session qui en résulte est vide, elle sera
probablement supprimée, mais ce n'est pas garanti. Si vous voulez
être sûr que la session sera supprimée, affectez une valeur faible
à la directive SessionMaxAge, par exemple 1
(affecter à cette directive la valeur zéro signifie une session
sans limite d'âge).
SetHandler form-logout-handler AuthFormLogoutLocation "http://example.com/loggedout.html" Session On SessionMaxAge 1 SessionCookieName session path=/
Notez que la soumission d'un formulaire implique l'encodage URL (URLEncoding) des données du formulaire, ici le nom d'utilisateur et le mot de passe. Vous devez donc choisir des noms d'utilisateurs et mots de passe qui ne contiennent pas de caractères susceptibles d'être encodés URL lors de la soumission du formulaire, sous peine d'obtenir des résultats inattendus.
| Description: | Détermine si l'autorisation et l'authentification sont confiés à des modules de plus bas niveau |
|---|---|
| Syntaxe: | AuthFormAuthoritative On|Off |
| Défaut: | AuthFormAuthoritative On |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_auth_form |
Normalement, chacun des modules d'autorisation spécifiés par la
directive AuthFormProvider va tenter de
vérifier l'identité de l'utilisateur, et si ce dernier n'est trouvé
dans aucun fournisseur, l'accès sera refusé. En définissant
explicitement la directive
AuthFormAuthoritative à Off on
confie les processus d'authentification et d'autorisation à des
modules ne s'appuyant pas sur des fournisseurs, si aucun
identifiant utilisateur ou aucune règle ne
correspond à l'identifiant utilisateur fourni. Ceci ne peut s'avérer
nécessaire que si l'on combine mod_auth_form avec
des modules tiers qui ne se configurent pas avec la directive
AuthFormProvider.
Lorsqu'on utilise de tels modules, la chronologie du processus est
déterminée dans leur code source, et n'est pas configurable.
| Description: | Le nom du champ de formulaire contenant le corps de la requête à effectuer en cas de connexion réussie |
|---|---|
| Syntaxe: | AuthFormBody nom du champ |
| Défaut: | AuthFormBody httpd_body |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache |
La directive AuthFormBody
spécifie le nom du champ HTML qui, s'il existe, contiendra le corps
de la requête à effectuer en cas de connexion réussie.
En ajoutant au formulaire les champs décrits dans AuthFormMethod, AuthFormMimetype et AuthFormBody, un site web sera en
mesure de relancer une requête qui a été éventuellement interrompue
par l'écran de connexion, ou par l'expiration d'un délai de
session.
| Description: | Désactive l'en-tête CacheControl no-store sur la page de connexion |
|---|---|
| Syntaxe: | AuthFormDisableNoStore On|Off |
| Défaut: | AuthFormDisableNoStore Off |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache |
Le drapeau AuthFormDisableNoStore supprime
l'envoi d'un en-tête Cache-Control no-store lorsqu'une
page avec code d'erreur 401 est renvoyée, si l'utilisateur n'est pas
encore connecté. Avec cette en-tête, il est plus difficile pour une
application ecmascript de resoumettre un formulaire de connexion, et
ainsi révéler le nom d'utilisateur et le mot de passe à
l'application sous-jacente. Vous devez être conscient des risques
encourus si vous le désactivez.
| Description: | Simule une en-tête d'authentification de base |
|---|---|
| Syntaxe: | AuthFormFakeBasicAuth On|Off |
| Défaut: | AuthFormFakeBasicAuth Off |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache |
Le drapeau AuthFormFakeBasicAuth
détermine si une en-tête d'Authentification de base
sera ajoutée aux en-têtes de la requête. On peut utiliser cette
méthode pour présenter le nom d'utilisateur et le mot de passe à
l'application sous-jacente, sans que cette dernière ait besoin de
connaître la manière dont le processus de connexion a été mené à
bien.
| Description: | Le nom du champ de formulaire qui contiendra l'URL vers laquelle l'utilisateur sera redirigé en cas de connexion réussie |
|---|---|
| Syntaxe: | AuthFormLocation nom du champ |
| Défaut: | AuthFormLocation httpd_location |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache |
La directive AuthFormLocation
spécifie le nom du champ HTML qui, s'il existe, contiendra l'URL
vers laquelle rediriger le navigateur en cas de connexion
réussie.
| Description: | L'URL de la page vers laquelle on doit être redirigé si une authentification est requise |
|---|---|
| Syntaxe: | AuthFormLoginRequiredLocation url |
| Défaut: | none |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache. L'interprétation des expressions rationnelles est supportée depuis la version 2.4.4. |
La directive AuthFormLoginRequiredLocation
spécifie l'URL vers laquelle l'utilisateur devra être
redirigé s'il n'est pas autorisé à accéder à une page. Sa valeur est
interprétée via l'interpréteur ap_expr
avant d'être envoyée au client. Par défaut,
si un utilisateur n'est pas autorisé à accéder à une page, le code
de réponse HTTP HTTP_UNAUTHORIZED est renvoyé avec la
page spécifiée par la directive ErrorDocument. La directive AuthFormLoginRequiredLocation
permet de remplacer cette valeur par défaut.
Vous pouvez utiliser cette directive si vous voulez présenter une page de connexion personnalisée à vos utilisateurs.
| Description: | L'URL de la page vers laquelle on doit être redirigé en cas de connexion réussie |
|---|---|
| Syntaxe: | AuthFormLoginSuccessLocation url |
| Défaut: | none |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache. L'interprétation des expressions rationnelles est supportée depuis la version 2.4.4. |
La directive AuthFormLoginSuccessLocation
spécifie l'URL vers laquelle l'utilisateur doit être
redirigé en cas de connexion réussie. Sa valeur est
interprétée via l'interpréteur ap_expr
avant d'être envoyée au client. L'effet de cette directive
peut être annulé si l'on a défini un champ de formulaire contenant
une autre URL à l'aide de la directive AuthFormLocation.
Vous pouvez utiliser cette directive si vous possédez une URL de connexion personnalisée, et si vous n'avez pas intégré la page de destination dans le formulaire de connexion.
| Description: | L'URL vers laquelle un utilisateur devra être redirigé après s'être déconnecté |
|---|---|
| Syntaxe: | AuthFormLogoutLocation uri |
| Défaut: | none |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache. L'interprétation des expressions rationnelles est supportée depuis la version 2.4.4. |
La directive AuthFormLogoutLocation
spécifie l'URL de la page du serveur vers laquelle l'utilisateur
devra être redirigé s'il se déconnecte. Sa valeur est
interprétée via l'interpréteur ap_expr
avant d'être envoyée au client.
Lorsqu'un accès est tenté sur un URI traité par le gestionnaire
form-logout-handler, la page spécifiée par cette
directive sera présentée à l'utilisateur final. Par exemple :
<Location "/logout">
SetHandler form-logout-handler
AuthFormLogoutLocation "http://example.com/loggedout.html"
Session on
#...
</Location>
Si un utilisateur tente d'accéder à l'URI /logout/, il sera déconnecté, et la page /loggedout.html lui sera présentée. Assurez-vous que la page loggedout.html n'est pas protégée par mot de passe, car dans le cas contraire, elle ne serait pas affichée.
| Description: | Le nom du champ de formulaire contenant la méthode de la requête à effectuer en cas de connexion réussie |
|---|---|
| Syntaxe: | AuthFormMethod nom du champ |
| Défaut: | AuthFormMethod httpd_method |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache |
La directive AuthFormMethod
spécifie le nom du champ HTML qui, s'il existe, contiendra le type
MIME de la requête à effectuer en cas de connexion réussie.
En ajoutant au formulaire les champs décrits dans AuthFormMethod, AuthFormMimetype et AuthFormBody, un site web sera en
mesure de relancer une requête qui a été éventuellement interrompue
par l'écran de connexion, ou par l'expiration d'un délai de
session.
| Description: | Le nom du champ de formulaire contenant le type MIME du corps de la requête à effectuer en cas de connexion réussie |
|---|---|
| Syntaxe: | AuthFormMimetype nom du champ |
| Défaut: | AuthFormMimetype httpd_mimetype |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache |
La directive AuthFormMimetype
spécifie le nom du champ HTML qui, s'il existe, contiendra le type
MIME de la requête à effectuer en cas de connexion réussie.
En ajoutant au formulaire les champs décrits dans AuthFormMethod, AuthFormMimetype et AuthFormBody, un site web sera en
mesure de relancer une requête qui a été éventuellement interrompue
par l'écran de connexion, ou par l'expiration d'un délai de
session.
| Description: | Le nom du champ de formulaire qui contient le mot de passe de connexion |
|---|---|
| Syntaxe: | AuthFormPassword nom du champ |
| Défaut: | AuthFormPassword httpd_password |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache |
La directive AuthFormPassword permet de
spécifier le nom du champ HTML qui, s'il existe, contiendra le mot
de passe qui sera utilisé pour la connexion.
| Description: | Définit le(s) fournisseur(s) d'authentification pour la zone concernée |
|---|---|
| Syntaxe: | AuthFormProvider nom fournisseur
[nom fournisseur] ... |
| Défaut: | AuthFormProvider file |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_auth_form |
La directive AuthFormProvider permet de
définir quel fournisseur sera utilisé pour authentifier les
utilisateurs pour la zone concernée. Le fournisseur par défaut
file est implémenté par le module
mod_authn_file. Assurez-vous que le fournisseur
choisi soit bien présent dans le serveur.
<Location "/secure">
AuthType form
AuthName "private area"
AuthFormProvider dbm
AuthDBMType SDBM
AuthDBMUserFile "/www/etc/dbmpasswd"
Require valid-user
#...
</Location>
Les différents fournisseurs sont implémentés par les modules
mod_authn_dbm, mod_authn_file,
mod_authn_dbd et
mod_authnz_ldap.
| Description: | Court-circuite l'authentification pour les sites à fort trafic |
|---|---|
| Syntaxe: | AuthFormSitePassphrase secret |
| Défaut: | none |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache |
La directive AuthFormSitePassphrase
spécifie un mot de passe qui, s'il est présent dans la session
utilisateur, indique à Apache httpd de court-circuiter l'authentification
pour l'URL considérée. On peut l'utiliser dans le cas de sites web à
fort trafic afin de réduire la charge induite sur l'infrastructure
d'authentification.
On peut insérer le mot de passe dans une session utilisateur en ajoutant cette directive à la configuration concernant le gestionnaire form-login-handler. Le gestionnaire form-login-handler, quant à lui, effectuera toujours les vérifications d'authentification, qu'un mot de passe soit spécifié ou non.
Si la session est présentée à l'utilisateur à l'aide du module
mod_session_cookie, et si la session n'est pas
protégée par le module mod_session_crypto, le mot
de passe peut faire l'objet d'une attaque de type dictionnaire.
Quelle que soit la configuration de la session, assurez-vous que
cette directive n'est pas utilisée dans un espace d'URLs contenant
des données privées, ou à partir desquelles des transactions
sensibles pourraient être menées. En tout état de cause, vous
devez être conscient des risques encourus avant de l'utiliser.
| Description: | La taille maximale en octets du formulaire dont seront extraites les informations de connexion |
|---|---|
| Syntaxe: | AuthFormSize taille |
| Défaut: | AuthFormSize 8192 |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache |
La directive AuthFormSize spécifie
la taille maximale du corps de la requête qui sera utilisée pour
trouver le formulaire de connexion.
Si une requête de connexion entrante possède une taille
supérieure à cette valeur, elle sera rejetée avec le code de réponse
HTTP HTTP_REQUEST_TOO_LARGE.
Si vous avez ajouté au formulaire des champs décrits dans AuthFormMethod, AuthFormMimetype et AuthFormBody, il est recommandé
de définir cette directive à une valeur similaire à celle de la
directive KeptBodySize.
| Description: | Le nom du champ de formulaire qui contient le nom de connexion |
|---|---|
| Syntaxe: | AuthFormUsername nom du champ |
| Défaut: | AuthFormUsername httpd_username |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_auth_form |
| Compatibilité: | Disponible depuis la version 2.3.3 du serveur HTTP Apache |
La directive AuthFormUsername permet de
spécifier le nom du champ HTML qui, s'il existe, contiendra le nom
d'utilisateur qui sera utilisé pour la connexion.
Serveur HTTP Apache Version 2.4
| Description: | Autorisation basée sur les groupes à l'aide de fichiers DBM |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | authz_dbm_module |
| Fichier Source: | mod_authz_dbm.c |
| Compatibilité: | Disponible depuis les versions 2.1 et supérieures d'Apache |
Ce module permet d'autoriser ou d'interdire l'accès à certaines
zones du site web aux utilisateurs authentifiés en fonction de leur
appartenance à un groupe spécifié. Le module
mod_authz_groupfile fournit une fonctionnalité
similaire.
Les directives Require d'Apache permettent,
au cours de la phase d'autorisation, de s'assurer qu'un utilisateur
est bien autorisé à accéder à une ressource. mod_authz_dbm ajoute
les types d'autorisation dbm-group et dbm-file-group.
A partir de la version 2.4.8, les directives require DBM supportent les expressions.
Cette directive permet de spécifier à quel groupe un utilisateur doit appartenir pour obtenir l'autorisation d'accès.
Require dbm-group admin
Lorsque cette directive est définie, l'utilisateur doit appartenir au groupe du fichier pour pouvoir y accéder.
Require dbm-file-group
Notez que si vous utilisez mod_authz_dbm, le mot-clé pour les
groupes d'authentification qui était auparavant group est
maintenant dbm-group :
<Directory "/foo/bar"> AuthType Basic AuthName "Secure Area" AuthBasicProvider dbm AuthDBMUserFile "site/data/users" AuthDBMGroupFile "site/data/users" Require dbm-group admin </Directory>
| Description: | Définit le nom du fichier de base de données contenant la liste des groupes d'utilisateurs permettant de définir les autorisations des utilisateurs |
|---|---|
| Syntaxe: | AuthDBMGroupFile chemin-fichier |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authz_dbm |
La directive AuthDBMGroupFile sert à
définir le nom d'un fichier DBM contenant la liste des groupes
d'utilisateurs. Les utilisateurs peuvent dès lors se voir autoriser ou
refuser leurs accès selon l'appartenance à tel ou tel groupe.
chemin-fichier est le chemin absolu du
fichier de groupes.
La clé du fichier de groupes est le nom d'utilisateur. La valeur de chaque clé est la liste des groupes, séparés par des virgules, auxquels l'utilisateur appartient. Cette liste ne doit comporter ni espace, ni caractère ':'.
Le fichier spécifié par la directive
AuthDBMGroupFile doit être situé en dehors de
l'arborescence des documents du serveur web. Ne le placez
surtout pas dans le répertoire qu'il protège, faute
de quoi, les clients pourraient le télécharger, en l'abscence de
protection supplémentaire.
Utilisation combinée de fichiers DBM de groupes et de mots de passe : dans certains cas, il est plus simple de gérer une seule base de données contenant les groupes et mots de passe de chaque utilisateur. L'écriture de programmes de support en est ainsi simplifiée car ils n'ont plus qu'un seul fichier DBM à gérer et à verrouiller. Pour ce faire, on attribue le même nom de fichier DBM aux fichiers de groupes et de mots de passe :
AuthDBMGroupFile "/www/userbase" AuthDBMUserFile "/www/userbase"
La clé du fichier DBM unique est le nom d'utilisateur. La valeur associée à la clé contient :
Mot de passe chiffré : Liste de groupes [ : (ignoré) ]
La partie mot de passe contient comme d'habitude le mot de passe chiffré. Viennent ensuite le caractère ':' et la liste des groupes séparés par des virgules. Il est possible d'ajouter d'autres données en fin de ligne après un autre caractère ':', mais elles seront ignorées par le module d'autorisation. Il s'agit du format utilisé par www.telescope.org pour sa base de données combinée groupes et mots de passe.
| Description: | Définit le type de fichier de base de données contenant la liste des groupes d'utilisateurs |
|---|---|
| Syntaxe: | AuthzDBMType default|SDBM|GDBM|NDBM|DB |
| Défaut: | AuthzDBMType default |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authz_dbm |
Définit le type de fichier de base de données contenant la liste des groupes d'utilisateurs. Le type de base de données par défaut est déterminé à la compilation. Les autres types de bases de données disponibles dépendent aussi de la configuration de la compilation.
Quel que soit le programme que vous utilisez pour créer votre fichier de groupes, il est impératif que celui-ci soit configuré pour utiliser le même type de base de données.
Apache HTTP Server Version 2.4
| : | Ȱ ɿ Ѵ |
|---|---|
| : | Base |
| : | status_module |
| ҽ: | mod_status.c |
Status ڿ ¸ ش. ִ HTML 踦 ش. ʿϴٸ (ǥ ) ڵ ִ. ¸ ǻͰ ִ ִ.
˷ִ :
ǥ ġ "(*)" ǥ 踦 . Ͻ ɼ ؾ Ѵ.
foo.com ο Ը ¸ ַ
httpd.conf Ͽ ߰Ѵ
<Location /server-status>
SetHandler server-status
Order Deny,Allow
Deny from all
Allow from .foo.com
</Location>
http://your.server.name/server-status
ϸ 踦 ִ.
"簻" Ѵٸ status ڵ
ִ. N ʸ Ϸ
http://your.server.name/server-status?refresh=N
϶.
http://your.server.name/server-status?auto
ǻͰ ִ status ִ.
ġ /support 丮 ִ
log_server_status Perl α ڵ
ϴ α ϴ.
mod_status
Ͽٸ 丮 (
, .htaccess) Ͽ
Ͽ ڵ鷯 ִ. Ʈ
ִ.
Apache HTTP Server Version 2.4
| : | CGI ũƮ Ư ڿ Ѵ |
|---|---|
| : | Extension |
| : | suexec_module |
| ҽ: | mod_suexec.c |
| : | ġ 2.0 ĺ |
suexec α Ͽ CGI ũƮ Ư ڿ Ѵ.
Apache HTTP Server Version 2.4
| : | û ĺڸ ȯ溯 Ѵ |
|---|---|
| : | Extension |
| : | unique_id_module |
| ҽ: | mod_unique_id.c |
Ư Ȳ "" û߿
ϵ ĺ(identifier) û Ѵ.
ĺڴ Ưϰ Ŭ ǻ͵
߿ ϴ. û ȯ溯
UNIQUE_ID Ѵ. ĺڴ
뵵 , Ѿ.
н ýۿ ġ ϴ 캸. Windows NT ʴ´. н ġ ڽ , ڽ μ ѹ û óѴ. ڽ ߿ û óѴ. ⼭ ߿ ڽĵ ڷḦ ʴ´ٴ ̴. ڽ httpd μ Ѵ.
ǻͷ Ʈ Ѵٸ Ŭ(cluster) θ. ǻʹ ġ ִ. ̵ θ "" , ŬͿ ִ ǻ͵鰣 ž û ֿ ĺڸ ִ.
ŬͿ ִ ǻʹ 䱸 ؾ Ѵ. (ǻ Ѵ븸 ϴ ǻ ð NTP ؾ Ѵ.)
ü pid (μ id) 32Ʈ ٰ Ѵ. ü pid 32Ʈ ̻ Ѵٸ ڵ带 ؾ Ѵ.
̷ Ͽ 츮 Ŭ ǻͿ ִ httpd μ ٸ httpd μ ִ. ǻ IP ּҿ httpd μ pidε ִ. û ڸ ð ȴ.
ð ϱ н ð(timestamp, ǥؽ÷ 1970 1 1 ) 16Ʈ ī Ѵ. н ð ʴ̰, īʹ ʵ 65536 Ѵ. ( ip_addr, pid, time_stamp, counter ) httpd μ ʵ 65536 û ִ. īʹ pid ϴ ذؾ Ѵ.
httpd ڽ īʹ ( и 10 ) 65536 ȴ. ( ý и ð Ʈ ġʴ .) ĺڸ 鶧 ϴ ð û ð̴. īʹ ĺڸ 鶧 Ѵ ( ٽ Ѵ).
Ŀ μ ũҶ(fork) μ pid Ҵϰ, pid ٽ ִ. (pid н 16Ʈ, ֱ ý 32Ʈ Ȯߴ.) ð pid ִ. ð pid ʴ´ٸ ϴ. , 츮 ý ʵ μ 65536 ̻ ʴ´ٰ Ѵ. ( н 32768 ̻ μ pid , ̰ Ͼ Ͱ ʴ.)
ð ݺȴٰ غ. , ý ð谡 ð ŷ ư (Ȥ ð谡 ʹ ռ ùٷ 缳 ̷ ð Ǵ) . pid ð ִ. ī ʱȭ ذϷ ȵǾ. 츮 ڷ ī ʱȭϱ , ýۿ ̷ . ( , seed ʿϱ rand() , ð ּ ̱ ð seed .) Ϻ ذå .
? ǻ ϳ û ʴ ִ 500 (ý Ϲ ϴ ̻ ۾ ϹǷ ̴.) Ѵٰ . ÿ ŭ Ŭ̾Ʈ óϴ° ڽ ȴ. 츮 ڽ û ʴ 500 ó ִٰ Ѵ. pid ڽ 500 û ڽ 500 û īͰ ĥ ִ ī ۰ 1000̴. (ʴ) ڽ īͰ ݺϿ ϼ Ȯ 1.5%̴. ̰ ſ ̸, ̷ . ýۿ ̷ ٸ (ҽ Ͽ) ī 32Ʈ .
ŸӶ ð谡 "ڷ " . ⼭ ϴ ð ǥؽ(UTC), ð "" Ƿ . x86 н ʿϴ. κ ð谡 UTC ϵ ؾ Ѵ. NTP Ѵٸ UTC ð ùٷ .
ȯ溯 UNIQUE_ID MIME base64 ڵ
112Ʈ (32Ʈ IP ּ, 32Ʈ pid, 32Ʈ
ð, 16Ʈ ī) ĺ [A-Za-z0-9@-]
ǥѴ. MIME base64 ĺ
[A-Za-z0-9+/] +
/ URL Ư ǹ̷ ϹǷ ߴ.
Ʈ Ʈ ڵϱ ٸ Ʈ
ϴ Űİ . ڵ
ð, IP ּ, pid, ī ̴.
, α ڵ Ͽ мϸ
ȵ Ѵ. α ڵ UNIQUE_ID
ü ϰ, ٸ UNIQUE_ID
ִ.
UNIQUE_ID ͺ̽
浹 ʰ ڵ ֵ ߴ.
ο ڵ ù ð ϰų, ĺ
Ʈ ̸ ִ. ð ⺻ ϴ ̹Ƿ
ŬͿ ִ ǻͰ û ߴϰ
ڵ ϱ (flag second)
ϴ. û ϰ ο ڵ
ִ.
츮 Ͽ ð ذå̶ ϴ´. Windows NT Ƽ ý Ȯ ְ, 뵵 Ȯ ִ. ̷ ʿѸŭ ĺڸ ֱ ĺڴ ⺻ . ⺻ Ŭ ǻ͵ ̿ ʿ (ϰ NTP ⸸ ʿϴ), httpd μ ̿ ŵ ʿ (Ŀ οϴ pid Ϲ ̴). ſ Ư Ȳ̶ ν ũ⸦ ؾ Ѵ. ( , Ʈ 32Ʈ IP ּ ʿϰ ũ, ̸ ̴ Ȳ ٸ.)
Apache HTTP Server Version 2.4
| : | ں 丮 |
|---|---|
| : | Base |
| : | userdir_module |
| ҽ: | mod_userdir.c |
ϸ http://example.com/~user/
ں 丮 ִ.
| : | ں 丮 ġ |
|---|---|
| : | UserDir directory-filename |
| ⺻: | UserDir public_html |
| : | ּ, ȣƮ |
| : | Base |
| : | mod_userdir |
UserDir þ
û Ȩ丮 ȿ 丮
Ѵ. Directory-filename ϳ̴:
disabled Ű.
enabled Ű (Ʒ ) ̸ ʾҴٸ
ڸ-丮 ȯ ʴ´.disabled Ű ڿ ڸ .
ڸ enabled ִٰ ϴ, Ͽ
ִ ڸ 丮 ȯ ʴ´.enabled Ű ڿ ڸ .
ü disable ϰ ڸ disabled
, ڸ 丮 ȯѴ.Userdir þ enabled
disabled Ű带 , ƱԸƮ
ϸ óϿ 丮 ȯѴ.
http://www.foo.com/~bob/one/two.html û
ȯȴ:
| UserDir þ | ȯ |
|---|---|
| UserDir public_html | ~bob/public_html/one/two.html |
| UserDir /usr/web | /usr/web/bob/one/two.html |
| UserDir /home/*/www | /home/bob/www/one/two.html |
þ Ŭ̾Ʈ ̷ :
| UserDir þ | ȯ |
|---|---|
| UserDir http://www.foo.com/users | http://www.foo.com/users/bob/one/two.html |
| UserDir http://www.foo.com/*/usr | http://www.foo.com/bob/usr/one/two.html |
| UserDir http://www.foo.com/~*/ | http://www.foo.com/~bob/one/two.html |
߰ :
ڿԸ UserDir 丮 Ѵٸ,
:
UserDir disabled
UserDir enabled user1 user2 user3
κ ڿ UserDir 丮 ϰ
Ϻθ źѴٸ, :
UserDir enabled
UserDir disabled user4 user5 user6
ٸ 丮 ִ. ɾ Ѵٸ:
Userdir public_html /usr/web http://www.foo.com/
http://www.foo.com/~bob/one/two.html û ϸ, ~bob/public_html/one/two.html ã, /usr/web/bob/one/two.html ã , http://www.foo.com/bob/one/two.html ̷ .
̷ Ѵٸ ξ Ѵ. ġ ̷ ߴ , ̷ տ θ ̷ ϰ ȴ.
Apache HTTP Server Version 2.4
| : | |
|---|---|
| : | Extension |
| : | version_module |
| ҽ: | mod_version.c |
| : | ġ 2.1 ĺ |
ٸ ٷ ū Ʈ
Ʈ ϱ .
ǥ Ͽ ο ˻簡
<IfVersion>
Ѵ.
<IfVersion 2.1.0>
# Ȯ 2.1.0̴
</IfVersion>
<IfVersion >= 2.2>
# ¥ ο Ѵ :-)
</IfVersion>
ٸ Ʒ Ѵ.
| : | ´ |
|---|---|
| : | <IfVersion [[!]operator] version> ...
</IfVersion> |
| : | ּ, ȣƮ, directory, .htaccess |
| Override ɼ: | All |
| : | Extension |
| : | mod_version |
<IfVersion>
ϴ Ҷ þ
´. Ϲ () version ƱԸƮ
2.1.0̳ 2.2
major[.minor[.patch]]
̴. minor patch ȴ.
̵ ڰ ٸ 0̶ Ѵ.
operator ϴ.
| operator | |
|---|---|
= Ȥ == |
|
> |
ū |
>= |
ũų |
< |
|
<= |
۰ų |
<IfVersion >= 2.1>
# 2.1.0 ũų
# Ѵ.
</IfVersion>
ܿ ǥ Ͽ ִ. ΰ ִ.
| operator | |
|---|---|
= Ȥ == |
version
/regex/ ̴ |
~ |
version
regex ̴ |
<IfVersion = /^2.1.[01234]$/>
# , װ ִ Ư ذå ´
</IfVersion>
տ ǥ(!) ǹ̸ ݴ
ؼѴ.
<IfVersion !~ ^2.1.[01234]$>
# ƴϸ
</IfVersion>
operator ϸ =̶
Ѵ.
Apache HTTP Server Version 2.4
ġ ִ Ÿ. , Ư ϱؼ ٽ ؾ 찡 ִ. Ӽ :
ϰ ؼ ҽڵ尡 ִ ҽϸ̴.
<IfModule>
þ ϴ ̸̱ ϴ.
Īϴ ڿ, о̴
LoadModule þ
Ѵ. Ȯ ϸ ҽϿ module ܺκ
̸̴.
Serveur HTTP Apache Version 2.4
| Description: | Permet à une application d'autorisation FastCGI de gérer l'authentification et l'autorisation httpd. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | authnz_fcgi_module |
| Fichier Source: | mod_authnz_fcgi.c |
| Compatibilité: | Disponible à partir de la version 2.4.10 du serveur HTTP Apache |
Ce module permet aux applications d'autorisation FastCGI d'authentifier les utilisateurs et de contrôler leur accès aux ressources. Il supporte les systèmes d'autorisation FastCGI génériques qui participent en une seule phase à l'authentification et à l'autorisation, ainsi que les processus d'authentification et d'autorisation spécifiques à Apache httpd qui interviennent en une ou plusieurs phases.
Les processus d'autorisation FastCGI peuvent authentifier un utilisateur via son identificateur et son mot de passe comme dans le processus d'authentification basique, ou via un mécanisme arbitraire.
Les modes d'invocation des processus d'autorisation FastCGI que ce module supporte se distinguent par deux caractéristiques : le type et le mécanisme d'authentification.
Le Type est simplement authn pour
l'authentification, authz pour l'autorisation et
authnz l'authentification et l'autorisation.
Le mécanisme d'authentification fait référence aux
mécanismes d'authentification et aux phases de traitement de la
configuration de Apache httpd, et peut être
AuthBasicProvider, Require, ou
check_user_id. Les deux premiers mécanismes
correspondent aux directives utilisées pour participer aux phases de
traitement appropriées.
Description de chaque mode:
authn, mechanism
AuthBasicProviderFCGI_ROLE est définie à
AUTHORIZER, et la variable
FCGI_APACHE_ROLE à AUTHENTICATOR.
L'application doit être spécifiée en tant que fournisseur de type
authn via la directive AuthnzFcgiDefineProvider, et
activée via la directive AuthBasicProvider. Lorsqu'elle
est invoquée, l'application est censée authentifier le client à
l'aide de l'identifiant et du mot de passe de l'utilisateur.
Exemple d'application :
#!/usr/bin/perl
use FCGI;
my $request = FCGI::Request();
while ($request->Accept() >= 0) {
die if $ENV{'FCGI_APACHE_ROLE'} ne "AUTHENTICATOR";
die if $ENV{'FCGI_ROLE'} ne "AUTHORIZER";
die if !$ENV{'REMOTE_PASSWD'};
die if !$ENV{'REMOTE_USER'};
print STDERR "This text is written to the web server error log.\n";
if ( ($ENV{'REMOTE_USER' } eq "foo" || $ENV{'REMOTE_USER'} eq "foo1") &&
$ENV{'REMOTE_PASSWD'} eq "bar" ) {
print "Status: 200\n";
print "Variable-AUTHN_1: authn_01\n";
print "Variable-AUTHN_2: authn_02\n";
print "\n";
}
else {
print "Status: 401\n\n";
}
}
Exemple de configuration httpd :
AuthnzFcgiDefineProvider authn FooAuthn fcgi://localhost:10102/ <Location "/protected/"> AuthType Basic AuthName "Restricted" AuthBasicProvider FooAuthn Require ... </Location>
authz, mechanism
RequireFCGI_ROLE est définie à
AUTHORIZER et FCGI_APACHE_ROLE à
AUTHORIZER. L'application doit être spécifiée en tant
que fournisseur de type authz via la directive AuthnzFcgiDefineProvider.
Lorsqu'elle est invoquée, l'application est censée contrôler les
accès du client à l'aide de l'identifiant utilisateur et d'autres
données contenues dans la requête. Exemple d'application :
#!/usr/bin/perl
use FCGI;
my $request = FCGI::Request();
while ($request->Accept() >= 0) {
die if $ENV{'FCGI_APACHE_ROLE'} ne "AUTHORIZER";
die if $ENV{'FCGI_ROLE'} ne "AUTHORIZER";
die if $ENV{'REMOTE_PASSWD'};
print STDERR "This text is written to the web server error log.\n";
if ($ENV{'REMOTE_USER'} eq "foo1") {
print "Status: 200\n";
print "Variable-AUTHZ_1: authz_01\n";
print "Variable-AUTHZ_2: authz_02\n";
print "\n";
}
else {
print "Status: 403\n\n";
}
}
Exemple de configuration httpd :
AuthnzFcgiDefineProvider authz FooAuthz fcgi://localhost:10103/ <Location "/protected/"> AuthType ... AuthName ... AuthBasicProvider ... Require FooAuthz </Location>
authnz, mechanism
AuthBasicProvider + RequireFCGI_ROLE est
définie à AUTHORIZER et FCGI_APACHE_ROLE
n'est pas définie. L'application doit être spécifiée en tant que
fournisseur de type authnz via la directive AuthnzFcgiDefineProvider.
L'application est censée assurer l'authentification et
l'autorisation au cours d'une même invocation à l'aide de
l'identifiant et du mot de passe de l'utilisateur et d'autres
données contenues dans la requête. L'invocation de l'application
intervient au cours de la phase d'authentification de l'API Apache
httpd. Si l'application renvoie le code 200, et si le même
fournisseur est invoqué au cours de la phase d'autorisation (via
une directive Require), mod_authnz_fcgi
renverra un code de type success pour la phase d'autorisation sans
invoquer l'application. Exemple d'application :
#!/usr/bin/perl
use FCGI;
my $request = FCGI::Request();
while ($request->Accept() >= 0) {
die if $ENV{'FCGI_APACHE_ROLE'};
die if $ENV{'FCGI_ROLE'} ne "AUTHORIZER";
die if !$ENV{'REMOTE_PASSWD'};
die if !$ENV{'REMOTE_USER'};
print STDERR "This text is written to the web server error log.\n";
if ( ($ENV{'REMOTE_USER' } eq "foo" || $ENV{'REMOTE_USER'} eq "foo1") &&
$ENV{'REMOTE_PASSWD'} eq "bar" &&
$ENV{'REQUEST_URI'} =~ m%/bar/.*%) {
print "Status: 200\n";
print "Variable-AUTHNZ_1: authnz_01\n";
print "Variable-AUTHNZ_2: authnz_02\n";
print "\n";
}
else {
print "Status: 401\n\n";
}
}
Exemple de configuration httpd :
AuthnzFcgiDefineProvider authnz FooAuthnz fcgi://localhost:10103/ <Location "/protected/"> AuthType Basic AuthName "Restricted" AuthBasicProvider FooAuthnz Require FooAuthnz </Location>
authn, mechanism
check_user_idFCGI_ROLE est définie à
AUTHORIZER et FCGI_APACHE_ROLE à
AUTHENTICATOR. L'application doit être spécifiée en
tant que fournisseur de type authn via une directive
AuthnzFcgiDefineProvider. La
directive AuthnzFcgiCheckAuthnProvider
permet de l'invoquer. Exemple d'application :
#!/usr/bin/perl
use FCGI;
my $request = FCGI::Request();
while ($request->Accept() >= 0) {
die if $ENV{'FCGI_APACHE_ROLE'} ne "AUTHENTICATOR";
die if $ENV{'FCGI_ROLE'} ne "AUTHORIZER";
# This authorizer assumes that the RequireBasicAuth option of
# AuthnzFcgiCheckAuthnProvider is On:
die if !$ENV{'REMOTE_PASSWD'};
die if !$ENV{'REMOTE_USER'};
print STDERR "This text is written to the web server error log.\n";
if ( ($ENV{'REMOTE_USER' } eq "foo" || $ENV{'REMOTE_USER'} eq "foo1") &&
$ENV{'REMOTE_PASSWD'} eq "bar" ) {
print "Status: 200\n";
print "Variable-AUTHNZ_1: authnz_01\n";
print "Variable-AUTHNZ_2: authnz_02\n";
print "\n";
}
else {
print "Status: 401\n\n";
# If a response body is written here, it will be returned to
# the client.
}
}
Exemple de configuration httpd :
AuthnzFcgiDefineProvider authn FooAuthn fcgi://localhost:10103/
<Location "/protected/">
AuthType ...
AuthName ...
AuthnzFcgiCheckAuthnProvider FooAuthn \
Authoritative On \
RequireBasicAuth Off \
UserExpr "%{reqenv:REMOTE_USER}"
Require ...
</Location>
AUTHENTICATOR et
AUTHORIZER), vous pouvez définir des fournisseurs
séparés comme suit, même s'ils correspondent à la même application :
AuthnzFcgiDefineProvider authn FooAuthn fcgi://localhost:10102/ AuthnzFcgiDefineProvider authz FooAuthz fcgi://localhost:10102/Spécifie le fournisseur authn via la directive
AuthBasicProvider
et le fournisseur authz via la directive
Require:
AuthType Basic AuthName "Restricted" AuthBasicProvider FooAuthn Require FooAuthz
AUTHORIZER (authentification et autorisation en une
seule invocation), vous pouvez définir un fournisseur unique comme
suit :
AuthnzFcgiDefineProvider authnz FooAuthnz fcgi://localhost:10103/Spécifie le fournisseur authnz via les directives
AuthBasicProvider et
Require :
AuthType Basic AuthName "Restricted" AuthBasicProvider FooAuthnz Require FooAuthnz
Les fonctionnalités suivantes ne sont pas encore implémentées :
FCGI_APACHE_ROLE
est définie à ACCESS_CHECKER.fcgistarter permet de
les démarrer.ProxyPass utilisée avec les répondeurs
FastCGI.error ou supérieur.warn.debug.trace2. La valeur de la
variable REMOTE_PASSWD sera occultée, mais
toute autre donnée sensible sera visible dans le
journal.trace5. Toutes les données sensibles seront
visibles dans le journal.La directive LogLevel permet
de configurer un niveau de journalisation spécifique à
mod_authnz_fcgi. Par exemple :
LogLevel info authnz_fcgi:trace8
| Description: | Permet à une application FastCGI de gérer l'accroche d'authentification check_authn. |
|---|---|
| Syntaxe: | AuthnzFcgiCheckAuthnProvider provider-name| |
| Défaut: | none |
| Contexte: | répertoire |
| Statut: | Extension |
| Module: | mod_authnz_fcgi |
Cette directive permet de confier à une application FastCGI la gestion d'une phase spécifique du processus d'authentification ou d'autorisation.
Certaines fonctionnalités des fournisseurs d'autorisation FastCGI
nécessitent cette directive en lieu et place de
AuthBasicProvider pour pouvoir être activées :
UserExpr ci-dessousAuthnzFcgiDefineProvider.NoneNone pour désactiver un fournisseur
activé avec cette même directive dans une autre portée, par
exemple dans un répertoire parent.UserExpr est défini et correspond à une chaîne
vide, (par exemple, si le fournisseur d'autorisation ne renvoie
aucune variable), c'est cette valeur qui sera utilisée comme id
utilisateur par défaut. Cela se produit souvent lorsqu'on se trouve dans
un contexte d'invité, ou d'utilisateur non authentifié ;
les utilisateurs et invités se voient alors attribué un id
utilisateur spécifique qui permettra de se connecter et
d'accéder à certaines ressources.Variable-XXX renvoyée par le
fournisseur d'autorisation via une option du style
UserExpr "%{reqenv:XXX}". Si cette option
est spécifiée, et si l'id utilisateur ne peut pas être définie
via l'expression après une authentification réussie, la requête
sera rejetée avec un code d'erreur 500.| Description: | Définit une application FastCGI en tant que fournisseur d'authentification et/ou autorisation |
|---|---|
| Syntaxe: | AuthnzFcgiDefineProvider type provider-name
backend-address |
| Défaut: | none |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_authnz_fcgi |
Cette directive permet de définir une application FastCGI en tant que fournisseur pour une phase particulière d'authentification ou d'autorisation.
AuthBasicProvider et
Require.fcgistarter.Serveur HTTP Apache Version 2.4
| Description: | Autorisation basique |
|---|---|
| Statut: | Base |
| Identificateur de Module: | authz_core_module |
| Fichier Source: | mod_authz_core.c |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache HTTPD |
Ce module fournit des fonctionnalités d'autorisation basiques
permettant d'accorder ou refuser l'accès à certaines zones du site
web aux utilisateurs authentifiés. mod_authz_core
donne la possibilité d'enregistrer divers fournisseurs
d'autorisation. Il est en général utilisé avec un module fournisseur
d'authentification comme mod_authn_file, et un
module d'autorisation comme mod_authz_user. Il
permet aussi l'application d'une logique élaborée au déroulement du
processus d'autorisation.
AuthMerging <AuthzProviderAlias> AuthzSendForbiddenOnFailure Require <RequireAll> <RequireAny> <RequireNone>Les directives de conteneur d'autorisation <RequireAll>,
<RequireAny> et <RequireNone>
peuvent être combinées entre elles et avec la directive Require pour confectionner une
logique d'autorisation complexe.
L'exemple ci-dessous illustre la logique d'autorisation suivante.
Pour pouvoir accéder à la ressource, l'utilisateur doit être
l'utilisateur superadmin, ou appartenir aux deux
groupes LDAP admins et Administrateurs et
soit appartenir au groupe ventes ou avoir
ventes comme valeur de l'attribut LDAP
dept. De plus, pour pouvoir accéder à la ressource,
l'utilisateur ne doit appartenir ni au groupe temps, ni
au groupe LDAP Employés temporaires.
<Directory "/www/mydocs">
<RequireAll>
<RequireAny>
Require user superadmin
<RequireAll>
Require group admins
Require ldap-group "cn=Administrators,o=Airius"
<RequireAny>
Require group sales
Require ldap-attribute dept="sales"
</RequireAny>
</RequireAll>
</RequireAny>
<RequireNone>
Require group temps
Require ldap-group "cn=Temporary Employees,o=Airius"
</RequireNone>
</RequireAll>
</Directory>
Le module mod_authz_core met à disposition des
fournisseurs d'autorisation génériques utilisables avec la directive
Require.
Le fournisseur env permet de contrôler l'accès au
serveur en fonction de l'existence d'une variable d'environnement. Lorsque Require
env env-variable est spécifié, la requête se voit
autoriser l'accès si la variable d'environnement
env-variable existe. Le serveur permet de définir
facilement des variables d'environnement en fonction des
caractéristiques de la requête du client via les directives fournies
par le module mod_setenvif. Cette directive Require
env permet donc de contrôler l'accès en fonction des
valeurs des en-têtes de la requête HTTP tels que
User-Agent (type de navigateur), Referer,
entre autres.
SetEnvIf User-Agent "^KnockKnock/2\.0" let_me_in
<Directory "/docroot">
Require env let_me_in
</Directory>
Avec cet exemple, les navigateurs dont la chaîne user-agent
commence par KnockKnock/2.0 se verront autoriser
l'accès, alors que tous les autres seront rejetés.
Lorsque le serveur cherche un chemin via une sous-requête interne (par exemple la
recherche d'un DirectoryIndex), ou lorsqu'il génère un
listing du contenu d'un répertoire via le module
mod_autoindex, la sous-requête n'hérite pas des
variables d'environnement spécifiques à la requête. En outre, à cause
des phases de l'API auxquelles mod_setenvif prend
part, les directives SetEnvIf ne sont pas évaluées
séparément dans la sous-requête.
Le fournisseur all reproduit la fonctionnalité
précédemment fournie par les directives 'Allow from all' et 'Deny
from all'. Il accepte un argument dont les deux valeurs possibles
sont : 'granted' ou 'denied'. Les exemples suivants autorisent ou
interdisent l'accès à toutes les requêtes.
Require all granted
Require all denied
Le fournisseur method permet d'utiliser la méthode
HTTP dans le processus d'autorisation. Les méthodes GET et HEAD sont
ici considérées comme équivalentes. La méthode TRACE n'est pas
supportée par ce fournisseur ; utilisez à la place la directive
TraceEnable.
Dans l'exemple suivant, seules les méthodes GET, HEAD, POST, et OPTIONS sont autorisées :
Require method GET POST OPTIONS
Dans l'exemple suivant, les méthodes GET, HEAD, POST, et OPTIONS sont autorisées sans authentification, alors que toutes les autres méthodes nécessitent un utilisateur valide :
<RequireAny>
Require method GET POST OPTIONS
Require valid-user
</RequireAny>
Le fournisseur expr permet d'accorder l'autorisation
d'accès de base en fonction d'expressions arbitraires.
Require expr "%{TIME_HOUR} -ge 9 && %{TIME_HOUR} -le 17"
<RequireAll>
Require expr "!(%{QUERY_STRING} =~ /secret/)"
Require expr "%{REQUEST_URI} in { '/example.cgi', '/other.cgi' }"
</RequireAll>
Require expr "!(%{QUERY_STRING} =~ /secret/) && %{REQUEST_URI} in { '/example.cgi', '/other.cgi' }"
La syntaxe de l'expression est décrite dans la documentation de ap_expr. Avant la version 2.4.16, les doubles-quotes étaient prohibées
Normalement, l'expression est évaluée avant l'authentification.
Cependant, si l'expression renvoie false et se réfère à la variable
%{REMOTE_USER}, le processus d'authentification sera
engagé et l'expression réévaluée.
Il est possible de créer des fournisseurs d'autorisation étendus
dans le fichier de configuration et de leur assigner un nom d'alias.
On peut ensuite utiliser ces fournisseurs aliasés dans une
directive Require de
la même manière qu'on le ferait pour des fournisseurs d'autorisation
de base. En plus de la possibilité de créer et d'aliaser un
fournisseur étendu, le même fournisseur d'autorisation étendu peut
être référencé par plusieurs localisations.
Dans l'exemple suivant, on crée deux alias de fournisseur d'autorisation ldap différents basés sur le fournisseur d'autorisation ldap-group. Il est ainsi possible pour un seul répertoire de vérifier l'appartenance à un groupe dans plusieurs serveurs ldap :
<AuthzProviderAlias ldap-group ldap-group-alias1 "cn=my-group,o=ctx">
AuthLDAPBindDN "cn=youruser,o=ctx"
AuthLDAPBindPassword yourpassword
AuthLDAPURL "ldap://ldap.host/o=ctx"
</AuthzProviderAlias>
<AuthzProviderAlias ldap-group ldap-group-alias2 "cn=my-other-group,o=dev">
AuthLDAPBindDN "cn=yourotheruser,o=dev"
AuthLDAPBindPassword yourotherpassword
AuthLDAPURL "ldap://other.ldap.host/o=dev?cn"
</AuthzProviderAlias>
Alias "/secure" "/webpages/secure"
<Directory "/webpages/secure">
Require all granted
AuthBasicProvider file
AuthType Basic
AuthName LDAP_Protected_Place
#implied OR operation
Require ldap-group-alias1
Require ldap-group-alias2
</Directory>
| Description: | Définit la manière dont chaque logique d'autorisation des sections de configuration se combine avec celles des sections de configuration précédentes. |
|---|---|
| Syntaxe: | AuthMerging Off | And | Or |
| Défaut: | AuthMerging Off |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_authz_core |
Lorsque l'autorisation est activée, elle est normalement héritée
par chaque section de
configuration suivante, à moins qu'un jeu de directives
d'autorisations différent ne soit spécifié. Il s'agit du
comportement par défaut, qui correspond à la définition explicite
AuthMerging Off.
Dans certaines situations cependant, il peut être souhaitable de
combiner la logique d'autorisation d'une section de configuration
avec celle de la section précédente lorsque les sections de
configuration se combinent entre elles. Dans ce cas, deux options
sont disponibles, And et Or.
Lorsqu'une section de configuration contient AuthMerging
And ou AuthMerging Or, sa logique d'autorisation
se combine avec celle de la section de configuration qui la précède
(selon l'ordre général des sections de configuration), et qui
contient aussi une logique d'autorisation, comme si les deux
sections étaient concaténées respectivement dans une directive
<RequireAll> ou <RequireAny>.
AuthMerging ne concerne que la section de
configuration dans laquelle elle apparaît. Dans l'exemple suivant,
seuls les utilisateurs appartenant au groupe alpha sont
autorisés à accéder à /www/docs. Les utilisateurs
appartenant au groupe alpha ou au groupe
beta sont autorisés à accéder à
/www/docs/ab. Cependant, la définition implicite à
Off de la directive AuthMerging
s'applique à la section de configuration <Directory> concernant le répertoire
/www/docs/ab/gamma, ce qui implique que les directives
d'autorisation de cette section l'emportent sur celles des sections
précédentes. Par voie de conséquence, seuls les utilisateurs
appartenant au groupe gamma sont autorisés à accéder à
/www/docs/ab/gamma.<Directory "/www/docs">
AuthType Basic
AuthName Documents
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
Require group alpha
</Directory>
<Directory "/www/docs/ab">
AuthMerging Or
Require group beta
</Directory>
<Directory "/www/docs/ab/gamma">
Require group gamma
</Directory>
| Description: | Regroupe des directives représentant une extension d'un fournisseur d'autorisation de base qui pourra être référencée à l'aide de l'alias spécifié |
|---|---|
| Syntaxe: | <AuthzProviderAlias fournisseur-de-base Alias
Paramètres-Require>
... </AuthzProviderAlias>
|
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_authz_core |
Les balises <AuthzProviderAlias> et
</AuthzProviderAlias> permettent de regrouper des
directives d'autorisation auxquelles on pourra faire référence à
l'aide de l'alias spécifié dans une directive Require.
Si Require-Parameters comporte plusieurs paramètres, la liste de ces derniers doit être entourée de guillemets. Dans le cas contraire, seul le premier paramètre de la liste sera pris en compte.
# Dans cet exemple, pour que les deux adresses IP soient prises en compte, elles
# DOIVENT être entourées de guillemets
<AuthzProviderAlias ip reject-ips "XXX.XXX.XXX.XXX YYY.YYY.YYY.YYY">
</AuthzProviderAlias>
<Directory "/path/to/dir">
<RequireAll>
Require not reject-ips
Require all granted
</RequireAll>
</Directory>
| Description: | Envoie '403 FORBIDDEN' au lieu de '401 UNAUTHORIZED' si l'authentification réussit et si l'autorisation a été refusée. |
|---|---|
| Syntaxe: | AuthzSendForbiddenOnFailure On|Off |
| Défaut: | AuthzSendForbiddenOnFailure Off |
| Contexte: | répertoire, .htaccess |
| Statut: | Base |
| Module: | mod_authz_core |
| Compatibilité: | Disponible depuis la version 2.3.11 d'Apache HTTPD |
Par défaut, si l'authentification réussit, alors que
l'autorisation est refusée, Apache HTTPD renvoie un code de réponse
HTTP '401 UNAUTHORIZED'. En général, les navigateurs proposent alors
une nouvelle fois à l'utilisateur la boîte de dialogue de saisie du
mot de passe, ce qui n'est pas toujours souhaitable. La directive
AuthzSendForbiddenOnFailure permet de changer
le code de réponse en '403 FORBIDDEN'.
La modification de la réponse en cas de refus d'autorisation diminue la sécurité du mot de passe, car elle indique à un éventuel attaquant que le mot de passe qu'il a saisi était correct.
| Description: | Vérifie si un utilisateur authentifié a une autorisation d'accès accordée par un fournisseur d'autorisation. |
|---|---|
| Syntaxe: | Require [not] nom-entité [nom-entité]
... |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_authz_core |
Cette directive permet de vérifier si un utilisateur authentifié
a l'autorisation d'accès accordée pour un certain fournisseur
d'autorisation et en tenant compte de certaines restrictions.
mod_authz_core met à disposition les fournisseurs
d'autorisation génériques suivants :
Require all grantedRequire all deniedRequire env env-var [env-var]
...Require method http-method [http-method]
...Require expr expression Voici quelques exemples de syntaxes autorisées par
mod_authz_user, mod_authz_host et
mod_authz_groupfile :
Require user identifiant utilisateur
[identifiant utilisateur]
...Require group nom groupe [nom
groupe]
...Require valid-userRequire ip 10 172.20 192.168.2Require forward-dns dynamic.example.orgD'autres modules d'autorisation comme
mod_authnz_ldap, mod_authz_dbm,
mod_authz_dbd,
mod_authz_owner et mod_ssl
implémentent des options de la directive Require.
Pour qu'une configuration d'authentification et d'autorisation
fonctionne correctement, la directive Require
doit être accompagnée dans la plupart des cas de directives AuthName, AuthType et AuthBasicProvider ou AuthDigestProvider, ainsi que
de directives telles que AuthUserFile et AuthGroupFile (pour la
définition des utilisateurs et des groupes). Exemple :
AuthType Basic AuthName "Restricted Resource" AuthBasicProvider file AuthUserFile "/web/users" AuthGroupFile "/web/groups" Require group admin
Les contrôles d'accès appliqués de cette manière sont effectifs
pour toutes les méthodes. C'est d'ailleurs
ce que l'on souhaite en général. Si vous voulez n'appliquer
les contrôles d'accès qu'à certaines méthodes, tout en laissant les
autres méthodes sans protection, placez la directive
Require dans une section <Limit>.
Le résultat de la directive Require peut
être inversé en utilisant l'option not. Comme dans le
cas de l'autre directive d'autorisation inversée <RequireNone>, si la directive
Require est inversée, elle ne peut qu'échouer
ou produire un résultat neutre ; elle ne peut donc alors pas
autoriser une requête de manière indépendante.
Dans l'exemple suivant, tous les utilisateurs appartenant aux
groupes alpha et beta ont l'autorisation
d'accès, à l'exception de ceux appartenant au groupe
reject.
<Directory "/www/docs">
<RequireAll>
Require group alpha beta
Require not group reject
</RequireAll>
</Directory>
Lorsque plusieurs directives Require sont
placées dans une même section de
configuration, et ne se trouvent pas dans une autre directive
d'autorisation comme <RequireAll>, elles sont implicitement
contenues dans une directive <RequireAny>. Ainsi, la première directive
Require qui autorise l'accès à un utilisateur
autorise l'accès pour l'ensemble de la requête, et les directives
Require suivantes sont ignorées.
Prettez une attention particulière aux directives d'autorisation
définies
au sein des sections Location
qui se chevauchent avec des contenus servis depuis le système de
fichiers. Par défaut, les configurations définies dans ces sections l'emportent sur les
configurations d'autorisations définies au sein des sections
Directory et Files sections.
La directive AuthMerging permet de contrôler
la manière selon laquelle les configurations d'autorisations sont
fusionnées au sein des sections précitées.
| Description: | Regroupe plusieurs directives d'autorisation dont aucune ne doit échouer et dont au moins une doit retourner un résultat positif pour que la directive globale retourne elle-même un résultat positif. |
|---|---|
| Syntaxe: | <RequireAll> ... </RequireAll> |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_authz_core |
Les balises <RequireAll> et
</RequireAll> permettent de regrouper des
directives d'autorisation dont aucune ne doit échouer, et dont au
moins une doit retourner un résultat positif pour que la directive
<RequireAll> retourne elle-même
un résultat positif.
Si aucune des directives contenues dans la directive <RequireAll> n'échoue, et si au moins une
retourne un résultat positif, alors la directive <RequireAll> retourne elle-même un résultat
positif. Si aucune ne retourne un résultat positif, et si aucune
n'échoue, la directive globale retourne un résultat neutre. Dans
tous les autres cas, elle échoue.
| Description: | Regroupe des directives d'autorisation dont au moins une doit retourner un résultat positif pour que la directive globale retourne elle-même un résultat positif. |
|---|---|
| Syntaxe: | <RequireAny> ... </RequireAny> |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_authz_core |
Les balises <RequireAny> et
</RequireAny> permettent de regrouper des
directives d'autorisation dont au moins une doit retourner un
résultat positif pour que la directive <RequireAny> retourne elle-même un résultat
positif.
Si une ou plusieurs directives contenues dans la directive
<RequireAny> retournent un
résultat positif, alors la directive <RequireAny> retourne elle-même un résultat
positif. Si aucune ne retourne un résultat positif et aucune
n'échoue, la directive globale retourne un résultat neutre. Dans
tous les autres cas, elle échoue.
<RequireAny> (elles pourraient tout au plus
faire échouer la directive dans le cas où elles échoueraient
elles-mêmes, et où
toutes les autres directives retourneraient un résultat neutre).
C'est pourquoi il n'est pas permis d'utiliser les directives
d'autorisation inversées dans une directive <RequireAny>.| Description: | Regroupe des directives d'autorisation dont aucune ne doit retourner un résultat positif pour que la directive globale n'échoue pas. |
|---|---|
| Syntaxe: | <RequireNone> ... </RequireNone> |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_authz_core |
Les balises <RequireNone> et
</RequireNone> permettent de regrouper des
directives d'autorisation dont aucune ne doit retourner un résultat
positif pour que la directive <RequireNone> n'échoue pas.
Si une ou plusieurs directives contenues dans la directive
<RequireNone> retournent un
résultat positif, la directive <RequireNone> échouera. Dans tous les
autres cas, cette dernière retournera un résultat neutre. Ainsi,
comme pour la directive d'autorisation inversée Require
not, elle ne peut jamais autoriser une requête de manière
indépendante car elle ne pourra jamais retourner un résultat
positif. Par contre, on peut l'utiliser pour restreindre l'ensemble
des utilisateurs autorisés à accéder à une ressource.
<RequireNone>.
C'est pourquoi il n'est pas permis d'utiliser les directives
d'autorisation inversées dans une directive <RequireNone>.Serveur HTTP Apache Version 2.4
| Description: | Autorisation basée sur les groupes à l'aide de fichiers textes |
|---|---|
| Statut: | Base |
| Identificateur de Module: | authz_groupfile_module |
| Fichier Source: | mod_authz_groupfile.c |
| Compatibilité: | Disponible depuis les versions 2.1 et supérieures d'Apache |
Ce module permet d'autoriser ou d'interdire l'accès à
certaines zones du site web aux utilisateurs authentifiés en
fonction de leur appartenance à un groupe spécifié. Le module
mod_authz_dbm fournit une fonctionnalité similaire.
Les directives Require d'Apache permettent,
au cours de la phase d'autorisation, de s'assurer qu'un utilisateur
est bien autorisé à accéder à une ressource. mod_authz_groupfile ajoute
les types d'autorisation group et file-group.
A partir de la version 2.4.8, les directives require groupfile supportent les expressions.
Cette directive permet de spécifier à quel groupe un utilisateur doit appartenir pour obtenir l'autorisation d'accès.
Require group admin
Lorsque cette directive est définie, Les permissions système du fichier
auquel on veut accéder sont vérifiées. L'utilisateur doit être un membre d'un
groupe de même nom que le groupe qui possède le fichier. Voir
mod_authz_owner pour plus de détails.
Require file-group
| Description: | Définit le nom d'un fichier texte contenant la liste des groupes d'utilisateurs permettant de définir les autorisations des utilisateurs |
|---|---|
| Syntaxe: | AuthGroupFile chemin-fichier |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_authz_groupfile |
La directive AuthGroupFile permet de définir
le nom d'un fichier texte contenant la liste des groupes d'utilisateurs.
L'appartenance d'un utilisateur à tel ou tel groupe pourra dès lors être utilisée
pour définir les permissions d'accès de l'utilisateur.
chemin-fichier est le chemin du fichier de groupes. S'il n'est
pas absolu, ce chemin est considéré comme relatif au répertoire défini par
la directive ServerRoot.
Chaque ligne du fichier de groupes contient un nom de groupe suivi du caractère ':' et des noms des utilisateurs membres du groupe séparés par des espaces.
mon-groupe : bob joe anne
Notez que la recherche dans de grands fichiers textes est
très inefficace ; la directive AuthDBMGroupFile fournit de bien meilleures
performances.
Le fichier AuthGroupFile ne doit pas
être stocké dans l'arborescence des documents du site web ; ne le placez
surtout pas dans le répertoire qu'il protège, faute de quoi les
clients pourraient le télécharger.
Serveur HTTP Apache Version 2.4
| Description: | Autorisation basée sur l'utilisateur |
|---|---|
| Statut: | Base |
| Identificateur de Module: | authz_user_module |
| Fichier Source: | mod_authz_user.c |
| Compatibilité: | Disponible depuis les versions 2.1 et supérieures d'Apache |
Ce module permet d'accorder ou de refuser l'accès à certaines
zones du site web aux utilisateurs authentifiés.
mod_authz_user accorde l'accès si l'utilisateur
authentifié fait partie de la liste spécifiée par une directive
Require user. On peut aussi utiliser la directive
Require valid-user pour accorder l'accès à tous les
utilisateurs qui ont été authentifiés avec succès.
Ce module ne fournit aucune directive.
Les directives Require d'Apache permettent,
au cours de la phase d'autorisation, de s'assurer qu'un utilisateur
est bien autorisé à accéder à une
ressource. mod_authz_user ajoute
les types d'autorisation user et valid-user.
A partir de la version 2.4.8, les directives require user supportent les expressions.
Cette directive permet de spécifier une liste d'utilisateurs autorisés à accéder à la ressource.
Require user john paul george ringo
Lorsque cette directive est définie, tout utilisateur qui s'est authentifié avec succès aura l'autorisation d'accès à la ressource.
Require valid-user
Serveur HTTP Apache Version 2.4
| Description: | Support de la mise en tampon des requêtes |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | buffer_module |
| Fichier Source: | mod_buffer.c |
| Compatibilité: | Disponible depuis les versions 2.3 et supérieures d'Apache |
Ce module fournit la possibilité de mettre en tampon les piles des filtres en entrée et sortie.
Dans certaines situations, les générateurs de contenu créent des contenus composés de petits tronçons. Afin de permettre la réutilisation de la mémoire, les éléments de mémoire attribués aux tronçons ont toujours une taille de 8k, quelle que soit la taille du tronçon lui-même. Lorsqu'une requête génère de nombreux petits tronçons, une grande quantité de mémoire peut être mobilisée par le traitement de la requête, et une grande quantité de données transmises sans nécessité. Pour y remédier, l'utilisation d'un tampon rassemble la réponse en un nombre de tronçons le plus petit possible.
Lorsque httpd est utilisé comme frontal d'un générateur de contenu consommant beaucoup de ressources, la mise en tampon de la réponse peut permettre à ce dernier d'effectuer le traitement et de libérer les ressources plus ou moins rapidement, en fonction de la manière dont il a été conçu.
Le filtre de mise en tampon peut être ajouté aux piles des
filtres en entrée ou en sortie, selon les besoins, à l'aide des
directives SetInputFilter,
SetOutputFilter, AddOutputFilter ou AddOutputFilterByType.
AddOutputFilterByType INCLUDES;BUFFER text/html
| Description: | Taille maximale en octets du filtre par tampon |
|---|---|
| Syntaxe: | BufferSize entier |
| Défaut: | BufferSize 131072 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_buffer |
La directive BufferSize permet de spécifier la
quantité de données en octets qui sera mise en tampon avant d'être
lue depuis ou écrite vers chaque requête. La valeur par défaut est
128 ko.
Serveur HTTP Apache Version 2.4
| Description: | Module de stockage à base de cache d'objets partagés (socache) pour le filtre de mise en cache HTTP. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | cache_socache_module |
| Fichier Source: | mod_cache_socache.c |
Le module mod_cache_socache implémente un
gestionnaire de stockage à base de cache d'objets partagés (socache)
pour le module mod_cache.
Les en-têtes et corps des réponses mises en cache sont rassemblés et stockés sous une même clé dans le cache d'objets partagés. Il est possible de choisir entre plusieurs implémentations de caches d'objets partagés.
Des réponses avec différents contenus négociés peuvent être stockées simultanément ; cependant, la mise en cache de contenus partiels n'est pas encore supportée par ce module.
# Activation de la mise en cache
CacheSocache shmcb
CacheSocacheMaxSize 102400
<Location "/foo">
CacheEnable socache
</Location>
# Possibilité de se rabattre sur le cache disque
CacheSocache shmcb
CacheSocacheMaxSize 102400
<Location "/foo">
CacheEnable socache
CacheEnable disk
</Location>
Le module mod_cache_socache requiert les
services du module mod_cache qui doit donc avoir
été préalablement chargé.
CacheSocache CacheSocacheMaxSize CacheSocacheMaxTime CacheSocacheMinTime CacheSocacheReadSize CacheSocacheReadTime| Description: | Implémentation du cache d'objets partagés à utiliser |
|---|---|
| Syntaxe: | CacheSocache type[:args] |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache_socache |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache |
La directive CacheSocache
définit l'implémentation du cache d'objets partagés à utiliser,
suivie d'arguments optionnels. Il est
possible de choisir entre plusieurs implémentations de caches d'objets
partagés.
CacheSocache shmcb
| Description: | La taille maximale d'une entrée pouvant être placée dans le cache |
|---|---|
| Syntaxe: | CacheSocacheMaxSize octets |
| Défaut: | CacheSocacheMaxSize 102400 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache_socache |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache |
La directive CacheSocacheMaxSize
définit la taille maximale, en octets, de la somme des en-têtes et
du corps d'un document pouvant être stocké dans le cache. Bien
entendu, plus la taille des en-têtes sera grande, plus la taille
maximale du corps du document s'en trouvera réduite.
Le module mod_cache_socache ne tentera de mettre
en cache que des réponses qui possèdent une taille de contenu
explicite, ou dont la taille est suffisamment petite pour qu'elles
soient écrites en une seule passe. Ceci permet au module
mod_cache_disk de mettre en cache des réponses dont
la taille est trop importante pour pouvoir être mises en cache par
mod_cache_socache.
CacheSocacheMaxSize 102400
| Description: | La durée maximale de stockage d'un document dans le cache avant péremption |
|---|---|
| Syntaxe: | CacheSocacheMaxTime secondes |
| Défaut: | CacheSocacheMaxTime 86400 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache_socache |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache |
La directive CacheSocacheMaxTime
définit la durée de stockage maximale en secondes d'un document dans
le cache avant péremption. Cette définition l'emporte sur la durée
de fraîcheur définie pour le document par le protocole HTTP.
CacheSocacheMaxTime 86400
| Description: | La durée minimale de stockage d'un document dans le cache |
|---|---|
| Syntaxe: | CacheSocacheMinTime seconds |
| Défaut: | CacheSocacheMinTime 600 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache_socache |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache |
La directive CacheSocacheMinTime
définit le nombre de secondes au delà de la durée de fraîcheur de la
réponse pendant lesquelles cette dernière devra être stockée dans le
cache d'objets partagés. En effet, si une réponse n'est stockée que
pour une durée égale à sa durée de fraîcheur, elle n'a pas besoin
d'être rafraîchie.
CacheSocacheMinTime 600
| Description: | La quantité minimale de données du document à lire et mettre en cache avant envoi au client |
|---|---|
| Syntaxe: | CacheSocacheReadSize octets |
| Défaut: | CacheSocacheReadSize 0 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache_socache |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache |
La directive CacheSocacheReadSize
définit la quantité minimale de données, en octets, à lire depuis
l'arrière-plan avant envoi au client. Avec la valeur par défaut 0,
les données sont transmises au client dès leur arrivée et quelle que
soit leur taille. Si la valeur définie est non nulle, le cache
disque va mettre en tampon au moins la quantité de données
correspondante avant envoi au client. Ceci peut améliorer les
performances en cas de mise en cache de contenu en provenance d'un
mandataire inverse lent.
Cette directive n'a d'effet qu'au moment où les données sont stockées dans le cache, et non lorsqu'elles sont servies depuis le cache.
CacheSocacheReadSize 102400
| Description: | La durée minimale de lecture avant l'envoi des données |
|---|---|
| Syntaxe: | CacheSocacheReadTime millisecondes |
| Défaut: | CacheSocacheReadTime 0 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache_socache |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache |
La directive CacheSocacheReadTime
définit le temps minimal qui doit s'écouler avant de tenter
l'envoi des données au client. Cette durée sera mise à profit pour
lire et mettre en tampon les données avant leur envoi au client.
Ceci peut améliorer les performances en cas de mise en cache de
contenu en provenance d'un mandataire inverse.
La valeur par défaut 0 désactive cette directive.
Cette directive n'a d'effet qu'au moment où les données sont
stockées dans le cache, et non lorsqu'elles sont servies depuis le
cache. Il est recommandé d'utiliser cette directive en concomitance
avec la directive CacheSocacheReadSize afin de
s'assurer que le serveur ne mette pas les données en tampon de
manière excessive dans le cas où les données arriveraient plus vite
que prévu.
CacheSocacheReadTime 1000
Serveur HTTP Apache Version 2.4
| Description: | Autorisation basée sur l'appartenance des fichiers |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | authz_owner_module |
| Fichier Source: | mod_authz_owner.c |
| Compatibilité: | Disponible depuis les versions 2.1 et supérieures d'Apache |
Ce module permet de contrôler l'accès aux fichiers en comparant
l'identifiant utilisateur ayant servi à l'authentification HTTP
(l'identifiant utilisateur web) avec le propriétaire ou le groupe
du fichier demandé du point de vue du système de fichiers. Le nom
d'utilisateur et le mot de passe doivent déjà avoir été vérifiés par
un module d'authentification comme mod_auth_basic
ou mod_auth_digest.
mod_authz_owner reconnaît deux arguments pour la
directive Require :
file-owner et file-group :
file-ownerjones comme
propriétaire du fichier demandé, le nom d'utilisateur fourni pour
l'authentification HTTP doit aussi être jones.file-groupmod_authz_groupfile ou
mod_authz_dbm, et le nom d'utilisateur web fourni
pour l'authentification doit être un membre de ce groupe. Par
exemple, si le système indique que le groupe (système) du fichier
demandé est accounts, le groupe accounts
doit apparaître dans la base de données des groupes, et le nom
d'utilisateur web utilisé pour l'authentification doit être un
membre de ce groupe.Si le module mod_authz_owner est utilisé pour
vérifier l'autorisation d'accès à une ressource qui n'est pas
vraiment présente dans le système de fichiers (en d'autres termes
une ressource virtuelle), il refusera l'accès.
En particulier, il n'accordera jamais l'accès à une ressource du type "Vues multiples" (MultiViews) d'un contenu négocié.
Ce module ne fournit aucune directive.
Considérons un serveur Web Apache fonctionnant sous un système
multi-utilisateurs, où les fichiers de chaque utilisateur sont
stockés dans ~/public_html/private. En supposant
qu'il n'existe qu'une seule base de données contenant les noms
d'utilisateurs web, et que ces noms d'utilisateurs correspondent
aux noms d'utilisateurs système qui sont les propriétaires
effectifs des fichiers, la configuration de l'exemple suivant
n'accordera l'autorisation d'accès aux fichiers qu'à leur
propriétaire. L'utilisateur jones ne sera pas
autorisé à accéder aux fichiers situés dans
/home/smith/public_html/private, à moins que leur
propriétaire ne soit jones au lieu de
smith.
<Directory "/home/*/public_html/private">
AuthType Basic
AuthName MyPrivateFiles
AuthBasicProvider dbm
AuthDBMUserFile "/usr/local/apache2/etc/.htdbm-all"
Require file-owner
</Directory>
Considérons un système similaire à celui décrit ci-dessus, mais
où certains utilisateurs partagent leurs fichiers de projets dans
~/public_html/project-foo. Le groupe système des
fichiers est foo, et il n'existe qu'une seule base de
données AuthDBMGroupFile qui contient
tous les noms d'utilisateurs web et leurs groupes d'appartenance.
Ces noms d'utilisateurs web doivent alors appartenir au moins au
groupe foo. En d'autres termes, si jones
et smith sont tous deux membres du groupe
foo, ils seront autorisés à accéder aux
répertoires project-foo de chacun d'entre eux.
<Directory "/home/*/public_html/project-foo">
AuthType Basic
AuthName "Project Foo Files"
AuthBasicProvider dbm
# combined user/group database
AuthDBMUserFile "/usr/local/apache2/etc/.htdbm-all"
AuthDBMGroupFile "/usr/local/apache2/etc/.htdbm-all"
Satisfy All
Require file-group
</Directory>
Serveur HTTP Apache Version 2.4
| Description: | Compression du contenu via Brotli avant sa livraison au client |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | brotli_module |
| Fichier Source: | mod_brotli.c |
| Compatibilité: | Disponible à partir de la version 2.4.26 du serveur HTTP Apache |
Le module mod_brotli fournit le filtre en sortie
BROTLI_COMPRESS qui permet de compresser un contenu avant sa
livraison au client en utilisant la bibliothèque brotli. Ce filtre est
implémenté en utilisant la bibliothèque Brotli que l'on peut trouver à https://github.com/google/brotli.
Exemples de configurations Activation de la compression Interaction avec les serveurs mandataires Servir un contenu pré-compressé BrotliAlterETag BrotliCompressionMaxInputBlock BrotliCompressionQuality BrotliCompressionWindow BrotliFilterNoteCertaines applications web sont vulnérables à une attaque de type vol d'informations lorsqu'une connexion TLS transmet des données compressées. Pour plus d'informations, étudiez en détail la famille d'attaques "BREACH".
Voici une configuration simple qui compresse des types de contenus courants au format texte :
AddOutputFilterByType BROTLI_COMPRESS text/html text/plain text/xml text/css text/javascript application/javascript
Certaines applications web sont vulnérables à une attaque de type vol d'informations lorsqu'une connexion TLS transmet des données compressées. Pour plus d'informations, étudiez en détail la famille d'attaques "BREACH".
La compression est implémentée par le filtre BROTLI_COMPRESS. La
directive suivante active la compression pour les documents correspondant
au conteneur dans lequel elle est placée :
SetOutputFilter BROTLI_COMPRESS SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-brotli
Si vous voulez restreindre la compression à certains types MIME
particuliers, vous pouvez utiliser la directive AddOutputFilterByType. Dans l'exemple
suivant, l'activation de la compression est restreinte aux fichiers html
de la documentation d'Apache :
<Directory "/your-server-root/manual">
AddOutputFilterByType BROTLI_COMPRESS text/html
</Directory>
BROTLI_COMPRESS est toujours inséré après les
filtres RESOURCE comme PHP ou SSI. Il n'affecte jamais les sous-requêtes
internes.
SetEnv, la variable
d'environnement no-brotli permet de désactiver la
compression brotli pour une requête particulière, et ceci même si elle
est supportée par le client.
Le module mod_brotli envoie un en-tête de réponse HTTP
Vary:Accept-Encoding pour indiquer aux mandataires qu'une
réponse mise en cache ne doit être envoyée qu'aux clients qui envoient
l'en-tête de requête Accept-Encoding approprié. Ceci permet
d'éviter d'envoyer du contenu compressé à un client qui ne sera pas en
mesure de le décompresser.
Si vous utilisez des exclusions spéciales dépendant, par exemple, de
l'en-tête User-Agent, vous devez faire un ajout manuel à
l'en-tête Vary afin d'informer les mandataires des restrictions
supplémentaires. Par exemple, dans une configuration typique où l'addition
du filtre BROTLI_COMPRESS dépend de l'en-tête User-Agent,
vous devez ajouter :
Header append Vary User-Agent
Si votre décision d'utiliser la compression ou non dépend d'autres
informations que le contenu d'en-têtes de requêtes (par exemple la version
HTTP), vous devez affecter la valeur * à l'en-tête
Vary. Ceci permet d'éviter que des mandataires qui le
supportent n'effectuent une mise en cache intégrale.
Header set Vary *
comme mod_brotli compresse systématiquement un contenu
pour chaque requête le concernant, il est possible d'obtenir un gain en
performance en pré-compressant le contenu et en disant à mod_brotli de le
servir sans le recompresser. Pour cela, vous pouvez utiliser une
configuration du style :
<IfModule mod_headers.c>
# Sert des fichiers CSS compressés par brotli, s'ils existent
# et si le client supporte brotli.
RewriteCond "%{HTTP:Accept-encoding}" "br"
RewriteCond "%{REQUEST_FILENAME}\.br" "-s"
RewriteRule "^(.*)\.css" "$1\.css\.br" [QSA]
# Sert des fichiers JS compressés par brotli, s'ils existent
# et si le client supporte brotli.
RewriteCond "%{HTTP:Accept-encoding}" "br"
RewriteCond "%{REQUEST_FILENAME}\.br" "-s"
RewriteRule "^(.*)\.js" "$1\.js\.br" [QSA]
# Sert des types de contenu corrects, et évite la double compression.
RewriteRule "\.css\.gz$" "-" [T=text/css,E=no-brotli:1]
RewriteRule "\.js\.gz$" "-" [T=text/javascript,E=no-brotli:1]
<FilesMatch "(\.js\.br|\.css\.br)$">
# Sert un type d'encodage correct.
Header append Content-Encoding br
# Force les mandataires à mettre en cache séparément les fichiers css/js
# compressés ou non par brotli.
Header append Vary Accept-Encoding
</FilesMatch>
</IfModule>
| Description: | Comment l'en-tête de réponse ETag doit être modifié au cours de la compression |
|---|---|
| Syntaxe: | BrotliAlterETag AddSuffix|NoChange|Remove |
| Défaut: | BrotliAlterETag AddSuffix |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_brotli |
La directive BrotliAlterETag permet d'indiquer
comment l'en-tête ETag doit être modifié lorsqu'une réponse est compressée.
Ajoute la méthode de compression à la fin de l'en-tête ETag, ce qui implique que les représentations compressées et non compressées possèderont des en-têtes ETag uniques. C'est le comportement par défaut depuis la version 2.4.0 avec un autre module de compression dynamique, mod-deflate. Ce paramètre permet d'éviter l'envoi de messages "HTTP Not Modified" (304) en réponse aux requêtes conditionnelles pour des contenus compressés.
Ne modifie pas l'en-tête ETag d'une réponse compressée. C'était le comportement par défaut avant la version 2.4.0 avec un autre module de compression dynamique, mod-deflate. Ce paramètre ne respecte pas la propriété HTTP/1.1 selon laquelle toutes les représentations d'une même ressource ont des en-têtes ETag uniques.
Supprime l'en-tête ETag des réponses compressées, ce qui rend impossibles certaines requêtes conditionnelles, mais évite les inconvénients des options précédentes.
| Description: | Taille maximale du bloc de données en entrée |
|---|---|
| Syntaxe: | BrotliCompressionMaxInputBlock value |
| Défaut: | (automatic) |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_brotli |
La directive BrotliCompressionMaxInputBlock permet
de spécifier la taille maximale du bloc de données en entrée entre 16 et 24,
sachant que plus cette taille sera grande, plus grande sera la quantité de
mémoire consommée.
| Description: | Qualité de la compression |
|---|---|
| Syntaxe: | BrotliCompressionQuality value |
| Défaut: | BrotliCompressionQuality 5 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_brotli |
La directive BrotliCompressionQuality permet de
spécifier la qualité de la compression (une valeur entre 0 et
11). Les valeurs les plus hautes correspondent à une compression de
meilleure qualité mais plus lente.
| Description: | Taille de la fenêtre de compression glissante brotli |
|---|---|
| Syntaxe: | BrotliCompressionWindow value |
| Défaut: | BrotliCompressionWindow 18 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_brotli |
La directive BrotliCompressionWindow permet de
spécifier la taille de la fenêtre de compression glissante brotli (une
valeur comprise entre 10 et 24). Une taille de fenêtre plus grande peut
améliorer la qualité de la compression mais consomme d'avantage de mémoire.
| Description: | Enregistre le taux de compression dans une note à des fins de journalisation |
|---|---|
| Syntaxe: | BrotliFilterNote [type] notename |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_brotli |
La directive BrotliFilterNote permet d'indiquer
qu'une note à propos du taux de compression doit être attachée à la
requête. L'argument notename permet de spécifier le nom de la
note. Vous pouvez utiliser cette note à des fins de statistiques en ajoutant
l'information correspondante à votre access
log.
BrotliFilterNote ratio
LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' brotli
CustomLog "logs/brotli_log" brotli
Si vous souhaitez que l'information enregistrée dans vos journaux soit plus pertinente, vous pouvez renseigner l'argument optionnel type afin de spécifier le type de données à enregistrer dans la note à journaliser. L'argument type accepte les valeurs suivantes :
InputOutputRatiooutput/input *
100). Il s'agit de l'option par défaut si l'argument
type est omis.Vous pouvez alors configurer vos journaux de la manière suivante :
BrotliFilterNote Input instream
BrotliFilterNote Output outstream
BrotliFilterNote Ratio ratio
LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' brotli
CustomLog "logs/brotli_log" brotli
Serveur HTTP Apache Version 2.4
| Description: | Module de stockage sur disque pour le filtre de mise en cache HTTP. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | cache_disk_module |
| Fichier Source: | mod_cache_disk.c |
mod_cache_disk implémente un gestionnaire de
stockage sur disque pour le module mod_cache.
Les en-têtes et corps des réponses mises en cache sont stockés séparément sur le disque, dans une structure de répertoires basée sur le condensé md5 de l'URL mise en cache.
Plusieurs réponses au contenu négocié peuvent être stockées en même temps, mais la mise en cache de contenus partiels n'est pas supportée actuellement par ce module.
Les mises à jour atomiques du cache pour les fichiers d'en-tête et de corps peuvent être effectuées sans verrouillage en enregistrant les numéros d'inode et de périphérique du fichier de corps dans le fichier d'en-tête. Ceci implique que les entrées du cache déplacées manuellement dans le cache seront ignorées.
L'utilitaire htcacheclean permet de lister et
de supprimer les URLs du cache, ou de maintenir le cache en deçà de
certaines limites de taille et/ou de nombre d'inodes. L'utilitaire
peut être exécuté à la demande, ou automatiquement pour assurer un
contrôle continu des tailles des répertoires.
mod_cache doit être chargé avant
mod_cache_disk pour que ce dernier puisse
fonctionner.
Lorsque la plate-forme la supporte, et si elle est activée via la
directive EnableSendfile,
mod_cache_disk utilise la fonctionnalité sendfile
pour servir les fichiers à partir du cache. Cependant,
mod_cache_disk ignore la configuration de la
directive EnableSendfile dans
un contexte de répertoire ou de fichier .htaccess, car le module ne
dispose pas des définitions correspondantes lorsque la requête est
servie depuis le cache.
CacheDirLength CacheDirLevels CacheMaxFileSize CacheMinFileSize CacheReadSize CacheReadTime CacheRoot| Description: | Le nombre de caractères des noms des sous-répertoires |
|---|---|
| Syntaxe: | CacheDirLength longueur |
| Défaut: | CacheDirLength 2 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache_disk |
la directive CacheDirLength permet de
définir le nombre de caractères que comportera chaque nom de
sous-répertoire de la hiérarchie du cache. On peut l'utiliser en
conjonction avec CacheDirLevels pour
déterminer une structure approximative de la hiérarchie de
cache.
Une valeur haute pour CacheDirLength
combinée avec une valeur basse pour
CacheDirLevels générera une hiérarchie
relativement peu profonde, avec un grand nombre de sous-répertoires
à chaque niveau.
La valeur du produit CacheDirLevels *
CacheDirLength ne
doit pas dépasser 20.
| Description: | Le nombre de niveaux de sous-répertoires que comportera le cache. |
|---|---|
| Syntaxe: | CacheDirLevels niveaux |
| Défaut: | CacheDirLevels 2 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache_disk |
La directive CacheDirLevels permet de
définir le nombre de niveaux de sous-répertoires que comportera le
cache. Les données du cache seront stokées au niveau correspondant
par rapport au répertoire CacheRoot.
Une valeur haute pour CacheDirLevels
combinée avec une valeur basse pour
CacheDirLength générera une arborescence
très développée, avec un petit nombre de sous-répertoires à chaque
niveau.
La valeur du produit CacheDirLevels *
CacheDirLength ne
doit pas dépasser 20.
| Description: | >La taille maximale (en octets) d'un document pour pouvoir être stocké dans le cache |
|---|---|
| Syntaxe: | CacheMaxFileSize octets |
| Défaut: | CacheMaxFileSize 1000000 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache_disk |
La directive CacheMaxFileSize permet de
définir la taille maximale d'un document, en octets, pour que
celui-ci puisse faire l'objet d'un stockage dans le cache.
CacheMaxFileSize 64000
| Description: | La taille minimale (en octets) d'un document pour pouvoir être stocké dans le cache |
|---|---|
| Syntaxe: | CacheMinFileSize octets |
| Défaut: | CacheMinFileSize 1 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache_disk |
La directive CacheMinFileSize permet de
définir la taille minimale d'un document, en octets, pour que
celui-ci puisse faire l'objet d'un stockage dans le cache.
CacheMinFileSize 64
| Description: | La quantité minimale (en octets) de données à lire et à mettre en cache avant de les envoyer au client |
|---|---|
| Syntaxe: | CacheReadSize octets |
| Défaut: | CacheReadSize 0 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache_disk |
La directive CacheReadSize permet de
définir la quantité minimale de données, en octets, à lire depuis le
serveur d'arrière-plan avant de les envoyer au client. Avec la
valeur par défaut zéro, toute donnée de toutes tailles est envoyée
au client dès qu'elle est disponible. Avec une valeur non nulle, le
cache disque met en tampon au moins la quantité de données
correspondante avant d'envoyer la réponse au client. Les
performances peuvent s'en trouver améliorées lorsqu'on met en cache
du contenu en provenance d'un mandataire inverse.
Cette directive ne prend effet que lorsque les données sont enregistrées dans le cache, et non lorsque les données sont servies à partir du cache.
CacheReadSize 102400
| Description: | Le temps minimum (en millisecondes) qui doit s'écouler avant d'envoyer les données au client |
|---|---|
| Syntaxe: | CacheReadTime millisecondes |
| Défaut: | CacheReadTime 0 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache_disk |
La directive CacheReadTime permet de
définir le temps minimum qui doit s'écouler avant d'essayer
d'envoyer des données au client. Pendant ce temps, les données sont
mises en tampon avant de pouvoir être envoyées au client. Les
performances peuvent s'en trouver améliorées lorsqu'on met en cache
du contenu en provenance d'un mandataire inverse.
La valeur par défaut zéro désactive cette option.
Cette directive ne prend effet que lorsque les données sont
enregistrées dans le cache, et non lorsque les données sont servies à
partir du cache. Il est recommandé d'harmoniser l'utilisation de cette
directive avec celle de la directive CacheReadSize, afin de s'assurer
que le serveur n'effectue pas une mise en tampon excessive au cas
où les données arriveraient plus vite que prévu.
CacheReadTime 1000
| Description: | La racine du répertoire dans lequel les fichiers du cache seront stockés |
|---|---|
| Syntaxe: | CacheRoot répertoire |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache_disk |
La directive CacheRoot permet de définir
le nom du répertoire sur disque qui contiendra les fichiers du
cache. Si le module mod_cache_disk a été chargé ou
compilé dans le serveur Apache, cette directive doit être
définie. L'absence de définition de la directive
CacheRoot provoquera une erreur de traitement
du fichier de configuration. Les directives CacheDirLevels et CacheDirLength permettent de
définir la structure des sous-répertoires du répertoire racine
spécifié.
CacheRoot c:/cacheroot
Serveur HTTP Apache Version 2.4
| Description: | Exécution des scripts CGI par l'intermédiaire d'un démon CGI externe |
|---|---|
| Statut: | Base |
| Identificateur de Module: | cgid_module |
| Fichier Source: | mod_cgid.c |
| Compatibilité: | Uniquement compatible avec les MPMs Unix threadés |
Exceptées les optimisations et la directive additionnelle
ScriptSock décrite
ci-dessous, mod_cgid a un comportement similaire à
celui de mod_cgi. Voir le résumé de
mod_cgi pour plus de détails à propos d'Apache et
CGI.
Sur certains systèmes d'exploitation de type unix, le lancement
(forking) d'un processus depuis un serveur multi-threadé est une
opération très lourde car le nouveau processus va répliquer tous les
threads du processus parent. Pour éviter cette dépense de ressouces
pour chaque invocation d'un programme CGI, mod_cgid
crée un démon externe qui est responsable du branchement de
processus enfants destinés au lancement de scripts CGI. Le serveur
principal communique avec ce démon par l'intermédiaire d'une socket
de domaine unix.
Si un MPM multi-threadé a été sélectionné lors du processus de
compilation, c'est ce module qui est utilisé par défaut à la place
de mod_cgi. Du point de vue de l'utilisateur, ce
module est identique à mod_cgi quant à sa
configuration et son utilisation. La seule différence est la
directive additionnelle ScriptSock qui permet de
définir le nom du socket à utiliser pour la communication avec le
démon CGI.
| Description: | Durée maximale d'attente de la prochaine sortie du programme CGI |
|---|---|
| Syntaxe: | CGIDScriptTimeout time[s|ms] |
| Défaut: | Si non définie ou définie à 0, valeur de la directive |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Base |
| Module: | mod_cgid |
| Compatibilité: | Disponible à partir de la version 2.4.10 du serveur HTTP Apache ; dans les versions précédentes, aucune durée d'attente n'était définie |
Cette directive permet de limiter la durée d'attente avant les prochaines données reçues en sortie du programme CGI. Si ce temps est dépassé, la requête et le programme CGI se terminent.
CGIDScriptTimeout 20
| Description: | Le préfixe du nom de fichier du socket à utiliser pour communiquer avec le démon CGI |
|---|---|
| Syntaxe: | ScriptSock chemin fichier |
| Défaut: | ScriptSock cgisock |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_cgid |
Cette directive permet de définir le préfixe du nom de fichier de la socket à utiliser pour communiquer avec le démon CGI, préfixe auquel sera ajouté une extension correspondant à l'identifiant processus du serveur. La socket sera ouverte avec les permissions de l'utilisateur qui a démarré Apache (en général root). Afin de préserver la sécurité des communications avec les scripts CGI, il est impératif de n'accorder à aucun autre utilisateur la permission d'écrire dans le répertoire où se trouve la socket.
Si chemin fichier n'est pas un chemin absolu, il est
relatif au chemin défini par la directive DefaultRuntimeDir.
ScriptSock /var/run/cgid.sock
Serveur HTTP Apache Version 2.4
| Description: | Fonctionnalité de création et gestion de versions de documents via le web (WebDAV) |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | dav_module |
| Fichier Source: | mod_dav.c |
Ce module ajoute à Apache une fonctionnalité WebDAV de classes 1 et 2 ('Web-based Distributed Authoring and Versioning' ou Création et gestion de versions de documents via le web). Il s'agit d'une extension du protocole HTTP qui permet de créer, déplacer, copier et supprimer des ressources ou collections de ressources sur un serveur web distant.
Pour activer le module mod_dav, ajoutez la ligne
suivante à un conteneur de votre fichier httpd.conf
:
Dav On
Ceci active le fournisseur de système de fichier DAV implémenté par
le module mod_dav_fs. Ce dernier doit donc être
compilé dans le serveur ou chargé au démarrage à l'aide de la
directive LoadModule.
En outre, vous devez indiquer où se trouve la base de données des
verrous DAV via une directive DavLockDB dans la section globale de
votre fichier httpd.conf :
DavLockDB /usr/local/apache2/var/DavLock
Le répertoire contenant le fichier de la base de données des
verrous doit avoir des droits en écriture pour l'utilisateur et le
groupe sous lesquels Apache s'exécute et définis respectivement par
les directives User et
Group.
Si vous souhaitez limiter l'accès aux répertoires où DAV est
activé, vous pouvez ajouter une clause <Limit> dans la section <Location> considérée. Pour
définir la quantité maximale de données en octets qu'un client
DAV peut envoyer par requête, vous devez utiliser la directive
LimitXMLRequestBody, car La
directive LimitRequestBody
"habituelle" n'a aucune incidence sur les requêtes DAV.
DavLockDB "/usr/local/apache2/var/DavLock"
<Directory "/usr/local/apache2/htdocs/foo">
Require all granted
Dav On
AuthType Basic
AuthName DAV
AuthUserFile "user.passwd"
<LimitExcept GET POST OPTIONS>
Require user admin
</LimitExcept>
</Directory>
Etant donné que les méthodes d'accès DAV permettent à des clients
distants de manipuler des fichiers sur le serveur, vous devez vous
assurer que votre serveur est bien sécurisé avant d'activer
mod_dav.
Tout répertoire du serveur où DAV est activé doit être protégé
par une procédure d'authentification. L'utilisation de
l'authentification HTTP de base n'est pas recommandée. Vous devez
utiliser au moins l'authentification HTTP à base de condensés
qu'implémente le module mod_auth_digest.
Pratiquement tous les clients WebDAV supportent cette méthode
d'authentification. Vous pouvez aussi utiliser l'authentification de
base sur une connexion où SSL est activé.
Pour que mod_dav puisse manipuler des fichiers,
il doit avoir des permissions en écriture sur les répertoires et les
fichiers qui sont sous son contrôle ; en d'autre termes, c'est
l'utilisateur et le groupe sous lesquels Apache s'exécute et définis
par les directives User et
Group qui doivent avoir
les droits en écriture sur ces fichiers et répertoires. Les fichiers
nouvellement créés appartiendront aussi à ces utilisateur et groupe.
Par conséquent, il est important de contrôler l'accès à ce compte.
Les répertoires DAV sont considérés comme privés du point de vue
d'Apache, et la modification des fichiers qu'ils contiennent
autrement que par l'intermédiaire d'Apache (par exemple par FTP ou
par des outils du niveau du système de fichiers) ne doit pas être
permise.
mod_dav peut faire l'objet de plusieurs sortes
d'attaques par déni de service. La directive LimitXMLRequestBody permet de limiter la
quantité de mémoire consommée pour interpréter des requêtes DAV de
grande taille. En outre, la directive DavDepthInfinity permet d'empêcher les
requêtes PROPFIND concernant un répertoire de très
grande taille de consommer de grandes quantités de mémoire. Un autre
type d'attaque par déni de service peut aussi être mené par un
client qui remplit simplement tout l'espace disque disponible avec
des fichiers de très grande taille. Etant donné qu'il n'existe aucun
moyen direct d'éviter ce genre d'attaque dans Apache, vous ne devez
accorder des accès DAV qu'à des utilisateurs de confiance.
Les requêtes ayant pour but de manipuler des fichiers dynamiques
(scripts PHP, scripts CGI, etc...) en utilisant
mod_dav sont courantes. Ce traitement n'est pas
évident car une requête
GET va toujours tenter d'exécuter le script, plutôt que
de télécharger son contenu. Pour éviter cet inconvénient, une
méthode possible consiste à faire correspondre deux URLs
différentes au même contenu, l'une d'entre elles servant à lancer le
script, alors que l'autre peut être utilisée pour le télécharger et
le manipuler avec DAV.
Alias "/phparea" "/home/gstein/php_files" Alias "/php-source" "/home/gstein/php_files" <Location "/php-source"> Dav On ForceType text/plain </Location>
Avec cette configuration, on peut utiliser
http://example.com/phparea pour afficher le résultat de
l'exécution des scripts PHP, et
http://example.com/php-source pour les manipuler avec
DAV.
| Description: | Active les méthodes HTTP WebDAV |
|---|---|
| Syntaxe: | Dav On|Off|nom fournisseur |
| Défaut: | Dav Off |
| Contexte: | répertoire |
| Statut: | Extension |
| Module: | mod_dav |
La directive Dav permet d'activer les
méthodes HTTP WebDAV pour le conteneur condidéré :
<Location "/foo">
Dav On
</Location>
La valeur On est en fait un alias vers le
fournisseur par défaut filesystem implémenté par le
module mod_dav_fs. Notez que lorsque DAV est activé
pour un conteneur, on ne peut pas le désactiver pour ses
sous-conteneurs. Pour un exemple de configuration complet,
reportez-vous à la section précédente.
| Description: | Définir le chemin de la racine du répertoire |
|---|---|
| Syntaxe: | DavBasePath root-path |
| Défaut: | None |
| Contexte: | répertoire |
| Statut: | Extension |
| Module: | mod_dav |
| Compatibilité: | Disponible à partir de la version 2.4.58 du serveur HTTP Apache |
Si le répertoire DAV est défini en utilisant une correspondance
d'expression rationnelle (comme LocationMatch), mod_dav ne sera pas
en mesure de déterminer de lui-même la racine du répertoire à partir du chemin
seul. En conséquence, des fournisseurs tiers (par exemple le module mod_dav_svn
de Subversion) pourront échouer à traiter des requêtes sans disposer de la
valeur correcte de la racine du répertoire.
Pour permettre aux fournisseurs de travailler correctement en présence
d'une telle configuration, vous devez utiliser
DavBasePath.
<LocationMatch "^/repos/">
Dav svn
DavBasePath /repos
SVNParentPath /var/svn
</LocationMatch>
| Description: | Autorise les requêtes PROPFIND avec en-tête Depth: Infinity |
|---|---|
| Syntaxe: | DavDepthInfinity on|off |
| Défaut: | DavDepthInfinity off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_dav |
La directive DavDepthInfinity permet
d'autoriser le traitement des requêtes PROPFIND
contenant l'en-tête Depth: Infinity. Par défaut, ce type de requête
n'est pas autorisé, car il peut favoriser les attaques de type Déni
de service.
| Description: | Durée minimale pendant laquelle le serveur maintient un verrou sur une ressource DAV |
|---|---|
| Syntaxe: | DavMinTimeout secondes |
| Défaut: | DavMinTimeout 0 |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_dav |
Lorsqu'un client demande le verrouillage d'une ressource DAV, il peut aussi spécifier une durée au bout de laquelle le verrou sera automatiquement supprimé par le serveur. Cette valeur ne constitue qu'une demande, et le serveur peut l'ignorer ou informer le client qu'il va utiliser une valeur arbitraire.
La directive DavMinTimeout permet de
spécifier, en secondes, la durée minimale de verrouillage à renvoyer
au client. Les Répertoires Web de Microsoft présentent une durée par
défaut de 120 secondes ; la directive
DavMinTimeout permet de définir une valeur
supérieure (par exemple 600 secondes), afin de réduire les risques
de perte du verrou par le client suite à une surcharge du
réseau.
<Location "/MSWord">
DavMinTimeout 600
</Location>
Apache HTTP Sunucusu Sürüm 2.4
| Açıklama: | Birden fazla Çok Süreçlilik Modülü (MPM) tarafından gerçeklenmiş yönergeler bütünü. |
|---|---|
| Durum: | MPM |
CoreDumpDirectory EnableExceptionHook GracefulShutdownTimeout Listen ListenBackLog ListenCoresBucketsRatio MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers StartThreads ThreadLimit ThreadsPerChild ThreadStackSize| Açıklama: | core dosyasını dökümlemek üzere Apache HTTP
Sunucusunun geçmeye çalışacağı dizin. |
|---|---|
| Sözdizimi: | CoreDumpDirectory dizin |
| Öntanımlı: | Öntanımlı değer için aşağıdaki açıklamaya bakınız |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork |
Bu yönerge core dosyasını dökümlemek üzere Apache httpd’nin
geçmeye çalışacağı dizini belirler. Eğer işletim sisteminiz, çöken bir
sürecin olması durumunda core dosyasını çöken sürecin
çalışma dizinine yazacak şekilde yapılandırılmışsa,
CoreDumpDirectory yönergesinin değeri olarak,
öntanımlı olan ve sunucuyu çalıştıran kullanıcı tarafından yazılamayan
ServerRoot dizini yerine başka bir
çalışma dizini belirtmek gerekir.
Hata ayıklamak amacıyla bir core dosyası dökümlemek
isterseniz farklı bir yer belirtmek için bu yönergeyi
kullanabilirsiniz. Eğer işletim sisteminiz çöken bir sürecin olması
durumunda core dosyasını çöken sürecin çalışma dizinine
yazacak şekilde yapılandırılmamışsa, bu yönergenin bir etkisi olmaz.
Bu yönergenin Linux'ta kullanılması, sistemdeki diğer işlemlerin
(benzer yetkilerle çalıştırılan CGI komut dosyaları gibi)
ptrace sistem çağrısı yoluyla httpd çocuklarına eklenmesine
izin verebilir. Bu, bazı güvenlik saldırılarına karşı korumayı
zayıflatabilir. Bu yönergenin üretim sistemlerinde kullanılması
önerilmez.
core dökümlemekApache httpd root olarak başlatılıp başka bir kullanıcıya geçilirse
Linux çekirdeği, süreç tarafından yazılabilir olsa bile
core dökümlemeyi iptal eder. Eğer
CoreDumpDirectory yönergesi ile açıkça bir
dizin belirtirseniz, Apache httpd (2.0.46 ve sonraki sürümleri), Linux
2.4 ve sonrasında core dökümlemeyi yeniden
etkinleştirecektir.
core dökümlemekBSD sistemlerinde (FreeBSD gibi) suid bitli çalıştırılabilirlerin
core dökümlemesini etkin kılmak için
kern.sugid_coredump değişkenine 1 değerini atayın.
CoreDumpDirectory işlemi sadece belli
sinyaller için gerçekleşir: SIGFPE, SIGILL, SIGABORT, SIGSEGV ve
SIGBUS.
Bazı işletim sistemlerinde SIGQUIT sinyali de bir core
dosyası dökümler ancak bunu CoreDumpDirectory
veya EnableExceptionHook işlemi üzerinden
yapmaz, dolayısıyla core dosyasının yeri tamamen işletim
sisteminin belirlediği yer olur.
| Açıklama: | Bir çöküş sonrası olağandışılık eylemcilerini çalıştıracak kancayı etkin kılar. |
|---|---|
| Sözdizimi: | EnableExceptionHook On|Off |
| Öntanımlı: | EnableExceptionHook Off |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork |
Güvenlik sebebiyle bu yönerge sadece Apache
--enable-exception-hook seçeneği ile yapılandırılmışsa
kullanılabilir olacaktır. Bu, harici modüllerin eklenmesine ve bir çocuk
sürecin çöküşü sonrası bir şeyler yapmaya izin veren bir kancayı etkin
kılar.
Bu kancayı kullanan iki modül (mod_whatkilledus ve
mod_backtrace) zaten vardır. bunlar hakkında daha fazla bilgi
edinmek için Jeff Trawick'in EnableExceptionHook sitesine bakabilirsiniz.
| Açıklama: | Sunucunun nazikçe kapatılmasının ardından ana süreç çıkana kadar geçecek süre için bir zaman aşımı belirler. |
|---|---|
| Sözdizimi: | GracefulShutdownTimeout saniye |
| Öntanımlı: | GracefulShutdownTimeout 0 |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork |
| Uyumluluk: | Sürüm 2.2 ve sonrasında mevcuttur |
GracefulShutdownTimeout yönergesi, sunucuya
"nazikçe dur" sinyali gönderildikten sonra mevcut bağlantılara hizmet
sunmaya daha kaç saniye devam edebileceğini belirtir.
Bu değerin 0 olarak belirtilmesi, sunucunun bekleyen bütün
isteklere hizmet sunumu tamamlanıncaya kadar (gerekirse sonsuza kadar)
bekleyebileceği anlamına gelir.
| Açıklama: | Sunucunun dinleyeceği IP adresini ve portu belirler. |
|---|---|
| Sözdizimi: | Listen [IP-adresi:]port-numarası
[protokol] |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
| Uyumluluk: | protokol değiştirgesi 2.1.5 sürümünde eklenmiştir. |
Listen yönergesi Apache httpd’yi sadece belli IP
adreslerini ve portlarını dinlemeye sevkeder.
Listen artık belirtilmesi zorunlu yönergelerden
biridir. Yapılandırma dosyasında bulunmadığı takdirde sunucu
başlatılırken başarısız olacaktır. Bu Apache HTTP Sunucusunun önceki
sürümünde böyle değildi.
Listen yönergesi Apache httpd’ye, sadece belli
portlardan veya IP adresi ve port çiftlerinden gelen istekleri kabul
etmesini söyler. Eğer sadece port numarası belirtilmişse sunucu
belirtilen portu bütün ağ arabirimlerinde dinleyecektir. Eğer portla
birlikte bir IP adresi de belirtilmişse, sunucu belirtilen portu sadece
belirtilen arabirimden dinleyecektir.
Çok sayıda IP adresi ve port belirtmek için çok sayıda
Listen yönergesi kullanılabilir. Sunucu bu
durumda belirtilen bütün IP adreslerinden ve portlardan gelecek
isteklere yanıt verecektir.
Örneğin sunucunun hem port 80 hem de port 8000’den istek kabul etmesini istiyorsanız bunu şöyle belirtebilirsiniz:
Listen 80 Listen 8000
Sunucunun belirtilen iki ağ arabiriminden ve port numarasından gelen bağlantıları kabul etmesi için şu yapılandırmayı kullanabilirsiniz:
Listen 192.170.2.1:80 Listen 192.170.2.5:8000
IPv6 adresleri belirtilirken örnekteki gibi köşeli ayraçlar arasına alınmalıdır:
Listen [2001:db8::a00:20ff:fea7:ccea]:80
İsteğe bağlı protocol argümanı çoğu yapılandırmada gerekli
değildir. Belirtilmediği takdirde. port 443 için https ve
tüm diğer portlar için http öntanımlıdır. Protokol, isteği
hangi modülün elde edeceğinin ve AcceptFilter yönergesi ile protokole özgü
hangi en iyilemelerin uygulanacağının saptanmasında kullanılır.
Protokol belirtme ihtiyacını sadece standartdışı portlar
çalıştırıyorsanız duyarsınız. Örneğin, port 8443 üzerinde bir
https sitesi çalıştırmak istiyorsanız bunu şöyle
belirtebilirsiniz:
Listen 192.170.2.1:8443 https
Listen
yönergesinde belirtilmesi bir "adres kullanımda" (Address already
in use) hatasına yol açar.
| Açıklama: | Bekleyen bağlantılar kuyruğunun azami uzunluğunu belirler |
|---|---|
| Sözdizimi: | ListenBackLog kuyruk-uzunluğu |
| Öntanımlı: | ListenBackLog 511 |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
Bekleyen bağlantılar kuyruğunun azami uzunluğu. Genellikle bu ayar ne
gerekir ne de istenir. Ancak bazı sistemlerde TCP SYN yüklenme
saldırılarına karşı bu değerin arttırılması gerekebilir.
kuyruk-uzunluğu parametresi için listen(2)
işlevinin açıklamasına bakınız.
Bu değer çoğunlukla işletim sistemi tarafından daha küçük bir sayıyla sınırlanır. Bu, işletim sistemine bağlı olarak değişiklik gösterir. Ayrıca, çoğu işletim sisteminin kuyruk-uzunluğu parametresi ile ne belirttiğinize bakmaksızın kendisi için atanmış değeri (fakat normal olarak daha büyüğünü) kullanacağına dikkat ediniz.
| Açıklama: | İşlemci çekirdek sayısının dinleyenlerin buket sayısına oranı |
|---|---|
| Sözdizimi: | ListenCoresBucketsRatio oran |
| Öntanımlı: | ListenCoresBucketsRatio 0 (iptal) |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork |
| Uyumluluk: | Apache HTTP Server 2.4.17 ve sonrasında,
SO_REUSEPORT soket seçeneğini destekleyen bir Linux çekirdeğinin
varlığında ve yeni bağlantıların bunu kullanan dinleme süreçlerinin (veya
evrelerinin) soketleri arasında eşit paylaştırılıyor olması halinde
kullanılır. Örneğin Linux 3.9 ve sonrasında kullanılabilirken *BSD'lerin şu
anki SO_REUSEPORT gerçeklenimi ile kullanılamaz. |
(çevrimiçi) İşlemci çekirdek sayısının dinleyenlerin buket sayısına
oranı, Apache HTTP Sunucusunun işlemci_çekirdek_sayısı /
oran sayıda dinleme buketi oluşturması için kullanılabilir ve bu
buketlerin herbiri aynı portlar üzerinde kendi Listen soketlerini içeriyor olurlar.
Bu durumda, her çocuk süreç tek bir buketle çalışır (çocukların
oluşturulması sırasında buketler döner dağılımla eşleştirilir).
Linux için (ve ayrıca BSD) bir işlemci çekirdeği Hotplug yapılandırılarak açılıp kapatıalbilir.
Dolayısıyla, ListenCoresBucketsRatio yönergesi
oluşturulacak buket sayısını hesaplarken bu yapılandırmayı esas alır.
ListenCoresBucketsRatio yeni bağlantılar kabul
edilirken/darboğazlar oluşurken ölçeklenebilirliği arttırabilir. Çok
sayıda işlemci çekirdekli sistemlerde bu özelliğin etkinleştirilmesinin
önemli başarım artışları ve daha kısa yanıt süreleri oluşturduğu
gözlenmiştir.
Bu oranın etkin olabilmesi için işlemci çekirdeği çift sayıda
olmalıdır. oran için önerilen değer 8 olup bu
durumda çalışma anında en azından 16 çekirdek
kullanılabiliyor olmalıdır. En iyi başarımı elde etmek gereken
oran her sistem için hesaplanmalı, çok sayıda değer denenmeli
ve başlıca başarım ölçütlerinizin çeşitli sonuçları iyi gözlemlenmelidir.
Bu yönerge aşağı yuvarlanan
MinSpareThreads ve
MaxSpareThreads değerlerinin
hesabını etkiler. Bağlantıları en uygun şekilde kabul etmek için çocuk
süreçlerin sayısının buket sayısının katları olması gerekir.
Listen veya aynı adres veya port
üstünda çok sayıda Apache HTTP sunucusuDinleyen soketler üzerinde SO_REUSEPORT seçeneğini tanımlamak
normal bir durumda sistem tarafından oluşturulmuş bir bağlama hatası
olmaksızın çok sayıda sürecin aynı adres ve porta bağlanması sonucunu
doğurur.
Bu ayrıca pozitif bir ListenCoresBucketsRatio
değeriyle aynı IP:port üzerinde yapılandırılmış çok sayıda
Apache httpd örneğinin hatasız başlamasının yanında gelen çağrıların her
iki örneğe eşit olarak dağıtılacağı anlamına da gelir. (Bu,
herhangi bir durumda bir öneri veya makul bir kullanım DEĞİL, böyle bir
olası sorunun algılanmasının engelleneceğine dair bir uyarıdır.)
Aynı örnek dahilinde, çok sayıda Listen
yönergesinin tam olarak aynı IP ve port üzerinde yapılandırılması durumunda
Apache httpd gerekli sınamaları yaptıktan sonra başlamayacak, böylelikle
birbirinin benzeri çok sayıda kullanışsız buketin oluşturulması
engellenecektir. Ancak, olası tüm örtüşmeler (bir konak adının başka bir
yerde kullanılmış bir IP'ye çözümlenmesi gibi) yakalanamayacaktır.
| Açıklama: | Tek bir çocuk sürecin ömrü boyunca işleme sokabileceği istek sayısını sınırlamakta kullanılır. |
|---|---|
| Sözdizimi: | MaxConnectionsPerChild sayı |
| Öntanımlı: | MaxConnectionsPerChild 0 |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
| Uyumluluk: | Apache HTTP Sunucusunun 2.3.9 ve sonraki sürümlerinde
kullanılabilmektedir. Eski isim MaxRequestsPerChild hala
desteklenmektedir. |
MaxConnectionsPerChild yönergesi, tek bir çocuk
sürecin işleme sokabileceği istek sayısını sınırlamakta kullanılır.
MaxConnectionsPerChild istekten sonra çocuk süreç
ölür. Eğer MaxConnectionsPerChild için
0 belirtilmişse sürecin ömrü sonsuz olacaktır.
MaxConnectionsPerChild için sıfırdan farklı bir
değer belirtilmesi sürecin kullanacağı bellek miktarını sınırlamak
suretiyle olası bellek sızıntılarını engeller.
| Açıklama: | free() çağrılmaksızın ana bellek ayırıcının
ayırmasına izin verilen azami bellek miktarını belirler. |
|---|---|
| Sözdizimi: | MaxMemFree kB-sayısı |
| Öntanımlı: | MaxMemFree 2048 |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork, mpm_winnt, mpm_netware |
MaxMemFree yönergesi, free()
çağrılmaksızın her bellek ayırıcının ayırmasına izin verilen azami
bellek miktarını kB cinsinden belirler. Evreli MPM'lerde her evre kendi
ayırıcısına sahiptir. 0 değeri belirtildiğinde eşik sınırsız
olacaktır.
| Açıklama: | Aynı anda işleme sokulacak azami bağlantı sayısı |
|---|---|
| Sözdizimi: | MaxRequestWorkers sayı |
| Öntanımlı: | Ayrıntılar için aşağıdaki açıklamaya bakınız. |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork |
MaxRequestWorkers yönergesi aynı anda işleme
sokulacak bağlantı sayısını sınırlamak için kullanılır. MaxRequestWorkers bağlantı isteğinden fazlası geldiği
takdirde bu istekler normal olarak kuyruğa alınıp bekletilir. Kuyrukta
bekletilecek isteklerin azami sayısı ise ListenBacklog yönergesi ile belirlenir. İstek sunmakta olan
çocuk süreçlerden biri serbest kaldığında bekletilen bağlantılardan
birine hizmet sunulmaya başlanır.
Evreli olmayan sunucularda (prefork gibi)
MaxRequestWorkers yönergesi istekleri sunmak için
başlatılacak çocuk süreçlerin azami sayısını belirler. Öntanımlı değer
256 olup bu değeri arttırmak isterseniz ServerLimit değerini de
arttırmalısınız.
Çok evreli ve melez sunucularda (event veya
worker gibi) MaxRequestWorkers
yönergesi istemcilere hizmet verecek evre sayısını sınırlar. Öntanımlı
değer melez MPM’ler için 16'dır
(ServerLimit ile ThreadsPerChild çarpılır: 16 x
25). Bu bakımdan MaxRequestWorkers değerini
16 süreçten fazlasına ayarlamak için ServerLimit değerini de arttırmalısınız.
MaxRequestWorkers yerine 2.3.13 öncesinde
MaxClients kullanılırdı. Eski isim hala
desteklenmektedir.
| Açıklama: | Boştaki azami evre sayısını belirler |
|---|---|
| Sözdizimi: | MaxSpareThreads number |
| Öntanımlı: | Ayrıntılar için aşağıdaki açıklamaya bakınız. |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, mpm_netware, mpmt_os2 |
Boştaki azami evre sayısı. Her MPM bu yönerge karşısında farklı davranır.
worker ve event için
MaxSpareThreads 250 öntanımlıdır. Bu MPM'ler boştaki
evreleri sunucu genelinde izler. Eğer sunucuda çok fazla boşta evre
varsa, sunucu boştaki evrelerin sayısı bu sınırın altına inene kadar
çocuk süreçleri öldürür.
ListenCoresBucketsRatio
yönergesi etkinse ek süreçler/evreler oluşabilir.
mpm_netware için MaxSpareThreads 100
öntanımlıdır. Bu MPM tek bir süreç olarak çalıştığından boştaki evre
sayısı aynı zamanda sunucu genelinde boştaki evre sayısıdır.
mpmt_os2 modülü mpm_netware modülü
gibi çalışır. mpmt_os2 için öntanımlı değer
10'dur.
MaxSpareThreads için değer aralığı sınırlıdır.
Apache httpd belirtilen değeri aşağıdaki kurallara uygun olarak
kendiliğinden düzeltecektir:
mpm_netware modülü, değerin MinSpareThreads değerinden küçük
olmasını gerektirir.worker ve event için değer,
MinSpareThreads
ve ThreadsPerChild
toplamına eşit veya büyük olmak zorundadır.| Açıklama: | İsteklerin ani artışında devreye girecek boştaki evrelerin asgari sayısını belirler. |
|---|---|
| Sözdizimi: | MinSpareThreads sayı |
| Öntanımlı: | Ayrıntılar için aşağıdaki açıklamaya bakınız. |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, mpm_netware, mpmt_os2 |
İsteklerin ani artışında devreye girecek boştaki evrelerin asgari sayısı. Her MPM bu yönerge karşısında farklı davranır.
worker ve event modülü için
MinSpareThreads 75 öntanımlıdır ve bu modül boştaki evreleri
sunucu genelinde izler. Eğer sunucuda boştaki evre sayısı yetersizse,
sunucu, boştaki evrelerin sayısı bu sınırın üstüne çıkana kadar çocuk
süreç oluşturur.
ListenCoresBucketsRatio
yönergesi etkinse ek süreçler/evreler oluşabilir.
mpm_netware için MinSpareThreads 10
öntanımlıdır ve tek süreç kendisi olduğundan izleme sunucu genelinde
yapılır.
mpmt_os2 modülü mpm_netware modülü
gibi çalışır. mpmt_os2 için öntanımlı değer
5'tir.
| Açıklama: | Ana sürecin süreç kimliğinin (PID) kaydedileceği dosyayı belirler. |
|---|---|
| Sözdizimi: | PidFile dosya |
| Öntanımlı: | PidFile logs/httpd.pid |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork, mpm_winnt, mpmt_os2 |
PidFile yönergesi, sunucunun artalan sürecinin
süreç kimliğinin kaydedileceği dosyayı belirler. Dosya ismi mutlak dosya
yoluyla belirtilmemişse dosya yolunun ServerRoot dizinine göre belirtildiği kabul
edilir.
PidFile /var/run/apache.pid
Sunucuya sinyal gönderebilmek çoğunlukla işe yarar. Böylece ErrorLog ve TransferLog dosyaları kapatılıp
yeniden açılır ve yapılandırma dosyaları yeniden okunur. Bu,
PidFile dosyasında belirtilen süreç kimliğine bir
SIGHUP (kill -1) sinyali gönderilerek yapılır.
Günlük dosyasının yeri ve güvenlik ile ilgili
uyarılar PidFile dosyası içinde sözkonusu
olabilir.
Apache HTTP Sunucusunu (yeniden) başlatırken veya durdururken sadece
apachectl betiğini kullanmanız önerilir.
| Açıklama: | TCP alım tamponu boyu |
|---|---|
| Sözdizimi: | ReceiveBufferSize bayt-sayısı |
| Öntanımlı: | ReceiveBufferSize 0 |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
Sunucunun TCP alım tamponu boyunu bayt-sayısı ile belirtilen bayta ayarlar.
0 değeri atarsanız sunucu işletim sistemi öntanımlısını
kullanacaktır.
| Açıklama: | Çocuk süreçler için eşgüdüm verisini saklamakta kullanılan dosyanın yerini belirler. |
|---|---|
| Sözdizimi: | ScoreBoardFile dosya-yolu |
| Öntanımlı: | ScoreBoardFile logs/apache_runtime_status |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork, mpm_winnt |
Apache HTTP Sunucusu ana ve çocuk süreçler arasında iletişim için bir çetele tutar. Bazı mimariler bu iletişimi kolaylaştırmak için bir dosya gerektirir. Eğer yönerge belirtilmezse Apache httpd çeteleyi önce tamamen bellekte oluşturmayı dener (anonim paylaşımlı bellek kullanarak); bunda başarılı olamazsa dosyayı diskte oluşturmaya çalışacaktır (paylaşımlı belleğe eşlemli dosya kullanarak). Bu yönergenin belirtilmesi Apache httpd'nin dosyayı daima diskte oluşturmasına sebep olur.
ScoreBoardFile /var/run/apache_status
Paylaşımlı belleğe eşlemli dosya, çeteleye doğrudan erişmesi gereken üçüncü parti uygulamalar için yararlıdır.
Eğer ScoreBoardFile yönergesi ile bir dosya
belirtecekseniz, dosyayı bir RAM diske yerleştirerek hız artışı
sağlayabilirsiniz. Fakat, günlük dosyası yerleştirme ve güvenlik ile ilgili uyarılara
benzer uyarılara karşı dikkatli olunuz.
| Açıklama: | TCP tamponu boyu |
|---|---|
| Sözdizimi: | SendBufferSize bayt-sayısı |
| Öntanımlı: | SendBufferSize 0 |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
Sunucu TCP gönderim tamponu boyunu bayt-sayısı ile belirtilen bayta ayarlayacaktır. Yüksek hızlı yüksek yataklık süreli bağlantılarda işletim sisteminin öntanımlı değerini aşacak şekilde (örn, kıtalararası hızlı hatlarda 100ms veya fazlası) ayarlamak çoğunlukla kullanışlıdır.
0 değeri atarsanız sunucu işletim sistemi öntanımlısını
kullanacaktır.
İşletim sisteminizin ilaveten yapılandırılması, yüksek hız, yüksek gecikme bağlantılarında daha yüksek başarım elde etmek için gerekli olabilir.
Bazı işletim sistemlerinde, TCP davranışı, EnableSendfile yönergesine Off
değeri atanmadıkça görülemeyen, büyükçe bir
SendBufferSize değerinden kaynaklanarak değişir.
Bu etkileşim sadece duruk dosyalarda görülür.
| Açıklama: | Ayarlanabilir süreç sayısının üst sınırını belirler. |
|---|---|
| Sözdizimi: | ServerLimit sayı |
| Öntanımlı: | Ayrıntılar için aşağıdaki açıklamaya bakınız. |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork |
prefork modülü söz konusu olduğunda bu yönerge, Apache
httpd sürecinin ömrü boyunca MaxRequestWorkers yönergesine atanabilecek
azami değeri belirler. worker ve event
modülü sözkonusu
olduğunda ise, Apache httpd sürecinin ömrü boyunca MaxRequestWorkers yönergesine
atanabilecek azami değeri ThreadLimit ile birlikte belirler. event modülü
için bu yönerge kaç eski sunucunun çalışmayı sürdüreceğini ve kaçının açık
bağlantıları işlemeyi bitireceğini belirler. Bu yönergeyi bir yeniden
başlatma sırasında değiştirirseniz bu değişiklik yok sayılır fakat
MaxRequestWorkers
değişiklikleri dikkate alınır.
Bu yönergenin kullanılması özel bir dikkat gerektirir. Eğer
ServerLimit gereğinden yüksek bir değere
ayarlanırsa, gereksiz yere paylaşımlı bellek ayrılmış olur. Eğer
ServerLimit ve MaxRequestWorkers değerleri sistemin
işleyebileceğinden daha yüksek değerlere ayarlanırsa Apache httpd
başlayamayacağı gibi sistemi kararsız hale de getirebilir.
Bu yönergeyi prefork modülü ile sadece MaxRequestWorkers yönergesine 256’dan
(öntanımlı) daha büyük bir değer atayacaksanız kullanınız. Bu yönergeye
MaxRequestWorkers için atamak
istediğiniz değerden fazlasını atamayınız.
worker modülü söz konusu olduğunda bu yönergeyi
MaxRequestWorkers ve
ThreadsPerChild ayarları 16
sunucu sürecinden (16 öntanımlıdır) fazlasını gerektiriyorsa
ayarlayınız. Bu yönergeye MaxRequestWorkers ve ThreadsPerChild için gerekli gördüğünüz sunucu süreci
sayısından fazlasını atamayınız.
event modülü söz konusu olduğunda, MaxRequestWorkers ve ThreadsPerChild yönergeleri ile belirlenen
süreç sayısına ek olarak zarifçe kapatılan süreçlerin sayısıyla arttırıp 16
sunucu sürecinden (16 öntanımlıdır) fazlasına ayarlayınız.
Sunucu içinde derlenmiş olarak ServerLimit 20000
şeklinde bir zorlayıcı sınır vardır (prefork için
200000’dir). Bu önlem, yazım hatalarının istenmeyen sonuçlara yol
açmasını engellemek için düşünülmüştür. Bu sınırı daha da arttırmak
için mpm kaynak dosyasındaki MAX_SERVER_LIMIT değerini değiştirip
sunucuyu yeniden derlemeniz gerekir.
| Açıklama: | Sunucunun başlatılması sırasında oluşturulan çocuk süreçlerin sayısını belirler. |
|---|---|
| Sözdizimi: | StartServers sayı |
| Öntanımlı: | Ayrıntılar için aşağıdaki açıklamaya bakınız. |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, prefork, mpmt_os2 |
StartServers yönergesi, sunucunun başlatılması
sırasında oluşturulan çocuk süreçlerin sayısını belirler. Süreç sayısı
normal olarak yüke bağlı olarak değişse de bu değerin ayarlanmasını
gerektirecek küçük bir sebep vardır.
(MinSpareThreads,
MaxSpareThreads,
MinSpareServers,
MaxSpareServers yönergelerine
bakınız.)
Öntanımlı değer MPM’den MPM’e fark eder. Öntanımlı değer
worker ve event için 3
iken prefork için 5,
mpmt_os2 için 2'dir.
| Açıklama: | Sunucunun başlatılması sırasında oluşturulan evrelerin sayısını belirler. |
|---|---|
| Sözdizimi: | StartThreads sayı |
| Öntanımlı: | Ayrıntılar için aşağıdaki açıklamaya bakınız. |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | mpm_netware |
StartThreads yönergesi, sunucunun başlatılması
sırasında oluşturulan evrelerin sayısını belirler. Evre sayısı normal
olarak yüke bağlı olarak değişse de bu değerin ayarlanmasını
gerektirecek küçük bir sebep vardır.
(MinSpareThreads,
MaxSpareThreads,
MinSpareServers,
MaxSpareServers yönergelerine
bakınız.)
mpm_netware için StartThreads 50
öntanımlı olup, sadece tek bir süreç olduğundan, sunucunun başlatılması
sırasında oluşturulan evrelerin toplam sayısı 50’dir.
| Açıklama: | Çocuk süreç başına ayarlanabilir evre sayısının üst sınırını belirler. |
|---|---|
| Sözdizimi: | ThreadLimit sayı |
| Öntanımlı: | Ayrıntılar için aşağıdaki açıklamaya bakınız. |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, mpm_winnt |
Bu yönerge, Apache httpd sürecinin ömrü boyunca ThreadsPerChild yönergesine
atanabilecek azami değeri belirler. Bu yönergeyi bir yeniden başlatma
sırasında değiştirirseniz bu değişiklik yok sayılır fakat ThreadsPerChild değişiklikleri dikkate
alınır.
Bu yönergenin kullanılması özel bir dikkat gerektirir. Eğer
ThreadLimit değeri ThreadsPerChild değerinden yüksek bir
değere ayarlanırsa, gereksiz yere paylaşımlı bellek ayrılmış olur. Eğer
ThreadLimit ve ThreadsPerChild değerleri sistemin
işleyebileceğinden daha yüksek değerlere ayarlanırsa Apache httpd
başlayamayacağı gibi sistemi kararsız hale de getirebilir. Bu yönergeye
Apache httpd'nin çalışması için öngörülmüş en büyük değerden daha
yükseğini atamayınız.
ThreadLimit yönergesinin öntanımlı değeri
mpm_winnt için 1920, diğerleri için
64’tür.
Sunucu içinde derlenmiş olarak ThreadLimit 20000
şeklinde bir zorlayıcı sınır vardır (mpm_winnt için
15000, event için ThreadLimit 100000).
Bu önlem, yazım hatalarının istenmeyen sonuçlara yol
açmasını engellemek için düşünülmüştür. Bu sınırı daha da arttırmak
için mpm kaynak dosyasındaki MAX_SERVER_LIMIT değerini değiştirip
sunucuyu yeniden derlemeniz gerekir.
| Açıklama: | Her çocuk süreç tarafından oluşturulan evrelerin sayısını belirler. |
|---|---|
| Sözdizimi: | ThreadsPerChild sayı |
| Öntanımlı: | Ayrıntılar için aşağıdaki açıklamaya bakınız. |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, mpm_winnt |
Bu yönerge, her çocuk süreç tarafından oluşturulan evrelerin sayısını
belirler. Çocuk süreçler bu evreleri başlatıldıklarında oluştururlar ve
bundan daha fazlasını asla oluşturmazlar. mpm_winnt
gibi sadece bir çocuk sürecin bulunduğu bir MPM kullanıyorsanız, bu
sayı Apache httpd'nin tüm yükünü kaldırabilecek kadar büyük olmalıdır.
worker gibi çok çocuk süreçli bir MPM kullanıyorsanız,
toplam evre sayısı Apache httpd'nin tüm yükünü kaldırabilecek
kadar büyük olmalıdır.
ThreadsPerChild için öntanımlı değer
mpm_winnt kullanıldığında 64 diğerleri
için 25’tir.
ThreadsPerChild değeri ThreadLimit değerini aşamaz. Eğer daha
yüksek bir değer verilirse sunucu başlatılırken düşürülür ve günlüğe bir
uyarı kaydedilir. Bu iki yönerge arasındaki ilişki ThreadLimit belgelsinde açıklanmıştır.
| Açıklama: | İstemci bağlantılarını elde eden evreler tarafından kullanılan yığıtın bayt cinsinden uzunluğunu belirler. |
|---|---|
| Sözdizimi: | ThreadStackSize boyut |
| Öntanımlı: | NetWare üzerinde 65536; diğer işletim sistemlerinde
değişir. |
| Bağlam: | sunucu geneli |
| Durum: | MPM |
| Modül: | event, worker, mpm_winnt, mpm_netware, mpmt_os2 |
| Uyumluluk: | Apache HTTP Sunucusu 2.1 ve sonrasında kullanılabilir. |
ThreadStackSize yönergesi, istemci
bağlantılarını elde eden evreler ve bu bağlantıları işlemekte yardımcı
olan modül çağrıları tarafından kullanılan yığıtın bayt cinsinden
uzunluğunu belirler. Çoğu durumda işletim sistemi yığıtı uygun bir
boyuta ayarlar, fakat yine de ayarlanmasını gerektirecek bazı durumlar
olabilir:
ThreadStackSize yönergesine daha büyük yığıt
boyu atanarak çözümlenir. Böyle bir ayarlamayı sadece üçüncü parti
modülün üreticisi bunun gerekliliğini belirtmişse veya Apache httpd’nin
evre yığıt boyutunun küçüklüğünden dolayı çöktüğü teşhis edildiği
takdirde yapınız.ThreadStackSize yönergesi ile bu boyuttan daha
düşük bir değer atanmışsa çocuk süreç başına evre sayısının yüksek
olduğu durumlarda bu yığıt yetmeyebilir. Böyle bir ayarlama sadece
sunucunun öldüresiye denendiği dolayısıyla yığıt boyutlarının aşırı
zorlandığı deneme ortamlarında yapılmalıdır. Gereken en küçük yığıt
boyutu kullanılan modüle sıkı sıkıya bağlıdır, fakat Apache httpd
yapılandırmasında yapılan bir değişiklik mevcut
ThreadStackSize ayarını geçersiz hale
getirebilir.ulimit -s için
(çoğunlukla büyükçe) soft sınır (sınırsızsa 8MB), öntanımlı yığıt
boyutu olarak kullanılır.ThreadStackSize değerinin azaltılmaması önerilir.
Bazı platformlarda (Linux dahil), 128000 ayarı zaten çok düşüktür ve daha
da azaltmak bazı modüllerle çökmeye sebep olur.Serveur HTTP Apache Version 2.4
Ce document décrit les termes utilisés pour décrire chaque directive de configuration d'Apache.
Une brève description des fonctions de cette directive.
Ce terme introduit le format sous lequel la directive doit apparaître dans le fichier de configuration. Cette syntaxe est très spécifique à la directive et est décrite en détail dans la définition de cette dernière. En général, le nom de la directive est suivi d'un ou plusieurs arguments séparés par des espaces. Si un argument contient un espace, il doit être entouré de guillemets. Les arguments optionnels sont entourés de crochets. Lorsqu'un argument accepte une valeur parmi une liste de valeurs possibles, cette liste est spécifiée en séparant les valeurs par une barre verticale "|". Les textes littéraux sont présentés dans la fonte par défaut, alors que les types d'argument pour lesquels une substitution est nécessaire sont en gras. La syntaxe des directives acceptant un nombre variable d'arguments se termine par "...", ce qui indique que le dernier argument peut être répété.
Les directives utilisent un grand nombre de types d'arguments différents. Les plus courants sont définis ci-dessous.
http://www.example.com/chemin/vers/fichier.html/chemin/vers/fichier.html. Le
chemin-URL représente la ressource vue du web, et est
différente de la représentation de cette même ressource vue du
système de fichiers./usr/local/apache/htdocs/chemin/vers/fichier.html.
Sauf mention contraire, un chemin-fichier qui ne commence
pas par un slash sera considéré comme relatif au répertoire défini
par la directive ServerRoot./usr/local/apache/htdocs/chemin/vers/.fichier.html.fichier.html.en comporte deux extensions :
.html et .en. Pour les directives
Apache, vous pouvez spécifier les extensions avec ou sans
le point initial. Enfin, les extensions ne sont pas
sensibles à la casse.text/html.Si la directive possède une valeur par défaut (en d'autres termes, si le serveur Web Apache se comporte comme si vous l'aviez définie à une valeur particulière, alors que vous l'avez omise dans votre configuration), elle est spécifiée ici. Si la directive ne possède pas de valeur par défaut, cette section doit spécifier "Aucune". Notez que la valeur par défaut dont il est question n'est pas nécessairement la même que la valeur attribuée à la directive dans le fichier httpd.conf par défaut distribué avec le serveur.
Indique les parties des fichiers de configuration du serveur où cette directive est valide. Il s'agit d'une liste d'une ou plusieurs des valeurs suivantes séparées par des virgules :
httpd.conf),
mais pas à l'intérieur d'un conteneur <VirtualHost> ou <Directory>. De même, elle
n'est pas valide dans les fichiers .htaccess.<VirtualHost> dans les fichiers de
configuration du serveur.<Directory>, <Location>, <Files>, <If>, et <Proxy> dans les
fichiers de configuration du serveur, en tenant compte des
restrictions précisées dans la documentation sur les Sections de configuration..htaccess. Elle sera ou
ne sera pas traitée, selon la définition de l'option overrides pour le contexte courant.La directive n'est autorisée que dans le contexte désigné ; si vous essayez de l'utiliser ailleurs, vous générerez une erreur de configuration qui va soit empêcher le serveur de traiter les requêtes correctement dans ce contexte, soit tout simplement empêcher le serveur de fonctionner -- en d'autres termes, le serveur refusera de démarrer.
Les lieux de définition valides pour une directive résultent en
fait d'un
OU logique de tous les contextes spécifiés. En d'autres termes, une
directive spécifiée comme valide dans "configuration globale,
.htaccess" peut être utilisée dans le fichier
httpd.conf et dans les fichiers .htaccess,
mais pas dans un conteneur <Directory> ou <VirtualHost>.
Ce terme indique quelle autorisation de surcharge ("override") doit être
active pour que la directive puisse être traitée lorsqu'elle
apparaît dans un fichier .htaccess. Si le context de la directive ne lui permet pas
d'apparaître dans un fichier .htaccess, aucun contexte
ne sera spécifié.
Les autorisations de surcharge sont activées via la directive
AllowOverride, et possèdent une
portée particulière, comme un répertoire et tous ses
sous-répertoires, sauf si une autre directive AllowOverride apparaît à un niveau
inférieur. La documentation pour cette directive spécifie aussi les
noms d'autorisations de surcharge disponibles.
Cet attribut indique le degré de rapprochement de la directive du coeur d'Apache ; en d'autres termes, vous pouvez être amené à recompiler le serveur avec un jeu de modules supplémentaires pour pouvoir utiliser la directive, et ainsi accéder à ses fonctionnalités. Les valeurs possible pour cet attribut sont :
Il s'agit d'une simple liste des noms des modules sources qui fournissent la directive.
Si la directive ne faisait pas partie de la distribution originale d'Apache version 2, la version dans laquelle elle a été introduite est indiquée ici. Cette section indique aussi si la directive n'est disponible que sur certaines plates-formes.
Serveur HTTP Apache Version 2.4
| Description: | Autorisations de groupe à base de nom d'hôte (nom ou adresse IP) |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | access_compat_module |
| Fichier Source: | mod_access_compat.c |
| Compatibilité: | Disponible dans la version 2.3 du serveur HTTP Apache
à des fins de compatibilité
avec les précédentes versions d'Apache httpd 2.x. Les directives fournies par
ce module sont devenues obsolètes depuis la refonte d'authz. Voir
mod_authz_host |
Les directives fournies par le module
mod_access_compat s'utilisent dans les sections
<Directory>,
<Files> et
<Location>, ainsi
que dans les fichiers .htaccess et permettent
de contrôler l'accès à certaines parties du serveur. On peut
contrôler cet accès en fonction du nom d'hôte du client, de son
adresse IP ou d'autres caractéristiques de la requête, telles
qu'elles sont enregistrées dans les variables
d'environnement. Les directives Allow et Deny permettent de spécifier
quels clients sont ou ne sont pas autorisés à accéder au serveur,
alors que la directive Order définit le statut
d'accès par défaut, et détermine la manière dont les directives
Allow et
Deny interagissent
entre elles.
Les restrictions d'accès à base de nom d'hôte et
l'authentification à base de mot de passe peuvent être implémentées
simultanément. Dans ce cas, on utilise la directive Satisfy pour déterminer la
manière dont ces deux modes de restrictions interagissent.
Les directives fournies par le module
mod_access_compat sont devenues obsolètes depuis
la refonte du module mod_authz_host. Mélanger d'anciennes
directives comme Order, Allow ou Deny avec des nouvelles comme
Require est techniquement
possible mais déconseillé. En effet, mod_access_compat a
été conçu pour supporter des configurations ne contenant que des anciennes
directives afin de faciliter le passage à la version 2.4. Voir le document
upgrading pour plus de détails.
En général, les directives de restriction d'accès s'appliquent à
toutes les méthodes d'accès (GET, PUT,
POST, etc...). C'est d'ailleurs ce que l'on souhaite
dans la plupart des cas. Il est cependant possible de restreindre
certaines méthodes, alors que les autres méthodes ne se verront
imposée aucune restriction, en regroupant les directives à
l'intérieur d'une section <Limit>.
Lorsqu'une directive fournie par ce module est utilisée dans une nouvelle section de configuration, cette dernière n'hérite d'aucune directive définie dans une section précédente.
| Description: | Spécifie quels hôtes peuvent accéder à une certaine zone du serveur |
|---|---|
| Syntaxe: | Allow from all|hôte|env=[!]variable
d'environnement
[hôte|env=[!]variable d'environnement] ... |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | Limit |
| Statut: | Extension |
| Module: | mod_access_compat |
La directive Allow permet de définir quels
hôtes ont le droit d'accéder à une certaine partie du serveur. On
peut contrôler l'accès par nom d'hôte, adresse IP, intervalle
d'adresses IP, ou toute autre caractéristique de la requête client
enregistrée dans les variables d'environnement.
Le premier argument de cette directive est toujours
from. Les arguments suivants peuvent prendre trois
formes différentes. Si Allow from all est spécifié,
tout hôte se voit accordé l'accès, en tenant compte des directives
Deny et Order comme décrit plus loin.
Pour ne permettre l'accès au serveur qu'à un hôte ou un groupe
d'hôtes particuliers, on peut spécifier un nom d'hôte sous
une des formes suivantes :
Allow from example.org Allow from .net example.edu
Les hôtes dont les noms correspondent ou se terminent par la
chaîne spécifiée ont l'autorisation d'accès. Seules les
composantes entières du nom d'hôte doivent correspondre ; ainsi,
dans l'exemple ci-dessus, foo.example.org
correspondra, mais fooexample.org ne conviendra pas.
Avec cette configuration, Apache httpd va effectuer une double recherche
DNS sur l'adresse IP du client, sans tenir compte de la
définition de la directive HostnameLookups. Tout d'abord, une
recherche DNS inverse sur l'adresse IP est effectuée pour
déterminer le nom d'hôte associé, puis une recherche directe sur
le nom d'hôte est effectuée afin de s'assurer qu'il correspond
bien à l'adresse IP originale. L'accès ne sera accordé que si le
nom d'hôte correspond et si les recherches DNS inverse et directe
concordent.
Allow from 10.1.2.3 Allow from 192.168.1.104 192.168.1.205
L'adresse IP d'un hôte auquel on a accordé l'accès
Allow from 10.1 Allow from 10 172.20 192.168.2
De un à trois des premiers octets d'une adresse IP, afin de restreindre l'accès à un sous-réseau.
Allow from 10.1.0.0/255.255.0.0
Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z, pour une définition plus précise de la restriction d'accès imposée à un sous-réseau.
Allow from 10.1.0.0/16
Identique au cas précédent, mis à part que le masque est constitué des nnn bits de poids fort.
Notez que les trois derniers exemples désignent le même ensemble d'hôtes.
On peut spécifier des adresses et sous-réseaux IPv6 de la manière suivante :
Allow from 2001:db8::a00:20ff:fea7:ccea Allow from 2001:db8::a00:20ff:fea7:ccea/10
Le troisième format d'argument de la directive
Allow permet de contrôler l'accès au serveur
en fonction de l'existence d'une variable d'environnement. Lorsque Allow
from env=variable d'environnement est spécifié, la
requête est autorisée si la variable d'environnement variable
d'environnement existe. En revanche, lorsque Allow from
env=!env-variable est spécifié, la
requête est autorisée si la variable d'environnement variable
d'environnement n'existe pas. Le serveur permet de définir
avec souplesse des variables d'environnement en se basant sur les
caractéristiques de la requête client et en utilisant les directives
fournies par le module mod_setenvif. Ainsi, on peut
utiliser la directive Allow pour permettre
l'accès en fonction de paramètres comme le User-Agent
(type de navigateur) des clients, le Referer, ou
d'autres champs d'en-tête de la requête HTTP.
SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in
<Directory "/docroot">
Order Deny,Allow
Deny from all
Allow from env=let_me_in
</Directory>
Dans cet exemple, les navigateurs dont la chaîne user-agent
commence par KnockKnock/2.0 se verront accorder
l'accès, alors que tous les autres seront rejetés.
Lorsqu'une directive fournie par ce module est utilisée dans une nouvelle section de configuration, cette dernière n'hérite d'aucune directive définie dans une section précédente.
| Description: | Définit quels hôtes ne sont pas autorisés à accéder au serveur |
|---|---|
| Syntaxe: | Deny from all|hôte|env=[!]variable
d'environnement
[hôte|env=[!]variable d'environnement] ... |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | Limit |
| Statut: | Extension |
| Module: | mod_access_compat |
Cette directive permet de restreindre l'accès au serveur en
fonction du nom d'hôte, de l'adresse IP ou de variables
d'environnement. Les arguments de la directive
Deny sont identiques aux arguments de la
directive Allow.
| Description: | Définit le statut d'accès par défaut et l'ordre dans lequel
les directives Allow et
Deny sont évaluées. |
|---|---|
| Syntaxe: | Order ordre |
| Défaut: | Order Deny,Allow |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | Limit |
| Statut: | Extension |
| Module: | mod_access_compat |
La directive Order, associée aux
directives Allow
et Deny,
implémente un système de contrôle d'accès en trois passes. Au cours
de la première passe, ce sont soit toutes les directives Allow, soit toutes les
directives Deny qui sont traitées, selon
la définition de la directive Order. Le reste des
directives (Deny
ou Allow) est
traité au cours de la seconde passe. La troisième passe s'applique à
toutes les requêtes qui ne sont concernées par aucune des deux
premières passes.
Notez que toutes les directives Allow et Deny sont traitées, à la
différence d'un pare-feu classique où seule la première règle qui
correspond est utilisée. La dernière directive qui correspond
s'applique ( à la différence là encore d'un pare-feu classique). De
plus, l'ordre dans lequel les lignes apparaissent dans le fichier de
configuration n'a pas d'incidence -- toutes les lignes Allow sont considérées comme
un groupe, toutes les lignes Deny comme un autre, et le
statut par défaut a son existence propre.
Ordre peut être :
Allow,DenyAllow sont évaluées ; au
moins une d'entre elles doit correspondre, sinon la requête est
rejetée. Ensuite, toutes les directives Deny sont évaluées. Si au
moins l'une d'entre elles correspond, la requête est rejetée.
Enfin, toute requête qui ne correspond à aucune directive
Allow ou
Deny est rejetée
par défaut.Deny,AllowDeny sont évaluées ; Si au
moins une d'entre elles correspond, la requête est rejetée,
à moins qu'elle corresponde aussi à une directive
Allow. Toute
requête qui ne correspond à aucune directive Allow ou Deny est autorisée.Mutual-failureAllow,Deny et
est devenu de ce fait obsolète.Les mots-clés ne peuvent être séparés que par des virgules ; aucun espace ne doit s'intercaler entre eux.
| Match | Résultat Allow,Deny | Résultat Deny,Allow |
|---|---|---|
| Correspond à Allow seulement | Requête autorisée | Requête autorisée |
| Correspond à Deny seulement | Requête rejetée | Requête rejetée |
| Aucune correspondance | Par défaut la seconde directive : rejet | Par défaut la seconde directive : autorisation |
| Correspond à Allow & Deny | La dernière correspondance l'emporte : rejet | La dernière correspondance l'emporte : autorisation |
Dans cet exemple, tous les hôtes du domaine example.org ont l'autorisation d'accès ; tous les autres voient leur accès refusé.
Order Deny,Allow Deny from all Allow from example.org
Dans l'exemple suivant, tous les hôtes du domaine example.org ont
l'autorisation d'accès, sauf ceux du sous-domaine foo.example.org qui
voient leur accès refusé. Tous les hôtes qui ne sont pas dans le
domaine example.org sont rejetés car le statut par défaut est positionné
sur Deny, et consiste donc en un
refus d'accès.
Order Allow,Deny Allow from example.org Deny from foo.example.org
Par contre, si la valeur de la directive
Order, dans l'exemple précédent, est
Deny,Allow, tout le monde a l'autorisation d'accès.
Ceci est dû au fait que Allow from example.org sera
évalué en dernier, sans tenir compte de l'ordre réel dans lequel les
directives apparaissent dans le fichier de configuration, et va
l'emporter sur Deny from foo.example.org. Tout hôte qui
n'est pas dans le domaine example.org aura aussi
l'autorisation d'accès car le statut par défaut est positionné sur
Allow et constitue donc une
autorisation d'accès.
La présence d'une directive Order peut
affecter le contrôle d'accès à une partie du serveur même en
l'abscence de directives Allow et Deny associées, à cause de
son influence sur le statut par défaut. Par exemple,
<Directory "/www">
Order Allow,Deny
</Directory>
va interdire tout accès au répertoire /www à cause
du statut d'accès par défaut qui est défini à Deny.
La directive Order ne contrôle l'ordre
dans lequel sont traitées les directives d'accès qu'au cours de
chaque phase du traitement de la configuration du serveur. Ceci
implique, par exemple, qu'une directive Allow ou Deny située dans une section
<Location> sera
toujours évaluée après une directive Allow ou Deny située dans une section
<Directory> ou un
fichier .htaccess, sans tenir compte de la
définition de la directive Order. Pour plus
de détails à propos de la fusion des sections de configuration, voir
le document Comment fonctionnent les sections Directory,
Location et Files.
Lorsqu'une directive fournie par ce module est utilisée dans une nouvelle section de configuration, cette dernière n'hérite d'aucune directive définie dans une section précédente.
| Description: | Interaction entre le contrôle d'accès en fonction de l'hôte et l'authentification utilisateur |
|---|---|
| Syntaxe: | Satisfy Any|All |
| Défaut: | Satisfy All |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_access_compat |
| Compatibilité: | Affecté par <Limit> et <LimitExcept> à partir de la version
2.0.51 |
Politique d'accès dans le cas où on utilise à la fois Allow et Require. L'argument est soit
All, soit Any. L'utilisation de cette
directive n'a de sens que si l'accès à une zone particulière du
serveur est restreinte par utilisateur/mot de passe et en fonction
de l'adresse IP de l'hôte client. Dans ce cas, par
défaut (All), le client doit satisfaire à la
restriction d'adresse, et fournir un couple
utilisateur/mot de passe valide. Avec l'argument Any,
le client se verra accorder l'accès s'il satisfait à la restriction
d'adresse ou fournit un couple utilisateur/mot de passe valide. On
peut utiliser cette dernière définition pour restreindre l'accès à
une zone par mot de passe, mais accorder l'accès aux clients
possédant certaines adresses IP sans qu'ils aient à fournir de mot
de passe.
Par exemple, si vous souhaitez que les utilisateurs de votre réseau accèdent à une zone de votre site web sans restriction, mais que l'accès à cette zone nécessite un mot de passe pour les autres utilisateurs, vous pouvez utiliser une configuration du style :
Require valid-user Allow from 192.168.1 Satisfy Any
Une autre utilisation fréquente de la directive
Satisfy est l'allègement des restrictions
d'accès à un sous-répertoire par rapport aux restrictions d'accès au
répertoire parent :
<Directory "/var/www/private">
Require valid-user
</Directory>
<Directory "/var/www/private/public">
Allow from all
Satisfy Any
</Directory>
Dans l'exemple ci-dessus, l'accès au répertoire
/var/www/private nécessitera une authentification,
alors que l'accès au répertoire /var/www/private/public
sera accordé sans restriction.
Depuis la version 2.0.51, les directives
Satisfy peuvent être restreintes à certaines
méthodes particulières à l'aide des sections <Limit> et <LimitExcept>.
Lorsqu'une directive fournie par ce module est utilisée dans une nouvelle section de configuration, cette dernière n'hérite d'aucune directive définie dans une section précédente.
Serveur HTTP Apache Version 2.4
| Description: | Ce module permet de restreindre aisément les méthodes HTTP pouvant être utilisées sur le serveur |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | allowmethods_module |
| Fichier Source: | mod_allowmethods.c |
| Compatibilité: | Disponible à partir de la version 2.3 du serveur HTTP Apache |
Ce module permet de restreindre aisément les méthodes HTTP pouvant être utilisées sur le serveur. La configuration la plus courante est du style :
<Location "/"> AllowMethods GET POST OPTIONS </Location>
| Description: | Restreint l'accès aux méthodes HTTP spécifiées |
|---|---|
| Syntaxe: | AllowMethods reset|HTTP-method
[HTTP-method]... |
| Défaut: | AllowMethods reset |
| Contexte: | répertoire |
| Statut: | Expérimental |
| Module: | mod_allowmethods |
Les noms des méthodes HTTP sont sensibles à la casse, et sont en
général définis en majuscules, comme dans les RFCs. Les méthodes GET et
HEAD sont considérées comme équivalentes. Le mot-clé
reset permet de désactiver
mod_allowmethods dans les niveaux inférieurs
d'imbrication :
<Location "/svn"> AllowMethods reset </Location>
La méthode TRACE ne peut pas être rejetée par ce module ; pour ce
faire, vous devez utiliser la directive TraceEnable.
Le module mod_allowmethods a été écrit pour
remplacer l'implémentation "bricolée" des directives Limit et LimitExcept.
Serveur HTTP Apache Version 2.4
| Description: | Authentification utilisateur utilisant les condensés MD5 |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | auth_digest_module |
| Fichier Source: | mod_auth_digest.c |
Ce module implémente l'authentification HTTP basée sur les
condensés MD5 (RFC2617), et
fournit une alternative à mod_auth_basic en
ne transmettant plus le mot de passe en clair. Cependant, cela ne
suffit pas pour améliorer la sécurité de manière significative par
rapport à l'authentification basique. En outre, le stockage du mot
de passe sur le serveur est encore moins sûr dans le cas
d'une authentification à base de condensé que dans le cas d'une
authentification basique. C'est pourquoi l'utilisation de
l'authentification basique associée à un chiffrement de la connexion
via mod_ssl constitue une bien meilleure
alternative.
AuthDigestAlgorithm AuthDigestDomain AuthDigestNonceLifetime AuthDigestProvider AuthDigestQop AuthDigestShmemSizePour utiliser l'authentification à base de condensés MD5, vous
devez simplement remplacer AuthType Basic et AuthBasicProvider respectivement
par AuthType Digest et AuthDigestProvider lorsque vous
configurez l'authentification, puis ajouter une directive AuthDigestDomain contenant au
moins la(les) URI(s) racine(s) de la zone à protéger.
On peut créer les fichiers utilisateur appropriés (au format
texte) à l'aide de l'outil htdigest.
<Location "/private/">
AuthType Digest
AuthName "private area"
AuthDigestDomain "/private/" "http://mirror.my.dom/private2/"
AuthDigestProvider file
AuthUserFile "/web/auth/.digest_pw"
Require valid-user
</Location>
L'authentification à base de condensé a été conçue pour améliorer
la sécurité par rapport à l'authentification basique, mais il
s'avère que ce but n'a pas été atteint. Un attaquant de type
"man-in-the-middle" peut facilement forcer le navigateur à revenir à
une authentification basique. Même une oreille indiscrète passive
peut retrouver le mot de passe par force brute avec les moyens
modernes, car l'algorithme de hashage utilisé par l'authentification
à base de condensé est trop rapide. Autre problème, le stockage des
mots de passe sur le serveur n'est pas sûr. Le contenu d'un fichier
htdigest volé peut être utilisé directement pour l'authentification
à base de condensé. Il est donc fortement recommandé d'utiliser
mod_ssl pour chiffrer la connexion.
mod_auth_digest ne fonctionne correctement que
sur les plates-formes où APR supporte la mémoire partagée.
| Description: | Sélectionne l'algorithme utilisé pour calculer les condensés du défit et de sa réponse |
|---|---|
| Syntaxe: | AuthDigestAlgorithm MD5|MD5-sess |
| Défaut: | AuthDigestAlgorithm MD5 |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_auth_digest |
La directive AuthDigestAlgorithm permet de
sélectionner l'algorithme utilisé pour calculer les condensés du
défit et de sa réponse.
MD5-sess n'est pas encore correctement implémenté.
| Description: | Les URIs qui se trouvent dans le même espace de protection concernant l'authentification à base de condensés |
|---|---|
| Syntaxe: | AuthDigestDomain URI [URI] ... |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_auth_digest |
La directive AuthDigestDomain vous permet
de spécifier un ou plusieurs URIs se trouvant dans le même
espace de protection (c'est à dire utilisant le même utilisateur/mot
de passe et se trouvant dans le même domaine). Les URIs spécifiés
sont des préfixes ; le client doit savoir que tous les URIs situés
sous ces préfixes seront protégés par le même utilisateur/mot de
passe. Les URIs peuvent être soit des URIs absolus (c'est à dire
avec protocole, nom serveur, port, etc...), soit des URIs
relatifs.
Cette directive doit toujours être présente et contenir au moins le(s) URI(s) racine(s) pour cet espace. Dans le cas contraire, le client va envoyer un en-tête d'autorisation avec chaque requête à destination de ce serveur.
Les URIs spécifiés peuvent aussi référencer différents serveurs, auquel cas les clients (qui sont à même de le comprendre) vont partager l'utilisateur/mot de passe entre plusieurs serveurs sans le demander à l'utilisateur à chaque fois.
| Description: | Durée de validité du nombre à valeur unique du serveur (nonce) |
|---|---|
| Syntaxe: | AuthDigestNonceLifetime secondes |
| Défaut: | AuthDigestNonceLifetime 300 |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_auth_digest |
La directive AuthDigestNonceLifetime
permet de contrôler la durée de validité du nombre à valeur unique
du serveur (nonce). Lorsque le client contacte le serveur en
utilisant un nonce dont la validité a expiré, le serveur renvoie un
code d'erreur 401 avec stale=true. Si
secondes est supérieur à 0, il spécifie la durée de
validité du nonce ; il est en général déconseillé d'affecter à cet
argument une valeur inférieure à 10 secondes. Si
secondes est inférieur à 0, le nonce n'expire jamais.
| Description: | Définit le(s) fournisseurs(s) d'authentification pour la zone du site web concernée |
|---|---|
| Syntaxe: | AuthDigestProvider nom fournisseur
[nom fournisseur] ... |
| Défaut: | AuthDigestProvider file |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_auth_digest |
La directive AuthDigestProvider permet de
définir quel fournisseur d'authentification sera utilisé pour
authentifier les utilisateurs pour la zone du site web concernée.
Assurez-vous que le module implémentant le fournisseur
d'authentification choisi soit bien présent dans le serveur. Le
fournisseur par défaut file est implémenté par le
module mod_authn_file.
Voir mod_authn_dbm,
mod_authn_file, mod_authn_dbd et
mod_authn_socache
pour la liste des fournisseurs disponibles.
| Description: | Détermine le niveau de protection fourni par l'authentification à base de condensé |
|---|---|
| Syntaxe: | AuthDigestQop none|auth|auth-int [auth|auth-int] |
| Défaut: | AuthDigestQop auth |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_auth_digest |
La directive AuthDigestQop permet de
définir le niveau de protection fourni. auth
ne fournit que l'authentification (nom utilisateur/mot de passe) ;
auth-int fournit l'authentification plus un contrôle
d'intégrité (un condensé MD5 de l'entité est aussi calculé et
vérifié) ; avec none, le module va utiliser l'ancien
algorithme de condensés RFC-2069 (qui n'effectue pas de contrôle
d'intégrité). On peut spécifier à la fois auth et
auth-int, auquel cas c'est le navigateur qui va choisir
lequel des deux utiliser. none ne doit être utilisé que
dans le cas où le navigateur ne serait pas à même (pour une raison
ou pour une autre) de relever le défit qu'il recevrait si un autre
niveau de protection était défini.
auth-int n'est pas encore implémenté.
| Description: | La quantité de mémoire partagée à allouer afin de conserver les informations à propos des clients |
|---|---|
| Syntaxe: | AuthDigestShmemSize taille |
| Défaut: | AuthDigestShmemSize 1000 |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_auth_digest |
La directive AuthDigestShmemSize permet de
définir la quantité de mémoire partagée à allouer au démarrage du
serveur afin de conserver les informations à propos des clients.
Notez que le segment de mémoire partagée ne peut pas être défini à
une taille inférieure à l'espace nécessaire pour conserver les
informations à propos d'un client. Cette valeur dépend de
votre système. Si vous voulez en déterminer la valeur exacte, vous
pouvez simplement définir AuthDigestShmemSize
à 0 et consulter le message d'erreur que renverra le
serveur lorsqu'on essaiera de le démarrer.
L'argument size s'exprime par défaut en octets, mais
vous pouvez suffixer le nombre par un K ou un
M pour spécifier respectivement des KiloOctets ou des
MégaOctets. Par exemple, les directives qui suivent sont toutes
équivalentes :
AuthDigestShmemSize 1048576 AuthDigestShmemSize 1024K AuthDigestShmemSize 1M
Serveur HTTP Apache Version 2.4
| Description: | Le noyau de l'authentification |
|---|---|
| Statut: | Base |
| Identificateur de Module: | authn_core_module |
| Fichier Source: | mod_authn_core.c |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache |
Ce module fournit le coeur des fonctionnalités d'authentification
permettant d'accorder ou de refuser l'accès à certaines zones du
site web. Les directives fournies par le module
mod_authn_core sont communes à tous les
fournisseurs d'authentification.
Il est possible de créer des fournisseurs d'authentification
étendus dans le fichier de configuration et de leur assigner un
alias. Le fournisseur ainsi nommé peut alors être référencé à l'aide
des directives AuthBasicProvider ou AuthDigestProvider tout comme
un fournisseur d'authentification de base. Outre la possibilité de
créer et attribuer un alias à un fournisseur étendu, le même
fournisseur d'authentification peut aussi être référencé par
plusieurs sections relatives à une zone du site web.
Cet exemple vérifie les mots de passe dans deux fichiers textes différents.
# Première vérification
<AuthnProviderAlias file file1>
AuthUserFile "/www/conf/passwords1"
</AuthnProviderAlias>
# Vérification suivante
<AuthnProviderAlias file file2>
AuthUserFile "/www/conf/passwords2"
</AuthnProviderAlias>
<Directory "/var/web/pages/secure">
AuthBasicProvider file1 file2
AuthType Basic
AuthName "Protected Area"
Require valid-user
</Directory>
Dans l'exemple ci-dessous, deux fournisseurs d'authentification ldap sont créés à partir du fournisseur ldap de base, et se voient attribuer un alias. L'authentification d'une même zone peut alors être traitée par plusieurs serveurs ldap :
<AuthnProviderAlias ldap ldap-alias1>
AuthLDAPBindDN cn=youruser,o=ctx
AuthLDAPBindPassword yourpassword
AuthLDAPURL ldap://ldap.host/o=ctx
</AuthnProviderAlias>
<AuthnProviderAlias ldap ldap-other-alias>
AuthLDAPBindDN cn=yourotheruser,o=dev
AuthLDAPBindPassword yourotherpassword
AuthLDAPURL ldap://other.ldap.host/o=dev?cn
</AuthnProviderAlias>
Alias "/secure" "/webpages/secure"
<Directory "/webpages/secure">
AuthBasicProvider ldap-other-alias ldap-alias1
AuthType Basic
AuthName LDAP_Protected Place
Require valid-user
# Notez que Require ldap-* ne fonctionnerait pas ici, car
# AuthnProviderAlias ne fournit pas de configuration pour les
# fournisseurs d'autorisation implémentés dans le même module que le
# fournisseur d'authentification.
</Directory>
| Description: | L'identifiant de l'autorisation à utiliser avec l'authentification HTTP |
|---|---|
| Syntaxe: | AuthName domaine d'autorisation |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_authn_core |
Cette directive permet de définir l'identifiant d'autorisation
pour un répertoire. Cet identifiant est fourni au client de façon à
ce qu'il sache quels nom d'utilisateur et mot de passe envoyer.
AuthName accepte un seul argument ; s'il
contient des espaces, il doit être entouré de guillemets. Pour
pouvoir fonctionner, la directive AuthName
doit être utilisée en combinaison avec les directives AuthType et Require, ainsi que des
directives comme AuthUserFile et AuthGroupFile.
Par exemple :
AuthName "Top Secret"
La chaîne fournie comme argument à AuthName
apparaîtra dans la boîte de dialogue d'authentification pour la
plupart des navigateurs.
A partir de la version 2.4.55 du serveur HTTP Apache, il est possible de définir cette directive en utilisant la syntaxe des expressions pour spécifier l'identifiant d'autorisation de manière dynamique.
Exemple :
AuthName "%{HTTP_HOST}"
| Description: | Regroupe un ensemble de directives qui constituent une extension d'un fournisseur d'authentification de base et lui attribue l'alias spécifié |
|---|---|
| Syntaxe: | <AuthnProviderAlias alias-fournisseur>
... </AuthnProviderAlias> |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_authn_core |
Les balises <AuthnProviderAlias> et
</AuthnProviderAlias> permettent de regrouper un
ensemble de directives d'authentification qui seront référencées par
l'alias spécifié à l'aide des directives AuthBasicProvider ou AuthDigestProvider.
| Description: | Type d'authentification utilisateur |
|---|---|
| Syntaxe: | AuthType None|Basic|Digest|Form |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_authn_core |
Cette directive permet de définir le type d'authentification
utilisateur pour un répertoire. Les types d'authentification
disponibles sont None, Basic (implémenté
par mod_auth_basic), Digest
(implémenté par mod_auth_digest), et
Form (implémenté par
mod_auth_form).
Pour mettre en oeuvre l'authentification, vous devez aussi
utiliser les directives AuthName et Require. De plus, le serveur
doit pouvoir disposer d'un module fournisseur d'authentification
comme mod_authn_file et d'un module d'autorisation
comme mod_authz_user.
Le type d'authentification None désactive
l'authentification. Lorsqu'une authentification est définie, elle
est en général héritée par chacune des sections de configuration qui
suivent, à moins qu'un autre type d'authentification ne soit
spécifié. Si l'on ne souhaite pas mettre en oeuvre
d'authentification pour une sous-section d'une section authentifiée,
on doit utiliser le type d'authentification None ; dans
l'exemple suivant, les clients peuvent accéder au répertoire
/www/docs/public sans devoir s'authentifier :
<Directory "/www/docs">
AuthType Basic
AuthName Documents
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
Require valid-user
</Directory>
<Directory "/www/docs/public">
AuthType None
Require all granted
</Directory>
A partir de la version 2.4.55, il est possible de définir cette directive en utilisant la syntaxe des expressions pour spécifier le type d'authentification de manière dynamique.
Serveur HTTP Apache Version 2.4
| Description: | Authentification utilisateur à l'aide de fichiers texte |
|---|---|
| Statut: | Base |
| Identificateur de Module: | authn_file_module |
| Fichier Source: | mod_authn_file.c |
| Compatibilité: | Disponible depuis les versions 2.1 et supérieures d'Apache |
Ce module permet aux frontaux d'authentification comme
mod_auth_digest et mod_auth_basic
d'authentifier les utilisateurs en les recherchant dans des fichiers
de mots de passe au format texte. mod_authn_dbm
fournit une fonctionnalité similaire.
Lorsqu'on utilise mod_auth_basic ou
mod_auth_digest, ce module peut être invoqué en
affectant la valeur file à la directive AuthBasicProvider ou AuthDigestProvider.
| Description: | Définit le nom d'un fichier texte pour l'authentification contenant la liste des utilisateurs et de leurs mots de passe |
|---|---|
| Syntaxe: | AuthUserFile chemin-fichier |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Base |
| Module: | mod_authn_file |
La directive AuthUserFile permet de
définir le nom d'un fichier texte pour l'authentification contenant
la liste des utilisateurs et de leurs mots de passe.
chemin-fichier est le chemin vers le fichier
des utilisateurs. S'il n'est pas absolu, il est considéré comme
relatif au répertoire défini par la directive ServerRoot.
Chaque ligne du fichier des utilisateurs se compose du nom de
l'utilisateur, du caractère ':' et du mot de passe chiffré. Si le
même identifiant utilisateur est référencé plusieurs fois,
mod_authn_file utilisera la première occurrence pour
vérifier le mot de passe.
Le format du mot de passe chiffré dépend du frontal
d'authentification utilisé (par exemple
mod_auth_basic ou
mod_auth_digest). Voir la documentation sur les
Formats de mots de
passe pour plus de détails.
Pour mod_auth_basic, utilisez le programme
htpasswd fourni avec la distribution binaire,
mais que vous trouverez aussi dans le répertoire
src/support de l'arborescence des sources. Voir sa page de manuel pour plus de
détails. En bref :
On crée un fichier de mots de passe nom-fichier avec
nom-utilisateur comme identifiant initial. Le mot de
passe correspondant sera alors demandé :
htpasswd -c nom-fichier nom-utilisateur
Pour ajouter ou modifier nom-utilisateur2 dans le
fichier de mots de passe nom-fichier :
htpasswd nom-fichier nom-utilisateur2
Noter qu'une recherche dans de grands fichiers texte peut être
très longue ; dans ce cas, il vaut mieux utiliser les fichiers DBM
avec la directive AuthDBMUserFile.
Pour mod_auth_digest, vous devez utiliser
le programme htdigest.
Notez que vous ne pouvez pas mélanger des données utilisateur pour
l'Authentification HTTP à base de condensé et des données pour
l'Authentification de Base dans le même fichier.
Assurez-vous que le fichier AuthUserFile
soit bien stocké en dehors de l'arborescence des documents du
serveur web. Ne placez pas ce fichier dans le
répertoire qu'il protège. Dans le cas contraire, les clients
seraient en mesure de télécharger le fichier des mots de passe.
Serveur HTTP Apache Version 2.4
| Description: | Exécution des scripts CGI |
|---|---|
| Statut: | Base |
| Identificateur de Module: | cgi_module |
| Fichier Source: | mod_cgi.c |
Tout fichier pris en compte par le gestionnaire
cgi-script sera traité en tant que script CGI et
exécuté par le serveur, sa sortie étant renvoyée au client. Les
fichiers sont associés à ce gestionnaire soit parce qu'ils possèdent
un nom contenant une extension définie par la directive AddHandler, soit parce qu'ils se
situent dans un répertoire défini par une directive ScriptAlias.
Comme introduction à l'utilisation des scripts CGI avec Apache, voir notre tutoriel Les contenus dynamiques avec CGI.
Il est recommandé d'utiliser le module mod_cgid
à la place de mod_cgi lorsqu'on utilise un module MPM
multi-threadé sous Unix. Vus de l'utilisateur, les deux modules
sont pratiquement identiques.
À des fins de compatibilité ascendante, le gestionnaire
cgi-script sera aussi activé pour tout fichier possédant le type
MIME application/x-httpd-cgi. L'utilisation du type
MIME magic est obsolète.
Le serveur va définir les variables d'environnement CGI comme décrit dans la Spécification CGI, de la manière suivante :
AcceptPathInfo est
explicitement définie à off. Par défaut, si la
directive AcceptPathInfo n'est pas définie,
mod_cgi acceptera des informations de chemin (en
ajoutant /infos/chemin après le nom du script dans l'URI), alors
que le serveur de base retournera une erreur 404 NOT FOUND pour
les requêtes contenant des informations de chemin supplémentaires.
Ne pas définir la directive AcceptPathInfo
a le même effet sur les requêtes avec mod_cgi que
de la définir à On.HostnameLookups est définie à
on (elle est à off par défaut), et si
une recherche DNS inverse sur l'adresse IP de l'hôte client
aboutit effectivement à un nom d'hôte.IdentityCheck
est définie à on, et si l'hôte client supporte le
protocole ident. Notez que l'on ne peut accorder une confiance
aveugle au contenu de cette variable car il peut être aisément
falsifié, et si un mandataire s'intercale entre le client et le
serveur, il est totalement inutilisable.Ce module utilise aussi les fonctions de base ap_add_common_vars et ap_add_cgi_vars pour ajouter des variables d'environnement comme :
DocumentRoot.ServerAdmin.Pour une liste exhaustive de ces variables, vous pouvez écrire un script CGI basique qui extrait toutes les variables d'environnement passées par Apache selon un format adapté.
Le débogage des scripts CGI était difficile par le passé, principalement parce qu'il n'était pas possible d'étudier la sortie (sortie standard et erreurs) des scripts dont l'exécution échouait. Les directives qui suivent permettent une journalisation plus détaillée des erreurs.
Lorsqu'il est configuré, le journal des erreurs CGI enregistre la sortie de tout programme CGI dont l'exécution ne s'effectue pas correctement. Un script CGI dont l'exécution échoue provoque la journalisation d'une grande quantité d'informations. Les deux premières lignes possèdent toujours le format suivant :
%% [date] requête
%% état HTTP nom du script CGI
Si le script CGI n'a pas pu démarrer, le fichier journal contiendra les deux lignes supplémentaires suivantes :
%%erreur
message d'erreur
Par contre, si l'erreur provient du renvoi par le script d'informations incorrectes dans les en-têtes (dû souvent à une bogue du script), les informations suivantes sont journalisées :
%requête
Tous les en-têtes de requête HTTP reçus
Les entités POST ou PUT (s'il en existe)
%réponse
Tous les en-têtes générés par le script CGI
%stdout
la sortie standard CGI
%stderr
la sortie d'erreurs standard CGI
(Les parties %stdout et %stderr seront absentes si le script n'a rien envoyé sur la sortie standard ou la sortie d'erreurs).
| Description: | Le temps d'attente maximum pour une sortie du programme CGI |
|---|---|
| Syntaxe: | CGIScriptTimeout time[s|ms] |
| Défaut: | La valeur par défaut de la directive |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Base |
| Module: | mod_cgi |
| Compatibilité: | Disponible à partir de la version 2.4.59 du serveur HTTP Apache. |
Cette directive permet de limiter le temps d'attente jusqu'à une prochaine sortie du programme CGI. Si ce temps est dépassé, le traitement de la requête et l'exécution du programme CGI sont terminés.
CGIScriptTimeout 20
| Description: | Chemin du fichier journal des erreurs du script CGI |
|---|---|
| Syntaxe: | ScriptLog chemin fichier |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_cgi, mod_cgid |
La directive ScriptLog permet de définir
le chemin du fichier journal des erreurs du script CGI. Si cette
directive n'est pas définie, aucune journalisation des erreurs n'est
effectuée. Si elle est définie, toute erreur CGI sera enregistrée
dans le fichier dont le nom est fourni en argument. S'il s'agit d'un
chemin de fichier relatif, il est considéré par rapport au
répertoire défini par la directive ServerRoot.
ScriptLog logs/cgi_log
Ce journal sera ouvert par l'utilisateur sous lequel les
processus enfants s'exécutent, c'est à dire l'utilisateur spécifié
par la directive du serveur User. Ceci implique que le
répertoire dans lequel se trouve le journal doit être accessible en
écriture pour cet utilisateur, ou bien que le fichier est créé
manuellement et accessible en écriture pour cet utilisateur. Si vous
placez le journal du script dans votre répertoire principal des
journaux, ne modifiez JAMAIS les permissions de ce
dernier afin de le le rendre accessible en écriture par
l'utilisateur sous lequel les processus enfants s'exécutent.
Notez que l'on ne doit activer la journalisation des scripts qu'à des fins de débogage lors de l'écriture de scripts CGI, et non de manière permanente sur un serveur en production. Elle n'est pas optimisée en terme de performances et d'efficacité, et peut présenter des problèmes de sécurité si on l'utilise dans un cadre autre que celui pour lequel elle a été conçue.
| Description: | Taille maximale des requêtes PUT ou POST qui seront enregistrées dans le journal du script |
|---|---|
| Syntaxe: | ScriptLogBuffer octets |
| Défaut: | ScriptLogBuffer 1024 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_cgi, mod_cgid |
Cette directive permet de limiter la taille du corps de toute entité PUT ou POST qui sera enregistrée dans le journal, afin de prévenir une croissance trop importante et trop rapide du fichier journal due à la réception de corps de requête de grandes tailles. Cette directive permet de modifier cette taille maximale, dont la valeur par défaut est de 1024 octets.
| Description: | Taille maximale du fichier journal des scripts CGI |
|---|---|
| Syntaxe: | ScriptLogLength octets |
| Défaut: | ScriptLogLength 10385760 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_cgi, mod_cgid |
La directive ScriptLogLength permet de
définir la taille maximale du fichier journal des scripts CGI. Comme
le fichier journal accumule une grande quantité d'informations par
erreur CGI (tous les en-têtes de la requête, toutes les sorties du
script), il peut vite atteindre une grande taille. En limitant la
taille du fichier, cette directive permet d'éviter les problèmes que
causerait sa croissance sans limites. Lorsque le fichier a atteint
cette taille maximale, plus aucune information n'y est
enregistrée.
Serveur HTTP Apache Version 2.4
| Description: | Convertit un corps de réponse en URL de type données RFC2397 |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | data_module |
| Fichier Source: | mod_data.c |
| Compatibilité: | Disponible depuis la version 2.3 du serveur HTTP Apache |
Ce module permet de convertir une réponse en URL de type données RFC2397.
Les URLs de type données peuvent être incluses en ligne dans les
pages web via le module mod_include par exemple,
afin d'éviter aux clients d'avoir à effectuer des connexions
séparées pour éventuellement extraire un grand nombre de petites
images. Les URLs de type données peuvent aussi être incluses dans
des pages générées par langages de scripting tels que PHP.
data:image/gif;base64,R0lGODdhMAAwAPAAAAAAAP///ywAAAAAMAAw
AAAC8IyPqcvt3wCcDkiLc7C0qwyGHhSWpjQu5yqmCYsapyuvUUlvONmOZtfzgFz
ByTB10QgxOR0TqBQejhRNzOfkVJ+5YiUqrXF5Y5lKh/DeuNcP5yLWGsEbtLiOSp
a/TPg7JpJHxyendzWTBfX0cxOnKPjgBzi4diinWGdkF8kjdfnycQZXZeYGejmJl
ZeGl9i2icVqaNVailT6F5iJ90m6mvuTS4OK05M0vDk0Q4XUtwvKOzrcd3iq9uis
F81M1OIcR7lEewwcLp7tuNNkM3uNna3F2JQFo97Vriy/Xl4/f1cf5VWzXyym7PH
hhx4dbgYKAAA7
Le filtre n'accepte aucun paramètre, et peut être ajouté à la
pile des filtres via la directive SetOutputFilter, ou toute autre directive
supportée par le module mod_filter.
<Location "/data/images">
SetOutputFilter DATA
</Location>
Ce module ne fournit aucune directive.
Serveur HTTP Apache Version 2.4
| Description: | Module de verrouillage générique pour
mod_dav |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | dav_lock_module |
| Fichier Source: | mod_dav_lock.c |
| Compatibilité: | Disponible depuis la version 2.1 d'Apache |
ce module implémente une API de verrouillage générique que tout
fournisseur support de mod_dav peut utiliser. Son
activation nécessite l'utilisation de mod_dav. Mais
sans fournisseur support pour l'utiliser, il n'est d'aucun service
et ne doit pas être chargé dans le serveur. mod_dav_svn, le module qui
implémente le fournisseur subversion, est un exemple
de module de support qui utilise effectivement
mod_dav_lock.
Notez que mod_dav_fs n'a pas besoin de
ce module de verrouillage générique, car il utilise sa propre
version plus spécifique.
Pour que mod_dav_lock puisse fonctionner, il
vous suffit de spécifier le chemin de la base de données des verrous
à l'aide de la directive DavGenericLockDB décrite
ci-dessous.
Pour déterminer le pointeur de la fonction du fournisseur de
verrouillage, vous devez utiliser l'API
ap_lookup_provider avec les arguments
dav-lock, generic et 0.
| Description: | Chemin de la base de données des verrous DAV |
|---|---|
| Syntaxe: | DavGenericLockDB chemin fichier |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_dav_lock |
La directive DavLockDB permet de spécifier
le chemin complet de la base de données des verrous, sans extension.
Si le chemin n'est pas absolu, il sera considéré comme relatif au
répertoire défini par la directive ServerRoot. L'implémentation de
mod_dav_lock utilise une base de données SDBM pour
surveiller les verrous utilisateurs.
DavGenericLockDB var/DavLock
Les utilisateur et groupe sous lesquels Apache s'exécute et qui
sont respectivement définis par les directives User et Group doivent pouvoir écrire dans le
répertoire qui contient le fichier de la base de données des
verrous. Pour des raisons de sécurité, il est recommandé de créer un
répertoire dédié à la base de données des verrous, plutôt que de
modifier les permissions d'un répertoire existant. Dans l'exemple
ci-dessus, Apache va créer des fichiers dans le répertoire
var/, lui-même sous-répertoire du répertoire défini par
la directive ServerRoot, avec le nom de base
DavLock suivi d'une extension choisie par le
serveur.
Serveur HTTP Apache Version 2.4
| Description: | Envoie le contenu statique avec une bande passante limitée définie par les différents standards des anciens modems. |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | dialup_module |
| Fichier Source: | mod_dialup.c |
Il s'agit d'un module qui envoie le contenu statique avec une bande passante limitée définie par les différents standards des anciens modems. Ainsi, il est possible de naviguer sur votre site avec un modem 56k V.92 en positionnant une configuration de ce type :
<Location "/mysite">
ModemStandard "V.92"
</Location>
Auparavant, pour faire des modules de limitation de bande passante, il fallait monopoliser un thread, pour chaque client, et insérer des temporisations pour diminuer la bande passante. Grâce à cette nouvelle fonctionnalité, un gestionnaire peut recevoir les réponses à ses callbacks après N millisecondes, et il sera invoqué par le module MPM Event dans un thread différent à la fin du délai indiqué. À partir de ce moment, le gestionnaire peut continuer à envoyer des données au client.
| Description: | Standard de modem à simuler |
|---|---|
| Syntaxe: | ModemStandard V.21|V.26bis|V.32|V.34|V.92 |
| Contexte: | répertoire |
| Statut: | Expérimental |
| Module: | mod_dialup |
Cette directive permet de spécifier le standard de modem que vous souhaitez simuler.
<Location "/mysite">
ModemStandard "V.26bis"
</Location>
Serveur HTTP Apache Version 2.4
| Description: | Permet d'utiliser un annuaire LDAP pour l'authentification HTTP de base. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | authnz_ldap_module |
| Fichier Source: | mod_authnz_ldap.c |
| Compatibilité: | Disponible depuis les versions 2.1 et supérieures d'Apache |
Ce module permet aux frontaux d'authentification comme
mod_auth_basic d'authentifier les utilisateurs via
un annuaire ldap.
mod_authnz_ldap supporte les fonctionnalités
suivantes :
Lorsqu'on utilise mod_auth_basic, ce module est
invoqué en affectant la valeur ldap à la directive
AuthBasicProvider.
Sommaire Mises en garde à caractère général Mode opératoire Les directives requises Exemples Utilisation de TLS Utilisation de SSL Mise à disposition des informations de
connexion Utilisation d'Active
Directory Utilisation de Microsoft
FrontPage avec mod_authnz_ldap AuthLDAPAuthorizePrefix AuthLDAPBindAuthoritative AuthLDAPBindDN AuthLDAPBindPassword AuthLDAPCharsetConfig AuthLDAPCompareAsUser AuthLDAPCompareDNOnServer AuthLDAPDereferenceAliases AuthLDAPGroupAttribute AuthLDAPGroupAttributeIsDN AuthLDAPInitialBindAsUser AuthLDAPInitialBindPattern AuthLDAPMaxSubGroupDepth AuthLDAPRemoteUserAttribute AuthLDAPRemoteUserIsDN AuthLDAPSearchAsUser AuthLDAPSubGroupAttribute AuthLDAPSubGroupClass AuthLDAPURLCe module effectue une mise en cache des résultats du processus
d'authentification et d'autorisation en fonction de la configuration du
module mod_ldap. Les modifications effectuées au niveau
du serveur LDAP d'arrière-plan comme les
verrouillages ou révocations d'utilisateurs, les changements de mot de
passe, ou les changements d'appartenance à un groupe (et cette liste
n'est pas exhaustive), ne seront pas immédiatement propagées jusqu'au
serveur HTTP. Consultez les directives du module
mod_ldap pour plus de détails à propos de la
configuration de la mise en cache.
L'utilisateur se voit accorder l'accès selon un processus en deux
phases. La première phase est l'authentification, au cours de
laquelle le fournisseur d'authentification
mod_authnz_ldap vérifie que les informations de
connexion de l'utilisateur sont valides. Elle est aussi connue sous
le nom de phase de recherche/connexion (NdT : en anglais ou
dans le code source : search/bind). La deuxième
phase est l'autorisation, au cours de laquelle
mod_authnz_ldap détermine si l'utilisateur
authentifié a la permission d'accéder à la ressource considérée.
Elle est aussi connue sous le nom de phase de
comparaison (compare).
mod_authnz_ldap comporte un fournisseur
d'authentification authn_ldap et un gestionnaire d'autorisation
authz_ldap. Le fournisseur d'authentification authn_ldap peut être
invoqué en affectant la valeur ldap à la directive
AuthBasicProvider. Le
gestionnaire d'autorisation authz_ldap enrichit la liste des types
d'autorisations de la directive Require en y ajoutant les
valeurs ldap-user, ldap-dn et
ldap-group.
Au cours de la phase d'authentification,
mod_authnz_ldap recherche une entrée de l'annuaire
LDAP qui correspond au nom d'utilisateur fourni par le client HTTP.
Si une correspondance unique est trouvée,
mod_authnz_ldap tente de se connecter au serveur
hébergeant l'annuaire LDAP en utilisant le DN de l'entrée et le mot
de passe fourni par le client HTTP. Comme ce processus effectue tout
d'abord une recherche, puis une connexion, il est aussi connu sous
le nom de phase de recherche/connexion. Voici le détail des étapes
constituant la phase de recherche/connexion :
AuthLDAPURL avec le nom d'utilisateur et le mot de
passe fournis par le client HTTP.Les directives utilisées durant la phase de recherche/connexion sont les suivantes :
AuthLDAPURL |
Spécifie le serveur LDAP, le DN de base, l'attribut à utiliser pour la recherche, ainsi que les filtres de recherche supplémentaires. |
AuthLDAPBindDN |
Un DN optionnel pour se connecter durant la phase de recherche. |
AuthLDAPBindPassword |
Un mot de passe optionnel pour se connecter durant la phase de recherche. |
Au cours de la phase d'autorisation,
mod_authnz_ldap tente de déterminer si
l'utilisateur est autorisé à accéder à la ressource considérée. Une
grande partie de cette vérification consiste pour
mod_authnz_ldap en des opérations de comparaison au
niveau du serveur LDAP. C'est pourquoi cette phase est aussi connue
sous le nom de phase de comparaison.
mod_authnz_ldap accepte les directives Require suivantes pour
déterminer si les informations de connexion permettent d'accorder
l'accès à l'utilisateur :
Require ldap-user,
l'autorisation d'accès est accordée si le nom d'utilisateur
spécifié par la directive correspond au nom d'utilisateur fourni
par le client.Require
ldap-dn, l'autorisation d'accès est accordée si le DN
spécifié par la directive correspond au DN extrait du résultat de
la recherche dans l'annuaire LDAP.Require ldap-group,
l'autorisation d'accès est accordée si le DN extrait du résultat de
la recherche dans l'annuaire LDAP (ou le nom d'utilisateur fourni
par le client) appartient au groupe LDAP spécifié par la
directive, ou éventuellement à un de ses sous-groupes.Require ldap-attribute, l'autorisation d'accès
est accordée si la valeur de l'attribut extraite de la recherche
dans l'annuaire LDAP correspond à la valeur spécifiée par la
directive.Require ldap-filter, l'autorisation d'accès
est accordée si le filtre de recherche renvoie un objet
utilisateur unique qui corresponde au DN de l'utilisateur
authentifié.Require
ldap-search, l'autorisation d'accès
est accordée si le filtre de recherche renvoie avec succès un objet
correspondant unique avec n’importe quel DN.Sous réserve du chargement de modules d'autorisation
supplémentaires, d'autres valeurs de la directive Require peuvent être
spécifiées.
Require
valid-user est présente (nécessite le module
mod_authz_user).Require group, l'autorisation
d'accès est accordée si le module
mod_authz_groupfile a été chargé et si la
directive AuthGroupFile a été
définie.Durant la phase de comparaison, mod_authnz_ldap
utilise les directives suivantes :
AuthLDAPURL
|
On utilise l'attribut spécifié dans l'URL pour les
opérations de comparaison initiées par la directive
Require ldap-user. |
AuthLDAPCompareDNOnServer |
Détermine le comportement de la directive Require
ldap-dn. |
AuthLDAPGroupAttribute |
Détermine l'attribut utilisé pour les opérations de
comparaison initiées par la directive Require
ldap-group. |
AuthLDAPGroupAttributeIsDN |
Spécifie si l'on doit utiliser le DN ou le nom de
l'utilisateur lors des opérations de comparaison initiées par la
directive Require ldap-group. |
AuthLDAPMaxSubGroupDepth |
Détermine la profondeur maximale de l'arborescence des
sous-groupes qui seront évalués au cours des opérations de
comparaisons initiées par la directive Require
ldap-group. |
AuthLDAPSubGroupAttribute |
Détermine l'attribut à utiliser lors de l'extraction de
membres de sous-groupes du groupe courant au cours des
opérations de comparaison initiées par la directive
Require ldap-group. |
AuthLDAPSubGroupClass |
Spécifie les valeurs de classe d'objet LDAP à utiliser pour
déterminer si les objets extraits de l'annuaire sont bien des
objets de type groupe (et non des objets de type utilisateur),
au cours du traitement des sous-groupes initié par la directive
Require ldap-group. |
Les directives Require d'Apache sont utilisées
au cours de la phase d'autorisation afin de s'assurer que
l'utilisateur est autorisé à accéder à une ressource.
mod_authnz_ldap enrichit la liste des types d'autorisations avec les
valeurs ldap-user, ldap-dn,
ldap-group, ldap-attribute et
ldap-filter. D'autres types d'autorisations sont
disponibles, sous réserve du chargement de modules d'autorisation
supplémentaires.
Depuis la version 2.4.8, les directives require LDAP supportent les expressions.
La directive Require ldap-user permet de spécifier
les noms des utilisateurs autorisés à accéder à la ressource.
Lorsque mod_authnz_ldap a extrait un DN unique de
l'annuaire LDAP, il effectue une opération de comparaison LDAP en
utilisant le nom d'utilisateur spécifié par la directive
Require ldap-user, pour vérifier si ce nom
d'utilisateur correspond à l'entrée LDAP extraite. On peut accorder
l'accès à plusieurs utilisateurs en plaçant plusieurs nom
d'utilisateurs sur la même ligne séparés par des espaces. Si un nom
d'utilisateur contient des espaces, il doit être entouré de
guillemets. On peut aussi accorder l'accès à plusieurs utilisateurs
en utilisant une directive Require ldap-user par
utilisateur. Par exemple, avec la directive AuthLDAPURL définie à
ldap://ldap/o=Example?cn (spécifiant donc que l'attribut
cn sera utilisé pour les recherches), on pourra
utiliser les directives Require suivantes pour restreindre l'accès
:
Require ldap-user "Barbara Jenson" Require ldap-user "Fred User" Require ldap-user "Joe Manager"
De par la manière dont mod_authnz_ldap traite
cette directive, Barbara Jenson peut s'authentifier comme
Barbara Jenson, Babs Jenson ou tout autre
cn sous lequel elle est enregistrée dans l'annuaire
LDAP. Une seule ligne Require ldap-user suffit pour
toutes les valeurs de l'attribut dans l'entrée LDAP de
l'utilisateur.
Si l'attribut uid avait été spécifié à la place de
l'attribut cn dans l'URL précédente, les trois lignes
ci-dessus auraient pû être condensées en une seule ligne :
Require ldap-user bjenson fuser jmanager
Cette directive permet de spécifier un groupe LDAP dont les membres auront l'autorisation d'accès. Elle prend comme argument le DN du groupe LDAP. Note : n'entourez pas le nom du groupe avec des guillemets. Par exemple, supposons que l'entrée suivante existe dans l'annuaire LDAP :
dn: cn=Administrators, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Barbara Jenson, o=Example uniqueMember: cn=Fred User, o=Example
La directive suivante autoriserait alors l'accès à Fred et Barbara :
Require ldap-group cn=Administrators, o=Example
Les membres peuvent aussi se trouver dans les sous-groupes du
groupe LDAP spécifié si la directive AuthLDAPMaxSubGroupDepth a été
définie à une valeur supérieure à 0. Par exemple, supposons que les
entrées suivantes existent dans l'annuaire LDAP :
dn: cn=Employees, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Managers, o=Example uniqueMember: cn=Administrators, o=Example uniqueMember: cn=Users, o=Example dn: cn=Managers, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Bob Ellis, o=Example uniqueMember: cn=Tom Jackson, o=Example dn: cn=Administrators, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Barbara Jenson, o=Example uniqueMember: cn=Fred User, o=Example dn: cn=Users, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Allan Jefferson, o=Example uniqueMember: cn=Paul Tilley, o=Example uniqueMember: cn=Temporary Employees, o=Example dn: cn=Temporary Employees, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Jim Swenson, o=Example uniqueMember: cn=Elliot Rhodes, o=Example
Les directives suivantes autoriseraient alors l'accès à Bob Ellis, Tom Jackson, Barbara Jenson, Fred User, Allan Jefferson, et Paul Tilley, mais l'interdiraient à Jim Swenson, ou Elliot Rhodes (car ils sont situés dans un sous-groupe de niveau de profondeur 2) :
Require ldap-group cn=Employees, o=Example AuthLDAPMaxSubGroupDepth 1
Le comportement de cette directive est modifié par les directives
AuthLDAPGroupAttribute,
AuthLDAPGroupAttributeIsDN,
AuthLDAPMaxSubGroupDepth,
AuthLDAPSubGroupAttribute, et
AuthLDAPSubGroupClass.
La directive Require ldap-dn permet à
l'administrateur d'accorder l'utorisation d'accès en fonction du DN.
Elle permet de spécifier un DN pour lequel l'accès est autorisé. Si
le DN extrait de
l'annuaire correspond au DN spécifié par la directive Require
ldap-dn, l'autorisation d'accès est accordée. Note :
n'entourez pas Le DN de guillemets.
La directive suivante accorderait l'accès à un DN spécifique :
Require ldap-dn cn=Barbara Jenson, o=Example
Le comportement ce cette directive est modifié par la directive
AuthLDAPCompareDNOnServer.
La directive Require ldap-attribute permet à
l'administrateur d'accorder l'autorisation d'accès en fonction des
attributs de l'utilisateur authentifié dans l'annuaire LDAP. Si la
valeur de l'attribut dans l'annuaire correspond à la valeur
spécifiée par la directive, l'autorisation d'accès est accordée.
La directive suivante accorderait l'autorisation d'accès à tout utilisateur dont l'attribut employeeType a pour valeur "actif" :
Require ldap-attribute employeeType="active"
Plusieurs paires attribut/valeur peuvent être spécifiées par une
même directive en les séparant par des espaces, ou en définissant
plusieurs directives Require ldap-attribute. La logique
sous-jacente à une liste de paires attribut/valeur est une opération
OU. L'autorisation d'accès sera accordée si au moins une paire
attribut/valeur de la liste spécifiée correspond à la paire
attribut/valeur de l'utilisateur authentifié. Si elle contient des
espaces, la valeur, et seulement la valeur, doit être entourée de
guillemets.
La directive suivante accorderait l'autorisation d'accès à tout utilisateur dont l'attribut city aurait pour valeur "San Jose", ou donc l'attribut status aurait pour valeur "actif" :
Require ldap-attribute city="San Jose" status="active"
La directive Require ldap-filter permet à
l'administrateur d'accorder l'autorisation d'accès en fonction d'un
filtre de recherche LDAP complexe. L'autorisation d'accès est
accordée si le DN renvoyé par le filtre de recherche correspond au
DN de l'utilisateur authentifié.
La directive suivante accorderait l'autorisation d'accès à tout utilisateur possédant un téléphone cellulaire et faisant partie du département "marketing" :
Require ldap-filter &(cell=*)(department=marketing)
Alors que la directive Require ldap-attribute se
contente d'une simple comparaison d'attributs, la directive
Require ldap-filter effectue une opération de recherche
dans l'annuaire LDAP en utilisant le filtre de recherche spécifié.
Si une simple comparaison d'attributs suffit, l'opération de
comparaison effectuée par ldap-attribute sera plus
rapide que l'opération de recherche effectuée par
ldap-filter, en particulier dans le cas d'un annuaire
LDAP de grande taille.
Lorsqu'on utilise une expression dans un filtre, il faut s'assurer que les filtres LDAP sont correctement échappés afin de se prémunir contre toute injection LDAP. Pour ce faire, il est possible d'utiliser la fonction ldap.
<LocationMatch ^/dav/(?<SITENAME>[^/]+)/>
Require ldap-filter (memberOf=cn=%{ldap:%{unescape:%{env:MATCH_SITENAME}},ou=Websites,o=Example)
</LocationMatch>
La directive Require ldap-search permet à
l'administrateur d'autoriser l'accès en fonction d'un filtre de
recherche LDAP générique contenant une expression rationnelle. Si le filtre de
recherche renvoie une et une seule correspondance, l'accès est
accordé sans tenir compte du DN.
La directive suivante accorderait l'accès aux URLs correspondant aux objets spécifiés dans le serveur LDAP :
<LocationMatch "^/dav/(?<SITENAME>[^/]+)/">
Require ldap-search "(cn=%{ldap:%{unescape:%{env:MATCH_SITENAME}}
Website)"
</LocationMatch>
Note : il faut bien s'assurer que les expressions sont correctement échappés afin de se prémunir contre toute injection LDAP. A cet effet, il est possible d'utiliser la fonction ldap comme dans l'exemple ci-dessus.
AuthLDAPURL "ldap://ldap1.example.com:389/ou=People, o=Example?uid?sub?(objectClass=*)" Require valid-user
AuthLDAPURL "ldap://ldap1.example.com ldap2.example.com/ou=People, o=Example" Require valid-user
cn,
car une recherche sur le cn doit
retourner une entrée et une seule. C'est pourquoi cette
approche n'est pas recommandée : il est préférable de choisir un
attribut de votre annuaire dont l'unicité soit garantie, comme
uid.
AuthLDAPURL "ldap://ldap.example.com/ou=People, o=Example?cn" Require valid-user
AuthLDAPURL ldap://ldap.example.com/o=Example?uid Require ldap-group cn=Administrators, o=Example
AuthLDAPURL ldap://ldap.example.com/o=Example?uid
Require ldap-group cn=%{SERVER_NAME}, o=Example
qpagePagerID. Seuls ces utilisateurs
(authentifiés via leur UID) se verront accorder l'autorisation
d'accès :
AuthLDAPURL ldap://ldap.example.com/o=Example?uid??(qpagePagerID=*) Require valid-user
L'exemple suivant illustre la puissance des filtres pour effectuer des requêtes complexes. Sans les filtres, il aurait été nécessaire de créer un nouveau groupe LDAP et de s'assurer de la synchronisation des membres du groupe avec les utilisateurs possédant un bippeur. Tout devient limpide avec les filtres. Nous avons pour but d'accorder l'autorisation d'accès à tout utilisateur disposant d'un bippeur ainsi qu'à Joe Manager qui ne possède pas de bippeur, mais doit tout de même pouvoir accéder à la ressource :
AuthLDAPURL ldap://ldap.example.com/o=Example?uid??(|(qpagePagerID=*)(uid=jmanager)) Require valid-user
Ce dernier exemple peut sembler confus au premier abord ; en
fait, il permet de mieux comprendre à quoi doit ressembler le
filtre en fonction de l'utilisateur qui se connecte. Si Fred
User se connecte en tant que fuser, le filtre devra
ressembler à :
(&(|(qpagePagerID=*)(uid=jmanager))(uid=fuser))
Un recherche avec le filtre ci-dessus ne retournera un résultat positif que si fuser dispose d'un bippeur. Si Joe Manager se connecte en tant que jmanager, le filtre devra ressembler à :
(&(|(qpagePagerID=*)(uid=jmanager))(uid=jmanager))
Un recherche avec le filtre ci-dessus retournera un résultat positif que jmanager dispose d'un bippeur ou non
Pour l'utilisation de TLS, voir les directives du module
mod_ldap LDAPTrustedClientCert, LDAPTrustedGlobalCert et LDAPTrustedMode.
Un second paramètre optionnel peut être ajouté à la directive
AuthLDAPURL pour
remplacer le type de connexion par défaut défini par la directive
LDAPTrustedMode. Ceci
permettra de promouvoir la connexion établie via une URL du type
ldap:// au statut de connection sécurisée sur le même
port.
Pour l'utilisation de SSL, voir les directives du module
mod_ldap LDAPTrustedClientCert, LDAPTrustedGlobalCert et LDAPTrustedMode.
Pour spécifier un serveur LDAP sécurisé, utilisez
ldaps:// au lieu de
ldap:// dans la directive AuthLDAPURL.
Au cours du processus d'authentification, les attributs LDAP
spécifiés par la directive AuthLDAPURL sont enregistrés dans des
variables d'environnement préfixées par la chaîne "AUTHENTICATE_".
Au cours du processus d'autorisation, les attributs LDAP
spécifiés par la directive AuthLDAPURL sont enregistrés
dans des variables d'environnement préfixées par la chaîne
"AUTHORIZE_".
Si les champs attribut contiennent le nom, le CN et le numéro de téléphone d'un utilisateur, un programme CGI pourra accéder à ces informations sans devoir effectuer une autre requête LDAP pour les extraire de l'annuaire.
Ceci a pour effet de simplifier considérablement le code et la configuration nécessaire de certaines applications web.
Active Directory peut supporter plusieurs domaines à la fois. Pour faire la distinction entre les utilisateurs de plusieurs domaines, on peut ajouter à l'entrée de l'utilisateur dans l'annuaire un identifiant appelé Nom Principal d'Utilisateur (User Principle Name ou UPN). Cet UPN se compose en général du nom de compte de l'utilisateur, suivi du nom du domaine considéré, par exemple untel@nz.example.com.
Vous voudrez probablement configurer le module
mod_authnz_ldap afin de pouvoir authentifier les
utilisateurs de n'importe quel domaine de la forêt Active Directory.
Ainsi, untel@nz.example.com et
untel@au.example.com pourront être authentifiés en une
seule fois par la même requête.
Pour y parvenir, on utilise le concept de Catalogue Global d'Active Directory. Ce Catalogue Global est une copie en lecture seule des attributs sélectionnés de tous les serveurs de la forêt Active Directory. Une requête vers le Catalogue Global permet donc d'atteindre tous les domaines en une seule fois, sans avoir à se connecter aux différents serveurs, via des liaisons dont certaines peuvent être lentes.
Lorsqu'il est activé, la Catalogue Global est un serveur d'annuaire indépendant accessible sur le port 3268 (3269 pour SSL). Pour rechercher un utilisateur, effectuez une recherche sur l'attribut userPrincipalName, avec une base de recherche vide, comme suit :
AuthLDAPBindDN apache@example.com AuthLDAPBindPassword password AuthLDAPURL ldap://10.0.0.1:3268/?userPrincipalName?sub
Les utilisateurs devront s'authentifier en entrant leur UPN, de la formeuntel@nz.example.com.
Normalement, FrontPage utilise des fichiers utilisateur/groupe
spécifiques à FrontPage-web (c'est à dire les modules
mod_authn_file et
mod_authz_groupfile) pour effectuer toute
l'authentification. Malheureusement, il ne suffit pas de modifier
l'authentification LDAP en ajoutant les directives appropriées, car
ceci corromprait les formulaires de Permissions dans le
client FrontPage, qui sont censés modifier les fichiers
d'autorisation standards au format texte.
Lorsqu'un site web FrontPage a été créé, lui adjoindre
l'authentification LDAP consiste à ajouter les directives suivantes
à chaque fichier .htaccess qui sera créé dans
le site web :
AuthLDAPURL "the url" AuthGroupFile "mygroupfile" Require group "mygroupfile"
FrontPage restreint l'accès à un site web en ajoutant la
directive Require valid-user aux fichiers
.htaccess. La directive Require valid-user
permettra l'accès à tout utilisateur valide du point de vue
LDAP. Cela signifie que tout utilisateur possédant une entrée
dans l'annuaire LDAP sera considéré comme valide, alors que
FrontPage ne considère comme valides que les utilisateurs
enregistrés dans le fichier des utilisateurs local. En remplaçant
l'autorisation par groupe LDAP par une autorisation par fichier de
groupe, Apache sera en mesure de consulter le fichier des
utilisateurs local (géré par FrontPage) - au lieu de l'annuaire LDAP
- lors du processus d'autorisation des utilisateurs.
Une fois les directives ajoutées selon ce qui précède, les utilisateurs FrontPage pourront effectuer toutes les opérations de gestion à partir du client FrontPage.
mod_authn_file. A cette fin,
l'UID est idéal.mod_auth_basic, mod_authn_file
et mod_authz_groupfile. Ceci est dû au fait
qu'Apache doit utiliser le fichier de groupes de
mod_authz_groupfile pour déterminer le niveau
d'accès d'un utilisateur au site web FrontPage..htaccess. Elles ne fonctionneront pas si vous les
placez dans une section <Location> ou <Directory>. Ceci est dû au fait que pour savoir
où se trouve la liste des utilisateurs valides,
mod_authnz_ldap doit être en mesure d'atteindre
la directive AuthGroupFile qui se trouve
dans les fichiers .htaccess de FrontPage. Si les directives
de mod_authnz_ldap ne sont pas situées dans le
même fichier .htaccess que les directives FrontPage,
la configuration ne fonctionnera pas, car
mod_authnz_ldap ne sera jamais en mesure de
traiter le fichier .htaccess, et par conséquent ne
pourra jamais trouver le fichier des utilisateurs géré par
FrontPage.| Description: | Spécifie le préfixe ajouté aux variables d'environnement durant la phase d'autorisation |
|---|---|
| Syntaxe: | AuthLDAPAuthorizePrefix préfixe |
| Défaut: | AuthLDAPAuthorizePrefix AUTHORIZE_ |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
| Compatibilité: | Disponible depuis la version 2.3.6 |
Cette directive permet de spécifier le préfixe ajouté aux variables d'environnement durant la phase d'autorisation. Si la valeur spécifiée est AUTHENTICATE_, les utilisateurs de ces variables d'environnement verront les mêmes informations, que le serveur effectue une authentification, une autorisation, ou les deux.
Require
valid-user.
| Description: | Détermine si l'on doit utiliser d'autres fournisseurs d'authentification lorsque le serveur ne peut pas valider les données d'authentification de l'utilisateur, alors que ce dernier possède un DN. |
|---|---|
| Syntaxe: | AuthLDAPBindAuthoritative off|on |
| Défaut: | AuthLDAPBindAuthoritative on |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
Par défaut, des fournisseurs d'authentification sont appelés
si un utilisateur ne possède pas de DN, mais ne le sont pas si
l'utilisateur possède un DN et si son mot de passe ne peut pas être
vérifié lors d'une connexion au serveur LDAP. Si la directive
AuthLDAPBindAuthoritative est
définie à off, d'autres modules d'authentification
configurés auront une chance de valider le mot de passe de
l'utilisateur si la tentative de connexion au serveur LDAP échoue
pour une raison quelconque (avec les données d'authentification
fournies).
Ceci permet aux utilisateurs présent à la fois dans l'annuaire
LDAP et dans un fichier AuthUserFile de s'authentifier
lorsque le serveur LDAP est disponible, alors que le compte de
l'utilisateur est verrouillé ou que son mot de passe est
inutilisable pour une raison quelconque.
| Description: | Un DN optionnel pour se connecter au serveur LDAP |
|---|---|
| Syntaxe: | AuthLDAPBindDN dn |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
Cette directive permet de définir un DN optionnel pour se
connecter au serveur afin d'y rechercher des entrées. Si aucun DN
n'est spécifié, mod_authnz_ldap tentera une
connexion anonyme.
| Description: | Mot de passe à utiliser en conjonction avec le DN de connexion |
|---|---|
| Syntaxe: | AuthLDAPBindPassword mot-de-passe |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
| Compatibilité: | exec: est disponible depuis la version 2.4.5 du serveur HTTP Apache. |
Cette directive permet de spécifier un mot de passe à utiliser en
conjonction avec le DN de connexion. Notez que ce mot de passe
constitue en général une donnée sensible, et doit donc être protégé
de manière appropriée. Vous ne devez utiliser les directives
AuthLDAPBindDN et
AuthLDAPBindPassword que si
vous en avez vraiment besoin pour effectuer une recherche dans
l'annuaire.
Si la valeur spécifiée débute par "exec:", la commande qui suit sera exécutée, et la première ligne renvoyée par la commande sur la sortie standard sera utilisée comme mot de passe.
# Mot de passe spécifié directement AuthLDAPBindPassword secret # Exécution de /path/to/program pour obtenir le mot de passe AuthLDAPBindPassword exec:/path/to/program # Exécution de /path/to/otherProgram avec un argument pour obtenir le mot de passe AuthLDAPBindPassword "exec:/path/to/otherProgram argument1"
| Description: | Chemin du fichier de configuration de la correspondance langage/jeu de caractères |
|---|---|
| Syntaxe: | AuthLDAPCharsetConfig chemin-fichier |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
La directive AuthLDAPCharsetConfig permet
de définir le chemin du fichier de configuration de la
correspondance langage/jeu de caractères. chemin-fichier
est un chemin relatif au répertoire défini par la directive
ServerRoot. Ce fichier contient une liste
de correspondances extension de langage/jeu de caractères. La
plupart des administrateurs utilisent le fichier
charset.conv fourni qui associe les extensions de
langage courantes à leurs jeux de caractères.
Le fichier contient des lignes au format suivant :
extension de langage jeu de caractères
[Nom du langage] ...
L'extension est insensible à la casse. Les lignes vides et les
lignes commençant par un dièse (#) sont ignorées.
| Description: | Utilisation des données d'authentification de l'utilisateur pour effectuer les comparaisons pour l'attribution des autorisations |
|---|---|
| Syntaxe: | AuthLDAPCompareAsUser on|off |
| Défaut: | AuthLDAPCompareAsUser off |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
| Compatibilité: | Disponible depuis la version version 2.3.6 |
Lorsque cette directive est définie, et si
mod_authnz_ldap a authentifié l'utilisateur, les
recherches LDAP pour les autorisations utilisent le nom distinctif
trouvé (DN) et le mot de passe d'authentification basique HTTP de
l'utilisateur authentifié au lieu des données d'authentification
configurées au niveau du serveur.
Les vérifications d'autorisation ldap-attribute, ldap-user, et ldap-group (niveau simple seulement) utilisent des comparaisons.
Cette directive n'a d'effet sur les comparaisons effectuées au
cours des traitements de groupe imbriqués, et lorsque la directive
AuthLDAPSearchAsUser
est aussi activée.
Cette directive ne doit être utilisée que si votre serveur LDAP
n'autorise pas les recherches anonymes, ou si vous ne pouvez pas
utiliser de nom d'utilisateur dédié via la directive AuthLDAPBindDN.
| Description: | Utilise le serveur LDAP pour comparer les DNs |
|---|---|
| Syntaxe: | AuthLDAPCompareDNOnServer on|off |
| Défaut: | AuthLDAPCompareDNOnServer on |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
Lorsque cette directive est définie à on,
mod_authnz_ldap utilise le serveur LDAP pour
comparer les DNs. Il s'agit de la seule méthode infaillible pour
comparer les DNs. mod_authnz_ldap va rechercher
dans l'annuaire le DN spécifié par la directive Require dn, puis extraire ce DN et le
comparer avec le DN extrait de l'entrée de l'utilisateur. Si cette
directive est à off, mod_authnz_ldap effectue une
simple comparaison de chaînes. Cette dernière approche peut produire
des faux négatifs, mais elle est beaucoup plus rapide. Notez
cependant que le cache de mod_ldap peut accélérer
la comparaison de DNs dans la plupart des situations.
| Description: | À quel moment le module va déréférencer les alias |
|---|---|
| Syntaxe: | AuthLDAPDereferenceAliases never|searching|finding|always |
| Défaut: | AuthLDAPDereferenceAliases always |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
Cette directive permet de spécifier à quel moment
mod_authnz_ldap va déréférencer les alias au cours
des opérations liées à LDAP. La valeur par défaut est
always.
| Description: | L'attribut LDAP utilisé pour vérifier l'appartenance d'un utilisateur à un groupe. |
|---|---|
| Syntaxe: | AuthLDAPGroupAttribute attribut |
| Défaut: | AuthLDAPGroupAttribute member uniqueMember |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
Cette directive permet de spécifier quel attribut LDAP est
utilisé pour vérifier l'appartenance d'un utilisateur à un
groupe. On peut spécifier plusieurs attributs en répétant cette
directive plusieurs fois. Si la directive n'est pas définie,
mod_authnz_ldap utilise les attributs
member et uniqueMember.
| Description: | Utilise le DN de l'utilisateur pour vérifier son appartenance à un groupe |
|---|---|
| Syntaxe: | AuthLDAPGroupAttributeIsDN on|off |
| Défaut: | AuthLDAPGroupAttributeIsDN on |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
Lorsqu'elle est définie à on, cette directive
indique que c'est le DN de l'utilisateur qui doit être utilisé pour
vérifier son appartenance à un groupe. Dans le cas contraire, c'est
le nom de l'utilisateur qui sera utilisé. Par exemple, supposons que
le client envoie le nom d'utilisateur bjenson, qui
correspond au DN LDAP cn=Babs Jenson,o=Example. Si la
directive est à on, mod_authnz_ldap va
vérifier si cn=Babs Jenson, o=Example est un membre du
groupe. Dans le cas contraire, mod_authnz_ldap
vérifiera si bjenson est un membre du groupe.
| Description: | Détermine si le serveur effectue la recherche initiale du DN en utilisant le nom propre de l'utilisateur pour l'authentification de base et non de manière anonyme, ou en utilisant des données d'authentification codées en dur pour le serveur |
|---|---|
| Syntaxe: | AuthLDAPInitialBindAsUser off|on |
| Défaut: | AuthLDAPInitialBindAsUser off |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
| Compatibilité: | Disponible depuis la version 2.3.6 |
Par défaut, le serveur convertit le nom d'utilisateur pour l'authentification de base en nom distinctif LDAP (DN) soit de manière anonyme, soit avec un couple nom/mot de passe dédié. Cette directive permet de forcer le serveur à utiliser les véritables nom d'utilisateur et mot de passe fournis par l'utilisateur pour effectuer la recherche initiale du DN.
Si le nom d'utilisateur ne peut pas s'authentifier directement
et nécessite de légères modifications, voir la directive AuthLDAPInitialBindPattern.
Cette directive ne doit être utilisée que si votre serveur LDAP
n'autorise pas les recherches anonymes, ou si vous ne pouvez pas
utiliser de nom d'utilisateur dédié via la directive AuthLDAPBindDN.
| Description: | Spécifie la modification a apporter au nom d'utilisateur pour l'authentification de base lors de l'authentification auprès du serveur LDAP pour effectuer une recherche de DN |
|---|---|
| Syntaxe: | AuthLDAPInitialBindPattern regex substitution |
| Défaut: | AuthLDAPInitialBindPattern (.*) $1 (nom de l'utilisateur
distant utilisé tel quel) |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
| Compatibilité: | Disponible depuis la version 2.3.6 |
Si la directive AuthLDAPInitialBindAsUser est
définie à ON, le nom utilisateur pour l'authentification de
base sera transformé selon l'expression rationnelle
regex et l'argument substitution spécifiés.
L'expression rationnelle est comparée au nom d'utilisateur pour l'authentification de base courant. L'argument substitution peut contenir des références arrières, mais n'effectue aucune autre interpolation de variable.
Cette directive ne doit être utilisée que si votre serveur LDAP
n'autorise pas les recherches anonymes, ou si vous ne pouvez pas
utiliser de nom d'utilisateur dédié via la directive AuthLDAPBindDN.
AuthLDAPInitialBindPattern (.+) $1@example.com
AuthLDAPInitialBindPattern (.+) cn=$1,dc=example,dc=com
| Description: | Spécifie la profondeur d'imbrication des sous-groupes maximale prise en compte avant l'abandon de la recherche de l'utilisateur. |
|---|---|
| Syntaxe: | AuthLDAPMaxSubGroupDepth Nombre |
| Défaut: | AuthLDAPMaxSubGroupDepth 10 |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
| Compatibilité: | Disponible à partir de la version 2.3.0 du serveur HTTP Apache |
Lorsque cette directive est définie à une valeur X
non nulle, en combinaison avec l'utilisation de la directive
Require ldap-group DN-groupe, les données de connexion
fournies seront utilisées pour vérifier l'appartenance de
l'utilisateur à l'objet de l'annuaire DN-groupe ou à
tout sous-groupe du groupe courant en tenant compte de la profondeur
d'imbrication maximale X spécifiée par la directive.
Se référer à la section Require
ldap-group pour un exemple plus détaillé.
Lorsque les directives
AuthLDAPSubGroupAttribute et
AuthLDAPGroupAttribute se recouvrent (comme
c'est le cas par défaut et requis par les schémas LDAP courants), la
recherche de sous-groupes au sein de grands groupes peut être très
longue. Si vos groupes sont très grands et non imbriqués, définissez
la directive AuthLDAPMaxSubGroupDepth à 0.
| Description: | Spécifie l'attribut dont la valeur renvoyée au cours de la requête de l'utilisateur sera utilisée pour définir la variable d'environnement REMOTE_USER |
|---|---|
| Syntaxe: | AuthLDAPRemoteUserAttribute uid |
| Défaut: | none |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
Lorsque cette directive est définie, la variable d'environnement
REMOTE_USER sera définie à la valeur de l'attribut spécifié.
Assurez-vous que cet attribut soit bien inclus dans la liste d'attributs
spécifiés dans la définition de AuthLDAPURL ; dans le cas contraire,
cette directive n'aurait aucun effet. Si elle est présente, cette directive
l'emporte sur AuthLDAPRemoteUserIsDN. Elle peut
s'avérer utile par exemple, si vous souhaitez que les utilisateurs se
connectent à un site web en utilisant leur adresse email, alors qu'une
application sous-jacente nécessite un nom d'utilisateur comme
identifiant.
| Description: | Utilise le DN de l'utilisateur pour définir la variable d'environnement REMOTE_USER |
|---|---|
| Syntaxe: | AuthLDAPRemoteUserIsDN on|off |
| Défaut: | AuthLDAPRemoteUserIsDN off |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
Lorsque cette directive est à on, la variable d'environnement
REMOTE_USER sera définie avec la valeur du DN complet
de l'utilisateur authentifié, et non plus avec simplement le nom
d'utilisateur fourni par le client. Elle est définie à off par
défaut.
| Description: | Utilise les données d'authentification de l'utilisateur pour la recherche des autorisations |
|---|---|
| Syntaxe: | AuthLDAPSearchAsUser on|off |
| Défaut: | AuthLDAPSearchAsUser off |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
| Compatibilité: | Disponible depuis la version 2.3.6 |
Lorsque cette directive est définie, et si
mod_authnz_ldap a authentifié l'utilisateur, les
recherches LDAP pour définir les autorisations utilisent le nom
distinctif (DN) trouvé et le mot de passe pour l'authentification de
base HTTP de l'utilisateur authentifié, au lieu des données
d'authentification configurées au niveau du serveur.
Les vérifications d'autorisation ldap-filter et ldap-dn utilisent des recherches.
Cette directive n'a d'effet sur les comparaisons effectuées au
cours des traitements de groupe imbriqués, et lorsque la directive
AuthLDAPCompareAsUser
est aussi activée.
Cette directive ne doit être utilisée que si votre serveur LDAP
n'autorise pas les recherches anonymes, ou si vous ne pouvez pas
utiliser de nom d'utilisateur dédié via la directive AuthLDAPBindDN.
| Description: | Spécifie les noms d'attribut, un par directive, utilisés pour différencier les membres du groupe courant qui sont eux-mêmes des groupes. |
|---|---|
| Syntaxe: | AuthLDAPSubGroupAttribute attribut |
| Défaut: | AuthLDAPSubgroupAttribute member uniqueMember |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
| Compatibilité: | Disponible à partir de la version 2.3.0 du serveur HTTP Apache |
Un objet groupe LDAP peut contenir des membres qui sont des
utilisateurs et des membres qui sont eux-mêmes des groupes (appelés
sous-groupes ou groupes imbriqués). La directive
AuthLDAPSubGroupAttribute spécifie l'attribut utilisé
pour identifier les groupes, alors que la directive
AuthLDAPGroupAttribute
spécifie l'attribut utilisé pour identifier les utilisateurs. On peut
spécifier plusieurs attributs en répétant la directive plusieurs fois. Si
elle n'est pas définie, mod_authnz_ldap utilise les
attributs member et uniqueMember.
| Description: | Spécifie quelles valeurs d'objectClass LDAP identifient les objets de l'annuaire qui sont des groupes au cours du traitement des sous-groupes. |
|---|---|
| Syntaxe: | AuthLDAPSubGroupClass ObjectClass-LDAP |
| Défaut: | AuthLDAPSubGroupClass groupOfNames groupOfUniqueNames |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
| Compatibilité: | Disponible à partir de la version 2.3.0 du serveur HTTP Apache |
Un objet groupe LDAP peut contenir des membres qui sont des
utilisateurs et des membres qui sont eux-mêmes des groupes (appelés
sous-groupes ou groupes imbriqués). La directive
AuthLDAPSubGroupAttribute
permet d'identifier les
membres qui sont des sous-groupes du groupe courant (à l'opposé des
membres utilisateurs). La directive
AuthLDAPSubGroupClass permet de spécifier les valeurs
d'objectClass LDAP utilisées pour vérifier que certains membres sont
en fait des objets groupe. Les sous-groupes ainsi identifiés peuvent
alors faire l'objet d'une recherche d'autres membres utilisateurs ou
sous-groupes. On peut spécifier plusieurs attributs en répétant
cette directive plusieurs fois. Si cette directive n'est pas
définie, mod_authnz_ldap utilise les attributs
groupOfNames et groupOfUniqueNames.
| Description: | URL specifying the LDAP search parameters |
|---|---|
| Syntaxe: | AuthLDAPURL url [NONE|SSL|TLS|STARTTLS] |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_authnz_ldap |
La documentation de cette directive n'a pas encore t traduite. Veuillez vous reporter la version en langue anglaise.
Serveur HTTP Apache Version 2.4
| Description: | Autorisation en groupe et reconnaissance d'identité avec base SQL |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | authz_dbd_module |
| Fichier Source: | mod_authz_dbd.c |
| Compatibilité: | Disponible dans les versions 2.4 et supérieures d'Apache |
Ce module fournit des fonctionnalités d'autorisation permettant
d'accorder ou de refuser aux utilisateurs authentifiés l'accès à
certaines zones du site web en fonction de leur appartenance à tel
ou tel groupe. Les modules mod_authz_groupfile et
mod_authz_dbm fournissent une fonctionnalité
similaire, mais ici le module interroge une base de données SQL pour
déterminer si un utilisateur appartient ou non à tel ou tel groupe.
Ce module propose également des fonctionnalités de connexion
utilisateur s'appuyant sur une base de données, ce qui peut se révéler
particulièrement utile lorsque le module est utilisé conjointement avec
mod_authn_dbd.
Ce module s'appuie sur mod_dbd pour spécifier le
pilote de la base de données sous-jacente et les paramètres de
connexion, et gérer les connexions à la base de données.
Les directives Require Reconnaissance d'identité s'appuyant sur une base de données Reconnaissance d'identité côté client Exemple de configurationLes directives Require d'Apache permettent,
au cours de la phase d'autorisation, de s'assurer qu'un utilisateur
est bien autorisé à accéder à une ressource. mod_authz_dbd ajoute
les types d'autorisation dbd-group,
dbd-login et dbd-logout.
A partir de la version 2.4.8, les directives require DBD supportent les expressions.
Cette directive permet de spécifier à quel groupe un utilisateur doit appartenir pour obtenir l'autorisation d'accès.
Require dbd-group team AuthzDBDQuery "SELECT user_group FROM authz WHERE user = %s"
Cette directive permet de spécifier une requête à exécuter pour indiquer que l'utilisateur s'est authentifié.
Require dbd-login AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"
Cette directive permet de spécifier une requête à exécuter pour indiquer que l'utilisateur s'est déconnecté.
Require dbd-logout AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"
Outre sa fonction d'autorisation standard consistant à vérifier l'appartenance à des groupes, ce module permet aussi de gérer des sessions utilisateur côté serveur grâce à sa fonctionnalité de connexion utilisateur en s'appuyant sur une base de données. En particulier, il peut mettre à jour le statut de session de l'utilisateur dans la base de données chaque fois que celui-ci visite certaines URLs (sous réserve bien entendu que l'utilisateur fournissent les informations de connexion nécessaires).
Pour cela, il faut definir deux directives Require spéciales : Require
dbd-login et Require dbd-logout. Pour les détails de
leur utilisation, voir l'exemple de configuration ci-dessous.
Certains administrateurs peuvent vouloir implémenter une gestion de session côté client fonctionnant de concert avec les fonctionnalités de connexion/déconnexion des utilisateurs côté serveur offertes par ce module, en définissant ou en annulant par exemple un cookie HTTP ou un jeton similaire lorsqu'un utilisateur se connecte ou se déconnecte.
Pour supporter une telle intégration, mod_authz_dbd exporte
un programme à déclenchement optionnel (hook) qui sera lancé chaque fois
que le statut d'un utilisateur sera mis à jour dans la base de données.
D'autres modules de gestion de session pourront alors utiliser ce
programme pour implémenter des fonctions permettant d'ouvrir et de
fermer des sessions côté client.
# configuration de mod_dbd
DBDriver pgsql
DBDParams "dbname=apacheauth user=apache pass=xxxxxx"
DBDMin 4
DBDKeep 8
DBDMax 20
DBDExptime 300
<Directory "/usr/www/mon.site/team-private/">
# configuration de mod_authn_core et mod_auth_basic
# pour mod_authn_dbd
AuthType Basic
AuthName Team
AuthBasicProvider dbd
# requête SQL de mod_authn_dbd pour authentifier un utilisateur qui se
# connecte
AuthDBDUserPWQuery \
"SELECT password FROM authn WHERE user = %s AND login = 'true'"
# configuration de mod_authz_core pour mod_authz_dbd
Require dbd-group team
# configuration de mod_authz_dbd
AuthzDBDQuery "SELECT group FROM authz WHERE user = %s"
# lorsqu'un utilisateur échoue dans sa tentative d'authentification ou
# d'autorisation, on l'invite à se connecter ; cette page doit
# contenir un lien vers /team-private/login.html
ErrorDocument 401 "/login-info.html"
<Files "login.html">
# il n'est pas nécessaire que l'utilisateur soit déjà connecté !
AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
# le processus de connexion dbd exécute une requête pour enregistrer
# la connexion de l'utilisateur
Require dbd-login
AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"
# redirige l'utilisateur vers la page d'origine (si elle existe)
# après une connexion réussie
AuthzDBDLoginToReferer On
</Files>
<Files "logout.html">
# le processus de déconnexion dbd exécute une requête pour
# enregistrer la déconnexion de l'utilisateur
Require dbd-logout
AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"
</Files>
</Directory>
| Description: | Définit si le client doit être redirigé vers la page
d'origine en cas de connexion ou de déconnexion réussie si un en-tête
de requête Referer est présent |
|---|---|
| Syntaxe: | AuthzDBDLoginToReferer On|Off |
| Défaut: | AuthzDBDLoginToReferer Off |
| Contexte: | répertoire |
| Statut: | Extension |
| Module: | mod_authz_dbd |
Utilisée en conjonction avec Require dbd-login ou
Require dbd-logout, cette directive permet de rediriger
le client vers la page d'origine (l'URL contenue dans l'en-tête
de requête HTTP Referer, s'il est présent). En
l'absence d'en-tête Referer, la définition
AuthzDBDLoginToReferer On sera ignorée.
| Description: | Définit la requête SQL pour l'opération requise |
|---|---|
| Syntaxe: | AuthzDBDQuery requête |
| Contexte: | répertoire |
| Statut: | Extension |
| Module: | mod_authz_dbd |
La directive AuthzDBDQuery permet de
spécifier une requête SQL à exécuter. Le but de cette requête dépend
de la directive Require en cours de
traitement.
Require dbd-group, elle spécifie
une requête permettant de rechercher les groupes d'appartenance de
l'utilisateur courant. Ceci correspond à la fonctionnalité standard
d'autres modules d'autorisation comme
mod_authz_groupfile et
mod_authz_dbm.
La première colonne de chaque enregistrement renvoyé par la requête
doit contenir une chaîne de caractères correspondant à un nom de
groupe. La requête peut renvoyer zéro, un ou plusieurs
enregistrements.
Require dbd-group AuthzDBDQuery "SELECT group FROM groups WHERE user = %s"
Require dbd-login ou
Require dbd-logout, elle ne refusera jamais l'accès,
mais au contraire exécutera une requête SQL permettant d'enregistrer
la connexion ou la déconnexion de l'utilisateur. Ce dernier doit
être déjà authentifié avec mod_authn_dbd.
Require dbd-login AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"
Dans tous les cas, l'identifiant utilisateur sera transmis comme
paramètre sous la forme d'une simple chaîne lorsque la requête SQL
sera exécutée. Il y sera fait référence dans la requête en utilisant
le spécificateur de format %s.
| Description: | Définit une requête pour rechercher une page vers laquelle rediriger l'utilisateur après une connexion réussie |
|---|---|
| Syntaxe: | AuthzDBDRedirectQuery requête |
| Contexte: | répertoire |
| Statut: | Extension |
| Module: | mod_authz_dbd |
Spécifie une requête SQL optionnelle à utiliser après une
connexion (ou une déconnexion) réussie pour rediriger l'utilisateur
vers une URL, qui peut être spécifique à l'utilisateur.
L'identifiant utilisateur sera transmis comme paramètre sous la
forme d'une simple chaîne lorsque la requête SQL sera exécutée. Il y
sera fait référence dans la requête en utilisant le spécificateur de
format %s.
AuthzDBDRedirectQuery "SELECT userpage FROM userpages WHERE user = %s"
La première colonne du premier enregistrement renvoyé par la requête doit contenir une chaîne de caractères correspondant à une URL vers laquelle rediriger le client. Les enregistrements suivants sont ignorés. Si aucun enregistrement n'est renvoyé, le client ne sera pas redirigé.
Notez que AuthzDBDLoginToReferer l'emporte
sur cette directive si les deux sont définies.
Serveur HTTP Apache Version 2.4
| Description: | Autorisations de groupe basées sur l'hôte (nom ou adresse IP) |
|---|---|
| Statut: | Base |
| Identificateur de Module: | authz_host_module |
| Fichier Source: | mod_authz_host.c |
| Compatibilité: | Le fournisseur forward-dns est disponible à partir
de la version 2.4.19 du serveur HTTP Apache |
Les fournisseurs d'autorisation implémentés par le module
mod_authz_host sont enregistrés à l'aide de
la directive Require. On peut
utiliser cette directive à l'intérieur de sections <Directory>, <Files>, ou <Location> ou de fichiers
.htaccess pour
contrôler l'accès à certaines zones du serveur. Le contrôle d'accès
peut être effectué en fonction du nom d'hôte ou de l'adresse IP.
En général, les directives de restriction d'accès s'appliquent à
toutes les méthodes d'accès (GET, PUT,
POST, etc...). C'est d'ailleurs ce que l'on souhaite
dans la plupart des cas. Il est cependant possible de ne restreindre
l'accès que pour certaines méthodes, tout en laissant les autres
méthodes sans protection, en plaçant les directives dans une section
<Limit>.
Ce module ne fournit aucune directive.
La directive Apache Require est utilisée au cours de
la phase d'autorisation pour vérifier si un utilisateur se voit
accorder ou refuser l'accès à une ressource. mod_authz_host fournit
les types d'autorisation ip, host,
forward-dns et local. D'autres
types d'autorisation sont aussi disponibles, mais nécessitent le chargement
des modules d'autorisation appropriés.
Ces fournisseurs d'autorisation permettent de déterminer quels hôtes peuvent accéder à une zone du serveur. On peut contrôler l'accès en fonction du nom d'hôte, de l'adresse IP, ou d'un intervalle d'adresses IP.
A partir de la version 2.4.8, les directives require host supportent les expressions.
Le fournisseur ip permet de contrôler l'accès au
serveur en fonction de l'adresse IP du client distant. Lorsque
Require ip adresse-ip est spécifié, la
requête est autorisée si l'adresse IP du client distant correspond
à
Une adresse IP complète :
Require ip 10.1.2.3 Require ip 192.168.1.104 192.168.1.205
L'adresse IP d'un hôte pour qui l'accès est accordé
Une adresse IP partielle :
Require ip 10.1 Require ip 10 172.20 192.168.2
Les 1 à 3 premiers octets d'une adresse IP, pour une restriction à un sous-réseau.
Une paire réseau/masque de sous-réseau :
Require ip 10.1.0.0/255.255.0.0
Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z. pour une restriction de sous-réseau plus fine.
Une spécification CIDR réseau/nnn :
Require ip 10.1.0.0/16
Identique au cas précédent, excepté que le masque de sous-réseau représente les nnn premiers bits de poids fort.
Notez que les trois derniers exemples correspondent exectement au même ensemble d'hôtes.
On peut spécifier des adresses et des sous-réseaux IPv6 comme suit :
Require ip 2001:db8::a00:20ff:fea7:ccea Require ip 2001:db8:1:1::a Require ip 2001:db8:2:1::/64 Require ip 2001:db8:3::/48
Note: comme les adresses IP sont lues au démarrage, les expressions ne sont pas évaluées au moment de la requête.
Le fournisseur host permet de contrôler l'accès au
serveur en fonction du nom d'hôte du client distant. Lorsque
Require host nom-hôte est spécifié, la
requête est autorisée si le nom d'hôte correspond à
Un nom de domaine (éventuellement partiel)
Require host example.org Require host .net example.edu
Les hôtes dont les noms correspondent ou se terminent par la
chaîne spécifiée se voient accorder l'accès. Seuls les élément de
nom de domaine complets sont mis en correspondance ; ainsi,
l'exemple ci-dessus correspondra à foo.example.org, mais
ne correspondra pas à fooexample.org. Avec cette
configuration, Apache va effectuer une double recherche DNS sur
l'adresse IP du client, sans tenir compte de la définition de la
directive HostnameLookups. Il
va effectuer une recherche DNS inverse sur l'adresse IP pour trouver
le nom d'hôte associé, puis une recherche DNS directe sur le nom
d'hôte pour vérifier qu'il correspond bien à l'adresse IP originale.
L'accès ne sera accordé que si le nom d'hôte correspond et si les
recherches DNS inverse et directe sont cohérentes.
Le fournisseur forward-dns permet d'accéder au serveur
sécurisé en fonction de simples noms d'hôte. Lorsque Require
forward-dns host-name est spécifié, toute adresse IP
correspondant à host-name se voit autoriser l'accès.
A la différence du fournisseur host, ce fournisseur
n'effectue pas de recherche DNS inverse : il effectue simplement une requête
DNS directe pour le nom d'hôte spécifié et donne accès au client si son
adresse IP correspond. Il ne fonctionnera donc qu'avec des noms d'hôte
complets qui peuvent être résolus par le DNS, et non avec des noms de
domaine partiels. Par contre, comme le DNS inverse n'est pas sollicité, et
comme les recherches DNS interviennent au moment du traitement de la requête
(et non au démarrage), il fonctionnera avec des clients qui utilisent un
service de DNS dynamique.
Require forward-dns dynamic.example.org
Un client dont l'adresse IP correspond au nom d'hôte
dynamic.example.org se verra autoriser l'accès.
Le fournisseur local autorise l'accès au serveur si
l'une au moins de ces conditions est satisfaite :
L'exemple suivant montre une méthode simple pour sélectionner les connexions en provenance de l'hôte local :
Require local
Si le contenu de votre serveur est mandaté, vous devez garder à
l'esprit que l'adresse client correspondra à l'adresse de votre
serveur mandataire et non à l'adresse du client, et l'utilisation de
la directive Require dans ce contexte ne provoquera pas
forcément l'effet désiré. Voir mod_remoteip pour
une solution possible à ce problème.
Serveur HTTP Apache Version 2.4
| Description: | Génère automatiquement des index de répertoires d'une
manière similaire à la commande Unix ls, ou à la commande
shell Win32 dir |
|---|---|
| Statut: | Base |
| Identificateur de Module: | autoindex_module |
| Fichier Source: | mod_autoindex.c |
L'index d'un répertoire peut être généré de deux manières :
index.html, mais dont le nom de ce ou ces fichiers peut être défini par la
directive DirectoryIndex. C'est le module
mod_dir qui traite alors cet index.AddIcon, AddIconByEncoding et AddIconByType permettent de
définir une liste d'icônes à afficher en fonction des différents
types de fichiers ; pour chaque fichier listé, le premier icône
qui correspond au type du fichier est affiché. C'est le module
mod_autoindex qui traite alors cet index.Les deux fonctions sont séparées, si bien que vous pouvez entièrement supprimer (ou remplacer) la génération automatique d'index, si vous le souhaitez.
On active la génération automatique d'index en spécifiant
Options +Indexes. Voir la directive Options pour plus de détails.
Si la directive IndexOptions est spécifiée avec
l'option FancyIndexing, les en-têtes de colonnes sont des liens
qui permettent de contrôler l'ordre de tri de l'affichage. Si vous
actionnez le lien d'un en-tête, le listing sera généré à nouveau,
trié en fonction des valeurs de la colonne concernée. Si l'on
actionne de manière répétitive le même en-tête, l'ordre de tri est
commuté entre les ordres croissant et décroissant. On peut supprimer
ces liens d'en-têtes de colonnes à l'aide de l'option
SuppressColumnSorting
de la directive IndexOptions.
Notez que lorsque l'affichage est trié en fonction de la taille, c'est la taille réelle qui est prise en compte, et non la valeur affichée - ainsi, un fichier de 1010 octets sera toujours affiché avant un fichier de 1011 octets (en ordre croissant), même si la taille affichée des deux fichiers est "1K".
AddAlt AddAltByEncoding AddAltByType AddDescription AddIcon AddIconByEncoding AddIconByType DefaultIcon HeaderName IndexHeadInsert IndexIgnore IndexIgnoreReset IndexOptions IndexOrderDefault IndexStyleSheet ReadmeNameLa chaîne de paramètres de la requête peut contenir de nombreux
arguments permettant dans une certaine mesure au client de contrôler
l'ordre de l'index du répertoire, ainsi que la liste des fichiers à
afficher. Si vous souhaitez désactiver cette fonctionnalité,
utilisez l'option IndexOptions
IgnoreClient.
Les en-têtes de tri des colonnes eux-mêmes sont des hyper-liens auto-référant qui ajoutent les options de tri à la requête énumérées ci-dessous qui peuvent être ajoutées à toute requête concernant la ressource répertoire.
C=N trie l'affichage en fonction du nom de
fichierC=M trie l'affichage en fonction de la date de
dernière modification, puis du nom de fichierC=S trie l'affichage en fonction de la taille,
puis du nom de fichierC=D trie l'affichage en fonction
de la description, puis du nom de fichierO=A trie l'affichage selon l'ordre croissantO=D trie l'affichage selon
l'ordre décroissantF=0 affiche le listing sous la forme d'une simple
liste (sans FancyIndex)F=1 affiche le listing avec en-têtes de colonnes
sous forme de liens hyper-textes (FancyIndexed)F=2 affiche le listing sous
forme de table HTML avec en-têtes de colonnes contenant des liens
hyper-textes (FancyIndexed)V=0 désactive le tri en fonction de la
versionV=1 active le tri en fonction de
la versionP=modèle n'affiche que les fichiers
correspondant au modèle spécifiéNotez que l'argument 'P' (pour Pattern) n'est testé
qu'après que les directives habituelles IndexIgnore ont été traitées,
et que tous les noms de fichiers sont encore assujettis aux mêmes
critères que pour tout autre listing auto-indexé. L'interpréteur
d'arguments de requête de mod_autoindex s'arrête
immédiatement s'il rencontre une option non reconnue. Les arguments
de requête doivent être bien formés, selon la table ci-dessus.
Les options de requêtes sont illustrées par l'exemple ci-dessous, qui
peut être copié et collé dans un fichier header.html. Notez que l'argument
inconnu "X", pour le bouton submit, est introduit en dernier afin de
s'assurer que tous les arguments ont été interprétés avant que
mod_autoindex ne rencontre l'entrée X=Go.
<form action="" method="get">
Show me a <select name="F">
<option value="0"> Plain list</option>
<option value="1" selected="selected"> Fancy list</option>
<option value="2"> Table list</option>
</select>
Sorted by <select name="C">
<option value="N" selected="selected"> Name</option>
<option value="M"> Date Modified</option>
<option value="S"> Size</option>
<option value="D"> Description</option>
</select>
<select name="O">
<option value="A" selected="selected"> Ascending</option>
<option value="D"> Descending</option>
</select>
<select name="V">
<option value="0" selected="selected"> in Normal order</option>
<option value="1"> in Version order</option>
</select>
Matching <input type="text" name="P" value="*" />
<input type="submit" name="X" value="Go" />
</form>
| Description: | Texte optionnel à afficher à la place d'un icône pour un fichier en fonction de son nom |
|---|---|
| Syntaxe: | AddAlt texte fichier [fichier] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
La directive AddAlt permet d'afficher un
texte optionnel pour un fichier, à la place d'un icône, dans le cas
d'un affichage FancyIndexing.
fichier est une extension de fichier, un nom de fichier
partiel, une expression avec caractères génériques ou un nom de
fichier complet permettant de caractériser le(s) fichier(s)
concerné(s). Si texte contient des espaces, vous devez
l'entourer de guillemets ou d'apostrophes (" ou
'). Ce texte optionnel sera affiché si le client ne
peut pas afficher d'images, si le chargement d'images est désactivé
ou si l'icône ne peut pas être trouvé.
AddAlt "PDF file" *.pdf AddAlt Compressed *.gz *.zip *.Z
| Description: | Texte optionnel à afficher à la place d'un icône pour un fichier en fonction de son codage MIME |
|---|---|
| Syntaxe: | AddAltByEncoding texte codage MIME
[codage MIME] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
La directive AddAltByEncoding permet
d'afficher un texte optionnel à la place d'un icône pour un fichier
dans le cas d'un affichage FancyIndexing.
codage MIME doit être un type valide, comme
x-compress. Si texte contient des espaces,
vous devez l'entourer de guillemets ou d'apostrophes ("
ou '). Ce texte optionnel sera affiché si le client ne
peut pas afficher d'images, si le chargement d'images est désactivé
ou si l'icône ne peut pas être trouvé.
AddAltByEncoding gzip x-gzip
| Description: | Texte optionnel à afficher à la place d'un icône pour un fichier en fonction de son type MIME |
|---|---|
| Syntaxe: | AddAltByType texte type MIME
[type MIME] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
La directive AddAltByType permet
d'afficher un texte optionnel à la place d'un icône pour un fichier
dans le cas d'un affichage FancyIndexing.
type MIME doit être un type MIME valide, comme
text/html. Si texte contient des espaces,
vous devez l'entourer de guillemets ou d'apostrophes ("
ou '). Ce texte optionnel sera affiché si le client ne
peut pas afficher d'images, si le chargement d'images est désactivé
ou si l'icône ne peut pas être trouvé.
AddAltByType 'Fichier texte' text/plain
| Description: | Afficher la description d'un fichier |
|---|---|
| Syntaxe: | AddDescription texte [fichier] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
Cette directive permet d'afficher une description pour un
fichier, dans le cas d'un affichage FancyIndexing.
fichier est une extension de fichier, un nom de fichier
partiel, une expression avec caractères génériques ou un nom de
fichier complet permettant de caractériser le fichier.
texte doit être entouré de guillemets
(").
AddDescription "The planet Mars" mars.gif AddDescription "My friend Marshall" friends/mars.gif
La taille par défaut, habituelle du champ de description est de
23 octets. L'option IndexOptions SuppressIcon ajoute 6 octets, l'option
IndexOptions
SuppressSize en ajoute 7 et l'option IndexOptions
SuppressLastModified en ajoute 19. Ainsi, la plus grande
taille par défaut qui peut être assignée à la colonne description
est de 55 octets.
Comme l'argument fichier peut être un nom de fichier
partiel, vous devez garder à l'esprit qu'un nom de fichier partiel
trop court pourra correspondre à des fichiers non voulus. Par
exemple, le.html correspondra au fichier
le.html, mais aussi au fichier
example.html. En cas d'ambiguïté, utilisez un nom de
fichier aussi complet que possible, et ordonnez votre liste de
directives AddDescription en conséquence.
Voir le mot-clé DescriptionWidth de la directive IndexOptions pour plus de
détails sur la manière d'augmenter la taille de cette colonne, ou
pour permettre des descriptions de taille illimitée.
Le texte descriptif défini par la directive
AddDescription peut contenir des marquages
HTML, comme des balises ou des entités caractères. Si la limite de
taille de la colonne description venait à tronquer une balise (par
exemple couper la fin d'une phrase en caractères gras), le
résultat pourrait en affecter toute la suite du listing du
répertoire.
Les chemins absolus ne sont actuellement pas supportés et ne peuvent correspondre à aucun chemin réel à l'exécution. Les arguments contenant des chemins relatifs, qui ne devraient être normalement utilisés que dans les fichiers htaccess, sont implicitement préfixés par '*/' afin d'éviter toute association avec des noms de répertoires partiels.
| Description: | Icône à afficher pour un fichier en fonction de son nom |
|---|---|
| Syntaxe: | AddIcon icône nom [nom]
... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
Cette directive permet de déterminer l'icône à afficher à côté
d'un fichier dont le nom se termine par nom, dans le cas
d'un affichage FancyIndexing. icône est une URL relative
(échappée par des caractères '%') vers
l'icône, une URL distante pleinement qualifiée, ou de la forme
(alttext,url), où
alttext est le symbole texte correspondant à l'icône à
afficher dans les navigateurs en mode texte.
nom correspond à ^^DIRECTORY^^ pour les
répertoires, ^^BLANKICON^^ pour les lignes vides
(pour personnaliser la présentation du listing), une extension de
fichier, une expression avec caractères génériques, un nom de
fichier partiel ou un nom de fichier complet.
^^BLANKICON^^ n'est utilisé que pour le formatage,
et n'est donc pas nécessaire si vous utilisez IndexOptions
HTMLTable.
#Examples AddIcon (IMG,/icons/image.png) .gif .jpg .png AddIcon /icons/dir.png ^^DIRECTORY^^ AddIcon /icons/backup.png *~
Lorsque c'est possible, il est préférable d'utiliser AddIconByType plutôt que
AddIcon.
| Description: | Icône à afficher à côté d'un fichier en fonction de son codage MIME |
|---|---|
| Syntaxe: | AddIconByEncoding icône codage MIME
[codage MIME] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
Cette directive permet de déterminer l'icône à afficher à côté
d'un fichier dans le cas d'un affichage FancyIndexing.
icône est une URL relative
(échappée par des caractères '%') vers
l'icône, une URL pleinement qualifiée, ou de la forme
(alttext,url), où
alttext est le symbole texte correspondant à l'icône à
afficher dans les navigateurs en mode texte.
codage MIME doit être un codage valide, comme
x-compress.
AddIconByEncoding /icons/compress.png x-compress
| Description: | Icône à afficher à côté d'un fichier en fonction de son type MIME |
|---|---|
| Syntaxe: | AddIconByType icône type MIME
[type MIME] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
Cette directive permet de déterminer l'icône à afficher à côté
d'un fichier de type MIME type MIME dans le cas d'un
affichage FancyIndexing.
icône est une URL relative
(échappée par des caractères '%') vers
l'icône, une URL pleinement qualifiée, ou de la forme
(alttext,url), où
alttext est le symbole texte correspondant à l'icône à
afficher dans les navigateurs en mode texte.
type MIME est une expression avec caractères génériques représentant le type MIME.
AddIconByType (IMG,/icons/image.png) image/*
| Description: | Icône à afficher par défaut lorsqu'aucun icône spécifique n'est précisé |
|---|---|
| Syntaxe: | DefaultIcon chemin URL |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
La directive DefaultIcon permet de définir
l'icône à afficher à côté d'un fichier lorsqu'aucun icône spécifique
n'a été précisé, dans le cas d'un affichage FancyIndexing.
chemin URL est une URL relative (échappée par des
caractères '%') vers l'icône ou une URL pleinement qualifiée.
DefaultIcon /icon/unknown.png
| Description: | Nom du fichier qui sera inséré au début de la page contenant l'index |
|---|---|
| Syntaxe: | HeaderName nom fichier |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
La directive HeaderName permet de définir
le nom du fichier qui sera inséré au début de la page contenant
l'index. nom fichier est le nom du fichier à inclure.
HeaderName HEADER.html
Les deux directives HeaderName et ReadmeName traitent maintenant
nom fichier comme un chemin URI relatif au chemin
utilisé pour accéder au répertoire faisant l'objet de l'index. Si
nom fichier commence par un slash '/', il sera
considéré comme relatif au répertoire défini par la directive
DocumentRoot.
HeaderName /include/HEADER.html
nom fichier doit correspondre à un document dont le
type MIME est du style text/* (par exemple
text/html, text/plain, etc...). Cela
signifie que nom fichier peut faire référence à un
script CGI si le véritable type MIME du script (et non celui de sa
sortie) est marqué comme text/html par exemple à
l'aide d'une directive comme :
AddType text/html .cgi
Une négociation de
contenu sera effectuée si Options MultiViews a été
précisé. Si nom fichier correspond à un document
statique text/html (et non à un script CGI), et une
des deux options
Includes ou IncludesNOEXEC est activée,
le fichier sera traité en tant qu'inclusion côté serveur (Server
Side Include) (voir la documentation de
mod_include).
Si le fichier spécifié par la directive
HeaderName contient les en-têtes d'un
document HTML (<html>, <head>, etc...), vous serez
probablement amenés à définir IndexOptions
+SuppressHTMLPreamble, de manière à ce que ces balises ne
soient pas répétées.
| Description: | Insère du texte dans la section HEAD de la page d'index. |
|---|---|
| Syntaxe: | IndexHeadInsert "marque ..." |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
La directive IndexHeadInsert permet de
spécifier une chaîne de caractères à insérer dans la section
<head> du code HTML généré pour la page
d'index.
IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"
| Description: | Ajouts à la liste des fichiers à cacher lors de l'affichage de l'index d'un répertoire |
|---|---|
| Syntaxe: | IndexIgnore fichier [fichier] ... |
| Défaut: | IndexIgnore "." |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
La directive IndexIgnore permet
d'effectuer des ajouts à la liste des fichiers à cacher lors de
l'affichage de l'index d'un répertoire. fichier est une
expression avec caractères génériques de style shell ou un nom de
fichier complet. Plusieurs directives IndexIgnore effectuent des
ajouts à la liste, et ne remplacent pas la liste des fichiers à
ignorer. Par défaut, la liste contient . (le répertoire
courant).
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
Cette directive est actuellement incompatible avec les sections
de configuration qui comportent des arguments avec expressions
rationnelles comme <DirectoryMatch>
| Description: | Vide la liste des fichiers à cacher lors de l'affichage du contenu d'un répertoire |
|---|---|
| Syntaxe: | IndexIgnoreReset ON|OFF |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
| Compatibilité: | Versions 2.3.10 et supérieures |
La directive IndexIgnoreReset supprime toute liste
de fichiers définie par la directive IndexIgnore et héritée par ailleurs
d'autres sections de configuration.
<Directory "/var/www">
IndexIgnore *.bak .??* *~ *# HEADER* README* RCS CVS *,v *,t
</Directory>
<Directory "/var/www/backups">
IndexIgnoreReset ON
IndexIgnore .??* *# HEADER* README* RCS CVS *,v *,t
</Directory>
Revoyez la configuration par défaut pour une liste de modèles que vous voulez ignorer explicitement après usage de cette directive.
| Description: | Diverses options de configuration pour l'indexation d'un répertoire |
|---|---|
| Syntaxe: | IndexOptions [+|-]option [[+|-]option]
... |
| Défaut: | Par défaut, aucune option n'est activée. |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
La directive IndexOptions permet de
spécifier les options de configuration de l'indexation du
répertoire. option peut prendre l'une des valeurs
suivantes :
IndexOptions HTMLTable est activé et où un
IndexStyleSheet a été défini. Plutôt que d'appliquer
à chaque enregistrement de la table les classes standards
even et odd, c'est ici une classe
even-ALT ou odd-ALT
qui sera appliquée, où ALT sera soit le texte alternatif
standard associé au style du fichier (par exemple snd,
txt, img, etc...), soit le texte alternatif
défini par une des différentes directives AddAlt*.
Charset vous permet de spécifier le
jeu de caractères de la page générée. La valeur par défaut est
UTF-8 sous Windows et MAC OS X, et
ISO-8859-1 dans les autres cas (en fait selon que le
système de fichiers sous-jacent utilise les noms de fichiers en
Unicode ou non).
IndexOptions Charset=UTF-8
DescriptionWidth vous permet de
spécifier la taille en caractères de la colonne description.-DescriptionWidth (ou si l'option n'est pas
définie), mod_autoindex calcule la meilleure
taille.DescriptionWidth=n fixe la taille de
la colonne à n octets.DescriptionWidth=* ajuste la taille de la colonne
à la plus longue chaîne de description.
Voir la section concernant AddDescription pour les dangers
inhérants à la troncature des descriptions.FoldersFirst est
activé, le sous-répertoire Zed sera affiché avant le
sous-répertoire Beta, qui sera lui-même affiché avant
les fichiers normaux Gamma et Alpha.
Cette option n'a d'effet que si FancyIndexing
est aussi activé.
FancyIndexing permet de construire une table simple
pour l'affichage de l'index du répertoire. Cette option s'avèrera
particulièrement nécessaire pour les plates-formes où utf-8 est
activé et dans le cas où les noms de fichiers ou les chaînes
de description alternent entre les ordres de lecture gauche à
droite et droite à gauche.IconWidth, le serveur va inclure les attributs
height et width dans la balise
img qui référence le fichier de l'icône. Ceci va
permettre au navigateur de prévoir les caractéristiques de la page
sans devoir attendre que toutes les images aient été chargées. En
l'absence de cette option, c'est la hauteur standard définie par
le logiciel Apache httpd qui est choisie comme valeur par défaut.
Cette option n'a d'effet que si FancyIndexing
est aussi activé.
IconHeight, le serveur va inclure les attributs
height et width dans la balise
img qui référence le fichier de l'icône. Ceci va
permettre au navigateur de prévoir les caractéristiques de la page
sans devoir attendre que toutes les images aient été chargées. En
l'absence de cette option, c'est la largeur standard définie par
le logiciel Apache httpd qui est choisie comme valeur par défaut.IgnoreCase est activé,
le fichier Zeta apparaîtra après le fichier alfa (Note : le
fichier GAMMA apparaîtra toujours avant le fichier gamma).
mod_autoindex va
ignorer toutes les variables de requête fournies par le client, y
compris les informations de tri (ce qui implique l'activation de
l'option SuppressColumnSorting).NameWidth vous permet de spécifier la
largeur en octets de la colonne correspondant au nom du
fichier.-NameWidth (ou si l'option n'est pas
définie), mod_autoindex va calculer la meilleure largeur
possible, mais jusqu'à une largeur maximale de 20 octets.NameWidth=n fixe la largeur de la
colonne à n octets.NameWidth=* définit la largeur de colonne à la
valeur nécessaire.AddDescription, httpd va lire
le document pour tenter d'en extraire le titre. Ce
processus est coûteux en ressources disque et CPU.HTTP_UNAUTHORIZED ou HTTP_FORBIDDEN par
la sous-requête.IndexOptions
IgnoreClient.AddDescription pour plus d'informations à propos de
la définition des descriptions de fichiers. Voir aussi l'option
d'index DescriptionWidth
pour limiter la taille de la colonne description.
Cette option n'a d'effet que si FancyIndexing
est aussi activé.
HeaderName, le module inclut
en général le contenu du fichier après avoir inséré un préambule
HTML standard (<html>,
<head>, etc...). L'activation de
l'option SuppressHTMLPreamble supprime l'insertion de
ce préambule, et le module va alors commencer l'affichage
directement par le contenu du fichier d'en-tête. Dans ce cas par
contre, le fichier d'en-tête doit contenir des instructions HTML
appropriées. S'il n'y a pas de fichier d'en-tête, le préambule est
généré comme dans le cas général. Si vous spécifiez aussi une
directive ReadmeName, et si ce
fichier existe, les balises de fermeture closing
</body></html> seront aussi omises dans la sortie, en
supposant que vous ayez placé ces balises de fermeture dans ce
fichier.SuppressIcon et SuppressRules permet de
générer une sortie au format HTML 3.2 qui, selon les dernières
spécifications, interdit les éléments img et
hr dans les blocs pre (utilisés pour
formater les affichages "améliorés").FancyIndexing
est aussi activé.
hr) dans les index de
répertoires. La combinaison de
SuppressIcon et SuppressRules permet de
générer une sortie au format HTML 3.2 qui, selon les dernières
spécifications, interdit les éléments img et
hr dans les blocs pre (utilisés pour
formater les affichages "améliorés").
Cette option n'a d'effet que si FancyIndexing
est aussi activé.
FancyIndexing
est aussi activé.
Last-Modified et
ETag pour le répertoire indexé dans l'en-tête HTTP.
Elle n'est valide que si le système d'exploitation et le système
de fichiers renvoient des résultats appropriés pour la fonction
stat(). C'est le cas de certains systèmes Unix, ainsi que JFS sous
OS/2 ou
les volumes NTFS sous Win32. Ce n'est par contre pas le cas
des volumes FAT Win32 et OS/2. Lorsque cette option est activée, le
client ou le mandataire peuvent détecter les changements dans la
liste des fichiers lorsqu'ils effectuent une requête
HEAD. Notez que certains systèmes d'exploitation
détectent correctement les nouveaux fichiers et les fichiers
supprimés, mais ne détectent pas les modifications de tailles ou
de dates des fichiers du répertoire. Les modifications de
taille ou de date d'un fichier existant ne mettent pas à jour
l'en-tête Last-Modified sur toutes les plate-formes
Unix. Si c'est le cas, laissez cette option
désactivée.Type vous permet de spécifier le type
MIME de la page générée. La valeur par défaut est
text/html.
IndexOptions Type=text/plain
Last Modified
avait été modifié par inadvertance de "%d-%b-%Y %H:%M" en
"%Y-%m-%d %H:%M" dans la version 2.4.0. Cette option permet
de restaurer le format de date des versions 2.2 et antérieures.VersionSort permet de trier les
fichiers contenant des numéros de version d'une manière
spécifique. Les chaînes sont triées comme d'habitude, excepté les
sous-chaînes de chiffres du nom de fichier et de sa description
qui sont comparées en fonction de leur valeur numérique.
foo-1.7
foo-1.7.2
foo-1.7.12
foo-1.8.2
foo-1.8.2a
foo-1.12
Si le nombre commence par le chiffre 0, il est considéré comme la partie fractionnaire d'un nombre :
foo-1.001
foo-1.002
foo-1.030
foo-1.04
XHTML enjoint
mod_autoindex de générer du code XHTML 1.0 au
lieu de HTML 3.2.
Cette option n'a d'effet que si FancyIndexing
est aussi activé.
Vous devez porter une attention particulière à la manière dont
les IndexOptions multiples sont traitées.
IndexOptions
apparaissant dans la même section directory sont maintenant
fusionnées. Le résultat de :
<Directory "/foo">
IndexOptions HTMLTable
IndexOptions SuppressColumnsorting
</Directory>
est équivalent à
IndexOptions HTMLTable SuppressColumnsorting
+ ou -).Chaque fois qu'un mot-clé préfixé par '+' ou '-' est trouvé, il
est appliqué aux définitions des
IndexOptions courantes (qui ont été
éventuellement héritées d'un directory de niveau supérieur). Par
contre, si un mot-clé non préfixé est trouvé, il supprime toutes
les definitions héritées, ainsi que toute
définition incrémentale. Considérons l'exemple
suivant :
IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing IndexOptions +SuppressSize
L'effet global est équivalent à l'effet qu'aurait provoqué
IndexOptions FancyIndexing +SuppressSize, car l'option
non préfixée FancyIndexing annule les mots-clés
incrémentaux situés avant elle, mais leur permet ensuite de
s'incrémenter à nouveau.
Pour définir inconditionnellement les
IndexOptions pour un répertoire particulier,
tout en supprimant les définitions héritées, spécifiez les
mots-clés sans préfixe + ou -
| Description: | Définit l'ordre d'affichage par défaut d'un index de répertoire |
|---|---|
| Syntaxe: | IndexOrderDefault Ascending|Descending
Name|Date|Size|Description |
| Défaut: | IndexOrderDefault Ascending Name |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
La directive IndexOrderDefault s'utilise
en combinaison avec l'option d'index FancyIndexing. Par
défaut, les index de répertoires "améliorés" sont affichés selon l'ordre
croissant des noms de fichiers ; la directive
IndexOrderDefault vous permet de modifier ce
comportement.
La directive IndexOrderDefault accepte
deux arguments. Le premier est soit Ascending, soit
Descending, et indique l'ordre de tri. Le second doit
prendre une des valeurs Name, Date,
Size, ou Description, et permet
d'identifier la clé primaire. La clé secondaire est
toujours le nom du fichier selon un ordre croissant.
Si vous le désirez, vous pouvez empêcher le client de modifier
l'ordre de tri de la liste en ajoutant l'option d'index SuppressColumnSorting
qui supprime le lien de définition du tri de l'en-tête de la
colonne, ainsi que l'option IgnoreClient qui
empêche ce même client de passer outre vos préférences de tri en
ajoutant manuellement des options de tri à la chaîne de paramètres
de la requête.
| Description: | Ajoute une feuille de style CSS à l'index du répertoire |
|---|---|
| Syntaxe: | IndexStyleSheet chemin-url |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
La directive IndexStyleSheet permet de
définir le nom du fichier qui servira de feuille de style CSS pour
l'index.
IndexStyleSheet "/css/style.css"
L'utilisation de cette directive en conjonction avec IndexOptions
HTMLTable ajoute plusieurs classes CSS au document HTML
résultant. Un identifiant CSS indexlist est attribué à
l'ensemble de la table et les classes suivantes sont associées aux
différentes parties du listing :
| Classe | Définition |
|---|---|
| tr.indexhead | Ligne d'en-tête du listing |
| th.indexcolicon and td.indexcolicon | Colonne de l'icône |
| th.indexcolname and td.indexcolname | Colonne du nom du fichier |
| th.indexcollastmod and td.indexcollastmod | Colonne de la date de dernière modification |
| th.indexcolsize and td.indexcolsize | Colonne de la taille du fichier |
| th.indexcoldesc and td.indexcoldesc | Colonne de la description |
| tr.breakrow | Pied de page |
| tr.odd and tr.even | Alternance des lignes paires et impaires |
| Description: | Nom du fichier dont le contenu sera inséré à la fin de l'index |
|---|---|
| Syntaxe: | ReadmeName nom-fichier |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_autoindex |
La directive ReadmeName permet de définir
le nom du fichier dont le contenu sera ajouté à la fin de l'index.
nom-fichier est le nom du fichier à inclure, et est
considéré comme relatif au répertoire faisant l'objet de l'index. Si
nom-fichier commence par un slash '/', comme dans
l'exemple 2, il sera considéré
comme relatif au répertoire défini par la directive DocumentRoot.
# Example 1 ReadmeName FOOTER.html
# Example 2 ReadmeName /include/FOOTER.html
Voir aussi la directive HeaderName, où cette fonctionnalité est décrite plus en
détails.
Serveur HTTP Apache Version 2.4
| Description: | Gestion des connexions à une base de données SQL |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | dbd_module |
| Fichier Source: | mod_dbd.c |
| Compatibilité: | Versions 2.1 and supérieures |
Le module mod_dbd gère les connexions
à une base de données SQL via APR. Il permet
aux modules qui requièrent des fonctions liées aux bases de données
SQL de se connecter à une base de données à la demande, et s'efforce
de conférer aux bases de données une efficacité et une
évolutivité optimales pour les MPMs threadés ou non threadés. Pour
plus de détails, voir le site web APR,
ainsi que cette vue d'ensemble de l'environnement de
développement d'Apache DBD par son développeur initial.
Regroupement des connexions Connexion API DBD d'Apache Requêtes SQL préparées AVERTISSEMENT DE SECURITECe module gère de manière optimisée en fonction de la plate-forme
les connexions aux bases de données. Sur les plates-formes non
threadées, il maintient une connexion persistente à la manière d'un
LAMP classique (Linux, Apache, Mysql, Perl/PHP/Python). Sur les
plates-formes threadées, il maintient un groupe de
connexions à la fois plus évolutif et plus efficace, comme
décrit dans cet
article d'ApacheTutor. Notez que mod_dbd
remplace les modules présentés dans cet article.
Pour vous connecter à votre base de données, vous devez spécifier un pilote et des paramètres de connexion qui diffèrent selon le moteur de base de données. Par exemple, pour vous connecter à mysql, spécifiez ce qui suit :
DBDriver mysql DBDParams host=localhost,dbname=pony,user=shetland,pass=appaloosa
Vous pourrez alors utiliser cette connexion dans de nombreux autres
modules comme mod_rewrite, mod_authn_dbd
et mod_lua. Vous trouverez des exemples d'utilisation dans
la documentation de ces modules.
Voir la syntaxe de la directive DBDParams pour les
informations à fournir dans la chaîne de connexion en fonction des
différents pilotes de base de données supportés.
mod_dbd exporte cinq fonctions que d'autres
modules pourront utiliser. L'API se présente comme suit :
typedef struct {
apr_dbd_t *handle;
apr_dbd_driver_t *driver;
apr_hash_t *prepared;
} ap_dbd_t;
/* Fonctions exportées pour accéder à la base de données */
/* ouvre une connexion qui DOIT avoir été explicitement fermée.
* Renvoie NULL en cas d'erreur
*/
AP_DECLARE(ap_dbd_t*) ap_dbd_open(apr_pool_t*, server_rec*);
/* ferme une connexion ouverte avec ap_dbd_open */
AP_DECLARE(void) ap_dbd_close(server_rec*, ap_dbd_t*);
/* acquiert une connexion qui aura la durée de vie de la requête et qui
* NE DOIT PAS avoir été explicitement fermée. Renvoie NULL en cas
* d'erreur. C'est la fonction recommandée pour la plupart des
* applications.
*/
AP_DECLARE(ap_dbd_t*) ap_dbd_acquire(request_rec*);
/* acquiert une connexion qui aura la durée de vie d'une connexion et
* qui NE DOIT PAS avoir été explicitement fermée. Renvoie NULL en cas
* d'erreur.
*/
AP_DECLARE(ap_dbd_t*) ap_dbd_cacquire(conn_rec*);
/* Prépare une requête qu'un module client pourra utiliser */
AP_DECLARE(void) ap_dbd_prepare(server_rec*, const char*, const char*);
/* Exporte aussi ces fonctions à titre optionnel mour les modules qui
* péfèreraient les utiliser */
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_open, (apr_pool_t*, server_rec*));
APR_DECLARE_OPTIONAL_FN(void, ap_dbd_close, (server_rec*, ap_dbd_t*));
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_acquire, (request_rec*));
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_cacquire, (conn_rec*));
APR_DECLARE_OPTIONAL_FN(void, ap_dbd_prepare, (server_rec*, const char*, const char*));
mod_dbd supporte les requêtes SQL préparées à
destination des modules qui pourraient les utiliser. Chaque requête
préparée doit posséder un nom (étiquette), et est stockée dans un
condensé (hash) : les condensés sont du type
apr_dbd_prepared_t et s'utilisent dans toute requête
SQL ou commande select préparée par apr_dbd.
Il est du ressort des modules utilisateurs de dbd d'utiliser les
requêtes préparées et de préciser quelles requêtes doivent être
spécifiées dans httpd.conf, ou de fournir leurs propres directives
et d'utiliser ap_dbd_prepare.
reconnect à 0 dans la chaîne de connexion, afin
d'éviter des erreurs provoquées par un client MySQL qui se
reconnecterait sans réinitialiser correctement les requêtes
préparées. Si reconnect est défini à 1, toute
connexion défectueuse sera sensée être réparée, mais comme
mod_dbd n'en est pas informé, les requêtes préparées seront
invalidées.
Toute application web impliquant une base de données doit se protéger elle-même contre les attaques de type injection SQL. Dans la plupart des cas Apache DBD est sûr, car les applications utilisent des requêtes préparées, et les entrées non sures ne seront utilisées qu'à titre de données. Bien entendu, si vous l'utilisez via un module tiers, vous devez être au fait des précautions à prendre.
Cependant, le pilote FreeTDS est non sûr de par sa nature-même. Comme la bibliothèque sous-jacente ne supporte pas les requêtes préparées, le pilote en effectue une émulation, et les entrées non sûres sont fusionnées avec la requête SQL.
Il peut être sécurisé en décontaminant toutes les entrées : un processus inspiré de la recherche de contaminations (taint mode) de Perl. Chaque entrée est comparée à une expression rationnelle, et seules les entrées qui correspondent sont utilisées, en accord avec le langage Perl :
$untrusted =~ /([a-z]+)/;
$trusted = $1;Pour utiliser ceci, les expressions rationnelles de décontamination doivent être incluses dans les requêtes préparées. L'expression rationnelle doit se situer immédiatement après le caractère % dans la requête préparée, et doit être entourée d'accolades {}. Par exemple, si votre application attend une entrée alphanumérique, vous pouvez utiliser :
"SELECT foo FROM bar WHERE input = %s"
avec d'autres pilotes, et ne risquer au pire qu'une requête échouée. Mais avec FreeTDS, vous devez utiliser :
"SELECT foo FROM bar WHERE input = %{([A-Za-z0-9]+)}s"
tout ce qui ne correspond pas à l'expression rationnelle est alors rejeté, et la requête est maintenant sûre.
Alternativement, vous pouvez utiliser le pilote ODBC tiers, qui offre la sécurité des requêtes préparées authentiques.
| Description: | Durée de vie des connexions inactives |
|---|---|
| Syntaxe: | DBDExptime durée en secondes |
| Défaut: | DBDExptime 300 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_dbd |
Cette directive permet de définir la durée de vie des connexions inactives lorsque le nombre de connexions spécifié par la directive DBDKeep a été dépassé (plates-formes threadées uniquement).
| Description: | Exécute une instruction SQL après connexion à une base de données |
|---|---|
| Syntaxe: | DBDInitSQL "instruction SQL" |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_dbd |
Les modules qui le souhaitent peuvent exécuter une ou plusieurs instructions SQL après connexion à une base de données. Par exemple initialiser certaines valeurs, ou ajouter une entrée dans le journal lors d'une nouvelle connexion à la base de données.
| Description: | Nombre maximum de connexions maintenues |
|---|---|
| Syntaxe: | DBDKeep nombre |
| Défaut: | DBDKeep 2 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_dbd |
Cette directive permet de définir le nombre maximum de connexions à maintenir par processus, en dehors de celles servant à gérer les pics de demandes (plates-formes threadées uniquement).
| Description: | Nombre maximum de connexions |
|---|---|
| Syntaxe: | DBDMax nombre |
| Défaut: | DBDMax 10 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_dbd |
Cette directive permet de définir le nombre maximum effectif de connexions par processus (plates-formes threadées uniquement).
| Description: | Nombre minimum de connexions |
|---|---|
| Syntaxe: | DBDMin nombre |
| Défaut: | DBDMin 1 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_dbd |
Cette directive permet de définir le nombre minimum de connexions par processus (plates-formes threadées uniquement).
| Description: | Paramètres de la connexion à la base de données |
|---|---|
| Syntaxe: | DBDParams
param1=valeur1[,param2=valeur2] |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_dbd |
Cette directive permet de spécifier des paramètres selon les besoins du pilote concerné. En général, les paramètres à passer concernent tout ce qui n'a pas de valeur par défaut comme le nom d'utilisateur, le mot de passe, le nom de la base de données, le nom d'hôte et le numéro de port de la connexion.
Les paramètres de la chaîne de connexion en fonction des différents pilotes comprennent :
PQconnectdbpartie1:partie2 est utilisé dans
sqlite_open(partie1, atoi(partie2), NULL)sqlite3_open| Description: | Utiliser ou non des connexions persistentes |
|---|---|
| Syntaxe: | DBDPersist On|Off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_dbd |
Si cette directive est définie à Off, les connexions persistentes et les connexions groupées sont désactivées. À la demande d'un client, une nouvelle connexion à la base de données est ouverte, et fermée immédiatement à l'issue du traitement. Cette configuration ne doit être utilisée qu'à des fins de débogage, ou sur des serveurs à charge faible.
Par défaut, les groupes de connexions persistentes sont activés (ou une seule connexion persistente du style LAMP pour les serveurs non threadés), et c'est la configuration qui devrait être utilisée dans la plupart des cas sur un serveur en production.
Avant la version 2.2.2, cette directive n'acceptait que les
valeurs 0 et 1 au lieu de Off
et On, respectivement.
| Description: | Définit une requête SQL préparée |
|---|---|
| Syntaxe: | DBDPrepareSQL "requête SQL" étiquette |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_dbd |
Pour les modules tels que les modules d'authentification, qui utilisent de manière répétée la même requête SQL, on peut optimiser les performances en préparant la requête une fois pour toutes au démarrage, plutôt qu'à chaque utilisation. Cette directive permet de préparer une requête SQL et de lui assigner une étiquette.
| Description: | Spécifie un pilote SQL |
|---|---|
| Syntaxe: | DBDriver nom |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_dbd |
Cette directive permet de spécifier un pilote apr_dbd par son
nom. Le pilote doit être installé sur votre système (sur la plupart
des systèmes, il s'agit d'un objet partagé ou d'une dll). Par
exemple, DBDriver mysql va sélectionner le pilote MySQL
dans la bibliothèque apr_dbd_mysql.so.
Serveur HTTP Apache Version 2.4
| Description: | Permet la redirection des adresses se terminant par un répertoire sans slash de fin et la mise à disposition des fichiers index de répertoire |
|---|---|
| Statut: | Base |
| Identificateur de Module: | dir_module |
| Fichier Source: | mod_dir.c |
L'index d'un répertoire peut provenir de deux sources :
index.html, peut être défini à l'aide de la
directive DirectoryIndex
fournie par le module mod_dir.mod_autoindex.Les deux fonctions sont bien distinctes, si bien que vous pouvez supprimer (ou remplacer) la génération automatique d'index, si vous le souhaitez.
Une redirection "slash de fin" est effectuée lorsque le serveur
reçoit une requête pour une URL du style
http://nom-serveur/foo/nom-rep où nom-rep
est le nom d'un répertoire. Comme les répertoires nécessitent un slash de
fin, mod_dir effectue une redirection vers
http://nom-serveur/foo/nom-rep/.
| Description: | Définit la réponse de ce module lorsqu'un autre gestionnaire est utilisé |
|---|---|
| Syntaxe: | DirectoryCheckHandler On|Off |
| Défaut: | DirectoryCheckHandler Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_dir |
| Compatibilité: | Disponible depuis la version 2.4.8 du serveur HTTP Apache. Les versions antérieures à 2.4 se comportaient implicitement comme si "DirectoryCheckHandler ON" avait été spécifié. |
La directive DirectoryCheckHandler permet
de faire en sorte que mod_dir recherche un index
de répertoire ou ajoute des slashes de fin lorsqu'un autre
gestionnaire à été défini pour l'URL considérée. Les gestionnaires
peuvent être définis à via des directives telles que
SetHandler ou par d'autres
modules tels que mod_rewrite au cours des
substitutions de niveau répertoire.
Dans les versions antérieures à 2.4, ce module ne modifiait pas son
comportement si un autre gestionnaire avait été défini pour l'URL
considérée. Ceci permettait de servir des index de répertoires même si une
directive SetHandler avait été définie pour un
répertoire entier, mais pouvait aussi être à l'origine de conflits avec
d'autres modules comme mod_rewrite.
| Description: | Liste des fichiers ressources à rechercher lorsque le client envoie une requête pour un répertoire |
|---|---|
| Syntaxe: | DirectoryIndex
disabled | url locale [url locale] ... |
| Défaut: | DirectoryIndex index.html |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_dir |
La directive DirectoryIndex permet de
définir une liste de fichiers ressources à rechercher lorsqu'un
client envoie une requête pour l'index d'un répertoire, en ajoutant
un '/' à la fin du nom de ce dernier. url locale est
l'URL (codée avec caractères '%') d'un document du serveur, relative
au répertoire faisant l'objet de la requête ; il s'agit en général
du nom d'un fichier situé dans le répertoire. Si plusieurs URLs sont
fournies, le serveur renverra la première d'entre elles qui
correspond à une ressource existante. Si aucune ressource ne
correspond à la liste des URLs spécifiées, et si l'option
Indexes est définie, le serveur générera son propre
listing du répertoire.
DirectoryIndex index.html
Avec cette configuration, une requête pour l'URL
http://example.com/docs/ renverrait au client la
ressource http://example.com/docs/index.html si elle
existe, ou provoquerait la génération du listing du répertoire si la
ressource n'existe pas.
Notez qu'il n'est pas nécessaire que les documents soient relatifs au répertoire ;
DirectoryIndex index.html index.txt /cgi-bin/index.pl
provoquerait l'exécution du script CGI
/cgi-bin/index.pl si aucun des fichiers
index.html ou index.txt n'existe dans le
répertoire considéré.
La spécification du seul argument "disabled" empêche
mod_dir de rechercher un index. Un argument
"disabled" sera interprété de manière littérale si d'autres
arguments sont présents avant ou après lui, même s'ils sont
eux-mêmes des arguments "disabled".
Note: Positionner plusieurs directives DirectoryIndex
au coeur du même context complète la liste des ressources et ne l'écrase pas :
# Exemple A: Positionner index.html en page d'index, puis ajouter index.php.
<Directory "/foo">
DirectoryIndex index.html
DirectoryIndex index.php
</Directory>
# Exemple B: La même chose que l'exemple A, mais réalisé au moyen d'une seule directive.
<Directory "/foo">
DirectoryIndex index.html index.php
</Directory>
# Exemple C: Pour remplacer la liste des ressources, il faut d'abord la vider :
# Ici, seul index.php restera référencé comme ressource d'index.
<Directory "/foo">
DirectoryIndex index.html
DirectoryIndex disabled
DirectoryIndex index.php
</Directory>
| Description: | Définit une redirection externe pour les index de répertoires. |
|---|---|
| Syntaxe: | DirectoryIndexRedirect on | off | permanent | temp | seeother |
3xx-code
|
| Défaut: | DirectoryIndexRedirect off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_dir |
| Compatibilité: | Disponible depuis la version 2.3.14 |
Par défaut, c'est la page définie par la directive
DirectoryIndex qui est sélectionnée et
renvoyée de manière transparente au client. La directive
DirectoryIndexRedirect permet de rediriger le
client via une redirection de type 3xx.
Les arguments acceptés sont :
on : envoie une redirection 302 vers l'index choisi.off : n'envoie aucune redirection. Il s'agit du comportement historique de mod_dir.permanent : envoie une redirection 301 (permanent) vers l'index choisi.temp : ceci est équivalent à onseeother : envoie une redirection 303 (également appelée "See Other") vers l'index choisi.DirectoryIndexRedirect on
Une requête pour http://example.com/docs/ se
solderait par une redirection temporaire vers
http://example.com/docs/index.html si cette ressource
existe.
| Description: | Activation/Désactivation de la redirection "slash de fin" |
|---|---|
| Syntaxe: | DirectorySlash On|Off |
| Défaut: | DirectorySlash On |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_dir |
La directive DirectorySlash permet de
déterminer si mod_dir doit corriger ou non les URLs
pointant vers un répertoire.
En général, si un utilisateur envoie une requête pour une
ressource sans slash de fin, cette ressource représentant un
répertoire, mod_dir le redirige vers la même
ressource, mais en ajoutant un slash de fin, et ceci pour
plusieurs bonnes raisons :
mod_autoindex fonctionnera correctement. Comme
il n'indique pas le chemin dans le lien, le chemin de l'URL serait
incorrect.DirectoryIndex n'est évaluée
que pour les répertoires se terminant par un slash.Si vous ne souhaitez pas voir ces effets, et si les raisons évoquées ci-dessus ne s'appliquent pas à vous, vous pouvez désactiver la redirection comme indiqué ci-dessous. Gardez cependant à l'esprit que ceci peut avoir des répercutions en matière de sécurité.
# voir l'avertissement de sécurité ci-dessous !
<Location "/some/path">
DirectorySlash Off
SetHandler some-handler
</Location>
La désactivation de la redirection "slash de fin" peut entraîner
la divulgation d'informations. Considérons la situation où
mod_autoindex est actif (Options
+Indexes), où la directive DirectoryIndex a pour valeur une ressource valide (par
exemple index.html), et où aucun gestionnaire
particulier n'a été défini pour cette URL. Dans ce cas, une requête
avec slash de fin afficherait le contenu du fichier
index.html ; par contre, une requête sans slash
de fin afficherait un listing du contenu du
répertoire.
Notez aussi que certains navigateurs peuvent modifier par erreur des requêtes POST en requêtes GET lors d'une redirection, les données POST étant alors perdues.
| Description: | Définit une URL par défaut pour les requêtes qui ne ciblent aucun fichier |
|---|---|
| Syntaxe: | FallbackResource disabled | url-locale |
| Défaut: | disabled - httpd renvoie un code d'erreur 404 (Not Found) |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Base |
| Module: | mod_dir |
| Compatibilité: | L'argument disabled est disponible à partir
de la version 2.4.4 du serveur HTTP Apache. |
Cette directive permet de définir un traitement pour toute URL qui ne correspond à aucune ressource de votre système de fichiers, et qui provoquerait sans cela l'envoi d'un code d'erreur HTTP 404 (Not Found). Par exemple
FallbackResource /not-404.php
fait en sorte que les requêtes ne correspondant à aucun fichier
soient traitées par non-404.php, sans affecter les
requêtes pour des fichiers existants.
Il est souvent souhaitable qu'un seul fichier ou ressource traite toutes les requêtes à destination d'un répertoire particulier, sauf pour les requêtes qui correspondent à un fichier ou script existant. On y fait souvent référence sous le terme 'contrôleur frontal'.
Dans les versions plus anciennes de httpd, cet effet nécessitait
en général mod_rewrite, et l'utilisation des tests
conditionnels -f et -d pour vérifier
l'existence des fichiers et répertoires. Maintenant, une seule ligne
de configuration est nécessaire.
FallbackResource /index.php
Les fichiers existants comme des images, des fichiers css, etc... seront traités normalement.
L'argument disabled permet de désactiver cette
fonctionnalité dans le cas où l'héritage d'un répertoire parent
n'est pas souhaité.
Pour un URI intermédiaire tel que http://example.com/blog/, cet URI intermédiaire doit être spécifié en tant que url-locale :
<Directory "/web/example.com/htdocs/blog">
FallbackResource /blog/index.php
</Directory>
<Directory "/web/example.com/htdocs/blog/images">
FallbackResource disabled
</Directory>
Un gestionnaire de ressource par défaut (dans l'exemple ci-dessus
/blog/index.php) peut accéder à l'URL de la requête originale
via la variable de serveur REQUEST_URI. Pour accéder à cette
variable en PHP, par exemple, utilisez $_SERVER['REQUEST_URI'].
Serveur HTTP Apache Version 2.4
| Description: | Modifie l'environnement transmis aux scripts CGI et aux pages SSI |
|---|---|
| Statut: | Base |
| Identificateur de Module: | env_module |
| Fichier Source: | mod_env.c |
Ce module permet de contrôler les variables d'environnement
internes utilisées par divers modules du serveur HTTP Apache. Ces
variables sont aussi accessibles aux scripts CGI en tant que
variables d'environnement système natives, et disponibles dans les
pages SSI. Les variables d'environnement peuvent
être transmises depuis le shell qui a lancé le processus
httpd. Elles peuvent également être définies ou
supprimées au cours du processus de configuration.
| Description: | Transmet des variables d'environnement depuis le shell |
|---|---|
| Syntaxe: | PassEnv var-env [var-env]
... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_env |
Cette directive permet de spécifier quelles variables
d'environnement système natives doivent être disponibles en tant que
variables d'environnement internes pour les modules du serveur HTTP
Apache, et propagées vers les scripts CGI et les pages SSI. Leurs
valeurs sont issues de l'environnement natif de l'OS associé au
shell qui a invoqué le processus httpd.
PassEnv LD_LIBRARY_PATH
| Description: | Définit des variables d'environnement |
|---|---|
| Syntaxe: | SetEnv var-env [valeur] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_env |
Définit une variable d'environnement interne, cette dernière étant ensuite disponible pour les modules du serveur HTTP Apache et transmise aux scripts CGI et aux pages SSI.
SetEnv SPECIAL_PATH /foo/bin
Si l'argument valeur est absent, la variable est définie à la valeur d'une chaîne vide.
Les variables d'environnement internes définies par cette
directive le sont après l'exécution de la plupart des
directives du traitement initial des requêtes, comme les contrôles
d'accès et la mise en correspondance des URIs avec les noms de
fichiers. Si la variable d'environnement est sensée intervenir au
cours de cette phase initiale du traitement, par exemple pour la
directive RewriteRule,
vous devez plutôt utiliser la directive SetEnvIf pour définir cette
variable.
| Description: | Supprime des variables de l'environnement |
|---|---|
| Syntaxe: | UnsetEnv var-env [var-env]
... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_env |
Supprime une ou plusieurs variables d'environnement internes parmi celles qui sont transmises aux scripts CGI et aux pages SSI.
UnsetEnv LD_LIBRARY_PATH
Serveur HTTP Apache Version 2.4
| Description: | Fait traiter le corps de la réponse par un programme externe avant de l'envoyer au client |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | ext_filter_module |
| Fichier Source: | mod_ext_filter.c |
mod_ext_filter représente un modèle de
programmation simple et bien connu pour les filtres. Avec ce module, tout programme
qui lit l'entrée standard stdin et écrit sur la sortie standard
stdout (autrement dit une commande filtre de style Unix) peut
servir de filtre pour Apache. Ce mécanisme de filtrage est beaucoup
plus lent qu'un filtre spécialement écrit pour
l'API d'Apache et faisant partie intégrante du processus du serveur
Apache, mais il présente les avantages suivants :
Même dans le cas où le niveau de performance est insuffisant pour
une utilisation en production, on peut utiliser
mod_ext_filter comme prototype d'environnement pour
les filtres.
# la directive de mod_ext_filter définissant un filtre
# permettant de mettre des fichiers text/c au format HTML en
# utilisant le programme externe /usr/bin/enscript, le type du
# fichier résultant étant défini à text/html
ExtFilterDefine c-to-html mode=output \
intype=text/c outtype=text/html \
cmd="/usr/bin/enscript --color -w html -Ec -o -"
<Directory "/export/home/trawick/apacheinst/htdocs/c">
# directive de base permettant de traiter la sortie avec le
# nouveau filtre
SetOutputFilter c-to-html
# directive de mod_mime définissant le type des fichiers dont
# le nom possède l'extension .c à text/c
AddType text/c .c
</Directory>
Note : cet exemple avec gzip n'est fourni qu'à titre
d'illustration. Veuillez vous reporter à la documentation de
mod_deflate pour un exemple d'implémentation plus
pratique.
# la directive de mod_ext_filter qui définit le filtre externe
ExtFilterDefine gzip mode=output cmd=/bin/gzip
<Location "/gzipped">
# directive de base permettant de traiter la sortie avec le
# filtre gzip
SetOutputFilter gzip
# la directive de mod_headers permettant d'ajouter le champ
# d'en-tête "Content-Encoding: gzip"
Header set Content-Encoding gzip
</Location>
# directive de mod_ext_filter définissant un filtre qui fait
# passer tous les flux en sortie par la commande cat ; cat ne
# modifie rien ; elle ne fait que compliquer le cheminement des
# flux et consommer des ressources supplémentaires
ExtFilterDefine slowdown mode=output cmd=/bin/cat \
ExtFilterDefine slowdown mode=output cmd=/bin/cat \
preservescontentlength
<Location "/">
# directive de base permettant de traiter plusieurs fois la
# sortie avec le filtre slowdown
#
SetOutputFilter slowdown;slowdown;slowdown
</Location>
# directive de mod_ext_filter définissant un filtre qui
# remplace du texte dans la réponse
#
ExtFilterDefine fixtext mode=output intype=text/html \
cmd="/bin/sed s/verdana/arial/g"
<Location "/">
# directive de base permettant de traiter la sortie avec le
# filtre fixtext
SetOutputFilter fixtext
</Location>
Vous pouvez aussi utiliser mod_substitute pour
effectuer le même traitement sans avoir à invoquer un programme
externe.
# Trace les données lues et écrites par mod_deflate pour un
# client particulier (IP 192.168.1.31) qui a des problèmes de
# compression.
# Ce premier filtre va tracer ce qui entre dans mod_deflate.
ExtFilterDefine tracebefore \
cmd="/bin/tracefilter.pl /tmp/tracebefore" \
EnableEnv=trace_this_client
# Ce second filtre va tracer ce qui sort de mod_deflate.
# Notez que sans le paramètre ftype, le type de filtre par
# défaut AP_FTYPE_RESOURCE placerait le filtre *avant*
# mod_deflate dans la chaîne de filtrage. Le fait d'affecter
# à ce paramètre une valeur numérique sensiblement supérieure à
# AP_FTYPE_CONTENT_SET permet de s'assurer que le filtre sera
# placé après mod_deflate.
ExtFilterDefine traceafter \
cmd="/bin/tracefilter.pl /tmp/traceafter" \
EnableEnv=trace_this_client ftype=21
<Directory "/usr/local/docs">
SetEnvIf Remote_Addr 192.168.1.31 trace_this_client
SetOutputFilter tracebefore;deflate;traceafter
</Directory>
#!/usr/local/bin/perl -w
use strict;
open(SAVE, ">$ARGV[0]")
or die "can't open $ARGV[0]: $?";
while (<STDIN>) {
print SAVE $_;
print $_;
}
close(SAVE);
| Description: | Définit un filtre externe |
|---|---|
| Syntaxe: | ExtFilterDefine nom_filtre paramètres |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ext_filter |
La directive ExtFilterDefine
définit les caractéristiques d'un filtre externe, et en particulier
le programme à exécuter ainsi que ses arguments.
nom_filtre spécifie le nom du filtre en cours de
définition. On peut ensuite utiliser ce nom pour référencer le
filtre dans les directives SetOutputFilter. Il doit être unique parmi les noms de
tous les filtres enregistrés. Pour le moment, aucune erreur
n'est signalée par l'API register-filter, si bien qu'un problème de
noms dupliqués ne sera pas porté à la connaissance de
l'utilisateur.
Viennent ensuite un ou plusieurs paramètres dans un ordre
indéfini, qui permettent de spécifier la commande externe à exécuter
et certaines autres caractéristiques. Le seul paramètre obligatoire
est cmd=. Voici la liste de ces paramètres :
cmd=ligne de commandecmd= spécifie la commande
externe à exécuter. Si la ligne de commande comporte des
arguments, elle doit être entourée de guillemets (par exemple
cmd="/bin/mypgm arg1
arg2"). Les guillemets habituels du shell ne
sont pas nécessaires car le programme est lancé directement, sans
passer par le shell. Les arguments du programme doivent être
séparés par des espaces. Si un argument contient des espaces, ces
derniers doivent être échappés par un antislash '\'. Si un
argument contient des antislashes '\', ces derniers doivent être
eux-mêmes échappés par un antislash '\'. Outre les variables
d'environnement CGI standards, les variables DOCUMENT_URI,
DOCUMENT_PATH_INFO, et QUERY_STRING_UNESCAPED seront également
définies pour le programme.mode=modemode=output (valeur par défaut) pour les
filtres qui traitent les réponses. Utilisez
mode=input pour les filtres qui traitent les
requêtes. mode=input est disponible depuis la version
2.1 d'Apache.intype=type MIMEintype= ne sera filtré.outtype=type MIMEPreservesContentLengthPreservesContentLength indique que le
filtre doit conserver la taille du contenu. Ce n'est pas le
comportement par défaut, car la plupart des filtres modifient cette
taille. Ce mot-clé doit être spécifié si le filtre ne doit pas
modifier la taille du contenu.ftype=type de filtredisableenv=envenableenv=env| Description: | Configure les options de
mod_ext_filter |
|---|---|
| Syntaxe: | ExtFilterOptions option [option] ... |
| Défaut: | ExtFilterOptions NoLogStderr |
| Contexte: | répertoire |
| Statut: | Extension |
| Module: | mod_ext_filter |
La directive ExtFilterOptions
spécifie des options de traitement particulières pour
mod_ext_filter. Les arguments option
peuvent contenir :
LogStderr | NoLogStderrLogStderr indique que les messages
envoyés par le programme de filtrage externe sur la sortie
d'erreurs standard doivent être enregistrés dans le journal des
erreurs d'Apache. NoLogStderr inverse ce
comportement.Onfail=[abort|remove]abort (la valeur par
défaut), le traitement de la requête sera abandonné. Avec remove, le
filtre est supprimé, et le traitement de la requête se poursuit
sans lui.ExtFilterOptions LogStderr
Les messages envoyés vers la sortie d'erreurs standard du filtre seront enregistrés dans le journal des erreurs d'Apache.
Serveur HTTP Apache Version 2.4
| Description: | Personnalisation des en-têtes de requêtes et de réponses HTTP |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | headers_module |
| Fichier Source: | mod_headers.c |
Ce module fournit des directives permettant de contrôler et modifier les en-têtes de requêtes et de réponses HTTP. Les en-têtes peuvent être fusionnés, remplacés ou supprimés.
Les directives fournies par mod_headers peuvent
s'insérer presque partout dans la configuration du serveur, et on
peut limiter leur portée en les plaçant dans des sections de configuration.
La chronologie du traitement est importante et est affectée par l'ordre d'apparition des directives dans le fichier de configuration et par leur placement dans les sections de configuration. Ainsi, ces deux directives ont un effet différent si leur ordre est inversé :
RequestHeader append MirrorID "mirror 12" RequestHeader unset MirrorID
Dans cet ordre, l'en-tête MirrorID n'est pas défini.
Si l'ordre des directives était inversé, l'en-tête
MirrorID serait défini à "mirror 12".
mod_headers peut agir soir précocement, soit
tardivement au niveau de la requête. Le mode normal est le mode
tardif, lorsque les en-têtes de requête sont définis, immédiatement
avant l'exécution du générateur de contenu, et pour les en-têtes de
réponse, juste au moment où la réponse est envoyée sur le réseau.
Utilisez toujours le mode tardif sur un serveur en production.
Le mode précoce a été conçu à des fins d'aide aux tests et au
débogage pour les développeurs. Les directives définies en utilisant
le mot-clé early sont censées agir au tout début du
traitement de la requête. Cela signifie que l'on peut les utiliser
pour simuler différentes requêtes et définir des situations de test,
tout en gardant à l'esprit que les en-têtes peuvent être modifiés à
tout moment par d'autres modules avant que le réponse ne soit
générée.
Comme les directives précoces sont traitées avant que le
chemin de la requête ne soit parcouru, les en-têtes
précoces ne peuvent être définis que dans un contexte de serveur
principal ou de serveur virtuel. Les directives précoces ne peuvent
pas dépendre d'un chemin de requête, si bien qu'elles échoueront
dans des contextes tels que <Directory> ou <Location>.
Header echo ^TS
mon-en-tête, qui
contient un horodatage permettant de déterminer le moment où la
requête a été reçue, et le temps qui s'est écoulé jusqu'à ce que
la requête ait commencé à être servie. Cet en-tête peut être
utilisé par le client pour estimer la charge du serveur ou
isoler les goulets d'étranglement entre le client et le
serveur.
Header set mon-en-tête "%D %t"
le résultat est l'ajout à la réponse d'un en-tête du type :
mon-en-tête: D=3775428 t=991424704447256
Header set mon-en-tête "Bonjour Joe. Il a fallu %D microsecondes \
à Apache pour servir cette requête."
le résultat est l'ajout à la réponse d'un en-tête du type :
Header set MyHeader "Bonjour Joe. Il a fallu D=3775428 microsecondes à Apache
pour servir cette requête."
mon-en-tête à la réponse si et
seulement si l'en-tête mon-en-tête-requête est
présent dans la requête. Ceci peut s'avérer utile pour générer
des en-têtes de réponse "à la tête du client". Notez que cet
exemple nécessite les services du module
mod_setenvif.
SetEnvIf MyRequestHeader myvalue HAVE_MyRequestHeader Header set MyHeader "%D %t mytext" env=HAVE_MyRequestHeader
Si l'en-tête mon-en-tête-requête: mavaleur est
présent dans la requête HTTP, la réponse contiendra un en-tête
du type :
mon-en-tête: D=3775428 t=991424704447256 montexte
RequestHeader edit Destination ^https: http: early
CGI,
NO_CACHE et NO_STORE existent pour la
requête) :
Header merge Cache-Control no-cache env=CGI Header merge Cache-Control no-cache env=NO_CACHE Header merge Cache-Control no-store env=NO_STORE
alors, la réponse contiendra l'en-tête suivant :
Cache-Control: no-cache, no-store
Si append avait été utilisé à la place de
merge, la réponse aurait contenu l'en-tête suivant
:
Cache-Control: no-cache, no-cache, no-store
Header set Set-Cookie testcookie "expr=-z %{req:Cookie}"
Header append Cache-Control s-maxage=600 "expr=%{REQUEST_STATUS} == 200"
| Description: | Configure les en-têtes d'une réponse HTTP |
|---|---|
| Syntaxe: | Header [condition] add|append|echo|edit|edit*|merge|set|setifempty|unset|note
en-tête [[expr=]valeur
[remplacement]
[early|env=[!]variable|expr=expression]]
|
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_headers |
| Compatibilité: | SetIfEmpty est disponible depuis la version 2.4.7 du serveur HTTP Apache ; le paramètre expr=valeur a été introduit avec la version 2.4.10 |
Cette directive permet de remplacer, fusionner, ou supprimer des en-têtes de réponse HTTP. L'en-tête est modifié juste après que le gestionnaire de contenu et les filtres en sortie ne s'exécutent, ce qui permet la modification des en-têtes sortants.
L'argument optionnel condition permet de déterminer
sur quelle table interne d'en-têtes de réponses cette directive va
opérer : onsuccess (valeur par défaut, peut être omis) ou
always. A la différence de ceux de la première table, les
en-têtes de la seconde sont ajoutés à la réponse même en cas d'erreur et
sont conservés au fil des redirections internes (par exemple les
gestionnaires ErrorDocument). Notez aussi que la répétition
de cette directive avec les deux conditions peut être pertinente
dans certains scénarios, car always n'englobe pas
onsuccess en ce qui concerne les en-têtes existants :
always est utilisée dans la réponse
définitive.mod_proxy_fcgi, auquel cas, les en-têtes des scripts CGI
sont dans la table correspondant à always et non dans la
table par défaut.onsuccess.Comme il n'y a pas de liste unique "normalisée" d'en-têtes, la manière
dont httpd stocke en interne les en-têtes des réponses HTTP est à l'origine
de la fonctionnalité que constitue la différence entre
onsuccess et always. Si vous ne gardez pas à
l'esprit le concept ci-après lors de l'écriture de votre configuration,
certaines réponses HTTP pourront contenir des en-têtes dupliqués
(ce qui pourra dérouter les utilisateurs ou même parfois les clients HTTP). Supposons par
exemple que votre configuration comporte un mandataire PHP simple avec
mod_proxy_fcgi et que votre script PHP d'arrière-plan
ajoute l'en-tête X-Foo: bar à chaque réponse HTTP. Comme décrit
plus haut, mod_proxy_fcgi utilise la table
always pour stocker les en-têtes, et une configuration comme la
suivante n'aboutira pas au résultat attendu car l'en-tête sera dupliqué
avec les deux valeurs :
# la valeur de X-Foo est définie dans la table d'en-têtes 'onsuccess' Header set X-Foo: baz
Plusieurs modèles de configuration permettent de contourner ce problème, comme celui-ci :
# 'onsuccess' peut être omis car il s'agit de la valeur par défaut Header onsuccess unset X-Foo Header always set X-Foo "baz"
Outre le paramètre condition décrit ci-dessus, vous pouvez limiter une action en fonction de codes d'état HTTP, par exemple pour les requêtes mandatées ou générées par un programme CGI. Voir l'exemple qui utilise %{REQUEST_STATUS} dans la section ci-dessus.
L'action que cette directive provoque est déterminée par le premier argument (ou par le second argument si une condition est spécifiée). Il peut prendre une des valeurs suivantes :
Vous devez lire la différence, décrite plus haut, entre les listes
d'en-têtes always et onsuccess avant de lire
la liste d'actions ci-dessous car cet important concept s'applique
encore ici. En fait, chaque action fonctionne telle qu'elle est décrite
mais seulement pour la liste d'en-têtes cible.
addset, append ou merge.appendechoeditedit*edit n'effectuera une
recherche/remplacement qu'une seule fois dans la valeur de
l'en-tête, alors que la forme edit* en effectuera autant
que le nombre d'apparition de la chaîne à remplacer.mergesetsetifemptysetifempty est évalué. Dans ce cas, il est
préférable d'utiliser set comme dans l'exemple suivant :
Header set Content-Type "text/plain" "expr=-z %{CONTENT_TYPE}"
unsetnoteCet argument est suivi d'un nom d'en-tête qui peut se
terminer par un caractère ':', mais ce n'est pas obligatoire. La
casse est ignorée avec set, append,
merge, add, unset et
edit. Le nom d'en-tête est sensible à la
casse pour echo et peut être une expression rationnelle.
Avec set, append, merge et
add, une valeur est spécifiée comme
argument suivant. Si valeur contient des espaces, elle
doit être entourée de guillemets. valeur peut être une
chaîne de caractères, une chaîne contenant des spécificateurs de
format propres à mod_headers (et des caractères
littéraux), ou une expression ap_expr
préfixée par expr=.
valeur supporte les spécificateurs de format suivants :
| Format | Description |
|---|---|
%% |
Le caractère pourcentage |
%t |
Le moment de réception de la requête en temps
universel coordonné depuis le temps epoch (Jan. 1, 1970) et
exprimé en microsecondes. La valeur est précédée de
t=. |
%D |
Le temps écoulé entre la réception de la requête et l'envoi
des en-têtes sur le réseau. Il s'agit de la durée de traitement
de la requête. La valeur est précédée de D=. La
valeur est exprimée en microsecondes. |
%l |
La charge moyenne courante du serveur proprement dit. Ce
sont les valeurs obtenues par getloadavg() qui
représentent la charge moyenne courante, sur 5 minutes et sur 15
minutes. Chaque valeur est précédée de l= et
séparée de la suivante par un /.Disponible depuis la version 2.4.4 du serveur HTTP Apache. |
%i |
Le pourcentage courant de httpd au repos (de 0 à 100)
en se basant sur le nombre de processus et threads disponibles.
La valeur est précédée de i=.Disponible depuis la version 2.4.4 du serveur HTTP Apache. |
%b |
Le pourcentage courant de httpd utilisé (de 0 à 100)
en se basant sur le nombre de processus et threads disponibles.
La valeur est précédée de b=.Disponible depuis la version 2.4.4 du serveur HTTP Apache. |
%{NOM_VARIABLE}e |
Le contenu de la variable
d'environnement NOM_VARIABLE. |
%{NOM_VARIABLE}s |
Le contenu de la variable
d'environnement SSL NOM_VARIABLE, si
mod_ssl est activé. |
Le spécificateur de format %s est disponible
depuis la version 2.1 d'Apache ; il peut être utilisé à la place
de %e pour éviter de devoir spécifier
SSLOptions +StdEnvVars. Cependant, si
SSLOptions +StdEnvVars doit tout de même être
spécifié pour une raison quelconque, %e sera plus
efficace que %s.
Lorsque le paramètre valeur utilise l'interpréteur ap_expr, certaines syntaxes d'expressions seront différentes des exemples qui évaluent des expressions booléennes telles que <If> :
Header set foo-checksum "expr=%{md5:foo}"
editnécessite les deux arguments
valeur, qui est une expression
rationnelle, et une chaîne additionnelle
remplacement. Depuis la version 2.4.7, la chaîne de
remplacement peut aussi
contenir des spécificateurs de format.
La directive Header peut être suivie d'un
argument additionnel qui peut prendre les valeurs suivantes :
earlyenv=[!]variablevariable existe. Un ! devant
variable inverse le test, et la directive ne
s'appliquera alors que si variable n'est pas définie.expr=expression # Cet exemple retarde l'évaluation de la clause de condition par
# rapport à <If>
Header always set CustomHeader my-value "expr=%{REQUEST_URI} =~ m#^/special_path.php$#"
Excepté le cas du mode précoce, les
directives Header sont traitées juste avant
l'envoi de la réponse sur le réseau. Cela signifie qu'il est
possible de définir et/ou modifier la plupart des en-têtes, à
l'exception de certains en-têtes qui sont ajoutés par le filtre
d'en-tête HTTP. Avant la version 2.2.12, il n'était pas
possible de modifier l'en-tête Content-Type avec cette directive.
| Description: | Configure les en-têtes d'une requête HTTP |
|---|---|
| Syntaxe: | RequestHeader add|append|edit|edit*|merge|set|setifempty|unset
en-tête [[expr=]valeur
[remplacement]
[early|env=[!]variable|expr=expression]]
|
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_headers |
| Compatibilité: | SetIfEmpty est disponible depuis la version 2.4.7 du serveur HTTP Apache ; le paramètre expr=valeur a été introduit avec la version 2.4.10 |
Cette directive permet de remplacer, fusionner, modifier ou supprimer des en-têtes de requête HTTP. L'en-tête est modifié juste avant que le gestionnaire de contenu ne s'exécute, ce qui permet la modification des en-têtes entrants. L'action effectuée est déterminée par le premier argument. Ce dernier accepte les valeurs suivantes :
addset, append ou merge.appendeditedit*edit, la chaîne de l'en-tête correspondant au modèle ne
sera recherchée et remplacée qu'une seule fois, alors qu'avec
edit*, elle le sera pour chacune de ses instances si
elle apparaît plusieurs fois.mergesetsetifemptyunsetCet argument est suivi d'un nom d'en-tête qui peut se terminer
par un caractère ':', mais ce n'est pas obligatoire. La casse est
ignorée. Avec set, append,
merge et add, une valeur est
fournie en troisième argument. Si une valeur contient des
espaces, elle doit être entourée de guillemets. Avec
unset, aucune valeur ne doit apparaître.
valeur peut être une chaîne de caractères, une chaîne
contenant des spécificateurs de format, ou une combinaison des deux.
Les spécificateurs de format supportés sont les mêmes que ceux de la
directive Header, à
laquelle vous pouvez vous reporter pour plus de détails. Avec
edit, les deux arguments valeur et
remplacement sont obligatoires, et correspondent
respectivement à une expression
rationnelle et à une chaîne de remplacement.
La directive RequestHeader peut être
suivie d'un argument supplémentaire, qui pourra prendre les valeurs
suivantes :
earlyenv=[!]variablevariable existe. Un ! devant
variable inverse le test, et la directive ne
s'appliquera alors que si variable n'est pas définie.expr=expressionExcepté le cas du mode précoce, la directive
RequestHeader est traitée juste avant la
prise en compte de la requête par son gestionnaire, au cours de la
phase de vérification. Ceci permet la modification des en-têtes
générés par le navigateur, ou par les filtres en entrée
d'Apache.
Serveur HTTP Apache Version 2.4
| Description: | Recherche d'identité conformément à la RFC 1413 |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | ident_module |
| Fichier Source: | mod_ident.c |
| Compatibilité: | Disponible depuis la version 2.2 d'Apache |
Ce module interroge un démon compatible RFC 1413 sur un serveur distant afin de déterminer le propriétaire d'une connexion.
| Description: | Active la journalisation de l'identité RFC 1413 de l'utilisateur distant |
|---|---|
| Syntaxe: | IdentityCheck On|Off |
| Défaut: | IdentityCheck Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_ident |
| Compatibilité: | Retiré du serveur de base depuis Apache 2.1 |
Cette directive permet d'activer la journalisation compatible RFC 1413 du nom de
l'utilisateur distant pour chaque connexion, si la machine du client
exécute identd ou un démon similaire. Cette information est
enregistrée dans le journal des accès en utilisant la chaîne de formatage
%...l.
Notez que de sérieux problèmes de délais peuvent survenir lors
des accès à votre serveur, car chaque requête nécessite l'exécution
d'un de ces processus de recherche. Lorsque des pare-feu ou des
serveurs mandataires sont impliqués, chaque recherche est
susceptible d'échouer et ajouter un temps de latence conformément
à la directive IdentityCheckTimeout. En général, ces
recherches ne se révèlent donc pas très utiles sur des serveurs
publics accessibles depuis l'Internet.
| Description: | Détermine le délai d'attente pour les requêtes ident |
|---|---|
| Syntaxe: | IdentityCheckTimeout secondes |
| Défaut: | IdentityCheckTimeout 30 |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_ident |
Cette directive permet de spécifier le délai d'attente d'une requête ident. Une valeur par défaut de 30 secondes est recommandée par la RFC 1413, principalement pour prévenir les problèmes qui pourraient être induits par la charge du réseau. Vous pouvez cependant ajuster la valeur de ce délai en fonction du débit de votre réseau local.
Serveur HTTP Apache Version 2.4
| Description: | Affiche une présentation complète de la configuration du serveur |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | info_module |
| Fichier Source: | mod_info.c |
Pour activer mod_info, ajoutez les lignes
suivantes à votre fichier httpd.conf.
<Location "/server-info">
SetHandler server-info
</Location>
Il est recommandé d'utiliser mod_authz_host à
l'intérieur de la section <Location> afin de restreindre l'accès aux
informations de configuration de votre serveur :
<Location "/server-info">
SetHandler server-info
Require host example.com
</Location>
Une fois cette configuration effectuée, les informations du
serveur sont disponibles à l'adresse
http://votre-serveur.com/infos-serveur.
Problèmes liés à la sécurité Filtrage des informations affichées Affichage de la configuration au démarrage Limitations connuesUne fois mod_info chargé dans le serveur, sa
fonctionnalité de gestionnaire est disponible dans tous les
fichiers de configuration, y compris les fichiers de configuration
des répertoires (par exemple .htaccess). Ceci peut
avoir des répercutions en matière de sécurité pour votre site.
En particulier, l'utilisation de ce module peut conduire à la divulgation d'informations sensibles à partir des directives de configuration d'autres modules Apache comme des chemins systèmes, des couples nom d'utilisateur/mot de passe, des noms de bases de données, etc... C'est pourquoi ce module ne doit être utilisé que dans un environnement sous contrôle et toujours avec les plus grandes précautions.
Il est recommandé d'utiliser mod_authz_host pour
restreindre l'accès aux informations de configuration de votre
serveur.
<Location "/server-info">
SetHandler server-info
# Autorisation d'accès depuis le serveur lui-même
Require ip 127.0.0.1
# Autorisation d'accès depuis une station de travail du réseau
# local
Require ip 192.168.1.17
</Location>
Par défaut, les informations affichées comprennent une liste de tous les modules activés, et pour chaque module, une description des directives qu'il accepte, les branchements (hooks) qu'il implémente, ainsi que les directives concernées dans la configuration courante.
Il est possible d'afficher d'autres vues de la configuration en
ajoutant un argument à la requête infos-serveur. Par
exemple, http://votre-serveur.com/infos-serveur?config
affichera toutes les directives de configuration.
?<module-name>?config?hooks?list?server?providersSi la directive de configuration define
-DDUMP_CONFIG est utilisée, mod_info va
envoyer la configuration préinterprétée vers stdout au
cours du démarrage du serveur.
httpd -DDUMP_CONFIG -k start
"Préinterprétée" signifie que
les directives telles que <IfDefine> et <IfModule> sont évaluées et les variables
d'environnement remplacées par leurs valeurs. Cela ne représente
cependant pas la configuration définitive. En particulier, les
fusions ou écrasementsde définitions en cas de directives multiples ne sont pas
représentés.
Le résultat est équivalent à celui de la requête
?config.
mod_info tire ses informations de
la configuration interprétée, et non du fichier de configuration
original. La manière dont l'arbre de configuration interprété est
créé induit quelques limitations :
ServerRoot, LoadModule et LoadFile.Include,
<IfModule> et
<IfDefine> ne
sont pas prises en compte, mais les directives de configuration
incluses le sont..htaccess ne sont pas prises en compte (car elles ne
font pas partie de la configuration permanente du serveur).<Directory> sont affichées
normalement, mais mod_info est incapable de
déterminer le numéro de ligne de la balise fermante
</Directory>.| Description: | Ajoute des données supplémentaires aux informations de module affichées par le gestionnaire server-info |
|---|---|
| Syntaxe: | AddModuleInfo nom-module chaîne |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_info |
Cette directive permet d'afficher le contenu de chaîne en tant qu'Information supplémentaire interprétée en HTML pour le module nom-module. Exemple :
AddModuleInfo mod_deflate.c 'See <a \
href="http://httpd.apache.org/docs/2.4/mod/mod_deflate.html">\
http://httpd.apache.org/docs/2.4/mod/mod_deflate.html</a>'
Serveur HTTP Apache Version 2.4
| Description: | Un simple serveur d'écho pour illustrer les modules de protocole |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | echo_module |
| Fichier Source: | mod_echo.c |
Ce module est un module de protocole exemple permettant d'en illustrer le concept. Il fournit un simple serveur d'écho. Envoyez lui une phrase par telnet, et il vous la renverra.
| Description: | Active ou désactive le serveur d'écho |
|---|---|
| Syntaxe: | ProtocolEcho On|Off |
| Défaut: | ProtocolEcho Off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Expérimental |
| Module: | mod_echo |
La directive ProtocolEcho permet d'activer
ou de désactiver le serveur d'écho.
ProtocolEcho On
Serveur HTTP Apache Version 2.4
| Description: | Génération des en-têtes HTTP Expires et
Cache-Control en fonction de critères spécifiés par
l'utilisateur |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | expires_module |
| Fichier Source: | mod_expires.c |
Ce module permet de contrôler la définition de l'en-tête HTTP
Expires et la directive max-age de
l'en-tête HTTP Cache-Control dans les réponses du
serveur. La date d'expiration peut être définie soit par rapport à
la date de dernière modification du fichier source, soit
par rapport à l'heure d'accès du client.
Ces en-têtes HTTP permettent d'informer le client quant à la validité et à la persistence du document. S'il est présent dans le cache, et tant qu'il n'est pas arrivé à expiration, le document sera servi à partir de ce dernier, plutôt qu'à partir du document source. Après expiration, la copie du document dans le cache sera considérée comme "expirée" et donc invalide, et une nouvelle copie devra être obtenue à partir du document source.
Pour modifier les directives de contrôle du cache autres
que max-age (voir la RFC
2616 section 14.9), vous pouvez utiliser la directive Header.
Lorsque l'en-tête Expires est déjà présent dans la
réponse générée par le serveur, par exemple s'il a été créé par un
script CGI ou un serveur original via un serveur mandataire, ce
module n'ajoute aucun en-tête Expires ou
Cache-Control.
Pour une syntaxe plus lisible, on peut aussi utiliser les
directives ExpiresDefault et ExpiresByType comme suit :
ExpiresDefault "base [plus num type] [num type] ..." ExpiresByType type/encoding "base [plus num type] [num type] ..."
où base peut être :
accessnow (équivalent à
'access')modificationLe mot-clé plus est optionnel. num doit
correspondre à une valeur entière [compatible avec
atoi()], et type peut être choisi parmi :
yearsmonthsweeksdayshoursminutessecondsPar exemple, pour faire expirer par défaut les documents 1 mois après leur accès, on peut utiliser une des directives suivantes :
ExpiresDefault "access plus 1 month" ExpiresDefault "access plus 4 weeks" ExpiresDefault "access plus 30 days"
La date d'expiration peut être définie plus précisément en ajoutant plusieurs clauses 'num type' :
ExpiresByType text/html "access plus 1 month 15 days 2 hours" ExpiresByType image/gif "modification plus 5 hours 3 minutes"
Notez que si vous utilisez une configuration basée sur la date de modification, l'en-tête Expires ne sera pas ajouté à un contenu qui ne provient pas directement d'un fichier sur disque ; et ceci tout simplement parce que ce type de contenu ne possède pas de date de modification.
| Description: | Active la génération d'en-têtes
Expires |
|---|---|
| Syntaxe: | ExpiresActive On|Off |
| Défaut: | ExpiresActive Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Extension |
| Module: | mod_expires |
Cette directive permet d'activer ou de désactiver la génération
des en-têtes Expires et Cache-Control pour
les documents concernés ; en d'autres termes, si cette directive se
trouve dans un fichier .htaccess, par exemple, elle ne
s'applique qu'aux documents générés à partir du répertoire
considéré. Si elle est définie à Off, les en-têtes ne
seront générés pour aucun document du domaine considéré (sauf
surcharge de la configuration à un niveau inférieur, comme un
fichier .htaccess qui l'emporterait sur le fichier de
configuration du serveur). Si elle est définie à On,
les en-têtes seront ajoutés aux documents servis en fonction des
critères définis par les directives ExpiresByType et ExpiresDefault (voir plus
loin).
Notez que cette directive ne permet pas de garantir qu'un en-tête
Expires ou Cache-Control sera généré. Si
les critères ne sont pas respectés, aucun en-tête ne sera généré, et
la directive produira le même effet que si elle n'avait pas été
définie.
| Description: | Définition de la valeur de l'en-tête Expires
en fonction du type MIME |
|---|---|
| Syntaxe: | ExpiresByType type MIME
<code>secondes |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Extension |
| Module: | mod_expires |
Cette directive permet de définir la valeur de l'en-tête
Expires et de la directive max-age de
l'en-tête Cache-Control générés pour les documents du
type MIME spécifié (par exemple, text/html). Le second
argument définit le nombre de secondes qui seront ajoutées à un
temps de base pour calculer la date d'expiration.
Cache-Control: max-age se calcule en soustrayant la
date de la requête de la date d'expiration et s'exprime en
secondes.
Le champ <code> permet de spécifier
quel temps doit être utilisé comme temps de base; M
signifie que c'est la date
de dernière modification du fichier qui doit être utilisée comme
temps de base, alors que A signifie que c'est le moment
où le client a accédé au document qui doit être utilisé comme temps
de base.
La différence d'effet est subtile. Si on utilise M,
toutes les copies existantes du document dans tous les caches
expireront au même moment, ce qui peut convenir par exemple pour une
notice hebdomadaire qui correspond toujours à la même URL. Si on
utilise A, la date d'expiration sera différente pour
chaque client, ce qui peut convenir pour des fichiers d'images qui
ne changent pas très souvent, et en particulier pour un ensemble de
documents en relation qui se réfèrent tous aux mêmes images (ces
images sont alors accédées de manière répétitive dans un intervalle
de temps assez court).
# active la génération des en-têtes Expires ExpiresActive On # les images GIF expirent au bout d'un mois dans le cache du # client ExpiresByType image/gif A2592000 # les documents HTML restent valables une semaine après leur date # de dernière modification ExpiresByType text/html M604800
Notez que cette directive ne produit d'effet que si
ExpiresActive On a été spécifié. Elle l'emporte, mais
seulement pour le type MIME spécifié, sur toute date
d'expiration définie par la directive ExpiresDefault.
Vous pouvez aussi définir le mode de calcul de la date d'expiration en utilisant une syntaxe alternative, comme décrit plus haut dans ce document.
| Description: | Mode de calcul par défaut de la date d'expiration |
|---|---|
| Syntaxe: | ExpiresDefault <code>secondes |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Extension |
| Module: | mod_expires |
Cette directive permet de définir le mode de calcul par défaut de
la date d'expiration pour tous les documents du domaine considéré.
Elle peut être annulée pour certains types de documents par la
directive ExpiresByType. Voir la description
de cette dernière directive pour plus de détails à propos de la
syntaxe de l'argument, ainsi que la description de la syntaxe alternative.
Serveur HTTP Apache Version 2.4
| Description: | Module de configuration de filtre intelligent sensible au contexte |
|---|---|
| Statut: | Base |
| Identificateur de Module: | filter_module |
| Fichier Source: | mod_filter.c |
| Compatibilité: | Versions 2.1 et supérieures |
Ce module permet une configuration intelligente et dépendant du contexte des filtres de contenu en sortie. Par exemple, Apache peut être configuré pour faire traiter différents types de contenus par différents filtres, même lorsque le type de contenu n'est pas connu à l'avance (par exemple dans un serveur mandataire).
Le fonctionnement de mod_filter consiste à
introduire des branchements dans la chaîne de filtrage. Plutôt que
d'insérer directement des filtres dans la chaîne, on insère un
sélecteur de filtre qui va effectuer un branchement conditionnel
vers un fournisseur de filtre. mod_filter peut
utiliser tout filtre de contenu comme fournisseur ; aucune
modification des modules de filtrage existants n'est nécessaire
(bien qu'il soit tout de même possible de les simplifier).
Filtrage intelligent Déclarations de filtres, fournisseurs et
chaînes Configuration de la chaîne de
filtrage Filtrage et statut de la réponse Mise à jour depuis une configuration du
serveur HTTP Apache 2.2 Exemples Gestion de protocoleDans le modèle de filtrage traditionnel, les filtres sont insérés
sans condition à l'aide de la directive AddOutputFilter et des directives
apparentées. Chaque filtre doit ensuite déterminer s'il doit
s'exécuter ou non, et les administrateurs du serveur disposent de
peu de souplesse pour faire en sorte que la chaîne soit traitée de
manière dynamique.
mod_filter, à l'opposé, fournit aux
administrateurs du serveur un grand degré de souplesse pour
configurer la chaîne de filtrage. Concrètement, la décision
d'insérer un filtre peut être prise en fonction d'une expression booléenne complexe. Ceci
généralise le fonctionnement relativement souple de la directive
AddOutputFilterByType.
![[Cette image illustre le modèle de filtrage traditionnel]](../images/mod_filter_old.gif)
Figure 1: Le modèle de filtrage traditionnel
Dans le modèle traditionnel, les filtres en sortie constituent une simple chaîne s'étendant depuis le générateur de contenu (ou gestionnaire) jusqu'au client. Ce fonctionnement peut convenir s'il permet d'atteindre le but recherché, mais pose problème lorsque cette chaîne doit être configurée dynamiquement en fonction de la sortie du gestionnaire.
![[Cette image illustre le modèle de fonctionnement de mod_filter]](../images/mod_filter_new.gif)
Figure 2: Le modèle de fonctionnement de
mod_filter
Le fonctionnement de mod_filter consiste à
introduire des branchements dans la chaîne de filtrage. Plutôt que
d'insérer directement des filtres dans la chaîne, on insère un
sélecteur de filtre qui va effectuer un branchement conditionnel
vers un fournisseur de filtre. mod_filter peut
utiliser tout filtre de contenu comme fournisseur ; aucune
modification des modules de filtrage existants n'est nécessaire
(bien qu'il soit tout de même possible de les simplifier). Il peut y
avoir plusieurs fournisseurs pour un seul filtre, mais un seul
fournisseur sera choisi pour chaque requête.
Une chaîne de filtrage peut comporter autant d'instances du sélecteur de filtre que l'on souhaite, chacune d'entre elles pouvant disposer de plusieurs fournisseurs. Un sélecteur de filtre possédant un seul fournisseur dont le choix est inconditionnel constitue un cas particulier : cette situation est équivalente à l'insertion directe du filtre dans la chaîne.
Trois étapes sont nécessaires pour configurer une chaîne de
filtrage avec mod_filter. Voir ci-dessous la
description détaillée des directives.
FilterDeclare permet de déclarer un
filtre en lui assignant un nom et un type. Elle n'est obligatoire
que si le filtre n'est pas du type par défaut
AP_FTYPE_RESOURCE.FilterProvider permet d'associer un
fournisseur à un filtre. Le filtre a été éventuellement déclaré à
l'aide de la directive FilterDeclare ; si ce n'est pas le cas, FilterProvider
va le déclarer implicitement avec le type par défaut
AP_FTYPE_RESOURCE. Le fournisseur doit avoir été enregistré à
l'aide de ap_register_output_filter par un module
quelconque. Le dernier argument de la directive FilterProvider est une expression :
le fournisseur s'exécutera pour une requête si et seulement si
l'expression est évaluée vraie. L'expression peut évaluer une
requête HTTP ou les en-têtes de la réponse, des variables
d'environnement, ou le gestionnaire utilisé par cette requête. À la
différence des version précédentes, mod_filter supporte désormais
les expressions complexes associant des critères multiples au moyen
d'une logique AND / OR (&& / ||) et de parenthèses. Pour les
détails sur la syntaxe de l'expression, voir la documentation sur ap_expr.FilterChain élabore une chaîne de filtrage à
partir de filtres intelligents déclarés, permettant avec souplesse
d'insérer des filtres au début ou à la fin de la chaîne, de
supprimer un filtre ou même la chaîne complète.Normalement, mod_filter n'applique les filtres qu'aux réponses
possédant un statut HTTP 200 (OK). Pour pouvoir filtrer des
documents possédant un autre statut, vous devez définir la variable
d'environnement filter-errordocs, les réponses étant
alors filtrées sans se préoccuper de leur statut. Pour définir ce
comportement de manière plus fine, vous pouvez utiliser des
conditions dans la directive
FilterProvider.
La directive FilterProvider a été modifiée par
rapport à httpd 2.2 : les arguments match et
dispatch ont été remplacés par l'argument unique
expression plus polyvalent. En général, il est possible
de convertir une paire match/dispatch vers les deux côtés d'une
expression, de la manière suivante :
"dispatch = 'match'"
Les en-têtes de requête et de réponse et les variables d'environnement sont maintenant interprétés selon les syntaxes respectives %{req:foo}, %{resp:foo} et %{env:foo}. Les variables %{HANDLER} et %{CONTENT_TYPE} sont également supportées.
Notez que l'évaluation de l'expression ne supporte plus les comparaisons de sous-chaînes. Ces dernières peuvent être remplacées par des comparaisons d'expressions rationnelles.
AddOutputFilterByType
FilterDeclare SSI
FilterProvider SSI INCLUDES "%{CONTENT_TYPE} =~ m|^text/html|"
FilterChain SSI
FilterProvider SSI INCLUDES "%{HANDLER} = 'server-parsed'"
FilterChain SSI
FilterDeclare gzip CONTENT_SET
FilterProvider gzip inflate "%{req:Accept-Encoding} !~ /gzip/"
FilterChain gzip
FilterProvider unpack jpeg_unpack "%{CONTENT_TYPE} = 'image/jpeg'"
FilterProvider unpack gif_unpack "%{CONTENT_TYPE} = 'image/gif'"
FilterProvider unpack png_unpack "%{CONTENT_TYPE} = 'image/png'"
FilterProvider downsample downsample_filter "%{CONTENT_TYPE} = m|^image/(jpeg|gif|png)|"
FilterProtocol downsample "change=yes"
FilterProvider repack jpeg_pack "%{CONTENT_TYPE} = 'image/jpeg'"
FilterProvider repack gif_pack "%{CONTENT_TYPE} = 'image/gif'"
FilterProvider repack png_pack "%{CONTENT_TYPE} = 'image/png'"
<Location "/image-filter">
FilterChain unpack downsample repack
</Location>
Historiquement, tout filtre doit s'assurer que toute modification qu'il effectue est correctement représentée dans les en-têtes de la réponse HTTP, et qu'il ne s'exécutera pas si cette exécution résultait en une modification interdite. Ceci impose aux auteurs de filtres la corvée de réimplémenter certaines fonctionnalités communes dans chaque filtre :
Cache-Control: no-transform éventuel.mod_filter a pour but de gérer de manière
générale ces détails de l'implémentation des filtres, réduisant par
là-même la complexité des modules de filtrage de contenu. Le
travail permettant d'atteindre ce but est cependant toujours en
cours ; la directive FilterProtocol
implémente certaines de ces fonctionnalités à des fins de
compatibilité ascendante avec les modules d'Apache 2.0. Pour les
versions 2.1 et supérieures de httpd, les API
ap_register_output_filter_protocol et
ap_filter_protocol permettent aux modules de filtrage
de définir leurs propres comportements.
Cependant, mod_filter ne doit pas interférer
avec un filtre qui gère déjà tous les aspects du protocole. Par
défaut (c'est à dire en l'absence de toute directive FilterProtocol),
mod_filter ne modifiera donc pas les en-têtes.
Au moment où ces lignes sont écrites, cette fonctionnalité a été très peu testée, car les modules d'usage courant ont été conçus pour fonctionner avec httpd 2.0. Les modules qui l'utilisent devront donc l'expérimenter avec précautions.
| Description: | assigne un filtre en sortie pour un type de média particulier |
|---|---|
| Syntaxe: | AddOutputFilterByType filtre[;filtre...]
type_de_média [type_de_média] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_filter |
| Compatibilité: | Présentait de sévères limitations avant d'être déplacé dans
mod_filter dans la version 2.3.7 |
Cette directive active un filtre en sortie particulier pour une requête en fonction du type de média de la réponse.
L'exemple suivant active le filtre DEFLATE qui est
fourni par le module mod_deflate. Il va compresser
toute sortie dont le type MIME est text/html ou
text/plain avant de l'envoyer au client.
AddOutputFilterByType DEFLATE text/html text/plain
Si vous voulez assigner plusieurs filtres au contenu, leurs noms
doivent être séparés par des points-virgules. On peut aussi utiliser
une directive AddOutputFilterByType pour
chacun des filtres à assigner.
La configuration ci-dessous impose le traitement de toute sortie
de script dont le type MIME est text/html en premier
lieu par le filtre INCLUDES, puis par le filtre
DEFLATE.
<Location "/cgi-bin/">
Options Includes
AddOutputFilterByType INCLUDES;DEFLATE text/html
</Location>
| Description: | Configure la chaîne de filtrage |
|---|---|
| Syntaxe: | FilterChain [+=-@!]nom_filtre ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Base |
| Module: | mod_filter |
Cette directive permet de configurer une chaîne de filtrage
composée de filtres déclarés. FilterChain
accepte un nombre illimité d'arguments, chacun d'entre eux étant
précédé d'un caractère de contrôle unique qui détermine l'action à
entreprendre :
+nom filtre@nom filtre-nom filtre=nom filtre!nom filtre+nom filtre| Description: | Déclare un filtre intelligent |
|---|---|
| Syntaxe: | FilterDeclare nom_filtre [type] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Base |
| Module: | mod_filter |
Cette directive permet de déclarer un filtre en sortie associé à
un en-tête ou une variable d'environnement qui déterminera les
conditions de son exécution. Le premier argument est le nom du
filtre destiné à être utilisé dans les directives FilterProvider, FilterChain et FilterProtocol.
Le dernier argument (optionnel) est le type du filtre, et peut
prendre les valeurs de ap_filter_type, à savoir
RESOURCE (valeur par défaut), CONTENT_SET,
PROTOCOL, TRANSCODE,
CONNECTION ou NETWORK.
| Description: | Vérifie le respect du protocole HTTP |
|---|---|
| Syntaxe: | FilterProtocol nom_filtre [nom_fournisseur]
drapeaux_protocole |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Base |
| Module: | mod_filter |
Cette directive permet à mod_filter de s'assurer
qu'un filtre ne s'exécutera pas s'il ne doit pas le faire, et que
les en-têtes de la réponse HTTP sont définis correctement en tenant
compte des effets du filtre.
Cette directive se présente sous deux formes. Avec trois arguments, elle s'applique de manière spécifique à un nom filtre et un nom fournisseur pour ce filtre. Avec deux arguments, elle s'applique à un nom filtre pour tout fournisseur qu'il actionne.
Les drapeaux spécifiés sont fusionnés avec les drapeaux que les
fournisseurs sous-jacents ont éventuellement enregistrés avec
mod_filter. Par exemple, un filtre peut avoir
spécifié en interne un drapeau équivalent à change=yes,
mais une configuration particulière du module peut le surcharger
en spécifiant change=no.
drapeaux_protocole peut contenir un ou plusieurs drapeaux parmi les suivants :
change=yes|nochange=1:1byteranges=noproxy=noproxy=transformCache-Control: no-transformcache=no| Description: | Enregistre un filtre de contenu |
|---|---|
| Syntaxe: | FilterProvider nom_filtre nom_fournisseur
expression |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Base |
| Module: | mod_filter |
Cette directive permet d'associer un fournisseur au filtre intelligent. Le fournisseur sera invoqué si et seulement si l'expression est évaluée vraie lorsque le sélecteur de filtre est appelé pour la première fois.
nom fournisseur doit avoir été enregistré au cours du
chargement d'un module à l'aide de
ap_register_output_filter.
expression est une expression ap_expr.
mod_include| Description: | Obtention d'informations de débogage/diagnostique en
provenance de mod_filter |
|---|---|
| Syntaxe: | FilterTrace nom_filtre niveau |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_filter |
Cette directive permet d'obtenir des informations de débogage en
provenance de mod_filter. Elle est conçue pour
aider à tester et déboguer les fournisseurs (ou modules de filtrage)
; elle peut aussi apporter une aide à l'utilisation de
mod_filter lui-même.
La sortie de débogage dépend de la définition d'argument level :
0 (valeur par défaut)1mod_filter va enregistrer les ensembles de
conteneurs de données (buckets and brigades) qui traversent le
filtre dans le journal des erreurs, avant que le fournisseur ne les
traite. Ces informations sont similaires à celles générées par mod_diagnostics.
2 (pas encore implémenté)Serveur HTTP Apache Version 2.4
| Description: | Moniteur centralisé pour les serveurs d'origine mod_heartbeat |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | heartmonitor_module |
| Fichier Source: | mod_heartmonitor.c |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache |
mod_heartmonitor interprète les messages d'état générés
par les serveurs d'origine pour lesquels mod_heartbeat est activé et
fournit ces informations à mod_lbmethod_heartbeat, ce
qui permet d'utiliser la lbmethod "heartbeat" au sein des
directives ProxyPass.
Ce module utilise les services de mod_slotmem_shm,
lorsqu'il est disponible, au lieu d'un simple fichier texte. Aucune
configuration supplémentaire n'est requise pour utiliser
mod_slotmem_shm.
mod_heartmonitor,
mod_status et mod_watchdog
doivent être soit des modules statiques, soit des modules
dynamiques, et dans ce dernier cas, ils doivent être chargés
avant mod_heartmonitor.
| Description: | Adresse multicast d'écoute des requêtes entrantes heartbeat |
|---|---|
| Syntaxe: | HeartbeatListen addr:port |
| Défaut: | disabled |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_heartmonitor |
La directive HeartbeatListen permet de
spécifier l'adresse multicast sur laquelle le serveur va surveiller les
informations d'état en provenance de serveurs où
mod_heartbeat est activé. Cette adresse correspond
en général à la valeur de la directive HeartbeatAddress sur le serveur
d'origine.
HeartbeatListen 239.0.0.1:27999
Tant que cette directive n'est pas utilisée, le module est désactivé.
| Description: | Spécifie le nombre maximal de serveurs qui pourront envoyer des requêtes heartbeat à ce serveur. |
|---|---|
| Syntaxe: | HeartbeatMaxServers nombre-de-serveurs |
| Défaut: | HeartbeatMaxServers 10 |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_heartmonitor |
| Compatibilité: | La valeur 0 est prise en charge à partir de la version 2.4.55 du serveur HTTP Apache |
La directive HeartbeatMaxServers
spécifie le nombre maximal de serveurs qui pourront envoyer des
requêtes heartbeat à ce serveur de monitoring. Elle permet ainsi de
contrôler la quantité de mémoire partagée allouée pour le stockage
des données heartbeat lorsqu'on utilise
mod_slotmem_shm.
Pour utiliser un stockage de type fichier bidimensionnel (flat-file)
lorque le module mod_slotmem_shm n'est pas chargé, cette
directive doit être définie à 0. La valeur doit être soit égale à 0, soit
supérieure ou égale à 10.
| Description: | Chemin vers le stockage des données heartbeat lorsqu'on utilise un fichier bidimensionnel (flat-file) |
|---|---|
| Syntaxe: | HeartbeatStorage chemin fichier |
| Défaut: | HeartbeatStorage logs/hb.dat |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_heartmonitor |
La directive HeartbeatStorage permet de spécifier
le chemin de stockage des données heartbeat. Ce fichier bidimensionnel n'est
utilisé que si mod_slotmem_shm n'est pas chargé et si la
directive HeartbeatMaxServers
est définie à 0.
Serveur HTTP Apache Version 2.4
| Description: | Documents html interprétés par le serveur (Server Side Includes ou SSI) |
|---|---|
| Statut: | Base |
| Identificateur de Module: | include_module |
| Fichier Source: | mod_include.c |
Ce module fournit un filtre qui va traiter les fichiers avant de les envoyer au client. Le traitement est contrôlé via des commentaires SGML spécialement formatés, aussi nommés éléments. Ces éléments permettent l'insertion conditionnelle de texte, l'inclusion d'autres fichiers ou programmes, ainsi que la définition et l'affichage de variables d'environnement.
Activation des SSI PATH_INFO et SSI Eléments disponibles Variables include Substitution de variable Eléments de contrôle d'inclusion conditionnelle Syntaxe des expressions héritée SSIEndTag SSIErrorMsg SSIETag SSILastModified SSILegacyExprParser SSIStartTag SSITimeFormat SSIUndefinedEcho XBitHackLes SSI sont implémentés par le filtre INCLUDES. Si des
documents contenant des directives SSI possèdent une extension
.shtml, les directives suivantes indiqueront à Apache de les
interpréter et d'assigner le type MIME
text/html au document obtenu :
AddType text/html .shtml AddOutputFilter INCLUDES .shtml
L'option suivante doit être définie pour les répertoires qui
contiennent les fichiers shtml (en général dans une section
<Directory>, mais
cette option peut également être définie dans un fichier
.htaccess si AllowOverride Options
Options +Includes
Pour des raisons de compatibilité ascendante, le gestionnaire server-parsed
peut aussi activer le filtre INCLUDES. Ainsi, Apache va activer le
filtre INCLUDES pour tout document de type MIME
text/x-server-parsed-html ou
text/x-server-parsed-html3 (et le document obtenu aura
pour type MIME text/html).
Pour plus d'informations, voyez notre Tutoriel SSI.
Les fichiers traités dans le cadre des SSI n'acceptent plus par
défaut les requêtes avec PATH_INFO (les informations
relatives au chemin en fin de requête). La directive AcceptPathInfo permet de configurer le
serveur de façon à ce qu'il accepte ce genre de requête.
Le document est interprété comme un document HTML, avec des commandes spéciales incluses sous forme de commentaires SGML. La syntaxe d'une commande est la suivante :
<!--#élément attribut=valeur
attribut=valeur ... -->
Les valeurs sont souvent entourées de guillemets, mais on peut
aussi utiliser des apostrophes (') ou des apostrophes
inverses (`). De nombreuses commandes n'acceptent
qu'une seule paire attribut-valeur. Notez que le terminateur de
commentaire (-->) doit être précédé d'un espace afin
d'être sûr qu'il ne soit pas considéré comme un élément de commande
SSI. Notez aussi que le délimiteur de début <!--#
est un élément de commande et ne doit donc pas contenir
d'espace.
La table suivante contient la liste des éléments autorisés :
| Elément | Description |
|---|---|
comment |
commentaire SSI |
config |
configure les formats de sortie |
echo |
affiche le contenu de variables |
exec |
exécute des programmes externes |
fsize |
affiche la taille d'un fichier |
flastmod |
affiche la date de dernière modification d'un fichier |
include |
inclut un fichier |
printenv |
affiche toutes les variables disponibles |
set |
définit la valeur d'une variable |
Les éléments SSI peuvent être définis par d'autres modules que
mod_include. À ce titre, l'élément exec est fourni par
mod_cgi, et ne sera disponible que si ce module est
chargé.
Cette commande n'affiche aucune information. Elle n'a pour but que l'ajout de commentaires dans un fichier et ces commentaires ne sont pas affichés.
Cette syntaxe est disponible à partir de la version 2.4.21 du serveur HTTP Apache.
<!--#comment Blah Blah Blah -->
or
<!--#comment text="Blah Blah Blah" -->
Cette commande contrôle divers aspects de l'interprétation. Les attributs valides sont :
echomsg (Versions 2.1 et supérieures
d'Apache)La valeur est un message qui sera envoyé au client si
l'élément echo tente
d'afficher le contenu d'une variable non définie. Cet attribut
l'emporte sur toute directive SSIUndefinedEcho.
<!--#config echomsg="[Valeur non définie]" -->
errmsgLa valeur est un message qui sera envoyé au client si une
erreur survient lors de l'interprétation du document. Cet attribut
l'emporte sur toute directive SSIErrorMsg.
<!--#config errmsg="[Zut, quelque chose s'est mal passé.]" -->
sizefmtLa valeur définit l'unité employée lors de l'affichage de la
taille d'un fichier. Les valeurs possibles sont bytes
pour une taille en octets, ou abbrev pour une taille
en Ko ou Mo selon son importance ; par exemple, une taille de 1024
octets sera affichée sous la forme "1K".
<!--#config sizefmt="abbrev" -->
timefmtLa valeur est une chaîne que pourra utiliser la fonction de la
bibliothèque standard strftime(3) lors de l'affichage
des dates.
<!--#config timefmt=""%R, %B %d, %Y"" -->
Cette commande affiche le contenu d'une des variables include définies ci-dessous. Si
la variable n'est pas définie, le résultat est déterminé par la
valeur de la directive SSIUndefinedEcho. Le format d'affichage des dates est
défini par l'attribut timefmt de la commande
config.
Attributs:
vardecodingSpécifie si Apache doit effectuer un décodage dans la
variable avant son traitement ultérieur. La valeur par défaut est
none, et dans ce cas, aucun décodage n'est effectué.
Si la valeur est url, un décodage de type URL sera
effectué (il s'agit du codage de type %-encoding utilisé dans les
URLs des liens, etc...). Si la valeur est urlencoded,
c'est un décodage des éléments de type
application/x-www-form-urlencode (que l'on trouve dans les chaînes
de paramètres) qui sera effectué. Si la valeur est
base64, un
decodage de type base64 sera effectué, et si elle est
entity, c'est un décodage des entités HTML qui sera
effectué. Ce décodage est effectué avant tout codage ultérieur de
la variable. Il est possible d'effectuer plusieurs décodages en
spécifiant plusieurs valeurs séparées par des virgules. Les
spécifications de décodages restent valables jusqu'au prochain
attribut de décodage, ou la fin de l'élément.
Pour être pris en compte, l'attribut de décodage
doit précéder l'attribut var correspondant.
encodingSpécifie la manière dont Apache va coder les caractères
spéciaux que la variable contient avant leur affichage. S'il est
défini à none, aucun codage ne sera effectué. S'il
est défini à url, un codage de type URL sera effectué
(aussi connu sous le nom de codage avec caractères % , il convient
pour les URLS des liens, etc...). S'il est défini à
urlencoded, c'est un codage compatible
application/x-www-form-urlencoded qui sera effectué (à utiliser
dans les chaînes de paramètres). S'il est défini à
base64, c'est un encodage de type base64 qui sera
effectué. Au début d'un élément
echo, la valeur par défaut est définie à
entity, ce qui correspond à un codage de type entité
(codage qui convient pour un élément HTML de type bloc, comme le
paragraphe d'un texte). Cette valeur par défaut peut être modifiée
en ajoutant un attribut encoding, qui fera effet
jusqu'à la définition d'un nouvel attribut encoding
ou la fin de l'élément echo.
Pour produire son effet, l'attribut encoding doit
précéder l'attribut var concerné.
<!--#echo encoding="entity" var="QUERY_STRING" -->
La commande exec exécute la commande shell ou le
script spécifié. Elle nécessite le chargement du module
mod_cgi. Si Options IncludesNOEXEC est
définie, cette commande est désactivée. Les attributs disponibles
sont :
cgiLa valeur spécifie un chemin URL vers le script CGI (encodé
avec caractères %). Si le chemin ne commence pas par un slash (/),
il est considéré comme relatif au document courant. Le document
référencé par ce chemin est invoqué en tant que script CGI, même
s'il n'est pas censé être reconnu comme tel par le serveur. Les
scripts CGI doivent cependant être activés dans le répertoire qui
contient les scripts (via la directive ScriptAlias ou l'Options ExecCGI).
Le PATH_INFO et la chaîne d'arguments
(QUERY_STRING) de la requête originale du client sont
fournis au script CGI ; ils ne peuvent pas être spécifiés
dans le chemin de l'URL. Le script disposera des variables include
en plus de l'environnement standard CGI.
<!--#exec cgi="/cgi-bin/exemple.cgi" -->
Si, à la place d'un flux de sortie, le script renvoie un
en-tête Location:, ce dernier sera traduit en ancrage
HTML.
L'élément include
virtual doit être préféré à exec cgi. En
particulier, si vous devez transmettre des arguments
supplémentaires à un programme CGI en utilisant la chaîne
d'arguments de la requête, c'est impossible avec exec
cgi, mais vous pouvez y parvenir avec include
virtual comme suit :
<!--#include virtual="/cgi-bin/exemple.cgi?argument=valeur" -->
cmdLe serveur va exécuter la commande fournie en utilisant
/bin/sh. La commande dispose des variables include, en plus du jeu habituel
de variables CGI.
Il est toujours préférable d'utiliser #include virtual à la place de
#exec cgi ou #exec cmd. #include
virtual utilise le mécanisme standard des sous-requêtes
d'Apache pour inclure des fichiers ou des scripts. Il a fait
l'objet de tests plus approfondis et sa maintenance est mieux
suivie.
De plus, sur certaines plate-formes, comme Win32, et sous unix,
si l'on utilise suexec, il est
impossible de transmettre des arguments à une commande dans une
directive exec, à moins d'insérer des espaces dans la
commande. Ainsi, alors que ce qui suit fonctionnera sous unix avec
une configuration sans suexec, l'effet produit ne sera pas celui
désiré sous Win32, ou dans le cas de l'utilisation de suexec
:
<!--#exec cmd="perl /chemin/vers/script_perl arg1 arg2" -->
Cette commande permet d'afficher la taille du fichier spécifié
en fonction des spécifications de format de sizefmt.
Attributs :
file
Ce fichier a une taille de <!--#fsize file="mod_include.html"
--> octets.
file ne peut pas faire référence à un
fichier situé à un niveau supérieur de l'arborescence du répertoire
courant ou en dehors de la racine des documents ; il ne peut donc
ni commencer par un slash, ni contenir la séquence de caractères
../. Si c'est le cas, le message d'erreur The
given path was above the root path sera renvoyé.
virtual
Ce fichier a une taille de <!--#fsize
virtual="/docs/mod/mod_include.html" --> octets.
Notez que dans la plupart des cas, ces deux attributs sont
identiques. Cependant, l'attribut file ne respecte
pas les aliases URL-space.
Cette commande permet d'afficher la date de dernière
modification du fichier spécifié, en fonction des spécifications
de format de timefmt. Les attributs sont les mêmes
que ceux de la commande fsize.
Cette commande permet d'insérer le texte d'un autre document ou
fichier dans le fichier en cours d'interprétation. Tout fichier
inclus est soumis au contrôle d'accès habituel. Si Options IncludesNOEXEC
est défini pour le répertoire contenant le fichier
interprété, seuls les documents possèdant un
type MIME de type texte
(text/plain, text/html, etc...) seront
inclus. Les scripts CGI, quant à eux, sont invoqués de manière
habituelle en utilisant l'URL complète fournie avec la commande, y
compris toute chaîne d'arguments éventuelle.
Un attribut définit le chemin du document à inclure, et peut apparaître plusieurs fois dans l'élément à inclure ; en retour, pour chaque attribut fourni à la commande include, une inclusion est effectuée. Les attributs disponibles sont :
file../, ni être un chemin absolu. Ainsi, vous ne pouvez
pas inclure de fichiers situés en dehors de l'arborescence du
site web ou dans un niveau supérieur à celui du fichier courant
dans cette arborescence. Il est toujours préférable d'utiliser
l'attribut virtual.virtualLa valeur est un chemin URL (codé avec caractères %). L'URL ne peut contenir qu'un chemin et une chaîne d'arguments éventuelle, à l'exclusion de tout protocole ou nom d'hôte. S'il ne commence pas par un slash (/), il est considéré comme relatif au document courant.
Une URL est construite à partir de l'attribut, et la sortie que renverrait le serveur si l'URL était accédée par le client est incluse dans la sortie interprétée. Les inclusions de fichiers peuvent ainsi être imbriquées.
Si l'URL spécifiée correspond à un programme CGI, le programme sera exécuté, et son flux de sortie inséré à la place de la directive dans le fichier interprété. Vous pouvez insérer une chaîne d'arguments dans une URL correspond à un programme CGI :
<!--#include virtual="/cgi-bin/exemple.cgi?argument=valeur" -->
include virtual doit être préféré à exec
cgi pour inclure le flux de sortie d'un programme CGI dans
un document HTML.
Si la directive KeptBodySize est correctement
définie et valide pour le fichier inclus, les tentatives de
requêtes POST vers le document HTML qui inclut des fichiers seront
transmises aux sous-requêtes en tant que requêtes POST
elles-mêmes. Sans cette directive, toutes les sous-requêtes sont
traitées en tant que requêtes GET.
onerrorLa valeur est un chemin-URL (codé-%) qui est affiché si une tentative précédente d'inclure un fichier ou un attribut virtuel a échoué. Pour produire son effet, cet attribut doit être spécifié après le fichier ou les attributs virtuels concernés. Si la tentative d'inclure le chemin onerror échoue, ou si onerror n'est pas spécifié, c'est le message d'erreur par défaut qui sera inclus.
# Exemple simple
<!--#include virtual="/not-exist.html" onerror="/error.html" -->
# Chemins onerror dédiés
<!--#include virtual="/path-a.html" onerror="/error-a.html" virtual="/path-b.html" onerror="/error-b.html" -->
Cette commande affiche la liste en mode texte de toutes les variables et de
leurs valeurs. Les caractères spéciaux sont encodés entity avant
d'être affichés (se reporter à l'élément echo pour plus de détails). Cette
commande ne comporte pas d'attributs.
<pre>
<!--#printenv -->
</pre>
Cette commande permet de définir la valeur d'une variable. Les attributs sont :
varvaluedecodingSpécifie si Apache doit effectuer un décodage dans la
variable avant son traitement ultérieur. La valeur par défaut est
none, et dans ce cas, aucun décodage n'est effectué.
Si la valeur est url, urlencoded,
base64 ou
entity, c'est un décodage de type URL,
application/x-www-form-urlencoded, base64 ou
entité HTML qui sera respectivement effectué. Il est possible
d'effectuer plusieurs décodages en
spécifiant plusieurs valeurs séparées par des virgules. Les
spécifications de décodages restent valables jusqu'au prochain
attribut de décodage, ou la fin de l'élément. Pour être pris en
compte, l'attribut de décodage
doit précéder l'attribut var correspondant.
encodingSpécifie la manière dont Apache va encoder les caractères
spéciaux que la variable contient avant leur affichage. S'il est
défini à none, aucun encodage ne sera effectué. Si la
valeur est url, urlencoding,
base64 ou
entity, c'est un encodage de type URL,
application/x-www-form-urlencoded, base64 ou
entité HTML qui sera respectivement effectué. Il est possible de
spécifier plusieurs types d'encodage en les séparant par des
virgules. La spécification du type d'encodage fera effet
jusqu'à la définition d'un nouvel attribut encoding
ou la fin de l'élément. Pour produire son effet, l'attribut encoding doit
précéder l'attribut var concerné. Les encodages sont
effectués après les opérations de décodage.
<!--#set var="category" value="help" -->
À l'instar des variables de l'environnement CGI standard, ces
variables sont mises à la disposition de la commande
echo, des opérateurs conditionnels if et
elif, et de tout programme invoqué par le document.
DATE_GMTDATE_LOCALDOCUMENT_ARGSinclude, QUERY_STRING contiendra la chaîne
de paramètres de la sous-requête et DOCUMENT_ARGS la chaîne
de paramètres du document SSI (disponible à partir de la version 2.4.19 du
serveur HTTP Apache).DOCUMENT_NAMEDOCUMENT_PATH_INFOAcceptPathInfo pour plus d'informations à
propos de PATH_INFO.DOCUMENT_URIalias ou directoryindex), c'est l'URL modifiée
que contiendra la variable.LAST_MODIFIEDQUERY_STRING_UNESCAPED&,etc...
sont précédés d'anti-slashes). Cette variable n'est pas définie si aucune
chaîne d'arguments n'est présente. Utilisez DOCUMENT_ARGS si
l'échappement des caractères du shell n'est pas souhaité.USER_NAMEUne substitution de variable à l'intérieur d'une chaîne entre
guillemets s'effectue dans la plupart des situations où cette
dernière peut raisonablement constituer un argument d'une directive
SSI. Sont concernées les directives config,
exec, flastmod, fsize,
include, echo, et set. Si la
directive SSILegacyExprParser est définie à
on, la substitution s'effectue aussi dans les arguments
des opérateurs conditionnels. Vous pouvez insérer
un signe dollar en tant que caractère littéral dans une chaîne en
utilisant un anti-slash :
<!--#set var="cur" value="\$test" -->
Si une référence de variable doit être substituée au beau milieu d'une séquence de caractères qui pourrait être elle-même considérée comme un identifiant valide, l'ambiguïté peut être levée en entourant la référence d'accolades, à la manière du shell :
<!--#set var="Zed" value="${REMOTE_HOST}_${REQUEST_METHOD}" -->
Dans cet exemple, la variable Zed se verra affecter
la valeur "X_Y" si REMOTE_HOST et
REQUEST_METHOD contiennent respectivement
"X" et "Y".
Les éléments de base du contrôle d'inclusion conditionnelle sont :
<!--#if expr="test_condition" -->
<!--#elif expr="test_condition" -->
<!--#else -->
<!--#endif -->
L'élément if fonctionne de la même manière que
la directive if d'un langage de programmation. La condition est
évaluée et si le résultat est vrai, le texte qui suit jusqu'au
prochain élément elif, else ou
endif sera inclus dans le flux de sortie.
Les éléments elif ou else permettent
d'insérer du texte dans le flux de sortie si
test_condition s'est révélé faux. Ces éléments sont
optionnels.
L'élément endif termine le bloc de traitement
conditionnel if et est obligatoire.
test_condition est une expression booléenne qui
emprunte la syntaxe ap_expr. La directive
SSILegacyExprParser
permet de modifier cette syntaxe pour la rendre compatible avec
Apache HTTPD 2.2.x.
Le jeu de variables SSI avec l'élément var sont
exportées vers l'environnement de la requête et sont accessibles via
la fonction reqenv. Pour faire simple, le nom de
fonction v est aussi disponible dans le module
mod_include.
Dans l'exemple suivant, "depuis le réseau local" sera affiché si l'adresse IP du client appartient au sous-réseau 10.0.0.0/8.
<!--#if expr='-R "10.0.0.0/8"' -->
depuis le réseau local
<!--#else -->
depuis ailleurs
<!--#endif -->
Dans l'exemple suivant, "foo vaut bar" sera affiché si la variable
foo contient la valeur "bar".
<!--#if expr='v("foo") = "bar"' -->
foo vaut bar
<!--#endif -->
Voir aussi Les expressions dans le serveur
HTTP Apache pour une référence complète et des exemples. Les
fonctions restricted ne sont pas disponibles dans
mod_include.
Cette section décrit la syntaxe de l'élément #if
expr dans le cas où la directive SSILegacyExprParser est définie à
on.
chaîne-A stringvrai si l'URL que contient la chaîne est accessible du point de vue de la configuration, faux sinon. Il s'avère utile lorsqu'un lien vers une URL doit être caché aux utilisateurs qui ne sont pas autorisés à voir cette URL. Notez que le test porte sur l'autorisation d'accès à l'URL, et non sur son existence.
<!--#if expr="-A /prive" -->
Cliquez <a href="/prive">ici</a> pour accéder aux
informations privées.
<!--#endif -->
chaîne1 = chaîne2
chaîne1 == chaîne2
chaîne1 != chaîne2Compare chaîne1 à chaîne2. Si
chaîne2 est de la forme
/chaîne2/, elle est traitée comme une
expression rationnelle. Les expressions rationnelles sont
implémentées par le moteur PCRE
et possèdent la même syntaxe que celles de perl 5. Notez que ==
n'est qu'un alias pour = et se comporte exactement de
la même manière que ce dernier.
Si vous faites une comparaison directe (= ou
==), vous pouvez extraire des parties de l'expression
rationnelle. Les parties extraites sont stockées dans les
variables spéciales $1 .. $9. L'ensemble
de la chaîne correspondant à l'expression rationnelle est stocké
dans la variable spéciale $0.
<!--#if expr="$QUERY_STRING = /^sid=([a-zA-Z0-9]+)/" -->
<!--#set var="session" value="$1" -->
<!--#endif -->
chaîne1 < chaîne2
chaîne1 <= chaîne2
chaîne1 > chaîne2
chaîne1 >= chaîne2strcmp(3)). Ainsi, la chaîne "100" est inférieure à
"20".( test_condition )! test_conditiontest_condition1 &&
test_condition2test_condition1 ||
test_condition2"=" et "!=" ont une priorité supérieure
à "&&" et "||". "!" a
la priorité la plus haute. Ainsi, les deux directives suivantes sont
équivalentes :
<!--#if expr="$a = test1 && $b = test2" -->
<!--#if expr="($a = test1) && ($b = test2)" -->
Les opérateurs booléens && et
|| ont la même priorité. Ainsi, si vous voulez
augmenter la priorité d'un de ces opérateurs, vous devez utiliser
des parenthèses.
Tout ce qui n'est pas reconnu comme variable ou opérateur est
traité comme une chaîne. Les chaînes peuvent aussi être entourées
d'apostrophes : 'chaîne'. Les chaînes sans apostrophe
ne peuvent pas contenir d'espaces (espaces ou tabulations) car
ceux-ci servent à séparer certains éléments comme les variables. Si
plusieurs chaînes se trouvent dans une ligne, elles sont concaténées
en utilisant des espaces. Ainsi,
chaîne1 chaîne2 devient chaîne1 chaîne2
et
'chaîne1 chaîne2' devient chaîne1 chaîne2.
Si les expressions atteignent une complexité suffisante pour ralentir les traitements de manière significative, vous pouvez essayer de les optimiser en fonction des règles d'évaluation :
&& et
||) font l'objet d'une évaluation abrégée chaque fois
que cela est possible. En d'autres termes, et selon la règle
ci-dessus, mod_include évalue tout d'abord la
partie gauche de l'expression. Si le résultat de l'évaluation de
cette partie gauche suffit à déterminer le résultat final,
l'évaluation s'arrête ici. Dans le cas contraire, la partie droite
est évaluée, et le résultat final tient compte des résultats des
évaluations des parties gauche et droite.$1 .. $9).Si vous voulez déterminer la manière dont une expression est
traitée, vous pouvez recompiler mod_include en
utilisant l'option de compilation -DDEBUG_INCLUDE.
Ceci a pour effet d'insérer, pour chaque expression interprétée,
des informations étiquetées, l'arbre d'interprétation et la
manière dont elle est évaluée au sein du flux de sortie envoyé au
client.
Tous les caractères slashes qui ne sont pas des séparateurs dans votre expression rationnelle doivent être échappés, et ceci sans tenir compte de leur signification du point de vue du moteur d'expressions rationnelles.
Voir le document Les expressions dans le serveur HTTP Apache, pour une référence complète et des exemples.
| Description: | Chaîne qui termine l'élément include |
|---|---|
| Syntaxe: | SSIEndTag tag |
| Défaut: | SSIEndTag "-->" |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_include |
Cette directive permet de modifier la chaîne que
mod_include interprète comme la fin d'un élément
include.
SSIEndTag "%>"
| Description: | Message d'erreur affiché lorsqu'une erreur SSI survient |
|---|---|
| Syntaxe: | SSIErrorMsg message |
| Défaut: | SSIErrorMsg "[an error occurred while processing this
directive]" |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Base |
| Module: | mod_include |
La directive SSIErrorMsg permet de
modifier le message d'erreur affiché lorsqu'une erreur SSI survient.
Pour les serveurs en production, il est recommandé de modifier le
message d'erreur par défaut en "<!-- Error
-->", de façon à ce que le message ne soit pas
présenté à l'utilisateur.
Cette directive a le même effet que l'élément
<!--#config errmsg=message -->.
SSIErrorMsg "<!-- Error -->"
| Description: | Définit si des en-têtes ETags sont générés par le serveur. |
|---|---|
| Syntaxe: | SSIETag on|off |
| Défaut: | SSIETag off |
| Contexte: | répertoire, .htaccess |
| Statut: | Base |
| Module: | mod_include |
| Compatibilité: | Disponible à partir de la version 2.2.15 du serveur HTTP Apache. |
Dans le cas général, un fichier filtré par
mod_include peut contenir des éléments soit
générés dynamiquement, soit éventuellement modifiés indépendemment
du fichier original. En conséquence, il est demandé par défaut au
serveur de ne pas générer d'en-tête ETag à la réponse
en ajoutant no-etag aux informations de requête.
Ce comportement peut être modifié via la directive
SSIETag qui permet au serveur de générer un
en-tête ETag. On peut aussi l'utiliser pour la mise
en cache de la sortie. Notez qu'un serveur d'arrière-plan ou un
générateur de contenu dynamique peut lui-même générer un en-tête
ETag, en ignorant l'information no-etag,
cet en-tête ETag étant transmis par
mod_include sans tenir compte de la définition de
la présente directive. La directive SSIETag
peut prendre une des valeurs suivantes :
offno-etag sera ajouté aux informations de
requête, et il sera demandé au serveur de ne pas générer
d'en-tête ETag. Lorsqu'un serveur ignore la valeur
de no-etag et génère tout de même un en-tête
ETag, ce dernier sera respecté.onETag existants seront respectés,
et ceux générés par le serveur seront ajoutés à la réponse.| Description: | Définit si des en-têtes Last-Modified sont
générés par le serveur. |
|---|---|
| Syntaxe: | SSILastModified on|off |
| Défaut: | SSILastModified off |
| Contexte: | répertoire, .htaccess |
| Statut: | Base |
| Module: | mod_include |
| Compatibilité: | Disponible à partir de la version 2.2.15 du serveur HTTP Apache. |
Dans le cas général, un fichier filtré par
mod_include peut contenir des éléments soit
générés dynamiquement, soit éventuellement modifiés indépendemment
du fichier original. En conséquence, l'en-tête
Last-Modified est supprimé par défaut de la réponse.
La directive SSILastModified permet de
modifier ce comportement en faisant en sorte que l'en-tête
Last-Modified soit respecté s'il est déjà présent, ou
défini dans le cas contraire. On peut aussi l'utiliser pour la mise
en cache de la sortie. La directive
SSILastModified peut prendre une des
valeurs suivantes :
offLast-Modified sera supprimé des
réponses, à moins que la directive XBitHack ne soit définie à
full comme décrit plus loin.onLast-Modified sera respecté s'il est
déjà présent, et ajouté à la réponse si cette dernière est un
fichier et si l'en-tête est manquant. La directive SSILastModified l'emporte sur
la directive XBitHack.| Description: | Active le mode de compatibilité pour les expressions conditionnelles. |
|---|---|
| Syntaxe: | SSILegacyExprParser on|off |
| Défaut: | SSILegacyExprParser off |
| Contexte: | répertoire, .htaccess |
| Statut: | Base |
| Module: | mod_include |
| Compatibilité: | Disponible à partir de la version 2.3.13. |
Depuis la version 2.3.13, mod_include a adopté
la nouvelle syntaxe ap_expr pour ses
expressions conditionnelles dans les éléments de contrôle de flux
#if. Cette directive permet de réactiver l'ancienne syntaxe qui est compatible avec les
versions 2.2.x et antérieures d'Apache HTTPD.
| Description: | Chaîne qui marque le début d'un élément include |
|---|---|
| Syntaxe: | SSIStartTag tag |
| Défaut: | SSIStartTag "<!--#" |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_include |
Cette directive permet de modifier la chaîne que
mod_include interprète comme le début d'un élément
include.
Cette option peut vous être utile si vous avez deux serveurs qui interprètent un fichier avec des commandes différentes (et éventuellement à des moments différents).
SSIStartTag "<%" SSIEndTag "%>"
Avec l'exemple ci-dessus, qui définit aussi une directive
SSIEndTag, vous pourrez
inscrire des directives SSI comme dans l'exemple suivant :
<%printenv %>
| Description: | Configuration du format d'affichage des dates |
|---|---|
| Syntaxe: | SSITimeFormat chaîne de formatage |
| Défaut: | SSITimeFormat "%A, %d-%b-%Y %H:%M:%S %Z" |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Base |
| Module: | mod_include |
Cette directive permet de modifier le format d'affichage des
variables d'environnement DATE. La chaîne de
formatage est identique à celle de la fonction
strftime(3) de la bibliothèque C standard.
Cette directive a le même effet que l'élément
<!--#config timefmt=chaîne de formatage
-->.
SSITimeFormat "%R, %B %d, %Y"
Avec l'exemple ci-dessus, les dates seront affichées dans le style "22:26, June 14, 2002".
| Description: | Chaîne à afficher lorsqu'on tente d'extraire le contenu d'une variable non définie |
|---|---|
| Syntaxe: | SSIUndefinedEcho chaîne |
| Défaut: | SSIUndefinedEcho "(none)" |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Base |
| Module: | mod_include |
Cette directive permet de modifier la chaîne affichée par
mod_include lorsqu'on tente d'extraire le contenu
d'une variable non définie.
SSIUndefinedEcho "<!-- nondef -->"
| Description: | Interprète les directives SSI dans les fichiers dont le bit d'exécution est positionné |
|---|---|
| Syntaxe: | XBitHack on|off|full |
| Défaut: | XBitHack off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Base |
| Module: | mod_include |
La directive XBitHack permet de contrôler
l'interprétation des documents html standards. Elle n'affecte que
les fichiers dont le type MIME est
text/html. XBitHack peut prendre
les valeurs suivantes :
offontext/html dont le bit d'exécution
est positionné pour le propriétaire sera traité en tant que
document html interprété par le serveur.fullon, avec test du bit d'exécution pour
le groupe. Si ce dernier est positionné, la date de dernière
modification du fichier renvoyé est définie à la date de
dernière modification du fichier. Dans le cas contraire, aucune
date de dernière modification n'est renvoyée. Le positionnement de
ce bit permet aux clients et aux mandataires de gérer la mise en
cache du résultat de la requête.
Il est recommandé de n'utiliser l'option full que dans le cas
où vous êtes certain que le bit d'exécution du groupe est non
positionné pour les scripts SSI qui pourraient effectuer l'#include d'un programme CGI ou bien produire des sorties
différentes à chaque accès (ou seraient susceptibles d'être
modifiées au cours des requêtes ultérieures).
Lorsqu'elle est définie à on, la directive
SSILastModified
l'emporte sur la directive XBitHack.
Serveur HTTP Apache Version 2.4
| Description: | Algorithme de planification avec répartition de charge de
l'attribution des requêtes en attente pour le module
mod_proxy_balancer |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | lbmethod_bybusyness_module |
| Fichier Source: | mod_lbmethod_bybusyness.c |
| Compatibilité: | Dissocié de mod_proxy_balancer depuis la
version 2.3 |
Ce module ne fournit pas lui-même de directive de configuration. Il
nécessite les services de mod_proxy_balancer, et
fournit la méthode de répartition de charge bybusyness.
Ce module ne fournit aucune directive.
Activé via lbmethod=bybusyness, ce planificateur
surveille le nombre de requêtes assignées à chaque processus worker
à l'instant présent. Une nouvelle requête est automatiquement
assignée au processus worker auquel est assigné le plus petit nombre de
requêtes. Ceci s'avère utile dans le cas où les
processus worker mettent en file d'attente les requêtes entrantes
indépendamment d'Apache, et permet de s'assurer que la longueur des
files reste raisonnable, et qu'une requête est toujours assignée au
processus worker qui sera à même de la servir le plus
rapidement et avec une latence réduite.
Si plusieurs processus worker s'avèrent les moins chargés, le
choix d'un de ces derniers est effectué à partir des statistiques
(et des estimations de charges) qu'utilise la méthode de décompte
des requêtes. Au fil du temps, la distribution des tâches finit par
ressembler à celle de byrequests (tel qu'implémenté par
mod_lbmethod_byrequests).
Serveur HTTP Apache Version 2.4
| Description: | Algorithme d'ordonnancement de répartition de charge pour
mod_proxy_balancer basé sur le comptage de trafic Heartbeat |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | lbmethod_heartbeat_module |
| Fichier Source: | mod_lbmethod_heartbeat.c |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache |
lbmethod=heartbeat utilise les services du module
mod_heartmonitor pour répartir la charge entre les
serveurs d'origine qui fournissent des données heartbeat via le
module mod_heartbeat.
Son algorithme de répartition de charge favorise les serveurs dont la capacité de traitement moyenne répartie dans le temps est la plus importante, mais il ne sélectionne pas forcément le serveur qui présente la disponibilité instantanée la plus importante. Les serveurs qui ne possèdent aucun client actif sont pénalisés, car ils sont considérés comme non entièrement initialisés.
| Description: | Indique le chemin permettant de lire les données heartbeat |
|---|---|
| Syntaxe: | HeartbeatStorage chemin-fichier |
| Défaut: | HeartbeatStorage logs/hb.dat |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_lbmethod_heartbeat |
La directive HeartbeatStorage permet de
spécifier le chemin d'accès aux données heartbeat. Ce fichier texte
n'est utilisé que si le module mod_slotmem_shm
n'est pas chargé.
Serveur HTTP Apache Version 2.4
| Description: | Algorithme de planification avec répartition de charge du
traitement des requêtes pour le module
mod_proxy_balancer |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | lbmethod_byrequests_module |
| Fichier Source: | mod_lbmethod_byrequests.c |
| Compatibilité: | Dissocié de mod_proxy_balancer dans la
version 2.3 |
Ce module ne fournit pas lui-même de directive de configuration. Il
nécessite les services de mod_proxy_balancer, et
fournit la méthode de répartition de charge byrequests.
Ce module ne fournit aucune directive.
Activé via lbmethod=byrequests, ce planificateur a
été conçu dans le but de distribuer les requêtes à tous les
processus worker afin qu'ils traitent tous le nombre de requêtes
pour lequel ils ont été configurés. Il fonctionne de la manière
suivante :
lbfactor correspond à la quantité de travail que nous attendons de ce processus worker, ou en d'autres termes son quota de travail. C'est une valeur normalisée représentant leur part du travail à accomplir.
lbstatus représente combien il est urgent que ce processus worker travaille pour remplir son quota de travail.
Le worker est un membre du dispositif de répartition de charge, en général un serveur distant traitant un des protocoles supportés.
On distribue à chaque processus worker son quota de travail, puis on regarde celui qui a le plus besoin de travailler (le plus grand lbstatus). Ce processus est alors sélectionné pour travailler, et son lbstatus diminué de l'ensemble des quotas de travail que nous avons distribués à tous les processus. La somme de tous les lbstatus n'est ainsi pas modifiée, et nous pouvons distribuer les requêtes selon nos souhaits.
Si certains processus workers sont désactivés, les autres feront l'objet d'une planification normale.
for each worker in workers
worker lbstatus += worker lbfactor
total factor += worker lbfactor
if worker lbstatus > candidate lbstatus
candidate = worker
candidate lbstatus -= total factorSi un répartiteur de charge est configuré comme suit :
| worker | a | b | c | d |
|---|---|---|---|---|
| lbfactor | 25 | 25 | 25 | 25 |
| lbstatus | 0 | 0 | 0 | 0 |
Et si b est désactivé, la planification suivante est mise en oeuvre :
| worker | a | b | c | d |
|---|---|---|---|---|
| lbstatus | -50 | 0 | 25 | 25 |
| lbstatus | -25 | 0 | -25 | 50 |
| lbstatus | 0 | 0 | 0 | 0 |
| (repeat) | ||||
C'est à dire la chronologie suivante : a c d a c d a c d ... Veuillez noter que :
| worker | a | b | c | d |
|---|---|---|---|---|
| lbfactor | 25 | 25 | 25 | 25 |
A le même effet que :
| worker | a | b | c | d |
|---|---|---|---|---|
| lbfactor | 1 | 1 | 1 | 1 |
Ceci est dû au fait que toutes les valeurs de lbfactor sont normalisées et évaluées en fonction des autres. Avec :
| worker | a | b | c |
|---|---|---|---|
| lbfactor | 1 | 4 | 1 |
le processus b va, en moyenne, se voir assigner 4 fois plus de requêtes que a et c.
La configuration suivante, asymétrique, fonctionne comme on peut s'y attendre :
| worker | a | b |
|---|---|---|
| lbfactor | 70 | 30 |
| lbstatus | -30 | 30 |
| lbstatus | 40 | -40 |
| lbstatus | 10 | -10 |
| lbstatus | -20 | 20 |
| lbstatus | -50 | 50 |
| lbstatus | 20 | -20 |
| lbstatus | -10 | 10 |
| lbstatus | -40 | 40 |
| lbstatus | 30 | -30 |
| lbstatus | 0 | 0 |
| (repeat) | ||
Après 10 distributions, la planification se répète et 7 a sont sélectionnés avec 3 b intercalés.
Serveur HTTP Apache Version 2.4
| Description: | Conservation des connexions LDAP et services de mise en cache du résultat à destination des autres modules LDAP |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | ldap_module |
| Fichier Source: | util_ldap.c |
Ce module a été conçu dans le but d'améliorer les performances des sites web s'appuyant sur des connexions en arrière-plan vers des serveurs LDAP. Il ajoute aux fonctions fournies par les bibliothèques standards LDAP la conservation des connexions LDAP ainsi qu'un cache LDAP partagé en mémoire.
Pour activer ce module, le support LDAP doit être compilé dans
apr-util. Pour ce faire, on ajoute l'option --with-ldap
au script configure lorsqu'on construit
Apache.
Le support SSL/TLS est conditionné par le kit de développement LDAP qui a été lié à APR. Au moment où ces lignes sont écrites, APR-util supporte OpenLDAP SDK (version 2.x ou supérieure), Novell LDAP SDK, Mozilla LDAP SDK, le SDK LDAP Solaris natif (basé sur Mozilla) ou le SDK LDAP Microsoft natif. Voir le site web APR pour plus de détails.
Exemple de configuration Conservation des connexions LDAP Cache LDAP Utiliser SSL/TLS Certificats SSL/TLS LDAPCacheEntries LDAPCacheTTL LDAPConnectionPoolTTL LDAPConnectionTimeout LDAPLibraryDebug LDAPOpCacheEntries LDAPOpCacheTTL LDAPReferralHopLimit LDAPReferrals LDAPRetries LDAPRetryDelay LDAPSharedCacheFile LDAPSharedCacheSize LDAPTimeout LDAPTrustedClientCert LDAPTrustedGlobalCert LDAPTrustedMode LDAPVerifyServerCertCe qui suit est un exemple de configuration qui utilise
mod_ldap pour améliorer les performances de
l'authentification HTTP de base fournie par
mod_authnz_ldap.
# Active la conservation des connexions LDAP et le cache partagé en
# mémoire. Active le gestionnaire de statut du cache LDAP.
# Nécessite le chargement de mod_ldap et de mod_authnz_ldap.
# Remplacez "votre-domaine.example.com" par le nom de votre
# domaine.
LDAPSharedCacheSize 500000
LDAPCacheEntries 1024
LDAPCacheTTL 600
LDAPOpCacheEntries 1024
LDAPOpCacheTTL 600
<Location "/ldap-status">
SetHandler ldap-status
Require host yourdomain.example.com
Satisfy any
AuthType Basic
AuthName "LDAP Protected"
AuthBasicProvider ldap
AuthLDAPURL "ldap://127.0.0.1/dc=example,dc=com?uid?one"
Require valid-user
</Location>
Les connexions LDAP sont conservées de requête en requête. Ceci permet de rester connecté et identifié au serveur LDAP, ce dernier étant ainsi prêt pour la prochaine requête, sans avoir à se déconnecter, reconnecter et réidentifier. Le gain en performances est similaire à celui des connexions persistantes (keepalives) HTTP.
Sur un serveur très sollicité, il est possible que de nombreuses requêtes tentent d'accéder simultanément à la même connexion au serveur LDAP. Lorsqu'une connexion LDAP est utilisée, Apache en crée une deuxième en parallèle à la première, ce qui permet d'éviter que le système de conservation des connexions ne devienne un goulot d'étranglement.
Il n'est pas nécessaire d'activer explicitement la conservation des connexions dans la configuration d'Apache. Tout module utilisant le module ldap pour accéder aux services LDAP partagera le jeu de connexions.
Les connexions LDAP peuvent garder la trace des données
d'identification du client ldap utilisées pour l'identification
auprès du serveur LDAP. Ces données peuvent être fournies aux
serveurs LDAP qui ne permettent pas les connexions anonymes au cours
lors des tentatives de sauts vers des serveurs alternatifs. Pour
contrôler cette fonctionnalité, voir les directives LDAPReferrals et LDAPReferralHopLimit. Cette
fonctionnalité est activée par défaut.
Pour améliorer les performances, mod_ldap met en oeuvre
une stratégie de mise en cache agressive visant à minimiser le nombre de
fois que le serveur LDAP doit être contacté. La mise en cache peut
facilement doubler et même tripler le débit d'Apache lorsqu'il sert des
pages protégées par mod_authnz_ldap. De plus, le serveur
LDAP verra lui-même sa charge sensiblement diminuée.
mod_ldap supporte deux types de mise en cache
LDAP : un cache recherche/identification durant la phase
de recherche/identification et deux caches d'opérations
durant la phase de comparaison. Chaque URL LDAP utilisée par le
serveur a son propre jeu d'instances dans ces trois caches.
Les processus de recherche et d'identification sont les opérations LDAP les plus consommatrices en temps, en particulier si l'annuaire est de grande taille. Le cache de recherche/identification met en cache toutes les recherches qui ont abouti à une identification positive. Les résultats négatifs (c'est à dire les recherches sans succès, ou les recherches qui n'ont pas abouti à une identification positive) ne sont pas mis en cache. La raison de cette décision réside dans le fait que les connexions avec des données d'identification invalides ne représentent qu'un faible pourcentage du nombre total de connexions, et ainsi, le fait de ne pas mettre en cache les données d'identification invalides réduira d'autant la taille du cache.
mod_ldap met en cache le nom d'utilisateur, le
DN extrait, le mot de passe utilisé pour l'identification, ainsi
que l'heure de l'identification. Chaque fois qu'une nouvelle
connexion est initialisée avec le même nom d'utilisateur,
mod_ldap compare le mot de passe de la nouvelle
connexion avec le mot de passe enregistré dans le cache. Si les
mots de passe correspondent, et si l'entrée du cache n'est pas
trop ancienne, mod_ldap court-circuite la phase
de recherche/identification.
Le cache de recherche/identification est contrôlé par les
directives LDAPCacheEntries et LDAPCacheTTL.
Au cours des opérations de comparaison d'attributs et de noms
distinctifs (DN), mod_ldap utilise deux caches
d'opérations pour mettre en cache les opérations de comparaison.
Le premier cache de comparaison sert à mettre en cache les
résultats de comparaisons effectuées pour vérifier l'appartenance
à un groupe LDAP. Le second cache de comparaison sert à mettre en
cache les résultats de comparaisons entre DNs.
Notez que, lorsque l'appartenance à un groupe est vérifiée, toute comparaison de sous-groupes est mise en cache afin d'accélérer les comparaisons de sous-groupes ultérieures.
Le comportement de ces deux caches est contrôlé par les
directives LDAPOpCacheEntries et LDAPOpCacheTTL.
mod_ldap possède un gestionnaire de contenu
qui permet aux administrateurs de superviser les performances du
cache. Le nom du gestionnaire de contenu est
ldap-status, et on peut utiliser les directives
suivantes pour accéder aux informations du cache de
mod_ldap :
<Location "/server/cache-info">
SetHandler ldap-status
</Location>
En se connectant à l'URL
http://nom-serveur/infos-cache, l'administrateur peut
obtenir un rapport sur le statut de chaque cache qu'utilise
mod_ldap. Notez que si Apache ne supporte pas la
mémoire partagée, chaque instance de httpd
possèdera son propre cache, et chaque fois que l'URL sera
rechargée, un résultat différent pourra être affiché, en fonction
de l'instance de httpd qui traitera la
requête.
La possibilité de créer des connexions SSL et TLS avec un serveur
LDAP est définie par les directives
LDAPTrustedGlobalCert,
LDAPTrustedClientCert et
LDAPTrustedMode. Ces directives permettent de spécifier
l'autorité de certification (CA), les certificats clients éventuels,
ainsi que le type de chiffrement à utiliser pour la connexion (none,
SSL ou TLS/STARTTLS).
# Etablissement d'une connexion SSL LDAP sur le port 636.
# Nécessite le chargement de mod_ldap et mod_authnz_ldap.
# Remplacez "votre-domaine.example.com" par le nom de votre
# domaine.
LDAPTrustedGlobalCert CA_DER "/certs/certfile.der"
<Location "/ldap-status">
SetHandler ldap-status
Require host yourdomain.example.com
Satisfy any
AuthType Basic
AuthName "LDAP Protected"
AuthBasicProvider ldap
AuthLDAPURL "ldaps://127.0.0.1/dc=example,dc=com?uid?one"
Require valid-user
</Location>
# Etablissement d'une connexion TLS LDAP sur le port 389.
# Nécessite le chargement de mod_ldap et mod_authnz_ldap.
# Remplacez "votre-domaine.example.com" par le nom de votre
# domaine.
LDAPTrustedGlobalCert CA_DER "/certs/certfile.der"
<Location "/ldap-status">
SetHandler ldap-status
Require host yourdomain.example.com
Satisfy any
AuthType Basic
AuthName "LDAP Protected"
AuthBasicProvider ldap
AuthLDAPURL "ldap://127.0.0.1/dc=example,dc=com?uid?one" TLS
Require valid-user
</Location>
Les différents SDKs LDAP disposent de nombreuses méthodes pour définir et gérer les certificats des clients et des autorités de certification (CA).
Si vous avez l'intention d'utiliser SSL ou TLS, lisez cette section ATTENTIVEMENT de façon à bien comprendre les différences de configurations entre les différents SDKs LDAP supportés.
Les certificat de CA sont enregistrés dans un fichier nommé cert7.db. Le SDK ne dialoguera avec aucun serveur LDAP dont le certificat n'a pas été signé par une CA spécifiée dans ce fichier. Si des certificats clients sont requis, un fichier key3.db ainsi qu'un mot de passe optionnels peuvent être spécifiés. On peut aussi spécifier le fichier secmod si nécessaire. Ces fichiers sont du même format que celui utilisé par les navigateurs web Netscape Communicator ou Mozilla. Le moyen le plus simple pour obtenir ces fichiers consiste à les extraire de l'installation de votre navigateur.
Les certificats clients sont spécifiés pour chaque connexion en
utilisant la directive LDAPTrustedClientCert et en se référant au
certificat "nickname". On peut éventuellement spécifier un mot de passe
pour déverrouiller la clé privée du certificat.
Le SDK supporte seulement SSL. Toute tentative d'utilisation de STARTTLS engendrera une erreur lors des tentatives de contacter le serveur LDAP pendant l'exécution.
# Spécifie un fichier de certificats de CA Netscape
LDAPTrustedGlobalCert CA_CERT7_DB "/certs/cert7.db"
# Spécifie un fichier key3db optionnel pour le support des
# certificats clients
LDAPTrustedGlobalCert CERT_KEY3_DB "/certs/key3.db"
# Spécifie le fichier secmod si nécessaire
LDAPTrustedGlobalCert CA_SECMOD "/certs/secmod"
<Location "/ldap-status">
SetHandler ldap-status
Require host yourdomain.example.com
Satisfy any
AuthType Basic
AuthName "LDAP Protected"
AuthBasicProvider ldap
LDAPTrustedClientCert CERT_NICKNAME <nickname> [password]
AuthLDAPURL "ldaps://127.0.0.1/dc=example,dc=com?uid?one"
Require valid-user
</Location>
Un ou plusieurs certificats de CA doivent être spécifiés pour que le SDK Novell fonctionne correctement. Ces certificats peuvent être spécifiés sous forme de fichiers au format binaire DER ou codés en Base64 (PEM).
Note: Les certificats clients sont spécifiés globalement plutôt qu'à
chaque connexion, et doivent être spécifiés à l'aide de la directive
LDAPTrustedGlobalCert comme
ci-dessous. Définir des certificats clients via la directive LDAPTrustedClientCert engendrera une
erreur qui sera journalisée, au moment de la tentative de connexion avec
le serveur LDAP.
Le SDK supporte SSL et STARTTLS, le choix étant défini par le
paramètre de la directive LDAPTrustedMode. Si une URL de type
ldaps:// est spécifiée, le mode SSL est forcé, et l'emporte sur cette
directive.
# Spécifie deux fichiers contenant des certificats de CA LDAPTrustedGlobalCert CA_DER "/certs/cacert1.der" LDAPTrustedGlobalCert CA_BASE64 "/certs/cacert2.pem" # Spécifie un fichier contenant des certificats clients # ainsi qu'une clé LDAPTrustedGlobalCert CERT_BASE64 "/certs/cert1.pem" LDAPTrustedGlobalCert KEY_BASE64 "/certs/key1.pem" [password] # N'utilisez pas cette directive, sous peine de provoquer # une erreur #LDAPTrustedClientCert CERT_BASE64 "/certs/cert1.pem"
Un ou plusieurs certificats de CA doivent être spécifiés pour que le SDK OpenLDAP fonctionne correctement. Ces certificats peuvent être spécifiés sous forme de fichiers au format binaire DER ou codés en Base64 (PEM).
Les certificats clients et CA peuvent être spécifiés globalement
(LDAPTrustedGlobalCert) ou pour
chaque connexion (LDAPTrustedClientCert). Les définitions au
niveau d'une connexion l'emportent sur les définitions globales.
La documentation du SDK prétend que SSL et STARTTLS sont supportés ; cependant, STARTTLS semble ne pas fonctionner avec toutes les versions du SDK. Le mode SSL/TLS peut être défini en utilisant le paramètre de la directive LDAPTrustedMode. Si une URL de type ldaps:// est spécifiée, le mode SSL est forcé. La documentation OpenLDAP indique que le support SSL (ldaps://) tend à être remplacé par TLS, bien que le mode SSL fonctionne toujours.
# Spécifie deux fichiers contenant des certificats de CA
LDAPTrustedGlobalCert CA_DER "/certs/cacert1.der"
LDAPTrustedGlobalCert CA_BASE64 "/certs/cacert2.pem"
<Location /ldap-status>
SetHandler ldap-status
Require host yourdomain.example.com
LDAPTrustedClientCert CERT_BASE64 "/certs/cert1.pem"
LDAPTrustedClientCert KEY_BASE64 "/certs/key1.pem"
# CA certs respecified due to per-directory client certs
LDAPTrustedClientCert CA_DER "/certs/cacert1.der"
LDAPTrustedClientCert CA_BASE64 "/certs/cacert2.pem"
Satisfy any
AuthType Basic
AuthName "LDAP Protected"
AuthBasicProvider ldap
AuthLDAPURL "ldaps://127.0.0.1/dc=example,dc=com?uid?one"
Require valid-user
</Location>
SSL/TLS pour les bibliothèques LDAP propres à Solaris n'est pas encore supporté. Si nécessaire, installez et utilisez plutôt les bibliothèques OpenLDAP.
La configuration des certificats SSL/TLS pour les bibliothèques LDAP propres à Microsoft s'effectue à l'intérieur du registre système, et aucune directive de configuration n'est requise.
SSL et TLS sont tous deux supportés en utilisant des URLs de type
ldaps://, ou en définissant la directive LDAPTrustedMode à cet effet.
Note: L'état du support des certificats clients n'est pas encore connu pour ce SDK.
| Description: | Nombre maximum d'entrées dans le cache LDAP primaire |
|---|---|
| Syntaxe: | LDAPCacheEntries nombre |
| Défaut: | LDAPCacheEntries 1024 |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Cette directive permet de spécifier la taille maximale du cache LDAP primaire. Ce cache contient les résultats de recherche/identification positifs. Définissez-la à 0 pour désactiver la mise en cache des résultats de recherche/identification positifs. La taille par défaut est de 1024 recherches en cache.
| Description: | Durée pendant laquelle les entrées du cache restent valides. |
|---|---|
| Syntaxe: | LDAPCacheTTL secondes |
| Défaut: | LDAPCacheTTL 600 |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Cette directive permet de spécifier la durée (en secondes) pendant laquelle une entrée du cache de recherche/identification reste valide. La valeur par défaut est de 600 secondes (10 minutes).
| Description: | Désactive les connexions d'arrière-plan qui sont restées inactives trop longtemps au sein du jeu de connexions. |
|---|---|
| Syntaxe: | LDAPConnectionPoolTTL n |
| Défaut: | LDAPConnectionPoolTTL -1 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ldap |
| Compatibilité: | Disponible à partir de la version 2.3.12 du serveur HTTP Apache |
Cette directive permet de spécifier la durée maximale, en secondes, pendant laquelle une connexion LDAP du jeu de connexions peut demeurer inactive, mais rester quand-même disponible pour une utilisation éventuelle. Le jeu de connexions est nettoyé au fur et à mesure des besoins, de manière non asynchrone.
Si cette directive est définie à 0, les connexions ne sont jamais sauvegardées dans le jeu de connexions d'arrière-plan. Avec la valeur par défaut -1, ou toute autre valeur négative, les connexions peuvent être réutilisées sans limite de durée.
Dans le but d'améliorer les performances, le temps de référence qu'utilise cette directive correspond au moment où la connexion LDAP est enregistrée ou remise dans le jeu de connexions, et non au moment du dernier échange réussi avec le serveur LDAP.
La version 2.4.10 a introduit de nouvelles mesures permettant d'éviter une augmentation excessive du temps de référence due à des correspondances positives dans le cache ou des requêtes lentes. A cet effet, le temps de référence n'est pas réactualisé si aucune connexion LDAP d'arrière-plan n'est requise ; d'autre part, le temps de référence se base sur le moment où la requête HTTP est reçue, et non sur le moment où la requête a été traitée.
Cette durée de vie s'exprime par défaut en secondes, mais il est possible d'utiliser d'autres unités en ajoutant un suffixe : millisecondes (ms), minutes (min), ou heures (h).
| Description: | Spécifie le délai d'attente en secondes de la socket de connexion |
|---|---|
| Syntaxe: | LDAPConnectionTimeout secondes |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Cette directive configure l'option LDAP_OPT_NETWORK_TIMEOUT (ou LDAP_OPT_CONNECT_TIMEOUT) dans la bibliothèque client LDAP sous-jacente, si elle est disponible. Cette valeur représente la durée pendant laquelle la bibliothèque client LDAP va attendre que le processus de connexion TCP au serveur LDAP soit achevé.
Si la connexion n'a pas réussi avant ce délai, une erreur sera
renvoyée, ou la bibliothèque client LDAP tentera de se connecter à
un second serveur LDAP, s'il en a été défini un (via une liste de
noms d'hôtes séparés par des espaces dans la directive AuthLDAPURL).
La valeur par défaut est 10 secondes, si la bibliothèque client LDAP liée avec le serveur supporte l'option LDAP_OPT_NETWORK_TIMEOUT.
| Description: | Active le débogage dans le SDK LDAP |
|---|---|
| Syntaxe: | LDAPLibraryDebug 7 |
| Défaut: | disabled |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Active les options de débogage LDAP spécifiques au SDK, qui entraînent en général une journalisation d'informations verbeuses du SDK LDAP dans le journal principal des erreurs d'Apache. Les messages de traces en provenance du SDK LDAP fournissent des informations très détaillées qui peuvent s'avérer utiles lors du débogage des problèmes de connexion avec des serveurs LDAP d'arrière-plan.
Cette option n'est configurable que lorsque le serveur HTTP
Apache est lié avec un SDK LDAP qui implémente
LDAP_OPT_DEBUG ou LDAP_OPT_DEBUG_LEVEL,
comme OpenLDAP (une valeur de 7 est verbeuse) ou Tivoli Directory
Server (une valeur de 65535 est verbeuse).
Les informations journalisées peuvent contenir des données d'authentification en clair utilisées ou validées lors de l'authentification LDAP ; vous devez donc prendre soin de protéger et de purger le journal des erreurs lorsque cette directive est utilisée.
| Description: | Nombre d'entrées utilisées pour mettre en cache les opérations de comparaison LDAP |
|---|---|
| Syntaxe: | LDAPOpCacheEntries nombre |
| Défaut: | LDAPOpCacheEntries 1024 |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Cette directive permet de spécifier le nombre d'entrées que
mod_ldap va utiliser pour mettre en cache les
opérations de comparaison LDAP. La valeur par défaut est de 1024
entrées. Si elle est définie à 0, la mise en cache des opérations de
comparaison LDAP est désactivée.
| Description: | Durée pendant laquelle les entrées du cache d'opérations restent valides |
|---|---|
| Syntaxe: | LDAPOpCacheTTL secondes |
| Défaut: | LDAPOpCacheTTL 600 |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Cette directive permet de spécifier la durée (en secondes) pendant laquelle les entrées du cache d'opérations restent valides. La valeur par défaut est de 600 secondes.
| Description: | Le nombre maximum de redirections vers des serveurs alternatifs (referrals) avant l'abandon de la requête LDAP. |
|---|---|
| Syntaxe: | LDAPReferralHopLimit nombre |
| Défaut: | Dépend du SDK, en général entre 5 et 10 |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_ldap |
Si elle est activée par la directive LDAPReferrals, cette directive permet de
définir le nombre maximum de sauts vers des serveurs alternatifs (referrals)
avant l'abandon de la requête LDAP.
L'ajustement de ce paramètre n'est pas commun à tous les SDKs LDAP.
| Description: | Active la redirection vers des serveurs alternatifs au cours des requêtes vers le serveur LDAP. |
|---|---|
| Syntaxe: | LDAPReferrals On|Off|default |
| Défaut: | LDAPReferrals On |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_ldap |
| Compatibilité: | Le paramètre default est disponible depuis la version 2.4.7 du serveur HTTP Apache. |
Certains serveurs LDAP partagent leur annuaire en plusieurs domaines et utilisent le système des redirections (referrals) pour aiguiller un client lorsque les limites d'un domaine doivent être franchies. Ce processus est similaire à une redirection HTTP. Les bibliothèques client LDAP ne respectent pas forcément ces redirections par défaut. Cette directive permet de configurer explicitement les redirections LDAP dans le SDK sous-jacent.
La directive LDAPReferrals accepte les
valeurs suivantes :
Avec la valeur "on", la prise en compte des redirections LDAP par
le SDK sous-jacent est activée, la directive LDAPReferralHopLimit permet de surcharger la
"hop limit" du SDK, et un "LDAP rebind callback" est enregistré.
Avec la valeur "off", la prise en compte des redirections LDAP par le SDK sous-jacent est complètement désactivée.
Avec la valeur "default", la prise en compte des redirections LDAP
par le SDK sous-jacent n'est pas modifiée, la directive LDAPReferralHopLimit ne permet pas de
surcharger la "hop limit" du SDK, et aucun "LDAP rebind callback" n'est
enregistré.
La directive LDAPReferralHopLimit travaille en conjonction
avec cette directive pour limiter le nombre de redirections à suivre pour
achever le traitement de la requête LDAP. Lorsque le processus de
redirection est activé par la valeur "On", les données d'authentification du
client sont transmises via un "rebind callback" à tout serveur LDAP qui en
fait la demande.
| Description: | Définit le nombre maximum de tentatives de connexions au serveur LDAP. |
|---|---|
| Syntaxe: | LDAPRetries nombre d'essais |
| Défaut: | LDAPRetries 3 |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Suite à des échecs de connexion au serveur LDAP, le serveur
tentera de se connecter autant de fois qu'indiqué par la directive
LDAPRetries. Si cette directive est définie à
0, le serveur ne tentera pas d'autre connexion après un échec.
Il est possible d'effectuer une autre tentative de connexion en cas d'erreurs LDAP du type délai dépassé ou connexion refusée.
| Description: | Définit le temps d'attente avant un autre essai de connexion au serveur LDAP. |
|---|---|
| Syntaxe: | LDAPRetryDelay secondes |
| Défaut: | LDAPRetryDelay 0 |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Si la directive LDAPRetryDelay est définie
à une valeur différente de 0, le serveur attendra pendant la durée
spécifiée pour envoyer à nouveau sa requête LDAP. Une valeur de 0
implique une absence de délai pour les essais successifs.
Il est possible d'effectuer une autre tentative de connexion en cas d'erreurs LDAP du type délai dépassé ou connexion refusée.
| Description: | Définit le fichier du cache en mémoire partagée |
|---|---|
| Syntaxe: | LDAPSharedCacheFile chemin/fichier |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Cette directive permet de spécifier le chemin du fichier du cache en mémoire partagée. Si elle n'est pas définie, la mémoire partagée anonyme sera utilisée si la plate-forme la supporte.
| Description: | Taille en octets du cache en mémoire partagée |
|---|---|
| Syntaxe: | LDAPSharedCacheSize octets |
| Défaut: | LDAPSharedCacheSize 500000 |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Cette directive permet de spécifier le nombre d'octets à allouer pour le cache en mémoire partagée. La valeur par défaut est 500kb. Si elle est définie à 0, le cache en mémoire partagée ne sera pas utilisé et chaque processus HTTPD va créer son propre cache.
| Description: | Spécifie le délai d'attente pour les opérations de recherche et d'identification LDAP en secondes |
|---|---|
| Syntaxe: | LDAPTimeout secondes |
| Défaut: | LDAPTimeout 60 |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
| Compatibilité: | Disponible à partir de la version 2.3.5 du serveur HTTP Apache |
Cette directive permet de spécifier le délai d'attente pour les opérations de recherche et d'identification, ainsi que l'option LDAP_OPT_TIMEOUT dans la bibliothèque LDAP client sous-jacente, lorsqu'elle est disponible.
Lorsque le délai est atteint, httpd va refaire un essai dans le cas où une connexion existante a été silencieusement fermée par un pare-feu. Les performances seront cependant bien meilleures si le pare-feu est configuré pour envoyer des paquets TCP RST au lieu de rejeter silencieusement les paquets.
Les délais pour les opérations de comparaison LDAP nécessitent un SDK avec LDAP_OPT_TIMEOUT, comme OpenLDAP >= 2.4.4.
| Description: | Définit le nom de fichier contenant un certificat client ou un alias renvoyant vers un certificat client spécifique à une connexion. Tous les SDK LDAP ne supportent pas les certificats clients par connexion. |
|---|---|
| Syntaxe: | LDAPTrustedClientCert type
chemin/nom-fichier/alias [mot de passe] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_ldap |
Cette directive permet de spécifier le chemin et le nom de fichier ou
l'alias d'un certificat client par connexion utilisé lors de l'établissement
d'une connexion SSL ou TLS avec un serveur LDAP. Les sections directory ou
location peuvent posséder leurs propres configurations de certificats
clients. Certains SDK LDAP (en particulier Novell) ne supportent pas les
certificats clients par connexion, et renvoient une erreur lors de la
connexion au serveur LDAP si vous tenter d'utiliser cette directive
(Utilisez à la place la directive LDAPTrustedGlobalCert pour les certificats
clients sous Novell - Voir plus haut le guide des certificats SSL/TLS pour
plus de détails). Le paramètre type spécifie le type du certificat en cours
de définition, en fonction du SDK LDAP utilisé. Les types supportés sont
:
| Description: | Définit le nom de fichier ou la base de données contenant les Autorités de Certification de confiance globales ou les certificats clients globaux |
|---|---|
| Syntaxe: | LDAPTrustedGlobalCert type
chemin/nom-fichier [mot de passe] |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Cette directive permet de spécifier le chemin et le nom du fichier
contenant les certificats des CA de confiance et/ou les certificats clients
du système global que mod_ldap utilisera pour établir une
connexion SSL ou TLS avec un serveur LDAP. Notez que toute information
relative aux certificats spécifiée en utilisant cette directive s'applique
globalement à l'ensemble de l'installation du serveur. Certains SDK LDAP (en
particulier Novell) nécessitent la définition globale de tous les
certificats clients en utilisant cette directive. La plupart des autres SDK
nécessitent la définition des certificats clients dans une section Directory
ou Location en utilisant la directive LDAPTrustedClientCert. Si vous ne définissez
pas ces directives correctement, une erreur sera générée lors des tentatives
de contact avec un serveur LDAP, ou la connexion échouera silencieusement
(Voir plus haut le guide des certificats SSL/TLS pour plus de détails). Le
paramètre type spécifie le type de certificat en cours de définition, en
fonction du SDK LDAP utilisé. Les types supportés sont :
| Description: | Spécifie le mode (SSL ou TLS) à utiliser lors de la connexion à un serveur LDAP. |
|---|---|
| Syntaxe: | LDAPTrustedMode type |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_ldap |
Les modes suivants sont supportés :
Les modes ci-dessus ne sont pas supportés par tous les SDK LDAP. Un message d'erreur sera généré à l'exécution si un mode n'est pas supporté, et la connexion au serveur LDAP échouera.
Si une URL de type ldaps:// est spécifiée, le mode est forcé à SSL et la
définition de LDAPTrustedMode est ignorée.
| Description: | Force la vérification du certificat du serveur |
|---|---|
| Syntaxe: | LDAPVerifyServerCert On|Off |
| Défaut: | LDAPVerifyServerCert On |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_ldap |
Cette directive permet de spécifier s'il faut forcer la vérification d'un certificat de serveur lors de l'établissement d'une connexion SSL avec un serveur LDAP.
Serveur HTTP Apache Version 2.4
| Description: | Journalisation légale des requêtes envoyées au serveur |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | log_forensic_module |
| Fichier Source: | mod_log_forensic.c |
| Compatibilité: | mod_unique_id n'est plus obligatoire
depuis la version 2.1 |
Ce module permet la journalisation légale des requêtes client. La journalisation s'effectuant avant et après le traitement de la requête, le journal légal contient deux lignes pour chaque requête. Le processus de journalisation légale est très strict, à savoir :
CoreDumpDirectory).Pour interpréter les données du journal légal, vous pouvez vous
aider du script check_forensic qui se trouve dans le
répertoire support de la distribution.
Chaque requête fait l'objet d'une double journalisation. La requête est journalisée une première fois avant son traitement (c'est à dire après la réception des en-têtes). La deuxième entrée du journal est écrite après le traitement de la requête, en fait au moment de la journalisation habituelle.
Un identifiant unique est attribué à chaque requête afin de
pouvoir l'identifier. Cette identifiant légal peut faire l'objet
d'un enregistrement dans le journal standard en utilisant l'élément
de chaîne de format %{forensic-id}n. Si vous utilisez
mod_unique_id, c'est l'identifiant qu'il génère qui
sera utilisé.
La première partie de la journalisation de la requête enregistre
l'identifiant légal, la ligne de la requête et tous les en-têtes
reçus séparés par des caractères pipe (|). Voici à
titre d'exemple à quoi pourrait ressembler une telle entrée (tout
étant rassemblé sur une seule ligne) :
+yQtJf8CoAB4AAFNXBIEAAAAA|GET /manual/de/images/down.gif
HTTP/1.1|Host:localhost%3a8080|User-Agent:Mozilla/5.0 (X11;
U; Linux i686; en-US; rv%3a1.6) Gecko/20040216
Firefox/0.8|Accept:image/png, etc...
Le caractère plus ('+') de début indique qu'il s'agit de la première entrée de journal pour cette requête. La seconde entrée ne contiendra qu'un caractère moins ('-') suivi de l'identifiant :
-yQtJf8CoAB4AAFNXBIEAAAAA
Le script check_forensic prend comme argument le nom
du fichier journal. Il recherche ces paires d'identifiants
+/- et affiche un message d'erreur si la
journalisation d'une requête n'est pas complète.
Voir le document conseils en matière de sécurité pour des détails sur les raisons pour lesquelles votre sécurité pourrait être compromise si le répertoire dans lequel les fichiers journaux sont stockés sont inscriptibles par tout autre utilisateur que celui qui démarre le serveur.
Les fichiers journaux peuvent contenir des données sensibles
comme le contenu des en-têtes Authorization: (qui
peuvent contenir des mots de passe) ; ils ne doivent donc être
lisibles que par l'utilisateur qui démarre le serveur.
| Description: | Définit le nom de fichier du journal légal |
|---|---|
| Syntaxe: | ForensicLog nom-fichier|pipe |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_log_forensic |
La directive ForensicLog permet de
contrôler la journalisation des requêtes à des fins d'analyse
légale. Chaque entrée du journal se voit assigner un identifiant
unique qui peut être associé à la requête en utilisant la directive
CustomLog habituelle.
mod_log_forensic crée un élément nommé
forensic-id, qui peut être ajouté au journal standard
en utilisant l'élément de format %{forensic-id}n.
L'argument, qui permet de spécifier l'emplacement vers lequel le journal légal sera écrit, peut contenir les deux types de valeurs suivants :
ServerRoot.|", suivi du chemin vers un
programme qui recevra les informations de la journalisation sur
son entrée standard. Le nom du programme peut être relatif au
répertoire défini par la directive ServerRoot.
Si les journaux sont redirigés vers un programme, ce dernier
s'exécutera sous l'utilisateur qui a démarré
httpd. Ce sera l'utilisateur root si le serveur
a été démarré par root ; vérifiez que le programme est
sécurisé ou passe sous le contrôle d'un utilisateur possédant des
droits restreints.
Lors de la spécification d'un chemin de fichier sur les plate-formes non-Unix, il faut prendre soin de ne pas oublier que seuls les slashes directs doivent être utilisés, même si la plate-forme autorise l'emploi d'anti-slashes. D'une manière générale, c'est une bonne idée que de n'utiliser que des slashes directs dans les fichiers de configuration.
Serveur HTTP Apache Version 2.4
| Description: | Filtre de mise en cache HTTP conforme à la RFC 2616 |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | cache_module |
| Fichier Source: | mod_cache.c |
CacheQuickHandler est définie à sa
valeur par défaut on, les directives Allow and Deny sont court-circuitées. Vous
ne devez donc pas activer la gestion rapide de la mise en cache pour
un contenu auquel vous souhaitez limiter l'accès en fonction du nom
d'hôte du client, de l'adresse IP ou d'une variable
d'environnement.mod_cache implémente un filtre de mise
en cache de contenu HTTP conforme à la RFC 2616, avec
support de la mise en cache des réponses dont le contenu a été
négocié et comportant l'en-tête Vary.
La mise en cache conforme à la RFC 2616 fournit un mécanisme permettant de vérifier si un contenu expiré ou dépassé est encore à jour, et peut apporter un gain de performances significatif si le serveur original supporte les requêtes conditionnelles en prenant en compte l'en-tête de requête HTTP If-None-Match. Le contenu n'est ainsi régénéré que lorsqu'il a été modifié, et non lorsqu'il a expiré.
En tant que filtre, mod_cache peut être placé
en face d'un contenu issu de tout gestionnaire, y compris
des fichiers à accès séquentiel (servis depuis un
disque lent mis en
cache sur un gros disque), la sortie d'un script
CGI ou d'un générateur de contenu
dynamique, ou du contenu mandaté depuis un autre
serveur.
Dans la configuration par défaut, mod_cache
place le filtre de mise en cache aussi loin que possible dans la
pile de filtres, utilisant le gestionnaire rapide
pour court-circuiter tout traitement par requête lors de l'envoi du
contenu au client. Dans ce mode opératoire,
mod_cache peut être considéré comme un serveur
mandataire avec cache fixé en tête du serveur web, alors qu'il
s'exécute dans ce même serveur web.
Lorsque le gestionnaire rapide est désactivé via la directive
CacheQuickHandler, il
devient possible d'insérer le filtre CACHE à un
point de la pile de filtres choisi par l'administrateur. Ceci permet
de mettre en cache un contenu avant que celui-ci ne soit
personnalisé par le filtre mod_include, ou
éventuellement compressé par le filtre mod_deflate.
Dans le mode de fonctionnement normal, mod_cache
peut être contrôlé par les en-têtes Cache-Control
et Pragma
envoyés par un client dans une requête, ou par un serveur dans une
réponse. Dans des circonstances exceptionnelles,
mod_cache peut cependant être configuré pour
outrepasser ces en-têtes et forcer un comportement spécifique au
site, bien qu'un tel comportement sera limité à ce cache seulement,
et n'affectera pas les opérations des autres caches qui peuvent
s'insérer entre le client et le serveur, et ce type de configuration
ne doit donc être utiliser qu'en cas de nécessité absolue.
La RFC 2616 permet au cache de renvoyer des données périmées
pendant que l'entrée périmée correspondante est mise à jour depuis
le serveur original, et mod_cache supporte cette
fonctionnalité lorsque la directive CacheLock est configurée en
conséquence. De telles réponses comportent un en-tête HTTP Warning
contenant un code de réponse 110. La RFC 2616 permet aussi au cache
de renvoyer des données périmées lorsque la tentative de mise à jour
des données périmées renvoie une erreur 500 ou supérieure, et cette
fonctionnalité est supportée par défaut par
mod_cache. De telles réponses comportent un en-tête HTTP Warning
contenant un code de réponse 111.
mod_cache requiert les services d'un ou
plusieurs modules de gestion de stockage. La distribution Apache de base
inclut les modules de gestion de stockage suivants :
mod_cache_diskhtcacheclean permet de lister et de supprimer les
URLs mises en cache, et de maintenir le cache en deçà de
certaines limites de taille et de nombre d'inodes.mod_cache_socachePour de plus amples détails, une description, et des exemples, reportez-vous au Guide de la mise en cache.
Modules apparentés et directives Exemple de configuration Eviter une tempête de requête Contrôle fin via le filtre CACHE Etat du cache et journalisation CacheDefaultExpire CacheDetailHeader CacheDisable CacheEnable CacheHeader CacheIgnoreCacheControl CacheIgnoreHeaders CacheIgnoreNoLastMod CacheIgnoreQueryString CacheIgnoreURLSessionIdentifiers CacheKeyBaseURL CacheLastModifiedFactor CacheLock CacheLockMaxAge CacheLockPath CacheMaxExpire CacheMinExpire CacheQuickHandler CacheStaleOnError CacheStoreExpired CacheStoreNoStore CacheStorePrivate| Modules Apparentés | Directives Apparentées |
|---|---|
#
# Exemple de configuration du cache
#
LoadModule cache_module modules/mod_cache.so
<IfModule mod_cache.c>
LoadModule cache_disk_module modules/mod_cache_disk.so
<IfModule mod_cache_disk.c>
CacheRoot "c:/cacheroot"
CacheEnable disk "/"
CacheDirLevels 5
CacheDirLength 3
</IfModule>
# Lorsqu'on sert de mandataire, on ne met pas en cache la liste
# des mises à jour de sécurité
CacheDisable "http://security.update.server/update-list/"
</IfModule>
Lorsqu'une entrée du cache est périmée, mod_cache
soumet une requête conditionnelle au processus d'arrière-plan, qui est
censé confirmer la validité de l'entrée du cache, ou dans la négative
envoyer une entrée mise à jour.
Un court mais non négligeable laps de temps existe entre le moment où l'entrée du cache est périmée, et le moment où elle est mise à jour. Sur un serveur fortement chargé, un certain nombre de requêtes peut arriver pendant ce laps de temps, et provoquer une tempête de requêtes susceptibles de saturer le processus d'arrière-plan de manière soudaine et imprédictible.
Pour contenir cette tempête, on peut utiliser la directive CacheLock afin de définir un répertoire où
seront créés à la volée des verrous pour les URLs. Ces
verrous sont utilisés comme autant d'indications par les
autres requêtes, soit pour empêcher une tentative de mise en cache (un autre
processus est en train de récupérer l'entité), soit pour indiquer qu'une
entrée périmée est en cours de mise à jour (pendant ce temps, c'est le contenu
périmé qui sera renvoyé).
Lorsqu'une entité est mise en cache pour la première fois, un verrou est créé pour cette entité jusqu'à ce que la réponse ait été entièrement mise en cache. Pendant la durée de vie du verrou, le cache va empêcher une seconde tentative de mise en cache de la même entité. Bien que cela ne suffise pas à contenir la tempête de requêtes, toute tentative de mettre en cache la même entité plusieurs fois simultanément est stoppée.
Lorsqu'une entrée atteint la limite de sa durée de vie, et devient par conséquent périmée, un verrou est créé pour cette entité jusqu'à ce que la réponse ait été soit confirmée comme encore valide, soit remplacée par le processus d'arrière-plan. Pendant la durée de vie du verrou, une seconde requête entrante va provoquer le renvoi de la donnée périmée, et la tempête de requêtes sera contenue.
Les verrous ne sont utilisés qu'à titre indicatif pour enjoindre le cache à être plus coopératif avec les serveurs d'arrière-plan, et il est possible de passer outre si nécessaire. Si le client envoie une requête contenant un en-tête Cache-Control imposant un nouveau téléchargement de l'entité, tout verrou éventuel sera ignoré, la requête du client sera honorée immédiatement, et l'entrée du cache mise à jour.
Comme mécanisme de sécurité supplémentaire, la durée de vie maximale des
verrous est configurable. Lorsque cette limite est atteinte, le verrou est
supprimé et une autre requête peut alors en créer un nouveau. Cette durée de
vie peut être définie via la directive CacheMaxExpire, et sa valeur par défaut est
de 5 secondes.
#
# Active le verrouillage du cache
#
<IfModule mod_cache.c>
CacheLock on
CacheLockPath "/tmp/mod_cache-lock"
CacheLockMaxAge 5
</IfModule>
Dans son mode de fonctionnement par défaut, le cache s'exécute sous la forme d'un gestionnaire rapide, court-circuitant la majorité des traitements du serveur et fournissant ainsi une mise en cache possédant les plus hautes performances disponibles.
Dans ce mode, le cache s'incruste devant le serveur, comme si un mandataire de mise en cache indépendant RFC 2616 était placé devant ce dernier.
Bien que que ce mode offre les meilleures performances, les administrateurs peuvent souhaiter, dans certaines circonstances, effectuer des traitements sur la requête après que cette dernière ait été mise en cache, comme ajouter du contenu personnalisé à la page mise en cache, ou appliquer des restrictions d'autorisations au contenu. Pour y parvenir, l'administrateur sera alors souvent forcé de placer des serveurs mandataires inverses indépendants soit derrière, soit devant le serveur de mise en cache.
Pour résoudre ce problème, la directive CacheQuickHandler peut être définie à
off, afin que le serveur traite toutes les phases
normalement exécutées par une requête non mise en cache, y compris les
phases d'authentification et d'autorisation.
En outre, l'administrateur peut éventuellement spécifier le point précis dans la chaîne de filtrage où devra intervenir la mise en cache en ajoutant le filtre CACHE à la chaîne de filtrage en sortie.
Par exemple, pour mettre en cache le contenu avant d'appliquer une compression à la réponse, placez le filtre CACHE avant le filtre DEFLATE comme dans l'exemple suivant :
# Mise en cache du contenu avant la compression optionnelle CacheQuickHandler off AddOutputFilterByType CACHE;DEFLATE text/plain
Une autre possibilité consiste à mettre en cache le contenu avant
l'ajout de contenu personnalisé via mod_include (ou
tout autre filtre de traitement de contenu). Dans l'exemple suivant,
les modèles contenant des balises comprises par
mod_include sont mis en cache avant d'être
interprétés :
# Mise en cache du contenu avant l'intervention de mod_include et # mod_deflate CacheQuickHandler off AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html
Vous pouvez insérer le filtre CACHE en tout point
de la chaîne de filtrage. Dans l'exemple suivant, le contenu est mis
en cache après avoir été interprété par mod_include,
mais avant d'être traité par mod_deflate :
# Mise en cache du contenu entre les interventions de mod_include et # mod_deflate CacheQuickHandler off AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html
mod_cache n'est pas
en mesure d'effectuer cette opération à votre place.Lorsque mod_cache a décidé s'il devait ou non
servir une entité depuis le cache, les raisons précises de cette
décision sont enregistrées dans l'environnement du sous-processus
interne à la requête sous la clé cache-status.
Cette information peut être journalisée via la directive LogFormat comme suit :
LogFormat "%{cache-status}e ..."
En fonction de la décision prise, l'information est aussi écrite dans l'environnement du sous-processus sous une des quatre clés suivantes :
Il est alors possible d'envisager une journalisation conditionnelle du traitement des requêtes par rapport au cache comme dans l'exemple suivant :
CustomLog "cached-requests.log" common env=cache-hit CustomLog "uncached-requests.log" common env=cache-miss CustomLog "revalidated-requests.log" common env=cache-revalidate CustomLog "invalidated-requests.log" common env=cache-invalidate
Pour les concepteurs de modules, une accroche (hook) nommée cache_status est disponible et permet aux modules de répondre aux résultats de la vérification du cache ci-dessus de manière personnalisée.
| Description: | La durée par défaut de mise en cache d'un document lorsqu'aucune date d'expiration n'a été spécifiée. |
|---|---|
| Syntaxe: | CacheDefaultExpire secondes |
| Défaut: | CacheDefaultExpire 3600 (une heure) |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
La directive CacheDefaultExpire permet de
spécifier un temps par défaut, en secondes, pendant lequel sera conservé
dans le cache un document qui ne possède ni date d'expiration, ni date de
dernière modification. La valeur de cette directive n'est pas
écrasée par la valeur de la directive CacheMaxExpire, même si cette dernière est
utilisée.
CacheDefaultExpire 86400
| Description: | Ajoute un en-tête X-Cache-Detail à la réponse. |
|---|---|
| Syntaxe: | CacheDetailHeader on|off |
| Défaut: | CacheDetailHeader off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
| Compatibilité: | Disponible depuis la version 2.3.9 d'Apache |
Lorsque la directive CacheDetailHeader est définie à
on, un en-tête X-Cache-Detail est ajouté à la réponse et
contient les raisons précises d'une décision d'utilisation du cache vis à vis
de cette dernière.
Ceci peut s'avérer utile au cours du développement de services
RESTful mis en cache pour obtenir des informations supplémentaires à
propos des décisions vis à vis du cache écrites dans les en-têtes de
la réponse. Il est ainsi possible de vérifier si
Cache-Control et d'autres en-têtes ont été correctement
utilisés par le service et le client.
Si le gestionnaire normal est utilisé, cette directive peut se situer dans
une section <Directory> ou
<Location>. Si c'est le
gestionnaire rapide qui est utilisé, elle doit se situer dans un contexte de
serveur principal ou de serveur virtuel, sinon elle sera ignorée.
# Active l'en-tête X-Cache-Detail CacheDetailHeader on
X-Cache-Detail: "conditional cache hit: entity refreshed" from localhost
| Description: | Désactive la mise en cache des URLs spécifiées |
|---|---|
| Syntaxe: | CacheDisable chaîne-url | on |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
La directive CacheDisable enjoint
mod_cache de ne pas mettre en cache l'URL
spécifiée par chaîne URL, ainsi que les URLs de niveaux
inférieurs.
CacheDisable "/fichiers_locaux"
Si la directive se trouve à l'intérieur d'une section <Location>, le chemin doit être
spécifié en dessous de la Location, et si le mot "on" est utilisé, la mise
en cache sera désactivée pour l'ensemble de l'arborescence concernée par la
section Location.
<Location "/foo">
CacheDisable on
</Location>
Avec les versions 2.2.12 et ultérieures, on peut définir la
variable d'environnement no-cache pour une définition
plus fine des ressources à mettre en cache.
| Description: | Active la mise en cache des URLs spécifiées en utilisant le gestionnaire de stockage précisé |
|---|---|
| Syntaxe: | CacheEnable type de cache [chaîne
URL] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_cache |
| Compatibilité: | Une chaîne URL telle que '/' s'appliquait à tout contenu en mandat direct dans les versions 2.2 et antérieures. |
La directive CacheEnable enjoint
mod_cache de mettre en cache l'URL précisée par
chaîne URL, ainsi que les URLs de niveaux inférieurs. Le
gestionnaire de stockage du cache est spécifié à l'aide de l'argument
type de cache. La directive CacheEnable
peut être placée à l'intérieur d'une section <Location> ou <LocationMatch> pour indiquer que le contenu
considéré peut être mis en cache. Si type de cache a pour valeur
disk, mod_cache utilisera le gestionnaire de
stockage sur disque implémenté par
mod_cache_disk. Pour que mod_cache
utilise le gestionnaire de stockage basé sur le cache d'objets
partagés implémenté par mod_cache_socache,
spécifiez socache comme valeur du paramètre type
de cache.
Si les différentes directives CacheEnable
spécifient des URLs qui se recoupent (comme dans l'exemple
ci-dessous), tous les gestionnaires de stockage possibles seront
lancés, jusqu'au premier d'entre eux qui traitera effectivement la
requête.
L'ordre dans lequel les gestionnaires de stockage sont lancés est déterminé
par l'ordre dans lequel apparaissent les directives
CacheEnable dans le fichier de configuration. Les
directives CacheEnable situées à l'intérieur de
sections <Location> ou
<LocationMatch> sont
traitées avant les directives CacheEnable définies au
niveau global.
En fonctionnement du type serveur mandataire direct, chaîne URL doit au moins débuter par un protocole pour lequel la mise en cache doit être activée.
# Mise en cache de contenu (gestionnaire normal seulement)
CacheQuickHandler off
<Location "/foo">
CacheEnable disk
</Location>
# Mise en cache via une expression rationnelle (gestionnaire normal seulement)
CacheQuickHandler off
<LocationMatch "foo$">
CacheEnable disk
</LocationMatch>
# Mise en cache de tous les contenus, à l'exception des URLs
# mandatées en direct (gestionnaire normal ou rapide)
CacheEnable disk /
# Mise en cache des URLs FTP mandatées (gestionnaire normal ou rapide)
CacheEnable disk ftp://
# Mise en cache des contenus mandatés en direct depuis www.example.org (gestionnaire normal ou rapide)
CacheEnable disk http://www.example.org/
Un nom d'hôte commençant par un caractère "*" correspondra à tout nom d'hôte se terminant par le suffixe considéré. Un nom d'hôte commençant par un caractère "." correspondra à tout nom d'hôte contenant le composant de nom de domaine qui suit ce caractère.
# Correspond à www.example.org et fooexample.org CacheEnable disk "http://*example.org/" # Correspond à www.example.org, mais pas à fooexample.org CacheEnable disk "http://.example.org/"
Depuis la version 2.2.12, on peut définir la variable
d'environnement no-cache pour une définition plus fine
des ressources à mettre en cache.
| Description: | Ajoute un en-tête X-Cache à la réponse. |
|---|---|
| Syntaxe: | CacheHeader on|off |
| Défaut: | CacheHeader off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
| Compatibilité: | Disponible depuis la version 2.3.9 d'Apache |
Lorsque la directive CacheHeader est définie à on, un
en-tête X-Cache est ajouté à la réponse et contient
l'état du cache pour cette dernière. Si le gestionnaire normal est
utilisé, cette directive peut se situer dans une section
<Directory> ou
<Location>. Si c'est
le gestionnaire rapide qui est utilisé, elle doit se situer dans un
contexte de serveur principal ou de serveur virtuel, sinon elle sera
ignorée.
# Active l'en-tête X-Cache CacheHeader on
X-Cache: HIT from localhost
| Description: | Ignore les en-têtes de requête enjoignant de ne pas servir le contenu au client depuis le cache |
|---|---|
| Syntaxe: | CacheIgnoreCacheControl On|Off |
| Défaut: | CacheIgnoreCacheControl Off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache |
Normalement, les requêtes contenant des en-têtes tels que
Cache-Control: no-cache ou Pragma: no-cache ne sont pas
servies depuis le cache. La directive
CacheIgnoreCacheControl permet de modifier ce
comportement. Avec CacheIgnoreCacheControl
On, le serveur tentera de servir la ressource depuis le
cache, même si la requête contient un des en-têtes cités plus haut.
Les ressources qui requièrent une autorisation ne seront
jamais mises en cache.
CacheIgnoreCacheControl On
| Description: | Ne pas stocker le(s) en-tête(s) spécifié(s) dans le cache. |
|---|---|
| Syntaxe: | CacheIgnoreHeaders en-tête [en-tête] ... |
| Défaut: | CacheIgnoreHeaders None |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache |
En accord avec la RFC 2616, les en-têtes HTTP hop-by-hop ne sont
pas stockés dans le cache. Les en-têtes HTTP suivant sont des
en-têtes hop-by-hop, et en tant que tels, ne sont en aucun
cas stockés dans le cache, quelle que soit la définition de la
directive CacheIgnoreHeaders :
ConnectionKeep-AliveProxy-AuthenticateProxy-AuthorizationTETrailersTransfer-EncodingUpgradeLa directive CacheIgnoreHeaders permet de
spécifier quels en-têtes HTTP ne doivent pas être stockés dans le
cache. Par exemple, il peut s'avérer pertinent dans certains cas de
ne pas stocker les cookies dans le cache.
La directive CacheIgnoreHeaders accepte
une liste d'en-têtes HTTP séparés par des espaces, qui ne doivent
pas être stockés dans le cache. Si les en-têtes hop-by-hop sont les
seuls à ne pas devoir être stockés dans le cache (le comportement
compatible RFC 2616), la directive
CacheIgnoreHeaders peut être définie à
None.
CacheIgnoreHeaders Set-Cookie
CacheIgnoreHeaders None
Expires, ne sont pas stockés suite à la définition
d'une directive CacheIgnoreHeaders, le
comportement de mod_cache sera imprévisible.
| Description: | Ignore le fait qu'une réponse ne possède pas d'en-tête Last Modified. |
|---|---|
| Syntaxe: | CacheIgnoreNoLastMod On|Off |
| Défaut: | CacheIgnoreNoLastMod Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
Normalement, les documents qui ne possèdent pas de date de
dernière modification ne sont pas mis en cache. Dans certaines
circonstances, la date de dernière modification est supprimée (au
cours des traitements liés à mod_include par
exemple), ou n'existe tout simplement pas. La directive
CacheIgnoreNoLastMod permet de spécifier si
les documents ne possèdant pas de date de dernière modification doivent être
mis en cache, même sans date de dernière modification. Si le document ne
possède ni date d'expiration, ni date de dernière modification, la valeur
spécifiée par la directive CacheDefaultExpire servira à générer une date
d'expiration.
CacheIgnoreNoLastMod On
| Description: | Ignore la chaîne de paramètres lors de la mise en cache |
|---|---|
| Syntaxe: | CacheIgnoreQueryString On|Off |
| Défaut: | CacheIgnoreQueryString Off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache |
Normalement, les requêtes comportant une chaîne de paramètres
sont mises en cache séparément si leurs chaînes de paramètres
diffèrent.
En accord avec la RFC 2616/13.9, cette mise en cache n'est effectuée
séparément que si une date d'expiration est spécifiée. La directive
CacheIgnoreQueryString permet la mise en
cache de requêtes même si aucune date d'expiration est spécifiée, et
de renvoyer une réponse depuis la cache même si les chaînes de
paramètres diffèrent. Du point de vue du cache, la requête est
traitée comme si elle ne possèdait pas de chaîne de paramètres
lorsque cette directive est activée.
CacheIgnoreQueryString On
| Description: | Ignore les identifiants de session définis encodés dans l'URL lors de la mise en cache |
|---|---|
| Syntaxe: | CacheIgnoreURLSessionIdentifiers identifiant
[identifiant] ... |
| Défaut: | CacheIgnoreURLSessionIdentifiers None |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache |
Certaines applications encodent l'identifiant de session dans l'URL comme dans l'exemple suivant :
/une-application/image.gif;jsessionid=123456789/une-application/image.gif?PHPSESSIONID=12345678Ceci implique la mise en cache des ressources séparément pour
chaque session, ce qui n'est en général pas souhaité. La directive
CacheIgnoreURLSessionIdentifiers permet de
définir une liste d'identifiants qui seront supprimés de la clé
utilisée pour identifier une entité dans le cache, de façon à ce que
les ressources ne soient pas stockées séparément pour chaque
session.
CacheIgnoreURLSessionIdentifiers None vide la liste
des identifiants ignorés. Autrement, chaque identifiant spécifié est
ajouté à la liste.
CacheIgnoreURLSessionIdentifiers jsessionid
CacheIgnoreURLSessionIdentifiers None
| Description: | Remplace l'URL de base des clés du cache mandatées en inverse |
|---|---|
| Syntaxe: | CacheKeyBaseURL URL |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache |
| Compatibilité: | Disponible depuis la version 2.3.9 d'Apache |
Lorsque la directive CacheKeyBaseURL est utilisée,
l'URL spécifiée sera utilisée comme URL de base pour calculer l'URL des clés
du cache dans la configuration du mandataire inverse. Par défaut, c'est le
protocole/nom d'hôte/port du serveur virtuel courant qui sera utilisé pour
construire la clé de cache. Dans le cas d'un cluster de machines, si toutes
les entrées du cache doivent posséder la même clé, cette directive permet de
spécifier une nouvelle URL de base.
# Remplace l'URL de base de la clé de cache. CacheKeyBaseURL "http://www.example.com/"
| Description: | Le facteur utilisé pour générer une date d'expiration en fonction de la date de dernière modification. |
|---|---|
| Syntaxe: | CacheLastModifiedFactor flottant |
| Défaut: | CacheLastModifiedFactor 0.1 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
Si un document ne possède pas de date d'expiration, elle peut
être calculée en fonction de la date de dernière modification, si
elle existe. La directive
CacheLastModifiedFactor permet de spécifier
un facteur à utiliser pour la génération de cette date
d'expiration au sein de la formule suivante :
délai-expiration = durée-depuis-date-dernière-modification *
facteur
date-expiration = date-courante + délai-expiration
Par exemple, si la dernière modification du document date de 10
heures, et si facteur a pour valeur 0.1, le délai
d'expiration sera de 10*0.1 = 1 heure. Si l'heure courante est
3:00pm, la date d'expiration calculée sera 3:00pm + 1 heure =
4:00pm.
Si le délai d'expiration est supérieur à celui spécifié par la directive
CacheMaxExpire, c'est ce dernier
qui l'emporte.
CacheLastModifiedFactor 0.5
| Description: | Active la protection contre les tempêtes de requêtes. |
|---|---|
| Syntaxe: | CacheLock on|off |
| Défaut: | CacheLock off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache |
| Compatibilité: | Disponible depuis la version 2.2.15 d'Apache |
La directive CacheLock active la protection
contre les tempêtes de requêtes pour l'espace d'adressage donné.
La configuration minimale pour activer le verrouillage contre les tempêtes de requêtes dans le répertoire temp par défaut du système est la suivante :
# Active le verrouillage du cache CacheLock on
| Description: | Définit la durée de vie maximale d'un verrou de cache. |
|---|---|
| Syntaxe: | CacheLockMaxAge entier |
| Défaut: | CacheLockMaxAge 5 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache |
La directive CacheLockMaxAge permet de
spécifier la durée de vie maximale d'un verrou de cache.
Un verrou plus ancien que cette valeur exprimée en secondes sera ignoré, et la prochaine requête entrante sera alors en mesure de recréer le verrou. Ce mécanisme permet d'éviter les mises à jour trop longues initiées par des clients lents.
| Description: | Définit le répertoire des verrous. |
|---|---|
| Syntaxe: | CacheLockPath répertoire |
| Défaut: | CacheLockPath /tmp/mod_cache-lock |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache |
La directive CacheLockPath permet de
spécifier le répertoire dans lequel les verrous sont créés. Par
défaut, c'est le répertoire temporaire du système qui est utilisé. Les
verrous sont des fichiers vides qui n'existent que pour les URLs
périmées en cours de mise à jour, et consomment donc bien moins de
ressources que le traditionnel cache sur disque.
| Description: | La durée maximale en secondes de mise en cache d'un document |
|---|---|
| Syntaxe: | CacheMaxExpire secondes |
| Défaut: | CacheMaxExpire 86400 (une journée) |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
La directive CacheMaxExpire permet de
spécifier le nombre maximum de secondes pendant lequel les documents
HTTP suceptibles d'être mis en cache seront conservés sans vérifier
leur contenu sur le serveur d'origine. Ce nombre de secondes
correspond donc à la durée maximale pendant laquelle un document ne
sera pas à jour. L'utilisation de cette valeur maximale est forcée,
même si le document possède une date d'expiration.
CacheMaxExpire 604800
| Description: | La durée minimale en secondes de mise en cache d'un document |
|---|---|
| Syntaxe: | CacheMinExpire secondes |
| Défaut: | CacheMinExpire 0 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
La directive CacheMinExpire permet de
spécifier le nombre minimum de secondes pendant lequel les documents
HTTP susceptibles d'être mis en cache seront conservés sans vérifier
leur contenu sur le serveur d'origine. Elle n'est prise en compte
que dans le cas où le document ne possède aucune date d'expiration
valide.
CacheMinExpire 3600
| Description: | Exécute le cache à partir d'un gestionnaire rapide. |
|---|---|
| Syntaxe: | CacheQuickHandler on|off |
| Défaut: | CacheQuickHandler on |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_cache |
| Compatibilité: | Disponible à partir de la version 2.3.3 du serveur HTTP Apache |
La directive CacheQuickHandler permet de contrôler
la phase au cours de laquelle la mise en cache est effectuée.
Avec la configuration par défaut, le cache agit au cours de la phase du gestionnaire rapide. Cette phase court-circuite la majorité des traitements du serveur, et constitue le mode d'opération le plus performant pour un serveur typique. Le cache s'incruste devant le serveur, et la majorité des traitements du serveur est court-circuitée.
Lorsque cette directive est définie à off, le cache agit comme un gestionnaire normal, et est concerné par toutes les phases de traitement d'une requête. Bien que ce mode soit moins performant que le mode par défaut, il permet d'utiliser le cache dans les cas où un traitement complet de la requête est nécessaire, comme par exemple lorsque le contenu est soumis à autorisation.
# Exécute le cache comme un gestionnaire normal CacheQuickHandler off
Lorsque le gestionnaire rapide est désactivé, l'administrateur a aussi la possibilité de choisir avec précision le point de la chaîne de filtrage où la mise en cache sera effectuée, en utilisant le filtre CACHE.
# Mise en cache du contenu avant l'intervention de mod_include et
# mod_deflate
CacheQuickHandler off
AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html
Si le filtre CACHE est spécifié plusieurs fois, c'est la dernière instance qui sera prise en compte.
| Description: | Sert du contenu non à jour à la place de réponses 5xx. |
|---|---|
| Syntaxe: | CacheStaleOnError on|off |
| Défaut: | CacheStaleOnError on |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
| Compatibilité: | Disponible depuis la version 2.3.9 d'Apache |
Lorsque la directive CacheStaleOnError est définie à
on, et si des données non mises à jour sont disponibles dans le cache, ce
dernier renverra ces données, plutôt qu'une éventuelle réponse 5xx en
provenance du serveur d'arrière-plan. Alors que l'en-tête Cache-Control envoyé
par les clients sera respecté, et que les clients recevront donc dans ce cas
la réponse 5xx brute à leur requête, cette réponse 5xx renvoyée au client
n'invalidera pas le contenu dans le cache.
# Sert des données non mises à jour en cas d'erreur. CacheStaleOnError on
| Description: | Tente de mettre en cache les réponses que le serveur considère comme arrivées à expiration |
|---|---|
| Syntaxe: | CacheStoreExpired On|Off |
| Défaut: | CacheStoreExpired Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
Depuis la version 2.2.4, les réponses qui sont arrivées à
expiration ne sont pas stockées dans le cache. La directive
CacheStoreExpired permet de modifier ce
comportement. Avec CacheStoreExpired On, le
serveur tente de mettre en cache la ressource si elle est périmée.
Les requêtes suivantes vont déclencher une requête si-modifié-depuis
de la part du serveur d'origine, et la réponse sera renvoyée à
partir du cache si la ressource d'arrière-plan n'a pas été modifiée.
CacheStoreExpired On
| Description: | Tente de mettre en cache les requêtes ou réponses dont l'entête Cache-Control: a pour valeur no-store. |
|---|---|
| Syntaxe: | CacheStoreNoStore On|Off |
| Défaut: | CacheStoreNoStore Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
Normalement, les requêtes ou réponses dont l'en-tête
Cache-Control: no-store ne sont pas stockées dans le
cache. La directive CacheStoreNoStore permet
de modifier ce comportement. Si
CacheStoreNoStore est définie à On, le
serveur tente de mettre la ressource en cache même si elle contient
des en-têtes ayant pour valeur no-store. Les ressources
nécessitant une autorisation ne sont jamais mises en
cache.
CacheStoreNoStore On
CacheStoreNoCache pourrait provoquer le
stockage d'informations sensibles dans le cache. Vous avez donc
été prévenus.
| Description: | Tente de mettre en cache des réponses que le serveur a marquées comme privées |
|---|---|
| Syntaxe: | CacheStorePrivate On|Off |
| Défaut: | CacheStorePrivate Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_cache |
Normalement, les réponse comportant un en-tête Cache-Control:
private ne seront pas stockées dans le cache. La directive
CacheStorePrivate permet de modifier ce comportement.
Si CacheStorePrivate est définie à On, le serveur
tentera de mettre la ressource en cache, même si elle
contient des en-têtes ayant pour valeur private. Les ressources
nécessitant une autorisation ne sont jamais mises en
cache.
CacheStorePrivate On
Serveur HTTP Apache Version 2.4
| Description: | La sémantique des métafichiers du serveur httpd du CERN |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | cern_meta_module |
| Fichier Source: | mod_cern_meta.c |
Il s'agit d'une émulation de la sémantique des métafichiers du serveur httpd du CERN. Les métafichiers consistent en en-têtes HTTP qui peuvent s'ajouter au jeu d'en-têtes habituels pour chaque fichier accédé. Ils ressemblent beaucoup aux fichiers .asis d'Apache, et permettent d'influencer de manière rudimentaire l'en-tête Expires:, ainsi que d'autres curiosités. Il existe de nombreuses méthodes pour gérer les métainformations, mais le choix s'est porté sur celle-ci car il existe déjà un grand nombre d'utilisateurs du CERN qui peuvent exploiter ce module.
Pour plus d'information, voir le document sur la sémantique des métafichiers du CERN.
| Description: | Le nom du répertoire où trouver les fichiers de métainformations dans le style du CERN |
|---|---|
| Syntaxe: | MetaDir répertoire |
| Défaut: | MetaDir .web |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Extension |
| Module: | mod_cern_meta |
Spécifie le nom du répertoire dans lequel Apache pourra trouver
les fichiers de métainformations. Ce répertoire est en général un
sous-répertoire 'caché' du répertoire qui contient le fichier à
accéder. Définissez cette directive à "." pour
rechercher les métafichiers dans le même répertoire que le fichier à
accéder :
MetaDir .
Ou, pour rechercher dans un sous-répertoire du répertoire contenant le fichier à accéder :
MetaDir .meta
| Description: | Active le traitement des métafichiers du CERN |
|---|---|
| Syntaxe: | MetaFiles on|off |
| Défaut: | MetaFiles off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Extension |
| Module: | mod_cern_meta |
Active ou désactive le traitement des métafichiers pour certains répertoires.
| Description: | Suffixe du fichier contenant les métainformations dans le style du CERN |
|---|---|
| Syntaxe: | MetaSuffix suffixe |
| Défaut: | MetaSuffix .meta |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Indexes |
| Statut: | Extension |
| Module: | mod_cern_meta |
Spécifie le suffixe du fichier contenant les métainformations.
Par exemple, si on conserve les valeurs par défaut des deux
directives précédentes, une requête pour
DOCUMENT_ROOT/un-rep/index.html provoquera la recherche
du métafichier
DOCUMENT_ROOT/un-rep/.web/index.html.meta, et utilisera
son contenu pour générer les informations quant aux en-têtes MIME
additionnels.
MetaSuffix .meta
Serveur HTTP Apache Version 2.4
| Description: | Spécifie dans quel jeu de caractère doivent s'effectuer les traductions ou les réencodages |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | charset_lite_module |
| Fichier Source: | mod_charset_lite.c |
Le module mod_charset_lite permet au serveur de
modifier le jeu de caractères des réponses avant de les envoyer aux
clients. Dans un environnement EBCDIC, Apache traduit toujours les
contenus au protocole HTTP (par exemples les en-têtes de réponses)
de la page de code de la locale du processus Apache vers ISO-8859-1,
mais pas le corps des réponses. Dans tous les environnements, on
peut utiliser mod_charset_lite pour spécifier que
les corps des réponses doivent être traduits. Par exemple, si les
fichiers sont stockés sous forme EBCDIC,
mod_charset_lite pourra les traduire en ISO-8859-1
avant de les envoyer au client.
Ce module fournit quelques procédés de configuration implémentés
par Apache version russe, ainsi que son module
mod_charset associé.
Les noms des jeux de caractères passés en paramètres aux
directives CharsetSourceEnc et
CharsetDefault
doivent être reconnus par le mécanisme de traduction utilisé par
APR sur le système où
mod_charset_lite est utilisé. Ces noms de jeux de
caractères ne sont pas standardisés, et sont en général différents
des valeurs qui leur correspondent dans les en-têtes HTTP.
Actuellement, APR ne peut utiliser que iconv(3) ; vous pouvez donc
tester facilement vos noms de jeux de caractères en utilisant le
programme iconv(1), de la manière suivante :
iconv -f valeur-charsetsourceenc -t valeur-charsetdefault
Si les règles de traduction ne peuvent s'appliquer au contenu, la traduction peut échouer avec des conséquences diverses, comme :
| Description: | Jeu de caractère vers lequel la traduction doit s'effectuer |
|---|---|
| Syntaxe: | CharsetDefault jeu de caractères |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_charset_lite |
La directive CharsetDefault permet de
spécifier le jeu de caractères vers lequel le contenu situé dans le
conteneur associé devra être traduit.
La valeur de l'argument jeu de caractères doit être un nom de jeu de caractères valide du point de vue du support des jeux de caractères dans APR. En général, cela implique qu'elle doit être reconnue par iconv.
<Directory "/export/home/trawick/apacheinst/htdocs/convert">
CharsetSourceEnc UTF-16BE
CharsetDefault ISO-8859-1
</Directory>
CharsetSourceEnc
et CharsetDefault
désactive la traduction. Le jeu de caractères ne doit pas forcément
correspondre au jeu de caractères de la réponse, mais il doit être
valide du point de vue du système.
| Description: | Précise les détails de la traduction du jeu de caractères |
|---|---|
| Syntaxe: | CharsetOptions option [option] ... |
| Défaut: | CharsetOptions ImplicitAdd |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_charset_lite |
La directive CharsetOptions permet de
préciser certains détails du comportement du module
mod_charset_lite. Option accepte les
valeurs suivantes :
ImplicitAdd | NoImplicitAddImplicitAdd indique que
mod_charset_lite doit insérer son filtre de
manière implicite lorsque la configuration indique que le jeu de
caractère du contenu doit être traduit. Si la chaîne de filtrage
est configurée de manière explicite via la directive AddOutputFilter, l'option
NoImplicitAdd doit être utilisée afin que
mod_charset_lite n'ajoute pas son propre
filtre.TranslateAllMimeTypes | NoTranslateAllMimeTypesmod_charset_lite n'effectuera
une traduction qu'en présence d'un petit nombre de types MIME
parmi tous les types possibles. Lorsque l'option
TranslateAllMimeTypes est utilisée pour une section
de configuration donnée, la traduction est effectuée sans se
préoccuper du type MIME.| Description: | Jeu de caractères source des fichiers |
|---|---|
| Syntaxe: | CharsetSourceEnc jeu de caractères |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_charset_lite |
La directive CharsetSourceEnc permet de
spécifier un jeu de caractères source pour les fichiers situés dans
le conteneur associé.
La valeur de l'argument jeu de caractères doit être un nom de jeu de caractères valide du point de vue du support des jeux de caractères dans APR. En général, cela implique qu'elle doit être reconnue par iconv.
<Directory "/export/home/trawick/apacheinst/htdocs/convert">
CharsetSourceEnc UTF-16BE
CharsetDefault ISO-8859-1
</Directory>
Les noms de jeux de caractères de cet exemple sont reconnus par le mécanisme de traduction d'iconv sous Solaris 8.
CharsetSourceEnc
et CharsetDefault
désactive la traduction. Le jeu de caractères ne doit pas forcément
correspondre au jeu de caractères de la réponse, mais il doit être
valide du point de vue du système.
Serveur HTTP Apache Version 2.4
| Description: | Implémente le fournisseur filesystem pour
mod_dav |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | dav_fs_module |
| Fichier Source: | mod_dav_fs.c |
L'activation de ce module nécessite l'utilisation de
mod_dav. C'est un module de support pour mod_dav et à ce titre, il permet l'accès à des ressources
situées dans le système de fichiers du serveur. Le nom formel de ce
fournisseur est filesystem. Les fournisseurs supports
de mod_dav sont invoqués via la directive
Dav :
Dav filesystem
Comme filesystem est le fournisseur par défaut de
mod_dav, vous pouvez vous contenter d'utiliser la
valeur On comme argument de Dav.
| Description: | Chemin de la base de données des verrous DAV |
|---|---|
| Syntaxe: | DavLockDB chemin fichier |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_dav_fs |
La directive DavLockDB permet de spécifier
le chemin complet de la base de données des verrous, sans extension.
Si le chemin n'est pas absolu, il sera considéré comme relatif au
répertoire défini par la directive ServerRoot. L'implémentation de
mod_dav_fs utilise une base de données SDBM pour
surveiller les verrous utilisateurs.
DavLockDB "var/DavLock"
Les utilisateur et groupe sous lesquels Apache s'exécute et qui
sont respectivement définis par les directives User et Group doivent pouvoir écrire dans le
répertoire qui contient le fichier de la base de données des
verrous. Pour des raisons de sécurité, il est recommandé de créer un
répertoire dédié à la base de données des verrous, plutôt que de
modifier les permissions d'un répertoire existant. Dans l'exemple
ci-dessus, Apache va créer des fichiers dans le répertoire
var/, lui-même sous-répertoire du répertoire défini par
la directive ServerRoot, avec le nom de base
DavLock suivi d'une extension choisie par le
serveur.
| Description: | Active la découverte des verrous |
|---|---|
| Syntaxe: | DavLockDiscovery on|off |
| Défaut: | DavLockDiscovery on |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_dav_fs |
| Compatibilité: | Disponible à partir de la version 2.4.55 du serveur HTTP Apache. |
DavLockDiscovery contrôle la
découverte des verrous par la méthode PROPFIND.
Lorsqu'elle est désactivée, PROPFIND renvoie
toujours une section lockdiscovery vide. Ce
réglage améliore les performances dans le cas où des
clients utilisent beaucoup PROPFIND.
DavLockDiscovery off
Serveur HTTP Apache Version 2.4
| Description: | Comprime le contenu avant de le servir au client |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | deflate_module |
| Fichier Source: | mod_deflate.c |
Le module mod_deflate implémente le filtre de
sortie DEFLATE qui permet de comprimer la sortie de
votre serveur avant de l'envoyer au client sur le réseau.
Codages supportés Exemples de configurations Activation de la compression Prise en compte des serveurs mandataires Servir du contenu précompressé DeflateAlterETag DeflateBufferSize DeflateCompressionLevel DeflateFilterNote DeflateInflateLimitRequestBody DeflateInflateRatioBurst DeflateInflateRatioLimit DeflateMemLevel DeflateWindowSizeLe seul codage supporté est gzip afin d'assurer une complète
compatibilité avec les anciens navigateurs. Le codage deflate
n'est donc pas supporté ; voir à ce sujet la documentation de zlib pour une
explication détaillée.
Certaines applications web sont vulnérables aux attaques visant le vol d'information lorsqu'une connexion TLS transmet des données compressées par deflate. Pour plus de détails, étudiez les attaques de la famille "BREACH".
Voici une configuration simple qui comprime les contenus à base de texte courants.
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript
Certaines applications web sont vulnérables aux attaques pour vol d'information lorsque la connexion TLS transmet des données compressées par deflate. Pour plus d'informations, voir en détails la famille d'attaques de type "BREACH".
La compression est implémentée par le filtre DEFLATE. La
directive suivante active la compression des documents dans le
conteneur où elle est placée :
SetOutputFilter DEFLATE SetEnvIfNoCase Request_URI "\.(?:gif|jpe?g|png)$" no-gzip
Si vous voulez limiter la compression à certains types MIME
particuliers, vous pouvez utiliser la directive AddOutputFilterByType. Voici un exemple
où la compression n'est activée que pour les fichiers html de la
documentation d'Apache :
<Directory "/your-server-root/manual">
AddOutputFilterByType DEFLATE text/html
</Directory>
DEFLATE est toujours inséré après les
filtres RESOURCE comme PHP ou SSI. Il n'affecte jamais les
sous-requêtes internes.
force-gzip, définie à
l'aide de la directive SetEnv, permet d'ignorer la
configuration de votre navigateur quant aux codages acceptés, et
d'envoyer sans condition une sortie comprimée.
Le module mod_deflate fournit aussi un filtre
permettant de décomprimer un corps de réponse comprimé par gzip.
Pour activer cette fonctionnalité, vous devez insérer le filtre
INFLATE dans la chaîne de filtrage en sortie via la
directive SetOutputFilter ou
AddOutputFilter, comme
dans l'exemple suivant :
<Location "/dav-area">
ProxyPass "http://example.com/"
SetOutputFilter INFLATE
</Location>
Dans cet exemple, les sorties comprimées par gzip en provenance de example.com seront décomprimées afin de pouvoir être éventuellement traitées par d'autres filtres.
Le module mod_deflate fournit également un filtre
permettant de décomprimer un corps de requête comprimé par gzip.
Pour activer cette fonctionnalité, vous devez insérer le filtre
DEFLATE dans la chaîne de filtrage en entrée via la
directive SetInputFilter ou
AddInputFilter, comme
dans l'exemple suivant :
<Location "/dav-area">
SetInputFilter DEFLATE
</Location>
Désormais, si une requête contient un en-tête
Content-Encoding: gzip, son corps sera
automatiquement décomprimé. Peu de navigateurs sont actuellement
en mesure de comprimer les corps de requêtes. Cependant,
certaines applications spécialisées supportent les requêtes
comprimées, comme par exemple certains clients WebDAV.
Content-LengthSi vous évaluez vous-même la taille du corps de requête,
ne faites pas confiance à l'en-tête
Content-Length! L'en-tête
Content-Length indique la longueur des données en provenance du
client, et non la quantité d'octets que représente le
flux de données décompressé.
Le module mod_deflate envoie un en-tête de
réponse HTTP Vary: Accept-Encoding pour avertir les
mandataires qu'une réponse enregistrée dans le cache ne doit être
envoyée qu'aux clients qui ont envoyé l'en-tête de requête
Accept-Encoding approprié. Ceci permet d'éviter l'envoi
d'un contenu comprimé à un client qui ne sera pas en mesure
de l'interpréter.
Si vous avez défini des exclusions spécifiques dépendant, par
exemple, de l'en-tête User-Agent, vous devez
ajouter manuellement des données à l'en-tête Vary afin
d'informer les mandataires des restrictions supplémentaires. Par
exemple, dans la configuration classique où l'addition du filtre
DEFLATE dépend du contenu de l'en-tête
User-Agent, vous devez spécifier :
Header append Vary User-Agent
Si votre décision de comprimer le contenu dépend d'autres
informations que celles contenues dans les en-têtes de la requête
(par exemple la version HTTP), vous devez attribuer à l'en-tête
Vary la valeur *, ce qui permet d'empêcher
les mandataires compatibles de tout mettre en cache.
Header set Vary *
Comme mod_deflate recompresse le contenu demandé à
chaque requête, il est possible de gagner en performances en précompressant
ce contenu, et en forçant mod_deflate à servir ce contenu
précompressé sans avoir à le recompresser à chaque requête. Pour ce faire,
utilisez une configuration du style :
<IfModule mod_headers.c>
# Servir des fichiers CSS et JS compressés avec gzip, s'ils existent, et
# si le client accepte gzip.
RewriteCond "%{HTTP:Accept-encoding}" "gzip"
RewriteCond "%{REQUEST_FILENAME}\.gz" -s
RewriteRule "^(.*)\.(css|js)" "$1\.$2\.gz" [QSA]
# Servir des types de contenus corrects, et empêcher mod_deflate
# d'effectuer un double gzip.
RewriteRule "\.css\.gz$" "-" [T=text/css,E=no-gzip:1]
RewriteRule "\.js\.gz$" "-" [T=text/javascript,E=no-gzip:1]
<FilesMatch "(\.js\.gz|\.css\.gz)$">
# Servir le type de codage correct.
Header append Content-Encoding gzip
# Force les mandataires à mettre en cache séparément les fichiers
# css/js gzippés & non gzippés.
Header append Vary Accept-Encoding
</FilesMatch>
</IfModule>
| Description: | Comment l'en-tête sortant ETag doit être modifié au cours de la compression |
|---|---|
| Syntaxe: | DeflateAlterETag AddSuffix|NoChange|Remove |
| Défaut: | DeflateAlterETag AddSuffix |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_deflate |
| Compatibilité: | Disponible à partir de la version 2.4.58 du serveur HTTP Apache |
La directive DeflateAlterETag permet de
spécifier comment l'en-tête ETag doit être modifié lorsqu'une
réponse est compressée.
Ajoute la méthode de compression à la fin de l'en-tête, ce qui a pour effet d'attribuer un en-tête ETag unique aux représentations compressées et non compressées. C'est l'option par défaut depuis la version 2.4.0, mais empêche de servir des codes d'état "HTTP Not Modified" (304) en réponse aux requêtes pour un contenu compressé.
Ne modifie pas l'en-tête ETag dans une réponse compressée. C'était l'option par défaut avant la version 2.4.0, mais cela ne respectait pas la préconisation HTTP/1.1 selon laquelle chaque représentation de la même ressource doit posséder un en-tête ETag unique.
Supprime l'en-tête ETag dans les réponses compressées, ce qui a pour effet de rendre impossibles certaines requêtes conditionnelles, mais permet d'éviter les inconvénients des options précédentes.
| Description: | Taille du fragment que zlib devra comprimer en une seule fois |
|---|---|
| Syntaxe: | DeflateBufferSize valeur |
| Défaut: | DeflateBufferSize 8096 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_deflate |
La directive DeflateBufferSize permet de
spécifier la taille en octets du fragment que zlib devra comprimer
en une seule fois. Si la taille de la réponse compressée est supérieure à
celle spécifiée par cette directive, httpd passera à un mode d'encodage
fragmenté (l'en-tête HTTP Transfer-Encoding prend la valeur
Chunked), ceci ayant comme effet de bord de ne définir aucun
en-tête HTTP Content-Length. Il est important de connaître ce
comportement, particulièrement lorsque httpd travaille derrière des
mandataires inverses avec mise en cache, ou lorsque httpd est configuré pour
utiliser mod_cache et mod_cache_disk car
les réponses HTTP sans en-tête Content-Length peuvent ne pas
être mises en cache.
| Description: | Le niveau de compression que nous appliquons à la sortie |
|---|---|
| Syntaxe: | DeflateCompressionLevel valeur |
| Défaut: | La valeur par défaut de zlib |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_deflate |
La directive DeflateCompressionLevel
permet de spécifier le niveau de compression à utiliser ; plus
grande est la valeur, meilleure sera la compression, mais plus grand
sera aussi le temps CPU nécessaire pour effectuer le
traitement.
La valeur doit être comprise entre 1 (compression minimale) et 9 (compression maximale).
| Description: | Enregistre le taux de compression sous la forme d'une note à des fins de journalisation |
|---|---|
| Syntaxe: | DeflateFilterNote [type] nom de la note |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_deflate |
La directive DeflateFilterNote permet de
spécifier qu'une note à propos du taux de compression doit être
attachée à la requête. Le nom de la note est passé sous la forme
d'un argument de la directive. Vous pouvez utiliser cette note à des
fins statistiques en enregistrant sa valeur dans votre journal des accès.
DeflateFilterNote ratio
LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate
CustomLog "logs/deflate_log" deflate
Pour extraire des informations plus précises de vos journaux, vous pouvez utiliser l'argument type pour spécifier le type de données de la note enregistrée dans le journal. type peut prendre une des valeurs suivantes :
InputOutputRatiosortie/entrée *
100) dans la note. Il s'agit de la valeur par défaut si
l'argument type est omis.Vous pouvez donc configurer votre journalisation de la manière suivante :
DeflateFilterNote Input instream
DeflateFilterNote Output outstream
DeflateFilterNote Ratio ratio
LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
CustomLog "logs/deflate_log" deflate
| Description: | Taille maximale des corps de requête décompressés |
|---|---|
| Syntaxe: | DeflateInflateLimitRequestBody value |
| Défaut: | Aucune limite, mais LimitRequestBody s'applique après la
compression |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_deflate |
| Compatibilité: | Disponible à partir de la version 2.4.10 du serveur HTTP Apache |
La directive
DeflateInflateLimitRequestBody permet de
spécifier la taille maximale d'un corps de requête décompressé. Si
elle n'est pas définie, c'est la valeur de la directive LimitRequestBody qui s'applique au corps
de requête décompressé.
| Description: | Nombre maximal de fois que le ratio de décompression d'un corps de requête peut être dépassé |
|---|---|
| Syntaxe: | DeflateInflateRatioBurst value |
| Défaut: | DeflateInflateRatioBurst 3 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_deflate |
| Compatibilité: | Disponible à partir de la version 2.4.10 du serveur HTTP Apache |
La directive DeflateInflateRatioBurst permet de
spécifier le nombre maximal de fois que la valeur de la directive DeflateInflateRatioLimit peut être dépassé
avant l'arrêt du traitement de la requête.
| Description: | Ratio de décompression maximum pour les corps de requêtes |
|---|---|
| Syntaxe: | DeflateInflateRatioLimit value |
| Défaut: | DeflateInflateRatioLimit 200 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_deflate |
| Compatibilité: | Disponible à partir de la version 2.4.10 du serveur HTTP Apache |
La directive DeflateInflateRatioLimit permet de
définir le ratio maximum entre la taille d'un corps de requête compressé et
sa taille décompressée. Ce ratio est vérifié au fur et à mesure de l'arrivée
du corps de requête, et s'il est dépassé plus de DeflateInflateRatioBurst fois, le
traitement de la requête est interrompu.
| Description: | La quantité de mémoire utilisable par zlib pour la compression |
|---|---|
| Syntaxe: | DeflateMemLevel valeur |
| Défaut: | DeflateMemLevel 9 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_deflate |
La directive DeflateMemLevel permet de
spécifier la quantité de mémoire utilisable par zlib pour la
compression (une valeur comprise entre 1 et 9).
| Description: | Taille de la fenêtre de compression zlib |
|---|---|
| Syntaxe: | DeflateWindowSize valeur |
| Défaut: | DeflateWindowSize 15 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_deflate |
La directive DeflateWindowSize permet de
spécifier la fenêtre de compression zlib (une valeur comprise entre
1 et 15). En général, plus grande sera la taille de la fenêtre, plus
grand sera le taux de compression auquel on pourra s'attendre.
Serveur HTTP Apache Version 2.4
| Description: | Enregistre toutes les entrées/sorties dans le journal des erreurs de la manière souhaitée. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | dumpio_module |
| Fichier Source: | mod_dumpio.c |
mod_dumpio permet d'enregistrer toutes les entrées
reçues par Apache et/ou toutes les sorties envoyées par ce dernier
dans le fichier error.log.
L'enregistrement des données s'effectue juste après le décodage SSL (pour les entrées), et juste avant le codage SSL (pour les sorties). Comme on peut s'y attendre, tout ceci peut représenter un volume important de données, et ne doit être utilisé qu'à des fins de débogage.
Pour activer le module, ce dernier doit être compilé et chargé
par l'intermédiaire de la configuration de votre instance d'Apache.
La journalisation peut ensuite être activée ou désactivée séparément
pour les entrées et sorties à l'aide des directives ci-dessous. En
outre, mod_dumpio doit être configuré à LogLevel trace7 :
LogLevel dumpio:trace7
| Description: | Enregistre toutes les entrées dans le journal des erreurs |
|---|---|
| Syntaxe: | DumpIOInput On|Off |
| Défaut: | DumpIOInput Off |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_dumpio |
| Compatibilité: | DumpIOInput est disponible depuis la version 2.1.3 d'Apache. |
Active la journalisation de toutes les entrées.
DumpIOInput On
| Description: | Enregistre toutes les sorties dans le journal des erreurs |
|---|---|
| Syntaxe: | DumpIOOutput On|Off |
| Défaut: | DumpIOOutput Off |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_dumpio |
| Compatibilité: | DumpIOOutput est disponible depuis la version 2.1.3 d'Apache. |
Active la journalisation de toutes les sorties.
DumpIOOutput On
Serveur HTTP Apache Version 2.4
| Description: | Mise en cache mémoire d'une liste statique de fichiers |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | file_cache_module |
| Fichier Source: | mod_file_cache.c |
mod_file_cache peut facilement conduire à la
création d'un site inopérant.
La mise en cache de fichiers souvent demandés mais rarement
modifiés est une technique permettant de réduire la charge du
serveur. mod_file_cache met en oeuvre deux
techniques de mise en cache de fichiers statiques
fréquemment demandés. Des directives de configuration vous
permettent d'indiquer à mod_file_cache soit
d'ouvrir et de charger une image en mémoire d'un fichier avec
mmap(), soit de préouvrir un fichier et de maintenir en
service le gestionnaire du fichier. Les deux techniques
permettent de réduire la charge du serveur lors du traitement des
requêtes concernant ces fichiers, en accomplissant une partie du
travail nécessaire à la mise à disposition de ces fichiers (en
particulier les opérations d'entrées/sorties sur les fichiers) au
démarrage du serveur, plutôt qu'au cours de chaque requête.
Note : ces techniques sont inutilisables pour accélérer des programmes CGI ou d'autres fichiers servis par des gestionnaires de contenu spéciaux. Elles ne peuvent être utilisées que pour des fichiers standards, normalement servis par le gestionnaire de contenu de base d'Apache.
Ce module est une extension du module
d'Apache 1.3 mod_mmap_staticet s'en inspire
fortement .
mod_file_cache gère la mise en cache d'une liste
de fichiers définie de manière statique via une des directives
MMapFile ou
CacheFile au niveau
de la configuration du serveur principal.
Les deux directives ne sont pas supportées par toutes les
plates-formes. Par exemple, Apache pour Windows ne supporte pas
actuellement la directive MMapFile, alors que d'autres
plates-formes, comme AIX, supportent les deux. Vous recevrez un
message d'erreur dans le journal des erreurs du serveur si vous
essayez d'utiliser une directive non supportée. Si vous utilisez une
directive non supportée, le serveur démarrera, mais les fichiers ne
seront pas mis en cache. Sur les plates-formes qui supportent les
deux directives, vous devez faire des essais afin de déterminer
quelle directive vous convient le mieux.
La directive MMapFile du module
mod_file_cache permet de transférer en mémoire
une liste statique de fichiers à l'aide de l'appel système
mmap(). Cet appel système est disponible sur la
plupart des plates-formes de style Unix, mais pas sur toutes. Il
existe parfois des limites spécifiques au système quant à la
taille et au nombre de fichiers qui peuvent être
mmap()és, et l'expérimentation est probablement la
méthode la plus simple pour déterminer ces limites.
Ce mmap()age n'est effectué qu'une seul fois au
démarrage ou redémarrage du serveur. Ainsi, chaque fois qu'un des
fichiers chargés en mémoire est modifié au niveau du système de
fichiers, vous devez redémarrer le serveur (voir la
documentation sur l'Arrêt et redémarrage). Pour bien
insister sur ce point, si des fichiers sont modifiés sur
disque, et si vous ne redémarrez pas le serveur, vous allez
finir par servir des contenus complètement obsolètes. Vous devez
mettre à jour les fichiers en renommant l'ancienne version et en
enregistrant la nouvelle sur disque. Pour y parvenir, on peut
utiliser des outils comme rdist et mv.
La raison pour laquelle ce module ne prend pas en compte les
modifications de fichiers réside dans le fait que cette
vérification nécessiterait un appel à stat() à chaque
accès, et en fin de compte, l'augmentation de la consommation de
ressources finirait par aller contre le but initial de
réduire les entrées/sorties.
La directive CacheFile du module
mod_file_cache permet d'associer un
gestionnaire ou descripteur de fichier à chaque
fichier énuméré dans la directive de configuration et place ces
gestionnaires de fichiers ouverts dans le cache. Lorsqu'un des
fichier est demandé, le serveur sélectionne son gestionnaire dans
le cache et le transmet à l'API sendfile() (ou
TransmitFile() sous Windows).
Cette mise en cache des gestionnaire n'est effectuée qu'une
seule fois au démarrage ou redémarrage du système. Ainsi, chaque
fois qu'un des fichiers chargés en mémoire est modifié au niveau
du système de fichiers, vous devez redémarrer le serveur
(voir la documentation sur l'Arrêt et redémarrage).
Pour bien
insister sur ce point, si des fichiers sont modifiés sur
disque, et si vous ne redémarrez pas le serveur, vous allez
finir par servir des contenus complètement obsolètes. Vous devez
mettre à jour les fichiers en renommant l'ancienne version et en
enregistrant la nouvelle sur disque. Pour y parvenir, on peut
utiliser des outils comme rdist et
mv.
Ne cherchez pas à trouver de directive qui met tous les
fichiers d'un répertoire en cache, de manière récursive. Pour y
parvenir, vous pouvez vous reporter à la directive Include directive, et considérer cette
commande :
find /www/htdocs -type f -print \
| sed -e 's/.*/mmapfile &/' > /www/conf/mmap.conf
| Description: | Met en cache une liste de gestionnaires de fichiers au démarrage |
|---|---|
| Syntaxe: | CacheFile chemin fichier [chemin fichier] ... |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_file_cache |
La directive CacheFile permet d'associer
des gestionnaires à un ou plusieurs fichiers (séparés par des
espaces), et de placer ceux-ci dans le cache au démarrage du
serveur. Les gestionnaires des fichiers mis en cache sont
automatiquement fermés à l'arrêt du serveur. Lorsqu'un ou plusieurs
fichiers ont été modifiés sur disque, le serveur doit être redémarré
afin que les modifications soient prises en compte par le cache.
Soyez prudent avec les arguments chemin fichier : ils
doivent correspondre exactement au chemin du système de fichier que
créent les gestionnaires de traduction URL-vers-nom-fichier
d'Apache. On ne peut pas comparer des inodes ou autres identifiants
pour mettre en correspondance des chemins à l'aide de liens
symboliques (etc...), car là encore, ceci nécessiterait un
appel à stat() supplémentaire, ce qui n'est pas acceptable.
Il n'est pas garanti que ce module fonctionne avec des noms de
fichiers réécrits par mod_alias ou
mod_rewrite.
CacheFile /usr/local/apache/htdocs/index.html
| Description: | Charge au démarrage une liste de fichiers en mémoire |
|---|---|
| Syntaxe: | MMapFile chemin fichier [chemin fichier] ... |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_file_cache |
La directive MMapFile permet de charger un
ou plusieurs fichiers (séparés par des espaces) en mémoire au
démarrage du serveur. Ceux-ci sont automatiquement déchargés de la
mémoire à l'arrêt du serveur. Lorsqu'un ou plusieurs fichiers ont
été modifiés sur disque, on doit au minimum envoyer un signal
HUP ou USR1 au serveur afin de les
remmap()er.
Soyez prudent avec les arguments chemin fichier : ils
doivent correspondre exactement au chemin du système de fichier que
créent les gestionnaires de traduction URL-vers-nom-fichier
d'Apache. On ne peut pas comparer des inodes ou autres identifiants
pour mettre en correspondance des chemins à l'aide de liens
symboliques (etc...), car là encore, ceci nécessiterait un
appel à stat() supplémentaire, ce qui n'est pas
acceptable.
Il n'est pas garanti que ce module fonctionne avec des noms de
fichiers réécrits par mod_alias ou
mod_rewrite.
MMapFile /usr/local/apache/htdocs/index.html
Serveur HTTP Apache Version 2.4
| Description: | Envoie des messages d'état au mandataire frontal |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | heartbeat_module |
| Fichier Source: | mod_heartbeat |
| Compatibilité: | Disponible à partir de la version 2.3 du serveur HTTP Apache |
mod_heartbeat envoie à un moniteur
mod_heartmonitor des messages multicast l'informant
du nombre de connexions courantes. En général,
mod_heartmonitor est chargé sur un serveur
mandataire où mod_lbmethod_heartbeat est chargé, ce
qui permet d'utiliser la lbmethod "heartbeat" au sein des
directives ProxyPass.
Le module mod_heartbeat est chargé sur le
serveur d'origine qui sert les requêtes via le
serveur mandataire.
mod_heartbeat,
mod_status et mod_watchdog
doivent être soit des modules statiques, soit des modules
dynamiques, et dans ce dernier cas, ils doivent être chargés
avant mod_heartbeat.
Chaque seconde, ce module génère un paquet multicast UDP contenant le nombre de threads/processus occupés et en attente. Le paquet possède un format ASCII simple similaire aux paramètres de requête GET en HTTP.
v=1&ready=75&busy=0
Les utilisateurs disposeront dans le futur de nouvelles variables en plus de busy et ready, et toujours séparées par des '&'.
| Description: | Adresse multicast à laquelle envoyer les requêtes heartbeat |
|---|---|
| Syntaxe: | HeartbeatAddress addr:port |
| Défaut: | disabled |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_heartbeat |
La directive HeartbeatAddress permet de
spécifier l'adresse multicast à laquelle mod_heartbeat va
envoyer ses informations. En général, cette adresse correspond à la
valeur définie par la directive HeartbeatListen sur le serveur
mandataire frontal.
HeartbeatAddress 239.0.0.1:27999
Serveur HTTP Apache Version 2.4
| Description: | Extensions ISAPI dans Apache pour Windows |
|---|---|
| Statut: | Base |
| Identificateur de Module: | isapi_module |
| Fichier Source: | mod_isapi.c |
| Compatibilité: | Win32 only |
Ce module implémente l'API des extensions du Serveur Internet. Il permet à Apache pour Windows de servir les extensions du Serveur Internet (par exemple les modules .dll ISAPI), compte tenu des restrictions spécifiées.
Les modules d'extension ISAPI (fichiers .dll) sont des modules tiers. Leur auteur n'est pas le Groupe Apache, et nous n'assurons donc pas leur support. Veuillez contacter directement l'auteur d'ISAPI si vous rencontrez des problèmes à l'exécution d'une extension ISAPI. Merci de ne pas soumettre ce genre de problème dans les listes d'Apache ou dans les pages de rapports de bogues.
ISAPIAppendLogToErrors ISAPIAppendLogToQuery ISAPICacheFile ISAPIFakeAsync ISAPILogNotSupported ISAPIReadAheadBufferDans le fichier de configuration du serveur, utilisez la
directive AddHandler pour
associer les fichiers ISAPI au gestionnaire
isapi-handler à l'aide de l'extension de leur nom de
fichier. Pour faire en sorte que tout fichier .dll soit traité en
tant qu'extension ISAPI, éditez le fichier httpd.conf et ajoutez les
lignes suivantes :
AddHandler isapi-handler .dll
isapi-isa au lieu de
isapi-handler. Depuis les versions de développement 2.3
du serveur Apache, isapi-isa n'est plus valide, et vous
devrez éventuellement modifier votre configuration pour utiliser
isapi-handler à la place.Le serveur Apache ne propose aucun moyen de conserver en mémoire un module chargé. Vous pouvez cependant précharger et garder un module spécifique en mémoire en utilisant la syntaxe suivante dans votre httpd.conf :
ISAPICacheFile c:/WebWork/Scripts/ISAPI/mytest.dll
Que vous ayez ou non préchargé une extension ISAPI, ces dernières
sont toutes soumises au mêmes restrictions et possèdent les mêmes
permissions que les scripts CGI. En d'autres termes, Options ExecCGI doit être
défini pour le répertoire qui contient le fichier .dll ISAPI.
Reportez-vous aux Notes additionnelles et au
Journal du programmeur pour plus de détails
et une clarification à propos du support spécifique ISAPI fourni par
le module mod_isapi.
L'implémentation ISAPI d'Apache se conforme à toutes les
spécifications ISAPI 2.0, à l'exception de certaines extensions
"spécifiques Microsoft" utilisant des entrées/sorties asynchrones.
Le modèle des entrées/sorties d'Apache ne permet pas l'écriture et
la lecture asynchrone de la manière dont ISAPI pourrait le faire. Si
une extension tente d'utiliser des fonctionnalités non supportées,
comme les entrées/sorties asynchrones, un message est enregistré
dans le journal des erreurs afin d'aider au débogage. Comme ces
messages peuvent devenir envahissants, la directive
ISAPILogNotSupported Off permet de filter ce bruit de
fond.
Si aucune option de configuration particulière n'est spécifiée,
certains serveurs, comme Microsoft IIS, chargent l'extension ISAPI
dans le serveur et la conservent en mémoire jusqu'à ce que
l'utilisation de cette dernière devienne trop élevée. Apache, par
contre, charge et décharge réellement l'extension ISAPI chaque fois
qu'elle est invoquée, si la directive ISAPICacheFile n'a pas été spécifiée.
Ce n'est pas très performant, mais le modèle de mémoire d'Apache
fait que cette méthode est la plus efficace. De nombreux modules
ISAPI présentent des incompatibilités subtiles avec le serveur
Apache, et le déchargement de ces modules permet d'assurer la
stabilité du serveur.
En outre, gardez à l'esprit que si Apache supporte les extensions ISAPI, il ne supporte pas les filtres ISAPI. Le support des filtres sera peut-être ajouté dans le futur, mais n'a pas encore été planifié.
Si vous écrivez des modules mod_isapi Apache
2.0, vous devez limiter vos appels à
ServerSupportFunction aux directives suivantes :
HSE_REQ_SEND_URL_REDIRECT_RESPhttp://serveur/chemin).HSE_REQ_SEND_URL/chemin).Dans sa documentation récente, Microsoft semble avoir
abandonné la distinction entre les deux fonctions
HSE_REQ_SEND_URL. Apache, quant à lui, continue de
les traiter comme deux fonctions distinctes avec des contraintes
et des comportements spécifiques.
HSE_REQ_SEND_RESPONSE_HEADERHSE_REQ_DONE_WITH_SESSIONHSE_REQ_MAP_URL_TO_PATHHSE_APPEND_LOG_PARAMETER\"%{isapi-parameter}n\"
d'une directive CustomLog%q avec la directive
ISAPIAppendLogToQuery
OnISAPIAppendLogToErrors
OnLa première option, le composant
%{isapi-parameter}n, est préférable et toujours
disponible.
HSE_REQ_IS_KEEP_CONNHSE_REQ_SEND_RESPONSE_HEADER_EXfKeepConn soit ignoré.HSE_REQ_IS_CONNECTEDApache renvoie FALSE pour tout appel non supporté à
ServerSupportFunction, et GetLastError
renverra la valeur ERROR_INVALID_PARAMETER.
ReadClient extrait la partie du corps de la requête
qui dépasse le tampon initial (défini par la directive ISAPIReadAheadBuffer). En fonction de
la définition de la directive
ISAPIReadAheadBuffer (nombre d'octets à
mettre dans le tampon avant d'appeler le gestionnaire ISAPI), les
requêtes courtes sont envoyées en entier à l'extension lorsque
celle-ci est invoquée. Si la taille de la requête est trop
importante, l'extension ISAPI doit faire appel à
ReadClient pour extraire la totalité du corps de la
requête.
WriteClient est supporté, mais seulement avec le
drapeau HSE_IO_SYNC ou le drapeau "aucune option"
(valeur 0). Toute autre requête
WriteClient sera rejetée avec une valeur de retour
FALSE, et GetLastError renverra la valeur
ERROR_INVALID_PARAMETER
GetServerVariable est supporté, bien que les
variables étendues de serveur n'existent pas (comme défini par
d'autres serveurs). Toutes les variables d'environnement CGI
usuelles d'Apache sont disponibles à partir de
GetServerVariable, ainsi que les valeurs
ALL_HTTP et ALL_RAW.
Depuis httpd 2.0, mod_isapi propose des
fonctionnalités supplémentaires introduites dans les versions
actualisées de la spécification ISAPI, ainsi qu'une émulation
limitée des entrées/sorties asynchrones et la sémantique
TransmitFile. Apache httpd supporte aussi le préchargement
des .dlls ISAPI à des fins de performances.
| Description: | Enregistrement des requêtes
HSE_APPEND_LOG_PARAMETER de la part des extensions ISAPI
dans le journal des erreurs |
|---|---|
| Syntaxe: | ISAPIAppendLogToErrors on|off |
| Défaut: | ISAPIAppendLogToErrors off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_isapi |
Cette directive permet d'enregistrer les requêtes
HSE_APPEND_LOG_PARAMETER de la part des extensions
ISAPI dans le journal des erreurs.
| Description: | Enregistre les requêtes
HSE_APPEND_LOG_PARAMETER de la part des extensions ISAPI
dans la partie arguments de la requête |
|---|---|
| Syntaxe: | ISAPIAppendLogToQuery on|off |
| Défaut: | ISAPIAppendLogToQuery on |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_isapi |
Cette directive permet d'enregistrer les requêtes
HSE_APPEND_LOG_PARAMETER de la part des extensions
ISAPI dans la partie arguments de la requête (ajouté au composant
%q de la directive CustomLog).
| Description: | Fichiers .dll ISAPI devant être chargés au démarrage |
|---|---|
| Syntaxe: | ISAPICacheFile chemin-fichier
[chemin-fichier]
... |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_isapi |
Cette directive permet de spécifier une liste, séparés par des
espaces, de noms de fichiers devant être chargés au démarrage
du serveur Apache, et rester en mémoire jusqu'à l'arrêt du serveur.
Cette directive peut être répétée pour chaque fichier .dll ISAPI
souhaité. Le chemin complet du fichier doit être spécifié. Si le
chemin n'est pas absolu, il sera considéré comme relatif au
répertoire défini par la directive ServerRoot.
| Description: | Emulation du support des entrées/sorties asynchrones pour les appels ISAPI |
|---|---|
| Syntaxe: | ISAPIFakeAsync on|off |
| Défaut: | ISAPIFakeAsync off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_isapi |
Lorsquelle est définie à "on", cette directive permet d'émuler le support des entrées/sorties asynchrones pour les appels ISAPI.
| Description: | Journalisation des demandes de fonctionnalités non supportées de la part des extensions ISAPI |
|---|---|
| Syntaxe: | ISAPILogNotSupported on|off |
| Défaut: | ISAPILogNotSupported off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_isapi |
Cette directive permet d'enregistrer dans le journal des erreurs toutes les demandes de fonctionnalités non supportées de la part des extensions ISAPI. Ceci peut aider les administrateurs à décortiquer certains problèmes. Lorsqu'elle a été définie à "on" et si tous les modules ISAPI fonctionnent, elle peut être redéfinie à "off".
| Description: | Taille du tampon de lecture anticipée envoyé aux extensions ISAPI |
|---|---|
| Syntaxe: | ISAPIReadAheadBuffer taille |
| Défaut: | ISAPIReadAheadBuffer 49152 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_isapi |
Cette directive permet de définir la taille maximale du tampon de
lecture anticipée envoyé aux extensions ISAPI lorsqu'elles sont
initialement invoquées. Toute donnée restante doit être extraite en
faisant appel à ReadClient ; certaines extensions ISAPI
peuvent ne pas supporter la fonction ReadClient.
Pour plus de détails, veuillez vous adresser à l'auteur de
l'extension ISAPI.
Serveur HTTP Apache Version 2.4
| Description: | Algorithme de planification avec répartition de charge en
fonction d'un niveau de trafic pour le module
mod_proxy_balancer |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | lbmethod_bytraffic_module |
| Fichier Source: | mod_lbmethod_bytraffic.c |
| Compatibilité: | Dissocié de mod_proxy_balancer depuis la
version 2.3 |
Ce module ne fournit pas lui-même de directive de configuration. Il
nécessite les services de mod_proxy_balancer, et
fournit la méthode de répartition de charge bytraffic.
Ce module ne fournit aucune directive.
Activé via lbmethod=bytraffic, l'idée directrice de
ce planificateur est similaire à celle de la méthode reposant sur le
nombre de requêtes, avec les différences suivantes :
lbfactor représente la quantité de trafic, en octets, que nous voulons voir traitée par le processus. Il s'agit là aussi d'une valeur normalisée représentant la part de travail à effectuer par le processus, mais au lieu de se baser sur un nombre de requêtes, on prend en compte la quantité de trafic que ce processus a traité.
Si un répartiteur est configuré comme suit :
| worker | a | b | c |
|---|---|---|---|
| lbfactor | 1 | 2 | 1 |
Cela signifie que nous souhaitons que b traite 2 fois plus d'octets que a ou c. Cela n'entraîne pas nécessairement que b va traiter deux fois plus de requêtes, mais qu'il va traiter deux fois plus de trafic en termes d'entrées/sorties. A cet effet, les tailles de la requête et de sa réponse assocciée sont prises en compte par l'algorithme de sélection et d'évaluation du trafic.
Note : les octets en entrée sont évalués avec la même pondération que les octets en sortie.
Serveur HTTP Apache Version 2.4
| Description: | Journalisation des octets en entrée et en sortie pour chaque requête |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | logio_module |
| Fichier Source: | mod_logio.c |
Ce module permet d'enregistrer le nombre d'octets reçus et envoyés pour chaque requête. Ce nombre reflète le nombre réel d'octets transmis sur le réseau, et prend en compte les en-têtes et corps des requêtes et des réponses. Le décompte est effectué avant SSL/TLS en entrée et après SSL/TLS en sortie, si bien que le résultat reflètera toute modification introduite par le chiffrement.
Pour fonctionner, ce module requiert le chargement du module
mod_log_config.
Ce module introduit trois nouvelles directives de journalisation.
Les caractéristiques de la requête en elle-même sont journalisées en
insérant des directives "%" dans la chaîne de format,
qui seront remplacées comme suit dans le fichier journal :
| Chaîne de Format | Description |
|---|---|
%I |
Octets reçus, en-têtes et corps de requête inclus ; ne peut pas être nul. |
%O |
Octets envoyés, en-têtes inclus ; ne peut pas être nul. |
%S |
Nombre d'octets transmis (en émission et réception), y
compris corps et en-têtes de requête. Ce nombre ne peut pas être
nul, et il correspond à la combinaison des formats %I et %O. Disponible depuis la version 2.4.7 du serveur HTTP Apache. |
%^FB |
Délai en microsecondes entre l'arrivée de la requête et
l'écriture du premier octet des en-têtes de la réponse.
Disponible uniquement si la directive
LogIOTrackTTFB a été définie à ON.Disponible à partir de la version 2.4.13 du serveur HTTP Apache |
En général, cette fonctionnalité s'utilise comme suit :
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\" %I %O"| Description: | Permet d'enregistrer le délai avant le premier octet (time to first byte - TTFB) |
|---|---|
| Syntaxe: | LogIOTrackTTFB ON|OFF |
| Défaut: | LogIOTrackTTFB OFF |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_logio |
| Compatibilité: | Disponible à partir de la version 2.4.13 du serveur HTTP Apache |
Cette directive permet de définir si ce module mesure le délai
entre la lecture de la requête et l'écriture du premier octet des
en-têtes de la réponse. La valeur obtenue peut être enregistrée dans
le journal via le format %^FB.
Serveur HTTP Apache Version 2.4
| Description: | Ce module permet d'utiliser des macros dans les fichiers de configuration Apache. |
|---|---|
| Statut: | Base |
| Identificateur de Module: | macro_module |
| Fichier Source: | mod_macro.c |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache |
Ce module permet d'utiliser des macros dans les fichiers de configuration à l'exécution du serveur HTTP Apache afin de faciliter la création de nombreux blocs de configuration similaires. Quand le serveur démarre, les macros sont exécutées avec les paramètres fournis, et le résultat obtenu est traité au même titre que le reste du fichier de configuration.
On définit une macro à l'aide des blocs <Macro> qui contiennent la portion de votre
configuration qui intervient de manière répétitive, y compris les
variables pour les parties qui devront être substituées.
Par exemple, vous pouvez utiliser une macro pour définir un bloc
<VirtualHost>, afin de pouvoir
définir de nombreux serveurs virtuels similaires :
<Macro VHost $name $domain>
<VirtualHost *:80>
ServerName $domain
ServerAlias www.$domain
DocumentRoot "/var/www/vhosts/$name"
ErrorLog "/var/log/httpd/$name.error_log"
CustomLog "/var/log/httpd/$name.access_log" combined
</VirtualHost>
</Macro>
Comme les directives de configuration httpd, les noms des macros sont insensibles à la casse, à la différence des variables qui y sont, elles, sensibles.
Vous pouvez alors invoquer cette macro autant de fois que vous le voulez pour créer des serveurs virtuels
Use VHost example example.com Use VHost myhost hostname.org Use VHost apache apache.org UndefMacro VHost
Au démarrage du serveur, chacune de ces invocations
Use sera remplacée par une définition de serveur
virtuel complète, comme décrit dans la définition de la
<Macro>.
La directive UndefMacro permet d'éviter les
conflits de définitions qui pourraient provenir de l'utilisation
ultérieure de macros contenant les mêmes noms de variables.
Vous trouverez une version plus élaborée de cet exemple plus loin dans la section Exemples.
Les noms de paramètres doivent commencer par un sigil tel que
$, %, ou @, de façon à ce qu'ils
soient clairement identifiables, mais aussi afin de faciliter les
interactions avec les autres directives, comme la directive de base
Define. Dans le cas contraire, vous
recevrez un avertissement. En tout état de cause, il est conseillé
d'avoir une bonne connaissance globale de la configuration du serveur,
afin d'éviter la réutilisation des mêmes variables à différents niveaux,
ce qui peut être à l'origine de confusions.
Les paramètres préfixés par $ ou % ne sont
pas échappés. Les paramètres préfixés par @ sont échappés
entre guillemets.
Evitez de préfixer un paramètre par le nom d'un autre paramètre (par
exemple, présence simultanée des paramètres $win et
$winter), car ceci peut introduire de la confusion lors de
l'évaluation des expressions. Si cela se produit, c'est le nom de
paramètre le plus long possible qui sera utilisé.
Si vous désirez insérer une valeur dans une chaîne, il est conseillé de l'entourer d'accolades afin d'éviter toute confusion :
<Macro DocRoot ${docroot}>
DocumentRoot "/var/www/${docroot}/htdocs"
</Macro>
Un exemple typique d'utilisation de mod_macro est la
création dynamique de serveurs virtuels.
## Définition d'une macro VHost pour les configurations répétitives
<Macro VHost $host $port $dir>
Listen $port
<VirtualHost *:$port>
ServerName $host
DocumentRoot "$dir"
# Racine des documents publique
<Directory "$dir">
Require all granted
</Directory>
# restriction d'accès au sous-répertoire intranet.
<Directory "$dir/intranet">
Require ip 10.0.0.0/8
</Directory>
</VirtualHost>
</Macro>
## Utilisation de la macro VHost avec différents arguments.
Use VHost www.apache.org 80 /vhosts/apache/htdocs
Use VHost example.org 8080 /vhosts/example/htdocs
Use VHost www.example.fr 1234 /vhosts/example.fr/htdocs
Il est recommandé de supprimer la définition d'une macro après l'avoir utilisée. Ceci permet d'éviter les confusions au sein d'un fichier de configuration complexe où des conflits entre noms de variables peuvent survenir.
<Macro DirGroup $dir $group>
<Directory "$dir">
Require group $group
</Directory>
</Macro>
Use DirGroup /www/apache/private private
Use DirGroup /www/apache/server admin
UndefMacro DirGroup
| Description: | Définition d'une macro dans un fichier de configuration |
|---|---|
| Syntaxe: |
<Macro nom [par1 .. parN]>
... </Macro> |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_macro |
La directive <Macro> permet de définir une macro
dans un fichier de configuration Apache. Le premier argument est le nom
de la macro, et les arguments suivants sont les paramètres. Il
est de bon aloi de préfixer les noms des paramètres d'une macro
avec un caractère parmi '$%@', et d'éviter d'en faire
de même avec les noms de macros.
<Macro LocalAccessPolicy> Require ip 10.2.16.0/24 </Macro> <Macro RestrictedAccessPolicy $ipnumbers> Require ip $ipnumbers </Macro>
| Description: | Supprime une macro |
|---|---|
| Syntaxe: | UndefMacro nom |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_macro |
La directive UndefMacro annule la définition
d'une macro qui doit avoir été définie auparavant.
UndefMacro LocalAccessPolicy UndefMacro RestrictedAccessPolicy
| Description: | Utilisation d'une macro |
|---|---|
| Syntaxe: | Use nom [valeur1 ... valeurN]
|
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_macro |
La directive Use permet d'utiliser une macro.
La macro considérée est expansée. Son nombre d'arguments doit être égal au
nombre de paramètres précisés dans sa définition. Les valeurs passées en
argument sont attribuées aux paramètres correspondants et
substituées avant l'interprétation du texte de la macro.
Use LocalAccessPolicy ... Use RestrictedAccessPolicy "192.54.172.0/24 192.54.148.0/24"
est équivalent, avec les macros définies ci-dessus à :
Require ip 10.2.16.0/24 ... Require ip 192.54.172.0/24 192.54.148.0/24
Serveur HTTP Apache Version 2.4
| Description: | Effectue la négociation de contenu |
|---|---|
| Statut: | Base |
| Identificateur de Module: | negotiation_module |
| Fichier Source: | mod_negotiation.c |
La négociation de contenu, ou plus précisément la sélection de contenu, est la sélection parmi plusieurs documents disponibles, du document qui "colle" au plus près des possibilités du client. Pour y parvenir, deux méthodes sont employées.
type-map) qui contient une liste
explicite des fichiers contenant les différentes variantes.Options Multiviews), où le
serveur effectue une recherche de correspondance de modèle de nom
de fichier implicite, et fait son choix parmi les résultats.Une table de correspondances de types possède un format similaire à celui des en-têtes de messagerie RFC822. Elle contient des descriptions de documents séparées par des lignes vides, toute ligne commençant par un dièse ('#') étant considérée comme un commentaire. Une description de document comporte plusieurs enregistrements d'en-têtes ; chaque enregistrement peut être réparti sur plusieurs lignes à condition que les lignes supplémentaires commencent par un ou plusieurs espaces. Lors du traitement, les espaces de début de ligne seront supprimés et les lignes concaténées. L'enregistrement d'un en-tête comprend un mot-clé qui se termine toujours par un caractère "deux-points" ':', suivi d'une valeur. Les espaces sont autorisés entre le nom d'en-tête et sa valeur, ainsi qu'entre les différents éléments de la valeur. Les en-têtes autorisés sont :
Content-Encoding:AddEncoding. Sont normalement inclus
les codages x-compress pour les fichiers compressés
avec compress, et x-gzip pour les fichiers compressés
avec gzip. Le préfixe x- est ignoré lors des
comparaisons de codages.Content-Language:en correspond à l'anglais. Si la variante
contient plusieurs langages, ils sont séparés par des
virgules.Content-Length:Content-Type:nom=valeur. Les paramètres
courants sont :
leveltext/html, la valeur par défaut est 2, sinon
0.qsqs sont donc spécifiques à une certaine
ressource.
Content-Type: image/jpeg; qs=0.8
URI:Body:
Body:----xyz----
<html>
<body>
<p>Contenu de la page.</p>
</body>
</html>
----xyz----
Considérons une ressource, document.html, disponible
en anglais, en français et en allemand. Les fichiers correspondants
se nomment respectivement document.html.en,
document.html.fr, et document.html.de. Le
fichier de correspondances de types se nommera
document.html.var et contiendra ce qui suit :
URI: document.html
Content-language: en
Content-type: text/html
URI: document.html.en
Content-language: fr
Content-type: text/html
URI: document.html.fr
Content-language: de
Content-type: text/html
URI: document.html.de
Ces quatre fichiers doivent se trouver dans le même répertoire,
et le fichier .var doit être associé au gestionnaire
type-map via une directive AddHandler :
AddHandler type-map .var
A l'arrivée d'une requête pour la ressource
document.html.var, la variante de
document.html qui correspond le mieux à la préference
de langage spécifiée dans l'en-tête de la requête de l'utilisateur
Accept-Language sera choisie.
Si Multiviews est activée, et si MultiviewsMatch est définie à
"handlers" ou "any", une requête pour document.html va
rechercher document.html.var, et continuer la
négociation avec le gestionnaire explicite type-map.
D'autres directives de configuration, comme Alias, peuvent être utilisées pour
associer document.html avec
document.html.var.
Une recherche Multivues est activée par l'Options Multiviews. Si le
serveur reçoit une requête pour /un/répertoire/foo, et
si /un/répertoire/foo n'existe pas, le serveur parcourt
le répertoire à la recherche de tous les fichiers de nom
foo.*, et simule véritablement une correspondance de
type qui nomme tous ces fichiers en leur assignant les mêmes type
de média et codage de contenu qu'ils auraient eus si le client avait
requis l'un d'entre eux avec son nom complet. Il choisit ensuite le
fichier qui correspond le mieux au profile du client, puis renvoie
le document.
La directive MultiviewsMatch définit si Apache doit
prendre en compte les fichiers qui ne comportent pas de métadonnées
de négociation de contenu lors du choix du fichier à servir.
| Description: | Permet la mise en cache au niveau des serveurs mandataires des documents dont le contenu a été négocié |
|---|---|
| Syntaxe: | CacheNegotiatedDocs On|Off |
| Défaut: | CacheNegotiatedDocs Off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_negotiation |
Si elle est définie à "on", cette directive permet la mise en cache au niveau des serveurs mandataires des documents dont le contenu a été négocié. Le processus de mise en cache sera alors plus efficace, mais des clients se trouvant derrière le mandataire seront alors susceptibles de se voir servir des versions de documents qui ne correspondent pas forcément à leurs attentes.
Cette directive ne s'applique qu'aux requêtes en provenance de navigateurs HTTP/1.0. HTTP/1.1 fournit un bien meilleur contrôle de la mise en cache des documents au contenu négocié, et cette directive n'a aucun effet sur les réponses aux requêtes HTTP/1.1.
| Description: | Action à entreprendre si un document acceptable unique n'est pas trouvé |
|---|---|
| Syntaxe: | ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] |
| Défaut: | ForceLanguagePriority Prefer |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_negotiation |
La directive ForceLanguagePriority utilise
le langage défini par la directive LanguagePriority pour terminer
la négociation lorsque le serveur n'est pas en mesure de trouver une
solution satisfaisante unique.
ForceLanguagePriority Prefer utilise la directive
LanguagePriority pour servir le résultat d'un choix
unique, au lieu de renvoyer un résultat HTTP 300 (MULTIPLE CHOICES),
lorsque que plusieurs choix équivalents sont disponibles. Par
exemple, avec les deux directives ci-dessous, si l'en-tête
Accept-Language de l'utilisateur assigne à
en et de une qualité de .500
(les deux langages sont également acceptables), alors c'est la
première variante acceptable de langue en qui sera
servie.
LanguagePriority en fr de ForceLanguagePriority Prefer
ForceLanguagePriority Fallback utilise la directive
LanguagePriority
pour servir un résultat valide, au lieu de renvoyer un résultat HTTP
406 (NOT ACCEPTABLE). Avec les deux directives ci-dessous, si
l'en-tête Accept-Language de l'utilisateur ne mentionne
que les réponses de langage es, et si aucune variante
dans cette langue n'est trouvée, c'est la première variante de la
liste définie par la directive LanguagePriority qui sera servie.
LanguagePriority en fr de ForceLanguagePriority Fallback
Les deux options, Prefer et Fallback,
peuvent être spécifiées, de façon à ce que la variante servie soit
la première variante qui convient définie par la directive
LanguagePriority si
plusieurs variantes sont également acceptables, ou le premier
document disponible si aucune variante ne convient à la liste de
langages acceptables fournie par le client.
| Description: | L'ordre de priorité des variantes de langages pour les cas où le client n'a pas formulé de préférences |
|---|---|
| Syntaxe: | LanguagePriority langage-MIME [langage-MIME]
... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_negotiation |
La directive LanguagePriority permet de
définir, au cours du traitement d'une requête Multivues, l'ordre de
priorité des variantes de langages pour les cas
où le client n'a pas formulé de préférences. La liste énumère les
langages-MIME dans un ordre de préférences
décroissantes.
LanguagePriority en fr de
Dans le cas d'une requête pour foo.html, si
foo.html.fr et foo.html.de existent, et si
le client n'a pas formulé de préférences, c'est le fichier
foo.html.fr qui sera renvoyé.
Notez que cette directive n'a d'effet que si le 'meilleur'
langage n'a pas pu être déterminé d'une autre manière ou si la
valeur de la directive ForceLanguagePriority est
différente de None. En général, c'est le client qui
détermine le langage préféré, non le serveur.
Serveur HTTP Apache Version 2.4
| Description: | Détermine le type MIME d'un fichier à partir de quelques octets de son contenu |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | mime_magic_module |
| Fichier Source: | mod_mime_magic.c |
Ce module permet de déterminer le type
MIME des fichiers de la même manière que la commande Unix
file(1), à savoir en se basant sur les premiers octets
du fichier. Il est conçu comme une "seconde ligne de défense" pour
les cas où mod_mime ne parvient pas à déterminer le
type du fichier.
Ce module est dérivé d'une version libre de la commande Unix
file(1) qui utilise des "nombres magiques" et autres
marques distinctives issus du contenu du fichier pour essayer de
déterminer le type de contenu. Ce module n'est activé que si le
fichier magique est spécifié par la directive MimeMagicFile.
Le fichier contient du texte ASCII sur 4 à 5 colonnes. Les lignes
vides sont autorisées mais ignorées. Toute ligne commençant par un
dièse (#) est un commentaire. Les autres lignes sont
interprétées en colonnes comme suit :
| Colonne | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | numéro de l'octet à partir duquel la vérification débute " >" indique une dépendance par rapport à la
dernière ligne non-">" | ||||||||||||||||||||||
| 2 | type de donnée à rechercher
| ||||||||||||||||||||||
| 3 | contenu des données à rechercher | ||||||||||||||||||||||
| 4 | type MIME si correspondance | ||||||||||||||||||||||
| 5 | codage MIME si correspondance (optionnel) |
Par exemple, les lignes du fichier magique suivantes permettraient de reconnaître certains formats audio :
# Sun/NeXT audio data 0 string .snd >12 belong 1 audio/basic >12 belong 2 audio/basic >12 belong 3 audio/basic >12 belong 4 audio/basic >12 belong 5 audio/basic >12 belong 6 audio/basic >12 belong 7 audio/basic >12 belong 23 audio/x-adpcm
Et celles-ci permettraient de reconnaître la différence entre les
fichiers *.doc qui contiennent des documents Microsoft
Word et les documents FrameMaker (ce sont des formats de fichiers
incompatibles qui possèdent le même suffixe).
# Frame 0 string \<MakerFile application/x-frame 0 string \<MIFFile application/x-frame 0 string \<MakerDictionary application/x-frame 0 string \<MakerScreenFon application/x-frame 0 string \<MML application/x-frame 0 string \<Book application/x-frame 0 string \<Maker application/x-frame # MS-Word 0 string \376\067\0\043 application/msword 0 string \320\317\021\340\241\261 application/msword 0 string \333\245-\0\0\0 application/msword
Un champ optionnel codage MIME peut être ajouté dans la cinquième colonne. Par exemple, cette ligne permet de reconnaître les fichiers compressés par gzip et définissent le type de codage.
# gzip (GNU zip, à ne pas confondre avec # l'archiveur zip [Info-ZIP/PKWARE]) 0 string \037\213 application/octet-stream x-gzip
Ce module n'est pas fait pour tous les systèmes. Si votre système parvient à peine à supporter sa charge, ou si vous testez les performances d'un serveur web, il est déconseillé d'utiliser ce module car son fonctionnement a un prix en matière de ressources consommées.
Des efforts ont cependant été fournis pour améliorer les
performances du code original de la commande file(1) en
l'adaptant pour fonctionner sur un serveur web à forte charge. Il a
été conçu pour un serveur sur lequel des milliers d'utilisateurs
publient leurs propres documents, ce qui est probablement très
courant sur un intranet. Il s'avère souvent bénéfique qu'un serveur
puisse prendre des décisions plus pertinentes à propos du contenu
d'un fichier que celles se basant sur le nom du fichier seul, ne
serait-ce que pour diminuer le nombre d'appels du type "pourquoi ma
page ne s'affiche-t-elle pas ?" survenant lorsque les utilisateurs
nomment leurs fichiers incorrectement. Vous devez déterminer si la
charge supplémentaire convient à votre environnement.
Les notes suivantes s'appliquent au module
mod_mime_magic et sont incluses ici pour
conformité avec les restrictions de copyright des contributeurs
qui requièrent de les accepter.
Note de traduction : ces informations de type légal ne sont pas traductibles
mod_mime_magic: MIME type lookup via file magic numbers
Copyright (c) 1996-1997 Cisco Systems, Inc.
This software was submitted by Cisco Systems to the Apache Group in July 1997. Future revisions and derivatives of this source code must acknowledge Cisco Systems as the original contributor of this module. All other licensing and usage conditions are those of the Apache Group.
Some of this code is derived from the free version of the file command originally posted to comp.sources.unix. Copyright info for that program is included below as required.
- Copyright (c) Ian F. Darwin, 1987. Written by Ian F. Darwin.
This software is not subject to any license of the American Telephone and Telegraph Company or of the Regents of the University of California.
Permission is granted to anyone to use this software for any purpose on any computer system, and to alter it and redistribute it freely, subject to the following restrictions:
For compliance with Mr Darwin's terms: this has been very significantly modified from the free "file" command.
realloc().| Description: | Active la détermination du type MIME en se basant sur le contenu du fichier et en utilisant le fichier magique spécifié |
|---|---|
| Syntaxe: | MimeMagicFile chemin-fichier |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_mime_magic |
La directive MimeMagicFile permet
d'activer ce module, le fichier par défaut fourni étant
conf/magic. Les chemins sans slash '/' de début sont
relatifs au répertoire défini par la directive ServerRoot. Les serveurs virtuels
utilisent le même fichier que le serveur principal sauf si un
fichier spécifique a été défini pour ce serveur virtuel, auquel cas
c'est ce dernier fichier qui sera utilisé.
MimeMagicFile conf/magic
Serveur HTTP Apache Version 2.4
| Description: | Support des privilèges de Solaris et de l'exécution des serveurs virtuels sous différents identifiants utilisateurs. |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | privileges_module |
| Fichier Source: | mod_privileges.c |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache sur les plates-formes Solaris 10 et OpenSolaris |
Ce module permet l'exécution de différents serveurs virtuels sous différents identifiants Unix User et Group, et avec différents Privilèges Solaris. En particulier, il apporte au problème de séparation des privilèges entre les différents serveurs virtuels la solution que devait apporter le module MPM abandonné perchild. Il apporte aussi d'autres améliorations en matière de sécurité.
À la différence de perchild, mod_privileges n'est
pas un module MPM. Il travaille au sein d'un modèle de
traitement pour définir les privilèges et les User/Group pour chaque
requête dans un même processus. Il n'est donc pas compatible avec
les MPM threadés, et refusera de s'exécuter en cas d'utilisation d'un de
ces derniers.
mod_privileges traite des problèmes de sécurité
similaires à ceux de suexec ; mais à la
différence de ce dernier, il ne s'applique pas seulement aux programmes
CGI, mais à l'ensemble du cycle de traitement d'une requête, y compris
les applications in-process et les sous-processus. Il convient
particulièrement à l'exécution des applications PHP sous
mod_php, qui est lui-même incompatible avec les modules
MPM threadés. Il est également bien adapté aux autres applications de type
script in-process comme mod_perl,
mod_python, et mod_ruby, ainsi qu'aux
applications en langage C telles que les modules Apache pour lesquels la
séparation des privilèges constitue un problème.
DTracePrivileges PrivilegesMode VHostCGIMode VHostCGIPrivs VHostGroup VHostPrivs VHostSecure VHostUsermod_privileges introduit de nouveaux problèmes de
sécurité dans les situations où du code non sûr peut
s'exécuter à l'intérieur du processus du serveur web.
Ceci s'applique aux modules non sûrs, et aux scripts s'exécutant sous
des modules comme mod_php ou mod_perl. Les scripts s'exécutant en
externe (comme par exemple les scripts CGI ou ceux s'exécutant sur un
serveur d'applications derrière mod_proxy ou mod_jk) ne sont pas
concernés.
Les principaux problèmes de sécurité que l'on rencontre avec mod_privileges sont :
La directive PrivilegesMode vous permet de
sélectionner soit le mode FAST, soit le mode
SECURE. Vous pouvez panacher les modes en utilisant par
exemple le mode FAST pour les utilisateurs de confiance et
les chemins contenant du code entièrement audité, tout en imposant le
mode SECURE où un utilisateur non sûr a la possibilité
d'introduire du code.
Avant de décrire les modes, il nous faut présenter les cas d'utilisation de la cible : "Benign" ou "Hostile". Dans une situation "Benign", vous voulez séparer les utilisateurs pour leur confort, et les protéger, ainsi que le serveur, contre les risques induits par les erreurs involontaires. Dans une situation "Hostile" - par exemple l'hébergement d'un site commercial - il se peut que des utilisateurs attaquent délibérément le serveur ou s'attaquent entre eux.
Vous pouvez sélectionner différents
PrivilegesModes pour chaque serveur virtuel, et
même dans un contexte de répertoire à l'intérieur d'un serveur virtuel.
Le mode FAST convient lorsque les utilisateurs sont sûrs
et/ou n'ont pas le privilège de charger du code "in-process". Le mode
SECURE convient dans les cas où du code non sûr peut
s'exécuter "in-process". Cependant, même en mode SECURE, il
n'y a pas de protection contre un utilisateur malveillant qui a la
possibilité d'introduire du code supportant les privilèges avant le
début du cycle de traitement de la requête.
| Description: | Détermine si les privilèges requis par dtrace sont activés. |
|---|---|
| Syntaxe: | DTracePrivileges On|Off |
| Défaut: | DTracePrivileges Off |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_privileges |
| Compatibilité: | >Disponible sous Solaris 10 et OpenSolaris avec les
modules MPM non-threadés (prefork ou MPM
personnalisé). |
Cette directive qui s'applique à l'ensemble du serveur permet de déterminer si Apache s'exécutera avec les privilèges requis pour exécuter dtrace. Notez que la définition DTracePrivileges On n'activera pas à elle-seule DTrace, mais que DTracePrivileges Off l'empêchera de fonctionner.
| Description: | Fait un compromis entre d'une part l'efficacité et la vitesse de traitement et d'autre part la sécurité à l'encontre des codes malicieux supportant les privilèges. |
|---|---|
| Syntaxe: | PrivilegesMode FAST|SECURE|SELECTIVE |
| Défaut: | PrivilegesMode FAST |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Expérimental |
| Module: | mod_privileges |
| Compatibilité: | Disponible sous Solaris 10 et OpenSolaris avec des
modules MPMs non threadés (comme prefork ou un module
personnalisé). |
Cette directive permet de faire un compromis entre les performances et la sécurité à l'encontre des codes malicieux supportant les privilèges. En mode SECURE, chaque requête est traitée dans un sous-processus sécurisé, ce qui induit une dégradation sensible des performances. En mode FAST, le serveur n'est pas protégé contre l'augmentation de privilège comme décrit plus haut.
Cette directive est sensiblement différente selon qu'elle se trouve
dans une section <Directory> (ou Location/Files/If)
ou au niveau global ou dans un <VirtualHost>.
Au niveau global, elle définit un comportement par défaut dont
hériteront les serveurs virtuels. Dans un serveur virtuel, les modes
FAST ou SECURE agissent sur l'ensemble de la requête HTTP, et toute
définition de ces modes dans une section <Directory>
sera ignorée. Le pseudo-mode SELECTIVE confie le choix
du mode FAST ou SECURE aux directives contenues dans une
section<Directory>.
Dans une section <Directory>, elle ne s'applique
que lorsque le mode SELECTIVE a été défini pour le serveur virtuel.
Seuls FAST ou SECURE peuvent être définis dans ce contexte (SELECTIVE
n'aurait pas de sens).
<Directory> qui
s'applique à la requête. Ceci peut donner à un attaquant
l'opportunité d'introduire du code via une directive RewriteMap s'exécutant au
niveau global ou d'un serveur virtuel avant que les
privilèges n'aient été supprimés et l'uid/gid défini.
| Description: | Détermine si le serveur virtuel peut exécuter des sous-processus, et définit les privilèges disponibles pour ces dernier. |
|---|---|
| Syntaxe: | VHostCGIMode On|Off|Secure |
| Défaut: | VHostCGIMode On |
| Contexte: | serveur virtuel |
| Statut: | Expérimental |
| Module: | mod_privileges |
| Compatibilité: | Disponible sous Solaris 10 et OpenSolaris avec les
modules MPM non-threadés (prefork ou MPM
personnalisé). |
Détermine si le serveur virtuel est autorisé à exécuter fork et
exec, et définit les privilèges requis pour exécuter des sous-processus. Si cette
directive est définie à Off le serveur virtuel ne
disposera d'aucun privilège et ne pourra exécuter ni des programmes
ou scripts CGI classiques via le module traditionnel
mod_cgi, ni des programmes externes similaires tels
que ceux créés via le module mod_ext_filter ou les
programmes de réécriture externes utilisés par la directive
RewriteMap. Notez que
ceci n'empêche pas l'exécution de programmes CGI via d'autres
processus et sous d'autres modèles de sécurité comme mod_fcgid, ce qui est la
solution recommandée sous Solaris.
Si cette directive est définie à On ou
Secure, le serveur virtuel pourra exécuter les scripts et
programmes externes cités ci-dessus. Définir la directive
VHostCGIMode à Secure a pour effet
supplémentaire de n'accorder aucun privilège aux sous-processus,
comme décrit dans la directive
VHostSecure.
| Description: | Assigne des privilèges au choix aux sous-processus créés par un serveur virtuel. |
|---|---|
| Syntaxe: | VHostCGIPrivs [+-]?privilege-name [[+-]?privilege-name] ... |
| Défaut: | Aucun |
| Contexte: | serveur virtuel |
| Statut: | Expérimental |
| Module: | mod_privileges |
| Compatibilité: | Disponible sous Solaris 10 et OpenSolaris avec les
modules MPM non-threadés (prefork ou MPM
personnalisé) et lorsque mod_privileges est construit
avec l'option de compilation
BIG_SECURITY_HOLE. |
La directive VHostCGIPrivs permet
d'assigner des privilèges au choix aux sous-processus créés par un serveur
virtuel, comme décrit dans la directive
VHostCGIMode. Chaque
privilege-name correspond à un privilège Solaris tel que
file_setid ou sys_nfs.
privilege-name peut être éventuellement préfixé par + ou -, ce qui va respectivement accorder ou refuser le privilège. Si nom-privilège est spécifié sans + ni -, tous les autres privilèges préalablement assignés au serveur virtuel seront refusés. Cette directive permet de construire aisément votre propre jeu de privilèges en annulant tout réglage par défaut.
L'utilisation de cette directive peut ouvrir d'immenses trous de sécurité dans les sous-processus Apache, jusqu'à leur exécution avec les droits de root. Ne l'utilisez que si vous êtes absolument sûr de comprendre ce que vous faites !
| Description: | Définit l'identifiant du groupe sous lequel s'exécute un serveur virtuel. |
|---|---|
| Syntaxe: | VHostGroup identifiant-groupe-unix |
| Défaut: | Hérite de l'identifiant du groupe spécifié par la directive
|
| Contexte: | serveur virtuel |
| Statut: | Expérimental |
| Module: | mod_privileges |
| Compatibilité: | Disponible sous Solaris 10 et OpenSolaris avec les
modules MPM non-threadés (prefork ou MPM
personnalisé). |
La directive VHostGroup permet de définir
l'identifiant du groupe unix sous lequel le serveur va traiter les
requêtes par l'intermédiaire d'un serveur virtuel. L'identifiant
du groupe est défini avant le traitement de la requête, puis
restauré à sa valeur de départ via les Privilèges
Solaris. Comme la définition
s'applique au processus, cette directive est incompatible
avec les modules MPM threadés.
Unix-group peut être :
# suivi d'un numéro de groupe.Cette directive ne peut pas être utilisée pour exécuter Apache en tant que root ! Elle est tout de même susceptible de poser des problèmes de sécurité similaires à ceux décrits dans la documentation de suexec.
| Description: | Assigne des privilèges à un serveur virtuel. |
|---|---|
| Syntaxe: | VHostPrivs [+-]?nom-privilège [[+-]?nom-privilège] ... |
| Défaut: | Aucun |
| Contexte: | serveur virtuel |
| Statut: | Expérimental |
| Module: | mod_privileges |
| Compatibilité: | Disponible sous Solaris 10 et OpenSolaris avec les
modules MPM non-threadés (prefork ou MPM
personnalisé) et lorsque mod_privileges est construit
avec l'option de compilation
BIG_SECURITY_HOLE. |
La directive VHostPrivs permet d'assigner
des privilèges au choix à un serveur virtuel. Chaque
nom-privilège correspond à un privilège Solaris tel que
file_setid ou sys_nfs.
nom-privilège peut être éventuellement préfixé par + ou -, ce qui va respectivement accorder ou refuser le privilège. Si nom-privilège est spécifié sans + ni -, tous les autres privilèges préalablement assignés au serveur virtuel seront refusés. Cette directive permet de construire aisément votre propre jeu de privilèges en annulant tout réglage par défaut.
L'utilisation de cette directive peut ouvrir d'immenses trous de sécurité dans Apache, jusqu'au traitement de requêtes avec les droits de root. Ne l'utilisez que si vous êtes absolument sûr de comprendre ce que vous faites !
| Description: | Détermine si le serveur s'exécute avec une sécurité avancée pour les serveurs virtuels. |
|---|---|
| Syntaxe: | VHostSecure On|Off |
| Défaut: | VHostSecure On |
| Contexte: | serveur virtuel |
| Statut: | Expérimental |
| Module: | mod_privileges |
| Compatibilité: | Disponible sous Solaris 10 et OpenSolaris avec les
modules MPM non-threadés (prefork ou MPM
personnalisé). |
Détermine si les serveurs virtuels traitent les requêtes avec une sécurité avancée en supprimant les Privilèges rarement requis par un serveur web, mais disponibles par défaut pour un utilisateur Unix standard, et donc susceptibles d'être demandés par des modules et des applications. Il est recommandé de conserver la définition par défaut (On), sauf si elle empêche une application de fonctionner. Comme la définition s'applique au processus, cette directive est incompatible avec les modules MPM threadés.
Le fait que la directive VHostSecure
empêche une application de fonctionner peut constituer un signal
d'avertissement indiquant que la sécurité de l'application doit être
revue.
| Description: | Définit l'identifiant utilisateur sous lequel s'exécute un serveur virtuel. |
|---|---|
| Syntaxe: | VHostUser identifiant-utilisateur-unix |
| Défaut: | Hérite de l'identifiant utilisateur spécifié par la directive
|
| Contexte: | serveur virtuel |
| Statut: | Expérimental |
| Module: | mod_privileges |
| Compatibilité: | Disponible sous Solaris 10 et OpenSolaris avec les
modules MPM non-threadés (prefork ou MPM
personnalisé). |
La directive VHostUser permet de définir
l'identifiant utilisateur unix sous lequel le serveur va traiter les
requêtes par l'intermédiaire d'un serveur virtuel. L'identifiant
utilisateur est défini avant le traitement de la requête, puis
restauré à sa valeur de départ via les Privilèges
Solaris. Comme la définition
s'applique au processus, cette directive est incompatible
avec les modules MPM threadés.
identifiant-utilisateur-unix peut être :
# suivi d'un numéro d'utilisateur.Cette directive ne peut pas être utilisée pour exécuter Apache en tant que root ! Elle est tout de même susceptible de poser des problèmes de sécurité similaires à ceux décrits dans la documentation de suexec.
Serveur HTTP Apache Version 2.4
| Description: | Extension de mod_proxy pour le support de
la répartition de charge |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_balancer_module |
| Fichier Source: | mod_proxy_balancer.c |
| Compatibilité: | Disponible depuis la version 2.1 d'Apache |
Pour pouvoir fonctionner, ce module requiert le
chargement de mod_proxy, et il fournit le support de
la répartition de charge pour tous les protocoles supportés. Parmi ces
protocoles, les plus importants sont :
mod_proxy_httpmod_proxy_ftpmod_proxy_ajpmod_proxy_wstunnelL'algorithme de planification de la répartition de charge n'est pas fourni par ce module, mais par ceux-ci :
Ainsi, pour mettre en oeuvre la répartition de charge,
mod_proxy, mod_proxy_balancer et
au moins un des modules fournissant l'algorithme de planification de
la répartition de charge doivent être chargés dans le serveur.
N'activez pas la fonctionnalité de mandataire avant d'avoir sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux non seulement pour votre réseau, mais aussi pour l'Internet au sens large.
L'algorithme de planification de la répartition de
charge Répartition de charge avec abonnement utilisateur
(stickyness) Exemples de configuration d'un répartiteur Variables d'environnement exportées Activation du support du gestionnaire de répartiteur Détails à propos de la répartition de charge par abonnement
(stickyness) Résolution des problèmes liés à la répartition de charge par
abonnementCe module ne fournit aucune directive.
A l'heure actuelle, 4 algorithmes de planification de la répartition de
charge sont disponibles : ils se basent respectivement sur le comptage des
requêtes (mod_lbmethod_byrequests), la mesure de
l'intensité du trafic (mod_lbmethod_bytraffic), le comptage
des requêtes en attente (mod_lbmethod_bybusyness) et la
mesure de l'activité du serveur (mod_lbmethod_heartbeat).
Ils sont contrôlés par la valeur de lbmethod dans la définition
du répartiteur. Voir la directive ProxyPass pour plus de détails, et en
particulier la configuration du répartiteur et de ses membres.
Le répartiteur supporte l'abonnement utilisateur. Lorsqu'une requête est mandatée vers un serveur d'arrière-plan particulier, toutes les requêtes suivantes du même utilisateur seront alors mandatées vers le même serveur d'arrière-plan. De nombreux répartiteurs de charge implémentent cette fonctionnalité via une table qui associe les adresses IP des clients aux serveurs d'arrière-plan. Cette approche est transparente aux clients et aux serveurs d'arrière-plan, mais induit certains problèmes : distribution de charge inégale si les clients se trouvent eux-mêmes derrière un mandataire, erreurs d'abonnement lorsqu'un client possède une adresse IP dynamique qui peut changer au cours d'une session et perte d'abonnement en cas de dépassement de la table de correspondances.
Le module mod_proxy_balancer implémente
l'abonnement selon deux alternatives : les cookies et le codage
d'URL. Le cookie peut être fourni par le serveur d'arrière-plan ou
par le serveur web Apache lui-même, alors que le codage d'URL est en
général effectué par le serveur d'arrière-plan.
Avant de nous plonger dans les détails techniques, voici un
exemple d'utilisation de mod_proxy_balancer mettant
en oeuvre la répartition de charge entre deux serveurs
d'arrière-plan :
<Proxy "balancer://mycluster">
BalancerMember "http://192.168.1.50:80"
BalancerMember "http://192.168.1.51:80"
</Proxy>
ProxyPass "/test" "balancer://mycluster"
ProxyPassReverse "/test" "balancer://mycluster"
Voici un autre exemple de répartiteur de charge avec
abonnement utilisant mod_headers,
fonctionnant même si le serveur d'arrière-plan ne définit pas de
cookie de session approprié :
Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED
<Proxy "balancer://mycluster">
BalancerMember "http://192.168.1.50:80" route=1
BalancerMember "http://192.168.1.51:80" route=2
ProxySet stickysession=ROUTEID
</Proxy>
ProxyPass "/test" "balancer://mycluster"
ProxyPassReverse "/test" "balancer://mycluster"
A l'heure actuelle, 6 variables d'environnement sont exportées :
Cette variable se voir assignée la valeur de stickysession pour la requête courante. Il s'agit du nom du cookie ou du paramètre de requête utilisé pour les sessions avec abonnement.
Cette variable se voit assignée la route interprétée pour la requête courante.
Cette variable se voit assigné le nom du répartiteur pour la
requête courante. Il s'agit d'une valeur du style
balancer://foo.
Cette variable se voit assigné le nom du membre du groupe de
répartition de charge utilisé pour la requête courante. Il s'agit
d'une valeur du style http://hostA:1234.
Cette variable se voit assignée la route du membre du groupe de répartition de charge qui sera utilisé pour la requête courante.
Cette variable est définie à 1 si la route de la session ne correspond pas à celle du membre du groupe de répartition de charge (BALANCER_SESSION_ROUTE != BALANCER_WORKER_ROUTE), ou si la session ne possède pas encore de route établie. Elle peut servir à déterminer quand il est éventuellement nécessaire d'envoyer au client une route mise à jour lorsque les sessions persistantes sont utilisées.
Cette fonctionnalité nécessite le chargement du module
mod_status. Le gestionnaire de répartiteur permet
la mise à jour dynamique des membres du groupe de répartition de
charge. Vous pouvez utiliser le gestionnaire de répartiteur pour
modifier le facteur de charge d'un membre particulier, ou passer ce
dernier en mode hors ligne.
Ainsi, pour mettre en oeuvre la gestion du répartiteur de charge,
mod_status et mod_proxy_balancer
doivent être chargés dans le serveur.
Pour permettre la gestion du répartiteur de charge aux
navigateurs appartenant au domaine example.com, ajoutez ces lignes à
votre fichier de configuration httpd.conf :
<Location "/balancer-manager">
SetHandler balancer-manager
Require host example.com
</Location>
Vous pourrez alors accéder au gestionnaire du répartiteur de
charge en utilisant un navigateur web pour afficher la page
http://nom.de.votre.serveur/balancer-manager. Notez que
pour pouvoir contrôler dynamiquement un membre de groupe de
répartition, ce dernier ne doit pas être défini au sein d'une
section <Location ...>.
Si l'abonnement s'appuie sur un cookie, vous devez définir le nom
de ce cookie dont le contenu précise le serveur d'arrière-plan à
utiliser. Pour ce faire, on utilise l'attribut
stickysession avec la directive ProxyPass ou ProxySet. Le nom du cookie est
sensible à la casse. Le répartiteur extrait le contenu du cookie et
recherche un serveur membre dont la route correspond à
cette valeur. La route doit aussi être définie dans la directive ProxyPass ou ProxySet. Le cookie peut être défini
soit par le serveur d'arrière-plan, soit, comme indiqué dans l'exemple ci-dessus par le serveur web Apache
lui-même.
Certains serveurs d'arrière-plan, tels qu'Apache Tomcat,
utilisent une forme sensiblement différente de cookie d'abonnement.
Tomcat ajoute le nom de l'instance Tomcat à la fin de son
identifiant de session, précédé par un point. Ainsi, si le serveur
web Apache trouve un point dans la valeur du cookie d'abonnement, il
n'utilisera que la partie située après ce point pour
rechercher sa route. Pour que Tomcat puisse connaître son nom
d'instance, vous devez définir l'attribut jvmRoute dans
son fichier de configuration conf/server.xml à la
valeur de la route du serveur qui se connecte au Tomcat
considéré. Le nom du cookie de session utilisé par Tomcat (et plus
généralement par les applications web Java à base de servlets) est
JSESSIONID (en majuscules), mais peut être modifié.
La seconde méthode pour implémenter l'abonnement est le codage
d'URL. Ici, le serveur web recherche un paramètre dans l'URL de la
requête. Le nom du paramètre est spécifié par l'attribut
stickysession. Pour trouver un serveur membre, on
recherche un serveur dont la route est égale à la valeur
du paramètre. Comme il n'est pas aisé d'extraire et de manipuler
tous les liens URL contenus dans les réponses, le travail consistant
à ajouter les paramètres à chaque lien est généralement effectué par
le serveur d'arrière-plan qui génère le contenu. Bien qu'il soit
possible dans certains cas d'effectuer ces ajouts au niveau du
serveur web via les modules mod_substitute ou
mod_sed, cette méthode peut dégrader les
performances.
Les standards Java implémentent le codage d'URL de manière
sensiblement différente. Ils ajoutent une information de chemin à
l'URL en utilisant un point-virgule (;) comme
séparateur, puis ajoutent enfin l'identifiant de session. Comme dans
le cas des cookies, Apache Tomcat peut insérer la valeur de
l'attribut jvmRoute dans cette information de chemin.
Pour qu'Apache puisse trouver ce genre d'information de chemin, vous
devez définir scolonpathdelim à On dans la
directive ProxyPass ou
ProxySet.
Enfin, vous pouvez utiliser simultanément les cookies et le codage
d'URL en définissant le nom du cookie et le nom du paramètre d'URL
séparés par une barre verticale (|) comme dans
l'exemple suivant :
ProxyPass "/test" "balancer://mycluster" stickysession=JSESSIONID|jsessionid scolonpathdelim=On
<Proxy "balancer://mycluster">
BalancerMember "http://192.168.1.50:80" route=node1
BalancerMember "http://192.168.1.51:80" route=node2
</Proxy>
Si le cookie et le paramètre de requête fournissent tous deux une information de route correcte pour la même requête, c'est l'information en provenance du paramètre de requête qui sera retenue.
Si vous êtes confronté à des erreurs d'abonnement, comme la nécessité pour les utilisateurs de se reconnecter suite à une perte de session d'application, vous devez tout d'abord vérifier si ceci n'est pas du à une indisponibilité sporadique des serveurs d'arrière-plan ou à une erreur de configuration. La présence de messages d'erreur de type proxy dans le journal des erreurs d'Apache pourra révéler des problèmes de stabilité au niveau des serveurs d'arrière-plan.
Pour contrôler votre configuration, regardez tout d'abord si
l'abonnement est à base de cookie ou de codage d'URL. L'étape
suivante consiste à enregistrer certaines données dans le journal
des accès en utilisant un format
de journalisation personnalisé. Les champs intéressants
sont les suivants :
%{MONCOOKIE}CMONCOOKIE.
Le nom doit correspondre au nom défini par l'attribut
stickysession.%{Set-Cookie}o%{BALANCER_SESSION_STICKY}e%{BALANCER_SESSION_ROUTE}e%{BALANCER_WORKER_ROUTE}e%{BALANCER_ROUTE_CHANGED}e1 si la route extraite de la
requête est différente de la route du serveur ; autrement dit, le
traitement de la requête n'a pas pu être effectué dans le cadre
d'une répartition de charge par abonnement.Les pertes de session sont souvent dues à des expirations de session dont la valeur peut en général être configurée au niveau du serveur d'arrière-plan.
Si le niveau de journalisation est défini à debug ou
plus, le répartiteur journalise aussi des informations détaillées à
propos de l'abonnement dans le journal des erreurs, ce qui facilite
la résolution des problèmes d'abonnement. Notez cependant que le
volume de journalisation pourra alors s'avérer trop important pour
un serveur en production sous forte charge.
Serveur HTTP Apache Version 2.4
| Description: | Fournit des points d'entrée Lua dans différentes parties du traitement des requêtes httpd |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | lua_module |
| Fichier Source: | mod_lua.c |
| Compatibilité: | versions 2.3 et supérieures |
Ce module permet d'ajouter au serveur des extensions sous forme de
scripts écrits dans le langage de programmation Lua.
mod_lua fournit de nombreuses extensions
(hooks) disponibles avec les modules natifs du serveur HTTP Apache,
comme les associations de requêtes à des fichiers, la génération de
réponses dynamiques, le contrôle d'accès, l'authentification et
l'autorisation.
Vous trouverez davantage d'informations à propos du langage de programmation Lua sur le site web de Lua.
Ce module possède une grande capacité d'action sur le fonctrionnement de httpd, ce qui lui confère une grande puissance, mais peut aussi induire un risque de sécurité. Il est déconseillé d'utiliser ce module sur un serveur partagé avec des utilisateurs auxquels vous ne pouvez pas accorder une confiance absolue, car il peut permettre de modifier le fonctionnement interne de httpd.
Configuration de base Ecrire des gestionnaires Ecriture de fournisseurs d'autorisation Ecriture de fonctions d'accroche
(hooks) Structures de données Méthodes de l'objet request_rec Fonctions de journalisation Paquet apache2 Modification de contenu avec les filtres lua Connectivité aux bases de données LuaAuthzProvider LuaCodeCache LuaHookAccessChecker LuaHookAuthChecker LuaHookCheckUserID LuaHookFixups LuaHookInsertFilter LuaHookLog LuaHookMapToStorage LuaHookPreTranslate LuaHookTranslateName LuaHookTypeChecker LuaInherit LuaInputFilter LuaMapHandler LuaOutputFilter LuaPackageCPath LuaPackagePath LuaQuickHandler LuaRoot LuaScopeLa directive de base pour le chargement du module est
LoadModule lua_module modules/mod_lua.so
mod_lua fournit un gestionnaire nommé
lua-script qui peut être utilisé avec une directive
AddHandler ou SetHandler :
<Files "*.lua">
SetHandler lua-script
</Files>
Ceci aura pour effet de faire traiter les requêtes pour les fichiers
dont l'extension est .lua par mod_lua en
invoquant cette fonction de gestion de fichier.
Pour plus de détails, voir la directive
LuaMapHandler.
Dans l'API du serveur HTTP Apache, un gestionnaire est une sorte de
point d'accroche (hook) spécifique responsable de la génération de la
réponse. mod_proxy, mod_cgi et
mod_status sont des exemples de modules comportant un
gestionnaire.
mod_lua cherche toujours à invoquer une fonction Lua pour le
gestionnaire, plutôt que de simplement évaluer le corps d'un script dans
le style de CGI. Une fonction de gestionnaire se présente comme suit :
example.lua
-- exemple de gestionnaire require "string" --[[ Il s'agit du nom de méthode par défaut pour les gestionnaires Lua ; voir les noms de fonctions optionnels dans la directive LuaMapHandler pour choisir un point d'entrée différent. --]] function handle(r) r.content_type = "text/plain" if r.method == 'GET' then r:puts("Hello Lua World!\n") for k, v in pairs( r:parseargs() ) do r:puts( string.format("%s: %s\n", k, v) ) end elseif r.method == 'POST' then r:puts("Hello Lua World!\n") for k, v in pairs( r:parsebody() ) do r:puts( string.format("%s: %s\n", k, v) ) end else elseif r.method == 'PUT' then -- message d'erreur personnalisé r:puts("Unsupported HTTP method " .. r.method) r.status = 405 return apache2.OK else -- message d'erreur ErrorDocument return 501 end return apache2.OK end
Ce gestionnaire se contente d'afficher les arguments codés d'un uri ou d'un formulaire dans un page au format texte.
Cela signifie que vous pouvez (et êtes encouragé à) avoir plusieurs gestionnaires (ou points d'entrée, ou filtres) dans le même script.
mod_authz_core fournit une interface d'autorisation
de haut niveau bien plus facile à utiliser que dans les hooks
correspondants. Le premier argument de la directive Require permet de spécifier le
fournisseur d'autorisation à utiliser. Pour chaque directive Require,
mod_authz_core appellera le fournisseur d'autorisation
spécifié, le reste de la ligne constituant les paramètres. Le
fournisseur considéré va alors vérifier les autorisations et fournir le
résultat dans une valeur de retour.
En général, le fournisseur authz est appelé avant l'authentification.
S'il doit connaître le nom d'utilisateur authentifié (ou si
l'utilisateur est appelé à être authentifié), le fournisseur doit
renvoyer apache2.AUTHZ_DENIED_NO_USER, ce qui va
déclancher le processus d'authentification et un deuxième appel du
fournisseur authz.
La fonction du fournisseur authz ci-dessous accepte deux arguments, une adresse IP et un nom d'utilisateur. Elle autorise l'accès dans le cas où la requête provient de l'adresse IP spécifiée, ou si l'utilisateur authentifié correspond au second argument :
authz_provider.lua
require 'apache2' function authz_check_foo(r, ip, user) if r.useragent_ip == ip then return apache2.AUTHZ_GRANTED elseif r.user == nil then return apache2.AUTHZ_DENIED_NO_USER elseif r.user == user then return apache2.AUTHZ_GRANTED else return apache2.AUTHZ_DENIED end end
La configuration suivante enregistre cette fonction en tant que
fournisseur foo, et la configure por l'URL / :
LuaAuthzProvider foo authz_provider.lua authz_check_foo <Location "/"> Require foo 10.1.2.3 john_doe </Location>
Les fonctions d'accroche déterminent la manière dont les modules (et les scripts Lua) participent au traitement des requêtes. Chaque type d'accroche proposé par le serveur a un rôle spécifique, comme l'association de requêtes au système de fichiers, le contrôle d'accès, ou la définition de types MIME :
| Phase d'accroche | Directive mod_lua | Description |
|---|---|---|
| Gestionnaire rapide | LuaQuickHandler |
Il s'agit de la première accroche appelée lorsqu'une requête a été associée à un serveur ou un serveur virtuel. |
| Phase de pré-traduction | LuaHookPreTranslateName |
Cette phase traduit l'URI de la requête en nom de fichier sur le
système avant la phase de décodage. Des modules comme
mod_proxy peuvent agir au cours de cette phase. |
| Phase de traduction | LuaHookTranslateName |
Cette phase traduit l'URI de la requête en nom de fichier
sur le système. Ce sont des modules comme
mod_alias et mod_rewrite qui
interviennent au cours de cette phase. |
| Choix du lieu de stockage de la ressource | LuaHookMapToStorage |
Cette phase définit le lieu de stockage de la ressource : physique, en cache ou externe/mandaté. Elle est assurée par les modules de mandat ou de mise en cache. |
| Autorisation d'accès | LuaHookAccessChecker |
Cette phase vérifie si un client a l'autorisation d'accès à la ressource. Elle s'exécute avant l'authentification de l'utisateur ; il faut donc être prudent. |
| Vérification de l'identifiant utilisateur | LuaHookCheckUserID |
Cette phase vérifie l'identifiant de l'utilisateur ayant fait l'objet d'une négociation. |
| Vérification de l'autorisation d'accès | LuaHookAuthChecker
ou
LuaAuthzProvider |
Cette phase vérifie l'autorisation d'accès d'un utilisateur en fonction des ses paramètres de connexion, comme l'identifiant, le certificat, etc... |
| Vérification du type de la ressource | LuaHookTypeChecker |
Cette phase assigne un type de contenu et un gestionnaire à la ressource. |
| Derniers réglages | LuaHookFixups |
C'est la dernière phase avant l'activation des gestionnaires de contenu. Toute modification de dernière minute à la requête doit être effectuée ici. |
| Gestionnaire de contenu | fichiers fx. .lua ou directive LuaMapHandler |
C'est durant cette phase que le contenu est traité. Les fichiers sont lus, interprétés, certains sont exécutés, et le résultat obtenu est envoyé au client. |
| Journalisation | LuaHookLog |
Lorsqu'une requête a été traitée, plusieurs phases de journalisation interviennent, et enregistrent leurs résultats dans les fichiers d'erreur ou d'accès. Mod_lua peut s'intercaler au départ de ce processus et ainsi contrôler la journalisation. |
Les fonctions d'accroche reçoivent l'objet de la requête comme seul
argument (sauf LuaAuthzProvider qui reçoit aussi des arguments en
provenance de la directive Require). Elles peuvent renvoyer une valeur,
selon la fonction, mais il s'agit en général d'un
code d'état HTTP ou des valeurs OK, DONE, ou DECLINED,
que vous pouvez écrire dans Lua sous la forme apache2.OK,
apache2.DONE, ou apache2.DECLINED.
translate_name.lua
-- exemple d'accroche qui réécrit un URI en chemin du système de fichiers. require 'apache2' function translate_name(r) if r.uri == "/translate-name" then r.filename = r.document_root .. "/find_me.txt" return apache2.OK end -- on ne gère pas cette URL et on donne sa chance à un autre module return apache2.DECLINED end
translate_name2.lua
--[[ exemple d'accroche qui réécrit un URI vers un autre URI. Il renvoie un apache2.DECLINED pour permettre à un autre interpréteur d'URL de travailler sur la substitution, y compris l'accroche translate_name de base dont les tables de correspondances se basent sur DocumentRoot. Note: utilisez le drapeau early/late de la directive pour l'exécuter avant ou après mod_alias. --]] require 'apache2' function translate_name(r) if r.uri == "/translate-name" then r.uri = "/find_me.txt" return apache2.DECLINED end return apache2.DECLINED end
request_rec est considérée en tant que donnée utilisateur. Elle possède une métatable qui vous permet d'accomplir des choses intéressantes. Pour la plus grande partie, elle possède les mêmes champs que la structure request_rec, la plupart d'entre eux étant accessibles en lecture et écriture (le contenu des champs de la table peut être modifié, mais les champs eux-mêmes ne peuvent pas être établis en tant que tables distinctes).
| Nom | Type Lua | Modifiable | Description |
|---|---|---|---|
allowoverrides |
string | non | L'option AllowOverride s'applique à la requête courante. |
ap_auth_type |
string | oui | Ce champ contient le type d'authentification effectuée
(par exemple basic) |
args |
string | oui | La chaîne de paramètres de la requête (par exemple
foo=bar&name=johnsmith) |
assbackwards |
boolean | non | contient true s'il s'agit d'une requête de style HTTP/0.9
(par exemple GET /foo (sans champs d'en-tête) ) |
auth_name |
string | non | La chaîne d'identification utilisée pour la vérification de l'autorisation d'accès (si elle est disponible). |
banner |
string | non | La bannière du serveur, par exemple Apache HTTP
Server/2.4.3 openssl/0.9.8c |
basic_auth_pw |
string | non | Le mot de passe pour l'authentification de base envoyé avec la requête, s'il existe |
canonical_filename |
string | non | Le nom de fichier canonique de la requête |
content_encoding |
string | non | Le type de codage du contenu de la requête courante |
content_type |
string | oui | Le type de contenu de la requête courante, tel qu'il a été
déterminé au cours de la phase type_check (par exemple
image/gif ou text/html) |
context_prefix |
string | non | |
context_document_root |
string | non | |
document_root |
string | non | La racine des documents du serveur |
err_headers_out |
table | non | L'en-tête MIME de l'environnement pour la réponse, écrit même en cas d'erreur et conservé pendant les redirections internes. Une table lua en lecture seule est disponible pour l'itération sous la forme r:err_headers_out_table(). |
filename |
string | oui | Le nom de fichier correspondant à la requête, par exemple /www/example.com/foo.txt. Il peut être modifié au cours des phases pre-translate-name, translate-name ou map-to-storage du traitement de la requête pour permettre au gestionnaire par défaut (ou aux gestionnaires de script) de servir une version du fichier autre que celle demandée. |
handler |
string | oui | Le nom du gestionnaire qui
doit traiter la requête, par exemple lua-script
si elle doit être traitée par mod_lua. Cette valeur est en
général définie via les directives AddHandler ou SetHandler, mais peut aussi l'être
via mod_lua pour permettre à un autre gestionnaire de traiter
une requête spécifique qui ne serait pas traitée par défaut
par ce dernier.
|
headers_in |
table | oui | Les en-têtes MIME de l'environnement de la requête. Il
s'agit des en-têtes comme Host, User-Agent,
Referer, etc... Une table lua en lecture seule est disponible pour
l'itération sous la forme r:headers_in_table(). |
headers_out |
table | oui | Les en-têtes MIME de l'environnement de la réponse. Une table lua en lecture seule est disponible pour l'itération sous la forme r:headers_out_table(). |
hostname |
string | non | Le nom d'hôte, tel que défini par l'en-tête
Host: ou par un URI complet. |
is_https |
boolean | non | Indique si la requête à été faite via HTTPS |
is_initial_req |
boolean | non | Indique si la requête courante est la requête initiale ou une sous-requête. |
limit_req_body |
number | non | La taille maximale du corps de la requête, ou 0 si aucune limite. |
log_id |
string | non | L'identifiant de la requête dans les journaux d'accès ou d'erreur. |
method |
string | non | La méthode de la requête, par exemple GET ou
POST. |
notes |
table | oui | Une liste de notes qui peuvent être transmises d'un module à l'autre. Une table lua en lecture seule est disponible pour l'itération sous la forme r:notes_table(). |
options |
string | non | La valeur de la directive Options pour la requête courante. |
path_info |
string | non | La valeur de PATH_INFO extraite de la requête. |
port |
number | non | Le port du serveur utilisé par la requête. |
protocol |
string | non | Le protocole utilisé, par exemple HTTP/1.1 |
proxyreq |
string | oui | Indique s'il s'agit d'une requête mandatée ou non. Cette valeur est en général définie au cours de la phase post_read_request/pre_translate_name/translate_name du traitement de la requête. |
range |
string | non | Le contenu de l'en-tête Range:. |
remaining |
number | non | Le nombre d'octets du corps de la requête restant à lire. |
server_built |
string | non | La date de compilation du serveur. |
server_name |
string | non | Le nom du serveur pour cette requête. |
some_auth_required |
boolean | non | Indique si une autorisation est/était requise pour cette requête. |
subprocess_env |
table | oui | Le jeu de variables d'environnement pour cette requête. Une table lua en lecture seule est disponible pour l'itération sous la forme r:subprocess_env_table(). |
started |
number | non | Le moment où le serveur a été (re)démarré, en secondes depuis epoch (1er janvier 1970) |
status |
number | oui | Le code de retour (courant) pour cette requête, par
exemple 200 ou 404. |
the_request |
string | non | La chaîne de la requête telle qu'elle a été envoyée par le
client, par exemple GET /foo/bar HTTP/1.1. |
unparsed_uri |
string | non | La partie URI non interprétée de la requête |
uri |
string | oui | L'URI après interprétation par httpd |
user |
string | oui | Si une authentification a été effectuée, nom de l'utilisateur authentifié. |
useragent_ip |
string | non | L'adresse IP de l'agent qui a envoyé la requête |
L'objet request_rec possède (au minimum) les méthodes suivantes :
r:flush() -- vide le tampon de sortie
-- Renvoie true si le vidage a été effectué avec succès,
-- false dans le cas contraire.
while nous_avons_des_données_à_envoyer do
r:puts("Bla bla bla\n") -- envoi des données à envoyer vers le tampon
r:flush() -- vidage du tampon (envoi au client)
r.usleep(500000) -- mise en attente pendant 0.5 secondes et bouclage
end
r:add_output_filter(filter_name) -- ajoute un filtre en sortie
r:add_output_filter("fooFilter") -- insère le filtre fooFilter dans le flux de sortie
r:sendfile(filename) -- envoie un fichier entier au client en utilisant sendfile s'il est
-- supporté par la plateforme :
if use_sendfile_thing then
r:sendfile("/var/www/large_file.img")
end
r:parseargs() -- renvoie deux tables : une table standard de couples
-- clé/valeur pour les données GET simples,
-- et une autre pour les données
-- multivaluées (par exemple foo=1&foo=2&foo=3) :
local GET, GETMULTI = r:parseargs()
r:puts("Votre nom est : " .. GET['name'] or "Unknown")
r:parsebody()([sizeLimit]) -- interprète le corps de la
-- requête en tant que POST et renvoie
-- deux tables lua, comme r:parseargs(). Un
-- nombre optionnel peut être fourni
-- pour spécifier le nombre maximal
-- d'octets à interpréter. La
-- valeur par défaut est 8192.
local POST, POSTMULTI = r:parsebody(1024*1024)
r:puts("Votre nom est : " .. POST['name'] or "Unknown")
r:puts("bonjour", " le monde", "!") -- affichage dans le corps de la réponse
r:write("une simple chaîne") -- affichage dans le corps de la réponse
r:escape_html("<html>test</html>") -- Echappe le code HTML et renvoie le résultat
r:base64_encode(string) -- Encode une chaîne à l'aide du standard de codage Base64.
local encoded = r:base64_encode("This is a test") -- returns VGhpcyBpcyBhIHRlc3Q=
r:base64_decode(string) -- Décode une chaîne codée en Base64.
local decoded = r:base64_decode("VGhpcyBpcyBhIHRlc3Q=") -- returns 'This is a test'
r:md5(string) -- Calcule et renvoie le condensé MD5 d'une chaîne en mode binaire (binary safe).
local hash = r:md5("This is a test") -- returns ce114e4501d2f4e2dcea3e17b546f339
r:sha1(string) -- Calcule et renvoie le condensé SHA1 d'une chaîne en mode binaire (binary safe).
local hash = r:sha1("This is a test") -- returns a54d88e06612d820bc3be72877c74f257b561b19
r:escape(string) -- Echappe une chaîne de type URL. local url = "http://foo.bar/1 2 3 & 4 + 5" local escaped = r:escape(url) -- renvoie 'http%3a%2f%2ffoo.bar%2f1+2+3+%26+4+%2b+5'
r:unescape(string) -- Déséchappe une chaîne de type URL. local url = "http%3a%2f%2ffoo.bar%2f1+2+3+%26+4+%2b+5" local unescaped = r:unescape(url) -- renvoie 'http://foo.bar/1 2 3 & 4 + 5'
r:construct_url(string) -- Construit une URL à partir d'un URI local url = r:construct_url(r.uri)
r.mpm_query(number) -- Interroge le serveur à propos de son module MPM via la requête ap_mpm_query.
local mpm = r.mpm_query(14)
if mpm == 1 then
r:puts("Ce serveur utilise le MPM Event")
end
r:expr(string) -- Evalue une chaîne de type expr. if r:expr("%{HTTP_HOST} =~ /^www/") then r:puts("Ce nom d'hôte commence par www") end
r:scoreboard_process(a) -- Interroge le serveur à propos du
-- processus à la position a.
local process = r:scoreboard_process(1)
r:puts("Le serveur 1 a comme PID " .. process.pid)
r:scoreboard_worker(a, b) -- Interroge le serveur à propos du
-- thread b, dans le processus a.
local thread = r:scoreboard_worker(1, 1)
r:puts("L'ID du thread 1 du serveur 1 est " .. thread.tid .. " et son
état est " .. thread.status)
r:clock() -- Renvoie l'heure courante avec une précision d'une microseconde.
r:requestbody(filename) -- Lit et renvoie le corps d'une requête.
-- Si 'filename' est spécifié, le
-- corps de requête n'est pas
-- renvoyé, mais sauvegardé dans
-- le fichier correspondant.
local input = r:requestbody()
r:puts("Vous m'avez envoyé le corps de requête suivant :\n")
r:puts(input)
r:add_input_filter(filter_name) -- Ajoute le filtre en entrée 'filter_name'.
r:module_info(module_name) -- Interroge le serveur à propos d'un module.
local mod = r.module_info("mod_lua.c")
if mod then
for k, v in pairs(mod.commands) do
r:puts( ("%s: %s\n"):format(k,v)) -- affiche toutes les directives
-- implémentées par ce module.
end
end
r:loaded_modules() -- Renvoie une liste des modules chargés par httpd.
for k, module in pairs(r:loaded_modules()) do
r:puts("J'ai chargé le module " .. module .. "\n")
end
r:runtime_dir_relative(filename) -- Génère le nom d'un fichier run-time
-- (par exemple la mémoire partagée
-- "file") relativement au répertoire de run-time.
r:server_info() -- Renvoie une table contenant des informations à
-- propos du serveur, comme le nom de
-- l'exécutable httpd, le module mpm utilisé, etc...
r:set_document_root(file_path) -- Définit la racine des documents
-- pour la requête à file_path.
r:add_version_component(component_string) -- Ajoute un élément à
-- la bannière du serveur.
r:set_context_info(prefix, docroot) -- Définit le préfixe et la
-- racine des documents du contexte pour une requête.
r:os_escape_path(file_path) -- Convertit un chemin du système de
-- fichiers en URL indépendamment du système d'exploitation.
r:escape_logitem(string) -- Echappe une chaîne pour journalisation.
r.strcmp_match(string, pattern) -- Vérifie si 'string' correspond à
-- 'pattern' via la fonction strcmp_match (GLOBs). Par exemple, est-ce que
-- 'www.example.com' correspond à '*.example.com' ?
local match = r.strcmp_match("foobar.com", "foo*.com")
if match then
r:puts("foobar.com matches foo*.com")
end
r:set_keepalive() -- Définit l'état de persistance d'une requête.
-- Renvoie true dans la mesure du possible, false dans le cas contraire.
r:make_etag() -- Génère et renvoie le etag pour la requête courante.
r:send_interim_response(clear) -- Renvoie une réponse d'intérim (1xx) au
-- client. Si 'clear' est vrai, les en-têtes disponibles
-- seront envoyés et effacés.
r:custom_response(status_code, string) -- Génère et définit une réponse
-- personnalisée pour un code d'état particulier.
-- Le fonctionnement est très proche de celui de la directive ErrorDocument.
r:custom_response(404, "Baleted!")
r.exists_config_define(string) -- Vérifie si une définition de configuration existe.
if r.exists_config_define("FOO") then
r:puts("httpd a probablement été lancé avec l'option -DFOO, ou FOO a
été défini dans la configuration")
end
r:state_query(string) -- Interroge le serveur à propos de son état.
r:stat(filename [,wanted]) -- Exécute stat() sur un fichier, et renvoie une table contenant
-- des informations à propos de ce fichier.
local info = r:stat("/var/www/foo.txt")
if info then
r:puts("Ce fichier existe et a été modifié pour la dernière fois à : " .. info.modified)
end
r:regex(string, pattern [,flags]) -- Exécute une recherche à base d'expression rationnelle
-- sur une chaîne, et renvoie les éventuelles correspondances trouvées.
local matches = r:regex("foo bar baz", [[foo (\w+) (\S*)]])
if matches then
r:puts("L'expression rationnelle correspond et le dernier mot
capturé ($2) est : " .. matches[2])
end
-- Exemple avec insensibilité à la casse :
local matches = r:regex("FOO bar BAz", [[(foo) bar]], 1)
-- les drapeaux peuvent être une combibaison bit à bit de :
-- 0x01: insensibilité à la casse
-- 0x02: recherche multiligne
r.usleep(microsecondes) -- Interrompt l'exécution du script pendant le nombre de microsecondes spécifié.
r:dbacquire(dbType[, dbParams]) -- Acquiert une connexion à une base de données et renvoie une classe database.
-- Voir 'Connectivité aux bases de données'
-- pour plus de détails.
r:ivm_set("key", value) -- Défini une variable Inter-VM avec une valeur spécifique.
-- Ces valeurs sont conservées même si la VM est
-- arrêtée ou non utilisée, et ne doivent donc être
-- utilisées que si MaxConnectionsPerChild > 0.
-- Les valeurs peuvent être de type number, string
-- ou boolean et sont stockées séparément pour
-- chaque processus (elles ne seront donc pas d'une
-- grande utilité si l'on utilise le mpm prefork).
r:ivm_get("key") -- Lit le contenu d'une variable définie via ivm_set. Renvoie
-- le contenu de la variable si elle existe, ou nil
-- dans le cas contraire.
-- Voici un exemple de lecture/écriture qui sauvegarde une variable
-- globale en dehors de la VM :
function handle(r)
-- La première VM qui effectue l'appel suivant n'obtiendra aucune
-- valeur, et devra la créer
local foo = r:ivm_get("cached_data")
if not foo then
foo = do_some_calcs() -- simulation de valeurs de retour
r:ivm_set("cached_data", foo) -- définition globale de la variable
end
r:puts("La donnée en cache est : ", foo)
end
r:htpassword(string [,algorithm [,cost]]) -- Génère un hash de mot de passe à partir d'une chaîne.
-- algorithm: 0 = APMD5 (défaut), 1 = SHA, 2 = BCRYPT, 3 = CRYPT.
-- cost: ne s'utilise qu'avec l'algorythme BCRYPT (défaut = 5).
r:mkdir(dir [,mode]) -- Crée un répertoire et définit son mode via le paramètre optionnel mode.
r:mkrdir(dir [,mode]) -- Crée des répertoires de manière récursive et définit
-- leur mode via le paramètre optionnel mode.
r:rmdir(dir) -- Supprime un répertoire.
r:touch(file [,mtime]) -- Définit la date de modification d'un fichier à la date courante ou à
-- la valeur optionnelle mtime en msec.
r:get_direntries(dir) -- Renvoie une table contenant toutes les entrées de répertoires.
-- Renvoie un chemin sous forme éclatée en chemin, fichier, extension
function handle(r)
local dir = r.context_document_root
for _, f in ipairs(r:get_direntries(dir)) do
local info = r:stat(dir .. "/" .. f)
if info then
local mtime = os.date(fmt, info.mtime / 1000000)
local ftype = (info.filetype == 2) and "[dir] " or "[file]"
r:puts( ("%s %s %10i %s\n"):format(ftype, mtime, info.size, f) )
end
end
end
r.date_parse_rfc(string) -- Interprète une chaîne date/heure et renvoie l'équivalent en secondes depuis epoche.
r:getcookie(key) -- Obtient un cookie HTTP
r:setcookie(key, value, secure, expires) -- Définit un cookie HTTP, par exemple :
r:setcookie("foo", "bar and stuff", false, os.time() + 86400)
r:wsupgrade() -- Met à jour une connexion vers les WebSockets si possible (et si demandé) :
if r:wsupgrade() then -- si la mise à jour est possible :
r:wswrite("Bienvenue dans les websockets!") -- écrit quelque chose à l'intention du client
r:wsclose() -- Au revoir !
end
r:wsread() -- Lit un cadre de websocket depuis une connexion vers websocket mise à jour (voir ci-dessus) :
local line, isFinal = r:wsread() -- isFinal indique s'il s'agit du cadre final.
-- dans le cas contraire, on peut lire les cadres suivants
r:wswrite("Vous avez écrit : " .. line)
r:wswrite(line) -- écrit un cadre vers un client WebSocket :
r:wswrite("Bonjour le Monde !")
r:wsclose() -- ferme une requête WebSocket et l'achève pour httpd :
if r:wsupgrade() then
r:wswrite("Ecrire quelque chose : ")
local line = r:wsread() or "nothing"
r:wswrite("Vous avez écrit : " .. line);
r:wswrite("Au revoir !")
r:wsclose()
end
-- exemples de messages de journalisation
r:trace1("Ceci est un message de journalisation de niveau
trace") -- les niveaux valides vont de trace1 à trace8
r:debug("Ceci est un message de journalisation de niveau debug")
r:info("Ceci est un message de journalisation de niveau info")
r:notice("Ceci est un message de journalisation de niveau notice")
r:warn("Ceci est un message de journalisation de niveau warn")
r:err("Ceci est un message de journalisation de niveau err")
r:alert("Ceci est un message de journalisation de niveau alert")
r:crit("Ceci est un message de journalisation de niveau crit")
r:emerg("Ceci est un message de journalisation de niveau emerg")
Le paquet nommé apache2 est fourni avec (au minimum) le
contenu suivant :
mod_proxymod_authz_coreLes autres codes d'état HTTP ne sont pas encore implémentés.
Les fonctions de filtrage implémentées via les directives LuaInputFilter ou LuaOutputFilter sont conçues comme des
fonctions de 3ème phase non blocantes utilisant des sous-routines
pour suspendre et reprendre l'exécution d'une fonction lorsque des
paquets de données sont envoyés à la chaîne de filtrage. La
structure de base d'une telle fonction est :
function filter(r)
-- Nous indiquons tout d'abord que nous sommes prêts à recevoir des
-- blocs de données.
-- Avant ceci, nous pouvons définir notre environnement, tester
-- certaines conditions, et, si nous le jugeons nécessaire, refuser le
-- filtrage d'une requête :
if something_bad then
return -- Le filtrage est sauté
end
-- Sans se préoccuper des données que nous devons éventuellement ajouter, un arrêt est réalisé ici.
-- Noter que les filtres de sortie sont les seuls capables d'ajouter des éléments au début des données.
-- Les filtres en entrée peuvent ajouter des éléments à la fin des données au stade final.
coroutine.yield([optional header to be prepended to the content])
-- Après cet arrêt, nous allons recevoir d'autres blocs de données, un par un ;
-- nous pouvons les traiter comme il nous plaît et procéder à la réponse.
-- Ces blocs sont conservés dans la variable globale 'bucket', nous réalisons donc
-- une boucle pour vérifier que 'bucket' n'est pas vide :
while bucket ~= nil do
local output = mangle(bucket) -- Do some stuff to the content
coroutine.yield(output) -- Return our new content to the filter chain
end
-- Une fois les blocs de données épuisés, 'bucket' est positionné à une valeur vide ('nil'),
-- ce qui va nous faire sortir de cette boucle et nous amener à l'étape suivante.
-- On peut ajouter ce qu'on veut à la fin des données à cette étape, qui constitue le dernier
-- arrêt. Les filtres d'entrée comme de sortie peuvent servir à ajouter des éléments à la fin
-- des données à cette étape.
coroutine.yield([optional footer to be appended to the content])
end
Mod_lua implémente une fonctionnalité basique de connexion aux bases de données permettant d'envoyer des requêtes ou d'exécuter des commandes auprès des moteurs de base de données les plus courants (mySQL, PostgreSQL, FreeTDS, ODBC, SQLite, Oracle), ainsi que mod_dbd.
dbType, le premier paramètre de dbacquire, est
sensible à la casse.
Ses valeurs possibles sont mysql, pgsql,
freetds, odbc, sqlite2,
sqlite3, oracle ou mod_dbd.
L'exemple suivant montre comment se connecter à une base de données et extraire des informations d'une table :
function handle(r)
-- connexion à la base de données
local database, err = r:dbacquire("mysql", "server=localhost,user=someuser,pass=somepass,dbname=mydb")
if not err then
-- Sélection de certaines informations
local results, err = database:select(r, "SELECT `name`, `age` FROM `people` WHERE 1")
if not err then
local rows = results(0) -- extrait tous les enregistrements en mode synchrone
for k, row in pairs(rows) do
r:puts( string.format("Name: %s, Age: %s<br/>", row[1], row[2]) )
end
else
r:puts("Database query error: " .. err)
end
database:close()
else
r:puts("Connexion à la base de données impossible : " .. err)
end
end
Pour utiliser mod_dbd, spécifiez
mod_dbd comme type de base de données, ou laissez le champ
vide :
local database = r:dbacquire("mod_dbd")
L'objet database renvoyé par dbacquire possède
les méthodes suivantes :
Sélection normale et requête vers une base de données :
-- Exécution d'une requête et renvoie du nombre d'enregistrements affectés : local affected, errmsg = database:query(r, "DELETE FROM `tbl` WHERE 1") -- Exécution d'une requête et renvoie du résultat qui peut être utilisé en mode synchrone ou asynchrone : local result, errmsg = database:select(r, "SELECT * FROM `people` WHERE 1")
Utilisation de requêtes préparées (recommandé) :
-- Création et exécution d'une requête préparée :
local statement, errmsg = database:prepare(r, "DELETE FROM `tbl` WHERE `age` > %u")
if not errmsg then
local result, errmsg = statement:query(20) -- exécute la requête pour age > 20
end
-- Extrait une requête préparée depuis une directive DBDPrepareSQL :
local statement, errmsg = database:prepared(r, "someTag")
if not errmsg then
local result, errmsg = statement:select("John Doe", 123) -- injecte les valeurs "John Doe" et 123 dans la requête
end
Echappement de valeurs, fermeture de la base données, etc...
-- Echappe une valeur pour pouvoir l'utiliser dans une requête : local escaped = database:escape(r, [["'|blabla]]) -- Ferme une base de données et libère les liens vers cette dernière : database:close() -- Vérifie si une connexion à une base de données est en service et opérationnelle : local connected = database:active()
Les jeux d'enregistrements renvoyés par db:select ou par des
requêtes préparées créées par db:prepare permettent de
sélectionner des enregistrements en mode synchrone ou
asynchrone, selon le nombre d'enregistrements spécifié :
result(0) sélectionne tous les enregistrements en mode
synchrone en renvoyant une table d'enregistrements.
result(-1) sélectionne le prochain enregistrement disponible en
mode asynchrone.
result(N) sélectionne l'enregistrement numéro
N en mode asynchrone.
-- extrait un jeu d'enregistrements via une requête régulière : local result, err = db:select(r, "SELECT * FROM `tbl` WHERE 1") local rows = result(0) -- sélectionne tous les enregistrements en mode synchrone local row = result(-1) -- sélectionne le prochain enregistrement disponible en mode asynchrone local row = result(1234) -- sélectionne l'enregistrement 1234 en mode asynchrone local row = result(-1, true) -- Lit l'enregistrement suivant en utilisant les noms d'enregistrements comme index.
Il est possible de construire une fonction qui renvoie une fonction itérative permettant de traiter tous les enregistrement en mode synchrone ou asynchrone selon la valeur de l'argument async :
function rows(resultset, async)
local a = 0
local function getnext()
a = a + 1
local row = resultset(-1)
return row and a or nil, row
end
if not async then
return pairs(resultset(0))
else
return getnext, self
end
end
local statement, err = db:prepare(r, "SELECT * FROM `tbl` WHERE `age` > %u")
if not err then
-- sélectionne des enregistrements en mode asynchrone :
local result, err = statement:select(20)
if not err then
for index, row in rows(result, true) do
....
end
end
-- sélectionne des enregistrements en mode synchrone :
local result, err = statement:select(20)
if not err then
for index, row in rows(result, false) do
....
end
end
end
Lorsqu'elles ne sont plus utilisées, les connexions aux bases de
données doivent être fermées avec database:close(). Si vous
ne les fermez pas manuellement, mod_lua les fermera peut-être en tant
que résidus collectés, mais si ce n'est pas le cas, vous pouvez finir
pas avoir trop de connexions vers la base de données inutilisées. Les
deux mesures suivantes sont pratiquement identiques :
-- Méthode 1 : fermeture manuelle de la connexion
local database = r:dbacquire("mod_dbd")
database:close() -- c'est tout
-- Méthode 2 : on laisse le collecteur de résidus la fermer
local database = r:dbacquire("mod_dbd")
database = nil -- on coupe le lien
collectgarbage() -- fermeture de la connexion par le collecteur de résidus
Bien que les fonctions query et run
soient toujours disponibles, il est recommandé d'utiliser des requêtes
préparées chaque fois que possible, afin d'une part d'optimiser les
performances (si votre connexion reste longtemps en vie), et d'autre part
minimiser le risque d'attaques par injection SQL. Les fonctions
run et query ne doivent être utilisées que
lorsque la requête ne contient pas de variables (requête statique). Dans
le cas des requêtes dynamiques, utilisez db:prepare ou
db:prepared.
| Description: | Branche une fonction fournisseur d'autorisation dans mod_authz_core
|
|---|---|
| Syntaxe: | LuaAuthzProvider provider_name /path/to/lua/script.lua function_name |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_lua |
| Compatibilité: | Disponible depuis la version 2.4.3 du serveur HTTP Apache |
Lorsqu'une fonction lua a été enregistrée en tant que fournisseur
d'autorisation, elle peut être appelée via la directive Require :
LuaRoot "/usr/local/apache2/lua" LuaAuthzProvider foo authz.lua authz_check_foo <Location "/"> Require foo johndoe </Location>
require "apache2"
function authz_check_foo(r, who)
if r.user ~= who then return apache2.AUTHZ_DENIED
return apache2.AUTHZ_GRANTED
end
| Description: | Configure le cache de code compilé. |
|---|---|
| Syntaxe: | LuaCodeCache stat|forever|never |
| Défaut: | LuaCodeCache stat |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Cette directive permet de définir le comportement du cache de code en mémoire. La valeur par défaut est stat ; dans ce cas, le script du niveau le plus haut (et pas les scripts inclus) est vérifié à chaque fois que ce fichier est nécessaire, et est rechargé si la date de modification est plus récente que celle du script déjà chargé. Les autres valeurs permettent respectivement de garder le fichier en cache perpétuellement (forever - jamais vérifié ni remplacé), ou de ne jamais le mettre en cache (never).
En général, les valeurs stat et forever sont utilisées pour un serveur en production, et les valeurs stat ou never pour un serveur en développement.
LuaCodeCache stat LuaCodeCache forever LuaCodeCache never
| Description: | Fournit un point d'entrée pour la phase access_checker du traitement de la requête |
|---|---|
| Syntaxe: | LuaHookAccessChecker /chemin/vers/lua/script.lua hook_function_name [early|late] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
| Compatibilité: | Le troisième argument optionnel est disponible depuis la version 2.3.15 du serveur HTTP Apache. |
Ajoute votre fonction d'accroche à la phase access_checker. Une fonction d'accroche access checker renvoie en général OK, DECLINED, ou HTTP_FORBIDDEN.
Les arguments optionnels "early" ou "late" permettent de contrôler le moment auquel ce script s'exécute par rapport aux autres modules.
| Description: | Fournit un point d'entrée pour la phase auth_checker du traitement de la requête |
|---|---|
| Syntaxe: | LuaHookAuthChecker /chemin/vers/lua/script.lua hook_function_name [early|late] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
| Compatibilité: | Le troisième argument optionnel est disponible depuis la version 2.3.15 du serveur HTTP Apache. |
Invoque une fonction lua au cours de la phase auth_checker du traitement de la requête. Cette directive peut s'utiliser pour implémenter une vérification arbitraire de l'authentification et de l'autorisation. Voici un exemple très simple :
require 'apache2'
-- fonction d'accroche authcheck fictive
-- Si la requête ne contient aucune donnée d'authentification, l'en-tête
-- de la réponse est défini et un code 401 est renvoyé afin de demander au
-- navigateur d'effectuer une authentification basique. Si la requête
-- comporte des données d'authentification, elles ne sont pas vraiment
-- consultées, mais on admet la prise en compte de l'utilisateur 'foo' et
-- on la valide. On vérifie ensuite si l'utilisateur est bien 'foo' et on
-- accepte la requête.
function authcheck_hook(r)
-- recherche des informations d'authentification
auth = r.headers_in['Authorization']
if auth ~= nil then
-- définition d'un utilisateur par défaut
r.user = 'foo'
end
if r.user == nil then
r:debug("authcheck: user is nil, returning 401")
r.err_headers_out['WWW-Authenticate'] = 'Basic realm="WallyWorld"'
return 401
elseif r.user == "foo" then
r:debug('user foo: OK')
else
r:debug("authcheck: user='" .. r.user .. "'")
r.err_headers_out['WWW-Authenticate'] = 'Basic realm="WallyWorld"'
return 401
end
return apache2.OK
end
Les arguments optionnels "early" ou "late" permettent de contrôler le moment auquel ce script s'exécute par rapport aux autres modules.
| Description: | Fournit un point d'entrée pour la phase check_user_id du traitement de la requête |
|---|---|
| Syntaxe: | LuaHookCheckUserID /chemin/vers/lua/script.lua hook_function_name [early|late] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
| Compatibilité: | Le troisième argument optionnel est disponible depuis la version 2.3.15 du serveur HTTP Apache. |
...
Les arguments optionnels "early" ou "late" permettent de contrôler le moment auquel ce script s'exécute par rapport aux autres modules.
| Description: | Fournit un point d'entrée pour la phase de correction du traitement de la requête |
|---|---|
| Syntaxe: | LuaHookFixups /chemin/vers/lua/script.lua hook_function_name |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Idem LuaHookTranslateName, mais s'exécute durant la phase de correction.
| Description: | Fournit un point d'entrée pour la phase insert_filter du traitement de la requête |
|---|---|
| Syntaxe: | LuaHookInsertFilter /chemin/vers/lua/script.lua hook_function_name |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Non encore implémenté
| Description: | Permet une insertion dans la phase de journalisation du traitement d'une requête |
|---|---|
| Syntaxe: | LuaHookLog /path/to/lua/script.lua log_function_name |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Ce dispositif d'insertion simple permet d'exécuter une fonction
lorsque httpd entre dans la phase de journalisation du traitement
d'une requête. Vous pouvez ainsi ajouter des données à vos propres
entrées de journalisation, manipuler les entrées du journal standard
avant leur enregistrement ou empêcher l'enregistrement d'une entrée
dans le journal. Pour empêcher l'enregistrement normal des entrées
du journal, renvoyez simplement apache2.DONE dans votre
gestionnaire de journalisation, ou au contraire, renvoyez
apache2.OK pour que httpd effectue une journalisation
normale.
Exemple :
LuaHookLog "/path/to/script.lua" logger
-- /path/to/script.lua --
function logger(r)
-- on joue à pile ou face :
-- Si on obtient 1, on écrit dans notre propre journal Lua et on dit
-- à httpd de ne pas enregistrer d'entrée dans le journal standard..
-- Si on obtient 2, on nettoie un peu les données avant que httpd ne
-- les enregistre dans le journal standard.
if math.random(1,2) == 1 then
-- On effectue notre propre journalisation et le journal
-- standard n'est pas alimenté
local f = io.open("/foo/secret.log", "a")
if f then
f:write("Quelque chose de secret est arrivé à " .. r.uri .. "\n")
f:close()
end
return apache2.DONE -- On dit à httpd de ne rien enregistrer
--dans le journal standard
else
r.uri = r.uri:gsub("somesecretstuff", "") -- nettoie les données
return apache2.OK -- et httpd doit alors les enregistrer.
end
end
| Description: | Fournit un point d'entrée pour la phase map_to_storage du traitement de la requête |
|---|---|
| Syntaxe: | LuaHookMapToStorage /chemin/vers/lua/script.lua hook_function_name |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Identique à la directive
LuaHookTranslateName, mais s'exécute à la phase
map-to-storage du traitement de la requête. Les modules comme
mod_cache agissent pendant cette phase, ce qui permet de
présenter un exemple intéressant de ce que l'on peut faire ici :
LuaHookMapToStorage "/path/to/lua/script.lua" check_cache
require"apache2"
cached_files = {}
function read_file(filename)
local input = io.open(filename, "r")
if input then
local data = input:read("*a")
cached_files[filename] = data
file = cached_files[filename]
input:close()
end
return cached_files[filename]
end
function check_cache(r)
if r.filename:match("%.png$") then -- Ne concerne que les fichiers PNG
local file = cached_files[r.filename] -- Vérifie les entrées du cache
if not file then
file = read_file(r.filename) -- Lit le fichier vers le cache
end
if file then -- Si le fichier existe, on l'envoie
r.status = 200
r:write(file)
r:info(("%s a été envoyé au client depuis le cache"):format(r.filename))
return apache2.DONE -- cout-circuite le gestionnaire par défaut des fichiers PNG
end
end
return apache2.DECLINED -- Si nous n'avons rien eu à faire, nous laissons les autres s'en charger
end
| Description: | Fournit un point d'entrée pour la phase de pré-traduction du traitement d'une requête |
|---|---|
| Syntaxe: | LuaHookPreTranslate /path/to/lua/script.lua hook_function_name |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Identique à LuaHookTranslateName, mais s'exécute au cours de la phase de pré-traduction où les pourcentages du chemin de l'URI ne sont pas encore décodés.
| Description: | Fournit un point d'entrée à la phase du nom de traduction du traitement de la requête |
|---|---|
| Syntaxe: | LuaHookTranslateName /chemin/vers/lua/script.lua nom_fonction_hook [early|late] |
| Contexte: | configuration globale, serveur virtuel |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
| Compatibilité: | Le troisième argument optionnel est disponible depuis la version 2.3.15 du serveur HTTP Apache. |
Cette directive permet d'ajouter un point d'entrée (à APR_HOOK_MIDDLE) à la phase du nom de traduction du traitement de la requête. La fonction hook accepte un seul argument, le request_rec, et doit renvoyer un code d'état qui est soit un code d'erreur HTTP, ou une constante définie dans le module apache2 : apache2.OK, apache2.DECLINED, ou apache2.DONE.
Pour ceux qui ne sont pas familiers avec les points d'entrée (hook), en gros, chaque hook sera invoqué jusqu'à ce que l'un d'entre eux renvoie apache2.OK. Si un hook n'effectuer pas la traduction, il doit juste renvoyer apache2.DECLINED. Si le traitement de la requête doit être interrompu, la valeur renvoyée doit être apache2.DONE.
Exemple :
# httpd.conf LuaHookTranslateName "/scripts/conf/hooks.lua" silly_mapper
-- /scripts/conf/hooks.lua --
require "apache2"
function silly_mapper(r)
if r.uri == "/" then
r.filename = "/var/www/home.lua"
return apache2.OK
else
return apache2.DECLINED
end
end
Cette directive ne peut être
utilisée ni à l'intérieur d'une section <Directory> ou <Files>, ni dans un fichier htaccess.
Les arguments optionnels "early" ou "late" permettent de contrôler le moment auquel ce script s'exécute par rapport aux autres modules.
| Description: | Fournit un point d'entrée pour la phase type_checker du traitement de la requête |
|---|---|
| Syntaxe: | LuaHookTypeChecker /chemin/vers/lua/script.lua hook_function_name |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Cette directive fournit un point d'entrée pour la phase type_checker du traitement de la requête. Cette phase correspond au moment où la requête se voit assigner un type et un gestionnaire de contenu, et peut donc être utilisée pour modifier le type et le gestionnaire en fonction de l'entrée :
LuaHookTypeChecker "/path/to/lua/script.lua" type_checker
function type_checker(r)
if r.uri:match("%.to_gif$") then -- foo.png.to_gif convient
r.content_type = "image/gif" -- affectation du type image/gif
r.handler = "gifWizard" -- force le traitement de la requête par le module gifWizard
r.filename = r.uri:gsub("%.to_gif$", "") -- corrige le nom du fichier demandé
return apache2.OK
end
return apache2.DECLINED
end
| Description: | Contrôle la manière dont les sections de configuration parentes sont fusionnées dans les enfants |
|---|---|
| Syntaxe: | LuaInherit none|parent-first|parent-last |
| Défaut: | LuaInherit parent-first |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
| Compatibilité: | Versions 2.4.0 et supérieures |
Par défaut, si des directives LuaHook* se trouvent dans des sections de configuration Directory ou Location qui se chevauchent, les scripts définis dans les sections les plus spécifiques s'exécutent après ceux définis dans les sections plus génériques (LuaInherit parent-first). Vous pouvez inverser cet ordre, ou faire en sorte que le contexte parent ne s'applique pas du tout.
Jusqu'aux versions 2.3.x, le comportement par défaut consistait à ignorer les directives LuaHook* situées dans les sections de configuration parentes.
| Description: | Fournit une fonction Lua pour le filtrage en entrée |
|---|---|
| Syntaxe: | LuaInputFilter filter_name /path/to/lua/script.lua function_name |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_lua |
| Compatibilité: | Disponible depuis la version 2.4.5 du serveur HTTP Apache |
Cette directive permet d'ajouter un filtre en entrée sous la forme
d'une fonction Lua. A l'instar des filtres en sorties, les filtres en
entrée fonctionnent comme des sous-routines, intervenant dans un premier
temps avant l'envoi du contenu des tampons, puis chaque fois qu'un
paquet de données doit être transmis à la chaîne, et éventuellement
produisant toute donnée à ajouter aux données en entrée. La variable
globale bucket contient les paquets de données tels qu'ils
sont transmis au script Lua :
LuaInputFilter myInputFilter "/www/filter.lua" input_filter <Files "*.lua"> SetInputFilter myInputFilter </Files>
--[[
Exemple de filtre en entrée qui convertit toutes les données POST en
majuscules.
]]--
function input_filter(r)
print("luaInputFilter called") -- pour débogage
coroutine.yield() -- attend des paquets de données
while bucket do -- Pour chaque paquet, faire ...
local output = string.upper(bucket) -- Convertit toutes les données POST en majuscules
coroutine.yield(output) -- Envoie les données traitées à la chaîne de filtrage
end
-- plus aucune donnée à traiter.
coroutine.yield("&filterSignature=1234") -- Ajoute une signature à la fin
end
Le filtre en entrée peut interdire ou sauter un filtre s'il est considéré comme indésirable :
function input_filter(r)
if not good then
return -- Empêche tout simplement le filtrage et transmet le contenu original
end
coroutine.yield() -- attend des paquets de données
... -- insert les filtres ici
end
Voir "Modification de contenu avec les filtres Lua" pour plus de détails.
| Description: | Met en correspondance un chemin avec un gestionnaire lua |
|---|---|
| Syntaxe: | LuaMapHandler modele-uri /chemin/vers/lua/script.lua
[nom-fonction] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Cette directive permet de faire correspondre un modèle d'uri avec une fonction de gestionnaire située dans un fichier spécifique. Elle utilise les expressions rationnelles PCRE pour mettre en correspondance l'uri, et supporte les groupes de correspondance d'interpolation dans le chemin du fichier et le nom de la fonction. Prenez garde aux problèmes de sécurité en écrivant vos expressions rationnelles.
LuaMapHandler "/(\w+)/(\w+)" "/scripts/$1.lua" "handle_$2"
Cette directive va faire correspondre des uri comme /photos/show?id=9 au fichier /scripts/photos.lua, et invoquera la fonction de gestionnaire handle_show au niveau de la vm lua après chargement de ce fichier.
LuaMapHandler "/bingo" "/scripts/wombat.lua"
Cette directive invoquera la fonction "handle" qui est la valeur par défaut si aucun nom de fonction spécifique n'est spécifié.
| Description: | Fournit une fonction Lua pour le filtrage de contenu en sortie |
|---|---|
| Syntaxe: | LuaOutputFilter filter_name /path/to/lua/script.lua function_name |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_lua |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache |
>Cette directive permet d'ajouter un filtre en sortie sous la forme
d'une fonction Lua. A l'instar des filtres en sorties, les filtres en
entrée fonctionnent comme des sous-routines, intervenant dans un premier
temps avant l'envoi du contenu des tampons, puis chaque fois qu'un
paquet de données doit être transmis à la chaîne, et éventuellement
produisant toute donnée à ajouter aux données en sortie. La variable
globale bucket contient les paquets de données tels qu'ils
sont transmis au script Lua :
LuaOutputFilter myOutputFilter "/www/filter.lua" output_filter <Files "*.lua"> SetOutputFilter myOutputFilter </Files>
--[[
Exemple de filtre en sortie qui échappe toutes les entités HTML en
sortie
]]--
function output_filter(r)
coroutine.yield("(Handled by myOutputFilter)<br/>\n") -- Ajoute des données au début de la sortie,
-- puis attend des paquets de données à traiter
while bucket do -- Pour chaque paquet, faire ...
local output = r:escape_html(bucket) -- Echappe les données en sortie
coroutine.yield(output) -- Envoie les données traitées à la chaîne
end
-- plus aucune donnée à traiter.
end
Comme les filres en entrée, le filtre en sortie peut interdire ou sauter un filtre s'il est considéré comme indésirable :
function output_filter(r)
if not r.content_type:match("text/html") then
return -- Empêche tout simplement le filtrage et transmet le contenu original
end
coroutine.yield() -- attend des paquets de données
... -- insert les filtres ici
end
mod_filterLorsqu'on utilise un filtre Lua comme fournisseur sous-jacent via la
directive FilterProvider, le
filtrage ne fonctionnera que si filter-name est identique à
provider-name.
Voir "Modification de contenu avec les filtres Lua" pour plus de détails.
| Description: | Ajoute un répertoire au package.cpath de lua |
|---|---|
| Syntaxe: | LuaPackageCPath /chemin/vers/include/?.soa |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Cette directive permet d'ajouter un chemin à la liste des chemins de recherche des bibliothèques partagées de lua. Ceci modifie le package.cpath dans les vms lua.
| Description: | Ajoute un répertoire au package.path de lua |
|---|---|
| Syntaxe: | LuaPackagePath /chemin/vers/include/?.lua |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Cette directive permet d'ajouter un chemin à la liste des chemins de recherche du module lua. Elle suit les mêmes conventions que lua. Ceci modifie le package.path dans les vms lua.
LuaPackagePath "/scripts/lib/?.lua" LuaPackagePath "/scripts/lib/?/init.lua"
| Description: | Fournit un point d'entrée pour la gestion rapide du traitement de la requête |
|---|---|
| Syntaxe: | LuaQuickHandler /path/to/script.lua hook_function_name |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Cette phase s'exécute juste après l'attribution de la requête à
un serveur virtuel, et permet d'effectuer certains traitements avant
le déroulement des autres phases, ou de servir une requête sans
avoir à la traduire, l'associer à un espace de stockage, etc...
Comme cette phase s'exécute avant toute autre, les directives telles
que <Location> ou
<Directory> ne
sont pas encore prises en compte, car Les URI n'ont pas encore été
entièrement interprétés.
Cette directive ne peut être
utilisée ni à l'intérieur d'une section <Directory> ou <Files>, ni dans un fichier htaccess.
| Description: | Spécifie le chemin de base pour la résolution des chemins relatifs dans les directives de mod_lua |
|---|---|
| Syntaxe: | LuaRoot /chemin/vers/un/répertoire |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Cette directive permet de spécifier le chemin de base qui sera utilisé pour évaluer tous les chemins relatifs dans mod_lua. En l'absence de cette directive, les chemins relatifs sont résolus par rapport au répertoire de travail courant, ce qui ne sera pas toujours approprié pour un serveur.
| Description: | Une valeur parmi once, request, conn, thread -- la valeur par défaut est once |
|---|---|
| Syntaxe: | LuaScope once|request|conn|thread|server [min] [max] |
| Défaut: | LuaScope once |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_lua |
Cette directive permet de spécifier la durée de vie de l'interpréteur Lua qui sera utilisé dans ce "répertoire". La valeur par défaut est "once".
min et max permettent
de spécifier les nombres minimaux et maximaux d'états lua à stocker
dans la liste.En général, les portées thread et server
sont 2 à 3 fois plus rapides que les autres, car elles n'ont pas besoin
de régénérer de nouveaux états Lua à chaque requête (comme c'est le
cas avec le MPM event, où même les connexions persistantes utilisent un
nouveau thread pour chaque requête). Si vous pensez que vos scripts
n'auront pas de problème s'il réutilisent un état, alors les portées
thread ou server doivent être utilisées car
elles présenteront de meilleures performances. Alors que la portée
thread fournira les réponses les plus rapides, la portée
server utilisera moins de mémoire car les états sont
rassemblés dans des jeux, permettant par exemple à 1000 threads de
partager 100 états Lua, ne nécessitant ainsi que 10% de la mémoire
requise par la portée thread.
Serveur HTTP Apache Version 2.4
| Description: | Associe les extensions des fichiers demandés avec l'action déclenchée par ces fichiers et avec leur contenu (type MIME, langue, jeu de caractère et codage) |
|---|---|
| Statut: | Base |
| Identificateur de Module: | mime_module |
| Fichier Source: | mod_mime.c |
Ce module permet d'assigner des métadonnées aux contenus
sélectionnés pour une réponse HTTP, en associant des modèles d'URI
ou de noms de fichiers aux valeurs des métadonnées. Par exemple, les
extensions de noms de fichiers définissent souvent le type de médium
Internet, la langue, le jeu de caractères et le codage du contenu.
Ces informations sont relayées par les messages HTTP véhiculant ces
contenus, et utilisées au cours de la négociation de contenu lors de
la sélection des différentes possibilités, de manière à ce que les
préférences des utilisateurs soient respectées lors du choix d'un
contenu à servir parmi plusieurs autres contenus. Voir
mod_negotiation pour plus d'informations à propos
de la négociation de
contenu.
Les directives AddCharset, AddEncoding, AddLanguage et AddType permettent d'associer des
extensions de fichiers aux métadonnées de ces fichiers. Elles
définissent respectivement le jeu de caractères, le codage du
contenu, la langue du contenu et le type de
médium (content-type) des documents. La directive
TypesConfig permet de
spécifier un fichier qui contient lui-même des associations entre
extensions et types de media.
De plus, mod_mime peut définir le gestionnaire et les filtres qui sont à l'origine du contenu et
le traitent. Les directives AddHandler, AddOutputFilter, et AddInputFilter permettent de contrôler
les modules ou les scripts qui vont servir le document. La directive
MultiviewsMatch permet à
mod_negotiation de déterminer les extensions de
fichiers à inclure lors des tests de correspondances multivues.
Alors que mod_mime associe des métadonnées avec
des extensions de fichiers, le serveur de base core
fournit des directives permettant d'associer tous les fichiers d'un
conteneur donné (par exemple <Location>, <Directory>, ou <Files>) avec des métadonnées particulières.
Parmi ces directives, on trouve ForceType, SetHandler, SetInputFilter, et SetOutputFilter. Les directives du serveur
de base l'emportent sur toute directive d'association d'extensions
de noms de fichiers définie par mod_mime.
Notez que la modification des métadonnées d'un fichier ne modifie
pas la valeur de l'en-tête Last-Modified. Ainsi,
certaines copies de documents préalablement mises en cache peuvent
encore être utilisées par un client ou un mandataire avec les
anciens en-têtes. Si vous modifiez les métadonnées (langue, type de
contenu, jeu de caractère ou codage), vous devez donc enregistrer
une modification du fichier concerné (afin de mettre à jour sa date
de dernière modification), pour être sûr que tous les visiteurs
recevront le documents avec les en-têtes corrects.
AddCharset AddEncoding AddHandler AddInputFilter AddLanguage AddOutputFilter AddType DefaultLanguage ModMimeUsePathInfo MultiviewsMatch RemoveCharset RemoveEncoding RemoveHandler RemoveInputFilter RemoveLanguage RemoveOutputFilter RemoveType TypesConfigLes fichiers peuvent posséder plusieurs extensions dont l'ordre
est normalement sans importance. Par exemple, si
le fichier welcome.html.fr est associé au type de
contenu text/html et à la langue française, le fichier
welcome.fr.html possèdera exactement les même
métadonnées. Si le fichier possède plusieurs extensions associées
au même type de métadonnée, c'est celle de ces extensions la plus à
droite qui sera utilisée, excepté pour ce qui concerne les langues
et les codages de contenu. Par exemple, si .gif est
associé au type de médium
image/gif, et .html au type de médium
text/html, le fichier welcome.gif.html
sera associé au type de médium text/html.
Les Languages et les codages de contenu sont traités de
manière cumulative, car il est possible d'assigner plusieurs
langues ou codages à une ressource particulière. Par exemple, le
fichier welcome.html.en.de sera servi avec les en-têtes
Content-Language: en, de et Content-Type:
text/html.
Des précautions doivent être prises lorsqu'un fichier avec
extensions multiples est associé à la fois à un type de
médium et à un gestionnaire. En général, cela impliquera
la gestion de la requête par le module associé au gestionnaire. Par
exemple, si l'extension .imap est associée au
gestionnaire imap-file (du module
mod_imagemap), et si l'extension .html
est associée au type de médium text/html, le fichier
world.imap.html sera à la fois associé au gestionnaire
imap-file et au type de médium text/html.
Pour son traitement, c'est le gestionnaire imap-file
qui sera utilisé, et il sera donc traité en tant que fichier
imagemap.
Si vous préférez que seule la dernière partie d'un nom de fichier
séparée du reste du nom par un point soit associée à une métadonnée
particulière, n'utilisez pas les directives Add*. Par
exemple, si vous souhaitez que le fichier foo.html.cgi
soit traité en tant que script CGI, mais pas le fichier
bar.cgi.html, alors, au lieu d'utiliser
AddHandler cgi-script .cgi, utilisez plutôt :
<FilesMatch "[^.]+\.cgi$"> SetHandler cgi-script </FilesMatch>
Un fichier d'un type de médium particulier
peut être également codé d'une certaine manière pour simplifier sa
transmission sur Internet. Alors que cela concerne en général la
compression, comme gzip, il peut aussi s'agir de
chiffrement, comme pgp ou d'un codage comme UUencoding,
qui est conçu pour transmettre un fichier binaire sous un format
ASCII (texte).
La RFC HTTP/1.1, section 14.11 stipule à ce titre :
Le champ d'en-tête Content-Encoding de l'entité est utilisé en tant que modificateur du type de médium. Lorsqu'il est présent, sa valeur indique quels codages de contenu additionnels ont été appliqués au corps de l'entité, et ainsi quels mécanismes de décodage doivent être appliqués afin de retrouver le type de médium référencé par le champ d'en-tête Content-Type. Le codage de contenu est principalement utilisé pour permettre la compression d'un document sans perdre l'information concernant le type de médium sous-jacent.
En utilisant plusieurs extensions (voir la section ci-dessus à propos des extensions de fichiers multiples), vous pouvez indiquer qu'un fichier est d'un type, particulier, et possède aussi un codage particulier.
Considérons par exemple un fichier contenant un document
Microsoft Word et compressé par pkzip pour réduire sa taille. Si
l'extension .doc est associée au type de fichier
Microsoft Word, et si l'extension .zip est associée au
codage de fichier pkzip, alors le fichier
Resume.doc.zip sera identifié comme document Word
compressé par pkzip.
Apache joint un en-tête Content-encoding à la
ressource afin d'informer le navigateur client à propos de la
méthode de codage.
Content-encoding: pkzip
En plus du type de fichier et du codage, un autre élément important d'information est la langue dans laquelle le document est écrit, et avec quel jeu de caractères le contenu du fichier doit être affiché. Par exemple, un document peut être écrit en alphabet vietnamien ou cyrillique, et doit être affiché en conséquence. Cette information est également transmise via des en-têtes HTTP.
Les jeu de caractères, langue, codage et type MIME sont tous
utilisés au cours du processus de négociation de contenu (voir
mod_negotiation) afin de déterminer quel document
servir au client, lorsque plusieurs choix sont possibles en fonction
du jeu de caractères, de la langue, du codage ou du type MIME. Toutes
les associations d'extensions de noms de fichiers créées via les
directives AddCharset,
AddEncoding, AddLanguage et AddType (ainsi que les associations
d'extensions listées dans le fichier défini par la directive
MimeMagicFile),
participent à ce processus de sélection. Les extensions de noms de
fichiers qui n'ont été associés que par des directives AddHandler, AddInputFilter ou AddOutputFilter, peuvent être incluses
ou exclues du processus de sélection en utilisant la directive
MultiviewsMatch.
Pour transmettre cette information supplémentaire, Apache peut
ajouter un en-tête Content-Language, afin de
spécifier la langue dans laquelle le document est écrit, et peut
ajouter des informations additionnelles à l'en-tête
Content-Type pour indiquer le jeu de caractères
particulier qui doit être utilisé pour restituer correctement le
document.
Content-Language: en, fr
Content-Type: text/plain; charset=ISO-8859-1
La langue est spécifiée via son abréviation en deux lettres. Le
jeu de caractères est le nom du jeu de caractères
particulier qui doit être utilisé.
| Description: | Associe les extensions de noms de fichiers spécifiées au jeu de caractères spécifié |
|---|---|
| Syntaxe: | AddCharset jeu-car extension
[extension] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive AddCharset permet d'associer
les extensions de noms de fichiers spécifiées au jeu de caractères
spécifié (le nom enregistré sur l'Internet d'un codage de caractères
donné). jeu-car est le paramètre jeu
de caractères du type de médium pour les ressources dont le nom
de fichier contient extension. Cette association est
ajoutée à toutes les autres déjà en vigueur, et écrase toute
association préexistante pour la même extension.
AddLanguage ja .ja AddCharset EUC-JP .euc AddCharset ISO-2022-JP .jis AddCharset SHIFT_JIS .sjis
Avec cet exemple, le document xxxx.ja.jis sera
traité en tant que document japonais dont le jeu de caractère est
ISO-2022-JP (idem pour le document
xxxx.jis.ja). La directive
AddCharset sert à la fois à informer le
client sur le codage des caractères du document afin que ce dernier
puisse être interprété et affiché correctement, et à la négociation de contenu, au
cours de laquelle le serveur décide lequel parmi plusieurs
documents possibles il renvoie au client en fonction des préférences
de ce dernier en matière de jeu de caractères.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséder plusieurs extensions, et l'argument extension sera comparé à chacune d'entre elles.
| Description: | Associe les extensions de noms de fichiers données au type de codage spécifié |
|---|---|
| Syntaxe: | AddEncoding codage extension
[extension] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive AddEncoding permet d'associer
les extensions de noms de fichiers données au codage de contenu HTTP
spécifié. codage est le codage de contenu HTTP à ajouter
à la valeur du champ d'en-tête Content-Encoding pour les documents
possédant l'extension spécifiée. Cette association est
ajoutée à toutes les autres déjà en vigueur, et écrase toute
association préexistante pour la même extension.
AddEncoding x-gzip .gz AddEncoding x-compress .Z
Avec cet exemple, les noms de fichiers possédant l'extension
.gz seront marqués comme codés à l'aide du codage
x-gzip, et les noms de fichiers possédant l'extension
.Z comme codés avec x-compress.
Les clients anciens n'acceptent que x-gzip et
x-compress, bien que les standards stipulent qu'ils
sont respectivement équivalents à gzip et
compress. Apache effectue ses comparaisons de codages
de contenu en ignorant tout préfixe x-. Lorsqu'il
répond avec un codage, Apache utilise l'une ou l'autre forme (c'est
à dire x-foo ou foo) selon les besoins du
client. Si le client n'a pas besoin d'une forme particulière, Apache
utilisera la forme employée par la directive
AddEncoding. Pour résumer, vous devez toujours utiliser
x-gzip et x-compress pour ces deux
codages spécifiques. Certains codages plus récents, comme
deflate, doivent être spécifiés sans le préfixe
x-.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséder plusieurs extensions, et l'argument extension sera comparé à chacune d'entre elles.
| Description: | Associe les extensions de noms de fichiers données au gestionnaire spécifié |
|---|---|
| Syntaxe: | AddHandler nom-gestionnaire extension
[extension] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
Les fichiers dont le nom a pour extension extension
seront servis par le nom-gestionnaire spécifié. Cette
association est ajoutée à toutes les autres déjà en vigueur, et
écrase toute association préexistante pour la même
extension. Par exemple, pour associer les scripts CGI
avec l'extension de fichier .cgi, vous pouvez utiliser
:
AddHandler cgi-script .cgi
Une fois cette ligne insérée dans votre fichier httpd.conf, tout
fichier possédant l'extension .cgi sera traité en tant
que programme CGI.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséder plusieurs extensions, et l'argument extension sera comparé à chacune d'entre elles.
| Description: | Associe les extensions de noms de fichiers aux filtres spécifiés qui traiteront les requêtes clients |
|---|---|
| Syntaxe: | AddInputFilter filtre[;filtre...]
extension [extension] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive AddInputFilter permet
d'associer l'extension de nom de fichier extension aux filtres spécifiés qui traiteront les
requêtes clients et les entrées POST à leur réception par le
serveur. Ceci s'ajoute à toute définition de filtre préexistante, y
compris la directive SetInputFilter. Cette
association est ajoutée à toutes les autres déjà en vigueur, et
écrase toute association préexistante pour la même
extension.
Si plusieurs filtres sont spécifiés, ils doivent être séparés par des points-virgules et inscrits dans l'ordre selon lequel ils devront traiter le contenu. L'argument filtre est insensible à la casse.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséder plusieurs extensions, et l'argument extension sera comparé à chacune d'entre elles.
| Description: | Associe l'extension de nom de fichier donnée à la langue spécifié |
|---|---|
| Syntaxe: | AddLanguage symbole-langue extension
[extension] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive AddLanguage permet d'associer
l'extension de nom de fichier donnée à la langue spécifiée. Les
fichiers dont l'extension correspond à la valeur
de l'argument extension se voient attribuer la valeur de
l'argument symbole-langue comme en-tête HTTP
Content-Language en accord avec les identifiants de langues définis
par la RFC 3066. Cette directive l'emporte sur toute association
préexistante pour la même extension.
AddEncoding x-compress .Z AddLanguage en .en AddLanguage fr .fr
Avec cet exemple, le document xxxx.en.Z sera traité
en tant que document compressé de langue anglaise (idem pour le
document xxxx.Z.en). Bien que la langue soit fournie au
client, le navigateur n'utilise habituellement pas cette
information. La directive AddLanguage est
principalement utilisée au cours de la négociation de contenu, où le
serveur choisit d'envoyer un document parmi plusieurs documents
possibles en fonction de la préférence du client en matière de
langue.
Si une extension fait l'objet de plusieurs associations de langues, c'est la dernière qui sera utilisée. Ainsi, dans le cas suivant,
AddLanguage en .en AddLanguage en-gb .en AddLanguage en-us .en
les documents possédant l'extension .en seront
traités en tant que documents de langue en-us.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséder plusieurs extensions, et l'argument extension sera comparé à chacune d'entre elles.
| Description: | Associe les extensions de noms de fichiers aux filtres spécifiés qui traiteront les réponses en provenance du serveur |
|---|---|
| Syntaxe: | AddOutputFilter filtre[;filtre...]
extension [extension] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive AddOutputFilter permet
d'associer l'extension de nom de fichier définie par l'argument
extension aux filtres qui traiteront les réponses en
provenance du serveur avant de les envoyer au client. Ces filtres
s'ajoutent à tout filtre défini par d'autres directives comme
SetOutputFilter et AddOutputFilterByType. Cette association
est fusionnée avec toute autre association en vigueur, et l'emporte
sur toute association préexistante pour la même
extension.
Avec l'exemple suivant, tous les fichiers .shtml
seront traités en tant qu'inclusions côté serveur (SSI), et la
sortie sera compressée à l'aide du module
mod_deflate.
AddOutputFilter INCLUDES;DEFLATE shtml
Si plusieurs filtres sont spécifiés, ils doivent être séparés par des points-virgules et inscrits dans l'ordre selon lequel il devront traiter le contenu. L'argument filtre est insensible à la casse.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséder plusieurs extensions, et l'argument extension sera comparé à chacune d'entre elles.
Notez que toute définition de filtres via la directive AddOutputFilter remplace toutes les
définitions précédentes effectuées via cette même directive.
# Filtre spécifié "DEFLATE" AddOutputFilter DEFLATE shtml <Location "/foo"> # Filtre spécifié "INCLUDES", remplace "DEFLATE" AddOutputFilter INCLUDES shtml </Location> <Location "/bar"> # Filtre spécifié "INCLUDES;DEFLATE", remplace "DEFLATE" AddOutputFilter INCLUDES;DEFLATE shtml </Location> <Location "/bar/baz"> # Filtre spécifié "BUFFER", remplace "INCLUDES;DEFLATE" AddOutputFilter BUFFER shtml </Location> <Location "/bar/baz/buz"> # Pas de filtre spécifié, suppression de "BUFFER" RemoveOutputFilter shtml </Location>
| Description: | Associe les extensions de noms de fichiers au type de contenu spécifié |
|---|---|
| Syntaxe: | AddType type-médium extension
[extension] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive AddType permet d'associer les
extensions de noms de fichiers données au type de contenu spécifié.
type-médium est le Type
MIME à utiliser pour les fichiers dont le nom possède
l'extension extension. Cette association s'ajoute à toute
autre association en vigueur, et l'emporte sur toute association
préexistante pour la même extension.
TypesConfig, il est recommandé
d'utiliser la directive AddType pour
ajouter de nouveaux types de médias.
AddType image/gif .gif
Ou, pour spécifier plusieurs extensions dans une seule directive :
AddType image/jpeg jpeg jpg jpe
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial. Les noms de fichiers peuvent posséder plusieurs extensions, et l'argument extension sera comparé à chacune d'entre elles.
Il est possible d'obtenir un effet similaire à celui de la
directive LanguagePriority du module
mod_negotiation en qualifiant un type de
média avec qs :
AddType application/rss+xml;qs=0.8 .xml
Ceci peut s'avérer utile dans certaines situations, par exemple
lorsqu'un client qui a ajouté un en-tête Accept: */* à
sa requête n'est pas en mesure de traiter le contenu renvoyé par le
serveur.
À la base, cette directive configure le type de contenu généré pour les fichiers statiques servis à partir du système de fichiers. Dans le cas des ressources autres que les fichiers statiques pour lesquelles le générateur de la réponse spécifie en général un Content-Type, cette directive n'a aucun effet.
Si aucun gestionnaire n'est explicitement défini pour une requête, le type de contenu spécifié sera aussi utilisé comme nom du gestionnaire.
Lorsqu'aucune directive comme SetHandler ou
AddHandler ne s'applique à
une requête, le nom de gestionnaire interne normalement défini
par une de ces directives est en fait défini par le type de contenu
spécifié par la présente directive.
Pour des raisons historiques, certains modules tiers comme mod_php peuvent adopter ce type de comportement pour prendre en compte la requête concernée.
Il est conseillé d'éviter les configurations qui reposent sur de
tels types "synthétiques". En outre, les configurations qui
limitent l'accès aux directives SetHandler ou AddHandler doivent aussi limiter
l'accès à la directive AddType.
| Description: | Définit un symbole de langue par défaut à affecter au champ d'en-tête Content-Language pour toutes les ressources dans le contexte courant auxquelles aucun symbole de langue n'a été associé. |
|---|---|
| Syntaxe: | DefaultLanguage symbole-langue |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive DefaultLanguage permet
d'indiquer à Apache que toutes les ressources du contexte courant
(par exemple, toutes les ressources concernées par le conteneur
<Directory>
courant) qui ne possèdent pas d'extension de langue explicite
(comme .fr ou .de tel que défini par la
directive AddLanguage),
verront leur en-tête HTTP Content-Language affecté de la langue
symbole-langue. Ceci permet de marquer des arborescences
de répertoires entières comme contenant des documents en français,
par exemple, sans avoir à renommer chaque fichier. Notez qu'à la
différence de l'utilisation des extensions pour spécifier des
langues, DefaultLanguage ne permet de
spécifier qu'une seule langue.
Si aucune directive DefaultLanguage n'est
en vigueur, et si un fichier ne possède pas d'extension configurée
par la directive AddLanguage, aucun champ d'en-tête
Content-Language ne sera généré.
DefaultLanguage en
| Description: | Indique à mod_mime de traiter les éléments
de path_info en tant que parties du nom de
fichier |
|---|---|
| Syntaxe: | ModMimeUsePathInfo On|Off |
| Défaut: | ModMimeUsePathInfo Off |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_mime |
La directive ModMimeUsePathInfo permet de
combiner le nom de fichier avec la partie path_info de
l'URL pour appliquer les directives mod_mime à la
requête. La valeur par défaut est Off - situation dans
laquelle l'élément path_info est ignoré.
L'utilisation de cette directive est conseillée si vous utilisez un système de fichiers virtuel.
ModMimeUsePathInfo On
Considérons une requête pour /index.php/foo.shtml,
mod_mime ne traitera pas la requête entrante comme
/index.php/foo.shtml et les directives comme
AddOutputFilter INCLUDES .shtml ajouteront le filtre
INCLUDES à la requête. Si la directive
ModMimeUsePathInfo n'est pas définie, le
filtre INCLUDES ne sera pas ajouté. Le fonctionnement
sera identique dans le cas des chemins virtuels, tels que ceux
définis par la directive <Location>
| Description: | Les types de fichiers qui seront inclus lors d'une recherche de correspondance de fichier avec les vues multiples (MultiViews) |
|---|---|
| Syntaxe: | MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers
[Handlers|Filters] |
| Défaut: | MultiviewsMatch NegotiatedOnly |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive MultiviewsMatch permet trois
comportements différents pour la fonctionnalité Multiviews du module
mod_negotiation. Les vues
multiples permettent d'associer une requête pour un fichier, par
exemple index.html, à toute extension négociée
s'ajoutant à la requête de base, par exemple
index.html.en, index.html.fr, ou
index.html.gz.
L'option NegotiatedOnly implique que toute extension
s'ajoutant au nom de base doit correspondre à une extension de
mod_mime reconnue pour la négociation de contenu,
par exemple Charset, Content-Type, Language, ou Encoding. C'est la
valeur d'option par défaut, et la contrainte la plus stricte
dont les effets de bord inattendus sont les moins nombreux.
Pour inclure des extensions associées avec des gestionnaires
et/ou des filtres, définissez la directive
MultiviewsMatch avec les mots-clés
Handlers, Filters, ou les deux. Si tous
les autres facteurs sont égaux, c'est le fichier de plus petite
taille qui sera servi ; par exemple, si le choix doit s'opérer entre
index.html.cgi de 500 octets et
index.html.pl de 1000 octets, c'est le fichier
.cgi qui l'emportera dans cet exemple. Les utilisateurs
de fichiers .asis auront avantage à utiliser l'option
Handler, si les fichiers .asis sont associés au
gestionnaire asis-handler.
Vous pouvez enfin autoriser l'association de toute extension avec
l'option Any, même si mod_mime ne
reconnaît pas l'extension. Ceci
peut conduire à des résultats imprévisibles, comme l'envoi de
fichiers .old ou .bak contrairement aux souhaits du webmaster.
Par exemple, la configuration suivante va permettre l'inclusion des extensions associées aux gestionnaires et aux filtres dans les vues multiples, tout en excluant les fichiers de type inconnu :
MultiviewsMatch Handlers Filters
L'utilisation de la directive
MultiviewsMatch dans une section <Location> ou <LocationMatch> n'est pas
permise.
| Description: | Supprime toute association de jeu de caractères pour un ensemble d'extensions de noms de fichiers |
|---|---|
| Syntaxe: | RemoveCharset extension [extension]
... |
| Contexte: | serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive RemoveCharset permet de
supprimer toute association de jeu de caractères pour les fichiers
dont les noms possèdent les extensions spécifiées. Ceci permet, au
sein des fichiers .htaccess, d'annuler toute
association héritée du répertoire parent ou de la configuration du
serveur pour un répertoire particulier.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial.
RemoveCharset .html .shtml
| Description: | Supprime toute association de codage de contenu pour un ensemble d'extensions de noms de fichiers |
|---|---|
| Syntaxe: | RemoveEncoding extension [extension]
... |
| Contexte: | serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive RemoveEncoding permet de
supprimer toute association de codage pour les fichiers dont les
noms possèdent les extensions spécifiées. Ceci permet, au
sein des fichiers .htaccess, d'annuler toute
association héritée du répertoire parent ou de la configuration du
serveur pour un répertoire particulier. Voici un exemple
d'utilisation de cette directive :
AddEncoding x-gzip .gz
AddType text/plain .asc
<Files "*.gz.asc">
RemoveEncoding .gz
</Files>
Avec cette configuration, le fichier foo.gz sera
marqué comme codé avec gzip, mais foo.gz.asc sera
marqué comme fichier texte non codé.
Les directives RemoveEncoding étant
traitées après toute directive AddEncoding, il est possible
qu'elles annulent les effets de ces dernières si les deux
apparaissent dans la configuration du même répertoire.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial.
| Description: | Supprime toute association de gestionnaire à un ensemble d'extensions de noms de fichiers |
|---|---|
| Syntaxe: | RemoveHandler extension [extension]
... |
| Contexte: | serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive RemoveHandler permet de
supprimer toute association de gestionnaire à des fichiers dont le
nom possède l'extension donnée. Ceci permet, au
sein des fichiers .htaccess, d'annuler toute
association héritée du répertoire parent ou de la configuration du
serveur pour un répertoire particulier. Voici un exemple
d'utilisation de cette directive :
AddHandler server-parsed .html
RemoveHandler .html
Avec cette dernière ligne, les fichiers .html du
répertoire /foo/bar seront traités en tant que fichiers
normaux, au lieu d'être traités en tant que candidats à
l'interprétation (voir le module mod_include
module).
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial.
| Description: | Supprime toute association de filtre en entrée à un ensemble d'extensions de noms de fichiers |
|---|---|
| Syntaxe: | RemoveInputFilter extension [extension]
... |
| Contexte: | serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive RemoveInputFilter permet de
supprimer toute association de filtre
en entrée à des fichiers dont le nom possède l'extension donnée.
Ceci permet, au
sein des fichiers .htaccess, d'annuler toute
association héritée du répertoire parent ou de la configuration du
serveur pour un répertoire particulier.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial.
| Description: | Supprime toute association de langue à un ensemble d'extensions de noms de fichiers |
|---|---|
| Syntaxe: | RemoveLanguage extension [extension]
... |
| Contexte: | serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive RemoveLanguage permet de
supprimer toute association de langue à des fichiers dont le nom
possède l'extension donnée. Ceci permet, au
sein des fichiers .htaccess, d'annuler toute
association héritée du répertoire parent ou de la configuration du
serveur pour un répertoire particulier.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial.
| Description: | Supprime toute association de filtre en sortie à un ensemble d'extensions de noms de fichiers |
|---|---|
| Syntaxe: | RemoveOutputFilter extension [extension]
... |
| Contexte: | serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive RemoveOutputFilter permet de
supprimer toute association de filtre
en sortie à des fichiers dont le nom possède l'extension donnée. Ceci permet, au
sein des fichiers .htaccess, d'annuler toute
association héritée du répertoire parent ou de la configuration du
serveur pour un répertoire particulier.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial.
RemoveOutputFilter shtml
| Description: | Supprime toute association de type de contenu à un ensemble d'extensions de noms de fichiers |
|---|---|
| Syntaxe: | RemoveType extension [extension]
... |
| Contexte: | serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_mime |
La directive RemoveType permet de
supprimer toute association de type de
médium à des fichiers dont le nom possède l'extension
donnée. Ceci permet, au
sein des fichiers .htaccess, d'annuler toute
association héritée du répertoire parent ou de la configuration du
serveur pour un répertoire particulier. Voici un exemple
d'utilisation de cette directive :
RemoveType .cgi
Cette ligne aura pour effet de supprimer tout traitement
spécifique des fichiers .cgi dans le répertoire
/foo/ et ses sous-répertoires, et les réponses
contenant ce type de fichier ne possèderont pas de champ d'en-tête
HTTP Content-Type.
Les directives RemoveType sont traitées
après toutes les directives AddType, et il est possible que les
effets de ces dernières soient annulés si les deux types de
directives sont présents au sein de la configuration du même
répertoire.
L'argument extension est insensible à la casse et peut être spécifié avec ou sans le point initial.
| Description: | Le chemin du fichier mime.types |
|---|---|
| Syntaxe: | TypesConfig chemin-fichier |
| Défaut: | TypesConfig conf/mime.types |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_mime |
La directive TypesConfig permet de définir
le chemin du fichier de configuration des types de média. L'argument
chemin-fichier est un chemin relatif au répertoire défini
par la directive ServerRoot. Ce
fichier contient la liste des associations par défaut des extensions
de noms de fichiers aux types de contenus. La plupart des
administrateurs utilisent le fichier mime.types fourni
par leur système d'exploitation,
qui associe les extensions de noms de fichiers courantes à la liste
officielle des types de média enregistrés par l'IANA et maintenue à
http://www.iana.org/assignments/media-types/index.html, ainsi
qu'un grand nombre de types non officiels. Ce fichier permet de
simplifier le fichier httpd.conf en fournissant la
majorité des définitions de types de média, et ses définitions
peuvent être écrasées par des directives AddType, selon les besoins. Il est
déconseillé de modifier le contenu du fichier
mime.types car il peut être remplacé lors d'une mise à
jour du serveur.
Le fichier contient des lignes dont le format est identique à
celui des arguments d'une directive AddType :
type-médium [extension] ...
Les extensions sont insensibles à la casse. Les lignes vides et
les lignes commençant par un dièse (#) sont
ignorées. Les lignes vides servent à compléter le fichier
mime.types. Apache httpd peut encore déterminer ces types via le
module mod_mime_magic.
mime.types fourni, sauf si :
1) le type de médium est déjà enregistré à l'IANA
2) et si l'extension est largement acceptée et ne provoque pas de
conflits d'extensions entre les différentes plate-formes. Les
requêtes du type catégorie/x-sous-type seront
systématiquement rejetées, ainsi que toute nouvelle extension de
deux lettres, car elle ont de fortes chances d'entrer en conflit
par la suite avec les inombrables langues préexistantes et les
espaces de nommage des jeux de caractères.
Serveur HTTP Apache Version 2.4
| Description: | Active le chiffrement SSL pour Netware |
|---|---|
| Statut: | Base |
| Identificateur de Module: | nwssl_module |
| Fichier Source: | mod_nw_ssl.c |
| Compatibilité: | NetWare seulement |
Ce module active le chiffrement SSL sur un port spécifique. Il s'appuie sur la fonctionnalité de chiffrement SSL intégrée au système d'exploitation Netware.
| Description: | Liste de certificats clients supplémentaires |
|---|---|
| Syntaxe: | NWSSLTrustedCerts nom-fichier
[nom-fichier] ... |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_nw_ssl |
Cette directive permet de spécifier une liste de fichiers (au
format DER) contenant des certificats clients utilisés lors de
l'établissement d'une connexion SSL mandatée. Chaque certificat
client utilisé par un serveur doit être enregistré séparément dans
son propre fichier .der.
| Description: | Permet de promouvoir une connexion non SSL au statut de connexion SSL à la demande |
|---|---|
| Syntaxe: | NWSSLUpgradeable [adresse-IP:]num-port |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_nw_ssl |
Cette directive permet de promouvoir une connexion établie sur
l'adresse IP et/ou le port spécifiés au statut de connexion SSL à la
demande du client. L'adresse et/ou le port doivent avoir été définis
au préalable par une directive Listen.
| Description: | Active le chiffrement SSL pour le port spécifié |
|---|---|
| Syntaxe: | SecureListen [adresse-IP:]num-port
nom-certificat [MUTUAL] |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_nw_ssl |
Cette directive permet de spécifier le port et le nom de certificat de style eDirectory qui seront utilisés pour activer le chiffrement SSL. En outre, un troisième paramètre optionnel permet d'activer l'authentification mutuelle.
Serveur HTTP Apache Version 2.4
| Description: | Module de support AJP pour
mod_proxy |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_ajp_module |
| Fichier Source: | mod_proxy_ajp.c |
| Compatibilité: | Disponible à partir de la version 2.1 du serveur HTTP Apache |
Ce module nécessite le chargement de mod_proxy. Il fournit le support du Protocole Apache
JServ version 1.3 (nommé dans la suite de ce document
AJP13).
Pour être en mesure d'exploiter le protocole AJP13,
il est donc nécessaire de charger les modules
mod_proxy et mod_proxy_ajp.
N'activez pas la fonctionnalité de mandataire avant d'avoir sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux non seulement pour votre réseau, mais aussi pour l'Internet au sens large.
Utilisation Variables d'environnement Vue d'ensemble du protocole Structure de base des paquets Structure des paquets de
requête Structure du paquet de la
réponseCe module ne fournit aucune directive.
Ce module permet de mandater en inverse un serveur d'application
d'arrière-plan (comme Apache Tomcat) qui utilise le protocole AJP13.
Son utilisation est similaire à celle d'un mandataire inverse HTTP,
mais s'appuie sur le prefixe ajp:// :
ProxyPass "/app" "ajp://backend.example.com:8009/app"
Les options telles que l'option secret de Tomcat (requise
par défaut depuis Tomcat 8.5.51 et 9.0.31) peut tout simplement être ajoutée
en tant que paramètre séparé à la fin des directives ProxyPass ou BalancerMember. Ce paramètre est disponible à
partir de la version 2.4.42 du serveur HTTP Apache :
secretProxyPass "/app" "ajp://backend.example.com:8009/app" secret=YOUR_AJP_SECRET
On peut aussi configurer un répartiteur de charge :
<Proxy "balancer://cluster">
BalancerMember "ajp://app1.example.com:8009" loadfactor=1
BalancerMember "ajp://app2.example.com:8009" loadfactor=2
ProxySet lbmethod=bytraffic
</Proxy>
ProxyPass "/app" "balancer://cluster/app"
Notez qu'en général, la directive ProxyPassReverse n'est pas
nécessaire. La requête AJP inclut l'en-tête host original fourni
au mandataire, et le serveur d'application est sensé générer des
en-têtes auto-référençants relatifs à cet hôte ; aucune réécriture
n'est donc nécessaire.
La situation la plus courante dans laquelle la directive ProxyPassReverse est nécessaire se
rencontre lorsque le chemin de l'URL au niveau du mandataire est
différente de celle du serveur d'arrière-plan. Dans ce cas, un
en-tête redirect peut être réécrit relativement à l'URL de l'hôte
original (et non du serveur d'arrière-plan ajp:// URL)
; par exemple :
ProxyPass "/apps/foo" "ajp://backend.example.com:8009/foo" ProxyPassReverse "/apps/foo" "http://www.example.com/foo"
Il est cependant préférable en général de déployer l'application sur le serveur d'arrière-plan avec le même chemin que sur le mandataire.
Les variables d'environnement dont le nom possède le préfixe
AJP_ sont transmises au serveur original en tant
qu'attributs de requête AJP (le préfixe AJP_ étant supprimé du
nom de la clé).
Le protocole AJP13 est orienté paquet. Le format
binaire a été préféré, probablement pour des raisons de
performances, au format texte pourtant plus lisible. Le serveur web
communique avec le conteneur de servlets sur une connexion TCP. Pour
diminuer la charge induite par le processus de création de socket,
le serveur web va tenter d'utiliser des connexions TCP persistantes
avec le conteneur de servlets, et de réutiliser les connexions
pendant plusieurs cycles requêtes/réponse.
Lorsqu'une connexion a été assignée à une requête particulière, elle ne sera utilisée pour aucune autre jusqu'à ce que le cycle de traitement de la requête se soit terminé. En d'autres termes, il n'y a pas de multiplexage des requêtes sur une connexion. Ceci se traduit par un code beaucoup plus simple à chaque extrémité de la connexion, un nombre plus important de connexions étant cependant ouvertes en même temps.
Lorsque le serveur web a ouvert une connexion vers le conteneur de servlets, celle-ci peut se trouver dans l'un des états suivants :
Lorsqu'une connexion est assignée au traitement d'une requête
particulière, les informations de base de cette dernière (comme les
en-têtes HTTP, etc...) sont envoyées sur la connexion sous une forme
très condensée (par exemple les chaînes courantes sont codées sous
forme d'entiers). Vous trouverez des détails sur ce format plus
loin dans la structure des paquets de requête. Si la requête possède
un corps (content-length > 0), il est envoyé dans un
paquet séparé immédiatement après.
A ce moment, le conteneur est probablement prêt à traiter la requête. Au cours de ce traitement, il peut renvoyer les messages suivants au serveur web :
Chaque message est associé à un paquet de données formaté différemment. Voir plus loin les structures des paquets de réponses pour plus de détails.
Ce protocole hérite en partie de XDR, mais il diffère sur de nombreux points (pas d'alignement sur 4 bits, par exemple).
AJP13 utilise les octets selon leur ordre d'arrivée par le réseau pour tous les types de données.
Le protocole comporte quatre types de données : octets, booléens, entiers et chaînes de caractères.
1 = vrai, 0 = faux.
L'utilisation d'autres valeurs non nulles (dans le style C) peut
fonctionner dans certains cas, mais pas dans certains autres..0 et 2^16 (32768), stocké
sur 2 octets en débutant par l'octet de poids forts.strlen. Cela peut
prêter à confusion du point de vue de Java qui est surchargé de
déclarations d'autoincrémentation étranges destinées à traiter
ces terminateurs. Je suppose que le but dans lequel cela a
été conçu ainsi était de permettre au code C d'être plus efficace
lors de la lecture de chaînes en provenance du conteneur de
servlets -- avec le caractère \0 final, le code C peut transmettre
des références dans un seul tampon, sans avoir à effectuer de
copie. En l'absence du caractère \0 final, le code C doit
effectuer une copie afin de pouvoir tenir compte de sa notion de
chaîne.Selon la majorité du code, la taille maximale du paquet est de
8 * 1024 bytes (8K). La taille réelle du paquet est
encodée dans l'en-tête.
Les paquets envoyés par le serveur vers le conteneur commencent
par 0x1234. Les paquets envoyés par le conteneur vers
le serveur commencent par AB (c'est à dire le code
ASCII de A suivi du code ASCII de B). Ensuite, vient un entier (codé
comme ci-dessus) représentant la longueur des données transmises.
Bien que ceci puisse faire croire que la taille maximale des données
est de 2^16, le code définit en fait ce maximum à 8K.
| Format du paquet (Serveur->Conteneur) | |||||
|---|---|---|---|---|---|
| Octet | 0 | 1 | 2 | 3 | 4...(n+3) |
| Contenu | 0x12 | 0x34 | Taille des données (n) | Data | |
| Format du paquet (Conteneur->Serveur) | |||||
|---|---|---|---|---|---|
| Octet | 0 | 1 | 2 | 3 | 4...(n+3) |
| Contenu | A | B | Taille des données (n) | Data | |
Pour la plupart des paquets, le premier octet de la charge utile
encode le type de message, à l'exception des paquets contenant un
corps de requête envoyés du serveur vers le conteneur -- ils
comportent un en-tête standard (0x1234 suivi de la taille
du paquet), mais celui-ci n'est suivi d'aucun préfixe.
Le serveur web peut envoyer les messages suivants au conteneur de servlets :
| Code | Type de paquet | Signification |
| 2 | Fait suivre la requête | Débute le cycle de traitement de la requête avec les données qui suivent. |
| 7 | Arrêt | Le serveur web demande au conteneur de s'arrêter. |
| 8 | Ping | Le serveur web demande au conteneur de prendre le contrôle (phase de connexion sécurisée). |
| 10 | CPing | Le serveur web demande au conteneur de répondre rapidement avec un CPong. |
| none | Données | Taille (2 octets) et les données correspondantes. |
À des fins de sécurité, le conteneur n'effectuera réellement son
Arrêt que si la demande provient de la machine par
laquelle il est hébergé.
Le premier paquet Données est envoyé immédiatement
après le paquet Faire suivre la requête par le serveur
web.
Le conteneur de servlets peut envoyer les types de messages suivants au serveur web :
| Code | Type de paquet | Signification |
| 3 | Envoi d'un tronçon de corps | Envoi d'un tronçon de corps depuis le conteneur de servlets vers le serveur web (et probablement vers le navigateur). |
| 4 | Envoie les en-têtes | Envoi des en-têtes de réponse depuis le conteneur de servlets vers le serveur web (et probablement vers le navigateur). |
| 5 | Fin de la réponse | Marque la fin de la réponse (et par conséquent du cycle de traitement de la requête). |
| 6 | Réception du tronçon de corps suivant | Réception de la suite des données de la requête si elles n'ont pas encore été entièrement transmises. |
| 9 | Réponse CPong | La réponse à une requête CPing |
Chacun des messages ci-dessus possède une structure interne différente dont vous trouverez les détails ci-dessous.
Pour les messages de type Faire suivre la requête depuis le serveur vers le conteneur :
AJP13_FORWARD_REQUEST :=
prefix_code (byte) 0x02 = JK_AJP13_FORWARD_REQUEST
method (byte)
protocol (string)
req_uri (string)
remote_addr (string)
remote_host (string)
server_name (string)
server_port (integer)
is_ssl (boolean)
num_headers (integer)
request_headers *(req_header_name req_header_value)
attributes *(attribut_name attribute_value)
request_terminator (byte) OxFFLes request_headers possèdent la structure suivante
:
req_header_name :=
sc_req_header_name | (string) [voir ci-dessous pour la manière dont
ceci est interprété]
sc_req_header_name := 0xA0xx (integer)
req_header_value := (string)Les attributes sont optionnels et possèdent la
structure suivante :
attribute_name := sc_a_name | (sc_a_req_attribute string) attribute_value := (string)
Un des en-têtes les plus importants est
content-length, car il indique si le conteneur doit ou
non attendre un autre paquet immédiatement.
Pour toutes les requêtes, ce préfixe est 2. Voir ci-dessus pour les détails des autres codes de préfixes.
La méthode HTTP, encodée sous la forme d'un seul octet :
| Nom commande | Code |
| OPTIONS | 1 |
| GET | 2 |
| HEAD | 3 |
| POST | 4 |
| PUT | 5 |
| DELETE | 6 |
| TRACE | 7 |
| PROPFIND | 8 |
| PROPPATCH | 9 |
| MKCOL | 10 |
| COPY | 11 |
| MOVE | 12 |
| LOCK | 13 |
| UNLOCK | 14 |
| ACL | 15 |
| REPORT | 16 |
| VERSION-CONTROL | 17 |
| CHECKIN | 18 |
| CHECKOUT | 19 |
| UNCHECKOUT | 20 |
| SEARCH | 21 |
| MKWORKSPACE | 22 |
| UPDATE | 23 |
| LABEL | 24 |
| MERGE | 25 |
| BASELINE_CONTROL | 26 |
| MKACTIVITY | 27 |
Les versions futures d'ajp13 pourront transmettre des méthodes supplémentaires, même si elles ne font pas partie de cette liste.
Les significations de ces éléments sont triviales. Ils sont tous obligatoires et seront envoyés avec chaque requête.
La structure de request_headers est la suivante
: tout d'abord, le nombre d'en-têtes num_headers est
encodé, suivi d'une liste de paires nom d'en-tête
req_header_name / valeur req_header_value.
Les noms d'en-têtes courants sont codés sous forme d'entiers afin de
gagner de la place. Si le nom d'en-tête ne fait partie de la liste
des en-têtes courants, il est encodé normalement (une chaîne de
caractères préfixée par la taille). La liste des en-têtes courants
sc_req_header_name avec leurs codes se présente comme
suit (il sont tous sensibles à la casse) :
| Nom | Valeur du code | Nom du code |
| accept | 0xA001 | SC_REQ_ACCEPT |
| accept-charset | 0xA002 | SC_REQ_ACCEPT_CHARSET |
| accept-encoding | 0xA003 | SC_REQ_ACCEPT_ENCODING |
| accept-language | 0xA004 | SC_REQ_ACCEPT_LANGUAGE |
| authorization | 0xA005 | SC_REQ_AUTHORIZATION |
| connection | 0xA006 | SC_REQ_CONNECTION |
| content-type | 0xA007 | SC_REQ_CONTENT_TYPE |
| content-length | 0xA008 | SC_REQ_CONTENT_LENGTH |
| cookie | 0xA009 | SC_REQ_COOKIE |
| cookie2 | 0xA00A | SC_REQ_COOKIE2 |
| host | 0xA00B | SC_REQ_HOST |
| pragma | 0xA00C | SC_REQ_PRAGMA |
| referer | 0xA00D | SC_REQ_REFERER |
| user-agent | 0xA00E | SC_REQ_USER_AGENT |
Le code Java qui lit ceci extrait l'entier représenté par les
deux premiers octets, et si le premier octet est
'0xA0', il utilise l'entier représenté par le deuxième
octet comme index d'un tableau de noms d'en-têtes. Si le premier
octet n'est pas 0xA0, l'entier représenté par les deux
octets est considéré comme la longueur d'une chaîne qui est alors
lue.
Ceci ne peut fonctionner que si aucun nom d'en-tête ne possède
une taille supérieure à 0x9FFF (==0xA000 - 1), ce qui
est vraisemblable, bien qu'un peu arbitraire.
content-length est extrêmement important.
S'il est présent et non nul, le conteneur considère que la requête
possède un corps (une requête POST, par exemple), et lit
immédiatement le paquet suivant dans le flux d'entrée pour extraire
ce corps.
Les attributs préfixés par ? (par exemple
?context) sont tous optionnels. Chacun d'eux est
représenté par un octet correspondant au type de l'attribut et par
sa valeur (chaîne ou entier). Ils peuvent être envoyés dans un ordre
quelconque (bien que le code C les envoie dans l'ordre ci-dessous).
Un code de terminaison spécial est envoyé pour signaler la fin de la
liste des attributs optionnels. La liste des codes est la suivante
:
| Information | Valeur code | Type de valeur | Note |
| ?context | 0x01 | - | Non implémenté actuellement |
| ?servlet_path | 0x02 | - | Non implémenté actuellement |
| ?remote_user | 0x03 | String | |
| ?auth_type | 0x04 | String | |
| ?query_string | 0x05 | String | |
| ?jvm_route | 0x06 | String | |
| ?ssl_cert | 0x07 | String | |
| ?ssl_cipher | 0x08 | String | |
| ?ssl_session | 0x09 | String | |
| ?req_attribute | 0x0A | String | Nom (le nom de l'attribut vient ensuite) |
| ?ssl_key_size | 0x0B | Integer | |
| ?secret | 0x0C | String | Supporté depuis la version 2.4.42 |
| are_done | 0xFF | - | request_terminator |
context et servlet_path ne sont pas
définis actuellement par le code C, et la majorité du code Java
ignore complètement ce qui est envoyé par l'intermédiaire de ces
champs (il va même parfois s'interrompre si une chaîne est
envoyée après un de ces codes). Je ne sais pas si c'est une bogue ou
une fonctionnalité non implémentée, ou tout simplement du code
obsolète, mais en tout cas, il n'est pris en charge par aucune des
deux extrémités de la connexion.
remote_user et auth_type concernent
probablement l'authentification au niveau HTTP, et contiennent le
nom de l'utilisateur distant ainsi que le type d'authentification
utilisée pour établir son identité (à savoir Basic, Digest).
query_string, ssl_cert,
ssl_cipher, ssl_session et
ssl_key_size contiennent les
éléments HTTP et HTTPS correspondants.
jvm_route est utilisé dans le cadre des sessions
persistantes, en associant une session utilisateur à une instance
Tomcat particulière en présence de plusieurs répartiteurs de
charge.
Le mot de passe est envoyé lorsque la directive ProxyPass ou BalancerMember utilise le paramètre
secret=secret_keyword. Le serveur d'arrière-plan doit savoir
utiliser les mots de passe et les valeurs doivent correspondre.
request.secret ou requiredSecret sont documentés
dans la configuration AJP d'Apache Tomcat.
Au delà de cette liste de base, tout autre attribut
supplémentaire peut être envoyé via le code
req_attribute 0x0A. Une paire de chaînes
représentant le nom et la valeur de l'attribut est envoyée
immédiatement après chaque instance de ce code. Les variables
d'environnement sont transmises par cette méthode.
Enfin, lorsque tous les attributs ont été transmis, le
terminateur d'attributs, 0xFF, est envoyé. Ce dernier
indique à la fois la fin de la liste d'attributs et la fin du paquet
de la requête
Pour les messages que le conteneur peut renvoyer au serveur.
AJP13_SEND_BODY_CHUNK :=
prefix_code 3
chunk_length (integer)
chunk *(byte)
chunk_terminator (byte) Ox00
AJP13_SEND_HEADERS :=
prefix_code 4
http_status_code (integer)
http_status_msg (string)
num_headers (integer)
response_headers *(res_header_name header_value)
res_header_name :=
sc_res_header_name | (string) [voir ci-dessous pour la manière
dont ceci est interprété]
sc_res_header_name := 0xA0 (byte)
header_value := (string)
AJP13_END_RESPONSE :=
prefix_code 5
reuse (boolean)
AJP13_GET_BODY_CHUNK :=
prefix_code 6
requested_length (integer)Le tronçon se compose essentiellement de données binaires et est renvoyé directement au navigateur.
Les code et message d'état correspondent aux code et message HTTP
habituels (par exemple 200 et OK). Les
noms d'en-têtes de réponses sont codés de la même façon que les noms
d'en-têtes de requêtes. Voir ci-dessus le codage des en-têtes pour
plus de détails à propos de la manière dont les codes se distinguent
des chaînes.
Les codes des en-têtes courants sont ::
| Nom | Valeur code |
| Content-Type | 0xA001 |
| Content-Language | 0xA002 |
| Content-Length | 0xA003 |
| Date | 0xA004 |
| Last-Modified | 0xA005 |
| Location | 0xA006 |
| Set-Cookie | 0xA007 |
| Set-Cookie2 | 0xA008 |
| Servlet-Engine | 0xA009 |
| Status | 0xA00A |
| WWW-Authenticate | 0xA00B |
La valeur de l'en-tête est codée immédiatement après le code ou la chaîne du nom d'en-tête.
Signale la fin de ce cycle de traitement de requête. Si le
drapeau reuse est à true (toute valeur autre que
0 en langage C pur), cette
connexion TCP peut être réutilisée pour traiter de nouvelles
requêtes entrantes. Si reuse est à false
(==0), la connexion sera fermée.
Le conteneur réclame la suite des données de la requête (dans le
cas où la taille du corps était trop importante pour pouvoir être
contenue dans le premier paquet envoyé, où lorsque la requête est
fractionnée). Le serveur va alors envoyer un paquet contenant une
quantité de données correspondant au minimum de la
request_length, la taille maximale de corps envoyée
(8186 (8 Koctets - 6)), et le nombre réel d'octets
restants à envoyer pour ce corps de requête.
S'il ne reste plus de données à transmettre pour ce corps de requête
(c'est à dire si le conteneur de servlets tente de lire au delà de
la fin du corps), le serveur va renvoyer un paquet vide
dont la charge utile est de longueur 0 et se présentant sous la
forme (0x12,0x34,0x00,0x00).
Serveur HTTP Apache Version 2.4
| Description: | Extension à mod_proxy pour le mandatement
dynamique inverse de masse |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_express_module |
| Fichier Source: | mod_proxy_express.c |
| Compatibilité: | Disponible à partir de la version 2.3.13 du serveur HTTP Apache |
Ce module crée dynamiquement en masse des mandataires inverses en
faisant correspondre l'en-tête Host: de la requête HTTP à un nom de
serveur et une URL d'arrière-plan stockés dans un fichier DBM. Il
est ainsi plus aisé d'utiliser un grand nombre de
mandataires inverses sans avoir à modifier la configuration. Il est
loin de posséder autant de fonctionnalités que
mod_proxy_balancer qui propose aussi la croissance
dynamique, mais il est conçu pour gérer un nombre beaucoup plus important
de serveurs d'arrière-plan. Il convient parfaitement pour créer un
commutateur HTTP frontal et pour les architectures Microservices.
Pour pouvoir être utilisé, ce module nécessite le chargement de
mod_proxy.
N'activez le mandatement que si vous avez sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux pour votre réseau, et dans une plus large mesure pour Internet.
mod_proxy_balancer. Par contre, il peut constituer une
alternative légère et rapide à mod_rewrite lorsque ce
dernier utilise la directive RewriteMap et le drapeau [P]
pour le mandatement inverse à partir d'une table de correspondances.
<VirtualHost *:80> ServerName front.end.server ProxyPass "/" "back.end.server:port" ProxyPassReverse "/" "back.end.server:port" </VirtualHost>En d'autres termes, l'URL dans son ensemble est ajoutée à l'URL d'arrière-plan correspondante, tout ceci dans le but de proposer un commutateur mandataire inverse simple mais rapide.
| Description: | Chemin du fichier DBM. |
|---|---|
| Syntaxe: | ProxyExpressDBMFile pathname |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy_express |
La directive ProxyExpressDBMFile permet de
définir le chemin du fichier DBM de correspondance Express. Ce fichier
permet de faire correspondre le nom de serveur extrait de l'en-tête
Host: de la requête entrante avec une URL d'arrière-plan.
Ce fichier est élaboré à partir d'un fichier texte à l'aide de
l'utilitaire httxt2dbm.
##
##express-map.txt:
##
www1.example.com http://192.168.211.2:8080
www2.example.com http://192.168.211.12:8088
www3.example.com http://192.168.212.10
httxt2dbm -i express-map.txt -o emap
ProxyExpressEnable on ProxyExpressDBMFile emap
| Description: | Type de fichier DBM. |
|---|---|
| Syntaxe: | ProxyExpressDBMType type |
| Défaut: | ProxyExpressDBMType default |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy_express |
La directive ProxyExpressDBMType permet de
définir le type de fichier DBM requis par le module. La valeur par
défaut correspond au type DBM par défaut du fichier créé par
l'utilitaire httxt2dbm.
Les valeurs possibles sont (mais toutes ne seront pas disponibles à l'exécution) :
| Value | Description |
|---|---|
db | Fichiers Berkeley DB |
gdbm | Fichiers GDBM |
ndbm | Fichiers NDBM |
sdbm | Fichiers SDBM (toujours disponible) |
default | type DBM par défaut |
| Description: | Active la fonctionnalité du module. |
|---|---|
| Syntaxe: | ProxyExpressEnable on|off |
| Défaut: | ProxyExpressEnable off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy_express |
La directive ProxyExpressEnable permet
d'activer/désactiver le module.
Serveur HTTP Apache Version 2.4
| Description: | Module fournissant le support FTP à
mod_proxy |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_ftp_module |
| Fichier Source: | mod_proxy_ftp.c |
Pour pouvoir fonctionner, ce module requiert le
chargement de mod_proxy. Il fournit le support du
mandatement des sites FTP. Notez que le support FTP est
actuellement limité à la méthode GET.
Ainsi, pour pouvoir traiter les requêtes FTP mandatées,
mod_proxy, et mod_proxy_ftp
doivent être chargés dans le serveur.
N'activez pas la fonctionnalité de mandataire avant d'avoir sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux non seulement pour votre réseau, mais aussi pour l'Internet au sens large.
Pourquoi les fichiers du type
xxx ne sont-ils pas téléchargeables par FTP ? Comment puis-je forcer le téléchargement
FTP en mode ASCII du fichier xxx ? Comment puis-je effectuer un
chargement FTP ? Comment puis-je accéder par FTP à
des fichiers situés en dehors de mon répertoire home ? Comment puis-je dissimuler le mot de
passe FTP apparaissant en clair dans la ligne d'URL de mon
navigateur ? Pourquoi reçois-je un listing de
fichiers alors que j'ai demandé le téléchargement d'un fichier
?Ce type particulier de fichier n'est probablement pas défini en
temps que application/octet-stream dans le fichier
de configuration mime.types de votre mandataire. La ligne suivante
peut y remédier :
application/octet-stream bin dms lha lzh exe class tgz taz
Vous pouvez aussi utiliser la directive ForceType pour définir par défaut tous les types
de fichiers en tant que fichiers binaires :
ForceType application/octet-stream
Dans les rares siruations où vous devez télécharger un fichier
spécifique en utilisant la méthode de transfert FTP
ASCII (alors que le mode transfert par défaut est
binary), vous pouvez modifier le mode de transfert de
mod_proxy en suffixant la requête avec
;type=a pour forcer un transfert en mode ASCII (les
listings de répertoires FTP sont cependant quant à eux transmis en
mode ASCII).
Actuellement, seule la méthode GET est supportée pour FTP dans
mod_proxy. Vous pouvez par contre utiliser le chargement HTTP (POST
or PUT) via un mandataire Apache.
Un URI FTP est considéré comme relatif au répertoire home de
l'utilisateur connecté. Hélas, vous ne pouvez pas utiliser /../
pour atteindre des répertoires de niveau supérieur, car les points
sont interprétés par le navigateur et ne sont donc pas vraiment
envoyés au serveur FTP. Pour traiter ce problème, une méthode
nommée Squid %2f hack a été implémentée dans le
mandataire FTP Apache ; cette solution est aussi utilisée par
d'autres serveurs mandataires courants comme le Cache mandataire Squid. En
préfixant par /%2f le chemin de votre requête, vous
pouvez faire en sorte que le mandataire modifie le répertoire FTP
racine en / (au lieu du répertoire home). Par
exemple, pour extraire le fichier /etc/motd, vous
pourriez utiliser l'URL :
ftp://utilisateur@serveur/%2f/etc/motd
Apache utilise différentes stratégies pour effectuer une connexion à un serveur FTP à l'aide d'un nom d'utilisateur et d'un mot de passe. En l'absence de nom d'utilisateur et de mot de passe dans l'URL, Apache tente une connexion anonyme auprès du serveur FTP comme suit :
utilisateur : anonymous
mot de passe : apache-proxy@
Ceci fonctionne avec tous les serveurs FTP courants configurés pour accepter les connexions anonymes.
Pour une connexion personnalisée avec un nom d'utilisateur spécifique, vous pouvez intégrer ce dernier dans l'URL comme suit :
ftp://nom-utilisateur@serveur/mon-fichier
Si le serveur FTP demande un mot de passe pour ce nom
d'utilisateur (ce qu'il est censé faire), Apache va renvoyer au
client une réponse 401 (Autorisation requise), ce qui
fera afficher au navigateur une boîte de dialogue utilisateur/mot
de passe. Une fois le mot de passe saisi, la connexion est tentée
à nouveau, et si elle réussit, la ressource demandée est
présentée. L'avantage de cette procédure réside dans le fait que
votre navigateur n'affiche pas le mot de passe en clair, ce qu'il
aurait fait si vous aviez utilisé l'URL :
ftp://nom-utilisateur:mot-de-passe@serveur/mon-fichier
Le mot de passe transmis de cette manière n'est pas chiffré lorsqu'il est envoyé. Il transite entre votre navigateur et le serveur mandataire Apache sous la forme d'une chaîne de texte en clair codée en base64, et entre le mandataire Apache et le serveur FTP en texte pur. Vous devez par conséquent réfléchir à deux fois avant d'accéder à votre serveur FTP via HTTP (et d'une manière générale avant d'accéder à vos fichiers personnels via FTP !) sur des canaux non sécurisés, car des oreilles indiscrètes pourraient intercepter votre mot de passe au cours de son transfert.
Apache examine l'URL de la requête afin de permettre la navigation dans les répertoires d'un serveur FTP ainsi que le téléchargement de fichiers. Si elle ressemble à un répertoire, ou contient des caractères génériques ("*?[{~"), alors Apache considère que c'est un listing qui est demandé, et non un téléchargement.
Vous pouvez désactiver le traitement spécial des noms contenant
des caractères génériques. Voir à cet effet la directive
ProxyFtpListOnWildcard.
| Description: | Définit le jeu de caractères des listings FTP mandatés |
|---|---|
| Syntaxe: | ProxyFtpDirCharset character_set |
| Défaut: | ProxyFtpDirCharset ISO-8859-1 |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy_ftp |
| Compatibilité: | Disponible à partir de la version 2.2.7 du serveur HTTP Apache. Déplacé
depuis mod_proxy à partir de la version 2.3.5 |
La directive ProxyFtpDirCharset permet de
définir le jeu de caractères à utiliser pour les listings FTP en
HTML générés par mod_proxy_ftp.
| Description: | Les caractères génériques dans les noms de fichiers doivent-ils être échappés lorsqu'ils sont envoyés au serveur FTP ? |
|---|---|
| Syntaxe: | ProxyFtpEscapeWildcards on|off |
| Défaut: | ProxyFtpEscapeWildcards on |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy_ftp |
| Compatibilité: | Disponible depuis la version 2.3.3 du serveur HTTP Apache |
La directive ProxyFtpEscapeWildcards permet
de déterminer si les caractères génériques ("*?[{~") que contiennent
les noms de fichiers demandés doivent être échappés pas un slash
inversé avant d'être envoyés au serveur FTP. Il s'agit du comportement
par défaut ; cependant, de nombreux serveurs FTP n'ont aucune
connaissance de la notion d'échappement, et tentent de servir le
fichier demandé sous sa forme littérale, en incluant les slashes
inversés dans son nom.
Définissez cette directive à "off" pour permettre le téléchargement de fichiers dont les noms contiennent des caractères génériques depuis des serveurs FTP qui ne connaissent pas l'échappement des caractères génériques.
| Description: | Les caractères génériques dans les noms de fichiers demandés doivent-ils déclencher l'affichage d'un listing ? |
|---|---|
| Syntaxe: | ProxyFtpListOnWildcard on|off |
| Défaut: | ProxyFtpListOnWildcard on |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy_ftp |
| Compatibilité: | Disponible depuis la version 2.3.3 du serveur HTTP Apache |
La directive ProxyFtpListOnWildcard permet
de déterminer si les caractères génériques ("*?[{~") que contiennent
les noms de fichiers demandés provoquent l'affichage d'un listing de
fichiers par mod_proxy_ftp au lieu de télécharger un
fichier. Il s'agit de leur comportement par défaut (valeur on).
Définissez cette directive à "off" pour permettre le téléchargement de fichiers même si leur nom contient des caractères génériques.
Serveur HTTP Apache Version 2.4
| Description: | Module fournissant le support HTTP à
mod_proxy |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_http_module |
| Fichier Source: | mod_proxy_http.c |
Pour pouvoir fonctionner, ce module requiert le
chargement de mod_proxy. Il fournit le support du
mandatement des requêtes HTTP et HTTPS. mod_proxy_http
supporte HTTP/0.9, HTTP/1.0 et HTTP/1.1. Il ne fournit
aucune fonctionnalité de mise en cache. Si vous souhaitez
mettre en oeuvre un mandataire qui assure aussi les fonctions de
mise en cache, vous devez utiliser les services du module
mod_cache.
Ainsi, pour pouvoir traiter les requêtes HTTP mandatées,
mod_proxy, et mod_proxy_http
doivent être chargés dans le serveur.
N'activez pas la fonctionnalité de mandataire avant d'avoir sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux non seulement pour votre réseau, mais aussi pour l'Internet au sens large.
Ce module ne fournit aucune directive.
Outre les directives de configuration qui contrôlent le
comportement de mod_proxy, plusieurs variables
d'environnement permettent de contrôler le fournisseur du
protocole HTTP. Parmi les variables suivantes, celle qui ne
nécessitent pas de valeur particulière sont définies quelle que soit
la valeur qu'on leur affecte.
RFC
(valeur par défaut) ou
Suppress. Les versions précédentes de httpd
supprimaient les réponses intermédiaires HTTP (1xx) envoyées par
le serveur cible. En pratique, si un serveur cible envoie une
réponse intermédiaire, il se peut qu'il étende lui-même le
protocole d'une manière dont nous n'avons pas connaissance, ou
tout simplement non conforme. Le comportement du mandataire est
donc maintenant configurable : définissez
proxy-interim-response RFC pour être totalement
compatible avec le protocole, ou proxy-interim-response
Suppress pour supprimer les réponses intermédiaires.mod_proxy_http enregistre les informations
suivantes pour journalisation via le format %{NOMVAR}n
dans les directives LogFormat ou ErrorLogFormat :
Serveur HTTP Apache Version 2.4
| Description: | Module fournissant le support de FastCGI à
mod_proxy |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_fcgi_module |
| Fichier Source: | mod_proxy_fcgi.c |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache |
Pour fonctionner, ce module nécessite le chargement de
mod_proxy. Il fournit le support du protocole FastCGI.
Ainsi, pour pouvoir traiter le protocole FastCGI,
mod_proxy et mod_proxy_fcgi
doivent être chargés dans le serveur.
A la différence de mod_fcgid et mod_fastcgi,
mod_proxy_fcgi n'est pas en mesure de démarrer le
processus de l'application ; fcgistarter est
fourni à cet effet sur certaines plateformes. Le framework
applicatif FastCGI utilisé peut aussi fournir la gestion des
processus ou des lancements de programmes externes.
N'activez pas la fonctionnalité de mandataire avant d'avoir sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux non seulement pour votre réseau, mais aussi pour l'Internet au sens large.
Pour que ces exemples fonctionnent, vous ne devez pas oublier
d'activer mod_proxy et
mod_proxy_fcgi.
ProxyPass "/mon_appli/" "fcgi://localhost:4000/"
mod_proxy_fcgi interdisant par défaut la
réutilisation des connexions, lorsqu'une requête a été traitée, la
connexion ne sera pas maintenue ouverte par le processus enfant
httpd, et ne sera donc pas réutilisée. Cependant, si l'application
FastCGI supporte les connexions httpd simultanées, vous pouvez opter
pour la réutilisation des connexions comme dans l'exemple suivant :
ProxyPass "/myapp/" "fcgi://localhost:4000/" enablereuse=on
Il faut garder à l'esprit que PHP-FPM (en février 2018) utilise un modèle
du style prefork ; autrement dit, chacun de ses processus de travail ne peut
gérer qu'une connexion à la fois.
Par défaut et lorsqu'il est
configuré avec enablereuse=on et lorsqu'un MPM à base de
threads est utilisé (comme worker ou
event), mod_proxy autorise un jeu de ThreadsPerChild connexions vers le serveur
d'arrière-plan pour chaque processus httpd, et par conséquent, il faut
prêter une attention particulière aux situations suivantes :
MaxRequestWorkers.mod_http2 est implémenté, il y a des threads de travail
h2 additionnels qui peuvent forcer la création de connexions
supplémentaires vers le serveur d'arrière-plan. Le nombre total de
connexions que contiennent les jeux de connexions peut alors dépasser
MaxRequestWorkers.Le nombre maximum de processus de travail PHP-FPM doit être défini judicieusement car il est possible qu'ils finissent par rester dans l'état occupé ("busy") pour ne gérer que des connexions persistantes inactives, sans avoir la possibilité d'en établir de nouvelles ; ce qui se traduira pour l'utilisateur final par une pile de "HTTP request timeouts".
Dans l'exemple suivant, l'URI de la requête est transmis en tant que chemin du système de fichiers pour l'exécution du démon PHP-FPM. L'URL de la requête est implicitement ajoutée au second paramètre. PHP-FPM est à l'écoute de l'hôte et du port qui suivent fcgi://. La conservation/réutilisation des connexions est activée.
ProxyPassMatch "^/myapp/.*\.php(/.*)?$" "fcgi://localhost:9000/var/www/" enablereuse=on
Dans l'exemple suivant, l'URI de la requête est transmis en tant que chemin du système de fichiers pour l'exécution du démon PHP-FPM. Dans ce cas cependant, PHP-FPM est à l'écoute d'un socket de domaine unix (UDS). Cette fonctionnalité est disponible à partir de la version 2.4.9. Avec cette syntaxe, si un nom d'hôte et un port sont ajoutés après fcgi://, ils seront ignorés.
ProxyPassMatch "^/(.*\.php(/.*)?)$" "unix:/var/run/php5-fpm.sock|fcgi://localhost/var/www/"
La passerelle à répartition de charge nécessite le chargement du
module mod_proxy_balancer et d'au moins un module
fournissant un algorithme de répartition de charge, comme
mod_lbmethod_byrequests en plus des modules
déjà cités. mod_lbmethod_byrequests est le module
par défaut et sera utilisé dans cet exemple de configuration.
ProxyPass "/myapp/" "balancer://myappcluster/"
<Proxy "balancer://myappcluster/">
BalancerMember "fcgi://localhost:4000"
BalancerMember "fcgi://localhost:4001"
</Proxy>
Vous pouvez aussi forcer le traitement d'une requête en tant que requête de mandataire inverse en créant un court-circuiteur de gestionnaire approprié. Dans l'exemple ci-dessous, toutes les requêtes pour des scripts PHP seront transmises au serveur FastCGI spécifié par mandat inverse. Cette fonctionnalité est disponible à partir de la version 2.4.10 du serveur HTTP Apache. Pour des raisons de performances, il est recommandé de définir un worker (configuration d'un mandataire) représentant le même serveur fcgi:// d'arrière-plan. Avec cette configuration, il est possible d'effectuer une correspondance directe entre l'URI et le chemin du fichier sur le serveur, et le chemin local du fichier sera alors transmis au serveur d'arrière-plan. Lorsque FastCGI est configuré ainsi, le serveur est en mesure de calculer le PATH_INFO le plus approprié.
<FilesMatch "\.php$">
# Note : la seule partie variable est /path/to/app.sock
SetHandler "proxy:unix:/path/to/app.sock|fcgi://localhost/"
</FilesMatch>
# Définition d'une configuration de mandataire qui convient.
# La partie qui est mise en correspondance avec la valeur de
# SetHandler est la partie qui suit le "pipe". Si vous devez faire
# une distinction, "localhost" peut être changé en un nom de serveur
# unique.
<Proxy "fcgi://localhost/" enablereuse=on max=10>
</Proxy>
<FilesMatch ...>
SetHandler "proxy:fcgi://localhost:9000"
</FilesMatch>
<FilesMatch ...>
SetHandler "proxy:balancer://myappcluster/"
</FilesMatch>
En plus des directives de configuration qui contrôlent le
comportement de mod_proxy, de nombreuses
variables d'environnement permettent de piloter le
fournisseur du protocole FCGI :
ProxyPass ou ProxyPassMatch,
mod_proxy_fcgi ne définit
pas la variable d'environnement PATH_INFO,
ce qui permet au serveur FCGI d'arrière-plan de déterminer
correctement SCRIPT_NAME et Script-URI, et
de se conformer à la section 3.3 de la RFC 3875. Si au contraire
vous avez souhaitez que mod_proxy_fcgi génère une
"estimation la plus exacte possible" de PATH_INFO,
définissez la variable d'environnement
proxy-fcgi-pathinfo. Ceci peut servir de
contournement pour une bogue présente dans certaines
implémentations de FCGI. Cette variable peut être
multivaluée afin de pouvoir choisir la valeur la plus appropriée
(versions 2.4.11 et supérieures) :
| Description: | Spécifie le type de l'application FastCGI d'arrière-plan |
|---|---|
| Syntaxe: | ProxyFCGIBackendType FPM|GENERIC |
| Défaut: | ProxyFCGIBackendType FPM |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_proxy_fcgi |
| Compatibilité: | Disponible à partir de la version 2.4.26 du serveur HTTP Apache |
Cette directive permet de spécifier le type de l'application FastCGI d'arrière-plan. Certains serveurs FastCGI, comme PHP-FPM, utilisent de manière historique des variables d'environnement exotiques pour identifier le type du serveur mandataire utilisé. Définissez cette directive à "GENERIC" si votre application n'est pas de type PHP-FPM et n'interpréter pas correctement des variables d'environnement comme SCRIPT_FILENAME ou PATH_TRANSLATED telles qu'elles sont définies par le serveur.
SCRIPT_FILENAME est un exemple de valeur modifiée par la définition de cette
directive. Historiquement, lorsqu'on utilisait le module
mod_proxy_fcgi, SCRIPT_FILENAME était préfixé par la chaîne
"proxy:fcgi://". C'est cette variable que lisent certaines applications FastCGI
génériques en tant que valeur en entrée pour leur script ; cependant, PHP-FPM
peut supprimer le préfixe, puis garder en mémoire qu'il communique avec Apache.
Avec les versions 2.4.21 à 2.4.25, ce préfixe était automatiquement supprimé par
le serveur, empêchant ainsi PHP-FPM de détecter et interopérer avec Apache dans
certains scénarios.
| Description: | Permet d'adapter la valeur des variables envoyées aux serveurs FastCGI |
|---|---|
| Syntaxe: | ProxyFCGISetEnvIf conditional-expression
[!]environment-variable-name
[value-expression] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_proxy_fcgi |
| Compatibilité: | Disponible à partir de la version 2.4.26 du serveur HTTP Apache. |
Juste avant la transmission d'une requête au serveur FastCGI configuré, le coeur du programme du serveur web définit un certain nombre de variables d'environnement en fonction de certains détails de la requête considérée. Les programmes FastCGI utilisent souvent ces variables comme données en entrée afin de déterminer quels scripts sous-jacents ils vont exécuter, ou quelles données en sortie doivent être produites.
Voici quelques exemples de variables d'environnement importantes :
Cette directive permet de passer outre les variables d'environnement ci-dessus, entre autres. Elle est évaluée après la définition de la valeur initiale de ces variables ; elle peuvent donc être utilisées comme entrées dans les expressions définissants les conditions et les valeurs.
Syntaxe des paramètres :
# Une modification basique, inconditionnelle
ProxyFCGISetEnvIf "true" PATH_INFO "/example"
# Utilisation d'une variable d'environnement pour spécifier la nouvelle valeur
ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"
# Utilisation de captures dans la condition et de références arrières dans la
# nouvelle valeur
ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m#(/.*prefix)(\d+)(.*)#" PATH_TRANSLATED "$1$3"
VARIABLE,
ce qui l'empêche d'être envoyée au serveur FastCGI :
ProxyFCGISetEnvIf true !VARIABLELa ligne suivante, quant à elle, efface la valeur de la variable
VARIABLE en lui affectant la chaîne vide ; cette variable
VARIABLE sera alors tout de même envoyée au serveur FastCGI :
ProxyFCGISetEnvIf true VARIABLELa spécification CGI/1.1 ne fait pas de distinction entre une variable contenant une chaîne vide et une variable qui n'existe pas. De nombreuses implémentations CGI et FastCGI font cependant cette distinction (ou permettent aux scripts de la faire). Le choix de celle que vous allez utiliser dépend de votre implémentation et de la raison qui vous pousse à modifier cette variable.
Serveur HTTP Apache Version 2.4
| Description: | Check up dynamique des membres du groupe de répartition de charge
(équipiers) pour mod_proxy |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_hcheck_module |
| Fichier Source: | mod_proxy_hcheck.c |
| Compatibilité: | Disponible à partir de la version 2.4.21 du serveur HTTP Apache |
Ce module permet d'effectuer un check up dynamique des membres du groupe de répartition de charge (équipiers). Ce check up peut être activé pour un ou plusieurs équipiers et il est indépendant des requêtes de mandataire inverse proprement dites.
Pour fonctionner, ce module nécessite le chargement préalable de
mod_watchdog.
Le mécanisme de check up est activé via l'utilisation de paramètres
supplémentaires de la directive BalancerMember configurés de manière standard
via la directive ProxyPass :
Ce module définit un nouveau drapeau d'état status pour BalancerMember :
"C". Lorsque l'équipier est mis hors service suite à un
disfonctionnement déterminé par le module de check up, ce drapeau est activé
et peut être lu (et modifié) via le balancer-manager.
| Paramètre | Défaut | Description | |||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hcmethod | None | Aucun check up dynamique n'est effectué. Les choix possibles sont :
| |||||||||||||||||||||||||||||||||
| hcpasses | 1 | Nombre de check up à passer avec succès avant de remettre en service l'équipier | |||||||||||||||||||||||||||||||||
| hcfails | 1 | Nombre de check up échoués avant mettre hors service l'équipier | |||||||||||||||||||||||||||||||||
| hcinterval | 30 | Intervalle entre deux check up en secondes (par défaut effectué toutes les 30 secondes) | |||||||||||||||||||||||||||||||||
| hcuri | URI supplémentaire à ajouter à l'URL de l'équipier pour le check up. | ||||||||||||||||||||||||||||||||||
| hctemplate | Nom du modèle créé via ProxyHCTemplate à
utiliser pour définir les paramètres de check up de cet équipier | ||||||||||||||||||||||||||||||||||
| hcexpr | Nom de l'expression créée via ProxyHCExpr
utilisée pour analyser les en-têtes de la réponse du check up.Si ce paramètre est absent, un état HTTP de 2xx à 3xx est interprété comme un check up réussi. | ||||||||||||||||||||||||||||||||||
OPTIONS11, HEAD11 et GET11 sont
disponibles à partir de la version 2.4.55 du serveur HTTP Apache.
L'exemple suivant montre comment configurer le check up pour différents serveurs d'arrière-plan :
ProxyHCExpr ok234 {%{REQUEST_STATUS} =~ /^[234]/}
ProxyHCExpr gdown {%{REQUEST_STATUS} =~ /^[5]/}
ProxyHCExpr in_maint {hc('body') !~ /Under maintenance/}
<Proxy balancer://foo>
BalancerMember http://www.example.com/ hcmethod=GET hcexpr=in_maint hcuri=/status.php
BalancerMember http://www2.example.com/ hcmethod=HEAD hcexpr=ok234 hcinterval=10
BalancerMember http://www3.example.com/ hcmethod=TCP hcinterval=5 hcpasses=2 hcfails=3
BalancerMember http://www4.example.com/
</Proxy>
ProxyPass "/" "balancer://foo"
ProxyPassReverse "/" "balancer://foo"
Dans ce scénario, on teste l'équipier http://www.example.com/ en lui
envoyant une requête GET /status.php et en regardant si la réponse
contient la chaîne Under maintenance. Si c'est le cas, le check up est
considéré comme ayant échoué et l'équipier est mis hors service. Ce check up
dynamique est effectué toutes les 30 secondes, ce qui correspond à la valeur par
défaut.
On teste l'équipier http://www2.example.com/ en lui envoyant
simplement une requête HEAD toutes les 10 secondes et en vérifiant
que la réponse HTTP est bien un code d'état de 2xx, 3xx ou 4xx. On teste
l'équipier http://www3.example.com/ en vérifiant simplement toutes
les 5 secondes que le socket vers ce serveur est bien opérationnel. Si ce
serveur est marqué "hors service", il lui faudra 2 check up réussis pour être
réactivé et participer à nouveau à la répartition de charge. Si à ce moment-là
il échoue à 3 check up successifs, il sera à nouveau mis hors service. Enfin,
l'équipier http://www4.example.com/ ne fait l'objet d'aucun check
up.
| Description: | Crée et nomme une expression conditionnelle à utiliser pour déterminer la santé d'un serveur d'arrière-plan en fonction de sa valeur |
|---|---|
| Syntaxe: | ProxyHCExpr name {ap_expr expression} |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy_hcheck |
La directive ProxyHCExpr permet de créer et nommer
une expression conditionnelle dont la valeur calculée en fonction des
en-têtes de la réponse du serveur d'arrière-plan permettra d'évaluer la
santé de ce dernier. Cette expression nommée peut alors être assignée aux
serveurs d'arrière-plan via le paramètre hcexpr.
ProxyHCExpr ok234 {%{REQUEST_STATUS} =~ /^[234]/}
ProxyPass "/apps" "balancer://foo"
<Proxy balancer://foo>
BalancerMember http://www2.example.com/ hcmethod=HEAD hcexpr=ok234 hcinterval=10
</Proxy>
Si l'on utilise une méthode de check up (par exemple GET)
qui génère un corps de réponse, ce corps peut lui-même être ausculté via
ap_expr en utilisant la fonction associée aux expressions
hc() spécifique à ce module.
Dans l'exemple suivant, on envoie une requête GET au serveur
d'arrière-plan, et si le corps de la réponse contient la chaîne Under
maintenance, ce serveur d'arrière-plan est mis hors service.
ProxyHCExpr in_maint {hc('body') !~ /Under maintenance/}
ProxyPass "/apps" "balancer://foo"
<Proxy balancer://foo>
BalancerMember http://www.example.com/ hcexpr=in_maint hcmethod=get hcuri=/status.php
</Proxy>
NOTE: Comme le corps de la réponse peut être assez grand, il est recommandé de privilégier un check up basé sur les codes d'état.
| Description: | Crée et nomme un modèle permettant de définir différents paramètres de check up |
|---|---|
| Syntaxe: | ProxyHCTemplate name parameter=setting [...] |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy_hcheck |
La directive ProxyHCTemplate permet de créer et
nommer un modèle de paramètres de check up qui peut alors être assigné aux
équipiers via le paramètre hctemplate.
ProxyHCTemplate tcp5 hcmethod=tcp hcinterval=5 ProxyPass "/apps" "balancer://foo" <Proxy balancer://foo> BalancerMember http://www2.example.com/ hctemplate=tcp5 </Proxy>
| Description: | Définit la taille totale, pour l'ensemble du serveur, du jeu de threads utilisé pour le check up des équipiers |
|---|---|
| Syntaxe: | ProxyHCTPsize size |
| Défaut: | ProxyHCTPsize 16 |
| Contexte: | configuration globale |
| Statut: | Extension |
| Module: | mod_proxy_hcheck |
Si Apache httpd et APR ont été compilés avec le support des threads, le
module de check up peut confier ce travail à un jeu de threads associé au
processus Watchdog, ce qui permet l'exécution des check up en parallèle. La
directive ProxyHCTPsize permet de déterminer la
taille de ce jeu de threads. Une valeur de 0 signifie qu'aucun
jeu de threads ne sera utilisé, et le check up des différents équipiers sera
alors effectué séquentiellement.
ProxyHCTPsize 32
Serveur HTTP Apache Version 2.4
| Description: | Support de HTTP/2 pour mod_proxy |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_http2_module |
| Fichier Source: | mod_proxy_http2.c |
| Compatibilité: | Disponible à partir de la version 2.4.19 du serveur HTTP Apache |
mod_proxy_http2 ne
supporte que HTTP/2 et ne permet pas de rétrogradation vers HTTP/1.1. Cela
signifie que le serveur d'arrière-plan doit supporter HTTP/2 car HTTP/1.1 ne
pourra alors pas être utilisé.
Ce module nécessite la présence de mod_proxy ;
pour pouvoir traiter les requêtes mandatées HTTP/2,
mod_proxy et mod_proxy_http2 doivent donc
être chargés par le serveur.
mod_proxy_http2 travaille avec des requêtes entrantes en
HTTP/1.1 ou HTTP/2. Dans les deux cas, les requêtes vers le même serveur
d'arrière-plan sont envoyées
via une seule connexion TCP, dans la mesure du possible (autrement dit
lorsque la connexion peut être réutilisée).
Avertissement : il ne sera effectué aucune tentative de fusion de plusieurs requêtes entrantes HTTP/1 (devant être mandatées vers le même serveur d'arrière-plan) vers des flux HTTP/2 appartenant à la même requête HTTP/2. Chaque requête HTTP/1 entrante sera mandatée vers le serveur d'arrière-plan en utilisant une requête HTTP/2 séparée (tout en réutilisant si possible la même connexion TCP).
Ce module s'appuie sur libnghttp2 pour fournir le moteur central http/2.
Ce module en est au stade expérimental. Ses comportement, directives et valeurs par défauts sont donc susceptibles de modifications d'une version à l'autre plus fréquentes que pour les autres modules. A ce titre, il est fortement conseillé aux utilisateurs de consulter le fichier "CHANGES" pour prendre connaissance de ces modifications.
N'activez pas le mandatement avant d'avoir sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux non seulement pour votre propre réseau, mais aussi pour l'Internet au sens large.
Ce module ne fournit aucune directive.
Les exemples ci-dessous montrent comment configurer HTTP/2 pour des connexions d'arrière-plan vers un mandataire inverse.
ProxyPass "/app" "h2://app.example.com" ProxyPassReverse "/app" "https://app.example.com"
ProxyPass "/app" "h2c://app.example.com" ProxyPassReverse "/app" "http://app.example.com"
Pour mandater en inverse les protocoles h2 ou
h2c, on utilise la directive
ProxyPassReverse avec les schèmes habituels
https et respectivement
http qui sont connus et utilisés par l'agent utilisateur.
mod_proxy_http fournit les informations sur les requêtes
suivantes pour enregistrement dans les journaux en utilisant le format
%{VARNAME}n avec les directives LogFormat ou ErrorLogFormat :
Serveur HTTP Apache Version 2.4
| Description: | Module pour mod_proxy supportant les
websockets |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_wstunnel_module |
| Fichier Source: | mod_proxy_wstunnel.c |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache |
Depuis la version 2.4.47 du serveur HTTP Apache, la promotion de
protocole (tunneling) peut être pris en charge de manière plus efficace par
mod_proxy_http.
Voir Promotion de protocole.
Pour utiliser ce module, mod_proxy doit être
chargé. Il fournit le support du tunnelling pour les connexions
websocket vers un serveur websockets d'arrière-plan. La connexion
est automatiquement promue en connexion websocket :
Upgrade: WebSocket Connection: Upgrade
Le mandatement des requêtes vers un serveur websockets comme
echo.websocket.org peut être configuré via la directive ProxyPass :
ProxyPass "/ws2/" "ws://echo.websocket.org/" ProxyPass "/wss2/" "wss://echo.websocket.org/"
Il est possible de mandater les websockets et HTTP en même temps, avec un jeu
spécifique d'URLs pour les websockets, en définissant la directive ProxyPass concernant les
websockets avant celle concernant HTTP :
ProxyPassMatch ^/(myApp/ws)$ ws://backend.example.com:9080/$1 ProxyPass / http://backend.example.com:9080/
Il est possible de mandater les websockets et HTTP en même temps, lorsque
les URLs websockets ne concernent pas uniquement les websockets ou ne sont pas
connues à l'avance, en utilisant la directive RewriteRule pour configurer le mandatement des
websockets :
ProxyPass / http://example.com:9080/
RewriteEngine on
RewriteCond %{HTTP:Upgrade} websocket [NC]
RewriteCond %{HTTP:Connection} upgrade [NC]
RewriteRule ^/?(.*) "ws://example.com:9080/$1" [P,L]
La répartition de charge entre plusieurs serveurs d'arrière-plan peut être
configurée via le module mod_proxy_balancer.
Ce module peut aussi être utilisé pour la promotion vers des protocoles autres
que WebSocket en définissant le paramètre upgrade de la directive ProxyPass avec un nom de
protocole particulier.
Les valeurs spéciales upgrade=NONE et upgrade=ANY
peuvent être utilisées pour tester ou forcer la promotion de protocole mais leur
utilisation n'est pas recommandée en production pour des
raisons de sécurité.
NONE signifie que la vérification de l'en-tête est omise mais que
la promotion (tunneling) vers WebSocket s'effectuera quand-même.
ANY signifie que la promotion (tunneling) s'effectuera en utilisant
tout protocole demandé par le client.
| Description: | Demande à ce module de laisser mod_proxy_http
gérer la requête |
|---|---|
| Syntaxe: | ProxyWebsocketFallbackToProxyHttp On|Off |
| Défaut: | ProxyWebsocketFallbackToProxyHttp On |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy_wstunnel |
| Compatibilité: | Disponible à partir de la version 2.4.48 du serveur HTTP Apache |
Depuis la version 2.4.47 de httpd, mod_proxy_http peut
gérer le tunneling et la mise à jour via les WebSockets en accord avec la
RFC 7230 ; cette directive permet de définir si, pour ces actions,
mod_proxy_wstunnel doit passer la main à
mod_proxy_http, ce qui est le cas par défaut.
Définir cette directive à Off revient à laisser
mod_proxy_wstunnel gérer les requêtes WebSocket, comme avec
les versions 2.4.46 et antérieures de httpd.
Serveur HTTP Apache Version 2.4
| Description: | Remplace l'adresse IP du client pour la requête par l'adresse IP présentée par un mandataire ou un répartiteur de charge via les en-têtes de la requête. |
|---|---|
| Statut: | Base |
| Identificateur de Module: | remoteip_module |
| Fichier Source: | mod_remoteip.c |
Ce module permet de traiter le client qui a initié la requête en tant que client original du point de vue de httpd à des fins d'autorisation et de connexion, même si ce client se trouve derrière un répartiteur de charge, un serveur frontal, ou un serveur mandataire.
Le module remplace l'adresse IP du client
pour la connexion par l'adresse IP indiquée dans
l'en-tête de requête configuré via la directive
RemoteIPHeader.
Ce module implémente aussi la partie serveur du protocole PROXY
de HAProxy via la directive RemoteIPProxyProtocol.
Une fois sa valeur modifiée comme indiqué, cette adresse IP client est
utilisée pour la fonctionnalité Require ip de mod_authz_host ;
elle est aussi affichée par mod_status, et enregistrée via
les chaînes de formatage %a des modules
mod_log_config et core. L'adresse IP
client sous-jacente de la connexion est enregistrée via la chaîne de
formatage %{c}a.
RemoteIPHeader RemoteIPInternalProxy RemoteIPInternalProxyList RemoteIPProxiesHeader RemoteIPProxyProtocol RemoteIPProxyProtocolExceptions RemoteIPTrustedProxy RemoteIPTrustedProxyListPar défaut, Apache identifie le client via la valeur client_ip de la connexion, et de cette valeur découlent les valeurs remote_host et remote_logname de la connexion. Ces champs jouent un rôle dans l'authentification, l'autorisation et la journalisation, ainsi que dans d'autres traitements effectués par d'autres modules chargeables.
mod_remoteip remplace l'adresse IP client de la connexion par l'adresse IP client indiquée par exemple par un mandataire ou un répartiteur de charge pour toute la durée de la requête. Un répartiteur de charge pourra ainsi établir une connexion keepalive de longue durée avec le serveur, chaque requête conservant alors l'adresse IP client correcte bien que l'adresse IP client sous-jacente du répartiteur de charge reste inchangée.
Lorsque la valeur de l'en-tête comporte plusieurs adresses IP client séparées par des virgules, celles-ci sont traitées de la droite vers la gauche. Le traitement s'arrête lorsque l'adresse IP client courante n'est pas digne de confiance pour présenter l'adresse IP précédente. Le champ d'en-tête est alors mis à jour de façon à ne contenir que cette liste d'adresses non confirmées, ou bien, si toutes les adresses IP sont dignes de confiance, cet en-tête est tout bonnement supprimé de la requête.
Lors du remplacement de l'adresse IP client, le module stocke
la liste des hôtes intermédiaires dans un mémo
remoteip-proxy-ip-list, que l'on peut faire enregistrer par
mod_log_config en utilisant le symbole de format
%{remoteip-proxy-ip-list}n. Si l'administrateur doit
stocker ceci dans un en-tête additionnel, la même valeur peut aussi
être enregistrée sous la forme d'un en-tête en utilisant la
directive RemoteIPProxiesHeader.
RemoteIPInternalProxy sont enregistrés.| Description: | Définit le champ d'en-tête qui contiendra les adresses IP du client |
|---|---|
| Syntaxe: | RemoteIPHeader en-tête |
| Défaut: | none |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_remoteip |
La directive RemoteIPHeader indique à
mod_remoteip de traiter la valeur de
l'en-tête spécifié comme l'adresse IP du client, ou comme
une liste d'adresses IP clients intermédiaires, en fonction de la
configuration des directives
RemoteIPInternalProxy et
RemoteIPTrustedProxy. Si ces
deux dernières directives ne sont pas utilisées,
mod_remoteip traitera tout hôte présentant une adresse non
interne dans l'en-tête RemoteIPHeader comme hôte de confiance.
mod_remoteip
traitera tout hôte présentant une adresse non interne
dans l'en-tête RemoteIPHeader comme hôte de
confiance.RemoteIPHeader X-Client-IP
RemoteIPHeader X-Forwarded-For
| Description: | Déclare les adresses IP intranet clients comme dignes de confiance pour présenter la valeur RemoteIPHeader |
|---|---|
| Syntaxe: | RemoteIPInternalProxy
ip-mandataire|ip-mandataire/sous-réseau|nom-hôte ... |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_remoteip |
La directive RemoteIPInternalProxy permet
d'ajouter une ou plusieurs adresses (ou blocs d'adresses) auxquelles
on peut faire confiance pour présenter une valeur RemoteIPHeader
valide de l'adresse IP du client. A la différence de la directive
RemoteIPTrustedProxy, toute adresse IP
présentée dans cet en-tête, y comprises les adresses intranet
privées, sont considérées comme dignes de confiance lorsqu'elles
sont indiquées par ces mandataires.
RemoteIPHeader X-Client-IP RemoteIPInternalProxy 10.0.2.0/24 RemoteIPInternalProxy gateway.localdomain
| Description: | Déclare les adresses IP intranet clients comme dignes de confiance pour présenter la valeur RemoteIPHeader |
|---|---|
| Syntaxe: | RemoteIPInternalProxyList nom-fichier |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_remoteip |
La directive RemoteIPInternalProxyList
permet de spécifier un fichier parcouru au démarrage du serveur pour
construire une liste d'adresses (ou blocs d'adresses), auxquelles
on peut faire confiance pour présenter une valeur RemoteIPHeader
valide de l'adresse IP du client.
Le caractère '#' indique une ligne de commentaires,
sinon, toutes les lignes séparées par un caractère nouvelle
ligne ou
tous les éléments d'une ligne séparés par un espace sont traités de
la même façon qu'avec la directive
RemoteIPInternalProxy.
RemoteIPHeader X-Client-IP RemoteIPInternalProxyList conf/trusted-proxies.lst
# Nos mandataires internes de confiance
10.0.2.0/24 # Tout le monde dans le groupe de test
passerelle.domaine-local # Le frontal répartiteur de charge| Description: | Déclare le champ d'en-tête qui contiendra toutes les adresses IP intermédiaires |
|---|---|
| Syntaxe: | RemoteIPProxiesHeader Nom_en-tête |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_remoteip |
La directive RemoteIPProxiesHeader permet
de spécifier l'en-tête dans lequel mod_remoteip va
collecter une liste de toutes les adresses IP clients intermédiaires
auxquelles on pourra faire confiance pour résoudre l'adresse IP
client de la requête. Notez que les adresses intermédiaires
RemoteIPTrustedProxy sont enregistrées dans
cet en-tête, alors que toute adresse intermédiaire
RemoteIPInternalProxy est omise.
RemoteIPHeader X-Forwarded-For RemoteIPProxiesHeader X-Forwarded-By
| Description: | Active ou désactive la gestion du protocole PROXY |
|---|---|
| Syntaxe: | RemoteIPProxyProtocol On|Off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_remoteip |
| Compatibilité: | Disponible à partir de la version 2.4.31 du serveur HTTP Apache |
La directive RemoteIPProxyProtocol permet
d'activer ou de désactiver la prise en compte et la gestion de l'en-tête de
connexion du protocole PROXY. Si elle est définie à On, la
demande du client doit envoyer l'en-tête approprié pour chaque
nouvelle connexion, sinon cette dernière sera fermée à moins qu'il ne fasse
partie de la liste, définie via la directive RemoteIPProxyProtocolDisableHosts, des
hôtes pour lesquels le protocole PROXY est désactivé.
Bien que cette directive peut être définie au niveau de n'importe quel serveur virtuel, il est important de garder à l'esprit que, étant donné que le protocole PROXY est basé sur la connexion et agnostique quant au protocle, son activation/désactivation est basée sur le couple adresse IP/port. Cela signifie que si plusieurs serveurs virtuels à base de nom sont configurés avec le même couple adresse IP/port, et si vous activez le protocole PROXY pour l'un d'entre eux, il le sera aussi pour tous les autres (avec le même couple adresse IP/port). Cela signifie aussi que si vous tentez d'activer le protocole PROXY pour un serveur virtuel et de le désactiver pour un autre, cela ne marchera pas ; dans ce dernier cas, la dernière directive l'emporte sur les autres et une notification sera enregistrée dans le journal pour indiquer les réglages qui ont été annulés.
Listen 80
<VirtualHost *:80>
ServerName www.example.com
RemoteIPProxyProtocol On
#Les requêtes pour ce serveur virtuel doivent contenir un en-tête du
#protocole PROXY. Si ce n'est pas le cas, la connexion sera fermée.
</VirtualHost>
Listen 8080
<VirtualHost *:8080>
ServerName www.example.com
RemoteIPProxyProtocol On
RemoteIPProxyProtocolExceptions 127.0.0.1 10.0.0.0/8
#Les requêtes pour ce serveur virtuel doivent contenir un en-tête du
#protocole PROXY. Si ce n'est pas le cas, la connexion sera fermée à moins
que sa source ne soit localhost ou la gamme d'adresses RFC1918 10.x.x.x
</VirtualHost>
| Description: | Désactive la prise en compte de l'en-tête PROXY pour certains hôtes ou réseaux |
|---|---|
| Syntaxe: | RemoteIPProxyProtocolExceptions host|range [host|range] [host|range] |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_remoteip |
| Compatibilité: | RemoteIPProxyProtocolExceptions est disponible à partir de la version 2.4.31 du serveur HTTP Apache |
La directive RemoteIPProxyProtocol permet de
contrôler la prise en compte de l'en-tête de connexion du protocole PROXY.
Il est parfois souhaitable d'exiger pour certains clients la
présence de l'en-tête PROXY, mais aussi de permettre aux autres clients de
se connecter sans ce dernier. Cette directive permet à l'administrateur du
serveur d'autoriser cette possibilité à un hôte isolé ou à une gamme d'hôtes
au format CIDR.
| Description: | Déclare les adresses IP clientes de l'intranet dignes de confiance pour présenter la valeur RemoteIPHeader |
|---|---|
| Syntaxe: | RemoteIPTrustedProxy
ip-mandataire|ip-mandataire/sous-réseau|nom-hôte ... |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_remoteip |
La directive RemoteIPTrustedProxy permet
d'ajouter une ou plusieurs adresses, ou blocs d'adresses, auxquelles
on peut faire confiance pour présenter une valeur RemoteIPHeader
valide de l'adresse IP du client. A la différence de la directive
RemoteIPInternalProxy, toutes les adresses IP
intranet ou privées indiquées par de tels mandataires, y compris les
blocs d'adresses 10/8, 172.16/12, 192.168/16, 169.254/16 et 127/8
(ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas
dignes de confiance en tant qu'adresses IP distantes, et se situent
à gauche dans le contenu de l'en-tête
RemoteIPHeader.
RemoteIPHeader X-Forwarded-For RemoteIPTrustedProxy 10.0.2.16/28 RemoteIPTrustedProxy proxy.example.com
| Description: | Déclare les adresses IP intranet clients comme dignes de confiance pour présenter la valeur RemoteIPHeader |
|---|---|
| Syntaxe: | RemoteIPTrustedProxyList nom-fichier |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_remoteip |
La directive RemoteIPTrustedProxyList
permet de spécifier un fichier parcouru au démarrage du serveur pour
construire une liste d'adresses (ou blocs d'adresses), auxquelles
on peut faire confiance pour présenter une valeur RemoteIPHeader
valide de l'adresse IP du client.
Le caractère '#' indique une ligne de commentaires,
sinon, toutes les lignes séparées par un caractère nouvelle ligne ou
tous les éléments d'une ligne séparés par un espace sont traités de
la même façon qu'avec la directive
RemoteIPTrustedProxy.
RemoteIPHeader X-Forwarded-For RemoteIPTrustedProxyList conf/trusted-proxies.lst
# Mandataires externes identifiés
192.0.2.16/28 #groupe wap phone de mandataires
proxy.isp.example.com #un FAI bien connu
Serveur HTTP Apache Version 2.4
| Description: | Serveur mandataire/passerelle multi-protocole |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_module |
| Fichier Source: | mod_proxy.c |
N'activez pas la fonctionnalité de mandataire avec la directive
ProxyRequests avant
d'avoir sécurisé votre serveur. Les serveurs
mandataires ouverts sont dangereux pour votre réseau,
mais aussi pour l'Internet au sens large.
mod_proxy et ses modules associés implémentent
un mandataire/passerelle pour le serveur HTTP Apache, et supportent
de nombreux protocoles courants, ainsi que plusieurs algorithmes de
répartition de charge. Le support de protocoles et d'algorithmes de
répartition de charge supplémentaires peut être assuré par des
modules tiers.
Un jeu de modules chargés dans le serveur permet de fournir les
fonctionnalités souhaitées. Ces modules peuvent être inclus
statiquement à la compilation, ou dynamiquement via la directive
LoadModule. Ce jeu de module
doit comporter :
mod_proxy, qui fournit les fonctionnalités de
base d'un mandatairemod_proxy_balancer et un ou plusieurs modules
de répartition, si la répartition de charge doit être mise en
oeuvre (Voir la documentation de
mod_proxy_balancer pour plus de détails).| Protocole | Module |
|---|---|
| AJP13 (Protocole Apache JServe version 1.3) | mod_proxy_ajp |
| CONNECT (pour SSL) | mod_proxy_connect |
| FastCGI | mod_proxy_fcgi |
| ftp | mod_proxy_ftp |
| HTTP/0.9, HTTP/1.0, et HTTP/1.1 | mod_proxy_http |
| HTTP/2.0 | mod_proxy_http2 |
| SCGI | mod_proxy_scgi |
| UWSGI | mod_proxy_uwsgi |
| WS and WSS (Web-sockets) | mod_proxy_wstunnel |
En outre, d'autres modules fournissent des fonctionnalités
étendues. mod_cache et ses modules associés
fournissent la mise en cache. Les directives SSLProxy*
du module mod_ssl permettent de contacter des
serveurs distants en utilisant le protocole SSL/TLS. Ces modules
additionnels devront être chargés et configurés pour pouvoir
disposer de ces fonctionnalités.
Mandataires directs et
mandataires/passerelles inverses Exemples simples Accès via un gestionnaire Workers Contrôler l'accès à votre
mandataire Ralentissement au démarrage Mandataire en Intranet Ajustements relatifs au
protocole Corps de requêtes En-têtes de requête du mandataire
inverse BalancerGrowth BalancerInherit BalancerMember BalancerPersist NoProxy <Proxy> Proxy100Continue ProxyAddHeaders ProxyBadHeader ProxyBlock ProxyDomain ProxyErrorOverride ProxyIOBufferSize <ProxyMatch> ProxyMaxForwards ProxyPass ProxyPassInherit ProxyPassInterpolateEnv ProxyPassMatch ProxyPassReverse ProxyPassReverseCookieDomain ProxyPassReverseCookiePath ProxyPreserveHost ProxyReceiveBufferSize ProxyRemote ProxyRemoteMatch ProxyRequests ProxySet ProxySourceAddress ProxyStatus ProxyTimeout ProxyViaLe serveur HTTP Apache peut être configuré dans les deux modes mandataire direct et mandataire inverse (aussi nommé mode passerelle).
Un mandataire direct standard est un serveur intermédiaire qui s'intercale entre le client et le serveur demandé. Pour obtenir un contenu hébergé par le serveur demandé, le client envoie une requête au mandataire en nommant le serveur demandé comme cible. Le mandataire extrait alors le contenu depuis le serveur demandé et le renvoie enfin au client. Le client doit être configuré de manière appropriée pour pouvoir utiliser le mandataire direct afin d'accéder à d'autres sites.
L'accès à Internet depuis des clients situés derrière un
pare-feu est une utilisation typique du mandataire direct. Le
mandataire direct peut aussi utiliser la mise en cache (fournie
par mod_cache) pour réduire la charge du
réseau.
La fonctionnalité de mandataire direct est activée via la
directive ProxyRequests.
Comme les mandataires directs permettent aux clients d'accéder à
des sites quelconques via votre serveur et de dissimuler leur
véritable origine, il est indispensable de sécuriser votre serveur de façon à ce que seuls
les clients autorisés puissent accéder à votre serveur avant
d'activer la fonctionnalité de mandataire direct.
Un mandataire inverse (ou passerelle), quant à lui, apparaît au client comme un serveur web standard. Aucune configuration particulière du client n'est nécessaire. Le client adresse ses demandes de contenus ordinaires dans l'espace de nommage du mandataire inverse. Ce dernier décide alors où envoyer ces requêtes, et renvoie le contenu au client comme s'il l'hébergeait lui-même.
L'accès d'utilisateurs depuis Internet vers un serveur situé derrière un pare-feu est une utilisation typique du mandataire inverse. On peut aussi utiliser les mandataires inverses pour mettre en oeuvre une répartition de charge entre plusieurs serveurs en arrière-plan, ou fournir un cache pour un serveur d'arrière-plan plus lent. Les mandataires inverses peuvent aussi tout simplement servir à rassembler plusieurs serveurs dans le même espace de nommage d'URLs.
La fonctionnalité de mandataire inverse est activée via la
directive ProxyPass ou
le drapeau [P] de la directive RewriteRule. Il n'est
pas nécessaire de définir ProxyRequests pour configurer
un mandataire inverse.
Les exemples ci-dessous illustrent de manière très basique la mise en oeuvre de la fonctionnalité de mandataire et ne sont là que pour vous aider à démarrer. Reportez-vous à la documentation de chaque directive.
Si en outre, vous désirez activer la mise en cache, consultez la
documentation de mod_cache.
ProxyPass "/foo" "http://foo.example.com/bar" ProxyPassReverse "/foo" "http://foo.example.com/bar"
ProxyRequests On ProxyVia On <Proxy "*"> Require host internal.example.com </Proxy>
ProxyPass "/some/ws/capable/path/" "http://example.com/some/ws/capable/path/" upgrade=websocket
Vous pouvez aussi forcer le traitement d'une requête en tant que requête de mandataire inverse en créant un gestionnaire de transfert approprié. Dans l'exemple suivant, toutes les requêtes pour des scripts PHP seront transmises au serveur FastCGI spécifié via un mandat inverse :
<FilesMatch "\.php$">
# Les sockets Unix nécessitent une version 2.4.7 ou supérieure du
# serveur HTTP Apache
SetHandler "proxy:unix:/path/to/app.sock|fcgi://localhost/"
</FilesMatch>
Cette fonctionnalité est disponible à partir de la version 2.4.10 du serveur HTTP Apache.
Le mandataire gère la configuration et les paramètres de communication des serveurs originaux au sein d'objets nommés workers. Deux types de worker sont fournis : le worker par défaut du mandataire direct et le worker par défaut du mandataire inverse. Il est aussi possible de définir explicitement des workers supplémentaires.
Les deux workers par défaut possèdent une configuration figée et seront utilisés si aucun autre worker ne correspond à la requête. Ils ne réutilisent pas les connexions et n'utilisent pas les connexions HTTP persistantes (Keep-Alive). En effet, les connexions TCP vers le serveur original sont fermées et ouvertes pour chaque requête.
Les workers définis explicitement sont identifiés par leur URL.
Ils sont en général définis via les directives ProxyPass ou ProxyPassMatch lorsqu'on les
utilise dans le cadre d'un mandataire inverse :
ProxyPass "/example" "http://backend.example.com" connectiontimeout=5 timeout=30
Cette directive va créer un worker associé à l'URL du serveur
original http://backend.example.com qui utilisera les
valeurs de timeout données. Lorsqu'ils sont utilisés dans le cadre
d'un mandataire direct, les workers sont en général définis via la
directive ProxySet,
ProxySet "http://backend.example.com" connectiontimeout=5 timeout=30
ou encore via les directives Proxy et ProxySet :
<Proxy "http://backend.example.com"> ProxySet connectiontimeout=5 timeout=30 </Proxy>
L'utilisation de workers définis explicitement dans le mode
mandataire direct n'est pas très courante, car les mandataires
directs communiquent en général avec de nombreux serveurs
originaux. La création explicite de workers pour certains serveurs
originaux peut cependant s'avérer utile si ces serveurs sont
très souvent sollicités. A leur niveau, les workers explicitement
définis ne possèdent aucune notion de mandataire direct ou
inverse. Ils encapsulent un concept de communication commun avec
les serveurs originaux. Un worker créé via la directive ProxyPass pour être utilisé dans le
cadre d'un mandataire inverse sera aussi utilisé dans le cadre
d'un mandataire directe chaque fois que l'URL vers le serveur
original correspondra à l'URL du worker, et vice versa.
L'URL qui identifie un worker correspond à l'URL de son serveur original, y compris un éventuel chemin donné :
ProxyPass "/examples" "http://backend.example.com/examples" ProxyPass "/docs" "http://backend.example.com/docs"
Dans cet exemple, deux workers différents sont définis, chacun d'eux utilisant des configurations et jeux de connexions séparés.
Le partage de workers intervient lorsque les URLs des workers s'entrecoupent, ce qui arrive lorsque l'URL d'un worker correspond au début de l'URL d'un autre worker défini plus loin dans le fichier de configuration. Dans l'exemple suivant,
ProxyPass "/apps" "http://backend.example.com/" timeout=60 ProxyPass "/examples" "http://backend.example.com/examples" timeout=10
le second worker n'est pas vraiment créé. C'est le premier
worker qui est en fait utilisé. L'avantage de ceci réside dans
le fait qu'il n'existe qu'un seul jeu de connexions, ces
dernières étant donc réutilisées plus souvent. Notez que tous
les attributs de configuration définis explicitement pour le
deuxième worker seront ignorés, ce qui sera journalisé en tant
qu'avertissement. Ainsi, dans l'exemple ci-dessus, la valeur de
timeout retenue pour l'URL /exemples sera
60, et non 10 !
Si vous voulez empêcher le partage de workers, classez vos
définitions de workers selon la longueur des URLs, de la plus
longue à la plus courte. Si au contraire vous voulez favoriser
ce partage, utilisez l'ordre de classement inverse. Voir aussi
l'avertissement à propos de l'ordre de classement des directives
ProxyPass.
Les workers définis explicitement sont de deux sortes :
workers directs et workers de répartition (de
charge). Ils supportent de nombreux attributs de
configuration importants décrits dans la directive ProxyPass. Ces mêmes attributs
peuvent aussi être définis via la directive ProxySet.
Le jeu d'options disponibles pour un worker direct dépend du
protocole spécifié dans l'URL du serveur original. Les protocoles
disponibles comprennent ajp, fcgi,
ftp, http et scgi.
Les workers de répartition sont des workers virtuels qui utilisent les workers directs, connus comme faisant partie de leurs membres, pour le traitement effectif des requêtes. Chaque répartiteur peut comporter plusieurs membres. Lorsqu'il traite une requête, il choisit un de ses membres en fonction de l'algorithme de répartition de charge défini.
Un worker de répartition est créé si son URL de worker comporte
balancer comme indicateur de protocole. L'URL du
répartiteur permet d'identifier de manière unique le worker de
répartition. La directive BalancerMember permet d'ajouter des
membres au répartiteur.
La résolution DNS s'effectue lorsque le socket vers le
domaine original est créé pour la première fois. Lorsque la réutilisation
des connexions est activée, chaque domaine d'arrière-plan n'est résolu qu'une
seule fois pour chaque processus enfant, et cette résolution est mise en
cache pour toutes les connexions ultérieures jusqu'à ce que le processus enfant
soit recyclé. Ce comportement doit être pris en considération lorsqu'on
planifie des tâches de maintenance du DNS impactant les domaines
d'arrière-plan. Veuillez aussi vous reporter aux paramètres de la
directive ProxyPass pour plus de
détails à propos de la réutilisation des connexions.
Vous pouvez restreindre l'accès à votre mandataire via le bloc
de contrôle <Proxy> comme dans
l'exemple suivant :
<Proxy "*"> Require ip 192.168.0 </Proxy>
Pour plus de détails sur les directives de contrôle d'accès,
voir la documentation du module
mod_authz_host.
Restreindre l'accès de manière stricte est essentiel si vous
mettez en oeuvre un mandataire direct (en définissant la directive
ProxyRequests à "on").
Dans le cas contraire, votre serveur pourrait être utilisé par
n'importe quel client pour accéder à des serveurs quelconques,
tout en masquant sa véritable identité. Ceci représente un danger
non seulement pour votre réseau, mais aussi pour l'Internet au
sens large. Dans le cas de la mise en oeuvre d'un mandataire
inverse (en utilisant la directive ProxyPass avec ProxyRequests Off), le contrôle
d'accès est moins critique car les clients ne peuvent contacter
que les serveurs que vous avez spécifiés.
Voir aussi la variable d'environnement Proxy-Chain-Auth.
Si vous utilisez la directive ProxyBlock, les noms d'hôtes sont résolus en adresses
IP puis ces dernières mises en cache au cours du démarrage
à des fins de tests de comparaisons ultérieurs. Ce processus peut
durer plusieurs secondes (ou d'avantage) en fonction de la vitesse
à laquelle s'effectue la résolution des noms d'hôtes.
Un serveur mandataire Apache httpd situé à l'intérieur d'un Intranet
doit faire suivre les requêtes destinées à un serveur externe à
travers le pare-feu de l'entreprise (pour ce faire, définissez la
directive ProxyRemote de
façon à ce qu'elle fasse suivre le protocole concerné
vers le mandataire du pare-feu). Cependant, lorsqu'il doit accéder
à des ressources situées dans l'Intranet, il peut se passer du
pare-feu pour accéder aux serveurs. A cet effet, la directive
NoProxy permet de
spécifier quels hôtes appartiennent à l'Intranet et peuvent donc
être accédés directement.
Les utilisateurs d'un Intranet ont tendance à oublier le nom du
domaine local dans leurs requêtes WWW, et demandent par exemple
"http://un-serveur/" au lieu de
http://un-serveur.example.com/. Certains serveurs
mandataires commerciaux acceptent ce genre de requête et les
traitent simplement en utilisant un nom de domaine local
implicite. Lorsque la directive ProxyDomain est utilisée et si le
serveur est configuré comme
mandataire, Apache httpd peut renvoyer une réponse de redirection et
ainsi fournir au client l'adresse de serveur correcte,
entièrement qualifiée. C'est la méthode à privilégier car le
fichier des marque-pages de l'utilisateur contiendra alors des
noms de serveurs entièrement qualifiés.
Pour les cas où mod_proxy envoie des requêtes
vers un serveur qui n'implémente pas correctement les connexions
persistantes ou le protocole HTTP/1.1, il existe deux variables
d'environnement qui permettent de forcer les requêtes à utiliser
le protocole HTTP/1.0 avec connexions non persistantes. Elles
peuvent être définies via la directive SetEnv.
Il s'agit des variables force-proxy-request-1.0 et
proxy-nokeepalive.
<Location "/buggyappserver/"> ProxyPass "http://buggyappserver:7001/foo/" SetEnv force-proxy-request-1.0 1 SetEnv proxy-nokeepalive 1 </Location>
A partir de la version 2.4.26 du serveur HTTP Apache, la définition de
la variable d'environnement "no-proxy" permet de désactiver
mod_proxy dans le traitement de la requête courante.
Cette variable doit être définie via la directive SetEnvIf car la directive SetEnv n'est pas évaluée assez tôt.
Certaines méthodes de requêtes comme POST comportent un corps de
requête. Le protocole HTTP stipule que les requêtes qui comportent
un corps doivent soit utiliser un codage de transmission
fractionnée (chunked transfer encoding), soit envoyer un en-tête de requête
Content-Length. Lorsqu'il fait suivre ce genre de
requête vers le serveur demandé, mod_proxy_http
s'efforce toujours d'envoyer l'en-tête Content-Length.
Par contre, si la taille du corps est importante, et si la requête
originale utilise un codage à fractionnement, ce dernier peut aussi
être utilisé dans la requête montante. Ce comportement peut être
contrôlé à l'aide de variables
d'environnement. Ainsi, si elle est définie, la variable
proxy-sendcl assure une compatibilité maximale avec les
serveurs demandés en imposant l'envoi de l'en-tête
Content-Length, alors que
proxy-sendchunked diminue la consommation de ressources
en imposant l'utilisation d'un codage à fractionnement.
Dans certaines circonstances, le serveur doit mettre en file d'attente sur disque les corps de requêtes afin de satisfaire le traitement demandé des corps de requêtes. Par exemple, cette mise en file d'attente se produira si le corps original a été envoyé selon un codage morcelé (et possède une taille importante), alors que l'administrateur a demandé que les requêtes du serveur d'arrière-plan soient envoyées avec l'en-tête Content-Length ou en HTTP/1.0. Cette mise en file d'attente se produira aussi si le corps de la requête contient déjà un en-tête Content-Length, alors que le serveur est configuré pour filtrer les corps des requêtes entrantes.
Lorsqu'il est configuré en mode mandataire inverse (en utilisant
par exemple la directive ProxyPass),
mod_proxy_http ajoute plusieurs en-têtes de requête
afin de transmettre des informations au serveur demandé. Ces
en-têtes sont les suivants :
X-Forwarded-ForX-Forwarded-HostHost.X-Forwarded-ServerCes en-têtes doivent être utilisés avec précautions sur le
serveur demandé, car ils contiendront plus d'une valeur (séparées
par des virgules) si la requête originale contenait déjà un de ces
en-têtes. Par exemple, vous pouvez utiliser
%{X-Forwarded-For}i dans la chaîne de format du journal
du serveur demandé pour enregistrer les adresses IP des clients
originaux, mais il est possible que vous obteniez plusieurs adresses
si la requête passe à travers plusieurs mandataires.
Voir aussi les directives ProxyPreserveHost et ProxyVia directives, qui permettent
de contrôler d'autres en-têtes de requête.
Note : Si vous devez ajouter des en-têtes particuliers à la
requête mandatée, utilisez la directive RequestHeader.
| Description: | Nombre de membres supplémentaires pouvant être ajoutés après la configuration initiale |
|---|---|
| Syntaxe: | BalancerGrowth # |
| Défaut: | BalancerGrowth 5 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | BalancerGrowth est disponible depuis la version 2.3.13 du serveur HTTP Apache |
Cette directive permet de définir le nombre de membres pouvant être ajoutés au groupe de répartition de charge préconfiguré d'un serveur virtuel. Elle n'est active que si le groupe a été préconfiguré avec un membre au minimum.
| Description: | Héritage des membres du groupes de répartition de charge du mandataire définis au niveau du serveur principal |
|---|---|
| Syntaxe: | BalancerInherit On|Off |
| Défaut: | BalancerInherit On |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache. |
Cette directive permet d'attribuer au serveur virtuel courant l'héritage des membres de groupes de répartition de charge définis au niveau du serveur principal. Elle ne doit pas être activée si vous utilisez la fonctionnalité de modifications dynamiques du gestionnaire de répartition de charge (Balancer Manager) pour éviter des problèmes et des comportements inattendus.
Les définitions au niveau du serveur principal constituent les définitions par défaut au niveau des serveurs virtuels.
| Description: | Ajoute un membre à un groupe de répartition de charge |
|---|---|
| Syntaxe: | BalancerMember [balancerurl] url [clé=valeur [clé=valeur ...]] |
| Contexte: | répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Disponible depuis la version 2.2 du serveur HTTP Apache. |
Cette directive permet d'ajouter un membre à un groupe de
répartition de charge. Elle peut se trouver dans un conteneur
<Proxy balancer://...>, et accepte
tous les paramètres de paires clé/valeur que supporte la directive
ProxyPass.
La directive BalancerMember accepte un paramètre
supplémentaire : loadfactor. Il s'agit du facteur de
charge du membre - un nombre décimal entre 1.0 (valeur par défaut) et 100.0, qui
définit la charge à appliquer au membre en question.
L'argument balancerurl n'est requis que s'il ne se trouve pas
dèjà dans la directive de conteneur <Proxy
balancer://...>. Il correspond à l'URL d'un
répartiteur de charge défini par une directive ProxyPass.
La partie chemin de l'URL du répartiteur dans toute directive de
conteneur <Proxy balancer://...> est
ignorée.
En particulier, le slash de fin de l'URL d'un
BalancerMember doit être supprimé.
| Description: | Tente de conserver les changements effectués par le gestionnaire de répartition de charge après un redémarrage du serveur. |
|---|---|
| Syntaxe: | BalancerPersist On|Off |
| Défaut: | BalancerPersist Off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | BalancerPersist n'est disponible qu'à partir de la version 2.4.4 du serveur HTTP Apache. |
Cette directive permet de conserver le contenu de l'espace mémoire partagé associé aux répartiteurs de charge et à leurs membres après un redémarrage du serveur. Ces modifications locales ne sont ainsi pas perdues lors des transitions d'état dues à un redémarrage.
| Description: | Serveurs, domaines ou réseaux auquels on se connectera directement |
|---|---|
| Syntaxe: | NoProxy domaine [domaine] ... |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
Cette directive n'a d'utilité que pour les serveurs mandataires
Apache httpd au sein d'Intranets. La directive
NoProxy permet de spécifier une liste de
sous-réseaux, d'adresses IP, de serveurs et/ou de domaines séparés
par des espaces. Une requête pour un serveur qui correspond à un ou
plusieurs critères sera toujours servie par ce serveur directement,
sans être redirigée vers le(s) serveur(s) mandataire(s) défini(s) par
la directive ProxyRemote.
ProxyRemote "*" "http://firewall.example.com:81" NoProxy ".example.com" "192.168.112.0/21"
Le type des arguments serveur de la directive
NoProxy appartiennent à la liste suivante
:
Un domaine est ici un nom de domaine DNS partiellement qualifié précédé d'un point. Il représente une liste de serveurs qui appartiennent logiquement au même domaine ou à la même zonz DNS (en d'autres termes, les nom des serveurs se terminent tous par domaine).
.com .example.org.
Pour faire la distinction entre domaines et nom d'hôtes (des points de vue à la fois syntaxique et sémantique, un domaine DNS pouvant aussi avoir un enregistrement DNS de type A !), les domaines sont toujours spécifiés en les préfixant par un point.
Les comparaisons de noms de domaines s'effectuent sans tenir
compte de la casse, et les parties droites des Domaines
sont toujours censées correspondre à la racine de l'arborescence
DNS, si bien que les domaines .ExEmple.com et
.exemple.com. (notez le point à la fin du nom) sont
considérés comme identiques. Comme une comparaison de domaines ne
nécessite pas de recherche DNS, elle est beaucoup plus efficace
qu'une comparaison de sous-réseaux.
Un Sous-réseau est une adresse internet partiellement qualifiée sous forme numérique (quatre nombres séparés par des points), optionnellement suivie d'un slash et du masque de sous-réseau spécifiant le nombre de bits significatifs dans le Sous-réseau. Il représente un sous-réseau de serveurs qui peuvent être atteints depuis la même interface réseau. En l'absence de masque de sous-réseau explicite, il est sous-entendu que les digits manquants (ou caractères 0) de fin spécifient le masque de sous-réseau (Dans ce cas, le masque de sous-réseau ne peut être qu'un multiple de 8). Voici quelques exemples :
192.168 ou 192.168.0.0255.255.0.0)192.168.112.0/21192.168.112.0/21 avec un masque de
sous-réseau implicite de 21 bits significatifs (parfois exprimé
sous la forme255.255.248.0)Comme cas extrêmes, un Sous-réseau avec un masque de sous-réseau de 32 bits significatifs est équivalent à une adresse IP, alors qu'un Sous-réseau avec un masque de sous-réseau de 0 bit significatif (c'est à dire 0.0.0.0/0) est identique à la constante _Default_, et peut correspondre à toute adresse IP.
Une Adresse IP est une adresse internet pleinement qualifiée sous forme numérique (quatre nombres séparés par des points). En général, cette adresse représente un serveur, mais elle ne doit pas nécessairement correspondre à un nom de domaine DNS.
192.168.123.7
Une Adresse IP ne nécessite pas de résolution DNS, et peut ainsi s'avérer plus efficace quant aux performances d'Apache.
Un Nom de serveur est un nom de domaine DNS pleinement qualifié qui peut être résolu en une ou plusieurs adresses IP par le service de noms de domaines DNS. Il représente un hôte logique (par opposition aux Domaines, voir ci-dessus), et doit pouvoir être résolu en une ou plusieurs adresses IP (ou souvent en une liste d'hôtes avec différentes adresses IP).
prep.ai.example.edu
www.example.org
Dans de nombreuses situations, il est plus efficace de spécifier une adresse IP qu'un Nom de serveur car cela évite d'avoir à effectuer une recherche DNS. La résolution de nom dans Apache httpd peut prendre un temps très long lorsque la connexion avec le serveur de noms utilise une liaison PPP lente.
Les comparaisons de Nom de serveur s'effectuent sans tenir
compte de la casse, et les parties droites des Noms de serveur
sont toujours censées correspondre à la racine de l'arborescence
DNS, si bien que les domaines WWW.ExEmple.com et
www.example.com. (notez le point à la fin du nom) sont
considérés comme identiques.
| Description: | Conteneur de directives s'appliquant à des ressources mandatées |
|---|---|
| Syntaxe: | <Proxy url-avec-jokers> ...</Proxy> |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
Les directives situées dans une section <Proxy> ne s'appliquent qu'au contenu
mandaté concerné. Les jokers de style shell sont autorisés.
Par exemple, les lignes suivantes n'autoriseront à accéder à un
contenu via votre serveur mandataire que les hôtes appartenant à
votre-reseau.example.com :
<Proxy "*"> Require host votre-reseau.example.com </Proxy>
Dans l'exemple suivant, tous les fichiers du répertoire
foo de example.com seront traités par le
filtre INCLUDES lorsqu'ils seront envoyés par
l'intermédiaire du serveur mandataire :
<Proxy "http://example.com/foo/*"> SetOutputFilter INCLUDES </Proxy>
Une URL d'arrière-plan sera concernée par le conteneur Proxy si
elle commence par la url-avec-jokers, même si le
dernier segment de chemin de la directive ne correspond qu'à un
préfixe de segment dee chemin de l'URL d'arrière-plan. Par exemple, <Proxy
"http://example.com/foo"> correspondra entre autres aux URLs
http://example.com/foo, http://example.com/foo/bar, et
http://example.com/foobar. La correspondance de l'URL finale
diffère du comportement de la section <Location> qui, pour le cas de cette note,
traitera le segment de chemin final comme s'il se terminait par un
slash.
Pour un contrôle plus fin de la correspondance des URL, voir la
directive <ProxyMatch>.
| Description: | Transmission du message "100-continue" au serveur d'origine |
|---|---|
| Syntaxe: | Proxy100Continue Off|On |
| Défaut: | Proxy100Continue On |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Disponible à partir de la version 2.4.40 du serveur HTTP Apache |
Cette directive permet de contrôler le transfert par le mandataire du message "100-continue" (Expect:ation) vers le serveur d'origine. Si elle est définie à "On", le serveur d'origine décidera lui-même si le corps de la requête HTTP doit être lu. Si elle est définie à "Off", le mandataire générera lui-même une réponse intermédiaire 100 Continue avant de transférer le corps de la requête.
Cette option n'est utilisable qu'avec les mandataires HTTP gérés par
mod_proxy_http.
| Description: | Ajoute des informations à propos du mandataire aux en-têtes X-Forwarded-* |
|---|---|
| Syntaxe: | ProxyAddHeaders Off|On |
| Défaut: | ProxyAddHeaders On |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Disponible depuis la version 2.3.10 |
Cette directive permet de passer au serveur d'arrière-plan des informations à propos du mandataire via les en-têtes HTTP X-Forwarded-For, X-Forwarded-Host et X-Forwarded-Server.
Cette option n'est utile que dans le cas du mandat HTTP traité
par mod_proxy_http.
| Description: | Détermine la manière de traiter les lignes d'en-tête incorrectes d'une réponse |
|---|---|
| Syntaxe: | ProxyBadHeader IsError|Ignore|StartBody |
| Défaut: | ProxyBadHeader IsError |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
La directive ProxyBadHeader permet de
déterminer le comportement de mod_proxy lorsqu'il
reçoit des lignes d'en-tête de réponse dont la syntaxe n'est pas valide (c'est
à dire ne contenant pas de caractère ':') en provenance du serveur
original. Les arguments disponibles sont :
IsErrorIgnoreStartBody| Description: | Termes, serveurs ou domaines bloqués par le mandataire |
|---|---|
| Syntaxe: | ProxyBlock *|terme|serveur|domaine
[terme|serveur|domaine] ... |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
La directive ProxyBlock permet de
spécifier une liste de termes, serveurs et/ou domaines, séparés par
des espaces. Les requêtes de documents HTTP, HTTPS, FTP vers des
sites dont les noms contiennent des termes, noms de serveur ou
domaine correspondants seront bloqués par le serveur
mandataire. La module proxy va aussi tenter de déterminer les
adresses IP des éléments de la liste qui peuvent correspondre à des
noms d'hôtes au cours du démarrage, et les mettra en cache à des
fins de comparaisons ultérieures. Ceci peut ralentir le démarrage du
serveur.
ProxyBlock "news.example.com" "auctions.example.com" "friends.example.com"
Notez qu'example suffirait aussi pour atteindre
ces sites.
Hosts conviendrait aussi s'il était référencé par adresse IP.
Notez aussi que
ProxyBlock "*"
bloque les connexions vers tous les sites.
| Description: | Nom de domaine par défaut pour les requêtes mandatées |
|---|---|
| Syntaxe: | ProxyDomain Domaine |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
Cette directive n'a d'utilité que pour les serveurs mandataires
Apache httpd au sein d'un Intranet. La directive
ProxyDomain permet de spécifier le domaine
par défaut auquel le serveur mandataire apache appartient. Si le
serveur reçoit une requête pour un hôte sans nom de domaine, il va
générer une réponse de redirection vers le même hôte suffixé par le
Domaine spécifié.
ProxyRemote "*" "http://firewall.example.com:81" NoProxy ".example.com" "192.168.112.0/21" ProxyDomain ".example.com"
| Description: | Outrepasser les pages d'erreur pour les contenus mandatés |
|---|---|
| Syntaxe: | ProxyErrorOverride Off|On [code ...] |
| Défaut: | ProxyErrorOverride Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | La liste de codes d'états a été ajoutée à partir de la version 2.4.47 du serveur HTTP Apache. |
Cette directive est utile pour les configurations de mandataires
inverses, lorsque vous souhaitez que les pages d'erreur envoyées
aux utilisateurs finaux présentent un aspect homogène. Elle permet
aussi l'inclusion de fichiers (via les SSI de
mod_include) pour obtenir le code d'erreur et agir
en conséquence (le comportement par défaut afficherait la page
d'erreur du serveur mandaté, alors que c'est le message d'erreur SSI
qui sera affiché si cette directive est à "on").
Cette directive n'affecte pas le traitement des réponses informatives (1xx), de type succès normal (2xx), ou de redirection (3xx).
Par défaut, ProxyErrorOverride affecte toutes les
réponses avec un code compris entre 400 inclus et 600 exclus.
ProxyErrorOverride On
Pour n'affecter que les réponses possèdant certains codes d'état particuliers, vous pouvez spécifier ces derniers sous la forme d'une liste en les séparant par des espaces. Les réponses dont le code d'état ne fait pas partie de la liste ne seront pas affectées. Vous ne pouvez spécifier que des codes d'erreurs, donc compris entre 400 inclus et 600 exclus.
ProxyErrorOverride On 403 405 500 501 502 503 504
| Description: | Détermine la taille du tampon interne de transfert de données |
|---|---|
| Syntaxe: | ProxyIOBufferSize octets |
| Défaut: | ProxyIOBufferSize 8192 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
La directive ProxyIOBufferSize permet
d'ajuster la taille du tampon interne utilisé comme bloc-note pour
les transferts de données entre entrée et sortie. La taille minimale
est de 512 octets.
Dans la plupart des cas, il n'y a aucune raison de modifier cette valeur.
Si elle est utilisée avec AJP, cette directive permet de définir
la taille maximale du paquet AJP en octets. Si la valeur spécifiée
est supérieure à 65536, elle est corrigée et prend la valeur 65536.
Si vous ne conservez pas
la valeur par défaut, vous devez aussi modifier l'attribut
packetSize de votre connecteur AJP du côté de Tomcat !
L'attribut packetSize n'est disponible que dans Tomcat
5.5.20+ et 6.0.2+.
Il n'est normalement pas nécessaire de modifier la taille maximale du paquet. Des problèmes ont cependant été rapportés avec la valeur par défaut lors de l'envoi de certificats ou de chaînes de certificats.
| Description: | Conteneur de directives s'appliquant à des ressources mandatées correspondant à une expression rationnelle |
|---|---|
| Syntaxe: | <ProxyMatch regex> ...</ProxyMatch> |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
La directive <ProxyMatch> est
identique à la directive <Proxy>, à l'exception qu'elle définit
les URLs auxquelles elle s'applique en utilisant une expression rationnelle.
A partir de la version 2.4.8, les groupes nommés et les
références arrières sont extraits et enregistrés dans
l'environnement avec leur nom en majuscules et préfixé par "MATCH_". Ceci permet
de référencer des URLs dans des expressions
ou au sein de modules comme mod_rewrite. Pour
éviter toute confusion, les références arrières numérotées (non
nommées) sont ignorées. Vous devez utiliser à la place des groupes
nommés.
<ProxyMatch "^http://(?<sitename>[^/]+)">
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</ProxyMatch>
| Description: | Nombre maximum de mandataires à travers lesquelles une requête peut être redirigée |
|---|---|
| Syntaxe: | ProxyMaxForwards nombre |
| Défaut: | ProxyMaxForwards -1 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Comportement par défaut modifié dans 2.2.7 |
La directive ProxyMaxForwards permet de
spécifier le nombre maximum de mandataires à travers lesquels une
requête peut passer dans le cas où la la requête ne contient pas
d'en-tête Max-Forwards. Ceci permet de se prémunir
contre les boucles infinies de mandataires ou contre les attaques de
type déni de service.
ProxyMaxForwards 15
Notez que la définition de la directive
ProxyMaxForwards constitue une violation du
protocole HTTP/1.1 (RFC2616), qui interdit à un mandataire de
définir Max-Forwards si le client ne l'a pas fait
lui-même. Les versions précédentes d'Apache httpd la définissaient
systématiquement. Une valeur négative de
ProxyMaxForwards, y compris la valeur par
défaut -1, implique un comportement compatible avec le protocole,
mais vous expose aux bouclages infinis.
| Description: | Référencer des serveurs distants depuis l'espace d'URLs du serveur local |
|---|---|
| Syntaxe: | ProxyPass [chemin] !|url [clé=valeur
[clé=valeur ...]] [nocanon] [interpolate] [noquery] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Les sockets de style Unix (Unix Domain Socket - UDS) sont supportés à partir de la version 2.4.7 du serveur HTTP Apache |
Cette directive permet de référencer des serveurs distants depuis l'espace d'URLs du serveur local. Le serveur local n'agit pas en tant que mandataire au sens conventionnel, mais plutôt comme miroir du serveur distant. Le serveur local est souvent nommé mandataire inverse ou passerelle. L'argument chemin est le nom d'un chemin virtuel local ; url est une URL partielle pour le serveur distant et ne doit pas contenir de chaîne d'arguments.
ProxyRequests doit être définie à
off lorsqu'on utilise la directive
ProxyPass.Les sockets de style Unix sont supportés à partir de la version
2.4.7 du serveur HTTP Apache ; pour utiliser cette fonctionnalité,
il suffit d'utiliser une URL cible préfixée par
unix:/path/lis.sock|. Par exemple, pour mandater HTTP
et cibler l'UDS /home/www.socket, vous devez utiliser
unix:/home/www.socket|http://localhost/whatever/.
unix: tient compte de la directive
DefaultRuntimeDir.Lorsque cette directive est utilisée dans une section <Location>, le premier
argument est omis et le répertoire local est obtenu à partir de
l'argument de la directive <Location>. Il en est de même à l'intérieur
d'une section <LocationMatch>, mais le résultat ne sera
probablement pas celui attendu car ProxyPassReverse va interpréter
l'expression rationnelle littéralement comme un chemin ; si besoin
est dans ce cas, définissez la directive ProxyPassReverse en dehors
de la section, ou dans une section <Location> séparée.
Supposons que le serveur local a pour adresse
http://example.com/ ; alors la ligne
<Location "/mirror/foo/">
ProxyPass "http://backend.example.com/"
</Location>
va convertir en interne toute requête pour
http://example.com/mirror/foo/bar en une requête
mandatée pour http://backend.example.com/bar.
Si vous avez besoin d'un configuration de mandataire inverse plus
souple, reportez-vous à la documentaion de la directive RewriteRule et son drapeau
[P].
La syntaxe alternative suivante est valide, bien qu'elle puisse induire une dégradation des performances lorsqu'elle est présente en très grand nombre. Elle possède l'avantage de permettre un contrôle dynamique via l'interface Balancer Manager :
ProxyPass "/mirror/foo/" "http://backend.example.com/"
Si le premier argument se termine par un slash /, il doit en être de même pour le second argument et vice versa. Dans le cas contraire, il risque de manquer des slashes nécessaires dans la requête résultante vers le serveur d'arrière-plan et les résulats ne seront pas ceux attendus.
Le drapeau ! permet de soustraire un sous-répertoire
du mandat inverse, comme dans l'exemple suivant :
<Location "/mirror/foo/">
ProxyPass "http://backend.example.com/"
</Location>
<Location "/mirror/foo/i">
ProxyPass "!"
</Location>
ProxyPass "/mirror/foo/i" "!" ProxyPass "/mirror/foo" "http://backend.example.com"
va mandater toutes les requêtes pour /mirror/foo
vers backend.example.com, sauf les requêtes
pour /mirror/foo/i.
Mélanger plusieurs configurations ProxyPass dans différents contextes ne fonctionne pas :
ProxyPass "/mirror/foo/i" "!"
<Location "/mirror/foo/">
ProxyPass "http://backend.example.com/"
</Location>
Dans ce cas, une requête pour /mirror/foo/i sera tout de
même mandatée car c'est la directive ProxyPass de la
section Location qui sera évaluée en premier. Le fait que la directive
ProxyPass supporte les deux contextes serveur
principal et répertoire ne signifie pas que sa portée et sa position dans le
fichier de configuration va garantir une quelconque priorité et/ou
chronologie de prise en compte.
Les directives ProxyPass et ProxyPassMatch sont évaluées dans
l'ordre de leur apparition dans le fichier de configuration. La
première règle qui correspond s'applique. Vous devez donc en
général classer les règles ProxyPass qui entrent en conflit de
l'URL la plus longue à la plus courte. Dans le cas contraire, les
règles situées après une règle dont l'URL correspond au début de
leur propre URL seront ignorées. Notez que tout ceci est en
relation avec le partage de workers.
On ne peut placer
qu'une seule directive ProxyPass dans une section
Location, et c'est la section
la plus spécifique qui l'emportera.
Les exclusions doivent se situer avant
les directives ProxyPass générales. A partir de la
version 2.4.26 du serveur HTTP Apache, la variable
d'environnement "no-proxy" est une alternative aux exclusions et constitue
le seul moyen de configurer une exclusion pour une directive
ProxyPass dans le contexte d'une section Location. Cette variable doit être définie via
la directive SetEnvIf car la
directive SetEnv n'est pas évaluée
assez tôt.
ProxyPass clé=valeur Paramètres
Depuis la version 2.1 du serveur HTTP Apache, mod_proxy supporte
les groupements de connexions vers un serveur d'arrière-plan. Les
connexions créées à la demande peuvent être enregistrées dans un
groupement pour une utilisation ultérieure. La taille du groupe
ainsi que d'autres caractéristiques peuvent être définies via la
directive ProxyPass au moyen de paramètres
clé=valeur dont la description fait l'objet des
tableaux ci-dessous.
Par défaut, mod_proxy permet et met en réserve le
nombre maximum de connexions pouvant être utilisées simultanément par le
processus enfant concerné du serveur web. Le paramètre max
permet de réduire cette valeur par défaut. Le jeu de connexions est maintenu
au niveau de chaque processus enfant du serveur web, max et les
autres réglages n'étant pas coordonnés entre ces différents processus, sauf
bien entendu lorsqu'un seul processus enfant n'est autorisé par la
configuration ou le MPM utilisé.
Le paramètre ttl,
quant à lui, permet de définir une durée de vie optionnelle ; les
connexions qui n'ont pas été utilisées pendant au moins
ttl secondes seront fermées. ttl permet
aussi d'empêcher l'utilisation d'une connexion susceptible d'être
fermée suite à une fin de vie de connexion persistante sur le
serveur d'arrière-plan.
ProxyPass "/example" "http://backend.example.com" max=20 ttl=120 retry=300
| Paramètres de worker (directive BalancerMember) |
|---|
| Paramètre | Défaut | Description | |||||||
|---|---|---|---|---|---|---|---|---|---|
| min | 0 | Nombre minimum d'entrées dans le pool de connexions, distinct du nombre de connexions effectif. La valeur par défaut ne doit être modifiée que dans des circonstances particulières où la mémoire associée aux connexions avec le serveur d'arrière-plan doit être préallouée ou réservée dans le tas. | |||||||
| max | 1...n | Nombre maximum de connexions autorisées vers le serveur
d'arrière-plan. La valeur par défaut correspond au nombre de
threads par processus pour le MPM (Module Multi Processus)
actif. La valeur sera toujours 1 pour le MPM Prefork, alors
qu'elle dépendra de la définition de la directive
ThreadsPerChild pour les autres MPMs. | |||||||
| smax | max | Les entrées du pool de connexions conservées au delà de
cette limite sont libérées au cours de certaines opérations si
elles n'ont pas été utilisées au cours de leur durée de vie,
définie par le paramètre ttl. Si l'entrée du pool
de connexions est associée à une connexion, cette dernière sera
fermée. La valeur par défaut ne doit être modifiée que dans des
circonstances particulières où les entrées du pool de connexions
et toutes connexions associées qui ont dépassé leur durée de vie
doivent être libérées ou fermées de manière plus autoritaire. | |||||||
| acquire | - | Cette clé permet de définir le délai maximum d'attente pour
une connexion libre dans le jeu de connexions, en millisecondes.
S'il n'y a pas de connexion libre dans le jeu, Apache httpd renverra
l'état SERVER_BUSY au client.
| |||||||
| connectiontimeout | timeout | Délai d'attente d'une connexion en secondes. La durée en secondes pendant laquelle Apache httpd va attendre pour l'établissement d'une connexion vers le serveur d'arrière-plan. Le délai peut être spécifié en millisecondes en ajoutant le suffixe ms. | |||||||
| disablereuse | Off | Vous pouvez utiliser cette clé pour forcer mod_proxy à
fermer immédiatement une connexion vers le serveur
d'arrière-plan après utilisation, et ainsi désactiver le jeu de
connexions permanentes vers ce serveur. Ceci peut s'avérer utile
dans des situations où un pare-feu situé entre Apache httpd et le
serveur d'arrière-plan (quelque soit le protocole) interrompt
des connexions de manière silencieuse, ou lorsque le serveur
d'arrière-plan lui-même est accessible par rotation de DNS
(round-robin DNS). Lorsque la réutilisation des connexions est activée,
chaque domaine d'arrière-plan n'est résolu (via une requête DNS) qu'une
seule fois par chaque processus enfant et mis en cache pour toutes les
connexions ultérieures jusqu'au recyclage du processus concerné.
Pour désactiver la réutilisation du jeu de
connexions, définissez cette clé à On.
| |||||||
| enablereuse | On | Ce paramètre est utilisé par les gestionnaires de protocole pour
lesquels la réutilisation des connexions est optionnelle (comme
mod_proxy_fcgi). C'est le contraire du
paramètre 'disablereuse' ci-dessus, et il est supporté par les
versions 2.4.11 et supérieures du serveur HTTP Apache.
| |||||||
| flushpackets | off | Permet de définir si le module mandataire doit vider automatiquement le tampon de sortie après chaque tronçon de données. 'off' signifie que le tampon sera vidé si nécessaire ; 'on' signifie que le tampon sera vidé après chaque envoi d'un tronçon de données, et 'auto' que le tampon sera vidé après un délai de 'flushwait' millisecondes si aucune entrée n'est reçue. Actuellement, cette clé n'est supportée que par mod_proxy_ajp et mod_proxy_fcgi. | |||||||
| flushwait | 10 | Le délai d'attente pour une entrée additionnelle, en millisecondes, avant le vidage du tampon en sortie dans le cas où 'flushpackets' est à 'auto'. | |||||||
| iobuffersize | 8192 | Permet de définir la taille du tampon d'entrées/sorties du
bloc-notes interne. Cette clé vous permet d'outrepasser la
directive ProxyIOBufferSize pour un
serveur cible spécifique. La valeur doit être au minimum 512 ou définie
à 0 pour la valeur par défaut du système de 8192.
| |||||||
| responsefieldsize | 8192 | Contrôle la taille du tampon pour le champ de la réponse mandatée.
Cette taille doit être au moins égale à la taille attendue du plus grand
en-tête d'une réponse mandatée. Une valeur de 0 implique l'utilisation
de la valeur par défaut du système, à savoir 8192 octets. Disponible à partir de la version 2.4.34 du serveur HTTP Apache. | |||||||
| keepalive | Off | Cette clé doit être utilisée lorsque vous avez un pare-feu
entre Apache httpd et le serveur d'arrière-plan, et si ce dernier tend
à interrompre les connexions inactives. Cette clé va faire en
sorte que le système d'exploitation envoie des messages
La fréquence de vérification des connexions TCP persistantes initiale et subséquentes dépend de la configuration globale de l'OS, et peut atteindre 2 heures. Pour être utile, la fréquence configurée dans l'OS doit être inférieure au seuil utilisé par le pare-feu. | |||||||
| lbset | 0 | Définit le groupe de répartition de charge dont le serveur cible est membre. Le répartiteur de charge va essayer tous les membres d'un groupe de répartition de charge de numéro inférieur avant d'essayer ceux dont le groupe possède un numéro supérieur. | |||||||
| ping | 0 | Avec la clé Ping, le serveur web va "tester" la connexion
vers le serveur d'arrière-plan avant de transmettre la requête.
Avec AJP, mod_proxy_ajp envoie une requête
CPING sur la connexion ajp13 (implémenté sur Tomcat
3.3.2+, 4.1.28+ et 5.0.13+). Avec HTTP,
mod_proxy_http envoie 100-Continue
au serveur d'arrière-plan (seulement avecHTTP/1.1 - pour les
serveurs d'arrière-plan non HTTP/1.1, cette clé ne produit
aucun effet). Dans les deux cas, ce paramètre correspond au
délai en secondes pour l'attente de la réponse. Cette
fonctionnalité a été ajoutée pour éviter les problèmes avec les
serveurs d'arrière-plan bloqués ou surchargés.
Le trafic
réseau peut s'en trouver augmenté en fonctionnement normal, ce
qui peut poser problème, mais peut s'en trouver diminué dans les
cas où les noeuds de cluster sont arrêtés ou
surchargés. Le délai peut
aussi être défini en millisecondes en ajoutant le suffixe
ms.
| |||||||
| receivebuffersize | 0 | Définit la taille du tampon réseau explicite (TCP/IP) pour
les connexions mandatées. Cette clé vous permet d'outrepasser la
directive ProxyReceiveBufferSize pour un
serveur cible spécifique. Sa valeur doit être au minimum 512 ou définie
à 0 pour la valeur par défaut du système.
| |||||||
| redirect | - | Route pour la redirection du serveur cible. Cette valeur est en général définie dynamiquement pour permettre une suppression sécurisée du noeud du cluster. Si cette clé est définie, toutes les requêtes sans identifiant de session seront redirigées vers le membre de groupe de répartition de charge dont la route correspond à la valeur de la clé. | |||||||
| retry | 60 | Délai entre deux essais du serveur cible du jeu de connexions en secondes. Si le serveur cible du jeu de connexions vers le serveur d'arrière-plan est dans un état d'erreur, Apache httpd ne redirigera pas de requête vers ce serveur avant l'expiration du délai spécifié. Ceci permet d'arrêter le serveur d'arrière-plan pour maintenance, et de le remettre en ligne plus tard. Une valeur de 0 implique de toujours essayer les serveurs cibles dans un état d'erreur sans délai. | |||||||
| route | - | La route du serveur cible lorsqu'il est utilisé au sein d'un répartiteur de charge. La route est une valeur ajoutée à l'identifiant de session. | |||||||
| status | - | Valeur constituée d'une simple lettre et définissant l'état
initial de ce serveur cible.
| |||||||
| timeout | ProxyTimeout |
Délai d'attente du socket en secondes. Le nombre de secondes pendant lesquelles Apache httpd attend l'envoi de données vers le serveur d'arrière-plan. | |||||||
| ttl | - | Durée de vie des connexions inactives et des entrées du pool de connexions associées en secondes. Une fois cette limite atteinte, une connexion ne sera pas réutilisée ; elle sera fermée après un délai variable. | |||||||
| flusher | flush | Nom du fournisseur utilisé par | |||||||
| secret | - | Le mot de passe utilisé par mod_proxy_ajp. Il doit
identique au mot de passe configuré sur le côté serveur de la connexion
AJP.Disponible à partir de la version 2.4.42 du serveur HTTP Apache. | |||||||
| upgrade | - | Protocole pris en charge par | |||||||
| mapping | - | Type de mappage entre le chemin et l'url.
Détermine la normalisation et/ou le (non-)décodage que
ProxyPass "/special%3Fsegment" "https://example.com/special%3Fsegment" mapping=encoded <Location "/special%3Fsegment"> Require ip 172.17.2.0/24 </Location>
ProxyPass "/some/path" "https://servlet.example.com/some/path" mapping=servlet <Location "/some/path"> Require valid-user </Location> NoteIl est recommandé d'utiliser le même mappage côté Apache httpd
que celui utilisé côté arrière-plan. Par exemple, lors de la
configuration des autorisations dans les sections
| |||||||
| addressttl | -1 | Durée de vie (TTL) en secondes des résolutions DNS de l'adresse du serveur d'arrière-plan dans le cache. -1 signifie jusqu'au redémarrage de Apache httpd. |
Si l'URL de la directive Proxy débute par
balancer:// (par exemple:
balancer://cluster, toute information relative au
chemin est ignorée), alors un serveur cible virtuel ne communiquant pas
réellement avec le serveur d'arrière-plan sera créé. Celui-ci sera
en fait responsable de la gestion de plusieurs serveurs cibles "réels". Dans
ce cas, un jeu de paramètres particuliers s'applique à ce serveur cible
virtuel. Voir mod_proxy_balancer pour plus
d'informations à propos du fonctionnement du répartiteur de
charge.
| Paramètres du répartiteur |
|---|
| Paramètre | Défaut | Description |
|---|---|---|
| lbmethod | byrequests | Méthode de répartition de charge utilisée. Permet de
sélectionner la méthode de planification de la répartition de
charge à utiliser. La valeur est soit byrequests,
pour effectuer un décompte de requêtes pondérées, soit
bytraffic, pour effectuer une répartition en
fonction du décompte des octets transmis, soit
bybusyness, pour effectuer une répartition en
fonction des requêtes en attente. La valeur par défaut est
byrequests.
|
| maxattempts | 1 de moins que le nombre de workers, ou 1 avec un seul worker | Nombre maximum d'échecs avant abandon. |
| nofailover | Off | Si ce paramètre est défini à On, la session va
s'interrompre si le serveur cible est dans un état d'erreur ou
désactivé. Définissez ce paramètre à On si le serveur
d'arrière-plan ne supporte pas la réplication de session.
|
| stickysession | - | Nom de session persistant du répartiteur. La valeur est
généralement du style JSESSIONID ou
PHPSESSIONID, et dépend du serveur d'application
d'arrière-plan qui supporte les sessions. Si le serveur
d'application d'arrière-plan utilise un nom différent pour
les cookies et les identifiants codés d'URL (comme les
conteneurs de servlet), séparez-les par le caractère '|'. La
première partie contient le cookie et la seconde le chemin.Disponible depuis la version 2.4.4 du serveur HTTP Apache. |
| stickysessionsep | "." | Définit le caractère de séparation dans le cookie de session. Certains serveurs d'application d'arrière-plan n'utilisent pas le caractère '.' comme séparateur. Par exemple le serveur Oracle Weblogic utilise le caractère '!'. Cette option permet d'attribuer au caractère de séparation la valeur appropriée. Si elle est définie à 'Off', aucun caractère de séparation n'est utilisé. |
| scolonpathdelim | Off | Si ce paramètre est défini à On, le caractère
';' sera utilisé comme séparateur de chemin de session
persistante additionnel. Ceci permet principalement de simuler
le comportement de mod_jk lorsqu'on utilise des chemins du style
JSESSIONID=6736bcf34;foo=aabfa.
|
| timeout | 0 | Délai du répartiteur en secondes. Si ce paramètre est défini, sa valeur correspond à la durée maximale d'attente pour un serveur cible libre. Le comportement par défaut est de ne pas attendre. |
| failonstatus | - | Une liste de codes d'état HTTP séparés par des virgules. Si ce paramètre est présent, le worker se mettra en erreur si le serveur d'arrière-plan renvoie un des codes d'état spécifiés dans la liste. La récupération du worker s'effectue comme dans le cas des autres erreurs de worker. |
| failontimeout | Off | Si ce paramètre est défini à "On", un délai d'attente
dépassé en entrée/sortie après envoi d'une requête au serveur
d'arrière-plan va mettre le processus en état d'erreur. La
sortie de cet état d'erreur se passe de la même façon que pour
les autres erreurs. Disponible à partir de la version 2.4.5 du serveur HTTP Apache. |
| nonce | <auto> | Le nombre à usage unique de protection utilisé dans la page
de l'application balancer-manager. Par défaut, la
protection de la page est assurée par un nombre à usage unique
automatique à base d'UUID. Si une valeur est précisée, elle sera
utilisée comme nombre à usage unique. La valeur
None désactive la vérification du nombre à usage
unique.
NoteEn plus du nombre à usage unique, la page de l'application
|
| growth | 0 | Nombre de membres supplémentaires que l'on peut ajouter à ce répartiteur en plus de ceux définis au niveau de la configuration. |
| forcerecovery | On | Force la relance immédiate de tous les membres sans tenir
compte de leur paramètre retry dans le cas où ils sont tous en
état d'erreur. Il peut cependant arriver qu'un membre déjà
surchargé entre dans une situation critique si la relance de
tous les membres est forcée sans tenir compte du paramètre retry
de chaque membre. Dans ce cas, définissez ce paramètre à
Off.Disponible depuis la version 2.4.2 du serveur HTTP Apache. |
Exemple de configuration d'un répartiteur de charge
ProxyPass "/special-area" "http://special.example.com" smax=5 max=10
ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofailover=On
<Proxy "balancer://mycluster">
BalancerMember "ajp://1.2.3.4:8009"
BalancerMember "ajp://1.2.3.5:8009" loadfactor=20
# Less powerful server, don't send as many requests there,
BalancerMember "ajp://1.2.3.6:8009" loadfactor=5
</Proxy>
La définition de remplaçants à chaud permet de s'assurer qu'un nombre déterminé de serveurs sera toujours disponible dans le jeu de serveurs cibles :
ProxyPass "/" "balancer://sparecluster/"
<Proxy balancer://sparecluster>
BalancerMember ajp://1.2.3.4:8009
BalancerMember ajp://1.2.3.5:8009
# Les serveurs ci-dessous sont des remplaçants à chaud. Pour chaque serveur
# ci-dessus qui viendrait à être inutilisable (maintenance, arrêt, non
# contactable, en erreur, etc...), un de ces remplaçants à chaud prendra sa
# place. Deux serveurs seront toujours disponibles pour traiter une requête
# (à moins qu'un ou plusieurs remplaçant à chaud soit lui aussi
# indisponible).
BalancerMember ajp://1.2.3.6:8009 status=+R
BalancerMember ajp://1.2.3.7:8009 status=+R
</Proxy>
Configuration d'un serveur cible de réserve qui ne sera utilisé que si aucun autre serveur cible ou remplaçant à chaud n'est disponible dans le jeu de serveurs cibles :
ProxyPass "/" "balancer://hotcluster/"
<Proxy "balancer://hotcluster">
BalancerMember "ajp://1.2.3.4:8009" loadfactor=1
BalancerMember "ajp://1.2.3.5:8009" loadfactor=2.25
# The server below is on hot standby
BalancerMember "ajp://1.2.3.6:8009" status=+H
ProxySet lbmethod=bytraffic
</Proxy>
Mots-clés additionnels de ProxyPass
Normalement, mod_proxy va mettre sous leur forme canonique les URLs traitées par ProxyPass. Mais ceci peut être incompatible avec certains serveurs d'arrière-plan, et en particulier avec ceux qui utilisent PATH_INFO. Le mot-clé optionnel nocanon modifie ce comportement et permet de transmettre le chemin d'URL sous sa forme brute au serveur d'arrière-plan. Notez que ceci peut affecter la sécurité de votre serveur d'arrière-plan, car la protection limitée contre les attaques à base d'URL que fournit le mandataire est alors supprimée.
Par défaut, mod_proxy inclut la chaîne de paramètres lors de la génération de la variable d'environnement SCRIPT_FILENAME. Le mot-clé optionnel noquery (disponible à partir de la version 2.4.1) permet d'exclure cette chaîne.
Lorsque la directive ProxyPass est utilisée à l'intérieur d'une
section <Location>, le premier argument est omis et le répertoire
local est obtenu à partir de la section <Location>. Il en sera de même dans une
section <LocationMatch> ; cependant, ProxyPass
n'interprète pas les expressions rationnelles, et il sera ici
nécessaire d'utiliser la directive
ProxyPassMatch à la place.
Cette directive ne peut pas être placée dans une section
<Directory> ou
<Files>.
Si vous avez besoin d'un configuration de mandataire inverse plus
souple, reportez-vous à la documentaion de la directive RewriteRule et son drapeau
[P].
Le mot-clé optionnel interpolate, en combinaison avec la directive
ProxyPassInterpolateEnv, permet à ProxyPass
d'interpoler les variables d'environnement à l'aide de la syntaxe
${VARNAME}. Notez que de nombreuses variables
d'environnement standard dérivées de CGI n'existeront pas lorsque
l'interpolation se produit ; vous devrez alors encore avoir avoir
recours à mod_rewrite pour des règles
complexes. Notez aussi que l'interpolation n'est supportée dans
la partie protocole/hostname/port d'une URL que pour les variables qui sont
disponibles au moment où la directive est interprétée (comme pour la
directive Define). La détermination
dynamique de ces champs peut être effectuée à l'aide de
mod_rewrite, et l'exemple suivant décrit comment utiliser
mod_rewrite pour définir dynamiquement le protocole à http
ou https :
RewriteEngine On
RewriteCond "%{HTTPS}" =off
RewriteRule "". "-" [E=protocol:http]
RewriteCond "%{HTTPS}" =on
RewriteRule "." "-" [E=protocol:https]
RewriteRule "^/mirror/foo/(.*)" "%{ENV:protocol}://backend.example.com/$1" [P]
ProxyPassReverse "/mirror/foo/" "http://backend.example.com/"
ProxyPassReverse "/mirror/foo/" "https://backend.example.com/"
Depuis la version 2.4.47 du serveur HTTP Apache, la promotion de
protocole (tunneling) peut être géré bout à bout par
mod_proxy_http en utilisant le paramètre upgrade.
Bout à bout signifie que la requête de promotion de protocole en
provenance du client/navigateur est tout d'abord transmise par
mod_proxy_http au serveur origine et que le protocole de
la connexion ne sera modifié (et « tunnelisé » par
mod_proxy_http) que si le serveur origine accepte/initie
la promotion (réponse HTTP 101 Switching Protocols). Si le
serveur origine renvoie une réponse différente,
mod_proxy_http continuera la transmission en utilisant
(et en forçant) le protocole HTTP habituel pour cette connexion.
Voir Promotion de protocole vers Websocket
(versions 2.4.47 et ultérieures) pour un exemple de configuration qui
utilisemod_proxy_http.
Avec les versions 2.4.46 et antérieures du serveur HTTP Apache (ou si
la directive ProxyWebsocketFallbackToProxyHttp
des versions 2.4.48 et ultérieures désactive la prise en charge par
mod_proxy_http), voir la documentation de
mod_proxy_wstunnel pour la méthode permettant de mandater
le protocole WebSocket.
| Description: | Héritage des directives ProxyPass définies au niveau du serveur principal |
|---|---|
| Syntaxe: | ProxyPassInherit On|Off |
| Défaut: | ProxyPassInherit On |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Disponible à partir de la version 2.4.5 du serveur HTTP Apache. |
Cette directive permet à un serveur virtuel d'hériter des
directives ProxyPass définies
au niveau du serveur principal. Si vous utilisez la fonctionnalité de
modifications dynamiques du Balancer Manager, cette directive peut
causer des problèmes et des comportements inattendus et doit donc
être désactivée.
Les valeurs définies au niveau du serveur principal constituent les valeurs par défaut pour tous les serveurs virtuels.
La désactivation de ProxyPassInherit désactive aussi la
directive BalancerInherit.
| Description: | Active l'interpolation des variables d'environnement dans les configurations de mandataires inverses |
|---|---|
| Syntaxe: | ProxyPassInterpolateEnv On|Off |
| Défaut: | ProxyPassInterpolateEnv Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Disponible depuis la version 2.2.9 d'Apache |
Cette directive, ainsi que l'argument interpolate des
directives ProxyPass,
ProxyPassReverse,
ProxyPassReverseCookieDomain et
ProxyPassReverseCookiePath, permet de
configurer dynamiquement un mandataire inverse à l'aide de
variables d'environnement, ces dernières pouvant être définies par un
autre module comme mod_rewrite. Elle affecte les
directives ProxyPass,
ProxyPassReverse,
ProxyPassReverseCookieDomain, et
ProxyPassReverseCookiePath, en leur indiquant
de remplacer la chaîne ${nom_var} dans les directives
de configuration par la valeur de la variable d'environnement
nom_var (si l'option interpolate est
spécifiée).
La partie protocole/hostname/port de ProxyPass
peut contenir des variables, mais seulement celles qui sont accessibles au
moment où la directive est interprétée (similairement à la directive
Define). Pour tous les autres cas,
utilisez plutôt mod_rewrite.
Laissez cette directive à off, à moins que vous n'en ayez réellemnt
besoin ! Par exemple, ajouter des variables à
ProxyPass peut entraîner l'utilisation des serveurs
d'arrière-plan de mod_proxy configurés par défaut, et ceux-ci ne permettent
pas un réglage fin comme la réutilisation des connexions, entre
autres...).
| Description: | Fait correspondre des serveurs distants dans l'espace d'URL du serveur local en utilisant des expressions rationnelles |
|---|---|
| Syntaxe: | ProxyPassMatch [regex] !|url [key=value
[key=value ...]] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Depuis la version 2.4.47, les paramètres key=value sont pris en compte lorsque le paramètre url contient des références arrières (voir note ci-dessous). |
Cette directive est identique à la directive ProxyPass, mais fait usage des
expressions rationnelles, au lieu d'une simple comparaison de
préfixes. L'expression rationnelle spécifiée est comparée à
l'url, et si elle correspond, le serveur va substituer
toute correspondance entre parenthèses dans la chaîne donnée et
l'utiliser comme nouvelle url.
Supposons que le serveur local a pour adresse
http://example.com/ ; alors
ProxyPassMatch "^(/.*\.gif)$" "http://backend.example.com/$1"
va provoquer la conversion interne de la requête locale
http://example.com/foo/bar.gif en une requête mandatée
pour http://backend.example.com/foo/bar.gif.
Le drapeau ! vous permet de ne pas mandater un
sous-répertoire donné.
Dans une section <LocationMatch>, le premier argument est
omis et l'expression rationnelle est obtenue à partir de la directive
<LocationMatch>.
Si vous avez besoin d'une configuration du mandataire inverse
plus flexible, voyez la directive RewriteRule avec le drapeau
[P].
Lorsque le paramètre URL n'utilise pas de références arrières dans l'expression rationnelle, l'URL originale sera ajoutée au paramètre URL.
key=value et url avec
références arrièresDepuis la version 2.4.47, les paramètres key=value ne sont
plus ignorés dans une directive ProxyPassMatch
lorsqu'on utilise une url contenant des références arrières.
Cependant, pour conserver le comportement précédent relatif à la
réutilisation/conservation des connexions d'arrière-plan (qui n'avaient
jamais été réutilisées auparavant pour ces URLs), les paramètres
enablereuse et disablereuse prendront dans ce cas
respectivement comme valeurs par défaut off et
on. Définir explicitement enablereuse=on permet
de réutiliser les connexions, sauf si des références
arrières se trouvent dans la partie authority (nom d'hôte
et/ou port) de l'url (cette condition est imposée depuis la
version 2.4.55 du serveur HTTP Apache et provoque un avertissement au
démarrage car ces URLs ne sont pas réutilisables sous cette forme).
Lors de la construction de l'URL cible de la règle, il convient de prendre en compte l'impact en matière de sécurité qu'aura le fait de permettre au client d'influencer le jeu d'URLs pour lesquelles votre serveur agira en tant que mandataire. Assurez-vous que la partie protocole://nom-serveur de l'URL soit fixe, ou ne permette pas au client de l'influencer induement.
| Description: | Ajuste l'URL dans les en-têtes de la réponse HTTP envoyée par un serveur mandaté en inverse |
|---|---|
| Syntaxe: | ProxyPassReverse [chemin] url
[interpolate] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
Cette directive permet de faire en sorte qu'Apache httpd ajuste l'URL
dans les en-têtes Location,
Content-Location et URI des réponses de
redirection HTTP. Ceci est essentiel lorsqu'Apache httpd est utilisé en
tant que mandataire inverse (ou passerelle), afin d'éviter de
court-circuiter le mandataire inverse suite aux redirections HTTP
sur le serveur d'arrière-plan qui restent derrière le mandataire
inverse.
Seuls les en-têtes de réponse HTTP spécialement mentionnés
ci-dessus seront réécrits. Apache httpd ne réécrira ni les autres en-têtes
de réponse, ni par défaut les références d'URLs dans les pages HTML. Cela
signifie que dans le cas où un contenu mandaté contient des
références à des URLs absolues, elles court-circuiteront le
mandataire. Pour réécrire un contenu HTML afin qu'il corresponde au
mandataire, vous devez charger et activer le module
mod_proxy_html.
chemin est le nom d'un chemin virtuel local.
url est une URL partielle pour le serveur distant. Ces
paramètres s'utilisent de la même façon qu'avec la
directive ProxyPass.
Supposons par exemple que le serveur local a pour adresse
http://example.com/ ; alors
ProxyPass "/mirror/foo/" "http://backend.example.com/" ProxyPassReverse "/mirror/foo/" "http://backend.example.com/" ProxyPassReverseCookieDomain "backend.example.com" "public.example.com" ProxyPassReverseCookiePath "/" "/mirror/foo/"
ne va pas seulement provoquer la conversion interne d'une requête
locale pour http://example.com/mirror/foo/bar en une
requête mandatée pour http://backend.example.com/bar
(la fonctionnalité fournie par ProxyPass). Il va
aussi s'occuper des redirections que le serveur
backend.example.com envoie lorsqu'il redirige
http://backend.example.com/bar vers
http://backend.example.com/quux. Apache
httpd corrige ceci en http://example.com/mirror/foo/quux
avant de faire suivre la redirection HTTP au client. Notez que le
nom d'hôte utilisé pour construire l'URL est choisi en respectant la
définition de la directive UseCanonicalName.
Notez que la directive ProxyPassReverse
peut aussi être utilisée en conjonction avec la
fonctionnalité de mandataire
(RewriteRule ... [P]) du module
mod_rewrite, car elle ne dépend pas d'une directive
ProxyPass
correspondante.
Le mot-clé optionnel interpolate, en combinaison avec la
directive ProxyPassInterpolateEnv,
permet l'interpolation des variables d'environnement spécifiées en utilisant
le format ${VARNAME} Notez que l'interpolation n'est pas
supportée dans la partie protocole d'une URL.
Lorsque cette directive est utilisée dans une section <Location>, le premier
argument est omis et le répertoire local est obtenu à partir de
l'argument de la directive <Location>. Il en est de même à l'intérieur
d'une section <LocationMatch>, mais le résultat ne sera
probablement pas celui attendu car ProxyPassReverse va interpréter
l'expression rationnelle littéralement comme un chemin ; si besoin
est dans ce cas, définissez la directive ProxyPassReverse en dehors
de la section, ou dans une section <Location> séparée.
Cette directive ne peut pas être placée dans une section
<Directory> ou
<Files>.
| Description: | Ajuste la chaîne correspondant au domaine dans les en-têtes Set-Cookie en provenance d'un serveur mandaté |
|---|---|
| Syntaxe: | ProxyPassReverseCookieDomain domaine-interne
domaine-public [interpolate] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
L'utilisation de cette directive est similaire à celle de la
directive ProxyPassReverse,
mais au lieu de réécrire des en-têtes qui contiennent des URLs, elle
réécrit la chaîne correspondant au domaine dans les en-têtes
Set-Cookie.
| Description: | Ajuste la chaîne correspondant au chemin dans les en-têtes Set-Cookie en provenance d'un serveur mandaté |
|---|---|
| Syntaxe: | ProxyPassReverseCookiePath chemin-interne
chemin-public [interpolate] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
Cette directive s'avère utile en conjonction avec la directive
ProxyPassReverse dans les
situations où les chemins d'URL d'arrière-plan correspondent à des
chemins publics sur le mandataire inverse. Cette directive permet de
réécrire la chaîne path dans les en-têtes
Set-Cookie. Si le début du chemin du cookie correspond à
chemin-interne, le chemin du cookie sera remplacé par
chemin-public.
Dans l'exemple fourni avec la directive ProxyPassReverse, la directive :
ProxyPassReverseCookiePath "/" "/mirror/foo/"
va réécrire un cookie possédant un chemin d'arrière-plan /
(ou /example ou en fait tout chemin)
en /mirror/foo/..
| Description: | Utilise l'en-tête de requête entrante Host pour la requête du mandataire |
|---|---|
| Syntaxe: | ProxyPreserveHost On|Off |
| Défaut: | ProxyPreserveHost Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Utilisable dans un contexte de répertoire depuis la version 2.3.3. |
Lorsqu'elle est activée, cette directive va transmettre l'en-tête
Host: de la requête entrante vers le serveur mandaté, au lieu
du nom d'hôte spécifié par la directive ProxyPass.
Cette directive est habituellement définie à Off.
Elle est principalement utile dans les configurations particulières
comme l'hébergement virtuel mandaté en masse à base de nom, où
l'en-tête Host d'origine doit être évalué par le serveur
d'arrière-plan.
| Description: | Taille du tampon réseau pour les connexions mandatées HTTP et FTP |
|---|---|
| Syntaxe: | ProxyReceiveBufferSize octets |
| Défaut: | ProxyReceiveBufferSize 0 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
La directive ProxyReceiveBufferSize permet
de spécifier une taille de tampon réseau explicite (TCP/IP) pour les
connexions mandatées HTTP et FTP, afin d'améliorer le débit de
données. Elle doit être supérieure à 512 ou définie à
0 pour indiquer que la taille de tampon par défaut du
système doit être utilisée.
ProxyReceiveBufferSize 2048
| Description: | Mandataire distant à utiliser pour traiter certaines requêtes |
|---|---|
| Syntaxe: | ProxyRemote match remote-server [username:password] |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Le troisième argument facultatif est disponible depuis la version 2.4.59 du serveur HTTP Apache. |
Cette directive permet de définir des mandataires distants pour
ce mandataire. match est soit le nom d'un protocole
que supporte le serveur distant, soit une URL partielle pour
laquelle le serveur distant devra être utilisé, soit *
pour indiquer que le serveur distant doit être utilisé pour toutes
les requêtes. remote-server est une URL partielle
correspondant au serveur distant. Syntaxe :
remote-server =
scheme://hostname[:port]
scheme est effectivement le protocole à utiliser
pour communiquer avec le serveur distant ; ce module ne supporte que
http et https. Lorsqu'on utilise
https, les requêtes sont redirigées par le mandataire
distant en utilisant la méthode HTTP CONNECT.
ProxyRemote "http://goodguys.example.com/" "http://mirrorguys.example.com:8000" ProxyRemote "*" "http://cleverproxy.localdomain" ProxyRemote "ftp" "http://ftpproxy.mydomain:8080"
Dans la dernière ligne de l'exemple, le mandataire va faire suivre les requêtes FTP, encapsulées dans une autre requête mandatée HTTP, vers un autre mandataire capable de les traiter.
Cette directive supporte aussi les configurations de mandataire inverse ; un serveur web d'arrière-plan peut être intégré dans l'espace d'URL d'un serveur virtuel, même si ce serveur est caché par un autre mandataire direct.
Le troisième argument optionnel username:password permet de spécifier des données d'authentification basiques à transmettre au mandataire distant défini. Ces données d'authentification seront toujoujours envoyées sans attendre que le mandataire distant n'effectue une demande d'authentification. La variable d'environnement Proxy-Chain-Auth n'est plus prise en compte si cet argument est utilisé.
| Description: | Le mandataire distant à utiliser pour traiter les requêtes correspondant à une expression rationnelle |
|---|---|
| Syntaxe: | ProxyRemoteMatch regex remote-server [username:password] |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Le troisième argument facultatif est disponible à partir de la version 2.4.59 du serveur HTTP Apache. |
La directive ProxyRemoteMatch est
identique à la directive ProxyRemote, à l'exception du
premier argument qui est une expression
rationnelle à mettre en correspondance avec l'URL de la
requête.
| Description: | Active la fonctionnalité (standard) de mandataire direct |
|---|---|
| Syntaxe: | ProxyRequests On|Off |
| Défaut: | ProxyRequests Off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
Cette directive permet d'activer/désactiver la fonctionnalité de
serveur mandataire direct d'Apache httpd. Définir ProxyRequests à
Off n'interdit pas l'utilisation de la directive
ProxyPass.
Pour une configuration typique de mandataire inverse ou
passerelle, cette directive doit être définie à
Off.
Afin d'activer la fonctionnalité de mandataire pour des sites
HTTP et/ou FTP, les modules mod_proxy_http et/ou
mod_proxy_ftp doivent également être chargés dans le
serveur.
Pour activer la fonctionnalité de mandataire sur les sites chiffrés en HTTPS, le module
mod_proxy_connect doit également être chargé dans le serveur.
N'activez pas la fonctionnalité de mandataire avec la directive
ProxyRequests avant
d'avoir sécurisé votre serveur. Les serveurs
mandataires ouverts sont dangereux non seulement pour votre
réseau, mais aussi pour l'Internet au sens large.
| Description: | Définit différents paramètres relatifs à la répartition de charge des mandataires et aux membres des groupes de répartition de charge |
|---|---|
| Syntaxe: | ProxySet url clé=valeur [clé=valeur ...] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | ProxySet n'est disponible que depuis la version 2.2 du serveur HTTP Apache. |
Cette directive propose une méthode alternative pour définir tout
paramètre relatif aux répartiteurs de charge et serveurs cibles de
mandataires normalement définis via la directive ProxyPass. Si elle se trouve dans un
conteneur <Proxy url de répartiteur|url de
serveur cible>, l'argument url n'est pas
nécessaire. Comme effet de bord, le répartiteur ou serveur cible respectif
est créé. Ceci peut s'avérer utile pour la mise en oeuvre d'un
mandataire inverse via une directive RewriteRule au lieu de ProxyPass.
<Proxy "balancer://hotcluster">
BalancerMember "http://www2.example.com:8080" loadfactor=1
BalancerMember "http://www3.example.com:8080" loadfactor=2
ProxySet lbmethod=bytraffic
</Proxy>
<Proxy "http://backend">
ProxySet keepalive=On
</Proxy>
ProxySet "balancer://foo" lbmethod=bytraffic timeout=15
ProxySet "ajp://backend:7001" timeout=15
Gardez à l'esprit qu'une même clé de paramètre peut avoir différentes significations selon qu'elle s'applique à un répartiteur ou à un serveur cible, et ceci est illustré par les deux exemples précédents où il est question d'un timeout.
| Description: | Définit l'adresse IP locale pour les connexions mandatées sortantes |
|---|---|
| Syntaxe: | ProxySourceAddress adresse |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Disponible depuis la version 2.3.9 |
Cette directive permet de définir une adresse IP locale spécifique à laquelle faire référence lors d'une connexion à un serveur d'arrière-plan.
| Description: | Affiche l'état du répartiteur de charge du mandataire dans mod_status |
|---|---|
| Syntaxe: | ProxyStatus Off|On|Full |
| Défaut: | ProxyStatus Off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
| Compatibilité: | Disponible depuis la version 2.2 d'Apache |
Cette directive permet de spécifier si les données d'état du
répartiteur de charge du mandataire doivent être affichées via la
page d'état du serveur du module mod_status.
L'argument Full produit le même effet que l'argument On.
| Description: | Délai d'attente réseau pour les requêtes mandatées |
|---|---|
| Syntaxe: | ProxyTimeout secondes |
| Défaut: | Valeur de la directive |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
Cette directive permet à l'utilisateur de spécifier un délai pour les requêtes mandatées. Ceci s'avère utile dans le cas d'un serveur d'applications lent et bogué qui a tendance à se bloquer, et si vous préférez simplement renvoyer une erreur timeout et abandonner la connexion en douceur plutôt que d'attendre jusqu'à ce que le serveur veuille bien répondre.
| Description: | Information fournie dans l'en-tête de réponse HTTP
Via pour les requêtes mandatées |
|---|---|
| Syntaxe: | ProxyVia On|Off|Full|Block |
| Défaut: | ProxyVia Off |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy |
Cette directive permet de contrôler l'utilisation de l'en-tête
HTTP Via: par le mandataire. Le but recherché est de
contrôler le flux des requêtes mandatées tout au long d'une chaîne
de serveurs mandataires. Voir RFC 2616 (HTTP/1.1),
section 14.45 pour une description des lignes d'en-tête
Via:.
Off, valeur par défaut, cette
directive n'effectue aucun traitement particulier. Si une requête ou
une réponse contient un en-tête Via:, il est transmis
sans modification.On, chaque requête ou réponse
se verra ajouter une ligne d'en-tête Via: pour le
serveur courant.Full, chaque ligne d'en-tête
Via: se verra ajouter la version du serveur Apache
httpd sous la forme d'un champ de commentaire Via:.Block, chaque requête
mandatée verra ses lignes d'en-tête Via: supprimées.
Aucun nouvel en-tête Via: ne sera généré.Serveur HTTP Apache Version 2.4
| Description: | Extension de mod_proxy pour le traitement
des requêtes CONNECT |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_connect_module |
| Fichier Source: | mod_proxy_connect.c |
Pour fonctionner, ce module nécessite le chargement de
mod_proxy. Il fournit le support de la méthode HTTP
CONNECT. Cette méthode est principalement utilisée pour
faire franchir les serveurs mandataires aux requêtes SSL à l'aide
d'un tunnel.
Ainsi, pour pouvoir traiter les requêtes CONNECT,
mod_proxy et mod_proxy_connect
doivent être chargés dans le serveur.
CONNECT est aussi utilisée lorsque le serveur doit envoyer une
requête HTTPS via un mandataire. Dans ce cas, le serveur se comporte
comme un client CONNECT. Cette fonctionnalité étant fournie par le
module mod_proxy, le module
mod_proxy_connect n'est dans ce cas pas nécessaire.
N'activez pas la fonctionnalité de mandataire avant d'avoir sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux non seulement pour votre réseau, mais aussi pour l'Internet au sens large.
mod_proxy_connect enregistre les informations
suivantes pour journalisation via le format %{NOMVAR}n
dans les directives LogFormat ou ErrorLogFormat :
| Description: | Ports autorisés à se CONNECTer à travers le
mandataire |
|---|---|
| Syntaxe: | AllowCONNECT port[-port]
[port[-port]] ... |
| Défaut: | AllowCONNECT 443 563 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_proxy_connect |
| Compatibilité: | Déplacé depuis mod_proxy à partir
d'Apache 2.3.5. Plages de ports disponibles depuis Apache 2.3.7. |
La directive AllowCONNECT permet de
spécifier une liste de numéros ou de plages de ports auxquels la
méthode de mandataire CONNECT pourra se connecter. Les
navigateurs récents utilisent cette méthode dans le cas où une
connexion https est requise et où le tunneling
mandataire sur HTTP est en service.
Par défaut, seuls les ports par défauts https (443)
et snews (563) sont pris en compte. Vous pouvez
utiliser la directive AllowCONNECT pour
outrepasser ces valeurs par défaut et n'autoriser les connexions que
vers les ports spécifiés.
Serveur HTTP Apache Version 2.4
| Description: | Module fournissant le support des processus externes fdpass
à mod_proxy |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_fdpass_module |
| Fichier Source: | mod_proxy_fdpass.c |
| Compatibilité: | Disponible pour unix depuis la version 2.3 d'Apache |
Pour fonctionner, ce module nécessite le chargement de
mod_proxy. Il permet le passage de la socket du client
vers un autre processus.
mod_proxy_fdpass utilise la capacité des sockets de
domaine AF_UNIX à transmettre un
descripteur de fichier ouvert afin de permettre à un autre
processus de terminer le traitement de la requête.
Le module possède une interface de fournisseur
proxy_fdpass_flusher qui permet éventuellement à un
autre module d'envoyer les en-têtes de la réponse, ou même le début
du corps de la réponse. Le fournisseur par défaut flush désactive la
persistence, et envoie les en-têtes de la réponse, laissant le soin
au processus externe d'envoyer le corps de la réponse.
Pour utiliser un autre fournisseur, vous devez spécifier le paramètre
flusher de la directive ProxyPass.
À l'heure actuelle, la seule donnée transmise au processus
externe est la socket du client. Pour recevoir une socket client,
appelez recvfrom avec une structure struct cmsghdr allouée. Les versions
futures de ce module pourront transmettre d'autres données que le
socket client.
Ce module ne fournit aucune directive.
Serveur HTTP Apache Version 2.4
| Description: | Réécrit les liens HTML afin de s'assurer qu'ils soient bien adressables depuis les réseaux des clients dans un contexte de mandataire. |
|---|---|
| Statut: | Base |
| Identificateur de Module: | proxy_html_module |
| Fichier Source: | mod_proxy_html.c |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures |
Ce module fournit un filtre en sortie permettant de réécrire les liens
HTML dans un contexte de mandataire, afin de s'assurer que ces liens
fonctionnent pour les utilisateurs en dehors du mandataire. Il accomplit la
même tâche que la directive ProxyPassReverse d'Apache accomplit pour les
en-têtes HTTP, et fait partie des composants essentiels d'un mandataire
inverse.
Par exemple, si une entreprise possède un serveur d'applications
nommé appserver.example.com qui n'est visible que depuis son réseau
interne, et un serveur web public www.example.com, il peut
être souhaitable de fournir une passerelle vers le serveur d'application
à l'adresse http://www.example.com/appserver/. Lorsque le
serveur d'applications présente un lien vers lui-même, ce lien doit être
réécrit pour fonctionner à travers la passerelle. A cet effet,
mod_proxy_html permet de réécrire <a
href="http://appserver.example.com/foo/bar.html">foobar</a>
en <a
href="http://www.example.com/appserver/foo/bar.html">foobar</a>,
ce qui permet de rendre le serveur d'applications accessible depuis
l'extérieur.
mod_proxy_html a été développé à l'origine à WebÞing, dont la documentation détaillée pourra s'avérer utile aux utilisateurs.
ProxyHTMLBufSize ProxyHTMLCharsetOut ProxyHTMLDocType ProxyHTMLEnable ProxyHTMLEvents ProxyHTMLExtended ProxyHTMLFixups ProxyHTMLInterp ProxyHTMLLinks ProxyHTMLMeta ProxyHTMLStripComments ProxyHTMLURLMap| Description: | Définit l'incrément de la taille du tampon, ainsi que sa taille initiale, pour la mise en tampon des scripts en ligne et des feuilles de style. |
|---|---|
| Syntaxe: | ProxyHTMLBufSize nb-octets |
| Défaut: | ProxyHTMLBufSize 8192 |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures. |
Pour pouvoir interpréter du contenu non HTML (feuilles de style et
scripts) embarqué dans des documents HTML, mod_proxy_html doit
le lire et le mémoriser en entier dans un
tampon. Ce tampon devra être étendu autant que nécessaire afin de
pouvoir accueillir le plus grand script ou la plus grande feuille de
style de la page, selon un incrément de nb-octets que cette
directive permet de définir.
La valeur par défaut est 8192 et sera suffisante pour la plupart des pages. Cependant, si vous savez que vous allez mandater des pages contenant des feuilles de style et/ou scripts plus grands que 8k (cette taille s'entend pour chaque script ou feuilles de style, non pour leur ensemble), il sera plus efficace de définir une taille de tampon initiale plus grande afin d'éviter d'avoir à le redimensionner dynamiquement au cours du traitement d'une requête.
| Description: | Spécifie un jeu de caractères pour la sortie de mod_proxy_html. |
|---|---|
| Syntaxe: | ProxyHTMLCharsetOut jeu-de-caractères | * |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures. |
Cette directive permet de spécifier un jeu de caractères pour la
sortie de mod_proxy_html. Elle ne devrait jamais être utilisée, car tout
changement par rapport à la valeur par défaut UTF-8 (Unicode -
utilisé en interne par libxml2) induit une charge supplémentaire de
traitement. La définition spéciale ProxyHTMLCharsetOut *
permet de générer une sortie qui utilisera le même encodage que
l'entrée.
Notez que tout ceci ne fonctionne que si le module
mod_xml2enc est chargé.
| Description: | Définit une déclaration de type de document HTML ou XHTML. |
|---|---|
| Syntaxe: | ProxyHTMLDocType HTML|XHTML [Legacy] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures. |
Avec la première syntaxe, les documents seront déclarés de type HTML
4.01 ou XHTML 1.0 selon l'option spécifiée. Cette option détermine aussi
si la syntaxe utilisée en sortie est HTML ou XHTML. Notez que le format
des documents en provenance du serveur d'arrière-plan n'est pas
important, car l'interpréteur le détectera automatiquement. Si le
second argument optionnel est défini à Legacy, les documents seront
déclarés de type "Transitional" ; cette option peut être nécessaire si
vous mandatez du contenu datant d'avant 1998, ou si vous travaillez avec
des outils de création/publication déficients.
Avec la deuxième syntaxe, cette directive vous permet d'insérer votre propre FPI (Formal Public Identifier). Le second argument optionnel détermine si la syntaxe utilisée sera SGML/HTML ou XML/XHTML.
Par défaut, aucun FPI n'est inséré, étant donné qu'il vaut mieux pas de FPI du tout qu'un FPI bogué. Si par contre votre serveur d'arrière-plan génère du contenu HTML ou XHTML correct, vous pouvez définir cette directive en conséquence.
Avec la première syntaxe, mod_proxy_html va aussi mettre le code HTML
en conformité avec le standard spécifié. Il ne pourra pas corriger
toutes les erreurs, mais il va supprimer les éléments et attributs non
conformes. Il peut aussi journaliser les autres erreurs si la directive
LogLevel est définie à
Debug.
| Description: | Permet d'activer/désactiver le filtre proxy_html. |
|---|---|
| Syntaxe: | ProxyHTMLEnable On|Off |
| Défaut: | ProxyHTMLEnable Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures. |
Cette directive est un simple commutateur permettant
d'activer/désactiver le filtre proxy_html. Si
mod_xml2enc est chargé, elle va aussi activer
automatiquement le support de l'internationalisation.
Notez que le filtre proxy_html s'agira que si les données sont de type HTML (Content-Type text/html ou application/xhtml+xml), et si elles passent par un mandataire. Vous pouvez passer outre ces contraintes (à vos risques et périls) en définissant la variable d'environnement PROXY_HTML_FORCE.
| Description: | Spécifie les attributs à traiter comme des évènements de type scripting. |
|---|---|
| Syntaxe: | ProxyHTMLEvents attribut [attribut ...] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures. |
Cette directive permet de spécifier un ou plusieurs attributs à
traiter comme
des évènements de type scripting et de leur appliquer les règles
ProxyHTMLURLMap lorsqu'elles ont été définies. Vous
pouvez spécifier un nombre quelconque d'attributs dans une ou plusieurs
directives ProxyHTMLEvents.
Normalement, cette directive est définie globalement. Si vous
définissez ProxyHTMLEvents à plusieurs niveaux, certains niveaux
l'emportant sur d'autres, vous devrez spécifier un jeu complet
d'évènements pour chaque niveau.
Le fichier proxy-html.conf fournit une configuration par défaut et définit les évènements selon les standards HTML 4 et XHTML 1.
| Description: | Détermine si l'on doit corriger les liens dans les scripts en ligne, les feuilles de style et les évènements de type scripting. |
|---|---|
| Syntaxe: | ProxyHTMLExtended On|Off |
| Défaut: | ProxyHTMLExtended Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures. |
Si cette directive est définie à Off, les liens HTML
sont réécrits en fonction des directives
ProxyHTMLURLMap, mais les liens qui apparaissent
dans le code Javascript et les feuilles de style restent inchangés.
Si elle est définie à On, tous les évènements de type
scripting (définis par la directive
ProxyHTMLEvents) et les scripts inclus ou les
feuilles de style sont aussi
traités par les règles ProxyHTMLURLMap, en
fonction des drapeaux définis pour chacune d'entre elles. Ne définissez
cette directive à On qu'en cas de nécessité absolue, car la
charge supplémentaire induite impacte les performances.
Vous devez aussi prêter attention aux modèles de comparaison, car
l'interpréteur n'a aucune notion de la forme que pourrait prendre une URL dans un
script embarqué ou une feuille de style. En particulier, la comparaison
étendus du caractère / a de fortes chances d'induire des
correspondances erronées.
| Description: | Corrige les erreurs HTML simples. |
|---|---|
| Syntaxe: | ProxyHTMLFixups [lowercase] [dospath] [reset] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures. |
Cette directive accepte un à trois arguments parmi les suivants :
lowercase Les Urls sont réécrites en minusculesdospath Les slashes inversés dans les URLs sont
remplacés par des slashes directs.reset Annule toute option définie à un niveau supérieur
dans la configurationCette directive doit être utilisée avec prudence. Elle peut corriger certaines erreurs de création, mais risque aussi de modifier par erreur des liens corrects. Ne l'utilisez que si vous êtes sûr que le serveur d'arrière-plan est déficient.
| Description: | Active la réinterprétation des règles
ProxyHTMLURLMap pour chaque requête. |
|---|---|
| Syntaxe: | ProxyHTMLInterp On|Off |
| Défaut: | ProxyHTMLInterp Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures. |
Cette directive permet d'activer le réinterprétation pour chaque
requête des modèles source et cible de la directive
ProxyHTMLURLMap.
Si la réinterprétation n'est pas activée, toutes les règles sont précompilées au démarrage du serveur. Si elle est activée, les règles doivent être recompilées pour chaque requête, ce qui induit une charge de traitement supplémentaire. Elle ne doit donc être activée que si cela s'avère nécessaire.
| Description: | Spécifie les éléments HTML dont les attributs d'URL doivent être réécrits. |
|---|---|
| Syntaxe: | ProxyHTMLLinks élément attribut [attribut2 ...] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures. |
Cette directive permet de spécifier les éléments dont les attributs d'URL
doivent être réécrits en utilisant les règles standards ProxyHTMLURLMap. Vous devez définir une
directive ProxyHTMLLinks pour chaque élément, mais chacune d'entre elles peut
spécifier un nombre quelconque d'attributs
Normalement, cette directive
est définie globalement. Si vous définissez ProxyHTMLLinks à plusieurs niveaux,
certains niveaux l'emportant sur d'autres, vous devrez spécifier un jeu complet
de liens pour chaque niveau.
Le fichier proxy-html.conf fournit une configuration par défaut et définit les liens HTML selon les standards HTML 4 et XHTML 1.
ProxyHTMLLinks a href ProxyHTMLLinks area href ProxyHTMLLinks link href ProxyHTMLLinks img src longdesc usemap ProxyHTMLLinks object classid codebase data usemap ProxyHTMLLinks q cite ProxyHTMLLinks blockquote cite ProxyHTMLLinks ins cite ProxyHTMLLinks del cite ProxyHTMLLinks form action ProxyHTMLLinks input src usemap ProxyHTMLLinks head profile ProxyHTMLLinks base href ProxyHTMLLinks script src for
| Description: | Active ou désactive une préinterprétation supplémentaire
des métadonnées dans les sections HTML <head>. |
|---|---|
| Syntaxe: | ProxyHTMLMeta On|Off |
| Défaut: | ProxyHTMLMeta Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible à partir de la version 2.4 du serveur HTTP Apache ; proposé en tant que module tiers dans les versions 2.x précédentes. |
Cette directive permet d'activer ou désactiver une
préinterprétation supplémentaire des métadonnées dans les sections
HTML <head>. Si cette préinterprétation n'est pas
requise, définissez ProxyHTMLMeta à Off et les performances
seront légèrement améliorées. Cependant, elle s'avère parfois
nécessaire pour assurer un fonctionnement correct de l'internationalisation.
La directive ProxyHTMLMeta a deux effets. Le premier et le plus
important est la détection des codages de caractères déclarés sous
la forme
<meta http-equiv="Content-Type" content="text/html;charset=foo">
ou, dans le cas d'un document XHTML, sous la forme d'une
déclaration XML. Elle n'est pas nécessaire si le jeu de caractères
est déclaré explicitement dans un en-tête HTTP (ce qui est
préférable) en provenance du serveur d'arrière-plan, ou si le
document est en utf-8 (unicode) ou un de ses
sous-ensembles comme ASCII. Vous pourrez aussi vous en passer
lorsque le document utilise une valeur par défaut déclarée via la
directive xml2EncDefault, avec le risque de
propager une déclaration incorrecte. Une directive
ProxyHTMLCharsetOut permettra d'annuler ce
risque, mais pourra induire une surcharge de traitement supérieure à
celle de ProxyHTMLMeta.
Le deuxième effet est l'interprétation de toutes les déclarations
<meta http-equiv=...> et leur conversion en
en-têtes HTTP, afin de conserver le but original de cette forme
de métaélément HTML.
http-equiv au rang d'en-têtes HTTP, il est conseillé de ne
l'activer que si vous faites autant confiance au contenu HTML qu'à votre
serveur mandataire. Avec cette directive en effet, si ce contenu est géré
par des gens malintentionnés, ces derniers seront en mesure d'injecter des
en-têtes HTTP arbitraires et peut-être malveillants dans les réponses de
votre serveur.
| Description: | Détermine si les commentaires HTML doivent être supprimés. |
|---|---|
| Syntaxe: | ProxyHTMLStripComments On|Off |
| Défaut: | ProxyHTMLStripComments Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures. |
Si cette directive est définie à On, mod_proxy_html
supprimera les commentaires HTML. Notez que cela supprimera aussi tout
script ou style inclus dans les commentaires (une monstruosité
introduite en 1995/1996 avec Netscape 2 pour les navigateurs plus
anciens, et encore utilisée de nos jours). Cette directive peut aussi
interférer avec des processeurs basés sur les commentaires comme SSI ou
ESI : assurez-vous d'exécuter ces derniers avant mod_proxy_html
dans la chaîne de filtrage si vous supprimez les commentaires !
| Description: | Définit une règle de réécriture des liens HTML |
|---|---|
| Syntaxe: | ProxyHTMLURLMap modèle-source modèle-cible [drapeaux] [cond] |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Base |
| Module: | mod_proxy_html |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.x antérieures. |
Il s'agit de la directive la plus importante pour la réécriture des
liens HTML. Lors de l'interprétation d'un document, chaque fois qu'un
lien correspond à modèle-source, la partie du lien concernée
sera réécrite en modèle-cible, en tenant compte des
modifications induites par les drapeaux éventuellement spécifiés et par
la directive ProxyHTMLExtended.
Ne seront considérés comme des liens HTML que les éléments spécifiés via la
directive ProxyHTMLLinks.
Le troisième argument optionnel permet de définir un des drapeaux suivants (les drapeaux sont sensibles à la casse) :
Ignore les liens HTML (les traverse sans les modifier)
Ignore les évènements de scripting (les traverse sans les modifier)
Traverse les sections de type style ou script sans les modifier.
Last-match. Si cette règle s'applique, aucune autre règle ne sera prise en compte (notez qu'il s'agit du comportement automatique pour les liens HTML).
L'opposé de L. Passe outre le comportement par défaut du changement unique pour les liens HTML.
Utilise des expressions rationnelles pour les modèles.
modèle-source est une expression rationnelle, et
modèle-cible une chaîne de remplacement qui peut être basée
elle aussi sur une expression rationnelle. La mémorisation dans les
expressions rationnelles est supportée : vous pouvez utiliser des
parenthèses () dans le modèle-source, et récupérer la
correspondance de leur contenu via les variables $1 à $9 dans le
modèle-cible.
Si le drapeau R n'est pas fourni, la directive utilisera des chaînes littérales pour les différents modèles de recherche/remplacement. La logique de recherche est "commence par" dans les liens HTML, et "contient" dans les évènements de scripting et les sections de type style ou script.
Utilise les expressions rationnelles étendues POSIX. Ne s'applique qu'avec R.
Recherche de correspondance sensible à la casse. Ne s'applique qu'avec R.
Désactive la mémorisation dans les expressions rationnelles (pour améliorer les performances). Ne s'applique qu'avec R.
Recherche de correspondance dans les expressions rationnelles basée sur la ligne. Ne s'applique qu'avec R.
Recherche de correspondance au début seulement. Ne concerne que les recherches de correspondance par rapport à des chaînes, et ne s'applique pas aux liens HTML.
Recherche de correspondance à la fin seulement. Ne concerne que les recherches de correspondance par rapport à des chaînes, et ne s'applique pas aux liens HTML.
Insère des variables d'environnement dans le
modèle-cible. Un modèle-cible de la forme
${varname|default} sera remplacé par la valeur de la
variable d'environnement varname. Si cette dernière n'est
pas définie, modèle-cible sera remplacé par
default. La spécification de |default est
facultative.
NOTE: l'insertion de variables d'environnement n'est possible que si
la directive ProxyHTMLInterp a été définie à
On.
Insère des variables d'environnement dans le
modèle-source. La syntaxe du modèle est identique à la
syntaxe précédente.
NOTE: l'insertion de variables d'environnement n'est possible que si
la directive ProxyHTMLInterp a été définie à
On.
Le quatrième argument optionnel cond définit une
condition qui sera évaluée pour chaque requête, sous réserve que la
directive ProxyHTMLInterp ait été définie à
On. Si la condition est évaluée à FALSE, la règle ne sera pas
appliquée à la requête. Si elle est évaluée à TRUE, ou si aucune
condition n'est définie, la règle s'applique.
La condition est évaluée par l'interpréteur d'expression. La syntaxe simple des conditions dans mod_proxy_html 3.x pour HTTPD 2.0 et 2.2 est aussi supportée.
Serveur HTTP Apache Version 2.4
| Description: | Module fournissant le support de la passerelle SCGI à
mod_proxy |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | proxy_scgi_module |
| Fichier Source: | mod_proxy_scgi.c |
| Compatibilité: | Disponible depuis la version 2.2.14 d'Apache |
Pour pouvoir fonctionner, ce module requiert le
chargement de mod_proxy. Il fournit le support du
protocole SCGI, version
1.
Ainsi, pour être en mesure de traiter le protocole SCGI,
mod_proxy et mod_proxy_scgi
doivent être chargés dans le serveur.
N'activez pas la fonctionnalité de mandataire avant d'avoir sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux non seulement pour votre réseau, mais aussi pour l'Internet au sens large.
Rappelez-vous, pour que les exemples suivants puissent
fonctionner, vous devez activer mod_proxy et
mod_proxy_scgi.
ProxyPass "/scgi-bin/" "scgi://localhost:4000/"
La passerelle à répartition de charge nécessite le chargement du
module mod_proxy_balancer et d'au moins un module
fournissant un algorithme de répartition de charge, comme
mod_lbmethod_byrequests en plus des modules
déjà cités. mod_lbmethod_byrequests est le module
par défaut et sera utilisé dans cet exemple de configuration.
ProxyPass "/scgi-bin/" "balancer://somecluster/"
<Proxy "balancer://somecluster">
BalancerMember "scgi://localhost:4000"
BalancerMember "scgi://localhost:4001"
</Proxy>
En plus des directives de configuration qui permettent de
contrôler le comportement de mod_proxy, une
variable d'environnement peut aussi
contrôler le fournisseur de protocole SCGI :
mod_proxy_scgi ne créera ni
exportera jamais la variable d'environnement
PATH_INFO. Ceci permet au serveur SCGI d'arrière-plan
de déterminer correctement SCRIPT_NAME et
Script-URI, et de rester en conformité avec la section
3.3 de la RFC 3875. Si au contraire vous souhaitez que
mod_proxy_scgi génère une estimation la plus
précise possible de PATH_INFO, définissez cette
variable d'environnement. La variable doit être définie avant
que la directive SetEnv ne soit effective. Il est possible
d'utiliser à la place la directive SetEnvIf : SetEnvIf Request_URI . proxy-scgi-pathinfo
| Description: | Active ou désactive les réponses de redirection interne en provenance du serveur cible. |
|---|---|
| Syntaxe: | ProxySCGIInternalRedirect On|Off|Headername |
| Défaut: | ProxySCGIInternalRedirect On |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy_scgi |
| Compatibilité: | Le paramètre Headername est disponible depuis la version 2.4.13 du serveur HTTP Apache. |
La directive ProxySCGIInternalRedirect
permet au serveur cible de rediriger en interne la passerelle vers
une URL différente. Cette fonctionnalité trouve son origine dans
mod_cgi qui redirige la réponse en interne si
l'état de la réponse est OK (200), et si
la réponse contient un en-tête Location
(ou un autre en-tête défini) dont la valeur
débute par un slash (/). Cette valeur est interprétée
comme une nouvelle URL locale vers laquelle Apache httpd effectue sa
redirection.
De ce point de vue, mod_proxy_scgi fait la même
chose que mod_cgi, mais vous pouvez en plus
désactiver la fonctionnalité ou spécifier
l'utilisation d'un en-tête autre que Location.
ProxySCGIInternalRedirect Off
# Django et certains autres frameworks qualifient pleinement les "URLs
# locales" définies par l'application ; il faut donc utiliser un autre
# en-tête.
<Location /django-app/>
ProxySCGIInternalRedirect X-Location
</Location>
| Description: | Active l'évaluation du pseudo en-tête de réponse X-Sendfile |
|---|---|
| Syntaxe: | ProxySCGISendfile On|Off|nom-en-tête |
| Défaut: | ProxySCGISendfile Off |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Extension |
| Module: | mod_proxy_scgi |
La directive ProxySCGISendfile permet au
serveur cible SCGI de faire servir les fichiers directement par la
passerelle. Ceci s'avère bénéfique en
matière de performances —
httpd peut alors utiliser sendfile ou d'autres
optimisations, ce qui n'est pas possible si les fichiers passent par
la socket du serveur cible. En outre, les fichiers ne sont transmis
qu'une seule fois.
L'argument de la directive
ProxySCGISendfile détermine le comportement
de la passerelle :
OffOnX-Sendfile, et interprète sa valeur comme
le nom du fichier à servir. L'en-tête est ensuite supprimé de la
réponse finale. Cet argument produit le même effet que
ProxySCGISendfile X-Sendfile.On, mais au lieu de rechercher le nom
d'en-tête codé en dur X-Sendfile, c'est la
valeur de l'argument qui constitue le nom de l'en-tête
à rechercher. # Utilise le nom d'en-tête par défaut (X-Sendfile)
ProxySCGISendfile On
# Utilise un nom d'en-tête différent
ProxySCGISendfile X-Send-Static
Serveur HTTP Apache Version 2.4
| Description: | Limitation de la bande passante pour les clients |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | ratelimit_module |
| Fichier Source: | mod_ratelimit.c |
| Compatibilité: |
rate-initial-burst est disponible à partir de la version 2.4.24
du serveur HTTP Apache. La limitation de bande passante pour les contenus
mandatés ne fonctionne pas correctement jusqu'à la version 2.4.33.
|
Ce module fournit un filtre RATE_LIMIT pour limiter la
bande passante des clients. Cette contrainte s'applique à chaque réponse HTTP au
moment où elle est envoyée au client ; elle n'affecte pas les autres échanges
entre le client et le serveur. La variable d'environnement
rate-limit permet de spécifier, en kb/s, le débit de la
connexion à simuler.
Optionnellement, il est possible, via la variable d'environnement
rate-initial-burst, de définir une quantité de données en
kOctets à transmettre à pleine vitesse avant de limiter la bande passante à la
valeur voulue.
<Location "/downloads">
SetOutputFilter RATE_LIMIT
SetEnv rate-limit 400
SetEnv rate-initial-burst 512
</Location>
rate-limit dépasse la valeur maximale à
affecter à un entier, la limitation de bande passante sera désactivée. Si la
valeur affectée à rate-limit-burst dépasse la valeur maximale à
affecter à un entier, la transmission du burst initial sans limitation de bande
passante sera désactivée.
Ce module ne fournit aucune directive.
Serveur HTTP Apache Version 2.4
| Description: | Définit le délai maximum et le taux minimum de transfert des données pour la réception des requêtes |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | reqtimeout_module |
| Fichier Source: | mod_reqtimeout.c |
| Compatibilité: | Disponible depuis la version 2.2.15 du serveur HTTP Apache |
Ce module permet de définir aisément le délai maximum et le taux de transfert des données minimum pour la réception des requêtes. Si ce délai est dépassé ou ce taux trop faible, la connexion concernée sera fermée par le serveur.
Cet évènement sera alors enregistré dans le journal au niveau de LogLevel info.
Au besoin, la directive LogLevel
peut être modifiée pour un enregistrement dans le journal plus explicite :
LogLevel reqtimeout:info
RequestReadTimeout handshake=5 header=10 body=30
LimitRequestBody) :
RequestReadTimeout body=10,MinRate=1000
RequestReadTimeout header=10-30,MinRate=500
RequestReadTimeout header=20-40,MinRate=500 body=20,MinRate=500
| Description: | Définit des délais maximums pour la négociation TLS, la réception des en-têtes et/ou corps des requêtes en provenance du client. |
|---|---|
| Syntaxe: | RequestReadTimeout
[handshake=timeout[-maxtimeout][,MinRate=rate]
[header=timeout[-maxtimeout][,MinRate=MinRate]
[body=timeout[-maxtimeout][,MinRate=MinRate]
|
| Défaut: | RequestReadTimeout handshake=0 header=20-40,MinRate=500 body=20,MinRate=500 |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_reqtimeout |
| Compatibilité: | Disponible depuis la version 2.2.15 du serveur HTTP
Apache ; désactivée par défaut depuis la version 2.3.14. La phase de
négociation est prise en compte à partir de la version 2.4.39. |
Cette directive permet de définir différents timeouts pour la négociation
TLS, la réception des en-têtes et/ou corps des requêtes en provenance du
client. Si le client ne parvient pas à respecter ces timeouts, un code
d'erreur 408 REQUEST TIME OUT est envoyé.
Pour les serveurs virtuels SSL, la valeur de timeout pour la
négociation correspond au temps nécessaire pour la négociation
SSL initiale. Si le navigateur du client est configuré pour demander des
listes de révocations de certificats, et si le serveur correspondant n'est
pas disponible, le timeout avant lequel le navigateur va abandonner son
attente de CRL au cours de la négociation SSL initiale peut être assez
important. Par conséquent, les valeurs de timeouts pour la
négociation doivent prendre en compte un temps supplémentaire
pour les serveurs virtuels SSL (si nécessaire). Le timeout concernant le
corps inclut le temps nécessaire à la renégociation SSL (si elle est
nécessaire).
Lorsqu'une directive AcceptFilter
est active (ce qui est en général le cas sous Linux et FreeBSD), la socket
n'est envoyée au processus du serveur qu'après la réception du premier octet
(ou de l'ensemble de la requête si httpready est défini). Les
timeouts configurés pour la négociation et les en-têtes via la directive
RequestReadTimeout n'entrent en ligne de compte
qu'une fois le socket reçu par le processus du serveur.
Il existe trois méthodes pour spécifier le timeout pour chacune des trois phases (négociation, en-tête ou corps) :
phase=timeout
Le temps en secondes alloué pour terminer l'ensemble de la phase (négociation, lecture de tous les en-têtes de la requête ou du corps de cette dernière). La valeur 0 signifie aucune limite.
handshake=0 header=0 body=0
Avec cet exemple, le module mod_reqtimeout est
complètement désactivé (notez que handshake=0 correspond à la
valeur par défaut et peut donc être omis).
phase=timeout,MinRate=débit
Identique à ce qui précède, mais chaque fois que des données sont reçues, la valeur du timeout est augmentée en fonction du MinRate spécifié (en octets par seconde).
phase=timeout-maxtimeout,MinRate=débit
Identique à ce qui précède, mais le timeout n'augmentera pas au delà de la borne supérieure du timeout spécifiée.
Serveur HTTP Apache Version 2.4
| Description: | Ce module fournit un moteur de réécriture à base de règles permettant de réécrire les URLs des requêtes à la volée |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | rewrite_module |
| Fichier Source: | mod_rewrite.c |
Le module mod_rewrite utilise un moteur de
réécriture à base de règles, basé sur un interpréteur
d'expressions rationnelles PCRE, pour réécrire les URLs à la volée. Par
défaut, mod_rewrite met en correspondance une URL
avec le système de fichiers. Cependant, on peut aussi l'utiliser
pour rediriger une URL vers une autre URL, ou pour invoquer une
requête interne à destination du mandataire.
mod_rewrite fournit une méthode souple et
puissante pour manipuler les URLs en utilisant un nombre illimité
de règles. Chaque règle peut être associée à un nombre illimité de
conditions, afin de vous permettre de réécrire les URLs en
fonction de variables du serveur, de variables d'environnement,
d'en-têtes HTTP, ou de repères temporels.
mod_rewrite agit sur la totalité de l'URL, y
compris la partie chemin. Une règle de réécriture peut être
invoquée dans httpd.conf ou dans un fichier
.htaccess. Le chemin généré par une règle de
réécriture peut inclure une chaîne de paramètres, ou peut renvoyer
vers un traitement secondaire interne, une redirection vers une
requête externe ou vers le mandataire interne.
Vous trouverez d'avantage de détails, discussions et exemples dans la documentation détaillée sur mod_rewrite.
mod_rewrite offre une journalisation détaillée
de ses actions aux niveaux de journalisation trace1 à
trace8. Le niveau de journalisation peut être défini de
manière spécifique à mod_rewrite via la directive
LogLevel : jusqu'au niveau
debug aucune action n'est journalisée, alors qu'elles
le sont pratiquement toutes au niveau trace8.
mod_rewrite va ralentir votre serveur HTTP Apache
de manière dramatique ! N'utilisez un niveau de journalisation
supérieur à trace2 qu'à des fins de débogage !
LogLevel alert rewrite:trace3
Ceux qui sont familiers avec les versions précédentes de
mod_rewrite vont probablement rechercher en vain les
directives RewriteLog et
RewriteLogLevel. Elles ont été en effet remplacées
par une configuration de la journalisation par module, comme
mentionné plus haut.
Pour extraire les traces spécifiques à
mod_rewrite, affichez le fichier journal en
redirigeant la sortie vers grep :
tail -f error_log|fgrep '[rewrite:'
| Description: | Définit l'URL de base pour les réécritures au niveau répertoire |
|---|---|
| Syntaxe: | RewriteBase chemin_URL |
| Défaut: | Pas de valeur par défaut |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_rewrite |
La directive RewriteBase permet de
spécifier le préfixe d'URL à utiliser dans un contexte de
répertoire (htaccess) pour les directives
RewriteRule qui réécrivent vers un chemin
relatif.
Cette directive est obligatoire si vous utilisez un chemin relatif dans une substitution, et dans un contexte de répertoire (htaccess), sauf si au moins une de ces conditions est vérifiée :
DocumentRoot (c'est à
dire que pour y accéder, il n'est pas nécessaire d'utiliser
une directive telle qu'Alias).RewriteRule, suffixé par
la substitution relative est aussi valide en tant qu'URL sur
le serveur (ce qui est rare).Alias ou le module
mod_userdir.Dans l'exemple ci-dessous, la directive
RewriteBase est nécessaire afin d'éviter une
réécriture en http://example.com/opt/myapp-1.2.3/welcome.html car la
ressource n'était pas relative à la racine des documents. Cette erreur
de configuration aurait conduit le serveur à rechercher un répertoire
"opt" à la racine des documents.
DocumentRoot "/var/www/example.com"
AliasMatch "^/myapp" "/opt/myapp-1.2.3"
<Directory "/opt/myapp-1.2.3">
RewriteEngine On
RewriteBase "/myapp/"
RewriteRule "^index\.html$" "welcome.html"
</Directory>
| Description: | Définit une condition qui devra être satisfaite pour que la réécriture soit effectuée |
|---|---|
| Syntaxe: | RewriteCond
chaîne_de_test expression_de_comparaison [drapeaux] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_rewrite |
La directive RewriteCond permet de définir une
condition d'exécution d'une règle. Une ou plusieurs conditions
RewriteCond peuvent précéder une
directive RewriteRule. La règle de réécriture correspondante n'est
ainsi exécutée que si ces conditions sont satisfaites,
et si l'URI correspond au modèle spécifié dans la
règle.
TestString est une chaîne qui peut contenir les extensions suivantes en plus du texte simple :
$N (0 <= N <= 9). $1 à $9
permettent d'accéder aux parties regroupées (entre
parenthèses) du modèle, issues de la RewriteRule
concernée par le jeu de conditions RewriteCond
courant. $0 donne accès à l'ensemble de la chaîne
correspondant au modèle.%N (0 <= N <= 9). %1 à %9
permettent d'accéder aux parties regroupées (entre
parenthèses) du modèle, issues de la dernière
condition RewriteCond satisfaite du jeu de conditions RewriteCond
courant. %0 donne accès à l'ensemble de la chaîne
correspondant au modèle.${nomTable:clé|défaut}. Voir la href="#mapfunc">documentation sur RewriteMap
pour plus de détails.
%{ NAME_OF_VARIABLE },
où NOM_DE_VARIABLE peut contenir une chaîne issue
de la liste suivante :
| En-têtes HTTP : | connexion & requête: | |
|---|---|---|
|
HTTP_ACCEPT HTTP_COOKIE HTTP_FORWARDED HTTP_HOST HTTP_PROXY_CONNECTION HTTP_REFERER HTTP_USER_AGENT |
AUTH_TYPE CONN_REMOTE_ADDR CONTEXT_PREFIX CONTEXT_DOCUMENT_ROOT IPV6 PATH_INFO QUERY_STRING REMOTE_ADDR REMOTE_HOST REMOTE_IDENT REMOTE_PORT REMOTE_USER REQUEST_METHOD SCRIPT_FILENAME |
|
| variables internes au serveur : | date et heure : | spéciaux : |
|
DOCUMENT_ROOT SCRIPT_GROUP SCRIPT_USER SERVER_ADDR SERVER_ADMIN SERVER_NAME SERVER_PORT SERVER_PROTOCOL SERVER_SOFTWARE |
TIME_YEAR TIME_MON TIME_DAY TIME_HOUR TIME_MIN TIME_SEC TIME_WDAY TIME |
API_VERSION CONN_REMOTE_ADDR HTTPS IS_SUBREQ REMOTE_ADDR REQUEST_FILENAME REQUEST_SCHEME REQUEST_URI THE_REQUEST |
Ces variables correspondent toutes aux en-têtes MIME
HTTP de mêmes noms, au variables C du serveur HTTP Apache, ou
aux champs struct tm du système Unix. La
plupart d'entre elles sont documentées ici, dans la
spécification CGI ou ailleurs dans le
manuel.
SERVER_NAME et SERVER_PORT dépendent respectivement
des valeurs des directives UseCanonicalName et UseCanonicalPhysicalPort.
Parmi les variables
spécifiques à mod_rewrite, ou trouve les suivantes :
API_VERSIONCONN_REMOTE_ADDRmod_remoteip).HTTPSmod_ssl soit chargé ou non).IS_SUBREQREMOTE_ADDRmod_remoteip).REQUEST_FILENAMEREQUEST_FILENAME contient la
valeur de REQUEST_URI. En fonction de la
valeur de la directive AcceptPathInfo, le serveur
peut n'utiliser que certains éléments de tête du
REQUEST_URI pour déterminer à quel
fichier correspond la requête.REQUEST_SCHEMEServerName.REQUEST_URIQUERY_STRING. La valeur renvoyée pour
REQUEST_URI a déjà été %-décodée ; pour la
recoder, passez-la à la fonction de
mappage "escape".
THE_REQUESTGET
/index.html HTTP/1.1"), à l'exclusion de tout
en-tête ajouté par le navigateur. Cette
valeur n'a pas été déséchappée (décodée), à la
différence de la plupart des variables suivantes.Si la chaîne_de_test contient la valeur spéciale
expr, expression_de_comparaison sera traité
en tant qu'expression rationnelle de type ap_expr. Si des en-têtes HTTP sont
référencés dans l'expression rationnelle, et si le drapeau
novary n'est pas activé, ils seront ajoutés à
l'en-tête Vary.
Autres points à connaître ::
Les variables SCRIPT_FILENAME et
REQUEST_FILENAME contiennent toutes deux la valeur
du champ filename de la
structure interne request_recdu serveur HTTP Apache.
Le premier nom correspond au nom de variable bien connu CGI,
alors que le second est l'équivalent de REQUEST_URI (qui
contient la valeur du champ uri de
request_rec).
Si une substitution intervient et si la réécriture se poursuit, la valeur des deux variables sera mise à jour en conséquence.
Dans le contexte du serveur principal (c'est à dire avant que
la requête ne soit mise en correspondance avec le système de
fichiers), SCRIPT_FILENAME et REQUEST_FILENAME ne peuvent pas
contenir le chemin entier dans le système de fichiers local car
ce chemin b'est pas connu à ce stade du traitement. Dans ce cas,
les deux variables contiendront la valeur de REQUEST_URI. Pour
obtenir le chemin complet de la requête dans le système de
fichiers local dans le contexte du serveur principal, utilisez une
référence avant à base d'URL
%{LA-U:REQUEST_FILENAME} pour déterminer la valeur
finale de REQUEST_FILENAME.
%{ENV:variable}, où variable peut
correspondre à une variable d'environnement quelconque.%{ENV:variable} est aussi disponible, où
variable peut correspondre à toute variable
d'environnement. Peut être consulté via des structures internes
d'Apache httpd et (si on ne les trouve pas ici) via la fonction
getenv() à partir du processus du serveur Apache
httpd.mod_ssl soit chargé ou non, on peut
utiliser %{SSL:variable}, où variable
peut être remplacé par le nom d'une
variable
d'environnement SSL . Si mod_ssl n'est pas
chargé, cette variable contiendra toujours une chaîne vide.
Exemple : %{SSL:SSL_CIPHER_USEKEYSIZE} pourra
contenir la valeur 128. Ces variables sont
disponibles même si l'option StdEnvVars de la
directive SSLOptions n'a
pas été définie.%{HTTP:en-tête}, où
en-tête peut correspondre à tout nom d'en-tête MIME
HTTP, pour extraire la valeur d'un en-tête envoyé dans la
requête HTTP. Par exemple, %{HTTP:Proxy-Connection}
contiendra la valeur de l'en-tête HTTP
"Proxy-Connection:".
Si on utilise un en-tête HTTP
dans une condition, et si cette condition est évaluée à
vrai pour la requête, cet en-tête sera ajouté à l'en-tête Vary de
la réponse. Il ne le sera pas si la condition est évaluée à
faux. L'ajout de l'en-tête HTTP à l'en-tête Vary
est nécessaire à une mise en cache appropriée.
Il faut garder à l'esprit que les conditions suivent une
logique de cout-circuit si le drapeau
'ornext|OR' est utilisé, et que de
ce fait, certaines d'entre elles ne seront pas évaluées.
%{LA-U:variable}, qui
permet d'effectuer une sous-requête interne à base d'URL, afin
de déterminer la valeur finale de variable. Ceci permet
d'accéder à la valeur d'une variable pour la réécriture inconnue
à ce stade du traitement, mais qui sera définie au
cours d'une phase ultérieure.
Par exemple, pour effectuer une réécriture dépendant de la
variable REMOTE_USER dans le contexte du serveur
principal (fichier httpd.conf), vous devez utiliser
%{LA-U:REMOTE_USER} - cette variable est définie
par la phase d'autorisation qui intervient après la
phase de traduction d'URL (pendant laquelle mod_rewrite
opère).
Par contre, comme mod_rewrite implémente son contexte de
répertoire (fichier .htaccess) via la phase Fixup
de l'API, et comme la phase d'autorisation intervient
avant cette dernière, vous pouvez vous contenter
d'utiliser %{REMOTE_USER} dans ce contexte.
%{LA-F:variable} peut être utilisée pour effectuer
une sous-requête interne (basée sur le nom de fichier), afin de
déterminer la valeur finale de variable. La plupart du
temps, elle est identique à LA-U (voir ci-dessus).expression_de_comparaison est une expression rationnelle qui est appliquée à l'instance actuelle de chaîne_de_test. chaîne_de_test est d'abord évaluée, puis comparée à l'expression_de_comparaison.
expression_de_comparaison est en général une expression rationnelle compatible perl, mais vous disposez des syntaxes supplémentaires suivantes pour effectuer d'autres tests utiles sur chaîne_de_test :
!' (point d'exclamation) pour inverser le résultat
de la condition, quelle que soit l'expression de
comparaison utilisée."" (deux guillemets),
chaîne_de_test est comparée à la
chaîne vide.RewriteCond %{HTTP_USER_AGENT} "=This Robot/1.0"
!-eq.test de l'existence d'une
URL via une sous-requête
Vérifie si chaîne_de_test est une URL valide,
accessible à travers tous les contrôles d'accès du serveur
actuellement configurés pour ce chemin. C'est une
sous-requête interne qui effectue cette vérification - à
utiliser avec précautions car les performances du serveur
peuvent s'en trouver affectées !
Ce drapeau ne renvoie que des informations concernant le contrôle d'accès, l'authentification et l'autorisation. Il ne renvoie pas d'informations concernant le code d'état que le gestionnaire configuré (static file, CGI, proxy, etc...) aurait, quant à lui, retourné.
RewriteCond /var/www/%{REQUEST_URI} !-f
RewriteRule ^(.+) /other/archive/$1 [R]
Si la chaîne_de_test contient la valeur spéciale
expr, la chaîne de comparaison sera
traitée en tant qu'expression rationnelle de type ap_expr.
Dans l'exemple ci-dessous, on utilise -strmatch
pour comparer le REFERER avec le nom d'hôte du
site afin de bloquer le hotlinking (référencement direct)
non désiré.
RewriteCond expr "! %{HTTP_REFERER} -strmatch '*://%{HTTP_HOST}/*'"
RewriteRule "^/images" "-" [F]
Vous pouvez aussi définir certains drapeaux pour
l'expression_de_comparaison en ajoutant ces
[drapeaux]
comme troisième argument de la directive
RewriteCond, où drapeaux est un
sous-ensemble séparé par des virgules des drapeaux suivants :
nocase|NC'
(no case)ornext|OR'
(ou condition suivante)RewriteCond "%{REMOTE_HOST}" "^host1" [OR]
RewriteCond "%{REMOTE_HOST}" "^host2" [OR]
RewriteCond "%{REMOTE_HOST}" "^host3"
RewriteRule ...règles concernant tous ces hôtes...
Sans ce drapeau, les paires
condition/règle devraient être écrites trois fois.
novary|NV'
(no vary)Exemple :
Pour réécrire la page d'accueil d'un site en fonction de
l'en-tête ``User-Agent:'' de la requête, vous
pouvez utiliser ce qui suit :
RewriteCond "%{HTTP_USER_AGENT}" "(iPhone|Blackberry|Android)"
RewriteRule "^/$" "/homepage.mobile.html" [L]
RewriteRule "^/$" "/homepage.std.html" [L]
Explications : si vous utilisez un navigateur qui s'identifie comme un navigateur de plateforme mobile (notez que l'exemple est incomplet car il existe de nombreuses autres plateformes mobiles), c'est la version pour mobile de la page d'accueil qui sera renvoyée. Dans le cas contraire, ce sera la page d'accueil standard.
Par défaut, plusieurs directives RewriteCond
sont évaluées de manière séquentielle et combinées à l'aide d'un
ET logique. Si une condition n'est pas vérifiée et en
l'absence d'un opérateur logique OU,
l'ensemble du jeu de règles est abandonné et les conditions restantes ne
sont pas évaluées.
| Description: | Active ou désactive l'exécution du moteur de réécriture |
|---|---|
| Syntaxe: | RewriteEngine on|off |
| Défaut: | RewriteEngine off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_rewrite |
La directive RewriteEngine active ou
désactive l'exécution du moteur de réécriture. Si sa valeur est
off, ce module n'exécutera aucun traitement et ne
mettra pas à jour les variables d'environnement
SCRIPT_URx.
Plutôt que de commenter toutes les directives RewriteRule, il est préférable
d'utiliser cette directive si l'on souhaite désactiver les
règles de réécriture dans un contexte particulier.
Notez que les hôtes virtuels n'héritent pas des
configurations de réécriture. Ceci implique que vous devez
insérer une directive RewriteEngine on dans chaque
hôte virtuel pour lequel vous souhaitez utiliser des règles
de réécriture.
Les directives RewriteMap du type
prg ne sont pas prises en compte au cours de
l'initialisation du serveur si elle ont été définies dans un
contexte où la directive RewriteEngine n'a
pas été définie à on.
| Description: | Définit une fonction de mise en correspondance pour la recherche de mots-clés |
|---|---|
| Syntaxe: | RewriteMap MapName MapType:MapSource [MapTypeOptions]
|
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_rewrite |
| Compatibilité: | Le troisième paramètre, MapTypeOptions, est disponible à partir de la version 2.4.29 du serveur HTTP Apache |
La directive RewriteMap définit une
Table de correspondance pour la réécriture que les
fonctions de mise en correspondance
peuvent utiliser dans les chaînes de substitution des règles
pour insérer/substituer des champs en recherchant des mots-clés.
La source utilisée pour cette recherche peut être de plusieurs
types.
MapName est le nom de la table de correspondance et servira à spécifier une fonction de mise en correspondance pour les chaînes de substitution d'une règle de réécriture selon une des constructions suivantes :
${ MapName :
mot-clé }
${ MapName :
mot-clé | valeur par défaut
}
Lorsqu'une telle construction est rencontrée, la table de correspondance MapName est consultée et la clé mot-clé recherchée. Si la clé est trouvée, la construction est remplacée par la valeur de remplacement. Si la clé n'est pas trouvée, elle est remplacée par la valeur par défaut, ou par une chaîne vide si aucune valeur par défaut n'est spécifiée. La valeur vide se comporte comme si la clé était absente ; il est donc impossible de distinguer une valeur vide d'une absence de clé.
Par exemple, vous pouvez définir une directive
RewriteMap comme suit
RewriteMap map-exemple "txt:/chemin/vers/fichier/map.txt"
Vous pourrez ensuite utiliser cette table dans une
directive RewriteRule comme suit :
RewriteRule "^/ex/(.*)" "${map-exemple:$1}"
La signification de l'argument MapTypeOptions dépend du MapType spécifié. Veuillez vous référer au document Utiliser RewriteMap pour plus de détails.
Les combinaisons suivantes pour type de correspondance et MapSource peuvent être utilisées :
httxt2dbm (Détails ...).RewriteMap: toupper, tolower, escape ou unescape
(Détails ...).Vous trouverez plus de détails et de nombreux exemples dans le RewriteMap HowTo.
| Description: | Configure certaines options spéciales pour le moteur de réécriture |
|---|---|
| Syntaxe: | RewriteOptions Options |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_rewrite |
La directive RewriteOptions définit
certaines options spéciales pour la configuration au niveau du
serveur ou du répertoire. La chaîne de caractères Option
ne peut actuellement prendre qu'une des valeurs suivantes :
InheritCeci force la configuration locale à hériter de la
configuration du niveau supérieur. Dans le contexte des hôtes
virtuels, cela signifie que les correspondances, conditions et
règles du serveur principal sont héritées. Dans le contexte des
répertoires, cela signifie que les conditions et règles de la
configuration .htaccess ou les sections <Directory> du répertoire
parent sont héritées. Les règles héritées sont virtuellement
copiées dans la section où cette directive est utilisée. Si elles
sont utilisées avec des règles locales, les règles héritées sont
placées après ces dernières. La place de cette directive - avant
ou après les règles locales - n'a aucune influence sur ce
comportement. Si des règles locales ont forcé l'arrêt de la
réécriture, les règles héritées ne seront pas traitées.
InheritBeforeMême effet que l'option Inherit ci-dessus, mais
les règles spécifiées dans le niveau parent s'appliquent
avant les règles spécifiées dans le niveau
enfant.
Disponible depuis la version 2.3.10 du serveur HTTP Apache.
InheritDownSi cette option est activée, toutes les configurations enfants
hériteront de la configuration courante. Il en est de même si l'on
spécifie RewriteOptions Inherit dans toutes les
configurations enfants. Voir l'option Inherit pour
plus de détails à propos de la manière dont les relations
parent-enfants sont traitées.
Cette option est disponible à partir
de la version 2.4.8 du serveur HTTP Apache.
InheritDownBeforeL'effet de cette option est équivalent à celui de l'option
InheritDown ci-dessus, mais les règles de la
configuration parente s'appliquent avant toute
règle de la configuration enfant.
Cette option est disponible à partir
de la version 2.4.8 du serveur HTTP Apache.
IgnoreInheritSi cette option est activée, les configurations courante et
enfants ignoreront toute règle héritée d'une configuration parente
via les options InheritDown ou
InheritDownBefore.
Cette option est disponible à partir
de la version 2.4.8 du serveur HTTP Apache.
AllowNoSlashPar défaut, mod_rewrite ignore les URLs qui
correspondent à un répertoire sur disque, mais ne comportent pas
de slash final, afin que le module mod_dir
redirige le client vers l'URL canonique avec un slash final.
Lorsque la directive DirectorySlash est définie à off, il
est possible de spécifier l'option AllowNoSlash pour
s'assurer que les règles de réécriture ne soient plus ignorées.
Si on le souhaite, cette option permet de faire s'appliquer des
règles de réécriture qui correspondent à un répertoire sans slash
final au sein de fichiers .htaccess.
Elle est disponible à
partir de la version 2.4.0 du serveur HTTP Apache.
AllowAnyURIA partir de la version 2.2.22 de httpd, lorsqu'une directive RewriteRule se situe dans un
contexte de serveur virtuel ou de serveur principal,
mod_rewrite ne traitera les règles de réécriture
que si l'URI de la requête respecte la syntaxe d'un chemin URL. Ceci permet
d'éviter certains problèmes de sécurité où des règles
particulières pourraient permettre des développements de modèles
inattendus (voir CVE-2011-3368
et CVE-2011-4317).
Pour s'affranchir de la restriction relative à la syntaxe des chemins URL, on peut
utiliser l'option AllowAnyURI, afin de permettre à
mod_rewrite d'appliquer le jeu de règles à toute
chaîne de requête URI, sans vérifier si cette dernière respecte la
grammaire des chemins URL définie dans la spécification HTTP.
Disponible depuis la version 2.4.3 du serveur HTTP Apache.
L'utilisation de cette option rendra le serveur vulnérable à
certains problèmes de sécurité si les règles de réécritures
concernées n'ont pas été rédigées avec soin. Il est par conséquent
fortement recommandé de ne pas utiliser cette
option. En particulier, prêtez attention aux chaînes en entrée contenant le
caractère '@', qui peuvent modifier l'interprétation
de l'URI réécrite, comme indiqué dans les liens ci-dessus.
MergeBaseAvec cette option, la valeur de la directive RewriteBase est recopiée depuis
une valeur explicitement définie dans tout sous-répertoire qui ne
définit pas sa propre directive RewriteBase. Il s'agissait du
comportement par défaut avec les versions 2.4.0 à 2.4.3, et ce
drapeau qui permet de retrouver ce comportement est disponible
depuis la version 2.4.4 du serveur HTTP Apache.
IgnoreContextInfoLors d'une
substitution relative dans un contexte de répertoire (htaccess),
et si la directive RewriteBase n'a pas été définie,
ce module utilise des informations en provenance d'une extension
d'URL et du contexte du système de fichiers pour transformer la
sustitution relative en URL. Par exemple, les modules
mod_userdir et mod_alias
utilisent ces informations de contexte étendu. Disponible à partir de la
version 2.4.16 du serveur HTTP Apache.
LegacyPrefixDocRootAvant la version 2.4.26, si une substitution était une URL absolue qui
correspondait au serveur virtuel courant, l'URL pouvait être tout d'abord
réduite à sa partie chemin, puis enfin en chemin local. Comme l'URL peut
être réduite en chemin local, le chemin doit être préfixé par la
valeur de la directive DocumentRoot, ce qui permet d'interdire l'accès à
un fichier tel que /tmp/myfile suite à une requête pour
http://host/file/myfile avec la RewriteRule suivante :
RewriteRule /file/(.*) http://localhost/tmp/$1
Cette option permet de restaurer l'ancien comportement lorsqu'un chemin local obtenu à partir de la réduction d'une URL n'est pas préfixé par la valeur de la directive DocumentRoot. Disponible à partir de la version 2.4.26 du serveur HTTP Apache.
| Description: | Définit les règles pour le moteur de réécriture |
|---|---|
| Syntaxe: | RewriteRule
Modèle Substitution [drapeaux] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_rewrite |
La directive RewriteRule est le
véritable cheval de trait de la réécriture. La directive peut
apparaître plusieurs fois, chaque instance définissant une
règle de réécriture particulière. L'ordre dans lequel ces règles
sont définies est important - il s'agit de l'ordre dans lequel
les règles seront appliquées au cours du processus de
réécriture.
Modèle est une
expression rationnelle
compatible perl. Ce avec quoi ce modèle est comparé dépend de l'endroit où
la directive RewriteRule est définie.
Dans un contexte de serveur virtuel VirtualHost, le modèle est tout
d'abord comparé à la portion de l'URL située entre le nom d'hôte
éventuellement accompagné du port, et la chaîne de paramètres (par
exemple "/app1/index.html"). Il s'agit du URL-path décodé de sa valeur "%xx".
Dans un contexte de répertoire (sections Directory et fichiers .htaccess), le
Modèle est comparé avec une partie de chemin ; par exemple une
requête pour "/app1/index.html" entraînera une comparaison avec
"app1/index.html" ou "index.html" selon l'endroit où la directive
RewriteRule est définie.
Le chemin où la règle est défini est supprimé du chemin correspondant du système de fichiers avant comparaison (jusqu'au slash final compris). En conséquence de cette suppression, les règles définies dans ce contexte n'effectuent des comparaisons qu'avec la portion du chemin du système de fichiers "en dessous" de l'endroit où la règle est définie.
Le chemin correspondant actuel du système de fichiers est déterminé par
des directives telles que DocumentRoot et
Alias, ou même le résultat de
substitutions dans des règles RewriteRule précédentes.
Si vous souhaitez faire une comparaison sur le nom
d'hôte, le port, ou la chaîne de requête, utilisez une
directive RewriteCond
comportant respectivement les variables
%{HTTP_HOST}, %{SERVER_PORT}, ou
%{QUERY_STRING}.
<Directory> est un peu plus
complexe.RewriteEngine On" et
"Options FollowSymLinks". Si l'administrateur a désactivé
la possibilité de modifier l'option FollowSymLinks au
niveau du répertoire d'un utilisateur, vous ne pouvez pas utiliser le
moteur de réécriture. Cette restriction a été instaurée à des fins de
sécurité.RewriteBase pour plus de détails à
propos de l'ajout du préfixe après les substitutions relatives.%{REQUEST_URI} dans la directive
RewriteCond.^/ ne correspondra jamais dans un contexte de répertoire.<Location> et <Files> (y compris leurs versions sous forme
d'expression rationnelle), elles n'y sont pas prises en compte, et
n'y sont à priori d'aucune utilité. Les substitutions
relatives sont une fonctionnalité qui n'est, elle non-plus pas supportée
dans ce genre de contexte.If suivent les règles
du contexte de répertoire.RewriteOptions pour définir par
exemple l'option Inherit.RewriteOptions
permet aussi de contrôler le comportement des sections définies au même niveau
d'imbrication dans la configuration. Dans l'exemple suivant, par défaut seule la
règle RewriteRules définie dans le second bloc If est prise en compte car celle définie dans le
premier bloc est écrasée. Définir RewriteOptions Inherit force mod_rewrite à
combiner les deux sections en prenant en compte les deux règles et pas seulement
la dernière.<If "true"> # Sans RewriteOptions Inherit, cette règle est écrasée par celle de la section # suivante et aucune redirection ne sera effectuée pour les URIs contenant # 'foo' RewriteRule foo http://example.com/foo [R] </If> <If "true"> RewriteRule bar http://example.com/bar [R] </If>
Pour quelques conseils à propos des expressions rationnelles, voir le document Introduction à mod_rewrite.
Dans mod_rewrite, on peut aussi utiliser le caractère
NOT ('!') comme préfixe de modèle. Ceci vous permet
d'inverser la signification d'un modèle, soit pour dire
``si l'URL considérée ne correspond PAS à
ce modèle''. Le caractère NON peut donc être utilisé à
titre exceptionnel, lorsqu'il est plus simple d'effectuer une
comparaison avec le modèle inversé, ou dans la dernière règle
par défaut.
$N dans la chaîne de
substitution !
Dans une règle de réécriture, Substitution est la chaîne de caractères qui remplace le chemin de l'URL original qui correspondait au Modèle. Substitution peut être :
DocumentRoot vers la ressource qui
doit être servie. Notez que mod_rewrite
essaie de deviner si vous avez spécifié un chemin du système
de fichiers ou un chemin d'URL en vérifiant si la première
partie du chemin existe à la racine du système de fichiers.
Par exemple, si vous avez spécifié comme chaîne de
Substitution /www/file.html, cette
dernière sera traitée comme un chemin d'URL à moins
qu'un répertoire nommé www n'existe à la racine
de votre système de fichiers (ou dans le cas d'une
réécriture au sein d'un fichier .htaccess,
relativement à la racine des documents), auquel cas la chaîne de
substitution sera traitée comme un chemin du système de
fichiers. Si vous désirez que d'autres directives de
correspondance d'URL (comme la directive Alias) soient appliquées au
chemin d'URL résultant, utilisez le drapeau [PT]
comme décrit ci-dessous.Si une URL absolue est spécifiée,
mod_rewrite vérifie si le nom d'hôte
correspond à celui de l'hôte local. Si c'est le cas, le
protocole et le nom d'hôte sont supprimés, et ce qui reste est
traité comme un chemin d'URL. Dans le cas contraire, une
redirection externe vers l'URL indiquée est effectuée. Pour
forcer une redirection externe vers l'hôte local, voir le
drapeau [R] ci-dessous.
Notez qu'une redirection (implicite ou non) qui utilise une URI
absolue inclura la chaîne de paramètres de la requête ; pour éviter
ceci, voir le drapeau [QSD] ci-dessous.
- (tiret)En plus du texte, la chaîne Substitution peut comporter :
$N) vers le modèle
d'une directive RewriteRule%N) vers le dernier
modèle d'une directive RewriteCond qui correspondait%{VARNAME})${nom correspondance:clé|défaut})Les références arrières sont des identificateurs de la forme
$N (N=0..9), qui
seront remplacés par le contenu du Nème groupe
du Modèle qui correspondait. Les variables du serveur
sont les mêmes que dans la Chaîne_de_test d'une
directive RewriteCond. Les
fonctions de comparaison sont issues de la directive RewriteMap dans la
section de laquelle elles sont décrites. Ces trois types de
variables sont évaluées dans l'ordre ci-dessus.
Chaque règle de réécriture s'applique au résultat de la règle
précédente, selon l'ordre dans lequel elles ont été définies dans
le fichier de configuration. Le chemin de l'URL ou du système de fichier (voir
ci-dessus Qu'est-ce qui est
comparé ?) est intégralement
remplacée par la chaîne de Substitution et le
processus de réécriture se poursuit jusqu'à ce que toutes les
règles aient été appliquées, ou qu'il soit explicitement stoppé
par un drapeau L,
ou par un autre drapeau qui implique un arrêt immédiat, comme
END ou
F.
Par défaut, la chaîne de requête est transmise sans
modification. Vous pouvez cependant créer dans la chaîne de
substitution des URLs dont une partie constitue une chaîne de
requête. Pour cela, ajoutez simplement un point d'interrogation
dans la chaîne de substitution pour indiquer que le texte qui
suit doit être réinjecté dans la chaîne de requête. Pour
supprimer une chaîne de requête, terminez simplement la chaîne de
substitution par un point d'interrogation. Pour combiner les
nouvelles chaînes de requête avec les anciennes, utilisez le
drapeau [QSA].
En outre, vous pouvez spécifier des actions spéciales à effectuer en ajoutant
des
[drapeaux]
comme troisième argument de la directive
RewriteRule. Séparés par des virgules au sein d'une
liste encadrée par des crochets, les drapeaux peuvent
être choisis dans la table suivante. Vous trouverez plus de
détails, et des exemples pour chaque drapeau dans le document à propos des drapeaux de
réécriture.
| Drapeaux et syntaxe | Fonction |
|---|---|
| B | Echappe les caractères non-alphanumériques dans les références arrières avant d'appliquer la transformation. Pour un échappement similaire des variables du serveur, voir la fonction de mappage "escape".détails ... |
| BCTLS | Identique à [B], mais n'échappe que les espaces et les caractères de contrôle. détails ... |
| BNE | Les caractères de [B] ou [BCTLS] qui ne doivent pas être échappés. détails ... |
| backrefnoplus|BNP | Avec ce drapeau, si les références arrières sont échappées, les espaces seront échappés en %20 au lieu de +. Ceci s'avère utile lorsqu'une référence arrière est utilisée dans la partie chemin, et non dans la chaîne de paramètres de la requête ; pour plus de détails, voir ici. |
| chain|C | La règle est chaînée avec la règle suivante. Si la règle échoue, la ou les règles avec lesquelles elle est est chaînée seront sautées. détails ... |
| cookie|CO=NAME:VAL | Définit un cookie au niveau du navigateur client. La syntaxe complète est : CO=NAME:VAL:domain[:lifetime[:path[:secure[:httponly[samesite]]]]] details ... détails ... |
| discardpath|DPI | Supprime la partie PATH_INFO de l'URI réécrit. détails ... |
| END | Stoppe le processus de réécriture immédiatement et n'applique plus aucune règle. Empêche aussi l'application ultérieure de règles de réécriture dans les contextes de répertoire et de fichier .htaccess (disponible à partir de la version 2.3.9 du serveur HTTP Apache). détails ... |
| env|E=[!]VAR[:VAL] | Définit la variable d'environnement VAR (à la valeur VAL si elle est fournie). La variante !VAR annule la définition de la variable VAR.détails ... |
| forbidden|F | Renvoie une réponse 403 FORBIDDEN au navigateur client. détails ... |
| gone|G | Renvoie un message d'erreur 410 GONE au navigateur client. détails ... |
| Handler|H=Gestionnaire de contenu | L'URI résultant est envoyé au Gestionnaire de contenu pour traitement. détails ... |
| last|L | Arrête le processus de réécriture immédiatement et n'applique plus aucune règle. Prêtez une attention particulière aux mises en garde concernant les contextes de niveau répertoire et .htaccess (voir aussi le drapeau END). détails ... |
| next|N | Réexécute le processus de réécriture à partir de la première règle, en utilisant le résultat du jeu de règles, sous réserve qu'il y ait un point de départ. détails ... |
| nocase|NC | Rend la comparaison entre modèles insensible à la casse. détails ... |
| noescape|NE | Empêche mod_rewrite d'effectuer un échappement hexadécimal des caractères spéciaux dans le résultat des réécritures qui aboutissent à une redirection. détails ... |
| nosubreq|NS | La règle est sautée si la requête courante est une sous-requête interne. détails ... |
| proxy|P | Force l'envoi en interne de l'URL de substitution en tant que requête mandataire. détails ... |
| passthrough|PT | L'URI résultant est repassé au moteur de mise en
correspondance des URLs pour y être traité par d'autres
traducteurs URI-vers-nom de fichier, comme Alias ou
Redirect. détails ... |
| qsappend|QSA | Ajoute toute chaîne de paramètres présente dans l'URL de la requête originale à toute chaîne de paramètres créée dans la cible de réécriture. détails ... |
| qsdiscard|QSD | Supprime toute chaîne de paramètres de l'URI entrant. détails ... |
| qslast|QSL | Interprète le dernier (le plus à droite) point d'interrogation comme le délimiteur de la chaîne de paramètres de la requête, au lieu du premier (le plus à gauche) comme c'est le cas habituellement. Disponble à partir de la version 2.4.19 du serveur HTTP Apache. détails ... |
| redirect|R[=code] | Force une redirection externe, avec un code de statut HTTP optionnel. détails ... |
| skip|S=nombre | Si la règle courante s'applique, le moteur de réécriture doit sauter les nombre règles suivantes. détails ... |
| type|T=MIME-type | Force l'attribution du Type-MIME spécifié au fichier cible. détails ... |
| UnsafeAllow3F | Autorise les substitutions à partir d’URL potentiellement non fiables. détails ... |
| UnsafePrefixStat | Autorise les substitutions potentiellement non fiables à partir
d’une variable de tête ou d’une référence arrière vers un chemin du
système de fichiers.
détails ... Disponible à partir de la version 2.4.60 du serveur HTTP Apache. |
| UNC |
Empêche la fusion des slashes de début multiples tels que ceux utilisés
dans les chemins UNC de Windows.
détails ... Disponible à partir de la version 2.4.62 du serveur HTTP Apache. |
Quand la chaîne de substitution commence par quelque chose comme
"/~user" (de manière explicite ou par références arrières), mod_rewrite
développe le répertoire home sans tenir compte de la présence ou de la
configuration du module mod_userdir.
Ce développement n'est pas effectué si le drapeau PT est
utilisé dans la directive RewriteRule
Voici toutes les combinaisons de substitution et leurs significations :
Dans la configuration au niveau du serveur principal
(httpd.conf)
pour la requête ``GET
/chemin/infochemin'':
| Règle | Résultat de la substitution |
|---|---|
| ^/un_chemin(.*) autre_chemin$1 | invalide, non supporté |
| ^/un_chemin(.*) autre_chemin$1 [R] | invalide, non supporté |
| ^/un_chemin(.*) autre_chemin$1 [P] | invalide, non supporté |
| ^/un_chemin(.*) /autre_chemin$1 | /autre_chemin/info_chemin |
| ^/un_chemin(.*) /autre_chemin$1 [R] | http://cet_hote/autre_chemin/info_chemin via une redirection externe |
| ^/un_chemin(.*) /autre_chemin$1 [P] | sans objet, non supporté |
| ^/un_chemin(.*) http://cet_hote/autre_chemin$1 | /autre_chemin/info_chemin |
| ^/un_chemin(.*) http://cet_hote/autre_chemin$1 [R] | http://cet_hote/autre_chemin/info_chemin via une redirection externe |
| ^/un_chemin(.*) http://cet_hote/autre_chemin$1 [P] | sans objet, non supporté |
| ^/un_chemin(.*) http://autre_hote/autre_chemin$1 | http://autre_hote/autre_chemin/info_chemin via une redirection externe |
| ^/un_chemin(.*) http://autre_hote/autre_chemin$1 [R] | http://autre_hote/autre_chemin/info_chemin (le drapeau [R] est redondant) |
| ^/somepath(.*) http://otherhost/otherpath$1 [P] | http://otherhost/otherpath/pathinfo via internal proxy |
Dans une configuration de niveau répertoire pour
/chemin
(/chemin/physique/vers/chemin/.htacccess, avec
RewriteBase "/chemin")
pour la requête ``GET
/chemin/chemin-local/infochemin'':
| Règle | Résultat de la substitution |
|---|---|
| ^chemin-local(.*) autre-chemin$1 | /chemin/autre-chemin/infochemin |
| ^chemin-local(.*) autre-chemin$1 [R] | http://cet-hôte/chemin/autre-chemin/infochemin via redirection externe |
| ^chemin-local(.*) autre-chemin$1 [P] | n'a pas lieu d'être, non supporté |
| ^chemin-local(.*) /autre-chemin$1 | /autre-chemin/infochemin |
| ^chemin-local(.*) /autre-chemin$1 [R] | http://cet-hôte/autre-chemin/infochemin via redirection externe |
| ^chemin-local(.*) /autre-chemin$1 [P] | n'a pas lieu d'être, non supporté |
| ^chemin-local(.*) http://cet-hôte/autre-chemin$1 | /autre-chemin/infochemin |
| ^chemin-local(.*) http://cet-hôte/autre-chemin$1 [R] | http://cet-hôte/autre-chemin/infochemin via redirection externe |
| ^chemin-local(.*) http://cet-hôte/autre-chemin$1 [P] | n'a pas lieu d'être, non supporté |
| ^chemin-local(.*) http://autre hôte/autre-chemin$1 | http://autre hôte/autre-chemin/infochemin via redirection externe |
| ^chemin-local(.*) http://autre hôte/autre-chemin$1 [R] | http://autre hôte/autre-chemin/infochemin via redirection externe (le drapeau [R] est redondant) |
| ^chemin-local(.*) http://autre hôte/autre-chemin$1 [P] | http://autre hôte/autre-chemin/infochemin via un mandataire interne |
Serveur HTTP Apache Version 2.4
| Description: | Support des sessions basé sur les cookies |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | session_cookie_module |
| Fichier Source: | mod_session_cookie.c |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache |
Les modules de session font usage des cookies HTTP, et peuvent à ce titre être victimes d'attaques de type Cross Site Scripting, ou divulguer des informations à caractère privé aux clients. Veuillez vous assurer que les risques ainsi encourus ont été pris en compte avant d'activer le support des sessions sur votre serveur.
Ce sous-module du module mod_session fournit le
support du stockage des sessions utilisateur au niveau du navigateur
distant dans des cookies HTTP.
L'utilisation de cookies pour stocker les sessions décharge le serveur ou le groupe de serveurs de la nécessité de stocker les sessions localement, ou de collaborer pour partager les sessions, et peut être utile dans les environnements à fort trafic où le stockage des sessions sur le serveur pourrait s'avérer trop consommateur de ressources.
Si la confidentialité de la session doit être préservée, le
contenu de cette dernière peut être chiffré avant d'être enregistré
au niveau du client à l'aide du module
mod_session_crypto.
Pour plus de détails à propos de l'interface des sessions, voir
la documentation du module mod_session.
Pour créer une session et la stocker dans un cookie nommé session, configurez-la comme suit :
Session On SessionCookieName session path=/
Pour plus d'exemples sur la manière dont une session doit être
configurée pour qu'une application CGI puisse l'utiliser, voir la
section exemples de la documentation du module
mod_session.
Pour des détails sur la manière dont une session peut être
utilisée pour stocker des informations de type nom
d'utilisateur/mot de passe, voir la documentation du module
mod_auth_form.
| Description: | Nom et attributs du cookie RFC2109 dans lequel la session est stockée |
|---|---|
| Syntaxe: | SessionCookieName nom attributs |
| Défaut: | none |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session_cookie |
La directive SessionCookieName permet de
spécifier le nom et les attributs optionnels d'un cookie compatible
RFC2109 dans lequel la session sera stockée. Les cookies RFC2109
sont définis en utilisant l'en-tête HTTP Set-Cookie.
Une liste optionnelle d'attributs peut être spécifiée, comme dans l'exemple suivant. Ces attributs sont insérés tels quels dans le cookie, et ne sont pas interprétés par Apache. Assurez-vous que vos attributs soient définis correctement selon la spécification des cookies.
Session On SessionCookieName session path=/private;domain=example.com;httponly;secure;version=1;
| Description: | Nom et attributs pour le cookie RFC2965 dans lequel est stockée la session |
|---|---|
| Syntaxe: | SessionCookieName2 nom attributs |
| Défaut: | none |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session_cookie |
La directive SessionCookieName2 permet de
spécifier le nom et les attributs optionnels d'un cookie compatible
RFC2965 dans lequel la session sera stockée. Les cookies RFC2965
sont définis en utilisant l'en-tête HTTP
Set-Cookie2.
Une liste optionnelle d'attributs peut être spécifiée, comme dans l'exemple suivant. Ces attributs sont insérés tels quels dans le cookie, et ne sont pas interprétés par Apache. Assurez-vous que vos attributs soient définis correctement selon la spécification des cookies.
Session On SessionCookieName2 session path=/private;domain=example.com;httponly;secure;version=1;
| Description: | Détermine si les cookies de session doivent être supprimés des en-têtes HTTP entrants |
|---|---|
| Syntaxe: | SessionCookieRemove On|Off |
| Défaut: | SessionCookieRemove Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session_cookie |
La directive SessionCookieRemove permet de
déterminer si les cookies contenant la session doivent être
supprimés des en-têtes pendant le traitement de la requête.
Dans le cas d'un mandataire inverse où le serveur Apache sert de frontal à un serveur d'arrière-plan, révéler le contenu du cookie de session à ce dernier peut conduire à une violation de la confidentialité. À ce titre, si cette directive est définie à "on", le cookie de session sera supprimé des en-têtes HTTP entrants.
Serveur HTTP Apache Version 2.4
| Description: | Renvoie un corps de requête comme réponse via la pile de filtres en sortie. |
|---|---|
| Statut: | Base |
| Identificateur de Module: | reflector_module |
| Fichier Source: | mod_reflector.c |
| Compatibilité: | Versions 2.3 et ultérieures |
Ce module permet de renvoyer un corps de requête au client, après l'avoir fait passer par la pile de filtres en sortie. Une chaîne de filtres configurée de manière appropriée peut être utilisée pour transformer la requête en réponse. Ce module peut ainsi être utilisé pour transformer un filtre en sortie en service HTTP.
<Location "/compress">
SetHandler reflector
SetOutputFilter DEFLATE
</Location>
<Location "/downsample">
SetHandler reflector
SetOutputFilter DOWNSAMPLE
</Location>
| Description: | Renvoie un en-tête d'entrée dans les en-têtes de sortie |
|---|---|
| Syntaxe: | ReflectorHeader en-tête-entrée [en-tête-sortie] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Base |
| Module: | mod_reflector |
Cette directive permet de contrôler la répercution des en-têtes de la requête dans la réponse. Le premier argument correspond au nom de l'en-tête à copier. Si le second argument (optionnel) est spécifié, il définit le nom sous lequel l'en-tête sera répercuté dans la réponse ; dans le cas contraire, c'est le nom de l'en-tête original qui sera utilisé.
Serveur HTTP Apache Version 2.4
| Description: | Filtres permettant de traiter et de mettre à disposition les corps de requêtes HTTP |
|---|---|
| Statut: | Base |
| Identificateur de Module: | request_module |
| Fichier Source: | mod_request.c |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache |
| Description: | Conserve le corps de la requête à concurrence de la taille maximale spécifiée, pour une utilisation éventuelle par des filtres comme mod_include. |
|---|---|
| Syntaxe: | KeptBodySize taille maximale en octets |
| Défaut: | KeptBodySize 0 |
| Contexte: | répertoire |
| Statut: | Base |
| Module: | mod_request |
Dans une situation normale, les gestionnaires de requête tels que
le gestionnaire par défaut des fichiers statiques suppriment le
corps de la requête s'il n'est pas nécessaire au gestionnaire de
requête. Il en résulte que les filtres comme mod_include sont
limités à des requêtes GET lors de l'inclusion d'autres
URLs en tant que sous-requêtes, et ceci même si la requête originale
était une requête POST, car le corps de la requête a
été supprimé et n'est donc plus disponible une fois le traitement du
filtre mis en oeuvre.
Lorsque l'argument de cette directive a une valeur supérieure à
zéro, les gestionnaires de requête qui suppriment habituellement les
corps de requête vont alors conserver ces corps de requête, à
concurrence de la taille maximale spécifiée, pour être
éventuellement utilisés par des filtres. Dans le cas du filtre
mod_include, une tentative de requête POST pour un
fichier shtml statique se traduira par des sous-requêtes
POST, et non par des sous-requêtes GET
comme avant.
Cette fonctionnalité permet de découper des pages web complexes
et des applications web en petits éléments individuels, et de
combiner ces éléments avec la structure de la page web sous-jacente
en utilisant mod_include. Les éléments peuvent se
présenter sous la forme de programmes CGI, de langages de scripts,
ou d'URLs issues d'un mandataire inverse dans l'espace d'URL d'un
autre serveur en utilisant mod_proxy.
Note : Chaque requête dont le corps est ainsi conservé doit être enregistrée temporairement en mémoire vive jusqu'à la fin du traitement de la requête. Il faut donc s'assurer que la mémoire RAM du serveur est suffisante pour pouvoir supporter la charge induite. L'utilisation de cette directive doit être limitée à certaines portions de votre espace d'URL bien précises qui le nécessitent, et en spécifiant comme taille maximale une valeur la plus petite possible, mais tout de même suffisante pour un corps de requête.
Si la taille de la requête envoyée par le client dépasse la taille
maximale autorisée par cette directive, le serveur renverra l'erreur
413 Request Entity Too Large.
Serveur HTTP Apache Version 2.4
| Description: | Permet de définir des variables d'environnement en fonction de certainescaractéristiques de la requête |
|---|---|
| Statut: | Base |
| Identificateur de Module: | setenvif_module |
| Fichier Source: | mod_setenvif.c |
Le module mod_setenvif vous permet de définir
des variables d'environnement internes de manière conditionnelle en fonction
de critères que vous pouvez spécifier. Ces variables d'environnement
peuvent être utilisées par d'autres parties du serveur pour prendre
des décisions quant aux actions à entreprendre, et pour déterminer
si les scripts CGI et les pages SSI doivent pouvoir y accéder.
Les directives sont interprétées selon l'ordre dans lequel elles apparaîssent dans les fichiers de configuration. Ainsi, des séquences plus complexes peuvent être utilisées, comme dans cet exemple qui définit netscape si le navigateur est Mozilla et non MSIE.
BrowserMatch ^Mozilla netscape BrowserMatch MSIE !netscape
Lorsque le serveur cherche un chemin via une sous-requête interne (par exemple la
recherche d'un DirectoryIndex), ou lorsqu'il génère un
listing du contenu d'un répertoire via le module
mod_autoindex, la sous-requête n'hérite pas des
variables d'environnement spécifiques à la requête. En outre, à cause
des phases de l'API auxquelles mod_setenvif prend
part, les directives SetEnvIf ne sont pas évaluées
séparément dans la sous-requête.
| Description: | Définit des variables d'environnement en fonction du contenu de l'en-tête HTTP User-Agent |
|---|---|
| Syntaxe: | BrowserMatch regex [!]env-variable[=valeur]
[[!]env-variable[=valeur]] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_setenvif |
La directive BrowserMatch est un cas
particulier de la directive SetEnvIf, qui définit des variables
d'environnement en fonction du contenu de l'en-tête de requête HTTP
User-Agent. Les deux lignes suivantes produisent le même
effet :
BrowserMatch Robot is_a_robot SetEnvIf User-Agent Robot is_a_robot
Quelques exemples supplémentaires :
BrowserMatch ^Mozilla forms jpeg=yes browser=netscape BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript BrowserMatch MSIE !javascript
| Description: | Définit des variables d'environnement en fonction du contenu de l'en-tête HTTP User-Agent sans tenir compte de la casse |
|---|---|
| Syntaxe: | BrowserMatchNoCase regex [!]env-variable[=valeur]
[[!]env-variable[=valeur]] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_setenvif |
La directive BrowserMatchNoCase est
identique sur le plan sémantique à la directive BrowserMatch. Elle permet
cependant une comparaison insensible à la casse. Par exemple :
BrowserMatchNoCase mac platform=macintosh BrowserMatchNoCase win platform=windows
Les directives BrowserMatch et
BrowserMatchNoCase sont des cas particuliers
des directives SetEnvIf
et SetEnvIfNoCase.
Ainsi, les deux lignes suivantes produisent le même effet :
BrowserMatchNoCase Robot is_a_robot SetEnvIfNoCase User-Agent Robot is_a_robot
| Description: | Définit des variables d'environnement en fonction des attributs de la requête |
|---|---|
| Syntaxe: | SetEnvIf attribut
regex [!]env-variable[=valeur]
[[!]env-variable[=valeur]] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_setenvif |
La directive SetEnvIf permet de définir
des variables d'environnement en fonction des attributs de la
requête. L'attribut spécifié comme premier argument peut
se présenter sous l'une des trois formes suivantes :
Host,
User-Agent, Referer, ou
Accept-Language. Il est possible d'utiliser une
expression rationnelle pour spécifier un jeu d'en-têtes de
requête.Remote_Host - le nom d'hôte (s'il est disponible)
du client qui effectue la requêteRemote_Addr - l'adresse IP du client qui effectue
la requêteServer_Addr - l'adresse IP du serveur qui a reçu
la requête (uniquement à partir des versions supérieures à
2.0.43)Request_Method - Le nom de la méthode HTTP
utilisée (GET, POST, et
cetera...)Request_Protocol - le nom et la version du
protocole utilisé pour la requête (par exemple "HTTP/0.9",
"HTTP/1.1", etc...)Request_URI - la ressource demandée dans la ligne
de requête HTTP -- en général la partie de l'URL suivant le
protocole et le nom du serveur, sans la chaîne d'arguments. Voir
la directive RewriteCond du module
mod_rewrite pour plus d'informations sur la
manière de mettre en correspondance votre chaîne d'arguments.SetEnvIf d'effectuer des tests en fonction du
résultat de comparaisons précédentes. Seules les variables
d'environnement définies par des directives
SetEnvIf[NoCase] précédentes sont disponibles pour
effectuer des tests de cette manière. 'Précédentes' signifie qu'elles se
trouvent à un niveau plus global de la configuration (par exemple au
niveau du serveur principal), ou plus haut chronologiquement dans le
contexte de la directive. Les variables d'environnement ne seront prises
en compte que si aucune correspondance n'a été trouvée parmi les
caractéristiques de la requête, et si attribut n'a pas été
spécifié sous la forme d'une expression rationnelle.Le second argument (regex) est une expression rationnelle. Si regex correspond à l'attribut, les arguments suivants sont évalués.
Le reste des arguments constitue les noms des variables à définir, ainsi que les valeurs optionnelles qui doivent leur être affectées. Ils peuvent se présenter sous les formes suivantes :
nom-variable, ou!nom-variable, ounom-variable=valeurDans la première forme, la valeur sera définie à "1". Dans la
seconde forme, la variable sera supprimée si elle a été définie au
préalable, et dans la troisième forme, la variable sera définie à la
valeur littérale spécifiée par valeur. Depuis
la version 2.0.51, Apache httpd reconnaît les occurrences de variables
$1..$9 à l'intérieur de
valeur, et les remplace par les
sous-expressions entre parenthèses correspondantes de
regex. $0 permet d'accéder à l'ensemble de la chaîne
qui correspond à ce modèle.
SetEnvIf Request_URI "\.gif$" object_is_image=gif
SetEnvIf Request_URI "\.jpg$" object_is_image=jpg
SetEnvIf Request_URI "\.xbm$" object_is_image=xbm
SetEnvIf Referer www\.mydomain\.example\.com intra_site_referral
SetEnvIf object_is_image xbm XBIT_PROCESSING=1
SetEnvIf Request_URI "\.(.*)$" EXTENSION=$1
SetEnvIf ^TS ^[a-z] HAVE_TS
Les trois premières lignes définissent la variable
d'environnement objet_est_une_image si l'objet de la
requête est un fichier image, et la quatrième définit la variable
intra_site_referral si la page référante se trouve
quelque part dans le site web
www.mydomain.example.com.
La dernière ligne définit la variable d'environnement
HAVE_TS si la requête contient un en-tête dont le nom
commence par "TS" et dont la valeur commence par tout caractère du
jeu [a-z].
| Description: | Définit des variables d'environnement en fonction d'une expression ap_expr |
|---|---|
| Syntaxe: | SetEnvIfExpr expr
[!]env-variable[=valeur]
[[!]env-variable[=valeur]] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_setenvif |
La directive SetEnvIfExpr permet de définir des
variables d'environnement en fonction d'une expression. Cette expression est évaluée à
l'exécution, et les différentes variables d'environnement
env-variable définies de la même manière que la directive
SetEnvIf, y compris les références arrières.
SetEnvIfExpr "tolower(req('X-Sendfile')) == 'd:\images\very_big.iso')" iso_delivered
SetEnvIfExpr "tolower(req('X-Sendfile')) =~ /(.*\.iso$)/" iso-path=$1
Dans cet exemple, la variable d'environnement
iso_delivered est définie chaque fois que notre
application tente de l'envoyer via X-Sendfile.
Il pourrait être plus utile de définir une variable rfc1918 si l'adresse IP distante est une adresse privée au sens de la RFC 1918 :
SetEnvIfExpr "-R '10.0.0.0/8' || -R '172.16.0.0/12' || -R '192.168.0.0/16'" rfc1918
<If> permet d'obtenir des résultats
similaires.mod_filter| Description: | Définit des variables d'environnement en fonction des attributs de la requête sans tenir compte de la casse |
|---|---|
| Syntaxe: | SetEnvIfNoCase attribut regex
[!]env-variable[=valeur]
[[!]env-variable[=valeur]] ... |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Base |
| Module: | mod_setenvif |
La directive SetEnvIfNoCase est identique
d'un point de vue sémantique à la directive SetEnvIf, et ne s'en distingue que
par le fait que la comparaison des expressions rationnelles est
effectuée sans tenir compte de la casse. Par exemple :
SetEnvIfNoCase Host Example\.Org site=example
Cette ligne va définir la variable d'environnement
site avec la valeur "example" si le champ
d'en-tête de requête HTTP Host: est présent et contient
Example.Org, example.org, ou une autre
combinaison des mêmes caractères, sans tenir compte de la casse.
Serveur HTTP Apache Version 2.4
| Description: | Chargement de modules ou de code exécutable au cours du démarrage ou du redémarrage du serveur |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | so_module |
| Fichier Source: | mod_so.c |
| Compatibilité: | Sous Windows, c'est un module de base (toujours inclus) |
Sur les systèmes d'exploitation sélectionnés, ce module peut être utilisé pour charger des modules dans le serveur HTTP Apache en cours d'exécution grâce au mécanisme des Dynamic Shared Object ou Objets Partagés Dynamiquement (DSO), et évite ainsi de devoir effectuer une recompilation.
Sous Unix, le code chargé provient en général de fichiers objet
partagés possèdant en général l'extension .so, alors
que sous Windows, l'extension peut être soit .so, soit
.dll.
En général, les modules compilés pour une version majeure du serveur HTTP Apache ne fonctionneront pas avec une autre (par exemple de 1.3 à 2.0 ou 2.0 à 2.2). D'une version majeure à l'autre, il y a souvent des modifications d'API qui nécessitent des modifications du module pour qu'il puisse fonctionner avec la nouvelle version.
Sous Windows, où les modules chargeables possèdent en général
l'extension de nom de fichier .dll, les modules Apache
httpd se nomment mod_nom-module.so, tout comme sur les
autres plates-formes. Vous trouverez cependant encore des modules
tiers, comme PHP par exemple, qui continuent d'utiliser la
convention de nommage avec extension .dll.
Bien que mod_so puisse encore charger des modules
possèdant un nom du style ApacheModuleFoo.dll,
il est préférable d'utiliser la
nouvelle convention de nommage ; si vous modifiez votre module
chargeable pour la version 2.0, veuillez aussi modifier son nom pour
respecter cette nouvelle convention.
Les API des modules Apache httpd sous Unix et Windows sont identiques. Alors que certains modules s'appuient sur certains aspects de l'architecture Unix non présents dans Windows, et ne fonctionneront donc pas sur cette dernière plate-forme, de nombreux modules fonctionnent sous Windows avec peu ou pas de modification par rapport à leur version Unix.
Lorsqu'un module fonctionne, il peut être ajouté au serveur de
deux manières. Sous Unix, il peut être compilé dans le serveur.
Comme Apache httpd pour Windows ne dispose pas du programme
Configure propre à Apache httpd pour Unix, le fichier source
du module doit être ajouté au fichier projet Apache de base, et ses
symboles ajoutés au fichier os\win32\modules.c.
La seconde méthode consiste à compiler le module en tant que DLL,
à savoir une bibliothèque partagée qui pourra être chargée dans le
serveur en cours d'exécution via la directive
LoadModule. Ces modules DLL
peuvent être distribués et exécutés sur toute installation d'Apache
httpd pour Windows, sans avoir à recompiler le serveur.
Pour créer un module DLL, il est nécessaire d'apporter une légère
modification à son fichier source : l'enregistrement du module doit
être exporté depuis la DLL (qui sera elle-même créée plus tard ;
voir plus loin). Pour ce faire, ajoutez la macro
AP_MODULE_DECLARE_DATA (définie dans les fichiers
d'en-têtes d'Apache httpd) à la définition de l'enregistrement de votre
module. Par exemple, si votre module est déclaré comme suit :
module foo_module;
Remplacez cette ligne par :
module AP_MODULE_DECLARE_DATA foo_module;
Notez que cette macro ne sera prise en compte que sous Windows,
si bien que le module poura être utilisé sans changement sous Unix,
si besoin est. Alternativement, si vous êtes familier avec les
fichiers .DEF, vous pouvez les utiliser pour exporter
l'enregistrement du module.
Maintenant, nous sommes prêts à créer une DLL contenant notre module. Il va falloir pour cela la lier avec la bibliothèque d'export libhttpd.lib qui a été créée au cours de la compilation de la bibliothèque partagée libhttpd.dll. Il sera peut-être aussi nécessaire de modifier la configuration du compilateur pour s'assurer que les fichiers d'en-têtes d'Apache httpd seront correctement localisés. Vous trouverez cette bibliothèque à la racine du répertoire des modules de votre serveur. Il est souhaitable d'utiliser un fichier de module .dsp existant dans l'arborescence afin de s'assurer que l'environnement de compilation est correctement configuré, mais vous pouvez aussi comparer les options de compilation et d'édition de liens à votre fichier .dsp.
Ceci devrait créer une version DLL de votre module. Il vous
suffit maintenant de l'enregistrer dans le répertoire
modules à la racine de votre serveur, et d'utiliser la
directive LoadModule pour la charger.
| Description: | Liaison du fichier objet ou de la bibliothèque spécifié |
|---|---|
| Syntaxe: | LoadFile nom-fichier [nom-fichier] ... |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_so |
La directive LoadFile permet de lier le fichier
objet ou la bibliothèque spécifié au serveur lors du
démarrage ou du redémarrage
de ce dernier ; ceci permet d'ajouter tout code additionnel
nécessaire au fonctionnement d'un module.
nom-fichier est soit un chemin absolu, soit un chemin
relatif au répertoire défini par la directive ServerRoot.
Par exemple :
LoadFile "libexec/libxmlparse.so"
| Description: | Liaison avec le serveur du fichier objet ou de la bibliothèque spécifié, et ajout de ce dernier à la liste des modules actifs |
|---|---|
| Syntaxe: | LoadModule module nom-fichier |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_so |
La directive LoadModule permet de lier le fichier objet ou la
bibliothèque nom-fichier avec le serveur, et d'ajouter la
structure de module nommée module à la liste des modules
actifs. module est le nom de la variable externe de type
module dans le fichier, et est référencé comme Identificateur de
module dans la documentation des modules.
Par exemple :
LoadModule status_module "modules/mod_status.so"
charge le module spécifié depuis le sous-répertoire des modules situé à la racine du serveur.
Serveur HTTP Apache Version 2.4
| Description: | Fournisseur de cache d'objets partagés basé sur Memcache. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | socache_memcache_module |
| Fichier Source: | mod_socache_memcache.c |
Le module mod_socache_memcache est un fournisseur de cache
d'objets partagés qui permet la création et l'accès à un cache
maintenu par le système de mise en cache d'objets en mémoire
distribuée à hautes performances memcached.
Cette méthode "create" du fournisseur de cache d'objets partagés
requiert une liste de spécifications hôte/port en cache mémoire
séparées par des virgules. Si vous utilisez ce fournisseur
dans la configuration d'autres modules (comme
SSLSessionCache), vous devez
fournir la liste des serveurs sous la forme du paramètre optionnel
"arg".
SSLSessionCache memcache:memcache.example.com:12345,memcache2.example.com:12345
Vous trouverez des détails à propos des autres fournisseurs de cache d'objets partagés ici.
| Description: | Durée de conservation des connexions inactives |
|---|---|
| Syntaxe: | MemcacheConnTTL num[units] |
| Défaut: | MemcacheConnTTL 15s |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_socache_memcache |
| Compatibilité: | Disponible à partir de la version 2.4.17 du serveur HTTP Apache. |
Définit la durée pendant laquelle les connexions inactives avec le(s) serveur(s) memcache seront conservées (plateformes threadées seulement).
Les valeurs valides de la directive
MemcacheConnTTL sont des durées d'une heure
maximum. La valeur 0 signifie une absence de péremption
L'unité par défaut pour ce délai est la seconde, mais vous pouvez ajouter un suffixe pour spécifier une unité différente ; ms pour milliseconde, s pour seconde, min pour minute et h pour heure..
Dans les versions antérieures à 2.4.17, ce délai était codé en
dur et sa valeur était 600 microsecondes. La valeur la plus proche
de cette ancienne valeur pour la directive
MemcacheConnTTL est donc 1ms.
# Définition d'un délai de 10 minutes MemcacheConnTTL 10min # Définition d'un délai de 60 secondes MemcacheConnTTL 60
Serveur HTTP Apache Version 2.4
| Description: | Tente de corriger les erreurs de casse dans les URLs ou les fautes de frappe mineures. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | speling_module |
| Fichier Source: | mod_speling.c |
Il arrive que des requêtes pour des documents ne puissent pas être traitées par le serveur Apache de base à cause d'une erreur de frappe ou de casse. Ce module permet de traiter ce problème en essayant de trouver un document correspondant, même lorsque tous les autres modules y ont renoncé. Sa méthode de travail consiste à comparer chaque nom de document du répertoire demandé avec le document de la requête sans tenir compte de la casse, et en acceptant jusqu'à une erreur (insertion, omission, inversion de caractère ou caractère erroné). Une liste de tous les documents qui correspondent est alors élaborée en utilisant cette stratégie. Ce module traite aussi les erreurs dans les extensions de fichiers.
Si après le parcours du répertoire,
404 - document not found).301 - Moved Permanently).300 - Multiple
Choices).| Description: | Vérifie aussi la correspondance des fichiers, même avec des extensions différentes |
|---|---|
| Syntaxe: | CheckBasenameMatch on|off |
| Défaut: | CheckBasenameMatch On |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Extension |
| Module: | mod_speling |
| Compatibilité: | Disponible à partir de la version 2.4.50 du serveur HTTP Apache |
Lorsqu'elle est définie, cette directive étend le processus de correction
orthographique à l'extension des noms de fichiers. Par exemple, un fichier
de nom foo.gif sera pris en compte par une requête pour
foo ou foo.jpg. Ceci peut s'avérer
particulièrement utile en conjonction avec les MultiViews.
| Description: | Limite l'action du module aux corrections de majuscules |
|---|---|
| Syntaxe: | CheckCaseOnly on|off |
| Défaut: | CheckCaseOnly Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Extension |
| Module: | mod_speling |
Lorsqu'elle est définie à "on", cette directive permet de limiter
l'action du module aux inversions majuscule/minuscule. Les autres
corrections éventuelles ne seront effectuées que si la directive CheckBasenameMatch est elle aussi définie.
| Description: | Active le module de correction |
|---|---|
| Syntaxe: | CheckSpelling on|off |
| Défaut: | CheckSpelling Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | Options |
| Statut: | Extension |
| Module: | mod_speling |
Cette directive permet d'activer ou de désactiver le module de correction. Lorsqu'il est activé, rappelez-vous que :
http://mon.serveur/~apahce/), mais seulement les noms
de fichiers ou de répertoires.<Location
/status> pour être traitée de manière incorrecte comme
une requête pour le fichier négocié "/stats.html".mod_speling ne doit pas être activé pour des répertoires
où DAV l'est aussi, car il va essayer de
"corriger" les noms des ressources nouvellement créées en fonction des noms
de fichiers existants ; par exemple, lors du chargement d'un nouveau
document doc43.html, il est possible qu'il redirige vers un
document existant doc34.html, ce qui ne correspond pas à ce que
l'on souhaite.
Serveur HTTP Apache Version 2.4
| Description: | Filtre les contenus en entrée (requêtes) et en sortie
(réponses) en utilisant la syntaxe de sed |
|---|---|
| Statut: | |
| Identificateur de Module: | sed_module |
| Fichier Source: | mod_sed.c sed0.c sed1.c regexp.c regexp.h sed.h |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache |
mod_sed est un filtre de contenu "in-process". Le
filtre mod_sed fournit les commandes d'édition de
sed implémentées par le programme sed de
Solaris 10 comme décrit dans la page de
manuel. Cependant, à la différence de sed,
mod_sed ne reçoit pas de données sur son entrée
standard. Au lieu de cela, le filtre agit sur les données échangées
entre le client et le serveur. mod_sed peut être
utilisé comme filtre en entrée ou en sortie. mod_sed
est un filtre de contenu, ce qui signifie qu'on ne peut pas l'utiliser
pour modifier les en-têtes http du client ou du serveur.
Le filtre en sortie mod_sed accepte un tronçon de
données, exécute le script sed sur ces données, puis génère
une sortie qui est transmise au filtre suivant dans la chaîne.
Le filtre en entrée mod_sed reçoit des données en
provenance du filtre suivant dans la chaîne, exécute les scripts
sed, et renvoie les données générées au filtre appelant
dans la chaîne de filtrage.
Les filtres en entrée ou en sortie ne traitent les données que si des caractères newline sont détectés dans le contenu à filtrer. A la fin des données, ce qui reste est traité comme la dernière ligne. A partir de la version 2.4.54 du serveur HTTP Apache, les lignes d'une taille supérieure à 8 Mo provoquent une erreur.
# Dans l'exemple suivant, le filtre sed va remplacer la chaîne
# "monday" par "MON" et la chaîne "sunday" par "SUN" dans les
# documents html avant de les envoyer au client.
<Directory "/var/www/docs/sed">
AddOutputFilter Sed html
OutputSed "s/monday/MON/g"
OutputSed "s/sunday/SUN/g"
</Directory>
# Dans l'exemple suivant, le filtre sed va remplacer la chaîne
# "monday" par "MON" et la chaîne "sunday" par "SUN" dans les
# données POST envoyées à PHP.
<Directory "/var/www/docs/sed">
AddInputFilter Sed php
InputSed "s/monday/MON/g"
InputSed "s/sunday/SUN/g"
</Directory>
Vous trouverez tous les détails à propos de la commande
sed dans sa page
de manuel.
bhHgGx| Description: | Commande sed à exécuter pour le filtrage des données d'une
requête (en général des données POST) |
|---|---|
| Syntaxe: | InputSed commande-sed |
| Contexte: | répertoire, .htaccess |
| Statut: | |
| Module: | mod_sed |
La directive InputSed permet de spécifier
la commande sed à exécuter pour le filtrage des données (en général
des données POST) d'une requête.
Serveur HTTP Apache Version 2.4
| Description: | Support du chiffrement des sessions |
|---|---|
| Statut: | Expérimental |
| Identificateur de Module: | session_crypto_module |
| Fichier Source: | mod_session_crypto.c |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache |
Les modules de session font usage des cookies HTTP, et peuvent à ce titre être victimes d'attaques de type Cross Site Scripting, ou divulguer des informations à caractère privé aux clients. Veuillez vous assurer que les risques ainsi encourus ont été pris en compte avant d'activer le support des sessions sur votre serveur.
Ce sous-module du module mod_session fournit le
support du chiffrement des sessions utilisateur avant de les
enregistrer dans une base de données locale, ou dans un cookie HTTP
au niveau du navigateur distant.
Il peut contribuer à préserver la confidentialité des sessions lorsque leur contenu doit rester privé pour l'utilisateur, ou lorsqu'une protection contre les attaques de type cross site scripting est nécessaire.
Pour plus de détails à propos de l'interface des sessions, voir
la documentation du module mod_session.
Pour créer une session chiffrée et la stocker dans un cookie nommé session, configurez la comme suit :
Session On SessionCookieName session path=/ SessionCryptoPassphrase secret
La session sera chiffrée avec la clé spécifiée. Il est possible de configurer plusieurs serveurs pour qu'ils puissent partager des sessions, en s'assurant que la même clé de chiffrement est utilisée sur chaque serveur.
Si la clé de chiffrement est modifiée, les sessions seront automatiquement invalidées.
Pour des détails sur la manière dont une session peut être
utilisée pour stocker des informations de type nom
d'utilisateur/mot de passe, voir la documentation du module
mod_auth_form.
| Description: | L'algorithme à utiliser pour le chiffrement de la session |
|---|---|
| Syntaxe: | SessionCryptoCipher algorithme |
| Défaut: | SessionCryptoCipher aes256 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Expérimental |
| Module: | mod_session_crypto |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache |
La directive SessionCryptoCipher permet de
spécifier l'algorithme à utiliser pour le chiffrement. En l'absence
de spécification, l'algorithme par défaut est aes256.
L'algorithme peut être choisi, en fonction du moteur de chiffrement utilisé, parmi les valeurs suivantes :
| Description: | Le pilote de chiffrement à utiliser pour chiffrer les sessions |
|---|---|
| Syntaxe: | SessionCryptoDriver nom [param[=valeur]] |
| Défaut: | aucun |
| Contexte: | configuration globale |
| Statut: | Expérimental |
| Module: | mod_session_crypto |
| Compatibilité: | Disponible depuis la version 2.3.0 d'Apache |
La directive SessionCryptoDriver permet de
spécifier le nom du pilote à utiliser pour le chiffrement. Si aucun
pilote n'est spécifié, le pilote utilisé par défaut sera le pilote
recommandé compilé avec APR-util.
Le pilote de chiffrement NSS nécessite certains paramètres de configuration, qui seront spécifiés comme arguments de la directive avec des valeurs optionnelles après le nom du pilote.
SessionCryptoDriver nss
SessionCryptoDriver nss dir=certs
SessionCryptoDriver nss dir=certs clé3=clé3.db cert7=cert7.db secmod=secmod
SessionCryptoDriver nss "dir=My Certs" key3=key3.db cert7=cert7.db secmod=secmod
Le pilote de chiffrement NSS peut avoir été configuré
au préalable dans une autre partie du serveur, par exemple depuis
mod_nss ou mod_ldap. Si c'est le
cas, un avertissement sera enregistré dans le journal, et la
configuration existante s'en trouvera affectée. Pour éviter cet
avertissement, utilisez le paramètre noinit comme suit :
SessionCryptoDriver nss noinit
Pour éviter la confusion, assurez-vous que tous les modules utilisant NSS soient configurés avec des paramètres identiques.
Le pilote de chiffrement openssl accepte un paramètre optionnel permettant de spécifier le moteur de chiffrement à utiliser.
SessionCryptoDriver openssl engine=nom-moteur
| Description: | La clé utilisée pour chiffrer la session |
|---|---|
| Syntaxe: | SessionCryptoPassphrase secret [ secret ... ] |
| Défaut: | none |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Expérimental |
| Module: | mod_session_crypto |
| Compatibilité: | Disponible depuis la version 2.3.0 d'Apache |
La directive SessionCryptoPassphrase
permet de spécifier les clés à utiliser pour chiffrer de manière
symétrique le contenu de la session avant de l'enregistrer, ou pour
déchiffrer le contenu de la session après sa lecture.
L'utilisation de clés longues et composées de caractères vraiment aléatoires est plus performant en matière de sécurité. Modifier une clé sur un serveur a pour effet d'invalider toutes les sessions existantes.
Il est possible de spécifier plusieurs clés afin de mettre en oeuvre la rotation de clés. La première clé spécifiée sera utilisée pour le chiffrement, alors que l'ensemble des clés spécifiées le sera pour le déchiffrement. Pour effectuer une rotation périodique des clés sur plusieurs serveurs, ajoutez une nouvelle clé en fin de liste, puis, une fois la rotation complète effectuée, supprimez la première clé de la liste.
Depuis la version 2.4.7, si la valeur de l'argument commence par exec: , la commande spécifiée sera exécutée, et la première ligne que cette dernière renverra sur la sortie standard sera utilisée comme clé.
# clé spécifiée et utilisée en tant que tel SessionCryptoPassphrase secret # exécution de /path/to/program pour générer la clé SessionCryptoPassphrase exec:/path/to/program # exécution de /path/to/program avec un argument pour générer la clé SessionCryptoPassphrase "exec:/path/to/otherProgram argument1"
| Description: | Le fichier contenant les clés utilisées pour chiffrer la session |
|---|---|
| Syntaxe: | SessionCryptoPassphraseFile nom-fichier |
| Défaut: | none |
| Contexte: | configuration globale, serveur virtuel, répertoire |
| Statut: | Expérimental |
| Module: | mod_session_crypto |
| Compatibilité: | Disponible depuis la version 2.3.0 du serveur HTTP Apache |
La directive SessionCryptoPassphraseFile
permet de spécifier le nom d'un fichier de configuration contenant
les clés à utiliser pour le chiffrement et le déchiffrement de la
session (une clé par ligne). Le fichier est lu au démarrage du
serveur, et un redémarrage graceful est nécessaire pour prendre en
compte un éventuel changement de clés.
À la différence de la directive SessionCryptoPassphrase, les
clés ne sont pas présentes dans le fichier de configuration de
httpd et peuvent être cachées via une protection
appropriée du fichier de clés.
Il est possible de spécifier plusieurs clés afin de mettre en oeuvre la rotation de clés. La première clé spécifiée sera utilisée pour le chiffrement, alors que l'ensemble des clés spécifiées le sera pour le déchiffrement. Pour effectuer une rotation périodique des clés sur plusieurs serveurs, ajoutez une nouvelle clé en fin de liste, puis, une fois la rotation complète effectuée, supprimez la première clé de la liste.
Serveur HTTP Apache Version 2.4
| Description: | Fournisseur de mémoire partagée à base de slots. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | slotmem_plain_module |
| Fichier Source: | mod_slotmem_plain.c |
mod_slotmem_plain est un fournisseur de mémoire qui
permet la création et l'utilisation d'un segment de mémoire contigu
dans lequel les ensembles de données sont organisés en "slots".
Si la mémoire doit être partagée entre des threads et des
processus, il est préférable d'utiliser le fournisseur
mod_slotmem_shm.
mod_slotmem_plain fournit une API comprenant les
fonctions suivantes :
/* appelle le callback sur tous les slots actifs */
apr_status_t doall(ap_slotmem_instance_t *s, ap_slotmem_callback_fn_t *func, void *data, apr_pool_t *pool)
/* crée un nouveau slot de mémoire dont chaque item aura une taille de item_size. */
apr_status_t create(ap_slotmem_instance_t **new, const char *name, apr_size_t item_size, unsigned int item_num, ap_slotmem_type_t type, apr_pool_t *pool)
/* rattache à un slot de mémoire existant. */
apr_status_t attach(ap_slotmem_instance_t **new, const char *name, apr_size_t *item_size, unsigned int *item_num, apr_pool_t *pool)
/* indique la mémoire associée à ce slot actif. */
apr_status_t dptr(ap_slotmem_instance_t *s, unsigned int item_id, void **mem)
/* lit la mémoire depuis ce slot et la transfert vers dest */
apr_status_t get(ap_slotmem_instance_t *s, unsigned int item_id, unsigned char *dest, apr_size_t dest_len)
/* écrit dans ce slot la mémoire en provenance de src */
apr_status_t put(ap_slotmem_instance_t *slot, unsigned int item_id, unsigned char *src, apr_size_t src_len)
/* renvoie le nombre total de slots contenus dans ce segment */
unsigned int num_slots(ap_slotmem_instance_t *s)
/* renvoie la taille totale des données, en octets, contenues dans un slot de ce segment */
apr_size_t slot_size(ap_slotmem_instance_t *s)
/* alloue le premier slot libre et le marque comme utilisé (n'effectue aucune copie de données) */
apr_status_t grab(ap_slotmem_instance_t *s, unsigned int *item_id)
/* appropriation ou allocation forcée du slot spécifié et marquage comme utilisé (n'effectue aucune copie de données) */
apr_status_t fgrab(ap_slotmem_instance_t *s, unsigned int item_id)
/* libère un slot et le marque comme non utilisé (n'effectue aucune copie de données) */
apr_status_t release(ap_slotmem_instance_t *s, unsigned int item_id)
Ce module ne fournit aucune directive.
Serveur HTTP Apache Version 2.4
| Description: | Permet l'exécution des scripts CGI sous l'utilisateur et le groupe spécifiés |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | suexec_module |
| Fichier Source: | mod_suexec.c |
Ce module, en combinaison avec son programme support
suexec, permet l'exécution des scripts CGI sous
l'utilisateur et le groupe spécifiés.
| Description: | L'utilisateur et le groupe sous lesquels les programmes CGI doivent s'exécuter |
|---|---|
| Syntaxe: | SuexecUserGroup Utilisateur Groupe |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_suexec |
La directive SuexecUserGroup permet de
spécifier l'utilisateur et le groupe sous lesquels les programmes
CGI doivent s'exécuter. Les requêtes non CGI seront toujours
traitées avec l'utilisateur spécifié par la directive User.
SuexecUserGroup nobody nogroup
Le démarrage échouera si cette directive est spécifiée et si la fonctionnalité suEXEC est désactivée.
Serveur HTTP Apache Version 2.4
| Description: | Sécurité de base (nécessaire) pour les plates-formes de la famille Unix. |
|---|---|
| Statut: | Base |
| Identificateur de Module: | unixd_module |
| Fichier Source: | mod_unixd.c |
| Description: | Répertoire dans lequel Apache doit se positionner au démarrage après avoir effectué un chroot(8). |
|---|---|
| Syntaxe: | ChrootDir chemin-répertoire |
| Défaut: | Non défini |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_unixd |
| Compatibilité: | Disponible depuis la version 2.2.10 d'Apache |
Cette directive fait en sorte que le serveur effectue un chroot(8) vers le répertoire spécifié après le démarrage, mais avant d'accepter les requêtes en provenance du réseau.
Notez que l'exécution du serveur dans un environnement chroot n'est pas simple et nécessite une configuration particulière, en particulier si vous utilisez des scripts CGI ou PHP. Il est conseillé de se familiariser avec l'opération chroot avant d'essayer d'utiliser cette fonctionnalité.
| Description: | Groupe sous lequel le serveur va traiter les requêtes |
|---|---|
| Syntaxe: | Group groupe unix |
| Défaut: | Group #-1 |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_unixd |
La directive Group permet de définir le
groupe sous lequel le serveur va traiter les requêtes. Pour
utiliser cette directive, le serveur doit avoir été démarré par
root. Si vous démarrez le serveur en tant
qu'utilisateur non root, celui-ci ne pourra pas adopter le groupe
spécifié comme groupe d'exécution, et continuera à s'exécuter sous
le groupe de l'utilisateur qui l'aura lancé. groupe unix
peut se présenter sous la forme :
# suivi d'un numéro de groupe.Group www-group
Il est conseillé de créer un groupe dédié à l'exécution du
serveur. Certains administrateurs utilisent l'utilisateur
nobody, mais ce n'est pas toujours souhaitable ou même
possible.
Ne définissez pas la directive Group (ou
User) à
root à moins de savoir exactement ce que vous faites
ainsi que les dangers encourus.
| Description: | Active ou désactive la fonctionnalité suEXEC |
|---|---|
| Syntaxe: | Suexec On|Off |
| Défaut: | On si le binaire suexec existe avec les mode et propriétaire
appropriés, Off dans le cas contraire |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_unixd |
Lorsque cette directive est définie à On, le démarrage échouera si le binaire suexec n'existe pas, ou possède un propriétaire ou mode fichier invalide.
Lorsque cette directive est définie à Off, suEXEC sera désactivé, même si le binaire suexec existe et possède un propriétaire et mode fichier valides.
| Description: | L'utilisateur sous lequel le serveur va traiter les requêtes |
|---|---|
| Syntaxe: | User utilisateur unix |
| Défaut: | User #-1 |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_unixd |
La directive User permet de définir
l'utilisateur sous lequel le serveur va traiter les requêtes. Pour
utiliser cette directive, le serveur doit avoir été démarré
par root. Si vous démarrez le serveur en tant
qu'utilisateur non root, celui-ci ne pourra pas adopter
l'utilisateur avec privilèges restreints comme utilisateur
d'exécution, et continuera à s'exécuter sous
l'utilisateur qui l'aura lancé. Si vous démarrez le serveur en tant
que root, il est normal que le processus parent
continue à s'exécuter sous root. utilisateur unix peut se
présenter sous la forme :
L'utilisateur ne doit pas posséder de privilèges qui lui
permettraient d'accéder à des fichiers non destinés au
monde extérieur, et parallèlement, l'utilisateur ne doit pas
exécuter de code dont l'usage soit destiné à un usage autre que les
requêtes HTTP. Il est conseillé de créer un utilisateur et un groupe
dédiés à l'exécution du serveur. Certains administrateurs utilisent
l'utilisateur nobody, mais ce n'est pas toujours
souhaitable, car l'utilisateur nobody peut avoir
diverses utilisations dans le système.
Ne définissez pas la directive Group (ou
User) à
root à moins de savoir exactement ce que vous faites
ainsi que les dangers encourus.
Serveur HTTP Apache Version 2.4
| Description: | Configuration dépendant de la version |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | version_module |
| Fichier Source: | mod_version.c |
Ce module a été conçu pour être utilisé dans les suites de tests
et les grands réseaux qui doivent prendre en compte différentes
versions de httpd et différentes configurations. Il fournit un
nouveau conteneur -- <IfVersion>, qui apporte une grande
souplesse dans la vérification de version en permettant une
comparaison numérique et l'utilisation d'expressions
rationnelles.
<IfVersion 2.4.2>
# la version actuelle de httpd est exactement 2.4.2
</IfVersion>
<IfVersion >= 2.5>
# utilise vraiment les nouvelles fonctionnalités :-)
</IfVersion>
Voir ci-dessous pour d'autres exemples.
| Description: | Contient des portions de configuration dépendantes de la version |
|---|---|
| Syntaxe: | <IfVersion [[!]opérateur] version> ...
</IfVersion> |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | All |
| Statut: | Extension |
| Module: | mod_version |
La section <IfVersion>
rassemble des directives de configuration qui ne sont exécutées que
si la version de httpd satisfait aux critères spécifiés. Pour une
comparaison normale (numérique), l'argument version doit
être spécifié sous le format
majeur[.mineur[.patch]],
comme par exemple 2.1.0 ou 2.2.
mineur et patch sont optionnels. Si ces
numéros sont absents, il se voient affectée implicitement la valeur
0. Les opérateurs numériques suivants sont autorisés
:
| opérateur | description |
|---|---|
= ou == |
La version de httpd est égale à la valeur spécifiée |
> |
La version de httpd est supérieure à la valeur spécifiée |
>= |
La version de httpd est supérieure ou égale à la valeur spécifiée |
< |
La version de httpd est inférieure à la valeur spécifiée |
<= |
La version de httpd est inférieure ou égale à la valeur spécifiée |
<IfVersion >= 2.3>
# la condition n'est satisfaite que pour les versions de httpd
# supérieures ou égales à 2.3
</IfVersion>
En plus d'une comparaison numérique, il est possible de comparer la version de httpd avec une expression rationnelle. Il existe deux méthodes pour spécifier cette dernière :
| opérateur | description |
|---|---|
= ou == |
version est de la forme
/regex/ |
~ |
version est de la forme
regex |
<IfVersion = /^2.4.[01234]$/>
# exemple de contournement pour les versions boguées
</IfVersion>
Pour inverser la condition, tous les opérateurs peuvent être
préfixés par un point d'exclamation (!) :
<IfVersion !~ ^2.4.[01234]$>
# pas pour ces versions
</IfVersion>
Si opérateur est absent, sa valeur implicite est
=.
Serveur HTTP Apache Version 2.4
| Description: | Support avancé de l'internationalisation et des jeux de caractères pour les modules de filtrage basés sur libxml2 |
|---|---|
| Statut: | Base |
| Identificateur de Module: | xml2enc_module |
| Fichier Source: | mod_xml2enc.c |
| Compatibilité: | Disponible depuis la version 2.4 du serveur HTTP Apache. Disponible en tant que module tiers dans les versions 2.2.x |
Ce module fournit un support avancé de l'internationalisation
pour les modules de filtrage supportant les balises (markup-aware)
comme mod_proxy_html. Il est capable de détecter
automatiquement l'encodage des données en entrée et de s'assurer
qu'elle sont traitées correctement par l'interpréteur libxml2, y compris la conversion en
Unicode (UTF-8) si nécessaire. Il peut aussi convertir les données
dans l'encodage de votre choix après le traitement des balises, et
s'assurera que le jeu de caractères approprié sera défini
dans l'en-tête HTTP Content-Type.
Il existe deux scénarios d'utilisation : le cas des modules programmés pour travailler avec mod_xml2enc ; et les autres :
Les modules comme mod_proxy_html versions 3.1 et
supérieures utilisent la fonction optionnelle
xml2enc_charset pour déterminer la valeur de l'argument
"jeu de caractères" à transmettre à l'interpréteur libxml2, et
disposent de la fonction optionnelle xml2enc_filter
pour effectuer un encodage ultérieur éventuel. L'utilisation de
mod_xml2enc avec un module préprogrammé à cet effet ne nécessite
aucune configuration : ce dernier configurera mod_xml2enc pour vous
(sachant que vous pouvez tout de même le personnaliser via les
directives de configuration ci-dessous).
Pour utiliser mod_xml2enc avec un module basé sur libxml2 qui n'a pas été explicitement programmé pour mod_xml2enc, vous devrez configurer la chaîne de filtrage vous-même. Ainsi, pour utiliser mod_xml2enc avec un filtre foo fourni par un module mod_foo et pour améliorer le support i18n de ce dernier avec HTML et XML, vous pouvez utiliser les directives suivantes :
FilterProvider iconv xml2enc Content-Type $text/html
FilterProvider iconv xml2enc Content-Type $xml
FilterProvider markup foo Content-Type $text/html
FilterProvider markup foo Content-Type $xml
FilterChain iconv markup
mod_foo supportera alors tout jeu de caractère supporté soit par libxml2, soit par apr_xlate/iconv, soit par les deux.
Les programmeurs de modules de filtrage basés sur libxml2 sont
encouragés à les préprogrammer pour mod_xml2enc, afin de fournir un
support i18n solide aux utilisateurs sans avoir à réinventer la
roue. L'API de programmation est décrite dans
mod_xml2enc.h, et mod_proxy_html est un
exemple de son utilisation.
A la différence de mod_charset_lite, mod_xml2enc
est conçu pour travailler avec des données dont l'encodage ne peut
pas être connu, et donc configuré, à l'avance. Il utilise donc les
techniques de 'reniflage' suivantes pour détecter le type d'encodage
des données HTTP :
<META>, c'est ce dernier qui sera utilisé.xml2EncDefault qui sera utilisée.Les conditions sont testées dans cet ordre . Dès qu'une règle s'applique, elle est utilisée et la détection est terminée.
libxml2 utilise toujours UTF-8 (Unicode) en interne, et les modules de filtrage basés sur libxml2 utiliseront cet encodage en sortie par défaut. mod_xml2enc peut modifier l'encodage en sortie via l'API, mais il n'y a actuellement aucun moyen de le configurer directement.
La modification de l'encodage en sortie ne devrait (du moins en théorie) jamais être nécessaire, et est même déconseillée à cause de la charge de traitement supplémentaire imposée au serveur par une conversion non nécessaire.
Si vous travaillez avec des encodages non supportés par aucune des
méthodes de conversion disponibles sur votre plateforme, vous pouvez
tout de même leur associer un alias vers un code supporté via la
directive xml2EncAlias.
| Description: | Définit des alias pour les valeurs d'encodage |
|---|---|
| Syntaxe: | xml2EncAlias jeu-de-caractères alias [alias ...] |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_xml2enc |
Cette directive de niveau serveur permet de définir un ou plusieurs alias pour un encodage. Elle permet au support d'encodage de libxml2 de traiter en interne des encodages non reconnus par libxml2 en utilisant la table de conversion pour un encodage reconnu. Elle permet d'atteindre deux objectifs : supporter des jeux (ou noms) de caractères non reconnus par libxml2 ou iconv, et éviter une conversion pour un encodage lorsque cela n'est pas nécessaire.
| Description: | Définit un encodage par défaut à utiliser lorsqu'aucune information ne peut être automatiquement détectée |
|---|---|
| Syntaxe: | xml2EncDefault nom |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Base |
| Module: | mod_xml2enc |
Si vous traitez des données dont l'encodage est connu, mais ne contenant aucune information à propos de ce dernier, vous pouvez définir une valeur par défaut afin d'aider mod_xml2enc à traiter correctement les données. Par exemple, pour définir la valeur par défaut Latin1 (iso-8859-1) specifiée dans HTTP/1.0, utilisez :
xml2EncDefault iso-8859-1
| Description: | Indique à l'interpréteur à partir de quelle balise il doit commencer son traitement. |
|---|---|
| Syntaxe: | xml2StartParse élément [élément ...] |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Base |
| Module: | mod_xml2enc |
Cette directive permet de spécifier à partir de quelle balise, parmi les éléments spécifiés, l'interpréteur de balise doit commencer son traitement. Ccei permet de contourner le problème des serveurs d'arrière-plan qui insèrent des éléments non conformes en début de données, ce qui a pour effet de perturber l'interpréteur (voir un exemple ici).
Elle ne doit être utilisée ni pour les documents XML, ni pour les documents HTML correctement formatés.
Serveur HTTP Apache Version 2.4
| Description: | Support des sessions |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | session_module |
| Fichier Source: | mod_session.c |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache |
Le module session fait usage des cookies HTTP, et peut à ce titre être victime d'attaques de type Cross Site Scripting, ou divulguer des informations à caractère privé aux clients. Veuillez vous assurer que les risques ainsi encourus ont été pris en compte avant d'activer le support des sessions sur votre serveur.
Ce module fournit le support d'une interface de session pour chaque utilisateur au niveau du serveur global. Les sessions permettent de transmettre diverses informations : l'utilisateur est-il connecté ou non, ou toute autre information qui doit être conservée d'une requête à l'autre.
Les sessions peuvent être stockées sur le serveur, ou au niveau
du navigateur. Les sessions peuvent également être chiffrées pour une
sécurité accrue. Ces fonctionnalités sont réparties entre différents
modules complémentaires de mod_session :
mod_session_crypto,
mod_session_cookie et
mod_session_dbd. Chargez les modules appropriés
en fonction des besoins du serveur (soit statiquement à la
compilation, soit dynamiquement via la directive LoadModule).
Les sessions peuvent être manipulées par d'autres modules qui dépendent de la session, ou la session peut être lue et écrite dans des variables d'environnement et des en-têtes HTTP, selon les besoins.
Qu'est-ce qu'une session ? Qui peut utiliser une session
? Stockage des sessions sur le
serveur Stockage des sessions au niveau
du navigateur Exemples simples Confidentialité des
sessions Confidentialité du cookie Support des sessions pour
l'authentification Intégration des sessions avec les
applications externes Session SessionEnv SessionExclude SessionExpiryUpdateInterval SessionHeader SessionInclude SessionMaxAgeAu coeur de l'interface de session se trouve une table de paires clé/valeur qui sont accessibles d'une requête du navigateur à l'autre. Les valeurs de clés peuvent se voir affecter toute chaîne de caractères valide, en fonction des besoins de l'application qui fait usage de la session.
Une "session" est une chaîne application/x-www-form-urlencoded qui contient la paire clé/valeur définie par la spécification HTML.
Selon les souhaits de l'administrateur, la session peut être chiffrée et codée en base64 avant d'être soumise au dispositif de stockage.
L'interface de session a été conçue à l'origine pour être
utilisée par d'autres modules du serveur comme
mod_auth_form ; les applications à base de
programmes CGI peuvent cependant se voir accorder l'accès au
contenu d'une session via la variable d'environnement
HTTP_SESSION. Il est possible de modifier et/ou de mettre à jour
une session en insérant un en-tête de réponse HTTP contenant les
nouveaux paramètres de session.
Apache peut être configuré pour stocker les sessions utilisateurs sur un serveur particulier ou un groupe de serveurs. Cette fonctionnalité est similaire aux sessions disponibles sur les serveurs d'applications courants.
Selon la configuration, les sessions sont suivies à partir d'un identifiant de session stocké dans un cookie, ou extraites de la chaîne de paramètres de l'URL, comme dans les requêtes GET courantes.
Comme le contenu de la session est stocké exclusivement sur le serveur, il est nécessaire de préserver la confidentialité de ce contenu. Ceci a des implications en matière de performance et de consommation de ressources lorsqu'un grand nombre de sessions est stocké, ou lorsqu'un grand nombre de serveurs doivent se partager les sessions entre eux.
Le module mod_session_dbd permet de stocker
les sessions utilisateurs dans une base de données SQL via le
module mod_dbd.
Dans les environnements à haut trafic où le stockage d'une session sur un serveur consomme trop de ressources, il est possible de stocker le contenu de la session dans un cookie au niveau du navigateur client.
Ceci a pour avantage de ne nécessiter qu'une quantité minimale de ressources sur le serveur pour suivre les sessions, et évite à plusieurs serveurs parmi une forêt de serveurs de devoir partager les informations de session.
Le contenu de la session est cependant présenté au client, avec
pour conséquence un risque de perte de confidentialité. Le module
mod_session_crypto peut être configuré pour
chiffrer le contenu de la session avant qu'elle soit stockée au
niveau du client.
Le module mod_session_cookie permet de stocker
les sessions au niveau du navigateur dans un cookie HTTP.
La création d'une session consiste simplement à ouvrir la
session, et à décider de l'endroit où elle doit être stockée. Dans
l'exemple suivant, la session sera stockée au niveau du
navigateur, dans un cookie nommé session.
Session On SessionCookieName session path=/
Une session est inutile s'il n'est pas possible d'y lire
ou d'y écrire. L'exemple suivant montre comment des valeurs
peuvent être injectées dans une session à l'aide d'un en-tête de
réponse HTTP prédéterminé nommé
X-Replace-Session.
Session On SessionCookieName session path=/ SessionHeader X-Replace-Session
L'en-tête doit contenir des paires clé/valeur sous le même format que celui de la chaîne d'argument d'une URL, comme dans l'exemple suivant. Donner pour valeur à une clé la chaîne vide a pour effet de supprimer la clé de la session.
#!/bin/bash echo "Content-Type: text/plain" echo "X-Replace-Session: key1=foo&key2=&key3=bar" echo env
Selon la configuration, les informations de la session peuvent
être extraites de la variable d'environnement HTTP_SESSION. Par
défaut la session est privée, et cette fonctionnalité doit donc
être explicitement activée via la directive SessionEnv.
Session On SessionEnv On SessionCookieName session path=/ SessionHeader X-Replace-Session
Une fois la lecture effectuée, la variable CGI
HTTP_SESSION doit contenir la valeur
clé1=foo&clé3=bar.
En utilisant la fonctionnalité de votre navigateur "Afficher les cookies", vous pouvez voir une réprésentation de la session sous forme de texte en clair. Ceci peut poser problème si le contenu de la session doit être dissimulé à l'utilisateur final, ou si un tiers accède sans autorisation aux informations de session.
À ce titre, le contenu de la session peut être chiffré à l'aide
du module mod_session_crypto avant d'être stocké
au niveau du navigateur.
Session On SessionCryptoPassphrase secret SessionCookieName session path=/
La session sera automatiquement déchiffrée à la lecture, et rechiffrée par Apache lors de la sauvegarde, si bien que l'application sous-jacente qui utilise la session n'a pas à se préoccuper de savoir si un chiffrement a été mis en oeuvre ou non.
Les sessions stockées sur le serveur plutôt qu'au niveau du
navigateur peuvent aussi être chiffrées, préservant par là-même la
confidentialité lorsque des informations sensibles sont partagées
entre les serveurs web d'une forêt de serveurs à l'aide du module
mod_session_dbd.
Le mécanisme de cookie HTTP offre aussi des fonctionnalités quant à la confidentialité, comme la possibilité de restreindre le transport du cookie aux pages protégées par SSL seulement, ou l'interdiction pour les scripts java qui s'exécutent au niveau du navigateur d'obtenir l'accès au contenu du cookie.
Certaines fonctionnalités de confidentialité du cookie HTTP ne
sont pas standardisées, ou ne sont pas toujours implémentées au
niveau du navigateur. Les modules de session vous permettent de
définir les paramètres du cookie, mais il n'est pas garanti que la
confidentialité sera respectée par le navigateur. Si la sécurité
est la principale préoccupation, chiffrez le contenu de la session
avec le module mod_session_crypto, ou stockez la
session sur le serveur avec le module
mod_session_dbd.
Les paramètres standards du cookie peuvent être spécifiés après le nom du cookie comme dans l'exemple suivant :
Session On SessionCryptoPassphrase secret SessionCookieName session path=/private;domain=example.com;httponly;secure;
Dans les cas où le serveur Apache sert de frontal pour des
serveurs d'arrière-plan, il est possible de supprimer les cookies
de session des en-têtes HTTP entrants à l'aide de la directive
SessionCookieRemove. Ceci
permet d'empêcher les serveurs d'arrière-plan d'accéder au contenu
des cookies de session.
Comme il est possible de le faire avec de nombreux serveurs
d'applications, les modules d'authentification peuvent utiliser
une session pour stocker le nom d'utilisateur et le mot de passe
après connexion. Le module mod_auth_form par
exemple, sauvegarde les nom de connexion et mot de passe de
l'utilisateur dans une session.
Session On SessionCryptoPassphrase secret SessionCookieName session path=/ AuthFormProvider file AuthUserFile "conf/passwd" AuthType form AuthName "realm" #...
Pour la documentation et des exemples complets, voir le module
mod_auth_form.
Pour que les sessions soient utiles, leur contenu doit être accessible aux applications externes, et ces dernières doivent elles-mêmes être capables d'écrire une session.
L'exemple type est une application qui modifie le mot de passe
d'un utilisateur défini par mod_auth_form. Cette
application doit pouvoir extraire les nom d'utilisateur et mot de
passe courants de la session, effectuer les modifications
demandées, puis écrire le nouveau mot de passe dans la session,
afin que la transition vers le nouveau mot de passe soit
transparente.
Un autre exemple met en jeu une application qui enregistre un nouvel utilisateur pour la première fois. Une fois l'enregistrement terminé, le nom d'utilisateur et le mot de passe sont écrits dans la session, fournissant là aussi une transition transparente.
mod_auth_form
utilisent ce mécanisme.
SessionEnv. Un script peut écrire
dans la session en renvoyant un en-tête de réponse
application/x-www-form-urlencoded dont le nom est
défini via la directive SessionHeader. Dans les deux cas,
tout chiffrement ou déchiffrement, ainsi que la lecture ou
l'écriture de ou vers la session à partir du mécanisme de stockage
choisi sont gérés par le module mod_session et la
configuration correspondante.
mod_proxySessionHeader est utilisée pour
définir un en-tête de requête HTTP, la session codée sous la forme
d'une chaîne application/x-www-form-urlencoded
sera accessible pour l'application. Si ce même en-tête est fourni
dans la réponse, sa valeur sera utilisée pour remplacer la
session. Comme précédemment, tout chiffrement ou déchiffrement,
ainsi que la lecture ou
l'écriture de ou vers la session à partir du mécanisme de stockage
choisi sont gérés par le module mod_session et la
configuration correspondante.| Description: | Ouvre une session pour le contexte courant |
|---|---|
| Syntaxe: | Session On|Off |
| Défaut: | Session Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_session |
La directive Session permet d'ouvrir une
session pour le contexte ou conteneur courant. Les directives
suivantes permettent de définir où la session sera stockée et
comment sera assurée la confidentialité.
| Description: | Définit si le contenu de la session doit être enregistré dans la variable d'environnement HTTP_SESSION |
|---|---|
| Syntaxe: | SessionEnv On|Off |
| Défaut: | SessionEnv Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_session |
Lorsque la directive SessionEnv est
définie à On, le contenu de la session est enregistré
dans une variable d'environnement CGI nommée
HTTP_SESSION.
La chaîne est écrite sous le même format que celui de la chaîne d'arguments d'une URL, comme dans l'exemple suivant :
clé1=foo&clé3=bar
| Description: | Définit les préfixes d'URLs pour lesquels une session sera ignorée |
|---|---|
| Syntaxe: | SessionExclude chemin |
| Défaut: | none |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session |
La directive SessionExclude permet de
définir les préfixes d'URLs pour lesquels la session sera
désactivée. Ceci peut améliorer l'efficacité d'un site web, en
ciblant de manière plus précise l'espace d'URL pour lequel une
session devra être maintenue. Par défaut, toutes les URLs du
contexte ou du conteneur courant sont incluses dans la session. La
directive SessionExclude
l'emporte sur la directive SessionInclude.
Cette directive a un comportement similaire à celui de l'attribut chemin des cookies HTTP, mais ne doit pas être confondue avec cet attribut. En effet, cette directive ne définit pas l'attribut chemin, qui doit être configuré séparément.
| Description: | Définit le nombre de secondes dont la durée d'expiration d'une session peut changer sans que cette session soit mise à jour |
|---|---|
| Syntaxe: | SessionExpiryUpdateInterval interval |
| Défaut: | SessionExpiryUpdateInterval 0 (mise à jour systématique) |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session |
| Compatibilité: | Disponible à partir de la version 2.4.41 du serveur HTTP Apache |
La directive SessionExpiryUpdateInterval
permet d'éviter le coût de l'écriture d'une session pour chaque
requête en n'effectuant cette mise à jour que lorsque la date
d'expiration a changé. Ceci permet d'améliorer les performances d'un
site web ou de réduire la charge d'une base de données lorsqu'on
utilise mod_session_dbd. La session est
systématiquement mise à jour si les données stockées dans la session
ont été modifiées ou si la durée d'expiration a été modifiée d'une
durée supérieure à l'intervalle spécifié.
Définir l'intervalle à 0 désactive cette directive, et l'expiration de la session sera alors rafraîchie pour chaque requête.
Cette directive n'a d'effet que si on l'utilise en combinaison
avec la directive SessionMaxAge qui active
l'expiration des sessions. Les sessions sans date d'expiration ne
sont écrites que lorsque les données qu'elles renferment ont été
modifiées.
Comme l'expiration de la session n'est pas systématiquement rafraîchie à chaque requête, une session peut arriver à expiration plus tôt d'un nombre de secondes spécifié dans le paramètre interval. Définir un petit intervalle est en général assez sur, mais en revenche n'a qu'un effet minime sur la prise en compte des durées d'expiration.
| Description: | Importation des mises à jour de session depuis l'en-tête de réponse HTTP spécifié |
|---|---|
| Syntaxe: | SessionHeader en-tête |
| Défaut: | none |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_session |
La directive SessionHeader permet de
définir le nom d'un en-tête de réponse HTTP qui, s'il est présent,
sera lu et son contenu écrit dans la session courante.
Le contenu de l'en-tête doit se présenter sous le même format que celui de la chaîne d'arguments d'une URL, comme dans l'exemple suivant :
clé1=foo&clé2=&clé3=bar
Si une clé a pour valeur la chaîne vide, elle sera supprimée de la session.
| Description: | Définit les préfixes d'URL pour lesquels une session est valide |
|---|---|
| Syntaxe: | SessionInclude chemin |
| Défaut: | toutes URLs |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_session |
La directive SessionInclude permet de
définir les préfixes d'URL spécifiques pour lesquels une session
sera valide. Ceci peut améliorer l'efficacité d'un site web, en
ciblant de manière plus précise l'espace d'URL pour lequel une
session devra être maintenue. Par défaut, toutes les URLs du
contexte ou du conteneur courant sont incluses dans la session.
Cette directive a un comportement similaire à celui de l'attribut chemin des cookies HTTP, mais ne doit pas être confondue avec cet attribut. En effet, cette directive ne définit pas l'attribut chemin, qui doit être configuré séparément.
| Description: | Définit une durée de vie maximale pour la session en secondes |
|---|---|
| Syntaxe: | SessionMaxAge durée de vie maximale |
| Défaut: | SessionMaxAge 0 |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | AuthConfig |
| Statut: | Extension |
| Module: | mod_session |
La directive SessionMaxAge permet de
définir la durée maximale pendant laquelle une session restera
valide. Lorsqu'une session est sauvegardée, cette durée est
réinitialisée et la session peut continuer d'exister. Si la durée
d'une session dépasse cette limite sans qu'une requête au serveur ne
vienne la rafraîchir, la session va passer hors délai et sera
supprimée. Lorsqu'une session est utilisée pour stocker les
informations de connexion d'un utilisateur, ceci aura pour effet de
le déconnecter automatiquement après le délai spécifié.
Donner à cette directive la valeur 0 empêche l'expiration de la session.
Serveur HTTP Apache Version 2.4
| Description: | Support des session basé sur DBD/SQL |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | session_dbd_module |
| Fichier Source: | mod_session_dbd.c |
| Compatibilité: | Disponible depuis la version 2.3 d'Apache |
Les modules de session font usage des cookies HTTP, et peuvent à ce titre être victimes d'attaques de type Cross Site Scripting, ou divulguer des informations à caractère privé aux clients. Veuillez vous assurer que les risques ainsi encourus ont été pris en compte avant d'activer le support des sessions sur votre serveur.
Ce sous-module du module mod_session fournit le
support du stockage des sessions utilisateur dans une base de
données SQL en utilisant le module mod_dbd.
Les sessions sont soit anonymes, et la session est alors identifiée par un UUID unique stocké dans un cookie au niveau du navigateur, soit propres à l'utilisateur, et la session est alors identifiée par l'identifiant de l'utilisateur connecté.
Les sessions basées sur SQL sont dissimulées au navigateur, et permettent ainsi de préserver la confidentialité sans avoir recours au chiffrement.
Plusieurs serveurs web d'une forêt de serveurs peuvent choisir de partager une base de données, et ainsi partager les sessions entre eux.
Pour plus de détails à propos de l'interface des sessions, voir
la documentation du module mod_session.
Configuration de DBD Sessions anonymes Sessions propres à un
utilisateur Nettoyage de la base de
données SessionDBDCookieName SessionDBDCookieName2 SessionDBDCookieRemove SessionDBDDeleteLabel SessionDBDInsertLabel SessionDBDPerUser SessionDBDSelectLabel SessionDBDUpdateLabelPour que le module mod_session_dbd puisse être
configuré et maintenir une session, il faut tout d'abord
configurer le module mod_dbd pour que le serveur
puisse exécuter des requêtes vers la base de données.
Quatre types de requêtes sont nécessaires pour maintenir une session, sélectionner ou mettre à jour une session existante, insérer une nouvelle session et supprimer une session vide ou arrivée à expiration. Ces requêtes sont configurées comme dans l'exemple suivant :
DBDriver pgsql DBDParams "dbname=apachesession user=apache password=xxxxx host=localhost" DBDPrepareSQL "delete from session where key = %s" deletesession DBDPrepareSQL "update session set value = %s, expiry = %lld, key = %s where key = %s" updatesession DBDPrepareSQL "insert into session (value, expiry, key) values (%s, %lld, %s)" insertsession DBDPrepareSQL "select value from session where key = %s and (expiry = 0 or expiry > %lld)" selectsession DBDPrepareSQL "delete from session where expiry != 0 and expiry < %lld" cleansession
Les sessions anonymes sont identifiées par un UUID unique, et stockées dans un cookie au niveau du navigateur. Cette méthode est similaire à celle utilisée par la plupart des serveurs d'applications pour stocker les informations de session.
Pour créer une session anonyme, la stocker dans une table de base de donnée postgres nommée apachesession, et sauvegarder l'identifiant de session dans un cookie nommé session, configurez la session comme suit :
Session On SessionDBDCookieName session path=/
Pour plus d'exemples sur la manière dont une application CGI
peut accéder aux informations de session, voir la section exemples
de la documentation du module mod_session.
Pour des détails sur la manière dont une session peut être
utilisée pour stocker des informations de type nom
d'utilisateur/mot de passe, voir la documentation du module
mod_auth_form.
Les sessions propres à un utilisateur sont identifiées par le nom de l'utilisateur authentifié avec succès. Ceci permet d'assurer une confidentialité optimale, car aucun traitement externe à la session n'existe en dehors du contexte authentifié.
Les sessions propres à un utilisateur ne fonctionnent que dans
un environnement d'authentification correctement configuré, qu'il
s'agisse d'une authentification de base, à base de condensés
(digest) ou de certificats client SSL. Suite à des limitations
dues à des dépendances mutuelles, les sessions propres à un
utilisateur ne peuvent pas être utilisées pour stocker les données
d'authentification en provenance d'un module comme
mod_auth_form.
Pour créer une session propre à un utilisateur, la stocker dans une table de base de données postgres nommée apachesession, avec comme clé de session l'identifiant utilisateur, ajoutez les lignes suivantes :
Session On SessionDBDPerUser On
Avec le temps, la base de données va commencer à accumuler des
sessions expirées. Pour le moment, le module
mod_session_dbd n'est pas en mesure de gérer
automatiquement l'expiration des sessions.
L'administrateur devra mettre en oeuvre un traitement externe via cron pour nettoyer les sessions expirées.
| Description: | Nom et attributs du cookie RFC2109 qui contient l'identifiant de session |
|---|---|
| Syntaxe: | SessionDBDCookieName nom attributs |
| Défaut: | none |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session_dbd |
La directive SessionDBDCookieName permet
de spécifier le nom et les attributs optionnels d'un cookie
compatible RFC2109 qui contiendra l'identifiant de session. Les
cookies RFC2109 sont définis à l'aide de l'en-tête HTTP
Set-Cookie.
Une liste optionnelle d'attributs peut être spécifiée pour ce cookie, comme dans l'exemple ci-dessous. Ces attributs sont insérés dans le cookie tels quels, et ne sont pas interprétés par Apache. Assurez-vous que vos attributs sont définis correctement selon la spécification des cookies.
Session On SessionDBDCookieName session path=/private;domain=example.com;httponly;secure;version=1;
| Description: | Nom et attributs du cookie RFC2965 qui contient l'identifiant de session |
|---|---|
| Syntaxe: | SessionDBDCookieName2 nom attributs |
| Défaut: | none |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session_dbd |
La directive SessionDBDCookieName2 permet
de spécifier le nom et les attributs optionnels d'un cookie
compatible RFC2965 qui contiendra l'identifiant de session. Les
cookies RFC2965 sont définis à l'aide de l'en-tête HTTP
Set-Cookie2.
Une liste optionnelle d'attributs peut être spécifiée pour ce cookie, comme dans l'exemple ci-dessous. Ces attributs sont insérés dans le cookie tel quel, et ne sont pas interprétés par Apache. Assurez-vous que vos attributs sont définis correctement selon la spécification des cookies.
Session On SessionDBDCookieName2 session path=/private;domain=example.com;httponly;secure;version=1;
| Description: | Détermine si les cookies de session doivent être supprimés des en-têtes HTTP entrants |
|---|---|
| Syntaxe: | SessionDBDCookieRemove On|Off |
| Défaut: | SessionDBDCookieRemove On |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session_dbd |
La directive SessionDBDCookieRemove permet
de déterminer si les cookies contenant l'identifiant de session
doivent être supprimés des en-têtes pendant le traitement de la
requête.
Dans le cas d'un mandataire inverse où le serveur Apache sert de frontal à un serveur d'arrière-plan, révéler le contenu du cookie de session à ce dernier peut conduire à une violation de la confidentialité. À ce titre, si cette directive est définie à "on", le cookie de session sera supprimé des en-têtes HTTP entrants.
| Description: | La requête SQL à utiliser pour supprimer des sessions de la base de données |
|---|---|
| Syntaxe: | SessionDBDDeleteLabel étiquette |
| Défaut: | SessionDBDDeleteLabel deletesession |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session_dbd |
La directive SessionDBDDeleteLabel permet
de définir l'étiquette de la requête de suppression à utiliser par
défaut pour supprimer une session vide ou expirée. Cette
étiquette doit avoir été définie au préalable via une directive
DBDPrepareSQL.
| Description: | La requête SQL à utiliser pour insérer des sessions dans la base de données |
|---|---|
| Syntaxe: | SessionDBDInsertLabel étiquette |
| Défaut: | SessionDBDInsertLabel insertsession |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session_dbd |
La directive SessionDBDInsertLabel permet
de définir l'étiquette de la requête d'insertion par défaut à
charger dans une session. Cette
étiquette doit avoir été définie au préalable via une directive
DBDPrepareSQL.
Si une tentative de mise à jour d'une session ne concerne aucun enregistrement, c'est cette requête qui sera utilisée pour insérer la session dans la base de données.
| Description: | Active une session propre à un utilisateur |
|---|---|
| Syntaxe: | SessionDBDPerUser On|Off |
| Défaut: | SessionDBDPerUser Off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session_dbd |
La directive SessionDBDPerUser permet
d'activer une session propre à un utilisateur, dont la clé sera le
nom de l'utilisateur connecté. Si l'utilisateur n'est pas connecté,
la directive sera ignorée.
| Description: | La requête SQL à utiliser pour sélectionner des sessions dans la base de données |
|---|---|
| Syntaxe: | SessionDBDSelectLabel étiquette |
| Défaut: | SessionDBDSelectLabel selectsession |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session_dbd |
La directive SessionDBDSelectLabel permet
de définir l'étiquette de la requête de sélection par défaut à
utiliser pour charger une session. Cette étiquette doit avoir été
définie au préalable via une directive DBDPrepareSQL.
| Description: | La requête SQL à utiliser pour mettre à jour des sessions préexistantes dans la base de données |
|---|---|
| Syntaxe: | SessionDBDUpdateLabel étiquette |
| Défaut: | SessionDBDUpdateLabel updatesession |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Statut: | Extension |
| Module: | mod_session_dbd |
La directive SessionDBDUpdateLabel permet
de définir l'étiquette de la requête de mise à jour par défaut à
charger dans une session. Cette
étiquette doit avoir été définie au préalable via une directive
DBDPrepareSQL.
Si une tentative de mise à jour d'une session ne concerne aucun enregistrement, c'est la requête d'insertion qui sera appelée pour insérer la session dans la base de données. Si la base de données supporte InsertOrUpdate, modifiez cette requête pour effectuer la mise à jour en une seule requête au lieu de deux.
Serveur HTTP Apache Version 2.4
| Description: | Module multi-processus implémentant un serveur web basé exclusivement sur les threads et optimisé pour Novell NetWare |
|---|---|
| Statut: | MPM |
| Identificateur de Module: | mpm_netware_module |
| Fichier Source: | mpm_netware.c |
Ce module multi-processus (MPM) implémente un serveur web basé exclusivement sur les threads et optimisé pour Novell NetWare.
Le thread maître est chargé du lancement de threads esclaves qui attendent les connexions et les traitent au fur et à mesure de leur arrivée. Le serveur HTTP Apache essaie toujours de maintenir plusieurs threads esclaves en spare (en réserve) ou inactifs. De cette façon, les clients n'ont pas besoin d'attendre le lancement d'un nouveau thread enfant pour que leurs requêtes soient traitées.
Les directives StartThreads, MinSpareThreads, MaxSpareThreads, et MaxThreads contrôlent
la manière dont le thread maître crée les threads esclaves afin de
traiter les requêtes. En général, Apache httpd s'auto-régule correctement,
et la plupart des sites ne nécessitent aucune modification des
valeurs par défaut de ces directives. Pour les sites dont le serveur
est limité en mémoire, il peut s'avérer nécessaire de diminuer la
valeur de la directive MaxThreads afin d'éviter une
hyper-activité du serveur (arrêts de threads inactifs et lancement incessant
de nouveau threads). Vous trouverez plus d'informations à
propos du contrôle de la création de processus dans le document conseils en matière de
performances.
La directive MaxRequestsPerChild
contrôle la fréquence à laquelle le serveur recycle ses processus
en arrêtant les anciens et en en lançant de nouveaux. Sous le
système d'exploitation NetWare, il est vivement recommandé de
laisser cette directive à 0, ce qui permet aux threads esclaves de
continuer à traiter les requêtes indéfiniment.
Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxSpareThreads MaxThreads MinSpareThreads ReceiveBufferSize SendBufferSize StartThreads ThreadStackSize| Description: | Définit le nombre maximum de threads esclaves |
|---|---|
| Syntaxe: | MaxThreads nombre |
| Défaut: | MaxThreads 2048 |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | mpm_netware |
La directive MaxThreads définit
le nombre maximum de threads esclaves que l'on désire autoriser. La
valeur par défaut correspondant à la valeur codée en dur à la
compilation, la valeur de cette directive ne peut donc qu'être
diminuée, comme dans l'exemple suivant :
MaxThreads 512
Serveur HTTP Apache Version 2.4
| Description: | Fournisseur de cache d'objets partagés basé sur DBM. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | socache_dbm_module |
| Fichier Source: | mod_socache_dbm.c |
Le module mod_socache_dbm est un fournisseur de cache
d'objets partagés qui permet la création et l'accès à un cache
maintenu par une base de données DBM.
dbm:/chemin/vers/datafile
Vous trouverez des détails à propos des autres fournisseurs de cache d'objets partagés ici.
Ce module ne fournit aucune directive.
Serveur HTTP Apache Version 2.4
| Description: | Fournisseur de cache d'objets partagé basé sur Redis. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | socache_redis_module |
| Fichier Source: | mod_socache_redis.c |
| Compatibilité: | Disponible à partir de la version 2.4.39 du serveur HTTP Apache |
mod_socache_redis implémente un fournisseur de cache
d'objets partagé qui permet la création et l'accès à un cache hébergé par le
système de mise en cache d'objets en mémoire partagée à hautes performances
Redis.
La méthode "create" de ce fournisseur de cache d'objets partagé nécessite
une liste en mémoire de spécifications hôte/port séparées par des virgules.
Si vous utilisez ce fournisseur dans une directive de configuration d'un autre
module comme SSLSessionCache,
spécifiez la liste des serveurs sous la forme du paramètre optionnel "arg" :
SSLSessionCache redis:redis.example.com:12345,redis2.example.com:12345
Vous trouverez une description détaillée des autres fournisseurs de cache d'objets partagé ici.
| Description: | Durée de vie du jeu de connexions avec le(s) serveur(s) Redis. |
|---|---|
| Syntaxe: | RedisConnPoolTTL num[units] |
| Défaut: | RedisConnPoolTTL 15s |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_socache_redis |
| Compatibilité: | Disponible à partir de la version 2.4.39 du serveur HTTP Apache. |
Cette directive permet de définir la durée pendant laquelle les connexions inactives avec le(s) serveur(s) Redis seront conservées (plateformes threadées seulement).
Les valeurs valides pour RedisConnPoolTTL sont des
durées limitées à 1 heure . 0 signifie aucune limite.
Par défaut, l'unité de ces valeurs est la secondes, mais on peut spécifier via un suffixe des valeurs en millisecondes (ms), en secondes (s), en minutes (min) ou en heures (h).
# Définit une durée de vie de 10 minutes RedisConnPoolTTL 10min # Définit une durée de vie de 60 secondes RedisConnPoolTTL 60
| Description: | Durée maximale de lecture/écriture sur la connexion avec le(s) serveur(s) Redis. |
|---|---|
| Syntaxe: | RedisTimeout num[units] |
| Défaut: | RedisTimeout 5s |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_socache_redis |
| Compatibilité: | Disponible à partir de la version 2.4.39 du serveur HTTP Apache. |
Cette directive permet de définir la durée maximale de lecture/écriture sur la connexion avec le(s) serveur(s) Redis.
Les valeurs valides pour RedisTimeout sont des
durées limitées à 1 heure . 0 signifie aucune limite.
Par défaut, l'unité de ces valeurs est la secondes, mais on peut spécifier via un suffixe des valeurs en millisecondes (ms), en secondes (s), en minutes (min) ou en heures (h).
# Définit une durée de 10 minutes RedisTimeout 10min # Définit une durée de 60 secondes RedisTimeout 60
Serveur HTTP Apache Version 2.4
| Description: | Fournit des informations sur les performances et l'activité du serveur |
|---|---|
| Statut: | Base |
| Identificateur de Module: | status_module |
| Fichier Source: | mod_status.c |
Le module Status permet à un administrateur de déterminer le niveau de performances de son serveur. Les statistiques instantanées du serveur sont présentées dans une page HTML sous une forme aisément lisible. Si nécessaire, cette page peut être configurée pour être automatiquement actualisée (sous réserve de compatibilité du navigateur). Une autre page fournit l'état instantané du serveur sous la forme d'une simple liste lisible par une machine.
Les détails fournis sont :
Les lignes se terminant par "(*)" ne sont disponibles que si la
directive ExtendedStatus
est définie à On. Depuis la version
2.3.6, le chargement de mod_status définit automatiquement
ExtendedStatus à On.
Activation du rapport d'état Actualisation automatique Fichier d'état lisible par une machine Utilisation de server-status pour la recherche de défauts de
fonctionnementCe module ne fournit aucune directive.
Pour n'activer les rapports d'état que pour les navigateurs
appartenent au domaine example.com, ajoutez ces lignes à votre
fichier de configuration httpd.conf :
<Location "/etat-serveur">
SetHandler server-status
Require host example.com
</Location>
Il est alors possible d'obtenir les statistiques du serveur en
utilisant un navigateur web et en accédant à la page
http://votre.serveur/etat-serveur.
Vous pouvez faire en sorte que cette page d'état s'actualise
elle-même automatiquement si votre navigateur supporte "refresh".
Pour ce faire, accédez à la page
http://votre.serveur/etat-serveur?refresh=N, pour que
cette dernière soit actualisée toutes les N secondes.
La page http://votre.serveur/etat-serveur?auto
permet d'obtenir une version du fichier d'état lisible par une
machine. Ceci s'avère intéressant dans le cadre d'une exécution
automatique : voir le programme en Perl
log_server_status situé dans le répertoire
/support de votre distribution du serveur HTTP Apache.
mod_status a été
chargé dans le serveur, son gestionnaire sera disponible dans
tous les fichiers de configuration, y compris les
fichiers de configuration de niveau répertoire (par
exemple .htaccess), ce qui peut avoir des
répercutions quant à la sécurité de votre site.
La page server-status peut servir de point de départ
à la recherche de défauts de fonctionnement lorsque votre serveur
mobilise toutes les ressources disponibles (CPU ou mémoire), pour
identifier quels clients ou requêtes sont la cause du problème.
Tout d'abord, assurez-vous que la directive ExtendedStatus est bien définie à on, de
façon à ce que vous puissiez avoir accès à toutes les informations à
propos de la requête et du client pour chaque processus enfant ou
thread.
Consultez ensuite la liste des processus en cours (à l'aide de
top, ou d'un utilitaire de listage des processus
similaire), afin d'identifier les processus coupables. Triez
l'affichage de top par utilisation CPU ou mémoire, en
fonction du problème rencontré.
Rechargez la page server-status et recherchez
les identifiants des processus trouvés précédemment ; vous pourrez
alors déterminer quelle requête est traitée par ces processus, pour
quel client. Les requêtes peuvent apparaître de manière fugitive, et
il se peut que vous deviez effectuer plusieurs essais avant de
parvenir à les prendre en flagrant délit, pour ainsi dire.
Cette procédure devrait vous permettre de cerner quel client, ou type de requête, sont à l'origine de vos problèmes de charge. Il est probable que vous identifiiez une application web au comportement anormal, ou un client en train d'attaquer votre site.
Serveur HTTP Apache Version 2.4
| Description: | Fournit un support amélioré pour l'intégration de systemd |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | systemd_module |
| Fichier Source: | mod_systemd.c |
Ce module implémente le support de l'intégration de systemd. Il
permet d'utiliser httpd en temps que service avec le paramètre de
systemd Type=notify (voir la page de manuel
systemd.service(5)
pour plus de détails). Le module est activé s'il est chargé.
[Unit] Description=The Apache HTTP Server After=network.target [Service] Type=notify ExecStart=/usr/local/apache2/bin/httpd -D FOREGROUND -k start ExecReload=/usr/local/apache2/bin/httpd -k graceful KillMode=mixed [Install] WantedBy=multi-user.target
Si vous utilisez ExecStop et/ou KillMode, vous
devez prêter une attention particulière à leur configuration pour ce service.
Si elle est présente, une commande ExecStop doit être une
operation synchrone qui se termine elle-même en même temps que le
démon. Cette condition n'est pas satisfaite si vous exécutez la commande
httpd -k stop de manière asynchrone, car elle initie
l'arrêt du démon. L'exemple ci-dessus utilise KillMode=mixed
afin que systemd envoie SIGTERM au processus parent (et
seulement à ce dernier) pour lui indiquer qu'il doit s'arrêter. Les processus
encore en cours d'exécution après un temps égal à TimeoutStopSec
recevront alors le signal SIGKILL. Voir systemd.kill(5)
pour plus d'informations.
Ce module ne fournit pas le support de l'activation du socket Systemd.
ExtendedStatus est activé par défaut
si le module est chargé. Si ExtendedStatus n'est pas explicitement désactivé
dans le fichier de configuration, les statistiques à propos de la charge et
des requêtes pendant l'exécution apparaîtront dans la sortie de la commande
systemctl status.
Ce module ne fournit aucune directive.
Serveur HTTP Apache Version 2.4
| Description: | Répertoires propres à un utilisateur |
|---|---|
| Statut: | Base |
| Identificateur de Module: | userdir_module |
| Fichier Source: | mod_userdir.c |
Ce module permet l'accès aux répertoires propres à un utilisateur en
utilisant la syntaxe http://example.com/~utilisateur/.
| Description: | Chemin des répertoires propres à un utilisateur |
|---|---|
| Syntaxe: | UserDir nom-répertoire [nom-répertoire] ...
|
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Base |
| Module: | mod_userdir |
La directive UserDir permet de définir le
répertoire réel du répertoire home d'un utilisateur à utiliser à la
réception d'une requête pour un document de cet utilisateur.
nom-répertoire peut se présenter sous la forme suivante
:
disabled. Toutes les
traductions nom d'utilisateur vers répertoire sont alors
désactivées, à l'exception de celles comportant le mot-clé
enabled (voir ci-dessous).disabled suivi d'une liste de noms
d'utilisateurs séparés par des espaces. Les noms d'utilisateurs
apparaissant dans une telle liste ne feront jamais
l'objet d'une traduction vers un répertoire, même dans le cas où
ils apparaîtront dans une clause enabled.enabled suivi d'une liste de noms
d'utilisateurs séparés par des espaces. Les noms d'utilisateurs
apparaissant dans une telle liste seront traduits en répertoires
même dans le cas où une clause disable globale est active, mais
pas s'ils apparaissent aussi dans une clause
disabled.Si aucun mot-clé enabled ou disabled
n'apparait dans la directive Userdir, l'argument est
traité en tant que modèle de fichier, et utilisé pour traduire le
nom d'utilisateur en une spécification de répertoire. Une requête
pour http://www.example.com/~bob/un/deux.html sera
traduite en :
| Directive Userdir utilisée | Chemin traduit |
|---|---|
| UserDir public_html | ~bob/public_html/un/deux.html |
| UserDir /usr/web | /usr/web/bob/un/deux.html |
| UserDir /home/*/www | /home/bob/www/un/deux.html |
Les directives suivantes vont envoyer des redirections au client :
| Directive Userdir utilisée | Chemin traduit |
|---|---|
| UserDir http://www.example.com/utilisateurs | http://www.example.com/utilisateurs/bob/un/deux.html |
| UserDir http://www.example.com/*/usr | http://www.example.com/bob/usr/un/deux.html |
| UserDir http://www.example.com/~*/ | http://www.example.com/~bob/un/deux.html |
"UserDir ./" ferait correspondre
"/~root" à "/" - ce qui n'est
probablement pas souhaité. Il est fortement recommandé d'inclure
une déclaration "UserDir disabled root" dans votre
configuration. Voir aussi la directive Directory et la page Conseils en matière de
sécurité pour plus d'informations.
Exemples supplémentaires :
Pour permettre à quelques utilisateurs et seulement à ceux-ci de
posséder des répertoires UserDir, utilisez la
configuration suivante :
UserDir disabled UserDir enabled user1 user2 user3
Pour permettre à la plupart des utilisateurs de posséder des
répertoires UserDir, mais l'interdire à quelques uns,
utilisez la configuration suivante :
UserDir disabled utilisateur4 utilisateur5 utilisateur6
Il est aussi possible de spécifier des répertoires utilisateurs alternatifs. Si vous utilisez une commande comme :
UserDir "public_html" "/usr/web" "http://www.example.com/"
Avec une requête pour
http://www.example.com/~bob/un/deux.html, le serveur
tentera tout d'abord de trouver la page à
~bob/public_html/un/deux.html, puis à
/usr/web/bob/un/deux.html, et enfin il enverra une
redirection vers
http://www.example.com/bob/un/deux.html.
Si vous spécifiez une redirection, elle doit être la dernière alternative de la liste. Apache httpd ne pouvant pas déterminer si la redirection a réussi, si cette dernière ne se trouve pas en fin de liste, c'est cette alternative qui sera toujours utilisée.
La substitution de répertoire utilisateur n'est pas activée par
défaut depuis la version 2.1.4. Dans les versions précédentes,
UserDir public_html était sous-entendu si aucune
directive UserDir
n'était présente.
Lorsqu'on passe du contexte global au contexte de serveur virtuel, les listes d'utilisateurs spécifiques activés ou désactivés sont remplacées par les listes du contexte, et non fusionnées.
Serveur HTTP Apache Version 2.4
| Description: | Permet de configurer dynamiquement l'hébergement virtuel de masse |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | vhost_alias_module |
| Fichier Source: | mod_vhost_alias.c |
Ce module permet de créer des serveurs virtuels configurés
dynamiquement, en autorisant l'utilisation de l'adresse IP et/ou de
l'en-tête Host: de la requête HTTP comme partie du nom
de chemin afin de déterminer les fichiers à servir. Ceci facilite la
gestion d'un grand nombre de serveurs virtuels possèdant des
configurations similaires.
Si les modules mod_alias ou
mod_userdir sont utilisés pour traduire les URIs
en noms de fichiers, ils l'emportent sur les directives du module
mod_vhost_alias décrites ci-dessous. Par
exemple, la configuration suivante fera correspondre
/cgi-bin/script.pl à
/usr/local/apache2/cgi-bin/script.pl dans tous les cas :
ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/" VirtualScriptAlias "/never/found/%0/cgi-bin/"
Toutes les directives de ce module insèrent une chaîne dans un
nom de chemin. La chaîne insérée (que nous appellerons maintenant le
"nom") peut être soit le nom du serveur (voir la directive
UseCanonicalName pour les
détails sur la manière dont il est déterminé), soit l'adresse IP du
serveur virtuel hébergé par le serveur sous la forme d'un quadruplet
d'octets séparés par des points. L'insertion est contrôlée par des
spécificateurs inspirés de printf et possèdant de
nombreux formats :
%% |
insère un % |
%p |
insère le numéro de port du serveur virtuel |
%N.M |
insère le nom (en partie) |
N et M permettent de spécifier des
sous-chaînes du nom. N sélectionne un des composants du
nom séparés par des points, et M sélectionne des
caractères à l'intérieur de ce que N a sélectionné.
M est optionnel et sa valeur par défaut est 0 s'il
n'est pas spécifié ; le point doit être présent si et seulement si
M l'est aussi. Les modes d'insertion sont les suivants
:
0 |
le nom en entier |
1 |
la première partie |
2 |
la seconde partie |
-1 |
la dernière partie |
-2 |
l'avant-dernière partie |
2+ |
toutes les parties à partir de la seconde |
-2+ |
toutes les parties jusqu'à l'avant-dernière |
1+ et -1+ |
identique à 0 |
Si N ou M est plus grand que le nombre
de parties disponibles, seul un caractère de soulignement est
inséré.
Pour des serveurs virtuels simples à base de nom, utilisez les directives suivantes dans le fichier de configuration de votre serveur :
UseCanonicalName Off VirtualDocumentRoot "/usr/local/apache/vhosts/%0"
Une requête pour
http://www.example.com/repertoire/fichier.html
concernera alors la ressource
/usr/local/apache/vhosts/www.example.com/repertoire/fichier.html.
Pour un très grand nombre de serveurs virtuels, il est avantageux
d'organiser les fichiers de façon à réduire la taille du répertoire
vhosts. Pour ce faire, insérez les lignes suivantes
dans votre fichier de configuration :
UseCanonicalName Off VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2"
Une requête pour
http://www.domaine.example.com/repertoire/fichier.html
concernera alors la ressource
/usr/local/apache/vhosts/example.com/d/o/m/domaine/repertoire/fichier.html.
Une répartition plus régulière des fichiers peut être obtenue en partant de la fin d'un composant du nom, comme dans l'exemple suivant :
VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.-1/%2.-2/%2.-3/%2"
La requête précédente concernerait alors
/usr/local/apache/vhosts/example.com/e/n/i/domaine/repertoire/fichier.html.
Vous pouvez également utiliser :
VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2.4+"
La requête précédente concernerait alors
/usr/local/apache/vhosts/example.com/d/o/m/aine/repertoire/fichier.html.
Une demande très courante des utilisateurs concerne la possibilité de
faire correspondre plusieurs racines de documents à plusieurs
domaines, sans avoir à se préoccuper de la longueur ou du nombre de
parties du nom d'hôte faisant partie de la requête. Si le nom d'hôte
de la requête est sub.www.domain.example.com au lieu de
simplement www.domain.example.com, alors en utilisant
%3+, la racine des documents sera
/usr/local/apache/vhosts/domain.example.com/... au
lieu du répertoire example.com attendu. Dans ce genre
de situation, il peut s'avérer préférable d'utiliser la combinaison
%-2.0.%-1.0 qui fournira toujours le nom de domaine et
le tld, par exemple example.com sans tenir compte du
nombre de sous-domaines ajoutés au nom d'hôte. Dans ces conditions,
il est possible d'élaborer une configuration qui associera les
sous-domaines de premier, second et troisième niveau au même
répertoire :
VirtualDocumentRoot "/usr/local/apache/vhosts/%-2.0.%-1.0"
Dans l'exemple ci-dessus, www.example.com,
www.sub.example.com ou example.com
correspondront tous au répertoire
/usr/local/apache/vhosts/example.com.
Pour l'hébergement virtuel à base d'adresse IP, vous pouvez insérer les lignes suivantes dans votre fichier de configuration :
UseCanonicalName DNS VirtualDocumentRootIP "/usr/local/apache/vhosts/%1/%2/%3/%4/docs" VirtualScriptAliasIP "/usr/local/apache/vhosts/%1/%2/%3/%4/cgi-bin"
Si l'adresse IP de www.domaine.example.com est
10.20.30.40, une requête pour
http://www.domaine.example.com/repertoire/fichier.html
concernera la ressource
/usr/local/apache/vhosts/10/20/30/40/docs/repertoire/fichier.html.
Une requête pour
http://www.domaine.example.com/cgi-bin/script.pl
concernera la ressource
/usr/local/apache/vhosts/10/20/30/40/cgi-bin/script.pl.
Si vous voulez insérer le caractère . dans une
directive VirtualDocumentRoot, et si cela crée un
conflit avec un spécificateur %, vous pouvez contourner
le problème de la manière suivante :
VirtualDocumentRoot "/usr/local/apache/vhosts/%2.0.%3.0"
Une requête pour
http://www.domaine.example.com/repertoire/fichier.html
concernera alors la ressource
/usr/local/apache/vhosts/domaine.exemple/repertoire/fichier.html.
Les spécificateurs de format %V et %A
de la directive LogFormat s'avèrent très utiles
lorsqu'ils sont utilisés en conjonction avec ce module.
| Description: | Permet une configuration dynamique de la racine des documents d'un serveur virtuel donné |
|---|---|
| Syntaxe: | VirtualDocumentRoot répertoire-interpolé|none |
| Défaut: | VirtualDocumentRoot none |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_vhost_alias |
La directive VirtualDocumentRoot vous
permet de spécifier où le serveur HTTP Apache pourra trouver vos
documents en se basant
sur le nom du serveur. Le résultat de l'expansion du
répertoire-interpolé est utilisé comme racine de
l'arborescence des documents d'une manière similaire à l'argument de
la directive DocumentRoot. Si
répertoire-interpolé a pour valeur none, la
directive VirtualDocumentRoot est désactivée.
Cette directive ne peut pas être utilisée dans le même contexte que
la directive VirtualDocumentRootIP.
VirtualDocumentRoot l'emporte sur
toute directive DocumentRoot
définie dans le même contexte ou dans des contextes enfants. Le fait de
définir une directive VirtualDocumentRoot dans le
contexte du serveur principal va effectivement l'emporter sur toute
directive DocumentRoot définie dans
un serveur virtuel quelconque, si vous n'avez pas défini
VirtualDocumentRoot à None dans ce
serveur virtuel.
| Description: | Configuration dynamique de la racine des documents pour un serveur virtuel donné |
|---|---|
| Syntaxe: | VirtualDocumentRootIP répertoire-interpolé|none |
| Défaut: | VirtualDocumentRootIP none |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_vhost_alias |
La directive VirtualDocumentRootIP est
identique à la directive VirtualDocumentRoot à l'exception
près qu'elle utilise l'adresse IP du serveur virtuel pour
l'interpolation du répertoire à la place du nom du serveur.
| Description: | Configuration dynamique du répertoire des scripts CGI pour un serveur virtuel donné |
|---|---|
| Syntaxe: | VirtualScriptAlias répertoire-interpolé|none |
| Défaut: | VirtualScriptAlias none |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_vhost_alias |
La directive VirtualScriptAlias vous
permet de spécifier où Apache httpd pourra trouver les scripts CGI selon une
méthode similaire à celle qu'utilise la directive VirtualDocumentRoot pour les
autres documents. Elle recherche des requêtes dont l'URI commence
par /cgi-bin/, comme le ferait la directive ScriptAlias.
| Description: | Configuration dynamique du répertoire des scripts CGI pour un serveur virtuel donné |
|---|---|
| Syntaxe: | VirtualScriptAliasIP répertoire-interpolé|none |
| Défaut: | VirtualScriptAliasIP none |
| Contexte: | configuration globale, serveur virtuel |
| Statut: | Extension |
| Module: | mod_vhost_alias |
La directive VirtualScriptAliasIP est
identique à la directive VirtualScriptAlias à
l'exception près qu'elle utilise l'adresse IP du serveur virtuel
pour l'interpolation du répertoire à la place du nom du serveur.
Serveur HTTP Apache Version 2.4
Ce document décrit les termes utilisés pour décrire chaque module Apache.
Une brève description des fonctions du module.
Ce terme indique le degré de rapprochement du module par rapport au coeur du serveur web Apache ; en d'autres termes, vous pouvez être amené à recompiler le serveur pour pouvoir accéder au module et à ses fonctionnalités. Les valeurs possibles de cet attribut sont :
Il s'agit tout simplement de la liste des noms des fichiers
source qui contiennent le code du module. C'est aussi le nom utilisé
par la directive <IfModule>.
C'est une chaîne permettant d'identifier le module à utiliser
dans la directive LoadModule
pour le chargement dynamique des modules. En particulier, c'est le
nom de la variable externe de type module dans le fichier
source.
Si le module ne faisait pas partie de la distribution originale d'Apache version 2, la version à partir de laquelle il est disponible est indiquée ici. En outre, si le module n'est disponible que sur certaines plates-formes, cela sera mentionné ici.
Serveur HTTP Apache Version 2.4
| Description: | Module multi-processus optimisé pour Windows NT. |
|---|---|
| Statut: | MPM |
| Identificateur de Module: | mpm_winnt_module |
| Fichier Source: | mpm_winnt.c |
Ce module multi-processus (MPM) est le module par défaut pour les systèmes d'exploitation de style Windows NT. Il consiste en un processus de contrôle unique qui lance un processus enfant unique, ce dernier créant à son tour des threads pour traiter les requêtes.
La directive ThreadsPerChild définit le
nombre maximal de connexions clientes simultanées.
Ce MPM utilise par défaut les APIs Windows avancées pour accepter les nouvelles connexions des clients. Avec certaines configurations, des produits tiers peuvent interférer avec cette implémentation, et provoquer l'enregistrement des messages suivants dans les journaux du serveur :
Child: Encountered too many AcceptEx faults accepting client connections.
winnt_mpm: falling back to 'AcceptFilter none'.
Le MPM se rabat sur une implémentation plus sûre, mais certaines
requêtes n'ont pas été traitées correctement. Pour éviter cette
erreur, définissez la directive AcceptFilter à none.
AcceptFilter http none AcceptFilter https none
Avec les versions 2.0 et 2.2 d'Apache httpd, c'est la directive
Win32DisableAcceptEx qui était utilisée à cet
effet.
Le MPM WinNT diffère des autres MPMs Unix comme worker et event à bien des égards :
MaxConnectionsPerChild est
atteinte, les requêtes en cours de traitement par ce processus en
cours d'arrêt n'ont que TimeOut secondes pour s'exécuter avant
l'arrêt du processus. Les autres types de redémarrage ou arrêt ne
sont pas implémentés.MaxConnectionsPerChild, tout
changement survenu entre temps dans la configuration sera alors
pris en compte dans le processus enfant, et parent et enfant
utiliseront une configuration différente. Si des modifications
planifiées de la configuration ont été partiellement effectuées,
et si la configuration courante n'est pas interprétable, le
processus enfant de remplacement ne pourra pas démarrer, et le
serveur s'arrêtera. En conséquence, toute modification des
fichiers de configuration doit être accompagnée d'un redémarrage
du serveur.monitor et fatal_exception
ne sont pas encore implémentés.AcceptFilter est
implémentée par le MPM et fournit un type de contrôle différent
sur le traitement des nouvelles connexions (Voir la documentation
de la directive AcceptFilter
pour plus de détails). AcceptFilter CoreDumpDirectory Listen ListenBacklog MaxConnectionsPerChild MaxMemFree PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ThreadLimit ThreadsPerChild ThreadStackSizeServeur HTTP Apache Version 2.4
| Description: | Implémente un serveur web avec démarrage anticipé de processus, sans thread |
|---|---|
| Statut: | MPM |
| Identificateur de Module: | mpm_prefork_module |
| Fichier Source: | prefork.c |
Ce module multi-processus (MPM) implémente un serveur web avec démarrage anticipé de processus. Chaque processus du serveur peut répondre aux requêtes entrantes, et un processus parent contrôle la taille du jeu de processus enfants. Il est particulièrement indiqué pour les sites qui ne doivent pas utiliser les threads afin de maintenir une compatibilité avec certaines bibliothèques non sûres du point de vue des threads. C'est également le MPM le plus approprié si l'on veut isoler les requêtes les unes des autres, de façon à ce qu'un problème concernant une requête n'affecte pas les autres.
Ce MPM s'auto-contrôle de manière efficace, de sorte qu'il est
rarement nécessaire d'ajuster ses directives de configuration. Le
plus important est la définition de la directive MaxRequestWorkers ; sa valeur doit être
assez grande pour pouvoir traiter autant de requêtes simultanées que
vous pensez recevoir, mais assez petite pour conserver suffisamment
de mémoire RAM pour tous les processus.
CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareServers MinSpareServers PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers UserUn processus de contrôle unique a pour tâche de lancer les processus enfants qui attendent les connexions et les traitent au fur et à mesure qu'elles arrivent. Apache httpd essaie toujours de maintenir plusieurs processus serveurs inactifs ou en réserve, afin de pouvoir traiter les requêtes entrantes. De cette façon, les clients n'ont pas besoin d'attendre le démarrage d'un nouveau processus enfant pour que leurs requêtes puissent être traitées.
Les directives StartServers, MinSpareServers, MaxSpareServers et MaxRequestWorkers permettent de contrôler
la manière dont le processus parent crée les processus enfants pour
traiter les requêtes. En général, Apache httpd s'auto-contrôle de manière
efficace, de sorte que la plupart des sites peuvent conserver les
valeurs par défaut des directives. Les sites qui doivent traiter
plus de 256 requêtes simultanées doivent augmenter la valeur de
MaxRequestWorkers, alors que les
sites dont la ressource mémoire est limitée doivent la diminuer afin
d'éviter une hyperactivité du serveur (utilisation excessive de la
mémoire virtuelle sur disque). Vous trouverez plus d'informations à
propos du contrôle de la création de processus dans le document conseils en matière de
performances
Alors que le processus parent est en général démarré en tant que
root sous Unix afin de pouvoir se mettre à l'écoute sur le port 80, les
processus enfants sont lancés par Apache httpd sous un utilisateur avec
privilèges restreints. On peut contrôler les privilèges accordés aux
processus enfants d'Apache httpd à l'aide des directives User et Group. Les processus enfants doivent
être en mesure de lire tous les contenus destinés à être servis,
mais leurs privilèges doivent être aussi bas que possible.
La directive MaxConnectionsPerChild permet de
contrôler la fréquence à laquelle le serveur recycle ses processus
en arrêtant les plus anciens et en en lançant de nouveaux.
Ce module MPM utilise le mutex mpm-accept pour
sérialiser l'accès aux connexions entrantes lorsque peut se
présenter un problème d'afflux de requêtes (en général quand il y a
plusieurs sockets en écoute). Les aspects de l'implémentation de ce
mutex peuvent être configurés via la directive Mutex. Vous trouverez des informations
supplémentaires à propos de ce mutex dans la documentation à propos
des conseils en matière de
performances
| Description: | Nombre maximum de processus serveurs enfants inactifs |
|---|---|
| Syntaxe: | MaxSpareServers nombre |
| Défaut: | MaxSpareServers 10 |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | prefork |
La directive MaxSpareServers permet de
définir le nombre maximum souhaité de processus serveurs enfants
inactifs. Un processus inactif est un processus qui ne
traite pas de requête. S'il y a plus de
MaxSpareServers processus inactifs, le
processus parent arrêtera les processus excédentaires.
La modification de ce paramètre n'est nécessaire que
dans le cas de sites très sollicités. Définir ce paramètre à une
valeur très grande est cependant dans la plupart des cas une
mauvaise idée. Si vous essayez d'affecter à ce paramètre une valeur
égale ou inférieure à la valeur de MinSpareServers, le serveur HTTP Apache
l'ajustera automatiquement à la valeur de
MinSpareServers + 1.
| Description: | Nombre minimum de processus serveurs enfants inactifs |
|---|---|
| Syntaxe: | MinSpareServers nombre |
| Défaut: | MinSpareServers 5 |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | prefork |
La directive MinSpareServers permet de
définir le nombre minimum désiré de processus serveurs enfants
inactifs. Un processus inactif est un processus qui ne
traite pas de requête. S'il y a moins de
MinSpareServers processus inactifs, le
processus parent va créer de nouveaux enfants de la manière suivante
: il en crée un, attend une seconde, il en crée deux, attend une
seconde, il en crée quatre, puis continue ainsi exponentiellement
jusu'à ce que son taux de création de processus enfants soit de 32
par seconde. Il ne s'arrête que lorsque le nombre de processus
enfants correspond à la définition de la directive
MinSpareServers.
La modification de ce paramètre n'est nécessaire que dans le cas de sites très sollicités. Définir ce paramètre à une valeur très grande est dans la plupart des cas une mauvaise idée.
Serveur HTTP Apache Version 2.4
Ceci est un index, organisé en classes, des directives autorisées dans les
fichiers .htaccess pour différentes définitions de la directive AllowOverride. Il a pour but d'aider les
administrateurs à contrôler les privilèges qu'ils accordent aux
utilisateurs via les fichiers .htaccess. Pour une présentation de la
manière dont fonctionnent les fichiers .htaccess, voir le tutoriel .htaccess.
Pour déterminer le jeu de directives que la configuration de votre serveur autorise aux utilisateurs dans les fichiers .htaccess :
AllowOverrideList dans la section directory concernée. Sa
définition vous indiquera la liste des directives autorisées (La valeur
par défaut de cette directive est None).AllowOverride dans cette même section (sa valeur par défaut
est None). Il y a tout d'abord deux cas particuliers :
AllowOverride est définie à
All, vous pouvez ajouter toutes les directives indiquées
sur cette page à la liste préexistante.AllowOverride est définie à
None, inutile d'aller plus loin. Seules les directives indiquées
par la directive AllowOverrideList (si elle est présente)
seront autorisées.AllowOverride
définit une liste de classes de directives (vous trouverez plus loin le
jeu de directives correspondant à chacune de ces classes), et vous pourrez
alors les ajouter à la liste définie par la directive
AllowOverrideList.
De nombreuses classes de directives sont assez puissantes et peuvent
permettre aux utilisateurs des fichiers .htaccess de contrôler une grande
partie du serveur. Pour une approche plus sure, définissez
AllowOverride None, et utilisez la directive AllowOverrideList pour spécifier la liste exacte
de directives que les utilisateurs de fichiers .htaccess pourront utiliser.
Les directives suivantes sont autorisées dans les fichiers .htaccess, sous réserve que la surcharge soit autorisée dans la configuration du serveur.
| <Else> | core |
Contient des directives qui ne s'appliquent que si la
condition correspondant à la section <If> ou <ElseIf> précédente n'est pas satisfaite par la
requête à l'exécution | |
| <ElseIf> | core |
Contient des directives qui ne s'appliquent que si la
condition correspondante est satisfaite par une requête à l'exécution,
alors que la condition correspondant à la section <If> ou <ElseIf> précédente ne l'était pas. | |
| <Files> | core |
| Contient des directives qui s'appliquent aux fichiers précisés | |
| <FilesMatch> | core |
| Contient des directives qui s'appliquent à des fichiers spécifiés sous la forme d'expressions rationnelles | |
| <If> | core |
| Contient des directives qui ne s'appliquent que si une condition est satisfaite au cours du traitement d'une requête | |
| <IfDefine> | core |
| Contient des directives qui ne s'appliqueront que si un test retourne "vrai" au démarrage du serveur | |
| <IfDirective> | core |
| Regroupe des directives dont le traitement est conditionné par la présence ou l'absence d'une directive particulière | |
| <IfFile> | core |
| Regroupe des directives qui ne seront traitées que si un fichier existe au démarrage | |
| <IfModule> | core |
| Contient des directives qui ne s'appliquent qu'en fonction de la présence ou de l'absence d'un module spécifique | |
| <IfSection> | core |
| Regroupe des directives dont le traitement est conditionné par la présence ou l'absence d'une section particulière | |
| <IfVersion> | mod_version |
| Contient des portions de configuration dépendantes de la version | |
| LimitRequestBody | core |
| limite la taille maximale du corps de la requête HTTP envoyée par le client | |
| LimitXMLRequestBody | core |
| Définit la taille maximale du corps d'une requête au format XML | |
| LogIOTrackTTFB | mod_logio |
| Permet d'enregistrer le délai avant le premier octet (time to first byte - TTFB) | |
| LuaCodeCache | mod_lua |
| Configure le cache de code compilé. | |
| LuaHookAccessChecker | mod_lua |
| Fournit un point d'entrée pour la phase access_checker du traitement de la requête | |
| LuaHookAuthChecker | mod_lua |
| Fournit un point d'entrée pour la phase auth_checker du traitement de la requête | |
| LuaHookCheckUserID | mod_lua |
| Fournit un point d'entrée pour la phase check_user_id du traitement de la requête | |
| LuaHookFixups | mod_lua |
| Fournit un point d'entrée pour la phase de correction du traitement de la requête | |
| LuaHookInsertFilter | mod_lua |
| Fournit un point d'entrée pour la phase insert_filter du traitement de la requête | |
| LuaHookLog | mod_lua |
| Permet une insertion dans la phase de journalisation du traitement d'une requête | |
| LuaHookMapToStorage | mod_lua |
| Fournit un point d'entrée pour la phase map_to_storage du traitement de la requête | |
| LuaHookPreTranslate | mod_lua |
| Fournit un point d'entrée pour la phase de pré-traduction du traitement d'une requête | |
| LuaHookTranslateName | mod_lua |
| Fournit un point d'entrée à la phase du nom de traduction du traitement de la requête | |
| LuaHookTypeChecker | mod_lua |
| Fournit un point d'entrée pour la phase type_checker du traitement de la requête | |
| LuaInherit | mod_lua |
| Contrôle la manière dont les sections de configuration parentes sont fusionnées dans les enfants | |
| LuaMapHandler | mod_lua |
| Met en correspondance un chemin avec un gestionnaire lua | |
| LuaPackageCPath | mod_lua |
| Ajoute un répertoire au package.cpath de lua | |
| LuaPackagePath | mod_lua |
| Ajoute un répertoire au package.path de lua | |
| LuaQuickHandler | mod_lua |
| Fournit un point d'entrée pour la gestion rapide du traitement de la requête | |
| LuaRoot | mod_lua |
| Spécifie le chemin de base pour la résolution des chemins relatifs dans les directives de mod_lua | |
| LuaScope | mod_lua |
| Une valeur parmi once, request, conn, thread -- la valeur par défaut est once | |
| RLimitCPU | core |
| Limite le temps CPU alloué aux processus initiés par les processus enfants d'Apache httpd | |
| RLimitMEM | core |
| Limite la mémoire allouée aux processus initiés par les processus enfants d'Apache httpd | |
| RLimitNPROC | core |
| Limite le nombre de processus qui peuvent être initiés par les processus initiés par les processus enfants d'Apache httpd | |
| ServerSignature | core |
| Définit un pied de page pour les documents générés par le serveur | |
| SSIErrorMsg | mod_include |
| Message d'erreur affiché lorsqu'une erreur SSI survient | |
| SSITimeFormat | mod_include |
| Configuration du format d'affichage des dates | |
| SSIUndefinedEcho | mod_include |
| Chaîne à afficher lorsqu'on tente d'extraire le contenu d'une variable non définie | |
Les directives suivantes sont autorisées dans les fichiers .htaccess
lorsque AllowOverride AuthConfig a été spécifié. Elles
permettent aux utilisateurs de fichiers .htaccess de contrôler les
méthodes d'authentification et d'autorisation qui s'appliquent à
l'arborescence de leur répertoire, y compris de nombreuses directives
utilitaires pour la gestion de session et la configuration TLS.
| Anonymous | mod_authn_anon |
| Définit la liste des identifiants utilisateur autorisés à accéder sans vérification du mot de passe | |
| Anonymous_LogEmail | mod_authn_anon |
| Détermine si le mot de passe fourni sera enregistré dans le journal des erreurs | |
| Anonymous_MustGiveEmail | mod_authn_anon |
| Détermine si l'abscence de mot de passe est autorisée | |
| Anonymous_NoUserID | mod_authn_anon |
| Détermine si le champ identifiant peut être vide | |
| Anonymous_VerifyEmail | mod_authn_anon |
| Détermine s'il faut vérifier que le format de l'adresse email fournie comme mot de passe est correct | |
| AuthBasicAuthoritative | mod_auth_basic |
| Définit si les processus d'autorisation et d'authentification peuvent être confiés à des modules de plus bas niveau | |
| AuthBasicFake | mod_auth_basic |
| Authentification de base simulée à l'aide des nom d'utilisateur et mot de passe fournis | |
| AuthBasicProvider | mod_auth_basic |
| Définit le(les) fournisseur(s) d'authentification pour cette zone du site web | |
| AuthBasicUseDigestAlgorithm | mod_auth_basic |
| Vérifie les mots de passe auprès des fournisseurs d'authentification à la manière de l'authentification de type Digest. | |
| AuthDBMGroupFile | mod_authz_dbm |
| Définit le nom du fichier de base de données contenant la liste des groupes d'utilisateurs permettant de définir les autorisations des utilisateurs | |
| AuthDBMType | mod_authn_dbm |
| Définit le type de fichier de base de données utilisé pour stocker les mots de passe | |
| AuthDBMUserFile | mod_authn_dbm |
| Définit le nom d'un fichier de base de données pour l'authentification contenant la liste des utilisateurs et de leurs mots de passe | |
| AuthDigestAlgorithm | mod_auth_digest |
| Sélectionne l'algorithme utilisé pour calculer les condensés du défit et de sa réponse | |
| AuthDigestDomain | mod_auth_digest |
| Les URIs qui se trouvent dans le même espace de protection concernant l'authentification à base de condensés | |
| AuthDigestNonceLifetime | mod_auth_digest |
| Durée de validité du nombre à valeur unique du serveur (nonce) | |
| AuthDigestProvider | mod_auth_digest |
| Définit le(s) fournisseurs(s) d'authentification pour la zone du site web concernée | |
| AuthDigestQop | mod_auth_digest |
| Détermine le niveau de protection fourni par l'authentification à base de condensé | |
| AuthFormAuthoritative | mod_auth_form |
| Détermine si l'autorisation et l'authentification sont confiés à des modules de plus bas niveau | |
| AuthFormProvider | mod_auth_form |
| Définit le(s) fournisseur(s) d'authentification pour la zone concernée | |
| AuthGroupFile | mod_authz_groupfile |
| Définit le nom d'un fichier texte contenant la liste des groupes d'utilisateurs permettant de définir les autorisations des utilisateurs | |
| AuthLDAPAuthorizePrefix | mod_authnz_ldap |
| Spécifie le préfixe ajouté aux variables d'environnement durant la phase d'autorisation | |
| AuthLDAPBindAuthoritative | mod_authnz_ldap |
| Détermine si l'on doit utiliser d'autres fournisseurs d'authentification lorsque le serveur ne peut pas valider les données d'authentification de l'utilisateur, alors que ce dernier possède un DN. | |
| AuthLDAPBindDN | mod_authnz_ldap |
| Un DN optionnel pour se connecter au serveur LDAP | |
| AuthLDAPBindPassword | mod_authnz_ldap |
| Mot de passe à utiliser en conjonction avec le DN de connexion | |
| AuthLDAPCompareAsUser | mod_authnz_ldap |
| Utilisation des données d'authentification de l'utilisateur pour effectuer les comparaisons pour l'attribution des autorisations | |
| AuthLDAPCompareDNOnServer | mod_authnz_ldap |
| Utilise le serveur LDAP pour comparer les DNs | |
| AuthLDAPDereferenceAliases | mod_authnz_ldap |
| À quel moment le module va déréférencer les alias | |
| AuthLDAPGroupAttribute | mod_authnz_ldap |
| L'attribut LDAP utilisé pour vérifier l'appartenance d'un utilisateur à un groupe. | |
| AuthLDAPGroupAttributeIsDN | mod_authnz_ldap |
| Utilise le DN de l'utilisateur pour vérifier son appartenance à un groupe | |
| AuthLDAPInitialBindAsUser | mod_authnz_ldap |
| Détermine si le serveur effectue la recherche initiale du DN en utilisant le nom propre de l'utilisateur pour l'authentification de base et non de manière anonyme, ou en utilisant des données d'authentification codées en dur pour le serveur | |
| AuthLDAPInitialBindPattern | mod_authnz_ldap |
| Spécifie la modification a apporter au nom d'utilisateur pour l'authentification de base lors de l'authentification auprès du serveur LDAP pour effectuer une recherche de DN | |
| AuthLDAPMaxSubGroupDepth | mod_authnz_ldap |
| Spécifie la profondeur d'imbrication des sous-groupes maximale prise en compte avant l'abandon de la recherche de l'utilisateur. | |
| AuthLDAPRemoteUserAttribute | mod_authnz_ldap |
| Spécifie l'attribut dont la valeur renvoyée au cours de la requête de l'utilisateur sera utilisée pour définir la variable d'environnement REMOTE_USER | |
| AuthLDAPRemoteUserIsDN | mod_authnz_ldap |
| Utilise le DN de l'utilisateur pour définir la variable d'environnement REMOTE_USER | |
| AuthLDAPSearchAsUser | mod_authnz_ldap |
| Utilise les données d'authentification de l'utilisateur pour la recherche des autorisations | |
| AuthLDAPSubGroupAttribute | mod_authnz_ldap |
| Spécifie les noms d'attribut, un par directive, utilisés pour différencier les membres du groupe courant qui sont eux-mêmes des groupes. | |
| AuthLDAPSubGroupClass | mod_authnz_ldap |
| Spécifie quelles valeurs d'objectClass LDAP identifient les objets de l'annuaire qui sont des groupes au cours du traitement des sous-groupes. | |
| AuthLDAPURl | mod_authnz_ldap |
| L'URL permettant de spécifier les paramètres de la recherche LDAP | |
| AuthMerging | mod_authz_core |
| Définit la manière dont chaque logique d'autorisation des sections de configuration se combine avec celles des sections de configuration précédentes. | |
| AuthName | mod_authn_core |
| L'identifiant de l'autorisation à utiliser avec l'authentification HTTP | |
| AuthnCacheProvideFor | mod_authn_socache |
| Spécifie le fournisseur pour lequel on veut effectuer une mise en cache | |
| AuthnCacheTimeout | mod_authn_socache |
| Définit une durée de vie pour les entrées du cache | |
| AuthType | mod_authn_core |
| Type d'authentification utilisateur | |
| AuthUserFile | mod_authn_file |
| Définit le nom d'un fichier texte pour l'authentification contenant la liste des utilisateurs et de leurs mots de passe | |
| AuthzDBMType | mod_authz_dbm |
| Définit le type de fichier de base de données contenant la liste des groupes d'utilisateurs | |
| CGIPassAuth | core |
| Active la transmission d'en-têtes d'autorisation HTTP aux scripts en tant que variables CGI | |
| LDAPReferralHopLimit | mod_ldap |
| Le nombre maximum de redirections vers des serveurs alternatifs (referrals) avant l'abandon de la requête LDAP. | |
| LDAPReferrals | mod_ldap |
| Active la redirection vers des serveurs alternatifs au cours des requêtes vers le serveur LDAP. | |
| <Limit> | core |
| Limite les contrôles d'accès que la section contient à certaines méthodes HTTP | |
| <LimitExcept> | core |
| Applique les contrôles d'accès à toutes les méthodes HTTP, sauf celles qui sont spécifiées | |
| Require | mod_authz_core |
| Vérifie si un utilisateur authentifié a une autorisation d'accès accordée par un fournisseur d'autorisation. | |
| <RequireAll> | mod_authz_core |
| Regroupe plusieurs directives d'autorisation dont aucune ne doit échouer et dont au moins une doit retourner un résultat positif pour que la directive globale retourne elle-même un résultat positif. | |
| <RequireAny> | mod_authz_core |
| Regroupe des directives d'autorisation dont au moins une doit retourner un résultat positif pour que la directive globale retourne elle-même un résultat positif. | |
| <RequireNone> | mod_authz_core |
| Regroupe des directives d'autorisation dont aucune ne doit retourner un résultat positif pour que la directive globale n'échoue pas. | |
| Satisfy | mod_access_compat |
| Interaction entre le contrôle d'accès en fonction de l'hôte et l'authentification utilisateur | |
| Session | mod_session |
| Ouvre une session pour le contexte courant | |
| SessionEnv | mod_session |
| Définit si le contenu de la session doit être enregistré dans la variable d'environnement HTTP_SESSION | |
| SessionHeader | mod_session |
| Importation des mises à jour de session depuis l'en-tête de réponse HTTP spécifié | |
| SessionInclude | mod_session |
| Définit les préfixes d'URL pour lesquels une session est valide | |
| SessionMaxAge | mod_session |
| Définit une durée de vie maximale pour la session en secondes | |
| SSLCipherSuite | mod_ssl |
| Algorithmes de chiffrement disponibles pour la négociation au cours de l'initialisation de la connexion SSL | |
| SSLRenegBufferSize | mod_ssl |
| Définit la taille du tampon de renégociation SSL | |
| SSLRequire | mod_ssl |
| N'autorise l'accès que lorsqu'une expression booléenne complexe et arbitraire est vraie | |
| SSLRequireSSL | mod_ssl |
| Interdit l'accès lorsque la requête HTTP n'utilise pas SSL | |
| SSLUserName | mod_ssl |
| Nom de la variable servant à déterminer le nom de l'utilisateur | |
| SSLVerifyClient | mod_ssl |
| Niveau de vérification du certificat client | |
| SSLVerifyDepth | mod_ssl |
| Profondeur maximale des certificats de CA pour la vérification des certificats clients | |
Les directives suivantes sont autorisées dans les fichiers .htaccess
lorsque AllowOverride FileInfo a été spécifié. Elles
accordent aux utilisateurs de fichiers .htaccess un grand nombre de
contrôles sur les réponses et les métadonnées fournies par le serveur.
| AcceptPathInfo | core |
| Les ressources acceptent des informations sous forme d'un nom de chemin en fin de requête. | |
| Action | mod_actions |
| Active un script CGI pour un gestionnaire ou un type de contenu particulier | |
| AddCharset | mod_mime |
| Associe les extensions de noms de fichiers spécifiées au jeu de caractères spécifié | |
| AddDefaultCharset | core |
Paramètre jeu de caractères par défaut à ajouter quand le
type de contenu d'une réponse est text/plain ou
text/html | |
| AddEncoding | mod_mime |
| Associe les extensions de noms de fichiers données au type de codage spécifié | |
| AddHandler | mod_mime |
| Associe les extensions de noms de fichiers données au gestionnaire spécifié | |
| AddInputFilter | mod_mime |
| Associe les extensions de noms de fichiers aux filtres spécifiés qui traiteront les requêtes clients | |
| AddLanguage | mod_mime |
| Associe l'extension de nom de fichier donnée à la langue spécifié | |
| AddOutputFilter | mod_mime |
| Associe les extensions de noms de fichiers aux filtres spécifiés qui traiteront les réponses en provenance du serveur | |
| AddOutputFilterByType | mod_filter |
| assigne un filtre en sortie pour un type de média particulier | |
| AddType | mod_mime |
| Associe les extensions de noms de fichiers au type de contenu spécifié | |
| BrowserMatch | mod_setenvif |
| Définit des variables d'environnement en fonction du contenu de l'en-tête HTTP User-Agent | |
| BrowserMatchNoCase | mod_setenvif |
| Définit des variables d'environnement en fonction du contenu de l'en-tête HTTP User-Agent sans tenir compte de la casse | |
| CGIMapExtension | core |
| Technique permettant de localiser l'interpréteur des scripts CGI | |
| CGIVar | core |
| Contrôle la manière dont certaines variables CGI sont définies | |
| CharsetDefault | mod_charset_lite |
| Jeu de caractère vers lequel la traduction doit s'effectuer | |
| CharsetOptions | mod_charset_lite |
| Précise les détails de la traduction du jeu de caractères | |
| CharsetSourceEnc | mod_charset_lite |
| Jeu de caractères source des fichiers | |
| CookieDomain | mod_usertrack |
| Le domaine auquel le cookie traceur s'applique | |
| CookieExpires | mod_usertrack |
| Durée avant expiration du cookie traceur | |
| CookieHTTPOnly | mod_usertrack |
| Ajoute l'attribut 'HTTPOnly' au cookie | |
| CookieName | mod_usertrack |
| Nom du cookie traceur | |
| CookieSameSite | mod_usertrack |
| Ajoute l'attribut 'SameSite' au cookie | |
| CookieSecure | mod_usertrack |
| Ajoute l'attribut 'Secure' au cookie | |
| CookieStyle | mod_usertrack |
| Format du champ d'en-tête cookie | |
| CookieTracking | mod_usertrack |
| Active le cookie traceur | |
| DefaultLanguage | mod_mime |
| Définit un symbole de langue par défaut à affecter au champ d'en-tête Content-Language pour toutes les ressources dans le contexte courant auxquelles aucun symbole de langue n'a été associé. | |
| DefaultType | core |
Les seuls effets de cette directive sont des émissions
d'avertissements si sa valeur est différente de none. Dans
les versions précédentes, DefaultType permettait de spécifier un type de
média à assigner par défaut au contenu d'une réponse pour lequel aucun
autre type de média n'avait été trouvé.
| |
| EnableMMAP | core |
| Utilise la projection en mémoire (Memory-Mapping) pour lire les fichiers pendant qu'ils sont servis | |
| EnableSendfile | core |
| Utilise le support sendfile du noyau pour servir les fichiers aux clients | |
| ErrorDocument | core |
| Document que le serveur renvoie au client en cas d'erreur | |
| FileETag | core |
| Caractéristiques de fichier utilisées lors de la génération de l'en-tête de réponse HTTP ETag pour les fichiers statiques | |
| ForceLanguagePriority | mod_negotiation |
| Action à entreprendre si un document acceptable unique n'est pas trouvé | |
| ForceType | core |
| Force le type de médium spécifié dans le champ d'en-tête HTTP Content-Type pour les fichiers correspondants | |
| Header | mod_headers |
| Configure les en-têtes d'une réponse HTTP | |
| ISAPIAppendLogToErrors | mod_isapi |
Enregistrement des requêtes
HSE_APPEND_LOG_PARAMETER de la part des extensions ISAPI
dans le journal des erreurs | |
| ISAPIAppendLogToQuery | mod_isapi |
Enregistre les requêtes
HSE_APPEND_LOG_PARAMETER de la part des extensions ISAPI
dans la partie arguments de la requête | |
| ISAPIFakeAsync | mod_isapi |
| Emulation du support des entrées/sorties asynchrones pour les appels ISAPI | |
| ISAPILogNotSupported | mod_isapi |
| Journalisation des demandes de fonctionnalités non supportées de la part des extensions ISAPI | |
| ISAPIReadAheadBuffer | mod_isapi |
| Taille du tampon de lecture anticipée envoyé aux extensions ISAPI | |
| LanguagePriority | mod_negotiation |
| L'ordre de priorité des variantes de langages pour les cas où le client n'a pas formulé de préférences | |
| MultiviewsMatch | mod_mime |
| Les types de fichiers qui seront inclus lors d'une recherche de correspondance de fichier avec les vues multiples (MultiViews) | |
| PassEnv | mod_env |
| Transmet des variables d'environnement depuis le shell | |
| QualifyRedirectURL | core |
| Vérifie si la variable d'environnement REDIRECT_URL est pleinement qualifiée | |
| Redirect | mod_alias |
| Envoie une redirection externe demandant au client d'effectuer une autre requête avec une URL différente | |
| RedirectMatch | mod_alias |
| Envoie une redirection externe faisant appel aux expressions rationnelles pour la mise en correspondance de l'URL courante | |
| RedirectPermanent | mod_alias |
| Envoie une redirection externe permanente demandant au client d'effectuer une nouvelle requête avec une URL différente | |
| RedirectTemp | mod_alias |
| Envoie une redirection externe temporaire demandant au client d'effectuer une nouvelle requête avec une URL différente | |
| RemoveCharset | mod_mime |
| Supprime toute association de jeu de caractères pour un ensemble d'extensions de noms de fichiers | |
| RemoveEncoding | mod_mime |
| Supprime toute association de codage de contenu pour un ensemble d'extensions de noms de fichiers | |
| RemoveHandler | mod_mime |
| Supprime toute association de gestionnaire à un ensemble d'extensions de noms de fichiers | |
| RemoveInputFilter | mod_mime |
| Supprime toute association de filtre en entrée à un ensemble d'extensions de noms de fichiers | |
| RemoveLanguage | mod_mime |
| Supprime toute association de langue à un ensemble d'extensions de noms de fichiers | |
| RemoveOutputFilter | mod_mime |
| Supprime toute association de filtre en sortie à un ensemble d'extensions de noms de fichiers | |
| RemoveType | mod_mime |
| Supprime toute association de type de contenu à un ensemble d'extensions de noms de fichiers | |
| RequestHeader | mod_headers |
| Configure les en-têtes d'une requête HTTP | |
| RewriteBase | mod_rewrite |
| Définit l'URL de base pour les réécritures au niveau répertoire | |
| RewriteCond | mod_rewrite |
| Définit une condition qui devra être satisfaite pour que la réécriture soit effectuée | |
| RewriteEngine | mod_rewrite |
| Active ou désactive l'exécution du moteur de réécriture | |
| RewriteOptions | mod_rewrite |
| Configure certaines options spéciales pour le moteur de réécriture | |
| RewriteRule | mod_rewrite |
| Définit les règles pour le moteur de réécriture | |
| ScriptInterpreterSource | core |
| Permet de localiser l'interpréteur des scripts CGI | |
| SetEnv | mod_env |
| Définit des variables d'environnement | |
| SetEnvIf | mod_setenvif |
| Définit des variables d'environnement en fonction des attributs de la requête | |
| SetEnvIfExpr | mod_setenvif |
| Définit des variables d'environnement en fonction d'une expression ap_expr | |
| SetEnvIfNoCase | mod_setenvif |
| Définit des variables d'environnement en fonction des attributs de la requête sans tenir compte de la casse | |
| SetHandler | core |
| Force le traitement des fichiers spécifiés par un gestionnaire particulier | |
| SetInputFilter | core |
| Définit les filtres par lesquels vont passer les requêtes client et les données POST | |
| SetOutputFilter | core |
| Définit les filtres par lesquels vont passer les réponses du serveur | |
| Substitute | mod_substitute |
| Modèle de substition dans le contenu de la réponse | |
| SubstituteInheritBefore | mod_substitute |
| Modifie l'ordre de fusion des modèles hérités | |
| SubstituteMaxLineLength | mod_substitute |
| Définit la longueur de ligne maximale | |
| UnsetEnv | mod_env |
| Supprime des variables de l'environnement | |
Les directives suivantes sont autorisées dans les fichiers .htaccess
lorsque AllowOverride Indexes a été spécifié. Elles
permettent aux utilisateurs de fichiers .htaccess de contrôler certains
aspects des pages d'index de répertoires fournies par le serveur, y
compris la génération d'autoindex.
| AddAlt | mod_autoindex |
| Texte optionnel à afficher à la place d'un icône pour un fichier en fonction de son nom | |
| AddAltByEncoding | mod_autoindex |
| Texte optionnel à afficher à la place d'un icône pour un fichier en fonction de son codage MIME | |
| AddAltByType | mod_autoindex |
| Texte optionnel à afficher à la place d'un icône pour un fichier en fonction de son type MIME | |
| AddDescription | mod_autoindex |
| Afficher la description d'un fichier | |
| AddIcon | mod_autoindex |
| Icône à afficher pour un fichier en fonction de son nom | |
| AddIconByEncoding | mod_autoindex |
| Icône à afficher à côté d'un fichier en fonction de son codage MIME | |
| AddIconByType | mod_autoindex |
| Icône à afficher à côté d'un fichier en fonction de son type MIME | |
| DefaultIcon | mod_autoindex |
| Icône à afficher par défaut lorsqu'aucun icône spécifique n'est précisé | |
| DirectoryCheckHandler | mod_dir |
| Définit la réponse de ce module lorsqu'un autre gestionnaire est utilisé | |
| DirectoryIndex | mod_dir |
| Liste des fichiers ressources à rechercher lorsque le client envoie une requête pour un répertoire | |
| DirectoryIndexRedirect | mod_dir |
| Définit une redirection externe pour les index de répertoires. | |
| DirectorySlash | mod_dir |
| Activation/Désactivation de la redirection "slash de fin" | |
| ExpiresActive | mod_expires |
Active la génération d'en-têtes
Expires | |
| ExpiresByType | mod_expires |
Définition de la valeur de l'en-tête Expires
en fonction du type MIME | |
| ExpiresDefault | mod_expires |
| Mode de calcul par défaut de la date d'expiration | |
| FallbackResource | mod_dir |
| Définit une URL par défaut pour les requêtes qui ne ciblent aucun fichier | |
| HeaderName | mod_autoindex |
| Nom du fichier qui sera inséré au début de la page contenant l'index | |
| ImapBase | mod_imagemap |
Valeur par défaut de la directive base des
fichiers imagemap | |
| ImapDefault | mod_imagemap |
| Action à entreprendre par défaut lorsqu'un fichier imagemap est invoqué avec des coordonnées qui ne correspondent à aucune cible | |
| ImapMenu | mod_imagemap |
| Action à entreprendre si aucune coordonnée n'est fournie lorsqu'on invoque un fichier imagemap | |
| IndexHeadInsert | mod_autoindex |
| Insère du texte dans la section HEAD de la page d'index. | |
| IndexIgnore | mod_autoindex |
| Ajouts à la liste des fichiers à cacher lors de l'affichage de l'index d'un répertoire | |
| IndexIgnoreReset | mod_autoindex |
| Vide la liste des fichiers à cacher lors de l'affichage du contenu d'un répertoire | |
| IndexOptions | mod_autoindex |
| Diverses options de configuration pour l'indexation d'un répertoire | |
| IndexOrderDefault | mod_autoindex |
| Définit l'ordre d'affichage par défaut d'un index de répertoire | |
| IndexStyleSheet | mod_autoindex |
| Ajoute une feuille de style CSS à l'index du répertoire | |
| MetaDir | mod_cern_meta |
| Le nom du répertoire où trouver les fichiers de métainformations dans le style du CERN | |
| MetaFiles | mod_cern_meta |
| Active le traitement des métafichiers du CERN | |
| MetaSuffix | mod_cern_meta |
| Suffixe du fichier contenant les métainformations dans le style du CERN | |
| ReadmeName | mod_autoindex |
| Nom du fichier dont le contenu sera inséré à la fin de l'index | |
Les directives suivantes sont autorisées dans les fichiers .htaccess
lorsque AllowOverride Limit a été spécifié. Cette autorisation
de surcharge très restreinte permet principalement d'utiliser les
directives d'autorisation héritées fournies par
mod_access_compat.
| Allow | mod_access_compat |
| Spécifie quels hôtes peuvent accéder à une certaine zone du serveur | |
| Deny | mod_access_compat |
| Définit quels hôtes ne sont pas autorisés à accéder au serveur | |
| <Limit> | core |
| Limite les contrôles d'accès que la section contient à certaines méthodes HTTP | |
| <LimitExcept> | core |
| Applique les contrôles d'accès à toutes les méthodes HTTP, sauf celles qui sont spécifiées | |
| Order | mod_access_compat |
Définit le statut d'accès par défaut et l'ordre dans lequel
les directives Allow et
Deny sont évaluées. | |
Les directives suivantes sont autorisées dans les fichiers .htaccess
lorsque AllowOverride Options a été spécifié. Elles permettent
aux utilisateurs de fichiers .htaccess d'utiliser la directive
Options et d'autres directives similaires, ainsi que les
directives qui contrôlent la chaîne de filtrage.
| CheckBasenameMatch | mod_speling |
| Vérifie aussi la correspondance des fichiers, même avec des extensions différentes | |
| CheckCaseOnly | mod_speling |
| Limite l'action du module aux corrections de majuscules | |
| CheckSpelling | mod_speling |
| Active le module de correction | |
| ContentDigest | core |
Active la génération d'un en-tête Content-MD5
dans la réponse HTTP | |
| FilterChain | mod_filter |
| Configure la chaîne de filtrage | |
| FilterDeclare | mod_filter |
| Déclare un filtre intelligent | |
| FilterProtocol | mod_filter |
| Vérifie le respect du protocole HTTP | |
| FilterProvider | mod_filter |
| Enregistre un filtre de contenu | |
| Options | core |
| Définit les fonctionnalités disponibles pour un répertoire particulier | |
| ReflectorHeader | mod_reflector |
| Renvoie un en-tête d'entrée dans les en-têtes de sortie | |
| SSLOptions | mod_ssl |
| Configure différentes options d'exécution du moteur SSL | |
| XBitHack | mod_include |
| Interprète les directives SSI dans les fichiers dont le bit d'exécution est positionné | |
Serveur HTTP Apache Version 2.4
| Description: | Fournisseur de mémoire partagée basée sur les slots. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | slotmem_shm_module |
| Fichier Source: | mod_slotmem_shm.c |
mod_slotmem_shm est un fournisseur de mémoire qui
permet la création et l'accès à un segment de mémoire partagée dans
lequel les ensembles de données sont organisés en "slots".
L'ensemble de la mémoire partagée est effacé à chaque
redémarrage, que ce dernier soit graceful ou non. Les données sont
stockées et restituées dans/à partir d'un fichier défini par le
paramètre name des appels create et
attach. Si son chemin absolu n'est pas spécifié, le
chemin du fichier sera relatif au chemin défini par la directive
DefaultRuntimeDir.
mod_slotmem_shm fournit les fonctions d'API suivantes
:
/* appelle le callback pour tous les slots actifs */
apr_status_t doall(ap_slotmem_instance_t *s, ap_slotmem_callback_fn_t *func, void *data, apr_pool_t *pool)
/* crée un nouveau slot de mémoire dont chaque taille d'item est
item_size. 'name' est utilisé pour générer le nom du fichier
permettant de stocker/restaurer le contenu de la mémoire partagée,
si elle est configurée. Les valeurs possibles sont :
"none" - Mémoire partagée anonyme et pas de stockage permanent
"file-name" - [DefaultRuntimeDir]/file-name
"/absolute-file-name" - Chemin absolu du fichier */
apr_status_t create(ap_slotmem_instance_t **new, const char *name, apr_size_t item_size, unsigned int item_num, ap_slotmem_type_t type, apr_pool_t *pool)
/* attache à un slot de mémoire existant. Voir
'create' pour la description du paramètre
'name'. */
apr_status_t attach(ap_slotmem_instance_t **new, const char *name, apr_size_t *item_size, unsigned int *item_num, apr_pool_t *pool)
/* obtient la mémoire associée à ce slot actif. */
apr_status_t dptr(ap_slotmem_instance_t *s, unsigned int item_id, void **mem)
/* lit la mémoire depuis ce slot et la transfert vers dest */
apr_status_t get(ap_slotmem_instance_t *s, unsigned int item_id, unsigned char *dest, apr_size_t dest_len)
/* écrit dans ce slot la mémoire en provenance de src */
apr_status_t put(ap_slotmem_instance_t *slot, unsigned int item_id, unsigned char *src, apr_size_t src_len)
/* renvoie le nombre total de slots contenus dans ce segment */
unsigned int num_slots(ap_slotmem_instance_t *s)
/* renvoie la taille totale des données, en octets, contenues
dans un slot de ce segment */
apr_size_t slot_size(ap_slotmem_instance_t *s)
/* alloue le premier slot libre et le marque comme utilisé (n'effectue aucune
copie de données) */
apr_status_t grab(ap_slotmem_instance_t *s, unsigned int *item_id)
/* appropriation ou allocation forcée du slot spécifié et marquage comme
utilisé (n'effectue aucune copie de données) */
apr_status_t fgrab(ap_slotmem_instance_t *s, unsigned int item_id)
/* libère un slot et le marque comme non utilisé (n'effectue aucune
copie de données) */
apr_status_t release(ap_slotmem_instance_t *s, unsigned int item_id)
Ce module ne fournit aucune directive.
Serveur HTTP Apache Version 2.4
| Description: | Fournisseur de cache d'objets partagés basé sur dc. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | socache_dc_module |
| Fichier Source: | mod_socache_dc.c |
Le module mod_socache_dc est un fournisseur de cache
d'objets partagés qui permet la création et l'accès à un cache
maintenu par les bibliothèques de mise en cache de sessions
distribuées distcache.
Vous trouverez des détails à propos des autres fournisseurs de cache d'objets partagés ici.
Ce module ne fournit aucune directive.
Serveur HTTP Apache Version 2.4
| Description: | Fournisseur de cache d'objets partagés basé sur shmcb. |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | socache_shmcb_module |
| Fichier Source: | mod_socache_shmcb.c |
Le module mod_socache_shmcb est un fournisseur de cache
d'objets partagés qui permet la création et l'accès à un cache
maintenu par un tampon cyclique à hautes performances au sein d'un
segment de mémoire partagée.
shmcb:/chemin/vers/datafile(512000)
Vous trouverez des détails à propos des autres fournisseurs de cache d'objets partagés ici.
Ce module ne fournit aucune directive.
Serveur HTTP Apache Version 2.4
| Description: | Effectue des opérations de recherche/remplacement sur les corps de réponses |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | substitute_module |
| Fichier Source: | mod_substitute.c |
| Compatibilité: | Disponible depuis la version 2.2.7 du serveur HTTP Apache |
mod_substitute fournit un mécanisme permettant
d'effectuer des substitutions de chaînes fixes ou d'expressions
rationnelles sur les corps de réponses.
| Description: | Modèle de substition dans le contenu de la réponse |
|---|---|
| Syntaxe: | Substitute s/modèle/substitution/[infq] |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_substitute |
La directive Substitute permet de
spécifier un modèle de recherche/remplacement à appliquer au corps
de la réponse.
La signification du modèle peut être modifiée via toute combinaison de ces drapeaux :
inn force le traitement du
modèle en tant que chaîne fixe.ff, mod_substitute met à plat le
résultat d'une substitution (les conteneurs ou buckets ne sont
pas dissociés), ce qui permet à d'éventuelles substitutions
ultérieures de s'effectuer sur cette dernière. C'est le
comportement par défaut.qq, mod_substitute dissocie les
conteneurs (ou buckets) après chaque substitution. Ceci peut
améliorer la rapidité de la réponse et diminuer la quantité de
mémoire utilisée, mais ne doit être utilisé que s'il n'existe
aucune possibilité pour que le résultat d'une substitution ne
corresponde au modèle ou à l'expression rationnelle d'une
substitution ultérieure.substitution peut contenir du texte et des références arrières d'expressions rationnelles.
<Location "/">
AddOutputFilterByType SUBSTITUTE text/html
Substitute "s/foo/bar/ni"
</Location>
Le caractère utilisé pour séparer (ou "délimiter") les différentes partie de la valeur de substitution est référencé sous le nom de "délimiteur", et il s'agit le plus souvent d'un "slash".
Si le modèle ou la chaîne de substitution contient un caractère slash '/', il est possible d'utiliser un autre délimiteur afin de rendre la directive plus lisible :
<Location "/">
AddOutputFilterByType SUBSTITUTE text/html
Substitute "s|<BR */?>|<br />|i"
</Location>
Lorsqu'on utilise des expressions rationnelles, on peut insérer des références arrières dans les opérations de comparaison et de substitution, comme illustré dans l'exemple suivant :
<Location "/">
AddOutputFilterByType SUBSTITUTE text/html
# "foo=k,bar=k" -> "foo/bar=k"
Substitute "s|foo=(\w+),bar=\1|foo/bar=$1|"
</Location>
Un scénario courant d'utilisation de mod_substitute
est la situation où un serveur frontal mandate des requêtes pour un
serveur d'arrière-plan qui renvoie des documents HTML contenant des
URLs intégrées codées en dur qui font référence à ce serveur
d'arrière-plan. Ces URLs ne fonctionnent pas pour l'utilisateur
final car le serveur d'arrière-plan est hors d'atteinte.
On peut, dans ce cas, utiliser mod_substitute pour
réécrire ces URLs afin qu'elles soit utilisables dans la partie
située derrière le mandataire :
ProxyPass "/blog/" "http://internal.blog.example.com/" ProxyPassReverse "/blog/" "http://internal.blog.example.com/" Substitute "s|http://internal.blog.example.com/|http://www.example.com/blog/|i"
La directive ProxyPassReverse modifie tout en-tête
Location (redirection) envoyé par le serveur
d'arrière-plan et, dans cet exemple, la directive
Substitute se charge à son tour de la modification de
la réponse HTML.
| Description: | Modifie l'ordre de fusion des modèles hérités |
|---|---|
| Syntaxe: | SubstituteInheritBefore on|off |
| Défaut: | SubstituteInheritBefore on |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_substitute |
| Compatibilité: | Disponible à partir de la version 2.4.17 du serveur HTTP Apache |
Cette directive permet de définir si l'on applique les modèles
Substitute hérités en premier
(valeur on), ou après ceux du
contexte courant (valeur off). La valeur de la directive
SubstituteInheritBefore est
elle-même héritée, et les contextes qui en héritent (ceux qui ne
définissent pas explicitement leur propre directive
SubstituteInheritBefore) appliqueront donc
l'ordre de fusion défini le plus proche.
| Description: | Définit la longueur de ligne maximale |
|---|---|
| Syntaxe: | SubstituteMaxLineLength octets(b|B|k|K|m|M|g|G) |
| Défaut: | SubstituteMaxLineLength 1m |
| Contexte: | répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_substitute |
| Compatibilité: | Disponible à partir de la version 2.4.11 du serveur HTTP Apache |
La taille de la ligne traitée par mod_substitute
est limitée afin de restreindre l'utilisation des ressources
mémoire. La directive SubstituteMaxLineLength
permet de définir cette limite. La valeur de la limite peut être
spécifiée sous la forme d'un nombre d'octets, et peut être suffixée
par une des lettres b, B, k,
K, m, M, g ou
G pour fournir une valeur respectivement en octets,
kiloOctets, mégaOctets ou gigaOctets.
<Location "/">
AddOutputFilterByType SUBSTITUTE text/html
SubstituteMaxLineLength 10m
Substitute "s/foo/bar/ni"
</Location>
Serveur HTTP Apache Version 2.4
| Description: | Fournit une variable d'environnement contenant un identifiant unique pour chaque requête |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | unique_id_module |
| Fichier Source: | mod_unique_id.c |
Ce module fournit un identifiant dont l'unicité est garantie
parmi "toutes" les requêtes sous des conditions très précises.
L'identifiant unique le sera aussi parmi plusieurs machines
appartenant à un cluster correctement configuré. L'identifiant est
affecté à la variable d'environnement UNIQUE_ID pour
chaque requête. Les identifiants uniques sont utiles pour diverses
raisons dont la nature se situe au delà de la portée de ce
document.
Ce module ne fournit aucune directive.
Tout d'abord un bref rappel de la manière dont le serveur Apache fonctionne sous Unix (cette fonctionnalité n'étant actuellement pas supportée sous Windows NT). Sous Unix, Apache crée plusieurs processus enfants, ces derniers traitant les requêtes une par une. Chaque processus enfant peut traiter plusieurs requêtes pendant sa durée de vie. Dans le cadre de cette discussion, nous supposerons que les différents processus enfants ne s'échangent pas de données entre eux. Nous nous référerons aux processus enfants sous le nom de processus httpd.
Votre site web est réparti entre une ou plusieurs machines dont vous êtes l'administrateur, et que nous nommerons cluster de serveurs. Chaque serveur peut exécuter plusieurs instances d'Apache. L'ensemble de ces dernières sera considéré comme "l'Univers", et sous certaines hypothèses, nous montrerons qu'il est possible dans cet univers, de générer des identifiants uniques pour chaque requête, sans pour autant nécessiter une communication importante entre les différents serveurs du cluster.
Les machines de votre cluster doivent satisfaire ces conditions (même si le cluster ne comporte qu'une machine, vous devez synchroniser son horloge avec NTP) :
Au vu des caractéristiques actuelles du système d'exploitation, nous supposerons que les pids (identifiants processus) sont codés sur 32 bits. Si le système d'exploitation utilise plus de 32 bits pour un pid, la correction est triviale mais doit être effectuée dans le code.
Ces hypothèses posées, à un instant donné, nous pouvons distinguer tout processus httpd sur toute machine du cluster de tous les autres processus httpd. Pour ce faire, il suffit d'utiliser l'adresse IP de la machine et le pid du processus httpd. Un processus httpd peut traiter plusieurs requêtes simultanément si vous utilisez un module MPM multi-threadé. Pour identifier les threads, Apache httpd utilise en interne un index de threads. Ainsi, afin de générer des identifiants uniques pour chaque requête, il suffit d'effectuer une distinction en fonction du temps.
Pour déterminer le temps, nous utiliserons un repère de temps Unix (les secondes écoulées depuis le 1er janvier 1970 UTC), et un compteur 16 bits. La précision du repère de temps n'étant que d'une seconde, le compteur va représenter 65536 valeurs par seconde. Le quadruplet (adresse IP, pid, repère de temps, compteur) est en mesure de distinguer 65536 requêtes par seconde par processus httpd. Il peut cependant arriver que le même pid soit réutilisé au cours du temps, et le compteur est là pour pallier cet inconvénient.
Lorsqu'un processus enfant httpd est créé, le compteur est initialisé avec (nombre de microsecondes actuel divisé par 10) modulo 65536 (cette formule a été choisie pour éliminer certains problème de variance avec les bits de poids faibles du compteur de microsecondes sur certains systèmes). Lorsqu'un identifiant unique est généré, le repère de temps utilisé est le moment où la requête arrive sur le serveur web. Le compteur est incrémenté à chaque création d'identifiant (et peut repasser à 0 lorsqu'il a atteint sa valeur maximale).
Le noyau génère un pid pour chaque processus lors de sa création, et le compteur de pid est réinitialisé à une certaine valeur lorsqu'il a atteint sa valeur maximale (les pid sont codés sur 16 bits sous de nombreux Unixes, mais les systèmes les plus récents les ont étendus à 32 bits). La même valeur de pid pourra donc être réutilisée au cours du temps. Cependant, tant qu'elle n'est pas réutilisée dans la même seconde, elle ne remet pas en cause l'unicité de notre quadruplet. Nous supposerons donc que le système ne créera pas plus de 65536 processus en une seconde (ce nombre peut être de 32768 sous certains Unixes, mais même dans ce cas, on est en général loin de cette situation).
Il est possible que le temps se répète pour une raison quelconque. Supposons par exemple que l'horloge système soit retardée et repasse par un temps passé (ou bien, comme elle avançait, elle a été remise à l'heure, et elle repasse par un temps futur). Dans ce cas, il peut être facilement démontré que le couple pid/repère de temps peut être réutilisé. Le choix de la formule d'initialisation du compteur a été effectué dans l'intention de pallier ce problème. Notez qu'un nombre vraiment aléatoire serait souhaitable pour initialiser le compteur, mais il n'existe pas de tel nombre directement lisible sur la plupart des systèmes (c'est à dire que vous ne pouvez pas utiliser rand() car vous devez déclencher le générateur avec une valeur unique, et vous ne pouvez pas utiliser le temps à cet effet car celui-ci , au moins à la seconde près, s'est répété). Il ne s'agit donc pas d'une défense parfaite.
Même si elle n'est pas parfaite, quel est le degré d'efficacité de cette défense ? Supposons qu'une de vos machines serve au plus 500 requêtes par seconde (ce qui constitue une limite supérieure très raisonnable au moment où ce document est écrit, car les systèmes ne se contentent en général pas de débiter des fichiers statiques). Pour y parvenir, un certain nombre de processus enfants sera nécessaire, qui dépendra du nombre de clients simultanés présents. Mais soyons pessimiste et supposons qu'un seul processus enfant soit capable de servir 500 requêtes par secondes. Il existe 1000 valeurs de démarrage possibles du compteur pour lesquelles deux séquences de 500 requêtes puissent se recouvrir. Il y a donc 1,5% de chance que le processus enfant répète une valeur de compteur si le temps se répète (avec une résolution d'une seconde), et l'unicité sera alors remise en cause. C'est cependant un exemple très pessimiste, et avec les valeurs du monde réel, il y a bien moins de chances que cela ne se produise. Si vous estimez que ceci a tout de même quelque chances de se produire sur votre système, vous pouvez migrer vers un compteur à 32 bits (en modifiant le code).
On pourrait supposer que ceci a plus de chance de se produire lors du passage à l'heure d'hiver où l'horloge est "retardée". Cela ne constitue cependant pas un problème car les temps pris en compte ici sont des temps UTC, qui vont "toujours" de l'avant. Notez que les Unixes à base de processeur x86 peuvent nécessiter une configuration particulière pour que ceci soit vrai -- il doivent être configurés pour assumer que l'horloge système est en UTC et compenser de manière appropriée. Mais même dans ce cas, si vous utilisez NTP, votre temps UTC sera correct peu après le redémarrage.
La variable d'environnement UNIQUE_ID est construite
par codage du quadruplet de 144 bits (adresse IP sur 32 bits, pid
sur 32 bits, repère de temps sur 32 bits, compteur 16 bits et index
de threads sur 32 bits) en
utilisant l'alphabet [A-Za-z0-9@-] d'une manière
similaire à celle du codage MIME base64, et sa valeur se présente
sous la forme d'une chaîne de 24 caractères. L'alphabet MIME base64
est en fait [A-Za-z0-9+/] ; cependant, les caractères
+ et / nécessitent un codage particulier
dans les URLs, ce qui rend leur utilisation peu commode. Toutes les
valeurs sont codées dans l'ordre des octets d'une adresse réseau de
façon à ce
que le codage soit comparable entre des architectures où l'ordre des
octets est différent. L'ordre réel de codage est : repère de temps,
adresse IP, pid, compteur. Cet ordre de codage possède un but
précis, mais il faut souligner que les applications n'ont aucun
intérêt à entrer dans les détails de ce codage. Les applications
doivent se contenter de traiter la variable UNIQUE_ID
comme un symbole opaque, qui peut être comparé avec d'autres
UNIQUE_IDs en ne testant que leur égalité.
L'ordre a été choisi de façon à ce qu'il soit possible de
modifier le codage dans le futur sans avoir à se préoccuper de
conflits éventuels avec une base de données de
UNIQUE_IDs existante. Les nouveaux codages doivent
conserver le repère de temps comme premier élément, et pour le
reste, utiliser les même alphabet et longueur en bits. Comme les
repères de temps constituent essentiellement un séquence croissante,
il suffit que toutes les machines du cluster arrêtent de traiter
toute requête dans la même seconde repère, et n'utilisent
alors plus l'ancien format de codage. Ensuite, elles peuvent
reprendre le traitement des requêtes en utilisant les nouveaux
codages.
Nous pensons que ceci apporte une solution relativement portable au problème. Les identifiants générés possèdent une durée de vie pratiquement infinie car les identifiants futurs pourront être allongés selon les besoins. Pratiquement aucune communication n'est requise entre les machines du cluster (seule la synchronisation NTP est requise, ce qui représente une charge très faible), et aucune communication entre les processus httpd n'est nécessaire (la communication est implicite et incluse dans le pid assigné par le noyau). Dans des situations très spécifiques, l'identifiant peut être raccourci, mais dans ce cas, d'avantage d'informations doivent être admises (par exemple, les 32 bits de l'adresse IP sont excessifs pour la plupart des sites, mais il n'existe pas de valeur de remplacement portable plus courte).
Serveur HTTP Apache Version 2.4
| Description: | Journalisation Clickstream des liens parcourus par un utilisateur sur un site |
|---|---|
| Statut: | Extension |
| Identificateur de Module: | usertrack_module |
| Fichier Source: | mod_usertrack.c |
Ce module permet de suivre le parcours d'un utilisateur à travers votre site web en faisant appel aux cookies de navigateur.
CookieDomain CookieExpires CookieHTTPOnly CookieName CookieSameSite CookieSecure CookieStyle CookieTrackingmod_usertrack définit un cookie qui peut être
journalisé via les formats configurables du module
mod_log_config :
LogFormat "%{Apache}n %r %t" usertrack
CustomLog "logs/clickstream.log" usertrack
| Description: | Le domaine auquel le cookie traceur s'applique |
|---|---|
| Syntaxe: | CookieDomain domaine |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_usertrack |
Cette directive permet de définir le domaine auquel le cookie traceur s'applique. Si elle n'est pas présente, aucun domaine n'est inclus dans le champ d'en-tête cookie.
La chaîne dommaine doit commencer par un point,
et doit comporter au moins un point entouré
d'autres caractères. Par exemple, .example.com est
une chaîne valide, mais www.example.com et
.com ne le sont pas.
.co.uk, bien qu'un tel domaine remplisse les
conditions de validité décrites ci-dessus..com, et autoriser de tels cookies peut constituer un
risque en matière de sécurité. Ainsi, si vous vous situez sous un
domaine racine de deux niveaux, vous devez encore utiliser votre
domaine véritable, comme vous le feriez avec tout autre domaine
racine (par exemple .example.co.uk).
CookieDomain .example.com
| Description: | Durée avant expiration du cookie traceur |
|---|---|
| Syntaxe: | CookieExpires durée |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_usertrack |
Lorsqu'elle est utilisée, cette directive définit une durée avant l'expiration du cookie généré par le module usertrack. La durée peut être spécifiée sous la forme d'un nombre de secondes, ou sous une forme du style "2 weeks 3 days 7 hours". les termes valides sont : years, months, weeks, days, hours, minutes et seconds. Si la durée est spécifiée dans un format autre qu'un nombre de secondes, elle doit être entourée de guillemets.
Si cette directive est absente, la durée de vie des cookies est limitée à la session actuelle du navigateur.
CookieExpires "3 weeks"
| Description: | Ajoute l'attribut 'HTTPOnly' au cookie |
|---|---|
| Syntaxe: | CookieHTTPOnly on|off |
| Défaut: | CookieHTTPOnly off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_usertrack |
| Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache |
Lorsqu'elle est définie à 'ON', cette directive ajoute l'attribut 'HTTPOnly' au cookie de traçage. Cet attribut indique aux navigateurs qu'ils doivent bloquer javascript au cours de la lecture de la valeur du cookie.
| Description: | Nom du cookie traceur |
|---|---|
| Syntaxe: | CookieName symbole |
| Défaut: | CookieName Apache |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_usertrack |
Cette directive vous permet de modifier le nom du cookie que ce
module utilise pour sa journalisation. Le nom par défaut du cookie
est "Apache".
Vous devez spécifier un nom de cookie valide ; les résultats sont imprévisibles si vous utilisez un nom contenant des caractères inhabituels. Les caractères valides font partie des intervales A-Z, a-z, 0-9, "_", et "-".
CookieName clicktrack
| Description: | Ajoute l'attribut 'SameSite' au cookie |
|---|---|
| Syntaxe: | CookieSameSite None|Lax|Strict |
| Défaut: | unset |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_usertrack |
| Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache |
Lorsque cette directive est définie à 'None', 'Lax', ou 'Strict', l'attribut 'SameSite' est ajouté au cookie de traçage avec la valeur correspondante. Cet attribut indique aux navigateurs de quelle manière ils doivent traiter le cookie lorsqu'il est demandé dans un contexte cross-site.
'None' définit l'attribut 'SameSite' à 'None', ce qui correspond à la configuration la plus permissive. Pour ne pas ajouter cet attribut au cookie, il est donc préférable de ne pas définir du tout cette directive.
| Description: | Ajoute l'attribut 'Secure' au cookie |
|---|---|
| Syntaxe: | CookieSecure on|off |
| Défaut: | CookieSecure off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_usertrack |
| Compatibilité: | Disponible à partir de la version 2.4.42 du serveur HTTP Apache |
Lorsqu'elle est définie à 'ON', cette directive ajoute l'attribut 'Secure' au cookie de traçage. Cet attribut indique aux navigateurs qu'il ne doivent transmettre le cookie que via HTTPS.
| Description: | Format du champ d'en-tête cookie |
|---|---|
| Syntaxe: | CookieStyle
Netscape|Cookie|Cookie2|RFC2109|RFC2965 |
| Défaut: | CookieStyle Netscape |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_usertrack |
Cette directive permet de contrôler le format du champ d'en-tête cookie. Les trois formats autorisés sont :
Tous les clients ne supportent pas l'ensemble de ces formats,
mais il est conseillé d'utiliser le plus récent qui sera en général
supporté par le navigateur utilisé par vos utilisateurs. A l'heure où ce
document est écrit, la plupart des navigateurs supportent ces trois
formats, Cookie2 étant le format recommandé.
CookieStyle Cookie2
| Description: | Active le cookie traceur |
|---|---|
| Syntaxe: | CookieTracking on|off |
| Défaut: | CookieTracking off |
| Contexte: | configuration globale, serveur virtuel, répertoire, .htaccess |
| Surcharges autorisées: | FileInfo |
| Statut: | Extension |
| Module: | mod_usertrack |
Lorsque le module mod_usertrack est chargé, et
si CookieTracking on est définie, Apache enverra un
cookie traceur pour toute nouvelle requête. Cette directive peut
être utilisée pour activer ou désactiver ce comportement pour un
serveur virtuel ou un répertoire. Par défaut, l'activation de
mod_usertrack ne suffit pas pour
activer les cookies.
CookieTracking on
Serveur HTTP Apache Version 2.4
| Description: | Fournit une infrastructure permettant à d'autres modules d'exécuter des tâches périodiques. |
|---|---|
| Statut: | Base |
| Identificateur de Module: | watchdog_module |
| Fichier Source: | mod_watchdog.c |
| Compatibilité: | Disponible à partir de la version 2.3 du serveur HTTP Apache |
Le module mod_watchdog définit des
branchements (hooks) programmés pour permettre à d'autres modules
d'exécuter des tâches périodiques. Ces modules peuvent enregistrer des
gestionnaires (handlers) pour les branchements de
mod_watchdog. Actuellement, seuls les modules suivants
de la distribution Apache utilisent cette fonctionnalité :
mod_watchdog, ce dernier doit être lié statiquement
avec le serveur httpd ; s'il a été lié dynamiquement, il doit être
chargé avant l'appel au module qui doit utiliser sa fonctionnalité.
| Description: | Intervalle Watchdog en secondes |
|---|---|
| Syntaxe: | WatchdogInterval time-interval[s] |
| Défaut: | WatchdogInterval 1 |
| Contexte: | configuration globale |
| Statut: | Base |
| Module: | mod_watchdog |
Cette directive permet de définir l'intervalle entre chaque exécution du branchement watchdog. La valeur par défaut est de 1 seconde.
Serveur HTTP Apache Version 2.4
| Description: | Une série de directives implémentées par plusieurs modules multi-processus (MPM) |
|---|---|
| Statut: | MPM |
CoreDumpDirectory EnableExceptionHook GracefulShutdownTimeout Listen ListenBackLog ListenCoresBucketsRatio MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers StartThreads ThreadLimit ThreadsPerChild ThreadStackSize| Description: | Le répertoire dans lequel le serveur HTTP Apache va tenter de se positionner avant d'effectuer un vidage mémoire |
|---|---|
| Syntaxe: | CoreDumpDirectory répertoire |
| Défaut: | Voir ci-dessous pour le répertoire par défaut |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork |
Cette directive permet de définir le répertoire dans lequel
Apache httpd va tenter de se positionner avant d'effectuer un vidage
mémoire sur disque.
Si votre système d'exploitation est configuré pour créer des
fichiers de vidage mémoire dans le répertoire de travail des
processus qui se sont crashés,
CoreDumpDirectory est nécessaire pour
définir un répertoire de travail autre que le répertoire par défaut
ServerRoot, ce répertoire de
travail ne devant pas être accessible en écriture par l'utilisateur sous
lequel le serveur s'exécute.
Si vous avez besoin d'un vidage mémoire pour le débogage, vous pouvez utiliser cette directive pour le placer à un endroit différent. Cette directive n'a aucun effet si votre système d'exploitation n'est pas configuré pour créer des fichiers de vidage mémoire dans le répertoire de travail des processus qui se sont crashés.
Utiliser cette directive sous Linux peut permettre aux autres processus
du système s'exécutant avec les même privilèges (comme les scripts CGI) de
se rattacher aux processus httpd enfants via l'appel système
ptrace. La protection contre certaines attaques engageant la
sécurité peut s'en trouver affectée. Il est par conséquent déconseillé
d'utiliser cette directive sur les systèmes en production.
Si Apache httpd est démarré sous l'utilisateur root puis bascule vers
un autre utilisateur, le noyau Linux désactive les
vidages mémoire, même si le répertoire est accessible en écriture au
processus. Apache httpd (versions 2.0.46 et supérieures) réactive les
vidages mémoire sous Linux 2.4 et au delà, mais seulement si vous
définissez une directive CoreDumpDirectory.
Pour activer le vidage mémoire des exécutables suid sur les
systèmes de style BSD (comme FreeBSD), définissez
kern.sugid_coredump à 1.
CoreDumpDirectory n'est traité qu'à la
reception d'un certain nombre de signaux , SIGFPE, SIGILL, SIGABORT,
SIGSEGV, et SIGBUS.
Sur certains systèmes d'exploitation, SIGQUIT provoque aussi un
vidage mémoire, mais n'est pas traité par les directives
CoreDumpDirectory ou
EnableExceptionHook, si bien que la
définition du répertoire d'enregistrement du vidage mémoire est
entièrement dévolue au système d'exploitation.
| Description: | Active un hook ("point d'accrochage logiciel") qui exécute des gestionnaires d'exception après un crash |
|---|---|
| Syntaxe: | EnableExceptionHook On|Off |
| Défaut: | EnableExceptionHook Off |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork |
Pour des raisons de sécurité, cette directive n'est disponible
que si la compilation du serveur a été configurée avec l'option
--enable-exception-hook. Elle permet d'activer un hook
("point d'accrochage logiciel")
qui autorise certains modules externes à effectuer un branchement et
accomplir telle ou telle action après le crash d'un processus
enfant.
Deux modules, mod_whatkilledus et
mod_backtrace utilisent ce hook. Veuillez vous
référer à la page EnableExceptionHook de Jeff Trawick pour plus
d'informations à leur sujet.
| Description: | Spécifie le délai maximum après lequel le serveur va s'arrêter dans le cas d'un arrêt "en douceur" |
|---|---|
| Syntaxe: | GracefulShutdownTimeout seconds |
| Défaut: | GracefulShutdownTimeout 0 |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork |
| Compatibilité: | Disponible dans les versions 2.2 et supérieures |
La directive GracefulShutdownTimeout
permet de spécifier le temps, en secondes, pendant lequel le serveur
va continuer à fonctionner après avoir reçu un signal
"graceful-stop" ("Arrêt en douceur"), afin de terminer le traitement
des connexions en cours.
Définir cette valeur à zéro signifie au serveur d'attendre jusqu'à ce que toutes les requêtes en cours aient été traitées.
| Description: | Les adresses IP et ports sur lesquels le serveur écoute |
|---|---|
| Syntaxe: | Listen [adresse IP:]numéro port
[protocole] |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
| Compatibilité: | L'argument protocole est supporté depuis la version 2.1.5 |
La directive Listen permet de signifier à
Apache httpd de ne se mettre à l'écoute que sur les adresses IP et ports spécifiés ; par
défaut, le serveur répond aux requêtes en provenance de toutes les
interfaces réseau. La directive Listen est
dorénavant requise, et si elle est absente du fichier de
configuration, le serveur refusera de démarrer. Ceci constitue un
changement par rapport aux versions précédentes d'Apache httpd.
La directive Listen signifie au serveur de
n'accepter les requêtes entrantes que vers le port ou le couple
adresse-port spécifié. Si seulement un port est spécifié, le serveur
se met à l'écoute sur ce port sur toutes les interfaces réseau. Si une adresse IP
et un port sont spécifiés, le serveur va se mettre à l'écoute sur ce port sur
l'interface réseau correspondant à l'adresse IP.
On peut utiliser autant de directives
Listen que nécessaire pour spécifier
plusieurs adresses et/ou ports à écouter. Le serveur répondra aux
requêtes vers tous les adresses et ports spécifiés.
Par exemple, pour que le serveur accepte les connexions sur les ports 80 et 8000, utilisez :
Listen 80 Listen 8000
Pour que le serveur accepte les connexions sur deux interfaces et ports particuliers, spécifiez :
Listen 192.170.2.1:80 Listen 192.170.2.5:8000
Les adressee IPv6 doivent être entourées de crochets, comme dans l'exemple suivant :
Listen [2001:db8::a00:20ff:fea7:ccea]:80
L'argument optionnel protocole n'est pas nécessaire
dans la plupart des configurations. S'il est absent,
https est la valeur par défaut pour le port 443 et
http l'est pour tous les autres ports. L'argument
protocole sert à déterminer quel module doit traiter une requête, et
à appliquer des optimisations spécifiques à certains protocoles à
l'aide de la directive AcceptFilter.
La spécification d'un protocole n'est nécessaire que si vous
utilisez des ports non standards. Par exemple, pour configurer un
site en https sur le port 8443 :
Listen 192.170.2.1:8443 https
Listen pour les mêmes
adresse IP/port vont provoquer l'envoi d'un message d'erreur
Address already in use.
| Description: | Longueur maximale de la liste d'attente des connexions |
|---|---|
| Syntaxe: | ListenBackLog backlog |
| Défaut: | ListenBackLog 511 |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
La longueur maximale de la liste d'attente des connexions. En
général, aucune modification n'est nécessaire, ni même souhaitable ;
cependant, sur certains systèmes, il peut être nécessaire
d'en augmenter la valeur en cas d'attaque TCP SYN flood (envoi en
masse de requêtes SYN pour saturer le serveur). Voir le paramètre
backlog de l'appel système listen(2).
En fait, l'argument backlog sera souvent limité à une valeur inférieure en fonction du système d'exploitation. Notez aussi que de nombreux systèmes d'exploitation ne tiennent pas vraiment compte de la valeur spécifiée pour l'argument backlog, mais s'en inspirent seulement (et choisissent en général une valeur supérieure).
| Description: | Rapport entre le nombre de coeurs de processeur activés et le nombre de segments d'écoute |
|---|---|
| Syntaxe: | ListenCoresBucketsRatio ratio |
| Défaut: | ListenCoresBucketsRatio 0 (disabled) |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork |
| Compatibilité: | Disponible à partir de la version 2.4.13 du serveur HTTP
Apache, avec un noyau supportant l'option de socket
SO_REUSEPORT, et distribuant uniformément les nouvelles
connexions aux sockets d'écoute des processus (ou threads) qui
l'utilisent (par exemple Linux versions 3.9 et ultérieures, mais pas
l'implémentation courante de SO_REUSEPORT par les
plateformes de type BSD. |
Vous pouvez utiliser la directive
ListenCoresBucketsRatio pour spécifier un
ratio entre le nombre de coeurs de CPU activés et le nombre de
segments d'écoute (listeners' buckets) souhaités ; le serveur HTTP Apache va
alors créernum_cpu_cores / ratio segments d'écoute, chacun
contenant son propre socket d'écoute Listen sur le ou les mêmes ports ; chaque
processus enfant sera associé à un seul segment d'écoute (avec une
distribution de type round-robin des segments à la création des processus
enfants).
Sous Linux et BSD, un coeur de CPU peut être activé ou désactivé si Hotplug
a été configuré ; la directive
ListenCoresBucketsRatio doit donc tenir compte de ce
paramètre pour calculer le nombre de segments d'écoute à créer.
La directive ListenCoresBucketsRatio peut
améliorer le support de la montée en charge lorsque l'arrivée de
nouvelles connexions est/devient un goulot d'étranglement. Le test
de cette fonctionnalité avec des machines possédant un nombre de
coeurs de CPU important a permit de constater une amélioration des
performances significative et des temps de réponse plus courts.
Pour que cette fonctionnalité soit activée, le nombre de coeurs
de CPU doit être égal au moins au double du ratio
spécifié. Si vous spécifiez la valeur recommandée pour
ratio, à savoir 8, le nombre minimum de
coeurs de processeurs disponibles sera alors de 16. La valeur
optimale de ratio permettant d'obtenir des performances maximales
doit être calculée pour chaque système cible, en testant plusieurs valeurs
et en observant les résultats.
Cette directive influence le calcul des valeurs limites inférieures de
MinSpareThreads et MaxSpareThreads. En effet, pour accepter les
connexions de manière optimale, le nombre de processus enfants doit être un
multiple du nombre de segments d'écoute.
Listeners ou serveurs HTTP
Apache partagent la même adresse IP et portLa définition de l'option SO_REUSEPORT pour les sockets
d'écoute permet à plusieurs processus (partageant le même EUID,
par exemple root) de se rattacher à la même adresse IP et port,
sans obtenir l'erreur de rattachement que le système génère habituellement
lorsque ce cas se produit.
Cela signifie aussi que plusieurs instances d'Apache httpd configurées
avec le même IP:port et avec une valeur
ListenCoresBucketsRatio positive pourraient démarrer
sans erreur, et fonctionner ensuite avec une répartition uniforme des
connexions entrantes sur ces différentes instances (ce n'est PAS une
recommandation et ne constitue pas un usage approprié à tous les cas, mais
juste un avertissement sur le fait qu'un véritable problème de rattachement
multiple à un IP:port pourrait alors être occulté).
Au sein d'une même instance, Apache httpd vérifie la présence de
directives Listen multiples avec la même adresse IP
(ou nom d'hôte) et le même port, et refuse de démarrer si c'est le cas, ce
qui permet d'éviter la création de segments d'écoute dupliqués qui seraient
du coup inutiles et affecteraient les performances. Cependant, il ne peut
pas (et n'essaiera pas de le faire) intercepter tous les cas possibles de
recouvrement (comme un nom d'hôte correspondant à une adresse IP utilisée
quelque part ailleurs).
| Description: | Limite le nombre de connexions qu'un processus enfant va traiter au cours de son fonctionnement |
|---|---|
| Syntaxe: | MaxConnectionsPerChild number |
| Défaut: | MaxConnectionsPerChild 0 |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
| Compatibilité: | Disponible depuis la version 2.3.9 du serveur HTTP
Apache. L'ancien nom MaxRequestsPerChild est encore
supporté. |
La directive MaxConnectionsPerChild permet de
définir le nombre maximum de connexions qu'un processus enfant va
pouvoir traiter au cours de son fonctionnement. Lorsqu'il a traité
MaxConnectionsPerChild connexions, le processus
enfant est arrêté. Si MaxConnectionsPerChild est
définie à 0, il n'y a plus aucune limite sur le nombre
de connexions que le processus pourra traiter.
Définir MaxConnectionsPerChild à une valeur
non nulle limite la quantité de mémoire qu'un processus peut
consommer à cause de fuites (accidentelles) de mémoire.
| Description: | Quantité maximale de mémoire que l'allocateur principal est
autorisé à conserver sans appeler free() |
|---|---|
| Syntaxe: | MaxMemFree KOctets |
| Défaut: | MaxMemFree 2048 |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware |
La directive MaxMemFree permet de définir
le nombre maximum de KOctets libres que tout allocateur est
autorisé à conserver sans appeler free(). Dans les MPMs
threadés, chaque thread possède son propre allocateur. Si elle est
définie à 0, la quantité de mémoire libre que peut conserver un
allocateur est illimitée.
| Description: | Nombre maximum de connexions pouvant être traitées simultanément |
|---|---|
| Syntaxe: | MaxRequestWorkers nombre |
| Défaut: | Voir ci-dessous pour plus de détails |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork |
La directive MaxRequestWorkers permet de fixer le
nombre maximum de requêtes pouvant être traitées simultanément.
Si la limite MaxRequestWorkers est atteinte, toute
tentative de connexion sera normalement mise dans une file
d'attente, et ceci jusqu'à un certain nombre dépendant de la
directive ListenBacklog.
Lorsqu'un processus enfant se libèrera suite à la fin du traitement
d'une requête, la connexion en attente pourra être traitée à son
tour.
Pour les serveurs non threadés (c'est à dire utilisant
prefork), la directive
MaxRequestWorkers définit alors le nombre maximum de
processus enfants qui pourront être lancés simultanément pour
traiter les requêtes. La valeur par défaut est 256 ; si
vous l'augmentez, vous devez aussi augmenter la valeur de la
directive ServerLimit.
Pour les serveur threadés et hybrides (utilisant par
exemple event ou worker),
MaxRequestWorkers définit alors le nombre total de
threads qui seront disponibles pour servir les clients. Dans le
cas des MPMs hybrides, la valeur par défaut est 16
(directive ServerLimit) multiplié par la valeur
25 (directive ThreadsPerChild). Par conséquent, pour affecter à la
directive MaxRequestWorkers une valeur qui requiert
plus de 16 processus, vous devez aussi augmenter la valeur de la
directive ServerLimit.
Le nom de la directive MaxRequestWorkers
était MaxClients avant la version 2.3.13. Cet
ancien nom est encore supporté.
| Description: | Nombre maximum de threads inactifs |
|---|---|
| Syntaxe: | MaxSpareThreads nombre |
| Défaut: | Voir ci-dessous pour plus de détails |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, mpm_netware, mpmt_os2 |
C'est le nombre maximum de threads inactifs. Les MPMs utilisent cette directive de différentes manières.
Pour worker et event, la définition par défaut est
MaxSpareThreads 250. Ce MPM gère les threads inactifs
au niveau du serveur. Si le serveur possède trop de threads
inactifs, des processus enfants seront arrêtés jusqu'à ce que le
nombre de threads inactifs repasse en dessous de cette limite. Des
processus/threads supplémentaires sont susceptibles d'être créés si
ListenCoresBucketsRatio est
activée.
Pour mpm_netware, la définition par défaut est
MaxSpareThreads 100. Comme ce MPM n'exécute qu'un seul
processus, le nombre de processus inactifs est surveillé au
niveau du serveur.
mpmt_os2 fonctionne de manière similaire à
mpm_netware. Pour mpmt_os2, la
valeur par défaut est 10.
La gamme de valeurs pour MaxSpareThreads
est limitée. Apache httpd corrigera automatiquement cette valeur selon
les règles suivantes :
mpm_netware, MaxSpareThreads doit être supérieure à MinSpareThreads.worker et event, MaxSpareThreads
doit être supérieure ou égale à la somme de MinSpareThreads et ThreadsPerChild.| Description: | Nombre minimum de threads inactifs qui seront disponibles pour pouvoir traiter les pics de requêtes |
|---|---|
| Syntaxe: | MinSpareThreads nombre |
| Défaut: | Voir ci-dessous pour plus de détails |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, mpm_netware, mpmt_os2 |
C'est le nombre minimum de threads inactifs pour être en mesure de traiter les pics de requêtes. Les MPMs utilisent cette directive de différentes manières.
Avec worker et event, la définition par défaut est
MinSpareThreads 75, et le nombre de threads inactifs
est surveillé au niveau du serveur. Si le serveur ne possède pas
assez de threads inactifs, des processus enfants sont créés jusqu'à
ce que le nombre de threads inactifs repasse au dessus de
nombre. Des processus/threads supplémentaires peuvent
être créés si ListenCoresBucketsRatio est activée.
Avec mpm_netware, la définition par défaut est
MinSpareThreads 10 et, comme ce MPM n'exécute qu'un
seul processus, le nombre de threads est surveillé au niveau général du
serveur.
mpmt_os2 fonctionne de manière similaire à
mpm_netware. Pour mpmt_os2, la
valeur par défaut est 5.
| Description: | Ficher dans lequel le serveur enregistre l'identificateur de processus du démon |
|---|---|
| Syntaxe: | PidFile nom fichier |
| Défaut: | PidFile logs/httpd.pid |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpmt_os2 |
La directive PidFile permet de définir le
ficher dans lequel le serveur
enregistre l'identificateur de processus du démon. Si le chemin du
fichier n'est pas absolu, il est considéré comme relatif au chemin
défini par la directive ServerRoot.
PidFile /var/run/apache.pid
Il est souvent utile de pouvoir envoyer un signal au
serveur afin qu'il ferme et ouvre à nouveau ses journaux
d'erreur et de transfert, et recharge son
fichier de configuration. Pour ce faire, on envoie un signal SIGHUP
(kill -1) à l'identificateur de processus enregistré dans le fichier
défini par la directive PidFile.
La directive PidFile fait l'objet des
mêmes avertissements que ceux concernant le chemin d'enregistrement
des fichiers journaux et la sécurité.
Depuis la version 2 du serveur HTTP Apache, nous recommandons de n'utiliser
que le script apachectl, ou le script de
démarrage fourni avec votre système d'exploitation pour (re)démarrer ou
arrêter le serveur.
| Description: | Taille du tampon TCP en entrée |
|---|---|
| Syntaxe: | ReceiveBufferSize octets |
| Défaut: | ReceiveBufferSize 0 |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
Le serveur va fixer la taille du tampon TCP en entrée au nombre d'octets spécifié.
Si la directive est définie à 0, le serveur va
utiliser la valeur par défaut adoptée par le système
d'exploitation.
| Description: | Chemin du fichier où sont stockées les données concernant la coordination des processus enfants |
|---|---|
| Syntaxe: | ScoreBoardFile chemin fichier |
| Défaut: | ScoreBoardFile logs/apache_runtime_status |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork, mpm_winnt |
Le serveur HTTP Apache utilise un tableau de bord pour la communication entre le processus parent et les processus enfants. Pour faciliter cette communication, certaines architectures nécessitent un fichier. En l'absence de cette directive, donc si aucun nom de fichier n'est spécifié, Apache httpd tentera tout d'abord de créer un tableau uniquement en mémoire (en utilisant la mémoire partagée anonyme) ; et si il n'y parvient pas, il tentera de créer un fichier sur disque (en utilisant la mémoire partagée à base de fichier). Si cette directive est utilisée, Apache httpd créera systématiquement un fichier sur disque.
ScoreBoardFile /var/run/apache_runtime_status
Une mémoire partagée sous forme de fichier est utile pour les applications tierces qui nécessitent un accès direct au tableau de bord des processus.
Si vous utilisez un ScoreBoardFile, vous
pourrez constater une amélioration des performances en le plaçant
sur un disque virtuel en RAM. Assurez-vous cependant de tenir compte
des mêmes avertissements que ceux concernant le chemin du fichier
journal et la sécurité.
| Description: | Taille du tampon TCP en sortie |
|---|---|
| Syntaxe: | SendBufferSize octets |
| Défaut: | SendBufferSize 0 |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
Définit la taille du tampon TCP en sortie avec le nombre d'octets spécifié. Ceci s'avère souvent très utile pour augmenter les valeurs par défaut standards du passé des systèmes d'exploitation pour les transmissions à grande vitesse et haute densité (c'est à dire de l'ordre de 100ms comme sur les liaisons rapides transcontinentales).
Si la directive est définie à 0, le serveur va
utiliser la valeur par défaut adoptée par le système
d'exploitation.
L'amélioration des performances des connexions à grande vitesse et à temps de latence élevé, peut nécessiter une intervention au niveau de la configuration de votre système d'exploitation.
Sous certains systèmes d'exploitation, la modification du
comportement TCP via une augmentation de la valeur de
SendBufferSize risque de ne pas être
perceptible, si la directive EnableSendfile n'est pas définie à OFF.
Cette interaction ne s'applique qu'aux fichiers statiques.
| Description: | Limite supérieure de la définition du nombre de processus |
|---|---|
| Syntaxe: | ServerLimit nombre |
| Défaut: | Voir ci-dessous pour plus de détails |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork |
Avec le MPM prefork, cette directive définit le
nombre maximum que l'on peut affecter à la directive MaxRequestWorkers, et ceci pour la
durée de vie du processus Apache httpd. Avec les
MPMs worker et event, cette directive, en combinaison avec
ThreadLimit, définit le
nombre maximum que l'on peut affecter à MaxRequestWorkers, et ceci pour la durée de
vie du processus Apache httpd. Avec le MPM event, cette
directive permet aussi de définir le nombre de processus anciens du serveur
pouvant continuer à s'exécuter pour terminer le traitement des connexions
ouvertes. Au cours d'un redémarrage, vous pouvez
modifier la valeur de la directive MaxRequestWorkers, alors que toute
tentative de modification de la valeur de la directive ServerLimit sera ignorée.
Cette directive doit être utilisée avec précaution. Si
ServerLimit est définie à une valeur beaucoup
plus grande que nécessaire, de la mémoire partagée supplémentaire
sera inutilement allouée. Si à la fois
ServerLimit et MaxRequestWorkers possèdent des valeurs
supérieures à ce que le système peut supporter, ce dernier peut
devenir instable ou Apache httpd peut tout simplement refuser de démarrer.
Avec les MPMs prefork et event, n'utilisez cette directive
que si vous devez définir MaxRequestWorkers à une valeur supérieure à
256 (valeur par défaut). N'affectez pas à la directive ServerLimit une valeur supérieure à
celle que vous avez prévu d'affecter à la directive MaxRequestWorkers.
Avec worker, n'utilisez cette directive que si
la définition de vos directives MaxRequestWorkers et ThreadsPerChild nécessitent plus de
16 processus serveurs (valeur par défaut). N'affectez pas à la
directive ServerLimit une
valeur supérieure au nombre de processus requis pour la définition
des directives MaxRequestWorkers
et ThreadsPerChild.
Il existe une limite de ServerLimit 20000 codée en
dur dans le serveur (200000 pour le MPM prefork).
Ceci est censé éviter les effets désastreux que pourrait provoquer
une faute de frappe. Pour dépasser cette limite, vous devez
modifier la valeur de MAX_SERVER_LIMIT dans le fichier source du
mpm et recompiler le serveur.
| Description: | Nombre de processus enfants du serveur créés au démarrage |
|---|---|
| Syntaxe: | StartServers nombre |
| Défaut: | Voir ci-dessous pour plus de détails |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, prefork, mpmt_os2 |
La directive StartServers permet de
définir le nombre de processus enfants du serveur créés au
démarrage. Comme le nombre de processus est contrôlé dynamiquement
en fonction de la charge (voir MinSpareThreads, MaxSpareThreads, MinSpareServers, MaxSpareServers), il n'est en général
pas nécessaire d'ajuster ce paramètre.
La valeur par défaut diffère d'un MPM à l'autre. Pour
worker et event, la définition par défaut est
StartServers 3 ; la valeur par défaut est
5 pour prefork et 2
pour mpmt_os2.
| Description: | Nombre de threads créés au démarrage |
|---|---|
| Syntaxe: | StartThreads nombre |
| Défaut: | Voir ci-dessous pour plus de détails |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | mpm_netware |
C'est le nombre de threads créés au démarrage du serveur. Comme
le nombre de threads est contrôlé dynamiquement
en fonction de la charge (voir MinSpareThreads, MaxSpareThreads, MinSpareServers, MaxSpareServers), il n'est en général
pas nécessaire d'ajuster ce paramètre.
Pour mpm_netware, la définition par défaut est
StartThreads 50 et, comme il n'y a qu'un processus, il
s'agit du nombre total de threads créés au démarrage pour servir les
requêtes.
| Description: | Le nombre de threads maximum que l'on peut définir par processus enfant |
|---|---|
| Syntaxe: | ThreadLimit nombre |
| Défaut: | Voir ci-dessous pour plus de détails |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, mpm_winnt |
Cette directive permet de définir le nombre maximum que l'on peut
affecter à la directive ThreadsPerChild pour la durée de vie
du processus Apache httpd. La directive ThreadsPerChild peut être modifiée
au cours d'un redémarrage jusqu'à la valeur de la directive ThreadLimit, mais toute tentative
de modification de la directive ThreadLimit au cours d'un
redémarrage sera ignorée.
L'utilisation de cette directive doit faire l'objet de
précautions particulières. Si ThreadLimit est
définie à une valeur très supérieure à la directive ThreadsPerChild, de la mémoire
partagée supplémentaire sera inutilement allouée. Si les directives
ThreadLimit et ThreadsPerChild sont définies à des
valeurs supérieures à ce que le système peut supporter, ce dernier
peut devenir instable, ou Apache httpd peut tout simplement refuser de
démarrer. Ne définissez pas cette directive à une valeur supérieure
à la valeur maximale que vous pensez affecter à la directive ThreadsPerChild pour le processus
Apache httpd en cours d'exécution.
La valeur par défaut de la directive
ThreadLimit est 1920 avec
mpm_winnt, et 64 avec les autres
MPMs.
Il existe une limite de ThreadLimit 20000 (ou
ThreadLimit 100000 avec event,
ThreadLimit 15000 avec mpm_winnt)
codée en dur dans le serveur. Ceci est censé éviter les effets
désastreux que pourrait provoquer une faute de frappe. Pour
dépasser cette limite, vous devez modifier la valeur de
MAX_THREAD_LIMIT dans le fichier source du mpm et recompiler le
serveur.
| Description: | Nombre de threads créés par chaque processus enfant |
|---|---|
| Syntaxe: | ThreadsPerChild nombre |
| Défaut: | Voir ci-dessous pour plus de détails |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, mpm_winnt |
Cette directive permet de définir le nombre de threads que va
créer chaque processus enfant. Un processus enfant crée ces threads
au démarrage et n'en crée plus d'autres par la suite. Si l'on
utilise un MPM comme mpm_winnt qui ne lance qu'un
processus enfant, ce nombre doit être suffisamment grand pour
supporter la charge du serveur. Avec un MPM comme
worker qui lance plusieurs processus enfants, c'est
le nombre total de threads qui doit être suffisamment grand
pour supporter la charge du serveur.
La valeur par défaut de la directive
ThreadsPerChild est 64 avec
mpm_winnt, et 25 avec les autres
MPMs.
La valeur de la directive ThreadsPerChild ne peut
pas dépasser la valeur de la directive ThreadLimit. Si on spécifie une valeur
supérieure, elle sera automatiquement réduite au démarrage du serveur et un
avertissement sera enregistré dans le journal. La relation entre ces deux
directives est expliquée dans la documentation de la directive ThreadLimit.
| Description: | La taille en octets de la pile qu'utilisent les threads qui traitent les connexions clients |
|---|---|
| Syntaxe: | ThreadStackSize taille |
| Défaut: | 65536 sous NetWare; varie en fonction des autres systèmes
d'exploitation |
| Contexte: | configuration globale |
| Statut: | MPM |
| Module: | event, worker, mpm_winnt, mpm_netware, mpmt_os2 |
| Compatibilité: | Disponible dans les versions 2.1 et supérieures du serveur HTTP Apache |
La directive ThreadStackSize permet de
définir la taille de la pile (pour les données propres) qu'utilisent
les threads qui traitent les connexions clients en faisant appel à
des modules. Dans la plupart des cas, la valeur par défaut de la
taille de la pile du système d'exploitation convient, mais il existe
certaines situations où il peut s'avérer nécessaire de l'ajuster
:
ThreadStackSize à une
valeur supérieure à la valeur par défaut du système
d'exploitation. Ce type d'ajustement n'est nécessaire que si le
fournisseur du module tiers en fait mention, ou si le diagnostic
d'un crash d'Apache httpd indique que la taille de la pile était trop
petite.ThreadStackSize est définie à une valeur
inférieure à la valeur par défaut du système d'exploitation.
Cependant, ce
type d'ajustement ne doit être effectué que dans un environnement
de test permettant de qualifier le serveur web au maximum de ses
possibilités, car il peut arriver, dans de rares cas, que des
requêtes nécessitent une taille de pile supérieure pour pouvoir
être traitées. La taille minimale requise pour la pile dépend
fortement des modules utilisés, mais toute modification dans la
configuration du serveur web peut invalider la définition courante
de la directive ThreadStackSize.ulimit -s (8Mo si aucune limite) qui est
utilisée comme taille de pile par défaut.ThreadStackSize, à moins qu'un grand nombre
de threads par processus enfant ne soit nécessaire. Sur certaines
plates-formes (y compris Linux), une valeur de 128000 est déjà trop
basse et provoque des crashes avec certains modules courants.Serveur HTTP Apache Version 2.4
| Description: | MPM hybride multi-processus, multi-thread pour OS/2 |
|---|---|
| Statut: | MPM |
| Identificateur de Module: | mpm_mpmt_os2_module |
| Fichier Source: | mpmt_os2.c |
Le serveur se compose d'un processus principal parent, et d'un petit nombre fixe de processus enfants.
La tâche du processus parent consiste à gérer les processus
enfants, c'est à dire lancer ces processus de manière à ce
qu'il y en ait toujours un nombre égal à la valeur de la directive
StartServers pour traiter
les connexions.
Chaque processus enfant comporte un jeu de threads esclaves et un
thread maître qui accepte les connexions et les distribue aux
esclaves via une file de travail. Le jeu de threads esclaves est
dynamique et géré par un thread de maintenance de façon à ce que le
nombre de threads inactifs soit maintenu entre MinSpareThreads et MaxSpareThreads.
Group Listen ListenBacklog MaxConnectionsPerChild MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize SendBufferSize StartServers UserApache HTTP Server Version 2.4
Below is a list of all of the modules that come as part of the Apache HTTP Server distribution. See also the complete alphabetical list of all Apache HTTP Server directives.
worker MPM with the goal
of consuming threads only for connections with active processingA | B | C | D | E | F | H | I | L | M | N | P | R | S | U | V | W | X
ls command or the
Win32 dir shell commandmod_davmod_davExpires and
Cache-Control HTTP headers according to user-specified
criteriamod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxy_balancermod_proxymod_proxy extension for load balancing mod_proxy extension for
CONNECT request handlingmod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxymod_proxysed syntaxApache HTTP Server Version 2.4
| Description: | Group Authorization and Login using SQL |
|---|---|
| Status: | Extension |
| Module Identifier: | authz_dbd_module |
| Source File: | mod_authz_dbd.c |
| Compatibility: | Available in Apache 2.4 and later |
This module provides authorization capabilities so that
authenticated users can be allowed or denied access to portions
of the web site by group membership. Similar functionality is
provided by mod_authz_groupfile and
mod_authz_dbm, with the exception that
this module queries a SQL database to determine whether a
user is a member of a group.
This module can also provide database-backed user login/logout
capabilities. These are likely to be of most value when used
in conjunction with mod_authn_dbd.
This module relies on mod_dbd to specify
the backend database driver and connection parameters, and
manage the database connections.
Apache's Require
directives are used during the authorization phase to ensure that
a user is allowed to access a resource. mod_authz_dbd extends the
authorization types with dbd-group, dbd-login and
dbd-logout.
Since v2.4.8, expressions are supported within the DBD require directives.
This directive specifies group membership that is required for the user to gain access.
Require dbd-group team AuthzDBDQuery "SELECT user_group FROM authz WHERE user = %s"
This directive specifies a query to be run indicating the user has logged in.
Require dbd-login AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"
This directive specifies a query to be run indicating the user has logged out.
Require dbd-logout AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"
In addition to the standard authorization function of checking group membership, this module can also provide server-side user session management via database-backed login/logout capabilities. Specifically, it can update a user's session status in the database whenever the user visits designated URLs (subject of course to users supplying the necessary credentials).
This works by defining two special
Require types:
Require dbd-login and Require dbd-logout.
For usage details, see the configuration example below.
Some administrators may wish to implement client-side session management that works in concert with the server-side login/logout capabilities offered by this module, for example, by setting or unsetting an HTTP cookie or other such token when a user logs in or out.
To support such integration, mod_authz_dbd exports an
optional hook that will be run whenever a user's status is updated in
the database. Other session management modules can then use the hook
to implement functions that start and end client-side sessions.
# mod_dbd configuration
DBDriver pgsql
DBDParams "dbname=apacheauth user=apache pass=xxxxxx"
DBDMin 4
DBDKeep 8
DBDMax 20
DBDExptime 300
<Directory "/usr/www/my.site/team-private/">
# mod_authn_core and mod_auth_basic configuration
# for mod_authn_dbd
AuthType Basic
AuthName Team
AuthBasicProvider dbd
# mod_authn_dbd SQL query to authenticate a logged-in user
AuthDBDUserPWQuery \
"SELECT password FROM authn WHERE user = %s AND login = 'true'"
# mod_authz_core configuration for mod_authz_dbd
Require dbd-group team
# mod_authz_dbd configuration
AuthzDBDQuery "SELECT group FROM authz WHERE user = %s"
# when a user fails to be authenticated or authorized,
# invite them to login; this page should provide a link
# to /team-private/login.html
ErrorDocument 401 "/login-info.html"
<Files "login.html">
# don't require user to already be logged in!
AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
# dbd-login action executes a statement to log user in
Require dbd-login
AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"
# return user to referring page (if any) after
# successful login
AuthzDBDLoginToReferer On
</Files>
<Files "logout.html">
# dbd-logout action executes a statement to log user out
Require dbd-logout
AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"
</Files>
</Directory>
| Description: | Determines whether to redirect the Client to the Referring
page on successful login or logout if a Referer request
header is present |
|---|---|
| Syntax: | AuthzDBDLoginToReferer On|Off |
| Default: | AuthzDBDLoginToReferer Off |
| Context: | directory |
| Status: | Extension |
| Module: | mod_authz_dbd |
In conjunction with Require dbd-login or
Require dbd-logout, this provides the option to
redirect the client back to the Referring page (the URL in
the Referer HTTP request header, if present).
When there is no Referer header,
AuthzDBDLoginToReferer On will be ignored.
| Description: | Specify the SQL Query for the required operation |
|---|---|
| Syntax: | AuthzDBDQuery query |
| Context: | directory |
| Status: | Extension |
| Module: | mod_authz_dbd |
The AuthzDBDQuery specifies an SQL
query to run. The purpose of the query depends on the
Require directive in
effect.
Require dbd-group directive,
it specifies a query to look up groups for the current user. This is
the standard functionality of other authorization modules such as
mod_authz_groupfile and mod_authz_dbm.
The first column value of each row returned by the query statement
should be a string containing a group name. Zero, one, or more rows
may be returned.
Require dbd-group AuthzDBDQuery "SELECT group FROM groups WHERE user = %s"
Require dbd-login or
Require dbd-logout directive, it will never deny access,
but will instead execute a SQL statement designed to log the user
in or out. The user must already be authenticated with
mod_authn_dbd.
Require dbd-login AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"
In all cases, the user's ID will be passed as a single string
parameter when the SQL query is executed. It may be referenced within
the query statement using a %s format specifier.
| Description: | Specify a query to look up a login page for the user |
|---|---|
| Syntax: | AuthzDBDRedirectQuery query |
| Context: | directory |
| Status: | Extension |
| Module: | mod_authz_dbd |
Specifies an optional SQL query to use after successful login
(or logout) to redirect the user to a URL, which may be
specific to the user. The user's ID will be passed as a single string
parameter when the SQL query is executed. It may be referenced within
the query statement using a %s format specifier.
AuthzDBDRedirectQuery "SELECT userpage FROM userpages WHERE user = %s"
The first column value of the first row returned by the query statement should be a string containing a URL to which to redirect the client. Subsequent rows will be ignored. If no rows are returned, the client will not be redirected.
Note that AuthzDBDLoginToReferer takes
precedence if both are set.
Apache HTTP Server Version 2.4
| Description: | Group authorizations based on host (name or IP address) |
|---|---|
| Status: | Base |
| Module Identifier: | authz_host_module |
| Source File: | mod_authz_host.c |
| Compatibility: | The forward-dns provider was added in 2.4.19 |
The authorization providers implemented by mod_authz_host are
registered using the Require
directive. The directive can be referenced within a
<Directory>,
<Files>,
or <Location> section
as well as .htaccess
files to control access to particular parts of the server.
Access can be controlled based on the client hostname or IP address.
In general, access restriction directives apply to all
access methods (GET, PUT,
POST, etc). This is the desired behavior in most
cases. However, it is possible to restrict some methods, while
leaving other methods unrestricted, by enclosing the directives
in a <Limit> section.
This module provides no directives.
Apache's Require
directive is used during the authorization phase to ensure that a user is allowed or
denied access to a resource. mod_authz_host extends the
authorization types with ip, host,
forward-dns and local.
Other authorization types may also be
used but may require that additional authorization modules be loaded.
These authorization providers affect which hosts can access an area of the server. Access can be controlled by hostname, IP Address, or IP Address range.
Since v2.4.8, expressions are supported within the host require directives.
The ip provider allows access to the server
to be controlled based on the IP address of the remote client.
When Require ip ip-address is specified,
then the request is allowed access if the IP address matches.
A full IP address:
Require ip 10.1.2.3 Require ip 192.168.1.104 192.168.1.205
An IP address of a host allowed access
A partial IP address:
Require ip 10.1 Require ip 10 172.20 192.168.2
The first 1 to 3 bytes of an IP address, for subnet restriction.
A network/netmask pair:
Require ip 10.1.0.0/255.255.0.0
A network a.b.c.d, and a netmask w.x.y.z. For more fine-grained subnet restriction.
A network/nnn CIDR specification:
Require ip 10.1.0.0/16
Similar to the previous case, except the netmask consists of nnn high-order 1 bits.
Note that the last three examples above match exactly the same set of hosts.
IPv6 addresses and IPv6 subnets can be specified as shown below:
Require ip 2001:db8::a00:20ff:fea7:ccea Require ip 2001:db8:1:1::a Require ip 2001:db8:2:1::/64 Require ip 2001:db8:3::/48
Note: As the IP addresses are parsed on startup, expressions are not evaluated at request time.
The host provider allows access to the server
to be controlled based on the host name of the remote client.
When Require host host-name is specified,
then the request is allowed access if the host name matches.
A (partial) domain-name
Require host example.org Require host .net example.edu
Hosts whose names match, or end in, this string are allowed
access. Only complete components are matched, so the above
example will match foo.example.org but it will not
match fooexample.org. This configuration will cause
Apache to perform a double reverse DNS lookup on the client IP
address, regardless of the setting of the HostnameLookups directive. It will do
a reverse DNS lookup on the IP address to find the associated
hostname, and then do a forward lookup on the hostname to assure
that it matches the original IP address. Only if the forward
and reverse DNS are consistent and the hostname matches will
access be allowed.
The forward-dns provider allows access to the server
to be controlled based on simple host names. When
Require forward-dns host-name is specified,
all IP addresses corresponding to host-name
are allowed access.
In contrast to the host provider, this provider does not
rely on reverse DNS lookups: it simply queries the DNS for the host name
and allows a client if its IP matches. As a consequence, it will only
work with complete host names that can be resolved in DNS, not partial domain names.
However, as the reverse DNS is not used, and DNS lookups occur at request processing
time (instead of startup), it will work with clients which use a dynamic DNS service.
Require forward-dns dynamic.example.org
A client the IP of which is resolved from the name
dynamic.example.org will be granted access.
The forward-dns provider was added in 2.4.19.
The local provider allows access to the server if any
of the following conditions is true:
This allows a convenient way to match connections that originate from the local host:
Require local
If you are proxying content to your server, you need to be aware
that the client address will be the address of your proxy server,
not the address of the client, and so using the Require
directive in this context may not do what you mean. See
mod_remoteip for one possible solution to this
problem.
Apache HTTP Server Version 2.4
| Description: | Generates directory indexes,
automatically, similar to the Unix ls command or the
Win32 dir shell command |
|---|---|
| Status: | Base |
| Module Identifier: | autoindex_module |
| Source File: | mod_autoindex.c |
The index of a directory can come from one of two sources:
index.html. The DirectoryIndex directive sets the
name of the file or files to be used. This is controlled by
mod_dir.AddIcon, AddIconByEncoding and
AddIconByType are
used to set a list of icons to display for various file types;
for each file listed, the first icon listed that matches the
file is displayed. These are controlled by
mod_autoindex.The two functions are separated so that you can completely remove (or replace) automatic index generation should you want to.
Automatic index generation is enabled with using
Options +Indexes. See the
Options directive for
more details.
If the FancyIndexing option is given with the IndexOptions directive,
the column headers are links that control the order of the
display. If you select a header link, the listing will be
regenerated, sorted by the values in that column. Selecting the
same header repeatedly toggles between ascending and descending
order. These column header links are suppressed with the
IndexOptions directive's
SuppressColumnSorting
option.
Note that when the display is sorted by "Size", it's the actual size of the files that's used, not the displayed value - so a 1010-byte file will always be displayed before a 1011-byte file (if in ascending order) even though they both are shown as "1K".
AddAlt AddAltByEncoding AddAltByType AddDescription AddIcon AddIconByEncoding AddIconByType DefaultIcon HeaderName IndexHeadInsert IndexIgnore IndexIgnoreReset IndexOptions IndexOrderDefault IndexStyleSheet ReadmeNameVarious query string arguments are available to give the client
some control over the ordering of the directory listing, as well as
what files are listed. If you do not wish to give the client this
control, the IndexOptions
IgnoreClient option disables that functionality.
The column sorting headers themselves are self-referencing hyperlinks that add the sort query options shown below. Any option below may be added to any request for the directory resource.
C=N sorts the directory by file nameC=M sorts the directory by last-modified
date, then file nameC=S sorts the directory by size, then file
nameC=D sorts the directory by description, then
file nameO=A sorts the listing in Ascending
OrderO=D sorts the listing in Descending
OrderF=0 formats the listing as a simple list
(not FancyIndexed)F=1 formats the listing as a FancyIndexed
listF=2 formats the listing as an
HTMLTable FancyIndexed listV=0 disables version sortingV=1 enables version sortingP=pattern lists only files matching
the given patternNote that the 'P'attern query argument is tested
after the usual IndexIgnore directives are processed,
and all file names are still subjected to the same criteria as
any other autoindex listing. The Query Arguments parser in
mod_autoindex will stop abruptly when an unrecognized
option is encountered. The Query Arguments must be well formed,
according to the table above.
The simple example below, which can be clipped and saved in
a header.html file, illustrates these query options. Note that
the unknown "X" argument, for the submit button, is listed last
to assure the arguments are all parsed before mod_autoindex
encounters the X=Go input.
<form action="" method="get">
Show me a <select name="F">
<option value="0"> Plain list</option>
<option value="1" selected="selected"> Fancy list</option>
<option value="2"> Table list</option>
</select>
Sorted by <select name="C">
<option value="N" selected="selected"> Name</option>
<option value="M"> Date Modified</option>
<option value="S"> Size</option>
<option value="D"> Description</option>
</select>
<select name="O">
<option value="A" selected="selected"> Ascending</option>
<option value="D"> Descending</option>
</select>
<select name="V">
<option value="0" selected="selected"> in Normal order</option>
<option value="1"> in Version order</option>
</select>
Matching <input type="text" name="P" value="*" />
<input type="submit" name="X" value="Go" />
</form>
| Description: | Alternate text to display for a file, instead of an icon selected by filename |
|---|---|
| Syntax: | AddAlt string file [file] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
AddAlt provides the alternate text to
display for a file, instead of an icon, for FancyIndexing.
File is a file extension, partial filename, wild-card
expression or full filename for files to describe.
If String contains any whitespace, you have to enclose it
in quotes (" or '). This alternate text
is displayed if the client is image-incapable, has image loading
disabled, or fails to retrieve the icon.
AddAlt "PDF file" *.pdf AddAlt Compressed *.gz *.zip *.Z
| Description: | Alternate text to display for a file instead of an icon selected by MIME-encoding |
|---|---|
| Syntax: | AddAltByEncoding string MIME-encoding
[MIME-encoding] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
AddAltByEncoding provides the alternate
text to display for a file, instead of an icon, for FancyIndexing.
MIME-encoding is a valid content-encoding, such as
x-compress. If String contains any whitespace,
you have to enclose it in quotes (" or ').
This alternate text is displayed if the client is image-incapable,
has image loading disabled, or fails to retrieve the icon.
AddAltByEncoding gzip x-gzip
| Description: | Alternate text to display for a file, instead of an icon selected by MIME content-type |
|---|---|
| Syntax: | AddAltByType string MIME-type
[MIME-type] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
AddAltByType sets the alternate text to
display for a file, instead of an icon, for FancyIndexing.
MIME-type is a valid content-type, such as
text/html. If String contains any whitespace,
you have to enclose it in quotes (" or ').
This alternate text is displayed if the client is image-incapable,
has image loading disabled, or fails to retrieve the icon.
AddAltByType 'plain text' text/plain
| Description: | Description to display for a file |
|---|---|
| Syntax: | AddDescription string file [file] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
This sets the description to display for a file, for
FancyIndexing.
File is a file extension, partial filename, wild-card
expression or full filename for files to describe.
String is enclosed in double quotes (").
AddDescription "The planet Mars" mars.gif AddDescription "My friend Marshall" friends/mars.gif
The typical, default description field is 23 bytes wide. 6
more bytes are added by the IndexOptions SuppressIcon option, 7 bytes are
added by the IndexOptions SuppressSize option, and 19 bytes are
added by the IndexOptions SuppressLastModified option.
Therefore, the widest default the description column is ever
assigned is 55 bytes.
Since the File argument may be a partial file name,
please remember that a too-short partial filename may match
unintended files. For example, le.html will match the
file le.html but will also match the file
example.html. In the event that there may be ambiguity,
use as complete a filename as you can, but keep in mind that the
first match encountered will be used, and order your list of
AddDescription directives accordingly.
See the DescriptionWidth IndexOptions keyword for details on overriding the size
of this column, or allowing descriptions of unlimited length.
Descriptive text defined with AddDescription
may contain HTML markup, such as tags and character entities. If the
width of the description column should happen to truncate a tagged
element (such as cutting off the end of a bolded phrase), the
results may affect the rest of the directory listing.
Absolute paths are not currently supported and do not match anything at runtime. Arguments with relative path information, which would normally only be used in htaccess context, are implicitly prefixed with '*/' to avoid matching partial directory names.
| Description: | Icon to display for a file selected by name |
|---|---|
| Syntax: | AddIcon icon name [name]
... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
This sets the icon to display next to a file ending in
name for FancyIndexing. Icon is either a (%-escaped)
relative URL to the icon, a fully qualified remote URL, or of the format
(alttext,url) where alttext
is the text tag given for an icon for non-graphical browsers.
Name is either ^^DIRECTORY^^ for directories,
^^BLANKICON^^ for blank lines (to format the list
correctly), a file extension, a wildcard expression, a partial
filename or a complete filename.
^^BLANKICON^^ is only used for formatting, and so
is unnecessary if you're using IndexOptions
HTMLTable.
#Examples AddIcon (IMG,/icons/image.png) .gif .jpg .png AddIcon /icons/dir.png ^^DIRECTORY^^ AddIcon /icons/backup.png *~
AddIconByType
should be used in preference to AddIcon,
when possible.
| Description: | Icon to display next to files selected by MIME content-encoding |
|---|---|
| Syntax: | AddIconByEncoding icon MIME-encoding
[MIME-encoding] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
This sets the icon to display next to files with FancyIndexing.
Icon is either a (%-escaped) relative URL to the icon,
a fully qualified remote URL,
or of the format (alttext,url)
where alttext is the text tag given for an icon for
non-graphical browsers.
MIME-encoding is a valid content-encoding, such as
x-compress.
AddIconByEncoding /icons/compress.png x-compress
| Description: | Icon to display next to files selected by MIME content-type |
|---|---|
| Syntax: | AddIconByType icon MIME-type
[MIME-type] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
This sets the icon to display next to files of type
MIME-type for FancyIndexing.
Icon is either a (%-escaped) relative URL to the icon,
a fully qualified remote URL,
or of the format (alttext,url)
where alttext is the text tag given for an icon for
non-graphical browsers.
MIME-type is a wildcard expression matching required the mime types.
AddIconByType (IMG,/icons/image.png) image/*
| Description: | Icon to display for files when no specific icon is configured |
|---|---|
| Syntax: | DefaultIcon url-path |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
The DefaultIcon directive sets the icon
to display for files when no specific icon is known, for FancyIndexing.
Url-path is a (%-escaped) relative URL to the icon,
or a fully qualified remote URL.
DefaultIcon /icon/unknown.png
| Description: | Name of the file that will be inserted at the top of the index listing |
|---|---|
| Syntax: | HeaderName filename |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
The HeaderName directive sets the name
of the file that will be inserted at the top of the index
listing. Filename is the name of the file to include.
HeaderName HEADER.html
Both HeaderName and ReadmeName now treat
Filename as a URI path relative to the one used to
access the directory being indexed. If Filename begins
with a slash, it will be taken to be relative to the DocumentRoot.
HeaderName /include/HEADER.html
Filename must resolve to a document with a major
content type of text/* (e.g.,
text/html, text/plain, etc.). This means
that filename may refer to a CGI script if the script's
actual file type (as opposed to its output) is marked as
text/html such as with a directive like:
AddType text/html .cgi
Content negotiation
will be performed if Options
MultiViews is in effect. If filename resolves
to a static text/html document (not a CGI script) and
either one of the options
Includes or IncludesNOEXEC is enabled,
the file will be processed for server-side includes (see the
mod_include documentation).
If the file specified by HeaderName contains
the beginnings of an HTML document (<html>, <head>, etc.)
then you will probably want to set IndexOptions
+SuppressHTMLPreamble, so that these tags are not
repeated.
| Description: | Inserts text in the HEAD section of an index page. |
|---|---|
| Syntax: | IndexHeadInsert "markup ..." |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
The IndexHeadInsert directive specifies a
string to insert in the <head> section of the HTML
generated for the index page.
IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"
| Description: | Adds to the list of files to hide when listing a directory |
|---|---|
| Syntax: | IndexIgnore file [file] ... |
| Default: | IndexIgnore "." |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
The IndexIgnore directive adds to the
list of files to hide when listing a directory. File is a
shell-style wildcard expression or full
filename. Multiple IndexIgnore directives add
to the list, rather than replacing the list of ignored
files. By default, the list contains . (the current
directory).
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
This directive does not currently work in configuration sections
that have regular expression arguments, such as <DirectoryMatch>
| Description: | Empties the list of files to hide when listing a directory |
|---|---|
| Syntax: | IndexIgnoreReset ON|OFF |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
| Compatibility: | 2.3.10 and later |
The IndexIgnoreReset directive removes
any files ignored by IndexIgnore otherwise
inherited from other configuration sections.
<Directory "/var/www">
IndexIgnore *.bak .??* *~ *# HEADER* README* RCS CVS *,v *,t
</Directory>
<Directory "/var/www/backups">
IndexIgnoreReset ON
IndexIgnore .??* *# HEADER* README* RCS CVS *,v *,t
</Directory>
Review the default configuration for a list of patterns that you might want to explicitly ignore after using this directive.
| Description: | Various configuration settings for directory indexing |
|---|---|
| Syntax: | IndexOptions [+|-]option [[+|-]option]
... |
| Default: | By default, no options are enabled. |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
The IndexOptions directive specifies the
behavior of the directory indexing. Option can be one
of
IndexOptions HTMLTable
is in effect and an IndexStyleSheet is defined.
Rather than the standard even and odd
classes that would otherwise be applied to each row of the table,
a class of even-ALT or
odd-ALT where ALT is either the
standard alt text associated with the file style (eg. snd,
txt, img, etc) or the alt text defined by one of
the various AddAlt* directives.
Charset keyword allows you to
specify the character set of the generated page. The
default is UTF-8 on Windows and Mac OS X,
and ISO-8859-1 elsewhere.
(It depends on whether the underlying file system
uses Unicode filenames or not.)
IndexOptions Charset=UTF-8
DescriptionWidth keyword allows you to
specify the width of the description column in
characters.-DescriptionWidth (or unset) allows
mod_autoindex to calculate the best width.DescriptionWidth=n fixes the column width to
n bytes wide.DescriptionWidth=* grows the column to the
width necessary to accommodate the longest description
string.
See the section on AddDescription for dangers
inherent in truncating descriptions.FoldersFirst is enabled, subdirectory
Zed will be listed before subdirectory
Beta, which will be listed before normal files
Gamma and Alpha.
This option only has an effect if FancyIndexing
is also enabled.
FancyIndexing constructs
a simple table for the fancy directory listing.
It is necessary for utf-8 enabled platforms or if file
names or description text will alternate between
left-to-right and right-to-left reading order.IconWidth,
will cause the server to include height and
width attributes in the img tag for the file
icon. This allows browser to precalculate the page layout without having
to wait until all the images have been loaded. If no value is given for
the option, it defaults to the standard height of the icons supplied
with the Apache httpd software.
This option
only has an effect if FancyIndexing is also enabled.
IconHeight,
will cause the server to include height and
width attributes in the img tag for
the file icon. This allows browser to precalculate the page
layout without having to wait until all the images have been
loaded. If no value is given for the option, it defaults to
the standard width of the icons supplied with the Apache httpd
software.IgnoreCase is enabled, file Zeta will be listed after
file alfa (Note: file GAMMA will always be listed before file gamma).
mod_autoindex to ignore all
query variables from the client, including sort order (implies
SuppressColumnSorting.)NameWidth keyword allows you to specify the width
of the filename column in bytes.-NameWidth (or unset) allows mod_autoindex to calculate the best width, but only up
to 20 bytes wide.NameWidth=n fixes the column width to
n bytes wide.NameWidth=* grows the column to the necessary
width.AddDescription
then httpd will read the document for the value of the
title element. This is CPU and disk intensive.HTTP_UNAUTHORIZED or
HTTP_FORBIDDENIndexOptions
IgnoreClient.AddDescription for information about setting the file
description. See also the DescriptionWidth
index option to limit the size of the description column.
This option
only has an effect if FancyIndexing is also enabled.
HeaderName
directive, the module usually includes the contents of the file
after a standard HTML preamble (<html>,
<head>, et cetera). The
SuppressHTMLPreamble option disables this behaviour,
causing the module to start the display with the header file
contents. The header file must contain appropriate HTML instructions
in this case. If there is no header file, the preamble is generated
as usual. If you also specify a ReadmeName, and if that file
exists, The closing </body></html> tags are also
omitted from the output, under the assumption that you'll likely
put those closing tags in that file.SuppressIcon and
SuppressRules yields proper HTML 3.2 output, which
by the final specification prohibits img and
hr elements from the pre block (used to
format FancyIndexed listings.)FancyIndexing is also enabled.
hr
elements) in directory listings. Combining both SuppressIcon and
SuppressRules yields proper HTML 3.2 output, which
by the final specification prohibits img and
hr elements from the pre block (used to
format FancyIndexed listings.)
This option
only has an effect if FancyIndexing is also enabled.
FancyIndexing is also enabled.
Last-Modified and ETag
values for the listed directory in the HTTP header. It is only valid
if the operating system and file system return appropriate stat()
results. Some Unix systems do so, as do OS2's JFS and Win32's
NTFS volumes. OS2 and Win32 FAT volumes, for example, do not.
Once this feature is enabled, the client or proxy can track
changes to the list of files when they perform a HEAD
request. Note some operating systems correctly track new and
removed files, but do not track changes for sizes or dates of
the files within the directory. Changes to the size
or date stamp of an existing file will not update the
Last-Modified header on all Unix platforms.
If this is a concern, leave this option disabled.Type keyword allows you to
specify the MIME content-type of the generated page. The default
is text/html.
IndexOptions Type=text/plain
Last Modified field was
inadvertently changed to "%Y-%m-%d %H:%M" from
"%d-%b-%Y %H:%M" in 2.4.0. Setting this option
restores the date format from 2.2 and earlier.VersionSort keyword causes files containing
version numbers to sort in a natural way. Strings are sorted as
usual, except that substrings of digits in the name and
description are compared according to their numeric value.
foo-1.7
foo-1.7.2
foo-1.7.12
foo-1.8.2
foo-1.8.2a
foo-1.12
If the number starts with a zero, then it is considered to be a fraction:
foo-1.001
foo-1.002
foo-1.030
foo-1.04
XHTML keyword forces mod_autoindex
to emit XHTML 1.0 code instead of HTML 3.2.
This option
only has an effect if FancyIndexing is also enabled.
Be aware of how multiple IndexOptions are
handled.
IndexOptions directives for a
single directory are now merged together. The result of:
<Directory "/foo">
IndexOptions HTMLTable
IndexOptions SuppressColumnsorting
</Directory>
will be the equivalent of
IndexOptions HTMLTable SuppressColumnsorting
+ or -).Whenever a '+' or '-' prefixed keyword is encountered, it
is applied to the current IndexOptions
settings (which may have been inherited from an upper-level
directory). However, whenever an unprefixed keyword is processed, it
clears all inherited options and any incremental settings encountered
so far. Consider the following example:
IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing IndexOptions +SuppressSize
The net effect is equivalent to IndexOptions FancyIndexing
+SuppressSize, because the unprefixed FancyIndexing
discarded the incremental keywords before it, but allowed them to
start accumulating again afterward.
To unconditionally set the IndexOptions for
a particular directory, clearing the inherited settings, specify
keywords without any + or - prefixes.
| Description: | Sets the default ordering of the directory index |
|---|---|
| Syntax: | IndexOrderDefault Ascending|Descending
Name|Date|Size|Description |
| Default: | IndexOrderDefault Ascending Name |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
The IndexOrderDefault directive is used
in combination with the FancyIndexing index option. By default, fancyindexed
directory listings are displayed in ascending order by filename; the
IndexOrderDefault allows you to change this
initial display order.
IndexOrderDefault takes two
arguments. The first must be either Ascending or
Descending, indicating the direction of the sort.
The second argument must be one of the keywords Name,
Date, Size, or Description,
and identifies the primary key. The secondary key is
always the ascending filename.
You can, if desired, prevent the client from reordering the list
by also adding the SuppressColumnSorting
index option to remove the sort link from the top of the column,
along with the IgnoreClient index
option to prevent them from manually adding sort options to the
query string in order to override your ordering preferences.
| Description: | Adds a CSS stylesheet to the directory index |
|---|---|
| Syntax: | IndexStyleSheet url-path |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
The IndexStyleSheet directive sets the name of
the file that will be used as the CSS for the index listing.
IndexStyleSheet "/css/style.css"
Using this directive in conjunction with IndexOptions
HTMLTable adds a number of CSS classes to the resulting HTML.
The entire table is given a CSS id of indexlist and the
following classes are associated with the various parts of the
listing:
| Class | Definition |
|---|---|
| tr.indexhead | Header row of listing |
| th.indexcolicon and td.indexcolicon | Icon column |
| th.indexcolname and td.indexcolname | File name column |
| th.indexcollastmod and td.indexcollastmod | Last modified column |
| th.indexcolsize and td.indexcolsize | File size column |
| th.indexcoldesc and td.indexcoldesc | Description column |
| tr.breakrow | Horizontal rule at the bottom of the table |
| tr.odd and tr.even | Alternating even and odd rows |
| Description: | Name of the file that will be inserted at the end of the index listing |
|---|---|
| Syntax: | ReadmeName filename |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_autoindex |
The ReadmeName directive sets the name
of the file that will be appended to the end of the index
listing. Filename is the name of the file to include, and
is taken to be relative to the location being indexed. If
Filename begins with a slash, as in example 2, it will be taken to be
relative to the DocumentRoot.
# Example 1 ReadmeName FOOTER.html
# Example 2 ReadmeName /include/FOOTER.html
See also HeaderName, where this behavior is described in greater
detail.
Apache HTTP Server Version 2.4
| Description: | Core Authorization |
|---|---|
| Status: | Base |
| Module Identifier: | authz_core_module |
| Source File: | mod_authz_core.c |
| Compatibility: | Available in Apache HTTPD 2.3 and later |
This module provides core authorization capabilities so that
authenticated users can be allowed or denied access to portions
of the web site. mod_authz_core provides the
functionality to register various authorization providers. It is
usually used in conjunction with an authentication
provider module such as mod_authn_file and an
authorization module such as mod_authz_user. It
also allows for advanced logic to be applied to the
authorization processing.
AuthMerging <AuthzProviderAlias> AuthzSendForbiddenOnFailure Require <RequireAll> <RequireAny> <RequireNone>The authorization container directives
<RequireAll>,
<RequireAny>
and
<RequireNone>
may be combined with each other and with the
Require
directive to express complex authorization logic.
The example below expresses the following authorization logic.
In order to access the resource, the user must either be the
superadmin user, or belong to both the
admins group and the Administrators LDAP
group and either belong to the sales group or
have the LDAP dept attribute sales.
Furthermore, in order to access the resource, the user must
not belong to either the temps group or the
LDAP group Temporary Employees.
<Directory "/www/mydocs">
<RequireAll>
<RequireAny>
Require user superadmin
<RequireAll>
Require group admins
Require ldap-group "cn=Administrators,o=Airius"
<RequireAny>
Require group sales
Require ldap-attribute dept="sales"
</RequireAny>
</RequireAll>
</RequireAny>
<RequireNone>
Require group temps
Require ldap-group "cn=Temporary Employees,o=Airius"
</RequireNone>
</RequireAll>
</Directory>
mod_authz_core provides some generic authorization
providers which can be used with the
Require directive.
The env provider allows access to the server
to be controlled based on the existence of an environment variable. When Require
env env-variable is specified, then the request is
allowed access if the environment variable env-variable
exists. The server provides the ability to set environment
variables in a flexible way based on characteristics of the client
request using the directives provided by
mod_setenvif. Therefore, this directive can be
used to allow access based on such factors as the clients
User-Agent (browser type), Referer, or
other HTTP request header fields.
SetEnvIf User-Agent "^KnockKnock/2\.0" let_me_in
<Directory "/docroot">
Require env let_me_in
</Directory>
In this case, browsers with a user-agent string beginning
with KnockKnock/2.0 will be allowed access, and all
others will be denied.
When the server looks up a path via an internal
subrequest such as looking
for a DirectoryIndex
or generating a directory listing with mod_autoindex,
per-request environment variables are not inherited in the
subrequest. Additionally,
SetEnvIf directives
are not separately evaluated in the subrequest due to the API phases
mod_setenvif takes action in.
The all provider mimics the functionality that
was previously provided by the 'Allow from all' and 'Deny from all'
directives. This provider can take one of two arguments which are
'granted' or 'denied'. The following examples will grant or deny
access to all requests.
Require all granted
Require all denied
The method provider allows using the HTTP method in
authorization decisions. The GET and HEAD methods are treated as
equivalent. The TRACE method is not available to this provider,
use TraceEnable instead.
The following example will only allow GET, HEAD, POST, and OPTIONS requests:
Require method GET POST OPTIONS
The following example will allow GET, HEAD, POST, and OPTIONS requests without authentication, and require a valid user for all other methods:
<RequireAny>
Require method GET POST OPTIONS
Require valid-user
</RequireAny>
The expr provider allows basing authorization
decisions on arbitrary expressions.
Require expr "%{TIME_HOUR} -ge 9 && %{TIME_HOUR} -le 17"
<RequireAll>
Require expr "!(%{QUERY_STRING} =~ /secret/)"
Require expr "%{REQUEST_URI} in { '/example.cgi', '/other.cgi' }"
</RequireAll>
Require expr "!(%{QUERY_STRING} =~ /secret/) && %{REQUEST_URI} in { '/example.cgi', '/other.cgi' }"
The syntax is described in the ap_expr documentation. Before httpd 2.4.16, the surrounding double-quotes MUST be omitted.
Normally, the expression is evaluated before authentication. However, if
the expression returns false and references the variable
%{REMOTE_USER}, authentication will be performed and
the expression will be re-evaluated.
Extended authorization providers can be created within the configuration
file and assigned an alias name. The alias providers can then be referenced
through the Require directive
in the same way as a base authorization provider. Besides the ability to
create and alias an extended provider, it also allows the same extended
authorization provider to be referenced by multiple locations.
The example below creates two different ldap authorization provider aliases based on the ldap-group authorization provider. This example allows a single authorization location to check group membership within multiple ldap hosts:
<AuthzProviderAlias ldap-group ldap-group-alias1 "cn=my-group,o=ctx">
AuthLDAPBindDN "cn=youruser,o=ctx"
AuthLDAPBindPassword yourpassword
AuthLDAPUrl "ldap://ldap.host/o=ctx"
</AuthzProviderAlias>
<AuthzProviderAlias ldap-group ldap-group-alias2 "cn=my-other-group,o=dev">
AuthLDAPBindDN "cn=yourotheruser,o=dev"
AuthLDAPBindPassword yourotherpassword
AuthLDAPUrl "ldap://other.ldap.host/o=dev?cn"
</AuthzProviderAlias>
Alias "/secure" "/webpages/secure"
<Directory "/webpages/secure">
Require all granted
AuthBasicProvider file
AuthType Basic
AuthName LDAP_Protected_Place
#implied OR operation
Require ldap-group-alias1
Require ldap-group-alias2
</Directory>
| Description: | Controls the manner in which each configuration section's authorization logic is combined with that of preceding configuration sections. |
|---|---|
| Syntax: | AuthMerging Off | And | Or |
| Default: | AuthMerging Off |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_authz_core |
When authorization is enabled, it is normally inherited by each
subsequent configuration section,
unless a different set of authorization directives is specified.
This is the default action, which corresponds to an explicit setting
of AuthMerging Off.
However, there may be circumstances in which it is desirable
for a configuration section's authorization to be combined with
that of its predecessor while configuration sections are being
merged. Two options are available for this case, And
and Or.
When a configuration section contains AuthMerging And
or AuthMerging Or,
its authorization logic is combined with that of the nearest
predecessor (according to the overall order of configuration sections)
which also contains authorization logic as if the two sections
were jointly contained within a
<RequireAll> or
<RequireAny>
directive, respectively.
AuthMerging is not
inherited outside of the configuration section in which it appears.
In the following example, only users belonging to group alpha
may access /www/docs. Users belonging to either
groups alpha or beta may access
/www/docs/ab. However, the default Off
setting of AuthMerging applies to the
<Directory>
configuration section for /www/docs/ab/gamma, so
that section's authorization directives override those of the
preceding sections. Thus only users belong to the group
gamma may access /www/docs/ab/gamma.<Directory "/www/docs">
AuthType Basic
AuthName Documents
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
Require group alpha
</Directory>
<Directory "/www/docs/ab">
AuthMerging Or
Require group beta
</Directory>
<Directory "/www/docs/ab/gamma">
Require group gamma
</Directory>
| Description: | Enclose a group of directives that represent an extension of a base authorization provider and referenced by the specified alias |
|---|---|
| Syntax: | <AuthzProviderAlias baseProvider Alias Require-Parameters>
... </AuthzProviderAlias>
|
| Context: | server config |
| Status: | Base |
| Module: | mod_authz_core |
<AuthzProviderAlias> and
</AuthzProviderAlias> are used to enclose a group of
authorization directives that can be referenced by the alias name using the
directive Require.
If several parameters are needed in Require-Parameters, they must be enclosed in quotation marks. Otherwise, only the first one is taken into account.
# In this example, for both addresses to be taken into account, they MUST be enclosed
# between quotation marks
<AuthzProviderAlias ip reject-ips "XXX.XXX.XXX.XXX YYY.YYY.YYY.YYY">
</AuthzProviderAlias>
<Directory "/path/to/dir">
<RequireAll>
Require not reject-ips
Require all granted
</RequireAll>
</Directory>
| Description: | Send '403 FORBIDDEN' instead of '401 UNAUTHORIZED' if authentication succeeds but authorization fails |
|---|---|
| Syntax: | AuthzSendForbiddenOnFailure On|Off |
| Default: | AuthzSendForbiddenOnFailure Off |
| Context: | directory, .htaccess |
| Status: | Base |
| Module: | mod_authz_core |
| Compatibility: | Available in Apache HTTPD 2.3.11 and later |
If authentication succeeds but authorization fails, Apache HTTPD will
respond with an HTTP response code of '401 UNAUTHORIZED' by default. This
usually causes browsers to display the password dialogue to the user
again, which is not wanted in all situations.
AuthzSendForbiddenOnFailure allows to change the
response code to '403 FORBIDDEN'.
Modifying the response in case of missing authorization weakens the security of the password, because it reveals to a possible attacker, that his guessed password was right.
| Description: | Tests whether an authenticated user is authorized by an authorization provider. |
|---|---|
| Syntax: | Require [not] entity-name
[entity-name] ... |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_authz_core |
This directive tests whether an authenticated user is authorized
according to a particular authorization provider and the specified
restrictions. mod_authz_core provides the following
generic authorization providers:
Require all grantedRequire all deniedRequire env env-var [env-var]
...Require method http-method [http-method]
...Require expr expression Some of the allowed syntaxes provided by mod_authz_user,
mod_authz_host,
and mod_authz_groupfile are:
Require user userid [userid]
...Require group group-name [group-name]
...Require valid-userRequire ip 10 172.20 192.168.2Require forward-dns dynamic.example.orgOther authorization modules that implement require options
include mod_authnz_ldap,
mod_authz_dbm, mod_authz_dbd,
mod_authz_owner and mod_ssl.
In most cases, for a complete authentication and authorization
configuration, Require must be accompanied by
AuthName, AuthType and
AuthBasicProvider or
AuthDigestProvider
directives, and directives such as
AuthUserFile
and AuthGroupFile (to
define users and groups) in order to work correctly. Example:
AuthType Basic AuthName "Restricted Resource" AuthBasicProvider file AuthUserFile "/web/users" AuthGroupFile "/web/groups" Require group admin
Access controls which are applied in this way are effective for
all methods. This is what is normally
desired. If you wish to apply access controls only to
specific methods, while leaving other methods unprotected, then
place the Require statement into a
<Limit>
section.
The result of the Require directive
may be negated through the use of the
not option. As with the other negated authorization
directive <RequireNone>,
when the Require directive is negated it can
only fail or return a neutral result, and therefore may never
independently authorize a request.
In the following example, all users in the alpha
and beta groups are authorized, except for those who
are also in the reject group.
<Directory "/www/docs">
<RequireAll>
Require group alpha beta
Require not group reject
</RequireAll>
</Directory>
When multiple Require directives are
used in a single
configuration section
and are not contained in another authorization directive like
<RequireAll>,
they are implicitly contained within a
<RequireAny>
directive. Thus the first one to authorize a user authorizes the
entire request, and subsequent Require directives
are ignored.
Exercise caution when setting authorization directives in
Location sections
that overlap with content served out of the filesystem.
By default, these configuration sections overwrite authorization configuration
in Directory,
and Files sections.
The AuthMerging directive
can be used to control how authorization configuration sections are
merged.
| Description: | Enclose a group of authorization directives of which none must fail and at least one must succeed for the enclosing directive to succeed. |
|---|---|
| Syntax: | <RequireAll> ... </RequireAll> |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_authz_core |
<RequireAll> and
</RequireAll> are used to enclose a group of
authorization directives of which none must fail and at least one
must succeed in order for
the <RequireAll> directive to
succeed.
If none of the directives contained within the
<RequireAll> directive fails,
and at least one succeeds, then the
<RequireAll> directive
succeeds. If none succeed and none fail, then it returns a
neutral result. In all other cases, it fails.
| Description: | Enclose a group of authorization directives of which one must succeed for the enclosing directive to succeed. |
|---|---|
| Syntax: | <RequireAny> ... </RequireAny> |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_authz_core |
<RequireAny> and
</RequireAny> are used to enclose a group of
authorization directives of which one must succeed in order for
the <RequireAny> directive to
succeed.
If one or more of the directives contained within the
<RequireAny> directive succeed,
then the <RequireAny> directive
succeeds. If none succeed and none fail, then it returns a
neutral result. In all other cases, it fails.
<RequireAny>
directive. (At most they could cause the directive to fail in
the case where they failed and all other directives returned a
neutral value.) Therefore negated authorization directives
are not permitted within a <RequireAny>
directive.| Description: | Enclose a group of authorization directives of which none must succeed for the enclosing directive to not fail. |
|---|---|
| Syntax: | <RequireNone> ... </RequireNone> |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_authz_core |
<RequireNone> and
</RequireNone> are used to enclose a group of
authorization directives of which none must succeed
in order for the
<RequireNone> directive to
not fail.
If one or more of the directives contained within the
<RequireNone> directive succeed,
then the <RequireNone> directive
fails. In all other cases, it returns a neutral result. Thus as with
the other negated authorization directive Require not,
it can never independently
authorize a request because it can never return a successful result.
It can be used, however, to restrict the set of users who are
authorized to access a resource.
<RequireNone>
directive. Therefore negated authorization directives
are not permitted within a
<RequireNone> directive.Apache HTTP Server Version 2.4
| Description: | Group authorization using plaintext files |
|---|---|
| Status: | Base |
| Module Identifier: | authz_groupfile_module |
| Source File: | mod_authz_groupfile.c |
| Compatibility: | Available in Apache 2.1 and later |
This module provides authorization capabilities so that
authenticated users can be allowed or denied access to portions
of the web site by group membership. Similar functionality is
provided by mod_authz_dbm.
Apache's Require
directives are used during the authorization phase to ensure that
a user is allowed to access a resource. mod_authz_groupfile extends the
authorization types with group and group-file.
Since v2.4.8, expressions are supported within the groupfile require directives.
This directive specifies group membership that is required for the user to gain access.
Require group admin
When this directive is specified, the filesystem permissions on
the file being accessed are consulted. The user must be a member of
a group with the same name as the group that owns the file.
See mod_authz_owner for more
details.
Require file-group
| Description: | Sets the name of a text file containing the list of user groups for authorization |
|---|---|
| Syntax: | AuthGroupFile file-path |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_authz_groupfile |
The AuthGroupFile directive sets the
name of a textual file containing the list of user groups for user
authorization. File-path is the path to the group
file. If it is not absolute, it is treated as relative to the ServerRoot.
Each line of the group file contains a groupname followed by a colon, followed by the member usernames separated by spaces.
mygroup: bob joe anne
Note that searching large text files is very
inefficient; AuthDBMGroupFile provides a much better performance.
Make sure that the AuthGroupFile is
stored outside the document tree of the web-server; do not
put it in the directory that it protects. Otherwise, clients may
be able to download the AuthGroupFile.
Apache HTTP Server Version 2.4
| Description: | User Authorization |
|---|---|
| Status: | Base |
| Module Identifier: | authz_user_module |
| Source File: | mod_authz_user.c |
| Compatibility: | Available in Apache 2.1 and later |
This module provides authorization capabilities so that
authenticated users can be allowed or denied access to portions
of the web site. mod_authz_user grants
access if the authenticated user is listed in a Require user
directive. Alternatively Require valid-user can be used to
grant access to all successfully authenticated users.
This module provides no directives.
Apache's Require
directives are used during the authorization phase to ensure that
a user is allowed to access a resource. mod_authz_user extends the
authorization types with user and valid-user.
Since v2.4.8, expressions are supported within the user require directives.
This directive specifies a list of users that are allowed to gain access.
Require user john paul george ringo
When this directive is specified, any successfully authenticated user will be allowed to gain access.
Require valid-user
Apache HTTP Server Version 2.4
| Description: | Support for request buffering |
|---|---|
| Status: | Extension |
| Module Identifier: | buffer_module |
| Source File: | mod_buffer.c |
| Compatibility: | Available in Apache 2.3 and later |
This module provides the ability to buffer the input and output filter stacks.
Under certain circumstances, content generators might create content in small chunks. In order to promote memory reuse, in memory chunks are always 8k in size, regardless of the size of the chunk itself. When many small chunks are generated by a request, this can create a large memory footprint while the request is being processed, and an unnecessarily large amount of data on the wire. The addition of a buffer collapses the response into the fewest chunks possible.
When httpd is used in front of an expensive content generator, buffering the response may allow the backend to complete processing and release resources sooner, depending on how the backend is designed.
The buffer filter may be added to either the input or the
output filter stacks, as appropriate, using the
SetInputFilter,
SetOutputFilter,
AddOutputFilter or
AddOutputFilterByType directives.
AddOutputFilterByType INCLUDES;BUFFER text/html
| Description: | Maximum size in bytes to buffer by the buffer filter |
|---|---|
| Syntax: | BufferSize integer |
| Default: | BufferSize 131072 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_buffer |
The BufferSize
directive specifies the amount of data in bytes that will be
buffered before being read from or written to each request.
The default is 128 kilobytes.
Apache HTTP Server Version 2.4
| Description: | Shared object cache (socache) based storage module for the HTTP caching filter. |
|---|---|
| Status: | Extension |
| Module Identifier: | cache_socache_module |
| Source File: | mod_cache_socache.c |
mod_cache_socache implements a shared object cache
(socache) based storage manager for mod_cache.
The headers and bodies of cached responses are combined, and stored underneath a single key in the shared object cache. A number of implementations of shared object caches are available to choose from.
Multiple content negotiated responses can be stored concurrently, however the caching of partial content is not yet supported by this module.
# Turn on caching
CacheSocache shmcb
CacheSocacheMaxSize 102400
<Location "/foo">
CacheEnable socache
</Location>
# Fall back to the disk cache
CacheSocache shmcb
CacheSocacheMaxSize 102400
<Location "/foo">
CacheEnable socache
CacheEnable disk
</Location>
mod_cache_socache requires the services of
mod_cache, which must be loaded before
mod_cache_socache.
CacheSocache CacheSocacheMaxSize CacheSocacheMaxTime CacheSocacheMinTime CacheSocacheReadSize CacheSocacheReadTime| Description: | The shared object cache implementation to use |
|---|---|
| Syntax: | CacheSocache type[:args] |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache_socache |
| Compatibility: | Available in Apache 2.4.5 and later |
The CacheSocache directive defines the name of
the shared object cache implementation to use, followed by optional
arguments for that implementation. A number of
implementations of shared object caches are available to choose
from.
CacheSocache shmcb
| Description: | The maximum size (in bytes) of an entry to be placed in the cache |
|---|---|
| Syntax: | CacheSocacheMaxSize bytes |
| Default: | CacheSocacheMaxSize 102400 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache_socache |
| Compatibility: | Available in Apache 2.4.5 and later |
The CacheSocacheMaxSize directive sets the
maximum size, in bytes, for the combined headers and body of a document
to be considered for storage in the cache. The larger the headers that
are stored alongside the body, the smaller the body may be.
The mod_cache_socache module will only attempt to
cache responses that have an explicit content length, or that are small
enough to be written in one pass. This is done to allow the
mod_cache_disk module to have an opportunity to cache
responses larger than those cacheable within
mod_cache_socache.
CacheSocacheMaxSize 102400
| Description: | The maximum time (in seconds) for a document to be placed in the cache |
|---|---|
| Syntax: | CacheSocacheMaxTime seconds |
| Default: | CacheSocacheMaxTime 86400 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache_socache |
| Compatibility: | Available in Apache 2.4.5 and later |
The CacheSocacheMaxTime directive sets the
maximum freshness lifetime, in seconds, for a document to be stored in
the cache. This value overrides the freshness lifetime defined for the
document by the HTTP protocol.
CacheSocacheMaxTime 86400
| Description: | The minimum time (in seconds) for a document to be placed in the cache |
|---|---|
| Syntax: | CacheSocacheMinTime seconds |
| Default: | CacheSocacheMinTime 600 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache_socache |
| Compatibility: | Available in Apache 2.4.5 and later |
The CacheSocacheMinTime directive sets the
amount of seconds beyond the freshness lifetime of the response that the
response should be cached for in the shared object cache. If a response is
only stored for its freshness lifetime, there will be no opportunity to
revalidate the response to make it fresh again.
CacheSocacheMinTime 600
| Description: | The minimum size (in bytes) of the document to read and be cached before sending the data downstream |
|---|---|
| Syntax: | CacheSocacheReadSize bytes |
| Default: | CacheSocacheReadSize 0 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache_socache |
| Compatibility: | Available in Apache 2.4.5 and later |
The CacheSocacheReadSize directive sets the
minimum amount of data, in bytes, to be read from the backend before the
data is sent to the client. The default of zero causes all data read of
any size to be passed downstream to the client immediately as it arrives.
Setting this to a higher value causes the disk cache to buffer at least
this amount before sending the result to the client. This can improve
performance when caching content from a slow reverse proxy.
This directive only takes effect when the data is being saved to the cache, as opposed to data being served from the cache.
CacheSocacheReadSize 102400
| Description: | The minimum time (in milliseconds) that should elapse while reading before data is sent downstream |
|---|---|
| Syntax: | CacheSocacheReadTime milliseconds |
| Default: | CacheSocacheReadTime 0 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache_socache |
| Compatibility: | Available in Apache 2.4.5 and later |
The CacheSocacheReadTime directive sets the minimum amount
of elapsed time that should pass before making an attempt to send data
downstream to the client. During the time period, data will be buffered
before sending the result to the client. This can improve performance when
caching content from a reverse proxy.
The default of zero disables this option.
This directive only takes effect when the data is being saved to the
cache, as opposed to data being served from the cache. It is recommended
that this option be used alongside the
CacheSocacheReadSize directive
to ensure that the server does not buffer excessively should data arrive faster
than expected.
CacheSocacheReadTime 1000
Apache HTTP Server Version 2.4
| Description: | Allows an LDAP directory to be used to store the database for HTTP Basic authentication. |
|---|---|
| Status: | Extension |
| Module Identifier: | authnz_ldap_module |
| Source File: | mod_authnz_ldap.c |
| Compatibility: | Available in version 2.1 and later |
This module allows authentication front-ends such as
mod_auth_basic to authenticate users through
an ldap directory.
mod_authnz_ldap supports the following features:
When using mod_auth_basic, this module is invoked
via the AuthBasicProvider
directive with the ldap value.
Contents General caveats Operation The Require Directives Examples Using TLS Using SSL Exposing Login Information Using Active Directory Using Microsoft
FrontPage with mod_authnz_ldap AuthLDAPAuthorizePrefix AuthLDAPBindAuthoritative AuthLDAPBindDN AuthLDAPBindPassword AuthLDAPCharsetConfig AuthLDAPCompareAsUser AuthLDAPCompareDNOnServer AuthLDAPDereferenceAliases AuthLDAPGroupAttribute AuthLDAPGroupAttributeIsDN AuthLDAPInitialBindAsUser AuthLDAPInitialBindPattern AuthLDAPMaxSubGroupDepth AuthLDAPRemoteUserAttribute AuthLDAPRemoteUserIsDN AuthLDAPSearchAsUser AuthLDAPSubGroupAttribute AuthLDAPSubGroupClass AuthLDAPURL This module caches authentication and authorization results based
on the configuration of mod_ldap. Changes
made to the backing LDAP server will not be immediately reflected on the
HTTP Server, including but not limited to user lockouts/revocations,
password changes, or changes to group memberships. Consult the directives
in mod_ldap for details of the cache tunables.
There are two phases in granting access to a user. The first
phase is authentication, in which the mod_authnz_ldap
authentication provider verifies that the user's credentials are valid.
This is also called the search/bind phase. The second phase is
authorization, in which mod_authnz_ldap determines
if the authenticated user is allowed access to the resource in
question. This is also known as the compare
phase.
mod_authnz_ldap registers both an authn_ldap authentication
provider and an authz_ldap authorization handler. The authn_ldap
authentication provider can be enabled through the
AuthBasicProvider directive
using the ldap value. The authz_ldap handler extends the
Require directive's authorization types
by adding ldap-user, ldap-dn and ldap-group
values.
During the authentication phase, mod_authnz_ldap
searches for an entry in the directory that matches the username
that the HTTP client passes. If a single unique match is found,
then mod_authnz_ldap attempts to bind to the
directory server using the DN of the entry plus the password
provided by the HTTP client. Because it does a search, then a
bind, it is often referred to as the search/bind phase. Here are
the steps taken during the search/bind phase.
AuthLDAPURL directive with
the username passed by the HTTP client.The following directives are used during the search/bind phase
AuthLDAPURL |
Specifies the LDAP server, the base DN, the attribute to use in the search, as well as the extra search filter to use. |
AuthLDAPBindDN |
An optional DN to bind with during the search phase. |
AuthLDAPBindPassword |
An optional password to bind with during the search phase. |
During the authorization phase, mod_authnz_ldap
attempts to determine if the user is authorized to access the
resource. Many of these checks require
mod_authnz_ldap to do a compare operation on the
LDAP server. This is why this phase is often referred to as the
compare phase. mod_authnz_ldap accepts the
following Require
directives to determine if the credentials are acceptable:
Require ldap-user directive, and the
username in the directive matches the username passed by the
client.Require
ldap-dn directive, and the DN in the directive matches
the DN fetched from the LDAP directory.Require ldap-group directive, and
the DN fetched from the LDAP directory (or the username
passed by the client) occurs in the LDAP group or, potentially, in
one of its sub-groups.Require ldap-attribute
directive, and the attribute fetched from the LDAP directory
matches the given value.Require ldap-filter
directive, and the search filter successfully finds a single user
object that matches the dn of the authenticated user.Require ldap-search
directive, and the search filter successfully returns a single
matching object with any distinguished name.Other Require values may also
be used which may require loading additional authorization modules.
Require valid-user
directive. (requires mod_authz_user)Require group directive, and
mod_authz_groupfile has been loaded with the
AuthGroupFile
directive set.mod_authnz_ldap uses the following directives during the
compare phase:
AuthLDAPURL |
The attribute specified in the
URL is used in compare operations for the Require
ldap-user operation. |
AuthLDAPCompareDNOnServer |
Determines the behavior of the
Require ldap-dn directive. |
AuthLDAPGroupAttribute |
Determines the attribute to
use for comparisons in the Require ldap-group
directive. |
AuthLDAPGroupAttributeIsDN |
Specifies whether to use the
user DN or the username when doing comparisons for the
Require ldap-group directive. |
AuthLDAPMaxSubGroupDepth |
Determines the maximum depth of sub-groups that will be evaluated
during comparisons in the Require ldap-group directive. |
AuthLDAPSubGroupAttribute |
Determines the attribute to use when obtaining sub-group members
of the current group during comparisons in the Require ldap-group
directive. |
AuthLDAPSubGroupClass |
Specifies the LDAP objectClass values used to identify if queried directory
objects really are group objects (as opposed to user objects) during the
Require ldap-group directive's sub-group processing. |
Apache's Require
directives are used during the authorization phase to ensure that
a user is allowed to access a resource. mod_authnz_ldap extends the
authorization types with ldap-user, ldap-dn,
ldap-group, ldap-attribute and
ldap-filter. Other authorization types may also be
used but may require that additional authorization modules be loaded.
Since v2.4.8, expressions are supported within the LDAP require directives.
The Require ldap-user directive specifies what
usernames can access the resource. Once
mod_authnz_ldap has retrieved a unique DN from the
directory, it does an LDAP compare operation using the username
specified in the Require ldap-user to see if that username
is part of the just-fetched LDAP entry. Multiple users can be
granted access by putting multiple usernames on the line,
separated with spaces. If a username has a space in it, then it
must be surrounded with double quotes. Multiple users can also be
granted access by using multiple Require ldap-user
directives, with one user per line. For example, with a AuthLDAPURL of
ldap://ldap/o=Example?cn (i.e., cn is
used for searches), the following Require directives could be used
to restrict access:
Require ldap-user "Barbara Jenson" Require ldap-user "Fred User" Require ldap-user "Joe Manager"
Because of the way that mod_authnz_ldap handles this
directive, Barbara Jenson could sign on as Barbara
Jenson, Babs Jenson or any other cn that
she has in her LDAP entry. Only the single Require
ldap-user line is needed to support all values of the attribute
in the user's entry.
If the uid attribute was used instead of the
cn attribute in the URL above, the above three lines
could be condensed to
Require ldap-user bjenson fuser jmanager
This directive specifies an LDAP group whose members are allowed access. It takes the distinguished name of the LDAP group. Note: Do not surround the group name with quotes. For example, assume that the following entry existed in the LDAP directory:
dn: cn=Administrators, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Barbara Jenson, o=Example uniqueMember: cn=Fred User, o=Example
The following directive would grant access to both Fred and Barbara:
Require ldap-group cn=Administrators, o=Example
Members can also be found within sub-groups of a specified LDAP group
if AuthLDAPMaxSubGroupDepth
is set to a value greater than 0. For example, assume the following entries
exist in the LDAP directory:
dn: cn=Employees, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Managers, o=Example uniqueMember: cn=Administrators, o=Example uniqueMember: cn=Users, o=Example dn: cn=Managers, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Bob Ellis, o=Example uniqueMember: cn=Tom Jackson, o=Example dn: cn=Administrators, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Barbara Jenson, o=Example uniqueMember: cn=Fred User, o=Example dn: cn=Users, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Allan Jefferson, o=Example uniqueMember: cn=Paul Tilley, o=Example uniqueMember: cn=Temporary Employees, o=Example dn: cn=Temporary Employees, o=Example objectClass: groupOfUniqueNames uniqueMember: cn=Jim Swenson, o=Example uniqueMember: cn=Elliot Rhodes, o=Example
The following directives would allow access for Bob Ellis, Tom Jackson, Barbara Jenson, Fred User, Allan Jefferson, and Paul Tilley but would not allow access for Jim Swenson, or Elliot Rhodes (since they are at a sub-group depth of 2):
Require ldap-group cn=Employees, o=Example AuthLDAPMaxSubGroupDepth 1
Behavior of this directive is modified by the AuthLDAPGroupAttribute, AuthLDAPGroupAttributeIsDN, AuthLDAPMaxSubGroupDepth, AuthLDAPSubGroupAttribute, and AuthLDAPSubGroupClass
directives.
The Require ldap-dn directive allows the administrator
to grant access based on distinguished names. It specifies a DN
that must match for access to be granted. If the distinguished
name that was retrieved from the directory server matches the
distinguished name in the Require ldap-dn, then
authorization is granted. Note: do not surround the distinguished
name with quotes.
The following directive would grant access to a specific DN:
Require ldap-dn cn=Barbara Jenson, o=Example
Behavior of this directive is modified by the AuthLDAPCompareDNOnServer
directive.
The Require ldap-attribute directive allows the
administrator to grant access based on attributes of the authenticated
user in the LDAP directory. If the attribute in the directory
matches the value given in the configuration, access is granted.
The following directive would grant access to anyone with the attribute employeeType = active
Require ldap-attribute employeeType="active"
Multiple attribute/value pairs can be specified on the same line
separated by spaces or they can be specified in multiple
Require ldap-attribute directives. The effect of listing
multiple attribute/values pairs is an OR operation. Access will be
granted if any of the listed attribute values match the value of the
corresponding attribute in the user object. If the value of the
attribute contains a space, only the value must be within double quotes.
The following directive would grant access to anyone with the city attribute equal to "San Jose" or status equal to "Active"
Require ldap-attribute city="San Jose" status="active"
The Require ldap-filter directive allows the
administrator to grant access based on a complex LDAP search filter.
If the dn returned by the filter search matches the authenticated user
dn, access is granted.
The following directive would grant access to anyone having a cell phone and is in the marketing department
Require ldap-filter "&(cell=*)(department=marketing)"
The difference between the Require ldap-filter directive and the
Require ldap-attribute directive is that ldap-filter
performs a search operation on the LDAP directory using the specified search
filter rather than a simple attribute comparison. If a simple attribute
comparison is all that is required, the comparison operation performed by
ldap-attribute will be faster than the search operation
used by ldap-filter especially within a large directory.
When using an expression within the filter, care must be taken to ensure that LDAP filters are escaped correctly to guard against LDAP injection. The ldap function can be used for this purpose.
<LocationMatch ^/dav/(?<SITENAME>[^/]+)/>
Require ldap-filter (memberOf=cn=%{ldap:%{unescape:%{env:MATCH_SITENAME}},ou=Websites,o=Example)
</LocationMatch>
The Require ldap-search directive allows the
administrator to grant access based on a generic LDAP search filter using an
expression. If there is exactly one match to the search filter,
regardless of the distinguished name, access is granted.
The following directive would grant access to URLs that match the given objects in the LDAP server:
<LocationMatch ^/dav/(?<SITENAME>[^/]+)/>
Require ldap-search (cn=%{ldap:%{unescape:%{env:MATCH_SITENAME}} Website)
</LocationMatch>
Note: care must be taken to ensure that any expressions are properly escaped to guard against LDAP injection. The ldap function can be used as per the example above.
AuthLDAPURL "ldap://ldap1.example.com:389/ou=People, o=Example?uid?sub?(objectClass=*)" Require valid-user
AuthLDAPURL "ldap://ldap1.example.com ldap2.example.com/ou=People, o=Example" Require valid-user
cn, because a search on cn
must return exactly one entry. That's why
this approach is not recommended: it's a better idea to
choose an attribute that is guaranteed unique in your
directory, such as uid.
AuthLDAPURL "ldap://ldap.example.com/ou=People, o=Example?cn" Require valid-user
AuthLDAPURL ldap://ldap.example.com/o=Example?uid Require ldap-group cn=Administrators, o=Example
AuthLDAPURL ldap://ldap.example.com/o=Example?uid
Require ldap-group cn=%{SERVER_NAME}, o=Example
qpagePagerID. The example will grant access
only to people (authenticated via their UID) who have
alphanumeric pagers:
AuthLDAPURL ldap://ldap.example.com/o=Example?uid??(qpagePagerID=*) Require valid-user
The next example demonstrates the power of using filters to accomplish complicated administrative requirements. Without filters, it would have been necessary to create a new LDAP group and ensure that the group's members remain synchronized with the pager users. This becomes trivial with filters. The goal is to grant access to anyone who has a pager, plus grant access to Joe Manager, who doesn't have a pager, but does need to access the same resource:
AuthLDAPURL ldap://ldap.example.com/o=Example?uid??(|(qpagePagerID=*)(uid=jmanager)) Require valid-user
This last may look confusing at first, so it helps to
evaluate what the search filter will look like based on who
connects, as shown below. If
Fred User connects as fuser, the filter would look
like
(&(|(qpagePagerID=*)(uid=jmanager))(uid=fuser))
The above search will only succeed if fuser has a pager. When Joe Manager connects as jmanager, the filter looks like
(&(|(qpagePagerID=*)(uid=jmanager))(uid=jmanager))
The above search will succeed whether jmanager has a pager or not.
To use TLS, see the mod_ldap directives LDAPTrustedClientCert, LDAPTrustedGlobalCert and LDAPTrustedMode.
An optional second parameter can be added to the
AuthLDAPURL to override
the default connection type set by LDAPTrustedMode.
This will allow the connection established by an ldap:// Url
to be upgraded to a secure connection on the same port.
To use SSL, see the mod_ldap directives LDAPTrustedClientCert, LDAPTrustedGlobalCert and LDAPTrustedMode.
To specify a secure LDAP server, use ldaps:// in the
AuthLDAPURL
directive, instead of ldap://.
when this module performs authentication, ldap attributes specified
in the AuthLDAPURL
directive are placed in environment variables with the prefix "AUTHENTICATE_".
when this module performs authorization, ldap attributes specified
in the AuthLDAPURL
directive are placed in environment variables with the prefix "AUTHORIZE_".
If the attribute field contains the username, common name and telephone number of a user, a CGI program will have access to this information without the need to make a second independent LDAP query to gather this additional information.
This has the potential to dramatically simplify the coding and configuration required in some web applications.
An Active Directory installation may support multiple domains at the same time. To distinguish users between domains, an identifier called a User Principle Name (UPN) can be added to a user's entry in the directory. This UPN usually takes the form of the user's account name, followed by the domain components of the particular domain, for example somebody@nz.example.com.
You may wish to configure the mod_authnz_ldap
module to authenticate users present in any of the domains making up
the Active Directory forest. In this way both
somebody@nz.example.com and someone@au.example.com
can be authenticated using the same query at the same time.
To make this practical, Active Directory supports the concept of a Global Catalog. This Global Catalog is a read only copy of selected attributes of all the Active Directory servers within the Active Directory forest. Querying the Global Catalog allows all the domains to be queried in a single query, without the query spanning servers over potentially slow links.
If enabled, the Global Catalog is an independent directory server that runs on port 3268 (3269 for SSL). To search for a user, do a subtree search for the attribute userPrincipalName, with an empty search root, like so:
AuthLDAPBindDN apache@example.com AuthLDAPBindPassword password AuthLDAPURL ldap://10.0.0.1:3268/?userPrincipalName?sub
Users will need to enter their User Principal Name as a login, in the form somebody@nz.example.com.
Normally, FrontPage uses FrontPage-web-specific user/group
files (i.e., the mod_authn_file and
mod_authz_groupfile modules) to handle all
authentication. Unfortunately, it is not possible to just
change to LDAP authentication by adding the proper directives,
because it will break the Permissions forms in
the FrontPage client, which attempt to modify the standard
text-based authorization files.
Once a FrontPage web has been created, adding LDAP
authentication to it is a matter of adding the following
directives to every .htaccess file
that gets created in the web
AuthLDAPURL "the url" AuthGroupFile "mygroupfile" Require group "mygroupfile"
FrontPage restricts access to a web by adding the Require
valid-user directive to the .htaccess
files. The Require valid-user directive will succeed for
any user who is valid as far as LDAP is
concerned. This means that anybody who has an entry in
the LDAP directory is considered a valid user, whereas FrontPage
considers only those people in the local user file to be
valid. By substituting the ldap-group with group file authorization,
Apache is allowed to consult the local user file (which is managed by
FrontPage) - instead of LDAP - when handling authorizing the user.
Once directives have been added as specified above, FrontPage users will be able to perform all management operations from the FrontPage client.
mod_authn_file user file.
The user ID is ideal for this.mod_auth_basic,
mod_authn_file and
mod_authz_groupfile in order to
use FrontPage support. This is because Apache will still use
the mod_authz_groupfile group file for determine
the extent of a user's access to the FrontPage web..htaccess
files. Attempting to put them inside <Location> or <Directory> directives won't work. This
is because mod_authnz_ldap has to be able to grab
the AuthGroupFile
directive that is found in FrontPage .htaccess
files so that it knows where to look for the valid user list. If
the mod_authnz_ldap directives aren't in the same
.htaccess file as the FrontPage directives, then
the hack won't work, because mod_authnz_ldap will
never get a chance to process the .htaccess file,
and won't be able to find the FrontPage-managed user file.| Description: | Specifies the prefix for environment variables set during authorization |
|---|---|
| Syntax: | AuthLDAPAuthorizePrefix prefix |
| Default: | AuthLDAPAuthorizePrefix AUTHORIZE_ |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
| Compatibility: | Available in version 2.3.6 and later |
This directive allows you to override the prefix used for environment variables set during LDAP authorization. If AUTHENTICATE_ is specified, consumers of these environment variables see the same information whether LDAP has performed authentication, authorization, or both.
Require valid-user.
| Description: | Determines if other authentication providers are used when a user can be mapped to a DN but the server cannot successfully bind with the user's credentials. |
|---|---|
| Syntax: | AuthLDAPBindAuthoritative off|on |
| Default: | AuthLDAPBindAuthoritative on |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
By default, subsequent authentication providers are only queried if a
user cannot be mapped to a DN, but not if the user can be mapped to a DN and their
password cannot be verified with an LDAP bind.
If AuthLDAPBindAuthoritative
is set to off, other configured authentication modules will have
a chance to validate the user if the LDAP bind (with the current user's credentials)
fails for any reason.
This allows users present in both LDAP and
AuthUserFile to authenticate
when the LDAP server is available but the user's account is locked or password
is otherwise unusable.
| Description: | Optional DN to use in binding to the LDAP server |
|---|---|
| Syntax: | AuthLDAPBindDN distinguished-name |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
An optional DN used to bind to the server when searching for
entries. If not provided, mod_authnz_ldap will use
an anonymous bind.
| Description: | Password used in conjunction with the bind DN |
|---|---|
| Syntax: | AuthLDAPBindPassword password |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
| Compatibility: | exec: was added in 2.4.5. |
A bind password to use in conjunction with the bind DN. Note
that the bind password is probably sensitive data, and should be
properly protected. You should only use the AuthLDAPBindDN and AuthLDAPBindPassword if you
absolutely need them to search the directory.
If the value begins with exec: the resulting command will be executed and the first line returned to standard output by the program will be used as the password.
#Password used as-is AuthLDAPBindPassword secret #Run /path/to/program to get my password AuthLDAPBindPassword exec:/path/to/program #Run /path/to/otherProgram and provide arguments AuthLDAPBindPassword "exec:/path/to/otherProgram argument1"
| Description: | Language to charset conversion configuration file |
|---|---|
| Syntax: | AuthLDAPCharsetConfig file-path |
| Context: | server config |
| Status: | Extension |
| Module: | mod_authnz_ldap |
The AuthLDAPCharsetConfig directive sets the location
of the language to charset conversion configuration file. File-path is relative
to the ServerRoot. This file specifies
the list of language extensions to character sets.
Most administrators use the provided charset.conv
file, which associates common language extensions to character sets.
The file contains lines in the following format:
Language-Extension charset [Language-String] ...
The case of the extension does not matter. Blank lines, and lines
beginning with a hash character (#) are ignored.
| Description: | Use the authenticated user's credentials to perform authorization comparisons |
|---|---|
| Syntax: | AuthLDAPCompareAsUser on|off |
| Default: | AuthLDAPCompareAsUser off |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
| Compatibility: | Available in version 2.3.6 and later |
When set, and mod_authnz_ldap has authenticated the
user, LDAP comparisons for authorization use the queried distinguished name (DN)
and HTTP basic authentication password of the authenticated user instead of
the servers configured credentials.
The ldap-attribute, ldap-user, and ldap-group (single-level only) authorization checks use comparisons.
This directive only has effect on the comparisons performed during
nested group processing when
AuthLDAPSearchAsUser is also enabled.
This directive should only be used when your LDAP server doesn't
accept anonymous comparisons and you cannot use a dedicated
AuthLDAPBindDN.
| Description: | Use the LDAP server to compare the DNs |
|---|---|
| Syntax: | AuthLDAPCompareDNOnServer on|off |
| Default: | AuthLDAPCompareDNOnServer on |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
When set, mod_authnz_ldap will use the LDAP
server to compare the DNs. This is the only foolproof way to
compare DNs. mod_authnz_ldap will search the
directory for the DN specified with the Require dn directive, then,
retrieve the DN and compare it with the DN retrieved from the user
entry. If this directive is not set,
mod_authnz_ldap simply does a string comparison. It
is possible to get false negatives with this approach, but it is
much faster. Note the mod_ldap cache can speed up
DN comparison in most situations.
| Description: | When will the module de-reference aliases |
|---|---|
| Syntax: | AuthLDAPDereferenceAliases never|searching|finding|always |
| Default: | AuthLDAPDereferenceAliases always |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
This directive specifies when mod_authnz_ldap will
de-reference aliases during LDAP operations. The default is
always.
| Description: | LDAP attributes used to identify the user members of groups. |
|---|---|
| Syntax: | AuthLDAPGroupAttribute attribute |
| Default: | AuthLDAPGroupAttribute member uniqueMember |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
This directive specifies which LDAP attributes are used to
check for user members within groups. Multiple attributes can be used
by specifying this directive multiple times. If not specified,
then mod_authnz_ldap uses the member and
uniqueMember attributes.
| Description: | Use the DN of the client username when checking for group membership |
|---|---|
| Syntax: | AuthLDAPGroupAttributeIsDN on|off |
| Default: | AuthLDAPGroupAttributeIsDN on |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
When set on, this directive says to use the
distinguished name of the client username when checking for group
membership. Otherwise, the username will be used. For example,
assume that the client sent the username bjenson,
which corresponds to the LDAP DN cn=Babs Jenson,
o=Example. If this directive is set,
mod_authnz_ldap will check if the group has
cn=Babs Jenson, o=Example as a member. If this
directive is not set, then mod_authnz_ldap will
check if the group has bjenson as a member.
| Description: | Determines if the server does the initial DN lookup using the basic authentication users' own username, instead of anonymously or with hard-coded credentials for the server |
|---|---|
| Syntax: | AuthLDAPInitialBindAsUser off|on |
| Default: | AuthLDAPInitialBindAsUser off |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
| Compatibility: | Available in version 2.3.6 and later |
By default, the server either anonymously, or with a dedicated user and password, converts the basic authentication username into an LDAP distinguished name (DN). This directive forces the server to use the verbatim username and password provided by the incoming user to perform the initial DN search.
If the verbatim username can't directly bind, but needs some
cosmetic transformation, see
AuthLDAPInitialBindPattern.
This directive should only be used when your LDAP server doesn't
accept anonymous searches and you cannot use a dedicated
AuthLDAPBindDN.
| Description: | Specifies the transformation of the basic authentication username to be used when binding to the LDAP server to perform a DN lookup |
|---|---|
| Syntax: | AuthLDAPInitialBindPattern regex substitution |
| Default: | AuthLDAPInitialBindPattern (.*) $1 (remote username used verbatim) |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
| Compatibility: | Available in version 2.3.6 and later |
If AuthLDAPInitialBindAsUser is set to
ON, the basic authentication username will be transformed according to the
regular expression and substitution arguments.
The regular expression argument is compared against the current basic authentication username. The substitution argument may contain backreferences, but has no other variable interpolation.
This directive should only be used when your LDAP server doesn't
accept anonymous searches and you cannot use a dedicated
AuthLDAPBindDN.
AuthLDAPInitialBindPattern (.+) $1@example.com
AuthLDAPInitialBindPattern (.+) cn=$1,dc=example,dc=com
| Description: | Specifies the maximum sub-group nesting depth that will be evaluated before the user search is discontinued. |
|---|---|
| Syntax: | AuthLDAPMaxSubGroupDepth Number |
| Default: | AuthLDAPMaxSubGroupDepth 10 |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
| Compatibility: | Available in version 2.3.0 and later |
When this directive is set to a non-zero value X
combined with use of the Require ldap-group someGroupDN
directive, the provided user credentials will be searched for
as a member of the someGroupDN directory object or of
any group member of the current group up to the maximum nesting
level X specified by this directive.
See the Require ldap-group
section for a more detailed example.
When AuthLDAPSubGroupAttribute overlaps with
AuthLDAPGroupAttribute (as it does by default and
as required by common LDAP schemas), uncached searching for subgroups in
large groups can be very slow. If you use large, non-nested groups, set
AuthLDAPMaxSubGroupDepth to zero.
| Description: | Use the value of the attribute returned during the user query to set the REMOTE_USER environment variable |
|---|---|
| Syntax: | AuthLDAPRemoteUserAttribute uid |
| Default: | none |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
If this directive is set, the value of the
REMOTE_USER environment variable will be set to the
value of the attribute specified. Make sure that this attribute is
included in the list of attributes in the AuthLDAPURL definition,
otherwise this directive will have no effect. This directive, if
present, takes precedence over AuthLDAPRemoteUserIsDN. This
directive is useful should you want people to log into a website
using an email address, but a backend application expects the
username as a userid.
| Description: | Use the DN of the client username to set the REMOTE_USER environment variable |
|---|---|
| Syntax: | AuthLDAPRemoteUserIsDN on|off |
| Default: | AuthLDAPRemoteUserIsDN off |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
If this directive is set to on, the value of the
REMOTE_USER environment variable will be set to the full
distinguished name of the authenticated user, rather than just
the username that was passed by the client. It is turned off by
default.
| Description: | Use the authenticated user's credentials to perform authorization searches |
|---|---|
| Syntax: | AuthLDAPSearchAsUser on|off |
| Default: | AuthLDAPSearchAsUser off |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
| Compatibility: | Available in version 2.3.6 and later |
When set, and mod_authnz_ldap has authenticated the
user, LDAP searches for authorization use the queried distinguished name (DN)
and HTTP basic authentication password of the authenticated user instead of
the servers configured credentials.
The ldap-filter and ldap-dn authorization checks use searches.
This directive only has effect on the comparisons performed during
nested group processing when
AuthLDAPCompareAsUser is also enabled.
This directive should only be used when your LDAP server doesn't
accept anonymous searches and you cannot use a dedicated
AuthLDAPBindDN.
| Description: | Specifies the attribute labels, one value per directive line, used to distinguish the members of the current group that are groups. |
|---|---|
| Syntax: | AuthLDAPSubGroupAttribute attribute |
| Default: | AuthLDAPSubGroupAttribute member uniqueMember |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
| Compatibility: | Available in version 2.3.0 and later |
An LDAP group object may contain members that are users and
members that are groups (called nested or sub groups). The
AuthLDAPSubGroupAttribute directive identifies the
labels of group members and the AuthLDAPGroupAttribute
directive identifies the labels of the user members. Multiple
attributes can be used by specifying this directive multiple times.
If not specified, then mod_authnz_ldap uses the
member and uniqueMember attributes.
| Description: | Specifies which LDAP objectClass values identify directory objects that are groups during sub-group processing. |
|---|---|
| Syntax: | AuthLDAPSubGroupClass LdapObjectClass |
| Default: | AuthLDAPSubGroupClass groupOfNames groupOfUniqueNames |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
| Compatibility: | Available in version 2.3.0 and later |
An LDAP group object may contain members that are users and
members that are groups (called nested or sub groups). The
AuthLDAPSubGroupAttribute
directive identifies the
labels of members that may be sub-groups of the current group
(as opposed to user members). The AuthLDAPSubGroupClass
directive specifies the LDAP objectClass values used in verifying that
these potential sub-groups are in fact group objects. Verified sub-groups
can then be searched for more user or sub-group members. Multiple
attributes can be used by specifying this directive multiple times.
If not specified, then mod_authnz_ldap uses the
groupOfNames and groupOfUniqueNames values.
| Description: | URL specifying the LDAP search parameters |
|---|---|
| Syntax: | AuthLDAPURL url [NONE|SSL|TLS|STARTTLS] |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authnz_ldap |
An RFC 2255 URL which specifies the LDAP search parameters to use. The syntax of the URL is
ldap://host:port/basedn?attribute?scope?filter
If you want to specify more than one LDAP URL that Apache should try in turn, the syntax is:
AuthLDAPURL "ldap://ldap1.example.com ldap2.example.com/dc=..."
Caveat: If you specify multiple servers, you need to enclose the entire URL string in quotes; otherwise you will get an error: "AuthLDAPURL takes one argument, URL to define LDAP connection.." You can of course use search parameters on each of these.
ldap. For secure LDAP, use ldaps
instead. Secure LDAP is only available if Apache was linked
to an LDAP library with SSL support.The name/port of the ldap server (defaults to
localhost:389 for ldap, and
localhost:636 for ldaps). To
specify multiple, redundant LDAP servers, just list all
servers, separated by spaces. mod_authnz_ldap
will try connecting to each server in turn, until it makes a
successful connection. If multiple ldap servers are specified,
then entire LDAP URL must be encapsulated in double quotes.
Once a connection has been made to a server, that
connection remains active for the life of the
httpd process, or until the LDAP server goes
down.
If the LDAP server goes down and breaks an existing
connection, mod_authnz_ldap will attempt to
re-connect, starting with the primary server, and trying
each redundant server in turn. Note that this is different
than a true round-robin search.
uid. It's a good
idea to choose an attribute that will be unique across all
entries in the subtree you will be using. All attributes
listed will be put into the environment with an AUTHENTICATE_ prefix
for use by other modules.one or
sub. Note that a scope of base is
also supported by RFC 2255, but is not supported by this
module. If the scope is not provided, or if base scope
is specified, the default is to use a scope of
sub.(objectClass=*), which
will search for all objects in the tree. Filters are
limited to approximately 8000 characters (the definition of
MAX_STRING_LEN in the Apache source code). This
should be more than sufficient for any application. In 2.4.10 and later,
the keyword none disables the use of a filter; this is
required by some primitive LDAP servers.When doing searches, the attribute, filter and username passed
by the HTTP client are combined to create a search filter that
looks like
(&(filter)(attribute=username)).
For example, consider an URL of
ldap://ldap.example.com/o=Example?cn?sub?(posixid=*). When
a client attempts to connect using a username of Babs
Jenson, the resulting search filter will be
(&(posixid=*)(cn=Babs Jenson)).
An optional parameter can be added to allow the LDAP Url to override the connection type. This parameter can be one of the following:
ldap:// on port 389.ldaps://See above for examples of AuthLDAPURL URLs.
Apache HTTP Server Version 2.4
| Description: | Group authorization using DBM files |
|---|---|
| Status: | Extension |
| Module Identifier: | authz_dbm_module |
| Source File: | mod_authz_dbm.c |
| Compatibility: | Available in Apache 2.1 and later |
This module provides authorization capabilities so that
authenticated users can be allowed or denied access to portions
of the web site by group membership. Similar functionality is
provided by mod_authz_groupfile.
Apache's Require
directives are used during the authorization phase to ensure that
a user is allowed to access a resource. mod_authz_dbm extends the
authorization types with dbm-group.
Since v2.4.8, expressions are supported within the DBM require directives.
This directive specifies group membership that is required for the user to gain access.
Require dbm-group admin
When this directive is specified, the user must be a member of the group assigned to the file being accessed.
Require dbm-file-group
Note that using mod_authz_dbm requires you to require dbm-group
instead of group:
<Directory "/foo/bar"> AuthType Basic AuthName "Secure Area" AuthBasicProvider dbm AuthDBMUserFile "site/data/users" AuthDBMGroupFile "site/data/users" Require dbm-group admin </Directory>
| Description: | Sets the name of the database file containing the list of user groups for authorization |
|---|---|
| Syntax: | AuthDBMGroupFile file-path |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authz_dbm |
The AuthDBMGroupFile directive sets the
name of a DBM file containing the list of user groups for user
authorization. File-path is the absolute path to the
group file.
The group file is keyed on the username. The value for a user is a comma-separated list of the groups to which the users belongs. There must be no whitespace within the value, and it must never contain any colons.
Make sure that the AuthDBMGroupFile is
stored outside the document tree of the web-server. Do
not put it in the directory that it protects.
Otherwise, clients will be able to download the
AuthDBMGroupFile unless otherwise
protected.
Combining Group and Password DBM files: In some cases it is easier to manage a single database which contains both the password and group details for each user. This simplifies any support programs that need to be written: they now only have to deal with writing to and locking a single DBM file. This can be accomplished by first setting the group and password files to point to the same DBM:
AuthDBMGroupFile "/www/userbase" AuthDBMUserFile "/www/userbase"
The key for the single DBM is the username. The value consists of
Encrypted Password : List of Groups [ : (ignored) ]
The password section contains the encrypted password as before. This is followed by a colon and the comma separated list of groups. Other data may optionally be left in the DBM file after another colon; it is ignored by the authorization module. This is what www.telescope.org uses for its combined password and group database.
| Description: | Sets the type of database file that is used to store list of user groups |
|---|---|
| Syntax: | AuthzDBMType default|SDBM|GDBM|NDBM|DB |
| Default: | AuthzDBMType default |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authz_dbm |
Sets the type of database file that is used to store the list of user groups. The default database type is determined at compile time. The availability of other types of database files also depends on compile-time settings.
It is crucial that whatever program you use to create your group files is configured to use the same type of database.
Apache HTTP Server Version 2.4
| Description: | Authorization based on file ownership |
|---|---|
| Status: | Extension |
| Module Identifier: | authz_owner_module |
| Source File: | mod_authz_owner.c |
| Compatibility: | Available in Apache 2.1 and later |
This module authorizes access to files by comparing the userid used
for HTTP authentication (the web userid) with the file-system owner or
group of the requested file. The supplied username and password
must be already properly verified by an authentication module,
such as mod_auth_basic or
mod_auth_digest. mod_authz_owner
recognizes two arguments for the Require directive, file-owner and
file-group, as follows:
file-ownerjones, then the
username used to access it through the web must be jones
as well.file-groupmod_authz_groupfile or mod_authz_dbm,
and the web-username must be a member of that group. For example, if
the operating system says the requested file is owned by (system)
group accounts, the group accounts must
appear in the group database and the web-username used in the request
must be a member of that group.If mod_authz_owner is used in order to authorize
a resource that is not actually present in the filesystem
(i.e. a virtual resource), it will deny the access.
Particularly it will never authorize content negotiated "MultiViews" resources.
This module provides no directives.
Consider a multi-user system running the Apache Web server, with
each user having his or her own files in ~/public_html/private. Assuming that there is a single
AuthDBMUserFile database
that lists all of their web-usernames, and that these usernames match
the system's usernames that actually own the files on the server, then
the following stanza would allow only the user himself access to his
own files. User jones would not be allowed to access
files in /home/smith/public_html/private unless they
were owned by jones instead of smith.
<Directory "/home/*/public_html/private">
AuthType Basic
AuthName MyPrivateFiles
AuthBasicProvider dbm
AuthDBMUserFile "/usr/local/apache2/etc/.htdbm-all"
Require file-owner
</Directory>
Consider a system similar to the one described above, but with
some users that share their project files in
~/public_html/project-foo. The files are owned by the
system group foo and there is a single AuthDBMGroupFile database that
contains all of the web-usernames and their group membership,
i.e. they must be at least member of a group named
foo. So if jones and smith
are both member of the group foo, then both will be
authorized to access the project-foo directories of
each other.
<Directory "/home/*/public_html/project-foo">
AuthType Basic
AuthName "Project Foo Files"
AuthBasicProvider dbm
# combined user/group database
AuthDBMUserFile "/usr/local/apache2/etc/.htdbm-all"
AuthDBMGroupFile "/usr/local/apache2/etc/.htdbm-all"
Satisfy All
Require file-group
</Directory>
Apache HTTP Server Version 2.4
| Description: | Compress content via Brotli before it is delivered to the client |
|---|---|
| Status: | Extension |
| Module Identifier: | brotli_module |
| Source File: | mod_brotli.c |
| Compatibility: | Available in version 2.4.26 and later. |
The mod_brotli module provides
the BROTLI_COMPRESS output filter that allows output from
your server to be compressed using the brotli compression format before being sent to the client over
the network. This module uses the Brotli library found at
https://github.com/google/brotli.
Sample Configurations Enabling Compression Dealing with proxy servers Serving pre-compressed
content BrotliAlterETag BrotliCompressionMaxInputBlock BrotliCompressionQuality BrotliCompressionWindow BrotliFilterNoteSome web applications are vulnerable to an information disclosure attack when a TLS connection carries compressed data. For more information, review the details of the "BREACH" family of attacks.
This is a simple configuration that compresses common text-based content types.
AddOutputFilterByType BROTLI_COMPRESS text/html text/plain text/xml text/css text/javascript application/javascript
Some web applications are vulnerable to an information disclosure attack when a TLS connection carries compressed data. For more information, review the details of the "BREACH" family of attacks.
Compression is implemented by the BROTLI_COMPRESS
filter. The following directive
will enable compression for documents in the container where it
is placed:
SetOutputFilter BROTLI_COMPRESS SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-brotli
If you want to restrict the compression to particular MIME types
in general, you may use the AddOutputFilterByType directive. Here is an example of
enabling compression only for the html files of the Apache
documentation:
<Directory "/your-server-root/manual">
AddOutputFilterByType BROTLI_COMPRESS text/html
</Directory>
BROTLI_COMPRESS filter is always inserted after RESOURCE
filters like PHP or SSI. It never touches internal subrequests.
no-brotli,
set via SetEnv, which
will disable brotli compression for a particular request, even if
it is supported by the client.
The mod_brotli module sends a Vary:
Accept-Encoding HTTP response header to alert proxies that
a cached response should be sent only to clients that send the
appropriate Accept-Encoding request header. This
prevents compressed content from being sent to a client that will
not understand it.
If you use some special exclusions dependent
on, for example, the User-Agent header, you must
manually configure an addition to the Vary header
to alert proxies of the additional restrictions. For example,
in a typical configuration where the addition of the BROTLI_COMPRESS
filter depends on the User-Agent, you should add:
Header append Vary User-Agent
If your decision about compression depends on other information
than request headers (e.g. HTTP version), you have to set the
Vary header to the value *. This prevents
compliant proxies from caching entirely.
Header set Vary *
Since mod_brotli re-compresses content each
time a request is made, some performance benefit can be derived by
pre-compressing the content and telling mod_brotli to serve them
without re-compressing them. This may be accomplished using a
configuration like the following:
<IfModule mod_headers.c>
# Serve brotli compressed CSS files if they exist
# and the client accepts brotli.
RewriteCond "%{HTTP:Accept-encoding}" "br"
RewriteCond "%{REQUEST_FILENAME}\.br" "-s"
RewriteRule "^(.*)\.css" "$1\.css\.br" [QSA]
# Serve brotli compressed JS files if they exist
# and the client accepts brotli.
RewriteCond "%{HTTP:Accept-encoding}" "br"
RewriteCond "%{REQUEST_FILENAME}\.br" "-s"
RewriteRule "^(.*)\.js" "$1\.js\.br" [QSA]
# Serve correct content types, and prevent double compression.
RewriteRule "\.css\.br$" "-" [T=text/css,E=no-brotli:1]
RewriteRule "\.js\.br$" "-" [T=text/javascript,E=no-brotli:1]
<FilesMatch "(\.js\.br|\.css\.br)$">
# Serve correct encoding type.
Header append Content-Encoding br
# Force proxies to cache brotli &
# non-brotli css/js files separately.
Header append Vary Accept-Encoding
</FilesMatch>
</IfModule>
| Description: | How the outgoing ETag header should be modified during compression |
|---|---|
| Syntax: | BrotliAlterETag AddSuffix|NoChange|Remove |
| Default: | BrotliAlterETag AddSuffix |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_brotli |
The BrotliAlterETag directive specifies
how the ETag hader should be altered when a response is compressed.
Append the compression method onto the end of the ETag, causing compressed and uncompressed representations to have unique ETags. In another dynamic compression module, mod_deflate, this has been the default since 2.4.0. This setting prevents serving "HTTP Not Modified" (304) responses to conditional requests for compressed content.
Don't change the ETag on a compressed response. In another dynamic compression module, mod_deflate, this has been the default prior to 2.4.0. This setting does not satisfy the HTTP/1.1 property that all representations of the same resource have unique ETags.
Remove the ETag header from compressed responses. This prevents some conditional requests from being possible, but avoids the shortcomings of the preceding options.
| Description: | Maximum input block size |
|---|---|
| Syntax: | BrotliCompressionMaxInputBlock value |
| Default: | (automatic) |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_brotli |
The BrotliCompressionMaxInputBlock directive specifies
the maximum input block size between 16 and 24, with the caveat that
larger block sizes require more memory.
| Description: | Compression quality |
|---|---|
| Syntax: | BrotliCompressionQuality value |
| Default: | BrotliCompressionQuality 5 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_brotli |
The BrotliCompressionQuality directive specifies
the compression quality (a value between 0 and 11). Higher quality values
result in better, but also slower compression.
| Description: | Brotli sliding compression window size |
|---|---|
| Syntax: | BrotliCompressionWindow value |
| Default: | BrotliCompressionWindow 18 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_brotli |
The BrotliCompressionWindow directive specifies the
brotli sliding compression window size (a value between 10 and 24). Larger
window sizes can improve compression quality, but require more memory.
| Description: | Places the compression ratio in a note for logging |
|---|---|
| Syntax: | BrotliFilterNote [type] notename |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_brotli |
The BrotliFilterNote directive
specifies that a note about compression ratios should be attached
to the request. The name of the note is the value specified for
the directive. You can use that note for statistical purposes by
adding the value to your access log.
BrotliFilterNote ratio
LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' brotli
CustomLog "logs/brotli_log" brotli
If you want to extract more accurate values from your logs, you can use the type argument to specify the type of data left as a note for logging. type can be one of:
InputOutputRatiooutput/input * 100)
in the note. This is the default, if the type argument
is omitted.Thus you may log it this way:
BrotliFilterNote Input instream
BrotliFilterNote Output outstream
BrotliFilterNote Ratio ratio
LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' brotli
CustomLog "logs/brotli_log" brotli
Apache HTTP Server Version 2.4
| Description: | Disk based storage module for the HTTP caching filter. |
|---|---|
| Status: | Extension |
| Module Identifier: | cache_disk_module |
| Source File: | mod_cache_disk.c |
mod_cache_disk implements a disk based storage
manager for mod_cache.
The headers and bodies of cached responses are stored separately on disk, in a directory structure derived from the md5 hash of the cached URL.
Multiple content negotiated responses can be stored concurrently, however the caching of partial content is not yet supported by this module.
Atomic cache updates to both header and body files are achieved without the need for locking by storing the device and inode numbers of the body file within the header file. This has the side effect that cache entries manually moved into the cache will be ignored.
The htcacheclean tool is provided to list cached
URLs, remove cached URLs, or to maintain the size of the disk cache
within size and/or inode limits. The tool can be run on demand, or
can be daemonized to offer continuous monitoring of directory sizes.
mod_cache_disk requires the services of
mod_cache, which must be
loaded before mod_cache_disk.
mod_cache_disk uses the sendfile feature to
serve files from the cache when supported by the platform, and
when enabled with EnableSendfile.
However, per-directory and .htaccess configuration of
EnableSendfile are ignored by
mod_cache_disk as the corresponding settings are not
available to the module when a request is being served from the
cache.
CacheDirLength CacheDirLevels CacheMaxFileSize CacheMinFileSize CacheReadSize CacheReadTime CacheRoot| Description: | The number of characters in subdirectory names |
|---|---|
| Syntax: | CacheDirLength length |
| Default: | CacheDirLength 2 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache_disk |
The CacheDirLength directive sets the number
of characters for each subdirectory name in the cache hierarchy. It can
be used in conjunction with CacheDirLevels to
determine the approximate structure of your cache hierarchy.
A high value for CacheDirLength combined
with a low value for CacheDirLevels will result in
a relatively flat hierarchy, with a large number of subdirectories at each
level.
The result of CacheDirLevels* CacheDirLength
must not be higher than 20.
| Description: | The number of levels of subdirectories in the cache. |
|---|---|
| Syntax: | CacheDirLevels levels |
| Default: | CacheDirLevels 2 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache_disk |
The CacheDirLevels directive sets the number
of subdirectory levels in the cache. Cached data will be saved this
many directory levels below the CacheRoot directory.
A high value for CacheDirLevels combined
with a low value for CacheDirLength will result in
a relatively deep hierarchy, with a small number of subdirectories at each
level.
The result of CacheDirLevels*
CacheDirLength must
not be higher than 20.
| Description: | The maximum size (in bytes) of a document to be placed in the cache |
|---|---|
| Syntax: | CacheMaxFileSize bytes |
| Default: | CacheMaxFileSize 1000000 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache_disk |
The CacheMaxFileSize directive sets the
maximum size, in bytes, for a document to be considered for storage in
the cache.
CacheMaxFileSize 64000
| Description: | The minimum size (in bytes) of a document to be placed in the cache |
|---|---|
| Syntax: | CacheMinFileSize bytes |
| Default: | CacheMinFileSize 1 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache_disk |
The CacheMinFileSize directive sets the
minimum size, in bytes, for a document to be considered for storage
in the cache.
CacheMinFileSize 64
| Description: | The minimum size (in bytes) of the document to read and be cached before sending the data downstream |
|---|---|
| Syntax: | CacheReadSize bytes |
| Default: | CacheReadSize 0 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache_disk |
The CacheReadSize directive sets the
minimum amount of data, in bytes, to be read from the backend before the
data is sent to the client. The default of zero causes all data read of
any size to be passed downstream to the client immediately as it arrives.
Setting this to a higher value causes the disk cache to buffer at least
this amount before sending the result to the client. This can improve
performance when caching content from a reverse proxy.
This directive only takes effect when the data is being saved to the cache, as opposed to data being served from the cache.
CacheReadSize 102400
| Description: | The minimum time (in milliseconds) that should elapse while reading before data is sent downstream |
|---|---|
| Syntax: | CacheReadTime milliseconds |
| Default: | CacheReadTime 0 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache_disk |
The CacheReadTime directive sets the minimum amount
of elapsed time that should pass before making an attempt to send data
downstream to the client. During the time period, data will be buffered
before sending the result to the client. This can improve performance when
caching content from a reverse proxy.
The default of zero disables this option.
This directive only takes effect when the data is being saved to the
cache, as opposed to data being served from the cache. It is recommended
that this option be used alongside the
CacheReadSize directive to
ensure that the server does not buffer excessively should data arrive faster
than expected.
CacheReadTime 1000
| Description: | The directory root under which cache files are stored |
|---|---|
| Syntax: | CacheRoot directory |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache_disk |
The CacheRoot directive defines the name of
the directory on the disk to contain cache files. If the mod_cache_disk module has been loaded or compiled in to the
Apache server, this directive must be defined. Failing to
provide a value for CacheRoot will result in
a configuration file processing error. The CacheDirLevels and CacheDirLength directives define
the structure of the directories under the specified root directory.
CacheRoot c:/cacheroot
Apache HTTP Server Version 2.4
| Description: | Execution of CGI scripts |
|---|---|
| Status: | Base |
| Module Identifier: | cgi_module |
| Source File: | mod_cgi.c |
Any file that has the handler
cgi-script will be treated
as a CGI script, and run by the server, with its output being
returned to the client. Files acquire this handler either by
having a name containing an extension defined by the
AddHandler directive, or by being
in a ScriptAlias
directory.
For an introduction to using CGI scripts with Apache, see our tutorial on Dynamic Content With CGI.
When using a multi-threaded MPM under unix, the module
mod_cgid should be used in place of
this module. At the user level, the two modules are essentially
identical.
For backward-compatibility, the cgi-script handler will also be activated
for any file with the mime-type application/x-httpd-cgi. The
use of the magic mime-type is deprecated.
The server will set the CGI environment variables as described in the CGI specification, with the following provisions:
AcceptPathInfo directive is explicitly set to
off. The default behavior, if AcceptPathInfo is not given, is that mod_cgi will accept path info (trailing
/more/path/info following the script filename in the URI),
while the core server will return a 404 NOT FOUND error for requests
with additional path info. Omitting the AcceptPathInfo directive has the same effect as setting
it On for mod_cgi requests.HostnameLookups is set to on (it
is off by default), and if a reverse DNS lookup of the accessing
host's address indeed finds a host name.IdentityCheck is set to
on and the accessing host supports the ident
protocol. Note that the contents of this variable cannot be
relied upon because it can easily be faked, and if there is a
proxy between the client and the server, it is usually
totally useless.This module also leverages the core functions ap_add_common_vars and ap_add_cgi_vars to add environment variables like:
DocumentRoot directive.ServerAdmin directive.For an exhaustive list it is suggested to write a basic CGI script that dumps all the environment variables passed by Apache in a convenient format.
Debugging CGI scripts has traditionally been difficult, mainly because it has not been possible to study the output (standard output and error) for scripts which are failing to run properly. These directives provide more detailed logging of errors when they occur.
When configured, the CGI error log logs any CGI which does not execute properly. Each CGI script which fails to operate causes several lines of information to be logged. The first two lines are always of the format:
%% [time] request-line
%% HTTP-status CGI-script-filename
If the error is that CGI script cannot be run, the log file will contain an extra two lines:
%%error
error-message
Alternatively, if the error is the result of the script returning incorrect header information (often due to a bug in the script), the following information is logged:
%request
All HTTP request headers received
POST or PUT entity (if any)
%response
All headers output by the CGI script
%stdout
CGI standard output
%stderr
CGI standard error
(The %stdout and %stderr parts may be missing if the script did not output anything on standard output or standard error).
| Description: | The length of time to wait for more output from the CGI program |
|---|---|
| Syntax: | CGIScriptTimeout time[s|ms] |
| Default: | value of |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Base |
| Module: | mod_cgi |
| Compatibility: | Available in version 2.4.59 and later. |
This directive limits the length of time to wait for more output from the CGI program. If the time is exceeded, the request and CGI are terminated.
CGIScriptTimeout 20
| Description: | Location of the CGI script error logfile |
|---|---|
| Syntax: | ScriptLog file-path |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_cgi, mod_cgid |
The ScriptLog directive sets the CGI
script error logfile. If no ScriptLog is given,
no error log is created. If given, any CGI errors are logged into the
filename given as argument. If this is a relative file or path it is
taken relative to the ServerRoot.
ScriptLog logs/cgi_log
This log will be opened as the user the child processes run
as, i.e. the user specified in the main User directive. This means that
either the directory the script log is in needs to be writable
by that user or the file needs to be manually created and set
to be writable by that user. If you place the script log in
your main logs directory, do NOT change the
directory permissions to make it writable by the user the child
processes run as.
Note that script logging is meant to be a debugging feature when writing CGI scripts, and is not meant to be activated continuously on running servers. It is not optimized for speed or efficiency, and may have security problems if used in a manner other than that for which it was designed.
| Description: | Maximum amount of PUT or POST requests that will be recorded in the scriptlog |
|---|---|
| Syntax: | ScriptLogBuffer bytes |
| Default: | ScriptLogBuffer 1024 |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_cgi, mod_cgid |
The size of any PUT or POST entity body that is logged to the file is limited, to prevent the log file growing too big too quickly if large bodies are being received. By default, up to 1024 bytes are logged, but this can be changed with this directive.
| Description: | Size limit of the CGI script logfile |
|---|---|
| Syntax: | ScriptLogLength bytes |
| Default: | ScriptLogLength 10385760 |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_cgi, mod_cgid |
ScriptLogLength can be used to limit the
size of the CGI script logfile. Since the logfile logs a lot of
information per CGI error (all request headers, all script output)
it can grow to be a big file. To prevent problems due to unbounded
growth, this directive can be used to set an maximum file-size for
the CGI logfile. If the file exceeds this size, no more
information will be written to it.
Apache HTTP Server Version 2.4
| Description: | Convert response body into an RFC2397 data URL |
|---|---|
| Status: | Extension |
| Module Identifier: | data_module |
| Source File: | mod_data.c |
| Compatibility: | Available in Apache 2.3 and later |
This module provides the ability to convert a response into an RFC2397 data URL.
Data URLs can be embedded inline within web pages using something
like the mod_include module, to remove the need for
clients to make separate connections to fetch what may potentially be
many small images. Data URLs may also be included into pages generated
by scripting languages such as PHP.
data:image/gif;base64,R0lGODdhMAAwAPAAAAAAAP///ywAAAAAMAAw
AAAC8IyPqcvt3wCcDkiLc7C0qwyGHhSWpjQu5yqmCYsapyuvUUlvONmOZtfzgFz
ByTB10QgxOR0TqBQejhRNzOfkVJ+5YiUqrXF5Y5lKh/DeuNcP5yLWGsEbtLiOSp
a/TPg7JpJHxyendzWTBfX0cxOnKPjgBzi4diinWGdkF8kjdfnycQZXZeYGejmJl
ZeGl9i2icVqaNVailT6F5iJ90m6mvuTS4OK05M0vDk0Q4XUtwvKOzrcd3iq9uis
F81M1OIcR7lEewwcLp7tuNNkM3uNna3F2JQFo97Vriy/Xl4/f1cf5VWzXyym7PH
hhx4dbgYKAAA7
The filter takes no parameters, and can be added to the filter stack
using the SetOutputFilter directive,
or any of the directives supported by the mod_filter
module.
<Location "/data/images">
SetOutputFilter DATA
</Location>
This module provides no directives.
Apache HTTP Server Version 2.4
| Description: | Generic locking module for mod_dav |
|---|---|
| Status: | Extension |
| Module Identifier: | dav_lock_module |
| Source File: | mod_dav_lock.c |
| Compatibility: | Available in version 2.1 and later |
This module implements a generic locking API which can be used by any
backend provider of mod_dav. It requires at least
the service of mod_dav. But without a backend provider
which makes use of it, it's useless and should not be loaded into the
server. A sample backend module which actually utilizes
mod_dav_lock is mod_dav_svn, the subversion provider module.
Note that mod_dav_fs does not need this
generic locking module, because it uses its own more specialized
version.
In order to make mod_dav_lock functional, you just have
to specify the location of the lock database using the DavGenericLockDB directive described
below.
In order to retrieve the pointer to the locking provider function, you
have to use the ap_lookup_provider API with the arguments
dav-lock, generic, and 0.
| Description: | Location of the DAV lock database |
|---|---|
| Syntax: | DavGenericLockDB file-path |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_dav_lock |
Use the DavGenericLockDB directive to specify
the full path to the lock database, excluding an extension. If
the path is not absolute, it will be interpreted relative to ServerRoot. The implementation of
mod_dav_lock uses a SDBM database to track user
locks.
DavGenericLockDB var/DavLock
The directory containing the lock database file must be
writable by the User
and Group under which
Apache is running. For security reasons, you should create a
directory for this purpose rather than changing the permissions on
an existing directory. In the above example, Apache will create
files in the var/ directory under the ServerRoot with the base filename
DavLock and an extension added by the server.
Apache HTTP Server Version 2.4
| Description: | Send static content at a bandwidth rate limit, defined by the various old modem standards |
|---|---|
| Status: | Experimental |
| Module Identifier: | dialup_module |
| Source File: | mod_dialup.c |
It is a module that sends static content at a bandwidth rate limit, defined by the various old modem standards. So, you can browse your site with a 56k V.92 modem, by adding something like this:
<Location "/mysite">
ModemStandard "V.92"
</Location>
Previously to do bandwidth rate limiting modules would have to block an entire thread, for each client, and insert sleeps to slow the bandwidth down. Using the new suspend feature, a handler can get callback N milliseconds in the future, and it will be invoked by the Event MPM on a different thread, once the timer hits. From there the handler can continue to send data to the client.
| Description: | Modem standard to simulate |
|---|---|
| Syntax: | ModemStandard V.21|V.26bis|V.32|V.34|V.92 |
| Context: | directory |
| Status: | Experimental |
| Module: | mod_dialup |
Specify what modem standard you wish to simulate.
<Location "/mysite">
ModemStandard "V.26bis"
</Location>
Apache HTTP Server Version 2.4
| Description: | RFC 2616 compliant HTTP caching filter. |
|---|---|
| Status: | Extension |
| Module Identifier: | cache_module |
| Source File: | mod_cache.c |
CacheQuickHandler directive is
in its default value of on, the Allow and Deny directives will be circumvented.
You should not enable quick handler caching for any content to which you
wish to limit access by client host name, address or environment
variable.mod_cache implements an RFC 2616 compliant
HTTP content caching filter, with support for the caching
of content negotiated responses containing the Vary header.
RFC 2616 compliant caching provides a mechanism to verify whether stale or expired content is still fresh, and can represent a significant performance boost when the origin server supports conditional requests by honouring the If-None-Match HTTP request header. Content is only regenerated from scratch when the content has changed, and not when the cached entry expires.
As a filter, mod_cache can be placed in front of
content originating from any handler, including flat
files (served from a slow disk cached on a fast disk), the output
of a CGI script or dynamic content
generator, or content proxied from another
server.
In the default configuration, mod_cache inserts the
caching filter as far forward as possible within the filter stack,
utilising the quick handler to bypass all per request
processing when returning content to the client. In this mode of
operation, mod_cache may be thought of as a caching
proxy server bolted to the front of the webserver, while running within
the webserver itself.
When the quick handler is switched off using the
CacheQuickHandler directive,
it becomes possible to insert the CACHE filter at a
point in the filter stack chosen by the administrator. This provides the
opportunity to cache content before that content is personalised by the
mod_include filter, or optionally compressed by the
mod_deflate filter.
Under normal operation, mod_cache will respond to
and can be controlled by the
Cache-Control
and
Pragma
headers sent from a client in a request, or from a
server within a response. Under exceptional circumstances,
mod_cache can be configured to override these headers
and force site specific behaviour, however such behaviour will be limited
to this cache only, and will not affect the operation of other caches
that may exist between the client and server, and as a result is not
recommended unless strictly necessary.
RFC 2616 allows for the cache to return stale data while the existing
stale entry is refreshed from the origin server, and this is supported
by mod_cache when the
CacheLock directive is suitably
configured. Such responses will contain a
Warning
HTTP header with a 110 response code. RFC 2616 also allows a cache to return
stale data when the attempt made to refresh the stale data returns an
error 500 or above, and this behaviour is supported by default by
mod_cache. Such responses will contain a
Warning
HTTP header with a 111 response code.
mod_cache requires the services of one or more
storage management modules. The following storage management modules are included in
the base Apache distribution:
mod_cache_diskhtcacheclean tool is
provided to list cached URLs, remove cached URLs, or to maintain the size
of the disk cache within size and inode limits.mod_cache_socacheFurther details, discussion, and examples, are provided in the Caching Guide.
Related Modules and Directives Sample Configuration Avoiding the Thundering Herd Fine Control with the CACHE Filter Cache Status and Logging CacheDefaultExpire CacheDetailHeader CacheDisable CacheEnable CacheHeader CacheIgnoreCacheControl CacheIgnoreHeaders CacheIgnoreNoLastMod CacheIgnoreQueryString CacheIgnoreURLSessionIdentifiers CacheKeyBaseURL CacheLastModifiedFactor CacheLock CacheLockMaxAge CacheLockPath CacheMaxExpire CacheMinExpire CacheQuickHandler CacheStaleOnError CacheStoreExpired CacheStoreNoStore CacheStorePrivate| Related Modules | Related Directives |
|---|---|
#
# Sample Cache Configuration
#
LoadModule cache_module modules/mod_cache.so
<IfModule mod_cache.c>
LoadModule cache_disk_module modules/mod_cache_disk.so
<IfModule mod_cache_disk.c>
CacheRoot "c:/cacheroot"
CacheEnable disk "/"
CacheDirLevels 5
CacheDirLength 3
</IfModule>
# When acting as a proxy, don't cache the list of security updates
CacheDisable "http://security.update.server/update-list/"
</IfModule>
When a cached entry becomes stale, mod_cache will submit
a conditional request to the backend, which is expected to confirm whether the
cached entry is still fresh, and send an updated entity if not.
A small but finite amount of time exists between the time the cached entity becomes stale, and the time the stale entity is fully refreshed. On a busy server, a significant number of requests might arrive during this time, and cause a thundering herd of requests to strike the backend suddenly and unpredictably.
To keep the thundering herd at bay, the CacheLock
directive can be used to define a directory in which locks are created for
URLs in flight. The lock is used as a hint
by other requests to either suppress an attempt to cache (someone else has
gone to fetch the entity), or to indicate that a stale entry is being refreshed
(stale content will be returned in the mean time).
When an entity is cached for the first time, a lock will be created for the entity until the response has been fully cached. During the lifetime of the lock, the cache will suppress the second and subsequent attempt to cache the same entity. While this doesn't hold back the thundering herd, it does stop the cache attempting to cache the same entity multiple times simultaneously.
When an entity reaches its freshness lifetime and becomes stale, a lock will be created for the entity until the response has either been confirmed as still fresh, or replaced by the backend. During the lifetime of the lock, the second and subsequent incoming request will cause stale data to be returned, and the thundering herd is kept at bay.
Locks are used as a hint only to enable the cache to be more gentle on backend servers, however the lock can be overridden if necessary. If the client sends a request with a Cache-Control header forcing a reload, any lock that may be present will be ignored, and the client's request will be honored immediately and the cached entry refreshed.
As a further safety mechanism, locks have a configurable maximum age.
Once this age has been reached, the lock is removed, and a new request is
given the opportunity to create a new lock. This maximum age can be set using
the CacheLockMaxAge directive, and defaults
to 5 seconds.
#
# Enable the cache lock
#
<IfModule mod_cache.c>
CacheLock on
CacheLockPath "/tmp/mod_cache-lock"
CacheLockMaxAge 5
</IfModule>
Under the default mode of cache operation, the cache runs as a quick handler, short circuiting the majority of server processing and offering the highest cache performance available.
In this mode, the cache bolts onto the front of the server, acting as if a free standing RFC 2616 caching proxy had been placed in front of the server.
While this mode offers the best performance, the administrator may find that under certain circumstances they may want to perform further processing on the request after the request is cached, such as to inject personalisation into the cached page, or to apply authorization restrictions to the content. Under these circumstances, an administrator is often forced to place independent reverse proxy servers either behind or in front of the caching server to achieve this.
To solve this problem the CacheQuickHandler
directive can be set to off, and the server will
process all phases normally handled by a non-cached request, including the
authentication and authorization phases.
In addition, the administrator may optionally specify the precise point within the filter chain where caching is to take place by adding the CACHE filter to the output filter chain.
For example, to cache content before applying compression to the response, place the CACHE filter before the DEFLATE filter as in the example below:
# Cache content before optional compression CacheQuickHandler off AddOutputFilterByType CACHE;DEFLATE text/plain
Another option is to have content cached before personalisation is applied
by mod_include (or another content processing filter). In this
example templates containing tags understood by
mod_include are cached before being parsed:
# Cache content before mod_include and mod_deflate CacheQuickHandler off AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html
You may place the CACHE filter anywhere you wish within the
filter chain. In this example, content is cached after being parsed by
mod_include, but before being processed by
mod_deflate:
# Cache content between mod_include and mod_deflate CacheQuickHandler off AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html
mod_cache is not in a position
to enforce this for you.Once mod_cache has made a decision as to whether or not
an entity is to be served from cache, the detailed reason for the decision
is written to the subprocess environment within the request under the
cache-status key. This reason can be logged by the
LogFormat directive as
follows:
LogFormat "%{cache-status}e ..."
Based on the caching decision made, the reason is also written to the subprocess environment under one the following four keys, as appropriate:
This makes it possible to support conditional logging of cached requests as per the following example:
CustomLog "cached-requests.log" common env=cache-hit CustomLog "uncached-requests.log" common env=cache-miss CustomLog "revalidated-requests.log" common env=cache-revalidate CustomLog "invalidated-requests.log" common env=cache-invalidate
For module authors, a hook called cache_status is available, allowing modules to respond to the caching outcomes above in customised ways.
| Description: | The default duration to cache a document when no expiry date is specified. |
|---|---|
| Syntax: | CacheDefaultExpire seconds |
| Default: | CacheDefaultExpire 3600 (one hour) |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
The CacheDefaultExpire directive specifies a default time,
in seconds, to cache a document if neither an expiry date nor last-modified date are provided
with the document. The value specified with the CacheMaxExpire
directive does not override this setting.
CacheDefaultExpire 86400
| Description: | Add an X-Cache-Detail header to the response. |
|---|---|
| Syntax: | CacheDetailHeader on|off |
| Default: | CacheDetailHeader off |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
| Compatibility: | Available in Apache 2.3.9 and later |
When the CacheDetailHeader directive
is switched on, an X-Cache-Detail header will be added to the response
containing the detailed reason for a particular caching decision.
It can be useful during development of cached RESTful services to have additional
information about the caching decision written to the response headers, so as to
confirm whether Cache-Control and other headers have been correctly
used by the service and client.
If the normal handler is used, this directive may appear within a
<Directory> or
<Location> directive. If the quick handler
is used, this directive must appear within a server or virtual host context, otherwise
the setting will be ignored.
# Enable the X-Cache-Detail header CacheDetailHeader on
X-Cache-Detail: "conditional cache hit: entity refreshed" from localhost
| Description: | Disable caching of specified URLs |
|---|---|
| Syntax: | CacheDisable url-string | on |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
The CacheDisable directive instructs
mod_cache to not cache urls at or below
url-string.
CacheDisable "/local_files"
If used in a <Location> directive,
the path needs to be specified below the Location, or if the word "on"
is used, caching for the whole location will be disabled.
<Location "/foo">
CacheDisable on
</Location>
The no-cache environment variable can be set to
disable caching on a finer grained set of resources in versions
2.2.12 and later.
| Description: | Enable caching of specified URLs using a specified storage manager |
|---|---|
| Syntax: | CacheEnable cache_type [url-string] |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_cache |
| Compatibility: | A url-string of '/' applied to forward proxy content in 2.2 and earlier. |
The CacheEnable directive instructs
mod_cache to cache urls at or below
url-string. The cache storage manager is specified with the
cache_type argument. The CacheEnable
directive can alternatively be placed inside either
<Location> or
<LocationMatch> sections to indicate
the content is cacheable.
cache_type disk instructs
mod_cache to use the disk based storage manager
implemented by mod_cache_disk. cache_type
socache instructs mod_cache to use the
shared object cache based storage manager implemented by
mod_cache_socache.
In the event that the URL space overlaps between different
CacheEnable directives (as in the example below),
each possible storage manager will be run until the first one that
actually processes the request. The order in which the storage managers are
run is determined by the order of the CacheEnable
directives in the configuration file. CacheEnable
directives within <Location> or
<LocationMatch> sections are processed
before globally defined CacheEnable directives.
When acting as a forward proxy server, url-string must minimally begin with a protocol for which caching should be enabled.
# Cache content (normal handler only)
CacheQuickHandler off
<Location "/foo">
CacheEnable disk
</Location>
# Cache regex (normal handler only)
CacheQuickHandler off
<LocationMatch "foo$">
CacheEnable disk
</LocationMatch>
# Cache all but forward proxy url's (normal or quick handler)
CacheEnable disk /
# Cache FTP-proxied url's (normal or quick handler)
CacheEnable disk ftp://
# Cache forward proxy content from www.example.org (normal or quick handler)
CacheEnable disk http://www.example.org/
A hostname starting with a "*" matches all hostnames with that suffix. A hostname starting with "." matches all hostnames containing the domain components that follow.
# Match www.example.org, and fooexample.org CacheEnable disk "http://*example.org/" # Match www.example.org, but not fooexample.org CacheEnable disk "http://.example.org/"
The no-cache environment variable can be set to
disable caching on a finer grained set of resources in versions
2.2.12 and later.
| Description: | Add an X-Cache header to the response. |
|---|---|
| Syntax: | CacheHeader on|off |
| Default: | CacheHeader off |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
| Compatibility: | Available in Apache 2.3.9 and later |
When the CacheHeader directive
is switched on, an X-Cache header will be added to the response
with the cache status of this response. If the normal handler is used, this
directive may appear within a <Directory>
or <Location> directive. If the quick
handler is used, this directive must appear within a server or virtual host
context, otherwise the setting will be ignored.
# Enable the X-Cache header CacheHeader on
X-Cache: HIT from localhost
| Description: | Ignore request to not serve cached content to client |
|---|---|
| Syntax: | CacheIgnoreCacheControl On|Off |
| Default: | CacheIgnoreCacheControl Off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache |
Ordinarily, requests containing a Cache-Control: no-cache or
Pragma: no-cache header value will not be served from the cache. The
CacheIgnoreCacheControl directive allows this
behavior to be overridden. CacheIgnoreCacheControl On
tells the server to attempt to serve the resource from the cache even
if the request contains no-cache header values. Resources requiring
authorization will never be cached.
CacheIgnoreCacheControl On
| Description: | Do not store the given HTTP header(s) in the cache. |
|---|---|
| Syntax: | CacheIgnoreHeaders header-string [header-string] ... |
| Default: | CacheIgnoreHeaders None |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache |
According to RFC 2616, hop-by-hop HTTP headers are not stored in
the cache. The following HTTP headers are hop-by-hop headers and thus
do not get stored in the cache in any case regardless of the
setting of CacheIgnoreHeaders:
ConnectionKeep-AliveProxy-AuthenticateProxy-AuthorizationTETrailersTransfer-EncodingUpgradeCacheIgnoreHeaders specifies additional HTTP
headers that should not to be stored in the cache. For example, it makes
sense in some cases to prevent cookies from being stored in the cache.
CacheIgnoreHeaders takes a space separated list
of HTTP headers that should not be stored in the cache. If only hop-by-hop
headers not should be stored in the cache (the RFC 2616 compliant
behaviour), CacheIgnoreHeaders can be set to
None.
CacheIgnoreHeaders Set-Cookie
CacheIgnoreHeaders None
Expires which are needed for proper cache
management are not stored due to a
CacheIgnoreHeaders setting, the behaviour of
mod_cache is undefined.
| Description: | Ignore the fact that a response has no Last Modified header. |
|---|---|
| Syntax: | CacheIgnoreNoLastMod On|Off |
| Default: | CacheIgnoreNoLastMod Off |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
Ordinarily, documents without a last-modified date are not cached.
Under some circumstances the last-modified date is removed (during
mod_include processing for example) or not provided
at all. The CacheIgnoreNoLastMod directive
provides a way to specify that documents without last-modified dates
should be considered for caching, even without a last-modified date.
If neither a last-modified date nor an expiry date are provided with
the document then the value specified by the
CacheDefaultExpire directive will be used to
generate an expiration date.
CacheIgnoreNoLastMod On
| Description: | Ignore query string when caching |
|---|---|
| Syntax: | CacheIgnoreQueryString On|Off |
| Default: | CacheIgnoreQueryString Off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache |
Ordinarily, requests with query string parameters are cached separately
for each unique query string. This is according to RFC 2616/13.9 done only
if an expiration time is specified. The
CacheIgnoreQueryString directive tells the cache to
cache requests even if no expiration time is specified, and to reply with
a cached reply even if the query string differs. From a caching point of
view the request is treated as if having no query string when this
directive is enabled.
CacheIgnoreQueryString On
| Description: | Ignore defined session identifiers encoded in the URL when caching |
|---|---|
| Syntax: | CacheIgnoreURLSessionIdentifiers identifier [identifier] ... |
| Default: | CacheIgnoreURLSessionIdentifiers None |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache |
Sometimes applications encode the session identifier into the URL like in the following Examples:
/someapplication/image.gif;jsessionid=123456789/someapplication/image.gif?PHPSESSIONID=12345678This causes cacheable resources to be stored separately for each session, which
is often not desired. CacheIgnoreURLSessionIdentifiers lets
define a list of identifiers that are removed from the key that is used to identify
an entity in the cache, such that cacheable resources are not stored separately for
each session.
CacheIgnoreURLSessionIdentifiers None clears the list of ignored
identifiers. Otherwise, each identifier is added to the list.
CacheIgnoreURLSessionIdentifiers jsessionid
CacheIgnoreURLSessionIdentifiers None
| Description: | Override the base URL of reverse proxied cache keys. |
|---|---|
| Syntax: | CacheKeyBaseURL URL |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache |
| Compatibility: | Available in Apache 2.3.9 and later |
When the CacheKeyBaseURL directive
is specified, the URL provided will be used as the base URL to calculate
the URL of the cache keys in the reverse proxy configuration. When not specified,
the scheme, hostname and port of the current virtual host is used to construct
the cache key. When a cluster of machines is present, and all cached entries
should be cached beneath the same cache key, a new base URL can be specified
with this directive.
# Override the base URL of the cache key. CacheKeyBaseURL "http://www.example.com/"
| Description: | The factor used to compute an expiry date based on the LastModified date. |
|---|---|
| Syntax: | CacheLastModifiedFactor float |
| Default: | CacheLastModifiedFactor 0.1 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
In the event that a document does not provide an expiry date but does
provide a last-modified date, an expiry date can be calculated based on
the time since the document was last modified. The
CacheLastModifiedFactor directive specifies a
factor to be used in the generation of this expiry date
according to the following formula:
expiry-period = time-since-last-modified-date * factor
expiry-date = current-date + expiry-period
For example, if the document was last modified 10 hours ago, and
factor is 0.1 then the expiry-period will be set to
10*0.1 = 1 hour. If the current time was 3:00pm then the computed
expiry-date would be 3:00pm + 1hour = 4:00pm.
If the expiry-period would be longer than that set by
CacheMaxExpire, then the latter takes
precedence.
CacheLastModifiedFactor 0.5
| Description: | Enable the thundering herd lock. |
|---|---|
| Syntax: | CacheLock on|off |
| Default: | CacheLock off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache |
| Compatibility: | Available in Apache 2.2.15 and later |
The CacheLock directive enables the thundering herd lock
for the given URL space.
In a minimal configuration the following directive is all that is needed to enable the thundering herd lock in the default system temp directory.
# Enable cache lock CacheLock on
| Description: | Set the maximum possible age of a cache lock. |
|---|---|
| Syntax: | CacheLockMaxAge integer |
| Default: | CacheLockMaxAge 5 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache |
The CacheLockMaxAge directive specifies the maximum
age of any cache lock.
A lock older than this value in seconds will be ignored, and the next incoming request will be given the opportunity to re-establish the lock. This mechanism prevents a slow client taking an excessively long time to refresh an entity.
| Description: | Set the lock path directory. |
|---|---|
| Syntax: | CacheLockPath directory |
| Default: | CacheLockPath /tmp/mod_cache-lock |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache |
The CacheLockPath directive allows you to specify the
directory in which the locks are created. By default, the system's temporary
folder is used. Locks consist of empty files that only exist for stale URLs
in flight, so is significantly less resource intensive than the traditional
disk cache.
| Description: | The maximum time in seconds to cache a document |
|---|---|
| Syntax: | CacheMaxExpire seconds |
| Default: | CacheMaxExpire 86400 (one day) |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
The CacheMaxExpire directive specifies the maximum number of
seconds for which cacheable HTTP documents will be retained without checking the origin
server. Thus, documents will be out of date at most this number of seconds. This maximum
value is enforced even if an expiry date was supplied with the document.
CacheMaxExpire 604800
| Description: | The minimum time in seconds to cache a document |
|---|---|
| Syntax: | CacheMinExpire seconds |
| Default: | CacheMinExpire 0 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
The CacheMinExpire directive specifies the minimum number of
seconds for which cacheable HTTP documents will be retained without checking the origin
server. This is only used if no valid expire time was supplied with the document.
CacheMinExpire 3600
| Description: | Run the cache from the quick handler. |
|---|---|
| Syntax: | CacheQuickHandler on|off |
| Default: | CacheQuickHandler on |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_cache |
| Compatibility: | Apache HTTP Server 2.3.3 and later |
The CacheQuickHandler directive
controls the phase in which the cache is handled.
In the default enabled configuration, the cache operates within the quick handler phase. This phase short circuits the majority of server processing, and represents the most performant mode of operation for a typical server. The cache bolts onto the front of the server, and the majority of server processing is avoided.
When disabled, the cache operates as a normal handler, and is subject to the full set of phases when handling a server request. While this mode is slower than the default, it allows the cache to be used in cases where full processing is required, such as when content is subject to authorization.
# Run cache as a normal handler CacheQuickHandler off
It is also possible, when the quick handler is disabled, for the administrator to choose the precise location within the filter chain where caching is to be performed, by adding the CACHE filter to the chain.
# Cache content before mod_include and mod_deflate CacheQuickHandler off AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html
If the CACHE filter is specified more than once, the last instance will apply.
| Description: | Serve stale content in place of 5xx responses. |
|---|---|
| Syntax: | CacheStaleOnError on|off |
| Default: | CacheStaleOnError on |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
| Compatibility: | Available in Apache 2.3.9 and later |
When the CacheStaleOnError directive
is switched on, and when stale data is available in the cache, the cache will
respond to 5xx responses from the backend by returning the stale data instead of
the 5xx response. While the Cache-Control headers sent by clients will be respected,
and the raw 5xx responses returned to the client on request, the 5xx response so
returned to the client will not invalidate the content in the cache.
# Serve stale data on error. CacheStaleOnError on
| Description: | Attempt to cache responses that the server reports as expired |
|---|---|
| Syntax: | CacheStoreExpired On|Off |
| Default: | CacheStoreExpired Off |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
Since httpd 2.2.4, responses which have already expired are not
stored in the cache. The CacheStoreExpired
directive allows this behavior to be overridden.
CacheStoreExpired On
tells the server to attempt to cache the resource if it is stale.
Subsequent requests would trigger an If-Modified-Since request of
the origin server, and the response may be fulfilled from cache
if the backend resource has not changed.
CacheStoreExpired On
| Description: | Attempt to cache requests or responses that have been marked as no-store. |
|---|---|
| Syntax: | CacheStoreNoStore On|Off |
| Default: | CacheStoreNoStore Off |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
Ordinarily, requests or responses with Cache-Control: no-store header
values will not be stored in the cache. The
CacheStoreNoStore directive allows this
behavior to be overridden. CacheStoreNoStore On
tells the server to attempt to cache the resource even if it contains
no-store header values. Resources requiring authorization will
never be cached.
CacheStoreNoStore On
| Description: | Attempt to cache responses that the server has marked as private |
|---|---|
| Syntax: | CacheStorePrivate On|Off |
| Default: | CacheStorePrivate Off |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_cache |
Ordinarily, responses with Cache-Control: private header values will not
be stored in the cache. The CacheStorePrivate
directive allows this behavior to be overridden.
CacheStorePrivate On
tells the server to attempt to cache the resource even if it contains
private header values. Resources requiring authorization will
never be cached.
CacheStorePrivate On
Apache HTTP Server Version 2.4
| Description: | CERN httpd metafile semantics |
|---|---|
| Status: | Extension |
| Module Identifier: | cern_meta_module |
| Source File: | mod_cern_meta.c |
Emulate the CERN HTTPD Meta file semantics. Meta files are HTTP headers that can be output in addition to the normal range of headers for each file accessed. They appear rather like the Apache .asis files, and are able to provide a crude way of influencing the Expires: header, as well as providing other curiosities. There are many ways to manage meta information, this one was chosen because there is already a large number of CERN users who can exploit this module.
More information on the CERN metafile semantics is available.
| Description: | Name of the directory to find CERN-style meta information files |
|---|---|
| Syntax: | MetaDir directory |
| Default: | MetaDir .web |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Extension |
| Module: | mod_cern_meta |
Specifies the name of the directory in which Apache can find
meta information files. The directory is usually a 'hidden'
subdirectory of the directory that contains the file being
accessed. Set to "." to look in the same directory
as the file:
MetaDir .
Or, to set it to a subdirectory of the directory containing the files:
MetaDir .meta
| Description: | Activates CERN meta-file processing |
|---|---|
| Syntax: | MetaFiles on|off |
| Default: | MetaFiles off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Extension |
| Module: | mod_cern_meta |
Turns on/off Meta file processing on a per-directory basis.
| Description: | File name suffix for the file containing CERN-style meta information |
|---|---|
| Syntax: | MetaSuffix suffix |
| Default: | MetaSuffix .meta |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Extension |
| Module: | mod_cern_meta |
Specifies the file name suffix for the file containing the
meta information. For example, the default values for the two
directives will cause a request to
DOCUMENT_ROOT/somedir/index.html to look in
DOCUMENT_ROOT/somedir/.web/index.html.meta and
will use its contents to generate additional MIME header
information.
MetaSuffix .meta
Apache HTTP Server Version 2.4
| Description: | Specify character set translation or recoding |
|---|---|
| Status: | Extension |
| Module Identifier: | charset_lite_module |
| Source File: | mod_charset_lite.c |
mod_charset_lite allows the server to change
the character set of responses before sending them to the client.
In an EBCDIC environment, Apache always translates HTTP protocol
content (e.g. response headers) from the code page of the Apache
process locale to ISO-8859-1, but not the body of responses. In
any environment, mod_charset_lite can be used to
specify that response bodies should be translated. For example,
if files are stored in EBCDIC, then
mod_charset_lite can translate them to
ISO-8859-1 before sending them to the client.
This module provides a small subset of configuration
mechanisms implemented by Russian Apache and its associated
mod_charset.
The character set name parameters of CharsetSourceEnc and
CharsetDefault
must be acceptable to the translation mechanism used by
APR on the system where
mod_charset_lite is deployed. These character
set names are not standardized and are usually not the same as
the corresponding values used in http headers. Currently, APR
can only use iconv(3), so you can easily test your character set
names using the iconv(1) program, as follows:
iconv -f charsetsourceenc-value -t charsetdefault-value
If the translation rules don't make sense for the content, translation can fail in various ways, including:
| Description: | Charset to translate into |
|---|---|
| Syntax: | CharsetDefault charset |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_charset_lite |
The CharsetDefault directive specifies the
charset that content in the associated container should be
translated to.
The value of the charset argument must be accepted as a valid character set name by the character set support in APR. Generally, this means that it must be supported by iconv.
<Directory "/export/home/trawick/apacheinst/htdocs/convert">
CharsetSourceEnc UTF-16BE
CharsetDefault ISO-8859-1
</Directory>
CharsetSourceEnc
and CharsetDefault disables translation. The charset
need not match the charset of the response, but it must be a valid charset on the system.
| Description: | Configures charset translation behavior |
|---|---|
| Syntax: | CharsetOptions option [option] ... |
| Default: | CharsetOptions ImplicitAdd |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_charset_lite |
The CharsetOptions directive configures certain
behaviors of mod_charset_lite. Option can
be one of
ImplicitAdd | NoImplicitAddImplicitAdd keyword specifies that
mod_charset_lite should implicitly insert its
filter when the configuration specifies that the character
set of content should be translated. If the filter chain is
explicitly configured using the AddOutputFilter directive, NoImplicitAdd
should be specified so that mod_charset_lite
doesn't add its filter.TranslateAllMimeTypes | NoTranslateAllMimeTypesmod_charset_lite will only perform
translation on a small subset of possible mimetypes. When the
TranslateAllMimeTypes keyword is specified for a given
configuration section, translation is performed without regard for
mimetype.| Description: | Source charset of files |
|---|---|
| Syntax: | CharsetSourceEnc charset |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_charset_lite |
The CharsetSourceEnc directive specifies the
source charset of files in the associated container.
The value of the charset argument must be accepted as a valid character set name by the character set support in APR. Generally, this means that it must be supported by iconv.
<Directory "/export/home/trawick/apacheinst/htdocs/convert">
CharsetSourceEnc UTF-16BE
CharsetDefault ISO-8859-1
</Directory>
The character set names in this example work with the iconv translation support in Solaris 8.
CharsetSourceEnc
and CharsetDefault disables translation. The charset
need not match the charset of the response, but it must be a valid charset on the system.
Apache HTTP Server Version 2.4
| Description: | Filesystem provider for mod_dav |
|---|---|
| Status: | Extension |
| Module Identifier: | dav_fs_module |
| Source File: | mod_dav_fs.c |
This module requires the service of mod_dav. It acts as a support module for mod_dav and provides access to resources located in the
server's file system. The formal name of this provider is
filesystem. mod_dav backend providers
will be invoked by using the Dav
directive:
Dav filesystem
Since filesystem is the default provider for
mod_dav, you may simply use the value
On instead.
| Description: | Location of the DAV lock database |
|---|---|
| Syntax: | DavLockDB file-path |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_dav_fs |
Use the DavLockDB directive to specify
the full path to the lock database, excluding an extension. If
the path is not absolute, it will be taken relative to ServerRoot. The implementation of
mod_dav_fs uses a SDBM database to track user
locks.
DavLockDB "var/DavLock"
The directory containing the lock database file must be
writable by the User
and Group under which
Apache is running. For security reasons, you should create a
directory for this purpose rather than changing the permissions on
an existing directory. In the above example, Apache will create
files in the var/ directory under the ServerRoot with the base filename
DavLock and extension name chosen by the server.
| Description: | Enable lock discovery |
|---|---|
| Syntax: | DavLockDiscovery on|off |
| Default: | DavLockDiscovery on |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_dav_fs |
| Compatibility: | Available from Apache 2.4.55 and later. |
DavLockDiscovery controls if the lock
discovery feature is enabled for PROPFIND method.
When disabled, PROPFIND always returns an empty
lockdiscovery section. This improves performance
if clients use PROPFIND a lot.
DavLockDiscovery off
Apache HTTP Server Version 2.4
| Description: | Compress content before it is delivered to the client |
|---|---|
| Status: | Extension |
| Module Identifier: | deflate_module |
| Source File: | mod_deflate.c |
The mod_deflate module provides
the DEFLATE output filter that allows output from
your server to be compressed before being sent to the client over
the network.
Supported Encodings Sample Configurations Enabling Compression Dealing with proxy servers Serving pre-compressed
content DeflateAlterETag DeflateBufferSize DeflateCompressionLevel DeflateFilterNote DeflateInflateLimitRequestBody DeflateInflateRatioBurst DeflateInflateRatioLimit DeflateMemLevel DeflateWindowSizeThe gzip encoding is the only one supported to ensure complete compatibility
with old browser implementations. The deflate encoding is not supported,
please check the zlib's documentation
for a complete explanation.
Some web applications are vulnerable to an information disclosure attack when a TLS connection carries deflate compressed data. For more information, review the details of the "BREACH" family of attacks.
This is a simple configuration that compresses common text-based content types.
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript
Some web applications are vulnerable to an information disclosure attack when a TLS connection carries deflate compressed data. For more information, review the details of the "BREACH" family of attacks.
Compression is implemented by the DEFLATE
filter. The following directive
will enable compression for documents in the container where it
is placed:
SetOutputFilter DEFLATE SetEnvIfNoCase Request_URI "\.(?:gif|jpe?g|png)$" no-gzip
If you want to restrict the compression to particular MIME types
in general, you may use the AddOutputFilterByType directive. Here is an example of
enabling compression only for the html files of the Apache
documentation:
<Directory "/your-server-root/manual">
AddOutputFilterByType DEFLATE text/html
</Directory>
DEFLATE filter is always inserted after RESOURCE
filters like PHP or SSI. It never touches internal subrequests.
force-gzip,
set via SetEnv, which
will ignore the accept-encoding setting of your browser and will
send compressed output.
The mod_deflate module also provides a filter for
inflating/uncompressing a gzip compressed response body. In order to activate
this feature you have to insert the INFLATE filter into
the output filter chain using SetOutputFilter or AddOutputFilter, for example:
<Location "/dav-area">
ProxyPass "http://example.com/"
SetOutputFilter INFLATE
</Location>
This Example will uncompress gzip'ed output from example.com, so other filters can do further processing with it.
The mod_deflate module also provides a filter for
decompressing a gzip compressed request body . In order to activate
this feature you have to insert the DEFLATE filter into
the input filter chain using SetInputFilter or AddInputFilter, for example:
<Location "/dav-area">
SetInputFilter DEFLATE
</Location>
Now if a request contains a Content-Encoding:
gzip header, the body will be automatically decompressed.
Few browsers have the ability to gzip request bodies. However,
some special applications actually do support request
compression, for instance some WebDAV clients.
If you evaluate the request body yourself, don't trust
the Content-Length header!
The Content-Length header reflects the length of the
incoming data from the client and not the byte count of
the decompressed data stream.
The mod_deflate module sends a Vary:
Accept-Encoding HTTP response header to alert proxies that
a cached response should be sent only to clients that send the
appropriate Accept-Encoding request header. This
prevents compressed content from being sent to a client that will
not understand it.
If you use some special exclusions dependent
on, for example, the User-Agent header, you must
manually configure an addition to the Vary header
to alert proxies of the additional restrictions. For example,
in a typical configuration where the addition of the DEFLATE
filter depends on the User-Agent, you should add:
Header append Vary User-Agent
If your decision about compression depends on other information
than request headers (e.g. HTTP version), you have to set the
Vary header to the value *. This prevents
compliant proxies from caching entirely.
Header set Vary *
Since mod_deflate re-compresses content each
time a request is made, some performance benefit can be derived by
pre-compressing the content and telling mod_deflate to serve them
without re-compressing them. This may be accomplished using a
configuration like the following:
<IfModule mod_headers.c>
# Serve gzip compressed CSS and JS files if they exist
# and the client accepts gzip.
RewriteCond "%{HTTP:Accept-encoding}" "gzip"
RewriteCond "%{REQUEST_FILENAME}\.gz" -s
RewriteRule "^(.*)\.(css|js)" "$1\.$2\.gz" [QSA]
# Serve correct content types, and prevent mod_deflate double gzip.
RewriteRule "\.css\.gz$" "-" [T=text/css,E=no-gzip:1]
RewriteRule "\.js\.gz$" "-" [T=text/javascript,E=no-gzip:1]
<FilesMatch "(\.js\.gz|\.css\.gz)$">
# Serve correct encoding type.
Header append Content-Encoding gzip
# Force proxies to cache gzipped &
# non-gzipped css/js files separately.
Header append Vary Accept-Encoding
</FilesMatch>
</IfModule>
| Description: | How the outgoing ETag header should be modified during compression |
|---|---|
| Syntax: | DeflateAlterETag AddSuffix|NoChange|Remove |
| Default: | DeflateAlterETag AddSuffix |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_deflate |
| Compatibility: | Available in Apache 2.4.58 and later |
The DeflateAlterETag directive specifies
how the ETag header should be altered when a response is compressed.
Append the compression method onto the end of the ETag, causing compressed and uncompressed representations to have unique ETags. This has been the default since 2.4.0, but prevents serving "HTTP Not Modified" (304) responses to conditional requests for compressed content.
Don't change the ETag on a compressed response. This was the default prior to 2.4.0, but does not satisfy the HTTP/1.1 property that all representations of the same resource have unique ETags.
Remove the ETag header from compressed responses. This prevents some conditional requests from being possible, but avoids the shortcomings of the preceding options.
| Description: | Fragment size to be compressed at one time by zlib |
|---|---|
| Syntax: | DeflateBufferSize value |
| Default: | DeflateBufferSize 8096 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_deflate |
The DeflateBufferSize directive specifies
the size in bytes of the fragments that zlib should compress at one
time. If the compressed response size is bigger than the one specified
by this directive then httpd will switch to chunked encoding
(HTTP header Transfer-Encoding set to Chunked), with the
side effect of not setting any Content-Length HTTP header. This is particularly
important when httpd works behind reverse caching proxies or when httpd is configured with
mod_cache and mod_cache_disk because
HTTP responses without any Content-Length header might not be cached.
| Description: | How much compression do we apply to the output |
|---|---|
| Syntax: | DeflateCompressionLevel value |
| Default: | Zlib's default |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_deflate |
The DeflateCompressionLevel directive specifies
what level of compression should be used, the higher the value,
the better the compression, but the more CPU time is required to
achieve this.
The value must between 1 (less compression) and 9 (more compression).
| Description: | Places the compression ratio in a note for logging |
|---|---|
| Syntax: | DeflateFilterNote [type] notename |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_deflate |
The DeflateFilterNote directive
specifies that a note about compression ratios should be attached
to the request. The name of the note is the value specified for
the directive. You can use that note for statistical purposes by
adding the value to your access log.
DeflateFilterNote ratio
LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' deflate
CustomLog "logs/deflate_log" deflate
If you want to extract more accurate values from your logs, you can use the type argument to specify the type of data left as a note for logging. type can be one of:
InputOutputRatiooutput/input * 100)
in the note. This is the default, if the type argument
is omitted.Thus you may log it this way:
DeflateFilterNote Input instream
DeflateFilterNote Output outstream
DeflateFilterNote Ratio ratio
LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
CustomLog "logs/deflate_log" deflate
| Description: | Maximum size of inflated request bodies |
|---|---|
| Syntax: | DeflateInflateLimitRequestBody value |
| Default: | None, but LimitRequestBody applies after deflation |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_deflate |
| Compatibility: | 2.4.10 and later |
The DeflateInflateLimitRequestBody directive
specifies the maximum size of an inflated request body. If it is unset,
LimitRequestBody is applied to the
inflated body.
| Description: | Maximum number of times the inflation ratio for request bodies can be crossed |
|---|---|
| Syntax: | DeflateInflateRatioBurst value |
| Default: | DeflateInflateRatioBurst 3 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_deflate |
| Compatibility: | 2.4.10 and later |
The DeflateInflateRatioBurst directive
specifies the maximum number of times the
DeflateInflateRatioLimit can
be crossed before terminating the request.
| Description: | Maximum inflation ratio for request bodies |
|---|---|
| Syntax: | DeflateInflateRatioLimit value |
| Default: | DeflateInflateRatioLimit 200 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_deflate |
| Compatibility: | 2.4.10 and later |
The DeflateInflateRatioLimit directive
specifies the maximum ratio of deflated to inflated size of an
inflated request body. This ratio is checked as the body is
streamed in, and if crossed more than
DeflateInflateRatioBurst
times, the request will be terminated.
| Description: | How much memory should be used by zlib for compression |
|---|---|
| Syntax: | DeflateMemLevel value |
| Default: | DeflateMemLevel 9 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_deflate |
The DeflateMemLevel directive specifies
how much memory should be used by zlib for compression
(a value between 1 and 9).
| Description: | Zlib compression window size |
|---|---|
| Syntax: | DeflateWindowSize value |
| Default: | DeflateWindowSize 15 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_deflate |
The DeflateWindowSize directive specifies the
zlib compression window size (a value between 1 and 15). Generally, the
higher the window size, the higher can the compression ratio be expected.
Apache HTTP Server Version 2.4
| Description: | Websockets support module for
mod_proxy |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_wstunnel_module |
| Source File: | mod_proxy_wstunnel.c |
| Compatibility: | Available in httpd 2.4.5 and later |
Since Apache HTTP Server 2.4.47, protocol Upgrade (tunneling) can be better handled by
mod_proxy_http.
See Protocol Upgrade.
This module requires the service of mod_proxy.
It provides support for the tunnelling of web
socket connections to a backend websockets server. The connection
is automatically upgraded to a websocket connection:
Upgrade: WebSocket Connection: Upgrade
Proxying requests to a websockets server like echo.websocket.org can be done using the
ProxyPass directive:
ProxyPass "/ws2/" "ws://echo.websocket.org/" ProxyPass "/wss2/" "wss://echo.websocket.org/"
Proxying both HTTP and websockets at the same time, with a specific set of URL's being
websocket-only, can be done by specifying the websockets
ProxyPass directive before the
HTTP directive:
ProxyPassMatch ^/(myApp/ws)$ ws://backend.example.com:9080/$1 ProxyPass / http://backend.example.com:9080/
Proxying both HTTP and websockets at the same time, where the websockets URL's are not
websocket-only or not known in advance can be done by using the
RewriteRule directive to
configure the websockets proxying:
ProxyPass / http://example.com:9080/
RewriteEngine on
RewriteCond %{HTTP:Upgrade} websocket [NC]
RewriteCond %{HTTP:Connection} upgrade [NC]
RewriteRule ^/?(.*) "ws://example.com:9080/$1" [P,L]
Load balancing for multiple backends can be achieved using mod_proxy_balancer.
The module can also be used to upgrade to other protocols than WebSocket, by setting
the upgrade parameter in the
ProxyPass
directive to some custom protocol name.
Special upgrade=NONE and upgrade=ANY values may be used for
testing/forcing the upgrade but they are not recommended in production for
security reasons.
NONE means that the check for the header is omitted but still the upgrade/tunneling to
WebSocket always happens.
ANY means that the upgrade/tunneling will happen using any protocol asked by the client.
| Description: | Instructs this module to let mod_proxy_http handle the request |
|---|---|
| Syntax: | ProxyWebsocketFallbackToProxyHttp On|Off |
| Default: | ProxyWebsocketFallbackToProxyHttp On |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy_wstunnel |
| Compatibility: | Available in httpd 2.4.48 and later |
Since httpd 2.4.47, mod_proxy_http can handle WebSocket
upgrading and tunneling in accordance to RFC 7230, this directive controls
whether mod_proxy_wstunnel should hand over to
mod_proxy_http to this, which is the case by default.
Setting to Off lets mod_proxy_wstunnel handle
WebSocket requests as in httpd 2.4.46 and earlier.
Apache HTTP Server Version 2.4
| Description: | A simple echo server to illustrate protocol modules |
|---|---|
| Status: | Experimental |
| Module Identifier: | echo_module |
| Source File: | mod_echo.c |
This module provides an example protocol module to illustrate the concept. It provides a simple echo server. Telnet to it and type stuff, and it will echo it.
| Description: | Turn the echo server on or off |
|---|---|
| Syntax: | ProtocolEcho On|Off |
| Default: | ProtocolEcho Off |
| Context: | server config, virtual host |
| Status: | Experimental |
| Module: | mod_echo |
The ProtocolEcho directive enables or
disables the echo server.
ProtocolEcho On
Apache HTTP Server Version 2.4
| Description: | Generation of Expires and
Cache-Control HTTP headers according to user-specified
criteria |
|---|---|
| Status: | Extension |
| Module Identifier: | expires_module |
| Source File: | mod_expires.c |
This module controls the setting of the Expires
HTTP header and the max-age directive of the
Cache-Control HTTP header in server responses. The
expiration date can set to be relative to either the time the
source file was last modified, or to the time of the client
access.
These HTTP headers are an instruction to the client about the document's validity and persistence. If cached, the document may be fetched from the cache rather than from the source until this time has passed. After that, the cache copy is considered "expired" and invalid, and a new copy must be obtained from the source.
To modify Cache-Control directives other than
max-age (see RFC
2616 section 14.9), you can use the Header directive.
When the Expires header is already part of the response
generated by the server, for example when generated by a CGI script or
proxied from an origin server, this module does not change or add
an Expires or Cache-Control header.
The ExpiresDefault and
ExpiresByType directives
can also be defined in a more readable syntax of the form:
ExpiresDefault "base [plus num type] [num type] ..." ExpiresByType type/encoding "base [plus num type] [num type] ..."
where base is one of:
accessnow (equivalent to
'access')modificationThe plus keyword is optional. num
should be an integer value [acceptable to atoi()],
and type is one of:
yearsmonthsweeksdayshoursminutessecondsFor example, any of the following directives can be used to make documents expire 1 month after being accessed, by default:
ExpiresDefault "access plus 1 month" ExpiresDefault "access plus 4 weeks" ExpiresDefault "access plus 30 days"
The expiry time can be fine-tuned by adding several 'num type' clauses:
ExpiresByType text/html "access plus 1 month 15 days 2 hours" ExpiresByType image/gif "modification plus 5 hours 3 minutes"
Note that if you use a modification date based setting, the Expires header will not be added to content that does not come from a file on disk. This is due to the fact that there is no modification time for such content.
| Description: | Enables generation of Expires
headers |
|---|---|
| Syntax: | ExpiresActive On|Off |
| Default: | ExpiresActive Off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Extension |
| Module: | mod_expires |
This directive enables or disables the generation of the
Expires and Cache-Control headers for
the document realm in question. (That is, if found in an
.htaccess file, for instance, it applies only to
documents generated from that directory.) If set to
Off, the headers will not be generated for any
document in the realm (unless overridden at a lower level, such as
an .htaccess file overriding a server config
file). If set to On, the headers will be added to
served documents according to the criteria defined by the
ExpiresByType and
ExpiresDefault
directives (q.v.).
Note that this directive does not guarantee that an
Expires or Cache-Control header will be
generated. If the criteria aren't met, no header will be sent, and
the effect will be as though this directive wasn't even
specified.
| Description: | Value of the Expires header configured
by MIME type |
|---|---|
| Syntax: | ExpiresByType MIME-type
<code>seconds |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Extension |
| Module: | mod_expires |
This directive defines the value of the Expires
header and the max-age directive of the
Cache-Control header generated for documents of the
specified type (e.g., text/html). The second
argument sets the number of seconds that will be added to a base
time to construct the expiration date. The Cache-Control:
max-age is calculated by subtracting the request time from
the expiration date and expressing the result in seconds.
The base time is either the last modification time of the
file, or the time of the client's access to the document. Which
should be used is specified by the
<code> field; M
means that the file's last modification time should be used as
the base time, and A means the client's access
time should be used.
The difference in effect is subtle. If M is used,
all current copies of the document in all caches will expire at
the same time, which can be good for something like a weekly
notice that's always found at the same URL. If A is
used, the date of expiration is different for each client; this
can be good for image files that don't change very often,
particularly for a set of related documents that all refer to
the same images (i.e., the images will be accessed
repeatedly within a relatively short timespan).
# enable expirations ExpiresActive On # expire GIF images after a month in the client's cache ExpiresByType image/gif A2592000 # HTML documents are good for a week from the # time they were changed ExpiresByType text/html M604800
Note that this directive only has effect if
ExpiresActive On has been specified. It overrides,
for the specified MIME type only, any expiration date
set by the ExpiresDefault
directive.
You can also specify the expiration time calculation using an alternate syntax, described earlier in this document.
| Description: | Default algorithm for calculating expiration time |
|---|---|
| Syntax: | ExpiresDefault <code>seconds |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Extension |
| Module: | mod_expires |
This directive sets the default algorithm for calculating the
expiration time for all documents in the affected realm. It can be
overridden on a type-by-type basis by the ExpiresByType directive. See the
description of that directive for details about the syntax of the
argument, and the alternate syntax
description as well.
Apache HTTP Server Version 2.4
| Description: | Dumps all I/O to error log as desired. |
|---|---|
| Status: | Extension |
| Module Identifier: | dumpio_module |
| Source File: | mod_dumpio.c |
mod_dumpio allows for the logging of
all input received by Apache and/or all output sent by
Apache to be logged (dumped) to the error.log file.
The data logging is done right after SSL decoding (for input) and right before SSL encoding (for output). As can be expected, this can produce extreme volumes of data, and should only be used when debugging problems.
To enable the module, it should be compiled and loaded
in to your running Apache configuration. Logging can then
be enabled or disabled separately for input and output via
the below directives. Additionally, mod_dumpio
needs to be configured to LogLevel trace7:
LogLevel dumpio:trace7
| Description: | Dump all input data to the error log |
|---|---|
| Syntax: | DumpIOInput On|Off |
| Default: | DumpIOInput Off |
| Context: | server config |
| Status: | Extension |
| Module: | mod_dumpio |
| Compatibility: | DumpIOInput is only available in Apache 2.1.3 and later. |
Enable dumping of all input.
DumpIOInput On
| Description: | Dump all output data to the error log |
|---|---|
| Syntax: | DumpIOOutput On|Off |
| Default: | DumpIOOutput Off |
| Context: | server config |
| Status: | Extension |
| Module: | mod_dumpio |
| Compatibility: | DumpIOOutput is only available in Apache 2.1.3 and later. |
Enable dumping of all output.
DumpIOOutput On
Apache HTTP Server Version 2.4
| Description: | Illustrates the Apache module API |
|---|---|
| Status: | Experimental |
| Module Identifier: | example_hooks_module |
| Source File: | mod_example_hooks.c |
The files in the modules/examples directory
under the Apache distribution directory tree are provided as an
example to those that wish to write modules that use the Apache
API.
The main file is mod_example_hooks.c, which
illustrates all the different callback mechanisms and call
syntaxes. By no means does an add-on module need to include
routines for all of the callbacks - quite the contrary!
The example module is an actual working module. If you link it into your server, enable the "example-hooks-handler" handler for a location, and then browse to that location, you will see a display of some of the tracing the example module did as the various callbacks were made.
To include the example_hooks module in your server, follow the steps below:
configure with --enable-example-hooks
option.make").To add another module of your own:
cp modules/examples/mod_example_hooks.c
modules/new_module/mod_myexample.cmodules/new_module/config.m4.
APACHE_MODPATH_INIT(new_module).modules/examples/config.m4.configure --help.config.m4 files in modules directory for
examples.APACHE_MODPATH_FINISH.module/new_module/Makefile.in.
If your module doesn't need special build instructions,
all you need to have in that file is
include $(top_srcdir)/build/special.mk.mod_example_hooks ModuleTo activate the example_hooks module, include a block similar to
the following in your httpd.conf file:
<Location "/example-hooks-info"> SetHandler example-hooks-handler </Location>
As an alternative, you can put the following into a .htaccess file
and then request the file "test.example" from that location:
AddHandler example-hooks-handler ".example"
After reloading/restarting your server, you should be able to browse to this location and see the brief display mentioned earlier.
| Description: | Demonstration directive to illustrate the Apache module API |
|---|---|
| Syntax: | Example |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Experimental |
| Module: | mod_example_hooks |
The Example directive just sets a demonstration
flag which the example module's content handler displays. It
takes no arguments. If you browse to an URL to which the
example-hooks content-handler applies, you will get a display of the
routines within the module and how and in what order they were
called to service the document request. The effect of this
directive one can observe under the point "Example
directive declared here: YES/NO".
Apache HTTP Server Version 2.4
| Description: | Distributed Authoring and Versioning (WebDAV) functionality |
|---|---|
| Status: | Extension |
| Module Identifier: | dav_module |
| Source File: | mod_dav.c |
This module provides class 1 and class 2 WebDAV ('Web-based Distributed Authoring and Versioning') functionality for Apache. This extension to the HTTP protocol allows creating, moving, copying, and deleting resources and collections on a remote web server.
To enable mod_dav, add the following to a
container in your httpd.conf file:
Dav On
This enables the DAV file system provider, which is implemented
by the mod_dav_fs module. Therefore, that module
must be compiled into the server or loaded at runtime using the
LoadModule directive.
In addition, a location for the DAV lock database must be
specified in the global section of your httpd.conf
file using the DavLockDB
directive:
DavLockDB /usr/local/apache2/var/DavLock
The directory containing the lock database file must be
writable by the User
and Group under which
Apache is running.
You may wish to add a <Limit> clause inside the <Location> directive to limit access to
DAV-enabled locations. If you want to set the maximum amount of
bytes that a DAV client can send at one request, you have to use
the LimitXMLRequestBody
directive. The "normal" LimitRequestBody directive has no effect on DAV
requests.
DavLockDB "/usr/local/apache2/var/DavLock"
<Directory "/usr/local/apache2/htdocs/foo">
Require all granted
Dav On
AuthType Basic
AuthName DAV
AuthUserFile "user.passwd"
<LimitExcept GET POST OPTIONS>
Require user admin
</LimitExcept>
</Directory>
Since DAV access methods allow remote clients to manipulate
files on the server, you must take particular care to assure that
your server is secure before enabling mod_dav.
Any location on the server where DAV is enabled should be
protected by authentication. The use of HTTP Basic Authentication
is not recommended. You should use at least HTTP Digest
Authentication, which is provided by the
mod_auth_digest module. Nearly all WebDAV clients
support this authentication method. An alternative is Basic
Authentication over an SSL enabled
connection.
In order for mod_dav to manage files, it must
be able to write to the directories and files under its control
using the User and
Group under which
Apache is running. New files created will also be owned by this
User and Group. For this reason, it is
important to control access to this account. The DAV repository
is considered private to Apache; modifying files outside of Apache
(for example using FTP or filesystem-level tools) should not be
allowed.
mod_dav may be subject to various kinds of
denial-of-service attacks. The LimitXMLRequestBody directive can be
used to limit the amount of memory consumed in parsing large DAV
requests. The DavDepthInfinity directive can be
used to prevent PROPFIND requests on a very large
repository from consuming large amounts of memory. Another
possible denial-of-service attack involves a client simply filling
up all available disk space with many large files. There is no
direct way to prevent this in Apache, so you should avoid giving
DAV access to untrusted users.
One common request is to use mod_dav to
manipulate dynamic files (PHP scripts, CGI scripts, etc). This is
difficult because a GET request will always run the
script, rather than downloading its contents. One way to avoid
this is to map two different URLs to the content, one of which
will run the script, and one of which will allow it to be
downloaded and manipulated with DAV.
Alias "/phparea" "/home/gstein/php_files"
Alias "/php-source" "/home/gstein/php_files"
<Location "/php-source">
Dav On
ForceType text/plain
</Location>
With this setup, http://example.com/phparea can be
used to access the output of the PHP scripts, and
http://example.com/php-source can be used with a DAV
client to manipulate them.
| Description: | Enable WebDAV HTTP methods |
|---|---|
| Syntax: | Dav On|Off|provider-name |
| Default: | Dav Off |
| Context: | directory |
| Status: | Extension |
| Module: | mod_dav |
Use the Dav directive to enable the
WebDAV HTTP methods for the given container:
<Location "/foo">
Dav On
</Location>
The value On is actually an alias for the default
provider filesystem which is served by the mod_dav_fs module. Note, that once you have DAV enabled
for some location, it cannot be disabled for sublocations.
For a complete configuration example have a look at the section above.
| Description: | Configure repository root path |
|---|---|
| Syntax: | DavBasePath root-path |
| Default: | None |
| Context: | directory |
| Status: | Extension |
| Module: | mod_dav |
| Compatibility: | Available in version 2.4.58 and later |
If a DAV repository is configured using a regular expression
match (such as LocationMatch)
then mod_dav will not be able to find the root of
the repository from the pathname alone. Third-party providers (for
example, Subversion's mod_dav_svn)
may fail to handle requests without the correct repository root.
To allow providers to work correctly in such a configuration,
DavBasePath must be used.
<LocationMatch "^/repos/">
Dav svn
DavBasePath /repos
SVNParentPath /var/svn
</LocationMatch>
| Description: | Allow PROPFIND, Depth: Infinity requests |
|---|---|
| Syntax: | DavDepthInfinity on|off |
| Default: | DavDepthInfinity off |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_dav |
Use the DavDepthInfinity directive to
allow the processing of PROPFIND requests containing the
header 'Depth: Infinity'. Because this type of request could constitute
a denial-of-service attack, by default it is not allowed.
| Description: | Minimum amount of time the server holds a lock on a DAV resource |
|---|---|
| Syntax: | DavMinTimeout seconds |
| Default: | DavMinTimeout 0 |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_dav |
When a client requests a DAV resource lock, it can also specify a time when the lock will be automatically removed by the server. This value is only a request, and the server can ignore it or inform the client of an arbitrary value.
Use the DavMinTimeout directive to specify, in
seconds, the minimum lock timeout to return to a client.
Microsoft Web Folders defaults to a timeout of 120 seconds; the
DavMinTimeout can override this to a higher value
(like 600 seconds) to reduce the chance of the client losing
the lock due to network latency.
<Location "/MSWord">
DavMinTimeout 600
</Location>
Apache HTTP Server Version 2.4
| Description: | Manages SQL database connections |
|---|---|
| Status: | Extension |
| Module Identifier: | dbd_module |
| Source File: | mod_dbd.c |
| Compatibility: | Version 2.1 and later |
mod_dbd manages SQL database connections using
APR. It provides database connections on request
to modules requiring SQL database functions, and takes care of
managing databases with optimal efficiency and scalability
for both threaded and non-threaded MPMs. For details, see the
APR website and this overview of the
Apache DBD Framework
by its original developer.
This module manages database connections, in a manner
optimised for the platform. On non-threaded platforms,
it provides a persistent connection in the manner of
classic LAMP (Linux, Apache, Mysql, Perl/PHP/Python).
On threaded platform, it provides an altogether more
scalable and efficient connection pool, as
described in this
article at ApacheTutor. Note that mod_dbd
supersedes the modules presented in that article.
To connect to your database, you'll need to specify a driver, and connection parameters. These vary from one database engine to another. For example, to connect to mysql, do the following:
DBDriver mysql DBDParams host=localhost,dbname=pony,user=shetland,pass=appaloosa
You can then use this connection in a variety of other
modules, including mod_rewrite,
mod_authn_dbd, and mod_lua.
Further usage examples appear in each of those modules'
documentation.
See DBDParams for connection string
information for each of the supported database drivers.
mod_dbd exports five functions for other modules
to use. The API is as follows:
typedef struct {
apr_dbd_t *handle;
apr_dbd_driver_t *driver;
apr_hash_t *prepared;
} ap_dbd_t;
/* Export functions to access the database */
/* acquire a connection that MUST be explicitly closed.
* Returns NULL on error
*/
AP_DECLARE(ap_dbd_t*) ap_dbd_open(apr_pool_t*, server_rec*);
/* release a connection acquired with ap_dbd_open */
AP_DECLARE(void) ap_dbd_close(server_rec*, ap_dbd_t*);
/* acquire a connection that will have the lifetime of a request
* and MUST NOT be explicitly closed. Return NULL on error.
* This is the preferred function for most applications.
*/
AP_DECLARE(ap_dbd_t*) ap_dbd_acquire(request_rec*);
/* acquire a connection that will have the lifetime of a connection
* and MUST NOT be explicitly closed. Return NULL on error.
*/
AP_DECLARE(ap_dbd_t*) ap_dbd_cacquire(conn_rec*);
/* Prepare a statement for use by a client module */
AP_DECLARE(void) ap_dbd_prepare(server_rec*, const char*, const char*);
/* Also export them as optional functions for modules that prefer it */
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_open, (apr_pool_t*, server_rec*));
APR_DECLARE_OPTIONAL_FN(void, ap_dbd_close, (server_rec*, ap_dbd_t*));
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_acquire, (request_rec*));
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_cacquire, (conn_rec*));
APR_DECLARE_OPTIONAL_FN(void, ap_dbd_prepare, (server_rec*, const char*, const char*));
mod_dbd supports SQL prepared statements on behalf
of modules that may wish to use them. Each prepared statement
must be assigned a name (label), and they are stored in a hash:
the prepared field of an ap_dbd_t.
Hash entries are of type apr_dbd_prepared_t
and can be used in any of the apr_dbd prepared statement
SQL query or select commands.
It is up to dbd user modules to use the prepared statements
and document what statements can be specified in httpd.conf,
or to provide their own directives and use ap_dbd_prepare.
reconnect to 0 in the connection string as to avoid errors that
arise from the MySQL client reconnecting without properly resetting the
prepared statements. If set to 1, any broken connections will be attempted
fixed, but as mod_dbd is not informed, the prepared statements will be invalidated.
Any web/database application needs to secure itself against SQL injection attacks. In most cases, Apache DBD is safe, because applications use prepared statements, and untrusted inputs are only ever used as data. Of course, if you use it via third-party modules, you should ascertain what precautions they may require.
However, the FreeTDS driver is inherently unsafe. The underlying library doesn't support prepared statements, so the driver emulates them, and the untrusted input is merged into the SQL statement.
It can be made safe by untainting all inputs: a process inspired by Perl's taint checking. Each input is matched against a regexp, and only the match is used, according to the Perl idiom:
$untrusted =~ /([a-z]+)/;
$trusted = $1;To use this, the untainting regexps must be included in the prepared statements configured. The regexp follows immediately after the % in the prepared statement, and is enclosed in curly brackets {}. For example, if your application expects alphanumeric input, you can use:
"SELECT foo FROM bar WHERE input = %s"
with other drivers, and suffer nothing worse than a failed query. But with FreeTDS you'd need:
"SELECT foo FROM bar WHERE input = %{([A-Za-z0-9]+)}s"
Now anything that doesn't match the regexp's $1 match is discarded, so the statement is safe.
An alternative to this may be the third-party ODBC driver, which offers the security of genuine prepared statements.
| Description: | Keepalive time for idle connections |
|---|---|
| Syntax: | DBDExptime time-in-seconds |
| Default: | DBDExptime 300 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_dbd |
Set the time to keep idle connections alive when the number of connections specified in DBDKeep has been exceeded (threaded platforms only).
| Description: | Execute an SQL statement after connecting to a database |
|---|---|
| Syntax: | DBDInitSQL "SQL statement" |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_dbd |
Modules, that wish it, can have one or more SQL statements executed when a connection to a database is created. Example usage could be initializing certain values or adding a log entry when a new connection is made to the database.
| Description: | Maximum sustained number of connections |
|---|---|
| Syntax: | DBDKeep number |
| Default: | DBDKeep 2 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_dbd |
Set the maximum number of connections per process to be sustained, other than for handling peak demand (threaded platforms only).
| Description: | Maximum number of connections |
|---|---|
| Syntax: | DBDMax number |
| Default: | DBDMax 10 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_dbd |
Set the hard maximum number of connections per process (threaded platforms only).
| Description: | Minimum number of connections |
|---|---|
| Syntax: | DBDMin number |
| Default: | DBDMin 1 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_dbd |
Set the minimum number of connections per process (threaded platforms only).
| Description: | Parameters for database connection |
|---|---|
| Syntax: | DBDParams
param1=value1[,param2=value2] |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_dbd |
As required by the underlying driver. Typically this will be used to pass whatever cannot be defaulted amongst username, password, database name, hostname and port number for connection.
Connection string parameters for current drivers include:
PQconnectdbpart1:part2 is used as sqlite_open(part1, atoi(part2), NULL)sqlite3_open| Description: | Whether to use persistent connections |
|---|---|
| Syntax: | DBDPersist On|Off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_dbd |
If set to Off, persistent and pooled connections are disabled. A new database connection is opened when requested by a client, and closed immediately on release. This option is for debugging and low-usage servers.
The default is to enable a pool of persistent connections (or a single LAMP-style persistent connection in the case of a non-threaded server), and should almost always be used in operation.
Prior to version 2.2.2, this directive accepted only the values
0 and 1 instead of Off and
On, respectively.
| Description: | Define an SQL prepared statement |
|---|---|
| Syntax: | DBDPrepareSQL "SQL statement" label |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_dbd |
For modules such as authentication that repeatedly use a single SQL statement, optimum performance is achieved by preparing the statement at startup rather than every time it is used. This directive prepares an SQL statement and assigns it a label.
| Description: | Specify an SQL driver |
|---|---|
| Syntax: | DBDriver name |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_dbd |
Selects an apr_dbd driver by name. The driver must be installed
on your system (on most systems, it will be a shared object or dll).
For example, DBDriver mysql will select the MySQL
driver in apr_dbd_mysql.so.
Apache HTTP Server Version 2.4
| Description: | Provides for "trailing slash" redirects and serving directory index files |
|---|---|
| Status: | Base |
| Module Identifier: | dir_module |
| Source File: | mod_dir.c |
The index of a directory can come from one of two sources:
index.html. The DirectoryIndex directive sets the
name of this file. This is controlled by
mod_dir.mod_autoindex.The two functions are separated so that you can completely remove (or replace) automatic index generation should you want to.
A "trailing slash" redirect is issued when the server
receives a request for a URL
http://servername/foo/dirname where
dirname is a directory. Directories require a
trailing slash, so mod_dir issues a redirect to
http://servername/foo/dirname/.
| Description: | Toggle how this module responds when another handler is configured |
|---|---|
| Syntax: | DirectoryCheckHandler On|Off |
| Default: | DirectoryCheckHandler Off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_dir |
| Compatibility: | Available in 2.4.8 and later. Releases prior to 2.4 implicitly act as if "DirectoryCheckHandler ON" was specified. |
The DirectoryCheckHandler directive determines
whether mod_dir should check for directory indexes or
add trailing slashes when some other handler has been configured for
the current URL. Handlers can be set by directives such as
SetHandler or by other modules,
such as mod_rewrite during per-directory substitutions.
In releases prior to 2.4, this module did not take any action if any
other handler was configured for a URL. This allows directory indexes to
be served even when a SetHandler directive is
specified for an entire directory, but it can also result in some conflicts
with modules such as mod_rewrite.
| Description: | List of resources to look for when the client requests a directory |
|---|---|
| Syntax: | DirectoryIndex
disabled | local-url [local-url] ... |
| Default: | DirectoryIndex index.html |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_dir |
The DirectoryIndex directive sets the
list of resources to look for, when the client requests an index
of the directory by specifying a / at the end of the directory
name. Local-url is the (%-encoded) URL of a document on
the server relative to the requested directory; it is usually the
name of a file in the directory. Several URLs may be given, in
which case the server will return the first one that it finds. If
none of the resources exist and the Indexes option is
set, the server will generate its own listing of the
directory.
DirectoryIndex index.html
then a request for http://example.com/docs/ would
return http://example.com/docs/index.html if it
exists, or would list the directory if it did not.
Note that the documents do not need to be relative to the directory;
DirectoryIndex index.html index.txt /cgi-bin/index.pl
would cause the CGI script /cgi-bin/index.pl to be
executed if neither index.html or index.txt
existed in a directory.
A single argument of "disabled" prevents mod_dir from
searching for an index. An argument of "disabled" will be interpreted
literally if it has any arguments before or after it, even if they are "disabled"
as well.
Note: Multiple DirectoryIndex
directives within the same context will add
to the list of resources to look for rather than replace:
# Example A: Set index.html as an index page, then add index.php to that list as well.
<Directory "/foo">
DirectoryIndex index.html
DirectoryIndex index.php
</Directory>
# Example B: This is identical to example A, except it's done with a single directive.
<Directory "/foo">
DirectoryIndex index.html index.php
</Directory>
# Example C: To replace the list, you must explicitly reset it first:
# In this example, only index.php will remain as an index resource.
<Directory "/foo">
DirectoryIndex index.html
DirectoryIndex disabled
DirectoryIndex index.php
</Directory>
| Description: | Configures an external redirect for directory indexes. |
|---|---|
| Syntax: | DirectoryIndexRedirect on | off | permanent | temp | seeother |
3xx-code
|
| Default: | DirectoryIndexRedirect off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_dir |
| Compatibility: | Available in version 2.3.14 and later |
By default, the DirectoryIndex is selected
and returned transparently to the client. DirectoryIndexRedirect causes an external redirect
to instead be issued.
The argument can be:
on: issues a 302 redirection to the index resource.off: does not issue a redirection. This is the legacy behaviour of mod_dir.permanent: issues a 301 (permanent) redirection to the index resource.temp: this has the same effect as onseeother: issues a 303 redirection (also known as "See Other") to the index resource.DirectoryIndexRedirect on
A request for http://example.com/docs/ would
return a temporary redirect to http://example.com/docs/index.html
if it exists.
| Description: | Toggle trailing slash redirects on or off |
|---|---|
| Syntax: | DirectorySlash On|Off |
| Default: | DirectorySlash On |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_dir |
The DirectorySlash directive determines whether
mod_dir should fixup URLs pointing to a directory or
not.
Typically if a user requests a resource without a trailing slash, which
points to a directory, mod_dir redirects him to the same
resource, but with trailing slash for some good reasons:
mod_autoindex works correctly. Since it doesn't emit
the path in the link, it would point to the wrong path.DirectoryIndex will be evaluated
only for directories requested with trailing slash.If you don't want this effect and the reasons above don't apply to you, you can turn off the redirect as shown below. However, be aware that there are possible security implications to doing this.
# see security warning below!
<Location "/some/path">
DirectorySlash Off
SetHandler some-handler
</Location>
Turning off the trailing slash redirect may result in an information
disclosure. Consider a situation where mod_autoindex is
active (Options +Indexes) and DirectoryIndex is set to a valid resource (say,
index.html) and there's no other special handler defined for
that URL. In this case a request with a trailing slash would show the
index.html file. But a request without trailing slash
would list the directory contents.
Also note that some browsers may erroneously change POST requests into GET (thus discarding POST data) when a redirect is issued.
| Description: | Define a default URL for requests that don't map to a file |
|---|---|
| Syntax: | FallbackResource disabled | local-url |
| Default: | disabled - httpd will return 404 (Not Found) |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_dir |
| Compatibility: | The disabled argument is available in version 2.4.4 and
later |
Use this to set a handler for any URL that doesn't map to anything in your filesystem, and would otherwise return HTTP 404 (Not Found). For example
FallbackResource /not-404.php
will cause requests for non-existent files to be handled by
not-404.php, while requests for files that exist
are unaffected.
It is frequently desirable to have a single file or resource handle all requests to a particular directory, except those requests that correspond to an existing file or script. This is often referred to as a 'front controller.'
In earlier versions of httpd, this effect typically required
mod_rewrite, and the use of the -f and
-d tests for file and directory existence. This now
requires only one line of configuration.
FallbackResource /index.php
Existing files, such as images, css files, and so on, will be served normally.
Use the disabled argument to disable that feature
if inheritance from a parent directory is not desired.
In a sub-URI, such as http://example.com/blog/ this sub-URI has to be supplied as local-url:
<Directory "/web/example.com/htdocs/blog">
FallbackResource /blog/index.php
</Directory>
<Directory "/web/example.com/htdocs/blog/images">
FallbackResource disabled
</Directory>
A fallback handler (in the above case, /blog/index.php)
can access the original requested URL via the server variable
REQUEST_URI. For example, to access this variable in PHP,
use $_SERVER['REQUEST_URI'].
Apache HTTP Server Version 2.4
| Description: | Modifies the environment which is passed to CGI scripts and SSI pages |
|---|---|
| Status: | Base |
| Module Identifier: | env_module |
| Source File: | mod_env.c |
This module allows for control of internal environment variables that
are used by various Apache HTTP Server modules. These variables are also
provided to CGI scripts as native system environment variables, and available
for use in SSI pages. Environment variables may be passed from the shell
which invoked the httpd process. Alternatively,
environment variables may be set or unset within the configuration process.
| Description: | Passes environment variables from the shell |
|---|---|
| Syntax: | PassEnv env-variable [env-variable]
... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_env |
Specifies one or more native system environment variables to make available
as internal environment variables, which are available to Apache HTTP Server modules
as well as propagated to CGI scripts and SSI pages. Values come from the
native OS environment of the shell which invoked the
httpd process.
PassEnv LD_LIBRARY_PATH
| Description: | Sets environment variables |
|---|---|
| Syntax: | SetEnv env-variable [value] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_env |
Sets an internal environment variable, which is then available to Apache HTTP Server modules, and passed on to CGI scripts and SSI pages.
SetEnv SPECIAL_PATH /foo/bin
If you omit the value argument, the variable is set to an empty string.
The internal environment variables set by this directive are set
after most early request processing directives are run, such as access
control and URI-to-filename mapping. If the environment variable you're
setting is meant as input into this early phase of processing such as the
RewriteRule directive, you should
instead set the environment variable with
SetEnvIf.
| Description: | Removes variables from the environment |
|---|---|
| Syntax: | UnsetEnv env-variable [env-variable]
... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_env |
Removes one or more internal environment variables from those passed on to CGI scripts and SSI pages.
UnsetEnv LD_LIBRARY_PATH
Apache HTTP Server Version 2.4
| Description: | Context-sensitive smart filter configuration module |
|---|---|
| Status: | Base |
| Module Identifier: | filter_module |
| Source File: | mod_filter.c |
| Compatibility: | Version 2.1 and later |
This module enables smart, context-sensitive configuration of output content filters. For example, apache can be configured to process different content-types through different filters, even when the content-type is not known in advance (e.g. in a proxy).
mod_filter works by introducing indirection into
the filter chain. Instead of inserting filters in the chain, we insert
a filter harness which in turn dispatches conditionally
to a filter provider. Any content filter may be used as a provider
to mod_filter; no change to existing filter modules is
required (although it may be possible to simplify them).
Smart Filtering Filter Declarations, Providers and Chains Configuring the Chain Filtering and Response Status Upgrading from Apache HTTP Server 2.2 Configuration Examples Protocol HandlingIn the traditional filtering model, filters are inserted unconditionally
using AddOutputFilter and family.
Each filter then needs to determine whether to run, and there is little
flexibility available for server admins to allow the chain to be
configured dynamically.
mod_filter by contrast gives server administrators a
great deal of flexibility in configuring the filter chain. In fact,
filters can be inserted based on complex boolean
expressions This generalises the limited
flexibility offered by AddOutputFilterByType.
Figure 1: The traditional filter model
In the traditional model, output filters are a simple chain from the content generator (handler) to the client. This works well provided the filter chain can be correctly configured, but presents problems when the filters need to be configured dynamically based on the outcome of the handler.
Figure 2: The mod_filter model
mod_filter works by introducing indirection into
the filter chain. Instead of inserting filters in the chain, we insert
a filter harness which in turn dispatches conditionally
to a filter provider. Any content filter may be used as a provider
to mod_filter; no change to existing filter modules
is required (although it may be possible to simplify them). There can be
multiple providers for one filter, but no more than one provider will
run for any single request.
A filter chain comprises any number of instances of the filter harness, each of which may have any number of providers. A special case is that of a single provider with unconditional dispatch: this is equivalent to inserting the provider filter directly into the chain.
There are three stages to configuring a filter chain with
mod_filter. For details of the directives, see below.
FilterDeclare directive
declares a filter, assigning it a name and filter type. Required
only if the filter is not the default type AP_FTYPE_RESOURCE.FilterProvider
directive registers a provider with a filter. The filter may have
been declared with FilterDeclare; if not, FilterProvider will implicitly
declare it with the default type AP_FTYPE_RESOURCE. The provider
must have been
registered with ap_register_output_filter by some module.
The final argument to FilterProvider is an expression: the provider will be
selected to run for a request if and only if the expression evaluates
to true. The expression may evaluate HTTP request or response
headers, environment variables, or the Handler used by this request.
Unlike earlier versions, mod_filter now supports complex expressions
involving multiple criteria with AND / OR logic (&& / ||)
and brackets. The details of the expression syntax are described in
the ap_expr documentation.FilterChain directive builds a filter chain from smart
filters declared, offering the flexibility to insert filters at the
beginning or end of the chain, remove a filter, or clear the chain.mod_filter normally only runs filters on responses with
HTTP status 200 (OK). If you want to filter documents with
other response statuses, you can set the filter-errordocs
environment variable, and it will work on all responses
regardless of status. To refine this further, you can use
expression conditions with FilterProvider.
The FilterProvider
directive has changed from httpd 2.2: the match and
dispatch arguments are replaced with a single but
more versatile expression. In general, you can convert
a match/dispatch pair to the two sides of an expression, using
something like:
"dispatch = 'match'"
The Request headers, Response headers and Environment variables are now interpreted from syntax %{req:foo}, %{resp:foo} and %{env:foo} respectively. The variables %{HANDLER} and %{CONTENT_TYPE} are also supported.
Note that the match no longer support substring matches. They can be replaced by regular expression matches.
AddOutputFilterByType
FilterDeclare SSI
FilterProvider SSI INCLUDES "%{CONTENT_TYPE} =~ m|^text/html|"
FilterChain SSI
FilterProvider SSI INCLUDES "%{HANDLER} = 'server-parsed'"
FilterChain SSI
FilterDeclare gzip CONTENT_SET
FilterProvider gzip inflate "%{req:Accept-Encoding} !~ /gzip/"
FilterChain gzip
FilterProvider unpack jpeg_unpack "%{CONTENT_TYPE} = 'image/jpeg'"
FilterProvider unpack gif_unpack "%{CONTENT_TYPE} = 'image/gif'"
FilterProvider unpack png_unpack "%{CONTENT_TYPE} = 'image/png'"
FilterProvider downsample downsample_filter "%{CONTENT_TYPE} = m|^image/(jpeg|gif|png)|"
FilterProtocol downsample "change=yes"
FilterProvider repack jpeg_pack "%{CONTENT_TYPE} = 'image/jpeg'"
FilterProvider repack gif_pack "%{CONTENT_TYPE} = 'image/gif'"
FilterProvider repack png_pack "%{CONTENT_TYPE} = 'image/png'"
<Location "/image-filter">
FilterChain unpack downsample repack
</Location>
Historically, each filter is responsible for ensuring that whatever changes it makes are correctly represented in the HTTP response headers, and that it does not run when it would make an illegal change. This imposes a burden on filter authors to re-implement some common functionality in every filter:
Cache-Control: no-transform header from the
backend.mod_filter aims to offer generic handling of these
details of filter implementation, reducing the complexity required of
content filter modules. This is work-in-progress; the
FilterProtocol implements
some of this functionality for back-compatibility with Apache 2.0
modules. For httpd 2.1 and later, the
ap_register_output_filter_protocol and
ap_filter_protocol API enables filter modules to
declare their own behaviour.
At the same time, mod_filter should not interfere
with a filter that wants to handle all aspects of the protocol. By
default (i.e. in the absence of any FilterProtocol directives), mod_filter
will leave the headers untouched.
At the time of writing, this feature is largely untested, as modules in common use are designed to work with 2.0. Modules using it should test it carefully.
| Description: | assigns an output filter to a particular media-type |
|---|---|
| Syntax: | AddOutputFilterByType filter[;filter...]
media-type [media-type] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_filter |
| Compatibility: | Had severe limitations before
being moved to mod_filter in version 2.3.7 |
This directive activates a particular output filter for a request depending on the response media-type.
The following example uses the DEFLATE filter, which
is provided by mod_deflate. It will compress all
output (either static or dynamic) which is labeled as
text/html or text/plain before it is sent
to the client.
AddOutputFilterByType DEFLATE text/html text/plain
If you want the content to be processed by more than one filter, their
names have to be separated by semicolons. It's also possible to use one
AddOutputFilterByType directive for each of
these filters.
The configuration below causes all script output labeled as
text/html to be processed at first by the
INCLUDES filter and then by the DEFLATE
filter.
<Location "/cgi-bin/">
Options Includes
AddOutputFilterByType INCLUDES;DEFLATE text/html
</Location>
| Description: | Configure the filter chain |
|---|---|
| Syntax: | FilterChain [+=-@!]filter-name ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Base |
| Module: | mod_filter |
This configures an actual filter chain, from declared filters.
FilterChain takes any number of arguments,
each optionally preceded with a single-character control that
determines what to do:
+filter-name@filter-name-filter-name=filter-name!filter-name+filter-name| Description: | Declare a smart filter |
|---|---|
| Syntax: | FilterDeclare filter-name [type] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Base |
| Module: | mod_filter |
This directive declares an output filter together with a
header or environment variable that will determine runtime
configuration. The first argument is a filter-name
for use in FilterProvider,
FilterChain and
FilterProtocol directives.
The final (optional) argument
is the type of filter, and takes values of ap_filter_type
- namely RESOURCE (the default), CONTENT_SET,
PROTOCOL, TRANSCODE, CONNECTION
or NETWORK.
| Description: | Deal with correct HTTP protocol handling |
|---|---|
| Syntax: | FilterProtocol filter-name [provider-name]
proto-flags |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Base |
| Module: | mod_filter |
This directs mod_filter to deal with ensuring the
filter doesn't run when it shouldn't, and that the HTTP response
headers are correctly set taking into account the effects of the
filter.
There are two forms of this directive. With three arguments, it applies specifically to a filter-name and a provider-name for that filter. With two arguments it applies to a filter-name whenever the filter runs any provider.
Flags specified with this directive are merged with the flags
that underlying providers may have registered with
mod_filter. For example, a filter may internally specify
the equivalent of change=yes, but a particular
configuration of the module can override with change=no.
proto-flags is one or more of
change=yes|nochange=1:1byteranges=noproxy=noproxy=transformCache-Control: no-transform header.cache=no| Description: | Register a content filter |
|---|---|
| Syntax: | FilterProvider filter-name provider-name
expression |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Base |
| Module: | mod_filter |
This directive registers a provider for the smart filter. The provider will be called if and only if the expression declared evaluates to true when the harness is first called.
provider-name must have been registered by loading
a module that registers the name with
ap_register_output_filter.
expression is an ap_expr.
mod_include| Description: | Get debug/diagnostic information from
mod_filter |
|---|---|
| Syntax: | FilterTrace filter-name level |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_filter |
This directive generates debug information from
mod_filter.
It is designed to help test and debug providers (filter modules), although
it may also help with mod_filter itself.
The debug output depends on the level set:
0 (default)1mod_filter will record buckets and brigades
passing through the filter to the error log, before the provider has
processed them. This is similar to the information generated by
mod_diagnostics.
2 (not yet implemented)Apache HTTP Server Version 2.4
| Description: | Centralized monitor for mod_heartbeat origin servers |
|---|---|
| Status: | Experimental |
| Module Identifier: | heartmonitor_module |
| Source File: | mod_heartmonitor.c |
| Compatibility: | Available in Apache 2.3 and later |
mod_heartmonitor listens for server status messages generated
by mod_heartbeat enabled origin servers and makes their status
available to mod_lbmethod_heartbeat. This allows
ProxyPass to use the "heartbeat"
lbmethod inside of ProxyPass.
This module uses the services of mod_slotmem_shm when
available instead of flat-file storage. No configuration is required to
use mod_slotmem_shm.
mod_heartmonitor,
mod_status and mod_watchdog
must be either a static modules or, if a dynamic module, it must
be loaded before mod_heartmonitor.
| Description: | multicast address to listen for incoming heartbeat requests |
|---|---|
| Syntax: | HeartbeatListen addr:port |
| Default: | disabled |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_heartmonitor |
The HeartbeatListen directive specifies the
multicast address on which the server will listen for status information from
mod_heartbeat-enabled servers. This
address will usually correspond to a configured HeartbeatAddress on an origin server.
HeartbeatListen 239.0.0.1:27999
This module is inactive until this directive is used.
| Description: | Specifies the maximum number of servers that will be sending heartbeat requests to this server |
|---|---|
| Syntax: | HeartbeatMaxServers number-of-servers |
| Default: | HeartbeatMaxServers 10 |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_heartmonitor |
| Compatibility: | The value of 0 is accepted only in 2.4.55 and above |
The HeartbeatMaxServers directive specifies the
maximum number of servers that will be sending requests to this monitor
server. It is used to control the size of the shared memory allocated
to store the heartbeat info when mod_slotmem_shm is in use.
For using flat-file storage (without loading mod_slotmem_shm),
this must be set to 0. The value must be either 0, or bigger or equals 10.
| Description: | Path to store heartbeat data when using flat-file storage |
|---|---|
| Syntax: | HeartbeatStorage file-path |
| Default: | HeartbeatStorage logs/hb.dat |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_heartmonitor |
The HeartbeatStorage directive specifies the
path to store heartbeat data. This flat-file is used only when
mod_slotmem_shm is not loaded and
HeartbeatMaxServers is set to 0.
Apache HTTP Server Version 2.4
| Description: | Replaces the original client IP address for the connection with the useragent IP address list presented by a proxies or a load balancer via the request headers. |
|---|---|
| Status: | Base |
| Module Identifier: | remoteip_module |
| Source File: | mod_remoteip.c |
This module is used to treat the useragent which initiated the request as the originating useragent as identified by httpd for the purposes of authorization and logging, even where that useragent is behind a load balancer, front end server, or proxy server.
The module overrides the client IP address for the connection
with the useragent IP address reported in the request header configured
with the RemoteIPHeader directive.
Additionally, this module implements the server side of
HAProxy's
PROXY Protocol when
using the RemoteIPProxyProtocol
directive.
Once replaced as instructed, this overridden useragent IP address is
then used for the mod_authz_host
Require ip
feature, is reported by mod_status, and is recorded by
mod_log_config %a and core
%a format strings. The underlying client IP of the connection
is available in the %{c}a format string.
RemoteIPHeader RemoteIPInternalProxy RemoteIPInternalProxyList RemoteIPProxiesHeader RemoteIPProxyProtocol RemoteIPProxyProtocolExceptions RemoteIPTrustedProxy RemoteIPTrustedProxyListApache by default identifies the useragent with the connection's client_ip value, and the connection remote_host and remote_logname are derived from this value. These fields play a role in authentication, authorization and logging and other purposes by other loadable modules.
mod_remoteip overrides the client IP of the connection with the advertised useragent IP as provided by a proxy or load balancer, for the duration of the request. A load balancer might establish a long lived keepalive connection with the server, and each request will have the correct useragent IP, even though the underlying client IP address of the load balancer remains unchanged.
When multiple, comma delimited useragent IP addresses are listed in the header value, they are processed in Right-to-Left order. Processing halts when a given useragent IP address is not trusted to present the preceding IP address. The header field is updated to this remaining list of unconfirmed IP addresses, or if all IP addresses were trusted, this header is removed from the request altogether.
In overriding the client IP, the module stores the list of intermediate
hosts in a remoteip-proxy-ip-list note, which mod_log_config
can record using the %{remoteip-proxy-ip-list}n format token.
If the administrator needs to store this as an additional header, this
same value can also be recording as a header using the directive
RemoteIPProxiesHeader.
RemoteIPInternalProxy
internal (intranet) proxies are registered.| Description: | Declare the header field which should be parsed for useragent IP addresses |
|---|---|
| Syntax: | RemoteIPHeader header-field |
| Default: | none |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_remoteip |
The RemoteIPHeader directive triggers
mod_remoteip to treat the value of the specified
header-field header as the useragent IP address, or list
of intermediate useragent IP addresses, subject to further configuration
of the RemoteIPInternalProxy and
RemoteIPTrustedProxy directives. Unless these
other directives are used, mod_remoteip will trust all
hosts presenting a RemoteIPHeader IP value.
RemoteIPHeader X-Client-IP
RemoteIPHeader X-Forwarded-For
| Description: | Declare client intranet IP addresses trusted to present the RemoteIPHeader value |
|---|---|
| Syntax: | RemoteIPInternalProxy proxy-ip|proxy-ip/subnet|hostname ... |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_remoteip |
The RemoteIPInternalProxy directive adds one
or more addresses (or address blocks) to trust as presenting a valid
RemoteIPHeader value of the useragent IP. Unlike the
RemoteIPTrustedProxy directive, any IP address
presented in this header, including private intranet addresses, are
trusted when passed from these proxies.
RemoteIPHeader X-Client-IP RemoteIPInternalProxy 10.0.2.0/24 RemoteIPInternalProxy gateway.localdomain
| Description: | Declare client intranet IP addresses trusted to present the RemoteIPHeader value |
|---|---|
| Syntax: | RemoteIPInternalProxyList filename |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_remoteip |
The RemoteIPInternalProxyList directive specifies
a file parsed at startup, and builds a list of addresses (or address blocks)
to trust as presenting a valid RemoteIPHeader value of the useragent IP.
The '#' hash character designates a comment line, otherwise
each whitespace or newline separated entry is processed identically to
the RemoteIPInternalProxy directive.
RemoteIPHeader X-Client-IP RemoteIPInternalProxyList conf/trusted-proxies.lst
# Our internally trusted proxies; 10.0.2.0/24 #Everyone in the testing group gateway.localdomain #The front end balancer
| Description: | Declare the header field which will record all intermediate IP addresses |
|---|---|
| Syntax: | RemoteIPProxiesHeader HeaderFieldName |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_remoteip |
The RemoteIPProxiesHeader directive specifies
a header into which mod_remoteip will collect a list of
all of the intermediate client IP addresses trusted to resolve the useragent
IP of the request. Note that intermediate
RemoteIPTrustedProxy addresses are recorded in
this header, while any intermediate
RemoteIPInternalProxy addresses are discarded.
RemoteIPHeader X-Forwarded-For RemoteIPProxiesHeader X-Forwarded-By
| Description: | Enable or disable PROXY protocol handling |
|---|---|
| Syntax: | RemoteIPProxyProtocol On|Off |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_remoteip |
| Compatibility: | RemoteIPProxyProtocol is only available in httpd 2.4.31 and newer |
The RemoteIPProxyProtocol directive enables or
disables the reading and handling of the PROXY protocol connection header.
If enabled with the On flag, the upstream client must
send the header every time it opens a connection or the connection will
be aborted unless it is in the list of disabled hosts provided by the
RemoteIPProxyProtocolExceptions
directive.
While this directive may be specified in any virtual host, it is important to understand that because the PROXY protocol is connection based and protocol agnostic, the enabling and disabling is actually based on IP address and port. This means that if you have multiple name-based virtual hosts for the same host and port, and you enable it for any one of them, then it is enabled for all of them (with that host and port). It also means that if you attempt to enable the PROXY protocol in one and disable in the other, that won't work; in such a case, the last one wins and a notice will be logged indicating which setting was being overridden.
Listen 80
<VirtualHost *:80>
ServerName www.example.com
RemoteIPProxyProtocol On
#Requests to this virtual host must have a PROXY protocol
# header provided. If it is missing, the connection will
# be aborted
</VirtualHost>
Listen 8080
<VirtualHost *:8080>
ServerName www.example.com
RemoteIPProxyProtocol On
RemoteIPProxyProtocolExceptions 127.0.0.1 10.0.0.0/8
#Requests to this virtual host must have a PROXY protocol
# header provided. If it is missing, the connection will
# be aborted except when coming from localhost or the
# 10.x.x.x RFC1918 range
</VirtualHost>
| Description: | Disable processing of PROXY header for certain hosts or networks |
|---|---|
| Syntax: | RemoteIPProxyProtocolExceptions host|range [host|range] [host|range] |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_remoteip |
| Compatibility: | RemoteIPProxyProtocolExceptions is only available in httpd 2.4.31 and newer |
The RemoteIPProxyProtocol directive enables or
disables the reading and handling of the PROXY protocol connection header.
Sometimes it is desirable to require clients to provide the PROXY header, but
permit other clients to connect without it. This directive allows a server
administrator to configure a single host or CIDR range of hosts that may do
so. This is generally useful for monitoring and administrative traffic to a
virtual host direct to the server behind the upstream load balancer.
| Description: | Declare client intranet IP addresses trusted to present the RemoteIPHeader value |
|---|---|
| Syntax: | RemoteIPTrustedProxy proxy-ip|proxy-ip/subnet|hostname ... |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_remoteip |
The RemoteIPTrustedProxy directive adds one
or more addresses (or address blocks) to trust as presenting a valid
RemoteIPHeader value of the useragent IP. Unlike the
RemoteIPInternalProxy directive, any intranet
or private IP address reported by such proxies, including the 10/8, 172.16/12,
192.168/16, 169.254/16 and 127/8 blocks (or outside of the IPv6 public
2000::/3 block) are not trusted as the useragent IP, and are left in the
RemoteIPHeader header's value.
RemoteIPHeader X-Forwarded-For RemoteIPTrustedProxy 10.0.2.16/28 RemoteIPTrustedProxy proxy.example.com
| Description: | Declare client intranet IP addresses trusted to present the RemoteIPHeader value |
|---|---|
| Syntax: | RemoteIPTrustedProxyList filename |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_remoteip |
The RemoteIPTrustedProxyList directive specifies
a file parsed at startup, and builds a list of addresses (or address blocks)
to trust as presenting a valid RemoteIPHeader value of the useragent IP.
The '#' hash character designates a comment line, otherwise
each whitespace or newline separated entry is processed identically to
the RemoteIPTrustedProxy directive.
RemoteIPHeader X-Forwarded-For RemoteIPTrustedProxyList conf/trusted-proxies.lst
# Identified external proxies;
192.0.2.16/28 #wap phone group of proxies
proxy.isp.example.com #some well known ISP
Apache HTTP Server Version 2.4
| Description: | Caches a static list of files in memory |
|---|---|
| Status: | Experimental |
| Module Identifier: | file_cache_module |
| Source File: | mod_file_cache.c |
mod_file_cache, so read this document
carefully.
Caching frequently requested files that change very
infrequently is a technique for reducing server load.
mod_file_cache provides two techniques for caching
frequently requested static files. Through configuration
directives, you can direct mod_file_cache to either
open then mmap() a file, or to pre-open a file and save
the file's open file handle. Both techniques reduce server
load when processing requests for these files by doing part of the work
(specifically, the file I/O) for serving the file when the
server is started rather than during each request.
Notice: You cannot use this for speeding up CGI programs or other files which are served by special content handlers. It can only be used for regular files which are usually served by the Apache core content handler.
This module is an extension of and borrows heavily from the
mod_mmap_static module in Apache 1.3.
mod_file_cache caches a list of statically
configured files via MMapFile or CacheFile directives in the main server configuration.
Not all platforms support both directives. You will receive an error message in the server error log if you attempt to use an unsupported directive. If given an unsupported directive, the server will start but the file will not be cached. On platforms that support both directives, you should experiment with both to see which works best for you.
The MMapFile
directive of mod_file_cache maps a list of
statically configured files into memory through the system call
mmap(). This system call is available on most modern
Unix derivatives, but not on all. There are sometimes system-specific
limits on the size and number of files that can be
mmap()ed, experimentation is probably the easiest way
to find out.
This mmap()ing is done once at server start or
restart, only. So whenever one of the mapped files changes on the
filesystem you have to restart the server (see the Stopping and Restarting documentation).
To reiterate that point: if the files are modified in place
without restarting the server you may end up serving requests that
are completely bogus. You should update files by unlinking the old
copy and putting a new copy in place. Most tools such as
rdist and mv do this. The reason why this
modules doesn't take care of changes to the files is that this check
would need an extra stat() every time which is a waste
and against the intent of I/O reduction.
The CacheFile
directive of mod_file_cache opens an active
handle or file descriptor to the file (or files)
listed in the configuration directive and places these open file
handles in the cache. When the file is requested, the server
retrieves the handle from the cache and passes it to the
sendfile() (or TransmitFile() on Windows),
socket API.
This file handle caching is done once at server start or
restart, only. So whenever one of the cached files changes on
the filesystem you have to restart the server (see the
Stopping and Restarting
documentation). To reiterate that point: if the files are
modified in place without restarting the server you
may end up serving requests that are completely bogus. You
should update files by unlinking the old copy and putting a new
copy in place. Most tools such as rdist and
mv do this.
Don't bother asking for a directive which recursively
caches all the files in a directory. Try this instead... See the
Include directive, and consider
this command:
find /www/htdocs -type f -print \
| sed -e 's/.*/mmapfile &/' > /www/conf/mmap.conf
| Description: | Cache a list of file handles at startup time |
|---|---|
| Syntax: | CacheFile file-path [file-path] ... |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_file_cache |
The CacheFile directive opens handles to
one or more files (given as whitespace separated arguments) and
places these handles into the cache at server startup
time. Handles to cached files are automatically closed on a server
shutdown. When the files have changed on the filesystem, the
server should be restarted to re-cache them.
Be careful with the file-path arguments: They have
to literally match the filesystem path Apache's URL-to-filename
translation handlers create. We cannot compare inodes or other
stuff to match paths through symbolic links etc.
because that again would cost extra stat() system
calls which is not acceptable. This module may or may not work
with filenames rewritten by mod_alias or
mod_rewrite.
CacheFile /usr/local/apache/htdocs/index.html
| Description: | Map a list of files into memory at startup time |
|---|---|
| Syntax: | MMapFile file-path [file-path] ... |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_file_cache |
The MMapFile directive maps one or more files
(given as whitespace separated arguments) into memory at server
startup time. They are automatically unmapped on a server
shutdown. When the files have changed on the filesystem at
least a HUP or USR1 signal should be send to
the server to re-mmap() them.
Be careful with the file-path arguments: They have
to literally match the filesystem path Apache's URL-to-filename
translation handlers create. We cannot compare inodes or other
stuff to match paths through symbolic links etc.
because that again would cost extra stat() system
calls which is not acceptable. This module may or may not work
with filenames rewritten by mod_alias or
mod_rewrite.
MMapFile /usr/local/apache/htdocs/index.html
Apache HTTP Server Version 2.4
| Description: | Sends messages with server status to frontend proxy |
|---|---|
| Status: | Experimental |
| Module Identifier: | heartbeat_module |
| Source File: | mod_heartbeat |
| Compatibility: | Available in Apache 2.3 and later |
mod_heartbeat sends multicast messages to a mod_heartmonitor listener
that advertises the servers current connection count. Usually, mod_heartmonitor
will be running on a proxy server with mod_lbmethod_heartbeat loaded, which allows
ProxyPass to use the "heartbeat" lbmethod inside
of ProxyPass.
mod_heartbeat itself is loaded on the origin server(s) that serve requests
through the proxy server(s).
mod_heartbeat,
mod_status and mod_watchdog
must be either a static modules or, if a dynamic module, must
be loaded before mod_heartbeat.
Every 1 second, this module generates a single multicast UDP packet, containing the number of busy and idle workers. The packet is a simple ASCII format, similar to GET query parameters in HTTP.
v=1&ready=75&busy=0
Consumers should handle new variables besides busy and ready, separated by '&', being added in the future.
| Description: | Multicast address for heartbeat packets |
|---|---|
| Syntax: | HeartbeatAddress addr:port |
| Default: | disabled |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_heartbeat |
The HeartbeatAddress directive specifies the
multicast address to which mod_heartbeat will send
status information. This address will usually correspond to a configured
HeartbeatListen on a
frontend proxy system.
HeartbeatAddress 239.0.0.1:27999
Apache HTTP Server Version 2.4
| Description: | Pass the response body through an external program before delivery to the client |
|---|---|
| Status: | Extension |
| Module Identifier: | ext_filter_module |
| Source File: | mod_ext_filter.c |
mod_ext_filter presents a simple and familiar
programming model for filters. With
this module, a program which reads from stdin and writes to stdout
(i.e., a Unix-style filter command) can be a filter for
Apache. This filtering mechanism is much slower than using a
filter which is specially written for the Apache API and runs
inside of the Apache server process, but it does have the
following benefits:
Even when the performance characteristics are not suitable
for production use, mod_ext_filter can be used as
a prototype environment for filters.
# mod_ext_filter directive to define a filter
# to HTML-ize text/c files using the external
# program /usr/bin/enscript, with the type of
# the result set to text/html
ExtFilterDefine c-to-html mode=output \
intype=text/c outtype=text/html \
cmd="/usr/bin/enscript --color -w html -Ec -o -"
<Directory "/export/home/trawick/apacheinst/htdocs/c">
# core directive to cause the new filter to
# be run on output
SetOutputFilter c-to-html
# mod_mime directive to set the type of .c
# files to text/c
AddType text/c .c
</Directory>
Note: this gzip example is just for the purposes of illustration.
Please refer to mod_deflate for a practical
implementation.
# mod_ext_filter directive to define the external filter
ExtFilterDefine gzip mode=output cmd=/bin/gzip
<Location "/gzipped">
# core directive to cause the gzip filter to be
# run on output
SetOutputFilter gzip
# mod_headers directive to add
# "Content-Encoding: gzip" header field
Header set Content-Encoding gzip
</Location>
# mod_ext_filter directive to define a filter
# which runs everything through cat; cat doesn't
# modify anything; it just introduces extra pathlength
# and consumes more resources
ExtFilterDefine slowdown mode=output cmd=/bin/cat \
preservescontentlength
<Location "/">
# core directive to cause the slowdown filter to
# be run several times on output
#
SetOutputFilter slowdown;slowdown;slowdown
</Location>
# mod_ext_filter directive to define a filter which
# replaces text in the response
#
ExtFilterDefine fixtext mode=output intype=text/html \
cmd="/bin/sed s/verdana/arial/g"
<Location "/">
# core directive to cause the fixtext filter to
# be run on output
SetOutputFilter fixtext
</Location>
You can do the same thing using mod_substitute
without invoking an external process.
# Trace the data read and written by mod_deflate
# for a particular client (IP 192.168.1.31)
# experiencing compression problems.
# This filter will trace what goes into mod_deflate.
ExtFilterDefine tracebefore \
cmd="/bin/tracefilter.pl /tmp/tracebefore" \
EnableEnv=trace_this_client
# This filter will trace what goes after mod_deflate.
# Note that without the ftype parameter, the default
# filter type of AP_FTYPE_RESOURCE would cause the
# filter to be placed *before* mod_deflate in the filter
# chain. Giving it a numeric value slightly higher than
# AP_FTYPE_CONTENT_SET will ensure that it is placed
# after mod_deflate.
ExtFilterDefine traceafter \
cmd="/bin/tracefilter.pl /tmp/traceafter" \
EnableEnv=trace_this_client ftype=21
<Directory "/usr/local/docs">
SetEnvIf Remote_Addr 192.168.1.31 trace_this_client
SetOutputFilter tracebefore;deflate;traceafter
</Directory>
#!/usr/local/bin/perl -w
use strict;
open(SAVE, ">$ARGV[0]")
or die "can't open $ARGV[0]: $?";
while (<STDIN>) {
print SAVE $_;
print $_;
}
close(SAVE);
| Description: | Define an external filter |
|---|---|
| Syntax: | ExtFilterDefine filtername parameters |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ext_filter |
The ExtFilterDefine directive defines the
characteristics of an external filter, including the program to
run and its arguments.
filtername specifies the name of the filter being
defined. This name can then be used in SetOutputFilter
directives. It must be unique among all registered filters.
At the present time, no error is reported by the
register-filter API, so a problem with duplicate names isn't
reported to the user.
Subsequent parameters can appear in any order and define the
external command to run and certain other characteristics. The
only required parameter is cmd=. These parameters
are:
cmd=cmdlinecmd= keyword allows you to specify the
external command to run. If there are arguments after the
program name, the command line should be surrounded in
quotation marks (e.g., cmd="/bin/mypgm
arg1 arg2".) Normal shell quoting is
not necessary since the program is run directly, bypassing the shell.
Program arguments are blank-delimited. A backslash can be used to
escape blanks which should be part of a program argument. Any
backslashes which are part of the argument must be escaped with
backslash themselves. In addition to the standard CGI environment
variables, DOCUMENT_URI, DOCUMENT_PATH_INFO, and
QUERY_STRING_UNESCAPED will also be set for the program.mode=modemode=output (the default) for filters which
process the response. Use mode=input for filters
which process the request. mode=input is available
in Apache 2.1 and later.intype=imtintype= is
specified, the filter will be disabled for documents of other
types.outtype=imtPreservesContentLengthPreservesContentLength keyword specifies
that the filter preserves the content length. This is not the
default, as most filters change the content length. In the
event that the filter doesn't modify the length, this keyword
should be specified.ftype=filtertypedisableenv=envenableenv=env| Description: | Configure mod_ext_filter options |
|---|---|
| Syntax: | ExtFilterOptions option [option] ... |
| Default: | ExtFilterOptions NoLogStderr |
| Context: | directory |
| Status: | Extension |
| Module: | mod_ext_filter |
The ExtFilterOptions directive specifies
special processing options for mod_ext_filter.
Option can be one of
LogStderr | NoLogStderrLogStderr keyword specifies that
messages written to standard error by the external filter
program will be saved in the Apache error log.
NoLogStderr disables this feature.Onfail=[abort|remove]abort (the default value)
the request will be aborted. With remove, the
filter is removed and the request continues without it.ExtFilterOptions LogStderr
Messages written to the filter's standard error will be stored in the Apache error log.
Apache HTTP Server Version 2.4
| Description: | Server-side imagemap processing |
|---|---|
| Status: | Base |
| Module Identifier: | imagemap_module |
| Source File: | mod_imagemap.c |
This module processes .map files, thereby
replacing the functionality of the imagemap CGI
program. Any directory or document type configured to use the
handler imap-file (using either
AddHandler or
SetHandler)
will be processed by this module.
The following directive will activate files ending with
.map as imagemap files:
AddHandler imap-file map
Note that the following is still supported:
AddType application/x-httpd-imap map
However, we are trying to phase out "magic MIME types" so we are deprecating this method.
The imagemap module adds some new features that were not possible with previously distributed imagemap programs.
<base> assignment through a new map
directive base.imagemap.conf file.The lines in the imagemap files can have one of several formats:
directive value [x,y ...]
directive value "Menu text" [x,y
...]
directive value x,y ... "Menu text"
The directive is one of base,
default, poly, circle,
rect, or point. The value is an
absolute or relative URL, or one of the special values listed
below. The coordinates are x,y
pairs separated by whitespace. The quoted text is used as the text of
the link if a imagemap menu is generated. Lines beginning with '#' are
comments.
There are six directives allowed in the imagemap file. The directives can come in any order, but are processed in the order they are found in the imagemap file.
base DirectiveHas the effect of <base href="value">
. The non-absolute URLs of the map-file are taken relative
to this value. The base directive overrides
ImapBase as set in a
.htaccess file or in the server configuration files.
In the absence of an ImapBase configuration
directive, base defaults to
http://server_name/.
base_uri is synonymous with base.
Note that a trailing slash on the URL is significant.
default Directivepoly, circle or
rect directives, and there are no
point directives. Defaults to nocontent
in the absence of an ImapDefault configuration setting, causing a status
code of 204 No Content to be returned. The client
should keep the same page displayed.poly Directivecirclerect Directivepoint Directivedefault will not be
followed if a point directive is present and
valid coordinates are given.The values for each of the directives can be any of the following:
The URL can be relative or absolute URL. Relative URLs
can contain '..' syntax and will be resolved relative to the
base value.
base itself will not be resolved according to the
current value. A statement base mailto: will
work properly, though.
mapImapMenu is set to
none.menumap.refererhttp://servername/ if no Referer:
header was present.nocontent204 No Content,
telling the client to keep the same page displayed. Valid for
all but base.error500 Server Error. Valid for all
but base, but sort of silly for anything but
default.0,0 200,2000,0, it is as if no coordinate had been
selected."Menu Text"After the value or after the coordinates, the line optionally may contain text within double quotes. This string is used as the text for the link if a menu is generated:
<a href="http://example.com/">Menu text</a>
If no quoted text is present, the name of the link will be used as the text:
<a href="http://example.com/">http://example.com</a>
If you want to use double quotes within this text, you have to
write them as ".
#Comments are printed in a 'formatted' or 'semiformatted' menu.
#And can contain html tags. <hr>
base referer
poly map "Could I have a menu, please?" 0,0 0,10 10,10 10,0
rect .. 0,0 77,27 "the directory of the referer"
circle http://www.inetnebr.example.com/lincoln/feedback/ 195,0 305,27
rect another_file "in same directory as referer" 306,0 419,27
point http://www.zyzzyva.example.com/ 100,100
point http://www.tripod.example.com/ 200,200
rect mailto:nate@tripod.example.com 100,150 200,0 "Bugs?"
<a href="/maps/imagemap1.map">
<img ismap src="/images/imagemap1.gif">
</a>
<a href="/maps/imagemap1.map">
<img ismap="ismap" src="/images/imagemap1.gif" />
</a>
| Description: | Default base for imagemap files |
|---|---|
| Syntax: | ImapBase map|referer|URL |
| Default: | ImapBase http://servername/ |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_imagemap |
The ImapBase directive sets the default
base used in the imagemap files. Its value is
overridden by a base directive within the imagemap
file. If not present, the base defaults to
http://servername/.
| Description: | Default action when an imagemap is called with coordinates that are not explicitly mapped |
|---|---|
| Syntax: | ImapDefault error|nocontent|map|referer|URL |
| Default: | ImapDefault nocontent |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_imagemap |
The ImapDefault directive sets the default
default used in the imagemap files. Its value is
overridden by a default directive within the
imagemap file. If not present, the default action
is nocontent, which means that a 204 No
Content is sent to the client. In this case, the client
should continue to display the original page.
| Description: | Action if no coordinates are given when calling an imagemap |
|---|---|
| Syntax: | ImapMenu none|formatted|semiformatted|unformatted |
| Default: | ImapMenu formatted |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Indexes |
| Status: | Base |
| Module: | mod_imagemap |
The ImapMenu directive determines the
action taken if an imagemap file is called without valid
coordinates.
nonenone, no menu is generated,
and the default action is performed.formattedformatted menu is the simplest menu.
Comments in the imagemap file are ignored. A level one header
is printed, then an hrule, then the links each on a separate
line. The menu has a consistent, plain look close to that of
a directory listing.semiformattedsemiformatted menu, comments are
printed where they occur in the imagemap file. Blank lines
are turned into HTML breaks. No header or hrule is printed,
but otherwise the menu is the same as a
formatted menu.unformattedApache HTTP Server Version 2.4
| Description: | Customization of HTTP request and response headers |
|---|---|
| Status: | Extension |
| Module Identifier: | headers_module |
| Source File: | mod_headers.c |
This module provides directives to control and modify HTTP request and response headers. Headers can be merged, replaced or removed.
The directives provided by mod_headers can
occur almost anywhere within the server configuration, and can be
limited in scope by enclosing them in configuration sections.
Order of processing is important and is affected both by the order in the configuration file and by placement in configuration sections. These two directives have a different effect if reversed:
RequestHeader append MirrorID "mirror 12" RequestHeader unset MirrorID
This way round, the MirrorID header is not set. If
reversed, the MirrorID header is set to "mirror 12".
mod_headers can be applied either early or late
in the request. The normal mode is late, when Request Headers are
set immediately before running the content generator and Response
Headers just as the response is sent down the wire. Always use
Late mode in an operational server.
Early mode is designed as a test/debugging aid for developers.
Directives defined using the early keyword are set
right at the beginning of processing the request. This means
they can be used to simulate different requests and set up test
cases, but it also means that headers may be changed at any time
by other modules before generating a Response.
Because early directives are processed before the request path's
configuration is traversed, early headers can only be set in a
main server or virtual host context. Early directives cannot depend
on a request path, so they will fail in contexts such as
<Directory> or
<Location>.
Header echo ^TS
MyHeader, to the response including a
timestamp for when the request was received and how long it
took to begin serving the request. This header can be used by
the client to intuit load on the server or in isolating
bottlenecks between the client and the server.
Header set MyHeader "%D %t"
results in this header being added to the response:
MyHeader: D=3775428 t=991424704447256
Header set MyHeader "Hello Joe. It took %D microseconds for Apache to serve this request."
results in this header being added to the response:
MyHeader: Hello Joe. It took D=3775428 microseconds for Apache
to serve this request.
MyHeader on the response if and
only if header MyRequestHeader is present on the request.
This is useful for constructing headers in response to some client
stimulus. Note that this example requires the services of the
mod_setenvif module.
SetEnvIf MyRequestHeader myvalue HAVE_MyRequestHeader Header set MyHeader "%D %t mytext" env=HAVE_MyRequestHeader
If the header MyRequestHeader: myvalue is present on
the HTTP request, the response will contain the following header:
MyHeader: D=3775428 t=991424704447256 mytext
RequestHeader edit Destination ^https: http: early
CGI, NO_CACHE and
NO_STORE environment variables all existed for the
request):
Header merge Cache-Control no-cache env=CGI Header merge Cache-Control no-cache env=NO_CACHE Header merge Cache-Control no-store env=NO_STORE
then the response would contain the following header:
Cache-Control: no-cache, no-store
If append was used instead of merge,
then the response would contain the following header:
Cache-Control: no-cache, no-cache, no-store
Header set Set-Cookie testcookie "expr=-z %{req:Cookie}"
Header append Cache-Control s-maxage=600 "expr=%{REQUEST_STATUS} == 200"
| Description: | Configure HTTP response headers |
|---|---|
| Syntax: | Header [condition] add|append|echo|edit|edit*|merge|set|setifempty|unset|note
header [[expr=]value [replacement]
[early|env=[!]varname|expr=expression]]
|
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_headers |
| Compatibility: | SetIfEmpty available in 2.4.7 and later, expr=value available in 2.4.10 and later |
This directive can replace, merge or remove HTTP response headers. The header is modified just after the content handler and output filters are run, allowing outgoing headers to be modified.
The optional condition argument determines which internal
table of responses headers this directive will operate against:
onsuccess (default, can be omitted) or always.
The difference between the two lists is that the headers contained in the
latter are added to the response even on error, and persisted across
internal redirects (for example, ErrorDocument handlers).
Note also that repeating this directive with both conditions makes sense in
some scenarios because always is not a superset of
onsuccess with respect to existing headers:
always is used in the ultimate response.mod_proxy_fcgi,
in which case the CGI scripts' headers are in the table corresponding to
always and not in the default table.onsuccess condition.This difference between onsuccess and always is
a feature that resulted as a consequence of how httpd internally stores
headers for a HTTP response, since it does not offer any "normalized" single
list of headers. The main problem that can arise if the following concept
is not kept in mind while writing the configuration is that some HTTP responses
might end up with the same header duplicated (confusing users or sometimes even
HTTP clients). For example, suppose that you have a simple PHP proxy setup with
mod_proxy_fcgi and your backend PHP scripts adds the
X-Foo: bar header to each HTTP response. As described above,
mod_proxy_fcgi uses the always table to store
headers, so a configuration like the following ends up in the wrong result, namely
having the header duplicated with both values:
# X-Foo's value is set in the 'onsuccess' headers table Header set X-Foo: baz
To circumvent this limitation, there are some known configuration patterns that can help, like the following:
# 'onsuccess' can be omitted since it is the default Header onsuccess unset X-Foo Header always set X-Foo "baz"
Separately from the condition parameter described above, you can limit an action based on HTTP status codes for e.g. proxied or CGI requests. See the example that uses %{REQUEST_STATUS} in the section above.
The action it performs is determined by the first argument (second argument if a condition is specified). This can be one of the following values:
Please read the difference between always
and onsuccess headers list described above
before start reading the actions list, since that important
concept still applies. Each action, in fact, works as described
but only on the target headers list.
addset,
append or merge should be used instead.appendechoeditedit*edit form will match and replace exactly once
in a header value, whereas the edit* form will replace
every instance of the search pattern if it appears more
than once.mergesetsetifemptysetifempty is evaluated.
It is safer to use set for this use case like in the
following example:
Header set Content-Type "text/plain" "expr=-z %{CONTENT_TYPE}"
unsetnoteThis argument is followed by a header name, which
can include the final colon, but it is not required. Case is
ignored for set, append, merge,
add, unset and edit.
The header name for echo
is case sensitive and may be a regular
expression.
For set, append, merge and
add a value is specified as the next argument.
If value
contains spaces, it should be surrounded by double quotes.
value may be a character string, a string containing
mod_headers specific format specifiers (and character
literals), or an ap_expr expression prefixed
with expr=
The following format specifiers are supported in value:
| Format | Description |
|---|---|
%% |
The percent sign |
%t |
The time the request was received in Universal Coordinated Time
since the epoch (Jan. 1, 1970) measured in microseconds. The value
is preceded by t=. |
%D |
The time from when the request was received to the time the
headers are sent on the wire. This is a measure of the duration
of the request. The value is preceded by D=.
The value is measured in microseconds. |
%l |
The current load averages of the actual server itself. It is
designed to expose the values obtained by getloadavg()
and this represents the current load average, the 5 minute average, and
the 15 minute average. The value is preceded by l= with each
average separated by /.Available in 2.4.4 and later. |
%i |
The current idle percentage of httpd (0 to 100) based on available
processes and threads. The value is preceded by i=.Available in 2.4.4 and later. |
%b |
The current busy percentage of httpd (0 to 100) based on available
processes and threads. The value is preceded by b=.Available in 2.4.4 and later. |
%{VARNAME}e |
The contents of the environment
variable VARNAME. |
%{VARNAME}s |
The contents of the SSL environment
variable VARNAME, if mod_ssl is enabled. |
The %s format specifier is only available in
Apache 2.1 and later; it can be used instead of %e
to avoid the overhead of enabling SSLOptions
+StdEnvVars. If SSLOptions +StdEnvVars must
be enabled anyway for some other reason, %e will be
more efficient than %s.
When the value parameter uses the ap_expr parser, some expression syntax will differ from examples that evaluate boolean expressions such as <If>:
Header set foo-checksum "expr=%{md5:foo}"
For edit there is both a value argument
which is a regular expression,
and an additional replacement string. As of version 2.4.7
the replacement string may also contain format specifiers.
The Header directive may be followed by
an additional argument, which may be any of:
earlyenv=[!]varnamevarname exists.
A ! in front of varname reverses the test,
so the directive applies only if varname is unset.expr=expression# This delays the evaluation of the condition clause compared to <If>
Header always set CustomHeader my-value "expr=%{REQUEST_URI} =~ m#^/special_path.php$#"
Except in early mode, the
Header directives are processed just
before the response is sent to the network. This means that it is
possible to set and/or override most headers, except for some headers
added by the HTTP header filter. Prior to 2.2.12, it was not possible
to change the Content-Type header with this directive.
| Description: | Configure HTTP request headers |
|---|---|
| Syntax: | RequestHeader add|append|edit|edit*|merge|set|setifempty|unset
header [[expr=]value [replacement]
[early|env=[!]varname|expr=expression]]
|
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_headers |
| Compatibility: | SetIfEmpty available in 2.4.7 and later, expr=value available in 2.4.10 and later |
This directive can replace, merge, change or remove HTTP request headers. The header is modified just before the content handler is run, allowing incoming headers to be modified. The action it performs is determined by the first argument. This can be one of the following values:
addset,
append or merge should be used instead.appendeditedit*edit form will match and replace exactly once
in a header value, whereas the edit* form will replace
every instance of the search pattern if it appears more
than once.mergesetsetifemptyunsetThis argument is followed by a header name, which can
include the final colon, but it is not required. Case is
ignored. For set, append, merge and
add a value is given as the third argument. If a
value contains spaces, it should be surrounded by double
quotes. For unset, no value should be given.
value may be a character string, a string containing format
specifiers or a combination of both. The supported format specifiers
are the same as for the Header,
please have a look there for details. For edit both
a value and a replacement are required, and are
a regular expression and a
replacement string respectively.
The RequestHeader directive may be followed by
an additional argument, which may be any of:
earlyenv=[!]varnamevarname exists.
A ! in front of varname reverses the test,
so the directive applies only if varname is unset.expr=expressionExcept in early mode, the
RequestHeader directive is processed
just before the request is run by its handler in the fixup phase.
This should allow headers generated by the browser, or by Apache
input filters to be overridden or modified.
Apache HTTP Server Version 2.4
| Description: | RFC 1413 ident lookups |
|---|---|
| Status: | Extension |
| Module Identifier: | ident_module |
| Source File: | mod_ident.c |
| Compatibility: | Available in Apache 2.1 and later |
This module queries an RFC 1413 compatible daemon on a remote host to look up the owner of a connection.
| Description: | Enables logging of the RFC 1413 identity of the remote user |
|---|---|
| Syntax: | IdentityCheck On|Off |
| Default: | IdentityCheck Off |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_ident |
| Compatibility: | Moved out of core in Apache 2.1 |
This directive enables RFC 1413-compliant logging of the remote user name for each
connection, where the client machine runs identd or something similar.
This information is logged in the access log using the %...l
format string.
Note that this can cause serious latency problems accessing
your server since every request requires one of these lookups
to be performed. When firewalls or proxy servers are involved,
each lookup might possibly fail and add a latency duration as
defined by the IdentityCheckTimeout directive to each hit. So in
general this is not very useful on public servers accessible from
the Internet.
| Description: | Determines the timeout duration for ident requests |
|---|---|
| Syntax: | IdentityCheckTimeout seconds |
| Default: | IdentityCheckTimeout 30 |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_ident |
This directive specifies the timeout duration of an ident request. The default value of 30 seconds is recommended by RFC 1413, mainly because of possible network latency. However, you may want to adjust the timeout value according to your local network speed.
Apache HTTP Server Version 2.4
| Description: | Server-parsed html documents (Server Side Includes) |
|---|---|
| Status: | Base |
| Module Identifier: | include_module |
| Source File: | mod_include.c |
This module provides a filter which will process files before they are sent to the client. The processing is controlled by specially formatted SGML comments, referred to as elements. These elements allow conditional text, the inclusion of other files or programs, as well as the setting and printing of environment variables.
Enabling Server-Side Includes PATH_INFO with Server Side Includes Available Elements Include Variables Variable Substitution Flow Control Elements Legacy expression syntax SSIEndTag SSIErrorMsg SSIETag SSILastModified SSILegacyExprParser SSIStartTag SSITimeFormat SSIUndefinedEcho XBitHackServer Side Includes are implemented by the
INCLUDES filter. If
documents containing server-side include directives are given
the extension .shtml, the following directives will make Apache
parse them and assign the resulting document the mime type of
text/html:
AddType text/html .shtml AddOutputFilter INCLUDES .shtml
The following directive must be given for the directories
containing the shtml files (typically in a
<Directory> section,
but this directive is also valid in .htaccess files if
AllowOverride Options
is set):
Options +Includes
For backwards compatibility, the server-parsed
handler also activates the
INCLUDES filter. As well, Apache will activate the INCLUDES
filter for any document with mime type
text/x-server-parsed-html or
text/x-server-parsed-html3 (and the resulting
output will have the mime type text/html).
For more information, see our Tutorial on Server Side Includes.
Files processed for server-side includes no longer accept
requests with PATH_INFO (trailing pathname information)
by default. You can use the AcceptPathInfo directive to
configure the server to accept requests with PATH_INFO.
The document is parsed as an HTML document, with special commands embedded as SGML comments. A command has the syntax:
<!--#element attribute=value
attribute=value ... -->
The value will often be enclosed in double quotes, but single
quotes (') and backticks (`) are also
possible. Many commands only allow a single attribute-value pair.
Note that the comment terminator (-->) should be
preceded by whitespace to ensure that it isn't considered part of
an SSI token. Note that the leading <!--# is one
token and may not contain any whitespaces.
The allowed elements are listed in the following table:
| Element | Description |
|---|---|
comment |
SSI comment |
config |
configure output formats |
echo |
print variables |
exec |
execute external programs |
fsize |
print size of a file |
flastmod |
print last modification time of a file |
include |
include a file |
printenv |
print all available variables |
set |
set a value of a variable |
SSI elements may be defined by modules other than
mod_include. In fact, the exec element is provided by
mod_cgi, and will only be available if this
module is loaded.
This command doesn't output anything. Its only use is to add comments within a file. These comments are not printed.
This syntax is available in version 2.4.21 and later.
<!--#comment Blah Blah Blah -->
or
<!--#comment text="Blah Blah Blah" -->
This command controls various aspects of the parsing. The valid attributes are:
echomsg (Apache 2.1 and later)The value is a message that is sent back to the
client if the echo element
attempts to echo an undefined variable. This overrides any SSIUndefinedEcho directives.
<!--#config echomsg="[Value Undefined]" -->
errmsgThe value is a message that is sent back to the
client if an error occurs while parsing the
document. This overrides any SSIErrorMsg directives.
<!--#config errmsg="[Oops, something broke.]" -->
sizefmtThe value sets the format to be used when displaying
the size of a file. Valid values are bytes
for a count in bytes, or abbrev for a count
in Kb or Mb as appropriate, for example a size of 1024 bytes
will be printed as "1K".
<!--#config sizefmt="abbrev" -->
timefmtThe value is a string to be used by the
strftime(3) library routine when printing
dates.
<!--#config timefmt=""%R, %B %d, %Y"" -->
This command prints one of the include
variables defined below. If the variable is unset, the result is
determined by the SSIUndefinedEcho directive. Any dates printed are
subject to the currently configured timefmt.
Attributes:
vardecodingSpecifies whether Apache should strip an encoding from
the variable before processing the variable further. The default
is none, where no decoding will be done. If set to
url, then URL decoding (also known as %-encoding;
this is appropriate for use within URLs in links, etc.) will be
performed. If set to urlencoded,
application/x-www-form-urlencoded compatible encoding (found in
query strings) will be stripped. If set to base64,
base64 will be decoded, and if set to entity, HTML
entity encoding will be stripped. Decoding is done prior to any
further encoding on the variable. Multiple encodings can be
stripped by specifying more than one comma separated encoding.
The decoding setting will remain in effect until the next decoding
attribute is encountered, or the element ends.
The decoding attribute must precede the
corresponding var attribute to be effective.
encodingSpecifies how Apache should encode special characters
contained in the variable before outputting them. If set
to none, no encoding will be done. If set to
url, then URL encoding (also known as %-encoding;
this is appropriate for use within URLs in links, etc.) will be
performed. If set to urlencoded,
application/x-www-form-urlencoded compatible encoding will be
performed instead, and should be used with query strings. If set
to base64, base64 encoding will be performed. At
the start of an echo element, the default is set to
entity, resulting in entity encoding (which is
appropriate in the context of a block-level HTML element,
e.g. a paragraph of text). This can be changed by adding
an encoding attribute, which will remain in effect
until the next encoding attribute is encountered or
the element ends, whichever comes first.
The encoding attribute must precede the
corresponding var attribute to be effective.
<!--#echo encoding="entity" var="QUERY_STRING" -->
The exec command executes a given shell command or
CGI script. It requires mod_cgi to be present
in the server. If Options
IncludesNOEXEC is set, this command is completely
disabled. The valid attributes are:
cgiThe value specifies a (%-encoded) URL-path to
the CGI script. If the path does not begin with a slash (/),
then it is taken to be relative to the current
document. The document referenced by this path is
invoked as a CGI script, even if the server would not
normally recognize it as such. However, the directory
containing the script must be enabled for CGI scripts
(with ScriptAlias
or Options
ExecCGI).
The CGI script is given the PATH_INFO and query
string (QUERY_STRING) of the original request from the
client; these cannot be specified in the URL path. The
include variables will be available to the script in addition to
the standard CGI environment.
<!--#exec cgi="/cgi-bin/example.cgi" -->
If the script returns a Location: header instead of
output, then this will be translated into an HTML anchor.
The include virtual
element should be used in preference to exec cgi. In
particular, if you need to pass additional arguments to a CGI program,
using the query string, this cannot be done with exec
cgi, but can be done with include virtual, as
shown here:
<!--#include virtual="/cgi-bin/example.cgi?argument=value" -->
cmdThe server will execute the given string using
/bin/sh. The include variables are available to the command, in addition
to the usual set of CGI variables.
The use of #include virtual is almost always preferred to using
either #exec cgi or #exec cmd. The former
(#include virtual) uses the standard Apache sub-request
mechanism to include files or scripts. It is much better tested and
maintained.
In addition, on some platforms, like Win32, and on unix when
using suexec, you cannot pass arguments
to a command in an exec directive, or otherwise include
spaces in the command. Thus, while the following will work under a
non-suexec configuration on unix, it will not produce the desired
result under Win32, or when running suexec:
<!--#exec cmd="perl /path/to/perlscript arg1 arg2" -->
This command prints the size of the specified file, subject
to the sizefmt format specification. Attributes:
file
This file is <!--#fsize file="mod_include.html" --> bytes.
file cannot start with a slash
(/), nor can it contain ../ so as to
refer to a file above the current directory or outside of the
document root. Attempting to so will result in the error message:
The given path was above the root path.
virtual
This file is <!--#fsize virtual="/docs/mod/mod_include.html" --> bytes.
Note that in many cases these two are exactly the same thing.
However, the file attribute doesn't respect URL-space
aliases.
This command prints the last modification date of the
specified file, subject to the timefmt format
specification. The attributes are the same as for the
fsize command.
This command inserts the text of another document or file
into the parsed file. Any included file is subject to the usual
access control. If the directory containing the parsed file has
Options
IncludesNOEXEC set, then only documents with a text
MIME-type (text/plain,
text/html etc.) will be included. Otherwise CGI
scripts are invoked as normal using the complete URL given in
the command, including any query string.
An attribute defines the location of the document, and may appear more than once in an include element; an inclusion is done for each attribute given to the include command in turn. The valid attributes are:
file../, nor can it be an absolute path.
Therefore, you cannot include files that are outside of the
document root, or above the current document in the directory
structure. The virtual attribute should always be
used in preference to this one.virtualThe value is a (%-encoded) URL-path. The URL cannot contain a scheme or hostname, only a path and an optional query string. If it does not begin with a slash (/) then it is taken to be relative to the current document.
A URL is constructed from the attribute, and the output the server would return if the URL were accessed by the client is included in the parsed output. Thus included files can be nested.
If the specified URL is a CGI program, the program will be executed and its output inserted in place of the directive in the parsed file. You may include a query string in a CGI url:
<!--#include virtual="/cgi-bin/example.cgi?argument=value" -->
include virtual should be used in preference
to exec cgi to include the output of CGI programs
into an HTML document.
If the KeptBodySize
directive is correctly configured and valid for this included
file, attempts to POST requests to the enclosing HTML document
will be passed through to subrequests as POST requests as well.
Without the directive, all subrequests are processed as GET
requests.
onerrorThe value is a (%-encoded) URL-path which is shown should a previous attempt to include a file or virtual attribute failed. To be effective, this attribute must be specified after the file or virtual attributes being covered. If the attempt to include the onerror path fails, or if onerror is not specified, the default error message will be included.
# Simple example
<!--#include virtual="/not-exist.html" onerror="/error.html" -->
# Dedicated onerror paths
<!--#include virtual="/path-a.html" onerror="/error-a.html" virtual="/path-b.html" onerror="/error-b.html" -->
This prints out a plain text listing of all existing variables and
their values. Special characters are entity encoded (see the echo element for details)
before being output. There are no attributes.
<pre>
<!--#printenv -->
</pre>
This sets the value of a variable. Attributes:
varvaluedecodingSpecifies whether Apache should strip an encoding from
the variable before processing the variable further. The default
is none, where no decoding will be done. If set to
url, urlencoded, base64
or entity, URL decoding,
application/x-www-form-urlencoded decoding, base64 decoding or HTML
entity decoding will be performed respectively. More than one
decoding can be specified by separating with commas. The decoding
setting will remain in effect until the next decoding attribute
is encountered, or the element ends. The decoding
attribute must precede the corresponding
var attribute to be effective.
encodingSpecifies how Apache should encode special characters
contained in the variable before setting them. The default is
none, where no encoding will be done. If set to
url, urlencoding, base64
or entity, URL encoding,
application/x-www-form-urlencoded encoding, base64 encoding or
HTML entity encoding will be performed respectively. More than
one encoding can be specified by separating with commas. The
encoding setting will remain in effect until the next encoding
attribute is encountered, or the element ends. The
encoding attribute must precede the
corresponding var attribute to be effective.
Encodings are applied after all decodings have been
stripped.
<!--#set var="category" value="help" -->
In addition to the variables in the standard CGI environment,
these are available for the echo command, for
if and elif, and to any program
invoked by the document.
DATE_GMTDATE_LOCALDOCUMENT_ARGSinclude SSI directive, QUERY_STRING
will represent the query string of the subrequest and
DOCUMENT_ARGS will represent the query string of
the SSI document. (Available in Apache HTTP Server 2.4.19 and
later.)DOCUMENT_NAMEDOCUMENT_PATH_INFOAcceptPathInfo for more information
about PATH_INFO.DOCUMENT_URIalias or directoryindex), the modified
URL is shown.LAST_MODIFIEDQUERY_STRING_UNESCAPED& etc. are preceded by
backslashes). It is not set if a query string is not
present. Use DOCUMENT_ARGS if shell escaping
is not desired.USER_NAMEVariable substitution is done within quoted strings in most
cases where they may reasonably occur as an argument to an SSI
directive. This includes the config,
exec, flastmod, fsize,
include, echo, and set
directives. If SSILegacyExprParser is set to on,
substitution also occurs in the arguments to conditional operators.
You can insert a literal dollar sign into the string using backslash
quoting:
<!--#set var="cur" value="\$test" -->
If a variable reference needs to be substituted in the middle of a character sequence that might otherwise be considered a valid identifier in its own right, it can be disambiguated by enclosing the reference in braces, a la shell substitution:
<!--#set var="Zed" value="${REMOTE_HOST}_${REQUEST_METHOD}" -->
This will result in the Zed variable being set
to "X_Y" if REMOTE_HOST is
"X" and REQUEST_METHOD is
"Y".
The basic flow control elements are:
<!--#if expr="test_condition" -->
<!--#elif expr="test_condition" -->
<!--#else -->
<!--#endif -->
The if element works like an if statement in a
programming language. The test condition is evaluated and if
the result is true, then the text until the next elif,
else or endif element is included in the
output stream.
The elif or else statements are used
to put text into the output stream if the original
test_condition was false. These elements are optional.
The endif element ends the if element
and is required.
test_condition is a boolean expression which follows the
ap_expr syntax. The syntax can be changed
to be compatible with Apache HTTPD 2.2.x using SSILegacyExprParser.
The SSI variables set with the var element are exported
into the request environment and can be accessed with the
reqenv function. As a short-cut, the function name
v is also available inside mod_include.
The below example will print "from local net" if client IP address belongs to the 10.0.0.0/8 subnet.
<!--#if expr='-R "10.0.0.0/8"' -->
from local net
<!--#else -->
from somewhere else
<!--#endif -->
The below example will print "foo is bar" if the variable
foo is set to the value "bar".
<!--#if expr='v("foo") = "bar"' -->
foo is bar
<!--#endif -->
See also: Expressions in Apache HTTP Server,
for a complete reference and examples. The restricted functions
are not available inside mod_include
This section describes the syntax of the #if expr
element if SSILegacyExprParser
is set to on.
string-A stringtrue if the URL represented by the string is accessible by configuration, false otherwise. This is useful where content on a page is to be hidden from users who are not authorized to view the URL, such as a link to that URL. Note that the URL is only tested for whether access would be granted, not whether the URL exists.
<!--#if expr="-A /private" -->
Click <a href="/private">here</a> to access private
information.
<!--#endif -->
string1 = string2
string1 == string2
string1 != string2Compare string1 with string2. If
string2 has the form /string2/
then it is treated as a regular expression. Regular expressions are
implemented by the PCRE engine and
have the same syntax as those in perl
5. Note that == is just an alias for =
and behaves exactly the same way.
If you are matching positive (= or ==), you
can capture grouped parts of the regular expression. The captured parts
are stored in the special variables $1 ..
$9. The whole string matched by the regular expression is
stored in the special variable $0
<!--#if expr="$QUERY_STRING = /^sid=([a-zA-Z0-9]+)/" -->
<!--#set var="session" value="$1" -->
<!--#endif -->
string1 < string2
string1 <= string2
string1 > string2
string1 >= string2strcmp(3)). Therefore the string "100" is less than
"20".( test_condition )! test_conditiontest_condition1 &&
test_condition2test_condition1 ||
test_condition2"=" and "!=" bind more tightly than
"&&" and "||". "!" binds
most tightly. Thus, the following are equivalent:
<!--#if expr="$a = test1 && $b = test2" -->
<!--#if expr="($a = test1) && ($b = test2)" -->
The boolean operators && and ||
share the same priority. So if you want to bind such an operator more
tightly, you should use parentheses.
Anything that's not recognized as a variable or an operator
is treated as a string. Strings can also be quoted:
'string'. Unquoted strings can't contain whitespace
(blanks and tabs) because it is used to separate tokens such as
variables. If multiple strings are found in a row, they are
concatenated using blanks. So,
string1 string2 results in string1 string2
and
'string1 string2' results in string1 string2.
If the expressions become more complex and slow down processing significantly, you can try to optimize them according to the evaluation rules:
&& and ||)
are short circuited wherever possible. In conclusion with the rule
above that means, mod_include evaluates at first
the left expression. If the left result is sufficient to determine
the end result, processing stops here. Otherwise it evaluates the
right side and computes the end result from both left and right
results.$1 .. $9).If you want to look how a particular expression is handled, you can
recompile mod_include using the
-DDEBUG_INCLUDE compiler option. This inserts for every
parsed expression tokenizer information, the parse tree and how it is
evaluated into the output sent to the client.
All slashes which are not intended to act as delimiters in your regex must be escaped. This is regardless of their meaning to the regex engine.
| Description: | String that ends an include element |
|---|---|
| Syntax: | SSIEndTag tag |
| Default: | SSIEndTag "-->" |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_include |
This directive changes the string that mod_include
looks for to mark the end of an include element.
SSIEndTag "%>"
| Description: | Error message displayed when there is an SSI error |
|---|---|
| Syntax: | SSIErrorMsg message |
| Default: | SSIErrorMsg "[an error occurred while processing this
directive]" |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Base |
| Module: | mod_include |
The SSIErrorMsg directive changes the error
message displayed when mod_include encounters an
error. For production servers you may consider changing the default
error message to "<!-- Error -->" so that
the message is not presented to the user.
This directive has the same effect as the <!--#config
errmsg=message --> element.
SSIErrorMsg "<!-- Error -->"
| Description: | Controls whether ETags are generated by the server. |
|---|---|
| Syntax: | SSIETag on|off |
| Default: | SSIETag off |
| Context: | directory, .htaccess |
| Status: | Base |
| Module: | mod_include |
| Compatibility: | Available in version 2.2.15 and later. |
Under normal circumstances, a file filtered by mod_include
may contain elements that are either dynamically generated, or that may
have changed independently of the original file. As a result, by default
the server is asked not to generate an ETag header for the
response by adding no-etag to the request notes.
The SSIETag directive suppresses this
behaviour, and allows the server to generate an ETag header.
This can be used to enable caching of the output. Note that a backend server
or dynamic content generator may generate an ETag of its own, ignoring
no-etag, and this ETag will be passed by
mod_include regardless of the value of this setting.
SSIETag can take on the following values:
offno-etag will be added to the request notes, and the server
is asked not to generate an ETag. Where a server ignores the value of
no-etag and generates an ETag anyway, the ETag will be
respected.on| Description: | Controls whether Last-Modified headers are generated by the
server. |
|---|---|
| Syntax: | SSILastModified on|off |
| Default: | SSILastModified off |
| Context: | directory, .htaccess |
| Status: | Base |
| Module: | mod_include |
| Compatibility: | Available in version 2.2.15 and later. |
Under normal circumstances, a file filtered by mod_include
may contain elements that are either dynamically generated, or that may
have changed independently of the original file. As a result, by default
the Last-Modified header is stripped from the response.
The SSILastModified directive overrides this
behaviour, and allows the Last-Modified header to be respected
if already present, or set if the header is not already present. This can
be used to enable caching of the output. SSILastModified
can take on the following values:
offLast-Modified header will be stripped from responses,
unless the XBitHack directive
is set to full as described below.onLast-Modified header will be respected if already
present in a response, and added to the response if the response is a
file and the header is missing. The
SSILastModified directive
takes precedence over XBitHack.| Description: | Enable compatibility mode for conditional expressions. |
|---|---|
| Syntax: | SSILegacyExprParser on|off |
| Default: | SSILegacyExprParser off |
| Context: | directory, .htaccess |
| Status: | Base |
| Module: | mod_include |
| Compatibility: | Available in version 2.3.13 and later. |
As of version 2.3.13, mod_include has switched to the
new ap_expr syntax for conditional expressions
in #if flow control elements. This directive allows to
switch to the old syntax which is compatible
with Apache HTTPD version 2.2.x and earlier.
| Description: | String that starts an include element |
|---|---|
| Syntax: | SSIStartTag tag |
| Default: | SSIStartTag "<!--#" |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_include |
This directive changes the string that mod_include
looks for to mark an include element to process.
You may want to use this option if you have 2 servers parsing the output of a file each processing different commands (possibly at different times).
SSIStartTag "<%" SSIEndTag "%>"
The example given above, which also specifies a matching
SSIEndTag, will
allow you to use SSI directives as shown in the example
below:
<%printenv %>
| Description: | Configures the format in which date strings are displayed |
|---|---|
| Syntax: | SSITimeFormat formatstring |
| Default: | SSITimeFormat "%A, %d-%b-%Y %H:%M:%S %Z" |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Base |
| Module: | mod_include |
This directive changes the format in which date strings are displayed
when echoing DATE environment variables. The
formatstring is as in strftime(3) from the
C standard library.
This directive has the same effect as the <!--#config
timefmt=formatstring --> element.
SSITimeFormat "%R, %B %d, %Y"
The above directive would cause times to be displayed in the format "22:26, June 14, 2002".
| Description: | String displayed when an unset variable is echoed |
|---|---|
| Syntax: | SSIUndefinedEcho string |
| Default: | SSIUndefinedEcho "(none)" |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Base |
| Module: | mod_include |
This directive changes the string that mod_include
displays when a variable is not set and "echoed".
SSIUndefinedEcho "<!-- undef -->"
| Description: | Parse SSI directives in files with the execute bit set |
|---|---|
| Syntax: | XBitHack on|off|full |
| Default: | XBitHack off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Base |
| Module: | mod_include |
The XBitHack directive controls the parsing
of ordinary html documents. This directive only affects files associated
with the MIME-type text/html. XBitHack can take on the following values:
offontext/html file that has the user-execute bit
set will be treated as a server-parsed html document.fullon but also test the group-execute bit.
If it is set, then set the Last-modified date of the
returned file to be the last modified time of the file. If
it is not set, then no last-modified date is sent. Setting
this bit allows clients and proxies to cache the result of
the request.
You would not want to use the full option, unless you assure the
group-execute bit is unset for every SSI script which might #include a CGI or otherwise produces different output on
each hit (or could potentially change on subsequent requests).
The SSILastModified
directive takes precedence over the
XBitHack directive when
SSILastModified is set to
on.
Apache HTTP Server Version 2.4
| Description: | Pending Request Counting load balancer scheduler algorithm for mod_proxy_balancer |
|---|---|
| Status: | Extension |
| Module Identifier: | lbmethod_bybusyness_module |
| Source File: | mod_lbmethod_bybusyness.c |
| Compatibility: | Split off from mod_proxy_balancer in 2.3 |
This module does not provide any configuration directives of its own.
It requires the services of mod_proxy_balancer, and
provides the bybusyness load balancing method.
This module provides no directives.
Enabled via lbmethod=bybusyness, this scheduler keeps
track of how many requests each worker is currently assigned at present. A new
request is automatically assigned to the worker with the lowest
number of active requests. This is useful in the case of workers
that queue incoming requests independently of Apache, to ensure that
queue length stays even and a request is always given to the worker
most likely to service it the fastest and reduce latency.
In the case of multiple least-busy workers, the statistics (and
weightings) used by the Request Counting method are used to break the
tie. Over time, the distribution of work will come to resemble that
characteristic of byrequests (as implemented
by mod_lbmethod_byrequests).
Apache HTTP Server Version 2.4
| Description: | Heartbeat Traffic Counting load balancer scheduler algorithm for mod_proxy_balancer |
|---|---|
| Status: | Experimental |
| Module Identifier: | lbmethod_heartbeat_module |
| Source File: | mod_lbmethod_heartbeat.c |
| Compatibility: | Available in version 2.3 and later |
lbmethod=heartbeat uses the services of mod_heartmonitor to balance between origin servers that are providing
heartbeat info via the mod_heartbeat module.
This modules load balancing algorithm favors servers with more ready (idle) capacity over time, but does not select the server with the most ready capacity every time. Servers that have 0 active clients are penalized, with the assumption that they are not fully initialized.
| Description: | Path to read heartbeat data |
|---|---|
| Syntax: | HeartbeatStorage file-path |
| Default: | HeartbeatStorage logs/hb.dat |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_lbmethod_heartbeat |
The HeartbeatStorage directive specifies the
path to read heartbeat data. This flat-file is used only when
mod_slotmem_shm is not loaded.
Apache HTTP Server Version 2.4
| Description: | Additional configurable debug logging |
|---|---|
| Status: | Experimental |
| Module Identifier: | log_debug_module |
| Source File: | mod_log_debug.c |
| Compatibility: | Available in Apache 2.3.14 and later |
<Location "/foo/"> LogMessage "/foo/ has been requested" </Location>
<Location "/foo/">
LogMessage "subrequest to /foo/" hook=type_checker "expr=-T %{IS_SUBREQ}"
</Location>
The default log_transaction hook is not executed for sub-requests,
therefore we have to use a different hook.
LogMessage "IPv6 timeout from %{REMOTE_ADDR}" "expr=-T %{IPV6} && %{REQUEST_STATUS} = 408"
Note the placing of the double quotes for the expr= argument.
<Location "/">
LogMessage "%{reqenv:X-Foo}" hook=all
</Location>
Together with microsecond time stamps in the error log,
hook=all also lets you determine the times spent
in the different parts of the request processing.
| Description: | Log user-defined message to error log |
|---|---|
| Syntax: | LogMessage message
[hook=hook] [expr=expression]
|
| Default: | Unset |
| Context: | directory |
| Status: | Experimental |
| Module: | mod_log_debug |
This directive causes a user defined message to be logged to the error log. The message can use variables and functions from the ap_expr syntax. References to HTTP headers will not cause header names to be added to the Vary header. The messages are logged at loglevel info.
The hook specifies before which phase of request processing the message will be logged. The following hooks are supported:
| Name |
|---|
pre_translate_name |
translate_name |
type_checker |
quick_handler |
map_to_storage |
check_access |
check_access_ex |
insert_filter |
check_authn |
check_authz |
fixups |
handler |
log_transaction |
The default is log_transaction. The special value
all is also supported, causing a message to be logged at each
phase. Not all hooks are executed for every request.
The optional expression allows to restrict the message if a condition is met. The details of the expression syntax are described in the ap_expr documentation. References to HTTP headers will not cause the header names to be added to the Vary header.
Apache HTTP Server Version 2.4
| Description: | ISAPI Extensions within Apache for Windows |
|---|---|
| Status: | Base |
| Module Identifier: | isapi_module |
| Source File: | mod_isapi.c |
| Compatibility: | Win32 only |
This module implements the Internet Server extension API. It allows Internet Server extensions (e.g. ISAPI .dll modules) to be served by Apache for Windows, subject to the noted restrictions.
ISAPI extension modules (.dll files) are written by third parties. The Apache Group does not author these modules, so we provide no support for them. Please contact the ISAPI's author directly if you are experiencing problems running their ISAPI extension. Please do not post such problems to Apache's lists or bug reporting pages.
ISAPIAppendLogToErrors ISAPIAppendLogToQuery ISAPICacheFile ISAPIFakeAsync ISAPILogNotSupported ISAPIReadAheadBufferIn the server configuration file, use
the AddHandler directive to
associate ISAPI files with the isapi-handler handler, and map
it to them with their file extensions. To enable any .dll file to be
processed as an ISAPI extension, edit the httpd.conf file and add the
following line:
AddHandler isapi-handler .dll
isapi-isa was the proper handler name, rather than
isapi-handler. As of 2.3 development versions of the Apache
server, isapi-isa is no longer valid. You will need to
change your configuration to use isapi-handler
instead.There is no capability within the Apache server to leave a requested module loaded. However, you may preload and keep a specific module loaded by using the following syntax in your httpd.conf:
ISAPICacheFile c:/WebWork/Scripts/ISAPI/mytest.dll
Whether or not you have preloaded an ISAPI extension, all
ISAPI extensions are governed by the same permissions and
restrictions as CGI scripts. That is, Options ExecCGI must be set for the
directory that contains the ISAPI .dll file.
Review the Additional Notes and the Programmer's Journal for additional details
and clarification of the specific ISAPI support offered by
mod_isapi.
Apache's ISAPI implementation conforms to all of the ISAPI
2.0 specification, except for some "Microsoft-specific"
extensions dealing with asynchronous I/O. Apache's I/O model
does not allow asynchronous reading and writing in a manner
that the ISAPI could access. If an ISA tries to access
unsupported features, including async I/O, a message is placed
in the error log to help with debugging. Since these messages
can become a flood, the directive ISAPILogNotSupported
Off exists to quiet this noise.
Some servers, like Microsoft IIS, load the ISAPI extension
into the server and keep it loaded until memory usage is too
high, or unless configuration options are specified. Apache
currently loads and unloads the ISAPI extension each time it is
requested, unless the ISAPICacheFile directive is specified.
This is inefficient, but Apache's memory model makes this the
most effective method. Many ISAPI modules are subtly
incompatible with the Apache server, and unloading these
modules helps to ensure the stability of the server.
Also, remember that while Apache supports ISAPI Extensions, it does not support ISAPI Filters. Support for filters may be added at a later date, but no support is planned at this time.
If you are programming Apache 2.0 mod_isapi
modules, you must limit your calls to ServerSupportFunction
to the following directives:
HSE_REQ_SEND_URL_REDIRECT_RESPhttp://server/location).HSE_REQ_SEND_URL/location).In their recent documentation, Microsoft appears to have
abandoned the distinction between the two
HSE_REQ_SEND_URL functions. Apache continues to treat
them as two distinct functions with different requirements
and behaviors.
HSE_REQ_SEND_RESPONSE_HEADERHSE_REQ_DONE_WITH_SESSIONHSE_REQ_MAP_URL_TO_PATHHSE_APPEND_LOG_PARAMETER\"%{isapi-parameter}n\" component in a
CustomLog
directive%q log component with the
ISAPIAppendLogToQuery
On directiveISAPIAppendLogToErrors On directiveThe first option, the %{isapi-parameter}n component,
is always available and preferred.
HSE_REQ_IS_KEEP_CONNHSE_REQ_SEND_RESPONSE_HEADER_EXfKeepConn
flag is ignored.HSE_REQ_IS_CONNECTEDApache returns FALSE to any unsupported call to
ServerSupportFunction, and sets the
GetLastError value to
ERROR_INVALID_PARAMETER.
ReadClient retrieves the request body exceeding the
initial buffer (defined by ISAPIReadAheadBuffer). Based on the
ISAPIReadAheadBuffer setting (number of bytes
to buffer prior to calling the ISAPI handler) shorter requests are sent
complete to the extension when it is invoked. If the request is
longer, the ISAPI extension must use ReadClient to
retrieve the remaining request body.
WriteClient is supported, but only with the
HSE_IO_SYNC flag or no option flag (value of
0). Any other WriteClient request
will be rejected with a return value of FALSE, and a
GetLastError value of
ERROR_INVALID_PARAMETER.
GetServerVariable is supported, although extended server
variables do not exist (as defined by other servers.) All the
usual Apache CGI environment variables are available from
GetServerVariable, as well as the ALL_HTTP
and ALL_RAW values.
Since httpd 2.0, mod_isapi supports additional
features introduced in later versions of the ISAPI specification,
as well as limited emulation of async I/O and the
TransmitFile semantics. Apache httpd also supports preloading
ISAPI .dlls for performance.
| Description: | Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the error log |
|---|---|
| Syntax: | ISAPIAppendLogToErrors on|off |
| Default: | ISAPIAppendLogToErrors off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_isapi |
Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
extensions to the server error log.
| Description: | Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the query field |
|---|---|
| Syntax: | ISAPIAppendLogToQuery on|off |
| Default: | ISAPIAppendLogToQuery on |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_isapi |
Record HSE_APPEND_LOG_PARAMETER requests from ISAPI
extensions to the query field (appended to the CustomLog %q
component).
| Description: | ISAPI .dll files to be loaded at startup |
|---|---|
| Syntax: | ISAPICacheFile file-path [file-path]
... |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_isapi |
Specifies a space-separated list of file names to be loaded
when the Apache server is launched, and remain loaded until the
server is shut down. This directive may be repeated for every
ISAPI .dll file desired. The full path name of each file should
be specified. If the path name is not absolute, it will be treated
relative to ServerRoot.
| Description: | Fake asynchronous support for ISAPI callbacks |
|---|---|
| Syntax: | ISAPIFakeAsync on|off |
| Default: | ISAPIFakeAsync off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_isapi |
While set to on, asynchronous support for ISAPI callbacks is simulated.
| Description: | Log unsupported feature requests from ISAPI extensions |
|---|---|
| Syntax: | ISAPILogNotSupported on|off |
| Default: | ISAPILogNotSupported off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_isapi |
Logs all requests for unsupported features from ISAPI extensions in the server error log. This may help administrators to track down problems. Once set to on and all desired ISAPI modules are functioning, it should be set back to off.
| Description: | Size of the Read Ahead Buffer sent to ISAPI extensions |
|---|---|
| Syntax: | ISAPIReadAheadBuffer size |
| Default: | ISAPIReadAheadBuffer 49152 |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_isapi |
Defines the maximum size of the Read Ahead Buffer sent to
ISAPI extensions when they are initially invoked. All remaining
data must be retrieved using the ReadClient callback; some
ISAPI extensions may not support the ReadClient function.
Refer questions to the ISAPI extension's author.
Apache HTTP Server Version 2.4
| Description: | Weighted Traffic Counting load balancer scheduler algorithm for mod_proxy_balancer |
|---|---|
| Status: | Extension |
| Module Identifier: | lbmethod_bytraffic_module |
| Source File: | mod_lbmethod_bytraffic.c |
| Compatibility: | Split off from mod_proxy_balancer in 2.3 |
This module does not provide any configuration directives of its own.
It requires the services of mod_proxy_balancer, and
provides the bytraffic load balancing method.
This module provides no directives.
Enabled via lbmethod=bytraffic, the idea behind this
scheduler is very similar to the Request Counting method, with
the following changes:
lbfactor is how much traffic, in bytes, we want this worker to handle. This is also a normalized value representing their "share" of the amount of work to be done, but instead of simply counting the number of requests, we take into account the amount of traffic this worker has either seen or produced.
If a balancer is configured as follows:
| worker | a | b | c |
|---|---|---|---|
| lbfactor | 1 | 2 | 1 |
Then we mean that we want b to process twice the amount of bytes than a or c should. It does not necessarily mean that b would handle twice as many requests, but it would process twice the I/O. Thus, the size of the request and response are applied to the weighting and selection algorithm.
Note: input and output bytes are weighted the same.
Apache HTTP Server Version 2.4
| Description: | Logging of the requests made to the server |
|---|---|
| Status: | Base |
| Module Identifier: | log_config_module |
| Source File: | mod_log_config.c |
This module provides for flexible logging of client requests. Logs are written in a customizable format, and may be written directly to a file, or to an external program. Conditional logging is provided so that individual requests may be included or excluded from the logs based on characteristics of the request.
Three directives are provided by this module:
TransferLog to create
a log file, LogFormat
to set a custom format, and CustomLog to define a log file and format in one
step. The TransferLog and CustomLog directives can be used multiple times in each
server to cause each request to be logged to multiple files.
The format argument to the LogFormat and CustomLog directives is a string. This string is
used to log each request to the log file. It can contain literal
characters copied into the log files and the C-style control
characters "\n" and "\t" to represent new-lines and tabs.
Literal quotes and backslashes should be escaped with
backslashes.
The characteristics of the request itself are logged by
placing "%" directives in the format string, which are
replaced in the log file by the values as follows:
| Format String | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
%% |
The percent sign. | ||||||||||
%a |
Client IP address of the request (see the
mod_remoteip module). | ||||||||||
%{c}a |
Underlying peer IP address of the connection (see the
mod_remoteip module). | ||||||||||
%A |
Local IP-address. | ||||||||||
%B |
Size of response in bytes, excluding HTTP headers. | ||||||||||
%b |
Size of response in bytes, excluding HTTP headers. In CLF format, i.e.
a '-' rather than a 0 when no bytes are sent. | ||||||||||
%{VARNAME}C |
The contents of cookie VARNAME in the request sent to the server. Only version 0 cookies are fully supported. | ||||||||||
%D |
The time taken to serve the request, in microseconds. | ||||||||||
%{VARNAME}e |
The contents of the environment variable VARNAME. | ||||||||||
%f |
Filename. | ||||||||||
%h |
Remote hostname. Will log the IP address if HostnameLookups is set to
Off, which is the default. If it logs the hostname
for only a few hosts, you probably have access control
directives mentioning them by name. See the Require host
documentation. | ||||||||||
%{c}h |
Like %h, but always reports on the hostname of the
underlying TCP connection and not any modifications to the
remote hostname by modules like mod_remoteip. | ||||||||||
%H |
The request protocol. | ||||||||||
%{VARNAME}i |
The contents of VARNAME: header line(s)
in the request sent to the server. Changes made by other
modules (e.g. mod_headers) affect this. If you're
interested in what the request header was prior to when most
modules would have modified it, use mod_setenvif
to copy the header into an internal environment variable and log
that value with the %{VARNAME}e described
above.
| ||||||||||
%k |
Number of keepalive requests handled on this connection. Interesting if
KeepAlive is being used, so that,
for example, a '1' means the first keepalive request after the initial
one, '2' the second, etc...;
otherwise this is always 0 (indicating the initial request). | ||||||||||
%l |
Remote logname (from identd, if supplied). This will return a
dash unless mod_ident is present and IdentityCheck is set
On. | ||||||||||
%L |
The request log ID from the error log (or '-' if nothing has been logged to the error log for this request). Look for the matching error log line to see what request caused what error. | ||||||||||
%m |
The request method. | ||||||||||
%{VARNAME}n |
The contents of note VARNAME from another module. | ||||||||||
%{VARNAME}o |
The contents of VARNAME: header line(s)
in the reply. | ||||||||||
%p |
The canonical port of the server serving the request. | ||||||||||
%{format}p |
The canonical port of the server serving the request, or the
server's actual port, or the client's actual port. Valid formats
are canonical, local, or remote.
| ||||||||||
%P |
The process ID of the child that serviced the request. | ||||||||||
%{format}P |
The process ID or thread ID of the child that serviced the
request. Valid formats are pid, tid,
and hextid.
| ||||||||||
%q |
The query string (prepended with a ? if a query
string exists, otherwise an empty string). | ||||||||||
%r |
First line of request. | ||||||||||
%R |
The handler generating the response (if any). | ||||||||||
%s |
Status. For requests that have been internally redirected, this is
the status of the original request. Use %>s
for the final status. | ||||||||||
%t |
Time the request was received, in the format [18/Sep/2011:19:18:28 -0400].
The last number indicates the timezone offset from GMT | ||||||||||
%{format}t |
The time, in the form given by format, which should be in
an extended strftime(3) format (potentially localized).
If the format starts with begin: (default) the time is taken
at the beginning of the request processing. If it starts with
end: it is the time when the log entry gets written,
close to the end of the request processing. In addition to the formats
supported by strftime(3), the following format tokens are
supported:
strftime(3)
formatting in the same format string. You can use multiple
%{format}t tokens instead.
| ||||||||||
%T |
The time taken to serve the request, in seconds. | ||||||||||
%{UNIT}T |
The time taken to serve the request, in a time unit given by
UNIT. Valid units are ms for milliseconds,
us for microseconds, and s for seconds.
Using s gives the same result as %T
without any format; using us gives the same result
as %D. Combining %T with a unit is
available in 2.4.13 and later. | ||||||||||
%u |
Remote user if the request was authenticated. May be bogus if return status
(%s) is 401 (unauthorized). | ||||||||||
%U |
The URL path requested, not including any query string. | ||||||||||
%v |
The canonical ServerName
of the server serving the request. | ||||||||||
%V |
The server name according to the UseCanonicalName setting. | ||||||||||
%X |
Connection status when response is completed:
| ||||||||||
%I |
Bytes received, including request and headers. Cannot be zero.
You need to enable mod_logio to use this. | ||||||||||
%O |
Bytes sent, including headers. May be zero in rare cases
such as when a request is aborted before a response is sent.
You need to enable mod_logio to use this. | ||||||||||
%S |
Bytes transferred (received and sent), including request and headers,
cannot be zero. This is the combination of %I and %O. You need to
enable mod_logio to use this. | ||||||||||
%{VARNAME}^ti |
The contents of VARNAME: trailer line(s)
in the request sent to the server. | ||||||||||
%{VARNAME}^to |
The contents of VARNAME: trailer line(s)
in the response sent from the server. |
Particular items can be restricted to print only for
responses with specific HTTP status codes by placing a
comma-separated list of status codes immediately following the
"%". The status code list may be preceded by a "!" to
indicate negation.
| Format String | Meaning |
|---|---|
%400,501{User-agent}i |
Logs User-agent on 400 errors and 501 errors only. For
other status codes, the literal string "-" will be
logged. |
%!200,304,302{Referer}i |
Logs Referer on all requests that do
not return one of the three specified codes,
"-" otherwise.
|
The modifiers "<" and ">" can be used for requests that
have been internally redirected to choose whether the original
or final (respectively) request should be consulted. By
default, the % directives %s, %U, %T,
%D, and %r look at the original request
while all others look at the final request. So for example,
%>s can be used to record the final status of
the request and %<u can be used to record the
original authenticated user on a request that is internally
redirected to an unauthenticated resource.
For security reasons, starting with version 2.0.46,
non-printable and other special characters in %r,
%i and %o are escaped using
\xhh sequences, where hh
stands for the hexadecimal representation of the raw
byte. Exceptions from this rule are " and
\, which are escaped by prepending a backslash, and
all whitespace characters, which are written in their C-style
notation (\n, \t, etc). In versions
prior to 2.0.46, no escaping was performed on these strings so
you had to be quite careful when dealing with raw log files.
Since httpd 2.0, unlike 1.3, the %b and
%B format strings do not represent the number of
bytes sent to the client, but simply the size in bytes of the
HTTP response (which will differ, for instance, if the
connection is aborted, or if SSL is used). The %O
format provided by mod_logio will log the
actual number of bytes sent over the network.
Note: mod_cache is implemented as a
quick-handler and not as a standard handler. Therefore, the
%R format string will not return any handler
information when content caching is involved.
Some commonly used log format strings are:
"%h %l %u %t \"%r\" %>s %b""%v %h %l %u %t \"%r\" %>s %b""%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\"""%{Referer}i -> %U""%{User-agent}i"You can use the %{format}t directive multiple
times to build up a time format using the extended format tokens
like msec_frac:
"%{%d/%b/%Y %T}t.%{msec_frac}t %{%z}t"See the security tips document for details on why your security could be compromised if the directory where logfiles are stored is writable by anyone other than the user that starts the server.
| Description: | Buffer log entries in memory before writing to disk |
|---|---|
| Syntax: | BufferedLogs On|Off |
| Default: | BufferedLogs Off |
| Context: | server config |
| Status: | Base |
| Module: | mod_log_config |
The BufferedLogs directive causes
mod_log_config to store several log entries in
memory and write them together to disk, rather than writing them
after each request. On some systems, this may result in more
efficient disk access and hence higher performance. It may be
set only once for the entire server; it cannot be configured
per virtual-host.
| Description: | Sets filename and format of log file |
|---|---|
| Syntax: | CustomLog file|pipe
format|nickname
[env=[!]environment-variable|
expr=expression] |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_log_config |
The CustomLog directive is used to
log requests to the server. A log format is specified, and the
logging can optionally be made conditional on request
characteristics using environment variables.
The first argument, which specifies the location to which the logs will be written, can take one of the following two types of values:
ServerRoot.|", followed by the path
to a program to receive the log information on its standard
input. See the notes on piped logs
for more information.
If a program is used, then it will be run as the user who
started httpd. This will be root if the server was
started by root; be sure that the program is secure.
When entering a file path on non-Unix platforms, care should be taken to make sure that only forward slashed are used even though the platform may allow the use of back slashes. In general it is a good idea to always use forward slashes throughout the configuration files.
The second argument specifies what will be written to the
log file. It can specify either a nickname defined by
a previous LogFormat
directive, or it can be an explicit format string as
described in the log formats section.
For example, the following two sets of directives have exactly the same effect:
# CustomLog with format nickname LogFormat "%h %l %u %t \"%r\" %>s %b" common CustomLog "logs/access_log" common # CustomLog with explicit format string CustomLog "logs/access_log" "%h %l %u %t \"%r\" %>s %b"
The third argument is optional and controls whether or
not to log a particular request. The condition can be the
presence or absence (in the case of a 'env=!name'
clause) of a particular variable in the server
environment. Alternatively, the condition
can be expressed as arbitrary boolean expression. If the condition is not satisfied, the request
will not be logged. References to HTTP headers in the expression
will not cause the header names to be added to the Vary header.
Environment variables can be set on a per-request
basis using the mod_setenvif
and/or mod_rewrite modules. For
example, if you want to record requests for all GIF
images on your server in a separate logfile but not in your main
log, you can use:
SetEnvIf Request_URI \.gif$ gif-image CustomLog "gif-requests.log" common env=gif-image CustomLog "nongif-requests.log" common env=!gif-image
Or, to reproduce the behavior of the old RefererIgnore directive, you might use the following:
SetEnvIf Referer example\.com localreferer CustomLog "referer.log" referer env=!localreferer
| Description: | Sets filename and format of log file |
|---|---|
| Syntax: | GlobalLogfile|pipe
format|nickname
[env=[!]environment-variable|
expr=expression] |
| Context: | server config |
| Status: | Base |
| Module: | mod_log_config |
| Compatibility: | Available in Apache HTTP Server 2.4.19 and later |
The GlobalLog directive defines a log shared
by the main server configuration and all defined virtual hosts.
The GlobalLog directive is identical to
the CustomLog directive, apart from the following
differences:
GlobalLog is not valid in virtual host
context.GlobalLog is used by virtual hosts that
define their own CustomLog, unlike a
globally specified CustomLog.| Description: | Describes a format for use in a log file |
|---|---|
| Syntax: | LogFormat format|nickname
[nickname] |
| Default: | LogFormat "%h %l %u %t \"%r\" %>s %b" |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_log_config |
This directive specifies the format of the access log file.
The LogFormat directive can take one of two
forms. In the first form, where only one argument is specified,
this directive sets the log format which will be used by logs
specified in subsequent TransferLog
directives. The single argument can specify an explicit
format as discussed in the custom log
formats section above. Alternatively, it can use a
nickname to refer to a log format defined in a
previous LogFormat directive as described
below.
The second form of the LogFormat
directive associates an explicit format with a
nickname. This nickname can then be used in
subsequent LogFormat or
CustomLog directives
rather than repeating the entire format string. A
LogFormat directive that defines a nickname
does nothing else -- that is, it only
defines the nickname, it doesn't actually apply the format and make
it the default. Therefore, it will not affect subsequent
TransferLog directives.
In addition, LogFormat cannot use one nickname
to define another nickname. Note that the nickname should not contain
percent signs (%).
LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common
| Description: | Specify location of a log file |
|---|---|
| Syntax: | TransferLog file|pipe |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_log_config |
This directive has exactly the same arguments and effect as
the CustomLog
directive, with the exception that it does not allow the log format
to be specified explicitly or for conditional logging of requests.
Instead, the log format is determined by the most recently specified
LogFormat directive
which does not define a nickname. Common Log Format is used if no
other format has been specified.
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
TransferLog logs/access_log
Apache HTTP Server Version 2.4
| Description: | Logging of input and output bytes per request |
|---|---|
| Status: | Extension |
| Module Identifier: | logio_module |
| Source File: | mod_logio.c |
This module provides the logging of input and output number of bytes received/sent per request. The numbers reflect the actual bytes as received on the network, which then takes into account the headers and bodies of requests and responses. The counting is done before SSL/TLS on input and after SSL/TLS on output, so the numbers will correctly reflect any changes made by encryption.
This module requires mod_log_config.
This module adds three new logging directives. The characteristics of the
request itself are logged by placing "%" directives in
the format string, which are replaced in the log file by the values as
follows:
| Format String | Description |
|---|---|
%I |
Bytes received, including request and headers, cannot be zero. |
%O |
Bytes sent, including headers, cannot be zero. |
%S |
Bytes transferred (received and sent), including request and headers,
cannot be zero. This is the combination of %I and %O. Available in Apache 2.4.7 and later |
%^FB |
Delay in microseconds between when the request arrived and the
first byte of the response headers are written. Only available if
LogIOTrackTTFB is set to ON.Available in Apache 2.4.13 and later |
Usually, the functionality is used like this:
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\" %I %O"| Description: | Enable tracking of time to first byte (TTFB) |
|---|---|
| Syntax: | LogIOTrackTTFB ON|OFF |
| Default: | LogIOTrackTTFB OFF |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_logio |
| Compatibility: | Apache HTTP Server 2.4.13 and later |
This directive configures whether this module tracks the delay
between the request being read and the first byte of the response
headers being written. The resulting value may be logged with the
%^FB format.
Apache HTTP Server Version 2.4
| Description: | Provides a comprehensive overview of the server configuration |
|---|---|
| Status: | Extension |
| Module Identifier: | info_module |
| Source File: | mod_info.c |
To configure mod_info, add the following to your
httpd.conf file.
<Location "/server-info">
SetHandler server-info
</Location>
You may wish to use mod_authz_host inside the
<Location>
directive to limit access to your server configuration
information:
<Location "/server-info">
SetHandler server-info
Require host example.com
</Location>
Once configured, the server information is obtained by
accessing http://your.host.example.com/server-info
Security Issues Selecting the information shown Dumping the configuration on startup Known LimitationsOnce mod_info is loaded into the server, its
handler capability is available in all configuration
files, including per-directory files (e.g.,
.htaccess). This may have security-related
ramifications for your site.
In particular, this module can leak sensitive information from the configuration directives of other Apache modules such as system paths, usernames/passwords, database names, etc. Therefore, this module should only be used in a controlled environment and always with caution.
You will probably want to use mod_authz_host
to limit access to your server configuration information.
<Location "/server-info">
SetHandler server-info
# Allow access from server itself
Require ip 127.0.0.1
# Additionally, allow access from local workstation
Require ip 192.168.1.17
</Location>
By default, the server information includes a list of all enabled modules, and for each module, a description of the directives understood by that module, the hooks implemented by that module, and the relevant directives from the current configuration.
Other views of the configuration information are available by
appending a query to the server-info request. For
example, http://your.host.example.com/server-info?config
will show all configuration directives.
?<module-name>?config?hooks?list?server?providersIf the config define -DDUMP_CONFIG is set,
mod_info will dump the pre-parsed configuration to
stdout during server startup.
httpd -DDUMP_CONFIG -k start
Pre-parsed means that directives like
<IfDefine> and
<IfModule> are
evaluated and environment variables are replaced. However it does
not represent the final state of the configuration. In particular,
it does not represent the merging or overriding that may happen
for repeated directives.
This is roughly equivalent to the ?config query.
mod_info provides its information by reading the
parsed configuration, rather than reading the original configuration
file. There are a few limitations as a result of the way the parsed
configuration tree is created:
ServerRoot,
LoadModule, and
LoadFile.Include,
<IfModule> and
<IfDefine> are not
listed, but the included configuration directives are..htaccess files are
not listed (since they do not form part of the permanent server
configuration).<Directory>
are listed normally, but mod_info cannot figure
out the line number for the closing
</Directory>.| Description: | Adds additional information to the module information displayed by the server-info handler |
|---|---|
| Syntax: | AddModuleInfo module-name string |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_info |
This allows the content of string to be shown as HTML interpreted, Additional Information for the module module-name. Example:
AddModuleInfo mod_deflate.c 'See <a \
href="http://httpd.apache.org/docs/2.4/mod/mod_deflate.html">\
http://httpd.apache.org/docs/2.4/mod/mod_deflate.html</a>'
Apache HTTP Server Version 2.4
| Description: | Request Counting load balancer scheduler algorithm for mod_proxy_balancer |
|---|---|
| Status: | Extension |
| Module Identifier: | lbmethod_byrequests_module |
| Source File: | mod_lbmethod_byrequests.c |
| Compatibility: | Split off from mod_proxy_balancer in 2.3 |
This module does not provide any configuration directives of its own.
It requires the services of mod_proxy_balancer, and
provides the byrequests load balancing method.
This module provides no directives.
Enabled via lbmethod=byrequests, the idea behind this
scheduler is that we distribute the requests among the
various workers to ensure that each gets their configured share
of the number of requests. It works as follows:
lbfactor is how much we expect this worker to work, or the workers' work quota. This is a normalized value representing their "share" of the amount of work to be done.
lbstatus is how urgent this worker has to work to fulfill its quota of work.
The worker is a member of the load balancer, usually a remote host serving one of the supported protocols.
We distribute each worker's work quota to the worker, and then look which of them needs to work most urgently (biggest lbstatus). This worker is then selected for work, and its lbstatus reduced by the total work quota we distributed to all workers. Thus the sum of all lbstatus does not change(*) and we distribute the requests as desired.
If some workers are disabled, the others will still be scheduled correctly.
for each worker in workers
worker lbstatus += worker lbfactor
total factor += worker lbfactor
if worker lbstatus > candidate lbstatus
candidate = worker
candidate lbstatus -= total factorIf a balancer is configured as follows:
| worker | a | b | c | d |
|---|---|---|---|---|
| lbfactor | 25 | 25 | 25 | 25 |
| lbstatus | 0 | 0 | 0 | 0 |
And b gets disabled, the following schedule is produced:
| worker | a | b | c | d |
|---|---|---|---|---|
| lbstatus | -50 | 0 | 25 | 25 |
| lbstatus | -25 | 0 | -25 | 50 |
| lbstatus | 0 | 0 | 0 | 0 |
| (repeat) | ||||
That is it schedules: a c d a c d a c d ... Please note that:
| worker | a | b | c | d |
|---|---|---|---|---|
| lbfactor | 25 | 25 | 25 | 25 |
Has the exact same behavior as:
| worker | a | b | c | d |
|---|---|---|---|---|
| lbfactor | 1 | 1 | 1 | 1 |
This is because all values of lbfactor are normalized with respect to the others. For:
| worker | a | b | c |
|---|---|---|---|
| lbfactor | 1 | 4 | 1 |
worker b will, on average, get 4 times the requests that a and c will.
The following asymmetric configuration works as one would expect:
| worker | a | b |
|---|---|---|
| lbfactor | 70 | 30 |
| lbstatus | -30 | 30 |
| lbstatus | 40 | -40 |
| lbstatus | 10 | -10 |
| lbstatus | -20 | 20 |
| lbstatus | -50 | 50 |
| lbstatus | 20 | -20 |
| lbstatus | -10 | 10 |
| lbstatus | -40 | 40 |
| lbstatus | 30 | -30 |
| lbstatus | 0 | 0 |
| (repeat) | ||
That is after 10 schedules, the schedule repeats and 7 a are selected with 3 b interspersed.
Apache HTTP Server Version 2.4
| Description: | LDAP connection pooling and result caching services for use by other LDAP modules |
|---|---|
| Status: | Extension |
| Module Identifier: | ldap_module |
| Source File: | util_ldap.c |
This module was created to improve the performance of websites relying on backend connections to LDAP servers. In addition to the functions provided by the standard LDAP libraries, this module adds an LDAP connection pool and an LDAP shared memory cache.
To enable this module, LDAP support must be compiled into
apr-util. This is achieved by adding the --with-ldap
flag to the configure script when building
Apache.
SSL/TLS support is dependent on which LDAP toolkit has been linked to APR. As of this writing, APR-util supports: OpenLDAP SDK (2.x or later), Novell LDAP SDK, Mozilla LDAP SDK, native Solaris LDAP SDK (Mozilla based) or the native Microsoft LDAP SDK. See the APR website for details.
LDAPCacheEntries LDAPCacheTTL LDAPConnectionPoolTTL LDAPConnectionTimeout LDAPLibraryDebug LDAPOpCacheEntries LDAPOpCacheTTL LDAPReferralHopLimit LDAPReferrals LDAPRetries LDAPRetryDelay LDAPSharedCacheFile LDAPSharedCacheSize LDAPTimeout LDAPTrustedClientCert LDAPTrustedGlobalCert LDAPTrustedMode LDAPVerifyServerCertThe following is an example configuration that uses
mod_ldap to increase the performance of HTTP Basic
authentication provided by mod_authnz_ldap.
# Enable the LDAP connection pool and shared
# memory cache. Enable the LDAP cache status
# handler. Requires that mod_ldap and mod_authnz_ldap
# be loaded. Change the "yourdomain.example.com" to
# match your domain.
LDAPSharedCacheSize 500000
LDAPCacheEntries 1024
LDAPCacheTTL 600
LDAPOpCacheEntries 1024
LDAPOpCacheTTL 600
<Location "/ldap-status">
SetHandler ldap-status
Require host yourdomain.example.com
Satisfy any
AuthType Basic
AuthName "LDAP Protected"
AuthBasicProvider ldap
AuthLDAPURL "ldap://127.0.0.1/dc=example,dc=com?uid?one"
Require valid-user
</Location>
LDAP connections are pooled from request to request. This allows the LDAP server to remain connected and bound ready for the next request, without the need to unbind/connect/rebind. The performance advantages are similar to the effect of HTTP keepalives.
On a busy server it is possible that many requests will try and access the same LDAP server connection simultaneously. Where an LDAP connection is in use, Apache will create a new connection alongside the original one. This ensures that the connection pool does not become a bottleneck.
There is no need to manually enable connection pooling in the Apache configuration. Any module using this module for access to LDAP services will share the connection pool.
LDAP connections can keep track of the ldap client
credentials used when binding to an LDAP server. These
credentials can be provided to LDAP servers that do not
allow anonymous binds during referral chasing. To control
this feature, see the
LDAPReferrals and
LDAPReferralHopLimit
directives. By default, this feature is enabled.
For improved performance, mod_ldap uses an aggressive
caching strategy to minimize the number of times that the LDAP
server must be contacted. Caching can easily double or triple
the throughput of Apache when it is serving pages protected
with mod_authnz_ldap. In addition, the load on the LDAP server
will be significantly decreased.
mod_ldap supports two types of LDAP caching during
the search/bind phase with a search/bind cache and
during the compare phase with two operation
caches. Each LDAP URL that is used by the server has
its own set of these three caches.
The process of doing a search and then a bind is the most time-consuming aspect of LDAP operation, especially if the directory is large. The search/bind cache is used to cache all searches that resulted in successful binds. Negative results (i.e., unsuccessful searches, or searches that did not result in a successful bind) are not cached. The rationale behind this decision is that connections with invalid credentials are only a tiny percentage of the total number of connections, so by not caching invalid credentials, the size of the cache is reduced.
mod_ldap stores the username, the DN
retrieved, the password used to bind, and the time of the bind
in the cache. Whenever a new connection is initiated with the
same username, mod_ldap compares the password
of the new connection with the password in the cache. If the
passwords match, and if the cached entry is not too old,
mod_ldap bypasses the search/bind phase.
The search and bind cache is controlled with the LDAPCacheEntries and LDAPCacheTTL directives.
During attribute and distinguished name comparison
functions, mod_ldap uses two operation caches
to cache the compare operations. The first compare cache is
used to cache the results of compares done to test for LDAP
group membership. The second compare cache is used to cache
the results of comparisons done between distinguished
names.
Note that, when group membership is being checked, any sub-group comparison results are cached to speed future sub-group comparisons.
The behavior of both of these caches is controlled with
the LDAPOpCacheEntries
and LDAPOpCacheTTL
directives.
mod_ldap has a content handler that allows
administrators to monitor the cache performance. The name of
the content handler is ldap-status, so the
following directives could be used to access the
mod_ldap cache information:
<Location "/server/cache-info">
SetHandler ldap-status
</Location>
By fetching the URL http://servername/cache-info,
the administrator can get a status report of every cache that is used
by mod_ldap cache. Note that if Apache does not
support shared memory, then each httpd instance has its
own cache, so reloading the URL will result in different
information each time, depending on which httpd
instance processes the request.
The ability to create an SSL and TLS connections to an LDAP server
is defined by the directives
LDAPTrustedGlobalCert,
LDAPTrustedClientCert
and LDAPTrustedMode.
These directives specify the CA and optional client certificates to be used,
as well as the type of encryption to be used on the connection (none, SSL or
TLS/STARTTLS).
# Establish an SSL LDAP connection on port 636. Requires that
# mod_ldap and mod_authnz_ldap be loaded. Change the
# "yourdomain.example.com" to match your domain.
LDAPTrustedGlobalCert CA_DER "/certs/certfile.der"
<Location "/ldap-status">
SetHandler ldap-status
Require host yourdomain.example.com
Satisfy any
AuthType Basic
AuthName "LDAP Protected"
AuthBasicProvider ldap
AuthLDAPURL "ldaps://127.0.0.1/dc=example,dc=com?uid?one"
Require valid-user
</Location>
# Establish a TLS LDAP connection on port 389. Requires that
# mod_ldap and mod_authnz_ldap be loaded. Change the
# "yourdomain.example.com" to match your domain.
LDAPTrustedGlobalCert CA_DER "/certs/certfile.der"
<Location "/ldap-status">
SetHandler ldap-status
Require host yourdomain.example.com
Satisfy any
AuthType Basic
AuthName "LDAP Protected"
AuthBasicProvider ldap
AuthLDAPURL "ldap://127.0.0.1/dc=example,dc=com?uid?one" TLS
Require valid-user
</Location>
The different LDAP SDKs have widely different methods of setting and handling both CA and client side certificates.
If you intend to use SSL or TLS, read this section CAREFULLY so as to understand the differences between configurations on the different LDAP toolkits supported.
CA certificates are specified within a file called cert7.db. The SDK will not talk to any LDAP server whose certificate was not signed by a CA specified in this file. If client certificates are required, an optional key3.db file may be specified with an optional password. The secmod file can be specified if required. These files are in the same format as used by the Netscape Communicator or Mozilla web browsers. The easiest way to obtain these files is to grab them from your browser installation.
Client certificates are specified per connection using the
LDAPTrustedClientCert
directive by referring
to the certificate "nickname". An optional password may be
specified to unlock the certificate's private key.
The SDK supports SSL only. An attempt to use STARTTLS will cause an error when an attempt is made to contact the LDAP server at runtime.
# Specify a Netscape CA certificate file
LDAPTrustedGlobalCert CA_CERT7_DB "/certs/cert7.db"
# Specify an optional key3.db file for client certificate support
LDAPTrustedGlobalCert CERT_KEY3_DB "/certs/key3.db"
# Specify the secmod file if required
LDAPTrustedGlobalCert CA_SECMOD "/certs/secmod"
<Location "/ldap-status">
SetHandler ldap-status
Require host yourdomain.example.com
Satisfy any
AuthType Basic
AuthName "LDAP Protected"
AuthBasicProvider ldap
LDAPTrustedClientCert CERT_NICKNAME <nickname> [password]
AuthLDAPURL "ldaps://127.0.0.1/dc=example,dc=com?uid?one"
Require valid-user
</Location>
One or more CA certificates must be specified for the Novell SDK to work correctly. These certificates can be specified as binary DER or Base64 (PEM) encoded files.
Note: Client certificates are specified globally rather than per
connection, and so must be specified with the LDAPTrustedGlobalCert
directive as below. Trying to set client certificates via the
LDAPTrustedClientCert
directive will cause an error to be logged
when an attempt is made to connect to the LDAP server.
The SDK supports both SSL and STARTTLS, set using the
LDAPTrustedMode parameter.
If an ldaps:// URL is specified,
SSL mode is forced, override this directive.
# Specify two CA certificate files LDAPTrustedGlobalCert CA_DER "/certs/cacert1.der" LDAPTrustedGlobalCert CA_BASE64 "/certs/cacert2.pem" # Specify a client certificate file and key LDAPTrustedGlobalCert CERT_BASE64 "/certs/cert1.pem" LDAPTrustedGlobalCert KEY_BASE64 "/certs/key1.pem" [password] # Do not use this directive, as it will throw an error #LDAPTrustedClientCert CERT_BASE64 "/certs/cert1.pem"
One or more CA certificates must be specified for the OpenLDAP SDK to work correctly. These certificates can be specified as binary DER or Base64 (PEM) encoded files.
Both CA and client certificates may be specified globally
(LDAPTrustedGlobalCert) or
per-connection (LDAPTrustedClientCert).
When any settings are specified per-connection, the global
settings are superseded.
The documentation for the SDK claims to support both SSL and STARTTLS, however STARTTLS does not seem to work on all versions of the SDK. The SSL/TLS mode can be set using the LDAPTrustedMode parameter. If an ldaps:// URL is specified, SSL mode is forced. The OpenLDAP documentation notes that SSL (ldaps://) support has been deprecated to be replaced with TLS, although the SSL functionality still works.
# Specify two CA certificate files
LDAPTrustedGlobalCert CA_DER "/certs/cacert1.der"
LDAPTrustedGlobalCert CA_BASE64 "/certs/cacert2.pem"
<Location "/ldap-status">
SetHandler ldap-status
Require host yourdomain.example.com
LDAPTrustedClientCert CERT_BASE64 "/certs/cert1.pem"
LDAPTrustedClientCert KEY_BASE64 "/certs/key1.pem"
# CA certs respecified due to per-directory client certs
LDAPTrustedClientCert CA_DER "/certs/cacert1.der"
LDAPTrustedClientCert CA_BASE64 "/certs/cacert2.pem"
Satisfy any
AuthType Basic
AuthName "LDAP Protected"
AuthBasicProvider ldap
AuthLDAPURL "ldaps://127.0.0.1/dc=example,dc=com?uid?one"
Require valid-user
</Location>
SSL/TLS for the native Solaris LDAP libraries is not yet supported. If required, install and use the OpenLDAP libraries instead.
SSL/TLS certificate configuration for the native Microsoft LDAP libraries is done inside the system registry, and no configuration directives are required.
Both SSL and TLS are supported by using the ldaps:// URL
format, or by using the LDAPTrustedMode directive accordingly.
Note: The status of support for client certificates is not yet known for this toolkit.
| Description: | Maximum number of entries in the primary LDAP cache |
|---|---|
| Syntax: | LDAPCacheEntries number |
| Default: | LDAPCacheEntries 1024 |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
Specifies the maximum size of the primary LDAP cache. This cache contains successful search/binds. Set it to 0 to turn off search/bind caching. The default size is 1024 cached searches.
| Description: | Time that cached items remain valid |
|---|---|
| Syntax: | LDAPCacheTTL seconds |
| Default: | LDAPCacheTTL 600 |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
Specifies the time (in seconds) that an item in the search/bind cache remains valid. The default is 600 seconds (10 minutes).
| Description: | Discard backend connections that have been sitting in the connection pool too long |
|---|---|
| Syntax: | LDAPConnectionPoolTTL n |
| Default: | LDAPConnectionPoolTTL -1 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ldap |
| Compatibility: | Apache HTTP Server 2.3.12 and later |
Specifies the maximum age, in seconds, that a pooled LDAP connection can remain idle and still be available for use. Connections are cleaned up when they are next needed, not asynchronously.
A setting of 0 causes connections to never be saved in the backend connection pool. The default value of -1, and any other negative value, allows connections of any age to be reused.
For performance reasons, the reference time used by this directive is based on when the LDAP connection is returned to the pool, not the time of the last successful I/O with the LDAP server.
Since 2.4.10, new measures are in place to avoid the reference time from being inflated by cache hits or slow requests. First, the reference time is not updated if no backend LDAP conncetions were needed. Second, the reference time uses the time the HTTP request was received instead of the time the request is completed.
This timeout defaults to units of seconds, but accepts suffixes for milliseconds (ms), minutes (min), and hours (h).
| Description: | Specifies the socket connection timeout in seconds |
|---|---|
| Syntax: | LDAPConnectionTimeout seconds |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
This directive configures the LDAP_OPT_NETWORK_TIMEOUT (or LDAP_OPT_CONNECT_TIMEOUT) option in the underlying LDAP client library, when available. This value typically controls how long the LDAP client library will wait for the TCP connection to the LDAP server to complete.
If a connection is not successful with the timeout period, either an error will be
returned or the LDAP client library will attempt to connect to a secondary LDAP
server if one is specified (via a space-separated list of hostnames in the
AuthLDAPURL).
The default is 10 seconds, if the LDAP client library linked with the server supports the LDAP_OPT_NETWORK_TIMEOUT option.
| Description: | Enable debugging in the LDAP SDK |
|---|---|
| Syntax: | LDAPLibraryDebug 7 |
| Default: | disabled |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
Turns on SDK-specific LDAP debug options that generally cause the LDAP SDK to log verbose trace information to the main Apache error log. The trace messages from the LDAP SDK provide gory details that can be useful during debugging of connectivity problems with backend LDAP servers
This option is only configurable when Apache HTTP Server is linked with
an LDAP SDK that implements LDAP_OPT_DEBUG or
LDAP_OPT_DEBUG_LEVEL, such as OpenLDAP (a value of 7 is verbose)
or Tivoli Directory Server (a value of 65535 is verbose).
The logged information will likely contain plaintext credentials being used or validated by LDAP authentication, so care should be taken in protecting and purging the error log when this directive is used.
| Description: | Number of entries used to cache LDAP compare operations |
|---|---|
| Syntax: | LDAPOpCacheEntries number |
| Default: | LDAPOpCacheEntries 1024 |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
This specifies the number of entries mod_ldap
will use to cache LDAP compare operations. The default is 1024
entries. Setting it to 0 disables operation caching.
| Description: | Time that entries in the operation cache remain valid |
|---|---|
| Syntax: | LDAPOpCacheTTL seconds |
| Default: | LDAPOpCacheTTL 600 |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
Specifies the time (in seconds) that entries in the operation cache remain valid. The default is 600 seconds.
| Description: | The maximum number of referral hops to chase before terminating an LDAP query. |
|---|---|
| Syntax: | LDAPReferralHopLimit number |
| Default: | SDK dependent, typically between 5 and 10 |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_ldap |
This directive, if enabled by the LDAPReferrals directive,
limits the number of referral hops that are followed before terminating an
LDAP query.
Support for this tunable is uncommon in LDAP SDKs.
| Description: | Enable referral chasing during queries to the LDAP server. |
|---|---|
| Syntax: | LDAPReferrals On|Off|default |
| Default: | LDAPReferrals On |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_ldap |
| Compatibility: | The default parameter is available in Apache 2.4.7 and later |
Some LDAP servers divide their directory among multiple domains and use referrals to direct a client when a domain boundary is crossed. This is similar to a HTTP redirect. LDAP client libraries may or may not chase referrals by default. This directive explicitly configures the referral chasing in the underlying SDK.
LDAPReferrals takes the following values:
When set to "on", the underlying SDK's referral chasing state
is enabled, LDAPReferralHopLimit is used to
override the SDK's hop limit, and an LDAP rebind callback is
registered.
When set to "off", the underlying SDK's referral chasing state is disabled completely.
When set to "default", the underlying SDK's referral chasing state
is not changed, LDAPReferralHopLimit is not
used to override the SDK's hop limit, and no LDAP rebind callback is
registered.
The directive LDAPReferralHopLimit works in conjunction with
this directive to limit the number of referral hops to follow before terminating the LDAP query.
When referral processing is enabled by a value of "On", client credentials will be provided,
via a rebind callback, for any LDAP server requiring them.
| Description: | Configures the number of LDAP server retries. |
|---|---|
| Syntax: | LDAPRetries number-of-retries |
| Default: | LDAPRetries 3 |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
The server will retry failed LDAP requests up to
LDAPRetries times. Setting this
directive to 0 disables retries.
LDAP errors such as timeouts and refused connections are retryable.
| Description: | Configures the delay between LDAP server retries. |
|---|---|
| Syntax: | LDAPRetryDelay seconds |
| Default: | LDAPRetryDelay 0 |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
If LDAPRetryDelay is set to a non-zero
value, the server will delay retrying an LDAP request for the
specified amount of time. Setting this directive to 0 will
result in any retry to occur without delay.
LDAP errors such as timeouts and refused connections are retryable.
| Description: | Sets the shared memory cache file |
|---|---|
| Syntax: | LDAPSharedCacheFile directory-path/filename |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
Specifies the directory path and file name of the shared memory cache file. If not set, anonymous shared memory will be used if the platform supports it.
| Description: | Size in bytes of the shared-memory cache |
|---|---|
| Syntax: | LDAPSharedCacheSize bytes |
| Default: | LDAPSharedCacheSize 500000 |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
Specifies the number of bytes to allocate for the shared memory cache. The default is 500kb. If set to 0, shared memory caching will not be used and every HTTPD process will create its own cache.
| Description: | Specifies the timeout for LDAP search and bind operations, in seconds |
|---|---|
| Syntax: | LDAPTimeout seconds |
| Default: | LDAPTimeout 60 |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
| Compatibility: | Apache HTTP Server 2.3.5 and later |
This directive configures the timeout for bind and search operations, as well as the LDAP_OPT_TIMEOUT option in the underlying LDAP client library, when available.
If the timeout expires, httpd will retry in case an existing connection has been silently dropped by a firewall. However, performance will be much better if the firewall is configured to send TCP RST packets instead of silently dropping packets.
Timeouts for ldap compare operations requires an SDK with LDAP_OPT_TIMEOUT, such as OpenLDAP >= 2.4.4.
| Description: | Sets the file containing or nickname referring to a per connection client certificate. Not all LDAP toolkits support per connection client certificates. |
|---|---|
| Syntax: | LDAPTrustedClientCert type directory-path/filename/nickname [password] |
| Context: | directory, .htaccess |
| Status: | Extension |
| Module: | mod_ldap |
It specifies the directory path, file name or nickname of a
per connection client certificate used when establishing an SSL
or TLS connection to an LDAP server. Different locations or
directories may have their own independent client certificate
settings. Some LDAP toolkits (notably Novell)
do not support per connection client certificates, and will throw an
error on LDAP server connection if you try to use this directive
(Use the LDAPTrustedGlobalCert
directive instead for Novell client
certificates - See the SSL/TLS certificate guide above for details).
The type specifies the kind of certificate parameter being
set, depending on the LDAP toolkit being used. Supported types are:
| Description: | Sets the file or database containing global trusted Certificate Authority or global client certificates |
|---|---|
| Syntax: | LDAPTrustedGlobalCert type directory-path/filename [password] |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
It specifies the directory path and file name of the trusted CA
certificates and/or system wide client certificates mod_ldap
should use when establishing an SSL or TLS connection to an LDAP
server. Note that all certificate information specified using this directive
is applied globally to the entire server installation. Some LDAP toolkits
(notably Novell) require all client certificates to be set globally using
this directive. Most other toolkits require clients certificates to be set
per Directory or per Location using LDAPTrustedClientCert. If you get this
wrong, an error may be logged when an attempt is made to contact the LDAP
server, or the connection may silently fail (See the SSL/TLS certificate
guide above for details).
The type specifies the kind of certificate parameter being
set, depending on the LDAP toolkit being used. Supported types are:
| Description: | Specifies the SSL/TLS mode to be used when connecting to an LDAP server. |
|---|---|
| Syntax: | LDAPTrustedMode type |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_ldap |
The following modes are supported:
Not all LDAP toolkits support all the above modes. An error message will be logged at runtime if a mode is not supported, and the connection to the LDAP server will fail.
If an ldaps:// URL is specified, the mode becomes SSL and the setting
of LDAPTrustedMode is ignored.
| Description: | Force server certificate verification |
|---|---|
| Syntax: | LDAPVerifyServerCert On|Off |
| Default: | LDAPVerifyServerCert On |
| Context: | server config |
| Status: | Extension |
| Module: | mod_ldap |
Specifies whether to force the verification of a server certificate when establishing an SSL connection to the LDAP server.
Apache HTTP Server Version 2.4
| Description: | Forensic Logging of the requests made to the server |
|---|---|
| Status: | Extension |
| Module Identifier: | log_forensic_module |
| Source File: | mod_log_forensic.c |
| Compatibility: | mod_unique_id is no longer required since
version 2.1 |
This module provides for forensic logging of client requests. Logging is done before and after processing a request, so the forensic log contains two log lines for each request. The forensic logger is very strict, which means:
CoreDumpDirectory
configuration).The check_forensic script, which can be found in the
distribution's support directory, may be helpful in evaluating the
forensic log output.
Each request is logged two times. The first time is before it's processed further (that is, after receiving the headers). The second log entry is written after the request processing at the same time where normal logging occurs.
In order to identify each request, a unique request ID is assigned.
This forensic ID can be cross logged in the normal transfer log using the
%{forensic-id}n format string. If you're using
mod_unique_id, its generated ID will be used.
The first line logs the forensic ID, the request line and all received
headers, separated by pipe characters (|). A sample line
looks like the following (all on one line):
+yQtJf8CoAB4AAFNXBIEAAAAA|GET /manual/de/images/down.gif
HTTP/1.1|Host:localhost%3a8080|User-Agent:Mozilla/5.0 (X11;
U; Linux i686; en-US; rv%3a1.6) Gecko/20040216
Firefox/0.8|Accept:image/png, etc...
The plus character at the beginning indicates that this is the first log line of this request. The second line just contains a minus character and the ID again:
-yQtJf8CoAB4AAFNXBIEAAAAA
The check_forensic script takes as its argument the name
of the logfile. It looks for those +/- ID pairs
and complains if a request was not completed.
See the security tips document for details on why your security could be compromised if the directory where logfiles are stored is writable by anyone other than the user that starts the server.
The log files may contain sensitive data such as the contents of
Authorization: headers (which can contain passwords), so
they should not be readable by anyone except the user that starts the
server.
| Description: | Sets filename of the forensic log |
|---|---|
| Syntax: | ForensicLog filename|pipe |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_log_forensic |
The ForensicLog directive is used to
log requests to the server for forensic analysis. Each log entry
is assigned a unique ID which can be associated with the request
using the normal CustomLog
directive. mod_log_forensic creates a token called
forensic-id, which can be added to the transfer log
using the %{forensic-id}n format string.
The argument, which specifies the location to which the logs will be written, can take one of the following two types of values:
ServerRoot.|", followed by the path
to a program to receive the log information on its standard
input. The program name can be specified relative to the ServerRoot directive.
If a program is used, then it will be run as the user who
started httpd. This will be root if the server was
started by root; be sure that the program is secure or switches to a
less privileged user.
When entering a file path on non-Unix platforms, care should be taken to make sure that only forward slashes are used even though the platform may allow the use of back slashes. In general it is a good idea to always use forward slashes throughout the configuration files.
Apache HTTP Server Version 2.4
| Description: | Provides macros within apache httpd runtime configuration files |
|---|---|
| Status: | Base |
| Module Identifier: | macro_module |
| Source File: | mod_macro.c |
| Compatibility: | Available in httpd 2.4.5 and later |
Provides macros within Apache httpd runtime configuration files, to ease the process of creating numerous similar configuration blocks. When the server starts up, the macros are expanded using the provided parameters, and the result is processed as along with the rest of the configuration file.
Macros are defined using <Macro> blocks, which contain the portion of
your configuration that needs to be repeated, complete with variables
for those parts that will need to be substituted.
For example, you might use a macro to define a <VirtualHost> block, in order to define
multiple similar virtual hosts:
<Macro VHost $name $domain>
<VirtualHost *:80>
ServerName $domain
ServerAlias www.$domain
DocumentRoot "/var/www/vhosts/$name"
ErrorLog "/var/log/httpd/$name.error_log"
CustomLog "/var/log/httpd/$name.access_log" combined
</VirtualHost>
</Macro>
Macro names are case-insensitive, like httpd configuration directives. However, variable names are case sensitive.
You would then invoke this macro several times to create virtual hosts:
Use VHost example example.com Use VHost myhost hostname.org Use VHost apache apache.org UndefMacro VHost
At server startup time, each of these Use
invocations would be expanded into a full virtualhost, as
described by the <Macro>
definition.
The UndefMacro directive is
used so that later macros using the same variable names don't result in
conflicting definitions.
A more elaborate version of this example may be seen below in the Examples section.
Parameter names should begin with a sigil such as $,
%, or @, so that they are clearly
identifiable, and also in order to help deal with interactions with
other directives, such as the core Define directive. Failure to do so will
result in a warning. Nevertheless, you are encouraged to have a good
knowledge of your entire server configuration in order to avoid reusing
the same variables in different scopes, which can cause confusion.
Parameters prefixed with either $ or % are
not escaped. Parameters prefixes with @ are escaped in
quotes.
Avoid using a parameter which contains another parameter as a prefix,
(For example, $win and $winter) as this may
cause confusion at expression evaluation time. In the event of such
confusion, the longest possible parameter name is used.
If you want to use a value within another string, it is useful to surround the parameter in braces, to avoid confusion:
<Macro DocRoot ${docroot}>
DocumentRoot "/var/www/${docroot}/htdocs"
</Macro>
A common usage of mod_macro is for the creation of
dynamically-generated virtual hosts.
## Define a VHost Macro for repetitive configurations
<Macro VHost $host $port $dir>
Listen $port
<VirtualHost *:$port>
ServerName $host
DocumentRoot "$dir"
# Public document root
<Directory "$dir">
Require all granted
</Directory>
# limit access to intranet subdir.
<Directory "$dir/intranet">
Require ip 10.0.0.0/8
</Directory>
</VirtualHost>
</Macro>
## Use of VHost with different arguments.
Use VHost www.apache.org 80 /vhosts/apache/htdocs
Use VHost example.org 8080 /vhosts/example/htdocs
Use VHost www.example.fr 1234 /vhosts/example.fr/htdocs
It's recommended that you undefine a macro once you've used it. This avoids confusion in a complex configuration file where there may be conflicts in variable names.
<Macro DirGroup $dir $group>
<Directory "$dir">
Require group $group
</Directory>
</Macro>
Use DirGroup /www/apache/private private
Use DirGroup /www/apache/server admin
UndefMacro DirGroup
| Description: | Define a configuration file macro |
|---|---|
| Syntax: |
<Macro name [par1 .. parN]>
... </Macro> |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_macro |
The <Macro> directive controls the
definition of a macro within the server runtime configuration files.
The first argument is the name of the macro.
Other arguments are parameters to the macro. It is good practice to prefix
parameter names with any of '$%@', and not macro names
with such characters.
<Macro LocalAccessPolicy>
Require ip 10.2.16.0/24
</Macro>
<Macro RestrictedAccessPolicy $ipnumbers>
Require ip $ipnumbers
</Macro>
| Description: | Undefine a macro |
|---|---|
| Syntax: | UndefMacro name |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_macro |
The UndefMacro directive undefines a macro
which has been defined before hand.
UndefMacro LocalAccessPolicy UndefMacro RestrictedAccessPolicy
| Description: | Use a macro |
|---|---|
| Syntax: | Use name [value1 ... valueN]
|
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_macro |
The Use directive controls the use of a macro.
The specified macro is expanded. It must be given the same number of
arguments as in the macro definition. The provided values are
associated to their corresponding initial parameters and are substituted
before processing.
Use LocalAccessPolicy ... Use RestrictedAccessPolicy "192.54.172.0/24 192.54.148.0/24"
is equivalent, with the macros defined above, to:
Require ip 10.2.16.0/24 ... Require ip 192.54.172.0/24 192.54.148.0/24
Apache HTTP Server Version 2.4
| Description: | Provides for content negotiation |
|---|---|
| Status: | Base |
| Module Identifier: | negotiation_module |
| Source File: | mod_negotiation.c |
Content negotiation, or more accurately content selection, is the selection of the document that best matches the clients capabilities, from one of several available documents. There are two implementations of this.
type-map) which explicitly lists the files
containing the variants.Multiviews
Options), where the server does
an implicit filename pattern match, and choose from amongst the
results.A type map has a format similar to RFC822 mail headers. It contains document descriptions separated by blank lines, with lines beginning with a hash character ('#') treated as comments. A document description consists of several header records; records may be continued on multiple lines if the continuation lines start with spaces. The leading space will be deleted and the lines concatenated. A header record consists of a keyword name, which always ends in a colon, followed by a value. Whitespace is allowed between the header name and value, and between the tokens of value. The headers allowed are:
Content-Encoding:AddEncoding directive.
This normally includes the encodings x-compress
for compress'd files, and x-gzip for gzip'd
files. The x- prefix is ignored for encoding
comparisons.Content-Language:en,
meaning English. If the variant contains more than one
language, they are separated by a comma.Content-Length:Content-Type:name=value. Common
parameters include:
leveltext/html this defaults to 2, otherwise
0.qsqs values are therefore specific to a given
resource.
Content-Type: image/jpeg; qs=0.8
URI:Body:
Body:----xyz----
<html>
<body>
<p>Content of the page.</p>
</body>
</html>
----xyz----
Consider, for example, a resource called
document.html which is available in English, French,
and German. The files for each of these are called
document.html.en, document.html.fr, and
document.html.de, respectively. The type map file will
be called document.html.var, and will contain the
following:
URI: document.html
Content-language: en
Content-type: text/html
URI: document.html.en
Content-language: fr
Content-type: text/html
URI: document.html.fr
Content-language: de
Content-type: text/html
URI: document.html.de
All four of these files should be placed in the same directory,
and the .var file should be associated with the
type-map handler with an AddHandler directive:
AddHandler type-map .var
A request for document.html.var in this directory will
result in choosing the variant which most closely matches the language preference
specified in the user's Accept-Language request
header.
If Multiviews is enabled, and MultiviewsMatch is set to "handlers" or "any", a request to
document.html will discover document.html.var and
continue negotiating with the explicit type map.
Other configuration directives, such as Alias can be used to map document.html to
document.html.var.
A Multiviews search is enabled by the Multiviews
Options. If the server receives a
request for /some/dir/foo and
/some/dir/foo does not exist, then the
server reads the directory looking for all files named
foo.*, and effectively fakes up a type map which
names all those files, assigning them the same media types and
content-encodings it would have if the client had asked for one
of them by name. It then chooses the best match to the client's
requirements, and returns that document.
The MultiviewsMatch
directive configures whether Apache will consider files
that do not have content negotiation meta-information assigned
to them when choosing files.
| Description: | Allows content-negotiated documents to be cached by proxy servers |
|---|---|
| Syntax: | CacheNegotiatedDocs On|Off |
| Default: | CacheNegotiatedDocs Off |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_negotiation |
If set, this directive allows content-negotiated documents to be cached by proxy servers. This could mean that clients behind those proxys could retrieve versions of the documents that are not the best match for their abilities, but it will make caching more efficient.
This directive only applies to requests which come from HTTP/1.0 browsers. HTTP/1.1 provides much better control over the caching of negotiated documents, and this directive has no effect in responses to HTTP/1.1 requests.
| Description: | Action to take if a single acceptable document is not found |
|---|---|
| Syntax: | ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] |
| Default: | ForceLanguagePriority Prefer |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_negotiation |
The ForceLanguagePriority directive uses
the given LanguagePriority to satisfy
negotiation where the server could otherwise not return a single
matching document.
ForceLanguagePriority Prefer uses
LanguagePriority to serve a one valid result, rather
than returning an HTTP result 300 (MULTIPLE CHOICES) when there
are several equally valid choices. If the directives below were
given, and the user's Accept-Language header assigned
en and de each as quality .500
(equally acceptable) then the first matching variant, en,
will be served.
LanguagePriority en fr de ForceLanguagePriority Prefer
ForceLanguagePriority Fallback uses
LanguagePriority to
serve a valid result, rather than returning an HTTP result 406
(NOT ACCEPTABLE). If the directives below were given, and the user's
Accept-Language only permitted an es
language response, but such a variant isn't found, then the first
variant from the LanguagePriority list below will be served.
LanguagePriority en fr de ForceLanguagePriority Fallback
Both options, Prefer and Fallback, may be
specified, so either the first matching variant from LanguagePriority will be served if
more than one variant is acceptable, or first available document will
be served if none of the variants matched the client's acceptable list
of languages.
| Description: | The precedence of language variants for cases where the client does not express a preference |
|---|---|
| Syntax: | LanguagePriority MIME-lang [MIME-lang]
... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_negotiation |
The LanguagePriority sets the precedence
of language variants for the case where the client does not
express a preference, when handling a Multiviews request. The list
of MIME-lang are in order of decreasing preference.
LanguagePriority en fr de
For a request for foo.html, where
foo.html.fr and foo.html.de both
existed, but the browser did not express a language preference,
then foo.html.fr would be returned.
Note that this directive only has an effect if a 'best'
language cannot be determined by any other means or the ForceLanguagePriority directive
is not None. In general, the client determines the
language preference, not the server.
Apache HTTP Server Version 2.4
| Description: | Provides Lua hooks into various portions of the httpd request processing |
|---|---|
| Status: | Extension |
| Module Identifier: | lua_module |
| Source File: | mod_lua.c |
| Compatibility: | 2.3 and later |
This module allows the server to be extended with scripts written in the
Lua programming language. The extension points (hooks) available with
mod_lua include many of the hooks available to
natively compiled Apache HTTP Server modules, such as mapping requests to
files, generating dynamic responses, access control, authentication, and
authorization
More information on the Lua programming language can be found at the the Lua website.
This module holds a great deal of power over httpd, which is both a strength and a potential security risk. It is not recommended that you use this module on a server that is shared with users you do not trust, as it can be abused to change the internal workings of httpd.
Basic Configuration Writing Handlers Writing Authorization Providers Writing Hooks Data Structures Built in functions Logging Functions apache2 Package Modifying contents with Lua filters Database connectivity LuaAuthzProvider LuaCodeCache LuaHookAccessChecker LuaHookAuthChecker LuaHookCheckUserID LuaHookFixups LuaHookInsertFilter LuaHookLog LuaHookMapToStorage LuaHookPreTranslate LuaHookTranslateName LuaHookTypeChecker LuaInherit LuaInputFilter LuaMapHandler LuaOutputFilter LuaPackageCPath LuaPackagePath LuaQuickHandler LuaRoot LuaScopeThe basic module loading directive is
LoadModule lua_module modules/mod_lua.so
mod_lua provides a handler named lua-script,
which can be used with a SetHandler or
AddHandler directive:
<Files "*.lua">
SetHandler lua-script
</Files>
This will cause mod_lua to handle requests for files
ending in .lua by invoking that file's
handle function.
For more flexibility, see LuaMapHandler.
In the Apache HTTP Server API, the handler is a specific kind of hook
responsible for generating the response. Examples of modules that include a
handler are mod_proxy, mod_cgi,
and mod_status.
mod_lua always looks to invoke a Lua function for the handler, rather than
just evaluating a script body CGI style. A handler function looks
something like this:
example.lua
-- example handler require "string" --[[ This is the default method name for Lua handlers, see the optional function-name in the LuaMapHandler directive to choose a different entry point. --]] function handle(r) r.content_type = "text/plain" if r.method == 'GET' then r:puts("Hello Lua World!\n") for k, v in pairs( r:parseargs() ) do r:puts( string.format("%s: %s\n", k, v) ) end elseif r.method == 'POST' then r:puts("Hello Lua World!\n") for k, v in pairs( r:parsebody() ) do r:puts( string.format("%s: %s\n", k, v) ) end elseif r.method == 'PUT' then -- use our own Error contents r:puts("Unsupported HTTP method " .. r.method) r.status = 405 return apache2.OK else -- use the ErrorDocument return 501 end return apache2.OK end
This handler function just prints out the uri or form encoded arguments to a plaintext page.
This means (and in fact encourages) that you can have multiple handlers (or hooks, or filters) in the same script.
mod_authz_core provides a high-level interface to
authorization that is much easier to use than using into the relevant
hooks directly. The first argument to the
Require directive gives
the name of the responsible authorization provider. For any
Require line,
mod_authz_core will call the authorization provider
of the given name, passing the rest of the line as parameters. The
provider will then check authorization and pass the result as return
value.
The authz provider is normally called before authentication. If it needs to
know the authenticated user name (or if the user will be authenticated at
all), the provider must return apache2.AUTHZ_DENIED_NO_USER.
This will cause authentication to proceed and the authz provider to be
called a second time.
The following authz provider function takes two arguments, one ip address and one user name. It will allow access from the given ip address without authentication, or if the authenticated user matches the second argument:
authz_provider.lua
require 'apache2' function authz_check_foo(r, ip, user) if r.useragent_ip == ip then return apache2.AUTHZ_GRANTED elseif r.user == nil then return apache2.AUTHZ_DENIED_NO_USER elseif r.user == user then return apache2.AUTHZ_GRANTED else return apache2.AUTHZ_DENIED end end
The following configuration registers this function as provider
foo and configures it for URL /:
LuaAuthzProvider foo authz_provider.lua authz_check_foo <Location "/"> Require foo 10.1.2.3 john_doe </Location>
Hook functions are how modules (and Lua scripts) participate in the processing of requests. Each type of hook exposed by the server exists for a specific purpose, such as mapping requests to the file system, performing access control, or setting mime types:
| Hook phase | mod_lua directive | Description |
|---|---|---|
| Quick handler | LuaQuickHandler |
This is the first hook that will be called after a request has been mapped to a host or virtual host |
| Pre-Translate name | LuaHookPreTranslateName |
This phase translates the requested URI into a filename on the
system, before decoding occurs. Modules such as mod_proxy
can operate in this phase. |
| Translate name | LuaHookTranslateName |
This phase translates the requested URI into a filename on the
system. Modules such as mod_alias and
mod_rewrite operate in this phase. |
| Map to storage | LuaHookMapToStorage |
This phase maps files to their physical, cached or external/proxied storage. It can be used by proxy or caching modules |
| Check Access | LuaHookAccessChecker |
This phase checks whether a client has access to a resource. This phase is run before the user is authenticated, so beware. |
| Check User ID | LuaHookCheckUserID |
This phase it used to check the negotiated user ID |
| Check Authorization | LuaHookAuthChecker or
LuaAuthzProvider |
This phase authorizes a user based on the negotiated credentials, such as user ID, client certificate etc. |
| Check Type | LuaHookTypeChecker |
This phase checks the requested file and assigns a content type and a handler to it |
| Fixups | LuaHookFixups |
This is the final "fix anything" phase before the content handlers are run. Any last-minute changes to the request should be made here. |
| Content handler | fx. .lua files or through LuaMapHandler |
This is where the content is handled. Files are read, parsed, some are run, and the result is sent to the client |
| Logging | LuaHookLog |
Once a request has been handled, it enters several logging phases, which logs the request in either the error or access log. Mod_lua is able to hook into the start of this and control logging output. |
Hook functions are passed the request object as their only argument
(except for LuaAuthzProvider, which also gets passed the arguments from
the Require directive).
They can return any value, depending on the hook, but most commonly
they'll return OK, DONE, or DECLINED, which you can write in Lua as
apache2.OK, apache2.DONE, or
apache2.DECLINED, or else an HTTP status code.
translate_name.lua
-- example hook that rewrites the URI to a filesystem path. require 'apache2' function translate_name(r) if r.uri == "/translate-name" then r.filename = r.document_root .. "/find_me.txt" return apache2.OK end -- we don't care about this URL, give another module a chance return apache2.DECLINED end
translate_name2.lua
--[[ example hook that rewrites one URI to another URI. It returns a apache2.DECLINED to give other URL mappers a chance to work on the substitution, including the core translate_name hook which maps based on the DocumentRoot. Note: Use the early/late flags in the directive to make it run before or after mod_alias. --]] require 'apache2' function translate_name(r) if r.uri == "/translate-name" then r.uri = "/find_me.txt" return apache2.DECLINED end return apache2.DECLINED end
The request_rec is mapped in as a userdata. It has a metatable which lets you do useful things with it. For the most part it has the same fields as the request_rec struct, many of which are writable as well as readable. (The table fields' content can be changed, but the fields themselves cannot be set to different tables.)
| Name | Lua type | Writable | Description |
|---|---|---|---|
allowoverrides |
string | no | The AllowOverride options applied to the current request. |
ap_auth_type |
string | yes | If an authentication check was made, this is set to the type
of authentication (f.x. basic) |
args |
string | yes | The query string arguments extracted from the request
(f.x. foo=bar&name=johnsmith) |
assbackwards |
boolean | no | Set to true if this is an HTTP/0.9 style request
(e.g. GET /foo (with no headers) ) |
auth_name |
string | no | The realm name used for authorization (if applicable). |
banner |
string | no | The server banner, f.x. Apache HTTP Server/2.4.3 openssl/0.9.8c |
basic_auth_pw |
string | no | The basic auth password sent with this request, if any |
canonical_filename |
string | no | The canonical filename of the request |
content_encoding |
string | no | The content encoding of the current request |
content_type |
string | yes | The content type of the current request, as determined in the
type_check phase (f.x. image/gif or text/html) |
context_prefix |
string | no | |
context_document_root |
string | no | |
document_root |
string | no | The document root of the host |
err_headers_out |
table | no | MIME header environment for the response, printed even on errors and persist across internal redirects. A read-only lua table suitable for iteration is available as r:err_headers_out_table(). |
filename |
string | yes | The file name that the request maps to, f.x. /www/example.com/foo.txt. This can be changed in the pre-translate-name, translate-name or map-to-storage phases of a request to allow the default handler (or script handlers) to serve a different file than what was requested. |
handler |
string | yes | The name of the handler that should serve this request, f.x.
lua-script if it is to be served by mod_lua. This is typically set by the
AddHandler or SetHandler
directives, but could also be set via mod_lua to allow another handler to serve up a specific request
that would otherwise not be served by it.
|
headers_in |
table | yes | MIME header environment from the request. This contains headers such as Host,
User-Agent, Referer and so on. A read-only lua table suitable for iteration is available as r:headers_in_table(). |
headers_out |
table | yes | MIME header environment for the response. A read-only lua table suitable for iteration is available as r:headers_out_table(). |
hostname |
string | no | The host name, as set by the Host: header or by a full URI. |
is_https |
boolean | no | Whether or not this request is done via HTTPS |
is_initial_req |
boolean | no | Whether this request is the initial request or a sub-request |
limit_req_body |
number | no | The size limit of the request body for this request, or 0 if no limit. |
log_id |
string | no | The ID to identify request in access and error log. |
method |
string | no | The request method, f.x. GET or POST. |
notes |
table | yes | A list of notes that can be passed on from one module to another. A read-only lua table suitable for iteration is available as r:notes_table(). |
options |
string | no | The Options directive applied to the current request. |
path_info |
string | no | The PATH_INFO extracted from this request. |
port |
number | no | The server port used by the request. |
protocol |
string | no | The protocol used, f.x. HTTP/1.1 |
proxyreq |
string | yes | Denotes whether this is a proxy request or not. This value is generally set in the post_read_request/pre_translate_name/translate_name phase of a request. |
range |
string | no | The contents of the Range: header. |
remaining |
number | no | The number of bytes remaining to be read from the request body. |
server_built |
string | no | The time the server executable was built. |
server_name |
string | no | The server name for this request. |
some_auth_required |
boolean | no | Whether some authorization is/was required for this request. |
subprocess_env |
table | yes | The environment variables set for this request. A read-only lua table suitable for iteration is available as r:subprocess_env_table(). |
started |
number | no | The time the server was (re)started, in seconds since the epoch (Jan 1st, 1970) |
status |
number | yes | The (current) HTTP return code for this request, f.x. 200 or 404. |
the_request |
string | no | The request string as sent by the client, f.x. GET /foo/bar HTTP/1.1. |
unparsed_uri |
string | no | The unparsed URI of the request |
uri |
string | yes | The URI after it has been parsed by httpd |
user |
string | yes | If an authentication check has been made, this is set to the name of the authenticated user. |
useragent_ip |
string | no | The IP of the user agent making the request |
The request_rec object has (at least) the following methods:
r:flush() -- flushes the output buffer.
-- Returns true if the flush was successful, false otherwise.
while we_have_stuff_to_send do
r:puts("Bla bla bla\n") -- print something to client
r:flush() -- flush the buffer (send to client)
r.usleep(500000) -- fake processing time for 0.5 sec. and repeat
end
r:add_output_filter(filter_name) -- add an output filter:
r:add_output_filter("fooFilter") -- add the fooFilter to the output stream
r:sendfile(filename) -- sends an entire file to the client, using sendfile if supported by the current platform:
if use_sendfile_thing then
r:sendfile("/var/www/large_file.img")
end
r:parseargs() -- returns two tables; one standard key/value table for regular GET data,
-- and one for multi-value data (fx. foo=1&foo=2&foo=3):
local GET, GETMULTI = r:parseargs()
r:puts("Your name is: " .. GET['name'] or "Unknown")
r:parsebody([sizeLimit]) -- parse the request body as a POST and return two lua tables,
-- just like r:parseargs().
-- An optional number may be passed to specify the maximum number
-- of bytes to parse. Default is 8192 bytes:
local POST, POSTMULTI = r:parsebody(1024*1024)
r:puts("Your name is: " .. POST['name'] or "Unknown")
r:puts("hello", " world", "!") -- print to response body, self explanatory
r:write("a single string") -- print to response body, self explanatory
r:escape_html("<html>test</html>") -- Escapes HTML code and returns the escaped result
r:base64_encode(string) -- Encodes a string using the Base64 encoding standard:
local encoded = r:base64_encode("This is a test") -- returns VGhpcyBpcyBhIHRlc3Q=
r:base64_decode(string) -- Decodes a Base64-encoded string:
local decoded = r:base64_decode("VGhpcyBpcyBhIHRlc3Q=") -- returns 'This is a test'
r:md5(string) -- Calculates and returns the MD5 digest of a string (binary safe):
local hash = r:md5("This is a test") -- returns ce114e4501d2f4e2dcea3e17b546f339
r:sha1(string) -- Calculates and returns the SHA1 digest of a string (binary safe):
local hash = r:sha1("This is a test") -- returns a54d88e06612d820bc3be72877c74f257b561b19
r:escape(string) -- URL-Escapes a string: local url = "http://foo.bar/1 2 3 & 4 + 5" local escaped = r:escape(url) -- returns 'http%3a%2f%2ffoo.bar%2f1+2+3+%26+4+%2b+5'
r:unescape(string) -- Unescapes an URL-escaped string: local url = "http%3a%2f%2ffoo.bar%2f1+2+3+%26+4+%2b+5" local unescaped = r:unescape(url) -- returns 'http://foo.bar/1 2 3 & 4 + 5'
r:construct_url(string) -- Constructs an URL from an URI local url = r:construct_url(r.uri)
r.mpm_query(number) -- Queries the server for MPM information using ap_mpm_query:
local mpm = r.mpm_query(14)
if mpm == 1 then
r:puts("This server uses the Event MPM")
end
r:expr(string) -- Evaluates an expr string. if r:expr("%{HTTP_HOST} =~ /^www/") then r:puts("This host name starts with www") end
r:scoreboard_process(a) -- Queries the server for information about the process at position a:
local process = r:scoreboard_process(1)
r:puts("Server 1 has PID " .. process.pid)
r:scoreboard_worker(a, b) -- Queries for information about the worker thread,b, in processa: local thread = r:scoreboard_worker(1, 1) r:puts("Server 1's thread 1 has thread ID " .. thread.tid .. " and is in " .. thread.status .. " status")
r:clock() -- Returns the current time with microsecond precision
r:requestbody(filename) -- Reads and returns the request body of a request.
-- If 'filename' is specified, it instead saves the
-- contents to that file:
local input = r:requestbody()
r:puts("You sent the following request body to me:\n")
r:puts(input)
r:add_input_filter(filter_name) -- Adds 'filter_name' as an input filter
r.module_info(module_name) -- Queries the server for information about a module
local mod = r.module_info("mod_lua.c")
if mod then
for k, v in pairs(mod.commands) do
r:puts( ("%s: %s\n"):format(k,v)) -- print out all directives accepted by this module
end
end
r:loaded_modules() -- Returns a list of modules loaded by httpd:
for k, module in pairs(r:loaded_modules()) do
r:puts("I have loaded module " .. module .. "\n")
end
r:runtime_dir_relative(filename) -- Compute the name of a run-time file (e.g., shared memory "file")
-- relative to the appropriate run-time directory.
r:server_info() -- Returns a table containing server information, such as
-- the name of the httpd executable file, mpm used etc.
r:set_document_root(file_path) -- Sets the document root for the request to file_path
r:set_context_info(prefix, docroot) -- Sets the context prefix and context document root for a request
r:os_escape_path(file_path) -- Converts an OS path to a URL in an OS dependent way
r:escape_logitem(string) -- Escapes a string for logging
r.strcmp_match(string, pattern) -- Checks if 'string' matches 'pattern' using strcmp_match (globs).
-- fx. whether 'www.example.com' matches '*.example.com':
local match = r.strcmp_match("foobar.com", "foo*.com")
if match then
r:puts("foobar.com matches foo*.com")
end
r:set_keepalive() -- Sets the keepalive status for a request. Returns true if possible, false otherwise.
r:make_etag() -- Constructs and returns the etag for the current request.
r:send_interim_response(clear) -- Sends an interim (1xx) response to the client.
-- if 'clear' is true, available headers will be sent and cleared.
r:custom_response(status_code, string) -- Construct and set a custom response for a given status code.
-- This works much like the ErrorDocument directive:
r:custom_response(404, "Baleted!")
r.exists_config_define(string) -- Checks whether a configuration definition exists or not:
if r.exists_config_define("FOO") then
r:puts("httpd was probably run with -DFOO, or it was defined in the configuration")
end
r:state_query(string) -- Queries the server for state information
r:stat(filename [,wanted]) -- Runs stat() on a file, and returns a table with file information:
local info = r:stat("/var/www/foo.txt")
if info then
r:puts("This file exists and was last modified at: " .. info.modified)
end
r:regex(string, pattern [,flags]) -- Runs a regular expression match on a string, returning captures if matched:
local matches = r:regex("foo bar baz", [[foo (\w+) (\S*)]])
if matches then
r:puts("The regex matched, and the last word captured ($2) was: " .. matches[2])
end
-- Example ignoring case sensitivity:
local matches = r:regex("FOO bar BAz", [[(foo) bar]], 1)
-- Flags can be a bitwise combination of:
-- 0x01: Ignore case
-- 0x02: Multiline search
r.usleep(number_of_microseconds) -- Puts the script to sleep for a given number of microseconds.
r:dbacquire(dbType[, dbParams]) -- Acquires a connection to a database and returns a database class.
-- See 'Database connectivity' for details.
r:ivm_set("key", value) -- Set an Inter-VM variable to hold a specific value.
-- These values persist even though the VM is gone or not being used,
-- and so should only be used if MaxConnectionsPerChild is > 0
-- Values can be numbers, strings and booleans, and are stored on a
-- per process basis (so they won't do much good with a prefork mpm)
r:ivm_get("key") -- Fetches a variable set by ivm_set. Returns the contents of the variable
-- if it exists or nil if no such variable exists.
-- An example getter/setter that saves a global variable outside the VM:
function handle(r)
-- First VM to call this will get no value, and will have to create it
local foo = r:ivm_get("cached_data")
if not foo then
foo = do_some_calcs() -- fake some return value
r:ivm_set("cached_data", foo) -- set it globally
end
r:puts("Cached data is: ", foo)
end
r:htpassword(string [,algorithm [,cost]]) -- Creates a password hash from a string.
-- algorithm: 0 = APMD5 (default), 1 = SHA, 2 = BCRYPT, 3 = CRYPT.
-- cost: only valid with BCRYPT algorithm (default = 5).
r:mkdir(dir [,mode]) -- Creates a directory and sets mode to optional mode parameter.
r:mkrdir(dir [,mode]) -- Creates directories recursive and sets mode to optional mode parameter.
r:rmdir(dir) -- Removes a directory.
r:touch(file [,mtime]) -- Sets the file modification time to current time or to optional mtime msec value.
r:get_direntries(dir) -- Returns a table with all directory entries.
function handle(r)
local dir = r.context_document_root
for _, f in ipairs(r:get_direntries(dir)) do
local info = r:stat(dir .. "/" .. f)
if info then
local mtime = os.date(fmt, info.mtime / 1000000)
local ftype = (info.filetype == 2) and "[dir] " or "[file]"
r:puts( ("%s %s %10i %s\n"):format(ftype, mtime, info.size, f) )
end
end
end
r.date_parse_rfc(string) -- Parses a date/time string and returns seconds since epoche.
r:getcookie(key) -- Gets a HTTP cookie
r:setcookie{
key = [key],
value = [value],
expires = [expiry],
secure = [boolean],
httponly = [boolean],
path = [path],
domain = [domain]
} -- Sets a HTTP cookie, for instance:
r:setcookie{
key = "cookie1",
value = "HDHfa9eyffh396rt",
expires = os.time() + 86400,
secure = true
}
r:wsupgrade() -- Upgrades a connection to WebSockets if possible (and requested):
if r:wsupgrade() then -- if we can upgrade:
r:wswrite("Welcome to websockets!") -- write something to the client
r:wsclose() -- goodbye!
end
r:wsread() -- Reads a WebSocket frame from a WebSocket upgraded connection (see above):
local line, isFinal = r:wsread() -- isFinal denotes whether this is the final frame.
-- If it isn't, then more frames can be read
r:wswrite("You wrote: " .. line)
r:wswrite(line) -- Writes a frame to a WebSocket client:
r:wswrite("Hello, world!")
r:wsclose() -- Closes a WebSocket request and terminates it for httpd:
if r:wsupgrade() then
r:wswrite("Write something: ")
local line = r:wsread() or "nothing"
r:wswrite("You wrote: " .. line);
r:wswrite("Goodbye!")
r:wsclose()
end
-- examples of logging messages
r:trace1("This is a trace log message") -- trace1 through trace8 can be used
r:debug("This is a debug log message")
r:info("This is an info log message")
r:notice("This is a notice log message")
r:warn("This is a warn log message")
r:err("This is an err log message")
r:alert("This is an alert log message")
r:crit("This is a crit log message")
r:emerg("This is an emerg log message")
A package named apache2 is available with (at least) the following contents.
mod_proxymod_authz_core(Other HTTP status codes are not yet implemented.)
Filter functions implemented via LuaInputFilter
or LuaOutputFilter are designed as
three-stage non-blocking functions using coroutines to suspend and resume a
function as buckets are sent down the filter chain. The core structure of
such a function is:
function filter(r)
-- Our first yield is to signal that we are ready to receive buckets.
-- Before this yield, we can set up our environment, check for conditions,
-- and, if we deem it necessary, decline filtering a request altogether:
if something_bad then
return -- This would skip this filter.
end
-- Regardless of whether we have data to prepend, a yield MUST be called here.
-- Note that only output filters can prepend data. Input filters must use the
-- final stage to append data to the content.
coroutine.yield([optional header to be prepended to the content])
-- After we have yielded, buckets will be sent to us, one by one, and we can
-- do whatever we want with them and then pass on the result.
-- Buckets are stored in the global variable 'bucket', so we create a loop
-- that checks if 'bucket' is not nil:
while bucket ~= nil do
local output = mangle(bucket) -- Do some stuff to the content
coroutine.yield(output) -- Return our new content to the filter chain
end
-- Once the buckets are gone, 'bucket' is set to nil, which will exit the
-- loop and land us here. Anything extra we want to append to the content
-- can be done by doing a final yield here. Both input and output filters
-- can append data to the content in this phase.
coroutine.yield([optional footer to be appended to the content])
end
Mod_lua implements a simple database feature for querying and running commands on the most popular database engines (mySQL, PostgreSQL, FreeTDS, ODBC, SQLite, Oracle) as well as mod_dbd.
The dbType to use as the first parameter of dbacquire
is case sensitive.
It should be one of mysql, pgsql, freetds,
odbc, sqlite2, sqlite3, oracle
or mod_dbd.
The example below shows how to acquire a database handle and return information from a table:
function handle(r)
-- Acquire a database handle
local database, err = r:dbacquire("mysql", "server=localhost,user=someuser,pass=somepass,dbname=mydb")
if not err then
-- Select some information from it
local results, err = database:select(r, "SELECT `name`, `age` FROM `people` WHERE 1")
if not err then
local rows = results(0) -- fetch all rows synchronously
for k, row in pairs(rows) do
r:puts( string.format("Name: %s, Age: %s<br/>", row[1], row[2]) )
end
else
r:puts("Database query error: " .. err)
end
database:close()
else
r:puts("Could not connect to the database: " .. err)
end
end
To utilize mod_dbd, specify mod_dbd
as the database type, or leave the field blank:
local database = r:dbacquire("mod_dbd")
The database object returned by dbacquire has the following methods:
Normal select and query from a database:
-- Run a statement and return the number of rows affected: local affected, errmsg = database:query(r, "DELETE FROM `tbl` WHERE 1") -- Run a statement and return a result set that can be used synchronously or async: local result, errmsg = database:select(r, "SELECT * FROM `people` WHERE 1")
Using prepared statements (recommended):
-- Create and run a prepared statement:
local statement, errmsg = database:prepare(r, "DELETE FROM `tbl` WHERE `age` > %u")
if not errmsg then
local result, errmsg = statement:query(20) -- run the statement with age > 20
end
-- Fetch a prepared statement from a DBDPrepareSQL directive:
local statement, errmsg = database:prepared(r, "someTag")
if not errmsg then
local result, errmsg = statement:select("John Doe", 123) -- inject the values "John Doe" and 123 into the statement
end
Escaping values, closing databases etc:
-- Escape a value for use in a statement: local escaped = database:escape(r, [["'|blabla]]) -- Close a database connection and free up handles: database:close() -- Check whether a database connection is up and running: local connected = database:active()
The result set returned by db:select or by the prepared statement functions
created through db:prepare can be used to
fetch rows synchronously or asynchronously, depending on the row number specified:
result(0) fetches all rows in a synchronous manner, returning a table of rows.
result(-1) fetches the next available row in the set, asynchronously.
result(N) fetches row number N, asynchronously:
-- fetch a result set using a regular query: local result, err = db:select(r, "SELECT * FROM `tbl` WHERE 1") local rows = result(0) -- Fetch ALL rows synchronously local row = result(-1) -- Fetch the next available row, asynchronously local row = result(1234) -- Fetch row number 1234, asynchronously local row = result(-1, true) -- Fetch the next available row, using row names as key indexes.
One can construct a function that returns an iterative function to iterate over all rows in a synchronous or asynchronous way, depending on the async argument:
function rows(resultset, async)
local a = 0
local function getnext()
a = a + 1
local row = resultset(-1)
return row and a or nil, row
end
if not async then
return pairs(resultset(0))
else
return getnext, self
end
end
local statement, err = db:prepare(r, "SELECT * FROM `tbl` WHERE `age` > %u")
if not err then
-- fetch rows asynchronously:
local result, err = statement:select(20)
if not err then
for index, row in rows(result, true) do
....
end
end
-- fetch rows synchronously:
local result, err = statement:select(20)
if not err then
for index, row in rows(result, false) do
....
end
end
end
Database handles should be closed using database:close() when they are no longer
needed. If you do not close them manually, they will eventually be garbage collected and
closed by mod_lua, but you may end up having too many unused connections to the database
if you leave the closing up to mod_lua. Essentially, the following two measures are
the same:
-- Method 1: Manually close a handle
local database = r:dbacquire("mod_dbd")
database:close() -- All done
-- Method 2: Letting the garbage collector close it
local database = r:dbacquire("mod_dbd")
database = nil -- throw away the reference
collectgarbage() -- close the handle via GC
Although the standard query and run functions are freely
available, it is recommended that you use prepared statements whenever possible, to
both optimize performance (if your db handle lives on for a long time) and to minimize
the risk of SQL injection attacks. run and query should only
be used when there are no variables inserted into a statement (a static statement).
When using dynamic statements, use db:prepare or db:prepared.
| Description: | Plug an authorization provider function into mod_authz_core
|
|---|---|
| Syntax: | LuaAuthzProvider provider_name /path/to/lua/script.lua function_name |
| Context: | server config |
| Status: | Extension |
| Module: | mod_lua |
| Compatibility: | 2.4.3 and later |
After a lua function has been registered as authorization provider, it can be used
with the Require directive:
LuaRoot "/usr/local/apache2/lua" LuaAuthzProvider foo authz.lua authz_check_foo <Location "/"> Require foo johndoe </Location>
require "apache2"
function authz_check_foo(r, who)
if r.user ~= who then return apache2.AUTHZ_DENIED
return apache2.AUTHZ_GRANTED
end
| Description: | Configure the compiled code cache. |
|---|---|
| Syntax: | LuaCodeCache stat|forever|never |
| Default: | LuaCodeCache stat |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
Specify the behavior of the in-memory code cache. The default is stat, which stats the top level script (not any included ones) each time that file is needed, and reloads it if the modified time indicates it is newer than the one it has already loaded. The other values cause it to keep the file cached forever (don't stat and replace) or to never cache the file.
In general stat or forever is good for production, and stat or never for development.
LuaCodeCache stat LuaCodeCache forever LuaCodeCache never
| Description: | Provide a hook for the access_checker phase of request processing |
|---|---|
| Syntax: | LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
| Compatibility: | The optional third argument is supported in 2.3.15 and later |
Add your hook to the access_checker phase. An access checker hook function usually returns OK, DECLINED, or HTTP_FORBIDDEN.
The optional arguments "early" or "late" control when this script runs relative to other modules.
| Description: | Provide a hook for the auth_checker phase of request processing |
|---|---|
| Syntax: | LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
| Compatibility: | The optional third argument is supported in 2.3.15 and later |
Invoke a lua function in the auth_checker phase of processing a request. This can be used to implement arbitrary authentication and authorization checking. A very simple example:
require 'apache2'
-- fake authcheck hook
-- If request has no auth info, set the response header and
-- return a 401 to ask the browser for basic auth info.
-- If request has auth info, don't actually look at it, just
-- pretend we got userid 'foo' and validated it.
-- Then check if the userid is 'foo' and accept the request.
function authcheck_hook(r)
-- look for auth info
auth = r.headers_in['Authorization']
if auth ~= nil then
-- fake the user
r.user = 'foo'
end
if r.user == nil then
r:debug("authcheck: user is nil, returning 401")
r.err_headers_out['WWW-Authenticate'] = 'Basic realm="WallyWorld"'
return 401
elseif r.user == "foo" then
r:debug('user foo: OK')
else
r:debug("authcheck: user='" .. r.user .. "'")
r.err_headers_out['WWW-Authenticate'] = 'Basic realm="WallyWorld"'
return 401
end
return apache2.OK
end
The optional arguments "early" or "late" control when this script runs relative to other modules.
| Description: | Provide a hook for the check_user_id phase of request processing |
|---|---|
| Syntax: | LuaHookCheckUserID /path/to/lua/script.lua hook_function_name [early|late] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
| Compatibility: | The optional third argument is supported in 2.3.15 and later |
...
The optional arguments "early" or "late" control when this script runs relative to other modules.
| Description: | Provide a hook for the fixups phase of a request processing |
|---|---|
| Syntax: | LuaHookFixups /path/to/lua/script.lua hook_function_name |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
Just like LuaHookTranslateName, but executed at the fixups phase
| Description: | Provide a hook for the insert_filter phase of request processing |
|---|---|
| Syntax: | LuaHookInsertFilter /path/to/lua/script.lua hook_function_name |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
Not Yet Implemented
| Description: | Provide a hook for the access log phase of a request processing |
|---|---|
| Syntax: | LuaHookLog /path/to/lua/script.lua log_function_name |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
This simple logging hook allows you to run a function when httpd enters the
logging phase of a request. With it, you can append data to your own logs,
manipulate data before the regular log is written, or prevent a log entry
from being created. To prevent the usual logging from happening, simply return
apache2.DONE in your logging handler, otherwise return
apache2.OK to tell httpd to log as normal.
Example:
LuaHookLog "/path/to/script.lua" logger
-- /path/to/script.lua --
function logger(r)
-- flip a coin:
-- If 1, then we write to our own Lua log and tell httpd not to log
-- in the main log.
-- If 2, then we just sanitize the output a bit and tell httpd to
-- log the sanitized bits.
if math.random(1,2) == 1 then
-- Log stuff ourselves and don't log in the regular log
local f = io.open("/foo/secret.log", "a")
if f then
f:write("Something secret happened at " .. r.uri .. "\n")
f:close()
end
return apache2.DONE -- Tell httpd not to use the regular logging functions
else
r.uri = r.uri:gsub("somesecretstuff", "") -- sanitize the URI
return apache2.OK -- tell httpd to log it.
end
end
| Description: | Provide a hook for the map_to_storage phase of request processing |
|---|---|
| Syntax: | LuaHookMapToStorage /path/to/lua/script.lua hook_function_name |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
Like LuaHookTranslateName but executed at the
map-to-storage phase of a request. Modules like mod_cache run at this phase,
which makes for an interesting example on what to do here:
LuaHookMapToStorage "/path/to/lua/script.lua" check_cache
require"apache2"
cached_files = {}
function read_file(filename)
local input = io.open(filename, "r")
if input then
local data = input:read("*a")
cached_files[filename] = data
file = cached_files[filename]
input:close()
end
return cached_files[filename]
end
function check_cache(r)
if r.filename:match("%.png$") then -- Only match PNG files
local file = cached_files[r.filename] -- Check cache entries
if not file then
file = read_file(r.filename) -- Read file into cache
end
if file then -- If file exists, write it out
r.status = 200
r:write(file)
r:info(("Sent %s to client from cache"):format(r.filename))
return apache2.DONE -- skip default handler for PNG files
end
end
return apache2.DECLINED -- If we had nothing to do, let others serve this.
end
| Description: | Provide a hook for the pre_translate phase of a request processing |
|---|---|
| Syntax: | LuaHookPreTranslate /path/to/lua/script.lua hook_function_name |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
Just like LuaHookTranslateName, but executed at the pre_translate phase, where the URI-path is not percent decoded.
| Description: | Provide a hook for the translate name phase of request processing |
|---|---|
| Syntax: | LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late] |
| Context: | server config, virtual host |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
| Compatibility: | The optional third argument is supported in 2.3.15 and later |
Add a hook (at APR_HOOK_MIDDLE) to the translate name phase of request processing. The hook function receives a single argument, the request_rec, and should return a status code, which is either an HTTP error code, or the constants defined in the apache2 module: apache2.OK, apache2.DECLINED, or apache2.DONE.
For those new to hooks, basically each hook will be invoked until one of them returns apache2.OK. If your hook doesn't want to do the translation it should just return apache2.DECLINED. If the request should stop processing, then return apache2.DONE.
Example:
# httpd.conf LuaHookTranslateName "/scripts/conf/hooks.lua" silly_mapper
-- /scripts/conf/hooks.lua --
require "apache2"
function silly_mapper(r)
if r.uri == "/" then
r.filename = "/var/www/home.lua"
return apache2.OK
else
return apache2.DECLINED
end
end
This directive is not valid in <Directory>, <Files>, or htaccess
context.
The optional arguments "early" or "late" control when this script runs relative to other modules.
| Description: | Provide a hook for the type_checker phase of request processing |
|---|---|
| Syntax: | LuaHookTypeChecker /path/to/lua/script.lua hook_function_name |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
This directive provides a hook for the type_checker phase of the request processing. This phase is where requests are assigned a content type and a handler, and thus can be used to modify the type and handler based on input:
LuaHookTypeChecker "/path/to/lua/script.lua" type_checker
function type_checker(r)
if r.uri:match("%.to_gif$") then -- match foo.png.to_gif
r.content_type = "image/gif" -- assign it the image/gif type
r.handler = "gifWizard" -- tell the gifWizard module to handle this
r.filename = r.uri:gsub("%.to_gif$", "") -- fix the filename requested
return apache2.OK
end
return apache2.DECLINED
end
| Description: | Controls how parent configuration sections are merged into children |
|---|---|
| Syntax: | LuaInherit none|parent-first|parent-last |
| Default: | LuaInherit parent-first |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
| Compatibility: | 2.4.0 and later |
By default, if LuaHook* directives are used in overlapping Directory or Location configuration sections, the scripts defined in the more specific section are run after those defined in the more generic section (LuaInherit parent-first). You can reverse this order, or make the parent context not apply at all.
In previous 2.3.x releases, the default was effectively to ignore LuaHook* directives from parent configuration sections.
| Description: | Provide a Lua function for content input filtering |
|---|---|
| Syntax: | LuaInputFilter filter_name /path/to/lua/script.lua function_name |
| Context: | server config |
| Status: | Extension |
| Module: | mod_lua |
| Compatibility: | 2.4.5 and later |
Provides a means of adding a Lua function as an input filter.
As with output filters, input filters work as coroutines,
first yielding before buffers are sent, then yielding whenever
a bucket needs to be passed down the chain, and finally (optionally)
yielding anything that needs to be appended to the input data. The
global variable bucket holds the buckets as they are passed
onto the Lua script:
LuaInputFilter myInputFilter "/www/filter.lua" input_filter <Files "*.lua"> SetInputFilter myInputFilter </Files>
--[[
Example input filter that converts all POST data to uppercase.
]]--
function input_filter(r)
print("luaInputFilter called") -- debug print
coroutine.yield() -- Yield and wait for buckets
while bucket do -- For each bucket, do...
local output = string.upper(bucket) -- Convert all POST data to uppercase
coroutine.yield(output) -- Send converted data down the chain
end
-- No more buckets available.
coroutine.yield("&filterSignature=1234") -- Append signature at the end
end
The input filter supports denying/skipping a filter if it is deemed unwanted:
function input_filter(r)
if not good then
return -- Simply deny filtering, passing on the original content instead
end
coroutine.yield() -- wait for buckets
... -- insert filter stuff here
end
See "Modifying contents with Lua filters" for more information.
| Description: | Map a path to a lua handler |
|---|---|
| Syntax: | LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
This directive matches a uri pattern to invoke a specific handler function in a specific file. It uses PCRE regular expressions to match the uri, and supports interpolating match groups into both the file path and the function name. Be careful writing your regular expressions to avoid security issues.
LuaMapHandler "/(\w+)/(\w+)" "/scripts/$1.lua" "handle_$2"
This would match uri's such as /photos/show?id=9 to the file /scripts/photos.lua and invoke the handler function handle_show on the lua vm after loading that file.
LuaMapHandler "/bingo" "/scripts/wombat.lua"
This would invoke the "handle" function, which is the default if no specific function name is provided.
| Description: | Provide a Lua function for content output filtering |
|---|---|
| Syntax: | LuaOutputFilter filter_name /path/to/lua/script.lua function_name |
| Context: | server config |
| Status: | Extension |
| Module: | mod_lua |
| Compatibility: | 2.4.5 and later |
Provides a means of adding a Lua function as an output filter.
As with input filters, output filters work as coroutines,
first yielding before buffers are sent, then yielding whenever
a bucket needs to be passed down the chain, and finally (optionally)
yielding anything that needs to be appended to the input data. The
global variable bucket holds the buckets as they are passed
onto the Lua script:
LuaOutputFilter myOutputFilter "/www/filter.lua" output_filter <Files "*.lua"> SetOutputFilter myOutputFilter </Files>
--[[
Example output filter that escapes all HTML entities in the output
]]--
function output_filter(r)
coroutine.yield("(Handled by myOutputFilter)<br/>\n") -- Prepend some data to the output,
-- yield and wait for buckets.
while bucket do -- For each bucket, do...
local output = r:escape_html(bucket) -- Escape all output
coroutine.yield(output) -- Send converted data down the chain
end
-- No more buckets available.
end
As with the input filter, the output filter supports denying/skipping a filter if it is deemed unwanted:
function output_filter(r)
if not r.content_type:match("text/html") then
return -- Simply deny filtering, passing on the original content instead
end
coroutine.yield() -- wait for buckets
... -- insert filter stuff here
end
mod_filter When a Lua filter is used as the underlying provider via the
FilterProvider directive, filtering
will only work when the filter-name is identical to the provider-name.
See "Modifying contents with Lua filters" for more information.
| Description: | Add a directory to lua's package.cpath |
|---|---|
| Syntax: | LuaPackageCPath /path/to/include/?.soa |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
Add a path to lua's shared library search path. Follows the same conventions as lua. This just munges the package.cpath in the lua vms.
| Description: | Add a directory to lua's package.path |
|---|---|
| Syntax: | LuaPackagePath /path/to/include/?.lua |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
Add a path to lua's module search path. Follows the same conventions as lua. This just munges the package.path in the lua vms.
LuaPackagePath "/scripts/lib/?.lua" LuaPackagePath "/scripts/lib/?/init.lua"
| Description: | Provide a hook for the quick handler of request processing |
|---|---|
| Syntax: | LuaQuickHandler /path/to/script.lua hook_function_name |
| Context: | server config, virtual host |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
This phase is run immediately after the request has been mapped to a virtual host,
and can be used to either do some request processing before the other phases kick
in, or to serve a request without the need to translate, map to storage et cetera.
As this phase is run before anything else, directives such as <Location> or <Directory> are void in this phase, just as
URIs have not been properly parsed yet.
This directive is not valid in <Directory>, <Files>, or htaccess
context.
| Description: | Specify the base path for resolving relative paths for mod_lua directives |
|---|---|
| Syntax: | LuaRoot /path/to/a/directory |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
Specify the base path which will be used to evaluate all relative paths within mod_lua. If not specified they will be resolved relative to the current working directory, which may not always work well for a server.
| Description: | One of once, request, conn, thread -- default is once |
|---|---|
| Syntax: | LuaScope once|request|conn|thread|server [min] [max] |
| Default: | LuaScope once |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_lua |
Specify the life cycle scope of the Lua interpreter which will be used by handlers in this "Directory." The default is "once"
min and max arguments
specify the minimum and maximum number of Lua states to keep in the
pool.
Generally speaking, the thread and server scopes
execute roughly 2-3 times faster than the rest, because they don't have to
spawn new Lua states on every request (especially with the event MPM, as
even keepalive requests will use a new thread for each request). If you are
satisfied that your scripts will not have problems reusing a state, then
the thread or server scopes should be used for
maximum performance. While the thread scope will provide the
fastest responses, the server scope will use less memory, as
states are pooled, allowing f.x. 1000 threads to share only 100 Lua states,
thus using only 10% of the memory required by the thread scope.
Apache HTTP Server Version 2.4
| Description: | Determines the MIME type of a file by looking at a few bytes of its contents |
|---|---|
| Status: | Extension |
| Module Identifier: | mime_magic_module |
| Source File: | mod_mime_magic.c |
This module determines the MIME
type of files in the same way the Unix
file(1) command works: it looks at the first few
bytes of the file. It is intended as a "second line of defense"
for cases that mod_mime can't resolve.
This module is derived from a free version of the
file(1) command for Unix, which uses "magic
numbers" and other hints from a file's contents to figure out
what the contents are. This module is active only if the magic
file is specified by the MimeMagicFile directive.
The contents of the file are plain ASCII text in 4-5
columns. Blank lines are allowed but ignored. Commented lines
use a hash mark (#). The remaining lines are parsed for
the following columns:
| Column | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | byte number to begin checking from " >" indicates a dependency upon the previous
non-">" line | ||||||||||||||||||||||
| 2 | type of data to match
| ||||||||||||||||||||||
| 3 | contents of data to match | ||||||||||||||||||||||
| 4 | MIME type if matched | ||||||||||||||||||||||
| 5 | MIME encoding if matched (optional) |
For example, the following magic file lines would recognize some audio formats:
# Sun/NeXT audio data 0 string .snd >12 belong 1 audio/basic >12 belong 2 audio/basic >12 belong 3 audio/basic >12 belong 4 audio/basic >12 belong 5 audio/basic >12 belong 6 audio/basic >12 belong 7 audio/basic >12 belong 23 audio/x-adpcm
Or these would recognize the difference between *.doc
files containing Microsoft Word or FrameMaker documents. (These are
incompatible file formats which use the same file suffix.)
# Frame 0 string \<MakerFile application/x-frame 0 string \<MIFFile application/x-frame 0 string \<MakerDictionary application/x-frame 0 string \<MakerScreenFon application/x-frame 0 string \<MML application/x-frame 0 string \<Book application/x-frame 0 string \<Maker application/x-frame # MS-Word 0 string \376\067\0\043 application/msword 0 string \320\317\021\340\241\261 application/msword 0 string \333\245-\0\0\0 application/msword
An optional MIME encoding can be included as a fifth column. For example, this can recognize gzipped files and set the encoding for them.
# gzip (GNU zip, not to be confused with # [Info-ZIP/PKWARE] zip archiver) 0 string \037\213 application/octet-stream x-gzip
This module is not for every system. If your system is barely keeping up with its load or if you're performing a web server benchmark, you may not want to enable this because the processing is not free.
However, an effort was made to improve the performance of
the original file(1) code to make it fit in a busy web
server. It was designed for a server where there are thousands of users
who publish their own documents. This is probably very common
on intranets. Many times, it's helpful if the server can make
more intelligent decisions about a file's contents than the
file name allows ...even if just to reduce the "why doesn't my
page work" calls when users improperly name their own files.
You have to decide if the extra work suits your
environment.
The following notes apply to the mod_mime_magic
module and are included here for compliance with contributors'
copyright restrictions that require their acknowledgment.
mod_mime_magic: MIME type lookup via file magic numbers
Copyright (c) 1996-1997 Cisco Systems, Inc.
This software was submitted by Cisco Systems to the Apache Group in July 1997. Future revisions and derivatives of this source code must acknowledge Cisco Systems as the original contributor of this module. All other licensing and usage conditions are those of the Apache Group.
Some of this code is derived from the free version of the file command originally posted to comp.sources.unix. Copyright info for that program is included below as required.
- Copyright (c) Ian F. Darwin, 1987. Written by Ian F. Darwin.
This software is not subject to any license of the American Telephone and Telegraph Company or of the Regents of the University of California.
Permission is granted to anyone to use this software for any purpose on any computer system, and to alter it and redistribute it freely, subject to the following restrictions:
For compliance with Mr Darwin's terms: this has been very significantly modified from the free "file" command.
realloc().| Description: | Enable MIME-type determination based on file contents using the specified magic file |
|---|---|
| Syntax: | MimeMagicFile file-path |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_mime_magic |
The MimeMagicFile directive can be used to
enable this module, the default file is distributed at
conf/magic. Non-rooted paths are relative to the
ServerRoot. Virtual hosts will use
the same file as the main server unless a more specific setting is
used, in which case the more specific setting overrides the main
server's file.
MimeMagicFile conf/magic
Apache HTTP Server Version 2.4
| Description: | Support for Solaris privileges and for running virtual hosts under different user IDs. |
|---|---|
| Status: | Experimental |
| Module Identifier: | privileges_module |
| Source File: | mod_privileges.c |
| Compatibility: | Available in Apache 2.3 and up, on Solaris 10 and OpenSolaris platforms |
This module enables different Virtual Hosts to run with different Unix User and Group IDs, and with different Solaris Privileges. In particular, it offers a solution to the problem of privilege separation between different Virtual Hosts, first promised by the abandoned perchild MPM. It also offers other security enhancements.
Unlike perchild, mod_privileges
is not itself an MPM. It works within a processing model to
set privileges and User/Group per request in a running process.
It is therefore not compatible with a threaded MPM, and will refuse
to run under one.
mod_privileges raises security issues similar to
those of suexec. But unlike suexec,
it applies not only to CGI programs but to the entire request processing
cycle, including in-process applications and subprocesses.
It is ideally suited to running PHP applications under mod_php,
which is also incompatible with threaded MPMs. It is also well-suited
to other in-process scripting applications such as mod_perl,
mod_python, and mod_ruby, and to
applications implemented in C as apache modules where privilege
separation is an issue.
DTracePrivileges PrivilegesMode VHostCGIMode VHostCGIPrivs VHostGroup VHostPrivs VHostSecure VHostUsermod_privileges introduces new security concerns
in situations where untrusted code may be run
within the webserver process. This applies to
untrusted modules, and scripts running under modules such as
mod_php or mod_perl. Scripts running externally (e.g. as CGI
or in an appserver behind mod_proxy or mod_jk) are NOT affected.
The basic security concerns with mod_privileges are:
The PrivilegesMode directive allows you to
select either FAST or SECURE mode. You can
mix modes, using FAST mode for trusted users and
fully-audited code paths, while imposing SECURE mode where an
untrusted user has scope to introduce code.
Before describing the modes, we should also introduce the target use cases: Benign vs Hostile. In a benign situation, you want to separate users for their convenience, and protect them and the server against the risks posed by honest mistakes, but you trust your users are not deliberately subverting system security. In a hostile situation - e.g. commercial hosting - you may have users deliberately attacking the system or each other.
You can select different PrivilegesModes for
each virtual host, and even in a directory context within a virtual
host. FAST mode is appropriate where the user(s) are
trusted and/or have no privilege to load in-process code.
SECURE mode is appropriate to cases where untrusted code
might be run in-process. However, even in SECURE mode,
there is no protection against a malicious user who is able to
introduce privileges-aware code running before the start of the
request-processing cycle.
| Description: | Determines whether the privileges required by dtrace are enabled. |
|---|---|
| Syntax: | DTracePrivileges On|Off |
| Default: | DTracePrivileges Off |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_privileges |
| Compatibility: | Available on Solaris 10 and OpenSolaris with
non-threaded MPMs (prefork or custom MPM). |
This server-wide directive determines whether Apache will run with the privileges required to run dtrace. Note that DTracePrivileges On will not in itself activate DTrace, but DTracePrivileges Off will prevent it working.
| Description: | Trade off processing speed and efficiency vs security against malicious privileges-aware code. |
|---|---|
| Syntax: | PrivilegesMode FAST|SECURE|SELECTIVE |
| Default: | PrivilegesMode FAST |
| Context: | server config, virtual host, directory |
| Status: | Experimental |
| Module: | mod_privileges |
| Compatibility: | Available on Solaris 10 and OpenSolaris with
non-threaded MPMs (prefork or custom MPM). |
This directive trades off performance vs security against malicious, privileges-aware code. In SECURE mode, each request runs in a secure subprocess, incurring a substantial performance penalty. In FAST mode, the server is not protected against escalation of privileges as discussed above.
This directive differs slightly between a <Directory>
context (including equivalents such as Location/Files/If) and a
top-level or <VirtualHost>.
At top-level, it sets a default that will be inherited by virtualhosts.
In a virtual host, FAST or SECURE mode acts on the entire
HTTP request, and any settings in a <Directory>
context will be ignored. A third pseudo-mode
SELECTIVE defers the choice of FAST vs SECURE to directives in a
<Directory> context.
In a <Directory> context, it is applicable only
where SELECTIVE mode was set for the VirtualHost. Only
FAST or SECURE can be set in this context (SELECTIVE would be
meaningless).
<Directory> context applies to the request.
This might give an attacker opportunities to introduce
code through a RewriteMap
running at top-level or <VirtualHost> context
before privileges have been dropped and userid/gid set.
| Description: | Determines whether the virtualhost can run subprocesses, and the privileges available to subprocesses. |
|---|---|
| Syntax: | VHostCGIMode On|Off|Secure |
| Default: | VHostCGIMode On |
| Context: | virtual host |
| Status: | Experimental |
| Module: | mod_privileges |
| Compatibility: | Available on Solaris 10 and OpenSolaris with
non-threaded MPMs (prefork or custom MPM). |
Determines whether the virtual host is allowed to run fork and exec,
the privileges required to run subprocesses. If this is set to
Off the virtualhost is denied the privileges and will not
be able to run traditional CGI programs or scripts under the traditional
mod_cgi, nor similar external programs such as those
created by mod_ext_filter or
RewriteMap prog.
Note that it does not prevent CGI programs running under alternative
process and security models such as mod_fcgid, which is a recommended solution in Solaris.
If set to On or Secure, the virtual host
is permitted to run external programs and scripts as above.
Setting VHostCGIMode Secure has
the effect of denying privileges to the subprocesses, as described
for VHostSecure.
| Description: | Assign arbitrary privileges to subprocesses created by a virtual host. |
|---|---|
| Syntax: | VHostCGIPrivs [+-]?privilege-name [[+-]?privilege-name] ... |
| Default: | None |
| Context: | virtual host |
| Status: | Experimental |
| Module: | mod_privileges |
| Compatibility: | Available on Solaris 10 and OpenSolaris with
non-threaded MPMs (prefork or custom MPM)
and when mod_privileges is compiled with the
BIG_SECURITY_HOLE compile-time option. |
VHostCGIPrivs can be used to assign arbitrary privileges to subprocesses created by a virtual host, as discussed
under VHostCGIMode. Each privilege-name
is the name of a Solaris privilege, such as file_setid
or sys_nfs.
A privilege-name may optionally be prefixed by + or -, which will respectively allow or deny a privilege. If used with neither + nor -, all privileges otherwise assigned to the virtualhost will be denied. You can use this to override any of the default sets and construct your own privilege set.
This directive can open huge security holes in apache subprocesses, up to and including running them with root-level powers. Do not use it unless you fully understand what you are doing!
| Description: | Sets the Group ID under which a virtual host runs. |
|---|---|
| Syntax: | VHostGroup unix-groupid |
| Default: | Inherits the group id specified in
|
| Context: | virtual host |
| Status: | Experimental |
| Module: | mod_privileges |
| Compatibility: | Available on Solaris 10 and OpenSolaris with
non-threaded MPMs (prefork or custom MPM). |
The VHostGroup directive sets the Unix group
under which the server will process requests to a virtualhost.
The group is set before the request is processed and reset afterwards
using Solaris Privileges. Since the setting applies to the
process, this is not compatible with threaded MPMs.
Unix-group is one of:
# followed by a group number.This directive cannot be used to run apache as root! Nevertheless, it opens potential security issues similar to those discussed in the suexec documentation.
| Description: | Assign arbitrary privileges to a virtual host. |
|---|---|
| Syntax: | VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ... |
| Default: | None |
| Context: | virtual host |
| Status: | Experimental |
| Module: | mod_privileges |
| Compatibility: | Available on Solaris 10 and OpenSolaris with
non-threaded MPMs (prefork or custom MPM)
and when mod_privileges is compiled with the
BIG_SECURITY_HOLE compile-time option. |
VHostPrivs can be used to assign arbitrary privileges to a virtual host. Each privilege-name
is the name of a Solaris privilege, such as file_setid
or sys_nfs.
A privilege-name may optionally be prefixed by + or -, which will respectively allow or deny a privilege. If used with neither + nor -, all privileges otherwise assigned to the virtualhost will be denied. You can use this to override any of the default sets and construct your own privilege set.
This directive can open huge security holes in apache, up to and including running requests with root-level powers. Do not use it unless you fully understand what you are doing!
| Description: | Determines whether the server runs with enhanced security for the virtualhost. |
|---|---|
| Syntax: | VHostSecure On|Off |
| Default: | VHostSecure On |
| Context: | virtual host |
| Status: | Experimental |
| Module: | mod_privileges |
| Compatibility: | Available on Solaris 10 and OpenSolaris with
non-threaded MPMs (prefork or custom MPM). |
Determines whether the virtual host processes requests with security enhanced by removal of Privileges that are rarely needed in a webserver, but which are available by default to a normal Unix user and may therefore be required by modules and applications. It is recommended that you retain the default (On) unless it prevents an application running. Since the setting applies to the process, this is not compatible with threaded MPMs.
If VHostSecure prevents an application
running, this may be a warning sign that the application should be
reviewed for security.
| Description: | Sets the User ID under which a virtual host runs. |
|---|---|
| Syntax: | VHostUser unix-userid |
| Default: | Inherits the userid specified in
|
| Context: | virtual host |
| Status: | Experimental |
| Module: | mod_privileges |
| Compatibility: | Available on Solaris 10 and OpenSolaris with
non-threaded MPMs (prefork or custom MPM). |
The VHostUser directive sets the Unix userid
under which the server will process requests to a virtualhost.
The userid is set before the request is processed and reset afterwards
using Solaris Privileges. Since the setting applies to the
process, this is not compatible with threaded MPMs.
Unix-userid is one of:
# followed by a user number.This directive cannot be used to run apache as root! Nevertheless, it opens potential security issues similar to those discussed in the suexec documentation.
Apache HTTP Server Version 2.4
| Description: | mod_proxy extension for load balancing |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_balancer_module |
| Source File: | mod_proxy_balancer.c |
| Compatibility: | Available in version 2.1 and later |
This module requires the service of mod_proxy and it provides load balancing for
all the supported protocols. The most important ones are:
mod_proxy_httpmod_proxy_ftpmod_proxy_ajpmod_proxy_wstunnelThe Load balancing scheduler algorithm is not provided by this module but from other ones such as:
Thus, in order to get the ability of load balancing,
mod_proxy, mod_proxy_balancer
and at least one of load balancing scheduler algorithm modules have
to be present in the server.
Do not enable proxying until you have secured your server. Open proxy servers are dangerous both to your network and to the Internet at large.
Load balancer scheduler algorithm Load balancer stickyness Examples of a balancer configuration Exported Environment Variables Enabling Balancer Manager Support Details on load balancer stickyness Troubleshooting load balancer stickynessThis module provides no directives.
At present, there are 4 load balancer scheduler algorithms available
for use: Request Counting (mod_lbmethod_byrequests),
Weighted Traffic Counting (mod_lbmethod_bytraffic),
Pending Request Counting (mod_lbmethod_bybusyness) and
Heartbeat Traffic Counting (mod_lbmethod_heartbeat).
These are controlled via the lbmethod value of
the Balancer definition. See the ProxyPass
directive for more information, especially regarding how to
configure the Balancer and BalancerMembers.
The balancer supports stickyness. When a request is proxied to some back-end, then all following requests from the same user should be proxied to the same back-end. Many load balancers implement this feature via a table that maps client IP addresses to back-ends. This approach is transparent to clients and back-ends, but suffers from some problems: unequal load distribution if clients are themselves hidden behind proxies, stickyness errors when a client uses a dynamic IP address that changes during a session and loss of stickyness, if the mapping table overflows.
The module mod_proxy_balancer implements stickyness
on top of two alternative means: cookies and URL encoding. Providing the
cookie can be either done by the back-end or by the Apache web server
itself. The URL encoding is usually done on the back-end.
Before we dive into the technical details, here's an example of
how you might use mod_proxy_balancer to provide
load balancing between two back-end servers:
<Proxy "balancer://mycluster">
BalancerMember "http://192.168.1.50:80"
BalancerMember "http://192.168.1.51:80"
</Proxy>
ProxyPass "/test" "balancer://mycluster"
ProxyPassReverse "/test" "balancer://mycluster"
Another example of how to provide load balancing with stickyness
using mod_headers, even if the back-end server does
not set a suitable session cookie:
Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED
<Proxy "balancer://mycluster">
BalancerMember "http://192.168.1.50:80" route=1
BalancerMember "http://192.168.1.51:80" route=2
ProxySet stickysession=ROUTEID
</Proxy>
ProxyPass "/test" "balancer://mycluster"
ProxyPassReverse "/test" "balancer://mycluster"
At present there are 6 environment variables exported:
This is assigned the stickysession value used for the current request. It is the name of the cookie or request parameter used for sticky sessions
This is assigned the route parsed from the current request.
This is assigned the name of the balancer used for the current
request. The value is something like balancer://foo.
This is assigned the name of the worker used for the current request.
The value is something like http://hostA:1234.
This is assigned the route of the worker that will be used for the current request.
This is set to 1 if the session route does not match the worker route (BALANCER_SESSION_ROUTE != BALANCER_WORKER_ROUTE) or the session does not yet have an established route. This can be used to determine when/if the client needs to be sent an updated route when sticky sessions are used.
This module requires the service of
mod_status.
Balancer manager enables dynamic update of balancer
members. You can use balancer manager to change the balance
factor of a particular member, or put it in the off line
mode.
Thus, in order to get the ability of load balancer management,
mod_status and mod_proxy_balancer
have to be present in the server.
To enable load balancer management for browsers from the example.com
domain add this code to your httpd.conf
configuration file
<Location "/balancer-manager">
SetHandler balancer-manager
Require host example.com
</Location>
You can now access load balancer manager by using a Web browser
to access the page
http://your.server.name/balancer-manager. Please note
that only Balancers defined outside of <Location ...>
containers can be dynamically controlled by the Manager.
When using cookie based stickyness, you need to configure the
name of the cookie that contains the information about which back-end
to use. This is done via the stickysession attribute added
to either ProxyPass or
ProxySet. The name of
the cookie is case-sensitive. The balancer extracts the value of the
cookie and looks for a member worker with route equal
to that value. The route must also be set in either
ProxyPass or
ProxySet. The cookie can either
be set by the back-end, or as shown in the above
example by the Apache web server itself.
Some back-ends use a slightly different form of stickyness cookie,
for instance Apache Tomcat. Tomcat adds the name of the Tomcat instance
to the end of its session id cookie, separated with a dot (.)
from the session id. Thus if the Apache web server finds a dot in the value
of the stickyness cookie, it only uses the part behind the dot to search
for the route. In order to let Tomcat know about its instance name, you
need to set the attribute jvmRoute inside the Tomcat
configuration file conf/server.xml to the value of the
route of the worker that connects to the respective Tomcat.
The name of the session cookie used by Tomcat (and more generally by Java
web applications based on servlets) is JSESSIONID
(upper case) but can be configured to something else.
The second way of implementing stickyness is URL encoding.
The web server searches for a query parameter in the URL of the request.
The name of the parameter is specified again using stickysession.
The value of the parameter is used to lookup a member worker with route
equal to that value. Since it is not easy to extract and manipulate all
URL links contained in responses, generally the work of adding the parameters
to each link is done by the back-end generating the content.
In some cases it might be feasible doing
this via the web server using mod_substitute or
mod_sed. This can have negative impact on performance though.
The Java standards implement URL encoding slightly different. They use
a path info appended to the URL using a semicolon (;)
as the separator and add the session id behind. As in the cookie case,
Apache Tomcat can include the configured jvmRoute in this path
info. To let Apache find this sort of path info, you need to set
scolonpathdelim to On in
ProxyPass or
ProxySet.
Finally you can support cookies and URL encoding at the same time, by
configuring the name of the cookie and the name of the URL parameter
separated by a vertical bar (|) as in the following example:
ProxyPass "/test" "balancer://mycluster" stickysession=JSESSIONID|jsessionid scolonpathdelim=On
<Proxy "balancer://mycluster">
BalancerMember "http://192.168.1.50:80" route=node1
BalancerMember "http://192.168.1.51:80" route=node2
</Proxy>
If the cookie and the request parameter both provide routing information for the same request, the information from the request parameter is used.
If you experience stickyness errors, e.g. users lose their application sessions and need to login again, you first want to check whether this is because the back-ends are sometimes unavailable or whether your configuration is wrong. To find out about possible stability problems with the back-ends, check your Apache error log for proxy error messages.
To verify your configuration, first check, whether the stickyness
is based on a cookie or on URL encoding. Next step would be logging
the appropriate data in the access log by using an enhanced
LogFormat.
The following fields are useful:
%{MYCOOKIE}CMYCOOKIE.
The name should be the same given in the stickysession
attribute.%{Set-Cookie}o%{BALANCER_SESSION_STICKY}e%{BALANCER_SESSION_ROUTE}e%{BALANCER_WORKER_ROUTE}e%{BALANCER_ROUTE_CHANGED}e1 if the route in the request
is different from the route of the worker, i.e.
the request couldn't be handled sticky.Common reasons for loss of session are session timeouts, which are usually configurable on the back-end server.
The balancer also logs detailed information about handling
stickyness to the error log, if the log level is set to
debug or higher. This is an easy way to
troubleshoot stickyness problems, but the log volume might
be too high for production servers under high load.
Apache HTTP Server Version 2.4
| Description: | Associates the requested filename's extensions with the file's behavior (handlers and filters) and content (mime-type, language, character set and encoding) |
|---|---|
| Status: | Base |
| Module Identifier: | mime_module |
| Source File: | mod_mime.c |
This module is used to assign content metadata to the content
selected for an HTTP response by mapping patterns in the
URI or filenames to the metadata values. For example, the filename
extensions of content files often define the content's Internet
media type, language, character set, and content-encoding. This
information is sent in HTTP messages containing that content and
used in content negotiation when selecting alternatives, such that
the user's preferences are respected when choosing one of several
possible contents to serve. See
mod_negotiation for more information
about content negotiation.
The directives AddCharset, AddEncoding, AddLanguage and AddType are all used to map file
extensions onto the metadata for that file. Respectively
they set the character set, content-encoding, content-language,
and media-type (content-type) of documents. The directive TypesConfig is used to specify a
file which also maps extensions onto media types.
In addition, mod_mime may define the handler and filters that originate and process
content. The directives AddHandler, AddOutputFilter, and AddInputFilter control the modules
or scripts that serve the document. The MultiviewsMatch directive allows
mod_negotiation to consider these file extensions
to be included when testing Multiviews matches.
While mod_mime associates metadata
with filename extensions, the core server
provides directives that are used to associate all the files in a
given container (e.g., <Location>, <Directory>, or <Files>) with particular
metadata. These directives include ForceType, SetHandler, SetInputFilter, and SetOutputFilter. The core directives
override any filename extension mappings defined in
mod_mime.
Note that changing the metadata for a file does not
change the value of the Last-Modified header.
Thus, previously cached copies may still be used by a client or
proxy, with the previous headers. If you change the
metadata (language, content type, character set or
encoding) you may need to 'touch' affected files (updating
their last modified date) to ensure that all visitors are
receive the corrected content headers.
AddCharset AddEncoding AddHandler AddInputFilter AddLanguage AddOutputFilter AddType DefaultLanguage ModMimeUsePathInfo MultiviewsMatch RemoveCharset RemoveEncoding RemoveHandler RemoveInputFilter RemoveLanguage RemoveOutputFilter RemoveType TypesConfigFiles can have more than one extension; the order of the
extensions is normally irrelevant. For example, if the
file welcome.html.fr maps onto content type
text/html and language French then the file
welcome.fr.html will map onto exactly the same
information. If more than one extension is given that maps onto
the same type of metadata, then the one to the right will
be used, except for languages and content encodings. For example,
if .gif maps to the media-type
image/gif and .html maps to the
media-type text/html, then the file
welcome.gif.html will be associated with the
media-type text/html.
Languages and content encodings are treated accumulative, because one can assign
more than one language or encoding to a particular resource. For example,
the file welcome.html.en.de will be delivered with
Content-Language: en, de and Content-Type:
text/html.
Care should be taken when a file with multiple extensions
gets associated with both a media-type
and a handler. This will
usually result in the request being handled by the module associated
with the handler. For example, if the .imap
extension is mapped to the handler imap-file (from
mod_imagemap) and the .html extension is
mapped to the media-type text/html, then the file
world.imap.html will be associated with both the
imap-file handler and text/html media-type.
When it is processed, the imap-file handler will be used,
and so it will be treated as a mod_imagemap imagemap
file.
If you would prefer only the last dot-separated part of the
filename to be mapped to a particular piece of meta-data, then do
not use the Add* directives. For example, if you wish
to have the file foo.html.cgi processed as a CGI
script, but not the file bar.cgi.html, then instead
of using AddHandler cgi-script .cgi, use
<FilesMatch "[^.]+\.cgi$"> SetHandler cgi-script </FilesMatch>
A file of a particular media-type can additionally be encoded a
particular way to simplify transmission over the Internet.
While this usually will refer to compression, such as
gzip, it can also refer to encryption, such a
pgp or to an encoding such as UUencoding, which is
designed for transmitting a binary file in an ASCII (text)
format.
The HTTP/1.1 RFC, section 14.11 puts it this way:
The Content-Encoding entity-header field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type header field. Content-Encoding is primarily used to allow a document to be compressed without losing the identity of its underlying media type.
By using more than one file extension (see section above about multiple file extensions), you can indicate that a file is of a particular type, and also has a particular encoding.
For example, you may have a file which is a Microsoft Word
document, which is pkzipped to reduce its size. If the
.doc extension is associated with the Microsoft
Word file type, and the .zip extension is
associated with the pkzip file encoding, then the file
Resume.doc.zip would be known to be a pkzip'ed Word
document.
Apache sends a Content-encoding header with the
resource, in order to tell the client browser about the
encoding method.
Content-encoding: pkzip
In addition to file type and the file encoding, another important piece of information is what language a particular document is in, and in what character set the file should be displayed. For example, the document might be written in the Vietnamese alphabet, or in Cyrillic, and should be displayed as such. This information, also, is transmitted in HTTP headers.
The character set, language, encoding and mime type are all
used in the process of content negotiation (See
mod_negotiation) to determine
which document to give to the client, when there are
alternative documents in more than one character set, language,
encoding or mime type. All filename extensions associations
created with AddCharset,
AddEncoding, AddLanguage and AddType directives
(and extensions listed in the MimeMagicFile) participate in this select process.
Filename extensions that are only associated using the AddHandler, AddInputFilter or AddOutputFilter directives may be included or excluded
from matching by using the MultiviewsMatch directive.
To convey this further information, Apache optionally sends
a Content-Language header, to specify the language
that the document is in, and can append additional information
onto the Content-Type header to indicate the
particular character set that should be used to correctly
render the information.
Content-Language: en, fr
Content-Type: text/plain; charset=ISO-8859-1
The language specification is the two-letter abbreviation
for the language. The charset is the name of the
particular character set which should be used.
| Description: | Maps the given filename extensions to the specified content charset |
|---|---|
| Syntax: | AddCharset charset extension
[extension] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The AddCharset directive maps the given
filename extensions to the specified content charset (the Internet
registered name for a given character encoding). charset
is the media
type's charset parameter for resources with filenames containing
extension. This mapping is added to any already in force,
overriding any mappings that already exist for the same
extension.
AddLanguage ja .ja AddCharset EUC-JP .euc AddCharset ISO-2022-JP .jis AddCharset SHIFT_JIS .sjis
Then the document xxxx.ja.jis will be treated
as being a Japanese document whose charset is ISO-2022-JP
(as will the document xxxx.jis.ja). The
AddCharset directive is useful for both to
inform the client about the character encoding of the document so that
the document can be interpreted and displayed appropriately, and for content negotiation,
where the server returns one from several documents based on
the client's charset preference.
The extension argument is case-insensitive and can be specified with or without a leading dot. Filenames may have multiple extensions and the extension argument will be compared against each of them.
| Description: | Maps the given filename extensions to the specified encoding type |
|---|---|
| Syntax: | AddEncoding encoding extension
[extension] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The AddEncoding directive maps the given
filename extensions to the specified HTTP content-encoding.
encoding is the HTTP content coding to append to the
value of the Content-Encoding header field for documents named with the
extension. This mapping is added to any already in force,
overriding any mappings that already exist for the same
extension.
AddEncoding x-gzip .gz AddEncoding x-compress .Z
This will cause filenames containing the .gz extension
to be marked as encoded using the x-gzip encoding, and
filenames containing the .Z extension to be marked as
encoded with x-compress.
Old clients expect x-gzip and x-compress,
however the standard dictates that they're equivalent to
gzip and compress respectively. Apache does
content encoding comparisons by ignoring any leading x-.
When responding with an encoding Apache will use whatever form
(i.e., x-foo or foo) the
client requested. If the client didn't specifically request a
particular form Apache will use the form given by the
AddEncoding directive. To make this long story
short, you should always use x-gzip and
x-compress for these two specific encodings. More
recent encodings, such as deflate, should be
specified without the x-.
The extension argument is case-insensitive and can be specified with or without a leading dot. Filenames may have multiple extensions and the extension argument will be compared against each of them.
| Description: | Maps the filename extensions to the specified handler |
|---|---|
| Syntax: | AddHandler handler-name extension
[extension] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
Files having the name extension will be served by the
specified handler-name. This
mapping is added to any already in force, overriding any mappings that
already exist for the same extension. For example, to
activate CGI scripts with the file extension .cgi, you
might use:
AddHandler cgi-script .cgi
Once that has been put into your httpd.conf file, any file containing
the .cgi extension will be treated as a CGI program.
The extension argument is case-insensitive and can be specified with or without a leading dot. Filenames may have multiple extensions and the extension argument will be compared against each of them.
| Description: | Maps filename extensions to the filters that will process client requests |
|---|---|
| Syntax: | AddInputFilter filter[;filter...]
extension [extension] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
AddInputFilter maps the filename extension
extension to the filters which
will process client requests and POST input when they are received by
the server. This is in addition to any filters defined elsewhere,
including the SetInputFilter
directive. This mapping is merged over any already in force, overriding
any mappings that already exist for the same extension.
If more than one filter is specified, they must be separated by semicolons in the order in which they should process the content. The filter is case-insensitive.
The extension argument is case-insensitive and can be specified with or without a leading dot. Filenames may have multiple extensions and the extension argument will be compared against each of them.
| Description: | Maps the given filename extension to the specified content language |
|---|---|
| Syntax: | AddLanguage language-tag extension
[extension] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The AddLanguage directive maps the given
filename extension to the specified content language. Files with the
filename extension are assigned an HTTP Content-Language
value of language-tag corresponding to the language
identifiers defined by RFC 3066.
This directive overrides any mappings that already exist for the same
extension.
AddEncoding x-compress .Z AddLanguage en .en AddLanguage fr .fr
Then the document xxxx.en.Z will be treated as
being a compressed English document (as will the document
xxxx.Z.en). Although the content language is
reported to the client, the browser is unlikely to use this
information. The AddLanguage directive is
more useful for content
negotiation, where the server returns one from several documents
based on the client's language preference.
If multiple language assignments are made for the same extension, the last one encountered is the one that is used. That is, for the case of:
AddLanguage en .en AddLanguage en-gb .en AddLanguage en-us .en
documents with the extension .en would be treated as
being en-us.
The extension argument is case-insensitive and can be specified with or without a leading dot. Filenames may have multiple extensions and the extension argument will be compared against each of them.
| Description: | Maps filename extensions to the filters that will process responses from the server |
|---|---|
| Syntax: | AddOutputFilter filter[;filter...]
extension [extension] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The AddOutputFilter directive maps the
filename extension extension to the filters which will process responses
from the server before they are sent to the client. This is in
addition to any filters defined elsewhere, including SetOutputFilter and AddOutputFilterByType directive. This mapping is merged
over any already in force, overriding any mappings that already exist
for the same extension.
For example, the following configuration will process all
.shtml files for server-side includes and will then
compress the output using mod_deflate.
AddOutputFilter INCLUDES;DEFLATE shtml
If more than one filter is specified, they must be separated by semicolons in the order in which they should process the content. The filter argument is case-insensitive.
The extension argument is case-insensitive and can be specified with or without a leading dot. Filenames may have multiple extensions and the extension argument will be compared against each of them.
Note that when defining a set of filters using the
AddOutputFilter directive,
any definition made will replace any previous definition made by
the AddOutputFilter
directive.
# Effective filter "DEFLATE" AddOutputFilter DEFLATE shtml <Location "/foo"> # Effective filter "INCLUDES", replacing "DEFLATE" AddOutputFilter INCLUDES shtml </Location> <Location "/bar"> # Effective filter "INCLUDES;DEFLATE", replacing "DEFLATE" AddOutputFilter INCLUDES;DEFLATE shtml </Location> <Location "/bar/baz"> # Effective filter "BUFFER", replacing "INCLUDES;DEFLATE" AddOutputFilter BUFFER shtml </Location> <Location "/bar/baz/buz"> # No effective filter, replacing "BUFFER" RemoveOutputFilter shtml </Location>
| Description: | Maps the given filename extensions onto the specified content type |
|---|---|
| Syntax: | AddType media-type extension
[extension] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The AddType directive maps the given
filename extensions onto the specified content
type. media-type is the media
type to use for filenames containing
extension. This mapping is added to any already in
force, overriding any mappings that already exist for the same
extension.
AddType directive rather than changing the
TypesConfig file.
AddType image/gif .gif
Or, to specify multiple file extensions in one directive:
AddType image/jpeg jpeg jpg jpe
The extension argument is case-insensitive and can be specified with or without a leading dot. Filenames may have multiple extensions and the extension argument will be compared against each of them.
A similar effect to mod_negotiation's
LanguagePriority
can be achieved by qualifying a media-type with
qs:
AddType application/rss+xml;qs=0.8 .xml
This is useful in situations, e.g. when a client
requesting Accept: */* can not actually processes
the content returned by the server.
This directive primarily configures the content types generated for static files served out of the filesystem. For resources other than static files, where the generator of the response typically specifies a Content-Type, this directive has no effect.
If no handler is explicitly set for a request, the specified content type will also be used as the handler name.
When explicit directives such as
SetHandler or
AddHandler do not apply
to the current request, the internal handler name normally set by those
directives is instead set to the content type specified by this directive.
This is a historical behavior that may be used by some third-party modules (such as mod_php) for taking responsibility for the matching request.
Configurations that rely on such "synthetic" types should be avoided.
Additionally, configurations that restrict access to
SetHandler or
AddHandler should
restrict access to this directive as well.
| Description: | Defines a default language-tag to be sent in the Content-Language header field for all resources in the current context that have not been assigned a language-tag by some other means. |
|---|---|
| Syntax: | DefaultLanguage language-tag |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The DefaultLanguage directive tells Apache
that all resources in the directive's scope (e.g., all resources
covered by the current <Directory> container) that don't have an explicit language
extension (such as .fr or .de as configured
by AddLanguage) should be
assigned a Content-Language of language-tag. This allows
entire directory trees to be marked as containing Dutch content, for
instance, without having to rename each file. Note that unlike using
extensions to specify languages, DefaultLanguage
can only specify a single language.
If no DefaultLanguage directive is in force
and a file does not have any language extensions as configured
by AddLanguage, then no
Content-Language header field will be generated.
DefaultLanguage en
| Description: | Tells mod_mime to treat path_info
components as part of the filename |
|---|---|
| Syntax: | ModMimeUsePathInfo On|Off |
| Default: | ModMimeUsePathInfo Off |
| Context: | directory |
| Status: | Base |
| Module: | mod_mime |
The ModMimeUsePathInfo directive is used to
combine the filename with the path_info URL component to
apply mod_mime's directives to the request. The default
value is Off - therefore, the path_info
component is ignored.
This directive is recommended when you have a virtual filesystem.
ModMimeUsePathInfo On
If you have a request for /index.php/foo.shtml
mod_mime will now treat the
incoming request as /index.php/foo.shtml and directives
like AddOutputFilter INCLUDES .shtml will add the
INCLUDES filter to the request. If ModMimeUsePathInfo is not set, the
INCLUDES filter will not be added. This will work
analogously for virtual paths, such as those defined by
<Location>
| Description: | The types of files that will be included when searching for a matching file with MultiViews |
|---|---|
| Syntax: | MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers
[Handlers|Filters] |
| Default: | MultiviewsMatch NegotiatedOnly |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
MultiviewsMatch permits three different
behaviors for mod_negotiation's
Multiviews feature. Multiviews allows a request for a file,
e.g. index.html, to match any negotiated
extensions following the base request, e.g.
index.html.en, index.html.fr, or
index.html.gz.
The NegotiatedOnly option provides that every extension
following the base name must correlate to a recognized
mod_mime extension for content negotiation, e.g.
Charset, Content-Type, Language, or Encoding. This is the strictest
implementation with the fewest unexpected side effects, and is the
default behavior.
To include extensions associated with Handlers and/or Filters,
set the MultiviewsMatch directive to either
Handlers, Filters, or both option keywords.
If all other factors are equal, the smallest file will be served,
e.g. in deciding between index.html.cgi of 500
bytes and index.html.pl of 1000 bytes, the .cgi
file would win in this example. Users of .asis files
might prefer to use the Handler option, if .asis files are
associated with the asis-handler.
You may finally allow Any extensions to match, even if
mod_mime doesn't recognize the extension. This can cause
unpredictable results, such as serving .old or .bak files the webmaster
never expected to be served.
For example, the following configuration will allow handlers and filters to participate in Multviews, but will exclude unknown files:
MultiviewsMatch Handlers Filters
MultiviewsMatch is not allowed in a
<Location> or <LocationMatch> section.
| Description: | Removes any character set associations for a set of file extensions |
|---|---|
| Syntax: | RemoveCharset extension [extension]
... |
| Context: | virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The RemoveCharset directive removes any
character set associations for files with the given extensions.
This allows .htaccess files in subdirectories to
undo any associations inherited from parent directories or the
server config files.
The extension argument is case-insensitive and can be specified with or without a leading dot.
RemoveCharset .html .shtml
| Description: | Removes any content encoding associations for a set of file extensions |
|---|---|
| Syntax: | RemoveEncoding extension [extension]
... |
| Context: | virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The RemoveEncoding directive removes any
encoding associations for files with the given extensions. This
allows .htaccess files in subdirectories to undo
any associations inherited from parent directories or the
server config files. An example of its use might be:
AddEncoding x-gzip .gz
AddType text/plain .asc
<Files "*.gz.asc">
RemoveEncoding .gz
</Files>
This will cause foo.gz to be marked as being
encoded with the gzip method, but foo.gz.asc as an
unencoded plaintext file.
RemoveEncoding directives are processed
after any AddEncoding
directives, so it is possible they may undo the effects of the latter
if both occur within the same directory configuration.
The extension argument is case-insensitive and can be specified with or without a leading dot.
| Description: | Removes any handler associations for a set of file extensions |
|---|---|
| Syntax: | RemoveHandler extension [extension]
... |
| Context: | virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The RemoveHandler directive removes any
handler associations for files with the given extensions. This allows
.htaccess files in subdirectories to undo any
associations inherited from parent directories or the server
config files. An example of its use might be:
AddHandler server-parsed .html
RemoveHandler .html
This has the effect of returning .html files in
the /foo/bar directory to being treated as normal
files, rather than as candidates for parsing (see the mod_include module).
The extension argument is case-insensitive and can be specified with or without a leading dot.
| Description: | Removes any input filter associations for a set of file extensions |
|---|---|
| Syntax: | RemoveInputFilter extension [extension]
... |
| Context: | virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The RemoveInputFilter directive removes any
input filter associations for files with
the given extensions.
This allows .htaccess files in subdirectories to
undo any associations inherited from parent directories or the
server config files.
The extension argument is case-insensitive and can be specified with or without a leading dot.
| Description: | Removes any language associations for a set of file extensions |
|---|---|
| Syntax: | RemoveLanguage extension [extension]
... |
| Context: | virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The RemoveLanguage directive removes any
language associations for files with the given extensions. This
allows .htaccess files in subdirectories to undo
any associations inherited from parent directories or the
server config files.
The extension argument is case-insensitive and can be specified with or without a leading dot.
| Description: | Removes any output filter associations for a set of file extensions |
|---|---|
| Syntax: | RemoveOutputFilter extension [extension]
... |
| Context: | virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The RemoveOutputFilter directive removes any
output filter associations for files with
the given extensions.
This allows .htaccess files in subdirectories to
undo any associations inherited from parent directories or the
server config files.
The extension argument is case-insensitive and can be specified with or without a leading dot.
RemoveOutputFilter shtml
| Description: | Removes any content type associations for a set of file extensions |
|---|---|
| Syntax: | RemoveType extension [extension]
... |
| Context: | virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_mime |
The RemoveType directive removes any
media type associations for files with
the given extensions. This allows .htaccess files in
subdirectories to undo any associations inherited from parent
directories or the server config files. An example of its use
might be:
RemoveType .cgi
This will remove any special handling of .cgi
files in the /foo/ directory and any beneath it,
causing responses containing those files to omit the HTTP
Content-Type header field.
RemoveType directives are processed
after any AddType
directives, so it is possible they may undo the effects of the
latter if both occur within the same directory configuration.
The extension argument is case-insensitive and can be specified with or without a leading dot.
| Description: | The location of the mime.types file |
|---|---|
| Syntax: | TypesConfig file-path |
| Default: | TypesConfig conf/mime.types |
| Context: | server config |
| Status: | Base |
| Module: | mod_mime |
The TypesConfig directive sets the
location of the media types
configuration file. File-path is relative to the
ServerRoot. This file sets
the default list of mappings from filename extensions to content
types. Most administrators use the mime.types file
provided by their OS, which associates common filename
extensions with the official list of IANA registered media types
maintained at http://www.iana.org/assignments/media-types/index.html
as well as a large number of unofficial types. This
simplifies the httpd.conf file by providing the
majority of media-type definitions, and may be overridden by
AddType directives as
needed. You should not edit the mime.types file,
because it may be replaced when you upgrade your server.
The file contains lines in the format of the arguments to
an AddType directive:
media-type [extension] ...
The case of the extension does not matter. Blank lines, and lines
beginning with a hash character (#) are ignored.
Empty lines are there for completeness (of the mime.types file).
Apache httpd can still determine these types with mod_mime_magic.
mime.types file unless (1) they are already
registered with IANA, and (2) they use widely accepted,
non-conflicting filename extensions across platforms.
category/x-subtype requests will be automatically
rejected, as will any new two-letter extensions as they will
likely conflict later with the already crowded language and
character set namespace.
Apache HTTP Server Version 2.4
| Description: | Enable SSL encryption for NetWare |
|---|---|
| Status: | Base |
| Module Identifier: | nwssl_module |
| Source File: | mod_nw_ssl.c |
| Compatibility: | NetWare only |
This module enables SSL encryption for a specified port. It takes advantage of the SSL encryption functionality that is built into the NetWare operating system.
| Description: | List of additional client certificates |
|---|---|
| Syntax: | NWSSLTrustedCerts filename [filename] ... |
| Context: | server config |
| Status: | Base |
| Module: | mod_nw_ssl |
Specifies a list of client certificate files (DER format)
that are used when creating a proxied SSL connection. Each
client certificate used by a server must be listed separately
in its own .der file.
| Description: | Allows a connection to be upgraded to an SSL connection upon request |
|---|---|
| Syntax: | NWSSLUpgradeable [IP-address:]portnumber |
| Context: | server config |
| Status: | Base |
| Module: | mod_nw_ssl |
Allow a connection that was created on the specified address
and/or port to be upgraded to an SSL connection upon request from
the client. The address and/or port must have already be defined
previously with a Listen
directive.
| Description: | Enables SSL encryption for the specified port |
|---|---|
| Syntax: | SecureListen [IP-address:]portnumber
Certificate-Name [MUTUAL] |
| Context: | server config |
| Status: | Base |
| Module: | mod_nw_ssl |
Specifies the port and the eDirectory based certificate name that will be used to enable SSL encryption. An optional third parameter also enables mutual authentication.
Apache HTTP Server Version 2.4
| Description: | AJP support module for
mod_proxy |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_ajp_module |
| Source File: | mod_proxy_ajp.c |
| Compatibility: | Available in version 2.1 and later |
This module requires the service of mod_proxy. It provides support for the
Apache JServ Protocol version 1.3 (hereafter
AJP13).
Thus, in order to get the ability of handling AJP13
protocol, mod_proxy and
mod_proxy_ajp have to be present in the server.
Do not enable proxying until you have secured your server. Open proxy servers are dangerous both to your network and to the Internet at large.
Usage Environment Variables Overview of the protocol Basic Packet Structure Request Packet Structure Response Packet StructureThis module provides no directives.
This module is used to reverse proxy to a backend application server
(e.g. Apache Tomcat) using the AJP13 protocol. The usage is similar to
an HTTP reverse proxy, but uses the ajp:// prefix:
ProxyPass "/app" "ajp://backend.example.com:8009/app"
Options such as the secret option of Tomcat (required by
default since Tomcat 8.5.51 and 9.0.31) can just be added as a separate
parameter at the end of ProxyPass
or BalancerMember. This parameter
is available in Apache HTTP Server 2.4.42 and later:
secret optionProxyPass "/app" "ajp://backend.example.com:8009/app" secret=YOUR_AJP_SECRET
Balancers may also be used:
<Proxy "balancer://cluster">
BalancerMember "ajp://app1.example.com:8009" loadfactor=1
BalancerMember "ajp://app2.example.com:8009" loadfactor=2
ProxySet lbmethod=bytraffic
</Proxy>
ProxyPass "/app" "balancer://cluster/app"
Note that usually no
ProxyPassReverse
directive is necessary. The AJP request includes the original host
header given to the proxy, and the application server can be expected
to generate self-referential headers relative to this host, so no
rewriting is necessary.
The main exception is when the URL path on the proxy differs from that
on the
backend. In this case, a redirect header can be rewritten relative to the
original host URL (not the backend ajp:// URL), for
example:
ProxyPass "/apps/foo" "ajp://backend.example.com:8009/foo" ProxyPassReverse "/apps/foo" "http://www.example.com/foo"
However, it is usually better to deploy the application on the backend server at the same path as the proxy rather than to take this approach.
Environment variables whose names have the prefix AJP_
are forwarded to the origin server as AJP request attributes
(with the AJP_ prefix removed from the name of the key).
The AJP13 protocol is packet-oriented. A binary format
was presumably chosen over the more readable plain text for reasons of
performance. The web server communicates with the servlet container over
TCP connections. To cut down on the expensive process of socket creation,
the web server will attempt to maintain persistent TCP connections to the
servlet container, and to reuse a connection for multiple request/response
cycles.
Once a connection is assigned to a particular request, it will not be used for any others until the request-handling cycle has terminated. In other words, requests are not multiplexed over connections. This makes for much simpler code at either end of the connection, although it does cause more connections to be open at once.
Once the web server has opened a connection to the servlet container, the connection can be in one of the following states:
Once a connection is assigned to handle a particular request, the basic
request information (e.g. HTTP headers, etc) is sent over the connection in
a highly condensed form (e.g. common strings are encoded as integers).
Details of that format are below in Request Packet Structure. If there is a
body to the request (content-length > 0), that is sent in a
separate packet immediately after.
At this point, the servlet container is presumably ready to start processing the request. As it does so, it can send the following messages back to the web server:
Each message is accompanied by a differently formatted packet of data. See Response Packet Structures below for details.
There is a bit of an XDR heritage to this protocol, but it differs in lots of ways (no 4 byte alignment, for example).
AJP13 uses network byte order for all data types.
There are four data types in the protocol: bytes, booleans, integers and strings.
1 = true, 0 = false.
Using other non-zero values as true (i.e. C-style) may work in some places,
but it won't in others.0 to 2^16 (32768). Stored in
2 bytes with the high-order byte first.strlen. This is a touch confusing on the Java side, which
is littered with odd autoincrement statements to skip over these
terminators. I believe the reason this was done was to allow the C
code to be extra efficient when reading strings which the servlet
container is sending back -- with the terminating \0 character, the
C code can pass around references into a single buffer, without copying.
if the \0 was missing, the C code would have to copy things out in order
to get its notion of a string.According to much of the code, the max packet size is
8 * 1024 bytes (8K). The actual length of the packet is encoded in
the header.
Packets sent from the server to the container begin with
0x1234. Packets sent from the container to the server
begin with AB (that's the ASCII code for A followed by the
ASCII code for B). After those first two bytes, there is an integer
(encoded as above) with the length of the payload. Although this might
suggest that the maximum payload could be as large as 2^16, in fact, the
code sets the maximum to be 8K.
| Packet Format (Server->Container) | |||||
|---|---|---|---|---|---|
| Byte | 0 | 1 | 2 | 3 | 4...(n+3) |
| Contents | 0x12 | 0x34 | Data Length (n) | Data | |
| Packet Format (Container->Server) | |||||
|---|---|---|---|---|---|
| Byte | 0 | 1 | 2 | 3 | 4...(n+3) |
| Contents | A | B | Data Length (n) | Data | |
For most packets, the first byte of the payload encodes the type of
message. The exception is for request body packets sent from the server to
the container -- they are sent with a standard packet header (
0x1234 and then length of the packet), but without any prefix code
after that.
The web server can send the following messages to the servlet container:
| Code | Type of Packet | Meaning |
| 2 | Forward Request | Begin the request-processing cycle with the following data |
| 7 | Shutdown | The web server asks the container to shut itself down. |
| 8 | Ping | The web server asks the container to take control (secure login phase). |
| 10 | CPing | The web server asks the container to respond quickly with a CPong. |
| none | Data | Size (2 bytes) and corresponding body data. |
To ensure some basic security, the container will only actually do the
Shutdown if the request comes from the same machine on which
it's hosted.
The first Data packet is send immediately after the
Forward Request by the web server.
The servlet container can send the following types of messages to the webserver:
| Code | Type of Packet | Meaning |
| 3 | Send Body Chunk | Send a chunk of the body from the servlet container to the web server (and presumably, onto the browser). |
| 4 | Send Headers | Send the response headers from the servlet container to the web server (and presumably, onto the browser). |
| 5 | End Response | Marks the end of the response (and thus the request-handling cycle). |
| 6 | Get Body Chunk | Get further data from the request if it hasn't all been transferred yet. |
| 9 | CPong Reply | The reply to a CPing request |
Each of the above messages has a different internal structure, detailed below.
For messages from the server to the container of type Forward Request:
AJP13_FORWARD_REQUEST :=
prefix_code (byte) 0x02 = JK_AJP13_FORWARD_REQUEST
method (byte)
protocol (string)
req_uri (string)
remote_addr (string)
remote_host (string)
server_name (string)
server_port (integer)
is_ssl (boolean)
num_headers (integer)
request_headers *(req_header_name req_header_value)
attributes *(attribut_name attribute_value)
request_terminator (byte) OxFFThe request_headers have the following structure:
req_header_name :=
sc_req_header_name | (string) [see below for how this is parsed]
sc_req_header_name := 0xA0xx (integer)
req_header_value := (string)The attributes are optional and have the following
structure:
attribute_name := sc_a_name | (sc_a_req_attribute string) attribute_value := (string)
Not that the all-important header is content-length,
because it determines whether or not the container looks for another
packet immediately.
For all requests, this will be 2. See above for details on other Prefix codes.
The HTTP method, encoded as a single byte:
| Command Name | Code |
| OPTIONS | 1 |
| GET | 2 |
| HEAD | 3 |
| POST | 4 |
| PUT | 5 |
| DELETE | 6 |
| TRACE | 7 |
| PROPFIND | 8 |
| PROPPATCH | 9 |
| MKCOL | 10 |
| COPY | 11 |
| MOVE | 12 |
| LOCK | 13 |
| UNLOCK | 14 |
| ACL | 15 |
| REPORT | 16 |
| VERSION-CONTROL | 17 |
| CHECKIN | 18 |
| CHECKOUT | 19 |
| UNCHECKOUT | 20 |
| SEARCH | 21 |
| MKWORKSPACE | 22 |
| UPDATE | 23 |
| LABEL | 24 |
| MERGE | 25 |
| BASELINE_CONTROL | 26 |
| MKACTIVITY | 27 |
Later version of ajp13, will transport additional methods, even if they are not in this list.
These are all fairly self-explanatory. Each of these is required, and will be sent for every request.
The structure of request_headers is the following:
First, the number of headers num_headers is encoded.
Then, a series of header name req_header_name / value
req_header_value pairs follows.
Common header names are encoded as integers,
to save space. If the header name is not in the list of basic headers,
it is encoded normally (as a string, with prefixed length). The list of
common headers sc_req_header_nameand their codes
is as follows (all are case-sensitive):
| Name | Code value | Code name |
| accept | 0xA001 | SC_REQ_ACCEPT |
| accept-charset | 0xA002 | SC_REQ_ACCEPT_CHARSET |
| accept-encoding | 0xA003 | SC_REQ_ACCEPT_ENCODING |
| accept-language | 0xA004 | SC_REQ_ACCEPT_LANGUAGE |
| authorization | 0xA005 | SC_REQ_AUTHORIZATION |
| connection | 0xA006 | SC_REQ_CONNECTION |
| content-type | 0xA007 | SC_REQ_CONTENT_TYPE |
| content-length | 0xA008 | SC_REQ_CONTENT_LENGTH |
| cookie | 0xA009 | SC_REQ_COOKIE |
| cookie2 | 0xA00A | SC_REQ_COOKIE2 |
| host | 0xA00B | SC_REQ_HOST |
| pragma | 0xA00C | SC_REQ_PRAGMA |
| referer | 0xA00D | SC_REQ_REFERER |
| user-agent | 0xA00E | SC_REQ_USER_AGENT |
The Java code that reads this grabs the first two-byte integer and if
it sees an '0xA0' in the most significant
byte, it uses the integer in the second byte as an index into an array of
header names. If the first byte is not 0xA0, it assumes that
the two-byte integer is the length of a string, which is then read in.
This works on the assumption that no header names will have length
greater than 0x9FFF (==0xA000 - 1), which is perfectly
reasonable, though somewhat arbitrary.
content-length header is extremely
important. If it is present and non-zero, the container assumes that
the request has a body (a POST request, for example), and immediately
reads a separate packet off the input stream to get that body.
The attributes prefixed with a ?
(e.g. ?context) are all optional. For each, there is a
single byte code to indicate the type of attribute, and then its value
(string or integer). They can be sent in any order (though the C code
always sends them in the order listed below). A special terminating code
is sent to signal the end of the list of optional attributes. The list of
byte codes is:
| Information | Code Value | Type Of Value | Note |
| ?context | 0x01 | - | Not currently implemented |
| ?servlet_path | 0x02 | - | Not currently implemented |
| ?remote_user | 0x03 | String | |
| ?auth_type | 0x04 | String | |
| ?query_string | 0x05 | String | |
| ?jvm_route | 0x06 | String | |
| ?ssl_cert | 0x07 | String | |
| ?ssl_cipher | 0x08 | String | |
| ?ssl_session | 0x09 | String | |
| ?req_attribute | 0x0A | String | Name (the name of the attribute follows) |
| ?ssl_key_size | 0x0B | Integer | |
| ?secret | 0x0C | String | Supported since 2.4.42 |
| are_done | 0xFF | - | request_terminator |
The context and servlet_path are not
currently set by the C code, and most of the Java code completely ignores
whatever is sent over for those fields (and some of it will actually break
if a string is sent along after one of those codes). I don't know if this
is a bug or an unimplemented feature or just vestigial code, but it's
missing from both sides of the connection.
The remote_user and auth_type presumably
refer to HTTP-level authentication, and communicate the remote user's
username and the type of authentication used to establish their identity
(e.g. Basic, Digest).
The query_string, ssl_cert,
ssl_cipher, ssl_session and
ssl_key_size refer to the
corresponding pieces of HTTP and HTTPS.
The jvm_route, is used to support sticky
sessions -- associating a user's sesson with a particular Tomcat instance
in the presence of multiple, load-balancing servers.
The secret is sent when the secret=secret_keyword
parameter is used in
ProxyPass or
BalancerMember directives.
The backend needs to support secret and the values must match.
request.secret or requiredSecret are documented in the AJP
configuration of the Apache Tomcat.
Beyond this list of basic attributes, any number of other attributes
can be sent via the req_attribute code 0x0A.
A pair of strings to represent the attribute name and value are sent
immediately after each instance of that code. Environment values are passed
in via this method.
Finally, after all the attributes have been sent, the attribute
terminator, 0xFF, is sent. This signals both the end of the
list of attributes and also then end of the Request Packet.
for messages which the container can send back to the server.
AJP13_SEND_BODY_CHUNK :=
prefix_code 3
chunk_length (integer)
chunk *(byte)
chunk_terminator (byte) Ox00
AJP13_SEND_HEADERS :=
prefix_code 4
http_status_code (integer)
http_status_msg (string)
num_headers (integer)
response_headers *(res_header_name header_value)
res_header_name :=
sc_res_header_name | (string) [see below for how this is parsed]
sc_res_header_name := 0xA0 (byte)
header_value := (string)
AJP13_END_RESPONSE :=
prefix_code 5
reuse (boolean)
AJP13_GET_BODY_CHUNK :=
prefix_code 6
requested_length (integer)The chunk is basically binary data, and is sent directly back to the browser.
The status code and message are the usual HTTP things
(e.g. 200 and OK). The response header names are
encoded the same way the request header names are. See header_encoding above
for details about how the codes are distinguished from the strings.
The codes for common headers are:
| Name | Code value |
| Content-Type | 0xA001 |
| Content-Language | 0xA002 |
| Content-Length | 0xA003 |
| Date | 0xA004 |
| Last-Modified | 0xA005 |
| Location | 0xA006 |
| Set-Cookie | 0xA007 |
| Set-Cookie2 | 0xA008 |
| Servlet-Engine | 0xA009 |
| Status | 0xA00A |
| WWW-Authenticate | 0xA00B |
After the code or the string header name, the header value is immediately encoded.
Signals the end of this request-handling cycle. If the
reuse flag is true (anything other than 0 in the actual
C code), this TCP connection can now be used to handle new incoming
requests. If reuse is false (==0), the connection should
be closed.
The container asks for more data from the request (If the body was
too large to fit in the first packet sent over or when the request is
chunked). The server will send a body packet back with an amount of data
which is the minimum of the request_length, the maximum send
body size (8186 (8 Kbytes - 6)), and the number of bytes
actually left to send from the request body.
If there is no more data in the body (i.e. the servlet container is
trying to read past the end of the body), the server will send back an
empty packet, which is a body packet with a payload length of 0.
(0x12,0x34,0x00,0x00)
Apache HTTP Server Version 2.4
| Description: | Dynamic mass reverse proxy extension for
mod_proxy |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_express_module |
| Source File: | mod_proxy_express.c |
| Compatibility: | Available in Apache 2.3.13 and later |
This module creates dynamically configured mass reverse
proxies, by mapping the Host: header of the HTTP request to
a server name and backend URL stored in a DBM file.
This allows for easy use of a huge number of reverse proxies
with no configuration changes. It is much less feature-full
than mod_proxy_balancer, which also provides
dynamic growth, but is intended to handle much, much
larger numbers of backends. It is ideally suited as a
front-end HTTP switch and for micro-services architectures.
This module requires the service of mod_proxy.
Do not enable proxying until you have secured your server. Open proxy servers are dangerous both to your network and to the Internet at large.
mod_proxy_balancer. Instead, it is intended to be mostly
a lightweight and fast alternative to using mod_rewrite
with RewriteMap and the
[P] flag for mapped reverse proxying.
<VirtualHost *:80> ServerName front.end.server ProxyPass "/" "back.end.server:port" ProxyPassReverse "/" "back.end.server:port" </VirtualHost>That is, the entire URL is appended to the mapped backend URL. This is in keeping with the intent of being a simple but fast reverse proxy switch.
| Description: | Pathname to DBM file. |
|---|---|
| Syntax: | ProxyExpressDBMFile pathname |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy_express |
The ProxyExpressDBMFile directive
points to the location of the Express map DBM file. This
file serves to map the incoming server name, obtained from
the Host: header, to a backend URL.
The file is constructed from a plain text file format using
the httxt2dbm
utility.
##
##express-map.txt:
##
www1.example.com http://192.168.211.2:8080
www2.example.com http://192.168.211.12:8088
www3.example.com http://192.168.212.10
httxt2dbm -i express-map.txt -o emap
ProxyExpressEnable on ProxyExpressDBMFile emap
| Description: | DBM type of file. |
|---|---|
| Syntax: | ProxyExpressDBMType type |
| Default: | ProxyExpressDBMType default |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy_express |
The ProxyExpressDBMType directive
controls the DBM type expected by the module. The default
is the default DBM type created with
httxt2dbm.
Possible values are (not all may be available at run time):
| Value | Description |
|---|---|
db | Berkeley DB files |
gdbm | GDBM files |
ndbm | NDBM files |
sdbm | SDBM files (always available) |
default | default DBM type |
| Description: | Enable the module functionality. |
|---|---|
| Syntax: | ProxyExpressEnable on|off |
| Default: | ProxyExpressEnable off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy_express |
The ProxyExpressEnable directive
controls whether the module will be active.
Apache HTTP Server Version 2.4
| Description: | FTP support module for
mod_proxy |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_ftp_module |
| Source File: | mod_proxy_ftp.c |
This module requires the service of mod_proxy. It provides support for the proxying
FTP sites. Note that FTP support is currently limited to
the GET method.
Thus, in order to get the ability of handling FTP proxy requests,
mod_proxy and mod_proxy_ftp
have to be present in the server.
Do not enable proxying until you have secured your server. Open proxy servers are dangerous both to your network and to the Internet at large.
Why doesn't file type xxx
download via FTP? How can I force an FTP ASCII download of
file xxx? How can I do FTP upload? How can I access FTP files outside
of my home directory? How can I hide the FTP cleartext password
in my browser's URL line? Why do I get a file listing when I expected
a file to be downloaded?You probably don't have that particular file type defined as
application/octet-stream in your proxy's mime.types
configuration file. A useful line can be:
application/octet-stream bin dms lha lzh exe class tgz taz
Alternatively you may prefer to use the ForceType
directive to default everything to binary:
ForceType application/octet-stream
In the rare situation where you must download a specific file using the
FTP ASCII transfer method (while the default transfer is in
binary mode), you can override mod_proxy's
default by suffixing the request with ;type=a to force an
ASCII transfer. (FTP Directory listings are always executed in ASCII mode,
however.)
Currently, only GET is supported for FTP in mod_proxy. You can
of course use HTTP upload (POST or PUT) through an Apache proxy.
An FTP URI is interpreted relative to the home directory of the user
who is logging in. Alas, to reach higher directory levels you cannot
use /../, as the dots are interpreted by the browser and not actually
sent to the FTP server. To address this problem, the so called Squid
%2f hack was implemented in the Apache FTP proxy; it is a
solution which is also used by other popular proxy servers like the Squid Proxy Cache. By
prepending /%2f to the path of your request, you can make
such a proxy change the FTP starting directory to / (instead
of the home directory). For example, to retrieve the file
/etc/motd, you would use the URL:
ftp://user@host/%2f/etc/motd
To log in to an FTP server by username and password, Apache uses different strategies. In absence of a user name and password in the URL altogether, Apache sends an anonymous login to the FTP server, i.e.,
user: anonymous
password: apache-proxy@
This works for all popular FTP servers which are configured for anonymous access.
For a personal login with a specific username, you can embed the user name into the URL, like in:
ftp://username@host/myfile
If the FTP server asks for a password when given this username (which
it should), then Apache will reply with a 401 (Authorization
required) response, which causes the Browser to pop up the
username/password dialog. Upon entering the password, the connection
attempt is retried, and if successful, the requested resource is
presented. The advantage of this procedure is that your browser does not
display the password in cleartext (which it would if you had used
ftp://username:password@host/myfile
in the first place).
The password which is transmitted in such a way is not encrypted on its way. It travels between your browser and the Apache proxy server in a base64-encoded cleartext string, and between the Apache proxy and the FTP server as plaintext. You should therefore think twice before accessing your FTP server via HTTP (or before accessing your personal files via FTP at all!) When using insecure channels, an eavesdropper might intercept your password on its way.
In order to allow both browsing the directories on an FTP server and downloading files, Apache looks at the request URL. If it looks like a directory, or contains wildcard characters ("*?[{~"), then it guesses that a listing is wanted instead of a download.
You can disable the special handling of names with wildcard characters.
See the ProxyFtpListOnWildcard directive.
| Description: | Define the character set for proxied FTP listings |
|---|---|
| Syntax: | ProxyFtpDirCharset character_set |
| Default: | ProxyFtpDirCharset ISO-8859-1 |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy_ftp |
| Compatibility: | Available in Apache 2.2.7 and later. Moved from mod_proxy in Apache 2.3.5. |
The ProxyFtpDirCharset directive defines the
character set to be set for FTP directory listings in HTML generated by
mod_proxy_ftp.
| Description: | Whether wildcards in requested filenames are escaped when sent to the FTP server |
|---|---|
| Syntax: | ProxyFtpEscapeWildcards on|off |
| Default: | ProxyFtpEscapeWildcards on |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy_ftp |
| Compatibility: | Available in Apache 2.3.3 and later |
The ProxyFtpEscapeWildcards directive
controls whether wildcard characters ("*?[{~") in requested
filenames are escaped with backslash before sending them to the
FTP server. That is the default behavior, but many FTP servers
don't know about the escaping and try to serve the literal filenames
they were sent, including the backslashes in the names.
Set to "off" to allow downloading files with wildcards in their names from FTP servers that don't understand wildcard escaping.
| Description: | Whether wildcards in requested filenames trigger a file listing |
|---|---|
| Syntax: | ProxyFtpListOnWildcard on|off |
| Default: | ProxyFtpListOnWildcard on |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy_ftp |
| Compatibility: | Available in Apache 2.3.3 and later |
The ProxyFtpListOnWildcard directive
controls whether wildcard characters ("*?[{~") in requested
filenames cause mod_proxy_ftp to return a listing
of files instead of downloading a file. By default (value on),
they do.
Set to "off" to allow downloading files even if they have wildcard characters in their names.
Apache HTTP Server Version 2.4
| Description: | HTTP support module for
mod_proxy |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_http_module |
| Source File: | mod_proxy_http.c |
This module requires the service of mod_proxy. It provides the features used for
proxying HTTP and HTTPS requests. mod_proxy_http
supports HTTP/0.9, HTTP/1.0 and HTTP/1.1. It does not
provide any caching abilities. If you want to set up a caching
proxy, you might want to use the additional service of the
mod_cache module.
Thus, in order to get the ability of handling HTTP proxy requests,
mod_proxy and mod_proxy_http
have to be present in the server.
Do not enable proxying until you have secured your server. Open proxy servers are dangerous both to your network and to the Internet at large.
This module provides no directives.
In addition to the configuration directives that control the
behaviour of mod_proxy, there are a number of
environment variables that control the HTTP protocol
provider. Environment variables below that don't specify specific values
are enabled when set to any value.
RFC (the default) or
Suppress. Earlier httpd versions would suppress
HTTP interim (1xx) responses sent from the backend. This is
technically a violation of the HTTP protocol. In practice,
if a backend sends an interim response, it may itself be
extending the protocol in a manner we know nothing about,
or just broken. So this is now configurable: set
proxy-interim-response RFC to be fully protocol
compliant, or proxy-interim-response Suppress
to suppress interim responses.mod_proxy_http creates the following request notes for
logging using the %{VARNAME}n format in
LogFormat or
ErrorLogFormat:
Apache HTTP Server Version 2.4
| Description: | UWSGI gateway module for mod_proxy |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_uwsgi_module |
| Source File: | mod_proxy_uwsgi.c |
| Compatibility: | Available in version 2.4.30 and later |
This module requires the service of mod_proxy. It provides support for the
UWSGI protocol.
Thus, in order to get the ability of handling the UWSGI protocol,
mod_proxy and mod_proxy_uwsgi have to
be present in the server.
Do not enable proxying until you have secured your server. Open proxy servers are dangerous both to your network and to the Internet at large.
This module provides no directives.
Remember, in order to make the following examples work, you have to
enable mod_proxy and mod_proxy_uwsgi.
ProxyPass "/uwsgi-bin/" "uwsgi://localhost:4000/"
The balanced gateway needs mod_proxy_balancer and
at least one load balancer algorithm module, such as
mod_lbmethod_byrequests, in addition to the proxy
modules listed above. mod_lbmethod_byrequests is the
default, and will be used for this example configuration.
ProxyPass "/uwsgi-bin/" "balancer://somecluster/"
<Proxy balancer://somecluster>
BalancerMember uwsgi://localhost:4000
BalancerMember uwsgi://localhost:4001
</Proxy>
Apache HTTP Server Version 2.4
| Description: | Reflect a request body as a response via the output filter stack. |
|---|---|
| Status: | Base |
| Module Identifier: | reflector_module |
| Source File: | mod_reflector.c |
| Compatibility: | Version 2.3 and later |
This module allows request bodies to be reflected back to the client, in the process passing the request through the output filter stack. A suitably configured chain of filters can be used to transform the request into a response. This module can be used to turn an output filter into an HTTP service.
<Location "/compress">
SetHandler reflector
SetOutputFilter DEFLATE
</Location>
<Location "/downsample">
SetHandler reflector
SetOutputFilter DOWNSAMPLE
</Location>
| Description: | Reflect an input header to the output headers |
|---|---|
| Syntax: | ReflectorHeader inputheader [outputheader] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Base |
| Module: | mod_reflector |
This directive controls the reflection of request headers to the response. The first argument is the name of the request header to copy. If the optional second argument is specified, it will be used as the name of the response header, otherwise the original request header name will be used.
Apache HTTP Server Version 2.4
| Description: | Filters to handle and make available HTTP request bodies |
|---|---|
| Status: | Base |
| Module Identifier: | request_module |
| Source File: | mod_request.c |
| Compatibility: | Available in Apache 2.3 and later |
| Description: | Keep the request body instead of discarding it up to the specified maximum size, for potential use by filters such as mod_include. |
|---|---|
| Syntax: | KeptBodySize maximum size in bytes |
| Default: | KeptBodySize 0 |
| Context: | directory |
| Status: | Base |
| Module: | mod_request |
Under normal circumstances, request handlers such as the
default handler for static files will discard the request body
when it is not needed by the request handler. As a result,
filters such as mod_include are limited to making GET requests
only when including other URLs as subrequests, even if the
original request was a POST request, as the discarded
request body is no longer available once filter processing is
taking place.
When this directive has a value greater than zero, request
handlers that would otherwise discard request bodies will
instead set the request body aside for use by filters up to
the maximum size specified. In the case of the mod_include
filter, an attempt to POST a request to the static
shtml file will cause any subrequests to be POST
requests, instead of GET requests as before.
This feature makes it possible to break up complex web pages and
web applications into small individual components, and combine
the components and the surrounding web page structure together
using mod_include. The components can take the
form of CGI programs, scripted languages, or URLs reverse proxied
into the URL space from another server using
mod_proxy.
Note: Each request set aside has to be set aside in temporary RAM until the request is complete. As a result, care should be taken to ensure sufficient RAM is available on the server to support the intended load. Use of this directive should be limited to where needed on targeted parts of your URL space, and with the lowest possible value that is still big enough to hold a request body.
If the request size sent by the client exceeds the maximum
size allocated by this directive, the server will return
413 Request Entity Too Large.
Apache HTTP Server Version 2.4
| Description: | Session support |
|---|---|
| Status: | Extension |
| Module Identifier: | session_module |
| Source File: | mod_session.c |
| Compatibility: | Available in Apache 2.3 and later |
The session modules make use of HTTP cookies, and as such can fall victim to Cross Site Scripting attacks, or expose potentially private information to clients. Please ensure that the relevant risks have been taken into account before enabling the session functionality on your server.
This module provides support for a server wide per user session interface. Sessions can be used for keeping track of whether a user has been logged in, or for other per user information that should be kept available across requests.
Sessions may be stored on the server, or may be stored on the
browser. Sessions may also be optionally encrypted for added security.
These features are divided into several modules in addition to
mod_session; mod_session_crypto,
mod_session_cookie and mod_session_dbd.
Depending on the server requirements, load the appropriate modules
into the server (either statically at compile time or dynamically
via the LoadModule directive).
Sessions may be manipulated from other modules that depend on the session, or the session may be read from and written to using environment variables and HTTP headers, as appropriate.
What is a session? Who can use a session? Keeping sessions on the server Keeping sessions on the browser Basic Examples Session Privacy Cookie Privacy Session Support for Authentication Integrating Sessions with External Applications Session SessionEnv SessionExclude SessionExpiryUpdateInterval SessionHeader SessionInclude SessionMaxAgeAt the core of the session interface is a table of key and value pairs that are made accessible across browser requests. These pairs can be set to any valid string, as needed by the application making use of the session.
The "session" is a application/x-www-form-urlencoded string containing these key value pairs, as defined by the HTML specification.
The session can optionally be encrypted and base64 encoded before being written to the storage mechanism, as defined by the administrator.
The session interface is primarily developed for the use by other
server modules, such as mod_auth_form, however CGI
based applications can optionally be granted access to the contents
of the session via the HTTP_SESSION environment variable. Sessions
have the option to be modified and/or updated by inserting an HTTP
response header containing the new session parameters.
Apache can be configured to keep track of per user sessions stored on a particular server or group of servers. This functionality is similar to the sessions available in typical application servers.
If configured, sessions are tracked through the use of a session ID that is stored inside a cookie, or extracted from the parameters embedded within the URL query string, as found in a typical GET request.
As the contents of the session are stored exclusively on the server, there is an expectation of privacy of the contents of the session. This does have performance and resource implications should a large number of sessions be present, or where a large number of webservers have to share sessions with one another.
The mod_session_dbd module allows the storage of user
sessions within a SQL database via mod_dbd.
In high traffic environments where keeping track of a session on a server is too resource intensive or inconvenient, the option exists to store the contents of the session within a cookie on the client browser instead.
This has the advantage that minimal resources are required on the server to keep track of sessions, and multiple servers within a server farm have no need to share session information.
The contents of the session however are exposed to the client, with a
corresponding risk of a loss of privacy. The
mod_session_crypto module can be configured to encrypt the
contents of the session before writing the session to the client.
The mod_session_cookie allows the storage of user
sessions on the browser within an HTTP cookie.
Creating a session is as simple as turning the session on, and deciding
where the session will be stored. In this example, the session will be
stored on the browser, in a cookie called session.
Session On SessionCookieName session path=/
The session is not useful unless it can be written to or read from. The
following example shows how values can be injected into the session through
the use of a predetermined HTTP response header called
X-Replace-Session.
Session On SessionCookieName session path=/ SessionHeader X-Replace-Session
The header should contain name value pairs expressed in the same format as a query string in a URL, as in the example below. Setting a key to the empty string has the effect of removing that key from the session.
#!/bin/bash echo "Content-Type: text/plain" echo "X-Replace-Session: key1=foo&key2=&key3=bar" echo env
If configured, the session can be read back from the HTTP_SESSION
environment variable. By default, the session is kept private, so this
has to be explicitly turned on with the
SessionEnv directive.
Session On SessionEnv On SessionCookieName session path=/ SessionHeader X-Replace-Session
Once read, the CGI variable HTTP_SESSION should contain
the value key1=foo&key3=bar.
Using the "show cookies" feature of your browser, you would have seen a clear text representation of the session. This could potentially be a problem should the end user need to be kept unaware of the contents of the session, or where a third party could gain unauthorised access to the data within the session.
The contents of the session can be optionally encrypted before being
placed on the browser using the mod_session_crypto
module.
Session On SessionCryptoPassphrase secret SessionCookieName session path=/
The session will be automatically decrypted on load, and encrypted on save by Apache, the underlying application using the session need have no knowledge that encryption is taking place.
Sessions stored on the server rather than on the browser can also be
encrypted as needed, offering privacy where potentially sensitive
information is being shared between webservers in a server farm using
the mod_session_dbd module.
The HTTP cookie mechanism also offers privacy features, such as the ability to restrict cookie transport to SSL protected pages only, or to prevent browser based javascript from gaining access to the contents of the cookie.
Some of the HTTP cookie privacy features are either non-standard, or
are not implemented consistently across browsers. The session modules
allow you to set cookie parameters, but it makes no guarantee that privacy
will be respected by the browser. If security is a concern, use the
mod_session_crypto to encrypt the contents of the session,
or store the session on the server using the mod_session_dbd
module.
Standard cookie parameters can be specified after the name of the cookie, as in the example below.
Session On SessionCryptoPassphrase secret SessionCookieName session path=/private;domain=example.com;httponly;secure;
In cases where the Apache server forms the frontend for backend origin servers,
it is possible to have the session cookies removed from the incoming HTTP headers using
the SessionCookieRemove directive.
This keeps the contents of the session cookies from becoming accessible from the
backend server.
As is possible within many application servers, authentication modules can use
a session for storing the username and password after login. The
mod_auth_form saves the user's login name and password within
the session.
Session On SessionCryptoPassphrase secret SessionCookieName session path=/ AuthFormProvider file AuthUserFile "conf/passwd" AuthType form AuthName "realm" #...
See the mod_auth_form module for documentation and complete
examples.
In order for sessions to be useful, it must be possible to share the contents of a session with external applications, and it must be possible for an external application to write a session of its own.
A typical example might be an application that changes a user's password set by
mod_auth_form. This application would need to read the current
username and password from the session, make the required changes to the user's
password, and then write the new password to the session in order to provide a
seamless transition to the new password.
A second example might involve an application that registers a new user for the first time. When registration is complete, the username and password is written to the session, providing a seamless transition to being logged in.
mod_auth_form.
SessionEnv directive. The session
can be written to by the script by returning a
application/x-www-form-urlencoded response header with a name
set by the SessionHeader
directive. In both cases, any encryption or decryption, and the reading the
session from or writing the session to the chosen storage mechanism is handled
by the mod_session modules and corresponding configuration.
mod_proxySessionHeader
directive is used to define an HTTP request header, the session, encoded as
a application/x-www-form-urlencoded string, will be made
available to the application. If the same header is provided in the response,
the value of this response header will be used to replace the session. As
above, any encryption or decryption, and the reading the session from or
writing the session to the chosen storage mechanism is handled by the
mod_session modules and corresponding configuration.| Description: | Enables a session for the current directory or location |
|---|---|
| Syntax: | Session On|Off |
| Default: | Session Off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_session |
The Session directive enables a session for the
directory or location container. Further directives control where the
session will be stored and how privacy is maintained.
| Description: | Control whether the contents of the session are written to the HTTP_SESSION environment variable |
|---|---|
| Syntax: | SessionEnv On|Off |
| Default: | SessionEnv Off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_session |
If set to On, the SessionEnv directive
causes the contents of the session to be written to a CGI environment
variable called HTTP_SESSION.
The string is written in the URL query format, for example:
key1=foo&key3=bar
| Description: | Define URL prefixes for which a session is ignored |
|---|---|
| Syntax: | SessionExclude path |
| Default: | none |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session |
The SessionExclude directive allows sessions to
be disabled relative to URL prefixes only. This can be used to make a
website more efficient, by targeting a more precise URL space for which
a session should be maintained. By default, all URLs within the directory
or location are included in the session. The
SessionExclude directive takes
precedence over the
SessionInclude directive.
This directive has a similar purpose to the path attribute in HTTP cookies, but should not be confused with this attribute. This directive does not set the path attribute, which must be configured separately.
| Description: | Define the number of seconds a session's expiry may change without the session being updated |
|---|---|
| Syntax: | SessionExpiryUpdateInterval interval |
| Default: | SessionExpiryUpdateInterval 0 (always update) |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session |
| Compatibility: | Available in Apache 2.4.41 and later |
The SessionExpiryUpdateInterval directive allows
sessions to avoid the cost associated with writing the session each request
when only the expiry time has changed. This can be used to make a website
more efficient or reduce load on a database when using
mod_session_dbd. The session is always written if the data
stored in the session has changed or the expiry has changed by more than the
configured interval.
Setting the interval to zero disables this directive, and the session expiry is refreshed for each request.
This directive only has an effect when combined with
SessionMaxAge to enable session
expiry. Sessions without an expiry are only written when the data stored in
the session has changed.
Because the session expiry may not be refreshed with each request, it's possible for sessions to expire up to interval seconds early. Using a small interval usually provides sufficient savings while having a minimal effect on expiry resolution.
| Description: | Import session updates from a given HTTP response header |
|---|---|
| Syntax: | SessionHeader header |
| Default: | none |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_session |
The SessionHeader directive defines the name of an
HTTP response header which, if present, will be parsed and written to the
current session.
The header value is expected to be in the URL query format, for example:
key1=foo&key2=&key3=bar
Where a key is set to the empty string, that key will be removed from the session.
| Description: | Define URL prefixes for which a session is valid |
|---|---|
| Syntax: | SessionInclude path |
| Default: | all URLs |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_session |
The SessionInclude directive allows sessions to
be made valid for specific URL prefixes only. This can be used to make a
website more efficient, by targeting a more precise URL space for which
a session should be maintained. By default, all URLs within the directory
or location are included in the session.
This directive has a similar purpose to the path attribute in HTTP cookies, but should not be confused with this attribute. This directive does not set the path attribute, which must be configured separately.
| Description: | Define a maximum age in seconds for a session |
|---|---|
| Syntax: | SessionMaxAge maxage |
| Default: | SessionMaxAge 0 |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_session |
The SessionMaxAge directive defines a time limit
for which a session will remain valid. When a session is saved, this time
limit is reset and an existing session can be continued. If a session
becomes older than this limit without a request to the server to refresh
the session, the session will time out and be removed. Where a session is
used to stored user login details, this has the effect of logging the user
out automatically after the given time.
Setting the maxage to zero disables session expiry.
Apache HTTP Server Version 2.4
| Description: | FastCGI support module for
mod_proxy |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_fcgi_module |
| Source File: | mod_proxy_fcgi.c |
| Compatibility: | Available in version 2.3 and later |
This module requires the service of mod_proxy. It provides support for the
FastCGI protocol.
Thus, in order to get the ability of handling the FastCGI
protocol, mod_proxy and
mod_proxy_fcgi have to be present in the server.
Unlike mod_fcgid
and mod_fastcgi,
mod_proxy_fcgi has no provision for starting the
application process; fcgistarter is provided
(on some platforms) for that purpose. Alternatively, external launching
or process management may be available in the FastCGI application
framework in use.
Do not enable proxying until you have secured your server. Open proxy servers are dangerous both to your network and to the Internet at large.
Remember, in order to make the following examples work, you have to
enable mod_proxy and mod_proxy_fcgi.
ProxyPass "/myapp/" "fcgi://localhost:4000/"
mod_proxy_fcgi disables connection reuse by
default, so after a request has been completed the connection will NOT be
held open by that httpd child process and won't be reused. If the
FastCGI application is able to handle concurrent connections
from httpd, you can opt-in to connection reuse as shown in the following
example:
ProxyPass "/myapp/" "fcgi://localhost:4000/" enablereuse=on
Please keep in mind that PHP-FPM (at the time of writing, February 2018)
uses a prefork model, namely each of its worker processes can handle one
connection at the time.
By default mod_proxy (configured with enablereuse=on)
allows a connection pool of
ThreadsPerChild connections to the
backend for each httpd process when using a threaded mpm (like
worker or event),
so the following use cases should be taken into account:
MaxRequestWorkers
connections to the FCGI backend.mod_http2 is implemented,
there are additional h2 worker threads that may force the creation of other
backend connections. The overall count of connections in the pools may raise
to more than MaxRequestWorkers.The maximum number of PHP-FPM worker processes needs to be configured wisely, since there is the chance that they will all end up "busy" handling idle persistent connections, without any room for new ones to be established, and the end user experience will be a pile of HTTP request timeouts.
The following example passes the request URI as a filesystem path for the PHP-FPM daemon to run. The request URL is implicitly added to the 2nd parameter. The hostname and port following fcgi:// are where PHP-FPM is listening. Connection pooling/reuse is enabled.
ProxyPassMatch "^/myapp/.*\.php(/.*)?$" "fcgi://localhost:9000/var/www/" enablereuse=on
The following example passes the request URI as a filesystem path for the PHP-FPM daemon to run. In this case, PHP-FPM is listening on a unix domain socket (UDS). Requires 2.4.9 or later. With this syntax, the hostname and optional port following fcgi:// are ignored.
ProxyPassMatch "^/(.*\.php(/.*)?)$" "unix:/var/run/php5-fpm.sock|fcgi://localhost/var/www/"
The balanced gateway needs mod_proxy_balancer and
at least one load balancer algorithm module, such as
mod_lbmethod_byrequests, in addition to the proxy
modules listed above. mod_lbmethod_byrequests is the
default, and will be used for this example configuration.
ProxyPass "/myapp/" "balancer://myappcluster/"
<Proxy "balancer://myappcluster/">
BalancerMember "fcgi://localhost:4000"
BalancerMember "fcgi://localhost:4001"
</Proxy>
You can also force a request to be handled as a reverse-proxy request, by creating a suitable Handler pass-through. The example configuration below will pass all requests for PHP scripts to the specified FastCGI server using reverse proxy. This feature is available in Apache HTTP Server 2.4.10 and later. For performance reasons, you will want to define a worker representing the same fcgi:// backend. The benefit of this form is that it allows the normal mapping of URI to filename to occur in the server, and the local filesystem result is passed to the backend. When FastCGI is configured this way, the server can calculate the most accurate PATH_INFO.
<FilesMatch "\.php$">
# Note: The only part that varies is /path/to/app.sock
SetHandler "proxy:unix:/path/to/app.sock|fcgi://localhost/"
</FilesMatch>
# Define a matching worker.
# The part that is matched to the SetHandler is the part that
# follows the pipe. If you need to distinguish, "localhost; can
# be anything unique.
<Proxy "fcgi://localhost/" enablereuse=on max=10>
</Proxy>
<FilesMatch ...>
SetHandler "proxy:fcgi://localhost:9000"
</FilesMatch>
<FilesMatch ...>
SetHandler "proxy:balancer://myappcluster/"
</FilesMatch>
In addition to the configuration directives that control the
behaviour of mod_proxy, there are a number of
environment variables that control the FCGI protocol
provider:
ProxyPass or ProxyPassMatch, mod_proxy_fcgi will not
set the PATH_INFO environment variable. This allows
the backend FCGI server to correctly determine SCRIPT_NAME
and Script-URI and be compliant with RFC 3875 section 3.3.
If instead you need mod_proxy_fcgi to generate
a "best guess" for PATH_INFO, set this env-var.
This is a workaround for a bug in some FCGI implementations. This
variable can be set to multiple values to tweak at how the best guess
is chosen (In 2.4.11 and later only):
| Description: | Specify the type of backend FastCGI application |
|---|---|
| Syntax: | ProxyFCGIBackendType FPM|GENERIC |
| Default: | ProxyFCGIBackendType FPM |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_proxy_fcgi |
| Compatibility: | Available in version 2.4.26 and later |
This directive allows the type of backend FastCGI application to be specified. Some FastCGI servers, such as PHP-FPM, use historical quirks of environment variables to identify the type of proxy server being used. Set this directive to "GENERIC" if your non PHP-FPM application has trouble interpreting environment variables such as SCRIPT_FILENAME or PATH_TRANSLATED as set by the server.
One example of values that change based on the setting of this directive is
SCRIPT_FILENAME. When using mod_proxy_fcgi historically,
SCRIPT_FILENAME was prefixed with the string "proxy:fcgi://". This variable is
what some generic FastCGI applications would read as their script input, but
PHP-FPM would strip the prefix then remember it was talking to Apache. In
2.4.21 through 2.4.25, this prefix was automatically stripped by the server,
breaking the ability of PHP-FPM to detect and interoperate with Apache in some
scenarios.
| Description: | Allow variables sent to FastCGI servers to be fixed up |
|---|---|
| Syntax: | ProxyFCGISetEnvIf conditional-expression
[!]environment-variable-name
[value-expression] |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_proxy_fcgi |
| Compatibility: | Available in version 2.4.26 and later |
Just before passing a request to the configured FastCGI server, the core of the web server sets a number of environment variables based on details of the current request. FastCGI programs often uses these environment variables as inputs that determine what underlying scripts they will process, or what output they directly produce.
Examples of noteworthy environment variables are:
This directive allows the environment variables above, or any others of interest, to be overridden. This directive is evaluated after the initial values for these variables are set, so they can be used as input into both the condition expressions and value expressions.
Parameter syntax:
# A basic, unconditional override
ProxyFCGISetEnvIf "true" PATH_INFO "/example"
# Use an environment variable in the value
ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"
# Use captures in the conditions and backreferences in the replacement
ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m|(/.*prefix)(\d+)(.*)|" PATH_TRANSLATED "$1$3"
VARIABLE, preventing it from being sent
to the FastCGI server:
ProxyFCGISetEnvIf true !VARIABLEWhereas the following will erase any existing value of
VARIABLE (by setting it to the empty string), but the empty
VARIABLE will still be sent to the server:
ProxyFCGISetEnvIf true VARIABLEThe CGI/1.1 specification does not distinguish between a variable with an empty value and a variable that does not exist. However, many CGI and FastCGI implementations distinguish (or allow scripts to distinguish) between the two. The choice of which to use is dependent upon your implementation and your reason for modifying the variable.
Apache HTTP Server Version 2.4
| Description: | Dynamic health check of Balancer members (workers) for
mod_proxy |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_hcheck_module |
| Source File: | mod_proxy_hcheck.c |
| Compatibility: | Available in Apache 2.4.21 and later |
This module provides for dynamic health checking of balancer members (workers). This can be enabled on a worker-by-worker basis. The health check is done independently of the actual reverse proxy requests.
This module requires the service of mod_watchdog.
The health check mechanism is enabled via the use of additional
BalancerMember parameters, which are configured
in the standard way via ProxyPass:
A new BalancerMember status state (flag)
is defined via this module: "C".
When the worker is taken offline due to failures as determined by the health
check module, this flag is set, and can be seen (and modified) via the
balancer-manager.
| Parameter | Default | Description | |||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hcmethod | None | No dynamic health check performed. Choices are:
| |||||||||||||||||||||||||||||||||
| hcpasses | 1 | Number of successful health check tests before worker is re-enabled | |||||||||||||||||||||||||||||||||
| hcfails | 1 | Number of failed health check tests before worker is disabled | |||||||||||||||||||||||||||||||||
| hcinterval | 30 | Period of health checks in seconds (e.g. performed every 30 seconds) | |||||||||||||||||||||||||||||||||
| hcuri | Additional URI to be appended to the worker URL for the health check. | ||||||||||||||||||||||||||||||||||
| hctemplate | Name of template, created via ProxyHCTemplate,
to use for setting health check parameters for this worker | ||||||||||||||||||||||||||||||||||
| hcexpr | Name of expression, created via ProxyHCExpr,
used to check response headers for health.If not used, 2xx thru 3xx status codes imply success | ||||||||||||||||||||||||||||||||||
OPTIONS11, HEAD11 and GET11 are
available in 2.4.55 and above.
The following example shows how one might configured health checking for various backend servers:
ProxyHCExpr ok234 {%{REQUEST_STATUS} =~ /^[234]/}
ProxyHCExpr gdown {%{REQUEST_STATUS} =~ /^[5]/}
ProxyHCExpr in_maint {hc('body') !~ /Under maintenance/}
<Proxy balancer://foo>
BalancerMember http://www.example.com/ hcmethod=GET hcexpr=in_maint hcuri=/status.php
BalancerMember http://www2.example.com/ hcmethod=HEAD hcexpr=ok234 hcinterval=10
BalancerMember http://www3.example.com/ hcmethod=TCP hcinterval=5 hcpasses=2 hcfails=3
BalancerMember http://www4.example.com/
</Proxy>
ProxyPass "/" "balancer://foo"
ProxyPassReverse "/" "balancer://foo"
In this scenario, http://www.example.com/ is health checked by sending a GET /status.php
request to that server and seeing that the returned page does not include the string Under maintenance. If
it does, that server is put in health-check fail mode, and disabled. This dynamic check is performed
every 30 seconds, which is the default.
http://www2.example.com/ is checked by sending a simple HEAD request every
10 seconds and making sure that the response status is 2xx, 3xx or 4xx. http://www3.example.com/ is checked
every 5 seconds by simply ensuring that the socket to that server is up. If the backend is marked as
"down" and it passes 2 health check, it will be re-enabled and added back into the load balancer.
It takes 3 back-to-back health check failures to disable the server and move it out
of rotation. Finally, http://www4.example.com/ is
not dynamically checked at all.
| Description: | Creates a named condition expression to use to determine health of the backend based on its response |
|---|---|
| Syntax: | ProxyHCExpr name {ap_expr expression} |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy_hcheck |
The ProxyHCExpr directive allows
for creating a named condition expression that checks the response
headers of the backend server to determine its health. This named
condition can then be assigned to balancer members via the hcexpr
parameter.
ProxyHCExpr ok234 {%{REQUEST_STATUS} =~ /^[234]/}
ProxyPass "/apps" "balancer://foo"
<Proxy balancer://foo>
BalancerMember http://www2.example.com/ hcmethod=HEAD hcexpr=ok234 hcinterval=10
</Proxy>
If using a health check method (eg: GET) which results in a response
body, that body itself can be checked via ap_expr using the hc()
expression function, which is unique to this module.
In the following example, we send the backend a GET request
and if the response body contains the phrase Under maintenance,
we want to disable the backend.
ProxyHCExpr in_maint {hc('body') !~ /Under maintenance/}
ProxyPass "/apps" "balancer://foo"
<Proxy balancer://foo>
BalancerMember http://www.example.com/ hcexpr=in_maint hcmethod=get hcuri=/status.php
</Proxy>
NOTE: Since response body can quite large, it is best if used against specific status pages.
| Description: | Creates a named template for setting various health check parameters |
|---|---|
| Syntax: | ProxyHCTemplate name parameter=setting [...] |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy_hcheck |
The ProxyHCTemplate directive allows
for creating a named set (template) of health check parameters
that can then be assigned to balancer members via the hctemplate
parameter.
ProxyHCTemplate tcp5 hcmethod=tcp hcinterval=5 ProxyPass "/apps" "balancer://foo" <Proxy balancer://foo> BalancerMember http://www2.example.com/ hctemplate=tcp5 </Proxy>
| Description: | Sets the total server-wide size of the threadpool used for the health check workers |
|---|---|
| Syntax: | ProxyHCTPsize size |
| Default: | ProxyHCTPsize 16 |
| Context: | server config |
| Status: | Extension |
| Module: | mod_proxy_hcheck |
If Apache httpd and APR are built with thread support, the health check
module will offload the work of the actual checking to a threadpool
associated with the Watchdog process, allowing for parallel checks.
The ProxyHCTPsize directive
determines the size of this threadpool. If set to 0, no threadpool
is used at all, resulting in serialized health checks.
ProxyHCTPsize 32
Apache HTTP Server Version 2.4
| Description: | HTTP/2 support module for
mod_proxy |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_http2_module |
| Source File: | mod_proxy_http2.c |
| Compatibility: | Available in httpd 2.4.19 and later |
mod_proxy_http2
supports HTTP/2 only, it does not
provide any downgrades to HTTP/1.1. This means that the backend
needs to support HTTP/2 because HTTP/1.1 will not be used instead.
This module requires the service of mod_proxy, so in order to get the ability of
handling HTTP/2 proxy requests,
mod_proxy and mod_proxy_http2
need to be both loaded by the server.
mod_proxy_http2 works with incoming fronted requests
using HTTP/1.1 or HTTP/2. In both cases, requests proxied
to the same backend are sent over a single TCP connection
whenever possible (namely when the connection can be re-used).
Caveat: there will be no attempt to consolidate multiple HTTP/1.1 frontend requests (configured to be proxied to the same backend) into HTTP/2 streams belonging to the same HTTP/2 request. Each HTTP/1.1 frontend request will be proxied to the backend using a separate HTTP/2 request (trying to re-use the same TCP connection if possible).
This module relies on libnghttp2 to provide the core http/2 engine.
This module is experimental. Its behaviors, directives, and defaults are subject to more change from release to release relative to other standard modules. Users are encouraged to consult the "CHANGES" file for potential updates.
Do not enable proxying until you have secured your server. Open proxy servers are dangerous both to your network and to the Internet at large.
This module provides no directives.
The examples below demonstrate how to configure HTTP/2 for backend connections for a reverse proxy.
ProxyPass "/app" "h2://app.example.com" ProxyPassReverse "/app" "https://app.example.com"
ProxyPass "/app" "h2c://app.example.com" ProxyPassReverse "/app" "http://app.example.com"
The schemes to configure above in
ProxyPassReverse for reverse proxying
h2 (or h2c) protocols are the usual
https (resp. http) as expected/used by
the user agent.
mod_proxy_http creates the following request notes for
logging using the %{VARNAME}n format in
LogFormat or
ErrorLogFormat:
Apache HTTP Server Version 2.4
| Description: | Multi-protocol proxy/gateway server |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_module |
| Source File: | mod_proxy.c |
Do not enable proxying with ProxyRequests until you have secured your server. Open proxy servers are dangerous both to your
network and to the Internet at large.
mod_proxy and related modules implement a
proxy/gateway for Apache HTTP Server, supporting a number of popular
protocols as well as several different load balancing algorithms.
Third-party modules can add support for additional protocols and
load balancing algorithms.
A set of modules must be loaded into the server to provide the
necessary features. These modules can be included statically at
build time or dynamically via the
LoadModule directive).
The set must include:
mod_proxy, which provides basic proxy
capabilitiesmod_proxy_balancer and one or more
balancer modules if load balancing is required. (See
mod_proxy_balancer for more information.)| Protocol | Module |
|---|---|
| AJP13 (Apache JServe Protocol version 1.3) | mod_proxy_ajp |
| CONNECT (for SSL) | mod_proxy_connect |
| FastCGI | mod_proxy_fcgi |
| ftp | mod_proxy_ftp |
| HTTP/0.9, HTTP/1.0, and HTTP/1.1 | mod_proxy_http |
| HTTP/2.0 | mod_proxy_http2 |
| SCGI | mod_proxy_scgi |
| UWSGI | mod_proxy_uwsgi |
| WS and WSS (Web-sockets) | mod_proxy_wstunnel |
In addition, extended features are provided by other modules.
Caching is provided by mod_cache and related
modules. The ability to contact remote servers using the SSL/TLS
protocol is provided by the SSLProxy* directives of
mod_ssl. These additional modules will need
to be loaded and configured to take advantage of these features.
Forward Proxies and Reverse
Proxies/Gateways Basic Examples Access via Handler Workers Controlling Access to Your Proxy Slow Startup Intranet Proxy Protocol Adjustments Request Bodies Reverse Proxy Request Headers BalancerGrowth BalancerInherit BalancerMember BalancerPersist NoProxy <Proxy> Proxy100Continue ProxyAddHeaders ProxyBadHeader ProxyBlock ProxyDomain ProxyErrorOverride ProxyIOBufferSize <ProxyMatch> ProxyMaxForwards ProxyPass ProxyPassInherit ProxyPassInterpolateEnv ProxyPassMatch ProxyPassReverse ProxyPassReverseCookieDomain ProxyPassReverseCookiePath ProxyPreserveHost ProxyReceiveBufferSize ProxyRemote ProxyRemoteMatch ProxyRequests ProxySet ProxySourceAddress ProxyStatus ProxyTimeout ProxyViaApache HTTP Server can be configured in both a forward and reverse proxy (also known as gateway) mode.
An ordinary forward proxy is an intermediate server that sits between the client and the origin server. In order to get content from the origin server, the client sends a request to the proxy naming the origin server as the target. The proxy then requests the content from the origin server and returns it to the client. The client must be specially configured to use the forward proxy to access other sites.
A typical usage of a forward proxy is to provide Internet
access to internal clients that are otherwise restricted by a
firewall. The forward proxy can also use caching (as provided
by mod_cache) to reduce network usage.
The forward proxy is activated using the ProxyRequests directive. Because
forward proxies allow clients to access arbitrary sites through
your server and to hide their true origin, it is essential that
you secure your server so that only
authorized clients can access the proxy before activating a
forward proxy.
A reverse proxy (or gateway), by contrast, appears to the client just like an ordinary web server. No special configuration on the client is necessary. The client makes ordinary requests for content in the namespace of the reverse proxy. The reverse proxy then decides where to send those requests and returns the content as if it were itself the origin.
A typical usage of a reverse proxy is to provide Internet users access to a server that is behind a firewall. Reverse proxies can also be used to balance load among several back-end servers or to provide caching for a slower back-end server. In addition, reverse proxies can be used simply to bring several servers into the same URL space.
A reverse proxy is activated using the ProxyPass directive or the
[P] flag to the RewriteRule directive. It is
not necessary to turn ProxyRequests on in order to
configure a reverse proxy.
The examples below are only a very basic idea to help you get started. Please read the documentation on the individual directives.
In addition, if you wish to have caching enabled, consult
the documentation from mod_cache.
ProxyPass "/foo" "http://foo.example.com/bar" ProxyPassReverse "/foo" "http://foo.example.com/bar"
ProxyRequests On ProxyVia On <Proxy "*"> Require host internal.example.com </Proxy>
ProxyPass "/some/ws/capable/path/" "http://example.com/some/ws/capable/path/" upgrade=websocket
You can also force a request to be handled as a reverse-proxy request, by creating a suitable Handler pass-through. The example configuration below will pass all requests for PHP scripts to the specified FastCGI server using reverse proxy:
<FilesMatch "\.php$">
# Unix sockets require 2.4.7 or later
SetHandler "proxy:unix:/path/to/app.sock|fcgi://localhost/"
</FilesMatch>
This feature is available in Apache HTTP Server 2.4.10 and later.
The proxy manages the configuration of origin servers and their communication parameters in objects called workers. There are two built-in workers: the default forward proxy worker and the default reverse proxy worker. Additional workers can be configured explicitly.
The two default workers have a fixed configuration and will be used if no other worker matches the request. They do not use HTTP Keep-Alive or connection reuse. The TCP connections to the origin server will instead be opened and closed for each request.
Explicitly configured workers are identified by their URL.
They are usually created and configured using
ProxyPass or
ProxyPassMatch when used
for a reverse proxy:
ProxyPass "/example" "http://backend.example.com" connectiontimeout=5 timeout=30
This will create a worker associated with the origin server URL
http://backend.example.com that will use the given timeout
values. When used in a forward proxy, workers are usually defined
via the ProxySet directive:
ProxySet "http://backend.example.com" connectiontimeout=5 timeout=30
or alternatively using Proxy
and ProxySet:
<Proxy "http://backend.example.com"> ProxySet connectiontimeout=5 timeout=30 </Proxy>
Using explicitly configured workers in the forward mode is
not very common, because forward proxies usually communicate with many
different origin servers. Creating explicit workers for some of the
origin servers can still be useful if they are used very often.
Explicitly configured workers have no concept of forward or reverse
proxying by themselves. They encapsulate a common concept of
communication with origin servers. A worker created by
ProxyPass for use in a
reverse proxy will also be used for forward proxy requests whenever
the URL to the origin server matches the worker URL, and vice versa.
The URL identifying a direct worker is the URL of its origin server including any path components given:
ProxyPass "/examples" "http://backend.example.com/examples" ProxyPass "/docs" "http://backend.example.com/docs"
This example defines two different workers, each using a separate connection pool and configuration.
Worker sharing happens if the worker URLs overlap, which occurs when the URL of some worker is a leading substring of the URL of another worker defined later in the configuration file. In the following example
ProxyPass "/apps" "http://backend.example.com/" timeout=60 ProxyPass "/examples" "http://backend.example.com/examples" timeout=10
the second worker isn't actually created. Instead the first
worker is used. The benefit is, that there is only one connection pool,
so connections are more often reused. Note that all configuration attributes
given explicitly for the later worker will be ignored. This will be logged
as a warning. In the above example, the resulting timeout value
for the URL /examples will be 60 instead
of 10!
If you want to avoid worker sharing, sort your worker definitions
by URL length, starting with the longest worker URLs. If you want to maximize
worker sharing, use the reverse sort order. See also the related warning about
ordering ProxyPass directives.
Explicitly configured workers come in two flavors:
direct workers and (load) balancer workers.
They support many important configuration attributes which are
described below in the ProxyPass
directive. The same attributes can also be set using
ProxySet.
The set of options available for a direct worker
depends on the protocol which is specified in the origin server URL.
Available protocols include ajp, fcgi,
ftp, http and scgi.
Balancer workers are virtual workers that use direct workers known as their members to actually handle the requests. Each balancer can have multiple members. When it handles a request, it chooses a member based on the configured load balancing algorithm.
A balancer worker is created if its worker URL uses
balancer as the protocol scheme.
The balancer URL uniquely identifies the balancer worker.
Members are added to a balancer using
BalancerMember.
DNS resolution happens when the socket to
the origin domain is created for the first time.
When connection reuse is enabled, each backend domain is resolved
only once per child process, and cached for all further connections
until the child is recycled. This information should to be considered
while planning DNS maintenance tasks involving backend domains.
Please also check ProxyPass
parameters for more details about connection reuse.
You can control who can access your proxy via the <Proxy> control block as in
the following example:
<Proxy "*"> Require ip 192.168.0 </Proxy>
For more information on access control directives, see
mod_authz_host.
Strictly limiting access is essential if you are using a
forward proxy (using the ProxyRequests directive).
Otherwise, your server can be used by any client to access
arbitrary hosts while hiding his or her true identity. This is
dangerous both for your network and for the Internet at large.
When using a reverse proxy (using the ProxyPass directive with
ProxyRequests Off), access control is less
critical because clients can only contact the hosts that you
have specifically configured.
See Also the Proxy-Chain-Auth environment variable.
If you're using the ProxyBlock directive, hostnames' IP addresses are looked up
and cached during startup for later match test. This may take a few
seconds (or more) depending on the speed with which the hostname lookups
occur.
An Apache httpd proxy server situated in an intranet needs to forward
external requests through the company's firewall (for this, configure
the ProxyRemote directive
to forward the respective scheme to the firewall proxy).
However, when it has to
access resources within the intranet, it can bypass the firewall when
accessing hosts. The NoProxy
directive is useful for specifying which hosts belong to the intranet and
should be accessed directly.
Users within an intranet tend to omit the local domain name from their
WWW requests, thus requesting "http://somehost/" instead of
http://somehost.example.com/. Some commercial proxy servers
let them get away with this and simply serve the request, implying a
configured local domain. When the ProxyDomain directive is used and the server is configured for proxy service, Apache httpd can return
a redirect response and send the client to the correct, fully qualified,
server address. This is the preferred method since the user's bookmark
files will then contain fully qualified hosts.
For circumstances where mod_proxy is sending
requests to an origin server that doesn't properly implement
keepalives or HTTP/1.1, there are two environment variables that can force the
request to use HTTP/1.0 with no keepalive. These are set via the
SetEnv directive.
These are the force-proxy-request-1.0 and
proxy-nokeepalive notes.
<Location "/buggyappserver/"> ProxyPass "http://buggyappserver:7001/foo/" SetEnv force-proxy-request-1.0 1 SetEnv proxy-nokeepalive 1 </Location>
In 2.4.26 and later, the "no-proxy" environment variable can be set to disable
mod_proxy processing the current request.
This variable should be set with SetEnvIf, as SetEnv
is not evaluated early enough.
Some request methods such as POST include a request body.
The HTTP protocol requires that requests which include a body
either use chunked transfer encoding or send a
Content-Length request header. When passing these
requests on to the origin server, mod_proxy_http
will always attempt to send the Content-Length. But
if the body is large and the original request used chunked
encoding, then chunked encoding may also be used in the upstream
request. You can control this selection using environment variables. Setting
proxy-sendcl ensures maximum compatibility with
upstream servers by always sending the
Content-Length, while setting
proxy-sendchunked minimizes resource usage by using
chunked encoding.
Under some circumstances, the server must spool request bodies to disk to satisfy the requested handling of request bodies. For example, this spooling will occur if the original body was sent with chunked encoding (and is large), but the administrator has asked for backend requests to be sent with Content-Length or as HTTP/1.0. This spooling can also occur if the request body already has a Content-Length header, but the server is configured to filter incoming request bodies.
When acting in a reverse-proxy mode (using the ProxyPass directive, for example),
mod_proxy_http adds several request headers in
order to pass information to the origin server. These headers
are:
X-Forwarded-ForX-Forwarded-HostHost
HTTP request header.X-Forwarded-ServerBe careful when using these headers on the origin server, since
they will contain more than one (comma-separated) value if the
original request already contained one of these headers. For
example, you can use %{X-Forwarded-For}i in the log
format string of the origin server to log the original clients IP
address, but you may get more than one address if the request
passes through several proxies.
See also the ProxyPreserveHost and ProxyVia directives, which control
other request headers.
Note: If you need to specify custom request headers to be
added to the forwarded request, use the
RequestHeader
directive.
| Description: | Number of additional Balancers that can be added Post-configuration |
|---|---|
| Syntax: | BalancerGrowth # |
| Default: | BalancerGrowth 5 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | BalancerGrowth is only available in Apache HTTP Server 2.3.13 and later. |
This directive allows for growth potential in the number of Balancers available for a virtualhost in addition to the number pre-configured. It only takes effect if there is at least one pre-configured Balancer.
| Description: | Inherit ProxyPassed Balancers/Workers from the main server |
|---|---|
| Syntax: | BalancerInherit On|Off |
| Default: | BalancerInherit On |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | BalancerInherit is only available in Apache HTTP Server 2.4.5 and later. |
This directive will cause the current server/vhost to "inherit" ProxyPass Balancers and Workers defined in the main server. This can cause issues and inconsistent behavior if using the Balancer Manager and so should be disabled if using that feature.
The setting in the global server defines the default for all vhosts.
| Description: | Add a member to a load balancing group |
|---|---|
| Syntax: | BalancerMember [balancerurl] url [key=value [key=value ...]] |
| Context: | directory |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | BalancerMember is only available in Apache HTTP Server 2.2 and later. |
This directive adds a member to a load balancing group. It can be used
within a <Proxy balancer://...> container
directive and can take any of the key value pair parameters available to
ProxyPass directives.
One additional parameter is available only to BalancerMember directives:
loadfactor. This is the member load factor - a decimal number between 1.0
(default) and 100.0, which defines the weighted load to be applied to the
member in question.
The balancerurl is only needed when not within a
<Proxy balancer://...>
container directive. It corresponds to the url of a balancer defined in
ProxyPass directive.
The path component of the balancer URL in any
<Proxy balancer://...> container directive
is ignored.
Trailing slashes should typically be removed from the URL of a
BalancerMember.
| Description: | Attempt to persist changes made by the Balancer Manager across restarts. |
|---|---|
| Syntax: | BalancerPersist On|Off |
| Default: | BalancerPersist Off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | BalancerPersist is only available in Apache HTTP Server 2.4.4 and later. |
This directive will cause the shared memory storage associated with the balancers and balancer members to be persisted across restarts. This allows these local changes to not be lost during the normal restart/graceful state transitions.
| Description: | Hosts, domains, or networks that will be connected to directly |
|---|---|
| Syntax: | NoProxy host [host] ... |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
This directive is only useful for Apache httpd proxy servers within
intranets. The NoProxy directive specifies a
list of subnets, IP addresses, hosts and/or domains, separated by
spaces. A request to a host which matches one or more of these is
always served directly, without forwarding to the configured
ProxyRemote proxy server(s).
ProxyRemote "*" "http://firewall.example.com:81" NoProxy ".example.com" "192.168.112.0/21"
The host arguments to the NoProxy
directive are one of the following type list:
A Domain is a partially qualified DNS domain name, preceded by a period. It represents a list of hosts which logically belong to the same DNS domain or zone (i.e., the suffixes of the hostnames are all ending in Domain).
.com .example.org.
To distinguish Domains from Hostnames (both syntactically and semantically; a DNS domain can have a DNS A record, too!), Domains are always written with a leading period.
Domain name comparisons are done without regard to the case, and
Domains are always assumed to be anchored in the root of the
DNS tree; therefore, the two domains .ExAmple.com and
.example.com. (note the trailing period) are considered
equal. Since a domain comparison does not involve a DNS lookup, it is much
more efficient than subnet comparison.
A SubNet is a partially qualified internet address in numeric (dotted quad) form, optionally followed by a slash and the netmask, specified as the number of significant bits in the SubNet. It is used to represent a subnet of hosts which can be reached over a common network interface. In the absence of the explicit net mask it is assumed that omitted (or zero valued) trailing digits specify the mask. (In this case, the netmask can only be multiples of 8 bits wide.) Examples:
192.168 or 192.168.0.0255.255.0.0)192.168.112.0/21192.168.112.0/21 with a netmask of 21
valid bits (also used in the form 255.255.248.0)As a degenerate case, a SubNet with 32 valid bits is the equivalent to an IPAddr, while a SubNet with zero valid bits (e.g., 0.0.0.0/0) is the same as the constant _Default_, matching any IP address.
A IPAddr represents a fully qualified internet address in numeric (dotted quad) form. Usually, this address represents a host, but there need not necessarily be a DNS domain name connected with the address.
192.168.123.7
An IPAddr does not need to be resolved by the DNS system, so it can result in more effective apache performance.
A Hostname is a fully qualified DNS domain name which can be resolved to one or more IPAddrs via the DNS domain name service. It represents a logical host (in contrast to Domains, see above) and must be resolvable to at least one IPAddr (or often to a list of hosts with different IPAddrs).
prep.ai.example.edu
www.example.org
In many situations, it is more effective to specify an IPAddr in place of a Hostname since a DNS lookup can be avoided. Name resolution in Apache httpd can take a remarkable deal of time when the connection to the name server uses a slow PPP link.
Hostname comparisons are done without regard to the case,
and Hostnames are always assumed to be anchored in the root
of the DNS tree; therefore, the two hosts WWW.ExAmple.com
and www.example.com. (note the trailing period) are
considered equal.
| Description: | Container for directives applied to proxied resources |
|---|---|
| Syntax: | <Proxy wildcard-url> ...</Proxy> |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
Directives placed in <Proxy>
sections apply only to matching proxied content. Shell-style wildcards are
allowed.
For example, the following will allow only hosts in
yournetwork.example.com to access content via your proxy
server:
<Proxy "*"> Require host yournetwork.example.com </Proxy>
The following example will process all files in the foo
directory of example.com through the INCLUDES
filter when they are sent through the proxy server:
<Proxy "http://example.com/foo/*"> SetOutputFilter INCLUDES </Proxy>
A backend URL matches the configuration section if it begins with the
the wildcard-url string, even if the last path segment in the
directive only matches a prefix of the backend URL. For example,
<Proxy "http://example.com/foo"> matches all of
http://example.com/foo, http://example.com/foo/bar, and
http://example.com/foobar. The matching of the final URL differs
from the behavior of the <Location> section, which for purposes of this note
treats the final path component as if it ended in a slash.
For more control over the matching, see <ProxyMatch>.
| Description: | Forward 100-continue expectation to the origin server |
|---|---|
| Syntax: | Proxy100Continue Off|On |
| Default: | Proxy100Continue On |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | Available in version 2.4.40 and later |
This directive determines whether the proxy should forward 100-continue
Expect:ation to the origin server and thus let it decide when/if
the HTTP request body should be read, or when Off the proxy
should generate 100 Continue intermediate response by itself before
forwarding the request body.
This option is of use only for HTTP proxying, as handled by mod_proxy_http.
| Description: | Add proxy information in X-Forwarded-* headers |
|---|---|
| Syntax: | ProxyAddHeaders Off|On |
| Default: | ProxyAddHeaders On |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | Available in version 2.3.10 and later |
This directive determines whether or not proxy related information should be passed to the backend server through X-Forwarded-For, X-Forwarded-Host and X-Forwarded-Server HTTP headers.
This option is of use only for HTTP proxying, as handled by mod_proxy_http.
| Description: | Determines how to handle bad header lines in a response |
|---|---|
| Syntax: | ProxyBadHeader IsError|Ignore|StartBody |
| Default: | ProxyBadHeader IsError |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
The ProxyBadHeader directive determines the
behavior of mod_proxy if it receives syntactically invalid
response header lines (i.e. containing no colon) from the origin
server. The following arguments are possible:
IsErrorIgnoreStartBody| Description: | Words, hosts, or domains that are banned from being proxied |
|---|---|
| Syntax: | ProxyBlock *|word|host|domain
[word|host|domain] ... |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
The ProxyBlock directive specifies a list of
words, hosts and/or domains, separated by spaces. HTTP, HTTPS, and
FTP document requests to sites whose names contain matched words,
hosts or domains are blocked by the proxy server. The proxy
module will also attempt to determine IP addresses of list items which
may be hostnames during startup, and cache them for match test as
well. That may slow down the startup time of the server.
ProxyBlock "news.example.com" "auctions.example.com" "friends.example.com"
Note that example would also be sufficient to match any
of these sites.
Hosts would also be matched if referenced by IP address.
Note also that
ProxyBlock "*"
blocks connections to all sites.
| Description: | Default domain name for proxied requests |
|---|---|
| Syntax: | ProxyDomain Domain |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
This directive is only useful for Apache httpd proxy servers within
intranets. The ProxyDomain directive specifies
the default domain which the apache proxy server will belong to. If a
request to a host without a domain name is encountered, a redirection
response to the same host with the configured Domain appended
will be generated.
ProxyRemote "*" "http://firewall.example.com:81" NoProxy ".example.com" "192.168.112.0/21" ProxyDomain ".example.com"
| Description: | Override error pages for proxied content |
|---|---|
| Syntax: | ProxyErrorOverride Off|On [code ...] |
| Default: | ProxyErrorOverride Off |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | The list of status codes was added in 2.4.47 |
This directive is useful for reverse-proxy setups where you want to
have a common look and feel on the error pages seen by the end user.
This also allows for included files (via
mod_include's SSI) to get
the error code and act accordingly. (Default behavior would display
the error page of the proxied server. Turning this on shows the SSI
Error message.)
This directive does not affect the processing of informational (1xx), normal success (2xx), or redirect (3xx) responses.
By default ProxyErrorOverride affects all responses with codes between 400 (including)
and 600 (excluding).
ProxyErrorOverride On
To change the default behavior, you can specify the status codes to consider, separated by spaces. If you do so, all other status codes will be ignored. You can only specify status codes, that are considered error codes: between 400 (including) and 600 (excluding).
ProxyErrorOverride On 403 405 500 501 502 503 504
| Description: | Determine size of internal data throughput buffer |
|---|---|
| Syntax: | ProxyIOBufferSize bytes |
| Default: | ProxyIOBufferSize 8192 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
The ProxyIOBufferSize directive adjusts the size
of the internal buffer which is used as a scratchpad for the data between
input and output. The size must be at least 512.
In almost every case, there's no reason to change that value.
If used with AJP, this directive sets the maximum AJP packet size in
bytes. Values larger than 65536 are set to 65536. If you change it from
the default, you must also change the packetSize attribute of
your AJP connector on the Tomcat side! The attribute
packetSize is only available in Tomcat 5.5.20+
and 6.0.2+
Normally it is not necessary to change the maximum packet size. Problems with the default value have been reported when sending certificates or certificate chains.
| Description: | Container for directives applied to regular-expression-matched proxied resources |
|---|---|
| Syntax: | <ProxyMatch regex> ...</ProxyMatch> |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
The <ProxyMatch> directive is
identical to the <Proxy> directive, except that it matches URLs
using regular expressions.
From 2.4.8 onwards, named groups and backreferences are captured and
written to the environment with the corresponding name prefixed with
"MATCH_" and in upper case. This allows elements of URLs to be referenced
from within expressions and modules like
mod_rewrite. In order to prevent confusion, numbered
(unnamed) backreferences are ignored. Use named groups instead.
<ProxyMatch "^http://(?<sitename>[^/]+)">
Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</ProxyMatch>
| Description: | Maximum number of proxies that a request can be forwarded through |
|---|---|
| Syntax: | ProxyMaxForwards number |
| Default: | ProxyMaxForwards -1 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | Default behaviour changed in 2.2.7 |
The ProxyMaxForwards directive specifies the
maximum number of proxies through which a request may pass if there's no
Max-Forwards header supplied with the request. This may
be set to prevent infinite proxy loops or a DoS attack.
ProxyMaxForwards 15
Note that setting ProxyMaxForwards is a
violation of the HTTP/1.1 protocol (RFC2616), which forbids a Proxy
setting Max-Forwards if the Client didn't set it.
Earlier Apache httpd versions would always set it. A negative
ProxyMaxForwards value, including the
default -1, gives you protocol-compliant behavior but may
leave you open to loops.
| Description: | Maps remote servers into the local server URL-space |
|---|---|
| Syntax: | ProxyPass [path] !|url [key=value
[key=value ...]] [nocanon] [interpolate] [noquery] |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | Unix Domain Socket (UDS) support added in 2.4.7 |
This directive allows remote servers to be mapped into the space of the local server. The local server does not act as a proxy in the conventional sense but appears to be a mirror of the remote server. The local server is often called a reverse proxy or gateway. The path is the name of a local virtual path; url is a partial URL for the remote server and cannot include a query string.
ProxyRequests directive should
usually be set off when using
ProxyPass.In 2.4.7 and later, support for using a Unix Domain Socket is available by using a target
which prepends unix:/path/lis.sock|. For example, to proxy
HTTP and target the UDS at /home/www.socket, you would use
unix:/home/www.socket|http://localhost/whatever/.
unix:
URL is DefaultRuntimeDir aware.When used inside a <Location> section, the first argument is omitted and the local
directory is obtained from the <Location>. The same will occur inside a
<LocationMatch> section;
however, ProxyPass does not interpret the regexp as such, so it is necessary
to use ProxyPassMatch in this situation instead.
Suppose the local server has address http://example.com/;
then
<Location "/mirror/foo/">
ProxyPass "http://backend.example.com/"
</Location>
will cause a local request for
http://example.com/mirror/foo/bar to be internally converted
into a proxy request to http://backend.example.com/bar.
If you require a more flexible reverse-proxy configuration, see the
RewriteRule directive with the
[P] flag.
The following alternative syntax is possible; however, it can carry a performance penalty when present in very large numbers. The advantage of the below syntax is that it allows for dynamic control via the Balancer Manager interface:
ProxyPass "/mirror/foo/" "http://backend.example.com/"
If the first argument ends with a trailing /, the second argument should also end with a trailing /, and vice versa. Otherwise, the resulting requests to the backend may miss some needed slashes and do not deliver the expected results.
The ! directive is useful in situations where you don't want
to reverse-proxy a subdirectory, e.g.
<Location "/mirror/foo/">
ProxyPass "http://backend.example.com/"
</Location>
<Location "/mirror/foo/i">
ProxyPass "!"
</Location>
ProxyPass "/mirror/foo/i" "!" ProxyPass "/mirror/foo" "http://backend.example.com"
will proxy all requests to /mirror/foo to
backend.example.com except requests made to
/mirror/foo/i.
Mixing ProxyPass settings in different contexts does not work:
ProxyPass "/mirror/foo/i" "!"
<Location "/mirror/foo/">
ProxyPass "http://backend.example.com/"
</Location>
In this case, a request to /mirror/foo/i will get proxied,
because the ProxyPass directive in the Location block will be evaluated
first. The fact that ProxyPass supports both server and directory contexts
does not mean that their scope and position in the configuration file will
guarantee any ordering or override.
The configured ProxyPass
and ProxyPassMatch
rules are checked in the order of configuration. The first rule that
matches wins. So usually you should sort conflicting
ProxyPass rules starting with the
longest URLs first. Otherwise, later rules for longer URLS will be hidden
by any earlier rule which uses a leading substring of the URL. Note that
there is some relation with worker sharing.
Only one ProxyPass directive
can be placed in a Location block,
and the most specific location will take precedence.
Exclusions must come before the
general ProxyPass directives. In 2.4.26 and later, the "no-proxy"
environment variable is an alternative to exclusions, and is the only
way to configure an exclusion of a ProxyPass
directive in Location context.
This variable should be set with SetEnvIf, as SetEnv
is not evaluated early enough.
ProxyPass key=value Parameters
In Apache HTTP Server 2.1 and later, mod_proxy supports pooled
connections to a backend server. Connections created on demand
can be retained in a pool for future use. Limits on the pool size
and other settings can be coded on
the ProxyPass directive
using key=value parameters, described in the tables
below.
By default, mod_proxy will allow and retain the maximum number of
connections that could be used simultaneously by that web server child
process. Use the max parameter to reduce the number from
the default. The pool of connections is maintained per web server child
process, and max and other settings are not coordinated
among all child processes, except when only one child process is allowed
by configuration or MPM design.
Use the ttl parameter to set an optional
time to live; connections which have been unused for at least
ttl seconds will be closed. ttl can be used
to avoid using a connection which is subject to closing because of the
backend server's keep-alive timeout.
ProxyPass "/example" "http://backend.example.com" max=20 ttl=120 retry=300
| Worker|BalancerMember parameters |
|---|
| Parameter | Default | Description | |||||||
|---|---|---|---|---|---|---|---|---|---|
| min | 0 | Minimum number of connection pool entries, unrelated to the actual number of connections. This only needs to be modified from the default for special circumstances where heap memory associated with the backend connections should be preallocated or retained. | |||||||
| max | 1...n | Maximum number of connections that will be allowed to the
backend server. The default for this limit is the number of threads
per process in the active MPM. In the Prefork MPM, this is always 1,
while with other MPMs, it is controlled by the
ThreadsPerChild directive. | |||||||
| smax | max | Retained connection pool entries above this limit are freed
during certain operations if they have been unused for longer than
the time to live, controlled by the ttl parameter. If
the connection pool entry has an associated connection, it will be
closed. This only needs to be modified from the default for special
circumstances where connection pool entries and any associated
connections which have exceeded the time to live need to be freed or
closed more aggressively. | |||||||
| acquire | - | If set, this will be the maximum time to wait for a free
connection in the connection pool, in milliseconds. If there are no free
connections in the pool, the Apache httpd will return SERVER_BUSY
status to the client.
| |||||||
| connectiontimeout | timeout | Connect timeout in seconds. The number of seconds Apache httpd waits for the creation of a connection to the backend to complete. By adding a postfix of ms, the timeout can be also set in milliseconds. | |||||||
| disablereuse | Off | This parameter should be used when you want to force mod_proxy
to immediately close a connection to the backend after being used, and
thus, disable its persistent connection and pool for that backend.
This helps in various situations where a firewall between Apache
httpd and
the backend server (regardless of protocol) tends to silently
drop connections or when backends themselves may be under round-
robin DNS.
When connection reuse is enabled each backend domain is resolved
(with a DNS query) only once per child process and cached for all further
connections until the child is recycled. To disable connection reuse,
set this property value to On.
| |||||||
| enablereuse | On | This is the inverse of 'disablereuse' above, provided as a
convenience for scheme handlers that require opt-in for connection
reuse (such as mod_proxy_fcgi). 2.4.11 and later only.
| |||||||
| flushpackets | off | Determines whether the proxy module will auto-flush the output brigade after each "chunk" of data. 'off' means that it will flush only when needed; 'on' means after each chunk is sent; and 'auto' means poll/wait for a period of time and flush if no input has been received for 'flushwait' milliseconds. Currently, this is in effect only for mod_proxy_ajp and mod_proxy_fcgi. | |||||||
| flushwait | 10 | The time to wait for additional input, in milliseconds, before flushing the output brigade if 'flushpackets' is 'auto'. | |||||||
| iobuffersize | 8192 | Adjusts the size of the internal scratchpad IO buffer. This allows you
to override the ProxyIOBufferSize for a specific worker.
This must be at least 512 or set to 0 for the system default of 8192.
| |||||||
| responsefieldsize | 8192 | Adjust the size of the proxy response field buffer. The buffer size
should be at least the size of the largest expected header size from
a proxied response. Setting the value to 0 will use the system
default of 8192 bytes. Available in Apache HTTP Server 2.4.34 and later. | |||||||
| keepalive | Off | This parameter should be used when you have a firewall between your
Apache httpd and the backend server, which tends to drop inactive connections.
This flag will tell the Operating System to send The frequency of initial and subsequent TCP keepalive probes depends on global OS settings, and may be as high as 2 hours. To be useful, the frequency configured in the OS must be smaller than the threshold used by the firewall. | |||||||
| lbset | 0 | Sets the load balancer cluster set that the worker is a member of. The load balancer will try all members of a lower numbered lbset before trying higher numbered ones. | |||||||
| ping | 0 | Ping property tells the webserver to "test" the connection to
the backend before forwarding the request. For AJP, it causes
mod_proxy_ajp to send a CPING
request on the ajp13 connection (implemented on Tomcat 3.3.2+, 4.1.28+
and 5.0.13+). For HTTP, it causes mod_proxy_http
to send a 100-Continue to the backend (only valid for
HTTP/1.1 - for non HTTP/1.1 backends, this property has no
effect). In both cases, the parameter is the delay in seconds to wait
for the reply.
This feature has been added to avoid problems with hung and
busy backends.
This will increase the network traffic during the normal operation
which could be an issue, but it will lower the
traffic in case some of the cluster nodes are down or busy.
By adding a postfix of ms, the delay can be also set in
milliseconds.
| |||||||
| receivebuffersize | 0 | Adjusts the size of the explicit (TCP/IP) network buffer size for
proxied connections. This allows you to override the
ProxyReceiveBufferSize for a specific worker.
This must be at least 512 or set to 0 for the system default.
| |||||||
| redirect | - | Redirection Route of the worker. This value is usually set dynamically to enable safe removal of the node from the cluster. If set, all requests without session id will be redirected to the BalancerMember that has route parameter equal to this value. | |||||||
| retry | 60 | Connection pool worker retry timeout in seconds. If the connection pool worker to the backend server is in the error state, Apache httpd will not forward any requests to that server until the timeout expires. This enables to shut down the backend server for maintenance and bring it back online later. A value of 0 means always retry workers in an error state with no timeout. | |||||||
| route | - | Route of the worker when used inside load balancer. The route is a value appended to session id. | |||||||
| status | - | Single letter value defining the initial status of
this worker.
| |||||||
| timeout | ProxyTimeout |
Socket timeout in seconds. The number of seconds Apache httpd waits for data sent by / to the backend. | |||||||
| ttl | - | Time to live for inactive connections and associated connection pool entries, in seconds. Once reaching this limit, a connection will not be used again; it will be closed at some later time. | |||||||
| flusher | flush | Name of the provider used by | |||||||
| secret | - | Value of secret used by mod_proxy_ajp.
It must be identical to the secret configured on the server side of the
AJP connection.Available in Apache HTTP Server 2.4.42 and later. | |||||||
| upgrade | - | Protocol accepted by | |||||||
| mapping | - | Type of mapping between the path and the url.
This determines the normalization and/or (non-)decoding that
ProxyPass "/special%3Fsegment" "https://example.com/special%3Fsegment" mapping=encoded <Location "/special%3Fsegment"> Require ip 172.17.2.0/24 </Location>
ProxyPass "/some/path" "https://servlet.example.com/some/path" mapping=servlet <Location "/some/path"> Require valid-user </Location> NoteIt is recommended to use the same mapping on the Apache httpd side than the one
used on the backend side. For instance when configuring authorizations in
| |||||||
| addressttl | -1 | TTL in seconds for how long DNS resolutions of the backend address are cached. -1 means until restart of Apache httpd. |
If the Proxy directive scheme starts with the
balancer:// (eg: balancer://cluster,
any path information is ignored), then a virtual worker that does not really
communicate with the backend server will be created. Instead, it is responsible
for the management of several "real" workers. In that case, the special set of
parameters can be added to this virtual worker.
See mod_proxy_balancer for more information about how
the balancer works.
| Balancer parameters |
|---|
| Parameter | Default | Description |
|---|---|---|
| lbmethod | byrequests | Balancer load-balance method. Select the load-balancing scheduler
method to use. Either byrequests, to perform weighted
request counting; bytraffic, to perform weighted
traffic byte count balancing; or bybusyness, to perform
pending request balancing. The default is byrequests.
|
| maxattempts | One less than the number of workers, or 1 with a single worker. | Maximum number of failover attempts before giving up. |
| nofailover | Off | If set to On, the session will break if the worker is in
error state or disabled. Set this value to On if backend
servers do not support session replication.
|
| stickysession | - | Balancer sticky session name. The value is usually set to something
like JSESSIONID or PHPSESSIONID,
and it depends on the backend application server that support sessions.
If the backend application server uses different name for cookies
and url encoded id (like servlet containers) use | to separate them.
The first part is for the cookie the second for the path.Available in Apache HTTP Server 2.4.4 and later. |
| stickysessionsep | "." | Sets the separation symbol in the session cookie. Some backend application servers do not use the '.' as the symbol. For example, the Oracle Weblogic server uses '!'. The correct symbol can be set using this option. The setting of 'Off' signifies that no symbol is used. |
| scolonpathdelim | Off | If set to On, the semi-colon character ';' will be
used as an additional sticky session path delimiter/separator. This
is mainly used to emulate mod_jk's behavior when dealing with paths such
as JSESSIONID=6736bcf34;foo=aabfa
|
| timeout | 0 | Balancer timeout in seconds. If set, this will be the maximum time to wait for a free worker. The default is to not wait. |
| failonstatus | - | A single or comma-separated list of HTTP status codes. If set, this will force the worker into error state when the backend returns any status code in the list. Worker recovery behaves the same as other worker errors. |
| failontimeout | Off | If set, an IO read timeout after a request is sent to the backend will
force the worker into error state. Worker recovery behaves the same as other
worker errors. Available in Apache HTTP Server 2.4.5 and later. |
| nonce | <auto> | The protective nonce used in the balancer-manager application page.
The default is to use an automatically determined UUID-based
nonce, to provide for further protection for the page. If set,
then the nonce is set to that value. A setting of None
disables all nonce checking.
NoteIn addition to the nonce, the |
| growth | 0 | Number of additional BalancerMembers to allow to be added to this balancer in addition to those defined at configuration. |
| forcerecovery | On | Force the immediate recovery of all workers without considering the
retry parameter of the workers if all workers of a balancer are
in error state. There might be cases where an already overloaded backend
can get into deeper trouble if the recovery of all workers is enforced
without considering the retry parameter of each worker. In this case,
set to Off.Available in Apache HTTP Server 2.4.2 and later. |
A sample balancer setup:
ProxyPass "/special-area" "http://special.example.com" smax=5 max=10
ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofailover=On
<Proxy "balancer://mycluster">
BalancerMember "ajp://1.2.3.4:8009"
BalancerMember "ajp://1.2.3.5:8009" loadfactor=20
# Less powerful server, don't send as many requests there,
BalancerMember "ajp://1.2.3.6:8009" loadfactor=5
</Proxy>
Configuring hot spares can help ensure that a certain number of workers are always available for use per load balancer set:
ProxyPass "/" "balancer://sparecluster/"
<Proxy balancer://sparecluster>
BalancerMember ajp://1.2.3.4:8009
BalancerMember ajp://1.2.3.5:8009
# The servers below are hot spares. For each server above that is unusable
# (draining, stopped, unreachable, in error state, etc.), one of these spares
# will be used in its place. Two servers will always be available for a request
# unless one or more of the spares is also unusable.
BalancerMember ajp://1.2.3.6:8009 status=+R
BalancerMember ajp://1.2.3.7:8009 status=+R
</Proxy>
Setting up a hot-standby that will only be used if no other members (or spares) are available in the load balancer set:
ProxyPass "/" "balancer://hotcluster/"
<Proxy "balancer://hotcluster">
BalancerMember "ajp://1.2.3.4:8009" loadfactor=1
BalancerMember "ajp://1.2.3.5:8009" loadfactor=2.25
# The server below is on hot standby
BalancerMember "ajp://1.2.3.6:8009" status=+H
ProxySet lbmethod=bytraffic
</Proxy>
Additional ProxyPass Keywords
Normally, mod_proxy will canonicalise ProxyPassed URLs. But this may be incompatible with some backends, particularly those that make use of PATH_INFO. The optional nocanon keyword suppresses this and passes the URL path "raw" to the backend. Note that this keyword may affect the security of your backend, as it removes the normal limited protection against URL-based attacks provided by the proxy.
Normally, mod_proxy will include the query string when generating the SCRIPT_FILENAME environment variable. The optional noquery keyword (available in httpd 2.4.1 and later) prevents this.
The optional interpolate keyword, in combination with
ProxyPassInterpolateEnv, causes the ProxyPass
to interpolate environment variables, using the syntax
${VARNAME}. Note that many of the standard CGI-derived
environment variables will not exist when this interpolation happens,
so you may still have to resort to mod_rewrite
for complex rules. Also note that interpolation is supported
within the scheme/hostname/port portion of a URL only for variables that
are available when the directive is parsed
(like Define). Dynamic determination of
those fields can be accomplished with mod_rewrite.
The following example describes how to use mod_rewrite
to dynamically set the scheme to http or https:
RewriteEngine On
RewriteCond "%{HTTPS}" =off
RewriteRule "." "-" [E=protocol:http]
RewriteCond "%{HTTPS}" =on
RewriteRule "." "-" [E=protocol:https]
RewriteRule "^/mirror/foo/(.*)" "%{ENV:protocol}://backend.example.com/$1" [P]
ProxyPassReverse "/mirror/foo/" "http://backend.example.com/"
ProxyPassReverse "/mirror/foo/" "https://backend.example.com/"
Since Apache HTTP Server 2.4.47, protocol Upgrade (tunneling) can be handled
end-to-end by mod_proxy_http using the ProxyPass
parameter upgrade.
End-to-end means that the HTTP Upgrade request from the client/browser is first
forwarded by mod_proxy_http to the origin server and the connection
will be upgraded (and tunneled by mod_proxy_http) only if the origin
server accepts/initiates the upgrade (HTTP response 101 Switching Protocols).
If the origin server responds with anything else mod_proxy_http
will continue forwarding (and enforcing) the HTTP protocol as usual for this
connection.
See Websocket Upgrade (2.4.47 and later) for an example of
configuration using mod_proxy_http.
For Apache HTTP Server 2.4.46 and earlier (or if
ProxyWebsocketFallbackToProxyHttp
from 2.4.48 and later disables mod_proxy_http handling), see the
documentation of mod_proxy_wstunnel for how to proxy the WebSocket
protocol.
| Description: | Inherit ProxyPass directives defined from the main server |
|---|---|
| Syntax: | ProxyPassInherit On|Off |
| Default: | ProxyPassInherit On |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | ProxyPassInherit is only available in Apache HTTP Server 2.4.5 and later. |
This directive will cause the current server/vhost to "inherit"
ProxyPass
directives defined in the main server. This can cause issues and
inconsistent behavior if using the Balancer Manager for dynamic changes
and so should be disabled if using that feature.
The setting in the global server defines the default for all vhosts.
Disabling ProxyPassInherit also disables BalancerInherit.
| Description: | Enable Environment Variable interpolation in Reverse Proxy configurations |
|---|---|
| Syntax: | ProxyPassInterpolateEnv On|Off |
| Default: | ProxyPassInterpolateEnv Off |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | Available in httpd 2.2.9 and later |
This directive, together with the interpolate argument to
ProxyPass, ProxyPassReverse,
ProxyPassReverseCookieDomain, and
ProxyPassReverseCookiePath,
enables reverse proxies to be dynamically
configured using environment variables which may be set by
another module such as mod_rewrite.
It affects the ProxyPass,
ProxyPassReverse,
ProxyPassReverseCookieDomain, and
ProxyPassReverseCookiePath directives
and causes them to substitute the value of an environment
variable varname for the string ${varname}
in configuration directives if the interpolate option is set.
The scheme/hostname/port portion of ProxyPass may
contain variables, but only the ones available when the directive is parsed
(for example, using Define).
For all the other use cases, please consider using
mod_rewrite instead.
Keep this turned off unless you need it!
Adding variables to ProxyPass for example may lead to
the use of the default mod_proxy's workers configured (that don't allow any fine
tuning like connections reuse, etc..).
| Description: | Maps remote servers into the local server URL-space using regular expressions |
|---|---|
| Syntax: | ProxyPassMatch [regex] !|url [key=value
[key=value ...]] |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | Since 2.4.47 the key=value Parameters are honored when the url parameter contains backreference(s) (see note below). |
This directive is equivalent to ProxyPass
but makes use of regular expressions instead of simple prefix matching. The
supplied regular expression is matched against the url, and if it
matches, the server will substitute any parenthesized matches into the given
string and use it as a new url.
<Directory> context.Suppose the local server has address http://example.com/;
then
ProxyPassMatch "^/(.*\.gif)$" "http://backend.example.com/$1"
will cause a local request for
http://example.com/foo/bar.gif to be internally converted
into a proxy request to http://backend.example.com/foo/bar.gif.
The ! directive is useful in situations where you don't want
to reverse-proxy a subdirectory.
When used inside a <LocationMatch> section, the first argument is omitted and the
regexp is obtained from the <LocationMatch>.
If you require a more flexible reverse-proxy configuration, see the
RewriteRule directive with the
[P] flag.
When the URL parameter doesn't use any backreferences into the regular expression, the original URL will be appended to the URL parameter.
key=value Parameters versus url with backreference(s)Since Apache HTTP Server 2.4.47, the key=value Parameters
are no longer ignored in a ProxyPassMatch using
an url with backreference(s). However to keep the existing
behavior regarding reuse/keepalive of backend connections (which were
never reused before for these URLs), the parameter enablereuse
(or disablereuse) default to off (resp. on)
in this case. Setting enablereuse=on explicitely allows to
reuse connections unless some backreference(s) belong in
the authority part (hostname and/or port) of the url
(this condition is enforced since Apache HTTP Server 2.4.55, and produces
a warning at startup because these URLs are not reusable per se).
Take care when constructing the target URL of the rule, considering the security impact from allowing the client influence over the set of URLs to which your server will act as a proxy. Ensure that the scheme and hostname part of the URL is either fixed or does not allow the client undue influence.
| Description: | Adjusts the URL in HTTP response headers sent from a reverse proxied server |
|---|---|
| Syntax: | ProxyPassReverse [path] url
[interpolate] |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy |
This directive lets Apache httpd adjust the URL in the Location,
Content-Location and URI headers on HTTP
redirect responses. This is essential when Apache httpd is used as a
reverse proxy (or gateway) to avoid bypassing the reverse proxy
because of HTTP redirects on the backend servers which stay behind
the reverse proxy.
Only the HTTP response headers specifically mentioned above
will be rewritten. Apache httpd will not rewrite other response
headers, nor will it by default rewrite URL references inside HTML pages.
This means that if the proxied content contains absolute URL
references, they will bypass the proxy. To rewrite HTML content to
match the proxy, you must load and enable mod_proxy_html.
path is the name of a local virtual path; url is a
partial URL for the remote server.
These parameters are used the same way as for the
ProxyPass directive.
For example, suppose the local server has address
http://example.com/; then
ProxyPass "/mirror/foo/" "http://backend.example.com/" ProxyPassReverse "/mirror/foo/" "http://backend.example.com/" ProxyPassReverseCookieDomain "backend.example.com" "public.example.com" ProxyPassReverseCookiePath "/" "/mirror/foo/"
will not only cause a local request for the
http://example.com/mirror/foo/bar to be internally converted
into a proxy request to http://backend.example.com/bar
(the functionality which ProxyPass provides here).
It also takes care of redirects which the server backend.example.com
sends when redirecting http://backend.example.com/bar to
http://backend.example.com/quux . Apache httpd adjusts this to
http://example.com/mirror/foo/quux before forwarding the HTTP
redirect response to the client. Note that the hostname used for
constructing the URL is chosen in respect to the setting of the UseCanonicalName directive.
Note that this ProxyPassReverse directive can
also be used in conjunction with the proxy feature
(RewriteRule ... [P]) from mod_rewrite
because it doesn't depend on a corresponding ProxyPass directive.
The optional interpolate keyword, used together with
ProxyPassInterpolateEnv, enables interpolation
of environment variables specified using the format ${VARNAME}.
Note that interpolation is not supported within the scheme portion of a
URL.
When used inside a <Location> section, the first argument is omitted and the local
directory is obtained from the <Location>. The same occurs inside a <LocationMatch> section, but will probably not work as
intended, as ProxyPassReverse will interpret the regexp literally as a
path; if needed in this situation, specify the ProxyPassReverse outside
the section or in a separate <Location> section.
This directive is not supported in <Directory> or <Files> sections.
| Description: | Adjusts the Domain string in Set-Cookie headers from a reverse- proxied server |
|---|---|
| Syntax: | ProxyPassReverseCookieDomain internal-domain
public-domain [interpolate] |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy |
Usage is basically similar to
ProxyPassReverse, but instead of
rewriting headers that are a URL, this rewrites the domain
string in Set-Cookie headers.
| Description: | Adjusts the Path string in Set-Cookie headers from a reverse- proxied server |
|---|---|
| Syntax: | ProxyPassReverseCookiePath internal-path
public-path [interpolate] |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy |
Useful in conjunction with
ProxyPassReverse
in situations where backend URL paths are mapped to public paths on the
reverse proxy. This directive rewrites the path string in
Set-Cookie headers. If the beginning of the cookie path matches
internal-path, the cookie path will be replaced with
public-path.
In the example given with
ProxyPassReverse, the directive:
ProxyPassReverseCookiePath "/" "/mirror/foo/"
will rewrite a cookie with backend path / (or
/example or, in fact, anything) to /mirror/foo/.
| Description: | Use incoming Host HTTP request header for proxy request |
|---|---|
| Syntax: | ProxyPreserveHost On|Off |
| Default: | ProxyPreserveHost Off |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | Usable in directory context in 2.3.3 and later. |
When enabled, this option will pass the Host: line from the incoming
request to the proxied host, instead of the hostname specified in the
ProxyPass line.
This option should normally be turned Off. It is mostly
useful in special configurations like proxied mass name-based virtual
hosting, where the original Host header needs to be evaluated by the
backend server.
| Description: | Network buffer size for proxied HTTP and FTP connections |
|---|---|
| Syntax: | ProxyReceiveBufferSize bytes |
| Default: | ProxyReceiveBufferSize 0 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
The ProxyReceiveBufferSize directive specifies an
explicit (TCP/IP) network buffer size for proxied HTTP and FTP connections,
for increased throughput. It has to be greater than 512 or set
to 0 to indicate that the system's default buffer size should
be used.
ProxyReceiveBufferSize 2048
| Description: | Remote proxy used to handle certain requests |
|---|---|
| Syntax: | ProxyRemote match remote-server [username:password] |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | The optional third argument is usable only in httpd 2.4.59 and later. |
This defines remote proxies to this proxy. match is either the
name of a URL-scheme that the remote server supports, or a partial URL
for which the remote server should be used, or * to indicate
the server should be contacted for all requests. remote-server is
a partial URL for the remote server. Syntax:
remote-server =
scheme://hostname[:port]
scheme is effectively the protocol that should be used to
communicate with the remote server; only http and https
are supported by this module. When using https, the requests
are forwarded through the remote proxy using the HTTP CONNECT method.
ProxyRemote "http://goodguys.example.com/" "http://mirrorguys.example.com:8000" ProxyRemote "*" "http://cleverproxy.localdomain" ProxyRemote "ftp" "http://ftpproxy.mydomain:8080"
In the last example, the proxy will forward FTP requests, encapsulated as yet another HTTP proxy request, to another proxy which can handle them.
This option also supports reverse proxy configuration; a backend webserver can be embedded within a virtualhost URL space even if that server is hidden by another forward proxy.
An optional third argument username:password may be given, which defines the Basic authentication credentials to pass to the configured remote proxy. The credentials will always be sent without first waiting for the remote proxy to send a Basic authentication challenge. The Proxy-Chain-Auth environment variable has no effect if this argument is used.
| Description: | Remote proxy used to handle requests matched by regular expressions |
|---|---|
| Syntax: | ProxyRemoteMatch regex remote-server [username:password] |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | The optional third argument is usable only in httpd 2.4.59 and later. |
The ProxyRemoteMatch is identical to the
ProxyRemote directive, except that
the first argument is a regular expression
match against the requested URL.
| Description: | Enables forward (standard) proxy requests |
|---|---|
| Syntax: | ProxyRequests On|Off |
| Default: | ProxyRequests Off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
This allows or prevents Apache httpd from functioning as a forward proxy
server. (Setting ProxyRequests to Off does not disable use of
the ProxyPass directive.)
In a typical reverse proxy or gateway configuration, this
option should be set to
Off.
In order to get the functionality of proxying HTTP or FTP sites, you
need also mod_proxy_http or mod_proxy_ftp
(or both) present in the server.
In order to get the functionality of (forward) proxying HTTPS sites, you
need mod_proxy_connect enabled in the server.
Do not enable proxying with ProxyRequests until you have secured your server. Open proxy servers are dangerous
both to your network and to the Internet at large.
| Description: | Set various Proxy balancer or member parameters |
|---|---|
| Syntax: | ProxySet url key=value [key=value ...] |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | ProxySet is only available in Apache HTTP Server 2.2 and later. |
This directive is used as an alternate method of setting any of the
parameters available to Proxy balancers and workers normally done via the
ProxyPass directive. If used
within a <Proxy balancer url|worker url>
container directive, the url argument is not required. As a side
effect the respective balancer or worker gets created. This can be useful
when doing reverse proxying via a
RewriteRule instead of a
ProxyPass directive.
<Proxy "balancer://hotcluster">
BalancerMember "http://www2.example.com:8080" loadfactor=1
BalancerMember "http://www3.example.com:8080" loadfactor=2
ProxySet lbmethod=bytraffic
</Proxy>
<Proxy "http://backend">
ProxySet keepalive=On
</Proxy>
ProxySet "balancer://foo" lbmethod=bytraffic timeout=15
ProxySet "ajp://backend:7001" timeout=15
Keep in mind that the same parameter key can have a different meaning depending whether it is applied to a balancer or a worker, as shown by the two examples above regarding timeout.
| Description: | Set local IP address for outgoing proxy connections |
|---|---|
| Syntax: | ProxySourceAddress address |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | Available in version 2.3.9 and later |
This directive allows to set a specific local address to bind to when connecting to a backend server.
| Description: | Show Proxy LoadBalancer status in mod_status |
|---|---|
| Syntax: | ProxyStatus Off|On|Full |
| Default: | ProxyStatus Off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
| Compatibility: | Available in version 2.2 and later |
This directive determines whether or not proxy
loadbalancer status data is displayed via the mod_status
server-status page.
Full is synonymous with On
| Description: | Network timeout for proxied requests |
|---|---|
| Syntax: | ProxyTimeout seconds |
| Default: | Value of |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
This directive allows a user to specify a timeout on proxy requests. This is useful when you have a slow/buggy appserver which hangs, and you would rather just return a timeout and fail gracefully instead of waiting however long it takes the server to return.
| Description: | Information provided in the Via HTTP response
header for proxied requests |
|---|---|
| Syntax: | ProxyVia On|Off|Full|Block |
| Default: | ProxyVia Off |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy |
This directive controls the use of the Via: HTTP
header by the proxy. Its intended use is to control the flow of
proxy requests along a chain of proxy servers. See RFC 2616 (HTTP/1.1), section
14.45 for an explanation of Via: header lines.
Off, which is the default, no special processing
is performed. If a request or reply contains a Via: header,
it is passed through unchanged.On, each request and reply will get a
Via: header line added for the current host.Full, each generated Via: header
line will additionally have the Apache httpd server version shown as a
Via: comment field.Block, every proxy request will have all its
Via: header lines removed. No new Via: header will
be generated.Apache HTTP Server Version 2.4
| Description: | mod_proxy extension for
CONNECT request handling |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_connect_module |
| Source File: | mod_proxy_connect.c |
This module requires the service of mod_proxy. It provides support for the CONNECT
HTTP method. This method is mainly used to tunnel SSL requests
through proxy servers.
Thus, in order to get the ability of handling CONNECT
requests, mod_proxy and
mod_proxy_connect have to be present in the server.
CONNECT is also used when the server needs to send an HTTPS request
through a forward proxy. In this case the server acts as a CONNECT client.
This functionality is part of mod_proxy and
mod_proxy_connect is not needed in this case.
Do not enable proxying until you have secured your server. Open proxy servers are dangerous both to your network and to the Internet at large.
mod_proxy_connect creates the following request notes for
logging using the %{VARNAME}n format in
LogFormat or
ErrorLogFormat:
| Description: | Ports that are allowed to CONNECT through the
proxy |
|---|---|
| Syntax: | AllowCONNECT port[-port]
[port[-port]] ... |
| Default: | AllowCONNECT 443 563 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_proxy_connect |
| Compatibility: | Moved from mod_proxy in Apache 2.3.5.
Port ranges available since Apache 2.3.7. |
The AllowCONNECT directive specifies a list
of port numbers or ranges to which the proxy CONNECT method
may connect. Today's browsers use this method when a https
connection is requested and proxy tunneling over HTTP is in effect.
By default, only the default https port (443) and the
default snews port (563) are enabled. Use the
AllowCONNECT directive to override this default and
allow connections to the listed ports only.
Apache HTTP Server Version 2.4
| Description: | fdpass external process support module for
mod_proxy |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_fdpass_module |
| Source File: | mod_proxy_fdpass.c |
| Compatibility: | Available for unix in version 2.3 and later |
This module requires the service of mod_proxy. It provides support for the passing the socket of the
client to another process.
mod_proxy_fdpass uses the ability of AF_UNIX domain
sockets to pass an
open file descriptor to allow another process to finish handling a request.
The module has a proxy_fdpass_flusher provider interface,
which allows another module to optionally send the response headers, or even
the start of the response body. The default flush provider
disables keep-alive, and sends the response headers, letting the external
process just send a response body.
In order to use another provider, you have to set the flusher
parameter in the ProxyPass directive.
At this time the only data passed to the external process is the client
socket. To receive a client socket, call recvfrom with an allocated
struct cmsghdr. Future versions of this module may include
more data after the client socket, but this is not implemented at this time.
This module provides no directives.
Apache HTTP Server Version 2.4
| Description: | Rewrite HTML links in to ensure they are addressable from Clients' networks in a proxy context. |
|---|---|
| Status: | Base |
| Module Identifier: | proxy_html_module |
| Source File: | mod_proxy_html.c |
| Compatibility: | Version 2.4 and later. Available as a third-party module for earlier 2.x versions |
This module provides an output filter to rewrite HTML links in a
proxy situation, to ensure that links work for users outside the proxy.
It serves the same purpose as Apache's ProxyPassReverse directive does
for HTTP headers, and is an essential component of a reverse proxy.
For example, if a company has an application server at
appserver.example.com that is only visible from within
the company's internal network, and a public webserver
www.example.com, they may wish to provide a gateway to the
application server at http://www.example.com/appserver/.
When the application server links to itself, those links need to be
rewritten to work through the gateway. mod_proxy_html serves to rewrite
<a href="http://appserver.example.com/foo/bar.html">foobar</a> to
<a href="http://www.example.com/appserver/foo/bar.html">foobar</a>
making it accessible from outside.
mod_proxy_html was originally developed at WebÞing, whose extensive documentation may be useful to users.
ProxyHTMLBufSize ProxyHTMLCharsetOut ProxyHTMLDocType ProxyHTMLEnable ProxyHTMLEvents ProxyHTMLExtended ProxyHTMLFixups ProxyHTMLInterp ProxyHTMLLinks ProxyHTMLMeta ProxyHTMLStripComments ProxyHTMLURLMap| Description: | Sets the buffer size increment for buffering inline scripts and stylesheets. |
|---|---|
| Syntax: | ProxyHTMLBufSize bytes |
| Default: | ProxyHTMLBufSize 8192 |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party for earlier 2.x versions |
In order to parse non-HTML content (stylesheets and scripts) embedded
in HTML documents, mod_proxy_html
has to read the entire script or stylesheet into a buffer. This buffer will
be expanded as necessary to hold the largest script or stylesheet in a page,
in increments of bytes as set by this directive.
The default is 8192, and will work well for almost all pages. However, if you know you're proxying pages containing stylesheets and/or scripts bigger than 8K (that is, for a single script or stylesheet, NOT in total), it will be more efficient to set a larger buffer size and avoid the need to resize the buffer dynamically during a request.
| Description: | Specify a charset for mod_proxy_html output. |
|---|---|
| Syntax: | ProxyHTMLCharsetOut Charset | * |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party for earlier 2.x versions |
This selects an encoding for mod_proxy_html output. It should not
normally be used, as any change from the default UTF-8
(Unicode - as used internally by libxml2) will impose an additional
processing overhead. The special token ProxyHTMLCharsetOut *
will generate output using the same encoding as the input.
Note that this relies on mod_xml2enc being loaded.
| Description: | Sets an HTML or XHTML document type declaration. |
|---|---|
| Syntax: | ProxyHTMLDocType HTML|XHTML [Legacy] |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party for earlier 2.x versions |
In the first form, documents will be declared as HTML 4.01 or XHTML 1.0
according to the option selected. This option also determines whether
HTML or XHTML syntax is used for output. Note that the format of the
documents coming from the backend server is immaterial: the parser will
deal with it automatically. If the optional second argument is set to
Legacy, documents will be declared "Transitional", an option that may
be necessary if you are proxying pre-1998 content or working with defective
authoring/publishing tools.
In the second form, it will insert your own FPI. The optional second argument determines whether SGML/HTML or XML/XHTML syntax will be used.
The default is changed to omitting any FPI, on the grounds that no FPI is better than a bogus one. If your backend generates decent HTML or XHTML, set it accordingly.
If the first form is used, mod_proxy_html
will also clean up the HTML to the specified standard. It cannot
fix every error, but it will strip out bogus elements and attributes.
It will also optionally log other errors at LogLevel Debug.
| Description: | Turns the proxy_html filter on or off. |
|---|---|
| Syntax: | ProxyHTMLEnable On|Off |
| Default: | ProxyHTMLEnable Off |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party module for earlier 2.x versions. |
A simple switch to enable or disable the proxy_html filter.
If mod_xml2enc is loaded it will also automatically
set up internationalisation support.
Note that the proxy_html filter will only act on HTML data (Content-Type text/html or application/xhtml+xml) and when the data are proxied. You can override this (at your own risk) by setting the PROXY_HTML_FORCE environment variable.
| Description: | Specify attributes to treat as scripting events. |
|---|---|
| Syntax: | ProxyHTMLEvents attribute [attribute ...] |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party for earlier 2.x versions |
Specifies one or more attributes to treat as scripting events and
apply ProxyHTMLURLMaps to where enabled.
You can specify any number of attributes in one or more
ProxyHTMLEvents directives.
Normally you'll set this globally. If you set ProxyHTMLEvents in more than
one scope so that one overrides the other, you'll need to specify a complete
set in each of those scopes.
A default configuration is supplied in proxy-html.conf and defines the events in standard HTML 4 and XHTML 1.
| Description: | Determines whether to fix links in inline scripts, stylesheets, and scripting events. |
|---|---|
| Syntax: | ProxyHTMLExtended On|Off |
| Default: | ProxyHTMLExtended Off |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party for earlier 2.x versions |
Set to Off, HTML links are rewritten according to the
ProxyHTMLURLMap directives, but links appearing
in Javascript and CSS are ignored.
Set to On, all scripting events (as determined by
ProxyHTMLEvents) and embedded scripts or
stylesheets are also processed by the ProxyHTMLURLMap
rules, according to the flags set for each rule. Since this requires more
parsing, performance will be best if you only enable it when strictly necessary.
You'll also need to take care over patterns matched, since the parser has no
knowledge of what is a URL within an embedded script or stylesheet.
In particular, extended matching of / is likely to lead to
false matches.
| Description: | Fixes for simple HTML errors. |
|---|---|
| Syntax: | ProxyHTMLFixups [lowercase] [dospath] [reset] |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party for earlier 2.x versions |
This directive takes one to three arguments as follows:
lowercase Urls are rewritten to lowercasedospath Backslashes in URLs are rewritten to forward slashes.reset Unset any options set at a higher level in the configuration.Take care when using these. The fixes will correct certain authoring mistakes, but risk also erroneously fixing links that were correct to start with. Only use them if you know you have a broken backend server.
| Description: | Enables per-request interpolation of
ProxyHTMLURLMap rules. |
|---|---|
| Syntax: | ProxyHTMLInterp On|Off |
| Default: | ProxyHTMLInterp Off |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party module for earlier 2.x versions |
This enables per-request interpolation in
ProxyHTMLURLMap to- and from- patterns.
If interpolation is not enabled, all rules are pre-compiled at startup. With interpolation, they must be re-compiled for every request, which implies an extra processing overhead. It should therefore be enabled only when necessary.
| Description: | Specify HTML elements that have URL attributes to be rewritten. |
|---|---|
| Syntax: | ProxyHTMLLinks element attribute [attribute2 ...] |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party for earlier 2.x versions |
Specifies elements that have URL attributes that should be rewritten
using standard ProxyHTMLURLMaps.
You will need one ProxyHTMLLinks directive per element,
but it can have any number of attributes.
Normally you'll set this globally. If you set ProxyHTMLLinks in more than
one scope so that one overrides the other, you'll need to specify a complete
set in each of those scopes.
A default configuration is supplied in proxy-html.conf and defines the HTML links for standard HTML 4 and XHTML 1.
ProxyHTMLLinks a href ProxyHTMLLinks area href ProxyHTMLLinks link href ProxyHTMLLinks img src longdesc usemap ProxyHTMLLinks object classid codebase data usemap ProxyHTMLLinks q cite ProxyHTMLLinks blockquote cite ProxyHTMLLinks ins cite ProxyHTMLLinks del cite ProxyHTMLLinks form action ProxyHTMLLinks input src usemap ProxyHTMLLinks head profile ProxyHTMLLinks base href ProxyHTMLLinks script src for
| Description: | Turns on or off extra pre-parsing of metadata in HTML
<head> sections. |
|---|---|
| Syntax: | ProxyHTMLMeta On|Off |
| Default: | ProxyHTMLMeta Off |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party module for earlier 2.x versions. |
This turns on or off pre-parsing of metadata in HTML
<head> sections.
If not required, turning ProxyHTMLMeta Off will give a small performance boost by skipping this parse step. However, it is sometimes necessary for internationalisation to work correctly.
ProxyHTMLMeta has two effects. Firstly and most importantly
it enables detection of character encodings declared in the form
<meta http-equiv="Content-Type" content="text/html;charset=foo">
or, in the case of an XHTML document, an XML declaration.
It is NOT required if the charset is declared in a real HTTP header
(which is always preferable) from the backend server, nor if the
document is utf-8 (unicode) or a subset such as ASCII.
You may also be able to dispense with it where documents use a
default declared using xml2EncDefault, but that risks propagating an
incorrect declaration. A ProxyHTMLCharsetOut
can remove that risk, but is likely to be a bigger processing
overhead than enabling ProxyHTMLMeta.
The other effect of enabling ProxyHTMLMeta is to parse all
<meta http-equiv=...> declarations and convert
them to real HTTP headers, in keeping with the original purpose
of this form of the HTML <meta> element.
http-equiv elements to HTTP headers, it is important that you
only enable it in cases where you trust the HTML content as much as you
trust the upstream server. If the HTML is controlled by bad actors, it
will be possible for them to inject arbitrary, possibly malicious, HTTP
headers into your server's responses.
| Description: | Determines whether to strip HTML comments. |
|---|---|
| Syntax: | ProxyHTMLStripComments On|Off |
| Default: | ProxyHTMLStripComments Off |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party for earlier 2.x versions |
This directive will cause mod_proxy_html to strip HTML comments. Note that this will also kill off any scripts or styles embedded in comments (a bogosity introduced in 1995/6 with Netscape 2 for the benefit of then-older browsers, but still in use today). It may also interfere with comment-based processors such as SSI or ESI: be sure to run any of those before mod_proxy_html in the filter chain if stripping comments!
| Description: | Defines a rule to rewrite HTML links |
|---|---|
| Syntax: | ProxyHTMLURLMap from-pattern to-pattern [flags] [cond] |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_proxy_html |
| Compatibility: | Version 2.4 and later; available as a third-party module for earlier 2.x versions. |
This is the key directive for rewriting HTML links. When parsing a document,
whenever a link target matches from-pattern, the matching
portion will be rewritten to to-pattern, as modified by any
flags supplied and by the
ProxyHTMLExtended directive.
Only the elements specified using
the ProxyHTMLLinks directive
will be considered as HTML links.
The optional third argument may define any of the following Flags. Flags are case-sensitive.
Ignore HTML links (pass through unchanged)
Ignore scripting events (pass through unchanged)
Pass embedded script and style sections through untouched.
Last-match. If this rule matches, no more rules are applied (note that this happens automatically for HTML links).
Opposite to L. Overrides the one-change-only default behaviour with HTML links.
Use Regular Expression matching-and-replace. from-pattern
is a regexp, and to-pattern a replacement string that may be
based on the regexp. Regexp memory is supported: you can use brackets ()
in the from-pattern and retrieve the matches with $1 to $9
in the to-pattern.
If R is not set, it will use string-literal search-and-replace. The logic is starts-with in HTML links, but contains in scripting events and embedded script and style sections.
Use POSIX extended Regular Expressions. Only applicable with R.
Case-insensitive matching. Only applicable with R.
Disable regexp memory (for speed). Only applicable with R.
Line-based regexp matching. Only applicable with R.
Match at start only. This applies only to string matching (not regexps) and is irrelevant to HTML links.
Match at end only. This applies only to string matching (not regexps) and is irrelevant to HTML links.
Interpolate environment variables in to-pattern.
A string of the form ${varname|default} will be replaced by the
value of environment variable varname. If that is unset, it
is replaced by default. The |default is optional.
NOTE: interpolation will only be enabled if
ProxyHTMLInterp is On.
Interpolate environment variables in from-pattern.
Patterns supported are as above.
NOTE: interpolation will only be enabled if
ProxyHTMLInterp is On.
The optional fourth cond argument defines a condition
that will be evaluated per Request, provided
ProxyHTMLInterp is On.
If the condition evaluates FALSE the map will not be applied in this request.
If TRUE, or if no condition is defined, the map is applied.
A cond is evaluated by the Expression Parser. In addition, the simpler syntax of conditions in mod_proxy_html 3.x for HTTPD 2.0 and 2.2 is also supported.
Apache HTTP Server Version 2.4
| Description: | SCGI gateway module for mod_proxy |
|---|---|
| Status: | Extension |
| Module Identifier: | proxy_scgi_module |
| Source File: | mod_proxy_scgi.c |
| Compatibility: | Available in version 2.2.14 and later |
This module requires the service of mod_proxy. It provides support for the
SCGI protocol, version
1.
Thus, in order to get the ability of handling the SCGI protocol,
mod_proxy and mod_proxy_scgi have to
be present in the server.
Do not enable proxying until you have secured your server. Open proxy servers are dangerous both to your network and to the Internet at large.
Remember, in order to make the following examples work, you have to
enable mod_proxy and mod_proxy_scgi.
ProxyPass "/scgi-bin/" "scgi://localhost:4000/"
The balanced gateway needs mod_proxy_balancer and
at least one load balancer algorithm module, such as
mod_lbmethod_byrequests, in addition to the proxy
modules listed above. mod_lbmethod_byrequests is the
default, and will be used for this example configuration.
ProxyPass "/scgi-bin/" "balancer://somecluster/"
<Proxy "balancer://somecluster">
BalancerMember "scgi://localhost:4000"
BalancerMember "scgi://localhost:4001"
</Proxy>
In addition to the configuration directives that control the
behaviour of mod_proxy, an environment
variable may also control the SCGI protocol
provider:
mod_proxy_scgi will neither create
nor export the PATH_INFO environment variable. This allows
the backend SCGI server to correctly determine SCRIPT_NAME
and Script-URI and be compliant with RFC 3875 section 3.3.
If instead you need mod_proxy_scgi to generate
a "best guess" for PATH_INFO, set this env-var. The
variable must be set before SetEnv
is effective. SetEnvIf can be
used instead: SetEnvIf Request_URI . proxy-scgi-pathinfo
| Description: | Enable or disable internal redirect responses from the backend |
|---|---|
| Syntax: | ProxySCGIInternalRedirect On|Off|Headername |
| Default: | ProxySCGIInternalRedirect On |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy_scgi |
| Compatibility: | The Headername feature is available in version 2.4.13 and later |
The ProxySCGIInternalRedirect enables the backend
to internally redirect the gateway to a different URL. This feature
originates in mod_cgi, which internally redirects the
response if the response status is OK (200) and
the response contains a Location (or configured alternate
header) and its value starts with a slash (/). This value is
interpreted as a new local URL that Apache httpd internally redirects to.
mod_proxy_scgi does the same as
mod_cgi in this regard, except that you can turn off the
feature or specify the use of a header other than Location.
ProxySCGIInternalRedirect Off
# Django and some other frameworks will fully qualify "local URLs"
# set by the application, so an alternate header must be used.
<Location /django-app/>
ProxySCGIInternalRedirect X-Location
</Location>
| Description: | Enable evaluation of X-Sendfile pseudo response header |
|---|---|
| Syntax: | ProxySCGISendfile On|Off|Headername |
| Default: | ProxySCGISendfile Off |
| Context: | server config, virtual host, directory |
| Status: | Extension |
| Module: | mod_proxy_scgi |
The ProxySCGISendfile directive enables the
SCGI backend to let files be served directly by the gateway. This is useful
for performance purposes — httpd can use sendfile or other
optimizations, which are not possible if the file comes over the backend
socket. Additionally, the file contents are not transmitted twice.
The ProxySCGISendfile argument determines the
gateway behaviour:
OffOnX-Sendfile and interprets the value as the filename to serve.
The header is removed from the final response headers. This is equivalent to
ProxySCGISendfile X-Sendfile.On, but instead of the hardcoded header name
X-Sendfile, the argument is used as the header name.# Use the default header (X-Sendfile) ProxySCGISendfile On # Use a different header ProxySCGISendfile X-Send-Static
Apache HTTP Server Version 2.4
| Description: | Bandwidth Rate Limiting for Clients |
|---|---|
| Status: | Extension |
| Module Identifier: | ratelimit_module |
| Source File: | mod_ratelimit.c |
| Compatibility: |
rate-initial-burst available in httpd 2.4.24 and later.
Rate limiting proxied content does not work correctly up to httpd 2.4.33.
|
Provides a filter named RATE_LIMIT to limit client bandwidth.
The throttling is applied to each HTTP response while it is transferred to the client,
and not aggregated at IP/client level.
The connection speed to be simulated is specified, in KiB/s, using the environment
variable rate-limit.
Optionally, an initial amount of burst data, in KiB, may be
configured to be passed at full speed before throttling to the
specified rate limit. This value is optional, and is set using
the environment variable rate-initial-burst.
<Location "/downloads">
SetOutputFilter RATE_LIMIT
SetEnv rate-limit 400
SetEnv rate-initial-burst 512
</Location>
rate-limit causes integer overflow, the rate-limited will be disabled.
If the value specified for rate-limit-burst causes integer overflow, the burst will be disabled.
This module provides no directives.
Apache HTTP Server Version 2.4
| Description: | Set timeout and minimum data rate for receiving requests |
|---|---|
| Status: | Extension |
| Module Identifier: | reqtimeout_module |
| Source File: | mod_reqtimeout.c |
| Compatibility: | Available in Apache HTTPD 2.2.15 and later |
This module provides a convenient way to set timeouts and minimum data rates for receiving requests. Should a timeout occur or a data rate be to low, the corresponding connection will be closed by the server.
This is logged at LogLevel
info.
If needed, the LogLevel directive
can be tweaked to explicitly log it:
LogLevel reqtimeout:info
RequestReadTimeout handshake=5 header=10 body=30
LimitRequestBody):
RequestReadTimeout body=10,MinRate=1000
RequestReadTimeout header=10-30,MinRate=500
RequestReadTimeout header=20-40,MinRate=500 body=20,MinRate=500
| Description: | Set timeout values for completing the TLS handshake, receiving the request headers and/or body from client. |
|---|---|
| Syntax: | RequestReadTimeout
[handshake=timeout[-maxtimeout][,MinRate=rate]
[header=timeout[-maxtimeout][,MinRate=rate]
[body=timeout[-maxtimeout][,MinRate=rate]
|
| Default: | RequestReadTimeout handshake=0 header=20-40,MinRate=500 body=20,MinRate=500 |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_reqtimeout |
| Compatibility: | Available in version 2.2.15 and later; defaulted to disabled in
version 2.3.14 and earlier. The handshake stage is available since
version 2.4.39.
|
This directive can set various timeouts for completing the TLS handshake,
receiving the request headers and/or the request body from the client.
If the client fails to complete each of these stages within the configured
time, a 408 REQUEST TIME OUT error is sent.
For SSL virtual hosts, the handshake timeout values is the time
needed to do the initial SSL handshake. If the user's browser is configured to
query certificate revocation lists and the CRL server is not reachable, the
initial SSL handshake may take a significant time until the browser gives up
waiting for the CRL. Therefore the handshake timeout should take
this possible overhead into consideration for SSL virtual hosts (if necessary).
The body timeout values include the time needed for SSL renegotiation
(if necessary).
When an AcceptFilter is in use
(usually the case on Linux and FreeBSD), the socket is not sent to the
server process before at least one byte (or the whole request for
httpready) is received. The handshake and header timeouts
configured with RequestReadTimeout are only effective
after the server process has received the socket.
For each of the three timeout stages (handshake, header or body), there are three ways to specify the timeout:
stage=timeout
The time in seconds allowed for completing the whole stage (handshaking, reading all of the request headers or body). A value of 0 means no limit.
handshake=0 header=0 body=0
This disables mod_reqtimeout completely (note that
handshake=0 is the default already and could be omitted).
stage=timeout,MinRate=data_rate
Same as above, but whenever data is received, the timeout value is increased according to the specified minimum data rate (in bytes per second).
stage=timeout-maxtimeout,MinRate=data_rate
Same as above, but the timeout will not be increased above the second value of the specified timeout range.
Apache HTTP Server Version 2.4
| Description: | Filter Input (request) and Output (response) content using sed syntax |
|---|---|
| Status: | Experimental |
| Module Identifier: | sed_module |
| Source File: | mod_sed.c sed0.c sed1.c regexp.c regexp.h sed.h |
| Compatibility: | Available in Apache 2.3 and later |
mod_sed is an in-process content filter. The mod_sed filter implements the sed editing
commands implemented by the Solaris 10 sed
program as described in the manual
page. However, unlike sed, mod_sed doesn't take data from
standard
input. Instead, the filter acts on the entity data sent between client and
server. mod_sed can be used as an input or output filter. mod_sed is a
content filter, which means that it cannot be used to modify client or
server http headers.
The mod_sed output filter accepts a chunk of data, executes the sed scripts on the data, and generates the output which is passed to the next filter in the chain.
The mod_sed input filter reads the data from the next filter in the chain, executes the sed scripts, and returns the generated data to the caller filter in the filter chain.
Both the input and output filters only process the data if newline characters are seen in the content. At the end of the data, the rest of the data is treated as the last line. Lines greater than 8MB in length result in an error, in 2.4.54 and later.
# In the following example, the sed filter will change the string
# "monday" to "MON" and the string "sunday" to SUN in html documents
# before sending to the client.
<Directory "/var/www/docs/sed">
AddOutputFilter Sed html
OutputSed "s/monday/MON/g"
OutputSed "s/sunday/SUN/g"
</Directory>
# In the following example, the sed filter will change the string
# "monday" to "MON" and the string "sunday" to SUN in the POST data
# sent to PHP.
<Directory "/var/www/docs/sed">
AddInputFilter Sed php
InputSed "s/monday/MON/g"
InputSed "s/sunday/SUN/g"
</Directory>
Complete details of the sed command can be found from the
sed manual
page.
bhHgGx| Description: | Sed command to filter request data (typically POST data) |
|---|---|
| Syntax: | InputSed sed-command |
| Context: | directory, .htaccess |
| Status: | Experimental |
| Module: | mod_sed |
The InputSed directive specifies the sed command
to execute on the request data e.g., POST data.
Apache HTTP Server Version 2.4
| Description: | Provides a rule-based rewriting engine to rewrite requested URLs on the fly |
|---|---|
| Status: | Extension |
| Module Identifier: | rewrite_module |
| Source File: | mod_rewrite.c |
The mod_rewrite module uses a rule-based rewriting
engine, based on a PCRE regular-expression parser, to rewrite requested URLs on
the fly. By default, mod_rewrite maps a URL to a filesystem
path. However, it can also be used to redirect one URL to another URL, or
to invoke an internal proxy fetch.
mod_rewrite provides a flexible and powerful way to
manipulate URLs using an unlimited number of rules. Each rule can have an
unlimited number of attached rule conditions, to allow you to rewrite URL
based on server variables, environment variables, HTTP headers, or time
stamps.
mod_rewrite operates on the full URL path, including the
path-info section. A rewrite rule can be invoked in
httpd.conf or in .htaccess. The path generated
by a rewrite rule can include a query string, or can lead to internal
sub-processing, external request redirection, or internal proxy
throughput.
Further details, discussion, and examples, are provided in the detailed mod_rewrite documentation.
mod_rewrite offers detailed logging of its actions
at the trace1 to trace8 log levels. The
log level can be set specifically for mod_rewrite
using the LogLevel directive: Up to
level debug, no actions are logged, while trace8
means that practically all actions are logged.
mod_rewrite
will slow down your Apache HTTP Server dramatically! Use a log
level higher than trace2 only for debugging!
LogLevel alert rewrite:trace3
Those familiar with earlier versions of
mod_rewrite will no doubt be looking for the
RewriteLog and RewriteLogLevel
directives. This functionality has been completely replaced by the
new per-module logging configuration mentioned above.
To get just the mod_rewrite-specific log
messages, pipe the log file through grep:
tail -f error_log|fgrep '[rewrite:'
| Description: | Sets the base URL for per-directory rewrites |
|---|---|
| Syntax: | RewriteBase URL-path |
| Default: | None |
| Context: | directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_rewrite |
The RewriteBase directive specifies the
URL prefix to be used for per-directory (htaccess)
RewriteRule directives that
substitute a relative path.
This directive is required when you use a relative path in a substitution in per-directory (htaccess) context unless any of the following conditions are true:
DocumentRoot
(as opposed to reachable by other means, such as
Alias).RewriteRule,
suffixed by the relative
substitution is also valid as a URL path on the server
(this is rare).Alias
or mod_userdir. In the example below, RewriteBase is necessary
to avoid rewriting to http://example.com/opt/myapp-1.2.3/welcome.html
since the resource was not relative to the document root. This
misconfiguration would normally cause the server to look for an "opt"
directory under the document root.
DocumentRoot "/var/www/example.com"
AliasMatch "^/myapp" "/opt/myapp-1.2.3"
<Directory "/opt/myapp-1.2.3">
RewriteEngine On
RewriteBase "/myapp/"
RewriteRule "^index\.html$" "welcome.html"
</Directory>
| Description: | Defines a condition under which rewriting will take place |
|---|---|
| Syntax: | RewriteCond
TestString CondPattern [flags] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_rewrite |
The RewriteCond directive defines a
rule condition. One or more RewriteCond
can precede a RewriteRule
directive. The following rule is then only used if both
the current state of the URI matches its pattern, and if these conditions are met.
TestString is a string which can contain the following expanded constructs in addition to plain text:
$N
(0 <= N <= 9). $1 to $9 provide access to the grouped
parts (in parentheses) of the pattern, from the
RewriteRule which is subject to the current
set of RewriteCond conditions. $0 provides
access to the whole string matched by that pattern.
%N
(0 <= N <= 9). %1 to %9 provide access to the grouped
parts (again, in parentheses) of the pattern, from the last matched
RewriteCond in the current set
of conditions. %0 provides access to the whole string matched by
that pattern.
${mapname:key|default}.
See the documentation for
RewriteMap for more details.
%{ NAME_OF_VARIABLE
}
where NAME_OF_VARIABLE can be a string taken
from the following list:
| HTTP headers: | connection & request: | |
|---|---|---|
|
HTTP_ACCEPT HTTP_COOKIE HTTP_FORWARDED HTTP_HOST HTTP_PROXY_CONNECTION HTTP_REFERER HTTP_USER_AGENT |
AUTH_TYPE CONN_REMOTE_ADDR CONTEXT_PREFIX CONTEXT_DOCUMENT_ROOT IPV6 PATH_INFO QUERY_STRING REMOTE_ADDR REMOTE_HOST REMOTE_IDENT REMOTE_PORT REMOTE_USER REQUEST_METHOD SCRIPT_FILENAME |
|
| server internals: | date and time: | specials: |
|
DOCUMENT_ROOT SCRIPT_GROUP SCRIPT_USER SERVER_ADDR SERVER_ADMIN SERVER_NAME SERVER_PORT SERVER_PROTOCOL SERVER_SOFTWARE |
TIME_YEAR TIME_MON TIME_DAY TIME_HOUR TIME_MIN TIME_SEC TIME_WDAY TIME |
API_VERSION CONN_REMOTE_ADDR HTTPS IS_SUBREQ REMOTE_ADDR REQUEST_FILENAME REQUEST_SCHEME REQUEST_URI THE_REQUEST |
These variables all
correspond to the similarly named HTTP
MIME-headers, C variables of the Apache HTTP Server or
struct tm fields of the Unix system.
Most are documented here
or elsewhere in the Manual or in the CGI specification.
SERVER_NAME and SERVER_PORT depend on the values of
UseCanonicalName and
UseCanonicalPhysicalPort
respectively.
Those that are special to mod_rewrite include those below.
API_VERSIONCONN_REMOTE_ADDRmod_remoteip module).HTTPSmod_ssl is loaded).IS_SUBREQREMOTE_ADDRmod_remoteip module).REQUEST_FILENAMEREQUEST_FILENAME is referenced. Otherwise,
such as when used in virtual host context, the same
value as REQUEST_URI. Depending on the value of
AcceptPathInfo, the
server may have only used some leading components of the
REQUEST_URI to map the request to a file.
REQUEST_SCHEMEServerName.REQUEST_URIQUERY_STRING. The value returned for
REQUEST_URI
has already been %-decoded, to re-encode it pass it through
the "escape" mapping-function.
THE_REQUESTGET
/index.html HTTP/1.1"). This does not
include any additional headers sent by the
browser. This value has not been unescaped
(decoded), unlike most other variables below.If the TestString has the special value expr,
the CondPattern will be treated as an
ap_expr. HTTP headers referenced in the
expression will be added to the Vary header if the novary
flag is not given.
Other things you should be aware of:
The variables SCRIPT_FILENAME and REQUEST_FILENAME
contain the same value - the value of the
filename field of the internal
request_rec structure of the Apache HTTP Server.
The first name is the commonly known CGI variable name
while the second is the appropriate counterpart of
REQUEST_URI (which contains the value of the
uri field of request_rec).
If a substitution occurred and the rewriting continues, the value of both variables will be updated accordingly.
If used in per-server context (i.e., before the
request is mapped to the filesystem) SCRIPT_FILENAME and
REQUEST_FILENAME cannot contain the full local filesystem
path since the path is unknown at this stage of processing.
Both variables will initially contain the value of REQUEST_URI
in that case. In order to obtain the full local filesystem
path of the request in per-server context, use an URL-based
look-ahead %{LA-U:REQUEST_FILENAME} to determine
the final value of REQUEST_FILENAME.
%{ENV:variable}, where variable can be
any environment variable, is also available.
This is looked-up via internal
Apache httpd structures and (if not found there) via
getenv() from the Apache httpd server process.%{SSL:variable}, where variable is the
name of an SSL environment
variable, can be used whether or not
mod_ssl is loaded, but will always expand to
the empty string if it is not. Example:
%{SSL:SSL_CIPHER_USEKEYSIZE} may expand to
128. These variables are available even without
setting the StdEnvVars option of the
SSLOptions directive.%{HTTP:header}, where header can be
any HTTP MIME-header name, can always be used to obtain the
value of a header sent in the HTTP request.
Example: %{HTTP:Proxy-Connection} is
the value of the HTTP header
``Proxy-Connection:''.
If a HTTP header is used in a condition this header is added to the Vary header of the response in case the condition evaluates to true for the request. It is not added if the condition evaluates to false for the request. Adding the HTTP header to the Vary header of the response is needed for proper caching.
It has to be kept in mind that conditions follow a short circuit
logic in the case of the 'ornext|OR' flag
so that certain conditions might not be evaluated at all.
%{LA-U:variable}
can be used for look-aheads which perform
an internal (URL-based) sub-request to determine the final
value of variable. This can be used to access
variable for rewriting which is not available at the current
stage, but will be set in a later phase.
For instance, to rewrite according to the
REMOTE_USER variable from within the
per-server context (httpd.conf file) you must
use %{LA-U:REMOTE_USER} - this
variable is set by the authorization phases, which come
after the URL translation phase (during which
mod_rewrite operates).
On the other hand, because mod_rewrite implements
its per-directory context (.htaccess file) via
the Fixup phase of the API and because the authorization
phases come before this phase, you just can use
%{REMOTE_USER} in that context.
%{LA-F:variable} can be used to perform an internal
(filename-based) sub-request, to determine the final value
of variable. Most of the time, this is the same as
LA-U above.CondPattern is the condition pattern, a regular expression which is applied to the current instance of the TestString. TestString is first evaluated, before being matched against CondPattern.
CondPattern is usually a perl compatible regular expression, but there is additional syntax available to perform other useful tests against the Teststring:
!' character (exclamation mark) to negate the result
of the condition, no matter what kind of CondPattern is used.
"" (two quotation marks) this
compares TestString to the empty string.RewriteCond %{HTTP_USER_AGENT} "=This Robot/1.0"
!-eq.Is existing URL, via subrequest.
Checks whether or not TestString is a valid URL,
accessible via all the server's currently-configured
access controls for that path. This uses an internal
subrequest to do the check, so use it with care -
it can impact your server's performance!
This flag only returns information about things like access control, authentication, and authorization. This flag does not return information about the status code the configured handler (static file, CGI, proxy, etc.) would have returned.
RewriteCond /var/www/%{REQUEST_URI} !-f
RewriteRule ^(.+) /other/archive/$1 [R]
If the TestString has the special value expr, the
CondPattern will be treated as an
ap_expr.
In the below example, -strmatch is used to
compare the REFERER against the site hostname,
to block unwanted hotlinking.
RewriteCond expr "! %{HTTP_REFERER} -strmatch '*://%{HTTP_HOST}/*'"
RewriteRule "^/images" "-" [F]
You can also set special flags for CondPattern by appending
[flags]
as the third argument to the RewriteCond
directive, where flags is a comma-separated list of any of the
following flags:
nocase|NC'
(no case)ornext|OR'
(or next condition)RewriteCond "%{REMOTE_HOST}" "^host1" [OR]
RewriteCond "%{REMOTE_HOST}" "^host2" [OR]
RewriteCond "%{REMOTE_HOST}" "^host3"
RewriteRule ...some special stuff for any of these hosts...
Without this flag you would have to write the condition/rule
pair three times.
novary|NV'
(no vary)Example:
To rewrite the Homepage of a site according to the
``User-Agent:'' header of the request, you can
use the following:
RewriteCond "%{HTTP_USER_AGENT}" "(iPhone|Blackberry|Android)"
RewriteRule "^/$" "/homepage.mobile.html" [L]
RewriteRule "^/$" "/homepage.std.html" [L]
Explanation: If you use a browser which identifies itself as a mobile browser (note that the example is incomplete, as there are many other mobile platforms), the mobile version of the homepage is served. Otherwise, the standard page is served.
By default, multiple RewriteConds
are evaluated in sequence with an implied logical AND.
If a condition fails, in the absence of an
OR flag, the entire ruleset is abandoned,
and further conditions are not evaluated.
| Description: | Enables or disables runtime rewriting engine |
|---|---|
| Syntax: | RewriteEngine on|off |
| Default: | RewriteEngine off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_rewrite |
The RewriteEngine directive enables or
disables the runtime rewriting engine. If it is set to
off this module does no runtime processing at
all. It does not even update the SCRIPT_URx
environment variables.
Use this directive to disable rules in a particular context,
rather than commenting out all the RewriteRule directives.
Note that rewrite configurations are not
inherited by virtual hosts. This means that you need to have a
RewriteEngine on directive for each virtual host
in which you wish to use rewrite rules.
RewriteMap directives
of the type prg
are not started during server initialization if they're defined in a
context that does not have RewriteEngine set to
on
| Description: | Defines a mapping function for key-lookup |
|---|---|
| Syntax: | RewriteMap MapName MapType:MapSource
[MapTypeOptions]
|
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_rewrite |
| Compatibility: | The 3rd parameter, MapTypeOptions, in only available from Apache 2.4.29 and later |
The RewriteMap directive defines a
Rewriting Map which can be used inside rule
substitution strings by the mapping-functions to
insert/substitute fields through a key lookup. The source of
this lookup can be of various types.
The MapName is the name of the map and will be used to specify a mapping-function for the substitution strings of a rewriting rule via one of the following constructs:
${ MapName :
LookupKey }
${ MapName :
LookupKey | DefaultValue
}
When such a construct occurs, the map MapName is consulted and the key LookupKey is looked-up. If the key is found, the map-function construct is substituted by SubstValue. If the key is not found then it is substituted by DefaultValue or by the empty string if no DefaultValue was specified. Empty values behave as if the key was absent, therefore it is not possible to distinguish between empty-valued keys and absent keys.
For example, you might define a
RewriteMap as:
RewriteMap examplemap "txt:/path/to/file/map.txt"
You would then be able to use this map in a
RewriteRule as follows:
RewriteRule "^/ex/(.*)" "${examplemap:$1}"
The meaning of the MapTypeOptions argument depends on particular MapType. See the Using RewriteMap for more information.
The following combinations for MapType and MapSource can be used:
httxt2dbm
utility. (Details ...)RewriteMap: toupper, tolower, escape or
unescape. (Details ...)Further details, and numerous examples, may be found in the RewriteMap HowTo
| Description: | Sets some special options for the rewrite engine |
|---|---|
| Syntax: | RewriteOptions Options |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_rewrite |
The RewriteOptions directive sets some
special options for the current per-server or per-directory
configuration. The Option string can currently
only be one of the following:
InheritThis forces the current configuration to inherit the
configuration of the parent. In per-virtual-server context,
this means that the maps, conditions and rules of the main
server are inherited. In per-directory context this means
that conditions and rules of the parent directory's
.htaccess configuration or
<Directory>
sections are inherited. The inherited rules are virtually copied
to the section where this directive is being used. If used in
combination with local rules, the inherited rules are copied behind
the local rules. The position of this directive - below or above
of local rules - has no influence on this behavior. If local
rules forced the rewriting to stop, the inherited rules won't
be processed.
InheritBefore Like Inherit above, but the rules from the parent scope
are applied before rules specified in the child scope.
Available in Apache HTTP Server 2.3.10 and later.
InheritDownIf this option is enabled, all child configurations will inherit
the configuration of the current configuration. It is equivalent to
specifying RewriteOptions Inherit in all child
configurations. See the Inherit option for more details
on how the parent-child relationships are handled.
Available in Apache HTTP Server 2.4.8 and later.
InheritDownBeforeLike InheritDown above, but the rules from the current
scope are applied before rules specified in any child's
scope.
Available in Apache HTTP Server 2.4.8 and later.
IgnoreInheritThis option forces the current and child configurations to ignore
all rules that would be inherited from a parent specifying
InheritDown or InheritDownBefore.
Available in Apache HTTP Server 2.4.8 and later.
AllowNoSlashBy default, mod_rewrite will ignore URLs that map to a
directory on disk but lack a trailing slash, in the expectation that
the mod_dir module will issue the client with a redirect to
the canonical URL with a trailing slash.
When the DirectorySlash directive
is set to off, the AllowNoSlash option can be enabled to ensure
that rewrite rules are no longer ignored. This option makes it possible to
apply rewrite rules within .htaccess files that match the directory without
a trailing slash, if so desired.
Available in Apache HTTP Server 2.4.0 and later.
AllowAnyURIWhen RewriteRule
is used in VirtualHost or server context with
version 2.2.22 or later of httpd, mod_rewrite
will only process the rewrite rules if the request URI is a URL-path. This avoids
some security issues where particular rules could allow
"surprising" pattern expansions (see CVE-2011-3368
and CVE-2011-4317).
To lift the restriction on matching a URL-path, the
AllowAnyURI option can be enabled, and
mod_rewrite will apply the rule set to any
request URI string, regardless of whether that string matches
the URL-path grammar required by the HTTP specification.
Available in Apache HTTP Server 2.4.3 and later.
Enabling this option will make the server vulnerable to
security issues if used with rewrite rules which are not
carefully authored. It is strongly recommended
that this option is not used. In particular, beware of input
strings containing the '@' character which could
change the interpretation of the transformed URI, as per the
above CVE names.
MergeBaseWith this option, the value of RewriteBase is copied from where it's explicitly defined
into any sub-directory or sub-location that doesn't define its own
RewriteBase. This was the
default behavior in 2.4.0 through 2.4.3, and the flag to restore it is
available Apache HTTP Server 2.4.4 and later.
IgnoreContextInfoWhen a relative substitution is made
in directory (htaccess) context and RewriteBase has not been set, this module uses some
extended URL and filesystem context information to change the
relative substitution back into a URL. Modules such as
mod_userdir and mod_alias
supply this extended context info. Available in 2.4.16 and later.
LegacyPrefixDocRootPrior to 2.4.26, if a substitution was an absolute URL that matched
the current virtual host, the URL might first be reduced to a URL-path
and then later reduced to a local path. Since the URL can be reduced
to a local path, the path should be prefixed with the document root.
This prevents a file such as /tmp/myfile from being accessed when a
request is made to http://host/file/myfile with the following
RewriteRule.
RewriteRule /file/(.*) http://localhost/tmp/$1
This option allows the old behavior to be used where the document root is not prefixed to a local path that was reduced from a URL. Available in 2.4.26 and later.
| Description: | Defines rules for the rewriting engine |
|---|---|
| Syntax: | RewriteRule
Pattern Substitution [flags] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_rewrite |
The RewriteRule directive is the real
rewriting workhorse. The directive can occur more than once,
with each instance defining a single rewrite rule. The
order in which these rules are defined is important - this is the order
in which they will be applied at run-time.
Pattern is
a perl compatible regular
expression. What this pattern is compared against varies depending
on where the RewriteRule directive is defined.
In VirtualHost context,
The Pattern will initially be matched against the part of the
URL after the hostname and port, and before the query string (e.g. "/app1/index.html").
This is the (%-decoded) URL-path.
In per-directory context (Directory and .htaccess),
the Pattern is matched against only a partial path, for example a request
of "/app1/index.html" may result in comparison against "app1/index.html"
or "index.html" depending on where the RewriteRule is
defined.
The directory path where the rule is defined is stripped from the currently mapped filesystem path before comparison (up to and including a trailing slash). The net result of this per-directory prefix stripping is that rules in this context only match against the portion of the currently mapped filesystem path "below" where the rule is defined.
Directives such as DocumentRoot and Alias, or even the
result of previous RewriteRule substitutions, determine
the currently mapped filesystem path.
If you wish to match against the hostname, port, or query string, use a
RewriteCond with the
%{HTTP_HOST}, %{SERVER_PORT}, or
%{QUERY_STRING} variables respectively.
<Directory> sections, with some additional
complexity.RewriteEngine On" and
"Options FollowSymLinks" must be enabled. If your
administrator has disabled override of FollowSymLinks for
a user's directory, then you cannot use the rewrite engine. This
restriction is required for security reasons.RewriteBase
directive for more information regarding what prefix will be added back to
relative substitutions.%{REQUEST_URI} variable in
a RewriteCond.^/ never
matches in per-directory context.<Location> and <Files> sections
(including their regular expression counterparts), this
should never be necessary and is unsupported. A likely feature
to break in these contexts is relative substitutions.If blocks
follow the rules of the directory context.RewriteOptions directive can change this behavior,
for example using the Inherit setting.RewriteOptions also regulates the
behavior of sections that are stated at the same nesting level of the configuration. In the
following example, by default only the RewriteRules stated in the second
If block
are considered, since the first ones are overridden. Using RewriteOptions Inherit forces mod_rewrite to merge the two
sections and consider both set of statements, rather than only the last one.<If "true"> # Without RewriteOptions Inherit, this rule is overridden by the next # section and no redirect will happen for URIs containing 'foo' RewriteRule foo http://example.com/foo [R] </If> <If "true"> RewriteRule bar http://example.com/bar [R] </If>
For some hints on regular expressions, see the mod_rewrite Introduction.
In mod_rewrite, the NOT character
('!') is also available as a possible pattern
prefix. This enables you to negate a pattern; to say, for instance:
``if the current URL does NOT match this
pattern''. This can be used for exceptional cases, where
it is easier to match the negative pattern, or as a last
default rule.
$N in the substitution string!
The Substitution of a rewrite rule is the string that replaces the original URL-path that was matched by Pattern. The Substitution may be a:
DocumentRoot-relative path to the
resource to be served. Note that mod_rewrite
tries to guess whether you have specified a file-system path
or a URL-path by checking to see if the first segment of the
path exists at the root of the file-system. For example, if
you specify a Substitution string of
/www/file.html, then this will be treated as a
URL-path unless a directory named www
exists at the root or your file-system (or, in the case of
using rewrites in a .htaccess file, relative to
your document root), in which case it will
be treated as a file-system path. If you wish other
URL-mapping directives (such as Alias) to be applied to the
resulting URL-path, use the [PT] flag as
described below.If an absolute URL is specified,
mod_rewrite checks to see whether the
hostname matches the current host. If it does, the scheme and
hostname are stripped out and the resulting path is treated as
a URL-path. Otherwise, an external redirect is performed for
the given URL. To force an external redirect back to the
current host, see the [R] flag below.
Note that a redirect (implicit or not) using an absolute URI
will include the requested query-string, to prevent this see the
[QSD] flag below.
- (dash)In addition to plain text, the Substitution string can include
$N) to the RewriteRule
pattern%N) to the last matched
RewriteCond pattern%{VARNAME})${mapname:key|default})Back-references are identifiers of the form
$N
(N=0..9), which will be replaced
by the contents of the Nth group of the
matched Pattern. The server-variables are the same
as for the TestString of a
RewriteCond
directive. The mapping-functions come from the
RewriteMap
directive and are explained there.
These three types of variables are expanded in the order above.
Rewrite rules are applied to the results of previous rewrite
rules, in the order in which they are defined
in the config file. The URL-path or file-system path (see "What is matched?", above) is completely
replaced by the Substitution and the
rewriting process continues until all rules have been applied,
or it is explicitly terminated by an
L flag,
or other flag which implies immediate termination, such as
END or
F.
By default, the query string is passed through unchanged. You
can, however, create URLs in the substitution string containing
a query string part. Simply use a question mark inside the
substitution string to indicate that the following text should
be re-injected into the query string. When you want to erase an
existing query string, end the substitution string with just a
question mark. To combine new and old query strings, use the
[QSA] flag.
Additionally you can set special actions to be performed by
appending [flags]
as the third argument to the RewriteRule
directive. Flags is a comma-separated list, surround by square
brackets, of any of the flags in the following table. More
details, and examples, for each flag, are available in the Rewrite Flags document.
| Flag and syntax | Function |
|---|---|
| B | Escape non-alphanumeric characters in backreferences before applying the transformation. For similar escaping of server-variables, see the "escape" mapping-function.details ... |
| BCTLS | Like [B], but only escape control characters and spaces. details ... |
| BNE | Characters of [B] or [BCTLS] which should not be escaped. details ... |
| backrefnoplus|BNP | If backreferences are being escaped, spaces should be escaped to %20 instead of +. Useful when the backreference will be used in the path component rather than the query string.details ... |
| chain|C | Rule is chained to the following rule. If the rule fails, the rule(s) chained to it will be skipped. details ... |
| cookie|CO=NAME:VAL | Sets a cookie in the client browser. Full syntax is: CO=NAME:VAL:domain[:lifetime[:path[:secure[:httponly[samesite]]]]] details ... |
| discardpath|DPI | Causes the PATH_INFO portion of the rewritten URI to be discarded. details ... |
| END | Stop the rewriting process immediately and don't apply any more rules. Also prevents further execution of rewrite rules in per-directory and .htaccess context. (Available in 2.3.9 and later) details ... |
| env|E=[!]VAR[:VAL] | Causes an environment variable VAR to be set (to the value VAL if provided). The form !VAR causes the environment variable VAR to be unset. details ... |
| forbidden|F | Returns a 403 FORBIDDEN response to the client browser. details ... |
| gone|G | Returns a 410 GONE response to the client browser. details ... |
| Handler|H=Content-handler | Causes the resulting URI to be sent to the specified Content-handler for processing. details ... |
| last|L | Stop the rewriting process immediately and don't apply any more rules. Especially note caveats for per-directory and .htaccess context (see also the END flag). details ... |
| next|N | Re-run the rewriting process, starting again with the first rule, using the result of the ruleset so far as a starting point. details ... |
| nocase|NC | Makes the pattern comparison case-insensitive. details ... |
| noescape|NE | Prevent mod_rewrite from applying hexcode escaping of special characters in the result of rewrites that result in redirection. details ... |
| nosubreq|NS | Causes a rule to be skipped if the current request is an internal sub-request. details ... |
| proxy|P | Force the substitution URL to be internally sent as a proxy request. details ... |
| passthrough|PT | Forces the resulting URI to be passed back to the URL
mapping engine for processing of other URI-to-filename
translators, such as Alias or
Redirect. details ... |
| qsappend|QSA | Appends any query string from the original request URL to any query string created in the rewrite target.details ... |
| qsdiscard|QSD | Discard any query string attached to the incoming URI. details ... |
| qslast|QSL | Interpret the last (right-most) question mark as the query string delimiter, instead of the first (left-most) as normally used. Available in 2.4.19 and later. details ... |
| redirect|R[=code] | Forces an external redirect, optionally with the specified HTTP status code. details ... |
| skip|S=num | Tells the rewriting engine to skip the next num rules if the current rule matches. details ... |
| type|T=MIME-type | Force the MIME-type of the target file to be the specified type. details ... |
| UnsafeAllow3F | Allows substitutions from URL's that may be unsafe. details ... |
| UnsafePrefixStat | Allows potentially unsafe substitutions from a leading variable or backreference to a filesystem path.
details ... Available in Apache HTTP Server 2.4.60 and later. |
| UNC | Prevents the merging of multiple leading slashes, as used by Windows UNC paths.
details ... Available in Apache HTTP Server 2.4.62 and later. |
When the substitution string begins with a string
resembling "/~user" (via explicit text or backreferences), mod_rewrite performs
home directory expansion independent of the presence or configuration
of mod_userdir.
This expansion does not occur when the PT
flag is used on the RewriteRule
directive.
Here are all possible substitution combinations and their meanings:
Inside per-server configuration
(httpd.conf)
for request ``GET
/somepath/pathinfo'':
| Given Rule | Resulting Substitution |
|---|---|
| ^/somepath(.*) otherpath$1 | invalid, not supported |
| ^/somepath(.*) otherpath$1 [R] | invalid, not supported |
| ^/somepath(.*) otherpath$1 [P] | invalid, not supported |
| ^/somepath(.*) /otherpath$1 | /otherpath/pathinfo |
| ^/somepath(.*) /otherpath$1 [R] | http://thishost/otherpath/pathinfo via external redirection |
| ^/somepath(.*) /otherpath$1 [P] | doesn't make sense, not supported |
| ^/somepath(.*) http://thishost/otherpath$1 | /otherpath/pathinfo |
| ^/somepath(.*) http://thishost/otherpath$1 [R] | http://thishost/otherpath/pathinfo via external redirection |
| ^/somepath(.*) http://thishost/otherpath$1 [P] | doesn't make sense, not supported |
| ^/somepath(.*) http://otherhost/otherpath$1 | http://otherhost/otherpath/pathinfo via external redirection |
| ^/somepath(.*) http://otherhost/otherpath$1 [R] | http://otherhost/otherpath/pathinfo via external redirection (the [R] flag is redundant) |
| ^/somepath(.*) http://otherhost/otherpath$1 [P] | http://otherhost/otherpath/pathinfo via internal proxy |
Inside per-directory configuration for
/somepath
(/physical/path/to/somepath/.htaccess, with
RewriteBase "/somepath")
for request ``GET
/somepath/localpath/pathinfo'':
| Given Rule | Resulting Substitution |
|---|---|
| ^localpath(.*) otherpath$1 | /somepath/otherpath/pathinfo |
| ^localpath(.*) otherpath$1 [R] | http://thishost/somepath/otherpath/pathinfo via external redirection |
| ^localpath(.*) otherpath$1 [P] | doesn't make sense, not supported |
| ^localpath(.*) /otherpath$1 | /otherpath/pathinfo |
| ^localpath(.*) /otherpath$1 [R] | http://thishost/otherpath/pathinfo via external redirection |
| ^localpath(.*) /otherpath$1 [P] | doesn't make sense, not supported |
| ^localpath(.*) http://thishost/otherpath$1 | /otherpath/pathinfo |
| ^localpath(.*) http://thishost/otherpath$1 [R] | http://thishost/otherpath/pathinfo via external redirection |
| ^localpath(.*) http://thishost/otherpath$1 [P] | doesn't make sense, not supported |
| ^localpath(.*) http://otherhost/otherpath$1 | http://otherhost/otherpath/pathinfo via external redirection |
| ^localpath(.*) http://otherhost/otherpath$1 [R] | http://otherhost/otherpath/pathinfo via external redirection (the [R] flag is redundant) |
| ^localpath(.*) http://otherhost/otherpath$1 [P] | http://otherhost/otherpath/pathinfo via internal proxy |
Apache HTTP Server Version 2.4
| Description: | Cookie based session support |
|---|---|
| Status: | Extension |
| Module Identifier: | session_cookie_module |
| Source File: | mod_session_cookie.c |
| Compatibility: | Available in Apache 2.3 and later |
The session modules make use of HTTP cookies, and as such can fall victim to Cross Site Scripting attacks, or expose potentially private information to clients. Please ensure that the relevant risks have been taken into account before enabling the session functionality on your server.
This submodule of mod_session provides support for the
storage of user sessions on the remote browser within HTTP cookies.
Using cookies to store a session removes the need for the server or a group of servers to store the session locally, or collaborate to share a session, and can be useful for high traffic environments where a server based session might be too resource intensive.
If session privacy is required, the mod_session_crypto
module can be used to encrypt the contents of the session before writing
the session to the client.
For more details on the session interface, see the documentation for
the mod_session module.
To create a simple session and store it in a cookie called session, configure the session as follows:
Session On SessionCookieName session path=/
For more examples on how the session can be configured to be read
from and written to by a CGI application, see the
mod_session examples section.
For documentation on how the session can be used to store username
and password details, see the mod_auth_form module.
| Description: | Name and attributes for the RFC2109 cookie storing the session |
|---|---|
| Syntax: | SessionCookieName name attributes |
| Default: | none |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session_cookie |
The SessionCookieName directive specifies the name and
optional attributes of an RFC2109 compliant cookie inside which the session will
be stored. RFC2109 cookies are set using the Set-Cookie HTTP header.
An optional list of cookie attributes can be specified, as per the example below. These attributes are inserted into the cookie as is, and are not interpreted by Apache. Ensure that your attributes are defined correctly as per the cookie specification.
Session On SessionCookieName session path=/private;domain=example.com;httponly;secure;version=1;
| Description: | Name and attributes for the RFC2965 cookie storing the session |
|---|---|
| Syntax: | SessionCookieName2 name attributes |
| Default: | none |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session_cookie |
The SessionCookieName2 directive specifies the name and
optional attributes of an RFC2965 compliant cookie inside which the session will
be stored. RFC2965 cookies are set using the Set-Cookie2 HTTP header.
An optional list of cookie attributes can be specified, as per the example below. These attributes are inserted into the cookie as is, and are not interpreted by Apache. Ensure that your attributes are defined correctly as per the cookie specification.
Session On SessionCookieName2 session path=/private;domain=example.com;httponly;secure;version=1;
| Description: | Control for whether session cookies should be removed from incoming HTTP headers |
|---|---|
| Syntax: | SessionCookieRemove On|Off |
| Default: | SessionCookieRemove Off |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session_cookie |
The SessionCookieRemove flag controls whether the cookies
containing the session will be removed from the headers during request processing.
In a reverse proxy situation where the Apache server acts as a server frontend for a backend origin server, revealing the contents of the session cookie to the backend could be a potential privacy violation. When set to on, the session cookie will be removed from the incoming HTTP headers.
Apache HTTP Server Version 2.4
| Description: | Allows the setting of environment variables based on characteristics of the request |
|---|---|
| Status: | Base |
| Module Identifier: | setenvif_module |
| Source File: | mod_setenvif.c |
The mod_setenvif module allows you to set
internal environment variables according to whether different aspects of
the request match regular expressions you specify. These
environment variables can be used by other parts of the server
to make decisions about actions to be taken, as well as becoming
available to CGI scripts and SSI pages.
The directives are considered in the order they appear in
the configuration files. So more complex sequences can be used,
such as this example, which sets netscape if the
browser is mozilla but not MSIE.
BrowserMatch ^Mozilla netscape BrowserMatch MSIE !netscape
When the server looks up a path via an internal
subrequest such as looking
for a DirectoryIndex
or generating a directory listing with mod_autoindex,
per-request environment variables are not inherited in the
subrequest. Additionally,
SetEnvIf directives
are not separately evaluated in the subrequest due to the API phases
mod_setenvif takes action in.
| Description: | Sets environment variables conditional on HTTP User-Agent |
|---|---|
| Syntax: | BrowserMatch regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_setenvif |
The BrowserMatch is a special cases of the
SetEnvIf directive that
sets environment variables conditional on the
User-Agent HTTP request header. The following two
lines have the same effect:
BrowserMatch Robot is_a_robot SetEnvIf User-Agent Robot is_a_robot
Some additional examples:
BrowserMatch ^Mozilla forms jpeg=yes browser=netscape BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript BrowserMatch MSIE !javascript
| Description: | Sets environment variables conditional on User-Agent without respect to case |
|---|---|
| Syntax: | BrowserMatchNoCase regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_setenvif |
The BrowserMatchNoCase directive is
semantically identical to the BrowserMatch directive.
However, it provides for case-insensitive matching. For
example:
BrowserMatchNoCase mac platform=macintosh BrowserMatchNoCase win platform=windows
The BrowserMatch and
BrowserMatchNoCase directives are special cases of
the SetEnvIf and SetEnvIfNoCase
directives. The following two lines have the same effect:
BrowserMatchNoCase Robot is_a_robot SetEnvIfNoCase User-Agent Robot is_a_robot
| Description: | Sets environment variables based on attributes of the request |
|---|---|
| Syntax: | SetEnvIf attribute
regex [!]env-variable[=value]
[[!]env-variable[=value]] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_setenvif |
The SetEnvIf directive defines
environment variables based on attributes of the request. The
attribute specified in the first argument can be one of four
things:
Host,
User-Agent, Referer, and
Accept-Language. A regular expression may be
used to specify a set of request headers.Remote_Host - the hostname (if available) of
the client making the requestRemote_Addr - the IP address of the client
making the requestServer_Addr - the IP address of the server
on which the request was received (only with versions later
than 2.0.43)Request_Method - the name of the method
being used (GET, POST, et
cetera)Request_Protocol - the name and version of
the protocol with which the request was made (e.g.,
"HTTP/0.9", "HTTP/1.1", etc.)Request_URI - the resource requested on the HTTP
request line -- generally the portion of the URL
following the scheme and host portion without the query string. See
the RewriteCond
directive of mod_rewrite for extra information on
how to match your query string.SetEnvIf directives to test against the result
of prior matches. Only those environment variables defined by earlier
SetEnvIf[NoCase] directives are available for testing in
this manner. 'Earlier' means that they were defined at a broader scope
(such as server-wide) or previously in the current directive's scope.
Environment variables will be considered only if there was no match
among request characteristics and a regular expression was not
used for the attribute.The second argument (regex) is a regular expression. If the regex matches against the attribute, then the remainder of the arguments are evaluated.
The rest of the arguments give the names of variables to set, and optionally values to which they should be set. These take the form of
varname, or!varname, orvarname=valueIn the first form, the value will be set to "1". The second
will remove the given variable if already defined, and the
third will set the variable to the literal value given by
value. Since version 2.0.51, Apache httpd will
recognize occurrences of $1..$9 within
value and replace them by parenthesized subexpressions
of regex. $0 provides access to the whole
string matched by that pattern.
SetEnvIf Request_URI "\.gif$" object_is_image=gif
SetEnvIf Request_URI "\.jpg$" object_is_image=jpg
SetEnvIf Request_URI "\.xbm$" object_is_image=xbm
SetEnvIf Referer www\.mydomain\.example\.com intra_site_referral
SetEnvIf object_is_image xbm XBIT_PROCESSING=1
SetEnvIf Request_URI "\.(.*)$" EXTENSION=$1
SetEnvIf ^TS ^[a-z] HAVE_TS
The first three will set the environment variable
object_is_image if the request was for an image
file, and the fourth sets intra_site_referral if
the referring page was somewhere on the
www.mydomain.example.com Web site.
The last example will set environment variable
HAVE_TS if the request contains any headers that
begin with "TS" whose values begins with any character in the
set [a-z].
| Description: | Sets environment variables based on an ap_expr expression |
|---|---|
| Syntax: | SetEnvIfExpr expr
[!]env-variable[=value]
[[!]env-variable[=value]] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_setenvif |
The SetEnvIfExpr directive defines
environment variables based on an expression.
These expressions will be evaluated at runtime,
and applied env-variable in the same fashion as SetEnvIf, including backreferences.
SetEnvIfExpr "tolower(req('X-Sendfile')) == 'd:\images\very_big.iso')" iso_delivered
SetEnvIfExpr "tolower(req('X-Sendfile')) =~ /(.*\.iso$)/" iso-path=$1
This would set the environment variable iso_delivered
every time our application attempts to send it via X-Sendfile
A more useful example would be to set the variable rfc1918 if the remote IP address is a private address according to RFC 1918:
SetEnvIfExpr "-R '10.0.0.0/8' || -R '172.16.0.0/12' || -R '192.168.0.0/16'" rfc1918
<If> can be used to achieve similar
results.mod_filter| Description: | Sets environment variables based on attributes of the request without respect to case |
|---|---|
| Syntax: | SetEnvIfNoCase attribute regex
[!]env-variable[=value]
[[!]env-variable[=value]] ... |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_setenvif |
The SetEnvIfNoCase is semantically identical to
the SetEnvIf directive,
and differs only in that the regular expression matching is
performed in a case-insensitive manner. For example:
SetEnvIfNoCase Host Example\.Org site=example
This will cause the site environment variable
to be set to "example" if the HTTP request header
field Host: was included and contained
Example.Org, example.org, or any other
combination.
Apache HTTP Server Version 2.4
| Description: | Loading of executable code and modules into the server at start-up or restart time |
|---|---|
| Status: | Extension |
| Module Identifier: | so_module |
| Source File: | mod_so.c |
| Compatibility: | This is a Base module (always included) on Windows |
On selected operating systems this module can be used to load modules into Apache HTTP Server at runtime via the Dynamic Shared Object (DSO) mechanism, rather than requiring a recompilation.
On Unix, the loaded code typically comes from shared object
files (usually with .so extension), on Windows
this may either be the .so or .dll
extension.
Modules built for one major version of the Apache HTTP Server will generally not work on another. (e.g. 1.3 vs. 2.0, or 2.0 vs. 2.2) There are usually API changes between one major version and another that require that modules be modified to work with the new version.
On Windows, where loadable files typically have a file extension
of .dll, Apache httpd modules are called
mod_whatever.so, just as they are on other platforms.
However, you may encounter third-party modules, such as PHP for
example, that continue to use the .dll convention.
While mod_so still loads modules with
ApacheModuleFoo.dll names, the new naming convention is
preferred; if you are converting your loadable module for 2.0,
please fix the name to this 2.0 convention.
The Apache httpd module API is unchanged between the Unix and Windows versions. Many modules will run on Windows with no or little change from Unix, although others rely on aspects of the Unix architecture which are not present in Windows, and will not work.
When a module does work, it can be added to the server in
one of two ways. As with Unix, it can be compiled into the
server. Because Apache httpd for Windows does not have the
Configure program of Apache httpd for Unix, the module's
source file must be added to the ApacheCore project file, and
its symbols must be added to the
os\win32\modules.c file.
The second way is to compile the module as a DLL, a shared
library that can be loaded into the server at runtime, using
the LoadModule
directive. These module DLLs can be distributed and run on any
Apache httpd for Windows installation, without recompilation of the
server.
To create a module DLL, a small change is necessary to the
module's source file: The module record must be exported from
the DLL (which will be created later; see below). To do this,
add the AP_MODULE_DECLARE_DATA (defined in the
Apache httpd header files) to your module's module record definition.
For example, if your module has:
module foo_module;
Replace the above with:
module AP_MODULE_DECLARE_DATA foo_module;
Note that this will only be activated on Windows, so the
module can continue to be used, unchanged, with Unix if needed.
Also, if you are familiar with .DEF files, you can
export the module record with that method instead.
Now, create a DLL containing your module. You will need to link this against the libhttpd.lib export library that is created when the libhttpd.dll shared library is compiled. You may also have to change the compiler settings to ensure that the Apache httpd header files are correctly located. You can find this library in your server root's modules directory. It is best to grab an existing module .dsp file from the tree to assure the build environment is configured correctly, or alternately compare the compiler and link options to your .dsp.
This should create a DLL version of your module. Now simply
place it in the modules directory of your server
root, and use the LoadModule
directive to load it.
| Description: | Link in the named object file or library |
|---|---|
| Syntax: | LoadFile filename [filename] ... |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_so |
The LoadFile directive links in the named object files or
libraries when the server is started or restarted; this is used
to load additional code which may be required for some module
to work. Filename is either an absolute path or
relative to ServerRoot.
For example:
LoadFile "libexec/libxmlparse.so"
| Description: | Links in the object file or library, and adds to the list of active modules |
|---|---|
| Syntax: | LoadModule module filename |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_so |
The LoadModule directive links in the object file or library
filename and adds the module structure named
module to the list of active modules. Module
is the name of the external variable of type
module in the file, and is listed as the Module Identifier
in the module documentation.
For example:
LoadModule status_module "modules/mod_status.so"
loads the named module from the modules subdirectory of the ServerRoot.
Apache HTTP Server Version 2.4
| Description: | Memcache based shared object cache provider. |
|---|---|
| Status: | Extension |
| Module Identifier: | socache_memcache_module |
| Source File: | mod_socache_memcache.c |
mod_socache_memcache is a shared object cache provider
which provides for creation and access to a cache backed by the
memcached
high-performance, distributed memory object caching system.
This shared object cache provider's "create" method requires a
comma separated list of memcached host/port specifications. If using
this provider via another modules configuration (such as
SSLSessionCache), provide
the list of servers as the optional "arg" parameter.
SSLSessionCache memcache:memcache.example.com:12345,memcache2.example.com:12345
Details of other shared object cache providers can be found here.
| Description: | Keepalive time for idle connections |
|---|---|
| Syntax: | MemcacheConnTTL num[units] |
| Default: | MemcacheConnTTL 15s |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_socache_memcache |
| Compatibility: | Available in Apache 2.4.17 and later |
Set the time to keep idle connections with the memcache server(s) alive (threaded platforms only).
Valid values for MemcacheConnTTL are times
up to one hour. 0 means no timeout.
This timeout defaults to units of seconds, but accepts suffixes for milliseconds (ms), seconds (s), minutes (min), and hours (h).
Before Apache 2.4.17, this timeout was hardcoded and its value was 600 usec.
So, the closest configuration to match the legacy behaviour is to set
MemcacheConnTTL to 1ms.
# Set a timeout of 10 minutes MemcacheConnTTL 10min # Set a timeout of 60 seconds MemcacheConnTTL 60
Apache HTTP Server Version 2.4
| Description: | Attempts to correct mistaken URLs by ignoring capitalization, or attempting to correct various minor misspellings. |
|---|---|
| Status: | Extension |
| Module Identifier: | speling_module |
| Source File: | mod_speling.c |
Requests to documents sometimes cannot be served by the core apache server because the request was misspelled or miscapitalized. This module addresses this problem by trying to find a matching document, even after all other modules gave up. It does its work by comparing each document name in the requested directory against the requested document name without regard to case, and allowing up to one misspelling (character insertion / omission / transposition or wrong character). A list is built with all document names which were matched using this strategy. Erroneous extension can also be fixed by this module.
If, after scanning the directory,
404 - document not found).301 - Moved Permanently).300 - Multiple
Choices).| Description: | Also match files with differing file name extensions. |
|---|---|
| Syntax: | CheckBasenameMatch on|off |
| Default: | CheckBasenameMatch On |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Extension |
| Module: | mod_speling |
| Compatibility: | Available in httpd 2.4.50 and later |
When set, this directive extends the action of the spelling correction
to the file name extension. For example a file foo.gif will
match a request for foo or foo.jpg. This can be
particularly useful in conjunction with
MultiViews.
| Description: | Limits the action of the speling module to case corrections |
|---|---|
| Syntax: | CheckCaseOnly on|off |
| Default: | CheckCaseOnly Off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Extension |
| Module: | mod_speling |
When set, this directive limits the action of the spelling correction
to lower/upper case changes. Other potential corrections are not performed,
except when CheckBasenameMatch is also set.
| Description: | Enables the spelling module |
|---|---|
| Syntax: | CheckSpelling on|off |
| Default: | CheckSpelling Off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | Options |
| Status: | Extension |
| Module: | mod_speling |
This directive enables or disables the spelling module. When enabled, keep in mind that
http://my.host/~apahce/), just file names or
directory names.<Location /status> may
get incorrectly treated as the negotiated file
"/stats.html".mod_speling should not be enabled in DAV
enabled directories, because it will try to "spell fix" newly created
resource names against existing filenames, e.g., when trying to upload
a new document doc43.html it might redirect to an existing
document doc34.html, which is not what was intended.
Apache HTTP Server Version 2.4
| Description: | DBD/SQL based session support |
|---|---|
| Status: | Extension |
| Module Identifier: | session_dbd_module |
| Source File: | mod_session_dbd.c |
| Compatibility: | Available in Apache 2.3 and later |
The session modules make use of HTTP cookies, and as such can fall victim to Cross Site Scripting attacks, or expose potentially private information to clients. Please ensure that the relevant risks have been taken into account before enabling the session functionality on your server.
This submodule of mod_session provides support for the
storage of user sessions within a SQL database using the
mod_dbd module.
Sessions can either be anonymous, where the session is keyed by a unique UUID string stored on the browser in a cookie, or per user, where the session is keyed against the userid of the logged in user.
SQL based sessions are hidden from the browser, and so offer a measure of privacy without the need for encryption.
Different webservers within a server farm may choose to share a database, and so share sessions with one another.
For more details on the session interface, see the documentation for
the mod_session module.
SessionDBDCookieName SessionDBDCookieName2 SessionDBDCookieRemove SessionDBDDeleteLabel SessionDBDInsertLabel SessionDBDPerUser SessionDBDSelectLabel SessionDBDUpdateLabelBefore the mod_session_dbd module can be configured to maintain a
session, the mod_dbd module must be configured to make the various database queries
available to the server.
There are four queries required to keep a session maintained, to select an existing session, to update an existing session, to insert a new session, and to delete an expired or empty session. These queries are configured as per the example below.
DBDriver pgsql DBDParams "dbname=apachesession user=apache password=xxxxx host=localhost" DBDPrepareSQL "delete from session where key = %s" deletesession DBDPrepareSQL "update session set value = %s, expiry = %lld, key = %s where key = %s" updatesession DBDPrepareSQL "insert into session (value, expiry, key) values (%s, %lld, %s)" insertsession DBDPrepareSQL "select value from session where key = %s and (expiry = 0 or expiry > %lld)" selectsession DBDPrepareSQL "delete from session where expiry != 0 and expiry < %lld" cleansession
Anonymous sessions are keyed against a unique UUID, and stored on the browser within an HTTP cookie. This method is similar to that used by most application servers to store session information.
To create a simple anonymous session and store it in a postgres database table called apachesession, and save the session ID in a cookie called session, configure the session as follows:
Session On SessionDBDCookieName session path=/
For more examples on how the session can be configured to be read
from and written to by a CGI application, see the
mod_session examples section.
For documentation on how the session can be used to store username
and password details, see the mod_auth_form module.
Per user sessions are keyed against the username of a successfully authenticated user. It offers the most privacy, as no external handle to the session exists outside of the authenticated realm.
Per user sessions work within a correctly configured authenticated
environment, be that using basic authentication, digest authentication
or SSL client certificates. Due to the limitations of who came first,
the chicken or the egg, per user sessions cannot be used to store
authentication credentials from a module like
mod_auth_form.
To create a simple per user session and store it in a postgres database table called apachesession, and with the session keyed to the userid, configure the session as follows:
Session On SessionDBDPerUser On
Over the course of time, the database can be expected to start accumulating
expired sessions. At this point, the mod_session_dbd module
is not yet able to handle session expiry automatically.
The administrator will need to set up an external process via cron to clean out expired sessions.
| Description: | Name and attributes for the RFC2109 cookie storing the session ID |
|---|---|
| Syntax: | SessionDBDCookieName name attributes |
| Default: | none |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session_dbd |
The SessionDBDCookieName directive specifies the name and
optional attributes of an RFC2109 compliant cookie inside which the session ID will
be stored. RFC2109 cookies are set using the Set-Cookie HTTP header.
An optional list of cookie attributes can be specified, as per the example below. These attributes are inserted into the cookie as is, and are not interpreted by Apache. Ensure that your attributes are defined correctly as per the cookie specification.
Session On SessionDBDCookieName session path=/private;domain=example.com;httponly;secure;version=1;
| Description: | Name and attributes for the RFC2965 cookie storing the session ID |
|---|---|
| Syntax: | SessionDBDCookieName2 name attributes |
| Default: | none |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session_dbd |
The SessionDBDCookieName2 directive specifies the name and
optional attributes of an RFC2965 compliant cookie inside which the session ID will
be stored. RFC2965 cookies are set using the Set-Cookie2 HTTP header.
An optional list of cookie attributes can be specified, as per the example below. These attributes are inserted into the cookie as is, and are not interpreted by Apache. Ensure that your attributes are defined correctly as per the cookie specification.
Session On SessionDBDCookieName2 session path=/private;domain=example.com;httponly;secure;version=1;
| Description: | Control for whether session ID cookies should be removed from incoming HTTP headers |
|---|---|
| Syntax: | SessionDBDCookieRemove On|Off |
| Default: | SessionDBDCookieRemove On |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session_dbd |
The SessionDBDCookieRemove flag controls whether the cookies
containing the session ID will be removed from the headers during request processing.
In a reverse proxy situation where the Apache server acts as a server frontend for a backend origin server, revealing the contents of the session ID cookie to the backend could be a potential privacy violation. When set to on, the session ID cookie will be removed from the incoming HTTP headers.
| Description: | The SQL query to use to remove sessions from the database |
|---|---|
| Syntax: | SessionDBDDeleteLabel label |
| Default: | SessionDBDDeleteLabel deletesession |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session_dbd |
The SessionDBDDeleteLabel directive sets the default delete
query label to be used to delete an expired or empty session. This label must have been previously
defined using the DBDPrepareSQL directive.
| Description: | The SQL query to use to insert sessions into the database |
|---|---|
| Syntax: | SessionDBDInsertLabel label |
| Default: | SessionDBDInsertLabel insertsession |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session_dbd |
The SessionDBDInsertLabel directive sets the default insert
query label to be used to load in a session. This label must have been previously defined using the
DBDPrepareSQL directive.
If an attempt to update the session affects no rows, this query will be called to insert the session into the database.
| Description: | Enable a per user session |
|---|---|
| Syntax: | SessionDBDPerUser On|Off |
| Default: | SessionDBDPerUser Off |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session_dbd |
The SessionDBDPerUser flag enables a per user session keyed
against the user's login name. If the user is not logged in, this directive will be
ignored.
| Description: | The SQL query to use to select sessions from the database |
|---|---|
| Syntax: | SessionDBDSelectLabel label |
| Default: | SessionDBDSelectLabel selectsession |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session_dbd |
The SessionDBDSelectLabel directive sets the default select
query label to be used to load in a session. This label must have been previously defined using the
DBDPrepareSQL directive.
| Description: | The SQL query to use to update existing sessions in the database |
|---|---|
| Syntax: | SessionDBDUpdateLabel label |
| Default: | SessionDBDUpdateLabel updatesession |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Extension |
| Module: | mod_session_dbd |
The SessionDBDUpdateLabel directive sets the default update
query label to be used to load in a session. This label must have been previously defined using the
DBDPrepareSQL directive.
If an attempt to update the session affects no rows, the insert query will be called to insert the session into the database. If the database supports InsertOrUpdate, override this query to perform the update in one query instead of two.
Apache HTTP Server Version 2.4
| Description: | Slot-based shared memory provider. |
|---|---|
| Status: | Extension |
| Module Identifier: | slotmem_shm_module |
| Source File: | mod_slotmem_shm.c |
mod_slotmem_shm is a memory provider which
provides for creation and access to a shared memory segment
in which the datasets are organized in "slots."
All shared memory is cleared and cleaned with each
restart, whether graceful or not. The data itself is
stored and restored within a file noted by the name
parameter in the create and attach
calls. If not specified with an absolute path, the file will be
created relative to the path specified by the
DefaultRuntimeDir directive.
mod_slotmem_shm provides the following API functions:
/* call the callback on all worker slots */
apr_status_t doall(ap_slotmem_instance_t *s, ap_slotmem_callback_fn_t *func, void *data, apr_pool_t *pool)
/* create a new slotmem with each item size is item_size. 'name' is used to generate a filename for the persistent
store of the shared memory if configured. Values are:
"none" - Anonymous shared memory and no persistent store
"file-name" - [DefaultRuntimeDir]/file-name
"/absolute-file-name" - Absolute file name */
apr_status_t create(ap_slotmem_instance_t **new, const char *name, apr_size_t item_size, unsigned int item_num, ap_slotmem_type_t type, apr_pool_t *pool)
/* attach to an existing slotmem. See 'create()' for description of 'name' parameter */
apr_status_t attach(ap_slotmem_instance_t **new, const char *name, apr_size_t *item_size, unsigned int *item_num, apr_pool_t *pool)
/* get the direct pointer to the memory associated with this worker slot */
apr_status_t dptr(ap_slotmem_instance_t *s, unsigned int item_id, void **mem)
/* get/read the memory from this slot to dest */
apr_status_t get(ap_slotmem_instance_t *s, unsigned int item_id, unsigned char *dest, apr_size_t dest_len)
/* put/write the data from src to this slot */
apr_status_t put(ap_slotmem_instance_t *slot, unsigned int item_id, unsigned char *src, apr_size_t src_len)
/* return the total number of slots in the segment */
unsigned int num_slots(ap_slotmem_instance_t *s)
/* return the total data size, in bytes, of a slot in the segment */
apr_size_t slot_size(ap_slotmem_instance_t *s)
/* grab or allocate the first free slot and mark as in-use (does not do any data copying) */
apr_status_t grab(ap_slotmem_instance_t *s, unsigned int *item_id)
/* forced grab or allocate the specified slot and mark as in-use (does not do any data copying) */
apr_status_t fgrab(ap_slotmem_instance_t *s, unsigned int item_id)
/* release or free a slot and mark as not in-use (does not do any data copying) */
apr_status_t release(ap_slotmem_instance_t *s, unsigned int item_id)
This module provides no directives.
Apache HTTP Server Version 2.4
| Description: | Distcache based shared object cache provider. |
|---|---|
| Status: | Extension |
| Module Identifier: | socache_dc_module |
| Source File: | mod_socache_dc.c |
mod_socache_dc is a shared object cache provider
which provides for creation and access to a cache backed by the
distcache
distributed session caching libraries.
Details of other shared object cache providers can be found here.
This module provides no directives.
Apache HTTP Server Version 2.4
| Description: | shmcb based shared object cache provider. |
|---|---|
| Status: | Extension |
| Module Identifier: | socache_shmcb_module |
| Source File: | mod_socache_shmcb.c |
mod_socache_shmcb is a shared object cache provider
which provides for creation and access to a cache backed by a
high-performance cyclic buffer inside a shared memory segment.
shmcb:/path/to/datafile(512000)
Details of other shared object cache providers can be found here.
This module provides no directives.
Apache HTTP Server Version 2.4
| Description: | Perform search and replace operations on response bodies |
|---|---|
| Status: | Extension |
| Module Identifier: | substitute_module |
| Source File: | mod_substitute.c |
| Compatibility: | Available in Apache HTTP Server 2.2.7 and later |
mod_substitute provides a mechanism to perform
both regular expression and fixed string substitutions on
response bodies.
| Description: | Pattern to filter the response content |
|---|---|
| Syntax: | Substitute s/pattern/substitution/[infq] |
| Context: | directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_substitute |
The Substitute directive specifies a
search and replace pattern to apply to the response body.
The meaning of the pattern can be modified by using any combination of these flags:
inn flag forces the pattern to be treated
as a fixed string.ff flag causes mod_substitute to flatten the
result of a substitution allowing for later substitutions to
take place on the boundary of this one. This is the default.qq flag causes mod_substitute to not
flatten the buckets after each substitution. This can
result in much faster response and a decrease in memory
utilization, but should only be used if there is no possibility
that the result of one substitution will ever match a pattern
or regex of a subsequent one.The substitution may contain literal text and regular expression backreferences
<Location "/">
AddOutputFilterByType SUBSTITUTE text/html
Substitute "s/foo/bar/ni"
</Location>
The character which is used to separate (or "delimit") the various parts of the substitution string is referred to as the "delimiter", and it is most common to use a slash for this purpose.
If either the pattern or the substitution contain a slash character then an alternative delimiter may be used to make the directive more readable:
<Location "/">
AddOutputFilterByType SUBSTITUTE text/html
Substitute "s|<BR */?>|<br />|i"
</Location>
Backreferences can be used in the comparison and in the substitution, when regular expressions are used, as illustrated in the following example:
<Location "/">
AddOutputFilterByType SUBSTITUTE text/html
# "foo=k,bar=k" -> "foo/bar=k"
Substitute "s|foo=(\w+),bar=\1|foo/bar=$1|"
</Location>
A common use scenario for mod_substitute is the
situation in which a front-end server proxies requests to a back-end
server which returns HTML with hard-coded embedded URLs that refer
to the back-end server. These URLs don't work for the end-user,
since the back-end server is unreachable.
In this case, mod_substitute can be used to rewrite
those URLs into something that will work from the front end:
ProxyPass "/blog/" "http://internal.blog.example.com/" ProxyPassReverse "/blog/" "http://internal.blog.example.com/" Substitute "s|http://internal.blog.example.com/|http://www.example.com/blog/|i"
ProxyPassReverse
modifies any Location (redirect) headers that are sent
by the back-end server, and, in this example,
Substitute takes care of the rest of the problem by
fixing up the HTML response as well.
| Description: | Change the merge order of inherited patterns |
|---|---|
| Syntax: | SubstituteInheritBefore on|off |
| Default: | SubstituteInheritBefore off |
| Context: | directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_substitute |
| Compatibility: | Available in httpd 2.4.17 and later |
Whether to apply the inherited Substitute
patterns first (on), or after the ones of the current
context (off).
SubstituteInheritBefore is itself inherited,
hence contexts that inherit it (those that don't specify their own
SubstituteInheritBefore value) will apply the
closest defined merge order.
| Description: | Set the maximum line size |
|---|---|
| Syntax: | SubstituteMaxLineLength bytes(b|B|k|K|m|M|g|G) |
| Default: | SubstituteMaxLineLength 1m |
| Context: | directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_substitute |
| Compatibility: | Available in httpd 2.4.11 and later |
The maximum line size handled by mod_substitute
is limited to restrict memory use. The limit can be configured
using SubstituteMaxLineLength.
The value can be given as the number of bytes and can be suffixed
with a single letter b, B, k,
K, m, M, g,
G to provide the size in bytes, kilobytes, megabytes
or gigabytes respectively.
<Location "/">
AddOutputFilterByType SUBSTITUTE text/html
SubstituteMaxLineLength 10m
Substitute "s/foo/bar/ni"
</Location>
Apache HTTP Server Version 2.4
| Description: | Provides an environment variable with a unique identifier for each request |
|---|---|
| Status: | Extension |
| Module Identifier: | unique_id_module |
| Source File: | mod_unique_id.c |
This module provides a magic token for each request which is
guaranteed to be unique across "all" requests under very
specific conditions. The unique identifier is even unique
across multiple machines in a properly configured cluster of
machines. The environment variable UNIQUE_ID is
set to the identifier for each request. Unique identifiers are
useful for various reasons which are beyond the scope of this
document.
This module provides no directives.
First a brief recap of how the Apache server works on Unix machines. This feature currently isn't supported on Windows NT. On Unix machines, Apache creates several children, the children process requests one at a time. Each child can serve multiple requests in its lifetime. For the purpose of this discussion, the children don't share any data with each other. We'll refer to the children as httpd processes.
Your website has one or more machines under your administrative control, together we'll call them a cluster of machines. Each machine can possibly run multiple instances of Apache. All of these collectively are considered "the universe", and with certain assumptions we'll show that in this universe we can generate unique identifiers for each request, without extensive communication between machines in the cluster.
The machines in your cluster should satisfy these requirements. (Even if you have only one machine you should synchronize its clock with NTP.)
As far as operating system assumptions go, we assume that pids (process ids) fit in 32-bits. If the operating system uses more than 32-bits for a pid, the fix is trivial but must be performed in the code.
Given those assumptions, at a single point in time we can identify any httpd process on any machine in the cluster from all other httpd processes. The machine's IP address and the pid of the httpd process are sufficient to do this. A httpd process can handle multiple requests simultaneously if you use a multi-threaded MPM. In order to identify threads, we use a thread index Apache httpd uses internally. So in order to generate unique identifiers for requests we need only distinguish between different points in time.
To distinguish time we will use a Unix timestamp (seconds since January 1, 1970 UTC), and a 16-bit counter. The timestamp has only one second granularity, so the counter is used to represent up to 65536 values during a single second. The quadruple ( ip_addr, pid, time_stamp, counter ) is sufficient to enumerate 65536 requests per second per httpd process. There are issues however with pid reuse over time, and the counter is used to alleviate this issue.
When an httpd child is created, the counter is initialized with ( current microseconds divided by 10 ) modulo 65536 (this formula was chosen to eliminate some variance problems with the low order bits of the microsecond timers on some systems). When a unique identifier is generated, the time stamp used is the time the request arrived at the web server. The counter is incremented every time an identifier is generated (and allowed to roll over).
The kernel generates a pid for each process as it forks the process, and pids are allowed to roll over (they're 16-bits on many Unixes, but newer systems have expanded to 32-bits). So over time the same pid will be reused. However unless it is reused within the same second, it does not destroy the uniqueness of our quadruple. That is, we assume the system does not spawn 65536 processes in a one second interval (it may even be 32768 processes on some Unixes, but even this isn't likely to happen).
Suppose that time repeats itself for some reason. That is, suppose that the system's clock is screwed up and it revisits a past time (or it is too far forward, is reset correctly, and then revisits the future time). In this case we can easily show that we can get pid and time stamp reuse. The choice of initializer for the counter is intended to help defeat this. Note that we really want a random number to initialize the counter, but there aren't any readily available numbers on most systems (i.e., you can't use rand() because you need to seed the generator, and can't seed it with the time because time, at least at one second resolution, has repeated itself). This is not a perfect defense.
How good a defense is it? Suppose that one of your machines serves at most 500 requests per second (which is a very reasonable upper bound at this writing, because systems generally do more than just shovel out static files). To do that it will require a number of children which depends on how many concurrent clients you have. But we'll be pessimistic and suppose that a single child is able to serve 500 requests per second. There are 1000 possible starting counter values such that two sequences of 500 requests overlap. So there is a 1.5% chance that if time (at one second resolution) repeats itself this child will repeat a counter value, and uniqueness will be broken. This was a very pessimistic example, and with real world values it's even less likely to occur. If your system is such that it's still likely to occur, then perhaps you should make the counter 32 bits (by editing the code).
You may be concerned about the clock being "set back" during summer daylight savings. However this isn't an issue because the times used here are UTC, which "always" go forward. Note that x86 based Unixes may need proper configuration for this to be true -- they should be configured to assume that the motherboard clock is on UTC and compensate appropriately. But even still, if you're running NTP then your UTC time will be correct very shortly after reboot.
The UNIQUE_ID environment variable is
constructed by encoding the 144-bit (32-bit IP address, 32 bit
pid, 32 bit time stamp, 16 bit counter, 32 bit thread index)
quadruple using the
alphabet [A-Za-z0-9@-] in a manner similar to MIME
base64 encoding, producing 24 characters. The MIME base64
alphabet is actually [A-Za-z0-9+/] however
+ and / need to be specially encoded
in URLs, which makes them less desirable. All values are
encoded in network byte ordering so that the encoding is
comparable across architectures of different byte ordering. The
actual ordering of the encoding is: time stamp, IP address,
pid, counter. This ordering has a purpose, but it should be
emphasized that applications should not dissect the encoding.
Applications should treat the entire encoded
UNIQUE_ID as an opaque token, which can be
compared against other UNIQUE_IDs for equality
only.
The ordering was chosen such that it's possible to change
the encoding in the future without worrying about collision
with an existing database of UNIQUE_IDs. The new
encodings should also keep the time stamp as the first element,
and can otherwise use the same alphabet and bit length. Since
the time stamps are essentially an increasing sequence, it's
sufficient to have a flag second in which all machines
in the cluster stop serving any request, and stop using the old
encoding format. Afterwards they can resume requests and begin
issuing the new encodings.
This we believe is a relatively portable solution to this problem. The identifiers generated have essentially an infinite life-time because future identifiers can be made longer as required. Essentially no communication is required between machines in the cluster (only NTP synchronization is required, which is low overhead), and no communication between httpd processes is required (the communication is implicit in the pid value assigned by the kernel). In very specific situations the identifier can be shortened, but more information needs to be assumed (for example the 32-bit IP address is overkill for any site, but there is no portable shorter replacement for it).
Apache HTTP Server Version 2.4
| Description: | Allows CGI scripts to run as a specified user and Group |
|---|---|
| Status: | Extension |
| Module Identifier: | suexec_module |
| Source File: | mod_suexec.c |
This module, in combination with the suexec support program allows
CGI scripts to run as a specified user and Group.
| Description: | User and group for CGI programs to run as |
|---|---|
| Syntax: | SuexecUserGroup User Group |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_suexec |
The SuexecUserGroup directive allows you
to specify a user and group for CGI programs to run as. Non-CGI
requests are still processed with the user specified in the User directive.
SuexecUserGroup nobody nogroup
Startup will fail if this directive is specified but the suEXEC feature is disabled.
Apache HTTP Server Version 2.4
| Description: | Basic (required) security for Unix-family platforms. |
|---|---|
| Status: | Base |
| Module Identifier: | unixd_module |
| Source File: | mod_unixd.c |
| Description: | Directory for apache to run chroot(8) after startup. |
|---|---|
| Syntax: | ChrootDir /path/to/directory |
| Default: | none |
| Context: | server config |
| Status: | Base |
| Module: | mod_unixd |
| Compatibility: | Available in Apache 2.2.10 and later |
This directive tells the server to chroot(8) to the specified directory after startup, but before accepting requests over the 'net.
Note that running the server under chroot is not simple, and requires additional setup, particularly if you are running scripts such as CGI or PHP. Please make sure you are properly familiar with the operation of chroot before attempting to use this feature.
| Description: | Group under which the server will answer requests |
|---|---|
| Syntax: | Group unix-group |
| Default: | Group #-1 |
| Context: | server config |
| Status: | Base |
| Module: | mod_unixd |
The Group directive sets the group under
which the server will answer requests. In order to use this
directive, the server must be run initially as root. If
you start the server as a non-root user, it will fail to change to the
specified group, and will instead continue to run as the group of the
original user. Unix-group is one of:
# followed by a group number.Group www-group
It is recommended that you set up a new group specifically for
running the server. Some admins use user nobody,
but this is not always possible or desirable.
Don't set Group (or User) to root unless
you know exactly what you are doing, and what the dangers are.
| Description: | Enable or disable the suEXEC feature |
|---|---|
| Syntax: | Suexec On|Off |
| Default: | On if suexec binary exists with proper owner and mode,
Off otherwise |
| Context: | server config |
| Status: | Base |
| Module: | mod_unixd |
When On, startup will fail if the suexec binary doesn't exist or has an invalid owner or file mode.
When Off, suEXEC will be disabled even if the suexec binary exists and has a valid owner and file mode.
| Description: | The userid under which the server will answer requests |
|---|---|
| Syntax: | User unix-userid |
| Default: | User #-1 |
| Context: | server config |
| Status: | Base |
| Module: | mod_unixd |
The User directive sets the user ID as
which the server will answer requests. In order to use this
directive, the server must be run initially as root.
If you start the server as a non-root user, it will fail to change
to the lesser privileged user, and will instead continue to run as
that original user. If you do start the server as root,
then it is normal for the parent process to remain running as root.
Unix-userid is one of:
The user should have no privileges that result in it being
able to access files that are not intended to be visible to the
outside world, and similarly, the user should not be able to
execute code that is not meant for HTTP requests. It is
recommended that you set up a new user and group specifically for
running the server. Some admins use user nobody, but
this is not always desirable, since the nobody user
can have other uses on the system.
Don't set User (or Group) to root unless
you know exactly what you are doing, and what the dangers are.
Apache HTTP Server Version 2.4
| Description: | Version dependent configuration |
|---|---|
| Status: | Extension |
| Module Identifier: | version_module |
| Source File: | mod_version.c |
This module is designed for the use in test suites and large
networks which have to deal with different httpd versions and
different configurations. It provides a new container -- <IfVersion>, which
allows a flexible version checking including numeric comparisons and
regular expressions.
<IfVersion 2.4.2>
# current httpd version is exactly 2.4.2
</IfVersion>
<IfVersion >= 2.5>
# use really new features :-)
</IfVersion>
See below for further possibilities.
| Description: | contains version dependent configuration |
|---|---|
| Syntax: | <IfVersion [[!]operator] version> ...
</IfVersion> |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | All |
| Status: | Extension |
| Module: | mod_version |
The <IfVersion> section encloses
configuration directives which are executed only if the
httpd version
matches the desired criteria. For normal (numeric) comparisons the
version argument has the format
major[.minor[.patch]], e.g.
2.1.0 or 2.2. minor and
patch are optional. If these numbers are omitted, they are
assumed to be zero. The following numerical operators are
possible:
| operator | description |
|---|---|
= or == |
httpd version is equal |
> |
httpd version is greater than |
>= |
httpd version is greater or equal |
< |
httpd version is less than |
<= |
httpd version is less or equal |
<IfVersion >= 2.3>
# this happens only in versions greater or
# equal 2.3.0.
</IfVersion>
Besides the numerical comparison it is possible to match a regular expression against the httpd version. There are two ways to write it:
| operator | description |
|---|---|
= or == |
version has the form
/regex/ |
~ |
version has the form
regex |
<IfVersion = /^2.4.[01234]$/>
# e.g. workaround for buggy versions
</IfVersion>
In order to reverse the meaning, all operators can be preceded by an
exclamation mark (!):
<IfVersion !~ ^2.4.[01234]$>
# not for those versions
</IfVersion>
If the operator is omitted, it is assumed to be
=.
Apache HTTP Server Version 2.4
| Description: | Enhanced charset/internationalisation support for libxml2-based filter modules |
|---|---|
| Status: | Base |
| Module Identifier: | xml2enc_module |
| Source File: | mod_xml2enc.c |
| Compatibility: | Version 2.4 and later. Available as a third-party module for 2.2.x versions |
This module provides enhanced internationalisation support for
markup-aware filter modules such as mod_proxy_html.
It can automatically detect the encoding of input data and ensure
they are correctly processed by the libxml2 parser, including converting to Unicode (UTF-8) where
necessary. It can also convert data to an encoding of choice
after markup processing, and will ensure the correct charset
value is set in the HTTP Content-Type header.
There are two usage scenarios: with modules programmed to work with mod_xml2enc, and with those that are not aware of it:
Modules such as mod_proxy_html version 3.1
and up use the xml2enc_charset optional function to retrieve
the charset argument to pass to the libxml2 parser, and may use the
xml2enc_filter optional function to postprocess to another
encoding. Using mod_xml2enc with an enabled module, no configuration
is necessary: the other module will configure mod_xml2enc for you
(though you may still want to customise it using the configuration
directives below).
To use it with a libxml2-based module that isn't explicitly enabled for mod_xml2enc, you will have to configure the filter chain yourself. So to use it with a filter foo provided by a module mod_foo to improve the latter's i18n support with HTML and XML, you could use
FilterProvider iconv xml2enc Content-Type $text/html
FilterProvider iconv xml2enc Content-Type $xml
FilterProvider markup foo Content-Type $text/html
FilterProvider markup foo Content-Type $xml
FilterChain iconv markup
mod_foo will now support any character set supported by either (or both) of libxml2 or apr_xlate/iconv.
Programmers writing libxml2-based filter modules are encouraged to
enable them for mod_xml2enc, to provide strong i18n support for your
users without reinventing the wheel. The programming API is exposed in
mod_xml2enc.h, and a usage example is
mod_proxy_html.
Unlike mod_charset_lite, mod_xml2enc is designed
to work with data whose encoding cannot be known in advance and thus
configured. It therefore uses 'sniffing' techniques to detect the
encoding of HTTP data as follows:
<META>
element, that is used.xml2EncDefault is used.The rules are applied in order. As soon as a match is found, it is used and detection is stopped.
libxml2 always uses UTF-8 (Unicode) internally, and libxml2-based filter modules will output that by default. mod_xml2enc can change the output encoding through the API, but there is currently no way to configure that directly.
Changing the output encoding should (in theory, at least) never be necessary, and is not recommended due to the extra processing load on the server of an unnecessary conversion.
If you are working with encodings that are not supported by any of
the conversion methods available on your platform, you can still alias
them to a supported encoding using xml2EncAlias.
| Description: | Recognise Aliases for encoding values |
|---|---|
| Syntax: | xml2EncAlias charset alias [alias ...] |
| Context: | server config |
| Status: | Base |
| Module: | mod_xml2enc |
This server-wide directive aliases one or more encoding to another encoding. This enables encodings not recognised by libxml2 to be handled internally by libxml2's encoding support using the translation table for a recognised encoding. This serves two purposes: to support character sets (or names) not recognised either by libxml2 or iconv, and to skip conversion for an encoding where it is known to be unnecessary.
| Description: | Sets a default encoding to assume when absolutely no information can be automatically detected |
|---|---|
| Syntax: | xml2EncDefault name |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Base |
| Module: | mod_xml2enc |
If you are processing data with known encoding but no encoding information, you can set this default to help mod_xml2enc process the data correctly. For example, to work with the default value of Latin1 (iso-8859-1) specified in HTTP/1.0, use:
xml2EncDefault iso-8859-1
| Description: | Advise the parser to skip leading junk. |
|---|---|
| Syntax: | xml2StartParse element [element ...] |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Base |
| Module: | mod_xml2enc |
Specify that the markup parser should start at the first instance of any of the elements specified. This can be used as a workaround where a broken backend inserts leading junk that messes up the parser (example here).
It should never be used for XML, nor well-formed HTML.
Apache HTTP Server Version 2.4
| Description: | Clickstream logging of user activity on a site |
|---|---|
| Status: | Extension |
| Module Identifier: | usertrack_module |
| Source File: | mod_usertrack.c |
Provides tracking of a user through your website via browser cookies.
CookieDomain CookieExpires CookieHTTPOnly CookieName CookieSameSite CookieSecure CookieStyle CookieTrackingmod_usertrack sets a cookie which can be logged
via mod_log_config configurable logging formats:
LogFormat "%{Apache}n %r %t" usertrack
CustomLog "logs/clickstream.log" usertrack
| Description: | The domain to which the tracking cookie applies |
|---|---|
| Syntax: | CookieDomain domain |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
This directive controls the setting of the domain to which the tracking cookie applies. If not present, no domain is included in the cookie header field.
The domain string must begin with a dot, and
must include at least one embedded dot. That is,
.example.com is legal, but www.example.com and
.com are not.
.co.uk,
although such a domain ostensibly fulfills the requirements
above..com, and allowing such cookies may be a security
risk. Thus, if you are under a two-part top level domain, you
should still use your actual domain, as you would with any other top
level domain (for example .example.co.uk).
CookieDomain .example.com
| Description: | Expiry time for the tracking cookie |
|---|---|
| Syntax: | CookieExpires expiry-period |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
When used, this directive sets an expiry time on the cookie generated by the usertrack module. The expiry-period can be given either as a number of seconds, or in the format such as "2 weeks 3 days 7 hours". Valid denominations are: years, months, weeks, days, hours, minutes and seconds. If the expiry time is in any format other than one number indicating the number of seconds, it must be enclosed by double quotes.
If this directive is not used, cookies last only for the current browser session.
CookieExpires "3 weeks"
| Description: | Adds the 'HTTPOnly' attribute to the cookie |
|---|---|
| Syntax: | CookieHTTPOnly on|off |
| Default: | CookieHTTPOnly off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
| Compatibility: | 2.4.42 and later |
When set to 'ON', the 'HTTPOnly' cookie attribute is added to this modules tracking cookie. This attribute instructs browsers to block javascript from reading the value of the cookie.
| Description: | Name of the tracking cookie |
|---|---|
| Syntax: | CookieName token |
| Default: | CookieName Apache |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
This directive allows you to change the name of the cookie
this module uses for its tracking purposes. By default the
cookie is named "Apache".
You must specify a valid cookie name; results are unpredictable if you use a name containing unusual characters. Valid characters include A-Z, a-z, 0-9, "_", and "-".
CookieName clicktrack
| Description: | Adds the 'SameSite' attribute to the cookie |
|---|---|
| Syntax: | CookieSameSite None|Lax|Strict |
| Default: | unset |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
| Compatibility: | 2.4.42 and later |
When set to 'None', 'Lax', or 'Strict', the 'SameSite' cookie attribute is added to this modules tracking cookie with the corresponding value. This attribute instructs browser on how to treat the cookie when it is requested in a cross-site context.
A value of 'None' sets 'SameSite=None', which is the most liberal setting. To omit this attribute, omit the directive entirely.
| Description: | Adds the 'Secure' attribute to the cookie |
|---|---|
| Syntax: | CookieSecure on|off |
| Default: | CookieSecure off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
| Compatibility: | 2.4.42 and later |
When set to 'ON', the 'Secure' cookie attribute is added to this modules tracking cookie. This attribute instructs browsers to only transmit the cookie over HTTPS.
| Description: | Format of the cookie header field |
|---|---|
| Syntax: | CookieStyle
Netscape|Cookie|Cookie2|RFC2109|RFC2965 |
| Default: | CookieStyle Netscape |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
This directive controls the format of the cookie header field. The three formats allowed are:
Not all clients can understand all of these formats, but you
should use the newest one that is generally acceptable to your
users' browsers. At the time of writing, most browsers support all
three of these formats, with Cookie2 being the
preferred format.
CookieStyle Cookie2
| Description: | Enables tracking cookie |
|---|---|
| Syntax: | CookieTracking on|off |
| Default: | CookieTracking off |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
When mod_usertrack is loaded, and
CookieTracking on is set, Apache will send a
user-tracking cookie for all new requests. This directive can
be used to turn this behavior on or off on a per-server or
per-directory basis. By default, enabling
mod_usertrack will not
activate cookies.
CookieTracking on
Apache HTTP Server Version 2.4
| Description: | provides infrastructure for other modules to periodically run tasks |
|---|---|
| Status: | Base |
| Module Identifier: | watchdog_module |
| Source File: | mod_watchdog.c |
| Compatibility: | Available in Apache 2.3 and later |
mod_watchdog defines programmatic hooks for other modules to
periodically run tasks. These modules can register handlers for
mod_watchdog hooks. Currently, the following modules in the
Apache distribution use this functionality:
mod_watchdog functionality,
mod_watchdog itself must be statically linked to the server
core or, if a dynamic module, be loaded before the calling module.
| Description: | Watchdog interval in seconds |
|---|---|
| Syntax: | WatchdogInterval time-interval[s] |
| Default: | WatchdogInterval 1 |
| Context: | server config |
| Status: | Base |
| Module: | mod_watchdog |
Sets the interval at which the watchdog_step hook runs. Default is to run every second.
Apache HTTP Server Version 2.4
| Description: | Session encryption support |
|---|---|
| Status: | Experimental |
| Module Identifier: | session_crypto_module |
| Source File: | mod_session_crypto.c |
| Compatibility: | Available in Apache 2.3 and later |
The session modules make use of HTTP cookies, and as such can fall victim to Cross Site Scripting attacks, or expose potentially private information to clients. Please ensure that the relevant risks have been taken into account before enabling the session functionality on your server.
This submodule of mod_session provides support for the
encryption of user sessions before being written to a local database, or
written to a remote browser via an HTTP cookie.
This can help provide privacy to user sessions where the contents of the session should be kept private from the user, or where protection is needed against the effects of cross site scripting attacks.
For more details on the session interface, see the documentation for
the mod_session module.
To create a simple encrypted session and store it in a cookie called session, configure the session as follows:
Session On SessionCookieName session path=/ SessionCryptoPassphrase secret
The session will be encrypted with the given key. Different servers can be configured to share sessions by ensuring the same encryption key is used on each server.
If the encryption key is changed, sessions will be invalidated automatically.
For documentation on how the session can be used to store username
and password details, see the mod_auth_form module.
| Description: | The crypto cipher to be used to encrypt the session |
|---|---|
| Syntax: | SessionCryptoCipher name |
| Default: | SessionCryptoCipher aes256 |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Experimental |
| Module: | mod_session_crypto |
| Compatibility: | Available in Apache 2.3.0 and later |
The SessionCryptoCipher directive allows the cipher to
be used during encryption. If not specified, the cipher defaults to
aes256.
Possible values depend on the crypto driver in use, and could be one of:
| Description: | The crypto driver to be used to encrypt the session |
|---|---|
| Syntax: | SessionCryptoDriver name [param[=value]] |
| Default: | none |
| Context: | server config |
| Status: | Experimental |
| Module: | mod_session_crypto |
| Compatibility: | Available in Apache 2.3.0 and later |
The SessionCryptoDriver directive specifies the name of
the crypto driver to be used for encryption. If not specified, the driver defaults
to the recommended driver compiled into APR-util.
The NSS crypto driver requires some parameters for configuration, which are specified as parameters with optional values after the driver name.
SessionCryptoDriver nss
SessionCryptoDriver nss dir=certs
SessionCryptoDriver nss dir=certs key3=key3.db cert7=cert7.db secmod=secmod
SessionCryptoDriver nss "dir=My Certs" key3=key3.db cert7=cert7.db secmod=secmod
The NSS crypto driver might have already been
configured by another part of the server, for example from
mod_nss or mod_ldap. If found to
have already been configured, a warning will be logged, and the
existing configuration will have taken affect. To avoid this
warning, use the noinit parameter as follows.
SessionCryptoDriver nss noinit
To prevent confusion, ensure that all modules requiring NSS are configured with identical parameters.
The openssl crypto driver supports an optional parameter to specify the engine to be used for encryption.
SessionCryptoDriver openssl engine=name
| Description: | The key used to encrypt the session |
|---|---|
| Syntax: | SessionCryptoPassphrase secret [ secret ... ] |
| Default: | none |
| Context: | server config, virtual host, directory, .htaccess |
| Status: | Experimental |
| Module: | mod_session_crypto |
| Compatibility: | Available in Apache 2.3.0 and later |
The SessionCryptoPassphrase directive specifies the keys
to be used to enable symmetrical encryption on the contents of the session before
writing the session, or decrypting the contents of the session after reading the
session.
Keys are more secure when they are long, and consist of truly random characters. Changing the key on a server has the effect of invalidating all existing sessions.
Multiple keys can be specified in order to support key rotation. The first key listed will be used for encryption, while all keys listed will be attempted for decryption. To rotate keys across multiple servers over a period of time, add a new secret to the end of the list, and once rolled out completely to all servers, remove the first key from the start of the list.
As of version 2.4.7 if the value begins with exec: the resulting command will be executed and the first line returned to standard output by the program will be used as the key.
#key used as-is SessionCryptoPassphrase secret #Run /path/to/program to get key SessionCryptoPassphrase exec:/path/to/program #Run /path/to/otherProgram and provide arguments SessionCryptoPassphrase "exec:/path/to/otherProgram argument1"
| Description: | File containing keys used to encrypt the session |
|---|---|
| Syntax: | SessionCryptoPassphraseFile filename |
| Default: | none |
| Context: | server config, virtual host, directory |
| Status: | Experimental |
| Module: | mod_session_crypto |
| Compatibility: | Available in Apache 2.3.0 and later |
The SessionCryptoPassphraseFile directive specifies the
name of a configuration file containing the keys to use for encrypting or decrypting
the session, specified one per line. The file is read on server start, and a graceful
restart will be necessary for httpd to pick up changes to the keys.
Unlike the SessionCryptoPassphrase directive, the keys are
not exposed within the httpd configuration and can be hidden by protecting the file
appropriately.
Multiple keys can be specified in order to support key rotation. The first key listed will be used for encryption, while all keys listed will be attempted for decryption. To rotate keys across multiple servers over a period of time, add a new secret to the end of the list, and once rolled out completely to all servers, remove the first key from the start of the list.
Apache HTTP Server Version 2.4
| Description: | Slot-based shared memory provider. |
|---|---|
| Status: | Extension |
| Module Identifier: | slotmem_plain_module |
| Source File: | mod_slotmem_plain.c |
mod_slotmem_plain is a memory provider which
provides for creation and access to a plain memory segment
in which the datasets are organized in "slots."
If the memory needs to be shared between threads and
processes, a better provider would be
mod_slotmem_shm.
mod_slotmem_plain provides the following API functions:
/* call the callback on all worker slots */ apr_status_t doall(ap_slotmem_instance_t *s, ap_slotmem_callback_fn_t *func, void *data, apr_pool_t *pool) /* create a new slotmem with each item size is item_size */ apr_status_t create(ap_slotmem_instance_t **new, const char *name, apr_size_t item_size, unsigned int item_num, ap_slotmem_type_t type, apr_pool_t *pool) /* attach to an existing slotmem */ apr_status_t attach(ap_slotmem_instance_t **new, const char *name, apr_size_t *item_size, unsigned int *item_num, apr_pool_t *pool) /* get the direct pointer to the memory associated with this worker slot */ apr_status_t dptr(ap_slotmem_instance_t *s, unsigned int item_id, void **mem) /* get/read the memory from this slot to dest */ apr_status_t get(ap_slotmem_instance_t *s, unsigned int item_id, unsigned char *dest, apr_size_t dest_len) /* put/write the data from src to this slot */ apr_status_t put(ap_slotmem_instance_t *slot, unsigned int item_id, unsigned char *src, apr_size_t src_len) /* return the total number of slots in the segment */ unsigned int num_slots(ap_slotmem_instance_t *s) /* return the total data size, in bytes, of a slot in the segment */ apr_size_t slot_size(ap_slotmem_instance_t *s) /* grab or allocate the first free slot and mark as in-use (does not do any data copying) */ apr_status_t grab(ap_slotmem_instance_t *s, unsigned int *item_id) /* forced grab or allocate the specified slot and mark as in-use (does not do any data copying) */ apr_status_t fgrab(ap_slotmem_instance_t *s, unsigned int item_id) /* release or free a slot and mark as not in-use (does not do any data copying) */ apr_status_t release(ap_slotmem_instance_t *s, unsigned int item_id)
This module provides no directives.
Apache HTTP Server Version 2.4
| Description: | DBM based shared object cache provider. |
|---|---|
| Status: | Extension |
| Module Identifier: | socache_dbm_module |
| Source File: | mod_socache_dbm.c |
mod_socache_dbm is a shared object cache provider
which provides for creation and access to a cache backed by a
DBM database.
dbm:/path/to/datafile
Details of other shared object cache providers can be found here.
This module provides no directives.
Apache HTTP Server Version 2.4
| Description: | Redis based shared object cache provider. |
|---|---|
| Status: | Extension |
| Module Identifier: | socache_redis_module |
| Source File: | mod_socache_redis.c |
| Compatibility: | Available in Apache 2.4.39 and later |
mod_socache_redis is a shared object cache provider
which provides for creation and access to a cache backed by the
Redis
high-performance, distributed memory object caching system.
This shared object cache provider's "create" method requires a
comma separated list of memcached host/port specifications. If using
this provider via another modules configuration (such as
SSLSessionCache), provide
the list of servers as the optional "arg" parameter.
SSLSessionCache redis:redis.example.com:12345,redis2.example.com:12345
Details of other shared object cache providers can be found here.
| Description: | TTL used for the connection pool with the Redis server(s) |
|---|---|
| Syntax: | RedisConnPoolTTL num[units] |
| Default: | RedisConnPoolTTL 15s |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_socache_redis |
| Compatibility: | Available in Apache 2.4.39 and later |
Set the time to keep idle connections with the Redis server(s) alive (threaded platforms only).
Valid values for RedisConnPoolTTL are times
up to one hour. 0 means no timeout.
This timeout defaults to units of seconds, but accepts suffixes for milliseconds (ms), seconds (s), minutes (min), and hours (h).
# Set a timeout of 10 minutes RedisConnPoolTTL 10min # Set a timeout of 60 seconds RedisConnPoolTTL 60
| Description: | R/W timeout used for the connection with the Redis server(s) |
|---|---|
| Syntax: | RedisTimeout num[units] |
| Default: | RedisTimeout 5s |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_socache_redis |
| Compatibility: | Available in Apache 2.4.39 and later |
Set the Read/Write timeout used for the connection with the Redis server(s).
Valid values for RedisTimeout are times
up to one hour. 0 means no timeout.
This timeout defaults to units of seconds, but accepts suffixes for milliseconds (ms), seconds (s), minutes (min), and hours (h).
# Set a timeout of 10 minutes RedisTimeout 10min # Set a timeout of 60 seconds RedisTimeout 60
Apache HTTP Server Version 2.4
| Description: | Provides information on server activity and performance |
|---|---|
| Status: | Base |
| Module Identifier: | status_module |
| Source File: | mod_status.c |
The Status module allows a server administrator to find out how well their server is performing. A HTML page is presented that gives the current server statistics in an easily readable form. If required this page can be made to automatically refresh (given a compatible browser). Another page gives a simple machine-readable list of the current server state.
The details given are:
The lines marked "(*)" are only available if
ExtendedStatus
is On. In version 2.3.6, loading mod_status will
toggle ExtendedStatus On
by default.
Enabling Status Support Automatic Updates Machine Readable Status File Using server-status to troubleshootThis module provides no directives.
To enable status reports only for browsers from the example.com
domain add this code to your httpd.conf
configuration file
<Location "/server-status">
SetHandler server-status
Require host example.com
</Location>
You can now access server statistics by using a Web browser
to access the page
http://your.server.name/server-status
You can get the status page to update itself automatically if
you have a browser that supports "refresh". Access the page
http://your.server.name/server-status?refresh=N to
refresh the page every N seconds.
A machine-readable version of the status file is available by
accessing the page
http://your.server.name/server-status?auto. This
is useful when automatically run, see the Perl program
log_server_status, which you will find in the
/support directory of your Apache HTTP Server installation.
mod_status is
loaded into the server, its handler capability is available
in all configuration files, including
per-directory files (e.g.,
.htaccess). This may have security-related
ramifications for your site.
The server-status page may be used as a starting
place for troubleshooting a situation where your server is consuming
all available resources (CPU or memory), and you wish to identify
which requests or clients are causing the problem.
First, ensure that you have ExtendedStatus set on, so that you can see
the full request and client information for each child or
thread.
Now look in your process list (using top, or similar
process viewing utility) to identify the specific processes that are
the main culprits. Order the output of top by CPU
usage, or memory usage, depending on what problem you're trying to
address.
Reload the server-status page, and look for those process
ids, and you'll be able to see what request is being served by that
process, for what client. Requests are transient, so you may need to
try several times before you catch it in the act, so to speak.
This process should give you some idea what client, or what type of requests, are primarily responsible for your load problems. Often you will identify a particular web application that is misbehaving, or a particular client that is attacking your site.
Apache HTTP Server Version 2.4
| Description: | Provides better support for systemd integration |
|---|---|
| Status: | Extension |
| Module Identifier: | systemd_module |
| Source File: | mod_systemd.c |
| Compatibility: | Available in Apache 2.4.42 and later |
This module provides support for systemd integration. It allows
httpd to be used in a service with the systemd
Type=notify (see systemd.service(5)
for more information). The module is activated if loaded.
[Unit] Description=The Apache HTTP Server After=network.target [Service] Type=notify ExecStart=/usr/local/apache2/bin/httpd -D FOREGROUND -k start ExecReload=/usr/local/apache2/bin/httpd -k graceful KillMode=mixed [Install] WantedBy=multi-user.target
Special attention should be given to how ExecStop
and/or KillMode are configured for the service. If
configured, an ExecStop command should be a
synchronous operation which itself exits when the daemon
has terminated. Running httpd -k stop
asynchronously initiates daemon termination, so does not
satisfy this condition. The example above uses
KillMode=mixed so that systemd sends
SIGTERM to signal the parent process (and only the
parent) to shut down. The entire process group is then sent
SIGKILL after TimeoutStopSec elapses, if
any processes are still running. See systemd.kill(5)
for more information.
This module does not provide support for Systemd socket activation.
ExtendedStatus is
enabled by default if the module is loaded. If ExtendedStatus is not disabled in
the configuration, run-time load and request statistics are made
available in the systemctl status output.
This module provides no directives.
Apache HTTP Server Version 2.4
| Description: | User-specific directories |
|---|---|
| Status: | Base |
| Module Identifier: | userdir_module |
| Source File: | mod_userdir.c |
This module allows user-specific directories to be accessed using the
http://example.com/~user/ syntax.
| Description: | Location of the user-specific directories |
|---|---|
| Syntax: | UserDir directory-filename [directory-filename] ...
|
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_userdir |
The UserDir directive sets the real
directory in a user's home directory to use when a request for a
document for a user is received. Directory-filename is
one of the following:
disabled. This turns off
all username-to-directory translations except those
explicitly named with the enabled keyword (see
below).disabled followed by a
space-delimited list of usernames. Usernames that appear in
such a list will never have directory translation
performed, even if they appear in an enabled
clause.enabled followed by a
space-delimited list of usernames. These usernames will have
directory translation performed even if a global disable is
in effect, but not if they also appear in a
disabled clause.If neither the enabled nor the
disabled keywords appear in the
Userdir directive, the argument is treated as a
filename pattern, and is used to turn the name into a directory
specification. A request for
http://www.example.com/~bob/one/two.html will be
translated to:
| UserDir directive used | Translated path |
|---|---|
| UserDir public_html | ~bob/public_html/one/two.html |
| UserDir /usr/web | /usr/web/bob/one/two.html |
| UserDir /home/*/www | /home/bob/www/one/two.html |
The following directives will send redirects to the client:
| UserDir directive used | Translated path |
|---|---|
| UserDir http://www.example.com/users | http://www.example.com/users/bob/one/two.html |
| UserDir http://www.example.com/*/usr | http://www.example.com/bob/usr/one/two.html |
| UserDir http://www.example.com/~*/ | http://www.example.com/~bob/one/two.html |
"UserDir ./" would map "/~root" to
"/" - which is probably undesirable. It is strongly
recommended that your configuration include a "UserDir
disabled root" declaration. See also the Directory directive and the Security Tips page for
more information.
Additional examples:
To allow a few users to have UserDir directories, but
not anyone else, use the following:
UserDir disabled UserDir enabled user1 user2 user3
To allow most users to have UserDir directories, but
deny this to a few, use the following:
UserDir disabled user4 user5 user6
It is also possible to specify alternative user directories. If you use a command like:
UserDir "public_html" "/usr/web" "http://www.example.com/"
With a request for
http://www.example.com/~bob/one/two.html, will try to
find the page at ~bob/public_html/one/two.html first, then
/usr/web/bob/one/two.html, and finally it will send a
redirect to http://www.example.com/bob/one/two.html.
If you add a redirect, it must be the last alternative in the list. Apache httpd cannot determine if the redirect succeeded or not, so if you have the redirect earlier in the list, that will always be the alternative that is used.
User directory substitution is not active by default in versions
2.1.4 and later. In earlier versions, UserDir public_html
was assumed if no UserDir
directive was present.
Lists of specific enabled and disabled users are replaced, not merged, from global to virtual host scope
Apache HTTP Server Version 2.4
| Description: | Provides for dynamically configured mass virtual hosting |
|---|---|
| Status: | Extension |
| Module Identifier: | vhost_alias_module |
| Source File: | mod_vhost_alias.c |
This module creates dynamically configured virtual hosts, by
allowing the IP address and/or the Host: header of
the HTTP request to be used as part of the pathname to
determine what files to serve. This allows for easy use of a
huge number of virtual hosts with similar configurations.
If mod_alias or mod_userdir are
used for translating URIs to filenames, they will override the
directives of mod_vhost_alias described below. For
example, the following configuration will map
/cgi-bin/script.pl to
/usr/local/apache2/cgi-bin/script.pl in all cases:
ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/" VirtualScriptAlias "/never/found/%0/cgi-bin/"
All the directives in this module interpolate a string into
a pathname. The interpolated string (henceforth called the
"name") may be either the server name (see the UseCanonicalName
directive for details on how this is determined) or the IP
address of the virtual host on the server in dotted-quad
format. The interpolation is controlled by specifiers inspired
by printf which have a number of formats:
%% |
insert a % |
%p |
insert the port number of the virtual host |
%N.M |
insert (part of) the name |
N and M are used to specify
substrings of the name. N selects from the
dot-separated components of the name, and M
selects characters within whatever N has selected.
M is optional and defaults to zero if it isn't
present; the dot must be present if and only if M
is present. The interpretation is as follows:
0 |
the whole name |
1 |
the first part |
2 |
the second part |
-1 |
the last part |
-2 |
the penultimate part |
2+ |
the second and all subsequent parts |
-2+ |
the penultimate and all preceding parts |
1+ and -1+ |
the same as 0 |
If N or M is greater than the number
of parts available a single underscore is interpolated.
For simple name-based virtual hosts you might use the following directives in your server configuration file:
UseCanonicalName Off VirtualDocumentRoot "/usr/local/apache/vhosts/%0"
A request for
http://www.example.com/directory/file.html will be
satisfied by the file
/usr/local/apache/vhosts/www.example.com/directory/file.html.
For a very large number of virtual hosts it is a good idea
to arrange the files to reduce the size of the
vhosts directory. To do this you might use the
following in your configuration file:
UseCanonicalName Off VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2"
A request for
http://www.domain.example.com/directory/file.html
will be satisfied by the file
/usr/local/apache/vhosts/example.com/d/o/m/domain/directory/file.html.
A more even spread of files can be achieved by hashing from the end of the name, for example:
VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.-1/%2.-2/%2.-3/%2"
The example request would come from
/usr/local/apache/vhosts/example.com/n/i/a/domain/directory/file.html.
Alternatively you might use:
VirtualDocumentRoot "/usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2.4+"
The example request would come from
/usr/local/apache/vhosts/example.com/d/o/m/ain/directory/file.html.
A very common request by users is the ability to point multiple domains to multiple
document roots without having to worry about the length or number of parts of the
hostname being requested. If the requested hostname is sub.www.domain.example.com
instead of simply www.domain.example.com, then using %3+ will result in the document
root being /usr/local/apache/vhosts/domain.example.com/... instead of the
intended example.com directory. In such cases, it can be beneficial to use
the combination %-2.0.%-1.0, which will always yield the domain name and the
tld, for example example.com regardless of the number of subdomains appended
to the hostname. As such, one can make a configuration that will direct all first, second
or third level subdomains to the same directory:
VirtualDocumentRoot "/usr/local/apache/vhosts/%-2.0.%-1.0"
In the example above, both www.example.com as well as www.sub.example.com
or example.com will all point to /usr/local/apache/vhosts/example.com.
For IP-based virtual hosting you might use the following in your configuration file:
UseCanonicalName DNS VirtualDocumentRootIP "/usr/local/apache/vhosts/%1/%2/%3/%4/docs" VirtualScriptAliasIP "/usr/local/apache/vhosts/%1/%2/%3/%4/cgi-bin"
A request for
http://www.domain.example.com/directory/file.html
would be satisfied by the file
/usr/local/apache/vhosts/10/20/30/40/docs/directory/file.html
if the IP address of www.domain.example.com were
10.20.30.40. A request for
http://www.domain.example.com/cgi-bin/script.pl would
be satisfied by executing the program
/usr/local/apache/vhosts/10/20/30/40/cgi-bin/script.pl.
If you want to include the . character in a
VirtualDocumentRoot directive, but it clashes with
a % directive, you can work around the problem in
the following way:
VirtualDocumentRoot "/usr/local/apache/vhosts/%2.0.%3.0"
A request for
http://www.domain.example.com/directory/file.html
will be satisfied by the file
/usr/local/apache/vhosts/domain.example/directory/file.html.
The LogFormat
directives %V and %A are useful
in conjunction with this module.
| Description: | Dynamically configure the location of the document root for a given virtual host |
|---|---|
| Syntax: | VirtualDocumentRoot interpolated-directory|none |
| Default: | VirtualDocumentRoot none |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_vhost_alias |
The VirtualDocumentRoot directive allows you to
determine where Apache HTTP Server will find your documents based on the
value of the server name. The result of expanding
interpolated-directory is used as the root of the
document tree in a similar manner to the DocumentRoot directive's argument.
If interpolated-directory is none then
VirtualDocumentRoot is turned off. This directive
cannot be used in the same context as VirtualDocumentRootIP.
VirtualDocumentRoot will override any DocumentRoot directives you may have put in the same
context or child contexts. Putting a VirtualDocumentRoot
in the global server scope will effectively override DocumentRoot directives in any virtual hosts defined later
on, unless you set VirtualDocumentRoot to None
in each virtual host.
| Description: | Dynamically configure the location of the document root for a given virtual host |
|---|---|
| Syntax: | VirtualDocumentRootIP interpolated-directory|none |
| Default: | VirtualDocumentRootIP none |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_vhost_alias |
The VirtualDocumentRootIP directive is like the
VirtualDocumentRoot
directive, except that it uses the IP address of the server end
of the connection for directory interpolation instead of the server
name.
| Description: | Dynamically configure the location of the CGI directory for a given virtual host |
|---|---|
| Syntax: | VirtualScriptAlias interpolated-directory|none |
| Default: | VirtualScriptAlias none |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_vhost_alias |
The VirtualScriptAlias directive allows you to
determine where Apache httpd will find CGI scripts in a similar
manner to VirtualDocumentRoot does for other documents. It matches
requests for URIs starting /cgi-bin/, much like ScriptAlias
/cgi-bin/ would.
| Description: | Dynamically configure the location of the CGI directory for a given virtual host |
|---|---|
| Syntax: | VirtualScriptAliasIP interpolated-directory|none |
| Default: | VirtualScriptAliasIP none |
| Context: | server config, virtual host |
| Status: | Extension |
| Module: | mod_vhost_alias |
The VirtualScriptAliasIP directive is like the
VirtualScriptAlias
directive, except that it uses the IP address of the server end
of the connection for directory interpolation instead of the server
name.
Apache HTTP Server Version 2.4
This document describes the terms that are used to describe each Apache module.
A brief description of the purpose of the module.
This indicates how tightly bound into the Apache Web server the module is; in other words, you may need to recompile the server in order to gain access to the module and its functionality. Possible values for this attribute are:
This quite simply lists the name of the source file which
contains the code for the module. This is also the name used by
the <IfModule>
directive.
This is a string which identifies the module for use in the
LoadModule directive when
dynamically loading modules. In particular, it is the name of
the external variable of type module in the source file.
If the module was not part of the original Apache version 2 distribution, the version in which it was introduced should be listed here. In addition, if the module is limited to particular platforms, the details will be listed here.
Apache HTTP Server Version 2.4
| Description: | Multi-Processing Module implementing an exclusively threaded web server optimized for Novell NetWare |
|---|---|
| Status: | MPM |
| Module Identifier: | mpm_netware_module |
| Source File: | mpm_netware.c |
This Multi-Processing Module (MPM) implements an exclusively threaded web server that has been optimized for Novell NetWare.
The main thread is responsible for launching child worker threads which listen for connections and serve them when they arrive. Apache HTTP Server always tries to maintain several spare or idle worker threads, which stand ready to serve incoming requests. In this way, clients do not need to wait for a new child threads to be spawned before their requests can be served.
The StartThreads,
MinSpareThreads,
MaxSpareThreads, and
MaxThreads
regulate how the main thread creates worker threads to serve
requests. In general, Apache httpd is very self-regulating, so most
sites do not need to adjust these directives from their default
values. Sites with limited memory may need to decrease MaxThreads to keep the server from
thrashing (spawning and terminating idle threads). More information
about tuning process creation is provided in the performance hints
documentation.
MaxConnectionsPerChild
controls how frequently the server recycles processes by killing old
ones and launching new ones. On the NetWare OS it is highly
recommended that this directive remain set to 0. This allows worker
threads to continue servicing requests indefinitely.
Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxSpareThreads MaxThreads MinSpareThreads ReceiveBufferSize SendBufferSize StartThreads ThreadStackSize| Description: | Set the maximum number of worker threads |
|---|---|
| Syntax: | MaxThreads number |
| Default: | MaxThreads 2048 |
| Context: | server config |
| Status: | MPM |
| Module: | mpm_netware |
The MaxThreads directive sets the desired
maximum number worker threads allowable. The default value is
also the compiled in hard limit. Therefore it can only be lowered,
for example:
MaxThreads 512
Apache HTTP Server Version 2.4
| Description: | A collection of directives that are implemented by more than one multi-processing module (MPM) |
|---|---|
| Status: | MPM |
CoreDumpDirectory EnableExceptionHook GracefulShutdownTimeout Listen ListenBackLog ListenCoresBucketsRatio MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers StartThreads ThreadLimit ThreadsPerChild ThreadStackSize| Description: | Directory where Apache HTTP Server attempts to switch before dumping core |
|---|---|
| Syntax: | CoreDumpDirectory directory |
| Default: | See usage for the default setting |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork |
This controls the directory to which Apache httpd attempts to
switch before dumping core. If your operating system is configured to
create core files in the working directory of the crashing process,
CoreDumpDirectory is necessary to change working
directory from the default ServerRoot
directory, which should not be writable by the user the server runs as.
If you want a core dump for debugging, you can use this directive to place it in a different location. This directive has no effect if your operating system is not configured to write core files to the working directory of the crashing processes.
Using this directive on Linux may allow other processes on
the system (if running with similar privileges, such as CGI
scripts) to attach to httpd children via the ptrace
system call. This may make weaken the protection from certain
security attacks. It is not recommended to use this directive
on production systems.
If Apache httpd starts as root and switches to another user, the
Linux kernel disables core dumps even if the directory is
writable for the process. Apache httpd (2.0.46 and later) reenables core dumps
on Linux 2.4 and beyond, but only if you explicitly configure a CoreDumpDirectory.
To enable core-dumping of suid-executables on BSD-systems (such
as FreeBSD), set kern.sugid_coredump to 1.
CoreDumpDirectory processing only occurs for
a select set of fatal signals: SIGFPE, SIGILL, SIGABORT,
SIGSEGV, and SIGBUS.
On some operating systems, SIGQUIT also results in a core dump but
does not go through CoreDumpDirectory or
EnableExceptionHook processing, so the core
location is dictated entirely by the operating system.
| Description: | Enables a hook that runs exception handlers after a crash |
|---|---|
| Syntax: | EnableExceptionHook On|Off |
| Default: | EnableExceptionHook Off |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork |
For safety reasons this directive is only available if the server was
configured with the --enable-exception-hook option. It
enables a hook that allows external modules to plug in and do something
after a child crashed.
There are already two modules, mod_whatkilledus and
mod_backtrace that make use of this hook. Please have a
look at Jeff Trawick's EnableExceptionHook site for more information about these.
| Description: | Specify a timeout after which a gracefully shutdown server will exit. |
|---|---|
| Syntax: | GracefulShutdownTimeout seconds |
| Default: | GracefulShutdownTimeout 0 |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork |
| Compatibility: | Available in version 2.2 and later |
The GracefulShutdownTimeout specifies
how many seconds after receiving a "graceful-stop" signal, a
server should continue to run, handling the existing connections.
Setting this value to zero means that the server will wait indefinitely until all remaining requests have been fully served.
| Description: | IP addresses and ports that the server listens to |
|---|---|
| Syntax: | Listen [IP-address:]portnumber [protocol] |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
| Compatibility: | The protocol argument was added in 2.1.5 |
The Listen directive instructs Apache httpd to
listen to only specific IP addresses or ports; by default it
responds to requests on all IP interfaces. Listen
is now a required directive. If it is not in the config file, the
server will fail to start. This is a change from previous versions
of Apache httpd.
The Listen directive tells the server to
accept incoming requests on the specified port or address-and-port
combination. If only a port number is specified, the server listens to
the given port on all interfaces. If an IP address is given as well
as a port, the server will listen on the given port and
interface.
Multiple Listen directives may be used to
specify a number of addresses and ports to listen to. The server will
respond to requests from any of the listed addresses and ports.
For example, to make the server accept connections on both port 80 and port 8000, use:
Listen 80 Listen 8000
To make the server accept connections on two specified interfaces and port numbers, use
Listen 192.170.2.1:80 Listen 192.170.2.5:8000
IPv6 addresses must be surrounded in square brackets, as in the following example:
Listen [2001:db8::a00:20ff:fea7:ccea]:80
The optional protocol argument is not required for most
configurations. If not specified, https is the default for
port 443 and http the default for all other ports. The
protocol is used to determine which module should handle a request, and
to apply protocol specific optimizations with the
AcceptFilter directive.
You only need to set the protocol if you are running on non-standard
ports. For example, running an https site on port 8443:
Listen 192.170.2.1:8443 https
Listen directives for the same ip
address and port will result in an Address already in use
error message.
| Description: | Maximum length of the queue of pending connections |
|---|---|
| Syntax: | ListenBackLog backlog |
| Default: | ListenBackLog 511 |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
The maximum length of the queue of pending connections.
Generally no tuning is needed or desired; however on some
systems, it is desirable to increase this when under a TCP SYN
flood attack. See the backlog parameter to the
listen(2) system call.
This will often be limited to a smaller number by the operating system. This varies from OS to OS. Also note that many OSes do not use exactly what is specified as the backlog, but use a number based on (but normally larger than) what is set.
| Description: | Ratio between the number of CPU cores (online) and the number of listeners' buckets |
|---|---|
| Syntax: | ListenCoresBucketsRatio ratio |
| Default: | ListenCoresBucketsRatio 0 (disabled) |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork |
| Compatibility: | Available in Apache HTTP Server 2.4.17, with a kernel supporting
the socket option SO_REUSEPORT and distributing new connections
evenly across listening processes' (or threads') sockets using it (eg. Linux
3.9 and later, but not the current implementations of SO_REUSEPORT
in *BSDs. |
A ratio between the number of (online) CPU cores and the
number of listeners' buckets can be used to make Apache HTTP Server create
num_cpu_cores / ratio listening buckets, each containing its
own Listen-ing socket(s) on the same port(s), and
then make each child handle a single bucket (with round-robin distribution
of the buckets at children creation time).
On Linux (and also BSD) a CPU core can be turned on/off if
Hotplug
is configured, therefore ListenCoresBucketsRatio needs to
take this parameter into account while calculating the number of buckets to create.
ListenCoresBucketsRatio can improve the
scalability when accepting new connections is/becomes the bottleneck.
On systems with a large number of CPU cores, enabling this feature has
been tested to show significant performances improvement and shorter
responses time.
There must be at least twice the number of CPU cores than the
configured ratio for this to be active. The recommended
ratio is 8, hence at least 16
cores should be available at runtime when this value is used.
The right ratio to obtain maximum performance needs to be calculated
for each target system, testing multiple values and observing the variations in your
key performance metrics.
This directive influences the calculation of the
MinSpareThreads and
MaxSpareThreads lower bound values.
The number of children processes needs to be a multiple of the number
of buckets to optimally accept connections.
Listeners or Apache HTTP servers on
the same IP address and portSetting the SO_REUSEPORT option on the listening socket(s)
consequently allows multiple processes (sharing the same EUID,
e.g. root) to bind to the the same IP address and port,
without the binding error raised by the system in the usual case.
This also means that multiple instances of Apache httpd configured on a
same IP:port and with a positive ListenCoresBucketsRatio
would start without an error too, and then run with incoming connections
evenly distributed across both instances (this is NOT a recommendation or
a sensible usage in any case, but just a notice that it would prevent such
possible issues to be detected).
Within the same instance, Apache httpd will check and fail to start if
multiple Listen directives on the exact same IP (or
hostname) and port are configured, thus avoiding the creation of some
duplicated buckets which would be useless and kill performances. However
it can't (and won't try harder to) catch all the possible overlapping cases
(like a hostname resolving to an IP used elsewhere).
| Description: | Limit on the number of connections that an individual child server will handle during its life |
|---|---|
| Syntax: | MaxConnectionsPerChild number |
| Default: | MaxConnectionsPerChild 0 |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
| Compatibility: | Available Apache HTTP Server 2.3.9 and later. The old name
MaxRequestsPerChild is still supported. |
The MaxConnectionsPerChild directive sets
the limit on the number of connections that an individual child
server process will handle. After
MaxConnectionsPerChild connections, the child
process will die. If MaxConnectionsPerChild is
0, then the process will never expire.
Setting MaxConnectionsPerChild to a
non-zero value limits the amount of memory that a process can consume
by (accidental) memory leakage.
| Description: | Maximum amount of memory that the main allocator is allowed
to hold without calling free() |
|---|---|
| Syntax: | MaxMemFree KBytes |
| Default: | MaxMemFree 2048 |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware |
The MaxMemFree directive sets the
maximum number of free Kbytes that every allocator is allowed
to hold without calling free(). In threaded MPMs, every
thread has its own allocator. When set
to zero, the threshold will be set to unlimited.
| Description: | Maximum number of connections that will be processed simultaneously |
|---|---|
| Syntax: | MaxRequestWorkers number |
| Default: | See usage for details |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork |
The MaxRequestWorkers directive sets the limit
on the number of simultaneous requests that will be served. Any
connection attempts over the MaxRequestWorkers
limit will normally be queued, up to a number based on the
ListenBacklog
directive. Once a child process is freed at the end of a different
request, the connection will then be serviced.
For non-threaded servers (i.e., prefork),
MaxRequestWorkers translates into the maximum
number of child processes that will be launched to serve requests.
The default value is 256; to increase it, you must also raise
ServerLimit.
For threaded and hybrid servers (e.g. event
or worker), MaxRequestWorkers restricts
the total number of threads that will be available to serve clients.
For hybrid MPMs, the default value is 16 (ServerLimit) multiplied by the value of
25 (ThreadsPerChild). Therefore, to increase MaxRequestWorkers to a value that requires more than 16 processes,
you must also raise ServerLimit.
MaxRequestWorkers was called
MaxClients before version 2.3.13. The old name is still
supported.
| Description: | Maximum number of idle threads |
|---|---|
| Syntax: | MaxSpareThreads number |
| Default: | See usage for details |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, mpm_netware, mpmt_os2 |
Maximum number of idle threads. Different MPMs deal with this directive differently.
For worker and event, the default is
MaxSpareThreads 250. These MPMs deal with idle threads
on a server-wide basis. If there are too many idle threads in the
server, then child processes are killed until the number of idle
threads is less than this number. Additional processes/threads
might be created if ListenCoresBucketsRatio
is enabled.
For mpm_netware the default is
MaxSpareThreads 100. Since this MPM runs a
single-process, the spare thread count is also server-wide.
mpmt_os2 works
similar to mpm_netware. For
mpmt_os2 the default value is 10.
The range of the MaxSpareThreads value
is restricted. Apache httpd will correct the given value automatically
according to the following rules:
mpm_netware wants the value to be greater than
MinSpareThreads.worker and event, the value
must be greater or equal to the sum of
MinSpareThreads and
ThreadsPerChild.| Description: | Minimum number of idle threads available to handle request spikes |
|---|---|
| Syntax: | MinSpareThreads number |
| Default: | See usage for details |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, mpm_netware, mpmt_os2 |
Minimum number of idle threads to handle request spikes. Different MPMs deal with this directive differently.
worker and event use a default of
MinSpareThreads 75 and deal with idle threads on a server-wide
basis. If there aren't enough idle threads in the server, then child
processes are created until the number of idle threads is greater
than number. Additional processes/threads
might be created if ListenCoresBucketsRatio
is enabled.
mpm_netware uses a default of
MinSpareThreads 10 and, since it is a single-process
MPM, tracks this on a server-wide basis.
mpmt_os2 works
similar to mpm_netware. For
mpmt_os2 the default value is 5.
| Description: | File where the server records the process ID of the daemon |
|---|---|
| Syntax: | PidFile filename |
| Default: | PidFile logs/httpd.pid |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpmt_os2 |
The PidFile directive sets the file to
which the server records the process id of the daemon. If the
filename is not absolute, then it is assumed to be relative to the
ServerRoot.
PidFile /var/run/apache.pid
It is often useful to be able to send the server a signal,
so that it closes and then re-opens its ErrorLog and TransferLog, and
re-reads its configuration files. This is done by sending a
SIGHUP (kill -1) signal to the process id listed in the
PidFile.
The PidFile is subject to the same
warnings about log file placement and security.
As of Apache HTTP Server 2, we recommended that you only use the apachectl script, or the init script that your OS provides,
for (re-)starting or stopping the server.
| Description: | TCP receive buffer size |
|---|---|
| Syntax: | ReceiveBufferSize bytes |
| Default: | ReceiveBufferSize 0 |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
The server will set the TCP receive buffer size to the number of bytes specified.
If set to the value of 0, the server will use the
OS default.
| Description: | Location of the file used to store coordination data for the child processes |
|---|---|
| Syntax: | ScoreBoardFile file-path |
| Default: | ScoreBoardFile logs/apache_runtime_status |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork, mpm_winnt |
Apache HTTP Server uses a scoreboard to communicate between its parent and child processes. Some architectures require a file to facilitate this communication. If the file is left unspecified, Apache httpd first attempts to create the scoreboard entirely in memory (using anonymous shared memory) and, failing that, will attempt to create the file on disk (using file-based shared memory). Specifying this directive causes Apache httpd to always create the file on the disk.
ScoreBoardFile /var/run/apache_runtime_status
File-based shared memory is useful for third-party applications that require direct access to the scoreboard.
If you use a ScoreBoardFile, then
you may see improved speed by placing it on a RAM disk. But be
careful that you heed the same warnings about log file placement
and security.
| Description: | TCP buffer size |
|---|---|
| Syntax: | SendBufferSize bytes |
| Default: | SendBufferSize 0 |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork, mpm_winnt, mpm_netware, mpmt_os2 |
Sets the server's TCP send buffer size to the number of bytes specified. It is often useful to set this past the OS's standard default value on high speed, high latency connections (i.e., 100ms or so, such as transcontinental fast pipes).
If set to the value of 0, the server will use the
default value provided by your OS.
Further configuration of your operating system may be required to elicit better performance on high speed, high latency connections.
On some operating systems, changes in TCP behavior resulting
from a larger SendBufferSize may not be seen unless
EnableSendfile is set to OFF. This
interaction applies only to static files.
| Description: | Upper limit on configurable number of processes |
|---|---|
| Syntax: | ServerLimit number |
| Default: | See usage for details |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork |
For the prefork MPM, this directive sets the
maximum configured value for MaxRequestWorkers for the lifetime of the
Apache httpd process. For the worker and event
MPMs, this directive in combination with ThreadLimit sets
the maximum configured value for MaxRequestWorkers for the lifetime of the
Apache httpd process. For the event MPM, this directive
also defines how many old server processes may keep running and finish processing
open connections.
Any attempts to change this directive during a restart will be ignored, but
MaxRequestWorkers can be modified
during a restart.
Special care must be taken when using this directive. If
ServerLimit is set to a value much higher
than necessary, extra, unused shared memory will be allocated. If
both ServerLimit and MaxRequestWorkers are set to values
higher than the system can handle, Apache httpd may not start or the
system may become unstable.
With the prefork MPM, use this directive only
if you need to set MaxRequestWorkers higher than 256 (default).
Do not set the value of this directive any higher than what you
might want to set MaxRequestWorkers to.
With worker, use this directive only if your
MaxRequestWorkers
and ThreadsPerChild
settings require more than 16 server processes (default). Do not set
the value of this directive any higher than the number of server
processes required by what you may want for MaxRequestWorkers and ThreadsPerChild.
With event, increase this directive if the process
number defined by your MaxRequestWorkers and ThreadsPerChild settings, plus the
number of gracefully shutting down processes, is more than 16 server
processes (default).
There is a hard limit of ServerLimit 20000 compiled
into the server (for the prefork MPM 200000). This is
intended to avoid nasty effects caused by typos. To increase it
even further past this limit, you will need to modify the value of
MAX_SERVER_LIMIT in the mpm source file and rebuild the server.
| Description: | Number of child server processes created at startup |
|---|---|
| Syntax: | StartServers number |
| Default: | See usage for details |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, prefork, mpmt_os2 |
The StartServers directive sets the
number of child server processes created on startup. As the number
of processes is dynamically controlled depending on the load, (see
MinSpareThreads,
MaxSpareThreads,
MinSpareServers, MaxSpareServers)
there is usually little reason to adjust this parameter.
The default value differs from MPM to MPM. worker and
event default to StartServers 3;
prefork defaults to 5; mpmt_os2
defaults to 2.
| Description: | Number of threads created on startup |
|---|---|
| Syntax: | StartThreads number |
| Default: | See usage for details |
| Context: | server config |
| Status: | MPM |
| Module: | mpm_netware |
Number of threads created on startup. As the
number of threads is dynamically controlled depending on the
load, (see
MinSpareThreads,
MaxSpareThreads,
MinSpareServers, MaxSpareServers)
there is usually little reason to adjust this
parameter.
For mpm_netware the default is
StartThreads 50 and, since there is only a single
process, this is the total number of threads created at startup to
serve requests.
| Description: | Sets the upper limit on the configurable number of threads per child process |
|---|---|
| Syntax: | ThreadLimit number |
| Default: | See usage for details |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, mpm_winnt |
This directive sets the maximum configured value for ThreadsPerChild for the lifetime
of the Apache httpd process. Any attempts to change this directive
during a restart will be ignored, but ThreadsPerChild can be modified
during a restart up to the value of this directive.
Special care must be taken when using this directive. If
ThreadLimit is set to a value much higher
than ThreadsPerChild,
extra unused shared memory will be allocated. If both
ThreadLimit and ThreadsPerChild are set to values
higher than the system can handle, Apache httpd may not start or the
system may become unstable. Do not set the value of this directive
any higher than your greatest predicted setting of ThreadsPerChild for the
current run of Apache httpd.
The default value for ThreadLimit is
1920 when used with mpm_winnt and
64 when used with the others.
There is a hard limit of ThreadLimit 20000 (or
ThreadLimit 100000 with event,
ThreadLimit 15000 with mpm_winnt)
compiled into the server. This is intended to avoid nasty effects
caused by typos. To increase it even further past this limit, you
will need to modify the value of MAX_THREAD_LIMIT in the mpm
source file and rebuild the server.
| Description: | Number of threads created by each child process |
|---|---|
| Syntax: | ThreadsPerChild number |
| Default: | See usage for details |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, mpm_winnt |
This directive sets the number of threads created by each
child process. The child creates these threads at startup and
never creates more. If using an MPM like mpm_winnt,
where there is only one child process, this number should be high
enough to handle the entire load of the server. If using an MPM
like worker, where there are multiple child processes,
the total number of threads should be high enough to handle
the common load on the server.
The default value for ThreadsPerChild is
64 when used with mpm_winnt and
25 when used with the others.
The value of ThreadsPerChild can not exceed the
value of ThreadLimit. If a
higher value is configured, it will be automatically reduced at start-up
and a warning will be logged. The relationship between these 2 directives
is explained in ThreadLimit.
| Description: | The size in bytes of the stack used by threads handling client connections |
|---|---|
| Syntax: | ThreadStackSize size |
| Default: | 65536 on NetWare; varies on other operating systems |
| Context: | server config |
| Status: | MPM |
| Module: | event, worker, mpm_winnt, mpm_netware, mpmt_os2 |
| Compatibility: | Available in Apache HTTP Server 2.1 and later |
The ThreadStackSize directive sets the
size of the stack (for autodata) of threads which handle client
connections and call modules to help process those connections.
In most cases the operating system default for stack size is
reasonable, but there are some conditions where it may need to be
adjusted:
ThreadStackSize to a
value higher than the operating system default. This type of
adjustment is necessary only if the provider of the third-party
module specifies that it is required, or if diagnosis of an Apache httpd
crash indicates that the thread stack size was too small.ThreadStackSize is
set to a value lower than the operating system default. This type
of adjustment should only be made in a test environment which allows
the full set of web server processing to be exercised, as there
may be infrequent requests which require more stack to process.
The minimum required stack size strongly depends on the modules
used, but any change in the web server configuration can invalidate
the current ThreadStackSize setting.ulimit -s (8MB if unlimited) is used as the default stack
size.ThreadStackSize
unless a high number of threads per child process is needed. On some
platforms (including Linux), a setting of 128000 is already too low and
causes crashes with some common modules.Apache HTTP Server Version 2.4
| Description: | Hybrid multi-process, multi-threaded MPM for OS/2 |
|---|---|
| Status: | MPM |
| Module Identifier: | mpm_mpmt_os2_module |
| Source File: | mpmt_os2.c |
The Server consists of a main, parent process and a small, static number of child processes.
The parent process's job is to manage the child processes. This
involves spawning children as required to ensure there are always
StartServers processes
accepting connections.
Each child process consists of a pool of worker threads and a
main thread that accepts connections and passes them to the workers via
a work queue. The worker thread pool is dynamic, managed by a
maintenance thread so that the number of idle threads is kept between
MinSpareThreads and
MaxSpareThreads.
Apache HTTP Server Version 2.4
This is an index of the directives that are allowed in .htaccess files for
various AllowOverride settings,
organized by class. Its intended purpose is to help server administrators
verify the privileges they're granting to .htaccess users. For an overview
of how .htaccess works, see the
.htaccess tutorial.
To determine the set of directives that your server configuration allows .htaccess users to use:
AllowOverrideList
for the directory in question. (By default, this is set to
None.)AllowOverride setting for the directory in
question. (By default, it is set to None.) There are two
special cases:
AllowOverride setting is All,
add every directive listed on this page to the list.AllowOverride setting is None,
you're done. Only the directives in the AllowOverrideList
(if any) will be allowed.AllowOverride, look up
the corresponding set of directives below and add them to the list.
Several of the override classes are quite powerful and give .htaccess
users a large amount of control over the server. For a stricter approach,
set AllowOverride None and use
AllowOverrideList to specify the
exact list of directives that .htaccess users are allowed to use.
The following directives are allowed in any .htaccess file, as long as overrides are enabled in the server configuration.
| <Else> | core |
Contains directives that apply only if the condition of a
previous <If> or
<ElseIf> section is not
satisfied by a request at runtime | |
| <ElseIf> | core |
Contains directives that apply only if a condition is satisfied
by a request at runtime while the condition of a previous
<If> or
<ElseIf> section is not
satisfied | |
| <Files> | core |
| Contains directives that apply to matched filenames | |
| <FilesMatch> | core |
| Contains directives that apply to regular-expression matched filenames | |
| <If> | core |
| Contains directives that apply only if a condition is satisfied by a request at runtime | |
| <IfDefine> | core |
| Encloses directives that will be processed only if a test is true at startup | |
| <IfDirective> | core |
| Encloses directives that are processed conditional on the presence or absence of a specific directive | |
| <IfFile> | core |
| Encloses directives that will be processed only if file exists at startup | |
| <IfModule> | core |
| Encloses directives that are processed conditional on the presence or absence of a specific module | |
| <IfSection> | core |
| Encloses directives that are processed conditional on the presence or absence of a specific section directive | |
| <IfVersion> | mod_version |
| contains version dependent configuration | |
| LimitRequestBody | core |
| Restricts the total size of the HTTP request body sent from the client | |
| LimitXMLRequestBody | core |
| Limits the size of an XML-based request body | |
| LogIOTrackTTFB | mod_logio |
| Enable tracking of time to first byte (TTFB) | |
| LuaCodeCache | mod_lua |
| Configure the compiled code cache. | |
| LuaHookAccessChecker | mod_lua |
| Provide a hook for the access_checker phase of request processing | |
| LuaHookAuthChecker | mod_lua |
| Provide a hook for the auth_checker phase of request processing | |
| LuaHookCheckUserID | mod_lua |
| Provide a hook for the check_user_id phase of request processing | |
| LuaHookFixups | mod_lua |
| Provide a hook for the fixups phase of a request processing | |
| LuaHookInsertFilter | mod_lua |
| Provide a hook for the insert_filter phase of request processing | |
| LuaHookLog | mod_lua |
| Provide a hook for the access log phase of a request processing | |
| LuaHookMapToStorage | mod_lua |
| Provide a hook for the map_to_storage phase of request processing | |
| LuaHookPreTranslate | mod_lua |
| Provide a hook for the pre_translate phase of a request processing | |
| LuaHookTranslateName | mod_lua |
| Provide a hook for the translate name phase of request processing | |
| LuaHookTypeChecker | mod_lua |
| Provide a hook for the type_checker phase of request processing | |
| LuaInherit | mod_lua |
| Controls how parent configuration sections are merged into children | |
| LuaMapHandler | mod_lua |
| Map a path to a lua handler | |
| LuaPackageCPath | mod_lua |
| Add a directory to lua's package.cpath | |
| LuaPackagePath | mod_lua |
| Add a directory to lua's package.path | |
| LuaQuickHandler | mod_lua |
| Provide a hook for the quick handler of request processing | |
| LuaRoot | mod_lua |
| Specify the base path for resolving relative paths for mod_lua directives | |
| LuaScope | mod_lua |
| One of once, request, conn, thread -- default is once | |
| RLimitCPU | core |
| Limits the CPU consumption of processes launched by Apache httpd children | |
| RLimitMEM | core |
| Limits the memory consumption of processes launched by Apache httpd children | |
| RLimitNPROC | core |
| Limits the number of processes that can be launched by processes launched by Apache httpd children | |
| ServerSignature | core |
| Configures the footer on server-generated documents | |
| SSIErrorMsg | mod_include |
| Error message displayed when there is an SSI error | |
| SSITimeFormat | mod_include |
| Configures the format in which date strings are displayed | |
| SSIUndefinedEcho | mod_include |
| String displayed when an unset variable is echoed | |
The following directives are allowed in .htaccess files when
AllowOverride AuthConfig is in effect. They give .htaccess
users control over the authentication and authorization methods that are
applied to their directory subtrees, including several related utility
directives for session handling and TLS settings.
| Anonymous | mod_authn_anon |
| Specifies userIDs that are allowed access without password verification | |
| Anonymous_LogEmail | mod_authn_anon |
| Sets whether the password entered will be logged in the error log | |
| Anonymous_MustGiveEmail | mod_authn_anon |
| Specifies whether blank passwords are allowed | |
| Anonymous_NoUserID | mod_authn_anon |
| Sets whether the userID field may be empty | |
| Anonymous_VerifyEmail | mod_authn_anon |
| Sets whether to check the password field for a correctly formatted email address | |
| AuthBasicAuthoritative | mod_auth_basic |
| Sets whether authorization and authentication are passed to lower level modules | |
| AuthBasicFake | mod_auth_basic |
| Fake basic authentication using the given expressions for username and password | |
| AuthBasicProvider | mod_auth_basic |
| Sets the authentication provider(s) for this location | |
| AuthBasicUseDigestAlgorithm | mod_auth_basic |
| Check passwords against the authentication providers as if Digest Authentication was in force instead of Basic Authentication. | |
| AuthDBMGroupFile | mod_authz_dbm |
| Sets the name of the database file containing the list of user groups for authorization | |
| AuthDBMType | mod_authn_dbm |
| Sets the type of database file that is used to store passwords | |
| AuthDBMUserFile | mod_authn_dbm |
| Sets the name of a database file containing the list of users and passwords for authentication | |
| AuthDigestAlgorithm | mod_auth_digest |
| Selects the algorithm used to calculate the challenge and response hashes in digest authentication | |
| AuthDigestDomain | mod_auth_digest |
| URIs that are in the same protection space for digest authentication | |
| AuthDigestNonceLifetime | mod_auth_digest |
| How long the server nonce is valid | |
| AuthDigestProvider | mod_auth_digest |
| Sets the authentication provider(s) for this location | |
| AuthDigestQop | mod_auth_digest |
| Determines the quality-of-protection to use in digest authentication | |
| AuthFormAuthoritative | mod_auth_form |
| Sets whether authorization and authentication are passed to lower level modules | |
| AuthFormProvider | mod_auth_form |
| Sets the authentication provider(s) for this location | |
| AuthGroupFile | mod_authz_groupfile |
| Sets the name of a text file containing the list of user groups for authorization | |
| AuthLDAPAuthorizePrefix | mod_authnz_ldap |
| Specifies the prefix for environment variables set during authorization | |
| AuthLDAPBindAuthoritative | mod_authnz_ldap |
| Determines if other authentication providers are used when a user can be mapped to a DN but the server cannot successfully bind with the user's credentials. | |
| AuthLDAPBindDN | mod_authnz_ldap |
| Optional DN to use in binding to the LDAP server | |
| AuthLDAPBindPassword | mod_authnz_ldap |
| Password used in conjunction with the bind DN | |
| AuthLDAPCompareAsUser | mod_authnz_ldap |
| Use the authenticated user's credentials to perform authorization comparisons | |
| AuthLDAPCompareDNOnServer | mod_authnz_ldap |
| Use the LDAP server to compare the DNs | |
| AuthLDAPDereferenceAliases | mod_authnz_ldap |
| When will the module de-reference aliases | |
| AuthLDAPGroupAttribute | mod_authnz_ldap |
| LDAP attributes used to identify the user members of groups. | |
| AuthLDAPGroupAttributeIsDN | mod_authnz_ldap |
| Use the DN of the client username when checking for group membership | |
| AuthLDAPInitialBindAsUser | mod_authnz_ldap |
| Determines if the server does the initial DN lookup using the basic authentication users' own username, instead of anonymously or with hard-coded credentials for the server | |
| AuthLDAPInitialBindPattern | mod_authnz_ldap |
| Specifies the transformation of the basic authentication username to be used when binding to the LDAP server to perform a DN lookup | |
| AuthLDAPMaxSubGroupDepth | mod_authnz_ldap |
| Specifies the maximum sub-group nesting depth that will be evaluated before the user search is discontinued. | |
| AuthLDAPRemoteUserAttribute | mod_authnz_ldap |
| Use the value of the attribute returned during the user query to set the REMOTE_USER environment variable | |
| AuthLDAPRemoteUserIsDN | mod_authnz_ldap |
| Use the DN of the client username to set the REMOTE_USER environment variable | |
| AuthLDAPSearchAsUser | mod_authnz_ldap |
| Use the authenticated user's credentials to perform authorization searches | |
| AuthLDAPSubGroupAttribute | mod_authnz_ldap |
| Specifies the attribute labels, one value per directive line, used to distinguish the members of the current group that are groups. | |
| AuthLDAPSubGroupClass | mod_authnz_ldap |
| Specifies which LDAP objectClass values identify directory objects that are groups during sub-group processing. | |
| AuthLDAPURL | mod_authnz_ldap |
| URL specifying the LDAP search parameters | |
| AuthMerging | mod_authz_core |
| Controls the manner in which each configuration section's authorization logic is combined with that of preceding configuration sections. | |
| AuthName | mod_authn_core |
| Authorization realm for use in HTTP authentication | |
| AuthnCacheProvideFor | mod_authn_socache |
| Specify which authn provider(s) to cache for | |
| AuthnCacheTimeout | mod_authn_socache |
| Set a timeout for cache entries | |
| AuthType | mod_authn_core |
| Type of user authentication | |
| AuthUserFile | mod_authn_file |
| Sets the name of a text file containing the list of users and passwords for authentication | |
| AuthzDBMType | mod_authz_dbm |
| Sets the type of database file that is used to store list of user groups | |
| CGIPassAuth | core |
| Enables passing HTTP authorization headers to scripts as CGI variables | |
| LDAPReferralHopLimit | mod_ldap |
| The maximum number of referral hops to chase before terminating an LDAP query. | |
| LDAPReferrals | mod_ldap |
| Enable referral chasing during queries to the LDAP server. | |
| <Limit> | core |
| Restrict enclosed access controls to only certain HTTP methods | |
| <LimitExcept> | core |
| Restrict access controls to all HTTP methods except the named ones | |
| Require | mod_authz_core |
| Tests whether an authenticated user is authorized by an authorization provider. | |
| <RequireAll> | mod_authz_core |
| Enclose a group of authorization directives of which none must fail and at least one must succeed for the enclosing directive to succeed. | |
| <RequireAny> | mod_authz_core |
| Enclose a group of authorization directives of which one must succeed for the enclosing directive to succeed. | |
| <RequireNone> | mod_authz_core |
| Enclose a group of authorization directives of which none must succeed for the enclosing directive to not fail. | |
| Satisfy | mod_access_compat |
| Interaction between host-level access control and user authentication | |
| Session | mod_session |
| Enables a session for the current directory or location | |
| SessionEnv | mod_session |
| Control whether the contents of the session are written to the HTTP_SESSION environment variable | |
| SessionHeader | mod_session |
| Import session updates from a given HTTP response header | |
| SessionInclude | mod_session |
| Define URL prefixes for which a session is valid | |
| SessionMaxAge | mod_session |
| Define a maximum age in seconds for a session | |
| SSLCipherSuite | mod_ssl |
| Cipher Suite available for negotiation in SSL handshake | |
| SSLRenegBufferSize | mod_ssl |
| Set the size for the SSL renegotiation buffer | |
| SSLRequire | mod_ssl |
| Allow access only when an arbitrarily complex boolean expression is true | |
| SSLRequireSSL | mod_ssl |
| Deny access when SSL is not used for the HTTP request | |
| SSLUserName | mod_ssl |
| Variable name to determine user name | |
| SSLVerifyClient | mod_ssl |
| Type of Client Certificate verification | |
| SSLVerifyDepth | mod_ssl |
| Maximum depth of CA Certificates in Client Certificate verification | |
The following directives are allowed in .htaccess files when
AllowOverride FileInfo is in effect. They give .htaccess
users a wide range of control over the responses and metadata given by the
server.
| AcceptPathInfo | core |
| Resources accept trailing pathname information | |
| Action | mod_actions |
| Activates a CGI script for a particular handler or content-type | |
| AddCharset | mod_mime |
| Maps the given filename extensions to the specified content charset | |
| AddDefaultCharset | core |
Default charset parameter to be added when a response
content-type is text/plain or text/html | |
| AddEncoding | mod_mime |
| Maps the given filename extensions to the specified encoding type | |
| AddHandler | mod_mime |
| Maps the filename extensions to the specified handler | |
| AddInputFilter | mod_mime |
| Maps filename extensions to the filters that will process client requests | |
| AddLanguage | mod_mime |
| Maps the given filename extension to the specified content language | |
| AddOutputFilter | mod_mime |
| Maps filename extensions to the filters that will process responses from the server | |
| AddOutputFilterByType | mod_filter |
| assigns an output filter to a particular media-type | |
| AddType | mod_mime |
| Maps the given filename extensions onto the specified content type | |
| BrowserMatch | mod_setenvif |
| Sets environment variables conditional on HTTP User-Agent | |
| BrowserMatchNoCase | mod_setenvif |
| Sets environment variables conditional on User-Agent without respect to case | |
| CGIMapExtension | core |
| Technique for locating the interpreter for CGI scripts | |
| CGIVar | core |
| Controls how some CGI variables are set | |
| CharsetDefault | mod_charset_lite |
| Charset to translate into | |
| CharsetOptions | mod_charset_lite |
| Configures charset translation behavior | |
| CharsetSourceEnc | mod_charset_lite |
| Source charset of files | |
| CookieDomain | mod_usertrack |
| The domain to which the tracking cookie applies | |
| CookieExpires | mod_usertrack |
| Expiry time for the tracking cookie | |
| CookieHTTPOnly | mod_usertrack |
| Adds the 'HTTPOnly' attribute to the cookie | |
| CookieName | mod_usertrack |
| Name of the tracking cookie | |
| CookieSameSite | mod_usertrack |
| Adds the 'SameSite' attribute to the cookie | |
| CookieSecure | mod_usertrack |
| Adds the 'Secure' attribute to the cookie | |
| CookieStyle | mod_usertrack |
| Format of the cookie header field | |
| CookieTracking | mod_usertrack |
| Enables tracking cookie | |
| DefaultLanguage | mod_mime |
| Defines a default language-tag to be sent in the Content-Language header field for all resources in the current context that have not been assigned a language-tag by some other means. | |
| DefaultType | core |
This directive has no effect other than to emit warnings
if the value is not none. In prior versions, DefaultType
would specify a default media type to assign to response content for
which no other media type configuration could be found.
| |
| EnableMMAP | core |
| Use memory-mapping to read files during delivery | |
| EnableSendfile | core |
| Use the kernel sendfile support to deliver files to the client | |
| ErrorDocument | core |
| What the server will return to the client in case of an error | |
| FileETag | core |
| File attributes used to create the ETag HTTP response header for static files | |
| ForceLanguagePriority | mod_negotiation |
| Action to take if a single acceptable document is not found | |
| ForceType | core |
| Forces all matching files to be served with the specified media type in the HTTP Content-Type header field | |
| Header | mod_headers |
| Configure HTTP response headers | |
| ISAPIAppendLogToErrors | mod_isapi |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the error log | |
| ISAPIAppendLogToQuery | mod_isapi |
Record HSE_APPEND_LOG_PARAMETER requests from
ISAPI extensions to the query field | |
| ISAPIFakeAsync | mod_isapi |
| Fake asynchronous support for ISAPI callbacks | |
| ISAPILogNotSupported | mod_isapi |
| Log unsupported feature requests from ISAPI extensions | |
| ISAPIReadAheadBuffer | mod_isapi |
| Size of the Read Ahead Buffer sent to ISAPI extensions | |
| LanguagePriority | mod_negotiation |
| The precedence of language variants for cases where the client does not express a preference | |
| MultiviewsMatch | mod_mime |
| The types of files that will be included when searching for a matching file with MultiViews | |
| PassEnv | mod_env |
| Passes environment variables from the shell | |
| QualifyRedirectURL | core |
| Controls whether the REDIRECT_URL environment variable is fully qualified | |
| Redirect | mod_alias |
| Sends an external redirect asking the client to fetch a different URL | |
| RedirectMatch | mod_alias |
| Sends an external redirect based on a regular expression match of the current URL | |
| RedirectPermanent | mod_alias |
| Sends an external permanent redirect asking the client to fetch a different URL | |
| RedirectTemp | mod_alias |
| Sends an external temporary redirect asking the client to fetch a different URL | |
| RemoveCharset | mod_mime |
| Removes any character set associations for a set of file extensions | |
| RemoveEncoding | mod_mime |
| Removes any content encoding associations for a set of file extensions | |
| RemoveHandler | mod_mime |
| Removes any handler associations for a set of file extensions | |
| RemoveInputFilter | mod_mime |
| Removes any input filter associations for a set of file extensions | |
| RemoveLanguage | mod_mime |
| Removes any language associations for a set of file extensions | |
| RemoveOutputFilter | mod_mime |
| Removes any output filter associations for a set of file extensions | |
| RemoveType | mod_mime |
| Removes any content type associations for a set of file extensions | |
| RequestHeader | mod_headers |
| Configure HTTP request headers | |
| RewriteBase | mod_rewrite |
| Sets the base URL for per-directory rewrites | |
| RewriteCond | mod_rewrite |
| Defines a condition under which rewriting will take place | |
| RewriteEngine | mod_rewrite |
| Enables or disables runtime rewriting engine | |
| RewriteOptions | mod_rewrite |
| Sets some special options for the rewrite engine | |
| RewriteRule | mod_rewrite |
| Defines rules for the rewriting engine | |
| ScriptInterpreterSource | core |
| Technique for locating the interpreter for CGI scripts | |
| SetEnv | mod_env |
| Sets environment variables | |
| SetEnvIf | mod_setenvif |
| Sets environment variables based on attributes of the request | |
| SetEnvIfExpr | mod_setenvif |
| Sets environment variables based on an ap_expr expression | |
| SetEnvIfNoCase | mod_setenvif |
| Sets environment variables based on attributes of the request without respect to case | |
| SetHandler | core |
| Forces all matching files to be processed by a handler | |
| SetInputFilter | core |
| Sets the filters that will process client requests and POST input | |
| SetOutputFilter | core |
| Sets the filters that will process responses from the server | |
| Substitute | mod_substitute |
| Pattern to filter the response content | |
| SubstituteInheritBefore | mod_substitute |
| Change the merge order of inherited patterns | |
| SubstituteMaxLineLength | mod_substitute |
| Set the maximum line size | |
| UnsetEnv | mod_env |
| Removes variables from the environment | |
The following directives are allowed in .htaccess files when
AllowOverride Indexes is in effect. They allow .htaccess
users to control aspects of the directory index pages provided by the
server, including autoindex generation.
| AddAlt | mod_autoindex |
| Alternate text to display for a file, instead of an icon selected by filename | |
| AddAltByEncoding | mod_autoindex |
| Alternate text to display for a file instead of an icon selected by MIME-encoding | |
| AddAltByType | mod_autoindex |
| Alternate text to display for a file, instead of an icon selected by MIME content-type | |
| AddDescription | mod_autoindex |
| Description to display for a file | |
| AddIcon | mod_autoindex |
| Icon to display for a file selected by name | |
| AddIconByEncoding | mod_autoindex |
| Icon to display next to files selected by MIME content-encoding | |
| AddIconByType | mod_autoindex |
| Icon to display next to files selected by MIME content-type | |
| DefaultIcon | mod_autoindex |
| Icon to display for files when no specific icon is configured | |
| DirectoryCheckHandler | mod_dir |
| Toggle how this module responds when another handler is configured | |
| DirectoryIndex | mod_dir |
| List of resources to look for when the client requests a directory | |
| DirectoryIndexRedirect | mod_dir |
| Configures an external redirect for directory indexes. | |
| DirectorySlash | mod_dir |
| Toggle trailing slash redirects on or off | |
| ExpiresActive | mod_expires |
Enables generation of Expires
headers | |
| ExpiresByType | mod_expires |
Value of the Expires header configured
by MIME type | |
| ExpiresDefault | mod_expires |
| Default algorithm for calculating expiration time | |
| FallbackResource | mod_dir |
| Define a default URL for requests that don't map to a file | |
| HeaderName | mod_autoindex |
| Name of the file that will be inserted at the top of the index listing | |
| ImapBase | mod_imagemap |
Default base for imagemap files | |
| ImapDefault | mod_imagemap |
| Default action when an imagemap is called with coordinates that are not explicitly mapped | |
| ImapMenu | mod_imagemap |
| Action if no coordinates are given when calling an imagemap | |
| IndexHeadInsert | mod_autoindex |
| Inserts text in the HEAD section of an index page. | |
| IndexIgnore | mod_autoindex |
| Adds to the list of files to hide when listing a directory | |
| IndexIgnoreReset | mod_autoindex |
| Empties the list of files to hide when listing a directory | |
| IndexOptions | mod_autoindex |
| Various configuration settings for directory indexing | |
| IndexOrderDefault | mod_autoindex |
| Sets the default ordering of the directory index | |
| IndexStyleSheet | mod_autoindex |
| Adds a CSS stylesheet to the directory index | |
| MetaDir | mod_cern_meta |
| Name of the directory to find CERN-style meta information files | |
| MetaFiles | mod_cern_meta |
| Activates CERN meta-file processing | |
| MetaSuffix | mod_cern_meta |
| File name suffix for the file containing CERN-style meta information | |
| ReadmeName | mod_autoindex |
| Name of the file that will be inserted at the end of the index listing | |
The following directives are allowed in .htaccess files when
AllowOverride Limit is in effect. This extremely narrow
override type mostly allows the use of the legacy authorization directives
provided by mod_access_compat.
| Allow | mod_access_compat |
| Controls which hosts can access an area of the server | |
| Deny | mod_access_compat |
| Controls which hosts are denied access to the server | |
| <Limit> | core |
| Restrict enclosed access controls to only certain HTTP methods | |
| <LimitExcept> | core |
| Restrict access controls to all HTTP methods except the named ones | |
| Order | mod_access_compat |
Controls the default access state and the order in which
Allow and Deny are
evaluated. | |
The following directives are allowed in .htaccess files when
AllowOverride Options is in effect. They give .htaccess
users access to Options and similar directives, as well as
directives that control the filter chain.
| CheckBasenameMatch | mod_speling |
| Also match files with differing file name extensions. | |
| CheckCaseOnly | mod_speling |
| Limits the action of the speling module to case corrections | |
| CheckSpelling | mod_speling |
| Enables the spelling module | |
| ContentDigest | core |
Enables the generation of Content-MD5 HTTP Response
headers | |
| FilterChain | mod_filter |
| Configure the filter chain | |
| FilterDeclare | mod_filter |
| Declare a smart filter | |
| FilterProtocol | mod_filter |
| Deal with correct HTTP protocol handling | |
| FilterProvider | mod_filter |
| Register a content filter | |
| Options | core |
| Configures what features are available in a particular directory | |
| ReflectorHeader | mod_reflector |
| Reflect an input header to the output headers | |
| SSLOptions | mod_ssl |
| Configure various SSL engine run-time options | |
| XBitHack | mod_include |
| Parse SSI directives in files with the execute bit set | |
Apache HTTP Server Version 2.4
| Description: | Multi-Processing Module implementing a hybrid multi-threaded multi-process web server |
|---|---|
| Status: | MPM |
| Module Identifier: | mpm_worker_module |
| Source File: | worker.c |
This Multi-Processing Module (MPM) implements a hybrid multi-process multi-threaded server. By using threads to serve requests, it is able to serve a large number of requests with fewer system resources than a process-based server. However, it retains much of the stability of a process-based server by keeping multiple processes available, each with many threads.
The most important directives used to control this MPM are
ThreadsPerChild, which
controls the number of threads deployed by each child process and
MaxRequestWorkers, which
controls the maximum total number of threads that may be
launched.
CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers ThreadLimit ThreadsPerChild ThreadStackSize UserA single control process (the parent) is responsible for launching
child processes. Each child process creates a fixed number of server
threads as specified in the ThreadsPerChild directive, as well
as a listener thread which listens for connections and passes them
to a server thread for processing when they arrive.
Apache HTTP Server always tries to maintain a pool of spare or
idle server threads, which stand ready to serve incoming
requests. In this way, clients do not need to wait for a new
threads or processes to be created before their requests can be
served. The number of processes that will initially launch is
set by the StartServers
directive. During operation, the server assesses the total number
of idle threads in all processes, and forks or kills processes to
keep this number within the boundaries specified by MinSpareThreads and MaxSpareThreads. Since this
process is very self-regulating, it is rarely necessary to modify
these directives from their default values. The maximum number of
clients that may be served simultaneously (i.e., the maximum total
number of threads in all processes) is determined by the
MaxRequestWorkers directive.
The maximum number of active child processes is determined by
the MaxRequestWorkers
directive divided by the
ThreadsPerChild directive.
Two directives set hard limits on the number of active child
processes and the number of server threads in a child process,
and can only be changed by fully stopping the server and then
starting it again. ServerLimit
is a hard limit on the number of active child
processes, and must be greater than or equal to the
MaxRequestWorkers
directive divided by the
ThreadsPerChild directive.
ThreadLimit is a hard
limit of the number of server threads, and must be greater than
or equal to the ThreadsPerChild directive.
In addition to the set of active child processes, there may
be additional child processes which are terminating, but where at
least one server thread is still handling an existing client
connection. Up to MaxRequestWorkers terminating processes
may be present, though the actual number can be expected to be
much smaller. This behavior can be avoided by disabling the
termination of individual child processes, which is achieved using
the following:
MaxConnectionsPerChild to zero
MaxSpareThreads to the same value as
MaxRequestWorkersA typical configuration of the process-thread controls in
the worker MPM could look as follows:
ServerLimit 16 StartServers 2 MaxRequestWorkers 150 MinSpareThreads 25 MaxSpareThreads 75 ThreadsPerChild 25
While the parent process is usually started as root
under Unix in order to bind to port 80, the child processes and threads
are launched by the server as a less-privileged user. The User and Group directives are used to set
the privileges of the Apache HTTP Server child processes. The child processes
must be able to read all the content that will be served, but
should have as few privileges beyond that as possible. In
addition, unless suexec is used,
these directives also set the privileges which will be inherited
by CGI scripts.
MaxConnectionsPerChild
controls how frequently the server recycles processes by killing
old ones and launching new ones.
This MPM uses the mpm-accept mutex to serialize
access to incoming connections when subject to the thundering herd
problem (generally, when there are multiple listening sockets).
The implementation aspects of this mutex can be configured with the
Mutex directive. The performance hints
documentation has additional information about this mutex.
Apache HTTP Server Version 2.4
| Description: | A variant of the worker MPM with the goal
of consuming threads only for connections with active processing |
|---|---|
| Status: | MPM |
| Module Identifier: | mpm_event_module |
| Source File: | event.c |
The event Multi-Processing Module (MPM) is
designed to allow more requests to be served simultaneously by
passing off some processing work to the listeners threads, freeing up
the worker threads to serve new requests.
To use the event MPM, add
--with-mpm=event to the configure
script's arguments when building the httpd.
AsyncRequestWorkerFactor CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareThreads MinSpareThreads PidFile ScoreBoardFile SendBufferSize ServerLimit StartServers ThreadLimit ThreadsPerChild ThreadStackSize Userevent is based on the worker MPM, which implements a hybrid
multi-process multi-threaded server. A single control process (the parent) is responsible for launching
child processes. Each child process creates a fixed number of server
threads as specified in the ThreadsPerChild directive, as well
as a listener thread which listens for connections and passes them to a worker thread for processing when they arrive.
Run-time configuration directives are identical to those provided by worker, with the only addition
of the AsyncRequestWorkerFactor.
This MPM tries to fix the 'keep alive problem' in HTTP. After a client completes the first request, it can keep the connection open, sending further requests using the same socket and saving significant overhead in creating TCP connections. However, Apache HTTP Server traditionally keeps an entire child process/thread waiting for data from the client, which brings its own disadvantages. To solve this problem, this MPM uses a dedicated listener thread for each process to handle both the Listening sockets, all sockets that are in a Keep Alive state, sockets where the handler and protocol filters have done their work and the ones where the only remaining thing to do is send the data to the client.
This new architecture, leveraging non-blocking sockets and modern kernel
features exposed by APR (like Linux's epoll),
no longer requires the mpm-accept Mutex
configured to avoid the thundering herd problem.
The total amount of connections that a single process/threads block can handle is regulated
by the AsyncRequestWorkerFactor directive.
Async connections would need a fixed dedicated worker thread with the previous MPMs but not with event.
The status page of mod_status shows new columns under the Async connections section:
write() to the socket returns EWOULDBLOCK or EAGAIN to become writable again after an idle time.
The worker holding the socket might be able to offload the waiting task to the listener thread, that in turn will re-assign it to the first idle worker thread available once an event will be raised for the socket (for example, "the socket is now writable").
Please check the Limitations section for more information.
KeepAliveTimeout occurs then the socket will be
closed by the listener. In this way, the worker threads are not responsible for idle
sockets, and they can be re-used to serve other requests.These improvements are valid for both HTTP/HTTPS connections.
This mpm showed some scalability bottlenecks in the past, leading to the following
error: "scoreboard is full, not at MaxRequestWorkers".
MaxRequestWorkers
limits the number of simultaneous requests that will be served at any given time
and also the number of allowed processes
(MaxRequestWorkers
/ ThreadsPerChild); meanwhile,
the Scoreboard is a representation of all the running processes and
the status of their worker threads. If the scoreboard is full (so all the
threads have a state that is not idle) but the number of active requests
served is not MaxRequestWorkers,
it means that some of them are blocking new requests that could be served
but that are queued instead (up to the limit imposed by
ListenBacklog). Most of the time,
the threads are stuck in the Graceful state, namely they are waiting to
finish their work with a TCP connection to safely terminate and free up a
scoreboard slot (for example, handling long-running requests, slow clients
or connections with keep-alive enabled). Two scenarios are very common:
MaxSpareThreads).
This is particularly problematic because when the load increases again,
httpd will try to start new processes.
If the pattern repeats, the number of processes can rise quite a bit,
ending up in a mixture of old processes trying to stop and new ones
trying to do some work.
From 2.4.24 onward, mpm-event is smarter and it is able to handle graceful terminations in a much better way. Some of the improvements are:
ServerLimit.
MaxRequestWorkers and
ThreadsPerChild are used
to limit the amount of active processes; meanwhile,
ServerLimit
takes also into account the ones doing a graceful
close to allow extra slots when needed. The idea is to use
ServerLimit to instruct httpd
about how many overall processes are tolerated before impacting
the system resources.
The behavior described in the last point is completely observable via
mod_status in the connection summary table through two new
columns: "Slot" and "Stopping". The former indicates the PID and
the latter if the process is stopping or not; the extra state "Yes (old gen)"
indicates a process still running after a graceful restart.
The improved connection handling may not work for certain connection
filters that have declared themselves as incompatible with event. In these
cases, this MPM will fall back to the behavior of the
worker MPM and reserve one worker thread per connection.
All modules shipped with the server are compatible with the event MPM.
A similar restriction is currently present for requests involving an
output filter that needs to read and/or modify the whole response body.
If the connection to the client blocks while the filter is processing the
data, and the amount of data produced by the filter is too big to be
buffered in memory, the thread used for the request is not freed while
httpd waits until the pending data is sent to the client.
To illustrate this point, we can think about the following two situations:
serving a static asset (like a CSS file) versus serving content retrieved from
FCGI/CGI or a proxied server. The former is predictable, namely the event MPM
has full visibility on the end of the content and it can use events: the worker
thread serving the response content can flush the first bytes until EWOULDBLOCK
or EAGAIN is returned, delegating the rest to the listener. This one in turn
waits for an event on the socket and delegates the work to flush the rest of the content
to the first idle worker thread. Meanwhile in the latter example (FCGI/CGI/proxied content),
the MPM can't predict the end of the response and a worker thread has to finish its work
before returning the control to the listener. The only alternative is to buffer the
response in memory, but it wouldn't be the safest option for the sake of the
server's stability and memory footprint.
The event model was made possible by the introduction of new APIs into the supported operating systems:
Before these new APIs where made available, the traditional select and poll APIs had to be used.
Those APIs get slow if used to handle many connections or if the set of connections rate of change is high.
The new APIs allow to monitor many more connections, and they perform way better when the set of connections to monitor changes frequently. So these APIs made it possible to write the event MPM, that scales much better with the typical HTTP pattern of many idle connections.
The MPM assumes that the underlying apr_pollset
implementation is reasonably threadsafe. This enables the MPM to
avoid excessive high level locking, or having to wake up the listener
thread in order to send it a keep-alive socket. This is currently
only compatible with KQueue and EPoll.
This MPM depends on APR's atomic
compare-and-swap operations for thread synchronization. If you are
compiling for an x86 target and you don't need to support 386s, or
you are compiling for a SPARC and you don't need to run on
pre-UltraSPARC chips, add
--enable-nonportable-atomics=yes to the
configure script's arguments. This will cause
APR to implement atomic operations using efficient opcodes not
available in older CPUs.
This MPM does not perform well on older platforms which lack good threading, but the requirement for EPoll or KQueue makes this moot.
libkse (see man libmap.conf).glibc has been compiled
with support for EPoll.| Description: | Limit concurrent connections per process |
|---|---|
| Syntax: | AsyncRequestWorkerFactor factor |
| Default: | 2 |
| Context: | server config |
| Status: | MPM |
| Module: | event |
| Compatibility: | Available in version 2.3.13 and later |
The event MPM handles some connections in an asynchronous way, where request worker threads are only allocated for short periods of time as needed, and other connections with one request worker thread reserved per connection. This can lead to situations where all workers are tied up and no worker thread is available to handle new work on established async connections.
To mitigate this problem, the event MPM does two things:
This directive can be used to fine-tune the per-process connection limit. A process will only accept new connections if the current number of connections (not counting connections in the "closing" state) is lower than:
ThreadsPerChild +
(AsyncRequestWorkerFactor *
number of idle workers)
An estimation of the maximum concurrent connections across all the processes given an average value of idle worker threads can be calculated with:
(ThreadsPerChild +
(AsyncRequestWorkerFactor *
number of idle workers)) *
ServerLimit
ThreadsPerChild = 10
ServerLimit = 4
AsyncRequestWorkerFactor = 2
MaxRequestWorkers = 40
idle_workers = 4 (average for all the processes to keep it simple)
max_connections = (ThreadsPerChild + (AsyncRequestWorkerFactor * idle_workers)) * ServerLimit
= (10 + (2 * 4)) * 4 = 72
When all the worker threads are idle, then absolute maximum numbers of concurrent connections can be calculared in a simpler way:
(AsyncRequestWorkerFactor + 1) *
MaxRequestWorkers
ThreadsPerChild = 10 ServerLimit = 4 MaxRequestWorkers = 40 AsyncRequestWorkerFactor = 2
If all the processes have all threads idle then:
idle_workers = 10
We can calculate the absolute maximum numbers of concurrent connections in two ways:
max_connections = (ThreadsPerChild + (AsyncRequestWorkerFactor * idle_workers)) * ServerLimit
= (10 + (2 * 10)) * 4 = 120
max_connections = (AsyncRequestWorkerFactor + 1) * MaxRequestWorkers
= (2 + 1) * 40 = 120
Tuning AsyncRequestWorkerFactor requires knowledge about the traffic handled by httpd in each specific use case, so changing the default value requires extensive testing and data gathering from mod_status.
MaxRequestWorkers was called
MaxClients prior to version 2.3.13. The above value
shows that the old name did not accurately describe its meaning for the event MPM.
AsyncRequestWorkerFactor can take non-integer
arguments, e.g "1.5".
Apache HTTP Server Version 2.4
| Description: | Multi-Processing Module optimized for Windows NT. |
|---|---|
| Status: | MPM |
| Module Identifier: | mpm_winnt_module |
| Source File: | mpm_winnt.c |
This Multi-Processing Module (MPM) is the default for the Windows NT operating systems. It uses a single control process which launches a single child process which in turn creates threads to handle requests
Capacity is configured using the
ThreadsPerChild directive,
which sets the maximum number of concurrent client connections.
By default, this MPM uses advanced Windows APIs for accepting new client connections. In some configurations, third-party products may interfere with this implementation, with the following messages written to the web server log:
Child: Encountered too many AcceptEx faults accepting client connections.
winnt_mpm: falling back to 'AcceptFilter none'.
The MPM falls back to a safer implementation, but some client requests
were not processed correctly. In order to avoid this error, use
AcceptFilter with accept filter
none.
AcceptFilter http none AcceptFilter https none
In Apache httpd 2.0 and 2.2,
Win32DisableAcceptEx was used for this purpose.
The WinNT MPM differs from the Unix MPMs such as worker and event in several areas:
MaxConnectionsPerChild,
active requests in the exiting process have
TimeOut seconds to finish before
processing is aborted. Alternate types of restart and shutdown are not
implemented.MaxConnectionsPerChild,
any pending changes to the configuration will become active in the
child at that point, and the parent and child will be using a
different configuration. If planned configuration changes have been
partially implemented and the current configuration cannot be
parsed, the replacement child process cannot start up and the server
will halt. Because of this behavior, configuration files should not
be changed until the time of a server restart.monitor and fatal_exception hooks
are not currently implemented.AcceptFilter is implemented in the MPM
and has a different type of control over handling of new connections.
(Refer to the AcceptFilter
documentation for details.) AcceptFilter CoreDumpDirectory Listen ListenBacklog MaxConnectionsPerChild MaxMemFree PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ThreadLimit ThreadsPerChild ThreadStackSizeApache HTTP Server Version 2.4
| Description: | Implements a non-threaded, pre-forking web server |
|---|---|
| Status: | MPM |
| Module Identifier: | mpm_prefork_module |
| Source File: | prefork.c |
This Multi-Processing Module (MPM) implements a non-threaded, pre-forking web server. Each server process may answer incoming requests, and a parent process manages the size of the server pool. It is appropriate for sites that need to avoid threading for compatibility with non-thread-safe libraries. It is also the best MPM for isolating each request, so that a problem with a single request will not affect any other.
This MPM is very self-regulating, so it is rarely necessary to
adjust its configuration directives. Most important is that
MaxRequestWorkers be big enough
to handle as many simultaneous requests as you expect to receive, but
small enough to assure that there is enough physical RAM for all
processes.
CoreDumpDirectory EnableExceptionHook Group Listen ListenBacklog MaxConnectionsPerChild MaxMemFree MaxRequestWorkers MaxSpareServers MinSpareServers PidFile ReceiveBufferSize ScoreBoardFile SendBufferSize ServerLimit StartServers UserA single control process is responsible for launching child processes which listen for connections and serve them when they arrive. Apache httpd always tries to maintain several spare or idle server processes, which stand ready to serve incoming requests. In this way, clients do not need to wait for a new child processes to be forked before their requests can be served.
The StartServers,
MinSpareServers,
MaxSpareServers, and
MaxRequestWorkers regulate how
the parent process creates children to serve requests. In general,
Apache httpd is very self-regulating, so most sites do not need to
adjust these directives from their default values. Sites which
need to serve more than 256 simultaneous requests may need to
increase MaxRequestWorkers,
while sites with limited memory may need to decrease MaxRequestWorkers to keep the server from
thrashing (swapping memory to disk and back). More information
about tuning process creation is provided in the performance hints
documentation.
While the parent process is usually started as root
under Unix in order to bind to port 80, the child processes are
launched by Apache httpd as a less-privileged user. The User and Group directives are used to set
the privileges of the Apache httpd child processes. The child processes
must be able to read all the content that will be served, but
should have as few privileges beyond that as possible.
MaxConnectionsPerChild
controls how frequently the server recycles processes by killing
old ones and launching new ones.
This MPM uses the mpm-accept mutex to serialize
access to incoming connections when subject to the thundering herd
problem (generally, when there are multiple listening sockets).
The implementation aspects of this mutex can be configured with the
Mutex directive. The performance hints
documentation has additional information about this mutex.
| Description: | Maximum number of idle child server processes |
|---|---|
| Syntax: | MaxSpareServers number |
| Default: | MaxSpareServers 10 |
| Context: | server config |
| Status: | MPM |
| Module: | prefork |
The MaxSpareServers directive sets the
desired maximum number of idle child server processes. An
idle process is one which is not handling a request. If there are
more than MaxSpareServers idle, then the
parent process will kill off the excess processes.
Tuning of this parameter should only be necessary on very
busy sites. Setting this parameter to a large number is almost
always a bad idea. If you are trying to set the value equal to or lower than
MinSpareServers, Apache HTTP Server
will automatically adjust it to MinSpareServers + 1.
| Description: | Minimum number of idle child server processes |
|---|---|
| Syntax: | MinSpareServers number |
| Default: | MinSpareServers 5 |
| Context: | server config |
| Status: | MPM |
| Module: | prefork |
The MinSpareServers directive sets the
desired minimum number of idle child server processes. An
idle process is one which is not handling a request. If there are
fewer than MinSpareServers idle, then the parent
process creates new children: It will spawn one, wait a second, then spawn
two, wait a second, then spawn four, and it will
continue exponentially until it is spawning 32 children per second. It will
stop whenever it satisfies the MinSpareServers
setting.
Tuning of this parameter should only be necessary on very busy sites. Setting this parameter to a large number is almost always a bad idea.
Apache HTTP Server Version 2.4
This document describes the terms that are used to describe each Apache configuration directive.
A brief description of the purpose of the directive.
This indicates the format of the directive as it would appear in a configuration file. This syntax is extremely directive-specific, and is described in detail in the directive's definition. Generally, the directive name is followed by a series of one or more space-separated arguments. If an argument contains a space, the argument must be enclosed in double quotes. Optional arguments are enclosed in square brackets. Where an argument can take on more than one possible value, the possible values are separated by vertical bars "|". Literal text is presented in the default font, while argument-types for which substitution is necessary are emphasized. Directives which can take a variable number of arguments will end in "..." indicating that the last argument is repeated.
Directives use a great number of different argument types. A few common ones are defined below.
http://www.example.com/path/to/file.html/path/to/file.html. The
url-path represents a web-view of a resource, as
opposed to a file-system view./usr/local/apache/htdocs/path/to/file.html.
Unless otherwise specified, a file-path which does
not begin with a slash will be treated as relative to the ServerRoot./usr/local/apache/htdocs/path/to/.file.html.file.html.en
contains two extensions: .html and
.en. For Apache directives, you may specify
extensions with or without the leading dot. In
addition, extensions are not case sensitive.text/html.If the directive has a default value (i.e., if you omit it from your configuration entirely, the Apache Web server will behave as though you set it to a particular value), it is described here. If there is no default value, this section should say "None". Note that the default listed here is not necessarily the same as the value the directive takes in the default httpd.conf distributed with the server.
This indicates where in the server's configuration files the directive is legal. It's a comma-separated list of one or more of the following values:
httpd.conf), but
not within any
<VirtualHost>
or <Directory>
containers. It is not allowed in .htaccess files
at all.<VirtualHost>
containers in the server
configuration files.<Directory>, <Location>, <Files>, <If>, and <Proxy> containers
in the server configuration files, subject to the restrictions
outlined in Configuration
Sections..htaccess files. It may not be processed, though
depending upon the overrides currently active.The directive is only allowed within the designated context; if you try to use it elsewhere, you'll get a configuration error that will either prevent the server from handling requests in that context correctly, or will keep the server from operating at all -- i.e., the server won't even start.
The valid locations for the directive are actually the
result of a Boolean OR of all of the listed contexts. In other
words, a directive that is marked as being valid in
"server config, .htaccess" can be used in the
httpd.conf file and in .htaccess
files, but not within any <Directory> or
<VirtualHost>
containers.
This directive attribute indicates which configuration
override must be active in order for the directive to be
processed when it appears in a .htaccess file. If
the directive's context
doesn't permit it to appear in .htaccess files,
then no context will be listed.
Overrides are activated by the AllowOverride directive, and apply
to a particular scope (such as a directory) and all
descendants, unless further modified by other
AllowOverride directives at
lower levels. The documentation for that directive also lists the
possible override names available.
This indicates how tightly bound into the Apache Web server the directive is; in other words, you may need to recompile the server with an enhanced set of modules in order to gain access to the directive and its functionality. Possible values for this attribute are:
This quite simply lists the name of the source module which defines the directive.
If the directive wasn't part of the original Apache version 2 distribution, the version in which it was introduced should be listed here. In addition, if the directive is available only on certain platforms, it will be noted here.
Apache HTTP Server Version 2.4
| Description: | Execute CGI scripts based on media type or request method. |
|---|---|
| Status: | Base |
| Module Identifier: | actions_module |
| Source File: | mod_actions.c |
This module has two directives. The Action directive lets you run CGI
scripts whenever a file of a certain MIME content type is requested. The
Script directive lets
you run CGI scripts whenever a particular method is used in a
request. This makes it much easier to execute scripts that process
files.
| Description: | Activates a CGI script for a particular handler or content-type |
|---|---|
| Syntax: | Action action-type cgi-script [virtual] |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_actions |
| Compatibility: | The virtual modifier and handler passing were
introduced in Apache 2.1 |
This directive adds an action, which will activate
cgi-script when action-type is triggered by
the request. The cgi-script is the URL-path to a
resource that has been designated as a CGI script using ScriptAlias or AddHandler. The
action-type can be either a handler or a MIME content type. It sends the URL and
file path of the requested document using the standard CGI
PATH_INFO and PATH_TRANSLATED
environment variables. The handler used for the particular request
is passed using the REDIRECT_HANDLER variable.
# Requests for files of a particular MIME content type: Action image/gif /cgi-bin/images.cgi
In this example, requests for files with a MIME content
type of image/gif will be handled by the
specified cgi script /cgi-bin/images.cgi.
# Files of a particular file extension AddHandler my-file-type .xyz Action my-file-type "/cgi-bin/program.cgi"
In this example, requests for files with a file extension of
.xyz are handled by the specified cgi script
/cgi-bin/program.cgi.
The optional virtual modifier turns off the check
whether the requested file really exists. This is useful, for example,
if you want to use the Action directive in
virtual locations.
<Location "/news">
SetHandler news-handler
Action news-handler "/cgi-bin/news.cgi" virtual
</Location>
| Description: | Activates a CGI script for a particular request method. |
|---|---|
| Syntax: | Script method cgi-script |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_actions |
This directive adds an action, which will activate
cgi-script when a file is requested using the method of
method. The cgi-script is the URL-path to a
resource that has been designated as a CGI script using ScriptAlias or AddHandler. The URL and
file path of the requested document is sent using the standard CGI
PATH_INFO and PATH_TRANSLATED environment
variables.
Script PUT and
Script put have two entirely different
effects.
Note that the Script command defines default
actions only. If a CGI script is called, or some other resource that is
capable of handling the requested method internally, it will do
so. Also note that Script with a method of
GET will only be called if there are query arguments present
(e.g., foo.html?hi). Otherwise, the request will
proceed normally.
# All GET requests go here Script GET "/cgi-bin/search" # A CGI PUT handler Script PUT "/~bob/put.cgi"
Apache HTTP Server Version 2.4
| Description: | Group authorizations based on host (name or IP address) |
|---|---|
| Status: | Extension |
| Module Identifier: | access_compat_module |
| Source File: | mod_access_compat.c |
| Compatibility: | Available in Apache HTTP Server 2.3 as a compatibility module with
previous versions of Apache httpd 2.x. The directives provided by this module
have been deprecated by the new authz refactoring. Please see
mod_authz_host |
The directives provided by mod_access_compat are
used in <Directory>,
<Files>, and
<Location> sections
as well as .htaccess
files to control access to particular parts of the server.
Access can be controlled based on the client hostname, IP address, or
other characteristics of the client request, as captured in environment variables. The Allow and Deny directives are used to
specify which clients are or are not allowed access to the server,
while the Order
directive sets the default access state, and configures how the
Allow and Deny directives interact with each
other.
Both host-based access restrictions and password-based
authentication may be implemented simultaneously. In that case,
the Satisfy directive is used
to determine how the two sets of restrictions interact.
The directives provided by mod_access_compat have
been deprecated by mod_authz_host.
Mixing old directives like Order, Allow or Deny with new ones like
Require is technically possible
but discouraged. This module was created to support
configurations containing only old directives to facilitate the 2.4 upgrade.
Please check the upgrading guide for more
information.
In general, access restriction directives apply to all
access methods (GET, PUT,
POST, etc). This is the desired behavior in most
cases. However, it is possible to restrict some methods, while
leaving other methods unrestricted, by enclosing the directives
in a <Limit> section.
When any directive provided by this module is used in a new configuration section, no directives provided by this module are inherited from previous configuration sections.
| Description: | Controls which hosts can access an area of the server |
|---|---|
| Syntax: | Allow from all|host|env=[!]env-variable
[host|env=[!]env-variable] ... |
| Context: | directory, .htaccess |
| Override: | Limit |
| Status: | Extension |
| Module: | mod_access_compat |
The Allow directive affects which hosts can
access an area of the server. Access can be controlled by
hostname, IP address, IP address range, or by other
characteristics of the client request captured in environment
variables.
The first argument to this directive is always
from. The subsequent arguments can take three
different forms. If Allow from all is specified, then
all hosts are allowed access, subject to the configuration of the
Deny and Order directives as discussed
below. To allow only particular hosts or groups of hosts to access
the server, the host can be specified in any of the
following formats:
Allow from example.org Allow from .net example.edu
Hosts whose names match, or end in, this string are allowed
access. Only complete components are matched, so the above
example will match foo.example.org but it will not
match fooexample.org. This configuration will cause
Apache httpd to perform a double DNS lookup on the client IP
address, regardless of the setting of the HostnameLookups directive. It will do
a reverse DNS lookup on the IP address to find the associated
hostname, and then do a forward lookup on the hostname to assure
that it matches the original IP address. Only if the forward
and reverse DNS are consistent and the hostname matches will
access be allowed.
Allow from 10.1.2.3 Allow from 192.168.1.104 192.168.1.205
An IP address of a host allowed access
Allow from 10.1 Allow from 10 172.20 192.168.2
The first 1 to 3 bytes of an IP address, for subnet restriction.
Allow from 10.1.0.0/255.255.0.0
A network a.b.c.d, and a netmask w.x.y.z. For more fine-grained subnet restriction.
Allow from 10.1.0.0/16
Similar to the previous case, except the netmask consists of nnn high-order 1 bits.
Note that the last three examples above match exactly the same set of hosts.
IPv6 addresses and IPv6 subnets can be specified as shown below:
Allow from 2001:db8::a00:20ff:fea7:ccea Allow from 2001:db8::a00:20ff:fea7:ccea/10
The third format of the arguments to the
Allow directive allows access to the server
to be controlled based on the existence of an environment variable. When Allow from
env=env-variable is specified, then the request is
allowed access if the environment variable env-variable
exists. When Allow from env=!env-variable is
specified, then the request is allowed access if the environment
variable env-variable doesn't exist.
The server provides the ability to set environment
variables in a flexible way based on characteristics of the client
request using the directives provided by
mod_setenvif. Therefore, this directive can be
used to allow access based on such factors as the clients
User-Agent (browser type), Referer, or
other HTTP request header fields.
SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in
<Directory "/docroot">
Order Deny,Allow
Deny from all
Allow from env=let_me_in
</Directory>
In this case, browsers with a user-agent string beginning
with KnockKnock/2.0 will be allowed access, and all
others will be denied.
When any directive provided by this module is used in a new configuration section, no directives provided by this module are inherited from previous configuration sections.
| Description: | Controls which hosts are denied access to the server |
|---|---|
| Syntax: | Deny from all|host|env=[!]env-variable
[host|env=[!]env-variable] ... |
| Context: | directory, .htaccess |
| Override: | Limit |
| Status: | Extension |
| Module: | mod_access_compat |
This directive allows access to the server to be restricted
based on hostname, IP address, or environment variables. The
arguments for the Deny directive are
identical to the arguments for the Allow directive.
| Description: | Controls the default access state and the order in which
Allow and Deny are
evaluated. |
|---|---|
| Syntax: | Order ordering |
| Default: | Order Deny,Allow |
| Context: | directory, .htaccess |
| Override: | Limit |
| Status: | Extension |
| Module: | mod_access_compat |
The Order directive, along with the
Allow and
Deny directives,
controls a three-pass access control system. The first pass
processes either all Allow or all Deny directives, as specified
by the Order
directive. The second pass parses the rest of the directives
(Deny or
Allow). The third
pass applies to all requests which do not match either of the first
two.
Note that all Allow and Deny directives are
processed, unlike a typical firewall, where only the first match is
used. The last match is effective (also unlike a typical firewall).
Additionally, the order in which lines appear in the configuration
files is not significant -- all Allow lines are processed as
one group, all Deny lines are considered as
another, and the default state is considered by itself.
Ordering is one of:
Allow,DenyAllow directives are
evaluated; at least one must match, or the request is rejected.
Next, all Deny
directives are evaluated. If any matches, the request is rejected.
Last, any requests which do not match an Allow or a Deny directive are denied
by default.Deny,AllowDeny directives are
evaluated; if any match, the request is denied
unless it also matches an Allow directive. Any
requests which do not match any Allow or Deny directives are
permitted.Mutual-failureOrder
Allow,Deny and is deprecated in its favor.Keywords may only be separated by a comma; no whitespace is allowed between them.
| Match | Allow,Deny result | Deny,Allow result |
|---|---|---|
| Match Allow only | Request allowed | Request allowed |
| Match Deny only | Request denied | Request denied |
| No match | Default to second directive: Denied | Default to second directive: Allowed |
| Match both Allow & Deny | Final match controls: Denied | Final match controls: Allowed |
In the following example, all hosts in the example.org domain are allowed access; all other hosts are denied access.
Order Deny,Allow Deny from all Allow from example.org
In the next example, all hosts in the example.org domain are
allowed access, except for the hosts which are in the
foo.example.org subdomain, who are denied access. All hosts not
in the example.org domain are denied access because the default
state is to Deny
access to the server.
Order Allow,Deny Allow from example.org Deny from foo.example.org
On the other hand, if the Order in the
last example is changed to Deny,Allow, all hosts will
be allowed access. This happens because, regardless of the actual
ordering of the directives in the configuration file, the
Allow from example.org will be evaluated last and will
override the Deny from foo.example.org. All hosts not in
the example.org domain will also be allowed access
because the default state is Allow.
The presence of an Order directive can
affect access to a part of the server even in the absence of
accompanying Allow
and Deny
directives because of its effect on the default access state. For
example,
<Directory "/www">
Order Allow,Deny
</Directory>
will Deny all access to the /www directory
because the default access state is set to
Deny.
The Order directive controls the order of access
directive processing only within each phase of the server's
configuration processing. This implies, for example, that an
Allow or Deny directive occurring in a
<Location> section will
always be evaluated after an Allow or Deny directive occurring in a
<Directory> section or
.htaccess file, regardless of the setting of the
Order directive. For details on the merging
of configuration sections, see the documentation on How Directory, Location and Files sections
work.
When any directive provided by this module is used in a new configuration section, no directives provided by this module are inherited from previous configuration sections.
| Description: | Interaction between host-level access control and user authentication |
|---|---|
| Syntax: | Satisfy Any|All |
| Default: | Satisfy All |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_access_compat |
| Compatibility: | Influenced by <Limit> and <LimitExcept> in version 2.0.51 and
later |
Access policy if both Allow and Require used. The parameter can be
either All or Any. This directive is only
useful if access to a particular area is being restricted by both
username/password and client host address. In this case
the default behavior (All) is to require that the client
passes the address access restriction and enters a valid
username and password. With the Any option the client will be
granted access if they either pass the host restriction or enter a
valid username and password. This can be used to password restrict
an area, but to let clients from particular addresses in without
prompting for a password.
For example, if you wanted to let people on your network have unrestricted access to a portion of your website, but require that people outside of your network provide a password, you could use a configuration similar to the following:
Require valid-user Allow from 192.168.1 Satisfy Any
Another frequent use of the Satisfy directive
is to relax access restrictions for a subdirectory:
<Directory "/var/www/private">
Require valid-user
</Directory>
<Directory "/var/www/private/public">
Allow from all
Satisfy Any
</Directory>
In the above example, authentication will be required for the
/var/www/private directory, but will not be required
for the /var/www/private/public directory.
Since version 2.0.51 Satisfy directives can
be restricted to particular methods by <Limit> and <LimitExcept> sections.
When any directive provided by this module is used in a new configuration section, no directives provided by this module are inherited from previous configuration sections.
Apache HTTP Server Version 2.4
| Description: | Easily restrict what HTTP methods can be used on the server |
|---|---|
| Status: | Experimental |
| Module Identifier: | allowmethods_module |
| Source File: | mod_allowmethods.c |
| Compatibility: | Available in Apache 2.3 and later |
This module makes it easy to restrict what HTTP methods can be used on a server. The most common configuration would be:
<Location "/"> AllowMethods GET POST OPTIONS </Location>
| Description: | Restrict access to the listed HTTP methods |
|---|---|
| Syntax: | AllowMethods reset|HTTP-method
[HTTP-method]... |
| Default: | AllowMethods reset |
| Context: | directory |
| Status: | Experimental |
| Module: | mod_allowmethods |
The HTTP-methods are case sensitive and are generally, as per
RFC, given in upper case. The GET and HEAD methods are treated as
equivalent. The reset keyword can be used to
turn off mod_allowmethods in a deeper nested context:
<Location "/svn"> AllowMethods reset </Location>
The TRACE method cannot be denied by this module;
use TraceEnable instead.
mod_allowmethods was written to replace the rather
kludgy implementation of Limit and
LimitExcept.
Apache HTTP Server Version 2.4
| Description: | User authentication using MD5 Digest Authentication |
|---|---|
| Status: | Extension |
| Module Identifier: | auth_digest_module |
| Source File: | mod_auth_digest.c |
This module implements HTTP Digest Authentication
(RFC2617), and
provides an alternative to mod_auth_basic where the
password is not transmitted as cleartext. However, this does
not lead to a significant security advantage over
basic authentication. On the other hand, the password storage on the
server is much less secure with digest authentication than with
basic authentication. Therefore, using basic auth and encrypting the
whole connection using mod_ssl is a much better
alternative.
AuthDigestAlgorithm AuthDigestDomain AuthDigestNonceLifetime AuthDigestProvider AuthDigestQop AuthDigestShmemSizeTo use MD5 Digest authentication, configure the location to be protected as shown in the below example:
<Location "/private/">
AuthType Digest
AuthName "private area"
AuthDigestDomain "/private/" "http://mirror.my.dom/private2/"
AuthDigestProvider file
AuthUserFile "/web/auth/.digest_pw"
Require valid-user
</Location>
AuthDigestDomain
should list the locations that will be protected by this
configuration.
The password file referenced in the AuthUserFile directive may be
created and managed using the htdigest tool.
Digest authentication was intended to be more secure than basic
authentication, but no longer fulfills that design goal. A
man-in-the-middle attacker can trivially force the browser to downgrade
to basic authentication. And even a passive eavesdropper can brute-force
the password using today's graphics hardware, because the hashing
algorithm used by digest authentication is too fast. Another problem is
that the storage of the passwords on the server is insecure. The contents
of a stolen htdigest file can be used directly for digest authentication.
Therefore using mod_ssl to encrypt the whole connection is
strongly recommended.
mod_auth_digest only works properly on platforms
where APR supports shared memory.
| Description: | Selects the algorithm used to calculate the challenge and response hashes in digest authentication |
|---|---|
| Syntax: | AuthDigestAlgorithm MD5|MD5-sess |
| Default: | AuthDigestAlgorithm MD5 |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_auth_digest |
The AuthDigestAlgorithm directive
selects the algorithm used to calculate the challenge and response
hashes.
MD5-sess is not correctly implemented yet.
| Description: | URIs that are in the same protection space for digest authentication |
|---|---|
| Syntax: | AuthDigestDomain URI [URI] ... |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_auth_digest |
The AuthDigestDomain directive allows
you to specify one or more URIs which are in the same protection
space (i.e. use the same realm and username/password info).
The specified URIs are prefixes; the client will assume
that all URIs "below" these are also protected by the same
username/password. The URIs may be either absolute URIs (i.e.
including a scheme, host, port, etc.) or relative URIs.
This directive should always be specified and contain at least the (set of) root URI(s) for this space. Omitting to do so will cause the client to send the Authorization header for every request sent to this server.
The URIs specified can also point to different servers, in which case clients (which understand this) will then share username/password info across multiple servers without prompting the user each time.
| Description: | How long the server nonce is valid |
|---|---|
| Syntax: | AuthDigestNonceLifetime seconds |
| Default: | AuthDigestNonceLifetime 300 |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_auth_digest |
The AuthDigestNonceLifetime directive
controls how long the server nonce is valid. When the client
contacts the server using an expired nonce the server will send
back a 401 with stale=true. If seconds is
greater than 0 then it specifies the amount of time for which the
nonce is valid; this should probably never be set to less than 10
seconds. If seconds is less than 0 then the nonce never
expires.
| Description: | Sets the authentication provider(s) for this location |
|---|---|
| Syntax: | AuthDigestProvider provider-name
[provider-name] ... |
| Default: | AuthDigestProvider file |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_auth_digest |
The AuthDigestProvider directive sets
which provider is used to authenticate the users for this location.
The default file provider is implemented
by the mod_authn_file module. Make sure
that the chosen provider module is present in the server.
See mod_authn_dbm, mod_authn_file,
mod_authn_dbd and mod_authn_socache
for providers.
| Description: | Determines the quality-of-protection to use in digest authentication |
|---|---|
| Syntax: | AuthDigestQop none|auth|auth-int [auth|auth-int] |
| Default: | AuthDigestQop auth |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_auth_digest |
The AuthDigestQop directive determines
the quality-of-protection to use. auth will
only do authentication (username/password); auth-int is
authentication plus integrity checking (an MD5 hash of the entity
is also computed and checked); none will cause the module
to use the old RFC-2069 digest algorithm (which does not include
integrity checking). Both auth and auth-int may
be specified, in which the case the browser will choose which of
these to use. none should only be used if the browser for
some reason does not like the challenge it receives otherwise.
auth-int is not implemented yet.
| Description: | The amount of shared memory to allocate for keeping track of clients |
|---|---|
| Syntax: | AuthDigestShmemSize size |
| Default: | AuthDigestShmemSize 1000 |
| Context: | server config |
| Status: | Extension |
| Module: | mod_auth_digest |
The AuthDigestShmemSize directive defines
the amount of shared memory, that will be allocated at the server
startup for keeping track of clients. Note that the shared memory
segment cannot be set less than the space that is necessary for
tracking at least one client. This value is dependent on your
system. If you want to find out the exact value, you may simply
set AuthDigestShmemSize to the value of
0 and read the error message after trying to start the
server.
The size is normally expressed in Bytes, but you
may follow the number with a K or an M to
express your value as KBytes or MBytes. For example, the following
directives are all equivalent:
AuthDigestShmemSize 1048576 AuthDigestShmemSize 1024K AuthDigestShmemSize 1M
Apache HTTP Server Version 2.4
| Description: | Core Authentication |
|---|---|
| Status: | Base |
| Module Identifier: | authn_core_module |
| Source File: | mod_authn_core.c |
| Compatibility: | Available in Apache 2.3 and later |
This module provides core authentication capabilities to
allow or deny access to portions of the web site.
mod_authn_core provides directives that are
common to all authentication providers.
Extended authentication providers can be created
within the configuration file and assigned an alias name. The alias
providers can then be referenced through the directives
AuthBasicProvider or
AuthDigestProvider in
the same way as a base authentication provider. Besides the ability
to create and alias an extended provider, it also allows the same
extended authentication provider to be reference by multiple
locations.
This example checks for passwords in two different text files.
# Check here first
<AuthnProviderAlias file file1>
AuthUserFile "/www/conf/passwords1"
</AuthnProviderAlias>
# Then check here
<AuthnProviderAlias file file2>
AuthUserFile "/www/conf/passwords2"
</AuthnProviderAlias>
<Directory "/var/web/pages/secure">
AuthBasicProvider file1 file2
AuthType Basic
AuthName "Protected Area"
Require valid-user
</Directory>
The example below creates two different ldap authentication provider aliases based on the ldap provider. This allows a single authenticated location to be serviced by multiple ldap hosts:
<AuthnProviderAlias ldap ldap-alias1>
AuthLDAPBindDN cn=youruser,o=ctx
AuthLDAPBindPassword yourpassword
AuthLDAPURL ldap://ldap.host/o=ctx
</AuthnProviderAlias>
<AuthnProviderAlias ldap ldap-other-alias>
AuthLDAPBindDN cn=yourotheruser,o=dev
AuthLDAPBindPassword yourotherpassword
AuthLDAPURL ldap://other.ldap.host/o=dev?cn
</AuthnProviderAlias>
Alias "/secure" "/webpages/secure"
<Directory "/webpages/secure">
AuthBasicProvider ldap-other-alias ldap-alias1
AuthType Basic
AuthName "LDAP Protected Place"
Require valid-user
# Note that Require ldap-* would not work here, since the
# AuthnProviderAlias does not provide the config to authorization providers
# that are implemented in the same module as the authentication provider.
</Directory>
| Description: | Authorization realm for use in HTTP authentication |
|---|---|
| Syntax: | AuthName auth-domain |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_authn_core |
This directive sets the name of the authorization realm for a
directory. This realm is given to the client so that the user
knows which username and password to send.
AuthName takes a single argument; if the
realm name contains spaces, it must be enclosed in quotation
marks. It must be accompanied by AuthType and Require directives, and directives such
as AuthUserFile and
AuthGroupFile to
work.
For example:
AuthName "Top Secret"
The string provided for the AuthName is what will
appear in the password dialog provided by most browsers.
From 2.4.55, expression syntax can be used inside the directive to produce the name dynamically.
For example:
AuthName "%{HTTP_HOST}"
| Description: | Enclose a group of directives that represent an extension of a base authentication provider and referenced by the specified alias |
|---|---|
| Syntax: | <AuthnProviderAlias baseProvider Alias>
... </AuthnProviderAlias> |
| Context: | server config |
| Status: | Base |
| Module: | mod_authn_core |
<AuthnProviderAlias> and
</AuthnProviderAlias> are used to enclose a group of
authentication directives that can be referenced by the alias name
using one of the directives
AuthBasicProvider or
AuthDigestProvider.
| Description: | Type of user authentication |
|---|---|
| Syntax: | AuthType None|Basic|Digest|Form |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_authn_core |
This directive selects the type of user authentication for a
directory. The authentication types available are None,
Basic (implemented by
mod_auth_basic), Digest
(implemented by mod_auth_digest), and
Form (implemented by mod_auth_form).
To implement authentication, you must also use the AuthName and Require directives. In addition, the
server must have an authentication-provider module such as
mod_authn_file and an authorization module such
as mod_authz_user.
The authentication type None disables authentication.
When authentication is enabled, it is normally inherited by each
subsequent configuration section,
unless a different authentication type is specified. If no
authentication is desired for a subsection of an authenticated
section, the authentication type None may be used;
in the following example, clients may access the
/www/docs/public directory without authenticating:
<Directory "/www/docs">
AuthType Basic
AuthName Documents
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
Require valid-user
</Directory>
<Directory "/www/docs/public">
AuthType None
Require all granted
</Directory>
From 2.4.55, expression syntax can be used inside the directive to specify the type dynamically.
Apache HTTP Server Version 2.4
| Description: | User authentication using text files |
|---|---|
| Status: | Base |
| Module Identifier: | authn_file_module |
| Source File: | mod_authn_file.c |
| Compatibility: | Available in Apache 2.1 and later |
This module provides authentication front-ends such as
mod_auth_digest and mod_auth_basic
to authenticate users by looking up users in plain text password files.
Similar functionality is provided by mod_authn_dbm.
When using mod_auth_basic or
mod_auth_digest, this module is invoked via the
AuthBasicProvider or
AuthDigestProvider
with the file value.
| Description: | Sets the name of a text file containing the list of users and passwords for authentication |
|---|---|
| Syntax: | AuthUserFile file-path |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_authn_file |
The AuthUserFile directive sets the name
of a textual file containing the list of users and passwords for
user authentication. File-path is the path to the user
file. If it is not absolute, it is treated as relative to the
ServerRoot.
Each line of the user file contains a username followed by
a colon, followed by the encrypted password. If the same user
ID is defined multiple times, mod_authn_file will
use the first occurrence to verify the password.
The encrypted password format depends on which authentication
frontend (e.g. mod_auth_basic or
mod_auth_digest) is being used. See Password Formats for
more information.
For mod_auth_basic, use the utility htpasswd
which is installed as part of the binary distribution, or which
can be found in src/support. See the
man page for more details.
In short:
Create a password file Filename with
username as the initial ID. It will prompt for
the password:
htpasswd -c Filename username
Add or modify username2 in the password file
Filename:
htpasswd Filename username2
Note that searching large text files is very
inefficient; AuthDBMUserFile should be used
instead.
For mod_auth_digest, use htdigest
instead. Note that you cannot mix user data for Digest Authentication
and Basic Authentication within the same file.
Make sure that the AuthUserFile is
stored outside the document tree of the web-server. Do
not put it in the directory that it protects.
Otherwise, clients may be able to download the
AuthUserFile.
Apache HTTP Server Version 2.4
| Description: | Provides for mapping different parts of the host filesystem in the document tree and for URL redirection |
|---|---|
| Status: | Base |
| Module Identifier: | alias_module |
| Source File: | mod_alias.c |
The directives contained in this module allow for manipulation
and control of URLs as requests arrive at the server. The
Alias and ScriptAlias directives are used to
map between URLs and filesystem paths. This allows for content
which is not directly under the DocumentRoot served as part of the web
document tree. The ScriptAlias directive has the
additional effect of marking the target directory as containing
only CGI scripts.
The Redirect
directives are used to instruct clients to make a new request with
a different URL. They are often used when a resource has moved to
a new location.
When the Alias,
ScriptAlias and
Redirect directives are used
within a <Location>
or <LocationMatch>
section, expression syntax can be used
to manipulate the destination path or URL.
mod_alias is designed to handle simple URL
manipulation tasks. For more complicated tasks such as
manipulating the query string, use the tools provided by
mod_rewrite.
Alias AliasMatch AliasPreservePath Redirect RedirectMatch RedirectPermanent RedirectRelative RedirectTemp ScriptAlias ScriptAliasMatchAliases and Redirects occurring in different contexts are processed
like other directives according to standard merging rules. But when multiple
Aliases or Redirects occur in the same context (for example, in the
same <VirtualHost>
section) they are processed in a particular order.
First, all Redirects are processed before Aliases are processed,
and therefore a request that matches a Redirect or RedirectMatch will never have Aliases
applied. Second, the Aliases and Redirects are processed in the order
they appear in the configuration files, with the first match taking
precedence.
For this reason, when two or more of these directives apply to the same sub-path, you must list the most specific path first in order for all the directives to have an effect. For example, the following configuration will work as expected:
Alias "/foo/bar" "/baz" Alias "/foo" "/gaq"
But if the above two directives were reversed in order, the
/foo Alias
would always match before the /foo/bar Alias, so the latter directive would be
ignored.
When the Alias,
ScriptAlias and
Redirect directives are used
within a <Location>
or <LocationMatch>
section, these directives will take precedence over any globally
defined Alias,
ScriptAlias and
Redirect directives.
| Description: | Maps URLs to filesystem locations |
|---|---|
| Syntax: | Alias [URL-path]
file-path|directory-path |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_alias |
The Alias directive allows documents to
be stored in the local filesystem other than under the
DocumentRoot. URLs with a
(%-decoded) path beginning with URL-path will be mapped
to local files beginning with directory-path. The
URL-path is case-sensitive, even on case-insensitive
file systems.
Alias "/image" "/ftp/pub/image"
A request for http://example.com/image/foo.gif would cause
the server to return the file /ftp/pub/image/foo.gif. Only
complete path segments are matched, so the above alias would not match a
request for http://example.com/imagefoo.gif. For more complex
matching using regular expressions, see the AliasMatch directive.
Note that if you include a trailing / on the URL-path then the server will require a trailing / in order to expand the alias. That is, if you use
Alias "/icons/" "/usr/local/apache/icons/"
then the URL /icons will not be aliased, as it lacks
that trailing /. Likewise, if you omit the slash on the
URL-path then you must also omit it from the
file-path.
Note that you may need to specify additional <Directory> sections which
cover the destination of aliases. Aliasing occurs before
<Directory> sections
are checked, so only the destination of aliases are affected.
(Note however <Location>
sections are run through once before aliases are performed, so
they will apply.)
In particular, if you are creating an Alias to a
directory outside of your DocumentRoot, you may need to explicitly
permit access to the target directory.
Alias "/image" "/ftp/pub/image"
<Directory "/ftp/pub/image">
Require all granted
</Directory>
Any number slashes in the URL-path parameter matches any number of slashes in the requested URL-path.
If the Alias directive is used within a
<Location>
or <LocationMatch>
section the URL-path is omitted, and the file-path is interpreted
using expression syntax.
This syntax is available in Apache 2.4.19 and later.
<Location "/image">
Alias "/ftp/pub/image"
</Location>
<LocationMatch "/error/(?<NUMBER>[0-9]+)">
Alias "/usr/local/apache/errors/%{env:MATCH_NUMBER}.html"
</LocationMatch>
Note that when the AliasPreservePath
directive is on, the full path is mapped to the destination. When
the directive is off, all URLs are mapped to the single target
URL.
# /files/foo and /files/bar mapped to /ftp/pub/files/foo and /ftp/pub/files/bar
<Location "/files">
AliasPreservePath on
Alias "/ftp/pub/files"
</Location>
# /errors/foo and /errors/bar mapped to /var/www/errors.html
<Location "/errors">
AliasPreservePath off
Alias "/var/www/errors.html"
</Location>
| Description: | Maps URLs to filesystem locations using regular expressions |
|---|---|
| Syntax: | AliasMatch regex
file-path|directory-path |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_alias |
This directive is equivalent to Alias, but makes use of
regular expressions,
instead of simple prefix matching. The
supplied regular expression is matched against the URL-path, and
if it matches, the server will substitute any parenthesized
matches into the given string and use it as a filename. For
example, to activate the /icons directory, one might
use:
AliasMatch "^/icons(/|$)(.*)" "/usr/local/apache/icons$1$2"
The full range of regular expression power is available. For example, it is possible to construct an alias with case-insensitive matching of the URL-path:
AliasMatch "(?i)^/image(.*)" "/ftp/pub/image$1"
One subtle difference
between Alias
and AliasMatch is
that Alias will
automatically copy any additional part of the URI, past the part
that matched, onto the end of the file path on the right side,
while AliasMatch will
not. This means that in almost all cases, you will want the
regular expression to match the entire request URI from beginning
to end, and to use substitution on the right side.
In other words, just changing
Alias to
AliasMatch will not
have the same effect. At a minimum, you need to
add ^ to the beginning of the regular expression
and add (.*)$ to the end, and add $1 to
the end of the replacement.
For example, suppose you want to replace this with AliasMatch:
Alias "/image/" "/ftp/pub/image/"
This is NOT equivalent - don't do this! This will send all requests that have /image/ anywhere in them to /ftp/pub/image/:
AliasMatch "/image/" "/ftp/pub/image/"
This is what you need to get the same effect:
AliasMatch "^/image/(.*)$" "/ftp/pub/image/$1"
Of course, there's no point in
using AliasMatch
where Alias would
work. AliasMatch lets
you do more complicated things. For example, you could
serve different kinds of files from different directories:
AliasMatch "^/image/(.*)\.jpg$" "/files/jpg.images/$1.jpg" AliasMatch "^/image/(.*)\.gif$" "/files/gif.images/$1.gif"
Multiple leading slashes in the requested URL are discarded by the server before directives from this module compares against the requested URL-path.
| Description: | Map the full path after the alias in a location. |
|---|---|
| Syntax: | AliasPreservePath OFF|ON |
| Default: | AliasPreservePath OFF |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_alias |
| Compatibility: | 2.4.58 and later |
When using the two parameter version of the
Alias directive, the full path after the alias
is preserved. When using the one parameter version of the
Alias directive inside a
Location directive, the full path is dropped,
and all URLs are mapped to the target expression.
To make the one parameter version of the
Alias directive preserve paths in the same way
that the two parameter version of the Alias
directive, enable this setting.
| Description: | Sends an external redirect asking the client to fetch a different URL |
|---|---|
| Syntax: | Redirect [status] [URL-path]
URL |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_alias |
The Redirect directive maps an old URL into a new one by asking
the client to refetch the resource at the new location.
The old URL-path is a case-sensitive (%-decoded) path beginning with a slash. A relative path is not allowed.
The new URL may be either an absolute URL beginning with a scheme and hostname, or a URL-path beginning with a slash. In this latter case the scheme and hostname of the current server will be added.
Then any request beginning with URL-path will return a redirect request to the client at the location of the target URL. Additional path information beyond the matched URL-path will be appended to the target URL.
# Redirect to a URL on a different host Redirect "/service" "http://foo2.example.com/service" # Redirect to a URL on the same host Redirect "/one" "/two"
If the client requests http://example.com/service/foo.txt,
it will be told to access
http://foo2.example.com/service/foo.txt
instead. This includes requests with GET parameters, such as
http://example.com/service/foo.pl?q=23&a=42,
it will be redirected to
http://foo2.example.com/service/foo.pl?q=23&a=42.
Note that POSTs will be discarded.
Only complete path segments are matched, so the above
example would not match a request for
http://example.com/servicefoo.txt. For more complex matching
using the expression syntax, omit the URL-path
argument as described below. Alternatively, for matching using regular
expressions, see the RedirectMatch directive.
Redirect directives take precedence over Alias and ScriptAlias
directives, irrespective of their ordering in the configuration
file. Redirect directives inside a Location take
precedence over Redirect and Alias directives with an URL-path.
If no status argument is given, the redirect will be "temporary" (HTTP status 302). This indicates to the client that the resource has moved temporarily. The status argument can be used to return other HTTP status codes:
Other status codes can be returned by giving the numeric
status code as the value of status. If the status is
between 300 and 399, the URL argument must be present.
If the status is not between 300 and 399, the
URL argument must be omitted. The status must be a valid
HTTP status code, known to the Apache HTTP Server (see the function
send_error_response in http_protocol.c).
Redirect permanent "/one" "http://example.com/two" Redirect 303 "/three" "http://example.com/other"
If the Redirect directive is used within a
<Location>
or <LocationMatch>
section with the URL-path omitted, then the URL parameter
will be interpreted using expression syntax.
This syntax is available in Apache 2.4.19 and later.
<Location "/one">
Redirect permanent "http://example.com/two"
</Location>
<Location "/three">
Redirect 303 "http://example.com/other"
</Location>
<LocationMatch "/error/(?<NUMBER>[0-9]+)">
Redirect permanent "http://example.com/errors/%{env:MATCH_NUMBER}.html"
</LocationMatch>
| Description: | Sends an external redirect based on a regular expression match of the current URL |
|---|---|
| Syntax: | RedirectMatch [status] regex
URL |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_alias |
This directive is equivalent to Redirect, but makes use of
regular expressions,
instead of simple prefix matching. The
supplied regular expression is matched against the URL-path, and
if it matches, the server will substitute any parenthesized
matches into the given string and use it as a filename. For
example, to redirect all GIF files to like-named JPEG files on
another server, one might use:
RedirectMatch "(.*)\.gif$" "http://other.example.com$1.jpg"
The considerations related to the difference between
Alias and
AliasMatch
also apply to the difference between
Redirect and
RedirectMatch.
See AliasMatch for
details.
| Description: | Sends an external permanent redirect asking the client to fetch a different URL |
|---|---|
| Syntax: | RedirectPermanent URL-path URL |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_alias |
This directive makes the client know that the Redirect is
permanent (status 301). Exactly equivalent to Redirect
permanent.
| Description: | Allows relative redirect targets. |
|---|---|
| Syntax: | RedirectRelative On|Off |
| Default: | RedirectRelative Off |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_alias |
| Compatibility: | 2.4.58 and later |
By default, if the target URL of a Redirect
directive is a relative URL beginning with a '/' character, the server
converts it to an absolute URL before responding to the client. By
setting RedirectRelative to the value "On",
the relative URL is presented to the client directly.
| Description: | Sends an external temporary redirect asking the client to fetch a different URL |
|---|---|
| Syntax: | RedirectTemp URL-path URL |
| Context: | server config, virtual host, directory, .htaccess |
| Override: | FileInfo |
| Status: | Base |
| Module: | mod_alias |
This directive makes the client know that the Redirect is
only temporary (status 302). Exactly equivalent to
Redirect temp.
| Description: | Maps a URL to a filesystem location and designates the target as a CGI script |
|---|---|
| Syntax: | ScriptAlias [URL-path]
file-path|directory-path |
| Context: | server config, virtual host, directory |
| Status: | Base |
| Module: | mod_alias |
The ScriptAlias directive has the same
behavior as the Alias
directive, except that in addition it marks the target directory
as containing CGI scripts that will be processed by mod_cgi's cgi-script handler. URLs with a case-sensitive
(%-decoded) path beginning with URL-path will be mapped
to scripts beginning with the second argument, which is a full
pathname in the local filesystem.
ScriptAlias "/cgi-bin/" "/web/cgi-bin/"
A request for http://example.com/cgi-bin/foo would cause the
server to run the script /web/cgi-bin/foo. This configuration
is essentially equivalent to:
Alias "/cgi-bin/" "/web/cgi-bin/"
<Location "/cgi-bin">
SetHandler cgi-script
Options +ExecCGI
</Location>
ScriptAlias can also be used in conjunction with
a script or handler you have. For example:
ScriptAlias "/cgi-bin/" "/web/cgi-handler.pl"
In this scenario all files requested in /cgi-bin/ will be
handled by the file you have configured, this allows you to use your own custom
handler. You may want to use this as a wrapper for CGI so that you can add
content, or some other bespoke action.
DocumentRoot in order to
avoid accidentally revealing their source code if the
configuration is ever changed. The
ScriptAlias makes this easy by mapping a
URL and designating CGI scripts at the same time. If you do
choose to place your CGI scripts in a directory already
accessible from the web, do not use
ScriptAlias. Instead, use <Directory>, SetHandler, and Options as in:
<Directory "/usr/local/apache2/htdocs/cgi-bin">
SetHandler cgi-script
Options ExecCGI
</Directory>
This is necessary since multiple URL-paths can map
to the same filesystem location, potentially bypassing the
ScriptAlias and revealing the source code
of the CGI scripts if they are not restricted by a
Directory section.If the ScriptAlias directive is used within
a <Location>
or <LocationMatch>
section with the URL-path omitted, then the URL parameter will be
interpreted using expression syntax.
This syntax is available in Apache 2.4.19 and later.
<Location "/cgi-bin">
ScriptAlias "/web/cgi-bin/"
</Location>
<LocationMatch "/cgi-bin/errors/(?<NUMBER>[0-9]+)">
ScriptAlias "/web/cgi-bin/errors/%{env:MATCH_NUMBER}.cgi"
</LocationMatch>
| Description: | Maps a URL to a filesystem location using a regular expression and designates the target as a CGI script |
|---|---|
| Syntax: | ScriptAliasMatch regex
file-path|directory-path |
| Context: | server config, virtual host |
| Status: | Base |
| Module: | mod_alias |
This directive is equivalent to ScriptAlias, but makes use of
regular expressions,
instead of simple prefix matching. The
supplied regular expression is matched against the URL-path,
and if it matches, the server will substitute any parenthesized
matches into the given string and use it as a filename. For
example, to activate the standard /cgi-bin, one
might use:
ScriptAliasMatch "^/cgi-bin(.*)" "/usr/local/apache/cgi-bin$1"
As for AliasMatch, the full range of regular expression power is available. For example, it is possible to construct an alias with case-insensitive matching of the URL-path:
ScriptAliasMatch "(?i)^/cgi-bin(.*)" "/usr/local/apache/cgi-bin$1"
The considerations related to the difference between
Alias and
AliasMatch
also apply to the difference between
ScriptAlias and
ScriptAliasMatch.
See AliasMatch for
details.
Apache HTTP Server Version 2.4
| Description: | Basic HTTP authentication |
|---|---|
| Status: | Base |
| Module Identifier: | auth_basic_module |
| Source File: | mod_auth_basic.c |
| Compatibility: | Available in Apache 2.1 and later |
This module allows the use of HTTP Basic Authentication to
restrict access by looking up users in the given providers.
HTTP Digest Authentication is provided by
mod_auth_digest. This module should
usually be combined with at least one authentication module
such as mod_authn_file and one authorization
module such as mod_authz_user.
| Description: | Sets whether authorization and authentication are passed to lower level modules |
|---|---|
| Syntax: | AuthBasicAuthoritative On|Off |
| Default: | AuthBasicAuthoritative On |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_auth_basic |
Normally, each authorization module listed in AuthBasicProvider will attempt
to verify the user, and if the user is not found in any provider,
access will be denied. Setting the
AuthBasicAuthoritative directive explicitly
to Off allows for both authentication and
authorization to be passed on to other non-provider-based modules
if there is no userID or rule
matching the supplied userID. This should only be necessary when
combining mod_auth_basic with third-party modules
that are not configured with the AuthBasicProvider
directive. When using such modules, the order of processing
is determined in the modules' source code and is not configurable.
| Description: | Fake basic authentication using the given expressions for username and password |
|---|---|
| Syntax: | AuthBasicFake off|username [password] |
| Default: | none |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_auth_basic |
| Compatibility: | Apache HTTP Server 2.4.5 and later |
The username and password specified are combined into an Authorization header, which is passed to the server or service behind the webserver. Both the username and password fields are interpreted using the expression parser, which allows both the username and password to be set based on request parameters.
If the password is not specified, the default value "password" will be used. To disable fake basic authentication for an URL space, specify "AuthBasicFake off".
In this example, we pass a fixed username and password to a backend server.
<Location "/demo">
AuthBasicFake demo demopass
</Location>
In this example, we pass the email address extracted from a client
certificate, extending the functionality of the FakeBasicAuth option
within the SSLOptions
directive. Like the FakeBasicAuth option, the password is set to the
fixed string "password".
<Location "/secure">
AuthBasicFake "%{SSL_CLIENT_S_DN_Email}"
</Location>
Extending the above example, we generate a password by hashing the email address with a fixed passphrase, and passing the hash to the backend server. This can be used to gate into legacy systems that do not support client certificates.
<Location "/secure">
AuthBasicFake "%{SSL_CLIENT_S_DN_Email}" "%{sha1:passphrase-%{SSL_CLIENT_S_DN_Email}}"
</Location>
<Location "/public">
AuthBasicFake off
</Location>
| Description: | Sets the authentication provider(s) for this location |
|---|---|
| Syntax: | AuthBasicProvider provider-name
[provider-name] ... |
| Default: | AuthBasicProvider file |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_auth_basic |
The AuthBasicProvider directive sets
which provider is used to authenticate the users for this location.
The default file provider is implemented
by the mod_authn_file module. Make sure
that the chosen provider module is present in the server.
<Location "/secure">
AuthType basic
AuthName "private area"
AuthBasicProvider dbm
AuthDBMType SDBM
AuthDBMUserFile "/www/etc/dbmpasswd"
Require valid-user
</Location>
Providers are queried in order until a provider finds a match for the requested username, at which point this sole provider will attempt to check the password. A failure to verify the password does not result in control being passed on to subsequent providers.
Providers are implemented by mod_authn_dbm,
mod_authn_file, mod_authn_dbd,
mod_authnz_ldap and mod_authn_socache.
| Description: | Check passwords against the authentication providers as if Digest Authentication was in force instead of Basic Authentication. |
|---|---|
| Syntax: | AuthBasicUseDigestAlgorithm MD5|Off |
| Default: | AuthBasicUseDigestAlgorithm Off |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_auth_basic |
| Compatibility: | Apache HTTP Server 2.4.7 and later |
Normally, when using Basic Authentication, the providers listed in
AuthBasicProvider
attempt to verify a user by checking their data stores for
a matching username and associated password. The stored passwords
are usually encrypted, but not necessarily so; each provider may
choose its own storage scheme for passwords.
When using AuthDigestProvider and Digest
Authentication, providers perform a similar check to find a matching
username in their data stores. However, unlike in the Basic
Authentication case, the value associated with each stored username
must be an encrypted string composed from the username, realm name,
and password. (See
RFC 2617, Section 3.2.2.2 for more details on the format used
for this encrypted string.)
As a consequence of the difference in the stored values between Basic and Digest Authentication, converting from Digest Authentication to Basic Authentication generally requires that all users be assigned new passwords, as their existing passwords cannot be recovered from the password storage scheme imposed on those providers which support Digest Authentication.
Setting the AuthBasicUseDigestAlgorithm directive
to MD5 will cause the user's Basic Authentication password
to be checked using the same encrypted format as for Digest
Authentication. First a string composed from the username, realm name,
and password is hashed with MD5; then the username and this encrypted
string are passed to the providers listed in
AuthBasicProvider
as if
AuthType
was set to Digest and Digest Authentication was in force.
Through the use of AuthBasicUseDigestAlgorithm
a site may switch from Digest to Basic Authentication without
requiring users to be assigned new passwords.
AuthBasicUseDigestAlgorithm
is set to MD5. Use of other providers will result
in an error response and the client will be denied access.
Apache HTTP Server Version 2.4
| Description: | Allows "anonymous" user access to authenticated areas |
|---|---|
| Status: | Extension |
| Module Identifier: | authn_anon_module |
| Source File: | mod_authn_anon.c |
| Compatibility: | Available in Apache 2.1 and later |
This module provides authentication front-ends such as
mod_auth_basic to authenticate users similar
to anonymous-ftp sites, i.e. have a 'magic' user id
'anonymous' and the email address as a password. These email
addresses can be logged.
Combined with other (database) access control methods, this allows for effective user tracking and customization according to a user profile while still keeping the site open for 'unregistered' users. One advantage of using Auth-based user tracking is that, unlike magic-cookies and funny URL pre/postfixes, it is completely browser independent and it allows users to share URLs.
When using mod_auth_basic, this module is invoked
via the AuthBasicProvider
directive with the anon value.
The example below is combined with "normal" htpasswd-file based authentication and allows users in additionally as 'guests' with the following properties:
Anonymous_NoUserID)Anonymous_MustGiveEmail)Anonymous_VerifyEmail)anonymous guest www test
welcome and comparison is not case
sensitive. (Anonymous)Anonymous_LogEmail)<Directory "/var/www/html/private">
AuthName "Use 'anonymous' & Email address for guest entry"
AuthType Basic
AuthBasicProvider file anon
AuthUserFile "/path/to/your/.htpasswd"
Anonymous_NoUserID off
Anonymous_MustGiveEmail on
Anonymous_VerifyEmail on
Anonymous_LogEmail on
Anonymous anonymous guest www test welcome
Require valid-user
</Directory>
| Description: | Specifies userIDs that are allowed access without password verification |
|---|---|
| Syntax: | Anonymous user [user] ... |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authn_anon |
A list of one or more 'magic' userIDs which are allowed access without password verification. The userIDs are space separated. It is possible to use the ' and " quotes to allow a space in a userID as well as the \ escape character.
Please note that the comparison is
case-IN-sensitive.
It's strongly recommended that the magic username
'anonymous' is always one of the allowed
userIDs.
Anonymous anonymous "Not Registered" "I don't know"
This would allow the user to enter without password verification by using the userIDs "anonymous", "AnonyMous", "Not Registered" and "I Don't Know".
As of Apache 2.1 it is possible to specify the userID as
"*". That allows any supplied userID to be
accepted.
| Description: | Sets whether the password entered will be logged in the error log |
|---|---|
| Syntax: | Anonymous_LogEmail On|Off |
| Default: | Anonymous_LogEmail On |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authn_anon |
When set On, the default, the 'password' entered
(which hopefully contains a sensible email address) is logged in
the error log.
| Description: | Specifies whether blank passwords are allowed |
|---|---|
| Syntax: | Anonymous_MustGiveEmail On|Off |
| Default: | Anonymous_MustGiveEmail On |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authn_anon |
Specifies whether the user must specify an email address as the password. This prohibits blank passwords.
| Description: | Sets whether the userID field may be empty |
|---|---|
| Syntax: | Anonymous_NoUserID On|Off |
| Default: | Anonymous_NoUserID Off |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authn_anon |
When set On, users can leave the userID (and
perhaps the password field) empty. This can be very convenient for
MS-Explorer users who can just hit return or click directly on the
OK button; which seems a natural reaction.
| Description: | Sets whether to check the password field for a correctly formatted email address |
|---|---|
| Syntax: | Anonymous_VerifyEmail On|Off |
| Default: | Anonymous_VerifyEmail Off |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authn_anon |
When set On the 'password' entered is checked for
at least one '@' and a '.' to encourage users to enter valid email
addresses (see the above Anonymous_LogEmail).
Apache HTTP Server Version 2.4
| Description: | User authentication using DBM files |
|---|---|
| Status: | Extension |
| Module Identifier: | authn_dbm_module |
| Source File: | mod_authn_dbm.c |
| Compatibility: | Available in Apache 2.1 and later |
This module provides authentication front-ends such as
mod_auth_digest and mod_auth_basic
to authenticate users by looking up users in dbm password
files. Similar functionality is provided by
mod_authn_file.
When using mod_auth_basic or
mod_auth_digest, this module is invoked via the
AuthBasicProvider or
AuthDigestProvider
with the dbm value.
| Description: | Sets the type of database file that is used to store passwords |
|---|---|
| Syntax: | AuthDBMType default|SDBM|GDBM|NDBM|DB |
| Default: | AuthDBMType default |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authn_dbm |
Sets the type of database file that is used to store the passwords. The default database type is determined at compile time. The availability of other types of database files also depends on compile-time settings.
For example, in order to enable the support for Berkeley DB
(correspondent to the db type) the
--with-berkeley-db option needs to be added to httpd's
configure to generate the necessary DSO.
It is crucial that whatever program you use to create your password files is configured to use the same type of database.
| Description: | Sets the name of a database file containing the list of users and passwords for authentication |
|---|---|
| Syntax: | AuthDBMUserFile file-path |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Extension |
| Module: | mod_authn_dbm |
The AuthDBMUserFile directive sets the
name of a DBM file containing the list of users and passwords for
user authentication. File-path is the absolute path to
the user file.
The user file is keyed on the username. The value for a user is the encrypted password, optionally followed by a colon and arbitrary data. The colon and the data following it will be ignored by the server.
Make sure that the AuthDBMUserFile is stored
outside the document tree of the web-server; do not put it in
the directory that it protects. Otherwise, clients will be able to
download the AuthDBMUserFile.
The encrypted password format depends on which authentication
frontend (e.g. mod_auth_basic or
mod_auth_digest) is being used. See Password Formats for
more information.
Important compatibility note: The implementation of
dbmopen in the Apache modules reads the string length of
the hashed values from the DBM data structures, rather than relying
upon the string being NULL-appended. Some applications, such as
the Netscape web server, rely upon the string being
NULL-appended, so if you are having trouble using DBM files
interchangeably between applications this may be a part of the
problem.
A perl script called
dbmmanage is included with
Apache. This program can be used to create and update DBM
format password files for use with this module. Another
tool for maintaining the DBM files is the included program
htdbm.
Apache HTTP Server Version 2.4
| Description: | Allows a FastCGI authorizer application to handle Apache httpd authentication and authorization |
|---|---|
| Status: | Extension |
| Module Identifier: | authnz_fcgi_module |
| Source File: | mod_authnz_fcgi.c |
| Compatibility: | Available in version 2.4.10 and later |
This module allows FastCGI authorizer applications to authenticate users and authorize access to resources. It supports generic FastCGI authorizers which participate in a single phase for authentication and authorization as well as Apache httpd-specific authenticators and authorizors which participate in one or both phases.
FastCGI authorizers can authenticate using user id and password, such as for Basic authentication, or can authenticate using arbitrary mechanisms.
The invocation modes for FastCGI authorizers supported by this module are distinguished by two characteristics, type and auth mechanism.
Type is simply authn for authentication,
authz for authorization, or authnz for
combined authentication and authorization.
Auth mechanism refers to the Apache httpd configuration
mechanisms and processing phases, and can be
AuthBasicProvider, Require, or
check_user_id. The first two of these
correspond to the directives used to enable participation in the
appropriate processing phase.
Descriptions of each mode:
authn, mechanism
AuthBasicProviderFCGI_ROLE is set to AUTHORIZER and
FCGI_APACHE_ROLE is set to AUTHENTICATOR.
The application must be defined as provider type authn
using
AuthnzFcgiDefineProvider and enabled with
AuthBasicProvider.
When invoked, the application is
expected to authenticate the client using the provided user id and
password. Example application:
#!/usr/bin/perl
use FCGI;
my $request = FCGI::Request();
while ($request->Accept() >= 0) {
die if $ENV{'FCGI_APACHE_ROLE'} ne "AUTHENTICATOR";
die if $ENV{'FCGI_ROLE'} ne "AUTHORIZER";
die if !$ENV{'REMOTE_PASSWD'};
die if !$ENV{'REMOTE_USER'};
print STDERR "This text is written to the web server error log.\n";
if ( ($ENV{'REMOTE_USER' } eq "foo" || $ENV{'REMOTE_USER'} eq "foo1") &&
$ENV{'REMOTE_PASSWD'} eq "bar" ) {
print "Status: 200\n";
print "Variable-AUTHN_1: authn_01\n";
print "Variable-AUTHN_2: authn_02\n";
print "\n";
}
else {
print "Status: 401\n\n";
}
}
Example configuration:
AuthnzFcgiDefineProvider authn FooAuthn fcgi://localhost:10102/ <Location "/protected/"> AuthType Basic AuthName "Restricted" AuthBasicProvider FooAuthn Require ... </Location>
authz, mechanism
RequireFCGI_ROLE is set to
AUTHORIZER and FCGI_APACHE_ROLE is set to
AUTHORIZER. The application must be defined as
provider type authz using
AuthnzFcgiDefineProvider. When invoked, the application
is expected to authorize the client using the provided user id and other
request data. Example application:
#!/usr/bin/perl
use FCGI;
my $request = FCGI::Request();
while ($request->Accept() >= 0) {
die if $ENV{'FCGI_APACHE_ROLE'} ne "AUTHORIZER";
die if $ENV{'FCGI_ROLE'} ne "AUTHORIZER";
die if $ENV{'REMOTE_PASSWD'};
print STDERR "This text is written to the web server error log.\n";
if ($ENV{'REMOTE_USER'} eq "foo1") {
print "Status: 200\n";
print "Variable-AUTHZ_1: authz_01\n";
print "Variable-AUTHZ_2: authz_02\n";
print "\n";
}
else {
print "Status: 403\n\n";
}
}
Example configuration:
AuthnzFcgiDefineProvider authz FooAuthz fcgi://localhost:10103/ <Location "/protected/"> AuthType ... AuthName ... AuthBasicProvider ... Require FooAuthz </Location>
authnz, mechanism
AuthBasicProvider + RequireAUTHORIZER protocol, FCGI_ROLE is set to
AUTHORIZER and FCGI_APACHE_ROLE is not set.
The application must be defined as provider type authnz
using
AuthnzFcgiDefineProvider. The application is expected to
handle both authentication and authorization in the same invocation
using the user id, password, and other request data. The invocation
occurs during the Apache httpd API authentication phase. If the
application returns 200 and the same provider is invoked during the
authorization phase (via Require), mod_authnz_fcgi
will return success for the authorization phase without invoking the
application. Example application:
#!/usr/bin/perl
use FCGI;
my $request = FCGI::Request();
while ($request->Accept() >= 0) {
die if $ENV{'FCGI_APACHE_ROLE'};
die if $ENV{'FCGI_ROLE'} ne "AUTHORIZER";
die if !$ENV{'REMOTE_PASSWD'};
die if !$ENV{'REMOTE_USER'};
print STDERR "This text is written to the web server error log.\n";
if ( ($ENV{'REMOTE_USER' } eq "foo" || $ENV{'REMOTE_USER'} eq "foo1") &&
$ENV{'REMOTE_PASSWD'} eq "bar" &&
$ENV{'REQUEST_URI'} =~ m%/bar/.*%) {
print "Status: 200\n";
print "Variable-AUTHNZ_1: authnz_01\n";
print "Variable-AUTHNZ_2: authnz_02\n";
print "\n";
}
else {
print "Status: 401\n\n";
}
}
Example configuration:
AuthnzFcgiDefineProvider authnz FooAuthnz fcgi://localhost:10103/ <Location "/protected/"> AuthType Basic AuthName "Restricted" AuthBasicProvider FooAuthnz Require FooAuthnz </Location>
authn, mechanism
check_user_idFCGI_ROLE is set to
AUTHORIZER and FCGI_APACHE_ROLE is set to
AUTHENTICATOR. The application must be defined as
provider type authn using
AuthnzFcgiDefineProvider. AuthnzFcgiCheckAuthnProvider
specifies when it is called. Example application:
#!/usr/bin/perl
use FCGI;
my $request = FCGI::Request();
while ($request->Accept() >= 0) {
die if $ENV{'FCGI_APACHE_ROLE'} ne "AUTHENTICATOR";
die if $ENV{'FCGI_ROLE'} ne "AUTHORIZER";
# This authorizer assumes that the RequireBasicAuth option of
# AuthnzFcgiCheckAuthnProvider is On:
die if !$ENV{'REMOTE_PASSWD'};
die if !$ENV{'REMOTE_USER'};
print STDERR "This text is written to the web server error log.\n";
if ( ($ENV{'REMOTE_USER' } eq "foo" || $ENV{'REMOTE_USER'} eq "foo1") &&
$ENV{'REMOTE_PASSWD'} eq "bar" ) {
print "Status: 200\n";
print "Variable-AUTHNZ_1: authnz_01\n";
print "Variable-AUTHNZ_2: authnz_02\n";
print "\n";
}
else {
print "Status: 401\n\n";
# If a response body is written here, it will be returned to
# the client.
}
}
Example configuration:
AuthnzFcgiDefineProvider authn FooAuthn fcgi://localhost:10103/
<Location "/protected/">
AuthType ...
AuthName ...
AuthnzFcgiCheckAuthnProvider FooAuthn \
Authoritative On \
RequireBasicAuth Off \
UserExpr "%{reqenv:REMOTE_USER}"
Require ...
</Location>
AUTHENTICATOR and AUTHORIZER), define
separate providers as follows, even if they map to the same
application:
AuthnzFcgiDefineProvider authn FooAuthn fcgi://localhost:10102/ AuthnzFcgiDefineProvider authz FooAuthz fcgi://localhost:10102/Specify the authn provider on
AuthBasicProvider
and the authz provider on
Require:
AuthType Basic AuthName "Restricted" AuthBasicProvider FooAuthn Require FooAuthz
AUTHORIZER role
(authentication and authorizer in one invocation), define a
single provider as follows:
AuthnzFcgiDefineProvider authnz FooAuthnz fcgi://localhost:10103/Specify the authnz provider on both
AuthBasicProvider
and Require:
AuthType Basic AuthName "Restricted" AuthBasicProvider FooAuthnz Require FooAuthnz
The following are potential features which are not currently implemented:
FCGI_APACHE_ROLE to ACCESS_CHECKER.fcgistarter can be used to
start them.
ProxyPass used with FastCGI responders.error
and higher.warn.debug.trace2. The value of the
REMOTE_PASSWD variable will be obscured,
but any other sensitive data will be visible in the
log.trace5. All
sensitive data will be visible in the log.LogLevel can be used
to configure a log level specific to mod_authnz_fcgi. For
example:
LogLevel info authnz_fcgi:trace8
| Description: | Enables a FastCGI application to handle the check_authn authentication hook. |
|---|---|
| Syntax: | AuthnzFcgiCheckAuthnProvider provider-name| |
| Default: | none |
| Context: | directory |
| Status: | Extension |
| Module: | mod_authnz_fcgi |
This directive is used to enable a FastCGI authorizer to handle a specific processing phase of authentication or authorization.
Some capabilities of FastCGI authorizers require enablement
using this directive instead of
AuthBasicProvider:
UserExpr option below
AuthnzFcgiDefineProvider.NoneNone to disable a provider enabled
with this directive in an outer scope, such as in a parent
directory.UserExpr
is configured and evaluates to an empty string (e.g., authorizer
didn't return a variable), this value will be used as the user
id. This is typically used when the authorizer has a concept of
guest, or unauthenticated, users and guest users are mapped to
some specific user id for logging and other purposes.Variable-XXX
setting returned by the authorizer using an option like
UserExpr "%{reqenv:XXX}". If
this option is specified and the user id can't be retrieved
using the expression after a successful authentication, the
request will be rejected with a 500 error.| Description: | Defines a FastCGI application as a provider for authentication and/or authorization |
|---|---|
| Syntax: | AuthnzFcgiDefineProvider type provider-name
backend-address |
| Default: | none |
| Context: | server config |
| Status: | Extension |
| Module: | mod_authnz_fcgi |
This directive is used to define a FastCGI application as a provider for a particular phase of authentication or authorization.
AuthBasicProvider
and
Require.fcgistarter.Apache HTTP Server Version 2.4
| Description: | Sends files that contain their own HTTP headers |
|---|---|
| Status: | Base |
| Module Identifier: | asis_module |
| Source File: | mod_asis.c |
This module provides the handler send-as-is
which causes Apache HTTP Server to send the document without adding most of
the usual HTTP headers.
This can be used to send any kind of data from the server, including redirects and other special HTTP responses, without requiring a cgi-script or an nph script.
For historical reasons, this module will also process any
file with the mime type httpd/send-as-is.
This module provides no directives.
In the server configuration file, associate files with the
send-as-is handler e.g.
AddHandler send-as-is asis
The contents of any file with a .asis extension
will then be sent by Apache httpd to the client with almost no
changes. In particular, HTTP headers are derived from the file
itself according to mod_cgi rules, so an asis
file must include valid headers, and may also use the CGI
Status: header to determine the HTTP response
code. The Content-Length: header will automatically
be inserted or, if included, corrected by httpd.
Here's an example of a file whose contents are sent as is so as to tell the client that a file has redirected.
Status: 301 Now where did I leave that URL
Location: http://xyz.example.com/foo/bar.html
Content-type: text/html
<html>
<head>
<title>Lame excuses'R'us</title>
</head>
<body>
<h1>Fred's exceptionally wonderful page has moved to
<a href="http://xyz.example.com/foo/bar.html">Joe's</a>
site.
</h1>
</body>
</html>
The server always adds a Date: and Server:
header to the data returned to the client, so these should not be
included in the file. The server does not add a
Last-Modified header; it probably should.
Apache HTTP Server Version 2.4
| Description: | Form authentication |
|---|---|
| Status: | Base |
| Module Identifier: | auth_form_module |
| Source File: | mod_auth_form.c |
| Compatibility: | Available in Apache 2.3 and later |
Form authentication depends on the mod_session
modules, and these modules make use of HTTP cookies, and as such can fall
victim to Cross Site Scripting attacks, or expose potentially private
information to clients. Please ensure that the relevant risks have
been taken into account before enabling the session functionality on
your server.
This module allows the use of an HTML login form to restrict access by looking up users in the given providers. HTML forms require significantly more configuration than the alternatives, however an HTML login form can provide a much friendlier experience for end users.
HTTP basic authentication is provided by
mod_auth_basic, and HTTP digest authentication is
provided by mod_auth_digest. This module should
be combined with at least one authentication module
such as mod_authn_file and one authorization
module such as mod_authz_user.
Once the user has been successfully authenticated, the user's login
details will be stored in a session provided by mod_session.
Basic Configuration Standalone Login Inline Login Inline Login with Body Preservation Logging Out Usernames and Passwords AuthFormAuthoritative AuthFormBody AuthFormDisableNoStore AuthFormFakeBasicAuth AuthFormLocation AuthFormLoginRequiredLocation AuthFormLoginSuccessLocation AuthFormLogoutLocation AuthFormMethod AuthFormMimetype AuthFormPassword AuthFormProvider AuthFormSitePassphrase AuthFormSize AuthFormUsernameTo protect a particular URL with mod_auth_form, you need to
decide where you will store your session, and you will need to
decide what method you will use to authenticate. In this simple example, the
login details will be stored in a session based on
mod_session_cookie, and authentication will be attempted against
a file using mod_authn_file. If authentication is unsuccessful,
the user will be redirected to the form login page.
<Location "/admin">
AuthFormProvider file
AuthUserFile "conf/passwd"
AuthType form
AuthName "/admin"
AuthFormLoginRequiredLocation "http://example.com/login.html"
Session On
SessionCookieName session path=/
Require valid-user
</Location>
The directive AuthType will enable
the mod_auth_form authentication when set to the value form.
The directives AuthFormProvider and
AuthUserFile specify that usernames
and passwords should be checked against the chosen file.
The directives Session and
SessionCookieName
session stored within an HTTP cookie on the browser. For more information
on the different options for configuring a session, read the documentation for
mod_session.
You can optionally add a
SessionCryptoPassphrase to
create an encrypted session cookie. This required the additional
module mod_session_crypto be loaded.
In the simple example above, a URL has been protected by
mod_auth_form, but the user has yet to be given an opportunity to
enter their username and password. Options for doing so include providing a
dedicated standalone login page for this purpose, or for providing the login
page inline.
The login form can be hosted as a standalone page, or can be provided inline on the same page.
When configuring the login as a standalone page, unsuccessful authentication
attempts should be redirected to a login form created by the website for this purpose,
using the AuthFormLoginRequiredLocation
directive. Typically this login page will contain an HTML form, asking the user to
provide their usename and password.
<form method="POST" action="/dologin.html"> Username: <input type="text" name="httpd_username" value="" /> Password: <input type="password" name="httpd_password" value="" /> <input type="submit" name="login" value="Login" /> </form>
The part that does the actual login is handled by the form-login-handler. The action of the form should point at this handler, which is configured within Apache httpd as follows:
<Location "/dologin.html">
SetHandler form-login-handler
AuthFormLoginRequiredLocation "http://example.com/login.html"
AuthFormLoginSuccessLocation "http://example.com/admin/index.html"
AuthFormProvider file
AuthUserFile "conf/passwd"
AuthType form
AuthName /admin
Session On
SessionCookieName session path=/
</Location>
The URLs specified by the
AuthFormLoginRequiredLocation directive will typically
point to a page explaining to the user that their login attempt was unsuccessful, and they
should try again. The AuthFormLoginSuccessLocation
directive specifies the URL the user should be redirected to upon successful login.
Alternatively, the URL to redirect the user to on success can be embedded within the login form, as in the example below. As a result, the same form-login-handler can be reused for different areas of a website.
<form method="POST" action="/dologin.html"> Username: <input type="text" name="httpd_username" value="" /> Password: <input type="password" name="httpd_password" value="" /> <input type="submit" name="login" value="Login" /> <input type="hidden" name="httpd_location" value="http://example.com/success.html" /> </form>
A risk exists that under certain circumstances, the login form configured using inline login may be submitted more than once, revealing login credentials to the application running underneath. The administrator must ensure that the underlying application is properly secured to prevent abuse. If in doubt, use the standalone login configuration.
As an alternative to having a dedicated login page for a website, it is possible to
configure mod_auth_form to authenticate users inline, without being
redirected to another page. This allows the state of the current page to be preserved
during the login attempt. This can be useful in a situation where a time limited
session is in force, and the session times out in the middle of the user request. The
user can be re-authenticated in place, and they can continue where they left off.
If a non-authenticated user attempts to access a page protected by
mod_auth_form that isn't configured with a
AuthFormLoginRequiredLocation directive,
a HTTP_UNAUTHORIZED status code is returned to the browser indicating to the user
that they are not authorized to view the page.
To configure inline authentication, the administrator overrides the error document returned by the HTTP_UNAUTHORIZED status code with a custom error document containing the login form, as follows:
AuthFormProvider file ErrorDocument 401 "/login.shtml" AuthUserFile "conf/passwd" AuthType form AuthName realm Session On SessionCookieName session path=/
The error document page should contain a login form with an empty action property, as per the example below. This has the effect of submitting the form to the original protected URL, without the page having to know what that URL is.
<form method="POST" action=""> Username: <input type="text" name="httpd_username" value="" /> Password: <input type="password" name="httpd_password" value="" /> <input type="submit" name="login" value="Login" /> </form>
When the end user has filled in their login details, the form will make
an HTTP POST request to the original password protected URL.
mod_auth_form will intercept this POST request, and if
HTML fields are found present for the username and password, the user
will be logged in, and the original password protected URL will be returned
to the user as a GET request.
A limitation of the inline login technique described above is that should an HTML form POST have resulted in the request to authenticate or reauthenticate, the contents of the original form posted by the browser will be lost. Depending on the function of the website, this could present significant inconvenience for the end user.
mod_auth_form addresses this by allowing the method and body
of the original request to be embedded in the login form. If authentication
is successful, the original method and body will be retried by Apache httpd, preserving
the state of the original request.
To enable body preservation, add three additional fields to the login form as per the example below.
<form method="POST" action=""> Username: <input type="text" name="httpd_username" value="" /> Password: <input type="password" name="httpd_password" value="" /> <input type="submit" name="login" value="Login" />
<input type="hidden" name="httpd_method" value="POST" /> <input type="hidden" name="httpd_mimetype" value="application/x-www-form-urlencoded" /> <input type="hidden" name="httpd_body" value="name1=value1&name2=value2" />
</form>
How the method, mimetype and body of the original request are embedded within the login form will depend on the platform and technology being used within the website.
One option is to use the mod_include module along with the
KeptBodySize directive, along with a suitable
CGI script to embed the variables in the form.
Another option is to render the login form using a CGI script or other dynamic technology.
AuthFormProvider file ErrorDocument 401 "/cgi-bin/login.cgi" ...
To enable a user to log out of a particular session, configure a page to be handled by the form-logout-handler. Any attempt to access this URL will cause the username and password to be removed from the current session, effectively logging the user out.
By setting the
AuthFormLogoutLocation directive,
a URL can be specified that the browser will be redirected to on successful
logout. This URL might explain to the user that they have been logged out, and
give the user the option to log in again.
SetHandler form-logout-handler AuthName realm AuthFormLogoutLocation "http://example.com/loggedout.html" Session On SessionCookieName session path=/
Note that logging a user out does not delete the session; it merely removes
the username and password from the session. If this results in an empty session,
the net effect will be the removal of that session, but this is not
guaranteed. If you want to guarantee the removal of a session, set the
SessionMaxAge directive to a small
value, like 1 (setting the directive to zero would mean no session age limit).
SetHandler form-logout-handler AuthFormLogoutLocation "http://example.com/loggedout.html" Session On SessionMaxAge 1 SessionCookieName session path=/
Note that form submission involves URLEncoding the form data: in this case the username and password. You should therefore pick usernames and passwords that avoid characters that are URLencoded in form submission, or you may get unexpected results.
| Description: | Sets whether authorization and authentication are passed to lower level modules |
|---|---|
| Syntax: | AuthFormAuthoritative On|Off |
| Default: | AuthFormAuthoritative On |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_auth_form |
Normally, each authorization module listed in AuthFormProvider will attempt
to verify the user, and if the user is not found in any provider,
access will be denied. Setting the
AuthFormAuthoritative directive explicitly
to Off allows for both authentication and
authorization to be passed on to other non-provider-based modules
if there is no userID or rule
matching the supplied userID. This should only be necessary when
combining mod_auth_form with third-party modules
that are not configured with the AuthFormProvider
directive. When using such modules, the order of processing
is determined in the modules' source code and is not configurable.
| Description: | The name of a form field carrying the body of the request to attempt on successful login |
|---|---|
| Syntax: | AuthFormBody fieldname |
| Default: | AuthFormBody httpd_body |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later |
The AuthFormBody directive specifies
the name of an HTML field which, if present, will contain the body of the request
to submit should login be successful.
By populating the form with fields described by
AuthFormMethod,
AuthFormMimetype and
AuthFormBody, a website can retry
a request that may have been interrupted by the login screen, or by a session
timeout.
| Description: | Disable the CacheControl no-store header on the login page |
|---|---|
| Syntax: | AuthFormDisableNoStore On|Off |
| Default: | AuthFormDisableNoStore Off |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later |
The AuthFormDisableNoStore flag
disables the sending of a Cache-Control no-store header with the
error 401 page returned when the user is not yet logged in. The purpose of the header
is to make it difficult for an ecmascript application to attempt to resubmit the
login form, and reveal the username and password to the backend application. Disable
at your own risk.
| Description: | Fake a Basic Authentication header |
|---|---|
| Syntax: | AuthFormFakeBasicAuth On|Off |
| Default: | AuthFormFakeBasicAuth Off |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later |
The AuthFormFakeBasicAuth flag
determines whether a Basic Authentication header will be added to
the request headers. This can be used to expose the username and password to
an underlying application, without the underlying application having to be aware
of how the login was achieved.
| Description: | The name of a form field carrying a URL to redirect to on successful login |
|---|---|
| Syntax: | AuthFormLocation fieldname |
| Default: | AuthFormLocation httpd_location |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later |
The AuthFormLocation directive specifies
the name of an HTML field which, if present, will contain a URL to redirect the browser to
should login be successful.
| Description: | The URL of the page to be redirected to should login be required |
|---|---|
| Syntax: | AuthFormLoginRequiredLocation url |
| Default: | none |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later. The use of the expression parser has been added in 2.4.4. |
The AuthFormLoginRequiredLocation directive
specifies the URL to redirect to should the user not be authorised to view a page. The value
is parsed using the ap_expr parser before being sent to the client.
By default, if a user is not authorised to view a page, the HTTP response code
HTTP_UNAUTHORIZED will be returned with the page specified by the
ErrorDocument directive. This directive overrides this
default.
Use this directive if you have a dedicated login page to redirect users to.
| Description: | The URL of the page to be redirected to should login be successful |
|---|---|
| Syntax: | AuthFormLoginSuccessLocation url |
| Default: | none |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later. The use of the expression parser has been added in 2.4.4. |
The AuthFormLoginSuccessLocation directive
specifies the URL to redirect to should the user have logged in successfully. The value is
parsed using the ap_expr parser before being sent to the client.
This directive can be overridden if a form field has been defined containing another URL
using the AuthFormLocation directive.
Use this directive if you have a dedicated login URL, and you have not embedded the destination page in the login form.
| Description: | The URL to redirect to after a user has logged out |
|---|---|
| Syntax: | AuthFormLogoutLocation uri |
| Default: | none |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later. The use of the expression parser has been added in 2.4.4. |
The AuthFormLogoutLocation directive
specifies the URL of a page on the server to redirect to should the user attempt to log
out. The value is parsed using the ap_expr parser before
being sent to the client.
When a URI is accessed that is served by the handler form-logout-handler,
the page specified by this directive will be shown to the end user. For example:
<Location "/logout">
SetHandler form-logout-handler
AuthFormLogoutLocation "http://example.com/loggedout.html"
Session on
#...
</Location>
An attempt to access the URI /logout/ will result in the user being logged out, and the page /loggedout.html will be displayed. Make sure that the page loggedout.html is not password protected, otherwise the page will not be displayed.
| Description: | The name of a form field carrying the method of the request to attempt on successful login |
|---|---|
| Syntax: | AuthFormMethod fieldname |
| Default: | AuthFormMethod httpd_method |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later |
The AuthFormMethod directive specifies
the name of an HTML field which, if present, will contain the method of the request
to submit should login be successful.
By populating the form with fields described by
AuthFormMethod,
AuthFormMimetype and
AuthFormBody, a website can retry
a request that may have been interrupted by the login screen, or by a session
timeout.
| Description: | The name of a form field carrying the mimetype of the body of the request to attempt on successful login |
|---|---|
| Syntax: | AuthFormMimetype fieldname |
| Default: | AuthFormMimetype httpd_mimetype |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later |
The AuthFormMimetype directive specifies
the name of an HTML field which, if present, will contain the
mimetype of the request to submit should login be successful.
By populating the form with fields described by
AuthFormMethod,
AuthFormMimetype and
AuthFormBody, a website can retry
a request that may have been interrupted by the login screen, or by a session
timeout.
| Description: | The name of a form field carrying the login password |
|---|---|
| Syntax: | AuthFormPassword fieldname |
| Default: | AuthFormPassword httpd_password |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later |
The AuthFormPassword directive specifies
the name of an HTML field which, if present, will contain the password to be used to log
in.
| Description: | Sets the authentication provider(s) for this location |
|---|---|
| Syntax: | AuthFormProvider provider-name
[provider-name] ... |
| Default: | AuthFormProvider file |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_auth_form |
The AuthFormProvider directive sets
which provider is used to authenticate the users for this location.
The default file provider is implemented
by the mod_authn_file module. Make sure
that the chosen provider module is present in the server.
<Location "/secure">
AuthType form
AuthName "private area"
AuthFormProvider dbm
AuthDBMType SDBM
AuthDBMUserFile "/www/etc/dbmpasswd"
Require valid-user
#...
</Location>
Providers are implemented by mod_authn_dbm,
mod_authn_file, mod_authn_dbd,
mod_authnz_ldap and mod_authn_socache.
| Description: | Bypass authentication checks for high traffic sites |
|---|---|
| Syntax: | AuthFormSitePassphrase secret |
| Default: | none |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later |
The AuthFormSitePassphrase directive
specifies a passphrase which, if present in the user session, causes Apache httpd to
bypass authentication checks for the given URL. It can be used on high traffic websites
to reduce the load induced on authentication infrastructure.
The passphrase can be inserted into a user session by adding this directive to the configuration for the form-login-handler. The form-login-handler itself will always run the authentication checks, regardless of whether a passphrase is specified or not.
If the session is exposed to the user through the use of
mod_session_cookie, and the session is not protected with
mod_session_crypto, the passphrase is open to potential exposure
through a dictionary attack. Regardless of how the session is configured,
ensure that this directive is not used within URL spaces where private user data
could be exposed, or sensitive transactions can be conducted. Use at own risk.
| Description: | The largest size of the form in bytes that will be parsed for the login details |
|---|---|
| Syntax: | AuthFormSize size |
| Default: | AuthFormSize 8192 |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later |
The AuthFormSize directive specifies
the maximum size of the body of the request that will be parsed to find the login form.
If a login request arrives that exceeds this size, the whole request will be aborted
with the HTTP response code HTTP_REQUEST_TOO_LARGE.
If you have populated the form with fields described by
AuthFormMethod,
AuthFormMimetype and
AuthFormBody, you probably want to set this
field to a similar size as the KeptBodySize
directive.
| Description: | The name of a form field carrying the login username |
|---|---|
| Syntax: | AuthFormUsername fieldname |
| Default: | AuthFormUsername httpd_username |
| Context: | directory |
| Status: | Base |
| Module: | mod_auth_form |
| Compatibility: | Available in Apache HTTP Server 2.3.0 and later |
The AuthFormUsername directive specifies
the name of an HTML field which, if present, will contain the username to be used to log
in.
Apache HTTP Server Version 2.4
| Description: | User authentication using an SQL database |
|---|---|
| Status: | Extension |
| Module Identifier: | authn_dbd_module |
| Source File: | mod_authn_dbd.c |
| Compatibility: | Available in Apache 2.1 and later |
This module provides authentication front-ends such as
mod_auth_digest and mod_auth_basic
to authenticate users by looking up users in SQL tables.
Similar functionality is provided by, for example,
mod_authn_file.
This module relies on mod_dbd to specify
the backend database driver and connection parameters, and
manage the database connections.
When using mod_auth_basic or
mod_auth_digest, this module is invoked via the
AuthBasicProvider or
AuthDigestProvider
with the dbd value.
Some users of DBD authentication in HTTPD 2.2/2.4 have reported that it
imposes a problematic load on the database. This is most likely where
an HTML page contains hundreds of objects (e.g. images, scripts, etc)
each of which requires authentication. Users affected (or concerned)
by this kind of problem should use mod_authn_socache
to cache credentials and take most of the load off the database.
This simple example shows use of this module in the context of the Authentication and DBD frameworks.
# mod_dbd configuration # UPDATED to include authentication caching DBDriver pgsql DBDParams "dbname=apacheauth user=apache password=xxxxxx" DBDMin 4 DBDKeep 8 DBDMax 20 DBDExptime 300 <Directory "/usr/www/myhost/private"> # mod_authn_core and mod_auth_basic configuration # for mod_authn_dbd AuthType Basic AuthName "My Server" # To cache credentials, put socache ahead of dbd here AuthBasicProvider socache dbd # Also required for caching: tell the cache to cache dbd lookups! AuthnCacheProvideFor dbd AuthnCacheContext my-server # mod_authz_core configuration Require valid-user # mod_authn_dbd SQL query to authenticate a user AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s" </Directory>
Whenever a query is made to the database server, all column values in the first row returned by the query are placed in the environment, using environment variables with the prefix "AUTHENTICATE_".
If a database query for example returned the username, full name and telephone number of a user, a CGI program will have access to this information without the need to make a second independent database query to gather this additional information.
This has the potential to dramatically simplify the coding and configuration required in some web applications.
| Description: | SQL query to look up a password for a user |
|---|---|
| Syntax: | AuthDBDUserPWQuery query |
| Context: | directory |
| Status: | Extension |
| Module: | mod_authn_dbd |
The AuthDBDUserPWQuery specifies an
SQL query to look up a password for a specified user. The user's ID
will be passed as a single string parameter when the SQL query is
executed. It may be referenced within the query statement using
a %s format specifier.
AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
The first column value of the first row returned by the query
statement should be a string containing the encrypted password.
Subsequent rows will be ignored. If no rows are returned, the user
will not be authenticated through mod_authn_dbd.
Any additional column values in the first row returned by
the query statement will be stored as environment variables with
names of the form AUTHENTICATE_COLUMN.
The encrypted password format depends on which authentication
frontend (e.g. mod_auth_basic or
mod_auth_digest) is being used. See Password Formats for
more information.
| Description: | SQL query to look up a password hash for a user and realm. |
|---|---|
| Syntax: | AuthDBDUserRealmQuery query |
| Context: | directory |
| Status: | Extension |
| Module: | mod_authn_dbd |
The AuthDBDUserRealmQuery specifies an
SQL query to look up a password for a specified user and realm in a
digest authentication process.
The user's ID and the realm, in that order, will be passed as string
parameters when the SQL query is executed. They may be referenced
within the query statement using %s format specifiers.
AuthDBDUserRealmQuery "SELECT password FROM authn WHERE user = %s AND realm = %s"
The first column value of the first row returned by the query
statement should be a string containing the encrypted password.
Subsequent rows will be ignored. If no rows are returned, the user
will not be authenticated through mod_authn_dbd.
Any additional column values in the first row returned by
the query statement will be stored as environment variables with
names of the form AUTHENTICATE_COLUMN.
The encrypted password format depends on which authentication
frontend (e.g. mod_auth_basic or
mod_auth_digest) is being used. See Password Formats for
more information.
Apache HTTP Server Version 2.4
| Description: | Manages a cache of authentication credentials to relieve the load on backends |
|---|---|
| Status: | Base |
| Module Identifier: | authn_socache_module |
| Source File: | mod_authn_socache.c |
| Compatibility: | Version 2.3 and later |
Maintains a cache of authentication credentials, so that a new backend lookup is not required for every authenticated request.
Some users of more heavyweight authentication such as SQL database
lookups (mod_authn_dbd) have reported it putting an
unacceptable load on their authentication provider. A typical case
in point is where an HTML page contains hundreds of objects
(images, scripts, stylesheets, media, etc), and a request to the page
generates hundreds of effectively-immediate requests for authenticated
additional contents.
mod_authn_socache provides a solution to this problem by
maintaining a cache of authentication credentials.
The authentication cache should be used where authentication
lookups impose a significant load on the server, or a backend or
network. Authentication by file (mod_authn_file)
or dbm (mod_authn_dbm) are unlikely to benefit,
as these are fast and lightweight in their own right (though in some
cases, such as a network-mounted file, caching may be worthwhile).
Other providers such as SQL or LDAP based authentication are more
likely to benefit, particularly where there is an observed
performance issue. Amongst the standard modules, mod_authnz_ldap manages its own cache, so only
mod_authn_dbd will usually benefit from this cache.
The basic rules to cache for a provider are:
AuthnCacheProvideFor directive.AuthBasicProvider or AuthDigestProvider directive.A simple usage example to accelerate mod_authn_dbd
using dbm as a cache engine:
#AuthnCacheSOCache is optional. If specified, it is server-wide
AuthnCacheSOCache dbm
<Directory "/usr/www/myhost/private">
AuthType Basic
AuthName "Cached Authentication Example"
AuthBasicProvider socache dbd
AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
AuthnCacheProvideFor dbd
Require valid-user
#Optional
AuthnCacheContext dbd-authn-example
</Directory>
Module developers should note that their modules must be enabled
for caching with mod_authn_socache. A single optional API function
ap_authn_cache_store is provided to cache credentials
a provider has just looked up or generated. Usage examples are
available in r957072, in which three authn providers are enabled for caching.
| Description: | Specify a context string for use in the cache key |
|---|---|
| Syntax: | AuthnCacheContext directory|server|custom-string |
| Default: | AuthnCacheContext directory |
| Context: | directory |
| Status: | Base |
| Module: | mod_authn_socache |
This directive specifies a string to be used along with the supplied username (and realm in the case of Digest Authentication) in constructing a cache key. This serves to disambiguate identical usernames serving different authentication areas on the server.
Two special values for this are directory, which uses
the directory context of the request as a string, and server
which uses the virtual host name.
The default is directory, which is also the most
conservative setting. This is likely to be less than optimal, as it
(for example) causes $app-base, $app-base/images,
$app-base/scripts and $app-base/media each to
have its own separate cache key. A better policy is to name the
AuthnCacheContext for the password
provider: for example a htpasswd file or database table.
Contexts can be shared across different areas of a server, where credentials are shared. However, this has potential to become a vector for cross-site or cross-application security breaches, so this directive is not permitted in .htaccess contexts.
| Description: | Enable Authn caching configured anywhere |
|---|---|
| Syntax: | AuthnCacheEnable |
| Context: | server config |
| Status: | Base |
| Module: | mod_authn_socache |
This directive is not normally necessary: it is implied if authentication caching is enabled anywhere in httpd.conf. However, if it is not enabled anywhere in httpd.conf it will by default not be initialised, and is therefore not available in a .htaccess context. This directive ensures it is initialised so it can be used in .htaccess.
| Description: | Specify which authn provider(s) to cache for |
|---|---|
| Syntax: | AuthnCacheProvideFor authn-provider [...] |
| Default: | None |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_authn_socache |
This directive specifies an authentication provider or providers
to cache for. Credentials found by a provider not listed in an
AuthnCacheProvideFor directive will not be cached.
For example, to cache credentials found by mod_authn_dbd
or by a custom provider myprovider, but leave those looked
up by lightweight providers like file or dbm lookup alone:
AuthnCacheProvideFor dbd myprovider
| Description: | Select socache backend provider to use |
|---|---|
| Syntax: | AuthnCacheSOCache provider-name[:provider-args] |
| Context: | server config |
| Status: | Base |
| Module: | mod_authn_socache |
| Compatibility: | Optional provider arguments are available in Apache HTTP Server 2.4.7 and later |
This is a server-wide setting to select a provider for the shared object cache, followed by optional arguments for that provider. Some possible values for provider-name are "dbm", "dc", "memcache", or "shmcb", each subject to the appropriate module being loaded. If not set, your platform's default will be used.
| Description: | Set a timeout for cache entries |
|---|---|
| Syntax: | AuthnCacheTimeout timeout (seconds) |
| Default: | AuthnCacheTimeout 300 (5 minutes) |
| Context: | directory, .htaccess |
| Override: | AuthConfig |
| Status: | Base |
| Module: | mod_authn_socache |
Caching authentication data can be a security issue, though short-term caching is unlikely to be a problem. Typically a good solution is to cache credentials for as long as it takes to relieve the load on a backend, but no longer, though if changes to your users and passwords are infrequent then a longer timeout may suit you. The default 300 seconds (5 minutes) is both cautious and ample to keep the load on a backend such as dbd (SQL database queries) down.
This should not be confused with session timeout, which is an entirely separate issue. However, you may wish to check your session-management software for whether cached credentials can "accidentally" extend a session, and bear it in mind when setting your timeout.
Versión 2.4 del Servidor HTTP Apache
Este documento describe que es un Módulo de Multiprocesamiento y como los usa Apache.
Apache está diseñado para ser un servidor web potente y flexible que pueda funcionar en la más amplia variedad de plataformas y entornos. Las diferentes plataformas y los diferentes entornos, hacen que a menudo sean necesarias diferentes características o funcionalidades, o que una misma característica o funcionalidad sea implementada de diferente manera para obtener una mayor eficiencia. Apache se ha adaptado siempre a una gran variedad de entornos a través de su diseño modular. Este diseño permite a los administradores de sitios web elegir que características van a ser incluidas en el servidor seleccionando que módulos se van a cargar, ya sea al compilar o en tiempo de ejecución.
Apache 2.0 extiende este diseño modular hasta las funciones más básicas de un servidor web. El servidor viene con una serie de Módulos de MultiProcesamiento que son responsables de conectar con los puertos de red de la máquina, aceptar las peticiones, y generar los procesos hijo que se encargan de servirlas.
La extensión del diseño modular a este nivel del servidor ofrece dos beneficios importantes:
mpm_winnt
puede usar funcionalidades nativas de red en lugar de usar la
capa POSIX como hace Apache 1.3. Este beneficio se extiende
también a otros sistemas operativos que implementan sus
respectivos MPMs.worker, mientras que los sitios web que
requieran por encima de otras cosas estabilidad o compatibilidad
con software antiguo pueden usar
prefork.
A nivel de usuario, los MPMs son como cualquier otro módulo de Apache. La diferencia más importante es que solo un MPM puede estar cargado en el servidor en un determinado momento. La lista de MPMs disponibles está en la sección índice de Módulos.
En la siguiente tabla se muestran los MPMs por defecto para varios sistemas operativos. Estos serán los MPM seleccionados si no se especifica lo contrario al compilar.
| Netware | mpm_netware |
| OS/2 | mpmt_os2 |
| Unix | prefork, worker, or
event, depending on platform capabilities |
| Windows | mpm_winnt |
aquí, 'Unix' se usa para designar a los sistemas operativos "Unix-like", como Linux, BSD, Solaris, Mac OS X, etc.
En el caso de los Unix, la decisión de que MPM se va a instalar depende de dos pregunas:
1. ¿Nos permite el Sistema Operativo hilos?
2. -¿Nos permite el sistema operativo soporte a pila de hilos seguros (Especificamente, las funciones kqueue y epoll)?
Versión 2.4 del Servidor HTTP Apache
Este documento describe cómo usar filtros en Apache.
| Módulos Relacionados | Directivas Relacionadas |
|---|---|
La cadena de filtrado está disponible en Apache 2.0 y superiores. Un filtro es un proceso que se aplica a los datos que se reciben o se envían por el servidor. Los datos enviados por los clientes al servidor son procesados por filtros de entrada mientras que los datos enviados por el servidor se procesan por los filtros de salida. A los datos se les pueden aplicar varios filtros, y el orden en que se aplica cada filtro puede especificarse explícitamente. Todo este proceso es independiente de las tradicionales fase de peticiones
Algunos ejemplos de filtrado en la distribución estándar de Apache son:
mod_include, implementa server-side includes (SSI).mod_ssl, implementa cifrado SSL (https).mod_deflate, implementa compresión y descompresión en el acto.mod_charset_lite, transcodificación entre diferentes juegos de caracteres.mod_ext_filter, ejecuta un programa externo como filtro.Los filtros se usan internamente por Apache para llevar a cabo funciones tales como chunking y servir peticiones de byte-range. Además, los módulos contienen filtros que se pueden seleccionar usando directivas de configuración al iniciar el servidor.
Una mayor amplitud de aplicaciones son implementadas con módulos de filtros de terceros que estan disponibles en modules.apache.org y en otros lados. algunos de ellos son:
mod_filter, incluido en Apache 2.1 y posterior,
habilita la cadena de filtrado para ser configurada dinámicamente en
tiempo de ejecución. Así, por ejemplo, usted puede configurar un
proxy para que reescriba HTML con un filtro de HTML y imágenes JPEG
con filtros completos por separado, a pesar de que el proxy no tiene
información previa sobre lo que enviará al servidor de origen.
Esto funciona usando un engranaje filtros, que envía a diferentes
proveedores dependiendo del contenido en tiempo de ejecución.
Cualquier filtro puede ser, ya sea insertado directamente en la
cadena y ejecutado incondicionalmente, o usado como proveedor y
añadido dinámicamente
Por ejemplo:
Los filtros pueden ser usados para procesar contenido originado
desde el cliente además de usarse para procesar el contenido originado
desde el propio servidor usando el módulo mod_reflector.
mod_reflector acepta peticiones POST de los clientes, y
refleja el cuerpo de la petición POST recibida, dentro del contenido de la
respuesta de la petición, pasa a través de la pila del filtro de salida en
el camino de vuelta al cliente.
Esta técnica se puede utilizar como una alternativa a un servicio web
que se ejecuta en una pila de de aplicaciones dentro del servidor,
en donde el filtro de salida proporciona la transformación requerida en el
cuerpo de la petición. Por ejemplo, el módulo mod_deflate
puede ser usado para proporcionar un servicio de compresión general,
o un filtro de transformación de imagen, puede ser convertido en un
servicio de conversión de imágenes.
Hay dos formas de usar el filtrado: de forma Simple y Dinámica. Generalmente, deberá usar una forma u otra; ya que mezclarlas puede causar consecuencias inesperadas (a pesar de que reglas de Entrada de tipo simple pueden ser combinadas libremente con reglas de filtrado de Salidas de tipo simple o dinámico).
La forma más sencilla es la única manera de configurar filtros de
Entrada, y es suficiente para filtros de Salida donde se necesita una
cadena de filtros estática.
Las directivas más relevantes son:
SetInputFilter,
SetOutputFilter,
AddInputFilter,
AddOutputFilter,
RemoveInputFilter, and
RemoveOutputFilter.
La forma Dinámica habilita ambas configuraciones estática, y dinámica, para los filtros de Salida, como se plantea en la página mod_filter.
Las directivas más relevantes son:
FilterChain,
FilterDeclare, and
FilterProvider.
Una directiva más como es AddOutputFilterByType sigue siendo
soportada pero esta obsoleta. Usa en cambio la configuración dinámica.
Apache HTTP Sunucusu Sürüm 2.4
Bu sözlük, genelinde HTML sayfa sunumuna, özelinde Apache HTTP Sunucusuna özgü ortak terminolojinin bir kısmını içerir. Her kavram ile ilgili daha ayrıntılı bilgi bağlarla sağlanmıştır.
DirectoryIndex,
mod_autoindex ve mod_include örnek
verilebilir.
apxs kılavuz
sayfasına bakınız.
httpd
çalıştırılabilir dosyasından ayrı olarak derlenmiş modüllerin ortak adı./resimler/.*(jpg|gif)$” düzenli
ifadesi yazılabilir. Dizgileri değiştirmek için düzenli ifadelerin
kullanıldığı yerlerde, eşleşen (parantezlerin içinde) gruplanmış
parçalara başvurmak için $1 ... $9 özel değişkenleri kullanılır. $0 özel
değişkeni eşleşen ifadenin tamamına karşılık gelir. Bir dizgi içinde $
işaretini kendisi olarak kullanmak isterseniz önüne bir \ imi
koymalısınız. Geçmişe uyumluluk adına bazı yerlerde $0 yerine &
değişkeni kullanılabilir. Ancak 2.3.6 sürümünden beri bu artık mümkün
değildir. Apache, PCRE kütüphanesi ile
sağlanan Perl uyumlu düzenli ifadeleri kullanır. PCRE düzenli
ifadelerinin sözdizimi ile ilgili ayrıntılı bilgiyi Wikipedia'da bulabilirsiniz.
cgi-script eylemcisi dosyaları
CGI’ler tarafından işlenebilir hale
getirmek üzere işleme sokar./usr/local/apache2/conf/httpd.conf olup derleme
sırasındaki yapılandırmayla veya çalışma anındaki yapılandırmayla
başka bir yer belirtilebilir.text/html,
image/gif ve application/octet-stream örnek
olarak verilebilir. HTTP protokolünde MIME türleri
Content-Type başlığında
aktarılır.httpd
çalıştırılabiliri içinde derlenmiş modüllere durağan modüller
adı verilirken ayrı bir yerde saklanan ve çalışma anında isteğe bağlı
olarak yüklenebilen modüllere devingen modüller veya
DSO’lar denir. Yapılandırmaya öntanımlı
olarak dahil edilen modüllere temel modüller denir. Apache
için kullanılabilecek modüllerin çoğu Apache HTTP Sunucusunun
tar paketi içinde dağıtılmaz; bunlara
üçüncü parti modüller denir.INCLUDES çıkış süzgeci, belgeleri sunucu taraflı içerik için işleme sokar.httpd.apache.org tam alan adında httpd bir konak
adıyken apache.org bir alan adıdır.
tar uygulaması kullanılarak bir araya getirilmiş
dosyalardan oluşan bir paket. Apache dağıtımları sıkıştırılmış tar
arşivleri içinde veya pkzip kullanılarak saklanır.
http veya
https gibi bir şemayı takip eden bir konak adı ve bir dosya
yolundan oluşurlar. Örneğin, bu sayfanın URL’si
http://httpd.apache.org/docs/2.4/glossary.html olurdu.
GET,
POST ve PUT verilebilir.
Apache HTTP Server Version 2.4
Configuring Apache HTTP Server to listen on specific addresses and ports.
Overview Changing Listen configuration on restart Special IPv6 Considerations Specifying the protocol with Listen How This Works With Virtual Hosts| Related Modules | Related Directives |
|---|---|
When httpd starts, it binds to some port and address on
the local machine and waits for incoming requests. By default,
it listens to all addresses on the machine. However, it may need to
be told to listen on specific ports, or only on selected
addresses, or a combination of both. This is often combined with the
Virtual Host feature, which determines how
httpd responds to different IP addresses, hostnames and
ports.
The Listen
directive tells the server to accept
incoming requests only on the specified port(s) or
address-and-port combinations. If only a port number is
specified in the Listen
directive, the server listens to the given port on all interfaces.
If an IP address is given as well as a port, the server will listen
on the given port and interface. Multiple Listen directives may be used to
specify a number of addresses and ports to listen on. The
server will respond to requests from any of the listed
addresses and ports.
For example, to make the server accept connections on both port 80 and port 8000, on all interfaces, use:
Listen 80 Listen 8000
To make the server accept connections on port 80 for one interface, and port 8000 on another, use
Listen 192.0.2.1:80 Listen 192.0.2.5:8000
IPv6 addresses must be enclosed in square brackets, as in the following example:
Listen [2001:db8::a00:20ff:fea7:ccea]:80
Overlapping Listen directives will result in a
fatal error which will prevent the server from starting up.
(48)Address already in use: make_sock: could not bind to address [::]:80
See the discussion in the wiki for further troubleshooting tips.
When httpd is restarted, special consideration must be made for
changes to Listen directives. During a restart, httpd keeps ports
bound (as in the original configuration) to avoid generating
"Connection refused" errors for any new attempts to connect to the
server. If changes are made to the set of Listen directives used
which conflict with the old configuration, configuration will fail
and the server will terminate.
For example, changing from configuration:
Listen 127.0.0.1:80
to the following may fail, because binding to port 80 across all addresses conflicts with binding to port 80 on just 127.0.0.1.
Listen 80
To have such configuration changes take effect, it is necessary to stop and then start the server.
A growing number of platforms implement IPv6, and APR supports IPv6 on most of these platforms, allowing httpd to allocate IPv6 sockets, and to handle requests sent over IPv6.
One complicating factor for httpd administrators is whether or
not an IPv6 socket can handle both IPv4 connections and IPv6
connections. Handling IPv4 connections with an IPv6 socket uses
IPv4-mapped IPv6 addresses, which are allowed by default on most
platforms, but are disallowed by default on FreeBSD, NetBSD, and
OpenBSD, in order to match the system-wide policy on those
platforms. On systems where it is disallowed by default, a
special configure parameter can change this behavior
for httpd.
On the other hand, on some platforms, such as Linux and Tru64, the
only way to handle both IPv6 and IPv4 is to use
mapped addresses. If you want httpd to handle IPv4 and IPv6 connections
with a minimum of sockets, which requires using IPv4-mapped IPv6
addresses, specify the --enable-v4-mapped configure option.
--enable-v4-mapped is the default on all platforms except
FreeBSD, NetBSD, and OpenBSD, so this is probably how your httpd was
built.
If you want httpd to handle IPv4 connections only, regardless of
what your platform and APR will support, specify an IPv4 address on all
Listen directives, as in the
following examples:
Listen 0.0.0.0:80 Listen 192.0.2.1:80
If your platform supports it and you want httpd to handle IPv4 and
IPv6 connections on separate sockets (i.e., to disable IPv4-mapped
addresses), specify the --disable-v4-mapped configure option. --disable-v4-mapped is the
default on FreeBSD, NetBSD, and OpenBSD.
The optional second protocol argument of
Listen
is not required for most
configurations. If not specified, https is the default for
port 443 and http the default for all other ports. The
protocol is used to determine which module should handle a request, and
to apply protocol specific optimizations with the
AcceptFilter directive.
You only need to set the protocol if you are running on non-standard
ports. For example, running an https site on port 8443:
Listen 192.170.2.1:8443 https
The Listen directive does not implement
Virtual Hosts - it only tells the
main server what addresses and ports to listen on. If no
<VirtualHost>
directives are used, the server will behave
in the same way for all accepted requests. However,
<VirtualHost>
can be used to specify a different behavior
for one or more of the addresses or ports. To implement a
VirtualHost, the server must first be told to listen to the
address and port to be used. Then a
<VirtualHost> section
should be created for the specified address and port to set the
behavior of this virtual host. Note that if the
<VirtualHost>
is set for an address and port that the
server is not listening to, it cannot be accessed.
Apache HTTP 服务器版本 2.4
这篇文档解释了如何在 Microsoft Windows 中安装，配置，以及运行 Apache 2.0 。
这篇文档解释了编译 Apache 的要点。
这篇文档解释了如何在 Novell NetWare 5.1 或更新的版本中，如何安装，配置，以及运行 Apache 2.0 。
从 Apache HTTP 版本 1.3 开始支持使用 EBCDIC 字符集作为原生字符集的(非 ASCII)主机。
Apache HTTP Server Version 2.4
Apache HTTP Server Version 2.4
ġ 1.3 ó EBCDIC ⺻ ϴ (-ASCII) ÷ ǻͷ õǾ.
(BS2000/OSD ü ϴ SIEMENS 迭 ÷ Ѵ. ÷ ü SVR4迭 POSIX ý ִ).
ó ۵Ǿ
ý Ѵ.
EBCDIC ϳ ο ȯ ϰ
ȯ ֵ (EBCDIC) CERN ȣȯ
ϴ ̴. HTML ( CERN νϴ
) ASCII (POSIX ý ⺻ .
Ƿ grep̳ sed POSIX
ִ ) EBCDIC
־ Ѵ. ذå ġ ߰
ä ľϴ " MIME "̴
(Ʒ ). ȯؾ
"ebcdic-handler" ϴ ذ ̴.
ġ BUFF ڷ 带 Ͽ ϹǷ BUFF ó Լ ȯ ߰ϴ ̴. ȯ ־ ϱ BUFF ü ȯؾ ϴ ˷ִ BUFF ǥø ߰ߴ. ǥô HTTP ܰ迡 ִ:
ҽ ȭ ΰ #ifdef
ִ:
#ifdef
CHARSET_EBCDICEBCDIC ǻͿ ʿ ڵ. ںȯ, հ ӵ ڰ , HTTP κ ȯǾ ϴ ˷ִ ǥ .
#ifdef _OSD_POSIXSIEMENS BS2000/OSD ÷ ÷ ʿ ڵ. BS2000/OSD ÷ ʿ ̿ ٷ.
ؿ ASCII EBCDIC ȭ (BS2000 POSIX
ϴ ɼ ִ) HTTP ؿ
۵Ǵ ڷῡ ݰ ڿ ݰ
Ϲ ֱ ǵ
ʾҴ. HTTP ڿ (GET
û, Header: , Ÿ .) ASCII
̰, κ (, GIF , CGI
.) "ȯʰ ׳"
Ѵ. ڵ " ڿ" "Ϲ ڷ",
ڿ bgets() rvputs(),
̳ʸ ڷῡ bgets()
rvputs() Լ Ͽ Ѵ. Ƿ
ȯϴ ʴ.
( EBCDIC ASCII ϵ غؾ Ѵ)
ÿ (Ϸ EBCDIC ڿ ȯ)
ڿ ⺻
ؿ ȯϴ ִ. ڵ忡 ASCII
escape \012 \015 ܴ:
̵ ̹ ASCII \n \r
̳ʸ ̱ ASCII ι ȯϸ ȵȴ.
ܴ ڿ ȴ; ܺ
EBCDIC ASCII ٹٲڸ ϸ ȵȴ.
BUFF Լ ϴ 캻
puts/write/get/gets ġԵǴ "ebcdic/ascii ȯ
" ߰ϰ, ȯ ִ
ȯ ǥø ߰ߴ. (̳ CGI )
(û Ŭ̾Ʈ) ̵Ҷ
ι : -> ġ, ġ
-> Ŭ̾Ʈ.
EBCDIC CGI ũƮ а, ũƮ ASCII ˾Ƴ ִ (WWW 湮ڼ α : GIF ̴). ⺻ EBCDIC óѴ; type ̹ ASCII Ȥ EBCDIC ȯ ؾ ϴ Ѵ.
(MIME type text/plain, text/html ) Ϲ Ϲ ASCII ȯϰų, (ڿ ϱ ̸ ASCII Ͽų NFS Ʈ 丮 ִ ) ȯ ִ.
:
̸ .ahtml Ϲ
ȯ ASCII text/html (
.ascii Ȯڴ ASCII
text/plain) Ϸ þ
Ѵ:
AddType text/x-ascii-html .ahtml
AddType text/x-ascii-plain .ascii
, text/foo MIME type
AddType "text/x-ascii-foo"
Ͽ "Ϲ ASCII" ִ.
Ϲ ڰ ƴ ȯ "̳ʸ"
Ѵ. , GIF/ZIP/AU Ŀ
̴. ڴ "rcp -b"
̳ʸ ɼ Ͽ ÷ ȣƮ
߾ Ѵ.
Ľ ǻͰ ϴ ⺻ (, EBCDIC) Ǿٰ ϰ, óĿ ȯѴ.
CGI CGI ũƮ ȯ ʿ Ѵ: Content-Type Ͽ, ȯϰ, GIF ȯ ִ. 츮 wwwcount α .
Content-Type: text/
ϴ ʴ ̳ʸ Ͽ
ȯ ʴ´. ̳ʸ Ͽ GIF , gzip
ִ.
÷ ȣƮ н Ȥ PC ̳ʸ
ftp "binary" (TYPE I) ɾ
÷ ȣƮ (н rcp
-b ɼ ʴ´) rcp -b
ɾ ݵ ϶.
⺻ (,
Content-Type: text/ ϴ
) ȣƮ ⺻ EBCDIC Ǿٰ
Ѵ.
SSI EBCDIC θ ؾ Ѵ. óϱ ASCII ȯ ʴ´.
core |
+ | |
mod_access |
+ | |
mod_actions |
+ | |
mod_alias |
+ | |
mod_asis |
+ | |
mod_auth |
+ | |
mod_auth_anon |
+ | |
mod_auth_dbm |
? | ü libdb.a Ͽ |
mod_autoindex |
+ | |
mod_cern_meta |
? | |
mod_cgi |
+ | |
mod_digest |
+ | |
mod_dir |
+ | |
mod_so |
- | ̺귯 |
mod_env |
+ | |
mod_example |
- | ( ܰ) |
mod_expires |
+ | |
mod_headers |
+ | |
mod_imagemap |
+ | |
mod_include |
+ | |
mod_info |
+ | |
mod_log_agent |
+ | |
mod_log_config |
+ | |
mod_log_referer |
+ | |
mod_mime |
+ | |
mod_mime_magic |
? | þȵ |
mod_negotiation |
+ | |
mod_proxy |
+ | |
mod_rewrite |
+ | Ʈȵ |
mod_setenvif |
+ | |
mod_speling |
+ | |
mod_status |
+ | |
mod_unique_id |
+ | |
mod_userdir |
+ | |
mod_usertrack |
? | Ʈȵ |
JK (mod_jserv)
|
- | JAVA ̴. |
mod_php3 |
+ | mod_php3 LDAP, GD, FreeType ̺귯
Բ Ѵ. |
mod_put |
? | Ʈȵ |
mod_session |
- | Ʈȵ |
Apache HTTP Server Version 2.4
Novell NetWare 6.0 ̻ ġ 2.0 ġ, , ϴ Ѵ. ãҰų ٸ ʹٸ, ̿ϱ ٶ.
dev-httpd ϸƮ ġ ʴ´. ϱ (FAQ) , ٸ ù . ñ ̳ ִٸ, NetWare ġ 뿡 ư ο ġ ڰ ִ novell.devsup.webserver 쿡 ø ٶ.
̳ʸ ġ ġߴٰ Ѵ. (Ƹ ߿ ְų ã) ġ Ϸ Ʒ NetWare ġ ϱ ϶.
ġ 2.0 NetWare 6.0 service pack 3 ̻ ϵ Ǿ. SP3 service pack Ѵٸ ֽ NetWare Libraries for C (LibC) ġؾ Ѵ.
ֽ service pack̳ ֽ NetWare Libraries for C (LibC) ġߴٸ NetWare 5.1 ȯ濡 NetWare ġ 2.0 ִ. : NetWare ġ 2.0 ȯ ʾҰ Ʈ ʾҴ.
ġ ֽ http://www.apache.org/ (ġ ) ã ִ. ֱ /ŸƮ , ̷ Ʈ ftp Ʈ ִ. NetWare ġ 2.0 ֽ ̳ʸ ٿ ִ.
NetWare ġ ġα . NetWare ġ 2.0 ҽ Ѵٸ Ѵ.
̳ʸ ٿ NetWare ġ ġϴ
(sys:/apache2 ġѴٰ Ѵ):
SYS:
ֻ 丮 Ǭ (ٸ ġص ȴ)httpd.conf Ͽ ServerRoot ServerName ϰ
˸° ѴSEARCH ADD SYS:\APACHE2
SYS:/APACHE2 ߰Ѵ
ҽ NetWare ġ ġϴ
(sys:/apache2 ġѴٰ
Ѵ):
Apache2 丮
APACHE2.NLM APRLIB.NLM
SYS:/APACHE2 ѴSYS:/APACHE2 Ʒ BIN̶
丮 HTDIGEST.NLM, HTPASSWD.NLM,
HTDBM.NLM, LOGRES.NLM,
ROTLOGS.NLM SYS:/APACHE2/BIN
ѴSYS:/APACHE2 Ʒ CONF
丮 HTTPD-STD.CONF
SYS:/APACHE2/CONF ϰ ϸ
HTTPD.CONF ѴMIME.TYPES, CHARSET.CONV,
MAGIC SYS:/APACHE2/CONF
丮 Ѵ\HTTPD-2.0\DOCS\ICONS ִ ϰ
丮 SYS:/APACHE2/ICONS Ѵ\HTTPD-2.0\DOCS\MANUAL ִ ϰ
丮 SYS:/APACHE2/MANUAL Ѵ\HTTPD-2.0\DOCS\ERROR ִ ϰ
丮 SYS:/APACHE2/ERROR Ѵ\HTTPD-2.0\DOCS\DICROOT ִ ϰ
丮 SYS:/APACHE2/HTDOCS ѴSYS:/APACHE2/LOGS 丮 SYS:/APACHE2/APACHE2/CGI-BIN̶
丮 SYS:/APACHE2/MODULES 丮
nlm modules 丮 ѴHTTPD.CONF @@Value@@
ǥø üѴSEARCH ADD SYS:\APACHE2
SYS:/APACHE2 ߰Ѵ
⺻ SYS ƴ ٸ ġ
ġ ִ.
makefile ɾ "install" Ű带 ϸ Ͻ
ڵ DIST 丮
. makefile NetWare ֻ 丮
ϸ ġ ġȴ (Ʒ NetWare
ġ ϱ ).
ġ Ϸ ֿܼ apache Էϸ
ȴ. ü ּҿ ġ оδ.
ȣּҿ ġ о̷ load ɾ
ּҿ Ѵ:
load address space = apache2 apache2
ġ apache2 ּҿ оδ. NetWare ġ ٸ ȣּҿ о鿩 ġ ÿ ִ.
ġ ϸ (Ͽ Listen þ
ʴ) Ʈ 80 ٸ. Ͽ
Ȥ ּҸ Էϸ Ͽ ⺻
Ѵ. ġ ũ ִ ȯ ;
Ѵ. ƹ ϵ ų ϸ logs
丮 ִ error_log .
⺻ ġ ϸ conf 丮 ִ
Ѵ.
ü ּҿ ġ ֿܼ ԷѴ:
unload apache2
Ȥ
apache2 shutdown
ȣּҿ ġ ߴٸ unload ɾ ּҿ Ѵ:
unload address space = apache2 apache2
ġ ġ ã ˾Ƶξ Ѵ. ϴ ΰ:
-f Ư θ Ѵ
apache2 -f "vol:/my server/conf/my.conf"
apache -f test/test.conf
ùٸ ServerRoot ؾ Ѵ.
-f ϸ , ġ
ϵ ϸ ( conf/httpd.conf)
Ѵ. -V ɼ ġ ϸ
SERVER_CONFIG_FILE̶ ش.
ġ ServerRoot ã´:
-C ɼ ServerRoot þ.-d ɼ. ϵ server root
sys:/apache2̴. -V ɼ
ġ ϸ HTTPD_ROOT ش.
NetWare ġ 2.0 ̰ų
˷ִ þ ִ. ̵ þ ġ ߿
ִ. þ տ APACHE2 Ű带
ٿ Ѵ.
⺻ þ ü ּҿ ġ Ѵ. ġ ȣּҿ ̶, -p ּҿ ̸ ߰Ѵ. "apache2 Help" ԷѴ.
ġ conf 丮 ִ Ϸ
Ѵ. н , NetWare ġ
ٸ þ ִ. 밡 þ ؼ
ġ ϶.
NetWare ġ ֵ :
NetWare ġ ߾ ϱ, н û ٸ μ ʴ´. 带 Ѵ: θ û óϴ ڽ Ȥ worker .
Ƿ "μ"- þ ٸ:
MaxRequestsPerChild -
н worker 尡 û ŭ óϰ
Ѵ. ϴ ⺻
MaxRequestsPerChild 0 ϸ
ʰ û Ѵ. Ư ٸ
NetWare þ 0 ϱ
Ѵ.
StartThreads -
þ ó Ѵ.
ϴ ⺻ StartThreads 50̴.
MinSpareThreads -
(idle) worker
带 . ϴ ⺻
MinSpareThreads 10̴.
MaxSpareThreads -
worker 带
̱ Ѵ. ϴ ⺻
MaxSpareThreads 100̴.
MaxThreads -
þ worker ִ Ѵ. ϴ
⺻ ThreadsPerChild 250̴.
ThreadStackSize -
worker 尡 ũ⸦ Ѵ. ϴ
⺻ ThreadStackSize 65536̴.
ƱԸƮ ϸ þ н ϸ
ƴ NetWare ϸ ؾ Ѵ. ġ
н ϸ ϱ 齽
ؾ Ѵ. ο
ϱ ٶ. ϸ ġ
SYS: ̶ ߸ ִ.
NetWare ġ ٽ ʰ Ҷ
о ִ. ġ ϸ
\Apache2\modules 丮 ߰
ġѴ. ̵ Ȥ ٸ Ϸ LoadModule þ Ѵ.
status Ѵٸ:
LoadModule status_module modules/status.nlm
о ִ ִ.
CGIMapExtension -
CGI Ȯڸ ũƮ Ϳ Ѵ.SecureListen -
Ư Ʈ SSL ȣȭѴ.NWSSLTrustedCerts -
Ͻϴ ȿҶ ŷϴ
(certificate) ߰Ѵ.NWSSLUpgradeable -
Ư ּ/Ʈ ξ SSL
ִ.ġ Ϸ MetroWerks CodeWarrior 6.x ̻
ʿϴ. ġ ϸ Netware ġ
ִ. ⺻ sys:/Apache2 丮.
ϱ conf 丮 ۼؾ
Ѵ. conf 丮 ִ
HTTPD-STD.CONF ϸ HTTPD.CONF
Ѵ. HTTPD.CONF Ͽ @@Value@@
ǥø ãƼ üѴ. conf/magic
conf/mime.types ϵ Ѵ. ƴϸ makefile
Ҷ install Ű带 ϸ
.
NetWare ġ 2.0 Ϸ ߵ ʿϴ:
awk.exe ̸
ο ξ Ѵ.NOVELLLIBC ȯ溯
Set NOVELLLIBC=c:\novell\ndk\libc
METROWERKS ȯ溯
Set METROWERKS=C:\Program Files\Metrowerks\CodeWarrior
C:\Program Files\Metrowerks\CodeWarrior
ġϿٸ, ȯ溯 ʿ .LDAPSDK ȯ溯
Set LDAPSDK=c:\Novell\NDK\cldapsdk\NetWare\libc
ZLIBSDK ȯ溯
Set ZLIBSDK=D:\NOVELL\zlib
AP_WORK ȯ溯 \httpd-2.0
丮 ü η Ѵ.APR_WORK ȯ溯
\httpd-2.0\srclib\apr 丮 ü η
Ѵ.gmake.exe)
ý PATH ȯ溯 Եִ
ȮѴ.\httpd-2.0\srclib\apr-util\uri 丮
"gmake -f nwgnumakefile" Ͽ
GENURI.nlm Ѵ.GENURI.nlm NetWare
SYS: ϰ
SYS:\genuri > sys:\uri_delims.h
uri_delims.h ϴ ǻ
\httpd-2.0\srclib\apr-util\uri 丮
Ѵ.\httpd-2.0\srclib\apr 丮
"gmake -f nwgnumakefile" Ͽ APR
Ѵ.\httpd-2.0\srclib\pcre 丮
"gmake -f nwgnumakefile" Ͽ
DFTABLES.nlm Ѵ.\httpd-2.0\server 丮
"gmake -f nwgnumakefile" Ͽ
GENCHARS.nlm Ѵ.GENCHARS.nlm
DFTABLES.nlm NetWare
SYS: ϰ Ѵ:
SYS:\genchars > sys:\test_char.h
SYS:\dftables > sys:\chartables.c
test_char.h chartables.c
ϴ ǻ \httpd-2.0\os\netware
丮 Ѵ.\httpd-2.0 丮
"gmake -f nwgnumakefile" Ͽ ġ
Ѵ.
gmake -f nwgnumakefile install
gmake -f nwgnumakefileϹ
Ͽ \release 丮 Ѵ.
gmake -f nwgnumakefile DEBUG=1
Ͽ \debug 丮
Ѵ.
gmake -f nwgnumakefile install
\dist\Apache2 丮 , ,
߰ ġ .
gmake -f nwgnumakefile installdev
install , \lib
\include 丮 ϰ import
Ѵ.
gmake -f nwgnumakefile clean
DEBUG \release
\debug ִ Ʈϰ
.
gmake -f nwgnumakefile clobber_allclean 丮 .
Serveur HTTP Apache Version 2.4
Ce document explique comment installer, configurer et exécuter Apache 2.4 sous Microsoft Windows.
Il y a de nombreux points importants à connaître avant de se lancer dans la compilation d'Apache. Ce document en donne la description.
Ce document explique comment installer, configurer et exécuter Apache 2.4 sur des systèmes qui supportent le format de paquet RPM.
Voir : Utilisation d'Apache avec les systèmes à base de paquets RPM
Ce document explique comment installer, configurer et exécuter Apache 2.4 sous Novell NetWare versions 5.1 et supérieures.
La version 1.3 du serveur HTTP Apache est la première à avoir été portée vers une machine de type mainframe (non-ASCII) qui utilisait le jeu de caractères EBCDIC comme jeu de caractères natif.
Apache HTTP Server Version 2.4
Microsoft Windows ġ 2.0 ġ, , ϴ Ѵ. ߸ κ ְų ٸ ַ, ϱ ٶ.
ġ ̳ʸ ġѴٰ Ѵ. (Ƹ Ȥ ã) ġ Ϸ Microsoft Windows ġ ϶.
Microsoft Windows ü å Ѵ:
ġ 2.0 ϱ ⺻ Windows ÷ Windows NT̴. ̳ʸ ġα Intel AMD x86 μ Ѵ. ġ Windows 9x ˻ ʾұ ʱ ٶ.
ü ġ TCP/IP Ʈũ ؾ Ѵ. Windows 95 Ѵٸ, Winsock 2 ̵带 ġؾ Ѵ. Windows 95 Winsock 2 ٿ ִ.
Windows NT 4.0 Ѵٸ 4 TCP/IP Winsock ѿ ذǾ, 6 ġϱ Ѵ.
ġ http://httpd.apache.org/download.cgi ġ ֽ ִ. ֽ ǥǰ Ȥ Ÿ Ʈ, ġ ٿε ִ HTTP ̷ FTP ̷ ִ. ϰ ٿ ̷ ϱ ٶ.
Windows ġϷ Ȯڰ .msi Windows
ġ ٿƾ Ѵ. ٷ
ִ ġ Microsoft ġ̴. ҽڵ常
.zip ִ. Microsoft Visual C++
(Visual Studio) Ͽ ġ ִ.
ġϷ Microsoft Installer 1.2 ̻ ʿϴ. Windows 9x Ѵٸ Microsoft Installer 2.0 ̵ ְ, Windows NT 4.0 2000 Ѵٸ 2.0 Ʈ ִ. Windows XP Ʈ ʿ䰡 .
̳ʸ ġϷδ ǻͿ ٸ ġ 2.0 ġ ϶. 1.3 2.0 ǻͿ ƹ ġ ִ. ǻͿ ΰ ٸ 2.0 ġϷ ҽ Ͽ ġ ġؾ Ѵ.
ٿ ġ .msi Ѵ.
ġҶ :
Ʈũ (Network Domain).
ϵ DNS ԷѴ. ,
ü DNS ̸ server.mydomain.net̶
mydomain.net ԷѴ.
(Server Name). ü
DNS ̸. server.mydomain.net
ԷѴ.
ڿ ּ (Administrator's Email Address). ڳ ڿ ּҸ ԷѴ. ⺻ Ŭ̾Ʈ ּҸ Ѵ.
(For whom to install
Apache) ġϴ ġ 80 Ʈ
û ٸ Ϸ for All Users, on Port 80,
as a Service - Recommended ( , 80 Ʈ,
service - õ) Ѵ. ġ service Ѵ
(, ġ α ȴ).
Ʈغų ̹ 80 Ʈ ϴ ٸ
ִٸ only for the Current User, on Port
8080, when started Manually ( ڸ, 8080
Ʈ, ) Ѵ.
ġ (The installation type).
߿ ʿ ҽڵ ̺귯
ġϷ Typical Ѵ.
Custom ϸ ġ
ִ. ü ġ ũ 13 ްƮ
ʿϴ. ġ Ʈ ũ⸦
̴.
ġ (Where to install).
⺻ δ C:\Program Files\Apache Group̰,
̰ Apache2 丮 .
ġ ġ conf 丮
ִ ϵ ġ 丮 ° Ѵ.
丮 ̹ ִٸ ״ д. ,
ش ο 纻 Ȯ .default
δ. , conf\httpd.conf ̹ ִٸ
conf\httpd.conf.default ̸ Ѵ.
ġ .default 캸,
ʿϴٸ ؾ Ѵ.
, ̹ htdocs\index.html̶
ִٸ ״ д (index.html.default
ʴ´). , ġ ġִ ϰ
ġ ġ ִ. ġϱ
ߴϰ, ġ ο ؾ Ѵ.
ġ ġ ʿϴٸ conf 丮
ִ ؾ Ѵ. ġ ġ 丮
htdocs 丮 ִ ϵ
ִ. ġ ϱ ؾ ɼ
. غ ֵ ⺻ Ϸε Ѵ.
ġ conf 丮 ִ Ϸ
Ѵ. н , Windows ġ
Ư þ ִ. 밡 þ
þ ϶.
Windows ġ ֵ :
Windows ġ ߾ ϱ, н û ٸ μ ʴ´. ġ μ , θ μ û óϴ ڽ μ, 2̴. ڽ μ ִ û óѴ.
μ þ ٸ:
MaxRequestsPerChild: н
, ڽ μ û ŭ óϰ
Ѵ. н μ ѹ û
óʰ ѹ û ϱ, Ѵٸ
ſ ū ϱ Ѵ. ϴ ⺻
MaxRequestsPerChild 0 ϸ ڽ μ
ʰ û Ѵ.
httpd.conf ߴٸ, ڽ μ
ʰų ġ ִ.ThreadsPerChild:
þ ߰Ǿ. þ
Ѵ. ѹ ó
ִ ִ ᰳ̱, Ʈ ӷ ٸ
ū ؾ Ѵ. ϴ ⺻
ThreadsPerChild 50̴.
ϸ ƱԸƮ þ н ϸ ƴ Windows ϸ ؾ Ѵ. ġ ο н ̸ ϱ 齽 ƴ ؾ Ѵ. ̺ ڸ ִ. ̺긦 ġ ִ ̺긦 Ѵ.
Windows ġ ٽ ʰ
߿ о ִ. ⺻ ġ
ϸ \Apache2\modules 丮
ð ġѴ. Ȥ ٸ
Ϸ LoadModule þ Ѵ.
, status Ѵٸ
(access.conf status þ Բ)
Ʒ Ѵ:
LoadModule status_module modules/mod_status.so
о ִ ִ.
ġ Microsoft IIS ٸ Windows ϴ ISAPI (Internet Server Application Programming Interface) Ȯ (, ͳ α) о ִ. ڼ ִ. ġ ISAPI о ϶.
CGI ũƮ Ѵٸ ScriptInterpreterSource þ
Ͽ ġ ũƮ ã
ִ.
Windows .htaccess ϸ
ٷ Ƿ, AccessFilename þ Ͽ
丮 ̸ ϸ ϴ.
Windows NT ġ ۽ Windows
̺Ʈ α Ѵ. ġ ϴ
error.log 쿡 Ѵ.
Windows ̺Ʈ α״ Windows NT 4.0 ̺Ʈ
α, ֽ Windows ̺Ʈ MMC
ο ִ.
Windows NT ġ service ִ. Windows 9x ſ Ѵ.
ġ ڵ ġ service ġ ִ. " " ϸ, ġ service . " ڸ" ϴ ġ ġ service ִ. service ġϷ Administrators ̾ Ѵ.
ġ Apache Service Monitor ִ. ϸ Ʈ ִ ٸ ǻͿ ġ ġ µ Ȯϰ ִ. monitor ġ service Ϸ service (ġ ڵ Ȥ ) ġؾ Ѵ.
ġ bin 丮 Ʈ
Էϸ ġ Windows NT service ġѴ:
apache -k install
ġ service ̸ ϰ ʹٸ ɾ Ѵ. ǻͿ ġ ġִٸ ̸ ٸ ־ Ѵ.
apache -k install -n "MyServiceName"
service Ϸ Ѵ:
apache -k install -n "MyServiceName" -f "c:\files\my.conf"
-k install ܿ ٸ Ķ
, service ̸ Apache2 ǰ
conf\httpd.conf ȴ.
ġ service ϱ . :
apache -k uninstall
ġ service ִ:
apache -k uninstall -n "MyServiceName"
ġ service , , Apache Service
Monitor NET START Apache2, NET STOP
Apache2 ɾ Ȥ Windows â
Ѵ. ϵ ġ service ϱ
˻غ Ѵ:
apache -n "MyServiceName" -t
ɼε ġ service ִ. ġ ġ serivce Ϸ:
apache -k start
ɼ ġ service Ϸ:
apache -k stop
Ȥ
apache -k shutdown
service Ͽ ٽ е ִ:
apache -k restart
⺻ ġ service ý
(LocalSystem ) ϵ ϵȴ.
Windows ȱ LocalSystem Ͻý,
named pipes, DCOM, secure RPC ϵ
Ʈ . ش ǻͿ
.
LocalSystem
Ʈ ! ġ Ʈ ڿ ؾ
Ѵٸ, Ʒ ϴ ġ
.ġ service ϱ ִ. Ư ġ Ʈ ڿ ؾ Ѵٸ Ѵ.
α
ü Ϻη Ȱ
οѴ. Windows NT 4.0 User Manager for Domains
ο ְ, Windows 2000 XP Ƹ
" å" ؾ Ѵ. " " MMC
ο ִ.
htdocs cgi-bin) б
(RX) οѴ.logs 丮 (RWXD)
οѴ.Apache.exe Ͽ б (RX)
οѴ.logs 丮 ϰ
Apache2 丮 ü б (RX) οϴ
." α" " α" ִٸ, αϿ ũƮ ϰ ܼâ ġ ִ ˻غ ִ. ⼭ ٸ ġ service ص .
ġ service ϸ Windows Service Control Manager ִ. , ǿ "" Ͽ ġ ϴ ִ:
Could not start the Apache2 service on \\COMPUTER
Error 1067; The process terminated unexpectedly.
ġ service Ҷ Ϲ ̷ ´. ˷ ġ ܼ α غ.
Windows 9x ġ Windows NT service Ѵ. ſ ̴. Ҹŭ ʰ . ϹǷ Ȥó Ѵٸ ؼ ؾ Ѵ!
ΰ service ߿ :
ġ ϸ 濡 Ѵ. , ũž ٷΰ⸦ ϴ ,
apache -n "MyServiceName" -k start
service ϸ ܼâ ٰ ݹ . httpd.conf Ͽ ߸ ִ ġ ۽ ϸ ܼâ δ. ܼâ ľϴµ ִ ش.
Windows 9x NET START NET
STOP ɾ ʴ´. Ʈ
-k ɼ Ͽ ġ service ؾ
Ѵ.
ġ Windows 9x Ʈ Ư ڷ ġ Ѵ. Windows 9x ʴ´. ̰ ٷ Apache Software Foundation Windows 9x ý ϱ ʴ . ڰ ϰ ġ н , ƴϸ 缳 Ʈ ġ Ʈ , Windows 9x ̴.
ġ ܼ α ȮϿٸ Windows NT ɾ service ġ, , ִ. , Apache Service Monitor Ͽ Windows 9x service ִ.
Ϲ ġ service ϱ Ѵ. ϴ° 찡 ִ (Windows 9x service ʱ ġ ϴ Ѵ).
ġ ܼ α Ϸ, ɾ Ѵ:
apache
ġ Control-C ȴ.
, --> α --> Apache HTTP
Server 2.0.xx --> Control Apache Server ġ
Start Apache in Console ٷΰ ġ ִ.
ٷΰ⸦ ϸ ܼâ ȿ ġ Ѵ.
ġ service ġ ʾҴٸ, ġ ϴ
ܼâ Control-C ġ ߴҶ â ִ.
ʾȿ Ѵ. , ġ service
ġϿٸ ٷΰ service Ѵ. ġ service
̹ ̶ ٷΰ ƹϵ ʴ´.
ٸ ܼâ ԷϿ ġ ִ:
apache -k shutdown
ġ ۾ ġ ݰ ֱ Control-C .
, ġ ִ. ٽ д´. ۾ ߰ ʰ ϷѴ. ġ Ϸ:
apache -k restart
kill -TERM pid kill -USR1
pid Windows̴. ɼ
-k н kill ɾ ̸
.ġ ܼâ Ȥ ڱ ġ
--> α Ʈ Ѵ. ġ ġ
apache ɾ غ
캻. logs ,
߸Ǿ error.log 캻. ġ
ġҶ ⺻ ߴٸ :
c:
cd "\Program Files\Apache Group\Apache2\bin"
apache
ġ ٸų Control-C . ԷѴ:
cd ..\logs
more < error.log
ġ ٷ궧 ġ ã ƴ ߿ϴ. ΰ ִ:
-f Ȥ θ
Ѵ:
apache -f "c:\my server files\anotherconfig.conf"
Ȥ
apache -f files\anotherconfig.conf
-n ġ service ϰ, ش
service Ѵ:
apache -n "MyServiceName"
ServerRoot ؾ Ѵ.
-f -n
, ġ conf\httpd.conf
ϵ ϸ Ѵ. ⺻ δ ġ 丮
̴. -V ɼ ġ
ϸ SERVER_CONFIG_FILE̶
ִ:
apache -V
ġ ServerRoot ã´:
-C ɼǿ ServerRoot þ.-d ɼ./apachḛ, apache -V ϸ
HTTPD_ROOT Ȯ ִ.ġҶ Ʈ Ư Ʈ
Ű . Ű ġ ġ ٸ. install
Apache for all users Ͽٸ
HKEY_LOCAL_MACHINE Ʒ Ű
( ȣ ġ ٸ):
HKEY_LOCAL_MACHINE\SOFTWARE\Apache Group\Apache\2.0.43
" " ġ ġϿٸ
HKEY_CURRENT_USER Ʒ Ű .
α ڿ ٸ:
HKEY_CURRENT_USER\SOFTWARE\Apache Group\Apache\2.0.43
Ű ̸ ϵDZ ǵ帮ʰ ο ġϿ Ʈغ ִ. ٸ 丮 ġʵ ؾ Ѵ.
̳ʸ ġ ġ Ʈ Ű ٰ ִ. ٸ ã ִٸ ص ȴ.
Ű ServerRoot
丮̸, 丮 conf 丮
ִ. ġ ϸ 丮
httpd.conf д´. Ͽ
ServerRoot þ
Ʈ Ű 丮 ٸٸ, ġ Ʈ
ϰ Ͽ 丮 Ѵ.
ġ 丮 ٸ ҷ ϸ ݵ
httpd.conf Ͽ ִ ServerRoot þ ġ
϶.
(ܼâ̳ service ) ġ ϸ (
Listen þ
ϰų ġ " ڸ" ġ ʴ
) 80 Ʈ ٸ. ϰ URL ԷϿ
⺻ ϴ:
http://localhost/
ġ ġ ũ ִ ȯ
Ѵ. ƹ ϵ Ͼ ʰų , logs
丮 ִ error.log .
ȣƮ Ʈ ʰų DNS (Domain Name Service)
ִٸ URL ؾ Ѵ:
http://127.0.0.1/
⺻ ġ ϸ conf 丮
ִ Ѵ. , Windows NT ġ service
ġ Ͽ
ʴ Ȯؾ Ѵ.
ġ ٸ TCP/IP α Ʈ ġ ϱ ٸ ߴ, , 缳ؾ . ٸ Ư ȭ 浹 ִ.
Apache HTTP Server Version 2.4
Date: Wed, 05 Nov 1997 16:59:34 -0800 From: Rick Jones <raj@cup.hp.com> Reply-To: raj@cup.hp.com Organization: Network Performance Subject: HP-UX tuning tips
߰ HP-UX ̴.
HP-UX 9.X: 10.20 ̵϶
HP-UX 10.[00|01|10]: 10.20 ̵϶
HP-UX 10.20:
ֱ ARPA Transport ġ ġѴ. TCP
ã ؽ̺ ũ⸦ ִ. ⺻
256 ̰, 2 ŵ ؾ Ѵ. adb Ŀ
*disc* ̹ Ͽ Ѵ.
tcp_hash_size̴. tcp_hash_size
32Ʈ̹Ƿ disc ̹ Ҷ ݵ 16Ʈ
ϴ "w" 32Ʈ ϴ
"W" ؾ Ѵ.
? ftp://ftp.cup.hp.com/dist/networking/tools/connhist
, ýۿ ϴ TCP Ѱ .
ڸ ؽ̺ ũ (10 )
. HP SPECweb96 Ϲ ִ.
http://www.specbench.org/
ִ. HP-UX ý ʴ 1000 SPECweb96 ϴ
TIME_WAIT 60ʶ 60,000 TCP ""
Ѵٴ ̴.
ftp://ftp.cup.hp.com/dist/networking/misc/listenq Ͽ ý ̸ ִ.
PA-8000 ýۿ ġ Ѵٸ, ġ
ū ũ⸦ ϵ "chatr"Ѵ.
"chatr +pi L <>"̴.
ϴ GID MLOCK ݵ ʿϴ.
MLOCK ο ؼ Setprivgrp(1m)
϶. Glance Ͽ 캸
text Ʈ Ȯ ִ.
μ ýۿ ġ Ѵٸ, μ
μ ϴ mpctl()
α ۼغ. ܼ pid % numcpu
˰ε ̴. κ ҽڵ忡
Ե ִ.
FIN_WAIT_2 ٸ,
nettune Ͽ tcp_keepstart
ִ. ؾ Ѵ - 4 ۰ .
tcp_hash_size Ͽٸ,
FIN_WAIT_2 Ŀ ( ⺻ 2ð)
- ɿ ū ʴ´.
ҽڵ忡 Ե κ , ⼭ δ. ִٸ ֱ ٶ.
̸,
rick jones
Serveur HTTP Apache Version 2.4
Il y a de nombreux points importants à connaître avant de compiler Le serveur HTTP Apache pour Microsoft Windows. Avant de commencer, lisez le document Utiliser le serveur HTTP Apache avec Microsoft Windows.
httpd peut être compilé sous Windows en utilisant une chaîne de compilation basée sur cmake, ou à partir de fichiers projet Visual Studio maintenus par les développeurs de httpd. La chaîne de compilation basée sur cmake supporte directement davantage de versions de Visual Studio, mais possède actuellement des fonctionnalités très limitées.
Prérequis Compilation à partir des sources Unix Compilation à partir de la ligne de commandes Compilation depuis l'espace de travail IDE de Developer
Studio Export des fichiers .mak de la ligne de commandes Installation Avertissement à propos de la compilation d'Apache à partir de
l'arborescence de développement Compilation de httpd avec cmakePour compiler Apache, l'environnement doit satisfaire aux conditions suivantes :
Espace disque
Assurez-vous de disposer d'un minimum de 200 Mo d'espace disque disponible. Après l'installation, Apache occupe environ 80 Mo d'espace disque, plus l'espace réservé aux journaux et au cache, la taille de ces derniers pouvant augmenter rapidement. Les besoins réels en espace disque dépendent étroitement de la configuration choisie et des bibliothèques ou modules tiers installés, en particulier lorsqu'OpenSSL est mis en oeuvre. Comme de nombreux fichiers sont au format texte et donc facilement compressibles, l'utilisation de la compression du système de fichiers NTFS divise ces besoins par deux.
Correctifs requis
Le binaire httpd est compilé à l'aide de nombreux correctifs appliqués aux paquets tiers, ce qui permet de s'assurer que le code fourni est bien compilable et déboguable. Ces correctifs sont disponibles à http://www.apache.org/dist/httpd/binaries/win32/patches_applied/, et il est recommandé de les appliquer afin d'obtenir un résultat identique aux binaires "officiels" distribués par l'ASF.
Microsoft Visual C++ 6.0 (Visual Studio 97) ou supérieur.
Apache peut être compilé en utilisant l'outil ligne de
commande, ou depuis l'espace de travail IDE Visual Studio. Pour
la compilation depuis la ligne de commandes, l'environnement
doit comporter les variables the PATH,
INCLUDE, LIB, ainsi que d'autres
variables qui peuvent être définies via le script
vcvars32.bat :
Le SDK de la plate-forme Windows mis à jour, février 2003 ou plus récent.
Un SDK approprié pour la plate-forme Windows est inclus par défaut dans les versions complètes (et non Express/lite) de Visual C++ 7.1 (Visual Studio 2002) et supérieures ; les utilisateurs peuvent ignorer ces étapes, à moins qu'ils aient choisi d'utiliser une version plus récente ou différente du SDK.
Pour pouvoir utiliser Visual C++ 6.0 or 7.0 (Studio 2000
.NET), l'environnement du SDK de la plate-forme doit être préparé en utilisant le
script setenv.bat (installé par le SDK de la plate-forme) avant de
lancer la compilation en ligne de commande ou l'interface GUI
msdev/devenv. L'installation du SDK de la plate-forme pour les
versions Express de Visual Studio (2003 et supérieures) devrait
ajuster l'environnement par défaut de manière appropriée.
"c:\Program Files\Microsoft Visual Studio\VC98\Bin\VCVARS32"
"c:\Program Files\Platform SDK\setenv.bat"
Perl et awk
De nombreuses étapes recommandées ici nécessitent un interpréteur perl durant le processus de préparation de la compilation.
Pour installer Apache à partir du système de compilation, de
nombreux fichiers sont modifiés via l'utilitaire
awk.exe. awk effectue la modification des fichiers
au moment de l'installation ; il a été choisi car il nécessite
un téléchargement de petite taille (par rapport à Perl ou
WSH/VB). Le site de Brian Kernighan http://www.cs.princeton.edu/~bwk/btl.mirror/ propose un
binaire précompilé pour Win32, http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe, que
vous devez enregistrer sous le nom awk.exe (plutôt
que awk95.exe).
awk.exe que dans la variable PATH, ou dans le
chemin des exécutables spécifié par l'option de menu Tools ->
Options -> (Projects ->) Directories. Assurez-vous
qu'awk.exe est bien dans votre chemin système.gawk.exe et que le
fichier awk.exe est en fait un lien symbolique vers
le fichier gawk.exe. Le shell de commandes Windows
ne reconnaît pas les liens symboliques, et par conséquent la
compilation d'InstallBin échouera. Pour contourner le problème,
vous pouvez supprimer le lien awk.exe de
l'installation de Cygwin, et copier gawk.exe vers
awk.exe. Notez aussi que les portages cygwin/mingw
de gawk 3.0.x étaient bogués ; veuillez par conséquent effectuer
une mise à jour vers la version 3.1.x avant l'utilisation de
tout portage de gawk.[Optionnel] bibliothèque zlib (pour le module
mod_deflate)
Zlib doit être installée dans un sous-répertoire du
répertoire srclib et nommé zlib. Elle
doit être compilée directement à cette place. Zlib est
disponible à l'adresse http://www.zlib.net/ -- le
fonctionnement correct du module mod_deflate a
été vérifié avec la version 1.2.3.
nmake -f win32\Makefile.msc
nmake -f win32\Makefile.msc test
[Optionnel] Bibliothèques OpenSSL (pour le module
mod_ssl et ab.exe avec le support
ssl)
La configuration et la compilation d'OpenSSL nécessite l'installation de perl.
Pour pouvoir compiler mod_ssl ou le projet
abs.exe, qui devient ab.c avec le support SSL
activé, vous devez
télécharger OpenSSL à l'adresse http://www.openssl.org/source/,
et l'installer dans un sous-répertoire du répertoire
srclib que vous nommerez openssl. Afin
de préparer OpenSSL à la liaison avec le module Apache mod_ssl
ou abs.exe, et désactiver les fonctionnalités d'Openssl grévées
de brevets, vous pouvez utiliser la commande de compilation
suivante :
perl Configure no-rc5 no-idea enable-mdc2 enable-zlib VC-WIN32
-Ipath/to/srclib/zlib -Lpath/to/srclib/zlib
ms\do_masm.bat
nmake -f ms\ntdll.mak
[Optionnel] Bibliothèques de bases de données (pour
mod_dbd et mod_authn_dbm)
La bibliothèque apr-util fournit un accès aux fonctionnalités clients dbm (base de données à base de clés) et dbd (base de données à base de requêtes) au serveur httpd et à certains de ses modules, comme les modules d'authentification et d'autorisation. Les fournisseurs sdbm dbm et odbc dbd sont compilés automatiquement.
Le support dbd inclut le paquet instantclient Oracle, MySQL, PostgreSQL et sqlite. Par exemple, pour les compiler tous, définissez LIB de façon à inclure le chemin des bibliothèques, INCLUDE de façon à inclure le chemin des en-têtes, et PATH de façon à inclure le chemin des dll et bin de chacun des quatre SDK, et définissez la variable d'environnement DBD_LIST de façon à indiquer au processus de compilation quels SDKs pilotes clients du sont correctement installés ; par exemple :
set DBD_LIST=sqlite3 pgsql oracle mysql
De manière similaire, le support dbm peut être étendu avec DBM_LIST pour compiler un fournisseur Berkeley DB (db) et/ou un fournisseur gdbm, en configurant tout d'abord de la même manière LIB, INCLUDE et PATH afin de s'assurer que les bibliothèques et en-têtes de la bibliothèque client sont bien disponibles.
set DBM_LIST=db gdbm
Voir le fichier README-win32.txt pour plus d'informations à propos de l'obtention des différents SDKs pilotes de bases de données.
Le projet du serveur HTTP Apache à pour politique de ne fournir que des sources de type Unix. Les paquets source de type Windows disponibles en téléchargement ont été élaborés par des contributeurs, et ne seront pas forcément reconduits pour toutes les versions. Vous pouvez cependant compiler le serveur sous Windows à partir des sources Unix en ajoutant quelques étapes supplémentaires.
perl srclib\apr\build\lineends.pl
Vous pouvez maintenant compiler le serveur via l'environnement de développement Visual Studio en utilisant l'IDE. Les compilations du serveur en ligne de commande ne sont possibles avec des sources de type Unix que si vous exportez les fichiers .mak comme indiqué ci-dessous.
Makefile.win est le makefile principal ou racine
d'Apache. Pour compiler Apache sous Windows, utilisez simplement une
des commandes suivantes pour compiler la version
release ou debug :
nmake /f Makefile.win _apacher
nmake /f Makefile.win _apached
Ces deux commandes effectuent la compilation d'Apache. Cependant, avec la deuxième, les fichiers résultants ne seront pas optimisés, ce qui va faciliter l'examen pas à pas du code pour trouver des bogues et résoudre les problèmes.
Vous pouvez indiquer vos choix en matière de fournisseurs dbd et dbm à l'aide des variables (d'environnement) additionnelles de make DBD_LIST et DBM_LIST ; voir les commentaires à propos des [Optionnel] Bibliothèques de bases de données ci-dessus. Consultez les commentaires initiaux dans Makefile.win pour plus d'options pouvant être fournies lors de la compilation.
Apache peut aussi être compilé depuis l'environnement de
développement Visual Studio de VC++. Pour simplifier ce processus,
l'espace de travail Visual Studio Apache.dsw est
fourni. Cet espace de travail expose la liste complète des projets
.dsp actifs nécessaires à l'installation binaire
complète d'Apache. Il inclut les dépendances entre projets afin que
ces derniers soient compilés selon l'ordre approprié.
Ouvrez l'espace de travail Apache.dsw, et
sélectionnez InstallBin (compilation
Release ou Debug, selon vos souhaits)
comme Active Project. InstallBin provoque la
compilation de tous les projets concernés, puis invoque
Makefile.win pour installer les exécutables et dlls
compilés. Vous pouvez modifier la valeur de INSTDIR=
via la configuration de InstallBin, onglet Général,
entrée ligne de commandes de compilation. La valeur par défaut de
INSTDIR est le répertoire /Apache2. Si
vous désirez effectuer un test de compilation (sans installation),
sélectionnez le projet BuildBin.
Les fichiers projets .dsp sont distribués au format
Visual Studio 6.0 (98). Visual C++ 5.0 (97) les reconnaît. Les
utilisateurs de Visual Studio 2002 (.NET) et versions supérieures
doivent convertir Apache.dsw et les fichiers
.dsp en un projet Apache.sln, ainsi que
les fichiers .msproj ; assurez-vous de reconvertir le
fichier .msproj si l'un des fichiers source
.dsp est modifié ! Cette opération est vraiment très
simple, il suffit de réouvrir Apache.dsw dans l'IDE
VC++ 7.0 et de le reconvertir.
perl srclib\apr\build\cvtdsp.pl -2005
perl srclib\apr\build\cvtdsp.pl -ossl11
Les utilisateurs de Visual Studio 2002 (.NET) et versions
supérieures doivent aussi utiliser
la boîte de dialogue Configuration Manager du menu Build pour
décocher les deux versions Debug et
Release des modules mod_ssl
et mod_deflate pour abs. Ces modules
sont compilés
en invoquant nmake ou directement l'IDE avec la cible
BinBuild pour compiler ces modules de manière
conditionnelle si les sous-répertoires de srclib
openssl et/ou zlib existent, et en
fonction des définitions des variables d'environnement
DBD_LIST et DBM_LIST.
Les fichiers .mak exportés posent plus de problèmes,
mais les utilisateurs de Visual C++ 5.0 en ont besoin pour compiler
mod_ssl, abs (ab avec support
SSL) et/ou mod_deflate. Les fichiers .mak
supportent aussi un choix plus large de distributions de chaînes
d'outils C++, comme Visual Studio Express.
Vous devez tout d'abord compiler tous les projets afin de créer
toutes les cibles dynamiques auto-générées, de façon à ce que les
dépendances puissent être interprétées correctement. Compilez
l'ensemble du projet depuis l'IDE Visual Studio 6.0 (98), en
utilisant la cible BuildAll, puis utilisez le menu de
projet Export pour tous les makefiles (en cochant "with
dependencies"). Utilisez la commande suivante pour transformer les
chemins absolus en chemins relatifs de façon à ce que la compilation
puisse s'effectuer depuis n'importe quelle position dans
l'arborescence :
perl srclib\apr\build\fixwin32mak.pl
Vous devez exécuter cette commande depuis la racine de
l'arborescence des sources de httpd. Tout fichier projet
.mak et .dep du répertoire courant et de
ses sous-répertoires sera corrigé, et les repères de temps ajustés
en fonction des .dsp.
Vérifiez toujours le SDK de la plate-forme ou autres chemins
fichiers locaux, spécifiques à la machine dans les fichiers
.mak et .dep générés. Le répertoire
DevStudio\Common\MSDev98\bin\ (VC6) contient un fichier
sysincl.dat qui énumère toutes les exceptions. Mettez à
jour ce fichier (en particulier les chemins avec slashes et
anti-slashes, tels que sys/time.h et
sys\time.h) de façon à ignorer ces nouvelles
dépendances. Inclure les chemins d'installation locale dans un
fichier .mak distribué fera échouer la
compilation.
Si vous soumettez un patch qui modifie les fichiers projet, nous devons valider la modification de ces fichiers projet au format Visual Studio 6.0. Les modifications doivent êtres simples, avec un minimum de drapeaux de compilation et d'édition de liens qui pourront être reconnus par tous les environnements Visual Studio.
Une fois compilé, Apache doit être installé dans le répertoire
racine du serveur. La valeur par défaut est le répertoire
\Apache2, sur le même disque.
Pour compiler et installer automatiquement tous les fichiers dans
le répertoire rep désiré, utilisez une des commandes
nmake suivantes :
nmake /f Makefile.win installr INSTDIR=dir
nmake /f Makefile.win installd INSTDIR=dir
L'argument rep de INSTDIR permet de
spécifier le répertoire d'installation ; il peut être omis si Apache
doit être installé dans \Apache22 (du lecteur de disque
courant.
.dsp sont
maintenus d'une distribution release à l'autre. Les
fichiers .mak ne sont PAS régénérés, suite à
l'énorme perte de temps des relecteurs . Vous ne
pouvez donc pas utiliser les commandes NMAKE
ci-dessus pour compiler des fichiers de projet .dsp
révisés si vous n'exporter pas ensuite vous-même tous les
fichiers .mak du projet. Ceci n'est pas nécessaire
si vous effectuez la compilation depuis l'environnement
Microsoft Developer Studio.La documentation principale pour ce mécanisme de compilation se trouve
dans le fichier README.cmake situé dans l'arborescence
des sources. Consultez ce fichier pour des instructions détaillées.
Pour compiler httpd avec cmake, vous devez compiler APR et APR-util
séparément. Consultez les fichiers README.cmake de ces
projets pour obtenir des instructions.
Les principales limitations de la compilation basée sur cmake sont héritées du projet APR-util et sont énumérées ci-dessous à cause de leur impact sur httpd :
mod_charset_lite et probablement
d'autres modules tiers.Serveur HTTP Apache Version 2.4
Alors que de nombreuses distributions mettent à disposition des paquets Apache httpd supportés par le système d'exploitation sous-jacent, il peut s'avérer nécessaire d'installer et d'utiliser la version de base d'Apache httpd en remplacement de la version des paquets.
Bien que le projet Apache httpd ne crée pas actuellement de paquets RPM pour les différentes distributions, il est aisé de construire votre propre paquet RPM à partir du tarball de base d'Apache httpd.
Ce document explique comment construire, installer, configurer et exécuter Apache httpd 2.4 sur les systèmes Unix à base de paquets RPM.
Création d'un paquet RPM source Création d'un paquet RPM Installation du serveur Configuration de l'instance par défaut d'Apache httpd Configuration d'instances d'Apache httpd supplémentaires sur
la même machineLe tarball d'Apache httpd peut être converti en paquet SRPM de la manière suivante :
rpmbuild -ts httpd-2.4.x.tar.bz2
Le tarball d'Apache httpd peut être converti en paquet RPM de la manière suivante :
rpmbuild -tb httpd-2.4.x.tar.bz2
Il sera nécessaire d'installer les paquets "-devel"
correspondants avant de construire les RPMs ; à cet effet, la
commande rpmbuild détecte automatiquement les RPMs
requis et en donne la liste sous forme de dépendances manquantes sur
votre système. Ces paquets "-devel" ne seront d'ailleurs plus
nécessaires une fois la création des RPMs terminée, et pourront
alors être supprimés sans risque.
Si tout va bien, les RPMs suivants seront créés :
mod_ldap et
mod_authnz_ldap avec les dépendances
correspondantes sur openldap.mod_lua avec les dépendances
correspondantes sur lua.mod_proxy_html avec les
dépendances correspondantes sur libxml2.mod_socache_dc avec les
dépendances correspondantes sur distcache.mod_ssl avec les
dépendances correspondantes sur openssl.Le RPM httpd est le seul paquet nécessaire pour
obtenir un serveur de base fonctionnel. Vous pouvez l'installer
comme suit :
rpm -U httpd-2.4.x-1.i686.rpm
Le jeu de modules standards est inclus dans le serveur. Les modules qui dépendent de bibliothèques externes sont fournis en tant que paquets RPM séparés et doivent être installés si nécessaire.
Les répertoires par défaut sont
/etc/httpd pour la configuration du serveur, et
/var/log/httpd pour la journalisation. L'environnement
par défaut du serveur web est défini dans le répertoire optionnel
/etc/sysconfig/httpd.
Démarrez le serveur comme suit :
service httpd restart
Il est possible d'exécuter simultanément plusieurs instances du serveur Apache httpd sur la même machine. Chaque instance peut posséder sa propre configuration et en fonction de cette dernière, s'exécuter sous un utilisateur différent.
Pour parvenir à ce résultat, on a fait en sorte que le script de démarrage de httpd ait connaissance de son propre nom. Ce nom est par la suite utilisé pour trouver le fichier d'environnement associé au serveur, et par conséquent, la racine de l'instance du serveur considéré.
Pour créer une instance supplémentaire appelée
httpd-additional, suivez ces étapes :
ln -s /etc/rc.d/init.d/httpd /etc/rc.d/init.d/httpd-additional
chkconfig --add httpd-additional
/etc/sysconfig/httpd comme modèle :
# création du fichier d'environnement à partir du modèle httpd
cp /etc/sysconfig/httpd /etc/sysconfig/httpd-additional
# création du fichier d'environnement à partir de zéro
touch /etc/sysconfig/httpd-additional
/etc/sysconfig/httpd-additional et
définissez la racine de la nouvelle instance du serveur via la
variable d'environnement OPTIONS.
OPTIONS="-d /etc/httpd-additional -f conf/httpd-additional.conf"
/etc/httpd-additional/conf/httpd-additional.conf et
assurez-vous que les ports et chemins sont correctement définis.
service httpd-additional restart
Apache HTTP Server Version 2.4
ġ Ϸ ġǾ Ѵ:
ũ
ũ ּ 50 MB Ǿ Ѵ. ġ ġĿ ϴ α ij ϰ 10 MB ʿϴ. ũ 뷮 ڰ Ȥ ̺귯 ũ ٸ.
Microsoft Visual C++ 5.0 ̻.
ġ ϰų Visual Studio IDE
Workbench ȿ ִ. Ѵٸ
vcvars32 ġ ϴ PATH,
INCLUDE, LIB ȯ溯
ʿϴ:
"c:\Program Files\DevStudio\VC\Bin\vcvars32.bat"
Windows Platform SDK.
ġ Ϸ Visual C++ 5.0 ߰
ֽ Microsoft Windows Platform SDK ʿϴ.
Ѵٸ setenv ġ Platform
SDK ȯ :
"c:\Program Files\Platform SDK\setenv.bat"
Visual C++ 6.0 ̻ Ե Platform SDK ϴ. ϴ ڴ ص ȴ.
mod_isapi Ϸ
ֽ Windows Platform SDK ʿϴ. ֽ ƴϸ
MSVC++ 5.0 mod_isapi Ϻθ
ٰ Ѵ. http://msdn.microsoft.com/downloads/sdks/platform/platform.asp
ֽ ִ.awk (awk, gawk ).
ýۿ ġ ġϷ
awk.exe Ͽ ؾ
Ѵ. (Perl̳ WSH/VB Ͽ) ٿޱ ſ ۰
۾ Ͽ awk ߴ. Brian Kernighan
http://cm.bell-labs.com/cm/cs/who/bwk/ Ʈ
ϵ Win32 http://cm.bell-labs.com/cm/cs/who/bwk/awk95.exe
ִ. ̸ awk95.exe
awk.exe ؾ Ѵ.
awk.exe ã´. Ͽ awk.exe
θ ߰ϰ, ʿϴٸ PATH ȯ溯
߰Ѵ.gawk.exe ̸ awk ,
awk.exe gawk.exe
ɺũ ϶. Windows Ʈ ɺũ
ν ϱ InstallBin Ҷ Ѵ.
ذå cygwin awk.exe ϰ
gawk.exe ̸ awk.exe
ٲ۴.[] OpenSSL ̺귯 (mod_ssl
ab.exe ssl )
: ȣȭ Ư㰡 ɸ 迡 ϴµ ִ. OpenSSL ̱ ϸ ̱ Ÿ Ư ȣǴ ȣȭ Ѵ. Apache Software Foundation OpenSSL Ʈ OpenSSL Ʈ ϴ ڵ带 , , ϴµ ڹ ʴ´. ޱ ٶ. ൿ å ſ ִ.
mod_ssl̳ (SSL ϴ
ab.exe) abs Ʈ Ϸ, OpenSSL
http://www.openssl.org/source/ ٿƼ
srclib openssl̶
丮 ġؾ Ѵ. release
debug ġ Ҷ ϸ 0.9.7
ִ Ư㰡 ɸ ʴ´ٸ, Ʒ
ɾ Ѵ:
perl Configure VC-WIN32
perl util\mkfiles.pl >MINFO
perl util\mk1mf.pl dll no-asm no-mdc2 no-rc5 no-idea VC-WIN32 >makefile
perl util\mk1mf.pl dll debug no-asm no-mdc2 no-rc5 no-idea VC-WIN32 >makefile.dbg
perl util\mkdef.pl 32 libeay no-asm no-mdc2 no-rc5 no-idea >ms\libeay32.def
perl util\mkdef.pl 32 ssleay no-asm no-mdc2 no-rc5 no-idea >ms\ssleay32.def
nmake
nmake -f makefile.dbg
[] zlib ҽ (mod_deflate
)
Zlib srclib zlib
丮 ġؾ , ҽ ̸
ʿ . ý ҽ
mod_deflate Ѵ.
Zlib http://www.gzip.org/zlib/ ִ --
mod_deflate 1.1.4
ϵǾ.
丮 ġ Ǭ.
Ʈ 丮 cdѴ.
Makefile.win Ͽ ġ makefile
ִ. Windows NT release debug
ϴ ɾ :
nmake /f Makefile.win _apacher nmake /f Makefile.win _apached
ɾ ġ Ѵ. ڴ Ͽ Ͽ ã ϱ Ѵ.
VC++ Visual Studio ȯ Ͽ ġ
ִ. Ϸ Visual Studio workspace
Apache.dsw Ѵ. workspace
ġ ̳ʸ ʿ .dsp Ʈ
ִ. , ˸ ϱ Ʈ
Ѵ.
Apache.dsw workspace
InstallBin (Release
Debug ϴ ) Active Project Ѵ.
InstallBin õ Ʈ ϰ,
ϵ ϰ dll ű Makefile.win
ȣѴ. InstallBin Settings, General ,
Build command line Ͽ INSTDIR=
ִ. INSTDIR= ⺻
/Apache2 丮̴. (ġʰ) Ʈ
ϸ غ BuildBin Ʈ
Ѵ.
.dsp Ʈ Visual C++ 6.0 ̴.
Visual C++ 5.0 (97) ִ. Visual
C++ 7.0 (.net) Apache.dsw .dsp
ϵ Apache.sln .msproj
ϵ ȯѴ. .dsp ҽ ϸ
ݵ .msproj Ϸ ٽ ȯ϶! ׳ VC++
7.0 IDE Apache.dsw ٽ ⸸ ϸ ȴ.
, Visual C++ 7.0 (.net) ڴ Build , Configuration
Manager ȭâ Debug Release
abs, mod_ssl, mod_deflate
Solution modules ؾ Ѵ. srclib
openssl̳ zlib 丮 ִ
쿡 nmake ϰų (
ϴ) IDE BinBuild Ͽ
ִ.
Export .mak ϵ ȥ, Visual
C++ 5.0 ڰ mod_ssl, abs (SSL ϴ
ab), mod_deflate Ҷ ʿϴ.
VC++ 7.0 (.net) ڿԵ binenv
nmake ϸ . VC++ 5.0̳
6.0 IDE ü Ʈ ϰ, Project Export
for all makefiles ϶. ڵ ϴ
ϰ ùٸ ؼ
Ʈ ؾ Ѵ. ɾ Ͽ θ
ϸ ο ִ:
perl srclib\apr\build\fixwin32mak.pl
httpd ҽ ֻ 丮
ɾ ؾ Ѵ. 丮 丮 ִ
.mak .dep Ʈ
ϰ, .dsp Ͽ Ͻð Ѵ.
Ʈ ٵ ġ ٸ, Ʈ Visual Studio 6.0 Ѵ. ϰ, VC++ 5.0 7.0 ȯ濡 νϴ ּ ɼǰ Ŀ ɼ ؾ Ѵ.
Apache.dsw workspace makefile.win
nmake ũƮ ġ
.dsp Ʈ Ѵ:
srclib\apr\apr.dspsrclib\apr\libapr.dspsrclib\apr-util\uri\gen_uri_delims.dspsrclib\apr-util\xml\expat\lib\xml.dspsrclib\apr-util\aprutil.dspsrclib\apr-util\libaprutil.dspsrclib\pcre\dftables.dspsrclib\pcre\pcre.dspsrclib\pcre\pcreposix.dspserver\gen_test_char.dsplibhttpd.dspApache.dsp, modules\ 丮 Ʒ κ
Ʈ ִ.
support\ 丮 ġ ϴµ
ʿ , ڰ ġ ˻ϰų ȣϰ
α ϴµ ߰ α Ʈ
ִ. Windows α support\win32\
丮 ִ.
support\ab.dspsupport\htdigest.dspsupport\htpasswd.dspsupport\logresolve.dspsupport\rotatelogs.dspsupport\win32\ApacheMonitor.dspsupport\win32\wintty.dspġ ϸ server root 丮 ġؾ Ѵ.
⺻ ũ \Apache2 丮̴.
ϰ ϴ dir ڵ
ġϷ nmake ɾ ϳ Ѵ:
nmake /f Makefile.win installr INSTDIR=dir
nmake /f Makefile.win installd INSTDIR=dir
INSTDIR dir ƱԸƮ ġ丮
Ѵ. ϸ \Apache2 ġ ġѴ.
ġѴ:
dir\bin\Apache.exe - ġ
dir\bin\ApacheMonitor.exe -
ÿ ۾ǥ dir\bin\htdigest.exe - Digest
auth ȣ dir\bin\htdbm.exe - SDBM auth
ͺ̽ ȣ dir\bin\htpasswd.exe - Basic
auth ȣ dir\bin\logresolve.exe - αϿ
dns ̸ ã dir\bin\rotatelogs.exe - α
ȯ dir\bin\wintty.exe - ܼâ
dir\bin\libapr.dll - Apache
Portable Runtime ̺귯dir\bin\libaprutil.dll - Apache
Utility Runtime ̺귯dir\bin\libhttpd.dll - Apache
Core ̺귯dir\modules\mod_*.so - о
ִ ġ dir\conf - 丮dir\logs - ִ α
丮dir\include - C dir\lib - ũ ̺귯.dsp release
. ð
.mak ʴ´. Ƿ
NMAKE ɾ Ͽ ο .dsp
Ʈ . Ʈ
.mak exportؾ Ѵ. Microsoft Developer
Studio ȯ濡 Ѵٸ ۾ ʿ.BuildBin
Ʈ (Ȥ _apacher _apached
) ϸ ſ ȴ. ߿
ڵ . ü ؾ߸
Ҷ ʿ . .mak
.mak (Ȥ .dep) Platform
SDK ϶.
DevStudio\SharedIDE\bin\ (VC5)
DevStudio\Common\MSDev98\bin\ (VC6) 丮
sysincl.dat
ִ. Ͽ ߰Ѵ
(sys/time.h sys\time.h ,
δ Ͱ 齽 θ
߰Ѵ). .mak Ͽ ǻͿ
شϴ ġΰ ִٸ Ѵ.
Ƿ srclib/apr/build/fixwin32mak.pl
Ͽ .mak Ͽ ִ θ ־
Ѵ.
Serveur HTTP Apache Version 2.4
Date: Wed, 05 Nov 1997 16:59:34 -0800 From: Rick Jones <raj@cup.hp.com> Reply-To: raj@cup.hp.com Organization: Network Performance Subject: HP-UX tuning tips
Traduction du corps du message cité ci-dessus :
Voici quelques conseils de personnalisation pour HPUX à ajouter à la page de personnalisation.
Pour HP-UX 9.X: mettre à jour vers la version 10.20
Pour HP-UX 10.[00|01|10]: mettre à jour vers la version 10.20
Pour HP-UX 10.20:
Installez le dernier patch cumulatif à propos du transport ARPA.
Ceci va vous permettre de configurer la taille de la table de
hashage de recherche de connexion TCP. La valeur par défaut est 256
conteneurs et doit être une puissance de deux. À cet effet, utilisez
adb pour modifier l'image *disque* du noyau. Le nom de la variable
est tcp_hash_size. Notez qu'il est impératif d'utiliser
"W" pour spécifier une quantité sur 32 bits, et non
"w" qui indique une valeur sur 16 bits, lors de la
modification de l'image disque car la variable
tcp_hash_size est une quantité sur 32 bits.
Comment déterminer cette valeur ? Examinez la sortie de ftp://ftp.cup.hp.com/dist/networking/tools/connhist, et
comptez le nombre total de connexions TCP existant sur le système.
Il est en général souhaitable que ce nombre divisé par la taille de
la table de hashage soit raisonnablement petit, disons inférieur à
10. Les administrateurs peuvent consulter le document SPECweb96 de
HP pour quelques réglages courants. On peut les trouver à http://www.specbench.org/. Si
un système HP-UX traite 1000 connexions SPECweb96 par seconde, une
valeur de temps TIME_WAIT de 60 secondes permettrait le
suivi de 60000 connexions TCP.
Les administrateurs peuvent tester la profondeur de leur file d'attente d'écoute avec ftp://ftp.cup.hp.com/dist/networking/misc/listenq.
Si Apache s'exécute sur un système à base de PA-8000, il est
conseillé de modifier l'exécutable Apache avec la commande chatr
afin d'utiliser une page de grande taille. La commande sera du style
"chatr +pi L <BINARY>". Le GID de l'exécutable en
cours de fonctionnement doit posséder le privilège
MLOCK. Pour assigner ce privilège MLOCK,
consultez Setprivgrp(1m). La modification peut être
validée en exécutant Glance et en examinant les portions de mémoire
du/des serveur(s) afin de s'assurer qu'elles montrent une fraction
non triviale du segment de texte verrouillé.
Si Apache s'exécute sur un système MP (multi-processeurs), il est
conseillé d'écrire un petit programme qui utilise
mpctl() et permettant d'associer les processus aux
processeurs. Un simple algorithme pid % numcpu suffira
probablement. Cette modification peut aussi être ajoutée dans le
code source.
Si l'administrateur s'intéresse au nombre de connexions
FIN_WAIT_2, il peut utiliser nettune pour diminuer la
valeur de tcp_keepstart. Il devra cependant être
prudent - surtout ne pas diminuer cette valeur en dessous de, disons
deux à quatre minutes. Si tcp_hash_size a été défini,
il est probablement approprié de laisser les connexions
FIN_WAIT_2 prendre plus de temps à expirer (peut-être
même la valeur par défaut de deux heures) - elles n'auront en
général pas un grand impact sur les performances.
On peut ajouter d'autres choses au code de base, mais elles feront peut-être l'objet d'un autre email. N'hésitez pas à m'envoyer un message si vous êtes intéressé.
sincèrement ,
rick jones
Apache HTTP Server Version 2.4
This document explains how to install, configure and run Apache 2.4 under Microsoft Windows.
There are many important points before you begin compiling Apache. This document explain them.
This document explains how to build, install, and run Apache 2.4 on systems supporting the RPM packaging format.
This document explains how to install, configure and run Apache 2.4 under Novell NetWare 5.1 and above.
Version 1.3 of the Apache HTTP Server is the first version which includes a port to a (non-ASCII) mainframe machine which uses the EBCDIC character set as its native codeset.
Serveur HTTP Apache Version 2.4
Ce document explique l'installation, la configuration et le lancement d'Apache 2.0 sous Novell NetWare 6.0 et les versions ultérieures. Si vous trouvez une bogue, ou voulez tout simplement contribuer de quelque manière que ce soit, utilisez s'il vous plait notre page des rapports de bogues.
La page des rapports de bogues et la liste de diffusion dev-httpd ne doivent pas être utilisées pour poser des questions à propos de la configuration ou du lancement d'Apache. Avant de soumettre un rapport de bogue ou une question, consultez ce document, la FAQ ou tout autre sujet de la documentation en rapport avec votre problème. Si vous n'avez toujours pas résolu votre problème, postez votre question dans le newsgroup novell.devsup.webserver, où de nombreux utilisateurs d'Apache sont prêts à répondre à toutes les nouvelles et obscures questions à propos de l'utilisation d'Apache sous Netware.
Dans la majeure partie de ce document, vous êtes sensé avoir installé Apache à partir d'une distribution binaire. Si vous voulez compiler Apache vous-même (par exemple pour aider au développement, ou pour rechercher des bogues), reportez-vous à la section traitant de la Compilation d'Apache pour Netware ci-dessous.
Prérequis Téléchargement d'Apache pour NetWare Installation d'Apache pour NetWare Exécuter Apache pour NetWare Configuration d'Apache pour NetWare Compilation d'Apache pour NetWareApache 2.0 nécessite NetWare 6.0 service pack 3 et supérieurs pour fonctionner. Si vous utilisez un service pack antérieur à SP3, vous devez installer les dernières Bibliothèques Netware pour C (LibC).
Vous trouverez les service packs Netware ici.
Apache 2.0 pour NetWare peut aussi fonctionner dans un environnement NetWare 5.1, à partir du moment où le dernier service pack ou la dernière version des Bibliothèques Netware pour C (LibC) ont été installés. ATTENTION : Apache 2.0 pour NetWare n'a pas été testé dans cet environnement car il n'a pas été conçu pour ce dernier.
Les informations à propos de la dernière version d'Apache sont disponibles sur le site web d'Apache à http://www.apache.org/. Vous y trouverez la version courante, des versions alpha ou bêta-test plus récentes, ainsi que des sites miroirs et des sites FTP anonymes. Les distributions binaires des dernières versions d'Apache 2.0 pour NetWare sont disponibles ici.
Il n'existe pas actuellement de programme d'installation d'Apache pour Netware. Si vous installez Apache 2.0 pour NetWare à partir des sources, vous devrez copier les fichiers sur le serveur manuellement.
Suivez ces instructions pour installer Apache sous Netware à
partir de la distribution binaire (en supposant que vous effectuez
l'installation dans sys:/apache2) :
SYS: (vous pouvez cependant l'installer dans
tout volume)httpd.conf et définissez les
directives ServerRoot et
ServerName avec les valeurs
correctes des chemins de fichiers qui correspondent à la
configuration de votre serveur.SYS:/APACHE2 au chemin de recherche, par
une commande du style : SEARCH ADD
SYS:\APACHE2
Suivez ces instructions pour installer Apache pour Netware
manuellement à partir de votre propre répertoire de sources (en
supposant que vous effectuez l'installation dans
sys:/apache2) :
Apache2
dans un volume Netware.APACHE2.NLM, APRLIB.NLM dans
SYS:/APACHE2.BIN dans
SYS:/APACHE2.HTDIGEST.NLM, HTPASSWD.NLM,
HTDBM.NLM, LOGRES.NLM,
ROTLOGS.NLM dans SYS:/APACHE2/BIN.CONF dans
SYS:/APACHE2.HTTPD-STD.CONF dans le
répertoire SYS:/APACHE2/CONF et renommez-le en
HTTPD.CONF.MIME.TYPES,
CHARSET.CONV et MAGIC dans le répertoire
SYS:/APACHE2/CONF.\HTTPD-2.0\DOCS\ICONS dans
SYS:/APACHE2/ICONS.\HTTPD-2.0\DOCS\MANUAL dans
SYS:/APACHE2/MANUAL.\HTTPD-2.0\DOCS\ERROR dans
SYS:/APACHE2/ERROR.\HTTPD-2.0\DOCS\DOCROOT dans
SYS:/APACHE2/HTDOCS.SYS:/APACHE2/LOGS sur le
serveur.SYS:/APACHE2/CGI-BIN sur le
serveur.SYS:/APACHE2/MODULES et
copiez tous les modules nlm dans le répertoire
modules.HTTPD.CONF, et recherchez
toutes les marques @@Value@@ afin de les remplacer
par les valeurs appropriées.SYS:/APACHE2 au chemin de recherche, par
une commande du style : SEARCH ADD
SYS:\APACHE2
Outre le volume par défaut SYS, Apache peut être
installé dans tout autre volume.
Au cours du processus d'installation, l'ajout du mot-clé
"install" à la ligne de commande du makefile va provoquer la
construction d'une distribution complète sous forme d'un paquetage
dans le sous-répertoire DIST. Vous pouvez simplement
installer Apache en copiant la distribution créée précédemment à la
racine d'un volume Netware (voir Compilation
d'Apache pour NetWare ci-dessous).
Pour démarrer Apache, tapez simplement apache dans
la console. Ceci aura pour effet de charger Apache dans l'espace
d'adressage du système d'exploitation. Si vous préférez charger
Apache dans un espace d'adressage protégé, vous pouvez spécifier cet
espace d'adressage à l'aide de l'instruction de chargement suivante
:
load address space = apache2 apache2
Cette instruction va charger Apache dans un espace d'adressage appelé apache2. Il est possible d'exécuter plusieurs instances simultanées d'Apache sous Netware, en chargeant chacune d'entre elles dans son propre espace d'adressage protégé.
Une fois démarré, Apache écoute le port 80 (à moins que vous
n'ayez modifié la directive Listen dans les fichiers de
configuration). Pour vous connecter au serveur et afficher la page
par défaut, lancez un navigateur et entrez le nom du serveur ou son
adresse IP. Vous devriez voir une page de bienvenue, et un lien vers
le manuel Apache. Si rien ne se produit, ou si vous obtenez un
message d'erreur, consultez le fichier error_log dans
le répertoire logs.
Lorsque votre installation de base fonctionne, vous devez la
configurer correctement en éditant les fichiers du répertoire
conf.
Pour arrêter une instance d'Apache s'exécutant dans l'espace d'adressage du système d'exploitation, entrez simplement dans la console :
unload apache2
ou
apache2 shutdown
Si Apache s'exécute dans un espace d'adressage protégé, spécifiez cet espace d'adressage dans l'instruction d'arrêt :
unload address space = apache2 apache2
Lorsqu'on travaille avec Apache, il est important de savoir comment il trouve ses fichiers de configuration. Vous pouvez spécifier un fichier de configuration sur la ligne de commande de deux manières :
-f spécifie un chemin vers un fichier de
configuration particulier
apache2 -f "vol:/nom-serveur/conf/fich-conf.conf"
apache -f test/test.conf
Dans ces cas, la directive ServerRoot doit être correctement définie
dans le fichier de configuration.
Si vous ne spécifiez pas de nom de fichier de configuration avec
l'option -f, Apache utilisera le nom de fichier codé en
dur dans le serveur, en général conf/httpd.conf.
L'invocation d'Apache avec l'option -V indiquera ce nom
comme valeur de l'étiquette SERVER_CONFIG_FILE. Apache
va ensuite déterminer son ServerRoot en effectuant les tests
suivants, dans cet ordre
ServerRoot via une option
-C switch.-d.La racine du répertoire d'installation codée en dur dans le
serveur est en général sys:/apache2. L'invocation
d'Apache avec l'option -V indiquera ce chemin comme
valeur de l'étiquette HTTPD_ROOT.
Apache 2.0 pour Netware comporte un jeu d'options de ligne de
commande permettant d'afficher ou de modifier certaines
caractéristiques de l'instance du serveur web en cours d'exécution.
Ces options ne sont disponibles que lorsqu'Apache est en cours
d'exécution. Chacune de ces options doit être précédée du mot-clé
APACHE2.
Par défaut, ces options sont passées à l'instance d'apache s'exécutant dans l'espace d'adressage du système d'exploitation. Pour passer une option à une instance d'Apache spécifique s'exécutant dans un espace d'adressage protégé, ajouter le paramètre -p suivi du nom de l'espace d'adressage. Pour plus d'informations, tapez "apache2 Help" sur la ligne de commande.
Apache lit en général ses fichiers de configuration dans le
répertoire conf. Ces fichiers sont les mêmes que ceux
de la version Unix, mais quelques directives sont différentes sous
Netware. Voir la Documentation Apache pour
l'ensemble des directives disponibles.
Les principales différences propres à Apache pour NetWare sont :
Comme Apache pour Netware est une application multithread, elle n'utilise pas de processus séparé pour chaque requête, comme c'est le cas pour certaines implémentations sous Unix. Il n'y a que des threads en cours d'exécution : un thread parent, et plusieurs threads enfants ou worker qui traitent les requêtes.
En conséquence, les directives de gestion des "processus" sont différentes :
MaxConnectionsPerChild - comme sous
Unix, cette directive contrôle le nombre maximum de connexions
qu'un worker thread peut traiter avant de s'arrêter. Avec la
valeur par défaut MaxConnectionsPerChild 0,
le thread va pouvoir traiter un nombre illimité de requêtes.
Cette valeur est recommandée sous Netware, à moins que vous
n'ayez des raisons particulières de la modifier.
StartThreads -
Cette directive indique au serveur le nombre de threads qu'il
doit lancer au démarrage. Il est recommandé de conserver la
valeur par défaut StartThreads 50.
MinSpareThreads -
Cette directive indique au serveur le nombre de worker threads
additionnels qu'il doit lancer si le nombre de threads inactifs
tombe en dessous de cette valeur. Il est recommandé de conserver la
valeur par défaut MinSpareThreads 10.
MaxSpareThreads -
Cette directive indique au serveur qu'il doit commencer à
arrêter des worker threads si le nombre de threads inactifs
passe au dessus de cette valeur. Il est recommandé de conserver
la valeur par défaut MaxSpareThreads 100.
MaxThreads -
Cette directive impose un nombre maximum de worker threads. Il
est recommandé de conserver la valeur par défaut
ThreadsPerChild 250.
ThreadStackSize -
Cette directive indique au serveur la taille de la pile à
utiliser pour un worker thread individuel. Il est recommandé de
conserver la valeur par défaut ThreadStackSize
65536.
Les directives qui acceptent des noms de fichiers comme
arguments ne doivent pas utiliser des noms de fichiers Unix,
mais des noms de fichiers Netware. Cependant, comme Apache
utilise des noms de style Unix en interne, on doit utiliser des
slashes et non des antislashes. Il est recommandé de préfixer
tous les chemins de fichiers racines par un nom de volume. Si ce
dernier est omis, Apache supposera que le volume est
SYS:, ce qui n'est pas forcément correct.
Apache pour Netware a la possibilité de charger des modules
en cours d'exécution, sans avoir à recompiler le serveur. Si
Apache est compilé avec les options par défaut, il va installer
de nombreux modules optionnels dans le répertoire
\Apache2\modules. Pour les activer, ou en activer
d'autres, on doit utiliser la directive LoadModule. Par exemple, pour
activer le module status, ajoutez la ligne suivante :
LoadModule status_module modules/status.nlm
Des informations à propos de la création de modules chargeables sont aussi disponibles.
CGIMapExtension -
Cette directive associe une extension de fichier CGI à un
interpréteur de script.SecureListen -
Cette directive active le chiffrement SSL pour un port
spécifique.NWSSLTrustedCerts -
Cette directive permet d'ajouter des certificats de confiance
pouvant être utilisés pour créer des connexions sécurisées vers
des serveurs mandataires.NWSSLUpgradeable -
Cette directive permet de faire passer en SSL une connexion
initialisée sur les adresse IP et Port spécifiés.La compilation d'Apache nécessite MetroWerks CodeWarrior 6.x ou
supérieur. Une fois compilé, Apache peut être installé à la racine
de tout volume Netware. Le répertoire d'installation par défaut est
sys:/Apache2.
Avant de démarrer Apache, vous devez remplir le répertoire
conf. Copiez le fichier HTTPD-STD.CONF
depuis le répertoire conf de la distribution et
renommez-le en HTTPD.CONF. Editez le fichier
HTTPD.CONF en recherchant les repères
@@Value@@, et remplacez ces derniers par la valeur
appropriée. Copiez de même les fichiers conf/magic et
conf/mime.types. Vous pouvez aussi construire une
distribution complète en ajoutant le mot-clé install
lors de l'invocation des makefiles.
Les outils de développement suivants sont nécessaires pour la compilation d'Apache pour Netware :
awk.exe.NOVELLLIBC avec le chemin des bibliothèques Netware
pour C SDK ; par exemple : Set
NOVELLLIBC=c:\novell\ndk\libc
METROWERKS avec le chemin de votre compilateur
Metrowerks CodeWarrior ; par exemple : Set
METROWERKS=C:\Program Files\Metrowerks\CodeWarrior
C:\Program Files\Metrowerks\CodeWarrior, vous
n'avez pas besoin de définir cette variable.LDAPSDK
avec le chemin des bibliothèques LDAP pour C ; par exemple :
Set
LDAPSDK=c:\Novell\NDK\cldapsdk\NetWare\libc
ZLIBSDK
avec le chemin du code source de la bibliothèque Zlib ; par
exemple : Set ZLIBSDK=D:\NOVELL\zlib
PCRESDK
avec le chemin d'installation du code source de la bibliothèque
PCRE ; par exemple :
Set PCRESDK=D:\NOVELL\pcre
AP_WORK
avec le chemin du code source de httpd.
Set AP_WORK=D:\httpd-2.0.x
APR_WORK
avec le chemin du code source d'apr ; en général
\httpd\srclib\apr, mais le projet APR peut se
trouver en dehors de la structure des répertoires de httpd.
Set APR_WORK=D:\apr-1.x.x
APU_WORK
avec le chemin du code source d'apr-util ; en
général \httpd\srclib\apr-util, mais le projet
APR-UTIL peut se trouver en dehors de la structure des
répertoires de httpd. Set
APU_WORK=D:\apr-util-1.x.x
gmake.exe) ont bien été inclus dans la variable
d'environnement système PATH.\httpd-2.0
et compilez les utilitaires précompilés à l'aide de la commande
"gmake -f nwgnumakefile prebuild". Cette cible va
créer le répertoire \httpd-2.0\nwprebuild, et y
copier tous les utilitaires nécessaires au franchissement des
étapes suivantes de la compilation.\httpd-2.0\nwprebuild\GENCHARS.nlm et
\httpd-2.0\nwprebuild\DFTABLES.nlm vers le volume
SYS: d'un serveur Netware et exécutez-les à l'aide
des commandes suivantes :
SYS:\genchars > sys:\test_char.h
SYS:\dftables sys:\chartables.c
test_char.h et
chartables.c vers le répertoire
\httpd-2.0\os\netware de la machine où s'effectue
la compilation.\httpd-2.0
et compilez Apache à l'aide de la commande "gmake -f
nwgnumakefile". Vous pouvez créer un répertoire pour la
distribution en ajoutant le paramètre install à la commande ;
par exemple :
gmake -f nwgnumakefile install
gmake -f nwgnumakefileCompile les versions
de distribution de tous les binaires et les copie dans un
répertoire \release.
gmake -f nwgnumakefile DEBUG=1Compile les versions
de débogage de tous les binaires et les copie dans un
répertoire \debug.
gmake -f nwgnumakefile installCrée une
distribution complète d'Apache avec les binaires, la
documentation et les fichiers support dans un répertoire
\dist\Apache2.
gmake -f nwgnumakefile prebuildCompile tous
les utilitaires précompilés et les copie dans le répertoire
\nwprebuild.
gmake -f nwgnumakefile installdevMême effet
que l'option install, mais en plus, les répertoires
\lib et \include sont créés dans le
répertoire de destination, et les en-têtes et fichiers d'import
y sont copiés.
gmake -f nwgnumakefile cleanSupprime tous
les fichiers objets et les binaires de la zone de compilation
\release.o, ou \debug.o si
DEBUG a été défini.
gmake -f nwgnumakefile clobber_allMême effet que clean, mais en plus, le répertoire de la distribution est supprimé s'il existe.
EXPERIMENTAL :
Set EXPERIMENTAL=1
USE_STDSOCKETS :
Set USE_STDSOCKETS=1
Pour fournir les services SSL, Apache pour Netware utilise par
défaut le module intégré mod_nw_ssl. Ce module ne
fournit que les services SSL implémentés par le système
d'exploitation Netware lui-même pour gérer tous les chiffrements
pour un port donné. Cependant, on peut aussi utiliser mod_ssl de
la même manière que sur les autres plate-formes.
Afin de pouvoir compiler mod_ssl pour la plate-forme Netware, les bibliothèques OpenSSL doivent être disponibles. Elles peuvent être installées de la manière suivante :
NetWare/set_env.bat, et
effectuez toutes modifications nécessaires des chemins des
outils et utilitaires en fonction de votre environnement de
développement.
Netware\set_env netware-libc
Netware\build netware-libc
Netware\build netware-libc nw-nasm enable-mdc2 enable-md5
OSSLSDK avec le chemin absolu de
la racine du répertoire du code source d'openssl, et
définissez WITH_MOD_SSL à 1.
Set OSSLSDK=d:\openssl-0.9.8x
Set WITH_MOD_SSL=1
Apache HTTP Server Version 2.4
This document explains how to install, configure and run Apache 2.0 under Novell NetWare 6.0 and above. If you find any bugs, or wish to contribute in other ways, please use our bug reporting page.
The bug reporting page and dev-httpd mailing list are not provided to answer questions about configuration or running Apache. Before you submit a bug report or request, first consult this document, the Frequently Asked Questions page and the other relevant documentation topics. If you still have a question or problem, post it to the novell.devsup.webserver newsgroup, where many Apache users are more than willing to answer new and obscure questions about using Apache on NetWare.
Most of this document assumes that you are installing Apache from a binary distribution. If you want to compile Apache yourself (possibly to help with development, or to track down bugs), see the section on Compiling Apache for NetWare below.
Requirements Downloading Apache for NetWare Installing Apache for NetWare Running Apache for NetWare Configuring Apache for NetWare Compiling Apache for NetWareApache 2.0 is designed to run on NetWare 6.0 service pack 3 and above. If you are running a service pack less than SP3, you must install the latest NetWare Libraries for C (LibC).
NetWare service packs are available here.
Apache 2.0 for NetWare can also be run in a NetWare 5.1 environment as long as the latest service pack or the latest version of the NetWare Libraries for C (LibC) has been installed . WARNING: Apache 2.0 for NetWare has not been targeted for or tested in this environment.
Information on the latest version of Apache can be found on the Apache web server at http://www.apache.org/. This will list the current release, any more recent alpha or beta-test releases, together with details of mirror web and anonymous ftp sites. Binary builds of the latest releases of Apache 2.0 for NetWare can be downloaded from here.
There is no Apache install program for NetWare currently. If you are building Apache 2.0 for NetWare from source, you will need to copy the files over to the server manually.
Follow these steps to install Apache on NetWare from the
binary download (assuming you will install to
sys:/apache2):
SYS:
volume (may be installed to any volume)httpd.conf file setting ServerRoot and ServerName along with any file path values
to reflect your correct server settingsSYS:/APACHE2 to the search path, for example:
SEARCH ADD SYS:\APACHE2
Follow these steps to install Apache on NetWare manually
from your own build source (assuming you will install to
sys:/apache2):
Apache2 on a
NetWare volumeAPACHE2.NLM, APRLIB.NLM
to SYS:/APACHE2SYS:/APACHE2
called BINHTDIGEST.NLM, HTPASSWD.NLM,
HTDBM.NLM, LOGRES.NLM, ROTLOGS.NLM
to SYS:/APACHE2/BINSYS:/APACHE2
called CONFHTTPD-STD.CONF file to the
SYS:/APACHE2/CONF directory and rename to
HTTPD.CONFMIME.TYPES, CHARSET.CONV and
MAGIC files to SYS:/APACHE2/CONF directory\HTTPD-2.0\DOCS\ICONS
to SYS:/APACHE2/ICONS\HTTPD-2.0\DOCS\MANUAL
to SYS:/APACHE2/MANUAL\HTTPD-2.0\DOCS\ERROR
to SYS:/APACHE2/ERROR\HTTPD-2.0\DOCS\DOCROOT
to SYS:/APACHE2/HTDOCSSYS:/APACHE2/LOGS
on the serverSYS:/APACHE2/CGI-BIN
on the serverSYS:/APACHE2/MODULES
and copy all nlm modules into the modules directoryHTTPD.CONF file searching for all
@@Value@@ markers and replacing them with the
appropriate settingSYS:/APACHE2 to the search path, for example:
SEARCH ADD SYS:\APACHE2
Apache may be installed to other volumes besides the default SYS volume.
During the build process, adding the keyword "install" to the makefile command line
will automatically produce a complete distribution package under the subdirectory
DIST. Install Apache by simply copying the distribution that was produced
by the makfiles to the root of a NetWare volume (see: Compiling Apache for
NetWare below).
To start Apache just type apache at the
console. This will load apache in the OS address space. If you
prefer to load Apache in a protected address space you may
specify the address space with the load statement as follows:
load address space = apache2 apache2
This will load Apache into an address space called apache2. Running multiple instances of Apache concurrently on NetWare is possible by loading each instance into its own protected address space.
After starting Apache, it will be listening to port 80
(unless you changed the Listen
directive in the configuration files).
To connect to the server and access the default page,
launch a browser and enter the server's name or address. This
should respond with a welcome page, and a link to the Apache
manual. If nothing happens or you get an error, look in the
error_log file in the logs
directory.
Once your basic installation is working, you should
configure it properly by editing the files in the
conf directory.
To unload Apache running in the OS address space just type the following at the console:
unload apache2
or
apache2 shutdown
If apache is running in a protected address space specify the address space in the unload statement:
unload address space = apache2 apache2
When working with Apache it is important to know how it will find the configuration files. You can specify a configuration file on the command line in two ways:
-f specifies a path to a particular
configuration file
apache2 -f "vol:/my server/conf/my.conf"
apache -f test/test.conf
In these cases, the proper ServerRoot
should be set in the configuration file.
If you don't specify a configuration file name with -f,
Apache will use the file name compiled into the server, usually
conf/httpd.conf. Invoking Apache with the -V
switch will display this value labeled as SERVER_CONFIG_FILE.
Apache will then determine its ServerRoot
by trying the following, in this order:
ServerRoot directive via a
-C switch.-d switch on the command line.The server root compiled into the server is usually sys:/apache2.
invoking apache with the -V switch will display this value labeled as
HTTPD_ROOT.
Apache 2.0 for NetWare includes a set of command line directives that can
be used to modify or display information about the running instance of the
web server. These directives are only available while Apache is running. Each
of these directives must be preceded by the keyword APACHE2.
By default these directives are issued against the instance of Apache running in the OS address space. To issue a directive against a specific instance running in a protected address space, include the -p parameter along with the name of the address space. For more information type "apache2 Help" on the command line.
Apache is configured by reading configuration files usually stored
in the conf directory. These are the same as files used
to configure the Unix version, but there are a few different directives for
Apache on NetWare. See the Apache module
documentation for all the available directives.
The main differences in Apache for NetWare are:
Because Apache for NetWare is multithreaded, it does not use a separate process for each request, as Apache does on some Unix implementations. Instead there are only threads running: a parent thread, and multiple child or worker threads which handle the requests.
Therefore the "process"-management directives are different:
MaxConnectionsPerChild -
Like the Unix directive, this controls how many connections
a worker thread will serve before exiting. The recommended default,
MaxConnectionsPerChild 0, causes the thread to continue servicing
request indefinitely. It is recommended on NetWare, unless there is some
specific reason, that this directive always remain set to 0.
StartThreads -
This directive tells the server how many threads it should start initially.
The recommended default is StartThreads 50.
MinSpareThreads -
This directive instructs the server to spawn additional worker threads
if the number of idle threads ever falls below this value. The recommended
default is MinSpareThreads 10.
MaxSpareThreads -
This directive instructs the server to begin terminating worker threads
if the number of idle threads ever exceeds this value. The recommended
default is MaxSpareThreads 100.
MaxThreads -
This directive limits the total number of work threads to a maximum
value. The recommended default is ThreadsPerChild 250.
ThreadStackSize -
This directive tells the server what size of stack to use
for the individual worker thread. The recommended default
is ThreadStackSize 65536.
The directives that accept filenames as arguments must use
NetWare filenames instead of Unix names. However, because Apache
uses Unix-style names internally, forward slashes must be used
rather than backslashes. It is recommended that all rooted file paths
begin with a volume name. If omitted, Apache will assume the
SYS: volume which may not be correct.
Apache for NetWare has the ability to load modules at
runtime, without recompiling the server. If Apache is
compiled normally, it will install a number of optional
modules in the \Apache2\modules directory.
To activate these, or other modules, the LoadModule directive
must be used. For example, to active the status module, use
the following:
LoadModule status_module modules/status.nlm
Information on creating loadable modules is also available.
CGIMapExtension -
This directive maps a CGI file extension to a script interpreter.SecureListen -
Enables SSL encryption for a specified port.NWSSLTrustedCerts -
Adds trusted certificates that are used to create secure connections to proxied servers.NWSSLUpgradeable -
Allow a connection created on the specified address/port to be upgraded to an SSL connection.Compiling Apache requires MetroWerks CodeWarrior 6.x or higher. Once
Apache has been built, it can be installed to the root of any NetWare
volume. The default is the sys:/Apache2 directory.
Before running the server you must fill out the conf
directory. Copy the file HTTPD-STD.CONF from the distribution
conf directory and rename it to HTTPD.CONF.
Edit the HTTPD.CONF file searching for all @@Value@@
markers and replacing them with the appropriate setting. Copy over
the conf/magic and conf/mime.types files as well.
Alternatively, a complete distribution can be built by including the keyword
install when invoking the makefiles.
The following development tools are required to build Apache 2.0 for NetWare:
awk.exe.NOVELLLIBC to the
location of the NetWare Libraries for C SDK, for example:
Set NOVELLLIBC=c:\novell\ndk\libc
METROWERKS to the
location where you installed the Metrowerks CodeWarrior compiler,
for example:
Set METROWERKS=C:\Program Files\Metrowerks\CodeWarrior
C:\Program
Files\Metrowerks\CodeWarrior, you don't need to set this.LDAPSDK to the
location where you installed the LDAP Libraries for C, for example:
Set LDAPSDK=c:\Novell\NDK\cldapsdk\NetWare\libc
ZLIBSDK to the
location where you installed the source code for the ZLib Library,
for example:
Set ZLIBSDK=D:\NOVELL\zlib
PCRESDK to the location
where you installed the source code for the PCRE Library, for example:
Set PCRESDK=D:\NOVELL\pcre
AP_WORK to the full path of
the httpd source code directory.
Set AP_WORK=D:\httpd-2.0.x
APR_WORK to the full path of
the apr source code directory. Typically \httpd\srclib\apr
but the APR project can be outside of the httpd directory structure.
Set APR_WORK=D:\apr-1.x.x
APU_WORK to the full path of
the apr-util source code directory. Typically \httpd\srclib\apr-util
but the APR-UTIL project can be outside of the httpd directory structure.
Set APU_WORK=D:\apr-util-1.x.x
gmake.exe) have been included in the system's
PATH environment variable.\httpd-2.0 and build the prebuild utilities
by running "gmake -f nwgnumakefile prebuild". This target will create
the directory \httpd-2.0\nwprebuild and copy each of the utilities
to this location that are necessary to complete the following build steps.
\httpd-2.0\nwprebuild\GENCHARS.nlm and
\httpd-2.0\nwprebuild\DFTABLES.nlm to the SYS: volume of a
NetWare server and run them using the following commands:
SYS:\genchars > sys:\test_char.h
SYS:\dftables sys:\chartables.c
test_char.h and chartables.c
to the directory \httpd-2.0\os\netware on the build machine.\httpd-2.0 and build Apache by running
"gmake -f nwgnumakefile". You can create a distribution directory by
adding an install parameter to the command, for example:
gmake -f nwgnumakefile install
gmake -f nwgnumakefileBuilds release versions of all of the
binaries and copies them to a \release destination directory.
gmake -f nwgnumakefile DEBUG=1Builds debug versions of all of the
binaries and copies them to a \debug destination directory.
gmake -f nwgnumakefile installCreates a complete Apache
distribution with binaries, docs and additional support files in a
\dist\Apache2 directory.
gmake -f nwgnumakefile prebuildBuilds all of the prebuild utilities
and copies them to the \nwprebuild directory.
gmake -f nwgnumakefile installdevSame as install but also creates a
\lib and \include directory in the destination directory
and copies headers and import files.
gmake -f nwgnumakefile cleanCleans all object files and binaries
from the \release.o or \debug.o build areas depending on whether
DEBUG has been defined.
gmake -f nwgnumakefile clobber_allSame as clean and also deletes the distribution directory if it exists.
EXPERIMENTAL:
Set EXPERIMENTAL=1
USE_STDSOCKETS:
Set USE_STDSOCKETS=1
By default Apache for NetWare uses the built-in module
mod_nw_ssl to provide SSL services. This module
simply enables the native SSL services implemented in NetWare OS
to handle all encryption for a given port. Alternatively, mod_ssl
can also be used in the same manner as on other platforms.
Before mod_ssl can be built for the NetWare platform, the OpenSSL libraries must be provided. This can be done through the following steps:
NetWare/set_env.bat and modify any
tools and utilities paths so that they correspond to your build
environment.
Netware\set_env netware-libc
Netware\build netware-libc
Netware\build netware-libc nw-nasm enable-mdc2 enable-md5
OSSLSDK to the full path to the root of the openssl
source code directory, and set WITH_MOD_SSL to 1.
Set OSSLSDK=d:\openssl-0.9.8x
Set WITH_MOD_SSL=1
Apache HTTP Server Version 2.4
There are many important points to consider before you begin compiling Apache HTTP Server (httpd). See Using Apache HTTP Server on Microsoft Windows before you begin.
httpd can be built on Windows using a cmake-based build system or with Visual Studio project files maintained by httpd developers. The cmake-based build system directly supports more versions of Visual Studio but currently has considerable functional limitations.
Compiling Apache requires the following environment to be properly installed:
Disk Space
Make sure you have at least 200 MB of free disk space available. After installation Apache requires approximately 80 MB of disk space, plus space for log and cache files, which can grow rapidly. The actual disk space requirements will vary considerably based on your chosen configuration and any third-party modules or libraries, especially when OpenSSL is also built. Because many files are text and very easily compressed, NTFS filesystem compression cuts these requirements in half.
Appropriate Patches
The httpd binary is built with the help of several patches to third party packages, which ensure the released code is buildable and debuggable. These patches are available and distributed from http://www.apache.org/dist/httpd/binaries/win32/patches_applied/ and are recommended to be applied to obtain identical results as the "official" ASF distributed binaries.
Microsoft Visual C++ 6.0 (Visual Studio 97) or later.
Apache can be built using the command line tools, or from
within the Visual Studio IDE Workbench. The command line
build requires the environment to reflect the PATH,
INCLUDE, LIB and other variables
that can be configured with the vcvars32.bat script.
Updated Microsoft Windows Platform SDK, February 2003 or later.
An appropriate Windows Platform SDK is included by default in the full (not express/lite) versions of Visual C++ 7.1 (Visual Studio 2002) and later, these users can ignore these steps unless explicitly choosing a newer or different version of the Platform SDK.
To use Visual C++ 6.0 or 7.0 (Studio 2000 .NET), the Platform SDK
environment must be prepared using the setenv.bat
script (installed by the Platform SDK) before starting the command
line build or launching the msdev/devenv GUI environment. Installing
the Platform SDK for Visual Studio Express versions (2003 and later)
should adjust the default environment appropriately.
"c:\Program Files\Microsoft Visual Studio\VC98\Bin\VCVARS32"
"c:\Program Files\Platform SDK\setenv.bat"
Perl and awk
Several steps recommended here require a perl interpreter during the build preparation process, but it is otherwise not required.
To install Apache within the build system, several files are
modified using the awk.exe utility. awk was chosen since
it is a very small download (compared with Perl or WSH/VB) and
accomplishes the task of modifying configuration files upon
installation. Brian Kernighan's
http://www.cs.princeton.edu/~bwk/btl.mirror/
site has a compiled native Win32 binary,
http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe which
you must save with the name awk.exe (rather than
awk95.exe).
awk.exe
from the PATH, or executable path specified in the menu option
Tools -> Options -> (Projects ->) Directories. Ensure
awk.exe is in your system path.gawk.exe and that the file
awk.exe is really a symlink to the gawk.exe
file. The Windows command shell does not recognize symlinks, and
because of this building InstallBin will fail. A workaround is
to delete awk.exe from the cygwin installation and
copy gawk.exe to awk.exe. Also note the
cygwin/mingw ports of gawk 3.0.x were buggy, please upgrade to 3.1.x
before attempting to use any gawk port.[Optional] zlib library (for mod_deflate)
Zlib must be installed into a srclib subdirectory named
zlib. This must be built in-place. Zlib can be obtained
from http://www.zlib.net/ -- the
mod_deflate is confirmed to work correctly with
version 1.2.3.
nmake -f win32\Makefile.msc
nmake -f win32\Makefile.msc test
[Optional] OpenSSL libraries (for mod_ssl
and ab.exe with ssl support)
Configuring and building OpenSSL requires perl to be installed.
OpenSSL must be installed into a srclib subdirectory
named openssl, obtained from
http://www.openssl.org/source/, in order to compile
mod_ssl or the abs.exe project, which
is ab.c with SSL support enabled. To prepare OpenSSL to be linked
to Apache mod_ssl or abs.exe, and disable patent encumbered features
in OpenSSL, you might use the following build commands:
perl Configure no-rc5 no-idea enable-mdc2 enable-zlib VC-WIN32
-Ipath/to/srclib/zlib -Lpath/to/srclib/zlib
ms\do_masm.bat
nmake -f ms\ntdll.mak
[Optional] Database libraries (for mod_dbd
and mod_authn_dbm)
The apr-util library exposes dbm (keyed database) and dbd (query oriented database) client functionality to the httpd server and its modules, such as authentication and authorization. The sdbm dbm and odbc dbd providers are compiled unconditionally.
The dbd support includes the Oracle instantclient package, MySQL, PostgreSQL and sqlite. To build these all, for example, set up the LIB to include the library path, INCLUDE to include the headers path, and PATH to include the dll bin path of all four SDK's, and set the DBD_LIST environment variable to inform the build which client driver SDKs are installed correctly, e.g.;
set DBD_LIST=sqlite3 pgsql oracle mysql
Similarly, the dbm support can be extended with DBM_LIST to build a Berkeley DB provider (db) and/or gdbm provider, by similarly configuring LIB, INCLUDE and PATH first to ensure the client library libs and headers are available.
set DBM_LIST=db gdbm
See the README-win32.txt file for more hints on obtaining the various database driver SDKs.
The policy of the Apache HTTP Server project is to only release Unix sources. Windows source packages made available for download have been supplied by volunteers and may not be available for every release. You can still build the server on Windows from the Unix source tarball with just a few additional steps.
perl srclib\apr\build\lineends.pl
You can now build the server with the Visual Studio development environment using the IDE. Command-Line builds of the server are not possible from Unix sources unless you export .mak files as explained below.
Makefile.win is the top level Apache makefile.
To compile Apache on Windows, simply use one of the following commands
to build the release or debug flavor:
nmake /f Makefile.win _apacher
nmake /f Makefile.win _apached
Either command will compile Apache. The latter will disable optimization of the resulting files, making it easier to single step the code to find bugs and track down problems.
You can add your apr-util dbd and dbm provider choices with the additional make (environment) variables DBD_LIST and DBM_LIST, see the comments about [Optional] Database libraries, above. Review the initial comments in Makefile.win for additional options that can be provided when invoking the build.
Apache can also be compiled using VC++'s Visual Studio
development environment. To simplify this process, a
Visual Studio workspace, Apache.dsw, is provided.
This workspace exposes the entire list of working .dsp
projects that are required for the complete Apache binary release.
It includes dependencies between the projects to assure that they
are built in the appropriate order.
Open the Apache.dsw workspace, and select
InstallBin (Release or Debug build,
as desired) as the Active Project. InstallBin causes all
related project to be built, and then invokes Makefile.win to
move the compiled executables and dlls. You may personalize the
INSTDIR= choice by changing InstallBin's Settings,
General tab, Build command line entry. INSTDIR defaults to the
/Apache2 directory. If you only want a test compile (without
installing) you may build the BuildBin project instead.
The .dsp project files are distributed in Visual Studio 6.0
(98) format. Visual C++ 5.0 (97) will recognize them. Visual Studio
2002 (.NET) and later users must convert Apache.dsw plus
the .dsp files into an Apache.sln plus
.msproj files. Be sure you reconvert the .msproj
file again if its source .dsp file changes! This is really
trivial, just open Apache.dsw in the VC++ 7.0 IDE once again
and reconvert.
perl srclib\apr\build\cvtdsp.pl -2005
perl srclib\apr\build\cvtdsp.pl -ossl11
Visual Studio 2002 (.NET) and later users should also use the Build
menu, Configuration Manager dialog to uncheck both the Debug
and Release Solution modules abs,
mod_deflate and mod_ssl components, as
well as every component starting with apr_db*. These modules
are built by invoking nmake, or the IDE directly with the
BinBuild target, which builds those modules conditionally
if the srclib directories openssl and/or
zlib exist, and based on the setting of DBD_LIST
and DBM_LIST environment variables.
Exported .mak files pose a greater hassle, but they are
required for Visual C++ 5.0 users to build mod_ssl,
abs (ab with SSL support) and/or
mod_deflate. The .mak files also support a broader
range of C++ tool chain distributions, such as Visual Studio Express.
You must first build all projects in order to create all dynamic
auto-generated targets, so that dependencies can be parsed correctly.
Build the entire project from within the Visual Studio 6.0 (98) IDE,
using the BuildAll target, then use the Project Menu Export
for all makefiles (checking on "with dependencies".) Run the following
command to correct absolute paths into relative paths so they will build
anywhere:
perl srclib\apr\build\fixwin32mak.pl
You must type this command from the top level
directory of the httpd source tree. Every
.mak and .dep project file within
the current directory and below will be corrected, and the
timestamps adjusted to reflect the .dsp.
Always review the generated .mak and .dep
files for Platform SDK or other local, machine specific file paths.
The DevStudio\Common\MSDev98\bin\ (VC6) directory contains
a sysincl.dat file, which lists all exceptions. Update
this file (including both forward and backslashed paths, such as both
sys/time.h and sys\time.h) to ignore such
newer dependencies. Including local-install paths in a distributed
.mak file will cause the build to fail completely.
If you contribute back a patch that revises project files, we must commit project files in Visual Studio 6.0 format. Changes should be simple, with minimal compilation and linkage flags that can be recognized by all Visual Studio environments.
Once Apache has been compiled, it needs to be installed in
its server root directory. The default is the
\Apache2 directory, of the same drive.
To build and install all the files into the desired folder
dir automatically, use one of the following
nmake commands:
nmake /f Makefile.win installr INSTDIR=dir
nmake /f Makefile.win installd INSTDIR=dir
The dir argument to INSTDIR provides
the installation directory; it can be omitted if Apache is
to be installed into \Apache22 (of the current
drive).
.dsp files are maintained between release
builds. The .mak files are NOT regenerated, due to the tremendous
waste of reviewer's time. Therefore, you cannot rely on the NMAKE
commands above to build revised .dsp project files unless you
then export all .mak files yourself from the project. This is
unnecessary if you build from within the Microsoft
Developer Studio environment.The primary documentation for this build mechanism is in the
README.cmake file in the source distribution. Refer to that file
for detailed instructions.
Building httpd with cmake requires building APR and APR-util separately.
Refer to their README.cmake files for instructions.
The primary limitations of the cmake-based build are inherited from the APR-util project, and are listed below because of their impact on httpd:
mod_charset_lite and possibly some third-party modules
cannot be used.Apache HTTP Server Version 2.4
Overview of the Apache EBCDIC Port Design Goals Technical Solution Porting Notes Document Storage Notes Apache Modules' Status Third Party Modules' StatusVersion 1.3 of the Apache HTTP Server was the first version which included a port to a (non-ASCII) mainframe machine which uses the EBCDIC character set as its native codeset.
(It is the SIEMENS family of mainframes running the BS2000/OSD operating system. This mainframe OS nowadays features a SVR4-derived POSIX subsystem).
The port was started initially to
This document serves as a rationale to describe some of the design decisions of the port to this machine.
One objective of the EBCDIC port was to maintain enough
backwards compatibility with the (EBCDIC) CERN server to make
the transition to the new server attractive and easy. This
required the addition of a configurable method to define
whether a HTML document was stored in ASCII (the only format
accepted by the old server) or in EBCDIC (the native document
format in the POSIX subsystem, and therefore the only realistic
format in which the other POSIX tools like grep or
sed could operate on the documents). The current
solution to this is a "pseudo-MIME-format" which is intercepted
and interpreted by the Apache server (see below). Future versions
might solve the problem by defining an "ebcdic-handler" for all
documents which must be converted.
Since all Apache input and output is based upon the BUFF data type and its methods, the easiest solution was to add the conversion to the BUFF handling routines. The conversion must be settable at any time, so a BUFF flag was added which defines whether a BUFF object has currently enabled conversion or not. This flag is modified at several points in the HTTP protocol:
The relevant changes in the source are #ifdef'ed
into two categories:
#ifdef
CHARSET_EBCDICCode which is needed for any EBCDIC based machine. This includes character translations, differences in contiguity of the two character sets, flags which indicate which part of the HTTP protocol has to be converted and which part doesn't etc.
#ifdef _OSD_POSIXCode which is needed for the SIEMENS BS2000/OSD mainframe platform only. This deals with include file differences and socket implementation topics which are only required on the BS2000/OSD platform.
The possibility to translate between ASCII and EBCDIC at
the socket level (on BS2000 POSIX, there is a socket option
which supports this) was intentionally not chosen,
because the byte stream at the HTTP protocol level consists
of a mixture of protocol related strings and non-protocol
related raw file data. HTTP protocol strings are always
encoded in ASCII (the GET request, any Header: lines,
the chunking information etc.) whereas the file transfer
parts (i.e., GIF images, CGI output etc.)
should usually be just "passed through" by the server. This
separation between "protocol string" and "raw data" is
reflected in the server code by functions like bgets()
or rvputs() for strings, and functions like
bwrite() for binary data. A global translation
of everything would therefore be inadequate.
(In the case of text files of course, provisions must be made so that EBCDIC documents are always served in ASCII)
This port therefore features a built-in protocol level
conversion for the server-internal strings (which the
compiler translated to EBCDIC strings) and thus for all
server-generated documents. The hard coded ASCII escapes
\012 and \015 which are ubiquitous
in the server code are an exception: they are already the binary
encoding of the ASCII \n and \r and
must not be converted to ASCII a second time.
This exception is only relevant for server-generated strings;
and external EBCDIC documents are not expected to
contain ASCII newline characters.
By examining the call hierarchy for the BUFF management
routines, I added an "ebcdic/ascii conversion layer" which
would be crossed on every puts/write/get/gets, and a
conversion flag which allowed enabling/disabling the
conversions on-the-fly. Usually, a document crosses this
layer twice from its origin source (a file or CGI output) to
its destination (the requesting client): file ->
Apache, and Apache -> client.
The server can now read the header lines of a CGI-script output in EBCDIC format, and then find out that the remainder of the script's output is in ASCII (like in the case of the output of a WWW Counter program: the document body contains a GIF image). All header processing is done in the native EBCDIC format; the server then determines, based on the type of document being served, whether the document body (except for the chunking information, of course) is in ASCII already or must be converted from EBCDIC.
For Text documents (MIME types text/plain, text/html etc.), an implicit translation to ASCII can be used, or (if the users prefer to store some documents in raw ASCII form for faster serving, or because the files reside on a NFS-mounted directory tree) can be served without conversion.
Example:
to serve files with the suffix .ahtml as a
raw ASCII text/html document without implicit
conversion (and suffix .ascii as ASCII
text/plain), use the directives:
AddType text/x-ascii-html .ahtml
AddType text/x-ascii-plain .ascii
Similarly, any text/foo MIME type can be
served as "raw ASCII" by configuring a MIME type
"text/x-ascii-foo" for it using
AddType.
Non-text documents are always served "binary" without
conversion. This seems to be the most sensible choice for,
.e.g., GIF/ZIP/AU file types. This of course
requires the user to copy them to the mainframe host using
the "rcp -b" binary switch.
Server parsed files are always assumed to be in native (i.e., EBCDIC) format as used on the machine, and are converted after processing.
For CGI output, the CGI script determines whether a conversion is needed or not: by setting the appropriate Content-Type, text files can be converted, or GIF output can be passed through unmodified. An example for the latter case is the wwwcount program which we ported as well.
All files with a Content-Type: which does not
start with text/ are regarded as binary
files by the server and are not subject to any conversion.
Examples for binary files are GIF images, gzip-compressed files
and the like.
When exchanging binary files between the mainframe host and
a Unix machine or Windows PC, be sure to use the ftp "binary"
(TYPE I) command, or use the
rcp -b command from the mainframe host (the
-b switch is not supported in unix
rcp's).
The default assumption of the server is that Text Files
(i.e., all files whose Content-Type:
starts with text/) are stored in the native
character set of the host, EBCDIC.
SSI documents must currently be stored in EBCDIC only. No provision is made to convert it from ASCII before processing.
| Module | Status | Notes |
|---|---|---|
core |
+ | |
mod_access |
+ | |
mod_actions |
+ | |
mod_alias |
+ | |
mod_asis |
+ | |
mod_auth |
+ | |
mod_authn_anon |
+ | |
mod_authn_dbm |
? | with own libdb.a |
mod_authz_dbm |
? | with own libdb.a |
mod_autoindex |
+ | |
mod_cern_meta |
? | |
mod_cgi |
+ | |
mod_digest |
+ | |
mod_dir |
+ | |
mod_so |
- | no shared libs |
mod_env |
+ | |
mod_example |
- | (test bed only) |
mod_expires |
+ | |
mod_headers |
+ | |
mod_imagemap |
+ | |
mod_include |
+ | |
mod_info |
+ | |
mod_log_agent |
+ | |
mod_log_config |
+ | |
mod_log_referer |
+ | |
mod_mime |
+ | |
mod_mime_magic |
? | not ported yet |
mod_negotiation |
+ | |
mod_proxy |
+ | |
mod_rewrite |
+ | untested |
mod_setenvif |
+ | |
mod_speling |
+ | |
mod_status |
+ | |
mod_unique_id |
+ | |
mod_userdir |
+ | |
mod_usertrack |
? | untested |
| Module | Status | Notes |
|---|---|---|
JK (Formerly mod_jserv)
|
- | JAVA still being ported. |
mod_php3 |
+ | mod_php3 runs fine, with LDAP and GD
and FreeType libraries. |
mod_put |
? | untested |
mod_session |
- | untested |
Apache HTTP Server Version 2.4
While many distributions make Apache httpd available as operating system supported packages, it can sometimes be desirable to install and use the canonical version of Apache httpd on these systems, replacing the natively provided versions of the packages.
While the Apache httpd project does not currently create binary RPMs for the various distributions out there, it is easy to build your own binary RPMs from the canonical Apache httpd tarball.
This document explains how to build, install, configure and run Apache httpd 2.4 under Unix systems supporting the RPM packaging format.
Creating a Source RPM Building RPMs Installing the Server Configuring the Default Instance of Apache httpd Configuring Additional Instances of Apache httpd on the Same MachineThe Apache httpd source tarball can be converted into an SRPM as follows:
rpmbuild -ts httpd-2.4.x.tar.bz2
RPMs can be built directly from the Apache httpd source tarballs using the following command:
rpmbuild -tb httpd-2.4.x.tar.bz2
Corresponding "-devel" packages will be required to be installed on your
build system prior to building the RPMs, the rpmbuild command
will automatically calculate what RPMs are required and will list any
dependencies that are missing on your system. These "-devel" packages will
not be required after the build is completed, and can be safely removed.
If successful, the following RPMs will be created:
mod_ldap and mod_authnz_ldap, with
corresponding dependency on openldap.mod_lua module, with
corresponding dependency on lua.mod_proxy_html module, with
corresponding dependency on libxml2.mod_socache_dc module, with
corresponding dependency on distcache.mod_ssl module, with
corresponding dependency on openssl.The httpd RPM is the only RPM necessary to get a basic
server to run. Install it as follows:
rpm -U httpd-2.4.x-1.i686.rpm
Self contained modules are included with the server. Modules that depend on external libraries are provided as separate RPMs to install if needed.
The default configuration for the server is installed by default
beneath the /etc/httpd directory, with logs written by
default to /var/log/httpd. The environment for the
webserver is set by default within the optional
/etc/sysconfig/httpd file.
Start the server as follows:
service httpd restart
It is possible to configure additional instances of the Apache httpd server running independently alongside each other on the same machine. These instances can have independent configurations, and can potentially run as separate users if so configured.
This was done by making the httpd startup script aware of its own name. This name is then used to find the environment file for the server, and in turn, the server root of the server instance.
To create an additional instance called
httpd-additional, follow these steps:
ln -s /etc/rc.d/init.d/httpd /etc/rc.d/init.d/httpd-additional
chkconfig --add httpd-additional
/etc/sysconfig/httpd file as a template:
# template from httpd
cp /etc/sysconfig/httpd /etc/sysconfig/httpd-additional
# blank template
touch /etc/sysconfig/httpd-additional
/etc/sysconfig/httpd-additional and pass the
server root of the new server instance within the
OPTIONS environment variable.
OPTIONS="-d /etc/httpd-additional -f conf/httpd-additional.conf"
/etc/httpd-additional/conf/httpd-additional.conf to
ensure the correct ports and paths are configured.
service httpd-additional restart
Apache HTTP Server Version 2.4
This document explains how to install, configure and run Apache 2.4 under Microsoft Windows. If you have questions after reviewing the documentation (and any event and error logs), you should consult the peer-supported users' mailing list.
This document assumes that you are installing a binary distribution of Apache. If you want to compile Apache yourself (possibly to help with development or tracking down bugs), see Compiling Apache for Microsoft Windows.
Operating System Requirements Downloading Apache for Windows Customizing Apache for Windows Running Apache as a Service Running Apache as a Console Application Testing the Installation Configuring Access to Network Resources Windows TuningThe primary Windows platform for running Apache 2.4 is Windows 2000 or later. Always obtain and install the current service pack to avoid operating system bugs.
The Apache HTTP Server Project itself does not provide binary releases of software, only source code. Individual committers may provide binary packages as a convenience, but it is not a release deliverable.
If you cannot compile the Apache HTTP Server yourself, you can obtain a binary package from numerous binary distributions available on the Internet.
Popular options for deploying Apache httpd, and, optionally, PHP and MySQL, on Microsoft Windows, include:
Apache is configured by the files in the conf
subdirectory. These are the same files used to configure the Unix
version, but there are a few different directives for Apache on
Windows. See the directive index
for all the available directives.
The default configuration of the source distribution expects the server
to be installed into \Apache24. This can be customized at compilation time,
but it's important that ultimately the ServerRoot in
httpd.conf match the actual installation root. Binary distributions may
customize either the default installation root or the overall layout of
the initial configuration.
The main differences in Apache for Windows are:
Because Apache for Windows is multithreaded, it does not use a separate process for each request, as Apache can on Unix. Instead there are usually only two Apache processes running: a parent process, and a child which handles the requests. Within the child process each request is handled by a separate thread.
The process management directives are also different:
MaxConnectionsPerChild:
Like the Unix directive, this controls how many connections a single
child process will serve before exiting.
However, unlike on Unix, a replacement process is not instantly
available. Use the default MaxConnectionsPerChild 0,
unless instructed to change the behavior to overcome a memory leak
in third party modules or in-process applications.
httpd.conf, the new child may not start or
you may receive unexpected results.ThreadsPerChild:
This directive is new. It tells the server how many threads it
should use. This is the maximum number of connections the server
can handle at once, so be sure to set this number high enough for
your site if you get a lot of hits. The recommended default is
ThreadsPerChild 150, but this must be adjusted to
reflect the greatest anticipated number of simultaneous
connections to accept.
The directives that accept filenames as arguments must use Windows filenames instead of Unix ones. However, because Apache may interpret backslashes as an "escape character" sequence, you should consistently use forward slashes in path names, not backslashes.
While filenames are generally case-insensitive on
Windows, URLs are still treated internally as case-sensitive
before they are mapped to the filesystem. For example, the
<Location>,
Alias, and ProxyPass directives all use
case-sensitive arguments. For this reason, it is particularly
important to use the <Directory> directive when attempting
to limit access to content in the filesystem, since this
directive applies to any content in a directory, regardless of
how it is accessed. If you wish to assure that only lowercase
is used in URLs, you can use something like:
RewriteEngine On
RewriteMap lowercase int:tolower
RewriteCond "%{REQUEST_URI}" "[A-Z]"
RewriteRule "(.*)" "${lowercase:$1}" [R,L]
When running, Apache needs write access only to the logs directory and any configured cache directory tree. Due to the issue of case insensitive and short 8.3 format names, Apache must validate all path names given. This means that each directory which Apache evaluates, from the drive root up to the directory leaf, must have read, list and traverse directory permissions. If Apache2.4 is installed at C:\Program Files, then the root directory, Program Files and Apache2.4 must all be visible to Apache.
Apache for Windows contains the ability to load modules at
runtime, without recompiling the server. If Apache is compiled
normally, it will install a number of optional modules in the
\Apache2.4\modules directory. To activate these or
other modules, the LoadModule
directive must be used. For example, to activate the status
module, use the following (in addition to the status-activating
directives in access.conf):
LoadModule status_module "modules/mod_status.so"
Information on creating loadable modules is also available.
Apache can also load ISAPI (Internet Server Application Programming Interface) extensions such as those used by Microsoft IIS and other Windows servers. More information is available. Note that Apache cannot load ISAPI Filters, and ISAPI Handlers with some Microsoft feature extensions will not work.
When running CGI scripts, the method Apache uses to find
the interpreter for the script is configurable using the
ScriptInterpreterSource
directive.
Since it is often difficult to manage files with names
like .htaccess in Windows, you may find it useful to
change the name of this per-directory configuration file using
the AccessFilename
directive.
Any errors during Apache startup are logged into the
Windows event log when running on Windows NT. This mechanism
acts as a backup for those situations where Apache is not yet
prepared to use the error.log file. You can
review the Windows Application Event Log by using the Event Viewer,
e.g. Start - Settings - Control Panel - Administrative Tools
- Event Viewer.
Apache comes with a utility called the Apache Service Monitor. With it you can see and manage the state of all installed Apache services on any machine on your network. To be able to manage an Apache service with the monitor, you have to first install the service (either automatically via the installation or manually).
You can install Apache as a Windows NT service as follows from
the command prompt at the Apache bin subdirectory:
httpd.exe -k install
If you need to specify the name of the service you want to install, use the following command. You have to do this if you have several different service installations of Apache on your computer. If you specify a name during the install, you have to also specify it during any other -k operation.
httpd.exe -k install -n "MyServiceName"
If you need to have specifically named configuration files for different services, you must use this:
httpd.exe -k install -n "MyServiceName" -f "c:\files\my.conf"
If you use the first command without any special parameters except
-k install, the service will be called Apache2.4
and the configuration will be assumed to be conf\httpd.conf.
Removing an Apache service is easy. Just use:
httpd.exe -k uninstall
The specific Apache service to be uninstalled can be specified by using:
httpd.exe -k uninstall -n "MyServiceName"
Normal starting, restarting and shutting down of an Apache
service is usually done via the Apache Service Monitor, by using
commands like NET START Apache2.4 and NET STOP
Apache2.4 or via normal Windows service management. Before
starting Apache as a service by any means, you should test the
service's configuration file by using:
httpd.exe -n "MyServiceName" -t
You can control an Apache service by its command line switches, too. To start an installed Apache service you'll use this:
httpd.exe -k start -n "MyServiceName"
To stop an Apache service via the command line switches, use this:
httpd.exe -k stop -n "MyServiceName"
or
httpd.exe -k shutdown -n "MyServiceName"
You can also restart a running service and force it to reread its configuration file by using:
httpd.exe -k restart -n "MyServiceName"
By default, all Apache services are registered to run as the
system user (the LocalSystem account). The
LocalSystem account has no privileges to your network
via any Windows-secured mechanism, including the file system, named
pipes, DCOM, or secure RPC. It has, however, wide privileges locally.
LocalSystem account! If you need Apache to be able
to access network resources, create a separate account for Apache as
noted below.It is recommended that users create a separate account for running Apache service(s). If you have to access network resources via Apache, this is required.
Log on
as a service and Act as part of the operating
system. On Windows NT 4.0 these privileges are granted via
User Manager for Domains, but on Windows 2000 and XP you probably
want to use Group Policy for propagating these settings. You can
also manually set these via the Local Security Policy MMC snap-in.
htdocs and cgi-bin
for example).logs directory.httpd.exe binary executable.logs subdirectory, where the
user has to have at least change (RWXD) rights.If you allow the account to log in as a user and as a service, then you can log on with that account and test that the account has the privileges to execute the scripts, read the web pages, and that you can start Apache in a console window. If this works, and you have followed the steps above, Apache should execute as a service with no problems.
When starting Apache as a service you may encounter an error message from the Windows Service Control Manager. For example, if you try to start Apache by using the Services applet in the Windows Control Panel, you may get the following message:
Could not start the Apache2.4 service on \\COMPUTER
Error 1067; The process terminated unexpectedly.
You will get this generic error if there is any problem with starting the Apache service. In order to see what is really causing the problem you should follow the instructions for Running Apache for Windows from the Command Prompt.
If you are having problems with the service, it is suggested you follow the instructions below to try starting httpd.exe from a console window, and work out the errors before struggling to start it as a service again.
Running Apache as a service is usually the recommended way to use it, but it is sometimes easier to work from the command line, especially during initial configuration and testing.
To run Apache from the command line as a console application, use the following command:
httpd.exe
Apache will execute, and will remain running until it is stopped by pressing Control-C.
You can also run Apache via the shortcut Start Apache in Console
placed to Start Menu --> Programs --> Apache HTTP Server
2.4.xx --> Control Apache Server during the installation.
This will open a console window and start Apache inside it. If you
don't have Apache installed as a service, the window will remain
visible until you stop Apache by pressing Control-C in the console
window where Apache is running in. The server will exit in a few
seconds. However, if you do have Apache installed as a service, the
shortcut starts the service. If the Apache service is running
already, the shortcut doesn't do anything.
If Apache is running as a service, you can tell it to stop by opening another console window and entering:
httpd.exe -k shutdown
Running as a service should be preferred over running in a console window because this lets Apache end any current operations and clean up gracefully.
But if the server is running in a console window, you can only stop it by pressing Control-C in the same window.
You can also tell Apache to restart. This forces it to reread the configuration file. Any operations in progress are allowed to complete without interruption. To restart Apache, either press Control-Break in the console window you used for starting Apache, or enter
httpd.exe -k restart
if the server is running as a service.
kill -TERM
pid and kill -USR1 pid. The
command line option used, -k, was chosen as a reminder
of the kill command used on Unix.If the Apache console window closes immediately or unexpectedly
after startup, open the Command Prompt from the Start Menu -->
Programs. Change to the folder to which you installed Apache, type
the command httpd.exe, and read the error message. Then
change to the logs folder, and review the error.log
file for configuration mistakes. Assuming httpd was installed into
C:\Program Files\Apache Software Foundation\Apache2.4\,
you can do the following:
c:
cd "\Program Files\Apache Software Foundation\Apache2.4\bin"
httpd.exe
Then wait for Apache to stop, or press Control-C. Then enter the following:
cd ..\logs
more < error.log
When working with Apache it is important to know how it will find the configuration file. You can specify a configuration file on the command line in two ways:
-f specifies an absolute or relative path to
a particular configuration file:
httpd.exe -f "c:\my server files\anotherconfig.conf"
or
httpd.exe -f files\anotherconfig.conf
-n specifies the installed Apache service
whose configuration file is to be used:
httpd.exe -n "MyServiceName"
In both of these cases, the proper
ServerRoot should be set in
the configuration file.
If you don't specify a configuration file with -f
or -n, Apache will use the file name compiled into the
server, such as conf\httpd.conf. This built-in path
is relative to the installation directory. You can verify the compiled
file name from a value labelled as SERVER_CONFIG_FILE when
invoking Apache with the -V switch, like this:
httpd.exe -V
Apache will then try to determine its ServerRoot by trying the following, in this order:
ServerRoot directive
via the -C command line switch.-d switch on the command line.
/apache by default, you can verify it by using
httpd.exe -V and looking for a value labelled as
HTTPD_ROOT.If you did not do a binary install, Apache will in some scenarios complain about the missing registry key. This warning can be ignored if the server was otherwise able to find its configuration file.
The value of this key is the
ServerRoot directory which
contains the conf subdirectory. When Apache starts it
reads the httpd.conf file from that directory. If
this file contains a ServerRoot
directive which contains a different directory from the one
obtained from the registry key above, Apache will forget the
registry key and use the directory from the configuration file. If
you copy the Apache directory or configuration files to a new
location it is vital that you update the
ServerRoot directive in the
httpd.conf file to reflect the new location.
After starting Apache (either in a console window or as a
service) it will be listening on port 80 (unless you changed the
Listen directive in the
configuration files or installed Apache only for the current user).
To connect to the server and access the default page, launch a
browser and enter this URL:
http://localhost/
Apache should respond with a welcome page and you should see
"It Works!". If nothing happens or you get an error, look in the
error.log file in the logs subdirectory.
If your host is not connected to the net, or if you have serious
problems with your DNS (Domain Name Service) configuration, you
may have to use this URL:
http://127.0.0.1/
If you happen to be running Apache on an alternate port, you need to explicitly put that in the URL:
http://127.0.0.1:8080/
Once your basic installation is working, you should configure it
properly by editing the files in the conf subdirectory.
Again, if you change the configuration of the Windows NT service
for Apache, first attempt to start it from the command line to
make sure that the service starts with no errors.
Because Apache cannot share the same port with another TCP/IP application, you may need to stop, uninstall or reconfigure certain other services before running Apache. These conflicting services include other WWW servers, some firewall implementations, and even some client applications (such as Skype) which will use port 80 to attempt to bypass firewall issues.
Access to files over the network can be specified using two mechanisms provided by Windows:
Alias "/images/" "Z:/"Alias "/images/" "//imagehost/www/images/"Mapped drive letters allow the administrator to maintain the mapping to a specific machine and path outside of the Apache httpd configuration. However, these mappings are associated only with interactive sessions and are not directly available to Apache httpd when it is started as a service. Use only UNC paths for network resources in httpd.conf so that the resources can be accessed consistently regardless of how Apache httpd is started. (Arcane and error prone procedures may work around the restriction on mapped drive letters, but this is not recommended.)
UNCList dochost DocumentRoot "//dochost/www/html/"
UNCList 192.168.1.50 DocumentRoot "//192.168.1.50/docs/"
UNCList imagehost1 imagehost2 Alias "/images/" "//imagehost/www/images/" Alias "/images2/" "//imagehost2/www/images/" <Directory "//imagehost/www/images/"> #... </Directory> <Directory "//imagehost2/www/images/"> #... </Directory>
When running Apache httpd as a service, you must create a separate account in order to access network resources, as described above.
If more than a few dozen piped loggers are used on an operating system instance, scaling up the "desktop heap" is often necessary. For more detailed information, refer to the piped logging documentation.
Serveur HTTP Apache Version 2.4
Ce document décrit l'installation, la configuration et l'exécution d'Apache 2.4 sous Microsoft Windows. Si vous avez des questions après avoir lu la documentation, ou si vous avez rencontré des évènements particuliers ou des rapports d'erreur, vous pouvez consultez la liste de diffusion de la communauté des utilisateurs.
Dans ce document, nous supposons que vous installez une distribution binaire d'Apache. Si vous voulez compiler Apache vous-même (par exemple pour aider au développement ou pour rechercher des bogues), référez-vous au document Compilation d'Apache pour Microsoft Windows.
Prérequis du système d'exploitation Téléchargement d'Apache pour Windows Personnaliser Apache pour Windows Exécuter Apache en tant que service Exécuter Apache depuis la console Vérification de l'installation Configuration de l'accès aux ressources réseau Personnalisation sous WindowsLa plate-forme Windows de base pour l'exécution d'Apache 2.4 est Windows 2000 ou supérieur. Veillez à toujours vous procurer et installer le dernier service pack afin d'éviter les bogues du système d'exploitation.
Le projet du serveur HTTP Apache proprement dit ne fournit pas de distribution binaire mais seulement le code source. Certains membres du projet peuvent mettre à disposition des paquets binaires à titre individuel, mais ceux-ci n'ont pas vocation à être distribués publiquement.
Si vous n'êtes pas en mesure de compiler le serveur HTTP Apache vous-même, vous pouvez vous procurer un paquet binaire auprès des nombreuses distributions disponibles sur Internet.
Quelques solutions populaires pour déployer Apache httpd, et éventuellement PHP et MySQL sous Microsoft Windows :
La configuration d'Apache est enregistrée dans les fichiers du
sous-répertoire conf. Ce sont les même fichiers que
ceux utilisés pour configurer la version Unix, mais il y a quelques
directives spécifiques à Apache pour Windows. Voir l'index des directives pour la liste
des directives disponibles.
La configuration par défaut de la distribution source installe
le serveur dans \Apache2x. Cet emplacement peut être modifié à
la compilation, mais il est important qu'en fin de compte, la directive
ServerRoot dans httpd.conf corresponde effectivement
à la racine de l'installation. Les distributions binaires peuvent parfois
modifier la racine de l'installation par défaut, ou même la structure
complète de la configuration initiale.
Les principales spécificités d'Apache pour Windows sont :
Comme Apache pour Windows est un programme multithread, il ne lance pas de processus séparé pour chaque requête, comme Apache peut le faire sous Unix. En fait, il n'y a en général que deux processus Apache en exécution : un processus parent, et un processus enfant qui traite les requêtes. Chaque requête est traitée par un thread séparé au sein du processus enfant.
Les directives de gestion de processus diffèrent également :
MaxConnectionsPerChild
: comme dans la version Unix, cette directive contrôle le nombre
de connexions qu'un
processus enfant particulier va traiter avant de s'arrêter.
Cependant, à la différence d'Unix, un processus de remplacement
n'est pas instantanément disponible. Utilisez la définition par
défaut MaxConnectionsPerChild 0, sauf si vous
risquez de manquer de mémoire dans des modules tiers ou dans des
applications in-process.
httpd.conf, le nouveau processus enfant peut ne pas
démarrer, ou vous pouvez obtenir des résultats
inattendus.ThreadsPerChild : il
s'agit d'une nouvelle directive. Elle indique au serveur le nombre
de threads qu'il doit utiliser. Elle définit le nombre maximum de
connexions simultanées que le serveur peut gérer ; vous devez
donc vous assurer que ce nombre soit suffisamment grand pour les
besoins de votre site. La valeur par défaut ThreadsPerChild
150 est recommandée, mais doit être ajustée à la valeur
maximale estimée de connexions simultanées à accepter.
Les directives qui acceptent des noms de fichiers comme arguments doivent utiliser des noms de fichiers Windows et non Unix. Cependant, comme Apache peut interpréter les anti-slashes comme des séquences d'échappement de caractères, vous devez absolument utiliser des slashes dans les noms de chemins à la place des anti-slashes.
Alors que les noms de fichiers sont en général insensibles
à la casse sous Windows, les URLs sont encore sensibles à la casse
en interne avant d'être mises en correspondance avec le système de
fichiers. Par exemple, les directives <Location>, Alias, et ProxyPass utilisent toutes des
arguments sensibles à la casse. Pour cette raison, il est
particulièrement recommandé d'utiliser la directive <Directory> lorsqu'on
désire limiter l'accès à certains contenus du système de fichiers,
car cette directive s'applique à tout contenu d'un répertoire,
sans tenir compte de la manière dont on y accède. Pour vous
assurer que seules des minuscules sont utilisées dans les URLs,
vous pouvez utiliser ceci :
RewriteEngine On
RewriteMap lowercase int:tolower
RewriteCond "%{REQUEST_URI}" "[A-Z]"
RewriteRule "(.*)" "${lowercase:$1}" [R,L]
Lors de son exécution, Apache n'a besoin d'un accès en écriture qu'au répertoire des journaux et à toute arborescence de répertoires de cache configurée. Suite au problème d'insensibilité à la casse et au format de noms courts 8.3, Apache doit valider tous les noms de chemins fournis. Cela signifie que chaque répertoire qu'Apache évalue doit avoir les droits en lecture, listage et parcours, et ceci depuis la racine jusqu'aux feuilles. Si Apache2.4 est installé dans C:\Program Files, le répertoire racine, Program Files et Apache2.4 doivent tous être visibles pour Apache
Apache peut charger divers modules sans qu'il soit nécessaire
de recompiler le serveur. Si Apache est compilé
normalement, il va installer de nombreux modules optionnels dans
le répertoire \Apache2.4\modules. Pour activer ces
modules ou d'autres modules, on doit utiliser la
directive LoadModule. Par
exemple, pour activer le module status, ajoutez la ligne suivante
(en plus des directives d'activation de status dans
access.conf) :
LoadModule status_module "modules/mod_status.so"
Des informations sont aussi à votre disposition pour créer des modules chargeables
Apache peut aussi charger des extensions ISAPI (Internet Server Application Programming Interface), comme celles qu'utilise Microsoft IIS et d'autres serveurs Windows. Voir ici pour plus d'informations. Notez qu'Apache ne peut pas charger de filtres ISAPI, et que les gestionnaires ISAPI contenant des extensions de fonctionnalités Microsoft ne fonctionneront pas.
Pour les scripts CGI, la méthode qu'utilise Apache pour
déterminer l'interpréteur du script est configurable grâce à la
directive ScriptInterpreterSource
Comme il est souvent difficile de gérer des fichiers avec
des noms du style .htaccess sous Windows, vous avez
tout intérêt à changer le nom de ce fichier de configuration par
répertoire à l'aide de la directive AccessFilename.
Toute erreur survenant au cours du processus de démarrage
d'Apache est enregistrée dans le journal des évènements de
Windows si l'on est sous Windows NT. Ce mécanisme fonctionne comme
une sauvegarde pour les situations où Apache n'est pas encore prêt
à utiliser le fichier error.log. Vous pouvez
consulter le journal des évènements applicatifs Windows en
utilisant l'observateur d'évènements : Démarrage - Paramètres -
Panneau de configuration - Outils d'administration - Observateur
d'évènements.
Apache fournit un utilitaire nommé Apache Service Monitor (Moniteur du service Apache). Grâce à lui, vous pouvez voir et gérer l'état de tous les services Apache installés sur toutes les machines du réseau. Pour pouvoir gérer un service Apache avec le moniteur, vous devez d'abord installer le service (soit automatiquement au cours de l'installation, soit manuellement).
Vous pouvez installer Apache en tant que service Windows NT à
partir de la ligne de commandes et depuis le sous-répertoire Apache
bin comme suit :
httpd.exe -k install
Si vous avez installé plusieurs services Apache sur votre ordinateur, vous devrez spécifier le nom du service que vous voulez installer en utilisant la commande suivante (notez que si vous spécifiez un nom durant l'installation, vous devrez aussi le spécifier pour toute opération comportant l'option -k) :
httpd.exe -k install -n "Nom-service"
Si un service doit utiliser un fichier de configuration spécifique, utilisez ceci :
httpd.exe -k install -n "Nom-service" -f "c:\fichiers\Nom-service.conf"
Si vous utilisez la première commande sans paramètre particulier,
excepté -k install, le service aura pour nom
Apache2.4 et le fichier de configuration sera censé
être conf\httpd.conf.
Supprimer un service Apache est très simple. Utilisez simplement :
httpd.exe -k uninstall
On peut spécifier un service Apache particulier en utilisant :
httpd.exe -k uninstall -n "Nom service"
Normalement, le démarrage, le redémarrage et l'arrêt d'un
service Apache s'effectuent via le Moniteur de Service Apache, ou en
utilisant des commandes telles que NET START Apache2.4 et
NET STOP Apache2.4, ou encore via le gestionnaire de
services standard de Windows. Avant de démarrer Apache en tant que
service dans quelque but que ce soit, vous devez tester le fichier
de configuration du service en utilisant :
httpd.exe -n "Nom-service" -t
Vous pouvez aussi contrôler un service Apache à l'aide de ses options de ligne de commande. Avec cette méthode, pour démarrer un service Apache installé, vous utiliserez :
httpd.exe -k start -n "Nom-Service"
Pour arrêter un service Apache via les options de lignes de commande, utilisez ceci :
httpd.exe -k stop -n "Nom-Service"
ou
httpd.exe -k shutdown -n "Nom-Service"
Vous pouvez aussi redémarrer un service en exécution et le forcer à relire son fichier de configuration en utilisant :
httpd.exe -k restart -n "Nom-Service"
Par défaut, tous les services Apache sont configurés pour
s'exécuter sous l'utilisateur system (le compte
LocalSystem). Le compte LocalSystem n'a
pas de privilèges sur votre réseau, que ce soit via un mécanisme
sécurisé de Windows, y compris le système de fichiers, des tubes
nommés, DCOM ou des RPC sécurisés. Il a cependant des privilèges
élevés en local.
LocalSystem ! Si Apache doit pouvoir accéder
à des ressources réseau, créez un compte séparé pour Apache comme
indiqué ci-dessous.Il est fortement fortement conseillé aux utilisateurs de créer un compte séparé pour exécuter le(s) service(s) Apache, et même obligatoire si vous devez accéder à des ressources réseau via Apache.
Log on as a service et Act as part of the
operating system. Sous Windows NT 4.0, ces privilèges sont
accordés via le Gestionnaire des utilisateurs du Domaine, mais
sous Windows 2000 et XP, vous aurez plutôt intérêt à utiliser une
GPO pour propager ces configurations. Vous pouvez aussi effectuer
ces réglages via la Politique de Sécurité Locale intégrée à la
MMC.htdocs
et cgi-bin par exemple), et aussi sur l'exécutable
binaire httpd.exe.logs.logs, sur lequel l'utilisateur doit
avoir au moins les droits de modification (RWXD).Si vous permettez à ce compte de se connecter en tant qu'utilisateur et service, vous pouvez ouvrir une session sous ce compte et vérifier s'il a bien le droit d'exécuter les scripts, de lire les pages web, et si vous pouvez démarrer Apache à partir d'une console Windows. Si tout fonctionne, et si vous avez suivi les étapes ci-dessus, Apache devrait s'exécuter en tant que service sans problème.
Lorsqu'Apache démarre en tant que service, il se peut que vous obteniez un message d'erreur du Gestionnaire de Services Windows. Par exemple, si vous essayez de démarrer Apache en utilisant l'applet Services du Panneau de configuration de Windows, vous pouvez obtenir le message suivant :
Could not start the Apache2.4 service on \\COMPUTER
Error 1067; The process terminated unexpectedly.
Vous obtiendrez cette erreur à caractère général pour tout problème survenant au cours du démarrage du service Apache. Afin de déterminer exactement la cause du problème, vous devez suivre les instructions permettant d'exécuter Apache pour Windows depuis la ligne de commande.
Si vous rencontrez des problèmes avec le service, il est conseillé de suivre les instructions ci-dessous afin d'essayer de démarrer httpd.exe depuis une console, et d'analyser les erreurs plutôt que vous démener à essayer de démarrer le service.
Il est en général recommandé d'exécuter Apache en tant que service, mais il est parfois plus simple d'utiliser la ligne de commande, en particulier au cours de la configuration initiale et les tests.
Pour exécuter Apache depuis la ligne de commande et en tant qu'application de console, utilisez la commande suivante :
httpd.exe
Apache va démarrer, et continuera son exécution jusqu'à ce qu'on l'arrête en tapant Ctrl-C.
Vous pouvez également démarrer Apache via le raccourci "Démarrer
Apache dans une console" placé dans Démarrer -->
Programmes --> Apache HTTP Server 2.4.xx --> Control Apache
Server au cours de l'installation. Ceci va
ouvrir une console Windows, et y démarrer Apache.
Si vous n'avez pas installé Apache en tant que service, la
fenêtre Windows restera ouverte jusqu'à ce que vous arrêtiez Apache
en tapant Ctrl-C dans cette fenêtre. Le serveur va alors s'arrêter
au bout de quelques secondes. Cependant, si vous avez installé
Apache en tant que service, c'est ce dernier que le raccourci
ci-dessus va lancer. Si le service Apache est déjà en cours
d'exécution, le raccourci va rester sans effet.
Si Apache s'exécute en tant que service, vous pouvez l'arrêter en ouvrant une autre console et en entrant :
httpd.exe -k shutdown
Plutôt que de lancer Apache à partir d'une console, il est préférable de l'exécuter en tant que service car dans ce cas, il termine proprement les opérations en cours avant de s'éteindre.
Si le serveur a été lancé depuis une console, vous ne pouvez l'arrêter qu'en pressant la combinaison de touches Ctrl-C dans la même fenêtre.
Vous pouvez aussi redémarrer Apache. Ceci le force à recharger son fichier de configuration. Toute opération en cours peut être achevée sans interruption. Pour redémarrer Apache, vous pouvez soit taper Control-Break dans la fenêtre de console que vous avez utilisée pour le démarrer, soit entrer :
httpd.exe -k restart
si le serveur s'exécute en tant que service.
kill -TERM pid et
kill -USR1 pid. L'option de ligne de commande
-k a été choisie à titre de rapprochement avec la
commande kill utilisée sous Unix.Si la fenêtre de la console Apache se ferme immédiatement ou
inopinément après le démarrage d'Apache, ouvrez une console Windows
depuis le menu Démarrer --> Programmes. Placez-vous dans le
répertoire d'installation d'Apache, tapez la commande
httpd.exe, et observez le message d'erreur. Allez
ensuite dans le répertoire des journaux, et visualisez le fichier
error.log pour détecter d'éventuelles erreurs de
configuration. Si Apache a été installé dans C:\Program
Files\Apache Software Foundation\Apache2.4\, vous
pouvez entrer ce qui suit :
c:
cd "\Program Files\Apache Software Foundation\Apache2.4\bin"
httpd.exe
Attendez ensuite qu'Apache s'arrête ou tapez Ctrl-C. Entrez alors la commande suivante :
cd ..\logs
more < error.log
Lorsqu'on travaille avec Apache, il est important de comprendre comment ce dernier trouve son fichier de configuration. Vous pouvez spécifier un fichier de configuration à partir de la ligne de commande de deux façons :
L'option -f permet de spécifier un chemin
absolu ou relatif vers un fichier de configuration particulier
:
httpd.exe -f "c:\fichiers-de-mon-serveur\autre-config.conf"
ou
httpd.exe -f fichiers-de-mon-serveur\autre-config.conf
L'option -n permet de spécifier le service
Apache installé dont le fichier de configuration doit être utilisé
:
httpd.exe -n "Nom-service"
Dans les deux cas, la directive ServerRoot doit être correctement définie
dans le fichier de configuration.
Si vous ne spécifiez aucun fichier de configuration à l'aide des
options -f ou -n, Apache utilisera le nom
du fichier de configuration compilé dans le serveur, en général
conf\httpd.conf. Ce chemin codé en dur est relatif au
répertoire d'installation. Vous pouvez vérifier ce chemin à partir
de la valeur de l'étiquette SERVER_CONFIG_FILE en
invoquant Apache avec l'option -V, comme ceci :
httpd.exe -V
Apache va ensuite essayer de déterminer la valeur de son
ServerRoot en effectuant les
recherches suivantes, dans cet ordre :
ServerRoot
via l'option de ligne de commande -C.-d.DocumentRoot) codée en dur
dans le serveur. Elle
correspond par défaut à /apache, et vous pouvez le
vérifier en tapant httpd.exe -V et en recherchant
l'étiquette HTTPD_ROOT.Si vous n'avez pas effectué d'installation binaire, dans certains scénarios, Apache va signaler l'absence de cette clé de registre. On peut passer outre cet avertissement si le serveur a été en mesure de trouver son fichier de configuration d'une autre manière.
La valeur de cette clé correspond au répertoire ServerRoot qui contient lui-même le
sous-répertoire conf. Lors de son démarrage, Apache lit
le fichier httpd.conf à partir de ce répertoire. Si ce
fichier contient une directive ServerRoot qui spécifie un répertoire
différent de celui que contient la clé de registre ci-dessus, Apache
oubliera la clé de registre, et utilisera le répertoire spécifié par
le fichier de configuration. Si vous déplacez le répertoire Apache
ou ses fichiers de configuration, il est vital de mettre à jour la
directive ServerRoot dans
httpd.conf afin de refléter la nouvelle
localisation.
Une fois Apache démarré (soit à partir d'une console Windows,
soit en tant que service), ce dernier va se mettre à l'écoute sur
le port 80 (à moins que vous ayiez modifié la directive Listen dans les fichiers de
configuration ou que vous ayiez installé Apache pour l'utilisateur
courant seulement). Pour vous connecter au serveur et accéder à la
page par défaut, lancez un navigateur et entrez cette URL :
http://localhost/
Apache devrait renvoyer une page de bienvenue et vous devriez
voir s'afficher "It Works!". Si rien ne se passe ou si vous obtenez
une erreur, consultez le fichier error.log dans le
sous-répertoire logs. Si votre serveur n'est pas
connecté au réseau, ou si vous avez de sérieux problèmes avec la
configuration de votre DNS (Domain Name Service), vous devez
utiliser cette URL :
http://127.0.0.1/
Si Apache écoute un port non standard, vous devez le préciser explicitement dans l'URL :
http://127.0.0.1:8080/
Après que votre installation de base fonctionne, vous devez la
configurer correctement en éditant les fichiers du sous-répertoire
conf. Encore une fois, si vous modifiez la
configuration du service Apache sous Windows NT, essayez d'abord de
redémarrer le service depuis la ligne de commande afin de vous
assurer de l'absence d'erreur.
Comme Apache ne peut pas partager le même port avec d'autres applications TCP/IP, il se peut que vous soyez amené à arrêter, désinstaller ou reconfigurer certains services avant de démarrer Apache. Ces services entrant en conflit avec Apache comprennent les autres serveurs WWW, certaines implémentations de pare-feu, et même certaines applications client (comme Skype) qui utilisent le port 80 afin de contourner les pare-feu.
L'accès à des fichiers par le réseau peut être spécifié via deux mécanismes fournis par Windows :
Alias "/images/" "Z:/"Alias "/images/" "//imagehost/www/images/"L'association de lettres de lecteur permet à l'administrateur de maintenir une correspondance avec une certaine machine et un certain chemin en dehors de la configuration d'Apache httpd. Cependant, ces associations ne sont possibles que dans le cadre des sessions interactives, et ne sont pas directement disponibles pour Apache httpd lorsqu'il est démarré en tant que service. N'utilisez par conséquent que des chemins UNC pour les ressources réseau dans httpd.conf, de façon à ce que les ressources soient accessibles quelle que soit la manière dont Apache httpd a été démarré (des procédures exotiques et probablement sujettes aux erreurs peuvent permettre de contourner la restriction due aux associations de lettres de lecteur, mais leur utilisation est déconseillée).
UNCList dochost DocumentRoot "//dochost/www/html/"
UNCList 192.168.1.50 DocumentRoot "//192.168.1.50/docs/"
UNCList imagehost1 imagehost2 Alias "/images/" "//imagehost/www/images/" Alias "/images2/" "//imagehost2/www/images/" <Directory "//imagehost/www/images/"> #... </Directory> <Directory "//imagehost2/www/images/"> #... </Directory>
Lorsqu'Apache s'exécute en tant que service, vous devez créer un compte spécifique afin de pouvoir accéder aux ressources réseau, comme décrit ci-dessus.
Si on utilise un grand nombre de redirections de journaux via des pipes, il est souvent nécessaire d'augmenter la taille de la mémoire du bureau ("desktop heap"). Pour une information plus détaillée, veuillez vous reporter à la documentation sur les redirections de journaux.
Apache HTTP Server Version 2.4
Date: Wed, 05 Nov 1997 16:59:34 -0800 From: Rick Jones <raj@cup.hp.com> Reply-To: raj@cup.hp.com Organization: Network Performance Subject: HP-UX tuning tips
Here are some tuning tips for HP-UX to add to the tuning page.
For HP-UX 9.X: Upgrade to 10.20
For HP-UX 10.[00|01|10]: Upgrade to 10.20
For HP-UX 10.20:
Install the latest cumulative ARPA Transport Patch. This
will allow you to configure the size of the TCP connection
lookup hash table. The default is 256 buckets and must be set
to a power of two. This is accomplished with adb against the
*disc* image of the kernel. The variable name is tcp_hash_size.
Notice that it's critically important that you use "W"
to write a 32 bit quantity, not "w" to write a 16 bit
value when patching the disc image because the tcp_hash_size
variable is a 32 bit quantity.
How to pick the value? Examine the output of ftp://ftp.cup.hp.com/dist/networking/tools/connhist
and see how many total TCP connections exist on the system. You
probably want that number divided by the hash table size to be
reasonably small, say less than 10. Folks can look at HP's
SPECweb96 disclosures for some common settings. These can be
found at http://www.specbench.org/.
If an HP-UX system was performing at 1000 SPECweb96 connections
per second, the TIME_WAIT time of 60 seconds would mean
60,000 TCP "connections" being tracked.
Folks can check their listen queue depths with ftp://ftp.cup.hp.com/dist/networking/misc/listenq.
If folks are running Apache on a PA-8000 based system, they
should consider "chatr'ing" the Apache executable to have a
large page size. This would be "chatr +pi L <BINARY>".
The GID of the running executable must have MLOCK privileges.
Setprivgrp(1m) should be consulted for assigning
MLOCK. The change can be validated by running Glance
and examining the memory regions of the server(s) to make sure that
they show a non-trivial fraction of the text segment being locked.
If folks are running Apache on MP systems, they might
consider writing a small program that uses mpctl()
to bind processes to processors. A simple pid % numcpu
algorithm is probably sufficient. This might even go into the
source code.
If folks are concerned about the number of FIN_WAIT_2
connections, they can use nettune to shrink the value of
tcp_keepstart. However, they should be careful there -
certainly do not make it less than oh two to four minutes. If
tcp_hash_size has been set well, it is probably OK to
let the FIN_WAIT_2's take longer to timeout (perhaps
even the default two hours) - they will not on average have a big
impact on performance.
There are other things that could go into the code base, but that might be left for another email. Feel free to drop me a message if you or others are interested.
sincerely,
rick jones
Apache HTTP Server Version 2.4
Versión 2.4 del Servidor HTTP Apache
A continuación verá una lista de páginas adicionales de documentación que aplican al proyecto de desarrollo del servidor web Apache.
Los documentos no han sido completamente actualizados para tener en cuenta los cambios realizados en la versión 2.1 del Servidor Apache HTTP. Alguna información todavía puede ser relevante, por favor revísela con cuidado.
Notas sobre como configurar (en tiempo real y tiempo de compilación) Apache para el mejor rendimiento. Notas explicando por qué Apache hace ciertas cosas y por qué no hace otras (que le hacen ser más lento/rápido).
Alguna configuración de fácil acceso y opciones de mejora para Apache httpd 2.2 y 2.4 así como herramientas de motorización.
Algunas de las cosas que se deben y no deben hacer para mantener seguro su sitio web Apache.
Este documento actúa como una página de referencia para la mayor parte de estándares relevantes que Apache sigue.
Discusión de los distintos cifrados soportados por Apache para el proceso de autenticación.
Apache HTTP Server Version 2.4
ġ 2.0 ɰ ðɼ µ ̴. ġũ ʾ ġ 2.0 .
ġ 1.3 ؼ 2.0 ó Ȯ强(scalability) ̱ ȭ ߴ. ⺻ κ ȭ Ѵ. Ͻ Ȥ ɿ ū ִ. ġ 2.0 ϱ ڰ ִ ɼ Ѵ. ɼ ϵ ü Ȱϵ ϴ ݸ, ɼ ӵ Ѵ.
ɿ ū ִ .
û ð ڰ " ٰ" ϰ
ø ϸ ȵȴ. ڴ
ϰ ٽ Ͽ ϰ Ѵ. MaxClients þ Ͽ
ڽ ʵ ؾ
Ѵ. ϴ: top
μ ġ μ 뷮
˾Ƴ, ü 밡 ٸ μ
.
ϴ: CPU, Ʈī, ũ, ⼭ " " ؼ ؾ Ѵ.
ü ˾Ƽ ̴. Ϲ ϴٰ Ǹ ħ ִ:
ü ֽ ġ Ѵ. ü ۻ ֱ TCP ð ̺귯 ӵ ߴ.
ü sendfile(2) ýȣ
Ѵٸ, ̸ ϱ ̳ ġ ġϿ
ȮѴ. ( , 2.4 ̻ Ѵ.
Solaris 8 ʱ ġ ʿϴ.) ϴ ý̶
ġ 2 sendfile Ͽ CPU
ϸ մ.
| õ | õ þ |
|---|---|
ġ 1.3 HostnameLookups ⺻
On̿. û ġ DNS ˻
ϹǷ û . ġ 1.3
⺻ Off Ǿ. α ּҸ
ȣƮ ȯϷ αó α ϳ,
ġ Ե logresolve
α ϶.
αó ۾ ɿ ǿ ġǷ ϴ ƴ ٸ ǻͿ α óϱ ٶ.
Allow
from domainDeny from domain
<Location /server-status>
þ ϶.
ǿ ´ û DNS ȸ Ѵ.
.html .cgi ϸ DNS ˻
ϴ :
HostnameLookups off
<Files ~ "\.(html|cgi)$">
HostnameLookups on
</Files>
CGI DNS ʿ ̶, ʿ Ư
CGI gethostbyname ȣ ϵ غ
ִ.
URL Options FollowSymLinks
ʰ Options SymLinksIfOwnerMatch
ϸ ġ ɺũ ˻ϱ ýȣ
ѹ ؾ Ѵ. ϸ κи ѹ ȣ
Ѵ. , :
DocumentRoot /www/htdocs
<Directory />
Options SymLinksIfOwnerMatch
</Directory>
/index.html URI û ִٰ .
ġ /www, /www/htdocs,
/www/htdocs/index.html
lstat(2) ȣѴ. lstats
ij ʱ û Ź
۾ Ѵ. ¥ ɺũ ˻縦 Ѵٸ
ִ:
DocumentRoot /www/htdocs
<Directory />
Options FollowSymLinks
</Directory>
<Directory /www/htdocs>
Options -FollowSymLinks +SymLinksIfOwnerMatch
</Directory>
ּ DocumentRoot δ ˻
ʴ´. DocumentRoot ۿ ִ η Alias RewriteRule
쿡 ʿϴ. ɺũ
ʰ ְ ,
FollowSymLinks ϰ,
SymLinksIfOwnerMatch ȵȴ.
URL overrides Ѵٸ (
.htaccess ) ġ ϸ κи
.htaccess õѴ. ,
DocumentRoot /www/htdocs
<Directory />
AllowOverride all
</Directory>
/index.html URI û ִٰ .
ġ /.htaccess, /www/.htaccess,
/www/htdocs/.htaccess õѴ.
ذå Options FollowSymLinks
ϴ. ְ Ͻýۿ ؼ
AllowOverride None Ѵ.
ϰ ¥ ִٸ ´. ̵ Ϻ ۴. ִ. ϵī带 ϴ :
DirectoryIndex index
Ѵ:
DirectoryIndex index.cgi index.pl index.shtml index.html
տ д.
, 丮 ϵ ã MultiViews
ٴ, ϸ ʿ ִ
type-map
϶.
Ʈ ʿϴٸ Options
MultiViews þ ϱ⺸ type-map
϶. ڼ
type-map ϶.
, server-side-include óϴ ġ
2.0 ü mmap(2)
Ѵٸ Ѵ.
÷ Ѵ. Ʈ ġ 찡 ִ:
ü mmap CPU
read(2) ŭ Ȯ强 ʴ.
, μ Solaris ġ 2.0
mmap ó
Ѵ.
NFS Ʈ Ͻýۿ ִ ϴ ߿ ٸ NFS Ŭ̾Ʈ ִ μ ų ũ⸦ ̸, μ ϳ bus error ִ.
ǿ شϸ ϴ
ʵ EnableMMAP off ؾ Ѵ. (:
þ 丮 ִ.)
ġ ü sendfile(2) ϸ
Ŀ sendfile Ͽ -- , Ҷ
-- ִ.
÷ sendfile ϸ read send ʿ䰡 . sendfile ϸ ġԵǴ 찡 ִ:
sendfile ߸Ǿ ý ߰ ϴ ÷ ִ. Ư ٸ ǻͿ Ͽ sendfile ߸ ǻͷ 쿡 ϴ.
Ŀ ڽ ij Ͽ NFS Ʈ 찡 ִ.
ǿ شϸ sendfile ʵ
EnableSendfile off ؾ Ѵ. (:
þ 丮 ִ.)
ġ 1.3 MinSpareServers, MaxSpareServers, StartServers
ġũ ū ƴ. Ư ġ ۾
ϱ ڽļ ٴٸ "" Ⱓ
ʿߴ. ó StartServers ڽ
, MinSpareServers
ʴ ڽ ϳ . StartServers ⺻
5 Ŭ̾Ʈ 100 ÿ ϸ
ϸ óϱ ڽ 95ʰ ɷȴ.
ʴ , 10а
ϴ ġũ ſ ڰ ´.
ʴ Ѱ Ģ ڽ ϸ鼭
ߴ. ǻͰ ڽ ϴ ٻڸ
û . Ģ ġ ü
ɿ ǿ ־ Ͽ. ġ 1.3 ʴ Ѱ
Ģ ȭǾ. ڵ ڽ Ѱ , 1 ,
ΰ , 1 , װ , ̷ ʴ
ڽ 32 鶧 Ѵ. ڽļ MinSpareServers ٴٸ
ߴѴ.
ӵ MinSpareServers, MaxSpareServers, StartServers ʿ䰡 . ʿ
ڽ 4 ̻ ϸ ErrorLog Ѵ. ̷
̸ ϱ ٶ.
mod_status ̴.
μ Ͽ MaxRequestsPerChild
μ Ѵ. ⺻ ڽĴ ó û
ٴ 0̴. 30
ſ ִٸ, ʿ䰡
ִ. SunOS Solaris Ѵٸ,
10000 ϶.
(keep-alive) Ѵٸ ڽĵ ̹
ῡ ߰ û ٸ ƹ͵ ʱ
ٻڴ. KeepAliveTimeout
⺻ 15 ʴ ̷ ּȭѴ. Ʈ
뿪 ڿ ° Ѵ.
κ 쿡
60 ̻ ø .
ġ 2.x ó
(MPMs)̶ ü ִ ȭ Ѵ. ġ
Ҷ MPM ؾ Ѵ. beos,
mpm_netware, mpmt_os2,
mpm_winnt Ư ÷
ִ MPM ִ. Ϲ н ý MPM
߿ ϳ ִ. ӵ
Ȯ强(scalability) MPM ߳Ŀ ȴ:
worker MPM ڽ μ
带 Ѵ. ѹ
Ѵ. Ϲ worker prefork MPM
ϹǷ ŷ ϴ.prefork MPM 尡 Ѱ ڽ
μ Ѵ. μ ѹ
Ѵ. ýۿ prefork ӵ worker
, Ѵ. Ȳ
带 ʴ prefork worker
: 忡 (thread-safe)
ڰ ְ,
÷ ִ. 뷮 ɿ ߿ ̱
ʴ غ. DSO ߴٸ
LoadModule þ ּóϸ
ȴ. ϰ Ͽ Ʈ ̵
ϴ 캼 ִ.
ݴ ġ Ͽ ũִٸ ʴ ϱ ġ ؾ Ѵ.
⼭ 翬 ϰ
ǹ . Ʈ ٸ. Ƹ
ּ mod_mime,
mod_dir, mod_log_config
̴. Ʈ α ʿٸ
mod_log_config ȴ. õ
ʴ´.
mod_cache ֱ
worker MPM APR atomic API Ѵ. API 淮
ȭ atomic Ѵ.
⺻ APR ü/CPU ÷ ȿ
Ͽ Ѵ. , ֽ
CPU ϵ atomic compare-and-swap (CAS)
ϴ ɾ ִ. ÷ APR ̷
ɾ CPU ȣȯ mutex
⺻ Ѵ. ̷ ÷ ġ
Ҷ ġ ֽ CPU ȹ̶,
ġ Ҷ --enable-nonportable-atomics
ɼ Ͽ atomic ִ:
./buildconf
./configure --with-mpm=worker --enable-nonportable-atomics=yes
--enable-nonportable-atomics ɼ
÷ ִ:
--enable-nonportable-atomics ϸ
APR ϵ compare-and-swap SPARC
v8plus ɾ Ѵ. ɼ ϸ atomic
ȿ (CPU ϰ
ȭ ϴ), UltraSPARC
Ĩ ִ.
--enable-nonportable-atomics ϸ
APR ϵ compare-and-swap 486
ɾ Ѵ. ȿ atomic ,
486 ̻ Ĩ (386 ȵȴ)
ִ.
ġ Ҷ mod_status ϰ
Ҷ ExtendedStatus On ϸ ġ
û gettimeofday(2)(Ȥ ü
times(2)) ι ȣϰ (1.3 )
time(2) ߰ ȣѴ.
۽ð ʿϱ ̴. ֻ
(⺻) ExtendedStatus off Ѵ.
Ʒ ġ 2.0 ʴ. ȿ , ؼ ϱ ٶ.
н API Ѵ. Ʈ
Ȥ ּҸ ٸ Listen Ѵٰ .
˻ϱ ġ
select(2) Ѵ. select(2)
Ͽ ٸ ִ Ȥ ּ
Ѱ ִ ˷ش. ġ ڽ ְ,
ִ ڽ ÿ ο ˻Ѵ.
ϴ ( ڵ忡 ʾҴ.
ϱ 뵵 .):
for (;;) {
for (;;) {
fd_set accept_fds;
FD_ZERO (&accept_fds);
for (i = first_socket; i <= last_socket; ++i) {
FD_SET (i, &accept_fds);
}
rc = select (last_socket+1, &accept_fds, NULL, NULL, NULL);
if (rc < 1) continue;
new_connection = -1;
for (i = first_socket; i <= last_socket; ++i) {
if (FD_ISSET (i, &accept_fds)) {
new_connection = accept (i, NULL, NULL);
if (new_connection != -1) break;
}
}
if (new_connection != -1) break;
}
process the new_connection;
}
ܼ ɰ (starvation)
ִ. ڽ ÿ ݺ ϸ,
û ٸ select . ̶
Ͽ û ϳ ڽ
( ڽ ü Ÿֿ̹ ٸ).
̵ acceptϱ õѴ.
( Ḹ ̶) ڽĸ ϰ,
accept . ڽĵ
û ϵ , ο
û ͼ ڽ ﶧ ִ.
̷ PR#467
ó Ǿ. ּ ΰ ذå ִ.
Ѱ ʵ (non-blocking)
̴. ڽ accept ص
ʰ, ִ. CPU ð Ѵ.
select ڽ 10 ְ,
Ѱ Դٰ . ڽ 9
acceptϱ õϰ ϸ ƹ
ϵ ʰ ٽ select ݺѴ. ٽ
select ƿ ڽĵ ٸ Ͽ
û ʴ´. (μ ǻͿ)
ڽ ŭ CPU ִ 幮 찡 ƴ϶
ذå ƺ ʴ´.
ٸ ġ ϴ ݺ ڽĸ 鿩. ݺ (̸ ):
for (;;) {
accept_mutex_on ();
for (;;) {
fd_set accept_fds;
FD_ZERO (&accept_fds);
for (i = first_socket; i <= last_socket; ++i) {
FD_SET (i, &accept_fds);
}
rc = select (last_socket+1, &accept_fds, NULL, NULL, NULL);
if (rc < 1) continue;
new_connection = -1;
for (i = first_socket; i <= last_socket; ++i) {
if (FD_ISSET (i, &accept_fds)) {
new_connection = accept (i, NULL, NULL);
if (new_connection != -1) break;
}
}
if (new_connection != -1) break;
}
accept_mutex_off ();
process the new_connection;
}
accept_mutex_on accept_mutex_off
Լ mutex
Ѵ. ѹ ڽĸ mutex ִ.
mutex ϴ ̴. (1.3
) src/conf.h (1.3 )
src/include/ap_config.h ǵִ.
ŰĴ (locking) ʱ, ̷
ŰĿ Listen þ ϸ
ϴ.
AcceptMutex þ Ͽ
mutex ִ.
AcceptMutex flock ױ flock(2)
ýȣ Ѵ ( ġ LockFile þ ).
AcceptMutex fcntl ױ fcntl(2)
ýȣ Ѵ ( ġ LockFile þ ).
AcceptMutex sysvsem(1.3 ) SysV Ͽ
mutex Ѵ. SysV
ۿ ִ. ϳ ġ
ʰ ִ ̴ (ipcs(8) manpage
). ٸ ϳ uid ϴ
CGI (, suexec
cgiwrapper ʴ CGI)
API Ͽ źΰ ִ
̴. ̷ IRIX ŰĿ
ʴ´ (κ IRIX ǻͿ
ġ ̴).
AcceptMutex pthread(1.3 ) POSIX mutex ϱ POSIX Ծ ŰĶ 밡, (2.5 ) Solaris װ͵ Ư ϴ ϴ. õغٸ 缭 ϴ Ѵ. 븸 ϴ ϴ .
AcceptMutex posixsem(2.0 ) POSIX Ѵ. mutex μ 尡 ״´ٸ(segfault) ȸ ʾƼ .
ýۿ Ͽ ȭ(serialization) ִٸ ϴ ڵ带 APR ߰ ġ ִ.
غ ٸ κ ݺ ȭϴ ̴. , μ 鿩 ̴. ڽ ÿ ־ ȭ ü 뿪 Ȱ ϴ μ ǻͿ ִ. 캼 κ, ſ ȭ ʾƼ 켱 .
ֻ ؼ Listen ʴ
̴̻. Ѵ.
, Ѱ
? Ҷ ڽ
accept(2) ֱ ̷л
ʰ, . δ
տ ʴ (non-blocking) ϴ
"ȸ(spinning)" ߰ ִ. κ TCP
ϸ Ŀ accept ִ
ڽ 쵵 ִ. μ Ѱ
ڿ ư, Ŀο ȸϿ
߰ϸ ٽ ܴ. ڿ ڵ忡
̷ ȸ , и Ѵ.
ʴ ϰ ϸ ̴ ʿ ൿ
Ͼ.
츮 ŰĿ Ѱ 쿡
ȭϸ "" ߰ߴ. κ
⺻ ȭ Ѵ. (Ŀ 2.0.30,
128Mb Pentium pro) Ѱ
ȭϸ 쿡 ʴ û 3% ̸
پ. ȭ û 100ms
ߴ. Ƹ LAN ϴ
ἱ ̴. Ѱ ȭ
SINGLE_LISTEN_UNSERIALIZED_ACCEPT
Ѵ.
draft-ietf-http-connection-00.txt 8 ϵ Ƿ, ־ Ѵ (TCP ֹ̰, ̴). ٸ , ġ 1.2 Ȯ ؿԴ.
ϰ ġ ߰ н
ߴ. TCP Ծ
FIN_WAIT_2 ŸӾƿ ִٰ ʾ,
ʾҴ. ŸӾƿ ýۿ ġ 1.2
FIN_WAIT_2 · .
ۻ簡 ϴ ֽ TCP/IP ġ
Ͽ ذ ִ. ۻ簡 ġ ǥ
ʴ 찡 (, SunOS4 -- ҽ ̼ ִ
ġ ) ֱ
ʱ ߴ.
ΰ. ϳ ɼ SO_LINGER
ϴ ̴. κ TCP/IP
ɼ ùٷ ʾҴ. ùٷ ÿ
(, 2.0.31)
cpu ƸԴ´.
ġ (http_main.c ִ)
lingering_close Լ Ѵ. Լ
:
void lingering_close (int s)
{
char junk_buffer[2048];
/* shutdown the sending side */
shutdown (s, 1);
signal (SIGALRM, lingering_death);
alarm (30);
for (;;) {
select (s for reading, 2 second timeout);
if (error) break;
if (s is ready for reading) {
if (read (s, junk_buffer, sizeof (junk_buffer)) <= 0) {
break;
}
/* just toss away whatever is here */
}
}
close (s);
}
ڵ CPU ,
ʿϴ. HTTP/1.1 θ
Ѵٸ(persistent), û
óϸ鼭 ̴. ϰԵ
NO_LINGCLOSE Ͽ
, ʴ´. Ư HTTP/1.1
(; ¿ ٸ
ʰ û )
lingering_close ʼ̴ (
ϱ ٶ ̴).
ġ θ ڽ scoreboard
Ѵ. ̻δ scoreboard ؾ
Ѵ. 츮 ڰ ش ü ְų
Ͽ Ѵ.
ũ ִ Ͽ Ѵ. ũ
ִ ŷڵ (ɵ ).
src/main/conf.h Ͽ ϴ Űĸ
ãƼ USE_MMAP_SCOREBOARD Ȥ
USE_SHMGET_SCOREBOARD ȮѴ.
ϳ ( Բ HAVE_MMAP̳
HAVE_SHMGET ) ϸ ڵ带
Ѵ. ý ٸ Ѵٸ
src/main/http_main.c Ͽ ġ
ֵ (hook) ߰϶. (
ġ 츮 ֱ ٶ.)
о ʴ´ٸ ( ̶
̱ д´ٸ Ƹ
о ̴), Ҷ
-DDYNAMIC_MODULE_LIMIT=0 ߰Ѵ.
о̱ Ҵϴ Ѵ.
Solaris 8 worker MPM ġ 2.0.38 ýȣ (trace)̴. Ʒ ɾ Ͽ :
truss -l -p httpd_child_pid.
-l ɼ ϸ truss ýȣ
ϴ LWP (lightweight process, 淮 μ--Solaris
Ŀμ ) ID Ѵ.
ٸ ýۿ strace, ktrace,
par ýȣ ִ.
ϴ.
Ŭ̾Ʈ ũⰡ 10KB ûѴ. û ʰų ϴ û ſ ٸ (δ ſ ˾ƺ ).
/67: accept(3, 0x00200BEC, 0x00200C0C, 1) (sleeping...) /67: accept(3, 0x00200BEC, 0x00200C0C, 1) = 9
(listener) 尡 LWP #67 ִ.
accept(2) ȭ ָ϶.
Ʈ ٸʴ ÷ worker MPM
⺻ ȭ accept Ѵ./65: lwp_park(0x00000000, 0) = 0 /67: lwp_unpark(65, 1) = 0
Ƶ̰(accept) worker 带 û óϰ Ѵ. Ʒ Ͽ û óϴ worker 尡 LWP #65 ִ.
/65: getsockname(9, 0x00200BA4, 0x00200BC4, 1) = 0
ȣƮ ϱ ġ Ƶ
(local) ּҸ ˾ƾ Ѵ. (ȣƮ
ʰų Listen
þ ϵī ּҸ )
ȣ ִ. ̷ ȭ ۾
ȵִ.
/65: brk(0x002170E8) = 0 /65: brk(0x002190E8) = 0
brk(2) ȣ (heap) ҴѴ.
κ û ó ü
Ҵ(apr_pool apr_bucket_alloc)
ϱ ýȣ Ͽ ýȣ Ⱑ
幰. Ͽ ڸ ü Ҵڰ
malloc(3) ȣѴ.
/65: fcntl(9, F_GETFL, 0x00000000) = 2 /65: fstat64(9, 0xFAF7B818) = 0 /65: getsockopt(9, 65535, 8192, 0xFAF7B918, 0xFAF7B910, 2190656) = 0 /65: fstat64(9, 0xFAF7B818) = 0 /65: getsockopt(9, 65535, 8192, 0xFAF7B918, 0xFAF7B914, 2190656) = 0 /65: setsockopt(9, 65535, 8192, 0xFAF7B918, 4, 2190656) = 0 /65: fcntl(9, F_SETFL, 0x00000082) = 0
worker Ŭ̾Ʈ (ϱ 9)
(non-blocking) · ٲ۴. setsockopt(2)
getsockopt(2) ȣ Solaris libc Ͽ
fcntl(2) óϴ ش.
/65: read(9, " G E T / 1 0 k . h t m".., 8000) = 97
worker Ŭ̾Ʈ û д´.
/65: stat("/var/httpd/apache/httpd-8999/htdocs/10k.html", 0xFAF7B978) = 0
/65: open("/var/httpd/apache/httpd-8999/htdocs/10k.html", O_RDONLY) = 10 Options FollowSymLinks
AllowOverride None̴. û ϰ
丮 lstat(2)ϰų
.htaccess ˻ ʿ䰡 .
˻ϱ, 1) ִ, 2) 丮 ƴ Ϲ,
stat(2) ȣ⸸ ϸ ȴ.
/65: sendfilev(0, 9, 0x00200F90, 2, 0xFAF7B53C) = 10269
ѹ sendfilev(2) ýȣ
HTTP û ִ. Sendfile δ
ü ٸ. ٸ ý̶ sendfile(2)
ȣϱ write(2)
writev(2) ȣ Ѵ.
/65: write(4, " 1 2 7 . 0 . 0 . 1 - ".., 78) = 78
write(2) ȣ ٷα(access log) û
Ѵ. Ͽ time(2) ȣ ָ϶.
ġ 1.3 ġ 2.0 ð ˱
gettimeofday(3) Ѵ.
gettimeofday ȭ Solaris
ü Ϲ ýȣ δ .
/65: shutdown(9, 1, 1) = 0 /65: poll(0xFAF7B980, 1, 2000) = 1 /65: read(9, 0xFAF7BC20, 512) = 0 /65: close(9) = 0
worker ݱ(lingering close)Ѵ.
/65: close(10) = 0 /65: lwp_park(0x00000000, 0) (sleeping...)
worker ݰ, (listener) 尡 ٸ Ҵ Ѵ.
/67: accept(3, 0x001FEB74, 0x001FEB94, 1) (sleeping...)
( worker ۾̸
带 ߴ worker MPM 帧 ɿ )
worker 忡 Ҵڸ ٸ Ƶ ִ.
Ͽ , worker 尡
óϴ accept(2) (û ſ
) Ͼ ִ.
Apache HTTP Sunucusu Sürüm 2.4
Bir HTTP Sunucusunu ayarlarken dikkat edilmesi gerekenler ve bazı ipuçları. Öneriler kısmen Apache’ye özel kısmen de genel olacaktır.
Güncel Tutma Hizmet Reddi (DoS) Saldırıları ServerRoot Dizinlerinin İzinleri Sunucu Taraflı İçerik Yerleştirme CGI Genelinde ScriptAlias’sız CGI ScriptAlias’lı CGI Devingen içerikli kaynaklar Devingen içeriğin güvenliği Sistem Ayarlarının Korunması Sunucu dosyalarının öntanımlı olarak korunması Günlüklerin İzlenmesi Yapılandırma bölümlerinin birleştirilmesiApache HTTP Sunucusu iyi bir güvenlik sicilinin yanında güvenlik konularıyla oldukça ilgili bir geliştirici topluluğuna sahiptir. Fakat, bir yazılımın dağıtılmasının ardından küçük ya da büyük bazı sorunların keşfedilmesi kaçınılmazdır. Bu sebeple, yazılım güncellemelerinden haberdar olmak oldukça önem kazanır. HTTP sunucunuzu doğrudan Apache’den temin ediyorsanız yeni sürümler ve güvenlik güncellemeleri ile ilgili bilgileri tam zamanında alabilmek için Apache HTTP Sunucusu Duyuru Listesine mutlaka üye olmanızı öneririz. Apache yazılımının üçüncü parti dağıtımlarını yapanların da buna benzer hizmetleri vardır.
Şüphesiz, bir HTTP sunucusu, sunucu kodunda bir sorun olmasa da tehlike altındadır. Eklenti kodları, CGI betikleri hatta işletim sisteminden kaynaklanan sorunlar nedeniyle bu ortaya çıkabilir. Bu bakımdan, sisteminizdeki tüm yazılımların sorunları ve güncellemeleri hakkında bilgi sahibi olmalısınız.
Tüm ağ sunucuları, istemcilerin sistem kaynaklarından yararlanmalarını engellemeye çalışan hizmet reddi saldırılarına (HRS) maruz kalabilir. Bu tür saldırıları tamamen engellemek mümkün değildir, fakat yarattıkları sorunları azaltmak için bazı şeyler yapabilirsiniz.
Çoğunlukla en etkili anti-HRS aracı bir güvenlik duvarı veya başka bir işletim sistemi yapılandırmasıdır. Örneğin, çoğu güvenlik duvarı herhangi bir IP adresinden aynı anda yapılan bağlantıların sayısına bir sınırlama getirmek üzere yapılandırılabilir. Böylece basit saldırılar engellenebilir. Ancak bunun dağıtık hizmet reddi saldırılarına (DHRS) karşı bir etkisi olmaz.
Bunların yanında Apache HTTP Sunucusunun da sorunları azaltıcı tedbirler alınmasını sağlayacak bazı yapılandırmaları vardır:
RequestReadTimeout
yönergesi bir istemcinin isteği göndermek için harcadığı zamanı
sınırlamayı sağlar.TimeOut yönergesinin değeri düşürülmelidir. Birkaç
saniye gibi mümkün olduğunca düşük bir ayar uygun olabilir. Ancak
TimeOut başka işlemlerde de
kullanıldığından çok düşük değerler, örneğin, uzun süre çalışan CGI
betiklerinde sorunlar çıkmasına sebep olabilir.KeepAliveTimeout yönergesinin değeri de düşürülebilir.
Hatta bazı siteler başarımı arttırmak amacıyla KeepAlive yönergesi üzerinden kalıcı
bağlantıları tamamen kapatabilirler.LimitRequestBody,
LimitRequestFields,
LimitRequestFieldSize,
LimitRequestLine ve
LimitXMLRequestBody yönergeleri,
istemci girdileri ile tetiklenen özkaynak tüketimini sınırlamak için
yapılandırılırken dikkatli olunmalıdır.AcceptFilter yönergesinin etkin olmasını sağlamalısınız.
Bu, Apache HTTP Sunucusunda zaten öntanımlı olarak etkindir.
Yapacağınız şey işletim sistemi çekirdeğini buna göre yapılandırmak
olacaktır.MaxRequestWorkers yönergesini kullanın. Ayrıca, başarım arttırma belgesine de
bakabilirsiniz.event MPM’i
her bağlantıya yeni bir evre atanmaması için eşzamansız işlem yapar.
OpenSSL kütüphanesinin doğası nedeniyle
event MPM’i mod_ssl ve diğer girdi
süzgeçleri ile henüz uyumlu değildir. Bu durumlarda,
worker MPM'inin davranışına geri döner.ServerRoot Dizinlerinin İzinleriNormalde, Apache root kullanıcı tarafından başlatılır ve hizmetleri
sunarken User yönergesi
tarafından tanımlanan kullanıcının aidiyetinde çalışır. Root tarafından
çalıştırılan komutlarda olduğu gibi, root olmayan kullanıcıların
yapacakları değişikliklerden korunmak konusunda da dikkatli
olmalısınız. Dosyaların sadece root tarafından yazılabilir olmasını
sağlamak yeterli değildir, bu dizinler ve üst dizinler için de
yapılmalıdır. Örneğin, sunucu kök dizininin
/usr/local/apache olmasına karar verdiyseniz, bu dizini
root olarak şöyle oluşturmanız önerilir:
mkdir /usr/local/apache
cd /usr/local/apache
mkdir bin conf logs
chown 0 . bin conf logs
chgrp 0 . bin conf logs
chmod 755 . bin conf logs
/, /usr, /usr/local
dizinlerinde sadece root tarafından değişiklik yapılabileceği kabul
edilir. httpd çalıştırılabilirini kurarken de benzer
bir önlemin alındığından emin olmalısınız:
cp httpd /usr/local/apache/bin
chown 0 /usr/local/apache/bin/httpd
chgrp 0 /usr/local/apache/bin/httpd
chmod 511 /usr/local/apache/bin/httpd
Diğer kullanıcıların değişiklik yapabileceği bir dizin olarak bir
htdocs dizini oluşturabilirsiniz. Bu dizine root
tarafından çalıştırılabilecek dosyalar konulmamalı ve burada root
tarafından hiçbir dosya oluşturulmamalıdır.
Diğer kullanıcılara root tarafından yazılabilen ve çalıştırılabilen
dosyalarda değişiklik yapma hakkını tanırsanız, onlara root
kullanıcısını ele geçirilebilme hakkını da tanımış olursunuz. Örneğin,
biri httpd çalıştırılabilirini zararlı bir programla
değiştirebilir ve o programı tekrar çalıştırdığınız sırada program
yapacağını yapmış olur. Günlükleri kaydettiğiniz dizin herkes
tarafından yazılabilen bir dizin olduğu takdirde, birileri bir günlük
dosyasını bir sistem dosyasına sembolik bağ haline getirerek root
kullanıcısının bu dosyaya ilgisiz şeyler yazmasına sebep olabilir.
Günlüklerin dosyaları herkes tarafından yazılabilir olduğu takdirde ise
birileri dosyaya yanıltıcı veriler girebilir.
SSI sayfaları bir sunucu yöneticisi açısından çeşitli olası risklere kaynaklık edebilir.
İlk risk, sunucu yükündeki artış olasılığıdır. Tüm SSI sayfaları, SSI kodu içersin içermesin Apache tarafından çözümlenir. Bu küçük bir artış gibi görünürse de bir paylaşımlı sunucu ortamında önemli bir yük haline gelebilir.
SSI sayfaları, CGI betikleriyle ilgili riskleri de taşır. exec
cmd elemanı kullanılarak bir SSI sayfasından herhangi bir CGI
betiğini veya bir sistem programını Apache’nin aidiyetinde olduğu
kullanıcının yetkisiyle çalıştırmak mümkündür.
SSI sayfalarının yararlı özelliklerinden yararlanırken güvenliğini de arttırmanın bazı yolları vardır.
Sunucu yöneticisi, bir başıbozuk SSI sayfasının sebep olabileceği zararları bertaraf etmek için CGI Genelinde bölümünde açıklandığı gibi suexec’i etkin kılabilir.
SSI sayfalarını .html veya .htm
uzantılarıyla etkinleştirmek tehlikeli olabilir. Bu özellikle
paylaşımlı ve yüksek trafikli bir sunucu ortamında önemlidir. SSI
sayfalarını normal sayfalardan farklı olarak .shtml gibi
bildik bir uzantıyla etkinleştirmek gerekir. Bu, sunucu yükünü asgari
düzeyde tutmaya ve risk yönetimini kolaylaştırmaya yarar.
Diğer bir çözüm de SSI sayfalarından betik ve program çalıştırmayı
iptal etmektir. Bu, Options
yönergesine değer olarak Includes yerine
IncludesNOEXEC vererek sağlanır. Ancak, eğer betiklerin
bulunduğu dizinde ScriptAlias
yönergesiyle CGI betiklerinin çalışması mümkün kılınmışsa,
kullanıcıların <--#include virtual="..." --> ile bu
betikleri çalıştırabileceklerine dikkat ediniz.
Herşeyden önce ya CGI betiğini/programını yazanlara ya da kendinizin CGI'deki güvenlik açıklarını (ister kasıtlı olsun ister tesadüfi) yakalama becerinize güvenmek zorundasınız. CGI betikleri esasen sisteminizdeki komutları site kullanıcılarının izinleriyle çalıştırırlar. Bu bakımdan dikkatle denenmedikleri takdirde oldukça tehlikeli olabilirler.
CGI betiklerinin hepsi aynı kullanıcının aidiyetinde çalışırsa diğer betiklerle aralarında çelişkilerin ortaya çıkması ister istemez kaçınılmazdır. Örneğin A kullanıcısının B kullanıcısına garezi varsa bir betik yazıp B’nin CGI veritabanını silebilir. Bu gibi durumların ortaya çıkmaması için betiklerin farklı kullanıcıların aidiyetlerinde çalışmasını sağlayan ve 1.2 sürümünden beri Apache ile dağıtılan suEXEC diye bir program vardır. Başka bir yol da CGIWrap kullanmaktır.
ScriptAlias’sız CGIKullanıcıların sitenin her yerinde CGI betiklerini çalıştırmalarına izin vermek ancak şu koşullarda mümkün olabilir:
ScriptAlias’lı CGICGI’yi belli dizinlerle sınırlamak yöneticiye bu dizinlerde daha iyi
denetim imkanı sağlar. Bu kaçınılmaz olarak ScriptAlias’sız CGI’den çok daha
güvenlidir, ancak bu dizinlere yazma hakkı olan kullanıcılarınız
güvenilir kişiler olması ve site yöneticisinin de olası güvenlik
açıklarına karşı CGI betiklerini ve programlarını denemeye istekli
olması şartıyla.
Çoğu site yöneticisi ScriptAlias’sız CGI yerine bu
yaklaşımı seçer.
Sunucunun bir parçası gibi çalışan, mod_php,
mod_perl, mod_tcl ve mod_python
gibi gömülü betik çalıştırma seçenekleri sunucuyu çalıştıran
kullanıcının aidiyetinde çalışırlar (User yönergesine bakınız). Bu bakımdan bu betik
yorumlayıcılar tarafından çalıştırılan betikler, sunucu kullanıcısının
eriştiği herşeye erişebilirler. Bazı betik yorumlayıcıların getirdiği
bazı sınırlamalar varsa da bunlara pek güvenmemek, gerekli sınamaları
yine de yapmak gerekir.
mod_php, mod_perl veya
mod_python gibi devingen içeriği yapılandırırken
güvenlikle ilgili değerlendirmelerin çoğu httpd'nin
kapsamından çıkar ve bu modüllerin belgelerini incelemek ihtiyacı
duyarsınız. Örneğin, PHP çoğu zaman kapalı tutulan
Güvenli
Kip ayarını etkin kılmanızı önerir. Daha fazla güvenlik için bir
diğer örnek bir PHP eklentisi olan
Suhosin'dir. Bunlar
hakkında daha ayrıntılı bilgi için her projenin kendi belgelerine
başvurun.
Apache seviyesinde, mod_security adı verilen modülü bir HTTP güvenlik duvarı gibi ele alabilir, devingen içeriğin güvenliğini arttırmanıza yardımcı olmak üzere inceden inceye yapılandırabilirsiniz.
Güvenliği gerçekten sıkı tutmak istiyorsanız, kullanıcılarınızın
yapılandırmanızdaki güvenlik ayarlarını geçersiz kılmak için
.htaccess dosyalarını kullanabilmelerinin de önüne
geçmelisiniz. Bunu yapmanın tek bir yolu vardır.
Sunucu yapılandırma dosyanıza şunu yerleştirin:
<Directory "/">
AllowOverride None
</Directory>
Böylece, belli dizinlerde özellikle etkinleştirilmedikçe bütün
dizinlerde .htaccess dosyalarının kullanımını engellemiş
olursunuz.
Bu ayar Apache 2.3.9 itibariyle öntanımlıdır.
Apache’nin ister istemez yanlış anlaşılan yönlerinden biri öntanımlı erişim özelliğidir. Yani siz aksine bir şeyler yapmadıkça, sunucu normal URL eşleme kurallarını kullanarak bir dosyayı bulabildiği sürece onu istemciye sunacaktır.
Örneğin, aşağıdaki durumu ele alalım:
# cd /; ln -s / public_html
Ve, tarayıcınıza http://localhost/~root/ yazın.
Böylece, istemcilerin tüm dosya sisteminizi gezmelerine izin vermiş olursunuz. Bu işlemin sonuçlarının önünü almak için sunucu yapılandırma dosyanıza şunları yazın:
<Directory "/">
Require all denied
</Directory>
Bu suretle, dosya sisteminize öntanımlı erişimi yasaklamış olursunuz.
Erişime izin vermek istediğiniz dizinler için uygun Directory bölümleri eklemeniz yeterli
olacaktır. Örnek:
<Directory "/usr/users/*/public_html">
Require all granted
</Directory>
<Directory "/usr/local/httpd">
Require all granted
</Directory>
Location ve Directory yönergelerinin etkileşimine de
özellikle önem vermelisiniz; örneğin <Directory "/">
erişimi yasaklarken bir <Location "/"> yönergesi bunu
ortadan kaldırabilir.
UserDir yönergesi de size
buna benzer bir oyun oynayabilir; yönergeye ./ atamasını
yaparsanız, root kullanıcısı söz konusu olduğunda yukarıda ilk örnekteki
durumla karşılaşırız. Sunucu yapılandırma dosyanızda aşağıdaki satırın
mutlaka bulunmasını öneririz:
UserDir disabled root
Sunucunuzda olup biteni günü gününe bilmek istiyorsanız günlük dosyalarına bakmalısınız. Günlük dosyaları sadece olup biteni raporlamakla kalmaz, sunucunuza ne tür saldırılar yapıldığını ve güvenlik seviyenizin yeterli olup olmadığını anlamanızı da sağlarlar.
Bazı örnekler:
grep -c "/jsp/source.jsp?/jsp/ /jsp/source.jsp??" access_log
grep "client denied" error_log | tail -n 10
İlk örnek, Apache Tomcat Source.JSP Bozuk İstek Bilgilerini İfşa Açığını istismar etmeyi deneyen saldırıların sayısını verirken ikinci örnek, reddedilen son on istemciyi listeler; örnek:
[Thu Jul 11 17:18:39 2002] [error] [client foo.example.com] client denied
by server configuration: /usr/local/apache/htdocs/.htpasswd
Gördüğünüz gibi günlük dosyaları sadece ne olup bittiğini raporlar, bu
bakımdan eğer istemci .htpasswd dosyasına erişebiliyorsa erişim günlüğünüzde şuna benzer bir
kayıt görürsünüz:
foo.example.com - - [12/Jul/2002:01:59:13 +0200] "GET /.htpasswd HTTP/1.1"
Bu, sunucu yapılandırma dosyanızda aşağıdaki yapılandırmayı iptal ettiğiniz anlamına gelir:
<Files ".ht*">
Require all denied
</Files>
Yapılandırma bölümlerinin birleştirilmesi karmaşık bir işlem olup bazı durumlarda yönergelere bağlıdır. Yönergeleri bir araya getirirken aralarındaki bağımlılıkları daima sınayın.
mod_access_compat gibi henüz yönerge katıştırma
mantığını gerçeklememiş modüller için sonraki bölümlerdeki davranış, bu
modüllerin yönergelerini içerip içermemesine bağlıdır. Yapılandırmada
yönergelerin yerleri değiştirildiğinde fakat bir katıştırma
yapılmadığında, yapılandırma bir değişiklik yapılana kadar miras
alınır.
Apache HTTP 服务器版本 2.4
下面是适用于 Apache 服务器开发项目的附加文档。
下面的文档尚未完全更新，以反映自 Apache HTTP 服务器版本 2.1 之后的修改。某些信息可能仍旧适用，但请小心使用它。
对如何在编译或运行时，配置 Apache，以便性能更高的说明。 解释了为什么 Apache 这样做，而不那样做 (这会让它更慢或更快)。
做和不做 - 如何让你的 Apache 站点保持安全。
这篇文档是 Apache 遵循的相关标准的参考页面。
对 Apache 身份认证支持的各种密码加密格式的讨论。
Apache HTTP Server Version 2.4
ġ ü ϴ. ũ ۰ ǥ ߰ߵǴ . Ʈ ֽŹ ϴ ߿ϴ. ġ ٿεߴٸ, ο Ʈ ˷ִ ġ ǥ ϸƮ ϱ Ѵ. ġ Ʈ ϴ ڵ鵵 Ѵ.
ڵ嶧 ϴ ʴ. ߰ ڵ, CGI ũƮ, ü ϴ 찡 . Ƿ ϸ ý Ʈ Ʈؾ Ѵ.
root ڰ ġ , û ϱ
User þ
ڷ ȯѴ. root ϴ ɾ ִٸ,
root ̿ ڰ ϵ ؾ Ѵ.
ϵ root ־ ϰ, 丮 丮
. , ServerRoot /usr/local/apache
Ѵٸ root ڰ 丮
Ѵ:
mkdir /usr/local/apache
cd /usr/local/apache
mkdir bin conf logs
chown 0 . bin conf logs
chgrp 0 . bin conf logs
chmod 755 . bin conf logs
/, /usr, /usr/local root ִ. httpd ġҶ ȣؾ Ѵ:
cp httpd /usr/local/apache/bin
chown 0 /usr/local/apache/bin/httpd
chgrp 0 /usr/local/apache/bin/httpd
chmod 511 /usr/local/apache/bin/httpd
htdocs 丮 ٸ ڵ ֵ ִ -- root װ ִ , ʾƾ Ѵ.
root ƴ ڰ root ϰų Ⱑ ִٸ ý root ĥ ִ. , httpd Ͽٸ Ҷ ڵ带 ϰ ȴ. logs 丮 (root ƴ ڿ) Ⱑϴٸ α ٸ ýϷ ɺũ ɾ root Ͽ ڷḦ ִ. α (root ƴ ڿ) Ⱑϴٸ α ̻ ڷḦ ִ.
Server Side Includes (SSI) ڿ Ȼ ̴.
ù° ϸ ø ̴. ġ Ͽ SSI þ ִ ο SSI мؾ Ѵ. ϰ , ϴ ȯ濡 ɰ ִ.
, SSI Ϲ CGI ũƮ . SSI Ͽ "exec cmd" ϸ httpd.conf ġ ϵ ڿ CGI ũƮ α ִ.
Ȱϸ鼭 SSI Ű ִ.
.html̳ .htm Ȯڸ SSI Ϸ ϴ ϴ. Ư ϰų ŷ ȯ濡 ϴ. SSI Ϲ ϴ .shtml Ȯڸ Ѵ. ϸ ּȭϰ Ҹ ִ.
ٸ SSI ũƮ α
ϵ ̴. Options þ Includes
IncludesNOEXEC Ѵ. ũƮ
ScriptAlias þ
丮 ִٸ <--#include virtual="..." -->
Ͽ CGI ũƮ ϶.
ᱹ CGI ũƮ/α ڸ ŷؾ ϰ, ǰ Ǽ̰ CGI Ȼ ߰ ־ Ѵ. ⺻ CGI ũƮ ýۿ ɾ ֱ ְ Ȯ ſ ϴ.
CGI ũƮ ڷ DZ ٸ ũƮ (ǰ Ǽ̰) 浹 ɼ ִ. , A B ſ ȾϿ, B CGI ͺ̽ ũƮ ۼ ִ. ġ 1.2 ԵǾ ġ Ư (hook) ϴ suEXEC ũƮ ٸ ڷ ϴ ϳ. ٸ CGIWrap ִ.
Ư 丮 CGI ֵ ϸ ڴ ̵ 丮 ִ. scriptalias CGI Ȯ ϴ. , ŷϴ ڸ 丮 ְ, ڰ ο CGI ũƮ/α Ȼ ˻ ̰ ִٸ.
κ Ʈ scriptalias CGI Ѵ.
Ϸ ڰ
.htaccess Ͽ ȱ
ϱ ٶ ̴.
ִ.
Ͽ ߰Ѵ
<Directory />
AllowOverride None
</Directory>
밡ϵ 丮 ϰ
.htaccess .
ġ ⺻ ٿ ߸ ˰ִ. , Ϲ URL Ģ Ͽ ã ִٸ, Ư ġ ʴ Ŭ̾Ʈ ִ.
, Ʒ :
# cd /; ln -s / public_html
http://localhost/~root/ Ѵ
Ŭ̾Ʈ ü Ͻý ƴٴ ִ. ̸ ġ Ѵ:
<Directory />
Order Deny,Allow
Deny from all
</Directory>
Ͻý ġ ⺻ źεȴ.
ϴ ֵ Directory ߰Ѵ.
<Directory /usr/users/*/public_html>
Order Deny,Allow
Allow from all
</Directory>
<Directory /usr/local/httpd>
Order Deny,Allow
Allow from all
</Directory>
Location Directory þ ϴ
Ư Ǹ ￩. , <Directory
/> źϴ <Location
/> þ ̸ ִ
UserDir þ
ϴ 쿡 ϶. þ "./" ϸ
root ڿ ٷ Ѵ.
ġ 1.3 ̻ Ѵٸ Ͽ Ʒ ߰ϱ
Ѵ:
UserDir disabled root
־ ִ ˷ α Ѵ. α ̹ Ͼ ϸ , ־ ˷ְ ʿ ŭ Ȯϰ ش.
:
grep -c "/jsp/source.jsp?/jsp/ /jsp/source.jsp??" access_log
grep "client denied" error_log | tail -n 10
ù° ߸ Source.JSP û ˾Ƴ ִ Tomcat ̿Ϸ Ƚ ˷ְ, ι° źε ֱ Ŭ̾Ʈ 10 ش:
[Thu Jul 11 17:18:39 2002] [error] [client foo.bar.com] client denied
by server configuration: /usr/local/apache/htdocs/.htpasswd
α ̹ Ǹ Ѵ.
Ŭ̾Ʈ .htpasswd Ͽ
־ٸ α
̴:
foo.bar.com - - [12/Jul/2002:01:59:13 +0200] "GET /.htpasswd HTTP/1.1"
, Ͽ κ ּó ̴:
<Files ".ht*">
Order allow,deny
Deny from all
<Files>
Serveur HTTP Apache Version 2.4
Apache 2.x est un serveur web à usage général, conçu dans un but d'équilibre entre souplesse, portabilité et performances. Bien que non conçu dans le seul but d'établir une référence en la matière, Apache 2.x est capable de hautes performances dans de nombreuses situations du monde réel.
Comparée à Apache 1.3, la version 2.x comporte de nombreuses optimisations supplémentaires permettant d'améliorer le débit du serveur et sa personnalisation. La plupart de ces améliorations sont activées par défaut. Cependant, certains choix de configuration à la compilation et à l'exécution peuvent affecter les performances de manière significative. Ce document décrit les options qu'un administrateur de serveur peut configurer pour améliorer les performances d'une installation d'Apache 2.x. Certaines de ces options de configuration permettent au démon httpd de mieux tirer parti des possibilités du matériel et du système d'exploitation, tandis que d'autres permettent à l'administrateur de privilégier la vitesse par rapport aux fonctionnalités.
Problèmes matériels et relatifs au système d'exploitation Optimisation de la configuration à l'exécution Optimisation de la configuration à la compilation Appendice : Analyse détaillée d'une traceLe principal problème matériel qui affecte les performances du serveur
web est la mémoire vive (RAM). Un serveur web ne devrait jamais avoir à
utiliser le swap, car le swapping augmente le temps de réponse de chaque
requête au delà du point que les utilisateurs considèrent comme
"trop lent". Ceci incite les utilisateurs à cliquer sur "Stop", puis
"Charger à nouveau", ce qui a pour effet d'augmenter encore la charge
du serveur. Vous pouvez, et même devez définir la valeur de la directive
MaxRequestWorkers de façon à ce que
votre serveur ne lance pas un nombre de processus enfants tel qu'il
commence à faire du swapping. La méthode pour y parvenir est
simple : déterminez la taille de votre processus Apache standard en
consultant votre liste de processus à l'aide d'un outil tel que
top, et divisez votre quantité totale de mémoire disponible
par cette taille, tout en gardant un espace suffisant
pour les autres processus.
Hormis ce réglage relatif à la mémoire, le reste est trivial : le processeur, la carte réseau et les disques doivent être suffisamment rapides, où "suffisamment rapide" doit être déterminé par l'expérience.
Le choix du système d'exploitation dépend principalement du contexte local. Voici cependant quelques conseils qui se sont généralement avérés utiles :
Exécutez la dernière version stable et le niveau de patches le plus haut du système d'exploitation que vous avez choisi. De nombreux éditeurs de systèmes d'exploitation ont amélioré de manière significative les performances de leurs piles TCP et de leurs bibliothèques de thread ces dernières années.
Si votre système d'exploitation possède un appel système
sendfile(2), assurez-vous d'avoir installé la version
et/ou les patches nécessaires à son activation. (Pour Linux, par
exemple, cela se traduit par Linux 2.4 ou plus. Pour les versions
anciennes de Solaris 8, vous pouvez être amené à appliquer un patch.)
Sur les systèmes où il est disponible, sendfile permet
à Apache 2 de servir les contenus statiques plus rapidement, tout en
induisant une charge CPU inférieure.
| Modules Apparentés | Directives Apparentées |
|---|---|
Avant Apache 1.3, la directive
HostnameLookups était positionnée
par défaut à On. Ce réglage augmente le temps de réponse de
chaque requête car il entraîne une recherche DNS et le traitement de la
requête ne pourra pas être achevé tant que cette recherche ne sera
pas terminée. Avec Apache 1.3, ce réglage est défini par défaut à
Off. Si vous souhaitez que les adresses dans vos fichiers
journaux soient résolues en noms d'hôtes, utilisez le programme
logresolve fourni avec Apache, ou un des nombreux
paquets générateurs de rapports sur les journaux disponibles.
Il est recommandé d'effectuer ce genre de traitement a posteriori de vos fichiers journaux sur une autre machine que celle qui héberge le serveur web en production, afin que cette activité n'affecte pas les performances du serveur.
Si vous utilisez une directive
Allowfrom domainDeny from domain
Notez qu'il est possible de modifier la portée des directives, en les
plaçant par exemple à l'intérieur d'une section
<Location "/server-status">. Les recherches DNS ne
seront alors effectuées que pour les requêtes qui satisfont aux critères.
Voici un exemple qui désactive les recherches DNS sauf pour les fichiers
.html et .cgi :
HostnameLookups off <Files ~ "\.(html|cgi)$"> HostnameLookups on </Files>
Mais même dans ce cas, si vous n'avez besoin de noms DNS que dans
certains CGIs, vous pouvez effectuer l'appel à gethostbyname
dans les CGIs spécifiques qui en ont besoin.
Chaque fois que la ligne Options FollowSymLinks sera
absente, ou que la ligne Options SymLinksIfOwnerMatch sera
présente dans votre espace d'adressage, Apache devra effectuer des
appels système supplémentaires pour vérifier la présence de liens
symboliques. Un appel supplémentaire par élément du chemin du fichier.
Par exemple, si vous avez :
DocumentRoot "/www/htdocs" <Directory "/"> Options SymLinksIfOwnerMatch </Directory>
et si une requête demande l'URI /index.html, Apache
effectuera un appel à lstat(2) pour
/www, /www/htdocs, et
/www/htdocs/index.html. Les résultats de ces appels à
lstat ne sont jamais mis en cache, ils devront donc être
générés à nouveau pour chaque nouvelle requête. Si vous voulez absolument
vérifier la sécurité des liens symboliques, vous pouvez utiliser une
configuration du style :
DocumentRoot "/www/htdocs" <Directory "/"> Options FollowSymLinks </Directory> <Directory "/www/htdocs"> Options -FollowSymLinks +SymLinksIfOwnerMatch </Directory>
Ceci évite au moins les vérifications supplémentaires pour le chemin
défini par DocumentRoot. Notez que
vous devrez ajouter des sections similaires si vous avez des chemins
définis par les directives
Alias ou
RewriteRule en dehors de
la racine de vos documents. Pour améliorer les performances, et supprimer
toute protection des liens symboliques, ajoutez l'option
FollowSymLinks partout, et n'utilisez jamais l'option
SymLinksIfOwnerMatch.
Dans toute partie de votre espace d'adressage où vous autoriserez
la surcharge de la configuration (en général à l'aide de fichiers
.htaccess), Apache va tenter d'ouvrir .htaccess
pour chaque élément du chemin du fichier demandé. Par exemple, si vous
avez :
DocumentRoot "/www/htdocs" <Directory "/"> AllowOverride all </Directory>
et qu'une requête demande l'URI /index.html, Apache
tentera d'ouvrir /.htaccess, /www/.htaccess,
et /www/htdocs/.htaccess. Les solutions sont similaires à
celles évoquées précédemment pour Options FollowSymLinks.
Pour améliorer les performances, utilisez AllowOverride None
pour tous les niveaux de votre espace d'adressage.
Dans la mesure du possible, évitez toute négociation de contenu si vous tenez au moindre gain en performances. En pratique toutefois, les bénéfices de la négociation l'emportent souvent sur la diminution des performances. Il y a cependant un cas dans lequel vous pouvez accélérer le serveur. Au lieu d'utiliser une directive générique comme :
DirectoryIndex index
utilisez une liste explicite d'options :
DirectoryIndex index.cgi index.pl index.shtml index.html
où vous placez le choix courant en première position.
Notez aussi que créer explicitement un fichier de
correspondances de type fournit de meilleures performances
que l'utilisation des MultiViews, car les informations
nécessaires peuvent être simplement obtenues en lisant ce fichier, sans
avoir à parcourir le répertoire à la recherche de types de fichiers.
Par conséquent, si la négociation de contenu est nécessaire pour votre
site, préférez les fichiers de correspondances de type aux
directives Options MultiViews pour mener à bien cette
négociation. Se référer au document sur la
Négociation de contenu pour une
description complète des méthodes de négociation, et les instructions
permettant de créer des fichiers de correspondances de type.
Dans les situations où Apache 2.x doit consulter le contenu d'un
fichier en train d'être servi - par exemple à l'occasion du traitement
d'une inclusion côté serveur - il transfère en général le fichier en
mémoire si le système d'exploitation supporte une forme quelconque
de mmap(2).
Sur certains systèmes, ce transfert en mémoire améliore les performances. Dans certains cas, ce transfert peut toutefois les dégrader et même diminuer la stabilité du démon httpd :
Dans certains systèmes d'exploitation, mmap devient
moins efficace que read(2) quand le nombre de
processeurs augmente. Sur les serveurs multiprocesseurs sous Solaris,
par exemple, Apache 2.x sert parfois les fichiers consultés par le
serveur plus rapidement quand mmap est désactivé.
Si vous transférez en mémoire un fichier localisé dans un système de fichiers monté par NFS, et si un processus sur une autre machine cliente NFS supprime ou tronque le fichier, votre processus peut rencontrer une erreur de bus la prochaine fois qu'il essaiera d'accéder au contenu du fichier en mémoire.
Pour les installations où une de ces situations peut se produire,
vous devez utiliser EnableMMAP off afin de désactiver le
transfert en mémoire des fichiers servis. (Note : il est possible de
passer outre cette directive au niveau de chaque répertoire.)
Dans les cas où Apache peut se permettre d'ignorer le contenu du
fichier à servir - par exemple, lorsqu'il sert un contenu de fichier
statique - il utilise en général le support sendfile du noyau si le
système d'exploitation supporte l'opération sendfile(2).
Sur la plupart des plateformes, l'utilisation de sendfile améliore les performances en éliminant les mécanismes de lecture et envoi séparés. Dans certains cas cependant, l'utilisation de sendfile peut nuire à la stabilité du démon httpd :
Certaines plateformes peuvent présenter un support de sendfile défaillant que la construction du système n'a pas détecté, en particulier si les binaires ont été construits sur une autre machine et transférés sur la machine où le support de sendfile est défaillant.
Dans le cas d'un système de fichiers monté sous NFS, le noyau peut s'avérer incapable de servir les fichiers réseau de manière fiable depuis son propre cache.
Pour les installations où une de ces situations peut se produire,
vous devez utiliser EnableSendfile off afin de désactiver
la mise à disposition de contenus de fichiers par sendfile. (Note : il
est possible de passer outre cette directive au niveau de chaque
répertoire.)
Avant Apache 1.3, les directives
MinSpareServers,
MaxSpareServers, et
StartServers avaient des
effets drastiques sur les performances de référence. En particulier,
Apache avait besoin d'un délai de "montée en puissance" afin d'atteindre
un nombre de processus enfants suffisant pour supporter la charge qui lui
était appliquée. Après le lancement initial des processus enfants par
StartServers, seulement un
processus enfant par seconde était créé afin d'atteindre la valeur de la
directive MinSpareServers. Ainsi,
un serveur accédé par 100 clients simultanés et utilisant la valeur par
défaut de 5 pour la directive
StartServers, nécessitait
environ 95 secondes pour lancer suffisamment de processus enfants
permettant de faire face à la charge. Ceci fonctionne en pratique pour
les serveurs en production, car ils sont rarement redémarrés. Ce n'est
cependant pas le cas pour les tests de référence (benchmarks) où le
serveur ne fonctionne que 10 minutes.
La règle "un processus par seconde" avait été implémentée afin
d'éviter l'enlisement de la machine dans le démarrage de nouveaux
processus enfants. Pendant que la machine est occupée à lancer des
processus enfants, elle ne peut pas traiter les requêtes. Mais cette
règle impactait tellement la perception des performances d'Apache qu'elle
a dû être remplacée. A partir d'Apache 1.3, le code a assoupli la règle
"un processus par seconde". Il va en lancer un, attendre une seconde,
puis en lancer deux, attendre une seconde, puis en lancer quatre et
ainsi de suite jusqu'à lancer 32 processus. Il s'arrêtera lorsque le
nombre de processus aura atteint la valeur définie par la directive
MinSpareServers.
Ceci s'avère suffisamment réactif pour pouvoir en général se passer
de manipuler les valeurs des directives
MinSpareServers,
MaxSpareServers et
StartServers. Lorsque plus de
4 processus enfants sont lancés par seconde, un message est émis vers
le journal des erreurs. Si vous voyez apparaître souvent ce genre de
message, vous devez vous pencher sur ces réglages. Pour vous guider,
utilisez les informations délivrées par le module
mod_status.
À mettre en relation avec la création de processus, leur destruction
est définie par la valeur de la directive
MaxConnectionsPerChild. Sa valeur
par défaut est 0, ce qui signifie qu'il n'y a pas de limite
au nombre de connexions qu'un processus enfant peut traiter. Si votre
configuration actuelle a cette directive réglée à une valeur très basse,
de l'ordre de 30, il est conseillé de l'augmenter de manière
significative. Si vous utilisez SunOs ou une ancienne version de Solaris,
utilisez une valeur de l'ordre de 10000 à cause des fuites
de mémoire.
Lorsqu'ils sont en mode "keep-alive", les processus enfants sont
maintenus et ne font rien sinon attendre la prochaine requête sur la
connexion déjà ouverte. La valeur par défaut de 5 de la
directive KeepAliveTimeout tend à
minimiser cet effet. Il faut trouver le bon compromis entre la bande
passante réseau et les ressources du serveur. En aucun cas vous ne devez
choisir une valeur supérieure à 60 seconds, car
la plupart des bénéfices sont alors perdus.
Apache 2.x supporte les modèles simultanés enfichables, appelés
Modules Multi-Processus (MPMs). Vous devez
choisir un MPM au moment de la construction d'Apache. Certaines
plateformes ont des modules MPM spécifiques :
mpm_netware, mpmt_os2 et
mpm_winnt. Sur les systèmes de type Unix, vous avez le
choix entre un grand nombre de modules MPM. Le choix du MPM peut affecter
la vitesse et l'évolutivité du démon httpd :
worker utilise plusieurs processus
enfants possédant chacun de nombreux threads. Chaque thread gère une
seule connexion à la fois. Worker est en général un bon choix pour les
serveurs présentant un traffic important car il possède une empreinte
mémoire plus petite que le MPM prefork.event utilise
les threads, mais il a été conçu pour traiter davantage de
requêtes simultanément en confiant une partie du travail à des
threads de support, ce qui permet aux threads principaux de
traiter de nouvelles requêtes.prefork utilise plusieurs processus enfants
possédant chacun un seul thread. Chaque processus gère une seule
connexion à la fois. Sur de nombreux systèmes, prefork est comparable
en matière de vitesse à worker, mais il utilise plus de mémoire. De par
sa conception sans thread, prefork présente des avantages par rapport à
worker dans certaines situations : il peut être utilisé avec les
modules tiers qui ne supportent pas le threading, et son débogage est plus
aisé sur les platesformes présentant un support du débogage des threads
rudimentaire.Pour plus d'informations sur ces deux MPMs et les autres, veuillez vous référer à la documentation sur les MPM.
Comme le contrôle de l'utilisation de la mémoire est très important
en matière de performance, il est conseillé d'éliminer les modules que
vous n'utilisez pas vraiment. Si vous avez construit ces modules en
tant que DSOs, leur élimination consiste
simplement à commenter la directive
LoadModule associée à ce
module. Ceci vous permet de vérifier si votre site fonctionne toujours
après la suppression de tel ou tel module.
Par contre, si les modules que vous voulez supprimer sont liés statiquement à votre binaire Apache, vous devrez recompiler ce dernier afin de pouvoir les éliminer.
La question qui découle de ce qui précède est évidemment de
savoir de quels modules vous avez besoin et desquels vous pouvez vous
passer. La réponse sera bien entendu différente d'un site web à
l'autre. Cependant, la liste minimale de modules nécessaire à
la survie de votre site contiendra certainement
mod_mime, mod_dir et
mod_log_config. mod_log_config est bien
entendu optionnel puisque vous pouvez faire fonctionner un site web
en se passant de fichiers journaux ; ceci est cependant
déconseillé.
Certains modules, à l'instar de mod_cache et des
versions de développement récentes du MPM worker, utilisent l'API
atomique d'APR. Cette API propose des opérations atomiques que l'on
peut utiliser pour alléger la synchronisation des threads.
Par défaut, APR implémente ces opérations en utilisant les
mécanismes les plus efficaces disponibles sur chaque plateforme cible
(Système d'exploitation et processeur). De nombreux processeurs modernes,
par exemple, possèdent une instruction qui effectue une opération
atomique de type comparaison et échange ou compare-and-swap (CAS) au
niveau matériel. Sur certaines platesformes cependant, APR utilise par
défaut une implémentation de l'API atomique plus lente, basée sur les
mutex, afin d'assurer la compatibilité avec les anciens modèles de
processeurs qui ne possèdent pas ce genre d'instruction. Si vous
construisez Apache pour une de ces platesformes, et ne prévoyez de
l'exécuter que sur des processeurs récents, vous pouvez sélectionner une
implémentation atomique plus rapide à la compilation en utilisant
l'option --enable-nonportable-atomics du
script configure :
./buildconf
./configure --with-mpm=worker --enable-nonportable-atomics=yes
L'option --enable-nonportable-atomics concerne les
platesformes suivantes :
--enable-nonportable-atomics au script configure, APR
génère un code qui utilise le code opération SPARC v8plus pour des
opérations de compare-and-swap matériel plus rapides. Si vous
utilisez cette option de configure avec Apache, les opérations
atomiques seront plus efficaces (permettant d'alléger la charge du
processeur et un plus haut niveau de simultanéité), mais
l'exécutable produit ne fonctionnera que sur les processeurs
UltraSPARC.
--enable-nonportable-atomics au script configure,
APR générera un code qui utilise un code d'opération du 486
pour des opérations de compare-and-swap matériel plus rapides. Le
code résultant est plus efficace en matière d'opérations atomiques,
mais l'exécutable produit ne fonctionnera que sur des processeurs
486 et supérieurs (et non sur des 386).
Si vous incluez le module mod_status à la
construction d'Apache et ajoutez ExtendedStatus On à sa
configuration, Apache va effectuer pour chaque requête deux appels à
gettimeofday(2) (ou times(2) selon votre
système d'exploitation), et (pour les versions antérieures à 1.3) de
nombreux appels supplémentaires à time(2). Tous ces
appels sont effectués afin que le rapport de statut puisse contenir
des indications temporelles. Pour améliorer les performances, utilisez
ExtendedStatus off (qui est le réglage par défaut).
Cette section n'a pas été totalement mise à jour car elle ne tient pas compte des changements intervenus dans la version 2.x du Serveur HTTP Apache. Certaines informations sont encore pertinentes, il vous est cependant conseillé de les utiliser avec prudence.
Ce qui suit est une brève discussion à propos de l'API des sockets
Unix. Supposons que votre serveur web utilise plusieurs directives
Listen afin d'écouter
plusieurs ports ou de multiples adresses. Afin de tester chaque socket
pour voir s'il a une connexion en attente, Apache utilise
select(2). select(2) indique si un socket a
zéro ou au moins une connexion en attente. Le modèle
d'Apache comporte plusieurs processus enfants, et tous ceux qui sont
inactifs testent la présence de nouvelles connexions au même moment.
Une implémentation rudimentaire de ceci pourrait ressembler à
l'exemple suivant
(ces exemples ne sont pas extraits du code d'Apache, ils ne sont
proposés qu'à des fins pédagogiques) :
for (;;) {
for (;;) {
fd_set accept_fds;
FD_ZERO (&accept_fds);
for (i = first_socket; i <= last_socket; ++i) {
FD_SET (i, &accept_fds);
}
rc = select (last_socket+1, &accept_fds, NULL, NULL, NULL);
if (rc < 1) continue;
new_connection = -1;
for (i = first_socket; i <= last_socket; ++i) {
if (FD_ISSET (i, &accept_fds)) {
new_connection = accept (i, NULL, NULL);
if (new_connection != -1) break;
}
}
if (new_connection != -1) break;
}
process_the(new_connection);
}
Mais cette implémentation rudimentaire présente une sérieuse lacune.
Rappelez-vous que les processus enfants exécutent cette boucle au même
moment ; ils vont ainsi bloquer sur select s'ils se trouvent
entre deux requêtes. Tous ces processus bloqués vont se réactiver et
sortir de select quand une requête va apparaître sur un des
sockets (le nombre de processus enfants qui se réactivent varie en
fonction du système d'exploitation et des réglages de synchronisation).
Ils vont alors tous entrer dans la boucle et tenter un
"accept" de la connexion. Mais seulement un d'entre eux y
parviendra (en supposant qu'il ne reste q'une seule connexion en
attente), les autres vont se bloquer au niveau de accept.
Ceci verrouille vraiment ces processus de telle sorte qu'ils ne peuvent
plus servir de requêtes que par cet unique socket, et il en sera ainsi
jusqu'à ce que suffisamment de nouvelles requêtes apparaissent sur ce
socket pour les réactiver tous. Cette lacune a été documentée pour la
première fois dans
PR#467. Il existe
au moins deux solutions.
La première consiste à rendre les sockets non blocants. Dans ce cas,
accept ne bloquera pas les processus enfants, et ils
pourront continuer à s'exécuter immédiatement. Mais ceci consomme des
ressources processeur. Supposons que vous ayez dix processus enfants
inactifs dans select, et qu'une connexion arrive.
Neuf des dix processus vont se réactiver, tenter un accept
de la connexion, échouer, et boucler dans select, tout en
n'ayant finalement rien accompli. Pendant ce temps, aucun de ces processus
ne traite les requêtes qui arrivent sur d'autres sockets jusqu'à ce
qu'ils retournent dans select. Finalement, cette solution
ne semble pas très efficace, à moins que vous ne disposiez d'autant de
processeurs inactifs (dans un serveur multiprocesseur) que de processus
enfants inactifs, ce qui n'est pas une situation très courante.
Une autre solution, celle qu'utilise Apache, consiste à sérialiser les entrées dans la boucle interne. La boucle ressemble à ceci (les différences sont mises en surbrillance) :
for (;;) {
accept_mutex_on ();
for (;;) {
fd_set accept_fds;
FD_ZERO (&accept_fds);
for (i = first_socket; i <= last_socket; ++i) {
FD_SET (i, &accept_fds);
}
rc = select (last_socket+1, &accept_fds, NULL, NULL, NULL);
if (rc < 1) continue;
new_connection = -1;
for (i = first_socket; i <= last_socket; ++i) {
if (FD_ISSET (i, &accept_fds)) {
new_connection = accept (i, NULL, NULL);
if (new_connection != -1) break;
}
}
if (new_connection != -1) break;
}
accept_mutex_off ();
process the new_connection;
}
Les fonctions
accept_mutex_on et accept_mutex_off
implémentent un sémaphore permettant une exclusion mutuelle. Un seul
processus enfant à la fois peut posséder le mutex. Plusieurs choix se
présentent pour implémenter ces mutex. Ce choix est défini dans
src/conf.h (versions antérieures à 1.3) ou
src/include/ap_config.h (versions 1.3 ou supérieures).
Certaines architectures ne font pas ce choix du mode de verrouillage ;
l'utilisation de directives
Listen multiples sur ces
architectures est donc peu sûr.
La directive Mutex permet
de modifier l'implémentation du mutex mpm-accept à
l'exécution. Des considérations spécifiques aux différentes
implémentations de mutex sont documentées avec cette directive.
Une autre solution qui a été imaginée mais jamais implémentée, consiste à sérialiser partiellement la boucle -- c'est à dire y faire entrer un certain nombre de processus. Ceci ne présenterait un intérêt que sur les machines multiprocesseurs où plusieurs processus enfants peuvent s'exécuter simultanément, et encore, la sérialisation ne tire pas vraiment parti de toute la bande passante. C'est une possibilité d'investigation future, mais demeure de priorité basse car les serveurs web à architecture hautement parallèle ne sont pas la norme.
Pour bien faire, vous devriez faire fonctionner votre serveur sans
directives Listen multiples
si vous visez les performances les plus élevées.
Mais lisez ce qui suit.
Ce qui précède convient pour les serveurs à sockets multiples, mais
qu'en est-il des serveurs à socket unique ? En théorie, ils ne
devraient pas rencontrer les mêmes problèmes car tous les processus
enfants peuvent se bloquer dans accept(2) jusqu'à ce qu'une
connexion arrive, et ils ne sont pas utilisés à ne rien faire. En
pratique, ceci dissimule un même comportement de bouclage
discuté plus haut dans la solution non-blocante. De la manière dont
sont implémentées les piles TCP, le noyau réactive véritablement tous les
processus bloqués dans accept quand une seule connexion
arrive. Un de ces processus prend la connexion en compte et retourne
dans l'espace utilisateur, les autres bouclant dans l'espace du
noyau et se désactivant quand ils s'aperçoivent qu'il n'y a pas de
connexion pour eux. Ce bouclage est invisible depuis le code de l'espace
utilisateur, mais il est quand-même présent. Ceci peut conduire à la
même augmentation de charge à perte que la solution non blocante au cas
des sockets multiples peut induire.
Pour cette raison, il apparaît que de nombreuses architectures se
comportent plus "proprement" si on sérialise même dans le cas d'une socket
unique. Il s'agit en fait du comportement par défaut dans la plupart des
cas. Des expériences poussées sous Linux (noyau 2.0.30 sur un
biprocesseur Pentium pro 166 avec 128 Mo de RAM) ont montré que la
sérialisation d'une socket unique provoque une diminution inférieure à 3%
du nombre de requêtes par secondes par rapport au traitement non
sérialisé. Mais le traitement non sérialisé des sockets uniques induit
un temps de réponse supplémentaire de 100 ms pour chaque requête. Ce
temps de réponse est probablement provoqué par une limitation sur les
lignes à haute charge, et ne constitue un problème que sur les réseaux
locaux. Si vous voulez vous passer de la sérialisation des sockets
uniques, vous pouvez définir
SINGLE_LISTEN_UNSERIALIZED_ACCEPT et les
serveurs à socket unique ne pratiqueront plus du tout la
sérialisation.
Comme discuté dans draft-ietf-http-connection-00.txt section 8, pour implémenter de manière fiable le protocole, un serveur HTTP doit fermer les deux directions d'une communication indépendamment (rappelez-vous qu'une connexion TCP est bidirectionnelle, chaque direction étant indépendante de l'autre).
Quand cette fonctionnalité fut ajoutée à Apache, elle causa une
avalanche de problèmes sur plusieurs versions d'Unix à cause d'une
implémentation à courte vue. La spécification TCP ne précise pas que
l'état FIN_WAIT_2 possède un temps de réponse mais elle ne
l'exclut pas. Sur les systèmes qui n'introduisent pas ce temps de
réponse, Apache 1.2 induit de nombreux blocages définitifs de socket
dans l'état FIN_WAIT_2. On peut eviter ceci dans de nombreux
cas tout simplement en mettant à jour TCP/IP avec le dernier patch mis à
disposition par le fournisseur. Dans les cas où le fournisseur n'a
jamais fourni de patch (par exemple, SunOS4 -- bien que les utilisateurs
possédant une license source puissent le patcher eux-mêmes), nous avons
décidé de désactiver cette fonctionnalité.
Il y a deux méthodes pour arriver à ce résultat. La première est
l'option de socket SO_LINGER. Mais le sort a voulu que cette
solution ne soit jamais implémentée correctement dans la plupart des
piles TCP/IP. Et même dans les rares cas où cette solution a été
implémentée correctement (par exemple Linux 2.0.31), elle se
montre beaucoup plus gourmande (en temps processeur) que la solution
suivante.
Pour la plus grande partie, Apache implémente cette solution à l'aide
d'une fonction appelée lingering_close (définie dans
http_main.c). La fonction ressemble approximativement à
ceci :
void lingering_close (int s)
{
char junk_buffer[2048];
/* shutdown the sending side */
shutdown (s, 1);
signal (SIGALRM, lingering_death);
alarm (30);
for (;;) {
select (s for reading, 2 second timeout);
if (error) break;
if (s is ready for reading) {
if (read (s, junk_buffer, sizeof (junk_buffer)) <= 0) {
break;
}
/* just toss away whatever is here */
}
}
close (s);
}
Ceci ajoute naturellement un peu de charge à la fin d'une connexion,
mais s'avère nécessaire pour une implémentation fiable. Comme HTTP/1.1
est de plus en plus présent et que toutes les connexions sont
persistentes, la charge sera amortie par la multiplicité des requêtes.
Si vous voulez jouer avec le feu en désactivant cette fonctionnalité,
vous pouvez définir NO_LINGCLOSE, mais c'est fortement
déconseillé. En particulier, comme les connexions persistantes en
pipeline de HTTP/1.1 commencent à être utilisées,
lingering_close devient une absolue nécessité (et les
connexions en pipeline sont plus rapides ; vous avez donc tout
intérêt à les supporter).
Les processus parent et enfants d'Apache communiquent entre eux à
l'aide d'un objet appelé "Tableau de bord" (Scoreboard). Idéalement, cet
échange devrait s'effectuer en mémoire partagée. Pour les systèmes
d'exploitation auxquels nous avons eu accès, ou pour lesquels nous avons
obtenu des informations suffisamment détaillées pour effectuer un
portage, cet échange est en général implémenté en utilisant la mémoire
partagée. Pour les autres, on utilise par défaut un fichier d'échange sur
disque. Le fichier d'échange sur disque est non seulement lent, mais
aussi peu fiable (et propose moins de fonctionnalités). Recherchez dans
le fichier src/main/conf.h correspondant à votre
architecture soit USE_MMAP_SCOREBOARD, soit
USE_SHMGET_SCOREBOARD. La définition de l'un des deux
(ainsi que leurs compagnons respectifs HAVE_MMAP et
HAVE_SHMGET), active le code fourni pour la mémoire
partagée. Si votre système propose une autre solution pour la gestion de
la mémoire partagée, éditez le fichier src/main/http_main.c
et ajoutez la portion de code nécessaire pour pouvoir l'utiliser dans
Apache (Merci de nous envoyer aussi le patch correspondant).
Si vous n'avez pas l'intention d'utiliser les modules chargés
dynamiquement (ce qui est probablement le cas si vous êtes en train de
lire ce document afin de personnaliser votre serveur en recherchant le
moindre des gains en performances), vous pouvez ajouter la définition
-DDYNAMIC_MODULE_LIMIT=0 à la construction de votre serveur.
Ceci aura pour effet de libérer la mémoire RAM allouée pour le
chargement dynamique des modules.
Voici la trace d'un appel système d'Apache 2.0.38 avec le MPM worker sous Solaris 8. Cette trace a été collectée à l'aide de la commande :
truss -l -p httpd_child_pid.
L'option -l demande à truss de tracer l'ID du LWP
(lightweight process--la version de Solaris des threads niveau noyau) qui
invoque chaque appel système.
Les autres systèmes peuvent proposer des utilitaires de traçage
des appels système différents comme strace,
ktrace, ou par. Ils produisent cependant tous une
trace similaire.
Dans cette trace, un client a demandé un fichier statique de 10 ko au démon httpd. Le traçage des requêtes pour des contenus non statiques ou comportant une négociation de contenu a une présentation différente (et même assez laide dans certains cas).
/67: accept(3, 0x00200BEC, 0x00200C0C, 1) (sleeping...) /67: accept(3, 0x00200BEC, 0x00200C0C, 1) = 9
Dans cette trace, le thread à l'écoute s'exécute à l'intérieur de LWP #67.
accept(2). Sur
cette plateforme spécifique, le MPM worker utilise un accept non sérialisé
par défaut sauf s'il est en écoute sur des ports multiples./65: lwp_park(0x00000000, 0) = 0 /67: lwp_unpark(65, 1) = 0
Après avoir accepté la connexion, le thread à l'écoute réactive un thread du worker pour effectuer le traitement de la requête. Dans cette trace, le thread du worker qui traite la requête est associé à LWP #65.
/65: getsockname(9, 0x00200BA4, 0x00200BC4, 1) = 0
Afin de pouvoir implémenter les hôtes virtuels, Apache doit connaître
l'adresse du socket local utilisé pour accepter la connexion. On pourrait
supprimer cet appel dans de nombreuses situations (par exemple dans le cas
où il n'y a pas d'hôte virtuel ou dans le cas où les directives
Listen contiennent des adresses
sans caractères de substitution). Mais aucun effort n'a été accompli à ce
jour pour effectuer ces optimisations.
/65: brk(0x002170E8) = 0 /65: brk(0x002190E8) = 0
L'appel brk(2) alloue de la mémoire dans le tas. Ceci est
rarement visible dans une trace d'appel système, car le démon httpd
utilise des allocateurs mémoire de son cru (apr_pool et
apr_bucket_alloc) pour la plupart des traitements de requêtes.
Dans cette trace, le démon httpd vient juste de démarrer, et il doit
appeler malloc(3) pour réserver les blocs de mémoire
nécessaires à la création de ses propres allocateurs de mémoire.
/65: fcntl(9, F_GETFL, 0x00000000) = 2 /65: fstat64(9, 0xFAF7B818) = 0 /65: getsockopt(9, 65535, 8192, 0xFAF7B918, 0xFAF7B910, 2190656) = 0 /65: fstat64(9, 0xFAF7B818) = 0 /65: getsockopt(9, 65535, 8192, 0xFAF7B918, 0xFAF7B914, 2190656) = 0 /65: setsockopt(9, 65535, 8192, 0xFAF7B918, 4, 2190656) = 0 /65: fcntl(9, F_SETFL, 0x00000082) = 0
Ensuite, le thread de worker passe la connexion du client (descripteur
de fichier 9) en mode non blocant. Les appels setsockopt(2)
et getsockopt(2) constituent un effet de bord de la manière
dont la libc de Solaris utilise fcntl(2) pour les sockets.
/65: read(9, " G E T / 1 0 k . h t m".., 8000) = 97
Le thread de worker lit la requête du client.
/65: stat("/var/httpd/apache/httpd-8999/htdocs/10k.html", 0xFAF7B978) = 0
/65: open("/var/httpd/apache/httpd-8999/htdocs/10k.html", O_RDONLY) = 10Ce démon httpd a été configuré avec les options
Options FollowSymLinks et AllowOverride None. Il
n'a donc ni besoin d'appeler lstat(2) pour chaque répertoire
du chemin du fichier demandé, ni besoin de vérifier la présence de fichiers
.htaccess. Il appelle simplement stat(2) pour
vérifier d'une part que le fichier existe, et d'autre part que c'est un
fichier régulier, et non un répertoire.
/65: sendfilev(0, 9, 0x00200F90, 2, 0xFAF7B53C) = 10269
Dans cet exemple, le démon httpd peut envoyer l'en-tête de la réponse
HTTP et le fichier demandé à l'aide d'un seul appel système
sendfilev(2). La sémantique de sendfile varie en fonction des
systèmes d'exploitation. Sur certains autres systèmes, il faut faire un
appel à write(2) ou writev(2) pour envoyer les
en-têtes avant d'appeler sendfile(2).
/65: write(4, " 1 2 7 . 0 . 0 . 1 - ".., 78) = 78
Cet appel à write(2) enregistre la requête dans le journal
des accès. Notez qu'une des choses manquant à cette trace est un appel à
time(2). A la différence d'Apache 1.3, Apache 2.x utilise
gettimeofday(3) pour consulter l'heure. Sur certains systèmes
d'exploitation, comme Linux ou Solaris, gettimeofday est
implémenté de manière optimisée de telle sorte qu'il consomme moins de
ressources qu'un appel système habituel.
/65: shutdown(9, 1, 1) = 0 /65: poll(0xFAF7B980, 1, 2000) = 1 /65: read(9, 0xFAF7BC20, 512) = 0 /65: close(9) = 0
Le thread de worker effectue une fermeture "en prenant son temps" (lingering close) de la connexion.
/65: close(10) = 0 /65: lwp_park(0x00000000, 0) (sleeping...)
Enfin, le thread de worker ferme le fichier qu'il vient de délivrer et se bloque jusqu'à ce que le thread en écoute lui assigne une autre connexion.
/67: accept(3, 0x001FEB74, 0x001FEB94, 1) (sleeping...)
Pendant ce temps, le thread à l'écoute peut accepter une autre connexion
à partir du moment où il a assigné la connexion présente à un thread de
worker (selon une certaine logique de contrôle de flux dans le MPM worker
qui impose des limites au thread à l'écoute si tous les threads de worker
sont occupés). Bien que cela n'apparaisse pas dans cette trace,
l'accept(2) suivant peut (et le fait en général, en situation
de charge élevée) s'exécuter en parallèle avec le traitement de la
connexion qui vient d'être acceptée par le thread de worker.
Apache HTTP Sunucusu Sürüm 2.4
Aşağıda listelenen belgeler de Apache HTTP sunucusu geliştirme projesi kapsamındadır.
Aşağıdaki belgeler, Apache HTTP Sunucusunun 2.1 sürümünde yapılmış değişikliklere göre tam olarak güncellenmemiştir. Hala güncel kalmış bazı bilgiler olabilir, fakat siz yine de bu belgeleri kullanırken dikkatli olun.
Yüksek başarım elde etmek için Apache yapılandırmasında (çalışma anında ve derleme sırasında) yapılacaklar ile ilgili bazı bilgiler yanında Apache’de bazı şeylerin (bir şeyleri hızlandıran ve yavaşlatan şeylerin) yapılma ve yapılmama sebepleri açıklanmıştır.
Apache HTTP sitenizi güvenli kılmak için yapılacaklar ve yapılmayacaklar.
Bu belge Apache’nin uyacağı standartların bir çoğuna atıfta bulunmak amacıyla hazırlanmıştır.
Belgede, kimlik doğrulama amacıyla Apache tarafından desteklenen çeşitli şifreleme tekniklerinden bahsedilmiştir.
Apache HTTP Server Version 2.4
Բ ġ ǥ Ѵ.
Ʒ Ͽ ڷᵵ Ѵ:
ʴ.
ϰ ϴ ⺻ ġ IETF ǰ(recommendation) :
ؽƮ ũ (Hypertext Markup Language, HTML) Ͽ ġ IETF ǰ W3C ǰ :
Serveur HTTP Apache Version 2.4
Notes à propos des formats de chiffrement des mots de passe générés et compris par Apache.
Voici les cinq formats de mots de passe qu'Apache reconnaît pour l'authentification de base. Notez que tous les formats ne sont pas supportés par toutes les plates-formes :
crypt(3) avec une source d'entropie sur 32 bits
(seuls 12 bits sont utilisés), et seulement les 8 premiers
caractères du mot de passe. Non sûr.
$ htpasswd -nbB monNom monMot-de-passe
monNom:$2y$05$c4WoMPo3SXsafkva.HHa6uXQZWr7oboPiC2bT/r7q1BB8I2s0BRqC
$ htpasswd -nbm monNom monMot-de-passe
monNom:$apr1$r31.....$HqJZimcKQFAMYayBlzkrA/
$ htpasswd -nbs monNom monMot-de-passe
monNom:{SHA}VBPuJHI7uixaa6LQGWx4s+5GKNE=
$ htpasswd -nbd monNom monMot-de-passe
monNom:rqXexS6ZhobKA
OpenSSL connaît l'algorithme MD5 spécifique à Apache.
$ openssl passwd -apr1 monMot-de-passe
$apr1$qHDFfhPC$nITSVHgYbDAK1Y0acGRnY0
openssl passwd -crypt monMot-de-passe
qQ5vTYO3c8dsU
La source d'entropie pour un mot de passe CRYPT est constituée
des deux premiers caractères (convertis en valeur binaire). Pour
valider monMot-de-passe par rapport à
rqXexS6ZhobKA
$ openssl passwd -crypt -salt rq monMot-de-passe
Warning: truncating password to 8 characters
rqXexS6ZhobKA
Notez que spécifier monMot-d au lieu de
monMot-de-passe produira le même résultat car seuls
les 8 premiers caractères des mots de passe CRYPT sont pris en
compte.
La source d'entropie pour un mot de passe MD5 se situe entre
$apr1$ et le caractère $ suivant (sous
la forme d'une valeur binaire codée en Base64 - au maximum 8
caractères). Pour valider monMot-de-passe par rapport
à $apr1$r31.....$HqJZimcKQFAMYayBlzkrA/
$ openssl passwd -apr1 -salt r31..... monMot-de-passe
$apr1$r31.....$HqJZimcKQFAMYayBlzkrA/
La variante SHA1 constitue probablement le format le mieux approprié pour l'authentification DBD. Comme les fonctions SHA1 et Base64 sont en général disponibles, d'autres logiciels peuvent renseigner une base de données avec des mots de passe chiffrés utilisables par l'authentification basique d'Apache.
Pour créer des mots de passe au format SHA1 pour l'authentification de base d'Apache dans divers langages :
'{SHA}' . base64_encode(sha1($password, TRUE))
"{SHA}" + new sun.misc.BASE64Encoder().encode(java.security.MessageDigest.getInstance("SHA1").digest(password.getBytes()))
"{SHA}" & ToBase64(BinaryDecode(Hash(password, "SHA1"), "Hex"))
require 'digest/sha1'
require 'base64'
'{SHA}' + Base64.encode64(Digest::SHA1.digest(password))
Utilisez la fonction APR : apr_sha1_base64
import base64
import hashlib
"{SHA}" + format(base64.b64encode(hashlib.sha1(password).digest()))
'{SHA}'||encode(digest(password,'sha1'),'base64')
Apache ne reconnaît qu'un format pour les mots de passe
d'authentification à base de condensés - le condensé MD5 de la
chaîne utilisateur:domaine-de-protection:mot-de-passe
sous la forme d'une chaîne de 32 caractères au format hexadécimal.
domaine-de-protection est l'identifiant du domaine de
protection de l'autorisation passé en argument à la directive
AuthName dans
httpd.conf.
Comme la fonction MD5 est en général disponible, d'autres logiciels peuvent renseigner une base de données avec des mots de passe chiffrés utilisables par l'authentification à base de condensés d'Apache.
Pour créer des mots de passe pour l'authentification à base de condensés d'Apache dans divers langages :
md5($user . ':' . $realm . ':' .$password)
byte b[] = java.security.MessageDigest.getInstance("MD5").digest( (user + ":" + realm + ":" + password ).getBytes());
java.math.BigInteger bi = new java.math.BigInteger(1, b);
String s = bi.toString(16);
while (s.length() < 32)
s = "0" + s;
// La chaîne s contient le mot de passe chiffré
LCase(Hash( (user & ":" & realm & ":" & password) , "MD5"))
require 'digest/md5'
Digest::MD5.hexdigest(user + ':' + realm + ':' + password)
encode(digest( user || ':' || realm || ':' || password , 'md5'), 'hex')
Apache HTTP Sunucusu Sürüm 2.4
Apache 2.x, esneklik, taşınabilirlik ve başarım arasında bir denge sağlamak üzere tasarlanmış genel amaçlı bir HTTP sunucusudur. Başka sunucularla kıyaslama denemelerinde öne geçmek üzere tasarlanmamış olsa da Apache 2.x gerçek yaşamda karşılaşılan pek çok durumda oldukça yüksek bir başarıma ulaşacak yetenektedir.
Apache 1.3 ile karşılaştırıldığında 2.x sürümleri toplam veri hızını ve ölçeklenebilirliği arttırmak için pek çok en iyileme seçeneği içerir. Bu iyileştirmelerin pek çoğu zaten öntanımlı olarak etkin olmakla birlikte derleme ve kullanım sırasında başarımı önemli ölçüde etkileyebilen yapılandırma seçenekleri de mevcuttur. Bu belgede, bir Apache 2.x kurulumunda sunucu yöneticisinin sunucunun başarımını arttırmak amacıyla yapılandırma sırasında neler yapabileceğinden bahsedilmiştir. Bu yapılandırma seçeneklerinden bazıları, httpd’nin donanımın ve işletim sisteminin olanaklarından daha iyi yararlanabilmesini sağlarken bir kısmı da daha hızlı bir sunum için yöneticinin işlevsellikten ödün verebilmesini olanaklı kılar.
Donanım ve İşletim Sistemi ile İlgili Konular Çalışma Anı Yapılandırması ile İlgili Konular Derleme Sırasında Yapılandırma ile İlgili Konular Ek: Bir çağrı izlemesinin ayrıntılı çözümlemesiHTTP sunucusunun başarımını etkileyen en önemli donanım bellektir
(RAM). Bir HTTP sunucusu asla takaslama yapmamalıdır. Çünkü takaslama,
kullanıcının "yeterince hız" umduğu noktada sunumun gecikmesine sebep
olur. Böyle bir durumda kullanıcılar yüklemeyi durdurup tekrar
başlatma eğilimindedirler; sonuçta yük daha da artar. MaxRequestWorkers yönergesinin değerini
değiştirerek takaslamaya sebep olabilecek kadar çok çocuk süreç
oluşturulmasını engelleyebilirsiniz ve böyle bir durumda bunu mutlaka
yapmalısınız. Bunun için yapacağınız işlem basittir: top
benzeri bir araç üzerinden çalışan süreçlerinizin bir listesini alıp
Apache süreçlerinizin ortalama büyüklüğünü saptayıp, mevcut bellekten
bir kısmını diğer süreçler için ayırdıktan sonra kalan miktarı bu
değere bölerseniz yönergeye atayacağınız değeri bulmuş olursunuz.
Donanımın diğer unsurları için kararı siz verin: Daha hızlı işlemci, daha hızlı ağ kartı, daha hızlı disk; daha hızlının ne kadar hızlı olacağını deneyimlerinize bağlı olarak tamamen sizin ihtiyaçlarınız belirler.
İşletim sistemi seçimi büyük oranda yerel ilgi konusudur. Fakat yine de, genelde yararlılığı kanıtlanmış bazı kurallar bu seçimde size yardımcı olabilir:
Seçtiğiniz işletim sisteminin (çekirdeğin) en son kararlı sürümünü çalıştırın. Bir çok işletim sistemi, son yıllarda TCP yığıtları ve evre kütüphaneleri ile ilgili belirgin iyileştirmeler yapmışlar ve yapmaktadırlar.
İşletim sisteminiz sendfile(2) sistem çağrısını
destekliyorsa bunun etkinleştirilebildiği sürümün kurulu olması
önemlidir. (Örneğin, Linux için bu, Linux 2.4 ve sonraki sürümler
anlamına gelirken, Solaris için Solaris 8’den önceki sürümlerin
yamanması gerektirdiği anlamına gelmektedir.)
sendfile işlevinin desteklendiği sistemlerde Apache 2
duruk içeriği daha hızlı teslim etmek ve işlemci kullanımını
düşürmek amacıyla bu işlevselliği kullanacaktır.
| İlgili Modüller | İlgili Yönergeler |
|---|---|
HostnameLookups ve DNS ile ilgili diğer konularApache 1.3 öncesinde, HostnameLookups yönergesinin öntanımlı değeri
On idi. İstek yerine getirilmeden önce bir DNS sorgusu
yapılmasını gerektirmesi sebebiyle bu ayarlama her istekte bir
miktar gecikmeye sebep olurdu. Apache 1.3’ten itibaren yönergenin
öntanımlı değeri Off yapılmıştır. Eğer günlük
dosyalarınızda konak isimlerinin bulunmasını isterseniz, Apache ile
birlikte gelen logresolve programını
kullanabileceğiniz gibi günlük raporlarını çözümleyen Apache ile
gelmeyen programlardan herhangi birini de kullanabilirsiniz.
Günlük dosyaları üzerindeki bu işlemi sunucu makinesi dışında günlük dosyasının bir kopyası üzerinde yapmanızı öneririz. Aksi takdirde sunucunuzun başarımı önemli ölçüde etkilenebilir.
Allow veya
Deny
yönergelerinde IP adresi yerine bir konak veya alan ismi
belirtirseniz, iki DNS sorguluk bir bedel ödersiniz (biri normal,
diğeri IP taklidine karşı ters DNS sorgusu). Başarımı en iyilemek
için bu yönergelerde mümkün olduğunca isim yerine IP adreslerini
kullanınız.
HostnameLookups
yönergelerinin <Location "/server-status"> gibi
bölüm yönergelerinin içinde de yer alabileceğini unutmayın. Bu gibi
durumlarda DNS sorguları sadece istek kuralla eşleştiği takdirde
yapılacaktır. Aşağıdaki örnekte .html ve
.cgi dosyalarına yapılan istekler hariç DNS sorguları
iptal edilmektedir:
HostnameLookups off <Files ~ "\.(html|cgi)$"> HostnameLookups on </Files>
Yine de bazı CGI’lerin DNS isimlerine ihtiyacı olursa bu CGI’lerin
bu ihtiyaçlarına yönelik olarak gethostbyname çağrıları
yapabileceğini gözardı etmeyiniz.
FollowSymLinks ve
SymLinksIfOwnerMatchURL uzayınızda geçerli olmak üzere bir Options
FollowSymLinks yoksa veya Options
SymLinksIfOwnerMatch yönergeleri varsa, Apache her sembolik
bağın üzerinde bazı sınamalar yapmak için ek bir sistem çağrısından
başka istenen her dosya için de ayrı bir çağrı yapacaktır.
DocumentRoot "/siteler/htdocs" <Directory /> Options SymLinksIfOwnerMatch </Directory>
Bu durumda /index.html için bir istek yapıldığında
Apache, /siteler, /siteler/htdocs ve
/siteler/htdocs/index.html üzerinde
lstat(2) çağrıları yapacaktır. lstat
sonuçları önbelleğe kaydedilmediğinden bu işlem her istekte
yinelenecektir. Amacınız gerçekten sembolik bağları güvenlik
açısından sınamaksa bunu şöyle yapabilirsiniz:
DocumentRoot "/siteler/htdocs" <Directory "/"> Options FollowSymLinks </Directory> <Directory "/siteler/htdocs"> Options -FollowSymLinks +SymLinksIfOwnerMatch </Directory>
Böylece DocumentRoot altındaki
dosyalar için fazladan bir çağrı yapılmasını engellemiş olursunuz.
Eğer bazı bölümlerde Alias, RewriteRule gibi yönergeler üzerinden belge kök
dizininizin dışında kalan dosya yollarına sahipseniz benzer
işlemleri onlar için de yapmalısınız. Sembolik bağ koruması yapmamak
suretiyle başarımı arttırmak isterseniz, FollowSymLinks
seçeneğini her yerde etkin kılın ve
SymLinksIfOwnerMatch seçeneğini asla
etkinleştirmeyin.
AllowOverrideGenellikle .htaccess dosyaları üzerinden yapıldığı
gibi URL uzayınızda geçersizleştirmelere izin veriyorsanız, Apache
her dosya bileşeni için bu .htaccess dosyalarını açmaya
çalışacaktır.
DocumentRoot "/siteler/htdocs" <Directory "/"> AllowOverride all </Directory>
Bu durumda /index.html sayfasına yapılan bir istek için
Apache, /.htaccess, /siteler/.htaccess ve
/siteler/htdocs/.htaccess dosyalarını açmaya
çalışacaktır. Çözüm Options FollowSymLinks durumunun
benzeridir; başarımı arttırmak için dosya sisteminizin her yerinde
AllowOverride None olsun.
Başarımı son kırıntısına kadar arttırmak istiyorsanız, mümkünse içerik dili uzlaşımı da yapmayın. Dil uzlaşımından yararlanmak isterken büyük başarım kayıplarına uğrayabilirsiniz. Böyle bir durumda sunucunun başarımını arttırmanın tek bir yolu vardır.
DirectoryIndex index
Yukarıdaki gibi bir dosya ismi kalıbı kullanmak yerine, aşağıdaki gibi seçenekleri tam bir liste halinde belirtin:
DirectoryIndex index.cgi index.pl index.shtml index.html
Buradaki sıralama öncelik sırasını belirler; yani, öncelikli olmasını istediğiniz seçeneği listenin başına yazmalısınız.
İstenen dosya için MultiViews kullanarak dizini
taratmak yerine, gerekli bilgiyi tek bir dosyadan okutmak suretiyle
başarımı arttırabilirsiniz. Bu amaçla türeşlem
(type-map) dosyaları kullanmanız yeterli olacaktır.
Sitenizde içerik dili uzlaşımına gerek varsa, bunu Options
MultiViews yönergesi üzerinden değil, türeşlem dosyaları
kullanarak yapmayı deneyin. İçerik dili uzlaşımı ve türeşlem
dosyalarının oluşturulması hakkında daha ayrıntılı bilgi edinmek
için İçerik Uzlaşımı
belgesine bakınız.
Apache’nin SSI sayfalarında olduğu gibi teslim edilecek dosyanın
içeriğine bakma gereği duyduğu durumlarda, eğer işletim sistemi
mmap(2) ve benzerlerini destekliyorsa çekirdek normal
olarak dosyayı belleğe kopyalayacaktır.
Bazı platformlarda bu belleğe eşleme işlemi başarımı arttırsa da başarımın veya httpd kararlılığının zora girdiği durumlar olabilmektedir:
Bazı işletim sistemlerinde işlemci sayısı artışına bağlı
olarak, mmap işlevi read(2) kadar iyi
ölçeklenmemiştir. Örneğin, çok işlemcili Solaris sunucularda
mmap iptal edildiği takdirde içeriği sunucu
tarafından işlenen dosyalar üzerinde bazen daha hızlı işlem
yapılabilmektedir.
Belleğe kopyalanacak dosya NFS üzerinden bağlanan bir dosya sistemindeyse ve dosya başka bir NFS istemcisi makine tarafından silinmiş veya dosyanın boyutu değiştirilmişse sunucunuz dosyaya tekrar erişmeye çalıştığında bir hata alabilecektir.
Böyle durumların olasılık dahilinde olduğu kurulumlarda içeriği
sunucu tarafından işlenecek dosyaların belleğe kopyalanmaması için
yapılandırmanıza EnableMMAP off satırını ekleyiniz.
(Dikkat: Bu yönerge dizin seviyesinde geçersizleştirilebilen
yönergelerdendir.)
sendfileApache’nin duruk dosyalarda olduğu gibi teslim edilecek dosyanın
içeriğine bakmadığı durumlarda, eğer işletim sistemi
sendfile(2) desteğine sahipse çekirdek normal olarak bu
desteği kullanacaktır.
Bazı platformlarda sendfile kullanımı, okuma ve yazma
işlemlerinin ayrı ayrı yapılmamasını sağlasa da
sendfile kullanımının httpd kararlılığını bozduğu bazı
durumlar sözkonusudur:
Bazı platformlar derleme sisteminin saptayamadığı bozuk bir
sendfile desteğine sahip olabilir. Özellikle
derleme işleminin başka bir platformda yapılıp
sendfile desteği bozuk bir makineye kurulum
yapıldığı durumlarda bu desteğin bozuk olduğu
saptanamayacaktır.
Çekirdek, NFS üzerinden erişilen ağ dosyalarını kendi önbelleği üzerinden gerektiği gibi sunamayabilir.
Böyle durumların olasılık dahilinde olduğu kurulumlarda içeriğin
sendfile desteğiyle teslim edilmemesi için
yapılandırmanıza EnableSendfile off satırını ekleyiniz.
(Dikkat: Bu yönerge dizin seviyesinde geçersizleştirilebilen
yönergelerdendir.)
Apache 1.3 öncesinde MinSpareServers, MaxSpareServers ve StartServers ayarları, başka sunucularla kıyaslama
denemelerinde olağanüstü kötü sonuçlar alınmasına sebep olmaktaydı.
Özellikle uygulanan yükü karşılamaya yetecek sayıda çocuk süreç
oluşturulması aşamasında Apache’nin elde ettiği ivme bunlardan
biriydi. Başlangıçta StartServers yönergesiyle belli sayıda süreç
oluşturulduktan sonra her saniyede bir tane olmak üzere MinSpareServers sayıda çocuk süreç
oluşturulmaktaydı. Örneğin, aynı anda 100 isteğe yanıt vermek için
StartServers
yönergesinin öntanımlı değeri olarak başta 5 süreç
oluşturulduğundan kalan süreçler için 95 saniye geçmesi gerekirdi.
Sık sık yeniden başlatılmadıklarından dolayı gerçek hayatta
sunucuların başına gelen de buydu. Başka sunucularla kıyaslama
denemelerinde ise işlem sadece on dakika sürmekte ve içler acısı
sonuçlar alınmaktaydı.
Saniyede bir kuralı, sunucunun yeni çocukları oluşturması sırasında
sistemin aşırı meşgul duruma düşmemesi için alınmış bir önlemdi.
Makine çocuk süreç oluşturmakla meşgul edildiği sürece isteklere
yanıt veremeyecektir. Böylesi bir durum Apache’nin başarımını
kötüleştirmekten başka işe yaramayacaktır. Apache 1.3’te saniyede
bir kuralı biraz esnetildi. Yeni gerçeklenimde artık bir süreç
oluşturduktan bir saniye sonra iki süreç, bir saniye sonra dört
süreç oluşturulmakta ve işlem, saniyede 32 çocuk süreç oluşturulur
duruma gelene kadar böyle ivmelenmektedir. Çocuk süreç oluşturma
işlemi MinSpareServers
değerine ulaşılınca durmaktadır.
Bu, MinSpareServers,
MaxSpareServers ve
StartServers ayarlarıyla
oynamayı neredeyse gereksiz kılacak kadar iyi sonuçlar verecek gibi
görünmektedir. Saniyede 4 çocuktan fazlası oluşturulmaya
başlandığında hata günlüğüne bazı iletiler düşmeye başlar. Bu
iletilerin sayısı çok artarsa bu ayarlarla oynama vakti gelmiş
demektir. Bunun için mod_status çıktısını bir
kılavuz olarak kullanabilirsiniz.
Süreç oluşturmayla ilgili olarak süreç ölümü MaxConnectionsPerChild değeri ile
sağlanır. Bu değer öntanımlı olarak 0 olup, çocuk süreç
başına istek sayısının sınırsız olduğu anlamına gelir. Eğer
yapılandırmanızda bu değeri 30 gibi çok düşük bir
değere ayarlarsanız bunu hemen kaldırmak zorunda kalabilirsiniz.
Sunucunuzu SunOS veya Solaris’in eski bir sürümü üzerinde
çalıştırıyorsanız bellek kaçaklarına sebep olmamak için bu değeri
10000 ile sınırlayınız.
Kalıcı bağlantı özelliğini kullanıyorsanız, çocuk süreçler zaten
açık bağlantılardan istek beklemekte olacaklardır. KeepAliveTimeout yönergesinin öntanımlı
değeri 5 saniye olup bu etkiyi en aza indirmeye yönelik
süredir. Burada ağ band genişliği ile sunucu kaynaklarının kullanımı
arasında bir seçim yapmak söz konusudur. Hiçbir şey umurunuzda
değilse
çoğu ayrıcalığın yitirilmesi pahasına bu değeri rahatça
60 saniyenin üzerine çıkarabilirsiniz.
Apache 2.x, Çok Süreçlilik Modülleri
(MPM) adı verilen eklemlenebilir çok görevlilik modellerini
destekler. Apache’yi derlerken bu MPM’lerden birini seçmeniz
gerekir. MPM’lerden bazıları platformlara özeldir:
mpm_netware, mpmt_os2 ve
mpm_winnt. Unix
benzeri sistemler için ise seçebileceğiniz modül sayısı birden
fazladır. MPM seçiminin httpd’nin hızında ve ölçeklenebilirliğinde
bazı etkileri olabilir:
worker modülü her biri çok evreli çok sayıda
çocuk süreç kullanımını destekler. Her evre aynı anda tek bir
bağlantıya hizmet sunar. Aynı hizmeti daha az bellek harcayarak
vermesi nedeniyle yüksek trafiğe sahip sunucularda
prefork modülüne göre daha iyi bir seçimdir.event modülü worker modülü gibi
çok evreli bir modüldür, fakat aunı anda dahafazla isteğe yanıt
verecek şekilde tasarlanmıştır. Bunu, evreleri destekleyen bazı
işlemleri yapmamak suretiyle yeni isteklerle çalışacak ana evreleri
serbestleştirerek sağlar.prefork modülü her biri tek bir evreye sahip
çok sayıda çocuk süreç kullanımını destekler. Her süreç aynı anda
tek bir bağlantıya hizmet sunar. Çoğu sistemde daha hızlı olması
nedeniyle worker modülüne göre daha iyi bir seçim
olarak görünürse de bunu daha fazla bellek kullanarak sağlar.
prefork modülünün evresiz tasarımının
worker modülüne göre bazı yararlı tarafları
vardır: Çok evreli sistemlerde güvenilir olmayan üçüncü parti
modülleri kullanabilir ve evrelerde hata ayıklamanın yetersiz
kaldığı platformlarda hatalarını ayıklamak daha kolaydır.Bu modüller ve diğerleri hakkında daha ayrıntılı bilgi edinmek için Çok Süreçlilik Modülleri belgesine bakınız.
Bellek kullanımı başarım konusunda önemli olduğundan gerçekte
kullanmadığınız modülleri elemeye çalışmalısınız. Modülleri birer DSO olarak derlediyseniz LoadModule yönergesinin bulunduğu satırı
açıklama haline getirmeniz modülden kurtulmanız için yeterli
olacaktır. Modülleri bu şekilde kaldırarak onların yokluğunda
sitenizin hala işlevlerini yerine getirdiğini görme şansına da
kavuşmuş olursunuz.
Ancak, eğer modülleri Apache çalıştırılabilirinin içine gömmüşseniz istenmeyen modülleri kaldırmak için Apache'yi yeniden derlemeniz gerekir.
Bu noktada bir soru akla gelebilir: Hangi modüller gerekli,
hangileri değil? Bu sorunun yanıtı şüphesiz siteden siteye değişir.
Ancak, olmazsa olmaz moüller olarak mod_mime,
mod_dir ve mod_log_config
modüllerini sayabiliriz. Bunlardan mod_log_config
olmadan da bir sitenin çalışabileceğinden hareketle bu modülün
varlığı isteğe bağlı olsa da bu modülü kaldırmanızı önermiyoruz.
Worker MPM'nin en son geliştirme sürümleri ve
mod_cache gibi bazı modüller APR'nin atomik API'sini
kullanırlar. Bu API, düşük ayarlı evre eşzamanlamasında atomik
işlemler yapar.
Öntanımlı olarak, APR bu işlemleri hedef işletim sistemi/işlemci
platformunda kullanılabilecek en verimli mekanizmayı kullanarak
gerçekleştirir. Günümüz işlemcilerinin çoğu, örneğin, bir atomik
karşılaştırma ve takas (CAS) işlemini donanımda gerçekleştirmektedir.
Bazı platformlarda APR'nin atomik işlemler için öntanımlı olarak daha
yavaş olan mutekslere dayalı gerçeklenimi kullanmasının sebebi eski
işlemcilerde bu tür makine kodlarının yokluğudur. Apache'yi bu tür
platformalarda günümüz işlemcileriyde çalıştırmayı düşünüyorsanız
Apache'yi derlemek için yapılandırırken en hızlı atomik işlemin
seçilebilmesi için --enable-nonportable-atomics
seçeneğini kullanın:
./buildconf
./configure --with-mpm=worker --enable-nonportable-atomics=yes
--enable-nonportable-atomics seçeneği şu platformlar
için uygundur:
--enable-nonportable-atomics yapılandırmasını
kullanırsanız, donanım üzerinde hızlı karşılaştırma ve takas
için uygun SPARC v8plus kodunu kullanacak şekilde kod üretilir.
Apache'yi bu seçenekle yapılandırırsanız atomik işlemler daha
verimli olacak fakat derlenen Apache çalıştırılabiliri sadece
UltraSPARC kırmığı üzerinde çalışacaktır.
--enable-nonportable-atomics yapılandırmasını
kullanırsanız, donanım üzerinde hızlı karşılaştırma ve takas
için uygun 486 kodunu kullanacak şekilde kod üretilir. Apache'yi
bu seçenekle yapılandırırsanız atomik işlemler daha verimli
olacak fakat derlenen Apache çalıştırılabiliri (386 üzerinde
değil) sadece 486 ve sonrası kırmıklarda çalışacaktır.
mod_status ve ExtendedStatus On
mod_status modülünü derlemiş ve Apache'yi
yapılandırır ve çalıştırırken ExtendedStatus On satırını
da kullanmışsanız Apache her istek üzerinde
gettimeofday(2) (veya işletim sistemine bağlı olarak
time(2)) çağrısından başka (1.3 öncesinde) fazladan
defalarca time(2) çağrıları yapacaktır. Bu çağrılarla
durum raporununun zamanlama bilgilerini içermesi sağlanır. Başarımı
arttırmak için ExtendedStatus off yapın (zaten öntanımlı
böyledir).
accept dizgilemesi ve çok soketli işlemBu bölüm, Apache HTTP sunucusunun 2.x sürümlerinde yapılan değişikliklere göre tamamen güncellenmemiştir. Bazı bilgiler hala geçerliyse de lütfen dikkatli kullanınız.
Burada Unix soket arayüzü gerçeklenirken ihmal edilen bir durumdan
bahsedeceğiz. HTTP sunucunuzun çok sayıda adresten çok sayıda portu
dinlemek için çok sayıda Listen yönergesi kullanmakta olduğunu varsayalım. Her
soketi çalıştığını görmek için denerken Apache bağlantı için
select(2) kullanacaktır. select(2) çağrısı
bu soketin üzerinde sıfır veya en azından bir
bağlantının beklemekte olduğu anlamına gelir. Apache'nin modeli çok
sayıda çocuk süreç içerir ve boşta olanların tümünde aynı anda yeni
bağlantılar denenebilir. Gerçekte çalışan kod bu olmasa da meramımızı
anlatmak için kodun şöyle bir şey olduğunu varsayabiliriz:
for (;;) {
for (;;) {
fd_set accept_fds;
FD_ZERO (&accept_fds);
for (i = first_socket; i <= last_socket; ++i) {
FD_SET (i, &accept_fds);
}
rc = select (last_socket+1, &accept_fds, NULL, NULL, NULL);
if (rc < 1) continue;
new_connection = -1;
for (i = first_socket; i <= last_socket; ++i) {
if (FD_ISSET (i, &accept_fds)) {
new_connection = accept (i, NULL, NULL);
if (new_connection != -1) break;
}
}
if (new_connection != -1) break;
}
process_the(new_connection);
}
Bu özet gerçeklenim bir takım açlık sorunlarına sebep olur. Bu
döngünün çalışması sırasında aynı anda çok sayıda çocuk süreç yeniden
çağrılır ve istekler arasında kalan çoğu çocuk da select
ile engellenir. Engellenen tüm bu çocuklar soketlerden herhangi biri
üzerinde tek bir istek göründüğünde select tarafından
uyandırılıp işleme sokulmak üzere döndürülürler. (Uyandırılan çocuk
sayısı işletim sistemine ve zamanlama ayarlarına göre değişiklik
gösterir,) Bunların hepsi döngüye katılıp bağlantı kabul etmeye
(accept) çalışırlar. Fakat içlerinden yalnız biri
(sadece bir bağlantı isteğinin mevcut olduğu varsayımıyla) bunu
başarabilir. Kalanının bağlantı kabul etmesi (accept)
engellenir. Bu durum, bu çocukları istekleri başka başka soketlerden
değil mecburen tek bir soketten kabul etmeye kilitler ve bu soket
üzerinde yeni bir istek belirip uyandırılana kadar bu durumda
kalırlar. Bu açlık sorunu ilk olarak PR#467 sayılı raporla
belgelenmiştir. Bu sorunun en az iki çözümü vardır.
Çözümün biri engellenmeyen soket kullanımıdır. Bu durumda
accept çocukları engellemeyecek ve yapılan bir
bağlantının ardından diğer çocuklar durumları değişmeksizin bağlantı
beklemeye devam edeceklerdir. Fakat bu durum işlemci zamanının boşa
harcanmasına sebep olur. Seçilmiş (select) boşta on
çocuğun olduğunu ve bir bağlantı geldiğini varsayalım. Kalan dokuz
çocuk işine devam edip bağlantı kabul etmeyi (accept)
deneyecek, başarızsız olacak, dönecek başa, tekrar seçilecek
(select) ve böyle hiçbir iş yapmadan dönüp duracaktır. Bu
arada hizmet sunmakta olanlar da işlerini bitirdikten sonra bu
döngüdeki yerlerini alacaklardır. Aynı kutunun içinde boşta bir sürü
işlemciniz (çok işlemcili sistemler) yoksa bu çözüm pek verimli
olmayacaktır.
Diğer çözüm ise Apache tarafından kullanılan çözüm olup, girdiyi bir iç döngüde sıraya sokmaktır. Döngü aşağıda örneklenmiştir (farklar vurgulanmıştır):
for (;;) {
accept_mutex_on ();
for (;;) {
fd_set accept_fds;
FD_ZERO (&accept_fds);
for (i = first_socket; i <= last_socket; ++i) {
FD_SET (i, &accept_fds);
}
rc = select (last_socket+1, &accept_fds, NULL, NULL, NULL);
if (rc < 1) continue;
new_connection = -1;
for (i = first_socket; i <= last_socket; ++i) {
if (FD_ISSET (i, &accept_fds)) {
new_connection = accept (i, NULL, NULL);
if (new_connection != -1) break;
}
}
if (new_connection != -1) break;
}
accept_mutex_off ();
process the new_connection;
}
accept_mutex_on ve accept_mutex_off işlevleri bir karşılıklı red
semoforu oluştururlar. Mutekse aynı anda sadece bir çocuk sahip
olabilir. Bu muteksleri gerçeklemek için çeşitli seçenekler vardır.
Seçim, src/conf.h (1.3 öncesi) veya
src/include/ap_config.h (1.3 ve sonrası) dosyasında
tanımlanmıştır. Bazı mimariler bir kilitleme seçeneğine sahip
değildir. Böyle mimarilerde çok sayıda Listen yönergesi kullanmak güvenilir
olmayacaktır.
Mutex yönergesi,
mpm-accept muteks gerçeklenimini çalışma anında değiştirmek
için kullanılabilir. Farklı muteks gerçeklenimleri ile ilgili hususlar
bu yönergede belgelenmiştir.
Başka bir çözüm daha vardır ancak döngü kısmen dizgilenmeyeceğinden (yani belli sayıda sürece izin verilemeyeceğinden) asla gerçeklenmemiştir. Bu sadece, aynı anda çok sayıda çocuk sürecin çalışabileceği ve dolayısıyla band genişliğinin tüm yönleriyle kullanılabileceği çok işlemcili sistemlerde ilginç olabilirdi. Bu gelecekte incelenmeye değer bir konu olmakla beraber çok sayıda HTTP sunucusunun aynı anda aynı amaca hizmet edecek şekilde çalışması standart olarak pek mümkün görülmediğinden bu olasılık çok düşüktür.
En yüksek başarımı elde etmek için ideal olanı sunucuları
çalıştırırken çok sayıda Listen yönergesi kullanmamaktır. Fakat siz yine de
okumaya devam edin.
accept dizgilemesi - tek soketÇok soketli sunucular için yukarıda açıklananlar iyi güzel de tek
soketli sunucularda durum ne? Kuramsal olarak, bunların hiçbiriyle bir
sorunları olmaması gerekir. Çünkü yeni bir bağlantı gelene kadar tüm
çocuklar accept(2) ile engellenirler dolayısıyla hiçbir
açlık sorununun ortaya çıkmaması gerekir. Uygulamada ise son
kullanıcıdan gizli olarak, yukarıda engellenmeyen çocuklar çözümünde
bahsedilenle hemen hemen aynı "boşa dönüp durma" davranışı mevcuttur.
Çoğu TCP yığıtı bu yolu gerçeklemiştir. Çekirdek, yeni bir bağlantı
ortaya çıktığında accept ile engellenen tüm süreçleri
uyandırır. Bu süreçlerden bağlantıyı alan kullanıcı bölgesine geçerken
çekirdek içinde döngüde olan diğerleri de yeni bağlantı keşfedilene
kadar uykularına geri dönerler. Bu çekirdek içi döngü, kullanıcı
bölgesindeki kodlara görünür değildir ama bu olmadıkları anlamına
gelmez. Bu durum, çok soketli engellenmeyen çocuklar çözümündeki boşa
döngünün sebep olduğu gereksiz işlemci yükü sorununu içinde
barındırır.
Bununla birlikte, tek soketli durumda bile bundan daha verimli bir
davranış sergileyen bir çok mimari bulduk. Bu aslında hemen hemen her
durumda öntanımlı olarak böyledir. Linux altında yapılan üstünkörü
denemelerde (128MB bellekli çift Pentium pro 166 işlemcili makinede
Linux 2.0.30) tek sokette dizgilemenin dizgilenmemiş duruma göre
saniyede %3 daha az istekle sonuçlandığı gösterilmiştir. Fakat
dizgilenmemiş tek soket durumunda her istekte 100ms'lik ek bir gecikme
olduğu görülmüştür. Bu gecikmenin sebebi muhtemelen uzun mesafeli
hatlar olup sadece yerel ağlarda söz konusudur. Tek soketli
dizgilemeyi geçersiz kılmak için
SINGLE_LISTEN_UNSERIALIZED_ACCEPT tanımlarsanız tek
soketli sunucularda artık dizgileme yapılmayacaktır.
draft-ietf-http-connection-00.txt taslağının 8. bölümünde bahsedildiği gibi, bir HTTP sunucusunun protokolü güvenilir şekilde gerçeklemesi için her iki yöndeki iletişimi birbirinden bağımsız olarak (iki yönlü bir TCP bağlantısının her yarısını diğerinden bağımsız olarak) kapatması gerekir.
Bu özellik Apache'ye eklendiğinde Unix'in çeşitli sürümlerinde
uzgörüsüzlükten dolayı bir takım geçici telaş sorunlarına sebep oldu.
TCP belirtimi FIN_WAIT_2 durumunda bir zaman aşımından
bahsetmez ama yasaklamaz da. Zaman aşımı olmayan sistemlerde, Apache
1.2 çoğu soketin sonsuza kadar FIN_WAIT_2 durumunda
takılıp kalmasına sebep olur. Çoğu durumda, satıcıdan sağlanan en son
TCP/IP yamalarını uygulanarak bu önlenebilir. Satıcının hiçbir yeni
yama dağıtmadığı durumlarda (örneğin, SunOS4 -- bir kaynak lisansı ile
insanlar bunu kendileri yamayabilirse de) bu özelliği devre dışı
bırakmaya karar verdik.
Bunun üstesinden gelmenin iki yolu vardır. Bunlardan biri
SO_LINGER soket seçeneğidir. Bu işin kaderi buymuş gibi
görünürse de çoğu TCP/IP yığıtında bu gerektiği gibi
gerçeklenmemiştir. Bu yığıtlar üzerinde, bu yöntemin, doğru bir
gerçeklenimle bile (örneğin, Linux 2.0.31) sonraki çözümden daha
pahalı olduğu ortaya çıkmıştır.
Çoğunlukla, Apache bunu (http_main.c içindeki)
lingering_close adında bir işlevle gerçekler. Bu işlev
kabaca şöyle görünür:
void lingering_close (int s)
{
char junk_buffer[2048];
/* shutdown the sending side */
shutdown (s, 1);
signal (SIGALRM, lingering_death);
alarm (30);
for (;;) {
select (s for reading, 2 second timeout);
if (error) break;
if (s is ready for reading) {
if (read (s, junk_buffer, sizeof (junk_buffer)) <= 0) {
break;
}
/* just toss away whatever is here */
}
}
close (s);
}
Bağlantı sonunda bu doğal olarak biraz daha masrafa yol açar, fakat
güvenilir bir gerçeklenim için bu gereklidir. HTTP/1.1'in daha yaygın
kullanılmaya başlanması ve tüm bağlantıların kalıcı hale gelmesiyle bu
gerçeklenim daha fazla istek üzerinden kendi masrafını
karşılayacaktır. Ateşle oynamak ve bu özelliği devre dışı bırakmak
isterseniz NO_LINGCLOSE'u tanımlayabilirsiniz, fakat bu
asla önerilmez. Özellikle, HTTP/1.1'den itibaren boruhatlı kalıcı
bağlantıların lingering_close kullanmaya başlaması mutlak
bir gerekliliktir (ve
boruhatlı bağlantıların daha hızlı olması nedeniyle bu
bağlantıları desteklemek isteyebilirsiniz).
Apache'nin ana ve alt süreçleri birbirleriyle çetele denen birşey
üzerinden haberleşirler. Bunun en mükemmel şekilde paylaşımlı bellekte
gerçeklenmesi gerekir. Eriştiğimiz veya portlarını ayrıntılı olarak
belirttiğimiz işletim sistemleri için bu, genellikle paylaşımlı bellek
kullanılarak gerçeklenir. Geri kalanlar, öntanımlı olarak bunu bir
disk dosyası kullanarak gerçekler. Bir disk dosyaı yavaş olmanın yanı
sıra güvenilir de değildir (ve daha az özelliğe sahiptir). Mimarinizin
src/main/conf.h dosyasını inceleyin ve
USE_MMAP_SCOREBOARD veya
USE_SHMGET_SCOREBOARD'a bakın. Bu ikisinden birinin (ve
yanı sıra sırasıyla HAVE_MMAP veya
HAVE_SHMGET'in) tanımlanmış olması, sağlanan paylaşımlı
bellek kodunu etkinleştirir. Eğer sisteminiz diğer türdeki paylaşımlı
belleğe sahipse, src/main/http_main.c dosyasını açıp,
Apache'de bu belleği kullanması gereken kanca işlevleri ekleyin (Bize
de bir yama yollayın, lütfen).
Devingen olarak yüklenen modülleri kullanmamak niyetindeyseniz
(burayı okuyan ve sunucunuzun başarımını son kırıntısına kadar
arttırmakla ilgilenen biriyseniz bunu düşünmezsiniz), sunucunuzu
derlerken seçenekler arasına -DDYNAMIC_MODULE_LIMIT=0
seçeneğini de ekleyin. Bu suretle, sadece, devingen olarak yüklenen
modüller için ayrılacak belleği kazanmış olacaksınız.
Burada, Solaris 8 üzerinde worker MPM'li Apache 2.0.38'in bir sistem çağrısı izlenmektedir. Bu izleme şu komutla elde edilmiştir:
truss -l -p httpd_çocuk_pidi.
-l seçeneği, truss'a hafif bir sürecin yaptığı her
sistem çağrısını (hafif süreç -- HS -- Solaris'in bir çekirdek seviyesi
evreleme biçimi) günlüğe yazmasını söyler.
Diğer sistemlerin sistem çağrılarını izleyen farklı araçları vardır
(strace, ktrace, par gibi).
Bunlar da benzer çıktılar üretirler.
Bu izleme sırasında, bir istemci httpd'den 10 KB'lık duruk bir dosya talebinde bulunmuştur. Duruk olmayan veya içerik uzlaşımlı isteklerin izleme kayıtları vahşice (bazı durumlarda epey çirkince) farklı görünür.
/67: accept(3, 0x00200BEC, 0x00200C0C, 1) (uykuda...)
/67: accept(3, 0x00200BEC, 0x00200C0C, 1) = 9
Bu izlemede, dinleyen evre HS #67 içinde çalışmaktadır.
accept(2) dizgelemesinin olmayışına dikkat edin.
Özellikle bu platformda worker MPM, çok sayıda portu dinlemedikçe,
öntanımlı olarak dizgeleştirilmemiş bir accept çağrısı kullanır.
/65: lwp_park(0x00000000, 0) = 0
/67: lwp_unpark(65, 1) = 0
Bağlantının kabul edilmesiyle, dinleyici evre isteği yerine getirmek üzere bir worker evresini uyandırır. Bu izlemede, isteği yerine getiren worker evresi HS #65'e aittir.
/65: getsockname(9, 0x00200BA4, 0x00200BC4, 1) = 0
Sanal konakların gerçeklenimi sırasında, Apache'nin, bağlantıları
kabul etmek için kullanılan yerel soket adreslerini bilmesi gerekir.
Çoğu durumda bu çağrıyı bertaraf etmek mümkündür (hiç sanal konağın
olmadığı veya Listen
yönergelerinin mutlak adreslerle kullanıldığı durumlarda). Fakat bu en
iyilemeleri yapmak için henüz bir çaba harcanmamıştır.
/65: brk(0x002170E8) = 0
/65: brk(0x002190E8) = 0
brk(2) çağrıları devingen bellekten bellek ayırır. httpd
çoğu isteği yerine getirirken özel bellek ayırıcılar
(apr_pool ve apr_bucket_alloc) kullandığından
bunlar bir sistem çağrısı izlemesinde nadiren görünür. Bu izlemede,
httpd henüz yeni başlatıldığından, özel bellek ayırıcıları oluşturmak
için ham bellek bloklarını ayırmak amacıyla malloc(3)
çağrıları yapması gerekir.
/65: fcntl(9, F_GETFL, 0x00000000) = 2
/65: fstat64(9, 0xFAF7B818) = 0
/65: getsockopt(9, 65535, 8192, 0xFAF7B918, 0xFAF7B910, 2190656) = 0
/65: fstat64(9, 0xFAF7B818) = 0
/65: getsockopt(9, 65535, 8192, 0xFAF7B918, 0xFAF7B914, 2190656) = 0
/65: setsockopt(9, 65535, 8192, 0xFAF7B918, 4, 2190656) = 0
/65: fcntl(9, F_SETFL, 0x00000082) = 0
Ardından, worker evresi istemciye (dosya tanıtıcısı 9) engellenmeyen
kipte bir bağlantı açar. setsockopt(2)
ve getsockopt(2) çağrıları, Solaris libc'sinin soketler
üzerindeki fcntl(2) çağrısı yanında birer yan etkiden
ibarettirler.
/65: read(9, " G E T / 1 0 k . h t m".., 8000) = 97
Worker evresi istemciden isteği okur.
/65: stat("/var/httpd/apache/httpd-8999/htdocs/10k.html", 0xFAF7B978) = 0
/65: open("/var/httpd/apache/httpd-8999/htdocs/10k.html", O_RDONLY) = 10
Bu httpd Options FollowSymLinks ve AllowOverride
None ile yapılandırılmıştır. Bu bakımdan, ne istenen dosya ile
sonuçlanan yol üzerindeki her dizinde lstat(2) çağrısına ne
de .htaccess dosyalarına bakılmasına gerek vardır.
stat(2) çağrısı basitçe dosya için şunları doğrulamak
amacıyla yapılır: 1) dosya mevcuttur ve 2) bir dizin değil normal bir
dosyadır.
/65: sendfilev(0, 9, 0x00200F90, 2, 0xFAF7B53C) = 10269
Bu örnekte, httpd, istenen dosyayı ve HTTP yanıt başlığını tek bir
sendfilev(2) sistem çağrısı ile göndermektedir. Dosya
gönderim işleminin anlamı sistemden sisteme değişiklik gösterir. Bazı
sistemlerde, sendfile(2) çağrısından önce başlıkları
göndermek için write(2) veya writev(2)
çağrısı yapmak gerekir.
/65: write(4, " 1 2 7 . 0 . 0 . 1 - ".., 78) = 78
Bu write(2) çağrısı isteği erişim günlüğüne kaydeder. Bu
izlemede eksik olan tek şey, time(2) çağrısıdır. Apache
1.3'ün aksine, Apache 2.x zamana bakmak için
gettimeofday(3) çağırısını kullanır. Linux ve Solaris gibi
bazı işletim sistemleri, gettimeofday işlevinin, sıradan
bir sistem çağrısından daha fazla götürüsü olmayan en iyilenmiş bir
gerçeklenimine sahiptir.
/65: shutdown(9, 1, 1) = 0
/65: poll(0xFAF7B980, 1, 2000) = 1
/65: read(9, 0xFAF7BC20, 512) = 0
/65: close(9) = 0
Burada worker evresi bağlantıyı zamana yaymaktadır.
/65: close(10) = 0
/65: lwp_park(0x00000000, 0) (uykuda...)
Son olarak, worker evresi teslim edilen dosyayı kapattıktan sonra dinleyici evre tarafından başka bir bağlantı atanıncaya kadar beklemeye alınır.
/67: accept(3, 0x001FEB74, 0x001FEB94, 1) (uykuda...)
Bu arada, dinleyici evre bağlantıyı bir worker evresine atar atamaz
başka bir bağlantıyı beklemeye başlar (Mevcut tüm evreler meşgulse
dinleyici evreyi baskılayan worker MPM'nin akış denetim şemasına konu
olur). Bu izlemede görünmüyor olsa da sonraki accept(2)
çağrısı, yeni bağlantı kabul eden worker evresine paralel olarak
yapılabilir (aşırı yük durumlarında normal olarak, bu yapılır).
Serveur HTTP Apache Version 2.4
Vous trouverez plus loin une liste de pages de documentation additionnelles concernant le projet de développement du serveur web Apache.
La mise à jour des documents ci-dessous permettant de prendre en compte les modifications apportées par la version 2.1 du serveur HTTP Apache n'a pas été entièrement menée à bien. Certaines informations sont probablement encore pertinentes, mais utilisez-les tout de même avec précautions.
Notes à propos de la configuration d'Apache pour de plus hautes performances (à l'exécution et à la compilation). Notes expliquant pourquoi Apache accomplit certaines choses et n'en accomplit pas certaines autres (les premières l'accélérant et les deuxièmes le ralentissant).
Quelques conseils de type "faites" ou "ne faites pas" pour que votre site web Apache reste sécurisé.
Ce document constitue une page de référence pour la plupart des standards concernés par Apache.
Discussion à propos des divers algorithmes de chiffrement supportés par Apache à des fins d'authentification.
Serveur HTTP Apache Version 2.4
Cette page documente tous les standards applicables que suit le serveur HTTP Apache, accompagnés d'une brève description.
Pour compléter les informations fournies ci-dessous, vous pouvez consulter les ressources suivantes :
Ce document n'est pas encore finalisé.
Indépendamment des modules compilés et utilisés, Apache en tant que serveur web de base respecte les recommandations IETF suivantes :
En ce qui concerne le langage HTML, Apache respecte les recommandations IETF et W3C suivantes :
En ce qui concerne les différentes méthodes d'authentification, Apache respecte les recommandations IETF suivantes :
Les liens suivants fournissent des informations à propos des codes de langues et de pays aux normes ISO ou autres :
Apache HTTP Server Version 2.4
Notes about the password encryption formats generated and understood by Apache.
There are five formats that Apache recognizes for basic-authentication passwords. Note that not all formats work on every platform:
crypt(3) function
with a randomly-generated 32-bit salt (only 12 bits used) and the first 8
characters of the password. Insecure.
$ htpasswd -nbB myName myPassword
myName:$2y$05$c4WoMPo3SXsafkva.HHa6uXQZWr7oboPiC2bT/r7q1BB8I2s0BRqC
$ htpasswd -nbm myName myPassword
myName:$apr1$r31.....$HqJZimcKQFAMYayBlzkrA/
$ htpasswd -nbs myName myPassword
myName:{SHA}VBPuJHI7uixaa6LQGWx4s+5GKNE=
$ htpasswd -nbd myName myPassword
myName:rqXexS6ZhobKA
OpenSSL knows the Apache-specific MD5 algorithm.
$ openssl passwd -apr1 myPassword
$apr1$qHDFfhPC$nITSVHgYbDAK1Y0acGRnY0
openssl passwd -crypt myPassword
qQ5vTYO3c8dsU
The salt for a CRYPT password is the first two characters (converted to
a binary value). To validate myPassword against
rqXexS6ZhobKA
$ openssl passwd -crypt -salt rq myPassword
Warning: truncating password to 8 characters
rqXexS6ZhobKA
Note that using myPasswo instead of
myPassword will produce the same result because only the
first 8 characters of CRYPT passwords are considered.
The salt for an MD5 password is between $apr1$ and the
following $ (as a Base64-encoded binary value - max 8 chars).
To validate myPassword against
$apr1$r31.....$HqJZimcKQFAMYayBlzkrA/
$ openssl passwd -apr1 -salt r31..... myPassword
$apr1$r31.....$HqJZimcKQFAMYayBlzkrA/
The SHA1 variant is probably the most useful format for DBD authentication. Since the SHA1 and Base64 functions are commonly available, other software can populate a database with encrypted passwords that are usable by Apache basic authentication.
To create Apache SHA1-variant basic-authentication passwords in various languages:
'{SHA}' . base64_encode(sha1($password, TRUE))
"{SHA}" + new sun.misc.BASE64Encoder().encode(java.security.MessageDigest.getInstance("SHA1").digest(password.getBytes()))
"{SHA}" & ToBase64(BinaryDecode(Hash(password, "SHA1"), "Hex"))
require 'digest/sha1'
require 'base64'
'{SHA}' + Base64.encode64(Digest::SHA1.digest(password))
Use the APR function: apr_sha1_base64
import base64
import hashlib
"{SHA}" + format(base64.b64encode(hashlib.sha1(password).digest()))
'{SHA}'||encode(digest(password,'sha1'),'base64')
Apache recognizes one format for
digest-authentication passwords - the MD5 hash of the string
user:realm:password as a 32-character string of hexadecimal
digits. realm is the Authorization Realm argument to the
AuthName directive in
httpd.conf.
Since the MD5 function is commonly available, other software can populate a database with encrypted passwords that are usable by Apache digest authentication.
To create Apache digest-authentication passwords in various languages:
md5($user . ':' . $realm . ':' .$password)
byte b[] = java.security.MessageDigest.getInstance("MD5").digest( (user + ":" + realm + ":" + password ).getBytes());
java.math.BigInteger bi = new java.math.BigInteger(1, b);
String s = bi.toString(16);
while (s.length() < 32)
s = "0" + s;
// String s is the encrypted password
LCase(Hash( (user & ":" & realm & ":" & password) , "MD5"))
require 'digest/md5'
Digest::MD5.hexdigest(user + ':' + realm + ':' + password)
encode(digest( user || ':' || realm || ':' || password , 'md5'), 'hex')
Apache HTTP Server Version 2.4
Apache 2.x is a general-purpose webserver, designed to provide a balance of flexibility, portability, and performance. Although it has not been designed specifically to set benchmark records, Apache 2.x is capable of high performance in many real-world situations.
Compared to Apache 1.3, release 2.x contains many additional optimizations to increase throughput and scalability. Most of these improvements are enabled by default. However, there are compile-time and run-time configuration choices that can significantly affect performance. This document describes the options that a server administrator can configure to tune the performance of an Apache 2.x installation. Some of these configuration options enable the httpd to better take advantage of the capabilities of the hardware and OS, while others allow the administrator to trade functionality for speed.
Hardware and Operating System Issues Run-Time Configuration Issues Compile-Time Configuration Issues Appendix: Detailed Analysis of a TraceThe single biggest hardware issue affecting webserver
performance is RAM. A webserver should never ever have to swap,
as swapping increases the latency of each request beyond a point
that users consider "fast enough". This causes users to hit
stop and reload, further increasing the load. You can, and
should, control the MaxRequestWorkers setting so that your server
does not spawn so many children that it starts swapping. The procedure
for doing this is simple: determine the size of your average Apache
process, by looking at your process list via a tool such as
top, and divide this into your total available memory,
leaving some room for other processes.
Beyond that the rest is mundane: get a fast enough CPU, a fast enough network card, and fast enough disks, where "fast enough" is something that needs to be determined by experimentation.
Operating system choice is largely a matter of local concerns. But some guidelines that have proven generally useful are:
Run the latest stable release and patch level of the operating system that you choose. Many OS suppliers have introduced significant performance improvements to their TCP stacks and thread libraries in recent years.
If your OS supports a sendfile(2) system
call, make sure you install the release and/or patches
needed to enable it. (With Linux, for example, this means
using Linux 2.4 or later. For early releases of Solaris 8,
you may need to apply a patch.) On systems where it is
available, sendfile enables Apache 2 to deliver
static content faster and with lower CPU utilization.
| Related Modules | Related Directives |
|---|---|
Prior to Apache 1.3, HostnameLookups defaulted to On.
This adds latency to every request because it requires a
DNS lookup to complete before the request is finished. In
Apache 1.3 this setting defaults to Off. If you need
to have addresses in your log files resolved to hostnames, use the
logresolve
program that comes with Apache, or one of the numerous log
reporting packages which are available.
It is recommended that you do this sort of postprocessing of your log files on some machine other than the production web server machine, in order that this activity not adversely affect server performance.
If you use any Allow from domainDeny from domain
Note that it's possible to scope the directives, such as
within a <Location "/server-status"> section.
In this case the DNS lookups are only performed on requests
matching the criteria. Here's an example which disables lookups
except for .html and .cgi files:
HostnameLookups off <Files ~ "\.(html|cgi)$"> HostnameLookups on </Files>
But even still, if you just need DNS names in some CGIs you
could consider doing the gethostbyname call in the
specific CGIs that need it.
Wherever in your URL-space you do not have an Options
FollowSymLinks, or you do have an Options
SymLinksIfOwnerMatch, Apache will need to issue extra
system calls to check up on symlinks. (One extra call per
filename component.) For example, if you had:
DocumentRoot "/www/htdocs" <Directory "/"> Options SymLinksIfOwnerMatch </Directory>
and a request is made for the URI /index.html,
then Apache will perform lstat(2) on
/www, /www/htdocs, and
/www/htdocs/index.html. The results of these
lstats are never cached, so they will occur on
every single request. If you really desire the symlinks
security checking, you can do something like this:
DocumentRoot "/www/htdocs" <Directory "/"> Options FollowSymLinks </Directory> <Directory "/www/htdocs"> Options -FollowSymLinks +SymLinksIfOwnerMatch </Directory>
This at least avoids the extra checks for the
DocumentRoot path.
Note that you'll need to add similar sections if you
have any Alias or
RewriteRule paths
outside of your document root. For highest performance,
and no symlink protection, set FollowSymLinks
everywhere, and never set SymLinksIfOwnerMatch.
Wherever in your URL-space you allow overrides (typically
.htaccess files), Apache will attempt to open
.htaccess for each filename component. For
example,
DocumentRoot "/www/htdocs" <Directory "/"> AllowOverride all </Directory>
and a request is made for the URI /index.html.
Then Apache will attempt to open /.htaccess,
/www/.htaccess, and
/www/htdocs/.htaccess. The solutions are similar
to the previous case of Options FollowSymLinks.
For highest performance use AllowOverride None
everywhere in your filesystem.
If at all possible, avoid content negotiation if you're really interested in every last ounce of performance. In practice the benefits of negotiation outweigh the performance penalties. There's one case where you can speed up the server. Instead of using a wildcard such as:
DirectoryIndex index
Use a complete list of options:
DirectoryIndex index.cgi index.pl index.shtml index.html
where you list the most common choice first.
Also note that explicitly creating a type-map
file provides better performance than using
MultiViews, as the necessary information can be
determined by reading this single file, rather than having to
scan the directory for files.
If your site needs content negotiation, consider using
type-map files, rather than the Options
MultiViews directive to accomplish the negotiation. See the
Content Negotiation
documentation for a full discussion of the methods of negotiation,
and instructions for creating type-map files.
In situations where Apache 2.x needs to look at the contents
of a file being delivered--for example, when doing server-side-include
processing--it normally memory-maps the file if the OS supports
some form of mmap(2).
On some platforms, this memory-mapping improves performance. However, there are cases where memory-mapping can hurt the performance or even the stability of the httpd:
On some operating systems, mmap does not scale
as well as read(2) when the number of CPUs increases.
On multiprocessor Solaris servers, for example, Apache 2.x sometimes
delivers server-parsed files faster when mmap is disabled.
If you memory-map a file located on an NFS-mounted filesystem and a process on another NFS client machine deletes or truncates the file, your process may get a bus error the next time it tries to access the mapped file content.
For installations where either of these factors applies, you
should use EnableMMAP off to disable the memory-mapping
of delivered files. (Note: This directive can be overridden on
a per-directory basis.)
In situations where Apache 2.x can ignore the contents of the file
to be delivered -- for example, when serving static file content --
it normally uses the kernel sendfile support for the file if the OS
supports the sendfile(2) operation.
On most platforms, using sendfile improves performance by eliminating separate read and send mechanics. However, there are cases where using sendfile can harm the stability of the httpd:
Some platforms may have broken sendfile support that the build system did not detect, especially if the binaries were built on another box and moved to such a machine with broken sendfile support.
With an NFS-mounted filesystem, the kernel may be unable to reliably serve the network file through its own cache.
For installations where either of these factors applies, you
should use EnableSendfile off to disable sendfile
delivery of file contents. (Note: This directive can be overridden
on a per-directory basis.)
Prior to Apache 1.3 the MinSpareServers, MaxSpareServers, and StartServers settings all had drastic effects on
benchmark results. In particular, Apache required a "ramp-up"
period in order to reach a number of children sufficient to serve
the load being applied. After the initial spawning of
StartServers children,
only one child per second would be created to satisfy the
MinSpareServers
setting. So a server being accessed by 100 simultaneous
clients, using the default StartServers of 5 would take on
the order of 95 seconds to spawn enough children to handle
the load. This works fine in practice on real-life servers
because they aren't restarted frequently. But it does really
poorly on benchmarks which might only run for ten minutes.
The one-per-second rule was implemented in an effort to
avoid swamping the machine with the startup of new children. If
the machine is busy spawning children, it can't service
requests. But it has such a drastic effect on the perceived
performance of Apache that it had to be replaced. As of Apache
1.3, the code will relax the one-per-second rule. It will spawn
one, wait a second, then spawn two, wait a second, then spawn
four, and it will continue exponentially until it is spawning
32 children per second. It will stop whenever it satisfies the
MinSpareServers
setting.
This appears to be responsive enough that it's almost
unnecessary to twiddle the MinSpareServers, MaxSpareServers and StartServers knobs. When more than 4 children are
spawned per second, a message will be emitted to the
ErrorLog. If you
see a lot of these errors, then consider tuning these settings.
Use the mod_status output as a guide.
Related to process creation is process death induced by the
MaxConnectionsPerChild
setting. By default this is 0,
which means that there is no limit to the number of connections
handled per child. If your configuration currently has this set
to some very low number, such as 30, you may want to bump this
up significantly. If you are running SunOS or an old version of
Solaris, limit this to 10000 or so because of memory leaks.
When keep-alives are in use, children will be kept busy
doing nothing waiting for more requests on the already open
connection. The default KeepAliveTimeout of 5
seconds attempts to minimize this effect. The tradeoff here is
between network bandwidth and server resources. In no event
should you raise this above about 60 seconds, as
most of the benefits are lost.
Apache 2.x supports pluggable concurrency models, called
Multi-Processing Modules (MPMs).
When building Apache, you must choose an MPM to use. There
are platform-specific MPMs for some platforms:
mpm_netware,
mpmt_os2, and mpm_winnt. For
general Unix-type systems, there are several MPMs from which
to choose. The choice of MPM can affect the speed and scalability
of the httpd:
worker MPM uses multiple child
processes with many threads each. Each thread handles
one connection at a time. Worker generally is a good
choice for high-traffic servers because it has a smaller
memory footprint than the prefork MPM.event MPM is threaded like the
Worker MPM, but is designed to allow more requests to be
served simultaneously by passing off some processing work
to supporting threads, freeing up the main threads to work
on new requests.prefork MPM uses multiple child
processes with one thread each. Each process handles
one connection at a time. On many systems, prefork is
comparable in speed to worker, but it uses more memory.
Prefork's threadless design has advantages over worker
in some situations: it can be used with non-thread-safe
third-party modules, and it is easier to debug on platforms
with poor thread debugging support.For more information on these and other MPMs, please see the MPM documentation.
Since memory usage is such an important consideration in
performance, you should attempt to eliminate modules that you are
not actually using. If you have built the modules as DSOs, eliminating modules is a simple
matter of commenting out the associated LoadModule directive for that module.
This allows you to experiment with removing modules and seeing
if your site still functions in their absence.
If, on the other hand, you have modules statically linked into your Apache binary, you will need to recompile Apache in order to remove unwanted modules.
An associated question that arises here is, of course, what
modules you need, and which ones you don't. The answer here
will, of course, vary from one web site to another. However, the
minimal list of modules which you can get by with tends
to include mod_mime, mod_dir,
and mod_log_config. mod_log_config is,
of course, optional, as you can run a web site without log
files. This is, however, not recommended.
Some modules, such as mod_cache and
recent development builds of the worker MPM, use APR's
atomic API. This API provides atomic operations that can
be used for lightweight thread synchronization.
By default, APR implements these operations using the
most efficient mechanism available on each target
OS/CPU platform. Many modern CPUs, for example, have
an instruction that does an atomic compare-and-swap (CAS)
operation in hardware. On some platforms, however, APR
defaults to a slower, mutex-based implementation of the
atomic API in order to ensure compatibility with older
CPU models that lack such instructions. If you are
building Apache for one of these platforms, and you plan
to run only on newer CPUs, you can select a faster atomic
implementation at build time by configuring Apache with
the --enable-nonportable-atomics option:
./buildconf
./configure --with-mpm=worker --enable-nonportable-atomics=yes
The --enable-nonportable-atomics option is
relevant for the following platforms:
--enable-nonportable-atomics,
however, APR generates code that uses a SPARC v8plus opcode for
fast hardware compare-and-swap. If you configure Apache with
this option, the atomic operations will be more efficient
(allowing for lower CPU utilization and higher concurrency),
but the resulting executable will run only on UltraSPARC
chips.
--enable-nonportable-atomics,
however, APR generates code that uses a 486 opcode for fast
hardware compare-and-swap. This will result in more efficient
atomic operations, but the resulting executable will run only
on 486 and later chips (and not on 386).
If you include mod_status and you also set
ExtendedStatus On when building and running
Apache, then on every request Apache will perform two calls to
gettimeofday(2) (or times(2)
depending on your operating system), and (pre-1.3) several
extra calls to time(2). This is all done so that
the status report contains timing indications. For highest
performance, set ExtendedStatus off (which is the
default).
This section has not been fully updated to take into account changes made in the 2.x version of the Apache HTTP Server. Some of the information may still be relevant, but please use it with care.
This discusses a shortcoming in the Unix socket API. Suppose
your web server uses multiple Listen statements to listen on either multiple
ports or multiple addresses. In order to test each socket
to see if a connection is ready, Apache uses
select(2). select(2) indicates that a
socket has zero or at least one connection
waiting on it. Apache's model includes multiple children, and
all the idle ones test for new connections at the same time. A
naive implementation looks something like this (these examples
do not match the code, they're contrived for pedagogical
purposes):
for (;;) {
for (;;) {
fd_set accept_fds;
FD_ZERO (&accept_fds);
for (i = first_socket; i <= last_socket; ++i) {
FD_SET (i, &accept_fds);
}
rc = select (last_socket+1, &accept_fds, NULL, NULL, NULL);
if (rc < 1) continue;
new_connection = -1;
for (i = first_socket; i <= last_socket; ++i) {
if (FD_ISSET (i, &accept_fds)) {
new_connection = accept (i, NULL, NULL);
if (new_connection != -1) break;
}
}
if (new_connection != -1) break;
}
process_the(new_connection);
}
But this naive implementation has a serious starvation problem.
Recall that multiple children execute this loop at the same
time, and so multiple children will block at
select when they are in between requests. All
those blocked children will awaken and return from
select when a single request appears on any socket.
(The number of children which awaken varies depending on the
operating system and timing issues.) They will all then fall
down into the loop and try to accept the
connection. But only one will succeed (assuming there's still
only one connection ready). The rest will be blocked
in accept. This effectively locks those children
into serving requests from that one socket and no other
sockets, and they'll be stuck there until enough new requests
appear on that socket to wake them all up. This starvation
problem was first documented in PR#467. There
are at least two solutions.
One solution is to make the sockets non-blocking. In this
case the accept won't block the children, and they
will be allowed to continue immediately. But this wastes CPU
time. Suppose you have ten idle children in
select, and one connection arrives. Then nine of
those children will wake up, try to accept the
connection, fail, and loop back into select,
accomplishing nothing. Meanwhile none of those children are
servicing requests that occurred on other sockets until they
get back up to the select again. Overall this
solution does not seem very fruitful unless you have as many
idle CPUs (in a multiprocessor box) as you have idle children
(not a very likely situation).
Another solution, the one used by Apache, is to serialize entry into the inner loop. The loop looks like this (differences highlighted):
for (;;) {
accept_mutex_on ();
for (;;) {
fd_set accept_fds;
FD_ZERO (&accept_fds);
for (i = first_socket; i <= last_socket; ++i) {
FD_SET (i, &accept_fds);
}
rc = select (last_socket+1, &accept_fds, NULL, NULL, NULL);
if (rc < 1) continue;
new_connection = -1;
for (i = first_socket; i <= last_socket; ++i) {
if (FD_ISSET (i, &accept_fds)) {
new_connection = accept (i, NULL, NULL);
if (new_connection != -1) break;
}
}
if (new_connection != -1) break;
}
accept_mutex_off ();
process the new_connection;
}
The functions
accept_mutex_on and accept_mutex_off
implement a mutual exclusion semaphore. Only one child can have
the mutex at any time. There are several choices for
implementing these mutexes. The choice is defined in
src/conf.h (pre-1.3) or
src/include/ap_config.h (1.3 or later). Some
architectures do not have any locking choice made, on these
architectures it is unsafe to use multiple
Listen
directives.
The Mutex directive can
be used to change the mutex implementation of the
mpm-accept mutex at run-time. Special considerations
for different mutex implementations are documented with that
directive.
Another solution that has been considered but never implemented is to partially serialize the loop -- that is, let in a certain number of processes. This would only be of interest on multiprocessor boxes where it's possible that multiple children could run simultaneously, and the serialization actually doesn't take advantage of the full bandwidth. This is a possible area of future investigation, but priority remains low because highly parallel web servers are not the norm.
Ideally you should run servers without multiple
Listen
statements if you want the highest performance.
But read on.
The above is fine and dandy for multiple socket servers, but
what about single socket servers? In theory they shouldn't
experience any of these same problems because all the children
can just block in accept(2) until a connection
arrives, and no starvation results. In practice this hides
almost the same "spinning" behavior discussed above in the
non-blocking solution. The way that most TCP stacks are
implemented, the kernel actually wakes up all processes blocked
in accept when a single connection arrives. One of
those processes gets the connection and returns to user-space.
The rest spin in the kernel and go back to sleep when they
discover there's no connection for them. This spinning is
hidden from the user-land code, but it's there nonetheless.
This can result in the same load-spiking wasteful behavior
that a non-blocking solution to the multiple sockets case
can.
For this reason we have found that many architectures behave
more "nicely" if we serialize even the single socket case. So
this is actually the default in almost all cases. Crude
experiments under Linux (2.0.30 on a dual Pentium pro 166
w/128Mb RAM) have shown that the serialization of the single
socket case causes less than a 3% decrease in requests per
second over unserialized single-socket. But unserialized
single-socket showed an extra 100ms latency on each request.
This latency is probably a wash on long haul lines, and only an
issue on LANs. If you want to override the single socket
serialization, you can define
SINGLE_LISTEN_UNSERIALIZED_ACCEPT, and then
single-socket servers will not serialize at all.
As discussed in draft-ietf-http-connection-00.txt section 8, in order for an HTTP server to reliably implement the protocol, it needs to shut down each direction of the communication independently. (Recall that a TCP connection is bi-directional. Each half is independent of the other.)
When this feature was added to Apache, it caused a flurry of
problems on various versions of Unix because of shortsightedness.
The TCP specification does not state that the FIN_WAIT_2
state has a timeout, but it doesn't prohibit it.
On systems without the timeout, Apache 1.2 induces many sockets
stuck forever in the FIN_WAIT_2 state. In many cases this
can be avoided by simply upgrading to the latest TCP/IP patches
supplied by the vendor. In cases where the vendor has never
released patches (i.e., SunOS4 -- although folks with
a source license can patch it themselves), we have decided to
disable this feature.
There are two ways to accomplish this. One is the socket
option SO_LINGER. But as fate would have it, this
has never been implemented properly in most TCP/IP stacks. Even
on those stacks with a proper implementation (i.e.,
Linux 2.0.31), this method proves to be more expensive (cputime)
than the next solution.
For the most part, Apache implements this in a function
called lingering_close (in
http_main.c). The function looks roughly like
this:
void lingering_close (int s)
{
char junk_buffer[2048];
/* shutdown the sending side */
shutdown (s, 1);
signal (SIGALRM, lingering_death);
alarm (30);
for (;;) {
select (s for reading, 2 second timeout);
if (error) break;
if (s is ready for reading) {
if (read (s, junk_buffer, sizeof (junk_buffer)) <= 0) {
break;
}
/* just toss away whatever is here */
}
}
close (s);
}
This naturally adds some expense at the end of a connection,
but it is required for a reliable implementation. As HTTP/1.1
becomes more prevalent, and all connections are persistent,
this expense will be amortized over more requests. If you want
to play with fire and disable this feature, you can define
NO_LINGCLOSE, but this is not recommended at all.
In particular, as HTTP/1.1 pipelined persistent connections
come into use, lingering_close is an absolute
necessity (and
pipelined connections are faster, so you want to support
them).
Apache's parent and children communicate with each other
through something called the scoreboard. Ideally this should be
implemented in shared memory. For those operating systems that
we either have access to, or have been given detailed ports
for, it typically is implemented using shared memory. The rest
default to using an on-disk file. The on-disk file is not only
slow, but it is unreliable (and less featured). Peruse the
src/main/conf.h file for your architecture, and
look for either USE_MMAP_SCOREBOARD or
USE_SHMGET_SCOREBOARD. Defining one of those two
(as well as their companions HAVE_MMAP and
HAVE_SHMGET respectively) enables the supplied
shared memory code. If your system has another type of shared
memory, edit the file src/main/http_main.c and add
the hooks necessary to use it in Apache. (Send us back a patch
too, please.)
If you have no intention of using dynamically loaded modules
(you probably don't if you're reading this and tuning your
server for every last ounce of performance), then you should add
-DDYNAMIC_MODULE_LIMIT=0 when building your
server. This will save RAM that's allocated only for supporting
dynamically loaded modules.
Here is a system call trace of Apache 2.0.38 with the worker MPM on Solaris 8. This trace was collected using:
truss -l -p httpd_child_pid.
The -l option tells truss to log the ID of the
LWP (lightweight process--Solaris' form of kernel-level thread)
that invokes each system call.
Other systems may have different system call tracing utilities
such as strace, ktrace, or par.
They all produce similar output.
In this trace, a client has requested a 10KB static file from the httpd. Traces of non-static requests or requests with content negotiation look wildly different (and quite ugly in some cases).
/67: accept(3, 0x00200BEC, 0x00200C0C, 1) (sleeping...) /67: accept(3, 0x00200BEC, 0x00200C0C, 1) = 9
In this trace, the listener thread is running within LWP #67.
accept(2) serialization. On this
particular platform, the worker MPM uses an unserialized accept by
default unless it is listening on multiple ports./65: lwp_park(0x00000000, 0) = 0 /67: lwp_unpark(65, 1) = 0
Upon accepting the connection, the listener thread wakes up a worker thread to do the request processing. In this trace, the worker thread that handles the request is mapped to LWP #65.
/65: getsockname(9, 0x00200BA4, 0x00200BC4, 1) = 0
In order to implement virtual hosts, Apache needs to know
the local socket address used to accept the connection. It
is possible to eliminate this call in many situations (such
as when there are no virtual hosts, or when
Listen directives
are used which do not have wildcard addresses). But
no effort has yet been made to do these optimizations.
/65: brk(0x002170E8) = 0 /65: brk(0x002190E8) = 0
The brk(2) calls allocate memory from the heap.
It is rare to see these in a system call trace, because the httpd
uses custom memory allocators (apr_pool and
apr_bucket_alloc) for most request processing.
In this trace, the httpd has just been started, so it must
call malloc(3) to get the blocks of raw memory
with which to create the custom memory allocators.
/65: fcntl(9, F_GETFL, 0x00000000) = 2 /65: fstat64(9, 0xFAF7B818) = 0 /65: getsockopt(9, 65535, 8192, 0xFAF7B918, 0xFAF7B910, 2190656) = 0 /65: fstat64(9, 0xFAF7B818) = 0 /65: getsockopt(9, 65535, 8192, 0xFAF7B918, 0xFAF7B914, 2190656) = 0 /65: setsockopt(9, 65535, 8192, 0xFAF7B918, 4, 2190656) = 0 /65: fcntl(9, F_SETFL, 0x00000082) = 0
Next, the worker thread puts the connection to the client (file
descriptor 9) in non-blocking mode. The setsockopt(2)
and getsockopt(2) calls are a side-effect of how
Solaris' libc handles fcntl(2) on sockets.
/65: read(9, " G E T / 1 0 k . h t m".., 8000) = 97
The worker thread reads the request from the client.
/65: stat("/var/httpd/apache/httpd-8999/htdocs/10k.html", 0xFAF7B978) = 0
/65: open("/var/httpd/apache/httpd-8999/htdocs/10k.html", O_RDONLY) = 10This httpd has been configured with Options FollowSymLinks
and AllowOverride None. Thus it doesn't need to
lstat(2) each directory in the path leading up to the
requested file, nor check for .htaccess files.
It simply calls stat(2) to verify that the file:
1) exists, and 2) is a regular file, not a directory.
/65: sendfilev(0, 9, 0x00200F90, 2, 0xFAF7B53C) = 10269
In this example, the httpd is able to send the HTTP response
header and the requested file with a single sendfilev(2)
system call. Sendfile semantics vary among operating systems. On some other
systems, it is necessary to do a write(2) or
writev(2) call to send the headers before calling
sendfile(2).
/65: write(4, " 1 2 7 . 0 . 0 . 1 - ".., 78) = 78
This write(2) call records the request in the
access log. Note that one thing missing from this trace is a
time(2) call. Unlike Apache 1.3, Apache 2.x uses
gettimeofday(3) to look up the time. On some operating
systems, like Linux or Solaris, gettimeofday has an
optimized implementation that doesn't require as much overhead
as a typical system call.
/65: shutdown(9, 1, 1) = 0 /65: poll(0xFAF7B980, 1, 2000) = 1 /65: read(9, 0xFAF7BC20, 512) = 0 /65: close(9) = 0
The worker thread does a lingering close of the connection.
/65: close(10) = 0 /65: lwp_park(0x00000000, 0) (sleeping...)
Finally the worker thread closes the file that it has just delivered and blocks until the listener assigns it another connection.
/67: accept(3, 0x001FEB74, 0x001FEB94, 1) (sleeping...)
Meanwhile, the listener thread is able to accept another connection
as soon as it has dispatched this connection to a worker thread (subject
to some flow-control logic in the worker MPM that throttles the listener
if all the available workers are busy). Though it isn't apparent from
this trace, the next accept(2) can (and usually does, under
high load conditions) occur in parallel with the worker thread's handling
of the just-accepted connection.
Apache HTTP Server Version 2.4
Below is a list of additional documentation pages that apply to the Apache web server development project.
The documents below have not been fully updated to take into account changes made in the 2.1 version of the Apache HTTP Server. Some of the information may still be relevant, but please use it with care.
Notes about how to (run-time and compile-time) configure Apache for highest performance. Notes explaining why Apache does some things, and why it doesn't do other things (which make it slower/faster).
Some "do"s - and "don't"s - for keeping your Apache web site secure.
This document acts as a reference page for most of the relevant standards that Apache follows.
Discussion of the various ciphers supported by Apache for authentication purposes.
Apache HTTP Server Version 2.4
Some hints and tips on security issues in setting up a web server. Some of the suggestions will be general, others specific to Apache.
Keep up to Date Denial of Service (DoS) attacks Permissions on ServerRoot Directories Server Side Includes CGI in General Non Script Aliased CGI Script Aliased CGI Other sources of dynamic content Dynamic content security Protecting System Settings Protect Server Files by Default Watching Your Logs Merging of configuration sectionsThe Apache HTTP Server has a good record for security and a developer community highly concerned about security issues. But it is inevitable that some problems -- small or large -- will be discovered in software after it is released. For this reason, it is crucial to keep aware of updates to the software. If you have obtained your version of the HTTP Server directly from Apache, we highly recommend you subscribe to the Apache HTTP Server Announcements List where you can keep informed of new releases and security updates. Similar services are available from most third-party distributors of Apache software.
Of course, most times that a web server is compromised, it is not because of problems in the HTTP Server code. Rather, it comes from problems in add-on code, CGI scripts, or the underlying Operating System. You must therefore stay aware of problems and updates with all the software on your system.
All network servers can be subject to denial of service attacks that attempt to prevent responses to clients by tying up the resources of the server. It is not possible to prevent such attacks entirely, but you can do certain things to mitigate the problems that they create.
Often the most effective anti-DoS tool will be a firewall or other operating-system configurations. For example, most firewalls can be configured to restrict the number of simultaneous connections from any individual IP address or network, thus preventing a range of simple attacks. Of course this is no help against Distributed Denial of Service attacks (DDoS).
There are also certain Apache HTTP Server configuration settings that can help mitigate problems:
RequestReadTimeout
directive allows to limit the time a client may take to send the
request.TimeOut directive
should be lowered on sites that are subject to DoS attacks.
Setting this to as low as a few seconds may be appropriate.
As TimeOut is currently
used for several different operations, setting it to a low value
introduces problems with long running CGI scripts.KeepAliveTimeout
directive may be also lowered on sites that are subject to DoS
attacks. Some sites even turn off the keepalives completely via
KeepAlive, which has of course
other drawbacks on performance.LimitRequestBody,
LimitRequestFields,
LimitRequestFieldSize,
LimitRequestLine, and
LimitXMLRequestBody
should be carefully configured to limit resource consumption
triggered by client input.AcceptFilter directive
to offload part of the request processing to the operating
system. This is active by default in Apache httpd, but may
require reconfiguration of your kernel.MaxRequestWorkers directive to allow
the server to handle the maximum number of simultaneous
connections without running out of resources. See also the performance tuning
documentation.event mpm
uses asynchronous processing to avoid devoting a thread to each
connection. In typical operation, Apache is started by the root user, and it
switches to the user defined by the User directive to serve hits. As is the
case with any command that root executes, you must take care that it is
protected from modification by non-root users. Not only must the files
themselves be writeable only by root, but so must the directories, and
parents of all directories. For example, if you choose to place
ServerRoot in /usr/local/apache then it is suggested that
you create that directory as root, with commands like these:
mkdir /usr/local/apache
cd /usr/local/apache
mkdir bin conf logs
chown 0 . bin conf logs
chgrp 0 . bin conf logs
chmod 755 . bin conf logs
It is assumed that /, /usr, and
/usr/local are only modifiable by root. When you install the
httpd executable, you should ensure that it is
similarly protected:
cp httpd /usr/local/apache/bin
chown 0 /usr/local/apache/bin/httpd
chgrp 0 /usr/local/apache/bin/httpd
chmod 511 /usr/local/apache/bin/httpd
You can create an htdocs subdirectory which is modifiable by other users -- since root never executes any files out of there, and shouldn't be creating files in there.
If you allow non-root users to modify any files that root either
executes or writes on then you open your system to root compromises.
For example, someone could replace the httpd binary so
that the next time you start it, it will execute some arbitrary code. If
the logs directory is writeable (by a non-root user), someone could replace
a log file with a symlink to some other system file, and then root
might overwrite that file with arbitrary data. If the log files
themselves are writeable (by a non-root user), then someone may be
able to overwrite the log itself with bogus data.
Server Side Includes (SSI) present a server administrator with several potential security risks.
The first risk is the increased load on the server. All SSI-enabled files have to be parsed by Apache, whether or not there are any SSI directives included within the files. While this load increase is minor, in a shared server environment it can become significant.
SSI files also pose the same risks that are associated with CGI
scripts in general. Using the exec cmd element, SSI-enabled
files can execute any CGI script or program under the permissions of the
user and group Apache runs as, as configured in
httpd.conf.
There are ways to enhance the security of SSI files while still taking advantage of the benefits they provide.
To isolate the damage a wayward SSI file can cause, a server administrator can enable suexec as described in the CGI in General section.
Enabling SSI for files with .html or .htm
extensions can be dangerous. This is especially true in a shared, or high
traffic, server environment. SSI-enabled files should have a separate
extension, such as the conventional .shtml. This helps keep
server load at a minimum and allows for easier management of risk.
Another solution is to disable the ability to run scripts and
programs from SSI pages. To do this replace Includes
with IncludesNOEXEC in the Options directive. Note that users may
still use <--#include virtual="..." --> to execute CGI
scripts if these scripts are in directories designated by a ScriptAlias directive.
First of all, you always have to remember that you must trust the writers of the CGI scripts/programs or your ability to spot potential security holes in CGI, whether they were deliberate or accidental. CGI scripts can run essentially arbitrary commands on your system with the permissions of the web server user and can therefore be extremely dangerous if they are not carefully checked.
All the CGI scripts will run as the same user, so they have potential to conflict (accidentally or deliberately) with other scripts e.g. User A hates User B, so he writes a script to trash User B's CGI database. One program which can be used to allow scripts to run as different users is suEXEC which is included with Apache as of 1.2 and is called from special hooks in the Apache server code. Another popular way of doing this is with CGIWrap.
Allowing users to execute CGI scripts in any directory should only be considered if:
Limiting CGI to special directories gives the admin control over what goes into those directories. This is inevitably more secure than non script aliased CGI, but only if users with write access to the directories are trusted or the admin is willing to test each new CGI script/program for potential security holes.
Most sites choose this option over the non script aliased CGI approach.
Embedded scripting options which run as part of the server itself,
such as mod_php, mod_perl, mod_tcl,
and mod_python, run under the identity of the server itself
(see the User directive), and
therefore scripts executed by these engines potentially can access anything
the server user can. Some scripting engines may provide restrictions, but
it is better to be safe and assume not.
When setting up dynamic content, such as mod_php,
mod_perl or mod_python, many security considerations
get out of the scope of httpd itself, and you need to consult
documentation from those modules. For example, PHP lets you setup Safe Mode,
which is most usually disabled by default. Another example is Suhosin, a PHP addon for more
security. For more information about those, consult each project
documentation.
At the Apache level, a module named mod_security can be seen as a HTTP firewall and, provided you configure it finely enough, can help you enhance your dynamic content security.
To run a really tight ship, you'll want to stop users from setting
up .htaccess files which can override security features
you've configured. Here's one way to do it.
In the server configuration file, put
<Directory "/">
AllowOverride None
</Directory>
This prevents the use of .htaccess files in all
directories apart from those specifically enabled.
Note that this setting is the default since Apache 2.3.9.
One aspect of Apache which is occasionally misunderstood is the feature of default access. That is, unless you take steps to change it, if the server can find its way to a file through normal URL mapping rules, it can serve it to clients.
For instance, consider the following example:
# cd /; ln -s / public_html
Accessing http://localhost/~root/
This would allow clients to walk through the entire filesystem. To work around this, add the following block to your server's configuration:
<Directory "/">
Require all denied
</Directory>
This will forbid default access to filesystem locations. Add
appropriate Directory blocks to
allow access only in those areas you wish. For example,
<Directory "/usr/users/*/public_html">
Require all granted
</Directory>
<Directory "/usr/local/httpd">
Require all granted
</Directory>
Pay particular attention to the interactions of Location and Directory directives; for instance, even
if <Directory "/"> denies access, a
<Location "/"> directive might overturn it.
Also be wary of playing games with the UserDir directive; setting it to
something like ./ would have the same effect, for root, as
the first example above. We strongly
recommend that you include the following line in your server
configuration files:
UserDir disabled root
To keep up-to-date with what is actually going on against your server you have to check the Log Files. Even though the log files only reports what has already happened, they will give you some understanding of what attacks is thrown against the server and allow you to check if the necessary level of security is present.
A couple of examples:
grep -c "/jsp/source.jsp?/jsp/ /jsp/source.jsp??" access_log
grep "client denied" error_log | tail -n 10
The first example will list the number of attacks trying to exploit the Apache Tomcat Source.JSP Malformed Request Information Disclosure Vulnerability, the second example will list the ten last denied clients, for example:
[Thu Jul 11 17:18:39 2002] [error] [client foo.example.com] client denied
by server configuration: /usr/local/apache/htdocs/.htpasswd
As you can see, the log files only report what already has happened, so
if the client had been able to access the .htpasswd file you
would have seen something similar to:
foo.example.com - - [12/Jul/2002:01:59:13 +0200] "GET /.htpasswd HTTP/1.1"
in your Access Log. This means you probably commented out the following in your server configuration file:
<Files ".ht*">
Require all denied
</Files>
The merging of configuration sections is complicated and sometimes directive specific. Always test your changes when creating dependencies on how directives are merged.
For modules that don't implement any merging logic, such as
mod_access_compat, the behavior in later sections
depends on whether the later section has any directives
from the module. The configuration is inherited until a change is made,
at which point the configuration is replaced and not merged.
Serveur HTTP Apache Version 2.4
Ce document propose quelques conseils et astuces concernant les problèmes de sécurité liés à l'installation d'un serveur web. Certaines suggestions seront à caractère général, tandis que d'autres seront spécifiques à Apache.
Maintenez votre serveur à jour Attaques de type "Déni de service"
(Denial of Service - DoS) Permissions sur les répertoires de la racine du serveur Inclusions côté serveur Les CGI en général CGI sans alias de script CGI avec alias de script Autres sources de contenu dynamique Protection de la configuration du système Protection par défaut des fichiers du serveur Surveillez vos journaux Fusion des sections de configurationLe serveur HTTP Apache a une bonne réputation en matière de sécurité et possède une communauté de développeurs très sensibilisés aux problèmes de sécurité. Mais il est inévitable de trouver certains problèmes -- petits ou grands -- une fois le logiciel mis à disposition. C'est pour cette raison qu'il est crucial de se tenir informé des mises à jour. Si vous avez obtenu votre version du serveur HTTP directement depuis Apache, nous vous conseillons grandement de vous abonner à la Liste de diffusion des annonces du serveur HTTP qui vous informera de la parution des nouvelles versions et des mises à jour de sécurité. La plupart des distributeurs tiers d'Apache fournissent des services similaires.
Gardez cependant à l'esprit que lorsqu'un serveur web est compromis, le code du serveur HTTP n'est la plupart du temps pas en cause. Les problèmes proviennent plutôt de code ajouté, de scripts CGI, ou du système d'exploitation sous-jacent. Vous devez donc vous tenir informé des problèmes et mises à jour concernant tous les logiciels présents sur votre système.
Tous les services réseau peuvent faire l'objet d'attaques de type "Déni de service" qui tentent de les empêcher de répondre aux clients en saturant leurs ressources. Il est impossible de se prémunir totalement contre ce type d'attaques, mais vous pouvez accomplir certaines actions afin de minimiser les problèmes qu'elles créent.
Souvent, l'outil anti-DoS le plus efficace sera constitué par le pare-feu ou certaines configurations du système d'exploitation. Par exemple, la plupart des pare-feu peuvent être configurés de façon à limiter le nombre de connexions simultanées depuis une adresse IP ou un réseau, ce qui permet de prévenir toute une gamme d'attaques simples. Bien sûr, ceci n'est d'aucun secours contre les attaques de type "Déni de service" distribuées (DDoS).
Certains réglages de la configuration d'Apache peuvent aussi minimiser les problèmes :
RequestReadTimeout permet de
limiter le temps que met le client pour envoyer sa requête.TimeOut doit être diminuée sur les
sites sujets aux attaques DoS. Une valeur de quelques secondes devrait
convenir. Cependant, comme TimeOut
est actuellement concerné par de nombreuses opérations différentes, lui
attribuer une valeur trop faible peut provoquer des problèmes avec les
scripts CGI qui présentent un long temps de réponse.KeepAliveTimeout doit aussi être
diminuée sur les sites sujets aux attaques DoS. Certains sites
désactivent même complètement le "maintien en vie" (keepalives)
à l'aide de la directive
KeepAlive, ce qui bien sûr
présente des inconvénients en matière de performances.LimitRequestBody,
LimitRequestFields,
LimitRequestFieldSize,
LimitRequestLine, et
LimitXMLRequestBody doivent être
configurées avec prudence afin de limiter la consommation de ressources
induite par les demandes des clients.
AcceptFilter est
activée afin de déléguer une partie du traitement des requêtes au
système d'exploitation. Elle est activée par défaut dans le démon httpd
d'Apache, mais peut nécessiter une reconfiguration de votre noyau.MaxRequestWorkers de façon à définir le nombre
maximum de connexions simultanées au dessus duquel les ressources
s'épuisent. Voir aussi la documentation sur l'optimisation des
performances.event utilisera un traitement asynchrone afin de ne pas
dédier un thread à chaque connexion.Typiquement, Apache est démarré par l'utilisateur root, puis il devient
la propriété de l'utilisateur défini par la directive User afin de répondre aux demandes. Comme
pour toutes les commandes exécutées par root, vous devez vous assurer
qu'elle n'est pas modifiable par les utilisateurs autres que root. Les
fichiers eux-mêmes, mais aussi les répertoires ainsi que leurs parents ne
doivent être modifiables que par root. Par exemple, si vous avez choisi de
placer la racine du serveur dans /usr/local/apache, il est conseillé de
créer le répertoire en tant que root, avec des commandes du style :
mkdir /usr/local/apache
cd /usr/local/apache
mkdir bin conf logs
chown 0 . bin conf logs
chgrp 0 . bin conf logs
chmod 755 . bin conf logs
Nous supposerons que /, /usr et
/usr/local ne sont modifiables que par
root. Quand vous installez l'exécutable httpd, vous
devez vous assurer qu'il possède des protections similaires :
cp httpd /usr/local/apache/bin
chown 0 /usr/local/apache/bin/httpd
chgrp 0 /usr/local/apache/bin/httpd
chmod 511 /usr/local/apache/bin/httpd
Vous pouvez créer un sous-répertoire htdocs modifiable par d'autres utilisateurs -- car root ne crée ni exécute aucun fichier dans ce sous-répertoire.
Si vous permettez à des utilisateurs non root de modifier des fichiers
que root écrit ou exécute, vous exposez votre système à une compromission
de l'utilisateur root. Par exemple, quelqu'un pourrait remplacer le binaire
httpd de façon à ce que la prochaine fois que vous le
redémarrerez, il exécutera un code arbitraire. Si le répertoire des
journaux a les droits en écriture (pour un utilisateur non root), quelqu'un
pourrait remplacer un fichier journal par un lien symbolique vers un autre
fichier système, et root pourrait alors écraser ce fichier avec des données
arbitraires. Si les fichiers journaux eux-mêmes ont des droits en
écriture (pour un utilisateur non root), quelqu'un pourrait
modifier les journaux eux-mêmes avec des données fausses.
Les inclusions côté serveur (Server Side Includes - SSI) exposent l'administrateur du serveur à de nombreux risques potentiels en matière de sécurité.
Le premier risque est l'augmentation de la charge du serveur. Tous les fichiers où SSI est activé doivent être analysés par Apache, qu'ils contiennent des directives SSI ou non. L'augmentation de la charge induite est minime, mais peut devenir significative dans le contexte d'un serveur partagé.
Les fichiers SSI présentent les mêmes risques que les scripts CGI en
général. Les fichiers où SSI est activé peuvent exécuter tout script CGI
ou autre programme à l'aide de la commande "exec cmd" avec les permissions
des utilisateur et groupe sous lesquels Apache s'exécute, comme défini
dans httpd.conf.
Des méthodes existent pour améliorer la sécurité des fichiers SSI, tout en tirant parti des bénéfices qu'ils apportent.
Pour limiter les dommages qu'un fichier SSI agressif pourrait causer, l'administrateur du serveur peut activersuexec comme décrit dans la section Les CGI en général.
L'activation des SSI pour des fichiers possédant des extensions
.html ou
.htm peut s'avérer dangereux. Ceci est particulièrement vrai dans un
environnement de serveur partagé ou étant le siège d'un traffic élevé. Les
fichiers où SSI est activé doivent posséder une extension spécifique, telle
que la conventionnelle .shtml. Ceci permet de limiter la charge du serveur
à un niveau minimum et de simplifier la gestion des risques.
Une autre solution consiste à interdire l'exécution de scripts et
programmes à partir de pages SSI. Pour ce faire, remplacez
Includes par IncludesNOEXEC dans la directive
Options. Notez que les utilisateurs
pourront encore utiliser <--#include virtual="..." --> pour exécuter
des scripts CGI si ces scripts sont situés dans des répertoires spécifiés
par une directive
ScriptAlias.
Tout d'abord, vous devez toujours garder à l'esprit que vous devez faire confiance aux développeurs de scripts ou programmes CGI ainsi qu'à vos compétences pour déceler les trous de sécurité potentiels dans les CGI, que ceux-ci soient délibérés ou accidentels. Les scripts CGI peuvent essentiellement exécuter des commandes arbitraires sur votre système avec les droits de l'utilisateur du serveur web, et peuvent par conséquent être extrèmement dangereux s'ils ne sont pas vérifiés avec soin.
Tous les scripts CGI s'exécutent sous le même utilisateur, il peuvent donc entrer en conflit (accidentellement ou délibérément) avec d'autres scripts. Par exemple, l'utilisateur A hait l'utilisateur B, il écrit donc un script qui efface la base de données CGI de l'utilisateur B. Vous pouvez utiliser le programme suEXEC pour faire en sorte que les scripts s'exécutent sous des utilisateurs différents. Ce programme est inclus dans la distribution d'Apache depuis la version 1.2 et est appelé à partir de certaines portions de code du serveur Apache. Une autre méthode plus connue est l'utilisation de CGIWrap.
Vous ne devez permettre aux utilisateurs d'exécuter des scripts CGI depuis n'importe quel répertoire que dans l'éventualité où :
Le confinement des CGI dans des répertoires spécifiques permet à l'administrateur de contrôler ce que l'on met dans ces répertoires. Ceci est bien entendu mieux sécurisé que les CGI sans alias de script, mais seulement à condition que les utilisateurs avec les droits en écriture sur les répertoires soient dignes de confiance, et que l'administrateur ait la volonté de tester chaque programme ou script CGI à la recherche d'éventuels trous de sécurité.
La plupart des sites choisissent cette approche au détriment des CGI sans alias de script.
Les options de scripting intégrées qui s'exécutent en tant que partie du
serveur lui-même, comme mod_php, mod_perl,
mod_tcl, et mod_python,
s'exécutent sous le même utilisateur que le serveur (voir la directive
User), et par conséquent,
les scripts que ces moteurs exécutent peuvent accéder aux mêmes ressources
que le serveur. Certains moteurs de scripting peuvent proposer des
restrictions, mais pour plus de sûreté, il vaut mieux partir du principe
que ce n'est pas le cas.
Pour contrôler étroitement votre serveur, vous pouvez interdire
l'utilisation des fichiers .htaccess qui permettent de
passer outre les fonctionnalités de sécurité que vous avez configurées.
Voici un moyen pour y parvenir :
Ajoutez dans le fichier de configuration du serveur
<Directory "/">
AllowOverride None
</Directory>
Ceci interdit l'utilisation des fichiers .htaccess dans
tous les répertoires, sauf ceux pour lesquels c'est explicitement
autorisé.
Notez que c'est la configuration par défaut depuis Apache 2.3.9.
Le concept d'accès par défaut est un aspect d'Apache qui est parfois mal compris. C'est à dire que, à moins que vous ne changiez explicitement ce comportement, si le serveur trouve son chemin vers un fichier en suivant les règles normales de correspondance URL - fichier, il peut le retourner aux clients.
Considérons l'exemple suivant :
# cd /; ln -s / public_html
puis accès à http://localhost/~root/
Ceci permettrait aux clients de parcourir l'ensemble du système de fichiers. Pour l'éviter, ajoutez le bloc suivant à la configuration de votre serveur :
<Directory "/">
Require all denied
</Directory>
ceci va interdire l'accès par défaut à tous les fichiers du système de
fichiers. Vous devrez ensuite ajouter les blocs
Directory appropriés correspondant
aux répertoires auxquels vous voulez autorisez l'accès. Par exemple,
<Directory "/usr/users/*/public_html">
Require all granted
</Directory>
<Directory "/usr/local/httpd">
Require all granted
</Directory>
Portez une attention particulière aux interactions entre les directives
Location et
Directory ; par exemple, si une
directive <Directory ""/> interdit un accès, une
directive <Location "/"> pourra passer outre.
De même, soyez méfiant en jouant avec la directive
UserDir ; la positionner à
"./" aurait le même effet, pour root, que le premier exemple plus haut.
Nous vous conseillons
fortement d'inclure la ligne suivante dans le fichier de configuration de
votre serveur :
UserDir disabled root
Pour vous tenir informé de ce qui se passe réellement dans votre serveur, vous devez consulter vos fichiers journaux. Même si les fichiers journaux ne consignent que des évènements qui se sont déjà produits, ils vous informeront sur la nature des attaques qui sont lancées contre le serveur et vous permettront de vérifier si le niveau de sécurité nécessaire est atteint.
Quelques exemples :
grep -c "/jsp/source.jsp?/jsp/ /jsp/source.jsp??" access_log
grep "client denied" error_log | tail -n 10
Le premier exemple listera les attaques essayant d'exploiter la vulnérabilité d'Apache Tomcat pouvant provoquer la divulgation d'informations par des requêtes Source.JSP mal formées, le second donnera la liste des dix dernières interdictions client ; par exemple :
[Thu Jul 11 17:18:39 2002] [error] [client foo.example.com] client denied
by server configuration: /usr/local/apache/htdocs/.htpasswd
Comme vous le voyez, les fichiers journaux ne consignent que ce qui
s'est déjà produit ; ainsi, si le client a pu accéder au fichier
.htpasswd, vous devriez avoir quelque chose du style :
foo.example.com - - [12/Jul/2002:01:59:13 +0200] "GET /.htpasswd HTTP/1.1"
dans votre journal des accès ; ce qui signifie que vous avez probablement mis en commentaire ce qui suit dans le fichier de configuration de votre serveur :
<Files ".ht*">
Require all denied
</Files>
La fusion des sections de configuration est complexe et dépend souvent des directives utilisées. Vous devez systématiquement tester vos modifications pour vérifier la manière dont les directives sont fusionnées.
Concernant les modules qui n'implémentent aucune logique de
fusion, comme mod_access_compat, le
comportement des sections suivantes est tributaire de la présence
dans ces dernières de directives appartenant à ces modules. La
configuration est héritée jusqu'à ce qu'une modification soit
effectuée ; à ce moment, la configuration est remplacée et
non fusionnée.
Apache HTTP Server Version 2.4
This page documents all the relevant standards that the Apache HTTP Server follows, along with brief descriptions.
In addition to the information listed below, the following resources should be consulted:
This document is not yet complete.
Regardless of what modules are compiled and used, Apache as a basic web server complies with the following IETF recommendations:
Regarding the Hypertext Markup Language, Apache complies with the following IETF and W3C recommendations:
Concerning the different methods of authentication, Apache follows the following IETF recommendations:
The following links document ISO and other language and country code information:
Apache HTTP Sunucusu Sürüm 2.4
* For a fairly comprehensive set of languages see the * README * file that came with this source. At a minimum, the lexer should work on a * number of languages including C and friends, Java, Python, Bash, SQL, HTML, * XML, CSS, Javascript, and Makefiles. It works passably on Ruby, PHP and Awk * and a subset of Perl, but, because of commenting conventions, doesn't work on * Smalltalk, Lisp-like, or CAML-like languages without an explicit lang class. *
* Usage:
} and {@code } tags in your source with
* {@code class=prettyprint.}
* You can also use the (html deprecated) {@code } tag, but the pretty
* printer needs to do more substantial DOM manipulations to support that, so
* some css styles may not be preserved.
* </ol>
* That's it. I wanted to keep the API as simple as possible, so there's no
* need to specify which language the code is in, but if you wish, you can add
* another class to the {@code <pre>} or {@code <code>} element to specify the
* language, as in {@code <pre class="prettyprint lang-java">}. Any class that
* starts with "lang-" followed by a file extension, specifies the file type.
* See the "lang-*.js" files in this directory for code that implements
* per-language file handlers.
* <p>
* Change log:<br>
* cbeust, 2006/08/22
* <blockquote>
* Java annotations (start with "@") are now captured as literals ("lit")
* </blockquote>
* @requires console
*/
// JSLint declarations
/*global console, document, navigator, setTimeout, window, define */
/**
* Split {@code prettyPrint} into multiple timeouts so as not to interfere with
* UI events.
* If set to {@code false}, {@code prettyPrint()} is synchronous.
*/
window['PR_SHOULD_USE_CONTINUATION'] = true;
/**
* Find all the {@code <pre>} and {@code <code>} tags in the DOM with
* {@code class=prettyprint} and prettify them.
*
* @param {Function?} opt_whenDone if specified, called when the last entry
* has been finished.
*/
var prettyPrintOne;
/**
* Pretty print a chunk of code.
*
* @param {string} sourceCodeHtml code as html
* @return {string} code as html, but prettier
*/
var prettyPrint;
(function () {
var win = window;
// Keyword lists for various languages.
// We use things that coerce to strings to make them compact when minified
// and to defeat aggressive optimizers that fold large string constants.
var FLOW_CONTROL_KEYWORDS = ["break,continue,do,else,for,if,return,while"];
var C_KEYWORDS = [FLOW_CONTROL_KEYWORDS,"auto,case,char,const,default," +
"double,enum,extern,float,goto,int,long,register,short,signed,sizeof,module," +
"static,struct,switch,typedef,union,unsigned,void,volatile"];
var COMMON_KEYWORDS = [C_KEYWORDS,"catch,class,delete,false,import," +
"new,operator,private,protected,public,this,throw,true,try,typeof"];
var CPP_KEYWORDS = [COMMON_KEYWORDS,"alignof,align_union,asm,axiom,bool," +
"concept,concept_map,const_cast,constexpr,decltype," +
"dynamic_cast,explicit,export,friend,inline,late_check," +
"mutable,namespace,nullptr,reinterpret_cast,static_assert,static_cast," +
"template,typeid,typename,using,virtual,where,request_req"];
var JAVA_KEYWORDS = [COMMON_KEYWORDS,
"abstract,boolean,byte,extends,final,finally,implements,import," +
"instanceof,null,native,package,strictfp,super,synchronized,throws," +
"transient"];
var CSHARP_KEYWORDS = [JAVA_KEYWORDS,
"as,base,by,checked,decimal,delegate,descending,dynamic,event," +
"fixed,foreach,from,group,implicit,in,interface,internal,into,is,let," +
"lock,object,out,override,orderby,params,partial,readonly,ref,sbyte," +
"sealed,stackalloc,string,select,uint,ulong,unchecked,unsafe,ushort," +
"var,virtual,where"];
var COFFEE_KEYWORDS = "all,and,by,catch,class,else,extends,false,finally," +
"for,if,in,is,isnt,loop,new,no,not,null,of,off,on,or,return,super,then," +
"throw,true,try,unless,until,when,while,yes";
var JSCRIPT_KEYWORDS = [COMMON_KEYWORDS,
"debugger,eval,export,function,get,null,set,undefined,var,with," +
"Infinity,NaN"];
var PERL_KEYWORDS = "caller,delete,die,do,dump,else,elsif,eval,exit,foreach,for," +
"goto,if,import,last,local,my,next,no,our,print,printf,package,redo,require," +
"sub,undef,unless,until,use,wantarray,while,BEGIN,END";
var PHP_KEYWORDS = "abstract,and,array,as,break,case,catch,cfunction,class," +
"clone,const,continue,declare,default,do,else,elseif,enddeclare,endfor," +
"endforeach,endif,endswitch,endwhile,extends,final,for,foreach,function," +
"global,goto,if,implements,interface,instanceof,namespace,new,old_function," +
"or,private,protected,public,static,switch,throw,try,use,var,while,xor," +
"die,echo,empty,exit,eval,include,include_once,isset,list,require," +
"require_once,return,print,unset";
var PYTHON_KEYWORDS = [FLOW_CONTROL_KEYWORDS, "and,as,assert,class,def,del," +
"elif,except,exec,finally,from,global,import,in,is,lambda," +
"nonlocal,not,or,pass,print,raise,try,with,yield," +
"False,True,None"];
var RUBY_KEYWORDS = [FLOW_CONTROL_KEYWORDS, "alias,and,begin,case,class," +
"def,defined,elsif,end,ensure,false,in,module,next,nil,not,or,redo," +
"rescue,retry,self,super,then,true,undef,unless,until,when,yield," +
"BEGIN,END"];
var SH_KEYWORDS = [FLOW_CONTROL_KEYWORDS, "case,done,elif,esac,eval,fi," +
"function,in,local,set,then,until,echo"];
var CONFIG_ENVS = ["User-Agent,HTTP_USER_AGENT,HTTP_REFERER,HTTP_COOKIE,HTTP_FORWARDED,HTTP_HOST,HTTP_PROXY_CONNECTION,HTTP_ACCEPT,REMOTE_ADDR,REMOTE_HOST,REMOTE_PORT,REMOTE_USER,REMOTE_IDENT,REQUEST_METHOD,SCRIPT_FILENAME,PATH_INFO,QUERY_STRING,AUTH_TYPE,DOCUMENT_ROOT,SERVER_ADMIN,SERVER_NAME,SERVER_ADDR,SERVER_PORT,SERVER_PROTOCOL,SERVER_SOFTWARE,TIME_YEAR,TIME_MON,TIME_DAY,TIME_HOUR,TIME_MIN,TIME_SEC,TIME_WDAY,TIME,API_VERSION,THE_REQUEST,REQUEST_URI,REQUEST_FILENAME,IS_SUBREQ,HTTPS,REQUEST_SCHEME"];
var CONFIG_KEYWORDS = ["AcceptFilter,AcceptPathInfo,AccessFileName,Action,AddAlt,AddAltByEncoding,AddAltByType,AddCharset,AddDefaultCharset,AddDescription,AddEncoding,AddHandler,AddIcon,AddIconByEncoding,AddIconByType,AddInputFilter,AddLanguage,AddModuleInfo,AddOutputFilter,AddOutputFilterByType,AddType,Alias,AliasMatch,Allow,AllowCONNECT,AllowEncodedSlashes,AllowMethods,AllowOverride,AllowOverrideList,Anonymous,Anonymous_LogEmail,Anonymous_MustGiveEmail,Anonymous_NoUserID,Anonymous_VerifyEmail,AsyncRequestWorkerFactor,AuthBasicAuthoritative,AuthBasicFake,AuthBasicProvider,AuthBasicUseDigestAlgorithm,AuthDBDUserPWQuery,AuthDBDUserRealmQuery,AuthDBMGroupFile,AuthDBMType,AuthDBMUserFile,AuthDigestAlgorithm,AuthDigestDomain,AuthDigestNonceLifetime,AuthDigestProvider,AuthDigestQop,AuthDigestShmemSize,AuthFormAuthoritative,AuthFormBody,AuthFormDisableNoStore,AuthFormFakeBasicAuth,AuthFormLocation,AuthFormLoginRequiredLocation,AuthFormLoginSuccessLocation,AuthFormLogoutLocation,AuthFormMethod,AuthFormMimetype,AuthFormPassword,AuthFormProvider,AuthFormSitePassphrase,AuthFormSize,AuthFormUsername,AuthGroupFile,AuthLDAPAuthorizePrefix,AuthLDAPBindAuthoritative,AuthLDAPBindDN,AuthLDAPBindPassword,AuthLDAPCharsetConfig,AuthLDAPCompareAsUser,AuthLDAPCompareDNOnServer,AuthLDAPDereferenceAliases,AuthLDAPGroupAttribute,AuthLDAPGroupAttributeIsDN,AuthLDAPInitialBindAsUser,AuthLDAPInitialBindPattern,AuthLDAPMaxSubGroupDepth,AuthLDAPRemoteUserAttribute,AuthLDAPRemoteUserIsDN,AuthLDAPSearchAsUser,AuthLDAPSubGroupAttribute,AuthLDAPSubGroupClass,AuthLDAPURL,AuthMerging,AuthName,AuthnCacheContext,AuthnCacheEnable,AuthnCacheProvideFor,AuthnCacheSOCache,AuthnCacheTimeout,<AuthnProviderAlias>,AuthnzFcgiCheckAuthnProvider,AuthnzFcgiDefineProvider,AuthType,AuthUserFile,AuthzDBDLoginToReferer,AuthzDBDQuery,AuthzDBDRedirectQuery,AuthzDBMType,<AuthzProviderAlias>,AuthzSendForbiddenOnFailure,BalancerGrowth,BalancerInherit,BalancerMember,BalancerPersist,BrotliAlterETag,BrotliCompressionMaxInputBlock,BrotliCompressionQuality,BrotliCompressionWindow,BrotliFilterNote,BrowserMatch,BrowserMatchNoCase,BufferedLogs,BufferSize,CacheDefaultExpire,CacheDetailHeader,CacheDirLength,CacheDirLevels,CacheDisable,CacheEnable,CacheFile,CacheHeader,CacheIgnoreCacheControl,CacheIgnoreHeaders,CacheIgnoreNoLastMod,CacheIgnoreQueryString,CacheIgnoreURLSessionIdentifiers,CacheKeyBaseURL,CacheLastModifiedFactor,CacheLock,CacheLockMaxAge,CacheLockPath,CacheMaxExpire,CacheMaxFileSize,CacheMinExpire,CacheMinFileSize,CacheNegotiatedDocs,CacheQuickHandler,CacheReadSize,CacheReadTime,CacheRoot,CacheSocache,CacheSocacheMaxSize,CacheSocacheMaxTime,CacheSocacheMinTime,CacheSocacheReadSize,CacheSocacheReadTime,CacheStaleOnError,CacheStoreExpired,CacheStoreNoStore,CacheStorePrivate,CGIDScriptTimeout,CGIMapExtension,CGIPassAuth,CGIScriptTimeout,CGIVar,CharsetDefault,CharsetOptions,CharsetSourceEnc,CheckBasenameMatch,CheckCaseOnly,CheckSpelling,ChrootDir,ContentDigest,CookieDomain,CookieExpires,CookieHTTPOnly,CookieName,CookieSameSite,CookieSecure,CookieStyle,CookieTracking,CoreDumpDirectory,CustomLog,Dav,DavBasePath,DavDepthInfinity,DavGenericLockDB,DavLockDB,DavLockDiscovery,DavMinTimeout,DBDExptime,DBDInitSQL,DBDKeep,DBDMax,DBDMin,DBDParams,DBDPersist,DBDPrepareSQL,DBDriver,DefaultIcon,DefaultLanguage,DefaultRuntimeDir,DefaultType,Define,DeflateAlterETag,DeflateBufferSize,DeflateCompressionLevel,DeflateFilterNote,DeflateInflateLimitRequestBody,DeflateInflateRatioBurst,DeflateInflateRatioLimit,DeflateMemLevel,DeflateWindowSize,Deny,<Directory>,DirectoryCheckHandler,DirectoryIndex,DirectoryIndexRedirect,<DirectoryMatch>,DirectorySlash,DocumentRoot,DTracePrivileges,DumpIOInput,DumpIOOutput,<Else>,<ElseIf>,EnableExceptionHook,EnableMMAP,EnableSendfile,Error,ErrorDocument,ErrorLog,ErrorLogFormat,Example,ExpiresActive,ExpiresByType,ExpiresDefault,ExtendedStatus,ExtFilterDefine,ExtFilterOptions,FallbackResource,FileETag,<Files>,<FilesMatch>,FilterChain,FilterDeclare,FilterProtocol,FilterProvider,FilterTrace,FlushMaxPipelined,FlushMaxThreshold,ForceLanguagePriority,ForceType,ForensicLog,GlobalLog,GprofDir,GracefulShutdownTimeout,Group,H2CopyFiles,H2Direct,H2EarlyHint,H2EarlyHints,H2MaxDataFrameLen,H2MaxSessionStreams,H2MaxWorkerIdleSeconds,H2MaxWorkers,H2MinWorkers,H2ModernTLSOnly,H2OutputBuffering,H2Padding,H2ProxyRequests,H2Push,H2PushDiarySize,H2PushPriority,H2PushResource,H2SerializeHeaders,H2StreamMaxMemSize,H2StreamTimeout,H2TLSCoolDownSecs,H2TLSWarmUpSize,H2Upgrade,H2WebSockets,H2WindowSize,Header,HeaderName,HeartbeatAddress,HeartbeatListen,HeartbeatMaxServers,HeartbeatStorage,HeartbeatStorage,HostnameLookups,HttpProtocolOptions,IdentityCheck,IdentityCheckTimeout,<If>,<IfDefine>,<IfDirective>,<IfFile>,<IfModule>,<IfSection>,<IfVersion>,ImapBase,ImapDefault,ImapMenu,Include,IncludeOptional,IndexHeadInsert,IndexIgnore,IndexIgnoreReset,IndexOptions,IndexOrderDefault,IndexStyleSheet,InputSed,ISAPIAppendLogToErrors,ISAPIAppendLogToQuery,ISAPICacheFile,ISAPIFakeAsync,ISAPILogNotSupported,ISAPIReadAheadBuffer,KeepAlive,KeepAliveTimeout,KeptBodySize,LanguagePriority,LDAPCacheEntries,LDAPCacheTTL,LDAPConnectionPoolTTL,LDAPConnectionTimeout,LDAPLibraryDebug,LDAPOpCacheEntries,LDAPOpCacheTTL,LDAPReferralHopLimit,LDAPReferrals,LDAPRetries,LDAPRetryDelay,LDAPSharedCacheFile,LDAPSharedCacheSize,LDAPTimeout,LDAPTrustedClientCert,LDAPTrustedGlobalCert,LDAPTrustedMode,LDAPVerifyServerCert,<Limit>,<LimitExcept>,LimitInternalRecursion,LimitRequestBody,LimitRequestFields,LimitRequestFieldSize,LimitRequestLine,LimitXMLRequestBody,Listen,ListenBackLog,ListenCoresBucketsRatio,LoadFile,LoadModule,<Location>,<LocationMatch>,LogFormat,LogIOTrackTTFB,LogLevel,LogMessage,LuaAuthzProvider,LuaCodeCache,LuaHookAccessChecker,LuaHookAuthChecker,LuaHookCheckUserID,LuaHookFixups,LuaHookInsertFilter,LuaHookLog,LuaHookMapToStorage,LuaHookPreTranslate,LuaHookTranslateName,LuaHookTypeChecker,LuaInherit,LuaInputFilter,LuaMapHandler,LuaOutputFilter,LuaPackageCPath,LuaPackagePath,LuaQuickHandler,LuaRoot,LuaScope,<Macro>,MaxConnectionsPerChild,MaxKeepAliveRequests,MaxMemFree,MaxRangeOverlaps,MaxRangeReversals,MaxRanges,MaxRequestWorkers,MaxSpareServers,MaxSpareThreads,MaxThreads,MDActivationDelay,MDBaseServer,MDCAChallenges,MDCertificateAgreement,MDCertificateAuthority,MDCertificateCheck,MDCertificateFile,MDCertificateKeyFile,MDCertificateMonitor,MDCertificateProtocol,MDCertificateStatus,MDChallengeDns01,MDChallengeDns01Version,MDContactEmail,MDDriveMode,MDExternalAccountBinding,MDHttpProxy,MDMatchNames,MDMember,MDMembers,MDMessageCmd,MDMustStaple,MDNotifyCmd,MDomain,<MDomainSet>,MDPortMap,MDPrivateKeys,MDRenewMode,MDRenewWindow,MDRequireHttps,MDRetryDelay,MDRetryFailover,MDServerStatus,MDStapleOthers,MDStapling,MDStaplingKeepResponse,MDStaplingRenewWindow,MDStoreDir,MDStoreLocks,MDWarnWindow,MemcacheConnTTL,MergeSlashes,MergeTrailers,MetaDir,MetaFiles,MetaSuffix,MimeMagicFile,MinSpareServers,MinSpareThreads,MMapFile,ModemStandard,ModMimeUsePathInfo,MultiviewsMatch,Mutex,NameVirtualHost,NoProxy,NWSSLTrustedCerts,NWSSLUpgradeable,Options,Order,OutputSed,PassEnv,PidFile,PrivilegesMode,Protocol,ProtocolEcho,Protocols,ProtocolsHonorOrder,<Proxy>,Proxy100Continue,ProxyAddHeaders,ProxyBadHeader,ProxyBlock,ProxyDomain,ProxyErrorOverride,ProxyExpressDBMFile,ProxyExpressDBMType,ProxyExpressEnable,ProxyFCGIBackendType,ProxyFCGISetEnvIf,ProxyFtpDirCharset,ProxyFtpEscapeWildcards,ProxyFtpListOnWildcard,ProxyHCExpr,ProxyHCTemplate,ProxyHCTPsize,ProxyHTMLBufSize,ProxyHTMLCharsetOut,ProxyHTMLDocType,ProxyHTMLEnable,ProxyHTMLEvents,ProxyHTMLExtended,ProxyHTMLFixups,ProxyHTMLInterp,ProxyHTMLLinks,ProxyHTMLMeta,ProxyHTMLStripComments,ProxyHTMLURLMap,ProxyIOBufferSize,<ProxyMatch>,ProxyMaxForwards,ProxyPass,ProxyPassInherit,ProxyPassInterpolateEnv,ProxyPassMatch,ProxyPassReverse,ProxyPassReverseCookieDomain,ProxyPassReverseCookiePath,ProxyPreserveHost,ProxyReceiveBufferSize,ProxyRemote,ProxyRemoteMatch,ProxyRequests,ProxySCGIInternalRedirect,ProxySCGISendfile,ProxySet,ProxySourceAddress,ProxyStatus,ProxyTimeout,ProxyVia,ProxyWebsocketFallbackToProxyHttp,QualifyRedirectURL,ReadBufferSize,ReadmeName,ReceiveBufferSize,Redirect,RedirectMatch,RedirectPermanent,RedirectRelative,RedirectTemp,RedisConnPoolTTL,RedisTimeout,ReflectorHeader,RegexDefaultOptions,RegisterHttpMethod,RemoteIPHeader,RemoteIPInternalProxy,RemoteIPInternalProxyList,RemoteIPProxiesHeader,RemoteIPProxyProtocol,RemoteIPProxyProtocolExceptions,RemoteIPTrustedProxy,RemoteIPTrustedProxyList,RemoveCharset,RemoveEncoding,RemoveHandler,RemoveInputFilter,RemoveLanguage,RemoveOutputFilter,RemoveType,RequestHeader,RequestReadTimeout,Require,<RequireAll>,<RequireAny>,<RequireNone>,RewriteBase,RewriteCond,RewriteEngine,RewriteMap,RewriteOptions,RewriteRule,RLimitCPU,RLimitMEM,RLimitNPROC,Satisfy,ScoreBoardFile,Script,ScriptAlias,ScriptAliasMatch,ScriptInterpreterSource,ScriptLog,ScriptLogBuffer,ScriptLogLength,ScriptSock,SecureListen,SeeRequestTail,SendBufferSize,ServerAdmin,ServerAlias,ServerLimit,ServerName,ServerPath,ServerRoot,ServerSignature,ServerTokens,Session,SessionCookieName,SessionCookieName2,SessionCookieRemove,SessionCryptoCipher,SessionCryptoDriver,SessionCryptoPassphrase,SessionCryptoPassphraseFile,SessionDBDCookieName,SessionDBDCookieName2,SessionDBDCookieRemove,SessionDBDDeleteLabel,SessionDBDInsertLabel,SessionDBDPerUser,SessionDBDSelectLabel,SessionDBDUpdateLabel,SessionEnv,SessionExclude,SessionExpiryUpdateInterval,SessionHeader,SessionInclude,SessionMaxAge,SetEnv,SetEnvIf,SetEnvIfExpr,SetEnvIfNoCase,SetHandler,SetInputFilter,SetOutputFilter,SSIEndTag,SSIErrorMsg,SSIETag,SSILastModified,SSILegacyExprParser,SSIStartTag,SSITimeFormat,SSIUndefinedEcho,SSLCACertificateFile,SSLCACertificatePath,SSLCADNRequestFile,SSLCADNRequestPath,SSLCARevocationCheck,SSLCARevocationFile,SSLCARevocationPath,SSLCertificateChainFile,SSLCertificateFile,SSLCertificateKeyFile,SSLCipherSuite,SSLCompression,SSLCryptoDevice,SSLEngine,SSLFIPS,SSLHonorCipherOrder,SSLInsecureRenegotiation,SSLOCSPDefaultResponder,SSLOCSPEnable,SSLOCSPNoverify,SSLOCSPOverrideResponder,SSLOCSPProxyURL,SSLOCSPResponderCertificateFile,SSLOCSPResponderTimeout,SSLOCSPResponseMaxAge,SSLOCSPResponseTimeSkew,SSLOCSPUseRequestNonce,SSLOpenSSLConfCmd,SSLOptions,SSLPassPhraseDialog,SSLProtocol,SSLProxyCACertificateFile,SSLProxyCACertificatePath,SSLProxyCARevocationCheck,SSLProxyCARevocationFile,SSLProxyCARevocationPath,SSLProxyCheckPeerCN,SSLProxyCheckPeerExpire,SSLProxyCheckPeerName,SSLProxyCipherSuite,SSLProxyEngine,SSLProxyMachineCertificateChainFile,SSLProxyMachineCertificateFile,SSLProxyMachineCertificatePath,SSLProxyProtocol,SSLProxyVerify,SSLProxyVerifyDepth,SSLRandomSeed,SSLRenegBufferSize,SSLRequire,SSLRequireSSL,SSLSessionCache,SSLSessionCacheTimeout,SSLSessionTicketKeyFile,SSLSessionTickets,SSLSRPUnknownUserSeed,SSLSRPVerifierFile,SSLStaplingCache,SSLStaplingErrorCacheTimeout,SSLStaplingFakeTryLater,SSLStaplingForceURL,SSLStaplingResponderTimeout,SSLStaplingResponseMaxAge,SSLStaplingResponseTimeSkew,SSLStaplingReturnResponderErrors,SSLStaplingStandardCacheTimeout,SSLStrictSNIVHostCheck,SSLUserName,SSLUseStapling,SSLVerifyClient,SSLVerifyDepth,StartServers,StartThreads,StrictHostCheck,Substitute,SubstituteInheritBefore,SubstituteMaxLineLength,Suexec,SuexecUserGroup,ThreadLimit,ThreadsPerChild,ThreadStackSize,TimeOut,TraceEnable,TransferLog,TypesConfig,UNCList,UnDefine,UndefMacro,UnsetEnv,Use,UseCanonicalName,UseCanonicalPhysicalPort,User,UserDir,VHostCGIMode,VHostCGIPrivs,VHostGroup,VHostPrivs,VHostSecure,VHostUser,VirtualDocumentRoot,VirtualDocumentRootIP,<VirtualHost>,VirtualScriptAlias,VirtualScriptAliasIP,WatchdogInterval,XBitHack,xml2EncAlias,xml2EncDefault,xml2StartParse"];
var CONFIG_OPTIONS = /^[\\+\\-]?(AuthConfig|IncludesNOEXEC|ExecCGI|FollowSymLinks|MultiViews|Includes|Indexes|SymLinksIfOwnerMatch)\b/i;
var ALL_KEYWORDS = [
CPP_KEYWORDS, CSHARP_KEYWORDS, JSCRIPT_KEYWORDS, PERL_KEYWORDS +
PYTHON_KEYWORDS, RUBY_KEYWORDS, SH_KEYWORDS, CONFIG_KEYWORDS, PHP_KEYWORDS];
var C_TYPES = /^(DIR|FILE|vector|(de|priority_)?queue|list|stack|(const_)?iterator|(multi)?(set|map)|bitset|u?(int|float|char|void|const|static|struct)\d*(_t)?\b)|[a-z_]+_rec|cmd_parms\b/;
// token style names. correspond to css classes
/**
* token style for a string literal
* @const
*/
var PR_STRING = 'str';
/**
* token style for a keyword
* @const
*/
var PR_KEYWORD = 'kwd';
/**
* token style for a comment
* @const
*/
var PR_COMMENT = 'com';
/**
* token style for a type
* @const
*/
var PR_TYPE = 'typ';
/**
* token style for a literal value. e.g. 1, null, true.
* @const
*/
var PR_LITERAL = 'lit';
/**
* token style for a punctuation string.
* @const
*/
var PR_PUNCTUATION = 'pun';
/**
* token style for plain text.
* @const
*/
var PR_PLAIN = 'pln';
/**
* token style for an sgml tag.
* @const
*/
var PR_TAG = 'tag';
/**
* token style for a markup declaration such as a DOCTYPE.
* @const
*/
var PR_DECLARATION = 'dec';
/**
* token style for embedded source.
* @const
*/
var PR_SOURCE = 'src';
/**
* token style for an sgml attribute name.
* @const
*/
var PR_ATTRIB_NAME = 'atn';
/**
* token style for an sgml attribute value.
* @const
*/
var PR_ATTRIB_VALUE = 'atv';
/**
* A class that indicates a section of markup that is not code, e.g. to allow
* embedding of line numbers within code listings.
* @const
*/
var PR_NOCODE = 'nocode';
/**
* A set of tokens that can precede a regular expression literal in
* javascript
* http://web.archive.org/web/20070717142515/http://www.mozilla.org/js/language/js20/rationale/syntax.html
* has the full list, but I've removed ones that might be problematic when
* seen in languages that don't support regular expression literals.
*
* <p>Specifically, I've removed any keywords that can't precede a regexp
* literal in a syntactically legal javascript program, and I've removed the
* "in" keyword since it's not a keyword in many languages, and might be used
* as a count of inches.
*
* <p>The link above does not accurately describe EcmaScript rules since
* it fails to distinguish between (a=++/b/i) and (a++/b/i) but it works
* very well in practice.
*
* @private
* @const
*/
var REGEXP_PRECEDER_PATTERN = '(?:^^\\.?|[+-]|[!=]=?=?|\\#|%=?|&&?=?|\\(|\\*=?|[+\\-]=|->|\\/=?|::?|<<?=?|>>?>?=?|,|;|\\?|@|\\[|~|{|\\^\\^?=?|\\|\\|?=?|break|case|continue|delete|do|else|finally|instanceof|return|throw|try|typeof)\\s*';
// CAVEAT: this does not properly handle the case where a regular
// expression immediately follows another since a regular expression may
// have flags for case-sensitivity and the like. Having regexp tokens
// adjacent is not valid in any language I'm aware of, so I'm punting.
// TODO: maybe style special characters inside a regexp as punctuation.
/**
* Given a group of {@link RegExp}s, returns a {@code RegExp} that globally
* matches the union of the sets of strings matched by the input RegExp.
* Since it matches globally, if the input strings have a start-of-input
* anchor (/^.../), it is ignored for the purposes of unioning.
* @param {Array.<RegExp>} regexs non multiline, non-global regexs.
* @return {RegExp} a global regex.
*/
function combinePrefixPatterns(regexs) {
var capturedGroupIndex = 0;
var needToFoldCase = false;
var ignoreCase = false;
for (var i = 0, n = regexs.length; i < n; ++i) {
var regex = regexs[i];
if (regex.ignoreCase) {
ignoreCase = true;
} else if (/[a-z]/i.test(regex.source.replace(
/\\u[0-9a-f]{4}|\\x[0-9a-f]{2}|\\[^ux]/gi, ''))) {
needToFoldCase = true;
ignoreCase = false;
break;
}
}
var escapeCharToCodeUnit = {
'b': 8,
't': 9,
'n': 0xa,
'v': 0xb,
'f': 0xc,
'r': 0xd
};
function decodeEscape(charsetPart) {
var cc0 = charsetPart.charCodeAt(0);
if (cc0 !== 92 /* \\ */) {
return cc0;
}
var c1 = charsetPart.charAt(1);
cc0 = escapeCharToCodeUnit[c1];
if (cc0) {
return cc0;
} else if ('0' <= c1 && c1 <= '7') {
return parseInt(charsetPart.substring(1), 8);
} else if (c1 === 'u' || c1 === 'x') {
return parseInt(charsetPart.substring(2), 16);
} else {
return charsetPart.charCodeAt(1);
}
}
function encodeEscape(charCode) {
if (charCode < 0x20) {
return (charCode < 0x10 ? '\\x0' : '\\x') + charCode.toString(16);
}
var ch = String.fromCharCode(charCode);
return (ch === '\\' || ch === '-' || ch === ']' || ch === '^')
? "\\" + ch : ch;
}
function caseFoldCharset(charSet) {
var charsetParts = charSet.substring(1, charSet.length - 1).match(
new RegExp(
'\\\\u[0-9A-Fa-f]{4}'
+ '|\\\\x[0-9A-Fa-f]{2}'
+ '|\\\\[0-3][0-7]{0,2}'
+ '|\\\\[0-7]{1,2}'
+ '|\\\\[\\s\\S]'
+ '|-'
+ '|[^-\\\\]',
'g'));
var ranges = [];
var inverse = charsetParts[0] === '^';
var out = ['['];
if (inverse) { out.push('^'); }
for (var i = inverse ? 1 : 0, n = charsetParts.length; i < n; ++i) {
var p = charsetParts[i];
if (/\\[bdsw]/i.test(p)) { // Don't muck with named groups.
out.push(p);
} else {
var start = decodeEscape(p);
var end;
if (i + 2 < n && '-' === charsetParts[i + 1]) {
end = decodeEscape(charsetParts[i + 2]);
i += 2;
} else {
end = start;
}
ranges.push([start, end]);
// If the range might intersect letters, then expand it.
// This case handling is too simplistic.
// It does not deal with non-latin case folding.
// It works for latin source code identifiers though.
if (!(end < 65 || start > 122)) {
if (!(end < 65 || start > 90)) {
ranges.push([Math.max(65, start) | 32, Math.min(end, 90) | 32]);
}
if (!(end < 97 || start > 122)) {
ranges.push([Math.max(97, start) & ~32, Math.min(end, 122) & ~32]);
}
}
}
}
// [[1, 10], [3, 4], [8, 12], [14, 14], [16, 16], [17, 17]]
// -> [[1, 12], [14, 14], [16, 17]]
ranges.sort(function (a, b) { return (a[0] - b[0]) || (b[1] - a[1]); });
var consolidatedRanges = [];
var lastRange = [];
for (var i = 0; i < ranges.length; ++i) {
var range = ranges[i];
if (range[0] <= lastRange[1] + 1) {
lastRange[1] = Math.max(lastRange[1], range[1]);
} else {
consolidatedRanges.push(lastRange = range);
}
}
for (var i = 0; i < consolidatedRanges.length; ++i) {
var range = consolidatedRanges[i];
out.push(encodeEscape(range[0]));
if (range[1] > range[0]) {
if (range[1] + 1 > range[0]) { out.push('-'); }
out.push(encodeEscape(range[1]));
}
}
out.push(']');
return out.join('');
}
function allowAnywhereFoldCaseAndRenumberGroups(regex) {
// Split into character sets, escape sequences, punctuation strings
// like ('(', '(?:', ')', '^'), and runs of characters that do not
// include any of the above.
var parts = regex.source.match(
new RegExp(
'(?:'
+ '\\[(?:[^\\x5C\\x5D]|\\\\[\\s\\S])*\\]' // a character set
+ '|\\\\u[A-Fa-f0-9]{4}' // a unicode escape
+ '|\\\\x[A-Fa-f0-9]{2}' // a hex escape
+ '|\\\\[0-9]+' // a back-reference or octal escape
+ '|\\\\[^ux0-9]' // other escape sequence
+ '|\\(\\?[:!=]' // start of a non-capturing group
+ '|[\\(\\)\\^]' // start/end of a group, or line start
+ '|[^\\x5B\\x5C\\(\\)\\^]+' // run of other characters
+ ')',
'g'));
var n = parts.length;
// Maps captured group numbers to the number they will occupy in
// the output or to -1 if that has not been determined, or to
// undefined if they need not be capturing in the output.
var capturedGroups = [];
// Walk over and identify back references to build the capturedGroups
// mapping.
for (var i = 0, groupIndex = 0; i < n; ++i) {
var p = parts[i];
if (p === '(') {
// groups are 1-indexed, so max group index is count of '('
++groupIndex;
} else if ('\\' === p.charAt(0)) {
var decimalValue = +p.substring(1);
if (decimalValue) {
if (decimalValue <= groupIndex) {
capturedGroups[decimalValue] = -1;
} else {
// Replace with an unambiguous escape sequence so that
// an octal escape sequence does not turn into a backreference
// to a capturing group from an earlier regex.
parts[i] = encodeEscape(decimalValue);
}
}
}
}
// Renumber groups and reduce capturing groups to non-capturing groups
// where possible.
for (var i = 1; i < capturedGroups.length; ++i) {
if (-1 === capturedGroups[i]) {
capturedGroups[i] = ++capturedGroupIndex;
}
}
for (var i = 0, groupIndex = 0; i < n; ++i) {
var p = parts[i];
if (p === '(') {
++groupIndex;
if (!capturedGroups[groupIndex]) {
parts[i] = '(?:';
}
} else if ('\\' === p.charAt(0)) {
var decimalValue = +p.substring(1);
if (decimalValue && decimalValue <= groupIndex) {
parts[i] = '\\' + capturedGroups[decimalValue];
}
}
}
// Remove any prefix anchors so that the output will match anywhere.
// ^^ really does mean an anchored match though.
for (var i = 0; i < n; ++i) {
if ('^' === parts[i] && '^' !== parts[i + 1]) { parts[i] = ''; }
}
// Expand letters to groups to handle mixing of case-sensitive and
// case-insensitive patterns if necessary.
if (regex.ignoreCase && needToFoldCase) {
for (var i = 0; i < n; ++i) {
var p = parts[i];
var ch0 = p.charAt(0);
if (p.length >= 2 && ch0 === '[') {
parts[i] = caseFoldCharset(p);
} else if (ch0 !== '\\') {
// TODO: handle letters in numeric escapes.
parts[i] = p.replace(
/[a-zA-Z]/g,
function (ch) {
var cc = ch.charCodeAt(0);
return '[' + String.fromCharCode(cc & ~32, cc | 32) + ']';
});
}
}
}
return parts.join('');
}
var rewritten = [];
for (var i = 0, n = regexs.length; i < n; ++i) {
var regex = regexs[i];
if (regex.global || regex.multiline) { throw new Error('' + regex); }
rewritten.push(
'(?:' + allowAnywhereFoldCaseAndRenumberGroups(regex) + ')');
}
return new RegExp(rewritten.join('|'), ignoreCase ? 'gi' : 'g');
}
/**
* Split markup into a string of source code and an array mapping ranges in
* that string to the text nodes in which they appear.
*
* <p>
* The HTML DOM structure:</p>
* <pre>
* (Element "p"
* (Element "b"
* (Text "print ")) ; #1
* (Text "'Hello '") ; #2
* (Element "br") ; #3
* (Text " + 'World';")) ; #4
* </pre>
* <p>
* corresponds to the HTML
* {@code <p><b>print </b>'Hello '<br> + 'World';</p>}.</p>
*
* <p>
* It will produce the output:</p>
* <pre>
* {
* sourceCode: "print 'Hello '\n + 'World';",
* // 1 2
* // 012345678901234 5678901234567
* spans: [0, #1, 6, #2, 14, #3, 15, #4]
* }
* </pre>
* <p>
* where #1 is a reference to the {@code "print "} text node above, and so
* on for the other text nodes.
* </p>
*
* <p>
* The {@code} spans array is an array of pairs. Even elements are the start
* indices of substrings, and odd elements are the text nodes (or BR elements)
* that contain the text for those substrings.
* Substrings continue until the next index or the end of the source.
* </p>
*
* @param {Node} node an HTML DOM subtree containing source-code.
* @param {boolean} isPreformatted true if white-space in text nodes should
* be considered significant.
* @return {Object} source code and the text nodes in which they occur.
*/
function extractSourceSpans(node, isPreformatted) {
var nocode = /(?:^|\s)nocode(?:\s|$)/;
var chunks = [];
var length = 0;
var spans = [];
var k = 0;
function walk(node) {
switch (node.nodeType) {
case 1: // Element
if (nocode.test(node.className)) { return; }
for (var child = node.firstChild; child; child = child.nextSibling) {
walk(child);
}
var nodeName = node.nodeName.toLowerCase();
if ('br' === nodeName || 'li' === nodeName) {
chunks[k] = '\n';
spans[k << 1] = length++;
spans[(k++ << 1) | 1] = node;
}
break;
case 3: case 4: // Text
var text = node.nodeValue;
if (text.length) {
if (!isPreformatted) {
text = text.replace(/[ \t\r\n]+/g, ' ');
} else {
text = text.replace(/\r\n?/g, '\n'); // Normalize newlines.
text = text.replace(/^(\r?\n\s*)+/g, ''); // Remove leading newlines
text = text.replace(/^\s*/g, ''); // Remove leading spaces due to indented formatting
text = text.replace(/(\r?\n\s*)+$/g, ''); // Remove ending newlines
}
// TODO: handle tabs here?
chunks[k] = text;
spans[k << 1] = length;
length += text.length;
spans[(k++ << 1) | 1] = node;
}
break;
}
}
walk(node);
return {
sourceCode: chunks.join('').replace(/\n$/, ''),
spans: spans
};
}
/**
* Apply the given language handler to sourceCode and add the resulting
* decorations to out.
* @param {number} basePos the index of sourceCode within the chunk of source
* whose decorations are already present on out.
*/
function appendDecorations(basePos, sourceCode, langHandler, out) {
if (!sourceCode) { return; }
var job = {
sourceCode: sourceCode,
basePos: basePos
};
langHandler(job);
out.push.apply(out, job.decorations);
}
var notWs = /\S/;
/**
* Given an element, if it contains only one child element and any text nodes
* it contains contain only space characters, return the sole child element.
* Otherwise returns undefined.
* <p>
* This is meant to return the CODE element in {@code <pre><code ...>} when
* there is a single child element that contains all the non-space textual
* content, but not to return anything where there are multiple child elements
* as in {@code <pre><code>...</code><code>...</code></pre>} or when there
* is textual content.
*/
function childContentWrapper(element) {
var wrapper = undefined;
for (var c = element.firstChild; c; c = c.nextSibling) {
var type = c.nodeType;
wrapper = (type === 1) // Element Node
? (wrapper ? element : c)
: (type === 3) // Text Node
? (notWs.test(c.nodeValue) ? element : wrapper)
: wrapper;
}
return wrapper === element ? undefined : wrapper;
}
/** Given triples of [style, pattern, context] returns a lexing function,
* The lexing function interprets the patterns to find token boundaries and
* returns a decoration list of the form
* [index_0, style_0, index_1, style_1, ..., index_n, style_n]
* where index_n is an index into the sourceCode, and style_n is a style
* constant like PR_PLAIN. index_n-1 <= index_n, and style_n-1 applies to
* all characters in sourceCode[index_n-1:index_n].
*
* The stylePatterns is a list whose elements have the form
* [style : string, pattern : RegExp, DEPRECATED, shortcut : string].
*
* Style is a style constant like PR_PLAIN, or can be a string of the
* form 'lang-FOO', where FOO is a language extension describing the
* language of the portion of the token in $1 after pattern executes.
* E.g., if style is 'lang-lisp', and group 1 contains the text
* '(hello (world))', then that portion of the token will be passed to the
* registered lisp handler for formatting.
* The text before and after group 1 will be restyled using this decorator
* so decorators should take care that this doesn't result in infinite
* recursion. For example, the HTML lexer rule for SCRIPT elements looks
* something like ['lang-js', /<[s]cript>(.+?)<\/script>/]. This may match
* '<script>foo()<\/script>', which would cause the current decorator to
* be called with '<script>' which would not match the same rule since
* group 1 must not be empty, so it would be instead styled as PR_TAG by
* the generic tag rule. The handler registered for the 'js' extension would
* then be called with 'foo()', and finally, the current decorator would
* be called with '<\/script>' which would not match the original rule and
* so the generic tag rule would identify it as a tag.
*
* Pattern must only match prefixes, and if it matches a prefix, then that
* match is considered a token with the same style.
*
* Context is applied to the last non-whitespace, non-comment token
* recognized.
*
* Shortcut is an optional string of characters, any of which, if the first
* character, guarantee that this pattern and only this pattern matches.
*
* @param {Array} shortcutStylePatterns patterns that always start with
* a known character. Must have a shortcut string.
* @param {Array} fallthroughStylePatterns patterns that will be tried in
* order if the shortcut ones fail. May have shortcuts.
*
* @return {function (Object)} a
* function that takes source code and returns a list of decorations.
*/
function createSimpleLexer(shortcutStylePatterns, fallthroughStylePatterns) {
var shortcuts = {};
var tokenizer;
(function () {
var allPatterns = shortcutStylePatterns.concat(fallthroughStylePatterns);
var allRegexs = [];
var regexKeys = {};
for (var i = 0, n = allPatterns.length; i < n; ++i) {
var patternParts = allPatterns[i];
var shortcutChars = patternParts[3];
if (shortcutChars) {
for (var c = shortcutChars.length; --c >= 0;) {
shortcuts[shortcutChars.charAt(c)] = patternParts;
}
}
var regex = patternParts[1];
var k = '' + regex;
if (!regexKeys.hasOwnProperty(k)) {
allRegexs.push(regex);
regexKeys[k] = null;
}
}
allRegexs.push(/[\0-\uffff]/);
tokenizer = combinePrefixPatterns(allRegexs);
})();
var nPatterns = fallthroughStylePatterns.length;
/**
* Lexes job.sourceCode and produces an output array job.decorations of
* style classes preceded by the position at which they start in
* job.sourceCode in order.
*
* @param {Object} job an object like <pre>{
* sourceCode: {string} sourceText plain text,
* basePos: {int} position of job.sourceCode in the larger chunk of
* sourceCode.
* }</pre>
*/
var decorate = function (job) {
var sourceCode = job.sourceCode, basePos = job.basePos;
/** Even entries are positions in source in ascending order. Odd enties
* are style markers (e.g., PR_COMMENT) that run from that position until
* the end.
* @type {Array.<number|string>}
*/
var decorations = [basePos, PR_PLAIN];
var pos = 0; // index into sourceCode
var tokens = sourceCode.match(tokenizer) || [];
var styleCache = {};
for (var ti = 0, nTokens = tokens.length; ti < nTokens; ++ti) {
var token = tokens[ti];
var style = styleCache[token];
var match = void 0;
var isEmbedded;
if (typeof style === 'string') {
isEmbedded = false;
} else {
var patternParts = shortcuts[token.charAt(0)];
if (patternParts) {
match = token.match(patternParts[1]);
style = patternParts[0];
} else {
for (var i = 0; i < nPatterns; ++i) {
patternParts = fallthroughStylePatterns[i];
match = token.match(patternParts[1]);
if (match) {
style = patternParts[0];
break;
}
}
if (!match) { // make sure that we make progress
style = PR_PLAIN;
}
}
isEmbedded = style.length >= 5 && 'lang-' === style.substring(0, 5);
if (isEmbedded && !(match && typeof match[1] === 'string')) {
isEmbedded = false;
style = PR_SOURCE;
}
if (!isEmbedded) { styleCache[token] = style; }
}
var tokenStart = pos;
pos += token.length;
if (!isEmbedded) {
decorations.push(basePos + tokenStart, style);
} else { // Treat group 1 as an embedded block of source code.
var embeddedSource = match[1];
var embeddedSourceStart = token.indexOf(embeddedSource);
var embeddedSourceEnd = embeddedSourceStart + embeddedSource.length;
if (match[2]) {
// If embeddedSource can be blank, then it would match at the
// beginning which would cause us to infinitely recurse on the
// entire token, so we catch the right context in match[2].
embeddedSourceEnd = token.length - match[2].length;
embeddedSourceStart = embeddedSourceEnd - embeddedSource.length;
}
var lang = style.substring(5);
// Decorate the left of the embedded source
appendDecorations(
basePos + tokenStart,
token.substring(0, embeddedSourceStart),
decorate, decorations);
// Decorate the embedded source
appendDecorations(
basePos + tokenStart + embeddedSourceStart,
embeddedSource,
langHandlerForExtension(lang, embeddedSource),
decorations);
// Decorate the right of the embedded section
appendDecorations(
basePos + tokenStart + embeddedSourceEnd,
token.substring(embeddedSourceEnd),
decorate, decorations);
}
}
job.decorations = decorations;
};
return decorate;
}
/** returns a function that produces a list of decorations from source text.
*
* This code treats ", ', and ` as string delimiters, and \ as a string
* escape. It does not recognize perl's qq() style strings.
* It has no special handling for double delimiter escapes as in basic, or
* the tripled delimiters used in python, but should work on those regardless
* although in those cases a single string literal may be broken up into
* multiple adjacent string literals.
*
* It recognizes C, C++, and shell style comments.
*
* @param {Object} options a set of optional parameters.
* @return {function (Object)} a function that examines the source code
* in the input job and builds the decoration list.
*/
function sourceDecorator(options) {
var shortcutStylePatterns = [], fallthroughStylePatterns = [];
if (options['tripleQuotedStrings']) {
// '''multi-line-string''', 'single-line-string', and double-quoted
shortcutStylePatterns.push(
[PR_STRING, /^(?:\'\'\'(?:[^\'\\]|\\[\s\S]|\'{1,2}(?=[^\']))*(?:\'\'\'|$)|\"\"\"(?:[^\"\\]|\\[\s\S]|\"{1,2}(?=[^\"]))*(?:\"\"\"|$)|\'(?:[^\\\']|\\[\s\S])*(?:\'|$)|\"(?:[^\\\"]|\\[\s\S])*(?:\"|$))/,
null, '\'"']);
} else if (options['multiLineStrings']) {
// 'multi-line-string', "multi-line-string"
shortcutStylePatterns.push(
[PR_STRING, /^(?:\'(?:[^\\\']|\\[\s\S])*(?:\'|$)|\"(?:[^\\\"]|\\[\s\S])*(?:\"|$)|\`(?:[^\\\`]|\\[\s\S])*(?:\`|$))/,
null, '\'"`']);
} else {
// 'single-line-string', "single-line-string"
shortcutStylePatterns.push(
[PR_STRING,
/^(?:\'(?:[^\\\'\r\n]|\\.)*(?:\'|$)|\"(?:[^\\\"\r\n]|\\.)*(?:\"|$))/,
null, '"\'']);
}
if (options['verbatimStrings']) {
// verbatim-string-literal production from the C# grammar. See issue 93.
fallthroughStylePatterns.push(
[PR_STRING, /^@\"(?:[^\"]|\"\")*(?:\"|$)/, null]);
}
var hc = options['hashComments'];
if (hc) {
if (options['cStyleComments']) {
if (hc > 1) { // multiline hash comments
shortcutStylePatterns.push(
[PR_COMMENT, /^#(?:##(?:[^#]|#(?!##))*(?:###|$)|.*)/, null, '#']);
} else {
// Stop C preprocessor declarations at an unclosed open comment
shortcutStylePatterns.push(
[PR_COMMENT, /^#(?:(?:define|elif|else|endif|error|ifdef|include|ifndef|line|pragma|undef|warning)\b|[^\r\n]*)/,
null, '#']);
}
// #include <stdio.h>
fallthroughStylePatterns.push(
[PR_STRING,
/^<(?:(?:(?:\.\.\/)*|\/?)(?:[\w-]+(?:\/[\w-]+)+)?[\w-]+\.h(?:h|pp|\+\+)?|[a-z]\w*)>/,
null]);
} else {
shortcutStylePatterns.push([PR_COMMENT, /^#[^\r\n]*/, null, '#']);
}
}
if (options['cStyleComments']) {
fallthroughStylePatterns.push([PR_COMMENT, /^\/\/[^\r\n]*/, null]);
fallthroughStylePatterns.push(
[PR_COMMENT, /^\/\*[\s\S]*?(?:\*\/|$)/, null]);
}
if (options['regexLiterals']) {
/**
* @const
*/
var REGEX_LITERAL = (
// A regular expression literal starts with a slash that is
// not followed by * or / so that it is not confused with
// comments.
'/(?=[^/*])'
// and then contains any number of raw characters,
+ '(?:[^/\\x5B\\x5C]'
// escape sequences (\x5C),
+ '|\\x5C[\\s\\S]'
// or non-nesting character sets (\x5B\x5D);
+ '|\\x5B(?:[^\\x5C\\x5D]|\\x5C[\\s\\S])*(?:\\x5D|$))+'
// finally closed by a /.
+ '/');
fallthroughStylePatterns.push(
['lang-regex',
new RegExp('^' + REGEXP_PRECEDER_PATTERN + '(' + REGEX_LITERAL + ')')
]);
}
var types = options['types'];
if (types) {
fallthroughStylePatterns.push([PR_TYPE, types]);
}
if (options['strings']) {
var strings = ("" + options['strings']).replace(/^ | $/g, '').replace(/-/g, '\\-');
fallthroughStylePatterns.push(
[PR_STRING,
new RegExp('(?:' + strings.replace(/[\s,]+/g, '|') + ')'),
, null]
);
}
var keywords = ("" + options['keywords']).replace(/^ | $/g, '');
if (keywords.length) {
fallthroughStylePatterns.push(
[PR_KEYWORD,
new RegExp('^(?:' + keywords.replace(/[\s,]+/g, '|') + ')\\b'),
null]);
}
shortcutStylePatterns.push([PR_PLAIN, /^\s+/, null, ' \r\n\t\xA0']);
if (options['httpdComments']) {
fallthroughStylePatterns.push(
[PR_PLAIN, /^.*\S.*#/i, null]
);
}
fallthroughStylePatterns.push(
// TODO(mikesamuel): recognize non-latin letters and numerals in idents
[PR_LITERAL, /^@[a-z_$][a-z_$@0-9]*|\bNULL\b/i, null],
[PR_LITERAL, CONFIG_OPTIONS, null],
//[PR_STRING, CONFIG_ENVS, null],
[PR_TAG, /^\b(AuthnProviderAlias|AuthzProviderAlias|Directory|DirectoryMatch|Else|ElseIf|Files|FilesMatch|If|IfDefine|IfDirective|IfFile|IfModule|IfSection|IfVersion|Limit|LimitExcept|Location|LocationMatch|Macro|MDomainSet|Proxy|ProxyMatch|RequireAll|RequireAny|RequireNone|VirtualHost)\b/, null],
[PR_TYPE, /^(?:[@_]?[A-Z]+[a-z][A-Za-z_$@0-9]*|\w+_(t|req|module)\b)/, null],
[PR_TAG, /^apr_[a-z_0-9]+|ap_[a-z_0-9]+/i, null],
[PR_PLAIN, /^[a-z_$][a-z_$@0-9\-]*/i, null],
[PR_LITERAL,
new RegExp(
'^(?:'
// A hex number
+ '0x[a-f0-9]+'
// An IPv6 Address
+ '|[a-f0-9:]+:[a-f0-9:]+:[a-f0-9:]+:[a-f0-9:]+:[a-f0-9:]+:[a-f0-9:]+'
// or an octal or decimal number,
+ '|(?:\\d(?:_\\d+)*\\d*(?:\\.\\d*)?|\\.\\d\\+)'
// possibly in scientific notation
+ '(?:e[+\\-]?\\d+)?'
+ ')'
// with an optional modifier like UL for unsigned long
+ '[a-z]*', 'i'),
null, '0123456789'],
// Don't treat escaped quotes in bash as starting strings. See issue 144.
[PR_PLAIN, /^\\[\s\S]?/, null],
[PR_PUNCTUATION, /^.[^\s\w\.$@\'\"\`\/\#\\]*/, null]);
return createSimpleLexer(shortcutStylePatterns, fallthroughStylePatterns);
}
var decorateSource = sourceDecorator({
'keywords': ALL_KEYWORDS,
'hashComments': true,
'cStyleComments': true,
'multiLineStrings': true,
'regexLiterals': true
});
/**
* Given a DOM subtree, wraps it in a list, and puts each line into its own
* list item.
*
* @param {Node} node modified in place. Its content is pulled into an
* HTMLOListElement, and each line is moved into a separate list item.
* This requires cloning elements, so the input might not have unique
* IDs after numbering.
* @param {boolean} isPreformatted true iff white-space in text nodes should
* be treated as significant.
*/
function numberLines(node, opt_startLineNum, isPreformatted) {
var nocode = /(?:^|\s)nocode(?:\s|$)/;
var lineBreak = /\r\n?|\n/;
var document = node.ownerDocument;
var li = document.createElement('li');
while (node.firstChild) {
li.appendChild(node.firstChild);
}
// An array of lines. We split below, so this is initialized to one
// un-split line.
var listItems = [li];
function walk(node) {
switch (node.nodeType) {
case 1: // Element
if (nocode.test(node.className)) { break; }
if ('br' === node.nodeName) {
breakAfter(node);
// Discard the <BR> since it is now flush against a </LI>.
if (node.parentNode) {
node.parentNode.removeChild(node);
}
} else {
for (var child = node.firstChild; child; child = child.nextSibling) {
walk(child);
}
}
break;
case 3: case 4: // Text
if (isPreformatted) {
var text = node.nodeValue;
var match = text.match(lineBreak);
if (match) {
var firstLine = text.substring(0, match.index);
node.nodeValue = firstLine;
var tail = text.substring(match.index + match[0].length);
if (tail) {
var parent = node.parentNode;
parent.insertBefore(
document.createTextNode(tail), node.nextSibling);
}
breakAfter(node);
if (!firstLine) {
// Don't leave blank text nodes in the DOM.
node.parentNode.removeChild(node);
}
}
}
break;
}
}
// Split a line after the given node.
function breakAfter(lineEndNode) {
// If there's nothing to the right, then we can skip ending the line
// here, and move root-wards since splitting just before an end-tag
// would require us to create a bunch of empty copies.
while (!lineEndNode.nextSibling) {
lineEndNode = lineEndNode.parentNode;
if (!lineEndNode) { return; }
}
function breakLeftOf(limit, copy) {
// Clone shallowly if this node needs to be on both sides of the break.
var rightSide = copy ? limit.cloneNode(false) : limit;
var parent = limit.parentNode;
if (parent) {
// We clone the parent chain.
// This helps us resurrect important styling elements that cross lines.
// E.g. in <i>Foo<br>Bar</i>
// should be rewritten to <li><i>Foo</i></li><li><i>Bar</i></li>.
var parentClone = breakLeftOf(parent, 1);
// Move the clone and everything to the right of the original
// onto the cloned parent.
var next = limit.nextSibling;
parentClone.appendChild(rightSide);
for (var sibling = next; sibling; sibling = next) {
next = sibling.nextSibling;
parentClone.appendChild(sibling);
}
}
return rightSide;
}
var copiedListItem = breakLeftOf(lineEndNode.nextSibling, 0);
// Walk the parent chain until we reach an unattached LI.
for (var parent;
// Check nodeType since IE invents document fragments.
(parent = copiedListItem.parentNode) && parent.nodeType === 1;) {
copiedListItem = parent;
}
// Put it on the list of lines for later processing.
listItems.push(copiedListItem);
}
// Split lines while there are lines left to split.
for (var i = 0; // Number of lines that have been split so far.
i < listItems.length; // length updated by breakAfter calls.
++i) {
walk(listItems[i]);
}
// Make sure numeric indices show correctly.
if (opt_startLineNum === (opt_startLineNum|0)) {
listItems[0].setAttribute('value', opt_startLineNum);
}
var ol = document.createElement('ol');
ol.className = 'linenums';
var offset = Math.max(0, ((opt_startLineNum - 1 /* zero index */)) | 0) || 0;
for (var i = 0, n = listItems.length; i < n; ++i) {
li = listItems[i];
// Stick a class on the LIs so that stylesheets can
// color odd/even rows, or any other row pattern that
// is co-prime with 10.
li.className = 'L' + ((i + offset) % 1);
if (!li.firstChild) {
li.appendChild(document.createTextNode('\xA0'));
}
ol.appendChild(li);
}
node.appendChild(ol);
}
/**
* Breaks {@code job.sourceCode} around style boundaries in
* {@code job.decorations} and modifies {@code job.sourceNode} in place.
* @param {Object} job like <pre>{
* sourceCode: {string} source as plain text,
* spans: {Array.<number|Node>} alternating span start indices into source
* and the text node or element (e.g. {@code <BR>}) corresponding to that
* span.
* decorations: {Array.<number|string} an array of style classes preceded
* by the position at which they start in job.sourceCode in order
* }</pre>
* @private
*/
function recombineTagsAndDecorations(job) {
var isIE8OrEarlier = /\bMSIE\s(\d+)/.exec(navigator.userAgent);
isIE8OrEarlier = isIE8OrEarlier && +isIE8OrEarlier[1] <= 8;
var newlineRe = /\n/g;
var source = job.sourceCode;
var sourceLength = source.length;
// Index into source after the last code-unit recombined.
var sourceIndex = 0;
var spans = job.spans;
var nSpans = spans.length;
// Index into spans after the last span which ends at or before sourceIndex.
var spanIndex = 0;
var decorations = job.decorations;
var nDecorations = decorations.length;
// Index into decorations after the last decoration which ends at or before
// sourceIndex.
var decorationIndex = 0;
// Remove all zero-length decorations.
decorations[nDecorations] = sourceLength;
var decPos, i;
for (i = decPos = 0; i < nDecorations;) {
if (decorations[i] !== decorations[i + 2]) {
decorations[decPos++] = decorations[i++];
decorations[decPos++] = decorations[i++];
} else {
i += 2;
}
}
nDecorations = decPos;
// Simplify decorations.
for (i = decPos = 0; i < nDecorations;) {
var startPos = decorations[i];
// Conflate all adjacent decorations that use the same style.
var startDec = decorations[i + 1];
var end = i + 2;
while (end + 2 <= nDecorations && decorations[end + 1] === startDec) {
end += 2;
}
decorations[decPos++] = startPos;
decorations[decPos++] = startDec;
i = end;
}
nDecorations = decorations.length = decPos;
var sourceNode = job.sourceNode;
var oldDisplay;
if (sourceNode) {
oldDisplay = sourceNode.style.display;
sourceNode.style.display = 'none';
}
try {
var decoration = null;
var X = 0;
while (spanIndex < nSpans) {
X = X + 1;
if (X > 5000) { break; }
var spanStart = spans[spanIndex];
var spanEnd = spans[spanIndex + 2] || sourceLength;
var decEnd = decorations[decorationIndex + 2] || sourceLength;
var end = Math.min(spanEnd, decEnd);
var textNode = spans[spanIndex + 1];
var styledText;
if (textNode.nodeType !== 1 // Don't muck with <BR>s or <LI>s
// Don't introduce spans around empty text nodes.
&& (styledText = source.substring(sourceIndex, end))) {
// This may seem bizarre, and it is. Emitting LF on IE causes the
// code to display with spaces instead of line breaks.
// Emitting Windows standard issue linebreaks (CRLF) causes a blank
// space to appear at the beginning of every line but the first.
// Emitting an old Mac OS 9 line separator makes everything spiffy.
if (isIE8OrEarlier) {
styledText = styledText.replace(newlineRe, '\r');
}
textNode.nodeValue = styledText;
var document = textNode.ownerDocument;
var span = document.createElement('span');
span.className = decorations[decorationIndex + 1];
var parentNode = textNode.parentNode;
parentNode.replaceChild(span, textNode);
span.appendChild(textNode);
if (sourceIndex < spanEnd) { // Split off a text node.
spans[spanIndex + 1] = textNode
// TODO: Possibly optimize by using '' if there's no flicker.
= document.createTextNode(source.substring(end, spanEnd));
parentNode.insertBefore(textNode, span.nextSibling);
}
}
sourceIndex = end;
if (sourceIndex >= spanEnd) {
spanIndex += 2;
}
if (sourceIndex >= decEnd) {
decorationIndex += 2;
}
}
} finally {
if (sourceNode) {
sourceNode.style.display = oldDisplay;
}
}
}
/** Maps language-specific file extensions to handlers. */
var langHandlerRegistry = {};
/** Register a language handler for the given file extensions.
* @param {function (Object)} handler a function from source code to a list
* of decorations. Takes a single argument job which describes the
* state of the computation. The single parameter has the form
* {@code {
* sourceCode: {string} as plain text.
* decorations: {Array.<number|string>} an array of style classes
* preceded by the position at which they start in
* job.sourceCode in order.
* The language handler should assigned this field.
* basePos: {int} the position of source in the larger source chunk.
* All positions in the output decorations array are relative
* to the larger source chunk.
* } }
* @param {Array.<string>} fileExtensions
*/
function registerLangHandler(handler, fileExtensions) {
for (var i = fileExtensions.length; --i >= 0;) {
var ext = fileExtensions[i];
if (!langHandlerRegistry.hasOwnProperty(ext)) {
langHandlerRegistry[ext] = handler;
} else if (win['console']) {
console['warn']('cannot override language handler %s', ext);
}
}
}
function langHandlerForExtension(extension, source) {
if (!(extension && langHandlerRegistry.hasOwnProperty(extension))) {
// Treat it as markup if the first non whitespace character is a < and
// the last non-whitespace character is a >.
extension = /^\s*</.test(source)
? 'default-markup'
: 'default-code';
}
return langHandlerRegistry[extension];
}
registerLangHandler(decorateSource, ['default-code']);
registerLangHandler(
createSimpleLexer(
[],
[
[PR_PLAIN, /^[^<?]+/],
[PR_DECLARATION, /^<!\w[^>]*(?:>|$)/],
[PR_COMMENT, /^<\!--[\s\S]*?(?:-\->|$)/],
// Unescaped content in an unknown language
['lang-', /^<\?([\s\S]+?)(?:\?>|$)/],
['lang-', /^<%([\s\S]+?)(?:%>|$)/],
[PR_PUNCTUATION, /^(?:<[%?]|[%?]>)/],
['lang-', /^<xmp\b[^>]*>([\s\S]+?)<\/xmp\b[^>]*>/i],
// Unescaped content in javascript. (Or possibly vbscript).
['lang-js', /^<script\b[^>]*>([\s\S]*?)(<\/script\b[^>]*>)/i],
// Contains unescaped stylesheet content
['lang-css', /^<style\b[^>]*>([\s\S]*?)(<\/style\b[^>]*>)/i],
['lang-in.tag', /^(<\/?[a-z][^<>]*>)/i]
]),
['default-markup', 'htm', 'html', 'mxml', 'xhtml', 'xml', 'xsl']);
registerLangHandler(
createSimpleLexer(
[
[PR_PLAIN, /^[\s]+/, null, ' \t\r\n'],
[PR_ATTRIB_VALUE, /^(?:\"[^\"]*\"?|\'[^\']*\'?)/, null, '\"\'']
],
[
[PR_TAG, /^^<\/?[a-z](?:[\w.:-]*\w)?|\/?>$/i],
[PR_ATTRIB_NAME, /^(?!style[\s=]|on)[a-z](?:[\w:-]*\w)?/i],
['lang-uq.val', /^=\s*([^>\'\"\s]*(?:[^>\'\"\s\/]|\/(?=\s)))/],
[PR_PUNCTUATION, /^[=<>\/]+/],
['lang-js', /^on\w+\s*=\s*\"([^\"]+)\"/i],
['lang-js', /^on\w+\s*=\s*\'([^\']+)\'/i],
['lang-js', /^on\w+\s*=\s*([^\"\'>\s]+)/i],
['lang-css', /^style\s*=\s*\"([^\"]+)\"/i],
['lang-css', /^style\s*=\s*\'([^\']+)\'/i],
['lang-css', /^style\s*=\s*([^\"\'>\s]+)/i]
]),
['in.tag']);
registerLangHandler(
createSimpleLexer([], [[PR_ATTRIB_VALUE, /^[\s\S]+/]]), ['uq.val']);
registerLangHandler(sourceDecorator({
'keywords': CPP_KEYWORDS,
'hashComments': true,
'cStyleComments': true,
'types': C_TYPES
}), ['c', 'cc', 'cpp', 'cxx', 'cyc', 'm']);
registerLangHandler(sourceDecorator({
'keywords': PHP_KEYWORDS,
'hashComments': false,
'cStyleComments': true,
'multiLineStrings': true,
'regexLiterals': true
// 'types': C_TYPES,
}), ['php', 'phtml', 'inc']);
registerLangHandler(sourceDecorator({
'keywords': 'null,true,false'
}), ['json']);
registerLangHandler(sourceDecorator({
'keywords': CSHARP_KEYWORDS,
'hashComments': true,
'cStyleComments': true,
'verbatimStrings': true,
'types': C_TYPES
}), ['cs']);
registerLangHandler(sourceDecorator({
'keywords': JAVA_KEYWORDS,
'cStyleComments': true
}), ['java']);
registerLangHandler(sourceDecorator({
'keywords': SH_KEYWORDS,
'hashComments': true,
'multiLineStrings': true
}), ['bsh', 'csh', 'sh']);
registerLangHandler(sourceDecorator({
'keywords': PYTHON_KEYWORDS,
'hashComments': true,
'multiLineStrings': true,
'tripleQuotedStrings': true
}), ['cv', 'py']);
registerLangHandler(sourceDecorator({
'keywords': PERL_KEYWORDS,
'hashComments': true,
'multiLineStrings': true,
'regexLiterals': true
}), ['perl', 'pl', 'pm']);
registerLangHandler(sourceDecorator({
'keywords': RUBY_KEYWORDS,
'hashComments': true,
'multiLineStrings': true,
'regexLiterals': true
}), ['rb']);
registerLangHandler(sourceDecorator({
'keywords': JSCRIPT_KEYWORDS,
'cStyleComments': true,
'regexLiterals': true
}), ['js']);
registerLangHandler(sourceDecorator({
'keywords': COFFEE_KEYWORDS,
'hashComments': 3, // ### style block comments
'cStyleComments': true,
'multilineStrings': true,
'tripleQuotedStrings': true,
'regexLiterals': true
}), ['coffee']);
registerLangHandler(
createSimpleLexer([], [[PR_STRING, /^[\s\S]+/]]), ['regex']);
registerLangHandler(sourceDecorator({
'keywords': CONFIG_KEYWORDS,
'literals': CONFIG_OPTIONS,
'strings': CONFIG_ENVS,
'hashComments': true,
'cStyleComments': false,
'multiLineStrings': false,
'regexLiterals': false,
'httpdComments': true
}), ['config']);
function applyDecorator(job) {
var opt_langExtension = job.langExtension;
try {
// Extract tags, and convert the source code to plain text.
var sourceAndSpans = extractSourceSpans(job.sourceNode, job.pre);
/** Plain text. @type {string} */
var source = sourceAndSpans.sourceCode;
job.sourceCode = source;
job.spans = sourceAndSpans.spans;
job.basePos = 0;
// Apply the appropriate language handler
langHandlerForExtension(opt_langExtension, source)(job);
// Integrate the decorations and tags back into the source code,
// modifying the sourceNode in place.
recombineTagsAndDecorations(job);
} catch (e) {
if (win['console']) {
console['log'](e && e['stack'] ? e['stack'] : e);
}
}
}
/**
* @param sourceCodeHtml {string} The HTML to pretty print.
* @param opt_langExtension {string} The language name to use.
* Typically, a filename extension like 'cpp' or 'java'.
* @param opt_numberLines {number|boolean} True to number lines,
* or the 1-indexed number of the first line in sourceCodeHtml.
*/
function prettyPrintOne(sourceCodeHtml, opt_langExtension, opt_numberLines) {
var container = document.createElement('pre');
// This could cause images to load and onload listeners to fire.
// E.g. <img onerror="alert(1337)" src="nosuchimage.png">.
// We assume that the inner HTML is from a trusted source.
container.innerHTML = sourceCodeHtml;
if (opt_numberLines) {
numberLines(container, opt_numberLines, true);
}
var job = {
langExtension: opt_langExtension,
numberLines: opt_numberLines,
sourceNode: container,
pre: 1
};
applyDecorator(job);
return container.innerHTML;
}
function prettyPrint(opt_whenDone) {
function byTagName(tn) { return document.getElementsByTagName(tn); }
// fetch a list of nodes to rewrite
var codeSegments = [byTagName('pre'), byTagName('code'), byTagName('xmp')];
var elements = [];
for (var i = 0; i < codeSegments.length; ++i) {
for (var j = 0, n = codeSegments[i].length; j < n; ++j) {
elements.push(codeSegments[i][j]);
}
}
codeSegments = null;
var clock = Date;
if (!clock['now']) {
clock = { 'now': function () { return +(new Date); } };
}
// The loop is broken into a series of continuations to make sure that we
// don't make the browser unresponsive when rewriting a large page.
var k = 0;
var prettyPrintingJob;
var langExtensionRe = /\blang(?:uage)?-([\w.]+)(?!\S)/;
var prettyPrintRe = /\bprettyprint\b/;
var prettyPrintedRe = /\bprettyprinted\b/;
var preformattedTagNameRe = /pre|xmp/i;
var codeRe = /^code$/i;
var preCodeXmpRe = /^(?:pre|code|xmp)$/i;
function doWork() {
var endTime = (win['PR_SHOULD_USE_CONTINUATION'] ?
clock['now']() + 250 /* ms */ :
Infinity);
for (; k < elements.length && clock['now']() < endTime; k++) {
var cs = elements[k];
var className = cs.className;
if (prettyPrintRe.test(className)
// Don't redo this if we've already done it.
// This allows recalling pretty print to just prettyprint elements
// that have been added to the page since last call.
&& !prettyPrintedRe.test(className)) {
// make sure this is not nested in an already prettified element
var nested = false;
for (var p = cs.parentNode; p; p = p.parentNode) {
var tn = p.tagName;
if (preCodeXmpRe.test(tn)
&& p.className && prettyPrintRe.test(p.className)) {
nested = true;
break;
}
}
if (!nested) {
// Mark done. If we fail to prettyprint for whatever reason,
// we shouldn't try again.
cs.className += ' prettyprinted';
// If the classes includes a language extensions, use it.
// Language extensions can be specified like
// <pre class="prettyprint lang-cpp">
// the language extension "cpp" is used to find a language handler
// as passed to PR.registerLangHandler.
// HTML5 recommends that a language be specified using "language-"
// as the prefix instead. Google Code Prettify supports both.
// http://dev.w3.org/html5/spec-author-view/the-code-element.html
var langExtension = className.match(langExtensionRe);
// Support <pre class="prettyprint"><code class="language-c">
var wrapper;
if (!langExtension && (wrapper = childContentWrapper(cs))
&& codeRe.test(wrapper.tagName)) {
langExtension = wrapper.className.match(langExtensionRe);
}
if (langExtension) { langExtension = langExtension[1]; }
var preformatted;
if (preformattedTagNameRe.test(cs.tagName)) {
preformatted = 1;
} else {
var currentStyle = cs['currentStyle'];
var whitespace = (
currentStyle
? currentStyle['whiteSpace']
: (document.defaultView
&& document.defaultView.getComputedStyle)
? document.defaultView.getComputedStyle(cs, null)
.getPropertyValue('white-space')
: 0);
preformatted = whitespace
&& 'pre' === whitespace.substring(0, 3);
}
// Look for a class like linenums or linenums:<n> where <n> is the
// 1-indexed number of the first line.
var lineNums = cs.className.match(/\blinenums\b(?::(\d+))?/);
lineNums = lineNums
? lineNums[1] && lineNums[1].length ? +lineNums[1] : true
: false;
if (lineNums) { numberLines(cs, lineNums, preformatted); }
// do the pretty printing
prettyPrintingJob = {
langExtension: langExtension,
sourceNode: cs,
numberLines: lineNums,
pre: preformatted
};
applyDecorator(prettyPrintingJob);
}
}
}
if (k < elements.length) {
// finish up in a continuation
setTimeout(doWork, 250);
} else if (opt_whenDone) {
opt_whenDone();
}
}
doWork();
}
/**
* Contains functions for creating and registering new language handlers.
* @type {Object}
*/
var PR = win['PR'] = {
'createSimpleLexer': createSimpleLexer,
'registerLangHandler': registerLangHandler,
'sourceDecorator': sourceDecorator,
'PR_ATTRIB_NAME': PR_ATTRIB_NAME,
'PR_ATTRIB_VALUE': PR_ATTRIB_VALUE,
'PR_COMMENT': PR_COMMENT,
'PR_DECLARATION': PR_DECLARATION,
'PR_KEYWORD': PR_KEYWORD,
'PR_LITERAL': PR_LITERAL,
'PR_NOCODE': PR_NOCODE,
'PR_PLAIN': PR_PLAIN,
'PR_PUNCTUATION': PR_PUNCTUATION,
'PR_SOURCE': PR_SOURCE,
'PR_STRING': PR_STRING,
'PR_TAG': PR_TAG,
'PR_TYPE': PR_TYPE,
'prettyPrintOne': win['prettyPrintOne'] = prettyPrintOne,
'prettyPrint': win['prettyPrint'] = prettyPrint
};
/* Register Lua syntaxes */
PR['registerLangHandler'](
PR['createSimpleLexer'](
[
// Whitespace
[PR['PR_PLAIN'], /^[\t\n\r \xA0]+/, null, '\t\n\r \xA0'],
// A double or single quoted, possibly multi-line, string.
[PR['PR_STRING'], /^(?:\"(?:[^\"\\]|\\[\s\S])*(?:\"|$)|\'(?:[^\'\\]|\\[\s\S])*(?:\'|$))/, null, '"\'']
],
[
// A comment is either a line comment that starts with two dashes, or
// two dashes preceding a long bracketed block.
[PR['PR_COMMENT'], /^--(?:\[(=*)\[[\s\S]*?(?:\]\1\]|$)|[^\r\n]*)/],
[PR['PR_TYPE'], /^nil|false|true/],
// A long bracketed block not preceded by -- is a string.
[PR['PR_STRING'], /^\[(=*)\[[\s\S]*?(?:\]\1\]|$)/],
[PR['PR_KEYWORD'], /^(?:and|break|do|else|elseif|end|for|function|if|in|local|not|or|repeat|require|return|then|until|while)\b/, null],
// A number is a hex integer literal, a decimal real literal, or in
// scientific notation.
[PR['PR_LITERAL'],
/^[+-]?(?:0x[\da-f]+|(?:(?:\.\d+|\d+(?:\.\d*)?)(?:e[+\-]?\d+)?))/i],
// An identifier
[PR['PR_PLAIN'], /^[a-z_]\w*/i],
// A run of punctuation
[PR['PR_PUNCTUATION'], /^[^\w\t\n\r \xA0][^\w\t\n\r \xA0\"\'\-\+=]*/]
]),
['lua']);
// Make PR available via the Asynchronous Module Definition (AMD) API.
// Per https://github.com/amdjs/amdjs-api/wiki/AMD:
// The Asynchronous Module Definition (AMD) API specifies a
// mechanism for defining modules such that the module and its
// dependencies can be asynchronously loaded.
// ...
// To allow a clear indicator that a global define function (as
// needed for script src browser loading) conforms to the AMD API,
// any global define function SHOULD have a property called "amd"
// whose value is an object. This helps avoid conflict with any
// other existing JavaScript code that could have defined a define()
// function that does not conform to the AMD API.
if (typeof define === "function" && define['amd']) {
define("google-code-prettify", [], function () {
return PR;
});
}
})();
httpd-2.4.64/docs/manual/style/scripts/prettify.min.js 0000664 0001751 0001751 00000114610 14737563440 022664 0 ustar covener covener // see prettify.js for copyright, license and expanded version
window['PR_SHOULD_USE_CONTINUATION']=true;var prettyPrintOne;var prettyPrint;(function(){var win=window;var FLOW_CONTROL_KEYWORDS=["break,continue,do,else,for,if,return,while"];var C_KEYWORDS=[FLOW_CONTROL_KEYWORDS,"auto,case,char,const,default,"+"double,enum,extern,float,goto,int,long,register,short,signed,sizeof,module,"+"static,struct,switch,typedef,union,unsigned,void,volatile"];var COMMON_KEYWORDS=[C_KEYWORDS,"catch,class,delete,false,import,"+"new,operator,private,protected,public,this,throw,true,try,typeof"];var CPP_KEYWORDS=[COMMON_KEYWORDS,"alignof,align_union,asm,axiom,bool,"+"concept,concept_map,const_cast,constexpr,decltype,"+"dynamic_cast,explicit,export,friend,inline,late_check,"+"mutable,namespace,nullptr,reinterpret_cast,static_assert,static_cast,"+"template,typeid,typename,using,virtual,where,request_req"];var JAVA_KEYWORDS=[COMMON_KEYWORDS,"abstract,boolean,byte,extends,final,finally,implements,import,"+"instanceof,null,native,package,strictfp,super,synchronized,throws,"+"transient"];var CSHARP_KEYWORDS=[JAVA_KEYWORDS,"as,base,by,checked,decimal,delegate,descending,dynamic,event,"+"fixed,foreach,from,group,implicit,in,interface,internal,into,is,let,"+"lock,object,out,override,orderby,params,partial,readonly,ref,sbyte,"+"sealed,stackalloc,string,select,uint,ulong,unchecked,unsafe,ushort,"+"var,virtual,where"];var COFFEE_KEYWORDS="all,and,by,catch,class,else,extends,false,finally,"+"for,if,in,is,isnt,loop,new,no,not,null,of,off,on,or,return,super,then,"+"throw,true,try,unless,until,when,while,yes";var JSCRIPT_KEYWORDS=[COMMON_KEYWORDS,"debugger,eval,export,function,get,null,set,undefined,var,with,"+"Infinity,NaN"];var PERL_KEYWORDS="caller,delete,die,do,dump,else,elsif,eval,exit,foreach,for,"+"goto,if,import,last,local,my,next,no,our,print,printf,package,redo,require,"+"sub,undef,unless,until,use,wantarray,while,BEGIN,END";var PHP_KEYWORDS="abstract,and,array,as,break,case,catch,cfunction,class,"+"clone,const,continue,declare,default,do,else,elseif,enddeclare,endfor,"+"endforeach,endif,endswitch,endwhile,extends,final,for,foreach,function,"+"global,goto,if,implements,interface,instanceof,namespace,new,old_function,"+"or,private,protected,public,static,switch,throw,try,use,var,while,xor,"+"die,echo,empty,exit,eval,include,include_once,isset,list,require,"+"require_once,return,print,unset";var PYTHON_KEYWORDS=[FLOW_CONTROL_KEYWORDS,"and,as,assert,class,def,del,"+"elif,except,exec,finally,from,global,import,in,is,lambda,"+"nonlocal,not,or,pass,print,raise,try,with,yield,"+"False,True,None"];var RUBY_KEYWORDS=[FLOW_CONTROL_KEYWORDS,"alias,and,begin,case,class,"+"def,defined,elsif,end,ensure,false,in,module,next,nil,not,or,redo,"+"rescue,retry,self,super,then,true,undef,unless,until,when,yield,"+"BEGIN,END"];var SH_KEYWORDS=[FLOW_CONTROL_KEYWORDS,"case,done,elif,esac,eval,fi,"+"function,in,local,set,then,until,echo"];var CONFIG_ENVS=["User-Agent,HTTP_USER_AGENT,HTTP_REFERER,HTTP_COOKIE,HTTP_FORWARDED,HTTP_HOST,HTTP_PROXY_CONNECTION,HTTP_ACCEPT,REMOTE_ADDR,REMOTE_HOST,REMOTE_PORT,REMOTE_USER,REMOTE_IDENT,REQUEST_METHOD,SCRIPT_FILENAME,PATH_INFO,QUERY_STRING,AUTH_TYPE,DOCUMENT_ROOT,SERVER_ADMIN,SERVER_NAME,SERVER_ADDR,SERVER_PORT,SERVER_PROTOCOL,SERVER_SOFTWARE,TIME_YEAR,TIME_MON,TIME_DAY,TIME_HOUR,TIME_MIN,TIME_SEC,TIME_WDAY,TIME,API_VERSION,THE_REQUEST,REQUEST_URI,REQUEST_FILENAME,IS_SUBREQ,HTTPS,REQUEST_SCHEME"];var CONFIG_KEYWORDS=["AcceptFilter,AcceptPathInfo,AccessFileName,Action,AddAlt,AddAltByEncoding,AddAltByType,AddCharset,AddDefaultCharset,AddDescription,AddEncoding,AddHandler,AddIcon,AddIconByEncoding,AddIconByType,AddInputFilter,AddLanguage,AddModuleInfo,AddOutputFilter,AddOutputFilterByType,AddType,Alias,AliasMatch,Allow,AllowCONNECT,AllowEncodedSlashes,AllowMethods,AllowOverride,AllowOverrideList,Anonymous,Anonymous_LogEmail,Anonymous_MustGiveEmail,Anonymous_NoUserID,Anonymous_VerifyEmail,AsyncRequestWorkerFactor,AuthBasicAuthoritative,AuthBasicFake,AuthBasicProvider,AuthBasicUseDigestAlgorithm,AuthDBDUserPWQuery,AuthDBDUserRealmQuery,AuthDBMGroupFile,AuthDBMType,AuthDBMUserFile,AuthDigestAlgorithm,AuthDigestDomain,AuthDigestNonceLifetime,AuthDigestProvider,AuthDigestQop,AuthDigestShmemSize,AuthFormAuthoritative,AuthFormBody,AuthFormDisableNoStore,AuthFormFakeBasicAuth,AuthFormLocation,AuthFormLoginRequiredLocation,AuthFormLoginSuccessLocation,AuthFormLogoutLocation,AuthFormMethod,AuthFormMimetype,AuthFormPassword,AuthFormProvider,AuthFormSitePassphrase,AuthFormSize,AuthFormUsername,AuthGroupFile,AuthLDAPAuthorizePrefix,AuthLDAPBindAuthoritative,AuthLDAPBindDN,AuthLDAPBindPassword,AuthLDAPCharsetConfig,AuthLDAPCompareAsUser,AuthLDAPCompareDNOnServer,AuthLDAPDereferenceAliases,AuthLDAPGroupAttribute,AuthLDAPGroupAttributeIsDN,AuthLDAPInitialBindAsUser,AuthLDAPInitialBindPattern,AuthLDAPMaxSubGroupDepth,AuthLDAPRemoteUserAttribute,AuthLDAPRemoteUserIsDN,AuthLDAPSearchAsUser,AuthLDAPSubGroupAttribute,AuthLDAPSubGroupClass,AuthLDAPURL,AuthMerging,AuthName,AuthnCacheContext,AuthnCacheEnable,AuthnCacheProvideFor,AuthnCacheSOCache,AuthnCacheTimeout,<AuthnProviderAlias>,AuthnzFcgiCheckAuthnProvider,AuthnzFcgiDefineProvider,AuthType,AuthUserFile,AuthzDBDLoginToReferer,AuthzDBDQuery,AuthzDBDRedirectQuery,AuthzDBMType,<AuthzProviderAlias>,AuthzSendForbiddenOnFailure,BalancerGrowth,BalancerInherit,BalancerMember,BalancerPersist,BrotliAlterETag,BrotliCompressionMaxInputBlock,BrotliCompressionQuality,BrotliCompressionWindow,BrotliFilterNote,BrowserMatch,BrowserMatchNoCase,BufferedLogs,BufferSize,CacheDefaultExpire,CacheDetailHeader,CacheDirLength,CacheDirLevels,CacheDisable,CacheEnable,CacheFile,CacheHeader,CacheIgnoreCacheControl,CacheIgnoreHeaders,CacheIgnoreNoLastMod,CacheIgnoreQueryString,CacheIgnoreURLSessionIdentifiers,CacheKeyBaseURL,CacheLastModifiedFactor,CacheLock,CacheLockMaxAge,CacheLockPath,CacheMaxExpire,CacheMaxFileSize,CacheMinExpire,CacheMinFileSize,CacheNegotiatedDocs,CacheQuickHandler,CacheReadSize,CacheReadTime,CacheRoot,CacheSocache,CacheSocacheMaxSize,CacheSocacheMaxTime,CacheSocacheMinTime,CacheSocacheReadSize,CacheSocacheReadTime,CacheStaleOnError,CacheStoreExpired,CacheStoreNoStore,CacheStorePrivate,CGIDScriptTimeout,CGIMapExtension,CGIPassAuth,CGIScriptTimeout,CGIVar,CharsetDefault,CharsetOptions,CharsetSourceEnc,CheckBasenameMatch,CheckCaseOnly,CheckSpelling,ChrootDir,ContentDigest,CookieDomain,CookieExpires,CookieHTTPOnly,CookieName,CookieSameSite,CookieSecure,CookieStyle,CookieTracking,CoreDumpDirectory,CustomLog,Dav,DavBasePath,DavDepthInfinity,DavGenericLockDB,DavLockDB,DavLockDiscovery,DavMinTimeout,DBDExptime,DBDInitSQL,DBDKeep,DBDMax,DBDMin,DBDParams,DBDPersist,DBDPrepareSQL,DBDriver,DefaultIcon,DefaultLanguage,DefaultRuntimeDir,DefaultType,Define,DeflateAlterETag,DeflateBufferSize,DeflateCompressionLevel,DeflateFilterNote,DeflateInflateLimitRequestBody,DeflateInflateRatioBurst,DeflateInflateRatioLimit,DeflateMemLevel,DeflateWindowSize,Deny,<Directory>,DirectoryCheckHandler,DirectoryIndex,DirectoryIndexRedirect,<DirectoryMatch>,DirectorySlash,DocumentRoot,DTracePrivileges,DumpIOInput,DumpIOOutput,<Else>,<ElseIf>,EnableExceptionHook,EnableMMAP,EnableSendfile,Error,ErrorDocument,ErrorLog,ErrorLogFormat,Example,ExpiresActive,ExpiresByType,ExpiresDefault,ExtendedStatus,ExtFilterDefine,ExtFilterOptions,FallbackResource,FileETag,<Files>,<FilesMatch>,FilterChain,FilterDeclare,FilterProtocol,FilterProvider,FilterTrace,FlushMaxPipelined,FlushMaxThreshold,ForceLanguagePriority,ForceType,ForensicLog,GlobalLog,GprofDir,GracefulShutdownTimeout,Group,H2CopyFiles,H2Direct,H2EarlyHint,H2EarlyHints,H2MaxDataFrameLen,H2MaxSessionStreams,H2MaxWorkerIdleSeconds,H2MaxWorkers,H2MinWorkers,H2ModernTLSOnly,H2OutputBuffering,H2Padding,H2ProxyRequests,H2Push,H2PushDiarySize,H2PushPriority,H2PushResource,H2SerializeHeaders,H2StreamMaxMemSize,H2StreamTimeout,H2TLSCoolDownSecs,H2TLSWarmUpSize,H2Upgrade,H2WebSockets,H2WindowSize,Header,HeaderName,HeartbeatAddress,HeartbeatListen,HeartbeatMaxServers,HeartbeatStorage,HeartbeatStorage,HostnameLookups,HttpProtocolOptions,IdentityCheck,IdentityCheckTimeout,<If>,<IfDefine>,<IfDirective>,<IfFile>,<IfModule>,<IfSection>,<IfVersion>,ImapBase,ImapDefault,ImapMenu,Include,IncludeOptional,IndexHeadInsert,IndexIgnore,IndexIgnoreReset,IndexOptions,IndexOrderDefault,IndexStyleSheet,InputSed,ISAPIAppendLogToErrors,ISAPIAppendLogToQuery,ISAPICacheFile,ISAPIFakeAsync,ISAPILogNotSupported,ISAPIReadAheadBuffer,KeepAlive,KeepAliveTimeout,KeptBodySize,LanguagePriority,LDAPCacheEntries,LDAPCacheTTL,LDAPConnectionPoolTTL,LDAPConnectionTimeout,LDAPLibraryDebug,LDAPOpCacheEntries,LDAPOpCacheTTL,LDAPReferralHopLimit,LDAPReferrals,LDAPRetries,LDAPRetryDelay,LDAPSharedCacheFile,LDAPSharedCacheSize,LDAPTimeout,LDAPTrustedClientCert,LDAPTrustedGlobalCert,LDAPTrustedMode,LDAPVerifyServerCert,<Limit>,<LimitExcept>,LimitInternalRecursion,LimitRequestBody,LimitRequestFields,LimitRequestFieldSize,LimitRequestLine,LimitXMLRequestBody,Listen,ListenBackLog,ListenCoresBucketsRatio,LoadFile,LoadModule,<Location>,<LocationMatch>,LogFormat,LogIOTrackTTFB,LogLevel,LogMessage,LuaAuthzProvider,LuaCodeCache,LuaHookAccessChecker,LuaHookAuthChecker,LuaHookCheckUserID,LuaHookFixups,LuaHookInsertFilter,LuaHookLog,LuaHookMapToStorage,LuaHookPreTranslate,LuaHookTranslateName,LuaHookTypeChecker,LuaInherit,LuaInputFilter,LuaMapHandler,LuaOutputFilter,LuaPackageCPath,LuaPackagePath,LuaQuickHandler,LuaRoot,LuaScope,<Macro>,MaxConnectionsPerChild,MaxKeepAliveRequests,MaxMemFree,MaxRangeOverlaps,MaxRangeReversals,MaxRanges,MaxRequestWorkers,MaxSpareServers,MaxSpareThreads,MaxThreads,MDActivationDelay,MDBaseServer,MDCAChallenges,MDCertificateAgreement,MDCertificateAuthority,MDCertificateCheck,MDCertificateFile,MDCertificateKeyFile,MDCertificateMonitor,MDCertificateProtocol,MDCertificateStatus,MDChallengeDns01,MDChallengeDns01Version,MDContactEmail,MDDriveMode,MDExternalAccountBinding,MDHttpProxy,MDMatchNames,MDMember,MDMembers,MDMessageCmd,MDMustStaple,MDNotifyCmd,MDomain,<MDomainSet>,MDPortMap,MDPrivateKeys,MDRenewMode,MDRenewWindow,MDRequireHttps,MDRetryDelay,MDRetryFailover,MDServerStatus,MDStapleOthers,MDStapling,MDStaplingKeepResponse,MDStaplingRenewWindow,MDStoreDir,MDStoreLocks,MDWarnWindow,MemcacheConnTTL,MergeSlashes,MergeTrailers,MetaDir,MetaFiles,MetaSuffix,MimeMagicFile,MinSpareServers,MinSpareThreads,MMapFile,ModemStandard,ModMimeUsePathInfo,MultiviewsMatch,Mutex,NameVirtualHost,NoProxy,NWSSLTrustedCerts,NWSSLUpgradeable,Options,Order,OutputSed,PassEnv,PidFile,PrivilegesMode,Protocol,ProtocolEcho,Protocols,ProtocolsHonorOrder,<Proxy>,Proxy100Continue,ProxyAddHeaders,ProxyBadHeader,ProxyBlock,ProxyDomain,ProxyErrorOverride,ProxyExpressDBMFile,ProxyExpressDBMType,ProxyExpressEnable,ProxyFCGIBackendType,ProxyFCGISetEnvIf,ProxyFtpDirCharset,ProxyFtpEscapeWildcards,ProxyFtpListOnWildcard,ProxyHCExpr,ProxyHCTemplate,ProxyHCTPsize,ProxyHTMLBufSize,ProxyHTMLCharsetOut,ProxyHTMLDocType,ProxyHTMLEnable,ProxyHTMLEvents,ProxyHTMLExtended,ProxyHTMLFixups,ProxyHTMLInterp,ProxyHTMLLinks,ProxyHTMLMeta,ProxyHTMLStripComments,ProxyHTMLURLMap,ProxyIOBufferSize,<ProxyMatch>,ProxyMaxForwards,ProxyPass,ProxyPassInherit,ProxyPassInterpolateEnv,ProxyPassMatch,ProxyPassReverse,ProxyPassReverseCookieDomain,ProxyPassReverseCookiePath,ProxyPreserveHost,ProxyReceiveBufferSize,ProxyRemote,ProxyRemoteMatch,ProxyRequests,ProxySCGIInternalRedirect,ProxySCGISendfile,ProxySet,ProxySourceAddress,ProxyStatus,ProxyTimeout,ProxyVia,ProxyWebsocketFallbackToProxyHttp,QualifyRedirectURL,ReadBufferSize,ReadmeName,ReceiveBufferSize,Redirect,RedirectMatch,RedirectPermanent,RedirectRelative,RedirectTemp,RedisConnPoolTTL,RedisTimeout,ReflectorHeader,RegexDefaultOptions,RegisterHttpMethod,RemoteIPHeader,RemoteIPInternalProxy,RemoteIPInternalProxyList,RemoteIPProxiesHeader,RemoteIPProxyProtocol,RemoteIPProxyProtocolExceptions,RemoteIPTrustedProxy,RemoteIPTrustedProxyList,RemoveCharset,RemoveEncoding,RemoveHandler,RemoveInputFilter,RemoveLanguage,RemoveOutputFilter,RemoveType,RequestHeader,RequestReadTimeout,Require,<RequireAll>,<RequireAny>,<RequireNone>,RewriteBase,RewriteCond,RewriteEngine,RewriteMap,RewriteOptions,RewriteRule,RLimitCPU,RLimitMEM,RLimitNPROC,Satisfy,ScoreBoardFile,Script,ScriptAlias,ScriptAliasMatch,ScriptInterpreterSource,ScriptLog,ScriptLogBuffer,ScriptLogLength,ScriptSock,SecureListen,SeeRequestTail,SendBufferSize,ServerAdmin,ServerAlias,ServerLimit,ServerName,ServerPath,ServerRoot,ServerSignature,ServerTokens,Session,SessionCookieName,SessionCookieName2,SessionCookieRemove,SessionCryptoCipher,SessionCryptoDriver,SessionCryptoPassphrase,SessionCryptoPassphraseFile,SessionDBDCookieName,SessionDBDCookieName2,SessionDBDCookieRemove,SessionDBDDeleteLabel,SessionDBDInsertLabel,SessionDBDPerUser,SessionDBDSelectLabel,SessionDBDUpdateLabel,SessionEnv,SessionExclude,SessionExpiryUpdateInterval,SessionHeader,SessionInclude,SessionMaxAge,SetEnv,SetEnvIf,SetEnvIfExpr,SetEnvIfNoCase,SetHandler,SetInputFilter,SetOutputFilter,SSIEndTag,SSIErrorMsg,SSIETag,SSILastModified,SSILegacyExprParser,SSIStartTag,SSITimeFormat,SSIUndefinedEcho,SSLCACertificateFile,SSLCACertificatePath,SSLCADNRequestFile,SSLCADNRequestPath,SSLCARevocationCheck,SSLCARevocationFile,SSLCARevocationPath,SSLCertificateChainFile,SSLCertificateFile,SSLCertificateKeyFile,SSLCipherSuite,SSLCompression,SSLCryptoDevice,SSLEngine,SSLFIPS,SSLHonorCipherOrder,SSLInsecureRenegotiation,SSLOCSPDefaultResponder,SSLOCSPEnable,SSLOCSPNoverify,SSLOCSPOverrideResponder,SSLOCSPProxyURL,SSLOCSPResponderCertificateFile,SSLOCSPResponderTimeout,SSLOCSPResponseMaxAge,SSLOCSPResponseTimeSkew,SSLOCSPUseRequestNonce,SSLOpenSSLConfCmd,SSLOptions,SSLPassPhraseDialog,SSLProtocol,SSLProxyCACertificateFile,SSLProxyCACertificatePath,SSLProxyCARevocationCheck,SSLProxyCARevocationFile,SSLProxyCARevocationPath,SSLProxyCheckPeerCN,SSLProxyCheckPeerExpire,SSLProxyCheckPeerName,SSLProxyCipherSuite,SSLProxyEngine,SSLProxyMachineCertificateChainFile,SSLProxyMachineCertificateFile,SSLProxyMachineCertificatePath,SSLProxyProtocol,SSLProxyVerify,SSLProxyVerifyDepth,SSLRandomSeed,SSLRenegBufferSize,SSLRequire,SSLRequireSSL,SSLSessionCache,SSLSessionCacheTimeout,SSLSessionTicketKeyFile,SSLSessionTickets,SSLSRPUnknownUserSeed,SSLSRPVerifierFile,SSLStaplingCache,SSLStaplingErrorCacheTimeout,SSLStaplingFakeTryLater,SSLStaplingForceURL,SSLStaplingResponderTimeout,SSLStaplingResponseMaxAge,SSLStaplingResponseTimeSkew,SSLStaplingReturnResponderErrors,SSLStaplingStandardCacheTimeout,SSLStrictSNIVHostCheck,SSLUserName,SSLUseStapling,SSLVerifyClient,SSLVerifyDepth,StartServers,StartThreads,StrictHostCheck,Substitute,SubstituteInheritBefore,SubstituteMaxLineLength,Suexec,SuexecUserGroup,ThreadLimit,ThreadsPerChild,ThreadStackSize,TimeOut,TraceEnable,TransferLog,TypesConfig,UNCList,UnDefine,UndefMacro,UnsetEnv,Use,UseCanonicalName,UseCanonicalPhysicalPort,User,UserDir,VHostCGIMode,VHostCGIPrivs,VHostGroup,VHostPrivs,VHostSecure,VHostUser,VirtualDocumentRoot,VirtualDocumentRootIP,<VirtualHost>,VirtualScriptAlias,VirtualScriptAliasIP,WatchdogInterval,XBitHack,xml2EncAlias,xml2EncDefault,xml2StartParse"];var CONFIG_OPTIONS=/^[\\+\\-]?(AuthConfig|IncludesNOEXEC|ExecCGI|FollowSymLinks|MultiViews|Includes|Indexes|SymLinksIfOwnerMatch)\b/i;var ALL_KEYWORDS=[CPP_KEYWORDS,CSHARP_KEYWORDS,JSCRIPT_KEYWORDS,PERL_KEYWORDS+
PYTHON_KEYWORDS,RUBY_KEYWORDS,SH_KEYWORDS,CONFIG_KEYWORDS,PHP_KEYWORDS];var C_TYPES=/^(DIR|FILE|vector|(de|priority_)?queue|list|stack|(const_)?iterator|(multi)?(set|map)|bitset|u?(int|float|char|void|const|static|struct)\d*(_t)?\b)|[a-z_]+_rec|cmd_parms\b/;var PR_STRING='str';var PR_KEYWORD='kwd';var PR_COMMENT='com';var PR_TYPE='typ';var PR_LITERAL='lit';var PR_PUNCTUATION='pun';var PR_PLAIN='pln';var PR_TAG='tag';var PR_DECLARATION='dec';var PR_SOURCE='src';var PR_ATTRIB_NAME='atn';var PR_ATTRIB_VALUE='atv';var PR_NOCODE='nocode';var REGEXP_PRECEDER_PATTERN='(?:^^\\.?|[+-]|[!=]=?=?|\\#|%=?|&&?=?|\\(|\\*=?|[+\\-]=|->|\\/=?|::?|<<?=?|>>?>?=?|,|;|\\?|@|\\[|~|{|\\^\\^?=?|\\|\\|?=?|break|case|continue|delete|do|else|finally|instanceof|return|throw|try|typeof)\\s*';function combinePrefixPatterns(regexs){var capturedGroupIndex=0;var needToFoldCase=false;var ignoreCase=false;for(var i=0,n=regexs.length;i<n;++i){var regex=regexs[i];if(regex.ignoreCase){ignoreCase=true;}else if(/[a-z]/i.test(regex.source.replace(/\\u[0-9a-f]{4}|\\x[0-9a-f]{2}|\\[^ux]/gi,''))){needToFoldCase=true;ignoreCase=false;break;}}
var escapeCharToCodeUnit={'b':8,'t':9,'n':0xa,'v':0xb,'f':0xc,'r':0xd};function decodeEscape(charsetPart){var cc0=charsetPart.charCodeAt(0);if(cc0!==92){return cc0;}
var c1=charsetPart.charAt(1);cc0=escapeCharToCodeUnit[c1];if(cc0){return cc0;}else if('0'<=c1&&c1<='7'){return parseInt(charsetPart.substring(1),8);}else if(c1==='u'||c1==='x'){return parseInt(charsetPart.substring(2),16);}else{return charsetPart.charCodeAt(1);}}
function encodeEscape(charCode){if(charCode<0x20){return(charCode<0x10?'\\x0':'\\x')+charCode.toString(16);}
var ch=String.fromCharCode(charCode);return(ch==='\\'||ch==='-'||ch===']'||ch==='^')?"\\"+ch:ch;}
function caseFoldCharset(charSet){var charsetParts=charSet.substring(1,charSet.length-1).match(new RegExp('\\\\u[0-9A-Fa-f]{4}'
+'|\\\\x[0-9A-Fa-f]{2}'
+'|\\\\[0-3][0-7]{0,2}'
+'|\\\\[0-7]{1,2}'
+'|\\\\[\\s\\S]'
+'|-'
+'|[^-\\\\]','g'));var ranges=[];var inverse=charsetParts[0]==='^';var out=['['];if(inverse){out.push('^');}
for(var i=inverse?1:0,n=charsetParts.length;i<n;++i){var p=charsetParts[i];if(/\\[bdsw]/i.test(p)){out.push(p);}else{var start=decodeEscape(p);var end;if(i+2<n&&'-'===charsetParts[i+1]){end=decodeEscape(charsetParts[i+2]);i+=2;}else{end=start;}
ranges.push([start,end]);if(!(end<65||start>122)){if(!(end<65||start>90)){ranges.push([Math.max(65,start)|32,Math.min(end,90)|32]);}
if(!(end<97||start>122)){ranges.push([Math.max(97,start)&~32,Math.min(end,122)&~32]);}}}}
ranges.sort(function(a,b){return(a[0]-b[0])||(b[1]-a[1]);});var consolidatedRanges=[];var lastRange=[];for(var i=0;i<ranges.length;++i){var range=ranges[i];if(range[0]<=lastRange[1]+1){lastRange[1]=Math.max(lastRange[1],range[1]);}else{consolidatedRanges.push(lastRange=range);}}
for(var i=0;i<consolidatedRanges.length;++i){var range=consolidatedRanges[i];out.push(encodeEscape(range[0]));if(range[1]>range[0]){if(range[1]+1>range[0]){out.push('-');}
out.push(encodeEscape(range[1]));}}
out.push(']');return out.join('');}
function allowAnywhereFoldCaseAndRenumberGroups(regex){var parts=regex.source.match(new RegExp('(?:'
+'\\[(?:[^\\x5C\\x5D]|\\\\[\\s\\S])*\\]'
+'|\\\\u[A-Fa-f0-9]{4}'
+'|\\\\x[A-Fa-f0-9]{2}'
+'|\\\\[0-9]+'
+'|\\\\[^ux0-9]'
+'|\\(\\?[:!=]'
+'|[\\(\\)\\^]'
+'|[^\\x5B\\x5C\\(\\)\\^]+'
+')','g'));var n=parts.length;var capturedGroups=[];for(var i=0,groupIndex=0;i<n;++i){var p=parts[i];if(p==='('){++groupIndex;}else if('\\'===p.charAt(0)){var decimalValue=+p.substring(1);if(decimalValue){if(decimalValue<=groupIndex){capturedGroups[decimalValue]=-1;}else{parts[i]=encodeEscape(decimalValue);}}}}
for(var i=1;i<capturedGroups.length;++i){if(-1===capturedGroups[i]){capturedGroups[i]=++capturedGroupIndex;}}
for(var i=0,groupIndex=0;i<n;++i){var p=parts[i];if(p==='('){++groupIndex;if(!capturedGroups[groupIndex]){parts[i]='(?:';}}else if('\\'===p.charAt(0)){var decimalValue=+p.substring(1);if(decimalValue&&decimalValue<=groupIndex){parts[i]='\\'+capturedGroups[decimalValue];}}}
for(var i=0;i<n;++i){if('^'===parts[i]&&'^'!==parts[i+1]){parts[i]='';}}
if(regex.ignoreCase&&needToFoldCase){for(var i=0;i<n;++i){var p=parts[i];var ch0=p.charAt(0);if(p.length>=2&&ch0==='['){parts[i]=caseFoldCharset(p);}else if(ch0!=='\\'){parts[i]=p.replace(/[a-zA-Z]/g,function(ch){var cc=ch.charCodeAt(0);return'['+String.fromCharCode(cc&~32,cc|32)+']';});}}}
return parts.join('');}
var rewritten=[];for(var i=0,n=regexs.length;i<n;++i){var regex=regexs[i];if(regex.global||regex.multiline){throw new Error(''+regex);}
rewritten.push('(?:'+allowAnywhereFoldCaseAndRenumberGroups(regex)+')');}
return new RegExp(rewritten.join('|'),ignoreCase?'gi':'g');}
function extractSourceSpans(node,isPreformatted){var nocode=/(?:^|\s)nocode(?:\s|$)/;var chunks=[];var length=0;var spans=[];var k=0;function walk(node){switch(node.nodeType){case 1:if(nocode.test(node.className)){return;}
for(var child=node.firstChild;child;child=child.nextSibling){walk(child);}
var nodeName=node.nodeName.toLowerCase();if('br'===nodeName||'li'===nodeName){chunks[k]='\n';spans[k<<1]=length++;spans[(k++<<1)|1]=node;}
break;case 3:case 4:var text=node.nodeValue;if(text.length){if(!isPreformatted){text=text.replace(/[ \t\r\n]+/g,' ');}else{text=text.replace(/\r\n?/g,'\n');text=text.replace(/^(\r?\n\s*)+/g,'');text=text.replace(/^\s*/g,'');text=text.replace(/(\r?\n\s*)+$/g,'');}
chunks[k]=text;spans[k<<1]=length;length+=text.length;spans[(k++<<1)|1]=node;}
break;}}
walk(node);return{sourceCode:chunks.join('').replace(/\n$/,''),spans:spans};}
function appendDecorations(basePos,sourceCode,langHandler,out){if(!sourceCode){return;}
var job={sourceCode:sourceCode,basePos:basePos};langHandler(job);out.push.apply(out,job.decorations);}
var notWs=/\S/;function childContentWrapper(element){var wrapper=undefined;for(var c=element.firstChild;c;c=c.nextSibling){var type=c.nodeType;wrapper=(type===1)?(wrapper?element:c):(type===3)?(notWs.test(c.nodeValue)?element:wrapper):wrapper;}
return wrapper===element?undefined:wrapper;}
function createSimpleLexer(shortcutStylePatterns,fallthroughStylePatterns){var shortcuts={};var tokenizer;(function(){var allPatterns=shortcutStylePatterns.concat(fallthroughStylePatterns);var allRegexs=[];var regexKeys={};for(var i=0,n=allPatterns.length;i<n;++i){var patternParts=allPatterns[i];var shortcutChars=patternParts[3];if(shortcutChars){for(var c=shortcutChars.length;--c>=0;){shortcuts[shortcutChars.charAt(c)]=patternParts;}}
var regex=patternParts[1];var k=''+regex;if(!regexKeys.hasOwnProperty(k)){allRegexs.push(regex);regexKeys[k]=null;}}
allRegexs.push(/[\0-\uffff]/);tokenizer=combinePrefixPatterns(allRegexs);})();var nPatterns=fallthroughStylePatterns.length;var decorate=function(job){var sourceCode=job.sourceCode,basePos=job.basePos;var decorations=[basePos,PR_PLAIN];var pos=0;var tokens=sourceCode.match(tokenizer)||[];var styleCache={};for(var ti=0,nTokens=tokens.length;ti<nTokens;++ti){var token=tokens[ti];var style=styleCache[token];var match=void 0;var isEmbedded;if(typeof style==='string'){isEmbedded=false;}else{var patternParts=shortcuts[token.charAt(0)];if(patternParts){match=token.match(patternParts[1]);style=patternParts[0];}else{for(var i=0;i<nPatterns;++i){patternParts=fallthroughStylePatterns[i];match=token.match(patternParts[1]);if(match){style=patternParts[0];break;}}
if(!match){style=PR_PLAIN;}}
isEmbedded=style.length>=5&&'lang-'===style.substring(0,5);if(isEmbedded&&!(match&&typeof match[1]==='string')){isEmbedded=false;style=PR_SOURCE;}
if(!isEmbedded){styleCache[token]=style;}}
var tokenStart=pos;pos+=token.length;if(!isEmbedded){decorations.push(basePos+tokenStart,style);}else{var embeddedSource=match[1];var embeddedSourceStart=token.indexOf(embeddedSource);var embeddedSourceEnd=embeddedSourceStart+embeddedSource.length;if(match[2]){embeddedSourceEnd=token.length-match[2].length;embeddedSourceStart=embeddedSourceEnd-embeddedSource.length;}
var lang=style.substring(5);appendDecorations(basePos+tokenStart,token.substring(0,embeddedSourceStart),decorate,decorations);appendDecorations(basePos+tokenStart+embeddedSourceStart,embeddedSource,langHandlerForExtension(lang,embeddedSource),decorations);appendDecorations(basePos+tokenStart+embeddedSourceEnd,token.substring(embeddedSourceEnd),decorate,decorations);}}
job.decorations=decorations;};return decorate;}
function sourceDecorator(options){var shortcutStylePatterns=[],fallthroughStylePatterns=[];if(options['tripleQuotedStrings']){shortcutStylePatterns.push([PR_STRING,/^(?:\'\'\'(?:[^\'\\]|\\[\s\S]|\'{1,2}(?=[^\']))*(?:\'\'\'|$)|\"\"\"(?:[^\"\\]|\\[\s\S]|\"{1,2}(?=[^\"]))*(?:\"\"\"|$)|\'(?:[^\\\']|\\[\s\S])*(?:\'|$)|\"(?:[^\\\"]|\\[\s\S])*(?:\"|$))/,null,'\'"']);}else if(options['multiLineStrings']){shortcutStylePatterns.push([PR_STRING,/^(?:\'(?:[^\\\']|\\[\s\S])*(?:\'|$)|\"(?:[^\\\"]|\\[\s\S])*(?:\"|$)|\`(?:[^\\\`]|\\[\s\S])*(?:\`|$))/,null,'\'"`']);}else{shortcutStylePatterns.push([PR_STRING,/^(?:\'(?:[^\\\'\r\n]|\\.)*(?:\'|$)|\"(?:[^\\\"\r\n]|\\.)*(?:\"|$))/,null,'"\'']);}
if(options['verbatimStrings']){fallthroughStylePatterns.push([PR_STRING,/^@\"(?:[^\"]|\"\")*(?:\"|$)/,null]);}
var hc=options['hashComments'];if(hc){if(options['cStyleComments']){if(hc>1){shortcutStylePatterns.push([PR_COMMENT,/^#(?:##(?:[^#]|#(?!##))*(?:###|$)|.*)/,null,'#']);}else{shortcutStylePatterns.push([PR_COMMENT,/^#(?:(?:define|elif|else|endif|error|ifdef|include|ifndef|line|pragma|undef|warning)\b|[^\r\n]*)/,null,'#']);}
fallthroughStylePatterns.push([PR_STRING,/^<(?:(?:(?:\.\.\/)*|\/?)(?:[\w-]+(?:\/[\w-]+)+)?[\w-]+\.h(?:h|pp|\+\+)?|[a-z]\w*)>/,null]);}else{shortcutStylePatterns.push([PR_COMMENT,/^#[^\r\n]*/,null,'#']);}}
if(options['cStyleComments']){fallthroughStylePatterns.push([PR_COMMENT,/^\/\/[^\r\n]*/,null]);fallthroughStylePatterns.push([PR_COMMENT,/^\/\*[\s\S]*?(?:\*\/|$)/,null]);}
if(options['regexLiterals']){var REGEX_LITERAL=('/(?=[^/*])'
+'(?:[^/\\x5B\\x5C]'
+'|\\x5C[\\s\\S]'
+'|\\x5B(?:[^\\x5C\\x5D]|\\x5C[\\s\\S])*(?:\\x5D|$))+'
+'/');fallthroughStylePatterns.push(['lang-regex',new RegExp('^'+REGEXP_PRECEDER_PATTERN+'('+REGEX_LITERAL+')')]);}
var types=options['types'];if(types){fallthroughStylePatterns.push([PR_TYPE,types]);}
if(options['strings']){var strings=(""+options['strings']).replace(/^ | $/g,'').replace(/-/g,'\\-');fallthroughStylePatterns.push([PR_STRING,new RegExp('(?:'+strings.replace(/[\s,]+/g,'|')+')'),,null]);}
var keywords=(""+options['keywords']).replace(/^ | $/g,'');if(keywords.length){fallthroughStylePatterns.push([PR_KEYWORD,new RegExp('^(?:'+keywords.replace(/[\s,]+/g,'|')+')\\b'),null]);}
shortcutStylePatterns.push([PR_PLAIN,/^\s+/,null,' \r\n\t\xA0']);if(options['httpdComments']){fallthroughStylePatterns.push([PR_PLAIN,/^.*\S.*#/i,null]);}
fallthroughStylePatterns.push([PR_LITERAL,/^@[a-z_$][a-z_$@0-9]*|\bNULL\b/i,null],[PR_LITERAL,CONFIG_OPTIONS,null],[PR_TAG,/^\b(AuthnProviderAlias|AuthzProviderAlias|Directory|DirectoryMatch|Else|ElseIf|Files|FilesMatch|If|IfDefine|IfDirective|IfFile|IfModule|IfSection|IfVersion|Limit|LimitExcept|Location|LocationMatch|Macro|MDomainSet|Proxy|ProxyMatch|RequireAll|RequireAny|RequireNone|VirtualHost)\b/,null],[PR_TYPE,/^(?:[@_]?[A-Z]+[a-z][A-Za-z_$@0-9]*|\w+_(t|req|module)\b)/,null],[PR_TAG,/^apr_[a-z_0-9]+|ap_[a-z_0-9]+/i,null],[PR_PLAIN,/^[a-z_$][a-z_$@0-9\-]*/i,null],[PR_LITERAL,new RegExp('^(?:'
+'0x[a-f0-9]+'
+'|[a-f0-9:]+:[a-f0-9:]+:[a-f0-9:]+:[a-f0-9:]+:[a-f0-9:]+:[a-f0-9:]+'
+'|(?:\\d(?:_\\d+)*\\d*(?:\\.\\d*)?|\\.\\d\\+)'
+'(?:e[+\\-]?\\d+)?'
+')'
+'[a-z]*','i'),null,'0123456789'],[PR_PLAIN,/^\\[\s\S]?/,null],[PR_PUNCTUATION,/^.[^\s\w\.$@\'\"\`\/\#\\]*/,null]);return createSimpleLexer(shortcutStylePatterns,fallthroughStylePatterns);}
var decorateSource=sourceDecorator({'keywords':ALL_KEYWORDS,'hashComments':true,'cStyleComments':true,'multiLineStrings':true,'regexLiterals':true});function numberLines(node,opt_startLineNum,isPreformatted){var nocode=/(?:^|\s)nocode(?:\s|$)/;var lineBreak=/\r\n?|\n/;var document=node.ownerDocument;var li=document.createElement('li');while(node.firstChild){li.appendChild(node.firstChild);}
var listItems=[li];function walk(node){switch(node.nodeType){case 1:if(nocode.test(node.className)){break;}
if('br'===node.nodeName){breakAfter(node);if(node.parentNode){node.parentNode.removeChild(node);}}else{for(var child=node.firstChild;child;child=child.nextSibling){walk(child);}}
break;case 3:case 4:if(isPreformatted){var text=node.nodeValue;var match=text.match(lineBreak);if(match){var firstLine=text.substring(0,match.index);node.nodeValue=firstLine;var tail=text.substring(match.index+match[0].length);if(tail){var parent=node.parentNode;parent.insertBefore(document.createTextNode(tail),node.nextSibling);}
breakAfter(node);if(!firstLine){node.parentNode.removeChild(node);}}}
break;}}
function breakAfter(lineEndNode){while(!lineEndNode.nextSibling){lineEndNode=lineEndNode.parentNode;if(!lineEndNode){return;}}
function breakLeftOf(limit,copy){var rightSide=copy?limit.cloneNode(false):limit;var parent=limit.parentNode;if(parent){var parentClone=breakLeftOf(parent,1);var next=limit.nextSibling;parentClone.appendChild(rightSide);for(var sibling=next;sibling;sibling=next){next=sibling.nextSibling;parentClone.appendChild(sibling);}}
return rightSide;}
var copiedListItem=breakLeftOf(lineEndNode.nextSibling,0);for(var parent;(parent=copiedListItem.parentNode)&&parent.nodeType===1;){copiedListItem=parent;}
listItems.push(copiedListItem);}
for(var i=0;i<listItems.length;++i){walk(listItems[i]);}
if(opt_startLineNum===(opt_startLineNum|0)){listItems[0].setAttribute('value',opt_startLineNum);}
var ol=document.createElement('ol');ol.className='linenums';var offset=Math.max(0,((opt_startLineNum-1))|0)||0;for(var i=0,n=listItems.length;i<n;++i){li=listItems[i];li.className='L'+((i+offset)%1);if(!li.firstChild){li.appendChild(document.createTextNode('\xA0'));}
ol.appendChild(li);}
node.appendChild(ol);}
function recombineTagsAndDecorations(job){var isIE8OrEarlier=/\bMSIE\s(\d+)/.exec(navigator.userAgent);isIE8OrEarlier=isIE8OrEarlier&&+isIE8OrEarlier[1]<=8;var newlineRe=/\n/g;var source=job.sourceCode;var sourceLength=source.length;var sourceIndex=0;var spans=job.spans;var nSpans=spans.length;var spanIndex=0;var decorations=job.decorations;var nDecorations=decorations.length;var decorationIndex=0;decorations[nDecorations]=sourceLength;var decPos,i;for(i=decPos=0;i<nDecorations;){if(decorations[i]!==decorations[i+2]){decorations[decPos++]=decorations[i++];decorations[decPos++]=decorations[i++];}else{i+=2;}}
nDecorations=decPos;for(i=decPos=0;i<nDecorations;){var startPos=decorations[i];var startDec=decorations[i+1];var end=i+2;while(end+2<=nDecorations&&decorations[end+1]===startDec){end+=2;}
decorations[decPos++]=startPos;decorations[decPos++]=startDec;i=end;}
nDecorations=decorations.length=decPos;var sourceNode=job.sourceNode;var oldDisplay;if(sourceNode){oldDisplay=sourceNode.style.display;sourceNode.style.display='none';}
try{var decoration=null;var X=0;while(spanIndex<nSpans){X=X+1;if(X>5000){break;}
var spanStart=spans[spanIndex];var spanEnd=spans[spanIndex+2]||sourceLength;var decEnd=decorations[decorationIndex+2]||sourceLength;var end=Math.min(spanEnd,decEnd);var textNode=spans[spanIndex+1];var styledText;if(textNode.nodeType!==1&&(styledText=source.substring(sourceIndex,end))){if(isIE8OrEarlier){styledText=styledText.replace(newlineRe,'\r');}
textNode.nodeValue=styledText;var document=textNode.ownerDocument;var span=document.createElement('span');span.className=decorations[decorationIndex+1];var parentNode=textNode.parentNode;parentNode.replaceChild(span,textNode);span.appendChild(textNode);if(sourceIndex<spanEnd){spans[spanIndex+1]=textNode=document.createTextNode(source.substring(end,spanEnd));parentNode.insertBefore(textNode,span.nextSibling);}}
sourceIndex=end;if(sourceIndex>=spanEnd){spanIndex+=2;}
if(sourceIndex>=decEnd){decorationIndex+=2;}}}finally{if(sourceNode){sourceNode.style.display=oldDisplay;}}}
var langHandlerRegistry={};function registerLangHandler(handler,fileExtensions){for(var i=fileExtensions.length;--i>=0;){var ext=fileExtensions[i];if(!langHandlerRegistry.hasOwnProperty(ext)){langHandlerRegistry[ext]=handler;}else if(win['console']){console['warn']('cannot override language handler %s',ext);}}}
function langHandlerForExtension(extension,source){if(!(extension&&langHandlerRegistry.hasOwnProperty(extension))){extension=/^\s*</.test(source)?'default-markup':'default-code';}
return langHandlerRegistry[extension];}
registerLangHandler(decorateSource,['default-code']);registerLangHandler(createSimpleLexer([],[[PR_PLAIN,/^[^<?]+/],[PR_DECLARATION,/^<!\w[^>]*(?:>|$)/],[PR_COMMENT,/^<\!--[\s\S]*?(?:-\->|$)/],['lang-',/^<\?([\s\S]+?)(?:\?>|$)/],['lang-',/^<%([\s\S]+?)(?:%>|$)/],[PR_PUNCTUATION,/^(?:<[%?]|[%?]>)/],['lang-',/^<xmp\b[^>]*>([\s\S]+?)<\/xmp\b[^>]*>/i],['lang-js',/^<script\b[^>]*>([\s\S]*?)(<\/script\b[^>]*>)/i],['lang-css',/^<style\b[^>]*>([\s\S]*?)(<\/style\b[^>]*>)/i],['lang-in.tag',/^(<\/?[a-z][^<>]*>)/i]]),['default-markup','htm','html','mxml','xhtml','xml','xsl']);registerLangHandler(createSimpleLexer([[PR_PLAIN,/^[\s]+/,null,' \t\r\n'],[PR_ATTRIB_VALUE,/^(?:\"[^\"]*\"?|\'[^\']*\'?)/,null,'\"\'']],[[PR_TAG,/^^<\/?[a-z](?:[\w.:-]*\w)?|\/?>$/i],[PR_ATTRIB_NAME,/^(?!style[\s=]|on)[a-z](?:[\w:-]*\w)?/i],['lang-uq.val',/^=\s*([^>\'\"\s]*(?:[^>\'\"\s\/]|\/(?=\s)))/],[PR_PUNCTUATION,/^[=<>\/]+/],['lang-js',/^on\w+\s*=\s*\"([^\"]+)\"/i],['lang-js',/^on\w+\s*=\s*\'([^\']+)\'/i],['lang-js',/^on\w+\s*=\s*([^\"\'>\s]+)/i],['lang-css',/^style\s*=\s*\"([^\"]+)\"/i],['lang-css',/^style\s*=\s*\'([^\']+)\'/i],['lang-css',/^style\s*=\s*([^\"\'>\s]+)/i]]),['in.tag']);registerLangHandler(createSimpleLexer([],[[PR_ATTRIB_VALUE,/^[\s\S]+/]]),['uq.val']);registerLangHandler(sourceDecorator({'keywords':CPP_KEYWORDS,'hashComments':true,'cStyleComments':true,'types':C_TYPES}),['c','cc','cpp','cxx','cyc','m']);registerLangHandler(sourceDecorator({'keywords':PHP_KEYWORDS,'hashComments':false,'cStyleComments':true,'multiLineStrings':true,'regexLiterals':true}),['php','phtml','inc']);registerLangHandler(sourceDecorator({'keywords':'null,true,false'}),['json']);registerLangHandler(sourceDecorator({'keywords':CSHARP_KEYWORDS,'hashComments':true,'cStyleComments':true,'verbatimStrings':true,'types':C_TYPES}),['cs']);registerLangHandler(sourceDecorator({'keywords':JAVA_KEYWORDS,'cStyleComments':true}),['java']);registerLangHandler(sourceDecorator({'keywords':SH_KEYWORDS,'hashComments':true,'multiLineStrings':true}),['bsh','csh','sh']);registerLangHandler(sourceDecorator({'keywords':PYTHON_KEYWORDS,'hashComments':true,'multiLineStrings':true,'tripleQuotedStrings':true}),['cv','py']);registerLangHandler(sourceDecorator({'keywords':PERL_KEYWORDS,'hashComments':true,'multiLineStrings':true,'regexLiterals':true}),['perl','pl','pm']);registerLangHandler(sourceDecorator({'keywords':RUBY_KEYWORDS,'hashComments':true,'multiLineStrings':true,'regexLiterals':true}),['rb']);registerLangHandler(sourceDecorator({'keywords':JSCRIPT_KEYWORDS,'cStyleComments':true,'regexLiterals':true}),['js']);registerLangHandler(sourceDecorator({'keywords':COFFEE_KEYWORDS,'hashComments':3,'cStyleComments':true,'multilineStrings':true,'tripleQuotedStrings':true,'regexLiterals':true}),['coffee']);registerLangHandler(createSimpleLexer([],[[PR_STRING,/^[\s\S]+/]]),['regex']);registerLangHandler(sourceDecorator({'keywords':CONFIG_KEYWORDS,'literals':CONFIG_OPTIONS,'strings':CONFIG_ENVS,'hashComments':true,'cStyleComments':false,'multiLineStrings':false,'regexLiterals':false,'httpdComments':true}),['config']);function applyDecorator(job){var opt_langExtension=job.langExtension;try{var sourceAndSpans=extractSourceSpans(job.sourceNode,job.pre);var source=sourceAndSpans.sourceCode;job.sourceCode=source;job.spans=sourceAndSpans.spans;job.basePos=0;langHandlerForExtension(opt_langExtension,source)(job);recombineTagsAndDecorations(job);}catch(e){if(win['console']){console['log'](e&&e['stack']?e['stack']:e);}}}
function prettyPrintOne(sourceCodeHtml,opt_langExtension,opt_numberLines){var container=document.createElement('pre');container.innerHTML=sourceCodeHtml;if(opt_numberLines){numberLines(container,opt_numberLines,true);}
var job={langExtension:opt_langExtension,numberLines:opt_numberLines,sourceNode:container,pre:1};applyDecorator(job);return container.innerHTML;}
function prettyPrint(opt_whenDone){function byTagName(tn){return document.getElementsByTagName(tn);}
var codeSegments=[byTagName('pre'),byTagName('code'),byTagName('xmp')];var elements=[];for(var i=0;i<codeSegments.length;++i){for(var j=0,n=codeSegments[i].length;j<n;++j){elements.push(codeSegments[i][j]);}}
codeSegments=null;var clock=Date;if(!clock['now']){clock={'now':function(){return+(new Date);}};}
var k=0;var prettyPrintingJob;var langExtensionRe=/\blang(?:uage)?-([\w.]+)(?!\S)/;var prettyPrintRe=/\bprettyprint\b/;var prettyPrintedRe=/\bprettyprinted\b/;var preformattedTagNameRe=/pre|xmp/i;var codeRe=/^code$/i;var preCodeXmpRe=/^(?:pre|code|xmp)$/i;function doWork(){var endTime=(win['PR_SHOULD_USE_CONTINUATION']?clock['now']()+250:Infinity);for(;k<elements.length&&clock['now']()<endTime;k++){var cs=elements[k];var className=cs.className;if(prettyPrintRe.test(className)&&!prettyPrintedRe.test(className)){var nested=false;for(var p=cs.parentNode;p;p=p.parentNode){var tn=p.tagName;if(preCodeXmpRe.test(tn)&&p.className&&prettyPrintRe.test(p.className)){nested=true;break;}}
if(!nested){cs.className+=' prettyprinted';var langExtension=className.match(langExtensionRe);var wrapper;if(!langExtension&&(wrapper=childContentWrapper(cs))&&codeRe.test(wrapper.tagName)){langExtension=wrapper.className.match(langExtensionRe);}
if(langExtension){langExtension=langExtension[1];}
var preformatted;if(preformattedTagNameRe.test(cs.tagName)){preformatted=1;}else{var currentStyle=cs['currentStyle'];var whitespace=(currentStyle?currentStyle['whiteSpace']:(document.defaultView&&document.defaultView.getComputedStyle)?document.defaultView.getComputedStyle(cs,null).getPropertyValue('white-space'):0);preformatted=whitespace&&'pre'===whitespace.substring(0,3);}
var lineNums=cs.className.match(/\blinenums\b(?::(\d+))?/);lineNums=lineNums?lineNums[1]&&lineNums[1].length?+lineNums[1]:true:false;if(lineNums){numberLines(cs,lineNums,preformatted);}
prettyPrintingJob={langExtension:langExtension,sourceNode:cs,numberLines:lineNums,pre:preformatted};applyDecorator(prettyPrintingJob);}}}
if(k<elements.length){setTimeout(doWork,250);}else if(opt_whenDone){opt_whenDone();}}
doWork();}
var PR=win['PR']={'createSimpleLexer':createSimpleLexer,'registerLangHandler':registerLangHandler,'sourceDecorator':sourceDecorator,'PR_ATTRIB_NAME':PR_ATTRIB_NAME,'PR_ATTRIB_VALUE':PR_ATTRIB_VALUE,'PR_COMMENT':PR_COMMENT,'PR_DECLARATION':PR_DECLARATION,'PR_KEYWORD':PR_KEYWORD,'PR_LITERAL':PR_LITERAL,'PR_NOCODE':PR_NOCODE,'PR_PLAIN':PR_PLAIN,'PR_PUNCTUATION':PR_PUNCTUATION,'PR_SOURCE':PR_SOURCE,'PR_STRING':PR_STRING,'PR_TAG':PR_TAG,'PR_TYPE':PR_TYPE,'prettyPrintOne':win['prettyPrintOne']=prettyPrintOne,'prettyPrint':win['prettyPrint']=prettyPrint};PR['registerLangHandler'](PR['createSimpleLexer']([[PR['PR_PLAIN'],/^[\t\n\r \xA0]+/,null,'\t\n\r \xA0'],[PR['PR_STRING'],/^(?:\"(?:[^\"\\]|\\[\s\S])*(?:\"|$)|\'(?:[^\'\\]|\\[\s\S])*(?:\'|$))/,null,'"\'']],[[PR['PR_COMMENT'],/^--(?:\[(=*)\[[\s\S]*?(?:\]\1\]|$)|[^\r\n]*)/],[PR['PR_TYPE'],/^nil|false|true/],[PR['PR_STRING'],/^\[(=*)\[[\s\S]*?(?:\]\1\]|$)/],[PR['PR_KEYWORD'],/^(?:and|break|do|else|elseif|end|for|function|if|in|local|not|or|repeat|require|return|then|until|while)\b/,null],[PR['PR_LITERAL'],/^[+-]?(?:0x[\da-f]+|(?:(?:\.\d+|\d+(?:\.\d*)?)(?:e[+\-]?\d+)?))/i],[PR['PR_PLAIN'],/^[a-z_]\w*/i],[PR['PR_PUNCTUATION'],/^[^\w\t\n\r \xA0][^\w\t\n\r \xA0\"\'\-\+=]*/]]),['lua']);if(typeof define==="function"&&define['amd']){define("google-code-prettify",[],function(){return PR;});}})(); httpd-2.4.64/docs/manual/style/xsl/ 0000775 0001751 0001751 00000000000 15032766627 017013 5 ustar covener covener httpd-2.4.64/docs/manual/style/xsl/util/ 0000775 0001751 0001751 00000000000 15032766627 017770 5 ustar covener covener httpd-2.4.64/docs/manual/style/lang/ 0000775 0001751 0001751 00000000000 15032766627 017126 5 ustar covener covener httpd-2.4.64/docs/manual/style/version.ent 0000664 0001751 0001751 00000001635 14744525602 020402 0 ustar covener covener <?xml version='1.0' encoding='UTF-8' ?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You 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.
-->
<!ENTITY httpd.major "2">
<!ENTITY httpd.minor "4">
<!ENTITY httpd.patch "64">
<!ENTITY httpd.docs "2.4">
httpd-2.4.64/docs/manual/style/latex/ 0000775 0001751 0001751 00000000000 15032766627 017322 5 ustar covener covener httpd-2.4.64/docs/manual/style/latex/atbeginend.sty 0000664 0001751 0001751 00000005026 10455056574 022163 0 ustar covener covener % atbeginend.sty
%
% Licensed to the Apache Software Foundation (ASF) under one or more
% contributor license agreements. See the NOTICE file distributed with
% this work for additional information regarding copyright ownership.
% The ASF licenses this file to You 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.
% defines
% \BeforeBegin{environment}{code-to-execute}
% \BeforeEnd {environment}{code-to-execute}
% \AfterBegin {environment}{code-to-execute}
% \AfterEnd {environment}{code-to-execute}
%
% Save \begin and \end to \BeginEnvironment and \EndEnvironment
\let\BeginEnvironment=\begin
\let\EndEnvironment=\end
\def\IfUnDef#1{\expandafter\ifx\csname#1\endcsname\relax}
% Null command needed to for \nothing{something}=.nothing.
\def\NullCom#1{}
\def\begin#1{%
%
% if defined \BeforeBeg for this environment, execute it
\IfUnDef{BeforeBeg#1}\else\csname BeforeBeg#1\endcsname\fi%
%
%
%
\IfUnDef{AfterBeg#1}% This is done to skip the command for environments
% which can take arguments, like multicols; YOU MUST NOT
% USE \AfterBegin{...}{...} for such environments!
\let\SaveBegEng=\BeginEnvironment%
\else%
% Start this environment
\BeginEnvironment{#1}%
% and execute code after \begin{environment}
\csname AfterBeg#1\endcsname%
%
\let\SaveBegEng=\NullCom%
\fi%
\SaveBegEng{#1}%
}
\def\end#1{%
%
% execute code before \end{environment}
\IfUnDef{BeforeEnd#1}\else\csname BeforeEnd#1\endcsname\fi%
%
% close this environment
\EndEnvironment{#1}%
%
% and execute code after \begin{environment}
\IfUnDef{AfterEnd#1}\else\csname AfterEnd#1\endcsname\fi%
}
%% Now, define commands
% \BeforeBegin{environment}{code-to-execute}
% \BeforeEnd {environment}{code-to-execute}
% \AfterBegin {environment}{code-to-execute}
% \AfterEnd {environment}{code-to-execute}
\def\BeforeBegin#1#2{\expandafter\gdef\csname BeforeBeg#1\endcsname
{#2}}
\def\BeforeEnd #1#2{\expandafter\gdef\csname BeforeEnd#1\endcsname
{#2}}
\def\AfterBegin #1#2{\expandafter\gdef\csname AfterBeg#1\endcsname {#2}}
\def\AfterEnd #1#2{\expandafter\gdef\csname AfterEnd#1\endcsname{#2}}
httpd-2.4.64/docs/manual/style/common.dtd 0000664 0001751 0001751 00000013425 14655360273 020174 0 ustar covener covener <?xml version='1.0' encoding='UTF-8' ?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You 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.
-->
<!-- Character mnemonic entities -->
<!ENTITY % HTMLlat1 PUBLIC
"-//W3C//ENTITIES Latin 1 for XHTML//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent">
%HTMLlat1;
<!ENTITY % HTMLsymbol PUBLIC
"-//W3C//ENTITIES Symbols for XHTML//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml-symbol.ent">
%HTMLsymbol;
<!ENTITY % HTMLspecial PUBLIC
"-//W3C//ENTITIES Special for XHTML//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml-special.ent">
%HTMLspecial;
<!-- HTTPD Version -->
<!ENTITY % HTTPD-VERSION SYSTEM "version.ent">
%HTTPD-VERSION;
<!-- Generic tag entities -->
<!ENTITY % inlinetags "em | strong | code | a | br | directive | module |
program | img | cite | q | dfn | var | transnote | glossary | phonetic | since">
<!ENTITY % blocktags "p | example | note | table | ul | ol | dl | pre |
highlight | blockquote">
<!ENTITY % Block "(%blocktags;)*">
<!ENTITY % Inline "(#PCDATA | %inlinetags;)*">
<!ENTITY % BlockOrInline "(#PCDATA | %inlinetags; | %blocktags;)*">
<!-- Common Elements -->
<!ELEMENT title %Inline;>
<!ELEMENT summary %Block;>
<!ELEMENT seealso %Inline;>
<!ELEMENT modulelist (module)+>
<!-- a page may have one or more sections. Each section is named by an
unique id. A section must have a title and some text. It may have
subsections and a list of related modules and directives -->
<!ELEMENT section (title, related?, (section | %blocktags;)*)>
<!ATTLIST section id ID #IMPLIED>
<!-- the lists of related modules and/or related directives -->
<!ELEMENT related (modulelist | directivelist)+>
<!-- list of related directives -->
<!ELEMENT directivelist (directive)+>
<!ELEMENT module (#PCDATA)>
<!ATTLIST module status CDATA #IMPLIED
outdated (true) #IMPLIED>
<!ELEMENT directive (#PCDATA)>
<!-- name attribute is preferred over contents when generating links,
and idtype is used to disambiguate two directives sharing the
same name but with different type (for example section and non-section).
-->
<!ATTLIST directive module CDATA #IMPLIED
type CDATA #IMPLIED
idtype CDATA #IMPLIED
status CDATA #IMPLIED
name CDATA #IMPLIED >
<!ELEMENT program (#PCDATA)>
<!ELEMENT p %Inline;>
<!ATTLIST p class CDATA #IMPLIED>
<!-- the indent element is used to indent code examples. example/indent and
code/indent is now replacing pre. -->
<!ELEMENT indent ( #PCDATA | indent | %inlinetags; )*>
<!ELEMENT em %Inline;>
<!ELEMENT strong %Inline;>
<!ELEMENT code (#PCDATA | indent | %inlinetags;)*>
<!ELEMENT cite %Inline;>
<!ELEMENT q %Inline;>
<!ELEMENT dfn %Inline;>
<!ELEMENT var %Inline;>
<!ELEMENT since %Inline;>
<!-- translators note -->
<!ELEMENT transnote %Inline;>
<!ELEMENT a %Inline;>
<!ATTLIST a href CDATA #IMPLIED
name CDATA #IMPLIED
id CDATA #IMPLIED
rel CDATA #IMPLIED >
<!ELEMENT br EMPTY>
<!-- Note: The example and note elements should not have more then one
title. -->
<!ELEMENT example (#PCDATA | title | indent | %inlinetags; | %blocktags;)*>
<!ELEMENT note (#PCDATA | title | %inlinetags; | %blocktags;)*>
<!ATTLIST note type CDATA #IMPLIED>
<!ELEMENT table (columnspec | tr)+>
<!ATTLIST table summary CDATA #IMPLIED
width CDATA #IMPLIED
bgcolor CDATA #IMPLIED
cellspacing CDATA #IMPLIED
cellpadding CDATA #IMPLIED
border CDATA #IMPLIED
style CDATA #IMPLIED>
<!ELEMENT columnspec (column)+>
<!ELEMENT column EMPTY>
<!ATTLIST column width CDATA #IMPLIED>
<!ELEMENT tr (th | td)+>
<!ATTLIST tr valign CDATA #IMPLIED >
<!ELEMENT th %BlockOrInline;>
<!ATTLIST th colspan CDATA #IMPLIED
rowspan CDATA #IMPLIED
class CDATA #IMPLIED >
<!ELEMENT td %BlockOrInline;>
<!ATTLIST td colspan CDATA #IMPLIED
rowspan CDATA #IMPLIED
class CDATA #IMPLIED >
<!ELEMENT ul (li+)>
<!ELEMENT ol (li+)>
<!ATTLIST ol type CDATA #IMPLIED>
<!ELEMENT li %BlockOrInline;>
<!ATTLIST li class CDATA #IMPLIED >
<!ELEMENT dl (dd | dt)+>
<!ELEMENT dt %Inline;>
<!ELEMENT dd %BlockOrInline;>
<!ELEMENT pre %Inline;>
<!ELEMENT highlight %Inline;>
<!ATTLIST highlight language CDATA #IMPLIED>
<!ELEMENT img EMPTY>
<!ATTLIST img
src CDATA #REQUIRED
alt CDATA #REQUIRED
border CDATA #IMPLIED
height CDATA #IMPLIED
width CDATA #IMPLIED >
<!ELEMENT blockquote %Block;>
<!ATTLIST blockquote cite CDATA #IMPLIED >
<!-- The path and title of the parent document -->
<!ELEMENT parentdocument (#PCDATA)>
<!ATTLIST parentdocument href CDATA #REQUIRED >
<!-- The glossary element defines a special case of link. The referenced
target is the name of an anchor within the glossary -->
<!ELEMENT glossary %Inline;>
<!ATTLIST glossary ref CDATA #IMPLIED>
<!-- The phonetic element should be used only within the glossary. It
describes a pronunciation -->
<!ELEMENT phonetic (#PCDATA)>
httpd-2.4.64/docs/manual/style/css/ 0000775 0001751 0001751 00000000000 15032766612 016767 5 ustar covener covener httpd-2.4.64/docs/manual/style/css/prettify.css 0000664 0001751 0001751 00000007040 12113256271 021340 0 ustar covener covener /* Pretty printing styles. Used with prettify.js. */
/* SPAN elements with the classes below are added by prettyprint. */
.pln { color: #000 } /* plain text */
@media screen {
.str { color: #060 } /* string content */
.kwd { color: #006 } /* a keyword */
.com { color: #600 } /* a comment */
.typ { color: #404 } /* a type name */
.lit { color: #066 } /* a literal value */
/* punctuation, lisp open bracket, lisp close bracket */
.pun, .opn, .clo { color: #660 }
.tag { color: #008 } /* a markup tag name */
.atn { color: #606 } /* a markup attribute name */
.atv { color: #080 } /* a markup attribute value */
.dec, .var { color: #606 } /* a declaration; a variable name */
.fun { color: red } /* a function name */
}
/* Use higher contrast and text-weight for printable form. */
@media print, projection {
.str { color: #060 }
.kwd { color: #006; font-weight: bold }
.com { color: #600; font-style: italic }
.typ { color: #404; font-weight: bold }
.lit { color: #044 }
.pun, .opn, .clo { color: #440 }
.tag { color: #006; font-weight: bold }
.atn { color: #404 }
.atv { color: #060 }
}
/* Put a border around prettyprinted code snippets. */
pre.prettyprint { padding: 2px; border: 1px solid #888; tab-size: 4; overflow: auto; overflow-y: hidden; }
/* Specify class=linenums on a pre to get line numbering */
ol.linenums { margin-top: 0; margin-bottom: 0 } /* IE indents via margin-left */
li.L0,
li.L1,
li.L2,
li.L3,
li.L5,
li.L6,
li.L7,
li.L8 { list-style-type: none }
/* Alternate shading for lines */
li.L1,
li.L3,
li.L5,
li.L7,
li.L9 { background: #eee }
/* Highlighting style for Apache configuration files */
pre.lang-config{
background-color: #e5ecf3;
color: #000;
padding: 0.5em;
margin: 1em 2em 1em 1em;
border: none;
}
.lang-config .tag { color: #821; font-weight: bold } /* enclosures */
.lang-config .kwd { color: #128; font-weight: bold } /* directives */
.lang-config .com { color: #c46d34 } /* comments */
.lang-config .lit { color: #077 } /* miscellaneous types: Options arguments, handler names etc */
/* Highlighting style for C source code */
pre.lang-c{
background-color: #f8f6ee;
color: #000;
padding: 0.5em;
margin: 1em 2em 1em 1em;
border: 1px dotted #666;
}
.lang-c .com { color: #c46d34 } /* a comment */
.lang-c .lit { color: #088 } /* a literal */
.lang-c .str { color: #009606 } /* string content */
.lang-c .kwd { color: #00C; font-weight: bold } /* a keyword */
.lang-c .typ { color: #808 } /* a type name */
.lang-c .tag { color: #248 } /* a markup tag name */
/* Highlighting style for Lua source code */
pre.lang-lua{
background-color: #f8f6ee;
color: #000;
padding: 0.5em;
margin: 1em 2em 1em 1em;
border: 1px dotted #666;
}
.lang-lua .com { color: #c34e00 } /* a comment */
.lang-lua .lit { color: #088 } /* a literal (in this context; a known directive argument, a number or an IP address) */
.lang-lua .str { color: #009606 } /* string content */
.lang-lua .kwd { color: #00C; font-weight: bold } /* a keyword */
.lang-lua .typ { color: #808 } /* a type name */
/* Highlighting style for Perl source code */
pre.lang-perl{
background-color: #f8f6ee;
color: #000;
padding: 0.5em;
margin: 1em 2em 1em 1em;
border: 1px dotted #666;
}
.lang-perl .com { color: #c34e00 } /* a comment */
.lang-perl .lit { color: #088 } /* a literal */
.lang-perl .str { color: #009606 } /* string content */
.lang-perl .kwd { color: #00C; font-weight: bold } /* a keyword */
.lang-perl .typ { color: #808 } /* a type name */
httpd-2.4.64/docs/manual/style/css/manual-chm.css 0000664 0001751 0001751 00000001623 10455056330 021516 0 ustar covener covener @import url(manual-loose-100pc.css);
/* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/
html {
font-size: 95%;
}
h1 {
margin: 0 0 0.5em 0;
}
/* the end */
httpd-2.4.64/docs/manual/style/css/manual-zip.css 0000664 0001751 0001751 00000001552 10455056330 021552 0 ustar covener covener @import url(manual.css);
/* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/
h1 {
margin: 0 0 0.5em 0;
}
/* the end */
httpd-2.4.64/docs/manual/style/css/manual-loose-100pc.css 0000664 0001751 0001751 00000005771 10455056330 022721 0 ustar covener covener /* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* manual.css - no sidebar, 100% normal font height
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/
/* import the main CSS, so we
* have to adjust only a few things
*/
@import url(manual.css);
html {
font-size: 100%;
}
/* "sidebar" background is white here */
div#quickview a:hover,
div#quickview a:active {
background-color: #f0f0f0;
color: #0073c7;
}
div#quickview code.module a:hover,
div#quickview code.module a:active {
background-color: #f0f0f0;
color: #8b4513;
}
div#quickview code.directive a:hover,
div#quickview code.directive a:active {
background-color: #f0f0f0;
color: #287f00;
}
h1 {
font-size: 1.5em;
}
h2 {
font-size: 1.2em;
}
.category h2 {
font-size: 1em;
}
h3 {
font-size: 1.1em;
}
h4 {
font-size: 1em;
}
div.example h3,
div.note h3,
div.warning h3 {
font-size: 1em;
}
div#quickview h3,
div#quickview h3.directives {
margin: 1em 0 0.3em 0;
font-size: 1.1em;
}
div#quickview h3.directives {
margin-top: 0;
}
div#quickview li {
font-size: 1em;
}
div#quickview ul {
margin-bottom: 1em;
}
div#quickview ul#toc {
margin-left: 0;
}
div#quickview li img {
display: inline;
margin-right: 19px;
}
#module-index div#quickview ul#toc,
#manual-page div#quickview ul#toc,
div#quickview #topics {
padding-left: 0;
}
div#quickview .seealso {
padding-left: 34px;
}
#module-index div#quickview ul#toc li,
#manual-page div#quickview ul#toc li,
div#quickview #topics li,
div#quickview .seealso li {
margin: 0;
list-style-type: none;
}
div#page-header p.menu,
div#path,
div#footer {
font-size: smaller;
}
div#quickview {
position: static;
margin: 0 0 1em 30px;
padding: 0;
width: auto;
background-color: #fff;
}
div#page-content {
margin-right: 0;
padding-right: 0;
}
div.example pre,
div.example p > code {
font-size: 0.9em;
}
div.note pre,
div.warning pre {
font-size: 0.9em;
}
table.qref td.descr {
font-size: 0.9em;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* -> The End <-
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
httpd-2.4.64/docs/manual/style/css/manual-print.css 0000664 0001751 0001751 00000031620 10455056330 022103 0 ustar covener covener /* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* manual.css for printers
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* mainframe ;-)
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
html {
font-size: 11pt;
}
body {
background-color: #fff;
color: #000;
padding: 0 0 0 0;
margin: 0;
font-family: "Times New Roman", serif;
font-weight: normal;
}
pre, code {
font-family: "Courier New", Courier, monospace;
}
strong {
font-weight: bold;
}
q, em, var {
font-style: italic;
}
span.transnote, span.phonetic {
font-weight: normal;
background-color: inherit;
color: #888;
}
/* fixup IE & Opera
* otherwise they forget to inherit
* the computed font-size value
*/
table, code {
font-size: 1em;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Links
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* normal links */
/* ====================== */
a:link,
a:visited,
a:hover,
a:active {
color: #000;
background-color: inherit;
text-decoration: none;
}
/* sidebar */
div#quickview a:hover,
div#quickview a:active {
background-color: #fff;
color: #000;
}
/* EXPERIMENTAL! I'm waiting for complaints... */
#page-content p > a[href]:after {
content: " (\002197\0000A0" attr(href) ") ";
color: #036;
}
/* code.module [links] */
/* ====================== */
code.module,
code.module a:link,
code.module a:visited,
code.module a:hover,
code.module a:active {
color: #8b4513;
background-color: inherit;
text-decoration: none;
}
/* code.directive [links] */
/* ====================== */
code.directive,
code.directive a:link,
code.directive a:visited,
code.directive a:hover,
code.directive a:active {
color: #287f00;
background-color: inherit;
text-decoration: none;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Headings
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* h1 */
/* ====================== */
h1 {
padding: 0 0 0.2em 0;
margin: 1em 0 0.5em 0;
border-style: none none solid none;
border-bottom-width: 1px;
border-bottom-color: #405871;
background-color: inherit;
color: #000;
text-decoration: none;
font-size: 17pt;
font-weight: bold;
text-align: center;
}
/* h2 */
/* ====================== */
h2 {
padding: 0.2em 0 0.2em 0.2em;
margin: 0 0 0.5em 0;
width: 80%;
text-decoration: none;
font-size: 15pt;
font-weight: bold;
border-bottom: 1px solid #000;
text-align: left;
}
.section h2,
.directive-section h2,
.category h2 {
background-color: #fff;
color: #000;
}
/* take care of <a name>s inside */
h2 a,
h2 a:hover,
h2 a:active {
color: inherit;
background-color: inherit;
text-decoration: none;
}
/* h3, h4 */
/* ====================== */
h3 {
background-color: inherit;
color: #000;
text-decoration: none;
font-weight: bold;
font-size: 13pt;
margin: 1.3em 0 0.4em 0;
padding: 0 0 0 0.2em;
}
h4 {
background-color: inherit;
color: #000;
text-decoration: none;
font-weight: bold;
font-size: 11pt;
margin: 1.3em 0 0.2em 0;
padding: 0 0 0 0.2em;
}
/* margin adjustment */
h3 + *, h4 + * {
margin-top: 0;
}
/* IE confuses the + * :-(
* so reset some things
*/
ul, .section table, .directive-section table {
margin-bottom: 1em;
}
/* titles for
* examples, notes and warnings
*/
div.example h3,
div.note h3,
div.warning h3 {
margin: 0 0 0.5em 0;
text-align: left;
font-size: 11pt;
}
/* sidebar */
div#quickview h3 {
margin: 1em 0 0.3em 0;
font-size: 13pt;
}
div#quickview h3.directives {
margin-top: 0;
}
/* take care of <a name>s inside */
h3 a,
h3 a:hover,
h3 a:active,
h4 a,
h4 a:hover,
h4 a:active {
color: inherit;
background-color: inherit;
text-decoration: none;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Up & Top helper images
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
div.up,
div.top {
display: none;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Tables
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* general */
/* ====================== */
table {
border: 1px solid #000;
border-collapse: collapse;
padding: 2px;
margin-top: 0.5em;
margin-bottom: 0;
margin-left: 1px; /* border-width == 1px */
}
td, th {
empty-cells: show; /* show border around empty cells */
padding: 0.1em 0.2em;
vertical-align: top;
text-align: left;
line-height: 1.1em;
}
th {
font-weight: bold;
}
td.centered {
text-align: center;
}
tr.header, tr.header th {
border-top: 1px solid #000;
border-bottom: 1px solid #000;
}
/* bordered table cells */
/* ====================== */
/* turn off borders in tables nested in
* bordered tables per default
*/
table.bordered table td,
table.bordered table th {
border-style: none;
}
table.bordered td,
table.bordered th,
table table.bordered td,
table table.bordered th {
border: 1px solid #000;
}
/* mod/dir. overview table and quick reference */
/* ============================================ */
table.module th,
table.directive th {
white-space: nowrap;
}
table.qref {
border-collapse: collapse;
width: auto;
}
table.qref td {
border-style: none solid;
border-color: #000;
border-width: 1px;
}
table.qref td.descr {
padding-left: 1em;
font-size: 11pt;
}
table#legend {
width: 100%;
border-style: none;
border-width: 0;
vertical-align: bottom;
padding: 0;
margin: 0;
}
table#legend td {
vertical-align: bottom;
margin: 0;
padding: 0;
}
table#legend table {
vertical-align: bottom;
margin: 0 0 0 0.4em;
padding: 0;
height: 7.5em;
}
table#legend td.letters span {
display: none;
}
table#legend table td,
table#legend table th {
vertical-align: middle;
padding: 0.1ex 0.2em;
line-height: 1em;
}
/* related modules & dir. */
/* ====================== */
/* assuming, all links are enclosed by
* <code class="directive"> or
* <code class="module">
*/
table.related {
border-collapse: collapse;
}
table.related th,
table.related td {
background-color: #fff;
color: #000;
padding: 0.2ex 0.4em;
border: 1px solid #000;
}
table.related th {
vertical-align: middle;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Lists
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* list default values */
/* ====================== */
ul {
list-style-type: disc;
}
ul ul {
list-style-type: square;
}
ul ul ul {
list-style-type: circle;
}
li, dt, dd {
line-height: 1.1em;
}
dt {
margin-top: 0.5em;
font-weight: bold;
}
ol li {
margin-top: 0.5em;
}
ol.up-A {
list-style-type: upper-alpha;
}
/* table of contents */
/* ====================== */
#toc,
#topics {
margin: 0;
padding: 0;
}
#toc li,
#topics li {
list-style-type: square;
margin: 0 0 1em 0;
padding: 0;
}
#toc li img,
#topics li img {
margin-right: 19px;
}
/* see also */
/* ====================== */
.seealso {
margin: 0;
padding: 0;
}
.seealso li {
list-style-type: square;
margin: 0 0 1em 0;
padding: 0 0 0 34px;
}
/* related modules & dir. */
/* ====================== */
table.related td ul,
table.related td li {
list-style-type: none;
margin: 0;
padding: 0;
}
/* list of all directives */
/* ====================== */
div#directive-list ul {
margin: 0;
padding: 0;
}
/* quickview */
/* ====================== */
div#quickview li {
font-size: 11pt;
}
div#quickview ul {
margin: 0;
padding: 0;
}
div#quickview ul#toc {
margin: 0;
padding: 0;
}
div#quickview ul#toc li {
margin: 0 0 0 1em;
padding: 0;
list-style-type: square;
list-style-position: outside;
}
div#quickview li img {
display: none;
}
#module-index div#quickview ul#toc,
#manual-page div#quickview ul#toc,
div#quickview #topics,
div#quickview .seealso {
padding-left: 0;
}
#module-index div#quickview ul#toc li,
#manual-page div#quickview ul#toc li,
div#quickview #topics li,
div#quickview .seealso li {
margin: 0 0 2px 1em;
padding: 0;
list-style-type: square;
list-style-position: outside;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* main page sections
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* page header */
/* ====================== */
div#page-header {
margin-left: 0;
}
div#page-header img {
display: none;
}
div#page-header p.apache {
background-color: #fff;
color: #000;
padding: 0;
margin: 0;
text-align: center;
vertical-align: middle;
font-size: 20pt;
font-weight: bold;
line-height: 20pt;
}
div#page-header p.menu {
display: none;
}
/* breadcrumb navigation */
div#path {
display: none;
}
/* content sections */
/* ====================== */
div#preamble {
padding-bottom: 1em;
margin-left: 0;
}
div.section,
div.directive-section {
margin: 0;
padding: 0;
}
.section p,
.directive-section p {
margin: 0 0 1em 0;
padding: 0;
}
/* look for this on directive
* list pages
*/
div#directive-list {
margin-left: 0;
padding: 0 0 1em 1em;
}
div#directive-ref {
margin: -1em 0 0 1px;
padding: 0 0 1em 0;
width: auto;
}
/* no sidebar */
div#quickview {
position: static;
margin: 0 0 1em 0;
padding: 0;
width: auto;
background-color: #fff;
color: inherit;
}
/* -> keep content wide */
div#page-content {
padding-top: 0;
margin-right: 0;
padding-right: 0;
}
/* in general */
p {
line-height: 1.1em;
}
/* page footer */
/* ====================== */
div#footer {
margin-left: 0;
font-size: 11pt;
border-top: 1px solid #000;
padding-top: 0.2em;
}
div#footer p.apache {
float: none;
text-align: center;
padding: 0 0 1em 0;
margin-top: 0;
font-weight: bold;
}
div.toplang,
div.bottomlang,
div#footer p.menu {
display: none;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* subsections (examples, notes, warnings)
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* examples */
/* ====================== */
div.example,
div.note div.example {
background-color: #fff;
color: #000;
padding: 0.5em;
margin: 1em;
border: 1px dotted #000;
}
/* the following [block] elements
* may appear inside example...
*/
div.example p,
div.example pre,
div.example table {
padding: 0;
margin: 0;
}
div.example p {
line-height: 1em;
}
div.example pre,
div.example p > code {
font-size: 10pt;
}
/* notes & warnings */
/* ====================== */
div.note,
div.warning {
background-color: #fff;
color: #000;
border: 1px solid #000;
padding: 0.5em;
margin: 1em;
}
div.note p,
div.warning p {
margin: 0;
padding: 0;
}
div.note pre,
div.warning pre {
font-size: 10pt;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* quotations, indented paragraphs and figures
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
p.letters {
display: none;
}
blockquote p {
font-style: italic;
margin: 0;
}
blockquote p.cite {
font-style: normal;
margin-top: 0;
margin-left: 2em;
}
blockquote p.cite cite {
font-style: normal;
}
p.indent {
margin-left: 2em;
margin-top: 1em;
}
#index-page form {
display: none;
}
p.figure {
margin-left: 2em;
font-style: italic;
}
p.figure img {
border: 1px solid #000;
}
p.figure dfn {
font-weight: bold;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* -> The End <-
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
httpd-2.4.64/docs/manual/style/css/manual.css 0000664 0001751 0001751 00000045211 13154522721 020753 0 ustar covener covener /* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* manual.css
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* mainframe ;-)
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
html {
font-size: 14px;
}
body {
background-color: #fff;
color: #036;
padding: 0 1em 0 0;
margin: 0;
font-family: Arial, Helvetica, sans-serif;
font-weight: normal;
}
pre, code {
font-family: "Courier New", Courier, monospace;
}
strong {
font-weight: bold;
}
q, em, var {
font-style: italic;
}
span.transnote, span.phonetic {
font-weight: normal;
background-color: inherit;
color: #888;
}
/* fixup IE & Opera
* otherwise they forget to inherit
* the computed font-size value
*/
table, code {
font-size: 1em;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Links
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* normal links */
/* ====================== */
a:link {
color: #0073c7;
background-color: inherit;
}
a:visited {
color: #5A88B5;
background-color: inherit;
}
a:link:hover,
a:link:active,
a:visited:hover,
a:visited:active {
color: #0073c7;
background-color: #f0f0f0;
}
/* hover on non-white backgrounds */
tr.odd a:hover,
tr.odd a:active,
tr.header a:hover,
tr.header a:active,
div.note a:hover,
div.note a:active,
div.example a:hover,
div.example a:active,
div.warning a:hover,
div.warning a:active,
div#quickview a:hover,
div#quickview a:active {
background-color: #fff;
color: #0073c7;
}
/* code.module [links] */
/* ====================== */
code.module,
code.module a:link {
color: #8b4513;
background-color: inherit;
}
code.module a:visited {
color: #bc8f8f;
background-color: inherit;
}
code.module a:hover,
code.module a:active {
color: #8b4513;
background-color: #f0f0f0;
}
/* hover on non-white backgrounds */
tr.odd code.module a:hover,
tr.odd code.module a:active,
tr.header code.module a:hover,
tr.header code.module a:active,
div.note code.module a:hover,
div.note code.module a:active,
div.example code.module a:hover,
div.example code.module a:active,
div.warning code.module a:hover,
div.warning code.module a:active,
div#quickview code.module a:hover,
div#quickview code.module a:active {
background-color: #fff;
color: #8b4513;
}
/* code.directive [links] */
/* ====================== */
code.directive,
code.directive a:link {
color: #287f00;
background-color: inherit;
}
code.directive a:visited {
color: #35a500;
background-color: inherit;
}
code.directive a:hover,
code.directive a:active {
color: #287f00;
background-color: #f0f0f0;
}
/* hover on non-white backgrounds */
tr.odd code.directive a:hover,
tr.odd code.directive a:active,
tr.header code.directive a:hover,
tr.header code.directive a:active,
div.note code.directive a:hover,
div.note code.directive a:active,
div.example code.directive a:hover,
div.example code.directive a:active,
div.warning code.directive a:hover,
div.warning code.directive a:active,
div#quickview code.directive a:hover,
div#quickview code.directive a:active {
background-color: #fff;
color: #287f00;
}
/* glossary [links] */
/* ====================== */
.glossarylink {
cursor: help;
border-bottom: 1px dashed #0073c7;
text-decoration: none;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Headings
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* h1 */
/* ====================== */
h1 {
padding: 0.2em;
margin: 0;
border: 1px solid #405871;
background-color: inherit;
color: #036;
text-decoration: none;
font-size: 22px;
font-weight: bold;
}
/* h2 */
/* ====================== */
h2 {
padding: 0.2em 0 0.2em 0.7em;
margin: 0 0 0.5em 0;
text-decoration: none;
font-size: 18px;
font-weight: bold;
}
.section h2 {
background-color: #405871;
color: #fff;
}
.directive-section h2 {
background-color: #557697;
color: #fff;
}
.category h2 {
background-color: #e5ecf3;
color: #405871;
font-size: 14px;
}
/* take care of <a name>s inside */
h2 a,
h2 a:hover,
h2 a:active {
color: inherit;
background-color: inherit;
text-decoration: none;
}
/* h3, h4 */
/* ====================== */
h3 {
background-color: inherit;
color: #036;
text-decoration: none;
font-weight: bold;
font-size: 16px;
margin: 1.3em 0 0.4em 0;
padding: 0;
}
h4 {
background-color: inherit;
color: #036;
text-decoration: none;
font-weight: bold;
font-size: 14px;
margin: 1.3em 0 0.2em 0;
padding: 0;
}
/* margin adjustment */
h3 + *, h4 + * {
margin-top: 0;
}
/* IE confuses the + * :-(
* so reset some things
*/
ul, .section table, .directive-section table {
margin-bottom: 1em;
}
/* titles for
* examples, notes and warnings
*/
div.example h3,
div.note h3,
div.warning h3 {
margin: 0 0 0.5em 0;
text-align: left;
font-size: 14px;
}
/* sidebar */
div#quickview h3 {
margin: 1em 0 0.3em 0.5em;
font-size: 15px;
}
div#quickview h3.directives {
margin-top: 0.3em;
}
/* take care of <a name>s inside */
h3 a,
h3 a:hover,
h3 a:active,
h4 a,
h4 a:hover,
h4 a:active {
color: inherit;
background-color: inherit;
text-decoration: none;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Up & Top helper images
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* arrow left */
/* ====================== */
div.up {
width: 30px;
height: 20px;
padding: 0;
margin: -20px 0 1px 0;
text-align: center;
vertical-align: top;
}
div.up img {
vertical-align: top;
width: 11px;
height: 11px;
border-style: none;
}
/* arrow up (to page top) */
/* ====================== */
div.top {
width: 30px;
padding: 0 0 0 30px;
margin: 0;
}
div.top img {
margin-top: 0.5em;
vertical-align: bottom;
width: 11px;
height: 11px;
border-style: none;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Tables
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* general */
/* ====================== */
table {
border: 1px solid #aaa;
border-collapse: collapse;
padding: 2px;
margin-top: 0.5em;
margin-bottom: 0;
}
td, th {
empty-cells: show; /* show border around empty cells */
padding: 0.1em 0.2em;
vertical-align: top;
text-align: left;
line-height: 1.3em;
}
th {
font-weight: bold;
}
td.centered {
text-align: center;
}
td.data {
font-family: monospace;
text-align: right;
padding-left: 1em;
}
th.data {
text-align: right;
}
tr.odd { /* for large tables alternating colors */
background-color: #f2f2f2;
}
tr.header, tr.header th {
background-color: #e2e2e2;
border-top: 1px solid #aaa;
border-bottom: 1px solid #aaa;
}
/* bordered table cells */
/* ====================== */
/* turn off borders in tables nested in
* bordered tables per default
*/
table.bordered table td,
table.bordered table th {
border-style: none;
}
table.bordered td,
table.bordered th,
table table.bordered td,
table table.bordered th {
border: 1px solid #aaa;
}
/* index page layout table */
/* ======================= */
body#index-page div#page-content {
width: 100%; /* IE fun */
}
body[id]#index-page div#page-content {
width: auto; /* reasonable browsers. */
}
table#indextable {
width: 100%;
border-collapse: collapse;
border: 0 none;
}
table#indextable td {
width: 33.3%;
border-left: 1px solid #aaa;
padding-top: 0;
padding-bottom: 0;
}
table#indextable td.col1 {
border-left: 0 none;
padding-left: 0;
}
table#indextable td.col3 {
padding-right: 0;
}
/* mod/dir. overview table and quick reference */
/* ============================================ */
table.module th,
table.directive th {
white-space: nowrap;
}
table.qref {
border-collapse: collapse;
width: 100%;
}
table.qref td {
border-style: none solid;
border-color: #aaa;
border-width: 1px;
}
table.qref td.descr {
padding-left: 1em;
font-size: 13px;
}
table#legend {
width: 100%;
border-style: none;
border-width: 0;
vertical-align: bottom;
padding: 0;
margin: 0;
}
table#legend td {
vertical-align: bottom;
margin: 0;
padding: 0;
}
table#legend td.letters {
width: 100%;
padding-bottom: 0.5em;
}
table#legend table {
vertical-align: bottom;
margin: 0 0 0 0.4em;
padding: 0;
height: 7.5em;
}
table#legend table td,
table#legend table th {
vertical-align: middle;
padding: 0.1ex 0.2em;
line-height: 1em;
white-space: nowrap;
}
/* related modules & dir. */
/* ====================== */
/* assuming, all links are enclosed by
* <code class="directive"> or
* <code class="module">
*/
table.related {
border-collapse: separate;
}
table.related th {
padding: 0.2ex 0.3em;
background-color: #e5ecf3;
color: #405871;
vertical-align: middle;
}
table.related td {
padding: 0.2ex 0.3em;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Lists
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* list default values */
/* ====================== */
ul {
list-style-type: disc;
}
ul ul {
list-style-type: square;
}
ul ul ul {
list-style-type: circle;
}
li, dt, dd {
line-height: 1.3em;
}
dt {
margin-top: 0.5em;
font-weight: bold;
}
ol li {
margin-top: 0.5em;
}
ol.up-A {
list-style-type: upper-alpha;
}
ol.lo-A {
list-style-type: lower-alpha;
}
dd.separate {
margin-bottom: 2em;
}
li.separate {
margin-bottom: 1em;
}
/* table of contents */
/* ====================== */
#toc,
#topics {
margin: 0 0 1em 0;
padding: 0;
}
#toc li,
#topics li {
list-style-type: none;
margin: 0;
padding: 0;
}
/* see also */
/* ====================== */
.seealso {
margin: 0 0 1em 0;
padding: 0;
}
.seealso li {
list-style-type: none;
margin: 0;
padding: 0 0 0 34px;
}
/* related modules & dir. */
/* ====================== */
table.related td ul,
table.related td li {
list-style-type: none;
margin: 0;
padding: 0;
}
/* list of all directives */
/* ====================== */
div#directive-list ul {
margin: 0;
padding: 0;
}
/* override index */
/* ============== */
div#override-list td.module {
width: 20%;
}
/* indextable */
/* ========== */
table#indextable td ul {
list-style-type: none;
margin: 0 0 1em 0.5em;
padding: 0 0 0 0;
}
table#indextable td ul li {
margin-top: 0.3em;
}
/* sidebar */
/* ====================== */
div#quickview li {
font-size: 13px;
}
div#quickview ul {
margin: 0 0 15px 0;
padding: 0;
}
div#quickview ul#toc {
margin: 0 0 0 0.5em;
padding: 0;
}
#module-index div#quickview ul#toc,
#manual-page div#quickview ul#toc {
margin-left: 0;
}
div#quickview ul#toc li {
margin: 0;
padding: 0;
list-style-type: none;
}
div#quickview li img {
display: none;
}
#module-index div#quickview ul#toc,
#manual-page div#quickview ul#toc,
div#quickview #topics,
div#quickview .seealso {
padding-left: 15px;
}
#module-index div#quickview ul#toc li,
#manual-page div#quickview ul#toc li,
div#quickview #topics li,
div#quickview .seealso li {
margin: 0.4em 0 2px 0;
padding: 0;
list-style-type: square;
list-style-position: outside;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* main page sections
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* page header */
/* ====================== */
div#page-header {
margin-left: 30px;
}
div#page-header img {
padding: 0;
display: block;
margin: -70px 0 1px 2em;
width: 248px;
height: 70px;
}
div#quickview a.badge {
/* Temporary hack for the Support Apache badge */
background-color: transparent;
}
div#quickview a.badge img {
/* Temporary hack for the Support Apache badge */
width: 95px;
height: 95px;
}
div#page-header p.apache {
background-color: #405871;
color: #fff;
padding: 0 0 0 248px;
margin: 0;
text-align: center;
vertical-align: middle;
font-size: 16px;
font-weight: bold;
line-height: 29px;
}
div#page-header p.menu {
text-align: right;
font-size: 13px;
margin: 30px 0 0.5em 0;
padding: 0;
}
/* breadcrumb navigation */
div#path {
margin: 0.2em 0 1.2em 30px;
padding: 0;
font-size: 13px;
}
/* content sections */
/* ====================== */
div#preamble {
padding-bottom: 1em;
margin-left: 30px;
}
div.section,
div.directive-section {
margin: -1.2em 0 0 60px;
padding: 0;
}
.section p,
.directive-section p {
margin: 0 0 1em 0;
padding: 0;
}
/* look for this on directive
* list pages
*/
div#directive-list {
margin-left: 30px;
padding: 0 0 1em 1em;
}
div#directive-ref {
margin: -1em 0 0 0;
padding: 0 0 1em 30px;
width: 100%; /* IE is BAD (broken as designed) */
}
div[id]#directive-ref { /* a big sorry to ICab, Amaya (and old Konquerors?) */
width: auto; /* other browsers are fine ;-) */
}
/* sidebar position: right */
div#quickview {
position: absolute;
top: 5.5em;
right: 1em;
margin-left: 0;
margin-top: 40px;
padding: 4px;
width: 13.5em;
background-color: #f0f0f0;
color: inherit;
}
/* -> move content left */
div#page-content {
padding-top: 0;
margin-right: 13em;
padding-right: 30px;
}
/* unsqueeze on some pages... */
body.no-sidebar div#page-content,
body#index-page div#page-content {
margin-right: 0;
padding-right: 0;
}
body#index-page div#page-content {
margin-left: 30px;
padding-bottom: 1em;
}
/* in general */
p {
line-height: 1.3em;
}
/* translations */
/* ====================== */
.toplang {
padding: 0;
margin: 0.2em 0.2em 1em 0;
}
.bottomlang {
padding: 0;
margin: 0 0.2em 0.2em 0;
}
.toplang p,
.bottomlang p {
font-size: 13px;
text-align: right;
background-color: inherit;
color: #ccc;
margin: 0;
padding: 0;
}
.toplang p span,
.bottomlang p span {
background-color: inherit;
color: #036;
}
.toplang p a:link,
.toplang p a:visited,
.bottomlang p a:link,
.bottomlang p a:visited {
text-decoration: none;
font-weight: bold;
}
.toplang p a:hover,
.toplang p a:active,
.bottomlang p a:hover,
.bottomlang p a:active {
font-weight: bold;
}
/* page footer */
/* ====================== */
div#footer {
margin-left: 30px;
font-size: 13px;
border-top: 1px solid #405871;
padding-top: 0.2em;
}
div#footer p.apache {
float: left;
text-align: left;
padding: 0 0 1em 0;
margin-top: 0;
}
div#footer p.menu {
float: right;
text-align: right;
margin-top: 0;
padding: 0 0 1em 0;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* subsections (examples, notes, warnings)
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
/* examples */
/* ====================== */
div.example {
background-color: #e5ecf3;
color: #000;
padding: 0.5em;
margin: 1em 2em 1em 1em;
}
/* example inside a note:
* blue in gray doesn't look good
* so simply draw a border around
* and keep it gray
*/
div.note div.example,
div.warning div.example {
border: 1px solid #aaa;
background-color: transparent;
color: inherit;
margin-right: 1em;
}
/* example inside table */
table div.example {
margin-right: 1em;
}
/* the following [block] elements
* may appear inside example...
*/
div.example p,
div.example pre,
div.example table {
padding: 0;
margin: 0;
}
div.example p {
line-height: 1em;
}
div.example pre,
div.example p > code {
font-size: 13px;
}
/* notes & warnings */
/* ====================== */
div.note,
div.warning {
background-color: #eee;
color: #036;
padding: 0.5em;
margin: 1em 2em 1em 1em;
}
div.warning {
border: 1px solid #f00;
}
div.note p,
div.warning p {
margin: 0.5em 0 0 0;
padding: 0;
}
div.note pre,
div.warning pre {
font-size: 13px;
}
/* inside table */
table div.note,
table div.warning {
margin-right: 1em;
}
div.outofdate,
div.retired{
background-color: #ffffc0;
color: #036;
padding: 0.5em;
margin: 1em 2em 1em 1em;
}
div.retired{
border: solid 1px #ff0000;
margin-left: 3em;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* quotations, indented paragraphs, forms and figures
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
p.letters {
margin: 1em 0 0 0;
}
p.centered {
text-align: center;
}
.letters {
text-align: center;
background-color: inherit;
color: #ccc;
}
.letters a:link,
.letters a:visited {
text-decoration: none;
font-weight: bold;
}
.letters a:hover,
.letters a:active {
font-weight: bold;
}
blockquote p {
font-style: italic;
margin: 0;
}
blockquote p.cite {
font-style: normal;
margin-top: 0;
margin-left: 2em;
}
blockquote p.cite cite {
font-style: normal;
}
p.indent {
margin-left: 2em;
margin-top: 1em;
}
span.indent {
padding-left: 1.5em;
display: block;
}
#index-page form {
text-align: center;
}
#index-page form p {
line-height: 1.1em;
}
#index-page form input {
font-size: 1em;
}
p.figure {
margin-left: 2em;
font-style: italic;
}
p.figure img {
border: 1px solid #aaa;
}
p.figure dfn {
font-weight: bold;
}
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* -> The End <-
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */
httpd-2.4.64/docs/manual/style/css/manual-zip-100pc.css 0000664 0001751 0001751 00000001565 10455056330 022377 0 ustar covener covener @import url(manual-loose-100pc.css);
/* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/
h1 {
margin: 0 0 0.5em 0;
}
/* the end */
httpd-2.4.64/docs/manual/style/modulesynopsis.dtd 0000664 0001751 0001751 00000005434 13206512634 021771 0 ustar covener covener <?xml version='1.0' encoding='UTF-8' ?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You 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.
-->
<!ENTITY % sitemap SYSTEM "sitemap.dtd">
%sitemap;
<!ELEMENT modulesynopsis (name , description, status, hint?, sourcefile?,
identifier? , compatibility? , summary? , seealso* , section*,
directivesynopsis*)>
<!ATTLIST modulesynopsis metafile CDATA #REQUIRED
upgrade CDATA #IMPLIED>
<!ELEMENT directivesynopsis (name , description? , syntax? , default?
, contextlist? , override? , modulelist?, status?, compatibility? ,
usage?, seealso*)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT status (#PCDATA)>
<!ELEMENT hint %Inline;>
<!ELEMENT identifier (#PCDATA)>
<!ELEMENT sourcefile (#PCDATA)>
<!ELEMENT compatibility %Inline;>
<!ELEMENT description %Inline;>
<!--
idtype is appended to the directive name when generating links to allow
a directive of type section to share the name with another directive.
The attribute type could have been (re)used instead but it would have broken
pre-existing links.
-->
<!ATTLIST directivesynopsis type CDATA #IMPLIED
idtype CDATA #IMPLIED
location CDATA #IMPLIED >
<!ELEMENT syntax %Inline;>
<!ELEMENT default (#PCDATA | directive | br)*>
<!ELEMENT contextlist (context+)+>
<!ELEMENT context (#PCDATA)>
<!ELEMENT override (#PCDATA)>
<!ELEMENT usage %Block;>
<!-- Used in index.xml -->
<!ELEMENT moduleindex (title, summary, seealso*)>
<!ATTLIST moduleindex metafile CDATA #REQUIRED>
<!-- Used in directive.xml -->
<!ELEMENT directiveindex (title | summary)+>
<!ATTLIST directiveindex metafile CDATA #REQUIRED>
<!-- Used in quickreference.xml -->
<!ELEMENT quickreference (title | summary | legend)+>
<!ATTLIST quickreference metafile CDATA #REQUIRED>
<!ELEMENT legend (table, table)>
<!-- Used in overrides.xml -->
<!ELEMENT overrideindex (title | summary | overridesummary)+>
<!ATTLIST overrideindex metafile CDATA #REQUIRED>
<!ELEMENT overridesummary %Block;>
<!ATTLIST overridesummary class CDATA #IMPLIED
fallback CDATA #IMPLIED>
httpd-2.4.64/docs/manual/style/faq.dtd 0000664 0001751 0001751 00000002337 12273272705 017447 0 ustar covener covener <?xml version='1.0' encoding='UTF-8' ?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You 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.
-->
<!ENTITY % common SYSTEM "common.dtd">
%common;
<!-- <faq> is the root element -->
<!ELEMENT faq (parentdocument?, title, description?, summary?,
seealso*, (section | categories))>
<!ATTLIST faq metafile CDATA #REQUIRED
all-in-one (yes | no ) "no"
upgrade CDATA #IMPLIED
>
<!ELEMENT categories (categoryfile*)>
<!ELEMENT categoryfile (#PCDATA)>
<!ELEMENT description %Inline;>
httpd-2.4.64/docs/manual/style/manualpage.dtd 0000664 0001751 0001751 00000002072 12273272705 021006 0 ustar covener covener <?xml version='1.0' encoding='UTF-8' ?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You 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.
-->
<!ENTITY % common SYSTEM "common.dtd">
%common;
<!-- <manualpage> is the root element -->
<!ELEMENT manualpage (parentdocument?, title, summary?,
seealso*, section*)>
<!ATTLIST manualpage metafile CDATA #REQUIRED
upgrade CDATA #IMPLIED
>
httpd-2.4.64/docs/manual/style/build.properties 0000664 0001751 0001751 00000000741 12273272705 021415 0 ustar covener covener # This file contains version specific properties
# No xml files yet or anymore
#noxml.fr = rewrite/rewrite_guide.html.fr rewrite/rewrite_guide_advanced.html.fr
# This httpd version is not retired
# (run build bootstrap on change)
retired = no
manpages.8 = \
apachectl \
fcgistarter \
htcacheclean \
httpd \
rotatelogs \
suexec
manpages.1 = \
ab \
apxs \
dbmmanage \
htdbm \
htdigest \
htpasswd \
httxt2dbm \
logresolve
httpd-2.4.64/docs/manual/style/lang.dtd 0000664 0001751 0001751 00000001613 10455053115 017605 0 ustar covener covener <?xml version='1.0' encoding='UTF-8' ?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You 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.
-->
<!ENTITY % HTTPD-VERSION SYSTEM "version.ent">
%HTTPD-VERSION;
<!ENTITY nbsp " ">
httpd-2.4.64/docs/manual/style/sitemap.dtd 0000664 0001751 0001751 00000002621 12273272705 020336 0 ustar covener covener <?xml version='1.0' encoding='UTF-8' ?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You 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.
-->
<!ENTITY % common SYSTEM "common.dtd">
%common;
<!-- <sitemap> is the root element -->
<!ELEMENT sitemap (title, summary?, seealso*, category*)>
<!ATTLIST sitemap metafile CDATA #REQUIRED
upgrade CDATA #IMPLIED
>
<!-- <indexpage> is another root element -->
<!ELEMENT indexpage (parentdocument, title, category*)>
<!ATTLIST indexpage metafile CDATA #REQUIRED
upgrade CDATA #IMPLIED
>
<!ELEMENT category (title, page*)>
<!ATTLIST category id ID #IMPLIED>
<!ELEMENT page (#PCDATA)>
<!ATTLIST page href CDATA #IMPLIED
separate (yes | no) "no" >
httpd-2.4.64/docs/manual/configuring.html.de 0000664 0001751 0001751 00000041325 14744525602 020634 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Konfigurationsdateien - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Konfigurationsdateien</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="./de/configuring.html" title="Deutsch"> de </a> |
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<p>Dieses Dokument beschreibt die Dateien, die zur Konfiguration des Apache
HTTP Servers verwendet werden.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#main">Hauptkonfigurationsdateien</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#syntax">Syntax der Konfigurationsdateien</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Module</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#scope">Der Gültigkeitsbereich von Direktiven</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#htaccess">.htaccess-Dateien</a></li>
</ul><h3>Siehe auch</h3><ul class="seealso"><li><a href="#comments_section">Kommentare</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="main" id="main">Hauptkonfigurationsdateien</a></h2>
<table class="related"><tr><th>Referenzierte Module</th><th>Referenzierte Direktiven</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#include">Include</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code></li></ul></td></tr></table>
<p>Der Apache wird konfiguriert, indem <a href="mod/directives.html">Direktiven</a> in einfache Textdateien
eingetragen werden. Die Hauptkonfigurationsdatei heißt
üblicherweise <code>httpd.conf</code>. Der Ablageort dieser Datei
wird bei der Kompilierung festgelegt, kann jedoch mit der
Befehlszeilenoption <code>-f</code> überschrieben werden. Durch
Verwendung der Direktive <code class="directive"><a href="./mod/core.html#include">Include</a></code>
können außerdem weitere Konfigurationsdateien hinzugefügt
werden. Zum Einfügen von mehreren Konfigurationsdateien können
Platzhalter verwendet werden. Jede Direktive darf in jeder dieser
Konfigurationsdateien angegeben werden. Änderungen in den
Hauptkonfigurationsdateien werden vom Apache nur beim Start oder Neustart
erkannt.</p>
<p>Der Server liest auch eine Datei mit MIME-Dokumenttypen ein. Der
Name dieser Datei wird durch die Direktive <code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code> bestimmt. Die Voreinstellung
ist <code>mime.types</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="syntax" id="syntax">Syntax der Konfigurationsdateien</a></h2>
<p>Die Konfigurationsdateien des Apache enthalten eine Direktive pro Zeile.
Der Backslash "\" läßt sich als letztes Zeichen in einer Zeile
dazu verwenden, die Fortsetzung der Direktive in der nächsten Zeile
anzuzeigen. Es darf kein weiteres Zeichen oder Whitespace zwischen dem
Backslash und dem Zeilenende folgen.</p>
<p>In den Konfigurationsdateien wird bei den Direktiven nicht zwischen
Groß- und Kleinschreibung unterschieden. Bei den Argumenten der
Direktiven wird dagegen oftmals zwischen Groß- und Kleinschreibung
differenziert. Zeilen, die mit dem Doppelkreuz "#" beginnen, werden als
Kommentare betrachtet und ignoriert. Kommentare dürfen
<strong>nicht</strong> am Ende einer Zeile nach der Direktive
eingefügt werden. Leerzeilen und Whitespaces vor einer Direktive
werden ignoriert. Dadurch lassen sich Direktiven zur besseren Lesbarbeit
einrücken.</p>
<p>Sie können die Syntax Ihrer Konfigurationsdateien auf Fehler
prüfen, ohne den Server zu starten, indem Sie <code>apachectl
configtest</code> oder die Befehlszeilenoption <code>-t</code>
verwenden.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="modules" id="modules">Module</a></h2>
<table class="related"><tr><th>Referenzierte Module</th><th>Referenzierte Direktiven</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>Der Apache ist ein modularer Server. Das bedeutet, dass nur die abolute
Grundfunktionalität im Kernserver enthalten ist. Weitergehende
Fähigkeiten sind mittels <a href="mod/">Modulen</a> verfügbar,
die in den Apache geladen werden können. Standardmäßig
wird bei der Kompilierung ein Satz von Basismodulen <span class="transnote">(<em>Anm.d.Ü.:</em> die so
genannten <a href="mod/module-dict.html#Status">Base</a>-Module)</span> in den Server eingebunden. Wenn der
Server für die Verwendung von <a href="dso.html">dynamisch
ladbaren</a> Modulen kompiliert wurde, dann können Module separat
kompiliert und jederzeit mittels der Direktive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> hinzugefügt werden.
Andernfalls muss der Apache neu kompiliert werden, um Module
hinzuzufügen oder zu entfernen. Konfigurationsanweisungen können
abhängig vom Vorhandensein eines bestimmten Moduls eingesetzt werden,
indem sie in einen <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>-Block eingeschlossen werden.</p>
<p>Um zu sehen, welche Module momentan in den Server einkompiliert sind,
kann die Befehlszeilenoption <code>-l</code> verwendet werden.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="scope" id="scope">Der Gültigkeitsbereich von Direktiven</a></h2>
<table class="related"><tr><th>Referenzierte Module</th><th>Referenzierte Direktiven</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>Direktiven in den Hauptkonfigurationsdateien gelten für den
gesamten Server. Wenn Sie die Konfiguration nur für einen Teil des
Servers verändern möchten, können Sie den
Gültigkeitsbereich der Direktiven beschränken, indem Sie diese
in <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>-,
<code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>-,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>-,
<code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>-,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>- oder
<code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>-Abschnitte eingefügen.
Diese Abschnitte begrenzen die Anwendung der umschlossenen Direktiven
auf bestimmte Pfade des Dateisystems oder auf
bestimmte URLs. Sie können für eine fein abgestimmte
Konfiguration auch ineinander verschachtelt werden.</p>
<p>Der Apache besitzt die Fähigkeit, mehrere verschiedene Websites
gleichzeitig zu bedienen. Dies wird <a href="vhosts/">virtuelles
Hosten</a> genannt. Direktiven können auch in ihrem
Gültigkeitsgereich eingeschränkt werden, indem sie innerhalb
eines <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>-Abschnittes angegeben werden.
Sie werden dann nur auf Anfragen für eine bestimmte Website
angewendet.</p>
<p>Obwohl die meisten Direktiven in jedem dieser Abschnitte platziert
werden können, ergeben einige Direktiven in manchen Kontexten
keinen Sinn. Direktiven zur Prozesssteuerung beispielsweise
dürfen nur im Kontext des Hauptservers angegeben werden. Prüfen
Sie den <a href="mod/directive-dict.html#Context">Kontext</a> der
Direktive, um herauszufinden, welche Direktiven in welche Abschnitte
eingefügt werden können. Weitere Informationen finden Sie unter
"<a href="sections.html">Wie Directory-, Location- und Files-Abschnitte
arbeiten</a>".</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="htaccess" id="htaccess">.htaccess-Dateien</a></h2>
<table class="related"><tr><th>Referenzierte Module</th><th>Referenzierte Direktiven</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
<p>Der Apache ermöglicht die dezentrale Verwaltung der
Konfiguration mittes spezieller Dateien innerhalb des
Web-Verzeichnisbaums. Diese speziellen Dateien heißen
gewöhnlich <code>.htaccess</code>, mit der Direktive <code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code> kann jedoch auch ein anderer
Name festgelegt werden. In <code>.htaccess</code>-Dateien angegebene
Direktiven werden auf das Verzeichnis und dessen Unterverzeichnisse
angewendet, in dem die Datei abgelegt ist. <code>.htaccess</code>-Dateien
folgen der gleichen Syntax wie die Hauptkonfigurationsdateien. Da
<code>.htaccess</code>-Dateien bei jeder Anfrage eingelesen werden,
werden Änderungen in diesen Dateien sofort wirksam.</p>
<p>Prüfen Sie den <a href="mod/directive-dict.html#Context">Kontext</a> der Direktive, um
herauszufinden, welche Direktiven in <code>.htaccess</code>-Dateien
angegeben werden können. Darüber hinaus steuert der
Serveradministrator mit der Einstellung der Direktive <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> in den
Hauptkonfigurationsdateien welche Direktiven in
<code>.htaccess</code>-Dateien verwendet werden dürfen.</p>
<p>Weitere Informationen über <code>.htaccess</code>-Dateien finden
Sie in der <a href="howto/htaccess.html">.htaccess-Einführung</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="./de/configuring.html" title="Deutsch"> de </a> |
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Kommentare</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/configuring.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/install.html.de 0000664 0001751 0001751 00000063077 14744525602 020000 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Kompilieren und Installieren - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Kompilieren und Installieren</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="./de/install.html" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<p>Dieses Dokument umfaßt nur die Kompilierung und Installation des
Apache auf Unix und Unix-ähnlichen Systemen. Für die
Kompilierung und Installation unter Windows lesen Sie bitte <a href="platform/windows.html">Den Apache unter Microsoft Windows
betreiben</a>. Für andere Plattformen lesen Sie bitte die
Dokumentation <a href="platform/">Plattformen</a>.</p>
<p>Die Konfigurations- und Installationsumgebung des Apache 2.0 hat sich
seit dem Apache 1.3 komplett verändert. Der Apache 1.3 benutzt einen
speziellen Satz von Skripten, um eine einfache Installation zu
ermöglichen. Der Apache 2.0 dagegen verwendet nun
<code>libtool</code> und <code>autoconf</code>, um eine Umgebung zu
schaffen, die der vieler anderer Open Source Projekte ähnlich
sieht.</p>
<p>Wenn Sie von einer Unterversion auf die nächste aktualisieren (z.B.
von 2.0.50 auf 2.0.51), springen Sie bitte zum Abschnitt <a href="#upgrading">Upgrade</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Überblick für die Ungeduldigen</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#requirements">Anforderungen</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#download">Download</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extract">Auspacken</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configure">Den Codebaum konfigurieren</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#compile">Erstellen</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">Installieren</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#customize">Anpassen</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#test">Testen</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#upgrading">Upgrade</a></li>
</ul><h3>Siehe auch</h3><ul class="seealso"><li><a href="programs/configure.html">Den Quellcode konfigurieren</a></li><li><a href="invoking.html">Apache starten</a></li><li><a href="stopping.html">Beenden und Neustarten</a></li><li><a href="#comments_section">Kommentare</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="overview" id="overview">Überblick für die Ungeduldigen</a></h2>
<table>
<tr>
<td><a href="#download">Download</a></td>
<td><code>$ lynx http://httpd.apache.org/download.cgi</code>
</td>
</tr>
<tr>
<td><a href="#extract">Auspacken</a></td>
<td><code>$ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
$ tar xvf httpd-2_1_<em>NN</em>.tar</code> </td>
</tr>
<tr>
<td><a href="#configure">Konfigurieren</a></td>
<td><code>$ ./configure --prefix=<em>PREFIX</em></code>
</td>
</tr>
<tr>
<td><a href="#compile">Kompilieren</a></td>
<td><code>$ make</code> </td>
</tr>
<tr>
<td><a href="#install">Installieren</a></td>
<td><code>$ make install</code> </td>
</tr>
<tr>
<td><a href="#customize">Anpassen</a></td>
<td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
</tr>
<tr>
<td><a href="#test">Testen</a></td>
<td><code>$ <em>PREFIX</em>/bin/apachectl start</code>
</td>
</tr>
</table>
<p><em>NN</em> muss durch die Nummer der Unterversion ersetzt werden,
und <em>PREFIX</em> durch den Verzeichnispfad,
in dem der Server installiert werden soll. Wenn <em>PREFIX</em> nicht
angegeben ist, wird die Voreinstellung <code>/usr/local/apache2</code>
verwendet.</p>
<p>Beginnend mit den Anforderungen
für die Kompilierung und Installation des Apache HTTPD ist
weiter unten jeder Abschnitt des Kompilierungs- und
Installationsvorganges genauer beschrieben.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="requirements" id="requirements">Anforderungen</a></h2>
<p>Folgende Anforderungen gelten für die Erstellung des
Apache:</p>
<dl>
<dt>Plattenplatz</dt>
<dd>Stellen Sie sicher, dass Sie kurzzeitig wenigstens 50 MB freien
Festplattenplatz zur Verfügung haben. Nach der Installation
belegt der Apache ungefähr 10 MB Plattenplatz. Der
tatsächliche Platzbedarf variiert in Abhängigkeit von den
gewählten Konfigurationseinstellungen und
Modulen von Drittanbietern.</dd>
<dt>ANSI-C-Compiler und Generierungswerkzeuge</dt>
<dd>Stellen Sie sicher, dass Sie einen ANSI-C Compiler installiert
haben. Der <a href="http://www.gnu.org/software/gcc/gcc.html">GNU C
Compiler (GCC)</a> der <a href="http://www.gnu.org/">Free Software
Foundation (FSF)</a> ist empfehlenswert (Version 2.7.2 ist gut). Wenn
Sie den GCC nicht besitzen, stellen Sie zumindest sicher, dass der
Compiler Ihres Anbieters ANSI-kompatibel ist. Außerdem muss Ihr
<code>PATH</code> wesentliche Generierungswerkzeuge wie
<code>make</code> enthalten.</dd>
<dt>Zeitgenauigkeit bewahren</dt>
<dd>Elemente des HTTP-Protokolls werden in Form einer Tageszeit
ausgedrückt. Darum sollten Sie jetzt prüfen, ob Ihr System
die Fähigkeit zur Zeitsynchronisation besitzt, und diese
gegebenenfalls installieren. Üblicherweise werden hierfür
die Programme <code>ntpdate</code> oder <code>xntpd</code> verwendet,
die auf dem Network Time Protocol (NTP) basieren. Nähere
Informationen über NTP Software und öffentliche Zeitserver
finden Sie in der Usenet Newsgroup <a href="news:comp.protocols.time.ntp">comp.protocols.time.ntp</a>
und auf der <a href="http://www.ntp.org">NTP
Homepage</a>.</dd>
<dt><a href="http://www.perl.org/">Perl 5</a>
[OPTIONAL]</dt>
<dd>Für einige Hilfsskripte wie <code class="program"><a href="./programs/apxs.html">apxs</a></code>
oder <code class="program"><a href="./programs/dbmmanage.html">dbmmanage</a></code> (die in Perl
geschrieben sind) wird der Perl 5 Interpreter benötigt (die
Versionen ab 5.003 sind ausreichend). Wenn Sie mehrere Perl
Interpreter haben (beispielsweise eine systemweite Installation von
Perl 4 und Ihre eigene Perl 5-Installation), dann sollten Sie die
<code>--with-perl</code>-Option (siehe unten) verwenden, um
sicherzustellen, dass der richtige Interpreter von
<code class="program"><a href="./programs/configure.html">configure</a></code> ausgewählt wird.
Wenn kein Perl 5-Interpreter vom <code class="program"><a href="./programs/configure.html">configure</a></code>-Skript
gefunden werden kann, können Sie die betroffenen Hilfsskripte nicht
verwenden, sind jedoch selbstverständlich nach wie vor in der Lage,
den Apache 2.0 zu bauen und zu installieren.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="download" id="download">Download</a></h2>
<p>Der Apache kann von der <a href="http://httpd.apache.org/download.cgi">Apache HTTP Server
Downloadseite</a> heruntergeladen werden, auf der verschiedene Spiegelserver
angegeben sind. Für die meisten Benutzer des Apache ist es auf
Unix-ähnlichen Systemen am Besten, die Quellcodeversion herunterzuladen
und zu kompilieren. Der Erstellungsprozess (weiter unten beschrieben) ist
einfach und erlaubt es Ihnen, den Server Ihren Bedürfnissen anzupassen.
Dazu kommt, dass Binärdistributionen gegenüber der aktuellen
Quellcodeversion oft veraltet sind. Wenn Sie tatsächlich ein
Binärpaket herunterladen, folgen Sie bitte den Anweisungen in der Datei
<code>INSTALL.bindist</code>, die der Distribution beiliegt.</p>
<p>Es ist wichtig, dass Sie nach dem Herunterladen überprüfen,
dass es sich um einer vollständige und unveränderte Version des
Apache HTTP Servers handelt. Das können Sie erreichen, indem Sie das
heruntergeladene Paket gegen die PGP-Signatur prüfen. Einzelheiten dazu
erfahren Sie auf der <a href="http://httpd.apache.org/download.cgi#verify">Download-Seite</a>. Es
ist auch ein erweitertes Beispiel verfügbar, dass die <a href="http://httpd.apache.org/dev/verification.html">Anwendung von PGP</a>
beschreibt.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="extract" id="extract">Auspacken</a></h2>
<p>Das Auspacken des Quellcodes aus dem Apache HTTPD Tarball besteht
aus einem simplen Dekomprimieren und danach "Ent-tarren":</p>
<div class="example"><p><code>
$ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
$ tar xvf httpd-2_1_<em>NN</em>.tar
</code></p></div>
<p>Dies erstellt unterhalb des aktuellen Verzeichnisses ein neues
Verzeichnis, das den Quellcode für die Distribution enthält.
Sie sollten mit <code>cd</code> in dieses Verzeichnis wechseln,
bevor Sie mit der Kompilierung des Servers weitermachen. </p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configure" id="configure">Den Codebaum konfigurieren</a></h2>
<p>Der nächste Schritt ist die Konfiguration des
Apache-Codebaumes für Ihre spezielle Plattform und Ihre
persönlichen Bedürfnisse. Dies wird mit dem Skript
<code class="program"><a href="./programs/configure.html">configure</a></code> durchgeführt, das im Wurzelverzeichnis
der Distribution enthalten ist. (Entwickler, welche die CVS Version
des Apache-Codebaumes herunterladen, müssen <code>autoconf</code>
und <code>libtool</code> installiert haben und müssen
<code>buildconf</code> ausführen, bevor sie mit den
nächsten Schritten fortfahren können. Dies wird bei
offiziellen Releases nicht notwendig sein.)</p>
<p>Um den Codebaum mit den Standardeinstellungen zu konfigurieren,
geben Sie einfach <code>./configure</code> ein. Zur Änderung
dieser Voreinstellungen akzeptiert <code class="program"><a href="./programs/configure.html">configure</a></code> eine
Reihe von Variablen und Kommandozeilenoptionen.</p>
<p>Die wichtigste Option ist <code>--prefix</code>, der Ablageort, an dem
der Apache später installiert wird, da er für diesen Ort
konfiguriert werden muss, um korrekt zu arbeiten. Eine feinere Einstellung
der Dateiablagen ist mit weiteren <a href="programs/configure.html#installationdirectories">configure-Optionen</a>
möglich.</p>
<p>Weiterhin können Sie zu diesem Zeitpunkt festlegen, welche <a href="programs/configure.html#optionalfeatures">Funktionalität</a> Sie
in den Apache aufnehmen möchten, indem Sie <a href="mod/">Module</a>
aktivieren oder deaktivieren. Der Apache bindet standardmäßig
einen Satz von <a href="mod/module-dict.html#Status">Basismodulen</a> ein.
Andere Module werden mit Hilfe der Option
<code>--enable-<var>module</var></code> aktiviert, wobei <var>module</var>
den Namen des Moduls ohne das Präfix <code>mod_</code> darstellt.
Ausserdem sind alle Unterstriche durch Bindestriche zu ersetzen. Sie
können sich auch entscheiden, Module als "<a href="dso.html">Shared
Objects (DSOs)</a>" zu kompilieren, welche zur Laufzeit ge- und entladen
werden können. Dazu verwenden Sie die Option
<code>--enable-<var>module</var>=shared</code>. Entsprechend können Sie
Basismodule mit der Option <code>--disable-<var>module</var></code>
deaktivieren. Lassen Sie Vorsicht walten. wenn Sie diese Optionen verwenden,
da <code class="program"><a href="./programs/configure.html">configure</a></code> Sie nicht warnen kann, wenn die von Ihnen
angegebenen Module nicht existieren; die Option wird dann einfach
ignoriert.</p>
<p>Zusätzlich ist es zuweilen notwendig, das
<code class="program"><a href="./programs/configure.html">configure</a></code>-Skript mit Extrainformationen zum Ablageort
Ihres Compilers, Ihrer Bibliotheken oder Header-Dateien zu versorgen. Das
tun Sie, indem Sie entweder Umgebungsvariablen oder Kommandozeilenoptionen
an <code class="program"><a href="./programs/configure.html">configure</a></code> übergeben. Für mehr Informationen
lesen Sie bitte die Hilfeseite zu <code class="program"><a href="./programs/configure.html">configure</a></code>.</p>
<p>Um einen kurzen Eindruck zu gewinnen, welche Möglichkeiten Sie
haben, folgt hier ein typisches Beispiel, das den Apache mit einem
speziellen Compiler und Compilerflags für das
Installationsverzeichnis <code>/sk/pkg/apache</code> kompiliert, sowie
die beiden zusätzlichen Module <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> und
<code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> für späteres Laden durch den
DSO-Mechanismus:</p>
<div class="example"><p><code>
$ CC="pgcc" CFLAGS="-O2" \<br />
./configure --prefix=/sw/pkg/apache \<br />
--enable-rewrite=shared \<br />
--enable-speling=shared
</code></p></div>
<p>Wenn <code class="program"><a href="./programs/configure.html">configure</a></code> startet, benötigt es mehrere
Minuten, um die Verfügbarkeit von Features auf Ihrem System zu
prüfen und ein Makefile zu generieren, das später zur
Kompilierung des Servers verwendet wird.</p>
<p>Einzelheiten zu den vielen verschiedenen <code class="program"><a href="./programs/configure.html">configure</a></code>-Optionen finden Sie auf der Hilfeseite zu
<code class="program"><a href="./programs/configure.html">configure</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="compile" id="compile">Erstellen</a></h2>
<p>Nun können Sie die verschiedenen Teile, die das Apache-Paket
bilden, einfach durch Ausführen des folgenden Befehls erstellen:</p>
<div class="example"><p><code>$ make</code></p></div>
<p>Seien Sie hierbei bitte geduldig, denn eine Basiskonfiguration
benötigt ungefähr 3 Minuten auf einem Pentium III/Linux 2.2.
System. Dies kann aber abhängig von Ihrer Hardware und der Anzahl
der Module, die Sie aktiviert haben, sehr stark variieren.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">Installieren</a></h2>
<p>Nun endlich installieren Sie das Package unter dem konfigurierten
Installations-<em>PREFIX</em> (siehe oben: Option <code>--prefix</code>
durch Aufrufen von:</p>
<div class="example"><p><code>$ make install</code></p></div>
<p>Wenn Sie upgraden, wird die Installation Ihre Konfigurationsdateien
oder Dokumente nicht überschrieben.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="customize" id="customize">Anpassen</a></h2>
<p>Als nächstes können Sie Ihren Apache HTTP Server anpassen,
indem Sie die <a href="configuring.html">Konfigurationsdateien</a>
unterhalb von <code><em>PREFIX</em>/conf/</code> editieren.</p>
<div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
<p>Werfen Sie auch einen Blick in das Apache-Handbuch unter <a href="./">docs/manual/</a>. Die aktuellste Version dieses Handbuchs
sowie eine komplette Referenz der verfügbaren <a href="mod/directives.html">Konfigurationsanweisungen</a> finden
Sie unter <a href="http://httpd.apache.org/docs/2.4/">http://httpd.apache.org/docs/2.4/</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="test" id="test">Testen</a></h2>
<p>Sie können nun Ihren Apache HTTP Server <a href="invoking.html">starten</a>, indem Sie einfach</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl start</code></p></div>
<p>ausführen.</p>
<p>Danach sollten Sie Ihr erstes Dokument unter dem URL
<code>http://localhost/</code> anfordern können. Die Webseite,
die Sie sehen, ist im <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
abgelegt, welches üblicherweise <code><em>PREFIX</em>/htdocs/</code>
ist. Den Server <a href="stopping.html">stoppen</a> Sie wieder durch
Ausführen von:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl stop</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="upgrading" id="upgrading">Upgrade</a></h2>
<p>Der erste Schritt beim Aktualisieren besteht darin, die
Versionsankündigung sowie die <code>CHANGES</code>-Datei in der
Quelltextdistribution zu lesen, um Änderungen zu finden, die Ihr
System möglicherweise betreffen. Wenn Sie einen größeren
Versionssprung durchführen (z.B. vom 1.3 auf 2.0 oder von 2.0 auf
2.2), wird es wahrscheinlich auch größere Unterschiede in der
Kompilier- und Laufzeitkonfiguration geben, die manuelle Nacharbeiten
erfordern. Außerdem müssen alle Module aktualisiert
werden, um den Änderungen der Modul-API gerecht zu werden.</p>
<p>Die Aktualisierung einer Unterversion auf eine andere (z.B. von 2.0.55
auf 2.0.57) ist einfacher. <code>make install</code> überschreibt
keine der bereits existierenden Dokumente, Log- und Konfigurationsdateien.
Ausserdem bemühen sich die Entwickler, inkompatible Änderungen
der <code class="program"><a href="./programs/configure.html">configure</a></code>-Optionen, der Laufzeitkonfiguration sowie
der Modul-API zu vermeiden. In den meisten Fällen sollten Sie in der
Lage sein, den gleichen <code class="program"><a href="./programs/configure.html">configure</a></code>-Befehl, die gleiche
Konfiguration und die gleichen Module wieder zu verwenden. (Das gilt erst
seit Version 2.0.41 -- frühere Versionen enthielten noch inkompatible
Änderungen).</p>
<p>Um auf eine neue Unterversion zu aktualisieren, suchen Sie zunächst
die Datei <code>config.nice</code> im <code>build</code>-Verzeichnis
Ihrer Serverinstallation oder im Wurzelverzeichnis des Quelltextbaums
der alten Installation. Die Datei enthält den genauen
<code class="program"><a href="./programs/configure.html">configure</a></code>-Befehl, der verwendet wurde, um den
Quellcode zu konfigurieren. Um jetzt von einer Version auf die
nächste zu aktualisieren, kopieren Sie einfach die
<code>config.nice</code> in das Verzeichnis der neuen Version,
passen sie bei Bedarf an, und führen Sie sie aus:</p>
<div class="example"><p><code>
$ ./config.nice<br />
$ make<br />
$ make install<br />
$ <var>PREFIX</var>/bin/apachectl stop<br />
$ <var>PREFIX</var>/bin/apachectl start<br />
</code></p></div>
<div class="warning">Sie sollten jede neue Version immer in Ihrer Umgebung
testen, bevor Sie sie produktiv schalten. Beispielsweise können Sie
die neue Version neben der alten installieren, indem Sie ein anderes
<code>--prefix</code> und einen anderen Port wählen (durch Anpassen der
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>-Direktive). So
können Sie auf eventuelle Inkompatibilitäten testen, bevor Sie
endgültig die neue Version verwenden.</div>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="./de/install.html" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Kommentare</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/install.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/bind.html.de 0000664 0001751 0001751 00000036436 14744525602 017245 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>An Adressen und Ports binden - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>An Adressen und Ports binden</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="./de/bind.html" title="Deutsch"> de </a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/bind.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<p>Konfiguration der vom Apache HTTP Server verwendeten Adressen und
Ports.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Überblick</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ipv6">Betrachtung von IPv6-Besonderheiten</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#protocol">Angabe des Protokolls bei Listen</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Das Zusammenspiel mit virtuellen Hosts</a></li>
</ul><h3>Siehe auch</h3><ul class="seealso"><li><a href="vhosts/">Virtuelle Hosts</a></li><li><a href="dns-caveats.html">Probleme bezüglich DNS und
Apache</a></li><li><a href="#comments_section">Kommentare</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="overview" id="overview">Überblick</a></h2>
<table class="related"><tr><th>Referenzierte Module</th><th>Referenzierte Direktiven</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mpm_common.html">mpm_common</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table>
<p>Beim Start bindet sich der httpd an bestimmte Adressen und Ports
der lokalen Maschine und wartet auf eingehende Anfragen.
Standardmäßig lauscht er an allen Adressen des Systems.
Es kann jeodch notwendig sein, ihm mit zuteilen, nur an bestimmten
Ports zu lauschen oder nur an ausgewählten Adressen, bzw. einer
Kombination aus beidem. Dies wird oft mit der Funktionalität <a href="vhosts/">virtueller Hosts</a> kombiniert, die bestimmt, wie
der <code>httpd</code> auf verschiedene IP-Adressen, Hostnamen und
Ports reagiert.</p>
<p>Die Direktive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
weist den Server an, eingehende Anfragen nur an bestimmten Port(s)
oder Adress/Port-Kombinationen zu akzeptieren. Wenn bei der
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>-Direktive nur eine
Portnummer angegeben wird, dann lauscht der Server auf allen
Netzwerkinterfaces an dem angegebenen Port. Ist auch eine IP-Adresse
angegeben, dann lauscht der Server an der angegebenen Schnittstelle
auf dem angegebenen Port. Es können mehrere <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>-Anweisungen verwendet werden,
um eine Reihe von Adressen und Ports anzugeben, an denen gelauscht
werden soll. Der Server wird dann auf Anfragen an jeder der
abgehörten Adressen und Ports antworten.</p>
<p>Um beispielsweise den Server zu veranlassen, auf allen
Netzwerkinterfaces sowohl an Port 80, als auch an Port 8000
Verbindungen zu akzeptieren, geben Sie an:</p>
<div class="example"><pre class="prettyprint lang-config">Listen 80
Listen 8000</pre>
</div>
<p>Um den Server Verbindungen an Port 80 auf einem Netzwerkinterface
akzeptieren zu lassen und an Port 8080 auf einem anderen Interface, geben
Sie an:</p>
<div class="example"><pre class="prettyprint lang-config">Listen 192.0.2.1:80
Listen 192.0.2.5:8000</pre>
</div>
<p>IPv6-Adressen müssen wie im folgenden Beispiel in eckigen
Klammern angegeben werden:</p>
<div class="example"><pre class="prettyprint lang-config">Listen [2001:db8::a00:20ff:fea7:ccea]:80</pre>
</div>
<div class="warning"><p>Sich überlappende <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>-Direktiven generieren einen
fatalen Fehler, der verhindert, dass der Server hochfährt.</p>
<div class="example"><p><code>
(48)Address already in use: make_sock: could not bind to address [::]:80
</code></p></div>
<p><a href="http://wiki.apache.org/httpd/CouldNotBindToAddress">Diese
Diskussion im Wiki</a> gibt weitere Tipps zur Fehlerbehebung.</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="ipv6" id="ipv6">Betrachtung von IPv6-Besonderheiten</a></h2>
<p>Eine wachsende Anzahl von Plattformen implementiert IPv6. Die
<a class="glossarylink" href="./glossary.html#apr" title="siehe Glossar">APR</a> unterstützt IPv6 auf den meisten
dieser Plattformen und ermöglicht dem httpd, IPv6-Sockets zu
verwenden und über IPv6 gesendete Anfragen zu behandeln.</p>
<p>Für httpd-Administratoren kommt erschwerend die Frage hinzu,
ob IPv6-Sockets sowohl IPv4- als auch IPv6-Verbindungen handhaben
können. Zum Betrieb von IPv4-Verbindungen an IPv6-Sockets
werden auf IPv6 abgebildete IPv4-Adressen <span class="transnote">(<em>Anm.d.Ü.:</em> so genannete
IPv4-gemappte IPv6-Adressen)</span> verwendet, welche
standardmäßig auf den meisten Plattformen erlaubt sind.
Unter FreeBSD, NetBSD und OpenBSD jedoch sind sie
standardmäßig deaktiviert, um den Systemgrundsätzen
dieser Plattformen zu entsprechen. Auf Systemen, wo dies
standardmäßig dekativiert ist, kann dieses Verhalten mit
einem speziellen <code class="program"><a href="./programs/configure.html">configure</a></code>-Parameter für den
httpd geändert werden.</p>
<p>Auf der anderen Seite ist die Verwendung von gemappten Adressen
bei einigen Plattformen wie Linux und True64 der
<strong>einzige</strong> Weg, sowohl IPv4 wie auch IPv6 zu
verwenden. Wenn Sie möchten, dass der <code>httpd</code> IPv4-
und IPv6-Verbindungen mit einem Minimum an Sockets behandelt, was
die Verwendung von IPv4-gemappten IPv6-Adressen erfordert, dann
müssen Sie die <code class="program"><a href="./programs/configure.html">configure</a></code>-Option
<code>--enable-v4-mapped</code> angeben.</p>
<p><code>--enable-v4-mapped</code> ist die Voreinstellung auf allen
Plattformen außer FreeBSD, NetBSD und OpenBSD, so dass Ihr
httpd wahrscheinlich so übersetzt wurde.</p>
<p>Geben Sie wie in dem folgenden Beispiel bei allen <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>-Anweisungen eine IPv4-Adresse
an, wenn Sie möchten, dass Ihr httpd lediglich IPv4-Adressen
behandelt, unabhängig davon, was Ihre Plattform und die APR
unterstützen:</p>
<div class="example"><pre class="prettyprint lang-config">Listen 0.0.0.0:80
Listen 192.0.2.1:80</pre>
</div>
<p>Wenn Sie möchten, dass der httpd IPv4- und IPv6-Verbindungen
an separaten Sockets behandelt (d.h. IPv4-gemappte Adressen
deaktiviert werden sollen) und Ihre Plattform es unterstützt,
dann müssen Sie die <code class="program"><a href="./programs/configure.html">configure</a></code>-Option
<code>--disable-v4-mapped</code> angeben. Unter FreeBSD, NetBSD und
OpenBSD ist <code>--disable-v4-mapped</code> voreingestellt.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="protocol" id="protocol">Angabe des Protokolls bei Listen</a></h2>
<p>Das optionale zweite <var>Protokoll</var>-Argument von <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> ist für die meisten
Konfigurationen gar nicht erforderlich. Wenn nicht angegeben, sind
<code>https</code> für Port 443 und <code>http</code> für
alle anderen Ports die Voreinstellungen. Die Protokollangabe wird
sowohl dazu verwendet, herauszufinden, welches Modul Anfragen
verarbeiten soll, als auch, um protokollspezifische Optimierungen
bei der <code class="directive"><a href="./mod/core.html#acceptfilter">AcceptFilter</a></code>-Direktive
zu aktivieren.</p>
<p>Sie müssen das Protokoll nur angeben, wenn Sie
ungewöhnliche Ports benutzen, beispielsweise <code>https</code>
auf Port 8443:</p>
<div class="example"><pre class="prettyprint lang-config">Listen 192.170.2.1:8443 https</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">Das Zusammenspiel mit virtuellen Hosts</a></h2>
<p>Die Direktive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
implementiert keine virtuellen Hosts - sie teilt dem Hauptserver
lediglich mit, an welchen Adressen und Ports er zu lauschen hat.
Werden keine <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>-Container verwendet, dann
verhält sich der Server bei allen angenommenen Anfragen gleich.
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>-Abschnitte können jedoch
dazu verwendet werden, ein unterschiedliches Verhalten für eine
oder mehrere Adressen und Ports festzulegen. Um einen virtuellen
Host einzurichten, muss dem Server zunächst mitgeteilt werden,
an den betreffenden Adressen oder Ports zu lauschen. Dann sollte ein
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>-Abschnitt für die
angebene Adresse und den angegebenen Port erstellt werden, um das
Verhalten dieses virtuellen Hosts festzulegen. Beachten Sie bitte,
dass auf einen <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> nicht zugegriffen werden
kann, wenn er für eine Adresse und einen Port eingerichtet
wurde, an dem der Server nicht lauscht.</p>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="./de/bind.html" title="Deutsch"> de </a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/bind.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Kommentare</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/bind.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/mpm.html.en 0000664 0001751 0001751 00000032406 14737241666 017134 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Multi-Processing Modules (MPMs) - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Multi-Processing Modules (MPMs)</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>This document describes what a Multi-Processing Module is and
how they are used by the Apache HTTP Server.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#defaults">MPM Defaults</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#static">Building an MPM as a static module</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#dynamic">Building an MPM as a DSO module</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="introduction" id="introduction">Introduction</a></h2>
<p>The Apache HTTP Server is designed to be a powerful and
flexible web server that can work on a very wide variety of
platforms in a range of different environments. Different
platforms and different environments often require different
features, or may have different ways of implementing the same
feature most efficiently. Apache httpd has always accommodated a wide
variety of environments through its modular design. This design
allows the webmaster to choose which features will be included
in the server by selecting which modules to load either at
compile-time or at run-time.</p>
<p>Apache HTTP Server 2.0 extends this modular design to the most basic
functions of a web server. The server ships with a selection of
Multi-Processing Modules (MPMs) which are responsible for
binding to network ports on the machine, accepting requests,
and dispatching children to handle the requests.</p>
<p>Extending the modular design to this level of the server
allows two important benefits:</p>
<ul>
<li>Apache httpd can more cleanly and efficiently support a wide
variety of operating systems. In particular, the Windows
version of the server is now much more efficient, since
<code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code> can use native
networking features in place of the POSIX layer used in
Apache httpd 1.3. This benefit also extends to other operating
systems that implement specialized MPMs.</li>
<li>The server can be better customized for the needs of the
particular site. For example, sites that need a great deal of
scalability can choose to use a threaded MPM like
<code class="module"><a href="./mod/worker.html">worker</a></code> or <code class="module"><a href="./mod/event.html">event</a></code>, while sites requiring
stability or compatibility with older software can use a
<code class="module"><a href="./mod/prefork.html">prefork</a></code>.</li>
</ul>
<p>At the user level, MPMs appear much like other Apache httpd
modules. The main difference is that one and only one MPM must
be loaded into the server at any time. The list of available
MPMs appears on the <a href="mod/">module index page</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="defaults" id="defaults">MPM Defaults</a></h2>
<p>The following table lists the default MPMs for various operating
systems. This will be the MPM selected if you do not make another
choice at compile-time.</p>
<table class="bordered"><tr><td>Netware</td><td><code class="module"><a href="./mod/mpm_netware.html">mpm_netware</a></code></td></tr>
<tr class="odd"><td>OS/2</td><td><code class="module"><a href="./mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
<tr><td>Unix</td><td><code class="module"><a href="./mod/prefork.html">prefork</a></code>, <code class="module"><a href="./mod/worker.html">worker</a></code>, or
<code class="module"><a href="./mod/event.html">event</a></code>, depending on platform capabilities</td></tr>
<tr class="odd"><td>Windows</td><td><code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
</table>
<div class="note"><p>Here, 'Unix' is used to mean Unix-like operating systems, such as
Linux, BSD, Solaris, Mac OS X, etc.</p></div>
<p>In the case of Unix, the decision as to which MPM is installed is
based on two questions:</p>
<p>1. Does the system support threads?</p>
<p>2. Does the system support thread-safe polling (Specifically, the
kqueue and epoll functions)?</p>
<p>If the answer to both questions is 'yes', the default MPM is
<code class="module"><a href="./mod/event.html">event</a></code>.</p>
<p>If The answer to #1 is 'yes', but the answer to #2 is 'no', the
default will be <code class="module"><a href="./mod/worker.html">worker</a></code>.</p>
<p>If the answer to both questions is 'no', then the default MPM will be
<code class="module"><a href="./mod/prefork.html">prefork</a></code>.</p>
<p>In practical terms, this means that the default will almost always be
<code class="module"><a href="./mod/event.html">event</a></code>, as all modern operating systems support these
two features.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="static" id="static">Building an MPM as a static module</a></h2>
<p>MPMs can be built as static modules on all platforms. A single MPM
is chosen at build time and linked into the server. The server must
be rebuilt in order to change the MPM.</p>
<p>To override the default MPM choice, use the
<code>--with-mpm=<em>NAME</em></code> option of the
<code class="program"><a href="./programs/configure.html">configure</a></code> script. <em>NAME</em> is the name of the
desired MPM.</p>
<p>Once the server has been compiled, it is possible to determine which MPM
was chosen by using <code>./httpd -l</code>. This command will list every
module that is compiled into the server, including the MPM.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="dynamic" id="dynamic">Building an MPM as a DSO module</a></h2>
<p>On Unix and similar platforms, MPMs can be built as DSO modules and
dynamically loaded into the server in the same manner as other DSO
modules. Building MPMs as DSO modules allows the MPM to be changed by
updating the <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> directive
for the MPM instead of by rebuilding the server.</p>
<pre class="prettyprint lang-config">LoadModule mpm_prefork_module modules/mod_mpm_prefork.so</pre>
<p>Attempting to <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
more than one MPM will result in a startup failure with the
following error.</p>
<div class="example"><p><code>AH00534: httpd: Configuration error: More than one MPM
loaded.</code></p></div>
<p>This feature is enabled using the
<code>--enable-mpms-shared</code> option of the <code class="program"><a href="./programs/configure.html">configure</a></code>
script.
With argument <code><em>all</em></code>, all possible MPMs for the platform
will be installed. Alternately, a list of MPMs can be specified as the
argument.</p>
<p>The default MPM, either selected automatically or specified with the
<code>--with-mpm</code> option of the <code class="program"><a href="./programs/configure.html">configure</a></code>
script, will be loaded in the generated server configuration file. Edit the
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> directive to select a
different MPM.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mpm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/index.html.de 0000664 0001751 0001751 00000022437 14744525602 017434 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Dokumentation zum Apache HTTP Server Version
2.4 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="index-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></div>
<div class="up"><a href="http://httpd.apache.org/docs-project/"><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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a></div>
<div id="page-content"><h1>Dokumentation zum Apache HTTP Server Version
2.4</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<form method="get" action="https://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Google-Suche" type="submit" /><input value="10" name="num" type="hidden" /><input value="de" name="hl" type="hidden" /><input value="ISO-8859-1" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="Version 2.4" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value=""List-Post"" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form>
<table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">Hinweise zur Version</a></h2>
<ul><li><a href="new_features_2_4.html">Neue Funktionen in Version 2.3/2.4</a></li>
<li><a href="new_features_2_2.html">Neue Funktionen in Version 2.1/2.2</a></li>
<li><a href="new_features_2_0.html">Neue Funktionen in Version 2.0</a></li>
<li><a href="upgrading.html">Upgrade auf Version 2.4</a></li>
<li><a href="license.html">Apache-Lizenz</a></li>
</ul>
</div><div class="category"><h2><a name="manual" id="manual">Bedienungsanleitung</a></h2>
<ul><li><a href="install.html">Kompilieren und Installieren</a></li>
<li><a href="invoking.html">Starten</a></li>
<li><a href="stopping.html">Stoppen und Neustarten</a></li>
<li><a href="mod/quickreference.html">Konfigurationsanweisungen</a></li>
<li><a href="mod/">Module</a></li>
<li><a href="mpm.html">Multi-Processing-Module (MPMs)</a></li>
<li><a href="filter.html">Filter</a></li>
<li><a href="handler.html">Handler</a></li>
<li><a href="expr.html">Der Ausdrucksparser</a></li>
<li><a href="programs/">Server und Hilfsprogramme</a></li>
<li><a href="glossary.html">Glossar</a></li>
</ul>
</div></td><td><div class="category"><h2><a name="usersguide" id="usersguide">Benutzerhandbuch</a></h2>
<ul><li><a href="getting-started.html">Erste Schritte</a></li>
<li><a href="bind.html">An Adressen und Ports binden</a></li>
<li><a href="configuring.html">Konfigurationsdateien</a></li>
<li><a href="sections.html">Konfigurationsabschnitte</a></li>
<li><a href="caching.html">Caching von Inhalten</a></li>
<li><a href="content-negotiation.html">Content Negotiation</a></li>
<li><a href="dso.html">Dynamic Shared Objects (DSO)</a></li>
<li><a href="env.html">Umgebungsvariablen</a></li>
<li><a href="logs.html">Log-Dateien</a></li>
<li><a href="urlmapping.html">URLs auf das Dateisystem abbilden</a></li>
<li><a href="misc/perf-tuning.html">Performance-Hinweise</a></li>
<li><a href="misc/security_tips.html">Tipps zur Sicherheit</a></li>
<li><a href="server-wide.html">Serverweite Konfiguration</a></li>
<li><a href="ssl/">SSL/TLS-Verschlüsselung</a></li>
<li><a href="suexec.html">Suexec für CGI</a></li>
<li><a href="rewrite/">Einführung in die
URL-Manipulation</a></li>
<li><a href="vhosts/">Virtual-Hosts</a></li>
</ul>
</div></td><td class="col3"><div class="category"><h2><a name="howto" id="howto">Praxis / Anleitungen</a></h2>
<ul><li><a href="howto/auth.html">Authentisierung und Autorisierung</a></li>
<li><a href="howto/access.html">Zugriffskontrolle</a></li>
<li><a href="howto/cgi.html">CGI: Dynamische Inhalte</a></li>
<li><a href="howto/htaccess.html">.htaccess-Dateien</a></li>
<li><a href="howto/ssi.html">Server Side Includes (SSI)</a></li>
<li><a href="howto/public_html.html">Web-Verzeichnisse für Benutzer
(public_html)</a></li>
</ul>
</div><div class="category"><h2><a name="platform" id="platform">Plattform-spezifische Anmerkungen</a></h2>
<ul><li><a href="platform/windows.html">Microsoft Windows</a></li>
<li><a href="platform/rpm.html">RPM-basierte Systeme (Redhat / CentOS / Fedora)</a></li>
<li><a href="platform/netware.html">Novell NetWare</a></li>
<li><a href="platform/ebcdic.html">EBCDIC-Portierung</a></li>
</ul>
</div><div class="category"><h2><a name="other" id="other">Weitere Themen</a></h2>
<ul><li><a href="http://wiki.apache.org/httpd/FAQ">Häufig gestellte
Fragen (FAQ)</a></li>
<li><a href="sitemap.html">Seitenindex</a></li>
<li><a href="developer/">Dokumentation für Entwickler</a></li>
<li><a href="http://httpd.apache.org/docs-project/">Mithilfe bei der Dokumentation</a></li>
<li><a href="misc/">Sonstiges</a></li>
<li><a href="http://wiki.apache.org/httpd/">Wiki</a></li>
</ul>
</div></td></tr></table></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/index.html.da 0000664 0001751 0001751 00000021552 14744525602 017425 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="da" xml:lang="da"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Server Version 2.4
Dokumentation - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="index-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Moduler</a> | <a href="./mod/directives.html">Direktiver</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Ordbog</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></div>
<div class="up"><a href="http://httpd.apache.org/docs-project/"><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 Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a></div>
<div id="page-content"><h1>Apache HTTP Server Version 2.4
Dokumentation</h1>
<div class="toplang">
<p><span>Tilgængelige sprog: </span><a href="./da/" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">Denne oversættelse kan være forældet. Se den Engelske version for de seneste opdateringer.</div>
<form method="get" action="https://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Google Søgning" type="submit" /><input value="10" name="num" type="hidden" /><input value="da" name="hl" type="hidden" /><input value="ISO-8859-1" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="Version 2.4" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value=""List-Post"" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form>
<table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">Udgivelses Noter</a></h2>
<ul><li><a href="new_features_2_4.html">Nye funktioner i Apache 2.3/2.4</a></li>
<li><a href="new_features_2_2.html">Nye funktioner i Apache 2.1/2.2</a></li>
<li><a href="new_features_2_0.html">Nye funktioner i Apache 2.0</a></li>
<li><a href="upgrading.html">Opgradering fra 2.2 til 2.4</a></li>
<li><a href="license.html">Apache Licens</a></li>
</ul>
</div><div class="category"><h2><a name="manual" id="manual">Reference Manual</a></h2>
<ul><li><a href="install.html">Kompilering og installation</a></li>
<li><a href="invoking.html">Opstart</a></li>
<li><a href="stopping.html">At starte og stoppe serveren</a></li>
<li><a href="mod/directives.html">Kørselstidskonfigurationsdirektiver</a></li>
<li><a href="mod/quickreference.html">Hurtig oversigt over direktiver</a></li>
<li><a href="mod/">Moduler</a></li>
<li><a href="mpm.html">Multibehandlingsmoduler (MPM)</a></li>
<li><a href="filter.html">Filtre</a></li>
<li><a href="handler.html">Behandlere</a></li>
<li><a href="programs/">Serveren og understøttende programmer</a></li>
<li><a href="glossary.html">Anvendte gloser</a></li>
</ul>
</div></td><td><div class="category"><h2><a name="usersguide" id="usersguide">Brugerguide</a></h2>
<ul><li><a href="bind.html">Binding</a></li>
<li><a href="configuring.html">Konfigurationsfiler</a></li>
<li><a href="sections.html">Konfigurationssektioner</a></li>
<li><a href="caching.html">Caching af indhold</a></li>
<li><a href="content-negotiation.html">Indholdsforhandling</a></li>
<li><a href="dso.html">Dynamisk delte objekter (DSO)</a></li>
<li><a href="env.html">Miljøvariabler</a></li>
<li><a href="logs.html">Logfiler</a></li>
<li><a href="urlmapping.html">Afbilding af URL'er til filsystem</a></li>
<li><a href="misc/perf-tuning.html">Justering af ydeevne</a></li>
<li><a href="misc/security_tips.html">Sikkerhedstips</a></li>
<li><a href="server-wide.html">Global serverkonfiguration</a></li>
<li><a href="ssl/">SSL/TLS-Kryptering</a></li>
<li><a href="suexec.html">Suexec-afvikling for CGI</a></li>
<li><a href="rewrite/">URL-omskrivning med mod_rewrite</a></li>
<li><a href="vhosts/">Virtuelle værter</a></li>
</ul>
</div></td><td class="col3"><div class="category"><h2><a name="howto" id="howto">How-To / Gennemgange</a></h2>
<ul><li><a href="howto/auth.html">Godkendelse, autorisation og adgangskontrol</a></li>
<li><a href="howto/cgi.html">CGI: Dynamisk indhold</a></li>
<li><a href="howto/htaccess.html">.htaccess filer</a></li>
<li><a href="howto/ssi.html">Server Side Includes (SSI)</a></li>
<li><a href="howto/public_html.html">Per-bruger webmapper (public_html)</a></li>
</ul>
</div><div class="category"><h2><a name="platform" id="platform">Platformspecifikke noter</a></h2>
<ul><li><a href="platform/windows.html">Microsoft Windows</a></li>
<li><a href="platform/netware.html">Novell NetWare</a></li>
<li><a href="platform/ebcdic.html">EBCDIC Port</a></li>
</ul>
</div><div class="category"><h2><a name="other" id="other">Andre emner</a></h2>
<ul><li><a href="faq/">Ofte stillede spørgsmål</a></li>
<li><a href="sitemap.html">Sitemap</a></li>
<li><a href="developer/">Dokumentation for udviklere</a></li>
<li><a href="misc/">Andre noter</a></li>
<li><a href="http://wiki.apache.org/httpd/">Wiki</a></li>
</ul>
</div></td></tr></table></div>
<div class="bottomlang">
<p><span>Tilgængelige sprog: </span><a href="./da/" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licenseret under <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Moduler</a> | <a href="./mod/directives.html">Direktiver</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Ordbog</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/mpm.html.de 0000664 0001751 0001751 00000026205 14744525602 017113 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Multi-Processing-Module (MPMs) - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Multi-Processing-Module (MPMs)</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="./de/mpm.html" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<p>Das Dokument beschreibt, was ein Multi-Processing-Modul ist und wie solche
Module beim Apache HTTP Server verwendet werden.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Einführung</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#choosing">Auswahl eines MPMs</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#defaults">MPM-Voreinstellungen</a></li>
</ul><h3>Siehe auch</h3><ul class="seealso"><li><a href="#comments_section">Kommentare</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="introduction" id="introduction">Einführung</a></h2>
<p>Der Apache HTTP Server wurde als leistungsfähiger und flexibler Webserver
konzipiert, der auf einer Vielzahl von Plattformen in einer
Reihe unterschiedlicher Umgebungen arbeiten kann. Unterschiedliche
Plattformen und unterschiedliche Umgebungen verlangen oftmals verschiedene
Fähigkeiten oder kennen verschiedene Wege, die gleiche
Funktionaltät sehr effizient zu implementieren. Der Apache hat durch
seinen modularen Aufbau schon immer eine breite Auswahl von Umgebungen
unterstützt. Dieses Design erlaubt es dem Webmaster, durch Auswahl der
Module, die zur Kompilierungszeit oder zur Laufzeit geladen werden, die
Features auszuwählen, die in den Server intregiert werden.</p>
<p>Der Apache 2.0 erweitert dieses modulare Design auf die grundlegenden
Funktionen eines Webservers. Der Server wird mit einer Auswahl von
Multi-Processing-Modulen (MPMs) ausgeliefert, die für die Bindung an
Netzwerkports der Maschine, die Annahme von Anfragen und die Abfertigung von
Kindprozessen zur Behandlung der Anfragen zuständig sind.</p>
<p>Die Erweiterung des modularen Aufbaus auf diese Ebene des Servers
bringt zwei wesentliche Vorteile:</p>
<ul>
<li>Der Apache kann nun eine Vielfalt von Betriebssystemen sauberer und
effizienter unterstützen. Insbesondere die Windows-Version des Apache
ist jetzt deutlich effizienter, da <code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code> native
Netzwerkfähigkeiten anstelle der im Apache 1.3 verwendeten
POSIX-Schicht benutzen kann. Dieser Vorteil gilt auch für andere
Betriebssysteme, für die spezielle MPMs implementiert sind.</li>
<li>Der Server läßt sich besser auf die Bedürfnisse der
jeweiligen Website anpassen. Sites beispielsweise, die eine hohe
Skalierbarkeit benötigen, können ein Threaded-MPM wie
<code class="module"><a href="./mod/worker.html">worker</a></code> oder <code class="module"><a href="./mod/event.html">event</a></code> wählen,
während Sites, die Stabilität oder Kompatibilität mit
älterer Software erfordern, <code class="module"><a href="./mod/prefork.html">prefork</a></code> wählen
können.</li>
</ul>
<p>Auf Anwenderebene erscheinen MPMs fast wie andere Apache-Module. Der
Hauptunterschied ist, dass jeweils nur ein einziges MPM in den Server
geladen werden kann. Die Liste der verfügbaren MPMs finden Sie im <a href="mod/">Modul-Index</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="choosing" id="choosing">Auswahl eines MPMs</a></h2>
<p>MPMs müssen während der
<span class="transnote">(<em>Anm.d.Ü.:</em> Quelltext-)</span>Konfiguration ausgewählt und in den
Server einkompiliert werden. Compiler sind in der Lage eine Reihe von
Funktionen zu optimieren, wenn Threads verwendet werden. Sie können
dies allerdings nur, wenn sie wissen, dass Threads benutzt werden.</p>
<p>Um das gewünschte MPM tatsächlich auszuwählen, verwenden Sie
beim <code class="program"><a href="./programs/configure.html">configure</a></code>-Skript das Argument
<code>--with-mpm=<em>NAME</em></code>. <em>NAME</em> ist der Name des
gewünschten MPMs.</p>
<p>Ist der Server kompiliert, so ist es mittels <code>./httpd -l</code>
möglich, das ausgewählte MPM zu ermitteln. Dieser Befehl listet
alle in den Server einkompilierten Module auf, einschließlich des
MPM.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="defaults" id="defaults">MPM-Voreinstellungen</a></h2>
<p>Die folgende Tabelle gibt die voreingestellten MPMs für verschiedene
Betriebssysteme an. Wenn Sie während der Kompilierung keine andere
Auswahl treffen, wird dieses MPM gewählt.</p>
<table>
<tr><td>BeOS</td><td><code class="module"><a href="./mod/beos.html">beos</a></code></td></tr>
<tr><td>Netware</td><td><code class="module"><a href="./mod/mpm_netware.html">mpm_netware</a></code></td></tr>
<tr><td>OS/2</td><td><code class="module"><a href="./mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
<tr><td>Unix</td><td><code class="module"><a href="./mod/prefork.html">prefork</a></code></td></tr>
<tr><td>Windows</td><td><code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="./de/mpm.html" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Kommentare</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mpm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/dso.html.en 0000664 0001751 0001751 00000046421 14737241666 017132 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Dynamic Shared Object (DSO) Support - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Dynamic Shared Object (DSO) Support</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/dso.html" title="English"> en </a> |
<a href="./fr/dso.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>The Apache HTTP Server is a modular program where the
administrator can choose the functionality to include in the
server by selecting a set of modules.
Modules will be compiled as Dynamic Shared Objects (DSOs)
that exist separately from the main <code class="program"><a href="./programs/httpd.html">httpd</a></code>
binary file. DSO modules may be compiled at the time the server
is built, or they may be compiled and added at a later time
using the Apache Extension Tool (<code class="program"><a href="./programs/apxs.html">apxs</a></code>).</p>
<p>Alternatively, the modules can be statically compiled into
the <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary when the server is built.</p>
<p>This document describes how to use DSO modules as well as
the theory behind their use.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#implementation">Implementation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#usage">Usage Summary</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#background">Background</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#advantages">Advantages and Disadvantages</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="implementation" id="implementation">Implementation</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>The DSO support for loading individual Apache httpd modules is based
on a module named <code class="module"><a href="./mod/mod_so.html">mod_so</a></code> which must be statically
compiled into the Apache httpd core. It is the only module besides
<code class="module"><a href="./mod/core.html">core</a></code> which cannot be put into a DSO
itself. Practically all other distributed Apache httpd modules will then
be placed into a DSO. After a module is compiled into a DSO named
<code>mod_foo.so</code> you can use <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>'s <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> directive in your
<code>httpd.conf</code> file to load this module at server startup
or restart.</p>
<p>The DSO builds for individual modules can be disabled via
<code class="program"><a href="./programs/configure.html">configure</a></code>'s <code>--enable-mods-static</code>
option as discussed in the <a href="install.html">install
documentation</a>.</p>
<p>To simplify this creation of DSO files for Apache httpd modules
(especially for third-party modules) a support program
named <code class="program"><a href="./programs/apxs.html">apxs</a></code> (<dfn>APache
eXtenSion</dfn>) is available. It can be used to build DSO based
modules <em>outside of</em> the Apache httpd source tree. The idea is
simple: When installing Apache HTTP Server the <code class="program"><a href="./programs/configure.html">configure</a></code>'s
<code>make install</code> procedure installs the Apache httpd C
header files and puts the platform-dependent compiler and
linker flags for building DSO files into the <code class="program"><a href="./programs/apxs.html">apxs</a></code>
program. This way the user can use <code class="program"><a href="./programs/apxs.html">apxs</a></code> to compile
his Apache httpd module sources without the Apache httpd distribution
source tree and without having to fiddle with the
platform-dependent compiler and linker flags for DSO
support.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="usage" id="usage">Usage Summary</a></h2>
<p>To give you an overview of the DSO features of Apache HTTP Server 2.x,
here is a short and concise summary:</p>
<ol>
<li>
<p>Build and install a <em>distributed</em> Apache httpd module, say
<code>mod_foo.c</code>, into its own DSO
<code>mod_foo.so</code>:</p>
<div class="example"><p><code>
$ ./configure --prefix=/path/to/install --enable-foo<br />
$ make install
</code></p></div>
</li>
<li>
<p>Configure Apache HTTP Server with all modules enabled. Only a basic
set will be loaded during server startup. You can change the set of loaded
modules by activating or deactivating the <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> directives in
<code>httpd.conf</code>.</p>
<div class="example"><p><code>
$ ./configure --enable-mods-shared=all<br />
$ make install
</code></p></div>
</li>
<li>
<p>Some modules are only useful for developers and will not be build.
when using the module set <em>all</em>. To build all available modules
including developer modules use <em>reallyall</em>. In addition the
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> directives for all
built modules can be activated via the configure option
<code>--enable-load-all-modules</code>.</p>
<div class="example"><p><code>
$ ./configure --enable-mods-shared=reallyall --enable-load-all-modules<br />
$ make install
</code></p></div>
</li>
<li>
Build and install a <em>third-party</em> Apache httpd module, say
<code>mod_foo.c</code>, into its own DSO
<code>mod_foo.so</code> <em>outside of</em> the Apache httpd
source tree using <code class="program"><a href="./programs/apxs.html">apxs</a></code>:
<div class="example"><p><code>
$ cd /path/to/3rdparty<br />
$ apxs -cia mod_foo.c
</code></p></div>
</li>
</ol>
<p>In all cases, once the shared module is compiled, you must
use a <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
directive in <code>httpd.conf</code> to tell Apache httpd to activate
the module.</p>
<p>See the <a href="programs/apxs.html">apxs documentation</a> for more details.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="background" id="background">Background</a></h2>
<p>On modern Unix derivatives there exists a mechanism
called dynamic linking/loading of <em>Dynamic Shared
Objects</em> (DSO) which provides a way to build a piece of
program code in a special format for loading it at run-time
into the address space of an executable program.</p>
<p>This loading can usually be done in two ways: automatically
by a system program called <code>ld.so</code> when an
executable program is started or manually from within the
executing program via a programmatic system interface to the
Unix loader through the system calls
<code>dlopen()/dlsym()</code>.</p>
<p>In the first way the DSO's are usually called <em>shared
libraries</em> or <em>DSO libraries</em> and named
<code>libfoo.so</code> or <code>libfoo.so.1.2</code>. They
reside in a system directory (usually <code>/usr/lib</code>)
and the link to the executable program is established at
build-time by specifying <code>-lfoo</code> to the linker
command. This hard-codes library references into the executable
program file so that at start-time the Unix loader is able to
locate <code>libfoo.so</code> in <code>/usr/lib</code>, in
paths hard-coded via linker-options like <code>-R</code> or in
paths configured via the environment variable
<code>LD_LIBRARY_PATH</code>. It then resolves any (yet
unresolved) symbols in the executable program which are
available in the DSO.</p>
<p>Symbols in the executable program are usually not referenced
by the DSO (because it's a reusable library of general code)
and hence no further resolving has to be done. The executable
program has no need to do anything on its own to use the
symbols from the DSO because the complete resolving is done by
the Unix loader. (In fact, the code to invoke
<code>ld.so</code> is part of the run-time startup code which
is linked into every executable program which has been bound
non-static). The advantage of dynamic loading of common library
code is obvious: the library code needs to be stored only once,
in a system library like <code>libc.so</code>, saving disk
space for every program.</p>
<p>In the second way the DSO's are usually called <em>shared
objects</em> or <em>DSO files</em> and can be named with an
arbitrary extension (although the canonical name is
<code>foo.so</code>). These files usually stay inside a
program-specific directory and there is no automatically
established link to the executable program where they are used.
Instead the executable program manually loads the DSO at
run-time into its address space via <code>dlopen()</code>. At
this time no resolving of symbols from the DSO for the
executable program is done. But instead the Unix loader
automatically resolves any (yet unresolved) symbols in the DSO
from the set of symbols exported by the executable program and
its already loaded DSO libraries (especially all symbols from
the ubiquitous <code>libc.so</code>). This way the DSO gets
knowledge of the executable program's symbol set as if it had
been statically linked with it in the first place.</p>
<p>Finally, to take advantage of the DSO's API the executable
program has to resolve particular symbols from the DSO via
<code>dlsym()</code> for later use inside dispatch tables
<em>etc.</em> In other words: The executable program has to
manually resolve every symbol it needs to be able to use it.
The advantage of such a mechanism is that optional program
parts need not be loaded (and thus do not spend memory) until
they are needed by the program in question. When required,
these program parts can be loaded dynamically to extend the
base program's functionality.</p>
<p>Although this DSO mechanism sounds straightforward there is
at least one difficult step here: The resolving of symbols from
the executable program for the DSO when using a DSO to extend a
program (the second way). Why? Because "reverse resolving" DSO
symbols from the executable program's symbol set is against the
library design (where the library has no knowledge about the
programs it is used by) and is neither available under all
platforms nor standardized. In practice the executable
program's global symbols are often not re-exported and thus not
available for use in a DSO. Finding a way to force the linker
to export all global symbols is the main problem one has to
solve when using DSO for extending a program at run-time.</p>
<p>The shared library approach is the typical one, because it
is what the DSO mechanism was designed for, hence it is used
for nearly all types of libraries the operating system
provides.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="advantages" id="advantages">Advantages and Disadvantages</a></h2>
<p>The above DSO based features have the following
advantages:</p>
<ul>
<li>The server package is more flexible at run-time because
the server process can be assembled at run-time via
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
<code>httpd.conf</code> configuration directives instead of
<code class="program"><a href="./programs/configure.html">configure</a></code> options at build-time. For instance,
this way one is able to run different server instances
(standard & SSL version, minimalistic & dynamic
version [mod_perl, mod_php], <em>etc.</em>) with only one Apache httpd
installation.</li>
<li>The server package can be easily extended with
third-party modules even after installation. This is
a great benefit for vendor package maintainers, who can create
an Apache httpd core package and additional packages containing
extensions like PHP, mod_perl, mod_security, <em>etc.</em></li>
<li>Easier Apache httpd module prototyping, because with the
DSO/<code class="program"><a href="./programs/apxs.html">apxs</a></code> pair you can both work outside the
Apache httpd source tree and only need an <code>apxs -i</code>
command followed by an <code>apachectl restart</code> to
bring a new version of your currently developed module into
the running Apache HTTP Server.</li>
</ul>
<p>DSO has the following disadvantages:</p>
<ul>
<li>The server is approximately 20% slower at startup time
because of the symbol resolving overhead the Unix loader now
has to do.</li>
<li>The server is approximately 5% slower at execution time
under some platforms, because position independent code (PIC)
sometimes needs complicated assembler tricks for relative
addressing, which are not necessarily as fast as absolute
addressing.</li>
<li>Because DSO modules cannot be linked against other
DSO-based libraries (<code>ld -lfoo</code>) on all platforms
(for instance a.out-based platforms usually don't provide
this functionality while ELF-based platforms do) you cannot
use the DSO mechanism for all types of modules. Or in other
words, modules compiled as DSO files are restricted to only
use symbols from the Apache httpd core, from the C library
(<code>libc</code>) and all other dynamic or static libraries
used by the Apache httpd core, or from static library archives
(<code>libfoo.a</code>) containing position independent code.
The only chances to use other code is to either make sure the
httpd core itself already contains a reference to it or
loading the code yourself via <code>dlopen()</code>.</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/dso.html" title="English"> en </a> |
<a href="./fr/dso.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/dso.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/glossary.html.de 0000664 0001751 0001751 00000105470 14744525602 020167 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Glossar - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Glossar</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="./de/glossary.html" title="Deutsch"> de </a> |
<a href="./en/glossary.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/glossary.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/glossary.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<p>Dieses Glossar erläutert einige gebräuchliche Fachbegriffe im
Zusammenhang mit dem Apache im Speziellen und Web-Diensten im
Allgemeinen. Weitere Informationen zum jeweiligen Begriff erreichen Sie
über die Links.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="definitions" id="definitions">Definitionen</a></h2>
<dl>
<dt><a name="algorithm" id="algorithm">Algorithmus</a></dt>
<dd>Eine eindeutige Formel oder ein Satz von Regeln zur Lösung eines
Problems in einer endlichen Anzahl von Schritten. Algorithmen zur
Verschlüsselung werden üblicherweise <a class="glossarylink" href="./glossary.html#cipher" title="siehe Glossar"><dfn>Chiffre</dfn></a> genannt.
</dd>
<dt><a name="apacheextensiontool" id="apacheextensiontool">APache
eXtension Tool</a> <a name="apxs" id="apxs">(apxs)</a></dt>
<dd>Ein Perl-Skript zur Kompilierung von <a href="#module">Modul</a>-Quelltexten zu Dynamic-Shared-Objects
(<a class="glossarylink" href="./glossary.html#dso" title="siehe Glossar">DSOs</a>) und zur Installation dieser zum
Apache-Webserver.<br />
Siehe: <code class="program"><a href="./programs/apxs.html">apxs</a></code>-Dokumentation
</dd>
<dt><a name="apacheportableruntime" id="apacheportableruntime">Apache Portable Runtime</a> <a name="apr" id="apr">(APR)</a></dt>
<dd>Eine Menge von Bibliotheken, die viele grundlegende Schnittstellen
zwischen dem Server und dem Betriebssystem anbietet. Die APR
wird parallel zum Apache HTTP Server in einem eigenständigen Projekt
entwickelt.<br />
Siehe auch: <a href="http://apr.apache.org/">Apache Portable Runtime
Project</a>
</dd>
<dt><a name="authentication" id="authentication">Authentifizierung</a></dt>
<dd>Die positive Identifizierung einer Netzwerkeinheit, wie z.B.
eines Servers, eines Clients oder eines Benutzers.<br />
Siehe: <a href="howto/auth.html">Authentisierung, Autorisierung und
Zugriffskontrolle</a>
</dd>
<dt><a name="certificationauthority" id="certificationauthority">Certification Authority</a>
<span class="phonetic">[səˈtifiˈkeiʃən
ɔːθɔriti]</span>
<a name="ca" id="ca">(CA)</a></dt>
<dd><span class="transnote">(<em>Anm.d.Ü.:</em> die Zertifizierungsstelle)</span> Eine
vertrauenswürdige dritte Partei, deren Zweck es ist,
Zertifikate für Netzwerkeinheiten zu signieren. Andere
Netzwerkeinheiten können die Signatur prüfen, um
sicherzustellen, dass eine CA den Inhaber eines Zertifikats
authentifiziert hat.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="certificatsigningrequest" id="certificatsigningrequest">Certificate Signing Request</a>
<span class="phonetic">[səˈtifikit sainiŋ
riˈkwest]</span> <a name="csr" id="csr">(CSR)</a></dt>
<dd><span class="transnote">(<em>Anm.d.Ü.:</em> Zertifikats-Signierungsanfrage)</span> Ein unsigniertes
<a class="glossarylink" href="./glossary.html#certificate" title="siehe Glossar">Zertifikat</a> zur Einreichung bei
einer <a class="glossarylink" href="./glossary.html#certificationauthority" title="siehe Glossar">Zertifizierungsstelle</a>, welche
es mit dem <a class="glossarylink" href="./glossary.html#privatekey" title="siehe Glossar">privaten Schlüssel</a>
ihres CA-<em>Zertifikats</em> signiert. Durch die Signatur wird ein CSR
zum echten Zertifikat.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="cipher" id="cipher">Chiffre</a></dt>
<dd>Die <dfn>Chiffre</dfn> ist ein Algorithmus oder System zur
Datenverschlüsselung. Beispiele sind DES, IDEA, RC4 usw. Im
Englischen spricht man von
<dfn>Cipher</dfn> <span class="phonetic">[ˈsaifə]</span><br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="ciphertext" id="ciphertext">Chiffretext</a></dt>
<dd>Das Ergebnis, nachdem ein <a class="glossarylink" href="./glossary.html#plaintext" title="siehe Glossar">Klartext</a>
eine <a class="glossarylink" href="./glossary.html#cipher" title="siehe Glossar">Chiffre</a> durchlaufen hat.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="commongatewayinterface" id="commongatewayinterface">Common
Gateway Interface</a> <span class="phonetic">[ˈkɔmən geitwei
ˈintəːfeis]</span>
<a name="cgi" id="cgi">(CGI)</a></dt>
<dd>Eine einheitliche Definition einer Schnittstelle zwischen einem
Webserver und einem externen Programm, welcher dem externen Programm die
Behandlung von Anfragen ermöglicht. Die Schnittstelle ist
ursprünglich von der <a href="http://hoohoo.ncsa.uiuc.edu/cgi/overview.html">NCSA</a>
definiert worden. Es exisitert jedoch auch ein <a href="http://cgi-spec.golux.com/">RFC-Projekt</a>.<br />
Siehe: <a href="howto/cgi.html">Dynamische Inhalte mit CGI</a>
</dd>
<dt><a name="connect" id="connect">CONNECT</a>
<span class="phonetic">[kənekt]</span></dt>
<dd>Eine <a class="glossarylink" href="./glossary.html#method" title="siehe Glossar">HTTP-Methode</a> zur Weiterleitung
von Rohdaten über HTTP. Sie kann dazu verwendet werden, andere
Protokolle wie zum Beispiel das SSL-Protokoll zu kapseln.
</dd>
<dt><a name="digitalsignature" id="digitalsignature">Digitale
Signatur</a></dt>
<dd>Ein chiffrierter Textblock, der die Gültigkeit eines Zertifikats
oder einer anderen Datei bestätigt. Eine <a class="glossarylink" href="./glossary.html#certificationauthority" title="siehe Glossar">Zertifizierungsstelle</a> erstellt
eine digitale Signatur durch Generierung eines <a class="glossarylink" href="./glossary.html#hash" title="siehe Glossar">Hashs</a> aus dem in einem <em>Zertifikat</em>
enthaltenen <em>öffentlichen Schlüssel</em> und
anschließender Codierung des Hashs mit dem <em>privaten
Schlüssel</em> des Zertifikats. Nur der öffentliche
Schlüssel der CA kann die Signatur decodieren. So wird
sichergestellt, dass die CA die Netwerkeinheit, welche das
<em>Zertifikat</em> besitzt, authentifiziert hat.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="directive" id="directive">Direktive</a></dt>
<dd>Eine Konfigurationsanweisung, die das Verhalten des Apache in einem
oder mehreren Punkten steuert. Direktiven werden in den <a class="glossarylink" href="./glossary.html#configurationfile" title="siehe Glossar">Konfigurationsdateien</a> gesetzt.<br />
Siehe: <a href="mod/directives.html">Verzeichnis der Direktiven</a>
</dd>
<dt><a name="dynamicsharedobject" id="dynamicsharedobject">Dynamic
Shared Object</a>
<span class="phonetic">[daiˈnæmik ʃɛəd
ˈɔbdʒikt]</span> <a name="dso" id="dso">(DSO)</a></dt>
<dd>Separat von der Apache-Binärdatei <code class="program"><a href="./programs/httpd.html">httpd</a></code>
kompilierte <a class="glossarylink" href="./glossary.html#module" title="siehe Glossar">Module</a>, die bei Bedarf
geladen werden können.<br />
Siehe: <a href="dso.html">Unterstützung für
Dynamic-Shared-Objects</a>
</dd>
<dt><a name="export-crippled" id="export-crippled">exportbeschränkt</a></dt>
<dd>Verminderte kryptografische Stärke (und Sicherheit), um den
Exportbesimmungen der Vereinigten Staaten <span class="transnote">(<em>Anm.d.Ü.:</em> konkret: United
States' Export Administration Regulations (EAR))</span> zu
entsprechen. Exportbeschränkte Verschlüsselungssoftware ist
auf eine kurze Schlüssellänge begrenzt, was zu
<em>Chiffretexten</em> führt, die gewöhnlich mittels
Brute-Force dekodiert werden können.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="filter" id="filter">Filter</a></dt>
<dd>Ein Verfahren, dass auf vom Server empfangene oder zu sendende Daten
angewendet wird. Eingabefilter verarbeiten vom Client an den Server
gesendetet Daten, während Ausgabefilter vom Server an den Client zu
sendende Daten verarbeiten. Der Ausgabefilter <code>INCLUDES</code>
beispielsweise untersucht Dokumente nach <a class="glossarylink" href="./glossary.html#ssi" title="siehe Glossar">Server-Side-Includes</a> und führt sie aus.<br />
Siehe: <a href="filter.html">Filter</a>
</dd>
<dt><a name="handler" id="handler">Handler</a>
<span class="phonetic">[ˈhændlə]</span></dt>
<dd>Eine Apache-interne Darstellung der Aktion, die beim Aufruf einer
Datei auszuführen ist. Im Allgemeinen besitzen Dateien implizite,
auf dem Dateityp basierende Handler. Gewöhnlich werden alle Dateien
vom Server bedient, einige Dateitypen werden jedoch separat "behandelt"
<span class="transnote">(<em>Anm.d.Ü.:</em> besitzen einen separaten Handler)</span>. Der
<code>cgi-script</code>-Handler beispielsweise kennzeichnet Dateien, die
als <a class="glossarylink" href="./glossary.html#cgi" title="siehe Glossar">CGI-Programme</a> ausgeführt werden
sollen.<br />
Siehe: <a href="handler.html">Verwendung von Apache-Handlern</a>
</dd>
<dt><a name="hash" id="hash">Hash</a>
<span class="phonetic">[hæʃ]</span></dt>
<dd>Ein mathematischer, unumkehrbarer Einweg-Algorithmus zur Generierung
einer Zeichenfolge fester Länge aus einer anderen Zeichenfolge
beliebiger Länge. Unterschiedliche Zeichenfolgen bei der Eingabe
ergeben üblischerweise unterschiedliche Hashes (abhängig von
der Hash-Funktion).
</dd>
<dt><a name="header" id="header">Header</a>
<span class="phonetic">[hedə]</span></dt>
<dd>Der Teil der <a class="glossarylink" href="./glossary.html#http" title="siehe Glossar">HTTP</a>-Anfrage und -Antwort,
der vor den eigentlichen Daten übermittelt wird und den Inhalt
beschreibende Meta-Informationen enthält.
</dd>
<dt><a name="htaccess" id="htaccess">.htaccess</a></dt>
<dd>Eine <a class="glossarylink" href="./glossary.html#configurationfile" title="siehe Glossar">Konfigurationsdatei</a>,
die innerhalb des Web-Verzeichnisbaums abgelegt wird und zu dem
Verzeichnis, in dem sie abgelegt ist, sowie allen Unterverzeichnissen
<a class="glossarylink" href="./glossary.html#directive" title="siehe Glossar">Konfigurationsdirektiven</a>
enthält. Trotz ihres Namens kann diese Datei nahezu alle Arten von
Direktiven enthalten, nicht nur Direktiven zur Zugriffskontrolle.<br />
Siehe: <a href="configuring.html">Konfigurationsdateien</a>
</dd>
<dt><a name="httpd.conf" id="httpd.conf">httpd.conf</a></dt>
<dd>Die <a class="glossarylink" href="./glossary.html#configurationfile" title="siehe Glossar">Haupt-Konfigurationsdatei</a> ist
<code>/usr/local/apache2/conf/httpd.conf</code>. Dies kann aber zur
Laufzeit oder zur Kompilierungszeit anders konfiguriert werden.<br />
Siehe: <a href="configuring.html">Konfigurationsdateien</a>
</dd>
<dt><a name="https" id="https">HTTPS</a></dt>
<dd>Das HyperText-Transfer-Protokoll (Secure), der
Standard-Verschlüsselungsmechanismus im World Wide Web.
Tatsächlich handelt es sich hierbei um HTTP über <a class="glossarylink" href="./glossary.html#ssl" title="siehe Glossar">SSL</a>.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="hypertexttransferprotocol" id="hypertexttransferprotocol">HyperText-Transfer-Protokoll</a>
<a name="http" id="http">(HTTP)</a></dt>
<dd>Das Standard-Übertragungsprotokoll im World Wide Web. Der Apache
implementiert die Protokollversion 1.1, bezeichnet als HTTP/1.1 und
definiert in <a href="http://ietf.org/rfc/rfc2616.txt">RFC 2616</a>.
</dd>
<dt><a name="plaintext" id="plaintext">Klartext</a></dt>
<dd>Der unverschlüsselte Text.</dd>
<dt><a name="configurationdirective" id="configurationdirective">Konfigurationsanweisung</a></dt>
<dd>Siehe: <a class="glossarylink" href="./glossary.html#directive" title="siehe Glossar">Direktive</a></dd>
<dt><a name="configurationfile" id="configurationfile">Konfigurationsdatei</a></dt>
<dd>Eine Textdatei mit <a class="glossarylink" href="./glossary.html#directive" title="siehe Glossar">Direktiven</a>,
welche die Konfiguration des Apache steuern.<br />
Siehe: <a href="configuring.html">Konfigurationsdateien</a>
</dd>
<dt><a name="context" id="context">Kontext</a></dt>
<dd>Ein Bereich in den <a class="glossarylink" href="./glossary.html#configurationfile" title="siehe Glossar">Konfigurationsdateien</a>, in dem
verschiedene Typen von <a class="glossarylink" href="./glossary.html#directive" title="siehe Glossar">Direktiven</a>
erlaubt sind.<br />
Siehe: <a href="mod/directive-dict.html#Context">Erklärung der
Fachbegriffe zu Apache-Direktiven</a>
</dd>
<dt><a name="messagedigest" id="messagedigest">Message-Digest</a>
<span class="phonetic">[ˈmesidʒ]</span></dt>
<dd>Ein Hash einer Nachricht, mit dem sich sicherstellen läßt,
dass der Inhalt der Nachricht während der Übertragung nicht
verändert wurde. <span class="transnote">(<em>Anm.d.Ü.:</em> ein so genannter Extrakt der
Nachricht)</span><br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="method" id="method">Methode</a></dt>
<dd>Im <a class="glossarylink" href="./glossary.html#http" title="siehe Glossar">HTTP</a>-Kontext eine in der
Anfrage(zeile) des Clients angegeben Aktion, die auf eine Ressource
angewendet wird. <code>GET</code>, <code>POST</code> und <code>PUT</code>
sind einige der verfügbaren HTTP-Methoden.
</dd>
<dt><a name="mime-type" id="mime-type">MIME-Typ</a>
<span class="phonetic">[maim tyːp]</span></dt>
<dd>Eine Art und Weise, den Typ des übermittelten Dokuments zu
beschreiben. Sein Name leitet sich davon ab, dass sein Format den
Multipurpose Internet Mail Extensions entlehnt wurde. Er besteht aus
einem Haupttyp und einem Untertyp, getrennt durch einen
Schrägstrich. Einige Beispiele sind <code>text/html</code>,
<code>image/gif</code> und <code>application/octet-stream</code>.
Bei HTTP wird der MIME-Typ mit dem <a class="glossarylink" href="./glossary.html#header" title="siehe Glossar">Header</a> <code>Content-Type</code>
übermittelt.<br />
Siehe: <a href="mod/mod_mime.html">mod_mime</a>
</dd>
<dt><a name="module" id="module">Modul</a></dt>
<dd>Ein selbstständiger Teil eines Programms. Ein Großteil der
Funktionalität des Apache ist in Modulen enthalten, die Sie einbinden
oder entfernen können. In die Apache-Binärdatei <code class="program"><a href="./programs/httpd.html">httpd</a></code> einkompilierte Module werden <em>statische Module</em>
genannt, während Module, die separat gespeichert sind und optional
zur Laufzeit geladen werden können, <em>dynamische Module</em> oder
<a class="glossarylink" href="./glossary.html#dso" title="siehe Glossar">DSOs</a> genannt werden.
Standardmäßig eingebundene Module werden <em>Basismodule</em>
genannt. Für den Apache sind viele Module verfügbar, die nicht
als Bestandteil des <a class="glossarylink" href="./glossary.html#tarball" title="siehe Glossar">Apache-HTTP-Server-Tarballs</a> ausgeliefert
werden. Diese werden als <em>Drittmodule</em> bezeichnet.<br />
Siehe: <a href="mod/">Modulverzeichnis</a>
</dd>
<dt><a name="modulemagicnumber" id="modulemagicnumber">Module-Magic-Number</a>
<span class="phonetic">[ˈmɔjuːl mædʒik
ˈnʌmbə]</span>
(<a name="mmn" id="mmn">MMN</a>)</dt>
<dd>Die Module-Magic-Number ist eine Konstante, die im Apache-Quelltext
definiert ist und im Zusammenhang mit der Binärkompatibilität
von Modulen steht. Sie wird geändert, wenn sich interne
Apache-Strukturen, -Funktionen oder andere signifikante Teile der API
derart ändern, dass eine Binärkompatibilität nicht mehr
gewährleistet werden kann. Bei einer MMN-Änderung müssen
alle Module von Drittanbietern zumindest neu kompiliert und zuweilen auch
geringfügig angepaßt werden, um mit der neuen Apache-Version zu
funktionieren.
</dd>
<dt><a name="publickey" id="publickey">Öffentlicher
Schlüssel</a></dt>
<dd>Der öffentlich verfügbare Schlüssel in einem <a class="glossarylink" href="./glossary.html#publickeycryptography" title="siehe Glossar">Public-Key-Kryptographie</a>-System,
mit dem für seinen Eigentümer bestimmte Nachrichten
verschlüsselt und Signaturen von seinem Eigentümer
entschlüsselt werden.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="openssl" id="openssl">OpenSSL</a>
<span class="phonetic">[ˈəupənɛsɛsˈɛl]</span>
</dt>
<dd>Das Open-Source-Toolkit für SSL/TLS<br />
Siehe: <a href="http://www.openssl.org/">http://www.openssl.org/</a>
</dd>
<dt><a name="passphrase" id="passphrase">Passphrase</a>
<span class="phonetic">[paːfreiz]</span></dt>
<dd>Das Wort oder die Phrase, welches private Schlüssel-Dateien
schützt. Sie verhindert die Entschlüsselung durch nicht
authorisierte Benutzer. Normalerweise ist dies einfach der geheimen
(De-)Codierungsschlüssel, der für <a class="glossarylink" href="./glossary.html#cipher" title="siehe Glossar">Chiffren</a> verwendet wird.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="privatekey" id="privatekey">Privater Schlüssel</a></dt>
<dd>Der geheime Schlüssel in einem <a class="glossarylink" href="./glossary.html#publickeycryptography" title="siehe Glossar">Public-Key-Kryptographie</a>-System,
mit dem hereinkommende Nachrichten decodiert und ausgehende signiert
werden.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="proxy" id="proxy">Proxy</a></dt>
<dd>Ein zwischen dem Client und dem <em>ursprünglichen Server</em>
<span class="transnote">(<em>Anm.d.Ü.:</em> der Server, den der Client tatsächlich erreichen
möchte)</span> liegender Server. Er nimmt Anfragen von
Clients entgegen, übermittelt diese Anfragen dem
ursprünglichen Server und liefert die Antwort des
ursprünglichen Servers an den Client zurück. Wenn mehrere
Clients den gleichen Inhalt abfragen, dann kann der Proxy diesen Inhalt
aus seinem Zwischenspeicher ausliefern, anstatt ihn jedesmal vom
ursprünglichen Server anzufordern, und dadurch die Antwortzeit
verringern.<br />
Siehe: <a href="mod/mod_proxy.html">mod_proxy</a>
</dd>
<dt><a name="publickeycryptography" id="publickeycryptography">Public-Key-Kryptographie</a>
<span class="phonetic">[ˈpʌblik kiː
ˈkyptograˈfiː]</span></dt>
<dd>Theorie und Anwendung asymmetrischer Verschlüsselungssysteme,
die einen Schlüssel zur Verschlüsselung und einen anderen zur
Entschlüsselung verwenden. Zwei derart zusammengehörende
Schlüssel bilden Schüsselpaar. Man spricht auch von
"Asymetrischer Kryptographie".<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="regularexpresion" id="regularexpresion">Regulärer
Ausdruck</a> <a name="regex" id="regex">(Regex)</a></dt>
<dd>Eine Form, ein Muster im Text zu beschreiben - zum Beispiel: "alle
Wörter, die mit dem Buchstaben A beginnen" oder "Jeder Satz mit
zwei Kommata und ohne großes Q". Beim Apache sind reguläre
Ausdrücke hilfreich, da sie auf sehr flexible Art und Weise die
Anwendung bestimmter Eigenschaften auf eine Auswahl von Dateien oder
Ressourcen ermöglichen. - Zum Beispiel können alle .gif- und
.jpg-Dateien eines Verzeichnis "images" mit
"<code>/images/.*(jpg|gif)$</code>" beschrieben werden. Der Apache
verwendet Perl-kompatible reguläre Ausdrücke, wie sie die
<a href="http://www.pcre.org/">PCRE</a>-Bibliothek bereitstellt.
</dd>
<dt><a name="reverseproxy" id="reverseproxy">Reverse Proxy</a>
<span class="phonetic">[riːvəːs
ˈprɔksi]</span></dt>
<dd>Ein <a class="glossarylink" href="./glossary.html#proxy" title="siehe Glossar">Proxy</a>-Server, der dem Client
gegenüber als <em>ursprünglicher Server</em> erscheint. Dies
ist nützlich, um den tatsächlichen Server aus
Sicherheitsgründen oder zur Lastverteilung vor dem Client zu
verstecken.
</dd>
<dt><a name="securesocketslayer" id="securesocketslayer">Secure Sockets
Layer</a> <span class="phonetic">[siˈkjuə ˈsɔkits
ˈleiə]</span> <a name="ssl" id="ssl">(SSL)</a></dt>
<dd>Ein von der Firma Netscape Communications Corporation entwickeltes
Protokoll zur allgemeinen Authentisierung und Verschlüsselung der
Kommunikation über TCP/IP-Netzwerke. Die meistverbreitete Nutzung
ist <em>HTTPS</em>, d.h. HyperText Transfer Protocol (HTTP) über
SSL.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="serversideincludes" id="serversideincludes">Server Side
Includes</a> <span class="phonetic">[səːə said
inˈkluːds]</span> <a name="ssi" id="ssi">(SSI)</a></dt>
<dd>Eine Technik zum Einbetten von weiterverarbeitenden Anweisungen in
HMTL-Dateien.<br />
Siehe: <a href="howto/ssi.html">Einführung in Server Side
Includes</a>
</dd>
<dt><a name="session" id="session">Session</a>
<span class="phonetic">[ˈseʃən]</span></dt>
<dd>Allgemein der Kontext einer Kommunikation.</dd>
<dt><a name="ssleay" id="ssleay">SSLeay</a></dt>
<dd>Die Bibliothek der Original-SSL/TLS-Implementation von Eric A.
Young</dd>
<dt><a name="symmetriccryptophraphy" id="symmetriccryptophraphy">Symmetrische Kryptographie</a></dt>
<dd>Die Theorie und Anwendung von <em>Chiffren</em>, die einen einzigen
geheimen Schlüssel sowohl zur Verschlüsswelung als auch zur
Entschlüsselung benutzen.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="tarball" id="tarball">Tarball</a>
<span class="phonetic">[taːbɔːl]</span></dt>
<dd>Ein Paket von Dateien, die mit dem Hilfsprogramm <code>tar</code>
zusammengefasst wurden. Apache-Distributionen werden in komprimierten
tar-Archiven oder unter Verwendung von pkzip gespeichert.
</dd>
<dt><a name="transportlayersecurity" id="transportlayersecurity">Transport
Layer Security</a> <span class="phonetic">[trænsˈpɔːt
ˈeiə siˈkjuəriti]</span>
<a name="tls" id="tls">(TLS)</a></dt>
<dd>Das SSL-Nachfolgeprotokoll, das von der Internet Engineering Task
Force (IETF) zur allgemeinen Authentisierung und Verschlüsselung
einer Kommunikation über TCP/IP-Netzwerke entwickelt worden ist.
TLS Version 1 ist nahezu identisch mit SSL Version 3.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsseliung</a>
</dd>
<dt><a name="environmentvariable" id="environmentvariable">Umgebungsvariable</a> <a name="env-variable" id="env-variable">(env-Variable)</a></dt>
<dd>Benannte, von der Betriebssystem-Shell verwaltete Variablen zur
Speicherung von Informationen und zur Kommunikation zwischen Programmen.
Der Apache beinhaltet auch interne Variablen, die ebenfalls
Umgebungsvariablen genannt werden, die aber statt in der
Shell-Umgebung in internen Apache-Strukturen gespeichert sind.<br />
Siehe: <a href="env.html">Umgebungsvariablen im Apache</a>
</dd>
<dt><a name="uniformresourcelocator" id="uniformresourcelocator">Uniform
Resource Locator</a> <span class="phonetic">[ˈjuːnifɔːm
riˈsɔːs ləuˈkeitə]</span>
<a name="url" id="url">(URL)</a></dt>
<dd>Der Name bzw. die Adresse einer Ressource im Internet. Dies ist der
allgemein gebräuchliche Audruck für die formale Bezeichnung
<a class="glossarylink" href="./glossary.html#uniformresourceidentifier" title="siehe Glossar">Uniform Resource
Identifier</a>. URLs bestehen üblicherweise aus einem
Schema wie <code>http</code> oder <code>https</code>, einem Hostnamen
und einem Pfad. Die URL für diese Seite ist
<code>http://httpd.apache.org/docs/2.4/glossary.html</code>.
</dd>
<dt><a name="uniformresourceidentifier" id="uniformresourceidentifier">Uniform Resource Identifier</a>
<span class="phonetic">[ˈjuːnifɔːm
riˈsɔːs aiˈdentifaiə]</span>
<a name="URI" id="URI">(URI)</a></dt>
<dd>Eine kompakte Zeichenfolge zur Identifizierung einer abstrakten oder
physischen Ressource. Er wird in dem <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a> formell
definiert. Im World Wide Web verwendete URIs werden üblicherweise
als <a class="glossarylink" href="./glossary.html#url" title="siehe Glossar">URLs</a> bezeichnet.
</dd>
<dt><a name="virtualhosting" id="virtualhosting">Virtual-Hosting</a>
<span class="phonetic">[vəˈtjuəl
həustiŋ]</span></dt>
<dd>Die Bedienung mehrere Websites mit einer einzigen Apache-Instanz.
<em>IP-basierte virtuelle Hosts</em> unterscheiden zwischen
verschiedenen Websites aufgrund ihrer IP-Adressen, während
<em>namensbasierte virtuelle Hosts</em> nur den Namen des Hosts
verwenden und daher mehrere Angebote unter der gleichen IP-Adresse
hosten können.<br />
Siehe: <a href="vhosts/">Apache-Dokumentation zu virtuellen
Hosts</a>
</dd>
<dt><a name="fully-qualifieddomain-name" id="fully-qualifieddomain-name">Voll-qualifizierter Domainname</a>
<a name="fqdn" id="fqdn">(FQDN)</a></dt>
<dd>Der eindeutige Name einer Netzwerkeinheit, bestehend aus einem
Hostnamen und dem Domainnamen, welcher zu einer IP-Adresse
aufgelöst werden kann. Zum Beispiel ist <code>www</code> ein
Hostname, <code>example.com</code> ein Domainname und
<code>www.example.com</code> ein voll-qualifizierter Domainname.
</dd>
<dt><a name="website" id="website">Website</a>
<span class="phonetic">[websait]</span></dt>
<dd>Im Gegensatz zur Webseite, die einer konkreten URL entspricht, ist mit
Website ein komplettes Angebot unter einem bestimmten Hostnamen (und Port)
gemeint. Dieses kann aus vielen verschiedenen Webseiten bestehen.
</dd>
<dt><a name="x.509" id="x.509">X.509</a></dt>
<dd>Ein von der International Telecommunication Union (ITU-T) empfohlenes
Schema für Authentifizierungszertifikate. Es wird für
SSL/TLS-Authentifizierungen verwendet.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="certificate" id="certificate">Zertifikat</a></dt>
<dd>Ein Datensatz zur <a class="glossarylink" href="./glossary.html#authentication" title="siehe Glossar">Authentisierung</a> einer
Nertzwerkeinheit wie Server oder Client. Ein Zertifikat
enthält <a class="glossarylink" href="./glossary.html#x.509" title="siehe Glossar">X.509</a>-Informationen
über seinen Eigentümer (das sogenannte Betreff
<span class="transnote">(<em>Anm.d.Ü.:</em> engl.: subject)</span>) und die
signierende <a class="glossarylink" href="./glossary.html#certificationauthority" title="siehe Glossar">Certification
Authority</a> (der sogenannte Aussteller <span class="transnote">(<em>Anm.d.Ü.:</em> engl.:
issuer)</span>) sowie den <a class="glossarylink" href="./glossary.html#publickey" title="siehe Glossar">öffentlichen Schlüssel</a> des
Eigentümers und die Signatur der CA. Netzwerkeinheiten
überprüfen diese Signatur mit Hilfe von CA-Zertifikaten.<br />
Siehe: <a href="ssl/">SSL/TLS-Verschlüsselung</a>
</dd>
<dt><a name="accesscontrol" id="accesscontrol">Zugriffskontrolle</a></dt>
<dd>Die Beschränkung des Zugriffs auf Netzwerkbereiche. Im
Apache-Kontext in der Regel die Zugriffsbeschränkung auf bestimmte
<em>URLs</em>.<br />
Siehe: <a href="howto/auth.html">Authentisierung, Autorisierung und
Zugriffskontrolle</a>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="./de/glossary.html" title="Deutsch"> de </a> |
<a href="./en/glossary.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/glossary.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/glossary.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Kommentare</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/glossary.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/invoking.html.de 0000664 0001751 0001751 00000033644 14744525602 020153 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache starten - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache starten</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="./de/invoking.html" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<p>Unter Windows läuft der Apache üblicherweise als Dienst
(Windows NT, 2000 und XP) oder als Konsolenanwendung (Windows 9x und
ME). Für Einzelheiten lesen Sie bitte <a href="platform/windows.html#winsvc">Apache als Dienst betreiben</a>
und <a href="platform/windows.html#wincons">Apache als Konsolenanwendung betreiben</a>.</p>
<p>Unter Unix wird das <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programm als Daemon
ausgeführt, der im Hintergrund fortlaufend aktiv ist, um
Anfragen zu bearbeiten. Dieses Dokument beschreibt, wie
<code class="program"><a href="./programs/httpd.html">httpd</a></code> aufgerufen wird.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#startup">Wie der Apache startet</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errors">Fehler während des Hochfahrens</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#boot">Beim Bootvorgang starten</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#info">Weitere Informationen</a></li>
</ul><h3>Siehe auch</h3><ul class="seealso"><li><a href="stopping.html">Beenden und Neustarten</a></li><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="#comments_section">Kommentare</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="startup" id="startup">Wie der Apache startet</a></h2>
<p>Wenn die in der Konfigurationsdatei angegebene <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>-Anweisung auf die Voreinstellung
von 80 gesetzt ist (oder einen anderen Port unterhalb von 1024), dann
müssen Sie root-Berechtigung besitzen, um den Apache starten
zu können. Nur dann kann er sich an diesen privilegierten
Port binden. Sobald der Server gestartet ist und einige vorbereitende
Aktionen wie das Öffnen seiner Log-Dateien ausgeführt hat,
startet er mehrere <em>Kind</em>-Prozesse, welche die Arbeit erledigen:
das Lauschen auf und Beantworten von Anfragen von Clients. Der
Haupt-<code>httpd</code>-Prozess läuft unter dem Benutzer root
weiter, die Kind-Prozesse jedoch werden unter weniger privilegierten
Benutzerkennungen ausgeführt. Dies wird von dem ausgewählten
<a href="mpm.html">Multi-Processing-Modul</a> gesteuert.</p>
<p>Die Verwendung des Steuerskripts <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> ist die
empfohlene Methode, das <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programm zu starten.
Dieses Skript setzt verschiedene Umgebungsvariablen, die für die
korrekte Funktion von <code class="program"><a href="./programs/httpd.html">httpd</a></code> unter einigen
Betriebssystemen notwendig sind, und startet dann das
<code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programm. <code class="program"><a href="./programs/apachectl.html">apachectl</a></code>
reicht alle Kommandozeilenargumente durch, so dass alle
<code class="program"><a href="./programs/httpd.html">httpd</a></code>-Optionen auch mit <code class="program"><a href="./programs/apachectl.html">apachectl</a></code>
verwendet werden können. Um den korrekten Ablageort des
<code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programms sowie einige Kommandozeilenargumente
anzugeben, die Sie <em>immer</em> verwenden möchten, können
Sie auch das Skript <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> direkt editieren und die
Variable <code>HTTPD</code> am Anfang ändern.</p>
<p>Das Erste was <code>httpd</code> macht, wenn es startet, ist das
Suchen und Einlesen der <a href="configuring.html">Konfigurationsdatei</a> <code>httpd.conf</code>.
Der Ablageort dieser Datei wird zur Kompilierungszeit festgelegt. Es ist
aber möglich, den Ablageort zur Laufzeit anzugeben, indem die
Kommandozeilenoption <code>-f</code> wie folgt verwendet wird:</p>
<div class="example"><p><code>/usr/local/apache2/bin/apachectl -f
/usr/local/apache2/conf/httpd.conf</code></p></div>
<p>Wenn während des Starts alles gutgeht, trennt sich der Server
vom Terminal ab und die Eingabeaufforderung erscheint gleich darauf
wieder. Dies zeigt an, dass der Server hochgefahren ist und läuft.
Sie können nun Ihren Browser benutzen, um Verbindung zum Server
aufzunehmen und sich die Testseite im <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>-Verzeichnis anzusehen wie auch
die lokale Kopie der Dokumentation, die von dieser Seite aus verlinkt
ist.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errors" id="errors">Fehler während des Hochfahrens</a></h2>
<p>Wenn der Apache während des Hochfahrens einen schweren Fehler
feststellt, schreibt er entweder eine Nachricht, die das Problem
näher schildert, auf die Konsole oder ins <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code>, bevor er sich selbst beendet.
Eine der häufigsten Fehlermeldungen ist "<code>Unable
to bind to Port ...</code>" <span class="transnote">(<em>Anm.d.Ü.:</em> "Kann nicht an Port ...
binden")</span>. Diese Meldung wird üblicherweise verursacht:</p>
<ul>
<li>entweder durch den Versuch, den Server an einem privilegierten
Port zu starten, während man nicht als Benutzer root angemeldet
ist,</li>
<li>oder durch den Versuch, den Server zu starten, wenn bereits eine
andere Instanz des Apache oder ein anderer Webserver an den gleichen
Port gebunden ist.</li>
</ul>
<p>Für weitere Anleitungen zur Fehlerbehebung lesen Sie bitte die
Apache-<a href="faq/">FAQ</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="boot" id="boot">Beim Bootvorgang starten</a></h2>
<p>Wenn Sie möchten, dass Ihr Server direkt nach einem
System-Neustart weiterläuft, sollten Sie einen Aufruf von
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> zu den Startdateien Ihres Systems
hinzufügen (üblicherweise <code>rc.local</code> oder
eine Datei in einem <code>rc.N</code>-Verzeichnis). Dies startet
den Apache als root. Stellen Sie zuvor jedoch sicher, dass Ihr
Server hinsichtlich Sicherheit und Zugriffsbeschränkungen
richtig konfiguriert ist.</p>
<p>Das <code class="program"><a href="./programs/apachectl.html">apachectl</a></code>-Skript ist dafür ausgelegt, wie
ein Standard-SysV-init-Skript zu arbeiten. Es akzeptiert die Argumente
<code>start</code>, <code>restart</code> und <code>stop</code>
und übersetzt sie in die entsprechenden Signale für
<code class="program"><a href="./programs/httpd.html">httpd</a></code>. Daher können Sie oftmals
einfach <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> in das entsprechende init-Verzeichnis
linken. Überprüfen Sie bitte auf jeden Fall die genauen
Anforderungen Ihres Systems.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="info" id="info">Weitere Informationen</a></h2>
<p>Weitere Informationen über Kommandozeilenoptionen von <code class="program"><a href="./programs/httpd.html">httpd</a></code> und <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> sowie anderen
Hilfsprogrammen, die dem Server beigefügt sind, sind auf der
Seite <a href="programs/">Server und Hilfsprogramme</a>
verfügbar. Es existiert außerdem eine Dokumentation
aller in der Apache-Distribution enthaltenen <a href="mod/">Module</a> und der von ihnen bereitgestellten
<a href="mod/directives.html">Direktiven</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="./de/invoking.html" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Kommentare</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/invoking.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/ 0000775 0001751 0001751 00000000000 15032766627 015646 5 ustar covener covener httpd-2.4.64/docs/manual/ssl/index.html.tr.utf8 0000664 0001751 0001751 00000012156 14743132254 021150 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache SSL/TLS Şifrelemesi - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache SSL/TLS Şifrelemesi</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/ssl/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../tr/ssl/" title="Türkçe"> tr </a> |
<a href="../zh-cn/ssl/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Apache HTTP Sunucusunun <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> modülü, Güvenli Soketler
Katmanı (SSL) ve Aktarım Katmanı Güvenliği (TLS) protokollerinin
kullanıldığı Sağlam Şifreleme desteğini sağlayan <a href="http://www.openssl.org/">OpenSSL</a> kütüphanesine bir arayüz
içerir.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#documentation">Belgeler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mod-ssl"><code>mod_ssl</code> Modülü</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="documentation" id="documentation">Belgeler</a></h2>
<ul>
<li><a href="ssl_howto.html">mod_ssl Yapılandırması Nasıl</a></li>
<li><a href="ssl_intro.html">SSL'ye Giriş</a></li>
<li><a href="ssl_compat.html">Uyumluluk</a></li>
<li><a href="ssl_faq.html">Sıkça Sorulan Sorular</a></li>
<li><a href="../glossary.html">Terimler</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="mod-ssl" id="mod-ssl"><code>mod_ssl</code> Modülü</a></h2>
<p>Bu modülce sağlanan yönergeler ve ortam değişkenleri
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> başvuru kılavuzunda ayrıntılı olarak
açıklanmıştır.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/ssl/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../tr/ssl/" title="Türkçe"> tr </a> |
<a href="../zh-cn/ssl/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/index.html.ja.utf8 0000664 0001751 0001751 00000012274 14743132254 021116 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache の SSL/TLS 暗号化 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Apache の SSL/TLS 暗号化</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/ssl/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/" title="Japanese"> ja </a> |
<a href="../tr/ssl/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/ssl/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Apache HTTP サーバモジュール <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> が
<a href="http://www.openssl.org/">OpenSSL</a>
ライブラリへのインターフェースを提供していますが、これは
Secure Sockts Layer と Transport Layer Security
プロトコルを用いた強力な暗号化を提供します。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#documentation">Documentation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mod-ssl">mod_ssl</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="documentation" id="documentation">Documentation</a></h2>
<ul>
<li><a href="ssl_howto.html">mod_ssl Configuration How-To</a></li>
<li><a href="ssl_intro.html">Introduction To SSL</a></li>
<li><a href="ssl_compat.html">互換性</a></li>
<li><a href="ssl_faq.html">よくある質問</a></li>
<li><a href="../glossary.html">用語</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="mod-ssl" id="mod-ssl">mod_ssl</a></h2>
<p>このモジュールで提供されるディレクティブや環境変数に関する
詳しい文書は、<a href="../mod/mod_ssl.html">mod_ssl
リファレンス</a>をご覧下さい。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/ssl/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/" title="Japanese"> ja </a> |
<a href="../tr/ssl/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/ssl/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/index.html.fr.utf8 0000664 0001751 0001751 00000012166 14740503670 021134 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache et le Chiffrement SSL/TLS - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache et le Chiffrement SSL/TLS</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/ssl/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/" title="Français"> fr </a> |
<a href="../ja/ssl/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../tr/ssl/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/ssl/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Le module <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> du serveur HTTP Apache fournit une
interface avec la bibliothèque <a href="http://www.openssl.org/">OpenSSL</a>, qui permet d'effectuer un
chiffrement fort en s'appuyant sur les protocoles "Couche Points d'accès
Sécurisés" (Secure Sockets Layer - SSL) et "Sécurité de la Couche Transport"
(Transport Layer Security - TLS).</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#documentation">Documentation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mod-ssl">mod_ssl</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="documentation" id="documentation">Documentation</a></h2>
<ul>
<li><a href="ssl_howto.html">Comment configurer SSL ?</a></li>
<li><a href="ssl_intro.html">Introduction à SSL</a></li>
<li><a href="ssl_compat.html">Compatibilité</a></li>
<li><a href="ssl_faq.html">Foire aux questions</a></li>
<li><a href="../glossary.html">Glossaire</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="mod-ssl" id="mod-ssl">mod_ssl</a></h2>
<p>La documentation complète sur les directives et les variables
d'environnement fournies par ce module se trouve dans la
<a href="../mod/mod_ssl.html">documentation de référence de mod_ssl</a>.
</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/ssl/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/" title="Français"> fr </a> |
<a href="../ja/ssl/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../tr/ssl/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/ssl/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/ssl_intro.html.fr.utf8 0000664 0001751 0001751 00000117147 14740503670 022046 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Chiffrement SSL/TLS fort : Introduction - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">SSL/TLS</a></div><div id="page-content"><div id="preamble"><h1>Chiffrement SSL/TLS fort : Introduction</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/ssl/ssl_intro.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/ssl_intro.html" title="Français"> fr </a> |
<a href="../ja/ssl/ssl_intro.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div>
<p>Ce chapitre en guise d'introduction est destiné aux lecteurs pour lesquels
le Web, HTTP et Apache sont familiers, mais ne sont pas des experts en matière
de sécurité. Il n'a pas la prétention d'être un guide détaillé sur le
protocole SSL, il ne traitera pas non plus des techniques spécifiques de gestion
des certificats dans une organisation, ni des importants problèmes légaux de
brevets ou des restrictions d'importation ou d'exportation. Il se veut plutôt
une base de travail pour les utilisateurs de <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> en
rassemblant différents concepts, définitions et exemples comme point de départ
pour une exploration plus détaillée.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#cryptographictech">Techniques de chiffrement</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#certificates">Certificats</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ssl">Couche Points d'Accès Sécurisés - Secure Sockets Layer (SSL)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#references">Références</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="cryptographictech" id="cryptographictech">Techniques de chiffrement</a></h2>
<p>La maîtrise de SSL nécessite la compréhension des algorithmes de
chiffrement, des fonctions relatives aux empreintes de messages (comme les
fonctions de type hash ou non réversibles), et des signatures numériques. Ces
techniques pourraient faire l'objet d'un ouvrage à elles seules (voir par
exemple [<a href="#AC96">AC96</a>]) et constituent les bases de la
confidentialité, de l'intégrité et de l'authentification.</p>
<h3><a name="cryptographicalgo" id="cryptographicalgo">Algorithmes de chiffrement</a></h3>
<p>Supposons qu'Alice veuille envoyer un message à sa banque pour
transférer une certaine somme. Alice souhaiterait que le message soit
privé, car il contient des informations comme son numéro de compte et le
montant du transfert. Une solution consisterait à utiliser un algorithme de
chiffrement, technique qui permet de remplacer un message par sa version
chiffrée, illisible jusqu'à ce qu'elle soit déchiffrée.
Sous sa forme chiffrée,
le message ne peut être déchiffré qu'en utilisant une clé secrète. Sans la
clé, le message est inutilisable : les bons algorithmes de chiffrement
rendent si difficile la restitution du texte original par des intrus que
ceux-ci y gaspilleraient leurs efforts.</p>
<p>Il existe deux catégories d'algorithmes de chiffrement : conventionnel
ou à clé publique.</p>
<dl>
<dt>Chiffrement conventionnel</dt>
<dd>aussi connu sous le nom de chiffrement symétrique, il nécessite le
partage d'une clé entre l'expéditeur et le destinataire : une portion
d'information secrète permettant de chiffrer et déchiffrer un message.
Tant que cette clé reste secrète, personne à part l'expéditeur et le
destinataire ne peut lire le message. Si Alice et sa banque partagent une
clé secrète, ils peuvent donc s'envoyer l'un à l'autre des messages privés.
Le fait de partager une clé entre l'expéditeur et le destinataire avant
de communiquer, tout en la maintenant secrète vis à vis des autres, peut
toutefois poser des problèmes.</dd>
<dt>Chiffrement à clé publique</dt>
<dd>aussi connu sous le nom de chiffrement asymétrique, il résoud le
problème d'échange de clé en définissant un algorithme qui utilise deux
clés, chacune d'entre elles pouvant être utilisée pour chiffrer un message.
Si une des clés a été utilisée pour chiffrer le message, on doit utiliser
l'autre clé pour le déchiffrer. Il est ainsi possible de recevoir des
messages sécurisés simplement en rendant publique une des clés (la clé
publique), et en gardant l'autre clé secrète (la clé privée).</dd>
</dl>
<p>Tout le monde peut chiffrer un message en utilisant la clé publique,
mais seul le propriétaire de la clé privée sera en mesure de le lire. De
cette façon, Alice peut envoyer des messages privés au propriétaire d'une
paire de clés (sa banque), en les chiffrant à l'aide de la clé publique.
Seule la banque sera en mesure de les déchiffrer.</p>
<h3><a name="messagedigests" id="messagedigests">Empreinte d'un message</a></h3>
<p>Bien qu'Alice puisse chiffrer son message pour le rendre privé, il
subsiste toujours le risque que quelqu'un puisse modifier le message
original ou le remplacer par un autre, afin d'effectuer le transfert de
fonds à son profit, par exemple. Une solution pour garantir l'intégrité du
message consisterait pour Alice à créer un résumé concentré de son message
qu'elle enverrait à sa banque avec ce dernier. A la réception du message,
la banque crée son propre résumé et le compare avec celui qu'Alice a
envoyé. Si les deux résumés sont identiques, le message reçu n'a pas
été modifié.</p>
<p>Un résumé tel que celui-ci est appelé
<dfn>empreinte numérique de message</dfn> (message digest),
<em>fonction irréversible</em> (one-way function) ou
<em>fonction de hashage</em> (hash function). Une empreinte de message
constitue une représentation courte et de longueur fixe, d'un message plus
long et de longueur variable. Les algorithmes de création d'empreintes sont
conçus pour produire une empreinte unique pour chaque message. Les
empreintes de messages sont conçues pour que la restitution du message
à partir de l'empreinte soit d'une difficulté insurmontable, et qu'il soit
(en théorie) impossible de trouver deux messages différents qui produisent
la même empreinte -- ce qui élimine la possibilité de remplacer un message
par un autre en conservant la même empreinte.</p>
<p>Trouver le moyen d'envoyer l'empreinte de manière sécurisée à la banque
constitue un autre défit auquel Alice doit faire face ; si l'empreinte
n'est pas envoyée de manière sécurisée, son intégrité peut être compromise,
et avec elle, la possibilité pour la banque de vérifier l'intégrité du
message original. L'intégrité du message ne peut être vérifiée que si
l'empreinte qui lui est associée est envoyée de manière sécurisée.</p>
<p>Une solution pour envoyer l'empreinte de manière sécurisée consiste à
l'inclure dans une signature numérique.</p>
<h3><a name="digitalsignatures" id="digitalsignatures">Signatures numériques</a></h3>
<p>Quand Alice envoie un message à sa banque, cette dernière doit s'assurer
que le message a bien été envoyé par elle, pour éviter qu'un intrus puisse
effectuer une transaction sur son compte. Une <em>signature numérique</em>,
créée par Alice et incluse dans le message, permet d'atteindre cet
objectif.</p>
<p>Les signatures numériques peuvent être créées en chiffrant une empreinte de
message, ainsi que d'autres informations (comme un numéro d'ordre) avec la clé
privée de l'expéditeur. Bien que tout le monde puisse <em>déchiffrer</em> la
signature à l'aide de la clé publique, seul l'expéditeur connait la clé privée.
Ce qui implique que seul l'expéditeur peut avoir signé le message. Inclure
l'empreinte dans la signature entraîne que cette dernière n'est valable que
pour ce message ; ceci assure aussi l'intégrité du message car personne ne
peut modifier l'empreinte et ensuite signer le message.</p>
<p>Afin de se prémunir contre l'interception et la réutilisation de la
signature par un intrus quelques jours plus tard, la signature contient un
numéro d'ordre unique. Ceci protège la banque contre une plainte frauduleuse
de la part d'Alice alléguant qu'elle n'a pas envoyé le message --
elle seule peut l'avoir signé (non-répudiation).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="certificates" id="certificates">Certificats</a></h2>
<p>Bien qu'Alice soit parvenue à envoyer un message privé à sa banque, après
l'avoir signé et avoir ainsi assuré l'intégrité du message, elle doit encore vérifier
qu'elle communique réellement avec la banque. C'est à dire qu'elle doit
s'assurer que la clé publique qu'elle utilise appartient bien à la paire de
clés de la banque, et non à celle d'un intrus.
De même, la banque doit vérifier que la
signature du message a bien été construite avec la clé privée d'Alice.</p>
<p>Si chaque partie possède un certificat qui valide l'identité de l'autre,
confirme la clé publique, et est signé par un organisme de confiance, alors
les deux protagonistes peuvent être sûrs que la personne avec laquelle ils
communiquent est bien celle avec laquelle ils désirent le faire. Un tel
organisme de confiance s'appelle une <em>Autorité de Certification</em>, et
on utilise les certificats à des fins d'authentification.</p>
<h3><a name="certificatecontents" id="certificatecontents">Contenu d'un certificat</a></h3>
<p>Un certificat associe une clé publique avec l'identité réelle d'un
individu, d'un serveur, ou d'une autre entité plus connue sous le nom de
sujet. Comme on le voit dans le <a href="#table1">Tableau 1</a>, les
information concernant le sujet comprennent des informations
d'identification (le nom distinctif ou distinguished name - dn), ainsi que
la clé publique. Il comporte aussi l'identification et la signature de
l'autorité de certification qui a délivré le certificat, ainsi que la
période de validité de ce dernier. Il peut aussi contenir des informations
supplémentaires (ou extensions) telles que des informations de gestion
destinées à l'autorité de certification, comme un numéro de série.</p>
<h4><a name="table1" id="table1">Tableau 1: Information contenues dans un certificat</a></h4>
<table>
<tr><th>Sujet</th>
<td>Nom distinctif, Clé publique</td></tr>
<tr><th>Fournisseur</th>
<td>Nom distinctif, Signature</td></tr>
<tr><th>Période de validité</th>
<td>Pas avant, Pas après</td></tr>
<tr><th>Informations de gestion</th>
<td>Version, Numéro de série</td></tr>
<tr><th>Extensions</th>
<td>Contraintes de base, Drapeaux Netscape, etc.</td></tr>
</table>
<p>Un nom distinctif sert à fournir une identité dans un contexte
spécifique -- par exemple, un individu peut posséder un certificat
personnel, et aussi un certificat en tant qu'employé. Les noms distinctifs
doivent respecter le standard X509 [<a href="#X509">X509</a>], qui définit
les champs, les noms de champs, et les abréviations utilisées pour faire
référence aux champs (voir <a href="#table2">Tableau 2</a>).</p>
<h4><a name="table2" id="table2">Tableau 2: Informations contenues dans le nom distinctif</a></h4>
<table class="bordered">
<tr><th>Champ du DN</th>
<th>Abrév.</th>
<th>Description</th>
<th>Exemple</th></tr>
<tr><td>Nom complet (Common Name)</td>
<td>CN</td>
<td>Nom certifié</td>
<td>CN=Joe Average</td></tr>
<tr><td>Organisation or Entreprise</td>
<td>O</td>
<td>Nom est associé à cette<br />organisation</td>
<td>O=Snake Oil, Ltd.</td></tr>
<tr><td>Unité organisationnelle (Organizational Unit)</td>
<td>OU</td>
<td>Nom est associé avec cette <br />unité organisationnelle,
par exemple un département</td>
<td>OU=Research Institute</td></tr>
<tr><td>Ville/Localisation</td>
<td>L</td>
<td>Nom est localisé dans cette ville</td>
<td>L=Snake City</td></tr>
<tr><td>Etat/Province</td>
<td>ST</td>
<td>Nom est localisé dans cet état/province</td>
<td>ST=Desert</td></tr>
<tr><td>Pays</td>
<td>C</td>
<td>Nom est localisé dans ce pays (code ISO)</td>
<td>C=XZ</td></tr>
</table>
<p>Une autorité de certification peut définir une contrainte spécifiant
quels champs du nom distinctif sont optionnels et lesquels sont
obligatoires. Elle peut aussi imposer des contraintes sur le contenu des
champs, ce que peuvent aussi faire les utilisateurs de certificats. Par
exemple, un navigateur Netscape peut exiger, dans le cas d'un certificat
de serveur, que le nom complet (Common Name) corresponde à un nom générique
contenant le nom de domaine du serveur, comme
<code>*.snakeoil.com</code>.</p>
<p>Le format binaire d'un certificat est défini en utilisant la
notation ASN.1 [<a href="#ASN1">ASN1</a>] [<a href="#PKCS">PKCS</a>].
Cette notation definit la manière de spécifier les contenus, et les règles
d'encodage définissent la manière dont ces information sont converties au
format binaire. L'encodage binaire du certificat est défini par les Règles
d'Encodage Distinctives (Distinguished Encoding Rules - DER), qui se basent
d'une manière plus générale sur les Règles d'Encodage de Base (Basic
Encoding Rules - BER). Pour les transmissions qui ne supportent pas le
format binaire, ce dernier peut être converti au format ASCII en utilisant
le codage Base64 [<a href="#MIME">MIME</a>]. Lorsqu'il est placé entre des
délimiteurs de début et de fin (comme ci-dessous), on dit que le certificat
est encodé au format PEM ("Privacy Enhanced Mail").</p>
<div class="example"><h3>Exemple de certificat encodé au format PEM (snakeoil.crt)</h3><pre>-----BEGIN CERTIFICATE-----
MIIC7jCCAlegAwIBAgIBATANBgkqhkiG9w0BAQQFADCBqTELMAkGA1UEBhMCWFkx
FTATBgNVBAgTDFNuYWtlIERlc2VydDETMBEGA1UEBxMKU25ha2UgVG93bjEXMBUG
A1UEChMOU25ha2UgT2lsLCBMdGQxHjAcBgNVBAsTFUNlcnRpZmljYXRlIEF1dGhv
cml0eTEVMBMGA1UEAxMMU25ha2UgT2lsIENBMR4wHAYJKoZIhvcNAQkBFg9jYUBz
bmFrZW9pbC5kb20wHhcNOTgxMDIxMDg1ODM2WhcNOTkxMDIxMDg1ODM2WjCBpzEL
MAkGA1UEBhMCWFkxFTATBgNVBAgTDFNuYWtlIERlc2VydDETMBEGA1UEBxMKU25h
a2UgVG93bjEXMBUGA1UEChMOU25ha2UgT2lsLCBMdGQxFzAVBgNVBAsTDldlYnNl
cnZlciBUZWFtMRkwFwYDVQQDExB3d3cuc25ha2VvaWwuZG9tMR8wHQYJKoZIhvcN
AQkBFhB3d3dAc25ha2VvaWwuZG9tMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKB
gQDH9Ge/s2zcH+da+rPTx/DPRp3xGjHZ4GG6pCmvADIEtBtKBFAcZ64n+Dy7Np8b
vKR+yy5DGQiijsH1D/j8HlGE+q4TZ8OFk7BNBFazHxFbYI4OKMiCxdKzdif1yfaa
lWoANFlAzlSdbxeGVHoT0K+gT5w3UxwZKv2DLbCTzLZyPwIDAQABoyYwJDAPBgNV
HRMECDAGAQH/AgEAMBEGCWCGSAGG+EIBAQQEAwIAQDANBgkqhkiG9w0BAQQFAAOB
gQAZUIHAL4D09oE6Lv2k56Gp38OBDuILvwLg1v1KL8mQR+KFjghCrtpqaztZqcDt
2q2QoyulCgSzHbEGmi0EsdkPfg6mp0penssIFePYNI+/8u9HT4LuKMJX15hxBam7
dUHzICxBVC1lnHyYGjDuAMhe396lYAn8bCld1/L4NMGBCQ==
-----END CERTIFICATE-----</pre></div>
<h3><a name="certificateauthorities" id="certificateauthorities">Autorités de certification</a></h3>
<p>En vérifiant les informations contenues dans une demande de certificat
avant de l'accorder, l'autorité de certification s'assure de l'identité du
propriétaire de la clé privée issue de sa paire de clés. Par exemple, Si
Alice demande un certificat personnel, l'autorité de certification doit
d'abord s'assurer qu'elle correspond vraiment à la personne à laquelle
la demande de certificat fait référence.</p>
<h4><a name="certificatechains" id="certificatechains">Chaînes de certification</a></h4>
<p>Une autorité de certification peut aussi émettre un certificat à
destination d'une
autre autorité de certification. Pour vérifier un certificat, Alice
peut être amenée à vérifier le certificat de l'émetteur pour chaque
autorité de certification parente, jusqu'à ce qu'elle en atteigne une
en qui elle a confiance. Elle peut aussi ne faire confiance qu'aux
certificats faisant l'objet d'une chaîne limitée d'émetteurs, afin
de réduire le risque de rencontrer un "mauvais" certificat dans la
chaîne.</p>
<h4><a name="rootlevelca" id="rootlevelca">Création d'une autorité de certification racine</a></h4>
<p>Comme indiqué plus haut, chaque certificat nécessite la validation
de l'identité du sujet par un émetteur de certificats
de niveau supérieur, et ceci en
remontant jusqu'à l'Autorité de Certification (CA) racine. Ceci pose un
problème : qui va se porter garant du certificat de l'autorité racine
qui ne possède pas d'émetteur de certificat ? C'est uniquement dans ce
cas que le certificat est auto-signé, l'émetteur du certificat et son
sujet étant confondus. Les navigateurs sont préconfigurés avec une
liste d'autorités de certification de confiance, mais il est important
d'être extrèmement prudent avant de faire confiance à un certificat
auto-signé. La large publication d'une clé publique par l'autorité
racine réduit cependant les risques encourus
en faisant confiance à cette clé --
si quelqu'un publiait une clé en se faisant passer pour l'autorité, il
serait vite démasqué.</p>
<p>Quelques compagnies, comme <a href="http://www.thawte.com/">Thawte</a> et <a href="http://www.verisign.com/">VeriSign</a>,
se sont proclamées elles-mêmes Autorités de Certification. Ces
compagnies proposent les services suivant :</p>
<ul>
<li>Vérification des demandes de certificats</li>
<li>Traitement des demandes de certificats</li>
<li>Emission et gestion des certificats</li>
</ul>
<p>Vous pouvez aussi créer votre propre autorité de certification. Bien
que risqué dans l'environnement de l'Internet, ceci peut s'avérer utile
dans un Intranet, où l'organisme peut vérifier facilement les identités
des individus et des serveurs.</p>
<h4><a name="certificatemanagement" id="certificatemanagement">Gestion des certificats</a></h4>
<p>Constituer une autorité de certification représente une
responsabilité qui nécessite une solide infrastructure administrative,
technique et gestionnaire. Les autorités de certification ne se
contentent pas d'émettre des certificats, elles doivent aussi les gérer
-- à savoir elles déterminent leur durée de validité, elles les
renouvellent, et elles maintiennent des listes de certificats qui ont
été émis dans le passé mais ne sont plus valides (Listes de révocations
de certificats, ou CRLs).</p>
<p>Par exemple, si Alice est titulaire d'un certificat en tant
qu'employée d'une compagnie, mais vient de quitter cette compagnie,
son certificat doit être révoqué. Comme les certificats ne sont émis
qu'après vérification de l'identité du sujet, et peuvent être envoyés
à tous ceux avec lesquels le sujet peut communiquer, il est impossible
de discerner à partir du seul certificat s'il a été révoqué. Pour
vérifier la validité d'un certificat, il est donc nécessaire de
contacter l'autorité de certification qui l'a émis afin de pouvoir
consulter ses listes de révocations de certificats -- ce qui n'est
en général pas une partie automatique du processus.</p>
<div class="note"><h3>Note</h3>
<p>Si votre autorité de certification ne fait pas partie de la liste
des autorités de confiance de votre navigateur, il faut enregistrer le
certificat de l'autorité de certification dans ce dernier, ce qui lui
permettra de valider les certificats de serveurs signés par cette
autorité de certification. Ceci peut être dangereux, car une fois le
certificat enregistré, le navigateur acceptera tous les certificats
signés par cette autorité de certification.</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="ssl" id="ssl">Couche Points d'Accès Sécurisés - Secure Sockets Layer (SSL)</a></h2>
<p>Le protocole Couche Points d'Accès Sécurisés est une couche protocolaire
qui pourrait s'intercaler entre un protocole d'une couche réseau orientée
connexion (comme TCP/IP) et une couche protocolaire d'application (comme HTTP).
SSL fournit une communication sécurisée entre client et serveur en permettant
l'authentification mutuelle, l'utilisation des signatures numériques pour la
vérification de l'intégrité des données, et le chiffrement pour la
confidentialité.</p>
<p>Ce protocole est conçu pour supporter un grand choix d'algorithmes
spécifiques utilisés pour la cryptographie, les empreintes et les signatures.
Ceci permet la sélection d'un algorithme pour des serveurs spécifiques en
respectant la légalité, les règles d'exportation ou autres contraintes, et
permet aussi au protocole de tirer parti des nouveaux algorithmes. Ces choix
font l'objet d'une négociation entre client et serveur lors de
l'établissement de la session protocolaire.</p>
<h3><a name="table4" id="table4">Tableau 4: Versions du protocole SSL</a></h3>
<table class="bordered">
<tr><th>Version</th>
<th>Source</th>
<th>Description</th>
</tr>
<tr><td>SSL v2.0</td>
<td>Standard du fournisseur (de Netscape Corp.)</td>
<td>Premier protocole SSL pour lequel il existe des implémentations</td>
</tr>
<tr><td>SSL v3.0</td>
<td>Projet Internet arrivé à expiration (de Netscape Corp.) [<a href="#SSL3">SSL3</a>]</td>
<td>Comporte des révisions permettant de prévenir certaines attaques de
sécurité spécifiques, ajout de chiffrements non RSA, et support des
chaînes de certification</td>
</tr>
<tr><td>TLS v1.0</td>
<td>Standard proposé pour l'Internet (de l'IETF) [<a href="#TLS1">TLS1</a>]</td>
<td>Révision de SSL 3.0 pour mettre à jour la couche MAC vers HMAC,
ajout du bourrage de bloc pour le chiffrement de bloc, standardisation
de l'ordonnancement des messages et plus de messages d'alerte.</td>
</tr>
<tr><td>TLS v1.1</td>
<td>Standard proposé pour l'Internet (de l'IETF) [<a href="#TLS11">TLS11</a>]</td>
<td>Mise à jour de TLS 1.0 pour la protection contre les
attaques de type Cipher block chaining (CBC).</td>
</tr>
<tr><td>TLS v1.2</td>
<td>Standard proposé pour l'Internet (de l'IETF) [<a href="#TLS12">TLS12</a>]</td>
<td>Mise à jour de TLS 1.1 rendant les condensés MD5 obsolètes,
et introduisant une incompatibilité avec SSL ce qui interdit toute
négociation en vue d'une utilisation de SSLv2.</td>
</tr>
</table>
<p>Il existe plusieurs versions du protocole SSL, comme le montre le
<a href="#table4">Tableau 4</a>. Comme indiqué dans ce dernier, un des apports
de SSL 3.0 est le support du chargement des chaînes de certification. Cette
fonctionnalité permet à un serveur de passer au navigateur un certificat de
serveur accompagné du certificat de l'émetteur. Le chargement de la
chaîne permet aussi au navigateur de valider le certificat du serveur, même si
les certificats de l'autorité de certification ne sont pas installés pour les
émetteurs intermédiaires, car ils sont inclus dans la chaîne de certification.
SSL 3.0 sert de base au standard du protocole Sécurité de la Couche Transport
ou Transport Layer Security
[<a href="#TLS1">TLS</a>], actuellement en développement au sein de
l'Internet Engineering Task Force (IETF).</p>
<h3><a name="session" id="session">Etablissement d'une session</a></h3>
<p>La session SSL est établie en suivant une séquence d'échanges
d'informations entre client et serveur, comme le montre la
<a href="#figure1">Figure 1</a>. Cette séquence peut varier, selon que
le serveur est configuré pour fournir un certificat de serveur ou
réclame un certificat client. Bien que dans certains cas, des étapes
d'échanges d'informations supplémentaires soient nécessaires pour la
gestion des informations de chiffrement, cet article résume un scénario
courant. Se reporter aux spécifications SSL pour avoir la liste de
toutes les possibilités.</p>
<div class="note"><h3>Note</h3>
<p>Une fois la session SSL établie, elle peut être réutilisée. Ceci
permet d'éviter la perte de performances due à la répétition des nombreuses
étapes nécessaires à l'établissement d'une session. Pour parvenir à ceci,
le serveur assigne un identifiant de session unique à chaque session SSL ;
cet identifiant est mis en cache dans le serveur et le client peut
l'utiliser pour des connexions ultérieures afin de réduire la durée des
échanges d'informations (et ceci jusqu'à ce que l'identifiant de session
arrive à expiration dans le cache du serveur).</p>
</div>
<p class="figure">
<img src="../images/ssl_intro_fig1.gif" alt="" width="423" height="327" /><br />
<a id="figure1" name="figure1"><dfn>Figure 1</dfn></a> : Séquence
simplifiée d'échanges d'informations SSL</p>
<p>Les éléments de la séquence d'échanges d'informations, tels qu'ils
sont utilisés par le client et le serveur, sont énumérés ci-après :</p>
<ol>
<li>Négociation de la suite de chiffrement à utiliser durant le transfert des données</li>
<li>Elaboration et échange d'une clé de session entre le client et le serveur</li>
<li>Authentification éventuelle du serveur par le client</li>
<li>Authentification éventuelle du client par le serveur</li>
</ol>
<p>La première étape, la négociation de la suite de chiffrement, permet au
client et au serveur de choisir une suite de chiffrement qu'ils supportent
tous les deux. La spécification du protocole SSL 3.0 définit 31 suites de
chiffrement. Une suite de chiffrement se compose des éléments
suivants :</p>
<ul>
<li>Méthode d'échange de la clé</li>
<li>Chiffrement du transfert des données</li>
<li>Empreinte du message servant à créer le code d'authentification du
message (MAC)</li>
</ul>
<p>Ces trois éléments sont décrits dans les sections suivantes.</p>
<h3><a name="keyexchange" id="keyexchange">Méthode d'échange de la clé</a></h3>
<p>La méthode d'échange de la clé définit la manière
dont la clé de chiffrement
symétrique secrète et partagée utilisée pour le transfert des données de
l'application sera acceptée par le client et le serveur. SSL 2.0 utilise
l'échange de clé RSA seulement, tandis que SSL 3.0 supporte tout un choix
d'algorithmes d'échange de clé incluant l'échange de clé RSA (quand les
certificats sont utilisés), et l'échange de clés Diffie-Hellman (pour
échanger des clés sans certificat, ou en l'absence de communication
préalable entre le client et le serveur).</p>
<p>Les signatures numériques constituent une variante dans le choix des
méthodes d'échange de clé -- utiliser les signatures ou pas, et dans
l'affirmative, quel genre de signatures utiliser. La signature à l'aide
d'une clé privée fournit une protection contre une attaque
"man-in-the-middle" au cours de laquelle
l'échange d'informations destiné à générer la
clé partagée peut être intercepté [<a href="#AC96">AC96</a>, p516].</p>
<h3><a name="ciphertransfer" id="ciphertransfer">Chiffrement du transfert de données</a></h3>
<p>Comme décrit plus haut, SSL utilise le chiffrement symétrique
conventionnel pour chiffrer les messages au cours d'une session. Il existe
neuf choix possibles pour le chiffrement, y compris l'option du transfert
non chiffré :</p>
<ul>
<li>Pas de chiffrement</li>
<li>Chiffrement en continu (Stream Ciphers)
<ul>
<li>RC4 avec clés de 40 bits</li>
<li>RC4 avec clés de 128 bits</li>
</ul></li>
<li>Chiffrement par blocs CBC (CBC Block Ciphers)
<ul><li>RC2 avec clé de 40 bits</li>
<li>DES avec clé de 40 bits</li>
<li>DES avec clé de 56 bits</li>
<li>Triple-DES avec clé de 168 bits</li>
<li>Idea (clé de 128 bits)</li>
<li>Fortezza (clé de 96 bits)</li>
</ul></li>
</ul>
<p>"CBC" signifie Cipher Block Chaining (Chaînage de blocs chiffrés),
c'est à dire qu'une portion du bloc de texte chiffré précédent est utilisée
pour le chiffrement du bloc courant. "DES" signifie Data Encryption
Standard (Standard de Chiffrement des Données)
[<a href="#AC96">AC96</a>, ch12], et possède de nombreuses variantes
(telles que DES40 et 3DES_EDE). Parmi les algorithmes disponibles, "Idea"
est actuellement un des meilleurs et des plus puissants sur le plan
cryptographique, et "RC2" est un algorithme propriétaire de RSA DSI
[<a href="#AC96">AC96</a>, ch13].</p>
<h3><a name="digestfunction" id="digestfunction">Fonction de création d'empreinte</a></h3>
<p>Le choix d'une fonction de création d'empreinte détermine la manière
dont une empreinte est créée à partir d'une unité de données. SSL supporte
les fonctions suivantes :</p>
<ul>
<li>Pas d'empreinte (choix Null)</li>
<li>MD5, une empreinte de 128 bits</li>
<li>Algorithme d'Empreinte Sécurisée (Secure Hash Algorithm - SHA-1), une
empreinte de 160 bits</li>
</ul>
<p>On utilise l'empreinte de message pour créer un Code d'Authentification
de Message (Message Authentication Code - MAC) qui est chiffré avec le
message afin de vérifier son intégrité et de se protéger contre les
attaques de type "rejeu".</p>
<h3><a name="handshake" id="handshake">Protocole de la séquence d'échanges d'informations</a></h3>
<p>La séquence d'échanges d'informations utilise trois protocoles :</p>
<ul>
<li>Le <dfn>Protocole d'échanges d'informations SSL</dfn> pour établir
la session SSl entre le client et le serveur.</li>
<li>Le <dfn>Protocole de spécification du chiffrement SSL</dfn> pour
l'agrément effectif de la suite de chiffrement à utiliser
pour la session.</li>
<li>Le <dfn>Protocole d'alertes SSL</dfn> pour la transmission de
messages d'erreur SSL entre le client et le serveur.</li>
</ul>
<p>Ces protocoles, ainsi que les données du protocole de l'application,
sont encapsulés dans le <dfn>Protocole d'enregistrement SSL
(SSL Record Protocol)</dfn>, comme
le montre la <a href="#figure2">Figure 2</a>. Un protocole encapsulé est
tranféré en tant que données par le protocole de la couche de niveau
inférieur, qui ne se préoccupe pas du contenu des données. Le protocole
encapsulé n'a aucune connaissance du protocole sous-jacent.</p>
<p class="figure">
<img src="../images/ssl_intro_fig2.gif" alt="" width="428" height="217" /><br />
<a id="figure2" name="figure2"><dfn>Figure 2</dfn></a>:
Pile du protocole SSL</p>
<p>L'encapsulation des protocoles de contrôle SSL dans le protocole
d'enregistrement signifie que si une session active est renégociée, les
protocoles de contrôle seront transmis de manière sécurisée. S'il n'y
avait pas de session préalable, la suite de chiffrement Null est utilisée,
ce qui signifie que les messages ne seront pas chiffrés et ne possèderont
pas d'empreinte d'intégrité, jusqu'à ce que la session ait été établie.</p>
<h3><a name="datatransfer" id="datatransfer">Transmission des données</a></h3>
<p>Le protocole d'enregistrement SSL, comme le montre la
<a href="#figure3">Figure 3</a>, est utilisé pour transmettre les données
de l'application et les données de contrôle SSL entre le client et le
serveur, les données étant nécessairement fragmentées en éléments plus
petits, ou plusieurs messages de données avec protocole de niveau
supérieur pouvant être combinés en un seul élément. Ce protocole peut
joindre des signatures d'empreintes, compresser et chiffrer ces éléments
avant de les transmettre en utilisant le protocole fiable de transport
sous-jacent (Note : actuellement, aucune implémentation majeure de SSL
n'inclut le support de la compression).</p>
<p class="figure">
<img src="../images/ssl_intro_fig3.gif" alt="" width="423" height="323" /><br />
<a id="figure3" name="figure3"><dfn>Figure 3</dfn></a>:
Protocole d'enregistrement SSL</p>
<h3><a name="securehttp" id="securehttp">Sécurisation des communications HTTP</a></h3>
<p>Une des utilisations courantes de SSL est la sécurisation des
communication HTTP sur le Web entre un navigateur et un serveur web. Ceci
n'exclut pas l'utilisation de HTTP non sécurisé - la version sécurisée
(appelée HTTPS) est identique à du vrai HTTP sur SSL,
mais utilise le préfixe
d'URL <code>https</code> au lieu de <code>http</code>, et un port
de serveur différent (par défaut le port 443).
Ceci constitue pour une large part
ce qu'apporte <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> au serveur web Apache.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="references" id="references">Références</a></h2>
<dl>
<dt><a id="AC96" name="AC96">[AC96]</a></dt>
<dd>Bruce Schneier, <q>Applied Cryptography</q>, 2nd Edition, Wiley,
1996. Voir <a href="http://www.counterpane.com/">http://www.counterpane.com/</a> pour diverses autres productions de Bruce
Schneier.</dd>
<dt><a id="ASN1" name="ASN1">[ASN1]</a></dt>
<dd>ITU-T Recommendation X.208, <q>Specification of Abstract Syntax Notation
One (ASN.1)</q>, dernière mise à jour en 2008. Voir <a href="http://www.itu.int/ITU-T/asn1/">http://www.itu.int/ITU-T/asn1/</a>.
</dd>
<dt><a id="X509" name="X509">[X509]</a></dt>
<dd>ITU-T Recommendation X.509, <q>The Directory - Authentication
Framework</q>. A titre de référence, voir <a href="http://en.wikipedia.org/wiki/X.509">http://en.wikipedia.org/wiki/X.509</a>.
</dd>
<dt><a id="PKCS" name="PKCS">[PKCS]</a></dt>
<dd><q>Public Key Cryptography Standards (PKCS)</q>,
RSA Laboratories Technical Notes, Voir <a href="http://www.rsasecurity.com/rsalabs/pkcs/">http://www.rsasecurity.com/rsalabs/pkcs/</a>.</dd>
<dt><a id="MIME" name="MIME">[MIME]</a></dt>
<dd>N. Freed, N. Borenstein, <q>Multipurpose Internet Mail Extensions
(MIME) Part One: Format of Internet Message Bodies</q>, RFC2045.
Voir par exemple <a href="http://tools.ietf.org/html/rfc2045">http://tools.ietf.org/html/rfc2045</a>.</dd>
<dt><a id="SSL3" name="SSL3">[SSL3]</a></dt>
<dd>Alan O. Freier, Philip Karlton, Paul C. Kocher, <q>The SSL Protocol
Version 3.0</q>, 1996. Voir <a href="http://www.netscape.com/eng/ssl3/draft302.txt">http://www.netscape.com/eng/ssl3/draft302.txt</a>.</dd>
<dt><a id="TLS1" name="TLS1">[TLS1]</a></dt>
<dd>Tim Dierks, Christopher Allen, <q>The TLS Protocol Version 1.0</q>,
1999. Voir <a href="http://ietf.org/rfc/rfc2246.txt">http://ietf.org/rfc/rfc2246.txt</a>.</dd>
<dt><a id="TLS11" name="TLS11">[TLS11]</a></dt>
<dd><q>Le protocole TLS Version 1.1</q>,
2006. Voir <a href="http://tools.ietf.org/html/rfc4346">http://tools.ietf.org/html/rfc4346</a>.</dd>
<dt><a id="TLS12" name="TLS12">[TLS12]</a></dt>
<dd><q>Le protocole TLS Version 1.2</q>,
2008. Voir <a href="http://tools.ietf.org/html/rfc5246">http://tools.ietf.org/html/rfc5246</a>.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/ssl/ssl_intro.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/ssl_intro.html" title="Français"> fr </a> |
<a href="../ja/ssl/ssl_intro.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/ssl/ssl_intro.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/ssl_intro.html.ja.utf8 0000664 0001751 0001751 00000121307 14743132254 022021 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>SSL/TLS 暗号化: はじめに - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">SSL/TLS</a></div><div id="page-content"><div id="preamble"><h1>SSL/TLS 暗号化: はじめに</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/ssl/ssl_intro.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/ssl_intro.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/ssl_intro.html" title="Japanese"> ja </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<blockquote>
<p>標準規格の良い所は、たくさんの規格から選べるということだ。
そして、もし本当にどの規格も気に入らなければ、
一年待つだけで探していた規格が現れる。</p>
<p class="cite">-- <cite>A. Tanenbaum</cite>, "Introduction to
Computer Networks"</p>
</blockquote>
<p>
入門ということで、この章は Web、HTTP、Apache に通じている
読者向けですが、セキュリティ専門家向けではありません。
SSL プロトコルの決定的な手引きであるつもりはありません。
また、組織内の認証管理のための特定のテクニックや、
特許や輸出規制などの重要な法的な問題についても扱いません。
むしろ、更なる研究への出発点として色々な概念、定義、例を並べることで
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> のユーザに基礎知識を提供する事を目的としています。</p>
<p>ここに示された内容は主に、原著者の許可の下
The Open Group Research Institute の <a href="http://home.earthlink.net/~fjhirsch/">Frederick J. Hirsch</a>
氏の記事 <a href="http://home.earthlink.net/~fjhirsch/Papers/wwwj/">
Introducing SSL and Certificates using SSLeay</a> を基にしています。
氏の記事は <a href="http://www.ora.com/catalog/wjsum97/">Web Security: A Matter of
Trust</a>, World Wide Web Journal, Volume 2, Issue 3, Summer 1997
に掲載されました。
肯定的な意見は <a href="mailto:hirsch@fjhirsch.com">Frederick Hirsch</a> 氏
(元記事の著者) へ全ての苦情は <a href="mailto:rse@engelschall.com">Ralf S. Engelschall</a> (
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> の作者) へお願いします。
<span class="transnote">(<em>訳注:</em> 訳については <a href="mailto:apache-docs@ml.apache.or.jp">
Apache ドキュメント翻訳プロジェクト</a>
へお願いします。)</span></p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#cryptographictech">暗号化技術</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#certificates">証明書</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ssl">Secure Sockets Layer (SSL)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#references">参考文献</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="cryptographictech" id="cryptographictech">暗号化技術</a></h2>
<p>SSL を理解するには、暗号アルゴリズム、
メッセージダイジェスト関数(別名: 一方向関数、ハッシュ関数)、
電子署名などへの理解が必要です。
これらの技術は本が丸ごと必要な題目で
(例えば [<a href="#AC96">AC96</a>] を参照)、
プライバシー、信用、認証などの技術の基礎となっています。</p>
<h3><a name="cryptographicalgo" id="cryptographicalgo">暗号アルゴリズム</a></h3>
<p>例えば、アリスが送金のために銀行にメッセージを送りたいとします。
口座番号や送金の金額が含まれるため、
アリスはそのメッセージを秘密にしたいと思います。
解決方法の一つは暗号アルゴリズムを使って、メッセージを
復号されるまで読むことができない暗号化された
形態に変えてしまうことです。
その形態になると、
メッセージは秘密の鍵によってのみ復号化することができます。
鍵なしでは、メッセージは役に立ちません。
良い暗号アルゴリズムは、侵入者が元のテキストを解読することを
非常に難しくするため、努力が割に合わなくさせます。</p>
<p>暗号アルゴリズムには
従来型と公開鍵の二つの種類があります。</p>
<dl>
<dt>従来型暗号</dt>
<dd>対称暗号としても知られ、
送信者と受信者が鍵を共有することが必要です。
鍵とは、メッセージを暗号化したり復号するのに使われる秘密
の情報のことです。
この鍵が秘密になっている限り、送信者と受信者以外は誰もメッセージを読
むことができません。
もしも、アリスと銀行が秘密の鍵を知っているなら、
彼らはお互いに秘密のメッセージを送ることができるでしょう。
ただし交信の前に、事前に内密に鍵を共有するという作業自体は難題かもしれません。</dd>
<dt>公開鍵暗号</dt>
<dd>非対称暗号としても知られ、
メッセージを暗号化することのできる二つの鍵
を使用するアルゴリズムを定義することで鍵のやり取りの問題を解決
します。
もし、ある鍵が暗号化に使われたなら、
もう片方の鍵で復号しなければいけません。
この方式によって、一つの鍵を公表して(公開鍵)、
もう片方を秘密にしておく(秘密鍵)だけで、
安全なメッセージを受け取ることができます。</dd>
</dl>
<p>公開鍵を使って誰もがメッセージを暗号化できますが、秘
密鍵の持ち主だけがそれを読むことができます。
この方法で、銀行の公開鍵を使って暗号化することで、
アリスは秘密のメッセージを送ることができます。
銀行のみが送られたメッセージを復号することができます。</p>
<h3><a name="messagedigests" id="messagedigests">メッセージダイジェスト</a></h3>
<p>アリスはメッセージを秘密にすることができますが、
誰かが例えば自分に送金するようにメッセージを変更したり、
別のものに置き換えてしまうかもしれないという問題があります。
アリスのメッセージだという信憑性を保証する方法の一つは、
メッセージの簡潔なダイジェストを作って、それも銀行に送るというものです。
メッセージを受け取ると銀行側でもダイジェストを作成し、
アリスが送ったダイジェストと比べます。もし一致したなら、
受け取ったメッセージは無傷だということになります。</p>
<p>このような要約は<dfn>メッセージダイジェスト</dfn>、
<em>一方行関数</em>、または<em>ハッシュ関数</em>と呼ばれます。
メッセージダイジェストは長い可変長のメッセージから
短い固定長の表現を作るのに使われます。
ダイジェストアルゴリズムはメッセージから
一意なダイジェストを生成するように作られています。
メッセージダイジェストはダイジェストから元のメッセージを
判定するのがとても難しいようにできていて、
同じ要約を作成する二つのメッセージを探すのは(理論上)不可能です。
これによって、要約を変更することなくメッセージを置き換えられる
可能性を排除しています。</p>
<p>アリスへのもう一つの問題は、このダイジェストを安全に送る方法を探すことです。
ダイジェストが安全に送られればダイジェストの信憑性が保障されて、
ダイジェストの信憑性をもってオリジナルメッセージの信憑性を得ることができます。
ダイジェストを安全に送った場合にのみ、そのメッセージの
信憑性が得られます。</p>
<p>ダイジェスト安全に送る方法の一つは、電子署名に含める方法です。</p>
<h3><a name="digitalsignatures" id="digitalsignatures">電子署名</a></h3>
<p>アリスが銀行にメッセージを送ったとき、
侵入者が彼女になりすまして彼女の口座への取引を申請できないように、
銀行側ではメッセージが本当に彼女からのものか確実に分かるようにしなければなりません。
アリスによって作成されて、メッセージに含まれた
<em>電子署名</em>がここで役に立ちます。</p>
<p>電子署名はメッセージのダイジェストやその他の情報(処理番号など)を
送信者の秘密鍵で暗号化することで作られます。
誰もが公開鍵を使って署名を<em>復号</em>することができますが、
送信者のみが秘密鍵を知っています。
これは送信者のみが署名しえたことを意味します。
ダイジェストを電子署名に含むことは、
その署名がそのメッセージのみに有効であることを意味します。
これは、誰もダイジェストを変えて署名をすることができないため、
メッセージの信用も保証します。</p>
<p>侵入者が署名を傍受して後日に再利用するのを防ぐため
電子署名には一意な処理番号が含まれます。
これは、アリスがそんなメッセージは送っていないと言う詐欺
から銀行を守ります。
彼女だけが署名しえたからです。(否認防止)</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="certificates" id="certificates">証明書</a></h2>
<p>アリスは秘密のメッセージを銀行に送り、
署名をして、メッセージの信用を保証することができるおうになりましたが、
通信している相手が本当に銀行なのか確かめなくてはいけません。
つまり彼女が使おうとしている公開鍵が、銀行の秘密鍵と対になっていて、
侵入者の秘密鍵と対になっているわけではないことを
確かめなくてはいけないことを意味しています。
同様に銀行は、メッセージの署名が本当にアリスの持っている
秘密鍵で署名された署名かを確認する必要があります。</p>
<p>もし両者に身元を証明し、公開鍵を確認し、また信頼された機関が署名
した証明書があれば、両者とも通信相手について正しい相手だと
確信することができます。
そのような信頼された機関は<em>認証局</em>
(Certificate Authority または CA) と呼ばれ、
証明書 (certificate) が認証 (authentication) に使われます。</p>
<h3><a name="certificatecontents" id="certificatecontents">証明書の内容</a></h3>
<p>証明書は公開鍵と個人、サーバ、その他の主体の実在の身元を
関連付けます。
<a href="#table1">表1</a>に示されるように証明対象の情報は
身元証明の情報(識別名)と公開鍵が含まれます。
証明書はまた、認証局の身元証明と署名、そして証明書の有効期間を
含みます。
シリアルナンバーなどの認証局の管理上の情報や
その他の追加の情報が含まれているかもしれません。</p>
<h4><a name="table1" id="table1">表1: 証明書情報</a></h4>
<table>
<tr><th>証明対象</th>
<td>識別名、公開鍵</td></tr>
<tr><th>発行者</th>
<td>識別名、公開鍵</td></tr>
<tr><th>有効期間</th>
<td>開始日、失効日</td></tr>
<tr><th>管理情報</th>
<td>バージョン、シリアルナンバー</td></tr>
<tr><th>拡張情報</th>
<td>基本的な制約、ネットスケープフラッグ、その他</td></tr>
</table>
<p>識別名(ディスティングイッシュ・ネーム)は特定の状況における
身分証明を提供するのに使われています。例えば、ある人は
私用と会社とで別々の身分証明を持つかもしれません。
識別名は X.509 標準規格 [<a href="#X509">X509</a>] で定義されています。
X.509 標準規格は、項目、項目名、そして項目の略称を定義しています。(<a href="#table2">表
2</a> 参照)</p>
<h4><a name="table2" id="table2">表 2: 識別名情報</a></h4>
<table class="bordered">
<tr><th>識別名項目</th>
<th>略称</th>
<th>説明</th>
<th>例</th></tr>
<tr><td>Common Name (コモンネーム)</td>
<td>CN</td>
<td>認証される名前<br />
SSL接続するURL</td>
<td>CN=www.example.com</td></tr>
<tr><td>Organization or Company (組織名)</td>
<td>O</td>
<td>団体の正式英語組織名</td>
<td>O=Example Japan K.K.</td></tr>
<tr><td>Organizational Unit (部門名)</td>
<td>OU</td>
<td>部署名など</td>
<td>OU=Customer Service</td></tr>
<tr><td>City/Locality (市区町村)</td>
<td>L</td>
<td>所在してる市区町村</td>
<td>L=Sapporo</td></tr>
<tr><td>State/Province (都道府県)</td>
<td>ST</td>
<td>所在してる都道府県</td>
<td>ST=Hokkaido</td></tr>
<tr><td>Country(国)</td>
<td>C</td>
<td>所在している国名の ISO コード<br />
日本の場合 JP
</td>
<td>C=JP</td></tr>
</table>
<p>認証局はどの項目が省略可能でどれが必須かの方針を定義する
かもしれません。項目の内容についても認証局や証明書のユーザからの
要件があるかもしれません。
例えばネットスケープのブラウザは、サーバの証明書の
Common Name (コモンネーム)がサーバのドメイン名の
<code>*.snakeoil.com</code>
というようなワイルドカードのパターンにマッチすること
を要求します。</p>
<p>バイナリ形式の証明書は ASN.1 表記法
[<a href="#X208">X208</a>] [<a href="#PKCS">PKCS</a>] で
定義されています。
この表記法は内容をどのように記述するかを定義し、
符号化の規定がこの情報がどのようにバイナリ形式に変換されるかを
定義します。
証明書のバイナリ符号化は Distinguished Encoding
Rules (DER) で定義され、それはより一般的な Basic Encoding Rules
(BER) に基づいています。
バイナリ形式を扱うことのできない送信では、
バイナリ形式は Base64 符号化 [<a href="#MIME">MIME</a>] で
ASCII 形式に変換されることがあります。
開始デリミタ行と終了デリミタ行で囲まれた、この形式のことを
PEM ("Privacy Enhanced Mail") 符号化された証明書と言います。</p>
<div class="example"><h3>PEM 符号化された証明書の例 (example.crt)</h3><pre>-----BEGIN CERTIFICATE-----
MIIC7jCCAlegAwIBAgIBATANBgkqhkiG9w0BAQQFADCBqTELMAkGA1UEBhMCWFkx
FTATBgNVBAgTDFNuYWtlIERlc2VydDETMBEGA1UEBxMKU25ha2UgVG93bjEXMBUG
A1UEChMOU25ha2UgT2lsLCBMdGQxHjAcBgNVBAsTFUNlcnRpZmljYXRlIEF1dGhv
cml0eTEVMBMGA1UEAxMMU25ha2UgT2lsIENBMR4wHAYJKoZIhvcNAQkBFg9jYUBz
bmFrZW9pbC5kb20wHhcNOTgxMDIxMDg1ODM2WhcNOTkxMDIxMDg1ODM2WjCBpzEL
MAkGA1UEBhMCWFkxFTATBgNVBAgTDFNuYWtlIERlc2VydDETMBEGA1UEBxMKU25h
a2UgVG93bjEXMBUGA1UEChMOU25ha2UgT2lsLCBMdGQxFzAVBgNVBAsTDldlYnNl
cnZlciBUZWFtMRkwFwYDVQQDExB3d3cuc25ha2VvaWwuZG9tMR8wHQYJKoZIhvcN
AQkBFhB3d3dAc25ha2VvaWwuZG9tMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKB
gQDH9Ge/s2zcH+da+rPTx/DPRp3xGjHZ4GG6pCmvADIEtBtKBFAcZ64n+Dy7Np8b
vKR+yy5DGQiijsH1D/j8HlGE+q4TZ8OFk7BNBFazHxFbYI4OKMiCxdKzdif1yfaa
lWoANFlAzlSdbxeGVHoT0K+gT5w3UxwZKv2DLbCTzLZyPwIDAQABoyYwJDAPBgNV
HRMECDAGAQH/AgEAMBEGCWCGSAGG+EIBAQQEAwIAQDANBgkqhkiG9w0BAQQFAAOB
gQAZUIHAL4D09oE6Lv2k56Gp38OBDuILvwLg1v1KL8mQR+KFjghCrtpqaztZqcDt
2q2QoyulCgSzHbEGmi0EsdkPfg6mp0penssIFePYNI+/8u9HT4LuKMJX15hxBam7
dUHzICxBVC1lnHyYGjDuAMhe396lYAn8bCld1/L4NMGBCQ==
-----END CERTIFICATE-----</pre></div>
<h3><a name="certificateauthorities" id="certificateauthorities">認証局</a></h3>
<p>証明書を承認する前に、証明書要求に記載されている情報を確認し、
認証局は鍵の所有者の身元を確認します。
例えば、アリスが個人証明書を申請したとすると、
認証局はアリスが証明書の申請が主張する通りの
当の本人だということを確認しなくてはいけません。</p>
<h4><a name="certificatechains" id="certificatechains">証明書の連鎖</a></h4>
<p>認証局は他の認証局への証明書を発行することができます。
未知の証明書を調べる時に、アリスはその証明書の発行者
に自信が持てるまで、発行者の証明書を
その上位階層の認証局をたどって調べる必要があります。
「悪質な」証明書の危険性を減らすため、
彼女は限られた連鎖の発行者のみ信頼するように
決めることもできます。</p>
<h4><a name="rootlevelca" id="rootlevelca">最上位認証局の作成</a></h4>
<p>前に述べたように、全ての証明書について、
最上位の認証局(CA)までそれぞれの発行者が
対象の身元証明の有効性を明らかにする必要があります。
問題は、誰がその最上位の認証機関の証明書を保証するのか、
ということです。
このような場合に限り、証明書は「自己署名」されます。
ブラウザには、とてもよく知られている認証局が初期登録されていますが、
自己署名された証明書を信用する際には
細心の注意が必要です。
最上位認証局が公開鍵を広く公表することで、
その鍵を信頼するリスクを低くすることができます。
もし、他人がその認証局になりすました時に、それが露見しや
すいからです。</p>
<p><a href="http://www.thawte.com/">Thawte</a>
や <a href="http://www.verisign.com/">VeriSign</a>
のような多くの会社が認証局として開設しました。
このような会社は以下のサービスを提供します:</p>
<ul>
<li>証明書申請の確認</li>
<li>証明書申請の処理</li>
<li>証明書の発行と管理</li>
</ul>
<p>自分で認証局を作ることも可能です。
インターネット環境では危険ですが、
個人やサーバの身元証明が簡単に行える組織の
イントラネット内では役に立つかもしれません。</p>
<h4><a name="certificatemanagement" id="certificatemanagement">証明書管理</a></h4>
<p>認証局の開設は徹底した管理、技術、運用の体制を必要とする
責任のある仕事です。
認証局は証明書を発行するだけでなく、
管理もしなければなりません。
具体的には、証明書がいつまで有効であり続けるかを決定し、更新し、
また過去発行されて失効した証明書のリスト
(Certificate Revocation Lists または CRL)
を管理しなければいけません。</p>
<p>例えばアリスが過去、会社の社員であることを証明する証明書を持っていたが、
現在は退職していた際、その証明書は失効されなければなりません。
証明書は次々と人に渡されていくものなので、
証明書そのものから、それが取り消されたか判断することは
不可能です。
よって、証明書の有効性を調べるときには、
認証局に連絡して CRL を照合する必要があります。
普通この過程は自動化されているものではありません。</p>
<div class="note"><h3>注意</h3>
<p>ブラウザに信用できる認証局としてデフォルトで登録されていない
認証局を使おうとした場合、
認証局の証明書をブラウザに読み込んで、
ブラウザがその認証局によって署名されたサーバの証明書を
有効にする必要があります。
一度読み込まれると、その認証局によって署名された全ての
証明書を受け入れるため、危険を伴います。</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="ssl" id="ssl">Secure Sockets Layer (SSL)</a></h2>
<p>Secure Sockets Layer プロトコルは信頼性のあるコネクション型の
ネットワーク層のプロトコル(例えば、TCP/IP)と
アプリケーション層のプロトコル(例えば、HTTP)
の間に置くことができます。
SSL は、相互認証によってサーバとクライアント間の安全な通信を、
電子署名によってデータの完全性を、
そして暗号化によってプライバシを提供します。</p>
<p>SSL プロトコルは暗号化、ダイジェスト、電子署名について、
様々なアルゴリズムをサポートするようにできています。
こうすることで、法や輸出の規制を考慮に入れて、サーバに合わせた
アルゴリズムを選ぶことができ、また、新しいアルゴリズムを
利用していくことも可能にしています。
アルゴリズムの選択はプロトコルセッション開始時に
サーバとクライアント間で取り決められます。</p>
<h3><a name="table4" id="table4">表4: SSL プロトコルのバージョン</a></h3>
<table class="bordered">
<tr><th>バージョン</th>
<th>出典</th>
<th>説明</th>
<th>ブラウザのサポート</th></tr>
<tr><td>SSL v2.0</td>
<td>Vendor Standard (Netscape Corp. より) [<a href="#SSL2">SSL2</a>]</td>
<td>実装が現存する初めての SSL プロトコル</td>
<td>- NS Navigator 1.x/2.x<br />
- MS IE 3.x<br />
- Lynx/2.8+OpenSSL</td></tr>
<tr><td>SSL v3.0</td>
<td>Expired Internet Draft (Netscape Corp. より) [<a href="#SSL3">SSL3</a>]</td>
<td>特定のセキュリティ攻撃を防ぐための改訂、
非RSA 暗号の追加、証明書階層構造のサポート</td>
<td>- NS Navigator 2.x/3.x/4.x<br />
- MS IE 3.x/4.x<br />
- Lynx/2.8+OpenSSL</td></tr>
<tr><td>TLS v1.0</td>
<td>Proposed Internet Standard (IETF より) [<a href="#TLS1">TLS1</a>]</td>
<td>MAC レイヤを HMAC へ更新、ブロック暗号の block
padding、メッセージ順序の標準化、警告文の充実などのため
SSL 3.0 を改訂。</td>
<td>- Lynx/2.8+OpenSSL</td></tr>
</table>
<p><a href="#table4">表4</a>に示されるとおり、SSL プロトコルには
いくつものバージョンがあります。
表にも書かれているように、SSL 3.0 の利点の一つは
証明書階層構造をサポートすることです。
この機能によって、サーバは自分の証明書に加えて、
発行者の証明書をブラウザに渡すことができます。
証明書階層構造によって、
ブラウザに発行者の証明書が直接登録されていなくても、
階層の中に含まれていれば、
ブラウザはサーバの証明書を有効化することができます。
SSL 3.0 は現在 Internet Engineering Task Force (IETF)
によって開発されている Transport Layer Security
[<a href="#TLS1">TLS</a>] プロトコル標準規格の基礎となっています。</p>
<h3><a name="session" id="session">セッションの確立</a></h3>
<p><a href="#figure1">図1</a>で示されるように、
セッションの確立はクライアントとサーバ間の
ハンドシェークシークエンスによって行なわれます。
サーバが証明書を提供するか、クライアントの証明書をリクエストするか
というサーバの設定により、このシークエンスは異なるものとなります。
暗号情報の管理のために、追加のハンドシェーク過程が必要になる
場合もありますが、この記事では
よくあるシナリオを手短に説明します。
全ての可能性についは、SSL 仕様書を参照してください。</p>
<div class="note"><h3>注意</h3>
<p>一度 SSL セッションが確立すると、セッションを再利用することで、
セッションを開始するための多くの過程を繰り返すという
パフォーマンスの損失を防ぎます。
そのため、サーバは全てのセッションに一意なセッション識別名を
割り当て、サーバにキャッシュし、クライアントは次回から
(識別名がサーバのキャッシュで期限切れになるまでは)
ハンドシェークなしで接続することができます。</p>
</div>
<p class="figure">
<img src="../images/ssl_intro_fig1.gif" alt="" width="423" height="327" /><br />
<a id="figure1" name="figure1"><dfn>図1</dfn></a>: SSL
ハンドシェークシークエンス概略</p>
<p>サーバとクライアントで使われる
ハンドシェークシークエンスの要素を以下に示します:</p>
<ol>
<li>データ通信に使われる暗号スイートの取り決め</li>
<li>クライアントとサーバ間でのセッション鍵の確立と共有</li>
<li>オプションとして、クライアントに対するサーバの認証</li>
<li>オプションとして、サーバに対するクライアントの認証</li>
</ol>
<p>第一ステップの暗号スイート取り決めによって、
サーバとクライアントはそれぞれにあった
暗号スイートを選ぶことができます。
SSL3.0 プロトコルの仕様書は 31 の暗号スイートを定義しています。
暗号スイートは以下のコンポーネントにより定義されています:</p>
<ul>
<li>鍵の交換手段</li>
<li>データ通信の暗号術</li>
<li>Message Authentication Code (MAC) 作成のための
メッセージダイジェスト</li>
</ul>
<p>これらの三つの要素は以下のセクションで説明されています。</p>
<h3><a name="keyexchange" id="keyexchange">鍵の交換手段</a></h3>
<p>鍵の交換手段はアプリケーションのデータ通信に使われ、
共有される対称暗号鍵をどのようにがクライアントとサーバで
取り決めるかを定義します。
SSL 2.0 は RSA 鍵交換しか使いませんが、
SSL 3.0 は (証明書が使われるときの) RSA 鍵交換や、
(証明書無しの場合やクライアントとサーバの事前の通信が無い場合の)
Diffie-Hellman 鍵交換
など様々な鍵交換アルゴリズムをサポートします。</p>
<p>鍵の交換方法における一つの選択肢は電子署名です。
電子署名を使うかどうか、また、
どの種類の署名を使うかという選択があります。
秘密鍵で署名することで共有鍵を保護し、情報交換する時の
マン・イン・ザ・ミドル攻撃を防ぐことができます。
[<a href="#AC96">AC96</a>, p516]</p>
<h3><a name="ciphertransfer" id="ciphertransfer">データ通信の暗号術</a></h3>
<p>SSL はセッションのメッセージの暗号化に前述した
対称暗号方式を用います。
暗号化しないという選択肢も含め九つの暗号方式の選択肢があります:</p>
<ul>
<li>暗号化なし</li>
<li>ストリーム暗号
<ul>
<li>40-bit 鍵での RC4</li>
<li>128-bit 鍵での RC4</li>
</ul></li>
<li>CBC ブロック暗号
<ul><li>40 bit 鍵での RC2</li>
<li>40 bit 鍵での DES</li>
<li>56 bit 鍵での DES</li>
<li>168 bit 鍵での Triple-DES</li>
<li>Idea (128 bit 鍵)</li>
<li>Fortezza (96 bit 鍵)</li>
</ul></li>
</ul>
<p>CBC とは暗号ブロック連鎖 (Cipher Block Chaining)
の略で、一つ前の暗号化された暗号文の一部が
ブロックの暗号化に使われることを意味します。
DES はデータ暗号化標準規格 (Data Encryption Standard)
[<a href="#AC96">AC96</a>, ch12] の略で、
DES40 や 3DES_EDE を含むいくつもの種類があります。
Idea は現在最高なものの一つで、暗号術的には現在ある中で
最も強力なものです。
RC2 は RSA DSI による独占的なアルゴリズムです。
[<a href="#AC96">AC96</a>,
ch13]</p>
<h3><a name="digestfuntion" id="digestfuntion">ダイジェスト関数</a></h3>
<p>
ダイジェスト関数の選択はレコードユニットからどのようにダイジェストが生成されるかを決定します。
SSL は以下をサポートします:</p>
<ul>
<li>ダイジェストなし</li>
<li>MD5 (128-bit ハッシュ)</li>
<li>Secure Hash Algorithm (SHA-1) (160-bit ハッシュ)</li>
</ul>
<p>メッセージダイジェストは Message Authentication Code (MAC)
の生成に使われ、メッセージと共に暗号化され、メッセージの信憑性を
確認し、リプレイ攻撃を防ぎます。</p>
<h3><a name="handshake" id="handshake">ハンドシェークシークエンスプロトコル</a></h3>
<p>ハンドシェークシークエンスは三つのプロトコルを使います:</p>
<ul>
<li><dfn>SSL ハンドシェークプロトコル</dfn>は
クライアントとサーバ間での SSL セッションの確立に使われます。</li>
<li><dfn>SSL 暗号仕様変更プロトコル</dfn>は
セッションでの暗号スイートの取り決めに使われます。</li>
<li><dfn>SSL 警告プロトコル</dfn>は
クライアントサーバ間で SSL エラーを伝達するのに使われます。</li>
</ul>
<p>三つのプロトコルは、アプリケーションプロトコルデータとともに、
<a href="#figure2">図2</a>に示すとおり <dfn>SSL レコードプロトコル</dfn>
でカプセル化されます。
カプセル化されたプロトコルはデータを検査しない
下層のプロトコルによってデータとして伝達されます。
カプセル化されたプロトコルは下層のプロトコルに関して一切関知しません。</p>
<p class="figure">
<img src="../images/ssl_intro_fig2.gif" alt="" width="428" height="217" /><br />
<a id="figure2" name="figure2"><dfn>図2</dfn></a>: SSL プロトコルスタック
</p>
<p>
レコードプロトコルで SSL コントロールプロトコルがカプセル化されているということは、
アクティブなセッション上で再ネゴシエーションされたときにも、
コントロールプロトコルは安全であることを意味します。
既存のセッションが無い場合は、Null 暗号スイートが使われ、
暗号化は行なわれず、セッションが確立するまでは
ダイジェストも無い状態となります。</p>
<h3><a name="datatransfer" id="datatransfer">データ通信</a></h3>
<p><a href="#figure3">図3</a>に示される SSL レコードプロトコル
はクライアントとサーバ間のアプリケーションや
SSL コントロールデータの通信に使われます。
必要に応じてこのデータはより小さいユニットに分けられたり、
いくつかの高級プロトコルをまとめて一ユニットとして通信が
行なわれることもあります。
データを圧縮し、ダイジェスト署名を添付して、
これらのユニットを暗号化したのち、ベースとなっている
信頼性のあるトランスポートプロトコルを用いるかもしれません。
(注意: 現在メジャーな SLL 実装で圧縮をサポートしているものはありません)</p>
<p class="figure">
<img src="../images/ssl_intro_fig3.gif" alt="" width="423" height="323" /><br />
<a id="figure3" name="figure3"><dfn>図 3</dfn></a>: SSL レコードプロトコル
</p>
<h3><a name="securehttp" id="securehttp">HTTP 通信の安全化</a></h3>
<p>よくある SSL の使い方はブラウザとウェブサーバ間の HTTP 通信
の安全化です。
これは、従来の安全ではない HTTP の使用を除外するものではありません。
安全化されたもの (HTTPS と呼ばれます) は、SSL 上での普通の HTTP で、
URL スキームに <code>http</code> の代わりに <code>https</code>
を用い、サーバで別のポートを使うことです (デフォルトでは443)。
これが主に <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> が Apache
ウェブサーバに提供する機能です。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="references" id="references">参考文献</a></h2>
<dl>
<dt><a id="AC96" name="AC96">[AC96]</a></dt>
<dd>Bruce Schneier, <q>Applied Cryptography</q>, 2nd Edition, Wiley,
1996. See <a href="http://www.counterpane.com/">http://www.counterpane.com/</a> for various other materials by Bruce
Schneier.</dd>
<dt><a id="X208" name="X208">[X208]</a></dt>
<dd>ITU-T Recommendation X.208, <q>Specification of Abstract Syntax Notation
One (ASN.1)</q>, 1988. See for instance <a href="http://www.itu.int/rec/recommendation.asp?type=items&lang=e&parent=T-REC-X.208-198811-I">http://www.itu.int/rec/recommendation.asp?type=items&lang=e&parent=T-REC-X.208-198811-I</a>.
</dd>
<dt><a id="X509" name="X509">[X509]</a></dt>
<dd>ITU-T Recommendation X.509, <q>The Directory - Authentication
Framework</q>. See for instance <a href="http://www.itu.int/rec/recommendation.asp?type=folders&lang=e&parent=T-REC-X.509">http://www.itu.int/rec/recommendation.asp?type=folders&lang=e&parent=T-REC-X.509</a>.
</dd>
<dt><a id="PKCS" name="PKCS">[PKCS]</a></dt>
<dd><q>Public Key Cryptography Standards (PKCS)</q>,
RSA Laboratories Technical Notes, See <a href="http://www.rsasecurity.com/rsalabs/pkcs/">http://www.rsasecurity.com/rsalabs/pkcs/</a>.</dd>
<dt><a id="MIME" name="MIME">[MIME]</a></dt>
<dd>N. Freed, N. Borenstein, <q>Multipurpose Internet Mail Extensions
(MIME) Part One: Format of Internet Message Bodies</q>, RFC2045.
See for instance <a href="http://ietf.org/rfc/rfc2045.txt">http://ietf.org/rfc/rfc2045.txt</a>.</dd>
<dt><a id="SSL2" name="SSL2">[SSL2]</a></dt>
<dd>Kipp E.B. Hickman, <q>The SSL Protocol</q>, 1995. See <a href="http://www.netscape.com/eng/security/SSL_2.html">http://www.netscape.com/eng/security/SSL_2.html</a>.</dd>
<dt><a id="SSL3" name="SSL3">[SSL3]</a></dt>
<dd>Alan O. Freier, Philip Karlton, Paul C. Kocher, <q>The SSL Protocol
Version 3.0</q>, 1996. See <a href="http://www.netscape.com/eng/ssl3/draft302.txt">http://www.netscape.com/eng/ssl3/draft302.txt</a>.</dd>
<dt><a id="TLS1" name="TLS1">[TLS1]</a></dt>
<dd>Tim Dierks, Christopher Allen, <q>The TLS Protocol Version 1.0</q>,
1999. See <a href="http://ietf.org/rfc/rfc2246.txt">http://ietf.org/rfc/rfc2246.txt</a>.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/ssl/ssl_intro.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/ssl_intro.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/ssl_intro.html" title="Japanese"> ja </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/ssl/ssl_intro.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/ssl_howto.html.fr.utf8 0000664 0001751 0001751 00000062030 14740503670 022041 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Chiffrement fort SSL/TLS : Mode d'emploi - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">SSL/TLS</a></div><div id="page-content"><div id="preamble"><h1>Chiffrement fort SSL/TLS : Mode d'emploi</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/ssl/ssl_howto.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/ssl_howto.html" title="Français"> fr </a></p>
</div>
<p>Ce document doit vous permettre de démarrer et de faire fonctionner
une configuration de base. Avant de vous lancer dans l'application de
techniques avancées, il est fortement recommandé de lire le reste
de la documentation SSL afin d'en comprendre le fonctionnement de
manière plus approfondie.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#configexample">Exemple de configuration basique</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ciphersuites">Suites de chiffrement et mise en application de la sécurité
de haut niveau</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ocspstapling">Agrafage OCSP</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#accesscontrol">Authentification du client et contrôle d'accès</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#logging">Journalisation</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="configexample" id="configexample">Exemple de configuration basique</a></h2>
<p>Votre configuration SSL doit comporter au moins les directives
suivantes :</p>
<pre class="prettyprint lang-config">LoadModule ssl_module modules/mod_ssl.so
Listen 443
<VirtualHost *:443>
ServerName www.example.com
SSLEngine on
SSLCertificateFile "/path/to/www.example.com.cert"
SSLCertificateKeyFile "/path/to/www.example.com.key"
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ciphersuites" id="ciphersuites">Suites de chiffrement et mise en application de la sécurité
de haut niveau</a></h2>
<ul>
<li><a href="#onlystrong">Comment créer un serveur SSL
qui n'accepte que le chiffrement fort ?</a></li>
<li><a href="#strongurl">Comment créer un serveur qui accepte tous les types de
chiffrement en général, mais exige un chiffrement fort pour pouvoir
accéder à une URL particulière ?</a></li>
</ul>
<h3><a name="onlystrong" id="onlystrong">Comment créer un serveur SSL qui n'accepte
que le chiffrement fort ?</a></h3>
<p>Les directives suivantes ne permettent que les
chiffrements de plus haut niveau :</p>
<pre class="prettyprint lang-config">SSLCipherSuite HIGH:!aNULL:!MD5</pre>
<p>Avec la configuration qui suit, vous indiquez une préférence pour
des algorityhmes de chiffrement spécifiques optimisés en matière de
rapidité (le choix final sera opéré par mod_ssl, dans la mesure ou le
client les supporte) :</p>
<pre class="prettyprint lang-config">SSLCipherSuite RC4-SHA:AES128-SHA:HIGH:!aNULL:!MD5
SSLHonorCipherOrder on</pre>
<h3><a name="strongurl" id="strongurl">Comment créer un serveur qui accepte tous les types de
chiffrement en général, mais exige un chiffrement fort pour pouvoir
accéder à une URL particulière ?</a></h3>
<p>Dans ce cas bien évidemment, une directive <code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code> au niveau du serveur principal
qui restreint le choix des suites de chiffrement aux versions les plus
fortes ne conviendra pas. <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> peut cependant être
reconfiguré au sein de blocs <code>Location</code> qui permettent
d'adapter la configuration générale à un répertoire spécifique ;
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> peut alors forcer automatiquement une
renégociation des paramètres SSL pour parvenir au but recherché.
Cette configuration peut se présenter comme suit :</p>
<pre class="prettyprint lang-config"># soyons très tolérant a priori
SSLCipherSuite ALL:!aNULL:RC4+RSA:+HIGH:+MEDIUM:+LOW:+EXP:+eNULL
<Location "/strong/area">
# sauf pour https://hostname/strong/area/ et ses sous-répertoires
# qui exigent des chiffrements forts
SSLCipherSuite HIGH:!aNULL:!MD5
</Location></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ocspstapling" id="ocspstapling">Agrafage OCSP</a></h2>
<p>Le protocole de contrôle du statut des certificats en ligne (Online
Certificate Status Protocol - OCSP) est un mécanisme permettant de
déterminer si un certificat a été révoqué ou non, et l'agrafage OCSP en
est une fonctionnalité particulière par laquelle le serveur, par exemple
httpd et mod_ssl, maintient une liste des réponses OCSP actuelles pour
ses certificats et l'envoie aux clients qui communiquent avec lui. La
plupart des certificats contiennent l'adresse d'un répondeur OCSP maintenu
par l'Autorité de Certification (CA) spécifiée, et mod_ssl peut requérir
ce répondeur pour obtenir une réponse signée qui peut être envoyée aux
clients qui communiquent avec le serveur.</p>
<p>L'agrafage OCSP est la méthode la plus performante pour obtenir le
statut d'un certificat car il est disponible au niveau du serveur, et le
client n'a donc pas besoin d'ouvrir une nouvelle connexion vers
l'autorité de certification. Autres avantages de l'absence de
communication entre le client et l'autorité de certification :
l'autorité de certification n'a pas accès à l'historique de navigation
du client, et l'obtention du statut du certificat est plus efficace car
elle n'est plus assujettie à une surcharge éventuelle des serveurs de
l'autorité de certification.</p>
<p>La charge du serveur est moindre car la réponse qu'il a obtenu du
répondeur OCSP peut être réutilisée par tous les clients qui utilisent
le même certificat dans la limite du temps de validité de la réponse.</p>
<p>Une fois le support général SSL correctement configuré, l'activation
de l'agrafage OCSP ne requiert que des modifications mineures
à la configuration de httpd et il suffit en général de l'ajout de ces
deux directives :</p>
<pre class="prettyprint lang-config">SSLUseStapling On
SSLStaplingCache "shmcb:ssl_stapling(32768)"</pre>
<p>Ces directives sont placées de façon à ce qu'elles aient une portée
globale (et particulièrement en dehors de toute section VirtualHost), le
plus souvent où sont placées les autres directives de configuration
globales SSL, comme <code>conf/extra/httpd-ssl.conf</code> pour les
installations de httpd à partir des sources, ou
<code>/etc/apache2/mods-enabled/ssl.conf</code> pour Ubuntu ou Debian,
etc...</p>
<p>Le chemin spécifié par la directive
<code class="directive">SSLStaplingCache</code> (par exemple <code>logs/</code>)
doit être le même que celui spécifié par la directive
<code class="directive">SSLSessionCache</code>. Ce chemin est relatif au chemin
spécifié par la directive <code class="directive">ServerRoot</code>.</p>
<p>Cette directive <code class="directive">SSLStaplingCache</code> particulière
nécessite le chargement du module <code class="module"><a href="../mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code> (à
cause du préfixe <code>shmcb</code> de son argument). Ce module est en
général déjà activé pour la directive
<code class="directive">SSLSessionCache</code>, ou pour des modules autres que
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>. Si vous activez un cache de session SSL
utilisant un mécanisme autre que <code class="module"><a href="../mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code>,
utilisez aussi ce mécanisme alternatif pour la directive
<code class="directive">SSLStaplingCache</code>. Par exemple :</p>
<pre class="prettyprint lang-config">SSLSessionCache "dbm:ssl_scache"
SSLStaplingCache "dbm:ssl_stapling"</pre>
<p>Vous pouvez utiliser la commande openssl pour vérifier que votre
serveur envoie bien une réponse OCSP :</p>
<pre>$ openssl s_client -connect www.example.com:443 -status -servername www.example.com
...
OCSP response:
======================================
OCSP Response Data:
OCSP Response Status: successful (0x0)
Response Type: Basic OCSP Response
...
Cert Status: Good
...</pre>
<p>Les sections suivantes explicitent les situations courantes qui
requièrent des modifications supplémentaires de la configuration. Vous
pouvez aussi vous référer au manuel de référence de
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.</p>
<h3>Si l'on utilise plus que quelques certificats SSL pour le serveur</h3>
<p>Les réponses OCSP sont stockées dans le cache d'agrafage SSL. Alors
que les réponses ont une taille de quelques centaines à quelques
milliers d'octets, mod_ssl supporte des réponses d'une taille jusqu'à
environ 10 ko. Dans notre cas, le nombre de certificats est conséquent
et la taille du cache (32768 octets dans l'exemple ci-dessus) doit être
augmentée. En cas d'erreur lors du stockage d'une réponse, le
message AH01929 sera enregistré dans le journal.</p>
<h3>Si le certificat ne spécifie pas de répondeur OCSP, ou si une
adresse différente doit être utilisée</h3>
<p>Veuillez vous référer à la documentation de la directive <code class="directive"><a href="../mod/mod_ssl.html#sslstaplingforceurl">SSLStaplingForceURL</a></code>.</p>
<p>Vous pouvez vérifier si un certificat spécifie un répondeur OCSP en
utilisant la commande openssl comme suit :</p>
<pre>$ openssl x509 -in ./www.example.com.crt -text | grep 'OCSP.*http'
OCSP - URI:http://ocsp.example.com</pre>
<p>Si un URI OCSP est fourni et si le serveur web peut communiquer
directement avec lui sans passer par un mandataire, aucune modification
supplémentaire de la configuration n'est requise. Notez que les règles
du pare-feu qui contrôlent les connexions sortantes en provenance du
serveur web devront peut-être subir quelques ajustements.</p>
<p>Si aucun URI OCSP n'est fourni, contactez votre autorité de
certification pour savoir s'il en existe une ; si c'est le
cas, utilisez la directive <code class="directive"><a href="../mod/mod_ssl.html#sslstaplingforceurl">SSLStaplingForceURL</a></code> pour la spécifier dans
la configuration du serveur virtuel qui utilise le certificat.</p>
<h3>Si plusieurs serveurs virtuels sont configurés pour utiliser SSL
et si l'agrafage OCSP doit être désactivé pour certains d'entre eux</h3>
<p>Ajoutez la directive <code>SSLUseStapling Off</code> à la
configuration des serveurs virtuels pour lesquels l'agrafage OCSP doit
être désactivé.</p>
<h3>Si le répondeur OCSP est lent ou instable</h3>
<p>De nombreuses directives permettent de gérer les temps de réponse et
les erreurs. Référez-vous à la documentation de <code class="directive"><a href="../mod/mod_ssl.html#sslstaplingfaketrylater">SSLStaplingFakeTryLater</a></code>, <code class="directive"><a href="../mod/mod_ssl.html#sslstaplingrespondertimeout">SSLStaplingResponderTimeout</a></code>, et <code class="directive"><a href="../mod/mod_ssl.html#sslstaplingreturnrespondererrors">SSLStaplingReturnResponderErrors</a></code>.</p>
<h3>Si mod_ssl enregistre l'erreur AH02217 dans le journal</h3>
<pre>AH02217: ssl_stapling_init_cert: Can't retrieve issuer certificate!</pre>
<p>Afin de pouvoir supporter l'agrafage OCSP lorsqu'un certificat de
serveur particulier est utilisé, une chaîne de certification pour ce
certificat doit être spécifiée. Si cela n'a pas été fait lors de
l'activation de SSL, l'erreur AH02217 sera enregistrée lorsque
l'agrafage OCSP sera activé, et les clients qui utilisent le certificat
considéré ne recevront pas de réponse OCSP.</p>
<p>Veuillez vous référer à la documentation des directives <code class="directive"><a href="../mod/mod_ssl.html#sslcertificatechainfile">SSLCertificateChainFile</a></code> et <code class="directive"><a href="../mod/mod_ssl.html#sslcertificatefile">SSLCertificateFile</a></code> pour spécifier une
chaîne de certification.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="accesscontrol" id="accesscontrol">Authentification du client et contrôle d'accès</a></h2>
<ul>
<li><a href="#allclients">Comment forcer les clients
à s'authentifier à l'aide de certificats ?</a></li>
<li><a href="#arbitraryclients">Comment forcer les clients
à s'authentifier à l'aide de certificats pour une URL particulière,
mais autoriser quand-même tout client anonyme
à accéder au reste du serveur ?</a></li>
<li><a href="#certauthenticate">Comment n'autoriser l'accès à une URL
particulière qu'aux clients qui possèdent des certificats, mais autoriser
l'accès au reste du serveur à tous les clients ?</a></li>
<li><a href="#intranet">Comment imposer HTTPS avec chiffrements forts,
et soit authentification de base, soit possession de certificats clients,
pour l'accès à une partie de l'Intranet, pour les clients en
provenance de l'Internet ?</a></li>
</ul>
<h3><a name="allclients" id="allclients">Comment forcer les clients
à s'authentifier à l'aide de certificats ?
</a></h3>
<p>Lorsque vous connaissez tous vos clients (comme c'est en général le cas
au sein d'un intranet d'entreprise), vous pouvez imposer une
authentification basée uniquement sur les certificats. Tout ce dont vous
avez besoin pour y parvenir est de créer des certificats clients signés par
le certificat de votre propre autorité de certification
(<code>ca.crt</code>), et d'authentifier les clients à l'aide de ces
certificats.</p>
<pre class="prettyprint lang-config"># exige un certificat client signé par le certificat de votre CA
# contenu dans ca.crt
SSLVerifyClient require
SSLVerifyDepth 1
SSLCACertificateFile "conf/ssl.crt/ca.crt"</pre>
<h3><a name="arbitraryclients" id="arbitraryclients">Comment forcer les clients
à s'authentifier à l'aide de certificats pour une URL particulière,
mais autoriser quand-même tout client anonyme
à accéder au reste du serveur ?</a></h3>
<p>Pour forcer les clients à s'authentifier à l'aide de certificats pour une
URL particulière, vous pouvez utiliser les fonctionnalités de reconfiguration
de <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> en fonction du répertoire :</p>
<pre class="prettyprint lang-config">SSLVerifyClient none
SSLCACertificateFile "conf/ssl.crt/ca.crt"
<Location "/secure/area">
SSLVerifyClient require
SSLVerifyDepth 1
</Location></pre>
<h3><a name="certauthenticate" id="certauthenticate">Comment n'autoriser l'accès à une URL
particulière qu'aux clients qui possèdent des certificats, mais autoriser
l'accès au reste du serveur à tous les clients ?</a></h3>
<p>La clé du problème consiste à vérifier si une partie du certificat
client correspond à ce que vous attendez. Cela signifie en général
consulter tout ou partie du nom distinctif (DN), afin de vérifier s'il
contient une chaîne connue. Il existe deux méthodes pour y parvenir ;
on utilise soit le module <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>, soit la
directive <code class="directive"><a href="../mod/mod_ssl.html#sslrequire">SSLRequire</a></code>.</p>
<p>La méthode du module <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> est en général
incontournable lorsque les certificats ont un contenu arbitraire, ou
lorsque leur DN ne contient aucun champ connu
(comme l'organisation, etc...). Dans ce cas, vous devez construire une base
de données de mots de passe contenant <em>tous</em> les clients
autorisés, comme suit :</p>
<pre class="prettyprint lang-config">SSLVerifyClient none
SSLCACertificateFile "conf/ssl.crt/ca.crt"
SSLCACertificatePath "conf/ssl.crt"
<Directory "/usr/local/apache2/htdocs/secure/area">
SSLVerifyClient require
SSLVerifyDepth 5
SSLOptions +FakeBasicAuth
SSLRequireSSL
AuthName "Snake Oil Authentication"
AuthType Basic
AuthBasicProvider file
AuthUserFile "/usr/local/apache2/conf/httpd.passwd"
Require valid-user
</Directory></pre>
<p>Le mot de passe utilisé dans cet exemple correspond à la chaîne de
caractères "password" chiffrée en DES. Voir la documentation de la
directive <code class="directive"><a href="../mod/mod_ssl.html#ssloptions">SSLOptions</a></code> pour
plus de détails.</p>
<div class="example"><h3>httpd.passwd</h3><pre>/C=DE/L=Munich/O=Snake Oil, Ltd./OU=Staff/CN=Foo:xxj31ZMTZzkVA
/C=US/L=S.F./O=Snake Oil, Ltd./OU=CA/CN=Bar:xxj31ZMTZzkVA
/C=US/L=L.A./O=Snake Oil, Ltd./OU=Dev/CN=Quux:xxj31ZMTZzkVA</pre></div>
<p>Lorsque vos clients font tous partie d'une même hiérarchie, ce qui
apparaît dans le DN, vous pouvez les authentifier plus facilement en
utilisant la directive <code class="directive"><a href="../mod/mod_ssl.html#sslrequire">SSLRequire</a></code>, comme suit :</p>
<pre class="prettyprint lang-config">SSLVerifyClient none
SSLCACertificateFile "conf/ssl.crt/ca.crt"
SSLCACertificatePath "conf/ssl.crt"
<Directory "/usr/local/apache2/htdocs/secure/area">
SSLVerifyClient require
SSLVerifyDepth 5
SSLOptions +FakeBasicAuth
SSLRequireSSL
SSLRequire %{SSL_CLIENT_S_DN_O} eq "Snake Oil, Ltd." \
and %{SSL_CLIENT_S_DN_OU} in {"Staff", "CA", "Dev"}
</Directory></pre>
<h3><a name="intranet" id="intranet">Comment imposer HTTPS avec chiffrements forts,
et soit authentification de base, soit possession de certificats clients,
pour l'accès à une partie de l'Intranet, pour les clients en
provenance de l'Internet ? Je souhaite quand-même autoriser l'accès en HTTP
aux clients de l'intranet.</a></h3>
<p>On suppose dans ces exemples que les clients de l'intranet ont des
adresses IP dans la gamme 192.168.1.0/24, et que la partie de l'intranet
à laquelle vous voulez autoriser l'accès depuis l'Internet est
<code>/usr/local/apache2/htdocs/subarea</code>. Ces lignes de configuration
doivent se trouver en dehors de votre hôte virtuel HTTPS, afin qu'elles
s'appliquent à la fois à HTTP et HTTPS.</p>
<pre class="prettyprint lang-config">SSLCACertificateFile "conf/ssl.crt/company-ca.crt"
<Directory "/usr/local/apache2/htdocs">
# En dehors de subarea, seul l'accès depuis l'intranet est
# autorisé
Require ip 192.168.1.0/24
</Directory>
<Directory "/usr/local/apache2/htdocs/subarea">
# Dans subarea, tout accès depuis l'intranet est autorisé
# mais depuis l'Internet, seul l'accès par HTTPS + chiffrement fort + Mot de passe
# ou HTTPS + chiffrement fort + certificat client n'est autorisé.
# Si HTTPS est utilisé, on s'assure que le niveau de chiffrement est fort.
# Autorise en plus les certificats clients comme une alternative à
# l'authentification basique.
SSLVerifyClient optional
SSLVerifyDepth 1
SSLOptions +FakeBasicAuth +StrictRequire
SSLRequire %{SSL_CIPHER_USEKEYSIZE} >= 128
# ON oblige les clients venant d'Internet à utiliser HTTPS
RewriteEngine on
RewriteCond "%{REMOTE_ADDR}" "!^192\.168\.1\.[0-9]+$"
RewriteCond "%{HTTPS}" "!=on"
RewriteRule "." "-" [F]
# On permet l'accès soit sur les critères réseaux, soit par authentification Basique
Satisfy any
# Contrôle d'accès réseau
Require ip 192.168.1.0/24
# Configuration de l'authentification HTTP Basique
AuthType basic
AuthName "Protected Intranet Area"
AuthBasicProvider file
AuthUserFile "conf/protected.passwd"
Require valid-user
</Directory></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="logging" id="logging">Journalisation</a></h2>
<p><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> peut enregistrer des informations de
débogage très verbeuses dans le journal des erreurs, lorsque sa
directive <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> est définie
à des niveaux de trace élevés. Par contre, sur un serveur très
sollicité, le niveau <code>info</code> sera probablement déjà trop
élevé. Souvenez-vous que vous pouvez configurer la directive
<code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> par module afin de
pourvoir à vos besoins.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/ssl/ssl_howto.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/ssl_howto.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/ssl/ssl_howto.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/index.html.zh-cn.utf8 0000664 0001751 0001751 00000011724 14743132254 021542 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache SSL/TLS 加密 - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">模块</a> | <a href="../mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Apache SSL/TLS 加密</h1>
<div class="toplang">
<p><span>可用语言: </span><a href="../en/ssl/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../tr/ssl/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/ssl/" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">此翻译可能过期。要了解最近的更改，请阅读英文版。</div>
<p>Apache HTTP 服务器模块 <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>
提供了与 <a href="http://www.openssl.org/">OpenSSL</a>
的接口，它使用安全套接字层和传输层安全协议提供了强加密。
此模块与这篇文档都基于
Ralf S. Engelschall 的 mod_ssl 项目。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#documentation">文档</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mod-ssl">mod_ssl</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="documentation" id="documentation">文档</a></h2>
<ul>
<li><a href="ssl_intro.html">简介</a></li>
<li><a href="ssl_compat.html">兼容性</a></li>
<li><a href="ssl_howto.html">常见操作</a></li>
<li><a href="ssl_faq.html">常见问题</a></li>
<li><a href="../glossary.html">术语</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="mod-ssl" id="mod-ssl">mod_ssl</a></h2>
<p>此模块提供的指令和环境变量的文档位于 <a href="../mod/mod_ssl.html">mod_ssl 参考手册</a>。
</p>
</div></div>
<div class="bottomlang">
<p><span>可用语言: </span><a href="../en/ssl/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../tr/ssl/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/ssl/" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/ssl_faq.html.fr.utf8 0000664 0001751 0001751 00000156552 14740503670 021465 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Chiffrement SSL/TLS fort: foire aux questions - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">SSL/TLS</a></div><div id="page-content"><div id="preamble"><h1>Chiffrement SSL/TLS fort: foire aux questions</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/ssl/ssl_faq.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/ssl_faq.html" title="Français"> fr </a></p>
</div>
<blockquote>
<p>Le sage n'apporte pas de bonnes réponses, il pose les bonnes questions</p>
<p class="cite">-- <cite>Claude Levi-Strauss</cite></p>
</blockquote>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#installation">Installation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#aboutconfig">Configuration</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#aboutcerts">Certificats</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#aboutssl">Le protocole SSL</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#support">Support de mod_ssl</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="installation" id="installation">Installation</a></h2>
<ul>
<li><a href="#mutex">Pourquoi le démarrage d'Apache provoque-t-il des
erreurs de permission en rapport avec SSLMutex ?</a></li>
<li><a href="#entropy">Pourquoi mod_ssl s'arrête-t-il avec l'erreur
"Failed to generate temporary 512 bit RSA private key" au démarrage
d'Apache ?</a></li>
</ul>
<h3><a name="mutex" id="mutex">Pourquoi le démarrage d'Apache provoque-t-il des
erreurs de permission en rapport avec SSLMutex ?</a></h3>
<p>Des erreurs telles que ``<code>mod_ssl: Child could not open
SSLMutex lockfile /opt/apache/logs/ssl_mutex.18332 (avec l'erreur
système qui suit) [...] System: Permission denied (errno: 13)</code>''
sont souvent provoquées par des permissions trop restrictives sur les
répertoires <em>parents</em>. Assurez-vous que tous les répertoires
parents (ici <code>/opt</code>, <code>/opt/apache</code> et
<code>/opt/apache/logs</code>) ont le bit x positionné au moins pour
l'UID sous lequel les processus enfants d'Apache s'exécutent (voir la
directive <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code>).</p>
<h3><a name="entropy" id="entropy">Pourquoi mod_ssl s'arrête-t-il avec l'erreur
"Failed to generate temporary 512 bit RSA private key" au démarrage
d'Apache ?</a></h3>
<p>Pour fonctionner correctement, les logiciels de cryptographie ont
besoin d'une source de données aléatoires. De nombreux systèmes
d'exploitation libres proposent un "périphérique source d'entropie"
qui fournit ce service (il se nomme en général
<code>/dev/random</code>). Sur d'autres systèmes, les applications
doivent amorcer manuellement
le Générateur de Nombres Pseudo-Aléatoires d'OpenSSL
(Pseudo Random Number Generator -PRNG) à l'aide de données appropriées
avant de générer des clés ou d'effectuer un chiffrement à clé
publique. Depuis la version 0.9.5, les fonctions d'OpenSSL qui nécessitent
des données aléatoires provoquent une erreur si le PRNG n'a pas été amorcé
avec une source de données aléatoires d'au moins 128 bits.</p>
<p>Pour éviter cette erreur, <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> doit fournir
suffisamment d'entropie au PRNG pour lui permettre de fonctionner
correctement. Ce niveau d'entropie est défini par la directive
<code class="directive"><a href="../mod/mod_ssl.html#sslrandomseed">SSLRandomSeed</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="aboutconfig" id="aboutconfig">Configuration</a></h2>
<ul>
<li><a href="#parallel">Peut-on faire cohabiter HTTP et HTTPS sur le même
serveur ?</a></li>
<li><a href="#ports">Quel port HTTPS utilise-t-il ?</a></li>
<li><a href="#httpstest">Comment s'exprimer en langage HTTPS à des fins
de test ?</a></li>
<li><a href="#hang">Pourquoi la communication se bloque-t-elle lorsque je
me connecte à mon serveur Apache configuré pour SSL ?</a></li>
<li><a href="#refused">Pourquoi, lorsque je tente d'accéder en HTTPS à mon
serveur Apache+mod_ssl fraîchement installé, l'erreur ``Connection Refused''
s'affiche-t-elle ?</a></li>
<li><a href="#envvars">Pourquoi les variables <code>SSL_XXX</code>
ne sont-elles pas disponibles dans mes scripts CGI et SSI ?</a></li>
<li><a href="#relative">Comment puis-je basculer entre les protocoles HTTP et
HTTPS dans les hyperliens relatifs ?</a></li>
</ul>
<h3><a name="parallel" id="parallel">Peut-on faire cohabiter HTTP et HTTPS sur le même
serveur ?</a></h3>
<p>Oui. HTTP et HTTPS utilisent des ports différents (HTTP écoute le port
80 et HTTPS le port 443), si bien qu'il n'y a pas de conflit direct entre
les deux. Vous pouvez soit exécuter deux instances séparées du serveur,
chacune d'entre elles écoutant l'un de ces ports, soit utiliser l'élégante
fonctionnalité d'Apache que constituent les hôtes virtuels pour créer
deux serveurs virtuels gérés par la même instance d'Apache - le
premier serveur répondant en HTTP aux requêtes sur le port 80,
le second répondant en HTTPS aux requêtes sur le port
443.</p>
<h3><a name="ports" id="ports">Quel port HTTPS utilise-t-il ?</a></h3>
<p>Vous pouvez associer le protocole HTTPS à n'importe quel port, mais le port
standard est le port 443, que tout navigateur compatible HTTPS va utiliser par
défaut. Vous pouvez forcer votre navigateur à utiliser un port différent en le
précisant dans l'URL. Par exemple, si votre serveur est configuré pour
servir des pages en HTTPS sur le port 8080, vous pourrez y accéder par
l'adresse <code>https://example.com:8080/</code>.</p>
<h3><a name="httpstest" id="httpstest">Comment s'exprimer en langage HTTPS à des fins
de test ?</a></h3>
<p>Alors que vous utilisez simplement</p>
<div class="example"><p><code>$ telnet localhost 80<br />
GET / HTTP/1.0</code></p></div>
<p>pour tester facilement Apache via HTTP, les choses ne sont pas si
simples pour HTTPS à cause du protocole SSL situé entre TCP et HTTP.
La commande OpenSSL <code>s_client</code> vous permet cependant
d'effectuer un test similaire via HTTPS :</p>
<div class="example"><p><code>$ openssl s_client -connect localhost:443 -state -debug<br />
GET / HTTP/1.0</code></p></div>
<p>Avant la véritable réponse HTTP, vous recevrez des informations
détaillées à propos de l'établissement de la connexion SSL. Si vous
recherchez un client en ligne de commande à usage plus général qui comprend
directement HTTP et HTTPS, qui peut effectuer des opérations GET et POST,
peut utiliser un mandataire, supporte les requêtes portant sur une partie
d'un fichier (byte-range), etc..., vous devriez vous tourner vers
l'excellent outil <a href="http://curl.haxx.se/">cURL</a>. Grâce à lui,
vous pouvez vérifier si Apache répond correctement aux requêtes via
HTTP et HTTPS comme suit :</p>
<div class="example"><p><code>$ curl http://localhost/<br />
$ curl https://localhost/</code></p></div>
<h3><a name="hang" id="hang">Pourquoi la communication se bloque-t-elle lorsque je
me connecte à mon serveur Apache configuré pour SSL ?</a></h3>
<p>Ceci peut arriver si vous vous connectez à un serveur HTTPS (ou à
un serveur virtuel) via HTTP (par exemple, en utilisant
<code>http://example.com/</code> au lieu de <code>https://example.com</code>).
Cela peut aussi arriver en essayant de vous connecter via HTTPS à un
serveur HTTP (par exemple, en utilisant <code>https://example.com/</code>
avec un serveur qui ne supporte pas HTTPS, ou le supporte, mais sur un
port non standard). Assurez-vous que vous vous connectez bien à un
serveur (virtuel) qui supporte SSL.</p>
<h3><a name="refused" id="refused">Pourquoi, lorsque je tente d'accéder en HTTPS à mon
serveur Apache+mod_ssl fraîchement installé, l'erreur ``Connection Refused''
s'affiche-t-elle ?</a></h3>
<p>Une configuration incorrecte peut provoquer ce type d'erreur.
Assurez-vous que vos directives <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> s'accordent avec vos directives
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>. Si
l'erreur persiste, recommencez depuis le début en restaurant la
configuration par défaut fournie par<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.</p>
<h3><a name="envvars" id="envvars">Pourquoi les variables <code>SSL_XXX</code>
ne sont-elles pas disponibles dans mes scripts CGI et SSI ?</a></h3>
<p>Assurez-vous que la directive ``<code>SSLOptions +StdEnvVars</code>'' est
bien présente dans le contexte de vos requêtes CGI/SSI.</p>
<h3><a name="relative" id="relative">Comment puis-je basculer entre les protocoles HTTP et
HTTPS dans les hyperliens relatifs ?</a></h3>
<p>Normalement, pour basculer entre HTTP et HTTPS, vous devez utiliser des
hyperliens pleinement qualifiés (car vous devez modifier le schéma de l'URL).
Cependant, à l'aide du module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, vous pouvez
manipuler des hyperliens relatifs, pour obtenir le même effet.</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^/(.*)_SSL$" "https://%{SERVER_NAME}/$1" [R,L]
RewriteRule "^/(.*)_NOSSL$" "http://%{SERVER_NAME}/$1" [R,L]</pre>
<p>Ce jeu de règles rewrite vous permet d'utiliser des hyperliens de la
forme <code><a href="document.html_SSL"></code> pour passer en HTTPS
dans les liens relatifs. (Remplacez SSL par NOSSL pour passer en HTTP.)</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="aboutcerts" id="aboutcerts">Certificats</a></h2>
<ul>
<li><a href="#keyscerts">Qu'est-ce qu'un clé privée RSA, un certificat,
une demande de signature de certificat (CSR) ?</a></li>
<li><a href="#startup">Y a-t-il une différence au démarrage entre un serveur
Apache non SSL et un serveur Apache supportant SSL ?</a></li>
<li><a href="#selfcert">Comment créer un certificat auto-signé SSL à des
fins de test ?</a></li>
<li><a href="#realcert">Comment créer un vrai certificat SSL ?</a></li>
<li><a href="#ownca">Comment créer et utiliser sa propre Autorité de
certification (CA) ?</a></li>
<li><a href="#passphrase">Comment modifier le mot de passe
de ma clé privée ?</a></li>
<li><a href="#removepassphrase">Comment démarrer Apache sans avoir à entrer de
mot de passe ?</a></li>
<li><a href="#verify">Comment vérifier si une clé privée correspond bien
à son certificat ?</a></li>
<li><a href="#pemder">Comment convertir un certificat du format PEM
au format DER ?</a></li>
<li><a href="#gid">Pourquoi les navigateurs se plaignent-ils de ne pas pouvoir
vérifier mon certificat de serveur ?</a></li>
</ul>
<h3><a name="keyscerts" id="keyscerts">Qu'est-ce qu'un clé privée RSA, un certificat,
une demande de signature de certificat (CSR) ?</a></h3>
<p>Un fichier de clé privée RSA est un fichier numérique que vous pouvez
utiliser pour déchiffrer des messages que l'on vous a envoyés. Il a son
pendant à caractère public que vous pouvez distribuer (par le biais de votre
certificat), ce qui permet aux utilisateurs de chiffrer les messages qu'ils
vous envoient.</p>
<p>Une Demande de Signature de Certificat (CSR) est un fichier numérique
qui contient votre clé publique et votre nom. La CSR doit être envoyée à
une Autorité de Certification (CA), qui va la convertir en vrai certificat
en la signant.</p>
<p>Un certificat contient votre clé publique RSA, votre nom, le nom
de la CA, et est signé numériquement par cette dernière. Les navigateurs
qui reconnaissent la CA peuvent vérifier la signature du certificat, et
ainsi en extraire votre clé publique RSA. Ceci leur permet de vous envoyer
des messages chiffrés que vous seul pourrez déchiffrer.</p>
<p>Se référer au chapitre <a href="ssl_intro.html">Introduction</a>
pour une description générale du protocole SSL.</p>
<h3><a name="startup" id="startup">Y a-t-il une différence au démarrage entre un serveur
Apache non SSL et un serveur Apache supportant SSL ?</a></h3>
<p>Oui. En général, avec ou sans <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> intégré, le démarrage
d'Apache ne présente pas de différences. Cependant, si votre fichier de clé
privée SSL possède un mot de passe, vous devrez le taper au démarrage
d'Apache.</p>
<p>Devoir entrer manuellement le mot de passe au démarrage du serveur peut
poser quelques problèmes - par exemple, quand le serveur est démarré au
moyen de scripts au lancement du système. Dans ce cas, vous pouvez suivre
les étapes <a href="#removepassphrase">ci-dessous</a> pour supprimer le
mot de passe de votre clé privée. Gardez à l'esprit qu'agir ainsi augmente
les risques de sécurité - agissez avec précaution !</p>
<h3><a name="selfcert" id="selfcert">Comment créer un certificat auto-signé SSL à des
fins de test ?</a></h3>
<ol>
<li>Vérifiez qu'OpenSSL est installé et l'exécutable openssl dans votre
<code>PATH</code>.<br />
<br />
</li>
<li>Exécuter la commande suivante pour créer les fichiers
<code>server.key</code> et <code>server.crt</code> :<br />
<code><strong>$ openssl req -new -x509 -nodes -out server.crt
-keyout server.key</strong></code><br />
Ces fichiers seront utilisés comme suit dans votre
<code>httpd.conf</code> :
<pre class="prettyprint lang-config">SSLCertificateFile "/path/to/this/server.crt"
SSLCertificateKeyFile "/path/to/this/server.key"</pre>
</li>
<li>Il est important de savoir que le fichier <code>server.key</code> n'a
<em>pas</em> de mot de passe. Pour ajouter un mot de passe à la clé, vous
devez exécuter la commande suivante et confirmer le mot de passe comme
demandé.<br />
<p><code><strong>$ openssl rsa -des3 -in server.key -out
server.key.new</strong></code><br />
<code><strong>$ mv server.key.new server.key</strong></code><br /></p>
Sauvegardez le fichier <code>server.key</code> ainsi que son mot de
passe en lieu sûr.
</li>
</ol>
<h3><a name="realcert" id="realcert">Comment créer un vrai certificat SSL ?</a></h3>
<p>Voici la marche à suivre pas à pas :</p>
<ol>
<li>Assurez-vous qu'OpenSSL est bien installé et dans votre <code>PATH</code>.
<br />
<br />
</li>
<li>Créez une clé privée RSA pour votre serveur Apache
(elle sera au format PEM et chiffrée en Triple-DES):<br />
<br />
<code><strong>$ openssl genrsa -des3 -out server.key 2048</strong></code><br />
<br />
Enregistrez le fichier <code>server.key</code> et le mot de passe
éventuellement défini en lieu sûr.
Vous pouvez afficher les détails de cette clé privée RSA à l'aide de la
commande :<br />
<br />
<code><strong>$ openssl rsa -noout -text -in server.key</strong></code><br />
<br />
Si nécessaire, vous pouvez aussi créer une version PEM non chiffrée
(non recommandé) de clé privée RSA avec :<br />
<br />
<code><strong>$ openssl rsa -in server.key -out server.key.unsecure</strong></code><br />
<br />
</li>
<li>Créez une Demande de signature de Certificat (CSR) à l'aide de la
clé privée précédemment générée (la sortie sera au format PEM):<br />
<br />
<code><strong>$ openssl req -new -key server.key -out server.csr</strong></code><br />
<br />
Vous devez entrer le Nom de Domaine Pleinement Qualifié
("Fully Qualified Domain Name" ou FQDN) de votre serveur lorsqu'OpenSSL
vous demande le "CommonName", c'est à dire que si vous générez une CSR
pour un site web auquel on accèdera par l'URL
<code>https://www.foo.dom/</code>, le FQDN sera "www.foo.dom". Vous
pouvez afficher les détails de ce CSR avec :<br />
<br />
<code><strong>$ openssl req -noout -text -in server.csr</strong></code><br />
<br />
</li>
<li>Vous devez maintenant envoyer la CSR à une Autorité de Certification
(CA), afin que cette dernière puisse la signer. Une fois la CSR signée,
vous disposerez d'un véritable certificat que vous pourrez utiliser avec
Apache. Vous pouvez faire signer votre CSR par une CA commerciale ou par
votre propre CA.<br />
Les CAs commerciales vous demandent en général de leur envoyer la CSR
par l'intermédiaire d'un formulaire web, de régler le montant de la
signature, puis vous envoient un certificat signé que vous pouvez
enregistrer dans un fichier server.crt.
Pour plus de détails sur la manière de créer sa propre CA, et de
l'utiliser pour signer une CSR, voir <a href="#ownca">ci-dessous</a>.<br />
Une fois la CSR signée, vous pouvez afficher les détails du certificat
comme suit :<br />
<br />
<code><strong>$ openssl x509 -noout -text -in server.crt</strong></code><br />
</li>
<li>Vous devez maintenant disposer de deux fichiers :
<code>server.key</code> et <code>server.crt</code>. Ils sont précisés dans
votre fichier <code>httpd.conf</code> comme suit :
<pre class="prettyprint lang-config">SSLCertificateFile "/path/to/this/server.crt"
SSLCertificateKeyFile "/path/to/this/server.key"</pre>
Le fichier <code>server.csr</code> n'est plus nécessaire.
</li>
</ol>
<h3><a name="ownca" id="ownca">Comment créer et utiliser sa propre Autorité de
certification (CA) ?</a></h3>
<p>La solution la plus simple consiste à utiliser les scripts
<code>CA.sh</code> ou <code>CA.pl</code> fournis avec OpenSSL. De
préférence, utilisez cette solution, à moins que vous ayez de bonnes
raisons de ne pas le faire. Dans ce dernier cas, vous pouvez créer un
certificat auto-signé comme suit :</p>
<ol>
<li>Créez une clé privée RSA pour votre serveur
(elle sera au format PEM et chiffrée en Triple-DES) :<br />
<br />
<code><strong>$ openssl genrsa -des3 -out server.key 2048</strong></code><br />
<br />
Sauvegardez le fichier <code>server.key</code> et le mot de passe
éventuellement défini en lieu sûr.
Vous pouvez afficher les détails de cette clé privée RSA à l'aide de la
commande :<br />
<br />
<code><strong>$ openssl rsa -noout -text -in server.key</strong></code><br />
<br />
Si nécessaire, vous pouvez aussi créer une version PEM non chiffrée
(non recommandé) de cette clé privée RSA avec :<br />
<br />
<code><strong>$ openssl rsa -in server.key -out server.key.unsecure</strong></code><br />
<br />
</li>
<li>Créez un certificat auto-signé (structure X509) à l'aide de la clé RSA
que vous venez de générer (la sortie sera au format PEM) :<br />
<br />
<code><strong>$ openssl req -new -x509 -nodes -sha1 -days 365
-key server.key -out server.crt -extensions usr_cert</strong></code><br />
<br />
Cette commande signe le certificat du serveur et produit un fichier
<code>server.crt</code>. Vous pouvez afficher les détails de ce
certificat avec :<br />
<br />
<code><strong>$ openssl x509 -noout -text -in server.crt</strong></code><br />
<br />
</li>
</ol>
<h3><a name="passphrase" id="passphrase">Comment modifier le mot de passe
de ma clé privée ?</a></h3>
<p>Vous devez simplement lire la clé avec l'ancien mot de passe et la
réécrire en spécifiant le nouveau mot de passe. Pour cela, vous pouvez
utiliser les commandes suivantes :</p>
<p><code><strong>$ openssl rsa -des3 -in server.key -out server.key.new</strong></code><br />
<code><strong>$ mv server.key.new server.key</strong></code><br /></p>
<p>La première fois qu'il vous est demandé un mot de passe PEM, vous
devez entrer l'ancien mot de passe. Ensuite, on vous demandera d'entrer
encore un mot de passe - cette fois, entrez le nouveau mot de passe. Si on
vous demande de vérifier le mot de passe, vous devrez entrer le nouveau
mot de passe une seconde fois.</p>
<h3><a name="removepassphrase" id="removepassphrase">Comment démarrer Apache sans avoir à entrer de
mot de passe ?</a></h3>
<p>L'apparition de ce dialogue au démarrage et à chaque redémarrage provient
du fait que la clé privée RSA contenue dans votre fichier server.key est
enregistrée sous forme chiffrée pour des raisons de sécurité. Le
déchiffrement de ce fichier nécessite un mot de passe, afin de pouvoir être
lu et interprété. Cependant, La suppression du mot de passe diminue le niveau de
sécurité du serveur - agissez avec précautions !</p>
<ol>
<li>Supprimer le chiffrement de la clé privée RSA (tout en conservant une
copie de sauvegarde du fichier original) :<br />
<br />
<code><strong>$ cp server.key server.key.org</strong></code><br />
<code><strong>$ openssl rsa -in server.key.org -out server.key</strong></code><br />
<br />
</li>
<li>Assurez-vous que le fichier server.key n'est lisible que par root :<br />
<br />
<code><strong>$ chmod 400 server.key</strong></code><br />
<br />
</li>
</ol>
<p>Maintenant, <code>server.key</code> contient une copie non chiffrée de
la clé. Si vous utilisez ce fichier pour votre serveur, il ne vous
demandera plus de mot de passe. CEPENDANT, si quelqu'un arrive à obtenir
cette clé, il sera en mesure d'usurper votre identité sur le réseau.
Vous DEVEZ par conséquent vous assurer que seuls root ou le serveur web
peuvent lire ce fichier (de préférence, démarrez le serveur web sous
root et faites le s'exécuter sous un autre utilisateur, en n'autorisant
la lecture de la clé que par root).</p>
<p>Une autre alternative consiste à utiliser la directive
``<code>SSLPassPhraseDialog exec:/chemin/vers/programme</code>''. Gardez
cependant à l'esprit que ce n'est bien entendu ni plus ni moins
sécurisé.</p>
<h3><a name="verify" id="verify">Comment vérifier si une clé privée correspond bien
à son certificat ?</a></h3>
<p>Une clé privée contient une série de nombres. Deux de ces nombres forment la
"clé publique", les autres appartiennent à la "clé privée". Les bits de la
"clé publique" sont inclus quand vous générez une CSR, et font par
conséquent partie du certificat associé.</p>
<p>Pour vérifier que la clé publique contenue dans votre certificat
correspond bien à la partie publique de votre clé privée, il vous suffit
de comparer ces nombres. Pour afficher le certificat et la clé,
utilisez cette commande :</p>
<p><code><strong>$ openssl x509 -noout -text -in server.crt</strong></code><br />
<code><strong>$ openssl rsa -noout -text -in server.key</strong></code></p>
<p>Les parties `modulus' et `public exponent' doivent être identiques dans
la clé et le certificat. Comme le `public exponent' est habituellement
65537, et comme il est difficile de vérifier visuellement que les nombreux
nombres du `modulus' sont identiques, vous pouvez utiliser l'approche
suivante :</p>
<p><code><strong>$ openssl x509 -noout -modulus -in server.crt | openssl md5</strong></code><br />
<code><strong>$ openssl rsa -noout -modulus -in server.key | openssl md5</strong></code></p>
<p>Il ne vous reste ainsi que deux nombres relativement courts à comparer.
Il est possible, en théorie que ces deux nombres soient les mêmes, sans que
les nombres du modulus soient identiques, mais les chances en sont infimes.</p>
<p>Si vous souhaitez vérifier à quelle clé ou certificat appartient une CSR
particulière, vous pouvez effectuer le même calcul
sur la CSR comme suit :</p>
<p><code><strong>$ openssl req -noout -modulus -in server.csr | openssl md5</strong></code></p>
<h3><a name="pemder" id="pemder">Comment convertir un certificat du format PEM
au format DER ?</a></h3>
<p>Le format des certificats par défaut pour OpenSSL est le format PEM,
qui est tout simplement un format DER codé en Base64, avec des lignes
d'en-têtes et des annotations. Certaines applications, comme
Microsoft Internet Explorer, ont besoin d'un certificat au format DER de base.
Vous pouvez convertir un fichier PEM <code>cert.pem</code> en son équivalent
au format DER <code>cert.der</code> à l'aide de la commande suivante :
<code><strong>$ openssl x509 -in cert.pem -out cert.der
-outform DER</strong></code></p>
<h3><a name="gid" id="gid">Pourquoi les navigateurs se plaignent-ils de ne pas pouvoir
vérifier mon certificat de serveur ?</a></h3>
<p>Ceci peut se produire si votre certificat de serveur est signé
par une autorité de certification intermédiaire. Plusieurs CAs,
comme Verisign ou Thawte, ont commencé à signer les certificats avec
des certificats intermédiaires au lieu de leur certificat racine.</p>
<p>Les certificats de CA intermédiaires se situe à un niveau
intermédiaire entre le certificat racine de la CA (qui est installé dans les
navigateurs) et le certificat du serveur (que vous avez installé sur
votre serveur). Pour que le navigateur puisse traverser et vérifier
la chaîne de confiance depuis le certificat du serveur jusqu'au
certificat racine, il faut lui fournir les certificats
intermédiaires. Les CAs devraient pouvoir fournir de tels
paquetages de certificats intermédiaires à installer sur les
serveurs.</p>
<p>Vous devez inclure ces certificats intermédiaires via la
directive <code class="directive"><a href="../mod/mod_ssl.html#sslcertificatechainfile">SSLCertificateChainFile</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="aboutssl" id="aboutssl">Le protocole SSL</a></h2>
<ul>
<li><a href="#random">Pourquoi de nombreuses et aléatoires erreurs de
protocole SSL apparaissent-elles en cas de forte charge du serveur ?</a></li>
<li><a href="#load">Pourquoi la charge de mon serveur est-elle plus
importante depuis qu'il sert des ressources chiffrées en SSL ?</a></li>
<li><a href="#establishing">Pourquoi les connexions en HTTPS à mon serveur
prennent-elles parfois jusqu'à 30 secondes pour s'établir ?</a></li>
<li><a href="#ciphers">Quels sont les algorithmes de chiffrement
supportés par mod_ssl ?</a></li>
<li><a href="#adh">Pourquoi une erreur ``no shared cipher'' apparaît-elle
quand j'essaie d'utiliser un algorithme de chiffrement
Diffie-Hellman anonyme (ADH) ?</a></li>
<li><a href="#sharedciphers">Pourquoi une erreur ``no shared cipher''
apparaît-elle lorsqu'on se connecte à mon serveur
fraîchement installé ?</a></li>
<li><a href="#vhosts">Pourquoi ne peut-on pas utiliser SSL avec des hôtes
virtuels identifiés par un nom et non par une adresse IP ?</a></li>
<li><a href="#vhosts2">Est-il possible d'utiliser
l'hébergement virtuel basé sur le nom d'hôte
pour différencier plusieurs hôtes virtuels ?</a></li>
<li><a href="#comp">Comment mettre en oeuvre la compression SSL ?</a></li>
<li><a href="#lockicon">Lorsque j'utilise l'authentification de base sur HTTPS,
l'icône de verrouillage des navigateurs Netscape reste ouverte quand la boîte
de dialogue d'authentification apparaît. Cela signifie-t-il que les utilisateur
et mot de passe sont envoyés en clair ?</a></li>
<li><a href="#msie">Pourquoi des erreurs d'entrée/sortie apparaissent-elles
lorsqu'on se connecte à un serveur Apache+mod_ssl avec
Microsoft Internet Explorer (MSIE) ?</a></li>
<li><a href="#srp">Comment activer TLS-SRP ?</a></li>
<li><a href="#javadh">Pourquoi des erreurs de négociation apparaissent
avec les clients basés sur Java lorsqu'on utilise un certificat de plus
de 1024 bits ?</a></li>
</ul>
<h3><a name="random" id="random">Pourquoi de nombreuses et aléatoires erreurs de
protocole SSL apparaissent-elles en cas de forte charge du serveur ?</a></h3>
<p>Ce problème peut avoir plusieurs causes, mais la principale réside dans le
cache de session SSL défini par la directive
<code class="directive"><a href="../mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code>. Le cache de session
DBM est souvent à la source du problème qui peut être résolu en utilisant le
cache de session SHM (ou en n'utilisant tout simplement pas de cache).</p>
<h3><a name="load" id="load">Pourquoi la charge de mon serveur est-elle plus
importante depuis qu'il sert des ressources chiffrées en SSL ?</a></h3>
<p>SSL utilise un procédé de chiffrement fort qui nécessite la manipulation
d'une quantité très importante de nombres. Lorsque vous effectuez une requête
pour une page web via HTTPS, tout (même les images) est chiffré avant d'être
transmis. C'est pourquoi un accroissement du traffic HTTPS entraîne une
augmentation de la charge.</p>
<h3><a name="establishing" id="establishing">Pourquoi les connexions en HTTPS à mon serveur
prennent-elles parfois jusqu'à 30 secondes pour s'établir ?</a></h3>
<p>Ce problème provient en général d'un périphérique <code>/dev/random</code>
qui bloque l'appel système read(2) jusqu'à ce que suffisamment d'entropie
soit disponible pour servir la requête. Pour plus d'information, se référer au
manuel de référence de la directive
<code class="directive"><a href="../mod/mod_ssl.html#sslrandomseed">SSLRandomSeed</a></code>.</p>
<h3><a name="ciphers" id="ciphers">Quels sont les algorithmes de chiffrement
supportés par mod_ssl ?</a></h3>
<p>En général, tous les algorithmes de chiffrement supportés par la version
d'OpenSSL installée, le sont aussi par <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>. La liste des
algorithmes disponibles peut dépendre de la manière dont vous avez installé
OpenSSL. Typiquement, au moins les algorithmes suivants sont supportés :</p>
<ol>
<li>RC4 avec SHA1</li>
<li>AES avec SHA1</li>
<li>Triple-DES avec SHA1</li>
</ol>
<p>Pour déterminer la liste réelle des algorithmes disponibles, vous
pouvez utiliser la commande suivante :</p>
<div class="example"><p><code>$ openssl ciphers -v</code></p></div>
<h3><a name="adh" id="adh">Pourquoi une erreur ``no shared cipher'' apparaît-elle
quand j'essaie d'utiliser un algorithme de chiffrement
Diffie-Hellman anonyme (ADH) ?</a></h3>
<p>Par défaut et pour des raisons de sécurité, OpenSSl ne permet <em>pas</em>
l'utilisation des algorithmes de chiffrements ADH. Veuillez vous informer
sur les effets pervers potentiels si vous choisissez d'activer le support
de ces algorithmes de chiffrements.</p>
<p>Pour pouvoir utiliser les algorithmes de chiffrements Diffie-Hellman
anonymes (ADH), vous devez compiler OpenSSL avec
``<code>-DSSL_ALLOW_ADH</code>'', puis ajouter ``<code>ADH</code>'' à votre
directive <code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code>.</p>
<h3><a name="sharedciphers" id="sharedciphers">Pourquoi une erreur ``no shared cipher''
apparaît-elle lorsqu'on se connecte à mon serveur
fraîchement installé ?</a></h3>
<p>Soit vous avez fait une erreur en définissant votre directive
<code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code> (comparez-la avec
l'exemple préconfiguré dans <code>extra/httpd-ssl.conf</code>), soit vous avez
choisi d'utiliser des algorithmes DSA/DH au lieu de RSA lorsque vous avez
généré votre clé privée, et avez ignoré ou êtes passé outre les
avertissements. Si vous avez choisi DSA/DH, votre serveur est incapable de
communiquer en utilisant des algorithmes de chiffrements SSL basés sur RSA
(du moins tant que vous n'aurez pas configuré une paire clé/certificat RSA
additionnelle). Les navigateurs modernes tels que NS ou IE ne peuvent
communiquer par SSL qu'avec des algorithmes RSA. C'est ce qui provoque l'erreur
"no shared ciphers". Pour la corriger, générez une nouvelle paire
clé/certificat pour le serveur en utilisant un algorithme de chiffrement
RSA.</p>
<h3><a name="vhosts" id="vhosts">Pourquoi ne peut-on pas utiliser SSL avec des hôtes
virtuels identifiés par un nom et non par une adresse IP ?</a></h3>
<p>La raison est très technique, et s'apparente au problème de la primauté de
l'oeuf ou de la poule. La couche du protocole SSL se trouve en dessous de la
couche de protocole HTTP qu'elle encapsule. Lors de l'établissement d'une
connexion SSL (HTTPS), Apache/mod_ssl doit négocier les paramètres du
protocole SSL avec le client. Pour cela, mod_ssl doit consulter la
configuration du serveur virtuel (par exemple, il doit accéder à la suite
d'algorithmes de chiffrement, au certificat du serveur, etc...). Mais afin de
sélectionner le bon serveur virtuel, Apache doit connaître le contenu du champ
d'en-tête HTTP <code>Host</code>. Pour cela, il doit lire l'en-tête de la
requête HTTP. Mais il ne peut le faire tant que la négociation SSL n'est pas
terminée, or, la phase de négociation SSL a besoin du nom d'hôte contenu
dans l'en-tête de la requête. Voir la question suivante pour
contourner ce problème.</p>
<p>Notez que si votre certificat comporte un nom de serveur avec
caractères génériques, ou des noms de serveurs multiples dans le
champ subjectAltName, vous pouvez utiliser SSL avec les serveurs
virtuels à base de noms sans avoir à contourner ce problème.</p>
<h3><a name="vhosts2" id="vhosts2">Est-il possible d'utiliser
l'hébergement virtuel basé sur le nom d'hôte
pour différencier plusieurs hôtes virtuels ?</a></h3>
<p>L'hébergement virtuel basé sur le nom est une méthode très populaire
d'identification des différents hôtes virtuels. Il permet d'utiliser la
même adresse IP et le même numéro de port pour de nombreux sites
différents. Lorsqu'on se tourne vers SSL, il semble tout naturel de penser
que l'on peut appliquer la même méthode pour gérer plusieurs hôtes
virtuels SSL sur le même serveur.</p>
<p>C'est possible, mais seulement si on utilise une version 2.2.12
ou supérieure du serveur web compilée avec OpenSSL
version 0.9.8j ou supérieure. Ceci est du au fait que
l'utilisation de l'hébergement virtuel à base de nom
avec SSL nécessite une fonctionnalité appelée
Indication du Nom de Serveur (Server Name Indication - SNI) que
seules les révisions les plus récentes de la
spécification SSL supportent.</p>
<p>Notez que si votre certificat comporte un nom de serveur avec
caractères génériques, ou des noms de serveurs multiples dans le
champ subjectAltName, vous pouvez utiliser SSL avec les serveurs
virtuels à base de noms sans avoir à contourner ce problème.</p>
<p>La raison en est que le protocole SSL constitue une couche séparée qui
encapsule le protocole HTTP. Aini, la session SSL nécessite une
transaction séparée qui prend place avant que la session HTTP n'ait débuté.
Le serveur reçoit une requête SSL sur l'adresse IP X et le port Y
(habituellement 443). Comme la requête SSL ne contenait aucun
en-tête Host:, le serveur n'avait aucun moyen de déterminer quel hôte virtuel SSL il
devait utiliser. En général, il utilisait le premier
qu'il trouvait et qui
correspondait à l'adresse IP et au port spécifiés.</p>
<p>Par contre, si vous utilisez des versions du serveur web et
d'OpenSSL qui supportent SNI, et si le navigateur du client le
supporte aussi, alors le nom d'hôte sera inclus dans la
requête SSL originale, et le serveur web pourra
sélectionner le bon serveur virtuel SSL.</p>
<p>Bien entendu, vous pouvez utiliser l'hébergement virtuel basé sur le nom
pour identifier de nombreux hôtes virtuels non-SSL
(tous sur le port 80 par exemple), et ne gérer qu'un seul hôte virtuel SSL
(sur le port 443). Mais dans ce cas, vous devez définir le numéro de port
non-SSL à l'aide de la directive NameVirtualHost dans ce style :</p>
<pre class="prettyprint lang-config">NameVirtualHost 192.168.1.1:80</pre>
<p>il existe d'autres solutions alternatives comme :</p>
<p>Utiliser des adresses IP différentes pour chaque hôte SSL.
Utiliser des numéros de port différents pour chaque hôte SSL.</p>
<h3><a name="comp" id="comp">Comment mettre en oeuvre la compression SSL ?</a></h3>
<p>Bien que la négociation pour la compression SSL ait été définie dans la
spécification de SSLv2 et TLS, ce n'est qu'en mai 2004 que la RFC 3749 a
défini DEFLATE comme une méthode de compression standard négociable.
</p>
<p>Depuis la version 0.9.8, OpenSSL supporte cette compression par défaut
lorsqu'il est compilé avec l'option <code>zlib</code>. Si le client et le
serveur supportent la compression, elle sera utilisée. Cependant, la
plupart des clients essaient encore de se connecter avec un Hello SSLv2.
Comme SSLv2 ne comportait pas de table des algorithmes de compression préférés
dans sa négociation, la compression ne peut pas être négociée avec ces clients.
Si le client désactive le support SSLv2, un Hello SSLv3 ou TLS peut être
envoyé, selon la bibliothèque SSL utilisée, et la compression peut être mise
en oeuvre. Vous pouvez vérifier si un client utilise la compression SSL en
journalisant la variable <code>%{SSL_COMPRESS_METHOD}x</code>.
</p>
<h3><a name="lockicon" id="lockicon">Lorsque j'utilise l'authentification de base sur HTTPS,
l'icône de verrouillage des navigateurs Netscape reste ouverte quand la boîte
de dialogue d'authentification apparaît. Cela signifie-t-il que les utilisateur
et mot de passe sont envoyés en clair ?</a></h3>
<p>Non, le couple utilisateur/mot de passe est transmis sous forme chiffrée.
L'icône de chiffrement dans les navigateurs Netscape n'est pas vraiment
synchronisé avec la couche SSL/TLS. Il ne passe à l'état verrouillé
qu'au moment où la première partie des données relatives à la page web
proprement dite sont transférées, ce qui peut prêter à confusion. Le
dispositif d'authentification de base appartient à la couche HTTP, qui
est située au dessus de la couche SSL/TLS dans HTTPS. Avant tout
transfert de données HTTP sous HTTPS, la couche SSL/TLS a déjà achevé
sa phase de négociation et basculé dans le mode de communication
chiffrée. Ne vous laissez donc pas abuser par l'état de cet icône.</p>
<h3><a name="msie" id="msie">Pourquoi des erreurs d'entrée/sortie apparaissent-elles
lorsqu'on se connecte via HTTPS à un serveur Apache+mod_ssl avec des
versions anciennes de
Microsoft Internet Explorer (MSIE) ?</a></h3>
<p>La première raison en est la présence dans l'implémentation SSL de
certaines versions de MSIE de bogues subtils en rapport avec le
dispositif de "maintien en vie" (keep-alive) HTTP, et les alertes de
notification de fermeture de session SSL en cas de coupure de la
connexion au point d'entrée (socket). De plus, l'interaction entre
SSL et les fonctionnalités HTTP/1.1 pose problème avec certaines
versions de MSIE. Vous pouvez contourner ces problèmes en interdisant
à Apache l'utilisation de HTTP/1.1, les connexions avec maintien en vie
ou l'envoi de messages de notification de fermeture de session SSL aux
clients MSIE. Pour cela, vous pouvez utiliser la directive suivante
dans votre section d'hôte virtuel avec support SSL :</p>
<pre class="prettyprint lang-config">SetEnvIf User-Agent "MSIE [2-5]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0</pre>
<p>En outre, certaines versions de MSIE ont des problèmes avec des
algorithmes de chiffrement particuliers. Hélas, il n'est pas
possible d'apporter une solution spécifique à MSIE pour ces
problèmes, car les algorithmes de chiffrement sont utilisés dès la
phase de négociation SSL. Ainsi, une directive
<code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> spécifique
à MSIE ne peut être d'aucun secours. Par contre, vous devrez
ajuster les paramètres généraux de manière drastique. Avant de
vous décider, soyez sûr que vos clients rencontrent vraiment des
problèmes. Dans la négative, n'effectuez pas ces ajustements car
ils affecteront <em>tous</em> vos clients, ceux utilisant MSIE,
mais aussi les autres.</p>
<h3><a name="srp" id="srp">Comment activer TLS-SRP ?</a></h3>
<p>Le protocole TLS-SRP (Echange de clés sécurisé par mot de passe
pour TLS comme spécifié dans la RFC 5054) peut compléter ou même
remplacer les certificats lors du processus d'authentification des
connexions SSL. Pour utiliser TLS-SRP, spécifiez un fichier de
vérification SRP OpenSSL via la directive <code class="directive"><a href="../mod/mod_ssl.html#sslsrpverifierfile">SSLSRPVerifierFile</a></code>. Vous pouvez créer
le fichier de vérification via l'utilitaire <code>openssl</code> :</p>
<div class="example"><p><code>
openssl srp -srpvfile passwd.srpv -add username
</code></p></div>
<p>Une fois ce fichier créé, vous devez le référencer dans la
configuration du serveur SSL :</p>
<div class="example"><p><code>
SSLSRPVerifierFile /path/to/passwd.srpv
</code></p></div>
<p>Pour forcer les clients à utiliser des algorithmes de chiffrement
basés sur TLS-SRP et s'affranchissant des certificats, utilisez la
directive suivante :</p>
<div class="example"><p><code>
SSLCipherSuite "!DSS:!aRSA:SRP"
</code></p></div>
<h3><a name="javadh" id="javadh">Pourquoi des erreurs de négociation apparaissent
avec les clients basés sur Java lorsqu'on utilise un certificat de plus
de 1024 bits ?</a></h3>
<p>Depuis la version 2.4.7,
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> utilise des paramètres DH qui comportent
des nombres premiers de plus de 1024 bits. Cependant, java 7 et ses versions
antérieures ne supportent que les nombres premiers DH d'une longueur
maximale de 1024 bits.</p>
<p>Si votre client basé sur Java s'arrête avec une exception telle
que <code>java.lang.RuntimeException: Could not generate DH
keypair</code> et
<code>java.security.InvalidAlgorithmParameterException: Prime size
must be multiple of 64, and can only range from 512 to 1024
(inclusive)</code>, et si httpd enregistre le message <code>tlsv1
alert internal error (SSL alert number 80)</code> dans son journal
des erreurs (avec un <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code>
<code>info</code> ou supérieur), vous pouvez soit réarranger la
liste d'algorithmes de mod_ssl via la directive <code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code> (éventuellement en
conjonction avec la directive <code class="directive"><a href="../mod/mod_ssl.html#sslhonorcipherorder">SSLHonorCipherOrder</a></code>), soit utiliser des
paramètres DH personnalisés avec un nombre
premier de 1024 bits, paramètres qui seront toujours prioritaires
par rapport à tout autre paramètre DH par défaut.</p>
<p>Pour générer des paramètres DH personnalisés, utilisez la
commande <code>openssl dhparam 1024</code>. Vous pouvez aussi
utiliser les
paramètres DH standards issus de la <a href="http://www.ietf.org/rfc/rfc2409.txt">RFC 2409</a>, section 6.2 :</p>
<div class="example"><pre>-----BEGIN DH PARAMETERS-----
MIGHAoGBAP//////////yQ/aoiFowjTExmKLgNwc0SkCTgiKZ8x0Agu+pjsTmyJR
Sgh5jjQE3e+VGbPNOkMbMCsKbfJfFDdP4TVtbVHCReSFtXZiXn7G9ExC6aY37WsL
/1y29Aa37e44a/taiZ+lrp8kEXxLH+ZJKGZR7OZTgf//////////AgEC
-----END DH PARAMETERS-----</pre></div>
<p>Ajoute les paramètres personnalisés incluant les lignes "BEGIN DH
PARAMETERS" et "END DH PARAMETERS" à la fin du premier fichier de
certificat défini via la directive <code class="directive"><a href="../mod/mod_ssl.html#sslcertificatefile">SSLCertificateFile</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="support" id="support">Support de mod_ssl</a></h2>
<ul>
<li><a href="#resources">Quelles sont les sources d'informations
disponibles en cas de problème avec mod_ssl ?</a></li>
<li><a href="#contact">Qui peut-on contacter pour un support en cas de
problème avec mod_ssl ?</a></li>
<li><a href="#reportdetails">Quelles informations dois-je fournir lors
de l'écriture d'un rapport de bogue ?</a></li>
<li><a href="#coredumphelp">Un vidage mémoire s'est produit,
pouvez-vous m'aider ?</a></li>
<li><a href="#backtrace">Comment puis-je obtenir une journalisation de
ce qui s'est passé, pour m'aider à trouver la raison de ce vidage
mémoire ?</a></li>
</ul>
<h3><a name="resources" id="resources">Quelles sont les sources d'informations
disponibles en cas de problème avec mod_ssl ?</a></h3>
<p>Voici les sources d'informations disponibles ; vous devez chercher
ici en cas de problème.</p>
<dl>
<dt>Vous trouverez des réponses dans la Foire Aux Questions du
manuel utilisateur (ce document)</dt>
<dd><a href="http://httpd.apache.org/docs/2.4/ssl/ssl_faq.html">
http://httpd.apache.org/docs/2.4/ssl/ssl_faq.html</a><br />
Cherchez tout d'abord dans la foire aux questions
(ce document). Si votre question est courante, on a déjà dû y
répondre de nombreuses fois, et elle fait probablement partie
de ce document.
</dd>
</dl>
<h3><a name="contact" id="contact">Qui peut-on contacter pour un support en cas de
problème avec mod_ssl ?</a></h3>
<p>Voici toutes les possibilités de support pour mod_ssl, par ordre
de préférence. Merci d'utiliser ces possibilités
<em>dans cet ordre</em> - ne vous précipitez pas sur celle qui vous
paraît la plus alléchante. </p>
<ol>
<li><em>Envoyez un rapport de problème à la liste de diffusion de
support des utilisateurs d'Apache httpd</em><br />
<a href="mailto:users@httpd.apache.org">
users@httpd.apache.org</a><br />
C'est la deuxième manière de soumettre votre rapport de
problème. Ici aussi, vous devez d'abord vous abonner à la
liste, mais vous pourrez ensuite discuter facilement de votre
problème avec l'ensemble de la communauté d'utilisateurs
d'Apache httpd.
</li>
<li><em>Ecrire un rapport de problème dans la base de données des
bogues</em><br />
<a href="http://httpd.apache.org/bug_report.html">
http://httpd.apache.org/bug_report.html</a><br />
C'est la dernière manière de soumettre votre rapport de
problème. Vous ne devez utiliser cette solution que si vous
avez déjà écrit aux listes de diffusion, et n'avez pas trouvé
de solution. Merci de suivre les instructions de la page
mentionnée ci-dessus <em>avec soin</em>.
</li>
</ol>
<h3><a name="reportdetails" id="reportdetails">Quelles informations dois-je fournir lors
de l'écriture d'un rapport de bogue ?</a></h3>
<p>Vous devez toujours fournir au moins les informations
suivantes :</p>
<dl>
<dt>Les versions d'Apache httpd et OpenSSL installées</dt>
<dd>La version d'Apache peut être déterminée en exécutant
<code>httpd -v</code>. La version d'OpenSSL peut être déterminée
en exécutant <code>openssl version</code>. Si Lynx est installé,
vous pouvez aussi exécuter la commande<code>lynx -mime_header
http://localhost/ | grep Server</code> et ainsi obtenir ces
informations en une seule fois.
</dd>
<dt>Les détails de votre installation d'Apache httpd et OpenSSL</dt>
<dd>A cet effet, vous pouvez fournir un fichier journal de votre
session de terminal qui montre les étapes de la configuration et
de l'installation. En cas d'impossibilité, vous devez au moins
fournir la ligne de commande <code class="program"><a href="../programs/configure.html">configure</a></code> que
vous avez utilisée.
</dd>
<dt>En cas de vidage mémoire, inclure une trace de ce qui s'est
passé</dt>
<dd>Si votre serveur Apache httpd fait un vidage de sa
mémoire, merci de fournir en pièce jointe un fichier contenant
une trace de la zone dédiée à la pile (voir
<a href="#backtrace">ci-dessous</a> pour des informations sur la manière
de l'obtenir). Il est nécessaire de disposer de ces informations
afin de pouvoir déterminer la raison de votre vidage mémoire.
</dd>
<dt>Une description détaillée de votre problème</dt>
<dd>Ne riez pas, nous sommes sérieux ! De nombreux rapports
n'incluent pas de description de la véritable nature du problème.
Sans ces informations, il est très difficile pour quiconque de
vous aider. Donc, et c'est votre propre intérêt (vous souhaitez
que le problème soit résolu, n'est-ce pas ?), fournissez, s'il vous
plait, le maximum de détails possible. Bien entendu, vous devez
aussi inclure tout ce qui a été dit précédemment.
</dd>
</dl>
<h3><a name="coredumphelp" id="coredumphelp">Un vidage mémoire s'est produit,
pouvez-vous m'aider ?</a></h3>
<p>En général non, du moins tant que vous n'aurez pas fourni plus de
détails à propos de la localisation dans le code où Apache a effectué
son vidage mémoire. Ce dont nous avons en général besoin pour vous
aider est une trace de ce qui s'est passé (voir la question suivante).
Sans cette information, il est pratiquement impossible de déterminer
la nature du problème et de vous aider à le résoudre.</p>
<h3><a name="backtrace" id="backtrace">Comment puis-je obtenir une journalisation de
ce qui s'est passé, pour m'aider à trouver la raison de ce vidage
mémoire ?</a></h3>
<p>Vous trouverez ci-dessous les différentes étapes permettant
d'obtenir une journalisation des évènements (backtrace) :</p>
<ol>
<li>Assurez-vous que les symboles de débogage sont disponibles, au
moins pour Apache. Pour cela, sur les plates-formes où GCC/GDB est
utilisé, vous devez compiler Apache+mod_ssl avec l'option
``<code>OPTIM="-g -ggdb3"</code>''. Sur les autres plates-formes,
l'option ``<code>OPTIM="-g"</code>'' est un minimum.
</li>
<li>Démarrez le serveur et essayez de reproduire le vidage mémoire.
A cet effet, vous pouvez utiliser une directive du style
``<code>CoreDumpDirectory /tmp</code>'' pour être sûr que le
fichier de vidage mémoire puisse bien être écrit. Vous devriez
obtenir un fichier <code>/tmp/core</code> ou
<code>/tmp/httpd.core</code>. Si ce n'est pas le cas, essayez de
lancer votre serveur sous un UID autre que root.
Pour des raisons de sécurité, de nombreux
noyaux modernes de permettent pas à un processus de vider sa
mémoire une fois qu'il a accompli un <code>setuid()</code> (à moins
qu'il effectue un <code>exec()</code>) car des informations d'un
niveau privilégié pourraient être transmises en mémoire. Si
nécessaire, vous pouvez exécuter <code>/chemin/vers/httpd -X</code>
manuellement afin de ne pas permettre à Apache de se clôner (fork).
</li>
<li>Analysez le vidage mémoire. Pour cela, exécutez
<code>gdb /path/to/httpd /tmp/httpd.core</code> ou une commande
similaire. Dans GDB, tout ce que vous avez à faire est d'entrer
<code>bt</code>, et voila, vous obtenez la backtrace. Pour les
débogueurs autres que GDB consulter le manuel correspondant.
</li>
</ol>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/ssl/ssl_faq.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/ssl_faq.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/ssl/ssl_faq.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/ssl_compat.html.en 0000664 0001751 0001751 00000052363 14737241666 021314 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>SSL/TLS Strong Encryption: Compatibility - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">SSL/TLS</a></div><div id="page-content"><div id="preamble"><h1>SSL/TLS Strong Encryption: Compatibility</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/ssl/ssl_compat.html" title="English"> en </a> |
<a href="../fr/ssl/ssl_compat.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>
This page covers backwards compatibility between mod_ssl and other
SSL solutions. mod_ssl is not the only SSL solution for Apache; four
additional products are (or were) also available: Ben Laurie's freely
available <a href="http://www.apache-ssl.org/">Apache-SSL</a> (from
where mod_ssl were originally derived in 1998), Red Hat's commercial
Secure Web Server (which was based on mod_ssl), Covalent's commercial
Raven SSL Module (also based on
mod_ssl) and finally C2Net's (now Red Hat's) commercial product <a href="http://www.redhat.com/explore/stronghold/">Stronghold</a> (based
on a different evolution branch, named Sioux up to Stronghold 2.x, and
based on mod_ssl since Stronghold 3.x).</p>
<p>
mod_ssl mostly provides a superset of the functionality of all the other
solutions, so it's simple to migrate from one of the older modules to
mod_ssl. The configuration directives and environment variable names
used by the older SSL solutions vary from those used in mod_ssl;
mapping tables are included here to give the equivalents used by mod_ssl.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#configuration">Configuration Directives</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#variables">Environment Variables</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#customlog">Custom Log Functions</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="configuration" id="configuration">Configuration Directives</a></h2>
<p>The mapping between configuration directives used by Apache-SSL
1.x and mod_ssl 2.0.x is given in <a href="#table1">Table
1</a>. The mapping from Sioux 1.x and Stronghold 2.x is only partial
because of special functionality in these interfaces which mod_ssl
doesn't provide.</p>
<h3><a name="table1" id="table1">Table 1: Configuration Directive Mapping</a></h3>
<table><tr class="header"><th>Old Directive</th><th>mod_ssl Directive</th><th>Comment</th></tr>
<tr class="header"><th colspan="3">Apache-SSL 1.x & mod_ssl 2.0.x compatibility:</th></tr>
<tr><td><code>SSLEnable</code></td><td><code>SSLEngine on</code></td><td>compactified</td></tr>
<tr class="odd"><td><code>SSLDisable</code></td><td><code>SSLEngine off</code></td><td>compactified</td></tr>
<tr><td><code>SSLLogFile</code> <em>file</em></td><td><code /></td><td>Use per-module <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> setting instead.</td></tr>
<tr class="odd"><td><code>SSLRequiredCiphers</code> <em>spec</em></td><td><code>SSLCipherSuite</code> <em>spec</em></td><td>renamed</td></tr>
<tr><td><code>SSLRequireCipher</code> <em>c1</em> ...</td><td><code>SSLRequire %{SSL_CIPHER} in {"</code><em>c1</em><code>",
...}</code></td><td>generalized</td></tr>
<tr class="odd"><td><code>SSLBanCipher</code> <em>c1</em> ...</td><td><code>SSLRequire not (%{SSL_CIPHER} in {"</code><em>c1</em><code>",
...})</code></td><td>generalized</td></tr>
<tr><td><code>SSLFakeBasicAuth</code></td><td><code>SSLOptions +FakeBasicAuth</code></td><td>merged</td></tr>
<tr class="odd"><td><code>SSLCacheServerPath</code> <em>dir</em></td><td>-</td><td>functionality removed</td></tr>
<tr><td><code>SSLCacheServerPort</code> <em>integer</em></td><td>-</td><td>functionality removed</td></tr>
<tr class="header"><th colspan="3">Apache-SSL 1.x compatibility:</th></tr>
<tr class="odd"><td><code>SSLExportClientCertificates</code></td><td><code>SSLOptions +ExportCertData</code></td><td>merged</td></tr>
<tr><td><code>SSLCacheServerRunDir</code> <em>dir</em></td><td>-</td><td>functionality not supported</td></tr>
<tr class="header"><th colspan="3">Sioux 1.x compatibility:</th></tr>
<tr class="odd"><td><code>SSL_CertFile</code> <em>file</em></td><td><code>SSLCertificateFile</code> <em>file</em></td><td>renamed</td></tr>
<tr><td><code>SSL_KeyFile</code> <em>file</em></td><td><code>SSLCertificateKeyFile</code> <em>file</em></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_CipherSuite</code> <em>arg</em></td><td><code>SSLCipherSuite</code> <em>arg</em></td><td>renamed</td></tr>
<tr><td><code>SSL_X509VerifyDir</code> <em>arg</em></td><td><code>SSLCACertificatePath</code> <em>arg</em></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_Log</code> <em>file</em></td><td><code>-</code></td><td>Use per-module <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> setting instead.</td></tr>
<tr><td><code>SSL_Connect</code> <em>flag</em></td><td><code>SSLEngine</code> <em>flag</em></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_ClientAuth</code> <em>arg</em></td><td><code>SSLVerifyClient</code> <em>arg</em></td><td>renamed</td></tr>
<tr><td><code>SSL_X509VerifyDepth</code> <em>arg</em></td><td><code>SSLVerifyDepth</code> <em>arg</em></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_FetchKeyPhraseFrom</code> <em>arg</em></td><td>-</td><td>not directly mappable; use SSLPassPhraseDialog</td></tr>
<tr><td><code>SSL_SessionDir</code> <em>dir</em></td><td>-</td><td>not directly mappable; use SSLSessionCache</td></tr>
<tr class="odd"><td><code>SSL_Require</code> <em>expr</em></td><td>-</td><td>not directly mappable; use SSLRequire</td></tr>
<tr><td><code>SSL_CertFileType</code> <em>arg</em></td><td>-</td><td>functionality not supported</td></tr>
<tr class="odd"><td><code>SSL_KeyFileType</code> <em>arg</em></td><td>-</td><td>functionality not supported</td></tr>
<tr><td><code>SSL_X509VerifyPolicy</code> <em>arg</em></td><td>-</td><td>functionality not supported</td></tr>
<tr class="odd"><td><code>SSL_LogX509Attributes</code> <em>arg</em></td><td>-</td><td>functionality not supported</td></tr>
<tr class="header"><th colspan="3">Stronghold 2.x compatibility:</th></tr>
<tr><td><code>StrongholdAccelerator</code> <em>engine</em></td><td><code>SSLCryptoDevice</code> <em>engine</em></td><td>renamed</td></tr>
<tr class="odd"><td><code>StrongholdKey</code> <em>dir</em></td><td>-</td><td>functionality not needed</td></tr>
<tr><td><code>StrongholdLicenseFile</code> <em>dir</em></td><td>-</td><td>functionality not needed</td></tr>
<tr class="odd"><td><code>SSLFlag</code> <em>flag</em></td><td><code>SSLEngine</code> <em>flag</em></td><td>renamed</td></tr>
<tr><td><code>SSLSessionLockFile</code> <em>file</em></td><td><code>SSLMutex</code> <em>file</em></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSLCipherList</code> <em>spec</em></td><td><code>SSLCipherSuite</code> <em>spec</em></td><td>renamed</td></tr>
<tr><td><code>RequireSSL</code></td><td><code>SSLRequireSSL</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSLErrorFile</code> <em>file</em></td><td>-</td><td>functionality not supported</td></tr>
<tr><td><code>SSLRoot</code> <em>dir</em></td><td>-</td><td>functionality not supported</td></tr>
<tr class="odd"><td><code>SSL_CertificateLogDir</code> <em>dir</em></td><td>-</td><td>functionality not supported</td></tr>
<tr><td><code>AuthCertDir</code> <em>dir</em></td><td>-</td><td>functionality not supported</td></tr>
<tr class="odd"><td><code>SSL_Group</code> <em>name</em></td><td>-</td><td>functionality not supported</td></tr>
<tr><td><code>SSLProxyMachineCertPath</code> <em>dir</em></td><td><code>SSLProxyMachineCertificatePath</code> <em>dir</em></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSLProxyMachineCertFile</code> <em>file</em></td><td><code>SSLProxyMachineCertificateFile</code> <em>file</em></td><td>renamed</td></tr>
<tr><td><code>SSLProxyCipherList</code> <em>spec</em></td><td><code>SSLProxyCipherSpec</code> <em>spec</em></td><td>renamed</td></tr>
</table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="variables" id="variables">Environment Variables</a></h2>
<p>The mapping between environment variable names used by the older
SSL solutions and the names used by mod_ssl is given in <a href="#table2">Table 2</a>.</p>
<h3><a name="table2" id="table2">Table 2: Environment Variable Derivation</a></h3>
<table><tr class="header"><th>Old Variable</th><th>mod_ssl Variable</th><th>Comment</th></tr>
<tr><td><code>SSL_PROTOCOL_VERSION</code></td><td><code>SSL_PROTOCOL</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSLEAY_VERSION</code></td><td><code>SSL_VERSION_LIBRARY</code></td><td>renamed</td></tr>
<tr><td><code>HTTPS_SECRETKEYSIZE</code></td><td><code>SSL_CIPHER_USEKEYSIZE</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>HTTPS_KEYSIZE</code></td><td><code>SSL_CIPHER_ALGKEYSIZE</code></td><td>renamed</td></tr>
<tr><td><code>HTTPS_CIPHER</code></td><td><code>SSL_CIPHER</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>HTTPS_EXPORT</code></td><td><code>SSL_CIPHER_EXPORT</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SERVER_KEY_SIZE</code></td><td><code>SSL_CIPHER_ALGKEYSIZE</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SERVER_CERTIFICATE</code></td><td><code>SSL_SERVER_CERT</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SERVER_CERT_START</code></td><td><code>SSL_SERVER_V_START</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SERVER_CERT_END</code></td><td><code>SSL_SERVER_V_END</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SERVER_CERT_SERIAL</code></td><td><code>SSL_SERVER_M_SERIAL</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SERVER_SIGNATURE_ALGORITHM</code></td><td><code>SSL_SERVER_A_SIG</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SERVER_DN</code></td><td><code>SSL_SERVER_S_DN</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SERVER_CN</code></td><td><code>SSL_SERVER_S_DN_CN</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SERVER_EMAIL</code></td><td><code>SSL_SERVER_S_DN_Email</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SERVER_O</code></td><td><code>SSL_SERVER_S_DN_O</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SERVER_OU</code></td><td><code>SSL_SERVER_S_DN_OU</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SERVER_C</code></td><td><code>SSL_SERVER_S_DN_C</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SERVER_SP</code></td><td><code>SSL_SERVER_S_DN_SP</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SERVER_L</code></td><td><code>SSL_SERVER_S_DN_L</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SERVER_IDN</code></td><td><code>SSL_SERVER_I_DN</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SERVER_ICN</code></td><td><code>SSL_SERVER_I_DN_CN</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SERVER_IEMAIL</code></td><td><code>SSL_SERVER_I_DN_Email</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SERVER_IO</code></td><td><code>SSL_SERVER_I_DN_O</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SERVER_IOU</code></td><td><code>SSL_SERVER_I_DN_OU</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SERVER_IC</code></td><td><code>SSL_SERVER_I_DN_C</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SERVER_ISP</code></td><td><code>SSL_SERVER_I_DN_SP</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SERVER_IL</code></td><td><code>SSL_SERVER_I_DN_L</code></td><td>renamed</td></tr>
<tr><td><code>SSL_CLIENT_CERTIFICATE</code></td><td><code>SSL_CLIENT_CERT</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_CERT_START</code></td><td><code>SSL_CLIENT_V_START</code></td><td>renamed</td></tr>
<tr><td><code>SSL_CLIENT_CERT_END</code></td><td><code>SSL_CLIENT_V_END</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_CERT_SERIAL</code></td><td><code>SSL_CLIENT_M_SERIAL</code></td><td>renamed</td></tr>
<tr><td><code>SSL_CLIENT_SIGNATURE_ALGORITHM</code></td><td><code>SSL_CLIENT_A_SIG</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_DN</code></td><td><code>SSL_CLIENT_S_DN</code></td><td>renamed</td></tr>
<tr><td><code>SSL_CLIENT_CN</code></td><td><code>SSL_CLIENT_S_DN_CN</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_EMAIL</code></td><td><code>SSL_CLIENT_S_DN_Email</code></td><td>renamed</td></tr>
<tr><td><code>SSL_CLIENT_O</code></td><td><code>SSL_CLIENT_S_DN_O</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_OU</code></td><td><code>SSL_CLIENT_S_DN_OU</code></td><td>renamed</td></tr>
<tr><td><code>SSL_CLIENT_C</code></td><td><code>SSL_CLIENT_S_DN_C</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_SP</code></td><td><code>SSL_CLIENT_S_DN_SP</code></td><td>renamed</td></tr>
<tr><td><code>SSL_CLIENT_L</code></td><td><code>SSL_CLIENT_S_DN_L</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_IDN</code></td><td><code>SSL_CLIENT_I_DN</code></td><td>renamed</td></tr>
<tr><td><code>SSL_CLIENT_ICN</code></td><td><code>SSL_CLIENT_I_DN_CN</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_IEMAIL</code></td><td><code>SSL_CLIENT_I_DN_Email</code></td><td>renamed</td></tr>
<tr><td><code>SSL_CLIENT_IO</code></td><td><code>SSL_CLIENT_I_DN_O</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_IOU</code></td><td><code>SSL_CLIENT_I_DN_OU</code></td><td>renamed</td></tr>
<tr><td><code>SSL_CLIENT_IC</code></td><td><code>SSL_CLIENT_I_DN_C</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_ISP</code></td><td><code>SSL_CLIENT_I_DN_SP</code></td><td>renamed</td></tr>
<tr><td><code>SSL_CLIENT_IL</code></td><td><code>SSL_CLIENT_I_DN_L</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_EXPORT</code></td><td><code>SSL_CIPHER_EXPORT</code></td><td>renamed</td></tr>
<tr><td><code>SSL_KEYSIZE</code></td><td><code>SSL_CIPHER_ALGKEYSIZE</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_SECKEYSIZE</code></td><td><code>SSL_CIPHER_USEKEYSIZE</code></td><td>renamed</td></tr>
<tr><td><code>SSL_SSLEAY_VERSION</code></td><td><code>SSL_VERSION_LIBRARY</code></td><td>renamed</td></tr>
<tr class="odd"><td><code>SSL_STRONG_CRYPTO</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
<tr><td><code>SSL_SERVER_KEY_EXP</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
<tr class="odd"><td><code>SSL_SERVER_KEY_ALGORITHM</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
<tr><td><code>SSL_SERVER_KEY_SIZE</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
<tr class="odd"><td><code>SSL_SERVER_SESSIONDIR</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
<tr><td><code>SSL_SERVER_CERTIFICATELOGDIR</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
<tr class="odd"><td><code>SSL_SERVER_CERTFILE</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
<tr><td><code>SSL_SERVER_KEYFILE</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
<tr class="odd"><td><code>SSL_SERVER_KEYFILETYPE</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
<tr><td><code>SSL_CLIENT_KEY_EXP</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_KEY_ALGORITHM</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
<tr><td><code>SSL_CLIENT_KEY_SIZE</code></td><td><code>-</code></td><td>Not supported by mod_ssl</td></tr>
</table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="customlog" id="customlog">Custom Log Functions</a></h2>
<p>
When mod_ssl is enabled, additional functions exist for the <a href="../mod/mod_log_config.html#formats">Custom Log Format</a> of
<code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> as documented in the Reference
Chapter. Beside the ``<code>%{</code><em>varname</em><code>}x</code>''
eXtension format function which can be used to expand any variables provided
by any module, an additional Cryptography
``<code>%{</code><em>name</em><code>}c</code>'' cryptography format function
exists for backward compatibility. The currently implemented function calls
are listed in <a href="#table3">Table 3</a>.</p>
<h3><a name="table3" id="table3">Table 3: Custom Log Cryptography Function</a></h3>
<table>
<tr><th>Function Call</th><th>Description</th></tr>
<tr><td><code>%...{version}c</code></td> <td>SSL protocol version</td></tr>
<tr><td><code>%...{cipher}c</code></td> <td>SSL cipher</td></tr>
<tr><td><code>%...{subjectdn}c</code></td> <td>Client Certificate Subject Distinguished Name</td></tr>
<tr><td><code>%...{issuerdn}c</code></td> <td>Client Certificate Issuer Distinguished Name</td></tr>
<tr><td><code>%...{errcode}c</code></td> <td>Certificate Verification Error (numerical)</td></tr>
<tr><td><code>%...{errstr}c</code></td> <td>Certificate Verification Error (string)</td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/ssl/ssl_compat.html" title="English"> en </a> |
<a href="../fr/ssl/ssl_compat.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/ssl/ssl_compat.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/index.html 0000664 0001751 0001751 00000000716 13710016232 017624 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: index.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: index.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: index.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: index.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
URI: index.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/ssl/ssl_compat.html.fr.utf8 0000664 0001751 0001751 00000054160 14740503670 022171 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Chiffrement fort SSL/TLS : Compatibilité - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">SSL/TLS</a></div><div id="page-content"><div id="preamble"><h1>Chiffrement fort SSL/TLS : Compatibilité</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/ssl/ssl_compat.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/ssl_compat.html" title="Français"> fr </a></p>
</div>
<p>Ce document couvre la compatibilité ascendante entre mod_ssl et
d'autres solutions SSL. mod_ssl n'est pas la seule solution SSL pour Apache ;
quatre autres produits sont (ou ont été) également disponibles :
<a href="http://www.apache-ssl.org/">Apache-SSL</a>, le produit libre de
Ben Laurie (d'où mod_ssl est issu à l'origine en 1998), Secure
Web Server, un produit commercial de Red Hat (basé sur mod_ssl),
Raven SSL Module, un produit commercial
de Covalent (basé lui aussi sur mod_ssl), et enfin <a href="http://www.redhat.com/explore/stronghold/">Stronghold</a>, produit
commercial de C2Net et maintenant de Red Hat, (basé sur une branche
d'évolution différente appelée Sioux jusqu'à Stronghold 2.x et basé sur
mod_ssl depuis Stronghold 3.x).</p>
<p>En plus de ses fonctionnalités propres, mod_ssl rassemble la plupart de
celles des autres solutions SSL, si bien qu'il est très simple de
migrer depuis un module plus ancien vers mod_ssl. Les directives de
configuration et les noms des variables d'environnement utilisés par les
solutions SSL plus anciennes diffèrent de ceux qu'utilise mod_ssl ;
les tableaux de correspondance ci-dessous fournissent les équivalences
de termes utilisés par mod_ssl.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#configuration">Directives de configuration</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#variables">Variables d'environnement</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#customlog">Fonctions de personnalisation des journaux</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="configuration" id="configuration">Directives de configuration</a></h2>
<p>La correspondance entre les directives de configuration qu'utilise
Apache-SSL 1.x et mod_ssl 2.0.x est fournie dans le <a href="#table1">Tableau
1</a>. La correspondance depuis Sioux 1.x et Stronghold 2.x n'est que
partielle car certaines fonctionnalités de ces interfaces ne sont pas
supportées par mod_ssl.</p>
<h3><a name="table1" id="table1">Tableau 1: Correspondance entre les directives de configuration</a></h3>
<table><tr class="header"><th>Ancienne directive</th><th>Directive mod_ssl</th><th>Commentaires</th></tr>
<tr class="header"><th colspan="3">Compatibilité entre Apache-SSL 1.x et mod_ssl 2.0.x :</th></tr>
<tr><td><code>SSLEnable</code></td><td><code>SSLEngine on</code></td><td>plus compacte</td></tr>
<tr class="odd"><td><code>SSLDisable</code></td><td><code>SSLEngine off</code></td><td>plus compacte</td></tr>
<tr><td><code>SSLLogFile</code>
<em>file</em></td><td><code /></td><td>Utilisez plutôt la directive
de niveau module <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code>.</td></tr>
<tr class="odd"><td><code>SSLRequiredCiphers</code> <em>spec</em></td><td><code>SSLCipherSuite</code> <em>spec</em></td><td>renommée</td></tr>
<tr><td><code>SSLRequireCipher</code> <em>c1</em> ...</td><td><code>SSLRequire %{SSL_CIPHER} in {"</code><em>c1</em><code>",
...}</code></td><td>plus générale</td></tr>
<tr class="odd"><td><code>SSLBanCipher</code> <em>c1</em> ...</td><td><code>SSLRequire not (%{SSL_CIPHER} in {"</code><em>c1</em><code>",
...})</code></td><td>plus générale</td></tr>
<tr><td><code>SSLFakeBasicAuth</code></td><td><code>SSLOptions +FakeBasicAuth</code></td><td>rassemblées</td></tr>
<tr class="odd"><td><code>SSLCacheServerPath</code> <em>dir</em></td><td>-</td><td>fonctionnalité supprimée</td></tr>
<tr><td><code>SSLCacheServerPort</code> <em>integer</em></td><td>-</td><td>fonctionnalité supprimée</td></tr>
<tr class="header"><th colspan="3">Compatibilité avec Apache-SSL 1.x :</th></tr>
<tr class="odd"><td><code>SSLExportClientCertificates</code></td><td><code>SSLOptions +ExportCertData</code></td><td>rassemblées</td></tr>
<tr><td><code>SSLCacheServerRunDir</code> <em>dir</em></td><td>-</td><td>fonctionnalité non supportée</td></tr>
<tr class="header"><th colspan="3">Compatibilité avec Sioux 1.x :</th></tr>
<tr class="odd"><td><code>SSL_CertFile</code> <em>file</em></td><td><code>SSLCertificateFile</code> <em>file</em></td><td>renommée</td></tr>
<tr><td><code>SSL_KeyFile</code> <em>file</em></td><td><code>SSLCertificateKeyFile</code> <em>file</em></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_CipherSuite</code> <em>arg</em></td><td><code>SSLCipherSuite</code> <em>arg</em></td><td>renommée</td></tr>
<tr><td><code>SSL_X509VerifyDir</code> <em>arg</em></td><td><code>SSLCACertificatePath</code> <em>arg</em></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_Log</code>
<em>file</em></td><td><code>-</code></td><td>Utilisez plutôt la directive
de niveau module <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code></td></tr>
<tr><td><code>SSL_Connect</code> <em>flag</em></td><td><code>SSLEngine</code> <em>flag</em></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_ClientAuth</code> <em>arg</em></td><td><code>SSLVerifyClient</code> <em>arg</em></td><td>renommée</td></tr>
<tr><td><code>SSL_X509VerifyDepth</code> <em>arg</em></td><td><code>SSLVerifyDepth</code> <em>arg</em></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_FetchKeyPhraseFrom</code> <em>arg</em></td><td>-</td><td>pas de véritable équivalent ; utiliser SSLPassPhraseDialog</td></tr>
<tr><td><code>SSL_SessionDir</code> <em>dir</em></td><td>-</td><td>pas de véritable équivalent ; utiliser SSLSessionCache</td></tr>
<tr class="odd"><td><code>SSL_Require</code> <em>expr</em></td><td>-</td><td>pas de véritable équivalent ; utiliser SSLRequire</td></tr>
<tr><td><code>SSL_CertFileType</code> <em>arg</em></td><td>-</td><td>fonctionnalité non supportée</td></tr>
<tr class="odd"><td><code>SSL_KeyFileType</code> <em>arg</em></td><td>-</td><td>fonctionnalité non supportée</td></tr>
<tr><td><code>SSL_X509VerifyPolicy</code> <em>arg</em></td><td>-</td><td>fonctionnalité non supportée</td></tr>
<tr class="odd"><td><code>SSL_LogX509Attributes</code> <em>arg</em></td><td>-</td><td>fonctionnalité non supportée</td></tr>
<tr class="header"><th colspan="3">Compatibilité avec Stronghold 2.x :</th></tr>
<tr><td><code>StrongholdAccelerator</code> <em>engine</em></td><td><code>SSLCryptoDevice</code> <em>engine</em></td><td>renommée</td></tr>
<tr class="odd"><td><code>StrongholdKey</code> <em>dir</em></td><td>-</td><td>sans objet</td></tr>
<tr><td><code>StrongholdLicenseFile</code> <em>dir</em></td><td>-</td><td>sans objet</td></tr>
<tr class="odd"><td><code>SSLFlag</code> <em>flag</em></td><td><code>SSLEngine</code> <em>flag</em></td><td>renommée</td></tr>
<tr><td><code>SSLSessionLockFile</code> <em>file</em></td><td><code>SSLMutex</code> <em>file</em></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSLCipherList</code> <em>spec</em></td><td><code>SSLCipherSuite</code> <em>spec</em></td><td>renommée</td></tr>
<tr><td><code>RequireSSL</code></td><td><code>SSLRequireSSL</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSLErrorFile</code> <em>file</em></td><td>-</td><td>fonctionnalité non supportée</td></tr>
<tr><td><code>SSLRoot</code> <em>dir</em></td><td>-</td><td>fonctionnalité non supportée</td></tr>
<tr class="odd"><td><code>SSL_CertificateLogDir</code> <em>dir</em></td><td>-</td><td>fonctionnalité non supportée</td></tr>
<tr><td><code>AuthCertDir</code> <em>dir</em></td><td>-</td><td>fonctionnalité non supportée</td></tr>
<tr class="odd"><td><code>SSL_Group</code> <em>name</em></td><td>-</td><td>fonctionnalité non supportée</td></tr>
<tr><td><code>SSLProxyMachineCertPath</code> <em>dir</em></td><td><code>SSLProxyMachineCertificatePath</code> <em>dir</em></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSLProxyMachineCertFile</code> <em>file</em></td><td><code>SSLProxyMachineCertificateFile</code> <em>file</em></td><td>renommée</td></tr>
<tr><td><code>SSLProxyCipherList</code> <em>spec</em></td><td><code>SSLProxyCipherSpec</code> <em>spec</em></td><td>renommée</td></tr>
</table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="variables" id="variables">Variables d'environnement</a></h2>
<p>La correspondance entre les noms des variables d'environnement utilisés par
les solutions SSL plus anciennes et les noms utilisés par mod_ssl est fournie
dans le <a href="#table2">Tableau 2</a>.</p>
<h3><a name="table2" id="table2">Tableau 2: Dérivation des variables d'environnement</a></h3>
<table><tr class="header"><th>Ancienne variable</th><th>Variable mod_ssl</th><th>Commentaires</th></tr>
<tr><td><code>SSL_PROTOCOL_VERSION</code></td><td><code>SSL_PROTOCOL</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSLEAY_VERSION</code></td><td><code>SSL_VERSION_LIBRARY</code></td><td>renommée</td></tr>
<tr><td><code>HTTPS_SECRETKEYSIZE</code></td><td><code>SSL_CIPHER_USEKEYSIZE</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>HTTPS_KEYSIZE</code></td><td><code>SSL_CIPHER_ALGKEYSIZE</code></td><td>renommée</td></tr>
<tr><td><code>HTTPS_CIPHER</code></td><td><code>SSL_CIPHER</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>HTTPS_EXPORT</code></td><td><code>SSL_CIPHER_EXPORT</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SERVER_KEY_SIZE</code></td><td><code>SSL_CIPHER_ALGKEYSIZE</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SERVER_CERTIFICATE</code></td><td><code>SSL_SERVER_CERT</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SERVER_CERT_START</code></td><td><code>SSL_SERVER_V_START</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SERVER_CERT_END</code></td><td><code>SSL_SERVER_V_END</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SERVER_CERT_SERIAL</code></td><td><code>SSL_SERVER_M_SERIAL</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SERVER_SIGNATURE_ALGORITHM</code></td><td><code>SSL_SERVER_A_SIG</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SERVER_DN</code></td><td><code>SSL_SERVER_S_DN</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SERVER_CN</code></td><td><code>SSL_SERVER_S_DN_CN</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SERVER_EMAIL</code></td><td><code>SSL_SERVER_S_DN_Email</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SERVER_O</code></td><td><code>SSL_SERVER_S_DN_O</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SERVER_OU</code></td><td><code>SSL_SERVER_S_DN_OU</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SERVER_C</code></td><td><code>SSL_SERVER_S_DN_C</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SERVER_SP</code></td><td><code>SSL_SERVER_S_DN_SP</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SERVER_L</code></td><td><code>SSL_SERVER_S_DN_L</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SERVER_IDN</code></td><td><code>SSL_SERVER_I_DN</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SERVER_ICN</code></td><td><code>SSL_SERVER_I_DN_CN</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SERVER_IEMAIL</code></td><td><code>SSL_SERVER_I_DN_Email</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SERVER_IO</code></td><td><code>SSL_SERVER_I_DN_O</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SERVER_IOU</code></td><td><code>SSL_SERVER_I_DN_OU</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SERVER_IC</code></td><td><code>SSL_SERVER_I_DN_C</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SERVER_ISP</code></td><td><code>SSL_SERVER_I_DN_SP</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SERVER_IL</code></td><td><code>SSL_SERVER_I_DN_L</code></td><td>renommée</td></tr>
<tr><td><code>SSL_CLIENT_CERTIFICATE</code></td><td><code>SSL_CLIENT_CERT</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_CERT_START</code></td><td><code>SSL_CLIENT_V_START</code></td><td>renommée</td></tr>
<tr><td><code>SSL_CLIENT_CERT_END</code></td><td><code>SSL_CLIENT_V_END</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_CERT_SERIAL</code></td><td><code>SSL_CLIENT_M_SERIAL</code></td><td>renommée</td></tr>
<tr><td><code>SSL_CLIENT_SIGNATURE_ALGORITHM</code></td><td><code>SSL_CLIENT_A_SIG</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_DN</code></td><td><code>SSL_CLIENT_S_DN</code></td><td>renommée</td></tr>
<tr><td><code>SSL_CLIENT_CN</code></td><td><code>SSL_CLIENT_S_DN_CN</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_EMAIL</code></td><td><code>SSL_CLIENT_S_DN_Email</code></td><td>renommée</td></tr>
<tr><td><code>SSL_CLIENT_O</code></td><td><code>SSL_CLIENT_S_DN_O</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_OU</code></td><td><code>SSL_CLIENT_S_DN_OU</code></td><td>renommée</td></tr>
<tr><td><code>SSL_CLIENT_C</code></td><td><code>SSL_CLIENT_S_DN_C</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_SP</code></td><td><code>SSL_CLIENT_S_DN_SP</code></td><td>renommée</td></tr>
<tr><td><code>SSL_CLIENT_L</code></td><td><code>SSL_CLIENT_S_DN_L</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_IDN</code></td><td><code>SSL_CLIENT_I_DN</code></td><td>renommée</td></tr>
<tr><td><code>SSL_CLIENT_ICN</code></td><td><code>SSL_CLIENT_I_DN_CN</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_IEMAIL</code></td><td><code>SSL_CLIENT_I_DN_Email</code></td><td>renommée</td></tr>
<tr><td><code>SSL_CLIENT_IO</code></td><td><code>SSL_CLIENT_I_DN_O</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_IOU</code></td><td><code>SSL_CLIENT_I_DN_OU</code></td><td>renommée</td></tr>
<tr><td><code>SSL_CLIENT_IC</code></td><td><code>SSL_CLIENT_I_DN_C</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_ISP</code></td><td><code>SSL_CLIENT_I_DN_SP</code></td><td>renommée</td></tr>
<tr><td><code>SSL_CLIENT_IL</code></td><td><code>SSL_CLIENT_I_DN_L</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_EXPORT</code></td><td><code>SSL_CIPHER_EXPORT</code></td><td>renommée</td></tr>
<tr><td><code>SSL_KEYSIZE</code></td><td><code>SSL_CIPHER_ALGKEYSIZE</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_SECKEYSIZE</code></td><td><code>SSL_CIPHER_USEKEYSIZE</code></td><td>renommée</td></tr>
<tr><td><code>SSL_SSLEAY_VERSION</code></td><td><code>SSL_VERSION_LIBRARY</code></td><td>renommée</td></tr>
<tr class="odd"><td><code>SSL_STRONG_CRYPTO</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
<tr><td><code>SSL_SERVER_KEY_EXP</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
<tr class="odd"><td><code>SSL_SERVER_KEY_ALGORITHM</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
<tr><td><code>SSL_SERVER_KEY_SIZE</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
<tr class="odd"><td><code>SSL_SERVER_SESSIONDIR</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
<tr><td><code>SSL_SERVER_CERTIFICATELOGDIR</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
<tr class="odd"><td><code>SSL_SERVER_CERTFILE</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
<tr><td><code>SSL_SERVER_KEYFILE</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
<tr class="odd"><td><code>SSL_SERVER_KEYFILETYPE</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
<tr><td><code>SSL_CLIENT_KEY_EXP</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
<tr class="odd"><td><code>SSL_CLIENT_KEY_ALGORITHM</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
<tr><td><code>SSL_CLIENT_KEY_SIZE</code></td><td><code>-</code></td><td>Non supportée par mod_ssl</td></tr>
</table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="customlog" id="customlog">Fonctions de personnalisation des journaux</a></h2>
<p>Quand mod_ssl est activé, le <a href="../mod/mod_log_config.html#formats">Format de journal courant
(Custom Log Format)</a> du module <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> possède
des fonctions supplémentaires comme indiqué dans le chapitre de référence.
En plus de la fonction de format étendu
``<code>%{</code><em>varname</em><code>}x</code>'' que l'on peut utiliser pour
extraire le contenu d'une variable fournie par n'importe quel module,
la fonction
de format cryptographique ``<code>%{</code><em>name</em><code>}c</code>'' a
été ajoutée à des fins de compatibilité ascendante. Les appels de fonctions
actuellement implémentés sont énumérés dans le
<a href="#table3">Tableau 3</a>.</p>
<h3><a name="table3" id="table3">Table 3: Fonctions cryptographiques du format de journal courant</a></h3>
<table>
<tr><th>Appel de fonction</th><th>Description</th></tr>
<tr><td><code>%...{version}c</code></td> <td>Version du protocole SSL</td></tr>
<tr><td><code>%...{cipher}c</code></td> <td>Chiffrement SSL</td></tr>
<tr><td><code>%...{subjectdn}c</code></td> <td>Nom distinctif du sujet du certificat du client</td></tr>
<tr><td><code>%...{issuerdn}c</code></td> <td>Nom distinctif de l'émetteur du certificat du client</td></tr>
<tr><td><code>%...{errcode}c</code></td> <td>Erreur lors de la vérification du certificat (numérique)</td></tr>
<tr><td><code>%...{errstr}c</code></td> <td>Erreur lors de la vérification du certificat (chaîne de caractères)</td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/ssl/ssl_compat.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/ssl/ssl_compat.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/ssl/ssl_compat.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/index.html.en 0000664 0001751 0001751 00000011734 14737241666 020254 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache SSL/TLS Encryption - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache SSL/TLS Encryption</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/ssl/" title="English"> en </a> |
<a href="../fr/ssl/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../tr/ssl/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/ssl/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>The Apache HTTP Server module <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>
provides an interface to the <a href="http://www.openssl.org/">OpenSSL</a> library, which provides
Strong Encryption using the Secure Sockets Layer and Transport Layer
Security protocols.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#documentation">Documentation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mod-ssl">mod_ssl</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="documentation" id="documentation">Documentation</a></h2>
<ul>
<li><a href="ssl_howto.html">mod_ssl Configuration How-To</a></li>
<li><a href="ssl_intro.html">Introduction To SSL</a></li>
<li><a href="ssl_compat.html">Compatibility</a></li>
<li><a href="ssl_faq.html">Frequently Asked Questions</a></li>
<li><a href="../glossary.html">Glossary</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="mod-ssl" id="mod-ssl">mod_ssl</a></h2>
<p>Extensive documentation on the directives and environment variables
provided by this module is provided in the <a href="../mod/mod_ssl.html">mod_ssl reference documentation</a>.
</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/ssl/" title="English"> en </a> |
<a href="../fr/ssl/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../tr/ssl/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/ssl/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/ssl_intro.html.en 0000664 0001751 0001751 00000105374 14737241666 021165 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>SSL/TLS Strong Encryption: An Introduction - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">SSL/TLS</a></div><div id="page-content"><div id="preamble"><h1>SSL/TLS Strong Encryption: An Introduction</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/ssl/ssl_intro.html" title="English"> en </a> |
<a href="../fr/ssl/ssl_intro.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/ssl_intro.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div>
<p>As an introduction this chapter is aimed at readers who are familiar
with the Web, HTTP, and Apache, but are not security experts. It is not
intended to be a definitive guide to the SSL protocol, nor does it discuss
specific techniques for managing certificates in an organization, or the
important legal issues of patents and import and export restrictions.
Rather, it is intended to provide a common background to <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> users by pulling together various concepts, definitions,
and examples as a starting point for further exploration.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#cryptographictech">Cryptographic Techniques</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#certificates">Certificates</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ssl">Secure Sockets Layer (SSL)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#references">References</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="cryptographictech" id="cryptographictech">Cryptographic Techniques</a></h2>
<p>Understanding SSL requires an understanding of cryptographic
algorithms, message digest functions (aka. one-way or hash functions), and
digital signatures. These techniques are the subject of entire books (see
for instance [<a href="#AC96">AC96</a>]) and provide the basis for privacy,
integrity, and authentication.</p>
<h3><a name="cryptographicalgo" id="cryptographicalgo">Cryptographic Algorithms</a></h3>
<p>Suppose Alice wants to send a message to her bank to transfer some
money. Alice would like the message to be private, since it will
include information such as her account number and transfer amount. One
solution is to use a cryptographic algorithm, a technique that would
transform her message into an encrypted form, unreadable until it is
decrypted. Once in this form, the message can only be
decrypted by using a secret key. Without the key the message is useless:
good cryptographic algorithms make it so difficult
for intruders to decode the original text that it isn't worth their
effort.</p>
<p>There are two categories of cryptographic algorithms: conventional
and public key.</p>
<dl>
<dt>Conventional cryptography</dt>
<dd>also known as symmetric cryptography, requires the sender and
receiver to share a key: a secret piece of information that may be
used to encrypt or decrypt a message. As long as this key is kept
secret, nobody other than the sender or recipient can read the message.
If Alice and the bank know a secret key, then they can send each other
private messages. The task of sharing a key between sender and recipient
before communicating, while also keeping it secret from others, can be
problematic.</dd>
<dt>Public key cryptography</dt>
<dd>also known as asymmetric cryptography, solves the key exchange
problem by defining an algorithm which uses two keys, each of which
may be used to encrypt a message. If one key is used to encrypt a
message then the other must be used to decrypt it. This makes it
possible to receive secure messages by simply publishing one key
(the public key) and keeping the other secret (the private key).</dd>
</dl>
<p>Anyone can encrypt a message using the public key, but only the
owner of the private key will be able to read it. In this way, Alice
can send private messages to the owner of a key-pair (the bank), by
encrypting them using their public key. Only the bank will be able to
decrypt them.</p>
<h3><a name="messagedigests" id="messagedigests">Message Digests</a></h3>
<p>Although Alice may encrypt her message to make it private, there
is still a concern that someone might modify her original message or
substitute it with a different one, in order to transfer the money
to themselves, for instance. One way of guaranteeing the integrity
of Alice's message is for her to create a concise summary of her
message and send this to the bank as well. Upon receipt of the message,
the bank creates its own summary and compares it with the one Alice
sent. If the summaries are the same then the message has been received
intact.</p>
<p>A summary such as this is called a <dfn>message digest</dfn>, <em>one-way
function</em> or <em>hash function</em>. Message digests are used to create
a short, fixed-length representation of a longer, variable-length message.
Digest algorithms are designed to produce a unique digest for each
message. Message digests are designed to make it impractically difficult
to determine the message from the digest and (in theory) impossible to
find two different messages which create the same digest -- thus
eliminating the possibility of substituting one message for another while
maintaining the same digest.</p>
<p>Another challenge that Alice faces is finding a way to send the digest
to the bank securely; if the digest is not sent securely, its integrity may
be compromised and with it the possibility for the bank to determine the
integrity of the original message. Only if the digest is sent securely can
the integrity of the associated message be determined.</p>
<p>One way to send the digest securely is to include it in a digital
signature.</p>
<h3><a name="digitalsignatures" id="digitalsignatures">Digital Signatures</a></h3>
<p>When Alice sends a message to the bank, the bank needs to ensure that the
message is really from her, so an intruder cannot request a transaction
involving her account. A <em>digital signature</em>, created by Alice and
included with the message, serves this purpose.</p>
<p>Digital signatures are created by encrypting a digest of the message and
other information (such as a sequence number) with the sender's private key.
Though anyone can <em>decrypt</em> the signature using the public key, only the
sender knows the private key. This means that only the sender can have signed
the message. Including the digest in the signature means the signature is only
good for that message; it also ensures the integrity of the message since no one
can change the digest and still sign it.</p>
<p>To guard against interception and reuse of the signature by an intruder at a
later date, the signature contains a unique sequence number. This protects
the bank from a fraudulent claim from Alice that she did not send the message
-- only she could have signed it (non-repudiation).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="certificates" id="certificates">Certificates</a></h2>
<p>Although Alice could have sent a private message to the bank, signed
it and ensured the integrity of the message, she still needs to be sure
that she is really communicating with the bank. This means that she needs
to be sure that the public key she is using is part of the bank's key-pair,
and not an intruder's. Similarly, the bank needs to verify that the message
signature really was signed by the private key that belongs to Alice.</p>
<p>If each party has a certificate which validates the other's identity,
confirms the public key and is signed by a trusted agency, then both
can be assured that they are communicating with whom they think they are.
Such a trusted agency is called a <em>Certificate Authority</em> and
certificates are used for authentication.</p>
<h3><a name="certificatecontents" id="certificatecontents">Certificate Contents</a></h3>
<p>A certificate associates a public key with the real identity of
an individual, server, or other entity, known as the subject. As
shown in <a href="#table1">Table 1</a>, information about the subject
includes identifying information (the distinguished name) and the
public key. It also includes the identification and signature of the
Certificate Authority that issued the certificate and the period of
time during which the certificate is valid. It may have additional
information (or extensions) as well as administrative information
for the Certificate Authority's use, such as a serial number.</p>
<h4><a name="table1" id="table1">Table 1: Certificate Information</a></h4>
<table>
<tr><th>Subject</th>
<td>Distinguished Name, Public Key</td></tr>
<tr><th>Issuer</th>
<td>Distinguished Name, Signature</td></tr>
<tr><th>Period of Validity</th>
<td>Not Before Date, Not After Date</td></tr>
<tr><th>Administrative Information</th>
<td>Version, Serial Number</td></tr>
<tr><th>Extended Information</th>
<td>Basic Constraints, Netscape Flags, etc.</td></tr>
</table>
<p>A distinguished name is used to provide an identity in a specific
context -- for instance, an individual might have a personal
certificate as well as one for their identity as an employee.
Distinguished names are defined by the X.509 standard [<a href="#X509">X509</a>], which defines the fields, field names and
abbreviations used to refer to the fields (see <a href="#table2">Table
2</a>).</p>
<h4><a name="table2" id="table2">Table 2: Distinguished Name Information</a></h4>
<table class="bordered">
<tr><th>DN Field</th>
<th>Abbrev.</th>
<th>Description</th>
<th>Example</th></tr>
<tr><td>Common Name</td>
<td>CN</td>
<td>Name being certified</td>
<td>CN=Joe Average</td></tr>
<tr><td>Organization or Company</td>
<td>O</td>
<td>Name is associated with this<br />organization</td>
<td>O=Snake Oil, Ltd.</td></tr>
<tr><td>Organizational Unit</td>
<td>OU</td>
<td>Name is associated with this <br />organization unit, such
as a department</td>
<td>OU=Research Institute</td></tr>
<tr><td>City/Locality</td>
<td>L</td>
<td>Name is located in this City</td>
<td>L=Snake City</td></tr>
<tr><td>State/Province</td>
<td>ST</td>
<td>Name is located in this State/Province</td>
<td>ST=Desert</td></tr>
<tr><td>Country</td>
<td>C</td>
<td>Name is located in this Country (ISO code)</td>
<td>C=XZ</td></tr>
</table>
<p>A Certificate Authority may define a policy specifying which
distinguished field names are optional and which are required. It
may also place requirements upon the field contents, as may users of
certificates. For example, a Netscape browser requires that the
Common Name for a certificate representing a server matches a wildcard
pattern for the domain name of that server, such
as <code>*.snakeoil.com</code>.</p>
<p>The binary format of a certificate is defined using the ASN.1
notation [<a href="#ASN1">ASN1</a>] [<a href="#PKCS">PKCS</a>]. This
notation defines how to specify the contents and encoding rules
define how this information is translated into binary form. The binary
encoding of the certificate is defined using Distinguished Encoding
Rules (DER), which are based on the more general Basic Encoding Rules
(BER). For those transmissions which cannot handle binary, the binary
form may be translated into an ASCII form by using Base64 encoding
[<a href="#MIME">MIME</a>]. When placed between begin and end delimiter
lines (as below), this encoded version is called a PEM ("Privacy Enhanced
Mail") encoded certificate.</p>
<div class="example"><h3>Example of a PEM-encoded certificate (snakeoil.crt)</h3><pre>-----BEGIN CERTIFICATE-----
MIIC7jCCAlegAwIBAgIBATANBgkqhkiG9w0BAQQFADCBqTELMAkGA1UEBhMCWFkx
FTATBgNVBAgTDFNuYWtlIERlc2VydDETMBEGA1UEBxMKU25ha2UgVG93bjEXMBUG
A1UEChMOU25ha2UgT2lsLCBMdGQxHjAcBgNVBAsTFUNlcnRpZmljYXRlIEF1dGhv
cml0eTEVMBMGA1UEAxMMU25ha2UgT2lsIENBMR4wHAYJKoZIhvcNAQkBFg9jYUBz
bmFrZW9pbC5kb20wHhcNOTgxMDIxMDg1ODM2WhcNOTkxMDIxMDg1ODM2WjCBpzEL
MAkGA1UEBhMCWFkxFTATBgNVBAgTDFNuYWtlIERlc2VydDETMBEGA1UEBxMKU25h
a2UgVG93bjEXMBUGA1UEChMOU25ha2UgT2lsLCBMdGQxFzAVBgNVBAsTDldlYnNl
cnZlciBUZWFtMRkwFwYDVQQDExB3d3cuc25ha2VvaWwuZG9tMR8wHQYJKoZIhvcN
AQkBFhB3d3dAc25ha2VvaWwuZG9tMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKB
gQDH9Ge/s2zcH+da+rPTx/DPRp3xGjHZ4GG6pCmvADIEtBtKBFAcZ64n+Dy7Np8b
vKR+yy5DGQiijsH1D/j8HlGE+q4TZ8OFk7BNBFazHxFbYI4OKMiCxdKzdif1yfaa
lWoANFlAzlSdbxeGVHoT0K+gT5w3UxwZKv2DLbCTzLZyPwIDAQABoyYwJDAPBgNV
HRMECDAGAQH/AgEAMBEGCWCGSAGG+EIBAQQEAwIAQDANBgkqhkiG9w0BAQQFAAOB
gQAZUIHAL4D09oE6Lv2k56Gp38OBDuILvwLg1v1KL8mQR+KFjghCrtpqaztZqcDt
2q2QoyulCgSzHbEGmi0EsdkPfg6mp0penssIFePYNI+/8u9HT4LuKMJX15hxBam7
dUHzICxBVC1lnHyYGjDuAMhe396lYAn8bCld1/L4NMGBCQ==
-----END CERTIFICATE-----</pre></div>
<h3><a name="certificateauthorities" id="certificateauthorities">Certificate Authorities</a></h3>
<p>By verifying the information in a certificate request
before granting the certificate, the Certificate Authority assures
itself of the identity of the private key owner of a key-pair.
For instance, if Alice requests a personal certificate, the
Certificate Authority must first make sure that Alice really is the
person the certificate request claims she is.</p>
<h4><a name="certificatechains" id="certificatechains">Certificate Chains</a></h4>
<p>A Certificate Authority may also issue a certificate for
another Certificate Authority. When examining a certificate,
Alice may need to examine the certificate of the issuer, for each
parent Certificate Authority, until reaching one which she has
confidence in. She may decide to trust only certificates with a
limited chain of issuers, to reduce her risk of a "bad" certificate
in the chain.</p>
<h4><a name="rootlevelca" id="rootlevelca">Creating a Root-Level CA</a></h4>
<p>As noted earlier, each certificate requires an issuer to assert
the validity of the identity of the certificate subject, up to
the top-level Certificate Authority (CA). This presents a problem:
who can vouch for the certificate of the top-level
authority, which has no issuer? In this unique case, the
certificate is "self-signed", so the issuer of the certificate is
the same as the subject. Browsers are preconfigured to trust well-known
certificate authorities, but it is important to exercise extra care in
trusting a self-signed certificate. The wide publication of a
public key by the root authority reduces the risk in trusting this
key -- it would be obvious if someone else publicized a key
claiming to be the authority.</p>
<p>A number of companies, such as <a href="http://www.thawte.com/">Thawte</a> and <a href="http://www.verisign.com/">VeriSign</a>
have established themselves as Certificate Authorities. These
companies provide the following services:</p>
<ul>
<li>Verifying certificate requests</li>
<li>Processing certificate requests</li>
<li>Issuing and managing certificates</li>
</ul>
<p>It is also possible to create your own Certificate Authority.
Although risky in the Internet environment, it may be useful
within an Intranet where the organization can easily verify the
identities of individuals and servers.</p>
<h4><a name="certificatemanagement" id="certificatemanagement">Certificate Management</a></h4>
<p>Establishing a Certificate Authority is a responsibility which
requires a solid administrative, technical and management
framework. Certificate Authorities not only issue certificates,
they also manage them -- that is, they determine for how long
certificates remain valid, they renew them and keep lists of
certificates that were issued in the past but are no longer valid
(Certificate Revocation Lists, or CRLs).</p>
<p>For example, if Alice is entitled to a certificate as an
employee of a company but has now left
that company, her certificate may need to be revoked.
Because certificates are only issued after the subject's identity has
been verified and can then be passed around to all those with whom
the subject may communicate, it is impossible to tell from the
certificate alone that it has been revoked.
Therefore when examining certificates for validity
it is necessary to contact the issuing Certificate Authority to
check CRLs -- this is usually not an automated part of the process.</p>
<div class="note"><h3>Note</h3>
<p>If you use a Certificate Authority that browsers are not configured
to trust by default, it is necessary to load the Certificate
Authority certificate into the browser, enabling the browser to
validate server certificates signed by that Certificate Authority.
Doing so may be dangerous, since once loaded, the browser will
accept all certificates signed by that Certificate Authority.</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="ssl" id="ssl">Secure Sockets Layer (SSL)</a></h2>
<p>The Secure Sockets Layer protocol is a protocol layer which may be
placed between a reliable connection-oriented network layer protocol
(e.g. TCP/IP) and the application protocol layer (e.g. HTTP). SSL provides
for secure communication between client and server by allowing mutual
authentication, the use of digital signatures for integrity and encryption
for privacy.</p>
<p>The protocol is designed to support a range of choices for specific
algorithms used for cryptography, digests and signatures. This allows
algorithm selection for specific servers to be made based on legal, export
or other concerns and also enables the protocol to take advantage of new
algorithms. Choices are negotiated between client and server when
establishing a protocol session.</p>
<h3><a name="table4" id="table4">Table 4: Versions of the SSL protocol</a></h3>
<table class="bordered">
<tr><th>Version</th>
<th>Source</th>
<th>Description</th>
</tr>
<tr><td>SSL v2.0</td>
<td>Vendor Standard (from Netscape Corp.)</td>
<td>First SSL protocol for which implementations exist</td>
</tr>
<tr><td>SSL v3.0</td>
<td>Expired Internet Draft (from Netscape Corp.) [<a href="#SSL3">SSL3</a>]</td>
<td>Revisions to prevent specific security attacks, add non-RSA
ciphers and support for certificate chains</td>
</tr>
<tr><td>TLS v1.0</td>
<td>Proposed Internet Standard (from IETF) [<a href="#TLS1">TLS1</a>]</td>
<td>Revision of SSL 3.0 to update the MAC layer to HMAC, add block
padding for block ciphers, message order standardization and more
alert messages.</td>
</tr>
<tr><td>TLS v1.1</td>
<td>Proposed Internet Standard (from IETF) [<a href="#TLS11">TLS11</a>]</td>
<td>Update of TLS 1.0 to add protection against Cipher block chaining
(CBC) attacks.</td>
</tr>
<tr><td>TLS v1.2</td>
<td>Proposed Internet Standard (from IETF) [<a href="#TLS12">TLS12</a>]</td>
<td>Update of TLS 1.1 deprecating MD5 as hash, and adding incompatibility
to SSL so it will never negotiate the use of SSLv2.</td>
</tr>
</table>
<p>There are a number of versions of the SSL protocol, as shown in
<a href="#table4">Table 4</a>. As noted there, one of the benefits in
SSL 3.0 is that it adds support of certificate chain loading. This feature
allows a server to pass a server certificate along with issuer certificates
to the browser. Chain loading also permits the browser to validate the
server certificate, even if Certificate Authority certificates are not
installed for the intermediate issuers, since they are included in the
certificate chain. SSL 3.0 is the basis for the Transport Layer Security
[<a href="#TLS1">TLS</a>] protocol standard, currently in development by
the Internet Engineering Task Force (IETF).</p>
<h3><a name="session" id="session">Establishing a Session</a></h3>
<p>The SSL session is established by following a handshake sequence
between client and server, as shown in <a href="#figure1">Figure 1</a>. This sequence may vary, depending on whether the server
is configured to provide a server certificate or request a client
certificate. Although cases exist where additional handshake steps
are required for management of cipher information, this article
summarizes one common scenario. See the SSL specification for the full
range of possibilities.</p>
<div class="note"><h3>Note</h3>
<p>Once an SSL session has been established, it may be reused. This
avoids the performance penalty of repeating the many steps needed
to start a session. To do this, the server assigns each SSL session a
unique session identifier which is cached in the server and which the
client can use in future connections to reduce the handshake time
(until the session identifier expires from the cache of the server).</p>
</div>
<p class="figure">
<img src="../images/ssl_intro_fig1.gif" alt="" width="423" height="327" /><br />
<a id="figure1" name="figure1"><dfn>Figure 1</dfn></a>: Simplified SSL
Handshake Sequence</p>
<p>The elements of the handshake sequence, as used by the client and
server, are listed below:</p>
<ol>
<li>Negotiate the Cipher Suite to be used during data transfer</li>
<li>Establish and share a session key between client and server</li>
<li>Optionally authenticate the server to the client</li>
<li>Optionally authenticate the client to the server</li>
</ol>
<p>The first step, Cipher Suite Negotiation, allows the client and
server to choose a Cipher Suite supported by both of them. The SSL3.0
protocol specification defines 31 Cipher Suites. A Cipher Suite is
defined by the following components:</p>
<ul>
<li>Key Exchange Method</li>
<li>Cipher for Data Transfer</li>
<li>Message Digest for creating the Message Authentication Code (MAC)</li>
</ul>
<p>These three elements are described in the sections that follow.</p>
<h3><a name="keyexchange" id="keyexchange">Key Exchange Method</a></h3>
<p>The key exchange method defines how the shared secret symmetric
cryptography key used for application data transfer will be agreed
upon by client and server. SSL 2.0 uses RSA key exchange only, while
SSL 3.0 supports a choice of key exchange algorithms including
RSA key exchange (when certificates are used), and Diffie-Hellman key
exchange (for exchanging keys without certificates, or without prior
communication between client and server).</p>
<p>One variable in the choice of key exchange methods is digital
signatures -- whether or not to use them, and if so, what kind of
signatures to use. Signing with a private key provides protection
against a man-in-the-middle-attack during the information exchange
used to generating the shared key [<a href="#AC96">AC96</a>, p516].</p>
<h3><a name="ciphertransfer" id="ciphertransfer">Cipher for Data Transfer</a></h3>
<p>SSL uses conventional symmetric cryptography, as described earlier,
for encrypting messages in a session.
There are nine choices of how to encrypt, including the option not to
encrypt:</p>
<ul>
<li>No encryption</li>
<li>Stream Ciphers
<ul>
<li>RC4 with 40-bit keys</li>
<li>RC4 with 128-bit keys</li>
</ul></li>
<li>CBC Block Ciphers
<ul><li>RC2 with 40 bit key</li>
<li>DES with 40 bit key</li>
<li>DES with 56 bit key</li>
<li>Triple-DES with 168 bit key</li>
<li>Idea (128 bit key)</li>
<li>Fortezza (96 bit key)</li>
</ul></li>
</ul>
<p>"CBC" refers to Cipher Block Chaining, which means that a
portion of the previously encrypted cipher text is used in the
encryption of the current block. "DES" refers to the Data Encryption
Standard [<a href="#AC96">AC96</a>, ch12], which has a number of
variants (including DES40 and 3DES_EDE). "Idea" is currently one of
the best and cryptographically strongest algorithms available,
and "RC2" is a proprietary algorithm from RSA DSI [<a href="#AC96">AC96</a>, ch13].</p>
<h3><a name="digestfunction" id="digestfunction">Digest Function</a></h3>
<p>The choice of digest function determines how a digest is created
from a record unit. SSL supports the following:</p>
<ul>
<li>No digest (Null choice)</li>
<li>MD5, a 128-bit hash</li>
<li>Secure Hash Algorithm (SHA-1), a 160-bit hash</li>
</ul>
<p>The message digest is used to create a Message Authentication Code
(MAC) which is encrypted with the message to verify integrity and to
protect against replay attacks.</p>
<h3><a name="handshake" id="handshake">Handshake Sequence Protocol</a></h3>
<p>The handshake sequence uses three protocols:</p>
<ul>
<li>The <dfn>SSL Handshake Protocol</dfn>
for performing the client and server SSL session establishment.</li>
<li>The <dfn>SSL Change Cipher Spec Protocol</dfn> for actually
establishing agreement on the Cipher Suite for the session.</li>
<li>The <dfn>SSL Alert Protocol</dfn> for conveying SSL error
messages between client and server.</li>
</ul>
<p>These protocols, as well as application protocol data, are
encapsulated in the <dfn>SSL Record Protocol</dfn>, as shown in
<a href="#figure2">Figure 2</a>. An encapsulated protocol is
transferred as data by the lower layer protocol, which does not
examine the data. The encapsulated protocol has no knowledge of the
underlying protocol.</p>
<p class="figure">
<img src="../images/ssl_intro_fig2.gif" alt="" width="428" height="217" /><br />
<a id="figure2" name="figure2"><dfn>Figure 2</dfn></a>: SSL Protocol Stack
</p>
<p>The encapsulation of SSL control protocols by the record protocol
means that if an active session is renegotiated the control protocols
will be transmitted securely. If there was no previous session,
the Null cipher suite is used, which means there will be no encryption and
messages will have no integrity digests, until the session has been
established.</p>
<h3><a name="datatransfer" id="datatransfer">Data Transfer</a></h3>
<p>The SSL Record Protocol, shown in <a href="#figure3">Figure 3</a>,
is used to transfer application and SSL Control data between the
client and server, where necessary fragmenting this data into smaller units,
or combining multiple higher level protocol data messages into single
units. It may compress, attach digest signatures, and encrypt these
units before transmitting them using the underlying reliable transport
protocol (Note: currently, no major SSL implementations include support
for compression).</p>
<p class="figure">
<img src="../images/ssl_intro_fig3.gif" alt="" width="423" height="323" /><br />
<a id="figure3" name="figure3"><dfn>Figure 3</dfn></a>: SSL Record Protocol
</p>
<h3><a name="securehttp" id="securehttp">Securing HTTP Communication</a></h3>
<p>One common use of SSL is to secure Web HTTP communication between
a browser and a webserver. This does not preclude the use of
non-secured HTTP - the secure version (called HTTPS) is the same as
plain HTTP over SSL, but uses the URL scheme <code>https</code>
rather than <code>http</code>, and a different server port (by default,
port 443). This functionality is a large part of what <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> provides for the Apache webserver.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="references" id="references">References</a></h2>
<dl>
<dt><a id="AC96" name="AC96">[AC96]</a></dt>
<dd>Bruce Schneier, <q>Applied Cryptography</q>, 2nd Edition, Wiley,
1996. See <a href="http://www.counterpane.com/">http://www.counterpane.com/</a> for various other materials by Bruce
Schneier.</dd>
<dt><a id="ASN1" name="ASN1">[ASN1]</a></dt>
<dd>ITU-T Recommendation X.208, <q>Specification of Abstract Syntax Notation
One (ASN.1)</q>, last updated 2008. See <a href="http://www.itu.int/ITU-T/asn1/">http://www.itu.int/ITU-T/asn1/</a>.
</dd>
<dt><a id="X509" name="X509">[X509]</a></dt>
<dd>ITU-T Recommendation X.509, <q>The Directory - Authentication
Framework</q>. For references, see <a href="http://en.wikipedia.org/wiki/X.509">http://en.wikipedia.org/wiki/X.509</a>.
</dd>
<dt><a id="PKCS" name="PKCS">[PKCS]</a></dt>
<dd><q>Public Key Cryptography Standards (PKCS)</q>,
RSA Laboratories Technical Notes, See <a href="http://www.rsasecurity.com/rsalabs/pkcs/">http://www.rsasecurity.com/rsalabs/pkcs/</a>.</dd>
<dt><a id="MIME" name="MIME">[MIME]</a></dt>
<dd>N. Freed, N. Borenstein, <q>Multipurpose Internet Mail Extensions
(MIME) Part One: Format of Internet Message Bodies</q>, RFC2045.
See for instance <a href="http://tools.ietf.org/html/rfc2045">http://tools.ietf.org/html/rfc2045</a>.</dd>
<dt><a id="SSL3" name="SSL3">[SSL3]</a></dt>
<dd>Alan O. Freier, Philip Karlton, Paul C. Kocher, <q>The SSL Protocol
Version 3.0</q>, 1996. See <a href="http://www.netscape.com/eng/ssl3/draft302.txt">http://www.netscape.com/eng/ssl3/draft302.txt</a>.</dd>
<dt><a id="TLS1" name="TLS1">[TLS1]</a></dt>
<dd>Tim Dierks, Christopher Allen, <q>The TLS Protocol Version 1.0</q>,
1999. See <a href="http://ietf.org/rfc/rfc2246.txt">http://ietf.org/rfc/rfc2246.txt</a>.</dd>
<dt><a id="TLS11" name="TLS11">[TLS11]</a></dt>
<dd><q>The TLS Protocol Version 1.1</q>,
2006. See <a href="http://tools.ietf.org/html/rfc4346">http://tools.ietf.org/html/rfc4346</a>.</dd>
<dt><a id="TLS12" name="TLS12">[TLS12]</a></dt>
<dd><q>The TLS Protocol Version 1.2</q>,
2008. See <a href="http://tools.ietf.org/html/rfc5246">http://tools.ietf.org/html/rfc5246</a>.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/ssl/ssl_intro.html" title="English"> en </a> |
<a href="../fr/ssl/ssl_intro.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/ssl/ssl_intro.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/ssl/ssl_intro.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/ssl_howto.html 0000664 0001751 0001751 00000000321 13710016232 020526 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: ssl_howto.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: ssl_howto.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/ssl/ssl_howto.html.en 0000664 0001751 0001751 00000055114 14737241666 021166 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>SSL/TLS Strong Encryption: How-To - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">SSL/TLS</a></div><div id="page-content"><div id="preamble"><h1>SSL/TLS Strong Encryption: How-To</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/ssl/ssl_howto.html" title="English"> en </a> |
<a href="../fr/ssl/ssl_howto.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document is intended to get you started, and get a few things
working. You are strongly encouraged to read the rest of the SSL
documentation, and arrive at a deeper understanding of the material,
before progressing to the advanced techniques.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#configexample">Basic Configuration Example</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ciphersuites">Cipher Suites and Enforcing Strong Security</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ocspstapling">OCSP Stapling</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#accesscontrol">Client Authentication and Access Control</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#logging">Logging</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="configexample" id="configexample">Basic Configuration Example</a></h2>
<p>Your SSL configuration will need to contain, at minimum, the
following directives.</p>
<pre class="prettyprint lang-config">LoadModule ssl_module modules/mod_ssl.so
Listen 443
<VirtualHost *:443>
ServerName www.example.com
SSLEngine on
SSLCertificateFile "/path/to/www.example.com.cert"
SSLCertificateKeyFile "/path/to/www.example.com.key"
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ciphersuites" id="ciphersuites">Cipher Suites and Enforcing Strong Security</a></h2>
<ul>
<li><a href="#onlystrong">How can I create an SSL server which accepts strong encryption only?</a></li>
<li><a href="#strongurl">How can I create an SSL server which accepts all types of ciphers in general, but
requires a strong cipher for access to a particular URL?</a></li>
</ul>
<h3><a name="onlystrong" id="onlystrong">How can I create an SSL server which accepts strong encryption
only?</a></h3>
<p>The following enables only the strongest ciphers:</p>
<pre class="prettyprint lang-config">SSLCipherSuite HIGH:!aNULL:!MD5</pre>
<p>While with the following configuration you specify a preference
for specific speed-optimized ciphers (which will be selected by
mod_ssl, provided that they are supported by the client):</p>
<pre class="prettyprint lang-config">SSLCipherSuite RC4-SHA:AES128-SHA:HIGH:!aNULL:!MD5
SSLHonorCipherOrder on</pre>
<h3><a name="strongurl" id="strongurl">How can I create an SSL server which accepts all types of ciphers
in general, but requires a strong ciphers for access to a particular
URL?</a></h3>
<p>Obviously, a server-wide <code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code> which restricts
ciphers to the strong variants, isn't the answer here. However,
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> can be reconfigured within <code>Location</code>
blocks, to give a per-directory solution, and can automatically force
a renegotiation of the SSL parameters to meet the new configuration.
This can be done as follows:</p>
<pre class="prettyprint lang-config"># be liberal in general
SSLCipherSuite ALL:!aNULL:RC4+RSA:+HIGH:+MEDIUM:+LOW:+EXP:+eNULL
<Location "/strong/area">
# but https://hostname/strong/area/ and below
# requires strong ciphers
SSLCipherSuite HIGH:!aNULL:!MD5
</Location></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ocspstapling" id="ocspstapling">OCSP Stapling</a></h2>
<p>The Online Certificate Status Protocol (OCSP) is a mechanism for
determining whether or not a server certificate has been revoked, and OCSP
Stapling is a special form of this in which the server, such as httpd and
mod_ssl, maintains current OCSP responses for its certificates and sends
them to clients which communicate with the server. Most certificates
contain the address of an OCSP responder maintained by the issuing
Certificate Authority, and mod_ssl can communicate with that responder to
obtain a signed response that can be sent to clients communicating with
the server.</p>
<p>Because the client can obtain the certificate revocation status from
the server, without requiring an extra connection from the client to the
Certificate Authority, OCSP Stapling is the preferred way for the
revocation status to be obtained. Other benefits of eliminating the
communication between clients and the Certificate Authority are that the
client browsing history is not exposed to the Certificate Authority and
obtaining status is more reliable by not depending on potentially heavily
loaded Certificate Authority servers.</p>
<p>Because the response obtained by the server can be reused for all clients
using the same certificate during the time that the response is valid, the
overhead for the server is minimal.</p>
<p>Once general SSL support has been configured properly, enabling OCSP
Stapling generally requires only very minor modifications to the httpd
configuration — the addition of these two directives:</p>
<pre class="prettyprint lang-config">SSLUseStapling On
SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"</pre>
<p>These directives are placed at global scope (i.e., not within a virtual
host definition) wherever other global SSL configuration directives are
placed, such as in <code>conf/extra/httpd-ssl.conf</code> for normal
open source builds of httpd, <code>/etc/apache2/mods-enabled/ssl.conf</code>
for the Ubuntu or Debian-bundled httpd, etc.</p>
<p>The path on the <code class="directive">SSLStaplingCache</code> directive
(e.g., <code>logs/</code>) should match the one on the
<code class="directive">SSLSessionCache</code> directive. This path is relative
to <code class="directive">ServerRoot</code>.</p>
<p>This particular <code class="directive">SSLStaplingCache</code> directive requires
<code class="module"><a href="../mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code> (from the <code>shmcb</code> prefix on the
directive's argument). This module is usually enabled already for
<code class="directive">SSLSessionCache</code> or on behalf of some module other than
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>. If you enabled an SSL session cache using a
mechanism other than <code class="module"><a href="../mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code>, use that alternative
mechanism for <code class="directive">SSLStaplingCache</code> as well. For example:</p>
<pre class="prettyprint lang-config">SSLSessionCache "dbm:logs/ssl_scache"
SSLStaplingCache "dbm:logs/ssl_stapling"</pre>
<p>You can use the openssl command-line program to verify that an OCSP response
is sent by your server:</p>
<pre>$ openssl s_client -connect www.example.com:443 -status -servername www.example.com
...
OCSP response:
======================================
OCSP Response Data:
OCSP Response Status: successful (0x0)
Response Type: Basic OCSP Response
...
Cert Status: Good
...</pre>
<p>The following sections highlight the most common situations which require
further modification to the configuration. Refer also to the
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> reference manual.</p>
<h3>If more than a few SSL certificates are used for the server</h3>
<p>OCSP responses are stored in the SSL stapling cache. While the responses
are typically a few hundred to a few thousand bytes in size, mod_ssl
supports OCSP responses up to around 10K bytes in size. With more than a
few certificates, the stapling cache size (32768 bytes in the example above)
may need to be increased. Error message AH01929 will be logged in case of
an error storing a response.</p>
<h3>If the certificate does not point to an OCSP responder, or if a
different address must be used</h3>
<p>Refer to the
<code class="directive"><a href="../mod/mod_ssl.html#sslstaplingforceurl">SSLStaplingForceURL</a></code> directive.</p>
<p>You can confirm that a server certificate points to an OCSP responder
using the openssl command-line program, as follows:</p>
<pre>$ openssl x509 -in ./www.example.com.crt -text | grep 'OCSP.*http'
OCSP - URI:http://ocsp.example.com</pre>
<p>If the OCSP URI is provided and the web server can communicate to it
directly without using a proxy, no configuration is required. Note that
firewall rules that control outbound connections from the web server may
need to be adjusted.</p>
<p>If no OCSP URI is provided, contact your Certificate Authority to
determine if one is available; if so, configure it with
<code class="directive"><a href="../mod/mod_ssl.html#sslstaplingforceurl">SSLStaplingForceURL</a></code> in the virtual
host that uses the certificate.</p>
<h3>If multiple SSL-enabled virtual hosts are configured and OCSP
Stapling should be disabled for some</h3>
<p>Add <code>SSLUseStapling Off</code> to the virtual hosts for which OCSP
Stapling should be disabled.</p>
<h3>If the OCSP responder is slow or unreliable</h3>
<p>Several directives are available to handle timeouts and errors. Refer
to the documentation for the
<code class="directive"><a href="../mod/mod_ssl.html#sslstaplingfaketrylater">SSLStaplingFakeTryLater</a></code>,
<code class="directive"><a href="../mod/mod_ssl.html#sslstaplingrespondertimeout">SSLStaplingResponderTimeout</a></code>, and
<code class="directive"><a href="../mod/mod_ssl.html#sslstaplingreturnrespondererrors">SSLStaplingReturnResponderErrors</a></code>
directives.</p>
<h3>If mod_ssl logs error AH02217</h3>
<pre>AH02217: ssl_stapling_init_cert: Can't retrieve issuer certificate!</pre>
<p>In order to support OCSP Stapling when a particular server certificate is
used, the certificate chain for that certificate must be configured. If it
was not configured as part of enabling SSL, the AH02217 error will be issued
when stapling is enabled, and an OCSP response will not be provided for clients
using the certificate.</p>
<p>Refer to the <code class="directive"><a href="../mod/mod_ssl.html#sslcertificatechainfile">SSLCertificateChainFile</a></code>
and <code class="directive"><a href="../mod/mod_ssl.html#sslcertificatefile">SSLCertificateFile</a></code> for instructions
for configuring the certificate chain.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="accesscontrol" id="accesscontrol">Client Authentication and Access Control</a></h2>
<ul>
<li><a href="#allclients">How can I force clients to authenticate using certificates?</a></li>
<li><a href="#arbitraryclients">How can I force clients to authenticate using certificates for a
particular URL, but still allow arbitrary clients to access the rest of the server?</a></li>
<li><a href="#certauthenticate">How can I allow only clients who have certificates to access a
particular URL, but allow all clients to access the rest of the server?</a></li>
<li><a href="#intranet">How can I require HTTPS with strong ciphers, and either
basic authentication or client certificates, for access to part of the
Intranet website, for clients coming from the Internet?</a></li>
</ul>
<h3><a name="allclients" id="allclients">How can I force clients to authenticate using certificates?</a></h3>
<p>When you know all of your users (eg, as is often the case on a corporate
Intranet), you can require plain certificate authentication. All you
need to do is to create client certificates signed by your own CA
certificate (<code>ca.crt</code>) and then verify the clients against this
certificate.</p>
<pre class="prettyprint lang-config"># require a client certificate which has to be directly
# signed by our CA certificate in ca.crt
SSLVerifyClient require
SSLVerifyDepth 1
SSLCACertificateFile "conf/ssl.crt/ca.crt"</pre>
<h3><a name="arbitraryclients" id="arbitraryclients">How can I force clients to authenticate using certificates for a
particular URL, but still allow arbitrary clients to access the rest of the server?</a></h3>
<p>To force clients to authenticate using certificates for a particular URL,
you can use the per-directory reconfiguration features of
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>:</p>
<pre class="prettyprint lang-config">SSLVerifyClient none
SSLCACertificateFile "conf/ssl.crt/ca.crt"
<Location "/secure/area">
SSLVerifyClient require
SSLVerifyDepth 1
</Location></pre>
<h3><a name="certauthenticate" id="certauthenticate">How can I allow only clients who have certificates to access a
particular URL, but allow all clients to access the rest of the server?</a></h3>
<p>The key to doing this is checking that part of the client certificate
matches what you expect. Usually this means checking all or part of the
Distinguished Name (DN), to see if it contains some known string.
There are two ways to do this, using either <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> or
<code class="directive"><a href="../mod/mod_ssl.html#sslrequire">SSLRequire</a></code>.</p>
<p>The <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> method is generally required when
the certificates are completely arbitrary, or when their DNs have
no common fields (usually the organisation, etc.). In this case,
you should establish a password database containing <em>all</em>
clients allowed, as follows:</p>
<pre class="prettyprint lang-config">SSLVerifyClient none
SSLCACertificateFile "conf/ssl.crt/ca.crt"
SSLCACertificatePath "conf/ssl.crt"
<Directory "/usr/local/apache2/htdocs/secure/area">
SSLVerifyClient require
SSLVerifyDepth 5
SSLOptions +FakeBasicAuth
SSLRequireSSL
AuthName "Snake Oil Authentication"
AuthType Basic
AuthBasicProvider file
AuthUserFile "/usr/local/apache2/conf/httpd.passwd"
Require valid-user
</Directory></pre>
<p>The password used in this example is the DES encrypted string "password".
See the <code class="directive"><a href="../mod/mod_ssl.html#ssloptions">SSLOptions</a></code> docs for more
information.</p>
<div class="example"><h3>httpd.passwd</h3><pre>/C=DE/L=Munich/O=Snake Oil, Ltd./OU=Staff/CN=Foo:xxj31ZMTZzkVA
/C=US/L=S.F./O=Snake Oil, Ltd./OU=CA/CN=Bar:xxj31ZMTZzkVA
/C=US/L=L.A./O=Snake Oil, Ltd./OU=Dev/CN=Quux:xxj31ZMTZzkVA</pre></div>
<p>When your clients are all part of a common hierarchy, which is encoded
into the DN, you can match them more easily using <code class="directive"><a href="../mod/mod_ssl.html#sslrequire">SSLRequire</a></code>, as follows:</p>
<pre class="prettyprint lang-config">SSLVerifyClient none
SSLCACertificateFile "conf/ssl.crt/ca.crt"
SSLCACertificatePath "conf/ssl.crt"
<Directory "/usr/local/apache2/htdocs/secure/area">
SSLVerifyClient require
SSLVerifyDepth 5
SSLOptions +FakeBasicAuth
SSLRequireSSL
SSLRequire %{SSL_CLIENT_S_DN_O} eq "Snake Oil, Ltd." \
and %{SSL_CLIENT_S_DN_OU} in {"Staff", "CA", "Dev"}
</Directory></pre>
<h3><a name="intranet" id="intranet">How can I require HTTPS with strong ciphers, and either basic
authentication or client certificates, for access to part of the
Intranet website, for clients coming from the Internet? I still want to allow
plain HTTP access for clients on the Intranet.</a></h3>
<p>These examples presume that clients on the Intranet have IPs in the range
192.168.1.0/24, and that the part of the Intranet website you want to allow
internet access to is <code>/usr/local/apache2/htdocs/subarea</code>.
This configuration should remain outside of your HTTPS virtual host, so
that it applies to both HTTPS and HTTP.</p>
<pre class="prettyprint lang-config">SSLCACertificateFile "conf/ssl.crt/company-ca.crt"
<Directory "/usr/local/apache2/htdocs">
# Outside the subarea only Intranet access is granted
Require ip 192.168.1.0/24
</Directory>
<Directory "/usr/local/apache2/htdocs/subarea">
# Inside the subarea any Intranet access is allowed
# but from the Internet only HTTPS + Strong-Cipher + Password
# or the alternative HTTPS + Strong-Cipher + Client-Certificate
# If HTTPS is used, make sure a strong cipher is used.
# Additionally allow client certs as alternative to basic auth.
SSLVerifyClient optional
SSLVerifyDepth 1
SSLOptions +FakeBasicAuth +StrictRequire
SSLRequire %{SSL_CIPHER_USEKEYSIZE} >= 128
# Force clients from the Internet to use HTTPS
RewriteEngine on
RewriteCond "%{REMOTE_ADDR}" "!^192\.168\.1\.[0-9]+$"
RewriteCond "%{HTTPS}" "!=on"
RewriteRule "." "-" [F]
# Allow Network Access and/or Basic Auth
Satisfy any
# Network Access Control
Require ip 192.168.1.0/24
# HTTP Basic Authentication
AuthType basic
AuthName "Protected Intranet Area"
AuthBasicProvider file
AuthUserFile "conf/protected.passwd"
Require valid-user
</Directory></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="logging" id="logging">Logging</a></h2>
<p><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> can log extremely verbose debugging information
to the error log, when its <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> is
set to the higher trace levels. On the other hand, on a very busy server,
level <code>info</code> may already be too much. Remember that you can
configure the <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> per module to
suite your needs.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/ssl/ssl_howto.html" title="English"> en </a> |
<a href="../fr/ssl/ssl_howto.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/ssl/ssl_howto.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/ssl_faq.html 0000664 0001751 0001751 00000000315 13710016232 020140 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: ssl_faq.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: ssl_faq.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/ssl/ssl_faq.html.en 0000664 0001751 0001751 00000141436 14737241666 020600 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>SSL/TLS Strong Encryption: FAQ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">SSL/TLS</a></div><div id="page-content"><div id="preamble"><h1>SSL/TLS Strong Encryption: FAQ</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/ssl/ssl_faq.html" title="English"> en </a> |
<a href="../fr/ssl/ssl_faq.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<blockquote>
<p>The wise man doesn't give the right answers,
he poses the right questions.</p>
<p class="cite">-- <cite>Claude Levi-Strauss</cite></p>
</blockquote>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#installation">Installation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#aboutconfig">Configuration</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#aboutcerts">Certificates</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#aboutssl">The SSL Protocol</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#support">mod_ssl Support</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="installation" id="installation">Installation</a></h2>
<ul>
<li><a href="#mutex">Why do I get permission errors related to
SSLMutex when I start Apache?</a></li>
<li><a href="#entropy">Why does mod_ssl stop with the error "Failed to
generate temporary 512 bit RSA private key" when I start Apache?</a></li>
</ul>
<h3><a name="mutex" id="mutex">Why do I get permission errors related to
SSLMutex when I start Apache?</a></h3>
<p>Errors such as ``<code>mod_ssl: Child could not open
SSLMutex lockfile /opt/apache/logs/ssl_mutex.18332 (System error follows)
[...] System: Permission denied (errno: 13)</code>'' are usually
caused by overly restrictive permissions on the <em>parent</em> directories.
Make sure that all parent directories (here <code>/opt</code>,
<code>/opt/apache</code> and <code>/opt/apache/logs</code>) have the x-bit
set for, at minimum, the UID under which Apache's children are running (see
the <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> directive).</p>
<h3><a name="entropy" id="entropy">Why does mod_ssl stop with the error
"Failed to generate temporary 512 bit RSA private key" when I start
Apache?</a></h3>
<p>Cryptographic software needs a source of unpredictable data
to work correctly. Many open source operating systems provide
a "randomness device" that serves this purpose (usually named
<code>/dev/random</code>). On other systems, applications have to
seed the OpenSSL Pseudo Random Number Generator (PRNG) manually with
appropriate data before generating keys or performing public key
encryption. As of version 0.9.5, the OpenSSL functions that need
randomness report an error if the PRNG has not been seeded with
at least 128 bits of randomness.</p>
<p>To prevent this error, <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> has to provide
enough entropy to the PRNG to allow it to work correctly. This can
be done via the <code class="directive"><a href="../mod/mod_ssl.html#sslrandomseed">SSLRandomSeed</a></code>
directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="aboutconfig" id="aboutconfig">Configuration</a></h2>
<ul>
<li><a href="#parallel">Is it possible to provide HTTP and HTTPS from
the same server?</a></li>
<li><a href="#ports">Which port does HTTPS use?</a></li>
<li><a href="#httpstest">How do I speak HTTPS manually for testing
purposes?</a></li>
<li><a href="#hang">Why does the connection hang when I connect to my
SSL-aware Apache server?</a></li>
<li><a href="#refused">Why do I get ``Connection Refused'' errors, when
trying to access my newly installed Apache+mod_ssl server via HTTPS?</a></li>
<li><a href="#envvars">Why are the <code>SSL_XXX</code> variables not
available to my CGI & SSI scripts?</a></li>
<li><a href="#relative">How can I switch between HTTP and HTTPS in
relative hyperlinks?</a></li>
</ul>
<h3><a name="parallel" id="parallel">Is it possible to provide HTTP and HTTPS
from the same server?</a></h3>
<p>Yes. HTTP and HTTPS use different server ports (HTTP binds to
port 80, HTTPS to port 443), so there is no direct conflict between
them. You can either run two separate server instances bound to
these ports, or use Apache's elegant virtual hosting facility to
create two virtual servers, both served by the same instance of Apache
- one responding over HTTP to requests on port 80, and the other
responding over HTTPS to requests on port 443.</p>
<h3><a name="ports" id="ports">Which port does HTTPS use?</a></h3>
<p>You can run HTTPS on any port, but the standards specify port 443, which
is where any HTTPS compliant browser will look by default. You can force
your browser to look on a different port by specifying it in the URL. For
example, if your server is set up to serve pages over HTTPS on port 8080,
you can access them at <code>https://example.com:8080/</code></p>
<h3><a name="httpstest" id="httpstest">How do I speak HTTPS manually for testing purposes?</a></h3>
<p>While you usually just use</p>
<div class="example"><p><code>$ telnet localhost 80<br />
GET / HTTP/1.0</code></p></div>
<p>for simple testing of Apache via HTTP, it's not so easy for
HTTPS because of the SSL protocol between TCP and HTTP. With the
help of OpenSSL's <code>s_client</code> command, however, you can
do a similar check via HTTPS:</p>
<div class="example"><p><code>$ openssl s_client -connect localhost:443 -state -debug<br />
GET / HTTP/1.0</code></p></div>
<p>Before the actual HTTP response you will receive detailed
information about the SSL handshake. For a more general command
line client which directly understands both HTTP and HTTPS, can
perform GET and POST operations, can use a proxy, supports byte
ranges, etc. you should have a look at the nifty
<a href="http://curl.haxx.se/">cURL</a> tool. Using this, you can
check that Apache is responding correctly to requests via HTTP and
HTTPS as follows:</p>
<div class="example"><p><code>$ curl http://localhost/<br />
$ curl https://localhost/</code></p></div>
<h3><a name="hang" id="hang">Why does the connection hang when I connect
to my SSL-aware Apache server?</a></h3>
<p>This can happen when you try to connect to a HTTPS server (or virtual
server) via HTTP (eg, using <code>http://example.com/</code> instead of
<code>https://example.com</code>). It can also happen when trying to
connect via HTTPS to a HTTP server (eg, using
<code>https://example.com/</code> on a server which doesn't support HTTPS,
or which supports it on a non-standard port). Make sure that you're
connecting to a (virtual) server that supports SSL.</p>
<h3><a name="refused" id="refused">Why do I get ``Connection Refused'' messages,
when trying to access my newly installed Apache+mod_ssl server via HTTPS?</a></h3>
<p>
This error can be caused by an incorrect configuration.
Please make sure that your <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directives match your
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
directives. If all else fails, please start afresh, using the default
configuration provided by <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.</p>
<h3><a name="envvars" id="envvars">Why are the <code>SSL_XXX</code> variables
not available to my CGI & SSI scripts?</a></h3>
<p>Please make sure you have ``<code>SSLOptions +StdEnvVars</code>''
enabled for the context of your CGI/SSI requests.</p>
<h3><a name="relative" id="relative">How can I switch between HTTP and HTTPS in relative
hyperlinks?</a></h3>
<p>Usually, to switch between HTTP and HTTPS, you have to use
fully-qualified hyperlinks (because you have to change the URL
scheme). Using <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> however, you can
manipulate relative hyperlinks, to achieve the same effect.</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^/(.*)_SSL$" "https://%{SERVER_NAME}/$1" [R,L]
RewriteRule "^/(.*)_NOSSL$" "http://%{SERVER_NAME}/$1" [R,L]</pre>
<p>This rewrite ruleset lets you use hyperlinks of the form
<code><a href="document.html_SSL"></code>, to switch to HTTPS
in a relative link. (Replace SSL with NOSSL to switch to HTTP.)</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="aboutcerts" id="aboutcerts">Certificates</a></h2>
<ul>
<li><a href="#keyscerts">What are RSA Private Keys, CSRs and
Certificates?</a></li>
<li><a href="#startup">Is there a difference on startup between
a non-SSL-aware Apache and an SSL-aware Apache?</a></li>
<li><a href="#selfcert">How do I create a self-signed SSL
Certificate for testing purposes?</a></li>
<li><a href="#realcert">How do I create a real SSL Certificate?</a></li>
<li><a href="#ownca">How do I create and use my own Certificate
Authority (CA)?</a></li>
<li><a href="#passphrase">How can I change the pass-phrase on my private
key file?</a></li>
<li><a href="#removepassphrase">How can I get rid of the pass-phrase
dialog at Apache startup time?</a></li>
<li><a href="#verify">How do I verify that a private key matches its
Certificate?</a></li>
<li><a href="#pemder">How can I convert a certificate from PEM to DER
format?</a></li>
<li><a href="#gid">Why do browsers complain that they cannot
verify my server certificate?</a></li>
</ul>
<h3><a name="keyscerts" id="keyscerts">What are RSA Private Keys, CSRs and Certificates?</a></h3>
<p>An RSA private key file is a digital file that you can use to decrypt
messages sent to you. It has a public component which you distribute (via
your Certificate file) which allows people to encrypt those messages to
you.</p>
<p>A Certificate Signing Request (CSR) is a digital file which contains
your public key and your name. You send the CSR to a Certifying Authority
(CA), who will convert it into a real Certificate, by signing it.</p>
<p>A Certificate contains your
RSA public key, your name, the name of the CA, and is digitally signed by
the CA. Browsers that know the CA can verify the signature on that
Certificate, thereby obtaining your RSA public key. That enables them to
send messages which only you can decrypt.</p>
<p>See the <a href="ssl_intro.html">Introduction</a> chapter for a general
description of the SSL protocol.</p>
<h3><a name="startup" id="startup">Is there a difference on startup between
a non-SSL-aware Apache and an SSL-aware Apache?</a></h3>
<p>Yes. In general, starting Apache with
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> built-in is just like starting Apache
without it. However, if you have a passphrase on your SSL private
key file, a startup dialog will pop up which asks you to enter the
pass phrase.</p>
<p>Having to manually enter the passphrase when starting the server
can be problematic - for example, when starting the server from the
system boot scripts. In this case, you can follow the steps
<a href="#removepassphrase">below</a> to remove the passphrase from
your private key. Bear in mind that doing so brings additional security
risks - proceed with caution!</p>
<h3><a name="selfcert" id="selfcert">How do I create a self-signed SSL
Certificate for testing purposes?</a></h3>
<ol>
<li>Make sure OpenSSL is installed and in your <code>PATH</code>.<br />
<br />
</li>
<li>Run the following command, to create <code>server.key</code> and
<code>server.crt</code> files:<br />
<code><strong>$ openssl req -new -x509 -nodes -out server.crt
-keyout server.key</strong></code><br />
These can be used as follows in your <code>httpd.conf</code>
file:
<pre class="prettyprint lang-config">SSLCertificateFile "/path/to/this/server.crt"
SSLCertificateKeyFile "/path/to/this/server.key"</pre>
</li>
<li>It is important that you are aware that this
<code>server.key</code> does <em>not</em> have any passphrase.
To add a passphrase to the key, you should run the following
command, and enter & verify the passphrase as requested.<br />
<p><code><strong>$ openssl rsa -des3 -in server.key -out
server.key.new</strong></code><br />
<code><strong>$ mv server.key.new server.key</strong></code><br /></p>
Please backup the <code>server.key</code> file, and the passphrase
you entered, in a secure location.
</li>
</ol>
<h3><a name="realcert" id="realcert">How do I create a real SSL Certificate?</a></h3>
<p>Here is a step-by-step description:</p>
<ol>
<li>Make sure OpenSSL is installed and in your <code>PATH</code>.
<br />
<br />
</li>
<li>Create a RSA private key for your Apache server
(will be Triple-DES encrypted and PEM formatted):<br />
<br />
<code><strong>$ openssl genrsa -des3 -out server.key 2048</strong></code><br />
<br />
Please backup this <code>server.key</code> file and the
pass-phrase you entered in a secure location.
You can see the details of this RSA private key by using the command:<br />
<br />
<code><strong>$ openssl rsa -noout -text -in server.key</strong></code><br />
<br />
If necessary, you can also create a decrypted PEM version (not
recommended) of this RSA private key with:<br />
<br />
<code><strong>$ openssl rsa -in server.key -out server.key.unsecure</strong></code><br />
<br />
</li>
<li>Create a Certificate Signing Request (CSR) with the server RSA private
key (output will be PEM formatted):<br />
<br />
<code><strong>$ openssl req -new -key server.key -out server.csr</strong></code><br />
<br />
Make sure you enter the FQDN ("Fully Qualified Domain Name") of the
server when OpenSSL prompts you for the "CommonName", i.e. when you
generate a CSR for a website which will be later accessed via
<code>https://www.foo.dom/</code>, enter "www.foo.dom" here.
You can see the details of this CSR by using<br />
<br />
<code><strong>$ openssl req -noout -text -in server.csr</strong></code><br />
<br />
</li>
<li>You now have to send this Certificate Signing Request (CSR) to
a Certifying Authority (CA) to be signed. Once the CSR has been
signed, you will have a real Certificate, which can be used by
Apache. You can have a CSR signed by a commercial CA, or you can
create your own CA to sign it.<br />
Commercial CAs usually ask you to post the CSR into a web form,
pay for the signing, and then send a signed Certificate, which
you can store in a server.crt file.<br />
For details on how to create your own CA, and use this to sign
a CSR, see <a href="#ownca">below</a>.<br />
Once your CSR has been signed, you can see the details of the
Certificate as follows:<br />
<br />
<code><strong>$ openssl x509 -noout -text -in server.crt</strong></code><br />
</li>
<li>You should now have two files: <code>server.key</code> and
<code>server.crt</code>. These can be used as follows in your
<code>httpd.conf</code> file:
<pre class="prettyprint lang-config">SSLCertificateFile "/path/to/this/server.crt"
SSLCertificateKeyFile "/path/to/this/server.key"</pre>
The <code>server.csr</code> file is no longer needed.
</li>
</ol>
<h3><a name="ownca" id="ownca">How do I create and use my own Certificate Authority (CA)?</a></h3>
<p>The short answer is to use the <code>CA.sh</code> or <code>CA.pl</code>
script provided by OpenSSL. Unless you have a good reason not to,
you should use these for preference. If you cannot, you can create a
self-signed certificate as follows:</p>
<ol>
<li>Create a RSA private key for your server
(will be Triple-DES encrypted and PEM formatted):<br />
<br />
<code><strong>$ openssl genrsa -des3 -out server.key 2048</strong></code><br />
<br />
Please backup this <code>server.key</code> file and the
pass-phrase you entered in a secure location.
You can see the details of this RSA private key by using the
command:<br />
<br />
<code><strong>$ openssl rsa -noout -text -in server.key</strong></code><br />
<br />
If necessary, you can also create a decrypted PEM version (not
recommended) of this RSA private key with:<br />
<br />
<code><strong>$ openssl rsa -in server.key -out server.key.unsecure</strong></code><br />
<br />
</li>
<li>Create a self-signed certificate (X509 structure)
with the RSA key you just created (output will be PEM formatted):<br />
<br />
<code><strong>$ openssl req -new -x509 -nodes -sha1 -days 365
-key server.key -out server.crt -extensions usr_cert</strong></code><br />
<br />
This signs the server CSR and results in a <code>server.crt</code> file.<br />
You can see the details of this Certificate using:<br />
<br />
<code><strong>$ openssl x509 -noout -text -in server.crt</strong></code><br />
<br />
</li>
</ol>
<h3><a name="passphrase" id="passphrase">How can I change the pass-phrase on my private key file?</a></h3>
<p>You simply have to read it with the old pass-phrase and write it again,
specifying the new pass-phrase. You can accomplish this with the following
commands:</p>
<p><code><strong>$ openssl rsa -des3 -in server.key -out server.key.new</strong></code><br />
<code><strong>$ mv server.key.new server.key</strong></code><br /></p>
<p>The first time you're asked for a PEM pass-phrase, you should
enter the old pass-phrase. After that, you'll be asked again to
enter a pass-phrase - this time, use the new pass-phrase. If you
are asked to verify the pass-phrase, you'll need to enter the new
pass-phrase a second time.</p>
<h3><a name="removepassphrase" id="removepassphrase">How can I get rid of the pass-phrase dialog at Apache startup time?</a></h3>
<p>The reason this dialog pops up at startup and every re-start
is that the RSA private key inside your server.key file is stored in
encrypted format for security reasons. The pass-phrase is needed to decrypt
this file, so it can be read and parsed. Removing the pass-phrase
removes a layer of security from your server - proceed with caution!</p>
<ol>
<li>Remove the encryption from the RSA private key (while
keeping a backup copy of the original file):<br />
<br />
<code><strong>$ cp server.key server.key.org</strong></code><br />
<code><strong>$ openssl rsa -in server.key.org -out server.key</strong></code><br />
<br />
</li>
<li>Make sure the server.key file is only readable by root:<br />
<br />
<code><strong>$ chmod 400 server.key</strong></code><br />
<br />
</li>
</ol>
<p>Now <code>server.key</code> contains an unencrypted copy of the key.
If you point your server at this file, it will not prompt you for a
pass-phrase. HOWEVER, if anyone gets this key they will be able to
impersonate you on the net. PLEASE make sure that the permissions on this
file are such that only root or the web server user can read it
(preferably get your web server to start as root but run as another
user, and have the key readable only by root).</p>
<p>As an alternative approach you can use the ``<code>SSLPassPhraseDialog
exec:/path/to/program</code>'' facility. Bear in mind that this is
neither more nor less secure, of course.</p>
<h3><a name="verify" id="verify">How do I verify that a private key matches its Certificate?</a></h3>
<p>A private key contains a series of numbers. Two of these numbers form
the "public key", the others are part of the "private key". The "public
key" bits are included when you generate a CSR, and subsequently form
part of the associated Certificate.</p>
<p>To check that the public key in your Certificate matches the public
portion of your private key, you simply need to compare these numbers.
To view the Certificate and the key run the commands:</p>
<p><code><strong>$ openssl x509 -noout -text -in server.crt</strong></code><br />
<code><strong>$ openssl rsa -noout -text -in server.key</strong></code></p>
<p>The `modulus' and the `public exponent' portions in the key and the
Certificate must match. As the public exponent is usually 65537
and it's difficult to visually check that the long modulus numbers
are the same, you can use the following approach:</p>
<p><code><strong>$ openssl x509 -noout -modulus -in server.crt | openssl md5</strong></code><br />
<code><strong>$ openssl rsa -noout -modulus -in server.key | openssl md5</strong></code></p>
<p>This leaves you with two rather shorter numbers to compare. It is,
in theory, possible that these numbers may be the same, without the
modulus numbers being the same, but the chances of this are
overwhelmingly remote.</p>
<p>Should you wish to check to which key or certificate a particular
CSR belongs you can perform the same calculation on the CSR as
follows:</p>
<p><code><strong>$ openssl req -noout -modulus -in server.csr | openssl md5</strong></code></p>
<h3><a name="pemder" id="pemder">How can I convert a certificate from PEM to DER format?</a></h3>
<p>The default certificate format for OpenSSL is PEM, which is simply
Base64 encoded DER, with header and footer lines. For some applications
(e.g. Microsoft Internet Explorer) you need the certificate in plain DER
format. You can convert a PEM file <code>cert.pem</code> into the
corresponding DER file <code>cert.der</code> using the following command:
<code><strong>$ openssl x509 -in cert.pem -out cert.der -outform DER</strong></code></p>
<h3><a name="gid" id="gid">Why do browsers complain that they cannot verify my server certificate?</a></h3>
<p>One reason this might happen is because your server certificate is signed
by an intermediate CA. Various CAs, such as Verisign or Thawte, have started
signing certificates not with their root certificate but with intermediate
certificates.</p>
<p>Intermediate CA certificates lie between the root CA certificate (which is
installed in the browsers) and the server certificate (which you installed
on the server). In order for the browser to be able to traverse and verify
the trust chain from the server certificate to the root certificate it
needs need to be given the intermediate certificates. The CAs should
be able to provide you such intermediate certificate packages that can be
installed on the server.</p>
<p>You need to include those intermediate certificates with the
<code class="directive"><a href="../mod/mod_ssl.html#sslcertificatechainfile">SSLCertificateChainFile</a></code>
directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="aboutssl" id="aboutssl">The SSL Protocol</a></h2>
<ul>
<li><a href="#random">Why do I get lots of random SSL protocol
errors under heavy server load?</a></li>
<li><a href="#load">Why does my webserver have a higher load, now
that it serves SSL encrypted traffic?</a></li>
<li><a href="#establishing">Why do HTTPS connections to my server
sometimes take up to 30 seconds to establish a connection?</a></li>
<li><a href="#ciphers">What SSL Ciphers are supported by mod_ssl?</a></li>
<li><a href="#adh">Why do I get ``no shared cipher'' errors, when
trying to use Anonymous Diffie-Hellman (ADH) ciphers?</a></li>
<li><a href="#sharedciphers">Why do I get a 'no shared ciphers'
error when connecting to my newly installed server?</a></li>
<li><a href="#vhosts">Why can't I use SSL with name-based/non-IP-based
virtual hosts?</a></li>
<li><a href="#vhosts2">Is it possible to use Name-Based Virtual
Hosting to identify different SSL virtual hosts?</a></li>
<li><a href="#comp">How do I get SSL compression working?</a></li>
<li><a href="#lockicon">When I use Basic Authentication over HTTPS
the lock icon in Netscape browsers stays unlocked when the dialog pops up.
Does this mean the username/password is being sent unencrypted?</a></li>
<li><a href="#msie">Why do I get I/O errors when connecting via
HTTPS to an Apache+mod_ssl server with Microsoft Internet Explorer
(MSIE)?</a></li>
<li><a href="#srp">How do I enable TLS-SRP?</a></li>
<li><a href="#javadh">Why do I get handshake failures with Java-based clients when using a certificate with more than 1024 bits?</a></li>
</ul>
<h3><a name="random" id="random">Why do I get lots of random SSL protocol
errors under heavy server load?</a></h3>
<p>There can be a number of reasons for this, but the main one
is problems with the SSL session Cache specified by the
<code class="directive"><a href="../mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code> directive. The DBM session
cache is the most likely source of the problem, so using the SHM session cache (or
no cache at all) may help.</p>
<h3><a name="load" id="load">Why does my webserver have a higher load, now
that it serves SSL encrypted traffic?</a></h3>
<p>SSL uses strong cryptographic encryption, which necessitates a lot of
number crunching. When you request a webpage via HTTPS, everything (even
the images) is encrypted before it is transferred. So increased HTTPS
traffic leads to load increases.</p>
<h3><a name="establishing" id="establishing">Why do HTTPS connections to my server
sometimes take up to 30 seconds to establish a connection?</a></h3>
<p>This is usually caused by a <code>/dev/random</code> device for
<code class="directive"><a href="../mod/mod_ssl.html#sslrandomseed">SSLRandomSeed</a></code> which blocks the
read(2) call until enough entropy is available to service the
request. More information is available in the reference
manual for the <code class="directive"><a href="../mod/mod_ssl.html#sslrandomseed">SSLRandomSeed</a></code>
directive.</p>
<h3><a name="ciphers" id="ciphers">What SSL Ciphers are supported by mod_ssl?</a></h3>
<p>Usually, any SSL ciphers supported by the version of OpenSSL in use,
are also supported by <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>. Which ciphers are
available can depend on the way you built OpenSSL. Typically, at
least the following ciphers are supported:</p>
<ol>
<li>RC4 with SHA1</li>
<li>AES with SHA1</li>
<li>Triple-DES with SHA1</li>
</ol>
<p>To determine the actual list of ciphers available, you should run
the following:</p>
<div class="example"><p><code>$ openssl ciphers -v</code></p></div>
<h3><a name="adh" id="adh">Why do I get ``no shared cipher'' errors, when
trying to use Anonymous Diffie-Hellman (ADH) ciphers?</a></h3>
<p>By default, OpenSSL does <em>not</em> allow ADH ciphers, for security
reasons. Please be sure you are aware of the potential side-effects
if you choose to enable these ciphers.</p>
<p>In order to use Anonymous Diffie-Hellman (ADH) ciphers, you must
build OpenSSL with ``<code>-DSSL_ALLOW_ADH</code>'', and then add
``<code>ADH</code>'' into your <code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code>.</p>
<h3><a name="sharedciphers" id="sharedciphers">Why do I get a 'no shared ciphers'
error when connecting to my newly installed server?</a></h3>
<p>Either you have made a mistake with your
<code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code>
directive (compare it with the pre-configured example in
<code>extra/httpd-ssl.conf</code>) or you chose to use DSA/DH
algorithms instead of RSA when you generated your private key
and ignored or overlooked the warnings. If you have chosen
DSA/DH, then your server cannot communicate using RSA-based SSL
ciphers (at least until you configure an additional RSA-based
certificate/key pair). Modern browsers like NS or IE can only
communicate over SSL using RSA ciphers. The result is the
"no shared ciphers" error. To fix this, regenerate your server
certificate/key pair, using the RSA algorithm.</p>
<h3><a name="vhosts" id="vhosts">Why can't I use SSL with name-based/non-IP-based virtual hosts?</a></h3>
<p>The reason is very technical, and a somewhat "chicken and egg" problem.
The SSL protocol layer stays below the HTTP protocol layer and
encapsulates HTTP. When an SSL connection (HTTPS) is established
Apache/mod_ssl has to negotiate the SSL protocol parameters with the
client. For this, mod_ssl has to consult the configuration of the virtual
server (for instance it has to look for the cipher suite, the server
certificate, etc.). But in order to go to the correct virtual server
Apache has to know the <code>Host</code> HTTP header field. To do this, the
HTTP request header has to be read. This cannot be done before the SSL
handshake is finished, but the information is needed in order to
complete the SSL handshake phase. See the next question for how to
circumvent this issue.</p>
<p>Note that if you have a wildcard SSL certificate, or a
certificate that has multiple hostnames on it using subjectAltName
fields, you can use SSL on name-based virtual hosts without further
workarounds.</p>
<h3><a name="vhosts2" id="vhosts2">Is it possible to use Name-Based
Virtual Hosting to identify different SSL virtual hosts?</a></h3>
<p>Name-Based Virtual Hosting is a very popular method of identifying
different virtual hosts. It allows you to use the same IP address and
the same port number for many different sites. When people move on to
SSL, it seems natural to assume that the same method can be used to have
lots of different SSL virtual hosts on the same server.</p>
<p>It is possible, but only if using a 2.2.12 or later web server,
built with 0.9.8j or later OpenSSL. This is because it requires a
feature that only the most recent revisions of the SSL
specification added, called Server Name Indication (SNI).</p>
<p>Note that if you have a wildcard SSL certificate, or a
certificate that has multiple hostnames on it using subjectAltName
fields, you can use SSL on name-based virtual hosts without further
workarounds.</p>
<p>The reason is that the SSL protocol is a separate layer which
encapsulates the HTTP protocol. So the SSL session is a separate
transaction, that takes place before the HTTP session has begun.
The server receives an SSL request on IP address X and port Y
(usually 443). Since the SSL request did not contain any Host:
field, the server had no way to decide which SSL virtual host to use.
Usually, it just used the first one it found which matched the
port and IP address specified.</p>
<p>If you are using a version of the web server and OpenSSL that
support SNI, though, and the client's browser also supports SNI,
then the hostname is included in the original SSL request, and the
web server can select the correct SSL virtual host.</p>
<p>You can, of course, use Name-Based Virtual Hosting to identify many
non-SSL virtual hosts (all on port 80, for example) and then
have a single SSL virtual host (on port 443). But if you do this,
you must make sure to put the non-SSL port number on the NameVirtualHost
directive, e.g.</p>
<pre class="prettyprint lang-config">NameVirtualHost 192.168.1.1:80</pre>
<p>Other workaround solutions include: </p>
<p>Using separate IP addresses for different SSL hosts.
Using different port numbers for different SSL hosts.</p>
<h3><a name="comp" id="comp">How do I get SSL compression working?</a></h3>
<p>Although SSL compression negotiation was defined in the specification
of SSLv2 and TLS, it took until May 2004 for RFC 3749 to define DEFLATE as
a negotiable standard compression method.
</p>
<p>OpenSSL 0.9.8 started to support this by default when compiled with the
<code>zlib</code> option. If both the client and the server support compression,
it will be used. However, most clients still try to initially connect with an
SSLv2 Hello. As SSLv2 did not include an array of preferred compression algorithms
in its handshake, compression cannot be negotiated with these clients.
If the client disables support for SSLv2, either an SSLv3 or TLS Hello
may be sent, depending on which SSL library is used, and compression may
be set up. You can verify whether clients make use of SSL compression by
logging the <code>%{SSL_COMPRESS_METHOD}x</code> variable.
</p>
<h3><a name="lockicon" id="lockicon">When I use Basic Authentication over HTTPS
the lock icon in Netscape browsers stays unlocked when the dialog pops up.
Does this mean the username/password is being sent unencrypted?</a></h3>
<p>No, the username/password is transmitted encrypted. The icon in
Netscape browsers is not actually synchronized with the SSL/TLS layer.
It only toggles to the locked state when the first part of the actual
webpage data is transferred, which may confuse people. The Basic
Authentication facility is part of the HTTP layer, which is above
the SSL/TLS layer in HTTPS. Before any HTTP data communication takes
place in HTTPS, the SSL/TLS layer has already completed its handshake
phase, and switched to encrypted communication. So don't be
confused by this icon.</p>
<h3><a name="msie" id="msie">Why do I get I/O errors when connecting via
HTTPS to an Apache+mod_ssl server with older versions of Microsoft Internet
Explorer (MSIE)?</a></h3>
<p>The first reason is that the SSL implementation in some MSIE versions has
some subtle bugs related to the HTTP keep-alive facility and the SSL close
notify alerts on socket connection close. Additionally the interaction
between SSL and HTTP/1.1 features are problematic in some MSIE versions.
You can work around these problems by forcing Apache not to use HTTP/1.1,
keep-alive connections or send the SSL close notify messages to MSIE clients.
This can be done by using the following directive in your SSL-aware
virtual host section:</p>
<pre class="prettyprint lang-config">SetEnvIf User-Agent "MSIE [2-5]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0</pre>
<p>Further, some MSIE versions have problems with particular ciphers.
Unfortunately, it is not possible to implement a MSIE-specific
workaround for this, because the ciphers are needed as early as the
SSL handshake phase. So a MSIE-specific
<code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> won't solve these
problems. Instead, you will have to make more drastic
adjustments to the global parameters. Before you decide to do
this, make sure your clients really have problems. If not, do not
make these changes - they will affect <em>all</em> your clients, MSIE
or otherwise.</p>
<h3><a name="srp" id="srp">How do I enable TLS-SRP?</a></h3>
<p>TLS-SRP (Secure Remote Password key exchange for TLS, specified in RFC 5054)
can supplement or replace certificates in authenticating an SSL connection.
To use TLS-SRP, set the
<code class="directive"><a href="../mod/mod_ssl.html#sslsrpverifierfile">SSLSRPVerifierFile</a></code> directive to
point to an OpenSSL SRP verifier file. To create the verifier file, use the
<code>openssl</code> tool:</p>
<div class="example"><p><code>
openssl srp -srpvfile passwd.srpv -add username
</code></p></div>
<p>After creating this file, specify it in the SSL server configuration:</p>
<div class="example"><p><code>
SSLSRPVerifierFile /path/to/passwd.srpv
</code></p></div>
<p>To force clients to use non-certificate TLS-SRP cipher suites, use the
following directive:</p>
<div class="example"><p><code>
SSLCipherSuite "!DSS:!aRSA:SRP"
</code></p></div>
<h3><a name="javadh" id="javadh">Why do I get handshake failures with Java-based clients when using a certificate with more than 1024 bits?</a></h3>
<p>Beginning with version 2.4.7,
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> will use DH parameters which include primes
with lengths of more than 1024 bits. Java 7 and earlier limit their
support for DH prime sizes to a maximum of 1024 bits, however.</p>
<p>If your Java-based client aborts with exceptions such as
<code>java.lang.RuntimeException: Could not generate DH keypair</code> and
<code>java.security.InvalidAlgorithmParameterException: Prime size must be
multiple of 64, and can only range from 512 to 1024 (inclusive)</code>,
and httpd logs <code>tlsv1 alert internal error (SSL alert number 80)</code>
(at <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> <code>info</code>
or higher), you can either rearrange mod_ssl's cipher list with
<code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code>
(possibly in conjunction with <code class="directive"><a href="../mod/mod_ssl.html#sslhonorcipherorder">SSLHonorCipherOrder</a></code>),
or you can use custom DH parameters with a 1024-bit prime, which
will always have precedence over any of the built-in DH parameters.</p>
<p>To generate custom DH parameters, use the <code>openssl dhparam 1024</code>
command. Alternatively, you can use the following standard 1024-bit DH
parameters from <a href="http://www.ietf.org/rfc/rfc2409.txt">RFC 2409</a>,
section 6.2:</p>
<div class="example"><pre>-----BEGIN DH PARAMETERS-----
MIGHAoGBAP//////////yQ/aoiFowjTExmKLgNwc0SkCTgiKZ8x0Agu+pjsTmyJR
Sgh5jjQE3e+VGbPNOkMbMCsKbfJfFDdP4TVtbVHCReSFtXZiXn7G9ExC6aY37WsL
/1y29Aa37e44a/taiZ+lrp8kEXxLH+ZJKGZR7OZTgf//////////AgEC
-----END DH PARAMETERS-----</pre></div>
<p>Add the custom parameters including the "BEGIN DH PARAMETERS" and
"END DH PARAMETERS" lines to the end of the first certificate file
you have configured using the
<code class="directive"><a href="../mod/mod_ssl.html#sslcertificatefile">SSLCertificateFile</a></code> directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="support" id="support">mod_ssl Support</a></h2>
<ul>
<li><a href="#resources">What information resources are available in
case of mod_ssl problems?</a></li>
<li><a href="#contact">What support contacts are available in case of
mod_ssl problems?</a></li>
<li><a href="#reportdetails">What information should I
provide when writing a bug report?</a></li>
<li><a href="#coredumphelp">I had a core dump, can you help me?</a></li>
<li><a href="#backtrace">How do I get a backtrace, to help find the reason
for my core dump?</a></li>
</ul>
<h3><a name="resources" id="resources">What information resources are available in case of mod_ssl problems?</a></h3>
<p>The following information resources are available.
In case of problems you should search here first.</p>
<dl>
<dt>Answers in the User Manual's F.A.Q. List (this)</dt>
<dd><a href="http://httpd.apache.org/docs/2.4/ssl/ssl_faq.html">
http://httpd.apache.org/docs/2.4/ssl/ssl_faq.html</a><br />
First check the F.A.Q. (this text). If your problem is a common
one, it may have been answered several times before, and been included
in this doc.
</dd>
</dl>
<h3><a name="contact" id="contact">What support contacts are available in case
of mod_ssl problems?</a></h3>
<p>The following lists all support possibilities for mod_ssl, in order of
preference. Please go through these possibilities
<em>in this order</em> - don't just pick the one you like the look of. </p>
<ol>
<li><em>Send a Problem Report to the Apache httpd Users Support Mailing List</em><br />
<a href="mailto:users@httpd.apache.org">
users@httpd.apache.org</a><br />
This is the second way of submitting your problem report. Again, you must
subscribe to the list first, but you can then easily discuss your problem
with the whole Apache httpd user community.
</li>
<li><em>Write a Problem Report in the Bug Database</em><br />
<a href="http://httpd.apache.org/bug_report.html">
http://httpd.apache.org/bug_report.html</a><br />
This is the last way of submitting your problem report. You should only
do this if you've already posted to the mailing lists, and had no success.
Please follow the instructions on the above page <em>carefully</em>.
</li>
</ol>
<h3><a name="reportdetails" id="reportdetails">What information should I
provide when writing a bug report?</a></h3>
<p>You should always provide at least the following information:</p>
<dl>
<dt>Apache httpd and OpenSSL version information</dt>
<dd>The Apache version can be determined
by running <code>httpd -v</code>. The OpenSSL version can be
determined by running <code>openssl version</code>. Alternatively, if
you have Lynx installed, you can run the command <code>lynx -mime_header
http://localhost/ | grep Server</code> to gather this information in a
single step.
</dd>
<dt>The details on how you built and installed Apache httpd and OpenSSL</dt>
<dd>For this you can provide a logfile of your terminal session which shows
the configuration and install steps. If this is not possible, you
should at least provide the <code class="program"><a href="../programs/configure.html">configure</a></code> command line you used.
</dd>
<dt>In case of core dumps please include a Backtrace</dt>
<dd>If your Apache httpd dumps its core, please attach
a stack-frame ``backtrace'' (see <a href="#backtrace">below</a>
for information on how to get this). This information is required
in order to find a reason for your core dump.
</dd>
<dt>A detailed description of your problem</dt>
<dd>Don't laugh, we really mean it! Many problem reports don't
include a description of what the actual problem is. Without this,
it's very difficult for anyone to help you. So, it's in your own
interest (you want the problem be solved, don't you?) to include as
much detail as possible, please. Of course, you should still include
all the essentials above too.
</dd>
</dl>
<h3><a name="coredumphelp" id="coredumphelp">I had a core dump, can you help me?</a></h3>
<p>In general no, at least not unless you provide more details about the code
location where Apache dumped core. What is usually always required in
order to help you is a backtrace (see next question). Without this
information it is mostly impossible to find the problem and help you in
fixing it.</p>
<h3><a name="backtrace" id="backtrace">How do I get a backtrace, to help find
the reason for my core dump?</a></h3>
<p>Following are the steps you will need to complete, to get a backtrace:</p>
<ol>
<li>Make sure you have debugging symbols available, at least
in Apache. On platforms where you use GCC/GDB, you will have to build
Apache+mod_ssl with ``<code>OPTIM="-g -ggdb3"</code>'' to get this. On
other platforms at least ``<code>OPTIM="-g"</code>'' is needed.
</li>
<li>Start the server and try to reproduce the core-dump. For this you may
want to use a directive like ``<code>CoreDumpDirectory /tmp</code>'' to
make sure that the core-dump file can be written. This should result
in a <code>/tmp/core</code> or <code>/tmp/httpd.core</code> file. If you
don't get one of these, try running your server under a non-root UID.
Many modern kernels do not allow a process to dump core after it has
done a <code>setuid()</code> (unless it does an <code>exec()</code>) for
security reasons (there can be privileged information left over in
memory). If necessary, you can run <code>/path/to/httpd -X</code>
manually to force Apache to not fork.
</li>
<li>Analyze the core-dump. For this, run <code>gdb /path/to/httpd
/tmp/httpd.core</code> or a similar command. In GDB, all you
have to do then is to enter <code>bt</code>, and voila, you get the
backtrace. For other debuggers consult your local debugger manual.
</li>
</ol>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/ssl/ssl_faq.html" title="English"> en </a> |
<a href="../fr/ssl/ssl_faq.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/ssl/ssl_faq.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/ssl/ssl_compat.html 0000664 0001751 0001751 00000000323 13710016232 020653 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: ssl_compat.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: ssl_compat.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/ssl/ssl_intro.html 0000664 0001751 0001751 00000000452 13710016232 020526 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: ssl_intro.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: ssl_intro.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: ssl_intro.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/stopping.html.de 0000664 0001751 0001751 00000047032 14744525602 020166 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Beenden und Neustarten - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Beenden und Neustarten</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<p>Dieses Dokument umfasst das Beenden und Neustarten des
Apache auf Unix-ähnlichen Systemen. Anwender von Windows NT, 2000
und XP sollten <a href="platform/windows.html#winsvc">Betreiben
des Apache als Dienst</a> lesen, während hingegen Anwender von
Windows 9x sowie ME <a href="platform/windows.html#wincons">Betreiben
des Apache als Konsolenanwendung</a> lesen sollten, um mehr Informationen
zur Handhabung des Apache auf diesen Systemen zu erhalten.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Einleitung</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#term">Beenden</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#graceful">Unterbrechungsfreier Neustart</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#hup">Neustarten</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#race">Anhang: Signale und Wettkampfsituationen</a></li>
</ul><h3>Siehe auch</h3><ul class="seealso"><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="#comments_section">Kommentare</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="introduction" id="introduction">Einleitung</a></h2>
<p>Um den Apache zu stoppen oder neu zu starten, müssen Sie
ein Signal an den laufenden <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Prozess senden. Es gibt
zwei Möglichkeiten, diese Signale zu senden. Zum einen können
Sie den Unix-Befehl <code>kill</code> verwenden, um den Prozessen
direkt Signale zu senden. Sie werden feststellen, dass auf Ihrem
System mehrere <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programme laufen. Sie sollten
jedoch nicht jedem dieser Prozesse ein Signal senden, sondern nur dem
Elternprozess, dessen PID im <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> steht. Das heißt, Sie
sollten es niemals nötig haben, einem anderen Prozess, als dem
Elternprozess, ein Signal zu senden. Es gibt drei Signale, die Sie an den
Elternprozess senden können: <code><a href="#term">TERM</a></code>,
<code><a href="#hup">HUP</a></code> und
<code><a href="#graceful">USR1</a></code>, die nachfolgend beschrieben
werden.</p>
<p>Um dem Elternprozess ein Signal zu senden, verwenden Sie einen
Befehl wie z.B.:</p>
<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
<p>Die zweite Methode, dem <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Prozess zu
signalisieren, ist die Verwendung der <code>-k</code>-Befehlszeilenoptionen
<code>stop</code>, <code>restart</code> und <code>graceful</code>, wie
unten beschrieben. Dies sind Argumente des <code class="program"><a href="./programs/httpd.html">httpd</a></code>-Programms, es wird jedoch
empfohlen, sie unter Verwendung des Steuerskripts <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> zu senden, welches diese
an <code class="program"><a href="./programs/httpd.html">httpd</a></code> durchreicht.</p>
<p>Nachdem Sie <code class="program"><a href="./programs/httpd.html">httpd</a></code> signalisiert haben, können Sie
dessen Fortschritt beobachten, indem Sie eingeben:</p>
<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
<p>Passen Sie diese Beispiele entsprechend Ihren <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>- und <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>-Einstellungen an.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="term" id="term">Beenden</a></h2>
<dl><dt>Signal: TERM</dt>
<dd><code>apachectl -k stop</code></dd>
</dl>
<p>Das Senden des <code>TERM</code>- oder <code>stop</code>-Signals an
den Elternprozess veranlasst diesen, sofort zu versuchen, alle seine
Kindprozesse zu beenden. Es kann einige Sekunden dauern, bis alle
Kindprozesse komplett beendet sind. Danach beendet sich der Elternprozess
selbst. Alle gerade bearbeiteten Anfragen werden abgebrochen.
Es werden keine weiteren Anfragen mehr bedient.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="graceful" id="graceful">Unterbrechungsfreier Neustart</a></h2>
<dl><dt>Signal: USR1</dt>
<dd><code>apachectl -k graceful</code></dd>
</dl>
<p>Das <code>USR1</code>- oder <code>graceful</code>-Signal
veranlasst den Elternprozess, die Kinder <em>anzuweisen</em>, sich
nach Abschluß ihrer momentanen bearbeiteten Anfrage zu beenden
(oder sich sofort zu beenden, wenn sie gerade keine Anfrage bedienen).
Der Elternprozess liest seine Konfigurationsdateien erneut ein und
öffnet seine Logdateien neu. Wenn ein Kindprozess stirbt,
ersetzt der Elternprozess ihn durch ein Kind der neuen
Konfigurations-<em>Generation</em>. Dieses beginnt sofort damit,
neue Anfragen zu bedienen.</p>
<div class="note">Auf bestimmten Plattformen, welche kein <code>USR1</code>
für einen unterbrechungsfreien Neustart erlauben, kann ein
alternatives Signal verwendet werden (wie z.B.
<code>WINCH</code>). Der Befehl <code>apachectl graceful</code>
sendet das jeweils richtige Signal für Ihre Platform.</div>
<p>Der Code ist dafür ausgelegt, stets die MPM-Direktiven
zur Prozesssteuerung zu beachten, so dass die Anzahl der Prozesse
und Threads, die zur Bedienung der Clients bereitstehen, während
des Neustarts auf die entsprechenden Werte gesetzt werden.
Weiterhin wird <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
auf folgende Art und Weise interpretiert: Wenn nach einer Sekunde
nicht mindestens <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
neue Kindprozesse erstellt wurden, dann werden, um den Durchsatz zu
beschleunigen, entsprechend weitere erstellt. Auf diese Weise versucht
der Code sowohl die Anzahl der Kinder entsprechend der Serverlast
anzupassen als auch Ihre Wünsche hinsichtlich des Parameters
<code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> zu
berücksichtigen.</p>
<p>Benutzer von <code class="module"><a href="./mod/mod_status.html">mod_status</a></code> werden feststellen,
dass die Serverstatistiken <strong>nicht</strong> auf Null
zurückgesetzt werden, wenn ein <code>USR1</code> gesendet
wurde. Der Code wurde so geschrieben, dass sowohl die Zeit minimiert
wird, in der der Server nicht in der Lage ist, neue Anfragen zu
bedienen (diese werden vom Betriebssystem in eine Warteschlange
gestellt, so dass sie auf keinen Fall verloren gehen) als auch
Ihre Parameter zur Feinabstimmung berücksichtigt werden.
Um dies zu erreichen, muss die <em>Statustabelle</em> (Scoreboard),
die dazu verwendet wird, alle Kinder über mehrere Generationen
zu verfolgen, erhalten bleiben.</p>
<p>Das Statusmodul benutzt außerdem ein <code>G</code>, um
diejenigen Kinder zu kennzeichen, die noch immer Anfragen bedienen,
welche gestartet wurden, bevor ein unterbrechungsfreier Neustart
veranlaßt wurde.</p>
<p>Derzeit gibt es keine Möglichkeit für ein
Log-Rotationsskript, das <code>USR1</code> verwendet, sicher
festzustellen, dass alle Kinder, die in ein vor dem Neustart
geöffnetes Log schreiben, beendet sind. Wir schlagen vor, dass
Sie nach dem Senden des Signals <code>USR1</code> eine angemessene
Zeitspanne warten, bevor Sie das alte Log anfassen. Wenn beispielsweise
die meisten Ihrer Zugriffe bei Benutzern mit niedriger Bandbreite
weniger als 10 Minuten für eine vollständige Antwort
benötigen, dann könnten Sie 15 Minuten warten, bevor Sie auf
das alte Log zugreifen.</p>
<div class="note">Wenn Ihre Konfigurationsdatei Fehler enthält, während
Sie einen Neustart anweisen, dann wird Ihr Elternprozess nicht neu starten,
sondern sich mit einem Fehler beenden. Im Falle eines unterbrechungsfreien
Neustarts läßt er die Kinder weiterlaufen, wenn er sich beendet.
(Dies sind die Kinder, die sich "sanft beenden", indem sie ihre letzte
Anfrage erledigen.) Das verursacht Probleme, wenn Sie versuchen,
den Server neu zu starten -- er ist nicht in der Lage, sich an die Ports zu
binden, an denen er lauschen soll. Bevor Sie einen Neustart
durchführen, können Sie die Syntax der Konfigurationsdateien
mit dem Befehlszeilenargument <code>-t</code> überprüfen
(siehe auch <code class="program"><a href="./programs/httpd.html">httpd</a></code>). Das garantiert
allerdings nicht, dass der Server korrekt starten wird. Um sowohl die
Syntax als auch die Semantik der Konfigurationsdateien zu prüfen,
können Sie versuchen, <code class="program"><a href="./programs/httpd.html">httpd</a></code> als nicht-root-Benutzer
zu starten. Wenn dabei keine Fehler auftreten, wird er versuchen, seine
Sockets und Logdateien zu öffnen und fehlschlagen, da er nicht root
ist (oder weil sich der gegenwärtig laufende <code class="program"><a href="./programs/httpd.html">httpd</a></code>
bereits diese Ports gebunden hat). Wenn er aus einem anderen Grund
fehlschlägt, dann liegt wahrscheinlich ein Konfigurationsfehler vor.
Der Fehler sollte behoben werden, bevor der unterbrechungsfreie Neustart
angewiesen wird.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="hup" id="hup">Neustarten</a></h2>
<dl><dt>Signal: HUP</dt>
<dd><code>apachectl -k restart</code></dd>
</dl>
<p>Das Senden des Signals <code>HUP</code> oder <code>restart</code>
veranlaßt den Elternprozess, wie bei <code>TERM</code> alle seine
Kinder zu beenden. Der Elternprozess beendet sich jedoch nicht. Er liest
seine Konfigurationsdateien neu ein und öffnet alle Logdateien
erneut. Dann erzeugt er einen neuen Satz Kindprozesse und setzt die
Bedienung von Zugriffen fort.</p>
<p>Benutzer von <code class="module"><a href="./mod/mod_status.html">mod_status</a></code> werden feststellen, dass
die Serverstatistiken auf Null gesetzt werden, wenn ein <code>HUP</code>
gesendet wurde.</p>
<div class="note">Wenn Ihre Konfigurationsdatei einen Fehler enthält,
während Sie einen Neustart anweisen, dann wird Ihr Elternprozess
nicht neu starten, sondern sich mit einem Fehler beenden. Lesen Sie oben,
wie Sie das vermeiden können.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="race" id="race">Anhang: Signale und Wettkampfsituationen</a></h2>
<p>Vor der Version 1.2b9 des Apache existierten verschiedene
<em>Wettkampfsituationen</em> (race conditions), die den Neustart und
die Signale beeinflußt haben. (Einfach erklärt ist eine
Wettkampfsituation ein zeitabhängiges Problem - wenn
etwas zum falschen Zeitpunkt erfolgt oder Dinge in der falschen
Reihenfolge passieren, ist unerwartetes Verhalten die Folge. Wenn die
gleichen Dinge zur richtigen Zeit geschehen, funktioniert alles korrekt.)
Bei Architekturen mit dem "richtigen" Funktionsumfang
haben wir so viele eliminiert wie wir nur konnten. Dennoch
sollte beachtet werden, dass noch immer Wettkampfsituationen auf
bestimmten Architekturen existieren.</p>
<p>Bei Architekturen, die ein <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code> auf Platte verwenden,
besteht die Gefahr, dass die Statustabelle beschädigt wird.
Das kann zu "bind: Address already in use" ("bind: Adresse wird
bereits verwendet", nach einem <code>HUP</code>) oder "long lost
child came home!" ("Der verlorene Sohn ist heimgekehrt", nach einem
<code>USR1</code>) führen. Ersteres ist ein schwerer Fehler,
wärend letzteres lediglich bewirkt, dass der Server einen Eintrag
in der Statustabelle verliert. So kann es ratsam sein, unterbrechungsfreie
Neustarts zusammen mit einem gelegentlichen harten Neustart zu verwenden.
Diese Probleme lassen sich nur sehr schwer umgehen, aber
glücklicherweise benötigen die meisten Architekturen keine
Statustabelle in Form einer Datei. Bitte lesen Sie für Architekturen,
die sie benötigen, die Dokumentation zu <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code>.</p>
<p>Alle Architekturen haben in jedem Kindprozess eine kleine
Wettkampfsituation, welche die zweite und nachfolgende Anfragen
einer persistenten HTTP-Verbindung (KeepAlive) umfaßt. Der Prozess
kann nach dem Lesen der Anfragezeile aber vor dem Lesen der Anfrage-Header
enden. Es existiert eine Korrektur, die für 1.2 zu spät kam.
Theoretisch sollte das kein Problem darstellen, da
der KeepAlive-Client derartige Ereignisse aufgrund von
Netzwerk-Latenzzeiten und Auszeiten des Servers erwarten sollte.
In der Praxis scheint keiner von beiden beeinflußt zu werden
-- in einem Testfall wurde der Server zwanzig mal
pro Sekunde neu gestartet, während Clients das Angebot abgegrast
haben, ohne kaputte Bilder oder leere Dokumente zu erhalten.</p>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="./de/stopping.html" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Kommentare</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/stopping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_0.html.de 0000664 0001751 0001751 00000043255 14744525602 021455 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Übersicht der neuen Funktionen im Apache HTTP Server 2.0 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Übersicht der neuen Funktionen im Apache HTTP Server 2.0</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="./de/new_features_2_0.html" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Dieses Dokument beschreibt einige der wichtigsten Änderungen
des Apache HTTP Servers 2.0 gegenüber der Version 1.3.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Core-Erweiterungen</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Modul-Erweiterungen</a></li>
</ul><h3>Siehe auch</h3><ul class="seealso"><li><a href="upgrading.html">Upgrade von 1.3 auf 2.0</a></li><li><a href="#comments_section">Kommentare</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="core" id="core">Core-Erweiterungen</a></h2>
<dl>
<dt><strong>Unix-Threading</strong></dt>
<dd>Auf Unix-Systemen mit Unterstützung für
POSIX-Threads, kann der Apache httpd jetzt in einem Multi-Process,
Multi-Threaded Hybrid-Mode gestartet werden. Dies verbessert die
Skalierfähigkeit für viele, jedoch nicht unbedingt alle
Konfigurationen.</dd>
<dt><strong>Neues Build-System</strong></dt>
<dd>Das Build-System wurde komplett auf der Basis von
<code>autoconf</code> und <code>libtool</code> neu geschrieben.
Dadurch wird das Konfigurationssystem des Apache httpd dem vieler
anderer Packages ähnlicher.</dd>
<dt><strong>Multi-Protokoll-Unterstützung</strong></dt>
<dd>Der Apache HTTP Server stellt jetzt die notwendigen
Grundfunktionalitäten bereit, um mehrere Protokolle
unterstützen und verarbeiten zu können.
<code class="module"><a href="./mod/mod_echo.html">mod_echo</a></code> wurde hierfür als Beispiel
geschrieben.</dd>
<dt><strong>Bessere Unterstützung von
Nicht-Unix-Plattformen</strong></dt>
<dd>Der Apache HTTP Server 2.0 ist schneller und stabiler auf
Nicht-Unix-Plattformen wie BeOS, OS/2 und Windows. Mit der
Einführung von Plattform-spezifischen <a href="mpm.html">Multi-Processing Modulen</a> (MPMs) und der Apache
Portable Runtime (APR), sind diese Plattformen jetzt in ihrem
nativen API implementiert, wodurch die Verwendung der häufig
fehlerbehafteten und schlecht funktionierenden
POSIX-Emulation-Layer vermieden wird.</dd>
<dt><strong>Neues Apache-httpd API</strong></dt>
<dd>Das API für Module hat sich in 2.0 stark verändert.
Die meisten der Sortierungs-/Prioritätsprobleme von Modulen bei
1.3 sollten nun verschwunden sein. In 2.0 wird hiervon vieles
automatisch durchgeführt. Die Modulsortierung wird jetzt
über einen pre-hook vorgenommen, um mehr Flexibilität
zu bieten. Außerdem wurden neue API-Calls hinzugefügt,
die zusätzliche Modulfähigkeiten zur Verfügung stellen,
ohne den Kern des Apache HTTP Servers anpassen zu müssen.</dd>
<dt><strong>IPv6-Unterstützung</strong></dt>
<dd>Auf Systemen, bei denen die zugrundeliegende Apache Portable
Runtime-Bibliothek IPv6 unterstützt, bekommt der Apache httpd
standarmäßig IPv6 Listening Sockets. Zusätzlich
unterstützen die Konfigurationsanweisungen <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>, <code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code> und <code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> numerische IPv6-Adressangaben
(z.B., "<code>Listen [2001:db8::1]:8080</code>").</dd>
<dt><strong>Filterung</strong></dt>
<dd>Apache-httpd-Module können jetzt als Filter entwickelt
und zur Filterung des rein- und rausgehenden Datenstroms des
Servers eingesetzt werden. Hierdurch kann beispielsweise die
Ausgabe von CGI-Skripten durch den <code>INCLUDES</code>-Filter
von <code class="module"><a href="./mod/mod_include.html">mod_include</a></code> bearbeitet werden und so
Server-Side Include-Anweisungen ausgeführt werden. Das Modul
<code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> erlaubt externen Programmen als
Filter zu agieren, in der gleichen Weise wie CGI-Programme als
Eingabe dienen können.</dd>
<dt><strong>Mehrsprachige Fehlermeldungen</strong></dt>
<dd>Fehlermeldungen die an den Browser rausgehen, stehen jetzt als
SSI-Dokumente in verschiedenen Sprachen zur Verfügung. Sie
können bei Bedarf durch den Administrator angepasst werden,
um ein einheitliches Design zu erreichen.</dd>
<dt><strong>Vereinfachte Konfiguration</strong></dt>
<dd>Viele der verwirrenden Konfigurationsanweisungen wurden vereinfacht.
Die oft für Verwirrung sorgenden <code>Port</code>- und
<code>BindAddress</code>-Anweisungen wurden entfernt.
Ausschließlich die <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>-Anweisung wird nun zum
Setzen von IP-Addressen und Portnummern benutzt.
Der Servername und die Portnummer, die für Weiterleitungen und
zur Erkennung virtueller Server verwendet werden, werden über
die <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>-Anweisung
konfiguriert.</dd>
<dt><strong>Native Windows NT Unicode-Unterstützung</strong></dt>
<dd>Der Apache httpd 2.0 auf Windows NT benutzt jetzt utf-8
für alle Dateinamen-Kodierungen. Diese werden direkt auf das
zugrundeliegende Unicode-Dateisystem abgebildet, wodurch
Mehrsprach-Unterstützung für alle Windows NT-basierten
Installationen, inklusive Windows 2000 und Windows XP, zur
Verfügung gestellt wird. <em>Diese Unterstützung ist
nicht auf Windows 95, 98 oder ME verfügbar. Hier wird
weiterhin die jeweils lokale Codepage des Rechners für den
Zugriff auf das Dateisystem verwendet.</em></dd>
<dt>Bibliothek für reguläre Ausdrücke aktualisiert</dt>
<dd>Der Apache httpd 2.0 enthält die <a href="http://www.pcre.org/">"Perl Compatible
Regular Expression Library"</a> (PCRE).
Bei der Auswertung aller regulären Ausdrücke wird nun
die leistungsfähigere Syntax von Perl 5 verwendet.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Modul-Erweiterungen</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>Neues Modul in Apache httpd 2.0. Dieses Modul ist ein
Interface zu den von OpenSSL bereitgestellten SSL/TLS
Verschlüsselungs-Protokollen.</dd>
<dt><code class="module"><a href="./mod/mod_dav.html">mod_dav</a></code></dt>
<dd>Neues Modul in Apache httpd 2.0. Dieses Modul implementiert
die HTTP Distributed Authoring and Versioning (DAV) Spezifikation
zur Erzeugung und Pflege von Web-Inhalten.</dd>
<dt><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></dt>
<dd>Neues Modul in Apache httpd 2.0. Dieses Modul erlaubt es
Browsern, die dies unterstützen, eine Komprimierung des
Inhaltes vor der Auslieferung anzufordern, um so
Netzwerk-Bandbreite zu sparen.</dd>
<dt><code class="module">mod_auth_ldap</code></dt>
<dd>Neues Modul in Apache httpd 2.0.41. Diese Modul
ermöglicht die Verwendung einer LDAP-Datenbank zur
Speicherung von Berechtigungsdaten für die
HTTP-Basic-Authentication. Ein Begleitmodul,
<code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>, stellt einen Verbindungs-Pool und die
Pufferung von Abfrageergebnissen zur Verfügung.</dd>
<dt><code class="module"><a href="./mod/mod_auth_digest.html">mod_auth_digest</a></code></dt>
<dd>Zusätzliche Unterstützung für
prozessübergreifendes Session-Caching mittels Shared-Memory.
</dd>
<dt><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></dt>
<dd>Neues Modul in Apache httpd 2.0.
Dieses experimentelle Modul erlaubt Zeichensatz-Übersetzungen oder
-Umschlüsselung.</dd>
<dt><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></dt>
<dd>Neues Modul in Apache httpd 2.0. Dieses Modul beinhaltet die
Funktionalität von <code>mod_mmap_static</code> aus Version
1.3 des Apache HTTP Server zuzüglich einiger weiterer
Caching-Funktionen.</dd>
<dt><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></dt>
<dd>Dieses Modul ist in Apache httpd 2.0 deutlich flexibler
geworden. Es kann jetzt die von <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>
genutzten Request-Header manipulieren und es ist möglich
Response-Header auf Basis von definierten Bedingungen zu
verändern.</dd>
<dt><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dt>
<dd>Das Proxy Modul wurde komplett neu geschrieben um die
Möglichkeiten der neuen Filter-Funktionalität
auszuschöpfen und um einen zuverlässigen Proxy zu haben, der
den HTTP/1.1-Spezifikationen entspricht. Neue <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
-Konfigurationsabschnitte bieten eine besser lesbare (und intern
schnellere) Kontrolle der vermittelten Seiten.
Die überladenen <code><Directory
"proxy:..."></code>-Konfigurationen werden nicht
mehr unterstützt. Das Modul ist nun in mehrere Module
unterteilt, die jeweils ein bestimmtes Übertragungsprotokoll
unterstützen, wie <code>proxy_connect</code>,
<code>proxy_ftp</code> und <code>proxy_http</code>.</dd>
<dt><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></dt>
<dd>Die neue Konfigurationsanweisung <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code>
kann benutzt werden, um sicherzustellen, dass ein Client auf jeden
Fall ein einzelnes Dokument, anstatt einer NOT ACCEPTABLE- oder
MULTIPLE CHOICES-Antwort, bekommt. Zusätzlich wurden die
Negotiation- und Multiview-Algorithmen angepasst um einheitlichere
Ergebnisse zu liefern. Außerdem wird ein neues
Type-Map-Format bereitgestellt, das Dokumenteninhalte direkt
enthalten kann.</dd>
<dt><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code></dt>
<dd>Automatisch erzeugte Verzeichnisindizes können zur besseren
Übersichtlichkeit durch HTML-Tabellen dargestellt werden.
Genauere Sortierungen, wie Sortierung nach Versionsnummer und
Wildcard-Filterung des Verzeichnisindizes werden unterstützt.</dd>
<dt><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dt>
<dd>Neue Anweisungen erlauben es, die Standard Start- und Endtags von
SSI-Elementen zu ändern. Zudem können die Default-Formate
für Fehlermeldungen und Zeitangaben nun ebenfalls in der
Serverkonfiguration vorgenommen werden. Auf die Ergebnisse der
Auswertung und Gruppierung von regulären Ausdrücken (jetzt
auf Basis der Perl-Syntax für reguläre Ausdrücke) kann
über die <code class="module"><a href="./mod/mod_include.html">mod_include</a></code> Variablen <code>$0</code>
bis <code>$9</code> zugegriffen werden.</dd>
<dt><code class="module">mod_auth_dbm</code></dt>
<dd>DBM-ähnliche Datenbanken werden jetzt durch die
Konfigurationsaweisung <code>AuthDBMType</code>
unterstützt.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="./de/new_features_2_0.html" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Kommentare</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_0.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/ 0000775 0001751 0001751 00000000000 15032766627 016373 5 ustar covener covener httpd-2.4.64/docs/manual/vhosts/mass.html.en 0000664 0001751 0001751 00000044434 14737241666 020640 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Dynamically Configured Mass Virtual Hosting - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Virtual Hosts</a></div><div id="page-content"><div id="preamble"><h1>Dynamically Configured Mass Virtual Hosting</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/vhosts/mass.html" title="English"> en </a> |
<a href="../fr/vhosts/mass.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/mass.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/mass.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document describes how to efficiently serve an
arbitrary number of virtual hosts with the Apache HTTP Server. A
<a href="../rewrite/vhosts.html">separate document</a> discusses using
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> to create dynamic mass virtual hosts.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#motivation">Motivation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#overview">Overview</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#simple">Dynamic Virtual Hosts with
mod_vhost_alias</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#homepages">Simplified Dynamic Virtual Hosts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#combinations">Using Multiple Virtual
Hosting Systems on the Same Server</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ipbased">More Efficient IP-Based Virtual Hosting</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewrite">Mass virtual hosts with
mod_rewrite</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#macro">Mass virtual hosts with mod_macro</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="motivation" id="motivation">Motivation</a></h2>
<p>The techniques described here are of interest if your
<code>httpd.conf</code> contains many
<code><VirtualHost></code> sections that are
substantially the same, for example:</p>
<pre class="prettyprint lang-config"><VirtualHost 111.22.33.44>
ServerName customer-1.example.com
DocumentRoot "/www/hosts/customer-1.example.com/docs"
ScriptAlias "/cgi-bin/" "/www/hosts/customer-1.example.com/cgi-bin"
</VirtualHost>
<VirtualHost 111.22.33.44>
ServerName customer-2.example.com
DocumentRoot "/www/hosts/customer-2.example.com/docs"
ScriptAlias "/cgi-bin/" "/www/hosts/customer-2.example.com/cgi-bin"
</VirtualHost>
<VirtualHost 111.22.33.44>
ServerName customer-N.example.com
DocumentRoot "/www/hosts/customer-N.example.com/docs"
ScriptAlias "/cgi-bin/" "/www/hosts/customer-N.example.com/cgi-bin"
</VirtualHost></pre>
<p>We wish to replace these multiple
<code><VirtualHost></code> blocks with a mechanism
that works them out dynamically. This has a number of
advantages:</p>
<ol>
<li>Your configuration file is smaller, so Apache starts
more quickly and uses less memory. Perhaps more importantly, the
smaller configuration is easier to maintain, and leaves less room
for errors.</li>
<li>Adding virtual hosts is simply a matter of creating the
appropriate directories in the filesystem and entries in the
DNS - you don't need to reconfigure or restart Apache.</li>
</ol>
<p>The main disadvantage is that you cannot have a different log file for
each virtual host; however, if you have many virtual hosts, doing
this can be a bad idea anyway, because of the <a href="fd-limits.html">number of file descriptors needed</a>.
It is better to <a href="../logs.html#piped">log to a pipe or a fifo</a>,
and arrange for the process at the other end to split up the log
files into one per virtual host. One example of such a process can
be found in the <a href="../programs/split-logfile.html">split-logfile</a>
utility.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="overview" id="overview">Overview</a></h2>
<p>A virtual host is defined by two pieces of information: its
IP address, and the contents of the <code>Host:</code> header
in the HTTP request. The dynamic mass virtual hosting technique
used here is based on automatically inserting this information into the
pathname of the file that is used to satisfy the request. This
can be most easily done by using <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>
with Apache httpd. Alternatively,
<a href="../rewrite/vhosts.html">mod_rewrite can
be used</a>.</p>
<p>Both of these modules are disabled by default; you must enable
one of them when configuring and building Apache httpd if you want to
use this technique.</p>
<p>A couple of things need to be determined from the request in
order to make the dynamic
virtual host look like a normal one. The most important is the
server name, which is used by the server to generate
self-referential URLs etc. It is configured with the
<code>ServerName</code> directive, and it is available to CGIs
via the <code>SERVER_NAME</code> environment variable. The
actual value used at run time is controlled by the <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code>
setting. With <code>UseCanonicalName Off</code>, the server name
is taken from the contents of the <code>Host:</code> header in the
request. With <code>UseCanonicalName DNS</code>, it is taken from a
reverse DNS lookup of the virtual host's IP address. The former
setting is used for name-based dynamic virtual hosting, and the
latter is used for IP-based hosting. If httpd cannot work out
the server name because there is no <code>Host:</code> header,
or the DNS lookup fails, then the value configured with
<code>ServerName</code> is used instead.</p>
<p>The other thing to determine is the document root (configured
with <code>DocumentRoot</code> and available to CGI scripts via the
<code>DOCUMENT_ROOT</code> environment variable). In a normal
configuration, this is used by the core module when
mapping URIs to filenames, but when the server is configured to
do dynamic virtual hosting, that job must be taken over by another
module (either <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> or
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>), which has a different way of doing
the mapping. Neither of these modules is responsible for
setting the <code>DOCUMENT_ROOT</code> environment variable so
if any CGIs or SSI documents make use of it, they will get a
misleading value.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="simple" id="simple">Dynamic Virtual Hosts with
mod_vhost_alias</a></h2>
<p>This extract from <code>httpd.conf</code> implements the
virtual host arrangement outlined in the <a href="#motivation">Motivation</a> section above
using <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>.</p>
<pre class="prettyprint lang-config"># get the server name from the Host: header
UseCanonicalName Off
# this log format can be split per-virtual-host based on the first field
# using the split-logfile utility.
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
# include the server name in the filenames used to satisfy requests
VirtualDocumentRoot "/www/hosts/%0/docs"
VirtualScriptAlias "/www/hosts/%0/cgi-bin"</pre>
<p>This configuration can be changed into an IP-based virtual
hosting solution by just turning <code>UseCanonicalName
Off</code> into <code>UseCanonicalName DNS</code>. The server
name that is inserted into the filename is then derived from
the IP address of the virtual host. The variable <code>%0</code>
references the requested servername, as indicated in the
<code>Host:</code> header.</p>
<p>See the <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> documentation for more usage
examples.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="homepages" id="homepages">Simplified Dynamic Virtual Hosts</a></h2>
<p>This is an adjustment of the above system, tailored for an
ISP's web hosting server. Using <code>%2</code>,
we can select substrings of the server name to
use in the filename so that, for example, the documents for
<code>www.user.example.com</code> are found in
<code>/home/user/www</code>. It uses a single <code>cgi-bin</code>
directory instead of one per virtual host.</p>
<pre class="prettyprint lang-config">UseCanonicalName Off
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
# include part of the server name in the filenames
VirtualDocumentRoot "/home/%2/www"
# single cgi-bin directory
ScriptAlias "/cgi-bin/" "/www/std-cgi/"</pre>
<p>There are examples of more complicated
<code>VirtualDocumentRoot</code> settings in the
<code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> documentation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="combinations" id="combinations">Using Multiple Virtual
Hosting Systems on the Same Server</a></h2>
<p>With more complicated setups, you can use httpd's normal
<code><VirtualHost></code> directives to control the
scope of the various virtual hosting configurations. For
example, you could have one IP address for general customers' homepages,
and another for commercial customers, with the following setup.
This can be combined with conventional
<code><VirtualHost></code> configuration sections, as shown
below.</p>
<pre class="prettyprint lang-config">UseCanonicalName Off
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
<Directory "/www/commercial">
Options FollowSymLinks
AllowOverride All
</Directory>
<Directory "/www/homepages">
Options FollowSymLinks
AllowOverride None
</Directory>
<VirtualHost 111.22.33.44>
ServerName www.commercial.example.com
CustomLog "logs/access_log.commercial" vcommon
VirtualDocumentRoot "/www/commercial/%0/docs"
VirtualScriptAlias "/www/commercial/%0/cgi-bin"
</VirtualHost>
<VirtualHost 111.22.33.45>
ServerName www.homepages.example.com
CustomLog "logs/access_log.homepages" vcommon
VirtualDocumentRoot "/www/homepages/%0/docs"
ScriptAlias "/cgi-bin/" "/www/std-cgi/"
</VirtualHost></pre>
<div class="note">
<h3>Note</h3>
<p>If the first VirtualHost block does <em>not</em> include a
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> directive, the reverse
DNS of the relevant IP will be used instead.
If this is not the server name you
wish to use, a bogus entry (eg. <code>ServerName
none.example.com</code>) can be added to get around this
behaviour.</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="ipbased" id="ipbased">More Efficient IP-Based Virtual Hosting</a></h2>
<p>The configuration changes suggested to turn <a href="#simple">the first
example</a> into an IP-based virtual hosting setup result in
a rather inefficient setup. A new DNS lookup is required for every
request. To avoid this overhead, the filesystem can be arranged to
correspond to the IP addresses, instead of to the host names, thereby
negating the need for a DNS lookup. Logging will also have to be adjusted
to fit this system.</p>
<pre class="prettyprint lang-config"># get the server name from the reverse DNS of the IP address
UseCanonicalName DNS
# include the IP address in the logs so they may be split
LogFormat "%A %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
# include the IP address in the filenames
VirtualDocumentRootIP "/www/hosts/%0/docs"
VirtualScriptAliasIP "/www/hosts/%0/cgi-bin"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">Mass virtual hosts with
mod_rewrite</a></h2>
<p>
Mass virtual hosting may also be accomplished using
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, either using simple <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directives, or using more
complicated techniques such as storing the vhost definitions externally
and accessing them via <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>. These techniques are
discussed in the <a href="../rewrite/vhosts.html">rewrite
documentation</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="macro" id="macro">Mass virtual hosts with mod_macro</a></h2>
<p>Another option for dynamically generated virtual hosts is
<code class="module"><a href="../mod/mod_macro.html">mod_macro</a></code>, with which you can create a virtualhost
template, and invoke it for multiple hostnames. An example of this is
provided in the <strong>Usage</strong> section of the module
documentation.
</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/vhosts/mass.html" title="English"> en </a> |
<a href="../fr/vhosts/mass.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/mass.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/mass.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/mass.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/details.html.en 0000664 0001751 0001751 00000044625 14737241666 021324 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>An In-Depth Discussion of Virtual Host Matching - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Virtual Hosts</a></div><div id="page-content"><div id="preamble"><h1>An In-Depth Discussion of Virtual Host Matching</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/vhosts/details.html" title="English"> en </a> |
<a href="../fr/vhosts/details.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/details.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/details.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document attempts to explain
exactly what Apache HTTP Server does when deciding what virtual host to
serve a request from.</p>
<p>Most users should read about <a href="name-based.html#namevip">
Name-based vs. IP-based Virtual Hosts</a> to decide which type they
want to use, then read more about <a href="name-based.html">name-based</a>
or <a href="ip-based.html">IP-based</a> virtualhosts, and then see
<a href="examples.html">some examples</a>.</p>
<p>If you want to understand all the details, then you can
come back to this page.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#configparsing">Configuration File</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#hostmatching">Virtual Host Matching</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#tips">Tips</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="ip-based.html">IP-based Virtual Host Support</a></li><li><a href="name-based.html">Name-based Virtual Hosts Support</a></li><li><a href="examples.html">Virtual Host examples for common setups</a></li><li><a href="mass.html">Dynamically configured mass virtual hosting</a></li><li><a href="#comments_section">Comments</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="configparsing" id="configparsing">Configuration File</a></h2>
<p>There is a <em>main server</em> which consists of all the
definitions appearing outside of
<code><VirtualHost></code> sections.</p>
<p>There are virtual
servers, called <em>vhosts</em>, which are defined by
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
sections.</p>
<p>Each <code>VirtualHost</code> directive includes one
or more addresses and optional ports.</p>
<p>Hostnames can be used in place of IP addresses in a virtual
host definition, but they are resolved at startup and if any name
resolutions fail, those virtual host definitions are ignored.
This is, therefore, not recommended.</p>
<p>The address can be specified as
<code>*</code>, which will match a request if no
other vhost has the explicit address on which the request was
received. </p>
<p>The address appearing in the <code>VirtualHost</code>
directive can have an optional port. If the port is unspecified,
it is treated as a wildcard port, which can also be indicated
explicitly using <code>*</code>.
The wildcard port matches any port.</p>
<p>(Port numbers specified in the <code>VirtualHost</code> directive do
not influence what port numbers Apache will listen on, they only control
which <code>VirtualHost</code> will be selected to handle a request.
Use the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directive to
control the addresses and ports on which the server listens.)
</p>
<p>Collectively the
entire set of addresses (including multiple
results from DNS lookups) are called the vhost's
<em>address set</em>.</p>
<p>Apache automatically discriminates on the
basis of the HTTP <code>Host</code> header supplied by the client
whenever the most specific match for an IP address and port combination
is listed in multiple virtual hosts.</p>
<p>The
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> directive
may appear anywhere within the definition of a server. However,
each appearance overrides the previous appearance (within that
server). If no <code>ServerName</code> is specified, the server
attempts to deduce it from the server's IP address.</p>
<p>The first name-based vhost in the configuration file for a
given IP:port pair is significant because it is used for all
requests received on that address and port for which no other
vhost for that IP:port pair has a matching ServerName or
ServerAlias. It is also used for all SSL connections if the
server does not support <a class="glossarylink" href="../glossary.html#servernameindication" title="see glossary">Server Name Indication</a>.</p>
<p>The complete list of names in the <code>VirtualHost</code>
directive are treated just like a (non wildcard) <code>ServerAlias</code>
(but are not overridden by any <code>ServerAlias</code> statement).</p>
<p>For every vhost various default values are set. In
particular:</p>
<ol>
<li>If a vhost has no <code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>,
<code class="directive"><a href="../mod/core.html#timeout">Timeout</a></code>,
<code class="directive"><a href="../mod/core.html#keepalivetimeout">KeepAliveTimeout</a></code>,
<code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code>,
<code class="directive"><a href="../mod/core.html#maxkeepaliverequests">MaxKeepAliveRequests</a></code>,
<code class="directive"><a href="../mod/mpm_common.html#receivebuffersize">ReceiveBufferSize</a></code>,
or <code class="directive"><a href="../mod/mpm_common.html#sendbuffersize">SendBufferSize</a></code>
directive then the respective value is inherited from the
main server. (That is, inherited from whatever the final
setting of that value is in the main server.)</li>
<li>The "lookup defaults" that define the default directory
permissions for a vhost are merged with those of the
main server. This includes any per-directory configuration
information for any module.</li>
<li>The per-server configs for each module from the
main server are merged into the vhost server.</li>
</ol>
<p>Essentially, the main server is treated as "defaults" or a
"base" on which to build each vhost. But the positioning of
these main server definitions in the config file is largely
irrelevant -- the entire config of the main server has been
parsed when this final merging occurs. So even if a main server
definition appears after a vhost definition it might affect the
vhost definition.</p>
<p>If the main server has no <code>ServerName</code> at this
point, then the hostname of the machine that <code class="program"><a href="../programs/httpd.html">httpd</a></code>
is running on is used instead. We will call the <em>main server address
set</em> those IP addresses returned by a DNS lookup on the
<code>ServerName</code> of the main server.</p>
<p>For any undefined <code>ServerName</code> fields, a
name-based vhost defaults to the address given first in the
<code>VirtualHost</code> statement defining the vhost.</p>
<p>Any vhost that includes the magic <code>_default_</code>
wildcard is given the same <code>ServerName</code> as the
main server.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="hostmatching" id="hostmatching">Virtual Host Matching</a></h2>
<p>The server determines which vhost to use for a request as
follows:</p>
<h3><a name="hashtable" id="hashtable">IP address lookup</a></h3>
<p>When the connection is first received on some address and port,
the server looks for all the <code>VirtualHost</code> definitions
that have the same IP address and port.</p>
<p>If there are no exact matches for the address and port, then
wildcard (<code>*</code>) matches are considered.</p>
<p>If no matches are found, the request is served by the
main server.</p>
<p>If there are <code>VirtualHost</code> definitions for
the IP address, the next step is to decide if we have to
deal with an IP-based or a name-based vhost.</p>
<h3><a name="ipbased" id="ipbased">IP-based vhost</a></h3>
<p>If there is exactly one <code>VirtualHost</code> directive
listing the IP address and port combination that was determined
to be the best match, no further actions are performed and
the request is served from the matching vhost.</p>
<h3><a name="namebased" id="namebased">Name-based vhost</a></h3>
<p>If there are multiple <code>VirtualHost</code> directives listing
the IP address and port combination that was determined to be the
best match, the "list" in the remaining steps refers to the list of vhosts
that matched, in the order they were in the configuration file.</p>
<p>If the connection is using SSL, the server supports <a class="glossarylink" href="../glossary.html#servernameindication" title="see glossary">Server Name Indication</a>, and
the SSL client handshake includes the TLS extension with the
requested hostname, then that hostname is used below just like the
<code>Host:</code> header would be used on a non-SSL connection.
Otherwise, the first name-based vhost whose address matched is
used for SSL connections. This is significant because the
vhost determines which certificate the server will use for the
connection.</p>
<p>If the request contains a <code>Host:</code> header field, the
list is searched for the first vhost with a matching
<code>ServerName</code> or <code>ServerAlias</code>, and the
request is served from that vhost. A <code>Host:</code> header
field can contain a port number, but Apache always ignores it and
matches against the real port to which the client sent the
request.</p>
<p>The first vhost in the config
file with the specified IP address has the highest priority
and catches any request to an unknown server name, or a request
without a <code>Host:</code> header field (such as a HTTP/1.0
request).</p>
<h3><a name="persistent" id="persistent">Persistent connections</a></h3>
<p>The <em>IP lookup</em> described above is only done <em>once</em> for a
particular TCP/IP session while the <em>name lookup</em> is done on
<em>every</em> request during a KeepAlive/persistent
connection. In other words, a client may request pages from
different name-based vhosts during a single persistent
connection.</p>
<h3><a name="absoluteURI" id="absoluteURI">Absolute URI</a></h3>
<p>If the URI from the request is an absolute URI, and its
hostname and port match the main server or one of the
configured virtual hosts <em>and</em> match the address and
port to which the client sent the request, then the
scheme/hostname/port prefix is stripped off and the remaining
relative URI is served by the corresponding main server or
virtual host. If it does not match, then the URI remains
untouched and the request is taken to be a proxy request.</p>
<h3><a name="observations" id="observations">Observations</a></h3>
<ul>
<li>Name-based virtual hosting is a process applied after
the server has selected the best matching IP-based virtual
host.</li>
<li>If you don't care what IP address the client has connected to, use a
"*" as the address of every virtual host, and name-based virtual hosting
is applied across all configured virtual hosts.</li>
<li><code>ServerName</code> and <code>ServerAlias</code>
checks are never performed for an IP-based vhost.</li>
<li>Only the ordering of
name-based vhosts for a specific address set is significant.
The one name-based vhosts that comes first in the
configuration file has the highest priority for its
corresponding address set.</li>
<li>Any port in the <code>Host:</code> header field is never used during the
matching process. Apache always uses the real port to which
the client sent the request.</li>
<li>If two vhosts have an address in common, those common addresses
act as name-based virtual hosts implicitly. This is new behavior as of
2.3.11.</li>
<li>The main server is only used to serve a request if the IP
address and port number to which the client connected
does not match any vhost (including a
<code>*</code> vhost). In other words, the main server
only catches a request for an unspecified address/port
combination (unless there is a <code>_default_</code> vhost
which matches that port).</li>
<li>You should never specify DNS names in
<code>VirtualHost</code> directives because it will force
your server to rely on DNS to boot. Furthermore it poses a
security threat if you do not control the DNS for all the
domains listed. There's <a href="../dns-caveats.html">more
information</a> available on this and the next two
topics.</li>
<li><code>ServerName</code> should always be set for each
vhost. Otherwise a DNS lookup is required for each
vhost.</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="tips" id="tips">Tips</a></h2>
<p>In addition to the tips on the <a href="../dns-caveats.html#tips">DNS Issues</a> page, here are
some further tips:</p>
<ul>
<li>Place all main server definitions before any
<code>VirtualHost</code> definitions. (This is to aid the
readability of the configuration -- the post-config merging
process makes it non-obvious that definitions mixed in around
virtual hosts might affect all virtual hosts.)</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/vhosts/details.html" title="English"> en </a> |
<a href="../fr/vhosts/details.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/details.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/details.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/details.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/index.html.de 0000664 0001751 0001751 00000021044 14744525602 020753 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache-Dokumentation zu virtuellen Hosts - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Module</a> | <a href="../mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossar</a> | <a href="../sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache-Dokumentation zu virtuellen Hosts</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="../de/vhosts/" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<p>Der Begriff <cite>virtueller Host</cite> <span class="transnote">(<em>Anm.d.Ü.:</em> engl. 'virtual
host')</span> bezieht sich auf die Praxis, mehr als ein Webangebot
(z.B. <code>www.company1.com</code> und <code>www.company2.com</code>)
auf einer einzigen Maschine zu betreiben. Virtuelle Hosts können
"<a href="ip-based.html">IP-basiert</a>" sein, was bedeutet, dass jedes
Webangebot eine andere IP besitzt, oder "<a href="name-based.html">Namens-basiert</a>", was bedeutet, dass
unter jeder IP-Adresse mehrere Namen laufen. Die Tatsache, dass sie
auf dem gleichen physischen Server laufen, ist für den Endbenutzer
nicht offensichtlich.</p>
<p>Der Apache war einer der ersten Server, der IP-basierte
virtuelle Hosts von Haus aus direkt unterstützt hat. Seit Version 1.1
unterstützt der Apache sowohl IP-basierte als auch namensbasierte
virtuelle Hosts (vhosts). Letzteres wird zuweilen auch
<em>Host-basiert</em> oder <em>non-IP-Virtual-Host</em> genannt.</p>
<p>Nachfolgend finden Sie eine Liste von Dokumenten, die alle Details
der Unterstützung von virtuellen Hosts ab Apache Version 1.3
beschreiben.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#support">Unterstützung virtueller Hosts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#directives">Konfigurationsdirektiven</a></li>
</ul><h3>Siehe auch</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li><li><a href="name-based.html">Namensbasierte virtuelle Hosts</a></li><li><a href="ip-based.html">IP-basierte virtuelle Hosts</a></li><li><a href="examples.html">Beispiele für virtuelle
Hosts</a></li><li><a href="fd-limits.html">Datei-Deskriptor-Begrenzungen</a></li><li><a href="mass.html">Massen-Virtual-Hosting</a></li><li><a href="details.html">Zuweisung virtueller Hosts</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="support" id="support">Unterstützung virtueller Hosts</a></h2>
<ul>
<li><a href="name-based.html">Namensbasierte virtuelle Hosts</a> (Mehr
als ein Webangebot pro IP-Adresse)</li>
<li><a href="ip-based.html">IP-basierte virtuelle Hosts</a> (Eine
IP-Adresse für jedes Webangebot)</li>
<li><a href="examples.html">Beispiele für virtuelles Hosts in
typischen Installationen</a></li>
<li><a href="fd-limits.html">Datei-Deskriptor-Begrenzungen</a> (oder
<em>Zu viele Protokolldateien</em>)</li>
<li><a href="mass.html">Dynamisch konfiguriertes
Massen-Virtual-Hosting</a></li>
<li><a href="details.html">Tiefergehende Erörterung der Zuweisung
virtueller Hosts</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="directives" id="directives">Konfigurationsdirektiven</a></h2>
<ul>
<li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li>
<li><code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code></li>
<li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li>
</ul>
<p>Bei der Suche von Fehlern in Ihrer Virtual-Host-Konfiguration ist
die Apache-Befehlszeilenoption <code>-S</code> möglicherweise
hilfreich. Geben Sie dazu den folgenden Befehl ein:</p>
<div class="example"><p><code>
/usr/local/apache2/bin/httpd -S
</code></p></div>
<p>Diese Anweisung gibt eine Beschreibung aus, wie der Apache die
Konfigurationsdatei analysiert hat. Eine sorgfältige
Überprüfung der IP-Adressen und Servernamen kann helfen,
Konfigurationsfehler aufzudecken. (Lesen Sie die Dokumentation zum
<code class="program"><a href="../programs/httpd.html">httpd</a></code>-Programm für weitere
Befehlszeilenoptionen.)</p>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="../de/vhosts/" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Module</a> | <a href="../mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossar</a> | <a href="../sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/ip-based.html.en 0000664 0001751 0001751 00000032422 14737241666 021353 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache IP-based Virtual Host Support - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Virtual Hosts</a></div><div id="page-content"><div id="preamble"><h1>Apache IP-based Virtual Host Support</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/vhosts/ip-based.html" title="English"> en </a> |
<a href="../fr/vhosts/ip-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/ip-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/ip-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/ip-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#explanation">What is IP-based virtual hosting</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#requirements">System requirements</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#howto">How to set up Apache</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multiple">Setting up multiple daemons</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#single">Setting up a single daemon
with virtual hosts</a></li>
</ul><h3>See also</h3><ul class="seealso"><li>
<a href="name-based.html">Name-based Virtual Hosts Support</a>
</li><li><a href="#comments_section">Comments</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="explanation" id="explanation">What is IP-based virtual hosting</a></h2>
<p>IP-based virtual hosting is a method to apply different directives
based on the IP address and port a request is received on. Most commonly,
this is used to serve different websites on different ports or interfaces.</p>
<p>In many cases, <a href="name-based.html">name-based
virtual hosts</a> are more convenient, because they allow
many virtual hosts to share a single address/port.
See <a href="name-based.html#namevip">Name-based vs. IP-based
Virtual Hosts</a> to help you decide. </p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="requirements" id="requirements">System requirements</a></h2>
<p>As the term <cite>IP-based</cite> indicates, the server
<strong>must have a different IP address/port combination for each IP-based
virtual host</strong>. This can be achieved by the machine
having several physical network connections, or by use of
virtual interfaces which are supported by most modern operating
systems (see system documentation for details, these are
frequently called "ip aliases", and the "ifconfig" command is
most commonly used to set them up), and/or using multiple
port numbers.</p>
<p> In the terminology of Apache HTTP Server, using a single IP address
but multiple TCP ports, is also IP-based virtual hosting.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="howto" id="howto">How to set up Apache</a></h2>
<p>There are two ways of configuring apache to support multiple
hosts. Either by running a separate <code class="program"><a href="../programs/httpd.html">httpd</a></code> daemon for
each hostname, or by running a single daemon which supports all the
virtual hosts.</p>
<p>Use multiple daemons when:</p>
<ul>
<li>There are security partitioning issues, such as company1
does not want anyone at company2 to be able to read their
data except via the web. In this case you would need two
daemons, each running with different <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code>, <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code>, <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>, and <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> settings.</li>
<li>You can afford the memory and file descriptor
requirements of listening to every IP alias on the
machine. It's only possible to <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> to the "wildcard"
address, or to specific addresses. So if you have a need to
listen to a specific address for whatever reason, then you
will need to listen to all specific addresses. (Although one
<code class="program"><a href="../programs/httpd.html">httpd</a></code> could listen to N-1 of the addresses, and another could
listen to the remaining address.)</li>
</ul>
<p>Use a single daemon when:</p>
<ul>
<li>Sharing of the httpd configuration between virtual hosts
is acceptable.</li>
<li>The machine services a large number of requests, and so
the performance loss in running separate daemons may be
significant.</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="multiple" id="multiple">Setting up multiple daemons</a></h2>
<p>Create a separate <code class="program"><a href="../programs/httpd.html">httpd</a></code> installation for each
virtual host. For each installation, use the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directive in the
configuration file to select which IP address (or virtual host)
that daemon services. e.g.</p>
<pre class="prettyprint lang-config">Listen 192.0.2.100:80</pre>
<p>It is recommended that you use an IP address instead of a
hostname (see <a href="../dns-caveats.html">DNS caveats</a>).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="single" id="single">Setting up a single daemon
with virtual hosts</a></h2>
<p>For this case, a single <code class="program"><a href="../programs/httpd.html">httpd</a></code> will service
requests for the main server and all the virtual hosts. The <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> directive
in the configuration file is used to set the values of <code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>, <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>, <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, <code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code> and <code class="directive"><a href="../mod/mod_log_config.html#transferlog">TransferLog</a></code>
or <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code>
configuration directives to different values for each virtual
host. e.g.</p>
<pre class="prettyprint lang-config"><VirtualHost 172.20.30.40:80>
ServerAdmin webmaster@www1.example.com
DocumentRoot "/www/vhosts/www1"
ServerName www1.example.com
ErrorLog "/www/logs/www1/error_log"
CustomLog "/www/logs/www1/access_log" combined
</VirtualHost>
<VirtualHost 172.20.30.50:80>
ServerAdmin webmaster@www2.example.org
DocumentRoot "/www/vhosts/www2"
ServerName www2.example.org
ErrorLog "/www/logs/www2/error_log"
CustomLog "/www/logs/www2/access_log" combined
</VirtualHost></pre>
<p>It is recommended that you use an IP address instead of a
hostname in the <VirtualHost> directive
(see <a href="../dns-caveats.html">DNS caveats</a>).</p>
<p> Specific IP addresses or ports have precedence over their wildcard
equivalents, and any virtual host that matches has precedence over
the servers base configuration.</p>
<p>Almost <strong>any</strong> configuration directive can be
put in the VirtualHost directive, with the exception of
directives that control process creation and a few other
directives. To find out if a directive can be used in the
VirtualHost directive, check the <a href="../mod/directive-dict.html#Context">Context</a> using the
<a href="../mod/quickreference.html">directive index</a>.</p>
<p><code class="directive"><a href="../mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code>
may be used inside a
VirtualHost directive if the <a href="../suexec.html">suEXEC
wrapper</a> is used.</p>
<p><em>SECURITY:</em> When specifying where to write log files,
be aware of some security risks which are present if anyone
other than the user that starts Apache has write access to the
directory where they are written. See the <a href="../misc/security_tips.html">security tips</a> document
for details.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/vhosts/ip-based.html" title="English"> en </a> |
<a href="../fr/vhosts/ip-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/ip-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/ip-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/ip-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/ip-based.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/details.html 0000664 0001751 0001751 00000000576 13710016232 020673 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: details.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: details.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: details.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: details.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/vhosts/examples.html 0000664 0001751 0001751 00000000732 13710016232 021056 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: examples.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: examples.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: examples.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: examples.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: examples.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/vhosts/mass.html 0000664 0001751 0001751 00000000562 13710016232 020204 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: mass.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: mass.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: mass.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: mass.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/vhosts/details.html.ko.euc-kr 0000664 0001751 0001751 00000047573 14743132254 022512 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ȣƮ ã ڼ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">ȣƮ</a></div><div id="page-content"><div id="preamble"><h1>ȣƮ ã ڼ </h1>
<div class="toplang">
<p><span> : </span><a href="../en/vhosts/details.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/details.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/details.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/details.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>ȣƮ ڵ <strong>ġ 1.3</strong> ٽ
ۼǾ. ġ û ȣƮ
ϴ Ѵ. ο <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> þ Ͽ
ȣƮ 1.3 .</p>
<p> ϴ ʰ <cite>ϰԸ</cite>
ϰ ʹٸ, <a href="examples.html"></a> ϶.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#configparsing"> б</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#hostmatching">ȣƮ ã</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#tips"></a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="configparsing" id="configparsing"> б</a></h2>
<p><code><VirtualHost></code>
<em>ּ</em> . <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
κ ȣƮ θ.</p>
<p><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>,
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>,
<code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code>,
<code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> þ
ִ. þ
( ) þ ȿϴ.</p>
<p>ּ <code>Listen</code> ⺻ 80̴. ּ
<code>ServerPath</code> <code>ServerAlias</code>
⺻ . <code>ServerName</code> ⺻
IP ̴ּ.</p>
<p>ּ Listen þ ΰ Ѵ. ù°
ġ ⺻ Ʈ Ʈ ϴ ̴. °
̷ URI Ʈ ȣ ϴ ̴.</p>
<p>ּ ȣƮ Ʈ ġ ٸ
Ʈ <em>ʴ´</em>.</p>
<p><code>VirtualHost</code> þ Ʈ ִ.
Ʈ ּ ֱ <code>Listen</code>
Ѵ. Ư Ʈ <code>*</code> Ʈ
Īϴ ϵī̴. (DNS ˻ <code>A</code>
ڵ带 Ͽ) ȣƮ ּҸ ĪϿ ȣƮ
<em>ּ(address set)</em>̶ θ.</p>
<p>Ư IP ּҿ <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> þ ٸ
ּҸ ϴ ù° ȣƮ IP ȣƮ Ѵ.
IP ּҿ ϵī <code>*</code> ִ.</p>
<p≯ ȣƮ Ѵٸ ̸ ȣƮ
IP ּҸ <code>NameVirtualHost</code> þ
ؾ <em>Ѵ</em>. , <code>NameVirtualHost</code>
þ ̸ ȣƮ ȣƮ(CNAME) شϴ
IP ּҸ ؾ Ѵ.</p>
<p>Ư IP:Ʈ ֿ <code>NameVirtualHost</code>
þ Ѵٸ, <code>NameVirtualHost</code> þ
<code>VirtualHost</code> þ ִ.</p>
<p><code>NameVirtualHost</code> <code>VirtualHost</code>
þ ߿ ʱ (
<em></em> ּտ <code>VirtualHost</code>
߿ϴ. Ʒ ):</p>
<table><tr>
<td><div class="example"><p><code>
NameVirtualHost 111.22.33.44<br />
<VirtualHost 111.22.33.44><br />
# A<br />
...<br />
</VirtualHost><br />
<VirtualHost 111.22.33.44><br />
# B<br />
...<br />
</VirtualHost><br />
<br />
NameVirtualHost 111.22.33.55<br />
<VirtualHost 111.22.33.55><br />
# C<br />
...<br />
</VirtualHost><br />
<VirtualHost 111.22.33.55><br />
# D<br />
...<br />
</VirtualHost>
</code></p></div></td>
<td><div class="example"><p><code>
<VirtualHost 111.22.33.44><br />
# A<br />
</VirtualHost><br />
<VirtualHost 111.22.33.55><br />
# C<br />
...<br />
</VirtualHost><br />
<VirtualHost 111.22.33.44><br />
# B<br />
...<br />
</VirtualHost><br />
<VirtualHost 111.22.33.55><br />
# D<br />
...<br />
</VirtualHost><br />
<br />
NameVirtualHost 111.22.33.44<br />
NameVirtualHost 111.22.33.55<br />
<br />
</code></p></div></td>
</tr></table>
<p>( б ϴ.)</p>
<p><code>VirtualHost</code> þ , ȣƮ
<code>VirtualHost</code> þ Ʈ ⺻
<code>Listen</code> Ѵ.</p>
<p><code>VirtualHost</code> þ ̸
ּտ Ѵٸ <code>ServerAlias</code> Ѵ
( ٸ <code>ServerAlias</code> ʴ´).
ȣƮ ߰ <code>Listen</code> ּ
Ʈ ϶.</p>
<p>Ҷ IP ּ ؽ̺ ߰Ѵ.
<code>NameVirtualHost</code> þ IP ּҸ ϸ
IP ּҿ ̸ ȣƮ Ѵ.
ּҿ ȣƮ ٸ <code>NameVirtualHost</code>
þ ϰ α Ѵ. IP ȣƮ
ؽ̺ ߰ ʴ´.</p>
<p> ؽԼ ϱ û IP ּҸ ؽϴ
δ . ؽ̺ IP ּ κ
̿ ȭִ.</p>
<p>ȣƮ ⺻ ȴ. Ư:</p>
<ol>
<li>ȣƮ <code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>,
<code class="directive"><a href="../mod/core.html#resourceconfig">ResourceConfig</a></code>,
<code class="directive"><a href="../mod/core.html#accessconfig">AccessConfig</a></code>,
<code class="directive"><a href="../mod/core.html#timeout">Timeout</a></code>,
<code class="directive"><a href="../mod/core.html#keepalivetimeout">KeepAliveTimeout</a></code>,
<code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code>,
<code class="directive"><a href="../mod/core.html#maxkeepaliverequests">MaxKeepAliveRequests</a></code>,
<code class="directive"><a href="../mod/core.html#sendbuffersize">SendBufferSize</a></code>
þ ٸ ּ ش ´. (,
ּ Ѵ.)</li>
<li>ȣƮ 丮 ⺻ ϴ "
⺻(lookup defaults)" ּ .
丮 (per-directory configuration)
شȴ.</li>
<li> (per-server config) ּ
ȣƮ ģ.</li>
</ol>
<p>⺻ ּ ȣƮ "⺻" Ȥ ""
ȴ. Ͽ ּ ϴ ġ .
ġ ּ оδ.
ּ ǰ ȣƮ ڿ ͵ ȣƮ
ǿ ش.</p>
<p>ּ <code>ServerName</code> ٸ ϴ
ǻ ȣƮ Ѵ. ּ
<code>ServerName</code> DNS ̻Ͽ IP ּҵ
<em>ּ ּ</em>̶ θ.</p>
<p≯ ȣƮ <code>ServerName</code>
ȣƮ ϴ <code>VirtualHost</code>
ó ּҸ ⺻ Ѵ.</p>
<p>Ư <code>_default_</code> Ʈī带 ϴ
ȣƮ ּ <code>ServerName</code> .</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="hostmatching" id="hostmatching">ȣƮ ã</a></h2>
<p> Ʒ ȣƮ û
ó Ѵ:</p>
<h3><a name="hashtable" id="hashtable">ؽ̺ ã</a></h3>
<p>Ŭ̾Ʈ ó ϸ IP ּҸ IP
ؽ̺ ã´.</p>
<p>IP ּҸ ã Ŭ̾Ʈ û Ʈ
شϴ ȣƮ ִٸ, <code>_default_</code> ȣƮ
û Ѵ. <code>_default_</code> ȣƮ
ٸ ּ û Ѵ.</p>
<p>ؽ̺ IP ּҰ Ʈ ȣ
<code>NameVirtualHost *</code> ش ִ.
̸ ȣƮó óѴ.</p>
<p>ãҴٸ (Ͽ IP ּҿ شϴ ã),
IP ȣƮ ̸ ȣƮ Ѵ.</p>
<h3><a name="ipbased" id="ipbased">IP ȣƮ</a></h3>
<p>ã ̸ ٸ IP ȣƮ̴.
̻ ۾ ʿ, ȣƮ û óѴ.</p>
<h3><a name="namebased" id="namebased"≯ ȣƮ</a></h3>
<p≯ Ͽ Ѱ ̻ ȣƮ ԵǸ
̸ ȣƮ̴. Ͽ ȣƮ
<code>VirtualHost</code> ġѴ.</p>
<p>Ͽ ù° ȣƮ(Ͽ ش IP ּҸ
ϴ ù° ȣƮ) 켱 ,
ų <code>Host:</code> û
óѴ.</p>
<p>Ŭ̾Ʈ <code>Host:</code> ָ, Ͽ
ù° <code>ServerName</code>̳
<code>ServerAlias</code> ϴ ȣƮ û
Ѵ. <code>Host:</code> Ʈ ȣ
, ġ Ŭ̾Ʈ û Ʈ
ã´.</p>
<p>Ŭ̾Ʈ <code>Host:</code> HTTP/1.0 û
ϸ Ŭ̾Ʈ Ϸ
û URI شϴ <code>ServerPath</code> ִ ã´.
Ͽ ã θ ϰ, ȣƮ
û Ѵ.</p>
<p>ϴ ȣƮ ã ٸ, (̹ տ ߵ)
Ŭ̾Ʈ IP Ͽ ġϴ Ʈ ȣ
ϴ ù° ȣƮ û Ѵ.</p>
<h3><a name="persistent" id="persistent"> </a></h3>
<p>IP ѵ Ư TCP/IP Ǵ <em>ѹ</em>
ã, ̸ KeepAlive/ ᵿ <em></em> û
ã´. , Ŭ̾Ʈ ᵿ ̸
ȣƮ û ִ.</p>
<h3><a name="absoluteURI" id="absoluteURI"> URI</a></h3>
<p>û URI URḬ Ŭ̾Ʈ û
ȣƮ Ʈ ּ Ư ȣƮ شϸ,
ּ Ȥ ȣƮ URI Ŵ/ȣƮ/Ʈ
κ URI Ѵ. شϴ
ּ ȣƮ ٸ URI ״ ΰ û
Ͻ û óѴ.</p>
<h3><a name="observations" id="observations"></a></h3>
<ul>
<li≯ ȣƮ IP ȣƮ ο
ʴ´. IP ȣƮ ڽ ̸
IP ּҿܿ ּҷε . ̸
ȣƮ . ̸ ȣƮ
<code>NameVirtualHost</code> þ ּ
IP ּҸ ؼ ִ.</li>
<li>IP ȣƮ <code>ServerAlias</code>
<code>ServerPath</code> ˻ ʴ´.</li>
<li>Ͽ ̸ ȣƮ, IP ȣƮ,
<code>_default_</code> ȣƮ, <code>NameVirtualHost</code>
þ ߿ ʴ. Ư ּտ
̸ ȣƮ ߿ϴ. Ͽ
տ ̸ ȣƮ ڽ ּտ
켱 .</li>
<li> <code>Host:</code> Ե Ʈ
ȣ ʴ´. ġ Ŭ̾Ʈ
û Ʈ Ѵ.</li>
<li>( ̸ <code>Host:</code> ٰ
ϸ,) <code>ServerPath</code> þ Ͽ
ڿ ٸ <code>ServerPath</code> þ պκ
Īϴ տ þ Ѵ.</li>
<li> IP ȣƮ ּҸ ,
Ͽ տ ȣƮ Ѵ. ̷
ƹ Ͼ ִ. ̷ Ȳ ߰ϸ
αϿ Ѵ.</li>
<li><code>_default_</code> ȣƮ û IP ּ<em></em>
Ʈ ȣ شϴ ȣƮ û óѴ.
Ŭ̾Ʈ û Ʈ ȣ <code>_default_</code>
ȣƮ Ʈ ȣ(⺻ <code>Listen</code>)
û óѴ. Ʈ û̶
(<em> </em>, <code>_default_:*</code>) ϵī
Ʈ ִ. <code>NameVirtualHost *</code>
ȣƮ .</li>
<li>ּ Ŭ̾Ʈ IP ּҿ Ʈ ȣ
شϴ (<code>_default_</code> ȣƮ Ͽ)
ȣƮ û Ѵ. , ּ
( Ʈ شϴ <code>_default_</code> ȣƮ
ٸ) ּ/Ʈ ֿ û óѴ.</li>
<li>Ŭ̾Ʈ (<em> </em>, <code>NameVirtualHost</code>
þ) ̸ ȣƮ ּ( Ʈ)
<code>Host:</code> ų
û û <em></em> <code>_default_</code>
ȣƮ ּ ó ʴ´.</li>
<li>Ҷ DNS
<code>VirtualHost</code> þ DNS ̸ .
Դٰ DNS ʴ´ٸ
Ȼ 赵 ִ. ̿ <a href="../dns-caveats.html"></a> ִ.</li>
<li> ȣƮ <code>ServerName</code>
ؾ Ѵ. ȱ ȣƮ DNS ã ȴ.</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="tips" id="tips"></a></h2>
<p><a href="../dns-caveats.html#tips">DNS </a>
߰ Ʒ ִ:</p>
<ul>
<li> ּ Ǹ <code>VirtualHost</code> տ
ξ. ( б ϴ. ȱ ߿
ȣƮ ̿ ǰ ȣƮ
ֱ ȥ.)</li>
<li>б ϵ شϴ <code>NameVirtualHost</code>
<code>VirtualHost</code> ǵ .</li>
<li><code>ServerPath</code> ٸ <code>ServerPath</code>
պκ Īϴ 츦 ϶. ٸ Ͽ
պκ ( ڼ) ȣƮ ª ( ڼ)
ȣƮ տ ξ. (<em> </em>,
"ServerPath /abc" "ServerPath /abc/def" ξ
Ѵ.</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/vhosts/details.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/details.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/details.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/details.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/details.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/examples.html.tr.utf8 0000664 0001751 0001751 00000063675 14743132254 022420 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Sanal Konak Örnekleri - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Sanal Konaklar</a></div><div id="page-content"><div id="preamble"><h1>Sanal Konak Örnekleri</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/vhosts/examples.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/examples.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/examples.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belgede <a href="index.html">sanal konaklarla</a> ile ilgili olarak
karşılaşılması olası tüm senaryolara yer verilmeye çalışılmıştır.
Buradaki senaryolar, tek bir sunucu üzerinde <a href="name- based.html">isme dayalı</a> veya <a href="ip-based.html">IP’ye dayalı</a>
sanal konaklar aracılığıyla çok sayıda sitenin sunumu ile ilgilidir.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#purename">Tek bir IP ile çok sayıda isme dayalı site</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#twoips">IP adresleri farklı çok sayıda isme dayalı site</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#intraextra">Aynı içeriği farklı IP adresleriyle sunmak
(örn., dahili ve harici ağlara)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#port">Farklı portlarla farklı siteler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ip">IP’ye dayalı sanal konaklar</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ipport">Hem IP’ye hem de porta dayalı sanal konaklar</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mixed">Hem isme hem de IP‘ye dayalı sanal konaklar</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#proxy"><code>Virtualhost</code> ve
<code>mod_proxy</code>’nin birlikte kullanımı</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#default"><code>_default_</code> sanal konakları</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#migrate">Bir isme dayalı sanal konağı bir IP’ye dayalı
sanal konakla yansılamak</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#serverpath"><code>ServerPath</code> yönergesinin kullanımı</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="purename" id="purename">Tek bir IP ile çok sayıda isme dayalı site</a></h2>
<p>Bu örnekte, makinenizin tek bir IP adresine çözümlenen çok sayıda konak
adına sahip olduğunu, <code>example.com</code> ve
<code>example.org</code> gibi farklı isimlere farklı yanıtlar vermek
istediğinizi varsayalım.</p>
<div class="note"><h3>Bilginize</h3><p>Apache sunucusu üzerinde sanal konakları
yapılandırmakla bu konak isimleri için sihirli bir şekilde DNS
kayıtlarının da oluşturulmasını sağlamış olmazsınız. Bu isimler için
ilgili DNS kayıtlarında sizin IP adresinize çözümlenen A kayıtlarının
olması gerekir, yoksa sitenize kimse erişemez. Sitelere erişimi yerel
olarak denemek isterseniz, bu girdileri <code>hosts</code> dosyanıza
yazabilirsiniz. Fakat bu sadece sizin makinenizde çalışır. Yerel
ağınızdaki her makinenin <code>hosts</code> dosyasına bu girdileri
yazarak yerel ağdan erişimi bu yolla sağlayabilirsiniz ama dış ağdan
gelecek ziyaretçileriniz için DNS kayıtlarınızın olması şarttır.</p>
</div>
<pre class="prettyprint lang-config"># Apache’nin 80. portu dinlediğinden emin olalım
Listen 80
<VirtualHost *:80>
DocumentRoot "/siteler/ecom"
ServerName example.com
# Diğer yönergeler, burada ...
</VirtualHost>
<VirtualHost *:80>
DocumentRoot "/siteler/eorg"
ServerName example.org
# Diğer yönergeler, burada ...
</VirtualHost></pre>
<p>Yıldız imleri tüm adreslerle eşleşmeyi sağladığından ana sunucu
(yapılandırma dosyası genelindeki yapılandırma - sunucu geneli)
erişilebilir olmayacaktır. Yapılandırma
dosyasındaki <code>ServerName example.com</code> yönergeli konak, ilk
sanal konak olduğundan en yüksek önceliğe sahiptir ve
<cite>öntanımlı</cite> veya <cite>baskın</cite> site olarak davranır.
Yani, hiçbir <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> yönergesi
ile eşleşmeyen bir istek alındığında bu istek ilk <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> yapılandırması ile
karşılanır.</p>
<p>Yukarıdaki yapılandırmayı hemen hemen tüm isme dayalı sanal konaklar
için kullanabilirsiniz. Bu yapılandırmanın çalışmayacağı tek durum,
farklı içerikleri farklı IP adres veya portlardan sunma gereğiyle
karşılaşmaktır.</p>
<div class="note"><h3>Bilginize</h3>
<p><code>*</code> yerine sisteminizdeki belli bir IP adresini
yazabilirsiniz. Böyle sanal konaklar sadece, HTTP isteklerinin sadece
belirtilen IP adreslerinden alınması için kullanilabilir.</p>
<pre class="prettyprint lang-config">NameVirtualHost 192.168.1.22
<VirtualHost 192.168.1.22>
# vs. ...
</VirtualHost></pre>
<p>Bununla birlikte, IP adresinin önceden kestirilebilir olmadığı
sistemlerde, örneğin, hizmet sağlayıcınıza çevirmeli ağ ile bağlanıyor
ve onun rasgele atadığı bir IP adresi için bir devingen DNS çözümü
kullanıyorsanız, IP adresi değil de <code>*</code> kullanmak daha çok
işinize yarayacaktır. Yıldız imi her IP adresi ile eşleşeceğinden IP
adresiniz değişse bile bu yapılandırmayı değiştirmeden
kullanabilirsiniz.</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="twoips" id="twoips">IP adresleri farklı çok sayıda isme dayalı site</a></h2>
<div class="note"><h3>Bilginize</h3>
<p>Burada açıklanan teknikler istendiği kadar çok IP adresine
genişletilebilir.</p>
</div>
<p>Sunucunun iki IP adresi olsun. Birinden "ana sunucu"
(<code>192.168.1.2</code>) diğerinden <code>example.com</code>
<code>192.168.2.2</code> hizmet versin. Bu arada başka sanal konakları
da sunabilelim istiyoruz.</p>
<pre class="prettyprint lang-config">Listen 80
# Bu, 192.168.1.2 adresindeki "ana sunucu" olsun
ServerName sunucu.example.com
DocumentRoot "/siteler/anasunucu"
<VirtualHost 192.168.1.20>
DocumentRoot "/siteler/ecom"
ServerName example.com
# Diğer yönergeler, burada ...
</VirtualHost>
<VirtualHost 192.168.1.20>
DocumentRoot "/siteler/eorg"
ServerName example.org
# Diğer yönergeler, burada ...
</VirtualHost></pre>
<p><code>192.168.1.20</code> adresinden gelmeyen tüm isteklere ana sunucu
(<code>sunucu.example.com</code>), <code>192.168.1.20</code> adresinden
gelen sunucu ismi belirtmeyenler ile <code>Host:</code> başlığı
belirtmeyenlere ise <code>example.com</code> hizmet verecektir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="intraextra" id="intraextra">Aynı içeriği farklı IP adresleriyle sunmak
(örn., dahili ve harici ağlara)</a></h2>
<p>Sunucu makine iki IP adresine sahip olsun. Biri iç ağa
(<code>192.168.1.1</code>) diğeri dış ağa (<code>172.20.30.40</code>)
bakıyor olsun. <code>sunucu.example.com</code> ismi dış ağda dış ağa
bakan IP’ye, iç ağda ise iç ağa bakan IP’ye çözümleniyor olsun.</p>
<p>Bu durumda, sunucu hem iç hem de dış ağdan gelen isteklere aynı içerik,
dolayısıyla aynı <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> bölümü ile hizmet verebilir.</p>
<pre class="prettyprint lang-config"><VirtualHost 192.168.1.1 172.20.30.40>
DocumentRoot "/siteler/sunucu"
ServerName sunucu.example.com
ServerAlias sunucu
</VirtualHost></pre>
<p>Artık, hem iç hem de dış ağdan gelen isteklere aynı
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
bölümünden hizmet sunulacaktır.</p>
<div class="note"><h3>Bilginize:</h3>
<p>İç ağdan istek yapan biri, tam nitelenmiş konak ismi
<code>sunucu.example.com</code> yerine makine ismini
(<code>sunucu</code>) kullanabilir (<code>ServerAlias sunucu</code>
satırına dikkat).</p>
<p>Ayrıca, yukarıdaki gibi iki ayrı IP adresi belirtmek yerine sadece
<code>*</code> belirtmekle sunucunun tüm IP adreslerine yine aynı
içerikle yanıt vereceğine dikkat ediniz.</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="port" id="port">Farklı portlarla farklı siteler</a></h2>
<p>Aynı IP adresine sahip çok sayıda konak ismine sahip olduğunuzu ve
bunların bazılarının farklı portları kullanmasını istediğinizi
varsayalım. Aşağıdaki örnekte, isim eşleşmesinin, en iyi eşleşen IP
adresi ve port çifti saptandıktan sonra yer alması gösterilmiştir. </p>
<pre class="prettyprint lang-config">Listen 80
Listen 8080
<VirtualHost 172.20.30.40:80>
ServerName example.com
DocumentRoot "/siteler/ecom-80"
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
ServerName example.com
DocumentRoot "/siteler/ecom-8080"
</VirtualHost>
<VirtualHost 172.20.30.40:80>
ServerName example.org
DocumentRoot "/siteler/eorg-80"
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
ServerName example.org
DocumentRoot "/siteler/eorg-8080"
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ip" id="ip">IP’ye dayalı sanal konaklar</a></h2>
<p>Sunucu makinenin, biri <code>example.com</code> adından çözümlenen
<code>172.20.30.40</code>, diğeri <code>example.org</code> adından
çözümlenen <code>172.20.30.50</code> diye iki IP adresi olsun.</p>
<pre class="prettyprint lang-config">Listen 80
<VirtualHost 172.20.30.40>
DocumentRoot "/siteler/ecom"
ServerName example.com
</VirtualHost>
<VirtualHost 172.20.30.50>
DocumentRoot "/siteler/eorg"
ServerName example.org
</VirtualHost></pre>
<p><code><VirtualHost></code> yönergelerinde belirtilmeyen
adreslerle yapılan isteklere (örneğin, <code>localhost</code>) sunucu
genelindeki yapılandırma ile ana sunucu yanıt verecektir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ipport" id="ipport">Hem IP’ye hem de porta dayalı sanal konaklar</a></h2>
<p>Sunucu makinenin, biri <code>example.com</code> adından çözümlenen
<code>172.20.30.40</code>, diğeri <code>example.org</code> adından
çözümlenen <code>172.20.30.50</code> diye iki IP adresi olsun ve iki
konak da hem 80 hem de 8080 portlarında çalışsınlar istiyoruz.</p>
<pre class="prettyprint lang-config">Listen 172.20.30.40:80
Listen 172.20.30.40:8080
Listen 172.20.30.50:80
Listen 172.20.30.50:8080
<VirtualHost 172.20.30.40:80>
DocumentRoot "/siteler/ecom-80"
ServerName example.com
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
DocumentRoot "/siteler/ecom-8080"
ServerName example.com
</VirtualHost>
<VirtualHost 172.20.30.50:80>
DocumentRoot "/siteler/eorg-80"
ServerName example.org
</VirtualHost>
<VirtualHost 172.20.30.50:8080>
DocumentRoot "/siteler/eorg-8080"
ServerName example.org
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="mixed" id="mixed">Hem isme hem de IP‘ye dayalı sanal konaklar</a></h2>
<p>Bir <code>VirtualHost</code> yönergesinde belirtilen bir IP adresi başka
bir sanal konakta görünmüyorsa bu sankon kesinlikle IP'ye dayalı bir
sanal konaktır.</p>
<pre class="prettyprint lang-config">Listen 80
<VirtualHost 172.20.30.40>
DocumentRoot "/siteler/ecom"
ServerName example.com
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/siteler/eorg"
ServerName example.org
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/siteler/enet"
ServerName example.net
</VirtualHost>
# IP'ye dayalı
<VirtualHost 172.20.30.50>
DocumentRoot "/siteler/eedu"
ServerName example.edu
</VirtualHost>
<VirtualHost 172.20.30.60>
DocumentRoot "/siteler/egov"
ServerName example.gov
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy"><code>Virtualhost</code> ve
<code>mod_proxy</code>’nin birlikte kullanımı</a></h2>
<p>Bu örnekte bir arabirimi dışarıya bakan bir makinede, başka bir
makinede çalışan bir sunucuya sanal konak olarak, bir vekil sunucu
çalıştırmak istediğimizi varsayıyoruz. <code>192.168.111.2</code> IP
adresli bir makinede aynı isimde bir sanal konak yapılandırılmış olsun.
Çok sayıda konak ismi için vekil olarak tek bir makine kullandığımızdan
ve konak isminin de aktarılmasını arzuladığımızdan <code class="directive"><a href="../mod/mod_proxy.html#proxypreservehost">ProxyPreserveHost
On</a></code> yönergesini kullandık.</p>
<pre class="prettyprint lang-config"><VirtualHost *:*>
ProxyPreserveHost On
ProxyPass "/" "http://192.168.111.2/"
ProxyPassReverse "/" "http://192.168.111.2/"
ServerName konak.example.com
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="default" id="default"><code>_default_</code> sanal konakları</a></h2>
<h3><a name="defaultallports" id="defaultallports">Tüm portlar için <code>_default_</code></a></h3>
<p>Bir IP adresi ve port belirtilmeyen veya hiçbir sanal konağın hiçbir
adresi/portu ile eşleşmeyen istekleri yakalamak istersek...</p>
<pre class="prettyprint lang-config"><VirtualHost _default_:*>
DocumentRoot "/siteler/default"
</VirtualHost></pre>
<p>Bütün portlarla eşleşen böyle bir öntanımlı sanal konağın kullanımı
hiçbir isteğin ana sunucuya gitmemesi sonucunu doğurur.</p>
<p>Bir öntanımlı sanal konak, asla, isme dayalı sanal konaklar için
kullanılmış bir adrese/porta gönderilmiş bir isteğe hizmet sunmaz. Eğer
istek bilinmeyen bir <code>Host:</code> başlığına sahipse veya hiç
<code>Host:</code> başlığı içermiyorsa isteğe daima ilk (yapılandırma
dosyasındaki ilk) isme dayalı sanal konak hizmet sunar.</p>
<p>Her isteği tek bir bilgilendirme sayfasına (veya betiğe) yönlendirmek
isterseniz <code class="directive"><a href="../mod/mod_alias.html#aliasmatch">AliasMatch</a></code> veya
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> yönergesini
kullanabilirsiniz.</p>
<h3><a name="defaultdifferentports" id="defaultdifferentports">Farklı portlardan <code>_default_</code></a></h3>
<p>Önceki yapılandırmaya ek olarak 80. portta ayrı bir
<code>_default_</code> sanal konağı kullanmak istersek...</p>
<pre class="prettyprint lang-config"><VirtualHost _default_:80>
DocumentRoot "/siteler/default80"
# ...
</VirtualHost>
<VirtualHost _default_:*>
DocumentRoot "/siteler/default"
# ...
</VirtualHost></pre>
<p>80. porttan hizmet sunan <code>_default_</code> sanal konağı IP adresi
belirtilmeyen tüm istekleri yakalar, bunu yapabilmesi için yapılandırma
dosyasında tüm portlara hizmet sunan benzerinden önce yer almalıdır. Bu
durumda ana sunucu hiçbir isteğe yanıt vermeyecektir.</p>
<h3><a name="defaultoneport" id="defaultoneport">Tek portluk <code>_default_</code></a></h3>
<p><code>_default_</code> sanal konağının sadece 80. porttan hizmet
sunmasını istersek...</p>
<pre class="prettyprint lang-config"><VirtualHost _default_:80>
DocumentRoot "/siteler/default"
...
</VirtualHost></pre>
<p>80. porttan gelen IP adresi belirtilmemiş isteklere
<code>_default_</code> sanal konağı, diğer portlardan gelen adres
belirtilmemiş isteklere ise ana sunucu hizmet verecektir.</p>
<p>Bir sanal konak bildiriminde <code>*</code> kullanımı
<code>_default_</code> kullanımından daha yüksek öncelik sağlar.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="migrate" id="migrate">Bir isme dayalı sanal konağı bir IP’ye dayalı
sanal konakla yansılamak</a></h2>
<p>İsme dayalı sanal konak örneklerinin <a href="#twoips">2. sinde</a> adı
geçen <code>example.org</code> bu örnekte kendi IP adresinden hizmet
veriyor olsun. İsme dayalı sanal konağı eski IP adresiyle kaydetmiş
vekiller ve isim sunucularından kaynaklanacak olası sorunlardan kaçınmak
için yansılama sırasında sanal konağı hem eski hem de yeni IP adresiyle
sunmamız lazım.</p>
<p>Çözüm kolay, çünkü yapacağımız sadece <code>VirtualHost</code>
yönergesine yeni IP adresini (<code>192.168.1.2</code>) eklemek
olacak.</p>
<pre class="prettyprint lang-config">Listen 80
ServerName example.com
DocumentRoot "/siteler/ecom"
<VirtualHost 192.168.1.20 192.168.1.2>
DocumentRoot "/siteler/eorg"
ServerName example.org
# ...
</VirtualHost>
<VirtualHost 192.168.1.20>
DocumentRoot "/siteler/enet"
ServerName example.enet
ServerAlias *.example.net
# ...
</VirtualHost></pre>
<p>Böylece sanal konağa hem yeni (bir IP’ye dayalı sanal konak olarak)
hem de eski adresinden (bir isme dayalı sanal konak olarak)
erişilebilecektir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="serverpath" id="serverpath"><code>ServerPath</code> yönergesinin kullanımı</a></h2>
<p>İsme dayalı iki sanal konağı olan bir sunucumuz olsun. Doğru sanal
konağa erişebilmek için istemcinin doğru <code>Host:</code> başlığı
göndermesi gerekir. Eski HTTP/1.0 istemcileri böyle bir başlık
göndermedikleri için Apache istemcinin hangi sanal konağa erişmek
istediğini bilemez (ve isteğe ilk sanal konaktan hizmet sunar). Daha iyi
bir geriye uyumluluk sağlamak için isme dayalı sanal konağa bir önek
bağlantısı içeren bir bilgilendirme sayfası sunmak üzere yeni bir sanal
konak oluşturabiliriz.</p>
<pre class="prettyprint lang-config"><VirtualHost 172.20.30.40>
# ilk sanal konak
DocumentRoot "/siteler/baska"
RewriteEngine On
RewriteRule "." "/siteler/baska/index.html"
# ...
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot /siteler/baska/bir
ServerName "bir.baska.tld"
ServerPath "/bir/"
RewriteEngine On
RewriteRule "^(/bir/.*) /siteler/baska$1"
# ...
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/siteler/baska/iki"
ServerName iki.baska.tld
ServerPath "/iki/"
RewriteEngine On
RewriteRule "^(/iki/.*)" "/siteler/baska$1"
# ...
</VirtualHost></pre>
<p><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code> yönergesinden dolayı
<code>http://bir.baska.tld/bir/</code> şeklinde yapılan isteklere
<em>daima</em> “bir” sanal konağı hizmet sunacaktır.</p>
<p><code>http://bir.baska.tld/</code> şeklinde yapılan isteklere ise
istemcinin doğru <code>Host:</code> başlığı göndermesi şartıyla
“bir” sanal konağı hizmet sunacaktır. İstemci, bir
<code>Host:</code> başlığı göndermediği takdirde ilk konaktan bir
bilgilendirme sayfası alacaktır.</p>
<p>Yalnız buradaki bir tuhaflığa dikkat edin: Eğer istemci bir
<code>Host:</code> başlığı göndermeden
<code>http://iki.baska.tld/bir/</code> şeklinde bir istek yaparsa bu
isteğe de “bir” sanal konağı hizmet sunacaktır.</p>
<p><code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> yönergesi, bir
istemcinin, bir URL öneki belirtsin ya da belirtmesin doğru
<code>Host:</code> başlığı gönderdiğinden emin olmak için
kullanılmıştır.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/vhosts/examples.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/examples.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/examples.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/examples.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/index.html.ja.utf8 0000664 0001751 0001751 00000021723 14743132254 021642 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache バーチャルホスト説明書 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Apache バーチャルホスト説明書</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p><cite>バーチャルホスト</cite>という用語は、1 台のマシン上で
(<code>www.company1.com</code> and <code>www.company2.com</code> のような)
二つ以上のウェブサイトを扱う運用方法のことを指します。
バーチャルホストには、各ウェブサイトに違う IP アドレスがある
「<a href="ip-based.html">IP ベース</a>」と、それぞれの IP アドレスに
複数の名前がある「<a href="name-based.html">名前ベース</a>」とがあります。
複数のサイトが物理的に同じサーバで扱われている、ということはエンドユーザには
明らかではありません。</p>
<p>Apache は、特に手を入れない状態で IP ベースのバーチャルホスト
をサポートした最初のサーバの一つです。バージョン 1.1 以降の Apache
では、IP ベースとネームベースのバーチャルホストの両方をサポート
しています。ネームベースのバーチャルホストは、<em>ホストベース</em>あるいは
<em>非 IP ベース</em>のバーチャルホストと呼ばれることもあります。</p>
<p>以下のページでは、Apache バージョン 1.3
以降でのバーチャルホストのサポートについての詳細を説明します。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#support">バーチャルホストのサポート</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#directives">設定ディレクティブ</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li><li><a href="name-based.html">ネームベースのバーチャルホスト</a></li><li><a href="ip-based.html">IP ベースのバーチャルホスト</a></li><li><a href="examples.html">バーチャルホストの一般的な設定例</a></li><li><a href="fd-limits.html">ファイル記述子の限界</a></li><li><a href="mass.html">大量のバーチャルホストの設定</a></li><li><a href="details.html">バーチャルホストのマッチングについての詳細</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="support" id="support">バーチャルホストのサポート</a></h2>
<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>多過ぎるログファイル</em>)</li>
<li><a href="mass.html">大量のバーチャルホストの設定</a></li>
<li><a href="details.html">バーチャルホストのマッチングについての詳細</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="directives" id="directives">設定ディレクティブ</a></h2>
<ul>
<li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li>
<li><code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code></li>
<li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li>
</ul>
<p>バーチャルホストの設定のデバッグをするには
Apache のコマンドラインスイッチ <code>-S</code> が便利です。
つまり、以下のコマンドを入力します:</p>
<div class="example"><p><code>
/usr/local/apache2/bin/httpd -S
</code></p></div>
<p>このコマンドは Apache が設定ファイルをどう解析したかについて出力します。
IP アドレスとサーバ名を注意深く調べれば、
設定の間違いを見つける助けになるでしょう。
(他のコマンドラインのオプションは <code class="program"><a href="../programs/httpd.html">httpd</a></code>
プログラムの説明文書を見てください)</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/ip-based.html.ja.utf8 0000664 0001751 0001751 00000033711 14743132254 022217 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache の IP ベースのバーチャルホストサポート - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">バーチャルホスト</a></div><div id="page-content"><div id="preamble"><h1>Apache の IP ベースのバーチャルホストサポート</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/vhosts/ip-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/ip-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/ip-based.html" title="Japanese"> ja </a> |
<a href="../ko/vhosts/ip-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/ip-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#requirements">システム要件</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#howto">Apache の設定方法</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multiple">複数デーモンの設定</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#single">複数のバーチャルホストの設定をした
デーモンを一つ設定する</a></li>
</ul><h3>参照</h3><ul class="seealso"><li>
<a href="name-based.html">名前ベースのバーチャルホストサポート</a>
</li><li><a href="#comments_section">コメント</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="requirements" id="requirements">システム要件</a></h2>
<p><cite>IP ベース</cite> という名前が示すように、サーバには
<strong>IP ベースのバーチャルホストそれぞれにつき、別々の IP アドレスが
必要です</strong>。複数の物理コネクションを持っているマシンを用意するか、
最近のオペレーティングシステムでサポートされているバーチャル
インタフェース (詳細はシステムの説明書を読んでください。たいていは
"ip エイリアス" と呼ばれていて、設定には普通 "ifconfig" コマンドを
使います) を使うかで実現できます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="howto" id="howto">Apache の設定方法</a></h2>
<p>複数のホストをサポートするように Apache を設定する方法は
二通りあります。別の <code class="program"><a href="../programs/httpd.html">httpd</a></code> デーモンを各ホスト毎に実行するか、
すべてのバーチャルホストをサポートするデーモンを一つ実行するかです。</p>
<p>以下のときには複数のデーモンを使うと良いでしょう:</p>
<ul>
<li>会社1 はウェブ経由以外では会社2 からはデータを読まれたくない、
といったセキュリティの分離の問題があるとき。この場合、それぞれ
<code class="directive"><a href="../mod/mpm_common.html#user">User</a></code>, <code class="directive"><a href="../mod/mpm_common.html#group">Group</a></code>, <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>, <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> の設定が違う二つのデーモンを
実行する必要があります。</li>
<li>マシンのすべての IP エイリアスを listen するだけの
メモリとファイル記述子の余裕があるとき。<code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> は「ワイルドカード」
アドレスか、特定のアドレスのみを listen することができます。
ですから、何らかの理由で特定のアドレスを listen しなけばならない
ときは、その特定のアドレスをすべて listen する必要があります。
(ただし、一つの <code class="program"><a href="../programs/httpd.html">httpd</a></code> が N-1 個のアドレスを listen し、
別の <code class="program"><a href="../programs/httpd.html">httpd</a></code> が残りのアドレスを listen するといったことは可能です。)</li>
</ul>
<p>以下のときには単独のデーモンを使うと良いでしょう:</p>
<ul>
<li>バーチャルホスト間での httpd の設定を共有してもよいとき。</li>
<li>マシンが多くのリクエストを扱うため、別デーモンを実行することによる
性能の低下の影響が著しいとき。</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="multiple" id="multiple">複数デーモンの設定</a></h2>
<p>各バーチャルホストに対して別の <code class="program"><a href="../programs/httpd.html">httpd</a></code> のインストールを行ないます。
設定ファイル中の <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>
ディレクティブを使って、
各インストールでデーモンが扱う IP アドレス (バーチャルホスト)
を選択します。例えば</p>
<div class="example"><p><code>
Listen www.smallco.com:80
</code></p></div>
<p>ここで、ホスト名の代わりに IP アドレスを使う方が推奨されていることに
注意しておいてください
(<a href="../dns-caveats.html">DNS の注意事項</a> 参照)。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="single" id="single">複数のバーチャルホストの設定をした
デーモンを一つ設定する</a></h2>
<p>この場合は、一つの <code class="program"><a href="../programs/httpd.html">httpd</a></code> が主サーバとすべてのバーチャルホストのリクエストを
処理します。設定ファイルの <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> ディレクティブを使って、
<code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>, <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>, <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, <code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code>, <code class="directive"><a href="../mod/mod_log_config.html#transferlog">TransferLog</a></code>
や <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code>
設定ディレクティブの値が各ホスト毎に異なる値に設定されるようにします。
例えば</p>
<div class="example"><p><code>
<VirtualHost www.smallco.com><br />
ServerAdmin webmaster@mail.smallco.com<br />
DocumentRoot /groups/smallco/www<br />
ServerName www.smallco.com<br />
ErrorLog /groups/smallco/logs/error_log<br />
TransferLog /groups/smallco/logs/access_log<br />
</VirtualHost><br />
<br />
<VirtualHost www.baygroup.org><br />
ServerAdmin webmaster@mail.baygroup.org<br />
DocumentRoot /groups/baygroup/www<br />
ServerName www.baygroup.org<br />
ErrorLog /groups/baygroup/logs/error_log<br />
TransferLog /groups/baygroup/logs/access_log<br />
</VirtualHost>
</code></p></div>
<p>ここで、ホスト名の代わりに IP アドレスを使う方が推奨されていることに
注意しておいてください
(<a href="../dns-caveats.html">DNS の注意事項</a> 参照)。</p>
<p>プロセス生成を制御するディレクティブやその他のいくつかのディレクティブを
除いて、ほぼ<strong>すべて</strong>の設定ディレクティブを VirtualHost
ディレクティブの中に書くことができます。ディレクティブが VirtualHost
ディレクティブで使用できるかどうかは <a href="../mod/directives.html">ディレクティブ索引</a>を使って<a href="../mod/directive-dict.html#Context">コンテキスト</a>の
欄を調べてください。</p>
<p><a href="../suexec.html">suEXECラッパー</a>を使っている場合は、
<code class="directive"><a href="../mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code>
ディレクティブを VirtualHost
ディレクティブの中で使用することができます。</p>
<p><em>セキュリティ:</em> ログファイルを書く場所を指定するときは、
Apache を起動したユーザ以外がそのディレクトリに書き込み権限を
持っている場合にセキュリティ上の危険があることに注意してください。
詳細は<a href="../misc/security_tips.html">セキュリティのこつ</a>ドキュメントを
参照してください。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/vhosts/ip-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/ip-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/ip-based.html" title="Japanese"> ja </a> |
<a href="../ko/vhosts/ip-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/ip-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/ip-based.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/mass.html.tr.utf8 0000664 0001751 0001751 00000046716 14743132254 021542 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Devingen olarak Yapılandırılan Kitlesel Sanal Barındırma - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Sanal Konaklar</a></div><div id="page-content"><div id="preamble"><h1>Devingen olarak Yapılandırılan Kitlesel Sanal Barındırma</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/vhosts/mass.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/mass.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/mass.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/mass.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belgede sanal konakların sonu belirsiz bir şekilde artışı karşısında
Apache HTTP Sunucusunun nasıl daha verimli kullanılacağı açıklanmıştır.
Devingen kitlesel konakları oluşturmak için <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
modülünün kullanımını açıklayan <a href="../rewrite/vhosts.html">ayrı bir
belge</a> de mevcuttur.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#motivation">Amaç</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#overview">Genel Bakış</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#simple">mod_vhost_alias ile Kitlesel Sanal Konaklar</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#homepages">Basitleştirilmiş Kitlesel Sanal Konaklar</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#combinations">Aynı Sunucuda Kişisel ve Kurumsal Sanal Konaklar</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ipbased">IP’ye dayalı sanal konakları daha verimli kılmak</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#simple.rewrite"><code>mod_rewrite</code> ile Kitlesel Sanal Konaklar</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#macro"><code>mod_macro</code> ile Kitlesel Sanal Konaklar</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="motivation" id="motivation">Amaç</a></h2>
<p>Burada açıklanan teknikler, <code>httpd.conf</code> dosyanızın
örnekteki gibi, aslında hemen hemen birbirinin aynı çok sayıda
<code><VirtualHost></code> bölümü içereceği zaman yapılacaklar ile
ilgilidir.</p>
<pre class="prettyprint lang-config"><VirtualHost 111.22.33.44>
ServerName musteri-1.example.com
DocumentRoot "/siteler/musteri-1/belgeler"
ScriptAlias "/cgi-bin/" "/siteler/musteri-1/cgi-bin"
</VirtualHost>
<VirtualHost 111.22.33.44>
ServerName musteri-2.example.com
DocumentRoot "/siteler/musteri-2/belgeler"
ScriptAlias "/cgi-bin/" "/siteler/musteri-2/cgi-bin"
</VirtualHost>
<VirtualHost 111.22.33.44>
ServerName musteri-N.example.com
DocumentRoot "/siteler/musteri-N/belgeler"
ScriptAlias "/cgi-bin/" "/siteler/musteri-N/cgi-bin"
</VirtualHost></pre>
<p>İsteğimiz çok sayıda <code><VirtualHost></code> bölümünü devingen
olarak çalışan tek bir <code><VirtualHost></code> bölümüyle
değiştirmektir. Bunun elbette bazı getirileri olacaktır:</p>
<ol>
<li>Yapılandırma dosyanız küçüleceği için Apache daha çabuk
başlatılabilecek ve daha az bellek harcayacaktır. Muhtemelen daha da
önemlisi, küçülmüş bir yapılandırmanın bakımı da kolaylaşacağı için
hatalar da azalacaktır.</li>
<li>Yeni sanal konakların eklenmesi, DNS’de yeni girdiler oluşturmak ve
dosya sisteminde bununla ilgili dizinleri açmak dışında biraz daha
basit olacaktır; en azından Apache’yi yeniden yapılandırmak ve yeniden
başlatmak zorunda kalmayacaksınız.</li>
</ol>
<p>Ana götürüsü ise her sanal konak için ayrı birer günlük dosyasına sahip
olamayacak olmanızdır. Öte yandan, <a href="fd-limits.html">dosya
tanıtıcılarının sınırlı olması</a> nedeniyle bunu yapmayı zaten
istemezsiniz. Günlük kayıtları için bir <a href="../logs.html#piped">fifo
veya bir boru hattı</a> oluşturmak ve diğer uçta çalışan bir süreç
vasıtasıyla günlükleri müşterilere paylaştırmak daha iyidir. Böyle bir
işlemle ilgili bir örneği <a href="../programs/split-logfile.html">split-logfile</a> aracının belgesinde bulabilirsiniz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="overview" id="overview">Genel Bakış</a></h2>
<p>Bir sanal konak iki bilgiye bakarak belirlenir: IP adresi ve HTTP
isteğindeki <code>Host:</code> başlığının içeriği. Devingen sanal
barındırma tekniği, isteği yerine getirmek için kullanılacak dosya
yoluna bu bilgiyi kendiliğinden girmek esasına dayanır. Bu, Apache httpd
ile <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> modülünü kullanarak oldukça kolay
yapılabileceği gibi <a href="../rewrite/vhosts.html">mod_rewrite modülü
de kullanılabilir</a>.</p>
<p>Bu modüllerin her ikisi de öntanımlı olarak devre dışıdır. Bu tekniği
kullanmak isterseniz Apache httpd'yi yeniden yapılandırıp derleyerek bu
iki modülü etkin duruma getirmeniz gerekir.</p>
<p>Devingen sanal konağı normal bir sanal konak gibi göstermek için
bazı bilgileri istekten saptamak gerekir. Bunlardan en önemlisi,
httpd tarafından göreli URL’lerden normal URL’leri ve benzerlerini
üretmek için kullanılan sunucu ismidir. Sunucu ismi
<code>ServerName</code> yönergesi ile yapılandırılır ve CGI’ler
tarafından <code>SERVER_NAME</code> ortam değişkeni üzerinden
kullanılır. Çalışma anındaki asıl değer <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> yönergesi tarafından denetlenir.
<code>UseCanonicalName Off</code> olduğunda sunucu ismi isteğin
<code>Host:</code> başlık alanından elde edilir. <code>UseCanonicalName
DNS</code> belirtilmişse, sunucu ismi, sanal konağın IP adresinden
tersine DNS sorgusu yapılarak elde edilir. Birincisi isme dayalı sanal
konaklar tarafından ikincisi ise IP’ye dayalı sanal konaklar tarafından
kullanılır. Eğer httpd, istekte <code>Host:</code> başlığının olmayışı
veya DNS sorgusunun başarısız olması sebebiyle sunucu ismini elde
edemezse son çare olarak <code>ServerName</code> yönergesinde yazılı
değeri kullanır.</p>
<p>Saptanan bilgilerden biri de <code>DocumentRoot</code>
yönergesi ile yapılandırılan belge kök dizini olup CGI’ler tarafından
<code>DOCUMENT_ROOT</code> ortam değişkeni üzerinden kullanılır. Normal
yapılandırmada <code class="module"><a href="../mod/core.html">core</a></code> modülü tarafından dosya isimlerini
URI’lere eşlerken kullanılır. Fakat sunucu devingen sanal konakları
kullanmak üzere yapılandırıldığında, eşleştirmeyi farklı yollardan yapan
başka bir modül devreye girer (<code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> veya
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>). <code>DOCUMENT_ROOT</code> ortam
değişkenine değerini atamaktan sorumlu olan bu iki modülden biri
kullanılmazsa CGI veya SSI belgeleri yanlış değerlerle üretilirler.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="simple" id="simple">mod_vhost_alias ile Kitlesel Sanal Konaklar</a></h2>
<p>Yukarıda <a href="#motivation">Amaç</a> bölümünde özetlenen sanal konak
düzenlemesinin <code>mod_vhost_alias</code> kullanarak gerçekleştirilmiş
halini içeren <code>httpd.conf</code> bölümü aşağıdadır.</p>
<pre class="prettyprint lang-config"># sunucu ismini Host: başlığından elde edelim
UseCanonicalName Off
# Bu günlükleme biçiminde split-logfile aracı kullanılarak
# sanal konak günlükleri ilk alana göre ayrıştırılabilir
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log vcommon"
# istekleri yerine getirmek için kullanılacak
# dosya isimlerine sunucu ismini ekleyelim
VirtualDocumentRoot "/siteler/%0/belgeler"
VirtualScriptAlias "/siteler/%0/cgi-bin"</pre>
<p>Bu yapılandırmayı IP’ye dayalı sanal konaklar için kullanmak isterseniz
<code>UseCanonicalName Off</code> yerine <code>UseCanonicalName
DNS</code> yazmanız yeterlidir. Böylece dosya ismine eklenecek konak
ismi sanal konağın IP adresinden türetilir. <code>%0</code> değişkeni,
<code>Host:</code> başlığı ile belirlenen istekteki sunucu isminin
ifadesidir.</p>
<p>Kullanım örnekleri için <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>modülünün
belgesine bakınız.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="homepages" id="homepages">Basitleştirilmiş Kitlesel Sanal Konaklar</a></h2>
<p>Bu sistem, yukarıdaki yapılandırmanın bir ISS’nin sunucusuna
uyarlanmasından başka bir şey değildir. <code>%2</code> değişkenini
kullanarak, dosya isminde kullanmak üzere sunucu isminin alt dizgelerini
seçebiliriz, böylece, örneğin <code>www.user.example.com</code> belgeleri
<code>/home/user/www</code> dizininde bulunabilir. Farklı olarak her
sanal konak için bir tane değil hepsi için bir tane <code>cgi-bin</code>
olacaktır.</p>
<pre class="prettyprint lang-config">UseCanonicalName Off
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
# sunucu ismini içerecek dosya isimlerini oluşturalım
VirtualDocumentRoot "/home/%2/www"
# ortak cgi-bin dizini
ScriptAlias "/cgi-bin/" "/siteler/std-cgi/"</pre>
<p><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> belgesinde daha karmaşık
<code>VirtualDocumentRoot</code> örnekleri vardır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="combinations" id="combinations">Aynı Sunucuda Kişisel ve Kurumsal Sanal Konaklar</a></h2>
<p>Daha karmaşık ayarlamalar yaparak httpd’nin normal
<code><VirtualHost></code> bölümlerini farklı kitlesel sanal konak
yapılandırmaları için kullanabilirsiniz. Örneğin, bireysel
müşterileriniz için bir IP adresiniz, kurumsal müşterileriniz için de
başka bir IP adresiniz olsun. Her biri için ayrı ayrı sanal konaklar
ayarlamak yerine aşağıdaki gibi bir yapılandırma kullanabilirsiniz:</p>
<pre class="prettyprint lang-config">UseCanonicalName Off
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
<Directory "/siteler/kurumsal">
Options FollowSymLinks
AllowOverride All
</Directory>
<Directory "/siteler/bireysel">
Options FollowSymLinks
AllowOverride None
</Directory>
<VirtualHost 111.22.33.44>
ServerName kurumsal.example.com
CustomLog "logs/access_log.kurumsal" vcommon
VirtualDocumentRoot "/siteler/kurumsal/%0/belgeler"
VirtualScriptAlias "/siteler/kurumsal/%0/cgi-bin"
</VirtualHost>
<VirtualHost 111.22.33.45>
ServerName bireysel.example.com
CustomLog "logs/access_log.bireysel" vcommon
VirtualDocumentRoot "/siteler/bireysel/%0/belgeler"
ScriptAlias "/cgi-bin/" "/siteler/std-cgi/"
</VirtualHost></pre>
<div class="note"><h3>Bilginize</h3>
<p>Eğer ilk <code><VirtualHost></code> bölümü bir <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> yönergesi içermezse ilgili IP
için ters DNS sorgusu yapılır. Eğer sorgudan elde edilen isim
sunucunun ismi değilse bu istenmeyen duruma bir çözüm olarak bir
bilgilendirme bölümü (örn, <code>ServerName bilgi.example.com</code>)
eklenebilir.</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="ipbased" id="ipbased">IP’ye dayalı sanal konakları daha verimli kılmak</a></h2>
<p><a href="#simple">İlk örnekte</a> IP’ye dayalı sanal konaklar için
kullanılmak istenirse yapılandırmada neyin nasıl değiştirileceği
belirtilmişti. Her istek için ayrı bir DNS sorgusu gerekeceğinden bu
başarım düşmesine yol açar. DNS sorgusu ihtiyacını ortadan kaldırmak
için, bir çözüm olarak dosya sistemi, konak isimleri yerine IP
adreslerine göre düzenlenebilir. Günlük kayıtları da IP adreslerine göre
ayrıştırılacak şekilde ayarlanabilir.</p>
<pre class="prettyprint lang-config"># Sunucu ismini IP adresinden ters DNS sorgusu ile elde edelim
UseCanonicalName DNS
# Günlük kayıtları IP adreslerine göre ayrıştırılabilsin
LogFormat "%A %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
# dosya isimleri IP adreslerini içersin
VirtualDocumentRootIP "/siteler/%0/belgeler"
VirtualScriptAliasIP "/siteler/%0/cgi-bin"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="simple.rewrite" id="simple.rewrite"><code>mod_rewrite</code> ile Kitlesel Sanal Konaklar</a></h2>
<p>Kitlesel sanal barındırma <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> modülü kullanarak
da gerçeklenebilir. Ya basitçe <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> yönergelerini kullanırsınız ya da daha karmaşık
olarak sanal konak tanımlarınızı harici bir yerde tutar ve bunlara
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> yönergesini
kullanarak erişirsiniz. Bu teknikler ayrıntılı olarak
<a href="../rewrite/vhosts.html">rewrite belgelerinde</a>
açıklanmıştır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="macro" id="macro"><code>mod_macro</code> ile Kitlesel Sanal Konaklar</a></h2>
<p>Devingen olarak üretilen sanal konaklar için diğer bir seçenek
<code class="module"><a href="../mod/mod_macro.html">mod_macro</a></code> modülüdür. Bir sanal konak şablonu oluşturup
bunu çok sayıda konak ismi için çağırabilirsiniz. Modül belgelerinin
<strong>Kullanım</strong> bölümünde böyle bir örneğe yer verilmiştir.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/vhosts/mass.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/mass.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/mass.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/mass.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/mass.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/name-based.html.de 0000664 0001751 0001751 00000053001 14744525602 021636 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Unterstützung namensbasierter virtueller Hosts - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Module</a> | <a href="../mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossar</a> | <a href="../sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="../">Version 2.4</a> > <a href="./">Virtual Hosts</a></div><div id="page-content"><div id="preamble"><h1>Unterstützung namensbasierter virtueller Hosts</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="../de/vhosts/name-based.html" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<p>Das Dokument beschreibt, wann und wie namensbasierte virtuelle Hosts zu
verwenden sind.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#namevip">Namensbasierte gegenüber IP-basierten
virtuellen Hosts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#using">Die Verwendung von namensbasierten virtuellen Hosts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#compat">Kompatibilität mit älteren Browsern</a></li>
</ul><h3>Siehe auch</h3><ul class="seealso"><li><a href="ip-based.html">Unterstützung IP-basierter virtueller
Hosts</a></li><li><a href="details.html">Tiefergehende Erörterung der Zuweisung
virtueller Hosts</a></li><li><a href="mass.html">Dynamisch konfiguriertes
Massen-Virtual-Hosting</a></li><li><a href="examples.html">Beispiele für virtuelle Hosts in typischen
Installationen</a></li><li><a href="examples.html#serverpath">ServerPath-Beispielkonfiguration</a></li><li><a href="#comments_section">Kommentare</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="namevip" id="namevip">Namensbasierte gegenüber IP-basierten
virtuellen Hosts</a></h2>
<p>IP-basierte virtuelle Hosts verwenden die IP-Adresse der Verbindung, um den
korrekten virtuellen Host zur Bedienung einer Anfrage zu ermitteln. Folglich
benötigen Sie eine IP-Adresse für jeden virtuellen Host. Bei der
Verwendung von namensbasierten virtuellen Hosts verläßt sich der
Server darauf, dass der Client den Hostnamen als Bestandteil der HTTP-Header
angibt. Durch Anwendung dieser Technik können sich mehrere verschiedene
Hosts die gleiche IP-Adresse teilen.</p>
<p>Die Verwendung von namensbasierten virtuellen Hosts ist gewöhnlich
einfacher. Sie müssen lediglich Ihren DNS-Server darauf einstellen,
jeden Hostnamen auf die richtige IP-Adresse abzubilden, und dann den Apache
HTTP Server so konfigurieren, dass er die verschiedenen Hostnamen erkennt.
Namensbasierte virtuelle Hosts entschärfen auch den Bedarf an
knappen IP-Adressen. Daher sollten Sie namensbasierte virtuelle Hosts
verwenden, sofern kein besonderer Grund dafür existiert, IP-basierte
virtuelle Hosts zu wählen. Mögliche Gründe für die
Verwendung IP-basierter virtueller Hosts sind:</p>
<ul>
<li>Einige antike Clients sind nicht kompatibel zu namensbasierten
virtuellen Hosts. Damit namensbasierte virtuelle Hosts funktionieren,
muss der Client den HTTP-Host-Header senden. Dies ist bei HTTP/1.1
vorgeschrieben und in allen modernen HTTP/1.0-Browsern als Erweiterung
implementiert. Wenn Sie Unterstützung für veraltete Clients
benötigen und dennoch namensbasierte virtuelle Hosts verwenden,
dann finden Sie eine mögliche Lösung dafür am Ende des
Dokuments.</li>
<li>Namensbasierte virtuelle Hosts können aufgrund der Natur des
SSL-Protokolls nicht mit SSL-gesicherten Servern verwendet werden.</li>
<li>Einige Betriebssysteme und Netzwerkanlagen setzen Techniken zum
Bandbreiten-Management ein, die nicht zwischen Hosts unterscheiden
können, wenn diese nicht auf verschiedenen IP-Adressen liegen.</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="using" id="using">Die Verwendung von namensbasierten virtuellen Hosts</a></h2>
<table class="related"><tr><th>Referenzierte Module</th><th>Referenzierte Direktiven</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code></li><li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li><li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li><li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>Um namensbasierte virtuelle Hosts zu verwenden, müssen Sie die
IP-Adresse (und möglicherweise den Port) des Servers benennen, an
der Anfragen für die Hosts entgegengenommen werden. Dies wird mit
der Direktive <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>
eingestellt. Im Normalfall, wenn alle IP-Adressen des Server verwendet
werden sollen, können Sie <code>*</code> als Argument für
<code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> verwenden. Wenn Sie
vorhaben, mehrere Ports zu nutzen (etwa wenn SSL läuft), sollten
Sie dem Argument einen Port hinzufügen, wie zum Beispiel
<code>*:80</code>. Beachten Sie,
dass die Angabe einer IP-Adresse in einer <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>-Anweisung den Server nicht
automatisch an dieser Adresse lauschen läßt. Lesen Sie bitte "<a href="../bind.html">Bestimmen der vom Apache verwendeten Adressen und
Ports</a>" für weitere Details. Zusätzlich muss jede hier
angegebene IP-Adresse einer Netzwerkkarte des Servers zugeordnet sein.</p>
<p>Der nächste Schritt ist die Erstellung eines <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>-Blocks für jeden einzelnen
Host, den Sie bedienen wollen. Das Argument der Direktive <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> sollte das gleiche
sein wie das Argument der <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>-Anweisung (d.h. eine IP-Adresse
oder <code>*</code> für alle Adressen). Innerhalb jedes <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>-Blocks benötigen
Sie zumindestens eine <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>-Anweisung, um zu bestimmen, welcher
Host bedient wird, und eine <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>-Anweisung, um anzugeben, wo im
Dateisystem der Inhalt des Hosts abgelegt ist.</p>
<div class="note"><h3>Der Hauptserver verschwindet</h3>
Wenn Sie virtuelle Hosts zu einem bestehenden Webserver hinzufügen,
müssen Sie auch einen <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>-Block für den bestehenden Host
<span class="transnote">(<em>Anm.d.Ü.:</em> und bisherigen Hauptserver)</span> erstellen.
Die <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>- und
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>-Anweisungen zu diesem
virtuellen Host sollten die gleichen sein wie die globalen <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>- und <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>-Anweisungen. Führen Sie diesen
virtuellen Host als erstes in der Konfigurationsdatei auf, so dass er als
Standard-Host fungiert.
</div>
<p>Vorausgesetzt, Sie bedienen z.B. die Domain
<code>www.domain.tld</code> und möchten den virtuellen Host
<code>www.otherdomain.tld</code> hinzufügen, welcher auf
die gleiche IP-Adresse zeigt. Dann fügen Sie einfach Folgendes der
<code>httpd.conf</code> hinzu:</p>
<div class="example"><p><code>
NameVirtualHost *:80<br />
<br />
<VirtualHost *:80><br />
<span class="indent">
ServerName www.domain.tld<br />
ServerAlias domain.tld *.domain.tld<br />
DocumentRoot /www/domain<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost *:80><br />
<span class="indent">ServerName www.otherdomain.tld<br />
DocumentRoot /www/otherdomain<br />
</span>
</VirtualHost><br />
</code></p></div>
<p>Sie können anstelle des <code>*</code> bei den beiden Anweisungen
<code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> und <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> alternativ eine
eindeutige IP-Adresse angeben. Das kann man beispielsweise machen, um
einige namensbasierte virtuelle Hosts auf einer IP-Adresse zu betreiben und
entweder IP-basierte oder ein anderes Set von namensbasierten virtuellen
Hosts auf einer anderen Adresse.</p>
<p>Viele Server wollen unter mehr als einem Namen erreichbar sein. Die
Direktive <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>, die innerhalb
des <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>-Abschnittes angegeben wird,
ermöglicht dies. Zum Beispiel zeigt die <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>-Anweisung in dem ersten <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>-Block oben an, dass die
aufgeführten Namen alternative Namen sind, die man verwenden kann, um
das gleiche Webangebot zu erreichen:</p>
<div class="example"><p><code>
ServerAlias domain.tld *.domain.tld
</code></p></div>
<p>Anfragen für alle Hosts der Domain <code>domain.tld</code> werden
von dem virtuellen Host <code>www.domain.tld</code> bedient. Die
Platzhalter <code>*</code> und <code>?</code> können anstelle
entsprechender Namen verwendet werden. Natürlich können Sie nicht
einfach Namen erfinden und diese bei <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> oder <code>ServerAlias</code>
angeben, Sie müssen zunächst Ihren DNS Server entsprechend
konfigurieren, dass er diese Namen auf die mit Ihrem Server verknüpfte
IP-Adresse abbildet.</p>
<p>Und schlußendlich können Sie die Konfiguration der virtuellen
Hosts mittels Angabe weiterer Direktiven innherhalb der <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>-Container
feineinstellen. Die meisten Direktiven können in diesen Containern
angegeben werden und verändern dann ausschließlich die
Konfiguration des entsprechenden virtuellen Hosts. Prüfen Sie den <a href="../mod/directive-dict.html#Context">Kontext</a> einer Direktive, um
herauszufinden, ob eine bestimmte Direktive zulässig ist.
Im <em>Hauptserver-Kontext</em> (außerhalb der <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>-Container) definierte
Konfigurationsanweisungen werden nur dann angewendet, wenn sie nicht durch
Einstellungen des virtuellen Hosts außer Kraft gesetzt wurden.</p>
<p>Wenn nun eine Anfrage eintrifft, prüft der Server zuerst, ob sie eine
IP-Adresse verwendet, die der <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>-Anweisung entspricht. Ist dies der
Fall, dann sieht er sich jeden <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>-Abschnitt mit einer passenden
IP-Adresse an und versucht den einen zu finden, dessen <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>- oder <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>-Anweisung mit dem gewünschten
Hostnamen übereinstimmt. Findet er einen, dann verwendet er die
Konfiguration dieses Servers. Wird kein passender virtueller Host gefunden,
dann wird <strong>der erste angegeben virtuelle Host</strong> verwendet,
dessen IP-Adresse paßt.</p>
<p>Die Folge davon ist, dass der erste aufgeführte virtuelle Host der
<em>Standard</em>-Virtual-Host ist. Die <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>-Anweisung des <em>Hauptservers</em>
wird <strong>niemals</strong> verwendet, wenn eine IP-Adresse mit einer
<code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>-Anweisung
übereinstimmt. Wenn Sie eine spezielle Konfiguration für Anfragen
angeben möchten, die keinem bestimmten virtuellen Host entsprechen,
packen Sie diese Konfiguration einfach in einen <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>-Container und führen diesen als
erstes in der Konfigurationsdatei auf.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="compat" id="compat">Kompatibilität mit älteren Browsern</a></h2>
<p>Wie zuvor erwähnt gibt es einige Clients, die nicht die notwendigen
Daten senden, mit denen namensbasierte virtuelle Hosts korrekt
funktionieren. Diesen Clients werden stets die Seiten des ersten, für
diese IP-Adresse aufgeführten virtuellen Hosts gesendet werden (des
<cite>primären</cite> namensbasierten virtuellen Hosts).</p>
<div class="note"><h3>Was bedeutet älter?</h3>
<p>Beachten Sie bitte, wenn wir von älter sprechen, meinen wir auch
älter. Es ist sehr unwahrscheinlich, dass sie einen dieser Browser
heutzutage in Verwendung finden werden. Alle aktuellen Browser-Versionen
senden den <code>Host</code>-Header, so wie er für namensbasierte
virtuelle Hosts benäötigt wird.</p>
</div>
<p>Mit der Direktive <code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code> existiert
eine mögliche Behelfskonstruktion, obgleich sie etwas schwerfällig
ist:</p>
<p>Beispielkonfiguration:</p>
<div class="example"><p><code>
NameVirtualHost 111.22.33.44<br />
<br />
<VirtualHost 111.22.33.44><br />
<span class="indent">
ServerName www.domain.tld<br />
ServerPath /domain<br />
DocumentRoot /web/domain<br />
</span>
</VirtualHost><br />
</code></p></div>
<p>Was bedeutet das? Es bedeutet, dass eine Anfrage für eine mit
"<code>/domain</code>" beginnende URI von dem virtuellen Host
<code>www.domain.tld</code> bedient wird. Dies heißt, dass die Seiten
für alle Clients unter <code>http://www.domain.tld/domain/</code>
abrufbar sind, wenngleich Clients, die den Header <code>Host:</code>
senden, auch über <code>http://www.domain.tld/</code> auf sie zugreifen
können.</p>
<p>Legen Sie einen Link auf der Seite Ihres primären virtuellen Hosts zu
<code>http://www.domain.tld/domain/</code>, um die Behelfslösung
verfügbar zu machen. Bei den Seiten der virtuellen Hosts müssen
Sie dann sicherstellen, entweder außschließlich relative Links
(<em>z.B.</em> "<code>file.html</code>" oder
"<code>../icons/image.gif</code>") zu verwenden oder Links, die das
einleitende <code>/domain/</code> enthalten (<em>z.B.</em>,
"<code>http://www.domain.tld/domain/misc/file.html</code>" oder
"<code>/domain/misc/file.html</code>").</p>
<p>Dies erfordert etwas Disziplin, die Befolgung dieser Richtlinien stellt
jedoch größtenteils sicher, dass Ihre Seiten mit allen Browsern
funktionieren, alten wie neuen.</p>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="../de/vhosts/name-based.html" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Kommentare</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/name-based.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Module</a> | <a href="../mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossar</a> | <a href="../sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/examples.html.ko.euc-kr 0000664 0001751 0001751 00000062216 14743132254 022672 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ȣƮ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">ȣƮ</a></div><div id="page-content"><div id="preamble"><h1>ȣƮ </h1>
<div class="toplang">
<p><span> : </span><a href="../en/vhosts/examples.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/examples.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/examples.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/examples.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ǵǴ ȣƮ
Ϸ . Ȳ <a href="name-based.html"≯</a>̳ <a href="ip-based.html">IP</a> ȣƮ
Ʈ Ϸ ̴. Ͻ ڿ
Ͽ Ʈ ϴ 츦 ٷ
̴.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#purename">IP ּ Ѱ ̸
Ʈ ϱ.</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#twoips"> IP ּҿ ̸
ȣƮ.</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#intraextra">(ο ܺ ּҿ )
ٸ IP ּҷ ϱ.</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#port"> Ʈ ٸ Ʈ
ϱ.</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ip">IP ȣƮ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ipport">Ʈݰ ip ȥյ
ȣƮ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mixed"≯ݰ IP ȥյ
ȣƮ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#default"><code>_default_</code> ȣƮ
ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#migrate"≯ ȣƮ IP
ȣƮ ű</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#serverpath"><code>ServerPath</code>
þ ϱ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="purename" id="purename">IP ּ Ѱ ̸
Ʈ ϱ.</a></h2>
<p> IP ּҰ Ѱ ְ, DNS ּ(CNAMES)
ǻ Ų. ǻͿ <code>www.example.com</code>
<code>www.example.org</code> ϰ ʹ.</p>
<div class="note"><h3>Note</h3><p>ġ ȣƮ
Ѵٰ ȣƮ DNS ڵ̷
ʴ´. <em>ݵ</em> DNS IP ּҸ Ű
̸ ־ Ѵ. ȱ ƹ Ʈ
. ˻غ <code>hosts</code> Ͽ
߰ , ̴ hosts ǻͿ
ݿȴ.</p>
</div>
<div class="example"><h3> </h3><p><code>
# ġ Ʈ 80 ٸ<br />
Listen 80<br />
<br />
# IP ּҿ ȣƮ û ٸ<br />
NameVirtualHost *:80<br />
<br />
<VirtualHost *:80><br />
<span class="indent">
DocumentRoot /www/example1<br />
ServerName www.example.com<br />
<br />
# ٸ þ鵵 ִ<br />
<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost *:80><br />
<span class="indent">
DocumentRoot /www/example2<br />
ServerName www.example.org<br />
<br />
# ٸ þ鵵 ִ<br />
<br />
</span>
</VirtualHost>
</code></p></div>
<p>ǥ ּҸ ŰǷ, ּ û
ʴ´. <code>www.example.com</code>
Ͽ ó Ƿ 켱 ,
<cite>⺻</cite>Ȥ <cite>ʱ</cite> ȴ.
<code>ServerName</code> þ شʴ û
ù° <code>VirtualHost</code> Ѵ.</p>
<div class="note">
<h3></h3>
<p>Ѵٸ <code>*</code> ý IP
ּҸ ִ.
<code>VirtualHost</code> ƱԸƮ
<code>NameVirtualHost</code> ƱԸƮ ġؾ
<em>Ѵ</em>:</p>
<div class="example"><p><code>
NameVirtualHost 172.20.30.40<br />
<br />
<VirtualHost 172.20.30.40><br />
# ...
</code></p></div>
<p> ISP IP ּҸ
IP ּҸ 쿡 <code>*</code> ϴ
ϴ. <code>*</code> IP ּҿ
شϹǷ, IP ּҰ Ǿ
ʿ䰡 .</p>
</div>
<p> κ ̸ ȣƮ .
ܴ ٸ IP ּҳ Ʈ ٸ Ϸ
̴.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="twoips" id="twoips"> IP ּҿ ̸
ȣƮ.</a></h2>
<div class="note">
<h3></h3><p>⼭ IP ּҰ
밡ϴ.</p>
</div>
<p> IP ּҰ ΰִ. ϳ
(<code>172.20.30.40</code>) ""
<code>server.domain.com</code> ϰ, ٸ ϳ
(<code>172.20.30.50</code>) ȣƮ
̴.</p>
<div class="example"><h3> </h3><p><code>
Listen 80<br />
<br />
# 172.20.30.40 ϴ ""̴<br />
ServerName server.domain.com<br />
DocumentRoot /www/mainserver<br />
<br />
# ٸ ּҴ<br />
NameVirtualHost 172.20.30.50<br />
<br />
<VirtualHost 172.20.30.50><br />
<span class="indent">
DocumentRoot /www/example1<br />
ServerName www.example.com<br />
<br />
# ٸ þ鵵 ִ ...<br />
<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.50><br />
<span class="indent">
DocumentRoot /www/example2<br />
ServerName www.example.org<br />
<br />
# ٸ þ鵵 ִ ...<br />
<br />
</span>
</VirtualHost>
</code></p></div>
<p><code>172.20.30.50</code> ƴ ּҿ û
ּ Ѵ. ȣƮ , <code>Host:</code>
<code>172.20.30.50</code> ûϸ
<code>www.example.com</code> Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="intraextra" id="intraextra">(ο ܺ ּҿ )
ٸ IP ּҷ ϱ.</a></h2>
<p> ǻͿ IP ּҰ ΰ (<code>192.168.1.1</code>
<code>172.20.30.40</code>) ִ. ǻʹ (Ʈ)
Ʈ ܺ (ͳ) Ʈ ̿ ġѴ. Ʈ ۿ
<code>server.example.com</code> ܺ ּҸ
(<code>172.20.30.40</code>) ǹϰ, Ʈ ο
̸ ּҷ (<code>192.168.1.1</code>) Ѵ.</p>
<p> <code>VirtualHost</code> Ѱ ο ܺ
信 ִ.</p>
<div class="example"><h3> </h3><p><code>
NameVirtualHost 192.168.1.1<br />
NameVirtualHost 172.20.30.40<br />
<br />
<VirtualHost 192.168.1.1 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/server1<br />
ServerName server.example.com<br />
ServerAlias server<br />
</span>
</VirtualHost>
</code></p></div>
<p> Ʈ û
<code>VirtualHost</code> Ѵ.</p>
<div class="note">
<h3>:</h3><p> Ʈ ȣƮ
<code>server.example.com</code> ̸
<code>server</code> ϴ.</p>
<p> IP ּ <code>*</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="port" id="port"> Ʈ ٸ Ʈ
ϱ.</a></h2>
<p> IP Ʈ ٸ Ѵٰ
. ̴ "NameVirtualHost" ± Ʈ ϸ
ϴ. NameVirtualHost name:port <VirtualHost
name:port> Ȥ Listen þ ϸ ȵȴ.</p>
<div class="example"><h3> </h3><p><code>
Listen 80<br />
Listen 8080<br />
<br />
NameVirtualHost 172.20.30.40:80<br />
NameVirtualHost 172.20.30.40:8080<br />
<br />
<VirtualHost 172.20.30.40:80><br />
<span class="indent">
ServerName www.example.com<br />
DocumentRoot /www/domain-80<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40:8080><br />
<span class="indent">
ServerName www.example.com<br />
DocumentRoot /www/domain-8080<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40:80><br />
<span class="indent">
ServerName www.example.org<br />
DocumentRoot /www/otherdomain-80<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40:8080><br />
<span class="indent">
ServerName www.example.org<br />
DocumentRoot /www/otherdomain-8080<br />
</span>
</VirtualHost>
</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="ip" id="ip">IP ȣƮ</a></h2>
<p> <code>www.example.com</code>
<code>www.example.org</code> شϴ IP ּҸ
(<code>172.20.30.40</code> <code>172.20.30.50</code>)
.</p>
<div class="example"><h3> </h3><p><code>
Listen 80<br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/example1<br />
ServerName www.example.com<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.50><br />
<span class="indent">
DocumentRoot /www/example2<br />
ServerName www.example.org<br />
</span>
</VirtualHost>
</code></p></div>
<p><code><VirtualHost></code> þ ּҿ
شʴ ּҷ ( , <code>localhost</code>)
û ּ ִ ּ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ipport" id="ipport">Ʈݰ ip ȥյ
ȣƮ</a></h2>
<p> <code>www.example.com</code>
<code>www.example.org</code> شϴ IP ּҸ
(<code>172.20.30.40</code> <code>172.20.30.50</code>)
. IP 80 8080 Ʈ ȣƮ .</p>
<div class="example"><h3> </h3><p><code>
Listen 172.20.30.40:80<br />
Listen 172.20.30.40:8080<br />
Listen 172.20.30.50:80<br />
Listen 172.20.30.50:8080<br />
<br />
<VirtualHost 172.20.30.40:80><br />
<span class="indent">
DocumentRoot /www/example1-80<br />
ServerName www.example.com<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40:8080><br />
<span class="indent">
DocumentRoot /www/example1-8080<br />
ServerName www.example.com<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.50:80><br />
<span class="indent">
DocumentRoot /www/example2-80<br />
ServerName www.example.org<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.50:8080><br />
<span class="indent">
DocumentRoot /www/example2-8080<br />
ServerName www.example.org<br />
</span>
</VirtualHost>
</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="mixed" id="mixed"≯ݰ IP ȥյ
ȣƮ</a></h2>
<p>ּ ̸ ȣƮ, ٸ IP
ȣƮ ϰ ʹ.</p>
<div class="example"><h3> </h3><p><code>
Listen 80<br />
<br />
NameVirtualHost 172.20.30.40<br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/example1<br />
ServerName www.example.com<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/example2<br />
ServerName www.example.org<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/example3<br />
ServerName www.example3.net<br />
</span>
</VirtualHost><br />
<br />
# IP-<br />
<VirtualHost 172.20.30.50><br />
<span class="indent">
DocumentRoot /www/example4<br />
ServerName www.example4.edu<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.60><br />
<span class="indent">
DocumentRoot /www/example5<br />
ServerName www.example5.gov<br />
</span>
</VirtualHost>
</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="default" id="default"><code>_default_</code> ȣƮ
ϱ</a></h2>
<h3><a name="defaultallports" id="defaultallports"> Ʈ
<code>_default_</code> ȣƮ</a></h3>
<p> ȣƮ ش IP ּҿ Ʈ
<em></em> û óϱ.</p>
<div class="example"><h3> </h3><p><code>
<VirtualHost _default_:*><br />
<span class="indent">
DocumentRoot /www/default<br />
</span>
</VirtualHost>
</code></p></div>
<p>default(⺻) ȣƮ Ʈ ϵī带 Ͽ û
ּ .</p>
<p>default ȣƮ ̸ ȣƮ ϴ
ּ/Ʈ û ʴ´. ų
<code>Host:</code> û ̸
ȣƮ(Ͽ
ּ/Ʈ ó ȣƮ) Ѵ.</p>
<p><code class="directive"><a href="../mod/mod_alias.html#aliasmatch">AliasMatch</a></code>
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
Ͽ û Ư (Ȥ ũƮ)
ۼ(rewrite) ִ.</p>
<h3><a name="defaultdifferentports" id="defaultdifferentports"> Ʈ
<code>_default_</code> ȣƮ</a></h3>
<p> , Ʈ ٸ 80
Ʈ ؼ ߰ <code>_default_</code> ȣƮ
ϰ ʹ.</p>
<div class="example"><h3> </h3><p><code>
<VirtualHost _default_:80><br />
<span class="indent">
DocumentRoot /www/default80<br />
# ...<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost _default_:*><br />
<span class="indent">
DocumentRoot /www/default<br />
# ...<br />
</span>
</VirtualHost>
</code></p></div>
<p>80 Ʈ default ȣƮ (<em>ݵ</em>
ϵī Ʈ ⺻ ȣƮ ; Ѵ)
IP ּҷ û Ѵ.
ּ û Ѵ.</p>
<h3><a name="defaultoneport" id="defaultoneport"> Ʈ
<code>_default_</code> ȣƮ</a></h3>
<p>80 Ʈ ؼ default ȣƮ ʹ.</p>
<div class="example"><h3> </h3><p><code>
<VirtualHost _default_:80><br />
DocumentRoot /www/default<br />
...<br />
</VirtualHost>
</code></p></div>
<p>Ʈ 80 ּҿ û ⺻
ȣƮ ϰ, ٸ ּҿ Ʈ
û Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="migrate" id="migrate"≯ ȣƮ IP
ȣƮ ű</a></h2>
<p>(<a href="#name"≯</a> ù° ) ȣƮ
<code>www.example.org</code> ̸ ȣƮ
ڽ IP ּҸ Ѵ. ̸ ȣƮ
IP ּҸ ijϴ Ӽ Ͻÿ ϱ
ű θ ϰ ʹ.</p>
<p>
<code>VirtualHost</code> þ IP ּҸ
(<code>172.20.30.50</code>) ߰ϸǹǷ .</p>
<div class="example"><h3> </h3><p><code>
Listen 80<br />
ServerName www.example.com<br />
DocumentRoot /www/example1<br />
<br />
NameVirtualHost 172.20.30.40<br />
<br />
<VirtualHost 172.20.30.40 172.20.30.50><br />
<span class="indent">
DocumentRoot /www/example2<br />
ServerName www.example.org<br />
# ...<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/example3<br />
ServerName www.example.net<br />
ServerAlias *.example.net<br />
# ...<br />
</span>
</VirtualHost>
</code></p></div>
<p> (IP ȣƮ ) ο ּҿ (̸
ȣƮ ) ּ ȣƮ
ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="serverpath" id="serverpath"><code>ServerPath</code>
þ ϱ</a></h2>
<p> ̸ ȣƮ ִ. ùٸ
ȣƮ ϱ Ŭ̾Ʈ ùٸ
<code>Host:</code> Ѵ. HTTP/1.0
Ŭ̾Ʈ ϸ ġ Ŭ̾Ʈ
ȣƮ ϴ (
ȣƮ û Ѵ). ȣȯ
ϱ ȣƮ , ̸
ȣƮ URL λ縦 ϴ ũ
д.</p>
<div class="example"><h3> </h3><p><code>
NameVirtualHost 172.20.30.40<br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
# primary vhost<br />
DocumentRoot /www/subdomain<br />
RewriteEngine On<br />
RewriteRule ^/.* /www/subdomain/index.html<br />
# ...<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40><br />
DocumentRoot /www/subdomain/sub1<br />
<span class="indent">
ServerName www.sub1.domain.tld<br />
ServerPath /sub1/<br />
RewriteEngine On<br />
RewriteRule ^(/sub1/.*) /www/subdomain$1<br />
# ...<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/subdomain/sub2<br />
ServerName www.sub2.domain.tld<br />
ServerPath /sub2/<br />
RewriteEngine On<br />
RewriteRule ^(/sub2/.*) /www/subdomain$1<br />
# ...<br />
</span>
</VirtualHost>
</code></p></div>
<p><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code> þ
URL <code>http://www.sub1.domain.tld/sub1/</code>
û <em></em> subl-ȣƮ Ѵ.<br />
Ŭ̾Ʈ ùٸ <code>Host:</code> ٸ,
URL <code>http://www.sub1.domain.tld/</code> û
subl-ȣƮ Ѵ. <code>Host:</code>
Ŭ̾Ʈ ȣƮ ִ
Եȴ.</p>
<p> ϶: Ŭ̾Ʈ
<code>Host:</code>
<code>http://www.sub2.domain.tld/sub1/</code> û
subl-ȣƮ Ѵ.</p>
<p><code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
þ Ͽ ùٸ <code>Host:</code>
Ŭ̾Ʈ (<em> </em>, URL ġ簡 ְų )
URL ִ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/vhosts/examples.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/examples.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/examples.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/examples.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/examples.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/fd-limits.html.tr.utf8 0000664 0001751 0001751 00000022511 14743132254 022452 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Dosya Tanıtıcı Sınırları - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Sanal Konaklar</a></div><div id="page-content"><div id="preamble"><h1>Dosya Tanıtıcı Sınırları</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/vhosts/fd-limits.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/fd-limits.html" title="Türkçe"> tr </a></p>
</div>
<p>Çok büyük sayıda sanal konak kullanıyorsanız ve bunların her biri için
ayrı günlük kayıtları tutuyorsanız, Apache dosya tanıtıcılarını
tüketebilir. Apache tarafından, dahili olarak 10-20 dosya tanıtıcıya ek
olarak her hata günlüğü için bir ve her diğer günlük kaydı için bir dosya
tanıcı kullanılır. Unix işletim sisteminde dosya tanıtıcıların sayısı
süreç başına 64 taneyle sınırlıdır ve gerekirse donanıma bağlı olarak
arttırılabilir.</p>
<p>Apache gerektiğinde bu sınırı kendisi arttırmaya çalışırsa da bu her
zaman mümkün olmaz. Şöyle ki:</p>
<ol>
<li>Sisteminiz <code>setrlimit()</code> sistem çağrısını
sağlamıyordur.</li>
<li>Sisteminizde <code>setrlimit(RLIMIT_NOFILE)</code> çağrısı hiçbir işe
yaramıyordur (örneğin, Solaris 2.3).</li>
<li>Dosya tanıtıcılarının sayısı donanıma bağlı olarak daha fazla
arttırılamıyordur.</li>
<li>Sisteminiz dosya tanıtıcı sayısını başka sınırlara bağlı kılmıştır:
örneğin stdio akımları ile ilgili sınır, dosya tanıtıcı sayısının
256’nın altında ollmasını gerektiriyordur (Solaris 2).</li>
</ol>
<p>Böyle sorunlar karşısında yapabilecekleriniz:</p>
<ul><li>Ana günlük dosyaları hariç, <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> bölümlerinde günlük dosyası
belirtmeyerek günlük dosyası sayısını düşürürsünüz. (Bunun nasıl
yapılacağını öğrenmek için <a href="#splitlogs">Günlük kayıtlarının
ayrıştırılması</a> bölümüne bakınız.)</li>
<li>Sisteminizde serbest dosya tanıtıcı sayısı 1-2 civarına düşerse
Apache’yi aşağıdaki gibi bir betikle yeniden çalıştırarak dosya
tanıtıcı sayısını arttırabilirsiniz:
<div class="example"><p><code>
<code>#!/bin/sh<br />
ulimit -S -n 100<br />
exec httpd</code>
</code></p></div>
</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="splitlogs" id="splitlogs">Günlük kayıtlarının ayrıştırılması</a></h2>
<p>Günlük dosyalarını çok sayıda sanal konak için ortak olarak
kullanıyorsanız, sanal konaklar için istatistiksel çözümlemeler yapmak
amacıyla sırası geldiğinde bunları ayrıştırabilirsiniz. Bu işlem aşağıda
anlatıldığı gibi yapılabilir.</p>
<p>İlk iş olarak, sanal konak bilgilerini günlük girdilerine eklemeniz
gerekir. Bu işlem, <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> yönergesi ve
<code>%v</code> biçem değişkeni ile yapılabilir. Günlük girdisi biçem
dizgesinin başına bunu ekleyiniz:</p>
<pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost
CustomLog logs/multiple_vhost_log vhost</pre>
<p>Bu yapılandırma ile her günlük kaydının başında sanal konağın
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> yönergesine belirtilen
ismi eklenir. (Günlük dosyalarınızın kişiselleştirilmesi ile ilgili daha
fazla bilgi için <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> belgesine bakınız.)</p>
<p>Günlük dosyanızdaki kayıtları bileşenlere göre gruplamak isterseniz
<code><a href="../programs/other.html">split-logfile</a></code>
programını kullanabilirsiniz. Bu programı Apache dağıtımının
<code>support</code> dizininde bulabilirsiniz.</p>
<p>Programı aşağıdaki gibi çalıştırın:</p>
<div class="example"><p><code>
split-logfile < /logs/multiple_vhost_log
</code></p></div>
<p>Bu programı sanal konaklar için tuttuğunuz günlük dosyasının ismini
argüman olarak belirterek çalıştırdığınızda o dosyadaki kayıtlardan her
sanal konak için ayrı bir günlük dosyası
(<code><em>konakadı</em>.log</code>) üretilir.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/vhosts/fd-limits.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/fd-limits.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/fd-limits.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/index.html.zh-cn.utf8 0000664 0001751 0001751 00000016750 14743132254 022273 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache 虚拟主机文档 - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">模块</a> | <a href="../mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Apache 虚拟主机文档</h1>
<div class="toplang">
<p><span>可用语言: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">此翻译可能过期。要了解最近的更改，请阅读英文版。</div>
<p>术语<cite>虚拟主机</cite>指的是在单一机器上运行多个网站
(例如 <code>company1.example.com</code> 和
<code>company2.example.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 中支持虚拟主机的所有详细信息的文档页面列表。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#support">虚拟主机支持</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#directives">配置指令</a></li>
</ul><h3>参见</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li><li><a href="name-based.html">基于名称的虚拟主机</a></li><li><a href="ip-based.html">基于 IP 的虚拟主机</a></li><li><a href="examples.html">虚拟主机样例</a></li><li><a href="fd-limits.html">文件句柄限制</a></li><li><a href="mass.html">动态配置的大规模虚拟主机</a></li><li><a href="details.html">虚拟主机匹配的深入讨论</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="support" id="support">虚拟主机支持</a></h2>
<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>日志文件太多</em>)</li>
<li><a href="mass.html">动态配置的大规模虚拟主机</a></li>
<li><a href="details.html">虚拟主机匹配的深入讨论</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="directives" id="directives">配置指令</a></h2>
<ul>
<li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li>
<li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li>
</ul>
<p>如果你要调试虚拟主机配置，你会发现 Apache 的命令行参数 <code>-S</code>
非常有用。即输入以下命令:</p>
<div class="example"><p><code>
/usr/local/apache2/bin/httpd -S
</code></p></div>
<p>这个命令将会显示 Apache 是如何解析配置文件的。仔细检查 IP
地址与服务器名称可能会帮助你发现配置错误
(参见 <code class="program"><a href="../programs/httpd.html">httpd</a></code> 程序文档，以便了解其它命令行选项)。</p>
</div></div>
<div class="bottomlang">
<p><span>可用语言: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/mass.html.ko.euc-kr 0000664 0001751 0001751 00000051145 14743132254 022016 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>뷮 ȣƮ ϱ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">ȣƮ</a></div><div id="page-content"><div id="preamble"><h1>뷮 ȣƮ ϱ</h1>
<div class="toplang">
<p><span> : </span><a href="../en/vhosts/mass.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/mass.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/mass.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/mass.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ġ 1.3 뷮 ȣƮ ȿ
ϴ Ѵ.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#motivation"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#overview"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#simple"> ȣƮ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#homepages"> ȣƮϴ Ȩ ý</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#combinations"> ȣƮ
ý ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ipbased"> ȿ IP ȣƮ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#oldversion">ġ ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#simple.rewrite"><code>mod_rewrite</code>
ȣƮ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#homepages.rewrite"><code>mod_rewrite</code>
Ȩ ý</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#xtra-conf"> ȣƮ
ϱ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="motivation" id="motivation"></a></h2>
<p> <code>httpd.conf</code>
<code><VirtualHost></code> ǵ ִٸ ⼭
ϴ ̴:</p>
<div class="example"><p><code>
NameVirtualHost 111.22.33.44<br />
<VirtualHost 111.22.33.44><br />
<span class="indent">
ServerName www.customer-1.com<br />
DocumentRoot /www/hosts/www.customer-1.com/docs<br />
ScriptAlias /cgi-bin/ /www/hosts/www.customer-1.com/cgi-bin<br />
</span>
</VirtualHost><br />
<VirtualHost 111.22.33.44><br />
<span class="indent">
ServerName www.customer-2.com<br />
DocumentRoot /www/hosts/www.customer-2.com/docs<br />
ScriptAlias /cgi-bin/ /www/hosts/www.customer-2.com/cgi-bin<br />
</span>
</VirtualHost><br />
# ٺ ٺ ٺ<br />
<VirtualHost 111.22.33.44><br />
<span class="indent">
ServerName www.customer-N.com<br />
DocumentRoot /www/hosts/www.customer-N.com/docs<br />
ScriptAlias /cgi-bin/ /www/hosts/www.customer-N.com/cgi-bin<br />
</span>
</VirtualHost>
</code></p></div>
<p>⺻ <code><VirtualHost></code>
θ óϵ üϴ ̴.
ִ:</p>
<ol>
<li> ۾ ġ ϰ
Ѵ.</li>
<li>ȣƮ ߰ϱ Ͻýۿ
丮 DNS ߰ϱ⸸ ϸȴ. ,
ġ 缳ϰ ʿ䰡 .</li>
</ol>
<p> ȣƮ ٸ α ٴ
̴. ſ ȣƮ Ѵٸ ϱڸ
ٸ α .
fifo α , α óϿ
( ִ) .</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="overview" id="overview"></a></h2>
<p>ȣƮ IP ּҿ HTTP û <code>Host:</code>
Ѵ. ⺻ 뷮
ȣƮ ڵ ȣƮ û
ϰο Ѵ. ̴ κ <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>
Ͽ ذ , ġ 1.3.6 ϸ Ѵٸ
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ؾ Ѵ.
⺻ Ե ʴ´. Ϸ
ġ ϰ Ҷ ؾ Ѵ.</p>
<p> ȣƮ Ϲ ȣƮó ̰Ϸ
`ӿ' Ѵ. ߿ ġ ڱ
URL 鶧 ̴.
<code>ServerName</code> þ ϸ, CGI
<code>SERVER_NAME</code> ȯ溯 ־.
<code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> ȴ.
<code>UseCanonicalName Off</code≯ û <code>Host:</code>
ȴ. <code>UseCanonicalName DNS</code≯
ȣƮ IP ּҸ DNS ˻Ͽ ˾Ƴ.
ڴ ̸ ȣƮ ϰ, ڴ IP
ȣƮ Ѵ. <code>Host:</code> ų
DNS ˻ Ͽ ġ ˾Ƴ ϸ
<code>ServerName</code> Ѵ.</p>
<p>ٸ `' (<code>DocumentRoot</code> ϸ,
CGI <code>DOCUMENT_ROOT</code> ȯ溯 ־)
Ʈ̴. Ϲ core Ͽ
URI شϴ ϸ ã, ȣ Ҷ ٸ
(<code>mod_vhost_alias</code> <code>mod_rewrite</code>)
ٸ ̷ ۾ Ѵ.
<code>DOCUMENT_ROOT</code> ȯ溯 Ƿ
CGI SSI Ѵٸ ߸
ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="simple" id="simple"> ȣƮ</a></h2>
<p> <a href="#motivation"></a> ȣƮ
<code>mod_vhost_alias</code> Ͽ Ϲ
ߴ.</p>
<div class="example"><p><code>
# Host: ˾Ƴ<br />
UseCanonicalName Off<br />
<br />
# ù° ʵ带 Ͽ α ȣƮ ִ<br />
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon<br />
CustomLog logs/access_log vcommon<br />
<br />
# û óϱ ϸ Ѵ<br />
VirtualDocumentRoot /www/hosts/%0/docs<br />
VirtualScriptAlias /www/hosts/%0/cgi-bin
</code></p></div>
<p> <code>UseCanonicalName Off</code>
<code>UseCanonicalName DNS</code> ϱ⸸ ϸ IP
ȣƮ ȴ. ȣƮ IP ּҸ
ϸ ߰ ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="homepages" id="homepages"> ȣƮϴ Ȩ ý</a></h2>
<p>ISP Ȩ ߴ.
ϸ <code>www.user.isp.com</code>
<code>/home/user/</code> δ Ϻθ
ϸ ִ.
<code>cgi-bin</code> ȣƮ ʰ
ȣƮ Ѵ.</p>
<div class="example"><p><code>
# ⺻ . <br />
<br />
# ϸ Ϻθ Ѵ<br />
VirtualDocumentRoot /www/hosts/%2/docs<br />
<br />
# ϳ cgi-bin 丮<br />
ScriptAlias /cgi-bin/ /www/std-cgi/<br />
</code></p></div>
<p><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>
<code>VirtualDocumentRoot</code> ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="combinations" id="combinations"> ȣƮ
ý ϱ</a></h2>
<p> ġ Ϲ
<code><VirtualHost></code> þ Ͽ
ȣƮ ִ. ,
Ȩ IP ּ Ѱ,
ٸ IP ּ Ѱ οѴ. ó
<code><VirtualHost></code> ǿ
ִ.</p>
<div class="example"><p><code>
UseCanonicalName Off<br />
<br />
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon<br />
<br />
<Directory /www/commercial><br />
<span class="indent">
Options FollowSymLinks<br />
AllowOverride All<br />
</span>
</Directory><br />
<br />
<Directory /www/homepages><br />
<span class="indent">
Options FollowSymLinks<br />
AllowOverride None<br />
</span>
</Directory><br />
<br />
<VirtualHost 111.22.33.44><br />
<span class="indent">
ServerName www.commercial.isp.com<br />
<br />
CustomLog logs/access_log.commercial vcommon<br />
<br />
VirtualDocumentRoot /www/commercial/%0/docs<br />
VirtualScriptAlias /www/commercial/%0/cgi-bin<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 111.22.33.45><br />
<span class="indent">
ServerName www.homepages.isp.com<br />
<br />
CustomLog logs/access_log.homepages vcommon<br />
<br />
VirtualDocumentRoot /www/homepages/%0/docs<br />
ScriptAlias /cgi-bin/ /www/std-cgi/<br />
</span>
</VirtualHost>
</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="ipbased" id="ipbased"> ȿ IP ȣƮ</a></h2>
<p><a href="#simple">ù° </a>
IP ȣƮ ٲ ִٰ ߴ.
û DNS ãƾϹǷ ſ ȿ̴.
̸ IP ּҷ Ͻý ϰ
α ϸ ذ ִ. ġ
ٷ ʿ䰡 , DNS ˻ ʰ ȴ.</p>
<div class="example"><p><code>
# IP ּҸ DNS ˻Ͽ ˾Ƴ<br />
UseCanonicalName DNS<br />
<br />
# α ֵ IP ּҸ Ѵ<br />
LogFormat "%A %h %l %u %t \"%r\" %s %b" vcommon<br />
CustomLog logs/access_log vcommon<br />
<br />
# ϸ IP ּҸ Ѵ<br />
VirtualDocumentRootIP /www/hosts/%0/docs<br />
VirtualScriptAliasIP /www/hosts/%0/cgi-bin<br />
</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="oldversion" id="oldversion">ġ ϱ</a></h2>
<p> ġ 1.3.6 Ŀ Ե
<code>mod_vhost_alias</code> Ѵ.
<code>mod_vhost_alias</code> ġ Ѵٸ
̹ ߵ <code>mod_rewrite</code> Ͽ,
Host:- ȣƮ, ִ.</p>
<p> α Ͽ ִ. ġ 1.3.6
α þ <code>%V</code> ԵǾ, 1.3.0
- 1.3.3 <code>%v</code> ɼ ߴ.
1.3.4 ̷ . ġ
<code>.htaccess</code> Ͽ <code>UseCanonicalName</code>
þ Ƿ α ̻ ϵ ִ.
Ƿ <code>%{Host}i</code> þ
Ͽ <code>Host:</code> α ̴.
, <code>%V</code> ʴ <code>:port</code>
ڿ ߰ ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="simple.rewrite" id="simple.rewrite"><code>mod_rewrite</code>
ȣƮ</a></h2>
<p> <a href="#simple">ù° </a> ϴ
<code>httpd.conf</code> ̴. ó ù°
, ȣȯ <code>mod_rewrite</code>
Ǿ. ۾
ϴ <code>mod_rewrite</code> Ѵ.</p>
<p>Ư ؾ ִ. ⺻
<code>mod_rewrite</code> (<code>mod_alias</code> ) ٸ
URI ȴ. ٸ URI
Ͽ <code>mod_rewrite</code> ؾ Ѵ.
, ȣƮ <code>ScriptAlias</code>
ؼ Ư ۾ ʿϴ.</p>
<div class="example"><p><code>
# Host: ´<br />
UseCanonicalName Off<br />
<br />
# splittable logs<br />
LogFormat "%{Host}i %h %l %u %t \"%r\" %s %b" vcommon<br />
CustomLog logs/access_log vcommon<br />
<br />
<Directory /www/hosts><br />
<span class="indent">
# ScriptAlias CGI <br />
# ExecCGI Ѵ<br />
Options FollowSymLinks ExecCGI<br />
</span>
</Directory><br />
<br />
# κ̴<br />
<br />
RewriteEngine On<br />
<br />
# Host: ҹڰ ڼ ִ<br />
RewriteMap lowercase int:tolower<br />
<br />
## Ϲ óѴ:<br />
# Alias /icons/ ϵ - ٸ alias ؼ ݺ<br />
RewriteCond %{REQUEST_URI} !^/icons/<br />
# CGI ϵ<br />
RewriteCond %{REQUEST_URI} !^/cgi-bin/<br />
# Ư ۾<br />
RewriteRule ^/(.*)$ /www/hosts/${lowercase:%{SERVER_NAME}}/docs/$1<br />
<br />
## CGI óѴ - MIME type ؾ Ѵ<br />
RewriteCond %{REQUEST_URI} ^/cgi-bin/<br />
RewriteRule ^/(.*)$ /www/hosts/${lowercase:%{SERVER_NAME}}/cgi-bin/$1 [T=application/x-httpd-cgi]<br />
<br />
# !
</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="homepages.rewrite" id="homepages.rewrite"><code>mod_rewrite</code>
Ȩ ý</a></h2>
<p> <a href="#homepages">ι° </a>
Ѵ.</p>
<div class="example"><p><code>
RewriteEngine on<br />
<br />
RewriteMap lowercase int:tolower<br />
<br />
# CGI ϵ<br />
RewriteCond %{REQUEST_URI} !^/cgi-bin/<br />
<br />
# RewriteRule ϵ ȣƮ ùٸ ˻Ѵ<br />
RewriteCond ${lowercase:%{SERVER_NAME}} ^www\.[a-z-]+\.isp\.com$<br />
<br />
# ȣƮ URI տ δ<br />
# [C] ۼ Ѵ<br />
RewriteRule ^(.+) ${lowercase:%{SERVER_NAME}}$1 [C]<br />
<br />
# ϸ <br />
RewriteRule ^www\.([a-z-]+)\.isp\.com/(.*) /home/$1/$2<br />
<br />
# ü CGI 丮 Ѵ<br />
ScriptAlias /cgi-bin/ /www/std-cgi/
</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="xtra-conf" id="xtra-conf"> ȣƮ
ϱ</a></h2>
<p> <code>mod_rewrite</code> Ͽ
ȣƮ Ʈ ˾Ƴ.
ʿϴ.</p>
<p><code>vhost.map</code> :</p>
<div class="example"><p><code>
www.customer-1.com /www/customers/1<br />
www.customer-2.com /www/customers/2<br />
# ...<br />
www.customer-N.com /www/customers/N<br />
</code></p></div>
<p><code>http.conf</code> :</p>
<div class="example"><p><code>
RewriteEngine on<br />
<br />
RewriteMap lowercase int:tolower<br />
<br />
# Ѵ<br />
RewriteMap vhost txt:/www/conf/vhost.map<br />
<br />
# alias óѴ<br />
RewriteCond %{REQUEST_URI} !^/icons/<br />
RewriteCond %{REQUEST_URI} !^/cgi-bin/<br />
RewriteCond ${lowercase:%{SERVER_NAME}} ^(.+)$<br />
# ã´<br />
RewriteCond ${vhost:%1} ^(/.*)$<br />
RewriteRule ^/(.*)$ %1/docs/$1<br />
<br />
RewriteCond %{REQUEST_URI} ^/cgi-bin/<br />
RewriteCond ${lowercase:%{SERVER_NAME}} ^(.+)$<br />
RewriteCond ${vhost:%1} ^(/.*)$<br />
RewriteRule ^/(.*)$ %1/cgi-bin/$1
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/vhosts/mass.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/mass.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/mass.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/mass.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/mass.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/name-based.html.tr.utf8 0000664 0001751 0001751 00000043103 14743132254 022556 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>İsme Dayalı Sanal Konaklar - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Sanal Konaklar</a></div><div id="page-content"><div id="preamble"><h1>İsme Dayalı Sanal Konaklar</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belgede isme dayalı sanal konakların ne zaman, nasıl kullanılacakları
açıklanmıştır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#namevip">İsme dayalı ve IP’ye dayalı Sanal Konaklar</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#alg">Sunucu isme dayalı sanal konaklardan uygun olanını nasıl seçer</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#using">İsme Dayalı Sanal Konakların Kullanımı</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="ip-based.html">IP Adresine Dayalı Sanal Konaklar</a></li><li><a href="details.html">Konak Eşlemenin Derinliğine İncelenmesi</a>
</li><li><a href="mass.html">Devingen olarak Yapılandırılan Kütlesel Sanal
Barındırma</a></li><li><a href="examples.html">Çok kullanılan sanal konak yapılandırma
örnekleri</a></li><li><a href="#comments_section">Yorumlar</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="namevip" id="namevip">İsme dayalı ve IP’ye dayalı Sanal Konaklar</a></h2>
<p><a href="ip-based.html">IP’ye dayalı sanal konaklar</a>da sunulacak
sanal konağı doğru tespit edebilmek için bağlantının yapıldığı IP
adresine bakılır. Bu bakımdan her konak için ayrı bir IP adresine
gereksinim vardır.</p>
<p>İsme dayalı sanal konaklarda ise sunucu, istemcinin HTTP başlığının bir
parçası olarak gönderdiği konak adını kullanır. Bu teknikte aynı IP
adresini çok sayıda farklı konak kullanabilir.</p>
<p>İsme dayalı sanal barındırma nispeten daha kolaydır, çünkü her konak
ismini doğru IP adresiyle eşlemek için DNS sunucunuzu yapılandırdıktan
sonra Apache HTTP sunucusunu farklı konak isimlerini tanıyacak şekilde
yapılandırmanız yeterli olur. İsme dayalı sanal barındırma ayrıca zaten
kıt olan IP adreslerine talebi de azaltır. Bu nedenle, IP’ye dayalı sanal
konakları kullanmanızı gerektiren donanım kullanmadıkça isme dayalı
sanal konaklar kullanmalısınız. İstemci uyumuna bağlı IP’ye dayalı
sanal barındırma için eskiden varolan sebepler genel amaçlı bir HTTP
sunucusu için artık uygulanabilir değildir.</p>
<p>İsme dayalı sanal barındırma, IP'ye dayalı sanal barındırma seçim
algoritmasını kullanmaz, yani uygun sunucu ismini arama işlemi sadece en
iyi IP'ye dayalı adrese sahip sanal konaklar arasında gerçekleşir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="alg" id="alg">Sunucu isme dayalı sanal konaklardan uygun olanını nasıl seçer</a></h2>
<p>İsme dayalı sanal konak çözümlemesinin ilk adımının IP'ye dayalı
çözümleme olduğunun anlaşılması çok önemlidir. İsme dayalı sanal konak
çözümlemesi en uygun isme dayalı sanal konağı seçerken önce en iyi IP'ye
dayalı eşleşme adaylarının sayısını azaltır, sonra bunlar arasından en
uygununu seçer. Tüm <code>VirtualHost</code> yönergelerinde IP adresi
yerine joker kullanımı bu IP'ye dayalı eşlemeyi yersiz kılar.</p>
<p>Bir istek geldiğinde, sunucu, istekte kullanılan IP adresi ve portu ile
en iyi eşleşen <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> bileşenini bulur. Bu IP adresi ve port çifti ile
eşleşen birden fazla sanal konak varsa, Apache httpd istekte kullanılan
sunucu ismini <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> ve
<code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> yönergelerindeki
isimlerle karşılaştırır.</p>
<p>Herhangi bir isme dayalı sanal konakta <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> yönergesini kullanmazsanız, sunucu
bu yönergeye sistem konak adından türetilmiş tam nitelenmiş alan adının
(FQDN) tanımlandığını varsayacaktır. Bu örtük atama sezgiselliğin
istenmediği bir sanal konak eşleşmesi ile sonuçlanabilir ve bu
önerilmez.</p>
<h3><a name="defaultvhost" id="defaultvhost">Bir IP adresi ve port çifti için öntanımlı isme dayalı sankon</a></h3>
<p><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> ve
<code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> yönergelerinde bir
eşleşme bulunamazsa, Apache httpd bu çift ile eşleşen <strong>sanal
konaklar listesindeki ilk sanal konağı</strong> kullanır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="using" id="using">İsme Dayalı Sanal Konakların Kullanımı</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li><li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>İlk adım sunacağınız her konak için ayrı bir <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> bölümü oluşturmaktır. Her
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> bölümü
içinde sunulan konağı belirtmek üzere en azından bir adet <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> yönergesine ve konak içeriğinin
dosya sisteminde bulunduğu yeri gösteren bir <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> yönergesine ihtiyacınız
olacaktır.</p>
<div class="note"><h3>Ana konağı unutmayın</h3>
<p>Mevcut <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
yönergelerinin hiçbiriyle eşleşmeyen bir istek için, sunucu veya konak
ismine bakılmaksızın genel sunucu yapılandırmanız kullanılır.</p>
<p>Mevcut sitenize isme dayalı bir sanal konak eklerseniz ve bu sanal
konak ana sunucunun IP adresi ve portuna sahipse, ana sunucuya yapılan
istekler için bu sanal konak kullanılır. Bu bakımdan, <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> yönergesi ana sunucununki ile aynı
olan bir <a href="#defaultvhost">öntanımlı sanal konak</a> oluşturmak
akıllıca olacaktır. Aynı arayüz ve portu kullanan fakat farklı
yapılandırmalara sahip diğer alan isimlerinin sanal konakları (yani
öntanımlı olmayanlar) bu öntanımlı sanal konağın sonrasına
yerleştirilmelidir.</p>
</div>
<div class="note"><h3>ServerName miras alma</h3>
<p>İsme dayalı her sanal konak için daima bir <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> belirtmek en iyisidir.</p>
<p>Eğer bir <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> bölümü
içinde bir <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>
belirtilmezse, sunucu ismi olarak ana sunucu yapılandırmasındaki isim
kullanılır. Orada da bir sunucu ismi belirtilmemişse, başlatma sırasında
dinlenen ilk IP adresinden ters DNS araması ile elde edilen isim
kullanılır. Her iki durumda da miras alınan isim gereksiz yere isme
dayalı sanal konak ismi haline gelecektir; bu bakımdan isme dayalı her
sanal konak için daima bir <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> belirtmek en iyisidir.</p>
</div>
<p>Örnek olarak, <code>site1.example.com</code> adresinden sitenizi
sunmakta olduğunuzu ve bunun yanına aynı IP adresini kullanan
<code>site2.example.com</code> sanal konağını eklemek istediğinizi
varsayalım. Bunun için <code>httpd.conf</code> dosyanıza basitçe şu
satırları ekleyebilirsiniz:</p>
<pre class="prettyprint lang-config"><VirtualHost *:80>
#İlk sanal konak aynı zamanda *:80 için de öntanımlıdır.
ServerName site1.example.com
ServerAlias example.com
DocumentRoot "/siteler/site1"
</VirtualHost>
<VirtualHost *:80>
ServerName site2.example.com
DocumentRoot "/siteler/site2"
</VirtualHost></pre>
<p>İsterseniz, <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> yönergesinde argüman olarak <code>*</code>
yerine doğrudan bir IP adresi belirtebilirsiniz. Hatta, daha sonra, isme
dayalı sanal konakları bir IP adresinden ve IP’ye dayalı olanları veya
isme dayalı diğer bir sanal konak grubunu diğer IP adreslerinden sunmak
isteyebilirsiniz.</p>
<p>Çoğu sunucunun birden fazla isim ile erişilebilir olması istenir. Bu,
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> bölümü
içine bir <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> yönergesi
yerleştirmek suretiyle mümkün olur. Örneğin yukarıdaki örnekte,
kullanıcıların aynı siteye farklı isimlerle erişmelerini mümkün kılmak
için bölüm içine şu satırı ekleyebilirsiniz:</p>
<pre class="prettyprint lang-config">ServerAlias example.com *.example.com</pre>
<p>Böylece <code>example.com</code> alanındaki tüm konaklar için gelen
isteklere <code>www.example.com</code> sanal konağından hizmet sunulmuş
olur. Konak isimleriyle eşleşmek üzere dosya ismi kalıp karakterleri
<code>*</code> ve <code>?</code> kullanılabilir. Şüphesiz bu isimleri
sırf <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> veya
<code>ServerAlias</code> yönergesinde belirtmiş olmakla bu isimleri
erişilebilir kılamazsınız. Öncelikle, bu isimleri sunucunuzdaki IP
adresleriyle eşlemek üzere yapılandıracağınız bir DNS sunucunuz
olmalıdır.</p>
<p>İsme dayalı sanal konaklardan en iyi eşleşme kümesinde olanlar
yapılandırmada göründükleri sıraya göre işleme sokulur. Joker
kullanımları arasında fark gözetilmeksizin <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> veya <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> yönergesi eşleşen ilk sanal konak
kullanılır.</p>
<p><code>VirtualHost</code> içindeki isimlerin sırası (jokersiz) bir
<code>ServerAlias</code> gibi ele alınır (fakat hiçbir
<code>ServerAlias</code> yönergesi ile geçersiz kılınmaz).</p>
<p>Son olarak, sanal konak yapılandırmanıza, <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> bölümlerinin içine başka yönergeler
yerleştirerek ince ayar çekebilirsiniz. Çoğu yönerge bu bölümlere
yerleştirilebilir ve sadece o sanal konakla ilgili yapılandırmayı
değiştirmek için kullanılabilir. Belli bir yönergenin sanal konak
bölümlerinde kullanılıp kullanılmayacağını yönergenin açıklamasında <a href="../mod/directive-dict.html#Context">Bağlam</a> satırına bakarak
öğrenebilirsiniz. <em>Ana sunucu bağlamındaki</em> (<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> bölümleri dışındaki)
yapılandırma yönergelerinden sadece sanal konak bölümlerinde geçersiz
kılınmamış olanlar kullanılacaktır.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/name-based.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/index.html.fr.utf8 0000664 0001751 0001751 00000020367 14740503670 021663 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Documentation sur les serveurs virtuels Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Documentation sur les serveurs virtuels Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Le principe des <cite>Serveurs Virtuels</cite> consiste à
faire fonctionner un ou plusieurs serveurs Web (comme
<code>www.company1.example.com</code> et <code>www.company2.example.com</code>)
sur une même machine. Les serveurs virtuels peuvent être soit
"<a href="ip-based.html">par-IP</a>" où une adresse IP est
attribuée pour chaque serveur Web, soit "<a href="name-based.html">par-nom</a>" où plusieurs noms de domaine se côtoient sur
des mêmes adresses IP. L'utilisateur final ne perçoit pas
qu'en fait il s'agit d'un même serveur physique.</p>
<p>Apache a été le précurseur des serveurs proposant cette
méthode de serveurs virtuels basés sur les adresses IP. Ses
versions 1.1 et suivantes proposent les deux
méthodes de serveurs virtuels : par-IP et par-nom. Cette
deuxième méthode est parfois également appelée <em>host-based</em>
ou <em>serveur virtuel non-IP</em>.</p>
<p>Vous trouverez ci-dessous une liste documentaire qui vous
expliquera en détails le fonctionnement du support des serveurs
virtuels par le serveur HTTP Apache.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#support">Support des serveurs virtuels</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#directives">Directives de configuration</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li><li><a href="name-based.html">Serveurs virtuels par-nom</a></li><li><a href="ip-based.html">Serveurs virtuels par-IP</a></li><li><a href="examples.html">Exemples de serveurs virtuels</a></li><li><a href="fd-limits.html">Limites des descripteurs de fichiers</a></li><li><a href="mass.html">Hébergement virtuel en masse</a></li><li><a href="details.html">Détails sur les critères de choix du serveur</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="support" id="support">Support des serveurs virtuels</a></h2>
<ul>
<li><a href="name-based.html">Serveurs Virtuels par-Nom</a>
(Un ou plusieurs sites Web par adresse IP)</li>
<li><a href="ip-based.html">Serveurs Virtuels par-IP</a>
(Une adresse IP pour chaque site Web)</li>
<li><a href="examples.html">Exemples de configurations classiques
de Serveurs Virtuels </a></li>
<li><a href="fd-limits.html">Limites des descripteurs de fichiers</a>
(ou, <em>trop de fichiers journaux</em>)</li>
<li><a href="mass.html">Configuration dynamique en masse de
Serveurs Virtuels</a></li>
<li><a href="details.html">Explication approfondie des critères
de sélection d'un Serveur Virtuel</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="directives" id="directives">Directives de configuration</a></h2>
<ul>
<li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li>
<li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li>
</ul>
<p>Pour vérifier et analyser la configuration de vos serveurs
virtuels, vous pouvez utiliser l'argument <code>-S</code> sur
la ligne de commande.</p>
<div class="example"><h3>Exemple Unix</h3><p><code>
apachectl -S
</code></p></div>
<div class="example"><h3>Exemple Windows</h3><p><code>
httpd.exe -S
</code></p></div>
<p>Cette commande affichera dans le détail comment Apache a
traité son fichier de configuration. Les erreurs de configuration
peuvent être corrigées par l'examen attentif des adresses IP et
des noms de serveurs. (Consultez la documentation du programme
<code class="program"><a href="../programs/httpd.html">httpd</a></code> pour les autres arguments de la ligne de
commande)</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/examples.html.ja.utf8 0000664 0001751 0001751 00000076755 14743132254 022370 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>バーチャルホストの例 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">バーチャルホスト</a></div><div id="page-content"><div id="preamble"><h1>バーチャルホストの例</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/vhosts/examples.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/examples.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/examples.html" title="Japanese"> ja </a> |
<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/examples.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>この文書は、バーチャルホストの設定の際に
よくある質問に答えるものです。想定している対象は <a href="name-based.html">名前ベース</a> や <a href="ip-based.html">IP ベース</a> のバーチャルホストを使って
一つのサーバで複数のウェブサイトを運用している状況です。
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#purename">一つの IP アドレスでいくつかの名前ベースの
ウェブサイトを実行する</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#twoips">複数の IP アドレスのあるホストで名前ベースの
ホスティングを行なう</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#intraextra">違う IP アドレス (例えば、内部と外部アドレス)
で同じコンテンツを送る</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#port">違うポートで違うサイトを運営する</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ip">IP ベースのバーチャルホスティング</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ipport">ポートベースと IP ベースの混ざった
バーチャルホスト</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mixed">名前ベースと IP ベースを混ぜた
バーチャルホスト</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#proxy"><code>Virtual_host</code> と
mod_proxy を併用する</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#default"><code>_default_</code> のバーチャルホストを
使う</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#migrate">名前ベースのバーチャルホストから IP ベースの
バーチャルホストに移行する</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#serverpath"><code>ServerPath</code> ディレクティブを
使う</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="purename" id="purename">一つの IP アドレスでいくつかの名前ベースの
ウェブサイトを実行する</a></h2>
<p>サーバは IP アドレスを一つ割り当てられていて、DNS でマシンに
複数の名前 (CNAME) が指定されています。このマシンで
<code>www.example.com</code> と <code>www.example.org</code>
のためのウェブサーバを実行させたいとします。</p>
<div class="note"><h3>注</h3><p>
Apache サーバの設定でバーチャルホストの設定をしただけで、
知らない間にそのホスト名に対応する DNS のエントリが
作成されたりはしません。そのサーバの IP アドレスに解決される
ように DNS に名前を登録しなければ<em>なりません</em>。
そうでないと誰もあなたのウェブサイトを見ることはできません。
ローカルでのテストのために <code>hosts</code> ファイルに
エントリを追加することもできますが、この場合はその
hosts エントリのあるマシンからしか動作しません。</p>
</div>
<div class="example"><h3>サーバ設定</h3><p><code>
# Ensure that Apache listens on port 80<br />
Listen 80<br />
<br />
# Listen for virtual host requests on all IP addresses<br />
NameVirtualHost *:80<br />
<br />
<VirtualHost *:80><br />
<span class="indent">
DocumentRoot /www/example1<br />
ServerName www.example.com<br />
<br />
# Other directives here<br />
<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost *:80><br />
<span class="indent">
DocumentRoot /www/example2<br />
ServerName www.example.org<br />
<br />
# Other directives here<br />
<br />
</span>
</VirtualHost>
</code></p></div>
<p>アスタリスクはすべてのアドレスにマッチしますので、主サーバは
リクエストを扱いません。<code>www.example.com</code> は
最初にあるため、優先順位は一番高くなり、<cite>default</cite> もしくは
<cite>primary</cite> のサーバと考えることができます。つまり、リクエストが
どの <code>ServerName</code> ディレクティブにもマッチしない場合、
一番最初の <code>VirtualHost</code> により扱われます。</p>
<div class="note"><h3>注</h3>
<p><code>*</code> をシステムの実際の IP アドレスに置き換える
こともできます。その場合は <code>VirtualHost</code> の引数は
<code>NameVirtualHost</code> の引数と同じに<em>しなければなりません
</em>:</p>
<div class="example"><p><code>
NameVirtualHost 172.20.30.40<br />
<br />
<VirtualHost 172.20.30.40><br />
# etc ...
</code></p></div>
<p>しかし、IP アドレスが予測不可能なシステム
――例えばプロバイダから動的に IP アドレスを取得して何らかの
ダイナミック DNS を使っている場合など――においては、<code>*</code>
指定はさらに便利です。<code>*</code> はすべての IP アドレスに
マッチしますので、この設定にしておけば IP アドレスが変更されても
設定変更せずに動作します。</p>
</div>
<p>名前ベースのバーチャルホスティングではほぼすべての状況で、
上記の設定で希望の設定になっていることでしょう。
実際この設定が動作しないのは、IP アドレスやポートの違いによって
違うコンテンツを送るときだけです。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="twoips" id="twoips">複数の IP アドレスのあるホストで名前ベースの
ホスティングを行なう</a></h2>
<div class="note">
<h3>注</h3><p>ここで説明されている方法は IP アドレスが
何個あっても同様にできます。</p>
</div>
<p>サーバには二つ IP アドレスがついています。一つ目
(<code>172.20.30.40</code>) では主サーバ
<code>server.domain.com</code> を扱い、もう一方
(<code>172.20.30.50</code>) では二つかそれ以上の数の
バーチャルホストを扱います。</p>
<div class="example"><h3>サーバの設定</h3><p><code>
Listen 80<br />
<br />
# This is the "main" server running on 172.20.30.40<br />
ServerName server.domain.com<br />
DocumentRoot /www/mainserver<br />
<br />
# This is the other address<br />
NameVirtualHost 172.20.30.50<br />
<br />
<VirtualHost 172.20.30.50><br />
<span class="indent">
DocumentRoot /www/example1<br />
ServerName www.example.com<br />
<br />
# Other directives here ...<br />
<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.50><br />
<span class="indent">
DocumentRoot /www/example2<br />
ServerName www.example.org<br />
<br />
# Other directives here ...<br />
<br />
</span>
</VirtualHost>
</code></p></div>
<p><code>172.20.30.50</code> 以外のアドレスへのリクエストは主サーバ
が扱います。<code>172.20.30.50</code> への、未知のホスト名または
<code>Host:</code> ヘッダなしのリクエストは <code>www.example.com</code>
が扱います。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="intraextra" id="intraextra">違う IP アドレス (例えば、内部と外部アドレス)
で同じコンテンツを送る</a></h2>
<p>サーバマシンは IP アドレスを二つ (<code>192.168.1.1</code>
と <code>172.20.30.40</code>) 持っています。このマシンは内部
(イントラネット) と 外部 (インターネット) のネットワークの間に
あります。<code>server.example.com</code> はネットワークの外からは
外部アドレス (<code>172.20.30.40</code>) として解決されますが、
ネットワークの中からは内部アドレス (<code>192.168.1.1</code>)
として解決されます。</p>
<p><code>VirtualHost</code> 一つだけでサーバが内部のリクエストと
外部のリクエストの両方に同じコンテンツで応答するようにできます。</p>
<div class="example"><h3>サーバの設定</h3><p><code>
NameVirtualHost 192.168.1.1<br />
NameVirtualHost 172.20.30.40<br />
<br />
<VirtualHost 192.168.1.1 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/server1<br />
ServerName server.example.com<br />
ServerAlias server<br />
</span>
</VirtualHost>
</code></p></div>
<p>これでどちらのネットワークからのリクエストも同じ <code>VirtualHost</code>
で扱われるようになります。</p>
<div class="note"><h3>注:</h3><p>内部ネットワークでは完全なホスト名の
<code>server.example.com</code> の代わりに、単に <code>server</code>
を使うことができます。</p>
<p>上の例では、IP アドレスのリストを、すべてのアドレスに
同じコンテンツで応答する <code>*</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="port" id="port">違うポートで違うサイトを運営する</a></h2>
<p>同じ IP に複数のドメインがあり、さらに複数のポートを使って
リクエストを扱いたいときがあります。"NameVirtualHost" タグの中で
ポートを定義することで、これを動作させられます。
NameVirtualHost name:port 無しや Listen ディレクティブで
<VirtualHost name:port> を使おうとしても、その設定は動作しません。</p>
<div class="example"><h3>サーバの設定</h3><p><code>
Listen 80<br />
Listen 8080<br />
<br />
NameVirtualHost 172.20.30.40:80<br />
NameVirtualHost 172.20.30.40:8080<br />
<br />
<VirtualHost 172.20.30.40:80><br />
<span class="indent">
ServerName www.example.com<br />
DocumentRoot /www/domain-80<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40:8080><br />
<span class="indent">
ServerName www.example.com<br />
DocumentRoot /www/domain-8080<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40:80><br />
<span class="indent">
ServerName www.example.org<br />
DocumentRoot /www/otherdomain-80<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40:8080><br />
<span class="indent">
ServerName www.example.org<br />
DocumentRoot /www/otherdomain-8080<br />
</span>
</VirtualHost>
</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="ip" id="ip">IP ベースのバーチャルホスティング</a></h2>
<p>サーバは <code>www.example.com</code> と <code>www.example.org</code>
にそれぞれ解決される、二つの IP アドレス (<code>172.20.30.40</code> と
<code>172.20.30.50</code>) があります。</p>
<div class="example"><h3>サーバの設定</h3><p><code>
Listen 80<br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/example1<br />
ServerName www.example.com<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.50><br />
<span class="indent">
DocumentRoot /www/example2<br />
ServerName www.example.org<br />
</span>
</VirtualHost>
</code></p></div>
<p><code><VirtualHost></code> ディレクティブのどれでも
指定されていないアドレス (例えば <code>localhost</code>) は、
主サーバがあればそこに行きます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ipport" id="ipport">ポートベースと IP ベースの混ざった
バーチャルホスト</a></h2>
<p>サーバマシンはそれぞれ <code>www.example.com</code> と
<code>www.example.org</code> にそれぞれ解決される、IP アドレスを二つ
(<code>172.20.30.40</code> と <code>172.20.30.50</code>) 持っています。
どちらもポート 80 と 8080 でホストを走らせます。</p>
<div class="example"><h3>サーバの設定</h3><p><code>
Listen 172.20.30.40:80<br />
Listen 172.20.30.40:8080<br />
Listen 172.20.30.50:80<br />
Listen 172.20.30.50:8080<br />
<br />
<VirtualHost 172.20.30.40:80><br />
<span class="indent">
DocumentRoot /www/example1-80<br />
ServerName www.example.com<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40:8080><br />
<span class="indent">
DocumentRoot /www/example1-8080<br />
ServerName www.example.com<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.50:80><br />
<span class="indent">
DocumentRoot /www/example2-80<br />
ServerName www.example.org<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.50:8080><br />
<span class="indent">
DocumentRoot /www/example2-8080<br />
ServerName www.example.org<br />
</span>
</VirtualHost>
</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="mixed" id="mixed">名前ベースと IP ベースを混ぜた
バーチャルホスト</a></h2>
<p>いくつかのマシンでは名前ベースの、その他では IP ベースのバーチャル
ホストをします。</p>
<div class="example"><h3>サーバの設定</h3><p><code>
Listen 80<br />
<br />
NameVirtualHost 172.20.30.40<br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/example1<br />
ServerName www.example.com<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/example2<br />
ServerName www.example.org<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/example3<br />
ServerName www.example3.net<br />
</span>
</VirtualHost><br />
<br />
# IP-based<br />
<VirtualHost 172.20.30.50><br />
<span class="indent">
DocumentRoot /www/example4<br />
ServerName www.example4.edu<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.60><br />
<span class="indent">
DocumentRoot /www/example5<br />
ServerName www.example5.gov<br />
</span>
</VirtualHost>
</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="proxy" id="proxy"><code>Virtual_host</code> と
mod_proxy を併用する</a></h2>
<p>次の例は、フロント側のバーチャルホストで他のマシンへプロクシします。
例では <code>192.168.111.2</code> のマシンではバーチャルホスト名は
同じ名前で設定されています。複数のホスト名を一台のマシンにプロクシする
場合は、<code class="directive"><a href="../mod/mod_proxy.html#proxypreservehost on">ProxyPreserveHost On</a></code>
ディレクティブを使って、希望のホスト名を渡せるようになります。
</p>
<div class="example"><p><code>
<VirtualHost *:*><br />
ProxyPreserveHost On<br />
ProxyPass / http://192.168.111.2/<br />
ProxyPassReverse / http://192.168.111.2/<br />
ServerName hostname.example.com<br />
</VirtualHost>
</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="default" id="default"><code>_default_</code> のバーチャルホストを
使う</a></h2>
<h3><a name="defaultallports" id="defaultallports">すべてのポートに対する
<code>_default_</code> バーチャルホスト</a></h3>
<p>未指定の IP アドレスとポート、<em>つまり</em>他のバーチャルホストに
使われていないアドレスとポートの組み合わせ、への<em>すべての</em>リクエストを
受け取ります。</p>
<div class="example"><h3>サーバの設定</h3><p><code>
<VirtualHost _default_:*><br />
<span class="indent">
DocumentRoot /www/default<br />
</span>
</VirtualHost>
</code></p></div>
<p>このようにワイルドカードのポートでデフォルトのバーチャルホストを
指定すると、主サーバにリクエストが行くのを防げます。</p>
<p>デフォルトのバーチャルホストは名前ベースのバーチャルホストに
使われているアドレスとポートの組に送られたリクエストを扱うことは
ありません。リクエストが不明な <code>Host:</code> ヘッダやその
ヘッダがなかったりする場合は基本名前ベースバーチャルホスト (その
アドレスとポートで設定ファイル中で最初のバーチャルホスト) により
扱われます。</p>
<p>どんなリクエストでも <code class="directive"><a href="../mod/mod_alias.html#aliasmatch">AliasMatch</a></code>
や <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> を使って
単一の情報ページ (やスクリプト) に書き換えることができます。</p>
<h3><a name="defaultdifferentports" id="defaultdifferentports">違うポートのための
<code>_default_</code> バーチャルホスト</a></h3>
<p>一つめの設定とほぼ同じですが、サーバは複数のポートを listen しており、
80 番ポートに対して二つめの <code>_default_</code> バーチャルホストを
設定したい場合です。</p>
<div class="example"><h3>サーバの設定</h3><p><code>
<VirtualHost _default_:80><br />
<span class="indent">
DocumentRoot /www/default80<br />
# ...<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost _default_:*><br />
<span class="indent">
DocumentRoot /www/default<br />
# ...<br />
</span>
</VirtualHost>
</code></p></div>
<p>80 番ポートのデフォルトバーチャルホスト (ワイルドカードポートの
デフォルトバーチャルホストよりも前に書かれていなければ<em>なりません</em>) は
未指定の IP アドレスに送られたすべてのリクエストを扱います。
主サーバはリクエストを扱いません。</p>
<h3><a name="defaultoneport" id="defaultoneport">一つのポートに対してだけの
<code>_default_</code> バーチャルホスト</a></h3>
<p>80 番ポートにはデフォルトのバーチャルホストが必要で、他の
バーチャルホストはデフォルトが必要ない場合です。</p>
<div class="example"><h3>サーバの設定</h3><p><code>
<VirtualHost _default_:80><br />
DocumentRoot /www/default<br />
...<br />
</VirtualHost>
</code></p></div>
<p>80 番ポートへのアドレス未指定のリクエストはデフォルトのバーチャル
ホストから送られます。他の未指定のアドレスとポートへのリクエストは
主サーバから送られます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="migrate" id="migrate">名前ベースのバーチャルホストから IP ベースの
バーチャルホストに移行する</a></h2>
<p>ホスト名が名前 <code>www.example.org</code> のバーチャルホスト
(<a href="#name">名前ベース</a>の例の 2 番目の設定) が専用の IP アドレスを
得たとします。名前ベースのバーチャルホストの古い IP アドレスを
キャッシュしているネームサーバやプロキシのために移行期間中は両方の
バーチャルホストを提供したいとします。</p>
<p>答は簡単です。単に新しい IP アドレス (<code>172.20.30.50</code>)
を <code>VirtualHost</code> ディレクティブに追加することで
できます。</p>
<div class="example"><h3>サーバ設定</h3><p><code>
Listen 80<br />
ServerName www.example.com<br />
DocumentRoot /www/example1<br />
<br />
NameVirtualHost 172.20.30.40<br />
<br />
<VirtualHost 172.20.30.40 172.20.30.50><br />
<span class="indent">
DocumentRoot /www/example2<br />
ServerName www.example.org<br />
# ...<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/example3<br />
ServerName www.example.net<br />
ServerAlias *.example.net<br />
# ...<br />
</span>
</VirtualHost>
</code></p></div>
<p>このバーチャルホストは新しいアドレス (IP ベースのバーチャルホストとして)
と古いアドレス(名前ベースのバーチャルホストとして) の両方から
アクセスできます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="serverpath" id="serverpath"><code>ServerPath</code> ディレクティブを
使う</a></h2>
<p>名前ベースのバーチャルホストが二つあるサーバがあるとします。
正しいバーチャルホストを得るためにはクライアントは正しい
<code>Host:</code> ヘッダを送らなければなりません。
古い HTTP/1.0 はそのようなヘッダを送らないので、Apache はクライアントが
どのバーチャルホストを意図したのかさっぱりわかりません
(なので、主バーチャルホストでリクエストを扱います)。
可能な限りの下位互換性を得るため、名前ベースのバーチャルホストの
URL 接頭辞へのリンクの書かれたページを返す、
主バーチャルホストが作成されます。</p>
<div class="example"><h3>サーバの設定</h3><p><code>
NameVirtualHost 172.20.30.40<br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
# primary vhost<br />
DocumentRoot /www/subdomain<br />
RewriteEngine On<br />
RewriteRule ^/.* /www/subdomain/index.html<br />
# ...<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40><br />
DocumentRoot /www/subdomain/sub1<br />
<span class="indent">
ServerName www.sub1.domain.tld<br />
ServerPath /sub1/<br />
RewriteEngine On<br />
RewriteRule ^(/sub1/.*) /www/subdomain$1<br />
# ...<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost 172.20.30.40><br />
<span class="indent">
DocumentRoot /www/subdomain/sub2<br />
ServerName www.sub2.domain.tld<br />
ServerPath /sub2/<br />
RewriteEngine On<br />
RewriteRule ^(/sub2/.*) /www/subdomain$1<br />
# ...<br />
</span>
</VirtualHost>
</code></p></div>
<p><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code> ディレクティブの設定に
より、URL <code>http://www.sub1.domain.tld/sub1/</code> は
<em>常に</em> sub1-vhost により扱われます。URL
<code>http://www.sub1.domain.tld/</code> へのリクエストは
クライアントが正しい <code>Host:</code> ヘッダを送ったときにのみ
sub1-vhost から送られます。<code>Host:</code> ヘッダがなければ
クライアントは主ホストの情報ページを得ます。</p>
<p>一つ奇妙な動作をする点があることは覚えておいてください。
<code>http://www.sub2.domain.tld/sub1/</code> へのリクエストも
<code>Host:</code> ヘッダがなければ sub1-vhost により扱われます。</p>
<p>正しい <code>Host:</code> ヘッダを送ったクライアントはどちらの
URL、<em>つまり</em>接頭辞がある方も無い方も使えるように
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> ディレクティブが
使われています。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/vhosts/examples.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/examples.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/examples.html" title="Japanese"> ja </a> |
<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/examples.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/examples.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/fd-limits.html.ko.euc-kr 0000664 0001751 0001751 00000020660 14743132254 022741 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ϱ(file descriptor) Ѱ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">ȣƮ</a></div><div id="page-content"><div id="preamble"><h1>ϱ(file descriptor) Ѱ</h1>
<div class="toplang">
<p><span> : </span><a href="../en/vhosts/fd-limits.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/fd-limits.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/fd-limits.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>ȣƮ ϰ ȣƮ ٸ
α ϸ, ġ 밡 ϱ(file
descriptor, <cite>ڵ(file handle)</cite>̶
θ) ִ. ġ ϴ ϱ
αϴ Ѱ, ٸ α þ
Ѱ, ߰ ο뵵 10-20 . н ü
μ ִ ϱ Ѵ. Ѱ
64, ̺ ū hard-limit ø ִ.</p>
<p>ġ Ѱ踦 ʿѸŭ ø , ϴ
찡 ִ:</p>
<ol>
<li>ý <code>setrlimit()</code> ýȣ
ʴ´.</li>
<li>(Solaris 2.3 ) ýۿ
<code>setrlimit(RLIMIT_NOFILE)</code> Լ
ʴ´.</li>
<li>ʿ ϱ hard limit .</li>
<li>(Solaris 2) ý stdio Ʈ 256
ϱڸ ϵ ϴ ϱڿ
Ѵ.</li>
</ol>
<p> ذå:</p>
<ul>
<li>α δ. <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> ǿ α
ʰ α Ѵ. ( ڼ
Ʒ <a href="#splitlogs">α </a> ϶.)</li>
<li>
ϴ ý () 1° 2° 쿡 شѴٸ,
ũƮ ġ ϱ ϱ
Ѱ踦 ø.
<div class="example"><p><code>
<code>#!/bin/sh<br />
ulimit -S -n 100<br />
exec httpd</code>
</code></p></div>
</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="splitlogs" id="splitlogs">α </a></h2>
<p> ȣƮ α Ѵٸ ߿
ȣƮ м α ̴.
۾ ִ.</p>
<p> α ȣƮ ߰Ѵ. ̸
<code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code>
þ <code>%v</code> Ѵ. α
Ĺڿ տ ߰Ѵ:</p>
<div class="example"><p><code>
LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost<br />
CustomLog logs/multiple_vhost_log vhost
</code></p></div>
<p> common α տ (<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> þ )
ȣƮ Ͽ α Ѵ. (α
ǿ <code class="directive"><a href="../mod/mod_log_config.html# α"> α</a></code>
϶.)</p>
<p>α (ȣƮ Ͼ) ʹٸ <code><a href="../programs/other.html">split-logfile</a></code> α
Ѵ. α ġ <code>support</code>
丮 ִ.</p>
<p> α Ѵ:</p>
<div class="example"><p><code>
split-logfile < /logs/multiple_vhost_log
</code></p></div>
<p>ȣƮ α α ϸ αϿ
ȣƮ ϳ . ϸ
<code>hostname.log</code>̴.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/vhosts/fd-limits.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/fd-limits.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/fd-limits.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/fd-limits.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/index.html.tr.utf8 0000664 0001751 0001751 00000020150 14743132254 021666 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache Sanal Konak Belgeleri - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache Sanal Konak Belgeleri</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p><cite>Sanal Konak</cite> (Virtual Host) terimi tek bir makine üzerinde
birden fazla sitenin (sirket1.example.com, sirket2.example.com gibi)
barındırılma uygulamasını betimler. Sanal konaklar,
"<a href="ip-based.html">IP’ye dayalı</a>" veya
"<a href="name-based.html">isme dayalı</a>" olabilir;
birincisinde, her site ayrı bir IP adresinden sunulurken, ikincisinde her
IP adresinde birden fazla site sunulur. Olayda aynı fiziksel sunucu
kullanıldığı halde bu sunucu son kullanıcıya görünür değildir.</p>
<p>Apache yazılımsal olarak IP’ye dayalı sanal konakları destekleyen ilk
sunuculardan biridir. 1.1 sürümünden itibaren Apache hem IP’ye dayalı hem
de isme dayalı sanal konakları desteklemektedir. İsme dayalı sanal
konaklara bazen <em>konağa dayalı</em> sanal konaklar veya <em>IP’ye
dayanmayan</em> sanal konaklar da denmektedir.</p>
<p>Aşağıda, Apache HTTP Suncusundaki sanal konak desteğini bütün
ayrıntıları ile açıklayan belgeler listelenmiştir.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#support">Sanal Konak Desteği</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#directives">Yapılandırma Yönergeleri</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li><li><a href="name-based.html">İsme Dayalı Sanal Konaklar</a></li><li><a href="ip-based.html">IP Adresine Dayalı Sanal Konaklar</a>
</li><li><a href="examples.html">Sanal Konak Örnekleri</a></li><li><a href="fd-limits.html">Dosya Tanıtıcı Sınırları</a></li><li><a href="mass.html">Kütlesel Sanal Konaklık</a></li><li><a href="details.html">Ayrıntılı olarak Konak Eşleme</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="support" id="support">Sanal Konak Desteği</a></h2>
<ul>
<li><a href="name-based.html">İsme Dayalı Sanal Konaklar</a> (Her IP
adresinde birden fazla site)</li>
<li><a href="ip-based.html">IP Adresine Dayalı Sanal Konaklar</a> (Her
site için ayrı IP adresi)</li>
<li><a href="examples.html">Çok kullanılan sanal konak yapılandırma
örnekleri</a></li>
<li><a href="fd-limits.html">Dosya Tanıtıcı Sınırları</a> (veya,
<em>çok fazla günlük dosyası</em>)</li>
<li><a href="mass.html">Devingen olarak Yapılandırılan Kütlesel Sanal
Barındırma</a></li>
<li><a href="details.html">Konak Eşlemenin Derinliğine
İncelenmesi</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="directives" id="directives">Yapılandırma Yönergeleri</a></h2>
<ul>
<li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li>
<li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li>
</ul>
<p>Sanal konak yapılandırmanız üzerinde hata ayıklamaya çalışıyorsanız
<code>-S</code> komut satırı seçeneği şu şekilde çok işinize
yarayabilir:</p>
<div class="example"><h3>Unix örneği</h3><p><code>
apachectl -S
</code></p></div>
<div class="example"><h3>Windows örneği</h3><p><code>
httpd.exe -S
</code></p></div>
<p>Bu komut, yapılandırma dosyasının Apache yorumunu dökümler. IP
adreslerinin ve sunucu isimlerinin dikkatli bir incelemesi, yapılandırma
yanlışlarınızı keşfetmenize yardımcı olabilir. (Diğer komut satırı
seçenekleri için <code class="program"><a href="../programs/httpd.html">httpd</a></code> programının belgelerine
bakınız.)</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/ip-based.html.tr.utf8 0000664 0001751 0001751 00000034621 14743132254 022253 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>IP’ye Dayalı Sanal Konak Desteği - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Sanal Konaklar</a></div><div id="page-content"><div id="preamble"><h1>IP’ye Dayalı Sanal Konak Desteği</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/vhosts/ip-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/ip-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/ip-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/ip-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/ip-based.html" title="Türkçe"> tr </a></p>
</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#explanation">IP'ye dayalı sanal konak desteği nedir</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#requirements">Sistem gereksinimleri</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#howto">Apache nasıl ayarlanır?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multiple">Çok sayıda sürecin yapılandırılması</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#single">Sanal konaklar tek bir sürecin yapılandırılması</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li>
<a href="name-based.html">İsme Dayalı Sanal Konak Desteği</a>
</li><li><a href="#comments_section">Yorumlar</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="explanation" id="explanation">IP'ye dayalı sanal konak desteği nedir</a></h2>
<p>IP'ye dayalı sanal konak desteği, bir isteğin alındığı IP adresi ve
porta bağlı olarak farklı yönergeleri uygulamak için bir yoldur. Özetle,
farklı siteleri farklı portlardan ve arayüzlerden sunmakta
kullanılır.</p>
<p>Çoğu durumda, <a href="name-based.html">isme dayalı sanal konaklar</a>
birçok sanal konağın tek bir IP adresi/port çiftini paylaşmasını
sağladığından daha kullanışlıdır. Neyi kullanacağınıza karar vermek için
<a href="name-based.html#namevip">İsme dayalı ve IP’ye dayalı Sanal
Konaklar</a> bölümüne bakınız.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="requirements" id="requirements">Sistem gereksinimleri</a></h2>
<p><cite>IP’ye dayalı</cite> deyince, sunucunun <strong>her IP’ye dayalı
sanal konak için ayrı bir IP adresi/port çifti</strong>ne sahip olduğunu
anlıyoruz. Bunun olması için, makine ya çok sayıda ağ bağlantısına
sahiptir ya da makinede, günümüzde çoğu işletim sistemi tarafından
desteklenen sanal arabirimler ve/veya çok sayıda port kullanılıyordur.
(Sanal arabirimlerle ilgili ayrıntılar için sistem belgelerinize bakınız;
bu konu genellikle IP rumuzları (ip aliases) olarak geçer ve ayarlamak
için genellikle "ifconfig" komutu kullanılır.)</p>
<p>Apache HTTP Sunucusu terminolojisinde, tek bir IP adresinin çok sayıda
TCP portuyla kullanımı IP'ye dayalı sanal konak desteği olarak
bilinir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="howto" id="howto">Apache nasıl ayarlanır?</a></h2>
<p>Çok sayıda konağı desteklemek üzere Apache iki şekilde
yapılandırılabilir. Ya her konak için ayrı bir <code class="program"><a href="../programs/httpd.html">httpd</a></code>
süreci çalıştırırsınız ya da tüm sanal konakları destekleyen tek bir
süreciniz olur.</p>
<p>Çok sayıda süreç kullanıyorsanız:</p>
<ul>
<li>Güvenli bölgeler oluşturmanız gerekiyordur. Örneğin, şirket2’deki hiç
kimse dosya sistemi üzerinden şirket1’e ait verileri okuyamasın, sadece
herkes gibi tarayıcı kullanarak okuyabilsin istenebilir. Bu durumda,
<code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code>,
<code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code>,
<code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> ve
<code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> yönergeleri farklı
değerlerle yapılandırılmış iki ayrı süreç çalıştırmanız gerekir.</li>
<li>Makine üzerindeki her IP adresini dinlemek için gereken dosya tanıtıcı
ve bellek miktarını makul bir seviyede tutabilirsiniz. Bu sadece belli
adresleri dinleyerek veya çok sayıda adresle eşleşen adres kalıpları
kullanarak mümükün olabilir. Zaten, bir sebeple belli bir adresi dinleme
ihtiyacı duyarsanız, diğer tüm adresleri de ayrı ayrı dinlemeniz
gerekir. (Bir <code class="program"><a href="../programs/httpd.html">httpd</a></code> programı N-1 adresi dinlerken
diğerleri kalan adresleri dinleyebilir.)</li>
</ul>
<p>Tek bir süreç kullanıyorsanız:</p>
<ul>
<li><code class="program"><a href="../programs/httpd.html">httpd</a></code> yapılandırmasının sanal konaklar arasında
paylaşılmasına izin veriliyor demektir.</li>
<li>Makine çok büyük miktarda isteği karşılayabilir ve ayrı ayrı
süreçlerin çalışmasından kaynaklanan önemli başarım kayıpları
yaşanmaz.</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="multiple" id="multiple">Çok sayıda sürecin yapılandırılması</a></h2>
<p>Her sanal konak için ayrı bir <code class="program"><a href="../programs/httpd.html">httpd</a></code> yapılandırması
oluşturulur. Her yapılandırmada, o süreç tarafından sunulacak IP adresi
(veya sanal konak) için <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>
yönergesi kullanılır. Örnek:</p>
<pre class="prettyprint lang-config">Listen 192.0.2.100:80</pre>
<p>Burada konak ismi yerine IP adresi kullanmanız önerilir (ayrıntılar için
<a href="../dns-caveats.html">DNS ile ilgili konular</a> belgesine
bakınız).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="single" id="single">Sanal konaklar tek bir sürecin yapılandırılması</a></h2>
<p>Bu durum için, ana sunucu ve sanal konakların tümüne gelen istekler tek
bir <code class="program"><a href="../programs/httpd.html">httpd</a></code> süreci tarafından karşılanır. Yapılandırma
dosyasında, her sanal konak için, farklı değerlere sahip <code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>, <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>, <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, <code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code>ve<code class="directive"><a href="../mod/mod_log_config.html#transferlog">TransferLog</a></code>
veya <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> yönergeleri
içeren ayrı birer <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> bölümü
oluşturulur. Örnek:</p>
<pre class="prettyprint lang-config"><VirtualHost 192.168.1.10:80>
ServerAdmin bilgi@example.com
DocumentRoot "/siteler/belgeler/ecom"
ServerName example.com
ErrorLog "/siteler/gunlukler/ecom/hatalar.log"
CustomLog "/siteler/gunlukler/ecom/erisim.log" combined
</VirtualHost>
<VirtualHost 192.168.1.20:80>
ServerAdmin bilgi@example.org
DocumentRoot "/siteler/belgeler/eorg"
ServerName example.org
ErrorLog "/siteler/gunlukler/eorg/hatalar.log"
CustomLog "/siteler/gunlukler/eorg/erisim.log" combined
</VirtualHost></pre>
<p><VirtualHost> yönergesinde konak ismi yerine
IP adresi kullanmanız önerilir (ayrıntılar için
<a href="../dns-caveats.html">DNS ile ilgili konular</a>
belgesine bakınız).</p>
<p>Belli bir IP adresi veya port kullanımı bunların joker eşdeğerlerine
göre daha yüksek öncelik sağlar ve eşleşen bir sanal konak da genel
sunucuya göre öncelik alır.</p>
<p>Süreç oluşturmayı denetleyen yönergeler ve bir kaç başka yönerge dışında
hemen hemen tüm yapılandırma yönergeleri <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> bölümleri içinde kullanılabilir.
Bir yönergenin <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code>
bölümlerinde kullanılıp kullanılmayacağını öğrenmek için <a href="../mod/quickreference.html">yönerge dizinini</a> kullanarak yönergenin
<a href="../mod/directive-dict.html#Context">Bağlam</a>’ına bakınız.</p>
<p><a href="../suexec.html">suEXEC sarmalayıcısı</a> kullanıldığı takdirde
<code class="directive"><a href="../mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> yönergesi de
bir <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> bölümü içinde
kullanılabilir.</p>
<p><em>GÜVENLİK:</em>Günlük dosyalarının yazılacağı yeri belirlerken,
Apache’yi başlatan kullanıcıdan başka kimsenin yazamayacağı bir yerin
seçilmesi bazı güvenlik risklerini ortadan kaldırmak bakımından
önemlidir. Ayrıntılar için <a href="../misc/security_tips.html">güvenlik
ipuçları</a> belgesine bakınız.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/vhosts/ip-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/ip-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/ip-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/ip-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/ip-based.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/ip-based.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/name-based.html.ko.euc-kr 0000664 0001751 0001751 00000043125 14743132254 023046 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title≯ ȣƮ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">ȣƮ</a></div><div id="page-content"><div id="preamble"><h1≯ ȣƮ </h1>
<div class="toplang">
<p><span> : </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ̸ ȣƮ ϴ
Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#namevip"≯ IP ȣƮ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#using"≯ ȣƮ ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#compat"> ȣȯ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="ip-based.html">IP ȣƮ </a></li><li><a href="details.html">ȣƮ ã ڼ </a></li><li><a href="mass.html">뷮 ȣƮ ϱ</a></li><li><a href="examples.html">Ϲ ȣƮ </a></li><li><a href="examples.html#serverpath">ServerPath </a></li><li><a href="#comments_section">Comments</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="namevip" id="namevip"≯ IP ȣƮ</a></h2>
<p>IP ȣƮ IP ּҸ
ȣƮ Ѵ. ȣƮ ٸ IP ּҸ
Ѵ. ̸ ȣƮ Ŭ̾Ʈ
HTTP ȣƮ ˷ֱ ٶ. ̷
IP ּҷ ٸ ȣƮ ִ.</p>
<p≯ ȣƮ DNS ȣƮ ùٸ
IP ּҷ ϵ ȣƮ ϰ, ٸ ȣƮ
ֵ ġ ϱ⸸ ϸǹǷ ϴ. ̸
ȣƮ IP ּҰ ʿ. Ƿ Ư
IP ȣƮ ٸ ̸ ȣƮ
ؾ Ѵ. IP ȣƮ ؾ δ:</p>
<ul>
<li≯ ȣƮ ʴ
Ŭ̾Ʈ ִ. ̸ ȣƮ Ϸ
Ŭ̾Ʈ HTTP Host Ѵ. ̴
HTTP/1.1 ʼ̰, ֱ HTTP/1.0 鵵
Ȯ Ѵ. ̸ ȣƮ ϸ鼭
Ŭ̾Ʈ ؾ Ѵٸ ִ
.</li>
<li>SSL ݻ SSL ȼ ̸
ȣƮ .</li>
<li> ü Ʈ ġ ٸ IP ּҸ
ȣƮ ϴ Ʈ 뷮(bandwidth)
Ѵ.</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="using" id="using"≯ ȣƮ ϱ</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code></li><li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li><li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li><li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p≯ ȣƮ Ϸ
IP ּҸ (Ƹ Ʈ) ؾ Ѵ. ̴ <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> þ ϴ.
Ϲ IP ּҸ Ѵٸ
<code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>
ƱԸƮ <code>*</code> Ѵ. Ʈ
( , SSL ) ȹ̶ <code>*:80</code>
ƱԸƮ Ʈ ߰ؾ Ѵ. <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> þ IP ּҸ
־ٰ ڵ IP ּҸ ٸ
϶. ڼ <a href="../bind.html">ġ
ּҿ Ʈ ϱ</a> ϶. , ⼭
IP ּҴ Ʈ ̽̾ Ѵ.</p>
<p> ܰ Ϸ ȣƮ <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
̴. <code class="directive"><a href="../mod/core.html#virtualhost>"><VirtualHost>></a></code> þ ƱԸƮ
<code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> þ
ƱԸƮ( , IP ּҳ ּҸ ϴ <code>*</code>)
ƾ Ѵ. <code class="directive"><a href="../mod/core.html#virtualhost>"><VirtualHost>></a></code> ȿ
ּ ȣƮ ϴ <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> þ ȣƮ
Ͻý ִ ϴ <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> þ ʿϴ.</p>
<div class="note"><h3> ȣƮ </h3>
<p> ϴ ȣƮ ߰Ѵٸ
ϴ ȣƮ <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> ϵ ߰ؾ
Ѵ. Ͽ ϴ <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> ü <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> ƾ Ѵ.
Ͽ ȣƮ ⺻ ȣƮ
ȴ.</p>
</div>
<p> <code>www.domain.tld</code> ϰ
־µ IP ּҿ
<code>www.otherdomain.tld</code> ȣƮ ߰ϰ
ʹٰ . <code>httpd.conf</code>
߰ϸ ȴ:</p>
<div class="example"><p><code>
NameVirtualHost *:80<br />
<br />
<VirtualHost *:80><br />
<span class="indent">
ServerName www.domain.tld<br />
ServerAlias domain.tld *.domain.tld<br />
DocumentRoot /www/domain<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost *:80><br />
<span class="indent">ServerName www.otherdomain.tld<br />
DocumentRoot /www/otherdomain<br />
</span>
</VirtualHost><br />
</code></p></div>
<p><code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
þ <code>*</code> IP ּҸ
ִ. , ̷ IP ּҿ ̸
ȣƮ , ٸ ּҿ IP Ȥ ̸
ȣƮ ִ.</p>
<p> ̸ ֱ ٶ. ̴
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
ȿ <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>
þ Ͽ ϴ. ù° <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> Ͽ
<code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> þ
ϸ ̸ Ʈ ִ:</p>
<div class="example"><p><code>
ServerAlias domain.tld *.domain.tld
</code></p></div>
<p><code>domain.tld</code> ο ִ ȣƮ
û <code>www.domain.tld</code> ȣƮ Ѵ.
̸ ٶ ϵī <code>*</code> <code>?</code>
ִ. <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>̳ <code>ServerAlias</code>
̸ ־ٰ ƴϴ. ̸
IP ּҷ ϵ DNS ˸° ؾ Ѵ.</p>
<p> <code class="directive"><a href="../mod/core.html#<virtualhost>"><<VirtualHost>></a></code> ȿ ٸ
þ Ͽ ȣƮ ڼ ִ.
κ þ , õ ȣƮ
Ѵ. þ 밡 ˷ þ <a href="../mod/directive-dict.html#Context"></a>
Ȯ϶. (<code class="directive"><a href="../mod/core.html#<virtualhost>"><<VirtualHost>></a></code> ƴ)
<em>ּ</em> þ ȣƮ
þ 쿡 ȴ.</p>
<p>û <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> IP
ּ ˻Ѵ. ٸ IP ּҸ <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
ǵ鿡 û ȣƮ ġϴ <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>̳
<code>ServerAlias</code> ã´. ã Ѵ.
ȣƮ ãϸ, IP ּҿ شϴ
<strong>ȣƮ ù° </strong> Ѵ.</p>
<p> ó ȣƮ <em>⺻</em>
ȣƮ ȴ. IP ּҰ <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> þ شϸ,
<em>ּ</em> <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
<strong></strong> ʴ´. Ư ȣƮ
شʴ û Ϸ <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> Ͽ
ϸ ȴ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="compat" id="compat"> ȣȯ</a></h2>
<p>̹ ̸ ȣƮ ùٷ ϱ
ʿ ʴ Ŭ̾Ʈ ִ. ̷ Ŭ̾Ʈ
û IP ּҿ ù° ȣƮ
(<cite></cite> ̸ ȣƮ)
Ѵ.</p>
<div class="note"><h3> ϴ°?</h3>
<p>⼭ Ǿ Ѵ.
ó ̷ Ǿ.
̸ ȣƮ ʿ <code>Host</code>
.</p>
</div>
<p> ణ 彺 <code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code> þ ذ ִ:</p>
<p> :</p>
<div class="example"><p><code>
NameVirtualHost 111.22.33.44<br />
<br />
<VirtualHost 111.22.33.44><br />
<span class="indent">
ServerName www.domain.tld<br />
ServerPath /domain<br />
DocumentRoot /web/domain<br />
</span>
</VirtualHost><br />
</code></p></div>
<p>̰ ΰ? "<code>/domain</code>" ϴ
URI û ȣƮ <code>www.domain.tld</code>
Ѵ. , <code>Host:</code> Ŭ̾Ʈ
<code>http://www.domain.tld/</code>ε ,
<code>http://www.domain.tld/domain/</code>δ
Ŭ̾Ʈ ִ.</p>
<p≯ ȣƮ ִ
<code>http://www.domain.tld/domain/</code> ũ
ִ´. ȣƮ 븵ũ ( ,
"<code>file.html</code>" ̳ "<code>../icons/image.gif</code>")
Ȥ ("<code>http://www.domain.tld/domain/misc/file.html</code>"̳
"<code>/domain/misc/file.html</code>" ) տ
<code>/domain/</code> ũ Ѵ.</p>
<p> Ģ ʿ Ģ κ
̳ ̳
ִ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/name-based.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/fd-limits.html.fr.utf8 0000664 0001751 0001751 00000023361 14740503670 022441 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Limites des descripteurs de fichiers - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Serveurs Virtuels</a></div><div id="page-content"><div id="preamble"><h1>Limites des descripteurs de fichiers</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/vhosts/fd-limits.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/fd-limits.html" title="Français"> fr </a> |
<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/fd-limits.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Quand de nombreux serveurs virtuels sont créés, Apache peut
dépasser les limites en descripteurs de fichiers ('file descriptors',
également appelés <cite>gestionnaires de fichiers</cite>) si chacun
des serveurs virtuels utilise ses propres fichiers journaux. Le
nombre total de descripteurs de fichiers utilisés par Apache est
d'un par fichier journal, un pour chacune des autres directives
de fichiers journaux, plus un nombre constant compris entre 10 et 20
pour son fonctionnement interne. Les systèmes d'exploitation Unix
limitent le nombre de descripteurs de fichiers utilisables par
processus ; une valeur courante pour cette limite est de 64, et
cette valeur peut le plus souvent être augmentée.</p>
<p>Apache tente d'accroître cette valeur limite si nécessaire, mais
sans y parvenir dans les cas suivants :</p>
<ol>
<li>Le système d'exploitation ne permet pas l'utilisation d'appels
systèmes <code>setrlimit()</code>.</li>
<li>L'appel <code>setrlimit(RLIMIT_NOFILE)</code> ne fonctionne pas
sur votre système d'exploitation (c'est le cas sous Solaris 2.3).</li>
<li>Le nombre de descripteurs de fichiers nécessaires à Apache
dépasse la limite physique du matériel.</li>
<li>Le système impose d'autres limites sur l'utilisation des
descripteurs de fichiers, comme par exemple une limite sur les
flux stdio, utilisables uniquement sur les descripteurs de
fichiers inférieurs à 256. (sous Solaris 2).</li>
</ol>
<p>En cas de problème, Vous pouvez :</p>
<ul>
<li>Réduire le nombre de fichiers journaux, en ne spécifiant
aucun fichier journal dans les sections
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>,
en donc en envoyant les informations aux fichiers journaux du
serveur principal (Voir <a href="#splitlogs">Éclatement des
fichiers journaux</a> ci-dessous pour plus d'informations sur
cette possibilité).</li>
<li>
Dans les cas 1 ou 2 (évoqués ci-dessus), augmentez la limite sur
les descripteurs de fichiers avant le démarrage d'Apache, au
moyen d'un script comme
<div class="example"><p><code>
<code>#!/bin/sh<br />
ulimit -S -n 100<br />
exec httpd</code>
</code></p></div>
</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="splitlogs" id="splitlogs">Éclatement des fichiers journaux</a></h2>
<p>Lorsque vous choisissez d'enregistrer les informations émanant de
plusieurs serveurs virtuels dans un même fichier journal, vous voudrez
ensuite pouvoir scinder ces informations à des fins de statistiques, par
exemple, sur les différents serveurs virtuels. Il est possible de procéder
de la manière suivante :</p>
<p>Tout d'abord, vous devez ajouter le nom du serveur virtuel à chaque
entrée du journal. Ceci se paramètre au moyen de la directive
<code class="directive"><a href="../mod/mod_log_config.html#logformat"> LogFormat</a></code> et de la
variable <code>%v</code>. Ajoutez cette variable au début de la chaîne
de définition du format de journalisations :</p>
<pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost
CustomLog logs/multiple_vhost_log vhost</pre>
<p>Cette configuration va provoquer la création d'un fichier de
journalisation au format standard (CLF : 'Common Log Format'), mais dont
chaque ligne débutera par le nom canonique du serveur virtuel (spécifié
par la directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>).
(Voir <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> pour d'autres informations sur la
personnalisation des fichiers journaux.)</p>
<p>Au moment de séparer les informations du fichier journal en un fichier
par serveur virtuel, le programme <code>
<a href="../programs/other.html">split-logfile</a></code> peut être
utilisé. Ce programme peut être trouvé dans le répertoire
<code>support</code> de la distribution d'Apache.</p>
<p>Exécutez ce programme au moyen de la commande :</p>
<div class="example"><p><code>
split-logfile < /logs/multiple_vhost_log
</code></p></div>
<p>Une fois exécuté avec le nom du fichier contenant tous les journaux,
ce programme va générer un fichier pour chacun des serveurs virtuels
qui apparaît dans le fichier d'entrée. Chaque fichier en sortie est
nommé <code>nomduserveur.log</code>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/vhosts/fd-limits.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/fd-limits.html" title="Français"> fr </a> |
<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/fd-limits.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/fd-limits.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/name-based.html.fr.utf8 0000664 0001751 0001751 00000044551 14740503670 022551 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Support Apache des serveurs virtuels par nom - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Serveurs virtuels</a></div><div id="page-content"><div id="preamble"><h1>Support Apache des serveurs virtuels par nom</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document décrit quand et comment utiliser des serveurs
virtuels par nom.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#namevip">Serveurs virtuels par nom vs. par IP</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#alg">Comment le serveur sélectionne-t-il le serveur
virtuel basé sur le nom approprié</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#using">Utilisation de serveurs virtuels par nom</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="ip-based.html">Support Apache des serveurs virtuels par IP</a></li><li><a href="details.html">Détails sur le fonctionnement des serveurs virtuels</a></li><li><a href="mass.html">Configuration dynamique des hébergements virtuels de masse</a></li><li><a href="examples.html">Exemples d'utilisations de VirtualHost</a></li><li><a href="#comments_section">Commentaires</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="namevip" id="namevip">Serveurs virtuels par nom vs. par IP</a></h2>
<p>Les <a href="ip-based.html">serveurs virtuels</a> par IP utilisent l'adresse IP
de la connexion afin de déterminer quel serveur virtuel doit
répondre. Par conséquent, vous devez disposer d'adresses IP
différentes pour chaque serveur.</p>
<p>Avec un hébergement
virtuel par nom, le serveur s'appuie sur les informations
transmises par le client dans les en-têtes HTTP de ses requêtes.
La technique présentée ici vous permet de disposer de serveurs
virtuels différents partagés sur une même adresse IP.</p>
<p>L'hébergement virtuel par nom est habituellement plus simple,
car il vous suffit de configurer votre serveur DNS pour que
chaque domaine pointe sur l'adresse IP dont vous disposez, et de
configurer votre serveur Apache HTTP afin qu'il reconnaisse
ces domaines. Il réduit aussi la pénurie en adresses IP. Par
conséquent, vous devriez utiliser l'hébergement virtuel par
nom, sauf dans le cas où vous utiliseriez des équipements qui
nécessitent un hébergement basé sur IP. Les raisons historiques de
l'hébergement basé sur IP dans un but de support de certains clients ne
s'appliquent plus à un serveur web d'usage général.</p>
<p>La sélection du serveur virtuel en fonction du nom s'opère en
dehors de l'algorithme de sélection du serveur virtuel en fonction
de l'adresse IP, ce qui signifie que les recherches du point de vue
du nom du serveur ne s'effectuent que parmi le jeu de serveurs
virtuels pour lesquels la correspondance avec la paire adresse
IP/port est la plus exacte.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="alg" id="alg">Comment le serveur sélectionne-t-il le serveur
virtuel basé sur le nom approprié</a></h2>
<p>Il est important de savoir que la première étape de la résolution
de serveur virtuel basée sur le nom est une résolution basée sur IP.
La résolution de serveur virtuel basée sur le nom ne fait que
choisir le serveur virtuel basé sur le nom le plus approprié, en se
limitant aux candidats qui conviennent le mieux du point de vue IP.
La résolution basée sur IP est sans objet si l'on
utilise un caractère générique (*) pour l'adresse IP dans
toutes les directives VirtualHost.</p>
<p>A l'arrivée d'une requête, le serveur va rechercher l'argument de
section <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> présentant la meilleure
(la plus exacte) correspondance avec la paire adresse IP/port
utilisée dans la requête. Si plusieurs serveurs virtuels possèdent
cette même paire adresse IP/port, Apache va ensuite comparer les
valeurs des directives <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> et <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> avec le nom de serveur
présent dans la requête.</p>
<p>Si vous ne définissez pas de directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> pour un serveur virtuel à base
de nom, le serveur utilisera par défaut le nom de domaine
entièrement qualifié (FQDN) déduit du nom d'hôte système. Cette
configuration sans nom de serveur explicite peut conduire à des
erreurs de choix du serveur virtuel à utiliser et est déconseillée.</p>
<h3><a name="defaultvhost" id="defaultvhost">Le serveur virtuel à base de nom
par défaut pour une paire adresse IP/port</a></h3>
<p>Si aucune directive ServerName ou ServerAlias ne correspond dans
la liste de serveurs virtuels présentant la meilleure correspondance
du point de vue adresse IP/port, c'est <strong>le premier serveur
virtuel de cette liste</strong> qui sera utilisé.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="using" id="using">Utilisation de serveurs virtuels par nom</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li><li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>La première étape consiste à créer une section
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
pour chacun des serveurs à définir. Dans chaque section
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>,
vous devez définir au minimum une directive
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> pour désigner
le serveur concerné et une directive
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> pour préciser
l'emplacement sur le système de fichiers du contenu de ce serveur.</p>
<div class="note"><h3>Le serveur principal disparaît</h3>
<p>Toute requête qui ne correspond à aucune section <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> existante
est traitée avec la configuration du serveur principal, sans
tenir compte du nom d'hôte ou de la directive ServerName.</p>
<p>Lorsque vous ajoutez un serveur virtuel basé sur le nom à un
serveur existant, et si les caractéristiques de ce serveur
virtuel correspondent à des combinaisons IP/port préexistantes,
les requêtes seront alors traitées par un serveur virtuel
explicite. Dans ce cas, il est en général judicieux de créer un
<a href="#defaultvhost">serveur virtuel par défaut</a>
comportant une directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> correspondant au nom du
serveur principal. De nouveaux domaines sur les mêmes interface
et port, mais nécessitant des configurations distinctes,
pourront alors être ajoutés en tant que serveurs virtuels
spécifiques (et non par défaut).</p>
</div>
<div class="note"><h3>Héritage du nom de serveur</h3>
<p>Il est toujours préférable de définir une directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> au niveau de chaque serveur
virtuel à base de nom. Si un serveur virtuel ne définit pas
de directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>, le
nom de ce serveur virtuel sera hérité du serveur principal. Si
aucun nom de serveur n'a été explicitement défini au niveau du
serveur principal, le serveur tentera de déterminer son nom via
une résolution de nom DNS inverse sur la première adresse
d'écoute. Dans tous les cas, ce nom de serveur hérité influencera
la sélection du serveur virtuel à base de nom, c'est pourquoi il
est toujours préférable de définir une directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> pour chaque serveur virtuel
à base de nom.</p>
</div>
<p>Par exemple, supposez que vous hébergez le domaine
<code>www.example.com</code> et que vous souhaitez ajouter le
serveur virtuel <code>other.example.com</code> qui pointe sur
la même adresse IP. Il vous suffit d'ajouter la configuration
suivante à <code>httpd.conf</code> :</p>
<pre class="prettyprint lang-config"><VirtualHost *:80>
# Le premier serveur virtuel de la liste est aussi le
# serveur par défaut pour *:80
ServerName www.example.com
ServerAlias example.com
DocumentRoot "/www/domain"
</VirtualHost>
<VirtualHost *:80>
ServerName other.example.com
DocumentRoot "/www/otherdomain"
</VirtualHost></pre>
<p>Autrement, vous pouvez spécifiez une adresse IP explicite
à la place de <code>*</code> dans la directive
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>.
Par exemple, cette méthode est utile si vous souhaitez faire
tourner quelques serveurs virtuels par nom sur une même adresse
IP, et d'autres, soit par IP, soit basés sur un autre jeu de
serveurs virtuels par nom sur une autre adresse IP.</p>
<p>Plusieurs serveurs sont accessibles par plus d'un nom. Il
suffit de placer la directive
<code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> dans une section
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>.
Par exemple, dans la première section
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
ci-dessus, la directive <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>
indique aux utilisateurs les autres noms permis pour accéder au
même site Web :</p>
<pre class="prettyprint lang-config">ServerAlias example.com *.example.com</pre>
<p>ainsi, toutes les requêtes portant sur un domaine
<code>example.com</code> seront servies par le serveur virtuel
<code>www.example.com</code>. Les caractères joker <code>*</code>
et <code>?</code> peuvent être utilisés pour les correspondances.
Bien entendu, vous ne pouvez pas inventer des noms et les placer
dans une directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>
ou <code>ServerAlias</code>. Tout d'abord, votre serveur DNS
doit être correctement configuré pour lier ces noms à une
adresse IP associée avec votre serveur.</p>
<p>La recherche du serveur virtuel à base de nom qui correspond au
plus près à la requête s'effectue parmi les <code class="directive"><a href="../mod/core.html#virtualhost"><virtualhost></a></code> selon leur
ordre d'apparition dans le fichier de configuration. Le premier
serveur virtuel dont le <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> ou le <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> correspond est utilisé, sans
priorité particulière en cas de présence de caractères génériques
(que ce soit pour le ServerName ou le ServerAlias).</p>
<p>La liste complète des noms dans la section <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> sont traités comme une
directive <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> sans
caractères génériques.</p>
<p>Finalement, vous pouvez affiner la configuration des serveurs
virtuels en plaçant d'autres directives à l'intérieur des sections
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>.
La plupart des directives peut être placée dans ces sections en
y changeant seulement la configuration du serveur virtuel associé.
Pour déterminer si une directive particulière est permise,
consultez le <a href="../mod/directive-dict.html#Context">contexte</a> de la
directive. Le jeu de directives configurées dans le contexte
du <em>serveur principal</em> (en dehors de toutes sections
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>)
sera utilisé seulement s'il n'y a pas de configuration contraire
par un serveur virtuel.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/name-based.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/index.html.en 0000664 0001751 0001751 00000017504 14737241666 021002 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache Virtual Host documentation - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache Virtual Host documentation</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>The term <cite>Virtual Host</cite> refers to the practice of
running more than one web site (such as
<code>company1.example.com</code> and <code>company2.example.com</code>)
on a single machine. Virtual hosts can be "<a href="ip-based.html">IP-based</a>", meaning that you have a
different IP address for every web site, or "<a href="name-based.html">name-based</a>", meaning that you have
multiple names running on each IP address. The fact that they
are running on the same physical server is not apparent to the
end user.</p>
<p>Apache was one of the first servers to support IP-based
virtual hosts right out of the box. Versions 1.1 and later of
Apache support both IP-based and name-based virtual hosts
(vhosts). The latter variant of virtual hosts is sometimes also
called <em>host-based</em> or <em>non-IP virtual hosts</em>.</p>
<p>Below is a list of documentation pages which explain all
details of virtual host support in Apache HTTP Server:</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#support">Virtual Host Support</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#directives">Configuration directives</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li><li><a href="name-based.html">Name-based virtual
hosts</a></li><li><a href="ip-based.html">IP-based virtual hosts</a></li><li><a href="examples.html">Virtual host examples</a></li><li><a href="fd-limits.html">File descriptor limits</a></li><li><a href="mass.html">Mass virtual hosting</a></li><li><a href="details.html">Details of host matching</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="support" id="support">Virtual Host Support</a></h2>
<ul>
<li><a href="name-based.html">Name-based Virtual Hosts</a> (More
than one web site per IP address)</li>
<li><a href="ip-based.html">IP-based Virtual Hosts</a> (An IP
address for each web site)</li>
<li><a href="examples.html">Virtual Host examples for common
setups</a></li>
<li><a href="fd-limits.html">File Descriptor Limits</a> (or,
<em>Too many log files</em>)</li>
<li><a href="mass.html">Dynamically Configured Mass Virtual
Hosting</a></li>
<li><a href="details.html">In-Depth Discussion of Virtual Host
Matching</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="directives" id="directives">Configuration directives</a></h2>
<ul>
<li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li>
<li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li>
</ul>
<p>If you are trying to debug your virtual host configuration, you
may find the <code>-S</code> command line switch
useful.</p>
<div class="example"><h3>Unix example</h3><p><code>
apachectl -S
</code></p></div>
<div class="example"><h3>Windows example</h3><p><code>
httpd.exe -S
</code></p></div>
<p>This command will dump out a description of how Apache parsed
the configuration file. Careful examination of the IP addresses and
server names may help uncover configuration mistakes. (See
the docs for the <code class="program"><a href="../programs/httpd.html">httpd</a></code> program for
other command line options)</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/details.html.tr.utf8 0000664 0001751 0001751 00000046207 14743132254 022217 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Sanal Konak Eşlemenin Derinliğine İncelenmesi - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Sanal Konaklar</a></div><div id="page-content"><div id="preamble"><h1>Sanal Konak Eşlemenin Derinliğine İncelenmesi</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/vhosts/details.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/details.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/details.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/details.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belgede, bir istek aldığında Apache’nin hangi sanal konak
ile hizmet sunacağına nasıl karar verdiği açıklanmaya çalışılmıştır.</p>
<p>Çoğu kullanıcı hangi türü kullanacağına karar vermek için önce <a href="name-based.html#namevip">İsme dayalı ve IP’ye dayalı Sanal
Konak</a> bölümünü, sonra <a href="name-based.html">İsme Dayalı Sanal
Konak Desteği</a> veya <a href="ip-based.html">IP’ye Dayalı Sanal Konak
Desteği</a> belgesini okumalı ve <a href="examples.html">bazı
örneklere</a> göz atmalıdır.</p>
<p>Bunlardan sonra tüm ayrıntıları anlamak isterseniz tekrar bu sayfaya
gelebilirsiniz.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#configparsing">Yapılandırma Dosyası</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#hostmatching">Sanal Konağın Belirlenmesi</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#tips">İpuçları</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="ip-based.html">IP’ye Dayalı Sanal Konak Desteği</a></li><li><a href="name-based.html">İsme Dayalı Sanal Konak Desteği</a></li><li><a href="examples.html">Çok Kullanılan Sanal Konak Örnekleri</a></li><li><a href="mass.html">Devingen olarak Yapılandırılan Kitlesel Sanal Barındırma</a></li><li><a href="#comments_section">Yorumlar</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="configparsing" id="configparsing">Yapılandırma Dosyası</a></h2>
<p>Bu belgede <code><VirtualHost></code> bölümleri dışında kalan
tanımlardan bahsederken <em>ana_sunucu</em> diyeceğiz.</p>
<p><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
bölümlerindeki tanımlamalardan bahsederken <em>sankonlar</em>
diyeceğiz.</p>
<p>Her <code>VirtualHost</code> bölümü en az bir adres ve isteğe bağlı
portlar içerir.</p>
<p>Sanal konak tanımlarının içindeki IP adreslerinin yerine konak isimleri
kullanılabilir, fakat bunlar başlatma sırasında çözümleneceklerinden
çözümlemedeki bir başarısızlık bu sanal konak tanımlarının yoksayılması
ile sonuçlanacaktır. Bu bakımdan önerilmez.</p>
<p><code>VirtualHost</code> yönergesinde görünen her adresin seçimlik bir
portu olabilir. Eğer bir port belirtilmemişse, port olarak <code>*</code>
belirtilmiş gibi bütün portlar dinlenir.</p>
<p>(<code>VirtualHost</code> yönergesinde belirtilen port numaraları Apache
httpd'nin dinleyeceği port numaraları olarak yorumlanmaz, sadece bir
isteği işleme sokarken hangi <code>VirtualHost</code> bölümünün
seçileceğini belirlerler. Sunucunun dinleyeceği adresleri ve portları
belirtmek için <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>
yönergesini kullanın.)</p>
<p>Adreslerin tamamını (DNS sorgularındaki çoklu sonuçlar dahil) içeren
kümeye <em>sankonların adres kümesi</em> denir.</p>
<p>Apache httpd, bir IP adresi ve port birleşimi için en belirgin
eşleşmelerin listelendiği çok sayıdaki sanal konak arasında ayırdedici
olarak istemci tarafından sağlanan HTTP <code>Host</code> başlığını
kullanır.</p>
<p><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> yönergesi sunucu
tanımının içinde herhangi bir yerde görünebilirse de her göründüğü yerde
bir öncekini iptal eder. Hiç <code>ServerName</code> belirtilmemişse,
Apache httpd, sunucu ismini sunucunun IP adresinden saptamaya
çalışır.</p>
<p>Belli bir IP adresi ve port çifti için yapılandırma dosyasındaki ilk
isme dayalı sankon önemlidir, çünkü başka hiçbir sankonun ServerName veya
ServerAlias yönergesi ile eşleşmeyen bu adres ve port çifti için alınmış
tüm isteklerde bu sankon kullanılır. Ayrıca, sunucunun <a class="glossarylink" href="../glossary.html#servernameindication" title="sözlüğe bakınız">Sunucu İsmi Belirtimi</a>ni
desteklemediği durumlarda tüm SSL bağlantıları için bu sankon
kullanılır.</p>
<p><code>VirtualHost</code> içindeki isimlerin sırası (jokersiz) bir
<code>ServerAlias</code> gibi ele alınır (fakat hiçbir
<code>ServerAlias</code> yönergesi ile geçersiz kılınmaz).</p>
<p>Her sankon için bazı değerler öntanımlı olarak atanır. Bunların
başlıcaları:</p>
<ol>
<li>Sankon bir <code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>
yönergesi içermiyorsa,
<code class="directive"><a href="../mod/core.html#timeout">Timeout</a></code>,
<code class="directive"><a href="../mod/core.html#keepalivetimeout">KeepAliveTimeout</a></code>,
<code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code>,
<code class="directive"><a href="../mod/core.html#maxkeepaliverequests">MaxKeepAliveRequests</a></code>,
<code class="directive"><a href="../mod/mpm_common.html#receivebuffersize">ReceiveBufferSize</a></code> ve
<code class="directive"><a href="../mod/mpm_common.html#sendbuffersize">SendBufferSize</a></code> yönergeleri için
öntanımlı değerler ana_sunucudaki eşdeğerlerinden miras alınır. (Yani,
bu yönergeler için ana_sunucudaki son değerler miras alınır.)</li>
<li>Sankon için öntanımlı dizin erişim izinlerinin tanımlandığı "arama
öntanımlıları" ana_sunucununkilere katılır. Buna her modülün dizinlere
özgü yapılandırma bilgileri dahildir.</li>
<li>Her modülün ana_sunucudaki sunuculara özgü yapılandırmaları sankon
sunucusununkilerle katıştırılır.</li>
</ol>
<p>Esasen, ana_sunucu, sankon sunucularını oluştururken bir öntanımlılar
listesi veya öntanımlı değerlere dayanak noktası olarak ele alınır.
Fakat bu ana_sunucu tanımlarının yapılandırma dosyasındaki yerlerinin
saptanmasının konumuzla ilgisi yoktur; ana_sunucu yapılandırmasının
tamamı son katıştırma yapılacağı zaman çözümlenir. Bu bakımdan,
ana_sunucu tanımlarından bir kısmı sankon tanımlarından sonra yer alsa
bile sankon tanımlarında etkili olabilir.</p>
<p>Eğer, bu noktada ana_sunucu hiçbir <code>ServerName</code> satırı
içermiyorsa <code class="program"><a href="../programs/httpd.html">httpd</a></code> programının çalıştığı makinenin
konak ismi öntanımlıdır. Ana_sunucunun <code>ServerName</code> için
yaptığı DNS sorgusundan dönen IP adreslerine <em>ana_sunucu adres
kümesi</em> diyoruz.</p>
<p>Tanımsız <code>ServerName</code> alanları için bir isme dayalı sankon,
sankonu tanımlayan <code>VirtualHost</code> yönergesinde belirtilen ilk
adresi öntanımlı değer kabul eder.</p>
<p>Sihirli <code>_default_</code> sankonları için ana_sunucunun
<code>ServerName</code> değeri kullanılır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="hostmatching" id="hostmatching">Sanal Konağın Belirlenmesi</a></h2>
<p>Sunucu bir istek durumunda hangi sankonun kullanılacağını şöyle
belirler:</p>
<h3><a name="hashtable" id="hashtable">IP adresi aranır</a></h3>
<p>Bir adres ve port için bağlantı ilk alındığında Apache httpd tüm
<code>VirtualHost</code> tanımlarında bu çifti arar.</p>
<p>Arama başarısız olursa <code>*</code> (herşey) eşleşmelerine
bakılır.</p>
<p>Bir eşleşme bulunamazsa hizmet ana sunucudan sunulur.</p>
<p>Arama sonucunda bu IP adresi için bulunmuş <code>VirtualHost</code>
tanımları varsa sonraki adım hizmetin bir IP’ye dayalı sankondan mı yoksa
isme dayalı bir sankondan mı sunulacağına karar vermektir.</p>
<h3><a name="ipbased" id="ipbased">IP’ye dayalı sankon</a></h3>
<p>Eğer en iyi eşleşme olarak saptanmış IP adresi ve port çiftini içeren
sadece bir <code>VirtualHost</code> yönergesi varsa artık karar vermek
için başka bir şey yapmaya gerek yoktur ve istek bu sankondan
sunulur.</p>
<h3><a name="namebased" id="namebased">İsme dayalı sankon</a></h3>
<p>Eğer en iyi eşleşme olarak saptanmış IP adresi ve port çiftini içeren
birden fazla <code>VirtualHost</code> yönergesi varsa, sonraki
adımlardaki "liste" eşleşen sankonların listesi olup sankonlar listede
yapılandırma dosyasındaki yerlerine göre sıralanırlar.</p>
<p>Bağlantı SSL kullanıyorsa, sunucunun <a class="glossarylink" href="../glossary.html#servernameindication" title="sözlüğe bakınız">Sunucu İsmi Belirtimi</a>ni
desteklediği durumlarda SSL istemci uzlaşımı, istenen konak ismiyle
birlikte TLS eklentisini de içeriyorsa, konak ismi, SSL olmayan
bağlantılardaki <code>Host:</code> başlığı kullanımına benzer şekilde
aşağıdaki gibi kullanılır. Aksi takdirde, SSL bağlantıları için adresin
eşleştiği ilk isme dayalı sankon kullanılır. Sunucunun bağlantı için
hangi sertifikayı kullanacağını sankon belirlediği için bu önemlidir.</p>
<p>İstek bir <code>Host:</code> başlık alanı içeriyorsa, listede
<code>ServerName</code> veya <code>ServerAlias</code> alanı başlık alanı
ile eşleşen ilk sankona bakılır. <code>Host:</code> alanı bir port
içerebilirse de Apache httpd bunu yoksayarak daima istemcinin isteği
gönderdiği portu gerçek port kabul eder.</p>
<p>Yapılandırma dosyasındaki belirtilen IP adresiyle eşleşen ilk sankon en
yüksek önceliğe sahiptir ve sunucu ismi bilinmeyen ve (bir HTTP/1.0
isteği gibi) <code>Host:</code> başlık alanı içermeyen istekleri de
yakalar.</p>
<h3><a name="persistent" id="persistent">Kalıcı bağlantılar</a></h3>
<p>Yukarıda açıklanan <em>IP araması</em> belli bir TCP/IP oturumunda
<em>bir</em> defaya mahsus yapıldığı halde bir kalıcı/KeepAlive bağlantı
sırasında <em>her</em> istek için ayrı bir <em>arama</em> yapılır. Başka
bir deyişle, bir istemci tek bir kalıcı bağlantı üzerinde farklı isme
dayalı sankonlardan sayfa talebinde bulunabilir.</p>
<h3><a name="absoluteURI" id="absoluteURI">Mutlak URI</a></h3>
<p>Eğer istekte belirtilen URI bir mutlak URI ise ve istek yapılan konak
ismi ve port ana sunucuyla veya sankonlardan biriyle eşleşiyorsa,
şema/konakadı/port öneki ayrılır ve elde edilen göreli URI ilgili
sankondan veya ana sunucudan sunulur. Eğer bir eşleşme sağlanamazsa
URI’ye dokunulmaz ve istek bir vekil isteği olarak ele alınır.</p>
<h3><a name="observations" id="observations">İzlenimler</a></h3>
<ul>
<li>İsme dayalı sanal konak işlemleri, sunucunun en iyi eşleşen IP'ye
dayalı sanal konağı seçmesinin ardından uygulanır.</li>
<li>İstemcinin hangi IP adresine bağlandığını umursamıyorsanız, sanal
konaklarınızda adres olarak "*" kullanın, böylece yapılandırılmış
sankonların hepsine isme dayalı sanal konak işlemleri uygulanır.</li>
<li>Bir IP’ye dayalı sankon için asla <code>ServerAlias</code> ve
<code>ServerPath</code> değerine bakılmaz.</li>
<li>Sıralama sadece aynı IP adresine sahip isme dayalı sankonlar arasında
önemlidir. Aynı adres kümesine mensup isme dayalı sankonlardan
yapılandırma dosyasında ilk sırada yer alanı en yüksek önceliğe
sahiptir.</li>
<li>Eşleştirme işlemi sırasında <code>Host:</code>
başlık alanında belirtilen port asla kullanılmaz. Apache httpd daima
istemcinin isteği gönderdiği gerçek portu kullanır.</li>
<li>Eğer aynı IP adresine sahip IP’ye dayalı iki sankon varsa, bunlara
örtük olarak isme dayalı sanal konak işlemleri uygulanır. 2.3.11
sürümünden beri yeni davranış şekli budur.</li>
<li>Ana_sunucunun bir isteğe hizmet sunabilmesi için istemcinin
bağlandığı IP adresi ve port hiçbir yerde belirtilmemiş ve
hiçbir sankon ile eşleşme sağlanamamış olmalıdır. Başka bir deyişle,
istemcinin bağlandığı port ile eşleşen bir <code>_default_</code>
sankon olmadıkça adres ve port belirtmeyen bir isteğe ana_sunucu yanıt
verecektir.</li>
<li><code>VirtualHost</code> yönergelerinde asla DNS isimleri
belirtmemelisiniz. Aksi takdirde sunucuyu başlatma sırasında DNS
sorgusu yapmaya zorlamış olursunuz. Listelenen tüm alanlar için DNS
üzerinde tam denetime sahip değilseniz bu ayrıca bir güvenlik
tehdidine yol açar. Bu konuda daha ayrıntılı bilgi edinmek için <a href="../dns-caveats.html">DNS ile ilgili konular ve Apache</a>
belgesine bakınız.</li>
<li><code>ServerName</code> her sankon için ayrı ayrı belirlenmiş
olmalıdır. Aksi takdirde her sankon için bir DNS sorgusu gerekir.</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="tips" id="tips">İpuçları</a></h2>
<p><a href="../dns-caveats.html#tips">DNS konuları</a> sayfasındaki
ipuçlarına ilaveten burada da bazı ipuçları bulacaksınız:</p>
<ul>
<li>Ana sunucu tanımlarının hepsini <code>VirtualHost</code>
tanımlarının öncesinde bitirin. Bu ayrıca yapılandırmanızın
okunabilirliğini de arttırır; <code>VirtualHost</code> tanımlarının
sonrasına sarkan yapılandırmaların katıştırılması işlemi tüm sanal
konakları etkileyebilen tanımlar bakımından bir
karışıklığa/belirsizliğe sebep olabilir.)</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/vhosts/details.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/details.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/vhosts/details.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/details.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/details.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/fd-limits.html.ja.utf8 0000664 0001751 0001751 00000024441 14743132254 022423 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ファイル記述子の限界 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">バーチャルホスト</a></div><div id="page-content"><div id="preamble"><h1>ファイル記述子の限界</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/vhosts/fd-limits.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/fd-limits.html" title="Japanese"> ja </a> |
<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/fd-limits.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>たくさんのバーチャルホストを運用する場合、もし、
各バーチャルホストごとに異なるログファイルが指定してあると、
Apache がファイル記述子 (<cite>ファイルハンドル</cite>とも呼ばれます)
を使い切ってしまうことがあります。Apache が使用するファイル
記述子の数は、各エラーログファイルにつき 1 つ、他のログファイルの
ディレクティブにつき 1 つ、さらに内部で使用する 10 から 20、
の合計になります。Unix オペレーティングシステムではプロセスごとに
使用可能なファイル記述子の数を制限しています。たいていの場合は 64 で、
普通は大きな値のハードリミットまで増やすことができます。</p>
<p>Apache は必要に応じて上限を拡大しようと試みますが、
以下のような場合にはうまくいかないかもしれません。</p>
<ol>
<li>利用しているシステムで <code>setrlimit()</code>
システムコールが提供されていない。</li>
<li>システム上で <code>setrlimit</code>(RLIMIT_NOFILE) が動作しない
(たとえば Solaris 2.3 のように)。</li>
<li>要求されるファイル記述子の数が
ハードリミットを超えてしまう。</li>
<li>システムにファイル記述子に関して別の制限が存在してしまっている。
たとえば、stdio ストリームではファイル記述子を 256 以上使えない
(Solaris 2)、など。</li>
</ol>
<p>問題が発生した時に取り得る対処方法は次のとおり:</p>
<ul>
<li>ログファイルの数を減らす。<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
セクションでログファイルを指定せず、メインのログファイルにのみ記録する。
(これに関する詳しい情報は以下の<a href="#splitlogs">ログファイルの分割</a>を読んでください。)</li>
<li>
もし、前述の 1 または 2 の場合であれば、
Apache を起動する前にファイル記述子を増やします。
たとえば次のようなスクリプトを使います。
<div class="example"><p><code>
<code>#!/bin/sh<br />
ulimit -S -n 100<br />
exec httpd</code>
</code></p></div>
</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="splitlogs" id="splitlogs">ログファイルの分割</a></h2>
<p>複数のバーチャルホストのログを同じログファイルに収集しようとしているときには、
各バーチャルホストについて統計的な解析を実行するために後でログファイルを
分割したくなるかもしれません。これは以下のようにして実現できます。</p>
<p>まず、バーチャルホストの情報をログのエントリに追加する必要があります。
これは <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code>
ディレクティブの <code>%v</code> 変数を使うことでできます。
これをログのフォーマット文字列の先頭に追加します:</p>
<div class="example"><p><code>
LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost<br />
CustomLog logs/multiple_vhost_log vhost
</code></p></div>
<p>これは common log format のログを作成しますが、それぞれの行の先頭に
正規化されたバーチャルホストの名前
(<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>
ディレクティブに書かれているもの) が付加されます。
(ログファイルのカスタマイズの詳細については <a href="../mod/mod_log_config.html#formats">Custom Log Formats</a> を
読んでください。)</p>
<p>ログファイルを各部分 (バーチャルホスト毎に 1 ファイル) に分けたいときは、
<code><a href="../programs/other.html">split-logfile</a></code>
を使って行なうことができます。プログラムは Apache 配布の
<code>support</code> ディレクトリにあります。</p>
<p>以下のようなコマンドでこのプログラムを実行します:</p>
<div class="example"><p><code>
split-logfile < /logs/multiple_vhost_log
</code></p></div>
<p>このプログラムはバーチャルホストのログファイルの名前とともに実行され、
ログファイルに現れるそれぞれのバーチャルホスト毎に一つのファイルを作成します。
それぞれのファイルは <code>ホスト名.log</code> という名前になります。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/vhosts/fd-limits.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/fd-limits.html" title="Japanese"> ja </a> |
<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/fd-limits.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/fd-limits.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/index.html.ko.euc-kr 0000664 0001751 0001751 00000017037 14743132254 022164 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ġ ȣƮ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>ġ ȣƮ </h1>
<div class="toplang">
<p><span> : </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><cite>ȣƮ (Virtual Host)</cite> ǻͿ
Ʈ ( , <code>www.company1.com</code>
<code>www.company2.com</code>) Ѵ.
ȣƮ Ʈ ٸ IP ּҸ ϴ
"<a href="ip-based.html">IP (IP-based)</a>" İ
IP ּҴ ̸ "<a href="name-based.html"≯ (name-based)</a>"
ִ. Ʈ ִٴ ڴ
ġä Ѵ.</p>
<p>ġ ⺻ IP ȣƮ â
ϳ. ġ 1.1 ̻ IPݰ ̸
ȣƮ Ѵ. ̸ ȣƮ
<em>ȣƮ (host-based)</em> Ǵ <em>IP ȣƮ
(non-IP virtual hosts)</em> θ.</p>
<p> ġ 1.3 ̻ ȣƮ ڼ
̴.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#support">ȣƮ </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#directives"> þ</a></li>
</ul><h3></h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li><li><a href="name-based.html"≯ ȣƮ</a></li><li><a href="ip-based.html">IP ȣƮ</a></li><li><a href="examples.html">ȣƮ </a></li><li><a href="fd-limits.html">ϱ Ѱ</a></li><li><a href="mass.html">뷮 ȣƮ</a></li><li><a href="details.html">ȣƮ ã ڼ </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="support" id="support">ȣƮ </a></h2>
<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">ϱ(file descriptor)
Ѱ</a> (, <em>ʹ α</em>)</li>
<li><a href="mass.html">뷮 ȣƮ
ϱ</a></li>
<li><a href="details.html">ȣƮ ã ڼ
</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="directives" id="directives"> þ</a></h2>
<ul>
<li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li>
<li><code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code></li>
<li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li>
<li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li>
</ul>
<p>ȣƮ ƮҶ ġ <code>-S</code>
ɼ ϴ. , Ѵ:</p>
<div class="example"><p><code>
/usr/local/apache2/bin/httpd -S
</code></p></div>
<p> ɾ ġ Ͽ
Ѵ. IP ּҿ ڼ 캸
Ǽ ߰ϴµ ̴. (ٸ ɼǵ
<a href="../programs/httpd.html">httpd α </a>
϶.)</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/" title="Korean"> ko </a> |
<a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/ip-based.html.ko.euc-kr 0000664 0001751 0001751 00000026340 14743132254 022536 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ġ IP ȣƮ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">ȣƮ</a></div><div id="page-content"><div id="preamble"><h1>ġ IP ȣƮ </h1>
<div class="toplang">
<p><span> : </span><a href="../en/vhosts/ip-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/ip-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/ip-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/ip-based.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/ip-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#requirements">ý 䱸</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#howto">ġ </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multiple"> ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#single"> ϳ ȣƮ ϱ</a></li>
</ul><h3></h3><ul class="seealso"><li>
<a href="name-based.html"≯ ȣƮ </a>
</li><li><a href="#comments_section">Comments</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="requirements" id="requirements">ý 䱸</a></h2>
<p><cite>IP</cite>̶ ǹϵ
<strong>IP ȣƮ ٸ IP ּҸ
Ѵ</strong>. ̴ ǻ Ʈ
ϰų, ֱ ü ϴ ̽
(ڼ ý ϶. "ip aliases"
ϸ, "ifconfig" ɾ ) Ͽ ϴ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="howto" id="howto">ġ </a></h2>
<p> ȣƮ ϵ ġ ϴ ΰ.
ϳ ȣƮ ϴ
̰, ٸ ϳ ȣƮ ϴ Ѱ
ϴ ̴.</p>
<p> ϳ:</p>
<ul>
<li>ȸ2 ڰ ̿ ȸ1 ڷḦ
ϴ Ȼ ʿ .
ٸ <code class="directive"><a href="../mod/mpm_common.html#user">User</a></code>, <code class="directive"><a href="../mod/mpm_common.html#group">Group</a></code>, <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>, <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> ؾ Ѵ.</li>
<li> ְ, ǻ IP ٸ
ϱ(file descriptor) 䱸 Ѵ. "ϵī"
Ư ּҸ <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> ִ.
Ư ּҸ ٸ ʿ䰡 ִٸ, (
ּҸ ּҸ ٸ ٸ
ּҸ ٸ ) ּ
θ ٷ Ѵ.</li>
</ul>
<p> Ѱ ϳ:</p>
<ul>
<li>ȣƮ ִ .</li>
<li>ǻͰ ſ û Ѵٸ
ϱ ӵ ս Ŭ ִ.</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="multiple" id="multiple"> ϱ</a></h2>
<p> ȣƮ ġѴ.
<code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> þ
IP ּ(Ȥ ȣƮ) ش.
,</p>
<div class="example"><p><code>
Listen www.smallco.com:80
</code></p></div>
<p>ȣƮ ٴ IP ּҸ ϱ ٶ.
(<a href="../dns-caveats.html">DNS </a> )</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="single" id="single"> ϳ ȣƮ ϱ</a></h2>
<p> Ѱ ּ ȣƮ
û Ѵ. <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> þ ȣƮ
ٸ <code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>,
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>, <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, <code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code>, <code class="directive"><a href="../mod/mod_log_config.html#transferlog">TransferLog</a></code>,
<code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code>
þ Ѵ. ,</p>
<div class="example"><p><code>
<VirtualHost www.smallco.com><br />
ServerAdmin webmaster@mail.smallco.com<br />
DocumentRoot /groups/smallco/www<br />
ServerName www.smallco.com<br />
ErrorLog /groups/smallco/logs/error_log<br />
TransferLog /groups/smallco/logs/access_log<br />
</VirtualHost><br />
<br />
<VirtualHost www.baygroup.org><br />
ServerAdmin webmaster@mail.baygroup.org<br />
DocumentRoot /groups/baygroup/www<br />
ServerName www.baygroup.org<br />
ErrorLog /groups/baygroup/logs/error_log<br />
TransferLog /groups/baygroup/logs/access_log<br />
</VirtualHost>
</code></p></div>
<p>ȣƮ ٴ IP ּҸ ϱ ٶ.
(<a href="../dns-caveats.html">DNS </a> )</p>
<p>VirtualHost þ ȿ μ Ÿ þ
ϰ <strong></strong> þ
ִ. VirtualHost þ ȿ þ ִ
˷ <a href="../mod/directives.html">þ </a>
<a href="../mod/directive-dict.html#Context"></a>
Ȯ϶.</p>
<p><a href="../suexec.html">suEXEC α</a>
Ѵٸ VirtualHost þ ȿ <code class="directive"><a href="../mod/mpm_common.html#user">User</a></code> <code class="directive"><a href="../mod/mpm_common.html#group">Group</a></code> ִ.</p>
<p><em>:</em> ϴ ڿܿ ٸ
α ִ 丮 ִٸ
϶. ڼ <a href="../misc/security_tips.html"> </a> ϶.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/vhosts/ip-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/ip-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/ip-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/ip-based.html" title="Korean"> ko </a> |
<a href="../tr/vhosts/ip-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/ip-based.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/name-based.html.ja.utf8 0000664 0001751 0001751 00000056251 14743132254 022533 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>名前ベースのバーチャルホスト - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">バーチャルホスト</a></div><div id="page-content"><div id="preamble"><h1>名前ベースのバーチャルホスト</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>この文書では名前ベースのバーチャルホストをどんなとき、
どうやって使うかを説明します。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#namevip">名前ベースと IP ベースのバーチャルホストの比較</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#using">名前ベースのバーチャルホストを利用する</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#compat">古いブラウザとの互換性</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="ip-based.html">ネームベースのバーチャルホスト</a></li><li><a href="details.html">バーチャルホストのマッチングについての詳細</a></li><li><a href="mass.html">大量のバーチャルホストの動的な設定</a></li><li><a href="examples.html">バーチャルホストの一般的な設定例</a></li><li><a href="examples.html#serverpath">ServerPath 設定例</a></li><li><a href="#comments_section">コメント</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="namevip" id="namevip">名前ベースと IP ベースのバーチャルホストの比較</a></h2>
<p>IP ベースのバーチャルホストでは、応答する
バーチャルホストへのコネクションを決定するために IP
アドレスを使用します。ですから、それぞれのホストに個々に IP
アドレスが必要になります。これに対して名前ベースのバーチャルホストでは、
クライアントが HTTP ヘッダの一部としてホスト名を告げる、
ということに依存します。この技術で同一 IP
アドレスを異なる多数のホストで共有しています。</p>
<p>名前ベースのバーチャルホストは通常単純で、それぞれのホスト名と
それに対応する正確な IP アドレスを DNS で設定し、異なる
ホスト名を区別するように Apache HTTP サーバを設定するだけです。
さらに、名前ベースのバーチャルホストは不足する IP
アドレスの需要を緩和します。したがって、IP ベースのバーチャルホストを
選択すべき特定の理由がなければ名前ベースのバーチャルホストを使うべきです。
IP ベースのバーチャルホストを使用することを考慮する理由として、</p>
<ul>
<li>名前ベースのバーチャルホストに対応していない古いクライアントがある
名前ベースのバーチャルホストが働くためには、クライアントは
HTTP ホストヘッダを送ってこなければなりません。
これは HTTP/1.1 の仕様で要求されていて、すべての現代的な
HTTP/1.0 ブラウザでも拡張として実装されています。
とても古いクライアントをサポートしつつ、名前ベースの
バーチャルホストを行いたい場合は、この文書の最後の方に
書かれている解決策になるかもしれない方法を見てください。</li>
<li>名前ベースのバーチャルホストは SSL プロトコルの特徴により、
SSL セキュアサーバには使えません。</li>
<li>オペレーティングシステムやネットワーク装置のなかには、
別の IP アドレス上でない場合、複数のホストを別扱いできないような
帯域管理の方法を実装しているものがあります。</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="using" id="using">名前ベースのバーチャルホストを利用する</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code></li><li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li><li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li><li><code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code></li><li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>名前ベースのバーチャルホストを使うには、そのホストへの
リクエストを受け付けるサーバの IP アドレス (もしかしたらポートも)
を指定する必要があります。
これは <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>
ディレクティブで設定します。通常、<code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> で
<code>*</code> の属性を使ってサーバの全ての IP アドレスを使います。
(例えば SSL の使用などで) 複数のポートを使うことを計画しているのであれば、
引数に <code>*:80</code> のようにポートも含めるようにしてください。
<code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> ディレクティブで
IP アドレスを書いても、
自動的にサーバがその IP アドレスをリッスンするということはないことに
注意してください。詳細は「<a href="../bind.html">Apache の使うアドレスと
ポートを設定する</a>」を読んでください。さらに、ここで指定された
IP アドレスは全てサーバのネットワークインターフェースと関連付けられて
いなければなりません。</p>
<p>次は、扱うホストそれぞれに対して <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> ブロックを
作成してください。<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
ディレクティブの引数は <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>
ディレクティブの引数と同じにしてください (すなわち、IP アドレスか、全てのアドレスを意味する
<code>*</code>)。それぞれの <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
ディレクティブの中には、最低限、どのホストが扱われるかを示す <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> ディレクティブと、
そのホスト用のコンテンツがファイルシステム上のどこにあるかを示す
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> ディレクティブを
書く必要があります。</p>
<div class="note"><h3>メインホストはなくなります</h3>
<p>既にあるウェブサーバにバーチャルホストを追加する場合、
既存のウェブサーバに対しても <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
ブロックを作らなければなりません。このバーチャルホストの
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> と
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
は、グローバルな <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> と
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
と同じものにします。また、このバーチャルホストを設定ファイルの中で
先頭に置いて、デフォルトホストとして動作するようにします。</p>
</div>
<p>たとえば、<code>www.domain.tld</code> を動かしていて、
さらにバーチャルホスト <code>www.otherdomain.tld</code>
を追加するとしましょう。このバーチャルホストは同一 IP を指しているとします。
そのような場合は、<code>httpd.conf</code>
に以下のようなコードを追加するだけです</p>
<div class="example"><p><code>
NameVirtualHost *:80<br />
<br />
<VirtualHost *:80><br />
<span class="indent">
ServerName www.domain.tld<br />
ServerAlias domain.tld *.domain.tld<br />
DocumentRoot /www/domain<br />
</span>
</VirtualHost><br />
<br />
<VirtualHost *:80><br />
<span class="indent">ServerName www.otherdomain.tld<br />
DocumentRoot /www/otherdomain<br />
</span>
</VirtualHost><br />
</code></p></div>
<p><code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> 及び
<code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> のどちらの場合も、
* の部分には明示的に IP アドレスを指定することができます。
例えば、ある IP アドレスでは名前ベースのバーチャルホストを使いたい一方で、
別の IP アドレスでは、他の IP ベースのバーチャルホストや
別組の名前ベースのバーチャルホストを使いたい場合、
そう設定することになるでしょう。</p>
<p>複数の名前でサーバアクセスができるようにしたいことも多いでしょう。
このようなことは、<code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> ディレクティブを <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
セクションに記述することで実現できます。
例えば上記の <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> の例であれば、
次のように一覧に挙げられた名前が、
ユーザが同一のウェブサイトとして目にして使用できるサーバ名である、
と <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>
ディレクティブで指定できます。</p>
<div class="example"><p><code>
ServerAlias domain.tld *.domain.tld
</code></p></div>
<p><code>domain.tld</code> ドメインへの全てのホストへのリクエストは
<code>www.domain.tld</code> のバーチャルホストが処理します。
名前をマッチさせるために、ワイルドカード文字 * や ?
を使用することもできます。もちろん思いつきの名前を作って、
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> や
<code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>
にその名前を書くといったことはできません。まずは、
これらの名前が サーバに付けられた IP アドレスにマップされるように
DNS サーバを適切に設定しなければなりません。</p>
<p>最後に、<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> コンテナの中に
他のディレクティブを書くことで、バーチャルホストの設定を細かく調整
することができます。
ほとんどのディレクティブはこれらのコンテナに設置することができて、
変更点はそのバーチャルホストに対してのみ有効になります。
どのディレクティブを書くことができるかは、ディレクティブの <a href="../mod/directive-dist.html#context">コンテキスト</a> を
調べてください。<em>主サーバコンテキスト</em>
(<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
コンテナの外) の設定用ディレクティブはバーチャルホストでの設定で
上書きされない場合のみ使用されます。</p>
<p>リクエストが来ると、サーバはまず最初に <code class="directive"><a href="../mod/core.html#namevirtualhost"><NameVirtualHost></a></code>
にマッチする IP アドレスかどうかをチェックします。マッチすれば
マッチした IP アドレスの <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
のそれぞれのセクションの中から
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> か
<code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>
に要求されたホスト名があるか探します。
見つかればそのサーバ用の設定を使います。マッチするバーチャルホスト
が見つからなければ、マッチした IP アドレスの
<strong>リストの最初にあるバーチャルホスト</strong> が使われます。</p>
<p>結果として、リストの最初のバーチャルホストが <em>デフォルト</em> の
バーチャルホストになります。IP アドレスが <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>
ディレクティブにマッチした場合は、<em>メインのサーバ</em> の
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
は<strong>決して使われません</strong>
どのバーチャルホストにもマッチしないリクエストに対して、
特別な設定をしたいのであれば、設定ファイル中の最初の
<code><VirtualHost></code> コンテナにそれを記述してください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="compat" id="compat">古いブラウザとの互換性</a></h2>
<p>以前述べたように、名前ベースのバーチャルホストが正しく動作する
ために必要な情報を送ってこないクライアントが依然として存在しています。
そのようなクライアントに対しては、該当する IP アドレスについて、
一番最初に設定されているバーチャルホスト
(<cite>プライマリ</cite>の名前ベースのバーチャルホスト)
からページが送り返されます。</p>
<div class="note"><h3>どのぐらい古いの ?</h3>
<p>「古い」と表現している場合、本当に古いことを意味して使っています。
不幸にして今現在でもこのような古いブラウザに遭遇することがあります。
現在のブラウザは全て、名前ベースのバーチャルホストに必要な
<code>Host</code> ヘッダを送ります。</p>
</div>
<p><a href="../mod/core.html#serverpath"><code>ServerPath</code></a>
ディレクティブで対処が可能です。ちょっと不格好ですけれども。</p>
<p>設定例</p>
<div class="example"><p><code>
NameVirtualHost 111.22.33.44<br />
<br />
<VirtualHost 111.22.33.44><br />
<span class="indent">
ServerName www.domain.tld<br />
ServerPath /domain<br />
DocumentRoot /web/domain<br />
</span>
</VirtualHost><br />
</code></p></div>
<p>この例にはどういう意味があるでしょうか? これは
"<code>/domain</code>" で始まる URI へのリクエストはすべて、
バーチャルホスト <code>www.domain.tld</code> で処理される、
という意味です。つまり、すべてのクライアントで
<code>http://www.domain.tld/domain/</code> でアクセスできるページが、
<code>Host:</code> ヘッダを送ってくるクライアントであれば
<code>http://www.domain.tld/</code> としてもアクセスできる、
という意味です。</p>
<p>これが動作するようにするには、
プライマリのバーチャルホストのページに
<code>http://www.domain.tld/domain/</code> へのリンクを設置します。
そして、バーチャルホストのページでは、純粋な相対リンク (<em>例:</em>
"<code>file.html</code>" や "<code>../icons/image.gif</code>")、
あるいは <code>/domain/</code> で始まるリンク (<em>例:</em>
"<code>http://www.domain.tld/domain/misc/file.html</code>" や
"<code>/domain/misc/file.html</code>") だけを設置します。</p>
<p>これには、幾分かの規律が必要となりますが、
このようなガイドラインを忠実に守ることにより、たいていの場合、
すべてのブラウザで ― 新しいブラウザでも古いものでも ―
作成したページが見えるということを保証します。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/name-based.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/examples.html.fr.utf8 0000664 0001751 0001751 00000064633 14740503670 022376 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Exemples d'utilisations de VirtualHost - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Serveurs virtuels</a></div><div id="page-content"><div id="preamble"><h1>Exemples d'utilisations de VirtualHost</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/vhosts/examples.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/examples.html" title="Français"> fr </a> |
<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/examples.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Le but de ce document est d'essayer de répondre aux questions
les plus répandues sur la configuration des <a href="index.html">serveurs virtuels</a>.
Les scénarios présentés ici se rencontrent quand plusieurs
serveurs Webs doivent tourner sur une seule et même machine au
moyen de serveurs virtuels <a href="name-based.html">par nom</a>
ou <a href="ip-based.html">par IP</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#purename">Fonctionnement de plusieurs serveurs
virtuels par nom sur une seule adresse IP.</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#twoips">Serveurs virtuels par nom sur plus
d'une seule adresse IP.</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#intraextra">Servir le même contenu sur des
adresses IP différentes (telle qu'une adresse interne et une
externe).</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#port">Servir différents sites sur différents
ports.</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ip">Hébergement virtuel basé sur IP</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ipport">Hébergements virtuels mixtes basés sur
les ports et sur les IP</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mixed">Hébergements virtuels mixtes basé sur
les noms et sur IP</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#proxy">Utilisation simultanée de
<code>Virtual_host</code> et de mod_proxy</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#default">Utilisation de serveurs virtuels
<code>_default_</code></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#migrate">Migration d'un serveur virtuel
par nom en un serveur virtuel par IP</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#serverpath">Utilisation de la directive
<code>ServerPath</code></a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="purename" id="purename">Fonctionnement de plusieurs serveurs
virtuels par nom sur une seule adresse IP.</a></h2>
<p>Votre serveur possède plusieurs noms d'hôte qui correspondent à une seule
adresse IP, et vous souhaitez des réponses différentes si on demande
<code>www.example.com</code> ou <code>www.example.org</code>.</p>
<div class="note"><h3>Note :</h3><p>La configuration de serveurs virtuels
sous Apache ne provoque pas leur apparition magique dans la
configuration du DNS. Il <em>faut</em> que leurs noms soient
définis dans le DNS, et qu'ils y soient résolus sur l'adresse IP
du serveur, faute de quoi personne ne pourra visiter votre site Web.
Il est possible d'ajouter des entrées dans le fichier
<code>hosts</code> pour tests locaux, mais qui ne fonctionneront
que sur la machine possédant ces entrées.</p>
</div>
<pre class="prettyprint lang-config"># Apache doit écouter sur le port 80
Listen 80
<VirtualHost *:80>
DocumentRoot "/www/example1"
ServerName www.example.com
# Autres directives ici
</VirtualHost>
<VirtualHost *:80>
DocumentRoot "/www/example2"
ServerName www.example.org
# Autres directives ici
</VirtualHost></pre>
<p>Les astérisques correspondent à toutes les adresses, si bien que
le serveur principal ne répondra jamais à aucune requête. Comme le
serveur virtuel
<code>ServerName www.example.com</code> se trouve en premier dans le fichier
de configuration, il a la plus grande priorité et peut être vu
comme serveur <cite>par défaut</cite> ou <cite>primaire</cite> ;
ce qui signifie que toute requête reçue ne correspondant à aucune
des directives <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> sera servie par ce premier
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>.</p>
<p>La configuration ci-dessus correspond à ce que l'on souhaite pour
la plupart des serveurs virtuels à base de nom. Il faudra cependant
utiliser une configuration différente si vous souhaitez servir un
contenu différent en fonction de l'adresse IP ou du port.</p>
<div class="note">
<h3>Note :</h3>
<p>Vous pouvez remplacer <code>*</code>
par une adresse IP du système. Le serveur virtuel concerné
ne sera alors sélectionné que pour les requêtes HTTP vers
cette adresse IP.</p>
<p>En général, il est commode d'utiliser <code>*</code> sur
les systèmes dont l'adresse IP n'est pas constante - par
exemple, pour des serveurs dont l'adresse IP est attribuée
dynamiquement par le FAI, et où le DNS est géré au moyen
d'un DNS dynamique quelconque. Comme <code>*</code> signifie
<cite>n'importe quelle adresse</cite>, cette configuration
fonctionne sans devoir être modifiée quand l'adresse IP du
système est modifiée.</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="twoips" id="twoips">Serveurs virtuels par nom sur plus
d'une seule adresse IP.</a></h2>
<div class="note">
<h3>Note :</h3><p>Toutes les techniques présentées ici
peuvent être étendues à un plus grand nombre d'adresses IP.</p>
</div>
<p>Le serveur a deux adresses IP. Sur l'une
(<code>172.20.30.40</code>), le serveur "principal"
<code>server.example.com</code> doit répondre, et sur l'autre
(<code>172.20.30.50</code>), deux serveurs virtuels (ou plus)
répondront.</p>
<pre class="prettyprint lang-config">Listen 80
# Serveur "principal" sur 172.20.30.40
ServerName server.example.com
DocumentRoot "/www/mainserver"
<VirtualHost 172.20.30.50>
DocumentRoot "/www/example1"
ServerName www.example.com
# D'autres directives ici ...
</VirtualHost>
<VirtualHost 172.20.30.50>
DocumentRoot "/www/example2"
ServerName www.example.org
# D'autres directives ici ...
</VirtualHost></pre>
<p>Toute requête arrivant sur une autre adresse que
<code>172.20.30.50</code> sera servie par le serveur principal.
Les requêtes vers <code>172.20.30.50</code> avec un nom de serveur
inconnu, ou sans en-tête <code>Host:</code>, seront servies par
<code>www.example.com</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="intraextra" id="intraextra">Servir le même contenu sur des
adresses IP différentes (telle qu'une adresse interne et une
externe).</a></h2>
<p>La machine serveur dispose de deux adresses IP
(<code>192.168.1.1</code> et <code>172.20.30.40</code>). Cette
machine est placée à la fois sur le réseau interne (l'Intranet)
et le réseau externe (Internet). Sur Internet, le nom
<code>server.example.com</code> pointe vers l'adresse externe
(<code>172.20.30.40</code>), mais sur le réseau interne, ce même
nom pointe vers l'adresse interne (<code>192.168.1.1</code>).</p>
<p>Le serveur peut être configuré pour répondre de la même manière
aux requêtes internes et externes, au moyen d'une seule section
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>.</p>
<pre class="prettyprint lang-config"><VirtualHost 192.168.1.1 172.20.30.40>
DocumentRoot "/www/server1"
ServerName server.example.com
ServerAlias server
</VirtualHost></pre>
<p>Ainsi, les requêtes en provenance de chacun des deux réseaux
seront servies par le même <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>.</p>
<div class="note">
<h3>Note :</h3><p>Sur le réseau interne, il est possible
d'utiliser le nom raccourci <code>server</code> au lieu du nom
complet <code>server.example.com</code>.</p>
<p>Notez également que dans l'exemple précédent, vous pouvez
remplacer la liste des adresses IP par des <code>*</code> afin
que le serveur réponde de la même manière sur toutes ses
adresses.</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="port" id="port">Servir différents sites sur différents
ports.</a></h2>
<p>Vous disposez de plusieurs domaines pointant sur la même adresse
IP et vous voulez également servir de multiples ports. L'exemple
suivant montre que la sélection en fonction du nom intervient après
la sélection de la meilleure correspondance du point de vue adresse
IP/port.</p>
<pre class="prettyprint lang-config">Listen 80
Listen 8080
<VirtualHost 172.20.30.40:80>
ServerName www.example.com
DocumentRoot "/www/domain-80"
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
ServerName www.example.com
DocumentRoot "/www/domain-8080"
</VirtualHost>
<VirtualHost 172.20.30.40:80>
ServerName www.example.org
DocumentRoot "/www/otherdomain-80"
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
ServerName www.example.org
DocumentRoot "/www/otherdomain-8080"
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ip" id="ip">Hébergement virtuel basé sur IP</a></h2>
<p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code>
et <code>172.20.30.50</code>) correspondant respectivement aux noms
<code>www.example.com</code> et <code>www.example.org</code>.</p>
<pre class="prettyprint lang-config">Listen 80
<VirtualHost 172.20.30.40>
DocumentRoot "/www/example1"
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.50>
DocumentRoot "/www/example2"
ServerName www.example.org
</VirtualHost></pre>
<p>Les requêtes provenant d'adresses non spécifiées dans l'une des
directives <code><VirtualHost></code> (comme pour
<code>localhost</code> par exemple) seront dirigées vers le serveur
principal, s'il en existe un.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ipport" id="ipport">Hébergements virtuels mixtes basés sur
les ports et sur les IP</a></h2>
<p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code>
et <code>172.20.30.50</code>) correspondant respectivement aux noms
<code>www.example.com</code> et <code>www.example.org</code>.
Pour chacun d'eux, nous voulons un hébergement sur les ports 80
et 8080.</p>
<pre class="prettyprint lang-config">Listen 172.20.30.40:80
Listen 172.20.30.40:8080
Listen 172.20.30.50:80
Listen 172.20.30.50:8080
<VirtualHost 172.20.30.40:80>
DocumentRoot "/www/example1-80"
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
DocumentRoot "/www/example1-8080"
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.50:80>
DocumentRoot "/www/example2-80"
ServerName www.example.org
</VirtualHost>
<VirtualHost 172.20.30.50:8080>
DocumentRoot "/www/example2-8080"
ServerName www.example.org
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="mixed" id="mixed">Hébergements virtuels mixtes basé sur
les noms et sur IP</a></h2>
<p>Toute adresse indiquée comme argument d'une section VirtualHost
et n'apparaissant dans aucun autre serveur virtuel, fait de cette
section un serveur virtuel sélectionnable uniquement en fonction de
son adresse IP.</p>
<pre class="prettyprint lang-config">Listen 80
<VirtualHost 172.20.30.40>
DocumentRoot "/www/example1"
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/www/example2"
ServerName www.example.org
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/www/example3"
ServerName www.example.net
</VirtualHost>
# IP-based
<VirtualHost 172.20.30.50>
DocumentRoot "/www/example4"
ServerName www.example.edu
</VirtualHost>
<VirtualHost 172.20.30.60>
DocumentRoot "/www/example5"
ServerName www.example.gov
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Utilisation simultanée de
<code>Virtual_host</code> et de mod_proxy</a></h2>
<p>L'exemple suivant montre comment une machine peut mandater
un serveur virtuel fonctionnant sur le serveur d'une autre machine.
Dans cet exemple, un serveur virtuel de même nom est configuré sur
une machine à l'adresse <code>192.168.111.2</code>. La directive
<code class="directive"><a href="../mod/mod_proxy.html#proxypreservehost">ProxyPreserveHost On</a></code> est
employée pour permette au nom de domaine d'être préservé lors du
transfert, au cas où plusieurs noms de domaines cohabitent sur
une même machine.</p>
<pre class="prettyprint lang-config"><VirtualHost *:*>
ProxyPreserveHost On
ProxyPass "/" "http://192.168.111.2/"
ProxyPassReverse "/" "http://192.168.111.2/"
ServerName hostname.example.com
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="default" id="default">Utilisation de serveurs virtuels
<code>_default_</code></a></h2>
<h3><a name="defaultallports" id="defaultallports">Serveurs virtuels
<code>_default_</code> pour tous les ports</a></h3>
<p>Exemple de capture de <em>toutes</em> les requêtes émanant
d'adresses IP ou de ports non connus, <em>c'est-à-dire</em>, d'un
couple adresse/port non traité par aucun autre serveur virtuel.</p>
<pre class="prettyprint lang-config"><VirtualHost _default_:*>
DocumentRoot "/www/default"
</VirtualHost></pre>
<p>L'utilisation d'un tel serveur virtuel avec un joker pour le
port empêche de manière efficace qu'une requête n'atteigne le
serveur principal.</p>
<p>Un serveur virtuel par défaut ne servira jamais une requête
qui est envoyée vers un couple adresse/port utilisée par un
serveur virtuel par nom. Si la requête contient un en-tête
<code>Host:</code> inconnu, ou si celui-ci est absent, elle
sera toujours servie par le serveur virtuel primaire par nom
(celui correspondant à ce couple adresse/port trouvé en premier
dans le fichier de configuration).</p>
<p>Vous pouvez utiliser une directive
<code class="directive"><a href="../mod/mod_alias.html#aliasmatch">AliasMatch</a></code> ou
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> afin de
réécrire une requête pour une unique page d'information (ou pour
un script).</p>
<h3><a name="defaultdifferentports" id="defaultdifferentports">Serveurs virtuels
<code>_default_</code> pour des ports différents</a></h3>
<p>La configuration est similaire à l'exemple précédent, mais
le serveur écoute sur plusieurs ports et un second serveur virtuel
<code>_default_</code> pour le port 80 est ajouté.</p>
<pre class="prettyprint lang-config"><VirtualHost _default_:80>
DocumentRoot "/www/default80"
# ...
</VirtualHost>
<VirtualHost _default_:*>
DocumentRoot "/www/default"
# ...
</VirtualHost></pre>
<p>Le serveur virtuel par défaut défini pour le port 80 (il doit
impérativement être placé avant un autre serveur virtuel par
défaut traitant tous les ports grâce au joker *) capture toutes
les requêtes envoyées sur une adresse IP non spécifiée. Le
serveur principal n'est jamais utilisé pour servir une requête.</p>
<h3><a name="defaultoneport" id="defaultoneport">Serveurs virtuels
<code>_default_</code> pour un seul port</a></h3>
<p>Nous voulons créer un serveur virtuel par défaut seulement
pour le port 80.</p>
<pre class="prettyprint lang-config"><VirtualHost _default_:80>
DocumentRoot "/www/default"
...
</VirtualHost></pre>
<p>Une requête vers une adresse non spécifiée sur le port 80
sera servie par le serveur virtuel par défaut, et toute autre
requête vers une adresse et un port non spécifiés sera servie
par le serveur principal.</p>
<p>L'utilisation du caractère générique <code>*</code> dans la
déclaration d'un serveur virtuel l'emporte sur
<code>_default_</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="migrate" id="migrate">Migration d'un serveur virtuel
par nom en un serveur virtuel par IP</a></h2>
<p>Le serveur virtuel par nom avec le nom de domaine
<code>www.example.org</code> (de notre <a href="#name">exemple
par nom</a>) devrait obtenir sa propre adresse IP. Pendant la
phase de migration, il est possible d'éviter les problèmes avec
les noms de serveurs et autres serveurs mandataires qui mémorisent
les vielles adresses IP pour les serveurs virtuels par nom.<br />
La solution est simple, car il suffit d'ajouter la nouvelle
adresse IP (<code>172.20.30.50</code>) dans la directive
<code>VirtualHost</code>.</p>
<pre class="prettyprint lang-config">Listen 80
ServerName www.example.com
DocumentRoot "/www/example1"
<VirtualHost 172.20.30.40 172.20.30.50>
DocumentRoot "/www/example2"
ServerName www.example.org
# ...
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/www/example3"
ServerName www.example.net
ServerAlias *.example.net
# ...
</VirtualHost></pre>
<p>Le serveur virtuel peut maintenant être joint par la nouvelle
adresse (comme un serveur virtuel par IP) et par l'ancienne
adresse (comme un serveur virtuel par nom).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="serverpath" id="serverpath">Utilisation de la directive
<code>ServerPath</code></a></h2>
<p>Dans le cas où vous disposez de deux serveurs virtuels par nom,
le client doit transmettre un en-tête <code>Host:</code> correct
pour déterminer le serveur concerné. Les vieux clients HTTP/1.0
n'envoient pas un tel en-tête et Apache n'a aucun indice pour
connaître le serveur virtuel devant être joint (il sert la
requête à partir d'un serveur virtuel primaire). Dans un soucis
de préserver la compatibilité descendante, il suffit de créer
un serveur virtuel primaire chargé de retourner une page contenant
des liens dont les URLs auront un préfixe identifiant les serveurs
virtuels par nom.</p>
<pre class="prettyprint lang-config"><VirtualHost 172.20.30.40>
# serveur virtuel primaire
DocumentRoot "/www/subdomain"
RewriteEngine On
RewriteRule "." "/www/subdomain/index.html"
# ...
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/www/subdomain/sub1"
ServerName www.sub1.domain.tld
ServerPath "/sub1/"
RewriteEngine On
RewriteRule "^(/sub1/.*)" "/www/subdomain$1
# ...
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/www/subdomain/sub2"
ServerName www.sub2.domain.tld
ServerPath "/sub2/"
RewriteEngine On
RewriteRule "^(/sub2/.*)" "/www/subdomain$1"
# ...
</VirtualHost></pre>
<p>À cause de la directive
<code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code>, une requête sur
une URL <code>http://www.sub1.domain.tld/sub1/</code> est
<em>toujours</em> servie par le serveur sub1-vhost.<br />
Une requête sur une URL <code>http://www.sub1.domain.tld/</code> n'est
servie par le serveur sub1-vhost que si le client envoie un en-tête
<code>Host:</code> correct. Si aucun en-tête <code>Host:</code>
n'est transmis, le serveur primaire sera utilisé.</p>
<p>Notez qu'il y a une singularité : une requête sur
<code>http://www.sub2.domain.tld/sub1/</code> est également servie
par le serveur sub1-vhost si le client n'envoie pas d'en-tête
<code>Host:</code>.</p>
<p>Les directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
sont employées pour s'assurer que le client qui envoie un en-tête
<code>Host:</code> correct puisse utiliser d'autres variantes d'URLs,
<em>c'est-à-dire</em> avec ou sans préfixe d'URL.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/vhosts/examples.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/examples.html" title="Français"> fr </a> |
<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/examples.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/examples.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/mass.html.fr.utf8 0000664 0001751 0001751 00000047621 14740503670 021521 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Hébergement virtuel de masse configuré dynamiquement - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Hébergement virtuel</a></div><div id="page-content"><div id="preamble"><h1>Hébergement virtuel de masse configuré dynamiquement</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/vhosts/mass.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/mass.html" title="Français"> fr </a> |
<a href="../ko/vhosts/mass.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/mass.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document propose une méthode performante pour servir un nombre
quelconque d'hôtes virtuels avec le serveur HTTP Apache. Un <a href="../rewrite/vhosts.html">document séparé</a> décrit comment
utiliser <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour gérer l'hébergement
virtuel de masse dynamique.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#motivation">A qui ce document est-il destiné ?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#overview">Vue d'ensemble</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#simple">Hébergement virtuel
dynamique avec mod_vhost_alias</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#homepages">Système de serveurs virtuels dynamiques
simplifié</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#combinations">Utiliser plusieurs systèmes
d'hébergement virtuel sur le même serveur</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ipbased">Pour un hébergement virtuel par IP plus
efficace</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewrite">Hébergement virtuel de masse avec
mod_rewrite</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#macro">Hébergement virtuel en masse avec mod_macro</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="motivation" id="motivation">A qui ce document est-il destiné ?</a></h2>
<p>Les techniques décrites ici vous concernent si votre
<code>httpd.conf</code> contient de nombreuses sections
<code><VirtualHost></code> très semblables,
dans le style :</p>
<pre class="prettyprint lang-config"><VirtualHost 111.22.33.44>
ServerName customer-1.example.com
DocumentRoot "/www/hosts/customer-1.example.com/docs"
ScriptAlias "/cgi-bin/" "/www/hosts/customer-1.example.com/cgi-bin"
</VirtualHost>
<VirtualHost 111.22.33.44>
ServerName customer-2.example.com
DocumentRoot "/www/hosts/customer-2.example.com/docs"
ScriptAlias "/cgi-bin/" "/www/hosts/customer-2.example.com/cgi-bin"
</VirtualHost>
<VirtualHost 111.22.33.44>
ServerName customer-N.example.com
DocumentRoot "/www/hosts/customer-N.example.com/docs"
ScriptAlias "/cgi-bin/" "/www/hosts/customer-N.example.com/cgi-bin"
</VirtualHost></pre>
<p>Nous voulons remplacer toutes les configurations
<code><VirtualHost></code> par un mécanisme qui les génère
dynamiquement. Ceci présente certains avantages :</p>
<ol>
<li>Votre fichier de configuration est plus petit, ainsi Apache
démarre plus rapidement et consomme moins de mémoire. Et ce qui
est peut-être le plus important, le fichier de configuration plus
petit est plus facile à maintenir, et le risque d'erreurs en est
diminué d'autant.
</li>
<li>Pour ajouter des serveurs virtuels, il suffit de créer les
répertoires appropriés dans le système de fichiers et les entrées
dans le DNS - il n'est plus nécessaire de reconfigurer ou de
redémarrer Apache.</li>
</ol>
<p>Le principal désavantage réside dans le fait que vous ne pouvez
pas définir un fichier journal différent pour chaque serveur
virtuel. De toute façon, ce serait une mauvaise idée si vous avez de
nombreux serveurs virtuels, car cela nécessiterait un <a href="fd-limits.html">nombre important de descripteurs de
fichier</a>. Il est préférable de rediriger <a href="../logs.html#piped">les journaux via un pipe ou
une file fifo</a> vers un
programme, et faire en sorte que ce dernier éclate les journaux
en un journal par serveur virtuel. L'utilitaire <a href="../programs/split-logfile.html">split-logfile</a>
constitue un exemple de ce traitement.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="overview" id="overview">Vue d'ensemble</a></h2>
<p>Un serveur virtuel peut être défini par deux informations : son
adresse IP, et le contenu de l'en-tête <code>Host:</code> de la
requête HTTP. La technique d'hébergement virtuel dynamique de masse
utilisée ici consiste à insérer automatiquement ces informations
dans le chemin du fichier à utiliser pour répondre à la requête. On
peut y parvenir assez facilement en utilisant
<code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> avec Apache httpd, mais on peut aussi
<a href="../rewrite/vhosts.html">utiliser mod_rewrite</a>. </p>
<p>Par défaut, ces deux modules
sont désactivés ; vous devez activer l'un d'eux lors de la
compilation et de la configuration d'Apache httpd si vous voulez utiliser
cette technique.</p>
<p>Certains paramètres doivent être extraits de la requête pour que le serveur
dynamique se présente comme un serveur dynamique normal. Le plus
important est le nom du serveur, que le serveur utilise pour générer des
URLs d'auto-référencement, etc... Il est défini via la directive
<code>ServerName</code>, et les CGIs peuvent s'y référer via la
variable d'environnement <code>SERVER_NAME</code>. Sa véritable
valeur utilisée à l'exécution est contrôlée par la définition de la
directive
<code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code>. Avec
<code>UseCanonicalName Off</code>, le nom du serveur correspond au
contenu de l'en-tête <code>Host:</code> de la requête. Avec
<code>UseCanonicalName DNS</code>, il est extrait d'une recherche
DNS inverse sur l'adresse IP du serveur virtuel. La première
configuration est utilisée pour l'hébergement virtuel dynamique par
nom, et la deuxième pour l'hébergement virtuel dynamique par IP. Si
httpd ne peut pas déterminer le nom du serveur, soit parce qu'il
n'y a pas d'en-tête <code>Host:</code>, soit parce que la recherche
DNS a échoué, il prend en compte la valeur définie par la directive
<code>ServerName</code>.</p>
<p>L'autre paramètre à extraire est la racine des documents (définie
via la directive <code>DocumentRoot</code> et disponible pour les
scripts CGI via la variable d'environnement <code>DOCUMENT_ROOT</code>).
Dans une configuration classique, il est utilisé par le module core
pour faire correspondre les URIs aux noms de fichiers, mais lorsque
la configuration du serveur comporte des serveurs virtuels, ce
traitement doit être pris en charge par un autre module (soit
<code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>, soit <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>), qui
utilise un méthode de correspondance différente. Aucun de ces
modules ne se chargeant de définir la variable d'environnement
<code>DOCUMENT_ROOT</code>, si des CGIs ou des documents SSI
doivent en faire usage, ils obtiendront une valeur erronée.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="simple" id="simple">Hébergement virtuel
dynamique avec mod_vhost_alias</a></h2>
<p>Cet extrait de fichier <code>httpd.conf</code> implémente
l'hébergement virtuel décrit dans la section <a href="#motivation">À qui ce document est-il destiné ?</a> ci-dessus
en utilisant <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>.</p>
<pre class="prettyprint lang-config"># extrait le nom du serveur de l'en-tête Host:
UseCanonicalName Off
# ce format de journal peut être éclaté en journaux par serveur virtuel
# à l'aide du premier champ via l'utilitaire split-logfile
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
# inclut le nom du serveur dans les noms de fichiers ressources
# nécessaires aux traitements des requêtes
VirtualDocumentRoot "/www/hosts/%0/docs"
VirtualScriptAlias "/www/hosts/%0/cgi-bin"</pre>
<p>Pour changer cette configuration en solution de serveur virtuel
par IP, il suffit de remplacer <code>UseCanonicalName
Off</code> par <code>UseCanonicalName DNS</code>. Le nom du serveur
inséré dans le nom de fichier sera alors déduit de l'adresse IP du
serveur virtuel. La variable <code>%0</code> fait référence au nom
de serveur de la requête, tel qu'il est indiqué dans l'en-tête
<code>Host:</code>.</p>
<p>Voir la documentation du module <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>
pour d'avantages d'exemples d'utilisation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="homepages" id="homepages">Système de serveurs virtuels dynamiques
simplifié</a></h2>
<p>Il s'agit d'une adaptation du système ci-dessus, ajusté pour un
serveur d'hébergement web de FAI. Grâce à la variable
<code>%2</code>, on peut extraire des sous-chaînes de caractères du
nom du serveur pour les utiliser dans le nom de fichier afin, par
exemple, de définir <code>/home/user/www</code> comme emplacement des
documents pour <code>www.user.example.com</code>. Un seul répertoire
<code>cgi-bin</code> suffit pour l'ensemble des
serveurs virtuels.</p>
<pre class="prettyprint lang-config">UseCanonicalName Off
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
# insertion d'une partie du nom du serveur dans les noms de fichiers
VirtualDocumentRoot "/home/%2/www"
# répertoire cgi-bin unique
ScriptAlias "/cgi-bin/" "/www/std-cgi/"</pre>
<p>Vous trouverez des exemples plus élaborés d'utilisation de la
directive <code>VirtualDocumentRoot</code> dans la documentation du
module <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="combinations" id="combinations">Utiliser plusieurs systèmes
d'hébergement virtuel sur le même serveur</a></h2>
<p>Moyennant une configuration un peu plus compliquée, vous pouvez
contrôler la portée des différentes configurations d'hébergement
virtuel à l'aide des directives <code><VirtualHost></code>
normales de httpd. Par exemple, on peut associer une adresse IP pour
les pages d'accueil des clients en général, et une autre pour les
clients commerciaux avec la configuration suivante. Cette
configuration peut être combinée avec les sections
<code><VirtualHost></code> conventionnelles, comme indiqué
plus loin.</p>
<pre class="prettyprint lang-config">UseCanonicalName Off
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
<Directory "/www/commercial">
Options FollowSymLinks
AllowOverride All
</Directory>
<Directory "/www/homepages">
Options FollowSymLinks
AllowOverride None
</Directory>
<VirtualHost 111.22.33.44>
ServerName www.commercial.example.com
CustomLog "logs/access_log.commercial" vcommon
VirtualDocumentRoot "/www/commercial/%0/docs"
VirtualScriptAlias "/www/commercial/%0/cgi-bin"
</VirtualHost>
<VirtualHost 111.22.33.45>
ServerName www.homepages.example.com
CustomLog "logs/access_log.homepages" vcommon
VirtualDocumentRoot "/www/homepages/%0/docs"
ScriptAlias "/cgi-bin/" "/www/std-cgi/"
</VirtualHost></pre>
<div class="note">
<h3>Note</h3>
<p>Si le premier bloc VirtualHost ne comporte <em>pas</em> de
directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>, c'est
le nom issu d'une recherche DNS inverse à partir de l'adresse IP
du serveur virtuel qui sera utilisé. Si ce nom ne correspond pas
à celui que vous voulez utiliser, vous pouvez ajouter une entrée
de remplacement (par exemple <code>ServerName
none.example.com</code>) pour éviter ce comportement.</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="ipbased" id="ipbased">Pour un hébergement virtuel par IP plus
efficace</a></h2>
<p>Les changements de configuration suggérés pour transformer <a href="#simple">le premier exemple</a> en hébergement virtuel par IP
conduisent à une configuration peu efficace. Chaque requête
nécessite une nouvelle recherche DNS. Pour éviter cette surcharge de
travail, le système de fichiers peut être organisé pour correspondre
aux adresses IP, plutôt qu'aux noms de serveurs, supprimant par
la-même la nécessité d'une recherche DNS. La journalisation doit
aussi être adaptée pour fonctionner sur un tel système.</p>
<pre class="prettyprint lang-config"># obtention du nom du serveur par recherche DNS inverse
# sur l'adresse IP
UseCanonicalName DNS
# insertion de l'adresse IP dans les journaux afin de pouvoir les
# éclater
LogFormat "%A %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
# insertion de l'adresse IP dans les noms de fichiers
VirtualDocumentRootIP "/www/hosts/%0/docs"
VirtualScriptAliasIP "/www/hosts/%0/cgi-bin"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">Hébergement virtuel de masse avec
mod_rewrite</a></h2>
<p>
L'hébergement virtuel de masse peut aussi être effectué en utilisant
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, soit à l'aide de simples directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, soit en utilisant des
techniques plus compliquées comme le stockage externe des définitions
des serveurs virtuels, ces dernières étant accessibles via des
directives <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>. Ces
techniques sont décrites dans la <a href="../rewrite/vhosts.html">documentation sur la réécriture</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="macro" id="macro">Hébergement virtuel en masse avec mod_macro</a></h2>
<p>Une autre option pour générer dynamiquement des serveurs virtuels :
mod_macro ; ce module permet de créer un modèle de serveur virtuel que
vous pourrez invoquer pour des noms d'hôtes multiples. La section
<strong>Usage</strong> de la documentation du module présente un exemple qui
illustre cette méthode.
</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/vhosts/mass.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/mass.html" title="Français"> fr </a> |
<a href="../ko/vhosts/mass.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/mass.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/mass.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/fd-limits.html.en 0000664 0001751 0001751 00000021442 14737241666 021557 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>File Descriptor Limits - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Virtual Hosts</a></div><div id="page-content"><div id="preamble"><h1>File Descriptor Limits</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/vhosts/fd-limits.html" title="English"> en </a> |
<a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/fd-limits.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>When using a large number of Virtual Hosts, Apache may run
out of available file descriptors (sometimes called <cite>file
handles</cite>) if each Virtual Host specifies different log
files. The total number of file descriptors used by Apache is
one for each distinct error log file, one for every other log
file directive, plus 10-20 for internal use. Unix operating
systems limit the number of file descriptors that may be used
by a process; the limit is typically 64, and may usually be
increased up to a large hard-limit.</p>
<p>Although Apache attempts to increase the limit as required,
this may not work if:</p>
<ol>
<li>Your system does not provide the <code>setrlimit()</code>
system call.</li>
<li>The <code>setrlimit(RLIMIT_NOFILE)</code> call does not
function on your system (such as Solaris 2.3)</li>
<li>The number of file descriptors required exceeds the hard
limit.</li>
<li>Your system imposes other limits on file descriptors,
such as a limit on stdio streams only using file descriptors
below 256. (Solaris 2)</li>
</ol>
<p>In the event of problems you can:</p>
<ul>
<li>Reduce the number of log files; don't specify log files
in the <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
sections, but only log to the main log files. (See <a href="#splitlogs">Splitting up your log files</a>, below, for more
information on doing this.)</li>
<li>
If your system falls into 1 or 2 (above), then increase the
file descriptor limit before starting Apache, using a
script like:
<div class="example"><p><code>
<code>#!/bin/sh<br />
ulimit -S -n 100<br />
exec httpd</code>
</code></p></div>
</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="splitlogs" id="splitlogs">Splitting up your log files</a></h2>
<p>If you want to log multiple virtual hosts to the same log file, you
may want to split up the log files afterwards in order to run
statistical analysis of the various virtual hosts. This can be
accomplished in the following manner.</p>
<p>First, you will need to add the virtual host information to the log
entries. This can be done using the <code class="directive"><a href="../mod/mod_log_config.html#logformat">
LogFormat</a></code>
directive, and the <code>%v</code> variable. Add this to the beginning
of your log format string:</p>
<pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost
CustomLog logs/multiple_vhost_log vhost</pre>
<p>This will create a log file in the common log format, but with the
canonical virtual host (whatever appears in the
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> directive) prepended to
each line. (See <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> for
more about customizing your log files.)</p>
<p>When you wish to split your log file into its component parts (one
file per virtual host), you can use the program <code><a href="../programs/other.html">split-logfile</a></code> to accomplish
this. You'll find this program in the <code>support</code> directory
of the Apache distribution.</p>
<p>Run this program with the command:</p>
<div class="example"><p><code>
split-logfile < /logs/multiple_vhost_log
</code></p></div>
<p>This program, when run with the name of your vhost log file, will
generate one file for each virtual host that appears in your log file.
Each file will be called <code>hostname.log</code>.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/vhosts/fd-limits.html" title="English"> en </a> |
<a href="../fr/vhosts/fd-limits.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/fd-limits.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/fd-limits.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/details.html.fr.utf8 0000664 0001751 0001751 00000051664 14740503670 022205 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Détails sur le fonctionnement des serveurs virtuels - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Serveurs virtuels</a></div><div id="page-content"><div id="preamble"><h1>Détails sur le fonctionnement des serveurs virtuels</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/vhosts/details.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/details.html" title="Français"> fr </a> |
<a href="../ko/vhosts/details.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/details.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document vise à expliquer dans le détail comment le serveur
HTTP Apache procède lors du choix de l'utilisation
d'un serveur virtuel en fonction d'une requête reçue.</p>
<p>Il est recommandé de lire la documentation<a href="name-based.html#namevip">
Serveurs virtuels à base de nom et serveurs virtuels à base
d'adresse IP</a> pour déterminer quel type de serveur virtuel nous
convient le mieux, puis de lire les documentations <a href="name-based.html">serveurs virtuels à base de nom</a> ou <a href="ip-based.html">serveurs virtuels à base d'adresse IP</a>, et enfin
d'étudier <a href="examples.html">quelques exemples</a>.</p>
<p>Si vous voulez entrer dans les détails, vous pouvez revenir vers
cette page.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#configparsing">Fichier de configuration</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#hostmatching">Choix du serveur virtuel</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#tips">Trucs et astuces</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="ip-based.html">Support des serveurs virtuels à base
d'adresse IP</a></li><li><a href="name-based.html">Support des serveurs virtuels à base
de nom</a></li><li><a href="examples.html">Exemples de serveurs virtuels pour une
configuration courante</a></li><li><a href="mass.html">Hébergement virtuel de masse configuré
dynamiquement</a></li><li><a href="#comments_section">Commentaires</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="configparsing" id="configparsing">Fichier de configuration</a></h2>
<p>Un <em>serveur principal (main_server)</em> contient toutes
les définitions qui apparaissent en dehors des sections
<code><VirtualHost></code>.</p>
<p>Les serveurs virtuels, aussi
appelés <em>vhosts</em> (pour virtual hosts), sont définis par les
sections <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>.</p>
<p>Chaque directive <code>VirtualHost</code> comporte une ou
plusieurs adresses et des ports optionnels.</p>
<p>Il est possible d'utiliser des noms d'hôtes dans la définition
d'un serveur virtuel, mais ils seront résolus en adresses IP au
démarrage du serveur, et si une résolution de nom échoue, cette
définition de serveur virtuel sera ignorée. Cette méthode est par
conséquent déconseillée.</p>
<p>L'adresse peut
être spécifiée sous la forme <code>*</code>, ce qui conviendra à la
requête si aucun autre serveur virtuel ne possède l'adresse IP
explicite correspondant à celle de la requête.</p>
<p>L'adresse qui apparaît dans la directive <code>VirtualHost</code>
peut être associée à un port optionnel. Si aucun port n'est
spécifié, il s'agit d'un port générique qui peut aussi être spécifié
comme <code>*</code>. Le port générique correspond à toutes les
valeurs de port.</p>
<p>(Il ne faut pas confondre les numéros de port sur lesquels Apache
est en écoute avec les numéros de port spécifiés dans la directive
<code>VirtualHost</code> ; ces derniers ne servent qu'à définir le
<code>serveur virtuel</code> qui sera sélectionné pour traiter la
requête. Pour définir les ports sur lesquels Apache est en écoute,
utilisez la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>).
</p>
<p>L'ensemble des adresses (y compris les résultats multiples
<code>A</code> issus des requêtes DNS) est appelé <em>jeu
d'adresses</em> du serveur virtuel.</p>
<p>Apache fait automatiquement sa sélection à partir de l'en-tête
HTTP <code>Host</code> fourni par le client, lorsque la
correspondance la plus exacte du point de vue adresse IP/port a lieu
pour plusieurs serveurs virtuels.</p>
<p>La directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> peut
apparaître en quelque endroit de la définition d'un serveur.
Cependant, chaque occurrence écrase la précédente (pour ce serveur).
Si aucune directive <code>ServerName</code> n'est spécifiée, le
serveur tente de déterminer le nom du serveur à partir de l'adresse
IP.</p>
<p>Le premier serveur virtuel à base de nom apparaissant dans le
fichier de configuration pour une paire IP:port donnée est
significatif car c'est lui qui sera utilisé pour toutes les requêtes
reçues sur cette adresse IP/port et pour laquelle aucun autre
serveur virtuel ne possède un ServerName ou un ServerAlias
correspondant. Il sera aussi utilisé pour toutes les connexions SSL
si le serveur ne supporte pas l'<a class="glossarylink" href="../glossary.html#servernameindication" title="voir glossaire">Indication du nom du serveur</a>.</p>
<p>Tous les noms spécifiés au sein d'une section
<code>VirtualHost</code> sont traités comme un
<code>ServerAlias</code> (sans caractères génériques), mais ne sont
écrasés par aucune directive <code>ServerAlias</code>.</p>
<p>Pour chaque serveur virtuel, diverses valeurs sont initialisées
par défaut. En particulier :</p>
<ol>
<li>Dans le cas où un serveur virtuel ne contient pas de directives
<code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>,
<code class="directive"><a href="../mod/core.html#timeout">Timeout</a></code>,
<code class="directive"><a href="../mod/core.html#keepalivetimeout">KeepAliveTimeout</a></code>,
<code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code>,
<code class="directive"><a href="../mod/core.html#maxkeepaliverequests">MaxKeepAliveRequests</a></code>,
<code class="directive"><a href="../mod/mpm_common.html#receivebuffersize">ReceiveBufferSize</a></code>,
ou <code class="directive"><a href="../mod/mpm_common.html#sendbuffersize">SendBufferSize</a></code>,
alors la valeur de chacun de ces paramètres est héritée de celle du
serveur principal. (C'est à dire, héritée de la valeur finale après
lecture de la configuration du serveur principal.)</li>
<li>Les permissions par défaut sur les répertoires de chaque
serveur virtuel sont assemblées avec celles du serveur principal.
Elles concernent également toutes les informations de configuration
par répertoire pour tous les modules.</li>
<li>Les configurations par serveur pour chaque module sont assemblées
à partir de celles du serveur principal.</li>
</ol>
<p>L'essentiel des valeurs de configuration des serveurs virtuels
provient de valeurs par défaut issues du serveur principal.
Mais la position dans le fichier de configuration des directives
du serveur principal n'a pas d'importance -- l'ensemble de la
configuration du serveur principal est lu avant que ces valeurs par
défaut soient appliquées aux serveur virtuels. Ainsi, même si la
définition d'une valeur apparaît après celle d'un serveur virtuel,
cette valeur peut affecter la definition du serveur virtuel.</p>
<p>Dans le cas où le serveur principal n'a pas de <code>ServerName</code>
à ce stade, le nom de la machine sur laquelle tourne le programme
<code class="program"><a href="../programs/httpd.html">httpd</a></code> est utilisé à sa place. Nous appellerons
<em>jeu d'adresses du serveur principal</em> les adresses IP
renvoyées par une résolution DNS sur le <code>ServerName</code>
du serveur principal.</p>
<p>Pour tous les champs <code>ServerName</code> non définis, dans
le cas d'une configuration en serveur virtuel par nom, la valeur
adoptée par défaut est la première adresse donnée dans la section
<code>VirtualHost</code> qui définit le serveur virtuel.</p>
<p>Si un serveur virtuel contient la valeur magique
<code>_default_</code>, il fonctionne sur le même <code>ServerName</code>
que le serveur principal.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="hostmatching" id="hostmatching">Choix du serveur virtuel</a></h2>
<p>À la réception d'une requête, le serveur procède comme suit pour
déterminer quel serveur virtuel utiliser :</p>
<h3><a name="hashtable" id="hashtable">Recherche de l'adresse IP</a></h3>
<p>Lors d'une première connexion sur une adresse/port, le serveur
recherche toutes les directives <code>VirtualHost</code> qui
possèdent la même adresse IP/port.</p>
<p>S'il n'y a aucune correspondance exacte pour cette adresse/port,
la recherche s'effectue sur la valeur générique (<code>*</code>).</p>
<p>Si aucune correspondance n'est enfin trouvée, la requête sera
servie par le serveur principal.</p>
<p>S'il existe des définitions <code>VirtualHost</code> pour
l'adresse IP, l'étape suivante consiste à déterminer si nous avons à
faire à un serveur virtuel à base de nom ou d'adresse IP.</p>
<h3><a name="ipbased" id="ipbased">Serveur virtuel par IP</a></h3>
<p>Si une seule section <code>VirtualHost</code> présente la
meilleure correspondance avec la paire adresse IP/port, aucune
action n'est entreprise et la requête est
traitée par le serveur virtuel qui correspond.</p>
<h3><a name="namebased" id="namebased">Serveur virtuel par nom</a></h3>
<p>Si plusieurs sections <code>VirtualHost</code> présentent la
meilleure correspondance avec la paire adresse IP/port, le terme
"liste" dans les étapes suivantes fait référence à la liste des
serveurs virtuels qui correspondent, selon l'ordre dans lequel ils
apparaissent dans le fichier de configuration.</p>
<p>Si la connexion utilise SSL, si le serveur supporte l'<a class="glossarylink" href="../glossary.html#servernameindication" title="voir glossaire">Indication de nom de serveur</a>,
et si la négociation du client SSL inclut l'extension TLS dans le
nom d'hôte requis, alors ce nom d'hôte sera utilisé par la suite, tout
comme un en-tête <code>Host:</code> aurait été utilisé dans le cas
d'une connexion non-SSL. Si ces conditions ne sont pas réunies, le
premier serveur virtuel à base de nom dont l'adresse correspond sera
utilisé pour les connexions SSL. Ceci est important car c'est le
serveur virtuel qui détermine quel certificat le serveur va utiliser
pour la connexion.</p>
<p>Si la requête contient un en-tête <code>Host:</code>, on
recherche dans la liste le premier serveur virtuel dont le
<code>ServerName</code> ou le <code>ServerAlias</code> correspond,
et c'est celui-ci qui va traiter la requête. Un en-tête
<code>Host:</code> peut comporter un numéro de port mais Apache
l'ignore systématiquement et utilise toujours le
port sur lequel il a effectivement reçu la requête.</p>
<p>Le premier serveur virtuel du fichier de configuration qui
possède l'adresse spécifiée est prioritaire et intercepte toutes les
requêtes à destination d'un nom de serveur inconnu, ou toute requête
sans en-tête <code>Host:</code> (comme les requêtes HTTP/1.0).</p>
<h3><a name="persistent" id="persistent">Connexions persistantes</a></h3>
<p>La <em>recherche par adresse IP</em> décrite ci-avant n'est faite
qu'<em>une fois</em> pour chaque session TCP/IP, alors que la
<em>recherche par nom</em> est réalisée pour <em>chaque</em> requête au
cours d'une connexion persistante (KeepAlive). En d'autres termes,
il est possible pour un client de faire des requêtes sur
différents serveurs virtuels par nom, au cours d'une unique
connexion persistante.</p>
<h3><a name="absoluteURI" id="absoluteURI">URI absolu</a></h3>
<p>Au cas où l'URI de la requête est absolu, et que son nom de
serveur et son port correspondent au serveur principal (ou l'un
des serveurs virtuels configurés), <em>et</em> qu'ils correspondent
à l'adresse et au port de la requête, alors l'URI est amputé
de son préfixe protocole/nom de serveur/port et traité par le
serveur correspondant (principal ou virtuel). Si cette correspondance
n'existe pas, l'URI reste inchangé et la requête est considérée
comme une requête d'un serveur mandataire (proxy).</p>
<h3><a name="observations" id="observations">Observations</a></h3>
<ul>
<li>La sélection d'un serveur virtuel en fonction de son nom est
un processus qui intervient après la sélection par le serveur du
serveur virtuel qui correspond le mieux du point de vue adresse
IP/port.</li>
<li>Si vous ne tenez pas compte de l'adresse IP à laquelle le
client s'est connecté, indiquez un caractère "*" comme adresse
pour tous les serveurs virtuels, et la sélection du serveur
virtuel en fonction du nom s'appliquera alors à tous les serveurs
virtuels définis.</li>
<li>Les vérifications sur <code>ServerName</code> et
<code>ServerAlias</code> ne sont jamais
réalisées pour les serveurs virtuels par IP.</li>
<li>Seul l'ordre des serveurs virtuels par nom
pour une adresse donnée a une importance. Le serveur virtuel
par nom qui est présent en premier dans la configuration se
voit attribué la priorité la plus haute pour les requêtes
arrivant sur son jeu d'adresses IP.</li>
<li>Le numéro de port contenu dans l'en-tête <code>Host:</code> n'est jamais utilisé
pour les tests de correspondances. Apache ne prend en compte
que le numéro de port sur lequel le client a envoyé la requête.</li>
<li>Si deux serveurs virtuels partagent la même adresse, la
sélection se fera implicitement sur le nom. Il s'agit d'une
nouvelle fonctionnalité de la version 2.3.11.</li>
<li>Le serveur principal ne sert les requêtes que
lorsque l'adresse IP et le port demandés par le client ne
correspondent à aucun serveur virtuel (y compris un serveur
virtuel <code>*</code>). En d'autres termes, le serveur
principal n'est utile que pour les combinaisons adresse/port
non spécifiées (sauf quand un serveur virtuel <code>_default_</code>
correspond au port).</li>
<li>Il ne faut jamais employer de noms DNS dans des directives
<code>VirtualHost</code>, car cela oblige le serveur a s'appuyer
sur le DNS au moment du démarrage. De plus, vous vous exposez
à des problèmes de sécurité si vous n'avez pas la maîtrise du
DNS pour la totalité de vos domaines. Voir la documentation
<a href="../dns-caveats.html">disponible ici</a>, ainsi que
les deux points précisés ci-après.</li>
<li>Un nom de serveur <code>ServerName</code> devrait toujours
être indiqué pour chaque serveur virtuel. Sans cela, une
résolution DNS est nécessaire pour chaque serveur virtuel.</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="tips" id="tips">Trucs et astuces</a></h2>
<p>En plus des points évoqués sur la page des
<a href="../dns-caveats.html#tips">problèmes liés au DNS</a>,
voici quelques points intéressants :</p>
<ul>
<li>Toujours positionner les définitions relatives au serveur
principal avant toute définition <code>VirtualHost</code>.
(Ceci améliore grandement la lisibilité de la configuration
-- la manière dont la configuration est interprétée après la
lecture des fichiers ne met pas en évidence le fait que les
définitions positionnées avant et surtout après les serveurs
virtuels peuvent impacter le fonctionnement de tous les
serveurs virtuels.)</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/vhosts/details.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/details.html" title="Français"> fr </a> |
<a href="../ko/vhosts/details.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/details.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/details.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/ip-based.html.fr.utf8 0000664 0001751 0001751 00000032253 14740503670 022235 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Support Apache des serveurs virtuels par IP - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Serveurs virtuels</a></div><div id="page-content"><div id="preamble"><h1>Support Apache des serveurs virtuels par IP</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/vhosts/ip-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/ip-based.html" title="Français"> fr </a> |
<a href="../ja/vhosts/ip-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/ip-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/ip-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#requirements">Système requis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#howto">Comment configurer Apache</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multiple">Configuration de processus multiples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#single">Configuration d'un unique processus
résident pour des serveurs virtuels</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li>
<a href="name-based.html">Support Apache des serveurs virtuels par nom</a>
</li><li><a href="#comments_section">Commentaires</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="requirements" id="requirements">Système requis</a></h2>
<p>Comme l'indique le terme <cite>par IP</cite>, le serveur
<strong>doit disposer de différentes paires adresses IP/port pour chaque
serveur virtuel par IP</strong>. La machine peut posséder
plusieurs connexions physiques au réseau, ou utiliser des
interfaces virtuelles qui sont supportées par la plupart des
systèmes d'exploitation modernes (Consultez la documentation des
systèmes d'exploitation pour plus de détails, notamment les "alias
IP" et la commande "ifconfig" pour les activer), et/ou utiliser
plusieurs numéros de port.</p>
<p>Selon la terminologie du serveur HTTP Apache, l'utilisation d'une
seule adresse IP avec plusieurs ports TCP s'apparente aussi à de
l'hébergement virtuel basé sur IP.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="howto" id="howto">Comment configurer Apache</a></h2>
<p>Il y a deux manières de configurer Apache pour le support de
multiples serveurs virtuels. Il suffit soit de faire tourner un
processus résident <code class="program"><a href="../programs/httpd.html">httpd</a></code> pour chaque nom de
domaine, soit de faire tourner un unique processus résident qui
gère tous les serveurs virtuels.</p>
<p>Utilisez des processus résidents multiples lorsque :</p>
<ul>
<li>il y a des problèmes de répartition de sécurité, tels
qu'une entreprise1 ne souhaite que personne d'une entreprise2
ne puisse lire ses données excepté via le Web. Dans ce cas,
vous aurez besoin de deux processus résidents, chacun fonctionnant
avec des paramètres <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code>,
<code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code>,
<code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>, et
<code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> différents.</li>
<li>vous disposez suffisamment de mémoire et de
<a href="../misc/descriptors.html">descripteurs de fichiers</a>
pour l'écoute de chaque alias IP de la machine. Il est seulement
possible d'appliquer la directive
<code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>, soit sur toutes
les adresses avec le joker "*", soit uniquement sur des adresses
spécifiques. Donc, si vous avez besoin d'écouter une adresse
en particulier, vous devrez le faire pour l'ensemble des
autres adresses (Bien qu'il soit plus simple de lancer un
processus <code class="program"><a href="../programs/httpd.html">httpd</a></code> pour écouter N-1 adresses,
et un autre pour l'adresse restante).</li>
</ul>
<p>Utilisez un unique processus résident lorsque :</p>
<ul>
<li>le partage de la configuration httpd entre les serveurs
virtuels est acceptable.</li>
<li>la machine assume déjà une grande quantité de requêtes, et
que l'ajout de processus résidents supplémentaires en affecterait
les performances.</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="multiple" id="multiple">Configuration de processus multiples</a></h2>
<p>Créez une installation indépendante du programme
<code class="program"><a href="../programs/httpd.html">httpd</a></code> pour chaque serveur virtuel. Pour
chacune d'elle, utilisez la directive
<code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> dans le fichier
de configuration pour définir l'adresse IP (ou serveur virtuel)
que le processus résident doit gérer. Par exemple :</p>
<pre class="prettyprint lang-config">Listen 192.0.2.100:80</pre>
<p>Il est recommandé d'utiliser une adresse IP plutôt qu'un nom
de domaine (consultez <a href="../dns-caveats.html">Problèmes DNS
avec Apache</a>).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="single" id="single">Configuration d'un unique processus
résident pour des serveurs virtuels</a></h2>
<p>Dans ce cas, un unique processus httpd va gérer les requêtes
pour le serveur principal et tous les serveurs virtuels. Dans le
fichier de configuration, la directive
<code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> va servir à
définir les autres directives
<code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>,
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>,
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>,
<code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code> et
<code class="directive"><a href="../mod/mod_log_config.html#transferlog">TransferLog</a></code> ou
<code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> avec des
valeurs différentes pour chaque serveur virtuel. Par exemple :</p>
<pre class="prettyprint lang-config"><VirtualHost 172.20.30.40:80>
ServerAdmin webmaster@www1.example.com
DocumentRoot "/www/vhosts/www1"
ServerName www1.example.com
ErrorLog "/www/logs/www1/error_log"
CustomLog "/www/logs/www1/access_log" combined
</VirtualHost>
<VirtualHost 172.20.30.50:80>
ServerAdmin webmaster@www2.example.org
DocumentRoot "/www/vhosts/www2"
ServerName www2.example.org
ErrorLog "/www/logs/www2/error_log"
CustomLog "/www/logs/www2/access_log" combined
</VirtualHost></pre>
<p>Il est recommandé d'utiliser une adresse IP plutôt qu'un nom
de domaine comme argument à la directive <VirtualHost>
(consultez <a href="../dns-caveats.html">Problèmes DNS
avec Apache</a>).</p>
<p>Presque <strong>toutes</strong> les directives de configuration
peuvent être employées dans une directive VirtualHost, à l'exception
des directives qui contrôlent la création du processus et de
quelques autres. Pour connaître celles utilisables dans une
directive VirtualHost, vérifiez leur
<a href="../mod/directive-dict.html#Context">Contexte</a> en utilisant
l'<a href="../mod/quickreference.html">directive index</a>.</p>
<p><code class="directive"><a href="../mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> peut être
utilisées à l'intérieur d'une directive VirtualHost si l'exécution se fait
sous suEXEC. (Voir <a href="../suexec.html">suEXEC</a>).</p>
<p><em>SÉCURITÉ :</em> lorsque vous spécifiez où écrire les
fichiers journaux, soyez attentif aux risques si quelqu'un d'autre
que celui qui a démarré Apache dispose des droits d'écriture
sur l'emplacement de ces fichiers. Consultez les
<a href="../misc/security_tips.html">Conseils sur la sécurité</a>
pour plus de détails.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/vhosts/ip-based.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/vhosts/ip-based.html" title="Français"> fr </a> |
<a href="../ja/vhosts/ip-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/ip-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/ip-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/ip-based.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/examples.html.en 0000664 0001751 0001751 00000060551 14737241666 021511 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>VirtualHost Examples - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Virtual Hosts</a></div><div id="page-content"><div id="preamble"><h1>VirtualHost Examples</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/vhosts/examples.html" title="English"> en </a> |
<a href="../fr/vhosts/examples.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/examples.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document attempts to answer the commonly-asked questions about
setting up <a href="index.html">virtual hosts</a>. These scenarios are those involving multiple
web sites running on a single server, via <a href="name-based.html">name-based</a> or <a href="ip-based.html">IP-based</a> virtual hosts.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#purename">Running several name-based web
sites on a single IP address.</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#twoips">Name-based hosts on more than one
IP address.</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#intraextra">Serving the same content on
different IP addresses (such as an internal and external
address).</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#port">Running different sites on different
ports.</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ip">IP-based virtual hosting</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ipport">Mixed port-based and ip-based virtual
hosts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mixed">Mixed name-based and IP-based
vhosts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#proxy">Using <code>Virtual_host</code> and
mod_proxy together</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#default">Using <code>_default_</code>
vhosts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#migrate">Migrating a name-based vhost to an
IP-based vhost</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#serverpath">Using the <code>ServerPath</code>
directive</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="purename" id="purename">Running several name-based web
sites on a single IP address.</a></h2>
<p>Your server has multiple hostnames that resolve to a single address,
and you want to respond differently for <code>www.example.com</code>
and <code>www.example.org</code>.</p>
<div class="note"><h3>Note</h3><p>Creating virtual
host configurations on your Apache server does not magically
cause DNS entries to be created for those host names. You
<em>must</em> have the names in DNS, resolving to your IP
address, or nobody else will be able to see your web site. You
can put entries in your <code>hosts</code> file for local
testing, but that will work only from the machine with those
<code>hosts</code> entries.</p>
</div>
<pre class="prettyprint lang-config"># Ensure that Apache listens on port 80
Listen 80
<VirtualHost *:80>
DocumentRoot "/www/example1"
ServerName www.example.com
# Other directives here
</VirtualHost>
<VirtualHost *:80>
DocumentRoot "/www/example2"
ServerName www.example.org
# Other directives here
</VirtualHost></pre>
<p>The asterisks match all addresses, so the main server serves no
requests. Due to the fact that the virtual host with
<code>ServerName www.example.com</code> is first
in the configuration file, it has the highest priority and can be seen
as the <cite>default</cite> or <cite>primary</cite> server. That means
that if a request is received that does not match one of the specified
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> directives, it will be served by this first
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>.</p>
<p>The above configuration is what you will want to use in almost
all name-based virtual hosting situations. The only thing that this
configuration will not work for, in fact, is when you are serving
different content based on differing IP addresses or ports.</p>
<div class="note">
<h3>Note</h3>
<p>You may replace <code>*</code> with a specific IP address
on the system. Such virtual hosts will only be used for
HTTP requests received on connection to the specified IP
address.</p>
<p>However, it is additionally useful to use <code>*</code>
on systems where the IP address is not predictable - for
example if you have a dynamic IP address with your ISP, and
you are using some variety of dynamic DNS solution. Since
<code>*</code> matches any IP address, this configuration
would work without changes whenever your IP address
changes.</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="twoips" id="twoips">Name-based hosts on more than one
IP address.</a></h2>
<div class="note">
<h3>Note</h3>
<p>Any of the techniques discussed here can be extended to any
number of IP addresses.</p>
</div>
<p>The server has two IP addresses. On one (<code>172.20.30.40</code>), we
will serve the "main" server, <code>server.example.com</code> and on the
other (<code>172.20.30.50</code>), we will serve two or more virtual hosts.</p>
<pre class="prettyprint lang-config">Listen 80
# This is the "main" server running on 172.20.30.40
ServerName server.example.com
DocumentRoot "/www/mainserver"
<VirtualHost 172.20.30.50>
DocumentRoot "/www/example1"
ServerName www.example.com
# Other directives here ...
</VirtualHost>
<VirtualHost 172.20.30.50>
DocumentRoot "/www/example2"
ServerName www.example.org
# Other directives here ...
</VirtualHost></pre>
<p>Any request to an address other than <code>172.20.30.50</code> will be
served from the main server. A request to <code>172.20.30.50</code> with an
unknown hostname, or no <code>Host:</code> header, will be served from
<code>www.example.com</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="intraextra" id="intraextra">Serving the same content on
different IP addresses (such as an internal and external
address).</a></h2>
<p>The server machine has two IP addresses (<code>192.168.1.1</code>
and <code>172.20.30.40</code>). The machine is sitting between an
internal (intranet) network and an external (internet) network. Outside
of the network, the name <code>server.example.com</code> resolves to
the external address (<code>172.20.30.40</code>), but inside the
network, that same name resolves to the internal address
(<code>192.168.1.1</code>).</p>
<p>The server can be made to respond to internal and external requests
with the same content, with just one <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> section.</p>
<pre class="prettyprint lang-config"><VirtualHost 192.168.1.1 172.20.30.40>
DocumentRoot "/www/server1"
ServerName server.example.com
ServerAlias server
</VirtualHost></pre>
<p>Now requests from both networks will be served from the same
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>.</p>
<div class="note">
<h3>Note:</h3><p>On the internal
network, one can just use the name <code>server</code> rather
than the fully qualified host name
<code>server.example.com</code>.</p>
<p>Note also that, in the above example, you can replace the list
of IP addresses with <code>*</code>, which will cause the server to
respond the same on all addresses.</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="port" id="port">Running different sites on different
ports.</a></h2>
<p>You have multiple domains going to the same IP and also want to
serve multiple ports. The example below illustrates that the name-matching
takes place after the best matching IP address and port combination
is determined.</p>
<pre class="prettyprint lang-config">Listen 80
Listen 8080
<VirtualHost 172.20.30.40:80>
ServerName www.example.com
DocumentRoot "/www/domain-80"
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
ServerName www.example.com
DocumentRoot "/www/domain-8080"
</VirtualHost>
<VirtualHost 172.20.30.40:80>
ServerName www.example.org
DocumentRoot "/www/otherdomain-80"
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
ServerName www.example.org
DocumentRoot "/www/otherdomain-8080"
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ip" id="ip">IP-based virtual hosting</a></h2>
<p>The server has two IP addresses (<code>172.20.30.40</code> and
<code>172.20.30.50</code>) which resolve to the names
<code>www.example.com</code> and <code>www.example.org</code>
respectively.</p>
<pre class="prettyprint lang-config">Listen 80
<VirtualHost 172.20.30.40>
DocumentRoot "/www/example1"
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.50>
DocumentRoot "/www/example2"
ServerName www.example.org
</VirtualHost></pre>
<p>Requests for any address not specified in one of the
<code><VirtualHost></code> directives (such as
<code>localhost</code>, for example) will go to the main server, if
there is one.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ipport" id="ipport">Mixed port-based and ip-based virtual
hosts</a></h2>
<p>The server machine has two IP addresses (<code>172.20.30.40</code> and
<code>172.20.30.50</code>) which resolve to the names
<code>www.example.com</code> and <code>www.example.org</code>
respectively. In each case, we want to run hosts on ports 80 and
8080.</p>
<pre class="prettyprint lang-config">Listen 172.20.30.40:80
Listen 172.20.30.40:8080
Listen 172.20.30.50:80
Listen 172.20.30.50:8080
<VirtualHost 172.20.30.40:80>
DocumentRoot "/www/example1-80"
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
DocumentRoot "/www/example1-8080"
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.50:80>
DocumentRoot "/www/example2-80"
ServerName www.example.org
</VirtualHost>
<VirtualHost 172.20.30.50:8080>
DocumentRoot "/www/example2-8080"
ServerName www.example.org
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="mixed" id="mixed">Mixed name-based and IP-based
vhosts</a></h2>
<p>Any address mentioned in the argument to a virtualhost that never
appears in another virtual host is a strictly IP-based virtual host.</p>
<pre class="prettyprint lang-config">Listen 80
<VirtualHost 172.20.30.40>
DocumentRoot "/www/example1"
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/www/example2"
ServerName www.example.org
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/www/example3"
ServerName www.example.net
</VirtualHost>
# IP-based
<VirtualHost 172.20.30.50>
DocumentRoot "/www/example4"
ServerName www.example.edu
</VirtualHost>
<VirtualHost 172.20.30.60>
DocumentRoot "/www/example5"
ServerName www.example.gov
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Using <code>Virtual_host</code> and
mod_proxy together</a></h2>
<p>The following example allows a front-end machine to proxy a
virtual host through to a server running on another machine. In the
example, a virtual host of the same name is configured on a machine
at <code>192.168.111.2</code>. The <code class="directive"><a href="../mod/mod_proxy.html#proxypreservehost">ProxyPreserveHost
On</a></code> directive is used so that the desired hostname is
passed through, in case we are proxying multiple hostnames to a
single machine.</p>
<pre class="prettyprint lang-config"><VirtualHost *:*>
ProxyPreserveHost On
ProxyPass "/" "http://192.168.111.2/"
ProxyPassReverse "/" "http://192.168.111.2/"
ServerName hostname.example.com
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="default" id="default">Using <code>_default_</code>
vhosts</a></h2>
<h3><a name="defaultallports" id="defaultallports"><code>_default_</code> vhosts
for all ports</a></h3>
<p>Catching <em>every</em> request to any unspecified IP address and
port, <em>i.e.</em>, an address/port combination that is not used for
any other virtual host.</p>
<pre class="prettyprint lang-config"><VirtualHost _default_:*>
DocumentRoot "/www/default"
</VirtualHost></pre>
<p>Using such a default vhost with a wildcard port effectively prevents
any request going to the main server.</p>
<p>A default vhost never serves a request that was sent to an
address/port that is used for name-based vhosts. If the request
contained an unknown or no <code>Host:</code> header it is always
served from the primary name-based vhost (the vhost for that
address/port appearing first in the configuration file).</p>
<p>You can use <code class="directive"><a href="../mod/mod_alias.html#aliasmatch">AliasMatch</a></code> or
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to rewrite any
request to a single information page (or script).</p>
<h3><a name="defaultdifferentports" id="defaultdifferentports"><code>_default_</code> vhosts
for different ports</a></h3>
<p>Same as setup 1, but the server listens on several ports and we want
to use a second <code>_default_</code> vhost for port 80.</p>
<pre class="prettyprint lang-config"><VirtualHost _default_:80>
DocumentRoot "/www/default80"
# ...
</VirtualHost>
<VirtualHost _default_:*>
DocumentRoot "/www/default"
# ...
</VirtualHost></pre>
<p>The default vhost for port 80 (which <em>must</em> appear before any
default vhost with a wildcard port) catches all requests that were sent
to an unspecified IP address. The main server is never used to serve a
request.</p>
<h3><a name="defaultoneport" id="defaultoneport"><code>_default_</code> vhosts
for one port</a></h3>
<p>We want to have a default vhost for port 80, but no other default
vhosts.</p>
<pre class="prettyprint lang-config"><VirtualHost _default_:80>
DocumentRoot "/www/default"
...
</VirtualHost></pre>
<p>A request to an unspecified address on port 80 is served from the
default vhost. Any other request to an unspecified address and port is
served from the main server.</p>
<p>Any use of <code>*</code> in a virtual host declaration will have
higher precedence than <code>_default_</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="migrate" id="migrate">Migrating a name-based vhost to an
IP-based vhost</a></h2>
<p>The name-based vhost with the hostname
<code>www.example.org</code> (from our <a href="#name">name-based</a> example, setup 2) should get its own IP
address. To avoid problems with name servers or proxies who cached the
old IP address for the name-based vhost we want to provide both
variants during a migration phase.</p>
<p>
The solution is easy, because we can simply add the new IP address
(<code>172.20.30.50</code>) to the <code>VirtualHost</code>
directive.</p>
<pre class="prettyprint lang-config">Listen 80
ServerName www.example.com
DocumentRoot "/www/example1"
<VirtualHost 172.20.30.40 172.20.30.50>
DocumentRoot "/www/example2"
ServerName www.example.org
# ...
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/www/example3"
ServerName www.example.net
ServerAlias *.example.net
# ...
</VirtualHost></pre>
<p>The vhost can now be accessed through the new address (as an
IP-based vhost) and through the old address (as a name-based
vhost).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="serverpath" id="serverpath">Using the <code>ServerPath</code>
directive</a></h2>
<p>We have a server with two name-based vhosts. In order to match the
correct virtual host a client must send the correct <code>Host:</code>
header. Old HTTP/1.0 clients do not send such a header and Apache has
no clue what vhost the client tried to reach (and serves the request
from the primary vhost). To provide as much backward compatibility as
possible we create a primary vhost which returns a single page
containing links with an URL prefix to the name-based virtual
hosts.</p>
<pre class="prettyprint lang-config"><VirtualHost 172.20.30.40>
# primary vhost
DocumentRoot "/www/subdomain"
RewriteEngine On
RewriteRule "." "/www/subdomain/index.html"
# ...
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/www/subdomain/sub1"
ServerName www.sub1.domain.tld
ServerPath "/sub1/"
RewriteEngine On
RewriteRule "^(/sub1/.*)" "/www/subdomain$1"
# ...
</VirtualHost>
<VirtualHost 172.20.30.40>
DocumentRoot "/www/subdomain/sub2"
ServerName www.sub2.domain.tld
ServerPath "/sub2/"
RewriteEngine On
RewriteRule "^(/sub2/.*)" "/www/subdomain$1"
# ...
</VirtualHost></pre>
<p>Due to the <code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code>
directive a request to the URL
<code>http://www.sub1.domain.tld/sub1/</code> is <em>always</em> served
from the sub1-vhost.<br /> A request to the URL
<code>http://www.sub1.domain.tld/</code> is only
served from the sub1-vhost if the client sent a correct
<code>Host:</code> header. If no <code>Host:</code> header is sent the
client gets the information page from the primary host.</p>
<p>Please note that there is one oddity: A request to
<code>http://www.sub2.domain.tld/sub1/</code> is also served from the
sub1-vhost if the client sent no <code>Host:</code> header.</p>
<p>The <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directives
are used to make sure that a client which sent a correct
<code>Host:</code> header can use both URL variants, <em>i.e.</em>,
with or without URL prefix.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/vhosts/examples.html" title="English"> en </a> |
<a href="../fr/vhosts/examples.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/examples.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/examples.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/ip-based.html 0000664 0001751 0001751 00000000732 13710016232 020724 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: ip-based.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: ip-based.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: ip-based.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: ip-based.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: ip-based.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/vhosts/name-based.html.en 0000664 0001751 0001751 00000041427 14737241666 021670 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Name-based Virtual Host Support - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Virtual Hosts</a></div><div id="page-content"><div id="preamble"><h1>Name-based Virtual Host Support</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document describes when and how to use name-based virtual hosts.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#namevip">Name-based vs. IP-based Virtual Hosts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#alg">How the server selects the proper name-based virtual host</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#using">Using Name-based Virtual Hosts</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="ip-based.html">IP-based Virtual Host Support</a></li><li><a href="details.html">An In-Depth Discussion of Virtual Host Matching</a></li><li><a href="mass.html">Dynamically configured mass virtual hosting</a></li><li><a href="examples.html">Virtual Host examples for common setups</a></li><li><a href="#comments_section">Comments</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="namevip" id="namevip">Name-based vs. IP-based Virtual Hosts</a></h2>
<p><a href="ip-based.html">IP-based virtual hosts</a> use the IP address of the connection to
determine the correct virtual host to serve. Therefore you need to
have a separate IP address for each host.</p>
<p>With name-based virtual hosting, the server relies on the client to
report the hostname as part of the HTTP headers. Using this technique,
many different hosts can share the same IP address.</p>
<p>Name-based virtual hosting is usually simpler, since you need
only configure your DNS server to map each hostname to the correct
IP address and then configure the Apache HTTP Server to recognize
the different hostnames. Name-based virtual hosting also eases
the demand for scarce IP addresses. Therefore you should use
name-based virtual hosting unless you are using equipment
that explicitly demands IP-based hosting. Historical reasons for
IP-based virtual hosting based on client support are no longer
applicable to a general-purpose web server.</p>
<p> Name-based virtual hosting builds off of the IP-based virtual host
selection algorithm, meaning that searches for the proper server name
occur only between virtual hosts that have the best IP-based address.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="alg" id="alg">How the server selects the proper name-based virtual host</a></h2>
<p>It is important to recognize that the first step in name-based virtual
host resolution is IP-based resolution. Name-based virtual host
resolution only chooses the most appropriate name-based virtual host
after narrowing down the candidates to the best IP-based match. Using a wildcard (*)
for the IP address in all of the VirtualHost directives makes this
IP-based mapping irrelevant.</p>
<p>When a request arrives, the server will find the best (most specific) matching
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> argument based on
the IP address and port used by the request. If there is more than one virtual host
containing this best-match address and port combination, Apache will further
compare the <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> and <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> directives to the server name
present in the request.</p>
<p>If you omit the <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>
directive from any name-based virtual host, the server will default
to a fully qualified domain name (FQDN) derived from the system hostname.
This implicitly set server name can lead to counter-intuitive virtual host
matching and is discouraged.</p>
<h3><a name="defaultvhost" id="defaultvhost">The default name-based vhost for an IP and port combination </a></h3>
<p> If no matching ServerName or ServerAlias is found in the set of
virtual hosts containing the most specific matching IP address and port
combination, then <strong>the first listed virtual host</strong> that
matches that will be used.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="using" id="using">Using Name-based Virtual Hosts</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li><li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>The first step is to create a <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> block for
each different host that you would like to serve. Inside each <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> block, you will need at minimum a
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> directive to designate
which host is served and a <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
directive to show where in the filesystem the content for that host
lives.</p>
<div class="note"><h3>Main host goes away</h3>
<p> Any request that doesn't match an existing <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> is handled by the global
server configuration, regardless of the hostname or ServerName.</p>
<p> When you add a name-based virtual host to an existing server, and
the virtual host arguments match preexisting IP and port combinations,
requests will now be handled by an explicit virtual host. In this case,
it's usually wise to create a <a href="#defaultvhost">default virtual host</a>
with a <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> matching that of
the base server. New domains on the same interface and port, but
requiring separate configurations, can then be added as subsequent (non-default)
virtual hosts.</p>
</div>
<div class="note"><h3>ServerName inheritance</h3>
<p> It is best to always explicitly list a <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> in every name-based virtual host.</p>
<p>If a <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> doesn't specify
a <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>, a server name will be
inherited from the base server configuration. If no server name was
specified globally, one is detected at startup through reverse DNS resolution
of the first listening address. In either case, this inherited server name
will influence name-based virtual host resolution, so it is best to always
explicitly list a <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> in every
name-based virtual host.</p>
</div>
<p>For example, suppose that you are serving the domain
<code>www.example.com</code> and you wish to add the virtual host
<code>other.example.com</code>, which points at the same IP address.
Then you simply add the following to <code>httpd.conf</code>:</p>
<pre class="prettyprint lang-config"><VirtualHost *:80>
# This first-listed virtual host is also the default for *:80
ServerName www.example.com
ServerAlias example.com
DocumentRoot "/www/domain"
</VirtualHost>
<VirtualHost *:80>
ServerName other.example.com
DocumentRoot "/www/otherdomain"
</VirtualHost></pre>
<p>You can alternatively specify an explicit IP address in place of the
<code>*</code> in <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> directives. For example, you might want to do this
in order to run some name-based virtual hosts on one IP address, and either
IP-based, or another set of name-based virtual hosts on another address.</p>
<p>Many servers want to be accessible by more than one name. This is
possible with the <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>
directive, placed inside the <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> section. For example in the first <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> block above, the
<code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> directive indicates that
the listed names are other names which people can use to see that same
web site:</p>
<pre class="prettyprint lang-config">ServerAlias example.com *.example.com</pre>
<p>then requests for all hosts in the <code>example.com</code> domain will
be served by the <code>www.example.com</code> virtual host. The wildcard
characters <code>*</code> and <code>?</code> can be used to match names.
Of course, you can't just make up names and place them in <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> or <code>ServerAlias</code>. You must
first have your DNS server properly configured to map those names to an IP
address associated with your server.</p>
<p>Name-based virtual hosts for the best-matching set of <code class="directive"><a href="../mod/core.html#virtualhost"><virtualhost></a></code>s are processed
in the order they appear in the configuration. The first matching <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> or <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> is used, with no different precedence for wildcards
(nor for ServerName vs. ServerAlias). </p>
<p>The complete list of names in the <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code>
directive are treated just like a (non wildcard)
<code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>.</p>
<p>Finally, you can fine-tune the configuration of the virtual hosts
by placing other directives inside the <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> containers. Most directives can be
placed in these containers and will then change the configuration only of
the relevant virtual host. To find out if a particular directive is allowed,
check the <a href="../mod/directive-dict.html#Context">Context</a> of the
directive. Configuration directives set in the <em>main server context</em>
(outside any <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
container) will be used only if they are not overridden by the virtual host
settings.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/vhosts/name-based.html" title="English"> en </a> |
<a href="../fr/vhosts/name-based.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/vhosts/name-based.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/vhosts/name-based.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/vhosts/index.html 0000664 0001751 0001751 00000001173 13710016232 020347 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: index.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: index.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: index.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: index.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: index.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: index.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
URI: index.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/vhosts/fd-limits.html 0000664 0001751 0001751 00000000737 13710016232 021135 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: fd-limits.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: fd-limits.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: fd-limits.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: fd-limits.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: fd-limits.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/vhosts/name-based.html 0000664 0001751 0001751 00000001076 13710016232 021236 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: name-based.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: name-based.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: name-based.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: name-based.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: name-based.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: name-based.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/filter.html.ko.euc-kr 0000664 0001751 0001751 00000020567 14743132254 021016 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title> - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1></h1>
<div class="toplang">
<p><span> : </span><a href="./en/filter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/filter.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/filter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/filter.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/filter.html" title="Korean"> ko </a> |
<a href="./tr/filter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ġ ϴ Ѵ.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="filters" id="filters"></a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilteroptions">ExtFilterOptions</a></code></li><li><code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code></li><li><code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code></li></ul></td></tr></table>
<p><em>(filter)</em> ų ڷῡ
Ǵ ۾̴. Ŭ̾Ʈ ڷ
<em>Է(input filter)</em> óϰ,
Ŭ̾Ʈ ڷ <em>(output filter)</em>
óѴ. ڷῡ ְ,
ִ.</p>
<p>ġ ̾ޱ(byte-range) û óϱ
Ѵ. , þ
Ͽ ð ϴ ִ.
<code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code>,
<code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code>
þ ڷḦ óϴ Ѵ.</p>
<p> ġ ڰ ִ
Ѵ.</p>
<dl>
<dt>INCLUDES</dt>
<dd><code class="module"><a href="./mod/mod_include.html">mod_include</a></code> óϴ Server-Side Includes</dd>
<dt>DEFLATE</dt>
<dd><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> Ͽ
Ŭ̾Ʈ
</dd>
</dl>
<p>, <code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> Ͽ
ܺ α ͷ ִ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/filter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/filter.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/filter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/filter.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/filter.html" title="Korean"> ko </a> |
<a href="./tr/filter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/filter.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/index.html 0000664 0001751 0001751 00000001725 13741307256 017041 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: index.html.da
Content-Language: da
Content-type: text/html; charset=ISO-8859-1
URI: index.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: index.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: index.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: index.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: index.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: index.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: index.html.pt-br
Content-Language: pt-br
Content-type: text/html; charset=ISO-8859-1
URI: index.html.ru.utf8
Content-Language: ru
Content-type: text/html; charset=UTF-8
URI: index.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
URI: index.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/filter.html.tr.utf8 0000664 0001751 0001751 00000037776 14743132254 020544 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Süzgeçler - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Süzgeçler</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/filter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/filter.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/filter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/filter.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/filter.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/filter.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belge, Apache’de süzgeç kullanımı hakkındadır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#intro">Apache 2’de Süzme İşlemi</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#smart">Akıllı Süzme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#service">Süzgeçleri bir HTTP Hizmeti gibi göstermek </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Süzgeçlerin Kullanımı</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="intro" id="intro">Apache 2’de Süzme İşlemi</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code></li><li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></li><li><code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code></li><li><code class="module"><a href="./mod/mod_buffer.html">mod_buffer</a></code></li><li><code class="module"><a href="./mod/mod_data.html">mod_data</a></code></li><li><code class="module"><a href="./mod/mod_ratelimit.html">mod_ratelimit</a></code></li><li><code class="module"><a href="./mod/mod_reqtimeout.html">mod_reqtimeout</a></code></li><li><code class="module"><a href="./mod/mod_request.html">mod_request</a></code></li><li><code class="module"><a href="./mod/mod_sed.html">mod_sed</a></code></li><li><code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code></li><li><code class="module"><a href="./mod/mod_xml2enc.html">mod_xml2enc</a></code></li><li><code class="module"><a href="./mod/mod_proxy_html.html">mod_proxy_html</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_filter.html#filterchain">FilterChain</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprotocol">FilterProtocol</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_reflector.html#reflectorheader">ReflectorHeader</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilteroptions">ExtFilterOptions</a></code></li><li><code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code></li><li><code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code></li></ul></td></tr></table>
<p>Apache 2.0 ve sonrasında mevcut olan Süzgeç Zinciri, uygulamaların
nereden geldiğine bakmaksızın gelen ve giden verileri oldukça esnek ve
yapılandırılabilir tarzda işlemesini mümkün kılar. Böylece, gelen veriyi
bir takım ön işlemlerden geçirebilir, giden veriyi de son bir defa bazı
işlemlere sokabiliriz. Bu işlem temel olarak geleneksel istek işleme
aşamalarından bağımsızdır.</p>
<p class="figure">
<img src="images/filter_arch.tr.png" width="569" height="392" alt="Süzgeçler, İstek işleme eksenine dik bir veri eksenine peş peşe yerleştirilebilir." />
</p>
<p>Standard Apache dağıtımıyla gelen süzgeç uygulamalarından bazıları:</p>
<ul>
<li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>, sunucu taraflı içerik yerleştirmeyi
gerçekler.</li>
<li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>, SSL şifrelemesini gerçekler (https).</li>
<li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>, veri sıkıştırma/açma işlemlerini
çalışma anında gerçekleştirir.</li>
<li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code>, karakter kümeleri arasında
dönüşümü gerçekleştirir.</li>
<li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>, harici bir yazılımı bir süzgeç
olarak çalıştırır.</li>
</ul>
<p>Apache, bunlardan başka, bayt dizilerinin elde edilmesi ve içeriğin
bölünmesi gibi işlemleri gerçekleştirmek için bir takım dahili süzgeçler
de kullanabilir.</p>
<p>Üçüncü parti süzgeç modülleri tarafından gerçeklenmiş
modüllerden bazılarının uygulama alanları:</p>
<ul>
<li>HTML ve XML belgelerin işlenmesi ve yazılması</li>
<li>XSLT dönüşümleri ve XInclude’lar</li>
<li>XML İsim-alanı desteği</li>
<li>HTML Formlarının çözümlenmesi ve sunucuya dosya yükleme</li>
<li>Resim işleme</li>
<li>PHP betikleri gibi zararlı olabilecek uygulamalardan korunma</li>
<li>Metin düzenleme ve arama işlemleri</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="smart" id="smart">Akıllı Süzme</a></h2>
<p class="figure">
<img src="images/mod_filter_new.tr.png" width="423" height="331" alt="Farklı süzgeç üreticilerinin uygulamaları istek işlemenin durumuna bağlı olarak akıllıca uygulanabilir." />
</p>
<p><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>, Apache 2.1 ve sonrasında mevcut olup,
süzgeç zincirinin çalışma anında devingen olarak yapılandırılabilmesini
mümkün kılar. Böylece, örneğin, bir vekili, özgün sunucunun ne
göndereceğini bilmeden HTML’yi bir HTML süzgeciyle yazmaya ve JPEG
resimleri tamamen farklı bir süzgeçten geçirmeye ayarlayabilirsiniz. Bu,
asıl içeriğe bağlı olarak çalışma anında içeriği farklı içerik
sağlayıcılara dağıtan bir süzgeç düzeneği kullanılarak çalışır. Bir
süzgeç, doğrudan zincire yerleştirilip koşulsuz olarak
çalıştırılabileceği gibi bir içerik sağlayıcı gibi kullanılarak zincire
devingen olarak yerleştirilebilir. Örneğin:</p>
<ul>
<li>Bir HTML işleme süzgeci sadece içerik text/html veya
application/xhtml+xml olduğu takdirde çalışır.</li>
<li>Bir sıkıştırma süzgeci sadece girdi sıkıştırılabilir nitelikteyse ve
sıkıştırılmamışsa çalışır.</li>
<li>Bir karakter kümesi dönüşüm süzgeci, bir metin belgesi istenen
karakter kümesine sahip değilse zincire yerleştirilir.</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="service" id="service">Süzgeçleri bir HTTP Hizmeti gibi göstermek </a></h2>
<p>Süzgeçler, istemciden kaynaklanan içeriği işlemekte kullanılabileceği
gibi <code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code> modülü kullanılarak sunucudan
kaynaklanan içeriği işlemekte de kullanılabilir.</p>
<p><code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code> istemcilerden gelen POST isteklerini
kabul eder ve çıktı süzgeç yığıtı yoluyla istemciye aktararak, POST
isteği içinde alınan içerik istek gövdesini yanıt içinde geri
gönderir.</p>
<p>Bu teknik, bir çıktı süzgeciyle istek gövdesinde gerekli dönüşümün
sağlandığı durumda, bir uygulama sunucusu yığıtı içinde çalışan bir http
hizmetinin yerine de kullanılabilir. Örneğin,
<code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> modülü genel bir sıkıştırma hizmeti
sağlamakta kullanılabilir veya bir resim dönüştürme süzgeci bir resim
dönüşüm hizmeti haline getirilebilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="using" id="using">Süzgeçlerin Kullanımı</a></h2>
<p>Süzgeçler iki şekilde kullanılır: Basit ve Devingen.
Genelde ikisinden biri kullanılır; karışık kullanılırsa istenmeyen
sonuçlara yol açabilir (ise de, basit girdi süzme ile çıktı süzme işlemi
basit olsun olmasın karışık kullanılabilir).</p>
<p>Basit yol, girdi süzgeçlerini yapılandırmanın tek yoludur ve bir
durağan süzgeç zincirinin gerektiği yerlerde çıktı süzgeçleri için
yeterlidir. İlgili yönergeler:
<code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code>,
<code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code> ve
<code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code>.</p>
<p>Devingen yol, <code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> belgesinde açıklandığı gibi,
çıktı süzgeçlerinin hem durağan hem de esnek ve devingen olarak
yapılandırılabilmesini mümkün kılar. İlgili yönergeler:
<code class="directive"><a href="./mod/mod_filter.html#filterchain">FilterChain</a></code>,
<code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code> ve
<code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code>.</p>
<p><code class="directive"><a href="./mod/core.html#addoutputfilterbytype">AddOutputFilterByType</a></code> yönergesi
hala desteklenmekteyse de kullanımı artık
önerilmemektedir. Onun yerine devingen yapılandırma kullanınız.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/filter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/filter.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/filter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/filter.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/filter.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/filter.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/filter.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/glossary.html.ja.utf8 0000664 0001751 0001751 00000100035 14743132254 021042 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>用語 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>用語</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/glossary.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/glossary.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/glossary.html" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>この用語集では Apacheに特化した用語と、
ウェブサーバ全般で一般的な用語をいくつか定義しています。
それぞれの概念の、より詳細な情報はリンク先にあります。</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="definitions" id="definitions">定義</a></h2>
<dl>
<dt><a name="accesscontrol" id="accesscontrol">アクセス制御</a></dt>
<dd>ネットワーク認可領域へのアクセスを制限します。Apache においては、
普通はアクセスの制限は <em>URL</em> に対するものとなります。<br />
参照: <a href="howto/auth.html">認証、承認、アクセス制御</a>
</dd>
<dt><a name="algorithm" id="algorithm">アルゴリズム</a></dt>
<dd>有限回のステップで問題を解くためのあいまいでない式もしくは規則の
集合。暗号のためのアルゴリズムは通常 <dfn>Cipher</dfn> と呼ばれます。
</dd>
<dt><a name="apacheextensiontool" id="apacheextensiontool">APache
eXtension Tool</a> <a name="apxs" id="apxs">(apxs)</a></dt>
<dd><a class="glossarylink" href="./glossary.html#module" title="用語集を参照">モジュール</a> ソースを
動的共有オブジェクト (<a class="glossarylink" href="./glossary.html#dso" title="用語集を参照">DSO</a>) にコンパイルし、
Apache Web サーバにインストールする手助けをする perl スクリプト。<br />
参照: マニュアルページ: <code class="program"><a href="./programs/apxs.html">apxs</a></code>
</dd>
<dt><a name="apacheportableruntime" id="apacheportableruntime">Apache Portable Runtime</a> <a name="apr" id="apr">(APR)</a></dt>
<dd>サーバ<span class="transnote">(<em>訳注:</em> Apache HTTP Server)</span>と OS の
間の基本的なインターフェースの多くを提供する<span class="transnote">(<em>訳注:</em>
OS の差を吸収する)</span>ライブラリのセット。 APR は 独立した
プロジェクトとして Apache HTTP Server と平行して開発が行われています。<br />
参照: <a href="http://apr.apache.org/">Apache Portable Runtime
プロジェクト</a>
</dd>
<dt><a name="authentication" id="authentication">認証</a></dt>
<dd>サーバ、クライアント、ユーザといったネットワークエンティティの
身元の特定。<br />
参照: <a href="howto/auth.html">認証、承認、アクセス制御</a>
</dd>
<dt><a name="certificate" id="certificate">証明書</a></dt>
<dd>サーバやクライアントといったネットワークエンティティを認証するのに
使用されるデータレコード。証明書には (subject と呼ばれる) 所有者と、
(issuer と呼ばれる) <a class="glossarylink" href="./glossary.html#certificationauthority" title="用語集を参照">認証局</a> の署名、所有者の
<a class="glossarylink" href="./glossary.html#publickey" title="用語集を参照">公開鍵</a> と、CA による署名という
X.509 の情報が含まれます。ネットワークエンティティはそれらの署名を
CA 証明書を使って検証します。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="certificatsigningrequest" id="certificatsigningrequest">証明書署名リクエスト</a>
<span class="transnote">(<em>訳注:</em> Certificate Signing Request)</span>
<a name="csr" id="csr">(CSR)</a></dt>
<dd><a class="glossarylink" href="./glossary.html#certificationauthority" title="用語集を参照">認証局</a> に提出
する未署名の <a class="glossarylink" href="./glossary.html#certificate" title="用語集を参照">証明書</a>。
認証局は CA <em>証明書</em> の <a class="glossarylink" href="./glossary.html#privatekey" title="用語集を参照">秘密鍵</a> で署名します。
一旦 CSR に署名がなされると、それは本物の証明書になります。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="certificationauthority" id="certificationauthority">証明局</a>
<span class="transnote">(<em>訳注:</em> Certification Authority)</span>
<a name="ca" id="ca">(CA)</a></dt>
<dd>安全な方法で認証を行なったネットワークエンティティの証明書を
署名するための信頼できる第三者機関。他のネットワークエンティティは
証明書の保持者が CA に認証されたかを署名を検証することで調べることが
できます。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="cipher" id="cipher">Cipher</a></dt>
<dd>データ暗号化のためのアルゴリズム。例えば DES, IDEA, RC4 など。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="ciphertext" id="ciphertext">暗号文</a></dt>
<dd><a class="glossarylink" href="./glossary.html#plaintext" title="用語集を参照">平文</a> が
<a class="glossarylink" href="./glossary.html#cipher" title="用語集を参照">Cipher</a> をかけられた結果。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="commongatewayinterface" id="commongatewayinterface">Common
Gateway Interface</a> <a name="cgi" id="cgi">(CGI)</a></dt>
<dd>外部プログラムがリクエストを扱うことができるようにするための
ウェブサーバと外部プログラム間のインタフェースの標準仕様。
インタフェースは元々 <a href="http://hoohoo.ncsa.uiuc.edu/cgi/overview.html">NCSA</a> により定義
されていましたが
<a href="http://cgi-spec.golux.com/">RFC プロジェクト</a> も存在します。<br />
参照: <a href="howto/cgi.html">CGI による動的コンテンツ</a>
</dd>
<dt><a name="configurationdirective" id="configurationdirective">設定ディレクティブ</a></dt>
<dd>参照: <a class="glossarylink" href="./glossary.html#directive" title="用語集を参照">ディレクティブ</a></dd>
<dt><a name="configurationfile" id="configurationfile">設定ファイル</a></dt>
<dd>Apache の設定を制御する <a class="glossarylink" href="./glossary.html#directive" title="用語集を参照">ディレクティブ</a>
の書かれたテキストファイル。<br />
参照: <a href="configuring.html">設定ファイル</a>
</dd>
<dt><a name="connect" id="connect">CONNECT</a></dt>
<dd>データチャネルをそのまま HTTP 上でプロキシするための HTTP
<a class="glossarylink" href="./glossary.html#method" title="用語集を参照">メソッド</a>。SSL のような他の
プロトコルをくるむために使うことができます。
</dd>
<dt><a name="context" id="context">コンテキスト</a></dt>
<dd><a class="glossarylink" href="./glossary.html#configurationfile" title="用語集を参照">設定ファイル</a> 中で、
特定の種類の <a class="glossarylink" href="./glossary.html#directive" title="用語集を参照">ディレクティブ</a> が許可されている場所。<br />
参照: <a href="mod/directive-dict.html#Context">Apache のディレクティブの
説明に使われている用語</a>
</dd>
<dt><a name="digitalsignature" id="digitalsignature">デジタル署名</a></dt>
<dd>証明書や他のファイルを検証するための暗号化されたテキストブロック。
<a class="glossarylink" href="./glossary.html#certificationauthority" title="用語集を参照">認証局</a> は
<em>証明書</em> に埋め込まれた <em>公開鍵</em> のハッシュを作成し、
それを自身の <em>秘密鍵</em> で暗号化することで署名を作成します。
CA の公開鍵でのみその署名を復号することができますので、それにより
<em>証明書</em> を保有するネットワークエンティティを CA が認証した
ことを検証できます。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="directive" id="directive">ディレクティブ</a></dt>
<dd>Apache のいろいろな振る舞いを制御する設定コマンド。ディレクティブは
<a class="glossarylink" href="./glossary.html#configurationfile" title="用語集を参照">設定ファイル</a> に
書かれます。<br />
参照: <a href="mod/directives.html">ディレクティブ索引</a>
</dd>
<dt><a name="dynamicsharedobject" id="dynamicsharedobject">動的
共有オブジェクト</a> <span class="transnote">(<em>訳注:</em> Dynamic
Shared Object)</span> <a name="dso" id="dso">(DSO)</a></dt>
<dd>必要に応じて読み込むことが可能な、Apache <code class="program"><a href="./programs/httpd.html">httpd</a></code> とは
別にコンパイルされた <a class="glossarylink" href="./glossary.html#module" title="用語集を参照">モジュール</a><br />
参照: <a href="dso.html">動的共有オブジェクトサポート</a>
</dd>
<dt><a name="environmentvariable" id="environmentvariable">環境変数</a>
<a name="env-variable" id="env-variable">(env-variable)</a></dt>
<dd>情報を保管したり、プログラム間の通信をするために使われる、
オペレーティングシステムのシェルにより管理されている名前付きの変数。
Apache も環境変数と呼ばれる内部変数を持っていますが、こちらは
シェル環境ではなく、Apache の内部構造体に保持されています。<br />
参照: <a href="env.html">Apache の環境変数</a>
</dd>
<dt><a name="export-crippled" id="export-crippled">輸出強度削減</a>
<span class="transnote">(<em>訳注:</em> Export-Crippled)</span></dt>
<dd>アメリカの Export Administration Regulations (EAR)
<span class="transnote">(<em>訳注:</em> 輸出管理規則)</span> に従うために暗号の強度 (とセキュリティ)
を削減すること。輸出強度削減された暗号ソフトウェアは小さいキーに
制限され、通常総当たり攻撃で復号できてしまう <em>暗号文</em> を生成する
ことになります。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="filter" id="filter">フィルタ</a></dt>
<dd>サーバから送られるデータとサーバが受け取るデータに適用される処理。
入力フィルタはクライアントからサーバに送られたデータを処理し、
出力フィルタはサーバにある文書をクライアントに送る前に処理します。
例えば、<code>INCLUDES</code> 出力フィルタは
<a class="glossarylink" href="./glossary.html#ssi" title="用語集を参照">Server Side Includes</a> の文書を
処理します。<br />
参照: <a href="filter.html">フィルタ</a>
</dd>
<dt><a name="fully-qualifieddomain-name" id="fully-qualifieddomain-name">完全修飾ドメイン名</a>
<span class="transnote">(<em>訳注:</em> Fully-Qualified Domain-Name)</span>
<a name="fqdn" id="fqdn">(FQDN)</a></dt>
<dd>IP アドレスに解決できるホスト名と、ドメイン名からなるネットワーク
エンティティの一意な名前。例えば、<code>www</code> はホスト名で、
<code>example.com</code> はドメイン名なので、
<code>www.example.com</code> は完全修飾ドメイン名になります。</dd>
<dt><a name="handler" id="handler">ハンドラ</a></dt>
<dd>ファイルが呼ばれたときに行なわれる動作の Apache の内部での表現。
一般にファイルにはファイルの種類に応じて暗黙のハンドラが設定されて
います。普通はすべてのファイルがサーバにより送られますが、別に
扱われる <span class="transnote">(<em>訳注:</em> handle)</span> ファイルの種類も存在します。
例えば <code>cgi-script</code> はファイルが
<a class="glossarylink" href="./glossary.html#cgi" title="用語集を参照">CGI</a> として処理されるように指定します。<br />
参照: <a href="handler.html">Apache のハンドラの使用</a>
</dd>
<dt><a name="hash" id="hash">ハッシュ</a></dt>
<dd>任意の文字列から固定長の文字列を生成する、数学的な一方向で不可逆な
アルゴリズム。異なった入力文字列からは普通は違うハッシュが生成されます
(ハッシュ関数に依存します)。</dd>
<dt><a name="header" id="header">ヘッダ</a></dt>
<dd>実際のコンテンツの前に送られ、コンテンツを説明するメタ情報の
入った <a class="glossarylink" href="./glossary.html#http" title="用語集を参照">HTTP</a> リクエストと応答の一部分。</dd>
<dt><a name="htaccess" id="htaccess">.htaccess</a></dt>
<dd>ウェブツリーに置かれて、そのディレクトリとサブディレクトリに
<a class="glossarylink" href="./glossary.html#directive" title="用語集を参照">ディレクティブ</a> を適用する
<a class="glossarylink" href="./glossary.html#configurationfile" title="用語集を参照">設定ファイル</a>。
名前とは裏腹に、このファイルにはアクセス制御ディレクティブだけでなく、
ほとんどどんな種類のディレクティブでも書くことができます。<br />
参照: <a href="configuring.html">設定ファイル</a>
</dd>
<dt><a name="httpd.conf" id="httpd.conf">httpd.conf</a></dt>
<dd>メインの Apache <a class="glossarylink" href="./glossary.html#configurationfile" title="用語集を参照">設定
ファイル</a>。デフォルトの場所は
<code>/usr/local/apache2/conf/httpd.conf</code>
ですが、実行時やコンパイル時の設定により違う場所に移動されて
いるかもしれません。<br />
参照: <a href="configuring.html">設定ファイル</a>
</dd>
<dt><a name="hypertexttransferprotocol" id="hypertexttransferprotocol">HyperText Transfer Protocol</a>
<a name="http" id="hhtp">(HTTP)</a></dt>
<dd>World Wide Web で使われる標準の転送プロトコル。Apache
は HTTP/1.1 と呼ばれ、<a href="http://ietf.org/rfc/rfc2616.txt">RFC 2616</a>
で定義されているプロトコルのバージョン 1.1 を実装しています。</dd>
<dt><a name="https" id="https">HTTPS</a></dt>
<dd>The HyperText Transfer Protocol (Secure),
World Wide Web での暗号化された標準の通信機構。これは実際は
単に <a class="glossarylink" href="./glossary.html#ssl" title="用語集を参照">SSL</a> 上での HTTP です。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="method" id="method">メソッド</a></dt>
<dd><a class="glossarylink" href="./glossary.html#http" title="用語集を参照">HTTP</a> の文脈では、
クライアントから指定されたリクエスト行に対応するリソース
に対して行なう動作。HTTP では <code>GET</code>, <code>POST</code>,
<code>PUT</code> といったようなメソッドがあります。</dd>
<dt><a name="messagedigest" id="messagedigest">メッセージダイジェスト</a></dt>
<dd>メッセージのハッシュで、メッセージの内容が転送時に変更されていないことの検証に
使える。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="mime-type" id="mime-type">MIME タイプ</a></dt>
<dd>送信されているドキュメントの種類を表すための方法。
この名前はフォーマットが Multipurpose Internet Mail Extensions から
借りてこられたことによります。これはスラッシュで分離された、
主タイプと副タイプからなります。例えば、<code>text/html</code>,
<code>image/gif</code>, <code>application/octet-stream</code> など
があります。HTTP では、MIME タイプは <code>Content-Type</code>
<a class="glossarylink" href="./glossary.html#header" title="用語集を参照">ヘッダ</a> で送信されます。<br />
参照: <a href="mod/mod_mime.html">mod_mime</a>
</dd>
<dt><a name="module" id="module">モジュール</a></dt>
<dd>プログラムの独立した一部分。Apache の機能の多くは使用するかしないかを
選択できるモジュールの中にあります。Apache <code class="program"><a href="./programs/httpd.html">httpd</a></code>
に組み込まれているモジュールは<dfn>静的モジュール</dfn>と呼ばれ、
別に保存され、実行時に読み込むことのできるモジュールは
<dfn>動的モジュール</dfn> もしくは <a class="glossarylink" href="./glossary.html#dso" title="用語集を参照">DSO</a> と
呼ばれます。デフォルトで含まれているモジュールは<dfn>base モジュール</dfn>
と呼ばれます。Apache HTTP サーバの <a class="glossarylink" href="./glossary.html#tarball" title="用語集を参照">tarball</a>
の一部としては配られていない Apache 用のモジュールがあります。
それらは <dfn>サードパーティモジュール</dfn> と呼ばれます。<br />
参照: <a href="mod/">モジュール索引</a>
</dd>
<dt><a name="modulemagicnumber" id="modulemagicnumber">Module Magic
Number</a> (<a name="mmn" id="mmn">MMN</a>)</dt>
<dd>Apache ソースコードで定義されている、モジュールのバイナリ互換性に
関する定数。バイナリ互換性が保てなくなるような Apache 内部の構造体や、
関数呼び出し、その他の API の重要な部分の変更があったときに変更されます。
MMN が変わると、すべてのサードパーティモジュールは少なくとも再コンパイルを
する必要があり、場合によっては新しいバージョンの Apache で動作するために
少し変更する必要さえあるかもしれません。</dd>
<dt><a name="openssl" id="openssl">OpenSSL</a></dt>
<dd>SSL/TLS 用のオープンソースツールキット<br />
参照 <a href="http://www.openssl.org/">http://www.openssl.org/</a>#
</dd>
<dt><a name="passphrase" id="passphrase">パスフレーズ</a></dt>
<dd>秘密鍵のファイルを保護するための語句。権限の無いユーザが
暗号化するのを防ぎます。通常は単に <a class="glossarylink" href="./glossary.html#cipher" title="用語集を参照">Cipher</a> の秘密の暗号用と復号用のキーです。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="plaintext" id="plaintext">平文</a></dt>
<dd>暗号化されていないテキスト。</dd>
<dt><a name="privatekey" id="privatekey">秘密鍵</a></dt>
<dd>受け取るメッセージの復号と送出するメッセージの署名に使われる、
<a class="glossarylink" href="./glossary.html#publickeycryptography" title="用語集を参照">公開鍵暗号</a> の
秘密鍵。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="proxy" id="proxy">プロキシ</a></dt>
<dd>クライアントと <em>オリジンのサーバ</em> の間に存在する中間サーバ。
クライアントからのリクエストを受け取り、オリジンのサーバに送信して、オリジンの
サーバからの応答をクライアントに返します。複数のクライアントが同じ
コンテンツを要求する場合は、毎回元のサーバにリクエストを送る代わり
プロキシはキャッシュからコンテンツを送り、応答時間を短縮することが
できます。<br />
参照: <a href="mod/mod_proxy.html">mod_proxy</a>
</dd>
<dt><a name="publickey" id="publickey">公開鍵</a></dt>
<dd>所有者に向けられたメッセージの暗号化と所有者による署名の復号に使われる、
<a class="glossarylink" href="./glossary.html#publickeycryptography" title="用語集を参照">公開鍵暗号</a>システムに
おける公けにされている鍵。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="publickeycryptography" id="publickeycryptography">公開鍵暗号</a></dt>
<dd>ある鍵を暗号に使い、別の鍵を復号に使う非対称暗号システムについての研究や
その応用を指す。対応する鍵はキーペアと呼ばれます。非対称暗号とも呼ばれます。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="regularexpresion" id="regularexpresion">正規表現</a>
<a name="regex" id="regex">(Regex)</a></dt>
<dd>テキストのパターンを表現する方式の一つ。例えば、
「A で始まるすべての単語」や「すべての 10 桁の電話番号」や、
「コンマが二つあり、大文字の Q がないすべての文」というのでさえ表現
できます。
正規表現は Apache においても便利なもので、ファイルやリソースの集まりに対して
何らかの属性を適用することがとても柔軟にできます。例えば、
すべての "images" ディレクトリの下の、すべての .gif と .jpg ファイル
は <code>/images/.*(jpg|gif)$</code> と書くことができます。
Apache では <a href="http://www.pcre.org/">PCRE</a> ライブラリが提供する
Perl 互換正規表現 <span class="transnote">(<em>訳注:</em> Perl Compatible Regular Expressions)</span>
を使います。</dd>
<dt><a name="reverseproxy" id="reverseproxy">リバースプロキシ</a></dt>
<dd>クライアントには <em>オリジンのサーバ</em> のように見える
<a class="glossarylink" href="./glossary.html#proxy" title="用語集を参照">プロキシ</a> サーバ。セキュリティの
ためや、負荷分散のためにクライアントからオリジンのサーバを隠したいときに
便利です。</dd>
<dt><a name="securesocketslayer" id="securesocketslayer">Secure Sockets
Layer</a> <a name="ssl" id="ssl">(SSL)</a></dt>
<dd>Netscape Communications Corporation により
TCP/IP ネットワーク上で一般の通信の認証と暗号用に作られたプロトコル。
最もよく使われているものは <em>HTTPS</em> つまり SSL 上での
HyperText Transfer Protocol (HTTP) です。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="serversideincludes" id="serversideincludes">Server Side
Includes</a> <a name="ssi" id="ssi">(SSI)</a></dt>
<dd>HTML ファイル中に処理ディレクティブを埋め込む技術の一つ。<br />
参照: <a href="howto/ssi.html">Server Side Includes 入門</a>
</dd>
<dt><a name="session" id="session">セッション</a></dt>
<dd>一般的な通信における文脈情報。</dd>
<dt><a name="ssleay" id="ssleay">SSLeay</a></dt>
<dd>Eric A. Young 氏による SSL/TLS を実装した元々のライブラリ。</dd>
<dt><a name="symmetriccryptophraphy" id="symmetriccryptophraphy">対称暗号</a>
</dt>
<dd>一つの秘密鍵を暗号化と復号の両方に使う <em>Cipher</em> の
研究や応用を指す。</dd>
<dt><a name="tarball" id="tarball">Tarball</a></dt>
<dd><code>tar</code> ユーティリティを使ってまとめられたファイルのパッケージ。
Apache 配布は圧縮された tar アーカイブか pkzip で保管されています。</dd>
<dt><a name="transportlayersecurity" id="transportlayersecurity">Transport
Layer Security</a> <a name="tls" id="tls">(TLS)</a></dt>
<dd>TCP/IP ネットワーク上での一般通信の認証と暗号化用に
Internet Engineering Task Force (IETF) により作成された SSL の
後継プロトコル。TLS バージョン 1 は SSL バージョン 3 とほぼ同じです。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
<dt><a name="uniformresourcelocator" id="uniformresourcelocator">Uniform
Resource Locator</a> <a name="url" id="url">(URL)</a></dt>
<dd>Internet のリソースの名前、もしくはアドレス。これは正式には
<a class="glossarylink" href="./glossary.html#uniformresourceidentifier" title="用語集を参照">Uniform Resource Identifier</a>
と呼ばれるもののよく使われる非公式な名前です。URL は普通は、
<code>http</code> や <code>https</code> といったスキームとホスト名、
パスからなります。このページの URL はおそらく
<code>http://httpd.apache.org/docs/2.4/glossary.html</code>
と思われます。
</dd>
<dt><a name="uniformresourceidentifier" id="uniformresourceidentifier">Uniform Resource Identifier</a>
<a name="URI" id="URI">(URI)</a></dt>
<dd>抽象的なリソースや物理リソースを同定するためのコンパクトな文字列。
正式には <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a> で
定義されています。WWW で使われている URI は通常
<a class="glossarylink" href="./glossary.html#url" title="用語集を参照">URL</a> と呼ばれます。
</dd>
<dt><a name="virtualhosting" id="virtualhosting">バーチャルホスト</a></dt>
<dd>一つの Apache を使って複数のウェブサイトを扱うこと。
<em>IP バーチャルホスト</em> は IP アドレスを使ってウェブサイトを
区別します。また <em>名前ベースのバーチャルホスト</em> は
ホストの名前だけを使って区別するので、同じ IP アドレス上での多くのサイトを
ホストできます。<br />
参照: <a href="vhosts/">Apache バーチャルホストの文書</a>
</dd>
<dt><a name="x.509" id="x.509">X.509</a></dt>
<dd>SSL/TLS 認証に使われている International
Telecommunication Union (ITU-T) により推奨されている認証証明書の形式。<br />
参照: <a href="ssl/">SSL/TLS 暗号化</a>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/glossary.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/glossary.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/glossary.html" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/glossary.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/handler.html.es 0000664 0001751 0001751 00000031337 14743132254 017754 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Uso de los Handlers en Apache - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="./images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="./">Versión 2.4</a></div><div id="page-content"><div id="preamble"><h1>Uso de los Handlers en Apache</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/handler.html" 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="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Este documento describe el uso de los Handlers en Apache.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">¿Qué es un Handler?</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Ejemplos</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programmer">Nota para programadores</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</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">¿Qué es un Handler?</a></h2>
<table class="related"><tr><th>Módulos Relacionados</th><th>Directivas Relacionadas</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_imagemap.html">mod_imagemap</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>Un "handler" es una representación interna de Apache de
una acción que se va a ejecutar cuando hay una llamada a un
fichero. Generalmente, los ficheros tienen handlers
implícitos, basados en el tipo de fichero de que se
trata. Normalmente, todos los ficheros son simplemente servidos
por el servidor, pero algunos tipos de ficheros se tratan de forma
diferente.</p>
<p>Handlers pueden ser usados de manera explicita,
basándose en la extensión del fichero o en
la ubicación en la que esté, se pueden especificar handlers
sin tener en cuenta el tipo de fichero que se trate. Esto es
una ventaja por dos razones. Primero, es una solución
más elegante. Segundo, porque a un fichero se le pueden
asignar tanto un tipo <strong>como</strong> un handler. (Consulte
también la sección <a href="mod/mod_mime.html#multipleext">Ficheros y extensiones
múltiples</a>.)</p>
<p>Los Handlers pueden tanto ser compilados con el servidor
como incluidos en un módulo, o añadidos con la
directiva <code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code>. Los
handlers que vienen incluidos en el core con el servidor de la distribución
estándar de Apache son:</p>
<ul>
<li><strong>default-handler</strong>: Envía el fichero
usando el <code>default_handler()</code>, que es el handler
usado por defecto para tratar contenido
estático. (core)</li>
<li><strong>send-as-is</strong>: Envía el fichero con
cabeceras HTTP tal y como es. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
<li><strong>cgi-script</strong>: Trata el fichero como un sript
CGI. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
<li><strong>imap-file</strong>: Trata el fichero como un mapa de
imágenes. (<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code>)</li>
<li><strong>server-info</strong>: Extrae la información de
configuración del
servidor. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
<li><strong>server-status</strong>: Extrae el informe del estado
del servidor. (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
<li><strong>type-map</strong>: Trata el fichero como una
correspondencia de tipos para la negociación de contenidos.
(<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">Ejemplos</a></h2>
<h3><a name="example1" id="example1">Modificar contenido estático usando un script
CGI</a></h3>
<p>Las siguientes directivas hacen que cuando haya una
petición de ficheros con la extensión
<code>html</code> se lance el script 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>En este caso, el script CGI es el responsable de enviar el
documento originalmente solicitado (contenido en la variable de
entorno <code>PATH_TRANSLATED</code>) y de hacer cualquier
modificación o añadido deseado.</p>
<h3><a name="example2" id="example2">Archivos con cabeceras HTTP</a></h3>
<p>Las siguientes directivas activan el handler
<code>send-as-is</code>, que se usa para ficheros que contienen
sus propias cabeceras HTTP. Todos los archivos en el directorio
<code>/web/htdocs/asis/</code> serán procesados por el
handler <code>send-as-is</code>, sin tener en cuenta su
extension.</p>
<pre class="prettyprint lang-config"><Directory "/web/htdocs/asis">
SetHandler send-as-is
</Directory></pre>
</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">Nota para programadores</a></h2>
<p>Para implementar las funcionalidades de los handlers, se ha
hecho un añadido a la <a href="developer/API.html">API de
Apache</a> que puede que quiera usar. Para ser más
específicos, se ha añadido un nuevo registro a la
estructura <code>request_rec</code>:</p>
<pre class="prettyprint lang-c">char *handler</pre>
<p>Si quiere que su módulo llame a un handler , solo tiene
que añadir <code>r->handler</code> al nombre del handler
en cualquier momento antes de la fase <code>invoke_handler</code>
de la petición. Los handlers se implementan siempre como se
hacía antes, aunque usando el nombre del handler en vez de un
tipo de contenido. Aunque no es de obligado cumplimiento, la
convención de nombres para los handlers es que se usen
palabras separadas por guiones, sin barras, de manera que no se
invada el media type name-space.</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="./en/handler.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/handler.html" 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="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/handler.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/install.html.es 0000664 0001751 0001751 00000072601 14743132254 020004 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Compilar e Instalar - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="./images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="./">Versión 2.4</a></div><div id="page-content"><div id="preamble"><h1>Compilar e Instalar</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Esta traducción podría estar
obsoleta. Consulte la versión en inglés de la
documentación para comprobar si se han producido cambios
recientemente.</div>
<p>Éste documento hace referencia a la compilación y la instalación del Apache
HTTP Server sólo para los sistemas Unix y tipo Unix. Para la compilación e instalación en Windows ir a <a href="platform/windows.html">Usando Apache HTTP Server con Microsoft
Windows</a> y <a href="platform/win_compiling.html">Compilando Apache para Microsoft Windows</a>.
Para otras plataformas visite la documentación sobre <a href="platform/">plataformas</a>.</p>
<p>Apache httpd usa <code>libtool</code> y <code>autoconf</code>
para crear un entorno de compilación que se parece a muchos otros proyectos de código abierto</p>
<p>Si está actualizando desde una versión menor a la siguiente (por
ejemplo, 2.4.8 a 2.4.9), pasa a la sección de <a href="#upgrading">actualización</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Descripción general para los impacientes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#requirements">Requisitos</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#download">Descargar</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extract">Descomprimir</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configure">Configuración de la estructura de
directorios</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#compile">Build</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">Instalar</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#customize">Personalizar APACHE</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#test">Comprobar que la instalación
funciona</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#upgrading">Actualizar una instalación previa</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#thirdp">Paquetes de terceros</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="programs/configure.html">Configuración del árbol de las fuentes de código</a></li><li><a href="invoking.html">Arrancando Apache httpd</a></li><li><a href="stopping.html">Parada y Reinicio</a></li><li><a href="#comments_section">Comentarios</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="overview" id="overview">Descripción general para los impacientes</a></h2>
<table>
<tr>
<td><a href="#download">Descarga</a></td>
<td>Descarga la última versión
desde <a href="http://httpd.apache.org/download.cgi#apache24">
http://httpd.apache.org/download.cgi</a>
</td>
</tr>
<tr>
<td><a href="#extract">Extraer</a></td>
<td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar<br />
$ cd httpd-<em>NN</em></code></td>
</tr>
<tr>
<td><a href="#configure">Configura</a></td>
<td><code>$ ./configure --prefix=<em>PREFIX</em></code>
</td>
</tr>
<tr>
<td><a href="#compile">Compila</a></td>
<td><code>$ make</code> </td>
</tr>
<tr>
<td><a href="#install">Instala</a></td>
<td><code>$ make install</code> </td>
</tr>
<tr>
<td><a href="#customize">Personalizalo</a></td>
<td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
</tr>
<tr>
<td><a href="#test">Prueba</a></td>
<td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
</td>
</tr>
</table>
<p><em>NN</em> hay que reemplazarlo por el número de la versión menor, y <em>PREFIX</em> hay que reemplazarlo por la ruta en la que se va a instalar Apache. Si no especifica ningún valor en <em>PREFIX</em>, el valor por defecto que se toma es /usr/local/apache2.</p>
<p>Cada parte del proceso de configuración e instalación se describe detalladamente más abajo, empezando por los requisitos para compilar e instalar Apache.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="requirements" id="requirements">Requisitos</a></h2>
<p>Estos son los requisitos necesarios para compilar Apache:</p>
<dl>
<dt>APR y APR-Util</dt>
<dd>Asegúrate de que tiene instalado ya en su sistema APR y APR-Util. Si no es así, o no quiere utilizar la versión que le proporciona el sistema, puede descargar la última versión de ambos APR y APR-Util de
<a href="http://apr.apache.org/">Apache APR</a>, descomprimelo en
<code>/httpd_source_tree_root/srclib/apr</code> y /httpd_source_tree_root<code>/srclib/apr-util</code>
(cerciórate de que no existen directorios con números de versiones; por ejemplo,
la distribución de APR debe estar en /httpd_source_tree_root/srclib/apr/) y usa el comando
<code>./configure</code> <code>--con-las-opciones-incluidas-en-apr</code>.
En algunas plataformas deberás instalar la parte correspondiente a los paquetes
<code>-dev</code> para permitir que httpd se genere contra la instalación de la copia de APR y APR-Util.</dd>
<dt>Librería Compatible de expresiones regulares de Perl (PCRE)</dt>
<dd>Esta librería es requerida, pero ya no incluido con httpd.
Descarga el código fuente de <a href="http://www.pcre.org/">http://www.pcre.org</a>,
o instala un Port o un Paquete. Si la distrubución de su sistema no puede encontrar el escript pcre-config instalado por PCRE, seleccione utilizando el parámetro<code>--with-pcre</code>.En algunas plataformas,
deberás instalar la correspondiente versión <code>-dev</code>
del paquete para permitir a httpd que se genere contra la instalación de la copia del PCRE que se ha instalado.</dd>
<dt>Espacio en disco</dt>
<dd>Compruebe que tiene disponibles al
menos 50 MB de espacio libre en disco. Después de la
instalación, Apache ocupa aproximadamente 10 MB. No
obstante, la necesidad real de espacio en disco varía
considerablemente en función de las opciones de
configuración que elija y de los módulos externos que
use, y como no del tamaño de la página web</dd>
<dt>Systema de compilación ANSI-C</dt>
<dd>Compruebe que tiene instalado un compilador de ANSI-C. Se recomienda el <a href="http://gcc.gnu.org/">Compilador GNU C
(GCC)</a> de la <a href="http://www.gnu.org/">Free Software
Foundation (FSF)</a> es el recomendado. Si no tiene instalado el GCC, entonces compruebe que
el compilador que va a utilizar cumple con los estándares
ANSI. Además, su <code>PATH</code> debe contener la
ubicación donde de encuentran las herramientas básicas
para compilar tales como <code>make</code>.</dd>
<dt>Ajuste exacto del reloj del sistema</dt>
<dd>Los elementos
del protocolo HTTP están expresados según la hora del
día. Por eso, si quiere puede investigar como instalar alguna
utilidad para sincronizar la hora de su sistema. Para esto,
normalmente, se usan los programas <code>ntpdate</code> o
<code>xntpd</code>, que están basados en el protocolo
"Network Time Protocol" (NTP). Consulte el<a href="http://www.ntp.org">sitio web de NTP
</a> para obtener más información sobre NTP y los
servidores públicos de tiempo.</dd>
<dt><a href="http://www.perl.org/">Perl 5</a>[OPCIONAL]</dt>
<dd>Para algunos de los scripts de soporte como<code class="program"><a href="./programs/apxs.html">apxs</a></code> o <code class="program"><a href="./programs/dbmmanage.html">dbmmanage</a></code> (que están
escritos en Perl) es necesario el intérprete de Perl 5 (las
versiones 5.003 o posteriores son suficientes). Si el escript
<code class="program"><a href="./programs/configure.html">configure</a></code> no se encuentra, no podrá usar los
escripts correspondientes que lo necesiten. Pero por supuesto
podrás compilar y usar Apache httpd.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="download" id="download">Descargar</a></h2>
<p>Puede descargar Apache desde <a href="http://httpd.apache.org/download.cgi">la sección de
descargas del sitio web de Apache</a> el cual tiene varios
mirrors. Para la mayoría de los usuarios de Apache que tienen
sistemas tipo Unix, se recomienda que se descarguen y compilen el
código fuente. El proceso de compilación (descrito
más abajo) es fácil, y permite adaptar el servidor
Apache a sus necesidades. Además, las versiones de
disponibles en archivos binarios no están siempre actualizadas
con las últimas modificaciones en el código fuente. Si se
descarga un binario, siga las instrucciones contenidas en el
archivo <code>INSTALL.bindist</code> incluido en la
distribución</p>
<p>Después de la descarga, es importante que verifique que el
archivo descargado del servidor HTTP Apache está completo y
sin modificaciones. Esto puede hacerlo comparando el archivo
descargado (.tgz) con su firma PGP. Instrucciones detalladas de
cómo hacer esto están disponibles en <a href="http://httpd.apache.org/download.cgi#verify"> la
sección de descargas</a> junto con un ejemplo de cómo <a href="http://httpd.apache.org/dev/verification.html">usar
PGP</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="extract" id="extract">Descomprimir</a></h2>
<p>Extraer el código fuente del archivo .tgz del Servidor Apache HTTP que acabada
de descargar es muy fácil. Ejecute los siguientes comandos:</p>
<div class="example"><p><code>
$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar
</code></p></div>
<p>Estos comandos crearán un nuevo directorio dentro del
directorio en el que se encuentra y que contendrá el
código fuente de distribución. Debe cambiarse a ese
directorio con <code>cd</code> para proceder a compilar el
servidor Apache.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configure" id="configure">Configuración de la estructura de
directorios</a></h2>
<p>El siguiente paso es configurar la estructura de directorios
para su plataforma y sus necesidades personales. Esto se hace
usando el script <code class="program"><a href="./programs/configure.html">configure</a></code> incluido en el directorio
raíz de la distribución que acaba de descargar. (Los
desarrolladores que se descarguen la versión del CVS de la
estructura de directorios necesitarán tener instalados
<code>autoconf</code> y <code>libtool</code>, y necesitarán
ejecutar <code>buildconf</code> antes de continuar con los
siguientes pasos. Esto no es preciso para las versiones
oficiales.)</p>
<p>Para configurar la estructura de directorios a partir del
código fuente usando las opciones por defecto, solo tiene que
ejecutar <code>./configure</code>.Para cambiar las opciones por
defecto, <code class="program"><a href="./programs/configure.html">configure</a></code> acepta una serie de variables y
opciones por la línea de comandos.</p>
<p>La opción más importante es <code>--prefix</code>
que es el directorio en el que Apache va a ser instalado después,
porque Apache tiene que ser configurado para el directorio que se
especifique para que funcione correctamente. Es posible lograr un
mayor control del lugar donde se van a instalar los ficheros de
Apache con otras <a href="programs/configure.html#installationdirectories">opciones de
configuración</a>.</p>
<p>Llegados a este punto, puede especificar que <a href="programs/configure.html#optionalfeatures">características
o funcionalidades</a> quiere incluir en Apache activando o
desactivando <a href="mod/">modules</a>.Apache vine con una amplia
selección de módulos incluidos por defecto. Que serán compilados como .
<a href="dso.html">Objetos Compartidos (DSOs)</a> Que pueden ser activados
o desactivados en tiempo de ejecución.
También puede elegir por compilar módulos de forma estática usando las opciones
<code>--enable-<var>module</var>=static</code>.</p>
<p>Se pueden activar otros módulos usando la opción
<code>--enable-<var>module</var></code>, where
<var>module</var> es el nombre del módulo sin el
<code>mod_</code> y convirtiendo los guiones bajos que tenga en
guiones normales. Del mismo modo, puede desactivar los módulos con la
opción <code>--disable-<var>module</var></code>. Tenga cuidado al utilizar esta opción, ya que
<code class="program"><a href="./programs/configure.html">configure</a></code> no le avisará si el módulo que especifica no existe;
simplemente ignorará esa opción.</p>
<p>Además, a veces es necesario pasarle al script
<code class="program"><a href="./programs/configure.html">configure</a></code> información adicional sobre donde esta
su compilador, librerías o ficheros de cabecera. Esto se puede
hacer, tanto pasando variables de entorno, como pasandole opciones
a <code class="program"><a href="./programs/configure.html">configure</a></code>. Para más información, consulte el manual de
<code class="program"><a href="./programs/configure.html">configure</a></code>. O use <code class="program"><a href="./programs/configure.html">configure</a></code> con la
opción <code>--help</code>.</p>
<p>Para que se haga una idea sobre las posibilidades que tiene,
aquí tiene un ejemplo típico que configura Apache para
la ruta <code>/sw/pkg/apache</code> con un compilador y unos flags
determinados, y además, con dos módulos adicionales
<code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code> y <code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code> para
cargarlos después a través del mecanismo DSO:</p>
<div class="example"><p><code>
$ CC="pgcc" CFLAGS="-O2" \<br />
./configure --prefix=/sw/pkg/apache \<br />
--enable-ldap=shared \<br />
--enable-lua=shared
</code></p></div>
<p>Cuando se ejecuta <code class="program"><a href="./programs/configure.html">configure</a></code> se comprueban que
características o funcionalidades están disponibles en
su sistema y se crean los Makefiles que serán usados a continuación
para compilar el servidor. Esto tardará algunos minutos.</p>
<p>Los detalles de todas las opciones de <code class="program"><a href="./programs/configure.html">configure</a></code> están disponibles
en el manual de <code class="program"><a href="./programs/configure.html">configure</a></code> .</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="compile" id="compile">Build</a></h2>
<p>Ahora puede compilar las diferentes partes que forman Apache
simplemente ejecutando el siguiente comando:</p>
<div class="example"><p><code>$ make</code></p></div>
<p>Por favor sea paciente llegado a este punto, ya que una configuración básica lleva unos minutos
para su compilación, y el tiempo puede variar mucho dependiendo de su hardware
y del número de módulos que haya habilitado para la compilación.(Se recomienda añadir al make el
parámetro -j3 como mínimo para que vaya más rápido)</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">Instalar</a></h2>
<p>Ahora es el momento de instalar el paquete en el diretorio
elegido en <em>PREFIX</em> (consulte más arriba la opción
<code>--prefix</code>) ejecutando:</p>
<div class="example"><p><code>$ make install</code></p></div>
<p>Este paso requiere de forma típica privilegios de root, ya que
el directorio de <em>PREFIX</em> es normalmente un directorio con
restricciones de permisos escritura.</p>
<p>Si lo que esta es sólo actualizando, la instalación no sobreescribirá los
archivos de configuración.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="customize" id="customize">Personalizar APACHE</a></h2>
<p>Tras la instalación puede personalizarla, editando los
<a href="configuring.html">archivos de configuracion </a> en el directorio de
<code><em>PREFIX</em>/conf/</code>.</p>
<div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
<p>Échele un vistazo al Manual de Apache que está en
<code><em>PREFIX</em>/docs/manual/</code> o consulta <a href="http://httpd.apache.org/docs/2.4/">http://httpd.apache.org/docs/2.4/</a> para la versión más
reciente de este manual y su completa
referencia de las <a href="mod/directives.html">directivas de configuracion</a> disponibles.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="test" id="test">Comprobar que la instalación
funciona</a></h2>
<p>Ahora puedes <a href="invoking.html">ejecutar</a> tu Apache
HTTP server ejecutando directamente:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k start</code></p></div>
<p>Ahora debe poder acceder a su primer documento
bajo la URL <code>http://localhost/</code>. La página o documento que ve se encuentra en
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>,
que por norma general casi siempre será <code><em>PREFIX</em>/htdocs/</code>.
Si quiere <a href="stopping.html">parar</a> el servidor, puede hacerlo ejecutando:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k stop</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="upgrading" id="upgrading">Actualizar una instalación previa</a></h2>
<p>El primer paso para actualizar una instalación anterior es
leer las especificaciones de la versión y el fichero
<code>CHANGES</code> en la distribución de código fuente
que ha descargado para encontrar los cambios que puedan afectar a
su instalación actual. Cuando el cambio sea entre versiones
mayores(por ejemplo, de la 2.0 a 2.2 o de la 2.2 a la 2.4),
entonces es más probable que haya diferencias importantes en
la compilación y en la ejecución que necesitarán
ajustes manuales. Todos los módulos necesitarán
también ser actualizados para adaptarse a los cambios en el
interfaz de programación (API) de módulos.</p>
<p>Actualizando de una versión menor a la siguiente
(por ejemplo, de la 2.2.55 a la 2.2.57) es mas fácil. El prodeso de realizar el <code>make install</code>
no sobreescribirá ninguno de tus documentos existentes,archivos
log, o archivos de configuración. De hecho, los desarrolladores están haciendo los esfuerzos
necerarios para evitar cambios que generen incompatibilidades en las opciones de
<code class="program"><a href="./programs/configure.html">configure</a></code>, la configuración al ser ejecutado, o el módulo de la API
entre versiones menores. En la mayor parte de los casos debe poder usar un
comando <code class="program"><a href="./programs/configure.html">configure</a></code> idéntico, un fichero de
configuración idéntico, y todos sus módulos deben
seguir funcionando.</p>
<p>Para actualizar entre versiones menores, empecemos encontrando el archivo de configuración
<code>config.nice</code> el directorio <code>de instalación</code> del servidor
o en el directorio raiz del código fuente de tu antigua instalación. Este archivo contendrá
los parámetros exactos para pasarle al
<code class="program"><a href="./programs/configure.html">configure</a></code> que usaste anteriormente para configurar tus directorios.
Entonces, para actualizar su instalación de una versión a la
siguinete, solo tiene que copiar el archivo
<code>config.nice</code> a la estructura de directorios del
código fuente de la nueva versión, editarlo, hacer
cualquier cambio que desee, y ejecutarlo :</p>
<div class="example"><p><code>
$ ./config.nice<br />
$ make<br />
$ make install<br />
$ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
$ <em>PREFIX</em>/bin/apachectl -k start<br />
</code></p></div>
<div class="warning">Tenga en cuenta que antes de poner una nueva
versión de Apache en producción, debe siempre probarla
antes en un entorno de pruebas. Por ejemplo, puede instalar y ejecutar la
nueva versión junto con la antigua usando un
<code>--prefix</code> diferente y un puerto diferente (modificando
la directiva <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>)
para comprobar que no existe ninguna incompatibilidad antes de
hacer la actualización definitiva.</div>
<p>Puede pasarle argumentos adicionales a <code>config.nice</code>,
que se agregarán a susopciones originales de <code class="program"><a href="./programs/configure.html">configure</a></code>:</p>
<div class="example"><p><code>
$ ./config.nice --prefix=/home/test/apache --with-port=90
</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="thirdp" id="thirdp">Paquetes de terceros</a></h2>
<p>Un gran número de terceros proporcionan sus propias
distribuciones empaquetadas del Apache HTTP Server para su
instalación en plataformas específicas. Esto incluye las distintas
distribuciones de Linux, varios paquetes de Windows de terceros,
Mac OS X, Solaris, y muchos más.</p>
<p>Nuestra licencia de software no sólo permite, sino que anima,
este tipo de redistribución. Sin embargo, se da lugar a una situación
en la que el diseño y la configuración de los valores predeterminados
de la instalación del servidor pueden diferir de lo que se indica
en la documentación. Mientras lamentablemente, esta situación no es probable que cambie a corto plazo.</p>
<p>Una <a href="http://wiki.apache.org/httpd/DistrosDefaultLayout">descripción
de estas distribuciones de terceros </a> está siendo actualizada en el servidor de la WIKI de HTTP
Server, y debería reflejar el actual estado de éstas distribuciones de terceros.
Sin embargo, tendrá que familiarizarse con los procedimientos de gestión
e instalación de paquetes de su plataforma (SO) en particular.</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/install.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/invoking.html.es 0000664 0001751 0001751 00000033634 14743132254 020165 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Iniciar Apache - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="./images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="./">Versión 2.4</a></div><div id="page-content"><div id="preamble"><h1>Iniciar Apache</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>En Windows, Apache se ejecuta normalmente como un servicio.
Para obtener más información, consulte
<a href="platform/windows.html#winsvc">Ejecutar Apache como un
servicio</a>.</p>
<p>En Unix, el programa <code class="program"><a href="./programs/httpd.html">httpd</a></code> se
ejecuta como un demonio (daemon) de forma contíniua y en segundo plano
y atiende las peticiones que le lleguen. Este documento describe cómo
invocar el programa <code class="program"><a href="./programs/httpd.html">httpd</a></code>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#startup">Cómo iniciar Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errors">Errores Durante el Arranque</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#boot">Iniciar Apache al Iniciar el Sistema</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#info">Información Adicional</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="stopping.html">Parar y reiniciar Apache</a></li><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="#comments_section">Comentarios</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="startup" id="startup">Cómo iniciar Apache</a></h2>
<p>Si el puerto especificado en la directiva <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> del fichero de
configuración es el que viene por defecto, es decir, el
puerto 80 (o cualquier otro puerto por debajo del 1024), entonces
es necesario tener privilegios de usuario root (superusuario) para
iniciar Apache, de modo que pueda establecerse una conexión a
través de esos puertos privilegiados. Una vez que el servidor
Apache se ha iniciado y ha completado algunas tareas preliminares,
tales como abrir sus ficheros log, lanzará varios procesos,
procesos <em>hijo</em>, que hacen el trabajo de escuchar y atender
las peticiones de los clientes. El proceso principal,
<code>httpd</code> continúa ejecutándose con el usuario root, pero los
procesos hijo se ejecutan con menores privilegios de usuario.
Esto lo controla el <a href="mpm.html">Módulo de
MultiProcesamiento (MPM)</a> seleccionado.</p>
<p>La forma recomendada para invocar el ejecutable
<code class="program"><a href="./programs/httpd.html">httpd</a></code> es usando el script de control
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code>. Este script fija
determinadas variables de entorno que son necesarias para que
<code class="program"><a href="./programs/httpd.html">httpd</a></code> funcione correctamente en el sistema operativo,
y después invoca el binario <code class="program"><a href="./programs/httpd.html">httpd</a></code>.
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> pasa a <code class="program"><a href="./programs/httpd.html">httpd</a></code>
cualquier argumento que se le pase a través de la línea de comandos,
de forma que cualquier opción de <code>httpd</code> puede ser usada
también con <code>apachectl</code>. Puede editar
directamente el script <code>apachectl</code> y cambiar la
variable <code>HTTPD</code> variable que está al principio y
que especifica la ubicación exacta en la que está el
binario <code class="program"><a href="./programs/httpd.html">httpd</a></code> y cualquier argumento de línea de
comandos que quiera que esté <em>siempre</em> presente.</p>
<p>La primera cosa que hace <code class="program"><a href="./programs/httpd.html">httpd</a></code> cuando es invocado
es localizar y leer el <a href="configuring.html">fichero de
configuración</a> <code>httpd.conf</code>. El lugar en el que
está ese fichero se determina al compilar, pero también
es posible especificar la ubicación en la que se encuentra al
iniciar el servidor Apache usando la opción de línea de
comandos <code>-f</code></p>
<div class="example"><p><code>/usr/local/apache2/bin/apachectl -f
/usr/local/apache2/conf/httpd.conf</code></p></div>
<p>Si todo va bien durante el arranque, la sesión de terminal
se suspenderá un momento y volverá a estar activa casi
inmediatamente. Esto quiere decir que el servidor está activo
y funcionando. Puede usar su navegador para conectarse al
servidor y ver la página de prueba que hay en el directorio de
la directiva
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errors" id="errors">Errores Durante el Arranque</a></h2>
<p>Si Apache encuentra una error irrecuperable durante el
arranque, escribirá un mensaje describiendo el problema en la
consola o en el archivo <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> antes de abortar la
ejecución. Uno de los mensajes de error más comunes es
"<code>Unable to bind to Port ...</code>". Cuando se recibe este
mensaje es normalmente por alguna de las siguientes razones:</p>
<ul>
<li>Está intentando iniciar el servidor Apache en un puerto
privilegiado (del 0 al 1024) sin haber hecho login como usuario
root; ó bien</li>
<li>Está intentando iniciar el servidor Apache mientras
está ya ejecutando Apache o algún otro servidor web en
el mismo puerto.</li>
</ul>
<p>Puede encontrar más información sobre cómo
solucionar problemas, en la sección de <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> de Apache.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="boot" id="boot">Iniciar Apache al Iniciar el Sistema</a></h2>
<p>Si quiere que el servidor Apache continúe su ejecución
después de reiniciar el sistema, debe añadir una llamada
a <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> en sus archivos de arranque (normalmente
<code>rc.local</code> o un fichero en ese directorio del tipo
<code>rc.N</code>). Esto iniciará Apache como usuario
root. Antes de hacer esto, asegúrese de que la
configuración de seguridad y las restricciones de acceso de
su servidor Apache están correctamente configuradas.</p>
<p>El script <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> está diseñado para
actuar como un script estándar de tipo <code>SysV init</code>; puede tomar los
argumentos <code>start</code>, <code>restart</code>, y
<code>stop</code> y traducirlos en las señales apropiadas
para <code class="program"><a href="./programs/httpd.html">httpd</a></code>. De esta manera, casi siempre puede
simplemente enlazar <code class="program"><a href="./programs/apachectl.html">apachectl</a></code>con el directorio init
adecuado. Pero asegúrese de comprobar los requisitos exactos
de su sistema.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="info" id="info">Información Adicional</a></h2>
<p>En la sección <a href="programs/">El Servidor y Programas
de Soporte </a> puede encontrar más información sobre
las opciones de línea de comandos que puede pasar a <code class="program"><a href="./programs/httpd.html">httpd</a></code> y <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> así como sobre otros
programas de soporte incluidos con el servidor Apache.
También hay documentación sobre todos los <a href="mod/">módulos</a> incluidos con la distribución de
Apache y sus correspondientes <a href="mod/directives.html">directivas</a> asociadas.</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/invoking.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/index.html.zh-cn.utf8 0000664 0001751 0001751 00000021544 14743132254 020742 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP 服务器 2.4 文档 - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="index-page">
<div id="page-header">
<p class="menu"><a href="./mod/">模块</a> | <a href="./mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="./glossary.html">术语</a> | <a href="./sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="./images/feather.png" /></div>
<div class="up"><a href="http://httpd.apache.org/docs-project/"><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></div>
<div id="page-content"><h1>Apache HTTP 服务器 2.4 文档</h1>
<div class="toplang">
<p><span>可用语言: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" title="Simplified Chinese"> zh-cn </a></p>
</div>
<form method="get" action="https://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Google 搜索" type="submit" /><input value="10" name="num" type="hidden" /><input value="zh-cn" name="hl" type="hidden" /><input value="UTF-8" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="版本 2.4" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value=""List-Post"" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form>
<table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">发行说明</a></h2>
<ul><li><a href="new_features_2_4.html">Apache 2.3/2.4 的新特性</a></li>
<li><a href="new_features_2_2.html">Apache 2.1/2.2 的新特性</a></li>
<li><a href="new_features_2_0.html">Apache 2.0 的新特性</a></li>
<li><a href="upgrading.html">从 2.2 升级到 2.4</a></li>
<li><a href="license.html">Apache 许可证</a></li>
</ul>
</div><div class="category"><h2><a name="manual" id="manual">参考手册</a></h2>
<ul><li><a href="install.html">编译与安装</a></li>
<li><a href="invoking.html">启动</a></li>
<li><a href="stopping.html">停止与重启</a></li>
<li><a href="mod/quickreference.html">指令快速参考</a></li>
<li><a href="mod/">模块</a></li>
<li><a href="mpm.html">多处理模块(MPM)</a></li>
<li><a href="filter.html">过滤器</a></li>
<li><a href="handler.html">处理器</a></li>
<li><a href="expr.html">表达式解析器</a></li>
<li><a href="programs/">服务器与支持程序</a></li>
<li><a href="glossary.html">术语</a></li>
</ul>
</div></td><td><div class="category"><h2><a name="usersguide" id="usersguide">用户指南</a></h2>
<ul><li><a href="getting-started.html">入门指南</a></li>
<li><a href="bind.html">绑定指定地址与端口</a></li>
<li><a href="configuring.html">配置文件</a></li>
<li><a href="sections.html">配置片段</a></li>
<li><a href="caching.html">缓存指南</a></li>
<li><a href="content-negotiation.html">内容协商</a></li>
<li><a href="dso.html">动态共享对象(DSO)</a></li>
<li><a href="env.html">环境变量</a></li>
<li><a href="logs.html">日志文件</a></li>
<li><a href="urlmapping.html">从 URL 映射到文件系统</a></li>
<li><a href="misc/perf-tuning.html">性能调谐</a></li>
<li><a href="misc/security_tips.html">安全技巧</a></li>
<li><a href="server-wide.html">服务器全局配置</a></li>
<li><a href="ssl/">SSL/TLS 加密</a></li>
<li><a href="suexec.html">执行 CGI 前的用户切换(suEXEC)</a></li>
<li><a href="rewrite/">URL 改写与 mod_rewrite</a></li>
<li><a href="vhosts/">虚拟主机</a></li>
</ul>
</div></td><td class="col3"><div class="category"><h2><a name="howto" id="howto">指引/教程</a></h2>
<ul><li><a href="howto/auth.html">认证，授权与访问控制</a></li>
<li><a href="howto/access.html">访问控制</a></li>
<li><a href="howto/cgi.html">CGI 与动态内容</a></li>
<li><a href="howto/htaccess.html">.htaccess 文件</a></li>
<li><a href="howto/ssi.html">服务器端插入(SSI)</a></li>
<li><a href="howto/public_html.html">用户私人网站目录(public_html)</a></li>
<li><a href="howto/reverse_proxy.html">反向代理设置指南</a></li>
<li><a href="howto/http2.html">HTTP/2 指南</a></li>
</ul>
</div><div class="category"><h2><a name="platform" id="platform">平台相关说明</a></h2>
<ul><li><a href="platform/windows.html">Microsoft Windows</a></li>
<li><a href="platform/rpm.html">基于RPM安装包的系统 (Redhat / CentOS / Fedora)</a></li>
<li><a href="platform/netware.html">Novell NetWare</a></li>
<li><a href="platform/ebcdic.html">EBCDIC 系统</a></li>
</ul>
</div><div class="category"><h2><a name="other" id="other">其它主题</a></h2>
<ul><li><a href="http://wiki.apache.org/httpd/FAQ">常见问题</a></li>
<li><a href="sitemap.html">网站导航</a></li>
<li><a href="developer/">开发文档</a></li>
<li><a href="http://httpd.apache.org/docs-project/">帮助改进文档</a></li>
<li><a href="misc/">其它说明</a></li>
<li><a href="http://wiki.apache.org/httpd/">维基</a></li>
</ul>
</div></td></tr></table></div>
<div class="bottomlang">
<p><span>可用语言: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="./glossary.html">术语</a> | <a href="./sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/install.html.ko.euc-kr 0000664 0001751 0001751 00000047522 14743132254 021177 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ϰ ġ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>ϰ ġ</h1>
<div class="toplang">
<p><span> : </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> н н ýۿ ġ ϰ
ġϴ ٷ. ϰ ġϴ
<a href="platform/windows.html">ũμƮ
ġ </a> ϶. ٸ ÷ ؼ <a href="platform/">÷</a> ϶.</p>
<p>ġ 2.0 ġ ȯ 1.3 ſ ٸ.
ġ 1.3 ġ ü ũƮ ߴ.
ġ 2.0 ٸ ¼ҽ Ʈ ȯ
<code>libtool</code> <code>autoconf</code>
Ѵ.</p>
<p> Ѵܰ ̵Ѵٸ ( ,
2.0.50 2.0.51), <a href="#upgrading">̵</a>
ٷ ٶ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#requirements">䱸</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#download">ٿε</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extract"> Ǯ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configure">ҽ Ʈ ϱ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#compile"></a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">ġ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#customize"></a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#test">˻</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#upgrading">̵</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="programs/configure.html">ҽ Ʈ </a></li><li><a href="invoking.html">ġ </a></li><li><a href="stopping.html">ġ ߴܰ </a></li><li><a href="#comments_section">Comments</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="overview" id="overview"> </a></h2>
<table>
<tr>
<td><a href="#download">ٿε</a></td>
<td><code>$ lynx http://httpd.apache.org/download.cgi</code>
</td>
</tr>
<tr>
<td><a href="#extract"> Ǯ</a></td>
<td><code>$ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
$ tar xvf httpd-2_1_<em>NN</em>.tar</code> </td>
</tr>
<tr>
<td><a href="#configure"></a></td>
<td><code>$ ./configure --prefix=<em>PREFIX</em></code>
</td>
</tr>
<tr>
<td><a href="#compile"></a></td>
<td><code>$ make</code> </td>
</tr>
<tr>
<td><a href="#install">ġ</a></td>
<td><code>$ make install</code> </td>
</tr>
<tr>
<td><a href="#customize"></a></td>
<td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
</tr>
<tr>
<td><a href="#test">˻</a></td>
<td><code>$ <em>PREFIX</em>/bin/apachectl start</code>
</td>
</tr>
</table>
<p><em>NN</em> ڷ, <em>PREFIX</em>
ġ Ͻý η üؾ Ѵ. <em>PREFIX</em>
⺻ <code>/usr/local/apache2</code>
Ѵ.</p>
<p>Ʒ ġ ϰ ġϱ 䱸
ϰ ġ ڼ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="requirements" id="requirements">䱸</a></h2>
<p>ġ ϱ ͵ ʿϴ:</p>
<dl>
<dt>ũ </dt>
<dd>ũ ּ 50 MB ̻ Ȯ϶.
ġ ġ 10 MB ũ Ѵ.
ʿ ũ ɼǰ ߰
̰ .</dd>
<dt>ANSI-C Ϸ ý</dt>
<dd>ANSI-C Ϸ ġִ Ȯ϶. <a href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
<a href="http://www.gnu.org/software/gcc/gcc.html">GNU C
compiler (GCC)</a> õѴ. ( 2.7.2 ȴ.) GCC
ٸ ּ ϴ Ϸ ANSI ȣȯ Ȯ϶.
߰ <code>PATH</code> ȯ溯 <code>make</code>
⺻ ؾ Ѵ.</dd>
<dt>Ȯ ð</dt>
<dd>HTTP ݿ Ϸ ð ǥϴ κ ִ.
ý ð ȭ 캼 ð̴.
̸ Network Time Protocol (NTP)
<code>ntpdate</code> <code>xntpd</code> Ѵ.
NTP Ʈ ð
<a href="news:comp.protocols.time.ntp">comp.protocols.time.ntp</a>
<a href="http://www.ntp.org">NTP Ȩ</a>
϶.</dd>
<dt><a href="http://www.perl.org/">Perl 5</a>
[û]</dt>
<dd>(Perl ) <a href="programs/apxs.html">apxs</a>
<a href="programs/dbmmanage.html">dbmmanage</a>
ũƮ Perl 5 Ͱ ʿϴ. (
5.003 ̸̻ ȴ.) `<code>configure</code>' ũƮ
ã ص ġ 2.0
ϰ ġ ִ. ٸ ũƮ
̴. Perl Ͱ ġִٸ (Ƹ
춧 Ե Perl 4 Perl 5)
<code>./configure</code> ùٸ ã
<code>--with-perl</code> ɼ (Ʒ ) ϱ ٶ.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="download" id="download">ٿε</a></h2>
<p>ġ ̷ ִ <a href="http://httpd.apache.org/download.cgi">ġ
ٿε Ʈ</a> ٿε ִ. н ý
Ѵٸ ҽڵ带 ٿƼ ϴ .
(Ʒ ) ְ, ڽ 뵵 ˸°
ִ. , ֽ ̳ʸ 쵵
. ̳ʸ ٿ´ٸ ִ
<code>INSTALL.bindist</code> ø .</p>
<p>ٿε ٿ ϰ
ġ Ȯϴ ߿ϴ.
PGP ٿε Ÿ(tarball) ˻Ͽ ȮѴ.
ڼ <a href="http://httpd.apache.org/download.cgi#verify">ٿε
</a> ְ, <a href="http://httpd.apache.org/dev/verification.html">PGP
</a> ϴ ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="extract" id="extract"> Ǯ</a></h2>
<p>ġ Ÿ ҽ Ǫ ۾ ܼ
tar Ǫ ̴:</p>
<div class="example"><p><code>
$ gzip -d httpd-2_1_<em>NN</em>.tar.gz<br />
$ tar xvf httpd-2_1_<em>NN</em>.tar
</code></p></div>
<p> 丮 Ʒ ҽڵ带
ο 丮 . ϱ
丮 <code>cd</code>ؾ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configure" id="configure">ҽ Ʈ ϱ</a></h2>
<p> Ư ÷ ʿ信 ġ
ҽ Ʈ ϴ ̴. ̸ ֻ 丮
ִ <code><a href="programs/configure.html">configure</a></code>
ũƮ Ѵ. (ġ
ҽ Ʈ CVS ٿε ڴ ̹
<code>autoconf</code> <code>libtool</code> ġְ,
Ѿ <code>buildconf</code> ؾ
Ѵ. ̴ ʿ.)</p>
<p> ⺻ ɼ Ͽ ҽ Ʈ Ϸ
<code>./configure</code> Էϸȴ. ⺻ ɼ Ϸ
<code>./configure</code> ɼ Ѵ.</p>
<p> ߿ ɼ ġ ۵ϱ ġ
ϰ ġ <code>--prefix</code>. ٸ <a href="programs/configure.html#installationdirectories">configure
ɼǵ</a> Ͽ ġ ڼ
ִ.</p>
<p><a href="mod/"></a> ϰų ġ
<a href="programs/configure.html#optionalfeatures"></a>
Ѵ. <a href="mod/module-dict.html#Status">Base</a>
⺻ ġ Եȴ. ٸ
<code>--enable-<var>module</var></code> ɼ Ͽ
Ѵ. ⼭ <em>module</em> ̸
<code>mod_</code> ȣ .
<code>--enable-<var>module</var>=shared</code> ɼ ϸ
߿ ϰų ִ <a href="dso.html">ü(shared object, DSO)</a> Ѵ.
, <code>--disable-<var>module</var></code> ɼ Ͽ
Base ִ.
<code>configure</code> ʰ ׳ ϱ
̸ Ȯ Է϶.</p>
<p> <code>configure</code> ũƮ Ϸ,
̺귯, ġ ˷ 찡 ִ.
ȯ溯 <code>configure</code> ɼ
Ͽ Ѵ. ڼ <a href="programs/configure.html">configure manpage</a>
϶.</p>
<p> ִ ɼ ֱ
Ư Ϸ ÷ ϰ ߿ DSO о
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
<code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> ߰Ͽ
<code>/sw/pkg/apache</code> ġ ġ ϴ
̴:</p>
<div class="example"><p><code>
$ CC="pgcc" CFLAGS="-O2" \<br />
./configure --prefix=/sw/pkg/apache \<br />
--enable-rewrite=shared \<br />
--enable-speling=shared
</code></p></div>
<p><code>configure</code> ϸ а ý
˻Ͽ ߿ Ҷ Makefile
.</p>
<p><code>configure</code> ɼǵ鿡 ڼ <a href="programs/configure.html">configure manpage</a> ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="compile" id="compile"></a></h2>
<p> ɾ ϳ ġ κ
ִ:</p>
<div class="example"><p><code>$ make</code></p></div>
<p>⼭ ٷ. Ƽ III/ 2.2 ýۿ
⺻ ϴµ 3 ɸ. ð
ϵ ũ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">ġ</a></h2>
<p> ɾ Ű ( <code>--prefix</code>
ɼ ) ġ ġ <em>PREFIX</em> ġѴ:</p>
<div class="example"><p><code>$ make install</code></p></div>
<p>̵Ѵٸ ġ ̳
ʴ´.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="customize" id="customize"></a></h2>
<p> <code><em>PREFIX</em>/conf/</code> ִ
<a href="configuring.html"></a> Ͽ ġ
Ѵ.</p>
<div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
<p>밡 <a href="mod/directives.html"> þ</a>
ֱ <a href="./">docs/manual/</a>̳ <a href="http://httpd.apache.org/docs/2.4/">http://httpd.apache.org/docs/2.4/</a> ִ ġ
϶.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="test" id="test">˻</a></h2>
<p> ġ <a href="invoking.html"></a> ִ:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl start</code></p></div>
<p> URL <code>http://localhost/</code> ù
ûѴ. Ե Ƹ
<code><em>PREFIX</em>/htdocs/</code> <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> Ʒ ִ.
ɾ ٽ <a href="stopping.html">ߴ</a>Ѵ:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl stop</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="upgrading" id="upgrading">̵</a></h2>
<p>̵Ѵٸ Ʈ ִ ȭ
ִ ˾ƺ ǥ ҽ <code>CHANGES</code>
д´. ( , 1.3 2.0̳ 2.0 2.2
) ū ɼǰ ؾ
ū ȭ ̴. API ȭ
˸° ̵ؾ Ѵ.</p>
<p> Ѵܰ ̵ϴ ( ,
2.0.55 2.0.57) . <code>make install</code> ۾
, α, ʴ´. ,
ڴ <code>configure</code> ɼ, ,
API ȣȯ ȭ ִ ´. κ
<code>configure</code> ,
ְ, 鵵 ̴. (
2.0.41 شѴ. 鿡 ȣȯ
ȭ ִ.)</p>
<p> ġߴ ҽ ִٸ, ̵尡
. ҽ ֻ ִ <code>config.nice</code>
Ͽ ҽ ߴ <code>configure</code>
ɼ ״ ִ. ̵Ѵٸ
ο ҽ <code>config.nice</code> ϰ,
Ѵٸ , Ѵ:</p>
<div class="example"><p><code>
$ ./config.nice<br />
$ make<br />
$ make install<br />
$ <em>PREFIX</em>/bin/apachectl stop<br />
$ <em>PREFIX</em>/bin/apachectl start<br />
</code></p></div>
<div class="warning">ο ϱ ˻غ
Ѵ. , ̵带 ġ ȣȯ
ִ ˾ƺ ٸ <code>--prefix</code> (<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> þ) ٸ Ʈ
Ͽ ο ġ غ
ִ.</div>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/install.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/bind.html.ko.euc-kr 0000664 0001751 0001751 00000025710 14743132254 020440 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ּҿ Ʈ (Binding) - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>ּҿ Ʈ (Binding)</h1>
<div class="toplang">
<p><span> : </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/bind.html" title="Korean"> ko </a> |
<a href="./tr/bind.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>ġ Ư ּҿ Ʈ ϵ ϱ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview"></a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ipv6">IPv6 Ư </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">ȣƮ dz</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="vhosts/">ȣƮ</a></li><li><a href="dns-caveats.html">DNS </a></li><li><a href="#comments_section">Comments</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="overview" id="overview"></a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mpm_common.html">mpm_common</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table>
<p>ġ ϸ ġ ǻ Ʈ ּҿ
Ͽ, û ٸ. ⺻ ġ
ǻ ּҿ ٸ. ġ Ư Ʈ
ּҸ ٸ ؾ 찡 ִ.
ġ ٸ IP ּ, ȣƮ, Ʈ
ϴ ȣƮ ɰ õִ.</p>
<p><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> þ
Ư Ʈ ּҿ Ʈ տ û ް
Ѵ. <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
þ Ʈ ȣ ϸ, ̽
Ʈ ٸ. <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> þ ٸ
ּҿ Ʈ ִ. ּҿ Ʈ
û Ѵ.</p>
<p> , 80 8000 Ʈ ο
Ϸ:</p>
<div class="example"><p><code>
Listen 80<br />
Listen 8000
</code></p></div>
<p> ̽ Ʈ ٸ
Ϸ,</p>
<div class="example"><p><code>
Listen 192.0.2.1:80<br />
Listen 192.0.2.5:8000
</code></p></div>
<p>IPv6 ּҴ ȣ Ѵ:</p>
<div class="example"><p><code>
Listen [2001:db8::a00:20ff:fea7:ccea]:80
</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="ipv6" id="ipv6">IPv6 Ư </a></h2>
<p>IPv6 ÷ ð ְ APR ̵ ÷ κп
IPv6 ϱ, ġ IPv6 ҴϿ IPv6
û ó ִ.</p>
<p>ġ ڿ κ IPv6 IPv4
IPv6 ó ִĴ ̴. κ ÷
IPv4-(mapped) IPv6 ּҸ Ͽ IPv6 Ͽ IPv4
, FreeBSD NetBSD OpenBSD ýü å
⺻ ʴ´. ⺻ ʴ
ý̶ ġ Ư Ķͷ
ִ.</p>
<p>ݸ Tru64 Ϻ ÷ IPv4 IPv6
óϷ ּҸ <strong>ؾ߸</strong>
Ѵ. ġ ּ Ͽ IPv4 IPv6
Ϸ, IPv4- IPv6 ּҸ ϰ
<a href="programs/configure.html">configure</a> ɼ
<code>--enable-v4-mapped</code> Ѵ.</p>
<p><code>--enable-v4-mapped</code> FreeBSD, NetBSD, OpenBSD
÷ ⺻̰, Ƹ ġ
̴.</p>
<p>÷ APR ο ġ IPv4 Ḹ
Ϸ, <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> þ IPv4 ּҸ
Ѵ:</p>
<div class="example"><p><code>
Listen 0.0.0.0:80<br />
Listen 192.0.2.1:80
</code></p></div>
<p>÷ ϸ ġ ٸ IPv4
IPv6 Ϸ ( IPv4- ּҸ
), <a href="programs/configure.html">configure</a>
ɼ <code>--disable-v4-mapped</code>
Ѵ. <code>--disable-v4-mapped</code> FreeBSD, NetBSD,
OpenBSD ⺻̴.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">ȣƮ dz</a></h2>
<p><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
ȣƮ ʴ´. ̴ ּ
ּҿ Ʈ ٸ ˷ش. <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> þ
, û Ȱ óѴ.
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> ּҿ Ʈ
ٸ ൿ ִ. ȣƮ
ּҿ Ʈ ˷ Ѵ.
Ư ּҿ Ʈ ȣƮ ൿ
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
ʿϴ. ּ ٸʴ ּҿ Ʈ ϴ
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
϶.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/bind.html" title="Korean"> ko </a> |
<a href="./tr/bind.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/bind.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/configuring.html.ko.euc-kr 0000664 0001751 0001751 00000033325 14743132254 022037 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title> - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1></h1>
<div class="toplang">
<p><span> : </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" title="Korean"> ko </a> |
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ġ ϴ ϵ Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#main">ּ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#syntax"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules"></a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#scope">þ </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#htaccess">.htaccess </a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="main" id="main">ּ</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#include">Include</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code></li></ul></td></tr></table>
<p>Ϲ Ͽ <a href="mod/directives.html">þ</a> Ͽ ġ
Ѵ. ּ <code>httpd.conf</code>
θ. ġ Ͻ , <code>-f</code>
ɼ ִ. ٸ <code class="directive"><a href="./mod/core.html#include">Include</a></code> þ Ͽ
ְ, ϵī带 Ͽ
ִ. þ Ͽ ص ȴ.
ּ ϸ ġ ϰų Ŀ
ݿȴ.</p>
<p> mime Ÿ ϵ д´. ϸ
<code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code> þ
ϰ, ⺻ <code>mime.types</code>̴.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="syntax" id="syntax"> </a></h2>
<p>ġ ٿ þ Ѵ.
ڰ 齽 "\"̸ þ ٿ ӵ Ѵ.
齽 ڿ ڳ 鵵 ȵȴ.</p>
<p> þ ҹڸ , þ
ƱԸƮ ҹڸ ϴ 찡 ִ. ؽ "#"
ϴ ּ Ѵ. ּ þ
ٿ <strong></strong>. ٰ þ տ
ϹǷ, ϰ ̵ þ ٵ(indent)
ִ.</p>
<p><code>apachectl configtest</code> <code>-t</code>
ɼ Ͽ ġ ʰ
˻ ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="modules" id="modules"></a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>ġ ȭ . ̴ ſ ⺻ ɸ
ٽɿ Ե Ѵ. ġ <a href="mod/"></a> о鿩
ȮѴ. ⺻ ϸ <a href="mod/module-dict.html#Status">base</a> Եȴ.
<a href="dso.html"> о̴</a>
ְ Ͽٸ Ͽ ƹ
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> þ
߰ ִ. ߰ϰų
ġ ٽ ؾ Ѵ. þ <code class="directive"><a href="./mod/core.html#ifmodule">IfModule</a></code> μ Ư
ִ 쿡 ó ִ.</p>
<p> ϵִ <code>-l</code>
ɼ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="scope" id="scope">þ </a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>ּϿ ִ þ ü ȴ. þ
Ϻο ǰ Ϸ þ <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#files"><Files></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code>, <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> ȿ ξѴ.
ǵ δ þ Ͻý̳
URL Ư ġ Ѵ. , ļ ֱ
ſ ϴ.</p>
<p>ġ ٸ Ʈ ÿ ϴ
ɷ ִ. ̸ <a href="vhosts/">ȣƮ</a> Ѵ.
þ
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
ȿ ξ Ư Ʈ þ ִ.</p>
<p>þ κ ǿ ͵ , þ
Ư ҿ ǹ̰ . μ ϴ
þ ּ ҿ ִ. þ
ǿ ġ ִ ˷ þ <a href="mod/directive-dict.html#Context"></a> Ȯ϶.
ڼ <a href="sections.html"> Directory,
Location, Files ϳ</a> ϶.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="htaccess" id="htaccess">.htaccess </a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
<p>ġ Ư Ͽ
(б) ִ. Ư
<code>.htaccess</code> θ, ̸ <code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code> þ
ִ. <code>.htaccess</code> Ͽ ִ þ
ִ 丮 丮 ȴ.
<code>.htaccess</code> ּϰ
. <code>.htaccess</code> û б
ϸ ȿ ִ.</p>
<p> þ <code>.htaccess</code> Ͽ
ִ ˷ þ <a href="mod/directive-dict.html#Context"></a>
Ȯ϶. ڴ ּ <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> þ
<code>.htaccess</code> Ͽ þ ִ
ִ.</p>
<p><code>.htaccess</code> Ͽ ڼ
<a href="howto/htaccess.html">.htaccess 丮</a>
϶.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" title="Korean"> ko </a> |
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/configuring.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/ 0000775 0001751 0001751 00000000000 15032766627 017032 5 ustar covener covener httpd-2.4.64/docs/manual/developer/modules.html 0000664 0001751 0001751 00000000315 13710016232 021344 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: modules.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: modules.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/developer/thread_safety.html 0000664 0001751 0001751 00000000174 13710016232 022521 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: thread_safety.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/developer/documenting.html 0000664 0001751 0001751 00000000333 13710016232 022210 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: documenting.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: documenting.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/developer/modguide.html 0000664 0001751 0001751 00000000167 13710016232 021476 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: modguide.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/developer/request.html 0000664 0001751 0001751 00000000166 13710016232 021370 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: request.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/developer/index.html.zh-cn.utf8 0000664 0001751 0001751 00000013733 14743132254 022730 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache 2.0 开发者文档 - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">模块</a> | <a href="../mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Apache 2.0 开发者文档</h1>
<div class="toplang">
<p><span>可用语言: </span><a href="../en/developer/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../zh-cn/developer/" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">此翻译可能过期。要了解最近的更改，请阅读英文版。</div>
<p>开发者页面的许多文档都来自于 Apache 1.3。当更新到 Apache 2
时，它们可能位于不同的阶段。请耐心等待，或者直接向
<a href="http://httpd.apache.org/lists.html#http-dev">dev@httpd.apache.org</a> 邮件列表报告开发者页面的差异或错误。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#topics">主题</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#external">外部资源</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="topics" id="topics">主题</a></h2>
<ul>
<li><a href="API.html">Apache 1.3 API 说明</a></li>
<li><a href="new_api_2_4.html">在 Apache 2.3/2.4 中的 API 改变</a></li>
<li><a href="hooks.html">Apache 2.x 钩子函数</a></li>
<li><a href="request.html">Apache 2.x 中的请求处理</a></li>
<li><a href="filters.html">Apache 2.x 中的过滤器</a></li>
<li><a href="output-filters.html">Apache 2.x 中的输出过滤器指南</a></li>
<li><a href="modules.html">将模块从 Apache 1.3 移植到 Apache 2.x</a></li>
<li><a href="debugging.html">在 APR 中调试内存分配</a></li>
<li><a href="documenting.html">Apache 2.x 文档</a></li>
<li><a href="thread_safety.html">Apache 2.x 的线程安全问题</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="external" id="external">外部资源</a></h2>
<ul>
<li><a href="http://ci.apache.org/projects/httpd/trunk/doxygen/">自动生成的 Apache HTTP 服务器 (trunk) 代码文档</a></li>
<li>Kevin O'Donnell 的模块开发教程
<ul>
<li><a href="http://threebit.net/tutorials/apache2_modules/tut1/tutorial1.html">集成模块到 Apache 构建系统</a></li>
<li><a href="http://threebit.net/tutorials/apache2_modules/tut2/tutorial2.html">处理配置指令</a></li>
</ul></li>
<li><a href="http://www.onlamp.com/pub/ct/38">Ryan Bloom 对 Apache 模块开发的说明</a></li>
<li>位于 <a href="http://www.apachetutor.org/">apachetutor</a> 的开发者文章:
<ul>
<li><a href="http://www.apachetutor.org/dev/request">Apache 中的请求处理</a></li>
<li><a href="http://www.apachetutor.org/dev/config">模块的配置</a></li>
<li><a href="http://www.apachetutor.org/dev/pools">Apache 中的资源管理</a></li>
<li><a href="http://www.apachetutor.org/dev/reslist">Apache 中的连接池</a></li>
<li><a href="http://www.apachetutor.org/dev/brigades">桶与队列简介</a></li>
</ul></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>可用语言: </span><a href="../en/developer/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../zh-cn/developer/" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/documenting.html.en 0000664 0001751 0001751 00000015456 14737241666 022652 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Documenting code in Apache 2.4 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>Documenting code in Apache 2.4</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/documenting.html" title="English"> en </a> |
<a href="../zh-cn/developer/documenting.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Apache 2.4 uses <a href="http://www.doxygen.org/">Doxygen</a> to
document the APIs and global variables in the code. This will explain
the basics of how to document using Doxygen.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="brief" id="brief">Brief Description</a></h2>
<p>To start a documentation block, use <code>/**</code><br />
To end a documentation block, use <code>*/</code></p>
<p>In the middle of the block, there are multiple tags we can
use:</p>
<div class="example"><p><code>
Description of this functions purpose<br />
@param parameter_name description<br />
@return description<br />
@deffunc signature of the function<br />
</code></p></div>
<p>The <code>deffunc</code> is not always necessary. DoxyGen does not
have a full parser in it, so any prototype that use a macro in the
return type declaration is too complex for scandoc. Those functions
require a <code>deffunc</code>. An example (using &gt; rather
than >):</p>
<div class="example"><p><code>
/**<br />
* return the final element of the pathname<br />
* @param pathname The path to get the final element of<br />
* @return the final element of the path<br />
* @tip Examples:<br />
* <pre><br />
* "/foo/bar/gum" -&gt; "gum"<br />
* "/foo/bar/gum/" -&gt; ""<br />
* "gum" -&gt; "gum"<br />
* "wi\\n32\\stuff" -&gt; "stuff"<br />
* </pre><br />
* @deffunc const char * ap_filename_of_pathname(const char *pathname)<br />
*/
</code></p></div>
<p>At the top of the header file, always include:</p>
<div class="example"><p><code>
/**<br />
* @package Name of library header<br />
*/
</code></p></div>
<p>Doxygen uses a new HTML file for each package. The HTML files are named
{Name_of_library_header}.html, so try to be concise with your names.</p>
<p>For a further discussion of the possibilities please refer to
<a href="http://www.doxygen.org/">the Doxygen site</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/documenting.html" title="English"> en </a> |
<a href="../zh-cn/developer/documenting.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/documenting.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/documenting.html.zh-cn.utf8 0000664 0001751 0001751 00000015305 14743132254 024132 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache 2.0 文档 - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">模块</a> | <a href="../mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">开发者文档</a></div><div id="page-content"><div id="preamble"><h1>Apache 2.0 文档</h1>
<div class="toplang">
<p><span>可用语言: </span><a href="../en/developer/documenting.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../zh-cn/developer/documenting.html" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">此翻译可能过期。要了解最近的更改，请阅读英文版。</div>
<p>Apache 2.0 使用 <a href="http://www.doxygen.org/">Doxygen</a> 从代码中
生成 API 和全局变量的文档。下面是对使用 Doxygen 生成文档的简介。</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="brief" id="brief">简要说明</a></h2>
<p>使用 <code>/**</code> 开始文档块<br />
使用 <code>*/</code> 结束文档块</p>
<p>在文档块中，我们可以使用多个标签:</p>
<div class="example"><p><code>
Description of this functions purpose<br />
@param parameter_name description<br />
@return description<br />
@deffunc signature of the function<br />
</code></p></div>
<p>一般不需要 <code>deffunc</code> 。DoxyGen 没有完整的解析器，所以任何
在返回类型声明中使用宏的原型，都是太复杂了。这些函数就需要使用 <code>deffunc</code>。
例如 (使用 &gt; 而不是 >):</p>
<div class="example"><p><code>
/**<br />
* return the final element of the pathname<br />
* @param pathname The path to get the final element of<br />
* @return the final element of the path<br />
* @tip Examples:<br />
* <pre><br />
* "/foo/bar/gum" -&gt; "gum"<br />
* "/foo/bar/gum/" -&gt; ""<br />
* "gum" -&gt; "gum"<br />
* "wi\\n32\\stuff" -&gt; "stuff"<br />
* </pre><br />
* @deffunc const char * ap_filename_of_pathname(const char *pathname)<br />
*/
</code></p></div>
<p>总是在头文件开始包含:</p>
<div class="example"><p><code>
/**<br />
* @package Name of library header<br />
*/
</code></p></div>
<p>Doxygen 为每个包生成一个新的 HTML 文件，名字是
{Name_of_library_header}.html，所以请简化名称。</p>
<p>更深入的讨论，请参见
<a href="http://www.doxygen.org/">Doxygen 站点</a>。</p>
</div></div>
<div class="bottomlang">
<p><span>可用语言: </span><a href="../en/developer/documenting.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../zh-cn/developer/documenting.html" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">评论</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/documenting.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/debugging.html.en 0000664 0001751 0001751 00000010563 14737241666 022263 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Debugging Memory Allocation in APR - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>Debugging Memory Allocation in APR</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/debugging.html" title="English"> en </a></p>
</div>
<p>
This document has been removed.
</p>
</div>
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/debugging.html" title="English"> en </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/debugging.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/index.html.en 0000664 0001751 0001751 00000014044 14737241666 021435 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Developer Documentation for the Apache HTTP Server 2.4 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Developer Documentation for the Apache HTTP Server 2.4</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/" title="English"> en </a> |
<a href="../zh-cn/developer/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="warning"><h3>Warning</h3>
<p>Many of the documents listed here are in need of update.
They are in different stages of progress.
Please be patient and follow <a href="https://httpd.apache.org/docs-project/">this link</a>
to propose a fix or point out any error/discrepancy.</p>
</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#developing">2.4 development documents</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#upgrading">Upgrading to 2.4</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#external">Other Resources</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="developing" id="developing">2.4 development documents</a></h2>
<ul>
<li><a href="modguide.html">Developing modules for the Apache HTTP Server 2.4</a></li>
<li><a href="hooks.html">Hook Functions in 2.4</a></li>
<li><a href="request.html">Request Processing in 2.4</a></li>
<li><a href="filters.html">How filters work in 2.4</a></li>
<li><a href="output-filters.html">Guidelines for output filters in 2.4</a></li>
<li><a href="documenting.html">Documenting code in 2.4</a></li>
<li><a href="thread_safety.html">Thread Safety Issues in 2.4</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="upgrading" id="upgrading">Upgrading to 2.4</a></h2>
<ul>
<li><a href="new_api_2_4.html">API changes in 2.3/2.4</a></li>
<li><a href="modules.html">Converting Modules from 1.3 to 2.x</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="external" id="external">Other Resources</a></h2>
<ul>
<li><a href="http://ci.apache.org/projects/httpd/trunk/doxygen/">Autogenerated Apache HTTP Server (trunk) code documentation</a> (the link is built by
this <a href="https://ci.apache.org/builders/httpd-doxygen-nightly">job</a>).
</li>
<li>Developer articles at <a href="http://www.apachetutor.org/">apachetutor</a> include:
<ul>
<li><a href="http://www.apachetutor.org/dev/request">Request Processing</a></li>
<li><a href="http://www.apachetutor.org/dev/config">Configuration for Modules</a></li>
<li><a href="http://www.apachetutor.org/dev/pools">Resource Management</a></li>
<li><a href="http://www.apachetutor.org/dev/reslist">Connection Pooling</a></li>
<li><a href="http://www.apachetutor.org/dev/brigades">Introduction to Buckets and Brigades</a></li>
</ul></li>
<li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Report a bug or feature request</a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/" title="English"> en </a> |
<a href="../zh-cn/developer/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/modguide.html.en 0000664 0001751 0001751 00000214422 14737241666 022125 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Developing modules for the Apache HTTP Server 2.4 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Developer</a></div><div id="page-content"><div id="preamble"><h1>Developing modules for the Apache HTTP Server 2.4</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/modguide.html" title="English"> en </a></p>
</div>
<p>This document explains how you can develop modules for the Apache HTTP
Server 2.4</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#basics">Defining a module</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#hooking">Getting started: Hooking into the server</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#handling">Building a handler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuration">Adding configuration options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#context">Context aware configurations</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#summary">Summing up</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#snippets">Some useful snippets of code</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="request.html">Request Processing in Apache 2.4</a></li><li><a href="hooks.html">Apache 2.x Hook Functions</a></li><li><a href="#comments_section">Comments</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="introduction" id="introduction">Introduction</a></h2>
<h3><a name="what" id="what">What we will be discussing in this document</a></h3>
<p>
This document will discuss how you can create modules for the Apache
HTTP Server 2.4, by exploring an example module called
<code>mod_example</code>. In the first part of this document, the purpose
of this module will be to calculate and print out various digest values for
existing files on your web server, whenever we access the URL <code>
http://hostname/filename.sum</code>. For instance, if we want to know the
MD5 digest value of the file located at <code>
http://www.example.com/index.html</code>, we would visit <code>
http://www.example.com/index.html.sum</code>.
</p>
<p>
In the second part of this document, which deals with configuration
directive and context awareness, we will be looking at a module that simply
writes out its own configuration to the client.
</p>
<h3><a name="prerequisites" id="prerequisites">Prerequisites</a></h3>
<p>
First and foremost, you are expected to have a basic knowledge of how the C
programming language works. In most cases, we will try to be as pedagogical
as possible and link to documents describing the functions used in the
examples, but there are also many cases where it is necessary to either
just assume that "it works" or do some digging yourself into what the hows
and whys of various function calls.
</p>
<p>
Lastly, you will need to have a basic understanding of how modules are
loaded and configured in the Apache HTTP Server, as well as how to get the headers for
Apache if you do not have them already, as these are needed for compiling
new modules.
</p>
<h3><a name="compiling" id="compiling">Compiling your module</a></h3>
<p>
To compile the source code we are building in this document, we will be
using <a href="../programs/apxs.html">APXS</a>. Assuming your source file
is called mod_example.c, compiling, installing and activating the module is
as simple as:
</p>
<div class="example"><pre>apxs -i -a -c mod_example.c</pre></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="basics" id="basics">Defining a module</a></h2>
<p>
<img src="../images/build_a_mod_3.png" alt="Module name tags" /><br />
Every module starts with the same declaration, or name tag if you will,
that defines a module as <em>a separate entity within Apache</em>:</p>
<pre class="prettyprint lang-c">module AP_MODULE_DECLARE_DATA example_module =
{
STANDARD20_MODULE_STUFF,
create_dir_conf, /* Per-directory configuration handler */
merge_dir_conf, /* Merge handler for per-directory configurations */
create_svr_conf, /* Per-server configuration handler */
merge_svr_conf, /* Merge handler for per-server configurations */
directives, /* Any directives we may have for httpd */
register_hooks /* Our hook registering function */
};</pre>
<p>
This bit of code lets the server know that we have now registered a new module
in the system, and that its name is <code>example_module</code>. The name
of the module is used primarily for two things:<br />
</p>
<ul>
<li>Letting the server know how to load the module using the LoadModule</li>
<li>Setting up a namespace for the module to use in configurations</li>
</ul>
<p>
For now, we're only concerned with the first purpose of the module name,
which comes into play when we need to load the module:
</p>
<pre class="prettyprint lang-config">LoadModule example_module modules/mod_example.so</pre>
<p>
In essence, this tells the server to open up <code>mod_example.so</code> and look for a module
called <code>example_module</code>.
</p>
<p>
Within this name tag of ours is also a bunch of references to how we would
like to handle things: Which directives do we respond to in a configuration
file or .htaccess, how do we operate within specific contexts, and what
handlers are we interested in registering with the Apache HTTP service. We'll
return to all these elements later in this document.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="hooking" id="hooking">Getting started: Hooking into the server</a></h2>
<h3><a name="hook_intro" id="hook_intro">An introduction to hooks</a></h3>
<p>
When handling requests in Apache HTTP Server 2.4, the first thing you will need to do is
create a hook into the request handling process. A hook is essentially a
message telling the server that you are willing to either serve or at least
take a glance at certain requests given by clients. All handlers, whether
it's mod_rewrite, mod_authn_*, mod_proxy and so on, are hooked into
specific parts of the request process. As you are probably aware, modules
serve different purposes; Some are authentication/authorization handlers,
others are file or script handlers while some third modules rewrite URIs or
proxies content. Furthermore, in the end, it is up to the user of the server
how and when each module will come into place. Thus, the server itself does not
presume to know which module is responsible for handling a specific
request, and will ask each module whether they have an interest in a given
request or not. It is then up to each module to either gently decline
serving a request, accept serving it or flat out deny the request from
being served, as authentication/authorization modules do: <br />
<img src="../images/build_a_mod_2.png" alt="Hook handling in httpd" /><br />
To make it a bit easier for handlers such as our mod_example to know
whether the client is requesting content we should handle or not, the server
has directives for hinting to modules whether their assistance is needed or
not. Two of these are <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>
and <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>. Let's take a look at
an example using <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>. In
our example case, we want every request ending with .sum to be served by
<code>mod_example</code>, so we'll add a configuration directive that tells
the server to do just that:
</p>
<pre class="prettyprint lang-config">AddHandler example-handler .sum</pre>
<p>
What this tells the server is the following: <em>Whenever we receive a request
for a URI ending in .sum, we are to let all modules know that we are
looking for whoever goes by the name of "example-handler" </em>.
Thus, when a request is being served that ends in .sum, the server will let all
modules know, that this request should be served by "example-handler
". As you will see later, when we start building mod_example, we will
check for this handler tag relayed by <code>AddHandler</code> and reply to
the server based on the value of this tag.
</p>
<h3><a name="hook_declaration" id="hook_declaration">Hooking into httpd</a></h3>
<p>
To begin with, we only want to create a simple handler that replies to the
client browser when a specific URL is requested, so we won't bother setting
up configuration handlers and directives just yet. Our initial module
definition will look like this:</p>
<pre class="prettyprint lang-c">module AP_MODULE_DECLARE_DATA example_module =
{
STANDARD20_MODULE_STUFF,
NULL,
NULL,
NULL,
NULL,
NULL,
register_hooks /* Our hook registering function */
};</pre>
<p>This lets the server know that we are not interested in anything fancy, we
just want to hook onto the requests and possibly handle some of them. </p>
<p> The reference in our example declaration, <code>register_hooks</code>
is the name of a function we will create to manage how we hook onto the
request process. In this example module, the function has just one purpose;
To create a simple hook that gets called after all the rewrites, access
control etc has been handled. Thus, we will let the server know that we want
to hook into its process as one of the last modules:
</p>
<pre class="prettyprint lang-c">static void register_hooks(apr_pool_t *pool)
{
/* Create a hook in the request handler, so we get called when a request arrives */
ap_hook_handler(example_handler, NULL, NULL, APR_HOOK_LAST);
}</pre>
<p>
The <code>example_handler</code> reference is the function that will handle
the request. We will discuss how to create a handler in the next chapter.
</p>
<h3><a name="hook_others" id="hook_others">Other useful hooks</a></h3>
<p>
Hooking into the request handling phase is but one of many hooks that you
can create. Some other ways of hooking are:
</p>
<ul>
<li><code>ap_hook_child_init</code>: Place a hook that executes when a child process is spawned (commonly used for initializing modules after the server has forked)</li>
<li><code>ap_hook_pre_config</code>: Place a hook that executes before any configuration data has been read (very early hook)</li>
<li><code>ap_hook_post_config</code>: Place a hook that executes after configuration has been parsed, but before the server has forked</li>
<li><code>ap_hook_pre_translate_name</code>: Place a hook that executes when a URI needs to be translated into a filename on the server, before decoding</li>
<li><code>ap_hook_translate_name</code>: Place a hook that executes when a URI needs to be translated into a filename on the server (think <code>mod_rewrite</code>)</li>
<li><code>ap_hook_quick_handler</code>: Similar to <code>ap_hook_handler</code>, except it is run before any other request hooks (translation, auth, fixups etc)</li>
<li><code>ap_hook_log_transaction</code>: Place a hook that executes when the server is about to add a log entry of the current request</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="handling" id="handling">Building a handler</a></h2>
<p>
A handler is essentially a function that receives a callback when a request
to the server is made. It is passed a record of the current request (how it was
made, which headers and requests were passed along, who's giving the
request and so on), and is put in charge of either telling the server that it's
not interested in the request or handle the request with the tools provided.
</p>
<h3><a name="simple_handler" id="simple_handler">A simple "Hello, world!"
handler</a></h3>
<p>Let's start off by making a very simple request handler
that does the following:
</p>
<ol>
<li>Check that this is a request that should be served by "example-handler"</li>
<li>Set the content type of our output to <code>text/html</code></li>
<li>Write "Hello, world!" back to the client browser</li>
<li>Let the server know that we took care of this request and everything went fine</li>
</ol>
<p>
In C code, our example handler will now look like this:
</p>
<pre class="prettyprint lang-c">static int example_handler(request_rec *r)
{
/* First off, we need to check if this is a call for the "example-handler" handler.
* If it is, we accept it and do our things, if not, we simply return DECLINED,
* and the server will try somewhere else.
*/
if (!r->handler || strcmp(r->handler, "example-handler")) return (DECLINED);
/* Now that we are handling this request, we'll write out "Hello, world!" to the client.
* To do so, we must first set the appropriate content type, followed by our output.
*/
ap_set_content_type(r, "text/html");
ap_rprintf(r, "Hello, world!");
/* Lastly, we must tell the server that we took care of this request and everything went fine.
* We do so by simply returning the value OK to the server.
*/
return OK;
}</pre>
<p>
Now, we put all we have learned together and end up with a program that
looks like
<a href="http://people.apache.org/~humbedooh/mods/examples/mod_example_1.c">mod_example_1.c</a>
. The functions used in this example will be explained later in the section
<a href="#functions">"Some useful functions you should know"</a>.
</p>
<h3><a name="request_rec" id="request_rec">The request_rec structure</a></h3>
<p>The most essential part of any request is the <em>request record
</em>. In a call to a handler function, this is represented by the <code>
request_rec* </code> structure passed along with every call that is made.
This struct, typically just referred to as <code>r</code> in modules,
contains all the information you need for your module to fully process any
HTTP request and respond accordingly.</p> <p>Some key elements of the <code>
request_rec </code> structure are:
</p>
<ul>
<li><code>r->handler (char*):</code> Contains the name of the handler the server is currently asking to do the handling of this request</li>
<li><code>r->method (char*):</code> Contains the HTTP method being used, f.x. GET or POST</li>
<li><code>r->filename (char*):</code> Contains the translated filename the client is requesting</li>
<li><code>r->args (char*):</code> Contains the query string of the request, if any</li>
<li><code>r->headers_in (apr_table_t*):</code> Contains all the headers sent by the client</li>
<li><code>r->connection (conn_rec*):</code> A record containing information about the current connection</li>
<li><code>r->user (char*):</code> If the URI requires authentication, this is set to the username provided</li>
<li><code>r->useragent_ip (char*):</code> The IP address of the client connecting to us</li>
<li><code>r->pool (apr_pool_t*)</code>: The memory pool of this request. We'll discuss this in the
"<a href="#memory">Memory management</a>" chapter.</li>
</ul>
<p>
A complete list of all the values contained within the <code>request_rec</code> structure can be found in
the <a href="http://svn.apache.org/repos/asf/httpd/httpd/trunk/include/httpd.h"><code>httpd.h</code></a> header
file or at <a href="http://ci.apache.org/projects/httpd/trunk/doxygen/structrequest__rec.html">http://ci.apache.org/projects/httpd/trunk/doxygen/structrequest__rec.html</a>.
</p>
<p>
Let's try out some of these variables in another example handler:<br />
</p>
<pre class="prettyprint lang-c">static int example_handler(request_rec *r)
{
/* Set the appropriate content type */
ap_set_content_type(r, "text/html");
/* Print out the IP address of the client connecting to us: */
ap_rprintf(r, "<h2>Hello, %s!</h2>", r->useragent_ip);
/* If we were reached through a GET or a POST request, be happy, else sad. */
if ( !strcmp(r->method, "POST") || !strcmp(r->method, "GET") ) {
ap_rputs("You used a GET or a POST method, that makes us happy!<br/>", r);
}
else {
ap_rputs("You did not use POST or GET, that makes us sad :(<br/>", r);
}
/* Lastly, if there was a query string, let's print that too! */
if (r->args) {
ap_rprintf(r, "Your query string was: %s", r->args);
}
return OK;
}</pre>
<h3><a name="return_value" id="return_value">Return values</a></h3>
<p>
Apache relies on return values from handlers to signify whether a request
was handled or not, and if so, whether the request went well or not. If a
module is not interested in handling a specific request, it should always
return the value <code>DECLINED</code>. If it is handling a request, it
should either return the generic value <code>OK</code>, or a specific HTTP
status code, for example:
</p>
<pre class="prettyprint lang-c">static int example_handler(request_rec *r)
{
/* Return 404: Not found */
return HTTP_NOT_FOUND;
}</pre>
<p>
Returning <code>OK</code> or a HTTP status code does not necessarily mean
that the request will end. The server may still have other handlers that are
interested in this request, for instance the logging modules which, upon a
successful request, will write down a summary of what was requested and how
it went. To do a full stop and prevent any further processing after your
module is done, you can return the value <code>DONE</code> to let the server
know that it should cease all activity on this request and carry on with
the next, without informing other handlers.
<br />
<strong>General response codes:</strong>
</p>
<ul>
<li><code>DECLINED</code>: We are not handling this request</li>
<li><code>OK</code>: We handled this request and it went well</li>
<li><code>DONE</code>: We handled this request and the server should just close this thread without further processing</li>
</ul>
<p>
<strong>HTTP specific return codes (excerpt):</strong>
</p>
<ul>
<li><code>HTTP_OK (200)</code>: Request was okay</li>
<li><code>HTTP_MOVED_PERMANENTLY (301)</code>: The resource has moved to a new URL</li>
<li><code>HTTP_UNAUTHORIZED (401)</code>: Client is not authorized to visit this page</li>
<li><code>HTTP_FORBIDDEN (403)</code>: Permission denied</li>
<li><code>HTTP_NOT_FOUND (404)</code>: File not found</li>
<li><code>HTTP_INTERNAL_SERVER_ERROR (500)</code>: Internal server error (self explanatory)</li>
</ul>
<h3><a name="functions" id="functions">Some useful functions you should know</a></h3>
<ul>
<li>
<code>ap_rputs(const char *string, request_rec *r)</code>: <br />
Sends a string of text to the client. This is a shorthand version of <a href="http://ci.apache.org/projects/httpd/trunk/doxygen/group__APACHE__CORE__PROTO.html#gac827cd0537d2b6213a7c06d7c26cc36e">
ap_rwrite</a>.
<pre class="prettyprint lang-c">ap_rputs("Hello, world!", r);</pre>
</li>
<li>
<code>
<a href="http://ci.apache.org/projects/httpd/trunk/doxygen/group__APACHE__CORE__PROTO.html#ga5e91eb6ca777c9a427b2e82bf1eeb81d">ap_rprintf</a></code>: <br />
This function works just like <code>printf</code>, except it sends the result to the client.
<pre class="prettyprint lang-c">ap_rprintf(r, "Hello, %s!", r->useragent_ip);</pre>
</li>
<li>
<code>
<a href="http://ci.apache.org/projects/httpd/trunk/doxygen/group__APACHE__CORE__PROTO.html#gaa2f8412c400197338ec509f4a45e4579">ap_set_content_type</a>(request_rec *r, const char *type)</code>: <br />
Sets the content type of the output you are sending.
<pre class="prettyprint lang-c">ap_set_content_type(r, "text/plain"); /* force a raw text output */</pre>
</li>
</ul>
<h3><a name="memory" id="memory">Memory management</a></h3>
<p>
Managing your resources in Apache HTTP Server 2.4 is quite easy, thanks to the memory pool
system. In essence, each server, connection and request have their own
memory pool that gets cleaned up when its scope ends, e.g. when a request
is done or when a server process shuts down. All your module needs to do is
latch onto this memory pool, and you won't have to worry about having to
clean up after yourself - pretty neat, huh?
</p>
<p>
In our module, we will primarily be allocating memory for each request, so
it's appropriate to use the <code>r->pool</code>
reference when creating new objects. A few of the functions for allocating
memory within a pool are:
</p>
<ul>
<li><code>void* <a href="http://apr.apache.org/docs/apr/1.4/group__apr__pools.html#ga85f1e193c31d109affda72f9a92c6915">apr_palloc</a>(
apr_pool_t *p, apr_size_t size)</code>: Allocates <code>size</code> number of bytes in the pool for you</li>
<li><code>void* <a href="http://apr.apache.org/docs/apr/1.4/group__apr__pools.html#gaf61c098ad258069d64cdf8c0a9369f9e">apr_pcalloc</a>(
apr_pool_t *p, apr_size_t size)</code>: Allocates <code>size</code> number of bytes in the pool for you and sets all bytes to 0</li>
<li><code>char* <a href="http://apr.apache.org/docs/apr/1.4/group__apr__strings.html#gabc79e99ff19abbd7cfd18308c5f85d47">apr_pstrdup</a>(
apr_pool_t *p, const char *s)</code>: Creates a duplicate of the string <code>s</code>. This is useful for copying constant values so you can edit them</li>
<li><code>char* <a href="http://apr.apache.org/docs/apr/1.4/group__apr__strings.html#ga3eca76b8d293c5c3f8021e45eda813d8">apr_psprintf</a>(
apr_pool_t *p, const char *fmt, ...)</code>: Similar to <code>sprintf</code>, except the server supplies you with an appropriately allocated target variable</li>
</ul>
<p>Let's put these functions into an example handler:</p>
<pre class="prettyprint lang-c">static int example_handler(request_rec *r)
{
const char *original = "You can't edit this!";
char *copy;
int *integers;
/* Allocate space for 10 integer values and set them all to zero. */
integers = apr_pcalloc(r->pool, sizeof(int)*10);
/* Create a copy of the 'original' variable that we can edit. */
copy = apr_pstrdup(r->pool, original);
return OK;
}</pre>
<p>
This is all well and good for our module, which won't need any
pre-initialized variables or structures. However, if we wanted to
initialize something early on, before the requests come rolling in, we
could simply add a call to a function in our <code>register_hooks</code>
function to sort it out:
</p>
<pre class="prettyprint lang-c">static void register_hooks(apr_pool_t *pool)
{
/* Call a function that initializes some stuff */
example_init_function(pool);
/* Create a hook in the request handler, so we get called when a request arrives */
ap_hook_handler(example_handler, NULL, NULL, APR_HOOK_LAST);
}</pre>
<p>
In this pre-request initialization function we would not be using the
same pool as we did when allocating resources for request-based functions.
Instead, we would use the pool given to us by the server for allocating memory
on a per-process based level.
</p>
<h3><a name="parsing" id="parsing">Parsing request data</a></h3>
<p>
In our example module, we would like to add a feature, that checks which
type of digest, MD5 or SHA1 the client would like to see. This could be
solved by adding a query string to the request. A query string is typically
comprised of several keys and values put together in a string, for instance
<code>valueA=yes&valueB=no&valueC=maybe</code>. It is up to the
module itself to parse these and get the data it requires. In our example,
we'll be looking for a key called <code>digest</code>, and if set to <code>
md5</code>, we'll produce an MD5 digest, otherwise we'll produce a SHA1
digest.
</p>
<p>
Since the introduction of Apache HTTP Server 2.4, parsing request data from GET and
POST requests have never been easier. All we require to parse both GET and
POST data is four simple lines:
</p>
<pre class="prettyprint lang-c">
<a href="http://ci.apache.org/projects/httpd/trunk/doxygen/group__apr__tables.html#gad7ea82d6608a4a633fc3775694ab71e4">apr_table_t</a> *GET; <em>
</em><a href="http://ci.apache.org/projects/httpd/trunk/doxygen/structapr__array__header__t.html">apr_array_header_t</a>*POST;
<em>
</em>
<a href="http://ci.apache.org/projects/httpd/trunk/doxygen/group__APACHE__CORE__SCRIPT.html#gaed25877b529623a4d8f99f819ba1b7bd">
ap_args_to_table</a>(r, &GET); <em>
</em><a href="http://ci.apache.org/projects/httpd/trunk/doxygen/group__APACHE__CORE__DAEMON.html#ga9d426b6382b49754d4f87c55f65af202">
ap_parse_form_data</a>(r, NULL, &POST, -1, 8192);</pre>
<p>
In our specific example module, we're looking for the <code>digest</code>
value from the query string, which now resides inside a table called <code>
GET</code>. To extract this value, we need only perform a simple operation:
</p>
<pre class="prettyprint lang-c">/* Get the "digest" key from the query string, if any. */
const char *digestType = apr_table_get(GET, "digest");
/* If no key was returned, we will set a default value instead. */
if (!digestType) digestType = "sha1";</pre>
<p>
The structures used for the POST and GET data are not exactly the same, so
if we were to fetch a value from POST data instead of the query string, we
would have to resort to a few more lines, as outlined in <a href="#get_post">this example</a> in the last chapter of this document.
</p>
<h3><a name="advanced_handler" id="advanced_handler">Making an advanced handler</a></h3>
<p>
Now that we have learned how to parse form data and manage our resources,
we can move on to creating an advanced version of our module, that spits
out the MD5 or SHA1 digest of files:
</p>
<pre class="prettyprint lang-c">static int example_handler(request_rec *r)
{
int rc, exists;
apr_finfo_t finfo;
apr_file_t *file;
char *filename;
char buffer[256];
apr_size_t readBytes;
int n;
apr_table_t *GET;
apr_array_header_t *POST;
const char *digestType;
/* Check that the "example-handler" handler is being called. */
if (!r->handler || strcmp(r->handler, "example-handler")) return (DECLINED);
/* Figure out which file is being requested by removing the .sum from it */
filename = apr_pstrdup(r->pool, r->filename);
filename[strlen(filename)-4] = 0; /* Cut off the last 4 characters. */
/* Figure out if the file we request a sum on exists and isn't a directory */
rc = apr_stat(&finfo, filename, APR_FINFO_MIN, r->pool);
if (rc == APR_SUCCESS) {
exists =
(
(finfo.filetype != APR_NOFILE)
&& !(finfo.filetype & APR_DIR)
);
if (!exists) return HTTP_NOT_FOUND; /* Return a 404 if not found. */
}
/* If apr_stat failed, we're probably not allowed to check this file. */
else return HTTP_FORBIDDEN;
/* Parse the GET and, optionally, the POST data sent to us */
ap_args_to_table(r, &GET);
ap_parse_form_data(r, NULL, &POST, -1, 8192);
/* Set the appropriate content type */
ap_set_content_type(r, "text/html");
/* Print a title and some general information */
ap_rprintf(r, "<h2>Information on %s:</h2>", filename);
ap_rprintf(r, "<b>Size:</b> %u bytes<br/>", finfo.size);
/* Get the digest type the client wants to see */
digestType = apr_table_get(GET, "digest");
if (!digestType) digestType = "MD5";
rc = apr_file_open(&file, filename, APR_READ, APR_OS_DEFAULT, r->pool);
if (rc == APR_SUCCESS) {
/* Are we trying to calculate the MD5 or the SHA1 digest? */
if (!strcasecmp(digestType, "md5")) {
/* Calculate the MD5 sum of the file */
union {
char chr[16];
uint32_t num[4];
} digest;
apr_md5_ctx_t md5;
apr_md5_init(&md5);
readBytes = 256;
while ( apr_file_read(file, buffer, &readBytes) == APR_SUCCESS ) {
apr_md5_update(&md5, buffer, readBytes);
}
apr_md5_final(digest.chr, &md5);
/* Print out the MD5 digest */
ap_rputs("<b>MD5: </b><code>", r);
for (n = 0; n < APR_MD5_DIGESTSIZE/4; n++) {
ap_rprintf(r, "%08x", digest.num[n]);
}
ap_rputs("</code>", r);
/* Print a link to the SHA1 version */
ap_rputs("<br/><a href='?digest=sha1'>View the SHA1 hash instead</a>", r);
}
else {
/* Calculate the SHA1 sum of the file */
union {
char chr[20];
uint32_t num[5];
} digest;
apr_sha1_ctx_t sha1;
apr_sha1_init(&sha1);
readBytes = 256;
while ( apr_file_read(file, buffer, &readBytes) == APR_SUCCESS ) {
apr_sha1_update(&sha1, buffer, readBytes);
}
apr_sha1_final(digest.chr, &sha1);
/* Print out the SHA1 digest */
ap_rputs("<b>SHA1: </b><code>", r);
for (n = 0; n < APR_SHA1_DIGESTSIZE/4; n++) {
ap_rprintf(r, "%08x", digest.num[n]);
}
ap_rputs("</code>", r);
/* Print a link to the MD5 version */
ap_rputs("<br/><a href='?digest=md5'>View the MD5 hash instead</a>", r);
}
apr_file_close(file);
}
/* Let the server know that we responded to this request. */
return OK;
}</pre>
<p>
This version in its entirety can be found here:
<a href="http://people.apache.org/~humbedooh/mods/examples/mod_example_2.c">mod_example_2.c</a>.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuration" id="configuration">Adding configuration options</a></h2>
<p>
In this next segment of this document, we will turn our eyes away from the
digest module and create a new example module, whose only function is to
write out its own configuration. The purpose of this is to examine how
the server works with configuration, and what happens when you start writing
advanced configurations
for your modules.
</p>
<h3><a name="config_intro" id="config_intro">An introduction to configuration
directives</a></h3>
<p>
If you are reading this, then you probably already know
what a configuration directive is. Simply put, a directive is a way of
telling an individual module (or a set of modules) how to behave, such as
these directives control how <code>mod_rewrite</code> works:
</p>
<pre class="prettyprint lang-config">RewriteEngine On
RewriteCond "%{REQUEST_URI}" "^/foo/bar"
RewriteRule "^/foo/bar/(.*)$" "/foobar?page=$1"</pre>
<p>
Each of these configuration directives are handled by a separate function,
that parses the parameters given and sets up a configuration accordingly.
</p>
<h3><a name="config_simple" id="config_simple">Making an example configuration</a></h3>
<p>To begin with, we'll create a basic configuration in C-space:</p>
<pre class="prettyprint lang-c">typedef struct {
int enabled; /* Enable or disable our module */
const char *path; /* Some path to...something */
int typeOfAction; /* 1 means action A, 2 means action B and so on */
} example_config;</pre>
<p>
Now, let's put this into perspective by creating a very small module that
just prints out a hard-coded configuration. You'll notice that we use the
<code>register_hooks</code> function for initializing the configuration
values to their defaults:
</p>
<pre class="prettyprint lang-c">typedef struct {
int enabled; /* Enable or disable our module */
const char *path; /* Some path to...something */
int typeOfAction; /* 1 means action A, 2 means action B and so on */
} example_config;
static example_config config;
static int example_handler(request_rec *r)
{
if (!r->handler || strcmp(r->handler, "example-handler")) return(DECLINED);
ap_set_content_type(r, "text/plain");
ap_rprintf(r, "Enabled: %u\n", config.enabled);
ap_rprintf(r, "Path: %s\n", config.path);
ap_rprintf(r, "TypeOfAction: %x\n", config.typeOfAction);
return OK;
}
static void register_hooks(apr_pool_t *pool)
{
config.enabled = 1;
config.path = "/foo/bar";
config.typeOfAction = 0x00;
ap_hook_handler(example_handler, NULL, NULL, APR_HOOK_LAST);
}
/* Define our module as an entity and assign a function for registering hooks */
module AP_MODULE_DECLARE_DATA example_module =
{
STANDARD20_MODULE_STUFF,
NULL, /* Per-directory configuration handler */
NULL, /* Merge handler for per-directory configurations */
NULL, /* Per-server configuration handler */
NULL, /* Merge handler for per-server configurations */
NULL, /* Any directives we may have for httpd */
register_hooks /* Our hook registering function */
};</pre>
<p>
So far so good. To access our new handler, we could add the following to
our configuration:
</p>
<pre class="prettyprint lang-config"><Location "/example">
SetHandler example-handler
</Location></pre>
<p>
When we visit, we'll see our current configuration being spit out by our
module.
</p>
<h3><a name="register_directive" id="register_directive">Registering directives with the server</a></h3>
<p>
What if we want to change our configuration, not by hard-coding new values
into the module, but by using either the httpd.conf file or possibly a
.htaccess file? It's time to let the server know that we want this to be
possible. To do so, we must first change our <em>name tag</em> to include a
reference to the configuration directives we want to register with the server:
</p>
<pre class="prettyprint lang-c">module AP_MODULE_DECLARE_DATA example_module =
{
STANDARD20_MODULE_STUFF,
NULL, /* Per-directory configuration handler */
NULL, /* Merge handler for per-directory configurations */
NULL, /* Per-server configuration handler */
NULL, /* Merge handler for per-server configurations */
example_directives, /* Any directives we may have for httpd */
register_hooks /* Our hook registering function */
};</pre>
<p>
This will tell the server that we are now accepting directives from the
configuration files, and that the structure called <code>example_directives
</code> holds information on what our directives are and how they work.
Since we have three different variables in our module configuration, we
will add a structure with three directives and a NULL at the end:
</p>
<pre class="prettyprint lang-c">static const command_rec example_directives[] =
{
AP_INIT_TAKE1("exampleEnabled", example_set_enabled, NULL, RSRC_CONF, "Enable or disable mod_example"),
AP_INIT_TAKE1("examplePath", example_set_path, NULL, RSRC_CONF, "The path to whatever"),
AP_INIT_TAKE2("exampleAction", example_set_action, NULL, RSRC_CONF, "Special action value!"),
{ NULL }
};</pre>
<p>
<img src="../images/build_a_mod_4.png" alt="Directives structure" /><br />
As you can see, each directive needs at least 5 parameters set:
</p>
<ol>
<li><code><a href="http://ci.apache.org/projects/httpd/trunk/doxygen/group__APACHE__CORE__CONFIG.html#ga07c7d22ae17805e61204463326cf9c34">AP_INIT_TAKE1</a></code>: This is a macro that tells the server that this directive takes one and only one argument.
If we required two arguments, we could use the macro <code><a href="http://ci.apache.org/projects/httpd/trunk/doxygen/group__APACHE__CORE__CONFIG.html#gafaec43534fcf200f37d9fecbf9247c21">AP_INIT_TAKE2</a></code> and so on (refer to httpd_conf.h
for more macros).</li>
<li><code>exampleEnabled</code>: This is the name of our directive. More precisely, it is what the user must put in his/her
configuration in order to invoke a configuration change in our module.</li>
<li><code>example_set_enabled</code>: This is a reference to a C function that parses the directive and sets the configuration
accordingly. We will discuss how to make this in the following paragraph.</li>
<li><code>RSRC_CONF</code>: This tells the server where the directive is permitted. We'll go into details on this value in the
later chapters, but for now, <code>RSRC_CONF</code> means that the server will only accept these directives in a server context.</li>
<li><code>"Enable or disable...."</code>: This is simply a brief description of what the directive does.</li>
</ol>
<p>
(<em>The "missing" parameter in our definition, which is usually set to
<code>NULL</code>, is an optional function that can be run after the
initial function to parse the arguments have been run. This is usually
omitted, as the function for verifying arguments might as well be used to
set them.</em>)
</p>
<h3><a name="directive_handler" id="directive_handler">The directive handler function</a></h3>
<p>
Now that we have told the server to expect some directives for our module, it's
time to make a few functions for handling these. What the server reads in the
configuration file(s) is text, and so naturally, what it passes along to
our directive handler is one or more strings, that we ourselves need to
recognize and act upon. You'll notice, that since we set our <code>
exampleAction</code> directive to accept two arguments, its C function also
has an additional parameter defined:</p>
<pre class="prettyprint lang-c">/* Handler for the "exampleEnabled" directive */
const char *example_set_enabled(cmd_parms *cmd, void *cfg, const char *arg)
{
if(!strcasecmp(arg, "on")) config.enabled = 1;
else config.enabled = 0;
return NULL;
}
/* Handler for the "examplePath" directive */
const char *example_set_path(cmd_parms *cmd, void *cfg, const char *arg)
{
config.path = arg;
return NULL;
}
/* Handler for the "exampleAction" directive */
/* Let's pretend this one takes one argument (file or db), and a second (deny or allow), */
/* and we store it in a bit-wise manner. */
const char *example_set_action(cmd_parms *cmd, void *cfg, const char *arg1, const char *arg2)
{
if(!strcasecmp(arg1, "file")) config.typeOfAction = 0x01;
else config.typeOfAction = 0x02;
if(!strcasecmp(arg2, "deny")) config.typeOfAction += 0x10;
else config.typeOfAction += 0x20;
return NULL;
}</pre>
<h3><a name="directive_complete" id="directive_complete">Putting it all together</a></h3>
<p>
Now that we have our directives set up, and handlers configured for them,
we can assemble our module into one big file:
</p>
<pre class="prettyprint lang-c">/* mod_example_config_simple.c: */
#include <stdio.h>
#include "apr_hash.h"
#include "ap_config.h"
#include "ap_provider.h"
#include "httpd.h"
#include "http_core.h"
#include "http_config.h"
#include "http_log.h"
#include "http_protocol.h"
#include "http_request.h"
/*
==============================================================================
Our configuration prototype and declaration:
==============================================================================
*/
typedef struct {
int enabled; /* Enable or disable our module */
const char *path; /* Some path to...something */
int typeOfAction; /* 1 means action A, 2 means action B and so on */
} example_config;
static example_config config;
/*
==============================================================================
Our directive handlers:
==============================================================================
*/
/* Handler for the "exampleEnabled" directive */
const char *example_set_enabled(cmd_parms *cmd, void *cfg, const char *arg)
{
if(!strcasecmp(arg, "on")) config.enabled = 1;
else config.enabled = 0;
return NULL;
}
/* Handler for the "examplePath" directive */
const char *example_set_path(cmd_parms *cmd, void *cfg, const char *arg)
{
config.path = arg;
return NULL;
}
/* Handler for the "exampleAction" directive */
/* Let's pretend this one takes one argument (file or db), and a second (deny or allow), */
/* and we store it in a bit-wise manner. */
const char *example_set_action(cmd_parms *cmd, void *cfg, const char *arg1, const char *arg2)
{
if(!strcasecmp(arg1, "file")) config.typeOfAction = 0x01;
else config.typeOfAction = 0x02;
if(!strcasecmp(arg2, "deny")) config.typeOfAction += 0x10;
else config.typeOfAction += 0x20;
return NULL;
}
/*
==============================================================================
The directive structure for our name tag:
==============================================================================
*/
static const command_rec example_directives[] =
{
AP_INIT_TAKE1("exampleEnabled", example_set_enabled, NULL, RSRC_CONF, "Enable or disable mod_example"),
AP_INIT_TAKE1("examplePath", example_set_path, NULL, RSRC_CONF, "The path to whatever"),
AP_INIT_TAKE2("exampleAction", example_set_action, NULL, RSRC_CONF, "Special action value!"),
{ NULL }
};
/*
==============================================================================
Our module handler:
==============================================================================
*/
static int example_handler(request_rec *r)
{
if(!r->handler || strcmp(r->handler, "example-handler")) return(DECLINED);
ap_set_content_type(r, "text/plain");
ap_rprintf(r, "Enabled: %u\n", config.enabled);
ap_rprintf(r, "Path: %s\n", config.path);
ap_rprintf(r, "TypeOfAction: %x\n", config.typeOfAction);
return OK;
}
/*
==============================================================================
The hook registration function (also initializes the default config values):
==============================================================================
*/
static void register_hooks(apr_pool_t *pool)
{
config.enabled = 1;
config.path = "/foo/bar";
config.typeOfAction = 3;
ap_hook_handler(example_handler, NULL, NULL, APR_HOOK_LAST);
}
/*
==============================================================================
Our module name tag:
==============================================================================
*/
module AP_MODULE_DECLARE_DATA example_module =
{
STANDARD20_MODULE_STUFF,
NULL, /* Per-directory configuration handler */
NULL, /* Merge handler for per-directory configurations */
NULL, /* Per-server configuration handler */
NULL, /* Merge handler for per-server configurations */
example_directives, /* Any directives we may have for httpd */
register_hooks /* Our hook registering function */
};</pre>
<p>
In our httpd.conf file, we can now change the hard-coded configuration by
adding a few lines:
</p>
<pre class="prettyprint lang-config">ExampleEnabled On
ExamplePath "/usr/bin/foo"
ExampleAction file allow</pre>
<p>
And thus we apply the configuration, visit <code>/example</code> on our
web site, and we see the configuration has adapted to what we wrote in our
configuration file.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="context" id="context">Context aware configurations</a></h2>
<h3><a name="context_intro" id="context_intro">Introduction to context aware configurations</a></h3>
<p>
In Apache HTTP Server 2.4, different URLs, virtual hosts, directories etc can have very
different meanings to the user of the server, and thus different contexts
within which modules must operate. For example, let's assume you have this
configuration set up for mod_rewrite:
</p>
<pre class="prettyprint lang-config"><Directory "/var/www">
RewriteCond "%{HTTP_HOST}" "^example.com$"
RewriteRule "(.*)" "http://www.example.com/$1"
</Directory>
<Directory "/var/www/sub">
RewriteRule "^foobar$" "index.php?foobar=true"
</Directory></pre>
<p>
In this example, you will have set up two different contexts for
mod_rewrite:</p>
<ol>
<li>Inside <code>/var/www</code>, all requests for <code>http://example.com</code> must go to <code>http://www.example.com</code></li>
<li>Inside <code>/var/www/sub</code>, all requests for <code>foobar</code> must go to <code>index.php?foobar=true</code></li>
</ol>
<p>
If mod_rewrite (or the entire server for that matter) wasn't context aware, then
these rewrite rules would just apply to every and any request made,
regardless of where and how they were made, but since the module can pull
the context specific configuration straight from the server, it does not need
to know itself, which of the directives are valid in this context, since
the server takes care of this.</p>
<p>
So how does a module get the specific configuration for the server,
directory or location in question? It does so by making one simple call:
</p>
<pre class="prettyprint lang-c">example_config *config = (example_config*) <a href="http://ci.apache.org/projects/httpd/trunk/doxygen/group__APACHE__CORE__CONFIG.html#ga1093a5908a384eacc929b028c79f2a02">ap_get_module_config</a>(r->per_dir_config, &example_module);</pre>
<p>
That's it! Of course, a whole lot goes on behind the scenes, which we will
discuss in this chapter, starting with how the server came to know what our
configuration looks like, and how it came to be set up as it is in the
specific context.
</p>
<h3><a name="context_base" id="context_base">Our basic configuration setup</a></h3>
<p>In this chapter, we will be working with a slightly modified version of
our previous context structure. We will set a <code>context</code>
variable that we can use to track which context configuration is being
used by the server in various places:
</p>
<pre class="prettyprint lang-c">typedef struct {
char context[256];
char path[256];
int typeOfAction;
int enabled;
} example_config;</pre>
<p>Our handler for requests will also be modified, yet still very simple:</p>
<pre class="prettyprint lang-c">static int example_handler(request_rec *r)
{
if(!r->handler || strcmp(r->handler, "example-handler")) return(DECLINED);
example_config *config = (example_config*) ap_get_module_config(r->per_dir_config, &example_module);
ap_set_content_type(r, "text/plain");
ap_rprintf("Enabled: %u\n", config->enabled);
ap_rprintf("Path: %s\n", config->path);
ap_rprintf("TypeOfAction: %x\n", config->typeOfAction);
ap_rprintf("Context: %s\n", config->context);
return OK;
}</pre>
<h3><a name="context_which" id="context_which">Choosing a context</a></h3>
<p>
Before we can start making our module context aware, we must first define,
which contexts we will accept. As we saw in the previous chapter, defining
a directive required five elements be set:</p>
<pre class="prettyprint lang-c">AP_INIT_TAKE1("exampleEnabled", example_set_enabled, NULL, RSRC_CONF, "Enable or disable mod_example"),</pre>
<p>The <code>RSRC_CONF</code> definition told the server that we would only allow
this directive in a global server context, but since we are now trying out
a context aware version of our module, we should set this to something
more lenient, namely the value <code>ACCESS_CONF</code>, which lets us use
the directive inside <Directory> and <Location> blocks. For more
control over the placement of your directives, you can combine the following
restrictions together to form a specific rule:
</p>
<ul>
<li><code>RSRC_CONF</code>: Allow in .conf files (not .htaccess) outside <Directory> or <Location></li>
<li><code>ACCESS_CONF</code>: Allow in .conf files (not .htaccess) inside <Directory> or <Location></li>
<li><code>OR_OPTIONS</code>: Allow in .conf files and .htaccess when <code>AllowOverride Options</code> is set</li>
<li><code>OR_FILEINFO</code>: Allow in .conf files and .htaccess when <code>AllowOverride FileInfo</code> is set</li>
<li><code>OR_AUTHCFG</code>: Allow in .conf files and .htaccess when <code>AllowOverride AuthConfig</code> is set</li>
<li><code>OR_INDEXES</code>: Allow in .conf files and .htaccess when <code>AllowOverride Indexes</code> is set</li>
<li><code>OR_ALL</code>: Allow anywhere in .conf files and .htaccess</li>
</ul>
<h3><a name="context_pool" id="context_pool">Using the server to allocate configuration slots</a></h3>
<p> A much smarter way to manage your configurations is by letting the server
help you create them. To do so, we must first start off by changing our
<em>name tag</em> to let the server know, that it should assist us in creating
and managing our configurations. Since we have chosen the per-directory
(or per-location) context for our module configurations, we'll add a
per-directory creator and merger function reference in our tag:</p>
<pre class="prettyprint lang-c">module AP_MODULE_DECLARE_DATA example_module =
{
STANDARD20_MODULE_STUFF,
create_dir_conf, /* Per-directory configuration handler */
merge_dir_conf, /* Merge handler for per-directory configurations */
NULL, /* Per-server configuration handler */
NULL, /* Merge handler for per-server configurations */
directives, /* Any directives we may have for httpd */
register_hooks /* Our hook registering function */
};</pre>
<h3><a name="context_new" id="context_new">Creating new context configurations</a></h3>
<p>
Now that we have told the server to help us create and manage configurations,
our first step is to make a function for creating new, blank
configurations. We do so by creating the function we just referenced in
our name tag as the Per-directory configuration handler:</p>
<pre class="prettyprint lang-c">void *create_dir_conf(apr_pool_t *pool, char *context) {
context = context ? context : "(undefined context)";
example_config *cfg = apr_pcalloc(pool, sizeof(example_config));
if(cfg) {
/* Set some default values */
strcpy(cfg->context, context);
cfg->enabled = 0;
cfg->path = "/foo/bar";
cfg->typeOfAction = 0x11;
}
return cfg;
}</pre>
<h3><a name="context_merge" id="context_merge">Merging configurations</a></h3>
<p>
Our next step in creating a context aware configuration is merging
configurations. This part of the process particularly applies to scenarios
where you have a parent configuration and a child, such as the following:
</p>
<pre class="prettyprint lang-config"><Directory "/var/www">
ExampleEnabled On
ExamplePath "/foo/bar"
ExampleAction file allow
</Directory>
<Directory "/var/www/subdir">
ExampleAction file deny
</Directory></pre>
<p>
In this example, it is natural to assume that the directory <code>
/var/www/subdir</code> should inherit the values set for the <code>/var/www
</code> directory, as we did not specify an <code>ExampleEnabled</code> nor
an <code>ExamplePath</code> for this directory. The server does not presume to
know if this is true, but cleverly does the following:
</p>
<ol>
<li>Creates a new configuration for <code>/var/www</code></li>
<li>Sets the configuration values according to the directives given for <code>/var/www</code></li>
<li>Creates a new configuration for <code>/var/www/subdir</code></li>
<li>Sets the configuration values according to the directives given for <code>/var/www/subdir</code></li>
<li><strong>Proposes a merge</strong> of the two configurations into a new configuration for <code>/var/www/subdir</code></li>
</ol>
<p>
This proposal is handled by the <code>merge_dir_conf</code> function we
referenced in our name tag. The purpose of this function is to assess the
two configurations and decide how they are to be merged:</p>
<pre class="prettyprint lang-c">void *merge_dir_conf(apr_pool_t *pool, void *BASE, void *ADD) {
example_config *base = (example_config *) BASE ; /* This is what was set in the parent context */
example_config *add = (example_config *) ADD ; /* This is what is set in the new context */
example_config *conf = (example_config *) create_dir_conf(pool, "Merged configuration"); /* This will be the merged configuration */
/* Merge configurations */
conf->enabled = ( add->enabled == 0 ) ? base->enabled : add->enabled ;
conf->typeOfAction = add->typeOfAction ? add->typeOfAction : base->typeOfAction;
strcpy(conf->path, strlen(add->path) ? add->path : base->path);
return conf ;
}</pre>
<h3><a name="context_example" id="context_example">Trying out our new context aware configurations</a></h3>
<p>
Now, let's try putting it all together to create a new module that is
context aware. First off, we'll create a configuration that lets us test
how the module works:
</p>
<pre class="prettyprint lang-config"><Location "/a">
SetHandler example-handler
ExampleEnabled on
ExamplePath "/foo/bar"
ExampleAction file allow
</Location>
<Location "/a/b">
ExampleAction file deny
ExampleEnabled off
</Location>
<Location "/a/b/c">
ExampleAction db deny
ExamplePath "/foo/bar/baz"
ExampleEnabled on
</Location></pre>
<p>
Then we'll assemble our module code. Note, that since we are now using our
name tag as reference when fetching configurations in our handler, I have
added some prototypes to keep the compiler happy:
</p>
<pre class="prettyprint lang-c">/*$6
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
* mod_example_config.c
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
*/
#include <stdio.h>
#include "apr_hash.h"
#include "ap_config.h"
#include "ap_provider.h"
#include "httpd.h"
#include "http_core.h"
#include "http_config.h"
#include "http_log.h"
#include "http_protocol.h"
#include "http_request.h"
/*$1
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Configuration structure
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*/
typedef struct
{
char context[256];
char path[256];
int typeOfAction;
int enabled;
} example_config;
/*$1
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Prototypes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*/
static int example_handler(request_rec *r);
const char *example_set_enabled(cmd_parms *cmd, void *cfg, const char *arg);
const char *example_set_path(cmd_parms *cmd, void *cfg, const char *arg);
const char *example_set_action(cmd_parms *cmd, void *cfg, const char *arg1, const char *arg2);
void *create_dir_conf(apr_pool_t *pool, char *context);
void *merge_dir_conf(apr_pool_t *pool, void *BASE, void *ADD);
static void register_hooks(apr_pool_t *pool);
/*$1
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Configuration directives
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*/
static const command_rec directives[] =
{
AP_INIT_TAKE1("exampleEnabled", example_set_enabled, NULL, ACCESS_CONF, "Enable or disable mod_example"),
AP_INIT_TAKE1("examplePath", example_set_path, NULL, ACCESS_CONF, "The path to whatever"),
AP_INIT_TAKE2("exampleAction", example_set_action, NULL, ACCESS_CONF, "Special action value!"),
{ NULL }
};
/*$1
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Our name tag
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*/
module AP_MODULE_DECLARE_DATA example_module =
{
STANDARD20_MODULE_STUFF,
create_dir_conf, /* Per-directory configuration handler */
merge_dir_conf, /* Merge handler for per-directory configurations */
NULL, /* Per-server configuration handler */
NULL, /* Merge handler for per-server configurations */
directives, /* Any directives we may have for httpd */
register_hooks /* Our hook registering function */
};
/*
=======================================================================================================================
Hook registration function
=======================================================================================================================
*/
static void register_hooks(apr_pool_t *pool)
{
ap_hook_handler(example_handler, NULL, NULL, APR_HOOK_LAST);
}
/*
=======================================================================================================================
Our example web service handler
=======================================================================================================================
*/
static int example_handler(request_rec *r)
{
if(!r->handler || strcmp(r->handler, "example-handler")) return(DECLINED);
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
example_config *config = (example_config *) ap_get_module_config(r->per_dir_config, &example_module);
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ap_set_content_type(r, "text/plain");
ap_rprintf(r, "Enabled: %u\n", config->enabled);
ap_rprintf(r, "Path: %s\n", config->path);
ap_rprintf(r, "TypeOfAction: %x\n", config->typeOfAction);
ap_rprintf(r, "Context: %s\n", config->context);
return OK;
}
/*
=======================================================================================================================
Handler for the "exampleEnabled" directive
=======================================================================================================================
*/
const char *example_set_enabled(cmd_parms *cmd, void *cfg, const char *arg)
{
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
example_config *conf = (example_config *) cfg;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
if(conf)
{
if(!strcasecmp(arg, "on"))
conf->enabled = 1;
else
conf->enabled = 0;
}
return NULL;
}
/*
=======================================================================================================================
Handler for the "examplePath" directive
=======================================================================================================================
*/
const char *example_set_path(cmd_parms *cmd, void *cfg, const char *arg)
{
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
example_config *conf = (example_config *) cfg;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
if(conf)
{
strcpy(conf->path, arg);
}
return NULL;
}
/*
=======================================================================================================================
Handler for the "exampleAction" directive ;
Let's pretend this one takes one argument (file or db), and a second (deny or allow), ;
and we store it in a bit-wise manner.
=======================================================================================================================
*/
const char *example_set_action(cmd_parms *cmd, void *cfg, const char *arg1, const char *arg2)
{
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
example_config *conf = (example_config *) cfg;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
if(conf)
{
{
if(!strcasecmp(arg1, "file"))
conf->typeOfAction = 0x01;
else
conf->typeOfAction = 0x02;
if(!strcasecmp(arg2, "deny"))
conf->typeOfAction += 0x10;
else
conf->typeOfAction += 0x20;
}
}
return NULL;
}
/*
=======================================================================================================================
Function for creating new configurations for per-directory contexts
=======================================================================================================================
*/
void *create_dir_conf(apr_pool_t *pool, char *context)
{
context = context ? context : "Newly created configuration";
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
example_config *cfg = apr_pcalloc(pool, sizeof(example_config));
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
if(cfg)
{
{
/* Set some default values */
strcpy(cfg->context, context);
cfg->enabled = 0;
memset(cfg->path, 0, 256);
cfg->typeOfAction = 0x00;
}
}
return cfg;
}
/*
=======================================================================================================================
Merging function for configurations
=======================================================================================================================
*/
void *merge_dir_conf(apr_pool_t *pool, void *BASE, void *ADD)
{
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
example_config *base = (example_config *) BASE;
example_config *add = (example_config *) ADD;
example_config *conf = (example_config *) create_dir_conf(pool, "Merged configuration");
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
conf->enabled = (add->enabled == 0) ? base->enabled : add->enabled;
conf->typeOfAction = add->typeOfAction ? add->typeOfAction : base->typeOfAction;
strcpy(conf->path, strlen(add->path) ? add->path : base->path);
return conf;
}</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="summary" id="summary">Summing up</a></h2>
<p>
We have now looked at how to create simple modules for Apache HTTP Server 2.4 and
configuring them. What you do next is entirely up to you, but it is my
hope that something valuable has come out of reading this documentation.
If you have questions on how to further develop modules, you are welcome
to join our <a href="http://httpd.apache.org/lists.html">mailing lists</a>
or check out the rest of our documentation for further tips.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="snippets" id="snippets">Some useful snippets of code</a></h2>
<h3><a name="get_post" id="get_post">Retrieve variables from POST form data</a></h3>
<pre class="prettyprint lang-c">typedef struct {
const char *key;
const char *value;
} keyValuePair;
keyValuePair *readPost(request_rec *r) {
apr_array_header_t *pairs = NULL;
apr_off_t len;
apr_size_t size;
int res;
int i = 0;
char *buffer;
keyValuePair *kvp;
res = ap_parse_form_data(r, NULL, &pairs, -1, HUGE_STRING_LEN);
if (res != OK || !pairs) return NULL; /* Return NULL if we failed or if there are is no POST data */
kvp = apr_pcalloc(r->pool, sizeof(keyValuePair) * (pairs->nelts + 1));
while (pairs && !apr_is_empty_array(pairs)) {
ap_form_pair_t *pair = (ap_form_pair_t *) apr_array_pop(pairs);
apr_brigade_length(pair->value, 1, &len);
size = (apr_size_t) len;
buffer = apr_palloc(r->pool, size + 1);
apr_brigade_flatten(pair->value, buffer, &size);
buffer[len] = 0;
kvp[i].key = apr_pstrdup(r->pool, pair->name);
kvp[i].value = buffer;
i++;
}
return kvp;
}
static int example_handler(request_rec *r)
{
/*~~~~~~~~~~~~~~~~~~~~~~*/
keyValuePair *formData;
/*~~~~~~~~~~~~~~~~~~~~~~*/
formData = readPost(r);
if (formData) {
int i;
for (i = 0; &formData[i]; i++) {
if (formData[i].key && formData[i].value) {
ap_rprintf(r, "%s = %s\n", formData[i].key, formData[i].value);
} else if (formData[i].key) {
ap_rprintf(r, "%s\n", formData[i].key);
} else if (formData[i].value) {
ap_rprintf(r, "= %s\n", formData[i].value);
} else {
break;
}
}
}
return OK;
}</pre>
<h3><a name="headers_out" id="headers_out">Printing out every HTTP header received</a></h3>
<pre class="prettyprint lang-c">static int example_handler(request_rec *r)
{
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
const apr_array_header_t *fields;
int i;
apr_table_entry_t *e = 0;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
fields = apr_table_elts(r->headers_in);
e = (apr_table_entry_t *) fields->elts;
for(i = 0; i < fields->nelts; i++) {
ap_rprintf(r, "%s: %s\n", e[i].key, e[i].val);
}
return OK;
}</pre>
<h3><a name="request_body" id="request_body">Reading the request body into memory</a></h3>
<pre class="prettyprint lang-c">static int util_read(request_rec *r, const char **rbuf, apr_off_t *size)
{
/*~~~~~~~~*/
int rc = OK;
/*~~~~~~~~*/
if((rc = ap_setup_client_block(r, REQUEST_CHUNKED_ERROR))) {
return(rc);
}
if(ap_should_client_block(r)) {
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
char argsbuffer[HUGE_STRING_LEN];
apr_off_t rsize, len_read, rpos = 0;
apr_off_t length = r->remaining;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
*rbuf = (const char *) apr_pcalloc(r->pool, (apr_size_t) (length + 1));
*size = length;
while((len_read = ap_get_client_block(r, argsbuffer, sizeof(argsbuffer))) > 0) {
if((rpos + len_read) > length) {
rsize = length - rpos;
}
else {
rsize = len_read;
}
memcpy((char *) *rbuf + rpos, argsbuffer, (size_t) rsize);
rpos += rsize;
}
}
return(rc);
}
static int example_handler(request_rec *r)
{
/*~~~~~~~~~~~~~~~~*/
apr_off_t size;
const char *buffer;
/*~~~~~~~~~~~~~~~~*/
if(util_read(r, &buffer, &size) == OK) {
ap_rprintf(r, "We read a request body that was %" APR_OFF_T_FMT " bytes long", size);
}
return OK;
}</pre>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/modguide.html" title="English"> en </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/modguide.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/request.html.en 0000664 0001751 0001751 00000036157 14737241666 022027 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Request Processing in the Apache HTTP Server 2.x - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>Request Processing in the Apache HTTP Server 2.x</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/request.html" title="English"> en </a></p>
</div>
<div class="warning"><h3>Warning</h3>
<p>Warning - this is a first (fast) draft that needs further
revision!</p>
</div>
<p>Several changes in 2.0 and above affect the internal request
processing mechanics. Module authors need to be aware of these
changes so they may take advantage of the optimizations and
security enhancements.</p>
<p>The first major change is to the subrequest and redirect
mechanisms. There were a number of different code paths in
the Apache HTTP Server 1.3 to attempt to optimize subrequest
or redirect behavior. As patches were introduced to 2.0, these
optimizations (and the server behavior) were quickly broken due
to this duplication of code. All duplicate code has been folded
back into <code>ap_process_request_internal()</code> to prevent
the code from falling out of sync again.</p>
<p>This means that much of the existing code was 'unoptimized'.
It is the Apache HTTP Project's first goal to create a robust
and correct implementation of the HTTP server RFC. Additional
goals include security, scalability and optimization. New
methods were sought to optimize the server (beyond the
performance of 1.3) without introducing fragile or
insecure code.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#processing">The Request Processing Cycle</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#parsing">The Request Parsing Phase</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">The Security Phase</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#preparation">The Preparation Phase</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#handler">The Handler Phase</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="processing" id="processing">The Request Processing Cycle</a></h2>
<p>All requests pass through <code>ap_process_request_internal()</code>
in <code>server/request.c</code>, including subrequests and redirects. If a module
doesn't pass generated requests through this code, the author is cautioned
that the module may be broken by future changes to request
processing.</p>
<p>To streamline requests, the module author can take advantage
of the <a href="./modguide.html#hooking">hooks offered</a> to drop
out of the request cycle early, or to bypass core hooks which are
irrelevant (and costly in terms of CPU.)</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="parsing" id="parsing">The Request Parsing Phase</a></h2>
<h3><a name="unescape" id="unescape">Unescapes the URL</a></h3>
<p>The request's <code>parsed_uri</code> path is unescaped, once and only
once, at the beginning of internal request processing.</p>
<p>This step is bypassed if the proxyreq flag is set, or the
<code>parsed_uri.path</code> element is unset. The module has no further
control of this one-time unescape operation, either failing to
unescape or multiply unescaping the URL leads to security
repercussions.</p>
<h3><a name="strip" id="strip">Strips Parent and This Elements from the
URI</a></h3>
<p>All <code>/../</code> and <code>/./</code> elements are
removed by <code>ap_getparents()</code>, as well as any trailing
<code>/.</code> or <code>/..</code> element. This helps to ensure
the path is (nearly) absolute before the request processing
continues. (See RFC 1808 section 4 for further discussion.)</p>
<p>This step cannot be bypassed.</p>
<h3><a name="inital-location-walk" id="inital-location-walk">Initial URI Location Walk</a></h3>
<p>Every request is subject to an
<code>ap_location_walk()</code> call. This ensures that
<code class="directive"><a href="../mod/core.html#location"><Location></a></code> sections
are consistently enforced for all requests. If the request is an internal
redirect or a sub-request, it may borrow some or all of the processing
from the previous or parent request's ap_location_walk, so this step
is generally very efficient after processing the main request.</p>
<h3><a name="translate_name" id="translate_name">translate_name</a></h3>
<p>Modules can determine the file name, or alter the given URI
in this step. For example, <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> will
translate the URI's path into the configured virtual host,
<code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> will translate the path to an alias path,
and if the request falls back on the core, the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> is prepended to the request resource.</p>
<p>If all modules <code>DECLINE</code> this phase, an error 500 is
returned to the browser, and a "couldn't translate name" error is logged
automatically.</p>
<h3><a name="map_to_storage" id="map_to_storage">Hook: map_to_storage</a></h3>
<p>After the file or correct URI was determined, the
appropriate per-dir configurations are merged together. For
example, <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> compares and merges the appropriate
<code class="directive"><a href="../mod/mod_proxy.html#proxy"><Proxy></a></code> sections.
If the URI is nothing more than a local (non-proxy) <code>TRACE</code>
request, the core handles the request and returns <code>DONE</code>.
If no module answers this hook with <code>OK</code> or <code>DONE</code>,
the core will run the request filename against the <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> and <code class="directive"><a href="../mod/core.html#files"><Files></a></code> sections. If the request
'filename' isn't an absolute, legal filename, a note is set for
later termination.</p>
<h3><a name="location-walk" id="location-walk">URI Location Walk</a></h3>
<p>Every request is hardened by a second
<code>ap_location_walk()</code> call. This reassures that a
translated request is still subjected to the configured
<code class="directive"><a href="../mod/core.html#location"><Location></a></code> sections.
The request again borrows some or all of the processing from its previous
<code>location_walk</code> above, so this step is almost always very
efficient unless the translated URI mapped to a substantially different
path or Virtual Host.</p>
<h3><a name="header_parser" id="header_parser">Hook: header_parser</a></h3>
<p>The main request then parses the client's headers. This
prepares the remaining request processing steps to better serve
the client's request.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">The Security Phase</a></h2>
<p>Needs Documentation. Code is:</p>
<pre class="prettyprint lang-c">if ((access_status = ap_run_access_checker(r)) != 0) {
return decl_die(access_status, "check access", r);
}
if ((access_status = ap_run_check_user_id(r)) != 0) {
return decl_die(access_status, "check user", r);
}
if ((access_status = ap_run_auth_checker(r)) != 0) {
return decl_die(access_status, "check authorization", r);
}</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="preparation" id="preparation">The Preparation Phase</a></h2>
<h3><a name="type_checker" id="type_checker">Hook: type_checker</a></h3>
<p>The modules have an opportunity to test the URI or filename
against the target resource, and set mime information for the
request. Both <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> and
<code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code> use this phase to compare the file
name or contents against the administrator's configuration and set the
content type, language, character set and request handler. Some modules
may set up their filters or other request handling parameters at this
time.</p>
<p>If all modules <code>DECLINE</code> this phase, an error 500 is
returned to the browser, and a "couldn't find types" error is logged
automatically.</p>
<h3><a name="fixups" id="fixups">Hook: fixups</a></h3>
<p>Many modules are 'trounced' by some phase above. The fixups
phase is used by modules to 'reassert' their ownership or force
the request's fields to their appropriate values. It isn't
always the cleanest mechanism, but occasionally it's the only
option.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="handler" id="handler">The Handler Phase</a></h2>
<p>This phase is <strong>not</strong> part of the processing in
<code>ap_process_request_internal()</code>. Many
modules prepare one or more subrequests prior to creating any
content at all. After the core, or a module calls
<code>ap_process_request_internal()</code> it then calls
<code>ap_invoke_handler()</code> to generate the request.</p>
<h3><a name="insert_filter" id="insert_filter">Hook: insert_filter</a></h3>
<p>Modules that transform the content in some way can insert
their values and override existing filters, such that if the
user configured a more advanced filter out-of-order, then the
module can move its order as need be. There is no result code,
so actions in this hook better be trusted to always succeed.</p>
<h3><a name="hook_handler" id="hook_handler">Hook: handler</a></h3>
<p>The module finally has a chance to serve the request in its
handler hook. Note that not every prepared request is sent to
the handler hook. Many modules, such as <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>,
will create subrequests for a given URI, and then never serve the
subrequest, but simply lists it for the user. Remember not to
put required teardown from the hooks above into this module,
but register pool cleanups against the request pool to free
resources as required.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/request.html" title="English"> en </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/request.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/output-filters.html.en 0000664 0001751 0001751 00000073170 14737241666 023341 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Guide to writing output filters - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>Guide to writing output filters</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/output-filters.html" title="English"> en </a></p>
</div>
<p>There are a number of common pitfalls encountered when writing
output filters; this page aims to document best practice for
authors of new or existing filters.</p>
<p>This document is applicable to both version 2.0 and version 2.2
of the Apache HTTP Server; it specifically targets
<code>RESOURCE</code>-level or <code>CONTENT_SET</code>-level
filters though some advice is generic to all types of filter.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#basics">Filters and bucket brigades</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#invocation">Filter invocation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#brigade">Brigade structure</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#buckets">Processing buckets</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#filtering">Filtering brigades</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#state">Maintaining state</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#buffer">Buffering buckets</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#nonblock">Non-blocking bucket reads</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rules">Ten rules for output filters</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#usecase1">Use case: buffering in mod_ratelimit</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="basics" id="basics">Filters and bucket brigades</a></h2>
<p>Each time a filter is invoked, it is passed a <em>bucket
brigade</em>, containing a sequence of <em>buckets</em> which
represent both data content and metadata. Every bucket has a
<em>bucket type</em>; a number of bucket types are defined and
used by the <code>httpd</code> core modules (and the
<code>apr-util</code> library which provides the bucket brigade
interface), but modules are free to define their own types.</p>
<div class="note">Output filters must be prepared to process
buckets of non-standard types; with a few exceptions, a filter
need not care about the types of buckets being filtered.</div>
<p>A filter can tell whether a bucket represents either data or
metadata using the <code>APR_BUCKET_IS_METADATA</code> macro.
Generally, all metadata buckets should be passed down the filter
chain by an output filter. Filters may transform, delete, and
insert data buckets as appropriate.</p>
<p>There are two metadata bucket types which all filters must pay
attention to: the <code>EOS</code> bucket type, and the
<code>FLUSH</code> bucket type. An <code>EOS</code> bucket
indicates that the end of the response has been reached and no
further buckets need be processed. A <code>FLUSH</code> bucket
indicates that the filter should flush any buffered buckets (if
applicable) down the filter chain immediately.</p>
<div class="note"><code>FLUSH</code> buckets are sent when the
content generator (or an upstream filter) knows that there may be
a delay before more content can be sent. By passing
<code>FLUSH</code> buckets down the filter chain immediately,
filters ensure that the client is not kept waiting for pending
data longer than necessary.</div>
<p>Filters can create <code>FLUSH</code> buckets and pass these
down the filter chain if desired. Generating <code>FLUSH</code>
buckets unnecessarily, or too frequently, can harm network
utilisation since it may force large numbers of small packets to
be sent, rather than a small number of larger packets. The
section on <a href="#nonblock">Non-blocking bucket reads</a>
covers a case where filters are encouraged to generate
<code>FLUSH</code> buckets.</p>
<div class="example"><h3>Example bucket brigade</h3><p><code>
HEAP FLUSH FILE EOS</code></p></div>
<p>This shows a bucket brigade which may be passed to a filter; it
contains two metadata buckets (<code>FLUSH</code> and
<code>EOS</code>), and two data buckets (<code>HEAP</code> and
<code>FILE</code>).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="invocation" id="invocation">Filter invocation</a></h2>
<p>For any given request, an output filter might be invoked only
once and be given a single brigade representing the entire response.
It is also possible that the number of times a filter is invoked
for a single response is proportional to the size of the content
being filtered, with the filter being passed a brigade containing
a single bucket each time. Filters must operate correctly in
either case.</p>
<div class="warning">An output filter which allocates long-lived
memory every time it is invoked may consume memory proportional to
response size. Output filters which need to allocate memory
should do so once per response; see <a href="#state">Maintaining
state</a> below.</div>
<p>An output filter can distinguish the final invocation for a
given response by the presence of an <code>EOS</code> bucket in
the brigade. Any buckets in the brigade after an EOS should be
ignored.</p>
<p>An output filter should never pass an empty brigade down the
filter chain. To be defensive, filters should be prepared to
accept an empty brigade, and should return success without passing
this brigade on down the filter chain. The handling of an empty
brigade should have no side effects (such as changing any state
private to the filter).</p>
<div class="example"><h3>How to handle an empty brigade</h3><pre class="prettyprint lang-c">apr_status_t dummy_filter(ap_filter_t *f, apr_bucket_brigade *bb)
{
if (APR_BRIGADE_EMPTY(bb)) {
return APR_SUCCESS;
}
...</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="brigade" id="brigade">Brigade structure</a></h2>
<p>A bucket brigade is a doubly-linked list of buckets. The list
is terminated (at both ends) by a <em>sentinel</em> which can be
distinguished from a normal bucket by comparing it with the
pointer returned by <code>APR_BRIGADE_SENTINEL</code>. The list
sentinel is in fact not a valid bucket structure; any attempt to
call normal bucket functions (such as
<code>apr_bucket_read</code>) on the sentinel will have undefined
behaviour (i.e. will crash the process).</p>
<p>There are a variety of functions and macros for traversing and
manipulating bucket brigades; see the <a href="http://apr.apache.org/docs/apr-util/trunk/group___a_p_r___util___bucket___brigades.html">apr_buckets.h</a>
header for complete coverage. Commonly used macros include:</p>
<dl>
<dt><code>APR_BRIGADE_FIRST(bb)</code></dt>
<dd>returns the first bucket in brigade bb</dd>
<dt><code>APR_BRIGADE_LAST(bb)</code></dt>
<dd>returns the last bucket in brigade bb</dd>
<dt><code>APR_BUCKET_NEXT(e)</code></dt>
<dd>gives the next bucket after bucket e</dd>
<dt><code>APR_BUCKET_PREV(e)</code></dt>
<dd>gives the bucket before bucket e</dd>
</dl>
<p>The <code>apr_bucket_brigade</code> structure itself is
allocated out of a pool, so if a filter creates a new brigade, it
must ensure that memory use is correctly bounded. A filter which
allocates a new brigade out of the request pool
(<code>r->pool</code>) on every invocation, for example, will fall
foul of the <a href="#invocation">warning above</a> concerning
memory use. Such a filter should instead create a brigade on the
first invocation per request, and store that brigade in its <a href="#state">state structure</a>.</p>
<div class="warning"><p>It is generally never advisable to use
<code>apr_brigade_destroy</code> to "destroy" a brigade unless
you know for certain that the brigade will never be used
again, even then, it should be used rarely. The
memory used by the brigade structure will not be released by
calling this function (since it comes from a pool), but the
associated pool cleanup is unregistered. Using
<code>apr_brigade_destroy</code> can in fact cause memory leaks;
if a "destroyed" brigade contains buckets when its
containing pool is destroyed, those buckets will <em>not</em> be
immediately destroyed.</p>
<p>In general, filters should use <code>apr_brigade_cleanup</code>
in preference to <code>apr_brigade_destroy</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="buckets" id="buckets">Processing buckets</a></h2>
<p>When dealing with non-metadata buckets, it is important to
understand that the "<code>apr_bucket *</code>" object is an
abstract <em>representation</em> of data:</p>
<ol>
<li>The amount of data represented by the bucket may or may not
have a determinate length; for a bucket which represents data of
indeterminate length, the <code>->length</code> field is set to
the value <code>(apr_size_t)-1</code>. For example, buckets of
the <code>PIPE</code> bucket type have an indeterminate length;
they represent the output from a pipe.</li>
<li>The data represented by a bucket may or may not be mapped
into memory. The <code>FILE</code> bucket type, for example,
represents data stored in a file on disk.</li>
</ol>
<p>Filters read the data from a bucket using the
<code>apr_bucket_read</code> function. When this function is
invoked, the bucket may <em>morph</em> into a different bucket
type, and may also insert a new bucket into the bucket brigade.
This must happen for buckets which represent data not mapped into
memory.</p>
<p>To give an example; consider a bucket brigade containing a
single <code>FILE</code> bucket representing an entire file, 24
kilobytes in size:</p>
<div class="example"><p><code>FILE(0K-24K)</code></p></div>
<p>When this bucket is read, it will read a block of data from the
file, morph into a <code>HEAP</code> bucket to represent that
data, and return the data to the caller. It also inserts a new
<code>FILE</code> bucket representing the remainder of the file;
after the <code>apr_bucket_read</code> call, the brigade looks
like:</p>
<div class="example"><p><code>HEAP(8K) FILE(8K-24K)</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="filtering" id="filtering">Filtering brigades</a></h2>
<p>The basic function of any output filter will be to iterate
through the passed-in brigade and transform (or simply examine)
the content in some manner. The implementation of the iteration
loop is critical to producing a well-behaved output filter.</p>
<p>Taking an example which loops through the entire brigade as
follows:</p>
<div class="example"><h3>Bad output filter -- do not imitate!</h3><pre class="prettyprint lang-c">apr_bucket *e = APR_BRIGADE_FIRST(bb);
const char *data;
apr_size_t length;
while (e != APR_BRIGADE_SENTINEL(bb)) {
apr_bucket_read(e, &data, &length, APR_BLOCK_READ);
e = APR_BUCKET_NEXT(e);
}
return ap_pass_brigade(bb);</pre>
</div>
<p>The above implementation would consume memory proportional to
content size. If passed a <code>FILE</code> bucket, for example,
the entire file contents would be read into memory as each
<code>apr_bucket_read</code> call morphed a <code>FILE</code>
bucket into a <code>HEAP</code> bucket.</p>
<p>In contrast, the implementation below will consume a fixed
amount of memory to filter any brigade; a temporary brigade is
needed and must be allocated only once per response, see the <a href="#state">Maintaining state</a> section.</p>
<div class="example"><h3>Better output filter</h3><pre class="prettyprint lang-c">apr_bucket *e;
const char *data;
apr_size_t length;
while ((e = APR_BRIGADE_FIRST(bb)) != APR_BRIGADE_SENTINEL(bb)) {
rv = apr_bucket_read(e, &data, &length, APR_BLOCK_READ);
if (rv) ...;
/* Remove bucket e from bb. */
APR_BUCKET_REMOVE(e);
/* Insert it into temporary brigade. */
APR_BRIGADE_INSERT_HEAD(tmpbb, e);
/* Pass brigade downstream. */
rv = ap_pass_brigade(f->next, tmpbb);
if (rv) ...;
apr_brigade_cleanup(tmpbb);
}</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="state" id="state">Maintaining state</a></h2>
<p>A filter which needs to maintain state over multiple
invocations per response can use the <code>->ctx</code> field of
its <code>ap_filter_t</code> structure. It is typical to store a
temporary brigade in such a structure, to avoid having to allocate
a new brigade per invocation as described in the <a href="#brigade">Brigade structure</a> section.</p>
<div class="example"><h3>Example code to maintain filter state</h3><pre class="prettyprint lang-c">struct dummy_state {
apr_bucket_brigade *tmpbb;
int filter_state;
...
};
apr_status_t dummy_filter(ap_filter_t *f, apr_bucket_brigade *bb)
{
struct dummy_state *state;
state = f->ctx;
if (state == NULL) {
/* First invocation for this response: initialise state structure.
*/
f->ctx = state = apr_palloc(f->r->pool, sizeof *state);
state->tmpbb = apr_brigade_create(f->r->pool, f->c->bucket_alloc);
state->filter_state = ...;
}
...</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="buffer" id="buffer">Buffering buckets</a></h2>
<p>If a filter decides to store buckets beyond the duration of a
single filter function invocation (for example storing them in its
<code>->ctx</code> state structure), those buckets must be <em>set
aside</em>. This is necessary because some bucket types provide
buckets which represent temporary resources (such as stack memory)
which will fall out of scope as soon as the filter chain completes
processing the brigade.</p>
<p>To setaside a bucket, the <code>apr_bucket_setaside</code>
function can be called. Not all bucket types can be setaside, but
if successful, the bucket will have morphed to ensure it has a
lifetime at least as long as the pool given as an argument to the
<code>apr_bucket_setaside</code> function.</p>
<p>Alternatively, the <code>ap_save_brigade</code> function can be
used, which will move all the buckets into a separate brigade
containing buckets with a lifetime as long as the given pool
argument. This function must be used with care, taking into
account the following points:</p>
<ol>
<li>On return, <code>ap_save_brigade</code> guarantees that all
the buckets in the returned brigade will represent data mapped
into memory. If given an input brigade containing, for example,
a <code>PIPE</code> bucket, <code>ap_save_brigade</code> will
consume an arbitrary amount of memory to store the entire output
of the pipe.</li>
<li>When <code>ap_save_brigade</code> reads from buckets which
cannot be setaside, it will always perform blocking reads,
removing the opportunity to use <a href="#nonblock">Non-blocking
bucket reads</a>.</li>
<li>If <code>ap_save_brigade</code> is used without passing a
non-NULL "<code>saveto</code>" (destination) brigade parameter,
the function will create a new brigade, which may cause memory
use to be proportional to content size as described in the <a href="#brigade">Brigade structure</a> section.</li>
</ol>
<div class="warning">Filters must ensure that any buffered data is
processed and passed down the filter chain during the last
invocation for a given response (a brigade containing an EOS
bucket). Otherwise such data will be lost.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="nonblock" id="nonblock">Non-blocking bucket reads</a></h2>
<p>The <code>apr_bucket_read</code> function takes an
<code>apr_read_type_e</code> argument which determines whether a
<em>blocking</em> or <em>non-blocking</em> read will be performed
from the data source. A good filter will first attempt to read
from every data bucket using a non-blocking read; if that fails
with <code>APR_EAGAIN</code>, then send a <code>FLUSH</code>
bucket down the filter chain, and retry using a blocking read.</p>
<p>This mode of operation ensures that any filters further down the
filter chain will flush any buffered buckets if a slow content
source is being used.</p>
<p>A CGI script is an example of a slow content source which is
implemented as a bucket type. <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> will send
<code>PIPE</code> buckets which represent the output from a CGI
script; reading from such a bucket will block when waiting for the
CGI script to produce more output.</p>
<div class="example"><h3>Example code using non-blocking bucket reads</h3><pre class="prettyprint lang-c">apr_bucket *e;
apr_read_type_e mode = APR_NONBLOCK_READ;
while ((e = APR_BRIGADE_FIRST(bb)) != APR_BRIGADE_SENTINEL(bb)) {
apr_status_t rv;
rv = apr_bucket_read(e, &data, &length, mode);
if (rv == APR_EAGAIN && mode == APR_NONBLOCK_READ) {
/* Pass down a brigade containing a flush bucket: */
APR_BRIGADE_INSERT_TAIL(tmpbb, apr_bucket_flush_create(...));
rv = ap_pass_brigade(f->next, tmpbb);
apr_brigade_cleanup(tmpbb);
if (rv != APR_SUCCESS) return rv;
/* Retry, using a blocking read. */
mode = APR_BLOCK_READ;
continue;
}
else if (rv != APR_SUCCESS) {
/* handle errors */
}
/* Next time, try a non-blocking read first. */
mode = APR_NONBLOCK_READ;
...
}</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rules" id="rules">Ten rules for output filters</a></h2>
<p>In summary, here is a set of rules for all output filters to
follow:</p>
<ol>
<li>Output filters should not pass empty brigades down the filter
chain, but should be tolerant of being passed empty
brigades.</li>
<li>Output filters must pass all metadata buckets down the filter
chain; <code>FLUSH</code> buckets should be respected by passing
any pending or buffered buckets down the filter chain.</li>
<li>Output filters should ignore any buckets following an
<code>EOS</code> bucket.</li>
<li>Output filters must process a fixed amount of data at a
time, to ensure that memory consumption is not proportional to
the size of the content being filtered.</li>
<li>Output filters should be agnostic with respect to bucket
types, and must be able to process buckets of unfamiliar
type.</li>
<li>After calling <code>ap_pass_brigade</code> to pass a brigade
down the filter chain, output filters should call
<code>apr_brigade_cleanup</code> to ensure the brigade is empty
before reusing that brigade structure; output filters should
never use <code>apr_brigade_destroy</code> to "destroy"
brigades.</li>
<li>Output filters must <em>setaside</em> any buckets which are
preserved beyond the duration of the filter function.</li>
<li>Output filters must not ignore the return value of
<code>ap_pass_brigade</code>, and must return appropriate errors
back up the filter chain.</li>
<li>Output filters must only create a fixed number of bucket
brigades for each response, rather than one per invocation.</li>
<li>Output filters should first attempt non-blocking reads from
each data bucket, and send a <code>FLUSH</code> bucket down the
filter chain if the read blocks, before retrying with a blocking
read.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="usecase1" id="usecase1">Use case: buffering in mod_ratelimit</a></h2>
<p>The <a href="http://svn.apache.org/r1833875">r1833875</a> change is a good
example to show what buffering and keeping state means in the context of an
output filter. In this use case, a user asked on the users' mailing list a
interesting question about why <code class="module"><a href="../mod/mod_ratelimit.html">mod_ratelimit</a></code> seemed not to
honor its setting with proxied content (either rate limiting at a different
speed or simply not doing it at all). Before diving deep into the solution,
it is better to explain on a high level how <code class="module"><a href="../mod/mod_ratelimit.html">mod_ratelimit</a></code> works.
The trick is really simple: take the rate limit settings and calculate a
chunk size of data to flush every 200ms to the client. For example, let's imagine
that to set <code>rate-limit 60</code> in our config, these are the high level
steps to find the chunk size:</p>
<pre class="prettyprint lang-c">/* milliseconds to wait between each flush of data */
RATE_INTERVAL_MS = 200;
/* rate limit speed in b/s */
speed = 60 * 1024;
/* final chunk size is 12228 bytes */
chunk_size = (speed / (1000 / RATE_INTERVAL_MS));</pre>
<p>If we apply this calculation to a bucket brigade carrying 38400 bytes, it means
that the filter will try to do the following:</p>
<ol>
<li>Split the 38400 bytes in chunks of maximum 12228 bytes each.</li>
<li>Flush the first 12228 chunk of bytes and sleep 200ms.</li>
<li>Flush the second 12228 chunk of bytes and sleep 200ms.</li>
<li>Flush the third 12228 chunk of bytes and sleep 200ms.</li>
<li>Flush the remaining 1716 bytes.</li>
</ol>
<p>The above pseudo code works fine if the output filter handles only one brigade
for each response, but it might happen that it needs to be called multiple times
with different brigade sizes as well. The former use case is for example when
httpd directly serves some content, like a static file: the bucket brigade
abstraction takes care of handling the whole content, and rate limiting
works nicely. But if the same static content is served via mod_proxy_http (for
example a backend is serving it rather than httpd) then the content generator
(in this case mod_proxy_http) may use a maximum buffer size and then send data
as bucket brigades to the output filters chain regularly, triggering of course
multiple calls to <code class="module"><a href="../mod/mod_ratelimit.html">mod_ratelimit</a></code>. If the reader tries to execute the pseudo code
assuming multiple calls to the output filter, each one requiring to process
a bucket brigade of 38400 bytes, then it is easy to spot some
anomalies:</p>
<ol>
<li>Between the last flush of a brigade and the first one of the next,
there is no sleep.</li>
<li>Even if the sleep was forced after the last flush, then that chunk size
would not be the ideal size (1716 bytes instead of 12228) and the final client's speed
would quickly become different than what set in the httpd's config.</li>
</ol>
<p>In this case, two things might help:</p>
<ol>
<li>Use the ctx internal data structure, initialized by <code class="module"><a href="../mod/mod_ratelimit.html">mod_ratelimit</a></code>
for each response handling cycle, to "remember" when the last sleep was
performed across multiple invocations, and act accordingly.</li>
<li>If a bucket brigade is not splittable into a finite number of chunk_size
blocks, store the remaining bytes (located in the tail of the bucket brigade)
in a temporary holding area (namely another bucket brigade) and then use
<code>ap_save_brigade</code> to set them aside.
These bytes will be prepended to the next bucket brigade that will be handled
in the subsequent invocation.</li>
<li>Avoid the previous logic if the bucket brigade that is currently being
processed contains the end of stream bucket (EOS). There is no need to sleep
or buffering data if the end of stream is reached.</li>
</ol>
<p>The commit linked in the beginning of the section contains also a bit of code
refactoring so it is not trivial to read during the first pass, but the overall
idea is basically what written up to now. The goal of this section is not to
cause a headache to the reader trying to read C code, but to put him/her into
the right mindset needed to use efficiently the tools offered by the httpd's
filter chain toolset.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/output-filters.html" title="English"> en </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/output-filters.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/API.html 0000664 0001751 0001751 00000000162 13710016232 020305 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: API.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/developer/hooks.html 0000664 0001751 0001751 00000000164 13710016232 021021 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: hooks.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/developer/new_api_2_4.html 0000664 0001751 0001751 00000000172 13710016232 021763 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: new_api_2_4.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/developer/API.html.en 0000664 0001751 0001751 00000177540 14737241666 020752 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache 1.3 API notes - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>Apache 1.3 API notes</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/API.html" title="English"> en </a></p>
</div>
<div class="warning"><h3>Warning</h3>
<p>This document has not been updated to take into account changes made
in the 2.0 version of the Apache HTTP Server. Some of the information may
still be relevant, but please use it with care.</p>
</div>
<p>These are some notes on the Apache API and the data structures you have
to deal with, <em>etc.</em> They are not yet nearly complete, but hopefully,
they will help you get your bearings. Keep in mind that the API is still
subject to change as we gain experience with it. (See the TODO file for
what <em>might</em> be coming). However, it will be easy to adapt modules
to any changes that are made. (We have more modules to adapt than you
do).</p>
<p>A few notes on general pedagogical style here. In the interest of
conciseness, all structure declarations here are incomplete -- the real
ones have more slots that I'm not telling you about. For the most part,
these are reserved to one component of the server core or another, and
should be altered by modules with caution. However, in some cases, they
really are things I just haven't gotten around to yet. Welcome to the
bleeding edge.</p>
<p>Finally, here's an outline, to give you some bare idea of what's coming
up, and in what order:</p>
<ul>
<li>
<a href="#basics">Basic concepts.</a>
<ul>
<li><a href="#HMR">Handlers, Modules, and
Requests</a></li>
<li><a href="#moduletour">A brief tour of a
module</a></li>
</ul>
</li>
<li>
<a href="#handlers">How handlers work</a>
<ul>
<li><a href="#req_tour">A brief tour of the
<code>request_rec</code></a></li>
<li><a href="#req_orig">Where request_rec structures come
from</a></li>
<li><a href="#req_return">Handling requests, declining,
and returning error codes</a></li>
<li><a href="#resp_handlers">Special considerations for
response handlers</a></li>
<li><a href="#auth_handlers">Special considerations for
authentication handlers</a></li>
<li><a href="#log_handlers">Special considerations for
logging handlers</a></li>
</ul>
</li>
<li><a href="#pools">Resource allocation and resource
pools</a></li>
<li>
<a href="#config">Configuration, commands and the like</a>
<ul>
<li><a href="#per-dir">Per-directory configuration
structures</a></li>
<li><a href="#commands">Command handling</a></li>
<li><a href="#servconf">Side notes --- per-server
configuration, virtual servers, <em>etc</em>.</a></li>
</ul>
</li>
</ul>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#basics">Basic concepts</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#handlers">How handlers work</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#pools">Resource allocation and resource pools</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#config">Configuration, commands and the like</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="basics" id="basics">Basic concepts</a></h2>
<p>We begin with an overview of the basic concepts behind the API, and how
they are manifested in the code.</p>
<h3><a name="HMR" id="HMR">Handlers, Modules, and Requests</a></h3>
<p>Apache breaks down request handling into a series of steps, more or
less the same way the Netscape server API does (although this API has a
few more stages than NetSite does, as hooks for stuff I thought might be
useful in the future). These are:</p>
<ul>
<li>URI -> Filename translation</li>
<li>Auth ID checking [is the user who they say they are?]</li>
<li>Auth access checking [is the user authorized <em>here</em>?]</li>
<li>Access checking other than auth</li>
<li>Determining MIME type of the object requested</li>
<li>`Fixups' -- there aren't any of these yet, but the phase is intended
as a hook for possible extensions like <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code>, which don't really fit well elsewhere.</li>
<li>Actually sending a response back to the client.</li>
<li>Logging the request</li>
</ul>
<p>These phases are handled by looking at each of a succession of
<em>modules</em>, looking to see if each of them has a handler for the
phase, and attempting invoking it if so. The handler can typically do one
of three things:</p>
<ul>
<li><em>Handle</em> the request, and indicate that it has done so by
returning the magic constant <code>OK</code>.</li>
<li><em>Decline</em> to handle the request, by returning the magic integer
constant <code>DECLINED</code>. In this case, the server behaves in all
respects as if the handler simply hadn't been there.</li>
<li>Signal an error, by returning one of the HTTP error codes. This
terminates normal handling of the request, although an ErrorDocument may
be invoked to try to mop up, and it will be logged in any case.</li>
</ul>
<p>Most phases are terminated by the first module that handles them;
however, for logging, `fixups', and non-access authentication checking,
all handlers always run (barring an error). Also, the response phase is
unique in that modules may declare multiple handlers for it, via a
dispatch table keyed on the MIME type of the requested object. Modules may
declare a response-phase handler which can handle <em>any</em> request,
by giving it the key <code>*/*</code> (<em>i.e.</em>, a wildcard MIME type
specification). However, wildcard handlers are only invoked if the server
has already tried and failed to find a more specific response handler for
the MIME type of the requested object (either none existed, or they all
declined).</p>
<p>The handlers themselves are functions of one argument (a
<code>request_rec</code> structure. vide infra), which returns an integer,
as above.</p>
<h3><a name="moduletour" id="moduletour">A brief tour of a module</a></h3>
<p>At this point, we need to explain the structure of a module. Our
candidate will be one of the messier ones, the CGI module -- this handles
both CGI scripts and the <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> config file command. It's actually a great deal
more complicated than most modules, but if we're going to have only one
example, it might as well be the one with its fingers in every place.</p>
<p>Let's begin with handlers. In order to handle the CGI scripts, the
module declares a response handler for them. Because of <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>, it also has handlers for the
name translation phase (to recognize <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>ed URIs), the type-checking phase (any
<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>ed request is typed
as a CGI script).</p>
<p>The module needs to maintain some per (virtual) server information,
namely, the <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>es in
effect; the module structure therefore contains pointers to a functions
which builds these structures, and to another which combines two of them
(in case the main server and a virtual server both have <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>es declared).</p>
<p>Finally, this module contains code to handle the <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> command itself. This particular
module only declares one command, but there could be more, so modules have
<em>command tables</em> which declare their commands, and describe where
they are permitted, and how they are to be invoked.</p>
<p>A final note on the declared types of the arguments of some of these
commands: a <code>pool</code> is a pointer to a <em>resource pool</em>
structure; these are used by the server to keep track of the memory which
has been allocated, files opened, <em>etc.</em>, either to service a
particular request, or to handle the process of configuring itself. That
way, when the request is over (or, for the configuration pool, when the
server is restarting), the memory can be freed, and the files closed,
<em>en masse</em>, without anyone having to write explicit code to track
them all down and dispose of them. Also, a <code>cmd_parms</code>
structure contains various information about the config file being read,
and other status information, which is sometimes of use to the function
which processes a config-file command (such as <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>). With no further ado, the
module itself:</p>
<div class="example"><p><code>
/* Declarations of handlers. */<br />
<br />
int translate_scriptalias (request_rec *);<br />
int type_scriptalias (request_rec *);<br />
int cgi_handler (request_rec *);<br />
<br />
/* Subsidiary dispatch table for response-phase <br />
* handlers, by MIME type */<br />
<br />
handler_rec cgi_handlers[] = {<br />
<span class="indent">
{ "application/x-httpd-cgi", cgi_handler },<br />
{ NULL }<br />
</span>
};<br />
<br />
/* Declarations of routines to manipulate the <br />
* module's configuration info. Note that these are<br />
* returned, and passed in, as void *'s; the server<br />
* core keeps track of them, but it doesn't, and can't,<br />
* know their internal structure.<br />
*/<br />
<br />
void *make_cgi_server_config (pool *);<br />
void *merge_cgi_server_config (pool *, void *, void *);<br />
<br />
/* Declarations of routines to handle config-file commands */<br />
<br />
extern char *script_alias(cmd_parms *, void *per_dir_config, char *fake,
char *real);<br />
<br />
command_rec cgi_cmds[] = {<br />
<span class="indent">
{ "ScriptAlias", script_alias, NULL, RSRC_CONF, TAKE2,<br />
<span class="indent">"a fakename and a realname"},<br /></span>
{ NULL }<br />
</span>
};<br />
<br />
module cgi_module = {
</code></p><pre> STANDARD_MODULE_STUFF,
NULL, /* initializer */
NULL, /* dir config creator */
NULL, /* dir merger */
make_cgi_server_config, /* server config */
merge_cgi_server_config, /* merge server config */
cgi_cmds, /* command table */
cgi_handlers, /* handlers */
translate_scriptalias, /* filename translation */
NULL, /* check_user_id */
NULL, /* check auth */
NULL, /* check access */
type_scriptalias, /* type_checker */
NULL, /* fixups */
NULL, /* logger */
NULL /* header parser */
};</pre></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="handlers" id="handlers">How handlers work</a></h2>
<p>The sole argument to handlers is a <code>request_rec</code> structure.
This structure describes a particular request which has been made to the
server, on behalf of a client. In most cases, each connection to the
client generates only one <code>request_rec</code> structure.</p>
<h3><a name="req_tour" id="req_tour">A brief tour of the request_rec</a></h3>
<p>The <code>request_rec</code> contains pointers to a resource pool
which will be cleared when the server is finished handling the request;
to structures containing per-server and per-connection information, and
most importantly, information on the request itself.</p>
<p>The most important such information is a small set of character strings
describing attributes of the object being requested, including its URI,
filename, content-type and content-encoding (these being filled in by the
translation and type-check handlers which handle the request,
respectively).</p>
<p>Other commonly used data items are tables giving the MIME headers on
the client's original request, MIME headers to be sent back with the
response (which modules can add to at will), and environment variables for
any subprocesses which are spawned off in the course of servicing the
request. These tables are manipulated using the <code>ap_table_get</code>
and <code>ap_table_set</code> routines.</p>
<div class="note">
<p>Note that the <code>Content-type</code> header value <em>cannot</em>
be set by module content-handlers using the <code>ap_table_*()</code>
routines. Rather, it is set by pointing the <code>content_type</code>
field in the <code>request_rec</code> structure to an appropriate
string. <em>e.g.</em>,</p>
<div class="example"><p><code>
r->content_type = "text/html";
</code></p></div>
</div>
<p>Finally, there are pointers to two data structures which, in turn,
point to per-module configuration structures. Specifically, these hold
pointers to the data structures which the module has built to describe
the way it has been configured to operate in a given directory (via
<code>.htaccess</code> files or <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections), for private data it has built in the
course of servicing the request (so modules' handlers for one phase can
pass `notes' to their handlers for other phases). There is another such
configuration vector in the <code>server_rec</code> data structure pointed
to by the <code>request_rec</code>, which contains per (virtual) server
configuration data.</p>
<p>Here is an abridged declaration, giving the fields most commonly
used:</p>
<div class="example"><p><code>
struct request_rec {<br />
<br />
pool *pool;<br />
conn_rec *connection;<br />
server_rec *server;<br />
<br />
/* What object is being requested */<br />
<br />
char *uri;<br />
char *filename;<br />
char *path_info;
</code></p><pre>char *args; /* QUERY_ARGS, if any */
struct stat finfo; /* Set by server core;
* st_mode set to zero if no such file */</pre><p><code>
char *content_type;<br />
char *content_encoding;<br />
<br />
/* MIME header environments, in and out. Also, <br />
* an array containing environment variables to<br />
* be passed to subprocesses, so people can write<br />
* modules to add to that environment.<br />
*<br />
* The difference between headers_out and <br />
* err_headers_out is that the latter are printed <br />
* even on error, and persist across internal<br />
* redirects (so the headers printed for <br />
* <code class="directive"><a href="../mod/core.html#errordocument">ErrorDocument</a></code> handlers will have
them).<br />
*/<br />
<br />
table *headers_in;<br />
table *headers_out;<br />
table *err_headers_out;<br />
table *subprocess_env;<br />
<br />
/* Info about the request itself... */<br />
<br />
</code></p><pre>int header_only; /* HEAD request, as opposed to GET */
char *protocol; /* Protocol, as given to us, or HTTP/0.9 */
char *method; /* GET, HEAD, POST, <em>etc.</em> */
int method_number; /* M_GET, M_POST, <em>etc.</em> */</pre><p><code>
/* Info for logging */<br />
<br />
char *the_request;<br />
int bytes_sent;<br />
<br />
/* A flag which modules can set, to indicate that<br />
* the data being returned is volatile, and clients<br />
* should be told not to cache it.<br />
*/<br />
<br />
int no_cache;<br />
<br />
/* Various other config info which may change<br />
* with .htaccess files<br />
* These are config vectors, with one void*<br />
* pointer for each module (the thing pointed<br />
* to being the module's business).<br />
*/<br />
<br />
</code></p><pre>void *per_dir_config; /* Options set in config files, <em>etc.</em> */
void *request_config; /* Notes on *this* request */</pre><p><code>
};
</code></p></div>
<h3><a name="req_orig" id="req_orig">Where request_rec structures come from</a></h3>
<p>Most <code>request_rec</code> structures are built by reading an HTTP
request from a client, and filling in the fields. However, there are a
few exceptions:</p>
<ul>
<li>If the request is to an imagemap, a type map (<em>i.e.</em>, a
<code>*.var</code> file), or a CGI script which returned a local
`Location:', then the resource which the user requested is going to be
ultimately located by some URI other than what the client originally
supplied. In this case, the server does an <em>internal redirect</em>,
constructing a new <code>request_rec</code> for the new URI, and
processing it almost exactly as if the client had requested the new URI
directly.</li>
<li>If some handler signaled an error, and an <code>ErrorDocument</code>
is in scope, the same internal redirect machinery comes into play.</li>
<li><p>Finally, a handler occasionally needs to investigate `what would
happen if' some other request were run. For instance, the directory
indexing module needs to know what MIME type would be assigned to a
request for each directory entry, in order to figure out what icon to
use.</p>
<p>Such handlers can construct a <em>sub-request</em>, using the
functions <code>ap_sub_req_lookup_file</code>,
<code>ap_sub_req_lookup_uri</code>, and <code>ap_sub_req_method_uri</code>;
these construct a new <code>request_rec</code> structure and processes it
as you would expect, up to but not including the point of actually sending
a response. (These functions skip over the access checks if the
sub-request is for a file in the same directory as the original
request).</p>
<p>(Server-side includes work by building sub-requests and then actually
invoking the response handler for them, via the function
<code>ap_run_sub_req</code>).</p>
</li>
</ul>
<h3><a name="req_return" id="req_return">Handling requests, declining, and returning
error codes</a></h3>
<p>As discussed above, each handler, when invoked to handle a particular
<code>request_rec</code>, has to return an <code>int</code> to indicate
what happened. That can either be</p>
<ul>
<li><code>OK</code> -- the request was handled successfully. This may or
may not terminate the phase.</li>
<li><code>DECLINED</code> -- no erroneous condition exists, but the module
declines to handle the phase; the server tries to find another.</li>
<li>an HTTP error code, which aborts handling of the request.</li>
</ul>
<p>Note that if the error code returned is <code>REDIRECT</code>, then
the module should put a <code>Location</code> in the request's
<code>headers_out</code>, to indicate where the client should be
redirected <em>to</em>.</p>
<h3><a name="resp_handlers" id="resp_handlers">Special considerations for response
handlers</a></h3>
<p>Handlers for most phases do their work by simply setting a few fields
in the <code>request_rec</code> structure (or, in the case of access
checkers, simply by returning the correct error code). However, response
handlers have to actually send a request back to the client.</p>
<p>They should begin by sending an HTTP response header, using the
function <code>ap_send_http_header</code>. (You don't have to do anything
special to skip sending the header for HTTP/0.9 requests; the function
figures out on its own that it shouldn't do anything). If the request is
marked <code>header_only</code>, that's all they should do; they should
return after that, without attempting any further output.</p>
<p>Otherwise, they should produce a request body which responds to the
client as appropriate. The primitives for this are <code>ap_rputc</code>
and <code>ap_rprintf</code>, for internally generated output, and
<code>ap_send_fd</code>, to copy the contents of some <code>FILE *</code>
straight to the client.</p>
<p>At this point, you should more or less understand the following piece
of code, which is the handler which handles <code>GET</code> requests
which have no more specific handler; it also shows how conditional
<code>GET</code>s can be handled, if it's desirable to do so in a
particular response handler -- <code>ap_set_last_modified</code> checks
against the <code>If-modified-since</code> value supplied by the client,
if any, and returns an appropriate code (which will, if nonzero, be
USE_LOCAL_COPY). No similar considerations apply for
<code>ap_set_content_length</code>, but it returns an error code for
symmetry.</p>
<div class="example"><p><code>
int default_handler (request_rec *r)<br />
{<br />
<span class="indent">
int errstatus;<br />
FILE *f;<br />
<br />
if (r->method_number != M_GET) return DECLINED;<br />
if (r->finfo.st_mode == 0) return NOT_FOUND;<br />
<br />
if ((errstatus = ap_set_content_length (r, r->finfo.st_size))<br />
||
(errstatus = ap_set_last_modified (r, r->finfo.st_mtime)))<br />
return errstatus;<br />
<br />
f = fopen (r->filename, "r");<br />
<br />
if (f == NULL) {<br />
<span class="indent">
log_reason("file permissions deny server access", r->filename, r);<br />
return FORBIDDEN;<br />
</span>
}<br />
<br />
register_timeout ("send", r);<br />
ap_send_http_header (r);<br />
<br />
if (!r->header_only) send_fd (f, r);<br />
ap_pfclose (r->pool, f);<br />
return OK;<br />
</span>
}
</code></p></div>
<p>Finally, if all of this is too much of a challenge, there are a few
ways out of it. First off, as shown above, a response handler which has
not yet produced any output can simply return an error code, in which
case the server will automatically produce an error response. Secondly,
it can punt to some other handler by invoking
<code>ap_internal_redirect</code>, which is how the internal redirection
machinery discussed above is invoked. A response handler which has
internally redirected should always return <code>OK</code>.</p>
<p>(Invoking <code>ap_internal_redirect</code> from handlers which are
<em>not</em> response handlers will lead to serious confusion).</p>
<h3><a name="auth_handlers" id="auth_handlers">Special considerations for authentication
handlers</a></h3>
<p>Stuff that should be discussed here in detail:</p>
<ul>
<li>Authentication-phase handlers not invoked unless auth is
configured for the directory.</li>
<li>Common auth configuration stored in the core per-dir
configuration; it has accessors <code>ap_auth_type</code>,
<code>ap_auth_name</code>, and <code>ap_requires</code>.</li>
<li>Common routines, to handle the protocol end of things, at
least for HTTP basic authentication
(<code>ap_get_basic_auth_pw</code>, which sets the
<code>connection->user</code> structure field
automatically, and <code>ap_note_basic_auth_failure</code>,
which arranges for the proper <code>WWW-Authenticate:</code>
header to be sent back).</li>
</ul>
<h3><a name="log_handlers" id="log_handlers">Special considerations for logging
handlers</a></h3>
<p>When a request has internally redirected, there is the question of
what to log. Apache handles this by bundling the entire chain of redirects
into a list of <code>request_rec</code> structures which are threaded
through the <code>r->prev</code> and <code>r->next</code> pointers.
The <code>request_rec</code> which is passed to the logging handlers in
such cases is the one which was originally built for the initial request
from the client; note that the <code>bytes_sent</code> field will only be
correct in the last request in the chain (the one for which a response was
actually sent).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="pools" id="pools">Resource allocation and resource pools</a></h2>
<p>One of the problems of writing and designing a server-pool server is
that of preventing leakage, that is, allocating resources (memory, open
files, <em>etc.</em>), without subsequently releasing them. The resource
pool machinery is designed to make it easy to prevent this from happening,
by allowing resource to be allocated in such a way that they are
<em>automatically</em> released when the server is done with them.</p>
<p>The way this works is as follows: the memory which is allocated, file
opened, <em>etc.</em>, to deal with a particular request are tied to a
<em>resource pool</em> which is allocated for the request. The pool is a
data structure which itself tracks the resources in question.</p>
<p>When the request has been processed, the pool is <em>cleared</em>. At
that point, all the memory associated with it is released for reuse, all
files associated with it are closed, and any other clean-up functions which
are associated with the pool are run. When this is over, we can be confident
that all the resource tied to the pool have been released, and that none of
them have leaked.</p>
<p>Server restarts, and allocation of memory and resources for per-server
configuration, are handled in a similar way. There is a <em>configuration
pool</em>, which keeps track of resources which were allocated while reading
the server configuration files, and handling the commands therein (for
instance, the memory that was allocated for per-server module configuration,
log files and other files that were opened, and so forth). When the server
restarts, and has to reread the configuration files, the configuration pool
is cleared, and so the memory and file descriptors which were taken up by
reading them the last time are made available for reuse.</p>
<p>It should be noted that use of the pool machinery isn't generally
obligatory, except for situations like logging handlers, where you really
need to register cleanups to make sure that the log file gets closed when
the server restarts (this is most easily done by using the function <code><a href="#pool-files">ap_pfopen</a></code>, which also arranges for the
underlying file descriptor to be closed before any child processes, such as
for CGI scripts, are <code>exec</code>ed), or in case you are using the
timeout machinery (which isn't yet even documented here). However, there are
two benefits to using it: resources allocated to a pool never leak (even if
you allocate a scratch string, and just forget about it); also, for memory
allocation, <code>ap_palloc</code> is generally faster than
<code>malloc</code>.</p>
<p>We begin here by describing how memory is allocated to pools, and then
discuss how other resources are tracked by the resource pool machinery.</p>
<h3>Allocation of memory in pools</h3>
<p>Memory is allocated to pools by calling the function
<code>ap_palloc</code>, which takes two arguments, one being a pointer to
a resource pool structure, and the other being the amount of memory to
allocate (in <code>char</code>s). Within handlers for handling requests,
the most common way of getting a resource pool structure is by looking at
the <code>pool</code> slot of the relevant <code>request_rec</code>; hence
the repeated appearance of the following idiom in module code:</p>
<div class="example"><p><code>
int my_handler(request_rec *r)<br />
{<br />
<span class="indent">
struct my_structure *foo;<br />
...<br />
<br />
foo = (foo *)ap_palloc (r->pool, sizeof(my_structure));<br />
</span>
}
</code></p></div>
<p>Note that <em>there is no <code>ap_pfree</code></em> --
<code>ap_palloc</code>ed memory is freed only when the associated resource
pool is cleared. This means that <code>ap_palloc</code> does not have to
do as much accounting as <code>malloc()</code>; all it does in the typical
case is to round up the size, bump a pointer, and do a range check.</p>
<p>(It also raises the possibility that heavy use of
<code>ap_palloc</code> could cause a server process to grow excessively
large. There are two ways to deal with this, which are dealt with below;
briefly, you can use <code>malloc</code>, and try to be sure that all of
the memory gets explicitly <code>free</code>d, or you can allocate a
sub-pool of the main pool, allocate your memory in the sub-pool, and clear
it out periodically. The latter technique is discussed in the section
on sub-pools below, and is used in the directory-indexing code, in order
to avoid excessive storage allocation when listing directories with
thousands of files).</p>
<h3>Allocating initialized memory</h3>
<p>There are functions which allocate initialized memory, and are
frequently useful. The function <code>ap_pcalloc</code> has the same
interface as <code>ap_palloc</code>, but clears out the memory it
allocates before it returns it. The function <code>ap_pstrdup</code>
takes a resource pool and a <code>char *</code> as arguments, and
allocates memory for a copy of the string the pointer points to, returning
a pointer to the copy. Finally <code>ap_pstrcat</code> is a varargs-style
function, which takes a pointer to a resource pool, and at least two
<code>char *</code> arguments, the last of which must be
<code>NULL</code>. It allocates enough memory to fit copies of each of
the strings, as a unit; for instance:</p>
<div class="example"><p><code>
ap_pstrcat (r->pool, "foo", "/", "bar", NULL);
</code></p></div>
<p>returns a pointer to 8 bytes worth of memory, initialized to
<code>"foo/bar"</code>.</p>
<h3><a name="pools-used" id="pools-used">Commonly-used pools in the Apache Web
server</a></h3>
<p>A pool is really defined by its lifetime more than anything else.
There are some static pools in http_main which are passed to various
non-http_main functions as arguments at opportune times. Here they
are:</p>
<dl>
<dt><code>permanent_pool</code></dt>
<dd>never passed to anything else, this is the ancestor of all pools</dd>
<dt><code>pconf</code></dt>
<dd>
<ul>
<li>subpool of permanent_pool</li>
<li>created at the beginning of a config "cycle"; exists
until the server is terminated or restarts; passed to all
config-time routines, either via cmd->pool, or as the
"pool *p" argument on those which don't take pools</li>
<li>passed to the module init() functions</li>
</ul>
</dd>
<dt><code>ptemp</code></dt>
<dd>
<ul>
<li>sorry I lie, this pool isn't called this currently in
1.3, I renamed it this in my pthreads development. I'm
referring to the use of ptrans in the parent... contrast
this with the later definition of ptrans in the
child.</li>
<li>subpool of permanent_pool</li>
<li>created at the beginning of a config "cycle"; exists
until the end of config parsing; passed to config-time
routines <em>via</em> cmd->temp_pool. Somewhat of a
"bastard child" because it isn't available everywhere.
Used for temporary scratch space which may be needed by
some config routines but which is deleted at the end of
config.</li>
</ul>
</dd>
<dt><code>pchild</code></dt>
<dd>
<ul>
<li>subpool of permanent_pool</li>
<li>created when a child is spawned (or a thread is
created); lives until that child (thread) is
destroyed</li>
<li>passed to the module child_init functions</li>
<li>destruction happens right after the child_exit
functions are called... (which may explain why I think
child_exit is redundant and unneeded)</li>
</ul>
</dd>
<dt><code>ptrans</code></dt>
<dd>
<ul>
<li>should be a subpool of pchild, but currently is a
subpool of permanent_pool, see above</li>
<li>cleared by the child before going into the accept()
loop to receive a connection</li>
<li>used as connection->pool</li>
</ul>
</dd>
<dt><code>r->pool</code></dt>
<dd>
<ul>
<li>for the main request this is a subpool of
connection->pool; for subrequests it is a subpool of
the parent request's pool.</li>
<li>exists until the end of the request (<em>i.e.</em>,
ap_destroy_sub_req, or in child_main after
process_request has finished)</li>
<li>note that r itself is allocated from r->pool;
<em>i.e.</em>, r->pool is first created and then r is
the first thing palloc()d from it</li>
</ul>
</dd>
</dl>
<p>For almost everything folks do, <code>r->pool</code> is the pool to
use. But you can see how other lifetimes, such as pchild, are useful to
some modules... such as modules that need to open a database connection
once per child, and wish to clean it up when the child dies.</p>
<p>You can also see how some bugs have manifested themself, such as
setting <code>connection->user</code> to a value from
<code>r->pool</code> -- in this case connection exists for the
lifetime of <code>ptrans</code>, which is longer than
<code>r->pool</code> (especially if <code>r->pool</code> is a
subrequest!). So the correct thing to do is to allocate from
<code>connection->pool</code>.</p>
<p>And there was another interesting bug in <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
/ <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>. You'll see in those that they do this test
to decide if they should use <code>r->pool</code> or
<code>r->main->pool</code>. In this case the resource that they are
registering for cleanup is a child process. If it were registered in
<code>r->pool</code>, then the code would <code>wait()</code> for the
child when the subrequest finishes. With <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> this
could be any old <code>#include</code>, and the delay can be up to 3
seconds... and happened quite frequently. Instead the subprocess is
registered in <code>r->main->pool</code> which causes it to be
cleaned up when the entire request is done -- <em>i.e.</em>, after the
output has been sent to the client and logging has happened.</p>
<h3><a name="pool-files" id="pool-files">Tracking open files, etc.</a></h3>
<p>As indicated above, resource pools are also used to track other sorts
of resources besides memory. The most common are open files. The routine
which is typically used for this is <code>ap_pfopen</code>, which takes a
resource pool and two strings as arguments; the strings are the same as
the typical arguments to <code>fopen</code>, <em>e.g.</em>,</p>
<div class="example"><p><code>
...<br />
FILE *f = ap_pfopen (r->pool, r->filename, "r");<br />
<br />
if (f == NULL) { ... } else { ... }<br />
</code></p></div>
<p>There is also a <code>ap_popenf</code> routine, which parallels the
lower-level <code>open</code> system call. Both of these routines arrange
for the file to be closed when the resource pool in question is
cleared.</p>
<p>Unlike the case for memory, there <em>are</em> functions to close files
allocated with <code>ap_pfopen</code>, and <code>ap_popenf</code>, namely
<code>ap_pfclose</code> and <code>ap_pclosef</code>. (This is because, on
many systems, the number of files which a single process can have open is
quite limited). It is important to use these functions to close files
allocated with <code>ap_pfopen</code> and <code>ap_popenf</code>, since to
do otherwise could cause fatal errors on systems such as Linux, which
react badly if the same <code>FILE*</code> is closed more than once.</p>
<p>(Using the <code>close</code> functions is not mandatory, since the
file will eventually be closed regardless, but you should consider it in
cases where your module is opening, or could open, a lot of files).</p>
<h3>Other sorts of resources -- cleanup functions</h3>
<p>More text goes here. Describe the cleanup primitives in terms of
which the file stuff is implemented; also, <code>spawn_process</code>.</p>
<p>Pool cleanups live until <code>clear_pool()</code> is called:
<code>clear_pool(a)</code> recursively calls <code>destroy_pool()</code>
on all subpools of <code>a</code>; then calls all the cleanups for
<code>a</code>; then releases all the memory for <code>a</code>.
<code>destroy_pool(a)</code> calls <code>clear_pool(a)</code> and then
releases the pool structure itself. <em>i.e.</em>,
<code>clear_pool(a)</code> doesn't delete <code>a</code>, it just frees
up all the resources and you can start using it again immediately.</p>
<h3>Fine control -- creating and dealing with sub-pools, with
a note on sub-requests</h3>
<p>On rare occasions, too-free use of <code>ap_palloc()</code> and the
associated primitives may result in undesirably profligate resource
allocation. You can deal with such a case by creating a <em>sub-pool</em>,
allocating within the sub-pool rather than the main pool, and clearing or
destroying the sub-pool, which releases the resources which were
associated with it. (This really <em>is</em> a rare situation; the only
case in which it comes up in the standard module set is in case of listing
directories, and then only with <em>very</em> large directories.
Unnecessary use of the primitives discussed here can hair up your code
quite a bit, with very little gain).</p>
<p>The primitive for creating a sub-pool is <code>ap_make_sub_pool</code>,
which takes another pool (the parent pool) as an argument. When the main
pool is cleared, the sub-pool will be destroyed. The sub-pool may also be
cleared or destroyed at any time, by calling the functions
<code>ap_clear_pool</code> and <code>ap_destroy_pool</code>, respectively.
(The difference is that <code>ap_clear_pool</code> frees resources
associated with the pool, while <code>ap_destroy_pool</code> also
deallocates the pool itself. In the former case, you can allocate new
resources within the pool, and clear it again, and so forth; in the
latter case, it is simply gone).</p>
<p>One final note -- sub-requests have their own resource pools, which are
sub-pools of the resource pool for the main request. The polite way to
reclaim the resources associated with a sub request which you have
allocated (using the <code>ap_sub_req_...</code> functions) is
<code>ap_destroy_sub_req</code>, which frees the resource pool. Before
calling this function, be sure to copy anything that you care about which
might be allocated in the sub-request's resource pool into someplace a
little less volatile (for instance, the filename in its
<code>request_rec</code> structure).</p>
<p>(Again, under most circumstances, you shouldn't feel obliged to call
this function; only 2K of memory or so are allocated for a typical sub
request, and it will be freed anyway when the main request pool is
cleared. It is only when you are allocating many, many sub-requests for a
single main request that you should seriously consider the
<code>ap_destroy_...</code> functions).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="config" id="config">Configuration, commands and the like</a></h2>
<p>One of the design goals for this server was to maintain external
compatibility with the NCSA 1.3 server --- that is, to read the same
configuration files, to process all the directives therein correctly, and
in general to be a drop-in replacement for NCSA. On the other hand, another
design goal was to move as much of the server's functionality into modules
which have as little as possible to do with the monolithic server core. The
only way to reconcile these goals is to move the handling of most commands
from the central server into the modules.</p>
<p>However, just giving the modules command tables is not enough to divorce
them completely from the server core. The server has to remember the
commands in order to act on them later. That involves maintaining data which
is private to the modules, and which can be either per-server, or
per-directory. Most things are per-directory, including in particular access
control and authorization information, but also information on how to
determine file types from suffixes, which can be modified by
<code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> and <code class="directive"><a href="../mod/core.html#forcetype">ForceType</a></code> directives, and so forth. In general,
the governing philosophy is that anything which <em>can</em> be made
configurable by directory should be; per-server information is generally
used in the standard set of modules for information like
<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>es and <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code>s which come into play before the
request is tied to a particular place in the underlying file system.</p>
<p>Another requirement for emulating the NCSA server is being able to handle
the per-directory configuration files, generally called
<code>.htaccess</code> files, though even in the NCSA server they can
contain directives which have nothing at all to do with access control.
Accordingly, after URI -> filename translation, but before performing any
other phase, the server walks down the directory hierarchy of the underlying
filesystem, following the translated pathname, to read any
<code>.htaccess</code> files which might be present. The information which
is read in then has to be <em>merged</em> with the applicable information
from the server's own config files (either from the <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections in
<code>access.conf</code>, or from defaults in <code>srm.conf</code>, which
actually behaves for most purposes almost exactly like <code><Directory
/></code>).</p>
<p>Finally, after having served a request which involved reading
<code>.htaccess</code> files, we need to discard the storage allocated for
handling them. That is solved the same way it is solved wherever else
similar problems come up, by tying those structures to the per-transaction
resource pool.</p>
<h3><a name="per-dir" id="per-dir">Per-directory configuration structures</a></h3>
<p>Let's look out how all of this plays out in <code>mod_mime.c</code>,
which defines the file typing handler which emulates the NCSA server's
behavior of determining file types from suffixes. What we'll be looking
at, here, is the code which implements the <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> and <code class="directive"><a href="../mod/mod_mime.html#addencoding">AddEncoding</a></code> commands. These commands can appear in
<code>.htaccess</code> files, so they must be handled in the module's
private per-directory data, which in fact, consists of two separate
tables for MIME types and encoding information, and is declared as
follows:</p>
<div class="example"><pre>typedef struct {
table *forced_types; /* Additional AddTyped stuff */
table *encoding_types; /* Added with AddEncoding... */
} mime_dir_config;</pre></div>
<p>When the server is reading a configuration file, or <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> section, which includes
one of the MIME module's commands, it needs to create a
<code>mime_dir_config</code> structure, so those commands have something
to act on. It does this by invoking the function it finds in the module's
`create per-dir config slot', with two arguments: the name of the
directory to which this configuration information applies (or
<code>NULL</code> for <code>srm.conf</code>), and a pointer to a
resource pool in which the allocation should happen.</p>
<p>(If we are reading a <code>.htaccess</code> file, that resource pool
is the per-request resource pool for the request; otherwise it is a
resource pool which is used for configuration data, and cleared on
restarts. Either way, it is important for the structure being created to
vanish when the pool is cleared, by registering a cleanup on the pool if
necessary).</p>
<p>For the MIME module, the per-dir config creation function just
<code>ap_palloc</code>s the structure above, and a creates a couple of
tables to fill it. That looks like this:</p>
<div class="example"><p><code>
void *create_mime_dir_config (pool *p, char *dummy)<br />
{<br />
<span class="indent">
mime_dir_config *new =<br />
<span class="indent">
(mime_dir_config *) ap_palloc (p, sizeof(mime_dir_config));<br />
</span>
<br />
new->forced_types = ap_make_table (p, 4);<br />
new->encoding_types = ap_make_table (p, 4);<br />
<br />
return new;<br />
</span>
}
</code></p></div>
<p>Now, suppose we've just read in a <code>.htaccess</code> file. We
already have the per-directory configuration structure for the next
directory up in the hierarchy. If the <code>.htaccess</code> file we just
read in didn't have any <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code>
or <code class="directive"><a href="../mod/mod_mime.html#addencoding">AddEncoding</a></code> commands, its
per-directory config structure for the MIME module is still valid, and we
can just use it. Otherwise, we need to merge the two structures
somehow.</p>
<p>To do that, the server invokes the module's per-directory config merge
function, if one is present. That function takes three arguments: the two
structures being merged, and a resource pool in which to allocate the
result. For the MIME module, all that needs to be done is overlay the
tables from the new per-directory config structure with those from the
parent:</p>
<div class="example"><p><code>
void *merge_mime_dir_configs (pool *p, void *parent_dirv, void *subdirv)<br />
{<br />
<span class="indent">
mime_dir_config *parent_dir = (mime_dir_config *)parent_dirv;<br />
mime_dir_config *subdir = (mime_dir_config *)subdirv;<br />
mime_dir_config *new =<br />
<span class="indent">
(mime_dir_config *)ap_palloc (p, sizeof(mime_dir_config));<br />
</span>
<br />
new->forced_types = ap_overlay_tables (p, subdir->forced_types,<br />
<span class="indent">
parent_dir->forced_types);<br />
</span>
new->encoding_types = ap_overlay_tables (p, subdir->encoding_types,<br />
<span class="indent">
parent_dir->encoding_types);<br />
</span>
<br />
return new;<br />
</span>
}
</code></p></div>
<p>As a note -- if there is no per-directory merge function present, the
server will just use the subdirectory's configuration info, and ignore
the parent's. For some modules, that works just fine (<em>e.g.</em>, for
the includes module, whose per-directory configuration information
consists solely of the state of the <code>XBITHACK</code>), and for those
modules, you can just not declare one, and leave the corresponding
structure slot in the module itself <code>NULL</code>.</p>
<h3><a name="commands" id="commands">Command handling</a></h3>
<p>Now that we have these structures, we need to be able to figure out how
to fill them. That involves processing the actual <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> and <code class="directive"><a href="../mod/mod_mime.html#addencoding">AddEncoding</a></code> commands. To find commands, the server looks in
the module's command table. That table contains information on how many
arguments the commands take, and in what formats, where it is permitted,
and so forth. That information is sufficient to allow the server to invoke
most command-handling functions with pre-parsed arguments. Without further
ado, let's look at the <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code>
command handler, which looks like this (the <code class="directive"><a href="../mod/mod_mime.html#addencoding">AddEncoding</a></code> command looks basically the same, and won't be
shown here):</p>
<div class="example"><p><code>
char *add_type(cmd_parms *cmd, mime_dir_config *m, char *ct, char *ext)<br />
{<br />
<span class="indent">
if (*ext == '.') ++ext;<br />
ap_table_set (m->forced_types, ext, ct);<br />
return NULL;<br />
</span>
}
</code></p></div>
<p>This command handler is unusually simple. As you can see, it takes
four arguments, two of which are pre-parsed arguments, the third being the
per-directory configuration structure for the module in question, and the
fourth being a pointer to a <code>cmd_parms</code> structure. That
structure contains a bunch of arguments which are frequently of use to
some, but not all, commands, including a resource pool (from which memory
can be allocated, and to which cleanups should be tied), and the (virtual)
server being configured, from which the module's per-server configuration
data can be obtained if required.</p>
<p>Another way in which this particular command handler is unusually
simple is that there are no error conditions which it can encounter. If
there were, it could return an error message instead of <code>NULL</code>;
this causes an error to be printed out on the server's
<code>stderr</code>, followed by a quick exit, if it is in the main config
files; for a <code>.htaccess</code> file, the syntax error is logged in
the server error log (along with an indication of where it came from), and
the request is bounced with a server error response (HTTP error status,
code 500).</p>
<p>The MIME module's command table has entries for these commands, which
look like this:</p>
<div class="example"><p><code>
command_rec mime_cmds[] = {<br />
<span class="indent">
{ "AddType", add_type, NULL, OR_FILEINFO, TAKE2,<br />
<span class="indent">"a mime type followed by a file extension" },<br /></span>
{ "AddEncoding", add_encoding, NULL, OR_FILEINFO, TAKE2,<br />
<span class="indent">
"an encoding (<em>e.g.</em>, gzip), followed by a file extension" },<br />
</span>
{ NULL }<br />
</span>
};
</code></p></div>
<p>The entries in these tables are:</p>
<ul>
<li>The name of the command</li>
<li>The function which handles it</li>
<li>a <code>(void *)</code> pointer, which is passed in the
<code>cmd_parms</code> structure to the command handler ---
this is useful in case many similar commands are handled by
the same function.</li>
<li>A bit mask indicating where the command may appear. There
are mask bits corresponding to each
<code>AllowOverride</code> option, and an additional mask
bit, <code>RSRC_CONF</code>, indicating that the command may
appear in the server's own config files, but <em>not</em> in
any <code>.htaccess</code> file.</li>
<li>A flag indicating how many arguments the command handler
wants pre-parsed, and how they should be passed in.
<code>TAKE2</code> indicates two pre-parsed arguments. Other
options are <code>TAKE1</code>, which indicates one
pre-parsed argument, <code>FLAG</code>, which indicates that
the argument should be <code>On</code> or <code>Off</code>,
and is passed in as a boolean flag, <code>RAW_ARGS</code>,
which causes the server to give the command the raw, unparsed
arguments (everything but the command name itself). There is
also <code>ITERATE</code>, which means that the handler looks
the same as <code>TAKE1</code>, but that if multiple
arguments are present, it should be called multiple times,
and finally <code>ITERATE2</code>, which indicates that the
command handler looks like a <code>TAKE2</code>, but if more
arguments are present, then it should be called multiple
times, holding the first argument constant.</li>
<li>Finally, we have a string which describes the arguments
that should be present. If the arguments in the actual config
file are not as required, this string will be used to help
give a more specific error message. (You can safely leave
this <code>NULL</code>).</li>
</ul>
<p>Finally, having set this all up, we have to use it. This is ultimately
done in the module's handlers, specifically for its file-typing handler,
which looks more or less like this; note that the per-directory
configuration structure is extracted from the <code>request_rec</code>'s
per-directory configuration vector by using the
<code>ap_get_module_config</code> function.</p>
<div class="example"><p><code>
int find_ct(request_rec *r)<br />
{<br />
<span class="indent">
int i;<br />
char *fn = ap_pstrdup (r->pool, r->filename);<br />
mime_dir_config *conf = (mime_dir_config *)<br />
<span class="indent">
ap_get_module_config(r->per_dir_config, &mime_module);<br />
</span>
char *type;<br />
<br />
if (S_ISDIR(r->finfo.st_mode)) {<br />
<span class="indent">
r->content_type = DIR_MAGIC_TYPE;<br />
return OK;<br />
</span>
}<br />
<br />
if((i=ap_rind(fn,'.')) < 0) return DECLINED;<br />
++i;<br />
<br />
if ((type = ap_table_get (conf->encoding_types, &fn[i])))<br />
{<br />
<span class="indent">
r->content_encoding = type;<br />
<br />
/* go back to previous extension to try to use it as a type */<br />
fn[i-1] = '\0';<br />
if((i=ap_rind(fn,'.')) < 0) return OK;<br />
++i;<br />
</span>
}<br />
<br />
if ((type = ap_table_get (conf->forced_types, &fn[i])))<br />
{<br />
<span class="indent">
r->content_type = type;<br />
</span>
}<br />
<br />
return OK;
</span>
}
</code></p></div>
<h3><a name="servconf" id="servconf">Side notes -- per-server configuration,
virtual servers, <em>etc</em>.</a></h3>
<p>The basic ideas behind per-server module configuration are basically
the same as those for per-directory configuration; there is a creation
function and a merge function, the latter being invoked where a virtual
server has partially overridden the base server configuration, and a
combined structure must be computed. (As with per-directory configuration,
the default if no merge function is specified, and a module is configured
in some virtual server, is that the base configuration is simply
ignored).</p>
<p>The only substantial difference is that when a command needs to
configure the per-server private module data, it needs to go to the
<code>cmd_parms</code> data to get at it. Here's an example, from the
alias module, which also indicates how a syntax error can be returned
(note that the per-directory configuration argument to the command
handler is declared as a dummy, since the module doesn't actually have
per-directory config data):</p>
<div class="example"><p><code>
char *add_redirect(cmd_parms *cmd, void *dummy, char *f, char *url)<br />
{<br />
<span class="indent">
server_rec *s = cmd->server;<br />
alias_server_conf *conf = (alias_server_conf *)<br />
<span class="indent">
ap_get_module_config(s->module_config,&alias_module);<br />
</span>
alias_entry *new = ap_push_array (conf->redirects);<br />
<br />
if (!ap_is_url (url)) return "Redirect to non-URL";<br />
<br />
new->fake = f; new->real = url;<br />
return NULL;<br />
</span>
}
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/API.html" title="English"> en </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/API.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/hooks.html.en 0000664 0001751 0001751 00000032535 14737241666 021456 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Hook Functions in the Apache HTTP Server 2.x - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>Hook Functions in the Apache HTTP Server 2.x</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/hooks.html" title="English"> en </a></p>
</div>
<div class="warning"><h3>Warning</h3>
<p>This document is still in development and may be partially out of
date.</p>
</div>
<p>In general, a hook function is one that the Apache HTTP Server
will call at some point during the processing of a request.
Modules can provide functions that are called, and specify when
they get called in comparison to other modules.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#corehooks">Core Hooks</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#create">Creating a hook function</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#hooking">Hooking the hook</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="corehooks" id="corehooks">Core Hooks</a></h2>
<p>The httpd's core modules offer a predefinined list of hooks
used during the standard <a href="./request.html">request processing</a>
phase. Creating a new hook will expose a function that
implements it (see sections below) but it is essential to understand that you will not
extend the httpd's core hooks. Their presence and order in the request processing is in fact
a consequence of how they are called in <code>server/request.c</code>
(check <a href="./modguide.html#hooking">this section</a>
for an overview). The core hooks are listed in the
<a href="https://ci.apache.org/projects/httpd/trunk/doxygen/group__hooks.html">doxygen documentation</a>.</p>
<p>Reading <a href="./modguide.html">guide for developing modules</a> and
<a href="./request.html">request processing</a> before proceeding is
highly recommended.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="create" id="create">Creating a hook function</a></h2>
<p>In order to create a new hook, four things need to be
done:</p>
<h3><a name="create-declare" id="create-declare">Declare the hook function</a></h3>
<p>Use the <code>AP_DECLARE_HOOK</code> macro, which needs to be given
the return type of the hook function, the name of the hook, and the
arguments. For example, if the hook returns an <code>int</code> and
takes a <code>request_rec *</code> and an <code>int</code> and is
called <code>do_something</code>, then declare it like this:</p>
<pre class="prettyprint lang-c">AP_DECLARE_HOOK(int, do_something, (request_rec *r, int n))</pre>
<p>This should go in a header which modules will include if
they want to use the hook.</p>
<h3><a name="create-create" id="create-create">Create the hook structure</a></h3>
<p>Each source file that exports a hook has a private structure
which is used to record the module functions that use the hook.
This is declared as follows:</p>
<pre class="prettyprint lang-c">APR_HOOK_STRUCT(
APR_HOOK_LINK(do_something)
...
)</pre>
<h3><a name="create-implement" id="create-implement">Implement the hook caller</a></h3>
<p>The source file that exports the hook has to implement a
function that will call the hook. There are currently three
possible ways to do this. In all cases, the calling function is
called <code>ap_run_<var>hookname</var>()</code>.</p>
<h4>Void hooks</h4>
<p>If the return value of a hook is <code>void</code>, then all the
hooks are called, and the caller is implemented like this:</p>
<pre class="prettyprint lang-c">AP_IMPLEMENT_HOOK_VOID(do_something, (request_rec *r, int n), (r, n))</pre>
<p>The second and third arguments are the dummy argument
declaration and the dummy arguments as they will be used when
calling the hook. In other words, this macro expands to
something like this:</p>
<pre class="prettyprint lang-c">void ap_run_do_something(request_rec *r, int n)
{
...
do_something(r, n);
}</pre>
<h4>Hooks that return a value</h4>
<p>If the hook returns a value, then it can either be run until
the first hook that does something interesting, like so:</p>
<pre class="prettyprint lang-c">AP_IMPLEMENT_HOOK_RUN_FIRST(int, do_something, (request_rec *r, int n), (r, n), DECLINED)</pre>
<p>The first hook that does <em>not</em> return <code>DECLINED</code>
stops the loop and its return value is returned from the hook
caller. Note that <code>DECLINED</code> is the traditional
hook return value meaning "I didn't do anything", but it can be
whatever suits you.</p>
<p>Alternatively, all hooks can be run until an error occurs.
This boils down to permitting <em>two</em> return values, one of
which means "I did something, and it was OK" and the other
meaning "I did nothing". The first function that returns a
value other than one of those two stops the loop, and its
return is the return value. Declare these like so:</p>
<pre class="prettyprint lang-c">AP_IMPLEMENT_HOOK_RUN_ALL(int, do_something, (request_rec *r, int n), (r, n), OK, DECLINED)</pre>
<p>Again, <code>OK</code> and <code>DECLINED</code> are the traditional
values. You can use what you want.</p>
<h3><a name="create-call" id="create-call">Call the hook callers</a></h3>
<p>At appropriate moments in the code, call the hook caller,
like so:</p>
<pre class="prettyprint lang-c">int n, ret;
request_rec *r;
ret=ap_run_do_something(r, n);</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="hooking" id="hooking">Hooking the hook</a></h2>
<p>A module that wants a hook to be called needs to do two
things.</p>
<h3><a name="hooking-implement" id="hooking-implement">Implement the hook function</a></h3>
<p>Include the appropriate header, and define a static function
of the correct type:</p>
<pre class="prettyprint lang-c">static int my_something_doer(request_rec *r, int n)
{
...
return OK;
}</pre>
<h3><a name="hooking-add" id="hooking-add">Add a hook registering function</a></h3>
<p>During initialisation, the server will call each modules hook
registering function, which is included in the module
structure:</p>
<pre class="prettyprint lang-c">static void my_register_hooks()
{
ap_hook_do_something(my_something_doer, NULL, NULL, APR_HOOK_MIDDLE);
}
mode MODULE_VAR_EXPORT my_module =
{
...
my_register_hooks /* register hooks */
};</pre>
<h3><a name="hooking-order" id="hooking-order">Controlling hook calling order</a></h3>
<p>In the example above, we didn't use the three arguments in
the hook registration function that control calling order of
all the functions registered within the hook.
There are two mechanisms for doing this. The first, rather
crude, method, allows us to specify roughly where the hook is
run relative to other modules. The final argument control this.
There are three possible values: <code>APR_HOOK_FIRST</code>,
<code>APR_HOOK_MIDDLE</code> and <code>APR_HOOK_LAST</code>.</p>
<p>All modules using any particular value may be run in any
order relative to each other, but, of course, all modules using
<code>APR_HOOK_FIRST</code> will be run before <code>APR_HOOK_MIDDLE</code>
which are before <code>APR_HOOK_LAST</code>. Modules that don't care
when they are run should use <code>APR_HOOK_MIDDLE</code>. <em>These
values are spaced out, so that positions like <code>APR_HOOK_FIRST-2</code>
are possible to hook slightly earlier than other functions.</em></p>
<p>Note that there are two more values,
<code>APR_HOOK_REALLY_FIRST</code> and <code>APR_HOOK_REALLY_LAST</code>. These
should only be used by the hook exporter.</p>
<p>The other method allows finer control. When a module knows
that it must be run before (or after) some other modules, it
can specify them by name. The second (third) argument is a
NULL-terminated array of strings consisting of the names of
modules that must be run before (after) the current module. For
example, suppose we want "mod_xyz.c" and "mod_abc.c" to run
before we do, then we'd hook as follows:</p>
<pre class="prettyprint lang-c">static void register_hooks()
{
static const char * const aszPre[] = { "mod_xyz.c", "mod_abc.c", NULL };
ap_hook_do_something(my_something_doer, aszPre, NULL, APR_HOOK_MIDDLE);
}</pre>
<p>Note that the sort used to achieve this is stable, so
ordering set by <code>APR_HOOK_<var>ORDER</var></code> is preserved, as far
as is possible.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/hooks.html" title="English"> en </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/hooks.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/new_api_2_4.html.en 0000664 0001751 0001751 00000072253 14737241666 022422 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>API Changes in Apache HTTP Server 2.4 since 2.2 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>API Changes in Apache HTTP Server 2.4 since 2.2</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/new_api_2_4.html" title="English"> en </a></p>
</div>
<p>This document describes changes to the Apache HTTPD API from
version 2.2 to 2.4, that may be of interest to module/application
developers and core hacks. As of the first GA release of the
2.4 branch API compatibility is preserved for the life of the
2.4 branch. (The
<a href="http://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x/VERSIONING">VERSIONING</a>
description for the 2.4 release provides more information about API
compatibility.)</p>
<p>API changes fall into two categories: APIs that are altogether new,
and existing APIs that are expanded or changed. The latter are
further divided into those where all changes are backwards-compatible
(so existing modules can ignore them), and those that might
require attention by maintainers. As with the transition from
HTTPD 2.0 to 2.2, existing modules and applications will require
recompiling and may call for some attention, but most should not
require any substantial updating (although some may be able to
take advantage of API changes to offer significant improvements).</p>
<p>For the purpose of this document, the API is split according
to the public header files. These headers are themselves the
reference documentation, and can be used to generate a browsable
HTML reference with <code>make docs</code>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#api_changes">Changed APIs</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#upgrading">Specific information on upgrading modules from 2.2</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="api_changes" id="api_changes">Changed APIs</a></h2>
<h3><a name="ap_expr" id="ap_expr">ap_expr (NEW!)</a></h3>
<p>Introduces a new API to parse and evaluate boolean and algebraic
expressions, including provision for a standard syntax and
customised variants.</p>
<h3><a name="ap_listen" id="ap_listen">ap_listen (changed; backwards-compatible)</a></h3>
<p>Introduces a new API to enable httpd child processes to serve
different purposes.</p>
<h3><a name="ap_mpm" id="ap_mpm">ap_mpm (changed)</a></h3>
<p><code>ap_mpm_run</code> is replaced by a new <code>mpm</code> hook.
Also <code>ap_graceful_stop_signalled</code> is lost, and
<code>ap_mpm_register_timed_callback</code> is new.</p>
<h3><a name="ap_regex" id="ap_regex">ap_regex (changed)</a></h3>
<p>In addition to the existing regexp wrapper, a new higher-level API
<code>ap_rxplus</code> is now provided. This provides the capability to
compile Perl-style expressions like <code>s/regexp/replacement/flags</code>
and to execute them against arbitrary strings. Support for regexp
backreferences is also added.</p>
<h3><a name="ap_slotmem" id="ap_slotmem">ap_slotmem (NEW!)</a></h3>
<p>Introduces an API for modules to allocate and manage memory slots,
most commonly for shared memory.</p>
<h3><a name="ap_socache" id="ap_socache">ap_socache (NEW!)</a></h3>
<p>API to manage a shared object cache.</p>
<h3><a name="heartbeat" id="heartbeat">heartbeat (NEW!)</a></h3>
<p>common structures for heartbeat modules</p>
<h3><a name="ap_parse_htaccess" id="ap_parse_htaccess">ap_parse_htaccess (changed)</a></h3>
<p>The function signature for <code>ap_parse_htaccess</code> has been
changed. A <code>apr_table_t</code> of individual directives allowed
for override must now be passed (override remains).</p>
<h3><a name="http_config" id="http_config">http_config (changed)</a></h3>
<ul>
<li>Introduces per-module, per-directory loglevels, including macro wrappers.</li>
<li>New <code>AP_DECLARE_MODULE</code> macro to declare all modules.</li>
<li>New <code>APLOG_USE_MODULE</code> macro necessary for per-module loglevels in
multi-file modules.</li>
<li>New API to retain data across module unload/load</li>
<li>New <code>check_config</code> hook</li>
<li>New <code>ap_process_fnmatch_configs()</code> function to process wildcards</li>
<li>Change <code>ap_configfile_t</code>, <code>ap_cfg_getline()</code>,
<code>ap_cfg_getc()</code> to return error codes, and add
<code>ap_pcfg_strerror()</code> for retrieving an error description.</li>
<li>Any config directive permitted in ACCESS_CONF context must now
correctly handle being called from an .htaccess file via the new
<code class="directive"><a href="../mod/core.html#allowoverridelist">AllowOverrideList</a></code> directive.
ap_check_cmd_context() accepts a new flag NOT_IN_HTACCESS to detect
this case.</li>
</ul>
<h3><a name="http_core" id="http_core">http_core (changed)</a></h3>
<ul>
<li>REMOVED <code>ap_default_type</code>, <code>ap_requires</code>, all
2.2 authnz API</li>
<li>Introduces Optional Functions for logio and authnz</li>
<li>New function <code>ap_get_server_name_for_url</code> to support IPv6
literals.</li>
<li>New function <code>ap_register_errorlog_handler</code> to register error log
format string handlers.</li>
<li>Arguments of <code>error_log</code> hook have changed. Declaration has moved to
<code>http_core.h</code>.</li>
<li>New function <code>ap_state_query</code> to determine if the server is in the
initial configuration preflight phase or not. This is both easier to
use and more correct than the old method of creating a pool userdata
entry in the process pool.</li>
<li>New function <code>ap_get_conn_socket</code> to get the socket descriptor for a
connection. This should be used instead of accessing the core
connection config directly.</li>
</ul>
<h3><a name="httpd" id="httpd">httpd (changed)</a></h3>
<ul>
<li>Introduce per-directory, per-module loglevel</li>
<li>New loglevels <code>APLOG_TRACEn</code></li>
<li>Introduce errorlog ids for requests and connections</li>
<li>Support for mod_request kept_body</li>
<li>Support buffering filter data for async requests</li>
<li>New <code>CONN_STATE</code> values</li>
<li>Function changes: <code>ap_escape_html</code> updated;
<code>ap_unescape_all</code>, <code>ap_escape_path_segment_buffer</code></li>
<li>Modules that load other modules later than the <code>EXEC_ON_READ</code> config
reading stage need to call <code>ap_reserve_module_slots()</code> or
<code>ap_reserve_module_slots_directive()</code> in their
<code>pre_config hook</code>.</li>
<li>The useragent IP address per request can now be tracked
independently of the client IP address of the connection, for
support of deployments with load balancers.</li>
</ul>
<h3><a name="http_log" id="http_log">http_log (changed)</a></h3>
<ul>
<li>Introduce per-directory, per-module loglevel</li>
<li>New loglevels <code>APLOG_TRACEn</code></li>
<li><code>ap_log_*error</code> become macro wrappers (backwards-compatible if
<code>APLOG_MARK</code> macro is used, except that is no longer possible to
use <code>#ifdef</code> inside the argument list)</li>
<li>piped logging revamped</li>
<li><code>module_index</code> added to error_log hook</li>
<li>new function: <code>ap_log_command_line</code></li>
</ul>
<h3><a name="http_request" id="http_request">http_request (changed)</a></h3>
<ul>
<li>New auth_internal API and auth_provider API</li>
<li>New <code>EOR</code> bucket type</li>
<li>New function <code>ap_process_async_request</code></li>
<li>New flags <code>AP_AUTH_INTERNAL_PER_CONF</code> and
<code>AP_AUTH_INTERNAL_PER_URI</code></li>
<li>New <code>access_checker_ex</code> hook to apply additional access control
and/or bypass authentication.</li>
<li>New functions <code>ap_hook_check_access_ex</code>,
<code>ap_hook_check_access</code>, <code>ap_hook_check_authn</code>,
<code>ap_hook_check_authz</code> which accept
<code>AP_AUTH_INTERNAL_PER_*</code> flags</li>
<li>DEPRECATED direct use of <code>ap_hook_access_checker</code>,
<code>access_checker_ex</code>, <code>ap_hook_check_user_id</code>,
<code>ap_hook_auth_checker</code></li>
</ul>
<p>When possible, registering all access control hooks (including
authentication and authorization hooks) using <code>AP_AUTH_INTERNAL_PER_CONF</code>
is recommended. If all modules' access control hooks are registered
with this flag, then whenever the server handles an internal
sub-request that matches the same set of access control configuration
directives as the initial request (which is the common case), it can
avoid invoking the access control hooks another time.</p>
<p>If your module requires the old behavior and must perform access
control checks on every sub-request with a different URI from the
initial request, even if that URI matches the same set of access
control configuration directives, then use
<code>AP_AUTH_INTERNAL_PER_URI</code>.</p>
<h3><a name="mod_auth" id="mod_auth">mod_auth (NEW!)</a></h3>
<p>Introduces the new provider framework for authn and authz</p>
<h3><a name="mod_cache" id="mod_cache">mod_cache (changed)</a></h3>
<p>Introduces a <code>commit_entity()</code> function to the cache provider
interface, allowing atomic writes to cache. Add a <code>cache_status()</code>
hook to report the cache decision. All private structures and functions were
removed.</p>
<h3><a name="mod_core" id="mod_core">mod_core (NEW!)</a></h3>
<p>This introduces low-level APIs to send arbitrary headers,
and exposes functions to handle HTTP OPTIONS and TRACE.</p>
<h3><a name="mod_cache_disk" id="mod_cache_disk">mod_cache_disk (changed)</a></h3>
<p>Changes the disk format of the disk cache to support atomic cache
updates without locking. The device/inode pair of the body file is
embedded in the header file, allowing confirmation that the header
and body belong to one another.</p>
<h3><a name="mod_disk_cache" id="mod_disk_cache">mod_disk_cache (renamed)</a></h3>
<p>The mod_disk_cache module has been renamed to mod_cache_disk in
order to be consistent with the naming of other modules within the
server.</p>
<h3><a name="mod_request" id="mod_request">mod_request (NEW!)</a></h3>
<p>The API for <code class="module"><a href="../mod/mod_request.html">mod_request</a></code>, to make input data
available to multiple application/handler modules where required,
and to parse HTML form data.</p>
<h3><a name="mpm_common" id="mpm_common">mpm_common (changed)</a></h3>
<ul>
<li>REMOVES: <code>accept</code>, <code>lockfile</code>, <code>lock_mech</code>,
<code>set_scoreboard</code> (locking uses the new ap_mutex API)</li>
<li>NEW API to drop privileges (delegates this platform-dependent
function to modules)</li>
<li>NEW Hooks: <code>mpm_query</code>, <code>timed_callback</code>, and
<code>get_name</code></li>
<li>CHANGED interfaces: <code>monitor</code> hook,
<code>ap_reclaim_child_processes</code>,
<code>ap_relieve_child_processes</code></li>
</ul>
<h3><a name="scoreboard" id="scoreboard">scoreboard (changed)</a></h3>
<p><code>ap_get_scoreboard_worker</code> is made non-backwards-compatible
as an alternative version is introduced. Additional proxy_balancer
support. Child status stuff revamped.</p>
<h3><a name="util_cookies" id="util_cookies">util_cookies (NEW!)</a></h3>
<p>Introduces a new API for managing HTTP Cookies.</p>
<h3><a name="util_ldap" id="util_ldap">util_ldap (changed)</a></h3>
<p><em>no description available</em></p>
<h3><a name="util_mutex" id="util_mutex">util_mutex (NEW!)</a></h3>
<p>A wrapper for APR proc and global mutexes in httpd, providing
common configuration for the underlying mechanism and location
of lock files.</p>
<h3><a name="util_script" id="util_script">util_script (changed)</a></h3>
<p>NEW: <code>ap_args_to_table</code></p>
<h3><a name="util_time" id="util_time">util_time (changed)</a></h3>
<p>NEW: <code>ap_recent_ctime_ex</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="upgrading" id="upgrading">Specific information on upgrading modules from 2.2</a></h2>
<h3><a name="upgrading_logging" id="upgrading_logging">Logging</a></h3>
<p>In order to take advantage of per-module loglevel configuration, any
source file that calls the <code>ap_log_*</code> functions should declare
which module it belongs to. If the module's module_struct is called
<code>foo_module</code>, the following code can be used to remain
backward compatible with HTTPD 2.0 and 2.2:</p>
<div class="example"><p><code>
#include <http_log.h><br />
<br />
#ifdef APLOG_USE_MODULE<br />
APLOG_USE_MODULE(foo);<br />
#endif
</code></p></div>
<p>Note: This is absolutely required for C++-language modules. It
can be skipped for C-language modules, though that breaks
module-specific log level support for files without it.</p>
<p>The number of parameters of the <code>ap_log_*</code> functions and the
definition of <code>APLOG_MARK</code> has changed. Normally, the change
is completely transparent. However, changes are required if a
module uses <code>APLOG_MARK</code> as a parameter to its own functions
or if a module calls <code>ap_log_*</code> without passing
<code>APLOG_MARK</code>. A module which uses wrappers
around <code>ap_log_*</code> typically uses both of these constructs.</p>
<p>The easiest way to change code which passes <code>APLOG_MARK</code> to
its own functions is to define and use a different macro that expands to
the parameters required by those functions, as <code>APLOG_MARK</code>
should only be used when calling <code>ap_log_*</code>
directly. In this way, the code will remain compatible with HTTPD 2.0
and 2.2.</p>
<p>Code which calls <code>ap_log_*</code> without passing
<code>APLOG_MARK</code> will necessarily differ between 2.4 and earlier
releases, as 2.4 requires a new third argument,
<code>APLOG_MODULE_INDEX</code>.</p>
<div class="example"><p><code>
/* code for httpd 2.0/2.2 */<br />
ap_log_perror(file, line, APLOG_ERR, 0, p, "Failed to allocate dynamic lock structure");<br />
<br />
/* code for httpd 2.4 */<br />
ap_log_perror(file, line, APLOG_MODULE_INDEX, APLOG_ERR, 0, p, "Failed to allocate dynamic lock structure");<br />
<br />
</code></p></div>
<p><code>ap_log_*error</code> are now implemented as macros. This means
that it is no longer possible to use <code>#ifdef</code> inside the
argument list of <code>ap_log_*error</code>, as this would cause
undefined behavior according to C99.</p>
<p>A <code>server_rec</code> pointer must be passed to
<code>ap_log_error()</code> when called after startup. This
was always appropriate, but there are even more limitations with
a <code>NULL</code> <code>server_rec</code> in 2.4 than in
previous releases. Beginning with 2.3.12, the global variable
<code>ap_server_conf</code> can always be used as
the <code>server_rec</code> parameter, as it will be
<code>NULL</code> only when it is valid to pass <code>NULL</code>
to <code>ap_log_error()</code>. <code>ap_server_conf</code>
should be used only when a more appropriate <code>server_rec</code>
is not available.</p>
<p>Consider the following changes to take advantage of the new
<code>APLOG_TRACE1..8</code> log levels:</p>
<ul>
<li>Check current use of <code>APLOG_DEBUG</code> and
consider if one of the <code>APLOG_TRACEn</code> levels is
more appropriate.</li>
<li>If your module currently has a mechanism for configuring
the amount of debug logging which is performed, consider
eliminating that mechanism and relying on the use of
different <code>APLOG_TRACEn</code> levels. If expensive
trace processing needs to be bypassed depending on the
configured log level, use the <code>APLOGtrace<em>n</em></code>
and <code>APLOGrtrace<em>n</em></code> macros to first check
if tracing is enabled.</li>
</ul>
<p>Modules sometimes add process id and/or thread id to their log
messages. These ids are now logged by default, so it may not
be necessary for the module to log them explicitly. (Users may
remove them from the error log format, but they can be
instructed to add it back if necessary for problem diagnosis.)</p>
<h3><a name="upgrading_byfunction" id="upgrading_byfunction">If your module uses these existing APIs...</a></h3>
<dl>
<dt><code>ap_default_type()</code></dt>
<dd>This is no longer available; Content-Type must be configured
explicitly or added by the application.</dd>
<dt><code>ap_get_server_name()</code></dt>
<dd>If the returned server name is used in a URL,
use <code>ap_get_server_name_for_url()</code> instead. This new
function handles the odd case where the server name is an IPv6
literal address.</dd>
<dt><code>ap_get_server_version()</code></dt>
<dd>For logging purposes, where detailed information is
appropriate, use <code>ap_get_server_description()</code>.
When generating output, where the amount of information
should be configurable by ServerTokens, use
<code>ap_get_server_banner()</code>.</dd>
<dt><code>ap_graceful_stop_signalled()</code></dt>
<dd>Replace with a call
to <code>ap_mpm_query(AP_MPMQ_MPM_STATE)</code> and checking for
state <code>AP_MPMQ_STOPPING</code>.</dd>
<dt><code>ap_max_daemons_limit</code>, <code>ap_my_generation</code>,
and <code>ap_threads_per_child</code></dt>
<dd>Use <code>ap_mpm_query()</code> query codes
<code>AP_MPMQ_MAX_DAEMON_USED</code>, <code>AP_MPMQ_GENERATION</code>,
and <code>AP_MPMQ_MAX_THREADS</code>, respectively.</dd>
<dt><code>ap_mpm_query()</code></dt>
<dd>Ensure that it is not used until after the register-hooks
hook has completed. Otherwise, an MPM built as a DSO
would not have had a chance to enable support for this
function.</dd>
<dt><code>ap_requires()</code></dt>
<dd>The core server now provides better infrastructure for handling
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> configuration.
Register an auth provider function for each supported entity using
<code>ap_register_auth_provider()</code>. The function will be
called as necessary during <code class="directive">Require</code>
processing. (Consult bundled modules for detailed examples.)</dd>
<dt><code>ap_server_conf->process->pool</code>
userdata</dt>
<dd>
Optional:
<ul>
<li>If your module uses this to determine which pass of the
startup hooks is being run,
use <code>ap_state_query(AP_SQ_MAIN_STATE)</code>.</li>
<li>If your module uses this to maintain data across the
unloading and reloading of your module, use
<code>ap_retained_data_create()</code> and
<code>ap_retained_data_get()</code>.</li>
</ul>
</dd>
<dt><code>apr_global_mutex_create()</code>,
<code>apr_proc_mutex_create()</code></dt>
<dd>Optional: See <code>ap_mutex_register()</code>,
<code>ap_global_mutex_create()</code>, and
<code>ap_proc_mutex_create()</code>; these allow your
mutexes to be configurable with
the <code class="directive"><a href="../mod/core.html#mutex">Mutex</a></code> directive;
you can also remove any configuration mechanisms in your
module for such mutexes
</dd>
<dt><code>CORE_PRIVATE</code></dt>
<dd>This is now unnecessary and ignored.</dd>
<dt><code>dav_new_error()</code>
and <code>dav_new_error_tag()</code></dt>
<dd>Previously, these assumed that <code>errno</code> contained
information describing the failure. Now,
an <code>apr_status_t</code> parameter must be provided. Pass
0/APR_SUCCESS if there is no such error information, or a valid
<code>apr_status_t</code> value otherwise.</dd>
<dt><code>mpm_default.h</code>, <code>DEFAULT_LOCKFILE</code>,
<code>DEFAULT_THREAD_LIMIT</code>, <code>DEFAULT_PIDLOG</code>,
etc.</dt>
<dd>The header file and most of the default configuration
values set in it are no longer visible to modules. (Most can
still be overridden at build time.) <code>DEFAULT_PIDLOG</code>
and <code>DEFAULT_REL_RUNTIMEDIR</code> are now universally
available via <code>ap_config.h</code>.</dd>
<dt><code>unixd_config</code></dt>
<dd>This has been renamed to ap_unixd_config.</dd>
<dt><code>unixd_setup_child()</code></dt>
<dd>This has been renamed to ap_unixd_setup_child(), but most callers
should call the added ap_run_drop_privileges() hook.</dd>
<dt><code>conn_rec->remote_ip</code> and
<code>conn_rec->remote_addr</code></dt>
<dd>These fields have been renamed in order to distinguish between
the client IP address of the connection and the useragent IP address
of the request (potentially overridden by a load balancer or proxy).
References to either of these fields must be updated with one of the
following options, as appropriate for the module:
<ul>
<li>When you require the IP address of the user agent, which
might be connected directly to the server, or might optionally be
separated from the server by a transparent load balancer or
proxy, use <code>request_rec->useragent_ip</code> and
<code>request_rec->useragent_addr</code>.</li>
<li>When you require the IP address of the client that is
connected directly to the server, which might be the useragent or
might be the load balancer or proxy itself, use
<code>conn_rec->client_ip</code> and
<code>conn_rec->client_addr</code>.</li>
</ul>
</dd>
</dl>
<h3><a name="upgrading_byfeature" id="upgrading_byfeature">If your module interfaces with this feature...</a></h3>
<dl>
<dt>suEXEC</dt>
<dd>Optional: If your module logs an error
when <code>ap_unixd_config.suexec_enabled</code> is 0,
also log the value of the new
field <code>suexec_disabled_reason</code>, which contains an
explanation of why it is not available.</dd>
<dt>Extended status data in the scoreboard</dt>
<dd>In previous releases, <code>ExtendedStatus</code> had to be
set to <code>On</code>, which in turn required that
mod_status was loaded. In 2.4, just
set <code>ap_extended_status</code> to <code>1</code> in a
pre-config hook and the extended status data will be
available.</dd>
</dl>
<h3><a name="upgrading_newfeatures" id="upgrading_newfeatures">Does your module...</a></h3>
<dl>
<dt>Parse query args</dt>
<dd>Consider if <code>ap_args_to_table()</code> would be
helpful.</dd>
<dt>Parse form data...</dt>
<dd>Use <code>ap_parse_form_data()</code>.</dd>
<dt>Check for request header fields <code>Content-Length</code>
and <code>Transfer-Encoding</code> to see if a body was
specified</dt>
<dd>Use <code>ap_request_has_body()</code>.</dd>
<dt>Implement cleanups which clear pointer variables</dt>
<dd>Use <code>ap_pool_cleanup_set_null()</code>.</dd>
<dt>Create run-time files such as shared memory files, pid files,
etc.</dt>
<dd>Use <code>ap_runtime_dir_relative()</code> so that the global
configuration for the location of such files, either by the
<code>DEFAULT_REL_RUNTIMEDIR</code> compile setting or the
<code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</a></code> directive,
will be respected. <em>Apache httpd 2.4.2 and above.</em></dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/new_api_2_4.html" title="English"> en </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/new_api_2_4.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/modules.html.ja.utf8 0000664 0001751 0001751 00000037445 14743132254 022652 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>モジュールの Apache 1.3 から Apache 2.0 への移植 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>モジュールの Apache 1.3 から Apache 2.0 への移植</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/developer/modules.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../ja/developer/modules.html" title="Japanese"> ja </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>この文書は <code>mod_mmap_static</code> モジュールを Apache 2.0 用に移植した時に
学んだ経験をもとに書いた、最初の手引き書です。まだまだ完全じゃないし、
ひょっとすると間違っている部分もあるかもしれませんが、
取っ掛りにはなるでしょう。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#easy">簡単な変更点</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#messy">もっと厄介な変更点…</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="easy" id="easy">簡単な変更点</a></h2>
<h3><a name="cleanup" id="cleanup">クリーンナップ ルーチン</a></h3>
<p>クリーンナップルーチンは <code>apr_status_t</code> 型である必要があります。
そして、apr_status_t 型の値を返さなくてはなりません。
クリーンナップ中のエラーを通知する必要がなければ、返り値は普通、
<code>ARP_SUCCESS</code> です。たとえエラーを通知したとしても、
すべてのコードがその通知をチェックしたり、
エラーに応じた動作をするわけではないことに気をつけてください。</p>
<h3><a name="init" id="init">初期化ルーチン</a></h3>
<p>初期化ルーチンは処理全体から見てしっくりくるような意味を表すように、
名前が変更されました。ですから、<code>mmap_init</code> から <code>mmap_post_config</code>
のようにちょっと変更されました。
渡される引数は大幅に変更され、次のようになりました。</p>
<ul>
<li><code>apr_pool_t *p</code></li>
<li><code>apr_pool_t *plog</code></li>
<li><code>apr_pool_t *ptemp</code></li>
<li><code>server_rec *s</code></li>
</ul>
<h3><a name="datatypes" id="datatypes">データ型</a></h3>
<p>データ型のほとんどは <a href="http://apr.apache.org/">APR</a> に移されました。つまり、
いくつかの名前が前述のように変更されています。
施すべき変更点の簡単な一覧を以下に示します。</p>
<ul>
<li><code>pool</code> becomes <code>apr_pool_t</code></li>
<li><code>table</code> becomes <code>apr_table_t</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="messy" id="messy">もっと厄介な変更点…</a></h2>
<h3><a name="register-hooks" id="register-hooks">フックの登録</a></h3>
<p>新しいアーキテクチャでは作成した関数を呼び出すのに
一連のフックを使用します。このフックは、新しい関数
<code>static void register_hooks(void)</code> を使って登録するよう、
モジュールに書き足さなくてはなりません。
この関数は、なにをすべきか一旦理解してしまえば、
十分にわかりやすいものです。
リクエストの処理のあるステージで呼び出さなくてはならない
関数は登録する必要があります。ハンドラは登録する必要はありません。
関数を登録できるフェーズはたくさんあります。
それぞれのフェーズで、関数を呼び出す相対的な順番は、
かなりの程度制御できます。</p>
<p>以下は、<code>mod_mmap_static</code> に追加したコードです:</p>
<div class="example"><pre>static void register_hooks(void)
{
static const char * const aszPre[]={ "http_core.c",NULL };
ap_hook_post_config(mmap_post_config,NULL,NULL,HOOK_MIDDLE);
ap_hook_translate_name(mmap_static_xlat,aszPre,NULL,HOOK_LAST);
};</pre></div>
<p>ここでは呼びだすべき二つの関数を登録しています。一つは
<code>post_config</code> ステージ用 (ほとんどすべてのモジュール
はこれが必要です) で、もう一つは <code>translate_name</code> フェーズ用です。
それぞれの関数は名前は違うけれども形式は同じであることに注意してください。
それでは、形式はどのようになっているでしょうか?</p>
<div class="example"><p><code>
ap_hook_<var>phase_name</var>(<var>function_name</var>,
<var>predecessors</var>, <var>successors</var>, <var>position</var>);
</code></p></div>
<p>三つの位置が定義されています…</p>
<ul>
<li><code>HOOK_FIRST</code></li>
<li><code>HOOK_MIDDLE</code></li>
<li><code>HOOK_LAST</code></li>
</ul>
<p>位置を定義するには、上記の「位置」を指定し、
修飾子である「先行」と「後行」で手を加えます。
「先行」「後行」は、呼ばれるべき関数のリストです。
「先行」は関数の実行前に呼ばれるもので、
「後行」は実行後に呼ばれるものです。</p>
<p><code>mod_mmap_static</code> の場合、<code>post_config</code>
ステージでは必要ありませんが、
<code>mmap_static_xlat</code> が core モジュールが名前の変換を実行した後に
<strong>呼ばれなければなりません</strong>。
そこで aszPre を使って <code>HOOK_LAST</code> の修飾子を定義しています。</p>
<h3><a name="moddef" id="moddef">モジュールの定義</a></h3>
<p>モジュールの定義を作成する際に注意しなければならない
ステージの数は激減しています。古い定義は次のようになっていました。</p>
<div class="example"><pre>module MODULE_VAR_EXPORT <var>module_name</var>_module =
{
STANDARD_MODULE_STUFF,
/* initializer */
/* dir config creater */
/* dir merger --- default is to override */
/* server config */
/* merge server config */
/* command handlers */
/* handlers */
/* filename translation */
/* check_user_id */
/* check auth */
/* check access */
/* type_checker */
/* fixups */
/* logger */
/* header parser */
/* child_init */
/* child_exit */
/* post read-request */
};</pre></div>
<p>新しい構造体はとってもシンプルです…</p>
<div class="example"><pre>module MODULE_VAR_EXPORT <var>module_name</var>_module =
{
STANDARD20_MODULE_STUFF,
/* create per-directory config structures */
/* merge per-directory config structures */
/* create per-server config structures */
/* merge per-server config structures */
/* command handlers */
/* handlers */
/* register hooks */
};</pre></div>
<p>このうちのいくつかは古いものから新しいものに直接読み替えられるもので、
いくつかはそうではありません。どうすればいいのかを要約してみます。</p>
<p>直接読み替えられるステージ:</p>
<dl>
<dt><code>/* ディレクトリ設定作成関数 */</code></dt>
<dd><code>/* ディレクトリ毎設定構造体作成 */</code></dd>
<dt><code>/* サーバ設定作成関数 */</code></dt>
<dd><code>/* サーバ毎設定構造体作成 */</code></dd>
<dt><code>/* ディレクトリ設定マージ関数 */</code></dt>
<dd><code>/* ディレクトリ毎設定構造体マージ */</code></dd>
<dt><code>/* サーバ設定マージ関数 */</code></dt>
<dd><code>/* サーバ毎設定構造体作成マージ */</code></dd>
<dt><code>/* コマンド・テーブル */</code></dt>
<dd><code>/* コマンド apr_table_t */</code></dd>
<dt><code>/* ハンドラ */</code></dt>
<dd><code>/* ハンドラ */</code></dd>
</dl>
<p>古い関数の残りのものはフックとして登録されるべきです。
現時点で次のようなフック・ステージが定義されています…</p>
<dl>
<dt><code>ap_hook_post_config</code></dt>
<dd>(以前の <code>_init</code> ルーチンが登録されるべき場所です)</dd>
<dt><code>ap_hook_http_method</code></dt>
<dd>(リクエストから HTTP メソッドを取得します (互換用))</dd>
<dt><code>ap_hook_open_logs</code></dt>
<dd>(特定のログのオープン)</dd>
<dt><code>ap_hook_auth_checker</code></dt>
<dd>(リソースが権限を必要とするかどうかの確認)</dd>
<dt><code>ap_hook_access_checker</code></dt>
<dd>(モジュール固有の制約の確認)</dd>
<dt><code>ap_hook_check_user_id</code></dt>
<dd>(ユーザ ID とパスワードの確認)</dd>
<dt><code>ap_hook_default_port</code></dt>
<dd>(サーバのデフォルト・ポートの取得)</dd>
<dt><code>ap_hook_pre_connection</code></dt>
<dd>(処理の直前に必要なことを実行。ただし accept 直後に呼ばれる)</dd>
<dt><code>ap_hook_process_connection</code></dt>
<dd>(プロトコルの処理)</dd>
<dt><code>ap_hook_child_init</code></dt>
<dd>(子プロセル起動直後)</dd>
<dt><code>ap_hook_create_request</code></dt>
<dd>(??)</dd>
<dt><code>ap_hook_fixups</code></dt>
<dd>(応答内容の生成を変更するラスト・チャンス)</dd>
<dt><code>ap_hook_handler</code></dt>
<dd>(応答内容の生成)</dd>
<dt><code>ap_hook_header_parser</code></dt>
<dd>(モジュールにヘッダの照会をさせる。ほとんどのモジュールでは使われません。post_read_request を使います)</dd>
<dt><code>ap_hook_insert_filter</code></dt>
<dd>(フィルタ・チェインにフィルタを挿入)</dd>
<dt><code>ap_hook_log_transaction</code></dt>
<dd>(リクエストについての情報を記録する)</dd>
<dt><code>ap_hook_optional_fn_retrieve</code></dt>
<dd>(オプションとして登録された関数の取得)</dd>
<dt><code>ap_hook_post_read_request</code></dt>
<dd>(リクエストを読みこんだ後、他のフェーズの前に呼ばれる)</dd>
<dt><code>ap_hook_quick_handler</code></dt>
<dd>リクエストの処理が始まる前に呼ばれる。キャッシュモジュールが
使用している</dd>
<dt><code>ap_hook_translate_name</code></dt>
<dd>(URI をファイル名に変換する)</dd>
<dt><code>ap_hook_type_checker</code></dt>
<dd>(文書型の決定と設定。あるいはその片方)</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/developer/modules.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../ja/developer/modules.html" title="Japanese"> ja </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/modules.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/filters.html.en 0000664 0001751 0001751 00000035104 14737241666 021776 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>How filters work in Apache 2.0 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>How filters work in Apache 2.0</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/filters.html" title="English"> en </a></p>
</div>
<div class="warning"><h3>Warning</h3>
<p>This is a cut 'n paste job from an email
(<022501c1c529$f63a9550$7f00000a@KOJ>) and only reformatted for
better readability. It's not up to date but may be a good start for
further research.</p>
</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#types">Filter Types</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#howinserted">How are filters inserted?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#asis">Asis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#conclusion">Explanations</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="types" id="types">Filter Types</a></h2>
<p>There are three basic filter types (each of these is actually broken
down into two categories, but that comes later).</p>
<dl>
<dt><code>CONNECTION</code></dt>
<dd>Filters of this type are valid for the lifetime of this connection.
(<code>AP_FTYPE_CONNECTION</code>, <code>AP_FTYPE_NETWORK</code>)</dd>
<dt><code>PROTOCOL</code></dt>
<dd>Filters of this type are valid for the lifetime of this request from
the point of view of the client, this means that the request is valid
from the time that the request is sent until the time that the response
is received. (<code>AP_FTYPE_PROTOCOL</code>,
<code>AP_FTYPE_TRANSCODE</code>)</dd>
<dt><code>RESOURCE</code></dt>
<dd>Filters of this type are valid for the time that this content is used
to satisfy a request. For simple requests, this is identical to
<code>PROTOCOL</code>, but internal redirects and sub-requests can change
the content without ending the request. (<code>AP_FTYPE_RESOURCE</code>,
<code>AP_FTYPE_CONTENT_SET</code>)</dd>
</dl>
<p>It is important to make the distinction between a protocol and a
resource filter. A resource filter is tied to a specific resource, it
may also be tied to header information, but the main binding is to a
resource. If you are writing a filter and you want to know if it is
resource or protocol, the correct question to ask is: "Can this filter
be removed if the request is redirected to a different resource?" If
the answer is yes, then it is a resource filter. If it is no, then it
is most likely a protocol or connection filter. I won't go into
connection filters, because they seem to be well understood. With this
definition, a few examples might help:</p>
<dl>
<dt>Byterange</dt>
<dd>We have coded it to be inserted for all requests, and it is removed
if not used. Because this filter is active at the beginning of all
requests, it can not be removed if it is redirected, so this is a
protocol filter.</dd>
<dt>http_header</dt>
<dd>This filter actually writes the headers to the network. This is
obviously a required filter (except in the asis case which is special
and will be dealt with below) and so it is a protocol filter.</dd>
<dt>Deflate</dt>
<dd>The administrator configures this filter based on which file has been
requested. If we do an internal redirect from an autoindex page to an
index.html page, the deflate filter may be added or removed based on
config, so this is a resource filter.</dd>
</dl>
<p>The further breakdown of each category into two more filter types is
strictly for ordering. We could remove it, and only allow for one
filter type, but the order would tend to be wrong, and we would need to
hack things to make it work. Currently, the <code>RESOURCE</code> filters
only have one filter type, but that should change.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="howinserted" id="howinserted">How are filters inserted?</a></h2>
<p>This is actually rather simple in theory, but the code is
complex. First of all, it is important that everybody realize that
there are three filter lists for each request, but they are all
concatenated together:</p>
<ul>
<li><code>r->output_filters</code> (corresponds to RESOURCE)</li>
<li><code>r->proto_output_filters</code> (corresponds to PROTOCOL)</li>
<li><code>r->connection->output_filters</code> (corresponds to CONNECTION)</li>
</ul>
<p>The problem previously, was that we used a singly linked list to create the filter stack, and we
started from the "correct" location. This means that if I had a
<code>RESOURCE</code> filter on the stack, and I added a
<code>CONNECTION</code> filter, the <code>CONNECTION</code> filter would
be ignored. This should make sense, because we would insert the connection
filter at the top of the <code>c->output_filters</code> list, but the end
of <code>r->output_filters</code> pointed to the filter that used to be
at the front of <code>c->output_filters</code>. This is obviously wrong.
The new insertion code uses a doubly linked list. This has the advantage
that we never lose a filter that has been inserted. Unfortunately, it comes
with a separate set of headaches.</p>
<p>The problem is that we have two different cases were we use subrequests.
The first is to insert more data into a response. The second is to
replace the existing response with an internal redirect. These are two
different cases and need to be treated as such.</p>
<p>In the first case, we are creating the subrequest from within a handler
or filter. This means that the next filter should be passed to
<code>make_sub_request</code> function, and the last resource filter in the
sub-request will point to the next filter in the main request. This
makes sense, because the sub-request's data needs to flow through the
same set of filters as the main request. A graphical representation
might help:</p>
<div class="example"><pre>Default_handler --> includes_filter --> byterange --> ...</pre></div>
<p>If the includes filter creates a sub request, then we don't want the
data from that sub-request to go through the includes filter, because it
might not be SSI data. So, the subrequest adds the following:</p>
<div class="example"><pre>Default_handler --> includes_filter -/-> byterange --> ...
/
Default_handler --> sub_request_core</pre></div>
<p>What happens if the subrequest is SSI data? Well, that's easy, the
<code>includes_filter</code> is a resource filter, so it will be added to
the sub request in between the <code>Default_handler</code> and the
<code>sub_request_core</code> filter.</p>
<p>The second case for sub-requests is when one sub-request is going to
become the real request. This happens whenever a sub-request is created
outside of a handler or filter, and NULL is passed as the next filter to
the <code>make_sub_request</code> function.</p>
<p>In this case, the resource filters no longer make sense for the new
request, because the resource has changed. So, instead of starting from
scratch, we simply point the front of the resource filters for the
sub-request to the front of the protocol filters for the old request.
This means that we won't lose any of the protocol filters, neither will
we try to send this data through a filter that shouldn't see it.</p>
<p>The problem is that we are using a doubly-linked list for our filter
stacks now. But, you should notice that it is possible for two lists to
intersect in this model. So, you do you handle the previous pointer?
This is a very difficult question to answer, because there is no "right"
answer, either method is equally valid. I looked at why we use the
previous pointer. The only reason for it is to allow for easier
addition of new servers. With that being said, the solution I chose was
to make the previous pointer always stay on the original request.</p>
<p>This causes some more complex logic, but it works for all cases. My
concern in having it move to the sub-request, is that for the more
common case (where a sub-request is used to add data to a response), the
main filter chain would be wrong. That didn't seem like a good idea to
me.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="asis" id="asis">Asis</a></h2>
<p>The final topic. :-) Mod_Asis is a bit of a hack, but the
handler needs to remove all filters except for connection filters, and
send the data. If you are using <code class="module"><a href="../mod/mod_asis.html">mod_asis</a></code>, all other
bets are off.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="conclusion" id="conclusion">Explanations</a></h2>
<p>The absolutely last point is that the reason this code was so hard to
get right, was because we had hacked so much to force it to work. I
wrote most of the hacks originally, so I am very much to blame.
However, now that the code is right, I have started to remove some
hacks. Most people should have seen that the <code>reset_filters</code>
and <code>add_required_filters</code> functions are gone. Those inserted
protocol level filters for error conditions, in fact, both functions did
the same thing, one after the other, it was really strange. Because we
don't lose protocol filters for error cases any more, those hacks went away.
The <code>HTTP_HEADER</code>, <code>Content-length</code>, and
<code>Byterange</code> filters are all added in the
<code>insert_filters</code> phase, because if they were added earlier, we
had some interesting interactions. Now, those could all be moved to be
inserted with the <code>HTTP_IN</code>, <code>CORE</code>, and
<code>CORE_IN</code> filters. That would make the code easier to
follow.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/filters.html" title="English"> en </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/filters.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/modules.html.en 0000664 0001751 0001751 00000034714 14737241666 022004 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Converting Modules from Apache 1.3 to Apache 2.0 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>Converting Modules from Apache 1.3 to Apache 2.0</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/modules.html" title="English"> en </a> |
<a href="../ja/developer/modules.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div>
<p>This is a first attempt at writing the lessons I learned
when trying to convert the <code>mod_mmap_static</code> module to Apache
2.0. It's by no means definitive and probably won't even be
correct in some ways, but it's a start.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#easy">The easier changes ...</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#messy">The messier changes...</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="easy" id="easy">The easier changes ...</a></h2>
<h3><a name="cleanup" id="cleanup">Cleanup Routines</a></h3>
<p>These now need to be of type <code>apr_status_t</code> and return a
value of that type. Normally the return value will be
<code>APR_SUCCESS</code> unless there is some need to signal an error in
the cleanup. Be aware that even though you signal an error not all code
yet checks and acts upon the error.</p>
<h3><a name="init" id="init">Initialisation Routines</a></h3>
<p>These should now be renamed to better signify where they sit
in the overall process. So the name gets a small change from
<code>mmap_init</code> to <code>mmap_post_config</code>. The arguments
passed have undergone a radical change and now look like</p>
<ul>
<li><code>apr_pool_t *p</code></li>
<li><code>apr_pool_t *plog</code></li>
<li><code>apr_pool_t *ptemp</code></li>
<li><code>server_rec *s</code></li>
</ul>
<h3><a name="datatypes" id="datatypes">Data Types</a></h3>
<p>A lot of the data types have been moved into the <a href="http://apr.apache.org/">APR</a>. This means that some have had
a name change, such as the one shown above. The following is a brief
list of some of the changes that you are likely to have to make.</p>
<ul>
<li><code>pool</code> becomes <code>apr_pool_t</code></li>
<li><code>table</code> becomes <code>apr_table_t</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="messy" id="messy">The messier changes...</a></h2>
<h3><a name="register-hooks" id="register-hooks">Register Hooks</a></h3>
<p>The new architecture uses a series of hooks to provide for
calling your functions. These you'll need to add to your module
by way of a new function, <code>static void register_hooks(void)</code>.
The function is really reasonably straightforward once you
understand what needs to be done. Each function that needs
calling at some stage in the processing of a request needs to
be registered, handlers do not. There are a number of phases
where functions can be added, and for each you can specify with
a high degree of control the relative order that the function
will be called in.</p>
<p>This is the code that was added to <code>mod_mmap_static</code>:</p>
<div class="example"><pre>static void register_hooks(void)
{
static const char * const aszPre[]={ "http_core.c",NULL };
ap_hook_post_config(mmap_post_config,NULL,NULL,HOOK_MIDDLE);
ap_hook_translate_name(mmap_static_xlat,aszPre,NULL,HOOK_LAST);
};</pre></div>
<p>This registers 2 functions that need to be called, one in
the <code>post_config</code> stage (virtually every module will need this
one) and one for the <code>translate_name</code> phase. note that while
there are different function names the format of each is
identical. So what is the format?</p>
<div class="example"><p><code>
ap_hook_<var>phase_name</var>(<var>function_name</var>,
<var>predecessors</var>, <var>successors</var>, <var>position</var>);
</code></p></div>
<p>There are 3 hook positions defined...</p>
<ul>
<li><code>HOOK_FIRST</code></li>
<li><code>HOOK_MIDDLE</code></li>
<li><code>HOOK_LAST</code></li>
</ul>
<p>To define the position you use the position and then modify
it with the predecessors and successors. Each of the modifiers
can be a list of functions that should be called, either before
the function is run (predecessors) or after the function has
run (successors).</p>
<p>In the <code>mod_mmap_static</code> case I didn't care about the
<code>post_config</code> stage, but the <code>mmap_static_xlat</code>
<strong>must</strong> be called after the core module had done its name
translation, hence the use of the aszPre to define a modifier to the
position <code>HOOK_LAST</code>.</p>
<h3><a name="moddef" id="moddef">Module Definition</a></h3>
<p>There are now a lot fewer stages to worry about when
creating your module definition. The old definition looked
like</p>
<div class="example"><pre>module MODULE_VAR_EXPORT <var>module_name</var>_module =
{
STANDARD_MODULE_STUFF,
/* initializer */
/* dir config creater */
/* dir merger --- default is to override */
/* server config */
/* merge server config */
/* command handlers */
/* handlers */
/* filename translation */
/* check_user_id */
/* check auth */
/* check access */
/* type_checker */
/* fixups */
/* logger */
/* header parser */
/* child_init */
/* child_exit */
/* post read-request */
};</pre></div>
<p>The new structure is a great deal simpler...</p>
<div class="example"><pre>module MODULE_VAR_EXPORT <var>module_name</var>_module =
{
STANDARD20_MODULE_STUFF,
/* create per-directory config structures */
/* merge per-directory config structures */
/* create per-server config structures */
/* merge per-server config structures */
/* command handlers */
/* handlers */
/* register hooks */
};</pre></div>
<p>Some of these read directly across, some don't. I'll try to
summarise what should be done below.</p>
<p>The stages that read directly across :</p>
<dl>
<dt><code>/* dir config creater */</code></dt>
<dd><code>/* create per-directory config structures */</code></dd>
<dt><code>/* server config */</code></dt>
<dd><code>/* create per-server config structures */</code></dd>
<dt><code>/* dir merger */</code></dt>
<dd><code>/* merge per-directory config structures */</code></dd>
<dt><code>/* merge server config */</code></dt>
<dd><code>/* merge per-server config structures */</code></dd>
<dt><code>/* command table */</code></dt>
<dd><code>/* command apr_table_t */</code></dd>
<dt><code>/* handlers */</code></dt>
<dd><code>/* handlers */</code></dd>
</dl>
<p>The remainder of the old functions should be registered as
hooks. There are the following hook stages defined so
far...</p>
<dl>
<dt><code>ap_hook_pre_config</code></dt>
<dd>do any setup required prior to processing configuration
directives</dd>
<dt><code>ap_hook_check_config</code></dt>
<dd>review configuration directive interdependencies</dd>
<dt><code>ap_hook_test_config</code></dt>
<dd>executes only with <code>-t</code> option</dd>
<dt><code>ap_hook_open_logs</code></dt>
<dd>open any specified logs</dd>
<dt><code>ap_hook_post_config</code></dt>
<dd>this is where the old <code>_init</code> routines get
registered</dd>
<dt><code>ap_hook_http_method</code></dt>
<dd>retrieve the http method from a request. (legacy)</dd>
<dt><code>ap_hook_auth_checker</code></dt>
<dd>check if the resource requires authorization</dd>
<dt><code>ap_hook_access_checker</code></dt>
<dd>check for module-specific restrictions</dd>
<dt><code>ap_hook_check_user_id</code></dt>
<dd>check the user-id and password</dd>
<dt><code>ap_hook_default_port</code></dt>
<dd>retrieve the default port for the server</dd>
<dt><code>ap_hook_pre_connection</code></dt>
<dd>do any setup required just before processing, but after
accepting</dd>
<dt><code>ap_hook_process_connection</code></dt>
<dd>run the correct protocol</dd>
<dt><code>ap_hook_child_init</code></dt>
<dd>call as soon as the child is started</dd>
<dt><code>ap_hook_create_request</code></dt>
<dd>??</dd>
<dt><code>ap_hook_fixups</code></dt>
<dd>last chance to modify things before generating content</dd>
<dt><code>ap_hook_handler</code></dt>
<dd>generate the content</dd>
<dt><code>ap_hook_header_parser</code></dt>
<dd>lets modules look at the headers, not used by most modules, because
they use <code>post_read_request</code> for this</dd>
<dt><code>ap_hook_insert_filter</code></dt>
<dd>to insert filters into the filter chain</dd>
<dt><code>ap_hook_log_transaction</code></dt>
<dd>log information about the request</dd>
<dt><code>ap_hook_optional_fn_retrieve</code></dt>
<dd>retrieve any functions registered as optional</dd>
<dt><code>ap_hook_post_read_request</code></dt>
<dd>called after reading the request, before any other phase</dd>
<dt><code>ap_hook_quick_handler</code></dt>
<dd>called before any request processing, used by cache modules.</dd>
<dt><code>ap_hook_translate_name</code></dt>
<dd>translate the URI into a filename</dd>
<dt><code>ap_hook_type_checker</code></dt>
<dd>determine and/or set the doc type</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/modules.html" title="English"> en </a> |
<a href="../ja/developer/modules.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/modules.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/thread_safety.html.en 0000664 0001751 0001751 00000043201 14737241666 023145 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Server 2.x Thread Safety Issues - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Developer Documentation</a></div><div id="page-content"><div id="preamble"><h1>Apache HTTP Server 2.x Thread Safety Issues</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/developer/thread_safety.html" title="English"> en </a></p>
</div>
<p>When using any of the threaded mpms in the Apache HTTP Server 2.x it is important
that every function called from Apache be thread safe. When linking in 3rd
party extensions it can be difficult to determine whether the resulting
server will be thread safe. Casual testing generally won't tell you this
either as thread safety problems can lead to subtle race conditions that
may only show up in certain conditions under heavy load.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#variables">Global and static variables</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#errno">errno</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#functions">Common standard troublesome functions</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#commonlibs">Common 3rd Party Libraries</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#liblist">Library List</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="variables" id="variables">Global and static variables</a></h2>
<p>When writing your module or when trying to determine if a module or
3rd party library is thread safe there are some common things to keep in
mind.</p>
<p>First, you need to recognize that in a threaded model each individual
thread has its own program counter, stack and registers. Local variables
live on the stack, so those are fine. You need to watch out for any
static or global variables. This doesn't mean that you are absolutely not
allowed to use static or global variables. There are times when you
actually want something to affect all threads, but generally you need to
avoid using them if you want your code to be thread safe.</p>
<p>In the case where you have a global variable that needs to be global and
accessed by all threads, be very careful when you update it. If, for
example, it is an incrementing counter, you need to atomically increment
it to avoid race conditions with other threads. You do this using a mutex
(mutual exclusion). Lock the mutex, read the current value, increment it
and write it back and then unlock the mutex. Any other thread that wants
to modify the value has to first check the mutex and block until it is
cleared.</p>
<p>If you are using <a href="http://apr.apache.org/">APR</a>, have a look
at the <code>apr_atomic_<var>*</var></code> functions and the
<code>apr_thread_mutex_<var>*</var></code> functions.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="errno" id="errno">errno</a></h2>
<p>This is a common global variable that holds the error number of the
last error that occurred. If one thread calls a low-level function that
sets errno and then another thread checks it, we are bleeding error
numbers from one thread into another. To solve this, make sure your
module or library defines <code>_REENTRANT</code> or is compiled with
<code>-D_REENTRANT</code>. This will make errno a per-thread variable
and should hopefully be transparent to the code. It does this by doing
something like this:</p>
<div class="example"><p><code>
#define errno (*(__errno_location()))
</code></p></div>
<p>which means that accessing errno will call
<code>__errno_location()</code> which is provided by the libc. Setting
<code>_REENTRANT</code> also forces redefinition of some other functions
to their <code><var>*</var>_r</code> equivalents and sometimes changes
the common <code>getc</code>/<code>putc</code> macros into safer function
calls. Check your libc documentation for specifics. Instead of, or in
addition to <code>_REENTRANT</code> the symbols that may affect this are
<code>_POSIX_C_SOURCE</code>, <code>_THREAD_SAFE</code>,
<code>_SVID_SOURCE</code>, and <code>_BSD_SOURCE</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="functions" id="functions">Common standard troublesome functions</a></h2>
<p>Not only do things have to be thread safe, but they also have to be
reentrant. <code>strtok()</code> is an obvious one. You call it the first
time with your delimiter which it then remembers and on each subsequent
call it returns the next token. Obviously if multiple threads are
calling it you will have a problem. Most systems have a reentrant version
of the function called <code>strtok_r()</code> where you pass in an
extra argument which contains an allocated <code>char *</code> which the
function will use instead of its own static storage for maintaining
the tokenizing state. If you are using <a href="http://apr.apache.org/">APR</a> you can use <code>apr_strtok()</code>.</p>
<p><code>crypt()</code> is another function that tends to not be reentrant,
so if you run across calls to that function in a library, watch out. On
some systems it is reentrant though, so it is not always a problem. If
your system has <code>crypt_r()</code> chances are you should be using
that, or if possible simply avoid the whole mess by using md5 instead.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="commonlibs" id="commonlibs">Common 3rd Party Libraries</a></h2>
<p>The following is a list of common libraries that are used by 3rd party
Apache modules. You can check to see if your module is using a potentially
unsafe library by using tools such as <code>ldd(1)</code> and
<code>nm(1)</code>. For <a href="http://www.php.net/">PHP</a>, for example,
try this:</p>
<div class="example"><p><code>
% ldd libphp4.so<br />
libsablot.so.0 => /usr/local/lib/libsablot.so.0 (0x401f6000)<br />
libexpat.so.0 => /usr/lib/libexpat.so.0 (0x402da000)<br />
libsnmp.so.0 => /usr/lib/libsnmp.so.0 (0x402f9000)<br />
libpdf.so.1 => /usr/local/lib/libpdf.so.1 (0x40353000)<br />
libz.so.1 => /usr/lib/libz.so.1 (0x403e2000)<br />
libpng.so.2 => /usr/lib/libpng.so.2 (0x403f0000)<br />
libmysqlclient.so.11 => /usr/lib/libmysqlclient.so.11 (0x40411000)<br />
libming.so => /usr/lib/libming.so (0x40449000)<br />
libm.so.6 => /lib/libm.so.6 (0x40487000)<br />
libfreetype.so.6 => /usr/lib/libfreetype.so.6 (0x404a8000)<br />
libjpeg.so.62 => /usr/lib/libjpeg.so.62 (0x404e7000)<br />
libcrypt.so.1 => /lib/libcrypt.so.1 (0x40505000)<br />
libssl.so.2 => /lib/libssl.so.2 (0x40532000)<br />
libcrypto.so.2 => /lib/libcrypto.so.2 (0x40560000)<br />
libresolv.so.2 => /lib/libresolv.so.2 (0x40624000)<br />
libdl.so.2 => /lib/libdl.so.2 (0x40634000)<br />
libnsl.so.1 => /lib/libnsl.so.1 (0x40637000)<br />
libc.so.6 => /lib/libc.so.6 (0x4064b000)<br />
/lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x80000000)
</code></p></div>
<p>In addition to these libraries you will need to have a look at any
libraries linked statically into the module. You can use <code>nm(1)</code>
to look for individual symbols in the module.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="liblist" id="liblist">Library List</a></h2>
<p>Please drop a note to <a href="http://httpd.apache.org/lists.html#http-dev">dev@httpd.apache.org</a>
if you have additions or corrections to this list.</p>
<table class="bordered"><tr class="header"><th>Library</th><th>Version</th><th>Thread Safe?</th><th>Notes</th></tr>
<tr><td><a href="http://aspell.sourceforge.net/">ASpell/PSpell</a></td>
<td> </td>
<td>?</td>
<td> </td></tr>
<tr class="odd"><td><a href="http://www.sleepycat.com/">Berkeley DB</a></td>
<td>3.x, 4.x</td>
<td>Yes</td>
<td>Be careful about sharing a connection across threads.</td></tr>
<tr><td><a href="http://sources.redhat.com/bzip2/index.html">bzip2</a></td>
<td> </td>
<td>Yes</td>
<td>Both low-level and high-level APIs are thread-safe. However,
high-level API requires thread-safe access to errno.</td></tr>
<tr class="odd"><td><a href="http://cr.yp.to/cdb.html">cdb</a></td>
<td> </td>
<td>?</td>
<td> </td></tr>
<tr><td><a href="http://www.washington.edu/imap/">C-Client</a></td>
<td> </td>
<td>Perhaps</td>
<td>c-client uses <code>strtok()</code> and
<code>gethostbyname()</code> which are not thread-safe on most C
library implementations. c-client's static data is meant to be shared
across threads. If <code>strtok()</code> and
<code>gethostbyname()</code> are thread-safe on your OS, c-client
<em>may</em> be thread-safe.</td></tr>
<tr class="odd"><td><a href="http://www.ijg.org/files/">libcrypt</a></td>
<td> </td>
<td>?</td>
<td> </td></tr>
<tr><td><a href="http://expat.sourceforge.net/">Expat</a></td>
<td> </td>
<td>Yes</td>
<td>Need a separate parser instance per thread</td></tr>
<tr class="odd"><td><a href="http://www.freetds.org/">FreeTDS</a></td>
<td> </td>
<td>?</td>
<td> </td></tr>
<tr><td><a href="http://www.freetype.org/">FreeType</a></td>
<td> </td>
<td>?</td>
<td> </td></tr>
<tr class="odd"><td><a href="http://www.boutell.com/gd/">GD 1.8.x</a></td>
<td> </td>
<td>?</td>
<td> </td></tr>
<tr><td><a href="http://www.boutell.com/gd/">GD 2.0.x</a></td>
<td> </td>
<td>?</td>
<td> </td></tr>
<tr class="odd"><td><a href="http://www.gnu.org/software/gdbm/gdbm.html">gdbm</a></td>
<td> </td>
<td>No</td>
<td>Errors returned via a static <code>gdbm_error</code>
variable</td></tr>
<tr><td><a href="http://www.imagemagick.org/">ImageMagick</a></td>
<td>5.2.2</td>
<td>Yes</td>
<td>ImageMagick docs claim it is thread safe since version 5.2.2 (see <a href="http://www.imagemagick.com/www/changelog.html">Change log</a>).
</td></tr>
<tr class="odd"><td><a href="http://www.enlightenment.org/p.php?p=about/efl&l=en">Imlib2</a></td>
<td> </td>
<td>?</td>
<td> </td></tr>
<tr><td><a href="http://www.ijg.org/files/">libjpeg</a></td>
<td>v6b</td>
<td>?</td>
<td> </td></tr>
<tr class="odd"><td><a href="http://mysql.com">libmysqlclient</a></td>
<td> </td>
<td>Yes</td>
<td>Use mysqlclient_r library variant to ensure thread-safety. For
more information, please read <a href="http://dev.mysql.com/doc/mysql/en/Threaded_clients.html">http://dev.mysql.com/doc/mysql/en/Threaded_clients.html</a>.</td></tr>
<tr><td><a href="http://www.opaque.net/ming/">Ming</a></td>
<td>0.2a</td>
<td>?</td>
<td> </td></tr>
<tr class="odd"><td><a href="http://net-snmp.sourceforge.net/">Net-SNMP</a></td>
<td>5.0.x</td>
<td>?</td>
<td> </td></tr>
<tr><td><a href="http://www.openldap.org/">OpenLDAP</a></td>
<td>2.1.x</td>
<td>Yes</td>
<td>Use <code>ldap_r</code> library variant to ensure
thread-safety.</td></tr>
<tr class="odd"><td><a href="http://www.openssl.org/">OpenSSL</a></td>
<td>0.9.6g</td>
<td>Yes</td>
<td>Requires proper usage of <code>CRYPTO_num_locks</code>,
<code>CRYPTO_set_locking_callback</code>,
<code>CRYPTO_set_id_callback</code></td></tr>
<tr><td><a href="http://www.oracle.com/">liboci8 (Oracle 8+)</a></td>
<td>8.x,9.x</td>
<td>?</td>
<td> </td></tr>
<tr class="odd"><td><a href="http://pdflib.com/">pdflib</a></td>
<td>5.0.x</td>
<td>Yes</td>
<td>PDFLib docs claim it is thread safe; changes.txt indicates it
has been partially thread-safe since V1.91: <a href="http://www.pdflib.com/products/pdflib-family/pdflib/">http://www.pdflib.com/products/pdflib-family/pdflib/</a>.</td></tr>
<tr><td><a href="http://www.libpng.org/pub/png/libpng.html">libpng</a></td>
<td>1.0.x</td>
<td>?</td>
<td> </td></tr>
<tr class="odd"><td><a href="http://www.libpng.org/pub/png/libpng.html">libpng</a></td>
<td>1.2.x</td>
<td>?</td>
<td> </td></tr>
<tr><td><a href="http://www.postgresql.org/docs/8.4/static/libpq-threading.html">libpq (PostgreSQL)</a></td>
<td>8.x</td>
<td>Yes</td>
<td>Don't share connections across threads and watch out for
<code>crypt()</code> calls</td></tr>
<tr class="odd"><td><a href="http://www.gingerall.com/charlie/ga/xml/p_sab.xml">Sablotron</a></td>
<td>0.95</td>
<td>?</td>
<td /></tr>
<tr><td><a href="http://www.gzip.org/zlib/">zlib</a></td>
<td>1.1.4</td>
<td>Yes</td>
<td>Relies upon thread-safe zalloc and zfree functions Default is to
use libc's calloc/free which are thread-safe.</td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/developer/thread_safety.html" title="English"> en </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/developer/thread_safety.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/developer/debugging.html 0000664 0001751 0001751 00000000170 13710016232 021626 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: debugging.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/developer/index.html 0000664 0001751 0001751 00000000317 13710016232 021005 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: index.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: index.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/developer/output-filters.html 0000664 0001751 0001751 00000000175 13710016232 022706 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: output-filters.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/developer/filters.html 0000664 0001751 0001751 00000000166 13710016232 021350 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: filters.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/caching.html.tr.utf8 0000664 0001751 0001751 00000155302 14743132254 020635 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Önbellek Kullanım Kılavuzu - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Önbellek Kullanım Kılavuzu</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/caching.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/caching.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./tr/caching.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belge <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>,
<code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>, <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code>
modülleri ve <a href="programs/htcacheclean.html">htcacheclean</a>
için bir başvuru kılavuzu niteliğindedir. HTTP sunucusu ve vekil
olarak çalışmada işlemleri hızlandırmak için bilinen sorunlar ve
yanlış yapılandırmalardan kaçınarak Apache HTTPD sunucusunun önbellekleme
özelliklerinin nasıl kullanılacağı açıklanmıştır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Giriş</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#http-caching">Üç durumlu RFC2616 HTTP önbelleklemesi</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Önbellek Ayarlama Örnekleri</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#socache-caching">Genel İki durumlu Anahtar/Değer Paylaşımlı Nesne Önbellekleme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#file-caching">Uzmanlaşmış Dosya Önbellekleme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#security">Güvenlik Kaygıları</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="introduction" id="introduction">Giriş</a></h2>
<p>Apache HTTP sunucusu, sunucunun başarımını çeşitli yollarla arttırmak
üzere tasarlanmış bir dizi önbellekleme özelliğine sahiptir.</p>
<dl>
<dt>Üç durumlu RFC2616 HTTP önbelleklemesi</dt>
<dd>
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> ve destek modülü
<code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> akılcı ve HTTP'ye uygun
önbellekleme sağlar. İçeriğin kendisi önbellekte saklanır ve
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>, <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">RFC2616'nın 13. bölümü</a>nde açıklandığı gibi, içeriğin
önbelleklenebilirliğini denetleyen çeşitli HTTP başlıklarının ve
seçeneklerinin tümünü onurlandırmayı hedefler.
Devingen yerel içerik veya vekalet edilen içerik ile ilgilendiğiniz
durumda veya muhtemel bir yavaş disk üzerinde yerel dosyalara
erişimi hızlandırmak ihtiyacında olduğunuz durumda
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> hem basit hem de karmaşık önbellekleme
yapılandırmalarını hedefler.
</dd>
<dt>İki durumlu anahtar/değer paylaşımlı nesne önbellekleme</dt>
<dd>
<a href="socache.html">Paylaşımlı nesne önbellek API'si</a>
(socache) ve destek modülleri sunucu taraflı bir anahtar/değer
paylaşımlı nesne önbelleklemesi sağlar. Bu modüller SSL oturumları
ve kimlik doğrulama bilgileri gibi düşük seviyeli verileri
önbelleklemek için tasarlanmıştır. Destek modülleri verinin sunucu
tarafı bir paylaşımlı bellekte veya veri merkezi tarafı memcache
veya distcache gibi bir önbellekte saklanmasını mümkün kılar.
</dd>
<dt>Uzmanlaşmış dosya önbellekleme</dt>
<dd>
<code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> dosyaların sunucunun başlatılması
sırasında belleğe yüklenmesi ile ilgilenir. Böylece dosyalara
erişim zamanını kısaltabilir, sıkça erişilen dosyaların dosya
tanıtıcılarını kaydedebilir, her istekte diske gitme ihtiyacını
ortadan kaldırır.
</dd>
</dl>
<p>Bu belgeden azami yararı sağlayabilmek için temel bir HTTP bilginizin
olması ve <a href="urlmapping.html">URL’lerin Dosya Sistemine
Eşlenmesi</a> ile <a href="content-negotiation.html">İçerik Uzlaşımı</a>
belgelerini okumuş olmanız gerekir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="http-caching" id="http-caching">Üç durumlu RFC2616 HTTP önbelleklemesi</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code></li><li><code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code></li><li><code class="directive"><a href="./mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code></li></ul></td></tr></table>
<p>HTTP protokolü
<a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">RFC2616'nın 13. bölümü</a>nde açıklanan satıriçi önbellekleme
mekanizması için yerleşik bir destek içerir ve bunun getirilerinden
yararlanmak için <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> modülü kullanılabilir.</p>
<p>İçeriğin taze olmadığı durumda içeriğin kaybolmasına sebep olan basit
iki durumlu anahtar/değer önbelleklemesinin tersine, HTTP önbelleği
eskimiş içeriği tutan ve bu eski içeriğin değişip değişmediğini özgün
sunucuya soran ve duruma göre onu tekrar taze duruma getiren bir
mekanizma içerir.</p>
<p>HTTP önbelleğinde bulunan bir girdi şu üç durumdan birinde olabilir:</p>
<dl>
<dt>Taze</dt>
<dd>
İçerik yeteri kadar yeni (<strong>tazelik ömrü</strong>nden daha genç)
ise <strong>taze</strong> sayılır. Bir HTTP önbelleği böyle bir içeriği
özgün sunucuya birşey sormadan sunabilir.
</dd>
<dt>Bayat</dt>
<dd>
<p>İçerik çok eski (<strong>tazelik ömrü</strong>nden daha yaşlı)
ise <strong>bayat</strong> sayılır. Bir HTTP önbelleği böyle bir
içeriği istemciye sunmadan önce özgün sunucuya bağlanıp bayat içeriğin
hala yeterince taze olup olmadığına bakmalıdır. Özgün sunucu, içerik
geçersizse yenisini gönderecektir, aksi takdirde, (ideal olanı budur)
içeriğin hala geçerli olduğunu belirten bir kod ile yanıt verecektir.
İçerik tekrar taze hale gelince süreç kaldığı yerden devam eder.</p>
<p>HTTP protokolü belli koşullar altında önbelleğin bayat içeriği
sunmasına izin vermez. Örneğin, bir içeriği özgün sunucuda tazeleme
çabasının bir 5xx hatasıyla başarısız olması veya başka bir tazeleme
isteğinin henüz sonuçlanmamış olması bu çeşit koşullardandır. Bu
durumlarda yanıta bir <code>Warning</code> başlığı eklenir.</p>
</dd>
<dt>Yok</dt>
<dd>
Önbellekte yer kalmazsa yer açmak için içeriğin silinmesi seçenek
dahilindedir. İçerik taze olsun olmasın her zaman silinebilir. Önlem
olarak <code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code> elle veya bir artalan süreci
olarak çalıştırılabilir. Böylece önbelleğin boyutunun belirtilen
boyutta veya belirtilen dosya düğümü sayısında kalması sağlanabilir.
Araç içeriği silerken bayat içeriğe öncelik verir.
</dd>
</dl>
<p>HTTP önbelleklemesinin çalışması ile ilgili bütün ayrıntılar
<a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">RFC2616'nın 13. bölümünde</a> bulunabilir.</p>
<h3>Sunucu ile etkileşim</h3>
<p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> modülü
<code class="directive"><a href="./mod/mod_cache.html#cachequickhandler">CacheQuickHandler</a></code> yönergesinin
değerine bağlı olarak iki olası yerde sunucuya bağlanır:
</p>
<dl>
<dt>Çabuk eylem aşaması</dt>
<dd>
<p>Bu aşama çok erken gerçekleşen bir aşama olup isteğin işlenmesi
sırasında isteğin çözümlenmesinin hemen sonrasıdır. İçerik
önbellekte mevcutsa hemen sunulur ve geri kalan istek işleme işlemi
iptal edilir.</p>
<p>Bu senaryoda önbellek sunucunun önüne vidalanmış gibi
davranır.</p>
<p>Sunucuda gerçekleşecek bir dizi işlemin büyük çoğunluğunun
yapılmadan geçilmesi nedeniyle bu en yüksek başarımlı kiptir.
Bu kip ayrıca, sunucu işlemlerinin kimlik doğrulama ve yetkilendirme
aşamalarının da yapılmadan geçilmesini sağlar. Bu bakımdan bu kip
seçilirken bu durum dikkate alınmalıdır.</p>
<p>"Authorization" başlığı içeren istekler (örneğin, HTTP Temel
Kimlik Kanıtlaması gibi) <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> bu kipte
çalışırken önbelleğe alınmadıkları gibi önbellekten bir işleme de
sokulmazlar.</p>
</dd>
<dt>Normal eylem aşaması</dt>
<dd>
<p>Bu aşama geç bir aşama olup, isteğin tamamen işlenmesinin
sonrasıdır.</p>
<p>Bu senaryoda önbellek sunucunun arkasına vidalanmış gibi
davranır.</p>
<p>Bu kip en esneğidir. Önbelleğin, süzme zincirinin hassas olarak
denetlenen bir noktasında oluşması sağlanabilir ve önbelleklenen
içerik istemciye gönderilmeden önce süzülüp
kişiselleştirilebilir.</p>
</dd>
</dl>
<p>URL önbellekte yoksa <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> modülü yanıtı
önbelleğe kaydetme aşamasında süzgeç yığıtına bir
<a href="filter.html">süzgeç</a> ekler ve geri çekilerek normal istek
işlemlerinin devam etmesine izin verir. İçeriğin önbelleklenebilir
olduğu saptanırsa içerik gelecekte sunulmak üzere önbelleğe
kaydedilir, aksi takdirde içerik yok sayılır.</p>
<p>Önbellekteki içerik bayatsa, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> modülü
isteği bir <strong>koşullu istek</strong> haline getirir. Özgün
sunucu normal bir yanıt verirse bu yanıt mevcut içeriğin yerine
önbelleklenir. Özgün sunucu bir <code>304 Not Modified</code> yanıtı
verirse içerik tekrar taze olarak imlenir ve önbellekteki içerik
süzgeç tarafından kaydedilmeden sunulur.</p>
<h3>Önbelleğin Hızlandırılması</h3>
<p>Bir sanal konak birçok farklı sunucu takma adından biri olarak
bilindiği takdirde <code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> yönergesine <code>On</code>
değeri atanmışsa önbellekten sunulan sayfa sayısında büyük bir artış
olduğu görülür. Bunun sebebi içeriği sunan sanal konağın isminin
önbellek anahtarının içinde kullanılmasıdır. Yönergeye
<code>On</code> değerini atamak suretiyle çok isimli ve rumuzlu sanal
konaklar için farklı önbellek girdileri oluşturulmaz, bunun yerine her
meşru sanal konak için ayrı bir önbellek tutulur.</p>
<h3>Tazelik Ömrü</h3>
<p>Önbelleklenmek üzere tasarlanmış iyi biçimli bir içerik tazelik ömrünü
<code>Cache-Control</code> başlığının <code>max-age</code> veya
<code>s-maxage</code> alanlarıyla ya da bir <code>Expires</code>
başlığını içererek bildirmelidir.</p>
<p>Aynı zamanda, özgün sunucunun tanımladığı tazelik ömrü, bir istemci
tarafından istekte bir <code>Cache-Control</code> başlığı kullanılarak
geçersiz kılınmak istenebilir. Bu durumda hangi tazelik ömrü daha
kısaysa o geçerli olur.</p>
<p>Tazelik ömrü istekte veya yanıtta mevcut değilse öntanımlı bir tazelik
ömrü kullanılır. Öntanımlı tazelik ömrü önbellekli içerik için bir saat
olmakla birlikte <code class="directive"><a href="./mod/mod_cache.html#cachedefaultexpire">CacheDefaultExpire</a></code> yönergesi
kullanılarak kolayca değiştirilebilir.</p>
<p>Bir yanıt <code>Expires</code> başlığını değil de
<code>Last-Modified</code> başlığını içeriyorsa
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> tazelik ömrünü <code class="directive"><a href="./mod/mod_cache.html#cachelastmodifiedfactor">CacheLastModifiedFactor</a></code> yönergesine
bakarak saptar.</p>
<p>Yerel içerik için, ya da kendi <code>Expires</code> başlığını
tanımlamayan uzak içerik için tazelik ömrünü <code>max-age</code> ve
<code>Expires</code> ekleyerek hassas olarak ayarlamak
için <code class="module"><a href="./mod/mod_expires.html">mod_expires</a></code> kullanılabilir.</p>
<p>Tazelik ömrünün üst sınırı <code class="directive"><a href="./mod/mod_cache.html#cachemaxexpire">CacheMaxExpire</a></code> yönergesi ile
belirlenebilir.</p>
<h3>Şartlı İstekler için Özlü Kılavuz</h3>
<p>Önbellekteki içeriğin zaman aşımına uğrayıp bayat hale gelmesi,
httpd’nin özgün isteği aktarmak yerine isteği değişikliğe uğratarak
şartlı bir istek yapması sonucunu doğurur.</p>
<p>Özgün önbellekli yanıtta bir <code>ETag</code> başlığı mevcutsa,
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> modülü özgün sunucuya yapılan isteğe
bir <code>If-None-Match</code> başlığı ekler.
Özgün önbellekli yanıtta bir <code>Last-Modified</code> başlığı
mevcutsa, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> modülü özgün sunucuya yapılan
isteğe bir <code>If-Modified-Since</code> başlığı ekler. Bunlardan
birinin varlığı isteği <strong>koşullu</strong> yapar.</p>
<p>Bir koşullu istek özgün sunucu tarafından alındığında, özgün sunucu
<code>ETag</code> veya <code>Last-Modified</code> başlığının isteğe
uygun olarak değişip değişmediğine bakmalıdır. Değişmemişse, özgün
sunucu kısa ve öz bir "304 Not Modified" yanıtı ile yanıt vermelidir.
Bunun önbellekteki anlamı şudur: Eskimiş içerik hala tazedir ve içerik
yeni tazelik ömrüne ulaşıncaya kadar sonraki isteklerde
kullanılmalıdır.</p>
<p>İçerik değişmişse, bir şartlı istek yapılmamış gibi içeriğin kendisi
sunulur.</p>
<p>Şartlı istekler çifte yarar sağlar. Birinci olarak, böyle bir istek
özgün sunucuya yapılıyorsa ve iki içerik de aynıysa bunu saptamak kolay
olur ve özkaynağın tamamını aktarma külfetinden kurtulunur.</p>
<p>İkinci olarak, iyi tasarlanmış bir özgün sunucu, koşullu istekler tam
bir yanıt üretmekten önemli ölçüde ucuz olacak şekilde tasarlanmış
olacaktır. Durağan dosyalar için bu genellikle
<code>stat()</code> veya benzeri bir sistem çağrısıyla dosya
boyutları ve değişiklik zamanına bakmak şeklinde gerçekleşir.
Böylelikle, yerel içeriği bir değişiklik olmadığı takdirde önbellekten
sunmak daha hızlı olacaktır.</p>
<p>Özgün sunucular koşullu istekleri desteklemek için her türlü çabayı
göstermelidir. Ancak, koşullu istekler desteklenmiyorsa, özgün sunucu
istek koşullu değilmiş gibi yanıt vermeli, önbellek ise, içerik
değişmiş ve yani içerik önbelleğe kaydedilmiş gibi yanıt vermelidir. Bu
durumda, önbellek basit bir iki durumlu (içerik ya tazedir ya da
silinmiş) önbellek gibi davranacaktır.</p>
<h3>Neler Önbelleklenebilir?</h3>
<p>HTTP önbelleğin tarafından önbelleklenebilecek içerik
<a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html#sec13.4">
RFC2616 Section 13.4 Response Cacheability</a> belgesinde tanımlanmış
olup, bunlar şöyle özetlenebilir:</p>
<ol>
<li>Önbellekleme bu URL ile etkin kılınabilmelidir. <code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code> ve <code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code> yönergelerine bakınız.</li>
<li>Yanıtın HTTP durum kodu 200, 203, 300, 301 veya 410 olmalıdır.</li>
<li>Yanıtın HTTP durum kodu 200, 203, 300, 301 veya 410 değilse
yanıtın ayrıca, "Expires" veya "Cache-Control" başlığı da içermesi
gerekir.</li>
<li>İstek bir HTTP GET isteği olmalıdır.</li>
<li>Eğer yanıt bir "Authorization:" başlığı içeriyorsa ayrıca
"Cache-Control:" başlığında da "s-maxage", "must-revalidate" veya
"public" değerlerinden birini içermelidir, aksi takdirde
önbelleklenmez.</li>
<li>Eğer URL (GET yöntemi kullanan bir HTML formunun yaptığı gibi) bir
sorgu dizgesi içeriyorsa yanıt, RFC2616’nın 13.9. bölümünde
açıklandığı gibi bir "Expires:" başlığı içermedikçe veya
"Cache-Control:" başlığının max-age veya max-age yönergesini
içermedikçe yanıt içeriği önbelleğe alınmayacaktır.</li>
<li><code class="directive"><a href="./mod/mod_cache.html#cacheignorenolastmod">CacheIgnoreNoLastMod</a></code>
yönergesinin kullanımını gerektiren bir durum olmadıkça 200 durum
koduna sahip bir yanıtın "Etag", "Last-Modified" ve "Expires"
başlıklarından birini veya "Cache-Control:" başlığının "max-age" veya
"s-maxage" yönergelerinden birini (en azından) içermesi gerekir.</li>
<li><code class="directive"><a href="./mod/mod_cache.html#cachestoreprivate">CacheStorePrivate</a></code>
yönergesinin kullanımını gerektiren bir durum olmadıkça yanıt
"private" değerli bir "Cache-Control:" başlığı içerdiği takdirde
yanıtın içeriği önbelleğe alınmayacaktır.</li>
<li>Benzer şekilde, <code class="directive"><a href="./mod/mod_cache.html#cachestorenostore">CacheStoreNoStore</a></code> yönergesi kullanılmamışsa yanıt
"no-store" değerli bir "Cache-Control:" başlığı içeriyorsa yanıt
içeriği önbelleğe alınmayacaktır.</li>
<li>Herşeyle eşleşen "*" değerli bir "Vary:" başlığı içeren bir
yanıtın içeriği önbelleğe alınmaz.</li>
</ol>
<h3>Neler Önbelleklenmemeli?</h3>
<p>İçerik zamana bağımlıysa ya da istek kısmen bile olsa HTTP uzlaşımıyla
bağdaşmıyorsa önbelleğe alınmamalıdır. Bu içerik önbelleklenemeyeceğini
<code>Cache-Control</code> başlığını kullanarak sunucuya
bildirmelidir.</p>
<p>İçerik sıkça değişiyorsa, tazelik ömrü dakikalar veya saniyelerle
ifade ediliyorsa, içerik yine de önbelleklenebilir. Ancak, tam
yanıtların düzenli olarak üretilmemesinin temini için özgün sunucunun
<strong>koşullu istekleri</strong> doğru olarak desteklemesi
sağlanmalıdır.</p>
<p>İstemcinin sağladığı istek başlıklarına dayanarak değişen içerik,
<code>Vary</code> yanıt başlığının akıllıca kullanımıyla
önbelleklenebilir.</p>
<h3>Değişken/Uzlaşımlı İçerik</h3>
<p>Özgün sunucu, istekteki başlık değerlerine dayanarak farklı
içeriklerle yanıt vermeye ayarlandığı takdirde, örneğin aynı URL'de
farklı dillerde içerik sunmak gibi, HTTP'nin önbellekleme mekanizması
aynı URL'de aynı sayfanın değişik sürümlerini önbelleklemeyi mümkün
kılar.</p>
<p>Bu özgün sunucu tarafından bir <code>Vary</code> başlığı eklenerek
yapılır. Bir sayfanın farklı sürümleri arasındaki farkları saptarken
önbellek tarafından hangi başlıkların hesaba katılacağını
<code>Vary</code> başlığı belirler.</p>
<p>Örneğin, bir yanıt şöyle bir başlık ile alınmışsa,</p>
<div class="example"><p><code>
Vary: negotiate,accept-language,accept-charset
</code></p></div>
<p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> sadece accept-language ve accept-charset
başlıkları özgün istekle eşleşen önbellekli içeriği sunacaktır.</p>
<p>İçeriğin farklı sürümleri yan yana önbelleklenebilir.
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> modülü <code>Vary</code> başlığını
kullanarak başlıkta listelenmiş istek başlıklarının uygun değerlerini
saptar ve istemciye hangi sürümle yanıt verileceğine karar verir.</p>
</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">Önbellek Ayarlama Örnekleri</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code></li><li><code class="module"><a href="./mod/mod_cache_socache.html">mod_cache_socache</a></code></li><li><code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cacheroot">CacheRoot</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code></li><li><code class="directive"><a href="./mod/mod_cache_socache.html#cachesocache">CacheSocache</a></code></li></ul></td></tr></table>
<h3><a name="disk" id="disk">Disk Üzerinde Önbellekleme</a></h3>
<p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> modülü önbelleği yönetmek için çeşitli
depolama ortamlarına özgü gerçeklenimleri kullanır. Diske önbellekleme
desteğini <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> sağlar.</p>
<p>Tipik olarak modül şöyle yapılandırılır:</p>
<pre class="prettyprint lang-config">CacheRoot "/var/cache/apache/"
CacheEnable disk /
CacheDirLevels 2
CacheDirLength 1</pre>
<p>En önemlisi önbelleklenen dosyaların yerel olarak saklanması olup
işletim sisteminin sağladığı bellekiçi önbelleklemeden de ayrıca
faydalanılmış olur. Bu bakımdan, dosyalar disk üzerinde saklansa bile
sıkça erişilen dosyalar işletim sistemi sayesinde aslında bellekten
sunulmuş olacaklardır.</p>
<h3>Önbellekte Saklamanın Anlamı</h3>
<p><code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> öğeleri önbellekte saklamak için
istek yapılan URL’nin 22 karakterlik özetini oluşturur. Bu özet, çok
sayıda URL’nin aynı özeti oluşturmaması için konak ismi, protokol,
port ve varsa CGI argümanlarından başka <code>Vary</code> başlığında
tanımlı elemanlardan oluşur.</p>
<p>Özeti oluşturan karakterler 64 karakterlik bir karakter kümesinden
seçildiğinden oluşturulması olası farklı özet sayısı 64^22’dir.
Örneğin, bir URL’nin <code>xyTGxSMO2b68mBCykqkp1w</code> gibi bir
özeti olabilir. Bu özet, bu URL ile erişilen dosyalar önbellek içinde
saklanırken dosya ismi öneki olarak kullanılır. Ancak bununla
yetinilmez ve içerik <code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code> ve <code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code> yönergelerinin
değerlerine göre önce dizinlere ayrılır.</p>
<p><code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code>
yönergesi kaç alt seviye dizin olacağını ve <code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code> her dizinde kaç
karakter olacağını belirler. Örneğin, yukarıdaki
özete sahip bir dosyanın isminin başına yukarıdaki yapılandırma
örneğine uygun olarak
<code>/var/cache/apache/x/y/TGxSMO2b68mBCykqkp1w</code> gibi bir önek
getirilebilirdi.</p>
<p>Bu tekniğin asıl amacı belli bir dizin içinde bulunabilecek
dosyaların ve alt dizinlerin sayısını düşük tutmaktır. Bu sayının
büyük olması çoğu işletim sisteminde başarımın düşmesine sebep olur.
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code>
yönergesi "1" değeriyle kullanıldığında her dizin altında en fazla 64
alt dizin veya dosya açılabilir. "2" değeriyle kullanıldığında ise bu
sayı 64^2’ye yükselir ve böyle artarak gider. İyi bir sebebiniz
olmadıkça <code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code> için değer olarak
"1" belirtmenizi öneririz.</p>
<p><code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code>
yönergesine atanacak değer önbellekte saklamayı düşündüğünüz olası
dosya sayısı ile ilgilidir. Yukarıdaki örnekte olduğu gibi "2"
değerini belirtirseniz, toplamda en fazla 4096 dizin oluşturulabilir.
1 milyon dosyanın önbelleklendiği bir durumda bu, her dizinde yaklaşık
olarak 245 önbelleklenmiş URL demektir.</p>
<p>Her URL için önbellekte en az iki dosya saklanır. Biri genellikle URL
hakkındaki temel verilerden oluşan ".header" dosyasıdır, diğeri ise
sunulacak içeriğin bire bir kopyası olan ".data" dosyasıdır.</p>
<p>"Vary" başlığı üzerinden içeriğin uzlaşıldığı durumda URL için bir
".vary" dizini oluşturulur. Bu dizin her biri farklı bir uzlaşıma ait
çok sayıda ".data" dosyası içerebilir.</p>
<h3>Disk Önbelleğinin Bakımı</h3>
<p><code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> zaman aşımına uğrayan önbellekli
içeriği silse de önbelleğin toplam boyu ve ne kadar boş bellek kaldığı
hakkında bilgi vermez.</p>
<p>Bunun yerine httpd önbellek içeriğini düzenli aralıklarla
temizleyebilmeniz için <code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code> adında bir araç
içerir. Önbellek için azami ne kadar yer kullanılacağının ve bunun
üzerinde <code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code>’i hangi sıklıkta
çalıştırılacağının tespiti biraz karmaşık bir işlem olup uygun değerler
genellikle deneme yanılma yoluyla bulunur.</p>
<p><code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code> iki işlem kipine sahiptir. Kalıcı bir
artalan süreci olarak çalışabileceği gibi cron üzerinden belli
aralıklarla da çalıştırılabilir. Çok büyük (onlarca GB) önbelleklerde
<code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code>’in işini bitirmesi 1 saatten fazla
sürebileceğinden, cron ile çalıştırma durumunda aynı anda birden fazla
kopyanın çalışıyor durumda olmaması için
<code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code>’in çalıştırılma aralığını iyi
belirlemek gerekir.</p>
<p>Ayrıca, <code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code> için uygun bir "nice" seviyesi
seçilmesi önerilr. Böylece, sunucu çalışırken aracın ölçüsüz disk g/ç
yapmasına sebebiyet verilmemiş olur.</p>
<p class="figure">
<img src="images/caching_fig1.tr.png" alt="" width="600" height="406" /><br />
<a id="figure1" name="figure1"><dfn>Şekil 1</dfn></a>:
Önbelleğin büyümesi ve düzenli aralıklarla temizlenmesi.</p>
<p><code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> ne kadar bellek kullanıldığı hakkında
bilgi vermediğinden, <code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code>'in bir temizliğin
ardından yeterli bir büyüme alanı kalacak şekilde yapılandırılması
temin edilmelidir.</p>
<h3><a name="memcache" id="memcache">memcached ile önbellekleme</a></h3>
<p><code class="module"><a href="./mod/mod_cache_socache.html">mod_cache_socache</a></code> modülünü kullanarak,
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> çeşitli gerçeklenimlerden (diğer adıyla:
"sağlayıcılar"dan) gelen veriyi önbellekleyebilir.
<code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code> modülü kullanılarak, örneğin,
artalan saklama mekanizması olarak
<a href="http://memcached.org">memcached</a> kullanıldığı
söylenebilir.</p>
<p>Genelde modül şöyle yapılandırılır:</p>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache memcache:memcd.example.com:11211</pre>
<p>İlave <code>memcached</code> sunucular
<code>CacheSocache memcache:</code> satırının ardına virgüllerle
ayrılarak eklenebilir:</p>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache memcache:mem1.example.com:11211,mem2.example.com:11212</pre>
<p>Bu biçim diğer <code class="module"><a href="./mod/mod_cache_socache.html">mod_cache_socache</a></code> sağlayıcıları için de kullanılabilir:</p>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache shmcb:/path/to/datafile(512000)</pre>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache dbm:/path/to/datafile</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="socache-caching" id="socache-caching">Genel İki durumlu Anahtar/Değer Paylaşımlı Nesne Önbellekleme</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authn_socache.html">mod_authn_socache</a></code></li><li><code class="module"><a href="./mod/mod_socache_dbm.html">mod_socache_dbm</a></code></li><li><code class="module"><a href="./mod/mod_socache_dc.html">mod_socache_dc</a></code></li><li><code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code></li><li><code class="module"><a href="./mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code></li><li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authn_socache.html#authncachesocache">AuthnCacheSOCache</a></code></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslstaplingcache">SSLStaplingCache</a></code></li></ul></td></tr></table>
<p>Apache HTTP sunucusu, SSL oturumları, kimlik doğrulama bilgileri gibi
önbelleklenebilen özel bilgiler için <a href="socache.html">socache</a>
arayüzü içinde düşük seviyeli bir paylaşımlı nesne önbelleğine
sahiptir.</p>
<p>Her gerçeklenime uygun ek modüller de sağlanmıştır:</p>
<dl>
<dt><code class="module"><a href="./mod/mod_socache_dbm.html">mod_socache_dbm</a></code></dt>
<dd>DBM tabanlı paylaşımlı nesne önbelleklemesi.</dd>
<dt><code class="module"><a href="./mod/mod_socache_dc.html">mod_socache_dc</a></code></dt>
<dd>Distcache tabanlı paylaşımlı nesne önbelleklemesi.</dd>
<dt><code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code></dt>
<dd>Memcache tabanlı paylaşımlı nesne önbelleklemesi.</dd>
<dt><code class="module"><a href="./mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code></dt>
<dd>Paylaşımlı belleğe dayalı paylaşımlı nesne önbelleklemesi.</dd>
</dl>
<h3><a name="mod_authn_socache-caching" id="mod_authn_socache-caching">Kimlik Doğrulama Bilgilerinin Önbelleklenmesi</a></h3>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authn_socache.html">mod_authn_socache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authn_socache.html#authncachesocache">AuthnCacheSOCache</a></code></li></ul></td></tr></table>
<p><code class="module"><a href="./mod/mod_authn_socache.html">mod_authn_socache</a></code> modülü kimlik doğrulama araçlarının
yükünün hafifletilmesini, kimlik doğrulama sonucunun önbelleklenmesini
sağlar.</p>
<h3><a name="mod_ssl-caching" id="mod_ssl-caching">SSL Oturumlarının Önbelleklenmesi</a></h3>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslstaplingcache">SSLStaplingCache</a></code></li></ul></td></tr></table>
<p><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> modülü, oturum önbelleği ve önbellek
zımbalaması sağlamak için <code>socache</code> arayüzünü kullanır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="file-caching" id="file-caching">Uzmanlaşmış Dosya Önbellekleme</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code></li><li><code class="directive"><a href="./mod/mod_file_cache.html#mmapfile">MMapFile</a></code></li></ul></td></tr></table>
<p>Dosya sisteminin yavaş olabildiği veya dosya tanıtıcılarının
kullanımının pahalıya mal olduğu sistemlerde, sunucunun başlatılması
sırasında dosyaların belleğe yüklenmesi seçeneği vardır.</p>
<p>Dosyaların açılmasının yavaş olduğu sistemlerde, dosyaların sunucunun
başlatılması sırasında açılması ve dosya tanıtıcısını önbelleklenmesi
seçeneği vardır. Bu seçeneklerin duruk dosyalara erişimin yavaş olduğu
sistemlere de bir yardımı olabilir.</p>
<h3><a name="filehandle" id="filehandle">Dosya Tanıtıcı Önbelleklemesi</a></h3>
<p>Bir dosyanın açılması işlemi, özellikle de ağ dosya sistemlerinde
bulunan dosyalar için önemli bir gecikme kaynağı olabilir. Önbellekte,
çok sunulan dosyaların kendilerinin değil, açık dosya tanıtıcılarının
saklanması httpd’yi bu tür gecikmelerden koruyabilir. httpd’de tek
türde dosya tanıtıcı önbelleklemesi yapılabilmektedir.</p>
<h4><code>CacheFile</code> yönergesi ile</h4>
<p>httpd’de mevcut önbelleklemenin en temel şekli
<code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> tarafından sağlanan dosya tanıtıcı
önbelleklemesidir. Bu önbellek türü dosyaların kendilerini değil açık
dosya tanıtıcılarının bir listesini saklar. Dosyaların bu anlamda
önbelleklenmesi, <code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code> yönergesi yapılandırma dosyasında belirtilerek
sağlanabilir.</p>
<p><code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code> yönergesi
belirtilen dosyanın httpd başlatıldığında açılmasını ve dosya için
yapılan sonraki her istekte bu dosya tanıtıcısının kullanılmasını
sağlar.</p>
<pre class="prettyprint lang-config">CacheFile /usr/local/apache2/htdocs/index.html</pre>
<p>Büyük miktarda dosyayı bu anlamda önbelleklemeyi tasarlıyorsanız
işletim sisteminizin açık dosya tanıtıcılarının sayısı ile ilgili
sınırlamasını uygun bir değere ayarlamanız gerekebilir.</p>
<p><code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code> yönergesini
kullandığınız takdirde dosya içeriğindeki değişiklikleri anında
isteğe yansıtamazsınız. httpd dosyayı ilk başlatıldığındaki haliyle
sunar.</p>
<p>Eğer httpd çalışırken dosya silinmişse httpd ilk başlatıldığındaki
haline ilişkin dosya tanıtıcıyı sağlamaya ve dolayısıyla dosya
içeriğini sunmaya devam edecektir. Yani, dosya silinmiş ve artık
dosya sisteminde görünmüyor olsa bile httpd durdurulup dosya
tanıtıcıları kapanmadıkça dosyaların silinmesiyle açılan yer serbest
kalmayacaktır.</p>
<h3><a name="inmemory" id="inmemory">Sistem Belleğinde Önbellekleme</a></h3>
<p>İçeriğin sistem belleğinden sunulması içerik sunmanın evrensel olarak
en hızlı yoludur. Dosyaların bir disk denetleyiciden okunması ya da daha
kötüsü uzak bir ağdan okunması bellekten okumayla karşılaştırılamayacak
ölçüde yavaş işlemlerdir. Disk denetleyiciler genellikle fiziksel
süreçleri denetlerler. Ağ erişimi ise band genişliği sınırlamalarından
etkilenir. Halbuki bellek erişimi sadece nano saniyeler mertebesinde
gerçekleşir.</p>
<p>Sistem belleği en pahalı saklama ortamı olması sebebiyle en verimli
şekilde kullanımı önemlidir. Dosyaları sistem belleğinde saklamakla
sistemin kullanabileceği bellek miktarını azaltmış olursunuz. İşletim
sistemi önbelleklemesinde göreceğiniz gibi bu öyle basit bir konu
değildir. httpd’nin kendi kullandığı belleğin bir kısmını önbellek
olarak ayırırken çok fazla bellek kullanmamak önemlidir. Aksi takdirde
işletim sistemi belleğin yetmediği noktada belleği diske
takaslayacağından istenen başarım artışı sağlanamayacaktır.</p>
<h4>İşletim Sistemi Önbelleklemesi</h4>
<p>Günümüz iştetim sistemlerinin hemen hemen tamamında bellek içi
dosya/veri saklama işlemlerini çekirdek yönetir. Bu güçlü bir
özelliktir ve işletim sistemlerinin büyük çoğunluğu bunu böyle yapar.
Örneğin, Linux’ta bir dosyanın ilk defa okunduğunda ve ikinci kez
okunduğunda işlemcinin ne kadar meşgul edildiğine bakalım:</p>
<div class="example"><p><code>
colm@coroebus:~$ time cat testfile > /dev/null<br />
real 0m0.065s<br />
user 0m0.000s<br />
sys 0m0.001s<br />
colm@coroebus:~$ time cat testfile > /dev/null<br />
real 0m0.003s<br />
user 0m0.003s<br />
sys 0m0.000s
</code></p></div>
<p>Küçük bir dosya için bile okuma süresi bakımından büyük fark ortaya
çıkmaktadır. Bunun sebebi çekirdeğin dosya içeriğini bellek daha
güncel amaçlar için lazım olana dek bellek içinde saklamasıdır.</p>
<p>Sisteminizde yeterince yedek bellek olduğundan eminseniz, bu
önbellekte daha fazla dosya saklanacağından emin olabilirsiniz.
Bundan, önbelleğin sistem belleğinde verimli biçimde tutulması için
httpd’de ek bir yapılandırmaya gidilmesinin gerekmediği sonucu
çıkarılabilir.</p>
<p>Bundan başka, işletim sistemi dosyaların değiştiği ve silindiği
zamanları bildiğinden bu tür dosyaların içerikleri gerektiğinde
önbellekten kendiliğinden silinmiş olur. Bellek içinde dosya
saklarken dosyaların değiştirilme zamanlarını bilme olanağı
olmadığından bu durum httpd’ye büyük yarar sağlar.</p>
<p>İşletim sisteminin dosyaların önbelleklenmesi için sağladığı bunca
yarara ve başarım artışına karşın bellek içinde dosya önbelleklemenin
httpd tarafından yerine getirilmesinin daha iyi olacağı bazı durumlar
vardır.</p>
<h4><code>MMapFile</code> yönergesi ile</h4>
<p><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> modülü, bir durağan dosyanın
içeriğini sunucunun başlatılması sırasında (mmap sistem çağrısıyla)
belleğe eşlenmesini mümkün kılmak için <code class="directive"><a href="./mod/mod_file_cache.html#mmapfile">MMapFile</a></code> yönergesini sağlar.
httpd bu dosyaya gelecek sonraki istekler için dosyanın bellekiçi
içeriğini kullanacaktır.</p>
<pre class="prettyprint lang-config">MMapFile /usr/local/apache2/htdocs/index.html</pre>
<p><code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code>
yönergesinde olduğu gibi bu dosyalarda httpd başlatıldıktan sonra
yapılacak bir değişiklikten httpd’nin haberi olmayacaktır.</p>
<p><code class="directive"><a href="./mod/mod_file_cache.html#mmapfile">MMapFile</a></code> yönergesi
ayırdığı belleğin toplam miktarı ile ilgilenmez, dolayısıyla
yönergenin aşırı kullanımından kaçınmalısınız. httpd’nin çocuk
süreçlerinin her biri bu belleğin kendilerine ait birer kopyasını
yapacağından belleğe eşlenen dosyaların çok yer kaplamaması büyük
önem taşımaktadır; aksi takdirde işletim sistemi belleği diske
takaslayacağından beklenen fayda sağlanamayacaktır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Güvenlik Kaygıları</a></h2>
<h3>Erişim Denetimi ve Yetkilendirme</h3>
<p><code class="directive"><a href="./mod/mod_cache.html#cachequickhandler">CacheQuickHandler</a></code>
yönergesine <code>On</code> değerinin atandığı öntanımlı durumda
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> kullanımı, daha çok sunucunun önüne
vidalanmış önbelleklemeli bir karşı vekile sahip olmak gibidir. Özgün
sunucunun bir harici önbellekmiş gibi sorgulanmasını gerektirmeyen tüm
istekler önbellekleme modülü tarafından karşılanacaktır. Bu durum
httpd'nin güvenlik modelini büyük ölçüde değiştirir.</p>
<p>Olası <code>.htaccess</code> dosyalarının dosya sisteminin tamamında
taranması çok pahalı bir işlem olduğundan <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>,
(işlemi hızlandırmak için) önbelleğe almanın temel amacını kısmen
gözardı ederek, önbellekteki içeriğin sunumu için gerekli
yetkilendirmenin olup olmadığı konusunda bir karar üretmez. Başka bir
deyişle, eğer <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> bir kısım içeriği önbelleğe
almışsa içerik zaman aşımına uğramadığı sürece bu içerik önbellekten
sunulacaktır.</p>
<p>Örneğin, yapılandırmanız bir özkaynağa IP adresine göre erişime izin
veriyorsa bu içeriğin önbelleğe alınmayacağından emin olmalısınız.
Bunu <code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code>
yönergesini veya <code class="module"><a href="./mod/mod_expires.html">mod_expires</a></code> modülünü kullanarak
yapabilirsiniz. Bunu yapmaz, olayı kendi haline bırakırsanız
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> bir karşı vekil gibi çalışarak sunulan her
içeriği önbelleğe alacak ve hangi IP adresinden gelirse gelsin her
istemciye bunu sunacaktır.</p>
<p><code class="directive"><a href="./mod/mod_cache.html#cachequickhandler">CacheQuickHandler</a></code>
yönergesine <code>Off</code> atandığı takdirde, istek işleme
aşamalarının tamamı yerine getirilir ve güvenlik modeli değişmeden
kalır.</p>
<h3>Yerel İstismarcılar</h3>
<p>Son kullanıcılarıın isteklerine önbellekten hizmet sunulduğundan
önbelleğin kendisi içerikle etkileşime geçmek isteyenlerin veya
içeriği tahrif etmek isteyenlerin hedefi haline gelebilir. httpd’yi
çalıştıran kullanıcı tarafından her zaman önbelleğe yazılabileceğini
akıldan çıkarmamak önemlidir. Bu durumda alışılmışın tersine tüm
içeriğin Apache kullanıcısı tarafından yazılamamasının sağlanması
önerilir.</p>
<p>Eğer Apache kullanıcısı, örneğin bir CGI sürecindeki açık nedeniyle
tehlikeye atılırsa, önbellek hedef alınabilir.
<code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> kullanılırken önbellekteki bir öğeyi
değiştirmek veya önbelleğe yeni bir öğe eklemek görece daha
kolaydır.</p>
<p>Bu risk, Apache kullanıcısını kullanan diğer saldırı türleriyle
karşılaştırıldığında daha yüksektir. <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>
kullanıyorsanız şunları aklınızdan çıkarmayın: (1) httpd güvenlik
güncellemelerini takip edin ve sunucunuzu buna göre güncelleyin. (2)
Mümkünse <a href="suexec.html">suEXEC</a> kullanarak CGI süreçlerini
Apache kullanıcısı olmayan bir kullanıcının aidiyetinde çalıştırın.</p>
<h3>Önbellek Zehirlenmeleri</h3>
<p>httpd bir önbellekli vekil sunucu olarak çalıştığında önbellek
zehirlenmesi adı verilen sorunla karşılaşılma olasılığı vardır.
Önbellek zehirlenmesi, vekil sunucunun özgün sunucudan yanlış (ve
genellikle istenmeyen) içerik almasına sebep olan bir saldırı türünü
betimlemek için yaygın olarak kullanılan bir terimdir.</p>
<p>Örneğin httpd’nin çalıştığı sistemin kullandığı DNS sunucuları DNS
önbellek zehirlenmesinden etkilenebilecek durumdaysa, bir saldırgan
httpd’nin istekleri almak için başvuracağı kaynak sunucunun yerini
değiştirebilir. Diğer bir örnek, HTTP istek kaçakçılığı adı verilen
bir saldırı türüdür.</p>
<p>Bu belge HTTP istek kaçakçılığını derinliğine incelenmesi için uygun
yer değildir (böyle kaynaklara arama motorunuzla erişebilirsiniz).
Bununla birlikte, vekil tarafından kaynak sunucudan alınan içeriği
tamamen denetim altına almak amacıyla kaynak sunucudaki bir açığı
istismar etmeye yönelik bir dizi istek yapılabileceğinin olasılık
dahilinde olduğunu bilmenizde yarar vardır.</p>
<h3>Hizmet Reddi / Önbelleğin Engellenmesi</h3>
<p>Vary mekanizması aynı URL'nin çok sayıda sürümünün yan yana
önbelleklenmesini mümkün kılar. İstemci tarafından sağlanan başlık
değerlerine bağlı olarak, önbellek istemciye gönderilecek doğru yanıtı
bulacaktır. Normal kullanımda olası değerlerin çok geniş olduğunun
bilindiği durumda bir başlığı (örn, <code>User-Agent</code>)
değişikliğe uğratma çabası bu mekanizmayı bir sorun haline getirebilir.
Sitenin tanınırlığına bağlı olarak aynı URL'nin binlerce hatta
milyonlarca önbellek girdisi oluşabilir ve bunlar önbellekteki diğer
girdilerin yerini alabilir.</p>
<p>Diğer yandan, belli bir özkaynağın URL'sinin her istekte
değiştirilmesi ihtiyacı ortaya çıkabilir. Bu normalde URL dizgesine bir
"cachebuster" dizgesi eklenerek yapılır. Bu içerik sunucu tarafından
anlamlı bir tazelik ömrüyle önbelleklenebilir olarak imlenmişse bu
girdiler kısa zamanda önbellekteki meşru girdilerin yerini alabilir.
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> modülü bunun önlenmesi için <code class="directive"><a href="./mod/mod_cache.html#cacheignoreurlsessionidentifiers">CacheIgnoreURLSessionIdentifiers</a></code>
yönergesine sahipse de bu yönerge, yoldaki vekillerin veya tarayıcı
önbelleklerinin aynı hizmet reddi saldırısına maruz kalmamaları için
dikkatle kullanılmalıdır.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/caching.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/caching.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./tr/caching.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/caching.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/env.html.en 0000664 0001751 0001751 00000075764 14737241666 017151 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Environment Variables in Apache - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Environment Variables in Apache</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/env.html" title="English"> en </a> |
<a href="./fr/env.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>There are two kinds of environment variables that affect
the Apache HTTP Server.</p>
<p>First, there are the environment variables controlled by
the underlying operating system. These are set before the
server starts. They can be used in expansions in configuration
files, and can optionally be passed to CGI scripts and SSI
using the PassEnv directive.</p>
<p>Second, the Apache HTTP Server provides a mechanism for storing
information in named variables that are also called <em>environment
variables</em>. This information can be used to control various
operations such as logging or access control. The variables are
also used as a mechanism to communicate with external programs
such as CGI scripts. This document discusses different ways to
manipulate and use these variables.</p>
<p>Although these variables are referred to as <em>environment
variables</em>, they are not the same as the environment
variables controlled by the underlying operating system.
Instead, these variables are stored and manipulated in an
internal Apache structure. They only become actual operating
system environment variables when they are provided to CGI
scripts and Server Side Include scripts. If you wish to
manipulate the operating system environment under which the
server itself runs, you must use the standard environment
manipulation mechanisms provided by your operating system
shell.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#setting">Setting Environment Variables</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Using Environment Variables</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#special">Special Purpose Environment Variables</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Examples</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="setting" id="setting">Setting Environment Variables</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr></table>
<h3><a name="basic-manipulation" id="basic-manipulation">Basic Environment Manipulation</a></h3>
<p>The most basic way to set an environment variable in Apache
is using the unconditional <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> directive. Variables may also be passed from
the environment of the shell which started the server using the
<code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> directive.</p>
<h3><a name="conditional" id="conditional">Conditional Per-Request Settings</a></h3>
<p>For additional flexibility, the directives provided by
<code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> allow environment variables to be set
on a per-request basis, conditional on characteristics of particular
requests. For example, a variable could be set only when a
specific browser (User-Agent) is making a request, or only when
a specific Referer [sic] header is found. Even more flexibility
is available through the <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>'s <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> which uses the
<code>[E=...]</code> option to set environment variables.</p>
<h3><a name="unique-identifiers" id="unique-identifiers">Unique Identifiers</a></h3>
<p>Finally, <code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code> sets the environment
variable <code>UNIQUE_ID</code> for each request to a value which is
guaranteed to be unique across "all" requests under very
specific conditions.</p>
<h3><a name="standard-cgi" id="standard-cgi">Standard CGI Variables</a></h3>
<p>In addition to all environment variables set within the
Apache configuration and passed from the shell, CGI scripts and
SSI pages are provided with a set of environment variables
containing meta-information about the request as required by
the <a href="http://www.ietf.org/rfc/rfc3875">CGI
specification</a>.</p>
<h3><a name="caveats" id="caveats">Some Caveats</a></h3>
<ul>
<li>It is not possible to override or change the standard CGI
variables using the environment manipulation directives.</li>
<li>When <code class="program"><a href="./programs/suexec.html">suexec</a></code> is used to launch
CGI scripts, the environment will be cleaned down to a set of
<em>safe</em> variables before CGI scripts are launched. The
list of <em>safe</em> variables is defined at compile-time in
<code>suexec.c</code>.</li>
<li>For portability reasons, the names of environment
variables may contain only letters, numbers, and the
underscore character. In addition, the first character may
not be a number. Characters which do not match this
restriction will be replaced by an underscore when passed to
CGI scripts and SSI pages.</li>
<li>A special case are HTTP headers which are passed to CGI
scripts and the like via environment variables (see below).
They are converted to uppercase and only dashes are replaced with
underscores; if the header contains any other (invalid) character,
the whole header is silently dropped. See <a href="#fixheader">
below</a> for a workaround.</li>
<li>The <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> directive runs
late during request processing meaning that directives such as
<code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> and <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> will not see the
variables set with it.</li>
<li>When the server looks up a path via an internal
<a class="glossarylink" href="./glossary.html#subrequest" title="see glossary">subrequest</a> such as looking
for a <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>
or generating a directory listing with <code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code>,
per-request environment variables are <em>not</em> inherited in the
subrequest. Additionally,
<code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> directives
are not separately evaluated in the subrequest due to the API phases
<code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> takes action in.</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="using" id="using">Using Environment Variables</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</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_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code></li><li><code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr></table>
<h3><a name="cgi-scripts" id="cgi-scripts">CGI Scripts</a></h3>
<p>One of the primary uses of environment variables is to
communicate information to CGI scripts. As discussed above, the
environment passed to CGI scripts includes standard
meta-information about the request in addition to any variables
set within the Apache configuration. For more details, see the
<a href="howto/cgi.html">CGI tutorial</a>.</p>
<h3><a name="ssi-pages" id="ssi-pages">SSI Pages</a></h3>
<p>Server-parsed (SSI) documents processed by
<code class="module"><a href="./mod/mod_include.html">mod_include</a></code>'s
<code>INCLUDES</code> filter can print environment variables
using the <code>echo</code> element, and can use environment
variables in flow control elements to makes parts of a page
conditional on characteristics of a request. Apache also
provides SSI pages with the standard CGI environment variables
as discussed above. For more details, see the <a href="howto/ssi.html">SSI tutorial</a>.</p>
<h3><a name="access-control" id="access-control">Access Control</a></h3>
<p>Access to the server can be controlled based on
environment variables using the <code>Require env</code>
and <code>Require not env</code> directives. In combination with
<code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, this
allows for flexible control of access to the server based on
characteristics of the client. For example, you can use these
directives to deny access to a particular browser (User-Agent).
</p>
<h3><a name="logging" id="logging">Conditional Logging</a></h3>
<p>Environment variables can be logged in the access log using
the <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
option <code>%e</code>. In addition, the decision on whether
or not to log requests can be made based on the status of
environment variables using the conditional form of the
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
directive. In combination with <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> this allows for flexible control of which
requests are logged. For example, you can choose not to log
requests for filenames ending in <code>gif</code>, or you can
choose to only log requests from clients which are outside your
subnet.</p>
<h3><a name="response-headers" id="response-headers">Conditional Response Headers</a></h3>
<p>The <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>
directive can use the presence or
absence of an environment variable to determine whether or not
a certain HTTP header will be placed in the response to the
client. This allows, for example, a certain response header to
be sent only if a corresponding header is received in the
request from the client.</p>
<h3><a name="external-filter" id="external-filter">External Filter Activation</a></h3>
<p>External filters configured by <code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>
using the <code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code> directive can
by activated conditional on an environment variable using the
<code>disableenv=</code> and <code>enableenv=</code> options.</p>
<h3><a name="url-rewriting" id="url-rewriting">URL Rewriting</a></h3>
<p>The <code>%{ENV:<em>variable</em>}</code> form of
<em>TestString</em> in the <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> allows <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>'s rewrite
engine to make decisions conditional on environment variables.
Note that the variables accessible in <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
without the <code>ENV:</code> prefix are not actually environment
variables. Rather, they are variables special to
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> which cannot be accessed from other
modules.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="special" id="special">Special Purpose Environment Variables</a></h2>
<p>Interoperability problems have led to the introduction of
mechanisms to modify the way Apache behaves when talking to
particular clients. To make these mechanisms as flexible as
possible, they are invoked by defining environment variables,
typically with <code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, though <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> and <code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> could also be used, for example.</p>
<h3><a name="downgrade" id="downgrade">downgrade-1.0</a></h3>
<p>This forces the request to be treated as a HTTP/1.0 request
even if it was in a later dialect.</p>
<h3><a name="force-gzip" id="force-gzip">force-gzip</a></h3>
<p>If you have the <code>DEFLATE</code> filter activated, this
environment variable will ignore the accept-encoding setting of
your browser and will send compressed output unconditionally.</p>
<h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3>
<p>This causes any <code>Vary</code> fields to be removed from
the response header before it is sent back to the client. Some
clients don't interpret this field correctly; setting this
variable can work around this problem. Setting this variable
also implies <strong>force-response-1.0</strong>.</p>
<h3><a name="force-response" id="force-response">force-response-1.0</a></h3>
<p>This forces an HTTP/1.0 response to clients making an HTTP/1.0
request. It was originally
implemented as a result of a problem with AOL's proxies. Some
HTTP/1.0 clients may not behave correctly when given an HTTP/1.1
response, and this can be used to interoperate with them.</p>
<h3><a name="gzip-only-text-html" id="gzip-only-text-html">gzip-only-text/html</a></h3>
<p>When set to a value of "1", this variable disables the
<code>DEFLATE</code> output filter provided by
<code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> for content-types other than
<code>text/html</code>. If you'd rather
use statically compressed files, <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>
evaluates the variable as well (not only for gzip, but for all
encodings that differ from "identity").</p>
<h3><a name="no-gzip" id="no-gzip">no-gzip</a></h3>
<p>When set, the <code>DEFLATE</code> filter of
<code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> will be turned off and
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> will refuse to deliver encoded
resources.</p>
<h3><a name="no-cache" id="no-cache">no-cache</a></h3>
<p><em>Available in versions 2.2.12 and later</em></p>
<p>When set, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> will not save an otherwise
cacheable response. This environment variable does not influence
whether a response already in the cache will be served for the current
request.</p>
<h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
<p>This disables <code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code>
when set.</p>
<h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3>
<p>This influences <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>'s behaviour. If
it contains a language tag (such as <code>en</code>, <code>ja</code>
or <code>x-klingon</code>), <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> tries
to deliver a variant with that language. If there's no such variant,
the normal <a href="content-negotiation.html">negotiation</a> process
applies.</p>
<h3><a name="redirect-carefully" id="redirect-carefully">redirect-carefully</a></h3>
<p>This forces the server to be more careful when sending a redirect
to the client. This is typically used when a client has a known
problem handling redirects. This was originally implemented as a
result of a problem with Microsoft's WebFolders software which has
a problem handling redirects on directory resources via DAV
methods.</p>
<h3><a name="suppress-error-charset" id="suppress-error-charset">suppress-error-charset</a></h3>
<p><em>Available in versions after 2.0.54</em></p>
<p>When Apache issues a redirect in response to a client request,
the response includes some actual text to be displayed in case
the client can't (or doesn't) automatically follow the redirection.
Apache ordinarily labels this text according to the character set
which it uses, which is ISO-8859-1.</p>
<p> However, if the redirection is to a page that uses a different
character set, some broken browser versions will try to use the
character set from the redirection text rather than the actual page.
This can result in Greek, for instance, being incorrectly rendered.</p>
<p>Setting this environment variable causes Apache to omit the character
set for the redirection text, and these broken browsers will then correctly
use that of the destination page.</p>
<div class="warning">
<h3>Security note</h3>
<p>Sending error pages without a specified character set may
allow a cross-site-scripting attack for existing browsers (MSIE)
which do not follow the HTTP/1.1 specification and attempt to
"guess" the character set from the content. Such browsers can
be easily fooled into using the UTF-7 character set, and UTF-7
content from input data (such as the request-URI) will not be
escaped by the usual escaping mechanisms designed to prevent
cross-site-scripting attacks.</p>
</div>
<h3><a name="proxy" id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked,
proxy-sendcl, proxy-chain-auth, proxy-interim-response, proxy-initial-not-pooled</a></h3>
<p>These directives alter the protocol behavior of
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>. See the <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> and <code class="module"><a href="./mod/mod_proxy_http.html">mod_proxy_http</a></code>
documentation for more details.</p>
<h3><a name="cgilike" id="cgilike">ap_trust_cgilike_cl</a></h3>
<p><em>Available in 2.4.59 and later</em></p>
<p> This variable allows a script running in CGI-like module to supply it's
own Content-Length HTTP response header. It should
only be set on configuration sections that contain trusted scripts.
</p>
</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">Examples</a></h2>
<h3><a name="fixheader" id="fixheader">Passing broken headers to CGI scripts</a></h3>
<p>Starting with version 2.4, Apache is more strict about how HTTP
headers are converted to environment variables in <code class="module"><a href="./mod/mod_cgi.html">mod_cgi
</a></code> and other modules: Previously any invalid characters
in header names were simply translated to underscores. This allowed
for some potential cross-site-scripting attacks via header injection
(see <a href="http://events.ccc.de/congress/2007/Fahrplan/events/2212.en.html">
Unusual Web Bugs</a>, slide 19/20).</p>
<p>If you have to support a client which sends broken headers and
which can't be fixed, a simple workaround involving <code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif
</a></code> and <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> allows you to still accept
these headers:</p>
<pre class="prettyprint lang-config">#
# The following works around a client sending a broken Accept_Encoding
# header.
#
SetEnvIfNoCase ^Accept.Encoding$ ^(.*)$ fix_accept_encoding=$1
RequestHeader set Accept-Encoding %{fix_accept_encoding}e env=fix_accept_encoding</pre>
<h3><a name="misbehaving" id="misbehaving">Changing protocol behavior with misbehaving clients</a></h3>
<p>Earlier versions recommended that the following lines be included in
httpd.conf to deal with known client problems. Since the affected clients
are no longer seen in the wild, this configuration is likely no-longer
necessary.</p>
<pre class="prettyprint lang-config">#
# The following directives modify normal HTTP response behavior.
# The first directive disables keepalive for Netscape 2.x and browsers that
# spoof it. There are known problems with these browser implementations.
# The second directive is for Microsoft Internet Explorer 4.0b2
# which has a broken HTTP/1.1 implementation and does not properly
# support keepalive when it is used on 301 or 302 (redirect) responses.
#
BrowserMatch "Mozilla/2" nokeepalive
BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
#
# The following directive disables HTTP/1.1 responses to browsers which
# are in violation of the HTTP/1.0 spec by not being able to understand a
# basic 1.1 response.
#
BrowserMatch "RealPlayer 4\.0" force-response-1.0
BrowserMatch "Java/1\.0" force-response-1.0
BrowserMatch "JDK/1\.0" force-response-1.0</pre>
<h3><a name="no-img-log" id="no-img-log">Do not log requests for images in the access log</a></h3>
<p>This example keeps requests for images from appearing in the
access log. It can be easily modified to prevent logging of
particular directories, or to prevent logging of requests
coming from particular hosts.</p>
<pre class="prettyprint lang-config">SetEnvIf Request_URI \.gif image-request
SetEnvIf Request_URI \.jpg image-request
SetEnvIf Request_URI \.png image-request
CustomLog "logs/access_log" common env=!image-request</pre>
<h3><a name="image-theft" id="image-theft">Prevent "Image Theft"</a></h3>
<p>This example shows how to keep people not on your server
from using images on your server as inline-images on their
pages. This is not a recommended configuration, but it can work
in limited circumstances. We assume that all your images are in
a directory called <code>/web/images</code>.</p>
<pre class="prettyprint lang-config">SetEnvIf Referer "^http://www\.example\.com/" local_referal
# Allow browsers that do not send Referer info
SetEnvIf Referer "^$" local_referal
<Directory "/web/images">
Require env local_referal
</Directory></pre>
<p>For more information about this technique, see the
"<a href="https://www.serverwatch.com/guides/keeping-your-images-from-adorning-other-sites/">Keeping Your Images from Adorning Other Sites</a>"
tutorial on ServerWatch.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/env.html" title="English"> en </a> |
<a href="./fr/env.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/env.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/content-negotiation.html.ja.utf8 0000664 0001751 0001751 00000121736 14743132254 023202 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>コンテントネゴシエーション - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>コンテントネゴシエーション</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./en/content-negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/content-negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/content-negotiation.html" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>Apache は HTTP/1.1 の規格に記述されているコンテントネゴシエーションを
サポートしています。
ブラウザにより提供されたメディアタイプ、
言語、文字セット、エンコーディングの優先傾向に基づいて、
最適なリソースの表現を選択できます。
また、不完全なネゴシエーション情報を送ってくるブラウザからのリクエストを
もっと賢く取り扱えるよう、いくつか機能も実装してあります。</p>
<p>コンテントネゴシエーションは
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>
モジュールによって提供されていて、デフォルトで組み込まれています。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#about">コンテントネゴシエーションについて</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#negotiation">Apache におけるネゴシエーション</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#methods">ネゴシエーション方法</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#better">品質の値を変える</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extensions">Transparent Content Negotiation
の拡張</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#naming">リンクと名前の変換に関する注意点</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#caching">キャッシュに関する注意事項</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="about" id="about">コンテントネゴシエーションについて</a></h2>
<p>リソースは、幾つか異なった表現で利用できる場合があります。
例えば、異なる言語や異なるメディアタイプ、
またはそれらの組み合わせで利用できるかも知れません。
もっとも適した選択をする方法の一つには、インデックスページを
ユーザに見せて、ユーザに選んでもらう方法があります。
しかし、サーバが自動的に選ぶことができる場合が多くあります。
これは、ブラウザがリクエスト毎に、
どの表現を嗜好するかという情報を送ることで動作しています。
例えばブラウザは、可能ならフランス語で情報を見たい、
不可能ならその代わりに英語でもよいと、
自分の嗜好を知らせることができます。
ブラウザはリクエストのヘッダで自分の優先傾向を知らせます。
フランス語のみの表現を要求する場合は、ブラウザは次を送ります。</p>
<div class="example"><p><code>Accept-Language: fr</code></p></div>
<p>この優先傾向は、選択可能な表現が存在して、
言語によって様々な表現がある場合にのみ適用される
ということに注意してください。</p>
<p>もっと複雑なリクエストの例を挙げましょう。
このブラウザはフランス語と英語を受け付ける、しかしフランス語を好む、
そして様々なメディアタイプを受け付けるが、
プレインテキストや他のタイプよりは HTML を好む、
他のメディアタイプよりは GIF や JPEG を好む、しかし最終手段として
他のメディアタイプも受け付ける、と設定されています。</p>
<div class="example"><p><code>
Accept-Language: fr; q=1.0, en; q=0.5<br />
Accept: text/html; q=1.0, text/*; q=0.8, image/gif; q=0.6, image/jpeg; q=0.6, image/*; q=0.5, */*; q=0.1
</code></p></div>
<p>Apache は HTTP/1.1 規格で定義されている 'server
driven' コンテントネゴシエーションをサポートしています。
<code>Accept</code>, <code>Accept-Language</code>,
<code>Accept-Charset</code>, <code>Accept-Encoding</code>
リクエストヘッダを完全にサポートしています。Apache は
'transparent' コンテントネゴシエーションもサポートしていますが、
これは RFC 2295 と RFC 2296 で定義されている試験的な
ネゴシエーションプロトコルです。
これらの RFCで定義されている 'feature negotiation'
はサポートしていません。</p>
<p><strong>リソース</strong>とは URI
で特定される概念上のもののことです (RFC 2396)。 Apache
のような HTTP サーバは、その名前空間の中での
リソースの<strong>表現</strong>へのアクセスを提供します。
それぞれの表現は
定義されたメディアタイプ、文字セット、エンコーディング等の
付属した、バイト列の形式です。
それぞれのリソースはある時点で 0 個、1 個、それ以上の表現と
関連付けられる可能性があります。複数の表現が利用できる場合は、
リソースは<strong>ネゴシエーション可能である</strong>とされ、
個々の表現は <strong>variant</strong> と呼ばれます。
ネゴシエーション可能なリソースの variant が異なる、
その状態を指して、
ネゴシエーションの<strong>次元</strong>と呼びます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="negotiation" id="negotiation">Apache におけるネゴシエーション</a></h2>
<p>リソースをネゴシエーションするためには、
サーバは variant それぞれについての情報を知っておく必要があります。
これは以下の二つの方法のどちらかで行われます。</p>
<ul>
<li>タイプマップ
(<em>すなわち</em> <code>*.var</code> ファイル)
を使う方法。 これは variant
を明示的に挙げているファイルを指定します。</li>
<li>'Multiviews'
を使って、サーバが暗黙の内にファイル名にパターン照合を
行なってその結果から選択する方法。</li>
</ul>
<h3><a name="type-map" id="type-map">type-map ファイルを使う</a></h3>
<p>タイプマップは <code>type-map</code> ハンドラ
(もしくは、古い Apache
の設定と下位互換である <a class="glossarylink" href="./glossary.html#mime-type" title="用語集を参照">MIME タイプ</a>
<code>application/x-type-map</code>)
に関連付けられたドキュメントです。
この機能を使うためには、あるファイルの拡張子を
<code>type-map</code>
として定義するようなハンドラを、
設定ファイル中に置く必要があることに注意してください。
これは</p>
<div class="example"><p><code>AddHandler type-map .var</code></p></div>
<p>をサーバ設定ファイル中に書くことが一番良い方法です。</p>
<p>タイプマップファイルは記述するリソースと同じ名前を持っていて、
利用可能な variant それぞれのエントリを持っている必要があります。
そして、このエントリは連続した HTTP のヘッダ行で構成されます。
異なる variant のためのエントリは空行で区切られています。
エントリ中に空行が複数あってはいけません。
習慣的には、マップファイルは全体を結合したもののエントリから始まります
(しかしこれは必須ではなく、あったとしても無視されるものです)。
次に例を示します。このファイルはリソース <code>foo</code>
を記述しているので、<code>foo.var</code> という名前になります。</p>
<div class="example"><p><code>
URI: foo<br />
<br />
URI: foo.en.html<br />
Content-type: text/html<br />
Content-language: en<br />
<br />
URI: foo.fr.de.html<br />
Content-type: text/html;charset=iso-8859-2<br />
Content-language: fr, de<br />
</code></p></div>
<p>たとえ MultiViews を使用するようになっていたとしても、
ファイル名の拡張子よりタイプマップの方が優先権を持つということにも
注意してください。
variant の品質が違うときは、この画像のように (JPEG, GIF, ASCII
アートがあります) メディアタイプの "qs"
パラメータで指定されます。</p>
<div class="example"><p><code>
URI: foo<br />
<br />
URI: foo.jpeg<br />
Content-type: image/jpeg; qs=0.8<br />
<br />
URI: foo.gif<br />
Content-type: image/gif; qs=0.5<br />
<br />
URI: foo.txt<br />
Content-type: text/plain; qs=0.01<br />
</code></p></div>
<p>qs 値の範囲は 0.000 から 1.000 です。qs 値が
0.000 の variant は決して
選択されないことに注意してください。'qs' 値のない variant
は qs 値 1.0 を 与えられます。qs
パラメータはクライアントの能力に関係無く、他の variant と
比較したときの variant
の相対的な「品質」を示します。
例えば、写真を表現しようとしているときは JPEG
ファイルの方が普通は ASCII
ファイルよりも高い品質になります。しかし、リソースが元々
ASCII アートで表現されているときは、ASCII ファイルの
方が JPEG ファイルよりも高い品質になります。このように、qs
は 表現されるリソースの性質によって variant
毎に特有の値を取ります。</p>
<p>認識されるヘッダの一覧は
<a href="mod/mod_negotiation.html#typemaps">mod_negotiation</a>
ドキュメントにあります。</p>
<h3><a name="multiviews" id="multiviews">Multiviews</a></h3>
<p><code>MultiViews</code> はディレクトリ毎のオプションで、
<code>httpd.conf</code>ファイルの
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>
セクション中や、(<code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
が適切な値に 設定されていると) <code>.htaccess</code>
ファイルで <code class="directive"><a href="./mod/core.html#options">Options</a></code>
ディレクティブによって設定することができます。
<code>Options All</code> は
<code>MultiViews</code>
をセットしないことに注意してください。明示的に
その名前を書く必要があります。</p>
<p><code>MultiViews</code> の効果は以下のようになります:
サーバが <code>/some/dir/foo</code>
へのリクエストを受け取り、<code>/some/dir</code> で
<code>MultiViews</code> が有効であって、
<code>/some/dir/foo</code> が存在<em>しない</em>場合、
サーバはディレクトリを読んで <code>foo.*</code>
にあてはまる全てのファイルを探し、
事実上それらのファイルをマップするタイプマップを作ります。
そのとき、メディアタイプとコンテントエンコーディングは、そのファイル名を
直接指定したときと同じものが割り当てられます。
それからクライアントの要求に一番合うものを選びます。</p>
<p>サーバがディレクトリの索引を作ろうとしている場合、
<code>MultiViews</code>
は <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>
ディレクティブで指定されたファイルを探す過程にも
適用されます。設定ファイルに</p>
<div class="example"><p><code>DirectoryIndex index</code></p></div>
<p>が書かれていて、<code>index.html</code> と
<code>index.html3</code> が
両方存在していると、サーバはその中からどちらかを適当に選びます。
もしその両方が存在せずに <code>index.cgi</code>
が存在していると、 サーバはそれを実行します。</p>
<p>もしディレクトリを読んでいる際に、
文字セット、コンテントタイプ、言語、エンコーディングを
指定するための <code>mod_mime</code>
で認識できる拡張子を持たないファイルが見つかると、結果は
<code class="directive"><a href="./mod/mod_mime.html#multiviewsmatch">MultiViewsMatch</a></code>
ディレクティブの設定に依存します。このディレクティブは
ハンドラ、フィルタ、他のファイル拡張子タイプのどれが
MultiViews ネゴシエーションで使用できるかを決定します。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="methods" id="methods">ネゴシエーション方法</a></h2>
<p>Apache はリソースの variant の一覧を、タイプマップファイルか
ディレクトリ内のファイル名からかで取得した後、
「最適な」 variant を決定するために二つの方法の
どちらかを起動します。
Apache のコンテントネゴシエーションの機能を使うために、
どのようにしてこの調停が行われるか詳細を知る必要はありません。
しかしながら、この文書の残りでは関心のある人のために、
使用されている方法について説明しています。</p>
<p>ネゴシエーション方法は二つあります。</p>
<ol>
<li>通常は <strong>Apache のアルゴリズムを用いた Server
driven negotiation</strong> が使用されます。Apache
のアルゴリズムは後に詳細に説明されています。
このアルゴリズムが使用された場合、Apache
はより良い結果になるように、特定の次元において品質の値を
「変える」ことができます。Apache
が品質の値を変える方法は後で詳細に説明されています。</li>
<li>RFC 2295
で定義されている機構を用いてブラウザが特に指定した場合、
<strong>transparent content negotiation</strong>
が使用されます。このネゴシエーション方法では、「最適な」
variant の決定をブラウザが完全に制御することができます。
ですから、結果はブラウザが使用しているアルゴリズムに依存します。
Transparent negotiation の処理の過程で、ブラウザは RFC 2296
で 定義されている 'remote variant selection algorithm'
を実行するように頼むことができます。</li>
</ol>
<h3><a name="dimensions" id="dimensions">ネゴシエーションの次元</a></h3>
<table>
<tr valign="top">
<th>次元</th>
<th>説明</th>
</tr>
<tr valign="top">
<td>メディアタイプ</td>
<td>ブラウザは <code>Accept</code>
ヘッダフィールドで優先傾向を指定します。
アイテムそれぞれは、関連した品質数値を持つことができます。
variant の説明も品質数値を持つことができます
("qs" パラメータをご覧下さい)。</td>
</tr>
<tr valign="top">
<td>言語</td>
<td>ブラウザは <code>Accept-Language</code>
ヘッダフィールドで優先傾向を指定します。
要素それぞれに品質数値を持たせることができます。
variants は 0 か 1 つかそれ以上の言語と
関連づけることができます。</td>
</tr>
<tr valign="top">
<td>エンコーディング</td>
<td>ブラウザは <code>Accept-Encoding</code>
ヘッダフィールドで優先傾向を指定します。
要素それぞれに品質数値を持たせることができます。</td>
</tr>
<tr valign="top">
<td>文字セット</td>
<td>ブラウザは <code>Accept-Charset</code>
ヘッダフィールドで優先傾向を指定します。
要素それぞれに品質数値を持たせることができます。
variant はメディアタイプのパラメータとして文字セットを
指定することもできます。</td>
</tr>
</table>
<h3><a name="algorithm" id="algorithm">Apache ネゴシエーションアルゴリズム</a></h3>
<p>ブラウザに返す「最適な」variant を (もしあれば) 選択するように
Apache は次のアルゴリズムを使うことができます。
このアルゴリズムを設定により変更することはできません。
次のように動作します:</p>
<ol>
<li>まずはじめに、ネゴシエーションの次元それぞれについて適切な
<em>Accept*</em> ヘッダフィールドを調べ、
variant それぞれに品質を割り当てます。
もしある次元の <em>Accept*</em> ヘッダでその variant
が許容できないことが示されていれば、それを削除します。
variant が一つも残っていなければ、ステップ 4 に行きます。</li>
<li>
消去法で「最適な」 variant を選びます。
次のテストが順番に適用されます。
テストで選択されなかった variant は削除されていきます。
テスト後 variant が一つだけ残っていれば、それを最適なものとして
ステップ 3 に進みます。
複数 variant が残っていれば、次のテストに進みます。
<ol>
<li>variant のメディアタイプの品質数値と <code>Accept</code>
ヘッダの品質数値との積を計算して、最高値の variant
を選びます。</li>
<li>言語品質数値が最高の variant を選びます。</li>
<li>(もしあれば) <code>Accept-Language</code> ヘッダの言語順か、
(もしあれば)
<code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>
ディレクティブの言語順で最適な言語の variant を選びます。</li>
<li>最高「レベル」のメディアパラメータ
(text/html メディアタイプのバージョンを与えるために使われます)
を持つ variant を選びます。</li>
<li><code>Accept-Charset</code> ヘッダ行で与えられている最高の文字セット
メディアパラメータを持つ variant を選びます。
明示的に除外されていない限り、ISO-8859-1
が許容されるようになっています。
<code>text/*</code> メディアタイプであるけれども
特定の文字セットに明示的に関連づけられているわけではない
variant は ISO-8859-1 であると仮定されます。</li>
<li>ISO-8859-1 <em>ではない</em>文字セットメディアパラメータと
関連づけられている variant を選びます。
そのような variant がない場合は、代わりに全ての
variant を選びます。</li>
<li>最適なエンコーディングの variant を選びます。
もし user-agent が許容するエンコーディングがあれば、
その variant のみを選びます。
そうではなく、もしエンコードされたものとそうでない
variant が混ざって存在していたらエンコードされていない
variant のみを選びます。
variant が全部エンコードされているか
variant が全部エンコードされていないという場合は、
全ての variant を選びます。</li>
<li>内容の最も短い variant を選びます。</li>
<li>残っている variant の最初のものを選びます。
タイプマップファイルの最初にリストされているか、
variant がディレクトリから最初に読み込まれる時に
ASCII順でソートしてファイル名が先頭になったか、のどちらかです。</li>
</ol>
</li>
<li>アルゴリズムを使って一つの「最適な」variant を選びましたので、
それを応答として返します。ネゴシエーションの次元を指定するために
HTTP レスポンスヘッダ <code>Vary</code> が設定されます
(リソースのキャッシュをする時に、
ブラウザやキャッシュはこの情報を使うことができます)。
以上で終わり。</li>
<li>ここに来たということは、variant が一つも選択されなかった
(ブラウザが許容するものがなかったため) ということです。
406 ステータス ("No Acceptable representation" を意味する)
が、利用可能な variant のリストのついた HTML
ドキュメントとともに返されます。
相違の次元を示す HTTP <code>Vary</code> ヘッダも設定されます。</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="better" id="better">品質の値を変える</a></h2>
<p>上記の Apache ネゴシエーションアルゴリズムの厳格な解釈で
得られるであろう値から、Apache は品質数値を時々変えます。
これは、このアルゴリズムで完全ではない、あるいは正確でない情報を送る
ブラウザ向けによりよい結果を得るために行われます。
かなりポピュラーなブラウザで、もしないと間違った variant
を選択する結果になってしまうような <code>Accept</code>
ヘッダ情報を送るものもあります。
ブラウザが完全で正しい情報を送っていれば、
この数値変化は適用されません。</p>
<h3><a name="wildcards" id="wildcards">メディアタイプとワイルドカード</a></h3>
<p><code>Accept:</code> リクエストヘッダはメディアタイプの優先傾向を指定します。
これはまた、"image/*" や "*/*"
といった「ワイルドカード」メディアタイプを含むことができます。
ここで * は任意の文字列にマッチします。
ですから、次の:</p>
<div class="example"><p><code>Accept: image/*, */*</code></p></div>
<p>を含むリクエストは、"image/" ではじまるタイプ全てが許容できる、
そして他のどんなタイプも許容できる
(この場合はじめの "image/*" は冗長になります)
ことを示します。
扱うことのできる明示的なタイプに加えて、機械的に
ワイルドカードを送るブラウザもあります。例えば:</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*
</code></p></div>
<p>こうすることの狙いは、明示的にリストしているタイプが優先されるけれども、
異なる表現が利用可能であればそれでも良い、ということです。
しかしながら、上の基本的なアルゴリズムでは、
*/* ワイルドカードは他の全てのタイプと全く同等なので優先されません。
ブラウザは */* にもっと低い品質 (優先)
値を付けてリクエストを送るべきなのです。例えば:</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*; q=0.01
</code></p></div>
<p>明示的なタイプには品質数値が付けられていませんので、
デフォルトの 1.0 (最高値) の優先になります。
ワイルドカード */* は低い優先度 0.01 を与えられているので、
明示的にリストされているタイプに合致する variant がない場合にのみ、
他のタイプが返されます。</p>
<p>もし <code>Accept:</code> ヘッダが q 値を全く含んで<em>いなければ</em>、
望みの挙動をするために、
Apache は "*/*" があれば 0.01 の q 値を設定します。
また、"type/*" の形のワイルドカードには 0.02 の q 値を設定します
(ですからこれらは "*/*" のマッチよりも優先されます)。
もし <code>Accept:</code> ヘッダ中のメディアタイプのどれかが q
値を含んでいれば、これらの特殊な値は適応<em>されず</em>、
正しい情報を送るブラウザからのリクエストは期待通りに
動作するようになります。</p>
<h3><a name="exceptions" id="exceptions">言語ネゴシエーションの例外処理</a></h3>
<p>Apache 2.0 では新たに、言語ネゴシエーションが適合するものを
見つけるのに失敗した時に、優雅にフォールバックできるような
ネゴシエーションアルゴリズムが幾つか追加されました。</p>
<p>サーバのページをクライアントがリクエストしたけれども、
ブラウザの送ってきた <code>Accept-Language</code> に合致するページが一つも
見つからなかった場合に、サーバは "No Acceptable Variant"
か "Multiple Choices" レスポンスをクライアントに返します。
これらのエラーメッセージを返さないように、
このような場合には Apache が <code>Accept-Language</code> を無視して、
クライアントのリクエストに明示的には合致しないドキュメントを
提供するように設定できます。
<code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code>
ディレクティブは、これらのエラーの一つか両方をオーバーライドするために
使用できて、
<code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>
ディレクティブの内容を使ってサーバの判断を代行するようにできます。</p>
<p>サーバは他に適合するものが見つからなければ、
言語サブセットで適合するものを試そうともします。
例えばクライアントが英国英語である <code>en-GB</code> 言語で
ドキュメントをリクエストした場合、サーバは HTTP/1.1
規格では、単に <code>en</code> とマークされているドキュメントを
マッチするものとすることは通常は許されていません。
(英国英語は理解できるけど一般的な英語は理解できないという読み手は
考えられないので、Accept-Language ヘッダで <code>en-GB</code>
を含んで <code>en</code> を含まないのはほぼ確実に設定の間違いである、
ということに注意してください。
ですが不幸なことに、多くのクライアントではデフォルトで
このような設定になっています。)
しかしながら、他の言語にはマッチせず、"No Acceptable Variants"
エラーを返したり、
<code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>
にフォールバックしようとしているときは、
サブセット指定を無視して、<code>en-GB</code> を <code>en</code>
にマッチします。
Apache はクライアントの許容言語リストに暗黙に
非常に低い品質値の親言語を加えることになります。
しかし、クライアントが "en-GB; q=0.9, fr; q=0.8" とリクエストして、
サーバが "en" と "fr" と設計されたドキュメントを持っている場合は、
"fr" ドキュメントが返されることに注意してください。
このような処理は、HTTP 1.1 規格との整合性を維持して、
適切に設定されたクライアントともきちんと動作するために
必要です。</p>
<p>より高度なテクニック (Cookie や特殊な URL パス等)
においてもユーザの言語選択をサポートするため、
Apache 2.0.47 からは、<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>
が<a href="env.html">環境変数</a> <code>prefer-language</code>
を認識するようになりました。
この変数が存在して、適切な言語タグが代入されているのであれば、
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> は合致する variant
を選択しようとします。合致するものが無ければ、
通常のネゴシエーション手順が適用されます。</p>
<div class="example"><h3>Example</h3><p><code>
SetEnvIf Cookie "language=(.+)" prefer-language=$1<br />
Header append Vary cookie
</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="extensions" id="extensions">Transparent Content Negotiation
の拡張</a></h2>
<p>Apache は transparent content negotiation プロトコル
(RFC 2295) を次のように拡張しています。
特定のコンテントエンコーディングのみが利用可能である variant
に印を付けるために、新たに <code>{encoding ..}</code>
要素を variant リスト中に使っています。
リスト中のエンコードされた variant を認識し、
<code>Accept-Encoding</code> リクエストヘッダに従って許容される
エンコードをもった variant は、どれでも候補 variant
として使用するように、
RVSA/1.0 アルゴリズム (RFC 2296) の実装が拡張されました。
RVSA/1.0 の実装では、最適な variant が見つかるまで、
計算した品質数値は小数点以下 5 桁まで丸めません。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="naming" id="naming">リンクと名前の変換に関する注意点</a></h2>
<p>言語ネゴシエーションを使っている場合は、
ファイルが一つ以上の拡張子を持てて、
拡張子の順番は通常は考慮されない
(詳細は <a href="mod/mod_mime.html#multipleext">mod_mime</a>
を参照) ので、
幾つかの異なる名前の変換を選べることになります。</p>
<p>典型的なファイルでは、MIME タイプ拡張子 (<em>例えば</em>
<code>html</code>) を持っていて、エンコーディング拡張子
(<em>例えば</em> <code>gz</code>) を持っているかもしれなくて、
このファイルに異なる言語 variant を用意していれば、
もちろん言語拡張子 (<em>例えば</em> <code>en</code>)
を持っているでしょう。</p>
<p>例:</p>
<ul>
<li>foo.en.html</li>
<li>foo.html.en</li>
<li>foo.en.html.gz</li>
</ul>
<p>ファイル名と、それに対して使えるリンクと使えないリンクの例です:</p>
<table class="bordered">
<tr>
<th>ファイル名</th>
<th>使えるリンク</th>
<th>使えないリンク</th>
</tr>
<tr>
<td><em>foo.html.en</em></td>
<td>foo<br />
foo.html</td>
<td>-</td>
</tr>
<tr>
<td><em>foo.en.html</em></td>
<td>foo</td>
<td>foo.html</td>
</tr>
<tr>
<td><em>foo.html.en.gz</em></td>
<td>foo<br />
foo.html</td>
<td>foo.gz<br />
foo.html.gz</td>
</tr>
<tr>
<td><em>foo.en.html.gz</em></td>
<td>foo</td>
<td>foo.html<br />
foo.html.gz<br />
foo.gz</td>
</tr>
<tr>
<td><em>foo.gz.html.en</em></td>
<td>foo<br />
foo.gz<br />
foo.gz.html</td>
<td>foo.html</td>
</tr>
<tr>
<td><em>foo.html.gz.en</em></td>
<td>foo<br />
foo.html<br />
foo.html.gz</td>
<td>foo.gz</td>
</tr>
</table>
<p>上の表を見て、拡張子なしのリンク (<em>例えば</em> <code>foo</code>)
がいつでも使えることに気が付くでしょう。
この利点は、ドキュメントとして応答するファイルの
実際のファイルタイプを隠蔽して、リンクの参照を変更することなく
後からファイルを変更できる、
<em>例えば</em> <code>html</code> から <code>shtml</code>
に、あるいは <code>cgi</code> に変更できる点です。</p>
<p>リンクに MIME タイプを使い続けたい (<em>例えば</em>
<code>foo.html</code>)時は、言語拡張子は
(エンコーディング拡張子もあればそれも含めて)
MIME タイプ拡張子の右側になければなりません
(<em>例えば</em> <code>foo.html.en</code>)。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="caching" id="caching">キャッシュに関する注意事項</a></h2>
<p>キャッシュが一つの表現を保存しているときは、
リクエスト URL と関連づけられています。
次にその URL がリクエストされた時に、キャッシュは
保存されている表現を使用できます。しかし、
リソースがサーバでネゴシエーション可能であれば、
最初のリクエストでキャッシュされて続くキャッシュヒットでは
間違った応答を返してしまうということになりかねません。
これを防ぐために、Apache はコンテントネゴシエーションの
後に返された応答全てに、HTTP/1.0 クライアントでは
キャッシュ不可能の印をつけます。
また、ネゴシエーションされた応答のキャッシュを可能にする
HTTP/1.1 プロトコルの機能も Apache はサポートします。</p>
<p>HTTP/1.0 準拠のクライアントからのリクエストに対しては、
(ブラウザであろうとキャッシュであろうと)
ネゴシエーションを受けた応答のキャッシュを許すために、
<code class="directive"><a href="./mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code>
ディレクティブを使用できます。
このディレクティブは、サーバ設定ファイルやバーチャルホストに書くことができ、
引数をとりません。
HTTP/1.1 クライアントからのリクエストには効力を持ちません。</p>
<p>HTTP/1.1 クライアントに対しては、レスポンスのネゴシエーション次元
を示すために <code>Vary</code> HTTP レスポンスヘッダを送ります。
キャッシュは、これを使って後続のリクエストに対してローカルコピーで応答できるか
どうかを決定できます。
ネゴシエーション次元とは関係なしにローカルコピーの使用を優先するようにするには、
<code>force-no-vary</code> <a href="env.html#special">環境変数</a>を
設定します。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./en/content-negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/content-negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/content-negotiation.html" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/content-negotiation.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/custom-error.html.ja.utf8 0000664 0001751 0001751 00000032332 14743132254 021644 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>カスタムエラーレスポンス - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>カスタムエラーレスポンス</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>ウェブマスターが何らかのエラーや問題に対する
Apache の反応を設定できるようにする追加機能を提供します。</p>
<p>サーバがエラーや問題を発見した場合の反応を、
カスタマイズして定義することができます。</p>
<p>スクリプトの実行が失敗して "500 Server Error"
を発生させたとします。この場合の反応を、より好ましいテキストや、別の
URL (内部及び外部) へのリダイレクションに置き換えることができます。
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#behavior">動作</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configuration">設定</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#custom">カスタムエラーレスポンスとリダイレクト</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="behavior" id="behavior">動作</a></h2>
<h3>古い動作</h3>
<p>NCSA httpd 1.3 は、古くて退屈なエラー/問題メッセージを
返していました。それはしばしばユーザには無意味であり、
またそれを発生させた原因を記録する方法も提供していませんでした。</p>
<h3>新しい動作</h3>
<ol>
<li>NCSA のハードコードされたメッセージの代わりに
他のテキストを表示</li>
<li>ローカルの URL にリダイレクト</li>
<li>外部の URL にリダイレクト</li>
</ol>
<p>するようにサーバを設定できます。</p>
<p>別の URL にリダイレクトすることは役に立ちますが、
それは説明をしたり、より明確に誤り/問題を記録したりするために
何か情報を伝えられるときに限ります。</p>
<p>これを実現するために、 Apache は新しく CGI のような環境変数を
定義します:</p>
<div class="example"><p><code>
REDIRECT_HTTP_ACCEPT=*/*, image/gif,
image/x-xbitmap, image/jpeg<br />
REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX
A.09.05 9000/712)<br />
REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br />
REDIRECT_QUERY_STRING=<br />
REDIRECT_REMOTE_ADDR=121.345.78.123<br />
REDIRECT_REMOTE_HOST=ooh.ahhh.com<br />
REDIRECT_SERVER_NAME=crash.bang.edu<br />
REDIRECT_SERVER_PORT=80<br />
REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />
REDIRECT_URL=/cgi-bin/buggy.pl
</code></p></div>
<p>頭に付く <code>REDIRECT_</code> に注目してください。</p>
<p>少なくとも <code>REDIRECT_URL</code> と
<code>REDIRECT_QUERY_STRING</code> は新しい URL (CGI スクリプトか
CGI インクルードであると仮定されます) に渡されます。
他の変数は、エラーや問題が起きる前に存在した場合にだけ存在します。
もしあなたの設定した <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> が <em>外部</em>リダイレクト
(<em>すなわち</em>、<code>http:</code>
のような体系名から始まるすべてのもの。たとえ同じホストを指していても)
ならば、これらは<strong>まったく</strong>設定されません。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuration" id="configuration">設定</a></h2>
<p><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> が適切に設定されていれば、
.htaccess ファイルで <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
を使用することができます。</p>
<p>ここに、いくつかの例を挙げます。</p>
<div class="example"><p><code>
ErrorDocument 500 /cgi-bin/crash-recover <br />
ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />
ErrorDocument 500 http://xxx/ <br />
ErrorDocument 404 /Lame_excuses/not_found.html <br />
ErrorDocument 401 /Subscription/how_to_subscribe.html
</code></p></div>
<p>構文</p>
<div class="example"><p><code>
ErrorDocument <3-digit-code> <action>
</code></p></div>
<p>action (動作) は、下記のいずれかです</p>
<ol>
<li>表示するテキスト。テキストは引用符 (") で囲んで指定します。</li>
<li>リダイレクト先の外部 URL </li>
<li>リダイレクト先のローカル URL </li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="custom" id="custom">カスタムエラーレスポンスとリダイレクト</a></h2>
<p>スクリプト/SSI に追加の環境変数が利用可能になるように、
リダイレクトされた URL に対する Apache の動作が変更されました。</p>
<h3>古い動作</h3>
<p>リダイレクトされたスクリプトは標準の CGI
環境変数を利用可能でした。しかし、どこからリダイレクト
されたかの情報は提供されていませんでした。</p>
<h3>新しい動作</h3>
<p>リダイレクトされた先のスクリプトが使用可能なように、
新しいたくさんの環境変数が初期化されます。新しい変数は、それぞれ
<code>REDIRECT_</code> で始まります。
<code>REDIRECT_</code> で始まる環境変数はリダイレクトされる前に存在していた
CGI 環境変数の頭に <code>REDIRECT_</code> を付けて作成されます。
<em>すなわち</em>、<code>HTTP_USER_AGENT</code> は
<code>REDIRECT_HTTP_USER_AGENT</code> になります。
これらの新しい変数に加えて、Apache は、
スクリプトがリダイレクト元のトレースを助けるために
<code>REDIRECT_URL</code> と <code>REDIRECT_STATUS</code>
を定義します。アクセスログには元の URL とリダイレクトされた URL
の両方が記録されます。</p>
<p>ErrorDocument が CGI スクリプトへのローカルリダイレクトを
指定している場合は、それを起動することになったエラーの状態を
クライアントまで確実に伝えるために <code>"Status:" </code>
ヘッダを含むべきです。例えば、ErrorDocument 用の Perl
スクリプトは以下のようなものを含むかもしれません。
</p>
<div class="example"><p><code>
... <br />
print "Content-type: text/html\n"; <br />
printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
...
</code></p></div>
<p>スクリプトが <code>404 Not Found</code> のような
特定のエラーコンディションを扱うためだけに使われる場合は、
代わりに特定のコードとエラーテキストを使用することができます。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/custom-error.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/license.html 0000664 0001751 0001751 00000000166 13710016232 017335 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: license.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/bind.html.tr.utf8 0000664 0001751 0001751 00000040334 14743132254 020153 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Adresleri ve Portları Dinleme - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Adresleri ve Portları Dinleme</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/bind.html" title="Türkçe"> tr </a></p>
</div>
<p>Apache HTTPD sunucusunun belli adresleri ve portları dinlemek üzere
yapılandırılması.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Genel Bakış</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#reload">Dinleme yapılandırmasının yeniden başlatırken değiştirilmesi</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ipv6">IPv6 Adreslerin Durumu</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#protocol">Protokolü Listen ile Belirtme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Sanal Konaklarla Nasıl Çalışır?</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="vhosts/">Sanal Konaklar</a></li><li><a href="dns-caveats.html">DNS Konuları</a></li><li><a href="#comments_section">Yorumlar</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="overview" id="overview">Genel Bakış</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mpm_common.html">mpm_common</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table>
<p>httpd başlatıldığında yerel makinedeki bazı adres ve portları kendine
bağlar ve gelecek istekleri bekler. Öntanımlı olarak makine üzerindeki
tüm adresleri dinler. Bununla birlikte, belli portları veya sadece
seçilmiş bazı adresleri ya da her ikisini de dinlemesi için bunun
belirtilmesi gerekebilir. Bu çoğunlukla, httpd’nin farklı IP
adreslerine, konak isimlerine ve portlarına nasıl yanıt vereceğinin
belirlendiği <a href="vhosts/">sanal konak</a> özelliği ile birlikte
yürür.</p>
<p><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergesi sunucuya
gelen istekleri sadece belli port(lar)dan veya belli adres ve port
birleşimlerinden kabul etmesini söyler. <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergesinde sadece port
numarası belirtilmişse sunucu tüm arabirimlerin belirtilen portunu
dinleyecektir. Portla birlikte bir IP adresi de belirtilmişse sunucu
belirtilen portu ve arabirimi dinleyecektir. Çok sayıda adres ve portu
dinlemek için çok sayıda <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergesi kullanılabilir. Sunucu
böyle bir durumda belirtilen bütün adres ve portlardan gelen isteklere
yanıt verecektir.</p>
<p>Örneğin, sunucunun hem 80 portundan hem de 8000 portundan gelen
bağlantıları kabul etmesini sağlamak için,</p>
<div class="example"><pre class="prettyprint lang-config">Listen 80
Listen 8000</pre>
</div>
<p>yapılandırmasını kullanabilirsiniz. Sunucunun 80 portuna gelen
bağlantıları bir arabirimden 8000 portuna gelenleri ise başka bir
arabirimden kabul etmesini sağlamak için ise,</p>
<div class="example"><pre class="prettyprint lang-config">Listen 192.0.2.1:80
Listen 192.0.2.5:8000</pre>
</div>
<p>yapılandırmasını kullanabilirsiniz. IPv6 adresleri aşağıdaki örnekteki
gibi köşeli ayraçlar içine alınarak belirtilmelidir:</p>
<div class="example"><pre class="prettyprint lang-config">Listen [2001:db8::a00:20ff:fea7:ccea]:80</pre>
</div>
<div class="warning">
<p>Bir <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergesinin
aynısının tekrarı sunucunun başlatılmasını engelleyen ölümcül bir hatayla
sonuçlanacaktır.</p>
<div class="example"><p><code>
(48)Address already in use: make_sock: could not bind to address [::]:80
</code></p></div>
<p>Sorun giderme ile ilgili ipuçları için
<a href="http://wiki.apache.org/httpd/CouldNotBindToAddress">wiki
belgesine</a> bakınız.</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="reload" id="reload">Dinleme yapılandırmasının yeniden başlatırken değiştirilmesi</a></h2>
<p>httpd yeniden başlatılırken,
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergelerindeki
değişiklikler için özel değerlendirmeler yapılmalıdır. Yeniden başlatma
sırasında, httpd, yeni bağlanma çabalarında "Connection refused" (bağlantı
reddedildi) hatasından kaçınmak için [özgün yapılandırmadaki gibi] portları
bağlı tutar. Bu bakımdan, <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
yönergelerinden yapılan değişiklikler yenden başlatılrken yapılandırmanın
başarısız olmasına ve sunucunun sonlanmasına sebep olur.</p>
<p>Örneğin:</p>
<div class="example"><pre class="prettyprint lang-config">Listen 127.0.0.1:80</pre>
</div>
<p>yapılandırmasını aşağıdakiyle değiştirmek yenden başlatma sırasında
sucunun hta verip sonlanmasına sebep olur. Çünkü, tüm adreslerden 80 porta
bağlanmak sadece 127.0.0.1 adresine bağlanmakla çelişir.</p>
<div class="example"><pre class="prettyprint lang-config">Listen 80</pre>
</div>
<p>Böyle değişikliklerin etkili olabilmesi için sunucu önce durdurulmalı
sonra başlatımalıdır (restart yerine stop ve start kullanılmalıdır).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="ipv6" id="ipv6">IPv6 Adreslerin Durumu</a></h2>
<p>IPv6’yı gerçekleyen platformların sayısı giderek artmaktadır. Bu
platformların çoğunda <a class="glossarylink" href="./glossary.html#apr" title="sözlüğe bakınız">APR</a>, httpd’nin IPv6
soketleri ayırmasını mümkün kılarak IPv6’yı desteklemekte ve IPv6
üzerinden gönderilmiş istekleri elde etmektedir.</p>
<p>httpd yöneticilerinin kafasını karıştırıran tek şey IPv6 soketlerin
hem IPv4 hem de IPv6 bağlantılarını kabul edip etmeyeceğidir. IPv4
bağlantılarını kabul eden IPv6 soketleri IPv4 eşlemli IPv6 adresleri
kullanırlar. Bu çoğu sistemde öntanımlı olarak böyleyken, FreeBSD,
NetBSD ve OpenBSD’de sistem geneline uygulanan kurallar gereğince
öntanımlı olarak buna izin verilmez; bu sistemlerde özel bir
<code class="program"><a href="./programs/configure.html">configure</a></code> parametresi ile <code>httpd</code>’nin
davranışı değiştirilebilir.</p>
<p>Diğer taraftan, Linux ve Tru64 gibi bazı platformlarda hem IPv4 hem de
IPv6 adresleri kabul etmenin <strong>tek yolu</strong> eşlemli adresler
kullanmaktır. <code>httpd</code>’nin IPv4 ve IPv6 adresleri, IPv4 eşlemli
IPv6 adreslerin kullanımını gerektiren en az sayıda soketle kabul etmesini
istiyorsanız, <code class="program"><a href="./programs/configure.html">configure</a></code> betiğine
<code>--enable-v4-mapped</code> seçeneğini belirtiniz.</p>
<p><code>--enable-v4-mapped</code> seçeneği, FreeBSD, NetBSD ve OpenBSD
hariç tüm platformlarda öntanımlıdır. Muhtemelen siz de
<code>httpd</code>’nin böyle derlenmesini isterdiniz.</p>
<p>Platformunuzun ve APR’nin neyi desteklediğine bakmaksızın
<code>httpd</code>’nin sadece IPv4 adresleri kabul etmesini istiyorsanız,
tüm <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergelerinde
örnekteki gibi IPv4 adresleri belirtiniz:</p>
<div class="example"><pre class="prettyprint lang-config">Listen 0.0.0.0:80
Listen 192.0.2.1:80</pre>
</div>
<p>Platformunuz IPv4 ve IPv6 adresleri ayrı soketlerden kabul ediyorsa ve
<code>httpd</code>’nin de buna uygun davranmasını (yani IPv4 eşlemli IPv6
adreslerin iptalini) istiyorsanız <code class="program"><a href="./programs/configure.html">configure</a></code>
betiğine <code>--disable-v4-mapped</code> seçeneğini belirtiniz. Bu
seçenek FreeBSD, NetBSD ve OpenBSD’de öntanımlıdır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="protocol" id="protocol">Protokolü Listen ile Belirtme</a></h2>
<p><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergesinin isteğe
bağlı ikinci değiştirgesi <var>protokol</var> çoğu yapılandırmada gerekli
olmaz. Belirtilmediği takdirde, <code>https</code> için 443,
<code>http</code> için ise diğer bütün portlar öntanımlıdır. Protokol,
isteğin hangi modül tarafından işleneceğini ve <code class="directive"><a href="./mod/core.html#acceptfilter">AcceptFilter</a></code> yönergesi ile uygulanacak
protokole özgü en iyilemeleri belirlemekte kullanılır.</p>
<p>Sadece standartdışı bir port kullanmak isterseniz protokolü belirtmeniz
gerekir. Örneğin, bir<code>https</code> sitesini port 8443 üzerinde
çalıştırmak isterseniz:</p>
<div class="example"><pre class="prettyprint lang-config">Listen 192.170.2.1:8443 https</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">Sanal Konaklarla Nasıl Çalışır?</a></h2>
<p><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergesi sanal
konaklar için gerçeklenmemiştir; sadece ana sunucuya hangi adresleri ve
portları dinleyeceğini söyler. Hiç <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> yönergesi kullanılmamışsa sunucu
kabul edilen tüm isteklere aynı şekilde davranacaktır. Eğer bir veya
daha fazla adres ve port için farklı bir davranış belirtmek
istiyorsanız <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> kullanabilirsiniz. Bir sanal
konağı gerçeklemek için önce sunucunun sanal konak için kullanacağı
adres ve portu dinleyeceğini belirtmek gerekir. Bundan sonra bu sanal
konağın davranışını ayarlamak üzere belirtilen adres ve port için bir
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> bölümü
oluşturulmalıdır. Yalnız dikkat edin, eğer <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> için belirtilen adres ve port
sunucu tarafından dinlenmiyorsa ona erişemezsiniz.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/bind.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/bind.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/dso.html 0000664 0001751 0001751 00000000701 13710016232 016473 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: dso.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: dso.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: dso.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: dso.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: dso.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/configuring.html.tr.utf8 0000664 0001751 0001751 00000045103 14743132254 021550 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Yapılandırma Dosyaları - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Yapılandırma Dosyaları</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/configuring.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belgede Apache HTTP Sunucusunu yapılandırmakta kullanılan dosyalar
açıklanmıştır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#main">Ana Yapılandırma Dosyaları</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#syntax">Yapılandırma Dosyalarının Sözdizimi</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Modüller</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#scope">Yönergelerin Etki Alanı</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#htaccess">.htaccess Dosyaları</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="main" id="main">Ana Yapılandırma Dosyaları</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#include">Include</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code></li></ul></td></tr></table>
<p>Apache HTTP Sunucusu düz metin yapılandırma dosyalarına <a href="mod/directives.html">yönergeler</a> yerleştirilerek yapılandırılır.
Ana yapılandırma dosyasının ismi normalde <code>httpd.conf</code>’tur.
Bu dosyanın yeri derleme sırasında belirlenir, ancak çalıştırma
sırasında <code>-f</code> komut satırı seçeneği ile başka bir yer
belirtilebilir. Ayrıca, <code class="directive"><a href="./mod/core.html#include">Include</a></code>
yönergesi kullanılarak başka yapılandırma dosyaları da eklenebilir
ve bu dosyaların isimleri belirtilirken dosya ismi şablonları
kullanılabilir. Bu dosyaların içine de ana yapılandırma dosyasında
olduğu gibi her türlü yönerge yerleştirilebilir. Ana yapılandırma
dosyalarındaki değişiklikler httpd tarafından sadece başlatma veya
yeniden başlatma sırasında etkin kılınır.</p>
<p>Sunucu ayrıca MIME belge türlerini içeren bir dosya daha okur;
dosya ismi öntanımlı olarak <code>mime.types</code> olup <code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code> yönergesi ile başka bir dosya
belirtilebilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="syntax" id="syntax">Yapılandırma Dosyalarının Sözdizimi</a></h2>
<p>httpd yapılandırma dosyalarının her satırında sadece bir yönerge
bulunur ve bir yönergenin birden fazla satıra yayılması daha iyi
olacaksa satır katlanabilir; devamı bir alt satırda olan her satırın
son karakteri “\” (tersbölü) olmalı, satırsonu karakteri ile bu tersbölü
karakteri arasında başka karakter bulunmamalıdır.</p>
<p>Yönergelerdeki değiştirgeler boşluklarla ayrılır. Eğer bir değiştirge
kendi içinde boşluklar içeriyorsa tırnak içine alınır.</p>
<p>Yapılandırma dosyalarındaki yönergelerin isimleri harf büyüklüğüne
duyarlı olduğu halde argümanları genellikle harf büyüklüğüne duyarlı
değildir. Diyez (“#”) karakteri ile başlayan satırlar açıklama olarak
ele alınır ve yok sayılırlar. Yapılandırma yönergesi içeren satırlara
açıklama yerleştirilemez. Yönerge isminden önce yer alan boşluklar
yoksayılır; bu özellik, okunabilirliği sağlamak için yönergelerin
girintilenebilmesi olanağını verir. Ayrıca, boş satırlar da
yoksayılır.</p>
<p><code class="directive"><a href="./mod/core.html#define">Define</a></code> ile veya kabuğun ortam
değişkenleri ile tanımlanmış değişkenlerin değerleri, yapılandırma
dosyasının satırlarında <code>${VAR}</code> sözdizimi ile kullanılabilir.
"VAR" geçerli bir değişkenin adı olduğu takdirde, bu değişkenin değeri
yapılandırma dosyasının bu noktasında yerine konacak ve orada zaten
değişken yerine değeri varmış gibi işlem kaldığı yerden devam edecektir.
<code class="directive"><a href="./mod/core.html#define">Define</a></code> ile tanımlanmış değişkenler
kabuğun ortam değişkenlerinden önceliklidir. "VAR" diye bir değişken yoksa
<code>${VAR}</code> içindeki karakterler değişmeden kalır ve günlüğe bir
uyarı çıktılanır. <code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
sözdizimi ile olası bir karışıklığı önlemek için, değişken isimleri iki
nokta imini (":") içeremez.</p>
<p>Kabuğun ortam değişkenlerinin, sadece, sunucu başlatılmadan önce
tanımlanmış değerleri kullanılabilir. Yapılandırma dosyasının kendisinde
tanımlanmış ortam değişkenleri (örneğin,
<code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> ile), yapılandırma
dosyasındaki işlemlerde çok daha sonra yer alır.</p>
<p>Yapılandırma dosyasındaki bir satırın uzunluğu, değişken ikamesi
yapıldıkta, devam satırları eklenditen sonra en fazla 16MiB olabilir. <a href="configuring.html#htaccess">.htaccess dosyalarında</a> azami uzunluk
8190 karakterdir.</p>
<p>Sunucuyu başlatmadan önce <code>apachectl configtest</code> ile veya
<code>-t</code> komut satırı seçeneği ile yapılandırma dosyalarınızı
sözdizimi hatalarına karşı sınayabilirsiniz.</p>
<p>Eşleşmeyen <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>
ve <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> bölümleri
kaldırılmış, tüm açıklamalar, çözümlenmiş ortam değişkenleri ve içerilmiş
tüm dosyalar dahil yapılandırmanın bir dökümünü almak için
<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>'nun <code>-DDUMP_CONFIG</code> seçeneğini
kullanabilirsiniz. Ancak, çıktı yinelenen yönergeler için katıştırılan veya
geçersiz kılınanları yansıtmayacaktır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="modules" id="modules">Modüller</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>httpd modüler yapıda bir sunucudur. Bu, çekirdek sunucunun sadece en
temel işlevselliği içermesi demektir. Ek özellikler, httpd’ye <a href="mod/">modüller</a> halinde yüklenebilir. Öntanımlı olarak, derleme
sırasında sunucunun <a href="mod/module-dict.html#Status">temel</a> bir
modül kümesi içermesi sağlanır. Eğer sunucu <a href="dso.html">devingen
yüklenen</a> modülleri kullanmak üzere yapılandırılarak derlenirse modüller
ayrı olarak derlenip gerektiği zaman <code class="directive"><a href="./mod/mod_so.html#loadmodule">
LoadModule</a></code> yönergesi kullanılarak yüklenebilir. Aksi takdirde,
ek modülleri yükleyebilmek veya kaldırabilmek için httpd’nin yeniden
derlenmesi gerekir. Yapılandırma yönergeleri belli bir modülün varlığına
dayalı olarak bir <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>
bloku içine alınmak suretiyle sunucuya koşullu olarak eklenebilir. Ancak,
<code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> yönergeleri
gerekli değildir, önemli bir modülün yokluğu gibi durumlarda
maskelenebilir.</p>
<p>Sunucunun içinde derlenmiş modüllerin listesini görmek için
<code>-l</code> komut satırı seçeneğini kullanabilirsiniz. Ayrıca,
<code>-M</code> komut satırı seçeneği ile hangi modüllerin devingen olarak
yüklendiğini görebilirsiniz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="scope" id="scope">Yönergelerin Etki Alanı</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>Ana yapılandırma dosyasına yerleştirilen yönergeler sunucunun tamamına
uygulanır. Yapılandırmanızı sunucunun belli bir parçası için değiştirmek
isterseniz yönergelerinizi <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#files"><Files></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code> ve <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> bölümleri içine yerleştirerek etki
alanlarını değiştirebilirsiniz. Bu bölümler yönergelerin etkilediği
alanları dosya sistemininin belli yerleri veya belli URL’lerle sınırlar.
Yerine göre daha hassas ayarlamalar yapmak için bu bölgeler iç içe de
kullanılabilir.</p>
<p>httpd, çok sayıda farklı siteyi aynı anda sunabilecek yetenektedir.
Buna <a href="vhosts/">Sanal Konaklık</a> adı verilir. Yönergelerin etki
alanları ayrıca <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
bölümleri içine konarak da değiştirilebilir. Böylece belli bir siteye gelen
isteklere farklı bir uygulama yapılabilir.</p>
<p>Yönergelerin çoğu bu bölümlere yerleştirilebilirse de bazı yönergelerin
bazı bağlamlarda bir etkisi olmaz. Örneğin, süreç oluşturmayı denetleyen
yönergeler sadece ana sunucu bağlamına yerleştirilebilir. Hangi yönergenin
hangi bağlama yerleştirilebileceğini bulmak için yönergenin <a href="mod/directive-dict.html#Context">bağlamına</a> bakınız. Bu konuda daha
ayrıntılı bilgi edinmek için: <a href="sections.html">Directory, Location ve
Files Bölümleri Nasıl Çalışır</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="htaccess" id="htaccess">.htaccess Dosyaları</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
<p>httpd yapılandırma sorumluluğunu dağıtmak için site ağaçları içine özel
dosyalar yerleştirilmesine izin verir. Bu özel dosyalar normalde
<code>.htaccess</code> dosyaları olmakla birlikte <code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code> yönergesi kullanılarak rasgele bir isim
belirtilebilir. <code>.htaccess</code> dosyalarına yerleştirilen yönergeler
sadece dosyanın bulunduğu dizine ve alt dizinlerine uygulanır.
<code>.htaccess</code> dosyalarında da ana yapılandırma dosyalarında geçerli
sözdizimi kullanılır. <code>.htaccess</code> dosyaları her istek gelişinde
yeniden okunduğundan bu dosyalarda yapılan değişiklikler hemen etkisini
gösterir.</p>
<p><code>.htaccess</code> dosyalarına hangi yönergelerin
yerleştirilebileceğini bulmak için yönerge <a href="mod/directive-dict.html#Context">bağlamına</a> bakınız.
Sunucunun yöneticisi <code>.htaccess</code> dosyalarına hangi yönergelerin
yerleştirilebileceğini ana yapılandırma dosyalarında
<code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> yönergesini kullanarak
belirleyebilir.</p>
<p><code>.htaccess</code> dosyaları hakkında daha ayrıntılı bilgi edinmek
için <a href="howto/htaccess.html">.htaccess öğreticisi</a>ne bakabilirsiniz.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/configuring.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/configuring.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/custom-error.html.es 0000664 0001751 0001751 00000032462 14743132254 021000 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Respuestas de error personalizadas - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="./images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="./">Versión 2.4</a></div><div id="page-content"><div id="preamble"><h1>Respuestas de error personalizadas</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Apache ofrece la posibilidad de que los webmasters puedan
configurar las respuestas que muestra el servidor Apache cuando se
producen algunos errores o problemas.</p>
<p>Las respuestas personalizadas pueden definirse para activarse
en caso de que el servidor detecte un error o problema.</p>
<p>Si un script termina de forma anormal y se produce una respuesta
"500 Server Error", esta respuesta puede ser sustituida por otro
texto de su elección o por una redirección a otra URL
(local o externa).</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#behavior">Comportamiento</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuración</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#custom">Mesajes de error personalizados y redirecciones</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</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="behavior" id="behavior">Comportamiento</a></h2>
<h3>Comportamiento anterior</h3>
<p>NCSA httpd 1.3 devolvía mensajes antiguos del error o
problema encontrado que con frecuencia no tenían
significado alguno para el usuario, y que no incluían en
los logs información que diera pistas sobre las causas de
lo sucedido.</p>
<h3>Comportamiento actual</h3>
<p>Se puede hacer que el servidor siga uno de los siguientes
comportamientos:</p>
<ol>
<li>Desplegar un texto diferente, en lugar de los mensajes de
la NCSA, o</li>
<li>redireccionar la petición a una URL local, o</li>
<li>redireccionar la petición a una URL externa.</li>
</ol>
<p>Redireccionar a otra URL puede resultar de utilidad, pero
solo si con ello se puede también pasar alguna
información que pueda explicar el error o problema y/o
registrarlo en el log correspondiente más claramente.</p>
<p>Para conseguir esto, Apache define ahora variables de entorno
similares a las de los CGI:</p>
<div class="example"><p><code>
REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap,
image/jpeg<br />
REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05
9000/712)<br />
REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br />
REDIRECT_QUERY_STRING=<br />
REDIRECT_REMOTE_ADDR=121.345.78.123<br />
REDIRECT_REMOTE_HOST=ooh.ahhh.com<br />
REDIRECT_SERVER_NAME=crash.bang.edu<br />
REDIRECT_SERVER_PORT=80<br />
REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />
REDIRECT_URL=/cgi-bin/buggy.pl
</code></p></div>
<p>Tenga en cuenta el prefijo <code>REDIRECT_</code>.</p>
<p>Al menos <code>REDIRECT_URL</code> y
<code>REDIRECT_QUERY_STRING</code> se pasarán a la nueva
URL (asumiendo que es un cgi-script o un cgi-include). Las otras
variables existirán solo si existían antes de aparecer
el error o problema. <strong>Ninguna</strong> de estas variables
se creará si en la directiva <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> ha especificado una
redirección <em>externa</em> (cualquier cosa que empiece
por un nombre de esquema del tipo <code>http:</code>, incluso si
se refiere al mismo servidor).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuration" id="configuration">Configuración</a></h2>
<p>El uso de <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
está activado para los ficheros .htaccess cuando <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> tiene el valor
adecuado.</p>
<p>Aquí hay algunos ejemplos más...</p>
<div class="example"><p><code>
ErrorDocument 500 /cgi-bin/crash-recover <br />
ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />
ErrorDocument 500 http://xxx/ <br />
ErrorDocument 404 /Lame_excuses/not_found.html <br />
ErrorDocument 401 /Subscription/how_to_subscribe.html
</code></p></div>
<p>La sintaxis es,</p>
<div class="example"><p><code>
ErrorDocument <3-digit-code> <action>
</code></p></div>
<p>donde action puede ser,</p>
<ol>
<li>Texto a mostrar. Ponga antes del texto que quiere que se
muestre unas comillas ("). Lo que sea que siga a las comillas se
mostrará. <em>Nota: las comillas (") no se
muestran.</em></li>
<li>Una URL local a la que se redireccionará la
petición.</li>
<li>Una URL externa a la que se redireccionará la
petición.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="custom" id="custom">Mesajes de error personalizados y redirecciones</a></h2>
<p>El comportamiento de Apache en cuanto a las redirecciones ha
cambiado para que puedan usarse más variables de entorno con
los script/server-include.</p>
<h3>Antiguo comportamiento</h3>
<p>Las variables CGI estándar estaban disponibles para el
script al que se hacía la redirección. No se incluía
ninguna indicación sobre la precedencia de la
redirección.</p>
<h3>Nuevo comportamiento</h3>
<p>Un nuevo grupo de variables de entorno se inicializa para que
las use el script al que ha sido redireccionado. Cada
nueva variable tendrá el prefijo <code>REDIRECT_</code>.
Las variables de entorno <code>REDIRECT_</code> se crean a
partir de de las variables de entorno CGI que existen antes de
la redirección, se les cambia el nombre
añadiéndoles el prefijo <code>REDIRECT_</code>, por
ejemplo, <code>HTTP_USER_AGENT</code> pasa a ser
<code>REDIRECT_HTTP_USER_AGENT</code>. Además, para esas
nuevas variables, Apache definirá <code>REDIRECT_URL</code>
y <code>REDIRECT_STATUS</code> para ayudar al script a seguir su
origen. Tanto la URL original como la URL a la que es redirigida
la petición pueden almacenarse en los logs de acceso.</p>
<p>Si ErrorDocument especifica una redirección local a un
script CGI, el script debe incluir una campo de cabeceraa
"<code>Status:</code>" en el resultado final para asegurar que
es posible hacer llegar al cliente de vuelta la condición
de error que lo provocó. Por ejemplo, un script en Perl
para usar con ErrorDocument podría incluir lo
siguiente:</p>
<div class="example"><p><code>
... <br />
print "Content-type: text/html\n"; <br />
printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
...
</code></p></div>
<p>Si el script tiene como fin tratar una determinada
condición de error, por ejemplo
<code>404 Not Found</code>, se pueden usar los
códigos de error y textos específicos en su lugar.</p>
<p>Tenga en cuenta que el script <em>debe</em> incluir un campo
de cabecera <code>Status:</code> apropiado (como
<code>302 Found</code>), si la respuesta contiene un campo de
cabecera <code>Location:</code> (para poder enviar una
redirección que se interprete en el cliente). De otra
manera, la cabecera
<code>Location:</code> puede que no tenga efecto.</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/custom-error.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/bind.html.ja.utf8 0000664 0001751 0001751 00000034530 14743132254 020121 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>バインド - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>バインド</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/bind.html" title="Japanese"> ja </a> |
<a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/bind.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>Apache が使用するアドレスとポートの設定をします。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">概要</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ipv6">IPv6 の特記事項</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">バーチャルホストに対してどう働くのか</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="vhosts/">バーチャルホスト</a></li><li><a href="dns-caveats.html">DNS の問題</a></li><li><a href="#comments_section">コメント</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="overview" id="overview">概要</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mpm_common.html">mpm_common</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table>
<p>Apache は起動時に、ローカルマシンのあるポートおよびアドレス
に対して接続し、リクエストが来るのを待ちます。
デフォルトではマシンのすべてのアドレスに対して Listen します。
特定のポートか、特定のアドレスのみか、
またはそれらの組み合わせで Listen するように指定したい場合もあります。
異なる IP アドレス、ホスト名、ポートに対して Apache がどのように
応答するかを制御するバーチャルホスト機能と組み合わせてよく使われます。</p>
<p><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
ディレクティブで、特定のポートやアドレス・ポートの組から入ってくる
リクエストのみを受け付けるようにできます。
もしポート番号だけが <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
ディレクティブで指定された場合は、
すべてのインターフェースの与えられたポート番号に対して
Listen します。 IP アドレスとポート番号とが同時に与えられた場合は、
サーバは与えられたインターフェースのポートを Listen します。
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> ディレクティブを複数使って
Listen するアドレスとポートをいくつも指定できます。
サーバは指定されたアドレスやポートからのリクエストすべてに
対して応答します。</p>
<p>たとえば、全てのインターフェースのポート 80 と 8000 の両方において
接続を受け付けるには</p>
<div class="example"><p><code>
Listen 80<br />
Listen 8000
</code></p></div>
<p>とします。
あるインターフェースでは 80 番で、また、同時に他のインターフェースの
8000 番ポートで接続を受け付けるには、
</p>
<div class="example"><p><code>
Listen 192.0.2.1:80<br />
Listen 192.0.2.5:8000
</code></p></div>
<p>とします。
IPv6 アドレスは、角括弧で次の例のように囲まなければいけません。</p>
<div class="example"><p><code>
Listen [2001:db8::a00:20ff:fea7:ccea]:80
</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="ipv6" id="ipv6">IPv6 の特記事項</a></h2>
<p>多くのプラットホームで IPv6 がサポートされてきていて、
<a class="glossarylink" href="./glossary.html#apr" title="用語集を参照">APR</a> はこれらのほとんどで IPv6 をサポートしているので、
Apache は IPv6 ソケットを割り当てて IPv6
経由で送られてきたリクエストを扱うことができます。</p>
<p>IPv6 ソケットが IPv4 と IPv6 コネクションの両方を扱うことができるか
どうかは、Apache 管理者にとって厄介な問題です。
IPv4 コネクションを IPv6 ソケットで扱う場合は、
IPv4 マップされた IPv6 アドレスを使用していて、
ほとんどのプラットホームではデフォルトで使用可能ですが、
FreeBSD, NetBSD, OpenBSD では、システム全体としてのポリシーとの整合性から、
デフォルトでは使用不可に設定されています。
これらのデフォルトで使用不可のプラットホームであっても、
特別な <code class="program"><a href="./programs/configure.html">configure</a></code> の
設定パラメータで Apache の挙動を変化させることができます。</p>
<p>一方で、Linux や Tru64 といったプラットホームで IPv4 と IPv6
の両方を扱うには、マップドアドレスを使用する<strong>以外の方法はありません</strong>。
IPv4 と IPv6 のコネクションを最小限のソケットで扱いたいのであれば、
IPv4 マップの IPv6 アドレスを使用する必要があり、
<code>--enable-v4-mapped</code> <code class="program"><a href="./programs/configure.html">configure</a></code>
オプションを指定します。</p>
<p><code>--enable-v4-mapped</code> は、
FreeBSD, NetBSD, OpenBSD 以外の全てのプラットホームでのデフォルトです。
ですから、おそらくお手元の Apache はこの設定でビルドされているでしょう。</p>
<p>プラットフォームや APR が何をサポートするかに関わらず、
IPv4 コネクションのみを扱うようにしたい場合は、
次の例のように全ての
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> ディレクティブで
IPv4 アドレスを指定してください。</p>
<div class="example"><p><code>
Listen 0.0.0.0:80<br />
Listen 192.0.2.1:80
</code></p></div>
<p>条件を満たすプラットホームで、Apache が
IPv4 と IPv6 のコネクションを別々のソケットで扱うようにしたい場合
(つまり IPv4 マップのアドレスを無効にしたい場合)
は、<code>--disable-v4-mapped</code>
<code class="program"><a href="./programs/configure.html">configure</a></code>
オプションを指定して、次のように個別指定の
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
ディレクティブを使用してください。
<code>--disable-v4-mapped</code> は、
FreeBSD, NetBSD, OpenBSD プラットホームでのデフォルトです。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">バーチャルホストに対してどう働くのか</a></h2>
<p><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> ディレクティブ
でバーチャルホストが実装されるわけではありません。
Listen は単にメインサーバにどのアドレスとポートを Listen すべきかを
教えるだけです。
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
ディレクティブが使われない場合は、
受け入れたリクエストすべてに対して全く同じ挙動をします。
しかしながら
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
を使って、
一つ以上のアドレスやポートに対して異なる挙動をするように
指定することができます。
VirtualHost を実装するには、まず初めに使用したいアドレスとポートに対して
サーバが Listen していなければなりません。
そして、その指定したアドレスとポートでの
このバーチャルホストの挙動を設定するために、
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
セクションを作ります。もし
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
が Listen していないアドレスとポートに対して
設定されてしまうと、
それにはアクセスできないということに注意してください。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/bind.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/bind.html" title="Japanese"> ja </a> |
<a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/bind.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/bind.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/configuring.html.ja.utf8 0000664 0001751 0001751 00000041756 14743132254 021527 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>設定ファイル - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>設定ファイル</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/configuring.html" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>この文書では、Apache HTTP サーバを設定するのに使用するファイルについて
記述しています。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#main">メインの設定ファイル</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#syntax">設定ファイルの構文</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">モジュール</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#scope">ディレクティブの適用範囲</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#htaccess">.htaccess ファイル</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="main" id="main">メインの設定ファイル</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#include">Include</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code></li></ul></td></tr></table>
<p>Apache は <a href="mod/directives.html">ディレクティブ</a> を設定ファイルに平文で書くことにより設定します。
メインの設定ファイルは普通は <code>httpd.conf</code> という名前です。
このファイルの位置はコンパイル時に設定されますが、コマンドラインの
<code>-f</code> フラグにより上書きできます。
また、他の設定ファイルを <code class="directive"><a href="./mod/core.html#include">Include</a></code>
ディレクティブによって追加でき、ワイルドカードを使用して多数の
設定ファイルを追加することができます。
どんなディレクティブも、これらの設定ファイルどれにでも入れることができます。
Apache は起動時か再起動時のみメイン設定ファイルの変更を認識します。</p>
<p>サーバは MIME
ドキュメントタイプを含んでいるファイルも読み込みます。ファイル名は
<code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code>
で設定され、デフォルトでは <code>mime.types</code>
になっています。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="syntax" id="syntax">設定ファイルの構文</a></h2>
<p>Apache の設定ファイルは 1 行に 1 つのディレクティブからなります。
バックスラッシュ "\" はディレクティブが次の行に継続していることを
示すために行の最後の文字として使われているかもしれません。
行の最後とバックスラッシュの間に他の文字や空白があってはいけません。
</p>
<p>設定ファイルのディレクティブは大文字小文字を区別しませんが、
引数にはしばしば区別するものがあります。ハッシュ文字 "#"
で始まる行はコメントと見なされて無視されます。
設定ディレクティブと同一行の末尾にコメントが含まれていては<strong>いけません</strong>。ディレクティブの前の空行と空白は無視されますので、
わかりやすくするためにディレクティブをインデントしても構いません。
</p>
<p>設定ファイルの構文エラーは、
<code>apachectl configtest</code>
かコマンドラインオプション
<code>-t</code> を使って調べられます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="modules" id="modules">モジュール</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>Apache はモジュール化されたサーバです。
コアサーバには最も基本的な機能だけが含まれています。拡張機能は
Apache にロードされる<a href="mod/">モジュール</a>として利用可能です。デフォルトでは、コンパイル時にモジュールの
<a href="mod/module-dict.html#Status">Base</a> セット (基本セット) が
サーバに含まれます。サーバが<a href="dso.html">動的ロード</a>モジュールを使うようにコンパイルされている場合は、
モジュールを別にコンパイルして、いつでも
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
ディレクティブを使って追加できます。
そうでない場合は、モジュールの追加や削除をするためには Apache
を再コンパイルする必要があります。設定ディレクティブは <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>
ブロックに入れることで特定のモジュールが存在するときだけ
設定ファイルに含まれるようにすることができます。</p>
<p>コマンドラインオプション <code>-l</code> を使って現時点で
どのモジュールがサーバにコンパイルされているかを知ることができます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="scope" id="scope">ディレクティブの適用範囲</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>メイン設定ファイルにあるディレクティブはサーバ全体に適用されます。
サーバの一部分の設定だけを変更したい場合は <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#files"><Files></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code>, <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>
セクションの中に置くことで適用範囲を決められます。
これらのセクションはその中にあるディレクティブの適用範囲を
特定のファイルシステムの位置や URL に限定します。
非常に細粒度の設定を可能にするために、
セクションを入れ子にすることもできます。</p>
<p>Apache は同時に多くの違うウェブサイトを扱う能力があります。
これは <a href="vhosts/">バーチャルホスト</a> と呼ばれています。
特定のウェブサイトにのみ適用されるようにするために、
ディレクティブは
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
セクションの中に置くことでも適用範囲を変えることができます。</p>
<p>ほとんどのディレクティブはどのセクションにでも書けますが、
中にはコンテキストによっては意味をなさないものもあります。
例えば、プロセスの作成を制御しているディレクティブはメインサーバの
コンテキストにのみ書くことができます。
どのディレクティブをどのセクションに書くことができるかを知るためには
ディレクティブの <a href="mod/directive-dict.html#Context">コンテキスト</a> を調べてください。詳しい情報は、
<a href="sections.html">Directory, Location, Files
セクションの動作法</a>にあります。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="htaccess" id="htaccess">.htaccess ファイル</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
<p>Apache ではウェブツリーの中に置かれた特別なファイルを使って
非中央集権的な設定管理をできます。その特別なファイルは普通は
<code>.htaccess</code> という名前で、
<code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code>
ディレクティブでどんな名前にでも指定できます。
<code>.htaccess</code>
ファイルに書かれたディレクティブはファイルを置いた
ディレクトリとその全てのサブディレクトリに適用されます。
<code>.htaccess</code> ファイルは、メインの設定ファイルと同じ
構文を使います。
<code>.htaccess</code>
ファイルはすべてのリクエストで読み込まれるため、
変更はすぐに反映されます。</p>
<p>どのディレクティブが <code>.htaccess</code>
ファイルに書けるかを調べるには、ディレクティブの<a href="mod/directive-dict.html#Context">コンテキスト</a>
を調べてください。サーバ管理者はさらにメイン設定ファイルの
<code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
を設定することでどのディレクティブを <code>.htaccess</code>
ファイルに書けるようにするかを制御することができます。</p>
<p><code>.htaccess</code> ファイルに関する詳しい情報は
<a href="howto/htaccess.html">.htaccess チュートリアル</a>
を参照してください。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/configuring.html" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/configuring.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/content-negotiation.html.ko.euc-kr 0000664 0001751 0001751 00000070750 14743132254 023520 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title> (Content Negotiation) - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1> (Content Negotiation)</h1>
<div class="toplang">
<p><span> : </span><a href="./en/content-negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/content-negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>ġ HTTP/1.1 Ծ (content
negotiation) Ѵ. media type, , ,
ڵ ȣ ڿ
ǥ Ѵ. ҿ
û óϴ ɵ ִ.</p>
<p>⺻ ϵǴ <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>
Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#about"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#negotiation">ġ </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#methods"></a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#better">ǰ ϱ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extensions">ڿ(transparent) Ȯ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#naming">۸ũ ̸Ģ Ͽ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#caching">ij Ͽ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="about" id="about"> </a></h2>
<p>ڿ ٸ ǥ ִ. , ٸ
ٸ media type Ȥ ΰ ٸ ǥ
ִ. ǥ ϴ Ѱ ڿ
ְ ϰ ϴ ̴.
ڵ ϴ ͵ ϴ. ̴ û
Ϻη ȣϴ ǥ
ϴ. , Ҿ,
ٸ ʹٰ ˷ ִ.
û ȣ Ÿ. Ҿε ǥ
ûѴٸ .</p>
<div class="example"><p><code>Accept-Language: fr</code></p></div>
<p>̷ ȣ ǥ ٸ 쿡 ȴ.</p>
<p> û Ҿ
, Ҿ ȣϰ, media type
, Ϲ ؽƮ ٴ HTML, ٸ media type ٴ
GIF JPEG ȣѴٰ ˷ش.</p>
<div class="example"><p><code>
Accept-Language: fr; q=1.0, en; q=0.5<br />
Accept: text/html; q=1.0, text/*; q=0.8, image/gif; q=0.6, image/jpeg; q=0.6, image/*; q=0.5, */*; q=0.1
</code></p></div>
<p>ġ HTTP/1.1 Ծ ǵ ' ֵ(server driven)'
Ѵ. ġ <code>Accept</code>,
<code>Accept-Language</code>, <code>Accept-Charset</code>,
<code>Accept-Encoding</code> û Ѵ.
, ġ RFC 2295 RFC 2296 ǵ
'ڿ(transparent)' û Ѵ.
RFC ǵ ' (feature negotiation)'
ʴ´.</p>
<p><strong>ڿ(resource)</strong> (RFC 2396) URI ϴ
. ġ ڿ
<strong>ǥ(representations)</strong> Ѵ. ǥ
media type, , ڵ Ʈ
ִ. ڿ ǥ (δ ִ) ȴ.
ڿ ǥ ִٸ ڿ
<strong>ϴٰ(negotiable)</strong> θ, ̶
ǥ <strong>(variant)</strong>̶ Ѵ.
ڿ
<strong>(dimension)</strong> Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="negotiation" id="negotiation">ġ </a></h2>
<p>ڿ ϱ ʿϴ.
ΰ ϳ ´:</p>
<ul>
<li> ϵ type map (<em>
</em>, <code>*.var</code> ) ϰų,</li>
<li> ʾƵ ϸ Ģ ãƼ
ϴ 'MultiViews' Ѵ.</li>
</ul>
<h3><a name="type-map" id="type-map">type-map ϱ</a></h3>
<p>type map <code>type-map</code>̶ ڵ鷯
(Ȥ ġ ȣȯ MIME type
<code>application/x-type-map</code>) .
Ϸ <code>type-map</code> ڵ鷯
Ȯڸ ؾ Ѵ. Ͽ
ϴ .</p>
<div class="example"><p><code>AddHandler type-map .var</code></p></div>
<p>Type map شϴ ڿ ̸ ƾ ϰ,
־ Ѵ. HTTP
ٷ ȴ. ٷ
Ѵ. ȿ . (̷
ʿ䰡 , ־ )
ִ map ϴ ̴.
map . ̸ <code>foo.var</code>,
<code>foo</code> ڿ Ѵ.</p>
<div class="example"><p><code>
URI: foo<br />
<br />
URI: foo.en.html<br />
Content-type: text/html<br />
Content-language: en<br />
<br />
URI: foo.fr.de.html<br />
Content-type: text/html;charset=iso-8859-2<br />
Content-language: fr, de<br />
</code></p></div>
<p>typemap ϸ Ȯ , Multiviews
Ͽ, 켱 ϶. ٸ ǰ
ٸ, (JPEG, GIF, ASCII-art شϴ)
media type "qs" Ķͷ ǰ(source quality) ǥ
ִ:</p>
<div class="example"><p><code>
URI: foo<br />
<br />
URI: foo.jpeg<br />
Content-type: image/jpeg; qs=0.8<br />
<br />
URI: foo.gif<br />
Content-type: image/gif; qs=0.5<br />
<br />
URI: foo.txt<br />
Content-type: text/plain; qs=0.01<br />
</code></p></div>
<p>qs 0.000 1.000 ̴. qs 0.000
õ ϶. 'qs' 1.0
ȴ. qs Ŭ̾Ʈ ɷ° ٸ
Ͽ 'ǰ' Ÿ. ,
Ÿ JPEG ASCII Ϻٴ
ǰ . ڿ ASCII artٸ
ASCII ǥ JPEG ǥ ǰ ִ.
Ƿ qs ǥϷ ڿ
ٸ.</p>
<p>ϴ <a href="mod/mod_negotiation.html#typemaps">mod_negotation
typemap</a> ϶.</p>
<h3><a name="multiviews" id="multiviews">Multiviews</a></h3>
<p><code>MultiViews</code> 丮 ɼ̹Ƿ,
<code>httpd.conf</code>
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>
Ȥ (<code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
Ǿٸ) <code>.htaccess</code>
<code class="directive"><a href="./mod/core.html#options">Options</a></code> þ
ִ. <code>Options All</code> <code>MultiViews</code>
϶. Ѵ.</p>
<p><code>MultiViews</code> ϸ Ͼ:
<code>/some/dir/foo</code> û ް
<code>/some/dir/foo</code> <code>MultiViews</code> ϸ
<code>/some/dir/foo</code> <em></em> ,
丮 ̸ foo.* ϵ ϴ
type map . Ŭ̾Ʈ û media type
content-encoding ߿ Ѵ.</p>
<p><code>MultiViews</code> 丮 Ҷ
ã <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> þ
ȴ. ٸ,</p>
<div class="example"><p><code>DirectoryIndex index</code></p></div>
<p><code>index.html</code> <code>index.html3</code>
ִٸ ̵ ߿ ϳ Ѵ.
<code>index.cgi</code> ִٸ, װ Ѵ.</p>
<p>丮 ϳ Charset, Content-Type,
Language, Encoding Ǵϴ <code>mod_mime</code>
Ȯڸ ٸ, <code class="directive"><a href="./mod/mod_mime.html#multiviewsmatch">MultiViewsMatch</a></code> þ
Ǵ. þ ڵ鷯, , ٸ Ȯ MultiViews
θ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="methods" id="methods"></a></h2>
<p>ġ type-map ̳ 丮 ִ ϸ
־ ڿ ԵǸ ''
ϱ ϳ Ѵ. ġ
ϱ Ȯ Ͼ ڼ
ʿ . ñ Ѵ.</p>
<p>ΰ ִ:</p>
<ol>
<li><strong>ġ ˰ Ͽ ֵϴ
</strong> Ϲ 쿡 Ѵ. ġ ˰
Ʒ ڼ Ѵ. ˰ ϸ ġ
Ư
ǰ(quality factor) 'Ѵ'. ġ ǰ
ϴ Ʒ ڼ Ѵ.</li>
<li><strong>ڿ(Transparent) </strong>
RFC 2295 ǵ û 쿡
Ѵ. ''
οѴ. ˰
ȴ. ڿ ߿ ġ
RFC 2296 ǵ ' ˰(remote variant
selection algorithm)' û ִ.</li>
</ol>
<h3><a name="dimensions" id="dimensions"> </a></h3>
<table>
<tr valign="top">
<th></th>
<th></th>
</tr>
<tr valign="top">
<td>Media Type</td>
<td> <code>Accept</code> ȣ Ÿ.
ǰ ִ. ǰ
("qs" Ķ) ִ.</td>
</tr>
<tr valign="top">
<td>Language</td>
<td> <code>Accept-Language</code> ȣ
Ÿ. ǰ ִ.
(Ȥ ƹ ) ִ.</td>
</tr>
<tr valign="top">
<td>Encoding</td>
<td> <code>Accept-Encoding</code> ȣ
Ÿ. ǰ ִ.</td>
</tr>
<tr valign="top">
<td>Charset</td>
<td> <code>Accept-Charset</code> ȣ
Ÿ. ǰ ִ.
media type Ķͷ Ÿ ִ.</td>
</tr>
</table>
<h3><a name="algorithm" id="algorithm">ġ ˰</a></h3>
<p>ġ '' (ִٸ)
ϱ Ʒ ˰ Ѵ. ˰
. Ѵ:</p>
<ol>
<li>, شϴ <em>Accept*</em>
˻ϰ, ǰ ű.
<em>Accept*</em> Ƶ ʴ ĺ
Ѵ. 4 ܰ .</li>
<li>
ĺ ϳ Ͽ '' ã´.
˻ Ͼ. ˻翡 õ
ܵȴ. ˻ ̸
ϰ 3 ܰ .
˻縦 Ѵ.
<ol>
<li><code>Accept</code> ǰ
media type ǰ Ͽ
Ѵ.</li>
<li> (language) ǰ
Ѵ.</li>
<li><code>Accept-Language</code> (ִٸ)
Ȥ <code>LanguagePriority</code>
þ (ִٸ)
Ѵ.</li>
<li> (text/html media type Ÿ)
'level' media Ķ Ѵ.</li>
<li><code>Accept-Charset</code>
charset media Ķ ã´.
ٸ ISO-8859-1 ȣѴ.
<code>text/*</code> media type
Ư հ ISO-8859-1
Ѵ.</li>
<li>ISO-8859-1 <em>ƴ</em> charset media Ķ
Ѵ. ٸ,
Ѵ.</li>
<li> ڵ Ѵ.
user-agent ڵ ִٸ
Ѵ. ʰ ڵ ڵȵ
ִٸ ڵȵ Ѵ.
ڵǾų ڵȵ
Ѵ.</li>
<li>content length Ѵ.</li>
<li> ù Ѵ. ̴ type-map
տ ų, 丮
ϸ ASCII ڵ Ͽ տ ̴.</li>
</ol>
</li>
<li> ˰ '' ߴ. ̰
. HTTP <code>Vary</code>
Ÿ ȴ. ( ij ڿ ijҶ
ִ.) .</li>
<li> ܰ迡 ߴٸ ( ϱ )
ȵ . ("No acceptable
representation" ϴ) 406 밡
HTML . , HTML
<code>Vary</code> Ÿ.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="better" id="better">ǰ ϱ</a></h2>
<p>ġ ġ ˰ Űʰ
ǰ Ѵ. ϰ Ȯ ʴ
(˰) ؼ.
θ ̴ Ϻδ ߸ ϵ
<code>Accept</code> . ϰ ùٸ
ٸ, ʴ´.</p>
<h3><a name="wildcards" id="wildcards">Media Type ϵī</a></h3>
<p><code>Accept:</code> û media type ȣ
Ÿ. , * ڿ̶ ϱ "image/*"
"*/*" 'ϵī' media type ִ.
û:</p>
<div class="example"><p><code>Accept: image/*, */*</code></p></div>
<p>"image/" ϴ type ٸ type
ǹѴ.
ڽ ٷ ִ type ߰ ϵī带 .
:</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*
</code></p></div>
<p> type ȣ ٸ ǥ ִٸ
װ͵ Ÿ ؼ.
ǰ ̴.</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*; q=0.01
</code></p></div>
<p> type ǰ ⺻ ( )
1.0 . ϵī */* ȣ 0.01 Ƿ
type ´ 쿡 ٸ type
ȴ.</p>
<p><code>Accept:</code> q <em></em>
"*/*" ִٸ, ġ ٶ ൿ q 0.01
Ѵ. , "type/*" ϵī忡 ("*/*"ٴ
ȣϵ) 0.02 Ѵ. <code>Accept:</code>
q media type ִٸ ̷ Ư ߰
<em>ʴ´</em>.
û ûѵ óѴ.</p>
<h3><a name="exceptions" id="exceptions">(language) </a></h3>
<p>ġ 2.0 ε巴 ϱ
˰ ܸ ߰ߴ.</p>
<p>Ŭ̾Ʈ û
<code>Accept-language</code> ´ Ѱ
ã , Ŭ̾Ʈ
"No Acceptable Variant" "Multiple Choices" .
̷ ϱ <code>Accept-language</code>
ϰ Ŭ̾Ʈ û Ȯ
ġ ִ. <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code>
þ ̷ ϳ Ȥ Ѵٸ ϰ
<code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>
þ Ǵϵ Ѵ.</p>
<p>, ´ ã θ ã
ִ. Ŭ̾Ʈ ϴ
<code>en-GB</code> û , HTTP/1.1 ǥؿ
<code>en</code>θ ǥõ Ϲ
Ѵ. ( ϴ ڰ Ϲ
Ƿ <code>Accept-Language</code>
<code>en-GB</code> ϰ <code>en</code>
Ȯ ߸ ϶.
Ŭ̾Ʈ ̷ ⺻ִ.) ٸ
ã Ͽ "No Acceptable Variants" ų
<code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>
ư Ѵٸ, Ծ ϰ
<code>en-GB</code> <code>en</code> Ѵ.
Ϲ ġ θ ſ ǰ
Ŭ̾Ʈ Ͽ ߰Ѵ. Ŭ̾Ʈ
"en-GB; q=0.9, fr; q=0.8" ûϰ "en" "fr"
ִٸ, "fr" õ ϶. ̴ HTTP/1.1
ǥ Ű, ùٷ Ŭ̾Ʈ ȿ
ϱ̴.</p>
<p>ڰ ȣϴ ˾Ƴ (Ű Ư
URL- ) ϱ ġ 2.0.47
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> <code>prefer-language</code>
<a href="env.html">ȯ溯</a> νѴ. ȯ溯
ϰ ± Ѵٸ,
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> شϴ Ϸ
õѴ. ٸ Ϲ Ѵ.</p>
<div class="example"><h3></h3><p><code>
SetEnvIf Cookie "language=(.+)" prefer-language=$1
</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="extensions" id="extensions">ڿ(transparent) Ȯ</a></h2>
<p>ġ ڿ Ȯ (RFC 2295)
ȮѴ. ο <code>{encoding ..}</code> Ư
content-encoding ĪѴ. RVSA/1.0 ˰
(RFC 2296) Ͽ ڵ ν ְ, ڵ
<code>Accept-Encoding</code> û ´ ڵ
鵵 ĺ ϵ ȮǾ. RVSA/1.0
ã ǰ Ҽ 5ڸ ݿø
ʴ´.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="naming" id="naming">۸ũ ̸Ģ Ͽ</a></h2>
<p>(language) Ѵٸ Ȯڸ
Ȯ Ƿ ϸ ٸ
̸Ģ ִ. (ڼ <a href="mod/mod_mime.html#multipleext">mod_mime</a>
϶.)</p>
<p> MIME-type Ȯ (<em> </em>,
<code>html</code>), 쿡 encoding Ȯ (<em>
</em>, <code>gz</code>), Ͽ ִ
Ȯڸ (<em> </em>, <code>en</code>)
.</p>
<p>:</p>
<ul>
<li>foo.en.html</li>
<li>foo.html.en</li>
<li>foo.en.html.gz</li>
</ul>
<p> ϸ Ͽ ȿϰ ȿ
۸ũ δ:</p>
<table class="bordered">
<tr>
<th>ϸ</th>
<th>ȿ ۸ũ</th>
<th>ȿ ۸ũ</th>
</tr>
<tr>
<td><em>foo.html.en</em></td>
<td>foo<br />
foo.html</td>
<td>-</td>
</tr>
<tr>
<td><em>foo.en.html</em></td>
<td>foo</td>
<td>foo.html</td>
</tr>
<tr>
<td><em>foo.html.en.gz</em></td>
<td>foo<br />
foo.html</td>
<td>foo.gz<br />
foo.html.gz</td>
</tr>
<tr>
<td><em>foo.en.html.gz</em></td>
<td>foo</td>
<td>foo.html<br />
foo.html.gz<br />
foo.gz</td>
</tr>
<tr>
<td><em>foo.gz.html.en</em></td>
<td>foo<br />
foo.gz<br />
foo.gz.html</td>
<td>foo.html</td>
</tr>
<tr>
<td><em>foo.html.gz.en</em></td>
<td>foo<br />
foo.html<br />
foo.html.gz</td>
<td>foo.gz</td>
</tr>
</table>
<p> ǥ ۸ũ Ȯڵ ̸
(<em> </em>, <code>foo</code>)
ִ. ־,
<em> </em> ̷ũ Ͼʰ
<code>html</code> <code>shtml</code>̳
<code>cgi</code> ִٴ ̴.</p>
<p> ۸ũ MIME-type (<em> </em>,
<code>foo.html</code>) ϰ ʹٸ (encoding Ȯڰ
ִٸ ̰͵ Ͽ) Ȯڸ MIME-type Ȯں
ʿ (<em> </em>, <code>foo.html.en</code>)
ξѴ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="caching" id="caching">ij Ͽ</a></h2>
<p>ij ǥ ϸ ǥ û URL Ų.
URL ûϸ ij ǥ Ѵ.
ڿ ù° û
ijǾ û ij ߸ ִ.
̸ ġ ȯǴ û
HTTP/1.0 Ŭ̾Ʈ ij ϵ ǥø Ѵ. , ġ
ij ϴ HTTP/1.1
Ѵ.</p>
<p><code class="directive"><a href="./mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code>
þ HTTP/1.0 ȣȯ Ŭ̾Ʈ( Ȥ ij)
û ij ְ Ѵ. þ
ȣƮ ϸ, ƱԸƮ ʴ´.
þ HTTP/1.1 Ŭ̾Ʈ û 谡 .</p>
<p>HTTP/1.1 Ŭ̾Ʈ ġ
˷ִ <code>Vary</code> HTTP .
Ͽ û ij 纻 ü ִ
Ǵ ִ. ij 纻
Ѵٸ <code>force-no-vary</code> <a href="env.html#special">ȯ溯</a> Ѵ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/content-negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/content-negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/content-negotiation.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/bind.html 0000664 0001751 0001751 00000001032 13710016232 016620 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: bind.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: bind.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: bind.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: bind.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: bind.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: bind.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/custom-error.html.ko.euc-kr 0000664 0001751 0001751 00000027022 14743132254 022163 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title> - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1> </h1>
<div class="toplang">
<p><span> : </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>ʹ ġ
ִ.</p>
<p> ߰
ִ.</p>
<p>ũƮ "500 Server Error" ڿ
ģ ϰų ٸ ( Ʈ ܺ Ʈ)
URL ̷ ִ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#behavior">ൿ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configuration"></a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#custom"> ̷</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="behavior" id="behavior">ൿ</a></h2>
<h3> ൿ</h3>
<p>NCSA httpd 1.3 ڿ ǹϰ
´. α .</p>
<h3>ο ൿ</h3>
<p> ִ:</p>
<ol>
<li>NCSA ٸ ְų</li>
<li> Ʈ URL ̷ϰų</li>
<li>ܺ Ʈ URL ̷Ѵ.</li>
</ol>
<p>ٸ Ʈ URL ̷ϴ ,
ϰų αϴµ ʿ Ϻθ
ȴ.</p>
<p> ϱ ġ CGI ο
ȯ溯 Ѵ:</p>
<div class="example"><p><code>
REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap,
image/jpeg<br />
REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05
9000/712)<br />
REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br />
REDIRECT_QUERY_STRING=<br />
REDIRECT_REMOTE_ADDR=121.345.78.123<br />
REDIRECT_REMOTE_HOST=ooh.ahhh.com<br />
REDIRECT_SERVER_NAME=crash.bang.edu<br />
REDIRECT_SERVER_PORT=80<br />
REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />
REDIRECT_URL=/cgi-bin/buggy.pl
</code></p></div>
<p><code>REDIRECT_</code> λ翡 ָ϶.</p>
<p>ּ <code>REDIRECT_URL</code>
<code>REDIRECT_QUERY_STRING</code> (cgi-script
cgi-include) URL Ѱ. ٸ
ϱ <span class="transnote">(<em>;</em> ̸ <code>REDIRECT_</code>
ȯ溯)</span> 쿡 ִ.
<code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
<em>ܺη</em> ( <code>http:</code>
Ŵ(scheme) Ѵٸ) ̷Ѵٸ
͵ <strong>ʴ´</strong>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuration" id="configuration"></a></h2>
<p><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
Ǿٸ .htaccess Ͽ
<code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
ִ.</p>
<p> ̴...</p>
<div class="example"><p><code>
ErrorDocument 500 /cgi-bin/crash-recover <br />
ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />
ErrorDocument 500 http://xxx/ <br />
ErrorDocument 404 /Lame_excuses/not_found.html <br />
ErrorDocument 401 /Subscription/how_to_subscribe.html
</code></p></div>
<p>,</p>
<div class="example"><p><code>
ErrorDocument <3-digit-code> <action>
</code></p></div>
<p> action,</p>
<ol>
<li> . ǥ (") տ δ. ڿ
ǥ µȴ. <em>: տ ǥ (") µ
ʴ´.</em></li>
<li>̷ ܺ URL.</li>
<li>̷ URL.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="custom" id="custom"> ̷</a></h2>
<p>URL ̷ϴ ġ ൿ
ũƮ/server-include ȯ溯 Ѱֵ Ǿ.</p>
<h3> ൿ</h3>
<p>̷ǵǴ ũƮ ǥ CGI Ѿ.
̷ Ͼ .</p>
<h3>ο ൿ</h3>
<p>̷ǵ ũƮ ο ȯ溯
ִ. տ <code>REDIRECT_</code> پִ.
<code>REDIRECT_</code> ȯ溯 CGI ȯ溯
տ <code>REDIRECT_</code> ٿ . <em>
</em>, <code>HTTP_USER_AGENT</code>
<code>REDIRECT_HTTP_USER_AGENT</code> Ǿ. ̷
߰ ũƮ URL ˵ ġ
<code>REDIRECT_URL</code> <code>REDIRECT_STATUS</code>
Ѵ. URL ̷ǵ URL α
ִ.</p>
<p>ErrorDocument ִ CGI ũƮ
̷Ѵٸ, ũƮ Ŭ̾Ʈ Ȳ
Ȯ ϱ ¿ "<code>Status:</code>"
ʵ带 ؾ Ѵ. , Perl ۼ ErrorDocument
ũƮ :</p>
<div class="example"><p><code>
... <br />
print "Content-type: text/html\n"; <br />
printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
...
</code></p></div>
<p><code>404 Not Found</code> Ư
Ȳ ũƮ, <span class="transnote">(<em>;</em> )</span>
Ư ڵ ִ.</p>
<p>(Ŭ̾Ʈ ̷ ûϱ) 信
<code>Location:</code> Ѵٸ, ũƮ
<em>ݵ</em> (<code>302 Found</code> )
<code>Status:</code> ؾ ϶.
<code>Location:</code> ƹ ҿ ִ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/custom-error.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/caching.html 0000664 0001751 0001751 00000000444 13710016232 017306 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: caching.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: caching.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: caching.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/content-negotiation.html.tr.utf8 0000664 0001751 0001751 00000112126 14743132254 023226 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>İçerik Uzlaşımı - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>İçerik Uzlaşımı</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/content-negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/content-negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" title="Türkçe"> tr </a></p>
</div>
<p>Apache HTTPD, içerik uzlaşımını HTTP/1.1 belirtiminde bahsedildiği şekliyle
destekler. Bir özkaynağın en iyi gösterimini, tarayıcının sağladığı
karakter kodlaması, karakter kümesi, dil, ortam türü gibi kullanıcı
tercihlerine bağlı olarak seçebilir. Ayrıca, tarayıcının kullanıcı
tercihlerini tam yansıtamadığı durumlarda istekleri daha akıllıca ele
alabilmeyi sağlayacak bir takım özelliklere de sahiptir.</p>
<p>İçerik uzlaşımı öntanımlı olarak derlenen
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> modülü tarafından sağlanır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#about">İçerik Uzlaşımı Hakkında</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#negotiation">httpd’de İçerik Uzlaşımı</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#methods">Uzlaşım Yöntemleri</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#better">Üstünlük Değerleriyle Oynamak</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extensions">Şeffaf İçerik Uzlaşımının Genişletilmesi</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#naming">Hiperbağlar ve İsimlendirme Uzlaşımları</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#caching">Arabellekler Hakkında</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="about" id="about">İçerik Uzlaşımı Hakkında</a></h2>
<p>Bir özkaynağın bir çok farklı gösterimi olabilir. Örneğin, bir belgenin
farklı ortam türleri ve/veya farklı diller için gösterimleri olabilir.
En uygun seçimi yapmanın tek yolu kullanıcıya bir liste verip seçmesini
istemektir. Bununla birlikte sunucunun bu seçimi kendiliğinden yapması
da mümkündür. Tarayıcılar isteğin bir parçası olarak kullanıcı
tercihlerini de gönderdiğinden bu istendiği gibi çalışır. Örneğin bir
tarayıcı, kullanıcısınının mümkünse Fransızca içerik tercih ettiğini
yoksa İngilizce içeriğe de razı olabileceğini belirtebilirdi.
Tarayıcılar bu tercihleri başlıkta belirtirler. Tarayıcı sadece Türkçe
içerik istendiğini şöyle belirtebilirdi:</p>
<div class="example"><p><code>Accept-Language: tr</code></p></div>
<p>Bu tercihin yerine getirilebilmesininin sadece, desteklenen diller
arasında bu dilin varlığına ve istenen belgenin bu dilde bir
gösteriminin bulunmasına bağlı oluşuna dikkat ediniz.</p>
<p>Daha karmaşık bir istek örneği olarak, tarayıcının Fransızca ve
İngilizce içerik kabul etmeye ayarlandığını fakat Fransızcayı tercih
ettiğini ve çeşitli ortam türlerini kabul etmekle birlikte salt metin ve
diğer metin türlerinden ziyade HTML tercih ettiğini, ayrıca, diğer ortam
türleri üzerinde GIF veya JPEG tercih ettiğini fakat başka çare yoksa
her ortam türüne de izin verdiğini belirtiyor olsun:</p>
<div class="example"><p><code>
Accept-Language: fr; q=1.0, en; q=0.5<br />
Accept: text/html; q=1.0, text/*; q=0.8, image/gif; q=0.6, image/jpeg;
q=0.6, image/*; q=0.5, */*; q=0.1
</code></p></div>
<p>httpd, HTTP/1.1 belirtiminde tanımlanan şekliyle ‘sunucu yönetiminde’
içerik uzlaşımını destekler. <code>Accept</code>,
<code>Accept-Language</code>, <code>Accept-Charset</code> ve
<code>Accept-Encoding</code> istek başlıklarını tamamen destekler.
httpd ayrıca, RFC 2295 ve RFC 2296’da tanımlanan bir deneysel uzlaşım
olarak ‘şeffaf’ içerik uzlaşımını da destekler. Fakat ‘özellik
uzlaşımını’ bu RFC’lerde tanımlandığı gibi desteklemez.</p>
<p>Bir <strong>özkaynak</strong> bir URI (RFC 2396) tarafından betimlenen
kavramsal bir öğedir. Apache gibi bir HTTP sunucusu, ortam türü,
karakter kümesi, kodlama ve saire ile tanımlanmış bir bayt dizisi
şeklindeki her gösterimiyle, özkaynaklara kendi isim alanları dahilinde
erişim sağlar. Her özkaynağın aynı anda bir veya daha fazla gösterimi
mevcut olabileceği gibi hiç mevcut olmayabilir de. Eğer çok sayıda
gösterim mevcutsa, bu özkaynağın <strong>uzlaşılabilir</strong>
olduğundan ve her gösteriminin bir <strong>çeşitlilik</strong>
oluşturduğundan bunun da uzlaşımın <strong>boyutlar</strong>ından
kaynaklandığından bahsedilebilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="negotiation" id="negotiation">httpd’de İçerik Uzlaşımı</a></h2>
<p>Bir özkaynak üzerinde uzlaşılırken gösterim çeşitlerinin her biri
hakkında sunucuya bilgi verilmesi gerekir. Bu iki yolla yapılabilir:</p>
<ul>
<li>Ya gösterim çeşitlerini içeren dosyaların isimleriyle eşleşmeyi
sağlayan bir tür eşlemi kullanılır (bir <code>*.var</code> dosyası
gibi).</li>
<li>Ya da sunucu örtük bir dosya ismi kalıbı eşleşmesinin ardından
sonuçlar arasından seçim yapar; buna ‘Çoklu Görünüm’ araması adı
verilir.</li>
</ul>
<h3><a name="type-map" id="type-map">Bir türeşlem dosyası kullanmak</a></h3>
<p>Bir türeşlem dosyası, <code>type-map</code> eylemcisi ile ilişkili bir
belgedir (ya da eski httpd yapılandırmaları ile geriye uyumluluk için,
<code>application/x-type-map</code> <a class="glossarylink" href="./glossary.html#mime türü" title="sözlüğe bakınız">MIME türü</a>nde
bir belgedir). Bu özelliği kullanmak için, yapılandırmada bir tür
eşleyici olarak her dosya ismi uzantısı için bir <code>type-map</code>
eylemcisi tanımlamalısınız. Bu, sunucu yapılandırma dosyasında en iyi
şöyle yapılabilir:</p>
<pre class="prettyprint lang-config">AddHandler type-map .var</pre>
<p>Türeşlem dosyaları kendilerini tanımlayan özkaynak ile aynı isimde
olmalı ve isim bir <code>.var</code> uzantısı içermelidir. Aşağıdaki
örneklerde özkaynak ismi <code>foo</code> olduğundan türeşlem dosyasının
ismi <code>foo.var</code>'dır.</p>
<p>Bu dosya her gösterim çeşidi için bir girdi içermelidir; bu girdiler
ardarda belirtilen HTTP biçem başlık satırlarından oluşur. Farklı
gösterimlerin girdileri bir boş satırla diğerlerinden ayrılır. Aynı
girdi içinde boş satır kullanılamaz. Bir eşlem dosyasını bir birleşik
öğenin tamamı için bir girdi ile başlatmak adet olmuştur (ise de, bu
gerekli değildir, hele yoksayılacaksa hiç gerekli değildir). Eşlem
dosyası için aşağıda bir örnek verilmiştir.</p>
<p>Bu dosyadaki URI'ler türeşlem dosyasının yerine görelidir. Dolayısıyla,
bu dosyaların aynı dizinde bulunması beklenirse de bu gerekli değildir.
Aynı sunucuda bulunan tüm dosyalar için türeşlem dosyasındaki gibi mutlak
veya göreli URI'ler belirtebilirsiniz.</p>
<div class="example"><p><code>
URI: misal<br />
<br />
URI: misal.en.html<br />
Content-type: text/html<br />
Content-language: en<br />
<br />
URI: misal.fr.de.html<br />
Content-type: text/html;charset=iso-8859-2<br />
Content-language: fr, de<br />
</code></p></div>
<p>Ayrıca, <code>MultiViews</code> etkin olsa bile bir türeşlem dosyasının
dosya ismi uzantılarının taranmasına göre öncelik alacağına dikkat
ediniz. Eğer gösterimler bu örnekteki resim dosyasında olduğu gibi
farklı kaynak üstünlüklerine sahipseler, ortam türünün <code>qs</code>
parametresi kullanılarak kaynak üstünlükleri belirtilebilir: </p>
<div class="example"><p><code>
URI: misal<br />
<br />
URI: misal.jpeg<br />
Content-type: image/jpeg; <strong>qs=0.8</strong><br />
<br />
URI: misal.gif<br />
Content-type: image/gif; <strong>qs=0.5</strong><br />
<br />
URI: misal.txt<br />
Content-type: text/plain; <strong>qs=0.01</strong><br />
</code></p></div>
<p><code>qs</code> değerleri 0.000-1.000 değer aralığı içinde
belirtilebilir. 0.000 <code>qs</code> değerine sahip gösterimin asla
seçilmeyeceğine dikkat ediniz. Bir <code>qs</code> değeri belirtilmeyen
gösterimlerin kaynak üstünlüğü 1.000 kabul edilir. <code>qs</code>
parametresinin belirttiği değer istemcinin yeteneklerinden bağımsız
olarak olası gösterimler arasında göreli bir üstünlük ifade eder.
Örneğin bir fotoğraf sözkonusu olduğunda bir JPEG dosyasının kaynak
üstünlüğü bir ASCII çiziminkinden yüksek olacaktır. Diğer taraftan özgün
resim bir ASCII çizim olduğu takdirde, ASCII çizim, bir JPEG gösterimine
göre öncelikli olacaktır. Bu nedenle <code>qs</code> değeri özkaynağın
doğasına bakarak belirlenir.</p>
<p>Tanınan başlıkların tam listesini <a href="mod/mod_negotiation.html#typemaps">mod_negotiation</a> modülünün
belgesinde bulabilirsiniz.</p>
<h3><a name="multiviews" id="multiviews">Çoklu Görünümler</a></h3>
<p><code>MultiViews</code>, <code>httpd.conf</code> dosyasındaki veya
(<code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> yönergesinin
değerine bağlı olarak) <code>.htaccess</code> dosyalarındaki <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code> veya <code class="directive"><a href="./mod/core.html#files"><Files></a></code> bölümleri içinde
<code class="directive"><a href="./mod/core.html#options">Options</a></code> yönergeleri ile
belirtilebilen, dizine özgü bir seçenektir. Yalnız, dikkatli olun,
<code>Options All</code> yaparak <code>MultiViews</code> seçeneğini
etkin kılamazsınız; seçeneği ismiyle açıkça belirtmelisiniz.</p>
<p><code>MultiViews</code> şöyle etki eder: Sunucudan,
<code>MultiViews</code> seçeneğinin etkin olduğu <code>/bir/dizin</code>
dizininden <code>filanca</code> dosyası için bir istekte bulunulmuşsa
fakat dizinde bu dosya yoksa, sunucu dizin içeriğini
<code>filanca.*</code> dosyaları için tarar ve bu dosyalar için
istemcinin ismiyle talep ettiği ortam türlerini ve kodlamaları
kullanarak bir türeşlem dosyası uydurup bu gösterimler arasından
istemcinin gereksinimlerine en uygun gösterimi seçer.</p>
<p><code>MultiViews</code> ayrıca, sunucunun bir dizin içeriğini
listelemeye çalıştığı durumda <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> yönergesi ile belirtilen dosya için de bir
arama tertipleyebilir. Eğer yapılandırma dosyalarında</p>
<pre class="prettyprint lang-config">DirectoryIndex index</pre>
<p>şeklinde bir atama varsa ve dizinde <code>index.html</code> ve
<code>index.html3</code> dosyaları varsa sunucu bunlar arasından hakem
sıfatıyla bir seçim yapacaktır; ama bu ikisi yerine dizinde sadece
<code>index.cgi</code> mevcutsa sunucu sadece bu dosyayı
çalıştıracaktır.</p>
<p>Okunan dizinde bulunan dosyalar arasında <code>mod_mime</code>
tarafından tanınan karakter kümesi, içerik türü, dil ve kodlama
başlıklarına uygun gösterim uzantılarından birine sahip bir dosya yoksa
sonuç <code class="directive"><a href="./mod/mod_mime.html#multiviewsmatch">MultiViewsMatch</a></code>
yönergesiyle yapılan tanıma bağlı olur. Bu yönerge hangi diğer dosya
uzantılarının, eylemcilerin veya süzgeçlerin çok gösterimli uzlaşımla
ilintileneceğini belirler.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="methods" id="methods">Uzlaşım Yöntemleri</a></h2>
<p>httpd’nin, bir türeşlem dosyası veya dizin içindeki bir dosya
sayesinde belli bir özkaynağın gösterim çeşitlerinin bir listesini elde
ettikten sonra ‘en uygun’ gösterime karar vermek için kullanabileceği
iki yöntem vardır. httpd’nin içerik uzlaşım özelliklerinin kullanımı
sırasında uzlaşımın nasıl yerine getirileceği ile ilgili ayrıntıları
bilmek aslında gerekli değildir. Bununla birlikte belgenin kalanında bu
konu açıklanmaya çalışılmıştır.</p>
<p>İki uzlaşım yöntemi vardır:</p>
<ol>
<li>Normal durumda <strong>sunucu yönetiminde httpd uzlaşım
algoritması</strong> kullanılır. Bu algoritma aşağıda ayrıntılı olarak
açıklanmıştır. Bu algoritma kullanıldığı zaman, httpd, en iyi sonuca
ulaşmak için bazen belli boyutların üstünlük katsayılarıyla ‘oynar’.
httpd’nin bu katsayılarla oynama işini nasıl yaptığı aşağıda daha
ayrıntılı açıklanmıştır.</li>
<li>İstemci bu işlem için özellikle RFC 2295’te tanımlanan mekanizmanın
kullanılmasını isterse <strong>şeffaf içerik uzlaşımı</strong>
kullanılır. Bu uzlaşım yöntemi, en uygun gösterimin seçilmesi
konusunda tarayıcıya tam denetim imkanı verir; dolayısıyla sonuç
tarayıcının bu işlem için kullandığı algoritmanın başarısına bağlıdır.
Şeffaf uzlaşım sürecinin bir parçası olarak, tarayıcı, RFC 2296’da
tanımlanan ‘gösterim çeşidini uzaktan seçme algoritması’nın
çalıştırılmasını httpd’den isteyebilir.</li>
</ol>
<h3><a name="dimensions" id="dimensions">Uzlaşımın Boyutları</a></h3>
<table>
<tr valign="top">
<th>Boyut</th>
<th>Açıklama</th>
</tr>
<tr valign="top">
<td>Ortam Türü</td>
<td>Tarayıcı ortam türü tercihlerini <code>Accept</code> başlık alanı
ile belirtir. Her öğenin kendine özgü bir üstünlük katsayısı
olabilir. Gösterimin açıklaması da ayrıca bir kaynak üstünlüğüne
(<code>qs</code> parametresi) sahip olabilir.</td>
</tr>
<tr valign="top">
<td>Dil</td>
<td>Tarayıcı dil tercihlerini <code>Accept-Language</code> başlık
alanı ile belirtir. Her öğenin kendine özgü bir üstünlük katsayısı
olabilir. Gösterimler bir kaç dilde olabileceği gibi hiç bir dille
ilişkilendirimemiş de olabilir.</td>
</tr>
<tr valign="top">
<td>Kodlama</td>
<td>Tarayıcı kodlama tercihlerini <code>Accept-Encoding</code> başlık
alanı ile belirtir. Her öğenin kendine özgü bir üstünlük katsayısı
olabilir.</td>
</tr>
<tr valign="top">
<td>Karakter Kümesi</td>
<td>Tarayıcı karakter kümesi tercihlerini <code>Accept-Charset</code>
başlık alanı ile belirtir. Her öğenin kendine özgü bir üstünlük
katsayısı olabilir. Gösterim çeşitleri karakter kümesini ortam
türünün bir parametresi olarak belirtebilirler.</td>
</tr>
</table>
<h3><a name="algorithm" id="algorithm">httpd Uzlaşım Algoritması</a></h3>
<p>httpd, tarayıcıya döndürülecek en uygun gösterim çeşidini (varsa)
seçmek için aşağıdaki algoritmayı kullanabilir. Bu algoritma pek de
yapılandırılabilir değildir. Şöyle çalışır:</p>
<ol>
<li>Önce her uzlaşım boyutu için ilgili <em>Accept*</em> başlık alanına
bakılıp her gösterim çeşidine bir üstünlük katsayısı atanır. Eğer
boyutlardan bazıları için ilgili <em>Accept*</em> başlığı
uygulanabilir değilse bu boyut elenir ve sonuçta hiçbir gösterim
çeşidi kalmasza 4. adıma atlanır.</li>
<li>‘En uygun’ gösterim çeşidi bir eleme süreciyle seçilir. Bu süreç
sırasında aşağıdaki sınamalar sırayla uygulanır. Sınamalardan
geçemeyen bir gösterim çeşidi elenir. Sınamaların bir aşamasında tek
bir gösterim çeşidi kalırsa bu en uygun eşleşme olarak seçilmiş olur
ve 3. adıma atlanır. Eğer birden fazla gösterim çeşidi kalırsa sonraki
sınamaya geçilir.
<ol>
<li><code>Accept</code> başlığındaki üstünlük katsayısı ile
gösterimin ortam türünde belirtilen kaynak üstünlüğünün çarpımı en
büyük olan gösterim çeşidi seçilir.</li>
<li>En yüksek dil üstünlük katsayısına sahip gösterim çeşidi seçilir.
</li>
<li>En uygun dil eşleşmesine sahip gösterim çeşidini seçmek için
önce varsa <code>Accept-Language</code> başlığındaki dil
sıralamasına bakılır, aksi takdirde <code>LanguagePriority</code>
yönergesi ile atanmışsa oradaki dil sıralamasına bakılır.</li>
<li>En yüksek ‘seviyeden’ ortam parametresine (text/html ortam türü
sürümünü belirtmekte kullanılır) sahip gösterim çeşitleri
seçilir.</li>
<li><code>Accept-Charset</code> başlık satırında belirtilene bakarak
en uygun karakter kümesine sahip gösterim çeşitleri seçilir.
Alenen dışlanmadıkça ISO-8859-1 kabul edilebilir karakter
kümesidir. <code>text/*</code> ortam türüne sahip gösterim
çeşitlerinden belli bir karakter kümesi ile ilişkilendirilmemiş
olanların karakter kümesinin ISO-8859-1 olduğu varsayılır.</li>
<li>ISO-8859-1 karakter kümesi ile ilişkilendirilmemiş gösterim
çeşitleri seçilir. Böyle hiçbir gösterim yoksa bütün gösterimler
seçilir.</li>
<li>En uygun kodlamaya sahip gösterim çeşitleri seçilir. Tarayıcı
tarafından kabul edilebilir kodlamaya sahip gösterim çeşitleri
varsa bunlar seçilir. Yoksa kodlanmış ve kodlanmamış gösterim
çeşitleri karışık olarak mevcutsa sadece kodlanmamış olanlar
seçilir. Eğer bütün gösterim çeşitlerinin sadece kodlanmış ya da
sadece kodlanmamış gösterimleri mevcutsa hepsi seçilir.</li>
<li>En küçük içerik uzunluğuna sahip gösterim çeşitleri seçilir.</li>
<li>Kalan gösterim çeşitlerinin ilki seçilir. Bu ilk, ya türeşlem
dosyasında listelenen ilk çeşittir ya da gösterimler bir dizinden
okunuyorsa ASCII kod sıralamasına göre ilk sıradaki dosya ismine
sahip gösterimdir.</li>
</ol>
</li>
<li>Algoritma, artık seçilmiş en uygun gösterim çeşidine sahipse bu
artık yanıt olarak döndürülebilir. HTTP yanıt başlığı
<code>Vary</code>’ye uzlaşım boyutları atanır (tarayıcı ve
arabellekler özkaynağı kaydederken bu bilgiyi kullanırlar)
ve algoritma sonlandırılır.</li>
<li>Buraya gelinmişse hiçbir gösterim seçilmemiş demektir (hiçbiri
tarayıcı tarafından kabul edilebilir bulunmadığından dolayı).
Gövdesinde mevcut gösterim çeşitlerini listeleyen bir HTML belgesi 406
durum koduyla döndürülür (406: ‘kabul edilebilir bir gösterim yok’).
Ayrıca HTTP <code>Vary</code> başlığında gösterim çeşitliliğinin
boyutları belirtilir.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="better" id="better">Üstünlük Değerleriyle Oynamak</a></h2>
<p>httpd bazen yukarıdaki httpd uzlaşım algoritmasının kesin sonucunun
beklenenden farklı olması için üstünlük değerleriyle oynar. Bunu tam ve
doğru bilgi göndermeyen tarayıcılar için algoritmadan en iyi sonucu elde
etmek amacıyla yapar. Bazen günümüzün en tanınmış tarayıcıları bile çoğu
durumda yanlış bir seçimle sonuçlanmayacaksa <code>Accept</code> başlık
bilgilerini göndermemektedir. Eğer tarayıcı eksiksiz ve doğru bilgi
gönderirse httpd bu değerlerle oynamayacaktır.</p>
<h3><a name="wildcards" id="wildcards">Ortam Türleri ve Dosyaismi Kalıpları</a></h3>
<p><code>Accept:</code> istek başlığı ortam türü tercihlerini yansıtır.
Ayrıca, * bir dizge ile eşleşmek üzere "image/*" veya "*/*" gibi ortam
türü kalıpları da içerebilir. Dolayısıyla şöyle bir istek,</p>
<div class="example"><p><code>Accept: image/*, */*</code></p></div>
<p>diğer türler gibi "image/" ile başlayan ortam türlerini kabul
edilebilir kılacaktır. Bazı tarayıcılar ortam türlerini örtük olarak
elde etmek amacıyla hep bu tür kalıplar gönderirler. Örnek:</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*
</code></p></div>
<p>Bunun amacı, açıkça listelenmiş türlerin tercih edildiğini, fakat
farklı gösterimler varsa onların da kabul edilebileceğini belirtmektir.
Üstünlük değerlerini doğrudan kullanarak tarayıcılar gerçekte ne
istediklerini şuna benzer şekilde belirtebilirler:</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*; q=0.01
</code></p></div>
<p>Açıkça belirtilen türler için üstünlük katsayısı belirtilmemiştir,
dolayısıyla üstünlük katsayılarının 1.0 (en yüksek) olduğu
varsayılmaktadır. */* kalıbı 0.01 gibi çok daha düşük bir öncelik
belirtmektedir. Bu bakımdan, ancak, açıkça belirtilen türlerden
hiçbirinin bulunmaması halinde diğer türler eşleşecektir.</p>
<p>Eğer <code>Accept:</code> başlığı <em>hiçbir</em> <code>q</code>
katsayısı içermiyorsa ve başlıkta "*/*" belirtilmişse, httpd istenen
davranışı taklit etmek için bu kalıba 0.01 katsayısını atar. Keza
"type/*" kalıbına da 0.02 katsayısını atar (yani, */* kalıbına göre
tercihli olur). Eğer <code>Accept:</code> alanındaki her ortam türü bir
<code>q</code> katsayısı içeriyorsa bu özel değerler uygulanmaz.
Dolayısıyla gerekli bilgiyi açıkça bildiren tarayıcılardan gelen
istekler umulduğu gibi işlem görecektir.</p>
<h3><a name="exceptions" id="exceptions">Dil Uzlaşımında İstisnalar</a></h3>
<p>httpd 2.0’dan itibaren, uzlaşım algoritmasına, bir eşleşme bulmak
konusunda algoritma başarılı olamadığı takdirde hoş bir son çareye izin
vermek için bazı istisnalar eklenmiştir.</p>
<p>İstemci sunucudan bir sayfa istediğinde, sunucu, tarayıcı tarafından
gönderilen <code>Accept-language</code> başlığıyla eşleşen tek bir sayfa
bulamadığı takdirde istemciye ya “Kabul edilebilir bir gösterim çeşidi
yok” ya da “Çok sayıda seçim belirtilmiş” yanıtını döndürür. Bu hata
iletilerinden kaçınmak için bu gibi durumlarda httpd
<code>Accept-language</code> başlığını yoksaymaya ayarlanabilir. Böylece
istemcinin isteğine tam olarak uymasa da bir belge sağlanır. Bu hata
iletilerinin birini veya her ikisini de geçersiz kılmak için <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code> yönergesi
kullanılabilir ve sunucunun kararını <code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code> yönergesine
dayanarak vermesi sağlanabilir.</p>
<p>Sunucu ayrıca, tam bir eşleşme bulunmadığı zaman lehçelerle de eşleşme
arayabilir. Örneğin, bir istemci Britanya İngilizcesi
(<code>en-GB</code>) ile yazılmış belgeler için istekte bulunursa,
sunucu normalde HTTP/1.1 standardına göre bir belgenin basitçe
<code>en</code> olarak imlenmesine izin vermez. (Bir okuyucu Britanya
İngilizcesini anlıyor ama genel İngilizceyi anlamıyor diye
<code>Accept-Language</code> başlığında <code>en</code> değil de
<code>en-GB</code>’yi belirtmesinin hemen hemen daima bir yapılandırma
hatasına yol açacağına dikkat ediniz. Maalesef, mevcut istemcilerin çoğu
öntanımlı yapılandırmalarında buna benzer şeyler yapmaktadır.) Bununla
birlikte, başka bir dille eşleşme mümkün değilse ve sunucu “Kabul
edilebilir bir gösterim çeşidi yok” hatasını döndürmeye hazırsa veya
<code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code> son
çaresine ayarlanmışsa alt küme belirtimini yok sayacak ve
<code>en</code> belge isteklerine <code>en-GB</code> belgelerle yanıt
verecektir. httpd, lehçenin üyesi olduğu anadili, istemcinin kabul
edilebilir diller listesine örtük olarak düşük bir üstünlük değeri ile
ekler. Yalnız şuna dikkat edin, eğer istemci tercihini "en-GB; q=0.9,
fr; q=0.8" olarak belirtirse ve sunucuda sadece "en" ve "fr" belgeleri
varsa sunucu "fr" belge ile yanıt verecektir. HTTP/1.1 belirtimi ile
uyumluluğu sağlamak ve düzgün yapılandırılmış istemcilerle gerektiği
gibi çalışabilmek için bu gereklidir.</p>
<p>Gelişmiş tekniklerin (çerezler, özel URL yolları gibi) desteklenmesi
sırasında, kullanıcının tercih ettiği dili saptamak için httpd 2.0.47
sürümünden beri <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> modülü
<code>prefer-language</code> <a href="env.html">ortam değişkenini</a>
tanımaktadır. Değişken mevcutsa ve uygun bir dil yaftası içeriyorsa
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> uygun gösterimi seçmeyi deneyecektir.
Böyle bir gösterim çeşidi mevcut değilse normal uzlaşım işlemi
uygulanacaktır.</p>
<div class="example"><h3>Örnek</h3><pre class="prettyprint lang-config">SetEnvIf Cookie "language=(.+)" prefer-language=$1
Header append Vary cookie</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="extensions" id="extensions">Şeffaf İçerik Uzlaşımının Genişletilmesi</a></h2>
<p>httpd, şeffaf içerik uzlaşımı protokolünü (RFC 2295) şöyle genişletir:
Sadece içerik kodlamasına özgü olmak üzere gösterim çeşidi listelerinde
gösterim çeşitlerini imlemek için yeni bir <code>{encoding ..}</code>
elemanı kullanılır. RVSA/1.0 algoritmasının (RFC 2296) gerçeklenimi,
listedeki kodlanmış gösterim çeşitlerini tanımak ve onları
<code>Accept-Encoding</code> başlık alanıyla ilgili olarak kabul
edilebilir kodlamalara aday gösterim çeşitleri olarak kullanmak üzere
genişletilmiştir. RVSA/1.0 gerçeklenimi, en uygun gösterim çeşidi
seçiminin öncesinde hesaplanmış üstünlük katsayısını virgülden sonra beş
haneye yuvarlamaz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="naming" id="naming">Hiperbağlar ve İsimlendirme Uzlaşımları</a></h2>
<p>Eğer dil uzlaşımı kullanıyorsanız ve birden fazla dosya ismi uzantısına
sahip dosyalarınız varsa uzantıların sıralamasının normalde uygunsuz
düştüğü farklı isimlendirme yaklaşımlarında bulunabilirsiniz (ayrıntılar
için <a href="mod/mod_mime.html#multipleext">mod_mime</a> belgesine
bakınız).</p>
<p>Bir MIME türü uzantısına sahip bir dosyanın (<code>html</code> gibi),
kodlanmış bir gösterimi (<code>gz</code> gibi) mevcut olabilir. Bu
dosyanın ayrıca farklı dillerdeki gösterimleri için de bir uzantısı
(<code>en</code> gibi) olabilir.</p>
<p>Örnekler:</p>
<ul>
<li>misal.en.html</li>
<li>misal.html.en</li>
<li>misal.en.html.gz</li>
</ul>
<p>Hiperbağ olarak geçerli ve geçersiz bazı dosya ismi örnekleri:</p>
<table class="bordered">
<tr>
<th>Dosya ismi</th>
<th>Geçerli Hiperbağ</th>
<th>Geçersiz Hiperbağ</th>
</tr>
<tr>
<td><em>misal.html.en</em></td>
<td>misal<br />
misal.html</td>
<td>-</td>
</tr>
<tr>
<td><em>misal.en.html</em></td>
<td>misal</td>
<td>misal.html</td>
</tr>
<tr>
<td><em>misal.html.en.gz</em></td>
<td>misal<br />
misal.html</td>
<td>misal.gz<br />
misal.html.gz</td>
</tr>
<tr>
<td><em>misal.en.html.gz</em></td>
<td>misal</td>
<td>misal.html<br />
misal.html.gz<br />
misal.gz</td>
</tr>
<tr>
<td><em>misal.gz.html.en</em></td>
<td>misal<br />
misal.gz<br />
misal.gz.html</td>
<td>misal.html</td>
</tr>
<tr>
<td><em>misal.html.gz.en</em></td>
<td>misal<br />
misal.html<br />
misal.html.gz</td>
<td>misal.gz</td>
</tr>
</table>
<p>Yukarıdaki tabloya bakarak hiperbağlarda bir dosya ismini uzantısız
olarak (<code>misal</code> gibi) kullanmanın daima mümkün olduğunu
farkedeceksiniz. Böylece bir belgenin asıl türünü gizleyebilir ve
sonradan bir hiperbağ değişikliği yapmaksızın örneğin
<code>html</code>’den <code>shtml</code> veya <code>cgi</code>’ye
geçebilirsiniz.</p>
<p>Hiperbağlarda MIME türlerini (<code>misal.html</code> gibi) kullanmaya
devam etmek istiyorsanız dil uzantısı MIME türü uzantısının sağında
kalmalıdır (<code>misal.html.en</code> gibi).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="caching" id="caching">Arabellekler Hakkında</a></h2>
<p>Bir arabellek, bir gösterimi istek URL’si ile ilişkilendirerek saklar.
Böylece, sonradan aynı URL için bir istek yapıldığında kaydettiği
gösterimi kullanabilir. Fakat özkaynak sunucuyla uzlaşılan türdeyse
arabelleğe ilk istenen çeşit saklanmış olacağından isteğe yanlış
gösterimle yanıt verilmiş olacaktır. Bunun olmaması için httpd, normal
olarak içerik uzlaşımının sonucu olarak döndürülen tüm yanıtları
HTTP/1.0 istemciler tarafından arabelleklenemez olarak imler. httpd
ayrıca, uzlaşımlı yanıtların arabelleklenmesini mümkün kılan HTTP/1.1
protokolünü de destekler.</p>
<p>HTTP/1.0 uyumlu istemcilerden (bir tarayıcı veya arabellek) gelen
istekler için, uzlaşıma konu yanıtların arabelleklenmesini mümkün kılmak
üzere <code class="directive"><a href="./mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code> yönergesi kullanılabilir. Bu yönerge
argümansızdır ve sunucu genelinde veya sanal konakların
yapılandırılmasında kullanılabilir. Bunun HTTP/1.1 istemcilerinden gelen
isteklere bir etkisi yoktur.</p>
<p>HTTP/1.1 istemciler için, httpd, yanıtın uzlaşım boyutlarını göstermek
üzere bir <code>Vary</code> HTTP yanıt başlığı gönderir. Arabellekler bu
bilgiyi sonraki istekleri yerel kopyadan sunarken kullanabilirler. Bir
arabelleğin uzlaşım boyutlarına bakmaksızın yerel kopyasını kullanmaya
teşvik etmek için <code>force-no-vary</code> <a href="env.html#special">ortam değişkenini</a> etkin kılabilirsiniz.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/content-negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/content-negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/content-negotiation.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/mpm.html 0000664 0001751 0001751 00000001300 13710016232 016473 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: mpm.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: mpm.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: mpm.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: mpm.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: mpm.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: mpm.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: mpm.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
URI: mpm.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/custom-error.html.tr.utf8 0000664 0001751 0001751 00000034256 14743132254 021706 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Hata Yanıtlarının Kişiselleştirilmesi - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Hata Yanıtlarının Kişiselleştirilmesi</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" title="Türkçe"> tr </a></p>
</div>
<p>Apache HTTP Sunucusu 4xx veya 5xx HTTP durum kodları ile ilgili
olaylarda soysal hata yanıtları üretse de bu yanıtlar site
kullanıcılarına aşırı sade, bilgi vermez ve hatta korkutucu gelebilir.
Daha dostça yazılmış, İngilizce değil de kendi dilinizde ve belki
sayfalarınızın yerleşimine uygun daha hoş satırlarda özel hata yanıtları
üretmek isteyebilirsiniz.</p>
<p>Kişiselleştirilmiş hata yanıtları, bir hata durumuna göre tasarlanmış
herhangi bir HTTP durum kodu (yani 4xx ve 5xx kodlarından biri) için
tanımlanabilir.</p>
<p>Ek olarak bir değer kümesi de sağlanmıştır. Böylece hata belgeleri, <a href="howto/ssi.html">Sunucu taraflı İçerik Yerleştirme</a> kullanılarak
bu değişkenlerin değerlerine göre özelleştirilebilir. İsterseniz bunun
yerine bir CGI programı veya devingen bir eylemci (PHP, mod_perl, vs.)
kullanarak da bu değişkenlerin değerlerine göre hata sayfalarınızı
üretebilirsiniz.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#configuration">Yapılandırma</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#variables">Kullanılabilen Değişkenler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#custom">Özel Hata Yanıtları</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#multi-lang">Çok Dilli Özel Hata Belgeleri</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="configuration" id="configuration">Yapılandırma</a></h2>
<p>Kişiselleştirilmiş hata belgeleri <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> yönergesi kullanılarak yapılandırılabilir. Bu
yönerge küresel bağlamda olabileceği gibi sanal konak ve dizin
bağlamlarında da kullanılabilir. <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> yönergesine <code>FileInfo</code>
atanarak <code>.htaccess</code> dosyalarında da kullanılabilir.</p>
<pre class="prettyprint lang-config">ErrorDocument 500 "Pardon, galiba bizim betik hata verdi."
ErrorDocument 500 /cgi-bin/hata-kurtarma
ErrorDocument 500 http://error.example.com/server_error.html
ErrorDocument 404 /ozuru_kabahatinden_buyuk/yok.html
ErrorDocument 401 /Uyeler/NASIL_uye_olunur.html</pre>
<p><code>ErrorDocument</code> yönergesinin sözdizimi:</p>
<pre class="prettyprint lang-config">ErrorDocument <3-rakamlı-kod> <eylem></pre>
<p><var>eylem</var> şunlardan biri olabilir:</p>
<ol>
<li>Yönlendirmenin yapılacağı dahili adres (<var>eylem</var> bir "/" ile
başlıyorsa).</li>
<li>Yönlendirmenin yapılacağı harici adres (<var>eylem</var> geçerli bir
URL ise).</li>
<li>Gösterilecek metin (yukardakilerin hiçbiri yoksa). Birden fazla
sözcük içeriyorsa tırnak (") içine alınmalıdır.</li>
</ol>
<p>Yerel bir adrese yönlendirme yapılırken ek ortam değişkenleri de
atanarak yanıt daha da özelleştirilebilir. Bunlar harici URL'lere
gönderilmez.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="variables" id="variables">Kullanılabilen Değişkenler</a></h2>
<p>Hata durumunu açıklayacak veya hata günlüğüne daha açıkça
kaydedilebilecek bazı bilgilerin aktarılması koşuluyla, başka bir
adrese yönlendirme kullanışlı olabilir</p>
<p>Hata yönlendirmesi yapılırken bunu sağlamak için ek ortam değişkenleri
tanımlanır. Bu değişkenlerin isimleri, özgün istekle sağlanan
başlık isimlerinin önüne 'REDIRECT_' dizgesi getirilerek üretilir.
Böylece özgün istek bağlamından hata belgesi üretilebilir.</p>
<p>Örneğin, aşağıdaki gibi, daha yararlı olacak ek ortam değişkenleri
alabilirsiniz.</p>
<div class="example"><p><code>
REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/jpeg, image/png<br />
REDIRECT_HTTP_USER_AGENT=Mozilla/5.0 Fedora/3.5.8-1.fc12 Firefox/3.5.8<br />
REDIRECT_PATH=.:/bin:/usr/local/bin:/sbin<br />
REDIRECT_QUERY_STRING=<br />
REDIRECT_REMOTE_ADDR=121.345.78.123<br />
REDIRECT_REMOTE_HOST=client.example.com<br />
REDIRECT_SERVER_NAME=www.example.edu<br />
REDIRECT_SERVER_PORT=80<br />
REDIRECT_SERVER_SOFTWARE=Apache/2.2.15<br />
REDIRECT_URL=/cgi-bin/buggy.pl
</code></p></div>
<p><code>REDIRECT_</code> ortam değişkenleri, yönlendirme öncesi varolan
ortam değişkenlerinden üretilir. Bunlar önlerine <code>REDIRECT_</code>
getirilerek yeniden isimlendirilir. Örneğin,
<code>HTTP_USER_AGENT</code> değişkeni
<code>REDIRECT_HTTP_USER_AGENT</code> haline gelir.</p>
<p><code>REDIRECT_URL</code>, <code>REDIRECT_STATUS</code> ve
<code>REDIRECT_QUERY_STRING</code> mutlaka atanır. Diğer başlıklarla
ilgili olanlar ise hata durumu öncesinde mevcut oldukları takdirde
üretilirler.</p>
<p>Eğer <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> hedefi bir
<em>harici</em> yönlendirme ise bunların <strong>hiçbiri</strong>
üretilmez (sunucunun bulunduğu konağı hedeflese bile <code>http:</code>
ile başlayan herşey harici yönlendirme sayılır).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="custom" id="custom">Özel Hata Yanıtları</a></h2>
<p>Hata yanıtınızı üretmek için sunucu taraflı içerik yerleştirme, bir
CGI betiği veya başka bir eylemciyi devingen eylemci olarak
kullanıyorsanız, bu yanıtı özelleştirmek için bu kullanıma özel
üretilmiş ortam değişkenlerini kullanmak isteyebilirsiniz.</p>
<p><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> yönergesi bir CGI
betiğine bir yerel yönlendirme belirtiyorsa, hatanın kaynağı hakkında
istemciye bilgi vermek amacıyla betiğin çıktısında bir
"<code>Status:</code>" başlık alanına yer verilmelidir. Örneğin, bir
Perl betiği şunları içerebilirdi:</p>
<pre class="prettyprint lang-perl">...
print "Content-type: text/html\n";
printf "Status: %s durumu saptandı.\n", $ENV{"REDIRECT_STATUS"};
...</pre>
<p>Eğer betik, <code>404 Not Found</code> gibi, belli bir hata
durumunu ele almaya adanmışsa duruma özel kod ve hata metni
kullanılabilir.</p>
<p>Eğer yanıt, (istemci taraflı yönlendirme yapılırken) bir
<code>Location:</code> başlığı da içeriyorsa betiğin çıktıya uygun bir
<code>Status:</code> başlığı (<code>302 Found</code>) eklemesinin
gerekli oluşuna dikkat ediniz. Aksi takdirde, <code>Location:</code>
başlığı etkisiz olabilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="multi-lang" id="multi-lang">Çok Dilli Özel Hata Belgeleri</a></h2>
<p>Apache HTTP Sunucusunun kurulumunda, 16 dile çevrilmiş özel hata
iletileri belgeleri içeren bir dizin bulunmaktadır. Ayrıca,
<code>conf/extra</code> yaplandırma dizininde bu özelliği etkin kılmak
için yapılandırmaya dahil edilebilecek bir yapılandırma dosyası
vardır.</p>
<p>Sunucu yapılandırma dosyanızda şöyle satırlar görebilirsiniz:</p>
<pre class="prettyprint lang-config"># Multi-language error messages
#Include conf/extra/httpd-multilang-errordoc.conf</pre>
<p>Bu <code>Include</code> satırını açıklama olmaktan çıkarırsanız
bu özelliği etkinleştirmiş olursunuz. Böylece, istemcinin tarayıcısında
belirtilmiş dil tercihine uygun dil uzlaşımlı hata iletileri
sağlanır.</p>
<p>Ek olarak, bu belgeler çeşitli <code>REDIRECT_</code> değişkenleri
içerir. Böylece, son kullanıcıya neler olduğu ve şimdi ne yapması
beklendiği hakkında ek bilgiler sağlanabilir.</p>
<p>Bu belgeleri istediğiniz kadar özelleştirebilir, kullanıcıya siteniz
hakkında ve orada bulabilecekleri şeylere dair faydalı bilgiler de
sağlayabilirsiniz.</p>
<p>Bu özelliği kullanmak için <code class="module"><a href="./mod/mod_include.html">mod_include</a></code> ve
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> etkin kılınmalıdır.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/custom-error.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/handler.html.zh-cn.utf8 0000664 0001751 0001751 00000026533 14743132254 021253 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache 的处理器 - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">模块</a> | <a href="./mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="./glossary.html">术语</a> | <a href="./sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><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="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">此翻译可能过期。要了解最近的更改，请阅读英文版。</div>
<p>本页描述 Apache 处理器的用法。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><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><h3>参见</h3><ul class="seealso"><li><a href="#comments_section">评论</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_imagemap.html">mod_imagemap</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 要执行的动作的内部表示形式。
一般来说，每个文件都有基于其文件类型的隐式处理器。通常的文件会被
服务器简单处理，但是某些文件类型会被分别“处理”。</p>
<p>处理器也可以被基于扩展名或位置来明确配置。它们都很有用，这不仅
因为它是优雅的方案，而且还允许类型<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_imagemap.html">mod_imagemap</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>: 用于内容协商，按类型映射文件处理(<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> 环境变量指向它)，按照需要作出 and making
whatever modifications or additions are desired.</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>invoke_handler</code>
之前，将 <code>r->handler</code> 指向处理器名称。处理器的实现与以前一样，只是用处理器名称取代了内容类型。
虽然不是必要，处理器的命名约定是使用破折号分割的单词，没有斜杠，从而不侵入媒体类型名称空间。</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="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">评论</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/handler.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="./glossary.html">术语</a> | <a href="./sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/handler.html.tr.utf8 0000664 0001751 0001751 00000030622 14743132254 020653 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache Eylemcilerinin Kullanımı - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache Eylemcilerinin Kullanımı</h1>
<div class="toplang">
<p><span>Mevcut Diller: </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="./tr/handler.html" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Bu belgede Apache Eylemcilerinin kullanımı açıklanmıştır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">Eylemci Nedir?</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Örnekler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programmer">Yazılım Geliştirenler İçin</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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">Eylemci Nedir?</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</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_imagemap.html">mod_imagemap</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>Bir <em>eylemci</em> bir dosya çağrıldığında uygulanacak eylemin Apache
dahilindeki gösterimidir. Genellikle dosyaların kendi türüne bağlı
olarak örtük eylemcileri vardır. Normalde tüm dosyalar basitçe sunucu
tarafından sunulurlar, fakat bazı dosya türleri normalden farklı şekilde
ele alınırlar.</p>
<p>Eylemciler, dosya türünden bağımsız olarak dosyanın bulunduğu yere veya
dosya ismi uzantısına göre de yapılandırılabilirler. Gerek, zarif bir
çözüm oluşuyla gerekse, hem dosya türünü hem de bir dosya ile ilişkili
bir eylemciyi mümkün kılması sebebiyle bunun getirisi daha yüksektir.
(Ayrıca, <a href="mod/mod_mime.html#multipleext">çok uzantılı
dosyalara</a> da bakınız.)</p>
<p>Eylemciler sunucu içinde derlenebileceği gibi bir modül olarak ya da
<code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code> yönergesi ile de
sunucuya dahil edilebilirler. Standart dağıtımda bulunan yerleşik
eylemciler şunlardır:</p>
<ul>
<li><strong>default-handler</strong>: Dosyayı, öntanımlı olarak durağan
içeriği işlemekte kullanılan <code>default_handler()</code> işlevini
kullanarak gönderir. (<code class="module"><a href="./mod/core.html">core</a></code>)</li>
<li><strong>send-as-is</strong>: Dosyayı HTTP başlıklarıyla olduğu gibi
gönderir. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
<li><strong>cgi-script</strong>: Dosyayı bir CGI betiği olarak ele alır.
(<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
<li><strong>imap-file</strong>: Dosyayı bir resim eşleme kuralları
dosyası olarak çözümler. (<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code>)</li>
<li><strong>server-info</strong>: Sunucunun yapılandırma bilgisini
döndürür. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
<li><strong>server-status</strong>: Sunucunun durum raporunu döndürür.
(<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
<li><strong>type-map</strong>: Dosyayı içerik uzlaşımı için bir tür
eşlem dosyası olarak çözümler. (<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">Örnekler</a></h2>
<h3><a name="example1" id="example1">Bir CGI betiği kullanarak durağan içeriğin değiştirilmesi</a></h3>
<p>Aşağıdaki yönergeler sayesinde, <code>html</code> uzantılı dosyalar
için yapılan istekler <code>footer.pl</code> CGI betiğininin
çalıştırılmasına sebep olacaktır.</p>
<pre class="prettyprint lang-config">Action add-footer /cgi-bin/footer.pl
AddHandler add-footer .html</pre>
<p>Bu yapılandırmayla, istenen belgenin özgün haliyle mi (yeri
<code>PATH_TRANSLATED</code> ortam değişkenindedir) yoksa istenen
değişiklikler veya eklemeler yapıldıktan sonra mı gönderileceğinden
CGI betiği sorumlu olacaktır.</p>
<h3><a name="example2" id="example2">HTTP başlıklı dosyalar</a></h3>
<p>Aşağıdaki yönergeler kendi HTTP başlıklarını içeren dosyalar için
kullanılan <code>send-as-is</code> eylemcisini etkinleştirmek amacıyla
kullanılmıştır. <code>/siteler/htdocs/asis/</code> dizinindeki tüm
dosyalar dosya ismi uzantılarına bakılmaksızın <code>send-as-is</code>
eylemcisi tarafından işleme sokulacaktır.</p>
<pre class="prettyprint lang-config"><Directory "/web/htdocs/asis">
SetHandler send-as-is
</Directory></pre>
</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">Yazılım Geliştirenler İçin</a></h2>
<p>Eylemci özellikleri gerçeklenirken kullanılmak üzere <a href="developer/API.html">Apache API</a>’ye bir ekleme yapılmıştır.
Özellikle de, <code>request_rec</code> yapısına yeni bir kayıt
eklenmiştir:</p>
<pre class="prettyprint lang-c">char *handler</pre>
<p>Modülünüzün bir eylemciyi devreye sokmasını isterseniz, tek yapacağınız
isteğin <code>invoke_handler</code> aşamasının hemen öncesinde
<code>r->handler</code> alanına eylemcinin ismini atamak olacaktır.
Eylemciler daha önce de bahsedildiği gibi bir içerik türü yerine bir
eylemci ismi kullanılarak gerçeklenirler. Çok gerekli olmamakla
birlikte, eylemciler için kullanılan adlandırma uzlaşımları gereğince,
ismi oluşturan sözcükler, ortam türü isim alanını ihlal etmemek amacıyla
bölü imleri ile değil tire imleri ile ayrılırlar.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </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="./tr/handler.html" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/handler.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/mpm.html.ja.utf8 0000664 0001751 0001751 00000027320 14743132254 017775 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>マルチプロセッシングモジュール (MPM) - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>マルチプロセッシングモジュール (MPM)</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>この文書ではマルチプロセッシングモジュールがどのようなもので、
Apache HTTP サーバでどのように使用されるかについて解説しています。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">はじめに</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#choosing">MPM を選ぶ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#defaults">MPM デフォルト値</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="introduction" id="introduction">はじめに</a></h2>
<p>Apache HTTP サーバは異なる幅広い環境、多種多様なプラットホームで
動作するように、パワフルで柔軟性に富んだ設計になっています。
異なるプラットホーム・異なる環境ではしばしば、
異なる機能が必要になったり、
同じ機能でも効率のために異なる実装が必要になったりします。
Apache ではモジュール化された設計により幅広い環境に適応してきました。
この設計のおかげで、管理者は
コンパイル時または実行時にどのモジュールをロードするか選ぶことによって、
どの機能をサーバに取り込むか選択することができます。</p>
<p>Apache 2.0 では、
このモジュール化された設計をサーバの基本機能にまで拡張しました。
サーバには精選されたマルチプロセッシングモジュール (MPM)
が付いてきて、これらはマシンのネットワークポートをバインドしたり、
リクエストを受け付けたり、リクエストを扱うよう子プロセスに割り当てたり、
といった役割を持ちます。</p>
<p>モジュール化された設計をサーバのこのレベルまで拡張することで
二つの重要な利点が生まれます:</p>
<ul>
<li>Apache は幅広いオペレーティングシステムを
より美しく効率的にサポートできます。
特に Windows 版の Apache は随分効率的になりました。
なぜなら <code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code>
によって、Apache 1.3 で用いられていた POSIX
レイヤの代わりにネイティブのネットワーク機能を
利用できるからです。
特別化された MPM
を実装した他のオペレーティングシステムでも、
同様にこの利点は生まれます。</li>
<li>サーバは特定のサイト向けに、より上手にカスタマイズできます。
例えば、非常に大きなスケーラビリティを必要とするサイトでは、
<code class="module"><a href="./mod/worker.html">worker</a></code> や <code class="module"><a href="./mod/event.html">event</a></code> といったスレッド化された
MPM を利用できる一方で、安定性や古いソフトウェアとの互換性を
必要とするサイトでは <code class="module"><a href="./mod/prefork.html">prefork</a></code>
が利用できます。</li>
</ul>
<p>ユーザレベルでは、MPM は他の Apache
モジュールと同等に見えます。
主な違いは、いつでも唯一の MPM
がロードされなければならないという点です。
利用可能な MPM は
<a href="mod/">module インデックス</a>にあります。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="choosing" id="choosing">MPM を選ぶ</a></h2>
<p>MPM は設定中に選択して、サーバ内部にコンパイルされなければ
なりません。
コンパイラは、スレッドが使用されている場合に様々な機能を最適化できますが、
そのためにはそもそもスレッドが使われているということを知る必要があります。</p>
<p>望みの MPM を実際に選ぶためには、<code class="program"><a href="./programs/configure.html">configure</a></code> スクリプトで
<code>--with-mpm=<em>NAME</em></code> 引数を用いてください。
<em>NAME</em> は望みの MPM の名前です。</p>
<p>サーバコンパイル後は、どの MPM が選択されたかを
<code>./httpd -l</code> で確かめることができます。
このコマンドは、MPM
を含め、サーバにコンパイルで組み込まれたモジュール全てを
列挙します。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="defaults" id="defaults">MPM デフォルト値</a></h2>
<p>次表に様々な OS 向けのデフォルトの MPM 一覧を掲載しています。
コンパイル時に意図的に他を選択しなければ、自動的にこれらの MPM
が選択されます。</p>
<table>
<tr><td>BeOS</td><td><code class="module"><a href="./mod/beos.html">beos</a></code></td></tr>
<tr><td>Netware</td><td><code class="module"><a href="./mod/mpm_netware.html">mpm_netware</a></code></td></tr>
<tr><td>OS/2</td><td><code class="module"><a href="./mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
<tr><td>Unix</td><td><code class="module"><a href="./mod/prefork.html">prefork</a></code></td></tr>
<tr><td>Windows</td><td><code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mpm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/index.html.ko.euc-kr 0000664 0001751 0001751 00000020350 14743132254 020626 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Server Version 2.4 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="index-page">
<div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></div>
<div class="up"><a href="http://httpd.apache.org/docs-project/"><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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a></div>
<div id="page-content"><h1>Apache HTTP Server Version 2.4 </h1>
<div class="toplang">
<p><span> : </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<form method="get" action="https://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Google ˻" type="submit" /><input value="10" name="num" type="hidden" /><input value="ko" name="hl" type="hidden" /><input value="EUC-KR" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="Version 2.4" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value=""List-Post"" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form>
<table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">ǥ</a></h2>
<ul><li><a href="new_features_2_0.html"> 2.0 ο </a></li>
<li><a href="upgrading.html">1.3 2.0 ̵</a></li>
<li><a href="license.html">ġ ̼</a></li>
</ul>
</div><div class="category"><h2><a name="manual" id="manual"> </a></h2>
<ul><li><a href="install.html">ϰ ġ</a></li>
<li><a href="invoking.html"></a></li>
<li><a href="stopping.html">ߴܰ </a></li>
<li><a href="mod/directives.html"> þ</a></li>
<li><a href="mod/quickreference.html">þ </a></li>
<li><a href="mod/"></a></li>
<li><a href="mpm.html">ó (MPM)</a></li>
<li><a href="filter.html"></a></li>
<li><a href="handler.html">ڵ鷯</a></li>
<li><a href="programs/"> α</a></li>
<li><a href="glossary.html"></a></li>
</ul>
</div></td><td><div class="category"><h2><a name="usersguide" id="usersguide"> ħ</a></h2>
<ul><li><a href="bind.html">ּҿ Ʈ </a></li>
<li><a href="configuring.html"></a></li>
<li><a href="sections.html"> </a></li>
<li><a href="content-negotiation.html"> (content negotiation)</a></li>
<li><a href="dso.html">ü (DSO)</a></li>
<li><a href="env.html">ȯ溯</a></li>
<li><a href="logs.html">α</a></li>
<li><a href="urlmapping.html">URL Ͻýۿ </a></li>
<li><a href="misc/perf-tuning.html"></a></li>
<li><a href="misc/security_tips.html"> </a></li>
<li><a href="server-wide.html"> </a></li>
<li><a href="ssl/">SSL/TLS ȣȭ</a></li>
<li><a href="suexec.html">CGI Suexec </a></li>
<li><a href="rewrite/">URL ۼ(rewriting) ħ</a></li>
<li><a href="vhosts/">ȣƮ</a></li>
</ul>
</div></td><td class="col3"><div class="category"><h2><a name="howto" id="howto">How-To / 丮</a></h2>
<ul><li><a href="howto/auth.html">, Ѻο,
</a></li>
<li><a href="howto/cgi.html">CGI: </a></li>
<li><a href="howto/htaccess.html">.htaccess </a></li>
<li><a href="howto/ssi.html">Server Side Includes (SSI)</a></li>
<li><a href="howto/public_html.html">ں 丮
(public_html)</a></li>
</ul>
</div><div class="category"><h2><a name="platform" id="platform">÷ </a></h2>
<ul><li><a href="platform/windows.html">Microsoft Windows</a></li>
<li><a href="platform/netware.html">Novell NetWare</a></li>
<li><a href="platform/ebcdic.html">EBCDIC </a></li>
</ul>
</div><div class="category"><h2><a name="other" id="other">ٸ </a></h2>
<ul><li><a href="faq/"> (FAQ)</a></li>
<li><a href="sitemap.html">Ʈ</a></li>
<li><a href="developer/">ڸ </a></li>
<li><a href="misc/">Ÿ</a></li>
</ul>
</div></td></tr></table></div>
<div class="bottomlang">
<p><span> : </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/invoking.html.ko.euc-kr 0000664 0001751 0001751 00000025571 14743132254 021355 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ġ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>ġ </h1>
<div class="toplang">
<p><span> : </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ġ Windows NT, 2000, XP ,
Windows 95 ME ܼ α ȴ. ڼ
<a href="platform/windows.html#winsvc">
ġ ϱ</a> <a href="platform/windows.html#wincons">ܼ α
ġ ϱ</a>.</p>
<p>н <a href="programs/httpd.html">httpd</a>
α 忡 û óϴ
ȴ. <code>httpd</code> ϴ
Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#startup"> ġ ϳ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errors"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#boot">Ҷ ϱ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#info">߰ </a></li>
</ul><h3></h3><ul class="seealso"><li><a href="stopping.html">ġ ߴܰ </a></li><li><a href="programs/httpd.html">httpd</a></li><li><a href="programs/apachectl.html">apachectl</a></li><li><a href="#comments_section">Comments</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="startup" id="startup"> ġ ϳ</a></h2>
<p>Ͽ <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> ⺻ 80(Ȥ
1024 ٸ Ʈ)̶ Ư Ʈ ϱ
root ʿϴ. Ͽ α
۾ ģ, Ŭ̾Ʈ û ٸ
ϴ <em>ڽ(child)</em> μ .
<code>httpd</code> μ root ڷ ,
ڽ μ ڷ ȴ. ̴
<a href="mpm.html">ó </a> Ѵ.</p>
<p><a href="programs/apachectl.html">apachectl</a>
ũƮ Ͽ <code>httpd</code> ϱ
Ѵ. ũƮ <code>httpd</code>
ü ϱ ʿ ȯ溯
ϰ <code>httpd</code> Ѵ.
<code>apachectl</code> ƱԸƮ ״ ѱ,
<code>httpd</code> ɼ̶ <code>apachectl</code>
밡ϴ. , <code>apachectl</code> ũƮ պκп
<code>HTTPD</code> <code>httpd</code>
ִ ġ <em></em> ƱԸƮ
ִ.</p>
<p><code>httpd</code> ϸ <a href="configuring.html"></a> <code>httpd.conf</code>
ãƼ д´. ġ ߿ ϳ,
<code>-f</code> ɼ ִ.</p>
<div class="example"><p><code>/usr/local/apache2/bin/apachectl -f
/usr/local/apache2/conf/httpd.conf</code></p></div>
<p>ϴ ٸ, ̳ο
Ʈ Եȴ. ̴
ǹѴ. Ͽ <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> 丮 ִ
Ʈ ũ (ī)
ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errors" id="errors"> </a></h2>
<p>ġ ϴ ߿ ɰ ϸ,
ϱ ˸ ܼ̳ <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> .
ϳ "<code>Unable to bind to Port ...</code>"̴.
쿡 Ѵ:</p>
<ul>
<li>root ڷ α ʰ Ư Ʈ
Ϸ . Ȥ</li>
<li>̹ ġ ٸ Ʈ
Ϸ .</li>
</ul>
<p>Ÿ ذ ġ <a href="faq/">FAQ</a>
϶.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="boot" id="boot">Ҷ ϱ</a></h2>
<p>ý Ŀ DZ ٶٸ,
ý ( <code>rc.local</code>̳ <code>rc.N</code>
丮 ִ ) <code>apachectl</code> ߰ؾ
Ѵ. ġ root ۵ȴ. ̳
(ϱ) ùٷ Ǿ Ȯ϶.</p>
<p><code>apachectl</code> ǥ SysV init ũƮ ϰ
ϵ . ũƮ ƱԸƮ <code>start</code>,
<code>restart</code>, <code>stop</code>
ñ׳ <code>httpd</code> .
<code>apachectl</code> init 丮 ũ ɸȴ.
ϴ ý Ȯ 䱸 Ȯ϶.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="info" id="info">߰ </a></h2>
<p><a href="programs/httpd.html">httpd</a> <a href="programs/apachectl.html">apachectl</a>, Ÿ
Ե α ɼ
<a href="programs/"> α</a>
϶. ġ <a href="mod/"></a>
ϴ <a href="mod/directives.html">þ</a>
ִ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/invoking.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/faq/ 0000775 0001751 0001751 00000000000 15032766627 015614 5 ustar covener covener httpd-2.4.64/docs/manual/faq/index.html.zh-cn.utf8 0000664 0001751 0001751 00000007104 14743132254 021505 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>常见问题 - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">模块</a> | <a href="../mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>常见问题</h1>
<div class="toplang">
<p><span>可用语言: </span><a href="../en/faq/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/faq/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/faq/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/faq/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/faq/" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>常见问题已经移到 <a href="http://wiki.apache.org/httpd/FAQ">HTTP 服务器维基</a>。</p>
</div>
</div>
<div class="bottomlang">
<p><span>可用语言: </span><a href="../en/faq/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/faq/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/faq/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/faq/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/faq/" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/faq/index.html.tr.utf8 0000664 0001751 0001751 00000007155 14743132254 021121 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Sıkça Sorulan Sorular - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Sıkça Sorulan Sorular</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/faq/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/faq/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/faq/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/faq/" title="Türkçe"> tr </a> |
<a href="../zh-cn/faq/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>SSS belgesi <a href="http://wiki.apache.org/httpd/FAQ">HTTP Server
Wiki</a>'ye taşındı.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/faq/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/faq/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/faq/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/faq/" title="Türkçe"> tr </a> |
<a href="../zh-cn/faq/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/faq/index.html 0000664 0001751 0001751 00000000716 13710016232 017572 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: index.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: index.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: index.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: index.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
URI: index.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/faq/index.html.es 0000664 0001751 0001751 00000007431 14743132254 020213 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Preguntas Frecuentes - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="../images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a></div><div id="page-content"><div id="preamble"><h1>Preguntas Frecuentes</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="../en/faq/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/faq/" title="Español"> es </a> |
<a href="../fr/faq/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/faq/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/faq/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Las preguntas frecuentes se han movido a la <a href="http://wiki.apache.org/httpd/FAQ">Wiki de HTTP Server (en Inglés)</a>.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="../en/faq/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/faq/" title="Español"> es </a> |
<a href="../fr/faq/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/faq/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/faq/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/faq/index.html.en 0000664 0001751 0001751 00000007144 14737241666 020222 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Frequently Asked Questions - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Frequently Asked Questions</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/faq/" title="English"> en </a> |
<a href="../es/faq/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/faq/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/faq/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/faq/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>The FAQ has been moved to the <a href="http://wiki.apache.org/httpd/FAQ">HTTP Server Wiki</a>.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/faq/" title="English"> en </a> |
<a href="../es/faq/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/faq/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/faq/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/faq/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/faq/index.html.fr.utf8 0000664 0001751 0001751 00000007153 14740503670 021102 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Foire aux questions - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Foire aux questions</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/faq/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/faq/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/faq/" title="Français"> fr </a> |
<a href="../tr/faq/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/faq/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>La FAQ a été transférée vers le <a href="http://wiki.apache.org/httpd/FAQ">Wiki du serveur HTTP</a>.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/faq/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/faq/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/faq/" title="Français"> fr </a> |
<a href="../tr/faq/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/faq/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/glossary.html.ko.euc-kr 0000664 0001751 0001751 00000051604 14743132254 021370 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title> - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1></h1>
<div class="toplang">
<p><span> : </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/glossary.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/glossary.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/glossary.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> Ϲݿ , Ư ġ õ,
Ѵ. 信 ڼ ũ ϶.
<span class="transnote">(<em>;</em> ܾ ѱ ƴ϶,
Դϴ. ǥ <a href="http://www.whiterabbitpress.com/osp/apache/"></a>
ϱ ٶϴ.)</span></p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="definitions" id="definitions"></a></h2>
<dl>
<dt><a name="accesscontrol"> (Access Control)</a></dt>
<dd>Ʈ . ġ Ư
<em>URL</em> ϱ Ѵ.<br /> : <a href="howto/auth.html">, Ѻο, </a></dd>
<dt><a name="algorithm">˰ (Algorithm)</a></dt>
<dd> ܰ踦 Ǫ Ȯ Ȥ Ģ.
ȣȭ ˰ <dfn>ȣ(Ciphers)</dfn>
θ.</dd>
<dt><a name="apacheextensiontool">APache eXtension Tool</a>
<a name="apxs">(apxs)</a></dt> <dd><a href="#module">
(module)</a> ҽ ü (<a href="#dso">DSO</a>)
ϰ ġ ġϴ ۾ perl
ũƮ.<br /> : <a href="programs/apxs.html">Manpage:
apxs</a></dd>
<dt><a name="authentication"> (Authentication)</a></dt>
<dd>, Ŭ̾Ʈ, Ʈ ü
Ȯ.<br /> : <a href="howto/auth.html">, Ѻο,
</a></dd>
<dt><a name="certificate"> (Certificate)</a></dt>
<dd> Ŭ̾Ʈ Ʈ ü ϴ ڷ.
(subject ), <a href="#certificationauthority"> (Certificate
Authority)</a> (issuer ), <a href="#publickey">Ű</a>, CA
X.509 ִ. Ʈ ü CA Ͽ
˻Ѵ.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="certificatsigningrequest"> û (Certificate
Signing Request</a>, <a name="csr">CSR)</a></dt> <dd><a href="#certificationauthority"> (Certification
Authority)</a> Ͽ CA <em> (Certificate)</em>
<a href="#privatekey">Ű (Private Key)</a>
<a href="#certificate"></a>. CSR Ǹ
ȴ.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="certificationauthority"> (Certification
Authority</a>, <a name="ca">CA)</a></dt> <dd>
Ʈ ü ϴ ŷϴ . ٸ Ʈ
ü CA ڸ ߴ Ȯ
ִ.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="cipher">ȣ (Cipher)</a></dt> <dd>ڷḦ
ȣȭϴ ˰̳ ý. , DES, IDEA, RC4 ִ.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="ciphertext">ȣ (Ciphertext)</a></dt> <dd><a href="#plaintext"> (Plaintext)</a> <a href="#cipher">ȣ
(Cipher)</a> ó .<br /> : <a href="ssl/">SSL/TLS
ȣȭ</a></dd>
<dt><a name="commongatewayinterface"> Ʈ ̽
(Common Gateway Interface</a>, <a name="cgi">CGI)</a></dt>
<dd>ܺ α û ֵ ܺ
α ̽ ǥ. ̽ <a href="http://hoohoo.ncsa.uiuc.edu/cgi/overview.html">NCSA</a>
, <a href="http://cgi-spec.golux.com/">RFC
Ʈ</a>̱ ϴ.<br />
: <a href="howto/cgi.html">CGI </a></dd>
<dt><a name="configurationdirective"> þ (Configuration
Directive)</a></dt>
<dd>: <a href="#directive">þ</a></dd>
<dt><a name="configurationfile"> (Configuration File)</a></dt>
<dd>ġ ϴ <a href="#directive">þ (directive)</a>
ؽƮ.<br />
: <a href="configuring.html"></a></dd>
<dt><a name="connect">CONNECT</a></dt>
<dd>HTTP ڷ帧 Ͻϴ HTTP <a href="#method">
(method)</a>. SSL ٸ α Ѵ.</dd>
<dt><a name="context"> (Context)</a></dt> <dd><a href="#configurationfile"> (configuration file)</a>
Ư <a href="#directive">þ (directive)</a>
ִ .<br /> : <a href="mod/directive-dict.html#Context">ġ þ ϴµ
</a></dd>
<dt><a name="digitalsignature">ڼ (Digital Signature)</a></dt>
<dd> ٸ ˻ϴ ȣȭ ڵ. <a href="#certificationauthority"> (Certification
Authority)</a> <em> (Certificate)</em> Ե
<em>Ű (Public Key)</em> ؽ ڽ
<em>Ű (Private Key)</em> ȣȭϿ .
CA Ű Ǯ ֱ, CA <em>
(Certificate)</em> Ʈ ü
ִ.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="directive">þ (Directive)</a></dt> <dd>ġ
ϴ ɾ. þ <a href="#configurationfile"> (Configuration File)</a>
Ѵ.<br /> : <a href="mod/directives.html">þ </a></dd>
<dt><a name="dynamicsharedobject">ü (Dynamic Shared
Object)</a> <a name="dso">(DSO)</a></dt> <dd> ġ httpd
ϰ Ͽ ʿҶ о ִ <a href="#module"> (Module)</a>.<br />
: <a href="dso.html">ü </a></dd>
<dt><a name="environmentvariable">ȯ溯 (Environment Variable)</a>
<a name="env-variable">(env-variable)</a></dt>
<dd> ϰ α ü ϴ
. ġ ȯ溯 , ȯ
ƴ϶ ġ ο ȴ.<br />
: <a href="env.html">ġ ȯ溯</a></dd>
<dt><a name="export-crippled"> (Export-Crippled)</a></dt>
<dd>̱ (Export Administration Regulations, EAR)
ؼϱ ȣ( ) . ȣȭ
Ʈ Ű ũⰡ ۰ ѵǾ, <em>ȣ
(Ciphertext)</em> (brute force) Ǯ ִ.<br />
: <a href="ssl/">SSL/TLS ȣȭ (SSL/TLS Encryption)</a></dd>
<dt><a name="filter"> (Filter)</a></dt>
<dd> ų ڷḦ óϴ . Էʹ
Ŭ̾Ʈ ڷḦ óϰ, ʹ
Ŭ̾Ʈ óѴ. ,
<code>INCLUDES</code> ʹ <a href="#ssi">Server
Side Includes</a> óѴ.<br />
: <a href="filter.html"></a></dd>
<dt><a name="fully-qualifieddomain-name"> θ
(Fully-Qualified Domain-Name)</a> <a name="fqdn">(FQDN)</a></dt>
<dd>IP ּҿ ϴ, ȣƮ θ Ʈ
ü ̸. , <code>www</code> ȣƮ̰
<code>example.com</code> θ϶,
<code>www.example.com</code> θ̴.</dd>
<dt><a name="handler">ڵ鷯 (Handler)</a></dt>
<dd> ûҶ ϴ ۾ ġ ǥ.
Ϲ Ϲ ڵ鷯 .
,
"óȴ(handled)". , <code>cgi-script</code>
ڵ鷯 <a href="#cgi">CGI</a> ó Ѵ.<br />
: <a href="handler.html">ġ ڵ鷯 </a></dd>
<dt><a name="header"> (Header)</a></dt>
<dd><a href="#http">HTTP</a> û 信
κ ϴ ִ.</dd>
<dt><a name="htaccess">.htaccess</a></dt> <dd> ȿ ִ
<a href="#configurationfile"> (configuration file)</a>,
<a href="#directive">þ (directive)</a> ڽ ġ
丮 丮 Ѵ. ̸
Ͽ ܼ þܿ þ
ִ.<br />
: <a href="configuring.html"></a></dd>
<dt><a name="httpd.conf">httpd.conf</a></dt>
<dd>ġ <a href="#configurationfile"> (configuration
file)</a>. ⺻ ġ
<code>/usr/local/apache2/conf/httpd.conf</code>, Ҷ
Ȥ ϶ ִ.<br />
: <a href="configuring.html"></a></dd>
<dt><a name="hypertexttransferprotocol">HyperText Transfer
Protocol</a> <a name="http">(HTTP)</a></dt>
<dd>̵ ϴ ǥ . ġ
<a href="http://ietf.org/rfc/rfc2616.txt">RFC 2616</a>
HTTP/1.1̶ 1.1 Ѵ.</dd>
<dt><a name="https">HTTPS</a></dt>
<dd>ȭ̵ ǥ ȣ , HyperText Transfer
Protocol (Secure). شܿ <a href="#ssl">SSL</a>
HTTP̴.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="method"> (Method)</a></dt> <dd>Ŭ̾Ʈ
<a href="#http">HTTP</a> û
ڿ ϵ ൿ. HTTP 忡 <code>GET</code>,
<code>POST</code>, <code>PUT</code> ִ.</dd>
<dt><a name="messagedigest"> (Message Digest)</a></dt>
<dd> ʾ ϱ
ؽ.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="mime-type">MIME-type</a></dt> <dd>
ϴ . Multipurpose Internet Mail Extensions
Ա ̷ ̸ . ̿
major type minor type ̷. ,
<code>text/html</code>, <code>image/gif</code>,
<code>application/octet-stream</code> ̴. MIME-type HTTP
<code>Content-Type</code> <a href="#header"> (header)</a>
Ѵ.<br /> : <a href="mod/mod_mime.html">mod_mime</a></dd>
<dt><a name="module"> (Module)</a></dt> <dd>α
κ. ġ Կθ ִ
ִ. ġ httpd ϰ <em>
</em>̶ ϸ, иǾ о
ִ <em> </em> Ȥ <a href="#dso">DSO</a>
Ѵ. ⺻ ϴ <em>base </em>̶ Ѵ.
ġ <a href="#tarball">Ÿ (tarball)</a>
ġ ִ. ̵
<em>ڰ (third-party) </em>̶ Ѵ.<br />
: <a href="mod/"> </a></dd>
<dt><a name="modulemagicnumber"> (Module Magic Number)</a>
(<a name="mmn">MMN</a>)</dt>
<dd> ġ ҽڵ尡 ,
ȣȯ ִ. ȣȯ ̻
ġ Լ ȣ, ٸ API Ϻΰ
쿡 ٲ. MMN ϸ ڰ ּ ٽ
ϵǾ Ѵ. ġ µ ؾ 쵵
ִ.
</dd>
<dt><a name="openssl">OpenSSL</a></dt>
<dd>SSL/TLS ¼ҽ <br />
<a href="http://www.openssl.org/">http://www.openssl.org/</a></dd>
<dt><a name="passphrase">Pass Phrase</a></dt>
<dd>Ű ȣϴ . ڰ Ű
Ͽ ȣȭ ϵ Ѵ. <a name="cipher">ȣ
(Ciphers)</a> ϴ н ȣ/ص Ű̴.<br /> : <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="plaintext"> (Plaintext)</a></dt>
<dd>ȣȭ .</dd>
<dt><a name="privatekey">Ű (Private Key)</a></dt> <dd>
ڷḦ صϰ ڷḦ ϱ <a href="#publickeycryptography">Ű ȣȭ (Public Key
Cryptography)</a> ý ȣŰ.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="proxy">Ͻ (Proxy)</a></dt> <dd>Ŭ̾Ʈ
<em> </em> ̿ ִ ߰ . Ŭ̾Ʈ û
, Լ ٽ
Ŭ̾Ʈ . Ŭ̾Ʈ ûϸ
Ͻô Ź ûʰ ij Ͽ
ð ִ.<br />
: <a href="mod/mod_proxy.html">mod_proxy</a></dd>
<dt><a name="publickey">Ű (Public Key)</a></dt> <dd><a href="#publickeycryptography">Ű ȣȭ (Public Key
Cryptography)</a> ýۿ Ű ڿ ȣȭϰų
ڰ Ǯ Ű.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="publickeycryptography">Ű ȣȭ (Public Key
Cryptography)</a></dt>
<dd>ȣ ص ٸ Ű ϴ Ī(asymmetric)
ȣȭ ý Ȱ. ȣ ص ϴ ΰ Ű
Ű(key pair) ̷. Ī ȣȭ θ.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="regularexpresion">ǥ (Regular Expression)</a> <a name="regex">(Regex)</a></dt> <dd> ϴ .
, " A ϴ ܾ", " 10ε ȭȣ",
"ǥ ΰְ 빮 Q " ǥ ִ.
ǥ ϸ ſ ϰ ̳ ڿ
ִ. , "images" 丮 Ʒ ִ .gif
.jpg "<code>/images/.*(jpg|gif)$</code>" Ī
ִ. ġ <a href="http://www.pcre.org/">PCRE</a> ̺귯
Ͽ Perlȣȯ ǥ Ѵ.</dd>
<dt><a name="reverseproxy">Ͻ (Reverse Proxy)</a></dt>
<dd>Ŭ̾Ʈ <em> </em>ó ̴ <a href="#proxy">Ͻ (proxy)</a> . Ȼ Ȥ ϸ
лϱ Ŭ̾Ʈ 涧 ϴ.</dd>
<dt><a name="securesocketslayer">Secure Sockets Layer</a> <a name="ssl">(SSL)</a></dt> <dd>Netscape Communications簡 TCP/IP
Ʈ Ϲ ȣȭ .
Ϲ 뵵 <em>HTTPS</em> (HyperText Transfer Protocol
(HTTP) over SSL)̴.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="serversideincludes">Server Side Includes</a> <a name="ssi">(SSI)</a></dt> <dd>HTML ȿ óþ ϴ
.<br /> : <a href="howto/ssi.html">Server Side Includes Ұ</a></dd>
<dt><a name="session"> (Session)</a></dt>
<dd>Ϲ Ȳ(context) .</dd>
<dt><a name="ssleay">SSLeay</a></dt>
<dd>Eric A. Young SSL/TLS ̺귯</dd>
<dt><a name="symmetriccryptophraphy">Ī ȣ (Symmetric
Cryptography)</a></dt>
<dd>ȣ ص ۾ ȣŰ ϴ <em>ȣ
(Ciphers)</em> Ȱ.<br />
: <a href="ssl/">SSL/TLS Encryption</a></dd>
<dt><a name="tarball">Ÿ (Tarball)</a></dt>
<dd><code>tar</code> Ͽ ϵ . ġ
tar ϰų pkzip Ͽ ȴ.</dd>
<dt><a name="transportlayersecurity">Transport Layer Security</a> <a name="tls">(TLS)</a></dt>
<dd>ͳݱ ǥȭⱸ(Internet Engineering Task
Force, IETF) TCP/IP Ʈ Ϲ ȣȭ
SSL ļ . TLS 1 SSL 3
ϴ.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
<dt><a name="uniformresourcelocator">Uniform Resource Locator</a>
<a name="url">(URL)</a></dt>
<dd>ͳݿ ִ ڿ ̸/ּ. δ <a href="#uniformresourceidentifier">Uniform Resource
Identifier</a> ϴ ϻ Ī̴. URL
<code>http</code> <code>https</code> Ŵ(scheme), ȣƮ,
η ȴ. URL
<code>http://httpd.apache.org/docs/2.4/glossary.html</code>̴.</dd>
<dt><a name="uniformresourceidentifier">Uniform Resource Identifier</a>
<a name="URI">(URI)</a></dt>
<dd> ڿ̳ ڿ Īϱ ڿ.
<a href="http://www.ietf.org/rfc/rfc2396.txt">RFC
2396</a> Ѵ. ̵ ϴ URI
<a href="#url">URL</a>̶ θ.</dd>
<dt><a name="virtualhosting">ȣƮ (Virtual Hosting)</a></dt>
<dd>ġ ϳ Ʈ ϱ. <em>IP ȣƮ</em>
Ʈ IP ּҰ ٸ. <em≯(name-based)
ȣƮ</em> ȣƮ ϹǷ IP ּҿ
Ʈ ִ.<br />
: <a href="vhosts/">ġ ȣƮ </a></dd>
<dt><a name="x.509">X.509</a></dt>
<dd>ſ(International Telecommunication Union,
ITU-T) ϴ . SSL/TLS Ѵ.<br />
: <a href="ssl/">SSL/TLS ȣȭ</a></dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/glossary.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/glossary.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/glossary.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/glossary.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/socache.html 0000664 0001751 0001751 00000000315 13710016232 017314 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: socache.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: socache.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/handler.html.ko.euc-kr 0000664 0001751 0001751 00000026546 14743132254 021151 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ġ ڵ鷯 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>ġ ڵ鷯 </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" title="Korean"> ko </a> |
<a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ġ ڵ鷯 ϴ Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><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><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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_imagemap.html">mod_imagemap</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> ûҶ ġ ۾
"ڵ鷯(handler)" Ѵ. Ϲ
Ϲ ڵ鷯 ִ.
, "óȴ(handled)".</p>
<p>Apache 1.1 ڵ鷯 ְ Ǿ.
ڵ鷯 Ȯڳ ġ
ִ. ̴ Ǹ ̰ ڵ鷯
ο ֱ . (<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> Ͽ .
(core)</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_imagemap.html">mod_imagemap</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>
û <code>footer.pl</code> CGI ũƮ .</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> þ HTTP ϴ Ͽ
<code>send-as-is</code> ڵ鷯 Ѵ.
<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>invoke_handler</code> ܰ
<code>r->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" title="Korean"> ko </a> |
<a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/handler.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/index.html.ru.utf8 0000664 0001751 0001751 00000024640 14743132254 020351 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Server версия 2.4
Документация - HTTP сервер Apache Версия 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="index-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Модули</a> | <a href="./mod/directives.html">Директивы</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Глоссарий</a> | <a href="./sitemap.html">Карта сайта</a></p>
<p class="apache">HTTP сервер Apache Версия 2.4</p>
<img alt="" src="./images/feather.png" /></div>
<div class="up"><a href="http://httpd.apache.org/docs-project/"><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></div>
<div id="page-content"><h1>Apache HTTP Server версия 2.4
Документация</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<form method="get" action="https://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Google Search" type="submit" /><input value="10" name="num" type="hidden" /><input value="ru" name="hl" type="hidden" /><input value="UTF-8" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="Версия 2.4" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value=""List-Post"" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form>
<table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">Примечания к выпуску</a></h2>
<ul><li><a href="new_features_2_4.html">Новые возможности Apache 2.3/2.4</a></li>
<li><a href="new_features_2_2.html">Новые возможности Apache 2.1/2.2</a></li>
<li><a href="new_features_2_0.html">Новые возможности Apache 2.0</a></li>
<li><a href="upgrading.html">Обновление до 2.4 с 2.2</a></li>
<li><a href="license.html">Лицензия Apache</a></li>
</ul>
</div><div class="category"><h2><a name="manual" id="manual">Справочное руководство</a></h2>
<ul><li><a href="install.html">Компиляция и установка</a></li>
<li><a href="invoking.html">Запуск</a></li>
<li><a href="stopping.html">Остановка или перезапуск</a></li>
<li><a href="mod/quickreference.html">Директивы конфигурации среды выполнения</a></li>
<li><a href="mod/">Модули</a></li>
<li><a href="mpm.html">Модули многопроцессорной обработки (MPMs)</a></li>
<li><a href="filter.html">Фильтры</a></li>
<li><a href="handler.html">Обработчики</a></li>
<li><a href="expr.html">Парсер выражений</a></li>
<li><a href="mod/overrides.html">Индекс классов переопределения для .htaccess</a></li>
<li><a href="programs/">Сервер и вспомогательные программы</a></li>
<li><a href="glossary.html">Глоссарий</a></li>
</ul>
</div></td><td><div class="category"><h2><a name="usersguide" id="usersguide">Руководство пользователя</a></h2>
<ul><li><a href="getting-started.html">Начало работы</a></li>
<li><a href="bind.html">Привязка к адресам и портам</a></li>
<li><a href="configuring.html">Файлы конфигурации</a></li>
<li><a href="sections.html">Разделы конфигурации</a></li>
<li><a href="caching.html">Кэширование контента</a></li>
<li><a href="content-negotiation.html">Согласование контента</a></li>
<li><a href="dso.html">Динамические общие объекты (DSO)</a></li>
<li><a href="env.html">Переменные среды</a></li>
<li><a href="logs.html">Лог-файлы</a></li>
<li><a href="urlmapping.html">Сопоставление URL-адресов с файловой системой</a></li>
<li><a href="misc/perf-tuning.html">Настройка производительности</a></li>
<li><a href="misc/security_tips.html">Советы по безопасности</a></li>
<li><a href="server-wide.html">Общесерверная конфигурация</a></li>
<li><a href="ssl/">SSL/TLS шифрование</a></li>
<li><a href="suexec.html">Выполнение SuExec для CGI</a></li>
<li><a href="rewrite/">Перезапись URL с помощью mod_rewrite</a></li>
<li><a href="vhosts/">Виртуальные хосты</a></li>
</ul>
</div></td><td class="col3"><div class="category"><h2><a name="howto" id="howto">Инструкции / Учебники</a></h2>
<ul><li><a href="howto/auth.html">Аутентификация и авторизация</a></li>
<li><a href="howto/access.html">Контроль доступа</a></li>
<li><a href="howto/cgi.html">CGI: динамический контент</a></li>
<li><a href="howto/htaccess.html">Файлы .htaccess</a></li>
<li><a href="howto/ssi.html">Включения на стороне сервера (SSI)</a></li>
<li><a href="howto/public_html.html">Веб-каталоги для каждого пользователя (public_html)</a></li>
<li><a href="howto/reverse_proxy.html">Руководство по настройке обратного прокси</a></li>
<li><a href="howto/http2.html">Руководство HTTP/2</a></li>
</ul>
</div><div class="category"><h2><a name="platform" id="platform">Специфические примечания к платформе</a></h2>
<ul><li><a href="platform/windows.html">Microsoft Windows</a></li>
<li><a href="platform/rpm.html">RPM-based системы (Redhat / CentOS / Fedora)</a></li>
<li><a href="platform/netware.html">Novell NetWare</a></li>
<li><a href="platform/ebcdic.html">EBCDIC Port</a></li>
</ul>
</div><div class="category"><h2><a name="other" id="other">Другие темы</a></h2>
<ul><li><a href="http://wiki.apache.org/httpd/FAQ">Часто задаваемые вопросы</a></li>
<li><a href="sitemap.html">Карта сайта</a></li>
<li><a href="developer/">Документация для разработчиков</a></li>
<li><a href="http://httpd.apache.org/docs-project/">Помощь с документацией</a></li>
<li><a href="misc/">Прочие примечания</a></li>
<li><a href="http://wiki.apache.org/httpd/">Вики</a></li>
</ul>
</div></td></tr></table></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Глоссарий</a> | <a href="./sitemap.html">Карта сайта</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/install.html 0000664 0001751 0001751 00000001203 13710016232 017352 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: install.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: install.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: install.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: install.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: install.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: install.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: install.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/logs.html.ja.utf8 0000664 0001751 0001751 00000120205 14743132254 020144 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ログファイル - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>ログファイル</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/logs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/logs.html" title="Japanese"> ja </a> |
<a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>ウェブサーバを効果的に管理するためには、サーバの活動やパフォーマンス、
今発生しているかもしれない問題に関するフィードバックを得ることが必要です。
Apache HTTP サーバには非常に包括的で柔軟なロギング機能があります。
この文書はロギング機能の設定の仕方と、ログに何が書かれているかを
理解するための方法を説明します。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#security">
セキュリティに関する警告</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errorlog">エラーログ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#accesslog">アクセスログ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rotation">ログの交替</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#piped">パイプ経由のログ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhosts">バーチャルホスト</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">他のログファイル</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="security" id="security">
セキュリティに関する警告</a></h2>
<p>Apache がログファイルを書いているディレクトリに書き込める人は、
ほぼ確実にサーバが起動された uid へのアクセスを手に入れることができます。
そして、それは通常は root ユーザです。
ちゃんと結果を考えることなく、そのディレクトリへの
書き込み権限を与え<em>ない</em>でください。詳しくは
<a href="misc/security_tips.html">セキュリティのこつ</a>の文書を
読んでください。</p>
<p>加えて、ログファイルにはクライアントからの情報がそのまま、
エスケープされることなく書かれています。ですから、悪意のある
クライアントがログファイルに制御文字を挿入することができます。
生のログを扱うときは注意してください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errorlog" id="errorlog">エラーログ</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code></li></ul></td></tr></table>
<p><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> ディレクティブにより
名前と場所が決まるサーバのエラーログは、一番重要なログファイルです。
Apache の診断情報はここに送られ、リクエストを処理しているときに
発生したエラーはすべてここに記録されます。サーバを起動したときや、
サーバの動作に問題が起こったときは、一番最初に調べるべき
ところです。間違いの詳細や修正方法がそこに書かれていることが
よくあります。</p>
<p>エラーログは普通はファイルに書かれます (通常 Unix システムでは
<code>error_log</code>、Windows と OS/2 では <code>error.log</code>)。
Unix システムではエラーを <code>syslog</code> や
<a href="#piped">パイプでプログラムに送る</a> ことができます。</p>
<p>エラーログの書式は比較的自由度の高いもので、説明的に書かれています。
ただし、いくつかの情報はほとんどのエラーログのエントリにあります。
例えば、代表的なものに次のようなメッセージがあります。</p>
<div class="example"><p><code>
[Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1]
client denied by server configuration:
/export/home/live/ap/htdocs/test
</code></p></div>
<p>ログエントリの最初の項目はメッセージの日付と時刻です。
二つめの項目は報告されているエラーの重要度です。
<code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> で重要度のレベルを
制限することによりエラーログに送られるエラーの種類を制御することが
できます。三つ目の項目はエラーを発生させたクライアントの IP アドレス
です。残りはメッセージで、この場合はサーバがクライアントのアクセスを
拒否するように設定されている、ということを示しています。
サーバはリクエストされた文書の (ウェブのパスではなく) ファイルシステムの
パスを報告します。</p>
<p>非常に広範囲のメッセージがエラーログに現れます。たいていのものは
上の例のような感じです。エラーログには CGI スクリプトのデバッグ
出力も書かれます。CGI スクリプトが <code>stderr</code> に書いた
すべての情報は直接エラーログにコピーされます。</p>
<p>情報を追加したり削除したりしてエラーログをカスタマイズすることは
できません。しかし、リクエストに対するエラーログのエントリは、
対応するエントリが<a href="#accesslog">アクセスログ</a>にあります。
例えば、上の例のエントリはアクセスログのステータスコード 403 の
エントリに対応します。アクセスログはカスタマイズ可能ですので、
そちらを使うことによりエラーの状況に関する情報をより多く
手に入れることができます。</p>
<p>テストの最中は、問題が発生しているかどうかを見るために、
常にエラーログを監視するのが役に立つ場合がよくあります。
Unix システムでは、次のものを使うことができます。</p>
<div class="example"><p><code>
tail -f error_log
</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="accesslog" id="accesslog">アクセスログ</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li></ul></td></tr></table>
<p>サーバアクセスログはサーバが処理をしたすべてのリクエストを
記録します。アクセスログの場所と内容は <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
ディレクティブにより決まります。ログの内容の選択を簡潔にするために
<code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
ディレクティブを使用することができます。このセクションはアクセスログに
情報を記録するためのサーバの設定方法を説明します。</p>
<p>もちろん、アクセスログに情報を蓄積することはログ管理の
始まりに過ぎません。次の段階は有用な統計を取るためにこの情報を
解析することです。一般的なログ解析はこの文書の範囲外で、
ウェブサーバ自身の仕事というわけでもありません。この話や、
ログ解析を行なうアプリケーションの情報を得るには、<a href="http://dmoz.org/Computers/Software/Internet/Site_Management/Log_Analysis/">
Open Directory</a> を調べてください。</p>
<p>いろんなバージョンの Apache httpd が mod_log_config,
mod_log_agent, <code>TransferLog</code> ディレクティブといった、
他のモジュールやディレクティブを使ってアクセスのロギングを
制御してきました。今では、<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> がすべての古い
ディレクティブの機能を含むようになっています。</p>
<p>アクセスログの書式は非常に柔軟な設定が可能です。
書式は C の printf(1) フォーマット文字列に非常に似た
<code class="directive"><a href="./mod/mod_log_config.html#フォーマット文字列">フォーマット文字列</a></code>
により指定されます。いくつか次の節で例を示します。
フォーマット文字列に使用できる内容の一覧は <a href="mod/mod_log_config.html">mod_log_config の文書</a>
を見てください。</p>
<h3><a name="common" id="common">Common Log Format</a></h3>
<p>アクセスログのよくある設定に以下のものがあります。</p>
<div class="example"><p><code>
LogFormat "%h %l %u %t \"%r\" %>s %b" common<br />
CustomLog logs/access_log common
</code></p></div>
<p>これは、<em>ニックネーム</em> <code>common</code> を定義し、
ログのフォーマット文字列の一つと関連付けます。フォーマット文字列は
パーセントディレクティブからなり、それぞれのパーセントディレクティブは
サーバにどの情報をロギングするかを指示します。フォーマット文字列に
文字をそのまま入れることもでき、それらはログの出力に直接コピーされます。
そこに引用文字 (<code>"</code>) を書くときは、
フォーマット文字列の最後として解釈
されることを防ぐためにバックスラッシュでエスケープする必要があります。
フォーマット文字列には改行用の "<code>\n</code>"、タブ用の
"<code>\t</code>" という特別な制御文字も含めることができます。</p>
<p><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> ディレクティブは
既に定義された
<em>ニックネーム</em> を使って新しいログファイルを設定します。
アクセスログのファイル名はスラッシュで始まらない限り、
<code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> からの相対パスとして
扱われます。</p>
<p>上の設定は Common Log Format (CLF) と呼ばれる形式で
ログエントリを書きます。この標準の形式は異なるウェブサーバの多くが
生成することができ、多くのログ解析プログラムが読みこむことができます。
CLF により生成されたログファイルのエントリは以下のようになります:</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
</code></p></div>
<p>このログエントリのそれぞれの部分の意味は以下で説明します。</p>
<dl>
<dt><code>127.0.0.1</code> (<code>%h</code>)</dt>
<dd>これはサーバへリクエストをしたクライアント (リモートホスト)
の IP アドレスです。<code class="directive"><a href="./mod/core.html#hostnamelookups">HostnameLookups</a></code> が
<code>On</code> の場合は、サーバはホスト名を調べて、
IP アドレスが書かれているところに記録します。しかし、この設定は
サーバをかなり遅くするので、あまりお勧めできません。
そうではなく、<code class="program"><a href="./programs/logresolve.html">logresolve</a></code> の
ようなログの後処理を行なうプログラムでホスト名を調べるのが良いでしょう。
ここに報告される IP アドレスは必ずしもユーザが使っているマシンの
ものであるとは限りません。ユーザとサーバの間にプロキシサーバが
あれば、このアドレスは元のマシンのものではなく、プロキシの
アドレスになります。</dd>
<dt><code>-</code> (<code>%l</code>)</dt>
<dd>出力中の「ハイフン」は要求された情報が手に入らなかったということを
意味します。この場合、取得できなかった情報はクライアントのマシンの
<code>identd</code> により決まる RFC 1413 のクライアントの
アイデンティティです。この情報はあまり信用することができず、
しっかりと管理された内部ネットワークを除いては使うべきではありません。
Apache は <code class="directive"><a href="./mod/core.html#identitycheck">IdentityCheck</a></code> が
<code>On</code> になっていない限り、この情報を得ようとすらしません。</dd>
<dt><code>frank</code> (<code>%u</code>)</dt>
<dd>これは HTTP 認証による、ドキュメントをリクエストした人の
ユーザ ID です。CGI スクリプトには通常同じ値が <code>REMOTE_USER</code>
環境変数として与えられます。リクエストのステータスコード
(以下を参照) が 401 であった場合は、ユーザは認証に失敗しているので、
この値は信用できません。ドキュメントがパスワードで保護されていない
場合は、この部分は前のものと同じように "<code>-</code>" に
なります。</dd>
<dt><code>[10/Oct/2000:13:55:36 -0700]</code>
(<code>%t</code>)</dt>
<dd>
サーバがリクエストを受け取った時刻です。書式は:
<p class="indent">
<code>[day/month/year:hour:minute:second zone]<br />
day = 2*digit<br />
month = 3*letter<br />
year = 4*digit<br />
hour = 2*digit<br />
minute = 2*digit<br />
second = 2*digit<br />
zone = (`+' | `-') 4*digit</code>
</p>
ログのフォーマット文字列に <code>%{format}t</code> を
指定することで、別の形式で時刻を表示させることもできます。
このとき、<code>format</code> は C の標準ライブラリの
<code>strftime(3)</code> の形式になります。
</dd>
<dt><code>"GET /apache_pb.gif HTTP/1.0"</code>
(<code>\"%r\"</code>)</dt>
<dd>クライアントからのリクエストが二重引用符の中に示されています。
リクエストには多くの有用な情報があります。まず、この場合クライアントが
使ったメソッドは <code>GET</code> です。次に、クライアントは
リソース <code>/apache_pb.gif</code> を要求しました。そして、
クライアントはプロトコル <code>HTTP/1.0</code> を使用しました。
リクエストの各部分を独立にログ収集することもできます。例えば、
フォーマット文字列 "<code>%m %U%q %H</code>" は
メソッド、パス、クエリ文字列、プロトコルをログ収集し、
結局 "<code>%r</code>" とまったく同じ出力になります。</dd>
<dt><code>200</code> (<code>%>s</code>)</dt>
<dd>サーバがクライアントに送り返すステータスコードです。
この情報は、リクエストが成功応答 (2 で始まるコード) であったか、
リダイレクション (3 で始まるコード) であったか、クライアントによる
エラー (4 で始まるコード) であったか、サーバのエラー (5 で始まるコード)
であったか、を表すので、非常に大切です。ステータスコードの
完全なリストは <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">HTTP
規格</a> (RFC2616 第 10 節) にあります。</dd>
<dt><code>2326</code> (<code>%b</code>)</dt>
<dd>この最後の部分はクライアントに送信されたオブジェクトの、
応答ヘッダを除いたサイズを表します。コンテントがクライアントに送られなかった
場合は、この値は "<code>-</code>" になります。コンテントが無い場合に
"<code>0</code>" をログ収集するには、<code>%b</code> ではなく
<code>%B</code> を使ってください。</dd>
</dl>
<h3><a name="combined" id="combined">Combined Log Format</a></h3>
<p>もう一つのよく使われる書式は Combined Log Format と呼ばれています。
以下のようにして使うことができます。</p>
<div class="example"><p><code>
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\"" combined<br />
CustomLog log/access_log combined
</code></p></div>
<p>この書式の最初の方は Common Log Format とまったく同じで、最後に
二つ追加のエントリがあります。追加のエントリはパーセントディレクティブ
<code>%{<em>header</em>}i</code> を使っています。ここで
<em>header</em> は HTTP のリクエストヘッダのどれかです。この書式による
アクセスログは以下のような感じになります:</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
"http://www.example.com/start.html" "Mozilla/4.08 [en]
(Win98; I ;Nav)"
</code></p></div>
<p>追加のエントリは:</p>
<dl>
<dt><code>"http://www.example.com/start.html"</code>
(<code>\"%{Referer}i\"</code>)</dt>
<dd>"Referer" (意図的な綴り間違い) HTTP リクエストヘッダです。
これはクライアントが報告してくる参照元のサイトを表します。
(この場合は、<code>/apache_pb.gif</code> にリンクしているか、
それを含んでいるページです)。</dd>
<dt><code>"Mozilla/4.08 [en] (Win98; I ;Nav)"</code>
(<code>\"%{User-agent}i\"</code>)</dt>
<dd>User-Agent HTTP リクエストヘッダです。これはクライアントのブラウザが
自分自身のことを報告してくる情報です。</dd>
</dl>
<h3><a name="multiple" id="multiple">複数のアクセスログ</a></h3>
<p>複数のアクセスログは単に設定ファイルに複数の <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
ディレクティブを書くことで作成されます。例えば、以下のディレクティブは
三つのアクセスログを作ります。最初のものは基本的な CLF の情報で、
二つ目と三つ目は referer とブラウザの情報です。最後二つの
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> は
<code>ReferLog</code> ディレクティブと
<code>AgentLog</code> ディレクティブの効果をまねる方法を示しています。</p>
<div class="example"><p><code>
LogFormat "%h %l %u %t \"%r\" %>s %b" common<br />
CustomLog logs/access_log common<br />
CustomLog logs/referer_log "%{Referer}i -> %U"<br />
CustomLog logs/agent_log "%{User-agent}i"
</code></p></div>
<p>この例は <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> で
ニックネームを定義する必要がない、
ということも示しています。ニックネームの代わりに、
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> ディレクティブに
直接ログの書式を指定することができます。</p>
<h3><a name="conditional" id="conditional">条件付きログ</a></h3>
<p>クライアントのリクエストの特徴に基づいてアクセスログにエントリの
一部をロギングしない方が便利なことがあります。これは <a href="env.html">環境変数</a> の補助により簡単に実現できます。まず、
リクエストが何らかの条件に合うということを表すために環境変数が
設定される必要があります。これは通常は <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> により
行なわれます。そして、<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> ディレクティブの
<code>env=</code> 節を使って環境変数が設定されているリクエストを
含めたり排除したりすることができます。いくつか例を挙げます:</p>
<div class="example"><p><code>
# Mark requests from the loop-back interface<br />
SetEnvIf Remote_Addr "127\.0\.0\.1" dontlog<br />
# Mark requests for the robots.txt file<br />
SetEnvIf Request_URI "^/robots\.txt$" dontlog<br />
# Log what remains<br />
CustomLog logs/access_log common env=!dontlog
</code></p></div>
<p>他の例として、英語を話す人からのリクエストとそれ以外の人からのリクエストを
分けたい、という場合を考えてみてください。</p>
<div class="example"><p><code>
SetEnvIf Accept-Language "en" english<br />
CustomLog logs/english_log common env=english<br />
CustomLog logs/non_english_log common env=!english
</code></p></div>
<p>ここまででは条件付きロギングが非常に強力で柔軟であることを示してきましたが、
それがログの内容を制御する唯一の方法というわけではありません。ログファイルは
サーバの活動の完全な記録である方がより役に立ちます。単純にログファイルを
後処理して、考慮したくないログを削除する方が簡単であることがよくあります。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="rotation" id="rotation">ログの交替</a></h2>
<p>普通の負荷のサーバでさえ、ログファイルに保存される情報の量は
膨大になります。アクセスログのファイルは普通 10,000 リクエスト毎に
1 MB 以上増えます。ですから、既存のログを移動したり、削除したりして、
定期的にログを交替させることが必要になります。これはサーバの実行中には
行なえません。というのは、Apache はファイルが open されている間は
ずっと古いログファイルに書き続けるからです。
新しいログファイルを open できるように、ログファイルが移動されたり
削除された後に、サーバを<a href="stopping.html">再起動</a>する
必要があります。</p>
<p><em>優雅な</em> 再起動を行なうことで、サーバは既存のコネクションや
処理待ちのコネクションを失うことなく新しいログファイルを open させる
ことができます。しかし、これを実現するために、サーバは古いリクエストを
扱っている間は古いログファイルに書き続ける必要があります。
ですから、再起動の後ではログファイルの処理を始める前に、しばらく待たなければ
なりません。単にログを交替させて、ディスクの節約のために古いログを
圧縮する普通のシナリオは:</p>
<div class="example"><p><code>
mv access_log access_log.old<br />
mv error_log error_log.old<br />
apachectl graceful<br />
sleep 600<br />
gzip access_log.old error_log.old
</code></p></div>
<p>ログの交替をするもう一つの方法は<a href="#piped">パイプ経由のログ</a>を使うもので、次の節で説明されています。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="piped" id="piped">パイプ経由のログ</a></h2>
<p>Apache httpd はエラーログとアクセスログをファイルに直接書く代わりに、
パイプを通して別のプログラムに書き出すことができます。
この機能により、主サーバにコードを追加することなく
ロギングの柔軟性が非常に高まっています。パイプにログを書くためには、
単にファイル名をパイプ文字 "<code>|</code>" に置き換え、その続きに
標準入力からログのエントリを受けとる実行プログラムの名前を書くだけです。
Apache はパイプ経由のログ用のプロセスをサーバの起動時に実行し、
サーバの実行中にそのプログラムがクラッシュしたときはそれを再び
実行します。(この最後の機能がこの技術が「信頼性のあるパイプ経由のロギング」
と呼ばれている理由です。)</p>
<p>パイプ経由のログ用のプロセスは Apache httpd の親プロセスから起動され、
そのプロセスのユーザ ID を継承します。これは、パイプ経由のログ用の
プログラムは普通 root として実行されることを意味します。
ですから、プログラムを簡単で安全に保つことが非常に重要です。</p>
<p>パイプ経由のログの重要な利用法は、サーバの再起動なしでログの交替を
することです。Apache HTTP サーバにはこのための <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> と呼ばれる簡単な
プログラムが付属しています。たとえば、24 時間毎にログを交替させるには、
以下のものを使うことができます:</p>
<div class="example"><p><code>
CustomLog "|/usr/local/apache/bin/rotatelogs
/var/log/access_log 86400" common
</code></p></div>
<p>パイプの先で呼ばれるコマンド全体が引用符で囲まれていることに注目して
ください。この例はアクセスログを使っていますが、エラーログにも同じ技術を
使うことができます。</p>
<p>似ているけれど、よりずっと柔軟な
<a href="http://www.cronolog.org/">cronolog</a> というログ交替用の
プログラムが外部のサイトにあります。</p>
<p>条件付きロギングと同様、パイプ経由のログは非常に強力な
道具ですが、オフラインの後処理のような、より簡単な解決方法があるときは
使わない方が良いでしょう。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhosts" id="virtualhosts">バーチャルホスト</a></h2>
<p>多くの <a href="vhosts/">バーチャルホスト</a> のあるサーバを実行している
ときは、ログファイルの扱い方にいくつかの方法があります。
まず、単独のホストのみのサーバとまったく同じようにログを使うことができます。
ロギングディレクティブを主サーバのコンテキストの
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> セクションの外に置くことで、
すべてのログを同じアクセスログとエラーログにログ収集することができます。
この手法では個々のバーチャルホストの統計を簡単にとることはできません。</p>
<p><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> や
<code class="directive"><a href="./mod/mod_log_config.html#errorlog">ErrorLog</a></code> ディレクティブが
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> の中に
置かれた場合は、そのバーチャル
ホストへのすべてのリクエストやエラーがそこで指定されたファイルにのみ
ログ収集されます。ロギングディレクティブのないバーチャルホストは
依然としてリクエストが主サーバのログに送られます。この手法は少ない
バーチャルホストに対しては非常に有用ですが、ホストの数が非常に多くなると
管理が大変になります。さらに、<a href="vhosts/fd-limits.html">ファイル記述子の限界</a>の問題を起こすことが
あります。</p>
<p>アクセスログには、非常に良い妥協案があります。バーチャルホストの
情報をログのフォーマット文字列に加えることで、すべてのホストへの
リクエストを同じログにログ収集して、後でログを個々のファイルに分割することが
できます。たとえば、以下のディレクティブを見てください。</p>
<div class="example"><p><code>
LogFormat "%v %l %u %t \"%r\" %>s %b"
comonvhost<br />
CustomLog logs/access_log comonvhost
</code></p></div>
<p><code>%v</code> がリクエストを扱っているバーチャルホストの名前を
ログ収集するために使われています。そして、<a href="programs/other.html">split-logfile</a> のようなプログラムを
使ってアクセスログを後処理することで、
バーチャルホスト毎のファイルにログを分割することができます。</p>
<p>残念ながら、エラーログには同様の手法はありません。ですから、
すべてのバーチャルホストを同じエラーログの中に混ぜるか、
バーチャルホスト毎にエラーログを使うかを選ばなければなりません。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">他のログファイル</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</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_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_log_forensic.html#forensiclog">ForensicLog</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritelog">RewriteLog</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptloglength">ScriptLogLength</a></code></li></ul></td></tr></table>
<h3>実際に送受信したバイト数のログ</h3>
<p><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code> は、
ネットワーク上で実際に送受信した数をログする
二つのフィールド (%I と %O) を
<code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
ディレクティブに追加します。</p>
<h3>Forensic ログ</h3>
<p><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code> はクライアントリクエストの
forensic ログを取ります。ログはリクエスト処理前と処理後に
行われますので、1 リクエストに対して 2 行のログが出力されます。
forensic ロガーはとても厳密でカスタマイズできません。
デバッグやセキュリティ用のツールとして有効かもしれません。</p>
<h3><a name="pidfile" id="pidfile">PID ファイル</a></h3>
<p>起動時に、Apache は親 httpd プロセスのプロセス ID を
<code>logs/httpd.pid</code> に保存します。この
ファイル名は <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> ディレクティブを使って
変更することができます。プロセス ID は管理者が親プロセスに
シグナルを送ることでデーモンを再起動したり終了させたりするときに
使用します。Windows では、代わりに -k コマンドオプションを
使ってください。詳しい情報は <a href="stopping.html">終了と
再起動</a> のページを見てください。</p>
<h3><a name="scriptlog" id="scriptlog">スクリプトログ</a></h3>
<p>デバッグの補助のために、<code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code> ディレクティブは
CGI スクリプトの入力と出力を記録するようにできます。
これはテスト用にのみ使用して、通常のサーバでは使用しないでください。
詳しい情報は <a href="mod/mod_cgi.html">mod_cgi の文書</a> にあります。</p>
<h3><a name="rewritelog" id="rewritelog">リライトログ</a></h3>
<p><code class="directive"><a href="./mod/mod_rewrite.html#mod_rewrite">mod_rewrite</a></code> の強力で
複雑な機能を
使っているときは、ほぼいつもデバッグを簡単にするために
<code class="directive"><a href="./mod/mod_rewrite.html#rewritelog">RewriteLog</a></code> の使用が
必要でしょう。このログファイルにはリライトエンジンがリクエストを
書き換える方法の詳細な解析が出力されます。詳しさの度合は <code class="directive"><a href="./mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</a></code>
で制御できます。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/logs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/logs.html" title="Japanese"> ja </a> |
<a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/logs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/index.html.es 0000664 0001751 0001751 00000023401 14743132254 017437 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Server Versión 2.4
Documentación - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="index-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="./images/feather.png" /></div>
<div class="up"><a href="http://httpd.apache.org/docs-project/"><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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a></div>
<div id="page-content"><h1>Apache HTTP Server Versión 2.4
Documentación</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<form method="get" action="https://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Buscar en Google" type="submit" /><input value="10" name="num" type="hidden" /><input value="es" name="hl" type="hidden" /><input value="ISO-8859-1" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="Versión 2.4" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value=""List-Post"" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form>
<table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">Notas de la versión</a></h2>
<ul><li><a href="new_features_2_4.html">Nuevas funcionalidades en Apache 2.3/2.4</a></li>
<li><a href="new_features_2_2.html">Nuevas funcionalidades en Apache 2.1/2.2</a></li>
<li><a href="new_features_2_0.html">Nuevas funcionalidades en Apache 2.0</a></li>
<li><a href="upgrading.html">Actualizar a la versión 2.4 desde la 2.2</a></li>
<li><a href="license.html">Licencia Apache </a></li>
</ul>
</div><div class="category"><h2><a name="manual" id="manual">Manual de Referencia</a></h2>
<ul><li><a href="install.html">Compilar e Instalar</a></li>
<li><a href="invoking.html">Ejecutando Apache</a></li>
<li><a href="stopping.html">Parada y Reinicio de Apache</a></li>
<li><a href="mod/quickreference.html">Directivas de configuración en tiempo de ejecución</a></li>
<li><a href="mod/">Módulos</a></li>
<li><a href="mpm.html">Módulos de Procesamiento Múltiple (MPM)</a></li>
<li><a href="filter.html">Filtros</a></li>
<li><a href="handler.html">Handlers</a></li>
<li><a href="expr.html">Analizador de Expresiones</a></li>
<li><a href="mod/overrides.html">Sobreescritura de la clase índice .htaccess</a></li>
<li><a href="programs/">Programas de Soporte y Servidor</a></li>
<li><a href="glossary.html">Glosario</a></li>
</ul>
</div></td><td><div class="category"><h2><a name="usersguide" id="usersguide">Guía de Usuario</a></h2>
<ul><li><a href="getting-started.html">Empezando</a></li>
<li><a href="bind.html">Enlazando Direcciones y Puertos</a></li>
<li><a href="configuring.html">Ficheros de Configuración</a></li>
<li><a href="sections.html">Secciones de Configuración</a></li>
<li><a href="caching.html">Almacenamiento de Contenido en Caché</a></li>
<li><a href="content-negotiation.html">Negociación de Contenido</a></li>
<li><a href="dso.html">Objetos Compartidos Dinámicamente (DSO)</a></li>
<li><a href="env.html">Variables de Entorno</a></li>
<li><a href="logs.html">Ficheros de Log</a></li>
<li><a href="compliance.html">Cumplimiento del Protocolo HTTP</a></li>
<li><a href="urlmapping.html">Mapeo de URLs al Sistema de Ficheros</a></li>
<li><a href="misc/perf-tuning.html">Optimización del Rendimiento</a></li>
<li><a href="misc/security_tips.html">Consejos de seguridad</a></li>
<li><a href="server-wide.html">Configuración básica del Servidor</a></li>
<li><a href="ssl/">Cifrado SSL/TLS</a></li>
<li><a href="suexec.html">Ejecución de Suexec para CGI</a></li>
<li><a href="rewrite/">Reescritura de URL con mod_rewrite</a></li>
<li><a href="vhosts/">Servidores Virtuales</a></li>
</ul>
</div></td><td class="col3"><div class="category"><h2><a name="howto" id="howto">How-To / Tutoriales</a></h2>
<ul><li><a href="howto">Índice de Tutoriales </a></li>
<li><a href="howto/auth.html">Autenticación y Autorización</a></li>
<li><a href="howto/access.html">Control de Acceso</a></li>
<li><a href="howto/cgi.html">CGI: Contenido Dinámico</a></li>
<li><a href="howto/htaccess.html">Ficheros .htaccess</a></li>
<li><a href="howto/ssi.html">Inclusiones del Lado del Servidor (SSI)</a></li>
<li><a href="howto/public_html.html">Directorios Web por Usuario
(public_html)</a></li>
<li><a href="howto/reverse_proxy.html">Guía de configuración de Proxy Inverso</a></li>
<li><a href="howto/http2.html">Guía HTTP/2 </a></li>
</ul>
</div><div class="category"><h2><a name="platform" id="platform">Notas Sobre Plataformas Específicas</a></h2>
<ul><li><a href="platform/windows.html">Microsoft Windows</a></li>
<li><a href="platform/rpm.html">Sistemas Basados en RPM (Redhat / CentOS / Fedora)</a></li>
<li><a href="platform/netware.html">Novell NetWare</a></li>
</ul>
</div><div class="category"><h2><a name="other" id="other">Otros Temas</a></h2>
<ul><li><a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a></li>
<li><a href="sitemap.html">Mapa del Sitio</a></li>
<li><a href="developer/">Documentación para Desarrolladores</a></li>
<li><a href="http://httpd.apache.org/docs-project/">Contribuir en la Documentación</a></li>
<li><a href="misc/">Otras Notas</a></li>
<li><a href="http://wiki.apache.org/httpd/">Wiki</a></li>
</ul>
</div></td></tr></table></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/mpm.html.tr.utf8 0000664 0001751 0001751 00000034301 14743132254 020025 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Çok Süreçlilik Modülleri (MPM’ler) - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Çok Süreçlilik Modülleri (MPM’ler)</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Bu belgede Çok Süreçlilik Modülü denince ne anlaşıldığı ve bunların
Apache HTTP Sunucusu tarafından nasıl kullanıldıkları açıklanmıştır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Giriş</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#defaults">Öntanımlı MPM’ler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#static">Bir MPM'i bir duruk modül olarak derlemek</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#dynamic">Bir MPM'i bir DSO modülü olarak derlemek</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="introduction" id="introduction">Giriş</a></h2>
<p>Apache HTTP Sunucusu çok çeşitli platformlar üstünde farklı ortamlarda
çalışabilen güçlü ve esnek bir HTTP sunucusu olarak tasarlanmıştır.
Farklı platformlar ve farklı ortamlar çoğunlukla farklı özellikler veya
aynı özelliğin en yüksek verimlilikle gerçeklenmesi için farklı yöntemler
gerektirir. Apache httpd, geniş ortam çeşitliliğini daima modüler
tasarımı sayesinde uzlaştırmıştır. Bu tasarım, site yöneticilerine,
sunucularında bulunmasını istedikleri özellikleri derleme sırasında veya
çalışma anında gerekli modülleri yüklemek suretiyle seçebilme imkanı
verir.</p>
<p>Apache HTTP Sunucusu 2.0, bu modüler tasarımı sunucunun en temel
işlevlerine kadar indirmiştir. Sunucu, Çok Süreçlilik Modülleri adı
verilen ve makine üzerindeki ağ portlarının bağlanmasından, isteklerin
kabul edilmesinden ve bu istekleri yanıtlayacak çocuklara dağıtmaktan
sorumlu olan modüllerin seçimine imkan verecek bir yapılanma ile
gelir.</p>
<p>Sunucunun modüler tasarımının bu seviyede genişletilmesi iki önemli
yarar sağlar:</p>
<ul>
<li>Apache httpd geniş çeşitlilikteki işletim sistemlerini daha temiz ve
daha verimli bir şekilde destekleyebilmektedir. Özellikle,
<code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code> modülü, Apache httpd 1.3’te kullanılan POSIX
katmanının yerine işletim sistemine özgü özellikleri
kullanabildiğinden, Apache HTTP Sunucusunun Windows sürümü artık çok
daha verimli bir duruma gelmiştir. Aynı fayda özelleştirilmiş MPM’lerle
diğer işletim sistemlerine de sağlanmıştır.</li>
<li>Sunucu, belli bir sitenin ihtiyaçlarına uygun olarak daha iyi
kişiselleştirilebilmektedir. Örneğin, eski yazılım ile uyumluluk ve
kararlılığa önem veren siteler <code class="module"><a href="./mod/prefork.html">prefork</a></code> modülünü
kullanabilirken, daha geniş ölçeklenebilirlik gerektiren siteler
<code class="module"><a href="./mod/worker.html">worker</a></code> veya <code class="module"><a href="./mod/event.html">event</a></code> gibi evreli MPM
modüllerinden birini seçebilmektedir.</li>
</ul>
<p>Kullanıcı açısından MPM’lerin diğer Apache httpd modüllerinden görünüşte
bir farkı yoktur. Asıl fark sunucuya yüklenebilecek azami MPM modülü
sayısının bir ve yalnız bir olarak sınırlanmış olmasıdır. Mevcut MPM
modülleri <a href="mod/">modül dizini</a> sayfasında listelenmiştir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="defaults" id="defaults">Öntanımlı MPM’ler</a></h2>
<p>Aşağıdaki tabloda çeşitli işletim sistemlerinde öntanımlı olan MPM’ler
listelenmiştir. Derleme sırasında başka bir seçim yapmadığınız takdirde
bu işletim sistemlerinde bu MPM’ler seçilmiş olacaktır.</p>
<table class="bordered"><tr><td>Netware</td><td><code class="module"><a href="./mod/mpm_netware.html">mpm_netware</a></code></td></tr>
<tr class="odd"><td>OS/2</td><td><code class="module"><a href="./mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
<tr><td>Unix</td><td>Platformun yapabildiklerine bağlı olarak,
<code class="module"><a href="./mod/prefork.html">prefork</a></code>, <code class="module"><a href="./mod/worker.html">worker</a></code> veya
<code class="module"><a href="./mod/event.html">event</a></code></td></tr>
<tr class="odd"><td>Windows</td><td><code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
</table>
<div class="note"><p>'Unix' burada Unix benzeri işletim sistemleri anlamında
kullanılmıştır (örn, Linux, BSD, Solaris, Mac OS X, vb.</p></div>
<p>Unix durumunda, hangi MPM'nin kurulacağı kararı şu 2 soruya verilecek
yanıta bağlıdır:</p>
<p>1. Sistem evreleri destekliyor mu?</p>
<p>2. Sistem evreleri "thread-safe polling" anlamında destekliyor mu
(özellikle kqueue ve epoll işlevlerini)?</p>
<p>Her iki soruya da verilen yanıt 'evet' ise, öntanımlı MPM'niz
<code class="module"><a href="./mod/event.html">event</a></code> modülüdür.</p>
<p>Birincinin yanıtı 'evet' ikincinin 'hayır' ise öntanımlı MPM'niz
<code class="module"><a href="./mod/worker.html">worker</a></code> modülüdür.</p>
<p>Yanıtların her ikisi de 'hayır' ise öntanımlı MPM'niz
<code class="module"><a href="./mod/prefork.html">prefork</a></code> modülüdür.</p>
<p>Uygulamada, günümüzdeki işletim sistemlerinin tümü bu iki özelliği
desteklediğinden öntanımlı MPM'niz hemen hemen daima
<code class="module"><a href="./mod/event.html">event</a></code> modülü olacaktır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="static" id="static">Bir MPM'i bir duruk modül olarak derlemek</a></h2>
<p>MPM'ler tüm platformlarda duruk (static) modüller olarak derlenebilir.
Derleme sırasında tek bir modül seçilir ve sunucu ile ilintilenir. MPM
değiştirilmek istenirse sunucunun yeniden derlenmesi gerekir.</p>
<p>Öntanımlı MPM seçimin değiştirmek için <code class="program"><a href="./programs/configure.html">configure</a></code>
betiğinin <code>--with-mpm=<em>AD</em></code> seçeneği kullanılır.
Buradaki <em>AD</em> istenen MPM'in ismidir.</p>
<p>Sunucu bir kere derlendi mi, hangi MPM'in seçilmiş olduğunu
<code>./httpd -l</code> komutuyla öğrenebilirsiniz. Bu komut, içerilen
MPM dahil, sunucu içinde derlenmiş bütüm modülleri listeler.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="dynamic" id="dynamic">Bir MPM'i bir DSO modülü olarak derlemek</a></h2>
<p>Unix ve benzeri platformlarda, MPM'ler DSO modülleri olarak derlenebilir
ve diğer DSO modülleri gibi sunucuya devingen olarak yüklenebilir. DSO
modülü olarak derlenen MPM'ler, sunucunun yeniden derlenmesini
gerektirmeden <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> yönergesi
güncellenerek değiştirilebilir.</p>
<pre class="prettyprint lang-config">LoadModule mpm_prefork_module modules/mod_mpm_prefork.so</pre>
<p><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> yönergesini birden
fazla MPM için kullanmak sunucunun başlatılması sırasında aşağıdaki
hatanın oluşmasına sebep olur.</p>
<div class="example"><p><code>AH00534: httpd: Configuration error: More than one MPM
loaded.</code></p></div>
<p>Bu özellik <code class="program"><a href="./programs/configure.html">configure</a></code> betiğinin
<code>--enable-mpms-shared</code> seçeneği ile etkinleştirilebilir.
<code><em>all</em></code> değeri belirtilerek platform için
kullanılabilen tüm modüller kurulur. İstenirse, değer olarak bir MPM
listesi de belirtilebilir.</p>
<p>Özdevinimli olarak seçilerek veya <code class="program"><a href="./programs/configure.html">configure</a></code> betiğine
<code>--with-mpm</code> seçeneğiyle belirtilerek seçilen öntanımlı MPM
üretilen sunucu yapılandırma dosyasıyla yüklenir. Farklı bir MPM seçmek
için MPM'i <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> yönergesinde
belirtin.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mpm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/index.html.ja.utf8 0000664 0001751 0001751 00000023070 14743132254 020311 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP サーバ バージョン 2.4
ドキュメント - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="index-page">
<div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></div>
<div class="up"><a href="http://httpd.apache.org/docs-project/"><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></div>
<div id="page-content"><h1>Apache HTTP サーバ バージョン 2.4
ドキュメント</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<form method="get" action="https://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Google 検索" type="submit" /><input value="10" name="num" type="hidden" /><input value="ja" name="hl" type="hidden" /><input value="UTF-8" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="バージョン 2.4" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value=""List-Post"" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form>
<table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">リリースノート</a></h2>
<ul><li><a href="new_features_2_4.html">Apache 2.3/2.4 の新機能</a></li>
<li><a href="new_features_2_2.html">Apache 2.1/2.2 の新機能</a></li>
<li><a href="new_features_2_0.html">Apache 2.0 の新機能</a></li>
<li><a href="upgrading.html">2.2 から 2.4 へのアップグレード</a></li>
<li><a href="license.html">Apache ライセンス</a></li>
</ul>
</div><div class="category"><h2><a name="manual" id="manual">リファレンスマニュアル</a></h2>
<ul><li><a href="install.html">コンパイルとインストール</a></li>
<li><a href="invoking.html">起動</a></li>
<li><a href="stopping.html">終了と再起動</a></li>
<li><a href="mod/quickreference.html">実行の設定用ディレクティブ</a></li>
<li><a href="mod/">モジュール</a></li>
<li><a href="mpm.html">マルチプロセッシングモジュール (MPM)</a></li>
<li><a href="filter.html">フィルタ</a></li>
<li><a href="handler.html">ハンドラ</a></li>
<li><a href="expr.html">Expression parser</a></li>
<li><a href="programs/">サーバとサポートプログラム</a></li>
<li><a href="glossary.html">用語集</a></li>
</ul>
</div></td><td><div class="category"><h2><a name="usersguide" id="usersguide">ユーザの手引</a></h2>
<ul><li><a href="getting-started.html">Getting Started</a></li>
<li><a href="bind.html">アドレスとポートのバインド</a></li>
<li><a href="configuring.html">設定ファイル</a></li>
<li><a href="sections.html">セクションの設定</a></li>
<li><a href="caching.html">キャッシュ機能</a></li>
<li><a href="content-negotiation.html">コンテントネゴシエーション</a></li>
<li><a href="dso.html">動的共有オブジェクト (DSO)</a></li>
<li><a href="env.html">環境変数</a></li>
<li><a href="logs.html">ログファイル</a></li>
<li><a href="urlmapping.html">URL をファイルシステムにマップする</a></li>
<li><a href="misc/perf-tuning.html">性能に関する調整</a></li>
<li><a href="misc/security_tips.html">セキュリティ情報</a></li>
<li><a href="server-wide.html">サーバ全体の設定</a></li>
<li><a href="ssl/">SSL/TLS による暗号化</a></li>
<li><a href="suexec.html">CGI の Suexec 実行</a></li>
<li><a href="rewrite/">mod_rewriteによる URL Rewriting</a></li>
<li><a href="vhosts/">バーチャルホスト</a></li>
</ul>
</div></td><td class="col3"><div class="category"><h2><a name="howto" id="howto">How-To / チュートリアル</a></h2>
<ul><li><a href="howto/auth.html">認証、承認、アクセス制御
</a></li>
<li><a href="howto/cgi.html">CGI: 動的コンテンツ</a></li>
<li><a href="howto/htaccess.html">.htaccess ファイル</a></li>
<li><a href="howto/ssi.html">Server Side Includes (SSI)</a></li>
<li><a href="howto/public_html.html">ユーザ専用ディレクトリ
(public_html)</a></li>
</ul>
</div><div class="category"><h2><a name="platform" id="platform">プラットフォーム固有の情報</a></h2>
<ul><li><a href="platform/windows.html">Microsoft Windows</a></li>
<li><a href="platform/rpm.html">RPMベースのシステム (Redhat / CentOS / Fedora)</a></li>
<li><a href="platform/netware.html">Novell NetWare</a></li>
<li><a href="platform/ebcdic.html">EBCDIC 版</a></li>
</ul>
</div><div class="category"><h2><a name="other" id="other">その他</a></h2>
<ul><li><a href="http://wiki.apache.org/httpd/FAQ">よくある質問 (FAQ)</a></li>
<li><a href="sitemap.html">サイトマップ</a></li>
<li><a href="developer/">開発者のためのドキュメント</a></li>
<li><a href="http://httpd.apache.org/docs-project/">ドキュメンテーションプロジェクトへの協力</a></li>
<li><a href="misc/">その他</a></li>
<li><a href="http://wiki.apache.org/httpd/">ウィキ</a></li>
</ul>
</div></td></tr></table></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/index.html.pt-br 0000664 0001751 0001751 00000022406 14743132254 020060 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="pt-br" xml:lang="pt-br"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Documentação do Servidor HTTP Apache Versão
2.4 - Servidor HTTP Apache Versão 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="index-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Diretrizes</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossário</a> | <a href="./sitemap.html">Mapa do site</a></p>
<p class="apache">Servidor HTTP Apache Versão 2.4</p>
<img alt="" src="./images/feather.png" /></div>
<div class="up"><a href="http://httpd.apache.org/docs-project/"><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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentação</a></div>
<div id="page-content"><h1>Documentação do Servidor HTTP Apache Versão
2.4</h1>
<div class="toplang">
<p><span>Línguas Disponíveis: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">Esta tradução pode estar desatualizada.
Confira a versão em Inglês para mudanças recentes.</div>
<form method="get" action="https://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Busca Google" type="submit" /><input value="10" name="num" type="hidden" /><input value="pt-br" name="hl" type="hidden" /><input value="ISO-8859-1" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="Versão 2.4" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value=""List-Post"" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form>
<table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">Notas da Versão</a></h2>
<ul><li><a href="new_features_2_4.html">Novas funcionalidades no Apache 2.3/2.4</a></li>
<li><a href="new_features_2_2.html">Novas funcionalidades no Apache 2.1/2.2</a></li>
<li><a href="new_features_2_0.html">Novas funcionalidades no Apache 2.0</a></li>
<li><a href="upgrading.html">Atualizando da versão 2.2 para 2.4</a></li>
<li><a href="license.html">Licença Apache</a></li>
</ul>
</div><div class="category"><h2><a name="manual" id="manual">Manual de Referência</a></h2>
<ul><li><a href="install.html">Compilando e Instalando</a></li>
<li><a href="invoking.html">Iniciando</a></li>
<li><a href="stopping.html">Parando ou Reiniciando</a></li>
<li><a href="mod/directives.html">Diretrizes de Configuração para execução</a></li>
<li><a href="mod/quickreference.html">Referência Rápida de Diretrizes</a></li>
<li><a href="mod/">Módulos</a></li>
<li><a href="mpm.html">Módulos Multi-Processos (MPMs)</a></li>
<li><a href="filter.html">Filtros</a></li>
<li><a href="handler.html">Handlers</a></li>
<li><a href="programs/">Servidor e Programas Suportados</a></li>
<li><a href="glossary.html">Glossário</a></li>
</ul>
</div></td><td><div class="category"><h2><a name="usersguide" id="usersguide">Guia do Usuário</a></h2>
<ul><li><a href="bind.html">Portas de escuta</a></li>
<li><a href="configuring.html">Arquivos de Configuração</a></li>
<li><a href="sections.html">Seções de Configuração</a></li>
<li><a href="caching.html">Cachê de Conteúdo</a></li>
<li><a href="content-negotiation.html">Negociação de Conteúdo</a></li>
<li><a href="dso.html">Objetos Dinâmicos Compartilhados (DSO)</a></li>
<li><a href="env.html">Variáveis de Ambiente</a></li>
<li><a href="logs.html">Arquivos de Registro</a></li>
<li><a href="urlmapping.html">Mapeando URLs para o Sistema de Arquivos</a></li>
<li><a href="misc/perf-tuning.html">Ajustes de Performance</a></li>
<li><a href="misc/security_tips.html">Dicas de Segurança</a></li>
<li><a href="server-wide.html">Configurações Globais do Servidor</a></li>
<li><a href="ssl/">Encriptamento SSL/TLS</a></li>
<li><a href="suexec.html">Execução Suexec para CGI</a></li>
<li><a href="rewrite/">Guia para Reescrever URL</a></li>
<li><a href="vhosts/">Hosting Virtuais</a></li>
</ul>
</div></td><td class="col3"><div class="category"><h2><a name="howto" id="howto">How-To / Tutoriais</a></h2>
<ul><li><a href="howto/auth.html">Autenticação, Autorização, e
Controle de Acesso</a></li>
<li><a href="howto/cgi.html">CGI: Conteúdo Dinâmico</a></li>
<li><a href="howto/htaccess.html">Arquivos .htaccess</a></li>
<li><a href="howto/ssi.html">Server Side Includes (SSI)</a></li>
<li><a href="howto/public_html.html">Diretórios Web para usuários individuais
(public_html)</a></li>
</ul>
</div><div class="category"><h2><a name="platform" id="platform">Notas Específicas para diferentes Platformas</a></h2>
<ul><li><a href="platform/windows.html">Microsoft Windows</a></li>
<li><a href="platform/netware.html">Novell NetWare</a></li>
<li><a href="platform/ebcdic.html">EBCDIC Port</a></li>
</ul>
</div><div class="category"><h2><a name="other" id="other">Outros Tópicos</a></h2>
<ul><li><a href="faq/">Perguntas Mais Frequentes</a></li>
<li><a href="sitemap.html">Mapa do Site</a></li>
<li><a href="developer/">Documentação para Desenvolvedores</a></li>
<li><a href="misc/">Outras Notas</a></li>
</ul>
</div></td></tr></table></div>
<div class="bottomlang">
<p><span>Línguas Disponíveis: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licenciado sob a <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Diretrizes</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossário</a> | <a href="./sitemap.html">Mapa do site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/ 0000775 0001751 0001751 00000000000 15032766627 016205 5 ustar covener covener httpd-2.4.64/docs/manual/howto/ssi.html.fr.utf8 0000664 0001751 0001751 00000067264 14740503670 021173 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Tutoriel Apache httpd : Introduction aux "Inclusions Côté Serveur"
(Server Side Includes - SSI) - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Recettes et tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Tutoriel Apache httpd : Introduction aux "Inclusions Côté Serveur"
(Server Side Includes - SSI)</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/ssi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/ssi.html" title="Français"> fr </a> |
<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div>
<p>Les SSI permettent d'ajouter du contenu dynamique à des documents
HTML préexistants.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what">Qu'est-ce que SSI ?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuring">Configurer votre serveur pour permettre les SSI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#basic">Directives SSI de base</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#additionalexamples">Exemples additionnels</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#config">Que puis-je configurer d'autre ?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exec">Exécution de commandes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#advanced">Techniques SSI avancées</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#conclusion">Conclusion</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="related" id="related">Introduction</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_include.html">mod_include</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_expires.html">mod_expires</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code></li><li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li><li><code class="directive"><a href="../mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li></ul></td></tr></table>
<p>Cet article traite des Inclusions Côté Serveur (Server Side
Includes), plus communément appelés SSI. Vous trouverez ici la
manière de configurer votre serveur pour permettre les SSI, ainsi
qu'une introduction à quelques techniques SSI de base permettant
d'ajouter du contenu dynamique à vos pages HTML préexistantes.</p>
<p>La dernière partie de cet article sera consacrée aux
configurations SSI plus avancées, telles que les expressions
conditionnelles dans les directives SSI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">Qu'est-ce que SSI ?</a></h2>
<p>SSI (Server Side Includes) est constitué de directives placées dans
des pages HTML, et évaluées par le serveur au moment où les pages
sont servies. Elles vous permettent d'ajouter du contenu généré
dynamiquement à une page HTML préexistante, sans avoir à servir la
page entière via un programme CGI, ou toute autre technologie de
contenu dynamique.</p>
<p>Par exemple, vous pouvez insérer la directive suivante dans une
page HTML existante :</p>
<div class="example"><p><code>
<!--#echo var="DATE_LOCAL" -->
</code></p></div>
<p>Ainsi, lorsque la page sera servie, la directive sera évaluée et
remplacée par sa valeur :</p>
<div class="example"><p><code>
Tuesday, 15-Jan-2013 19:28:54 EST
</code></p></div>
<p>Le choix entre l'utilisation des SSI et la génération entière de
la page par un programme quelconque, est en général dicté par la
proportion de contenu statique et de contenu devant être généré
chaque fois que la page est servie. SSI est idéal pour ajouter de
petites quantités d'information, comme l'heure courante dans
l'exemple précédent. Mais si la
plus grande partie de votre page est générée au moment où elle est
servie, vous devez vous tourner vers une autre solution.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuring" id="configuring">Configurer votre serveur pour permettre les SSI</a></h2>
<p>Pour permettre l'utilisation des SSI sur votre serveur, vous
devez ajouter la directive suivante dans votre fichier
<code>httpd.conf</code>, ou dans un fichier <code>.htaccess</code>
:</p>
<pre class="prettyprint lang-config">Options +Includes</pre>
<p>Cette directive indique à Apache que vous désirez permettre la
recherche de directives SSI lors de l'interprétation des fichiers.
Notez cependant que la plupart des configurations contiennent de
nombreuses directives <code class="directive"><a href="../mod/core.html#options">Options</a></code>
qui peuvent s'écraser les unes les autres. Vous devrez probablement
appliquer ces directives <code>Options</code> au répertoire
spécifique pour lequel vous voulez activer les SSI, afin d'être sûr
qu'elles y seront bien activées.</p>
<p>Tout fichier ne fera cependant pas l'objet de recherche de
directives SSI. Vous devez indiquer à Apache quels fichiers seront
concernés. Vous pouvez y parvenir en indiquant une extension, comme
<code>.shtml</code>, à l'aide des directives suivantes :</p>
<pre class="prettyprint lang-config">AddType text/html .shtml
AddOutputFilter INCLUDES .shtml</pre>
<p>Un des désavantages de cette approche réside dans le fait que si
vous voulez ajouter des directives SSI à une page préexistante, vous
devrez changer le nom de cette page, et donc tout lien qui la
contient, de façon à ce qu'elle possède l'extension
<code>.shtml</code>, condition nécessaire pour que les directives
SSI qu'elle contient soient traitées.</p>
<p>Une autre méthode consiste à utiliser la directive <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code> :</p>
<pre class="prettyprint lang-config">XBitHack on</pre>
<p>La directive <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>
indique à Apache qu'il doit rechercher des directivves SSI dans les
fichiers si leur bit d'exécution est positionné. Il n'est ainsi plus
nécessaire de changer le nom du fichier pour ajouter des directives
SSI à une page préexistante ; vous devez simplement attribuer les
droits d'exécution au fichier à l'aide de <code>chmod</code>.</p>
<div class="example"><p><code>
chmod +x pagename.html
</code></p></div>
<p>Un bref commentaire sur ce qu'il ne faut pas faire. Certaines
personnes peuvent vous conseiller de tout simplement indiquer à
Apache de rechercher des directives SSI dans tous les fichiers
<code>.html</code>, ce qui vous évite d'avoir à gérer les noms de
fichiers avec extension <code>.shtml</code>. Ils n'ont probablement
pas entendu parler de la directive <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>. En effet, vous devez
garder à l'esprit qu'en faisant ceci, Apache va devoir rechercher
des directives SSI dans chaque fichier qu'il sert, même s'il n'en
contient aucune. Ce n'est donc pas une bonne idée car les
performances peuvent en être sensiblement affectées.</p>
<p>Bien entendu, sous Windows, il n'y a pas de bit d'exécution à
positionner, ce qui limite un peu vos choix.</p>
<p>Dans sa configuration par défaut, Apache n'envoie pas la date de
dernière modification ou les en-têtes HTTP relatifs à la taille des
contenus dans les pages SSI, car ses valeurs sont difficiles à
calculer pour les contenus dynamiques. Ceci peut induire une
impression de diminution des performances côté client, en empêchant
la mise en cache de votre document. Il existe deux méthodes pour
résoudre ce problème :</p>
<ol>
<li>Utilisez la configuration <code>XBitHack Full</code>. Elle
indique à Apache de déterminer la date de dernière modification en
ne regardant que la date du fichier à l'origine de la requête,
tout en ignorant la date de modification de tout fichier inclus.</li>
<li>Utilisez les directives fournies par le module
<code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code> pour définir de manière explicite la
date d'expiration de vos fichiers, laissant par la-même
aux navigateurs et aux mandataires le soin de déterminer s'il est
opportun ou non de les mettre en cache.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="basic" id="basic">Directives SSI de base</a></h2>
<p>Les directives SSI adoptent la syntaxe suivante :</p>
<div class="example"><p><code>
<!--#fonction attribut=valeur attribut=valeur ... -->
</code></p></div>
<p>Le format d'une directive SSI étant similaire à celui d'un
commentaire HTML, si vous n'avez pas activé correctement SSI, le
navigateur l'ignorera, mais elle sera encore visible dans le source
HTML. Si SSI est correctement configuré, la directive sera remplacée
par ses résultats.</p>
<p>"fonction" peut prendre de nombreuses formes, et nous décrirons
plus précisément la plupart d'entre eux dans la prochaine version de
ce document. Pour le moment, voici quelques exemples de ce que vous
pouvez faire avec SSI.</p>
<h3><a name="todaysdate" id="todaysdate">La date courante</a></h3>
<div class="example"><p><code>
<!--#echo var="DATE_LOCAL" -->
</code></p></div>
<p>La fonction <code>echo</code> permet d'afficher la valeur d'une
variable. Il existe un grand nombre de variables standards, y
compris l'ensemble des variables d'environnement disponibles pour
les programmes CGI. De plus, vous pouvez définir vos propres
variables à l'aide de la fonction <code>set</code>.</p>
<p>Si vous n'aimez pas le format sous lequel la date s'affiche, vous
pouvez utiliser la fonction <code>config</code> avec un attribut
<code>timefmt</code>, pour le modifier.</p>
<div class="example"><p><code>
<!--#config timefmt="%A %B %d, %Y" --><br />
Today is <!--#echo var="DATE_LOCAL" -->
</code></p></div>
<h3><a name="lastmodified" id="lastmodified">Date de modification du fichier</a></h3>
<div class="example"><p><code>
Dernière modification du document <!--#flastmod file="index.html" -->
</code></p></div>
<p>Le format peut là aussi être modifié à l'aide de l'attribut
<code>timefmt</code>.</p>
<h3><a name="cgi" id="cgi">Inclusion des résultats d'un programme CGI</a></h3>
<p>C'est le cas le plus courant d'utilisation des SSI - afficher les
résultats d'un programme CGI, comme l'universellement adoré
"compteur d'accès".</p>
<div class="example"><p><code>
<!--#include virtual="/cgi-bin/counter.pl" -->
</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="additionalexamples" id="additionalexamples">Exemples additionnels</a></h2>
<p>Vous trouverez dans ce qui suit quelques exemples spécifiques de
ce que vous pouvez faire de vos documents HTML avec SSI.</p>
<h3><a name="docmodified" id="docmodified">Quand ce document a-t-il été modifié ?</a></h3>
<p>Nous avons mentionné plus haut que vous pouviez utiliser SSI pour
informer l'utilisateur de la date de dernière modification du
document. Cependant, la méthode pour y parvenir n'a pas été vraiment
abordée. Placé dans votre document HTML, le code suivant va insérer
un repère de temps dans votre page. Bien entendu, SSI devra avoir
été correctement activé, comme décrit plus haut.</p>
<div class="example"><p><code>
<!--#config timefmt="%A %B %d, %Y" --><br />
Dernière modification du fichier <!--#flastmod file="ssi.shtml" -->
</code></p></div>
<p>Bien entendu, vous devez remplacer <code>ssi.shtml</code> par le
nom du fichier auquel vous faites référence. Ceci ne conviendra pas
si vous recherchez un morceau de code générique que vous pourrez
insérer dans tout fichier ; dans ce cas, il est préférable
d'utiliser la variable <code>LAST_MODIFIED</code> :</p>
<div class="example"><p><code>
<!--#config timefmt="%D" --><br />
This file last modified <!--#echo var="LAST_MODIFIED" -->
</code></p></div>
<p>Pour plus de détails sur le format <code>timefmt</code>, tapez
<code>strftime</code> dans votre moteur de recherche préferé. La
syntaxe est identique.</p>
<h3><a name="standard-footer" id="standard-footer">Inclusion d'un pied de page standard</a></h3>
<p>Si le site que vous gérez comporte plus que quelques pages, vous
allez vite vous apercevoir qu'effectuer des modifications sur toutes
ces pages peut devenir très contraignant, en particulier si vous
voulez qu'elles conservent un aspect homogène.</p>
<p>Inclure un fichier pour un en-tête et/ou un pied de page peut
simplifier cette corvée de mises à jour. Il vous suffit de
confectionner un fichier de pied de page, et de l'inclure dans
chaque page à l'aide de l'élément SSI <code>include</code>. Pour
définir le fichier à inclure, la fonction <code>include</code> peut
utiliser soit l'attribut <code>file</code>, soit l'attribut
<code>virtual</code>. L'attribut <code>file</code> est un chemin de
fichier <em>relatif au répertoire courant</em>. C'est à dire qu'il
ne peut ni avoir pour valeur un chemin absolu (commençant par /), ni
comporter "../" dans son chemin. L'attribut <code>virtual</code> est
probablement plus commode, et peut spécifier une URL relative au
document servi. Elle peut commencer par un /, mais le fichier inclus
et le fichier servi doivent résider sur le même serveur.</p>
<div class="example"><p><code>
<!--#include virtual="/footer.html" -->
</code></p></div>
<p>Je combinerai souvent ces deux derniers points, en ajoutant une
directive <code>LAST_MODIFIED</code> dans un fichier de pied de page
destiné à être inclus. Le fichier inclus peut contenir des
directives SSI, et les inclusions peuvent être imbriquées - à
savoir, le fichier inclus peut inclure un autre fichier, etc...</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="config" id="config">Que puis-je configurer d'autre ?</a></h2>
<p>En plus du format de date, vous pouvez utiliser l'élément
<code>config</code> pour configurer deux autres choses.</p>
<p>En général, lorsque quelque chose se passe mal avec votre
directive SSI, vous recevez le message :</p>
<div class="example"><p><code>
[an error occurred while processing this directive]
</code></p></div>
<p>Pour modifier ce message, vous pouvez utiliser l'attribut
<code>errmsg</code> avec la fonction <code>config</code> :</p>
<div class="example"><p><code>
<!--#config errmsg="[Il semblerait que vous ne sachiez pas
utiliser les SSI]" -->
</code></p></div>
<p>Il est cependant probable que les utilisateurs finaux ne voient
jamais ce message, car vous aurez résolu tous les problèmes issus de
vos directives SSI avant que votre site ne soit mis en production.
(N'est-ce pas ?)</p>
<p>Vous pouvez aussi modifier le format sous lequel les tailles de
fichiers sont affichées à l'aide de l'attribut <code>sizefmt</code>.
Vous pouvez spécifier <code>bytes</code> pour un affichage en
octets, ou <code>abbrev</code> pour un affichage plus concis en Ko
ou Mo, selon le cas.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exec" id="exec">Exécution de commandes</a></h2>
<p>Voici autre chose que vous pouvez faire avec la fonction
<code>exec</code>. Vous pouvez vraiment faire exécuter une commande
par SSI en utilisant le shell (<code>/bin/sh</code>, pour être plus
précis - ou le shell DOS, si vous êtes sous Win32). Par exemple, ce
qui suit vous permet d'afficher le contenu d'un répertoire.</p>
<div class="example"><p><code>
<pre><br />
<!--#exec cmd="ls" --><br />
</pre>
</code></p></div>
<p>ou, sous Windows</p>
<div class="example"><p><code>
<pre><br />
<!--#exec cmd="dir" --><br />
</pre>
</code></p></div>
<p>Vous noterez probablement l'étrange formatage provoqué par cette
directive sous Windows, car la sortie de <code>dir</code> contient
la chaîne de caractères "<<code>dir</code>>", ce qui trompe le
navigateur.</p>
<p>Notez que cette fonctionnalité est très dangereuse, car elle va
permettre d'exécuter tout code associé à l'élément
<code>exec</code>. Si vous êtes dans la situation où les
utilisateurs peuvent éditer le contenu de vos pages web, dans le cas
d'un "livre d'or" par exemple, assurez-vous de désactiver cette
fonctionnalité. Vous pouvez, tout en permettant les SSI, désactiver
la fonctionnalité <code>exec</code> à l'aide de l'argument
<code>IncludesNOEXEC</code> de la directive
<code>Options</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="advanced" id="advanced">Techniques SSI avancées</a></h2>
<p>Outre l'affichage de contenu, les SSI d'Apache vous permettent de
définir des variables, et de les utiliser dans des comparaisons et
des conditions.</p>
<h3><a name="variables" id="variables">Définition de variables</a></h3>
<p>Avec l'élément <code>set</code>, vous pouvez définir des
variables pour un usage ultérieur. Comme nous en aurons besoin plus
loin, nous allons en parler tout de suite. La syntaxe se présente
comme suit :</p>
<div class="example"><p><code>
<!--#set var="name" value="Rich" -->
</code></p></div>
<p>Pour affecter une valeur à vos variables, en plus de la
définition littérale de l'exemple ci-dessus, vous pouvez utiliser
une autre variable, y compris les <a href="../env.html">variables d'environnement</a>, ou les variables
décrites plus haut (comme <code>LAST_MODIFIED</code> par exemple).
Pour indiquer qu'il s'agit d'une variable et non d'une chaîne, vous
devez utiliser le symbole dollar ($) devant le nom de la
variable.</p>
<div class="example"><p><code> <!--#set var="modified" value="$LAST_MODIFIED" -->
</code></p></div>
<p>Pour insérer un caractère $ dans la valeur de votre variable,
vous devez l'échapper à l'aide d'un backslash.</p>
<div class="example"><p><code>
<!--#set var="cost" value="\$100" -->
</code></p></div>
<p>Enfin, si vous voulez insérer une variable dans une chaîne, et
s'il y a une chance pour que le nom de la variable se confonde avec
le reste de la chaîne, vous pouvez l'entourer d'accolades pour
eviter toute confusion (Il est difficile de trouver un bon exemple
pour illustrer ceci, mais j'espère que vous comprendrez).</p>
<div class="example"><p><code>
<!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" -->
</code></p></div>
<h3><a name="conditional" id="conditional">Expressions conditionnelles</a></h3>
<p>Maintenent que nous avons des variables, et que nous pouvons
définir et comparer leurs valeurs, nous sommes à même de les
utiliser dans des expressions conditionnelles. Ceci confère à SSI le
statut de petit langage de programmation.
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> fournit une structure <code>if</code>,
<code>elif</code>, <code>else</code>, <code>endif</code> pour la
construction d'expressions conditionnelles, ce qui vous permet de
générer plusieurs pages logiques à partir d'une seule vraie
page.</p>
<p>La structure de l'expression conditionnelle est :</p>
<div class="example"><p><code>
<!--#if expr="condition" --><br />
<!--#elif expr="condition" --><br />
<!--#else --><br />
<!--#endif -->
</code></p></div>
<p>Une <em>condition</em> peut revêtir la forme de toute comparaison
logique - soit une comparaison de valeurs avec une autre, soit une
vérification de la "vérité" d'une valeur particulière (Une chaîne
donnée est vraie si elle n'est pas vide). Pour une liste exhaustive
des opérateurs de comparaison disponibles, voir la documentation du
module <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>.</p>
<p>Par exemple, spour insérer l'heure du jour dans votre page web,
vous pouvez ajouter ces lignes dans la page HTML :</p>
<div class="example"><p><code>
Good
<!--#if expr="%{TIME_HOUR} <12" --><br />
morning!<br />
<!--#else --><br />
afternoon!<br />
<!--#endif --><br />
</code></p></div>
<p>Toute autre variable (que vous avez définie, ou une variable
d'environnement normale) peut être utilisée dans les expressions
conditionnelles. Voir le document <a href="../expr.html">Expressions
rationnelles dans le serveur HTTP Apache</a> pour plus de détails à
propos du fonctionnement du moteur d'évaluation des expressions
rationnelles.</p>
<p>Associée à la possibilité avec Apache de définir
des variables d'environnement à l'aide de directives
<code>SetEnvIf</code>, ainsi que d'autres directives en rapport,
cette fonctionnalité vous permet d'ajouter une grande variété
de contenus dynamiques côté serveur sans avoir à concevoir une
application web de A à Z.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="conclusion" id="conclusion">Conclusion</a></h2>
<p>SSI ne remplace certainement pas CGI, ou d'autres technologies
utilisées pour la génération de pages web dynamiques. Mais c'est une
bonne méthode pour ajouter des petits contenus dynamiques à vos
pages, sans devoir fournir un gros effort supplémentaire.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/ssi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/ssi.html" title="Français"> fr </a> |
<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/ssi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/ssi.html.es 0000664 0001751 0001751 00000067022 14743132254 020275 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Tutorial de Apache httpd: Introducción a los Server Side Includes
- Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="../images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a> > <a href="./">How-To / Tutoriales</a></div><div id="page-content"><div id="preamble"><h1>Tutorial de Apache httpd: Introducción a los Server Side Includes
</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/ssi.html" title="Español"> es </a> |
<a href="../fr/howto/ssi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div>
<p>Los Server Side Includes (Inclusiones en la parte Servidor) facilitan un método para añadir contenido dinámico a documentos HTML existentes.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Introducción</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what">¿Qué son los SSI?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuring">Configurar su servidor para permitir SSI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#basic">Directivas SSI básicas</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#additionalexamples">Más ejemplos</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#config">¿Qué más puedo configurar?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exec">Ejecutando comandos</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#advanced">Técnicas avanzadas de SSI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#conclusion">Conclusión</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</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="related" id="related">Introducción</a></h2>
<table class="related"><tr><th>Módulos Relacionados</th><th>Directivas Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_include.html">mod_include</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_expires.html">mod_expires</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code></li><li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li><li><code class="directive"><a href="../mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li></ul></td></tr></table>
<p>Este artículo trata sobre los Server Side Includes, generalmente llamados SSI.
En este artículo, hablaremos sobre cómo configurar su servidor para permitir SSI,
y de técnicas básicas de SSI para añadir contenido dinámico a sus páginas
HTML existentes.</p>
<p>Más adelante también hablaremos de algunas técnicas más avanzadas que
pueden usarse con SSI, tales como declaraciones condicionales en sus directivas SSI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">¿Qué son los SSI?</a></h2>
<p>SSI (Server Side Includes) son directivas que se introducen en páginas HTML y son
evaluadas por el servidor mientras éste las sirve. Le permiten añadir
contenido generado de manera dinámica a sus páginas HTML existentes sin tener
que servir una página entera a través de un programa CGI, u otra tecnología
para generar contenido dinámico.</p>
<p>Por ejemplo, podría colocar una directiva en una página existente de HTML
de esta manera:</p>
<div class="example"><p><code>
<!--#echo var="DATE_LOCAL" -->
</code></p></div>
<p>Y, cuando se sirve la página, este fragmento será evaluado y sustituido con su resultado:</p>
<div class="example"><p><code>
Tuesday, 15-Jan-2013 19:28:54 EST
</code></p></div>
<p>La decisión sobre cuándo usar SSI, o de cuándo generar una página al completo con algún programa, suele depender generalmente de la cantidad de contenido estático que contiene, y cuánto de esa página tiene que ser recalculado cada vez que ésta se sirve. SSI es un buen método para añadir pequeñas partes de información, tales como la hora actual - como se ha mostrado más arriba. Pero si la mayoría de su página se tiene que generar en el momento en el que se está sirviendo, necesita buscar otra opción más adecuada que no sea SSI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuring" id="configuring">Configurar su servidor para permitir SSI</a></h2>
<p>Para permitir SSI en su servidor, debe tener la siguiente directiva en su fichero <code>httpd.conf</code> , o en un fichero
<code>.htaccess</code>:</p>
<pre class="prettyprint lang-config">Options +Includes</pre>
<p>Esto le dice a Apache que quiere permitir que se examinen los ficheros buscando directivas SSI. Tenga en cuenta que la mayoría de las configuraciones contienen múltiples directivas <code class="directive"><a href="../mod/core.html#options">Options</a></code> que pueden sobreescribirse las unas a las otras. Probablemente necesitará aplicar <code>Options</code> al directorio específico donde quiere SSI activado para asegurarse de que se evalúa en último lugar y por tanto se acabará aplicando.</p>
<p>No todos los ficheros se examinan buscando directivas SSI. Usted Le tiene que indicar a Apache qué ficheros se tienen que examinar. Hay dos formas de hacer esto. Puede decirle a Apache que examine cualquier fichero con una extensión determinada, como por ejemplo <code>.shtml</code>, con las siguientes directivas:</p>
<pre class="prettyprint lang-config">AddType text/html .shtml
AddOutputFilter INCLUDES .shtml</pre>
<p>Una desventaja de este método es que si quisiera añadir directivas SSI a una página ya existente, tendría que cambiar el nombre de la página, y todos los enlaces que apuntasen a esa página, todo para poder darle la extensión <code>.shtml</code> y que esas directivas sean interpretadas.</p>
<p>El otro método es usar la directiva <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code> :</p>
<pre class="prettyprint lang-config">XBitHack on</pre>
<p><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code> le dice a Apache que examine ficheros buscando directivas SSI si los ficheros tienen el bit de ejecución configurado. Asi que para añadir directivas SSI a una página existente, en lugar de tener que cambiarle el nombre, solo tendría que convertirla en ejecutable usando <code>chmod</code>.</p>
<div class="example"><p><code>
chmod +x pagename.html
</code></p></div>
<p>Una breve recomendación de qué no hay que hacer. Ocasionalmente vemos gente recomendar que le diga a Apache que examine todos los ficheros
<code>.html</code> para activar SSI, para no tener que lidiar renombrando los ficheros a <code>.shtml</code>. Quizás estas personas no hayan oido hablar de <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>. Lo que hay que tener en cuenta, es que haciendo eso, está pidiendo al Apache que lea cada uno de los ficheros que manda al cliente, incluso si no contenien directivas SSI. Esto puede ralentizar bastante el servidor, y no es una buena idea.</p>
<p>Por supuesto, en Windows, no hay tal cosa como la configuración del bit de ejecución, así que esto limita las opciones un poco.</p>
<p>En su configuración por defecto, Apache no envía la fecha de última modificación o la longitud de contenido de páginas SSI porque es dificil calcular estos valores para contenido dinámico. Esto puede impedir que se cachee un documento, y dar como resultado en apareciencia un rendimiento más lento del cliente. Hay dos maneras de solucionar esto:</p>
<ol>
<li>Usando la configuración <code>XBitHack Full</code>. Esto le indica a apache que determine la fecha de última modificación mirando sólo la fecha del fichero que se ha solicitado originalmente, obviando la modificación de cualquier otro fichero al que se hace referencia mediante SSI.</li>
<li>Use las directivas facilitadas por <code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code> para configurar una expiración específica de tiempo en sus ficheros, y así hacer saber a proxies o navegadores web que es aceptable cachearlos.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="basic" id="basic">Directivas SSI básicas</a></h2>
<p>Las directivas SSI tienen la sintaxis siguiente:</p>
<div class="example"><p><code>
<!--#function attribute=value attribute=value ... -->
</code></p></div>
<p>Se formatean como comentarios HTML, así si no tiene SSI habilitado correctamente, el navegador las obviará, pero todavía serán visibles en el fichero HTML. Si tiene SSI configurado correctamente, la directiva será reemplazada con su propio resultado.</p>
<p>Esta función es una de tantas, y hablaremos de algunas de ellas más adelante. Por ahora, aquí mostramos unos ejemplos de lo que puede hacer con SSI.</p>
<h3><a name="todaysdate" id="todaysdate">La fecha de hoy</a></h3>
<div class="example"><p><code>
<!--#echo var="DATE_LOCAL" -->
</code></p></div>
<p>La función <code>echo</code> sencillamente muestra el valor de una variable. Hay muchas variables estándar que incluyen un conjunto de variables de entorno disponibles para programas CGI. También puede definir sus propias variables con la función <code>set</code>.</p>
<p>Si no le gusta el formato en el que se imprime la fecha, puede usar la función <code>config</code>, con un atributo
<code>timefmt</code> para modificar ese formato.</p>
<div class="example"><p><code>
<!--#config timefmt="%A %B %d, %Y" --><br />
Today is <!--#echo var="DATE_LOCAL" -->
</code></p></div>
<h3><a name="lastmodified" id="lastmodified">Fecha de modificación del fichero</a></h3>
<div class="example"><p><code>
La última modificación de este documento <!--#flastmod file="index.html" -->
</code></p></div>
<p>Esta función también está sujeta a configuraciones de formato de
<code>timefmt</code>.</p>
<h3><a name="cgi" id="cgi">Incluyendo los resultados de un programa CGI</a></h3>
<p>Este es uno de los usos más comunes de SSI - para sacar el resultado de un programa CGI, tal y como ocurre con el que fuera el programa favorito de todos, un ``contador de visitas.''</p>
<div class="example"><p><code>
<!--#include virtual="/cgi-bin/counter.pl" -->
</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="additionalexamples" id="additionalexamples">Más ejemplos</a></h2>
<p>A continuación hay algunos ejemplos específicos de cosas que puede hacer con SSI en sus documentos HTML.</p>
<h3><a name="docmodified" id="docmodified">¿Cuándo fue modificado este documento?</a></h3>
<p>Antes mencionamos que puede usar SSI para informar al usuario cuando el documento ha sido modificado por última vez. Aun así, el método actual para hacerlo se dejó en cuestión. El código que se muestra a continuación, puesto en un documento HTML, pondrá ese sello de tiempo en su página. Por descontado, tendrá que tener SSI habilitado correctamente, como se indicó más arriba.</p>
<div class="example"><p><code>
<!--#config timefmt="%A %B %d, %Y" --><br />
Ultima modificación de este fichero <!--#flastmod file="ssi.shtml" -->
</code></p></div>
<p>Obviamente, necesitará sustituir el nombre de fichero
<code>ssi.shtml</code> con el nombre real del fichero al que usted hace referencia. Esto puede ser inconveniente si solo está buscando un trozo genérico de código que pueda copiar y pegar en cualquier fichero, asi que probablemente necesite usar la variable <code>LAST_MODIFIED</code> en su lugar:</p>
<div class="example"><p><code>
<!--#config timefmt="%D" --><br />
Última modificación de este fichero <!--#echo var="LAST_MODIFIED" -->
</code></p></div>
<p>Para más detalles sobre el formato <code>timefmt</code>, vaya a su buscador favorito y busque <code>strftime</code>. La sintaxis es la misma.</p>
<h3><a name="standard-footer" id="standard-footer">Incluyendo un pie de página estándar</a></h3>
<p>Si gestiona un sitio que tiene más de unas cuantas páginas, probablemente se de cuenta de que modificar todas esa páginas es un auténtico engorro, especialmente si trata de mantener una apareciencia homogénea en todas ellas.</p>
<p>Si usa un Include de fichero para la cabecera y/o pie de página puede reducir la carga de trabajo de estas actualizaciones. Solo tiene que hacer un sólo pie de página, y después incluirlo en cada página con el comando SSI <code>include</code>. La función <code>include</code>
puede determinar qué fichero incluir cuando usa el atributo
<code>file</code>, o el atributo <code>virtual</code>. El atributo <code>file</code> es una ruta de fichero, <em>relativa al directorio actual</em>. Eso significa que no puede ser una ruta de fichero absoluta (que comienza con /), ni tampoco puede contener ../ como parte de la ruta. El atributo <code>virtual</code> es probablemente más útil, y debería especificar una URL relativa al documento que se está sirviendo. Puede empezar con una /, pero debe estar en el mismo servidor que el fichero que se está sirviendo.</p>
<div class="example"><p><code>
<!--#include virtual="/footer.html" -->
</code></p></div>
<p>Frecuentemente combinaremos las dos últimas, poniendo una directiva
<code>LAST_MODIFIED</code> dentro de un fichero de pie de página que va a ser incluido. Se pueden encontrar directivas SSI en el fichero que se incluye, las inclusiones pueden anidarse - lo que quiere decir, que el fichero incluido puede incluir otro fichero, y así sucesivamente.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="config" id="config">¿Qué más puedo configurar?</a></h2>
<p>Además de poder configurar el formato de la hora, también puede configurar dos cosas más.</p>
<p>Generalmente, cuando algo sale mal con sus directivas SSI, obtiene el mensaje (ha ocurrido un error procesando esta directiva)</p>
<div class="example"><p><code>
[an error occurred while processing this directive]
</code></p></div>
<p>Si quiere cambiar ese mensaje por otra cosa, puede hacerlo con el atributo <code>errmsg</code> para la función
<code>config</code>:</p>
<div class="example"><p><code>
<!--#config errmsg="[Parece que no sabe cómo usar SSI]" -->
</code></p></div>
<p>Afortunadamente, los usuarios finales nunca verán este mensaje, porque habrá resuelto todos los problemas con sus directivas SSI antes de publicar su página web. (¿Verdad?)</p>
<p>Y puede configurar el formato en el que los tamaños de fichero se muestran con el formato <code>sizefmt</code>. Puede especificar
<code>bytes</code> para un recuento total en bytes, o
<code>abbrev</code> para un número abreviado en Kb o Mb, según sea necesario.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exec" id="exec">Ejecutando comandos</a></h2>
<p> Puede usar la función <code>exec</code> para ejecutar comandos. Y SSI puede ejecutar un comando usando la shell (<code>/bin/sh</code>, para ser más precisos - o la shell de DOS , si está en Win32). Lo siguiente, por ejemplo, le dará un listado de ficheros en un directorio.</p>
<div class="example"><p><code>
<pre><br />
<!--#exec cmd="ls" --><br />
</pre>
</code></p></div>
<p>o, en Windows</p>
<div class="example"><p><code>
<pre><br />
<!--#exec cmd="dir" --><br />
</pre>
</code></p></div>
<p>Notará un formato estraño con esta directiva en Windows, porque el resultado de <code>dir</code> contiene la cadena de caracterers ``<<code>dir</code>>'' ,que confunde a los navegadores.</p>
<p>Tenga en cuenta de que esta característica es muy peligrosa, puesto que ejecutará cualquier código que esté especificado con la etiqueta
<code>exec</code>. Si tiene una situación en la que los usuarios pueden editar contenido en sus páginas web, tales como por ejemplo un ``registro de visitas'', asegúrese de tener esta característica deshabilitada. Puede permitir SSI, pero no la característica <code>exec</code>, con el argumento <code>IncludesNOEXEC</code> en la directiva <code>Options</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="advanced" id="advanced">Técnicas avanzadas de SSI</a></h2>
<p>Además de mostrar contenido, SSI en Apache da la opción de configurar variables y usar esas variables en comparaciones y condicionales.</p>
<h3><a name="variables" id="variables">Configurando Variables</a></h3>
<p>Usando la directiva <code>set</code>, puede configurar variables para su uso posterior. La sintaxis es como sigue:</p>
<div class="example"><p><code>
<!--#set var="name" value="Rich" -->
</code></p></div>
<p>Además de configurar valores literales como esto, puede usar cualquier otra variable, incluyendo <a href="../env.html">variables de entorno</a> o las variables que se han mencionado antes (como por ejemplo <code>LAST_MODIFIED</code>) para dar valores a sus variables. Podrá especificar que algo es una vaiable, en lugar de una cadena de caracters literal, usando el símbolo del dolar ($) antes del nombre de la variable.</p>
<div class="example"><p><code> <!--#set var="modified" value="$LAST_MODIFIED" -->
</code></p></div>
<p>Para poner el símbolo del dolar de manera literal en un valor de su variable tendrá que escapar el símbolo del dolar con una barra "\".</p>
<div class="example"><p><code>
<!--#set var="cost" value="\$100" -->
</code></p></div>
<p>Por último, si quiere poner una variable entre medias de una cadena de caracteres más larga, y se da la coincidencia de que el nombre de la variable se encontrará con otros caracteres, y de esta manera se confundirá con otros caracteres, puedes poner el nombre de la variable entre llaves, y así eliminar la confusión. (Es dificil encontrar un buen ejemplo para esto, pero con éste a lo mejor entiende lo que tratamos de transmitir.)</p>
<div class="example"><p><code>
<!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" -->
</code></p></div>
<h3><a name="conditional" id="conditional">Expresiones condicionales</a></h3>
<p>Ahora que tenemos variables, y somos capaces de comparar sus valores, podemos usarlas para expresar condicionales. Esto permite a SSI ser un cierto tipo de lenguaje de programación diminuto.
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> provee una estrucura <code>if</code>,
<code>elif</code>, <code>else</code>, <code>endif</code>
para construir declaraciones condicionales. Esto le permite generar de manera efectiva multitud de páginas lógicas desde tan solo una página.</p>
<p>La estructura de este sistema condicional es:</p>
<div class="example"><p><code>
<!--#if expr="test_condition" --><br />
<!--#elif expr="test_condition" --><br />
<!--#else --><br />
<!--#endif -->
</code></p></div>
<p>Una <em>test_condition</em> puede ser cualquier tipo de comparación lógica - o bien comparando valores entre ellos, o probando la ``verdad'' (o falsedad) de un valor en particular. (Una cadena de caracteres cualquiera es verdadera si no está vacía.) Para una lista completa de operadores de comparación, vea la documentación de <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>.</p>
<p>Por ejemplo, si quiere personalizar el texto en su página web basado en la hora actual, puede usar la siguiente receta, colocada en su página HTML:</p>
<div class="example"><p><code>
Good
<!--#if expr="%{TIME_HOUR} <12" --><br />
morning!<br />
<!--#else --><br />
afternoon!<br />
<!--#endif --><br />
</code></p></div>
<p>Cualquier otra variable (o bien las que defina usted, o variables de entorno normales) puede usarse en declaraciones condicionales.
Vea <a href="../expr.html">Expresiones en el Servidor Apache HTTP</a> para más información sobre el motor de evaluación de expresiones.</p>
<p>Con la habilidad de Apache de configurar variables de entorno con directivas <code>SetEnvIf</code>, y otras directivas relacionadas,
esta funcionalidad puede llevarle a hacer una gran variedad de contenido dinámico en la parte de servidor sin tener que depender de una aplicación web al completo.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="conclusion" id="conclusion">Conclusión</a></h2>
<p>Desde luego SSI no es un reemplazo para CGI u otras tecnologías que se usen para generar páginas web dinámicas. Pero es un gran método para añadir pequeñas cantidaddes de contenido dinámico a páginas web, sin hacer mucho más trabajo extra.</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/ssi.html" title="Español"> es </a> |
<a href="../fr/howto/ssi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/ssi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/auth.html.fr.utf8 0000664 0001751 0001751 00000117470 14740503670 021331 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Authentification et autorisation - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Recettes / Tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Authentification et autorisation</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/auth.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/auth.html" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>L'authentification est un processus qui vous permet de vérifier
qu'une personne est bien celle qu'elle prétend être. L'autorisation
est un processus qui permet à une personne d'aller là où elle veut
aller, ou d'obtenir les informations qu'elle désire.</p>
<p>Pour le contrôle d'accès en général, voir le How-To <a href="access.html">Contrôle d'accès</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Modules et directives concernés</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#theprerequisites">Les prérequis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#gettingitworking">Mise en oeuvre</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#lettingmorethanonepersonin">Autorisation d'accès à
plusieurs personnes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#possibleproblems">Problèmes possibles</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#dbmdbd">Autre méthode de stockage des mots de
passe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multprovider">Utilisation de plusieurs fournisseurs
d'authentification</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#beyond">Pour aller plus loin qu'une simple
autorisation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#socache">Mise en cache de l'authentification</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinformation">Pour aller plus loin . . .</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="related" id="related">Modules et directives concernés</a></h2>
<p>Trois groupes de modules sont concernés par le processus
d'authentification et d'autorisation. Vous devrez utiliser au moins un
module de chaque groupe.</p>
<ul>
<li>Type d'authentification (voir la directive <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>)
<ul>
<li><code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code></li>
<li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li>
</ul>
</li>
<li>Fournisseur d'authentification (voir les directives <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> et <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code>)
<ul>
<li><code class="module"><a href="../mod/mod_authn_anon.html">mod_authn_anon</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li>
<li><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code></li>
</ul>
</li>
<li>Autorisation (voir la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>)
<ul>
<li><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_dbd.html">mod_authz_dbd</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code></li>
</ul>
</li>
</ul>
<p>On peut aussi ajouter <code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> et
<code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>. Ces modules implémentent des
directives générales qui opèrent au dessus de tous les modules
d'authentification.</p>
<p>Le module <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> est un fournisseur
d'authentification et d'autorisation. Le module
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> fournit une autorisation et un
contrôle d'accès basés sur le nom du serveur, l'adresse IP ou
certaines caractéristiques de la requête, mais ne fait pas partie du
système fournisseur d'authentification. Le module
<code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> a été créé à des fins de
compatibilité ascendante avec mod_access.</p>
<p>Vous devriez aussi jeter un coup d'oeil au manuel de recettes de <a href="access.html">Contrôle d'accès</a>, qui décrit les différentes
méthodes de contrôle d'accès à votre serveur.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="introduction" id="introduction">Introduction</a></h2>
<p>Si votre site web contient des informations sensibles ou
destinées seulement à un groupe de personnes restreint, les
techniques exposées dans cet article vont vous aider à vous assurer
que les personnes qui ont accès à ces pages sont bien celles
auxquelles vous avez donné l'autorisation d'accès.</p>
<p>Cet article décrit les méthodes "standards" de protection de
parties de votre site web que la plupart d'entre vous sont appelés à
utiliser.</p>
<div class="note"><h3>Note :</h3>
<p>Si vos données ont un réel besoin de sécurisation, prévoyez
l'utilisation de <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> en plus de toute méthode
d'authentification.</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="theprerequisites" id="theprerequisites">Les prérequis</a></h2>
<p>Les directives décrites dans cet article devront être insérées
soit au niveau de la configuration de votre serveur principal (en
général dans une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>), soit au niveau de la
configuration des répertoires (fichiers <code>.htaccess</code>)</p>
<p>Si vous envisagez l'utilisation de fichiers
<code>.htaccess</code>, la configuration de votre serveur devra
permettre l'ajout de directives d'authentification dans ces
fichiers. Pour ce faire, on utilise la directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>, qui spécifie quelles
directives pourront éventuellement contenir les fichiers de
configuration de niveau répertoire.</p>
<p>Comme il est ici question d'authentification, vous aurez besoin
d'une directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
du style :</p>
<pre class="prettyprint lang-config">AllowOverride AuthConfig</pre>
<p>Si vous avez l'intention d'ajouter les directives directement
dans le fichier de configuration principal, vous devrez bien entendu
posséder les droits en écriture sur ce fichier.</p>
<p>Vous devrez aussi connaître un tant soit peu la structure des
répertoires de votre serveur, ne serait-ce que pour savoir où se
trouvent certains fichiers. Cela ne devrait pas présenter de grandes
difficultés, et nous essaierons de clarifier tout ça lorsque le besoin
s'en fera sentir.</p>
<p>Enfin, vous devrez vous assurer que les modules
<code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> et <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>
ont été soit compilés avec le binaire httpd, soit chargés par le
fichier de configuration httpd.conf. Ces deux modules fournissent
des directives générales et des fonctionnalités qui sont critiques
quant à la configuration et l'utilisation de l'authentification et
de l'autorisation au sein du serveur web.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="gettingitworking" id="gettingitworking">Mise en oeuvre</a></h2>
<p>Nous décrivons ici les bases de la protection par mot de passe
d'un répertoire de votre serveur.</p>
<p>Vous devez en premier lieu créer un fichier de mots de passe. La
méthode exacte selon laquelle vous allez créer ce fichier va varier
en fonction du fournisseur d'authentification choisi. Mais nous
entrerons dans les détails plus loin, et pour le moment, nous nous
contenterons d'un fichier de mots de passe en mode texte.</p>
<p>Ce fichier doit être enregistré à un endroit non accessible
depuis le web, de façon à ce que les clients ne puissent pas le
télécharger. Par exemple, si vos documents sont servis à partir de
<code>/usr/local/apache/htdocs</code>, vous pouvez enregistrer le
fichier des mots de passe dans
<code>/usr/local/apache/passwd</code>.</p>
<p>L'utilitaire <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> fourni avec Apache
permet de créer ce fichier. Vous le trouverez dans le répertoire
<code>bin</code> de votre installation d'Apache. Si vous avez
installé Apache à partir d'un paquetage tiers, il sera probablement
dans le chemin par défaut de vos exécutables.</p>
<p>Pour créer le fichier, tapez :</p>
<div class="example"><p><code>
htpasswd -c /usr/local/apache/passwd/passwords rbowen
</code></p></div>
<p><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> vous demandera d'entrer le mot de
passe, et de le retaper pour confirmation :</p>
<div class="example"><p><code>
# htpasswd -c /usr/local/apache/passwd/passwords rbowen<br />
New password: mot-de-passe<br />
Re-type new password: mot-de-passe<br />
Adding password for user rbowen
</code></p></div>
<p>Si <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> n'est pas dans le chemin par
défaut de vos exécutables, vous devrez bien entendu entrer le chemin
complet du fichier. Dans le cas d'une installation par défaut, il se
trouve à <code>/usr/local/apache2/bin/htpasswd</code>.</p>
<p>Ensuite, vous allez devoir configurer le serveur de façon à ce
qu'il demande un mot de passe et lui préciser quels utilisateurs ont
l'autorisation d'accès. Pour ce faire, vous pouvez soit éditer le
fichier <code>httpd.conf</code>, soit utiliser un fichier
<code>.htaccess</code>. Par exemple, si vous voulez protéger le
répertoire <code>/usr/local/apache/htdocs/secret</code>, vous pouvez
utiliser les directives suivantes, soit dans le fichier
<code>/usr/local/apache/htdocs/secret/.htaccess</code>, soit dans le
fichier <code>httpd.conf</code> à l'intérieur d'une section <Directory
"/usr/local/apache/htdocs/secret"> :</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "Restricted Files"
# (Following line optional)
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
Require user rbowen</pre>
<p>Examinons ces directives une à une. La directive <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code> définit la méthode
utilisée pour authentifier l'utilisateur. La méthode la plus
courante est <code>Basic</code>, et elle est implémentée par
<code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>. Il faut cependant garder à l'esprit
que l'authentification Basic transmet le mot de passe depuis le
client vers le serveur en clair. Cette méthode ne devra donc pas
être utilisée pour la transmission de données hautement sensibles si
elle n'est pas associée au module <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>. Apache
supporte une autre méthode d'authentification : <code>AuthType
Digest</code>. Cette méthode est implémentée par le module <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> et a été conçue pour
améliorer la sécurité. Ce but n'a cependant pas été atteint et il est préférable
de chiffrer la connexion avec <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.</p>
<p>La directive <code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code> définit
l'<dfn>Identificateur</dfn> (Realm) à utiliser avec
l'authentification. L'identificateur possède deux fonctions. Tout
d'abord, le client présente en général cette information à
l'utilisateur dans le cadre de la boîte de dialogue de mot de passe.
Ensuite, le client l'utilise pour déterminer quel mot de passe
envoyer pour une zone authentifiée donnée.</p>
<p>Ainsi par exemple, une fois un client authentifié dans la zone
<code>"Fichiers réservés"</code>, il soumettra à nouveau
automatiquement le même mot de passe pour toute zone du même serveur
marquée de l'identificateur <code>"Fichiers réservés"</code>. De
cette façon, vous pouvez éviter à un utilisateur d'avoir à saisir
plusieurs fois le même mot de passe en faisant partager le même
identificateur entre plusieurs zones réservées. Bien entendu et pour
des raisons de sécurité, le client devra redemander le mot
de passe chaque fois que le nom d'hôte du serveur sera modifié.</p>
<p>La directive <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> est, dans ce
cas, facultative, car <code>file</code> est la valeur par défaut
pour cette directive. Par contre, cette directive sera obligatoire
si vous utilisez une autre source d'authentification comme
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> ou
<code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.</p>
<p>La directive <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> définit le chemin
du fichier de mots de passe que nous venons de créer avec
<code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>. Si vous possédez un grand nombre
d'utilisateurs, la durée de la recherche dans un fichier texte pour
authentifier un utilisateur à chaque requête va augmenter
rapidement, et pour pallier cet inconvénient, Apache peut aussi
stocker les données relatives aux
utilisateurs dans des bases de données rapides. Le module
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> fournit la directive <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>. Les programmes <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> et <code class="program"><a href="../programs/htdbm.html">htdbm</a></code> permettent de
créer et manipuler ces fichiers. Enfin, de nombreux modules tiers
fournissent d'autres types d'authentification.</p>
<p>Enfin, la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> implémente la partie
autorisation du processus en définissant l'utilisateur autorisé à
accéder à cette zone du serveur. Dans la section suivante, nous
décrirons les différentes méthodes d'utilisation de la directive
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="lettingmorethanonepersonin" id="lettingmorethanonepersonin">Autorisation d'accès à
plusieurs personnes</a></h2>
<p>Les directives ci-dessus n'autorisent qu'une personne (quelqu'un
possédant le nom d'utilisateur <code>rbowen</code>) à accéder au
répertoire. Dans la plupart des cas, vous devrez autoriser
l'accès à plusieurs personnes. C'est ici
qu'intervient la directive <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>.</p>
<p>Si vous voulez autoriser l'accès à plusieurs personnes, vous
devez créer un fichier de groupes qui associe des noms de groupes
avec une liste d'utilisateurs de ce groupe. Le format de ce fichier
est très simple, et vous pouvez le créer avec votre éditeur favori.
Son contenu se présente comme suit :</p>
<div class="example"><p><code>
Nom-de-groupe: rbowen dpitts sungo rshersey
</code></p></div>
<p>Il s'agit simplement une liste des membres du groupe sous la
forme d'une ligne séparée par des espaces.</p>
<p>Pour ajouter un utilisateur à votre fichier de mots de passe
préexistant, entrez :</p>
<div class="example"><p><code>
htpasswd /usr/local/apache/passwd/passwords dpitts
</code></p></div>
<p>Vous obtiendrez le même effet qu'auparavant, mais le mot de passe
sera ajouté au fichier, plutôt que d'en créer un nouveau (C'est le
drapeau <code>-c</code> qui permet de créer un nouveau fichier de
mots de passe)..</p>
<p>Maintenant, vous devez modifier votre fichier
<code>.htaccess</code> ou la section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> comme suit :</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "By Invitation Only"
# Optional line:
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthGroupFile "/usr/local/apache/passwd/groups"
Require group GroupName</pre>
<p>Maintenant, quiconque appartient au groupe
<code>Nom-de-groupe</code>, et possède une entrée dans le fichier
<code>password</code> pourra accéder au répertoire s'il tape le bon
mot de passe.</p>
<p>Il existe une autre méthode moins contraignante pour autoriser
l'accès à plusieurs personnes. Plutôt que de créer un fichier de
groupes, il vous suffit d'ajouter la directive suivante :</p>
<pre class="prettyprint lang-config">Require valid-user</pre>
<p>Le remplacement de la ligne <code>Require user rbowen</code> par
la ligne <code>Require valid-user</code> autorisera l'accès à
quiconque possédant une entrée dans le fichier password, et ayant
tapé le bon mot de passe.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="possibleproblems" id="possibleproblems">Problèmes possibles</a></h2>
<p>L'authentification Basic est spécifiée d'une telle manière que
vos nom d'utilisateur et mot de passe doivent être vérifiés chaque
fois que vous demandez un document au serveur, et ceci même si vous
rechargez la même page, et pour chaque image contenue dans la page
(si elles sont situées dans un répertoire protégé). Comme vous
pouvez l'imaginer, ceci ralentit un peu le fonctionnement. La mesure
dans laquelle le fonctionnement est ralenti est proportionnelle à la
taille du fichier des mots de passe, car ce dernier doit être ouvert
et la liste des utilisateurs parcourue jusqu'à ce que votre nom soit
trouvé, et ceci chaque fois qu'une page est chargée.</p>
<p>En conséquence, ce ralentissement impose une limite pratique au
nombre d'utilisateurs que vous pouvez enregistrer dans un fichier de
mots de passe. Cette limite va varier en fonction des performances
de votre serveur, mais vous commencerez à remarquer un
ralentissement lorsque vous atteindrez quelques centaines
d'utilisateurs, et serez alors appelés à utiliser une méthode
d'authentification différente.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="dbmdbd" id="dbmdbd">Autre méthode de stockage des mots de
passe</a></h2>
<p>Suite au problème évoqué précédemment et induit par le stockage
des mots de passe dans un fichier texte, vous pouvez être appelé à
stocker vos mots de passe d'une autre manière, par exemple dans une
base de données.</p>
<p>Pour y parvenir, on peut utiliser les modules
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> ou <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.
Vous pouvez choisir comme format de stockage <code>dbm</code> ou
<code>dbd</code> à la place de <code>file</code> pour la directive
<code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code>.</p>
<p>Par exemple, pour sélectionner un fichier dbm à la place d'un
fichier texte :</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider dbm
AuthDBMUserFile "/www/passwords/passwd.dbm"
Require valid-user
</Directory></pre>
<p>D'autres options sont disponibles. Consultez la documentation de
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> pour plus de détails.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="multprovider" id="multprovider">Utilisation de plusieurs fournisseurs
d'authentification</a></h2>
<p>Depuis l'arrivée des nouvelles architecture d'autorisation et
d'authentification basées sur les fournisseurs, vous n'êtes plus
limité à une méthode d'authentification et d'autorisation
unique. En fait, on peut panacher autant de fournisseurs que l'on
veut, ce qui vous permet d'élaborer l'architecture qui correspond
exactement à vos besoins. Dans l'exemple suivant, on utilise
conjointement les fournisseurs d'authentification
file et LDAP :</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider file ldap
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthLDAPURL ldap://ldaphost/o=yourorg
Require valid-user
</Directory></pre>
<p>Dans cet exemple, le fournisseur file va tenter d'authentifier
l'utilisateur en premier. S'il n'y parvient pas, le fournisseur LDAP
sera sollicité. Ceci permet l'élargissement des possibilités
d'authentification si votre organisation implémente plusieurs types
de bases d'authentification. D'autres scénarios d'authentification
et d'autorisation peuvent associer un type d'authentification avec
un autre type d'autorisation. Par exemple, une authentification
basée sur un fichier de mots de passe peut permettre l'attribution
d'autorisations basée sur un annuaire LDAP.</p>
<p>Tout comme plusieurs fournisseurs d'authentification peuvent être
implémentés, on peut aussi utiliser plusieurs méthodes
d'autorisation. Dans l'exemple suivant, on utilise à la fois une
autorisation à base de fichier de groupes et une autorisation à base
de groupes LDAP.</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthLDAPURL ldap://ldaphost/o=yourorg
AuthGroupFile "/usr/local/apache/passwd/groups"
Require group GroupName
Require ldap-group cn=mygroup,o=yourorg
</Directory></pre>
<p>Pour un scénario d'autorisation un peu plus avancé, des
directives de conteneur d'autorisation comme <code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code> et
<code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code> permettent d'appliquer une
logique telle que l'ordre dans lequel les autorisations sont
appliquées peut être entièrement contrôlé au niveau de la
configuration. Voir <a href="../mod/mod_authz_core.html#logic">Conteneurs
d'autorisations</a> pour un exemple de ce contrôle.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="beyond" id="beyond">Pour aller plus loin qu'une simple
autorisation</a></h2>
<p>La manière dont les autorisations sont accordées est désormais
beaucoup plus souple qu'une simple vérification auprès d'une seule
base de données. Il est maintenant possible de choisir l'ordre, la
logique et la manière selon lesquels une autorisation est
accordée.</p>
<h3><a name="authandororder" id="authandororder">Appliquer logique et
ordonnancement</a></h3>
<p>Le contrôle de la manière et de l'ordre selon lesquels le
processus d'autorisation était appliqué
constituait une sorte de mystère par
le passé. Dans Apache 2.2, un mécanisme d'authentification basé
sur les fournisseurs a été développé afin de séparer le
véritable processus d'authentification de l'autorisation et ses
différentes fonctionnalités. Un des avantages colatéraux
résidait dans le fait que les fournisseurs d'authentification
pouvaient être configurés et appelés selon un ordre particulier
indépendant de l'ordre de chargement du module auth proprement
dit. Ce mécanisme basé sur les fournisseurs a été étendu au
processus d'autorisation. Ceci signifie que la directive
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> définit
non seulement quelles méthodes d'autorisation doivent être
utilisées, mais aussi l'ordre dans lequel elles sont appelées.
Les méthodes d'autorisation sont appelées selon l'ordre dans
lequel les directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> apparaissent dans la
configuration.</p>
<p>Avec l'introduction des directives de conteneur
d'autorisations <code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code>
et <code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code>, la
configuration contrôle aussi le moment où les méthodes
d'autorisation sont appelées, et quels critères déterminent
l'autorisation d'accès. Voir <a href="../mod/mod_authz_core.html#logic">Conteneurs
d'autorisations</a> pour un exemple de la manière de les
utiliser pour exprimer des logiques d'autorisation
complexes.</p>
<p>Par défaut, toutes les directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> sont
traitées comme si elles étaient contenues dans une directive
<code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code>. En d'autres termes, il
suffit
qu'une méthode d'autorisation s'applique avec succès pour que
l'autorisation soit accordée.</p>
<h3><a name="reqaccessctrl" id="reqaccessctrl">Utilisation de fournisseurs
d'autorisation pour le contrôle d'accès</a></h3>
<p>La vérification du nom d'utilisateur et du mot de passe ne
constituent qu'un aspect des méthodes d'authentification.
Souvent, le contrôle d'accès à certaines personnes n'est pas
basé sur leur identité ; il peut dépendre, par exemple de leur
provenance.</p>
<p>Les fournisseurs d'autorisation <code>all</code>,
<code>env</code>, <code>host</code> et <code>ip</code> vous
permettent d'accorder ou refuser l'accès en
fonction de critères tels que le nom d'hôte ou l'adresse
IP de la machine qui effectue la requête.</p>
<p>L'utilisation de ces fournisseurs est spécifiée à l'aide de
la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>. Cette directive
permet d'enregistrer quels fournisseurs d'autorisation
seront appelés dans le processus d'autorisation au cours du
traitement de la requête. Par exemple :</p>
<pre class="prettyprint lang-config">Require ip <var>address</var></pre>
<p>où <var>adresse</var> est une adresse IP (ou une adresse IP
partielle) ou :</p>
<pre class="prettyprint lang-config">Require host <var>domain_name</var></pre>
<p>où <var>nom_domaine</var> est un nom de domaine entièrement
qualifé (ou un nom de domaine partiel) ; vous pouvez indiquer
plusieurs adresses ou noms de domaines, si vous le désirez.</p>
<p>Par exemple, si vous voulez rejeter les spams dont une
machine vous inonde, vous pouvez utiliser ceci :</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not ip 10.252.46.165
</RequireAll></pre>
<p>Ainsi, les visiteurs en provenance de cette adresse ne
pourront pas voir le contenu concerné par cette directive. Si,
par contre, vous connaissez le nom de la machine, vous pouvez
utiliser ceci :</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not host host.example.com
</RequireAll></pre>
<p>Et si vous voulez interdire l'accès à toutes les machines
d'un domaine, vous pouvez spécifier une partie seulement de
l'adresse ou du nom de domaine :</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not ip 192.168.205
Require not host phishers.example.com moreidiots.example
Require not host ke
</RequireAll></pre>
<p>L'utilisation de la directive <code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code>
avec de multiples directives <code class="directive"><a href="../mod/mod_authz_core.html#require"><Require></a></code>, toutes avec la négation
<code>not</code>, n'accordera l'accès que si toutes les
conditions négatives sont vérifiées. En d'autres termes, l'accès
sera refusé si au moins une des conditions négatives n'est pas
vérifiée.</p>
<h3><a name="filesystem" id="filesystem">Compatibilité ascendante du contrôle
d'accès</a></h3>
<p>L'adoption d'un mécanisme à base de fournisseurs pour
l'authentification, a pour effet colatéral de rendre inutiles
les directives <code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>, <code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>, <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> et <code class="directive"><a href="../mod/mod_access_compat.html#satisfy">Satisfy</a></code>. Cependant, et à
des fins de compatibilité ascendante vers les anciennes
configurations, ces directives ont été déplacées vers le module
<code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code>.</p>
<div class="warning"><h3>Note</h3>
<p>Les directives fournies par le module
<code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> sont devenues obsolètes depuis
la refonte du module <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>. Mélanger d'anciennes
directives comme <code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>, <code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code> ou <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> avec des nouvelles comme
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> est techniquement
possible mais déconseillé. En effet, <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> a
été conçu pour supporter des configurations ne contenant que des anciennes
directives afin de faciliter le passage à la version 2.4. Voir le document
<a href="../upgrading.html">upgrading</a> pour plus de détails.
</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="socache" id="socache">Mise en cache de l'authentification</a></h2>
<p>Dans certains cas, l'authentification constitue une charge
inacceptable pour un fournisseur d'authentification ou votre réseau.
Ceci est susceptible d'affecter les utilisateurs du module
<code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> (ou les fournisseurs
tiers/personnalisés). Pour résoudre ce problème, HTTPD 2.3/2.4
propose un nouveau fournisseur de mise en cache,
<code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code>, qui permet de mettre en cache
les données d'authentification, et ainsi réduire la charge du/des
fournisseurs(s) originels.</p>
<p>Cette mise en cache apportera un gain en performance substantiel
à certains utilisateurs.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinformation" id="moreinformation">Pour aller plus loin . . .</a></h2>
<p>Vous pouvez aussi lire la documentation de
<code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> et <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>
qui contient des informations supplémentaires à propos du
fonctionnement de tout ceci.
Certaines configurations d'authentification peuvent aussi être
simplifiées à l'aide de la directive <code class="directive"><a href="../mod/mod_authn_core.html#authnprovideralias"><AuthnProviderAlias></a></code>.</p>
<p>Les différents algorithmes de chiffrement supportés par Apache
pour authentifier les données sont expliqués dans <a href="../misc/password_encryptions.html">PasswordEncryptions</a>.</p>
<p>Enfin vous pouvez consulter la recette <a href="access.html">Contrôle
d'accès</a>, qui décrit un certain nombre de situations en relation
avec le sujet.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/auth.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/auth.html" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/auth.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/index.html.fr.utf8 0000664 0001751 0001751 00000021607 14740503670 021473 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>How-To / Tutoriels - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>How-To / Tutoriels</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/" title="Français"> fr </a> |
<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></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="howto" id="howto">How-To / Tutoriels</a></h2>
<dl>
<dt>Authentification et autorisation</dt>
<dd>
<p>L'authentification représente tout processus par lequel vous
vérifiez si quelqu'un correspond bien à la personne qu'il
prétend être. L'autorisation représente tout processus
permettant de savoir si une personne est autorisée à aller là où
elle veut aller, ou à obtenir les informations qu'elle demande.</p>
<p>Voir <a href="auth.html">Authentification, Autorisation</a></p>
</dd>
</dl>
<dl>
<dt>Contrôle d'accès</dt>
<dd>
<p>Le contrôle d'accès se réfère au processus permettant
d'interdire ou d'accorder l'accès à une ressource en fonction de
certains critères, et il existe de nombreuses façons d'y
parvenir.</p>
<p>Voir <a href="access.html">Contrôle d'accès</a></p>
</dd>
</dl>
<dl>
<dt>Contenu dynamique avec CGI</dt>
<dd>
<p>L'interface CGI (Common Gateway Interface)
fournit au serveur web une méthode d'interaction avec des
programmes externes générateurs de contenu, souvent nommés
programmes CGI ou scripts CGI. Il s'agit d'une méthode
simple permettant d'ajouter du contenu
dynamique à votre site web. Ce document se veut une introduction
à la configuration de CGI sur votre serveur web Apache et à
l'écriture de programmes CGI.</p>
<p>Voir <a href="cgi.html">CGI : contenu dynamique</a></p>
</dd>
</dl>
<dl>
<dt>Fichiers <code>.htaccess</code></dt>
<dd>
<p>Les fichiers <code>.htaccess</code> permettent de modifier la
configuration du serveur au niveau de chaque répertoire. À cet
effet, un fichier est placé dans un répertoire particulier du site
web, et les directives de configuration qu'il contient s'appliquent à ce
répertoire et à tous ses sous-répertoires.</p>
<p>Voir <a href="htaccess.html">Fichiers <code>.htaccess</code></a></p>
</dd>
</dl>
<dl>
<dt>HTTP/2 avec httpd</dt>
<dd>
<p>HTTP/2 est une évolution du protocole de la couche application le plus
connu au monde, HTTP. Les efforts se sont concentrés sur une amélioration
de l'efficacité de l'utilisation des ressources réseau sans modifier la
sémantique de HTTP. Ce guide explique la manière dont HTTP/2 est
implémenté dans httpd, donne des conseils pour une configuration de base
ainsi qu'une liste de recommandations.
</p>
<p>Voir le <a href="http2.html">guide HTTP/2</a></p>
</dd>
</dl>
<dl>
<dt>Introduction au Inclusions côté Serveur (Server Side Includes
ou SSI)</dt>
<dd>
<p>Les SSI sont des directives que l'on place dans des pages
HTML, et qui sont évaluées par le serveur lorsque ces pages sont
servies. Elles vous permettent d'ajouter du contenu généré
dynamiquement à une page HTML existante, sans avoir à servir
l'intégralité de la page via un programme CGI, ou toute autre
technologie dynamique.</p>
<p>Voir <a href="ssi.html">Server Side Includes (SSI)</a></p>
</dd>
</dl>
<dl>
<dt>Répertoires web de l'utilisateur</dt>
<dd>
<p>Sur les systèmes multi-utilisateurs, vous pouvez permettre à
chaque utilisateur d'avoir un site web dans son répertoire home
via la directive <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>. Les visiteurs de l'URL
<code>http://example.com/~nom-utilisateur/</code> vont recevoir
du contenu situé dans le répertoire home de l'utilisateur
"<code>nom-utilisateur</code>", et dans le sous-répertoire
spécifié par la directive <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>.</p>
<p>Voir <a href="public_html.html">Répertoires web des utilisateurs (<code>public_html</code>)</a></p>
</dd>
</dl>
<dl>
<dt>Mandataires inverses</dt>
<dd>
<p>Apache httpd possède des fonctionnalités évoluées de serveur
mandataire inverse via ses directives <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> et <code class="directive"><a href="../mod/mod_proxy.html#balancermember">BalancerMember</a></code> qui permettent
d'implémenter un système de mandataire inverse sophistiqué garantissant
une haute disponibilité, une répartition et une réattribution de charge,
un regroupement de serveurs en grappe (clustering) basé sur le cloud et
une reconfiguration dynamique à la volée.</p>
<p>Voir le <a href="reverse_proxy.html" />Guide de configuration des
mandataires inverses</p>
</dd>
</dl>
<dl>
<dt>Réécriture d'URLs avec mod_rewrite</dt>
<dd>
<p>La réécriture d'URLs avec (ou sans) <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> devient
l'une des questions les plus fréquentes posées dans nos listes de
diffusion et nos canaux IRC. C'est pourquoi nous avons dédié une <a href="../rewrite/">section entière de notre documentation</a> à des
howtos et recettes sur ce sujet.</p>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/" title="Français"> fr </a> |
<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/htaccess.html.en 0000664 0001751 0001751 00000066634 14737241666 021312 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Server Tutorial: .htaccess files - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Apache HTTP Server Tutorial: .htaccess files</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/howto/htaccess.html" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
</div>
<p><code>.htaccess</code> files provide a way to make configuration
changes on a per-directory basis.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">.htaccess files</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what">What they are/How to use them</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#when">When (not) to use .htaccess files</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#how">How directives are applied</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#auth">Authentication example</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ssi">Server Side Includes example</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewrite">Rewrite Rules in .htaccess files</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">CGI example</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">Troubleshooting</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="related" id="related">.htaccess files</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</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_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</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/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li></ul></td></tr></table>
<div class="note">You should avoid using <code>.htaccess</code> files completely if you have access to
httpd main server config file. Using <code>.htaccess</code> files slows down your Apache http server.
Any directive that you can include in a <code>.htaccess</code> file is better set in a <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> block, as it will have the same effect with better performance.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">What they are/How to use them</a></h2>
<p><code>.htaccess</code> files (or "distributed configuration files")
provide a way to make configuration changes on a per-directory basis. A
file, containing one or more configuration directives, is placed in a
particular document directory, and the directives apply to that
directory, and all subdirectories thereof.</p>
<div class="note"><h3>Note:</h3>
<p>If you want to call your <code>.htaccess</code> file something
else, you can change the name of the file using the <code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code> directive. For example,
if you would rather call the file <code>.config</code> then you
can put the following in your server configuration file:</p>
<pre class="prettyprint lang-config">AccessFileName ".config"</pre>
</div>
<p>In general, <code>.htaccess</code> files use the same syntax as
the <a href="../configuring.html#syntax">main configuration
files</a>. What you can put in these files is determined by the
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> directive. This
directive specifies, in categories, what directives will be
honored if they are found in a <code>.htaccess</code> file. If a
directive is permitted in a <code>.htaccess</code> file, the
documentation for that directive will contain an Override section,
specifying what value must be in <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> in order for that
directive to be permitted.</p>
<p>For example, if you look at the documentation for the <code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>
directive, you will find that it is permitted in <code>.htaccess</code>
files. (See the Context line in the directive summary.) The <a href="../mod/directive-dict.html#Context">Override</a> line reads
<code>FileInfo</code>. Thus, you must have at least
<code>AllowOverride FileInfo</code> in order for this directive to be
honored in <code>.htaccess</code> files.</p>
<div class="example"><h3>Example:</h3><table>
<tr>
<td><a href="../mod/directive-dict.html#Context">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td><a href="../mod/directive-dict.html#Override">Override:</a></td>
<td>FileInfo</td>
</tr>
</table></div>
<p>If you are unsure whether a particular directive is permitted in a
<code>.htaccess</code> file, look at the documentation for that
directive, and check the Context line for ".htaccess".</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="when" id="when">When (not) to use .htaccess files</a></h2>
<p>In general, you should only use <code>.htaccess</code> files when
you don't have access to the main server configuration file. There is,
for example, a common misconception that user authentication should
always be done in <code>.htaccess</code> files, and, in more recent years,
another misconception that <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> directives
must go in <code>.htaccess</code> files. This is simply not the
case. You can put user authentication configurations in the main server
configuration, and this is, in fact, the preferred way to do
things. Likewise, <code>mod_rewrite</code> directives work better,
in many respects, in the main server configuration.</p>
<p><code>.htaccess</code> files should be used in a case where the
content providers need to make configuration changes to the server on a
per-directory basis, but do not have root access on the server system.
In the event that the server administrator is not willing to make
frequent configuration changes, it might be desirable to permit
individual users to make these changes in <code>.htaccess</code> files
for themselves. This is particularly true, for example, in cases where
ISPs are hosting multiple user sites on a single machine, and want
their users to be able to alter their configuration.</p>
<p>However, in general, use of <code>.htaccess</code> files should be
avoided when possible. Any configuration that you would consider
putting in a <code>.htaccess</code> file, can just as effectively be
made in a <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> section in your main server
configuration file.</p>
<p>There are two main reasons to avoid the use of
<code>.htaccess</code> files.</p>
<p>The first of these is performance. When <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
is set to allow the use of <code>.htaccess</code> files, httpd will
look in every directory for <code>.htaccess</code> files. Thus,
permitting <code>.htaccess</code> files causes a performance hit,
whether or not you actually even use them! Also, the
<code>.htaccess</code> file is loaded every time a document is
requested.</p>
<p>Further note that httpd must look for <code>.htaccess</code> files
in all higher-level directories, in order to have a full complement of
directives that it must apply. (See section on <a href="#how">how
directives are applied</a>.) Thus, if a file is requested out of a
directory <code>/www/htdocs/example</code>, httpd must look for the
following files:</p>
<div class="example"><p><code>
/.htaccess<br />
/www/.htaccess<br />
/www/htdocs/.htaccess<br />
/www/htdocs/example/.htaccess
</code></p></div>
<p>And so, for each file access out of that directory, there are 4
additional file-system accesses, even if none of those files are
present. (Note that this would only be the case if
<code>.htaccess</code> files were enabled for <code>/</code>, which
is not usually the case.)</p>
<p>In the case of <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directives, in
<code>.htaccess</code> context these regular expressions must be
re-compiled with every request to the directory, whereas in main
server configuration context they are compiled once and cached.
Additionally, the rules themselves are more complicated, as one must
work around the restrictions that come with per-directory context
and <code>mod_rewrite</code>. Consult the <a href="../rewrite/intro.html#htaccess">Rewrite Guide</a> for more
detail on this subject.</p>
<p>The second consideration is one of security. You are permitting
users to modify server configuration, which may result in changes over
which you have no control. Carefully consider whether you want to give
your users this privilege. Note also that giving users less
privileges than they need will lead to additional technical support
requests. Make sure you clearly tell your users what level of
privileges you have given them. Specifying exactly what you have set
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> to, and pointing them
to the relevant documentation, will save yourself a lot of confusion
later.</p>
<p>Note that it is completely equivalent to put a <code>.htaccess</code>
file in a directory <code>/www/htdocs/example</code> containing a
directive, and to put that same directive in a Directory section
<code><Directory "/www/htdocs/example"></code> in your main server
configuration:</p>
<p><code>.htaccess</code> file in <code>/www/htdocs/example</code>:</p>
<div class="example"><h3>Contents of .htaccess file in
<code>/www/htdocs/example</code></h3><pre class="prettyprint lang-config">AddType text/example ".exm"</pre>
</div>
<div class="example"><h3>Section from your <code>httpd.conf</code>
file</h3><pre class="prettyprint lang-config"><Directory "/www/htdocs/example">
AddType text/example ".exm"
</Directory></pre>
</div>
<p>However, putting this configuration in your server configuration
file will result in less of a performance hit, as the configuration is
loaded once when httpd starts, rather than every time a file is
requested.</p>
<p>The use of <code>.htaccess</code> files can be disabled completely
by setting the <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
directive to <code>none</code>:</p>
<pre class="prettyprint lang-config">AllowOverride None</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="how" id="how">How directives are applied</a></h2>
<p>The configuration directives found in a <code>.htaccess</code> file
are applied to the directory in which the <code>.htaccess</code> file
is found, and to all subdirectories thereof. However, it is important
to also remember that there may have been <code>.htaccess</code> files
in directories higher up. Directives are applied in the order that they
are found. Therefore, a <code>.htaccess</code> file in a particular
directory may override directives found in <code>.htaccess</code> files
found higher up in the directory tree. And those, in turn, may have
overridden directives found yet higher up, or in the main server
configuration file itself.</p>
<p>Example:</p>
<p>In the directory <code>/www/htdocs/example1</code> we have a
<code>.htaccess</code> file containing the following:</p>
<pre class="prettyprint lang-config">Options +ExecCGI</pre>
<p>(Note: you must have "<code>AllowOverride Options</code>" in effect
to permit the use of the "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" directive in
<code>.htaccess</code> files.)</p>
<p>In the directory <code>/www/htdocs/example1/example2</code> we have
a <code>.htaccess</code> file containing:</p>
<pre class="prettyprint lang-config">Options Includes</pre>
<p>Because of this second <code>.htaccess</code> file, in the directory
<code>/www/htdocs/example1/example2</code>, CGI execution is not
permitted, as only <code>Options Includes</code> is in effect, which
completely overrides any earlier setting that may have been in
place.</p>
<h3><a name="merge" id="merge">Merging of .htaccess with the main
configuration files</a></h3>
<p>As discussed in the documentation on <a href="../sections.html">Configuration Sections</a>,
<code>.htaccess</code> files can override the <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections for
the corresponding directory, but will be overridden by other types
of configuration sections from the main configuration files. This
fact can be used to enforce certain configurations, even in the
presence of a liberal <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> setting. For example, to
prevent script execution while allowing anything else to be set in
<code>.htaccess</code> you can use:</p>
<pre class="prettyprint lang-config"><Directory "/www/htdocs">
AllowOverride All
</Directory>
<Location "/">
Options +IncludesNoExec -ExecCGI
</Location></pre>
<div class="note">This example assumes that your <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> is <code>/www/htdocs</code>.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="auth" id="auth">Authentication example</a></h2>
<p>If you jumped directly to this part of the document to find out how
to do authentication, it is important to note one thing. There is a
common misconception that you are required to use
<code>.htaccess</code> files in order to implement password
authentication. This is not the case. Putting authentication directives
in a <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
section, in your main server configuration file, is the preferred way
to implement this, and <code>.htaccess</code> files should be used only
if you don't have access to the main server configuration file. See <a href="#when">above</a> for a discussion of when you should and should
not use <code>.htaccess</code> files.</p>
<p>Having said that, if you still think you need to use a
<code>.htaccess</code> file, you may find that a configuration such as
what follows may work for you.</p>
<p><code>.htaccess</code> file contents:</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "Password Required"
AuthUserFile "/www/passwords/password.file"
AuthGroupFile "/www/passwords/group.file"
Require group admins</pre>
<p>Note that <code>AllowOverride AuthConfig</code> must be in effect
for these directives to have any effect.</p>
<p>Please see the <a href="auth.html">authentication tutorial</a> for a
more complete discussion of authentication and authorization.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ssi" id="ssi">Server Side Includes example</a></h2>
<p>Another common use of <code>.htaccess</code> files is to enable
Server Side Includes for a particular directory. This may be done with
the following configuration directives, placed in a
<code>.htaccess</code> file in the desired directory:</p>
<pre class="prettyprint lang-config">Options +Includes
AddType text/html shtml
AddHandler server-parsed shtml</pre>
<p>Note that <code>AllowOverride Options</code> and <code>AllowOverride
FileInfo</code> must both be in effect for these directives to have any
effect.</p>
<p>Please see the <a href="ssi.html">SSI tutorial</a> for a more
complete discussion of server-side includes.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">Rewrite Rules in .htaccess files</a></h2>
<p>When using <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> in
<code>.htaccess</code> files, be aware that the per-directory context
changes things a bit. In particular, rules are taken to be relative to
the current directory, rather than being the original requested URI.
Consider the following examples:</p>
<pre class="prettyprint lang-config"># In httpd.conf
RewriteRule "^/images/(.+)\.jpg" "/images/$1.png"
# In .htaccess in root dir
RewriteRule "^images/(.+)\.jpg" "images/$1.png"
# In .htaccess in images/
RewriteRule "^(.+)\.jpg" "$1.png"</pre>
<p>In a <code>.htaccess</code> in your document directory, the leading
slash is removed from the value supplied to <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, and in the
<code>images</code> subdirectory, <code>/images/</code> is removed from
it. Thus, your regular expression needs to omit that portion as
well.</p>
<p>Consult the <a href="../rewrite/">mod_rewrite documentation</a> for
further details on using <code>mod_rewrite</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">CGI example</a></h2>
<p>Finally, you may wish to use a <code>.htaccess</code> file to permit
the execution of CGI programs in a particular directory. This may be
implemented with the following configuration:</p>
<pre class="prettyprint lang-config">Options +ExecCGI
AddHandler cgi-script cgi pl</pre>
<p>Alternately, if you wish to have all files in the given directory be
considered to be CGI programs, this may be done with the following
configuration:</p>
<pre class="prettyprint lang-config">Options +ExecCGI
SetHandler cgi-script</pre>
<p>Note that <code>AllowOverride Options</code> and <code>AllowOverride
FileInfo</code> must both be in effect for these directives to have any
effect.</p>
<p>Please see the <a href="cgi.html">CGI tutorial</a> for a more
complete discussion of CGI programming and configuration.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot">Troubleshooting</a></h2>
<p>When you put configuration directives in a <code>.htaccess</code>
file, and you don't get the desired effect, there are a number of
things that may be going wrong.</p>
<p>Most commonly, the problem is that <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> is not
set such that your configuration directives are being honored. Make
sure that you don't have a <code>AllowOverride None</code> in effect
for the file scope in question. A good test for this is to put garbage
in your <code>.htaccess</code> file and reload the page. If a server error is
not generated, then you almost certainly have <code>AllowOverride
None</code> in effect.</p>
<p>If, on the other hand, you are getting server errors when trying to
access documents, check your httpd error log. It will likely tell you
that the directive used in your <code>.htaccess</code> file is not
permitted.</p>
<div class="example"><p><code>
[Fri Sep 17 18:43:16 2010] [alert] [client 192.168.200.51] /var/www/html/.htaccess: DirectoryIndex not allowed here
</code></p></div>
<p>This will indicate either that you've used a directive that is
never permitted in <code>.htaccess</code> files, or that you simply
don't have <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> set to
a level sufficient for the directive you've used. Consult the
documentation for that particular directive to determine which is
the case.</p>
<p>Alternately, it may tell you that you had a syntax error in your
usage of the directive itself.</p>
<div class="example"><p><code>
[Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
</code></p></div>
<p>In this case, the error message should be specific to the
particular syntax error that you have committed.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/howto/htaccess.html" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/htaccess.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/reverse_proxy.html.en 0000664 0001751 0001751 00000050140 14737241666 022412 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Reverse Proxy Guide - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Reverse Proxy Guide</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/howto/reverse_proxy.html" title="English"> en </a> |
<a href="../fr/howto/reverse_proxy.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>In addition to being a "basic" web server, and providing static and
dynamic content to end-users, Apache httpd (as well as most other web
servers) can also act as a reverse proxy server, also-known-as a
"gateway" server.</p>
<p>In such scenarios, httpd itself does not generate or host the data,
but rather the content is obtained by one or several backend servers,
which normally have no direct connection to the external network. As
httpd receives a request from a client, the request itself is <em>proxied</em>
to one of these backend servers, which then handles the request, generates
the content and then sends this content back to httpd, which then
generates the actual HTTP response back to the client.</p>
<p>There are numerous reasons for such an implementation, but generally
the typical rationales are due to security, high-availability, load-balancing
and centralized authentication/authorization. It is critical in these
implementations that the layout, design and architecture of the backend
infrastructure (those servers which actually handle the requests) are
insulated and protected from the outside; as far as the client is concerned,
the reverse proxy server <em>is</em> the sole source of all content.</p>
<p>A typical implementation is below:</p>
<p class="centered"><img src="../images/reverse-proxy-arch.png" alt="reverse-proxy-arch" /></p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Reverse Proxy</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#simple">Simple reverse proxying</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cluster">Clusters and Balancers</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#config">Balancer and BalancerMember configuration</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#failover">Failover</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#manager">Balancer Manager</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#health-check">Dynamic Health Checks</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#status">BalancerMember status flags</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="related" id="related">Reverse Proxy</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li><li><code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></li><li><code class="module"><a href="../mod/mod_proxy_hcheck.html">mod_proxy_hcheck</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="../mod/mod_proxy.html#balancermember">BalancerMember</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="simple" id="simple">Simple reverse proxying</a></h2>
<p>
The <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>
directive specifies the mapping of incoming requests to the backend
server (or a cluster of servers known as a <code>Balancer</code>
group). The simplest example proxies all requests (<code>"/"</code>)
to a single backend:
</p>
<pre class="prettyprint lang-config">ProxyPass "/" "http://www.example.com/"</pre>
<p>
To ensure that and <code>Location:</code> headers generated from
the backend are modified to point to the reverse proxy, instead of
back to itself, the <code class="directive"><a href="../mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code>
directive is most often required:
</p>
<pre class="prettyprint lang-config">ProxyPass "/" "http://www.example.com/"
ProxyPassReverse "/" "http://www.example.com/"</pre>
<p>Only specific URIs can be proxied, as shown in this example:</p>
<pre class="prettyprint lang-config">ProxyPass "/images" "http://www.example.com/"
ProxyPassReverse "/images" "http://www.example.com/"</pre>
<p>In the above, any requests which start with the <code>/images</code>
path with be proxied to the specified backend, otherwise it will be handled
locally.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cluster" id="cluster">Clusters and Balancers</a></h2>
<p>
As useful as the above is, it still has the deficiencies that should
the (single) backend node go down, or become heavily loaded, that proxying
those requests provides no real advantage. What is needed is the ability
to define a set or group of backend servers which can handle such
requests and for the reverse proxy to load balance and failover among
them. This group is sometimes called a <em>cluster</em> but Apache httpd's
term is a <em>balancer</em>. One defines a balancer by leveraging the
<code class="directive"><a href="../mod/mod_proxy.html#proxy"><Proxy></a></code> and
<code class="directive"><a href="../mod/mod_proxy.html#balancermember">BalancerMember</a></code> directives as
shown:
</p>
<pre class="prettyprint lang-config"><Proxy balancer://myset>
BalancerMember http://www2.example.com:8080
BalancerMember http://www3.example.com:8080
ProxySet lbmethod=bytraffic
</Proxy>
ProxyPass "/images/" "balancer://myset/"
ProxyPassReverse "/images/" "balancer://myset/"</pre>
<p>
The <code>balancer://</code> scheme is what tells httpd that we are creating
a balancer set, with the name <em>myset</em>. It includes 2 backend servers,
which httpd calls <em>BalancerMembers</em>. In this case, any requests for
<code>/images</code> will be proxied to <em>one</em> of the 2 backends.
The <code class="directive"><a href="../mod/mod_proxy.html#proxyset">ProxySet</a></code> directive
specifies that the <em>myset</em> Balancer use a load balancing algorithm
that balances based on I/O bytes.
</p>
<div class="note"><h3>Hint</h3>
<p>
<em>BalancerMembers</em> are also sometimes referred to as <em>workers</em>.
</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="config" id="config">Balancer and BalancerMember configuration</a></h2>
<p>
You can adjust numerous configuration details of the <em>balancers</em>
and the <em>workers</em> via the various parameters defined in
<code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>. For example,
assuming we would want <code>http://www3.example.com:8080</code> to
handle 3x the traffic with a timeout of 1 second, we would adjust the
configuration as follows:
</p>
<pre class="prettyprint lang-config"><Proxy balancer://myset>
BalancerMember http://www2.example.com:8080
BalancerMember http://www3.example.com:8080 loadfactor=3 timeout=1
ProxySet lbmethod=bytraffic
</Proxy>
ProxyPass "/images" "balancer://myset/"
ProxyPassReverse "/images" "balancer://myset/"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="failover" id="failover">Failover</a></h2>
<p>
You can also fine-tune various failover scenarios, detailing which workers
and even which balancers should be accessed in such cases. For example, the
below setup implements three failover cases:
</p>
<ol>
<li>
<code>http://spare1.example.com:8080</code> and
<code>http://spare2.example.com:8080</code> are only sent traffic if one
or both of <code>http://www2.example.com:8080</code> or
<code>http://www3.example.com:8080</code> is unavailable. (One spare
will be used to replace one unusable member of the same balancer set.)
</li>
<li>
<code>http://hstandby.example.com:8080</code> is only sent traffic if
all other workers in balancer set <code>0</code> are not available.
</li>
<li>
If all load balancer set <code>0</code> workers, spares, and the standby
are unavailable, only then will the
<code>http://bkup1.example.com:8080</code> and
<code>http://bkup2.example.com:8080</code> workers from balancer set
<code>1</code> be brought into rotation.
</li>
</ol>
<p>
Thus, it is possible to have one or more hot spares and hot standbys for
each load balancer set.
</p>
<pre class="prettyprint lang-config"><Proxy balancer://myset>
BalancerMember http://www2.example.com:8080
BalancerMember http://www3.example.com:8080 loadfactor=3 timeout=1
BalancerMember http://spare1.example.com:8080 status=+R
BalancerMember http://spare2.example.com:8080 status=+R
BalancerMember http://hstandby.example.com:8080 status=+H
BalancerMember http://bkup1.example.com:8080 lbset=1
BalancerMember http://bkup2.example.com:8080 lbset=1
ProxySet lbmethod=byrequests
</Proxy>
ProxyPass "/images/" "balancer://myset/"
ProxyPassReverse "/images/" "balancer://myset/"</pre>
<p>
For failover, hot spares are used as replacements for unusable workers in
the same load balancer set. A worker is considered unusable if it is
draining, stopped, or otherwise in an error/failed state. Hot standbys are
used if all workers and spares in the load balancer set are
unavailable. Load balancer sets (with their respective hot spares and
standbys) are always tried in order from lowest to highest.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="manager" id="manager">Balancer Manager</a></h2>
<p>
One of the most unique and useful features of Apache httpd's reverse proxy is
the embedded <em>balancer-manager</em> application. Similar to
<code class="module"><a href="../mod/mod_status.html">mod_status</a></code>, <em>balancer-manager</em> displays
the current working configuration and status of the enabled
balancers and workers currently in use. However, not only does it
display these parameters, it also allows for dynamic, runtime, on-the-fly
reconfiguration of almost all of them, including adding new <em>BalancerMembers</em>
(workers) to an existing balancer. To enable these capability, the following
needs to be added to your configuration:
</p>
<pre class="prettyprint lang-config"><Location "/balancer-manager">
SetHandler balancer-manager
Require host localhost
</Location></pre>
<div class="warning"><h3>Warning</h3>
<p>Do not enable the <em>balancer-manager</em> until you have <a href="../mod/mod_proxy.html#access">secured your server</a>. In
particular, ensure that access to the URL is tightly
restricted.</p>
</div>
<p>
When the reverse proxy server is accessed at that url
(eg: <code>http://rproxy.example.com/balancer-manager/</code>, you will see a
page similar to the below:
</p>
<p class="centered"><img src="../images/bal-man.png" alt="balancer-manager page" /></p>
<p>
This form allows the devops admin to adjust various parameters, take
workers offline, change load balancing methods and add new works. For
example, clicking on the balancer itself, you will get the following page:
</p>
<p class="centered"><img src="../images/bal-man-b.png" alt="balancer-manager page" /></p>
<p>
Whereas clicking on a worker, displays this page:
</p>
<p class="centered"><img src="../images/bal-man-w.png" alt="balancer-manager page" /></p>
<p>
To have these changes persist restarts of the reverse proxy, ensure that
<code class="directive"><a href="../mod/mod_proxy.html#balancerpersist">BalancerPersist</a></code> is enabled.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="health-check" id="health-check">Dynamic Health Checks</a></h2>
<p>
Before httpd proxies a request to a worker, it can <em>"test"</em> if that worker
is available via setting the <code>ping</code> parameter for that worker using
<code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>. Oftentimes it is
more useful to check the health of the workers <em>out of band</em>, in a
dynamic fashion. This is achieved in Apache httpd by the
<code class="module"><a href="../mod/mod_proxy_hcheck.html">mod_proxy_hcheck</a></code> module.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="status" id="status">BalancerMember status flags</a></h2>
<p>
In the <em>balancer-manager</em> the current state, or <em>status</em>, of a worker
is displayed and can be set/reset. The meanings of these statuses are as follows:
</p>
<table class="bordered">
<tr><th>Flag</th><th>String</th><th>Description</th></tr>
<tr><td> </td><td><em>Ok</em></td><td>Worker is available</td></tr>
<tr><td> </td><td><em>Init</em></td><td>Worker has been initialized</td></tr>
<tr><td><code>D</code></td><td><em>Dis</em></td><td>Worker is disabled and will not accept any requests; will be
automatically retried.</td></tr>
<tr><td><code>S</code></td><td><em>Stop</em></td><td>Worker is administratively stopped; will not accept requests
and will not be automatically retried</td></tr>
<tr><td><code>I</code></td><td><em>Ign</em></td><td>Worker is in ignore-errors mode and will always be considered available.</td></tr>
<tr><td><code>R</code></td><td><em>Spar</em></td><td>Worker is a hot spare. For each worker in a given lbset that is unusable
(draining, stopped, in error, etc.), a usable hot spare with the same lbset will be used in
its place. Hot spares can help ensure that a specific number of workers are always available
for use by a balancer.</td></tr>
<tr><td><code>H</code></td><td><em>Stby</em></td><td>Worker is in hot-standby mode and will only be used if no other
viable workers or spares are available in the balancer set.</td></tr>
<tr><td><code>E</code></td><td><em>Err</em></td><td>Worker is in an error state, usually due to failing pre-request check;
requests will not be proxied to this worker, but it will be retried depending on
the <code>retry</code> setting of the worker.</td></tr>
<tr><td><code>N</code></td><td><em>Drn</em></td><td>Worker is in drain mode and will only accept existing sticky sessions
destined for itself and ignore all other requests.</td></tr>
<tr><td><code>C</code></td><td><em>HcFl</em></td><td>Worker has failed dynamic health check and will not be used until it
passes subsequent health checks.</td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/howto/reverse_proxy.html" title="English"> en </a> |
<a href="../fr/howto/reverse_proxy.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/reverse_proxy.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/cgi.html.en 0000664 0001751 0001751 00000074463 14737241666 020256 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache Tutorial: Dynamic Content with CGI - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Apache Tutorial: Dynamic Content with CGI</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/howto/cgi.html" title="English"> en </a> |
<a href="../es/howto/cgi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuring">Configuring Apache to permit CGI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#writing">Writing a CGI program</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">But it's still not working!</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#behindscenes">What's going on behind the scenes?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#libraries">CGI modules/libraries</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinfo">For more information</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="intro" id="intro">Introduction</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_alias.html">mod_alias</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_cgid.html">mod_cgid</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li></ul></td></tr></table>
<p>The CGI (Common Gateway Interface) defines a way for a web
server to interact with external content-generating programs,
which are often referred to as CGI programs or CGI scripts. It
is a simple way to put dynamic content on
your web site, using whatever programming language you're most
familiar with. This document will be an introduction to setting
up CGI on your Apache web server, and getting started writing
CGI programs.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuring" id="configuring">Configuring Apache to permit CGI</a></h2>
<p>In order to get your CGI programs to work properly, you'll
need to have Apache configured to permit CGI execution. There
are several ways to do this.</p>
<div class="warning">Note: If Apache has been built with shared module
support you need to ensure that the module is loaded; in your
<code>httpd.conf</code> you need to make sure the
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>
directive has not been commented out. A correctly configured directive
may look like this:
<pre class="prettyprint lang-config">LoadModule cgid_module modules/mod_cgid.so</pre>
On Windows, or using a non-threaded MPM like prefork, A correctly
configured directive may look like this:
<pre class="prettyprint lang-config">LoadModule cgi_module modules/mod_cgi.so</pre>
</div>
<h3><a name="scriptalias" id="scriptalias">ScriptAlias</a></h3>
<p>The
<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
directive tells Apache that a particular directory is set
aside for CGI programs. Apache will assume that every file in
this directory is a CGI program, and will attempt to execute
it, when that particular resource is requested by a
client.</p>
<p>The <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
directive looks like:</p>
<pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"</pre>
<p>The example shown is from your default <code>httpd.conf</code>
configuration file, if you installed Apache in the default
location. The <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
directive is much like the <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> directive, which defines a URL prefix that
is to mapped to a particular directory. <code class="directive">Alias</code>
and <code class="directive">ScriptAlias</code> are usually used for
directories that are outside of the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> directory. The difference between
<code class="directive">Alias</code> and <code class="directive">ScriptAlias</code>
is that <code class="directive">ScriptAlias</code> has the added meaning
that everything under that URL prefix will be considered a CGI
program. So, the example above tells Apache that any request for a
resource beginning with <code>/cgi-bin/</code> should be served from
the directory <code>/usr/local/apache2/cgi-bin/</code>, and should be
treated as a CGI program.</p>
<p>For example, if the URL
<code>http://www.example.com/cgi-bin/test.pl</code>
is requested, Apache will attempt to execute the file
<code>/usr/local/apache2/cgi-bin/test.pl</code>
and return the output. Of course, the file will have to
exist, and be executable, and return output in a particular
way, or Apache will return an error message.</p>
<h3><a name="nonscriptalias" id="nonscriptalias">CGI outside of ScriptAlias directories</a></h3>
<p>CGI programs are often restricted to <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>'ed directories for security reasons.
In this way, administrators can tightly control who is allowed to
use CGI programs. However, if the proper security precautions are
taken, there is no reason why CGI programs cannot be run from
arbitrary directories. For example, you may wish to let users
have web content in their home directories with the
<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> directive.
If they want to have their own CGI programs, but don't have access to
the main <code>cgi-bin</code> directory, they will need to be able to
run CGI programs elsewhere.</p>
<p>There are two steps to allowing CGI execution in an arbitrary
directory. First, the <code>cgi-script</code> handler must be
activated using the <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> or <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> directive. Second,
<code>ExecCGI</code> must be specified in the <code class="directive"><a href="../mod/core.html#options">Options</a></code> directive.</p>
<h3><a name="options" id="options">Explicitly using Options to permit CGI execution</a></h3>
<p>You could explicitly use the <code class="directive"><a href="../mod/core.html#options">Options</a></code> directive, inside your main server configuration
file, to specify that CGI execution was permitted in a particular
directory:</p>
<pre class="prettyprint lang-config"><Directory "/usr/local/apache2/htdocs/somedir">
Options +ExecCGI
</Directory></pre>
<p>The above directive tells Apache to permit the execution
of CGI files. You will also need to tell the server what
files are CGI files. The following <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> directive tells the server to treat all
files with the <code>cgi</code> or <code>pl</code> extension as CGI
programs:</p>
<pre class="prettyprint lang-config">AddHandler cgi-script .cgi .pl</pre>
<h3><a name="htaccess" id="htaccess">.htaccess files</a></h3>
<p>The <a href="htaccess.html"><code>.htaccess</code> tutorial</a>
shows how to activate CGI programs if you do not have
access to <code>httpd.conf</code>.</p>
<h3><a name="userdir" id="userdir">User Directories</a></h3>
<p>To allow CGI program execution for any file ending in
<code>.cgi</code> in users' directories, you can use the
following configuration.</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html">
Options +ExecCGI
AddHandler cgi-script .cgi
</Directory></pre>
<p>If you wish designate a <code>cgi-bin</code> subdirectory of
a user's directory where everything will be treated as a CGI
program, you can use the following.</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html/cgi-bin">
Options ExecCGI
SetHandler cgi-script
</Directory></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="writing" id="writing">Writing a CGI program</a></h2>
<p>There are two main differences between ``regular''
programming, and CGI programming.</p>
<p>First, all output from your CGI program must be preceded by
a <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME-type</a> header. This is HTTP header that tells the client
what sort of content it is receiving. Most of the time, this
will look like:</p>
<div class="example"><p><code>
Content-type: text/html
</code></p></div>
<p>Secondly, your output needs to be in HTML, or some other
format that a browser will be able to display. Most of the
time, this will be HTML, but occasionally you might write a CGI
program that outputs a gif image, or other non-HTML
content.</p>
<p>Apart from those two things, writing a CGI program will look
a lot like any other program that you might write.</p>
<h3><a name="firstcgi" id="firstcgi">Your first CGI program</a></h3>
<p>The following is an example CGI program that prints one
line to your browser. Type in the following, save it to a
file called <code>first.pl</code>, and put it in your
<code>cgi-bin</code> directory.</p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl
print "Content-type: text/html\n\n";
print "Hello, World.";</pre>
<p>Even if you are not familiar with Perl, you should be able
to see what is happening here. The first line tells Apache
(or whatever shell you happen to be running under) that this
program can be executed by feeding the file to the
interpreter found at the location <code>/usr/bin/perl</code>.
The second line prints the content-type declaration we
talked about, followed by two carriage-return newline pairs.
This puts a blank line after the header, to indicate the end
of the HTTP headers, and the beginning of the body. The third
line prints the string "Hello, World.". And that's the end
of it.</p>
<p>If you open your favorite browser and tell it to get the
address</p>
<div class="example"><p><code>
http://www.example.com/cgi-bin/first.pl
</code></p></div>
<p>or wherever you put your file, you will see the one line
<code>Hello, World.</code> appear in your browser window.
It's not very exciting, but once you get that working, you'll
have a good chance of getting just about anything working.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot">But it's still not working!</a></h2>
<p>There are four basic things that you may see in your browser
when you try to access your CGI program from the web:</p>
<dl>
<dt>The output of your CGI program</dt>
<dd>Great! That means everything worked fine. If the output is correct,
but the browser is not processing it correctly, make sure you have the
correct <code>Content-Type</code> set in your CGI program.</dd>
<dt>The source code of your CGI program or a "POST Method Not
Allowed" message</dt>
<dd>That means that you have not properly configured Apache
to process your CGI program. Reread the section on
<a href="#configuring">configuring
Apache</a> and try to find what you missed.</dd>
<dt>A message starting with "Forbidden"</dt>
<dd>That means that there is a permissions problem. Check the
<a href="#errorlogs">Apache error log</a> and the section below on
<a href="#permissions">file permissions</a>.</dd>
<dt>A message saying "Internal Server Error"</dt>
<dd>If you check the
<a href="#errorlogs">Apache error log</a>, you will probably
find that it says "Premature end of
script headers", possibly along with an error message
generated by your CGI program. In this case, you will want to
check each of the below sections to see what might be
preventing your CGI program from emitting the proper HTTP
headers.</dd>
</dl>
<h3><a name="permissions" id="permissions">File permissions</a></h3>
<p>Remember that the server does not run as you. That is,
when the server starts up, it is running with the permissions
of an unprivileged user - usually <code>nobody</code>, or
<code>www</code> - and so it will need extra permissions to
execute files that are owned by you. Usually, the way to give
a file sufficient permissions to be executed by <code>nobody</code>
is to give everyone execute permission on the file:</p>
<div class="example"><p><code>
chmod a+x first.pl
</code></p></div>
<p>Also, if your program reads from, or writes to, any other
files, those files will need to have the correct permissions
to permit this.</p>
<h3><a name="pathinformation" id="pathinformation">Path information and environment</a></h3>
<p>When you run a program from your command line, you have
certain information that is passed to the shell without you
thinking about it. For example, you have a <code>PATH</code>,
which tells the shell where it can look for files that you
reference.</p>
<p>When a program runs through the web server as a CGI program,
it may not have the same <code>PATH</code>. Any programs that you
invoke in your CGI program (like <code>sendmail</code>, for
example) will need to be specified by a full path, so that the
shell can find them when it attempts to execute your CGI
program.</p>
<p>A common manifestation of this is the path to the script
interpreter (often <code>perl</code>) indicated in the first
line of your CGI program, which will look something like:</p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl</pre>
<p>Make sure that this is in fact the path to the
interpreter.</p>
<div class="warning">
When editing CGI scripts on Windows, end-of-line characters may be
appended to the interpreter path. Ensure that files are then
transferred to the server in ASCII mode. Failure to do so may
result in "Command not found" warnings from the OS, due to the
unrecognized end-of-line character being interpreted as a part of
the interpreter filename.
</div>
<h3><a name="missingenv" id="missingenv">Missing environment variables</a></h3>
<p>If your CGI program depends on non-standard <a href="#env">environment variables</a>, you will need to
assure that those variables are passed by Apache.</p>
<p>When you miss HTTP headers from the environment, make
sure they are formatted according to
<a href="http://tools.ietf.org/html/rfc2616">RFC 2616</a>,
section 4.2: Header names must start with a letter,
followed only by letters, numbers or hyphen. Any header
violating this rule will be dropped silently.</p>
<h3><a name="syntaxerrors" id="syntaxerrors">Program errors</a></h3>
<p>Most of the time when a CGI program fails, it's because of
a problem with the program itself. This is particularly true
once you get the hang of this CGI stuff, and no longer make
the above two mistakes. The first thing to do is to make
sure that your program runs from the command line before
testing it via the web server. For example, try:</p>
<div class="example"><p><code>
cd /usr/local/apache2/cgi-bin<br />
./first.pl
</code></p></div>
<p>(Do not call the <code>perl</code> interpreter. The shell
and Apache should find the interpreter using the <a href="#pathinformation">path information</a> on the first line of
the script.)</p>
<p>The first thing you see written by your program should be
a set of HTTP headers, including the <code>Content-Type</code>,
followed by a blank line. If you see anything else, Apache will
return the <code>Premature end of script headers</code> error if
you try to run it through the server. See <a href="#writing">Writing a CGI program</a> above for more
details.</p>
<h3><a name="errorlogs" id="errorlogs">Error logs</a></h3>
<p>The error logs are your friend. Anything that goes wrong
generates message in the error log. You should always look
there first. If the place where you are hosting your web site
does not permit you access to the error log, you should
probably host your site somewhere else. Learn to read the
error logs, and you'll find that almost all of your problems
are quickly identified, and quickly solved.</p>
<h3><a name="suexec" id="suexec">Suexec</a></h3>
<p>The <a href="../suexec.html">suexec</a> support program
allows CGI programs to be run under different user permissions,
depending on which virtual host or user home directory they are
located in. Suexec has very strict permission checking, and any
failure in that checking will result in your CGI programs
failing with <code>Premature end of script headers</code>.</p>
<p>To check if you are using suexec, run <code>apachectl
-V</code> and check for the location of <code>SUEXEC_BIN</code>.
If Apache finds an <code class="program"><a href="../programs/suexec.html">suexec</a></code> binary there on startup,
suexec will be activated.</p>
<p>Unless you fully understand suexec, you should not be using it.
To disable suexec, simply remove (or rename) the <code class="program"><a href="../programs/suexec.html">suexec</a></code>
binary pointed to by <code>SUEXEC_BIN</code> and then restart the
server. If, after reading about <a href="../suexec.html">suexec</a>,
you still wish to use it, then run <code>suexec -V</code> to find
the location of the suexec log file, and use that log file to
find what policy you are violating.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="behindscenes" id="behindscenes">What's going on behind the scenes?</a></h2>
<p>As you become more advanced in CGI programming, it will
become useful to understand more about what's happening behind
the scenes. Specifically, how the browser and server
communicate with one another. Because although it's all very
well to write a program that prints "Hello, World.", it's not
particularly useful.</p>
<h3><a name="env" id="env">Environment variables</a></h3>
<p>Environment variables are values that float around you as
you use your computer. They are useful things like your path
(where the computer searches for the actual file
implementing a command when you type it), your username, your
terminal type, and so on. For a full list of your normal,
every day environment variables, type
<code>env</code> at a command prompt.</p>
<p>During the CGI transaction, the server and the browser
also set environment variables, so that they can communicate
with one another. These are things like the browser type
(Netscape, IE, Lynx), the server type (Apache, IIS, WebSite),
the name of the CGI program that is being run, and so on.</p>
<p>These variables are available to the CGI programmer, and
are half of the story of the client-server communication. The
complete list of required variables is at
<a href="http://www.ietf.org/rfc/rfc3875">Common Gateway
Interface RFC</a>.</p>
<p>This simple Perl CGI program will display all of the
environment variables that are being passed around. Two
similar programs are included in the
<code>cgi-bin</code>
directory of the Apache distribution. Note that some
variables are required, while others are optional, so you may
see some variables listed that were not in the official list.
In addition, Apache provides many different ways for you to
<a href="../env.html">add your own environment variables</a>
to the basic ones provided by default.</p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl
use strict;
use warnings;
print "Content-type: text/html\n\n";
foreach my $key (keys %ENV) {
print "$key --> $ENV{$key}<br>";
}</pre>
<h3><a name="stdin" id="stdin">STDIN and STDOUT</a></h3>
<p>Other communication between the server and the client
happens over standard input (<code>STDIN</code>) and standard
output (<code>STDOUT</code>). In normal everyday context,
<code>STDIN</code> means the keyboard, or a file that a
program is given to act on, and <code>STDOUT</code>
usually means the console or screen.</p>
<p>When you <code>POST</code> a web form to a CGI program,
the data in that form is bundled up into a special format
and gets delivered to your CGI program over <code>STDIN</code>.
The program then can process that data as though it was
coming in from the keyboard, or from a file</p>
<p>The "special format" is very simple. A field name and
its value are joined together with an equals (=) sign, and
pairs of values are joined together with an ampersand
(&). Inconvenient characters like spaces, ampersands, and
equals signs, are converted into their hex equivalent so that
they don't gum up the works. The whole data string might look
something like:</p>
<div class="example"><p><code>
name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey
</code></p></div>
<p>You'll sometimes also see this type of string appended to
a URL. When that is done, the server puts that string
into the environment variable called
<code>QUERY_STRING</code>. That's called a <code>GET</code>
request. Your HTML form specifies whether a <code>GET</code>
or a <code>POST</code> is used to deliver the data, by setting the
<code>METHOD</code> attribute in the <code>FORM</code> tag.</p>
<p>Your program is then responsible for splitting that string
up into useful information. Fortunately, there are libraries
and modules available to help you process this data, as well
as handle other of the aspects of your CGI program.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="libraries" id="libraries">CGI modules/libraries</a></h2>
<p>When you write CGI programs, you should consider using a
code library, or module, to do most of the grunt work for you.
This leads to fewer errors, and faster development.</p>
<p>If you're writing CGI programs in Perl, modules are
available on <a href="http://www.cpan.org/">CPAN</a>. The most
popular module for this purpose is <code>CGI.pm</code>. You might
also consider <code>CGI::Lite</code>, which implements a minimal
set of functionality, which is all you need in most programs.</p>
<p>If you're writing CGI programs in C, there are a variety of
options. One of these is the <code>CGIC</code> library, from
<a href="https://web.mit.edu/wwwdev/www/cgic.html">https://web.mit.edu/wwwdev/www/cgic.html</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinfo" id="moreinfo">For more information</a></h2>
<p>The current CGI specification is available in the
<a href="http://www.ietf.org/rfc/rfc3875">Common Gateway
Interface RFC</a>.</p>
<p>When you post a question about a CGI problem that you're
having, whether to a mailing list, or to a newsgroup, make sure
you provide enough information about what happened, what you
expected to happen, and how what actually happened was
different, what server you're running, what language your CGI
program was in, and, if possible, the offending code. This will
make finding your problem much simpler.</p>
<p>Note that questions about CGI problems should <strong>never</strong>
be posted to the Apache bug database unless you are sure you
have found a problem in the Apache source code.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/howto/cgi.html" title="English"> en </a> |
<a href="../es/howto/cgi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/cgi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/public_html.html.en 0000664 0001751 0001751 00000032541 14737241666 022005 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Per-user web directories - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Per-user web directories</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/howto/public_html.html" title="English"> en </a> |
<a href="../es/howto/public_html.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>On systems with multiple users, each user can be permitted to have a
web site in their home directory using the <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> directive. Visitors
to a URL <code>http://example.com/~username/</code> will get content
out of the home directory of the user "<code>username</code>", out of
the subdirectory specified by the <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> directive.</p>
<p>Note that, by default, access to these directories is <strong>not</strong>
enabled. You can enable access when using <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> by uncommenting the line:</p>
<pre class="prettyprint lang-config">#Include conf/extra/httpd-userdir.conf</pre>
<p>in the default config file <code>conf/httpd.conf</code>, and adapting the <code>httpd-userdir.conf</code>
file as necessary, or by including the appropriate directives in a
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> block
within the main config file.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Per-user web directories</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#userdir">Setting the file path with UserDir</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirect">Redirecting to external URLs</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#enable">Restricting what users are permitted to use this
feature</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">Enabling a cgi directory for each user</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#htaccess">Allowing users to alter configuration</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../urlmapping.html">Mapping URLs to the Filesystem</a></li><li><a href="#comments_section">Comments</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="related" id="related">Per-user web directories</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></li><li><code class="directive"><a href="../mod/core.html#directorymatch">DirectoryMatch</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="userdir" id="userdir">Setting the file path with UserDir</a></h2>
<p>The <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
directive specifies a directory out of which per-user
content is loaded. This directive may take several different forms.</p>
<p>If a path is given which does not start with a leading slash, it is
assumed to be a directory path relative to the home directory of the
specified user. Given this configuration:</p>
<pre class="prettyprint lang-config">UserDir public_html</pre>
<p>the URL <code>http://example.com/~rbowen/file.html</code> will be
translated to the file path
<code>/home/rbowen/public_html/file.html</code></p>
<p>If a path is given starting with a slash, a directory path will be
constructed using that path, plus the username specified. Given this
configuration:</p>
<pre class="prettyprint lang-config">UserDir /var/html</pre>
<p>the URL <code>http://example.com/~rbowen/file.html</code> will be
translated to the file path <code>/var/html/rbowen/file.html</code></p>
<p>If a path is provided which contains an asterisk (*), a path is used
in which the asterisk is replaced with the username. Given this
configuration:</p>
<pre class="prettyprint lang-config">UserDir /var/www/*/docs</pre>
<p>the URL <code>http://example.com/~rbowen/file.html</code> will be
translated to the file path
<code>/var/www/rbowen/docs/file.html</code></p>
<p>Multiple directories or directory paths can also be set.</p>
<pre class="prettyprint lang-config">UserDir public_html /var/html</pre>
<p>For the URL <code>http://example.com/~rbowen/file.html</code>,
Apache will search for <code>~rbowen</code>. If it isn't found,
Apache will search for <code>rbowen</code> in <code>/var/html</code>. If
found, the above URL will then be translated to the file path
<code>/var/html/rbowen/file.html</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirect" id="redirect">Redirecting to external URLs</a></h2>
<p>The <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> directive can be
used to redirect user directory requests to external URLs.</p>
<pre class="prettyprint lang-config">UserDir http://example.org/users/*/</pre>
<p>The above example will redirect a request for
<code>http://example.com/~bob/abc.html</code> to
<code>http://example.org/users/bob/abc.html</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="enable" id="enable">Restricting what users are permitted to use this
feature</a></h2>
<p>Using the syntax shown in the UserDir documentation, you can restrict
what users are permitted to use this functionality:</p>
<pre class="prettyprint lang-config">UserDir disabled root jro fish</pre>
<p>The configuration above will enable the feature for all users
except for those listed in the <code>disabled</code> statement.
You can, likewise, disable the feature for all but a few users by
using a configuration like the following:</p>
<pre class="prettyprint lang-config">UserDir disabled
UserDir enabled rbowen krietz</pre>
<p>See <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
documentation for additional examples.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">Enabling a cgi directory for each user</a></h2>
<p>In order to give each user their own cgi-bin directory, you can use
a <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
directive to make a particular subdirectory of a user's home directory
cgi-enabled.</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html/cgi-bin/">
Options ExecCGI
SetHandler cgi-script
</Directory></pre>
<p>Then, presuming that <code>UserDir</code> is set to
<code>public_html</code>, a cgi program <code>example.cgi</code>
could be loaded from that directory as:</p>
<div class="example"><p><code>
http://example.com/~rbowen/cgi-bin/example.cgi
</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="htaccess" id="htaccess">Allowing users to alter configuration</a></h2>
<p>If you want to allows users to modify the server configuration in
their web space, they will need to use <code>.htaccess</code> files to
make these changes. Ensure that you have set <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> to a
value sufficient for the directives that you want to permit the users
to modify. See the <a href="htaccess.html">.htaccess tutorial</a> for
additional details on how this works.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/howto/public_html.html" title="English"> en </a> |
<a href="../es/howto/public_html.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/public_html.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/access.html.es 0000664 0001751 0001751 00000035257 14743132254 020745 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Control de Acceso - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="../images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a> > <a href="./">How-To / Tutoriales</a></div><div id="page-content"><div id="preamble"><h1>Control de Acceso</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/access.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/access.html" title="Español"> es </a> |
<a href="../fr/howto/access.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>El control de acceso, hace referencia a todos los medios que proporcionan
una forma de controlar el acceso a cualquier recurso. Esta parte está
separada de <a href="auth.html">autenticación y autorización</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Módulos y Directivas relacionados</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#host">Control de Acceso por host</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#env">Control de acceso por variables arbitrarias.</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewrite">Control de acceso con mod_rewrite</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinformation">Más información</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</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="related" id="related">Módulos y Directivas relacionados</a></h2>
<p>El control de acceso puede efectuarse mediante diferentes módulos. Los
más importantes de éstos son <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> y
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>. También se habla en este documento de
el control de acceso usando el módulo <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="host" id="host">Control de Acceso por host</a></h2>
<p>
Si lo que se quiere es restringir algunas zonas del sitio web, basándonos
en la dirección del visitante, esto puede ser realizado de manera
fácil con el módulo <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>.
</p>
<p>La directiva <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
proporciona una variedad de diferentes maneras de permitir o denegar el acceso a los recursos. Además puede ser usada junto con las directivas:<code class="directive"><a href="../mod/mod_authz_core.html#requireall">RequireAll</a></code>, <code class="directive"><a href="../mod/mod_authz_core.html#requireany">RequireAny</a></code>, y <code class="directive"><a href="../mod/mod_authz_core.html#requirenone">RequireNone</a></code>, estos requerimientos pueden
ser combinados de forma compleja y arbitraria, para cumplir cualquiera que
sean tus políticas de acceso.</p>
<div class="warning"><p>
Las directivas <code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code>, y
<code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>,
proporcionadas por <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code>, están obsoletas y
serán quitadas en futuras versiones. Deberá evitar su uso, y también
los tutoriales desactualizaos que recomienden su uso.
</p></div>
<p>El uso de estas directivas es:</p>
<pre class="prettyprint lang-config">Require host <var>address</var> <br />
Require ip <var>ip.address</var>
</pre>
<p>En la primera línea, <var>address</var> es el FQDN de un nombre de
dominio (o un nombre parcial del dominio); puede proporcionar múltiples
direcciones o nombres de dominio, si se desea.
</p>
<p>En la segunda línea, <var>ip.address</var> es la dirección IP, una
dirección IP parcial, una red con su máscara, o una especificación red/nnn
CIDR. Pueden usarse tanto IPV4 como IPV6.</p>
<p>Consulte también <a href="../mod/mod_authz_host.html#requiredirectives">la
documentación de mod_authz_host </a> para otros ejemplos de esta sintaxis.
</p>
<p>Puede ser insertado <code>not</code> para negar un requisito en particular.
Note que, ya que <code>not</code> es una negación de un valor, no puede ser
usado por si solo para permitir o denegar una petición, como <em>not true</em>
que no contituye ser <em>false</em>. En consecuencia, para denegar una
visita usando una negación, el bloque debe tener un elemento que se evalúa como
verdadero o falso. Por ejemplo, si tienes a alguien espameandote tu tablón de
mensajes, y tu quieres evitar que entren o dejarlos fuera, puedes realizar
lo siguiente:
</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not ip 10.252.46.165
</RequireAll></pre>
<p>Los visitantes que vengan desde la IP que se configura (<code>10.252.46.165</code>)
no tendrán acceso al contenido que cubre esta directiva. Si en cambio, lo que se
tiene es el nombre de la máquina, en vez de la IP, podrás usar:</p>
<pre class="prettyprint lang-config">Require not host <var>host.example.com</var>
</pre>
<p>Y, Si lo que se quiere es bloquear el acceso desde dominio especifico,
podrás especificar parte de una dirección o nombre de dominio:</p>
<pre class="prettyprint lang-config">Require not ip 192.168.205
Require not host phishers.example.com moreidiots.example
Require not host gov</pre>
<p>Uso de las directivas <code class="directive"><a href="../mod/mod_authz_core.html#requireall">RequireAll</a></code>, <code class="directive"><a href="../mod/mod_authz_core.html#requireany">RequireAny</a></code>, y <code class="directive"><a href="../mod/mod_authz_core.html#requirenone">RequireNone</a></code> pueden ser usadas
para forzar requisitos más complejos.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="env" id="env">Control de acceso por variables arbitrarias.</a></h2>
<p>Haciendo el uso de <code class="directive"><a href="../mod/core.html#if"><If></a></code>,
puedes permitir o denegar el acceso basado en variables de entrono arbitrarias
o en los valores de las cabeceras de las peticiones. Por ejemplo para denegar
el acceso basándonos en el "user-agent" (tipo de navegador así como Sistema Operativo)
puede que hagamos lo siguiente:
</p>
<pre class="prettyprint lang-config"><If "%{HTTP_USER_AGENT} == 'BadBot'">
Require all denied
</If></pre>
<p>Usando la sintaxis de <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
<code>expr</code> , esto también puede ser escrito de la siguiente forma:
</p>
<pre class="prettyprint lang-config">Require expr %{HTTP_USER_AGENT} != 'BadBot'</pre>
<div class="note"><h3>Advertencia:</h3>
<p>El control de acceso por <code>User-Agent</code> es una técnica poco fiable,
ya que la cabecera de <code>User-Agent</code> puede ser modificada y establecerse
al antojo del usuario.</p>
</div>
<p>Vea también la página de <a href="../expr.html">expresiones</a>
para una mayor aclaración de que sintaxis tienen las expresiones y que
variables están disponibles.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">Control de acceso con mod_rewrite</a></h2>
<p>El flag <code>[F]</code> de <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> causa una respuesta 403 Forbidden
para ser enviada. USando esto, podrá denegar el acceso a recursos basándose
en criterio arbitrario.</p>
<p>Por ejemplo, si lo que desea es bloquear un recurso entre las 8pm y las
7am, podrá hacerlo usando <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>:</p>
<pre class="prettyprint lang-config">RewriteEngine On
RewriteCond "%{TIME_HOUR}" ">=20" [OR]
RewriteCond "%{TIME_HOUR}" "<07"
RewriteRule "^/fridge" "-" [F]</pre>
<p>Esto devolverá una respuesta de error 403 Forbidden para cualquier petición
después de las 8pm y antes de las 7am. Esta técnica puede ser usada para cualquier
criterio que desee usar. También puede redireccionar, o incluso reescribir estas
peticiones, si se prefiere ese enfoque.
</p>
<p>La directiva <code class="directive"><a href="../mod/core.html#if"><If></a></code>,
añadida en la 2.4, sustituye muchas cosas que <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
tradicionalmente solía hacer, y deberá comprobar estas antes de recurrir a
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinformation" id="moreinformation">Más información</a></h2>
<p>El <a href="../expr.html">motor de expresiones</a> le da una gran
capacidad de poder para hacer una gran variedad de cosas basadas en
las variables arbitrarias del servidor, y debe consultar este
documento para más detalles.</p>
<p>También, deberá leer la documentación de <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>
para ejemplos de combinaciones de múltiples requisitos de acceso y especificar
cómo interactúan.
</p>
<p>Vea también los howtos de <a href="auth.html">Authenticación y Autorización</a>
</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/access.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/access.html" title="Español"> es </a> |
<a href="../fr/howto/access.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/access.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/auth.html.ko.euc-kr 0000664 0001751 0001751 00000051073 14743132254 021626 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>(Authentication), Ѻο(Authorization),
(Access Control) - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>(Authentication), Ѻο(Authorization),
(Access Control)</h1>
<div class="toplang">
<p><span> : </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/auth.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>(authentication) ڽ ϴ
Ȯϴ ̴. Ѻο(authorization)
Ȥ ϴ ϴ ̴.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related"> þ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#introduction">Ұ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#theprerequisites">⺻ </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#gettingitworking">⺻ ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#lettingmorethanonepersonin"> 鿩</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#possibleproblems"> ִ </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#whatotherneatstuffcanido">ٸ Ѱ?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinformation"> </a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="related" id="related"> þ</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li><li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_host.html#deny">Deny</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/core.html#require">Require</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="introduction" id="introduction">Ұ</a></h2>
<p> Ʈ ִ Ҽ 鸸 ̰ų
̵鸸 , ۿ ϴ Ͽ
ϴ ִ.</p>
<p> Ʈ Ϻθ ȣϱ
ϴ "ǥ" ٷ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="theprerequisites" id="theprerequisites">⺻ </a></h2>
<p> ۿ ٷ þ ּ(Ϲ
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
)̳ 丮 (<code>.htaccess</code> )
Ѵ.</p>
<p><code>.htaccess</code> Ϸ Ͽ ִ
þ ϵ ؾ Ѵ. ̸
丮 Ͽ þ ִ ϴ
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> þ
Ѵ.</p>
<p>⼭ ٷ ,
<code>AllowOverride</code> þ ʿϴ.</p>
<div class="example"><p><code>
AllowOverride AuthConfig
</code></p></div>
<p>Ȥ þ ּϿ ´ٸ, Ͽ
־ Ѵ.</p>
<p> ȣ ִ ˱ 丮
˾ƾѴ. ʰ,
ڼ ̴.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="gettingitworking" id="gettingitworking">⺻ ϱ</a></h2>
<p> 丮 ȣ ȣϴ ⺻
Ѵ.</p>
<p> ȣ Ѵ.
־ Ѵ. ٸ ȣ ٿε
ϰϱ ؼ. ,
<code>/usr/local/apache/htdocs</code> ִٸ ȣ()
<code>/usr/local/apache/passwd</code> д.</p>
<p>ġ Ե <a href="../programs/htpasswd.html">htpasswd</a> Ͽ
ȣ . α ġ ġ
<code>bin</code> 丮 ִ.
ԷѴ.</p>
<div class="example"><p><code>
htpasswd -c /usr/local/apache/passwd/passwords rbowen
</code></p></div>
<p><code>htpasswd</code> ȣ , Ȯ
ȣ ٽ Է϶ ûѴ.</p>
<div class="example"><p><code>
# htpasswd -c /usr/local/apache/passwd/passwords rbowen<br />
New password: mypassword<br />
Re-type new password: mypassword<br />
Adding password for user rbowen
</code></p></div>
<p> <code>htpasswd</code> ο ٸ
ü θ Էؾ Ѵ. ϴ
<code>/usr/local/apache/bin/htpasswd</code>
ִ.</p>
<p> ȣ ûϵ ϰ,
˷ Ѵ.
<code>httpd.conf</code> ϰų <code>.htaccess</code>
Ͽ Ѵ. ,
<code>/usr/local/apache/htdocs/secret</code> 丮
ȣϷ, Ʒ þ
<code>/usr/local/apache/htdocs/secret/.htaccess</code> ̳
<code>httpd.conf</code> <Directory
/usr/local/apache/apache/htdocs/secret> ǿ
Ѵ.</p>
<div class="example"><p><code>
AuthType Basic<br />
AuthName "Restricted Files"<br />
AuthUserFile /usr/local/apache/passwd/passwords<br />
Require user rbowen
</code></p></div>
<p>þ ϳ 캸. <code class="directive"><a href="../mod/core.html#authtype">AuthType</a></code> þ ڸ
Ѵ. Ϲ <code>Basic</code>,
<code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> Ѵ. Basic
ȣ ȣȭ ʰ .
Ƿ ڷḦ ȣϱ ϸ ȵȴ.
ġ <code>AuthType Digest</code> Ѵ.
<code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> ϸ, ſ
ϴ. ֱ Ŭ̾Ʈ鸸 Digest Ѵٰ
Ѵ.</p>
<p><code class="directive"><a href="../mod/core.html#authname">AuthName</a></code> þ
<dfn>(realm)</dfn> Ѵ.
ΰ Ѵ. ù° Ŭ̾Ʈ
ȣ ȭâ ش. ι° Ͽ
Ŭ̾Ʈ Ư ȣ Ѵ.</p>
<p> , ϴ Ŭ̾Ʈ <code>"Restricted Files"</code>
Ͽٸ, Ŭ̾Ʈ ڵ
<code>"Restricted Files"</code> ǥõ
ȣ õѴ.
ϸ ڰ ȣ Է ʾƵ ȴ.
Ȼ Ŭ̾Ʈ ȣƮ ٸ
ȣ .</p>
<p><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
þ 츮 <code>htpasswd</code> ȣ
θ Ѵ. ڰ ٸ û Ź ڸ
ϱ Ϲ ˻ϴµ ð
ɸ ִ. ġ Ÿ̽ Ͽ
ִ. <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code> þ
Ѵ. <a href="../programs/dbmmanage.html">dbmmanage</a>
α Ͽ ȣ ٷ. <a href="http://modules.apache.org/">ġ
Ÿ̽</a> ٸ ϴ ڰ
ִ.</p>
<p> <code class="directive"><a href="../mod/core.html#require">Require</a></code>
þ Ư ִ ڸ Ͽ
Ѻο Ѵ. <code>require</code> þ
ϴ پ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="lettingmorethanonepersonin" id="lettingmorethanonepersonin"> 鿩</a></h2>
<p> þ 丮 (ڸ <code>rbowen</code>)
鿩. κ 鿩
̴. <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
.</p>
<p> 鿩 ʹٸ 쿡
ڵ ִ ˷ִ ʿϴ.
ſ Ͽ, ƹ γ ִ. ϳ
.</p>
<div class="example"><p><code>
GroupName: rbowen dpitts sungo rshersey
</code></p></div>
<p>׳ ̴.</p>
<p> ȣϿ ڸ ߰Ϸ ԷѴ</p>
<div class="example"><p><code>
htpasswd /usr/local/apache/passwd/passwords dpitts
</code></p></div>
<p> , ʰ Ͽ ڸ
߰Ѵ. (<code>-c</code> ɼ ȣ ).</p>
<p> <code>.htaccess</code> Ѵ.</p>
<div class="example"><p><code>
AuthType Basic<br />
AuthName "By Invitation Only"<br />
AuthUserFile /usr/local/apache/passwd/passwords<br />
AuthGroupFile /usr/local/apache/passwd/groups<br />
Require group GroupName
</code></p></div>
<p> <code>GroupName</code> 쿡 ϸ
<code>password</code> Ͽ ִ ڰ ùٸ
ȣ Էϸ Ѵ.</p>
<p> Ϲ ڸ 鿩 ٸ ִ.
ʿ þ ϱ⸸ ϸ ȴ.</p>
<div class="example"><p><code>
Require valid-user
</code></p></div>
<p><code>Require user rbowen</code> þ ϸ
ȣϿ ִ ùٸ ȣ Էϱ⸸ ϸ
Ѵ. 캰 ٸ ȣ Ͽ
ȿ ִ. ġ ΰ(ȣϰ
) ƴ Ѱ(ȣ) ˻ϸ ȴٴ
̴. ȣ ؾ ϰ, <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> þ
Ȯ ȣ ؾ ϴ ̴.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="possibleproblems" id="possibleproblems"> ִ </a></h2>
<p>Basic û ڸ
ȣ ȮѴ. ħ
( ȣ ȣϴ 丮 ִ ) ִ
ٽ ȮѴ. ϵ ӵ .
ȣ ڸ ã
ϱ ȣ ũⰡ Ŀ .
۾ û Ѵ.</p>
<p> ȣϿ ִ ڼ
Ѱ谡 ִ. Ѱ ϴ ɿ ٸ,
鰳 Ѵ´ٸ ٰ ϰ ٸ
ؾ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="whatotherneatstuffcanido" id="whatotherneatstuffcanido">ٸ Ѱ?</a></h2>
<p>ڸ ȣ ٰ ƴϴ.
ҿ ٸ ڸ 鿩
ִ.</p>
<p><code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code>
<code class="directive"><a href="../mod/mod_authz_host.html#deny">Deny</a></code> þ
û ǻ ȣƮ Ȥ ȣƮ ּҸ
ϰų źѴ. <code class="directive"><a href="../mod/mod_authz_host.html#order">Order</a></code> þ
þ Ͽ, ġ Ģ
˸.</p>
<p>̵ þ .</p>
<div class="example"><p><code>
Allow from <var>address</var>
</code></p></div>
<p>⼭ <var>address</var> IP ּ(Ȥ IP ּ Ϻ)
θ(Ȥ θ Ϻ)̴. Ѵٸ ּҳ
θ ִ.</p>
<p> , Խǿ ø ִٸ
ִ.</p>
<div class="example"><p><code>
Deny from 205.252.46.165
</code></p></div>
<p> ּҿ 湮ڴ þ ȣϴ
. IP ּ ǻ
ִ.</p>
<div class="example"><p><code>
Deny from <var>host.example.com</var>
</code></p></div>
<p>, ü ּҳ θ Ϻθ
Ѵ.</p>
<div class="example"><p><code>
Deny from <var>192.101.205</var><br />
Deny from <var>cyberthugs.com</var> <var>moreidiots.com</var><br />
Deny from ke
</code></p></div>
<p><code class="directive"><a href="../mod/mod_authz_host.html#order">Order</a></code>
<code class="directive"><a href="../mod/mod_authz_host.html#deny">Deny</a></code> <code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code> þ
Ͽ ϴ ִ.</p>
<div class="example"><p><code>
Order deny,allow<br />
Deny from all<br />
Allow from <var>dev.example.com</var>
</code></p></div>
<p><code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code>
þ ϸ, ش ȣƮ ڸ ϰ ű
߰ ϹǷ ϴ Ѵ.
Ư <em></em> ϱ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinformation" id="moreinformation"> </a></h2>
<p><code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> ϴ
ִ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/auth.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/auth.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/cgi.html.ko.euc-kr 0000664 0001751 0001751 00000063473 14743132254 021436 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ġ 丮: CGI - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>ġ 丮: CGI </h1>
<div class="toplang">
<p><span> : </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/cgi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/cgi.html" title="Korean"> ko </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">Ұ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuring">CGI ϵ ġ ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#writing">CGI α ۼϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot"> ʾƿ!</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#behindscenes">ڿ °?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#libraries">CGI /̺귯</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinfo"> ...</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="intro" id="intro">Ұ</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li></ul></td></tr></table>
<p>CGI (Common Gateway Interface) CGI α
Ȥ CGI ũƮ θ, ( ) ܺ
α ϴ Ѵ. Ʈ
ϰ ̴. ġ
CGI ϴ Ұϰ, CGI α
ۼغ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuring" id="configuring">CGI ϵ ġ ϱ</a></h2>
<p>CGI α ùٷ Ϸ CGI ϵ
ġ ؾ Ѵ. ϴ .</p>
<h3><a name="scriptalias" id="scriptalias">ScriptAlias</a></h3>
<p><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
þ ϸ ġ Ư 丮 CGI α
д. ġ 丮 ִ CGI
α̶ Ͽ Ŭ̾Ʈ ڿ ûϸ ڿ
Ϸ õѴ.</p>
<p><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
þ Ѵ.</p>
<div class="example"><p><code>
ScriptAlias /cgi-bin/ /usr/local/apache2/cgi-bin/
</code></p></div>
<p> ġ ⺻ ҿ ġ
<code>httpd.conf</code> Ͽ ִ ̴. <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> þ <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> þ URL
պκ Ư 丮 Ѵ.
<code class="directive">Alias</code>
<code class="directive">ScriptAlias</code> <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> 丮 ۿ ִ
丮 Ѵ. <code class="directive">Alias</code>
<code class="directive">ScriptAlias</code>
<code class="directive">ScriptAlias</code> ߰ URL պκ
ϴ CGI α ϴ ̴.
ġ <code>/cgi-bin/</code>
ϴ ڿ ûϸ
<code>/usr/local/apache2/cgi-bin/</code> 丮
ãƼ CGI α ó϶ ˸.</p>
<p> , URL
<code>http://www.example.com/cgi-bin/test.pl</code>
ûϸ ġ
<code>/usr/local/apache2/cgi-bin/test.pl</code>
Ͽ ȯѴ. ϰ డϸ
ε ؾ Ѵ. ġ
.</p>
<h3><a name="nonscriptalias" id="nonscriptalias">ScriptAlias 丮 ۿ ִ CGI</a></h3>
<p> Ȼ CGI α <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> 丮
Ѵ. ڴ CGI α
ִ ִ. ġ
ߴٸ ƹ 丮 CGI α
. , <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> þ Ͽ
ڰ ڽ Ȩ丮 츦
. ڰ ڽ CGI α ϰ
<code>cgi-bin</code> 丮 ٱ ٸ, ٸ
CGI α ϰ ̴.</p>
<p>ƹ 丮 CGI Ϸ
ʿϴ. , <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> þ Ͽ
<code>cgi-script</code> ڵ鷯 ۵ؾ Ѵ. ι°,
<code class="directive"><a href="../mod/core.html#options">Options</a></code> þ
<code>ExecCGI</code> ؾ Ѵ.</p>
<h3><a name="options" id="options">Options Ͽ CGI ϱ</a></h3>
<p> ּϿ <code class="directive"><a href="../mod/core.html#options">Options</a></code> þ Ͽ Ư
丮 CGI ִ.</p>
<div class="example"><p><code>
<Directory /usr/local/apache2/htdocs/somedir><br />
<span class="indent">
Options +ExecCGI<br />
</span>
</Directory>
</code></p></div>
<p> þ ġ CGI Ѵ.
CGI ˷ Ѵ. <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> þ
Ȯڰ <code>cgi</code> <code>pl</code>
CGI α̶ ˸.</p>
<div class="example"><p><code>
AddHandler cgi-script .cgi .pl
</code></p></div>
<h3><a name="htaccess" id="htaccess">.htaccess </a></h3>
<p><a href="htaccess.html"><code>.htaccess</code> 丮</a>
<code>httpd.conf</code> ٱ 쿡 CGI α
ִ ˷ش.</p>
<h3><a name="userdir" id="userdir"> 丮</a></h3>
<p>Ʒ ϸ 丮 <code>.cgi</code>
CGI α Ѵ.</p>
<div class="example"><p><code>
<Directory /home/*/public_html><br />
<span class="indent">
Options +ExecCGI<br />
AddHandler cgi-script .cgi<br />
</span>
</Directory>
</code></p></div>
<p> ϸ 丮 <code>cgi-bin</code>
丮 ִ CGI α νѴ.</p>
<div class="example"><p><code>
<Directory /home/*/public_html/cgi-bin><br />
<span class="indent">
Options ExecCGI<br />
SetHandler cgi-script<br />
</span>
</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="writing" id="writing">CGI α ۼϱ</a></h2>
<p>``Ϲ'' αְ CGI α ̿ ΰ
ֵ ִ.</p>
<p>ù° ̴ CGI α ٸ ϱ
MIME-type ؾ Ѵٴ ̴. HTTP
Ŭ̾Ʈ Ŭ̾Ʈ ްԵ ̸ ˸.
.</p>
<div class="example"><p><code>
Content-type: text/html
</code></p></div>
<p>ι° ̴ HTML Ȥ ִ
ؾ Ѵٴ ̴. κ HTML ,
gif HTML ƴ ϴ CGI
α ۼϴ 쵵 ִ.</p>
<p>ΰ ϰ CGI α ۼ ̹
ٸ α ſ ϴ.</p>
<h3><a name="firstcgi" id="firstcgi">ó CGI α</a></h3>
<p> CGI α .
״ <code>first.pl</code>̶ Ͽ ϰ,
<code>cgi-bin</code> 丮 Ѵ.</p>
<div class="example"><p><code>
#!/usr/bin/perl<br />
print "Content-type: text/html\n\n";<br />
print "Hello, World.";
</code></p></div>
<p>Perl ͼ ʴ Ͼ
ִ. ù° ġ(Ȥ ϴ )
<code>/usr/bin/perl</code> ġ ִ Ͽ
α ϶ ˸. ι°
content-type ϰ carriage-return ٹٲ
ι Ѵ. ڿ HTTP ϴ
, Ѵ. ° "Hello, World."
ڿ Ѵ. ̰ ̴.</p>
<p> ϰ ּҸ ԷѴ</p>
<div class="example"><p><code>
http://www.example.com/cgi-bin/first.pl
</code></p></div>
<p> Ҹ Էϸ, â <code>Hello, World.</code>
δ. е , ѹ ϴ
ٸ õ ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot"> ʾƿ!</a></h2>
<p> CGI α Ҷ ִ
⺻ װ.</p>
<dl>
<dt>CGI α </dt>
<dd>! Ѵٴ ̴. Ȯ
ùٷ ó Ѵٸ, CGI α
ùٸ <code>Content-Type</code> Ͽ ȮѴ.</dd>
<dt>CGI α ҽڵ Ȥ "POST Method Not Allowed"
</dt>
<dd>CGI α ϵ ġ
ʾҴٴ ̴. <a href="#configuring">ġ ϱ</a>
ٽ а κ ִ ãƺ.</dd>
<dt>"Forbidden" ϴ </dt>
<dd> ִٴ ̴. <a href="#errorlogs">ġ
α</a> Ʒ <a href="#permissions">ϱ</a>
Ȯ϶.</dd>
<dt>"Internal Server Error" </dt>
<dd><a href="#errorlogs">ġ α</a> Ƹ
CGI α Բ "Premature end of
script headers" ̴. Ʒ ϳ
ȮϿ CGI α HTTP
ߴ ˾ƺ.</dd>
</dl>
<h3><a name="permissions" id="permissions">ϱ</a></h3>
<p> Ű ϶.
, ϸ Ư (
<code>nobody</code> <code>www</code>) Ѵ.
Ϸ ʿϴ.
Ͽ <code>nobody</code> ϱ
ֱ ο ش.</p>
<div class="example"><p><code>
chmod a+x first.pl
</code></p></div>
<p>, α ٸ аų ٸ Ͽ
ʿϴ.</p>
<h3><a name="pathinformation" id="pathinformation"> ȯ</a></h3>
<p> α ϸ ڵ
ȴ. , <code>PATH</code>
ã Ҹ ˷ش.</p>
<p> α CGI α Ҷ
<code>PATH</code> ٸ ִ. ( ,
<code>sendmail</code> ) CGI α ȿ ϴ
ɾ η ؾ ɾ ã
ִ.</p>
<p> CGI α ù° ٿ
ũƮ ( <code>perl</code>) ο
Ѵ.</p>
<div class="example"><p><code>
#!/usr/bin/perl
</code></p></div>
<p> ȮѴ.</p>
<p>, CGI α ٸ <a href="#env">ȯ溯</a>
Ѵٸ ġ α ؾ
Ѵ.</p>
<h3><a name="syntaxerrors" id="syntaxerrors">α </a></h3>
<p>CGI α ϴ κ α ü
̴. Ư ΰ Ǽ ʾҰ
ִٸ . ϱ
α غ. ,
Ѵ.</p>
<div class="example"><p><code>
cd /usr/local/apache2/cgi-bin<br />
./first.pl
</code></p></div>
<p>(<code>perl</code> .
ġ ũƮ ù° ٿ ִ <a href="#pathinformation"> </a> Ͽ
ãƾ Ѵ.)</p>
<p>α <code>Content-Type</code>
HTTP ϰ ؾ Ѵ. ٸ
Ѵٸ ġ <code>Premature
end of script headers</code> ȯѴ. ڼ
<a href="#writing">CGI α ۼϱ</a> ϶.</p>
<h3><a name="errorlogs" id="errorlogs"> α</a></h3>
<p> α״ ̴. ߸Ǹ α
. α Ѵ. Ʈ
ȣϴ α ϰ Ѵٸ, Ƹ
ٸ ü ˾ƺ Ѵ. α ,
κ ľϿ ذ ִ.</p>
<h3><a name="suexec" id="suexec">Suexec</a></h3>
<p><a href="../suexec.html">suexec</a> α
ϸ ȣƮ Ȥ 丮 ִ
CGI α ٸ ִ.
Suexec ſ ϰ ˻ϸ, ˻縦 ϳ
ϸ CGI α ʰ <code>Premature
end of script headers</code> ȯѴ.</p>
<p>suexec ϰ ִ ˷ <code>apachectl -V</code>
Ͽ <code>SUEXEC_BIN</code> ġ ȮѴ. ġ
Ҷ ҿ suexec ߰ϸ, suexec
ִ.</p>
<p>suexec ߴٸ ؼ ȵȴ.
suexec <code>SUEXEC_BIN</code> ġ
ִ <code>suexec</code> (Ȥ ϸ
ٲٰ) ϸ ȴ. <a href="../suexec.html">suexec</a>
ϰ ʹٸ, <code>suexec -V</code> Ͽ suexec
α ġ ˾Ƴ αϿ Ģ
ִ ã´.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="behindscenes" id="behindscenes">ڿ °?</a></h2>
<p>CGI αֿ ͼ ڿ ϸ
ȴ. ü ϴ
ϴ ̴. "Hello, World." ϴ
α ۼ ̷ α
̴.</p>
<h3><a name="env" id="env">ȯ溯</a></h3>
<p>ȯ溯 ǻ ϴ
ٴϴ ̴. ȯ溯 path (ǻͰ Է
ɾ شϴ ã ), ڸ, ̳
. Ϲ ȯ溯
Ʈ <code>env</code> ԷѴ.</p>
<p>CGI Ҷ ȯ溯
ȯѴ. (Netscape, IE,
Lynx), (ġ, IIS, WebSite), ϴ CGI
α ִ.</p>
<p>CGI αӴ ̷ ְ,
ȯ溯 Ŭ̾Ʈ- ſ Ϻκ Ѵ.
ü ʼ <a href="http://hoohoo.ncsa.uiuc.edu/cgi/env.html">http://hoohoo.ncsa.uiuc.edu/cgi/env.html</a> ִ.</p>
<p>Ʒ Perl CGI α ڽſ
ȯ溯 ش. ġ <code>cgi-bin</code>
丮 ̿ α ΰ ִ.
ʼ̰ ̴. Ͽ
δ. , ġ ⺻ ϴ ȯ溯
ܿ <a href="../env.html"> ȯ溯
߰ ִ</a>.</p>
<div class="example"><p><code>
#!/usr/bin/perl<br />
print "Content-type: text/html\n\n";<br />
foreach $key (keys %ENV) {<br />
<span class="indent">
print "$key --> $ENV{$key}<br>";<br />
</span>
}
</code></p></div>
<h3><a name="stdin" id="stdin">STDIN STDOUT</a></h3>
<p>, Ŭ̾Ʈ ǥԷ(<code>STDIN</code>)
ǥ(<code>STDOUT</code>) Ѵ. ϻ
<code>STDIN</code> Ű峪 α óϴ
Ÿ, <code>STDOUT</code> ܼ̳ ȭ Ѵ.</p>
<p>CGI α (form) <code>POST</code>ϸ
Ŀ Է ڷḦ Ư CGI α
<code>STDIN</code> Ѵ. α Ű峪
Ͽ ڷḦ óϵ ڷḦ ó ִ.</p>
<p>"Ư " ſ ϴ. ̸ ȣ(=)
ϰ, ̸ ֵ ۻ(&)
Ѵ. , ۻ, ȣ ڿ ڴ
ȥ ʵ 16 ȯѴ. ڷ ڿ
.</p>
<div class="example"><p><code>
name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey
</code></p></div>
<p> URL ڿ ̷ ڿ ȴ.
ڿ <code>QUERY_STRING</code>̶ ȯ溯 Ѵ.
̸ <code>GET</code> û̶ Ѵ. <code>FORM</code>
± <code>METHOD</code> Ӽ Ͽ HTML (form)
ڷḦ <code>GET</code> <code>POST</code> Ѵ.</p>
<p> α ̷ ڿ ɰ
Ѵ. ̷ ڷ ó CGI α ٸ
Ǵ ̺귯 ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="libraries" id="libraries">CGI /̺귯</a></h2>
<p>CGI α ۼҶ ۾ ִ ڵ
̺귯 Ȥ غ Ѵ. ̷
ϸ װ ٰ α ִ.</p>
<p>Perl CGI α ۼѴٸ <a href="http://www.cpan.org/">CPAN</a> ã
ִ. CGI ߿ θ Ǵ
<code>CGI.pm</code>̴. κ α ּ
<code>CGI::Lite</code> ִ.</p>
<p>C CGI α ۼѴٸ .
ϳ <a href="http://www.boutell.com/cgic/">http://www.boutell.com/cgic/</a>
ִ <code>CGIC</code> ̺귯.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinfo" id="moreinfo"> ...</a></h2>
<p> ſ CGI ִ. <a href="news:comp.infosystems.www.authoring.cgi">comp.infosystems.www.authoring.cgi</a>
CGI ִ. HTML Writers Guild -servers
ϸƮ ã Ǹ Ҵ. <a href="http://www.hwg.org/lists/hwg-servers/">http://www.hwg.org/lists/hwg-servers/</a>
ִ.</p>
<p> CGI α ۿ
CGI Ծ о . <a href="http://hoohoo.ncsa.uiuc.edu/cgi/interface.html">NCSA</a>
ְ, ʾ <a href="http://web.golux.com/coar/cgi/">Common Gateway Interface
RFC Ʈ</a> ִ.</p>
<p>ϸƮ 쿡 ݰ ִ CGI
Ҷ ,
ٸ, ϴ , CGI α ۼ
, ϸ ش ڵ带 ڼ . ذå
ã .</p>
<p>ġ ҽڵ尡 ߸Ǿٰ Ȯ ʴ CGI
ġ ͺ̽ ø <strong></strong>
ȵȴ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/cgi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/cgi.html" title="Korean"> ko </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/cgi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/auth.html.es 0000664 0001751 0001751 00000126127 14743132254 020442 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Autenticación y Autorización - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="../images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a> > <a href="./">How-To / Tutoriales</a></div><div id="page-content"><div id="preamble"><h1>Autenticación y Autorización</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/auth.html" title="Español"> es </a> |
<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Esta traducción podría estar
obsoleta. Consulte la versión en inglés de la
documentación para comprobar si se han producido cambios
recientemente.</div>
<p>Autenticación es cualquier proceso por el cuál se verifica que uno es
quien dice ser. Autorización es cualquier proceso en el cuál cualquiera
está permitido a estar donde se quiera, o tener información la cuál se
quiera tener.
</p>
<p>Para información de control de acceso de forma genérica visite<a href="access.html">How to de Control de Acceso</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Módulos y Directivas Relacionados</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introducción</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#theprerequisites">Los Prerequisitos</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#gettingitworking">Conseguir que funcione</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#lettingmorethanonepersonin">Dejar que más de una persona
entre</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#possibleproblems">Posibles Problemas</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#dbmdbd">Método alternativo de almacenamiento de las
contraseñas</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multprovider">Uso de múltiples proveedores</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#beyond">Más allá de la Autorización</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#socache">Cache de Autenticación</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinformation">Más información</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</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="related" id="related">Módulos y Directivas Relacionados</a></h2>
<p>Hay tres tipos de módulos involucrados en los procesos de la autenticación
y autorización. Normalmente deberás escoger al menos un módulo de cada grupo.</p>
<ul>
<li>Modos de Autenticación (consulte la directiva
<code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code> )
<ul>
<li><code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code></li>
<li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li>
</ul>
</li>
<li>Proveedor de Autenticación (consulte la directiva
<code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> y
<code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code>)
<ul>
<li><code class="module"><a href="../mod/mod_authn_anon.html">mod_authn_anon</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li>
<li><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code></li>
</ul>
</li>
<li>Autorización (consulte la directiva
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>)
<ul>
<li><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_dbd.html">mod_authz_dbd</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code></li>
</ul>
</li>
</ul>
<p>A parte de éstos módulos, también están
<code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> y
<code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>. Éstos módulos implementan las directivas
esenciales que son el centro de todos los módulos de autenticación.</p>
<p>El módulo <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> es tanto un proveedor de
autenticación como de autorización. El módulo
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> proporciona autorización y control de acceso
basado en el nombre del Host, la dirección IP o características de la propia
petición, pero no es parte del sistema proveedor de
autenticación. Para tener compatibilidad inversa con el mod_access,
hay un nuevo modulo llamado <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code>.</p>
<p>También puedes mirar el how-to de <a href="access.html">Control de Acceso </a>, donde se plantean varias formas del control de acceso al servidor.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="introduction" id="introduction">Introducción</a></h2>
<p>Si se tiene información en nuestra página web que sea información
sensible o pensada para un grupo reducido de usuarios/personas,
las técnicas que se describen en este manual, le servirán
de ayuda para asegurarse de que las personas que ven esas páginas sean
las personas que uno quiere.</p>
<p>Este artículo cubre la parte "estándar" de cómo proteger partes de un
sitio web que muchos usarán.</p>
<div class="note"><h3>Nota:</h3>
<p>Si de verdad es necesario que tus datos estén en un sitio seguro,
considera usar <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> como método de autenticación adicional a cualquier forma de autenticación.</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="theprerequisites" id="theprerequisites">Los Prerequisitos</a></h2>
<p>Las directivas que se usan en este artículo necesitaran ponerse ya sea
en el fichero de configuración principal del servidor ( típicamente en
la sección
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> de httpd.conf ), o
en cada uno de los ficheros de configuraciones del propio directorio
(los archivos <code>.htaccess</code>).</p>
<p>Si planea usar los ficheros <code>.htaccess</code> , necesitarás
tener en la configuración global del servidor, una configuración que permita
poner directivas de autenticación en estos ficheros. Esto se hace con la
directiva <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>, la cual especifica
que directivas, en su caso, pueden ser puestas en cada fichero de configuración
por directorio.</p>
<p>Ya que estamos hablando aquí de autenticación, necesitarás una directiva
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> como la siguiente:
</p>
<pre class="prettyprint lang-config">AllowOverride AuthConfig</pre>
<p>O, si solo se van a poner las directivas directamente en la configuración
principal del servidor, deberás tener, claro está, permisos de escritura
en el archivo. </p>
<p>Y necesitarás saber un poco de como está estructurado el árbol de
directorios de tu servidor, para poder saber donde se encuentran algunos
archivos. Esto no debería ser una tarea difícil, aún así intentaremos
dejarlo claro llegado el momento de comentar dicho aspecto.</p>
<p>También deberás de asegurarte de que los módulos
<code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> y <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>
han sido incorporados, o añadidos a la hora de compilar en tu binario httpd o
cargados mediante el archivo de configuración <code>httpd.conf</code>. Estos
dos módulos proporcionan directivas básicas y funcionalidades que son críticas
para la configuración y uso de autenticación y autorización en el servidor web.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="gettingitworking" id="gettingitworking">Conseguir que funcione</a></h2>
<p>Aquí está lo básico de cómo proteger con contraseña un directorio en tu
servidor.</p>
<p>Primero, necesitarás crear un fichero de contraseña. Dependiendo de que
proveedor de autenticación se haya elegido, se hará de una forma u otra. Para empezar,
usaremos un fichero de contraseña de tipo texto.</p>
<p>Este fichero deberá estar en un sitio que no se pueda tener acceso desde
la web. Esto también implica que nadie pueda descargarse el fichero de
contraseñas. Por ejemplo, si tus documentos están guardados fuera de
<code>/usr/local/apache/htdocs</code>, querrás poner tu archivo de contraseñas en
<code>/usr/local/apache/passwd</code>.</p>
<p>Para crear el fichero de contraseñas, usa la utilidad
<code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> que viene con Apache. Esta herramienta se
encuentra en el directorio <code>/bin</code> en donde sea que se ha
instalado el Apache. Si ha instalado Apache desde un paquete de terceros,
puede ser que se encuentre en su ruta de ejecución.</p>
<p>Para crear el fichero, escribiremos:</p>
<div class="example"><p><code>
htpasswd -c /usr/local/apache/passwd/passwords rbowen
</code></p></div>
<p><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> te preguntará por una contraseña, y después
te pedirá que la vuelvas a escribir para confirmarla:</p>
<div class="example"><p><code>
$ htpasswd -c /usr/local/apache/passwd/passwords rbowen<br />
New password: mypassword<br />
Re-type new password: mypassword<br />
Adding password for user rbowen
</code></p></div>
<p>Si <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> no está en tu variable de entorno "path" del
sistema, por supuesto deberás escribir la ruta absoluta del ejecutable para
poder hacer que se ejecute. En una instalación por defecto, está en:
<code>/usr/local/apache2/bin/htpasswd</code></p>
<p>Lo próximo que necesitas, será configurar el servidor para que pida una
contraseña y así decirle al servidor que usuarios están autorizados a acceder.
Puedes hacer esto ya sea editando el fichero <code>httpd.conf</code>
de configuración o usando in fichero <code>.htaccess</code>. Por ejemplo,
si quieres proteger el directorio
<code>/usr/local/apache/htdocs/secret</code>, puedes usar las siguientes
directivas, ya sea en el fichero <code>.htaccess</code> localizado en
following directives, either placed in the file
<code>/usr/local/apache/htdocs/secret/.htaccess</code>, o
en la configuración global del servidor <code>httpd.conf</code> dentro de la
sección <Directory
"/usr/local/apache/htdocs/secret"> , como se muestra a continuación:</p>
<pre class="prettyprint lang-config"><Directory "/usr/local/apache/htdocs/secret">
AuthType Basic
AuthName "Restricted Files"
# (Following line optional)
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
Require user rbowen
</Directory></pre>
<p>Vamos a explicar cada una de las directivas individualmente.
La directiva <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code> selecciona el método
que se usa para autenticar al usuario. El método más común es
<code>Basic</code>, y éste es el método que implementa
<code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>. Es muy importante ser consciente,
de que la autenticación básica, envía las contraseñas desde el cliente
al servidor sin cifrar.
Este método por tanto, no debe ser utilizado para proteger datos muy sensibles,
a no ser que, este método de autenticación básica, sea acompañado del módulo
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.
Apache soporta otro método más de autenticación que es del tipo
<code>AuthType Digest</code>. Este método, es implementado por el módulo <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> y con el se pretendía crear una autenticación más
segura. Este ya no es el caso, ya que la conexión deberá realizarse con <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> en su lugar.
</p>
<p>La directiva <code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code>
establece el <dfn>Realm</dfn> para ser usado en la autenticación. El
<dfn>Realm</dfn> tiene dos funciones principales.
La primera, el cliente presenta a menudo esta información al usuario como
parte del cuadro de diálogo de contraseña. La segunda, que es utilizado por
el cliente para determinar qué contraseña enviar a para una determinada zona
de autenticación.</p>
<p>Así que, por ejemple, una vez que el cliente se ha autenticado en el área de
los <code>"Ficheros Restringidos"</code>, entonces re-intentará automáticamente
la misma contraseña para cualquier área en el mismo servidor que es marcado
con el Realm de <code>"Ficheros Restringidos"</code>
Por lo tanto, puedes prevenir que a un usuario se le pida mas de una vez por su
contraseña, compartiendo así varias áreas restringidas el mismo Realm
Por supuesto, por razones de seguridad, el cliente pedirá siempre por una contraseña,
siempre y cuando el nombre del servidor cambie.
</p>
<p>La directiva <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> es,
en este caso, opcional, ya que <code>file</code> es el valor por defecto
para esta directiva. Deberás usar esta directiva si estas usando otro medio
diferente para la autenticación, como por ejemplo
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> o <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.</p>
<p>La directiva <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
establece el path al fichero de contraseñas que acabamos de crear con el
comando <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>. Si tiene un número muy grande de usuarios,
puede ser realmente lento el buscar el usuario en ese fichero de texto plano
para autenticar a los usuarios en cada petición.
Apache también tiene la habilidad de almacenar información de usuarios en
unos ficheros de rápido acceso a modo de base de datos.
El módulo <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> proporciona la directiva <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>. Estos ficheros pueden ser creados y
manipulados con el programa <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> y <code class="program"><a href="../programs/htdbm.html">htdbm</a></code>.
Muchos otros métodos de autenticación así como otras opciones, están disponibles en
módulos de terceros
<a href="http://modules.apache.org/">Base de datos de Módulos disponibles</a>.</p>
<p>Finalmente, la directiva <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
proporciona la parte del proceso de autorización estableciendo el o los
usuarios que se les está permitido acceder a una región del servidor.
En la próxima sección, discutiremos las diferentes vías de utilizar la
directiva <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="lettingmorethanonepersonin" id="lettingmorethanonepersonin">Dejar que más de una persona
entre</a></h2>
<p>Las directivas mencionadas arriba sólo permiten a una persona
(especialmente con un usuario que en ej ejemplo es <code>rbowen</code>)
en el directorio. En la mayoría de los casos, se querrá permitir el acceso
a más de una persona. Aquí es donde la directiva
<code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> entra en juego.</p>
<p>Si lo que se desea es permitir a más de una persona el acceso, necesitarás
crear un archivo de grupo que asocie los nombres de grupos con el de personas
para permitirles el acceso. El formato de este fichero es bastante sencillo,
y puedes crearlo con tu editor de texto favorito. El contenido del fichero
se parecerá a:</p>
<div class="example"><p><code>
GroupName: rbowen dpitts sungo rshersey
</code></p></div>
<p>Básicamente eso es la lista de miembros los cuales están en un mismo fichero
de grupo en una sola linea separados por espacios.</p>
<p>Para añadir un usuario a tu fichero de contraseñas existente teclee:</p>
<div class="example"><p><code>
htpasswd /usr/local/apache/passwd/passwords dpitts
</code></p></div>
<p>Te responderá lo mismo que anteriormente, pero se añadirá al fichero
existente en vez de crear uno nuevo. (Es decir el flag <code>-c</code> será
el que haga que se genere un nuevo
fichero de contraseñas).</p>
<p>Ahora, tendrá que modificar su fichero <code>.htaccess</code> para que sea
parecido a lo siguiente:</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "By Invitation Only"
# Optional line:
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthGroupFile "/usr/local/apache/passwd/groups"
Require group GroupName</pre>
<p>Ahora, cualquiera que esté listado en el grupo <code>GroupName</code>,
y tiene una entrada en el fichero de <code>contraseñas</code>, se les
permitirá el acceso, si introducen su contraseña correctamente.</p>
<p>Hay otra manera de dejar entrar a varios usuarios, que es menos específica.
En lugar de crear un archivo de grupo, sólo puede utilizar la siguiente
directiva:</p>
<pre class="prettyprint lang-config">Require valid-user</pre>
<p>Usando ésto en vez de la línea <code>Require user rbowen</code>
permitirá a cualquier persona acceder, la cuál aparece en el archivo de
contraseñas, y que introduzca correctamente su contraseña. Incluso puede
emular el comportamiento del grupo aquí, sólo manteniendo un fichero de
contraseñas independiente para cada grupo. La ventaja de este enfoque es
que Apache sólo tiene que comprobar un archivo, en lugar de dos. La desventaja
es que se tiene que mantener un montón de ficheros de contraseña de grupo, y
recuerde hacer referencia al fichero correcto en la directiva
<code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="possibleproblems" id="possibleproblems">Posibles Problemas</a></h2>
<p>Debido a la forma en que se especifica la autenticación básica,
su nombre de usuario y la contraseña deben ser verificados cada vez
que se solicita un documento desde el servidor. Esto es, incluso si
se vuelve a cargar la misma página, y para cada imagen de la página (si
provienen de un directorio protegido). Como se puede imaginar, esto
ralentiza las cosas un poco. La cantidad que ralentiza las cosas es
proporcional al tamaño del archivo de contraseñas, porque tiene que
abrir ese archivo, recorrer lista de usuarios hasta que llega a su nombre.
Y tiene que hacer esto cada vez que se carga una página.</p>
<p>Una consecuencia de esto, es que hay un limite práctico de cuantos
usuarios puedes introducir en el fichero de contraseñas. Este límite
variará dependiendo de la máquina en la que tengas el servidor,
pero puedes notar ralentizaciones en cuanto se metan cientos de entradas,
y por lo tanto consideraremos entonces otro método de autenticación
en ese momento.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="dbmdbd" id="dbmdbd">Método alternativo de almacenamiento de las
contraseñas</a></h2>
<p>Debido a que el almacenamiento de las contraseñas en texto plano tiene
el problema mencionado anteriormente, puede que se prefiera guardar
las contraseñas en otro lugar como por ejemplo una base de datos.
</p>
<p>Los módulos <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> y <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> son
dos módulos que hacen esto posible. En vez de seleccionar la directiva de fichero
<code><code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> </code>, en su lugar
se puede elegir <code>dbm</code> o <code>dbd</code> como formato de almacenamiento.</p>
<p>Para seleccionar los ficheros de tipo dbm en vez de texto plano, podremos hacer algo parecido a lo siguiente:</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider dbm
AuthDBMUserFile "/www/passwords/passwd.dbm"
Require valid-user
</Directory></pre>
<p>Hay otras opciones disponibles. Consulta la documentación de
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> para más detalles.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="multprovider" id="multprovider">Uso de múltiples proveedores</a></h2>
<p>Con la introducción de la nueva autenticación basada en un proveedor y
una arquitectura de autorización, ya no estaremos restringidos a un único
método de autenticación o autorización. De hecho, cualquier número de
los proveedores pueden ser mezclados y emparejados para ofrecerle
exactamente el esquema que se adapte a sus necesidades.
En el siguiente ejemplo, veremos como ambos proveedores tanto el fichero
como el LDAP son usados en la autenticación:
</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider file ldap
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthLDAPURL ldap://ldaphost/o=yourorg
Require valid-user
</Directory></pre>
<p>En este ejemplo el fichero, que actúa como proveedor, intentará autenticar
primero al usuario. Si no puede autenticar al usuario, el proveedor del LDAP
será llamado para que realice la autenticación.
Esto permite al ámbito de autenticación ser amplio, si su organización
implementa más de un tipo de almacén de autenticación.
Otros escenarios de autenticación y autorización pueden incluir la
mezcla de un tipo de autenticación con un tipo diferente de autorización.
Por ejemplo, autenticar contra un fichero de contraseñas pero autorizando
dicho acceso mediante el directorio del LDAP.</p>
<p>Así como múltiples métodos y proveedores de autenticación pueden
ser implementados, también pueden usarse múltiples formas de
autorización.
En este ejemplo ambos ficheros de autorización de grupo así como
autorización de grupo mediante LDAP va a ser usado:
</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthLDAPURL ldap://ldaphost/o=yourorg
AuthGroupFile "/usr/local/apache/passwd/groups"
Require group GroupName
Require ldap-group cn=mygroup,o=yourorg
</Directory></pre>
<p>Para llevar la autorización un poco más lejos, las directivas
de autorización de contenedores tales como
<code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code>
and
<code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code>
nos permiten aplicar una lógica de en qué orden se manejará la autorización dependiendo
de la configuración y controlada a través de ella.
Mire también <a href="../mod/mod_authz_core.html#logic">Contenedores de
Autorización</a> para ejemplos de cómo pueden ser aplicados.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="beyond" id="beyond">Más allá de la Autorización</a></h2>
<p>El modo en que la autorización puede ser aplicada es ahora mucho más flexible
que us solo chequeo contra un almacén de datos (contraseñas). Ordenando la
lógica y escoger la forma en que la autorización es realizada, ahora es posible
</p>
<h3><a name="authandororder" id="authandororder">Aplicando la lógica y ordenación</a></h3>
<p>Controlar el cómo y en qué orden se va a aplicar la autorización ha
sido un misterio en el pasado. En Apache 2.2 un proveedor del
mecanismo de autenticación fue introducido para disociar el proceso actual
de autenticación y soportar funcionalidad.
Uno de los beneficios secundarios fue que los proveedores de autenticación
podían ser configurados y llamados en un orden especifico que no dependieran
en el orden de carga del propio modulo.
Este proveedor de dicho mecanismo, ha sido introducido en la autorización
también. Lo que esto significa es que la directiva
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
no sólo especifica que método de autorización deberá ser usado, si no
también especifica el orden en que van a ser llamados. Múltiples
métodos de autorización son llamados en el mismo orden en que la directiva
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> aparece en la
configuración.
</p>
<p>
Con la Introducción del contenedor de directivas de autorización tales como
<code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code>
y
<code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code>,
La configuración también tiene control sobre cuándo se llaman a los métodos
de autorización y qué criterios determinan cuándo se concede el acceso.
Vease
<a href="../mod/mod_authz_core.html#logic">Contenedores de autorización</a>
Para un ejemplo de cómo pueden ser utilizados para expresar una lógica
más compleja de autorización.
</p>
<p>
Por defecto todas las directivas
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
son manejadas como si estuvieran contenidas en una directiva
<code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code>.
En otras palabras, Si alguno de los métodos de autorización
especificados tiene éxito, se concede la autorización.
</p>
<h3><a name="reqaccessctrl" id="reqaccessctrl">Uso de los proveedores de autorización para
el control de acceso</a></h3>
<p>
La autenticación de nombre de usuario y contraseña es sólo parte
de toda la historia que conlleva el proceso. Frecuentemente quiere
dar acceso a la gente en base a algo más que lo que son.
Algo como de donde vienen.
</p>
<p>
Los proveedores de autorización <code>all</code>,
<code>env</code>, <code>host</code> y <code>ip</code>
te permiten denegar o permitir el acceso basándose en otros
criterios como el nombre de la máquina o la IP de la máquina que
realiza la consulta para un documento.
</p>
<p>
El uso de estos proveedores se especifica a través de la directiva
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>.
La directiva registra los proveedores de autorización que serán llamados
durante la solicitud de la fase del proceso de autorización. Por ejemplo:
</p>
<pre class="prettyprint lang-config">Require ip <var>address</var>
</pre>
<p>
Donde <var>address</var> es una dirección IP (o una dirección IP parcial)
o bien:
</p>
<pre class="prettyprint lang-config">Require host <var>domain_name</var>
</pre>
<p>
Donde <var>domain_name</var> es el nombre completamente cualificado de un nombre
de dominio (FQDN) (o un nombre parcial del dominio);
puede proporcionar múltiples direcciones o nombres de dominio, si se desea.
</p>
<p>
Por ejemplo, si alguien envía spam a su tablón de mensajes y desea
mantenerlos alejados, podría hacer lo siguiente:</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not ip 10.252.46.165
</RequireAll></pre>
<p>
Visitantes que vengan desde esa IP no serán capaces de ver el contenido
que cubre esta directiva. Si, en cambio, lo que se tiene es el nombre de
la máquina, en vez de la dirección IP, podría usar:
</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not host host.example.com
</RequireAll></pre>
<p>
Y, si lo que se quiere es bloquear el acceso desde un determinado dominio
(bloquear el acceso desde el dominio entero), puede especificar parte
de la dirección o del propio dominio a bloquear:
</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not ip 192.168.205
Require not host phishers.example.com moreidiots.example
Require not host ke
</RequireAll></pre>
<p>
Usando <code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code>
con múltiples directivas <code class="directive"><a href="../mod/mod_authz_core.html#require"><Require></a></code>, cada una negada con un <code>not</code>,
Sólo permitirá el acceso, si todas las condiciones negadas son verdaderas.
En otras palabras, el acceso será bloqueado, si cualquiera de las condiciones
negadas fallara.
</p>
<h3><a name="filesystem" id="filesystem">Compatibilidad de Control de Acceso con versiones
anteriores </a></h3>
<p>
Uno de los efectos secundarios de adoptar proveedores basados en
mecanismos de autenticación es que las directivas anteriores
<code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> y
<code class="directive"><a href="../mod/mod_access_compat.html#satisfy">Satisfy</a></code> ya no son necesarias.
Sin embargo, para proporcionar compatibilidad con configuraciones antiguas,
estas directivas se han movido al módulo <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code>.
</p>
<div class="warning"><h3>Nota:</h3>
<p>
Las directivas proporcionadas por <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code>
han quedado obsoletas por <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>. Mezclar
directivas antiguas como
<code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code> ó
<code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> con las nuevas
como
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
es técnicamente posible pero desaconsejable. El módulo
<code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> se creó para soportar configuraciones
que contuvieran sólo directivas antiguas para facilitar la actualización
a la versión 2.4.
Por favor revise la documentación de
<a href="../upgrading.html">actualización</a> para más información al
respecto.
</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="socache" id="socache">Cache de Autenticación</a></h2>
<p>
Puede haber momentos en que la autenticación ponga una carga
inaceptable en el proveedor (de autenticación) o en tu red.
Esto suele afectar a los usuarios de <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>
(u otros proveedores de terceros/personalizados).
Para lidiar con este problema, HTTPD 2.3/2.4 introduce un nuevo proveedor
de caché <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code> para cachear las credenciales
y reducir la carga en el proveedor(es) original.
</p>
<p>
Esto puede ofrecer un aumento de rendimiento sustancial para algunos usuarios.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinformation" id="moreinformation">Más información</a></h2>
<p>
También debería leer la documentación para
<code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> y <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>
la cuál contiene más información de como funciona todo esto.
La directiva <code class="directive"><a href="../mod/mod_authn_core.html#authnprovideralias"><AuthnProviderAlias></a></code> puede también ayudar
a la hora de simplificar ciertas configuraciones de autenticación.
</p>
<p>
Los diferentes algoritmos de cifrado que están soportados por Apache
para la autenticación se explican en
<a href="../misc/password_encryptions.html">Cifrado de Contraseñas</a>.
</p>
<p>
Y tal vez quiera ojear la documentación de "how to"
<a href="access.html">Control de Acceso</a> donde se mencionan temas
relacionados.</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/auth.html" title="Español"> es </a> |
<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/auth.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/cgi.html.es 0000664 0001751 0001751 00000107276 14743132254 020247 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Tutorial de Apache: Contenido Dinámico con CGI - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="../images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a> > <a href="./">How-To / Tutoriales</a></div><div id="page-content"><div id="preamble"><h1>Tutorial de Apache: Contenido Dinámico con CGI</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/cgi.html" title="Español"> es </a> |
<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div>
<div class="outofdate">Esta traducción podría estar
obsoleta. Consulte la versión en inglés de la
documentación para comprobar si se han producido cambios
recientemente.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">Introducción</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuring">Configurando Apache para permitir CGI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#writing">Escribiendo un programa CGI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">¡Pero todavía no funciona!</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#behindscenes">¿Qué ocurre entre bastidores?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#libraries">Módulos/librerías CGI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinfo">Para más información</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</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="intro" id="intro">Introducción</a></h2>
<table class="related"><tr><th>Módulos Relacionados</th><th>Directivas Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_alias.html">mod_alias</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_cgid.html">mod_cgid</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li></ul></td></tr></table>
<p>CGI (Common Gateway Interface) es un método por el cual
un servidor web puede interactuar con programas externos de
generación de contenido, a ellos nos referimos comúnmente como
programas CGI o scripts CGI. Es el método más común y sencillo de
mostrar contenido dinámico en su sitio web. Este documento es una
introducción para configurar CGI en su servidor web Apache, y de
iniciación para escribir programas CGI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuring" id="configuring">Configurando Apache para permitir CGI</a></h2>
<p>Para conseguir que sus programas CGI funcionen correctamente,
deberá configurar Apache para que permita la ejecución de CGI. Hay
distintas formas de hacerlo.</p>
<div class="warning">Nota: Si Apache ha sido compilado con soporte
de módulos compartidos, necesitará que el módulo de CGI esté cargado;
en su <code>httpd.conf</code> tiene que asegurarse de que la directiva
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>
no ha sido comentada. Una directiva configurada correctamente sería así:
<pre class="prettyprint lang-config">LoadModule cgid_module modules/mod_cgid.so</pre>
En Windows, o si usa un mpm que no es multihilo, como prefork, una
directiva configurada correctamente podría definirse así:
<pre class="prettyprint lang-config">LoadModule cgi_module modules/mod_cgi.so</pre>
</div>
<h3><a name="scriptalias" id="scriptalias">ScriptAlias</a></h3>
<p>La directiva
<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
indica a Apache que un directorio se ha configurado específicamente
para programas CGI. Apache asumirá que cada fichero en este
directorio es un programa CGI, e intentará ejecutarlos cuando un
cliente solicita este recurso.</p>
<p>La directiva
<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> se puede
definir así:</p>
<pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"</pre>
<p>El ejemplo que se muestra es de un archivo de configuración
<code>httpd.conf</code> por defecto si usted instaló Apache
en la ubicación por defecto. La directiva
<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> es muy
parecida a la directiva <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>,
ésta define un prefijo de URL que se enlaza a un directorio
en particular. <code class="directive">Alias</code> y
<code class="directive">ScriptAlias</code> se usan generalmente para
directorios que se encuentran fuera del directorio
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. La diferencia
entre <code class="directive">Alias</code> y <code class="directive">ScriptAlias</code>
es que en <code class="directive">ScriptAlias</code> cualquier elemento
debajo de ese prefijo de URL será considerado un programa CGI. Así,
el ejemplo de más arriba le indica a Apache que
cualquier solicitud para un recurso que comience con
<code>/cgi-bin/</code> debería servirse desde el directorio
<code>/usr/local/apache2/cgi-bin/</code>, y debería tratarse como un
programa CGI.</p>
<p>Por ejemplo, si se solicita la URL
<code>http://www.example.com/cgi-bin/test.pl</code>,
Apache intentará ejecutar el archivo
<code>/usr/local/apache2/cgi-bin/test.pl</code> y dar
el resultado. Por supuesto el archivo debe existir y ser ejecutable,
y dar el resultado de una manera específica o Apache devolverá
un mensaje de error.</p>
<h3><a name="nonscriptalias" id="nonscriptalias">CGI fuera de directorios ScriptAlias</a></h3>
<p>Los programas CGI habitualmente se restringen a los directorios de
<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> por razones de
seguridad. De esta manera, los administradores pueden controlar de una
manera más segura quien puede ejecutar programas CGI. Aun así, si no
se toman suficientes precauciones, no hay ninguna razón por la que
programas CGI no se puedan ejecutar desde directorios seleccionados de
manera arbitraria. Por ejemplo, quizás quiera permitir que usuarios del
sistema tengan contenido web en sus directorios home con la directiva
<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>. Si quieren
tener sus propios programas CGI, pero no tienen acceso al directorio
principal <code>cgi-bin</code>, necesitarán ser capaces de
ejecutar sus scripts CGI en algún otro sitio.</p>
<p>Hay dos pasos a seguir para permitir la ejecución CGI en directorios
seleccionados de manera arbitraria. Primero, el handler
<code>cgi-script</code> debe estar activado usando la directiva
<code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> o la directiva
<code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>. Segundo, el parámetro
<code>ExecCGI</code> debe estar definido en la directiva
<code class="directive"><a href="../mod/core.html#options">Options</a></code>.</p>
<h3><a name="options" id="options">Usando Options de manera explícita para permitir ejecución de
CGI</a></h3>
<p>Puede usar la directiva
<code class="directive"><a href="../mod/core.html#options">Options</a></code>, en el archivo de
configuración principal para especificar que se permite la ejecución
de CGI en un directorio en particular:</p>
<pre class="prettyprint lang-config"><Directory "/usr/local/apache2/htdocs/somedir">
Options +ExecCGI
</Directory></pre>
<p>Esta directiva de aquí arriba le indica a Apache que debe
permitir la ejecución de archivos CGI. También necesitará indicarle
al servidor que los archivos son archivos CGI. La directiva
<code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> le indica al
servidor que debe tratar a todos los archivos con la extensión
<code>cgi</code> o <code>pl</code> como programas CGI:</p>
<pre class="prettyprint lang-config">AddHandler cgi-script .cgi .pl</pre>
<h3><a name="htaccess" id="htaccess">Ficheros .htaccess</a></h3>
<p>El <a href="htaccess.html">tutorial <code>.htaccess</code></a>
enseña como activar programas CGI si no tienes acceso a
<code>httpd.conf</code>.</p>
<h3><a name="userdir" id="userdir">Directorios de Usuario</a></h3>
<p>Para permitir la ejecución de programas CGI para cualquier
archivo que acabe en <code>.cgi</code> en directorios de usuario,
puedes usar la siguiente configuración:</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html">
Options +ExecCGI
AddHandler cgi-script .cgi
</Directory></pre>
<p>Si quiere designar un subdirectorio <code>cgi-bin</code> dentro
de un directorio de usuario en el que todos los ficheros serán
tratados como un programa CGI, puede usar lo siguiente:</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html/cgi-bin">
Options ExecCGI
SetHandler cgi-script
</Directory></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="writing" id="writing">Escribiendo un programa CGI</a></h2>
<p>Hay dos diferencias principales entre programación ``regular'' y
programación en CGI.</p>
<p>Primera, el resultado al completo de tu programa CGI debe estar
precedido de una cabecera <a class="glossarylink" href="../glossary.html#mime-type" title="ver glosario">MIME-type</a>. Esta
cabecera HTTP le indica al cliente que tipo de contenido está
recibiendo. La mayor parte de las veces, ésto será algo como:</p>
<div class="example"><p><code>
Content-type: text/html
</code></p></div>
<p>Segunda, el resultado debe estar en formato HTML, o cualquier
otro formato que su navegador sea capaz de mostrar. La mayor
parte de las veces, será HTML, pero otras escribirá un programa
CGI que devuelve una imagen gif, u otro contenido no-HTML.</p>
<p>Aparte de estas dos cosas, escribir un programa en CGI se
parecerá bastante a cualquier otro programa que vaya a escribir.
</p>
<h3><a name="firstcgi" id="firstcgi">Su primer programa CGI</a></h3>
<p>A continuación podrá ver un ejemplo de programa CGI que muestra
una línea de texto en su navegador. Escriba lo siguiente,
guárdelo en un archivo con el nombre <code>first.pl</code>, y
póngalo en su directorio <code>cgi-bin</code>.</p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl
print "Content-type: text/html\n\n";
print "Hola, Mundo.";</pre>
<p>Incluso si Perl no le resulta familiar, podrá ver lo que está
ocurriendo aquí. La primera línea le dice a Apache (o a
cualquier shell en la que se esté ejecutando) que este programa
puede ejecutarse con el intérprete en la ubicación
<code>/usr/bin/perl</code>. La segunda línea imprime la
declaración de Content-Type que mencionamos antes, seguida de
dos pares de retornos de carro. Esto pone una línea en blanco
después de la cabecera para indicar el final de las cabeceras
HTTP, y el comienzo del cuerpo del contenido. La tercera
imprime la cadena de caracteres "Hola, Mundo.". Y ese es el
final del programa.</p>
<p>Si lo abre con su navegador favorito y le dice que solicite la
dirección</p>
<div class="example"><p><code>
http://www.example.com/cgi-bin/first.pl
</code></p></div>
<p>o donde quiera que pusiera el archivo, verá una línea
<code>Hola, Mundo.</code> aparecerán la ventana del navegador. No es
muy emocionante, pero una vez que consiga que funcione podrá hacer
lo mismo con casi cualquier programa.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot">¡Pero todavía no funciona!</a></h2>
<p>Hay 4 cosas básicas que puede llegar a ver en su navegador cuando
intenta acceder a un programa CGI desde la web:</p>
<dl>
<dt>El resultado del programa CGI</dt>
<dd>¡Genial! Esto indica que todo funcionó correctamente. Si el
resultado es correcto, pero el navegador no lo procesa
correctamente, asegúrese de que tiene especificado
correctamente el <code>Content-Type</code> en su programa
CGI.</dd>
<dt>El código fuente de su programa CGI o un mensaje del tipo
"POST Method Not Allowed".</dt>
<dd>Eso significa que no ha configurado Apache de manera
apropiada para interpretar su programa CGI. Relea la sección
de <a href="#configuring">Configurando Apache</a> e intente
encontrar qué le falta.</dd>
<dt>Un mensaje que empieza con "Forbidden"</dt>
<dd>Eso significa que hay un problema de permisos. Compruebe el
<a href="#errorlogs">Log de Errores de Apache</a> y la
sección de más abajo de <a href="#permissions">Permisos de
Fichero</a>.</dd>
<dt>Un mensaje indicando "Internal Server Error"</dt>
<dd>Si comprueba el <a href="#errorlogs">Log de errores de
Apache</a>, probablemente encontrará que indica "Premature
end of script headers", posiblemente acompañado de otro
mensaje de error generado por su programa CGI. En este caso,
querrá comprobar cada una de las secciones de más adelante
para ver qué impide que su programa CGI genere las cabeceras
HTTP adecuadas.</dd>
</dl>
<h3><a name="permissions" id="permissions">Permisos de Fichero</a></h3>
<p>Recuerde que el servidor no se ejecuta con su usuario. Es decir,
cuando el servidor arranca, está funcionando con un usuario sin
privilegios, generalmente el usuario <code>nobody</code>, o
<code>www-data</code>, así que necesitará permisos extra para
ejecutar los archivos de los que usted es dueño. Generalmente,
el método para dar permisos suficientes para que se pueda
ejecutar con <code>nobody</code> es dar permisos de ejecución a
todo el mundo en el fichero:</p>
<div class="example"><p><code>
chmod a+x first.pl
</code></p></div>
<p>Además, si su programa lee desde o escribe a cualquier otro/s
archivo/s, esos archivos necesitarán tener los permisos correctos
para permitir esas acciones.</p>
<h3><a name="pathinformation" id="pathinformation">Información de Ruta y Entorno</a></h3>
<p>Cuando ejecuta un programa desde la línea de comandos, usted tiene
cierta información que se le pasa a la shell sin que usted se
percate de ello. Por ejemplo, usted tiene un <code>PATH</code>,
que le indica a la shell dónde debe buscar archivos a los que usted
hace referencia.</p>
<p>Cuando un programa se ejecuta a través del servidor web como un
programa CGI, puede que no tenga el mismo <code>PATH</code>.
Cualquier programa que invoque desde su programa CGI (como por
ejemplo <code>sendmail</code>) necesitará que se le indique la
ruta absoluta, así la shell puede encontrarlos cuando intenta
ejecutar su programa CGI.</p>
<p>Una manifestación común de esto es la ruta del intérprete del
script (a menudo <code>perl</code>) indicado en la primera línea
de su programa CGI, que parecerá algo como:</p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl</pre>
<p>Asegúrese de que éste es de hecho el path de su intérprete.</p>
<div class="warning">
Cuando edita scripts CGI en Windows, los caracteres de retorno de
carro podrían añadirse a la línea donde se especifica el intérprete.
Asegúrese de que los archivos se transfieren al servidor en modo
ASCII. Fallar en esto puede acabar con avisos del tipo "Command not
found" del Sistema Operativo, debido a que éste no reconoce los
caracteres de final de línea interpretados como parte del nombre
de fichero del intérprete.
</div>
<h3><a name="missingenv" id="missingenv">Faltan Variables de Entorno</a></h3>
<p>Si su programa CGI depende de <a href="#env">variables de entorno</a> no estándar, necesitará
asegurarse de que Apache pasa esas variables.</p>
<p>Cuando no encuentra ciertas cabeceras HTTP del entorno, asegúrese
de que están formateadas según el
<a href="http://tools.ietf.org/html/rfc2616">RFC 2616</a>,
sección 4.2: Nombres de Cabeceras deben empezar con una letra,
seguida solo de letras, números o guión. Cualquier cabecera
que no cumpla esta regla será ignorada de manera silenciosa.</p>
<h3><a name="syntaxerrors" id="syntaxerrors">Errores de Programa</a></h3>
<p>La mayor parte de las veces cuando un programa CGI falla, es por un
problema en el programa mismo. Esto ocurre generalmente cuando se
maneja bien con "esto del CGI", y ya no comete los dos errores
mencionados más arriba. Lo primero que hay que hacer es asegurarse
de que su programa se ejecuta correctamente en línea de comandos
antes de probarlo a través del servidor web. Por ejemplo,
intente:</p>
<div class="example"><p><code>
cd /usr/local/apache2/cgi-bin<br />
./first.pl
</code></p></div>
<p>(No llame al intérprete de <code>perl</code>. La consola y Apache
tienen que poder encontrar el intérprete usando línea
<a href="#pathinformation">línea de información</a> en la primera
línea del script.)</p>
<p>Lo primero que debe ver escrito por su programa es un conjunto de
cabeceras HTTP, incluyendo el <code>Content-Type</code>,
seguido de una línea en blanco. Si ve alguna otra cosa, Apache
devolverá el error <code>Premature end of script headers</code> si
intenta lanzar el script en el servidor web. Vea
<a href="#writing">Escribiendo un programa CGI</a> más arriba para
más detalle.</p>
<h3><a name="errorlogs" id="errorlogs">Log de Errores</a></h3>
<p>El log de errores es su amigo. Cualquier cosa que vaya mal generará
un mensaje en el log de errores. Debería mirar siempre ahí primero.
Si el lugar donde está alojando su sitio web no permite que acceda
al log de errores, probablemente debería alojarlo en otro sitio.
Aprenda a leer el log de errores y se dará cuenta de que enseguida
averiguará el motivo del error y lo solucionará rápidamente.</p>
<h3><a name="suexec" id="suexec">Suexec</a></h3>
<p>El programa de soporte <a href="../suexec.html">suexec</a> permite
que programas CGI se ejecuten con permisos de usuario distintos,
dependiendo del virtualhost o el directorio home donde se
encuentren. Suexec tiene una comprobación de permisos muy estricta,
y cualquier fallo en esa comprobación dará como resultado un error
con el mensaje <code>Premature end of script headers</code>.</p>
<p>Para comprobar si está usando Suexec, ejecute
<code>apachectl -V</code> y compruebe la ubicación de
<code>SUEXEC_BIN</code>. Si Apache encuentra un binario
<code class="program"><a href="../programs/suexec.html">suexec</a></code> al arrancar, suexec se activará.</p>
<p>A menos que comprenda suxec perfectamente, no debería usarlo.
Para desactivar suexec, basta con eliminar el binario
<code class="program"><a href="../programs/suexec.html">suexec</a></code> al que apunta <code>SUEXEC_BIN</code> y
reiniciar el servidor. Si después de leer sobre
<a href="../suexec.html">suexec</a> todavía quiere usarlo, entonces
ejecute <code>suexec -V</code> para encontrar la ubicación del
fichero log de suexec, y use ese log para encontrar que política no
está cumpliendo.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="behindscenes" id="behindscenes">¿Qué ocurre entre bastidores?</a></h2>
<p>En cuanto tenga conocimiento avanzado de programación CGI, le será
útil comprender más de lo que ocurre entre bastidores.
Específicamente, cómo el navegador y el servidor se comunican el uno
con el otro. Porque aunque esté muy bien escribir un programa que
diga "Hola, Mundo.", no tiene una gran utilidad.</p>
<h3><a name="env" id="env">Variables de Entorno</a></h3>
<p>Las variables de entorno son valores que están ahí cuando
usa el ordenador. Son cosas útiles como el path (donde su ordenador
busca el archivo específico que se lanza cuando usted escribe un
comando), su nombre de usuario, el tipo de terminal que usa, etc.
Para una lista completa de la variables de entorno normales que se
se usan en su día a día escriba <code>env</code> en la línea de
comandos.</p>
<p>Durante la transacción CGI, el servidor y el navegador también
configuran variables de entorno, y así pueden comunicarse entre
ellos. Cosas como el tipo de navegador (Netscape, IE, Lynx), el tipo
de servidor (Apache, IIS, WebSite), el nombre del programa CGI que
se está ejecutando, etc.</p>
<p>Estas variables están disponibles para el programador de CGI, y son
la mitad de la historia de la comunicación cliente-servidor. La
lista completa de las variables necesarias se encuentra en
<a href="http://www.ietf.org/rfc/rfc3875">el RFC de Common Gateway
Interface</a>.</p>
<p>Este sencillo programa CGI en Perl mostrará todas las variables
de entorno que se están pasando entre el cliente y el navegador. Dos
programas similares están incluidos en el directorio
<code>cgi-bin</code> de la distribución de Apache. Tenga en cuenta
que algunas variables son necesarias mientras que otras son
opcionales, así que es posible que vea algunas variables que no
están en la lista oficial. Adicionalmente, Apache aporta distintas
maneras diferentes para que pueda
<a href="../env.html">añadir sus variables de entorno</a> a las
básicas que se proveen por defecto.</p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl
use strict;
use warnings;
print "Content-type: text/html\n\n";
foreach my $key (keys %ENV) {
print "$key --> $ENV{$key}<br>";
}</pre>
<h3><a name="stdin" id="stdin">STDIN y STDOUT</a></h3>
<p>Otra comunicación entre el servidor y el cliente ocurre en la
entrada estándar (<code>STDIN</code>) y la salida estándar
(<code>STDOUT</code>). En el contexto normal de cada día,
<code>STDIN</code> es la entrada con el teclado, o un fichero que se
le da a un programa para que actúe sobre él, y <code>STDOUT</code>
generalmente es la consola o la pantalla.</p>
<p>Cuando hace <code>POST</code> con un formulario de web a un programa
CGI, los datos en ese formulario se empaquetan en un formato especial
que se entrega a su programa CGI en el <code>STDIN</code>.
Entonces el programa puede procesar la información como si le llegara
desde el teclado, o desde un fichero.</p>
<p>El "formato especial" es muy sencillo. Un nombre de campo y su
valor se asocian juntos con el signo igual (=), y pares de valores
se asocian juntos con el ampersand ó et en español (&).
Caracteres inconvenientes como los espacios, ampersands y signos de
igual, se convierten en su equivalente hexadecimal para no impidan
el funcionamiento correcto del programa. La cadena de datos al
completo será algo como:</p>
<div class="example"><p><code>
name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey
</code></p></div>
<p>A veces tendrá este tipo de cadena de caracteres al final de una
URL. Cuando esto ocurre, el servidor pone esa cadena en una variable
de entorno que se llama <code>QUERY_STRING</code>. Esto se llama
solicitud <code>GET</code>. Su formulario HTML especifica si se usa
un <code>GET</code> o un <code>POST</code> para entregar la
información, configurando el atributo <code>METHOD</code> en la
etiqueta <code>FORM</code>.</p>
<p>Su programa es el responsable de convertir esa cadena de
caracteres en información útil. Afortunadamente, hay librerías y
módulos disponibles que ayudan a procesar la información, así como a
gestionar los distintos aspectos de su programa CGI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="libraries" id="libraries">Módulos/librerías CGI</a></h2>
<p>Cuando escribe programas CGI, debería considerar usar una librería de
código, o módulo, para hacer todo el trabajo más arduo por usted.
Esto lleva a tener menos errores y un desarrollo de código más
rápido.</p>
<p>Si está escribiendo un programa CGI en Perl, existen módulos
disponibles en <a href="http://www.cpan.org/">CPAN</a>. El módulo más
conocido para este propósito es <code>CGI.pm</code>. Quizás quiera
considerar <code>CGI::Lite</code>, que implementa una funcionalidad
mínima, que es todo lo que se necesita en la mayoría de los programas.</p>
<p>Si está escribiendo programas CGI en C, hay varidad de opciones. Una
de estas es la librería <code>CGIC</code>, de
<a href="http://www.boutell.com/cgic/">http://www.boutell.com/cgic/</a>.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinfo" id="moreinfo">Para más información</a></h2>
<p>La especificación actual de CGI está disponible en el
<a href="http://www.ietf.org/rfc/rfc3875">RFC de Common Gateway
Interface</a>.</p>
<p>Cuando envíe una pregunta sobre un problema de CGI, o bien a una
lista de correo, o a un grupo de noticias, asegúrese de que facilita suficiente
información de lo que ha ocurrido, de lo que espera que ocurra, y de
lo que está ocurriendo en su lugar que es diferente, el servidor que
está ejecutando, en qué lenguaje CGI está hecho su programa, y si es
posible, el código que falla. Esto hará encontrar el problema mucho más
fácil.</p>
<p>Tenga en cuenta que las preguntas sobre problemas CGI
<strong>nunca</strong> deberían enviarse a la base de datos de bugs de
bugs de Apache a menos que esté seguro de haber encontrado un
problema en el código fuente de Apache.</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/cgi.html" title="Español"> es </a> |
<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/cgi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/htaccess.html.ja.utf8 0000664 0001751 0001751 00000070341 14743132254 022142 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache チュートリアル: .htaccess ファイル - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">How-To / チュートリアル</a></div><div id="page-content"><div id="preamble"><h1>Apache チュートリアル: .htaccess ファイル</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p><code>.htaccess</code> ファイルはディレクトリ毎に設定を変更する方法を
提供します。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">.htaccess ファイル</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what">.htaccess ファイルとは何か/その使い方</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#when">いつ .htaccess ファイルを使う(使わない)か。</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#how">ディレクティブの適用のされ方</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#auth">認証の例</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ssi">SSI の例</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">CGI の例</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">問題解決</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="related" id="related">.htaccess ファイル</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</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_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</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/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">.htaccess ファイルとは何か/その使い方</a></h2>
<p><code>.htaccess</code> ファイル (「分散設定ファイル」) は
ディレクトリ毎に設定を変更する方法を提供します。ディレクティブの
書かれたファイルをディレクトリに置くことで、そのディレクトリとその
サブディレクトリすべてにディレクティブを適用させることができます。</p>
<div class="note"><h3>注:</h3>
<p><code>.htaccess</code> ファイルを別の名前にしたい場合は、
<code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code> ディレクティブを
使って変更することができます。例えば、そのファイルを <code>.config</code>
という名前にしたい場合は、以下の設定をサーバ設定ファイルに入れることが
できます:</p>
<div class="example"><p><code>
AccessFileName .config
</code></p></div>
</div>
<p>一般に、<code>.htaccess</code> ファイルの構文は
<a href="../configuring.html#syntax">主設定ファイル</a>
と同じです。これらのファイルに書くことのできるディレクティブは <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> ディレクティブにより決まります。
このディレクティブは、<code>.htaccess</code> ファイルに
書かれたディレクティブの中で、、
どのディレクティブが適用されるかをカテゴリー単位で指定します。
<code>.htaccess</code> に書くことのできるディレクティブであれば、
説明文書には「上書き」という項目があり、.htaccess に書くことができるように
なるための <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> の値が指定されています。</p>
<p>例えば、<code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code> ディレクティブの説明を
見ると、<code>.htaccess</code> ファイルでの使用が許可されていることが
わかります。 (ディレクティブの概要の所にある「コンテキスト」と書かれている
行を見てください。) <a href="../mod/directive-dict.html#Context">上書き</a>と書かれている行には
<code>FileInfo</code> とあります。ですから、<code>.htaccess</code> 中の
このディレクティブが有効になるためには、少なくとも
<code>AllowOverride FileInfo</code> が設定されている必要があります。</p>
<div class="example"><h3>例:</h3><table>
<tr>
<td><a href="../mod/directive-dict.html#Context">コンテキスト:</a></td>
<td>サーバ設定ファイル,バーチャルホスト,ディレクトリ,.htaccess</td>
</tr>
<tr>
<td><a href="../mod/directive-dict.html#Override">上書き:</a></td>
<td>FileInfo</td>
</tr>
</table></div>
<p>あるディレクティブを <code>.htaccess</code> ファイルに書くことができるか
どうかわからないときは、そのディレクティブの説明を探して、".htaccess"
のための「コンテキスト」の行を調べてください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="when" id="when">いつ .htaccess ファイルを使う(使わない)か。</a></h2>
<p>一般的に、サーバの主設定ファイルにアクセスできない場合を除いて、
<code>.htaccess</code> ファイルの使用は極力避けてください。
世の中には、例えば、ユーザ認証は常に <code>.htaccess</code> ファイルで
行なわなければならない、という誤解が広まっていますが、まったくそんなことは
ありません。ユーザ認証の設定はサーバ主設定ファイルに書くことができ、
実際、その方がより良い設定方法です。</p>
<p><code>.htaccess</code> ファイルはコンテンツ提供者がディレクトリ毎の
設定を行ないたいけれど、サーバシステムの root アクセス権限を持っていない
という場合にのみ使うべきものです。サーバ管理者が頻繁に設定変更を行ないたくは
ない、というときには個々のユーザが <code>.htaccess</code> ファイルを使って
自分で設定の変更を行なうことを許可した方が良いときもあるでしょう。
これは特に、ISP が複数のユーザのサイトを一つのマシンでホストしていて、
各ユーザが設定の変更をできるようにしたいようなときにあてはまります。</p>
<p>しかし、普通は可能であれば <code>.htaccess</code> ファイルの使用は
避けてください。<code>.htaccess</code> ファイルに書こうと考えるような
すべての設定は、サーバの主設定ファイルの <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> セクションで同じように行なうことが
できます。</p>
<p><code>.htaccess</code> ファイルの使用を避ける理由は主に二つあります。</p>
<p>一つ目はサーバの性能の問題です。<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> ディレクティブが
<code>.htaccess</code> ファイルの設定を許可している場合は、Apache は
各ディレクトリで <code>.htaccess</code> ファイルを探します。
ですから、<code>.htaccess</code> ファイルを許可すると、実際に使用しているか
どうかに関わらず、性能の低下を招くことになります! また、<code>.htaccess</code>
ファイルは文書がリクエストされる度に読み込まれます。</p>
<p>さらに、Apache は適用すべきディレクティブを集めるために、すべての
上位のディレクトリの <code>.htaccess</code> ファイルを探す必要があることにも
注意してください。(<a href="#how">ディレクティブが適用される方法</a>を
参照してください。)ですから、<code>/www/htdocs/example</code> にある
ファイルがリクエストされたときは、Apache は以下のファイルを調べます。</p>
<div class="example"><p><code>
/.htaccess<br />
/www/.htaccess<br />
/www/htdocs/.htaccess<br />
/www/htdocs/example/.htaccess
</code></p></div>
<p>ですから、そのディレクトリのそれぞれのファイルへのアクセスに対して、
上の例のファイルがまったく存在しないときでも、追加のファイルシステムの
アクセスが行なわれることになります。(これは、<code>.htaccess</code> が
<code>/</code> に対して有効になっているときの場合で、普通はそうなって
いないことに注意してください。)</p>
<p>二つ目はセキュリティです。ユーザにサーバの設定を変更することを
許可することになりますので、あなた自身が管理できない変更をされる
恐れがあります。ユーザにこの特権を与えるのが良いのかどうか、十分
検討してください。また、ユーザに与える権限が必要なものよりも少なすぎると、
余分な技術サポート報告を受け取るようになる可能性が高いことにも
注意してください。確実に、ユーザにどの程度の権限を与えたか明確に告げるように
してください。<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> に
何を設定したかということと、関連する文書を示すことで、
後々の混乱をぐっと減らすことが
できます。</p>
<p>ところで、ディレクティブの書かれた <code>.htaccess</code> を
<code>/www/htdocs/example</code> に置くことと、同じディレクティブを
主サーバ設定の Directory セクション
<code><Directory /www/htdocs/example></code> に書くことは
完全に等価です:</p>
<p><code>/www/htdocs/example</code> の <code>.htaccess</code> ファイル:</p>
<div class="example"><h3><code>/www/htdocs/example</code> の .htaccess ファイルの
内容</h3><p><code>
AddType text/example .exm
</code></p></div>
<div class="example"><h3><code>httpd.conf のセクション</code>
file</h3><p><code>
<Directory /www/htdocs/example><br />
<span class="indent">
AddType text/example .exm<br />
</span>
</Directory>
</code></p></div>
<p>しかし、この設定はサーバ設定ファイルに書いた方がパフォーマンスの
低下が少なくなります。ファイルがリクエストされる度に
読み込まれる代わりに、Apache の起動時に 1 回だけ読み込めば
よくなるからです。</p>
<p><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> ディレクティブの
値を <code>none</code> に設定することで <code>.htaccess</code> ファイル
の使用を完全に無効にすることができます。</p>
<div class="example"><p><code>
AllowOverride None
</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="how" id="how">ディレクティブの適用のされ方</a></h2>
<p><code>.htaccess</code> ファイルの設定ディレクティブは <code>.htaccess</code>
ファイルの存在するディレクトリと、そのサブディレクトリすべてに適用されます。
しかし、上の階層のディレクトリにも <code>.htaccess</code> ファイルが
存在するかもしれないことを覚えておくことは大切です。ディレクティブは現れる
順番に適用されます。ですから、あるディレクトリの <code>.htaccess</code> は
ディレクトリツリーのより上の階層の <code>.htaccess</code> ファイルの
設定を上書きするかもしれません。そして、その <code>.htaccess</code> も
より上の階層で書かれたディレクティブを上書きしたり、主サーバ設定ファイル
そのものの設定を上書きしたりしているかもしれません。</p>
<p>例:</p>
<p>ディレクトリ <code>/www/htdocs/example1</code> に以下の内容の
<code>.htaccess</code> ファイルがあります:</p>
<div class="example"><p><code>
Options +ExecCGI
</code></p></div>
<p>(注: <code>.htaccess</code>
ファイルで "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" ディレクティブが有効になるためには、
"<code>AllowOverride Options</code>" を有効にする必要があります。)</p>
<p>ディレクトリ <code>/www/htdocs/example1/example2</code> には
以下のような <code>.htaccess</code> ファイルがあります:</p>
<div class="example"><p><code>
Options Includes
</code></p></div>
<p>二つめの <code>.htaccess</code> により、ディレクトリ
<code>/www/htdocs/example1/example2</code> では CGI の実行は
許可されません。これは、<code>Options Includes</code> のみが
効力を持ち、それがすべての以前の設定を上書きするからです。</p>
<h3><a name="merge" id="merge">メイン設定ファイルに対する
.htaccess のマージ</a></h3>
<p>As discussed in the documentation on <a href="../sections.html">Configuration Sections</a>,
<code>.htaccess</code> files can override the <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections for
the corresponding directory, but will be overriden by other types
of configuration sections from the main configuration files. This
fact can be used to enforce certain configurations, even in the
presence of a liberal <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> setting. For example, to
prevent script execution while allowing anything else to be set in
<code>.htaccess</code> you can use:</p>
<p><a href="../sections.html">セクションの設定</a>
に記載されているように、<code>.htaccess</code> ファイルを使って
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
セクションの設定をディレクトリ毎に上書きできますが、
メイン設定ファイル中にある、他の種類の設定セクションによって
さらに上書きされることもあります。
この特徴を使って、
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
で自由度の高い設定があったとしても、ある特定の設定が確実に
反映されるようにできます。例えば、CGI スクリプトの実行は
不許可に、かつ、<code>.htaccess</code> でその他の項目は
設定できるように、という場合は次のようにできます :</p>
<div class="example"><p><code>
<Directory /><br />
<span class="indent">
Allowoverride All<br />
</span>
</Directory><br />
<br />
<Location /><br />
<span class="indent">
Options +IncludesNoExec -ExecCGI<br />
</span>
</Location>
</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="auth" id="auth">認証の例</a></h2>
<p>もし認証の方法を知るためにこの部分に直接来たのであれば、次のことを
知っておくことが重要です。よくある誤解に、パスワード認証を行なうためには
<code>.htaccess</code> ファイルを使う必要がある、というものがあります。
これは正しくありません。主サーバ設定ファイルの <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> セクションに
認証用のディレクティブを書く方が推奨される方法で、<code>.htaccess</code>
ファイルは主サーバ設定ファイルを変更できないときにのみ使用すべきです。
いつ <code>.htaccess</code> ファイルを使うべきで、いつ使うべきではないかに
ついては <a href="#when">上</a>を参照してください。</p>
<p>以上のことをふまえた上で、もし <code>.htaccess</code> の使用が
まだ必要だと思う場合は、次のようなものが望みのことをしてくれるかも
しれません。</p>
<p><code>.htaccess</code> ファイルの内容:</p>
<div class="example"><p><code>
AuthType Basic<br />
AuthName "Password Required"<br />
AuthUserFile /www/passwords/password.file<br />
AuthGroupFile /www/passwords/group.file<br />
Require Group admins
</code></p></div>
<p>これらのディレクティブが有効になるためには、
<code>AllowOverride AuthConfig</code> が有効でなくてはならないことに
注意してください。</p>
<p>認証と承認については <a href="auth.html">認証チュートリアル</a>を
参照してください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ssi" id="ssi">SSI の例</a></h2>
<p>もう一つの <code>.htaccess</code> ファイルのよくある利用法は
特定のディレクトリで SSI を有効にすることです。これは、望みのディレクトリの
<code>.htaccess</code> ファイルに以下の設定ディレクティブを書くことで
達成できます:</p>
<div class="example"><p><code>
Options +Includes<br />
AddType text/html shtml<br />
AddHandler server-parsed shtml
</code></p></div>
<p>これらのディレクティブが有効になるためには、
<code>AllowOverride Options</code> と <code>AllowOverride
FileInfo</code> が有効になっている必要があることに注意してください。</p>
<p>よりまとまった SSI の説明は <a href="ssi.html">SSI チュートリアル</a>を
参照してください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">CGI の例</a></h2>
<p>最後に、特定のディレクトリで CGI プログラムの実行を許可したいことが
あるでしょう。これは以下の設定で行なうことができます:</p>
<div class="example"><p><code>
Options +ExecCGI<br />
AddHandler cgi-script cgi pl
</code></p></div>
<p>もしくは、あるディレクトリのすべてのファイルが CGI プログラムと
みなされるようにしたいなら、以下の設定で実現することができます:</p>
<div class="example"><p><code>
Options +ExecCGI<br />
SetHandler cgi-script
</code></p></div>
<p>これらのディレクティブが有効になるためには、
<code>AllowOverride Options</code> と <code>AllowOverride
FileInfo</code> が有効である必要があることに注意してください。</p>
<p>CGI プログラムと設定のよりまとまった説明は <a href="cgi.html">CGI チュートリアル</a>を参照してください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot">問題解決</a></h2>
<p>設定ディレクティブを <code>.htaccess</code> ファイルに書いたけれども、
期待した効果が得られないときには、いくつかの原因が考えられます。</p>
<p>一番よくあることは、設定ディレクティブが考慮されるようには
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> が設定されていない
というものです。該当のファイルのスコープに <code>AllowOverride None</code>
が設定されていないことを確認してください。これを調べるための良い方法は、
<code>.htaccess</code> ファイルにごみを書いて、リロードすることです。
サーバのエラーが生成されないときは、ほぼ確実に <code>AllowOverride
None</code> が設定されている状態になっています。</p>
<p>そうではなく、文書をアクセスしようとしたときにエラーが発生している
ときは、Apache のエラーログを調べてください。<code>.htaccess</code> ファイルで
使用されたディレクティブが許可されていない、ということを知らせている
可能性が高いです。または、構文の間違いがあることを述べているかもしれません。
その場合にはまずそれを修正する必要があります。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/htaccess.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/index.html.es 0000664 0001751 0001751 00000020220 14743132254 020573 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>How-To / Tutoriales - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="../images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a></div><div id="page-content"><div id="preamble"><h1>How-To / Tutoriales</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/" title="Español"> es </a> |
<a href="../fr/howto/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></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="howto" id="howto">How-To / Tutoriales</a></h2>
<dl>
<dt>Autenticación y Autorización</dt>
<dd>
<p>Autenticación es un proceso en el cual se verifica
que alguien es quien afirma ser. Autorización es cualquier
proceso en el que se permite a alguien acceder donde quiere ir,
o a obtener la información que desea tener.</p>
<p>Ver: <a href="auth.html">Autenticación, Autorización</a></p>
</dd>
</dl>
<dl>
<dt>Control de Acceso</dt>
<dd>
<p>Control de acceso hace referencia al proceso de restringir, o
garantizar el acceso a un recurso en base a un criterio arbitrario.
Esto se puede conseguir de distintas formas.</p>
<p>Ver: <a href="access.html">Control de Acceso</a></p>
</dd>
</dl>
<dl>
<dt>Contenido Dinámico con CGI</dt>
<dd>
<p>El CGI (Common Gateway Interface) es un método por el cual
un servidor web puede interactuar con programas externos de
generación de contenido, a ellos nos referimos comúnmente como
programas CGI o scripts CGI. Es un método sencillo para mostrar
contenido dinámico en tu sitio web. Este documento es una
introducción para configurar CGI en tu servidor web Apache, y de
inicio para escribir programas CGI.</p>
<p>Ver: <a href="cgi.html">CGI: Contenido Dinámico</a></p>
</dd>
</dl>
<dl>
<dt>Ficheros <code>.htaccess</code></dt>
<dd>
<p>Los ficheros <code>.htaccess</code> facilitan una forma de
hacer configuraciones por-directorio. Un archivo, que
contiene una o más directivas de configuración, se coloca en un
directorio específico y las directivas especificadas solo aplican
sobre ese directorio y los subdirectorios del mismo.</p>
<p>Ver: <a href="htaccess.html"><code>.htaccess</code> files</a></p>
</dd>
</dl>
<dl>
<dt>HTTP/2 con httpd</dt>
<dd>
<p>HTTP/2 es la evolución del protocolo de capa de aplicación más conocido, HTTP.
Se centra en hacer un uso más eficiente de los recursos de red sin cambiar la
semántica de HTTP. Esta guía explica como se implementa HTTP/2 en httpd,
mostrando buenas prácticas y consejos de configuración básica.
</p>
<p>Ver: <a href="http2.html">Guía HTTP/2</a></p>
</dd>
</dl>
<dl>
<dt>Introducción a los SSI</dt>
<dd>
<p>Los SSI (Server Side Includes) son directivas que se colocan
en las páginas HTML, y son evaluadas por el servidor mientras
éste las sirve. Le permiten añadir contenido generado
dinámicamente a una página HTML existente, sin tener que servir
la página entera a través de un programa CGI u otro método
dinámico.</p>
<p>Ver: <a href="ssi.html">Server Side Includes (SSI)</a></p>
</dd>
</dl>
<dl>
<dt>Directorios web Por-usuario</dt>
<dd>
<p>En sistemas con múltiples usuarios, cada usuario puede tener
su directorio "home" compartido usando la directiva
<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>. Aquellos
que visiten la URL <code>http://example.com/~username/</code>
obtendrán contenido del directorio del usuario "<code>username</code>"
que se encuentra en el directorio "home" del sistema.</p>
<p>Ver: <a href="public_html.html">
Directorios Web de Usuario (<code>public_html</code>)</a></p>
</dd>
</dl>
<dl>
<dt>Guía de Proxy Inverso</dt>
<dd>
<p>Apache httpd ofrece muchas posibilidades como proxy inverso. Usando la
directiva <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> así como
<code class="directive"><a href="../mod/mod_proxy.html#balancermember">BalancerMember</a></code> puede crear
sofisticadas configuraciones de proxy inverso que proveen de alta
disponibilidad, balanceo de carga, clustering basado en la nube y
reconfiguración dinámica en caliente.</p>
<p>Ver: <a href="reverse_proxy.html">Guía de Proxy Inverso</a></p>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/" title="Español"> es </a> |
<a href="../fr/howto/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/public_html.html.es 0000664 0001751 0001751 00000034241 14743132254 021776 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Directorios web por usuario - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="../images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Directorios web por usuario</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/public_html.html" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>En sistemas con múltiples usuarios, cada usuario puede tener un website
en su directorio home usando la directiva <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>. Los visitantes de una URL
<code>http://example.com/~username/</code> recibirán el contenido del
directorio home del usuario "<code>username</code>", en el subdirectorio
especificado por la directiva <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>.</p>
<p>Tenga en cuenta que, por defecto, el acceso a estos directorios
<strong>NO</strong> está activado. Puede permitir acceso cuando usa
<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> quitando el comentario de la línea:</p>
<pre class="prettyprint lang-config">#Include conf/extra/httpd-userdir.conf</pre>
<p>En el fichero por defecto de configuración <code>conf/httpd.conf</code>,
y adaptando el fichero <code>httpd-userdir.conf</code> según sea necesario,
o incluyendo las directivas apropiadas en un bloque
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> dentro del fichero
principal de configuración.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Directorios web por usuario</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#userdir">Configurando la ruta del fichero con UserDir</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirect">Redirigiendo a URLs externas</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#enable">Restringiendo qué usuarios pueden usar esta característica</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">Activando un directorio cgi para cada usuario</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#htaccess">Permitiendo a usuarios cambiar la configuración</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="../urlmapping.html">Mapeando URLs al sistema de ficheros</a></li><li><a href="#comments_section">Comentarios</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="related" id="related">Directorios web por usuario</a></h2>
<table class="related"><tr><th>Módulos Relacionados</th><th>Directivas Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></li><li><code class="directive"><a href="../mod/core.html#directorymatch">DirectoryMatch</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="userdir" id="userdir">Configurando la ruta del fichero con UserDir</a></h2>
<p>La directiva <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
especifica un directorio del que cargar contenido por usuario. Esta directiva
puede tener muchas formas distintas.</p>
<p>Si se especifica una ruta que no empieza con una barra ("/"), se asume que
va a ser una ruta de directorio relativa al directorio home del usuario
especificado. Dada ésta configuración:</p>
<pre class="prettyprint lang-config">UserDir public_html</pre>
<p>La URL <code>http://example.com/~rbowen/file.html</code> se traducirá en
la ruta del fichero <code>/home/rbowen/public_html/file.html</code></p>
<p>Si la ruta que se especifica comienza con una barra ("/"), la ruta del
directorio se construirá usando esa ruta, más el usuario especificado en la
configuración:</p>
<pre class="prettyprint lang-config">UserDir /var/html</pre>
<p>La URL <code>http://example.com/~rbowen/file.html</code> se traducirá en
la ruta del fichero <code>/var/html/rbowen/file.html</code></p>
<p>Si se especifica una ruta que contiene un asterisco (*), se usará una ruta
en la que el asterisco se reemplaza con el nombre de usuario. Dada ésta configuración:</p>
<pre class="prettyprint lang-config">UserDir /var/www/*/docs</pre>
<p>La URL <code>http://example.com/~rbowen/file.html</code> se traducirá en
la ruta del fichero <code>/var/www/rbowen/docs/file.html</code></p>
<p>También se pueden configurar múltiples directorios o rutas de directorios.</p>
<pre class="prettyprint lang-config">UserDir public_html /var/html</pre>
<p>Para la URL <code>http://example.com/~rbowen/file.html</code>,
Apache buscará <code>~rbowen</code>. Si no lo encuentra, Apache buscará
<code>rbowen</code> en <code>/var/html</code>. Si lo encuentra, la URL de más
arriba se traducirá en la ruta del fichero
<code>/var/html/rbowen/file.html</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirect" id="redirect">Redirigiendo a URLs externas</a></h2>
<p>La directiva <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> puede
usarse para redirigir solcitudes de directorios de usuario a URLs externas.</p>
<pre class="prettyprint lang-config">UserDir http://example.org/users/*/</pre>
<p>El ejemplo de aquí arriba redirigirá una solicitud para
<code>http://example.com/~bob/abc.html</code> hacia
<code>http://example.org/users/bob/abc.html</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="enable" id="enable">Restringiendo qué usuarios pueden usar esta característica</a></h2>
<p>Usando la sintaxis que se muestra en la documentación de UserDir, usted
puede restringir a qué usuarios se les permite usar esta funcionalidad:</p>
<pre class="prettyprint lang-config">UserDir disabled root jro fish</pre>
<p>La configuración de aquí arriba permitirá a todos los usuarios excepto a
los que se listan con la declaración <code>disabled</code>. Usted puede,
del mismo modo, deshabilitar esta característica para todos excepto algunos
usuarios usando una configuración como la siguiente:</p>
<pre class="prettyprint lang-config">UserDir disabled
UserDir enabled rbowen krietz</pre>
<p>Vea la documentación de <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> para más
ejemplos.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">Activando un directorio cgi para cada usuario</a></h2>
<p>Para dar a cada usuario su propio directorio cgi-bin, puede usar una directiva
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
para activar cgi en un subdirectorio en particular del directorio home del usuario.</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html/cgi-bin/">
Options ExecCGI
SetHandler cgi-script
</Directory></pre>
<p>Entonces, asumiendo que <code>UserDir</code> está configurado con la
declaración <code>public_html</code>, un programa cgi <code>example.cgi</code>
podría cargarse de ese directorio así:</p>
<div class="example"><p><code>
http://example.com/~rbowen/cgi-bin/example.cgi
</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="htaccess" id="htaccess">Permitiendo a usuarios cambiar la configuración</a></h2>
<p>Si quiere permitir que usuarios modifiquen la configuración del servidor en
su espacio web, necesitarán usar ficheros <code>.htaccess</code> para hacer
estos cambios. Asegúrese de tener configurado <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> con un valor suficiente que permita a
los usuarios modificar las directivas que quiera permitir.
Vea el <a href="htaccess.html">tutorial de .htaccess</a> para obtener detalles adicionales sobre cómo funciona.</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/public_html.html" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/public_html.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/auth.html.en 0000664 0001751 0001751 00000111445 14737241666 020445 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Authentication and Authorization - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Authentication and Authorization</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/howto/auth.html" title="English"> en </a> |
<a href="../es/howto/auth.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Authentication is any process by which you verify that
someone is who they claim they are. Authorization is any
process by which someone is allowed to be where they want to
go, or to have information that they want to have.</p>
<p>For general access control, see the <a href="access.html">Access
Control How-To</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Related Modules and Directives</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#theprerequisites">The Prerequisites</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#gettingitworking">Getting it working</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#lettingmorethanonepersonin">Letting more than one
person in</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#possibleproblems">Possible problems</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#dbmdbd">Alternate password storage</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multprovider">Using multiple providers</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#beyond">Beyond just authorization</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#socache">Authentication Caching</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinformation">More information</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="related" id="related">Related Modules and Directives</a></h2>
<p>There are three types of modules involved in the authentication and
authorization process. You will usually need to choose at least one
module from each group.</p>
<ul>
<li>Authentication type (see the
<code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code> directive)
<ul>
<li><code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code></li>
<li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li>
</ul>
</li>
<li>Authentication provider (see the
<code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> and
<code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> directives)
<ul>
<li><code class="module"><a href="../mod/mod_authn_anon.html">mod_authn_anon</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li>
<li><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code></li>
</ul>
</li>
<li>Authorization (see the
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directive)
<ul>
<li><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_dbd.html">mod_authz_dbd</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code></li>
</ul>
</li>
</ul>
<p>In addition to these modules, there are also
<code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> and
<code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>. These modules implement core
directives that are core to all auth modules.</p>
<p>The module <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> is both an
authentication and authorization provider. The module
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> provides authorization
and access control based on hostname, IP address or characteristics
of the request, but is not part of the authentication provider
system. For backwards compatibility with the mod_access, there is
a new module <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code>.</p>
<p>You probably also want to take a look at the <a href="access.html">Access Control</a> howto, which discusses the
various ways to control access to your server.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="introduction" id="introduction">Introduction</a></h2>
<p>If you have information on your web site that is sensitive
or intended for only a small group of people, the techniques in
this article will help you make sure that the people that see
those pages are the people that you wanted to see them.</p>
<p>This article covers the "standard" way of protecting parts
of your web site that most of you are going to use.</p>
<div class="note"><h3>Note:</h3>
<p>If your data really needs to be secure, consider using
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> in addition to any authentication.</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="theprerequisites" id="theprerequisites">The Prerequisites</a></h2>
<p>The directives discussed in this article will need to go
either in your main server configuration file (typically in a
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> section), or
in per-directory configuration files (<code>.htaccess</code> files).</p>
<p>If you plan to use <code>.htaccess</code> files, you will
need to have a server configuration that permits putting
authentication directives in these files. This is done with the
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> directive, which
specifies which directives, if any, may be put in per-directory
configuration files.</p>
<p>Since we're talking here about authentication, you will need
an <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> directive like the
following:</p>
<pre class="prettyprint lang-config">AllowOverride AuthConfig</pre>
<p>Or, if you are just going to put the directives directly in
your main server configuration file, you will of course need to
have write permission to that file.</p>
<p>And you'll need to know a little bit about the directory
structure of your server, in order to know where some files are
kept. This should not be terribly difficult, and I'll try to
make this clear when we come to that point.</p>
<p>You will also need to make sure that the modules
<code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> and <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>
have either been built into the httpd binary or loaded by the
httpd.conf configuration file. Both of these modules provide core
directives and functionality that are critical to the configuration
and use of authentication and authorization in the web server.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="gettingitworking" id="gettingitworking">Getting it working</a></h2>
<p>Here's the basics of password protecting a directory on your
server.</p>
<p>First, you need to create a password file. Exactly how you do
this will vary depending on what authentication provider you have
chosen. More on that later. To start with, we'll use a text password
file.</p>
<p>This file should be
placed somewhere not accessible from the web. This is so that
folks cannot download the password file. For example, if your
documents are served out of <code>/usr/local/apache/htdocs</code>, you
might want to put the password file(s) in
<code>/usr/local/apache/passwd</code>.</p>
<p>To create the file, use the <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> utility that
came with Apache. This will be located in the <code>bin</code> directory
of wherever you installed Apache. If you have installed Apache from
a third-party package, it may be in your execution path.</p>
<p>To create the file, type:</p>
<div class="example"><p><code>
htpasswd -c /usr/local/apache/passwd/passwords rbowen
</code></p></div>
<p><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> will ask you for the password, and
then ask you to type it again to confirm it:</p>
<div class="example"><p><code>
# htpasswd -c /usr/local/apache/passwd/passwords rbowen<br />
New password: mypassword<br />
Re-type new password: mypassword<br />
Adding password for user rbowen
</code></p></div>
<p>If <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> is not in your path, of course
you'll have to type the full path to the file to get it to run.
With a default installation, it's located at
<code>/usr/local/apache2/bin/htpasswd</code></p>
<p>Next, you'll need to configure the server to request a
password and tell the server which users are allowed access.
You can do this either by editing the <code>httpd.conf</code>
file or using an <code>.htaccess</code> file. For example, if
you wish to protect the directory
<code>/usr/local/apache/htdocs/secret</code>, you can use the
following directives, either placed in the file
<code>/usr/local/apache/htdocs/secret/.htaccess</code>, or
placed in <code>httpd.conf</code> inside a <Directory
"/usr/local/apache/htdocs/secret"> section.</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "Restricted Files"
# (Following line optional)
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
Require user rbowen</pre>
<p>Let's examine each of those directives individually. The <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code> directive selects
the method that is used to authenticate the user. The most
common method is <code>Basic</code>, and this is the method
implemented by <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>. It is important to be aware,
however, that Basic authentication sends the password from the client to
the server unencrypted. This method should therefore not be used for
highly sensitive data, unless accompanied by <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.
Apache supports one other authentication method:
<code>AuthType Digest</code>. This method is implemented by <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> and was intended to be more secure. This is no
longer the case and the connection should be encrypted with <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> instead.</p>
<p>The <code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code> directive sets
the <dfn>Realm</dfn> to be used in the authentication. The realm serves
two major functions. First, the client often presents this information to
the user as part of the password dialog box. Second, it is used by the
client to determine what password to send for a given authenticated
area.</p>
<p>So, for example, once a client has authenticated in the
<code>"Restricted Files"</code> area, it will automatically
retry the same password for any area on the same server that is
marked with the <code>"Restricted Files"</code> Realm.
Therefore, you can prevent a user from being prompted more than
once for a password by letting multiple restricted areas share
the same realm. Of course, for security reasons, the client
will always need to ask again for the password whenever the
hostname of the server changes.</p>
<p>The <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> is,
in this case, optional, since <code>file</code> is the default value
for this directive. You'll need to use this directive if you are
choosing a different source for authentication, such as
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> or <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.</p>
<p>The <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
directive sets the path to the password file that we just
created with <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>. If you have a large number
of users, it can be quite slow to search through a plain text
file to authenticate the user on each request. Apache also has
the ability to store user information in fast database files.
The <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> module provides the <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code> directive. These
files can be created and manipulated with the <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> and <code class="program"><a href="../programs/htdbm.html">htdbm</a></code> programs. Many
other types of authentication options are available from third
party modules.</p>
<p>Finally, the <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
directive provides the authorization part of the process by
setting the user that is allowed to access this region of the
server. In the next section, we discuss various ways to use the
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="lettingmorethanonepersonin" id="lettingmorethanonepersonin">Letting more than one
person in</a></h2>
<p>The directives above only let one person (specifically
someone with a username of <code>rbowen</code>) into the
directory. In most cases, you'll want to let more than one
person in. This is where the <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> comes in.</p>
<p>If you want to let more than one person in, you'll need to
create a group file that associates group names with a list of
users in that group. The format of this file is pretty simple,
and you can create it with your favorite editor. The contents
of the file will look like this:</p>
<div class="example"><p><code>
GroupName: rbowen dpitts sungo rshersey
</code></p></div>
<p>That's just a list of the members of the group in a long
line separated by spaces.</p>
<p>To add a user to your already existing password file,
type:</p>
<div class="example"><p><code>
htpasswd /usr/local/apache/passwd/passwords dpitts
</code></p></div>
<p>You'll get the same response as before, but it will be
appended to the existing file, rather than creating a new file.
(It's the <code>-c</code> that makes it create a new password
file).</p>
<p>Now, you need to modify your <code>.htaccess</code> file or
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> block
to look like the following:</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "By Invitation Only"
# Optional line:
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthGroupFile "/usr/local/apache/passwd/groups"
Require group GroupName</pre>
<p>Now, anyone that is listed in the group <code>GroupName</code>,
and has an entry in the <code>password</code> file, will be let in, if
they type the correct password.</p>
<p>There's another way to let multiple users in that is less
specific. Rather than creating a group file, you can just use
the following directive:</p>
<pre class="prettyprint lang-config">Require valid-user</pre>
<p>Using that rather than the <code>Require user rbowen</code>
line will allow anyone in that is listed in the password file,
and who correctly enters their password.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="possibleproblems" id="possibleproblems">Possible problems</a></h2>
<p>Because of the way that Basic authentication is specified,
your username and password must be verified every time you
request a document from the server. This is even if you're
reloading the same page, and for every image on the page (if
they come from a protected directory). As you can imagine, this
slows things down a little. The amount that it slows things
down is proportional to the size of the password file, because
it has to open up that file, and go down the list of users
until it gets to your name. And it has to do this every time a
page is loaded.</p>
<p>A consequence of this is that there's a practical limit to
how many users you can put in one password file. This limit
will vary depending on the performance of your particular
server machine, but you can expect to see slowdowns once you
get above a few hundred entries, and may wish to consider a
different authentication method at that time.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="dbmdbd" id="dbmdbd">Alternate password storage</a></h2>
<p>Because storing passwords in plain text files has the above
problems, you may wish to store your passwords somewhere else, such
as in a database.</p>
<p><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> and <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> are two
modules which make this possible. Rather than selecting <code><code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> file</code>, instead
you can choose <code>dbm</code> or <code>dbd</code> as your storage
format.</p>
<p>To select a dbm file rather than a text file, for example:</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider dbm
AuthDBMUserFile "/www/passwords/passwd.dbm"
Require valid-user
</Directory></pre>
<p>Other options are available. Consult the
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> documentation for more details.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="multprovider" id="multprovider">Using multiple providers</a></h2>
<p>With the introduction of the new provider based authentication and
authorization architecture, you are no longer locked into a single
authentication or authorization method. In fact any number of the
providers can be mixed and matched to provide you with exactly the
scheme that meets your needs. In the following example, both the
file and LDAP based authentication providers are being used.</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider file ldap
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthLDAPURL ldap://ldaphost/o=yourorg
Require valid-user
</Directory></pre>
<p>In this example the file provider will attempt to authenticate
the user first. If it is unable to authenticate the user, the LDAP
provider will be called. This allows the scope of authentication
to be broadened if your organization implements more than
one type of authentication store. Other authentication and authorization
scenarios may include mixing one type of authentication with a
different type of authorization. For example, authenticating against
a password file yet authorizing against an LDAP directory.</p>
<p>Just as multiple authentication providers can be implemented, multiple
authorization methods can also be used. In this example both file group
authorization as well as LDAP group authorization is being used.</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthLDAPURL ldap://ldaphost/o=yourorg
AuthGroupFile "/usr/local/apache/passwd/groups"
Require group GroupName
Require ldap-group cn=mygroup,o=yourorg
</Directory></pre>
<p>To take authorization a little further, authorization container
directives such as
<code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code>
and
<code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code>
allow logic to be applied so that the order in which authorization
is handled can be completely controlled through the configuration.
See <a href="../mod/mod_authz_core.html#logic">Authorization
Containers</a> for an example of how they may be applied.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="beyond" id="beyond">Beyond just authorization</a></h2>
<p>The way that authorization can be applied is now much more flexible
than just a single check against a single data store. Ordering, logic
and choosing how authorization will be done is now possible.</p>
<h3><a name="authandororder" id="authandororder">Applying logic and ordering</a></h3>
<p>Controlling how and in what order authorization will be applied
has been a bit of a mystery in the past. In Apache 2.2 a provider-based
authentication mechanism was introduced to decouple the actual
authentication process from authorization and supporting functionality.
One of the side benefits was that authentication providers could be
configured and called in a specific order which didn't depend on the
load order of the auth module itself. This same provider based mechanism
has been brought forward into authorization as well. What this means is
that the <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directive
not only specifies which authorization methods should be used, it also
specifies the order in which they are called. Multiple authorization
methods are called in the same order in which the
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directives
appear in the configuration.</p>
<p>With the introduction of authorization container directives
such as
<code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code>
and
<code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code>,
the configuration also has control over when the
authorization methods are called and what criteria determines when
access is granted. See
<a href="../mod/mod_authz_core.html#logic">Authorization Containers</a>
for an example of how they may be used to express complex
authorization logic.</p>
<p>By default all
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
directives are handled as though contained within a
<code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code>
container directive. In other words, if
any of the specified authorization methods succeed, then authorization
is granted.</p>
<h3><a name="reqaccessctrl" id="reqaccessctrl">Using authorization providers for access control</a></h3>
<p>Authentication by username and password is only part of the
story. Frequently you want to let people in based on something
other than who they are. Something such as where they are
coming from.</p>
<p>The authorization providers <code>all</code>,
<code>env</code>, <code>host</code> and <code>ip</code> let you
allow or deny access based on other host based criteria such as
host name or ip address of the machine requesting a
document.</p>
<p>The usage of these providers is specified through the
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> directive.
This directive registers the authorization providers
that will be called during the authorization stage of the request
processing. For example:</p>
<pre class="prettyprint lang-config">Require ip <var>address</var>
</pre>
<p>where <var>address</var> is an IP address (or a partial IP
address) or:</p>
<pre class="prettyprint lang-config">Require host <var>domain_name</var>
</pre>
<p>where <var>domain_name</var> is a fully qualified domain name
(or a partial domain name); you may provide multiple addresses or
domain names, if desired.</p>
<p>For example, if you have someone spamming your message
board, and you want to keep them out, you could do the
following:</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not ip 10.252.46.165
</RequireAll></pre>
<p>Visitors coming from that address will not be able to see
the content covered by this directive. If, instead, you have a
machine name, rather than an IP address, you can use that.</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not host host.example.com
</RequireAll></pre>
<p>And, if you'd like to block access from an entire domain,
you can specify just part of an address or domain name:</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not ip 192.168.205
Require not host phishers.example.com moreidiots.example
Require not host ke
</RequireAll></pre>
<p>Using <code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code>
with multiple <code class="directive"><a href="../mod/mod_authz_core.html#require"><Require></a></code> directives, each negated with <code>not</code>,
will only allow access, if all of negated conditions are true. In other words,
access will be blocked, if any of the negated conditions fails.</p>
<h3><a name="filesystem" id="filesystem">Access Control backwards compatibility</a></h3>
<p>One of the side effects of adopting a provider based mechanism for
authentication is that the previous access control directives
<code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> and
<code class="directive"><a href="../mod/mod_access_compat.html#satisfy">Satisfy</a></code> are no longer needed.
However to provide backwards compatibility for older configurations, these
directives have been moved to the <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> module.</p>
<div class="warning"><h3>Note</h3>
<p>The directives provided by <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> have
been deprecated by <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>.
Mixing old directives like <code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>, <code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code> or <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> with new ones like
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> is technically possible
but discouraged. The <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> module was created to support
configurations containing only old directives to facilitate the 2.4 upgrade.
Please check the <a href="../upgrading.html">upgrading</a> guide for more
information.
</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="socache" id="socache">Authentication Caching</a></h2>
<p>There may be times when authentication puts an unacceptable load
on a provider or on your network. This is most likely to affect users
of <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> (or third-party/custom providers).
To deal with this, HTTPD 2.3/2.4 introduces a new caching provider
<code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code> to cache credentials and reduce
the load on the origin provider(s).</p>
<p>This may offer a substantial performance boost to some users.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinformation" id="moreinformation">More information</a></h2>
<p>You should also read the documentation for
<code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> and <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>
which contain some more information about how this all works. The
directive <code class="directive"><a href="../mod/mod_authn_core.html#authnprovideralias"><AuthnProviderAlias></a></code> can also help
in simplifying certain authentication configurations.</p>
<p>The various ciphers supported by Apache for authentication data are
explained in <a href="../misc/password_encryptions.html">Password
Encryptions</a>.</p>
<p>And you may want to look at the <a href="access.html">Access
Control</a> howto, which discusses a number of related topics.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/howto/auth.html" title="English"> en </a> |
<a href="../es/howto/auth.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/auth.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/index.html.en 0000664 0001751 0001751 00000020662 14737241666 020613 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>How-To / Tutorials - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>How-To / Tutorials</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/howto/" title="English"> en </a> |
<a href="../es/howto/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></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="howto" id="howto">How-To / Tutorials</a></h2>
<dl>
<dt>Authentication and Authorization</dt>
<dd>
<p>Authentication is any process by which you verify that
someone is who they claim they are. Authorization is any
process by which someone is allowed to be where they want to
go, or to have information that they want to have.</p>
<p>See: <a href="auth.html">Authentication, Authorization</a></p>
</dd>
</dl>
<dl>
<dt>Access Control</dt>
<dd>
<p>Access control refers to the process of restricting, or
granting access to a resource based on arbitrary criteria. There
are a variety of different ways that this can be
accomplished.</p>
<p>See: <a href="access.html">Access Control</a></p>
</dd>
</dl>
<dl>
<dt>Dynamic Content with CGI</dt>
<dd>
<p>The CGI (Common Gateway Interface) defines a way for a web
server to interact with external content-generating programs,
which are often referred to as CGI programs or CGI scripts. It
is a simple way to put dynamic content on
your web site. This document will be an introduction to setting
up CGI on your Apache web server, and getting started writing
CGI programs.</p>
<p>See: <a href="cgi.html">CGI: Dynamic Content</a></p>
</dd>
</dl>
<dl>
<dt><code>.htaccess</code> files</dt>
<dd>
<p><code>.htaccess</code> files provide a way to make configuration
changes on a per-directory basis. A file, containing one or more
configuration directives, is placed in a particular document directory,
and the directives apply to that directory, and all subdirectories thereof.</p>
<p>See: <a href="htaccess.html"><code>.htaccess</code> files</a></p>
</dd>
</dl>
<dl>
<dt>HTTP/2 with httpd</dt>
<dd>
<p>HTTP/2 is the evolution of the world's most successful application layer protocol, HTTP.
It focuses on making more efficient use of network resources without changing the semantics of HTTP.
This guide explains how HTTP/2 is implemented in httpd, showing basic configurations tips and
best practices.
</p>
<p>See: <a href="http2.html">HTTP/2 guide</a></p>
</dd>
</dl>
<dl>
<dt>Introduction to Server Side Includes</dt>
<dd>
<p>SSI (Server Side Includes) are directives that are placed in
HTML pages, and evaluated on the server while the pages are
being served. They let you add dynamically generated content to
an existing HTML page, without having to serve the entire page
via a CGI program, or other dynamic technology.</p>
<p>See: <a href="ssi.html">Server Side Includes (SSI)</a></p>
</dd>
</dl>
<dl>
<dt>Per-user web directories</dt>
<dd>
<p>On systems with multiple users, each user can be permitted to have a
web site in their home directory using the <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> directive. Visitors
to a URL <code>http://example.com/~username/</code> will get content
out of the home directory of the user "<code>username</code>", out of
the subdirectory specified by the <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> directive.</p>
<p>See: <a href="public_html.html">User web directories (<code>public_html</code>)</a></p>
</dd>
</dl>
<dl>
<dt>Reverse Proxy guide</dt>
<dd>
<p>Apache httpd has extensive capabilities as a reverse proxy server using the
<code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> directive as well as
<code class="directive"><a href="../mod/mod_proxy.html#balancermember">BalancerMember</a></code> to create sophisticated
reverse proxying implementations which provide for high-availability, load
balancing and failover, cloud-based clustering and dynamic on-the-fly reconfiguration.</p>
<p>See: <a href="reverse_proxy.html">Reverse proxy guide</a></p>
</dd>
</dl>
<dl>
<dt>Rewriting URLs with mod_rewrite</dt>
<dd>
<p>Rewriting URLs with (and without)
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> tends to be one of the most
frequently asked topics on our mailing lists and IRC channels.
We have devoted <a href="../rewrite/">and entire section of our
documentation</a> to howtos and recipes around this topic.</p>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/howto/" title="English"> en </a> |
<a href="../es/howto/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/auth.html.tr.utf8 0000664 0001751 0001751 00000114550 14743132254 021342 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Kimlik Doğrulama ve Yetkilendirme - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Nasıllar ve Öğreticiler</a></div><div id="page-content"><div id="preamble"><h1>Kimlik Doğrulama ve Yetkilendirme</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/auth.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" title="Türkçe"> tr </a></p>
</div>
<p>Kimlik Doğrulama istediğiniz kişileri teyid etme işlemidir.
Yetkilendirme ise kişilerin nereye gireceklerine ve hangi bilgiye
ulaşacaklarına müsaade edilmesi işlemidir.</p>
<p>Genel erişim denetimi için <a href="access.html">Erişim Denetimi
Nasıl</a> belgesine bakınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">İlgili modüller ve Yönergeler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#introduction">Giriş</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#theprerequisites">Ön gereksinimler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#gettingitworking">Çalışmaya Başlama</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#lettingmorethanonepersonin">Birden çok kişiye izin vermek</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#possibleproblems">Olası Sorunlar</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#dbmdbd">Diğer parola depolama yöntemleri</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multprovider">Birden çok tedarikçi kullanmak</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#beyond">Yetkilendirmenin biraz ötesi</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#socache">Kimlik Doğrulama Arabelleği</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinformation">Daha fazla bilgi</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="related" id="related">İlgili modüller ve Yönergeler</a></h2>
<p>Kimlik Doğrulama ve yetkilendirme işlemi ile ilgili üç tür modül
vardır. Genellikle her bir gruptan en az bir modül seçeceksiniz.</p>
<ul>
<li>Kimlik Doğrulama türü (bkz. <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code> yönergesi)
<ul>
<li><code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code></li>
<li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li>
</ul>
</li>
<li>Kimlik Doğrulayıcı (bkz.
<code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code>
ve <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> yönergeleri)
<ul>
<li><code class="module"><a href="../mod/mod_authn_anon.html">mod_authn_anon</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li>
<li><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code></li>
</ul>
</li>
<li>Yetkilendirme (bkz.
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> yönergesi)
<ul>
<li><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_dbd.html">mod_authz_dbd</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code></li>
</ul>
</li>
</ul>
<p>Bu modüllere ek olarak, <code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> ve
<code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> modülleri bulunur. Bu modüller
yetkilendirme modüllerinin çekirdeğini oluşturan temel yönergeleri
gerçekler.</p>
<p><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> modülü kimlik doğrulama ve
yetkilendirme işlemlerinin ikisini birden gerçekleştirir.
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> modülü bu işlemleri sunucu adına, IP
adresine ve isteğin karekteristiğine bağlı olarak gerçekleştirir.
Ancak kimlik doğrulama sisteminin bir parçası değildir.
<code>mod_access</code> ile geriye uyumluluk için
<code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> diye bir modül daha vardır.</p>
<p>Muhtemelen göz atmak isteyeceğiniz <a href="access.html">Erişim
Denetimi</a> nasıl belgesi, sunucuya erişimlerin çeşitli yollarından
bahsetmektedir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="introduction" id="introduction">Giriş</a></h2>
<p>Sitenizde sadece küçük bir grup insana hitap eden ya da hassas
bilgileriniz varsa, bu makaledeki teknikleri kullanarak dilediğiniz
kişilerin sadece dilediğiniz sayfaları görüntülemesini
sağlayabilirsiniz.</p>
<p>Bu makale sitenizin bazı parçalarını korumak için kullanacağınız
"standart" yolları içermektedir.</p>
<div class="note"><h3>Bilginize:</h3>
<p>Eğer bilgileriniz gerçekten gizliliğe ihtiyaç duyuyorsa kimlik
doğrulamasına ilaveten <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> modülünü de
kullanabilirsiniz.</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="theprerequisites" id="theprerequisites">Ön gereksinimler</a></h2>
<p>Bu makalede bahsi geçen yönergeler ya ana sunucu yapılandırma
dosyasında (genellikle <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> bölümünde) ya da dizin içi
yapılandırma dosyalarında (<code>.htaccess</code> dosyaları)
bulunmak zorundadır.</p>
<p>Eğer <code>.htaccess</code> dosyalarını kullanmayı
tasarlıyorsanız, kimlik doğrulama yönergelerine bu dosyaların içine
koymaya izin veren sunucu yapılandırmasına ihtiyacınız olacaktır.
Bunun için, dizin içi yapılandırma dosyalarının içine hangi
yönergelerin konacağını belirleyen <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> yönergesi kullanılır.</p>
<p>Kimlik doğrulamadan sözettiğimize göre, aşağıda gösterilen
şekilde bir <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> yönergesine ihtiyacınız olacaktır:</p>
<pre class="prettyprint lang-config">AllowOverride AuthConfig</pre>
<p>Yönergeleri doğrudan ana sunucunun yapılandırma dosyasına
koyacaksanız bu dosyaya yazma izniniz olmalıdır.</p>
<p>Bazı dosyaların nerede saklandığını bilmek için sunucunun dizin
yapısı hakkında biraz bilgi sahibi olmanız gerekmektedir. Bu çok da
zor olmamakla birlikte bu noktaya gelindiğinde konuyu
netleştireceğiz.</p>
<p>Ayrıca <code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> ve
<code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> modülleri ya <code>httpd</code>
çalıştırılabilirinin içinde derlenmiş olmalı ya da
<code>httpd.conf</code> yapılandırma dosyası ile yüklenmelidir. Bu
iki modül HTTP sunucusunda kimlik doğrulama ve yetkilendirme
kullanımı ve yapılandırması için büyük öneme sahip temel yönergeleri
ve işlevselliği sağlar.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="gettingitworking" id="gettingitworking">Çalışmaya Başlama</a></h2>
<p>Burada, sunucu üzerindeki bir dizini parolayla korumak için
gereken temel bilgiler verilecektir.</p>
<p>İlk olarak bir parola dosyası oluşturmalısınız. Bunu nasıl
yapacağınız, özellikle, seçtiğiniz kimlik doğrulayıcıya göre
değişiklik gösterir. Bunun üzerinde ileride daha fazla duracağız.
Başlangıç için parolaları bir metin dosyasında tutacağız.</p>
<p>Bu dosya belge kök dizini altında olmamalıdır. Böylece başkaları
parola dosyasını indiremezler. Örneğin belgeleriniz
<code>/usr/local/apache/htdocs</code> üzerinden sunuluyorsa parola
dosyanızı <code>/usr/local/apache/passwd</code> dizininde
tutabilirsiniz.</p>
<p>Dosyayı oluşturmak için Apache ile gelen
<code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> uygulamasını kullanacağız. Bu uygulama
Apache'nin kurulumunda belirtilen <code>bin</code> dizininde
bulunur. Eğer Apache'yi üçüncü parti paketlerden kurduysanız,
çalıştırılabilir dosyaların bulunduğu yollar üzerinde olmalıdır.</p>
<p>Bir dosya oluşturmak için şunları yazın:</p>
<div class="example"><p><code>
htpasswd -c /usr/local/apache/passwd/passwords umut
</code></p></div>
<p><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> size parola soracaktır arkasından da
teyit etmek için parolayı tekrar girmenizi isteyecektir:</p>
<div class="example"><p><code>
# htpasswd -c /usr/local/apache/passwd/passwords umut<br />
New password: parolam<br />
Re-type new password: parolam<br />
Adding password for user umut
</code></p></div>
<p>Eğer <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> normal yollar üzerinde değilse
çalıştırmak için dosyanın bulunduğu tam yeri belirtmeniz
gerekecektir. Dosyanın öntanımlı kurulum yeri:
<code>/usr/local/apache2/bin/htpasswd</code></p>
<p>Bundan sonra, sunucuyu, parola sorması için ve kimlerin erişim
izni olacağını belirlemek için yapılandıracaksınız. Bu işlemi
<code>httpd.conf</code>dosyasını düzenleyerek ya da bir
<code>.htaccess</code> dosyası kullanarak yapabilirsiniz. Örneğin,
<code>/usr/local/apache/htdocs/secret</code> dizinini korumayı
amaçlıyorsanız, şu yönergeleri kullanabilirsiniz. Bu yönergeleri
<code>/usr/local/apache/htdocs/secret/.htaccess</code> dosyası içine
veya <code>httpd.conf</code> içindeki <Directory
"/usr/local/apache/htdocs/secret"> bölümüne koyabilirsiniz.</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "Gizli Dosyalar"
# (Aşağıdaki satırın kullanımı isteğe bağlıdır)
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
Require user umut</pre>
<p>Bu yönergeleri tek tek inceleyelim.
<code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code> yönergesi
kullanıcının kimliğini doğrulamakta kullanılacak yöntemi seçer. En
çok kullanılan yöntem <code>Basic</code>'tir ve bu yöntem
<code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> modülüyle gerçeklenmiştir. Temel
(<code>Basic</code>) kimlik doğrulamasıyla gönderilen parolanın
şifrelenmeyeceğini unutmayın. Bu yöntem, bu sebepten dolayı
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> eşliğinde kullanılmadığı sürece yüksek
hassasiyete sahip bilgiler için kullanılmamalıdır. Apache bir başka
kimlik doğrulama yöntemini daha destekler: <code>AuthType
Digest</code>. Bu yöntem <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> tarafından
gerçeklenmişti ve çok daha güvenli olacağı düşünülmüştü. Bu artık
geçerliliğini yitirdiğinden bağlantının bundan böyle
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> ile şifrelenmesi gerekmektedir.</p>
<p><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code> yönergesi
ile kimlik doğrulamada kullanılacak <dfn>Saha</dfn> da
belirtilebilir. Saha kullanımının, başlıca iki işlevi vardır.
Birincisi, istemci sıklıkla bu bilgiyi kullanıcıya parola diyalog
kutusunun bir parçası olarak sunar. İkincisi, belirtilen kimlik
doğrulamalı alan için gönderilecek parolayı belirlerken istemci
tarafından kullanılır.</p>
<p>Örneğin, bir istemcinin <code>"Gizli Dosyalar"</code> alanında
kimliği doğrulanmış olsun. Aynı sunucu üzerinde <code>"Gizli
Dosyalar"</code> Sahası olarak belirlenmiş alanlarda aynı parola
özdevinimli olarak yinelenecektir. Böylece parola bir kere girilerek
aynı Sahayı paylaşan çok sayıda kısıtlanmış alana ulaşırken oluşacak
gecikmeden kullanıcı korunmuş olur. Güvenlik gerekçelerinden dolayı,
her sunucu adı değiştirilişinde istemcinin parolayı yeniden sorması
gerekir.</p>
<p><code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code>
yönergesinin öntanımlı değeri <code>file</code> olduğundan, bu
durumda, bu yönergenin kullanımı isteğe bağlıdır. Ancak, eğer kimlik
doğrulaması için <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> ya da
<code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> gibi farklı bir kaynak seçecekseniz
bu yönergeyi kullanmanız gerekecektir.</p>
<p><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
yönergesi <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> ile oluşturduğumuz parola
dosyasının yerini belirtmek için kullanılır. Eğer çok sayıda
kullanıcınız varsa her bir kullanıcıyı her kimlik doğrulama isteği
için kimlik bilgilerini bir metin dosyasında aramak gayet yavaş
olacaktır. Apache, kullanıcı bilgilerini hızlı bir veritabanı
dosyasında depolama özelliğine de sahiptir. Bu amaçla,
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> modülünün
<code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>
yönergesi kullanılabilir. Bu dosyalar <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> ve
<code class="program"><a href="../programs/htdbm.html">htdbm</a></code> programı ile oluşturulabilir ve değiştirilebilir.
Üçüncü parti modüllerinde çok sayıda
başka kimlik doğrulama türü de vardır.</p>
<p>Son olarak <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
yönergesi, sunucunun bu bölgesine erişimine izin verilen
kullanıcıları ayarlama işleminin kimlik doğrulamasıyla ilgili
kısmını sağlar. Bir sonraki bölümde <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> yönergesini kullanmanın
çeşitli yoları üzerinde duracağız.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="lettingmorethanonepersonin" id="lettingmorethanonepersonin">Birden çok kişiye izin vermek</a></h2>
<p>Yukarıdaki yönergelerle bir dizinde sadece bir kişiye
(<code>umut</code> adlı kullanıcıya) izin verir. Çoğunlukla birden
çok kişiye izin verilmesi istenir. Bu durumda <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> yönergesi
devreye girer.</p>
<p>Eğer birden çok kişiye izin vermek istiyorsanız içinde kullanıcı
isimlerinin olduğu bir grup dosyası oluşturmalısınız. Bu dosyanın
biçemi gayet basittir ve bunu herhangi bir metin düzenleyici ile
oluşturabilirsiniz. Bu dosyanın içeriği aşağıdaki gibi
görünecektir:</p>
<div class="example"><p><code>
GroupName: umut samet engin kubilay
</code></p></div>
<p>Dosya, sadece, boşluklarla birbirinden ayrılmış gurup üyelerinin
isimlerinden oluşan uzun bir liste içerir.</p>
<p>Varolan parola dosyasına bir kullanıcı eklemek için şunu
yazın:</p>
<div class="example"><p><code>
htpasswd /usr/local/apache/passwd/passwords birey
</code></p></div>
<p>Evvelce almış olduğunuz yanıtı yine alacaksınız ama bu sefer yeni
bir dosya oluşturulmak yerine var olan bir dosyaya eklenecektir.
(Yeni bir parola dosyası oluşturmak için <code>-c</code> seçeneği
kullanılır).</p>
<p>Şimdi, <code>.htaccess</code> dosyanızı veya
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> bölümünüzü
aşağıda görüldüğü şekilde değiştirebilirsiniz:</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "Davete Binaen"
# Satır isteğe bağlıdır:
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthGroupFile "/usr/local/apache/passwd/groups"
Require group Grupismi</pre>
<p>Artık, <code>Grupismi</code> gurubunda listelenmiş ve
<code>password</code> dosyasında kaydı olan kişiye, parolayı doğru
yazdığı takdirde izin verilecektir.</p>
<p>Çoklu kullanıcıya izin veren biraz daha az kullanılan başka bir
yol daha mevcuttur. Bir gurup dosyası oluşturmaktansa, şu yönergeyi
kullanabilirsiniz:</p>
<pre class="prettyprint lang-config">Require valid-user</pre>
<p><code>Require user umut</code> satırı ile parola dosyasında
listelenmiş ve parolayı doğru olarak giren herhangi bir kişiye izin
vermektense, her grup için ayrı bir parola dosyası tutarak grup
davranışını taklit edebilirsiniz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="possibleproblems" id="possibleproblems">Olası Sorunlar</a></h2>
<p>Temel kimlik doğrulama yolu belirtildiği için, sunucuya
yaptığınız her belge istediğinde kullanıcı adınızın ve parolanızın
doğrulanması gerekir. Hatta aynı sayfayı yeniden yüklerken ya da
sayfadaki her bir resim için bu yapılmalıdır (şayet korunmakta olan
bir dizinden geliyorsa). Bu işlem hızı azaltacaktır. Yavaşlama
miktarı parola dosyanızın büyüklüğü ile orantılı olacaktır, çünkü bu
işlem sırasında dosya açılacak ve kullanıcıların arasında isminiz
bulunana kadar liste aşağı doğru taranacaktır. Bu işlem sayfa her
yüklenişinde tekrar edilecektir.</p>
<p>Buradan çıkacak sonuç, bir parola dosyasına konulan kullanıcı
sayısında bir üst sınır olması gerekliliğidir. Bu sınır sunucunuzun
başarımına bağlı olarak değişiklik gösterir. Bir kaç yüz kayıtın
üstünde giriş yaptığınızda hız düşüşünü gözlemlebilirsiniz İşte bu
anda kimlik doğrulama için başka bir yöntem aramaya başlarsınız.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="dbmdbd" id="dbmdbd">Diğer parola depolama yöntemleri</a></h2>
<p>Parolaları basit bir metin dosyasında depolamak yukarıda
bahsedilen sorunlara yol açtığından parolaları başka bir yerde
depolamayı düşünebilirsiniz; örneğin bir veritabanında.</p>
<p><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> ve <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>
modülleri bunu mümkün kılan iki modüldür. Depolama yönemi olarak
<code><code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> file</code> yerine, <code>dbm</code>
veya <code>dbd</code> kullanabilirsiniz.</p>
<p>Bir metin dosyası yerine bir dbm dosyası kullanım örneği:</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider dbm
AuthDBMUserFile "/www/passwords/passwd.dbm"
Require valid-user
</Directory></pre>
<p>Başka seçenekler de mümkündür. Ayrınılar için
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> belgesine başvurun.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="multprovider" id="multprovider">Birden çok tedarikçi kullanmak</a></h2>
<p>Kimlik doğrulama ve yetkilendirme mimarisine dayalı yeni
tedarikçiyi kullanarak tek bir yetkilendirme ya da kimlik doğrulama
yöntemine kilitlenip kalmayacaksınız. Aslında birden çok tedarikçi
ihtiyacınıza cevap vermek için bir arada kullanılabilir. Aşağıdaki
örnekte dosya ve LDAP tabanlı kimlik doğrulama tedarikçileri bir
arada kullanılmıştır.</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider file ldap
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthLDAPURL ldap://ldaphost/o=yourorg
Require valid-user
</Directory></pre>
<p>Bu örnekte dosya tedarikçisi, ilk olarak kullanıcının kimliğini
doğrulamaya teşebbüs edecektir. Kullanıcının kimliği
doğrulanamıyorsa LDAP tedarikçisi çağırılır. Eğer kurumunuz birden
çok kimlik doğrulama tedarikçisini yürürlüğe koyuyorsa bu, kimlik
doğrulama faaliyet alanının genişletilmesini sağlar. Diğer kimlik
kanıtlama ve yetkilendirme senaryoları tek bir kimlik doğrulaması
ile birden fazla yetkilendirme türüne izin verebilir.</p>
<p>Çok sayıda kimlik doğrulama tedarikçisi uygulamaya konulabileceği
gibi, çok sayıda yetkilendirme yöntemi de kullanılabilir. Bu örnekte
dosya için hem dosyalı hem de LDAP grup kimlik doğrulaması
kullanılmıştır.</p>
<pre class="prettyprint lang-config"><Directory "/www/docs/private">
AuthName "Private"
AuthType Basic
AuthBasicProvider file
AuthUserFile "/usr/local/apache/passwd/passwords"
AuthLDAPURL ldap://ldaphost/o=yourorg
AuthGroupFile "/usr/local/apache/passwd/groups"
Require group GroupName
Require ldap-group cn=mygroup,o=yourorg
</Directory></pre>
<p>Kimlik doğrulama konusunu biraz daha genişletirsek, <code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code> ve
<code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code> gibi yetkilendirme taşıyıcısı
yönergelerle hangi iznin hangi sırayla uygulanacağını
belirlenebilir. <a href="../mod/mod_authz_core.html#logic">Yetkilendirme Taşıyıcıları</a> bölümünde bunun bir uygulama
örneğini görebilirsiniz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="beyond" id="beyond">Yetkilendirmenin biraz ötesi</a></h2>
<p>Tek bir veri deposundan yapılacak tek bir sınamadan çok daha
esnek kimlik doğrulaması yapılabilir. Sıralama, mantık ve hangi
kimlik doğrulamasının kullanılacağını seçmek mümkündür.</p>
<h3><a name="authandororder" id="authandororder">Mantık ve sıralamanın uygulanması</a></h3>
<p>Yetkilendirmenin hangi sırayla uygulanacağı ve nasıl
denetleneceği geçmişte biraz gizemli bir konuydu. Apache 2.2'de,
tedarikçi tabanlı kimlik doğrulamasının devreye girmesiyle asıl
kimlik doğrulama işlemini yetkilendirme ve destek işlevselliğinden
ayırmak mümkün oldu. Bunun faydalarından birisi de kimlik
doğrulama tedarikçilerinin yapılandırılabilmesi ve auth modülünün
kendi yükleme sırasından bağımsız olarak özel bir sırayla
çağrılabilmesidir. Bu tedarikçi tabanlı mekanizmanın aynısı
yetkilendirmeye de getirilmiştir. Bunun anlamı <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> yönergesinde hangi
izin yönteminin kullanılması gerektiğinin belirtmesinin yanında
hangi sırayla çağırılacaklarının da belirlenebildiğidir. Çok
sayıda yetkilendirme yöntemi kullanıldığında, bunlar, <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> yönergelerinin
yapılandırma dosyasında göründükleri sıra ile çağırılır.</p>
<p><code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code> ve <code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code> gibi yetkilendirme
taşıyıcısı yönergelerin devreye girmesiyle yetkilendirme
yöntemlerinin ne zaman çağırılacağı ve çağırıldığında ve erişime
izin verirken hangi kuralların uygulanacağı konusunda denetim
yapılandırmanın eline geçmektedir. Karmaşık yetkilendime mantığını
ifade etmek için kullanılan bir örneği görmek için
<a href="../mod/mod_authz_core.html#logic">Yetkilendirme
Taşıyıcıları</a> bölümüne bakınız.</p>
<p>Öntanımlı olarak tüm <code class="directive"><a href="../mod/mod_authz_core.html#require">
Require</a></code> yönergeleri, <code class="directive"><a href="../mod/mod_authz_core.html#requireany"><RequireAny></a></code>
taşıyıcı yönergesinin içine konur. Başka bir deyişle eğer
belirtilen kimlik doğrulama yöntemlerinden herhangi biri başarılı
olursa yetkilendirme de sağlanmış olur.</p>
<h3><a name="reqaccessctrl" id="reqaccessctrl">Erişim denetimi için yetkilendirme tedarikçilerinin
kullanımı</a></h3>
<p>Kullanıcı adı ve parolasına göre kimlik doğrulama hikayenin
sadece bir bölümüdür. Sıklıkla insanlara kim olduklarına göre
değil birşeylere dayanarak izin vermek istersiniz. Örneğin nereden
geldikleri gibi.</p>
<p><code>all</code>, <code>env</code>, <code>host</code> ve
<code>ip</code> gibi yetkilendirme tedarikçileri ile, bir belgenin
istendiği makinenin IP adresi veya konak ismi gibi bazı özelliklerine
dayalı olarak erişime izin verip vermeyeceğinizi belirtebilirsiniz.</p>
<p>Bu tedarikçilerin kullanımı <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> yönergesinde açıklanmıştır. Bu yönergeler,
isteklerin işlenmesi sırasında yetkilendirme aşamasında
çağırılacak yetkilendirme tedarikçilerini kayda geçirir. Örneğin:
</p>
<pre class="prettyprint lang-config">Require ip <var>adres</var>
</pre>
<p>Burada, <var>adres</var> bir IP adresidir (veya kısmi bir IP
addresidir)</p>
<pre class="prettyprint lang-config">Require host <var>alan_adı</var>
</pre>
<p>Burada, <var>alan_adı</var> bir tam nitelikli alan adıdır
(ya da kısmi alan adıdır); gerekirse çok sayıda alan adı veya IP
adresi de belirtilebilir.</p>
<p>Örneğin, yorum alanını gereksiz iletilerle dolduran birini uzak
tutmak istediğinizi varsayalım. Bu kişiyi uzak tutmak için şunları
yapabilirsiniz:</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not ip 10.252.46.165
</RequireAll></pre>
<p>Bu adresden gelen ziyaretçiler bu yönergedeki içeriği
göremeyeceklerdir. Bunun yerine, elinizde IP adresi değil de
makine adı varsa şunu kullanabilirsiniz:</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not host host.example.com
</RequireAll></pre>
<p>Eğer alan adının tamanıdan gelecek olan bütün erişimleri
engellemek isterseniz adresin ya da alan adının bir parçasını
belirtin:</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not ip 192.168.205
Require not host phishers.example.com moreidiots.example
Require not host ke
</RequireAll></pre>
<p><code class="directive"><a href="../mod/mod_authz_core.html#requireall"><RequireAll></a></code> yönergesini çok sayıda
<code class="directive"><a href="../mod/mod_authz_core.html#require"><Require></a></code> yönergesi ile birlikte kullanarak,
sadece <code>not</code> ile olumsuzlanan tüm koşulları gerçekleyen
bağlantılara erişim verilir. Başka bir deyişle, olumsuzlanan koşulları
gerçeklemeyen bağlantıların erişimi engellenir.</p>
<h3><a name="filesystem" id="filesystem">Erişim denetimi ve geriye uyumluluk</a></h3>
<p>Kimlik doğrulama için tedarik tabanlı mekanizma kullanımının
yan etkilerinden birisi,
<code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> ve
<code class="directive"><a href="../mod/mod_access_compat.html#satisfy">Satisfy</a></code> erişim
denetim yönergelerine artık ihtiyaç duyulmamasıdır. Ancak eski
yapılandırmalarla uyumluluğu sağlamak için bu yönergeler
<code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> modülüne taşınmıştır.</p>
<div class="warning"><h3>Note</h3>
<p><code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> ile sağlanan yönergelerin
kullanımı artık önerilmemekte, <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>
modülündeki yönergeler önerilmektedir. <code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>, <code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code> veya <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> ile
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> gibi daha yeni
olanlarının yenilerle karışık kullanımı teknik olarak mümkünse de
önerilmemektedir. <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> modülü, 2.4
yükseltmesini kolaylaştırmak için sadece eski yönergeleri içeren
yapılandırmaları desteklemek üzere oluşturulmuştur. Daha ayrıntılı
bilgi için <a href="../upgrading.html">yükseltme</a> belgesine bakınız.
</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="socache" id="socache">Kimlik Doğrulama Arabelleği</a></h2>
<p>Zaman zaman kimlik doğrulama ağınızda veya sağlayıcı(ları)nızda kabul
edilemez yükler oluşturur. Bu çoğunlukla <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>
(veya üçüncü parti/özel sağlayıcıların) kullanıcılarını etkiler. Bununla
ilgilenmek için httpd 2.3/2.4, kimlik bilgilerini arabelleklemek ve özgün
sağlayıcıların yüklerini azaltmak için yeni bir arabellekleme sağlayıcısı
olarak <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code> modülü ile gelmektedir.</p>
<p>Bu, bazı kullanıcılar için önemli bir başarım artışı sağlayabilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinformation" id="moreinformation">Daha fazla bilgi</a></h2>
<p>Daha fazla bilgi için <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> ve
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> modüllerinin belgelerine bakınız.
<code class="directive"><a href="../mod/mod_authn_core.html#authnprovideralias">AuthnProviderAlias</a></code>
yönergesi ile bazı yapılandırmalarınızı basitleştirebilirsiniz.</p>
<p>Apache tarafından desteklenen şifrelerle ilgili bilgi için <a href="../misc/password_encryptions.html">Parola Biçemleri</a>
belgesine bakınız.</p>
<p><a href="access.html">Erişim Denetimi</a> nasıl belgesinden de
bazı bilgiler edinebilirsiniz.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/auth.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/auth.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/htaccess.html.es 0000664 0001751 0001751 00000073135 14743132254 021276 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Tutorial del Servidor Apache HTTP: Ficheros .htaccess - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="../images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a> > <a href="./">How-To / Tutoriales</a></div><div id="page-content"><div id="preamble"><h1>Tutorial del Servidor Apache HTTP: Ficheros .htaccess</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
</div>
<p>Los ficheros <code>.htaccess</code> facilitan una forma de realizar
cambios en la configuración en contexto directorio.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Ficheros .htaccess</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what">Qué son/Cómo usarlos</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#when">Cuando (no) usar ficheros .htaccess</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#how">How directives are applied</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#auth">Ejemplo de Autenticación</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ssi">Ejemplo de Server Side Includes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewrite">Reglas de Rewrite en ficheros .htaccess</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">Ejemplo de CGI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">Resolución de problemas</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</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="related" id="related">Ficheros .htaccess</a></h2>
<table class="related"><tr><th>Módulos Relacionados</th><th>Directivas Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</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_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</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/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li></ul></td></tr></table>
<div class="note">Debería evitar usar ficheros <code>.htaccess</code> completamente si
tiene acceso al fichero de configuración principal de httpd. Usar ficheros
<code>.htaccess</code> ralentiza su servidor Apache http. Cualquier
directiva que pueda incluir en un fichero <code>.htaccess</code>
estará mejor configurada dentro de una sección
<code class="directive"><a href="../mod/core.html#directory">Directory</a></code>, tendrá el mismo efecto y
mejor rendimiento.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">Qué son/Cómo usarlos</a></h2>
<p>Los ficheros <code>.htaccess</code> (o "ficheros de configuración
distribuida") facilitan una forma de realizar cambios en la configuración
en contexto directorio. Un fichero, que contiene una o más directivas, se
coloca en un documento específico de un directorio, y estas directivas
aplican a ese directorio y todos sus subdirectorios.</p>
<div class="note"><h3>Nota:</h3>
<p>Si quiere llamar a su fichero <code>.htaccess</code> de otra manera,
puede cambiar el nombre del fichero usando la directiva <code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code>. Por ejemplo, si usted prefiere
llamar al fichero <code>.config</code>, entonces puede poner lo siguiente
en el fichero de configuración de su servidor:</p>
<pre class="prettyprint lang-config">AccessFileName ".config"</pre>
</div>
<p>Generalmente, los ficheros <code>.htaccess</code> usan la misma sintáxis
que los <a href="../configuring.html#syntax">ficheros de la configuración
principal</a>. Lo que puede utilizar en estos ficheros lo determina la
directiva <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>. Esta directiva
especifica, en categorías, qué directivas tendrán efecto si se encuentran en
un fichero <code>.htaccess</code>. Si se permite una directiva en un fichero
<code>.htaccess</code>, la documentación para esa directiva contendrá una
sección Override, especificando qué valor debe ir en
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> para que se permita esa
directiva.</p>
<p>Por ejemplo, si busca en la documentación la directiva <code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>, encontrará que se permite en
ficheros <code>.htaccess</code>. (Vea la línea de Contexto en el sumario de
la directiva.) La línea <a href="../mod/directive-dict.html#Context">Override</a> muestra
<code>FileInfo</code>. De este modo, debe tener al menos
<code>AllowOverride FileInfo</code> para que esta directiva se aplique en
ficheros <code>.htaccess</code>.</p>
<div class="example"><h3>Ejemplo:</h3><table>
<tr>
<td><a href="../mod/directive-dict.html#Context">Context:</a></td>
<td>server config, virtual host, directory, .htaccess</td>
</tr>
<tr>
<td><a href="../mod/directive-dict.html#Override">Override:</a></td>
<td>FileInfo</td>
</tr>
</table></div>
<p>Si no está seguro de cuándo, una directiva en concreto, se puede usar en un
fichero <code>.htaccess</code>, consulte la documentación para esa directiva,
y compruebe la línea Context buscando ".htaccess".</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="when" id="when">Cuando (no) usar ficheros .htaccess</a></h2>
<p>Generalmente, solo debería usar ficheros <code>.htaccess</code> cuando no
tiene acceso al fichero principal de configuración del servidor. Hay, por
ejemplo, una creencia errónea de que la autenticación de usuario debería
hacerse siempre dentro de ficheros <code>.htaccess</code>, y, más recientemente, otra creencia errónea de que las directivas de
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> deben ir en ficheros <code>.htaccess</code>.
Esto sencillamente no es el caso. Puede poner las configuraciones de
autenticación de usuario en la configuración principal del servidor, y esto
es de hecho, el método preferido de configurar Apache. Del mismo modo, las
directivas <code>mod_rewrite</code> funcionan mejor, en muchos sentidos, en
el fichero de configuración principal del servidor.</p>
<p>Los ficheros <code>.htaccess</code> deberían usarse cuando su proveedor
de contenidos le permite hacer modificaciones de configuración
en contexto directorio, pero usted no tiene acceso de root en el servidor.
En el caso de que el administrador no esté dispuesto a hacer cambios
frecuentes en la configuración, puede que sea necesario permitir a usuarios
individuales realizar estos cambios de configuración en ficheros
<code>.htaccess</code> por ellos mismos. Lo cual ocurre a menudo, por
ejemplo, en casos donde los ISP están albergando múltiples sitios web de
usuario en una sola máquina, y quieren que sus usuarios tengan la
posibilidad de modificar sus configuraciones.</p>
<p>Aun así, generalmente, el uso de ficheros <code>.htaccess</code> debería
evitarse cuando sea posible. Cualquier configuración que consideraría poner
en un fichero <code>.htaccess</code>, puede usarse con la misma efectividad
en una sección <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> en el fichero de configuración
del servidor.</p>
<p>Hay dos razones para evitar el uso de ficheros <code>.htaccess</code>.</p>
<p>La primera es el rendimiento. Cuando <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
está configurado para permitir el uso de ficheros <code>.htaccess</code>,
httpd buscará ficheros <code>.htaccess</code> en cada directorio. Así,
permitiendo ficheros <code>.htaccess</code> provoca una pérdida de
rendimiento, ¡incluso aunque no los use! Además, los ficheros
<code>.htaccess</code> se cargan cada vez que se solicita un documento.</p>
<p>Además tenga en cuenta que httpd debe buscar ficheros
<code>.htaccess</code> en todos los directorios de mayor jerarquía,
para poder terner la lista completa de directivas que debe aplicar. (Vea
la sección sobre <a href="#how">Cómo se aplican las directivas</a>.) Así, si
se solicita un fichero de un directorio <code>/www/htdocs/example</code>,
httpd debe buscar los siguientes ficheros:</p>
<div class="example"><p><code>
/.htaccess<br />
/www/.htaccess<br />
/www/htdocs/.htaccess<br />
/www/htdocs/example/.htaccess
</code></p></div>
<p>De esta manera, por cada acceso a un fichero de ese directorio, hay 4
accesos adicionales al sistema de ficheros, incluso si ninguno de esos
ficheros está presente. (Tenga en cuenta que este caso solo se daría si los
ficheros <code>.htaccess</code> están activados en <code>/</code>, que
generalmente no es el caso.).</p>
<p>En el caso de las directivas <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, en el contexto de
<code>.htaccess</code> estas expresiones regulares deben recompilarse con
cada solicitud a ese directorio, cuando en el contexto de configuración del
servidor solo se compilan una vez y se cachean. Adicionalmente, las reglas
en sí mismas son más complicadas, puesto que uno debe sortear las
restricciones que vienen acompañadas del contexto directorio y
<code>mod_rewrite</code>. Consulte la <a href="../rewrite/intro.html#htaccess">Guía de Rewrite</a> para un mayor
detalle sobre este tema.</p>
<p>La segunda consideración es de seguridad. Estará permitiendo que usuarios
modifiquen la configuración del servidor, lo cual puede dar lugar a cambios sobre los que usted no tendrá ningún control. Medite profundamente si debe
dar a sus usuarios ese privilegio. Además tenga en cuenta que dar a los usuarios menos privilegios de los que necesitan dará lugar a más peticiones
de soporte. Asegúrese de que le indica a sus usuarios claramente el nivel de privilegios que les está dando. Especificando exactamente cómo ha
configurado <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>, e invíteles
a revisar la documentación relacionada, lo cual le ahorrará
bastantes confusiones más adelante.</p>
<p>Tenga en cuenta que esto es equivalente por completo a poner un fichero
<code>.htaccess</code> en un directorio <code>/www/htdocs/example</code>
con una directiva, y poner la misma directiva en una sección
Directory <code><Directory "/www/htdocs/example"></code> en su
configuración principal del servidor:</p>
<p>Fichero <code>.htaccess</code> en <code>/www/htdocs/example</code>:</p>
<div class="example"><h3>Contenido de fichero .htaccess en
<code>/www/htdocs/example</code></h3><pre class="prettyprint lang-config">AddType text/example ".exm"</pre>
</div>
<div class="example"><h3>Sección de su fichero <code>httpd.conf</code></h3><pre class="prettyprint lang-config"><Directory "/www/htdocs/example">
AddType text/example ".exm"
</Directory></pre>
</div>
<p>Aun así, poniendo ésta en el fichero de configuración dará como resultado
una menor pérdida de rendimiento, y como la configuración se carga una vez
cuando el httpd arranca, en lugar de cada vez que se solicita un fichero.</p>
<p>El uso de ficheros <code>.htaccess</code> puede desactivarse por completo
configurando la directiva <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
a <code>none</code>:</p>
<pre class="prettyprint lang-config">AllowOverride None</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="how" id="how">How directives are applied</a></h2>
<p>Las directivas de configuración que se encuentran en el fichero
<code>.htaccess</code> se aplican al directorio en el que el fichero
<code>.htaccess</code> se encuentra, y a todos sus subdirectorios. Sin
embargo, es importante recordar que puede haber otros ficheros
<code>.htaccess</code> en directorios previos. Las directivas se aplican en
el orden en el que se encuentran. Por lo tanto, un fichero
<code>.htaccess</code> puede sobrescribir directivas que se encuentran
en ficheros <code>.htaccess</code> que se encuentran en directorios previos
del árbol de directorios. Y estos, en cambio, pueden haber sobrescrito
directivas que se encontraban más arriba, o en el fichero principal de
configuración del servidor mismo.</p>
<p>Ejemplo:</p>
<p>En el directorio <code>/www/htdocs/example1</code> tenemos un fichero
<code>.htaccess</code> que contiene lo siguiente:</p>
<pre class="prettyprint lang-config">Options +ExecCGI</pre>
<p>(Nota: debe terner "<code>AllowOverride Options</code>" configurado para
permitir el uso de la directiva "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" en ficheros
<code>.htaccess</code> files.)</p>
<p>En el directorio <code>/www/htdocs/example1/example2</code> tenemos un
fichero <code>.htaccess</code> que contiene:</p>
<pre class="prettyprint lang-config">Options Includes</pre>
<p>Por este segundo fichero <code>.htaccess</code>, en el directorio
<code>/www/htdocs/example1/example2</code>, la ejecución de CGI execution no
está permitida, porque solo se ha definido <code>Options Includes</code>,
que sobrescribe completamente una configuración previa que se pudiera haber
definido.</p>
<h3><a name="merge" id="merge">Incorporando el .htaccess en los ficheros de
configuración principal</a></h3>
<p>Como se ha comentado en la documentación en las <a href="../sections.html">Secciones de Configuración</a>, los ficheros
<code>.htaccess</code> pueden sobrescribir las secciones <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> por el directorio
correspondiente, pero se sobrescribirán por otros tipos de secciones de
configuración de los ficheros de configuración principal. Este hecho se
puede usar para forzar ciertas configuraciones, incluso en presencia
de una configuración laxa de
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>. Por ejemplo, para
prevenir la ejecución de un script mientras se permite cualquier otra cosa
en <code>.htaccess</code> puede usar:</p>
<pre class="prettyprint lang-config"><Directory "/www/htdocs">
AllowOverride All
</Directory>
<Location "/">
Options +IncludesNoExec -ExecCGI
</Location></pre>
<div class="note">Este ejemplo asume que su <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> es <code>/www/htdocs</code>.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="auth" id="auth">Ejemplo de Autenticación</a></h2>
<p>Si saltó directamente a esta parte del documento para averiguar como
hacer la autenticación, es important que tenga en cuenta una cosa. Hay una
creencia errónea de que necesita usar ficheros <code>.htaccess</code> para
configurar autenticación con contraseña. Este no es el caso. Colocar las
directivas de autenticación en una sección
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, en su fichero
de configuración principal, es el método recomendado para configurar esto,
y los ficheros <code>.htaccess</code> deberían usarse solamente si no tiene
acceso al fichero de configuración principal del servidor. Vea <a href="#when">más arriba</a> una explicación de cuando debería y cuando no
debería usar ficheros <code>.htaccess</code>.</p>
<p>Dicho esto, si todavía cree que debe usar el fichero
<code>.htaccess</code>, podrá ver que una configuración como la que sigue
podría servirle.</p>
<p>Contenido del fichero <code>.htaccess</code>:</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "Password Required"
AuthUserFile "/www/passwords/password.file"
AuthGroupFile "/www/passwords/group.file"
Require group admins</pre>
<p>Tenga en cuenta que <code>AllowOverride AuthConfig</code> debe estar
habilitado para que estas directivas tengan algún efecto.</p>
<p>Por favor vea el <a href="auth.html">tutorial de autenticación</a> para
una explicación más completa de la autenticación y la autorización.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ssi" id="ssi">Ejemplo de Server Side Includes</a></h2>
<p>Otro uso común de ficheros <code>.htaccess</code> es activar Server Side
Includes para un directorio en particular. Esto puede hacerse
con las siguientes directivas de configuración, colocadas en un fichero
<code>.htaccess</code> y el directorio deseado:</p>
<pre class="prettyprint lang-config">Options +Includes
AddType text/html "shtml"
AddHandler server-parsed shtml</pre>
<p>Tenga en cuenta que <code>AllowOverride Options</code> y
<code>AllowOverride FileInfo</code> deben estar activadas para que estas
directivas tengan efecto.</p>
<p>Por favor vea el <a href="ssi.html">tutorial de SSI</a> para una
explicación más completa de server-side includes.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">Reglas de Rewrite en ficheros .htaccess</a></h2>
<p>Cuando use <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> en
ficheros <code>.htaccess</code>, tenga en cuenta que el contexto
directorio cambia las cosas un poco. En concreto, las reglas son
relativas al directorio actual, en lugar de serlo de la petición de URI
solicitada originalmente.
Considere los siguientes ejemplos:</p>
<pre class="prettyprint lang-config"># En httpd.conf
RewriteRule "^/images/(.+)\.jpg" "/images/$1.png"
# En .htaccess en el directorio raíz
RewriteRule "^images/(.+)\.jpg" "images/$1.png"
# En .htaccess en images/
RewriteRule "^(.+)\.jpg" "$1.png"</pre>
<p>En un <code>.htaccess</code> en cualquier directorio del DocumentRoot, la
barra ("/") inicial se elimina del valor facilitado a <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, y en el subdirectorio
<code>images</code>, se elimina <code>/images/</code> también de este valor.
Así, su expresión regular necesita omitir también esa parte.</p>
<p>Consulte la <a href="../rewrite/">documentación de mod_rewrite</a> para
más detalles al usar <code>mod_rewrite</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">Ejemplo de CGI</a></h2>
<p>Finalmente, puede que quiera usar un fichero <code>.htaccess</code> para
permitir la ejecución de programas CGI en un directorio en particular. Esto
se puede implementar con la siguiente configuración:</p>
<pre class="prettyprint lang-config">Options +ExecCGI
AddHandler cgi-script "cgi" "pl"</pre>
<p>Alternativamente, si quiere considerar como programas CGI todos los
ficheros de un directorio concreto, esto se puede conseguir con la siguiente
configuración:</p>
<pre class="prettyprint lang-config">Options +ExecCGI
SetHandler cgi-script</pre>
<p>Tenga en cuenta que <code>AllowOverride Options</code> y
<code>AllowOverride FileInfo</code> deben estar ambas activadas para que
estas directivas tengan efecto.</p>
<p>Por favor vea el <a href="cgi.html">tutorial CGI</a> para mayor detalle
sobre programación y configuración de CGI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot">Resolución de problemas</a></h2>
<p>Cuando pone directivas en un fichero <code>.htaccess</code> y no obtiene
el efecto deseado hay una serie de cosas que pueden haber ido mal.</p>
<p>El problema más común es que <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride
</a></code> no está configurada para que sus directivas puedan surtir
efecto. Asegúrese de que no tiene <code>AllowOverride None</code>
configurado para el directorio en cuestión. Una buena forma de probar esto
es poner "basura" en su fichero <code>.htaccess</code> y recargar la página.
Si no se genera un error en el servidor, casi seguro que tiene configurado
<code>AllowOverride None</code>.</p>
<p>Si, por otro lado, obtiene errores de servidor al intentar acceder a
documentos, compruebe el log de errores de httpd. Seguramente le indiquen
que la directiva en uso en su fichero <code>.htaccess</code> no está
permitida.</p>
<div class="example"><p><code>
[Fri Sep 17 18:43:16 2010] [alert] [client 192.168.200.51] /var/www/html/.htaccess: DirectoryIndex not allowed here
</code></p></div>
<p>Esto indicará que o bien ha usado una directiva que no se permite nunca
en ficheros <code>.htaccess</code>, o que simplementa no tiene
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> configurado
a un nivel suficiente para la directiva que ha usado. Consulte la
documentación para esa directiva en particular para determinar cual es el
caso.</p>
<p>Alternativamente, puede que le indique que hay un error de sintaxis en
el uso de la propia directiva.</p>
<div class="example"><p><code>
[Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
</code></p></div>
<p>En este caso, el mensaje de error debería ser específico para el error de
sintaxis concreto que ha cometido.</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/htaccess.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/http2.html.es 0000664 0001751 0001751 00000071241 14743132254 020536 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Guía HTTP/2 - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="../images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a> > <a href="./">How-To / Tutoriales</a></div><div id="page-content"><div id="preamble"><h1>Guía HTTP/2</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/http2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/http2.html" title="Español"> es </a> |
<a href="../fr/howto/http2.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<div class="outofdate">Esta traducción podría estar
obsoleta. Consulte la versión en inglés de la
documentación para comprobar si se han producido cambios
recientemente.</div>
<p>
Esta es la guía para configurar HTTP/2 en Apache httpd. Ésta característica
está <em>lista en produción</em> así que es de esperar que las interfaces
y las directivas se mantengan consistentes en cada verión.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#protocol">El protocolo HTTP/2</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#implementation">HTTP/2 en Apache httpd</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#building">Compilar httpd con soporte HTTP/2</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#basic-config">Configuración básica</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mpm-config">Configuración MPM</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#clients">Clientes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#tools">Herramientas útiles para depurar HTTP/2</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#push">Server Push</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#earlyhints">"Early Hints"</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code></li><li><a href="#comments_section">Comentarios</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="protocol" id="protocol">El protocolo HTTP/2</a></h2>
<p>HTTP/2 es la evolución del protocolo de la capa de aplicación con más
éxito, HTTP. Se centra en hacer un uso más eficiente de los recursos de red.
No cambia la característica fundamental de HTTP, la semántica. Todavía hay
olicitudes, respuestas, cabeceras y todo los elementos típicos de HTTP/1. Así
que, si ya conoce HTTP/1, también conoce el 95% de HTTP/2.</p>
<p>Se ha escrito mucho sobre HTTP/2 y de cómo funciona. La norma más
estándar es, por supuesto, su
<a href="https://tools.ietf.org/html/rfc7540">RFC 7540</a>
(<a href="http://httpwg.org/specs/rfc7540.html"> también disponible en un
formato más legible, YMMV</a>). Así que, ahí encontrará toda la especificación
del protocolo.</p>
<p>Pero, como con todos los RFC, no es ideal como primera lectura. Es mejor
entender primero <em>qué</em> se quiere hacer y después leer el RFC sobre
<em>cómo</em> hacerlo. Un documento mucho mejor con el que empezar es
<a href="https://daniel.haxx.se/http2/">http2 explicado</a>
por Daniel Stenberg, el autor de <a href="https://curl.haxx.se">curl</a>.
¡También está disponible cada vez en un mayor número lenguajes!</p>
<p>Si le parece demasiado largo, o no lo ha leido, hay algunos términos
y elementos a tener en cuenta cuando lea este documento:</p>
<ul>
<li>HTTP/2 es un <strong>protocolo binario</strong>, al contrario que
HTTP 1.1 que es texto plano. La intención para HTTP 1.1 es que sea
legible (por ejemplo capturando el tráfico de red) mientras que para
HTTP/2 no. Más información en el FAQ oficial
<a href="https://http2.github.io/faq/#why-is-http2-binary">¿Por qué es
binario HTTP/2?</a></li>
<li><strong>h2</strong> es HTTP/2 sobre TLS (negociación de protocolo a
través de ALPN).</li>
<li><strong>h2c</strong> es HTTP/2 sobre TCP.</li>
<li>Un <strong>frame</strong> es la unidad más pequeña de comunicación
dentro de una conexión HTTP/2, que consiste en una cabecera y una secuencia
de octetos de longitud variable estructurada de acuerdo con el tipo de
frame. Más información en la documentación oficial
<a href="http://httpwg.org/specs/rfc7540.html#FramingLayer">Sección de
Capa de Frame</a>.</li>
<li>Un <strong>stream</strong> es un flujo bidireccional de frames dentro
de una conexión HTTP/2. El concepto correspondiente en HTTP 1.1 es un
intercambio de mensajes de solicitud/respuesta. Más información en la
documentación oficial
<a href="http://httpwg.org/specs/rfc7540.html#StreamsLayer">Sección Capa
de Stream</a>.</li>
<li>
HTTP/2 es capaz de llevar <strong>múltiples streams</strong> de datos
sobre la misma conexión TCP, evitando la clásica solicitud lenta
"head-of-line blocking" de HTTP 1.1 y evitando generar múltiples conexiones
TCP para cada solicitud/respuesta (KeepAlive parcheó el problema en
HTTP 1.1 pero no lo resolvió completamente).
</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="implementation" id="implementation">HTTP/2 en Apache httpd</a></h2>
<p>
El protocolo HTTP/2 se implementa con su propio módulo httpd, llamado
acertadamente <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code>. Incluye el set completo de
características descritas por el RFC 7540 y soporta HTTP/2 sobre texto
plano (http:), así como conexiones seguras (https:). La variante de texto
plano se llama '<code>h2c</code>', la segura '<code>h2</code>'. Para
<code>h2c</code> permite el modo <em>direct</em>
y el <code>Upgrade:</code> a través de una solicitud inicial HTTP/1.
</p>
<p>
Una característica de HTTP/2 que ofrece capacidades nuevas para
desarrolladores de web es <a href="#push">Server Push</a>. Vea esa sección
para saber como su aplicación web puede hacer uso de ella.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="building" id="building">Compilar httpd con soporte HTTP/2</a></h2>
<p>
<code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> usa la librería <a href="https://nghttp2.org">
nghttp2</a>como su implementación base. Para compilar
<code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> necesita al menos la versión 1.2.1 de
<code>libnghttp2</code> instalada en su sistema.
</p>
<p>
Cuando usted ejecuta <code>./configure</code> en el código fuente de
Apache HTTPD, necesita indicarle '<code>--enable-http2</code>' como una
opción adicional para activar la compilación de este módulo. Si su
<code>libnghttp2</code> está ubicado en una ruta no habitual (cualquiera que
sea en su sistema operativo), puede indicar su ubicación con
'<code>--with-nghttp2=<path></code>' para <code>./configure</code>.
</p>
<p>Aunque puede que eso sirva para la mayoría, habrá quien prefiera un <code>nghttp2</code> compilado estáticamente para este módulo. Para ellos existe la opción <code>--enable-nghttp2-staticlib-deps</code>. Funciona de manera muy similar a como uno debe enlazar openssl estáticamente para <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.</p>
<p>Hablando de SSL, necesita estar al tanto de que la mayoría de los navegadores hablan HTTP/2 solo con URLs <code>https:</code>. Así que necesita un servidor con soporte SSL. Pero no solo eso, necesitará una librería SSL que de soporte a la extensión <code>ALPN</code>. Si usa OpenSSL, necesita al menos la versión 1.0.2.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="basic-config" id="basic-config">Configuración básica</a></h2>
<p>Cuando tiene un <code>httpd</code> compilado con <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> necesita una configuración básica para activarlo. Lo primero, como con cualquier otro módulo de Apache, es que necesita cargarlo:</p>
<pre class="prettyprint lang-config">LoadModule http2_module modules/mod_http2.so</pre>
<p>La segunda directiva que necesita añadir a la configuración de su servidor es:</p>
<pre class="prettyprint lang-config">Protocols h2 http/1.1</pre>
<p>Esto permite h2, la variante segura, para ser el protocolo preferido de las conexiones en su servidor. Cuando quiera habilitar todas las variantes de HTTP/2, entonces simplemente configure:</p>
<pre class="prettyprint lang-config">Protocols h2 h2c http/1.1</pre>
<p>Dependiendo de dónde pone esta directiva, afecta a todas las conexiones o solo a las de ciertos host virtuales. La puede anidar, como en:</p>
<pre class="prettyprint lang-config">Protocols http/1.1
<VirtualHost ...>
ServerName test.example.org
Protocols h2 http/1.1
</VirtualHost></pre>
<p>Esto solo permite HTTP/1, excepto conexiones SSL hacia <code>test.example.org</code> que ofrecen HTTP/2.</p>
<div class="note"><h3>Escoger un SSLCipherSuite seguro</h3>
<p>Es necesario configurar <code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code> con una suite segura de cifrado TLS. La versión actual de mod_http2 no fuerza ningún cifrado pero la mayoría de los clientes si lo hacen. Encaminar un navegador hacia un servidor con <code>h2</code> activado con una suite inapropiada de cifrados forzará al navegador a rehusar e intentar conectar por HTTP 1.1. Esto es un error común cuando se configura httpd con HTTP/2 por primera vez, ¡así que por favor tenga en cuenta que debe evitar largas sesiones de depuración! Si quiere estar seguro de la suite de cifrados que escoja, por favor evite los listados en la <a href="http://httpwg.org/specs/rfc7540.html#BadCipherSuites">Lista Negra de TLS para HTTP/2</a>.</p>
</div>
<p>El orden de los protocolos mencionados también es relevante. Por defecto, el primero es el protocolo preferido. Cuando un cliente ofrece múltiples opciones, la que esté más a la izquierda será la escogida. En</p>
<pre class="prettyprint lang-config">Protocols http/1.1 h2</pre>
<p>el protocolo preferido es HTTP/1 y siempre será seleccionado a menos que el cliente <em>sólo</em> soporte h2. Puesto que queremos hablar HTTP/2 con clientes que lo soporten, el orden correcto es:</p>
<pre class="prettyprint lang-config">Protocols h2 h2c http/1.1</pre>
<p>Hay algo más respecto al orden: el cliente también tiene sus propias preferencias. Si quiere, puede configurar su servidor para seleccionar el protocolo preferido por el cliente:</p>
<pre class="prettyprint lang-config">ProtocolsHonorOrder Off</pre>
<p>Hace que el orden en que <em>usted</em> escribió los Protocols sea irrelevante y sólo el orden de preferencia del cliente será decisorio.</p>
<p>Una última cosa: cuando usted configura los protocolos no se comprueba si son correctos o están bien escritos. Puede mencionar protocolos que no existen, así que no hay necesidad de proteger <code class="directive"><a href="../mod/core.html#protocols">Protocols</a></code> con ningún <code class="directive"><a href="../mod/core.html#ifmodule"><IfModule></a></code> de comprobación.</p>
<p>Para más consejos avanzados de configuración, vea la <a href="../mod/mod_http2.html#dimensioning">
sección de módulos sobre dimensionamiento</a> y <a href="../mod/mod_http2.html#misdirected">
como gestionar multiples hosts con el mismo certificado</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="mpm-config" id="mpm-config">Configuración MPM</a></h2>
<p>HTTP/2 está soportado en todos los módulos de multi-proceso que se ofrecen con httpd. Aun así, si usa el mpm <code class="module"><a href="../mod/prefork.html">prefork</a></code>, habrá restricciones severas.</p>
<p>En <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> solo procesará una solicitud cada vez por conexión. Pero los clientes, como los navegadores, enviarán muchas solicitudes al mismo tiempo. Si una de ellas tarda mucho en procesarse (o hace un sondeo que dura más de la cuenta), las otras solicitudes se quedarán atascadas.</p>
<p><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> no evitará este límite por defecto. El motivo es que <code class="module"><a href="../mod/prefork.html">prefork</a></code> hoy en día solo se escoge si ejecuta motores de proceso que no están preparados para multi-hilo, p.ej. fallará con más de una solicitud.</p>
<p>Si su configuración lo soporta, hoy en día <code class="module"><a href="../mod/event.html">event</a></code> es el mejor mpm que puede usar.</p>
<p>Si realmente está obligado a usar <code class="module"><a href="../mod/prefork.html">prefork</a></code> y quiere multiples solicitudes, puede configurar la directiva <code class="directive"><a href="../mod/mod_http2.html#h2minworkers">H2MinWorkers</a></code> para hacerlo posible. Sin embargo, si esto falla, es bajo su cuenta y riesgo.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="clients" id="clients">Clientes</a></h2>
<p>Casi todos los navegadores modernos dan soporte a HTTP/2, pero solo en conexiones SSL: Firefox (v43), Chrome (v45), Safari (since v9), iOS Safari (v9), Opera (v35), Chrome para Android (v49) e Internet Explorer (v11 en Windows10) (<a href="http://caniuse.com/#search=http2">Fuente</a>).</p>
<p>Otros clientes, así cómo otros servidores, están listados en la
<a href="https://github.com/http2/http2-spec/wiki/Implementations">wiki de Implementaciones</a>, entre ellos, implementaciones para c, c++, common lisp, dart, erlang, haskell, java, nodejs, php, python, perl, ruby, rust, scala y swift.</p>
<p>Muchos de las implementaciones de clientes que no son navegadores soportan HTTP/2 sobre texto plano, h2c. La más versátil es <a href="https://curl.haxx.se">curl</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="tools" id="tools">Herramientas útiles para depurar HTTP/2</a></h2>
<p>La primera herramienta a mencionar es por supuesto <a href="https://curl.haxx.se">curl</a>. Por favor asegúrese de que su versión soporta HTTP/2 comprobando sus <code>Características</code>:</p>
<pre class="prettyprint lang-config"> $ curl -V
curl 7.45.0 (x86_64-apple-darwin15.0.0) libcurl/7.45.0 OpenSSL/1.0.2d zlib/1.2.8 nghttp2/1.3.4
Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 [...]
Features: IPv6 Largefile NTLM NTLM_WB SSL libz TLS-SRP <strong>HTTP2</strong>
</pre>
<div class="note"><h3>Notas sobre Mac OS homebrew</h3>
brew install curl --with-openssl --with-nghttp2
</div>
<p>Y para una inspección en gran profundidad <a href="https://wiki.wireshark.org/HTTP2">wireshark</a>.</p>
<p>El paquete <a href="https://nghttp2.org">nghttp2</a> también incluye clientes, tales como:</p>
<ul>
<li><a href="https://nghttp2.org/documentation/nghttp.1.html">nghttp
</a> - util para visualizar la frames de HTTP/2 y tener una mejor idea de como funciona el protocolo.</li>
<li><a href="https://nghttp2.org/documentation/h2load-howto.html">h2load</a> - útil para hacer un stress-test de su servidor.</li>
</ul>
<p>Chrome ofrece logs detallados de HTTP/2 en sus conexiones a través de la <a href="chrome://net-internals/#http2">página especial de net-internals</a>. También hay una extensión interesante para <a href="https://chrome.google.com/webstore/detail/http2-and-spdy-indicator/mpbpobfflnpcgagjijhmgnchggcjblin?hl=en">Chrome</a> y <a href="https://addons.mozilla.org/en-us/firefox/addon/spdy-indicator/">Firefox</a> con la que visualizar cuando su navegador usa HTTP/2.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="push" id="push">Server Push</a></h2>
<p>El protocolo HTTP/2 permite al servidor hacer PUSH de respuestas a un cliente que nunca las solicitó. El tono de la conversación es: "Aquí tiene una solicitud que nunca envió y la respuesta llegará pronto..."</p>
<p>Pero hay restricciones: el cliente puede deshabilitar esta característica y el servidor entonces solo podrá hacer PUSH en una solicitud que hizo previamente del cliente.</p>
<p>La intención es permitir al servidor enviar recursos que el cliente seguramente vaya a necesitar, p. ej. un recurso css o javascript que pertenece a una página html que el cliente solicitó, un grupo de imágenes a las que se hace referencia en un css, etc.</p>
<p>La ventaja para el cliente es que ahorra tiempo para solicitudes que pueden tardar desde unos pocos milisegundos a medio segundo, dependiendo de la distancia entre el cliente y el servidor. La desventaja es que el cliente puede recibir cosas que ya tiene en su cache. Por supuesto que HTTP/2 soporta cancelación previa de tales solicitudes, pero aun así se malgastan recursos.</p>
<p>Resumiendo: no hay una estrategia mejor sobre cómo usar esta característica de HTTP/2 y todo el mundo está experimentando con ella. Así que, ¿cómo experimenta usted con ella en Apache httpd?</p>
<p><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> busca e inspecciona las cabeceras de respuesta
<code>Link</code> con cierto formato:</p>
<pre class="prettyprint lang-config">Link </xxx.css>;rel=preload, </xxx.js>; rel=preload</pre>
<p>
Si la conexión soporta PUSH, estos dos recursos se enviarán al cliente.
Como desarrollador web, puede configurar estas cabeceras o bien
directamente en la respuesta de su aplicación o configurar su servidor con:
</p>
<pre class="prettyprint lang-config"><Location /xxx.html>
Header add Link "</xxx.css>;rel=preload"
Header add Link "</xxx.js>;rel=preload"
</Location></pre>
<p>Si quiere usar enlaces con <code>preload</code> sin activar un PUSH, puede
usar el parámetro <code>nopush</code>, como en:</p>
<pre class="prettyprint lang-config">Link </xxx.css>;rel=preload;nopush</pre>
<p>o puede desactivar PUSH para su servidor por completo con la directiva </p>
<pre class="prettyprint lang-config">H2Push Off</pre>
<p>Y hay más:</p>
<p>
El módulo mantiene un registro de lo que se ha enviado con PUSH para cada
conexión (hashes de URLs, básicamente) y no hará PUSH del mismo recurso dos
veces. Cuando la conexión se cierra, la información es descartada.
</p>
<p>
Hay gente pensando cómo un cliente puede decirle al servidor lo que ya
tiene, para evitar los PUSH de esos elementos, pero eso algo muy
experimental ahora mismo.
</p>
<p>Otro borrador experimental que ha sido implementado en
<code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> es el <a href="https://tools.ietf.org/html/draft-ruellan-http-accept-push-policy-00"> Campo de Cabecera
Accept-Push-Policy</a> en la que un cliente puede, para cada solicitud, definir
qué tipo de PUSH acepta.</p>
<p>
Puede que PUSH no siempre lance la peticion/respuesta/funcionamiento que
uno espera. Hay varios estudios sobre este tema en internet, que explican
el beneficio y las debilidades de como diferentes funcionalidades del
cliente y de la red influyen en el resultado.
Por Ejemplo, que un servidor haga "PUSH" de recursos, no significa que el
navegador vaya a usar dichos datos.
</p>
<p>
Lo más importante que influye en la respuesta que se envía, es la solicitud
que se simuló. La url de solicitud de un PUSH es dada por la aplicación,
pero ¿de donde vienen las cabeceras de la petición? por ejemplo si el PUSH
pide una cabecera <code>accept-language</code> y si es así, ¿con qué valor?
</p>
<p>Httpd mirará la petición original (la que originó el PUSH) y copiará las
siguientes cabeceras a las peticiones PUSH:
<code>user-agent</code>, <code>accept</code>, <code>accept-encoding</code>,
<code>accept-language</code>, <code>cache-control</code>.
</p>
<p>
Todas las otras cabeceras son ignorados. Las cookies tampoco serán copiadas.
Impulsar los recursos que requieren una cookie para estar presente no
funcionará. Esto puede ser una cuestión de debate. Pero a menos que esto se
discuta más claramente con el navegador, evitemos el exceso de precaución y
no expongamos las cookies donde podrían o no ser visibles.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="earlyhints" id="earlyhints">"Early Hints"</a></h2>
<p>Una alternativa de "Pushear" recursos es mandar una cabecera
<code>Link</code> al cliente antes que la respuesta esté lista. Esto usa
una caracteristica de HTTP que se llama "Early Hints" y está descrita en
la <a href="https://tools.ietf.org/html/rfc8297">RFC 8297</a>.</p>
<p>Para poder usar esto, necesita habilitarlo explicitamente en el servidor
via</p>
<pre class="prettyprint lang-config">H2EarlyHints on</pre>
<p>(No está habilitado por defecto ya q ue algunos navegadores más antiguos
se caen con dichas respuestas.)
</p>
<p>si esta funcionalidad esta activada, puede usar la directiva
<code class="directive"><a href="../mod/mod_http2.html#h2pushresource">H2PushResource</a></code> para que lance
"Early hints" y recursos mediante push:
</p>
<pre class="prettyprint lang-config"><Location /xxx.html>
H2PushResource /xxx.css
H2PushResource /xxx.js
</Location></pre>
<p>
Esto lanzará una respuesta <code>"103 Early Hints"</code> a un cliente
tan pronto como el servidor <em>comience</em> a procesar la solicitud.
Esto puede ser mucho antes que en el momento en que se determinaron los
primeros encabezados de respuesta, dependiendo de su aplicación web.
</p>
<p>
Si la directiva <code class="directive"><a href="../mod/mod_http2.html#h2push">H2Push</a></code> está
habilitada, esto comenzará el PUSH justo después de la respuesta 103.
Sin embargo, si la directiva <code class="directive"><a href="../mod/mod_http2.html#h2push">H2Push</a></code> está dehabilitada, la respuesta 103 se le enviará al cliente.
</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="../en/howto/http2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/http2.html" title="Español"> es </a> |
<a href="../fr/howto/http2.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/http2.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/index.html.zh-cn.utf8 0000664 0001751 0001751 00000014736 14743132254 022107 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>常见操作/教程 - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">模块</a> | <a href="../mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>常见操作/教程</h1>
<div class="toplang">
<p><span>可用语言: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">此翻译可能过期。要了解最近的更改，请阅读英文版。</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="howto" id="howto">常见操作/教程</a></h2>
<dl>
<dt>认证与授权</dt>
<dd>
<p>认证是你验证某人是所声称的人。
授权是允许某人执行他想要的操作，或者获得想要的信息。</p>
<p>参见: <a href="auth.html">认证，授权与访问控制</a></p>
</dd>
</dl>
<dl>
<dt>访问控制</dt>
<dd>
<p>访问控制是操作限制，或基于任意条件访问资源。这可以通过多种方法完成。</p>
</dd>
</dl>
<dl>
<dt>CGI 与动态内容</dt>
<dd>
<p>CGI (通用网管接口) 为 web 服务器定义了与外部的内容生成程序的操作接口，
通常称为 CGI 程序或 CGI 脚本。它是在 web 站点放入动态内容的最简单，
也最常用的方法。 本文简单介绍了在 Apache 服务器中配置 CGI 的方法，
以及如何编写 CGI 程序。</p>
<p>参见: <a href="cgi.html">CGI 与动态内容</a></p>
</dd>
</dl>
<dl>
<dt><code>.htaccess</code> 文件</dt>
<dd>
<p><code>.htaccess</code> files provide a way to make configuration
changes on a per-directory basis. A file, containing one or more
configuration directives, is placed in a particular document directory,
and the directives apply to that directory, and all subdirectories thereof.</p>
<p>See: <a href="htaccess.html"><code>.htaccess</code> files</a></p>
</dd>
</dl>
<dl>
<dt>服务器端插入简介</dt>
<dd>
<p>SSI (服务器端插入) 是在 HTML 页面中放入的指令，在页面被访问的时候执行。
它允许你在现有的 HTML 页面增加动态生成的内容，不需要通过 CGI
程序或其它动态计数来生成整个页面。</p>
<p>参见: <a href="ssi.html">服务器端插入 (SSI)</a></p>
</dd>
</dl>
<dl>
<dt>用户私人网站目录</dt>
<dd>
<p>在有多个用户的系统中，使用 <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> 指令，可以允许每个用户在他们的根目录中都有一个
web 站点。 访问 URL <code>http://example.com/~username/</code> 会得到位于用户
"<code>username</code>" 根目录中由 <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> 指定的子目录中的内容。</p>
<p>参见: <a href="public_html.html">用户私人网站目录 (<code>public_html</code>)</a></p>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>可用语言: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/public_html.html.tr.utf8 0000664 0001751 0001751 00000034454 14743132254 022707 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Kullanıcı Dizinleri (public_html) - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Nasıllar ve Öğreticiler</a></div><div id="page-content"><div id="preamble"><h1>Kullanıcı Dizinleri (public_html)</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/public_html.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" title="Türkçe"> tr </a></p>
</div>
<p>Çok kullanıcılı sistemlerde, <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> yönergesi ile her kullanıcının kendi ev dizininde
bir sitesi olması sağlanabilir.
<code>http://example.com/~kullanıcı/</code> adresinin ziyaretçileri
"kullanıcı" isimli kullanıcının ev dizininin içeriğini değil, <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> yönergesinde belirtilen alt
dizinin içeriğini görürler.</p>
<p>Öntanımlı olarak bu dizinlere erişimin etkin olmadığını unutmayınız.
<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> yönergesini
kullanırken <code>conf/httpd.conf</code> öntanımlı yapılandırma
dosyasındaki</p>
<pre class="prettyprint lang-config">#Include conf/extra/httpd-userdir.conf</pre>
<p>satırını etkin hale getirip, gerekiyorsa <code>httpd-userdir.conf</code>
dosyasını da düzenleyerek veya ana yapılandırma dosyasında bir
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> bloğu içine
uygun yönergeleri yerleştirerek bu dizinlere erişimi etkin hale
getirebilirsiniz.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Kullanıcı sayfaları dizinleri</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#userdir"><code>UserDir</code> ile dosya yolunun belirtilmesi</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirect">Harici adreslere yönlendirme</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#enable">Bu özelliği kullanacak kullanıcıların sınırlandırılması</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">Her kullanıcıya bir CGI dizini tahsis etmek</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#htaccess">Kullanıcıların yapılandırmayı değiştirmesine izin vermek</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="../urlmapping.html">URL’lerin Dosya Sistemi ile
Eşleştirilmesi</a></li><li><a href="#comments_section">Yorumlar</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="related" id="related">Kullanıcı sayfaları dizinleri</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></li><li><code class="directive"><a href="../mod/core.html#directorymatch">DirectoryMatch</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="userdir" id="userdir"><code>UserDir</code> ile dosya yolunun belirtilmesi</a></h2>
<p><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> yönergesinde
kullanıcı sayfalarının yükleneceği dizin belirtilir. Bu yönergeye değeri
çeşitli biçimlerde atanabilir.</p>
<p>Başında bölü çizgisi bulunmayan bir dosya yolu belirtilmişse,
kullanıcının ev dizinine göreli bir dizin belirtildiği varsayılır.
Yapılandırmada şöyle bir satır varsa:</p>
<pre class="prettyprint lang-config">UserDir public_html</pre>
<p><code>http://example.com/~orhan/dosya.html</code> adresine karşılık
gelen dosya yolu <code>/home/orhan/public_html/dosya.html</code> olarak
çözümlenir.</p>
<p>Eğer başında bölü çizgisi bulunan bir dosya yolu belirtilirse,
kullanıcı sayfalarının bu dizinin altında kullanıcı ismini taşıyan
dizinlerde bulunacağı varsayılır. Yapılandırmada şöyle bir satır
varsa:</p>
<pre class="prettyprint lang-config">UserDir /var/html</pre>
<p><code>http://example.com/~orhan/dosya.html</code> adresine karşılık
gelen dosya yolu <code>/var/html/orhan/dosya.html</code> olarak
çözümlenir.</p>
<p>Eğer belirtilen dosya yolu bir yıldız imi (*) içeriyorsa yıldız iminin
yerine kullanıcı ismi yerleştirilerek elde edilen dosya yolu
kullanılır. Yapılandırmada şöyle bir satır varsa:</p>
<pre class="prettyprint lang-config">UserDir /var/html/*/sayfam</pre>
<p><code>http://example.com/~orhan/dosya.html</code> adresine karşılık
gelen dosya yolu <code>/var/html/orhan/sayfam/dosya.html</code>
olarak çözümlenir.</p>
<p>Çok sayıda dizin veya dizin yolu belirtmek de mümkündür.</p>
<pre class="prettyprint lang-config">UserDir public_html /var/html</pre>
<p><code>http://example.com/~orhan/dosya.html</code> adresini Apache önce
<code>/home/orhan/public_html/dosya.html</code> olarak arayacak,
bulamazsa <code>/var/siteler/orhan/sayfam/dosya.html</code> olarak
arayacak, bulduğunda istenen dosyayı sunacaktır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirect" id="redirect">Harici adreslere yönlendirme</a></h2>
<p><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> yönergesi
kullanıcı dizini isteklerini harici adreslere yönlendirmek için de
kullanılabilir.</p>
<pre class="prettyprint lang-config">UserDir http://example.org/users/*/</pre>
<p>Bu yapılandırmaya göre <code>http://example.com/~bob/abc.html</code>
için yapılan bir istek <code>http://example.org/users/bob/abc.html</code>
adresine yönlendirilecektir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="enable" id="enable">Bu özelliği kullanacak kullanıcıların sınırlandırılması</a></h2>
<p><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> yönergesinin
açıklamasında belirtilen sözdizimini kullanarak bu işlevselliği bazı
kullanıcılara yasaklayabilirsiniz:</p>
<pre class="prettyprint lang-config">UserDir disabled root ahmet veli</pre>
<p>Bu yapılandırma ile <code>disabled</code> deyiminin bulunduğu
satırdaki kullanıcılar dışında kalan bütün kullanıcılar için bu özellik
etkin olacaktır. Benzer şekilde, aşağıdaki yapılandırma ile
işlevselliğin belli kullanıcılar dışında kullanılmamasını da
sağlayabilirsiniz:</p>
<pre class="prettyprint lang-config">UserDir disabled
UserDir enabled orhan yasar</pre>
<p>Daha fazla örnek için <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> yönergesinin açıklamasına bakabilirsiniz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">Her kullanıcıya bir CGI dizini tahsis etmek</a></h2>
<p>Her kullanıcıya kendine ait bir CGI dizini vermek isterseniz, bir
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> yönergesi
ile kullanıcının ev dizinindeki belli bir dizini CGI-etkin duruma
getirebilirsiniz.</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html/cgi-bin/">
Options ExecCGI
SetHandler cgi-script
</Directory></pre>
<p> <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> yönergesinde
<code>public_html</code> belirtildiği varsayımıyla
<code>mesela.cgi</code> betiği bu dizinden şöyle bir adresle
yüklenebilir:</p>
<div class="example"><p><code>
http://example.com/~orhan/cgi-bin/mesela.cgi
</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="htaccess" id="htaccess">Kullanıcıların yapılandırmayı değiştirmesine izin vermek</a></h2>
<p>Kullanıcıların kendilerine ayrılan bölge içinde sunucu
yapılandırmasını değiştirebilmelerine izin vermek isterseniz,
<code>.htaccess</code> dosyalarını kullanmalarına izin vermeniz
gerekir. Kullanıcının değiştirmesine izin vereceğiniz yönerge türlerini
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> yönergesinde
belirtmeyi ihmal etmeyin. <code>.htaccess</code> dosyalarının kullanımı
ile ilgili daha ayrıntılı bilgi için <a href="htaccess.html">.htaccess
öğreticisi</a>ne bakınız.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/public_html.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/public_html.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/access.html.fr.utf8 0000664 0001751 0001751 00000035263 14740503670 021630 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Contrôle d'accès - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Contrôle d'accès</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/howto/access.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/access.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/access.html" title="Français"> fr </a></p>
</div>
<p>Le contrôle d'accès fait référence à tout concept de contrôle
d'accès à une ressource quelconque. Il est distinct du processus d'<a href="auth.html">authentification et d'autorisation</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Modules et directives concernés</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#host">Contrôle d'accès en fonction de l'hôte du
client</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#env">Contrôle d'accès en fonction de variables
arbitraires</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewrite">Utilisation de mod_rewrite pour le contrôle
d'accès</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinformation">Informations complémentaires</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="related" id="related">Modules et directives concernés</a></h2>
<p>Plusieurs modules peuvent intervenir dans le contrôle d'accès.
Les plus importants sont <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> et
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>. Ce document illustre aussi comment
utiliser <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour le contrôle
d'accès.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="host" id="host">Contrôle d'accès en fonction de l'hôte du
client</a></h2>
<p>
Si vous souhaitez restreindre l'accès à certaines parties de votre
site web en fonction de l'addresse de l'hôte de vos visiteurs, le
plus simple pour y parvenir consiste à utiliser le module
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>.
</p>
<p>La directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> permet d'accorder ou
d'interdire l'accès à certaines ressources de différentes manières.
Ces critères d'accès, en conjonction avec les directives <code class="directive"><a href="../mod/mod_authz_core.html#requireall">RequireAll</a></code>, <code class="directive"><a href="../mod/mod_authz_core.html#requireany">RequireAny</a></code>, et <code class="directive"><a href="../mod/mod_authz_core.html#requirenone">RequireNone</a></code>, peuvent être
combinés d'une manière suffisamment complexe pour
satisfaire votre politique de contrôle d'accès.</p>
<div class="warning"><p>
Les directives <code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>, <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code>, et <code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code> fournies par le module
<code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> sont obsolètes, et sont appelées à
disparaître dans les versions futures. Il est donc déconseillé de
les utiliser, et de se fier aux tutoriels qui recommandent leur
utilisation.
</p></div>
<p>Les directives Require s'utilisent comme suit :</p>
<pre class="prettyprint lang-config">Require host address
Require ip ip.address</pre>
<p>Dans la première forme, <var>nom-hôte</var> est un nom de domaine
pleinement qualifié (fqdn), ou un nom de domaine partiel ; vous
pouvez spécifier plusieurs noms de domaines, si vous le désirez.</p>
<p>Dans la seconde forme, <var>adresse-ip</var> est une adresse IP
complète, une adresse IP partielle, une paire réseau/masque de
sous-réseau ou une spécification CIDR de la forme réseau/nnn. Il est
possible de spécifier des adresses IPv4 ou IPv6.</p>
<p>Voir <a href="../mod/mod_authz_host.html#requiredirectives">la
documentation de mod_authz_host</a> pour d'autres exemples de cette
syntaxe.</p>
<p>Vous pouvez insérer le mot-clé <code>not</code> pour inverser un
critère particulier. Notez que le mot <code>not</code> étant la
négation d'une valeur, il ne peut pas être utilisé pour autoriser
ou interdire une requête, car <em>non vrai</em> ne
sera pas interpreté par httpd comme <em>faux</em>. Ainsi, pour interdire la
visite d'une page à l'aide d'une négation, le bloc doit contenir un
élément évalué à vrai ou faux.
Par exemple, si quelqu'un est en train d'inonder
votre forum de messages indésirables, vous pouvez ajouter cette ligne pour lui refuser
l'accès :</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not ip 10.252.46.165
</RequireAll></pre>
<p>Les visiteurs possédant cette adresse (<code>10.252.46.165</code>) ne pourront pas voir le
contenu concerné par cette directive. Si vous voulez interdire
l'accès à une machine en fonction de son nom, vous pouvez ajouter
ceci :</p>
<pre class="prettyprint lang-config">Require not host <var>host.example.com</var>
</pre>
<p>Et si vous voulez interdire l'accès à un domaine particulier,
vous pouvez spécifier des adresses IP partielles ou des noms de
domaine, comme ceci :</p>
<pre class="prettyprint lang-config">Require not ip 192.168.205
Require not host phishers.example.com moreidiots.example
Require not host gov</pre>
<p>Les directives <code class="directive"><a href="../mod/mod_authz_core.html#requireall">RequireAll</a></code>, <code class="directive"><a href="../mod/mod_authz_core.html#requireany">RequireAny</a></code>, et <code class="directive"><a href="../mod/mod_authz_core.html#requirenone">RequireNone</a></code> permettent également de préciser des
critères d'accès plus complexes.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="env" id="env">Contrôle d'accès en fonction de variables
arbitraires</a></h2>
<p>Vous pouvez accorder ou refuser l'accès en fonction de variables
d'environnement arbitraires ou de valeurs d'en-têtes de la requête
en utilisant la directive <code class="directive"><a href="../mod/core.html#if"><If></a></code>. Par exemple, pour interdire l'accès en
fonction du user-agent (le type de navigateur), vous pouvez
spécifier ceci :</p>
<pre class="prettyprint lang-config"><If "%{HTTP_USER_AGENT} == 'BadBot'">
Require all denied
</If></pre>
<p>La syntaxe <code>expr</code> de la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> permet de réécrire
l'exemple précédent de la manière suivante :</p>
<pre class="prettyprint lang-config">Require expr %{HTTP_USER_AGENT} != 'BadBot'</pre>
<div class="note"><h3>Avertissement :</h3>
<p>Contrôler l'accès en fonction de l'en-tête
<code>User-Agent</code> n'est pas une technique fiable, car cet
en-tête peut être défini à une valeur quelconque, selon le bon
vouloir de l'utilisateur.</p>
</div>
<p>Voir le document à propos des <a href="../expr.html">expressions</a> pour une description plus
approfondie des syntaxes d'expressions et des variables disponibles.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">Utilisation de mod_rewrite pour le contrôle
d'accès</a></h2>
<p>Le drapeau <code>[F]</code> de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> permet d'envoyer une
réponse de type 403 Forbidden. Il vous permet donc d'interdire
l'accès à une ressource en fonction d'un critère arbitraire.</p>
<p>Par exemple, pour bloquer l'accès à une ressources entre 20h et
7h du matin, vous pouvez utiliser <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> :</p>
<pre class="prettyprint lang-config">RewriteEngine On
RewriteCond "%{TIME_HOUR}" ">=20" [OR]
RewriteCond "%{TIME_HOUR}" "<07"
RewriteRule "^/fridge" "-" [F]</pre>
<p>Toute requête arrivant après 20h ou avant 7h du matin provoquera
l'envoi d'une réponse de type 403 Forbidden. Vous pouvez utiliser
cette technique pour vérifier toutes sortes de critères. En outre,
si vous le préférez, vous pouvez rediriger ou réécrire la requête.</p>
<p>Notez que la directive <code class="directive"><a href="../mod/core.html#if"><If></a></code>, introduite à partir de la version 2.4,
permet de remplacer le module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> dans de
nombreuses situations où il était traditionnellement utilisé, et
il sera probablement préférable pour vous de tenter de l'utiliser
avant de vous tourner vers mod_rewrite.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinformation" id="moreinformation">Informations complémentaires</a></h2>
<p>Le <a href="../expr.html">moteur d'expressions</a> vous fournit
une grande puissance d'action en fonction de variables du serveur
arbitraires, et il vous est conseillé de consulter le document
correspondant pour plus de détails.</p>
<p>De même, vous devez lire la documentation du module
<code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> pour des exemples de combinaison de
critères d'accès multiples, et en particulier la manière dont ces
derniers interagissent.</p>
<p>Voir aussi le How-To <a href="auth.html">Authentification and
autorisation</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/howto/access.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/access.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/access.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/access.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/http2.html.fr.utf8 0000664 0001751 0001751 00000072626 14740503670 021434 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Guide HTTP/2 - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Guide HTTP/2</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/howto/http2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/http2.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/http2.html" title="Français"> fr </a></p>
</div>
<p>Ce document est le guide de l'utilisateur de l'implémentation de HTTP/2
dans Apache httpd. Cette fonctionnalité en est au stade
<em>de production</em>, et les interfaces et directives devraient donc être
dorénavant relativement stables.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#protocol">Le protocole HTTP/2</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#implementation">HTTP/2 dans Apache httpd</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#building">Compilation de httpd avec le support de HTTP/2</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#basic-config">Configuration de base</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mpm-config">Configuration du MPM</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#clients">Clients</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#tools">Outils efficaces pour déboguer HTTP/2</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#push">Push serveur</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#earlyhints">Suggestions précoces</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code></li><li><a href="#comments_section">Commentaires</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="protocol" id="protocol">Le protocole HTTP/2</a></h2>
<p>HTTP/2 est une évolution du protocole de la couche application le plus
utilisé au monde, HTTP. Cette évolution permet en particulier une utilisation
plus efficace des ressources réseau. Il ne modifie pas les aspects
fondamentaux de HTTP (sa sémantique). Entre autres, il y a toujours des
requêtes, des réponses et des en-têtes. Par conséquent, si vous connaissez
HTTP/1, vous connaissez déjà 95% de HTTP/2.</p>
<p>Beaucoup a déjà été écrit à propos de HTTP/2 et de son fonctionnement. La
documentation la plus officielle est bien entendu sa <a href="https://tools.ietf.org/html/rfc7540">RFC 7540</a> (ou <a href="http://httpwg.org/specs/rfc7540.html">cette version au format plus
lisible</a>). Vous trouverez ici une description des rouages de HTTP/2 dans
leurs moindres détails.</p>
<p>Le premier document à lire lorsqu'on ne connaît pas un mécanisme n'est
cependant pas sa RFC. Il est préférable de comprendre tout d'abord <em>ce
que</em> ce mécanisme est censé faire, et seulement ensuite de lire sa RFC
pour comprendre <em>comment</em> il fonctionne. <a href="https://daniel.haxx.se/http2/">http2 explained</a> de Daniel Stenberg
(l'auteur de <a href="https://curl.haxx.se">curl</a>)
est un bien meilleur document pour démarrer l'étude de HTTP/2. En outre, de
nouveaux langages s'ajoutent régulièrement à sa liste de traductions
disponibles !</p>
<p>Si vous n'avez pas envie de le lire parce que vous le trouvez trop long,
voici certains pièges à éviter et nouveaux termes à connaître avant de lire
ce document :</p>
<ul>
<li>A la différence de HTTP/1 qui est en texte pur, HTTP/2 est un
<strong>protocole binaire</strong>, et alors que le premier est lisible par
un humain (par exemple pour sniffer le trafic réseau), le second ne
l'est pas. Voir la <a href="https://http2.github.io/faq/#why-is-http2-binary">FAQ
officielle</a> pour plus de détails.</li>
<li><strong>h2</strong> correspond à HTTP/2 sur TLS (négociation de
protocole via ALPN).</li>
<li><strong>h2c</strong> correspond à HTTP/2 sur TCP.</li>
<li>Une <strong>frame</strong> ou trame est la plus petite unité de
communication au sein d'une connexion HTTP/2 et comporte une en-tête et
une séquence d'octets de longueur variable dont la structure correspond
au type de trame. Voir la <a href="http://httpwg.org/specs/rfc7540.html#FramingLayer">section
correspondante</a> de la documentation officielle pour plus de
détails.</li>
<li>Un <strong>stream</strong> est un flux bidirectionnel de frames au
sein d'une connexion HTTP/2. La notion correspondante dans HTTP/1 est un
échange de messages de type requête et réponse. Voir la <a href="http://httpwg.org/specs/rfc7540.html#StreamsLayer">section
correspondante</a> de la documentation officielle pour plus de détails.</li>
<li>HTTP/2 peut gérer <strong>plusieurs streams</strong> de données sur
la même connexion TCP, ce qui permet d'éviter le point de blocage
classique de HTTP/1 pour les requêtes lentes, et de ne pas avoir à
ouvrir de nouvelles connexions TCP pour chaque requête/réponse (les
connexions persistantes ou KeepAlive avaient contourné le problème dans
HTTP/1 mais ne l'avaient pas entièrement résolu)</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="implementation" id="implementation">HTTP/2 dans Apache httpd</a></h2>
<p>Le protocole HTTP/2 est implémenté dans Apache httpd via un module
propre, pertinemment nommé <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code>. Ce
module implémente toutes les fonctionnalités décrites par la RFC 7540 et
supporte les connexions en texte pur (http:), ou sécurisées (https:).
La variante texte pur se nomme '<code>h2c</code>', et la variante sécurisée
'<code>h2</code>'. <code>h2c</code> peut être en mode <em>direct</em> ou
<code>Upgrade:</code> via une requête initiale en HTTP/1.</p>
<p><a href="#push">Server Push</a> est une nouvelle fonctionnalité offerte
aux développeurs web par HTTP/2. La section correspondante de ce document
vous indiquera comment votre application peut en tirer parti.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="building" id="building">Compilation de httpd avec le support de HTTP/2</a></h2>
<p><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> se base sur la bibliothèque
de <a href="https://nghttp2.org">nghttp2</a> pour son implémentation. Pour
pouvoir compiler <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code>, <code>libnghttp2</code> version
1.2.1. ou supérieure doit être installée dans votre système.</p>
<p>Pour déclencher la compilation de <code>mod_http2</code>, vous devez
ajouter l'argument '<code>--enable-http2</code>' au script
<code>./configure</code> que vous exécutez à la racine de l'arborescence des
sources de httpd. Si <code>libnghttp2</code> est installée dans un
répertoire non connu du chemin de vos bibliothèques, vous devez indiquer ce
répertoire au script <code>./configure</code> via l'argument
'<code>--with-nghttp2=<path></code>'.</p>
<p>Alors que cette méthode de compilation conviendra à la plupart, certains
préféreront lier statiquement <code>nghttp2</code> à ce module. Pour ce
faire, utilisez l'argument <code>--enable-nghttp2-staticlib-deps</code>.
Cette méthode est pratiquement la même que celle utilisée pour lier
statiquement openssl à <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.</p>
<p>En parlant de SSL, vous devez savoir que la plupart des navigateurs ne
communiqueront en HTTP/2 que sur des URLs sécurisées de type
<code>https:</code> ; votre serveur doit donc supporter SSL. Mais de plus,
votre bibliothèque SSL devra supporter l'extension <code>ALPN</code>. Enfin,
si la bibliothèque que vous utilisez est OpenSSL, sa version devra être
1.0.2. ou supérieure.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="basic-config" id="basic-config">Configuration de base</a></h2>
<p>Maintenant que vous disposez d'un binaire <code>httpd</code> compilé avec le
module <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code>, l'activation de ce dernier nécessite un
minimum de configuration supplémentaire. En premier lieu, comme pour tout
module Apache, vous devez le charger :</p>
<pre class="prettyprint lang-config">LoadModule http2_module modules/mod_http2.so</pre>
<p>La seconde directive que vous devez ajouter à votre fichier de
configuration est</p>
<pre class="prettyprint lang-config">Protocols h2 http/1.1</pre>
<p>Ceci permet de définir h2, la variante sécurisée, comme le protocole
préféré pour les connexions à votre serveur. Si vous souhaitez que toutes les
variantes soient disponibles, utilisez la directive suivante :</p>
<pre class="prettyprint lang-config">Protocols h2 h2c http/1.1</pre>
<p>Selon l'endroit où vous placez cette directive, elle affectera l'ensemble
de votre serveur, ou seulement un ou plusieurs serveurs virtuels. Vous
pouvez aussi l'imbriquer comme dans l'exemple suivant :</p>
<pre class="prettyprint lang-config">Protocols http/1.1
<VirtualHost ...>
ServerName test.example.org
Protocols h2 http/1.1
</VirtualHost></pre>
<p>Seules les connexions en HTTP/1 seront alors permises, sauf pour le serveur
virtuel <code>test.example.org</code> qui acceptera aussi les connexions SSL
en HTTP/2.</p>
<div class="note"><h3>Utilisez une chaîne d'algorithmes de chiffrement forte</h3>
<p>La directive <code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code> doit
être définie avec une chaîne d'algorithmes de chiffrement TLS forte. Même si
la version actuelle de <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> n'impose pas d'algorithmes
de chiffrement particuliers, la plupart des clients le font. Faire pointer
un navigateur vers un serveur où <code>h2</code> est activé avec une chaîne
d'algorithmes de chiffrement inappropriée entraînera un rejet et une
retrogradation vers HTTP 1.1. C'est une erreur que l'on fait couramment
lorsqu'on configure httpd pour HTTP/2 pour la première fois ; donc gardez la
à l'esprit si vous voulez éviter de longues sessions de débogage ! Si vous
voulez être sûr de définir une chaîne d'algorithmes de chiffrement
appropriée, évitez ceux qui sont listés dans la <a href="http://httpwg.org/specs/rfc7540.html#BadCipherSuites"> </a>liste des
algorithmes de chiffrement TLS HTTP/2 à proscrire.</p>
</div>
<p>L'ordre des protocoles indiqués est aussi important. Par défaut, le
premier sera le protocole préféré. Lorsqu'un client offre plusieurs choix,
c'est le plus à gauche qui sera sélectionné. Dans</p>
<pre class="prettyprint lang-config">Protocols http/1.1 h2</pre>
<p>le protocole préféré sera HTTP/1 et il sera toujours sélectionné sauf si
un client ne supporte <em>que</em> h2. Comme nous souhaitons communiquer en
HTTP/2 avec les clients qui le supportent, la meilleure définition de la
directive est</p>
<pre class="prettyprint lang-config">Protocols h2 h2c http/1.1</pre>
<p>Toujours à propos de l'ordre des protocoles, le client a lui aussi ses
propres préférences en la matière. À ce titre, si vous le souhaitez, vous
pouvez configurer votre serveur pour qu'il sélectionne non plus son
protocole préféré, mais au contraire le protocole préféré
du client :</p>
<pre class="prettyprint lang-config">ProtocolsHonorOrder Off</pre>
<p>Avec cette directive, l'ordre des protocoles que <em>vous</em> avez
défini devient caduque et seul l'ordre défini par le client sera pris en
compte.</p>
<p>Une dernière chose : les protocoles que vous définissez ne sont pas
vérifiés quant à leurs validité ou orthographe. Vous pouvez très bien
définir des protocoles qui n'existent pas, et il n'est donc pas nécessaire
de filtrer le contenu de la directive <code class="directive"><a href="../mod/core.html#protocols">Protocols</a></code> avec des vérifications de type
<code class="directive"><a href="../mod/core.html#ifmodule"><IfModule></a></code>.</p>
<p>Pour des conseils plus avancés à propos de la configuration, voir la <a href="../mod/mod_http2.html">Documentation de mod_http2</a>, et en particulier
la section à propos de la <a href="../mod/mod_http2.html#dimensioning">consommation supplémentaire de
ressources</a>, ainsi que la section expliquant comment gérer les <a href="../mod/mod_http2.html#misdirected">serveurs multiples avec certificat
commun</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="mpm-config" id="mpm-config">Configuration du MPM</a></h2>
<p>Tous les modules multiprocessus (MPM) fournis avec httpd supportent
HTTP/2. Cependant, si vous utilisez le MPM <code class="module"><a href="../mod/prefork.html">prefork</a></code>, vous allez
faire face à de sévères restrictions.</p>
<p>Avec le MPM <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> ne traitera
qu'une requête à la fois par connexion alors que les clients tels que les
navigateurs internet envoient de nombreuses requêtes au même moment. Si
l'une d'entre elles est longue à traiter (ou implique une longue
interrogation), les autres requêtes seront mises en attente.</p>
<p>Par défaut, <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> ne passe pas outre cette limitation pour
la simple et bonne raison que le MPM <code class="module"><a href="../mod/prefork.html">prefork</a></code> n'est aujourd'hui
choisi que si vous exécutez des moteurs de traitement qui ne sont pas préparés
pour le multithreading (par exemple qui se crashent lorsque plusieurs
requêtes arrivent).</p>
<p>Si votre plateforme et votre installation de httpd le supportent, la
meilleur solution consiste actuellement à utiliser le MPM
<code class="module"><a href="../mod/event.html">event</a></code>.
</p>
<p>Si vous n'avez pas d'autre choix que d'utiliser le MPM
<code class="module"><a href="../mod/prefork.html">prefork</a></code>, mais souhaitez tout de même traiter plusieurs requêtes
simultanément, vous pouvez jouer avec la directive <code class="directive"><a href="../mod/mod_http2.html#h2minworkers">H2MinWorkers</a></code>, sans garantie que cela
fonctionne.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="clients" id="clients">Clients</a></h2>
<p>La plupart des navigateurs modernes supportent HTTP/2, mais seulement sur
des connexions SSL : Firefox v43, Chrome v45, Safari v9, iOS Safari v9,
Opera v35, Chrome pour Android v49 et
Internet Explorer v11 sous Windows10 (selon cette <a href="http://caniuse.com/#search=http2">source</a>).</p>
<p>D'autres clients et serveurs sont listés dans le <a href="https://github.com/http2/http2-spec/wiki/Implementations">wiki des
implémentations</a> ; entre autres des implémentations pour c, c++, common
lisp, dart, erlang, haskell, java, nodejs, php, python, perl, ruby, rust,
scala et swift.</p>
<p>De nombreuses implémentations clientes autres que les navigateurs
supportent HTTP/2 en texte pur, h2c. L'une des plus efficaces d'entre elles
est <a href="https://curl.haxx.se">curl</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="tools" id="tools">Outils efficaces pour déboguer HTTP/2</a></h2>
<p>Le premier d'entre eux est bien entendu <a href="https://curl.haxx.se">curl</a>. Assurez-vous au préalable que votre
version supporte HTTP/2 en vérifiant ses <code>Fonctionnalités</code> :</p>
<pre class="prettyprint lang-config"> $ curl -V
curl 7.45.0 (x86_64-apple-darwin15.0.0) libcurl/7.45.0 OpenSSL/1.0.2d zlib/1.2.8 nghttp2/1.3.4
Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 [...]
Features: IPv6 Largefile NTLM NTLM_WB SSL libz TLS-SRP <strong>HTTP2</strong>
</pre>
<div class="note"><h3>homebrew sous Mac OS :</h3>
brew install curl --with-openssl --with-nghttp2
</div>
<p>Pour une inspection en profondeur : <a href="https://wiki.wireshark.org/HTTP2">wireshark</a>.</p>
<p>Le paquet <a href="https://nghttp2.org">nghttp2</a> inclut aussi des
outils comme :</p>
<ul>
<li><a href="https://nghttp2.org/documentation/nghttp.1.html">nghttp</a>
- permet de visualiser les trames HTTP/2 et ainsi de se faire une meilleure
idée du protocole.</li>
<li><a href="https://nghttp2.org/documentation/h2load-howto.html">h2load</a> -
permet de tester votre serveur dans des conditions extremes.</li>
</ul>
<p>Chrome fournit des journaux détaillés des connexions HTTP/2 via la page
<a href="chrome://net-internals/#http2">special net-internals page</a>. Il y
a aussi cette extension intéressante pour <a href="https://chrome.google.com/webstore/detail/http2-and-spdy-indicator/mpbpobfflnpcgagjijhmgnchggcjblin?hl=en">Chrome</a>
et <a href="https://addons.mozilla.org/en-us/firefox/addon/spdy-indicator/">Firefox</a>
qui permet d'indiquer que votre navigateur utilise HTTP/2.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="push" id="push">Push serveur</a></h2>
<p>Le protocole HTTP/2 permet au serveur de proposer (PUSH) des réponses
pour lesquelles le client n'a rien demandé. La communication autour de ces
réponses est du style : "voici une requête que vous n'avez jamais
envoyée, et la réponse vous parviendra bientôt tout de même ..."</p>
<p>Il y a cependant des conditions : le client peut désactiver cette
fonctionnalité et le serveur ne pourra alors lui proposer des réponses que
pour les requêtes qu'il a effectivement envoyées.</p>
<p>Cette fonctionnalité a pour but de permettre au serveur d'envoyer au
client des ressources dont il va probablement avoir besoin : par exemple une
ressource css ou javascript appartenant à une page html que le client a
demandée, un jeu d'images référencé par un css, etc...</p>
<p>Cette anticipation a pour avantage de permettre au client d'économiser le
temps qu'il lui aurait fallu pour envoyer une requête, quelques
millisecondes à une demi-seconde en fonction de l'éloignement du serveur.
Elle a cependant pour inconvénient d'imposer au client le téléchargement de
ressources qu'il possède peut-être déjà dans son cache. Bien entendu, HTTP/2
permet d'annuler prématurément de telles requêtes, mais des ressources sont
tout de même gaspillées.</p>
<p>En résumé : il n'existe pas encore de stratégie efficace pour faire le
meilleur usage de cette fonctionnalité de HTTP/2 et tout le monde en est
encore au stade de l'expérimentation. À ce titre, voici des conseils pour
procéder vous-même à ces expérimentations :</p>
<p><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> inspecte l'en-tête de la réponse et recherche les
en-têtes <code>Link</code> sous un certain format :</p>
<pre class="prettyprint lang-config">Link </xxx.css>;rel=preload, </xxx.js>; rel=preload</pre>
<p>Si la connexion supporte PUSH, ces deux ressources seront envoyées au
client. En tant que développeur web vous pouvez définir ces en-têtes soit
directement au niveau de la réponse de votre application, soit en
configurant votre serveur via</p>
<pre class="prettyprint lang-config"><Location /xxx.html>
Header add Link "</xxx.css>;rel=preload"
Header add Link "</xxx.js>;rel=preload"
</Location></pre>
<p>Si vous souhaitez utiliser des liens <code>preload</code> sans déclencher
de PUSH, vous pouvez utiliser le paramètre <code>nopush</code> comme suit :</p>
<pre class="prettyprint lang-config">Link </xxx.css>;rel=preload;nopush</pre>
<p>Vous pouvez aussi désactiver les PUSHes pour l'ensemble de votre
serveur via la directive</p>
<pre class="prettyprint lang-config">H2Push Off</pre>
<p>À savoir aussi :</p>
<p>Le module maintient un journal des ressources ayant fait l'objet d'un
PUSH pour chaque connexion (en général des condensés hash des URLs), et
n'effectuera pas deux fois un PUSH pour la même ressource. Cependant,
lorsque la connexion est fermée, le journal de ses PUSHes est supprimé.</p>
<p>Certains développeurs planchent sur la manière de permettre au client
d'informer le serveur des ressources qu'il possède déjà dans son cache afin
d'éviter les PUSHes pour ces dernières, mais ceci n'en est actuellement qu'à
un stade très expérimental.</p>
<p>L'<a href="https://tools.ietf.org/html/draft-ruellan-http-accept-push-policy-00">
en-tête Accept-Push-Policy</a> est un autre dispositif expérimental
implémenté dans <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> ; il permet au client de définir pour
chaque requête quels genres de PUSHes il accepte.</p>
<p>
La fonctionnalité PUSH n'apportera pas toujours le gain de performances dans
l'obtention de réponses aux requêtes. Vous trouverez plusieurs études sur ce
sujet sur internet qui en expliquent les avantages et inconvénients et
comment les particularités des clients et du réseau en influencent le
fonctionnement. Par exemple, le seul fait que le serveur PUSHes une
ressource n'implique pas forcément que le navigateur l'utilisera.</p>
<p>Ce qui influence le plus la réponse PUSHed, c'est la requête qui a été
simulée. En effet, l'URL de la requête pour un PUSH est fournie par
l'application, mais d'où viennent les en-têtes ? Par exemple, La requête
PUSH requiert-elle un en-tête <code>accept-language</code> et si oui, quelle
sera sa valeur ?</p>
<p>httpd va consulter la requête originale (celle qui a déclenché le PUSH)
et copier les en-têtes suivants vers la requête PUSH :
<code>user-agent</code>, <code>accept</code>, <code>accept-encoding</code>,
<code>accept-language</code> et <code>cache-control</code>.</p>
<p>Tous les autres en-têtes sont ignorés. Les cookies eux non plus ne seront
pas copiés. PUSHer des ressources qui requièrent la présence d'un cookie ne
fonctionnera pas. Ceci peut être sujet à débat, mais tant que ce ne sera pas
clairement discuté avec les navigateurs, restons prudents et évitons
d'exposer les cookies là où ils ne sont pas censés être visibles.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="earlyhints" id="earlyhints">Suggestions précoces</a></h2>
<p>A l'instar des ressources PUSHées, une autre méthode consiste à envoyer
des en-têtes <code>Link</code> au client avant même que la réponse ne soit
prête. Cette méthode utilise la fonctionnalité appelée "Suggestions
précoces" (Early Hints) décrite dans la <a href="https://tools.ietf.org/html/rfc8297">RFC 8297</a>.</p>
<p>Pour utiliser cette fonctionnalité, vous devez l'activer explicitement
sur le serveur via :</p>
<pre class="prettyprint lang-config">H2EarlyHints on</pre>
<p>Elle n'est en effet pas activée par défaut car certains navigateurs
anciens perdent pied avec de telles réponses.</p>
<p>Une fois cette fonctionnalité activée, vous pouvez utiliser la directive
<code class="directive"><a href="../mod/mod_http2.html#h2pushresource">H2PushResource</a></code> pour déclencher les
suggestions précoces et les PUSHes de ressources :</p>
<pre class="prettyprint lang-config"><Location /xxx.html>
H2PushResource /xxx.css
H2PushResource /xxx.js
</Location></pre>
<p>Le serveur enverra alors au client une réponse <code>"103 Early
Hints"</code> dès qu'il <em>commencera</em> à traiter la requête. Selon
votre application web, cet envoi peut intervenir beaucoup plus tôt que le
moment où les premiers en-têtes de réponse auront été déterminés.</p>
<p>Si <code class="directive"><a href="../mod/mod_http2.html#h2push">H2Push</a></code> est activé, ceci
déclenchera aussi le PUSH juste après la réponse 103. Mais si <code class="directive"><a href="../mod/mod_http2.html#h2push">H2Push</a></code> n'est pas activé, la réponse 103 sera
quand-même envoyée au client.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/howto/http2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/http2.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/http2.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/http2.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/htaccess.html.pt-br 0000664 0001751 0001751 00000062761 14743132254 021716 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="pt-br" xml:lang="pt-br"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Tutorial do Apache: arquivos .htaccess - Servidor HTTP Apache Versão 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Diretrizes</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossário</a> | <a href="../sitemap.html">Mapa do site</a></p>
<p class="apache">Servidor HTTP Apache Versão 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentação</a> > <a href="../">Versão 2.4</a> > <a href="./">How-To / Tutoriais</a></div><div id="page-content"><div id="preamble"><h1>Tutorial do Apache: arquivos .htaccess</h1>
<div class="toplang">
<p><span>Línguas Disponíveis: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" title="Português (Brasil)"> pt-br </a></p>
</div>
<div class="outofdate">Esta tradução pode estar desatualizada.
Confira a versão em Inglês para mudanças recentes.</div>
<p>Arquivos <code>.htaccess</code> oferecem um meio de fazer mudanças
nas configurações por-diretório.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Arquivos .htaccess </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what">O que eles são/Como usá-los</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#when">Quando (não) usar arquivos .htaccess</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#how">Como as diretrizes são aplicadas</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#auth">Exemplo de Autenticação</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ssi">Exemplo de Server Side Includes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">Exemplo de CGI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">Resolvendo Problemas</a></li>
</ul><h3>Veja também</h3><ul class="seealso"><li><a href="#comments_section">Comentários</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="related" id="related">Arquivos .htaccess </a></h2>
<table class="related"><tr><th>Módulos Relacionados</th><th>Diretrizes Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</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_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</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/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">O que eles são/Como usá-los</a></h2>
<p>Os arquivos <code>.htaccess</code> (ou "arquivos de
configuração distribuída") oferecem um meio de fazer mudanças nas
configurações por-diretório. Um arquivo, contendo uma ou mais
diretrizes de configurações, é colocado em um diretório
em particular, e as diretrizes se aplicam para aquele diretório e todos
os seu subdiretórios subseqüentes.</p>
<div class="note"><h3>Nota:</h3>
<p>Se você quiser renomear o seu arquivo <code>.htaccess</code>
para outro nome, você deve usar a diretriz <code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code>. Por exemplo, se você
prefere que o arquivo se chame <code>.config</code>, então você
pode adicionar a seguinte linha ao seu arquivo de configuração
do servidor:</p>
<div class="example"><p><code>
AccessFileName .config
</code></p></div>
</div>
<p>No geral, arquivos <code>.htaccess</code> usam a mesma sintaxe
que os <a href="../configuring.html#syntax">arquivos de
configuração principal</a>. O que você pode colocar nesses
arquivos é determinado pele diretriz <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>. Essa diretriz especifica,
em categorias, quais diretrizes serão aceitas caso sejam
encontradas em um arquivo <code>.htaccess</code>. Se uma diretriz
for permitida em um arquivo <code>.htaccess</code>, a documentação
para essa diretriz irá conter uma seção <em>Override</em>,
especificando que valor precisa estar em <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> para que esta diretriz
seja permitida.</p>
<p>Por exemplo, se você procurar na documentação pela diretriz
<code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>, você
achará que ela é permitida nos arquivos <code>.htaccess</code>.
(Veja a linha Contexto no sumário das diretivas.) A
linha <a href="../mod/directive-dict.html#Context">Override</a> lê
<code>FileInfo</code>. Então, você deve ao menos ter
<code>AllowOverride FileInfo</code> para que essa diretriz seja
aceita nos arquivos <code>.htaccess</code>.</p>
<div class="example"><h3>Exemplo:</h3><table>
<tr>
<td><a href="../mod/directive-dict.html#Context">Contexto:</a></td>
<td>configuração do servidor, hospedeiros virtuais, diretório, .htaccess</td>
</tr>
<tr>
<td><a href="../mod/directive-dict.html#Override">Override:</a></td>
<td>FileInfo</td>
</tr>
</table></div>
<p>Se você estiver incerto se uma diretriz em particular é
aceita em um arquivo <code>.htaccess</code>, procure na
documentação por essa diretriz, e verifique a linha de
Contexto por ".htaccess".</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="when" id="when">Quando (não) usar arquivos .htaccess</a></h2>
<p>No geral, você nunca deve usar arquivos <code>.htaccess</code>
a não ser que você não tenha acesso ao arquivo de configuração
principal do servidor. Existe, por exemplo, um erro de concepção
que dita que a autenticação de usuários sempre deve
ser feita usando os arquivos <code>.htaccess</code>. Esse
simplesmente não é o caso. Você pode usar as configurações de
autenticação de usuário no arquivo de configuração principal do
servidor, e isso é, de fato, a maneira mais adequada de se fazer
as coisas.</p>
<p>Arquivos <code>.htaccess</code> devem ser usados em casos onde
os provedores de conteúdo do site precisem fazer mudanças na
configuração do servidor por-diretório, mas não tem
acesso <em>root</em> ao sistema do servidor. Caso o administrador do
servidor não esteja disposto a fazer mudanças freqüentes nas
configurações do servidor, é desejável permitir que os
usuários possam fazer essas mudanças através de arquivos
<code>.htaccess</code> eles mesmos. Isso é particularmente
verdade, por exemplo, em casos onde provedores estão fornecendo
múltiplos sites para usuários em apenas uma máquina, e querem que
seus usuários possam alterar suas configurações.</p>
<p>No entanto, de modo geral, o uso de arquivos <code>.htaccess</code>
deve ser evitado quando possível. Quaisquer configurações
que você considerar acrescentar em um arquivo <code>.htaccess</code>, podem
ser efetivamente colocadas em uma seção <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> no arquivo principal de
configuração de seu servidor.</p>
<p>Existem duas razões principais para evitar o uso de arquivos
<code>.htaccess</code>.</p>
<p>A primeira delas é a performance. Quando <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> é configurado para
permitir o uso de arquivos <code>.htaccess</code>, o Apache procura
em todos diretórios por arquivos <code>.htaccess</code>.
Logo, permitir arquivos <code>.htaccess</code> causa um impacto na
performance, mesmo sem você usá-los de fato! Além disso,
o arquivo <code>.htaccess</code> é carregado toda vez que um documento
é requerido.</p>
<p>Além disso, note que o Apache precisa procurar pelos arquivos
<code>.htaccess</code> em todos os diretórios superiores, para ter
o complemento total de todas as diretivas que devem ser
aplicadas. (Veja a seção <a href="#how">como as diretrizes são
aplicadas</a>.) Então, se um arquivo de um diretório
<code>/www/htdocs/example</code> é requerido, o Apache precisa
procurar pelos seguintes arquivos:</p>
<div class="example"><p><code>
/.htaccess<br />
/www/.htaccess<br />
/www/htdocs/.htaccess<br />
/www/htdocs/example/.htaccess
</code></p></div>
<p>Assim, para cada acesso de arquivo fora desse diretório,
existem 4 acessos ao sistema de arquivos adicionais, mesmo
que nenhum desses arquivos estejam presentes. (Note que esse
só será o caso se os arquivos <code>.htaccess</code>
estiverem habilitados para <code>/</code>, o que
normalmente não é o verdade.)</p>
<p>A segunda consideração é relativa à segurança.
Você está permitindo que os usuários modifiquem as
configurações do servidor, o que pode resultar em mudanças
que podem fugir ao seu controle. Considere com cuidado se você quer
ou não dar aos seus usuários esses privilégios. Note também
que dar aos usuários menos privilégios que eles precisam, acarreta em
pedidos de suporte técnico adicionais. Tenha certeza que você comunicou
aos usuários que nível de privilégios você os deu.
Especificar exatamente o que você configurou na diretriz <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>, e direcioná-los para a
documentação relevante, irá poupá-lo de muita confusão
depois.</p>
<p>Perceba que é exatamente equivalente colocar o arquivo
<code>.htaccess</code> em um diretório
<code>/www/htdocs/example</code> contendo uma diretriz, e
adicionar a mesma diretriz em uma seção <em>Directory</em>
<code><Directory /www/htdocs/example></code> na configuração
principal do seu servidor:</p>
<p>Arquivo <code>.htaccess</code> em <code>/www/htdocs/example</code>:</p>
<div class="example"><h3>Conteúdo de um arquivo .htaccess em
<code>/www/htdocs/example</code></h3><p><code>
AddType text/example .exm
</code></p></div>
<div class="example"><h3>Seção do seu arquivo <code>httpd.conf</code></h3><p><code>
<Directory /www/htdocs/example><br />
<span class="indent">
AddType text/example .exm<br />
</span>
</Directory>
</code></p></div>
<p>No entanto, adicionando isso ao seu arquivo de configuração do
servidor resultará em uma menor perda de performance, na medida que
a configuração é carregada no momento da inicialização do
servidor, ao invés de toda que que um arquivo é requerido.</p>
<p>O uso de arquivos <code>.htaccess</code> pode ser totalmente
desabilitado, ajustando a diretriz <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> para <code>none</code>:</p>
<div class="example"><p><code>
AllowOverride None
</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="how" id="how">Como as diretrizes são aplicadas</a></h2>
<p>As diretrizes de configuração que se encontram em um arquivo
<code>.htaccess</code> são aplicadas para o diretório no qual o
arquivo <code>.htaccess</code> se encontra, e para todos os
subdiretórios ali presentes. Mas, é importante lembrar também que
podem existir arquivos <code>.htaccess</code> no diretórios
superiores. As diretrizes são aplicadas na ordem que são
achadas. Logo, um arquivo <code>.htaccess</code> em um diretório
em particular, pode sobrescrever as diretrizes encontradas em um
diretório acima deste em sua respectiva árvore. Estes, por sua vez,
podem ter suas diretrizes sobrescritas por diretrizes ainda mais
acima, ou no próprio arquivo de configuração principal do
servidor.</p>
<p>Exemplo:</p>
<p>No diretório <code>/www/htdocs/example1</code> nós temos
um arquivo <code>.htaccess</code> contendo o seguinte:</p>
<div class="example"><p><code>
Options +ExecCGI
</code></p></div>
<p>(Nota: você deve ter "<code>AllowOverride Options</code>" para
permitir o uso da diretriz "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" nos arquivos
<code>.htaccess</code> .)</p>
<p>No diretório <code>/www/htdocs/example1/example2</code> nós temos
um arquivo <code>.htaccess</code> contendo:</p>
<div class="example"><p><code>
Options Includes
</code></p></div>
<p>Devido a esse segundo arquivo <code>.htaccess</code>, no
diretório <code>/www/htdocs/example1/example2</code>, a execução
de scripts CGI não é permitida, pois somente <code>Options
Includes</code> está em efeito, o que sobrescreve completamente
quaisquer outros ajustes previamente configurados.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="auth" id="auth">Exemplo de Autenticação</a></h2>
<p>Se você veio diretamente à esta parte do documento para
aprender como fazer autenticação, é importante notar uma
coisa. Existe uma concepção errada, mas muito comum, de que é
necessário o uso de arquivos <code>.htaccess</code> para implementar
a autenticação por senha. Este não é o caso. Colocar
diretrizes de senha em uma seção <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, no seu arquivo principal de
configuração do servidor, é a melhor maneira de se implementar
isto, e os arquivos <code>.htaccess</code> devem ser usados apenas
se você não tem acesso ao arquivo principal de configuração do
servidor. Veja <a href="#when">acima</a> a discussão sobre quando
você deve e quando não deve usar os arquivos
<code>.htaccess</code>.</p>
<p>Dito isso, se você ainda acredita que precisa usar um arquivo
<code>.htaccess</code>, a configuração a seguir provavelmente
funcionará para você.</p>
<p>Conteúdo de um arquivo <code>.htaccess</code>:</p>
<div class="example"><p><code>
AuthType Basic<br />
AuthName "Password Required"<br />
AuthUserFile /www/passwords/password.file<br />
AuthGroupFile /www/passwords/group.file<br />
Require Group admins
</code></p></div>
<p>Note que <code>AllowOverride AuthConfig</code> precisa estar
habilitado para que estas diretrizes tenham efeito.</p>
<p>Por favor veja o <a href="auth.html">tutorial de
autenticação</a> para uma discussão mais completa sobre
autenticação e autorização.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ssi" id="ssi">Exemplo de Server Side Includes</a></h2>
<p>Outro uso comum de arquivos <code>.htaccess</code> é ativar o
Server Side Includes para um diretório em particular. Isto pode
ser feito com as seguintes diretrizes de configuração, colocadas em
um arquivo <code>.htaccess</code> no diretório desejado:</p>
<div class="example"><p><code>
Options +Includes<br />
AddType text/html shtml<br />
AddHandler server-parsed shtml
</code></p></div>
<p>Note que ambos <code>AllowOverride Options</code> e
<code>AllowOverride FileInfo</code> precisam estar habilitados
para essas diretrizes terem efeito.</p>
<p>Por favor veja o <a href="ssi.html">tutorial de SSI</a> para
uma discussão mais completa sobre server-side includes.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">Exemplo de CGI</a></h2>
<p>Finalmente, você pode querer que um arquivo
<code>.htaccess</code> permita a execução de programas CGI em um
diretório em particular. Isto pode ser implementado com as
seguintes configurações:</p>
<div class="example"><p><code>
Options +ExecCGI<br />
AddHandler cgi-script cgi pl
</code></p></div>
<p>Alternativamente, se você desejar que todos os arquivos de um
dado diretório, sejam considerados programas CGI, isso pode ser
feito com a seguinte configuração:</p>
<div class="example"><p><code>
Options +ExecCGI<br />
SetHandler cgi-script
</code></p></div>
<p>Note que ambos <code>AllowOverride Options</code> e
<code>AllowOverride FileInfo</code> precisam estar habilitados
para que essas diretrizes tenham quaisquer efeito.</p>
<p>Por favor veja o <a href="cgi.html">tutorial de CGI
tutorial</a> para uma discussão mais completa sobre programação
e configuração CGI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot">Resolvendo Problemas</a></h2>
<p>Quando você adiciona diretrizes de configuração em um arquivo
<code>.htaccess</code>, e não obtém o efeito desejado, existe uma
série de pontos que podem estar errados.</p>
<p>Mais comumente, o problema é que a diretriz <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> não está habilitada
corretamente para que as suas diretrizes de configurações sejam
honradas. Verifique se você não possui <code>AllowOverride
None</code> ajustado para o escopo do arquivo em questão. Um bom
meio de testar isso é colocar "lixo" em seu arquivo
<code>.htaccess</code> e recarregá-lo. Se não for gerado nenhum
erro do servidor, certamente você tem <code>AllowOverride
None</code> habilitado.</p>
<p>Se, por outro lado, você está obtendo erros do servidor ao
tentar acessar documentos, verifique o registro de erros do
Apache. Ele provavelmente irá indicar que a diretriz usada em
seu arquivo <code>.htaccess</code> não é permitida.
Alternativamente, ele pode acusar erros de sintaxe que você terá
que corrigir.</p>
</div></div>
<div class="bottomlang">
<p><span>Línguas Disponíveis: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" title="Português (Brasil)"> pt-br </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentários</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/htaccess.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licenciado sob a <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Diretrizes</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossário</a> | <a href="../sitemap.html">Mapa do site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/index.html.ko.euc-kr 0000664 0001751 0001751 00000014446 14743132254 021777 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>How-To / 丮 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>How-To / 丮</h1>
<div class="toplang">
<p><span> : </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="howto" id="howto">How-To / 丮</a></h2>
<dl>
<dt></dt>
<dd>
<p>(authentication) ڽ ϴ
Ȯϴ ̴. Ѻο(authorization)
Ȥ ϴ ϴ ̴.</p>
<p>: <a href="auth.html">, Ѻο, </a></p>
</dd>
</dl>
<dl>
<dt>CGI </dt>
<dd>
<p>CGI (Common Gateway Interface) CGI
α Ȥ CGI ũƮϰ θ, (
) ܺ α ȣۿϴ Ѵ.
Ʈ ϰ
̴. ġ CGI ϴ
Ұϰ, CGI α ۼغ.</p>
<p>: <a href="cgi.html">CGI: </a></p>
</dd>
</dl>
<dl>
<dt><code>.htaccess</code> </dt>
<dd>
<p><code>.htaccess</code> Ͽ 丮
ִ. þ ִ
Ư 丮 θ, 丮 丮
þ Ѵ.</p>
<p>: <a href="htaccess.html"><code>.htaccess</code>
</a></p>
</dd>
</dl>
<dl>
<dt>Server Side Includes Ұ</dt>
<dd>
<p>SSI (Server Side Includes) HTML ϴ
þ, Ҷ óѴ. SSI
ϸ CGI α̳ ٸ
ü ʰ HTML
߰ ִ.</p>
<p>: <a href="ssi.html">Server Side Includes (SSI)</a></p>
</dd>
</dl>
<dl>
<dt>ں 丮</dt>
<dd>
<p> ڰ ִ ýۿ <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> þ ϸ
ڴ ڽ Ȩ丮 ȿ Ʈ
ִ. URL <code>http://example.com/~username/</code>
ϸ "<code>username</code>" Ȩ丮
<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
þ 丮 ִ
ȴ.</p>
<p>: <a href="public_html.html"> 丮
(<code>public_html</code>)</a></p>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/public_html.html.ko.euc-kr 0000664 0001751 0001751 00000026310 14743132254 023163 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ں 丮 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>ں 丮</h1>
<div class="toplang">
<p><span> : </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/public_html.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ڰ ִ ýۿ <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> þ ϸ
ڴ ڽ Ȩ丮 ȿ Ʈ ִ.
URL <code>http://example.com/~username/</code> ϸ
"<code>username</code>" Ȩ丮 <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> þ
丮 ִ ȴ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">ں 丮</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#userdir">UserDir ϰ ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#enable"> ̿ ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi"> ں cgi 丮 ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#htaccess">ڰ ֵ </a></li>
</ul><h3></h3><ul class="seealso"><li><a href="../urlmapping.html">URL Ͻýۿ </a></li><li><a href="#comments_section">Comments</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="related" id="related">ں 丮</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></li><li><code class="directive"><a href="../mod/core.html#directorymatch">DirectoryMatch</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="userdir" id="userdir">UserDir ϰ ϱ</a></h2>
<p><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
þ ں 丮 Ѵ.
þ .</p>
<p> ʴ θ ϸ
Ȩ丮 丮 η óѴ. ,
Ʒ :</p>
<div class="example"><p><code>
UserDir public_html
</code></p></div>
<p>URL <code>http://example.com/~rbowen/file.html</code>
<code>/home/rbowen/public_html/file.html</code>
Ѵ.</p>
<p> ϴ θ ϸ 丮
ڸ 丮 θ Ѵ. , Ʒ
:</p>
<div class="example"><p><code>
UserDir /var/html
</code></p></div>
<p>URL <code>http://example.com/~rbowen/file.html</code>
<code>/var/html/rbowen/file.html</code> Ѵ.</p>
<p>ǥ (*) θ ϸ ǥ ڸ
ü θ Ѵ. , Ʒ :</p>
<div class="example"><p><code>
UserDir /var/www/*/docs
</code></p></div>
<p>URL <code>http://example.com/~rbowen/file.html</code>
<code>/var/www/rbowen/docs/file.html</code>
Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="enable" id="enable"> ̿ ϱ</a></h2>
<p>UserDir ִ Ͽ ں 丮
̿ ִ ڸ ִ:</p>
<div class="example"><p><code>
UserDir enabled<br />
UserDir disabled root jro fish
</code></p></div>
<p> <code>disabled</code> 忡
ϰ ڿ 丮 Ѵ. ,
ڸ ϰ
ִ:</p>
<div class="example"><p><code>
UserDir disabled<br />
UserDir enabled rbowen krietz
</code></p></div>
<p><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
ִ ٸ 鵵 ϶.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi"> ں cgi 丮 ϱ</a></h2>
<p>ڸ cgi-bin 丮 οϷ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> þ
Ͽ Ȩ丮 Ư 丮 cgi ϰ
.</p>
<div class="example"><p><code>
<Directory /home/*/public_html/cgi-bin/><br />
Options ExecCGI<br />
SetHandler cgi-script<br />
</Directory>
</code></p></div>
<p><code>UserDir</code> <code>public_html</code>̶
ϸ, ȿ ִ cgi α
<code>example.cgi</code> ִ.</p>
<div class="example"><p><code>
http://example.com/~rbowen/cgi-bin/example.cgi
</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="htaccess" id="htaccess">ڰ ֵ </a></h2>
<p>ڰ ڽ Ϸ,
<code>.htaccess</code> ־ Ѵ. <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> ڰ
ִ þ ϶. ϴ
ڼ <a href="htaccess.html">.htaccess
丮</a> ϶.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/public_html.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/public_html.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/ssi.html.ko.euc-kr 0000664 0001751 0001751 00000054452 14743132254 021467 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ġ 丮: Server Side Includes Ұ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>ġ 丮: Server Side Includes Ұ</h1>
<div class="toplang">
<p><span> : </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/ssi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/ssi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/ssi.html" title="Korean"> ko </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>Server-side includes Ͽ HTML
߰ ִ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Ұ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what">SSI ΰ?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuring">SSI ϵ ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#basic">⺻ SSI þ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#additionalexamples">߰ </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#config">̿ܿ ִ ?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exec">ɾ ϱ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#advanced"> SSI </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#conclusion"></a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="related" id="related">Ұ</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_include.html">mod_include</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_expires.html">mod_expires</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code></li><li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li><li><code class="directive"><a href="../mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li></ul></td></tr></table>
<p> SSI θ Server Side Includes Ѵ.
SSI ϵ ϴ HTML
߰ϴ ⺻ SSI ҰѴ.</p>
<p> κ SSI þ ǹ ޱ
Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">SSI ΰ?</a></h2>
<p>SSI (Server Side Includes) HTML ϴ þ,
Ҷ óѴ. SSI ϸ CGI
α̳ ٸ ü
ʰ HTML ߰
ִ.</p>
<p>SSI ƴϸ α ü
κ
ٽ ؾ ȴ. SSI
ð ߰ϴµ .
Ҷ κ ؾ Ѵٸ ٸ
ãƺ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuring" id="configuring">SSI ϵ ϱ</a></h2>
<p> SSI óϷ <code>httpd.conf</code> ̳
<code>.htaccess</code> Ͽ þ ؾ Ѵ.</p>
<div class="example"><p><code>
Options +Includes
</code></p></div>
<p> ġ Ͽ SSI þ óѴ.
<code class="directive"><a href="../mod/core.html#options">Options</a></code> þ
ְ, þ Ἥ ȿ .
þ Ǹ óϱ SSI ϴ Ư
丮 <code>Options</code> Ѵ.</p>
<p> Ͽ SSI þ óϴ ƴϴ. ġ
ó ˷ Ѵ. ΰ ִ.
ϳ þ <code>.shtml</code> Ư
Ȯڸ óϴ ̴.</p>
<div class="example"><p><code>
AddType text/html .shtml<br />
AddOutputFilter INCLUDES .shtml
</code></p></div>
<p> ̹ ִ SSI þ ߰ϴ
SSI þ óϱ <code>.shtml</code> Ȯڸ
οϱ ϸ ũ ؾ
ϴ ̴.</p>
<p>ٸ <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>
þ ϴ ̴.</p>
<div class="example"><p><code>
XBitHack on
</code></p></div>
<p><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>
ִ Ͽ SSI þ óѴ. ̹
ִ SSI þ ߰Ѵٸ ϸ
ʰ <code>chmod</code> Ͽ ָ ȴ.</p>
<div class="example"><p><code>
chmod +x pagename.html
</code></p></div>
<p> ƾ ϳ. <code>.shtml</code> ϸ
ġ <code>.html</code> SSI ó϶
ϴ ִ. Ƹ <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>
. ̷ ϸ ġ Ͽ SSI þ
Ŭ̾Ʈ Ѵٴ
̴. ſ , ƴϴ.</p>
<p> ̶ ڸ
.</p>
<p> ̿ ϱ Ʊ ġ ⺻
SSI ֱټϰ content length HTTP
ʴ´. ij ϰ Ŭ̾Ʈ
. ΰ ذ ִ.</p>
<ol>
<li><code>XBitHack Full</code> Ѵ.
ġ ϴ(include) ϵ ü
û ¥ ֱټ ˾Ƴ.</li>
<li><code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code> ִ þ Ͽ
Ͽ ϸ Ͻð
ij ִ.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="basic" id="basic">⺻ SSI þ</a></h2>
<p>SSI þ .</p>
<div class="example"><p><code>
<!--#element attribute=value attribute=value ... -->
</code></p></div>
<p>HTML ּ SSI ʾƵ
HTML ҽ Ѵ. SSI ùٷ
ϸ þ ٲ۴.</p>
<p>element ϳ. ȸ ڼ ̴.
SSI ִ δ</p>
<h3><a name="todaysdate" id="todaysdate"> ¥</a></h3>
<div class="example"><p><code>
<!--#echo var="DATE_LOCAL" -->
</code></p></div>
<p><code>echo</code> element ״ Ѵ.
CGI α ϴ ȯ溯 ܿ ǥ
ִ. , <code>set</code> element Ͽ
ִ.</p>
<p>¥ ʴ´ٸ,
<code>config</code> element <code>timefmt</code> attribute
Ѵ.</p>
<div class="example"><p><code>
<!--#config timefmt="%A %B %d, %Y" --><br />
Today is <!--#echo var="DATE_LOCAL" -->
</code></p></div>
<h3><a name="lastmodified" id="lastmodified"> </a></h3>
<div class="example"><p><code>
<!--#flastmod file="index.html" --> Ǿ
</code></p></div>
<p> element <code>timefmt</code> ȴ.</p>
<h3><a name="cgi" id="cgi">CGI α ϱ</a></h3>
<p>Ϲ SSI ϳ, ̵ ֿϴ ``湮
ī'' CGI α Ѵ.</p>
<div class="example"><p><code>
<!--#include virtual="/cgi-bin/counter.pl" -->
</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="additionalexamples" id="additionalexamples">߰ </a></h2>
<p> HTML ִ SSI .</p>
<h3><a name="docmodified" id="docmodified">
Ǿ?</a></h3>
<p>տ SSI Ͽ ڿ ֱټ
˸ ִٰ ߴ. ˷ ʾҴ.
ڵ带 HTML ϸ ð .
Ѵ SSI ùٷ ۵ؾ Ѵ.</p>
<div class="example"><p><code>
<!--#config timefmt="%A %B %d, %Y" --><br />
<!--#flastmod file="ssi.shtml" --> Ǿ;
</code></p></div>
<p> <code>ssi.shtml</code> ϴ ϸ
Ѵ. ƹ ٿ ִ ڵ带
Ѵٸ, ϸ <code>LAST_MODIFIED</code>
Ѵ.</p>
<div class="example"><p><code>
<!--#config timefmt="%D" --><br />
This file last modified <!--#echo var="LAST_MODIFIED" -->
</code></p></div>
<p><code>timefmt</code> Ŀ ڼ ˻
<code>strftime</code> ãƺ. .</p>
<h3><a name="standard-footer" id="standard-footer">ǥ ϴ ϱ</a></h3>
<p> ִ Ʈ Ѵٸ ü
ϴ , Ư ǥ ܰ ϴ
Ӵ.</p>
<p> (header) ϴ(footer) Ϸ Ͽ
̷ δ ִ.
<code>include</code> SSI ɾ Ͽ ϴ
ϳ ϸ ȴ. <code>include</code> element
<code>file</code> attribute <code>virtual</code> attribute
Ѵ. <code>file</code> attribute <em>
丮 </em> ϰδ. , (/ ϴ)
ϰγ ȿ ../ . Ƹ ϴ
URL ִ <code>virtual</code> attribute
̴. θ / , Ϸ
ϴ ϰ ־ Ѵ.</p>
<div class="example"><p><code>
<!--#include virtual="/footer.html" -->
</code></p></div>
<p> ΰ ļ ϴ Ͽ
<code>LAST_MODIFIED</code> þ ִ´. Ϸ Ͽ
SSI þ , ̷ ٸ
ϴ ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="config" id="config">̿ܿ ִ ?</a></h2>
<p>ð <code>config</code>() ܿ ΰ
<code>config</code>() ִ.</p>
<p> SSI þ ߸Ǹ ´</p>
<div class="example"><p><code>
[an error occurred while processing this directive]
</code></p></div>
<p> ϰ ʹٸ <code>config</code> element
<code>errmsg</code> attribute Ͽ Ѵ.</p>
<div class="example"><p><code>
<!--#config errmsg="[It appears that you don't know how to use SSI]" -->
</code></p></div>
<p>Ʈ ϱ SSI þ ذϿ
ڰ ̷ ʱ ٶ. (?)</p>
<p> <code>sizefmt</code> attribute ȯϴ ũ
<code>config</code>() ִ. Ʈ ũ⸦
ַ <code>bytes</code>, Kb Mb ũ⸦
ַ <code>abbrev</code> Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exec" id="exec">ɾ ϱ</a></h2>
<p> CGI α SSI ϴ
̴. <code>exec</code> element
ִ ٸ ͵ ̴. SSI (Ȯ
<code>/bin/sh</code> Win32 Ѵٸ DOS ) Ͽ
ɾ Ѵ. , 丮 ش.</p>
<div class="example"><p><code>
<pre><br />
<!--#exec cmd="ls" --><br />
</pre>
</code></p></div>
<p>or, on Windows</p>
<div class="example"><p><code>
<pre><br />
<!--#exec cmd="dir" --><br />
</pre>
</code></p></div>
<p><code>dir</code> ¿ ȥ
``<<code>dir</code>>'' ڿ Եֱ,
þ ϸ ̻ ̴.</p>
<p> <code>exec</code> ± ɾ
ֱ ſ ϴ. ``'' ڰ
ִ ȯ̶,
ؼ ȵȴ. <code>Options</code> þ
<code>IncludesNOEXEC</code> ƱԸƮ Ͽ SSI
<code>exec</code> ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="advanced" id="advanced"> SSI </a></h2>
<p> ϴ ܿ ġ SSI ϰ,
ǹ ִ.</p>
<h3><a name="caveat" id="caveat"></a></h3>
<p> ۿ ϴ κ ġ 1.2 ĺ
ִ. , ġ 1.2 ̻ ʴ´ٸ
Ƹ ̵ؾ Ѵ. ض. ض. ٸ
̴.</p>
<h3><a name="variables" id="variables"> </a></h3>
<p><code>set</code> þ Ͽ ߿
ִ. ʿϱ Ѵ.
.</p>
<div class="example"><p><code>
<!--#set var="name" value="Rich" -->
</code></p></div>
<p> ڱ״ ʰ <a href="../env.html">ȯ溯</a> (
, <code>LAST_MODIFIED</code>) ٸ Ͽ
ִ. ̶ տ ǥ($)
ٿ ڿ ƴ ǥѴ.</p>
<div class="example"><p><code> <!--#set var="modified" value="$LAST_MODIFIED" -->
</code></p></div>
<p> ڸ ״ ԷϷ ǥ տ
齽 Ѵ.</p>
<div class="example"><p><code>
<!--#set var="cost" value="\$100" -->
</code></p></div>
<p> ڿ ߰ ϴµ ڿ ִ
ڵ Ͽ ȥǴ , ȣ
Ȯ Ѵ. ( ã ,
ϱ ٶ.)</p>
<div class="example"><p><code>
<!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" -->
</code></p></div>
<h3><a name="conditional" id="conditional"> ǥ</a></h3>
<p> ϰ ǹ ϴ.
SSI α־ ȴ.
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> ǹ <code>if</code>,
<code>elif</code>, <code>else</code>, <code>endif</code>
Ѵ.
ִ.</p>
<p>ǹ .</p>
<div class="example"><p><code>
<!--#if expr="test_condition" --><br />
<!--#elif expr="test_condition" --><br />
<!--#else --><br />
<!--#endif -->
</code></p></div>
<p><em>test_condition</em>
ִ. ٸ ϰų, Ư ``''
˻Ѵ. (ڿ ̴.) 밡
ڸ , <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
϶. ǹ .</p>
<p>Ͽ ߰Ѵ.</p>
<div class="example"><p><code>
BrowserMatchNoCase macintosh Mac<br />
BrowserMatchNoCase MSIE InternetExplorer
</code></p></div>
<p>Ŭ̾Ʈ Ųÿ ϴ Internet Explorer
ȯ溯 ``Mac'' ``InternetExplorer'' Ѵ.</p>
<p> SSI ´.</p>
<div class="example"><p><code>
<!--#if expr="${Mac} && ${InternetExplorer}" --><br />
´<br />
<!--#else --><br />
JavaScript ڵ尡 ´<br />
<!--#endif -->
</code></p></div>
<p> Ų IE ݰ ִ ƴϴ.
ֿ ٸ JavaScript ڵ尡 Ų
IE ʾƼ ð ߴ. ӽ
ذå̴.</p>
<p>( Ͽ Ϲ ȯ溯̰) ǹ
ִ. ƶġ <code>SetEnvIf</code> ٸ
þ ȯ溯 ֱ CGI ̵
ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="conclusion" id="conclusion"></a></h2>
<p>SSI Ȯ CGI ϴ ٸ
ü . ߰ ۾
߰ϱ Ǹ ̴.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/ssi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/ssi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/ssi.html" title="Korean"> ko </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/ssi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/htaccess.html.fr.utf8 0000664 0001751 0001751 00000074462 14740503670 022170 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Tutoriel du serveur HTTP Apache : fichiers .htaccess - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Recettes / Tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Tutoriel du serveur HTTP Apache : fichiers .htaccess</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
</div>
<p>Les fichiers <code>.htaccess</code> fournissent une méthode pour
modifier la configuration du serveur au niveau de chaque répertoire.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Fichiers .htaccess</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what">Que sont ce fichiers, comment les utiliser ?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#when">Quand doit-on (ne doit-on pas) utiliser
les fichiers .htaccess ?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#how">Comment sont appliquées les directives ?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#auth">Exemple d'authentification</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ssi">Exemple d'Inclusion Côté Serveur (Server Side
Includes - SSI)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewrite">Les règles de réécriture dans les fichiers .htaccess</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">Exemple de CGI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">Résolution des problèmes</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="related" id="related">Fichiers .htaccess</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</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_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</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/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li></ul></td></tr></table>
<div class="note">Les fichiers <code>.htaccess</code> ne doivent être utilisés
que si vous n'avez pas accès au fichier de configuration du serveur
principal. L'utilisation des fichiers <code>.htaccess</code>
ralentit le fonctionnement de votre serveur HTTP Apache. Il est toujours
préférable de définir les directives que vous pouvez inclure dans un
fichier <code>.htaccess</code> dans une section <code class="directive"><a href="../mod/core.html#directory">Directory</a></code>, car elles produiront le
même effet avec de meilleures performances.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">Que sont ce fichiers, comment les utiliser ?</a></h2>
<p>Les fichiers <code>.htaccess</code> (ou "fichiers de
configuration distribués") fournissent une méthode pour modifier la
configuration du serveur au niveau d'un répertoire. Un fichier,
contenant une ou plusieurs directives de configuration, est placé
dans un répertoire de documents particulier, et ses directives
s'appliquent à ce répertoire et à tous ses sous-répertoires.</p>
<div class="note"><h3>Note :</h3>
<p>Si vous voulez donner un autre nom à votre fichier
<code>.htaccess</code>, vous pouvez le faire en utilisant la
directive <code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code>. Par
exemple, si vous préférez nommer votre fichier
<code>.config</code>, vous pouvez mettre ceci dans le fichier de
configuration de votre serveur :</p>
<pre class="prettyprint lang-config">AccessFileName ".config"</pre>
</div>
<p>En général, les fichiers <code>.htaccess</code> utilisent la même
syntaxe que les <a href="../configuring.html#syntax">fichiers de
configuration principaux</a>. Ce que vous pouvez mettre dans ces
fichier est déterminé par la directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>. Cette directive spécifie,
sous forme de catégories, quelles directives seront traitées si
elles se trouvent dans un fichier <code>.htaccess</code>. Si une
directive est permise dans un fichier <code>.htaccess</code> file,
la documentation de cette directive contiendra une section Override,
spécifiant quelle valeur doit prendre <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> pour que cette directive
soit traitée.</p>
<p>Par exemple, si vous regardez la documentation de la directive
<code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>, vous verrez
que cette dernière est permise dans les fichiers
<code>.htaccess</code> (Voir la ligne de contexte dans le résumé de
la directive). La ligne <a href="../mod/directive-dict.html#Context">Override</a> indique
<code>FileInfo</code>. Vous devez donc avoir au moins
<code>AllowOverride FileInfo</code> pour que cette directive soit
traitée dans les fichiers <code>.htaccess</code>.</p>
<div class="example"><h3>Exemple :</h3><table>
<tr>
<td><a href="../mod/directive-dict.html#Context">Contexte :</a></td>
<td>configuration du serveur, serveur virtuel, directory, .htaccess</td>
</tr>
<tr>
<td><a href="../mod/directive-dict.html#Override">Override:</a></td>
<td>FileInfo</td>
</tr>
</table></div>
<p>Si vous n'êtes pas sûr qu'une directive particulière soit permise
dans un fichier <code>.htaccess</code>, lisez la documentation de
cette directive, et consultez la ligne de contexte pour
".htaccess".</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="when" id="when">Quand doit-on (ne doit-on pas) utiliser
les fichiers .htaccess ?</a></h2>
<p>En principe, vous ne devriez utiliser les fichiers
<code>.htaccess</code> que lorsque vous n'avez pas accès au fichier de
configuration du serveur principal. Par exemple, la fausse
idée
selon laquelle l'authentification de l'utilisateur devrait toujours
être faite dans les fichiers <code>.htaccess</code> est très
répandue. Il est aussi souvent avancé, ces dernières
années, que les directives de <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> doivent
être définies dans les fichiers <code>.htaccess</code>. Ceci est
tout simplement faux. Vous pouvez configurer
l'authentification des utilisateurs au niveau de la configuration du
serveur principal, et c'est en fait cette méthode qui doit être
privilégiée. De même, les directives de
<code>mod_rewrite</code> fonctionneront mieux, à de nombreux égards,
dans le contexte du serveur principal.</p>
<p>Les fichiers <code>.htaccess</code> ne devraient être utilisés
que dans le cas où les fournisseurs de contenu ont besoin de
modifier la configuration du serveur au niveau d'un répertoire, mais
ne possèdent pas l'accès root sur le système du serveur. Si
l'administrateur du serveur ne souhaite pas effectuer des
modifications de configuration incessantes, il peut être intéressant
de permettre aux utilisateurs isolés d'effectuer eux-mêmes ces
modifications par le biais de fichiers <code>.htaccess</code>. Ceci
est particulièrement vrai dans le cas où le fournisseur d'accès à
Internet héberge de nombreux sites d'utilisateurs sur un seul
serveur, et souhaite que ces utilisateurs puissent modifier
eux-mêmes leurs configurations.</p>
<p>Cependant et d'une manière générale, il vaut mieux éviter
d'utiliser les fichiers <code>.htaccess</code>. Tout élément de
configuration que vous pourriez vouloir mettre dans un fichier
<code>.htaccess</code>, peut aussi être mis, et avec la même
efficacité, dans une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> du fichier de configuration de
votre serveur principal.</p>
<p>Il y a deux raisons principales d'éviter l'utilisation des
fichiers <code>.htaccess</code>.</p>
<p>La première est liée aux performances. Lorsque la directive
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> est définie de
façon à autoriser l'utilisation des fichiers <code>.htaccess</code>,
httpd va rechercher leur présence dans chaque répertoire. Ainsi,
permettre l'utilisation des fichiers <code>.htaccess</code> est déjà
en soi une cause de dégradation des performances, que vous utilisiez
effectivement ces fichiers ou non ! De plus, le fichier
<code>.htaccess</code> est chargé en mémoire chaque fois qu'un
document fait l'objet d'une requête.</p>
<p>Notez aussi que httpd doit rechercher les fichiers
<code>.htaccess</code> dans tous les répertoires de niveau
supérieur, afin de rassembler toutes les directives qui s'appliquent
au répertoire courant (Voir la section <a href="#how">comment sont
appliquées les directives</a>). Ainsi, si un fichier fait l'objet
d'une requête à partir d'un répertoire
<code>/www/htdocs/exemple</code>, httpd doit rechercher les
fichiers suivants :</p>
<div class="example"><p><code>
/.htaccess<br />
/www/.htaccess<br />
/www/htdocs/.htaccess<br />
/www/htdocs/exemple/.htaccess
</code></p></div>
<p>En conséquence, chaque accès à un fichier de ce répertoire
nécessite 4 accès au système de fichiers supplémentaires pour
rechercher des fichiers <code>.htaccess</code>, même si
aucun de ces fichiers n'est présent. Notez que cet exemple ne peut
se produire que si les fichiers <code>.htaccess</code> ont été
autorisés pour le répertoire <code>/</code>, ce qui est rarement le
cas.</p>
<p>La seconde raison d'éviter l'utilisation des fichiers
<code>.htaccess</code> est liée à la sécurité. Si vous permettez aux
utilisateurs de modifier la configuration du serveur, il peut en
résulter des conséquences sur lesquelles vous n'aurez aucun
contrôle. Réfléchissez bien avant de donner ce privilège à vos
utilisateurs. Notez aussi que ne pas donner aux utilisateurs les
privilèges dont ils ont besoin va entraîner une augmentation des
demandes de support technique. Assurez-vous d'avoir informé
clairement vos utilisateurs du niveau de privilèges que vous leur
avez attribué. Indiquer exactement comment vous avez défini la
directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> et
diriger les utilisateurs vers la documentation correspondante vous
évitera bien des confusions ultérieures.</p>
<p>Notez que mettre un fichier <code>.htaccess</code> contenant une
directive dans un répertoire <code>/www/htdocs/exemple</code>
revient exactement au même que mettre la même directive dans une
section Directory <code><Directory "/www/htdocs/exemple"></code>
du fichier de configuration de votre serveur principal :</p>
<p>Fichier <code>.htaccess</code> dans
<code>/www/htdocs/exemple</code> :</p>
<div class="example"><h3>Contenu du fichier .htaccess dans
<code>/www/htdocs/exemple</code></h3><pre class="prettyprint lang-config">AddType text/example ".exm"</pre>
</div>
<div class="example"><h3>Section de votre fichier
<code>httpd.conf</code></h3><pre class="prettyprint lang-config"><Directory "/www/htdocs/example">
AddType text/example .exm
</Directory></pre>
</div>
<p>Cependant, la perte de performances sera moindre si vous
définissez cette directive dans la configuration de
votre serveur principal, car cette dernière ne sera chargée qu'une
seule fois au moment du démarrage du serveur, alors qu'elle le sera
à chaque accès dans le cas d'un fichier <code>.htaccess</code>.</p>
<p>L'utilisation des fichiers <code>.htaccess</code> peut être
entièrement désactivée en définissant la directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> à <code>none</code> :</p>
<pre class="prettyprint lang-config">AllowOverride None</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="how" id="how">Comment sont appliquées les directives ?</a></h2>
<p>Les directives de configuration situées dans un fichier
<code>.htaccess</code> s'appliquent au répertoire dans lequel ce
fichier <code>.htaccess</code> se trouve, ainsi qu'à tous ses
sous-répertoires. Cependant, il est important de garder à l'esprit
qu'il peut y avoir des fichiers <code>.htaccess</code> dans les
répertoires de niveau supérieur. Les directives sont appliquées
selon l'ordre dans lequel elles sont rencontrées. Ainsi, les
directives d'un fichier <code>.htaccess</code> situé dans un
répertoire particulier peuvent écraser les directives se trouvant
dans des fichiers <code>.htaccess</code> situés à un niveau
supérieur dans l'arborescence des répertoires. Et ces dernières
peuvent elles-mêmes avoir écrasé des directives d'un fichier
<code>.htaccess</code> situé à un niveau encore plus haut, ou dans
le fichier de configuration du serveur principal.</p>
<p>Exemple :</p>
<p>Dans le répertoire <code>/www/htdocs/exemple1</code> se trouve un
fichier <code>.htaccess</code> contenant ce qui suit :</p>
<pre class="prettyprint lang-config">Options +ExecCGI</pre>
<p>Note : "<code>AllowOverride Options</code>" doit être présent
pour permettre l'utilisation de la directive "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" dans les fichiers
<code>.htaccess</code>.</p>
<p>Dans le répertoire <code>/www/htdocs/exemple1/exemple2</code> se
trouve un fichier <code>.htaccess</code> contenant ce qui suit
:</p>
<pre class="prettyprint lang-config">Options Includes</pre>
<p>Ainsi, à cause de ce second fichier <code>.htaccess</code> du
répertoire <code>/www/htdocs/exemple1/exemple2</code>, l'exécution
des CGI est interdite, car la dernière définition d'options
<code>Options Includes</code> écrase toute autre définition
d'options d'un fichier <code>.htaccess</code> situé dans un
répertoire de niveau supérieur.</p>
<h3><a name="merge" id="merge">Interactions entre les fichiers .htaccess
et les fichiers de configuration du serveur principal</a></h3>
<p>Comme indiqué dans la documentation sur les <a href="../sections.html">Sections de configuration</a>, les fichiers
<code>.htaccess</code> peuvent écraser les directives des sections
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> pour
le répertoire correspondant, mais peuvent eux-mêmes être écrasés
par d'autres types de sections des fichiers de la
configuration principale. Cette possibilité peut s'avérer utile pour
forcer certaines configurations, même en cas de présence de l'option
libérale <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>. Par
exemple, pour interdire l'exécution de scripts en autorisant la
définition de toute autre option dans les fichiers
<code>.htaccess</code>, vous pouvez utiliser :</p>
<pre class="prettyprint lang-config"><Directory "/www/htdocs">
AllowOverride All
</Directory>
<Location "/">
Options +IncludesNoExec -ExecCGI
</Location></pre>
<div class="note">Dans cet exemple, on considère que le chemin défini par la
directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> est
<code>/www/htdocs</code>.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="auth" id="auth">Exemple d'authentification</a></h2>
<p>Si vous accédez directement à ce point du document pour apprendre
à effectuer une authentification, il est important de noter ceci. Il
existe une fausse idée selon laquelle il serait nécessaire
d'utiliser les fichiers <code>.htaccess</code> pour implémenter
l'authentification par mot de passe. Ceci est tout simplement faux.
Pour y parvenir, il est préférable de mettre les directives
d'authentification dans une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> du fichier de configuration de
votre serveur principal, et les fichiers <code>.htaccess</code> ne
devraient être utilisés que dans le cas où vous n'avez pas accès au
fichier de configuration du serveur principal. Voir <a href="#when">ci-dessus</a> pour savoir dans quels cas vous devez ou
ne devez pas utiliser les fichiers <code>.htaccess</code>.</p>
<p>Ceci étant dit, si vous pensez que vous devez quand-même utiliser
un fichier <code>.htaccess</code>, vous pouvez utiliser la
configuration suivante :</p>
<p>Contenu du fichier <code>.htaccess</code> :</p>
<pre class="prettyprint lang-config">AuthType Basic
AuthName "Password Required"
AuthUserFile "/www/passwords/password.file"
AuthGroupFile "/www/passwords/group.file"
Require group admins</pre>
<p>Notez que <code>AllowOverride AuthConfig</code> doit être présent
pour que ces directives produisent leur effet.</p>
<p>Vous pouvez vous référer au <a href="auth.html">tutoriel sur
l'authentification</a> pour une description plus détaillée de
l'authentification et de l'autorisation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ssi" id="ssi">Exemple d'Inclusion Côté Serveur (Server Side
Includes - SSI)</a></h2>
<p>Les fichiers <code>.htaccess</code> sont aussi couramment
utilisés pour activer les SSI pour un répertoire particulier. Pour y
parvenir, on utilise les directives de configuration suivantes,
placées dans un fichier <code>.htaccess</code> enregistré dans le
répertoire considéré :</p>
<pre class="prettyprint lang-config">Options +Includes
AddType text/html shtml
AddHandler server-parsed shtml</pre>
<p>Notez que <code>AllowOverride Options</code> et <code>AllowOverride
FileInfo</code> doivent être tous les deux présents pour que ces
directives puissent produire leur effet.</p>
<p>Vous pouvez vous référer au <a href="ssi.html">tutoriel SSI</a>
pour une description plus détaillée des SSI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">Les règles de réécriture dans les fichiers .htaccess</a></h2>
<p>Sivous utilisez des directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> dans un fichier
<code>.htaccess</code>, gardez à l'esprit que les choses sont légèrement
différentes dans un contexte de répertoire. En particulier, les règles
sont relatives au répertoire courant, et non à l'URI original. Considérez
les exemples suivants :</p>
<pre class="prettyprint lang-config"># Dans httpd.conf
RewriteRule "^/images/(.+)\.jpg" "/images/$1.png"
# Dans un fichier .htaccess situé dans le répertoire racine de vos
# documents
RewriteRule "^images/(.+)\.jpg" "images/$1.png"
# Dans un fichier .htaccess situé dans le répertoire images/
RewriteRule "^(.+)\.jpg" "$1.png"</pre>
<p>On voit que si le fichier <code>.htaccess</code> se situe à la racine
de vos documents, le slash de tête est supprimé de la valeur de
remplacement spécifiée pour la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, et que si le fichier
<code>.htaccess</code> se situe dans le répertoire <code>images</code>,
la chaîne <code>/images/</code> disparaît de cette même valeur de
remplacement. Il doit donc en être de même dans votre expression
rationnelle.</p>
<p>Veuillez vous référer à cette <a href="../rewrite/">documentation</a>
pour une étude détaillée de l'utilisation du module
<code>mod_rewrite</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">Exemple de CGI</a></h2>
<p>En fin de compte, vous avez décidé d'utiliser un fichier
<code>.htaccess</code> pour permettre l'exécution des programmes CGI
dans un répertoire particulier. Pour y parvenir, vous pouvez
utiliser la configuration suivante :</p>
<pre class="prettyprint lang-config">Options +ExecCGI
AddHandler cgi-script cgi pl</pre>
<p>Alternativement, si vous souhaitez que tous les fichiers d'un
répertoire donné soient considérés comme des programmes CGI, vous
pouvez utiliser la configuration suivante :</p>
<pre class="prettyprint lang-config">Options +ExecCGI
SetHandler cgi-script</pre>
<p>Notez que <code>AllowOverride Options</code> et <code>AllowOverride
FileInfo</code> doivent être tous les deux présents pour que ces
directives puissent produire leur effet.</p>
<p>Vous pouvez vous référer au <a href="cgi.html">tutoriel CGI</a>
pour une description plus détaillée de la configuration et de la
proprammation CGI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot">Résolution des problèmes</a></h2>
<p>De nombreuses raisons peuvent être à l'origine du fait que
les directives que vous avez mises dans un fichier
<code>.htaccess</code> ne produisent pas l'effet désiré.</p>
<p>Le plus souvent, le problème vient du fait que la définition de
la directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
ne permet pas l'activation des directives de votre fichier
<code>.htaccess</code>. Vérifiez si une directive
<code>AllowOverride None</code> n'affecte pas le répertoire où se
trouve votre fichier. Un bon test consiste à mettre des directives
dont la syntaxe est erronée dans votre ficher <code>.htaccess</code>
et de recharger la page. Si aucune erreur n'est générée par le
serveur, il est pratiquement certain qu'une directive
<code>AllowOverride None</code> affecte votre répertoire.</p>
<p>Par contre, si vous obtenez des erreurs de serveur lorsque vous
tentez d'accéder à des documents, consultez votre journal des
erreurs de httpd. Il vous indiquera probablement que la directive
utilisée dans votre fichier <code>.htaccess</code> n'est pas
permise.</p>
<div class="example"><p><code>
[Fri Sep 17 18:43:16 2010] [alert] [client 192.168.200.51] /var/www/html/.htaccess: DirectoryIndex not allowed here
</code></p></div>
<p>Cela signifie soit que vous utilisez une directive qui n'est
jamais permise dans les fichiers <code>.htaccess</code>, soit
que vous n'avez tout simplement pas défini la directive
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> à un niveau
suffisant pour la directive que vous utilisez. Consultez la
documentation de cette directive pour déterminer quel cas
s'applique.</p>
<p>Le journal des erreurs peut aussi vous signaler une erreur de
syntaxe dans l'usage de la directive elle-même.</p>
<div class="example"><p><code>
[Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
</code></p></div>
<p>Dans ce cas, le message d'erreur sera spécifique à l'erreur
de syntaxe que vous avez commise.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/htaccess.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/reverse_proxy.html.fr.utf8 0000664 0001751 0001751 00000053647 14740503670 023311 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Guide de configuration d'un mandataire inverse - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Recettes / Tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Guide de configuration d'un mandataire inverse</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/howto/reverse_proxy.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/howto/reverse_proxy.html" title="Français"> fr </a></p>
</div>
<p>En plus de ses fonctions de serveur web "basique", à savoir fournir du
contenu statique et dynamique à l'utilisateur, Apache httpd (comme la
plupart des autres serveurs web) peut aussi assurer les fonctions de serveur
mandataire inverse, connu aussi sous le nom de serveur "passerelle".</p>
<p>Dans un tel scénario, httpd ne génère et n'héberge pas lui-même les
données, le contenu étant en général obtenu à partir d'un ou plusieurs serveurs
d'arrière-plan qui n'ont normalement aucune connexion directe avec le réseau
externe. Lorsque httpd reçoit une requête en provenance d'un client, la
requête proprement dite est <em>mandatée</em> vers un de ces serveurs
d'arrière-plan qui traite la requête, génère le contenu et l'envoie à httpd,
ce dernier générant la véritable réponse HTTP à destination du client.</p>
<p>De nombreuses raisons peuvent vous motiver à utiliser cette
fonctionnalité, mais elles sont souvent du domaine de la sécurité, de
la haute disponibilité, de la répartition de charge et de
l'authentification/autorisation centralisée. Il est alors indispensable que
l'organisation, la conception et l'architecture de l'infrastructure
d'arrière-plan (les serveurs qui traitent au sens propre les requêtes) soient
isolées et protégées de l'extérieur ; vu du client, le serveur mandataire
inverse <em>est</em> le seul serveur accessible pouvant lui fournir du
contenu.</p>
<p>Voici un exemple typique d'implémentation de cette fonctionnalité :</p>
<p class="centered"><img src="../images/reverse-proxy-arch.png" alt="reverse-proxy-arch" /></p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Mandataire inverse</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#simple">Mandatement inverse simple</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cluster">Clusters et Balancers</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#config">Configuration du Balancer et des BalancerMembers</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#failover">Gestion des indisponibilités (Failover)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#manager">Gestion du répartiteur de charge</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#health-check">Vérification dynamique du bon fonctionnement d'un serveur
d'arrière-plan</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#status">Drapeaux d'état d'un membre du groupe de répartition de charge</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="related" id="related">Mandataire inverse</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li><li><code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></li><li><code class="module"><a href="../mod/mod_proxy_hcheck.html">mod_proxy_hcheck</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="../mod/mod_proxy.html#balancermember">BalancerMember</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="simple" id="simple">Mandatement inverse simple</a></h2>
<p>
La directive <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> permet de
rediriger les requêtes entrantes vers un serveur d'arrière-plan (ou un
cluster de serveurs plus connu sous le nom de groupe
<code>Balancer</code>). Dans cet exemple le plus simple, toutes les
requêtes (<code>"/"</code>) sont redirigées vers un serveur d'arrière-plan
unique :
</p>
<pre class="prettyprint lang-config">ProxyPass "/" "http://www.example.com/"</pre>
<p>
Pour être sur que cette redirection soit effectuée et que les en-têtes
<code>Location:</code> générés par le serveur d'arrière-plan soient
modifiés pour pointer vers le mandataire inverse, et non vers le serveur
d'arrière-plan, la directive <code class="directive"><a href="../mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> est souvent requise :
</p>
<pre class="prettyprint lang-config">ProxyPass "/" "http://www.example.com/"
ProxyPassReverse "/" "http://www.example.com/"</pre>
<p>Seules des URIs spécifiques peuvent être mandatées, comme le montre
l'exemple suivant :</p>
<pre class="prettyprint lang-config">ProxyPass "/images" "http://www.example.com/"
ProxyPassReverse "/images" "http://www.example.com/"</pre>
<p>Dans l'exemple précédent, si le chemin d'une requête commence par
<code>/images</code>, elle sera redirigée vers le serveur d'arrière-plan
spécifié ; dans le cas contraire, elle sera traitée localement.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cluster" id="cluster">Clusters et Balancers</a></h2>
<p>
Utiliser un serveur d'arrière-plan unique n'est cependant pas une solution
idéale car ce dernier peut devenir indisponible ou surchargé, et le
mandatement inverse vers ce serveur ne présente alors plus aucun avantage.
La solution réside dans la définition d'un groupe de serveurs
d'arrière-plan qui vont se partager le traitement des requêtes via un
mécanisme de répartition de charge et de gestion des indisponibilités pris
en charge par le mandataire. Ce groupe de répartition est plus connu sous le nom de
<em>cluster</em>, mais dans la terminologie d'Apache httpd, on utilise
plutôt le terme de <em>balancer</em>. Un balancer se définit en
utilisant les directives <code class="directive"><a href="../mod/mod_proxy.html#proxy"><Proxy></a></code> et <code class="directive"><a href="../mod/mod_proxy.html#balancermember">BalancerMember</a></code> comme suit :
</p>
<pre class="prettyprint lang-config"><Proxy balancer://myset>
BalancerMember http://www2.example.com:8080
BalancerMember http://www3.example.com:8080
ProxySet lbmethod=bytraffic
</Proxy>
ProxyPass "/images/" "balancer://myset/"
ProxyPassReverse "/images/" "balancer://myset/"</pre>
<p>
Le protocole <code>balancer://</code> indique à httpd que l'on souhaite
créer un balancer nommé <em>myset</em>. Ce balancer comporte deux serveurs
d'arrière-plan référencés dans la terminologie httpd sous le nom de
<em>BalancerMembers</em>. Avec cet exemple, toute requête dont le chemin
commence par <code>/images</code> sera mandatée vers <em>un</em> des deux
serveurs d'arrière-plan. La directive <code class="directive"><a href="../mod/mod_proxy.html#proxyset">ProxySet</a></code> définit ici pour le balancer
<em>myset</em> un algorithme de
répartition de charge basé sur le trafic entrées/sorties.
</p>
<div class="note"><h3>Remarque</h3>
<p>
Les <em>BalancerMembers</em> sont aussi souvent référencés sous le terme
<em>workers</em>.
</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="config" id="config">Configuration du Balancer et des BalancerMembers</a></h2>
<p>
Vous pouvez configurer de manière détaillée les <em>balancers</em> et
<em>workers</em> via les nombreux paramètres de la directive <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>. Par exemple, si vous souhaitez
que <code>http://www3.example.com:8080</code> traite avec un facteur 3 le
trafic avec un timeout d'une seconde, utilisez la configuration suivante :
</p>
<pre class="prettyprint lang-config"><Proxy balancer://myset>
BalancerMember http://www2.example.com:8080
BalancerMember http://www3.example.com:8080 loadfactor=3 timeout=1
ProxySet lbmethod=bytraffic
</Proxy>
ProxyPass "/images" "balancer://myset/"
ProxyPassReverse "/images" "balancer://myset/"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="failover" id="failover">Gestion des indisponibilités (Failover)</a></h2>
<p>
Vous pouvez aussi définir finement des scénarios pour les cas
d'indisponibilité d'un ou plusieurs serveurs d'arrière-plan en spécifiant
quels serveurs doivent alors prendre le relai. Dans l'exemple suivant,
trois scénarios sont envisagés :
</p>
<ol>
<li>
<code>http://spare1.example.com:8080</code> et
<code>http://spare2.example.com:8080</code> ne sont sollicités que si
<code>http://www2.example.com:8080</code> ou
<code>http://www3.example.com:8080</code> est indisponible (un serveur
de remplacement sera utilisé à la place d'un membre indisponible du même
jeu de serveurs cibles).
</li>
<li>
<code>http://hstandby.example.com:8080</code> n'est sollicité que si
tous les autres serveurs cibles du jeu de serveurs <code>0</code> sont
indisponibles.
</li>
<li>
Les serveurs <code>http://bkup1.example.com:8080</code> et
<code>http://bkup2.example.com:8080</code> du jeu <code>1</code> ne seront sollicités que si
tous les serveurs du jeu <code>0</code>, tous les serveurs de
remplacement et tous les serveurs de standby sont indisponibles.
</li>
</ol>
<p>
Il est ainsi possible de définir un ou plusieurs serveurs de remplacement
ou de standby pour chaque jeu de serveurs du répartiteur de charge.
</p>
<pre class="prettyprint lang-config"><Proxy balancer://myset>
BalancerMember http://www2.example.com:8080
BalancerMember http://www3.example.com:8080 loadfactor=3 timeout=1
BalancerMember http://spare1.example.com:8080 status=+R
BalancerMember http://spare2.example.com:8080 status=+R
BalancerMember http://hstandby.example.com:8080 status=+H
BalancerMember http://bkup1.example.com:8080 lbset=1
BalancerMember http://bkup2.example.com:8080 lbset=1
ProxySet lbmethod=byrequests
</Proxy>
ProxyPass "/images/" "balancer://myset/"
ProxyPassReverse "/images/" "balancer://myset/"</pre>
<p>
Les serveurs de remplacement à chaud remplacent les serveurs indisponibles
du même jeu de serveurs du répartiteur de charge. Un serveur est
considéré comme indisponible s'il est en maintenance, arrêté ou en erreur.
Les serveurs de standby à chaud sont utilisés si tous les serveurs et
serveurs de remplacement du jeu de serveurs du répartiteur de charge sont
indisponibles. Les jeux de serveurs du répartiteur de charge (avec leurs
serveurs de standby et de remplacement à chaud respectifs) sont toujours
sollicités dans l'ordre du plus bas lbset vers le plus haut.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="manager" id="manager">Gestion du répartiteur de charge</a></h2>
<p>
L'application <em>balancer-manager</em> fournie avec le mandataire inverse
d'Apache httpd en est un des outils les plus utiles. Comme
<code class="module"><a href="../mod/mod_status.html">mod_status</a></code>, <em>balancer-manager</em> affiche la
configuration et l'activité actuelles des balancers actifs. L'affichage de
ces informations n'est cependant pas sa seule fonction ; il permet aussi de
modifier la plupart d'entre elles et même d'ajouter des membres au groupe
de répartition de charge en temps réel. Pour activer ces fonctionnalités,
vous devez ajouter les lignes suivantes à votre fichier de configuration :
</p>
<pre class="prettyprint lang-config"><Location "/balancer-manager">
SetHandler balancer-manager
Require host localhost
</Location></pre>
<div class="warning"><h3>Avertissement</h3>
<p>N'activez le <em>balancer-manager</em> que si vous avez déjà <a href="../mod/mod_proxy.html#access">sécurisé votre serveur</a>.
Assurez-vous en particulier que l'accès à l'URL soit fortement restreint.</p>
</div>
<p>
Lorsque vous accédez au serveur mandataire avec une adresse du style
<code>http://rproxy.example.com/balancer-manager/</code>, la page suivante
s'affiche :
</p>
<p class="centered"><img src="../images/bal-man.png" alt="balancer-manager page" /></p>
<p>
Ce formulaire permet à l'administrateur de modifier certains paramètres,
de désactiver ou d'ajouter certains serveurs d'arrière-plan, et de
modifier les règles de répartition de charge. Par exemple, si on clique
sur le répartiteur, la page suivante s'affiche :
</p>
<p class="centered"><img src="../images/bal-man-b.png" alt="balancer-manager page" /></p>
<p>
Si on clique sur un membre du groupe de répartition de charge, la page
suivante s'affiche :
</p>
<p class="centered"><img src="../images/bal-man-w.png" alt="balancer-manager page" /></p>
<p>
Si vous souhaitez que ces modifications soient conservées après un
redémarrage du serveur, assurez-vous que la directive <code class="directive"><a href="../mod/mod_proxy.html#balancerpersist">BalancerPersist</a></code> soit définie à On.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="health-check" id="health-check">Vérification dynamique du bon fonctionnement d'un serveur
d'arrière-plan</a></h2>
<p>
Avant que le mandataire httpd ne fasse appel à un serveur d'arrière-plan, il
peut <em>"tester"</em> si ce dernier est disponible en définissant le
paramètre <code>ping</code> de ce serveur via la directive <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>. Cependant, il est souvent plus
judicieux de vérifier le bon fonctionnement d'un serveur <em>hors
bande</em> et de manière dynamique via le module
<code class="module"><a href="../mod/mod_proxy_hcheck.html">mod_proxy_hcheck</a></code> d'Apache httpd.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="status" id="status">Drapeaux d'état d'un membre du groupe de répartition de charge</a></h2>
<p>
<em>balancer-manager</em> permet d'afficher et de modifier l'état d'un
membre du groupe de répartition de charge. Les différents états et leurs
significations sont les suivants :
</p>
<table class="bordered">
<tr><th>Drapeau</th><th>Sigle</th><th>Description</th></tr>
<tr><td> </td><td><em>Ok</em></td><td>Le serveur est disponible</td></tr>
<tr><td> </td><td><em>Init</em></td><td>Le serveur a été initialisé</td></tr>
<tr><td><code>D</code></td><td><em>Dis</em></td><td>Le serveur est
désactivé et n'accepte aucune requête ; il sera retesté automatiquement.</td></tr>
<tr><td><code>S</code></td><td><em>Stop</em></td><td>Le serveur a été
arrêté par l'administrateur ; il n'accepte aucune requête et il ne sera
pas retesté automatiquement.</td></tr>
<tr><td><code>I</code></td><td><em>Ign</em></td><td>Les erreurs
concernant ce serveur sont ignorées et il sera donc toujours considéré
comme disponible.</td></tr>
<tr><td><code>R</code></td><td><em>Spar</em></td><td>Le serveur cible sert de remplaçant à
chaud. Lorsqu'un serveur cible avec un lbset donné est inutilisable
(maintenance, arrêt, en erreur, etc...), un serveur de remplacement à
chaud libre de même lbset sera utilisé à sa place. Les remplaçants à
chaud permettent de s'assurer qu'un nombre déterminé de serveurs cibles
sera toujours disponible pour un répartiteur de charge.</td></tr>
<tr><td><code>H</code></td><td><em>Stby</em></td><td>Le serveur est en
mode hot-standby et ne sera donc utilisé que si aucun autre serveur ou
serveur de remplacement n'est disponible dans le jeu de serveurs du
répartiteur de charge.</td></tr>
<tr><td><code>E</code></td><td><em>Err</em></td><td>Le serveur est en
erreur, en général suite à un test préalable à une requête ; aucune
requête ne lui sera soumise, mais il sera retesté en fonction de la
valeur de son paramètre <code>retry</code>.</td></tr>
<tr><td><code>N</code></td><td><em>Drn</em></td><td>Le serveur est en
mode drain ; il n'acceptera de requêtes que dans le cadre des sessions
persistantes qui lui sont réservées et ignorera toutes les autres.</td></tr>
<tr><td><code>C</code></td><td><em>HcFl</em></td><td>Le serveur a échoué
au test dynamique de bon fonctionnement et ne sera utilisé que lorsqu'il
aura réussi un test ultérieur.</td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/howto/reverse_proxy.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/howto/reverse_proxy.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/reverse_proxy.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/auth.html.ja.utf8 0000664 0001751 0001751 00000130177 14743132254 021312 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>認証、承認、アクセス制御 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">How-To / チュートリアル</a></div><div id="page-content"><div id="preamble"><h1>認証、承認、アクセス制御</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/auth.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>「認証」とは、誰かが自分は誰であるかを主張した場合に、
それを確認するための全過程を指します。「承認」とは、
誰かが行きたい場所に行けるように、あるいは欲しい情報を
得ることができるようにするための全過程を指します。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">関連するモジュールとディレクティブ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#introduction">はじめに</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#theprerequisites">準備</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#gettingitworking">動作させる</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#lettingmorethanonepersonin">
複数の人が入れるようにする</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#possibleproblems">起こりえる問題</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#dbmdbd">パスワードの保存形式を変える</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multprovider">複数のプロバイダを使用する</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#beyond">単純な承認のその先</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinformation">追加情報</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="related" id="related">関連するモジュールとディレクティブ</a></h2>
<p>認証と承認の処理に関連する 3 種類のモジュールがあります。
それぞれ少なくともひとつずつ必要です。</p>
<ul>
<li>認証のタイプ (
<code class="directive"><a href="../mod/core.html#authtype">AuthType</a></code> ディレクティブ参照)
<ul>
<li><code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code></li>
<li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li>
</ul>
</li>
<li>認証プロバイダ (
<code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code>,
<code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> ディレクティブ参照)
<ul>
<li><code class="module"><a href="../mod/mod_authn_anon.html">mod_authn_anon</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_default.html">mod_authn_default</a></code></li>
<li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li>
<li><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li>
</ul>
</li>
<li>承認 (
<code class="directive"><a href="../mod/core.html#require">Require</a></code> ディレクティブ参照)
<ul>
<li><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_default.html">mod_authz_default</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code></li>
<li><code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code></li>
</ul>
</li>
</ul>
<p>これらのモジュールに加えて、<code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code>
と <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> があります。
この 2 つのモジュールは認証モジュールに共通なコアディレクティブを
実装しています。</p>
<p><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> は認証プロバイダと承認プロバイダの
両方の機能を持っています。
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> はホスト名、IP アドレスや
リクエストの特徴に基づいたアクセス制御を行いますが、
認証プロバイダのシステムの一部ではありません。
mod_access との後方互換性のため、
新しいモジュールの <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> があります。</p>
<p>様々なアクセス制御の行ない方については、
<a href="access.html">アクセス制御</a>の方法をご覧ください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="introduction" id="introduction">はじめに</a></h2>
<p>もし機密の情報や、ごくごく少数グループの人向けの情報を
ウェブサイトに置くのであれば、この文書に書かれている
テクニックを使うことで、そのページを見ている人たちが
望みの人たちであることを確実にできるでしょう。</p>
<p>この文書では、多くの人が採用するであろう、
ウェブサイトの一部分を保護する「一般的な」
方法についてカバーしています。</p>
<div class="note"><h3>注意</h3>
<p>データが本当に機密なのであれば、認証に加えてさらに
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></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="theprerequisites" id="theprerequisites">準備</a></h2>
<p>この文書で取り扱われるディレクティブは、
メインサーバ設定ファイル (普通は
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
セクション中) か、あるいはディレクトリ毎の設定ファイル
(<code>.htaccess</code> ファイル) かで用います。</p>
<p><code>.htaccess</code> ファイルを用いるのであれば、
これらのファイルに認証用のディレクティブを置けるように
サーバの設定をしないといけないでしょう。これは
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
ディレクティブで可能になります。
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
ディレクティブでは、ディレクトリ毎の設定ファイル中に置くことのできる
ディレクティブを、もしあれば、指定します。</p>
<p>認証について話を進めているので、次のような
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
ディレクティブが必要になるでしょう。</p>
<div class="example"><p><code>
AllowOverride AuthConfig
</code></p></div>
<p>そうでなく、メインサーバ設定ファイルの中に
直接置くのであれば、当然ながらそのファイルへの書き込み
権限を持っていなければならないでしょう。</p>
<p>また、どのファイルがどこに保存されているか知るために、
サーバのディレクトリ構造について少し知っておく
必要があるでしょう。
これはそんなに難しくないので、この文書中で
ディレクトリ構造について知っておく必要がある場面では、
明らかになるようにします。</p>
<p><code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code> と <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>
の両方が httpd バイナリに静的に組み込み済みであるか、httpd.conf
設定ファイルで動的にロードされるかして、httpd に組み込まれていなければ
なりません。これらの二つのモジュールは、設定ファイルのなかで非常に
重要でウェブサーバの認証と承認で使用されるコアディレクティブと
その機能を提供しています。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="gettingitworking" id="gettingitworking">動作させる</a></h2>
<p>では、サーバ上のあるディレクトリをパスワードで保護する
基本手順を示します。</p>
<p>まずはじめに、パスワードファイルを作ります。
どの認証プロバイダを使うかによって、パスワードファイル生成の手順は
大きく異なります。ここでの例では、手始めにテキストパスワードファイルを
使います。</p>
<p>このパスワードファイルは、ウェブからアクセスできる場所に
置くべきではありません。他の人がパスワードファイルを
ダウンロードできないようにするためです。例えば、
<code>/usr/local/apache/htdocs</code> でドキュメントを
提供しているのであれば、パスワードファイルは
<code>/usr/local/apache/passwd</code>
などに置いた方が良いでしょう。</p>
<p>ファイルを作るためには、Apache 付属の <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>
を使います。このコマンドは Apache をどこにインストールしようとも、
インストールディレクトリの <code>bin</code>
ディレクトリ以下に置かれます。サードバーティ製のパッケージで
インストールした場合は、実行パスの中で見つかるでしょう。</p>
<p>ファイルを作るには、次のようにタイプしてください。</p>
<div class="example"><p><code>
htpasswd -c /usr/local/apache/passwd/passwords rbowen
</code></p></div>
<p><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> は、パスワードを要求し、その後
確認のためにもう一度入力するように要求してきます。</p>
<div class="example"><p><code>
# htpasswd -c /usr/local/apache/passwd/passwords rbowen<br />
New password: mypassword<br />
Re-type new password: mypassword<br />
Adding password for user rbowen
</code></p></div>
<p>もし <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> がパスの中に入っていない場合は、
もちろん、実行するためにプログラムまでのフルパスを
タイプする必要があります。デフォルトのインストール状態であれば、
<code>/usr/local/apache/bin/htpasswd</code>
にプログラムが置かれています。</p>
<p>次に、サーバがパスワードを要求するように設定して、
どのユーザがアクセスを許されているかをサーバに知らせなければ
なりません。 <code>httpd.conf</code> を編集するか
<code>.htaccess</code> ファイルを使用するかで
設定します。例えば、ディレクトリ
<code>/usr/local/apache/htdocs/secret</code>
を保護したい場合は、
<code>/usr/local/apache/htdocs/secret/.htaccess</code>
か httpd.conf 中の <Directory
/usr/local/apache/htdocs/secret> セクションに
配置して、次のディレクティブを使うことができます。</p>
<div class="example"><p><code>
AuthType Basic<br />
AuthName "Restricted Files"<br />
# (Following line optional)<br />
AuthBasicProvider file<br />
AuthUserFile /usr/local/apache/passwd/passwords<br />
Require user rbowen
</code></p></div>
<p>個々のディレクティブについて見てみましょう。
<code class="directive"><a href="../mod/core.html#authtype">AuthType</a></code>
ディレクティブはどういう認証方法でユーザの認証を行うかを
選択します。最も一般的な方法は <code>Basic</code>
で、これは <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>
で実装されています。しかしながら、
これは気を付けるべき重要なポイントなのですが、
Basic 認証はクライアントからサーバへ、
パスワードを暗号化せずに送ります。ですからこの方法は、
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> と組み合わせない状態では、
特に機密性の高いデータに対しては用いるべきでは
ありません。 Apache ではもう一つ別の認証方法:
<code>AuthType Digest</code> をサポートしています。
この方法は <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>
で実装されていて、もっと安全です。
最近のクライアントは Digest
認証をサポートしているようです。</p>
<p><code class="directive"><a href="../mod/core.html#authname">AuthName</a></code>
ディレクティブでは、認証に使う <dfn>Realm</dfn> (訳注: 領域)
を設定します。Realm は大きく分けて二つの機能を提供します。
一つ目は、クライアントがパスワードダイアログボックスの
一部としてユーザにこの情報をよく提示する、というものです。
二つ目には、クライアントが与えられた認証領域に対してどのパスワードを
送信すれば良いのかを決定するために使われる、という機能です。</p>
<p>例えば、<code>"Restricted Files"</code> 領域中で
一度認証されれば、同一サーバ上で <code>"Restricted Files"</code>
Realm としてマークされたどんな領域でも、クライアントは
自動的に同じパスワードを使おうと試みます。
このおかげで、複数の制限領域に同じ realm を共有させて、
ユーザがパスワードを何度も要求される事態を
防ぐことができます。もちろん、セキュリティ上の理由から、
サーバのホスト名が変わればいつでも必ず、
クライアントは再びパスワードを尋ねる必要があります。</p>
<p><code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code>
はデフォルト値が <code>file</code> なので、今回の場合は無くても構いません。
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> や <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>
といった他のモジュールを使う場合には必要になります。
</p>
<p><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
ディレクティブは <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> で作った
パスワードファイルへのパスを設定します。
ユーザ数が多い場合は、リクエスト毎のユーザの認証のための
プレーンテキストの探索が非常に遅くなることがあります。
Apache ではユーザ情報を高速なデータベースファイルに
保管することもできます。
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> モジュールが
<code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>
ディレクティブを提供します。これらのファイルは <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code>
プログラムで作成したり操作したりできます。
<a href="http://modules.apache.org/">Apache
モジュールデータベース</a>中にあるサードパーティー製の
モジュールで、その他多くのタイプの認証オプションが
利用可能です。</p>
<p>最後に、<code class="directive"><a href="../mod/core.html#require">Require</a></code>
ディレクティブが、サーバのこの領域にアクセスできるユーザを
指定することによって、プロセスの承認部分を提供します。
次のセクションでは、<code class="directive"><a href="../mod/core.html#require">Require</a></code>
ディレクティブの様々な用法について述べます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="lettingmorethanonepersonin" id="lettingmorethanonepersonin">
複数の人が入れるようにする</a></h2>
<p>上記のディレクティブは、ただ一人 (具体的にはユーザ名
<code>rbowen</code> の誰か) がディレクトリに
入れるようにします。多くの場合は、複数の人が
入れるようにしたいでしょう。ここで
<code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>
の登場です。</p>
<p>もし複数の人が入れるようにしたいのであれば、
グループに属するユーザの一覧の入っている、グループ名のついた
グループファイルを作る必要があります。このファイルの
書式はきわめて単純で、お好みのエディタで生成できます。
ファイルの中身は次のようなものです。</p>
<div class="example"><p><code>
GroupName: rbowen dpitts sungo rshersey
</code></p></div>
<p>一行にスペース区切りで、グループに所属するメンバーの
一覧をならべるだけです。</p>
<p>既に存在するパスワードファイルにユーザを加える場合は、
次のようにタイプしてください。</p>
<div class="example"><p><code>
htpasswd /usr/local/apache/passwd/passwords dpitts
</code></p></div>
<p>以前と同じ応答が返されますが、新しいファイルを
作るのではなく、既にあるファイルに追加されています。
(新しいパスワードファイルを作るには <code>-c</code>
を使います。)</p>
<p>ここで次のようにして <code>.htaccess</code> ファイルを
修正する必要があります。</p>
<div class="example"><p><code>
AuthType Basic<br />
AuthName "By Invitation Only"<br />
# Optional line:<br />
AuthBasicProvider file<br />
AuthUserFile /usr/local/apache/passwd/passwords<br />
AuthGroupFile /usr/local/apache/passwd/groups<br />
Require group GroupName
</code></p></div>
<p>これで、グループ <code>GroupName</code> にリストされていて、
<code>password</code> ファイルにエントリがある人は、
正しいパスワードをタイプすれば入ることができるでしょう。</p>
<p>もっと特定せずに複数のユーザが入れるようにする、
もう一つの方法があります。グループファイルを作るのではなく、
次のディレクティブを使えばできます。</p>
<div class="example"><p><code>
Require valid-user
</code></p></div>
<p><code>require user rbowen</code> 行でなく、上記を使うと、
パスワードファイルにリストされている人であれば誰でも
許可されます。
単にパスワードファイルをグループ毎に分けておくことで、
グループのような振る舞いをさせることもできます。
このアプローチの利点は、Apache は二つではなく、
ただ一つのファイルだけを検査すればよいという点です。
欠点は、たくさんのパスワードファイルを管理して、その中から
<code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
ディレクティブに正しいファイルを参照させなければならない点です。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="possibleproblems" id="possibleproblems">起こりえる問題</a></h2>
<p>Basic 認証が指定されている場合は、
サーバにドキュメントをリクエストする度に
ユーザ名とパスワードを検査しなければなりません。
これは同じページ、ページにある全ての画像を
リロードする場合であっても該当します
(もし画像も保護されたディレクトリから来るのであれば) 。
予想される通り、これは動作を多少遅くします。
遅くなる程度はパスワードファイルの大きさと比例しますが、
これは、ファイルを開いてあなたの名前を発見するまで
ユーザ名のリストを読まなければならないからです。
そして、ページがロードされる度にこれを行わなければ
なりません。</p>
<p>結論としては、一つのパスワードファイルに置くことのできる
ユーザ数には実質的な限界があります。
この限界はサーバマシンの性能に依存して変わりますが、
数百のエントリを越えたあたりから速度低下が見られると予期されています。
その時は他の認証方法を考慮に入れた方が良いでしょう。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="dbmdbd" id="dbmdbd">パスワードの保存形式を変える</a></h2>
<p>プレーンテキストでパスワードを保存する方法には上記の問題があり、
データベースのような別の場所にパスワードを保存したいと思う
かもしれません。</p>
<p><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> と <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>
を使うと、それができるようになります。
<code class="directive"><a href="../mod/mod_auth_basic.html#authbasicsource">AuthBasicSource</a></code>
で file の代わりに、<code>dbm</code> あるいは <code>dbd</code>
を格納形式として選べます。</p>
<p>テキストファイルの代わりに dbm ファイルを選択する場合は、たとえば次のようにします。</p>
<div class="example"><p><code>
<Directory /www/docs/private><br />
AuthName "Private"<br />
AuthType Basic<br />
AuthBasicProvider dbm<br />
AuthDBMUserFile /www/passwords/passwd.dbm<br />
Require valid-user<br />
</Directory>
</code></p></div>
<p>この他のオプションも存在します。詳細に関しては
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> のドキュメントをご覧ください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="multprovider" id="multprovider">複数のプロバイダを使用する</a></h2>
<p>認証承認アーキテクチャに基づいている新しいプロバイダを使うと、
認証承認の方法をひとつに縛る必要がなくなります。
いくつものプロバイダを組み合わせて、自分の望みの挙動にできます。
次の例では file 認証プロバイダと ldap 認証プロバイダを
組み合わせています。</p>
<div class="example"><p><code>
<Directory /www/docs/private><br />
AuthName "Private"<br />
AuthType Basic<br />
AuthBasicProvider file ldap<br />
AuthUserFile /usr/local/apache/passwd/passwords<br />
AuthLDAPURL ldap://ldaphost/o=yourorg<br />
Require valid-user
</code></p></div>
<p>この例では、まず file プロバイダがユーザ認証を試みます。
認証できなかった場合には、ldap プロバイダが呼び出されます。
組織で複数の認証格納方法を使っている際などに、
この方法を使って認証のスコープを拡大できます。
もうひとつのシナリオは、ひとつの認証タイプと異なる承認を
組み合わせる方法でしょう。たとえば、パスワードファイルで認証して、
ldap ディレクトリで承認を行うといった場合です。</p>
<p>認証プロバイダを複数実装できるように、承認方法も複数使用できます。
この例では file グループ承認と ldap グループ承認を使っています。</p>
<div class="example"><p><code>
<Directory /www/docs/private><br />
AuthName "Private"<br />
AuthType Basic<br />
AuthBasicProvider file<br />
AuthUserFile /usr/local/apache/passwd/passwords<br />
AuthLDAPURL ldap://ldaphost/o=yourorg
AuthGroupFile /usr/local/apache/passwd/groups<br />
Require group GroupName<br />
Require ldap-group cn=mygroup,o=yourorg
</code></p></div>
<p>承認をより細かく制御したい場合は、
<code class="directive"><a href="../mod/mod_authz_core.html#<satisfyall>"><SatisfyAll></a></code> と
<code class="directive"><a href="../mod/mod_authz_core.html#<satisfyone>"><SatisfyOne></a></code>
ディレクティブを使って AND/OR ロジックで指定し、設定ファイルで
承認の処理順番の制御ができるようになっています。
これらのディレクティブをどのように使えるか、網羅した例をご覧ください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="beyond" id="beyond">単純な承認のその先</a></h2>
<p>承認の方法は、ひとつのデータソースを見て一回だけチェックするのと比べて、
ずっと多彩な適用方法ができます。
承認処理の適用順序や制御、選択ができるようになりました。</p>
<h3><a name="authandororder" id="authandororder">AND/OR ロジックの適用と順序付け</a></h3>
<p>承認がどのような順序で適用されているか、また、それをどのように制御するかは、
これまで混乱を招いていました。
Apache 2.2 ではプロバイダベースの認証メカニズムが導入され、
承認処理から認証処理とサポート機能とが切り分けられました。
これによるひとつの効果として、
認証モジュールのロード順やモジュール自体の順序に依存することなく、
指定した順番で認証プロバイダが呼び出せるよう、
設定できるようになりました。
このプロバイダメカニズムは承認処理でも導入されています。
つまり、<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
ディレクティブは単にどの承認手法が使われるかを指定するだけではなく、
それらの呼び出し順序も指定できるようになりました。
複数の承認手法があるとき、その呼び出し順は、設定ファイルの
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> ディレクティブ中で
現れた順序と同じになります。</p>
<p>追加で導入された
<code class="directive"><a href="../mod/mod_authz_core.html#<satisfyall>"><SatisfyAll></a></code>,
<code class="directive"><a href="../mod/mod_authz_core.html#<satisfyone>"><SatisfyOne></a></code>
ディレクティブを使って、承認手法がいつ呼び出され、アクセスが許可された際に
どの手続きが適用されるか指定することができます。
たとえば、次の承認ブロックのロジックを見てみましょう:</p>
<div class="example"><p><code>
# if ((user == "John") ||<br />
# ((Group == "admin")<br />
# && (ldap-group <ldap-object> contains auth'ed_user)<br />
# && ((ldap-attribute dept == "sales")<br />
# || (file-group contains auth'ed_user))))<br />
# then<br />
# auth_granted<br />
# else<br />
# auth_denied<br />
#<br />
<Directory /www/mydocs><br />
<span class="indent">
Authname ...<br />
AuthBasicProvider ...<br />
...<br />
Require user John<br />
<SatisfyAll><br />
<span class="indent">
Require Group admins<br />
Require ldap-group cn=mygroup,o=foo<br />
<SatisfyOne><br />
<span class="indent">
Require ldap-attribute dept="sales"<br />
Require file-group<br />
</span>
</SatisfyOne><br />
</span>
</SatisfyAll><br />
</span>
</Directory>
</code></p></div>
<p>デフォルトでは <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
ディレクティブは OR 操作として扱われます。つまり、もし指定した承認手法の
ひとつでも合格すれば、承認されます。
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> ディレクティブのセットを
ひとつの <code class="directive"><a href="../mod/mod_authz_core.html#<satisfyall>"><SatisfyAll></a></code>
ブロックで囲むとAND 操作となり、全ての承認手法で合格しなければ許可されません。</p>
<h3><a name="reqaccessctrl" id="reqaccessctrl">アクセス制御における Require と Reject の使い方</a></h3>
<p>ユーザ名とパスワードによる認証は全体の一部分でしかありません。
誰がアクセスしてきたかといった情報以外の条件を使いたい、
とよく思うことでしょう。
たとえば、どこからアクセスしてきているか、といった具合です。</p>
<p>承認プロバイダ <code class="directive"><a href="../mod/mod_authz_host.html#all">all</a></code>,
<code class="directive"><a href="../mod/mod_authz_host.html#env">env</a></code>,
<code class="directive"><a href="../mod/mod_authz_host.html#host">host</a></code>,
<code class="directive"><a href="../mod/mod_authz_host.html#ip">ip</a></code>
を使うと、リクエストを送信してきているマシンのホスト名や IP アドレス
といった、ホストベースでのアクセス制御ができます。</p>
<p>これらプロバイダの扱いは
<code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> や
<code class="directive"><a href="../mod/mod_authz_core.html#reject">Reject</a></code> で
指定されます。これらのディレクティブは承認プロバイダを登録し、
リクエスト処理の承認段階で呼び出されます。たとえば:</p>
<div class="example"><p><code>
Require ip <var>address</var>
</code></p></div>
<p>ここで、<var>address</var> は IP アドレス (あるいは IP アドレスの
一部) か : </p>
<div class="example"><p><code>
Require host <var>domain_name</var>
</code></p></div>
<p>ここで <var>domain_name</var> は FQDN (あるいはドメイン名の一部)
で、必要であれば複数のアドレスやドメイン名を書くことができます。</p>
<p>たとえば、スパムメッセージを送信してくる誰かを拒否したい場合、
次のようになります : </p>
<div class="example"><p><code>
Reject ip 10.252.46.165
</code></p></div>
<p>このディレクティブが有効な範囲のコンテンツに対しては、
そのアドレスからアクセスしてきても見ることができません。
もしマシン名がわかっていて IP アドレスよりもそちらで
指定したいのであれば、そのマシン名が使えます。</p>
<div class="example"><p><code>
Reject host <var>host.example.com</var>
</code></p></div>
<p>また、特定のドメインからのアクセス全てをブロックしたい場合は、
IP アドレスの一部や、ドメイン名が指定できます :</p>
<div class="example"><p><code>
<SatisfyAll><br />
<span class="indent">
Reject ip <var>192.168.205</var><br />
Reject host <var>phishers.example.com</var> <var>moreidiots.example</var><br /> Reject host ke<br />
</span>
</SatisfyAll>
</code></p></div>
<p><code class="directive"><a href="../mod/mod_authz_host.html#reject">Reject</a></code> ディレクティブを
<code class="directive"><a href="../mod/mod_authz_core.html#<satisfyall>"><SatisfyAll></a></code> ブロックの中で使うと、
許可したいグループにのみアクセスができるように確認できます。</p>
<p>上記の例では <code class="directive"><a href="../mod/mod_authz_core.html#<satisfyall>"><SatisfyAll></a></code>
を使って、アクセスに合格する前段階で、全ての
<code class="directive"><a href="../mod/mod_authz_host.html#reject">Reject</a></code> ディレクティブが
満たされていることを確認しています。</p>
<h3><a name="filesystem" id="filesystem">アクセス制御の後方互換性</a></h3>
<p>認証プロバイダベースの機構があるため、以前使用されていたディレクティブ
<code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#satisfy">Satisfy</a></code>
は必要なくなりました。
とはいうものの、古い設定ファイルでの後方互換性を提供するため、
これらのディレクティブは <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> モジュールに移されました。</p>
<p>これらのディレクティブの抱えていた問題のひとつに、承認の設定行とアクセス制御の設定行の
関係がとてもあいまいだったことが挙げられます。
<code class="directive"><a href="../mod/mod_access_compat.html#satisfy">Satisfy</a></code> ディレクティブは
リクエスト処理中でそれ自身を呼び出すことによって、これらの 2 つの処理段階を結びつけようとします。
現在は、これらのディレクティブは <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code> に移動し、
新しい認証ディレクティブと古いアクセス制御ディレクティブを混ぜて使うことは
難しくなっています。この問題のため、<code class="module"><a href="../mod/mod_authz_default.html">mod_authz_default</a></code> モジュールを
ロードすることがとても重要で、必須になっています。
<code class="module"><a href="../mod/mod_authz_default.html">mod_authz_default</a></code> モジュールの主な目的は、どの承認プロバイダで
処理されなかった承認リクエストを受けることにあります。
しかし、古いアクセス制御ディレクティブが用いられた場合には、
アクセス制御と承認を結びつけて、すべての処理段階の出力結果を見てアクセスに合格するかを決めています。
ですから、古いディレクティブがうまく動作しない場合は、
<code class="module"><a href="../mod/mod_authz_default.html">mod_authz_default</a></code> がロードされていないからかもしれない、
と疑ってみてください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinformation" id="moreinformation">追加情報</a></h2>
<p>これら全てがどのように動作するかについて
もっと多くの情報が書かれている <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> と
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>
の文書も読むとよいでしょう。
<code class="directive"><a href="../mod/mod_authn_core.html#<authnprovideralias>"><AuthnProviderAlias></a></code>
ディレクティブを使うと、特定の認証設定が簡単に書けるようになります。</p>
<p><a href="access.html">アクセス制御</a>の方法も、
関連するトピックがたくさん記載されていますので、ご覧ください。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/howto/auth.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/auth.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/auth.html" title="Japanese"> ja </a> |
<a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/auth.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/auth.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/cgi.html.ja.utf8 0000664 0001751 0001751 00000107713 14743132254 021113 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache Tutorial: CGI による動的コンテンツ - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">How-To / チュートリアル</a></div><div id="page-content"><div id="preamble"><h1>Apache Tutorial: CGI による動的コンテンツ</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/cgi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/cgi.html" title="Japanese"> ja </a> |
<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">はじめに</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuring">CGI を許可するように Apache を設定する</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#writing">CGI プログラムを書く</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">しかし、まだ動かない !</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#behindscenes">裏で何が起こっているのか?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#libraries">CGI モジュール/ライブラリ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinfo">更なる情報</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="intro" id="intro">はじめに</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li></ul></td></tr></table>
<p>CGI (Common Gateway Interface) は、ウェブサーバが
コンテンツ生成をする外部プログラムと協調して動作するための方法を
定義しています。そのプログラムはしばしば CGI プログラムや
CGI スクリプトと呼ばれます。CGI は、ウェブサイトに動的な
コンテンツを置くための最も簡単で一般的な方法です。このドキュメントは、
Apache ウェブサーバで CGI を設定し、
CGI プログラムを書き始めるための入門書となるでしょう。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuring" id="configuring">CGI を許可するように Apache を設定する</a></h2>
<p>CGI プログラムを正しく動作させるには、CGI を許可するように
Apache の設定を行う必要があります。
これを行なうための方法がいくつかあります。</p>
<div class="warning">
注: Apache が共有モジュール機能着きでビルドされている場合、
モジュールがロードされていることを確認してください。
つまり <code>httpd.conf</code> で
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>
がコメントアウトされていないことを確認してください。
正常に設定されていれば次のようになるはずです:
<div class="example"><p><code>
LoadModule cgi_module modules/mod_cgi.so
</code></p></div></div>
<h3><a name="scriptalias" id="scriptalias">ScriptAlias</a></h3>
<p><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
ディレクティブを使用して、
CGI プログラム用の特別な別ディレクトリを Apache に設定します。
Apache は、このディレクトリ中の全てのファイルを CGI
プログラムであると仮定します。
そして、この特別なリソースがクライアントから要求されると、
そのプログラムの実行を試みます。</p>
<p><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
ディレクティブは以下のように使用します:</p>
<div class="example"><p><code>
ScriptAlias /cgi-bin/ /usr/local/apache2/cgi-bin/
</code></p></div>
<p>デフォルト位置に Apache をインストールしたならば、
この例はデフォルト状態の <code>httpd.conf</code>
設定ファイルに含まれています。
<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
ディレクティブは、URL の前に付加するディレクトリを定義する
<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>
ディレクティブとかなり似ています。
<code class="directive">Alias</code> と <code class="directive">ScriptAlias</code>
は通常、<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
ディレクトリ外のディレクトリのために使用されます。
<code class="directive">Alias</code> と <code class="directive">ScriptAlias</code>
との差は、<code class="directive">ScriptAlias</code> が接頭辞で始まるすべての
URL は CGI プログラムとみなされるという追加の意味を含んでいることです。
従って、上記の例では、<code>/cgi-bin/</code>
で始まるリソースへのあらゆるリクエストに対して、ディレクトリ
<code>/usr/local/apache2/cgi-bin/</code> から提供し、それらを
CGI プログラムとして扱うよう Apache に示します。</p>
<p>例えば、URL <code>http://www.example.com/cgi-bin/test.pl</code>
が要求された場合、Apache は ファイル
<code>/usr/local/apache2/cgi-bin/test.pl</code>
を実行し、その出力を返すことを試みます。
もちろん、ファイルが存在し、実行可能であり、決められた方法で出力を返します。
そうでなければ、Apache はエラーメッセージを返します。</p>
<h3><a name="nonscriptalias" id="nonscriptalias">ScriptAlias ディレクトリ外の CGI</a></h3>
<p>CGI プログラムは、セキュリティ上の理由から
<code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
されたディレクトリに制限されることがしばしばあります。この方法により、
CGI プログラムを使用できるユーザを管理者が厳しく制御することができます。
しかしながら、適切なセキュリティ事前対策がとられるならば、CGI
プログラムを任意のディレクトリで実行できないようにする理由はありません。
例えば、ユーザに <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
ディレクティブで彼らのホームディレクトリ配下にウェブコンテンツを持たせたいとします。
もし、彼らが CGI プログラムを持つことを望んでいても、メインの
<code>cgi-bin</code> ディレクトリへのアクセスができない場合、
CGI プログラムを実行することができる他の場所が必要になります。</p>
<p>任意のディレクトリで CGI の実行を許可するには二段階の設定が必要です。
まず、<code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> や <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code> ディレクティブによって
<code>cgi-script</code> ハンドラが可能になっている必要があります。
次に、<code class="directive"><a href="../mod/core.html#options">Options</a></code> ディレクティブで
<code>ExecCGI</code> が指定されていなければなりません。</p>
<h3><a name="options" id="options">CGI の実行を可能にするために Options を明示的に使用する</a></h3>
<p>サーバのメインの設定ファイル中で <code class="directive"><a href="../mod/core.html#options">Options</a></code>
ディレクティブを明示的に使用することで、特定のディレクトリ配下で
CGI の実行を許可するように指定することができます:</p>
<div class="example"><p><code>
<Directory /usr/local/apache2/htdocs/somedir><br />
<span class="indent">
Options +ExecCGI<br />
</span>
</Directory>
</code></p></div>
<p>上記ディレクティブは、CGI ファイルの実行を可能にするよう
Apache に伝えます。また、どのファイルが CGI ファイルかを
サーバに伝える必要があります。次の
<code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code>
ディレクティブの例では、<code>cgi</code> または <code>pl</code>
を拡張子に持つすべてのファイルを CGI
プログラムとしてみなすことをサーバに伝えます:</p>
<div class="example"><p><code>
AddHandler cgi-script .cgi .pl
</code></p></div>
<h3><a name="htaccess" id="htaccess">.htaccess ファイル</a></h3>
<p><a href="htaccess.html"><code>.htaccess</code> チュートリアル</a>
は <code>httpd.conf</code> を変更できない場合にどうやって CGI プログラムを
使えるようにするかを説明しています。</p>
<h3><a name="userdir" id="userdir">User ディレクトリ</a></h3>
<p><code>.cgi</code> で終わるすべてのファイルに対して CGI プログラムの
実行を許可するには、以下の設定を使用できます。</p>
<div class="example"><p><code>
<Directory /home/*/public_html><br />
<span class="indent">
Options +ExecCGI<br />
AddHandler cgi-script .cgi<br />
</span>
</Directory>
</code></p></div>
<p>ユーザディレクトリの <code>cgi-bin</code> サブディレクトリの
すべてのファイルを CGI プログラムとして指定したい場合には
以下のようなものを使います。</p>
<div class="example"><p><code>
<Directory /home/*/public_html/cgi-bin><br />
<span class="indent">
Options ExecCGI<br />
SetHandler cgi-script<br />
</span>
</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="writing" id="writing">CGI プログラムを書く</a></h2>
<p>「通常の」プログラミングと CGI
プログラミングの間には主に二つの違いがあります。</p>
<p>一つは、CGI プログラムのすべての出力には<a class="glossarylink" href="../glossary.html#mime-type" title="用語集を参照">MIME タイプ</a>
ヘッダを付けなければなりません。
これはどのような種類のコンテンツを受け取っているかをクライアントに示す
HTTP ヘッダです。ほとんどの場合では、次のように出力します:</p>
<div class="example"><p><code>
Content-type: text/html
</code></p></div>
<p>もう一つは、出力を HTML
か、ブラウザが表示することができる何か他の形式にする必要があります。
大抵の場合は HTML でしょうが、GIF イメージや他の非 HTML
コンテンツを出力する CGI プログラムを書くこともあるでしょう。</p>
<p>これら二点以外では、CGI プログラムを書くことは、
あなたが書いている他のプログラムとよく似ているでしょう。</p>
<h3><a name="firstcgi" id="firstcgi">最初の CGI プログラム</a></h3>
<p>次に示すのは、ブラウザに 1 行印字する CGI
プログラムの例です。以下を入力し、<code>first.pl</code>
というファイルに保存し、それを <code>cgi-bin</code>
ディレクトリに置いてください。</p>
<div class="example"><p><code>
#!/usr/bin/perl<br />
print "Content-type: text/html\n\n";<br />
print "Hello, World.";
</code></p></div>
<p>Perl に精通していなくても、
何が起こるかを理解することはできるでしょう。1 行目は、
<code>/usr/bin/perl</code> で見つけられるインタプリタに
このファイルを供給することでこのプログラムが実行されることを
Apache に (シェル上で実行しようとしているならば、そのシェルに )
示します。2 行目は、前述したとおり content-type の定義を印字します。
これには復帰改行の二つの組を後に付加します。
これにより、ヘッダの終りに空行が置かれ、HTTP
ヘッダの終りとボディの始まりを示します。3 行目は、"Hello, World."
という文字列を印字し、これで終りとなります。</p>
<p>好みのブラウザを開き、アドレス</p>
<div class="example"><p><code>
http://www.example.com/cgi-bin/first.pl
</code></p></div>
<p>あるいはファイルを置いたロケーションを指定すると、
<code>Hello, World.</code>
という 1 行がブラウザウィンドに現れるでしょう。
それはあまりエキサイティングなことではありません。
しかし、これがうまく動けば、
他のどのようなものでも動かすことができるようになります。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot">しかし、まだ動かない !</a></h2>
<p>ウェブから CGI プログラムへのアクセスを行なったとき、
ブラウザで見る可能性がある四つの基本的なことがあります:</p>
<dl>
<dt>CGI プログラムの出力</dt>
<dd>素晴らしい ! それはすべてがうまく動いたことを意味します。
出力が正常だけれども、ブラウザが正常に処理してくれない場合は、
正しい <code>Content-Type</code> を CGI プログラム内で
セットしたかを確認してください。</dd>
<dt>CGI プログラムのソースコード、または "POST Method Not Allowed"
というメッセージ</dt>
<dd>これは、CGI プログラムを処理できるよう Apache
を適切に設定していなかったことを意味します。<a href="#configuring">「CGI を許可するように
Apache を設定する」</a>の章を読み直し、
あなたが何を間違えたかを探してみてください。
</dd>
<dt>メッセージが "Forbidden" で始まっている</dt>
<dd>これはパーミッションの問題ということを意味します。
<a href="#errorlogs">Apache のエラーログ</a>と、後述の<a href="#permissions">「ファイルのパーミッション」</a>
の章をチェックしてください。
</dd>
<dt>"Internal Server Error" というメッセージ</dt>
<dd><a href="#errorlogs">Apache
のエラーログ</a>をチェックすると、"Premature end of script headers"
というログが記録されていると思います。そして、おそらく CGI
プログラムによって生成されたエラーメッセージも記録されているでしょう。
この場合、CGI プログラムが適切な
HTTP ヘッダを出力できない原因を知るために、
以下の各章でチェックしてみてください。</dd>
</dl>
<h3><a name="permissions" id="permissions">ファイルのパーミッション</a></h3>
<p>サーバはあなたの権限で実行されていないのを忘れないように。
つまり、起動するとき、サーバは特権をもたないユーザ - 通常 <code>nobody</code>
や <code>www</code> の権限で実行されます。したがって、あなたが所有する
ファイルを実行するには別のパーミッションが必要となります。
通常、<code>nobody</code> が実行するのに十分なパーミッションを与える方法は、
ファイルに誰でも実行可能とするパーミッションを与えることです:</p>
<div class="example"><p><code>
chmod a+x first.pl
</code></p></div>
<p>また、もしあなたのプログラムが他のファイルを読み書きするならば、
それらのファイルは、これが可能となる正しいパーミッション
を持っている必要があります。</p>
<h3><a name="pathinformation" id="pathinformation">パス情報と環境</a></h3>
<p>コマンドラインからプログラムを実行するとき、
意識しなくてもシェルに渡される情報があります。
例えば、参照するファイルのためにどこを検索したらよいかを
シェルに伝える <code>PATH</code> があります。</p>
<p>プログラムが CGI プログラムとしてウェブサーバによって実行されるとき、
それは同じ <code>PATH</code> ではないかもしれません。
CGI プログラム内で呼び出すあらゆるプログラム
(例えば、<code>sendmail</code> のようなもの) は、
フルパスで指定する必要があるでしょう。それにより、CGI
プログラムを実行しようとしたとき、
シェルはそのようなプログラムを見つけることができます。</p>
<p>同様なことは、スクリプトのインタプリタ (しばしば <code>perl</code>)
へのパスで、CGI プログラムの 1 行目に次のように示されます:</p>
<div class="example"><p><code>
#!/usr/bin/perl
</code></p></div>
<p>これがインタープリタへの実際のパスであることを確認しておきます。</p>
<p>また、CGI プログラムが他の<a href="#env">環境変数</a>に依存している場合は、その環境変数が
Apache から渡されるようにする必要があります。</p>
<h3><a name="syntaxerrors" id="syntaxerrors">プログラムエラー</a></h3>
<p>CGI
プログラムが失敗するのは大抵、プログラム自身に問題がある場合です。
一度 CGI の使い方を理解し、前述の二つの誤りを犯していないならば、
まず間違いなくそうでしょう。ブラウザを使ってテストする前に
まず確認することは、コマンドラインからプログラムが実行できることです。
例えば、以下を実行してみてください:</p>
<div class="example"><p><code>
cd /usr/local/apache2/cgi-bin<br />
./first.pl
</code></p></div>
<p>(<code>perl</code> インタプリタは呼ばないでください。
シェルと Apache がスクリプトの最初の行の <a href="#pathinformation">パス情報</a> を使って見つけます。)</p>
<p>最初にプログラムから出力されるのは <code>Content-Type</code> を含み、
後に空行の続く HTTP ヘッダでなければなりません。他のものが出力されている
場合は、Apache はこのプログラムをサーバ経由で実行しようとしたときには
<code>Premature end of script headers</code> エラーを出力します。詳細は
上記の <a href="#writing">CGI プログラムを書く</a> を読んでください。</p>
<h3><a name="errorlogs" id="errorlogs">エラーログ</a></h3>
<p>エラーログは友達です。
全てのうまくいかないことは、エラーログにメッセージを生成します。
必ずそれを最初に見るべきです。
もし、あなたがウェブサイトを主催している場所が
エラーログの参照を許していないならば、きっと他のサイトで主催するべきです。
エラーログの読み方を学ぶことで、ほとんど全ての問題が迅速に確認され、
迅速に解決されるということが分かるでしょう。</p>
<h3><a name="suexec" id="suexec">Suexec</a></h3>
<p><a href="../suexec.html">suexec</a> サポートプログラムは
バーチャルホストやユーザのホームディレクトリの場所に依って
CGI プログラムを違うユーザ権限の下で走らせることを可能にします。
Suexec の権限のチェックは非常に厳しく、それを満たさない場合は
CGI プログラムが <code>Premature end of script headers</code> エラーで
実行されません。</p>
<p>suexec を使っているかどうかを調べためには <code>apachectl
-V</code> を実行して、<code>SUEXEC_BIN</code> の場所を調べてください。
Apache がそこに <code class="program"><a href="../programs/suexec.html">suexec</a></code> のバイナリを発見した場合は、suexec が
使用されます。</p>
<p>suexec を完全に理解していない限り、使うべきではありません。
suexec を無効にするには、<code>SUEXEC_BIN</code> から指されている
<code class="program"><a href="../programs/suexec.html">suexec</a></code> バイナリを削除 (か名前を変更) するだけです。
<a href="../suexec.html">suexec</a> を読んだ後で、まだそれを
使いたいのであれば、<code>suexec -V</code> を実行して suexec の
ログファイルの位置を調べ、そのログファイルを使ってポリシー違反を
見つけてください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="behindscenes" id="behindscenes">裏で何が起こっているのか?</a></h2>
<p>CGI プログラミングに習熟すると、
裏で起こっていることについて更に理解することの役に立ちます。
ブラウザとサーバがどのように相互通信するかについては特にそうです。
なぜなら、"Hello, World."
を印字するプログラムを書くことはおおいに結構ですが、
それは特に有益ではありません。</p>
<h3><a name="env" id="env">環境変数</a></h3>
<p>環境変数は、
あなたがコンピュータを使うときに辺りに存在している値です。
それらは、パス
(コマンドをタイプしたときに実行する実際のファイルを探し出すところ)、
ユーザ名、端末型などのような便利なものです。
通常、普段使用している環境変数の完全なリストを調べるには、
コマンドプロンプトで <code>env</code> を入力します。</p>
<p>CGI の処理中、サーバとブラウザも環境変数を設定し、
それにより相互に通信することができるようになります。
その環境変数は、ブラウザタイプ (Netscape, IE, Lynx)、サーバタイプ
(Apache, IIS, WebSite)、実行されている CGI
プログラムの名前などです。</p>
<p>これらの変数は CGI プログラマが使用できます。
そして、それはクライアントとサーバの通信の話の半分です。
必要な変数の完全なリストは <a href="http://hoohoo.ncsa.uiuc.edu/cgi/env.html">http://hoohoo.ncsa.uiuc.edu/cgi/env.html</a> にあります。</p>
<p>以下の単純な Perl CGI
プログラムは、渡される全ての環境変数を表示します。同様のプログラムは、
Apache ディストリビューションの <code>cgi-bin</code>
ディレクトリに二つ含まれています。
いくつかの変数が必須であり、いくつかは任意であることに注意してください。
そして、公式のリストにはないいくつかの変数が表示されているかもしれません。
さらに、Apache はデフォルトで用意されている基本的なものに
<a href="../env.html">あなた自身の環境変数を加える</a>ための、
多くの異なる方法を用意してします。</p>
<div class="example"><p><code>
#!/usr/bin/perl<br />
print "Content-type: text/html\n\n";<br />
foreach $key (keys %ENV) {<br />
<span class="indent">
print "$key --> $ENV{$key}<br>";<br />
</span>
}
</code></p></div>
<h3><a name="stdin" id="stdin">STDIN と STDOUT</a></h3>
<p>サーバとクライアント間のもう一つの通信は、標準入力
(<code>STDIN</code>)と標準出力 (<code>STDOUT</code>)
を通じて行なわれます。通常の文脈において、<code>STDIN</code>
はキーボードやプログラムが動作するために与えられるファイルを意味し、
<code>STDOUT</code> は通常コンソールまたはスクリーンを意味します。</p>
<p>ウェブフォームから CGI プログラムへ<code>POST</code>
したとき、フォームのデータは特別なフォーマットで束ねられ、
<code>STDIN</code> を通して、CGI プログラムに引き渡されます。
プログラムはデータがキーボード
もしくはファイルから来ていたかのように処理することができます。</p>
<p>「特別なフォーマット」はとても単純です。フィールド名と値はイコール
(=) で結ばれます。そして値の組はアンパサンド (&) で結ばれます。
スペース、アンパサンド、イコールのような面倒な文字は、
それらが動作を駄目にしないようにその文字に相当する 16 進に変換されます。
全データ文字列は、以下のようになります:
</p>
<div class="example"><p><code>
name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey
</code></p></div>
<p>時々、このような文字列が URL
に付加されるのを見るでしょう。その場合、サーバは
<code>QUERY_STRING</code> という環境変数にその文字列を入れます。それは
<code>GET</code> リクエストと呼ばれます。
HTML フォームでは、データを渡すために <code>GET</code> と
<code>POST</code> のどちらを使用するかを、<code>FORM</code> タグの
<code>METHOD</code> 属性の設定で指定します。</p>
<p>CGI プログラムは、その文字列を役に立つ情報に分割する責任があります。
幸いにも、そのデータ処理を助けるライブラリやモジュールが存在します。
これらは、CGI プログラムの他の面でも同様に役に立ちます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="libraries" id="libraries">CGI モジュール/ライブラリ</a></h2>
<p>CGI プログラムを書くとき、面倒な仕事の大部分をしてくれる
コードライブラリまたはモジュールを使うことを検討すべきです。
これはエラーを減らし、早い開発につながります。</p>
<p>Perl で CGI プログラムを書いているなら、モジュールは <a href="http://www.cpan.org/">CPAN</a> で提供されています。
この目的のための最も普及しているモジュールは <code>CGI.pm</code> です。
<code>CGI::Lite</code> も検討しましょう。これは、ほとんどのプログラム
において必要とするすべての機能の最小セットの実装です。</p>
<p>C で CGI プログラムを書いているなら、いろいろな
オプションがあります。これらの内の一つは <a href="http://www.boutell.com/cgic/">http://www.boutell.com/cgic/</a>
で提供されている <code>CGIC</code> ライブラリです。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinfo" id="moreinfo">更なる情報</a></h2>
<p>CGI に関する情報はウェブで数多く提供されています。CGI
の問題については Usenet の <a href="news:comp.infosystems.www.authoring.cgi">comp.infosystems.www.authoring.cgi</a> で、
他のユーザと論議することができます。HTML Writers Guide の
-servers メーリングリストは、あなたの質問に回答してくれる偉大なリソースです。
<a href="http://www.hwg.org/lists/hwg-servers/">http://www.hwg.org/lists/hwg-servers/</a>
で更に多くを探し出すことができます。</p>
<p>そしてもちろん、おそらく CGI
プログラムの動作に関する詳細の全てが記述されている
CGI の仕様を読むべきです。オリジナルバージョンを
<a href="http://hoohoo.ncsa.uiuc.edu/cgi/interface.html">NCSA</a>
で、アップデートされたドラフトを
<a href="http://web.golux.com/coar/cgi/">Common Gateway Interface RFC
プロジェクト</a>で参照することができます。</p>
<p>CGI の問題について、加わっているメーリングリストまたはニュース
グループに質問を送るとき、起こったもの、起こってほしいこと、
実際に起こったことがどう違うか、使用しているサーバ、
CGI プログラムを記述している言語に関する十分な情報と、
可能であれば問題のコードを提供するようにしてください。
そうすることで、問題がより間単に見つかるようになります。</p>
<p>Apache のソースコードにおいて問題を発見したことを確信していない限り、
CGI の問題に関する質問を Apache
バグデータベースに<strong>送るべきでない</strong>
ことに注目してください。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/cgi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/cgi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/cgi.html" title="Japanese"> ja </a> |
<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/cgi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/htaccess.html.ko.euc-kr 0000664 0001751 0001751 00000050261 14743132254 022460 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ġ 丮: .htaccess - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>ġ 丮: .htaccess </h1>
<div class="toplang">
<p><span> : </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>.htaccess</code> Ͽ 丮
ִ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">.htaccess </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what"≯/ ϴ°</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#when"> .htaccess ϳ
(Ȥ ʳ)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#how"> þ ϳ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#auth"> </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ssi">Server Side Includes </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">CGI </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">ذ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="related" id="related">.htaccess </a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</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_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</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/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/core.html#require">Require</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what"≯/ ϴ°</a></h2>
<p><code>.htaccess</code> (Ȥ "л ")
ϸ 丮 ִ. þ
ִ Ư 丮 θ, 丮
丮 þ Ѵ.</p>
<div class="note"><h3>:</h3>
<p><code>.htaccess</code> ϸ ٸ ϰ ʹٸ,
<code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code> þ
Ͽ ִ. , <code>.config</code>
ϸ Ϸ Ͽ ߰Ѵ.</p>
<div class="example"><p><code>
AccessFileName .config
</code></p></div>
</div>
<p>Ϲ <code>.htaccess</code> <a href="../configuring.html#syntax">ּ</a>
. <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
þ Ͽ ִ Ѵ. þ
<code>.htaccess</code> Ͽ ϴ þ з Ѵ.
þ <code>.htaccess</code> Ͽ ִٸ,
ش þ Override þ ϱ
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
˷ش.</p>
<p> , <code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>
þ þ <code>.htaccess</code> Ͽ
ִ. (þ .)
<a href="../mod/directive-dict.html#Context">Override</a>
ٿ <code>FileInfo</code> ִ. þ
<code>.htaccess</code> Ͽ ϱؼ ּ
<code>AllowOverride FileInfo</code> ʿϴ.</p>
<div class="example"><h3>:</h3><table>
<tr>
<td><a href="../mod/directive-dict.html#Context">:</a></td>
<td>ּ, ȣƮ, directory, .htaccess</td>
</tr>
<tr>
<td><a href="../mod/directive-dict.html#Override">Override:</a></td>
<td>FileInfo</td>
</tr>
</table></div>
<p>Ư þ <code>.htaccess</code> Ͽ
ִ ñϸ þ ".htaccess"
ִ ȮѴ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="when" id="when"> .htaccess ϳ
(Ȥ ʳ)</a></h2>
<p>Ϲ ּϿ 찡 ƴ϶
<code>.htaccess</code> ϸ ȵȴ. ,
<code>.htaccess</code> Ͽ ־
Ѵٴ ߸ ˷ ش. ̴ ƴϴ. ּ
ְ, ̷ Ѵ.</p>
<p><code>.htaccess</code> ڰ 丮
ٸϰ ýۿ root
쿡 Ѵ. ڰ ϰ
Ϲ ڰ <code>.htaccess</code>
ϵ ϴ ٶϴ. ,
ǻͿ Ʈ ϴ ISP ڰ
ڽ ϰ 찡 ϴ.</p>
<p> Ϲ <code>.htaccess</code>
ؾ Ѵ. <code>.htaccess</code> Ͽ ϴ þ
ּ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ǰ ȿ
ִ.</p>
<p> ΰ ū <code>.htaccess</code>
ؾ Ѵ.</p>
<p>ù° ̴. <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> <code>.htaccess</code>
ϵ ϸ, ġ 丮
<code>.htaccess</code> ã´.
<code>.htaccess</code> ϸ
ʴ 쿡 ! , <code>.htaccess</code>
ûҶ оδ.</p>
<p>Դٰ ؾ ϴ ü þ ġ
丮 <code>.htaccess</code> ã´.
(<a href="#how"> þ ϳ</a> .)
<code>/www/htdocs/example</code> 丮 ִ
ûϸ, ġ ϵ ãƾ Ѵ.</p>
<div class="example"><p><code>
/.htaccess<br />
/www/.htaccess<br />
/www/htdocs/.htaccess<br />
/www/htdocs/example/.htaccess
</code></p></div>
<p> 丮 ִ
Ͻý 4 ؾ Ѵ.
(<code>/</code> <code>.htaccess</code>
츦 Ѵ. ʴ´.)</p>
<p>ι° ̴. ڿ
ָ ȭ Ͼ ִ. ڿ
̷ ϶. , ڰ ϴ ͺ
ָ û ´. ڿ
Ȯ ˷. ڿ <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> Ͽ
Ȯ ˸ ϸ ȥ
ִ.</p>
<p>þ <code>/www/htdocs/example</code> 丮
<code>.htaccess</code> δ Ͱ ּ
<code><Directory /www/htdocs/example></code> Directory
δ .</p>
<p><code>/www/htdocs/example</code> ִ
<code>.htaccess</code> :</p>
<div class="example"><h3><code>/www/htdocs/example</code> ִ
.htaccess </h3><p><code>
AddType text/example .exm
</code></p></div>
<div class="example"><h3><code>httpd.conf</code> Ͽ ִ </h3><p><code>
<Directory /www/htdocs/example><br />
<span class="indent">
AddType text/example .exm<br />
</span>
</Directory>
</code></p></div>
<p> û ʰ ġ
Ҷ ѹ б Ͽ
ϸ .</p>
<p><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> þ
<code>none</code> ϸ <code>.htaccess</code>
.</p>
<div class="example"><p><code>
AllowOverride None
</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="how" id="how"> þ ϳ</a></h2>
<p><code>.htaccess</code> ߰ 丮 丮
丮 <code>.htaccess</code> Ͽ ִ
þ Ѵ. 丮 <code>.htaccess</code>
ؾ Ѵ. ߰ þ Ѵ. Ư
丮 ִ <code>.htaccess</code> 丮
ִ <code>.htaccess</code> þ ȿ
ְ, 丮 ִ þ 丮 Ȥ
ּϿ ִ þ ȿ ִ.</p>
<p>:</p>
<p><code>/www/htdocs/example1</code> 丮
<code>.htaccess</code> ִ.</p>
<div class="example"><p><code>
Options +ExecCGI
</code></p></div>
<p>(: <code>.htaccess</code> Ͽ "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" þ Ϸ
"<code>AllowOverride Options</code>" ʿϴ.)</p>
<p><code>/www/htdocs/example1/example2</code> 丮
<code>.htaccess</code> ִ.</p>
<div class="example"><p><code>
Options Includes
</code></p></div>
<p> ι° <code>.htaccess</code>
<code>Options Includes</code> ȿ
<code>/www/htdocs/example1/example2</code>
丮 CGI ʴ´.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="auth" id="auth"> </a></h2>
<p> ˱ ٷ ̰ д´ٸ
ִ. ȣ Ϸ <code>.htaccess</code>
ʿϴٴ ذ θ ִ. ̴ ƴϴ.
ּ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ǿ þ
δ ϴ ̰, ּ
쿡 <code>.htaccess</code> ؾ
Ѵ. <code>.htaccess</code> ؾ ϴ
ƾ ϴ <a href="#when"></a>
Ͽ.</p>
<p>տ <code>.htaccess</code>
ʿϴٰ Ǹ Ʒ ̴.</p>
<p><code>.htaccess</code> .</p>
<div class="example"><p><code>
AuthType Basic<br />
AuthName "Password Required"<br />
AuthUserFile /www/passwords/password.file<br />
AuthGroupFile /www/passwords/group.file<br />
Require Group admins
</code></p></div>
<p> þ ϱؼ
<code>AllowOverride AuthConfig</code> þ ʿ
϶.</p>
<p> Ѻο ڼ <a href="auth.html">
丮</a> ٶ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="ssi" id="ssi">Server Side Includes </a></h2>
<p>Ǵٸ Ϲ <code>.htaccess</code> 뵵
Ư 丮 Server Side Includes ϰ
̴. ϴ 丮 <code>.htaccess</code> Ͽ
þ ϸ ȴ.</p>
<div class="example"><p><code>
Options +Includes<br />
AddType text/html shtml<br />
AddHandler server-parsed shtml
</code></p></div>
<p> þ Ϸ <code>AllowOverride Options</code>
<code>AllowOverride FileInfo</code> ʿ ϶.</p>
<p>server-side includes ڼ <a href="ssi.html">SSI 丮</a> ٶ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">CGI </a></h2>
<p> <code>.htaccess</code> Ͽ Ư
丮 CGI α ϰ ʹٸ,
Ѵ.</p>
<div class="example"><p><code>
Options +ExecCGI<br />
AddHandler cgi-script cgi pl
</code></p></div>
<p>Ȥ 丮 ִ CGI α
óϰ ʹٸ ϴ.</p>
<div class="example"><p><code>
Options +ExecCGI<br />
SetHandler cgi-script
</code></p></div>
<p> þ Ϸ <code>AllowOverride Options</code>
<code>AllowOverride FileInfo</code> ʿ ϶.</p>
<p>CGI αְ ڼ <a href="cgi.html">CGI 丮</a> ٶ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot">ذ</a></h2>
<p><code>.htaccess</code> Ͽ þ ϴ
ʴ ִ.</p>
<p> Ϲ þ ϰ <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
. Ǵ <code>AllowOverride None</code>
ȮѴ. <code>.htaccess</code> ƹԳ
ٽ Ͽ ˻غ ִ.
Ȯ
<code>AllowOverride None</code> .</p>
<p>ݴ Ҷ ϸ ġ α
. Ƹ <code>.htaccess</code> Ͽ ִ þ
ʴ´ٰ ̴. ƴϰ ִٸ
ģ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/htaccess.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/htaccess.html" title="Korean"> ko </a> |
<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/htaccess.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/index.html.ja.utf8 0000664 0001751 0001751 00000017472 14743132254 021462 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>How-To / チュートリアル - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>How-To / チュートリアル</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/" title="Japanese"> ja </a> |
<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="howto" id="howto">How-To / チュートリアル</a></h2>
<dl>
<dt>認証と承認</dt>
<dd>
<p>認証とは、誰かが自分は誰であるかを名乗っているものを検証する
処理のことです。承認とは、誰かが望みの場所に辿り着けたり、
望みの情報を手に入れたりすることを許可する処理のことです。</p>
<p>参照: <a href="auth.html">認証と承認</a></p>
</dd>
</dl>
<dl>
<dt>アクセス制御</dt>
<dd>
<p>アクセス制御は、さまざまな条件でリソースに対するアクセスを
許可したり制限したりすることを指します。
実現方法には様々な異なる手法があります。</p>
<p>参照: <a href="access.html">アクセス制御</a></p>
</dd>
</dl>
<dl>
<dt>CGI による動的コンテンツ</dt>
<dd>
<p>CGI (Common Gateway Interface) はウェブサーバが外部のコンテンツ
生成プログラムとどのように相互動作をするかを定義します。
その外部プログラムは通常 CGI プログラムや CGI スクリプトと呼ばれます。
CGI はウェブサイトに動的なコンテンツを追加するための、
単純な方法です。この文書は Apache ウェブサーバに
CGI を設定し、CGI プログラムを書き始めるためのイントロダクションです。</p>
<p>参照: <a href="cgi.html">CGI: 動的コンテンツ</a></p>
</dd>
</dl>
<dl>
<dt><code>.htaccess</code> ファイル</dt>
<dd>
<p><code>.htaccess</code> ファイルはディレクトリ毎に設定を変更するための
方法を提供します。設定ディレクティブが書かれたファイルが、あるドキュメント
ディレクトリに置かれると、ディレクティブはそのディレクトリと
すべてのサブディレクトリに適用されます。</p>
<p>参照: <a href="htaccess.html"><code>.htaccess</code> ファイル</a></p>
</dd>
</dl>
<dl>
<dt>Server Side Includes イントロダクション</dt>
<dd>
<p>SSI (Server Side Includes) は HTML ページ中に書かれるディレクティブで、
ページが送られる時にサーバにより評価されます。これにより、ページ全体を
CGI プログラムで生成したり、他の動的な技術を使うことなく、既存の HTML
ページに動的に生成された内容を付加することができます。</p>
<p>参照: <a href="ssi.html">Server Side Includes (SSI)</a></p>
</dd>
</dl>
<dl>
<dt>ユーザ毎のウェブディレクトリ</dt>
<dd>
<p>複数ユーザの存在するシステムでは、それぞれのユーザは <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> ディレクティブを使うことによって
ホームディレクトリ上にウェブサイトを作成することができます。
URL <code>http://example.com/~username/</code> を訪れた人は
ユーザ "<code>username</code>" のホームディレクトリの、<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> ディレクティブで指定された
サブディレクトリからコンテンツを得ることになります。</p>
<p>参照: <a href="public_html.html">ユーザウェブディレクトリ (<code>public_html</code>)</a></p>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/howto/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/" title="Japanese"> ja </a> |
<a href="../ko/howto/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../zh-cn/howto/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/public_html.html.ja.utf8 0000664 0001751 0001751 00000036037 14743132254 022653 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ユーザ毎のウェブディレクトリ - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">How-To / チュートリアル</a></div><div id="page-content"><div id="preamble"><h1>ユーザ毎のウェブディレクトリ</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/public_html.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>複数のユーザのいるシステムでは、<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> ディレクティブを使って
各ユーザがホームディレクトリにウェブサイトを構築できるように設定することが
可能です。URL <code>http://example.com/~username/</code> を訪れた人は
"<code>username</code>" というユーザの <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> ディレクティブで指定された
サブディレクトリからコンテンツを得ることになります。</p>
<p>in the default config file, and adapting the <code>httpd-userdir.conf</code>
file as necessary, or by including the appropriate directives in a
<code>Directory</code> block within the main config file.</p>
<p>デフォルトではこれらのディレクトリへのアクセスは<strong>許可されていません</strong>。
<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> を使って有効にできます。
有効にするには、デフォルトの設定ファイルで付随する
<code>httpd-userdir.conf</code> ファイルが必要で、
その中の次の行のコメントアウトを外して有効にするか、
</p>
<div class="example"><p><code>
#Include conf/extra/httpd-userdir.conf
</code></p></div>
<p>あるいは、メインの設定ファイル中の <code>Directory</code>
ブロックの中に適切にディレクティブを記述しておきます。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">ユーザ毎のウェブディレクトリ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#userdir">UserDir を使ってファイルのパスを設定する</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirect">外部 URL にリダイレクトする</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#enable">この機能を使用できるユーザを制限する</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">ユーザ毎の CGI ディレクトリ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#htaccess">ユーザによる設定変更を許可</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="../urlmapping.html">URL からファイルシステムへのマッピング</a></li><li><a href="#comments_section">コメント</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="related" id="related">ユーザ毎のウェブディレクトリ</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></li><li><code class="directive"><a href="../mod/core.html#directorymatch">DirectoryMatch</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="userdir" id="userdir">UserDir を使ってファイルのパスを設定する</a></h2>
<p><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> ディレクティブは
ユーザ毎のコンテンツが読み込まれるディレクトリを指定します。
このディレクティブはいろいろ違った形式を取ることができます。</p>
<p>スラッシュで始まらないパスが与えられたときは、ユーザのホームディレクトリ
からの相対パスとみなされます。次の設定があったときに:</p>
<pre class="prettyprint lang-config">UserDir public_html</pre>
<p>URL <code>http://example.com/~rbowen/file.html</code> は
パス <code>/home/rbowen/public_html/file.html</code> へ
変換されます。</p>
<p>パスがスラッシュで始まるときは、ディレクトリパスはそのパスに
ユーザ名を加えたものからなります。次の設定のとき:</p>
<pre class="prettyprint lang-config">UserDir /var/html</pre>
<p>URL <code>http://example.com/~rbowen/file.html</code> は
パス <code>/var/html/rbowen/file.html</code> へ変換されます。</p>
<p>アスタリスク (*) を含むパスが指定されたときは、アスタリスクを
ユーザ名で置換したものが使用されます。このような設定だと:</p>
<pre class="prettyprint lang-config">UserDir /var/www/*/docs</pre>
<p>URL <code>http://example.com/~rbowen/file.html</code> は
パス <code>/var/www/rbowen/docs/file.html</code> へ変換されます。</p>
<p>ディレクトリやディレクトリパスを複数設定することもできます。</p>
<pre class="prettyprint lang-config">UserDir public_html /var/html</pre>
<p><code>http://example.com/~rbowen/file.html</code> という
URL に対しては <code>~rbowen</code> を探します。見つからなければ、
<code>/var/html</code> の下にある <code>rbowen</code> を探します。
もし見つかれば上記の URL は <code>/var/html/rbowen/file.html</code>
というファイルパスに変換されます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirect" id="redirect">外部 URL にリダイレクトする</a></h2>
<p><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
ディレクティブを使って外部 URL にリダイレクトすることもできます。</p>
<pre class="prettyprint lang-config">UserDir http://example.org/users/*/</pre>
<p>上記例では <code>http://example.com/~bob/abc.html</code>
へのリクエストは <code>http://example.org/users/bob/abc.html</code>
にリダイレクトされます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="enable" id="enable">この機能を使用できるユーザを制限する</a></h2>
<p>UserDir のドキュメントに示されている構文を使うことで、
どのユーザがこの機能を使うことができるかを制限することができます:</p>
<div class="example"><p><code>
UserDir enabled<br />
UserDir disabled root jro fish
</code></p></div>
<p>上の設定は <code>dissabled</code> 文のユーザ以外のすべてのユーザに
対して UserDir の機能を有効にします。同様にして、以下のように
数名のユーザ以外に対してこの機能を無効にすることもできます:</p>
<pre class="prettyprint lang-config"> UserDir disabled<br />
UserDir enabled rbowen krietz</pre>
<p>他の例は <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
の説明を参照してください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">ユーザ毎の CGI ディレクトリ</a></h2>
<p>それぞれのユーザに専用の cgi-bin ディレクトリを与えるために、
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
を使ってユーザのホームディレクトリの指定された領域に対して CGI を有効に
することができます。</p>
<pre class="prettyprint lang-config"><Directory /home/*/public_html/cgi-bin/>
Options ExecCGI
SetHandler cgi-script
</Directory></pre>
<p>そして、<code>UserDir</code> が
<code>public_html</code> に設定されていると仮定すると、
そのディレクトリの CGI プログラム <code>example.cgi</code>
は以下の様に呼び出されることができます:</p>
<div class="example"><p><code>
http://example.com/~rbowen/cgi-bin/example.cgi
</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="htaccess" id="htaccess">ユーザによる設定変更を許可</a></h2>
<p>ユーザに彼らのウェブ空間でのサーバの設定の変更を許可する場合、
ユーザは <code>.htaccess</code> ファイルを使って設定を変更する必要があります。
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> の値を
ユーザが変更することを許可したいディレクティブに対して十分なものに
設定していることを確認してください。この機能がどのようにして動作しているか
の詳細は <a href="htaccess.html">.htaccess チュートリアル</a> を読んで
ください。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/public_html.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/public_html.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/ssi.html.ja.utf8 0000664 0001751 0001751 00000075130 14743132254 021144 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache チュートリアル: Server Side Includes 入門 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">How-To / チュートリアル</a></div><div id="page-content"><div id="preamble"><h1>Apache チュートリアル: Server Side Includes 入門</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/ssi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/ssi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/ssi.html" title="Japanese"> ja </a> |
<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>サーバサイドインクルードによって、既存の HTML
ドキュメントに動的なコンテンツを追加することができます。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">はじめに</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what">SSI とは ?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuring">SSI を許可するためのサーバの設定</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#basic">基本的な SSI ディレクティブ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#additionalexamples">追加の例</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#config">他に何が設定できるのか ?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exec">コマンドの実行</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#advanced">高度な SSI テクニック</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#conclusion">終わりに</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="related" id="related">はじめに</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_include.html">mod_include</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_expires.html">mod_expires</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code></li><li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li><li><code class="directive"><a href="../mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li></ul></td></tr></table>
<p>この記事は、通常は単に SSI と呼ばれる Server Side Includes
を扱います。この記事においては、サーバでの SSI を許可するための設定と、
現在の HTML ページに動的なコンテンツを加えるためのいくつかの基本的な
SSI 技術を紹介します。</p>
<p>記事の後半では、SSI ディレクティブで SSI
と共に実行することができる条件文のような
幾分高度な事柄について述べています。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">SSI とは ?</a></h2>
<p>SSI (Server Side Includes) は、HTML
ページ中に配置されるディレクティブであり、
サーバでページを提供する時に評価されます。SSI は、CGI
プログラムやその他の動的な技術で全てのページを提供せずに、
動的に生成されたコンテンツを現在の HTML ページに加えます。</p>
<p>どういう場合に SSI を使い、どういう場合にプログラムで
ページを完全に生成するかは、ページのうちどの程度が静的であり、
ページが提供されるたびに再計算する必要がどの程度あるかで通常は決定します。
SSI は現在時刻のような小さい情報を加えるにはうってつけの方法です。
しかし、そのページのほとんどの部分が提供時に生成される場合は、
他の方法を探す必要があります。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuring" id="configuring">SSI を許可するためのサーバの設定</a></h2>
<p>サーバで SSI を許可するには、<code>httpd.conf</code>
ファイルまたは <code>.htaccess</code>
ファイルに次のディレクティブを指定する必要があります:</p>
<div class="example"><p><code>
Options +Includes
</code></p></div>
<p>この指定は、ファイルを SSI
ディレクティブで解析させることを許可するということを Apache
に伝えます。ほとんどの設定ではお互いを上書きできる、複数の
<code class="directive"><a href="../mod/core.html#options">Options</a></code> があることに
注意してください。おそらく、設定が最後に評価されることを
保証されるために、SSI を使用したいディレクトリに <code>Options</code>
ディレクティブを適用する必要があるでしょう。</p>
<p>全てのファイルが SSI
ディレクティブで解析されるというわけではありません。
どのファイルが解析されるかを Apache に伝える必要があります。
これを行なうには二つ方法があります。
次のディレクティブを使うことで、例えば <code>.shtml</code>
のような特別なファイル拡張子を持つファイルを解析するよう
Apache に伝えることができます:</p>
<div class="example"><p><code>
AddType text/html .shtml<br />
AddOutputFilter INCLUDES .shtml
</code></p></div>
<p>この方法の欠点は、もし現在のページに SSI ディレクティブを加えたい場合、
それらのディレクティブが実行されるように
<code>.shtml</code> 拡張子にするため、そのページの名前と、
そのページへの全てのリンクを変更しなければならないことです。</p>
<p>もう一つの方法は、<code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>
ディレクティブを使用することです:</p>
<div class="example"><p><code>
XBitHack on
</code></p></div>
<p><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>
は、ファイルの実行ビットが立っている場合、
SSI ディレクティブにより解析することを Apache に伝えます。
従って、SSI ディレクティブを現在のページに加えるためには、
ファイル名を変更しなくてもよく、単に <code>chmod</code>
を使用してファイルを実行可能にするだけで済みます。</p>
<div class="example"><p><code>
chmod +x pagename.html
</code></p></div>
<p>行なうべきではないことに関する短いコメント。時々誰かが、全ての
<code>.html</code> ファイルを SSI で解析するよう Apache に伝えれば、
わざわざ <code>.shtml</code> というファイル名にする必要がないといって
薦めるのを見ることでしょう。こういう人たちは、おそらく
<code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>
について聞いたことがないのでしょう。
この方法について注意することは、たとえ SSI
ディレクティブを全く含まない場合でも、Apache がクライアントに
送る全てのファイルを最後まで読み込ませることになります。
この方法はかなり処理を遅くするものであり、良くないアイデアです。</p>
<p>もちろん、Windows ではそのような実行ビットをセット
するようなものはありませんのでオプションが少し制限されています。</p>
<p>デフォルトの設定では、Apache は SSI ページについて最終変更時刻や
コンテンツの長さを HTTP ヘッダに送りません。
動的なコンテンツであるため、それらの値を計算するのが難しいからです。
このためドキュメントがキャッシュされなくなり、
結果としてクライアントの性能が遅くなったように感じさせることになります。
これを解決する方法が二つあります:</p>
<ol>
<li><code>XBitHack Full</code> 設定を使用する。
この設定により、もともと要求されたファイルの時刻を参照し、
読み込まれるファイルの変更時刻を無視して最終変更時刻を決定するよう
Apache に伝えます。</li>
<li><a href="../mod/mod_expires.html">mod_expires</a>
で提供されているディレクティブを使用して、
ファイルが無効になる時刻を明示します。これにより、
ブラウザとプロキシにキャッシュが有効であることを通知します。</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="basic" id="basic">基本的な SSI ディレクティブ</a></h2>
<p>SSI ディレクティブは以下の文法で記述します:</p>
<div class="example"><p><code>
<!--#element attribute=value attribute=value ... -->
</code></p></div>
<p>HTML のコメントのような書式をしているので、もし SSI
を正しく動作可能にしなければ、ブラウザはそれを無視するでしょう。
しかし、HTML ソース中では見えます。もし SSI を正しく設定したなら、
ディレクティブはその結果と置き換えられます。</p>
<p>element はたくさんあるものから一つ指定することができます。
指定できるものの大多数については、次回もう少し詳しく説明します。
ここでは、SSI で行なうことができる例をいくつか示します。</p>
<h3><a name="todaysdate" id="todaysdate">今日の日付</a></h3>
<div class="example"><p><code>
<!--#echo var="DATE_LOCAL" -->
</code></p></div>
<p><code>echo</code> 要素は単に変数の値を出力します。
CGI プログラムに利用可能な環境変数の全ての
セットを含む多くの標準変数があります。また、<code>set</code>
要素を用いることで、独自の変数を定義することができます。
</p>
<p>出力される日付の書式が好きではない場合、その書式を修正するために、
<code>config</code> 要素に <code>timefmt</code>
属性を使用することができます。</p>
<div class="example"><p><code>
<!--#config timefmt="%A %B %d, %Y" --><br />
Today is <!--#echo var="DATE_LOCAL" -->
</code></p></div>
<h3><a name="lastmodified" id="lastmodified">ファイルの変更日</a></h3>
<div class="example"><p><code>
This document last modified <!--#flastmod file="index.html" -->
</code></p></div>
<p>この要素も <code>timefmt</code>
フォーマットの設定に従います。</p>
<h3><a name="cgi" id="cgi">CGI プログラムの結果を取り込む</a></h3>
<p>これは、全ての人のお気に入りである ``ヒットカウンタ'' のような
CGI プログラムの結果を出力する SSI
のより一般的な使用のうちの一つです。</p>
<div class="example"><p><code>
<!--#include virtual="/cgi-bin/counter.pl" -->
</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="additionalexamples" id="additionalexamples">追加の例</a></h2>
<p>以下は、SSI を使用して HTML
ドキュメントにおいてできることのいくつかの特別な例です。</p>
<h3><a name="docmodified" id="docmodified">いつこのドキュメントは修正されたのか
?</a></h3>
<p>先に、ドキュメントが最後に変更されたのはいつかを
ユーザに通知するために SSI を使用することができることを述べました。
しかしながら、実際の方法は、いくぶん問題のままにしておきました。
HTML ドキュメントに配置された次のコードは、ページにそのような
タイムスタンプを入れるでしょう。もちろん、上述のように、
SSI を正しく動作可能にしておく必要があります。</p>
<div class="example"><p><code>
<!--#config timefmt="%A %B %d, %Y" --><br />
This file last modified <!--#flastmod file="ssi.shtml" -->
</code></p></div>
<p>もちろん、<code>ssi.shtml</code>
の部分を実際の当該ファイル名と置き換える必要があります。
もし、あらゆるファイルに張ることができる一般的なコードを探しているなら、
これは不便であるかもしれません。おそらくその場合は、
そうする代わりに変数 <code>LAST_MODIFIED</code>
を使用したいと考えるでしょう:</p>
<div class="example"><p><code>
<!--#config timefmt="%D" --><br />
This file last modified <!--#echo var="LAST_MODIFIED" -->
</code></p></div>
<p><code>timefmt</code>
書式についてのより詳細については、お好みの検索サイトに行き、
<code>strftime</code> で検索してみてください。文法は同じです。</p>
<h3><a name="standard-footer" id="standard-footer">標準のフッタを挿入する</a></h3>
<p>もし数ページを超えるページを持つサイトを管理しているならば、
全ページに対して変項を行なうことが本当に苦痛となり得ることが
分かるでしょう。全てのページに渡ってある種の標準的な外観を
維持しようとしているならば特にそうでしょう。</p>
<p>ヘッダやフッタ用の挿入用ファイルを使用することで、
このような更新にかかる負担を減らすことができます。
一つのフッタファイルを作成し、それを <code>include</code>
SSI コマンドで各ページに入れるだけで済みます。<code>include</code>
要素は、<code>file</code> 属性または <code>virtual</code>
属性のいずれかを使用してどのファイルを挿入するかを決めることができます。
<code>file</code> 属性は、<em>カレントディレクトリからの相対パスで示された
</em>ファイルパスです。
それは / で始まる絶対ファイルパスにはできず、また、そのパスの一部に ../
を含むことができないことを意味します。<code>virtual</code>
属性は、おそらくより便利だと思いますが、提供するドキュメントからの相対
URL で指定すべきです。それは / で始めることができますが、
提供するファイルと同じサーバ上に存在しなくてはなりません。</p>
<div class="example"><p><code>
<!--#include virtual="/footer.html" -->
</code></p></div>
<p>私は最後の二つを組み合わせて、<code>LAST_MODIFIED</code>
ディレクティブをフッタファイルの中に置くことがよくあります。
SSI ディレクティブは、挿入用のファイルに含ませたり、
挿入ファイルのネストをしたりすることができます。すなわち、
挿入用のファイルは他のファイルを再帰的に挿入することができます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="config" id="config">他に何が設定できるのか ?</a></h2>
<p>時刻書式を <code>config</code> で設定できることに加えて、
更に二つ <code>config</code> で設定することができます。</p>
<p>通常、SSI ディレクティブで何かがうまくいかないときは、
次のメッセージが出力されます。</p>
<div class="example"><p><code>
[an error occurred while processing this directive]
</code></p></div>
<p>このメッセージを他のものにしたい場合、<code>config</code>
要素の <code>errmsg</code> 属性で変更することができます:</p>
<div class="example"><p><code>
<!--#config errmsg="[It appears that you don't know how to use SSI]" -->
</code></p></div>
<p>おそらく、エンドユーザはこのメッセージを決して見ることはありません。
なぜなら、そのサイトが生きた状態になる前に SSI ディレクティブに関する
全ての問題を解決しているはずだからです。(そうですよね?)</p>
<p>そして、<code>config</code> において <code>sizefmt</code>
属性を使用することで、
返されるファイルサイズの書式を設定することができます。
バイト数には <code>bytes</code> を、適当に Kb や Mb
に短縮させるには <code>abbrev</code> を指定することができます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exec" id="exec">コマンドの実行</a></h2>
<p>今後数ヶ月のうちに、小さな CGI プログラムと SSI
を使用する記事を出したいと考えています。ここではそれとは別に、
<code>exec</code> 要素によって行なうことができることを示します。
SSI にシェル (正確には <code>/bin/sh</code>。Win32 ならば DOS シェル)
を使用してコマンドを実行させることができます。
下記の例では、ディレクトリリスト出力を行ないます。</p>
<div class="example"><p><code>
<pre><br />
<!--#exec cmd="ls" --><br />
</pre>
</code></p></div>
<p>Windows 上では、</p>
<div class="example"><p><code>
<pre><br />
<!--#exec cmd="dir" --><br />
</pre>
</code></p></div>
<p>Windows 上では、このディレクティブによっていくつかの奇妙な
書式に気づくでしょう。なぜなら <code>dir</code> の出力が文字列
``<<code>dir</code>>'' を含み、ブラウザを混乱させるからです。</p>
<p>この機能は非常に危険であり、どんなコードでも <code>exec</code>
タグに埋め込まれてしまえば実行することに注意してください。例えば
`` ゲストブック '' のように、もし、
ユーザがページの内容を編集できる状況にあるならば、
この機能を確実に抑制してください。<code>Options</code>
ディレクティブの <code>IncludesNOEXEC</code> 引数を指定することで、
SSI は許可するけれど <code>exec</code>
機能は許可しないようにすることができます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="advanced" id="advanced">高度な SSI テクニック</a></h2>
<p>コンテンツを出力することに加え、Apache SSI は変数を設定し、
そして比較と条件分岐にその変数を使用できる機能を提供しています。
</p>
<h3><a name="caveat" id="caveat">警告</a></h3>
<p>この記事で述べた大部分の機能は、Apache 1.2
以降を使用している場合のみ利用可能です。もちろん、もし Apache 1.2
以降を使用してない場合、直ちにアップグレードする必要があります。
さぁ、今それを行ないなさい。それまで待っています。</p>
<h3><a name="variables" id="variables">変数を設定する</a></h3>
<p><code>set</code> ディレクティブを使用して、
後で使用するために変数を設定することができます。
これは後の説明で必要になるので、ここでそれについて述べています。
文法は以下のとおりです:</p>
<div class="example"><p><code>
<!--#set var="name" value="Rich" -->
</code></p></div>
<p>このように単純に文字どおりに設定することに加え、
<a href="../env.html">環境変数</a>や上記の変数
(例えば <code>LAST_MODIFIED</code> のような)
を含む他のあらゆる変数を値を設定するのに使用することができます。
変数名の前にドル記号 ($) を使用することで、
それがリテラル文字列ではなくて変数であることを示します。</p>
<div class="example"><p><code>
<!--#set var="modified" value="$LAST_MODIFIED" -->
</code></p></div>
<p>ドル記号 ($) を文字として変数の値に入れるには、
バックスラッシュによってドル記号をエスケープする必要があります。</p>
<div class="example"><p><code>
<!--#set var="cost" value="\$100" -->
</code></p></div>
<p>最後になりますが、長い文字列の中に変数を置きたい場合で、
変数名が他の文字とぶつかる可能性があり、
それらの文字について混乱してしまう場合、この混乱を取り除くため、
変数名を中括弧で囲むことができます
(これについての良い例を示すのは難しいのですが、
おそらく分かっていただけるでしょう)。
</p>
<div class="example"><p><code>
<!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" -->
</code></p></div>
<h3><a name="conditional" id="conditional">条件式</a></h3>
<p>さて、変数を持っていて、
それらの値を設定して比較することができるのですから、
条件を表すためにそれらを使用することができます。これにより
SSI はある種の小さなプログラミング言語になっています。
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> は条件を表現するために <code>if</code>,
<code>elif</code>, <code>else</code>, <code>endif</code>
構造を提供しています。これによって、
一つの実際のページから複数の論理ページを効果的に生成することができます。</p>
<p>条件構造は以下のとおりです:</p>
<div class="example"><p><code>
<!--#if expr="test_condition" --><br />
<!--#elif expr="test_condition" --><br />
<!--#else --><br />
<!--#endif -->
</code></p></div>
<p><em>test_condition</em>
はあらゆる種類の論理的比較をすることができます。
値を比較したり、その値が ``真'' かどうかを評価します
(空でないなら与えられた文字列は真です)。
利用可能な比較演算子の全てのリストについては、
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> ドキュメンテーションを参照してください。
ここでは、この構造をどう使用するかの例をいくつか示します。</p>
<p>設定ファイルで次の行を記述します:</p>
<div class="example"><p><code>
BrowserMatchNoCase macintosh Mac<br />
BrowserMatchNoCase MSIE InternetExplorer
</code></p></div>
<p>これはクライアントが Macintosh
上でインターネットエクスプローラが動いている場合、環境変数
``Mac'' と ``InternetExplorer'' を真と設定します。</p>
<p>次に、SSI が可能になったドキュメントで以下を行ないます:
</p>
<div class="example"><p><code>
<!--#if expr="${Mac} && ${InternetExplorer}" --><br />
Apologetic text goes here<br />
<!--#else --><br />
Cool JavaScript code goes here<br />
<!--#endif -->
</code></p></div>
<p>Mac 上の IE に対して何か思うところがあるわけでありません。
他では実行できているいくつかの JavaScript を Mac 上の IE
で実行させるのに、先週数時間苦労したというだけのことです。
上の例はその暫定的な対処方法です。</p>
<p>他のどんな変数 (あなたが定義するもの、
または普通の環境変数のいずれか) も、条件文に使用することができます。
Apache は <code>SetEnvIf</code> ディレクティブや他の関連
ディレクティブを使用して環境変数を設定することができます。
この機能により、CGI
に頼ることなくかなり複雑な動的なことをさせることができます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="conclusion" id="conclusion">終わりに</a></h2>
<p>SSI は確かに CGI
や動的なウェブページを生成する他の技術に代わるものではありません。
しかし、たくさんの余分な作業をせずに、
少量の動的なコンテンツを加えるにはすぐれた方法です。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="../en/howto/ssi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/ssi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/ssi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/ssi.html" title="Japanese"> ja </a> |
<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/ssi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/cgi.html.fr.utf8 0000664 0001751 0001751 00000104340 14740503670 021122 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Tutoriel Apache : Contenu dynamique basé sur CGI - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Recettes et tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Tutoriel Apache : Contenu dynamique basé sur CGI</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/cgi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/cgi.html" title="Français"> fr </a> |
<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#intro">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuring">Configurer Apache pour autoriser CGI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#writing">Ecrire un programme CGI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">Mais ça ne marche toujours pas !</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#behindscenes">Que se passe-t-il en coulisse</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#libraries">Bibliothèques et modules CGI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinfo">Pour plus d'informations</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="intro" id="intro">Introduction</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_alias.html">mod_alias</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_cgid.html">mod_cgid</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li></ul></td></tr></table>
<p>CGI (Common Gateway Interface) définit une méthode d'interaction
entre un serveur web et des programmes générateurs de contenu
externes, plus souvent appelés programmes CGI ou scripts CGI.
Il s'agit d'une méthode simple pour ajouter du contenu dynamique à votre site
web en utilisant votre langage de programmation préféré.
Ce document est une introduction à la configuration de CGI sur votre
serveur web Apache, et une initiation à l'écriture de programmes
CGI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuring" id="configuring">Configurer Apache pour autoriser CGI</a></h2>
<p>Apache doit être configuré pour permettre l'exécution des
programmes CGI, pour que vos programmes CGI puissent fonctionner
correctement. Il existe plusieurs méthodes pour y parvenir.</p>
<div class="warning">Note: si Apache a été compilé avec le support
des modules partagés (DSO), vous devez vous assurer que le module CGI est
chargé ; vous devez pour cela vérifier que la directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> correspondante n'a pas été
commentée dans votre <code>httpd.conf</code>. Une directive correcte
doit ressembler à ceci :
<pre class="prettyprint lang-config">LoadModule cgid_module modules/mod_cgid.so</pre>
Sous Windows, ou si l'on utilise un module MPM non-threadé comme prefork,
une directive correctement configurée sera du style :
<pre class="prettyprint lang-config">LoadModule cgi_module modules/mod_cgi.so</pre>
</div>
<h3><a name="scriptalias" id="scriptalias">ScriptAlias</a></h3>
<p>La directive <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> indique à Apache qu'un
répertoire particulier est dédié aux programmes CGI. Apache
considérera que tout fichier situé dans ce répertoire est un
programme CGI, et tentera de l'exécuter lorsque cette ressource
fera l'objet d'une requête client.</p>
<p>La directive <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> se présente comme suit
:</p>
<pre class="prettyprint lang-config">ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"</pre>
<p>Cet exemple est tiré de votre fichier de configuration
<code>httpd.conf</code> par défaut, si vous avez installé Apache
dans son répertoire par défaut. La directive <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code> est similaire à la
directive <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, qui
définit à quel répertoire particulier doit correspondre un préfixe
d'URL. <code class="directive">Alias</code> et
<code class="directive">ScriptAlias</code> sont généralement utilisés pour
accéder à des répertoires situés en dehors du répertoire défini
par la directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. La différence entre
<code class="directive">Alias</code> et <code class="directive">ScriptAlias</code>
réside dans le fait que <code class="directive">ScriptAlias</code> indique
en plus que tout ce qui se trouve sous le préfixe d'URL doit être
considéré comme un programme CGI. Ainsi, l'exemple ci-dessus
indique à Apache que toute requête pour une ressource commençant
par <code>/cgi-bin/</code> doit être servie depuis le répertoire
<code>/usr/local/apache2/cgi-bin/</code>, et doit être traitée en
tant que programme CGI.</p>
<p>Par exemple, si une requête pour l'URL
<code>http://www.example.com/cgi-bin/test.pl</code> est
effectuée, Apache tentera d'exécuter le fichier
<code>/usr/local/apache2/cgi-bin/test.pl</code> et en renverra la
sortie. Bien entendu, le fichier doit exister, être exécutable, et
retourner sa sortie d'une manière particulière, sinon Apache
renverra un message d'erreur.</p>
<h3><a name="nonscriptalias" id="nonscriptalias">CGI en dehors des répertoires ScripAlias</a></h3>
<p>Pour des raisons de sécurité, la localisation des programmes
CGI est souvent restreinte aux
répertoires définis par <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>. De cette manière, les administrateurs
peuvent contrôler précisément qui est autorisé à utiliser les
programmes CGI. Cependant, si les précautions adéquates quant à
la sécurité sont prises, il n'y a aucune raison pour que les
programmes CGI ne puissent pas être exécutés depuis d'autres
répertoires. Par exemple, vous pouvez autoriser les utilisateurs à
enregistrer des contenus web dans leurs répertoires home à l'aide
de la directive <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>. S'ils veulent mettre en
oeuvre leurs propres programmes CGI, mais n'ont pas l'autorisation
d'accès au répertoire <code>cgi-bin</code> principal, ils devront
être en mesure d'exécuter ces programmes depuis un autre
répertoire.</p>
<p>L'autorisation d'exécution des programmes CGI dans un
répertoire arbitraire se fait en deux étapes. En premier lieu, le
gestionnaire <code>cgi-script</code> doit être activé à l'aide
d'une directive <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> ou <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>. En second lieu,
<code>ExecCGI</code> doit être spécifié dans la directive <code class="directive"><a href="../mod/core.html#options">Options</a></code>.</p>
<h3><a name="options" id="options">Utilisation d'options explicites pour permettre l'exécution
des programmes CGI</a></h3>
<p>Vous pouvez utiliser de manière explicite la directive
<code class="directive"><a href="../mod/core.html#options">Options</a></code> dans le fichier de
configuration de votre serveur principal, pour indiquer que
l'exécution des programmes CGI est permise depuis un répertoire
particulier :</p>
<pre class="prettyprint lang-config"><Directory "/usr/local/apache2/htdocs/somedir">
Options +ExecCGI
</Directory></pre>
<p>La directive ci-dessus indique à Apache qu'il doit permettre
l'exécution des fichiers CGI. Vous devez aussi indiquer au serveur
quels fichiers sont des fichiers CGI. La directive <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> suivante indique au
serveur qu'il doit traiter tous les fichiers possédant une
extension <code>cgi</code> ou <code>pl</code> en tant que
programmes CGI :</p>
<pre class="prettyprint lang-config">AddHandler cgi-script .cgi .pl</pre>
<h3><a name="htaccess" id="htaccess">Fichiers .htaccess</a></h3>
<p>Le <a href="htaccess.html"><code>tutoriel
.htaccess</code></a> montre comment activer les programmes
CGI si vous n'avez pas accès au
fichier <code>httpd.conf</code>.</p>
<h3><a name="userdir" id="userdir">Répertoires utilisateurs</a></h3>
<p>Pour permettre l'exécution en tant que programme CGI de tout
fichier possédant l'extension <code>.cgi</code> et situé dans un
répertoire utilisateur, vous pouvez utiliser la configuration
suivante :</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html">
Options +ExecCGI
AddHandler cgi-script .cgi
</Directory></pre>
<p>Pour indiquer un sous-répertoire <code>cgi-bin</code> d'un
répertoire utilisateur où tout fichier sera traité en tant que
programme CGI, vous pouvez utiliser ceci :</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html/cgi-bin">
Options ExecCGI
SetHandler cgi-script
</Directory></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="writing" id="writing">Ecrire un programme CGI</a></h2>
<p>Il y a deux différences principales entre la programmation
"standard" et la programmation CGI.</p>
<p>En premier lieu, toute sortie de votre programme CGI doit être
précédée d'un en-tête <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">MIME-type</a>. Il s'agit d'un
en-tête HTTP qui indique au client quel type de contenu il reçoit.
La plupart du temps, il se présente comme suit :</p>
<div class="example"><p><code>
Content-type: text/html
</code></p></div>
<p>En second lieu, votre sortie doit être en HTML, ou tout autre
format qu'un navigateur est en mesure d'afficher. La plupart du
temps, il s'agira de HTML, mais occasionnellement, vous pouvez être
amené à écrire un programme CGI qui renvoie une image gif, ou un
autre type de contenu non-HTML.</p>
<p>A part ces deux différences, un programme CGI ressemblera à tout
autre programme que vous pourriez être amené à écrire.</p>
<h3><a name="firstcgi" id="firstcgi">Votre premier programme CGI</a></h3>
<p>L'exemple suivant est un exemple de programme CGI qui permet
d'afficher une ligne de caractères dans votre navigateur. Ecrivez
ce qui suit, enregistrez le dans un fichier nommé
<code>premier.pl</code>, et placez le dans votre répertoire
<code>cgi-bin</code>.</p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl
print "Content-type: text/html\n\n";
print "Hello, World.";</pre>
<p>Même si Perl ne vous est pas familier, vous devriez être
capable de comprendre le fonctionnement de ce programme. La
première ligne indique à Apache (ou à toute interface à partir de
laquelle le programme s'exécute) que ce programme peut être
exécuté en fournissant son fichier à l'interpréteur
<code>/usr/bin/perl</code>. La seconde ligne affiche la
déclaration du type de contenu considéré, suivie de deux paires
"Retour chariot - Nouvelle ligne". Ceci a pour effet d'insérer une
ligne vide après l'en-tête pour marquer la fin des en-têtes HTTP,
et le début du corps du document. La troisième ligne affiche la
chaîne de caractères "Bonjour tout le monde . . .". Et c'est tout
ce dont vous avez besoin.</p>
<p>Si vous ouvrez votre navigateur favori et lui indiquez
l'adresse</p>
<div class="example"><p><code>
http://www.example.com/cgi-bin/premier.pl
</code></p></div>
<p>ou toute autre URL correspondant à votre programme CGI, Vous
verrez la ligne <code>Bonjour tout le monde . . .</code>
s'afficher dans la fenêtre de votre navigateur. Ce n'est pas
extraordinaire, mais si vous y êtes parvenu, vous avez de bonnes
chances d'y parvenir pour tout autre programme plus
sophistiqué.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="troubleshoot" id="troubleshoot">Mais ça ne marche toujours pas !</a></h2>
<p>Vous devriez voir au moins une des quatre sorties suivantes dans
votre navigateur lorsque vous essayez d'accéder à votre programme
CGI depuis le web :</p>
<dl>
<dt>Le flux de sortie de votre programme CGI</dt>
<dd>Impeccable ! Cela signifie que tout fonctionne correctement.
Si la sortie est correcte mais n'est pas traitée correctement par
le navigateur, assurez-vous d'avoir défini
<code>Content-Type</code> de manière appropriée dans votre
programme CGI.</dd>
<dt>Le code source de votre programme CGI ou un message "POST
Method Not Allowed"</dt>
<dd>Cela signifie que vous n'avez pas configuré Apache de manière
à ce qu'il puisse traiter votre programme CGI. Relisez la section
sur la <a href="#configuring">configuration d'Apache</a>, et
essayez de trouver votre erreur.</dd>
<dt>Un message commençant par "Forbidden"</dt>
<dd>Ce type de message est révélateur d'un problème de
droits. Consultez le <a href="#errorlogs">journal des erreurs
d'Apache</a> et la section ci-dessous sur les <a href="#permissions">droits des fichiers</a>.</dd>
<dt>Un message contenant "Internal Server Error"</dt>
<dd>Si vous consultez le <a href="#errorlogs">journal des erreurs
d'Apache</a>, vous y trouverez probablement des messages du type
"Premature end of script headers" (Fin prématurée des en-têtes de
script), éventuellement accompagnés d'un message d'erreur généré
par votre programme CGI. Dans ce cas, il va vous falloir lire
chacune des sections ci-dessous pour déterminer ce qui empêche
votre programme CGI de générer les en-têtes appropriés.</dd>
</dl>
<h3><a name="permissions" id="permissions">Droits des fichiers</a></h3>
<p>Souvenez-vous que le serveur ne s'exécute pas sous votre nom.
En d'autres termes, lorsque le serveur a démarré, il s'exécute
avec les droits d'un utilisateur non privilégié - en général
<code>nobody</code>, ou <code>www</code> - et en conséquence, il
aura besoin de droits supplémentaires pour pouvoir exécuter des
fichiers dont vous êtes le propriétaire. En général, pour qu'un
fichier ait des droits suffisants pour être exécutable par
<code>nobody</code>, il suffit de lui attribuer des droits
d'exécution pour tout le monde :</p>
<div class="example"><p><code>
chmod a+x premier.pl
</code></p></div>
<p>En outre, si votre programme doit pouvoir accéder en lecture
et/ou écriture à d'autres fichiers, ces derniers devront avoir les
droits appropriés.</p>
<h3><a name="pathinformation" id="pathinformation">Chemin des exécutables (PATH) et variables
d'environnement</a></h3>
<p>Lorsque vous lancez un programme depuis la ligne de commande,
certaines informations sont passées au shell sans que vous vous en
doutiez. Par exemple, la variable <code>PATH</code> indique au
shell où il doit rechercher les exécutables auxquels vous faites
référence.</p>
<p>Lorsqu'un programme s'exécute depuis le serveur web en tant que
programme CGI, sa variable <code>PATH</code> n'aura peut-être pas
la même valeur. Tout programme que vous invoquez dans votre
programme CGI ( comme par exemple <code>sendmail</code>) devra
être spécifié par son chemin complet, de façon à ce que le shell
puisse le trouver lorsqu'il tentera d'exécuter votre programme
CGI.</p>
<p>Un exemple typique de spécification de programme est le chemin
vers l'interpréteur de script (souvent <code>perl</code>) que l'on
trouve à la première ligne de votre programme CGI et qui va
ressembler à ceci :</p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl</pre>
<p>Assurez-vous qu'il s'agit bien du chemin correct vers
l'interpréteur.</p>
<div class="warning">
Lors de l'édition de scripts CGI sous Windows, il se peut que des
caractères de fin de ligne soient ajoutés au chemin de
l'interpréteur. Assurez-vous donc que les fichiers sont bien
transmis au serveur en mode ASCII. Dans le cas contraire, l'OS
pourra envoyer des avertissements "Command not found" à cause des
caractères de fin de ligne non reconnus car considérés comme
faisant partie du nom de fichier de l'interpréteur.
</div>
<h3><a name="missingenv" id="missingenv">Variables d'environnement manquantes</a></h3>
<p>Si votre programme CGI dépend de <a href="#env">variables
d'environnement</a> non standards, vous devrez vous assurez que
ces variables lui sont bien transmises par Apache.</p>
<p>Lorsque des en-têtes HTTP ne sont pas transmis à
l'environnement, assurez-vous qu'ils sont bien formatés selon la
<a href="http://tools.ietf.org/html/rfc2616">RFC 2616</a>, section
4.2 : les noms d'en-têtes doivent commencer par une lettre,
elle-même suivie de lettres, chiffres ou traits d'union. Tout
en-tête dont le nom viole cette règle sera ignoré.</p>
<h3><a name="syntaxerrors" id="syntaxerrors">Erreurs inhérentes au programme</a></h3>
<p>La plupart des échecs dans l'exécution d'un programme CGI
proviennent du programme lui-même. Ceci est particulièrement vrai
lorsque ce satané programme CGI se bloque, alors que vous avez
appris à ne plus commettre les deux erreurs précédentes. La
première chose à faire est de vous assurer que votre programme
s'exécute depuis la ligne de commande, avant de le tester à partir
du serveur web. Par exemple, essayez :</p>
<div class="example"><p><code>
cd /usr/local/apache2/cgi-bin<br />
./premier.pl
</code></p></div>
<p>(N'invoquez pas l'interpréteur <code>perl</code>. Le shell et
Apache doivent être capable de le déterminer à partir de <a href="#pathinformation">l'information sur le chemin</a> située sur
la première ligne du script.)</p>
<p>La première chose que vous devriez voir affichée par votre
programme est un ensemble d'en-têtes HTTP, comprenant entre autres
le <code>Content-Type</code>, et suivi d'une ligne vide. Si vous
voyez quoi que ce soit d'autre, Apache renverra l'erreur
<code>Premature end of script headers</code> si vous tentez
d'exécuter le programme depuis le serveur. Voir <a href="#writing">Ecriture d'un programme CGI</a> ci-dessus pour
plus de détails.</p>
<h3><a name="errorlogs" id="errorlogs">Journalisation des erreurs</a></h3>
<p>Les journaux d'erreurs sont vos amis. Toute anomalie de
fonctionnement est consignée dans le journal des erreurs et c'est
ici que vous devez regarder en premier en cas de problème. Si
l'hébergeur de votre site ne vous donne pas accès au journal des
erreurs, vous avez tout intérêt à vous tourner vers quelqu'un
d'autre. Apprenez à déchiffrer les journaux d'erreurs, et vous
vous apercevrez que la plupart des problèmes seront rapidement
identifiés . . . et résolus.</p>
<h3><a name="suexec" id="suexec">Suexec</a></h3>
<p>Le programme <a href="../suexec.html">suexec</a> permet
d'exécuter les programmes CGI avec des droits différents selon le
serveur virtuel ou le répertoire utilisateur dans lequel ils
se situent. Suexec effectue une vérification des droits très
stricte, et toute anomalie détectée au cours de cette vérification
entraînera un echec d'exécution de votre programme CGI avec
affichage de l'erreur <code>Premature end of script
headers</code>.</p>
<p>Pour savoir si vous pouvez utiliser suexec, tapez la commande
<code>apachectl -V</code>, et regardez le chemin indiqué par
<code>SUEXEC_BIN</code>. Si au démarrage d'Apache, ce dernier
trouve un exécutable <code class="program"><a href="../programs/suexec.html">suexec</a></code> dans ce chemin,
suexec sera activé.</p>
<p>Si vous ne maîtrisez pas le fonctionnement de suexec, il vous
est déconseillé de l'utiliser. Pour désactiver suexec, supprimer
simplement (ou renommez) l'exécutable <code class="program"><a href="../programs/suexec.html">suexec</a></code>
pointé par <code>SUEXEC_BIN</code> et redémarrez le serveur. Si
après une lecture de <a href="../suexec.html">suexec</a>, vous
décidez quand-même de l'utiliser, tapez la commande <code>suexec
-V</code> pour voir où se situe le journal de suexec, et utilisez
ce dernier pour déterminer quelles règles vous violez
éventuellement.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="behindscenes" id="behindscenes">Que se passe-t-il en coulisse</a></h2>
<p>Lorsque vos compétences en programmation CGI seront plus
poussées, il s'avérera intéressant pour vous de mieux comprendre ce
qui se passe en coulisse, et en particulier la manière dont le
navigateur et le serveur dialoguent entre eux. En effet, bien qu'il
soit tout à fait louable d'écrire un programme qui affiche "Bonjour
tout le monde . . .", cela ne sert pas à grand chose.</p>
<h3><a name="env" id="env">Variables d'environnement</a></h3>
<p>Les variables d'environnement sont des valeurs qui gravitent
autour de vous lorsque vous utilisez votre ordinateur. Elles sont
très utiles, à l'instar de votre chemin par défaut (où votre
ordinateur va rechercher le fichier physique correspondant à la
commande que vous avez tapée), votre nom d'utilisateur, le type de
votre terminal, etc... Pour obtenir une liste complète des
variables d'environnement standards que vous utilisez tous les
jours, tapez <code>env</code> dans votre interpréteur
de commandes.</p>
<p>Au cours de la transaction CGI, le serveur et le navigateur
définissent aussi des variables d'environnement, de façon à ce
qu'ils puissent communiquer entre eux. Ces variables définissent
entre autre le type de navigateur (Netscape, IE, Lynx), le type de
serveur (Apache, IIS, WebSite), le nom du programme CGI en cours
d'exécution, etc...</p>
<p>Ces variables sont à la disposition du programmeur CGI, et
elles constituent 50% de la communication client-serveur. La liste
complète des variables requises se trouve à
<a href="http://www.ietf.org/rfc/rfc3875">Common Gateway
Interface RFC</a>.</p>
<p>Ce programme CGI basique en Perl permet d'afficher toutes les
variables d'environnement qui sont échangées. Deux programmes
similaires sont fournis avec la distribution d'Apache et situés
dans le répertoire <code>cgi-bin</code>.
Notez que certaines variables sont
obligatoires, alors que d'autres sont optionnelles, si bien que
vous verrez s'afficher certaines variables qui ne font pas partie
de la liste officielle. De plus, Apache vous propose de nombreuses
méthodes pour <a href="../env.html">ajouter vos propres
variables d'environnement</a> aux variables de base fournies par
défaut.</p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl
use strict;
use warnings;
print "Content-type: text/html\n\n";
foreach my $key (keys %ENV) {
print "$key --> $ENV{$key}<br>";
}</pre>
<h3><a name="stdin" id="stdin">STDIN et STDOUT</a></h3>
<p>L'entrée standard (<code>STDIN</code>) et la sortie standard
(<code>STDOUT</code>) constituent d'autres voies de communication
entre le client et le serveur. Dans un contexte normal,
<code>STDIN</code> correspond au clavier, ou à un fichier fourni
au programme à des fins de traitement, et <code>STDOUT</code> à la
console ou à l'écran.</p>
<p>Lorsque vous transmettez un formulaire web à un programme CGI
par la méthode <code>POST</code>, les données de ce formulaire
sont transcrites dans un format spécial et transmises à votre
programme CGI via <code>STDIN</code>. Le programme peut alors les
traiter comme si elles provenaient du clavier ou d'un
fichier.</p>
<p>Ce "format spécial" est très simple. Un nom de champ et sa
valeur sont reliés entre eux par un signe "égal" (=), et chacune
de ces paires nom champ/valeur est séparée de la suivante par un
"et" commercial (&). Les caractères
spéciaux comme les espaces, les "et" commerciaux, et les signes
"égal" sont convertis en leur équivalent hexadécimal pour éviter
qu'ils ne gâchent le travail. La chaîne contenant les données doit
ressembler à ceci :</p>
<div class="example"><p><code>
name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey
</code></p></div>
<p>Vous verrez aussi parfois une chaîne de ce type accolée à une
URL. Dans ce cas, le serveur enregistre cette chaîne dans la
variable d'environnement appelée <code>QUERY_STRING</code>. On a
alors affaire à une requête de type <code>GET</code>. Votre
formulaire HTML indique laquelle des méthodes <code>GET</code> ou
<code>POST</code> est utilisée pour transmettre les données, en
définissant l'attribut <code>METHOD</code> au niveau de la balise
<code>FORM</code>.</p>
<p>Votre programme est ensuite chargé d'extraire les informations
utiles de cette chaîne. Heureusement, des bibliothèques et des
modules sont à votre disposition pour vous aider à traiter ces
données, et à gérer les différents aspects de votre programme
CGI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="libraries" id="libraries">Bibliothèques et modules CGI</a></h2>
<p>Pour écrire un programme CGI, il vous est conseillé d'utiliser
une bibliothèque de code, ou un module, qui effectueront une grande
partie du travail de base pour vous. Ceci vous permettra de diminuer
le nombre d'erreurs et d'accélérer le développement.</p>
<p>Si vous écrivez des programmes CGI en Perl, des modules sont à
votre disposition à <a href="http://www.cpan.org/">CPAN</a>. A ce
sujet, le module le plus populaire est <code>CGI.pm</code>. Vous
pouvez aussi essayer <code>CGI::Lite</code>, qui implémente les
fonctionnalités strictement nécessaires, mais suffisantes pour
la majorité des programmes.</p>
<p>Si vous écrivez des programmes CGI en C, vous disposez de nombreuses
options. L'une d'elles est la bibliothèque <code>CGIC</code> de <a href="https://web.mit.edu/wwwdev/www/cgic.html">https://web.mit.edu/wwwdev/www/cgic.html</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinfo" id="moreinfo">Pour plus d'informations</a></h2>
<p>La spécification CGI actuelle est disponible dans la <a href="http://www.ietf.org/rfc/rfc3875">Common Gateway
Interface RFC</a>.</p>
<p>Lorsque vous postez une question à propos d'un problème CGI que
vous rencontrez, que ce soit dans une liste de diffusion ou dans un
newsgroup, faites en sorte de fournir suffisamment d'informations
sur le problème rencontré, ce que vous attendiez exactement, et en
quoi ce qui se produit est réellement différent de ce que vous
attendiez, quel serveur vous utilisez, en quel langage votre
programme CGI a été écrit, et, si possible, son code source. Ceci
permettra une résolution plus aisée de votre problème.</p>
<p>Notez que les questions à propos de problèmes CGI ne doivent
<strong>jamais</strong> être postées dans la base de données de
bogues d'Apache, à moins que vous ne soyez sûr d'avoir trouvé un
problème dans le code source d'Apache.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/howto/cgi.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/cgi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/cgi.html" title="Français"> fr </a> |
<a href="../ja/howto/cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/cgi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/public_html.html.fr.utf8 0000664 0001751 0001751 00000034456 14740503670 022674 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Répertoires web utilisateurs - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Recettes et tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Répertoires web utilisateurs</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/public_html.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Sur les systèmes multi-utilisateurs, on peut permettre à chaque
utilisateur d'avoir un site web dans son répertoire home à l'aide de la
directive <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>. Les
visiteurs de l'URL <code>http://example.com/~nom_utilisateur/</code>
recevront un contenu situé dans le répertoire home de l'utilisateur
"<code>nom_utilisateur</code>", et dans le sous-répertoire spécifié par
la directive <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>.</p>
<p>Notez que par défaut, l'accès à ces répertoires n'est
<strong>pas</strong> permis. Vous pouvez en permettre l'accès à l'aide
de la directive <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> en
décommentant la ligne :</p>
<pre class="prettyprint lang-config">#Include conf/extra/httpd-userdir.conf</pre>
<p>dans le fichier de configuration par défaut
<code>conf/httpd.conf</code>, et en adaptant le
fichier <code>httpd-userdir.conf</code> selon vos besoins, ou en
incluant les directives appropriées dans une section
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> du fichier de
configuration principal.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Répertoires web utilisateurs</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#userdir">Définition du chemin des fichiers avec UserDir</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirect">Redirection vers des URLs externes</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#enable">Définition de la liste des utilisateurs autorisés à utiliser
cette fonctionnalité</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#cgi">Définition d'un répertoire CGI pour chaque utilisateur</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#htaccess">Permettre aux utilisateurs de modifier la
configuration</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../urlmapping.html">Mise en correspondance des URLs
avec le système de fichiers</a></li><li><a href="#comments_section">Commentaires</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="related" id="related">Répertoires web utilisateurs</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code></li><li><code class="directive"><a href="../mod/core.html#directorymatch">DirectoryMatch</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="userdir" id="userdir">Définition du chemin des fichiers avec UserDir</a></h2>
<p>La directive <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>
permet de spécifier un répertoire à partir duquel le contenu de
l'utilisateur pourra être chargé. Elle peut revêtir plusieurs
formes.</p>
<p>Si le chemin spécifié ne commence pas par un slash, il sera
interprété comme chemin relatif au répertoire home de l'utilisateur
considéré. Par exemple, avec cette configuration :</p>
<pre class="prettyprint lang-config">UserDir public_html</pre>
<p>l'URL <code>http://example.com/~rbowen/fichier.html</code>
correspondra au chemin fichier
<code>/home/rbowen/public_html/fichier.html</code></p>
<p>Si le chemin spécifié commence par un slash, le chemin du fichier
sera construit en utilisant ce chemin, suivi du nom de l'utilisateur
considéré. Par exemple, avec cette configuration :</p>
<pre class="prettyprint lang-config">UserDir /var/html</pre>
<p>l'URL <code>http://example.com/~rbowen/fichier.html</code>
correspondra au chemin fichier
<code>/var/html/rbowen/fichier.html</code></p>
<p>Si le chemin spécifié contient un astérisque (*), ce dernier sera
remplacé par le nom de l'utilisateur dans le chemin du fichier
correspondant. Par exemple, avec cette configuration :</p>
<pre class="prettyprint lang-config">UserDir /var/www/*/docs</pre>
<p>l'URL <code>http://example.com/~rbowen/fichier.html</code>
correspondra au chemin fichier
<code>/var/www/rbowen/docs/fichier.html</code></p>
<p>On peut aussi définir plusieurs répertoires ou chemins de
répertoires.</p>
<pre class="prettyprint lang-config">UserDir public_html /var/html</pre>
<p>Avec l'URL <code>http://example.com/~rbowen/fichier.html</code>,
Apache va rechercher <code>~rbowen</code>. S'il ne le trouve pas,
Apache va rechercher <code>rbowen</code> dans
<code>/var/html</code>. S'il le trouve, l'URL ci-dessus correspondra
au chemin fichier <code>/var/html/rbowen/file.html</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirect" id="redirect">Redirection vers des URLs externes</a></h2>
<p>On peut utiliser la directive <code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code> pour rediriger les requêtes
relatives aux répertoires utilisateurs vers des URLs externes.</p>
<pre class="prettyprint lang-config">UserDir http://example.org/users/*/</pre>
<p>L'exemple ci-dessus va rediriger une requête pour
<code>http://example.com/~bob/abc.html</code> vers
<code>http://exemple.org/users/bob/abc.html</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="enable" id="enable">Définition de la liste des utilisateurs autorisés à utiliser
cette fonctionnalité</a></h2>
<p>En suivant la syntaxe décrite dans la documentation de UserDir,
vous pouvez définir quels utilisateurs sont autorisés à utiliser
cette fonctionnalité :</p>
<pre class="prettyprint lang-config">UserDir disabled root jro fish</pre>
<p>La configuration ci-dessus va autoriser l'utilisation de la
fonctionnalité pour tous les utilisateurs, à l'exception de ceux
listés à la suite de l'argument <code>disabled</code>. De même, vous
pouvez interdire l'utilisation de la fonctionnalité à tous les
utilisateurs sauf certains d'entre eux en utilisant une
configuration du style :</p>
<pre class="prettyprint lang-config">UserDir disabled
UserDir enabled rbowen krietz</pre>
<p>Vous trouverez d'autres exemples dans la documentation de
<code class="directive"><a href="../mod/mod_userdir.html#userdir">UserDir</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="cgi" id="cgi">Définition d'un répertoire CGI pour chaque utilisateur</a></h2>
<p>Afin de réserver un répertoire cgi-bin pour chaque utilisateur,
vous pouvez utiliser une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> pour activer CGI dans un
sous-répertoire particulier d'un répertoire home utilisateur.</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html/cgi-bin/">
Options ExecCGI
SetHandler cgi-script
</Directory></pre>
<p>Avec la configuration ci-dessus, et en supposant que
<code>UserDir</code> est défini à <code>public_html</code>, un
programme CGI <code>exemple.cgi</code> pourra être chargé depuis ce
répertoire en passant par l'URL :</p>
<div class="example"><p><code>
http://example.com/~rbowen/cgi-bin/exemple.cgi
</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="htaccess" id="htaccess">Permettre aux utilisateurs de modifier la
configuration</a></h2>
<p>Si vous voulez que vos utilisateurs puissent modifier la
configuration du serveur pour ce qui concerne leur espace web, ils
devront utiliser des fichiers <code>.htaccess</code> pour effectuer
ces modifications. Assurez-vous d'avoir défini la directive
<code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> à une valeur
appropriée pour les directives dont vous voulez permettre la
modification aux utilisateurs. Voir le <a href="htaccess.html">tutoriel .htaccess</a> pour plus de détails sur
la manière dont tout ceci fonctionne.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/howto/public_html.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/public_html.html" title="Français"> fr </a> |
<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/public_html.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/public_html.html 0000664 0001751 0001751 00000001104 13710016232 021346 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: public_html.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: public_html.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: public_html.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: public_html.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: public_html.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: public_html.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/howto/cgi.html 0000664 0001751 0001751 00000000701 13710016232 017610 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: cgi.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: cgi.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: cgi.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: cgi.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: cgi.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
httpd-2.4.64/docs/manual/howto/auth.html 0000664 0001751 0001751 00000001032 13710016232 020005 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: auth.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: auth.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: auth.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: auth.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: auth.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: auth.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/howto/index.html 0000664 0001751 0001751 00000001046 13710016232 020160 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: index.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: index.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: index.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: index.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: index.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: index.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/howto/access.html.en 0000664 0001751 0001751 00000032751 14737241666 020747 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Access Control - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Access Control</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/howto/access.html" title="English"> en </a> |
<a href="../es/howto/access.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/access.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>Access control refers to any means of controlling access to any
resource. This is separate from <a href="auth.html">authentication and authorization</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Related Modules and Directives</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#host">Access control by host</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#env">Access control by arbitrary variables</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewrite">Access control with mod_rewrite</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moreinformation">More information</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="related" id="related">Related Modules and Directives</a></h2>
<p>Access control can be done by several different modules. The most
important of these are <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> and
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>. Also discussed in this document
is access control using <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="host" id="host">Access control by host</a></h2>
<p>
If you wish to restrict access to portions of your site based on the
host address of your visitors, this is most easily done using
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>.
</p>
<p>The <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
provides a variety of different ways to allow or deny access to
resources. In conjunction with the <code class="directive"><a href="../mod/mod_authz_core.html#requireall">RequireAll</a></code>, <code class="directive"><a href="../mod/mod_authz_core.html#requireany">RequireAny</a></code>, and <code class="directive"><a href="../mod/mod_authz_core.html#requirenone">RequireNone</a></code> directives, these
requirements may be combined in arbitrarily complex ways, to enforce
whatever your access policy happens to be.</p>
<div class="warning"><p>
The <code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>,
<code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code>, and
<code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code> directives,
provided by <code class="module"><a href="../mod/mod_access_compat.html">mod_access_compat</a></code>, are deprecated and
will go away in a future version. You should avoid using them, and
avoid outdated tutorials recommending their use.
</p></div>
<p>The usage of these directives is:</p>
<pre class="prettyprint lang-config">Require host address
Require ip ip.address</pre>
<p>In the first form, <var>address</var> is a fully qualified
domain name (or a partial domain name); you may provide multiple
addresses or domain names, if desired.</p>
<p>In the second form, <var>ip.address</var> is an IP address, a
partial IP address, a network/netmask pair, or a network/nnn CIDR
specification. Either IPv4 or IPv6 addresses may be used.</p>
<p>See <a href="../mod/mod_authz_host.html#requiredirectives">the
mod_authz_host documentation</a> for further examples of this
syntax.</p>
<p>You can insert <code>not</code> to negate a particular requirement.
Note, that since a <code>not</code> is a negation of a value, it cannot
be used by itself to allow or deny a request, as <em>not true</em>
does not constitute <em>false</em>. Thus, to deny a visit using a negation,
the block must have one element that evaluates as true or false.
For example, if you have someone spamming your message
board, and you want to keep them out, you could do the
following:</p>
<pre class="prettyprint lang-config"><RequireAll>
Require all granted
Require not ip 10.252.46.165
</RequireAll></pre>
<p>Visitors coming from that address (<code>10.252.46.165</code>)
will not be able to see the content covered by this directive. If,
instead, you have a machine name, rather than an IP address, you
can use that.</p>
<pre class="prettyprint lang-config">Require not host <var>host.example.com</var>
</pre>
<p>And, if you'd like to block access from an entire domain,
you can specify just part of an address or domain name:</p>
<pre class="prettyprint lang-config">Require not ip 192.168.205
Require not host phishers.example.com moreidiots.example
Require not host gov</pre>
<p>Use of the <code class="directive"><a href="../mod/mod_authz_core.html#requireall">RequireAll</a></code>, <code class="directive"><a href="../mod/mod_authz_core.html#requireany">RequireAny</a></code>, and <code class="directive"><a href="../mod/mod_authz_core.html#requirenone">RequireNone</a></code> directives may be
used to enforce more complex sets of requirements.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="env" id="env">Access control by arbitrary variables</a></h2>
<p>Using the <code class="directive"><a href="../mod/core.html#if"><If></a></code>,
you can allow or deny access based on arbitrary environment
variables or request header values. For example, to deny access
based on user-agent (the browser type) you might do the
following:</p>
<pre class="prettyprint lang-config"><If "%{HTTP_USER_AGENT} == 'BadBot'">
Require all denied
</If></pre>
<p>Using the <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>
<code>expr</code> syntax, this could also be written as:</p>
<pre class="prettyprint lang-config">Require expr %{HTTP_USER_AGENT} != 'BadBot'</pre>
<div class="note"><h3>Warning:</h3>
<p>Access control by <code>User-Agent</code> is an unreliable technique,
since the <code>User-Agent</code> header can be set to anything at all,
at the whim of the end user.</p>
</div>
<p>See <a href="../expr.html">the expressions document</a> for a
further discussion of what expression syntaxes and variables are
available to you.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">Access control with mod_rewrite</a></h2>
<p>The <code>[F]</code> <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> flag causes a 403 Forbidden
response to be sent. Using this, you can deny access to a resource based
on arbitrary criteria.</p>
<p>For example, if you wish to block access to a resource between 8pm
and 7am, you can do this using <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
<pre class="prettyprint lang-config">RewriteEngine On
RewriteCond "%{TIME_HOUR}" ">=20" [OR]
RewriteCond "%{TIME_HOUR}" "<07"
RewriteRule "^/fridge" "-" [F]</pre>
<p>This will return a 403 Forbidden response for any request after 8pm
or before 7am. This technique can be used for any criteria that you wish
to check. You can also redirect, or otherwise rewrite these requests, if
that approach is preferred.</p>
<p>The <code class="directive"><a href="../mod/core.html#if"><If></a></code> directive,
added in 2.4, replaces many things that <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> has
traditionally been used to do, and you should probably look there first
before resorting to mod_rewrite.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moreinformation" id="moreinformation">More information</a></h2>
<p>The <a href="../expr.html">expression engine</a> gives you a
great deal of power to do a variety of things based on arbitrary
server variables, and you should consult that document for more
detail.</p>
<p>Also, you should read the <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code>
documentation for examples of combining multiple access requirements
and specifying how they interact.</p>
<p>See also the <a href="auth.html">Authentication and Authorization</a>
howto.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/howto/access.html" title="English"> en </a> |
<a href="../es/howto/access.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/access.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/access.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/http2.html.en 0000664 0001751 0001751 00000063234 14737241666 020547 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>HTTP/2 guide - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>HTTP/2 guide</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/howto/http2.html" title="English"> en </a> |
<a href="../es/howto/http2.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/http2.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This is the howto guide for the HTTP/2 implementation in Apache httpd. This
feature is <em>production-ready</em> and you may expect interfaces and directives to
remain consistent releases.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#protocol">The HTTP/2 protocol</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#implementation">HTTP/2 in Apache httpd</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#building">Build httpd with HTTP/2 support</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#basic-config">Basic Configuration</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#mpm-config">MPM Configuration</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#clients">Clients</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#tools">Useful tools to debug HTTP/2</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#push">Server Push</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#earlyhints">Early Hints</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code></li><li><a href="#comments_section">Comments</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="protocol" id="protocol">The HTTP/2 protocol</a></h2>
<p>HTTP/2 is the evolution of the world's most successful application layer protocol, HTTP.
It focuses on making more efficient use of network resources. It does not change the fundamentals
of HTTP, the semantics. There are still request and responses and headers and all that. So, if
you already know HTTP/1, you know 95% about HTTP/2 as well.</p>
<p>There has been a lot written about HTTP/2 and how it works. The most normative is, of course,
its <a href="https://tools.ietf.org/html/rfc7540">RFC 7540</a>
(<a href="http://httpwg.org/specs/rfc7540.html">also available in more readable formatting, YMMV</a>).
So, there you'll find the nuts and bolts.</p>
<p>But, as RFC do, it's not really a good thing to read first. It's better to first understand
<em>what</em> a thing wants to do and then read the RFC about <em>how</em> it is done. A much
better document to start with is <a href="https://daniel.haxx.se/http2/">http2 explained</a>
by Daniel Stenberg, the author of <a href="https://curl.haxx.se">curl</a>. It is available in
an ever growing list of languages, too!</p>
<p>Too Long, Didn't read: there are some new terms and gotchas that need to be kept in mind while reading this document:</p>
<ul>
<li>HTTP/2 is a <strong>binary protocol</strong>, as opposed to HTTP 1.1 that is plain text. The latter is meant to be human readable (for example sniffing network traffic) meanwhile the former is not. More info in the official FAQ <a href="https://http2.github.io/faq/#why-is-http2-binary">question</a>.</li>
<li><strong>h2</strong> is HTTP/2 over TLS (protocol negotiation via ALPN).</li>
<li><strong>h2c</strong> is HTTP/2 over TCP.</li>
<li>A <strong>frame</strong> is the smallest unit of communication within an HTTP/2 connection, consisting of a header and a variable-length sequence of octets structured according to the frame type. More info in the official documentation <a href="http://httpwg.org/specs/rfc7540.html#FramingLayer"> section</a>.</li>
<li>A <strong>stream</strong> is a bidirectional flow of frames within the HTTP/2 connection. The correspondent concept in HTTP 1.1 is a request/response message exchange. More info in the official documentation <a href="http://httpwg.org/specs/rfc7540.html#StreamsLayer"> section</a>.</li>
<li>HTTP/2 is able to run <strong>multiple streams</strong> of data over the same TCP connection, avoiding the classic HTTP 1.1 head of blocking slow request and avoiding to re-instantiate TCP connections for each request/response (KeepAlive patched the problem in HTTP 1.1 but did not fully solve it).</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="implementation" id="implementation">HTTP/2 in Apache httpd</a></h2>
<p>The HTTP/2 protocol is implemented by its own httpd module, aptly named
<code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code>. It implements the complete set
of features described by RFC 7540 and supports HTTP/2 over cleartext (http:), as
well as secure (https:) connections. The cleartext variant is named '<code>h2c</code>',
the secure one '<code>h2</code>'. For <code>h2c</code> it allows the <em>direct</em>
mode and the <code>Upgrade:</code> via an initial HTTP/1 request.</p>
<p>One feature of HTTP/2 that offers new capabilities for web developers is
<a href="#push">Server Push</a>. See that section on how your web application
can make use of it.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="building" id="building">Build httpd with HTTP/2 support</a></h2>
<p><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> uses the library of <a href="https://nghttp2.org">nghttp2</a>
as its implementation base. In order to build <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> you need at least version 1.2.1 of
<code>libnghttp2</code> installed on your system.</p>
<p>When you <code>./configure</code> your Apache httpd source tree, you need to give it
'<code>--enable-http2</code>' as additional argument to trigger the build of the module.
Should your <code>libnghttp2</code> reside in an unusual place (whatever that is on your
operating system), you may announce its location with '<code>--with-nghttp2=<path></code>'
to <code>configure</code>.</p>
<p>While that should do the trick for most, they are people who might prefer a statically
linked <code>nghttp2</code> in this module. For those, the option <code>--enable-nghttp2-staticlib-deps</code>
exists. It works quite similar to how one statically links openssl to <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.</p>
<p>Speaking of SSL, you need to be aware that most browsers will speak HTTP/2 only on <code>https:</code>
URLs, so you need a server with SSL support. But not only that, you will need a SSL library
that supports the <code>ALPN</code> extension. If OpenSSL is the library you use, you need
at least version 1.0.2.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="basic-config" id="basic-config">Basic Configuration</a></h2>
<p>When you have a <code>httpd</code> built with <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> you need some
basic configuration for it becoming active. The first thing, as with every Apache module,
is that you need to load it:</p>
<pre class="prettyprint lang-config">LoadModule http2_module modules/mod_http2.so</pre>
<p>The second directive you need to add to your server configuration is</p>
<pre class="prettyprint lang-config">Protocols h2 http/1.1</pre>
<p>This allows h2, the secure variant, to be the preferred protocol on your server
connections. When you want to enable all HTTP/2 variants, you simply write:</p>
<pre class="prettyprint lang-config">Protocols h2 h2c http/1.1</pre>
<p>Depending on where you put this directive, it affects all connections or just
the ones to a certain virtual host. You can nest it, as in:</p>
<pre class="prettyprint lang-config">Protocols http/1.1
<VirtualHost ...>
ServerName test.example.org
Protocols h2 http/1.1
</VirtualHost></pre>
<p>This allows only HTTP/1 on connections, except SSL connections to <code>test.example.org</code>
which offer HTTP/2.</p>
<div class="note"><h3>Choose a strong SSLCipherSuite</h3>
<p>The <code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code> needs to be configured with
a strong TLS cipher suite. The current version of <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> does not enforce any cipher but most
clients do so. Pointing a browser to a <code>h2</code> enabled server with a inappropriate
cipher suite will force it to simply refuse and fall back to HTTP 1.1. This is a common mistake
that is done while configuring httpd for HTTP/2 the first time, so please keep it in mind to avoid
long debugging sessions! If you want to be sure about the cipher suite to choose please avoid
the ones listed in the <a href="http://httpwg.org/specs/rfc7540.html#BadCipherSuites">HTTP/2 TLS reject list</a>.</p>
</div>
<p>The order of protocols mentioned is also relevant. By default, the first one is the
most preferred protocol. When a client offers multiple choices, the one most to the
left is selected. In</p>
<pre class="prettyprint lang-config">Protocols http/1.1 h2</pre>
<p>the most preferred protocol is HTTP/1 and it will always be selected unless a
client <em>only</em> supports h2. Since we want to talk HTTP/2 to clients that
support it, the better order is</p>
<pre class="prettyprint lang-config">Protocols h2 h2c http/1.1</pre>
<p>There is one more thing to ordering: the client has its own preferences, too. If
you want, you can configure your server to select the protocol most preferred by
the client:</p>
<pre class="prettyprint lang-config">ProtocolsHonorOrder Off</pre>
<p>makes the order <em>you</em> wrote the Protocols irrelevant and only the client's
ordering will decide.</p>
<p>A last thing: the protocols you configure are not checked for correctness
or spelling. You can mention protocols that do not exist, so there is no need
to guard <code class="directive"><a href="../mod/core.html#protocols">Protocols</a></code> with any
<code class="directive"><a href="../mod/core.html#ifmodule"><IfModule></a></code> checks.</p>
<p>For more advanced tips on configuration, see the <a href="../mod/mod_http2.html#dimensioning">
modules section about dimensioning</a> and <a href="../mod/mod_http2.html#misdirected">
how to manage multiple hosts with the same certificate</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="mpm-config" id="mpm-config">MPM Configuration</a></h2>
<p>HTTP/2 is supported in all multi-processing modules that come with httpd. However, if
you use the <code class="module"><a href="../mod/prefork.html">prefork</a></code> mpm, there will be severe restrictions.</p>
<p>In <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> will only process one request at at time
per connection. But clients, such as browsers, will send many requests at the same time.
If one of these takes long to process (or is a long polling one), the other requests will
stall.</p>
<p><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> will not work around this limit by default. The reason is that
<code class="module"><a href="../mod/prefork.html">prefork</a></code> is today only chosen, if you run processing engines that are not
prepared for multi-threading, e.g. will crash with more than one request.</p>
<p>If your setup can handle it, configuring <code class="module"><a href="../mod/event.html">event</a></code> mpm is nowadays
the best one (if supported on your platform).</p>
<p>If you are really stuck with <code class="module"><a href="../mod/prefork.html">prefork</a></code> and want multiple requests,
you can tweak the <code class="directive"><a href="../mod/mod_http2.html#h2minworkers">H2MinWorkers</a></code> to make
that possible. If it breaks, however, you own both parts.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="clients" id="clients">Clients</a></h2>
<p>Almost all modern browsers support HTTP/2, but only over SSL connections: Firefox (v43),
Chrome (v45), Safari (since v9), iOS Safari (v9), Opera (v35), Chrome for Android (v49)
and Internet Explorer (v11 on Windows10) (<a href="http://caniuse.com/#search=http2">source</a>).</p>
<p>Other clients, as well as servers, are listed
<a href="https://github.com/http2/http2-spec/wiki/Implementations">on the Implementations wiki</a>,
among them implementations for c, c++, common lisp, dart, erlang, haskell, java, nodejs, php,
python, perl, ruby, rust, scala and swift.</p>
<p>Several of the non-browser client implementations support HTTP/2 over cleartext, h2c. The
most versatile being <a href="https://curl.haxx.se">curl</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="tools" id="tools">Useful tools to debug HTTP/2</a></h2>
<p>The first tool to mention is of course <a href="https://curl.haxx.se">curl</a>. Please make sure that
your version supports HTTP/2 checking its <code>Features</code>:</p>
<pre class="prettyprint lang-config"> $ curl -V
curl 7.45.0 (x86_64-apple-darwin15.0.0) libcurl/7.45.0 OpenSSL/1.0.2d zlib/1.2.8 nghttp2/1.3.4
Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 [...]
Features: IPv6 Largefile NTLM NTLM_WB SSL libz TLS-SRP <strong>HTTP2</strong>
</pre>
<div class="note"><h3>Mac OS homebrew notes</h3>
brew install curl --with-openssl --with-nghttp2
</div>
<p>And for really deep inspection <a href="https://wiki.wireshark.org/HTTP2">wireshark</a>.</p>
<p>The <a href="https://nghttp2.org">nghttp2</a> package also includes clients, such as:</p>
<ul>
<li><a href="https://nghttp2.org/documentation/nghttp.1.html">nghttp</a> - useful to visualize the HTTP/2 frames and get a better idea of the protocol.</li>
<li><a href="https://nghttp2.org/documentation/h2load-howto.html">h2load</a> - useful to stress-test your server.</li>
</ul>
<p>Chrome offers detailed HTTP/2 logs on its connections via the
<a href="chrome://net-internals/#http2">special net-internals page</a>. There is also an
interesting extension for <a href="https://chrome.google.com/webstore/detail/http2-and-spdy-indicator/mpbpobfflnpcgagjijhmgnchggcjblin?hl=en">Chrome</a>
and <a href="https://addons.mozilla.org/en-us/firefox/addon/spdy-indicator/">Firefox</a>
to visualize when your browser is using HTTP/2.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="push" id="push">Server Push</a></h2>
<p>The HTTP/2 protocol allows the server to PUSH responses to a client it never
asked for. The tone of the conversation is: "here is a request that you
never sent and the response to it will arrive soon..."</p>
<p>But there are restrictions: the client can disable this feature and the
server may only ever PUSH on a request that came from the client.</p>
<p>The intention is to allow the server to send resources to the client that
it will most likely need: a css or javascript resource that belongs to a html
page the client requested. A set of images that is referenced by a css, etc.</p>
<p>The advantage for the client is that it saves the time to send the request which
may range from a few milliseconds to half a second, depending on where on the
globe both are located. The disadvantage is that the client may get sent
things it already has in its cache. Sure, HTTP/2 allows for the early cancellation
of such requests, but still there are resources wasted.</p>
<p>To summarize: there is no one good strategy on how to make best use of this
feature of HTTP/2 and everyone is still experimenting. So, how do you experiment
with it in Apache httpd?</p>
<p><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> inspect response header for <code>Link</code> headers
in a certain format:</p>
<pre class="prettyprint lang-config">Link </xxx.css>;rel=preload, </xxx.js>; rel=preload</pre>
<p>If the connection supports PUSH, these two resources will be sent to the
client. As a web developer, you may set these headers either directly in
your application response or you configure the server via</p>
<pre class="prettyprint lang-config"><Location /xxx.html>
Header add Link "</xxx.css>;rel=preload"
Header add Link "</xxx.js>;rel=preload"
</Location></pre>
<p>If you want to use <code>preload</code> links without triggering a PUSH, you
can use the <code>nopush</code> parameter, as in</p>
<pre class="prettyprint lang-config">Link </xxx.css>;rel=preload;nopush</pre>
<p>or you may disable PUSHes for your server entirely with the directive</p>
<pre class="prettyprint lang-config">H2Push Off</pre>
<p>And there is more:</p>
<p>The module will keep a diary of what has been PUSHed for each connection
(hashes of URLs, basically) and will not PUSH the same resource twice. When
the connection closes, this information is discarded.</p>
<p>There are people thinking about how a client can tell a server what it
already has, so PUSHes for those things can be avoided, but this is all
highly experimental right now.</p>
<p>Another experimental draft that has been implemented in <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code>
is the <a href="https://tools.ietf.org/html/draft-ruellan-http-accept-push-policy-00">
Accept-Push-Policy Header Field</a> where a client can, for each request, define
what kind of PUSHes it accepts.</p>
<p>
PUSH might not always trigger the request/response/performance that one expects or
hopes for. There are various studies on this topic to be found on the web that explain
benefits and weaknesses and how different features of client and network influence
the outcome. For example: just because the server PUSHes a resource does not mean
a browser will actually use the data.</p>
<p>The major thing that influences the response being PUSHed is the request that was
simulated. The request URL for a PUSH is given by the application, but where do the
request headers come from? For example, will the PUSH request a <code>accept-language</code>
header and if yes with what value?</p>
<p>Apache will look at the original request (the one that triggered the PUSH) and copy the
following headers over to PUSH requests: <code>user-agent</code>, <code>accept</code>,
<code>accept-encoding</code>, <code>accept-language</code>, <code>cache-control</code>.</p>
<p>All other headers are ignored. Cookies will also not be copied over. PUSHing resources
that require a cookie to be present will not work. This can be a matter of debate. But
unless this is more clearly discussed with browser, let's err on the side of caution and
not expose cookie where they might ordinarily not be visible.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="earlyhints" id="earlyhints">Early Hints</a></h2>
<p>An alternative to PUSHing resources is to send <code>Link</code> headers to the
client before the response is even ready. This uses the HTTP feature called "Early Hints" and
is described in <a href="https://tools.ietf.org/html/rfc8297">RFC 8297</a>.</p>
<p>In order to use this, you need to explicitly enable it on the server via</p>
<pre class="prettyprint lang-config">H2EarlyHints on</pre>
<p>(It is not enabled by default since some older browser tripped on such responses.)</p>
<p>If this feature is on, you can use the directive <code class="directive"><a href="../mod/mod_http2.html#h2pushresource">H2PushResource</a></code> to
trigger early hints and resource PUSHes:</p>
<pre class="prettyprint lang-config"><Location /xxx.html>
H2PushResource /xxx.css
H2PushResource /xxx.js
</Location></pre>
<p>This will send out a <code>"103 Early Hints"</code> response to a client as soon
as the server <em>starts</em> processing the request. This may be much early than
the time the first response headers have been determined, depending on your web
application.</p>
<p>If <code class="directive"><a href="../mod/mod_http2.html#h2push">H2Push</a></code> is enabled, this will also start the PUSH right after the
103 response. If <code class="directive"><a href="../mod/mod_http2.html#h2push">H2Push</a></code> is disabled however, the 103 response will be send
nevertheless to the client.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/howto/http2.html" title="English"> en </a> |
<a href="../es/howto/http2.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/http2.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/http2.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/ssi.html.en 0000664 0001751 0001751 00000063107 14737241666 020303 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache httpd Tutorial: Introduction to Server Side Includes - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Apache httpd Tutorial: Introduction to Server Side Includes</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/howto/ssi.html" title="English"> en </a> |
<a href="../es/howto/ssi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/ssi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div>
<p>Server-side includes provide a means to add dynamic content to
existing HTML documents.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#what">What are SSI?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#configuring">Configuring your server to permit SSI</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#basic">Basic SSI directives</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#additionalexamples">Additional examples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#config">What else can I config?</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exec">Executing commands</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#advanced">Advanced SSI techniques</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#conclusion">Conclusion</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="related" id="related">Introduction</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_include.html">mod_include</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_expires.html">mod_expires</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code></li><li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li><li><code class="directive"><a href="../mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li></ul></td></tr></table>
<p>This article deals with Server Side Includes, usually called
simply SSI. In this article, I'll talk about configuring your
server to permit SSI, and introduce some basic SSI techniques
for adding dynamic content to your existing HTML pages.</p>
<p>In the latter part of the article, we'll talk about some of
the somewhat more advanced things that can be done with SSI,
such as conditional statements in your SSI directives.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="what" id="what">What are SSI?</a></h2>
<p>SSI (Server Side Includes) are directives that are placed in
HTML pages, and evaluated on the server while the pages are
being served. They let you add dynamically generated content to
an existing HTML page, without having to serve the entire page
via a CGI program, or other dynamic technology.</p>
<p>For example, you might place a directive into an existing HTML
page, such as:</p>
<div class="example"><p><code>
<!--#echo var="DATE_LOCAL" -->
</code></p></div>
<p>And, when the page is served, this fragment will be evaluated and replaced with its value:</p>
<div class="example"><p><code>
Tuesday, 15-Jan-2013 19:28:54 EST
</code></p></div>
<p>The decision of when to use SSI, and when to have your page
entirely generated by some program, is usually a matter of how
much of the page is static, and how much needs to be
recalculated every time the page is served. SSI is a great way
to add small pieces of information, such as the current time - shown
above. But if a majority of your page is being generated at the time
that it is served, you need to look for some other solution.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuring" id="configuring">Configuring your server to permit SSI</a></h2>
<p>To permit SSI on your server, you must have the following
directive either in your <code>httpd.conf</code> file, or in a
<code>.htaccess</code> file:</p>
<pre class="prettyprint lang-config">Options +Includes</pre>
<p>This tells Apache that you want to permit files to be parsed
for SSI directives. Note that most configurations contain
multiple <code class="directive"><a href="../mod/core.html#options">Options</a></code> directives
that can override each other. You will probably need to apply the
<code>Options</code> to the specific directory where you want SSI
enabled in order to assure that it gets evaluated last.</p>
<p>Not just any file is parsed for SSI directives. You have to
tell Apache which files should be parsed. There are two ways to
do this. You can tell Apache to parse any file with a
particular file extension, such as <code>.shtml</code>, with
the following directives:</p>
<pre class="prettyprint lang-config">AddType text/html .shtml
AddOutputFilter INCLUDES .shtml</pre>
<p>One disadvantage to this approach is that if you wanted to
add SSI directives to an existing page, you would have to
change the name of that page, and all links to that page, in
order to give it a <code>.shtml</code> extension, so that those
directives would be executed.</p>
<p>The other method is to use the <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code> directive:</p>
<pre class="prettyprint lang-config">XBitHack on</pre>
<p><code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>
tells Apache to parse files for SSI
directives if they have the execute bit set. So, to add SSI
directives to an existing page, rather than having to change
the file name, you would just need to make the file executable
using <code>chmod</code>.</p>
<div class="example"><p><code>
chmod +x pagename.html
</code></p></div>
<p>A brief comment about what not to do. You'll occasionally
see people recommending that you just tell Apache to parse all
<code>.html</code> files for SSI, so that you don't have to
mess with <code>.shtml</code> file names. These folks have
perhaps not heard about <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>. The thing to
keep in mind is that, by doing this, you're requiring that
Apache read through every single file that it sends out to
clients, even if they don't contain any SSI directives. This
can slow things down quite a bit, and is not a good idea.</p>
<p>Of course, on Windows, there is no such thing as an execute
bit to set, so that limits your options a little.</p>
<p>In its default configuration, Apache does not send the last
modified date or content length HTTP headers on SSI pages,
because these values are difficult to calculate for dynamic
content. This can prevent your document from being cached, and
result in slower perceived client performance. There are two
ways to solve this:</p>
<ol>
<li>Use the <code>XBitHack Full</code> configuration. This
tells Apache to determine the last modified date by looking
only at the date of the originally requested file, ignoring
the modification date of any included files.</li>
<li>Use the directives provided by
<code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code> to set an explicit expiration
time on your files, thereby letting browsers and proxies
know that it is acceptable to cache them.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="basic" id="basic">Basic SSI directives</a></h2>
<p>SSI directives have the following syntax:</p>
<div class="example"><p><code>
<!--#function attribute=value attribute=value ... -->
</code></p></div>
<p>It is formatted like an HTML comment, so if you don't have
SSI correctly enabled, the browser will ignore it, but it will
still be visible in the HTML source. If you have SSI correctly
configured, the directive will be replaced with its
results.</p>
<p>The function can be one of a number of things, and we'll talk
some more about most of these in the next installment of this
series. For now, here are some examples of what you can do with
SSI</p>
<h3><a name="todaysdate" id="todaysdate">Today's date</a></h3>
<div class="example"><p><code>
<!--#echo var="DATE_LOCAL" -->
</code></p></div>
<p>The <code>echo</code> function just spits out the value of a
variable. There are a number of standard variables, which
include the whole set of environment variables that are
available to CGI programs. Also, you can define your own
variables with the <code>set</code> function.</p>
<p>If you don't like the format in which the date gets printed,
you can use the <code>config</code> function, with a
<code>timefmt</code> attribute, to modify that formatting.</p>
<div class="example"><p><code>
<!--#config timefmt="%A %B %d, %Y" --><br />
Today is <!--#echo var="DATE_LOCAL" -->
</code></p></div>
<h3><a name="lastmodified" id="lastmodified">Modification date of the file</a></h3>
<div class="example"><p><code>
This document last modified <!--#flastmod file="index.html" -->
</code></p></div>
<p>This function is also subject to <code>timefmt</code> format
configurations.</p>
<h3><a name="cgi" id="cgi">Including the results of a CGI program</a></h3>
<p>This is one of the more common uses of SSI - to output the
results of a CGI program, such as everybody's favorite, a ``hit
counter.''</p>
<div class="example"><p><code>
<!--#include virtual="/cgi-bin/counter.pl" -->
</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="additionalexamples" id="additionalexamples">Additional examples</a></h2>
<p>Following are some specific examples of things you can do in
your HTML documents with SSI.</p>
<h3><a name="docmodified" id="docmodified">When was this document
modified?</a></h3>
<p>Earlier, we mentioned that you could use SSI to inform the
user when the document was most recently modified. However, the
actual method for doing that was left somewhat in question. The
following code, placed in your HTML document, will put such a
time stamp on your page. Of course, you will have to have SSI
correctly enabled, as discussed above.</p>
<div class="example"><p><code>
<!--#config timefmt="%A %B %d, %Y" --><br />
This file last modified <!--#flastmod file="ssi.shtml" -->
</code></p></div>
<p>Of course, you will need to replace the
<code>ssi.shtml</code> with the actual name of the file that
you're referring to. This can be inconvenient if you're just
looking for a generic piece of code that you can paste into any
file, so you probably want to use the
<code>LAST_MODIFIED</code> variable instead:</p>
<div class="example"><p><code>
<!--#config timefmt="%D" --><br />
This file last modified <!--#echo var="LAST_MODIFIED" -->
</code></p></div>
<p>For more details on the <code>timefmt</code> format, go to
your favorite search site and look for <code>strftime</code>. The
syntax is the same.</p>
<h3><a name="standard-footer" id="standard-footer">Including a standard footer</a></h3>
<p>If you are managing any site that is more than a few pages,
you may find that making changes to all those pages can be a
real pain, particularly if you are trying to maintain some kind
of standard look across all those pages.</p>
<p>Using an include file for a header and/or a footer can
reduce the burden of these updates. You just have to make one
footer file, and then include it into each page with the
<code>include</code> SSI command. The <code>include</code>
function can determine what file to include with either the
<code>file</code> attribute, or the <code>virtual</code>
attribute. The <code>file</code> attribute is a file path,
<em>relative to the current directory</em>. That means that it
cannot be an absolute file path (starting with /), nor can it
contain ../ as part of that path. The <code>virtual</code>
attribute is probably more useful, and should specify a URL
relative to the document being served. It can start with a /,
but must be on the same server as the file being served.</p>
<div class="example"><p><code>
<!--#include virtual="/footer.html" -->
</code></p></div>
<p>I'll frequently combine the last two things, putting a
<code>LAST_MODIFIED</code> directive inside a footer file to be
included. SSI directives can be contained in the included file,
and includes can be nested - that is, the included file can
include another file, and so on.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="config" id="config">What else can I config?</a></h2>
<p>In addition to being able to <code>config</code> the time
format, you can also <code>config</code> two other things.</p>
<p>Usually, when something goes wrong with your SSI directive,
you get the message</p>
<div class="example"><p><code>
[an error occurred while processing this directive]
</code></p></div>
<p>If you want to change that message to something else, you
can do so with the <code>errmsg</code> attribute to the
<code>config</code> function:</p>
<div class="example"><p><code>
<!--#config errmsg="[It appears that you don't know how to use SSI]" -->
</code></p></div>
<p>Hopefully, end users will never see this message, because
you will have resolved all the problems with your SSI
directives before your site goes live. (Right?)</p>
<p>And you can <code>config</code> the format in which file
sizes are returned with the <code>sizefmt</code> attribute. You
can specify <code>bytes</code> for a full count in bytes, or
<code>abbrev</code> for an abbreviated number in Kb or Mb, as
appropriate.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exec" id="exec">Executing commands</a></h2>
<p>Here's something else that you can do with the <code>exec</code>
function. You can actually have SSI execute a command using the
shell (<code>/bin/sh</code>, to be precise - or the DOS shell,
if you're on Win32). The following, for example, will give you
a directory listing.</p>
<div class="example"><p><code>
<pre><br />
<!--#exec cmd="ls" --><br />
</pre>
</code></p></div>
<p>or, on Windows</p>
<div class="example"><p><code>
<pre><br />
<!--#exec cmd="dir" --><br />
</pre>
</code></p></div>
<p>You might notice some strange formatting with this directive
on Windows, because the output from <code>dir</code> contains
the string ``<<code>dir</code>>'' in it, which confuses
browsers.</p>
<p>Note that this feature is exceedingly dangerous, as it will
execute whatever code happens to be embedded in the
<code>exec</code> tag. If you have any situation where users
can edit content on your web pages, such as with a
``guestbook'', for example, make sure that you have this
feature disabled. You can allow SSI, but not the
<code>exec</code> feature, with the <code>IncludesNOEXEC</code>
argument to the <code>Options</code> directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="advanced" id="advanced">Advanced SSI techniques</a></h2>
<p>In addition to spitting out content, Apache SSI gives you
the option of setting variables, and using those variables in
comparisons and conditionals.</p>
<h3><a name="variables" id="variables">Setting variables</a></h3>
<p>Using the <code>set</code> directive, you can set variables
for later use. We'll need this later in the discussion, so
we'll talk about it here. The syntax of this is as follows:</p>
<div class="example"><p><code>
<!--#set var="name" value="Rich" -->
</code></p></div>
<p>In addition to merely setting values literally like that, you
can use any other variable, including <a href="../env.html">environment variables</a> or the variables
discussed above (like <code>LAST_MODIFIED</code>, for example) to
give values to your variables. You will specify that something is
a variable, rather than a literal string, by using the dollar sign
($) before the name of the variable.</p>
<div class="example"><p><code> <!--#set var="modified" value="$LAST_MODIFIED" -->
</code></p></div>
<p>To put a literal dollar sign into the value of your
variable, you need to escape the dollar sign with a
backslash.</p>
<div class="example"><p><code>
<!--#set var="cost" value="\$100" -->
</code></p></div>
<p>Finally, if you want to put a variable in the midst of a
longer string, and there's a chance that the name of the
variable will run up against some other characters, and thus be
confused with those characters, you can place the name of the
variable in braces, to remove this confusion. (It's hard to
come up with a really good example of this, but hopefully
you'll get the point.)</p>
<div class="example"><p><code>
<!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" -->
</code></p></div>
<h3><a name="conditional" id="conditional">Conditional expressions</a></h3>
<p>Now that we have variables, and are able to set and compare
their values, we can use them to express conditionals. This
lets SSI be a tiny programming language of sorts.
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> provides an <code>if</code>,
<code>elif</code>, <code>else</code>, <code>endif</code>
structure for building conditional statements. This allows you
to effectively generate multiple logical pages out of one
actual page.</p>
<p>The structure of this conditional construct is:</p>
<div class="example"><p><code>
<!--#if expr="test_condition" --><br />
<!--#elif expr="test_condition" --><br />
<!--#else --><br />
<!--#endif -->
</code></p></div>
<p>A <em>test_condition</em> can be any sort of logical
comparison - either comparing values to one another, or testing
the ``truth'' of a particular value. (A given string is true if
it is nonempty.) For a full list of the comparison operators
available to you, see the <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>
documentation.</p>
<p>For example, if you wish to customize the text on your web page
based on the time of day, you could use the following recipe, placed
in the HTML page:</p>
<div class="example"><p><code>
Good
<!--#if expr="%{TIME_HOUR} <12" --><br />
morning!<br />
<!--#else --><br />
afternoon!<br />
<!--#endif --><br />
</code></p></div>
<p>Any other variable (either ones that you define, or normal
environment variables) can be used in conditional statements.
See <a href="../expr.html">Expressions in Apache HTTP Server</a> for
more information on the expression evaluation engine.</p>
<p>With Apache's ability to set environment variables with the
<code>SetEnvIf</code> directives, and other related directives,
this functionality can let you do a wide variety of dynamic content
on the server side without resorting a full web application.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="conclusion" id="conclusion">Conclusion</a></h2>
<p>SSI is certainly not a replacement for CGI, or other
technologies used for generating dynamic web pages. But it is a
great way to add small amounts of dynamic content to pages,
without doing a lot of extra work.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/howto/ssi.html" title="English"> en </a> |
<a href="../es/howto/ssi.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/howto/ssi.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ja/howto/ssi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/howto/ssi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/ssi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/howto/access.html 0000664 0001751 0001751 00000000441 13710016232 020310 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: access.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: access.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: access.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/howto/http2.html 0000664 0001751 0001751 00000000436 13710016232 020114 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: http2.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: http2.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: http2.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/howto/ssi.html 0000664 0001751 0001751 00000000701 13710016232 017644 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: ssi.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: ssi.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: ssi.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: ssi.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: ssi.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
httpd-2.4.64/docs/manual/howto/htaccess.html 0000664 0001751 0001751 00000001070 13710016232 020643 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: htaccess.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: htaccess.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: htaccess.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: htaccess.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: htaccess.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: htaccess.html.pt-br
Content-Language: pt-br
Content-type: text/html; charset=ISO-8859-1
httpd-2.4.64/docs/manual/howto/reverse_proxy.html 0000664 0001751 0001751 00000000331 13710016232 021761 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: reverse_proxy.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: reverse_proxy.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/expr.html 0000664 0001751 0001751 00000000307 13710016232 016666 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: expr.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: expr.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/dso.html.ja.utf8 0000664 0001751 0001751 00000056436 14743132254 020003 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>動的共有オブジェクト (DSO) サポート - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>動的共有オブジェクト (DSO) サポート</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dso.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dso.html" title="Japanese"> ja </a> |
<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>Apache HTTP サーバはモジュール化されたプログラムで、
管理者がモジュールを選択することでサーバに組み込む機能を選ぶことができます。
モジュールはサーバがビルドされるときに <code class="program"><a href="./programs/httpd.html">httpd</a></code> バイナリに
静的に組み込むことができます。もしくは、<code class="program"><a href="./programs/httpd.html">httpd</a></code> バイナリとは
別に存在する動的共有オブジェクト (訳注: Dynamic Shared Object)
(DSO) としてコンパイルすることも
できます。DSO モジュールはサーバがビルドされるときにコンパイルしたり、
Apache 拡張ツール (<code class="program"><a href="./programs/apxs.html">apxs</a></code>) を
使って後でコンパイルして追加したりできます。</p>
<p>この文書は DSO モジュールの使い方と、仕組みについて
説明します。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#implementation">実装</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#usage">使用法の概要</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#background">背景</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#advantages">利点と欠点</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="implementation" id="implementation">実装</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>個々の Apache モジュールをロードするための DSO サポートは
<code class="module"><a href="./mod/mod_so.c.html">mod_so.c</a></code> というモジュールの機能に基づいています。
このモジュール は Apache のコアに静的に組み込まれている必要があります。
それは <code class="module"><a href="./mod/core.c.html">core.c</a></code> 以外では DSO にできない唯一の
モジュールです。事実上、他のすべての Apache のモジュールは、
<a href="install.html">インストールの文書</a>で説明されているように、
<code class="program"><a href="./programs/configure.html">configure</a></code> の
<code>--enable-<em>module</em>=shared</code> オプションでそれぞれを
DSO ビルドにすることにより、DSO モジュールにすることができます。
<code>mod_foo.so</code> のような DSO にモジュールがコンパイルされれば、
<code>httpd.conf</code> ファイル中で <code class="module"><a href="./mod/mod_so.html">mod_so</a></code> の
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
ディレクティブを使うことでサーバの起動や再起動時にこのモジュールを
ロードするようにできます。</p>
<p>Apache モジュール用の (特にサードパーティモジュールの) DSO ファイルの
作成を簡単にするために、<code class="program"><a href="./programs/apxs.html">apxs</a></code>
(<dfn>APache eXtenSion</dfn>) という新しいサポートプログラムがあります。
Apache のソースツリーの<em>外で</em> DSO モジュールをビルドするために
使うことができます。発想は単純です: Apache のインストール時の
<code class="program"><a href="./programs/configure.html">configure</a></code>、<code>make install</code> のときに Apache の
C ヘッダをインストールし、DSO ビルド用のプラットフォーム依存の
コンパイラとリンカのフラグを <code class="program"><a href="./programs/apxs.html">apxs</a></code> プログラムに追加します。
これにより、ユーザが Apache の配布ソースツリーなしで、さらに
DSO サポートのためのプラットフォーム依存のコンパイラやリンカの
フラグをいじることなく Apache のモジュールのソースをコンパイル
できるようになります。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="usage" id="usage">使用法の概要</a></h2>
<p>Apache 2.x の DSO 機能の概略を知ることができるための、
短く簡潔な概要です:</p>
<ol>
<li>
<em>配布されている</em> Apache モジュール、仮に <code>mod_foo.c</code>
として、それを DSO <code>mod_foo.so</code> にビルド、インストール:
<div class="example"><p><code>
$ ./configure --prefix=/path/to/install --enable-foo=shared<br />
$ make install
</code></p></div>
</li>
<li>
<em>サードパーティ</em> Apache モジュール、仮に <code>mod_foo.c</code>
として、それを DSO <code>mod_foo.so</code> にビルド、インストール:
<div class="example"><p><code>
$ ./configure --add-module=<var>module_type</var>:/path/to/3rdparty/mod_foo.c \<br />
<span class="indent">
--enable-foo=shared<br />
</span>
$ make install
</code></p></div>
</li>
<li>
共有モジュールの <em>後々のインストール</em> のために
Apache を設定:
<div class="example"><p><code>
$ ./configure --enable-so<br />
$ make install
</code></p></div>
</li>
<li>
<em>サードパーティ</em> Apache モジュール、仮に <code>mod_foo.c</code>
として、それを <code class="program"><a href="./programs/apxs.html">apxs</a></code> を使って
Apache ソースツリーの<em>外で</em> DSO にビルド、インストール:
<div class="example"><p><code>
$ cd /path/to/3rdparty<br />
$ apxs -c mod_foo.c<br />
$ apxs -i -a -n foo mod_foo.la
</code></p></div>
</li>
</ol>
<p>どの場合においても、共有モジュールをコンパイルした後で、
<code>httpd.conf</code> で
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
ディレクティブを使って Apache がモジュールを使用するように
しなければなりません。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="background" id="background">背景</a></h2>
<p>最近の Unix 系の OS には <em>動的共有オブジェクト</em> (DSO)
の動的リンク/ロードという気のきいた機構が
存在します。これは、実行時にプログラムのアドレス空間に
ロードできるような特別な形式でプログラムをビルドすることを
可能にします。</p>
<p>このロードは二つの方法で行なうことができます: 実行プログラムが
起動されたときに <code>ld.so</code> というシステムプログラム
により自動的に行なわれる方法と、実行プログラム中から、システムコール
<code>dlopen()/dlsym()</code> による Unix ローダへの
プログラムシステムのインタフェースを使って手動で行なう方法とが
あります。</p>
<p>最初の方法では DSO は普通は<em>共有ライブラリ</em>や <em>DSO
ライブラリ</em> と呼ばれていて、DSO の名前は
<code>libfoo.so</code> や <code>libfoo.so.1.2</code> のようになっています。
これらはシステムディレクトリ (通常 <code>/usr/lib</code>) に存在し、
実行プログラムへのリンクはビルド時に <code>-lfoo</code> をリンカに
指定することで確立されます。これによりライブラリへの参照が実行プログラムの
ファイルに書き込まれて、起動時に Unix のローダが <code>/usr/lib</code> や、
リンカの <code>-R</code> のようなオプションによりハードコードされたパス、
環境変数 <code>LD_LIBRARY_PATH</code> により設定されたパス、の中から
<code>libfoo.so</code> の場所を見つけることができます。それから、
実行プログラム中の (まだ未解決の) シンボルを DSO にあるシンボルで
解決します。</p>
<p>普通は実行プログラム中のシンボルは DSO からは参照されません
(DSO は一般的なコードによる再利用可能なライブラリですので)。
ですから、さらなるシンボルの解決は必要ありません。
シンボルは Unix ローダにより完全な解決が行なわれますので、実行ファイル自身は
何もする必要がありません。(実際のところ、静的でない方法でリンクされている
すべての実行プログラムに組み込まれている開始用のコードの一部に
<code>ld.so</code> を起動するコードが含まれています)。よく使われる
ライブラリの動的ロードの利点は明らかです。ライブラリのコードは
システムライブラリに <code>libc.so</code> のようにして一度保存するだけでよく、
プログラムのために必要なディスクの領域を節約することができます。</p>
<p>二つめの方法では DSO は普通は<em>共有オブジェクト</em>や
<em>DSO ファイル</em>と呼ばれていて、任意の拡張子を付けることができます
(ただし、標準的な名前は <code>foo.so</code> です)。
これらのファイルは通常はプログラム専用のディレクトリに置かれ、
これらを使う実行プログラムへのリンクは自動的にはされません。
ですので、実行プログラムは <code>dlopen()</code> を使って
実行時に手動で DSO をプログラムのアドレス空間にロードする必要があります。
この時点では実行プログラムに対して DSO のシンボルの解決は行なわれません。
しかし、その代わりに Unix のローダが DSO の (まだ未解決の) シンボルを
実行プログラムによりエクスポートされたシンボルと既にロードされた
DSO ライブラリによりエクスポートされたシンボル (特に、どこにでもある
<code>libc.so</code> のすべてのシンボル) で自動的に解決します。
こうすることで、DSO は最初から静的にリンクされていたかのように、
実行プログラムのシンボルを知ることができます。</p>
<p>最後に、DSO の API を利点を生かすために、プログラムは
後でディスパッチテーブル<em>など</em>でシンボルを使うことができるように、
<code>dlsym()</code> を使っていくつかのシンボルを解決します。
すなわち: 実行プログラムは必要なすべてのシンボルを手動で解決しなければ
なりません。この機構の利点はプログラムのオプショナルな部分は
必要になるまでロードする必要がない (だからメモリも消費しない)
ことです。必要ならば、基本プログラムの機能を拡張するために
これらの部分を動的にロードすることができます。</p>
<p>この DSO 機構は簡単なように見えますが、少なくとも一つ難しい点が
あります: プログラムを拡張するために DSO を使っているときに、
DSO が実行プログラムからシンボルを解決する点です (二番目の方法)。
これはなぜでしょうか。それは、DSO のシンボルを実行プログラムの
シンボルから「逆解決」するというのはライブラリの設計
(ライブラリはそれを使用するプログラムのことは何も
知らない) に反していて、この機能はすべてのプラットフォームに
あるわけではなく、標準化もされていないからです。
実際には実行プログラムのグローバルなシンボルは再エクスポートされることは
あまりなく、DSO から使うことができません。リンカにグローバルシンボルすべてを
エクスポートするようにさせる方法を見つけることが、実行時にプログラムを
拡張するために DSO を使うときの一番の問題です。</p>
<p>共有ライブラリのアプローチが普通の方法です。DSO 機構はそのために
設計されたものですから。したがって、その方法はオペレーティングシステムが
提供するほとんどすべての種類のライブラリで使われています。
一方、プログラムの拡張のために共有オブジェクトを使用する、という方は
あまり使われていません。</p>
<p>1998 年の時点で、実行時に実際に機能拡張のために DSO 機構を使っている
ソフトウェアパッケージは少しだけでした: Perl 5 (XS 機構と DnaLoader モジュール
によるもの)、Netscape サーバ<em>など</em>です。Apache はすでに
モジュールの概念を使って機能拡張をしていて、内部的にディスパッチリストに
基づいた外部モジュールの Apache コア機能へのリンクを行なっていましたので、
バージョン 1.3 から、Apache も DSO 機構を使う仲間になりました。
Apache は実行時に DSO を使ってモジュールをロードするようにすでに
運命付けられていたのです。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="advantages" id="advantages">利点と欠点</a></h2>
<p>上記の DSO に基づいた機能は以下の利点があります:</p>
<ul>
<li>実際のサーバプロセスを組み立てるために、
ビルド時に <code>configure</code> のオプションを使う代わりに
実行時に <code>httpd.conf</code> の設定用コマンド
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
を使うことができますので、サーバパッケージの柔軟性が高まりました。
たとえば、一つの Apache のインストールから
違う構成のサーバ (標準版と SSL 版、最小構成と拡張版 [mod_perl, PHP3]
<em>など</em>) を実行することができます。</li>
<li>インストールの後であっても、サーバのパッケージをサードパーティ
モジュールで簡単に拡張できるようになりました。これは、Apache コア
パッケージと、PHP3, mod_perl, mod_fastcgi <em>など</em> の追加の
パッケージを作成できるので、少なくともベンダのパッケージ管理者にとって
大きな利点があります。</li>
<li>Apache モジュールの開発が簡単になります。
これは DSO と <code class="program"><a href="./programs/apxs.html">apxs</a></code> の組み合わせにより、Apache ソースツリーの
外で作業でき、開発中のモジュールの新しいバージョンを
実行中の Apache サーバに組み込むために <code>apxs -i</code> と
<code>apachectl restart</code> を行なうだけで良くなるからです。</li>
</ul>
<p>DSO には以下の欠点があります:</p>
<ul>
<li>すべてのオペレーティングシステムがプログラムのアドレス空間に
コードを動的ロードすることをサポートしているわではないので、
プラットフォームによっては DSO 機構は使えません。</li>
<li>Unix のローダがシンボルの解決をする必要ができたので、
そのオーバヘッドによりサーバの起動時間が約 20% 遅くなっています。</li>
<li>位置非依存コード (PIC) (訳注 position independent code) は
相対アドレスのために複雑なアセンブラのトリックが必要なことがあり、
それは必ずしも絶対アドレスと同じくらいの速度がでるわけではありませんので、
プラットフォームによってはサーバの実行速度が約 5% 遅くなります。</li>
<li>DSO モジュールはすべてのプラットフォームで他の DSO に基づいた
ライブラリに対してリンクできる (<code>ld -lfoo</code>)
というわけではありませんので (たとえば、a.out のプラットフォームでは
この機能はありませんが、ELF のプラットフォームにはあります)、
すべての種類のモジュールに DSO 機構を使えるわけではありません。
言い換えると、DSO ファイルとしてコンパイルされたモジュールの
使えるシンボルは、
Apache のコアのシンボル、C ライブラリ (<code>libc</code>) と
Apache コアが使っている他のすべての静的なライブラリと動的ライブラリの
シンボル、PIC による静的なライブラリ (<code>libfoo.a</code>) の
シンボルのみに制限されます。その他のコードを使う方法は、
Apache コア自身がすでにそのコードへの参照があるようにするか、
<code>dlopen ()</code> を使ってコードを自分自身でロードするかの
どちらかしかありません。</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dso.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dso.html" title="Japanese"> ja </a> |
<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/dso.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/dns-caveats.html.tr.utf8 0000664 0001751 0001751 00000031454 14743132254 021452 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Sunucusu ve DNS ile ilgili Konular - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache HTTP Sunucusu ve DNS ile ilgili Konular</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/dns-caveats.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dns-caveats.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dns-caveats.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dns-caveats.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu sayfanın konusu şöyle özetlenebilirdi: Yapılandırma dosyalarınızda
DNS sorguları yapılmasını gerektirecek ayarlamalardan kaçınınız. Eğer
yapılandırma dosyalarınızda DNS sorgusu yapılarak çözümlenebilecek
adresler bulunursa sunucunuz beklenmedik davranışlar (hiç
başlamayabilir) gösterebileceği gibi hizmet reddi veya hizmet
hırsızlığı (bazı sanal konakların diğerlerine giden sayfaları çalma
olasılığı dahil) saldırılarına açık hale gelebilir.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#example">Basit Bir Örnek</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#denial">Hizmet Reddi</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#main">"Ana Sunucu" Adresi</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#tips">Bu Sorunlardan Kaçınmak için İpuçları</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="example" id="example">Basit Bir Örnek</a></h2>
<pre class="prettyprint lang-config"># Bu yetersiz bir yapılandırma örneğidir, sunucunuzda kullanmayın.
<VirtualHost falan.fesmekan.dom>
ServerAdmin filanca@fesmekan.dom
DocumentRoot "/siteler/fesmekan"
</VirtualHost></pre>
<p>httpd’nin beklendiği gibi işlemesi için her sanal konak için iki
veriye mutlaka ihtiyacı vardır: <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> ve sunucunun bağlantı kabul edip hizmet
sunacağı en az bir IP adresi. Yukarıdaki örnekte IP adresi
bulunmamaktadır, dolayısıyla Apache, <code>falan.fesmekan.dom</code>
adresi için bir DNS sorgusu yapmak zorundadır. Eğer sunucu,
yapılandırma dosyasını çözümlediği sırada bir sebeple DNS sunucusuna
erişemezse bu sanal konak <em>yapılandırılmayacak</em> ve bu sanal konağa
yapılan isteklere yanıt verilemeyecektir.</p>
<p><code>falan.fesmekan.dom</code>’un 192.168.2.1 IP adresine sahip
olduğunu varsayarsak yapılandırma şöyle olurdu:</p>
<pre class="prettyprint lang-config"># Bu yetersiz bir yapılandırma örneğidir, sunucunuzda kullanmayın.
<VirtualHost 192.168.2.1>
ServerAdmin filanca@fesmekan.dom
DocumentRoot "/siteler/fesmekan"
</VirtualHost></pre>
<p>Ancak, bu sefer de bu sanal konağın sunucu ismini öğrenmek için
httpd’nin bir ters DNS sorgusu yapması gerekecektir. Eğer bu sorgu
başarısız olursa kısmi bir yapılandırmaya gidilir.
Eğer sanal konak isme dayalı ise sanal konak
kısmen bile yapılandırılmaz. IP’ye dayalı sanal konaklar büyük oranda
çalışır, fakat (örneğin, bir Redirect varlığında olduğu gibi) sunucu ismini
içeren tam bir adres üretilmesini gerektiren bir durumda, sunucu geçerli
bir adres üretemez.</p>
<p>Her iki sorunu da çözen yapılandırma şöyle olurdu:</p>
<pre class="prettyprint lang-config"><VirtualHost 192.168.2.1>
ServerName falan.fesmekan.dom
ServerAdmin filanca@fesmekan.dom
DocumentRoot "/siteler/fesmekan"
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="denial" id="denial">Hizmet Reddi</a></h2>
<p>Şöyle bir yapılandırmanız olsun:</p>
<pre class="prettyprint lang-config"><VirtualHost falan.fesmekan.dom>
ServerAdmin filanca@fesmekan.dom
DocumentRoot "/siteler/fesmekan"
</VirtualHost>
<VirtualHost misal.mesela.dom>
ServerAdmin falanca@mesela.dom
DocumentRoot "/siteler/mesela"
</VirtualHost></pre>
<p><code>falan.fesmekan.dom</code>’a 192.168.2.1,
<code>misal.mesela.dom</code>’a 192.168.2.2 atadığınızı fakat,
<code>mesela.dom</code>’un DNS kaydının sizin denetiminizde olmadığını
varsayalım. Bu yapılandırmayla, <code>mesela.dom</code>’u
<code>fesmekan.dom</code>’a giden tüm trafiği çalabilecek duruma
getirirsiniz. Bunu gerçekleştirmek için DNS kaydında
<code>misal.mesela.dom</code>’a 192.168.2.1 adresinin atanması
yeterlidir. Kendi DNS’lerine sahip olduklarından dolayı
<code>misal.mesela.dom</code>’a istedikleri IP adresini atamaktan
onları alıkoyamazsınız.</p>
<p>192.168.2.1’e gelen isteklerin hepsine
(<code>http://falan.fesmekan.dom/biryer</code> şeklinde yazılan
adresler dahil) <code>mesela.dom</code> sanal konağınca hizmet
sunulacaktır. Apache’nin gelen istekleri sunduğu sanal konaklarla nasıl
eşleştirdiğini bilirseniz bunun sebebini kolayca anlarsınız. Bunu
kabataslak açıklayan <a href="vhosts/details.html">bir belgemiz
mevcuttur</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="main" id="main">"Ana Sunucu" Adresi</a></h2>
<p><a href="vhosts/name-based.html">İsme dayalı sanal konak
desteği</a>, httpd’nin çalıştığı makinenin IP adres(ler)ini de bilmesini
gerektirir. Bu adresi elde etmek için sunucu, ya sunucu genelinde geçerli
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> yönergesine bakar ya da bir
C işlevi olan <code>gethostname</code>’i kullanır (işlev, komut
isteminden <code>hostname</code> komutuna dönen yanıtın aynısını
döndürür) ve ardından bu adresle ilgili olarak bir DNS sorgusu yapar.
Bu sorgudan kaçınmanın henüz bir yolu yoktur.</p>
<p>Eğer bu sorgunun (DNS sunucusunun çökmüş olması gibi bir nedenle)
başarısız olabileceğinden korkuyorsanız, makine ismini ve IP adresini
<code>/etc/hosts</code> dosyanıza yazabilirsiniz (Makinenizin düzgün
olarak açılabilmesi için zaten bu kaydı yapmış olmanız gerekir).
Kullandığınız işletim sistemine bağlı olarak bu kaydın
<code>/etc/resolv.conf</code> veya <code>/etc/nsswitch.conf</code>
dosyasında bulunması gerekebilir.</p>
<p>Herhangi bir nedenle sunucunuz bir DNS sorgusu yapmıyorsa veya
yapmamalıysa, httpd’yi <code>HOSTRESORDER</code> ortam değişkenine
"<code>local</code>" değerini atadıktan sonra çalıştırabilirsiniz. Bu
tamamen işletim sistemine ve kullandığınız çözümleyici kütüphanelere
bağlıdır. Ayrıca, ortamı denetlemek için <code class="module"><a href="./mod/mod_env.html">mod_env</a></code>
kullanmıyorsanız, CGI’ler de bundan etkilenir. En iyisi işletim
sisteminizin SSS belgelerini ve kılavuz sayfalarını okumaktır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="tips" id="tips">Bu Sorunlardan Kaçınmak için İpuçları</a></h2>
<ul>
<li><code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> yönergelerinizde
IP adresleri kullanınız.</li>
<li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergelerinizde
IP adresleri kullanınız.</li>
<li>Tüm sanal konakların ayrı birer <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> yönergesi olsun.</li>
<li>Hiçbir sayfa sunulmayan bir <code><VirtualHost
_default_:*></code> sanal konağınız olsun.</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/dns-caveats.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dns-caveats.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dns-caveats.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dns-caveats.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/dns-caveats.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/env.html.ko.euc-kr 0000664 0001751 0001751 00000054221 14743132254 020313 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ġ ȯ溯 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>ġ ȯ溯</h1>
<div class="toplang">
<p><span> : </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/env.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/env.html" title="Korean"> ko </a> |
<a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>ġ <em>ȯ溯(environment variable)</em>
ִ. Ͽ α׳
۾ Ѵ. , ȯ溯 CGI ũƮ
ܺ α ϴ ȴ. ȯ溯
ٷ ϴ پ Ѵ.</p>
<p> <em>ȯ溯</em> θ, ü
ϴ ȯ溯 ٸ. ġ ο ǰ
ȴ. ȯ溯 CGI ũƮ Server Side Include
ũƮ Ѱ ü ȯ溯 ȴ.
ϴ ü ȯ ϰ ʹٸ ü
ȯ ؾ Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#setting">ȯ溯 ϱ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">ȯ溯 ϱ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#special">Ư ȯ溯</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples"></a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="setting" id="setting">ȯ溯 ϱ</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr></table>
<h3><a name="basic-manipulation" id="basic-manipulation">⺻ ȯ漳</a></h3>
<p>ġ ȯ溯 ϴ ⺻
<code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> þ ϴ ̴. <code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> þ Ͽ
ȯ溯 ִ.</p>
<h3><a name="conditional" id="conditional">û Ǻ </a></h3>
<p> ϰ, mod_setenvif ϴ þ û
û Ư¡ ȯ溯 Ѵ. , Ư
(User-Agent) ûϰų Ư Referer (
Ʋ ʾҴ) ִ 쿡
ִ. mod_rewrite ִ <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
<code>[E=...]</code> ɼ Ͽ ϰ ȯ溯
ִ.</p>
<h3><a name="unique-identifiers" id="unique-identifiers"> ĺ</a></h3>
<p> mod_unique_id û 쿡
"" û߿ Ȯ (ġ)
<code>UNIQUE_ID</code> ȯ溯 Ѵ.</p>
<h3><a name="standard-cgi" id="standard-cgi">ǥ CGI </a></h3>
<p>CGI ũƮ SSI ġ Ͽų
ȯ溯 ܿ ߰ <a href="http://cgi-spec.golux.com/">CGI Ծ</a>
û ˷ִ ȯ溯 ´.</p>
<h3><a name="caveats" id="caveats"> </a></h3>
<ul>
<li>ȯ漳 þ Ͽ ǥ CGI ϰų
.</li>
<li><a href="suexec.html">suexec</a> CGI ũƮ
ϴ , ϱ CGI ũƮ ȯ
<em></em> 鸸 ûҵȴ.
<em></em> Ͻ
<code>suexec.c</code> ǵȴ.</li>
<li> ȯ溯 ̸ , ,
ٹڸ ϴ . , ù° ڷ
ڸ ʴ . CGI ũƮ SSI
Ѿ ̿ ڴ ٷ üȴ.</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="using" id="using">ȯ溯 ϱ</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</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_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authz_host.html#allow">Allow</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_authz_host.html#deny">Deny</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr></table>
<h3><a name="cgi-scripts" id="cgi-scripts">CGI ũƮ</a></h3>
<p>ȯ溯 ֵ 뵵 ϳ CGI ũƮ
ȯϴ ̴. տ ߵ ġ
ܿ û ǥ CGI ũƮ
Ѿ. ڼ <a href="howto/cgi.html">CGI
丮</a> ϶.</p>
<h3><a name="ssi-pages" id="ssi-pages">SSI </a></h3>
<p>mod_include <code>INCLUDES</code> Ͱ óϴ
Ľ (SSI) <code>echo</code> Ҹ Ͽ
ȯ溯 ְ, ȯ溯 Ͽ û
Ư¡ 帧 ҷ Ϻθ
ִ. ġ SSI ǥ CGI
ȯ溯 Ѵ. ڼ <a href="howto/ssi.html">SSI 丮</a> ϶.</p>
<h3><a name="access-control" id="access-control"></a></h3>
<p><code>allow from env=</code> <code>deny from env=</code>
þ Ͽ ȯ溯
ִ. <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> ϸ
Ŭ̾Ʈ Ư¡ Ӱ
ִ. , Ư (User-Agent)
ź ִ.</p>
<h3><a name="logging" id="logging">Ǻ α</a></h3>
<p><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
<code>%e</code> ɼ Ͽ ȯ溯 α
ִ. , <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> þ
Ǻ ϸ ȯ溯 Ȳ û
α θ ִ. <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> Ͽ
û α Ӱ ִ. ,
ϸ <code>gif</code> û α ʰų,
ܺ Ʈ ִ Ŭ̾Ʈ û α ִ.</p>
<h3><a name="response-headers" id="response-headers">Ǻ </a></h3>
<p><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>
þ Ŭ̾Ʈ ȯ溯
HTTP ִ.
, Ŭ̾Ʈ û Ư ִ 쿡
ִ.</p>
<h3><a name="external-filter" id="external-filter">ܺ ϱ</a></h3>
<p><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> <code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code>
þ ܺ <code>disableenv=</code>
<code>enableenv=</code> ɼ Ͽ ȯ溯
ִ.</p>
<h3><a name="url-rewriting" id="url-rewriting">URL ۼ(Rewriting)</a></h3>
<p><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
<em>TestString</em> <code>%{ENV:...}</code>
ϸ mod_rewrite ۼ ȯ溯
ٸ ൿѴ. mod_rewrite տ <code>ENV:</code>
ʰ ϴ ȯ溯 ƴ ϶.
ٸ mod_rewrite
.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="special" id="special">Ư ȯ溯</a></h2>
<p>Ŭ̾Ʈ Ȱ ϱ ġ Ư
Ŭ̾Ʈ ڽ ൿ Ѵ. <code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>
ȯ溯 Ͽ ̷ ذѴ. <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> <code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code>ε ϴ.</p>
<h3><a name="downgrade" id="downgrade">downgrade-1.0</a></h3>
<p>û ϴ HTTP/1.0 û
óѴ.</p>
<h3><a name="force-gzip" id="force-gzip">force-gzip</a></h3>
<p><code>DEFLATE</code> Ҷ ȯ溯
accept-encoding ϰ
.</p>
<h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3>
<p> Ŭ̾Ʈ
<code>Vary</code> ʵ带 . Ŭ̾Ʈ
ʵ带 ؼ Ѵ. ̷
ذѴ. ,
<strong>force-response-1.0</strong> Ѵ.</p>
<h3><a name="force-response" id="force-response">force-response-1.0</a></h3>
<p>HTTP/1.0 û ϴ Ŭ̾Ʈ HTTP/1.0
Ѵ. AOL Ͻÿ ־ .
HTTP/1.0 Ŭ̾Ʈ HTTP/1.1
Ƿ, ذϱ Ѵ.</p>
<h3><a name="gzip-only-text-html" id="gzip-only-text-html">gzip-only-text/html</a></h3>
<p> "1"̸ <code>text/html</code> ƴ content-type
<code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> DEFLATE
ʴ´. (gzip Ӹ ƴ϶ "identity" ƴ
ڵ) 쿡
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> Ѵ.</p>
<h3><a name="no-gzip" id="no-gzip">no-gzip</a></h3>
<p> ɼ ϸ <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>
<code>DEFLATE</code> ʰ,
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> ڵ ڿ
ʴ´.</p>
<h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
<p><code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code>
Ѵ.</p>
<h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3>
<p> <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> ൿ
ģ. (<code>en</code>, <code>ja</code>,
<code>x-klingon</code> ) ± ִٸ,
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>
õѴ. ٸ Ϲ <a href="content-negotiation.html"></a> Ѵ.</p>
<h3><a name="redirect-carefully" id="redirect-carefully">redirect-carefully</a></h3>
<p> Ŭ̾Ʈ ̷ .
̷ óϴµ ִ Ŭ̾Ʈ
Ѵ. Microsoft WebFolders Ʈ
DAV 带 丮 ڿ ̷ óϴµ
־ .</p>
<h3><a name="suppress-error-charset" id="suppress-error-charset">suppress-error-charset</a></h3>
<p><em>2.0.40 ִ</em></p>
<p>ġ Ŭ̾Ʈ û ̷
Ŭ̾Ʈ ڵ ̷ ϴ(Ȥ
ʴ) 쿡 Ͽ 信 ڿ Ѵ.
ġ ġ ϴ ISO-8859-1
ǥѴ.</p>
<p> ̷ǵ ٸ
̻ ƴ϶ ̷
Ϸ Ѵ. ,
̻ϰ ִ.</p>
<p> ȯ溯 ġ ̷
ʵ Ͽ, ̷
ùٷ ϰ .</p>
</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="misbehaving" id="misbehaving">߸ ϴ Ŭ̾Ʈ ൿ
ϱ</a></h3>
<p>Ŭ̾Ʈ ̹ ˷ ذϱ
httpd.conf ϱ ٶ.</p>
<div class="example"><pre>#
# þ Ϲ HTTP Ѵ.
# ù° þ Netscape 2.x ̸
# keepalive ʴ´. ̵ ִ.
# ι° þ HTTP/1.1 ߸Ǿ 301̳ 302
# (̷) 信 keepalive
# ϴ Microsoft Internet Explorer 4.0b2 ̴.
#
BrowserMatch "Mozilla/2" nokeepalive
BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
#
# þ ⺻ HTTP/1.1 Ͽ
# HTTP/1.0 Ծ HTTP/1.1 ʴ´.
#
BrowserMatch "RealPlayer 4\.0" force-response-1.0
BrowserMatch "Java/1\.0" force-response-1.0
BrowserMatch "JDK/1\.0" force-response-1.0</pre></div>
<h3><a name="no-img-log" id="no-img-log"> α ̹ û α ʱ</a></h3>
<p> ̹ û α
ʴ´. Ư 丮 Ȥ Ư ȣƮ
û α ʵ ִ.</p>
<div class="example"><pre>SetEnvIf Request_URI \.gif image-request
SetEnvIf Request_URI \.jpg image-request
SetEnvIf Request_URI \.png image-request
CustomLog logs/access_log common env=!image-request</pre></div>
<h3><a name="image-theft" id="image-theft">"̹ " </a></h3>
<p> ڰ ִ
̹ ϵ ϴ Ѵ.
, ѵ 쿡 Ѵ.
츮 ̹ /web/images 丮 ȿ ִٰ
Ѵ.</p>
<div class="example"><pre>SetEnvIf Referer "^http://www.example.com/" local_referal
# Referer ʴ Ѵ
SetEnvIf Referer "^$" local_referal
<Directory /web/images>
Order Deny,Allow
Deny from all
Allow from env=local_referal
</Directory></pre></div>
<p> ڼ ApacheToday 丮 "<a href="http://apachetoday.com/news_story.php3?ltsn=2000-06-14-002-01-PS">
Keeping Your Images from Adorning Other Sites</a>" ϶.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/env.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/env.html" title="Korean"> ko </a> |
<a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/env.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/env.html 0000664 0001751 0001751 00000000701 13710016232 016476 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: env.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: env.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: env.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: env.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: env.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/dns-caveats.html.ko.euc-kr 0000664 0001751 0001751 00000032741 14743132254 021736 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>DNS ġ õ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>DNS ġ õ </h1>
<div class="toplang">
<p><span> : </span><a href="./en/dns-caveats.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dns-caveats.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dns-caveats.html" title="Korean"> ko </a> |
<a href="./tr/dns-caveats.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ִ. ġ
DNS ʵ ϶. ġ дµ
DNS ʿϴٸ ŷڼ ( ȵ ִ)
Ȥ ź ݰ (ڰ ٸ ڿ
ä Ͽ) (theft of service) ݿ
ô ִ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#example"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#denial">ź (Denial of Service)</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#main">"ּ" ּ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#tips"> ϱ </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#appendix">η: δ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="example" id="example"> </a></h2>
<div class="example"><p><code>
<VirtualHost www.abc.dom> <br />
ServerAdmin webgirl@abc.dom <br />
DocumentRoot /www/abc <br />
</VirtualHost>
</code></p></div>
<p>ġ ϱؼ ȣƮ
ΰ ʿϴ.
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
ٸ ּ Ѱ IP ̴ּ. IP ּҰ
, ġ DNS Ͽ <code>www.abc.dom</code>
ּҸ ãƾ Ѵ.
DNS ٸ ȣƮ <strong> </strong>.
ȣƮ û . (ġ 1.2
õ Ѵ.)</p>
<p><code>www.abc.dom</code> ּҰ 192.0.2.1̶ .
:</p>
<div class="example"><p><code>
<VirtualHost 192.0.2.1> <br />
ServerAdmin webgirl@abc.dom <br />
DocumentRoot /www/abc <br />
</VirtualHost>
</code></p></div>
<p> ġ ȣƮ <code>ServerName</code>
ã DNS ؾ Ѵ. ãⰡ ϸ ġ
ȣƮ κ . (ġ 1.2
õ Ѵ.) , ̸
ȣƮ ȣƮ ʰ, ip̶
κ Ѵ. ġ Ͽ
ü URL Ѵٸ URL Ѵ.</p>
<p>Ʒ ΰ .</p>
<div class="example"><p><code>
<VirtualHost 192.0.2.1> <br />
ServerName www.abc.dom <br />
ServerAdmin webgirl@abc.dom <br />
DocumentRoot /www/abc <br />
</VirtualHost>
</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="denial" id="denial">ź (Denial of Service)</a></h2>
<p>(ּ) ΰ źΰ ִ.
ġ 1.2 ȣƮ
DNS ˻ ϸ ʴ´.
DNS ִ. ,
<code>abc.dom</code> Ʈ̰ ڽ DNS
Ѵٸ, <code>www.abc.dom</code> ڵ带 ⸸ ص
(1.2 ) Ѵ.</p>
<p>ξ Ȱ ִ. 캸:</p>
<div class="example"><p><code>
<VirtualHost www.abc.dom> <br />
ServerAdmin webgirl@abc.dom <br />
DocumentRoot /www/abc <br />
</VirtualHost> <br />
<br />
<VirtualHost www.def.dom> <br />
ServerAdmin webguy@def.dom <br />
DocumentRoot /www/def <br />
</VirtualHost>
</code></p></div>
<p> <code>www.abc.dom</code> 192.0.2.1,
<code>www.def.dom</code> 192.0.2.2 Ҵߴٰ .
, <code>def.dom</code> ü DNS Ѵٰ .
Բ <code>def.dom</code> <code>abc.dom</code>
ç ִ ҿ ξ. ٸ
<code>www.def.dom</code> 192.0.2.1 ϱ⸸ ϸ ȴ.
ü DNS ϱ ϴµ
<code>www.def.dom</code> ڵ带 ϴ
.</p>
<p>(ڰ <code>http://www.abc.dom/whatever</code>
URL Էϴ 츦 Ͽ) 192.0.2.1 û
<code>def.dom</code> ȣƮ ϰ ȴ. ̷
Ͼ Ϸ ġ ȣƮ
û óϴ ʿϴ.
<a href="vhosts/details.html"></a> 밭 ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="main" id="main">"ּ" ּ</a></h2>
<p>ġ 1.1 <a href="vhosts/name-based.html"≯
ȣƮ </a> ԵǾ ġ
ϴ ȣƮ IP ּ() ʿ䰡 . ּҴ
(ִٸ) <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
Ȥ C Լ <code>gethostname</code> (Ʈ
"hostname" Է ) ´. ּҷ
DNS ˻ Ѵ. ˻ .</p>
<p>DNS ˻ ٸ
<code>/etc/hosts</code> ȣƮ ִ.
(ǻͰ õǾٸ Ƹ ̹ ̴.)
DNS ϸ <code>/etc/hosts</code>
ϴ Ȯ϶. ϴ ü
<code>/etc/resolv.conf</code> Ȥ <code>/etc/nsswitch.conf</code>
ϸ ̴.</p>
<p> DNS ˻ϸ ȵȴٸ
<code>HOSTRESORDER</code> ȯ溯 "local" ϰ
ġ ִ. <code class="module"><a href="./mod/mod_env.html">mod_env</a></code>
Ͽ ȯ ʴ´ٸ ȯ溯
CGI ش. ü manpage FAQ ϴ
.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="tips" id="tips"> ϱ </a></h2>
<ul>
<li>
<code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> IP
ּҸ ϶
</li>
<li>
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
IP ּҸ ϶
</li>
<li>
ȣƮ
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
϶
</li>
<li> ʴ
<code><VirtualHost _default_:*></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="appendix" id="appendix">η: δ</a></h2>
<p>DNS õ Ȳ ſ ٶ ϴ. ġ 1.2
츮 DNS 쿡 ּ
. · Ͽ IP ּҸ 䱸ϴ
ȣ ٽ ؾ ͳݿ ſ ٶ
ϴ.</p>
<p> Ѱ ˻
IP ּҿ ٽ DNS ˻ Ͽ ̸ ϴ ̴.
ٸ ȣƮ ִ.
DNS ùٷ Ǿ Ѵ. (FTP TCP wrapper
"ߺ-" DNS ˻ ϱ κ ڿ
ͼ ̴.)</p>
<p>· IP ּҸ DNS ȣƮ
ְ . Ϻθ ϴ
Ͱ κ ذå ü ʴ ͺ
ִ.</p>
<p>HTTP/1.1 Ͻð <code>Host</code>
Ƿ IP ȣƮ
ʴ ̴. ߿
DNS ˻ ʿ䰡 . 1997 3 ߿
̸ ȣƮ θ
ʾҴ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/dns-caveats.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dns-caveats.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dns-caveats.html" title="Korean"> ko </a> |
<a href="./tr/dns-caveats.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/dns-caveats.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/expr.html.en 0000664 0001751 0001751 00000110155 14737241666 017317 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Expressions in Apache HTTP Server - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Expressions in Apache HTTP Server</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/expr.html" title="English"> en </a> |
<a href="./fr/expr.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>Historically, there are several syntax variants for expressions
used to express a condition in the different modules of the Apache
HTTP Server. There is some ongoing effort to only use a single
variant, called <em>ap_expr</em>, for all configuration directives.
This document describes the <em>ap_expr</em> expression parser.
</p>
<p>The <em>ap_expr</em> expression is intended to replace most other
expression variants in HTTPD. For example, the deprecated <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code> expressions can be replaced
by <a href="mod/mod_authz_core.html#reqexpr">Require expr</a>. </p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#grammar">Grammar in Backus-Naur Form notation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#vars">Variables</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#binop">Binary operators</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#unnop">Unary operators</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#functions">Functions</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Example expressions</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">Other</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#sslrequire">Comparison with SSLRequire</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#compatibility">Version History</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="directive"><a href="./mod/core.html#if"><If></a></code></li><li><code class="directive"><a href="./mod/core.html#elseif"><ElseIf></a></code></li><li><code class="directive"><a href="./mod/core.html#else"><Else></a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_auth_basic.html#authbasicfake">AuthBasicFake</a></code></li><li><code class="directive"><a href="./mod/mod_auth_form.html#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code></li><li><code class="directive"><a href="./mod/mod_auth_form.html#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code></li><li><code class="directive"><a href="./mod/mod_auth_form.html#authformlogoutlocation">AuthFormLogoutLocation</a></code></li><li><code class="directive"><a href="./mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="./mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifexpr">SetEnvIfExpr</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#requestheader">RequestHeader</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code></li><li><a href="mod/mod_authz_core.html#reqexpr">Require expr</a></li><li><a href="mod/mod_authnz_ldap.html#requser">Require ldap-user</a></li><li><a href="mod/mod_authnz_ldap.html#reqgroup">Require ldap-group</a></li><li><a href="mod/mod_authnz_ldap.html#reqdn">Require ldap-dn</a></li><li><a href="mod/mod_authnz_ldap.html#reqattribute">Require ldap-attribute</a></li><li><a href="mod/mod_authnz_ldap.html#reqfilter">Require ldap-filter</a></li><li><a href="mod/mod_authnz_ldap.html#reqsearch">Require ldap-search</a></li><li><a href="mod/mod_authz_dbd.html#reqgroup">Require dbd-group</a></li><li><a href="mod/mod_authz_dbm.html#reqgroup">Require dbm-group</a></li><li><a href="mod/mod_authz_groupfile.html#reqgroup">Require group</a></li><li><a href="mod/mod_authz_host.html#reqhost">Require host</a></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code></li><li><code class="directive"><a href="./mod/mod_log_debug.html#logmessage">LogMessage</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><a href="#comments_section">Comments</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="grammar" id="grammar">Grammar in Backus-Naur Form notation</a></h2>
<p><a href="http://en.wikipedia.org/wiki/Backus%E2%80%93Naur_Form">Backus-Naur
Form</a> (BNF) is a notation technique for context-free grammars,
often used to describe the syntax of languages used in computing.
In most cases, expressions are used to express boolean values.
For these, the starting point in the BNF is <code>expr</code>.
However, a few directives like <code class="directive"><a href="./mod/mod_log_debug.html#logmessage">LogMessage</a></code> accept expressions
that evaluate to a string value. For those, the starting point in
the BNF is <code>string</code>.
</p>
<blockquote>
<pre>expr ::= "<strong>true</strong>" | "<strong>false</strong>"
| "<strong>!</strong>" expr
| expr "<strong>&&</strong>" expr
| expr "<strong>||</strong>" expr
| "<strong>(</strong>" expr "<strong>)</strong>"
| comp
comp ::= stringcomp
| integercomp
| unaryop word
| word binaryop word
| word "<strong>in</strong>" "<strong>{</strong>" wordlist "<strong>}</strong>"
| word "<strong>in</strong>" listfunction
| word "<strong>=~</strong>" regex
| word "<strong>!~</strong>" regex
stringcomp ::= word "<strong>==</strong>" word
| word "<strong>!=</strong>" word
| word "<strong><</strong>" word
| word "<strong><=</strong>" word
| word "<strong>></strong>" word
| word "<strong>>=</strong>" word
integercomp ::= word "<strong>-eq</strong>" word | word "<strong>eq</strong>" word
| word "<strong>-ne</strong>" word | word "<strong>ne</strong>" word
| word "<strong>-lt</strong>" word | word "<strong>lt</strong>" word
| word "<strong>-le</strong>" word | word "<strong>le</strong>" word
| word "<strong>-gt</strong>" word | word "<strong>gt</strong>" word
| word "<strong>-ge</strong>" word | word "<strong>ge</strong>" word
wordlist ::= word
| wordlist "<strong>,</strong>" word
word ::= word "<strong>.</strong>" word
| digit
| "<strong>'</strong>" string "<strong>'</strong>"
| "<strong>"</strong>" string "<strong>"</strong>"
| variable
| rebackref
| function
string ::= stringpart
| string stringpart
stringpart ::= cstring
| variable
| rebackref
cstring ::= ...
digit ::= [0-9]+
variable ::= "<strong>%{</strong>" varname "<strong>}</strong>"
| "<strong>%{</strong>" funcname "<strong>:</strong>" funcargs "<strong>}</strong>"
rebackref ::= "<strong>$</strong>" [0-9]
function ::= funcname "<strong>(</strong>" word "<strong>)</strong>"
listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>"</pre>
</blockquote>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="vars" id="vars">Variables</a></h2>
<p>The expression parser provides a number of variables of the form
<code>%{HTTP_HOST}</code>. Note that the value of a variable may depend
on the phase of the request processing in which it is evaluated. For
example, an expression used in an <code class="directive"><If ></code>
directive is evaluated before authentication is done. Therefore,
<code>%{REMOTE_USER}</code> will not be set in this case.</p>
<p>The following variables provide the values of the named HTTP request
headers. The values of other headers can be obtained with the
<code>req</code> <a href="#functions">function</a>. Using these
variables may cause the header name to be added to the Vary
header of the HTTP response, except where otherwise noted for the
directive accepting the expression. The <code>req_novary</code>
<a href="#functions">function</a> may be used to circumvent this
behavior.</p>
<table class="bordered"><tr class="header"><th>Name</th></tr>
<tr><td><code>HTTP_ACCEPT</code></td></tr>
<tr class="odd"><td><code>HTTP_COOKIE</code></td></tr>
<tr><td><code>HTTP_FORWARDED</code></td></tr>
<tr class="odd"><td><code>HTTP_HOST</code></td></tr>
<tr><td><code>HTTP_PROXY_CONNECTION</code></td></tr>
<tr class="odd"><td><code>HTTP_REFERER</code></td></tr>
<tr><td><code>HTTP_USER_AGENT</code></td></tr>
</table>
<p>Other request related variables</p>
<table class="bordered"><tr class="header"><th>Name</th><th>Description</th></tr>
<tr><td><code>REQUEST_METHOD</code></td>
<td>The HTTP method of the incoming request (e.g.
<code>GET</code>)</td></tr>
<tr class="odd"><td><code>REQUEST_SCHEME</code></td>
<td>The scheme part of the request's URI</td></tr>
<tr><td><code>REQUEST_URI</code></td>
<td>The path part of the request's URI</td></tr>
<tr class="odd"><td><code>DOCUMENT_URI</code></td>
<td>Same as <code>REQUEST_URI</code></td></tr>
<tr><td><code>REQUEST_FILENAME</code></td>
<td>The full local filesystem path to the file or script matching the
request, if this has already been determined by the server at the
time <code>REQUEST_FILENAME</code> is referenced. Otherwise, such
as when used in virtual host context, the same value as
<code>REQUEST_URI</code> </td></tr>
<tr class="odd"><td><code>SCRIPT_FILENAME</code></td>
<td>Same as <code>REQUEST_FILENAME</code></td></tr>
<tr><td><code>LAST_MODIFIED</code></td>
<td>The date and time of last modification of the file in the format
<code>20101231235959</code>, if this has already been determined by
the server at the time <code>LAST_MODIFIED</code> is referenced.
</td></tr>
<tr class="odd"><td><code>SCRIPT_USER</code></td>
<td>The user name of the owner of the script.</td></tr>
<tr><td><code>SCRIPT_GROUP</code></td>
<td>The group name of the group of the script.</td></tr>
<tr class="odd"><td><code>PATH_INFO</code></td>
<td>The trailing path name information, see
<code class="directive"><a href="./mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></td></tr>
<tr><td><code>QUERY_STRING</code></td>
<td>The query string of the current request</td></tr>
<tr class="odd"><td><code>IS_SUBREQ</code></td>
<td>"<code>true</code>" if the current request is a subrequest,
"<code>false</code>" otherwise</td></tr>
<tr><td><code>THE_REQUEST</code></td>
<td>The complete request line (e.g.,
"<code>GET /index.html HTTP/1.1</code>")</td></tr>
<tr class="odd"><td><code>REMOTE_ADDR</code></td>
<td>The IP address of the remote host</td></tr>
<tr><td><code>REMOTE_PORT</code></td>
<td>The port of the remote host (2.4.26 and later)</td></tr>
<tr class="odd"><td><code>REMOTE_HOST</code></td>
<td>The host name of the remote host</td></tr>
<tr><td><code>REMOTE_USER</code></td>
<td>The name of the authenticated user, if any (not available during <code class="directive"><If></code>)</td></tr>
<tr class="odd"><td><code>REMOTE_IDENT</code></td>
<td>The user name set by <code class="module"><a href="./mod/mod_ident.html">mod_ident</a></code></td></tr>
<tr><td><code>SERVER_NAME</code></td>
<td>The <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> of
the current vhost</td></tr>
<tr class="odd"><td><code>SERVER_PORT</code></td>
<td>The server port of the current vhost, see
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code></td></tr>
<tr><td><code>SERVER_ADMIN</code></td>
<td>The <code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code> of
the current vhost</td></tr>
<tr class="odd"><td><code>SERVER_PROTOCOL</code></td>
<td>The protocol used by the request</td></tr>
<tr><td><code>DOCUMENT_ROOT</code></td>
<td>The <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> of
the current vhost</td></tr>
<tr class="odd"><td><code>AUTH_TYPE</code></td>
<td>The configured <code class="directive"><a href="./mod/mod_authn_core.html#authtype">AuthType</a></code> (e.g.
"<code>basic</code>")</td></tr>
<tr><td><code>CONTENT_TYPE</code></td>
<td>The content type of the response (not available during <code class="directive"><If></code>)</td></tr>
<tr class="odd"><td><code>HANDLER</code></td>
<td>The name of the <a href="handler.html">handler</a> creating
the response</td></tr>
<tr><td><code>HTTP2</code></td>
<td>"<code>on</code>" if the request uses http/2,
"<code>off</code>" otherwise</td></tr>
<tr class="odd"><td><code>HTTPS</code></td>
<td>"<code>on</code>" if the request uses https,
"<code>off</code>" otherwise</td></tr>
<tr><td><code>IPV6</code></td>
<td>"<code>on</code>" if the connection uses IPv6,
"<code>off</code>" otherwise</td></tr>
<tr class="odd"><td><code>REQUEST_STATUS</code></td>
<td>The HTTP error status of the request (not available during <code class="directive"><If></code>)</td></tr>
<tr><td><code>REQUEST_LOG_ID</code></td>
<td>The error log id of the request (see
<code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code>)</td></tr>
<tr class="odd"><td><code>CONN_LOG_ID</code></td>
<td>The error log id of the connection (see
<code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code>)</td></tr>
<tr><td><code>CONN_REMOTE_ADDR</code></td>
<td>The peer IP address of the connection (see the
<code class="module"><a href="./mod/mod_remoteip.html">mod_remoteip</a></code> module)</td></tr>
<tr class="odd"><td><code>CONTEXT_PREFIX</code></td>
<td /></tr>
<tr><td><code>CONTEXT_DOCUMENT_ROOT</code></td>
<td /></tr>
</table>
<p>Misc variables</p>
<table class="bordered"><tr class="header"><th>Name</th><th>Description</th></tr>
<tr><td><code>TIME_YEAR</code></td>
<td>The current year (e.g. <code>2010</code>)</td></tr>
<tr class="odd"><td><code>TIME_MON</code></td>
<td>The current month (<code>01</code>, ..., <code>12</code>)</td></tr>
<tr><td><code>TIME_DAY</code></td>
<td>The current day of the month (<code>01</code>, ...)</td></tr>
<tr class="odd"><td><code>TIME_HOUR</code></td>
<td>The hour part of the current time
(<code>00</code>, ..., <code>23</code>)</td></tr>
<tr><td><code>TIME_MIN</code></td>
<td>The minute part of the current time </td></tr>
<tr class="odd"><td><code>TIME_SEC</code></td>
<td>The second part of the current time </td></tr>
<tr><td><code>TIME_WDAY</code></td>
<td>The day of the week (starting with <code>0</code>
for Sunday)</td></tr>
<tr class="odd"><td><code>TIME</code></td>
<td>The date and time in the format
<code>20101231235959</code></td></tr>
<tr><td><code>SERVER_SOFTWARE</code></td>
<td>The server version string</td></tr>
<tr class="odd"><td><code>API_VERSION</code></td>
<td>The date of the API version (module magic number)</td></tr>
</table>
<p>Some modules register additional variables, see e.g.
<code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="binop" id="binop">Binary operators</a></h2>
<p>With the exception of some built-in comparison operators, binary
operators have the form "<code>-[a-zA-Z][a-zA-Z0-9_]+</code>", i.e. a
minus and at least two characters. The name is not case sensitive.
Modules may register additional binary operators.</p>
<h3><a name="comp" id="comp">Comparison operators</a></h3>
<table class="bordered"><tr class="header"><th>Name</th><th>Alternative</th> <th>Description</th></tr>
<tr><td><code>==</code></td>
<td><code>=</code></td>
<td>String equality</td></tr>
<tr class="odd"><td><code>!=</code></td>
<td />
<td>String inequality</td></tr>
<tr><td><code><</code></td>
<td />
<td>String less than</td></tr>
<tr class="odd"><td><code><=</code></td>
<td />
<td>String less than or equal</td></tr>
<tr><td><code>></code></td>
<td />
<td>String greater than</td></tr>
<tr class="odd"><td><code>>=</code></td>
<td />
<td>String greater than or equal</td></tr>
<tr><td><code>=~</code></td>
<td />
<td>String matches the regular expression</td></tr>
<tr class="odd"><td><code>!~</code></td>
<td />
<td>String does not match the regular expression</td></tr>
<tr><td><code>-eq</code></td>
<td><code>eq</code></td>
<td>Integer equality</td></tr>
<tr class="odd"><td><code>-ne</code></td>
<td><code>ne</code></td>
<td>Integer inequality</td></tr>
<tr><td><code>-lt</code></td>
<td><code>lt</code></td>
<td>Integer less than</td></tr>
<tr class="odd"><td><code>-le</code></td>
<td><code>le</code></td>
<td>Integer less than or equal</td></tr>
<tr><td><code>-gt</code></td>
<td><code>gt</code></td>
<td>Integer greater than</td></tr>
<tr class="odd"><td><code>-ge</code></td>
<td><code>ge</code></td>
<td>Integer greater than or equal</td></tr>
</table>
<h3><a name="binaryother" id="binaryother">Other binary operators</a></h3>
<table class="bordered"><tr class="header"><th>Name</th><th>Description</th></tr>
<tr><td><code>-ipmatch</code></td>
<td>IP address matches address/netmask</td></tr>
<tr class="odd"><td><code>-strmatch</code></td>
<td>left string matches pattern given by right string (containing
wildcards *, ?, [])</td></tr>
<tr><td><code>-strcmatch</code></td>
<td>same as <code>-strmatch</code>, but case insensitive</td></tr>
<tr class="odd"><td><code>-fnmatch</code></td>
<td>same as <code>-strmatch</code>, but slashes are not matched by
wildcards</td></tr>
</table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="unnop" id="unnop">Unary operators</a></h2>
<p>Unary operators take one argument and have the form
"<code>-[a-zA-Z]</code>", i.e. a minus and one character.
The name <em>is</em> case sensitive.
Modules may register additional unary operators.</p>
<table class="bordered"><tr class="header"><th>Name</th><th>Description</th><th>Restricted</th></tr>
<tr><td><code>-d</code></td>
<td>The argument is treated as a filename.
True if the file exists and is a directory</td><td>yes</td></tr>
<tr class="odd"><td><code>-e</code></td>
<td>The argument is treated as a filename.
True if the file (or dir or special) exists</td><td>yes</td></tr>
<tr><td><code>-f</code></td>
<td>The argument is treated as a filename.
True if the file exists and is regular file</td><td>yes</td></tr>
<tr class="odd"><td><code>-s</code></td>
<td>The argument is treated as a filename.
True if the file exists and is not empty</td><td>yes</td></tr>
<tr><td><code>-L</code></td>
<td>The argument is treated as a filename.
True if the file exists and is symlink</td><td>yes</td></tr>
<tr class="odd"><td><code>-h</code></td>
<td>The argument is treated as a filename.
True if the file exists and is symlink
(same as <code>-L</code>)</td><td>yes</td></tr>
<tr><td><code>-F</code></td>
<td>True if string is a valid file, accessible via all the server's
currently-configured access controls for that path. This uses an
internal subrequest to do the check, so use it with care - it can
impact your server's performance!</td><td /></tr>
<tr class="odd"><td><code>-U</code></td>
<td>True if string is a valid URL, accessible via all the server's
currently-configured access controls for that path. This uses an
internal subrequest to do the check, so use it with care - it can
impact your server's performance!</td><td /></tr>
<tr><td><code>-A</code></td>
<td>Alias for <code>-U</code></td><td /></tr>
<tr class="odd"><td><code>-n</code></td>
<td>True if string is not empty</td><td /></tr>
<tr><td><code>-z</code></td>
<td>True if string is empty</td><td /></tr>
<tr class="odd"><td><code>-T</code></td>
<td>False if string is empty, "<code>0</code>", "<code>off</code>",
"<code>false</code>", or "<code>no</code>" (case insensitive).
True otherwise.</td><td /></tr>
<tr><td><code>-R</code></td>
<td>Same as "<code>%{REMOTE_ADDR} -ipmatch ...</code>", but more
efficient
</td><td /></tr>
</table>
<p>The operators marked as "restricted" are not available in some modules
like <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="functions" id="functions">Functions</a></h2>
<p>Normal string-valued functions take one string as argument and return
a string. Functions names are not case sensitive.
Modules may register additional functions.</p>
<table class="bordered"><tr class="header"><th>Name</th><th>Description</th><th>Special notes</th></tr>
<tr><td><code>req</code>, <code>http</code></td>
<td>Get HTTP request header; header names may be added to the Vary
header, see below</td><td /></tr>
<tr class="odd"><td><code>req_novary</code></td>
<td>Same as <code>req</code>, but header names will not be added to the
Vary header</td><td /></tr>
<tr><td><code>resp</code></td>
<td>Get HTTP response header (most response headers will not yet be set
during <code class="directive"><If></code>)</td><td /></tr>
<tr class="odd"><td><code>reqenv</code></td>
<td>Lookup request environment variable (as a shortcut,
<code>v</code> can also be used to access variables).
</td>
<td>ordering</td></tr>
<tr><td><code>osenv</code></td>
<td>Lookup operating system environment variable</td><td /></tr>
<tr class="odd"><td><code>note</code></td>
<td>Lookup request note</td><td>ordering</td></tr>
<tr><td><code>env</code></td>
<td>Return first match of <code>note</code>, <code>reqenv</code>,
<code>osenv</code></td><td>ordering</td></tr>
<tr class="odd"><td><code>tolower</code></td>
<td>Convert string to lower case</td><td /></tr>
<tr><td><code>toupper</code></td>
<td>Convert string to upper case</td><td /></tr>
<tr class="odd"><td><code>escape</code></td>
<td>Escape special characters in %hex encoding</td><td /></tr>
<tr><td><code>unescape</code></td>
<td>Unescape %hex encoded string, leaving encoded slashes alone;
return empty string if %00 is found</td><td /></tr>
<tr class="odd"><td><code>base64</code></td>
<td>Encode the string using base64 encoding</td><td /></tr>
<tr><td><code>unbase64</code></td>
<td>Decode base64 encoded string, return truncated string if 0x00 is
found</td><td /></tr>
<tr class="odd"><td><code>md5</code></td>
<td>Hash the string using MD5, then encode the hash with hexadecimal
encoding</td><td /></tr>
<tr><td><code>sha1</code></td>
<td>Hash the string using SHA1, then encode the hash with hexadecimal
encoding</td><td /></tr>
<tr class="odd"><td><code>file</code></td>
<td>Read contents from a file (including line endings, when present)
</td><td>restricted</td></tr>
<tr><td><code>filesize</code></td>
<td>Return size of a file (or 0 if file does not exist or is not
regular file)</td><td>restricted</td></tr>
<tr class="odd"><td><code>ldap</code></td>
<td>Escape characters as required by LDAP distinguished name escaping
(RFC4514) and LDAP filter escaping (RFC4515).<br />
(Available in httpd 2.4.53 and later)</td><td /></tr>
</table>
<p>The functions marked as "restricted" in the final column are not
available in some modules like <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>.</p>
<p>The functions marked as "ordering" in the final column require some
consideration for the ordering of different components of the server,
especially when the function is used within the
<<code class="directive"><a href="./mod/core.html#if">If</a></code>> directive which is
evaluated relatively early.</p>
<div class="note">
<h3>Environment variable ordering</h3>
When environment variables are looked up within an
<<code class="directive"><a href="./mod/core.html#if">If</a></code>> condition, it's important
to consider how extremely early in request processing that this
resolution occurs. As a guideline, any directive defined outside of virtual host
context (directory, location, htaccess) is not likely to have yet had a
chance to execute. <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>
in virtual host scope is one directive that runs prior to this resolution
<br />
<br />
When <code>reqenv</code> is used outside of <<code class="directive"><a href="./mod/core.html#if">If</a></code>>, the resolution will generally occur later, but the
exact timing depends on the directive the expression has been used within.
</div>
<p>When the functions <code>req</code> or <code>http</code> are used,
the header name will automatically be added to the Vary header of the
HTTP response, except where otherwise noted for the directive accepting
the expression. The <code>req_novary</code> function can be used to
prevent names from being added to the Vary header.</p>
<p>In addition to string-valued functions, there are also
list-valued functions which take one string as argument and return a
wordlist, i.e. a list of strings. The wordlist can be used with the
special <code>-in</code> operator. Functions names are not case
sensitive. Modules may register additional functions.</p>
<p>There are no built-in list-valued functions. <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>
provides <code>PeerExtList</code>. See the description of
<code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code> for details
(but <code>PeerExtList</code> is also usable outside
of <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code>).</p>
</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">Example expressions</a></h2>
<p>The following examples show how expressions might be used to
evaluate requests:</p>
<pre class="prettyprint lang-config"># Compare the host name to example.com and redirect to www.example.com if it matches
<If "%{HTTP_HOST} == 'example.com'">
Redirect permanent "/" "http://www.example.com/"
</If>
# Force text/plain if requesting a file with the query string contains 'forcetext'
<If "%{QUERY_STRING} =~ /forcetext/">
ForceType text/plain
</If>
# Only allow access to this content during business hours
<Directory "/foo/bar/business">
Require expr %{TIME_HOUR} -gt 9 && %{TIME_HOUR} -lt 17
</Directory>
# Check a HTTP header for a list of values
<If "%{HTTP:X-example-header} in { 'foo', 'bar', 'baz' }">
Header set matched true
</If>
# Check an environment variable for a regular expression, negated.
<If "! reqenv('REDIRECT_FOO') =~ /bar/">
Header set matched true
</If>
# Check result of URI mapping by running in Directory context with -f
<Directory "/var/www">
AddEncoding x-gzip gz
<If "-f '%{REQUEST_FILENAME}.unzipme' && ! %{HTTP:Accept-Encoding} =~ /gzip/">
SetOutputFilter INFLATE
</If>
</Directory>
# Check against the client IP
<If "-R '192.168.1.0/24'">
Header set matched true
</If>
# Function example in boolean context
<If "md5('foo') == 'acbd18db4cc2f85cedef654fccc4a4d8'">
Header set checksum-matched true
</If>
# Function example in string context
Header set foo-checksum "expr=%{md5:foo}"
# This delays the evaluation of the condition clause compared to <If>
Header always set CustomHeader my-value "expr=%{REQUEST_URI} =~ m#^/special_path\.php$#"
# Conditional logging
CustomLog logs/access-errors.log common "expr=%{REQUEST_STATUS} >= 400"
CustomLog logs/access-errors-specific.log common "expr=%{REQUEST_STATUS} -in {'405','410'}"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Other</a></h2>
<table class="bordered"><tr class="header"><th>Name</th><th>Alternative</th> <th>Description</th></tr>
<tr><td><code>-in</code></td>
<td><code>in</code></td>
<td>string contained in wordlist</td></tr>
<tr class="odd"><td><code>/regexp/</code></td>
<td><code>m#regexp#</code></td>
<td>Regular expression (the second form allows different
delimiters than /)</td></tr>
<tr><td><code>/regexp/i</code></td>
<td><code>m#regexp#i</code></td>
<td>Case insensitive regular expression</td></tr>
<tr class="odd"><td><code>$0 ... $9</code></td>
<td />
<td>Regular expression backreferences</td></tr>
</table>
<h3><a name="rebackref" id="rebackref">Regular expression backreferences</a></h3>
<p>The strings <code>$0</code> ... <code>$9</code> allow to reference
the capture groups from a previously executed, successfully
matching regular expressions. They can normally only be used in the
same expression as the matching regex, but some modules allow special
uses.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="sslrequire" id="sslrequire">Comparison with SSLRequire</a></h2>
<p>The <em>ap_expr</em> syntax is mostly a superset of the syntax of the
deprecated <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code> directive.
The differences are described in <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code>'s documentation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="compatibility" id="compatibility">Version History</a></h2>
<p>The <code>req_novary</code> <a href="#functions">function</a>
is available for versions 2.4.4 and later.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/expr.html" title="English"> en </a> |
<a href="./fr/expr.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/expr.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/env.html.ja.utf8 0000664 0001751 0001751 00000075073 14743132254 020004 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache の環境変数 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Apache の環境変数</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/env.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/env.html" title="Japanese"> ja </a> |
<a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>Apache HTTP サーバは<em>環境変数</em>と呼ばれる、名前のついた
変数に情報を記憶する仕組みを提供しています。この情報はログ収集や
アクセス制御などのいろいろな操作を制御するために使うことができます。
これらの変数は CGI スクリプトなどの外部プログラムと通信するためにも
使われます。この文書はそれらの変数の操作方法と使用方法をいくつか
紹介します。</p>
<p>これらの変数は<em>環境変数</em>と呼ばれていますが、オペレーティング
システムによって制御されている環境変数と同じではありません。
実際は、これらの変数は Apache の内部構造の中に記憶され、操作されています。
それらは、CGI や SSI スクリプトに渡されたときだけ、実際の
オペレーティングシステムの環境変数になります。サーバ自身が
実行されているオペレーティングシステムの環境を操作したい場合は、
オペレーティングシステムのシェルが提供している標準の環境変数の
操作方法を使わなければなりません。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#setting">環境変数の設定</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">環境変数の使用</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#special">特別な目的の環境変数</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">例</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="setting" id="setting">環境変数の設定</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr></table>
<h3><a name="basic-manipulation" id="basic-manipulation">基本的な環境の操作</a></h3>
<p>Apache において環境変数を設定する一番基本的な方法は、
無条件に環境変数を設定する <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> ディレクティブを使用することです。
<code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code>
ディレクティブにより、Apache が起動されたシェルの
環境変数を渡すこともできます。</p>
<h3><a name="conditional" id="conditional">リクエスト毎に条件に基づいて設定する</a></h3>
<p>より柔軟性を高めるために、mod_setenvif
で提供されているディレクティブを使用することで、リクエストの
特性に基づいて環境変数を設定することができます。例えば、特定のブラウザ
(User-Agent) のリクエストや特定の Referer [意図的な綴りです]
<span class="transnote">(<em>訳注:</em> 正しい綴りは referrer ですが、HTTP の仕様では Referer
となっています)</span>ヘッダが見つかったときのみ変数を設定することができます。
mod_rewrite の <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
ディレクティブにおいて環境変数を設定する <code>[E=...]</code>
オプションを使用することで、
より柔軟な設定を行なうことができます。</p>
<h3><a name="unique-identifiers" id="unique-identifiers">一意な識別子</a></h3>
<p>mod_unique_id は、非常に限られた条件の下で
「すべて」のリクエストについて、一意であることが保証されている値を環境変数
<code>UNIQUE_ID</code> に設定します。</p>
<h3><a name="standard-cgi" id="standard-cgi">標準 CGI 変数</a></h3>
<p>Apache の設定ファイルで設定された環境変数とシェルから渡される
環境変数に加えて、CGI スクリプトと SSI ページには <a href="http://cgi-spec.golux.com">CGI の仕様</a>で要求されている、
リクエストのメタ情報を持った環境変数の組が提供されます。</p>
<h3><a name="caveats" id="caveats">いくつかの注意</a></h3>
<ul>
<li>環境を操作するディレクティブを使って標準 CGI
変数を上書きしたり変更したりすることはできません。</li>
<li>CGI スクリプトを起動するために <code class="program"><a href="./programs/suexec.html">suexec</a></code>
が使用されている場合、CGI スクリプトが起動するために、環境変数は<em>安全</em>な環境変数の組に整理されます。
この安全な環境変数の集合は、コンパイル時に <code>suexec.c</code>
で定義されます。</li>
<li>移植性のために、環境変数の名前はアルファベット、
数字とアンダースコア <span class="transnote">(<em>訳注:</em> '_')</span> だけから成ります。
さらに、最初の文字は数字であってはいけません。
この制限に合わない文字は CGI スクリプトと SSI
ページに渡されるときにアンダースコアに置換されます。</li>
<li><code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> はリクエスト処理の
段階の中でも遅くに実行されます。つまり
<code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> や
<code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</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="using" id="using">環境変数の使用</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</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_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authz_host.html#allow">Allow</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_authz_host.html#deny">Deny</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr></table>
<h3><a name="cgi-scripts" id="cgi-scripts">CGI スクリプト</a></h3>
<p>環境変数の主な利用法の一つは、CGI スクリプトに情報を伝えることです。
上で説明されているように、CGI スクリプトに渡される環境変数は Apache
の設定により設定される変数に加えて、リクエストの標準のメタ情報を含んでいます。
詳細は <a href="howto/cgi.html">CGI チュートリアル</a>
を参照してください。</p>
<h3><a name="ssi-pages" id="ssi-pages">SSI ページ</a></h3>
<p>mod_include の <code>INCLUDES</code> フィルタで処理される
server-parsed (SSI) ドキュメントでは、<code>echo</code>
要素を使用すると環境変数が出力されます。
また、ページのある部分がリクエストの性質に応じて変更されるように、
環境変数をフロー制御要素で使うことができます。詳細は
<a href="howto/ssi.html">SSI チュートリアル</a> を参照してください。</p>
<h3><a name="access-control" id="access-control">アクセス制御</a></h3>
<p><code>allow from env=</code> ディレクティブと <code>deny from env=</code>
ディレクティブを使用して、サーバへのアクセスを環境変数の値で制御することができます。
<code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>
ディレクティブと組み合わせることで、クライアントの特性に基づいて
サーバへのアクセス制御を柔軟に行なうことができるようになります。
たとえば、これらのディレクティブを使用して、特定のブラウザ (User-Agent)
からのアクセスを拒否することができます。</p>
<h3><a name="logging" id="logging">条件付きログ記録</a></h3>
<p><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
ディレクティブのオプション <code>%e</code>
を使用することで、環境変数をアクセスログに記録することができます。さらに、
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
ディレクティブの条件分岐式を使用することで、
環境変数の値によってリクエストをログに記録するかどうかを決めることができます。
<code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>
ディレクティブと組み合わせることで、
どのリクエストをログに記録するかを柔軟に制御することが可能になります。たとえば、
<code>gif</code> で終わるファイル名へのリクエストはログに記録しない、
違うサブネットのクライアントからのリクエストだけをログに記録する、
という選択が可能です。</p>
<h3><a name="response-headers" id="response-headers">条件付き応答ヘッダ</a></h3>
<p><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>
ディレクティブは環境変数の存在や不在によってクライアントへの応答に特定の
HTTP ヘッダを付けるかどうかを決めることができます。
これにより、たとえば、クライアントからのリクエスト
にあるヘッダがある場合にのみ特定の応答ヘッダを送る、というようなことが
できます。</p>
<h3><a name="external-filter" id="external-filter">外部フィルタの適用</a></h3>
<p><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code>
ディレクティブを使用して
<code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> で設定される外部フィルタは、
<code>disableenv=</code> と <code>enableenv=</code>
オプションを使って、環境変数による条件付き適用ができます。</p>
<h3><a name="url-rewriting" id="url-rewriting">URL の書き換え</a></h3>
<p><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
ディレクティブで<em>評価文字列</em>として
<code>%{ENV:...}</code> 式を指定することで、mod_rewrite
の書き換えエンジンが環境変数に基いて条件分岐を行なうことができます。
mod_rewrite が使用可能な変数で <code>ENV:</code> が前についていない変数は、
実際は環境変数ではないということに注意してください。
それらは他のモジュールからは使用できない mod_rewrite 用の特別な変数です。
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="special" id="special">特別な目的の環境変数</a></h2>
<p>互換性の問題を解決するために、特定のクライアントと通信しているときは
Apache の動作を変更できる機構が導入されました。できるだけ柔軟にするために、
これらの機構は環境変数を定義することで呼び出されます。普通は、
<code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>
ディレクティブを使いますが、たとえば <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> ディレクティブや <code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> ディレクティブも使用することができます。</p>
<h3><a name="downgrade" id="downgrade">downgrade-1.0</a></h3>
<p>これを指定することで、リクエストが HTTP/1.0
より新しいプロトコルの場合でも、HTTP/1.0 として扱われます。</p>
<h3><a name="force-gzip" id="force-gzip">force-gzip</a></h3>
<p><code>DEFLATE</code> フィルタが使用するように設定されているときに、
この環境変数はブラウザの accept-encoding の設定を無視して常に
圧縮された出力を送るようにします。</p>
<h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3>
<p>応答ヘッダがクライアントに送られる前に <code>Vary</code>
フィールドを取り除きます。
クライアントの中にはこのフィールドを正しく解釈しないものがあります。
この変数を設定することでその問題を回避することができます。
この変数を設定すると、<strong>force-response-1.0</strong>
が設定されたことになります。</p>
<h3><a name="force-response" id="force-response">force-response-1.0</a></h3>
<p>これが設定されていると、HTTP/1.0 リクエストを発行するクライアントに対しては
常に HTTP/1.0 で応答するようになります。この機能は、
元々は AOL のプロキシの問題のために実装されました。HTTP/1.0 クライアントの中には、
HTTP/1.1 の応答を返されると正しく動作しないものがあるかもしれません。
この機能を使用することで、そのようなクライアントとの間の互換性問題を解決できます。</p>
<h3><a name="gzip-only-text-html" id="gzip-only-text-html">gzip-only-text/html</a></h3>
<p>これが 1 に設定されると、この変数は <code>text/html</code>
以外のコンテントタイプに対する、<code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>
提供の <code>DEFLATE</code> 出力フィルタを無効にします。
また、静的に、既に圧縮されたファイルを使用したい場合、
(gzip だけでなく、"identity" と異なる全てのエンコードに対して)
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> も変数を評価します。</p>
<h3><a name="no-gzip" id="no-gzip">no-gzip</a></h3>
<p>セットされると、<code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> の
<code>DEFLATE</code> フィルタがオフになります。
そして <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>
はエンコードされたリソースを送らないようにします。</p>
<h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
<p>これが設定されている場合は、<code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code> を使用しないようにします。</p>
<h4><a name="prefer-language" id="prefer-language">prefer-language</a></h4>
<p><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> の挙動に影響を与えます。
(<code>en</code>, <code>ja</code>, <code>x-klingon</code>といった)
言語タグが格納されていれば、その言語の variant を送信しようとします。
そのような variant がない場合は、
通常の<a href="content-negotiation.html">ネゴシエーション</a>処理が
適用されます。</p>
<h3><a name="redirect-carefully" id="redirect-carefully">redirect-carefully</a></h3>
<p>これはクライアントへのリダイレクトの送信をサーバがより注意深く
行なうようにします。
これは通常、リダイレクトに際してクライアントに
問題があることが分かっている場合に使われます。この機能は元々は
マイクロソフトのウェブフォルダのソフトが DAV
メソッドによるディレクトリのリソースへのリダイレクトの扱いに
問題がり、それを回避するために実装されました。</p>
<h3><a name="suppress-error-charset" id="suppress-error-charset">suppress-error-charset</a></h3>
<p><em>Apache 2.2 以降で利用可能</em></p>
<p>クライアントのリクエストに対する応答としてリダイレクトを送信する際、
レスポンスにはリダイレクトが自動的に行なえない (行なわれない)
場合に表示するテキストが含まれます。
通常、このテキストに合致したキャラクタセット、ISO-8859-1
でラベル付けをします。</p>
<p>しかし、リダイレクト先が別の文字セットを使っている場合、
ある問題のあるブラウザのバージョンでは、
リダイレクト先の実際の文字セットの代わりに、
リダイレクト元の文字セットを使ってしまうことがあります。
その結果、例えば変な描画が行なわれたりして、読めなくなったりします。</p>
<p>この環境変数を設定することで、リダイレクションテキストに対する
キャラクタセットの指定を除去しますので、それら問題のあるブラウザでも
リダイレクト先の文字セットを正しく使うようにできます。</p>
<div class="warning">
<h3>セキュリティ</h3>
<p>文字セットを指定せずにエラーページを送信すると、
クロスサイトスクリプティング <span class="transnote">(<em>訳注:</em> XSS)</span>
攻撃の危険性がでてきます。
HTTP/1.1 仕様に準拠していなくて、コンテンツの中身から文字セットを
"推測" しようとするブラウザ (MSIE) が実際にあるからです。
そのようなブラウザは UTF-7 文字セットを使って簡単に騙すことができます。
クロスサイトスクリプティング攻撃を防ぐために実装されている
通常のエスケープ機構が、入力データ中にある UTF-7 で
エンコードされたコンテンツ (リクエスト URI など) には
うまく動作しないからです。</p>
</div>
<h3><a name="proxy" id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked, proxy-sendcl</a></h3>
<p>これらの指示子は <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> の挙動を変更します。
詳細は <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> のドキュメントをご参照ください。</p>
</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="misbehaving" id="misbehaving">おかしな挙動をするクライアントに対してプロトコルの動作を変更する</a></h3>
<p>クライアントに関する既知の問題に対処するために、以下の行を
httpd.conf に入れることを推奨しています。</p>
<p>古いバージョンの Apache では、クライアントの問題に対応するために
httpd.conf に次の行を加えるよう推奨されていましたが、
今となっては、問題としていたクライアントは実際には見かけることは
なくなってきたので、この設定はもはや必要ないかもしれません。</p>
<div class="example"><pre>#
# The following directives modify normal HTTP response behavior.
# The first directive disables keepalive for Netscape 2.x and browsers that
# spoof it. There are known problems with these browser implementations.
# The second directive is for Microsoft Internet Explorer 4.0b2
# which has a broken HTTP/1.1 implementation and does not properly
# support keepalive when it is used on 301 or 302 (redirect) responses.
#
BrowserMatch "Mozilla/2" nokeepalive
BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
#
# The following directive disables HTTP/1.1 responses to browsers which
# are in violation of the HTTP/1.0 spec by not being able to grok a
# basic 1.1 response.
#
BrowserMatch "RealPlayer 4\.0" force-response-1.0
BrowserMatch "Java/1\.0" force-response-1.0
BrowserMatch "JDK/1\.0" force-response-1.0</pre></div>
<h3><a name="no-img-log" id="no-img-log">画像へのリクエストをアクセスログに記録しない</a></h3>
<p>この例では、画像へのリクエストがアクセスログに現れないようにします。
これを変更することで、特定のディレクトリのログ収集をやめたり、
特定のホストからのリクエストのログ収集をやめたりすることが簡単にできます。
</p>
<div class="example"><pre>SetEnvIf Request_URI \.gif image-request
SetEnvIf Request_URI \.jpg image-request
SetEnvIf Request_URI \.png image-request
CustomLog logs/access_log common env=!image-request</pre></div>
<h3><a name="image-theft" id="image-theft">「画像の盗用」を防ぐ</a></h3>
<p>この例は、別のサーバにいる人が、あなたのサーバにある画像を
inline 画像として使用することを防ぎます。
これは推奨されている設定ではありませんが、ある限定された状況では有効です。
ここでは、すべての画像は <code>/web/images</code>
というディレクトリにあると仮定します。</p>
<div class="example"><pre>SetEnvIf Referer "^http://www\.example\.com/" local_referal
# Allow browsers that do not send Referer info
SetEnvIf Referer "^$" local_referal
<Directory /web/images>
Order Deny,Allow
Deny from all
Allow from env=local_referal
</Directory></pre></div>
<p>この手法に関する詳しい情報は ServerWatch にあるチュートリアル
「<a href="http://www.serverwatch.com/tutorials/article.php/1132731">Keeping Your Images from Adorning Other Sites</a>
」を参照してください。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/env.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/env.html" title="Japanese"> ja </a> |
<a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/env.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/dso.html.tr.utf8 0000664 0001751 0001751 00000052756 14743132254 020037 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Devingen Paylaşımlı Nesne Desteği - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Devingen Paylaşımlı Nesne Desteği</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dso.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dso.html" title="Türkçe"> tr </a></p>
</div>
<p>Apache HTTP Sunucusu modüler bir program olup, yönetici sadece bir
grup modül seçerek sunucuya işlevsellik ekleyebilir. Modüller, Devingen
Paylaşımlı Nesneler (DSO - Dynamic Shared Object) halinde
<code class="program"><a href="./programs/httpd.html">httpd</a></code> programından ayrı olarak derlenir. DSO modülleri
sunucunun derlenmesi sırasında derlenebileceği gibi ayrı olarak derlenip
daha sonra Apache Eklenti Aracı (Apache Extension Tool)
<code class="program"><a href="./programs/apxs.html">apxs</a></code> programı kullanılarak da sunucuya eklenebilir.</p>
<p>Bu belgede DSO modüllerinin kullanımının yanında teorisine de
değinilecektir.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#implementation">Gerçeklenim</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#usage">Kullanım Özeti</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#background">Artalan Bilgisi</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#advantages">Getiriler ve Götürüler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="implementation" id="implementation">Gerçeklenim</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>Apache httpd modüllerini yüklemek için DSO desteği, Apache httpd
çekirdeğine durağan olarak ilintilenerek derlenmiş olan
<code class="module"><a href="./mod/mod_so.html">mod_so</a></code> adında bir modül tarafından sağlanır.
<code class="module"><a href="./mod/core.html">core</a></code> modülünden başka, bir DSO modülü olamayan tek modül
<code class="module"><a href="./mod/mod_so.html">mod_so</a></code> modülüdür. Apache ile dağıtılan hemen hemen tüm
diğer Apache modülleri bir DSO modülüne yerleştirilebilir. Derlenmiş
modüller <code>mod_filanca.so</code> biçeminde birer DSO ismi alırlar ve
her biri istenirse <code>httpd.conf</code> dosyasında
<code class="module"><a href="./mod/mod_so.html">mod_so</a></code> modülünün <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> yönergesiyle belirtilerek sunucu başlatılırken
veya yeniden başlatılırken sunucuya yüklenebilir.</p>
<p><a href="install.html">Kurulum belgesinde</a> açıklandığı gibi, her DSO
modülü <code class="program"><a href="./programs/configure.html">configure</a></code> programının
<code>--enable-mods-static</code> seçeneği ile devredışı bırakılabilir.</p>
<p>Apache httpd modülleri için (özellikle üçüncü parti modüller için) DSO
dosyası üretimini kolaylaştırmak amacıyla <code class="program"><a href="./programs/apxs.html">apxs</a></code>
(<dfn>APache eXtenSion</dfn>) adında yeni bir destek programı
kullanılmaktadır. Bu program Apache httpd modüllerini Apache httpd kaynak
ağacından ayrı olarak derlemek için kullanılabilir. Fikir basittir: Apache
HTTP Sunucusu derlenirken DSO dosyalarını derlemek için platforma bağımlı
derleyici ve ilintileyici seçenekleri <code class="program"><a href="./programs/apxs.html">apxs</a></code>
programının içine konur ve <code>make install</code> ile kurulum sırasında
Apache httpd C başlık dosyaları da kurulur. Böylece
kullanıcı Apache httpd dağıtımının kaynak ağacına ihtiyaç duymadan ve
platforma bağımlı derleyici ve ilintileyici seçeneklerini bilmek zorunda
kalmadan istediği Apache httpd modülünü <code class="program"><a href="./programs/apxs.html">apxs</a></code>
programını kullanarak derleyebilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="usage" id="usage">Kullanım Özeti</a></h2>
<p>Apache HTTP Sunucusu 2.x’in DSO özelliklerine bir giriş olarak burada
kısaca bir bilgi vermekle yetinilecektir:</p>
<ol>
<li><p>Kaynak dosyası <code>mod_filanca.c</code> dosyasında dağıtılan bir
<em>özgün</em> Apache htpd modülünü <code>mod_filanca.so</code> isminde
bir DSO modülü olarak derlemek ve kurmak için şöyle yapılır:</p>
<div class="example"><p><code>
$ ./configure --prefix=/kurulum/yeri --enable-filanca<br />
$ make install
</code></p></div>
</li>
<li><p>Apache HTTP Sunucusunu tüm modüller etkin olarak
derleyebilirsiniz. Fakat sunucunun başlatılması sırasında sadece temel
modüller yüklenir. Daha sonra <code>httpd.conf</code> içindeki
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> yönergelerini etkin
veya etkisiz hale getirerek yüklenecek modülleri
değiştirebilirsiniz.</p>
<div class="example"><p><code>
$ ./configure --enable-mods-shared=all<br />
$ make install
</code></p></div>
</li>
<li><p>Bazı modüller sadece geliştiriciler içindir ve bunlar tüm
modüllerin derlenmesini (<em>all</em>) seçseniz bile derlenmeyecektir.
Geliştirici modülleri dehil tüm modülleri derlemek isterseniz
<em>reallyall</em> kullanınız. Ek olarak, derlenmiş modüller için
kullanılan <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
yönergelerinin tamamını <code>--enable-load-all-modules</code> derleme
seçeneği ile etkin kılabilirsiniz.</p>
<div class="example"><p><code>
$ ./configure --enable-mods-shared=reallyall --enable-load-all-modules<br />
$ make install
</code></p></div>
</li>
<li><p>Kaynak dosyası <code>mod_filanca.c</code> dosyasında dağıtılan bir
<em>üçüncü parti</em> Apache httpd modülü <code>mod_filanca.so</code>
isminde bir DSO modülü olarak Apache httpd kaynak ağacının dışında
<code class="program"><a href="./programs/apxs.html">apxs</a></code> kullanarak derlemek ve kurmak için şöyle
yapılır:</p>
<div class="example"><p><code>
$ cd /bir/kurulum/yeri<br />
$ apxs -c mod_filanca.c<br />
$ apxs -aci filanca mod_filanca.la
</code></p></div>
</li>
</ol>
<p>Tüm durumlarda derlenen paylaşımlı modülü Apache httpd’nin etkin
kılabilmesi için <code>httpd.conf</code> dosyasında o modül için bir
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> yönergesi
bulunmalıdır.</p>
<p>Ayrıntılı bilgi için <a href="programs/apxs.html">apxs belgelerine</a>
bakınız.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="background" id="background">Artalan Bilgisi</a></h2>
<p>Günümüzün Unix türevlerinde var olan bir mekanizma sayesinde
çalıştırılabilir bir programın adres uzayına çalışma anında yüklenmek
veya ilintilenmek üzere <em>Devingen Paylaşımlı Nesneler</em> (DSO -
Dynamic Shared Object) adı verilen, özel bir biçem kullanarak kodlanmış
program parçaları oluşturulabilir.</p>
<p>Bu yükleme normalde iki yolla yapılabilir: Ya çalıştırılabilir
programın başlatılması sırasında yüklenen <code>ld.so</code> adlı bir
sistem programınının devingen olarak yüklenmesi ile ya da
çalıştırılabilir programın içinden Unix yükleyicisine programsal sistem
arayüzü sağlayan <code>dlopen()/dlsym()</code> sistem çağrılarının elle
yapılması suretiyle.</p>
<p>İlk yöntemde kullanılan DSO’lara genelde <em>paylaşımlı
kütüphaneler</em> veya <em>DSO kütüphaneleri</em> adı verilir ve
bunların dosyaları <code>libfilanca.so</code> veya
<code>libfilanca.so.1.2</code> biçiminde isimlendirilir. Belli bir
sistem dizininde (normalde <code>/usr/lib</code>) bulunurlar ve derleme
sırasında ilintileyici komutuna <code>-lfilanca</code> şeklinde
belirtilerek çalıştırılabilir programla ilintilenirler. Doğrudan
çalıştırılabilir koda eklenen bu kodlar Unix yükleyicisinin programın
başlatılması sırasında kütüphaneyi <code>/usr/lib</code> altında
<code>libfilanca.so</code> adıyla bulabilmesini sağlar. Kütüphanelerin
aranacağı yerler ya <code>-R</code> gibi bir ilintileyici seçeneği ile
koda eklenir ya da arama yolları <code>LD_LIBRARY_PATH</code> ortam
değişkeni aracılığıyla yapılandırılır. Böylece çalıştırılabilir
programda henüz çözümlenmemiş simgeler DSO içinde bulunarak
çözümlenebilir.</p>
<p>Çalıştırılabilir program içindeki simgelere normalde DSO içinden
atıfta bulunulmaz (genel kod kütüphanesinin başka programlarca da
kullanılması nedeniyle). Bu bakımdan DSO tarafında böyle bir çözümleme
yapılmaz. Çalıştırılabilir program da DSO’daki simgeleri kendisi
çözümlemeye uğraşmaz, bu işlemlerden tamamen Unix yükleyicisi
(<code>ld.so</code>) sorumludur. (Aslında, <code>ld.so</code>’yu
çağıracak kod, her çalıştırılabilir programın içine ilintilenmiş
(durağan değil) başlatma kodunun bir parçasıdır.) Programlar tarafından
ortaklaşa kullanılan kütüphanelerin devingen olarak yüklenmesinin sebebi
basittir: Kütüphane kodu <code>libc.so</code> gibi bir sistem
kütüphanesine bir kere kaydedilip disk alanından yer kazanılmış
olur.</p>
<p>İkinci yöntemde kullanılan DSO’lara yine <em>paylaşımlı
kütüphaneler</em> veya <em>DSO kütüphaneleri</em> adı verilir fakat
bunların dosyaları geçerli kabule göre <code>filanca.so</code> gibi
isimlendirilse de genelde keyfi olarak seçilen bir dosya uzantısı
kullanılarak isimlendirilirler. Bu dosyalar genellikle programa özel bir
dizinde dururlar ve bu dosyaları kullanacak olan çalıştırılabilir
programla aralarında özdevimli olarak bağ kurulmamıştır. Bunun yerine,
çalıştırılabilir program DSO’yu çalışma anında <code>dlopen()</code>
sayesinde kendi adres uzayına ekler. Çalıştırılabilir program için
DSO’daki simgeler bu sırada çözümlenmez. Özdevimli olarak devreye
giren Unix yükleyicisi, (varsa) artakalan simgeleri, çalıştırılabilir
ihraç edilen simge kümelerini (ve özellikle her yerde hazır ve nazır
<code>libc.so</code> içindeki tüm simgeleri) kullanarak çözümler. Bu
yolla DSO, çalıştırılabilir programın simge kümesi bilgilerini sanki
kendisine baştan durağan olarak ilintilenmiş gibi ulaşabilir.</p>
<p>Son olarak, DSO’nun programlama arayüzünün getirilerinden yararlanmak
amacıyla çalıştırılabilir program, daha sonra dağıtım tabloları vb.
yerlerde kullanmak üzere <code>dlsym()</code> üzerinden DSO’daki belli
simgeleri çözümlemek zorundadır. Başka bir deyişle: Çalıştırılabilir
program ihtiyaç duyduğu her simgeyi kullanmak için kendisi çözümleme
yapmak zorundadır. Böyle bir mekanizmanın getirisi, programın isteğe
bağlı parçalarının gerekli olana kadar yüklenmemesidir (böylece daha az
bellek alanı kullanılır). Gerektiği zaman programın işlevselliğini
arttırmak amacıyla bu parçalar devingen olarak programa
yüklenebilir.</p>
<p>DSO mekanizmasının bu basit gibi görünen işleyişinde zorluk içeren bir
adım şudur (başkaları da olabilir): Bir programın işlevselliğini
genişletmek için DSO kullanılırken (ikinci yöntem) çalıştırılabilir
programdan DSO için simgelerin çözümlenmesi. Zorluğun sebebi,
"tersine çözümleme" yapılmasıdır; çalıştırılabilir programın simge
kümesindeki DSO simgeleri kütüphane tasarımına aykırı bir şekilde
çözümlenir ve bu uygulama tüm platformlarda hazır olarak
desteklenmediği gibi standartlaşmış da değildir. Geçer uygulamada
çalıştırılabilir programın evrensel simgeleri çoğunlukla yeniden dışa
verilmez ve bu bakımdan bir DSO içinde kullanılmaları uygun değildir.
Esas sorun, çalıştırılabilir bir programın işlevselliğini çalışma
anında genişletmek için DSO kullanımı sırasında ilintileyicinin tüm
evrensel simgeleri dışa vermesini zorlamanın bir yolunu bulmaktır.</p>
<p>Paylaşımlı kütüphane yaklaşımı bu bakımdan türünün tek örneğidir,
çünkü DSO mekanizması özellikle bunun için tasarlanmıştır, dolayısıyla
işletim sisteminin sağladığı hemen hemen tüm kütüphaneler için
kullanılabilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="advantages" id="advantages">Getiriler ve Götürüler</a></h2>
<p>Yukarıda bahsedilen DSO’ya dayalı özelliklerin getirileri
şunlardır:</p>
<ul>
<li>Sunucu paketi çalışma anında daha esnektir çünkü, sunucuyu
oluşturan parçalar derleme sırasında <code class="program"><a href="./programs/configure.html">configure</a></code>
seçenekleriyle birleştirilmek yerine <code>httpd.conf</code> içinde
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> yönergeleri
sayesinde çalışma anında birleştirilebilmektedir. Bu yolla, örneğin
tek bir Apache kurulumuyla birbirinden farklı yapılandırmalara sahip
çok sayıda sunucu çalıştırmak mümkündür. (standart veya SSL sürümü;
basitleştirilmiş veya devingen sürümü [mod_perl, PHP3], vs.)</li>
<li>Sunucu paketi kurulumdan sonra bile üçüncü parti modüllerle kolayca
genişletilebilir. Bu özellikle, bir Apache temel paketinin yanında
PHP, mod_perl, mod_security gibi ek paketler oluşturan paket
dağıtıcılarına büyük yarar sağlar.</li>
<li>Yeni Apache httpd modülleri için daha kolay prototip
geliştirilebilir: Modül kaynak kodunu DSO/<code class="program"><a href="./programs/apxs.html">apxs</a></code> çifti
sayesinde Apache httpd kaynak ağacının dışında derleyip modülün yeni
bir sürümünü bir <code>apxs -i</code> komutunun ardından
<code>apachectl restart</code> yaparak çalışan bir Apache HTTP
Sunucusunda denemek daha kolay hale getirilmiştir.</li>
</ul>
<p>DSO kullanımının götürüleri ise şunlardır:</p>
<ul>
<li>İlk yüklemede %20 yavaşlama: Unix yükleyicisi simgeleri çözümlemek
zorunda olduğundan sunucu ilk başlatılırken yaklaşık %20 daha yavaş
faaliyete geçer.</li>
<li>Çalışma sırasında % 5 yavaşlama: Konumdan bağımsız kodun (PIC -
Position Independent Code) göreli adresleme için karmaşık oyunlara
girmesi ve bunun mutlak adresleme kadar hızlı olmaması nedeniyle
sunucu bazı platformlarda çalışma anında yaklaşık %5 daha yavaş
çalışabilir.</li>
<li>DSO'nun tüm modüller için uygun olmaması: DSO modülleri bazı
platformlarda diğer DSO temelli kütüphanelerle ilintilenemediğinden
(<code>ld -lfilanca</code>) DSO mekanizmasını tüm modül türleri için
kullanamazsınız (örneğin a.out temelli platformlar bu işlevselliği
ELF temelli platformlar kadar iyi sağlamaz). Başka bir deyişle, DSO
dosyaları olarak derlenmiş modüllerin kullanabileceği simgeler ya
Apache httpd temel kodunda vardır ya Apache httpd temel kodunun
kullandığı C kütüphanesinde (<code>libc</code>) ve diğer durağan ve
devingen kütüphanelerde vardır ya da konumdan bağımsız kodu içeren
durağan kütüphane arşivlerinde (<code>libfilanca.a</code>)
vardır. Diğer modülleri kullanmak için tek şansınız ya Apache httpd
çekirdeğinin modüle bir atıf içermesini sağlamak ya da modül kodunu
<code>dlopen()</code> vasıtasıyla yüklemektir.</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dso.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dso.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/dso.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/dns-caveats.html.ja.utf8 0000664 0001751 0001751 00000042576 14743132254 021426 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>DNS と Apache にまつわる注意事項 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>DNS と Apache にまつわる注意事項</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./en/dns-caveats.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dns-caveats.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dns-caveats.html" title="Japanese"> ja </a> |
<a href="./ko/dns-caveats.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dns-caveats.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>本文書の内容は次の一言に尽きます。「Apache が設定ファイルを読み込むときに
DNS を使用する必要がないようにして下さい」。Apache が設定ファイルを
読み込むときに DNS を使用する必要がある場合、信頼性の問題
(起動しないかもしれません) やサービス拒否や盗用アタック
(他のユーザからヒットを盗むことを含みます)
の問題に直面するかもしれません。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#example">簡単な例</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#denial">サービス拒否</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#main">「主サーバ」アドレス</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#tips">以上の問題を解決する方法</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#appendix">付録: 将来的な方向性</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="example" id="example">簡単な例</a></h2>
<div class="example"><p><code>
<VirtualHost www.abc.dom> <br />
ServerAdmin webgirl@abc.dom <br />
DocumentRoot /www/abc <br />
</VirtualHost>
</code></p></div>
<p>Apache が正常に機能するには、バーチャルホスト毎に必ず二つの
情報が必要になります。それは、
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
と、そのサーバが応答するための IP (最低一つ) です。
上記例では IP アドレスを含んでいませんので、Apache は DNS
を使用して <code>www.abc.dom</code> を見つけなければなりません。
何らかの理由で設定ファイルを読み込んでいるときに DNS
が利用できなかった場合、
バーチャルホストは<strong>設定されません</strong>。
そして、そのバーチャルホストに対するヒットには応答がなされません
(Apache 1.2 以前では起動すらしません)。</p>
<p><code>www.abc.dom</code> のアドレスが 192.0.2.1
だとします。では、次の設定について考えてみましょう。</p>
<div class="example"><p><code>
<VirtualHost 192.0.2.1> <br />
ServerAdmin webgirl@abc.dom <br />
DocumentRoot /www/abc <br />
</VirtualHost>
</code></p></div>
<p>現在のリリースでは Apache は DNS 逆引きを使用して
このバーチャルホストの <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
を見つけます。
その逆引きが失敗した場合は部分的にバーチャルホストを無効にします
(Apache 1.2 より前では起動すらしません)。
バーチャルホストが名前ベースであれば完全に無効になりますが、
IP ベースであれば概ね動作します。しかしながら、サーバ名を
含む完全な URL を生成しなければならない場合は、正しい URL
の生成ができません。</p>
<p>次の例は上記の問題を解決しています。</p>
<div class="example"><p><code>
<VirtualHost 192.0.2.1> <br />
ServerName www.abc.dom <br />
ServerAdmin webgirl@abc.dom <br />
DocumentRoot /www/abc <br />
</VirtualHost>
</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="denial" id="denial">サービス拒否</a></h2>
<p>サービス拒否が起こる場合、(少なくとも) 二つのケースがあります。
Apache 1.2 より前を実行している場合、バーチャルホストのための
上記の二つの DNS 検索のうち一つ失敗すれば起動すらしません。
そしてこの DNS 検索が自分の制御下にすらない場合もありえます。
例えば、<code>abc.dom</code> が顧客のサーバの一つで、
DNS は顧客自身で管理している場合、単に
<code>www.abc.dom</code> レコードを削除するだけで、
(1.2 より前の) サーバを起動不能にすることができます。</p>
<p>もう一つのケースは、より気付きにくいものです。
次の設定について考えてみましょう。</p>
<div class="example"><p><code>
<VirtualHost www.abc.dom> <br />
<span class="indent">
ServerAdmin webgirl@abc.dom <br />
DocumentRoot /www/abc <br />
</span>
</VirtualHost> <br />
<br />
<VirtualHost www.def.dom> <br />
<span class="indent">
ServerAdmin webguy@def.dom <br />
DocumentRoot /www/def <br />
</span>
</VirtualHost>
</code></p></div>
<p>192.0.2.1 を <code>www.abc.dom</code> に、
192.0.2.2 を <code>www.def.dom</code> に割り当てているとします。
また、<code>def.dom</code> は顧客自身の DNS
の制御下にあるとします。この設定で、<code>abc.dom</code>
に向けられたトラフィック全てを奪うことができる位置に
<code>def.dom</code> を設置できています。後は単に
<code>www.def.dom</code> が 192.0.2.1 を参照するように
設定するだけです。DNS は顧客側の DNS でコントロールされているので、
<code>www.def.dom</code> レコードが好きな場所を指すように
設定できてしまうのを止めさせることができません。</p>
<p>192.0.2.1 に対するリクエスト
(<code>http://www.abc.dom/whatever</code> 形式の URL
を入力したユーザからのもの全てを含みます)
は、<code>def.dom</code> バーチャルホストで応答されます。
このようなことが何故起こるかもっと良く知るためには、
応答の必要なバーチャルホストへのリクエストに対して、
Apache がどのように整合性を確保するかについて、
深い議論が必要になります。おおざっぱな説明は<a href="vhosts/details.html">こちら</a>に記述されています。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="main" id="main">「主サーバ」アドレス</a></h2>
<p>Apache 1.1 での <a href="vhost/name-based.html">名前ベースのバーチャルホストのサポート</a> 追加の際に、
Apache は <code class="program"><a href="./programs/httpd.html">httpd</a></code> の実行されているホストの IP
アドレスを知る必要が出てきました。このアドレスを得るために、
(もしあれば) グローバルな
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> を使用するか、
C 言語の関数 <code>gethostname</code> (コマンドプロンプトで
<code>hostname</code> とタイプしたときと同じものを返します)
を呼び出すかをします。
その後、得られたアドレスで DNS 検索を行ないます。
現在のところ、この DNS 検索を回避する方法はありません。</p>
<p>DNS サーバがダウンして、この検索ができない事態が起こることを
恐れているのであれば、<code>/etc/hosts</code>
にホスト名を記述しておくことができます
(マシンが正常に起動するように既に設定されているかもしれません)。
その場合、DNS 参照が失敗した場合にマシンが <code>/etc/hosts</code>
を使用するように設定していることを確認してください。
その方法は、どの OS を使用しているかに依存しますが、
<code>/etc/resolv.conf</code> か <code>/etc/nsswitch.conf</code>
を編集することで設定できます。</p>
<p>もし他の理由で DNS を利用する必要がない場合は、
<code>HOSTRESORDER</code> 環境変数を「 <code>local</code>
」に設定することでそのようにできます。以上これらの事柄は、どんな
OS 、レゾルバライブラリを使用しているかに依存します。また、
<code class="module"><a href="./mod/mod_env.html">mod_env</a></code> を使用して環境変数を制御しない限り、
CGI にも影響を与えます。man ページや使用している OS
の FAQ で調べると良いでしょう。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="tips" id="tips">以上の問題を解決する方法</a></h2>
<ul>
<li>
<code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code>
で IP アドレスを使用する。
</li>
<li>
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
で IP アドレスを使用する。
</li>
<li>
全てのバーチャルホストが明示的に
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
を持つようにする。
</li>
<li>何も応答しない
<code><VirtualHost _default_:*></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="appendix" id="appendix">付録: 将来的な方向性</a></h2>
<p>DNS に関して、現状は全く宜しくありません。Apache 1.2 で、
DNS のイベントが失敗しても少なくとも起動プロセスが続くようにしましたが、
これが最高の解決方法ではないでしょう。アドレスの再割り当てが必要不可避
となっている今日のインターネットにおいては、
設定ファイルの中で明示的な IP アドレスを要求する仕様は、
全く宜しくありません。</p>
<p>盗用のサービスアタックに関して行なうべき事は、
DNS 順引きを行なって得られたアドレスに対する DNS
逆引きを行なって、二つの名前を比較することです。
この二つが一致しなければバーチャルホストは無効になるようにします。
こうするためには逆引き DNS が適切に設定されている必要があります
(FTP サーバや TCP ラッパーのおかげで「二重逆引き」DNS は一般的に
なっていますので、管理者にはお馴染みものでしょう)。</p>
<p>IP アドレスが使用されていなくて DNS が失敗した場合は、
どうしてもバーチャルホストウェブサーバを信頼性を確保して
起動させることは不可能のようです。
設定の一部を無効にするというような部分的な解決では、
サーバが何をするようにするかにもよりますが、
そのサーバが起動しないより確実に悪い状況になるでしょう。</p>
<p>HTTP/1.1 が開発され、ブラウザやプロキシが <code>Host</code>
ヘッダを発行するようになったので、IP ベースのバーチャルホストを
全く使用しなくても済むようになるかもしれません。
この場合、ウェブサーバは設定中に DNS 参照をしなくても済みます。
しかし 1997 年 3 月時点の状況では、
商用レベルのウェブサーバで使用できるほどには、
これらの機能は広く開発が進んでいません。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./en/dns-caveats.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dns-caveats.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dns-caveats.html" title="Japanese"> ja </a> |
<a href="./ko/dns-caveats.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dns-caveats.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/dns-caveats.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/dso.html.ko.euc-kr 0000664 0001751 0001751 00000041136 14743132254 020311 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ü (DSO) - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>ü (DSO) </h1>
<div class="toplang">
<p><span> : </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dso.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dso.html" title="Korean"> ko </a> |
<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>ġ ڰ Ͽ
ִ ȭ α̴. Ҷ
<code>httpd</code> Ͽ
ִ. ƴϸ <code>httpd</code> ϰ
иϿ ü(Dynamic Shared Objects, DSO)
ִ. DSO Ҷ ϰų, Apache
Extension Tool (<a href="programs/apxs.html">apxs</a>)
Ͽ ߿ Ͽ ߰ ִ.</p>
<p> DSO ̷ Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#implementation"></a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#usage"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#background"></a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#advantages"></a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="implementation" id="implementation"></a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>ġ ٽɿ ؾ
<code class="module"><a href="./mod/mod_so.c.html">mod_so.c</a></code> ġ
о̱ DSO Ѵ.
<code class="module"><a href="./mod/core.html">core</a></code> ϰ DSO
̴. ٸ ġ
<a href="install.html">ġ </a>
<code>configure</code> <code>--enable-<em>module</em>=shared</code>
ɼ Ͽ DSO ִ.
<code>mod_foo.so</code> DSO <code>httpd.conf</code>
Ͽ <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> ɾ
Ͽ ۽ Ȥ ۽ о
ִ.</p>
<p>ġ (Ư ڰ ) DSO
<a href="programs/apxs.html">apxs</a> (<em>APache
eXtenSion</em>) ο α ִ. α
ġ ҽ Ʈ <em>ۿ</em> DSO
Ҷ Ѵ. . ġ ġҶ
<code>configure</code> <code>make install</code>
ġ C ġϰ, DSO ϱ
÷ Ư Ϸ ɼǰ Ŀ ɼ <code>apxs</code>
α Ѵ. <code>apxs</code> ϴ ڴ
ġ ҽ Ʈ, DSO ÷ Ư
Ϸ ɼǿ Ŀ ɼǿ Ű ʰ ڽ ġ
ҽ ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="usage" id="usage"> </a></h2>
<p>Apache 2.2 DSO ɿ ª ̴:</p>
<ol>
<li>
<em> ִ</em> ġ ϰ ġϴ
. <code>mod_foo.c</code> DSO
<code>mod_foo.so</code>:
<div class="example"><p><code>
$ ./configure --prefix=/path/to/install --enable-foo=shared<br />
$ make install
</code></p></div>
</li>
<li>
<em>ڰ </em> ġ ϰ ġϴ
. <code>mod_foo.c</code> DSO
<code>mod_foo.so</code>:
<div class="example"><p><code>
$ ./configure --add-module=module_type:/path/to/3rdparty/mod_foo.c --enable-foo=shared<br />
$ make install
</code></p></div>
</li>
<li>
<em>߿ ϱ</em> ġ ϴ
:
<div class="example"><p><code>
$ ./configure --enable-so<br />
$ make install
</code></p></div>
</li>
<li>
<em>ڰ </em> ġ ϰ ġϴ
. <a href="programs/apxs.html">apxs</a> Ͽ
ġ ҽ Ʈ <em>ۿ</em> <code>mod_foo.c</code>
DSO <code>mod_foo.so</code>:
<div class="example"><p><code>
$ cd /path/to/3rdparty<br />
$ apxs -c mod_foo.c<br />
$ apxs -i -a -n foo mod_foo.la
</code></p></div>
</li>
</ol>
<p> ϴ ϵǸ, <code>httpd.conf</code>
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> þ
Ͽ ġ о̰ .</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="background" id="background"></a></h2>
<p> н <em>ü</em> (DSO)
ŷ/ε(dynamic linking/loading)̶ Ͽ, Ư
ڵ α
ּҰ о̴ ִ.</p>
<p> ΰ о ִ. ϳ α
Ҷ <code>ld.so</code> ý α ڵ
о̴ , ٸ ϳ α
<code>dlopen()/dlsym()</code> ýȣ н δ(loader)
ý ̽ Ͽ о̴ .</p>
<p>ù° DSO <em>̺귯(shared libraries)</em>
Ȥ <em>DSO ̺귯</em> θ,
<code>libfoo.so</code> <code>libfoo.so.1.2</code>
̸ . ̵ ý 丮( <code>/usr/lib</code>)
ְ, Ͻ Ŀ ɾ <code>-lfoo</code> ־
ϰ Ѵ. ̷ ̺귯 Ͽ
ǿ, α Ҷ Ŀ ɼ <code>-R</code>
, ȯ溯 <code>LD_LIBRARY_PATH</code>
Ȥ <code>/usr/lib</code> н δ
<code>libfoo.so</code> ã ִ. α
( ã(unresolved)) ɺ(symbol) DSO ãԵȴ.</p>
<p>DSO α ɺ ãʱ (DSO
밡 Ϲ ڵ ̺귯̹Ƿ) ã ⼭
. н δ ɺ ã⸦ ϹǷ α
DSO ɺ ã ʿ䰡 . ( <code>ld.so</code>
θ ڵ ƴ α ũǴ
ڵ Ϻδ.) ̺귯 ڵ带 о̴
Ȯϴ. ̺귯 ڵ尡 α ߺؼ
Ǵ <code>libc.so</code> ý ̺귯
ѹ DZ ũ ȴ.</p>
<p>ι° DSO <em>ü(shared objects)</em>
Ȥ <em>DSO </em>̶ θ, (Ģ ̸
<code>foo.so</code>) Ȯڴ Ӵ.
ϵ α ü 丮 ġϰ α
ڵ ʴ´. α
<code>dlopen()</code> Ͽ DSO ּҰ
о鿩 Ѵ. ̶ α DSO ɺ
ã ʴ´. տ н δ ڵ ϰ
̹ о DSO ̺귯(Ư ϴ
<code>libc.so</code> ɺ) DSO ( ã)
ɺ ã´. DSO ġ ó α
ũȰͰ ɺ ˰Եȴ.</p>
<p>DSO API ̿ϱؼ α
<code>dlsym()</code> DSO Ư ɺ ãƼ,
ϱ ġ(dispatch) ǥ <em></em> Ѵ.
ٸ α Ǻ ãƾѴ.
̷ α Ϻθ α
ʿҶ о ʾƵ (
ʰ) ȴٴ ̴. ⺻ α Ȯϱ
ʿ κ о ִ.</p>
<p>̷ DSO ڿ , ּ
Ѱִ. α Ȯϱ DSO Ҷ DSO
α ɺ ã ̴. ? DSO α
ɺ " ã " (̺귯 ڽ ϴ α
ٴ) ̺귯 迡 ϸ, ÷
ʰ ǥȭ ʾұ ̴.
ɺ(global symbol) ͽƮ(export) ʱ
DSO . DSO Ͽ α ȮϷ
Ŀ ɺ ͽƮϵ ϴ ֵ
ذå̴.</p>
<p>̺귯 DSO Ģ ̱
ü ϴ ̺귯 Ѵ.
ݴ α α Ȯϱ ü
ʴ´.</p>
<p>1998 Ȯϱ DSO
Ʈ Ű (XS DynaLoader )
Perl 5, Netscape Server <em></em> 幰. ġ
̹ Ȯϱ ߰ ܺ
ġ ٽɱɿ ϱ ġ
̿ ٹ ߱ 1.3 뿭 շߴ.
ġ о̴µ DSO ϵ
.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="advantages" id="advantages"></a></h2>
<p>տ DSO ϸ ִ:</p>
<ul>
<li> μ Ͻ <code>configure</code>
ɼǴ <code>httpd.conf</code> <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> Ͽ ߿
յǹǷ Ű ϴ. ѹ
ġ ġ ٸ (ǥ SSL , ּȭ
߰ [mod_perl, PHP3] <em></em>)
ִ.</li>
<li> ġĿ ڰ Ͽ
Ȯ ִ. ּ Ű ڴ ġ ٽ
Ű PHP3, mod_perl, mod_fastcgi <em></em>
߰ Ű ־ ū ̵̴.</li>
<li>DSO <code>apxs</code> ġ ҽ Ʈ ۿ
۾ϰ <code>apxs -i</code> <code>apachectl restart</code>
ɾ ġ
ݿ ־ ġ
ִ.</li>
</ul>
<p>DSO ִ:</p>
<ul>
<li>α ּҰ ڵ带 о̴
ʴ ü ֱ ÷ DSO
.</li>
<li>н δ ɺ ãƾϱ
20% ʾ.</li>
<li> ġڵ(position independent code, PIC)
ּ(absolute addressing)
ּ(relative addressing)
ʿϹǷ ÷ 5% ʴ.</li>
<li>DSO ٸ DSO ̺귯(<code>ld -lfoo</code>)
ũ ÷ ֱ ( ELF
÷ a.out ÷
ʴ´) DSO .
ٸ DSO Ϸ ϴ ġ ٽɰ ġ
ٽ ϴ C ̺귯(<code>libc</code>) ٸ
/ ̺귯, ġڵ带 ִ ̺귯
ī̺(<code>libfoo.a</code>) ɺ ִ.
ٸ ڵ带 Ϸ ġ ٽ װ ϴ,
<code>dlopen()</code> ڵ带 о鿩 Ѵ.</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dso.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dso.html" title="Korean"> ko </a> |
<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/dso.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/suexec.html 0000664 0001751 0001751 00000000720 13710016232 017203 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: suexec.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: suexec.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: suexec.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: suexec.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: suexec.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/filter.html.ja.utf8 0000664 0001751 0001751 00000022354 14743132254 020473 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>フィルタ - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>フィルタ</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./en/filter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/filter.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/filter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/filter.html" title="Japanese"> ja </a> |
<a href="./ko/filter.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/filter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>Apache でのフィルタの使い方について記述しています。</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="filters" id="filters">フィルタ</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilteroptions">ExtFilterOptions</a></code></li><li><code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code></li><li><code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code></li></ul></td></tr></table>
<p><em>フィルタ</em> とは、サーバが送受信したデータに
適用される処理プロセスのことをいいます。クライアントからサーバに
送られたデータは <em>入力フィルタ</em> によって、サーバから
クライアントに送られるデータは<em>出力フィルタ</em>によって
処理されます。複数のフィルタを適用することができ、
その順番を厳密に指定することもできます。</p>
<p>Apache 内部では、チャンク (データのぶつ切り) を行ったり、
バイト範囲の指定されたリクエストを扱ったりといった機能を
行う際に、フィルタが使われています。それに加えて、
実行時の設定ディレクティブで選択が可能なフィルタを
モジュールが提供できます。
データに適応されるフィルタのセットは、
<code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code>,
<code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code>,
<code class="directive"><a href="./mod/core.html#addinputfilter">AddInputFilter</a></code>,
<code class="directive"><a href="./mod/core.html#addoutputfilter">AddOutputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code>
ディレクティブで制御できます。</p>
<p>現行の Apache HTTP サーバの配布では、
次のユーザ選択可能なフィルタが提供されています。</p>
<dl>
<dt>INCLUDES</dt>
<dd><code class="module"><a href="./mod/mod_include.html">mod_include</a></code> で Server-Side Include をします。</dd>
<dt>DEFLATE</dt>
<dd><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>
を使って、クライアントに送信する前に出力を圧縮します。</dd>
</dl>
<p>また、<code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> モジュールで
外部プログラムをフィルタとして指定することができます。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./en/filter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/filter.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/filter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/filter.html" title="Japanese"> ja </a> |
<a href="./ko/filter.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/filter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/filter.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/env.html.tr.utf8 0000664 0001751 0001751 00000101513 14743132254 020024 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache’de Ortam Değişkenleri - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache’de Ortam Değişkenleri</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/env.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/env.html" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Bu çeviri güncel olmayabilir. Son değişiklikler için İngilizce sürüm geçerlidir.</div>
<p>Apache HTTP Sunucusunu etkileyen ortam değişkenleri iki çeşittir.</p>
<p>İlki, işletim sisteminin denetimindeki ortam değişkenleridir. Bu
değişkenlere değer atama işlemi sunucu başlatılmadan önce yapılır.
Bunlar yapılandırma dosyalarının içinde kullanılabilir. Ayrıca,
istenirse PassEnv yönergesi kullanılarak bunlar CGI betiklerine ve
SSI sayfalarına da aktarılabilir.</p>
<p>İkincisi ise, Apache HTTP Sunucusunun kendi ortam değişkenleridir.
Bu değişkenlerde saklanan bilgi erişim denetimi, günlük kaydı gibi
çeşitli işlemleri denetlemekte kullanılabilir. Değişkenler ayrıca, CGI
betikleri gibi harici uygulamalarla iletişim mekanizması olarak da
kullanılabilir. Bu belgede bu değişkenler üzerindeki işlemlere ve
kullanım şekillerine değinilmiştir.</p>
<p>Bu değişkenlere <em>ortam değişkenleri</em> dense de işletim sisteminin
ortam değişkenleri gibi değillerdir. Bunlar sadece Apache ortamında
geçerli değişkenler olup işletim sisteminin bu değişkenlerden haberi
olmaz. Sadece CGI betikleri ve SSI sayfaları gibi harici uygulamalar
tarafından üretilen ortam değişkenleri sistem ortamının değişkenleri
haline gelirler. İşletim sistemi ortamına çalışmakta olan sunucudan
müdahale etmek isterseniz işletim sisteminizin kabuğu tarafından sağlanan
standart ortam müdahale mekanizmalarını kullanmalısınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#setting">Ortam Değişkenlerinin Atanması</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Ortam Değişkenlerinin Kullanımı</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#special">Özel Amaçlı Ortam Değişkenleri</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Örnekler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="setting" id="setting">Ortam Değişkenlerinin Atanması</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr></table>
<h3><a name="basic-manipulation" id="basic-manipulation">Temel Ortamda Değişiklik</a></h3>
<p>Apache ortamında bir ortam değişkenine müdahale etmenin en temel
yolu hiçbir koşula tabi olmayan <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> yönergesini kullanmaktır. Bu değişkenleri Apache
başlatılırken sistem ortam değişkenleri haline getirmek için
<code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> yönergesi
kullanılabilir.</p>
<h3><a name="conditional" id="conditional">İsteğe Bağlı Şartlı Atamalar</a></h3>
<p>Esnekliği arttırmak için, <code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> modülü ile
isteğin özelliklerine uygun olarak her isteğe özel değişkenler
atayabilmek mümkün kılınmıştır. Örneğin, bir değişken sadece isteği
yapan tarayıcıya özgü bir değerle veya sadece belli bir başlık
alanınına bağlı olarak atanabilir. Daha da esnek bir mekanizma,
ortam değişkeni atamak için <code>[E=...]</code> seçeneğinin
kullanıldığı <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> modülünün <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> yönergesi ile
sağlanmıştır.</p>
<h3><a name="unique-identifiers" id="unique-identifiers">Eşsiz Betimleyiciler</a></h3>
<p>Son olarak, <code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code> <code>UNIQUE_ID</code>
ortam değişkenine her istek için o isteğin çok özel koşullar altında
tüm diğer istekler arasında eşsizliğini garanti edecek bir değer
atar.</p>
<h3><a name="standard-cgi" id="standard-cgi">Standart CGI Değişkenleri</a></h3>
<p>Apache yapılandırmasıyla atanan ve kabuğa aktarılan ortam
değişkenlerinden başka <a href="http://www.ietf.org/rfc/rfc3875">CGI
Belirtimi</a>nin gerektirdiği istekler hakkında temel bilgileri
içeren ortam değişkenlerinin CGI betikleri ve SSI sayfalarınca
atanabilmesi sağlanmıştır.</p>
<h3><a name="caveats" id="caveats">Bazı Yetersizlikler</a></h3>
<ul>
<li>Standart CGI değişkenlerini ortam değişkenlerine müdahale
yönergelerini kullanarak değiştirmek veya geçersiz kılmak mümkün
değildir.</li>
<li>CGI betiklerini çalıştırmak için <code class="program"><a href="./programs/suexec.html">suexec</a></code>
kullanıldığında ortam, CGI betikleri çalıştırılmadan önce
<em>güvenilir</em> değişkenler kalacak şekilde temizlenir.
<em>Güvenilir</em> değişken listesi <code>suexec.c</code> içinde
derleme sırasında tanımlanır.</li>
<li>Taşınabilirlik adına, ortam değişkenlerinin isimleri sadece
harfler, rakamlar ve alt çizgi imlerini içerebilir. Bunlara ek
olarak ismin ilk karakteri bir rakam olmamalıdır. Değişkenler CGI
betiklerine ve SSI sayfalarına aktarılırken bu sınırlamalara uygun
olmayan karakterlerin yerlerine alt çizgi imleri konur.</li>
<li>Bir özel durum, CGI betiklerine ve benzerlerine ortam
değişkenleri üzerinden aktarılan HTTP başlıklarıdır (aşağıya
bakın). Bunlar büyük harfe dönüştürülür ve sadece tireler
altçizgilere dönüştürülür. Eğer HTTP başlığı geçersiz karakter
içeriyorsa başlığın tamamı yoksayılır. Böyle bir durumda ne
yapılacağı öğrenmek için <a href="#fixheader">aşağıya</a>
bakın.</li>
<li>İsteklerin işleme konması sırasında <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> yönergesi geç çalıştırılır,
yani <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> ve
<code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> gibi
yönergeler <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> ile
atanan değişken değerlerini görmezler.</li>
<li><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code> ile dizin listesi oluşturulması
veya bir <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>
için yol aranması gibi bir dahili <a class="glossarylink" href="./glossary.html#subrequest" title="sözlüğe bakınız">alt
istek</a> için sunucu yol araması yaparken isteklere özgü
ortam değişkenleri alt istekler tarafından miras alınMAZ. Buna ek
olarak, <code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> modülünün devreye girdiği API
fazlarından dolayı yapılan alt isteklerde
<code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> yönergeleri
ayrı ayrı değerlendirilMEZ.</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="using" id="using">Ortam Değişkenlerinin Kullanımı</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</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_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code></li><li><code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr></table>
<h3><a name="cgi-scripts" id="cgi-scripts">CGI Betikleri</a></h3>
<p>Ortam değişkenlerinin başlıca amaçlarından biri CGI betikleriyle
iletişim kurmaktır. Yukarıda bahsedildiği gibi CGI betiklerine
aktarılan ortam Apache yapılandırmasında atanan değişkenlere ek
olarak istek hakkında standart temel bilgileri de içerir. Bu konuda
ayrıntılı bilgi edinmek için <a href="howto/cgi.html">CGI
Öğreticisi</a>ne bakabilirsiniz.</p>
<h3><a name="ssi-pages" id="ssi-pages">SSI Sayfaları</a></h3>
<p>Sunucu tarafında <code class="module"><a href="./mod/mod_include.html">mod_include</a></code> modülünün
<code>INCLUDES</code> süzgeci ile yorumlanan SSI sayfalarında ortam
değişkenleri <code>echo</code> elemanı ile basılabilir ve sayfayı
isteğin özelliklerine uygun olarak oluşturmak için ortam
değişkenleri akış denetim elemanları içinde kullanılabilir. Apache
ayrıca, yukarıda bahsedildiği gibi standart CGI ortam değişkenli SSI
sayfalarını da sağlayabilmektedir. Daha ayrıntılı bilgi edinmek için
<a href="howto/ssi.html">SSI Öğreticisi</a>ne bakabilirsiniz.</p>
<h3><a name="access-control" id="access-control">Erişim Denetimi</a></h3>
<p><code>Require env</code> ve <code>Require not env</code>
yönergeleri sayesinde ortam değişkenlerine dayalı olarak sunucuya
erişim denetim altında tutulabilir. Bunlar <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> yönergesi ile birlikte
kullanılmak suretiyle sunucuya erişim isteğin özelliklerine bağlı
olarak daha esnek bir tarzda denetlenebilir. Örneğin, belli bir
tarayıcının sunucuya erişimi bu yönergelerle engellenebilir.</p>
<h3><a name="logging" id="logging">Şartlı Günlük Kaydı</a></h3>
<p>Ortam değişkenleri <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> yönergesinin <code>%e</code> seçeneği
kullanılarak erişim günlüğüne kaydedilebilir. Bundan başka,
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> yönergesi
sayesinde isteklerin günlüğe kaydedilip kaydedilmeyeceğine ortam
değişkenlerine dayalı olarak karar verilmesi sağlanabilir. Bunlar
<code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> yönergesi ile
birlikte kullanılmak suretiyle günlük kayıtları isteğin
özelliklerine bağlı olarak daha esnek bir tarzda denetlenebilir.
Örneğin, <code>gif</code> uzantılı dosyalar için yapılan isteklerin
günlüğe kaydedilmemesi veya sadece alt ağınızın dışından gelen
isteklerin günlüğe kaydedilmesini isteyebilirsiniz.</p>
<h3><a name="response-headers" id="response-headers">Şartlı Yanıt Başlıkları</a></h3>
<p><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code> yönergesi belli
bir yanıt başlığının istemciye gönderilip gönderilmeyeceğine belli
bir ortam değişkeninin varlığına bakarak karar vermek için
kullanılabilir. Böylece örneğin, belli bir başlığın istemciye
gönderilmesine istemciden belli bir başlığın alınıp alınmadığına
bağlı olarak karar verilebilir.</p>
<h3><a name="external-filter" id="external-filter">Harici Süzgeçlerin Etkinleştirilmesi</a></h3>
<p><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> tarafından yapılandırılan harici
süzgeçler <code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code> yönergesinin <code>disableenv=</code> ve
<code>enableenv=</code> seçenekleri kullanılarak bir ortam
değişkenine bağlı olarak etkinleştirilebilir.</p>
<h3><a name="url-rewriting" id="url-rewriting">URL Kurgulaması</a></h3>
<p><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
yönergesinin <em>SınamaDizgesi</em> olarak kullanılan
<code>%{ENV:<em>değişken</em>}</code> biçemi
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> yeniden yazma motorunun ortam
değişkenlerine bağlı kararlar almasını mümkün kılar. Yalnız şuna
dikkat ediniz: <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>’ta <code>ENV:</code>
öneki kullanılmadan belirtilen değişkenler ortam değişkenleri
değillerdir. Onlar <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>’a özgü diğer
modüllerden erişilemeyen özel değişkenlerdir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="special" id="special">Özel Amaçlı Ortam Değişkenleri</a></h2>
<p>Birlikte çalışabilirlik sorunları Apache’nin belli istemcilerle
veri alışverişi sırasında davranışını değiştirmesini gerektirebilir.
Genellikle <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> ve
<code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> yönergelerinden
başka <code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>
gibi yönergelerle ortam değişkenleri atanarak bunu sağlayan
mekanizmaların olabildiğince esnek davranabilmesi sağlanabilir.</p>
<h3><a name="downgrade" id="downgrade"><code>downgrade-1.0</code></a></h3>
<p>İstek, daha yüksek bir HTTP protokolüyle yapılmış olsa bile
HTTP/1.0 isteği olarak ele alınır.</p>
<h3><a name="force-gzip" id="force-gzip"><code>force-gzip</code></a></h3>
<p><code>DEFLATE</code> süzgeci etkinse tarayıcının tercih ettiği
kodlama koşulsuz olarak yoksayılarak sıkıştırılmış çıktı
gönderilir.</p>
<h3><a name="force-no-vary" id="force-no-vary"><code>force-no-vary</code></a></h3>
<p>İstemciye gönderilmeden önce yanıttan <code>Vary</code> alanının
çıkarılmasına sebep olur. Bazı istemciler bu alanı gerektiği gibi
yorumlayamazlar, bu değişken atanarak bu sorunla karşılaşılmamaya
çalışılır. Bu değişkenin atanması ayrıca
<strong>force-response-1.0</strong> değişkeninin de atanmasına sebep
olur.</p>
<h3><a name="force-response" id="force-response"><code>force-response-1.0</code></a></h3>
<p>HTTP/1.0 isteği yapan istemcilere HTTP/1.0 yanıtı verilmesini zorunlu
kılar. AOL vekillerindeki bir sorun nedeniyle gerçeklenmiştir. Bazı
HTTP/1.0 istemciler HTTP/1.1 yanıtlarında doğru davranmayabilirler; bu
değişken atanarak bunların sorunları giderilebilir.</p>
<h3><a name="gzip-only-text-html" id="gzip-only-text-html"><code>gzip-only-text/html</code></a></h3>
<p>Bu değişkene "1" değeri atandığında <code>text/html</code>’den
farklı içerik türleri için <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> modülü
tarafından sağlanan <code>DEFLATE</code> çıktı süzgeci iptal
edilir. Sıkıştırılmış olarak saklanan dosyalar kullanıyorsanız bu
değişkeni <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> modülü de dikkate alır
(kimliğine bakarak sadece gzip için değil, tüm kodlamalar için bunu
yapar).</p>
<h3><a name="no-gzip" id="no-gzip"><code>no-gzip</code></a></h3>
<p>Bu değişken atandığında, <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> modülünün
<code>DEFLATE</code> süzgeci kapatılır ve
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> modülü kodlanmış kaynak teslimatını
reddeder.</p>
<h3><a name="no-cache" id="no-cache">no-cache</a></h3>
<p><em>2.2.12 sürümünden beri kullanılabilmektedir.</em></p>
<p>Atandığı takdirde, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> artık
önbelleklenebilecek yanıtları kaydetmeyecektir. Bu ortam değişkeni bir
yanıtın halihazırda mevcut bir isteğe sunulmak üzere önbellekte olup
olmadığından etkilenmez.</p>
<h3><a name="nokeepalive" id="nokeepalive"><code>nokeepalive</code></a></h3>
<p>Bu değişken atandığında, <code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code> yönergesi iptal edilir.</p>
<h3><a name="prefer-language" id="prefer-language"><code>prefer-language</code></a></h3>
<p>Değer olarak <code>en</code>, <code>ja</code> veya
<code>x-klingon</code> gibi bir dil kısaltması verilerek atanmışsa
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> modülünün normal davranışını
değiştirerek belirtilen dilde bir teslimat yapılmaya çalışılır.
Böyle bir belge yoksa normal <a href="content-negotiation.html">uzlaşım</a> süreci uygulanır.</p>
<h3><a name="redirect-carefully" id="redirect-carefully"><code>redirect-carefully</code></a></h3>
<p>İstemciye bir yönlendirme gönderirken sunucuyu daha dikkatli olmaya
zorlar. Bu genellikle istemcinin yönlendirmeler konusunda sorunlu
olduğu bilindiği takdirde yararlı olur. Bu değişkenin gerçeklenme
sebebi, dizin kaynaklarına yönlendirmeler için DAV yöntemlerini
kullanan Microsoft'un WebFolders yazılımındaki bir sorundur.</p>
<h3><a name="suppress-error-charset" id="suppress-error-charset"><code>suppress-error-charset</code></a></h3>
<p><em>2.0.54 sürümünden beri mevcuttur.</em></p>
<p>Apache bir isteğe bir yönlendirme ile yanıt verdiğinde istemci
yönlendirmeyi kendiliğinden yapmaz veya yapamazsa kullanıcıya yanıtla
birlikte gönderilen metin gösterilir. Apache normal olarak bu metni
ISO-8859-1 ile kodlar.</p>
<p>Ancak, yönlendirmenin yapıldığı sayfa farklı bir karakter kümesine
sahipse bazı tarayıcı sürümleri asıl sayfanın karakter kodlaması yerine
yönlendirmenin kodlamasını kullanmaya çalışırlar. Bu özellikle Yunanca
gibi dillerde hedef sayfanın hatalı yorumlanmasına yol açar.</p>
<p>Bu ortam değişkeninin atanması Apache’nin yönlendirme için karakter
kümesi belirtmemesini sağlamak suretiyle hatalı tarayıcıların hedef
sayfayı yanlış karakter kodlamasıyla yorumlamasını önler.</p>
<div class="warning">
<h3>Güvenlik Uyarısı</h3>
<p>Hata sayfalarının bir karakter kümesi belirtilmeksizin yollanması,
HTTP/1.1 belirtimine uymayan ve karakter kümesini içeriğe bakarak
tahmin etmeye çalışan tarayıcılarda (MSIE) karşı siteden betik
saldırısı yorumuna sebep olabilir. Girdi verisindeki UTF-7 içerik
(istek betimleyici gibi) karşı siteden betik saldırılarını engellemek
için tasarlanmış normal önceleme mekanizmalarıyla öncelenmeyeceği için
böyle tarayıcılar UTF-7 karakter kodlaması kullanılarak kolayca
aldatılabilir.</p>
</div>
<h3><a name="proxy" id="proxy"><code>force-proxy-request-1.0</code>,
<code>proxy-nokeepalive</code>, <code>proxy-sendchunked</code> ve
<code>proxy-sendcl</code>, <code>proxy-chain-auth</code>,
<code>proxy-interim-response</code>, <code>proxy-initial-not-pooled</code>
</a></h3>
<p>Bu yönergeler <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> modülünün normal protokol
davranışını değiştirirler. Daha ayrıntılı bilgi için
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> ve <code class="module"><a href="./mod/mod_proxy_http.html">mod_proxy_http</a></code>
belgelerine bakınız.</p>
</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">Örnekler</a></h2>
<h3><a name="fixheader" id="fixheader">Bozuk başlıkların CGI betiklerine aktarılması</a></h3>
<p>2.4 sürümünden itibaren, <code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code> modülü ve diğer
modüllerde HTTP başlıklarının ortam değişkenlerine dönüştürülmesi
bağlamında Apache daha seçici davranmaktadır. Önce HTTP başlığındaki
geçersiz karakterlerin tamamı altçizgilere dönüştürülür. Bu, başlık
zerki yoluyla yapılan karşı-site-betiklerini-çalıştırma saldırısını
önlemeye yöneliktir. (Bakınız: <a href="http://events.ccc.de/congress/2007/Fahrplan/events/2212.en.html">Unusual Web Bugs</a>, slide 19/20).</p>
<p>Bozuk başlıklar gönderdiği halde bunlara dokunulmamasını gerektiren
bir istemciniz varsa, <code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> ve
<code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> modüllerinin sunduğu yapıyı örnekteki gibi
kullanarak bu sorunun üstesinden gelebilirsiniz:</p>
<pre class="prettyprint lang-config">#
# Aşağıdaki satırlarla bir istemcinin gönderdiği bozuk
# Accept_Encoding başlıklarının istenildiği gibi işlenmesi
# sağlanabilir.
#
SetEnvIfNoCase ^Accept.Encoding$ ^(.*)$ fix_accept_encoding=$1
RequestHeader set Accept-Encoding %{fix_accept_encoding}e env=fix_accept_encoding</pre>
<h3><a name="misbehaving" id="misbehaving">Protokolü yanlış yorumlayan tarayıcıların davranışlarının
değiştirilmesi</a></h3>
<p>Önceki sürümlerde bilinen istemci davranışlarına karşı önlem olarak
aşağıdaki satırların <code>httpd.conf</code> içinde bulunması
önerilirdi. Fakat, böyle tarayıcılar artık ortalıkta görünmediğinden
bu yapılandırmaya da artık gerek kalmamıştır.</p>
<pre class="prettyprint lang-config">#
# Aşağıdaki yönergeler normal HTTP yanıt davranışını değiştirirler.
# İlk yönerge Netscape 2.x ve kendini öyle gösteren tarayıcılar için
# kalıcı bağlantıyı (keepalive) iptal eder. İkinci yönerge ise HTTP/1.1
# protokolü bozuk olan ve 301/302 durum kodlu yönlendirme yanıtları
# kullanıldığında kalıcı bağlantıları gerektiği gibi desteklemeyen
# Microsoft Internet Explorer 4.0b2 içindir.
#
BrowserMatch "Mozilla/2" nokeepalive
BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
#
# Aşağıdaki yönergeler HTTP/1.0 yanıtlarından başkasına yabancı olan
# tarayıcılara HTTP/1.1 yanıtlarının gönderilmesini iptal eder.
#
BrowserMatch "RealPlayer 4\.0" force-response-1.0
BrowserMatch "Java/1\.0" force-response-1.0
BrowserMatch "JDK/1\.0" force-response-1.0</pre>
<h3><a name="no-img-log" id="no-img-log">Resim isteklerinin erişim günlüğüne kaydedilmemesi</a></h3>
<p>Bu örnek resim isteklerinin erişim günlüğüne yazılmasını engeller.
Bu örnek değiştirilerek belli dizinlerin veya belli konaklardan
gelen isteklerin günlüğe kaydedilmesini engellemek amacıyla da
kullanılabilir.</p>
<pre class="prettyprint lang-config">SetEnvIf Request_URI \.gif image-request
SetEnvIf Request_URI \.jpg image-request
SetEnvIf Request_URI \.png image-request
CustomLog "logs/access_log" common env=!image-request</pre>
<h3><a name="image-theft" id="image-theft">“Resim Hırsızlığı” için önlem alınması</a></h3>
<p>Bu örnekte sunucunuzda bulunmayan sayfalarda sunucunuzdaki
resimlerin kullanılmasının nasıl önleneceği gösterilmiştir. Bu
yapılandırma önerilmemekle birlikte nadir durumlarda işe yarar. Tüm
resimlerin <code>/siteler/resimler</code> dizini altında tutulduğu
varsayılmıştır.</p>
<pre class="prettyprint lang-config">SetEnvIf Referer "^http://www\.example\.com/" local_referal
# Referrer bilgisi göndermeyen tarayıcılara izin verelim
SetEnvIf Referer "^$" local_referal
<Directory "/siteler/resimler">
Require env local_referal
</Directory></pre>
<p>Bu teknik hakkında daha ayrıntılı bilgi edinmek için ServerWatch
üzerindeki "<a href="http://www.serverwatch.com/tutorials/article.php/1132731">Diğer sitelerin sizin resimlerinizle donatılmasını engellemek</a>"
belgesine bakınız.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/env.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/env.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/env.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sitemap.html 0000664 0001751 0001751 00000001340 13710016232 017350 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: sitemap.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: sitemap.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: sitemap.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: sitemap.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: sitemap.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: sitemap.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: sitemap.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
URI: sitemap.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/handler.html.ja.utf8 0000664 0001751 0001751 00000032562 14743132254 020625 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache のハンドラの使用 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><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" title="Japanese"> ja </a> |
<a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>Apache のハンドラの使用に関して記述しています。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><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><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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_imagemap.html">mod_imagemap</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 における内部表現です。
通常、ファイルはファイルタイプ<span class="transnote">(<em>訳注:</em> MIME-type)</span>に基づいた暗黙のハンドラがあります。
普通はすべてのファイルは単にサーバに扱われますが、
ファイルタイプの中には別に「ハンドル」<span class="transnote">(<em>訳注:</em> 扱う)</span>
されるものもあります。</p>
<p>ファイルの拡張子や置いている場所に基づいてファイルタイプと関係なく、
ハンドラを明示的に設定することもできます。
これはより優雅な解決法という点と、ファイルにタイプ<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_handelr()</code>
を使ってファイルを送ります。
静的なコンテンツを扱うときにデフォルトで使用されるハンドラです。
(<code class="module"><a href="./mod/core.html">core</a></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>:
イメージマップのルールファイルとして解析します。
(<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</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>:
コンテントネゴシエーションのためのタイプマップとして解析します。
(<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>
であるファイルは <code>footer.pl</code>
CGI スクリプトを起動するようになります。</p>
<pre class="prettyprint lang-config">Action add-footer /cgi-bin/footer.pl
AddHandler add-footer .html</pre>
<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>
<pre class="prettyprint lang-config"><Directory /web/htdocs/asis>
SetHandler send-as-is
</Directory></pre>
</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>
<pre class="prettyprint lang-c">char *handler</pre>
<p>もしモジュールがハンドラに関わりたい場合、
やらなければならないことは、リクエストが <code>invoke_handler</code>
ステージに達する以前に <code>r->handler</code>
を設定することだけです。ハンドラはコンテントタイプの代わりに
ハンドラ名を使うようになっていること以外は、以前と同じように実装されています。
必ず要求されているわけではありませんが、メディアタイプ
の名前空間を侵さないように、ハンドラの名前にはスラッシュを含まない、
ダッシュ<span class="transnote">(<em>訳注:</em> "-")</span>で分離された名前を付ける習慣になっています。</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" title="Japanese"> ja </a> |
<a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/handler.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/glossary.html.es 0000664 0001751 0001751 00000077737 14743132254 020220 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Glosario - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="./images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="./">Versión 2.4</a></div><div id="page-content"><div id="preamble"><h1>Glosario</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/glossary.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/glossary.html" title="Español"> es </a> |
<a href="./fr/glossary.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/glossary.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Éste glosario define las terminologías más comunes
relacionada con Apache en particular, y con los servidores web en
general. En los enlaces que hay asociados a cada término se puede
encontrar información más detallada de cada uno.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="definitions" id="definitions">Definiciones</a></h2>
<dl>
<dt><a name="algorithm" id="algorithm">Algoritmo</a></dt>
<dd>Un proceso definido sin ambigüedades o un conjunto de reglas
para solucionar un problema en un número finito de pasos.
Los algoritmos para encriptar se llaman
normalmente <dfn>algoritmos de cifrado</dfn>.
</dd>
<dt><a name="cipher" id="cipher">Algoritmo de cifrado, (Cipher). </a></dt>
<dd>Es un algoritmo o sistema de encriptado de información.
Ejemplos de estos algoritmos son DES, IDEA, RC4, etc.<br />
Consulte: <a href="ssl/">Encriptado SSL/TLS</a></dd>
<dt><a name="authentication" id="authentication">Autenticación.</a></dt>
<dd>La identificación positiva de una entidad de red tal como un
servidor, un cliente, o un usuario.<br />
Consulte: <a href="howto/auth.html">Autentificación, Autorización,
y Control de Acceso</a></dd>
<dt><a name="certificationauthority" id="certificationauthority">Autoridad Certificadora.</a> <a name="ca">(CA)</a></dt> <dd>Es una entidad externa de confianza cuyo fin
es firmar certificados para las entidades de red que ha autentificado
usando medios seguros. Otras entidades de red pueden verificar la
firma para comprobar que una Autoridad Certificadora ha autentificado
al poseedor del certificado.<br /> Consulte: <a href="ssl/">Encriptado
SSL/TLS</a></dd>
<dt><a name="header" id="header">Cabecera.</a></dt> <dd>Es la parte de la
petición y la respuesta <a class="glossarylink" href="./glossary.html#http" title="ver glosario">HTTP</a> que se
envía antes del contenido propiamente dicho, y que contiene
meta-información describiendo el contenido.</dd>
<dt><a name="certificate" id="certificate">Certificado.</a></dt>
<dd>Una información que se almacena para autenticar entidades
de red tales como un servidor o un cliente. Un certificado
contiene piezas de información X.509 sobre su poseedor
(llamado sujeto) y sobre la <a class="glossarylink" href="./glossary.html#certificationauthority" title="ver glosario">Autoridad Certificadora</a>
(llamada el emisor) que lo firma, más la <a class="glossarylink" href="./glossary.html#publickey" title="ver glosario">clave pública</a> del propietario y la firma de
la AC(Autoridad Certificadora). Las entidades de red verifican las firmas usando
certificados de las AC.<br />
Consulte: <a href="ssl/">Encriptado SSL/TLS</a>
</dd>
<dt><a name="publickey" id="publickey">Clave Pública.</a></dt>
<dd>La clave disponible
públicamente en un <a class="glossarylink" href="./glossary.html#publickeycryptography" title="ver glosario">sistema
criptográfico de Clave Pública</a>, usado para encriptar
mensajes destinados a su propietario y para desencriptar firmas hechas
por su propietario.<br /> Consulte: <a href="ssl/">Encriptado
SSL/TLS</a></dd>
<dt><a name="privatekey" id="privatekey">Clave Privada.</a></dt>
<dd>La clave secreta
de un <a class="glossarylink" href="./glossary.html#publickeycryptography" title="ver glosario">Sistema criptográfico de
Clave Pública</a>, usada para desencriptar los mensajes entrantes
y firmar los salientes.<br /> Consulte: <a href="ssl/">Encriptado
SSL/TLS</a></dd>
<dt><a name="connect" id="connect">CONNECT</a></dt> <dd>Un <a class="glossarylink" href="./glossary.html#method" title="ver glosario">método</a> de HTTP para hacer proxy a canales de
datos sin usar HTTP. Puede usarse para encapsular otros protocolos,
tales como el protocolo SSL.</dd>
<dt><a name="context" id="context">Contexto</a></dt> <dd>Un área en los
<a class="glossarylink" href="./glossary.html#configurationfile" title="ver glosario">ficheros de configuración</a>
donde están permitidos ciertos tipos de <a class="glossarylink" href="./glossary.html#directive" title="ver glosario">directivas</a>.<br />
Consulte: <a href="mod/directive-dict.html#Context">Términos
usados para describir las directivas de Apache</a></dd>
<dt><a name="accesscontrol" id="accesscontrol">Control de Acceso.</a></dt>
<dd>La
restricción en el acceso al entorno de una red. En el contexto de
Apache significa normalmente la restricción en el acceso a
ciertas <em>URLs</em>.<br />
Consulte: <a href="howto/auth.html">Autentificación, Autorización, y
Control de Acceso</a></dd>
<dt><a name="symmetriccryptophraphy">Criptografía
Simétrica</a></dt> <dd>El estudio y aplicación de
<em>Algoritmos de Cifrado</em> que usan una sola clave secreta tanto
para cifrar como para descifrar.<br /> Consulte: <a href="ssl/">Encriptado SSL/TLS</a></dd>
<dt><a name="directive" id="directive">Directiva</a></dt>
<dd>Un comando de
configuración que controla uno o más aspectos del
comportamiento de Apache. Las directivas se ponen en el <a class="glossarylink" href="./glossary.html#configurationfile" title="ver glosario">Fichero de Configuración</a><br />
Consulte: <a href="mod/directives.html">Índice de
Directivas</a></dd>
<dt><a name="configurationdirective" id="configurationdirective">Directivas de
configuración.</a></dt> <dd>Consulte: <a class="glossarylink" href="./glossary.html#directive" title="ver glosario">Directivas</a></dd>
<dt><a name="apacheportableruntime" id="apacheportableruntime">Entorno Portable de tiempo de ejecución de Apache, </a> <a name="apr" id="apr">(APR, Apache Portable Runtime)</a></dt>
<dd>Es un conjunto de librerías que proveen las interfaces básicas
entre el servidor y el sistema operativo. El desarrollo de APR es
paralelo al del Servidor HTTP Apache, como un proyecto independiente.
Puedes visitar el proyecto en:<br />
<a href="http://apr.apache.org/">Apache Portable Runtime
Project</a>
</dd>
<dt><a name="export-crippled" id="export-crippled">Export-Crippled</a></dt>
<dd>Disminución de la fortaleza criptográfica (y seguridad)
para cumplir con las Regulaciones sobre Exportación de la
Administración de los Estados Unidos (EAR). El software
criptográfico Export-crippled está limitado a una clave de
pequeño tamaño, de tal manera que el <em>texto cifrado</em>
que se consigue con él, puede descifrarse por medio de fuerza bruta.<br /> Consulte: <a href="ssl/">Encriptado SSL/TLS</a></dd>
<dt><a name="regularexpresion" id="regularexpresion">Expresiones Regulares</a>
<a name="regex">(Regex)</a></dt> <dd>Una forma de describir un patrón en un
texto - por ejemplo, "todas las palabras que empiezan con la letra "A"
o "todos los números de teléfono que contienen 10
dígitos" o incluso "Todas las frases entre comas, y que no
contengan ninguna letra Q". Las Expresiones Regulares son útiles en
Apache porque permiten aplicar ciertos atributos a colecciones de
ficheros o recursos de una forma flexible - por ejemplo, todos los
archivos .gif y .jpg que estén en el directorio "imágenes"
podrían ser escritos como "<code>/images/.*(jpg|gif)$</code>".
En los lugares donde expresiones regulares se utilizan para reemplazar
cadenas, las variables especiales $ 1 ... $ 9 contienen
referencias inversa las partes agrupadas (entre paréntesis)
de la expresión coincidente. La variable especial $ 0 contiene
una referencia inversa a todo el ejemplar de la expresión.
Para escribir un símbolo de dolar literal en una sustitución de
una cadena, se puede escapar usando "\". Históricamente, la variable &
se podía usar como un alias a $0 en algunos sitios.
Esto ya no esta soportado desde la versión 2.3.6.
Apache usa Expresiones Regulares compatibles con Perl gracias a la
librería <a href="http://www.pcre.org/">PCRE</a>.
Puedes encontrar más documentación sobre las expresiones regulares
de PCRE y su sintaxis en esa página o en la
<a href="http://en.wikipedia.org/wiki/PCRE">Wikipedia</a>.</dd>
<dt><a name="configurationfile" id="configurationfile">Fichero de Configuración.</a></dt>
<dd>Un fichero de texto que contiene <a class="glossarylink" href="./glossary.html#directive" title="ver glosario">Directivas</a> que controlan la configuración
de Apache.<br /> Consulte: <a href="configuring.html">Ficheros de
Configuración</a></dd>
<dt><a name="htaccess" id="htaccess">.htaccess</a></dt>
<dd>Un <a class="glossarylink" href="./glossary.html#configurationfile" title="ver glosario">fichero de configuración</a> que se
pone dentro de la estructura de directorios del sitio web y aplica <a class="glossarylink" href="./glossary.html#directive" title="ver glosario">directivas</a> de configuración al directorio
en el que está y a sus subdirectorios. A pesar de su nombre, este
fichero puede contener cualquier tipo de directivas, no solo
directivas de control de acceso.<br /> Consulte: <a href="configuring.html">Ficheros de Configuración</a> para más información.</dd>
<dt><a name="httpd.conf" id="httpd.conf">httpd.conf</a></dt>
<dd>Es el <a class="glossarylink" href="./glossary.html#configurationfile" title="ver glosario">fichero de configuración</a> principal
de Apache. Su ubicación por defecto es
<code>/usr/local/apache2/conf/httpd.conf</code>, pero puede moverse
usando opciones de configuración al compilar o al iniciar
Apache.<br /> Consulte: <a href="configuring.html">Ficheros de
Configuración</a></dd>
<dt><a name="filter" id="filter">Filtro</a></dt>
<dd>Un proceso que se aplica a la
información que es enviada o recibida por el servidor. Los
ficheros de entrada procesan la información enviada por un
cliente al servidor, mientras que los filtros de salida procesan la
información en el servidor antes de enviársela al
cliente. Por ejemplo, el filtro de salida <code>INCLUDES</code>
procesa documentos para <a class="glossarylink" href="./glossary.html#ssi" title="ver glosario">Server Side Includes</a>.<br />
Consulte: <a href="filter.html">Filtros</a></dd>
<dt><a name="digitalsignature" id="digitalsignature">Firma Digital</a></dt>
<dd>Un bloque de
texto encriptado que verifica la validez de un certificado o de otro
fichero. Una <a class="glossarylink" href="./glossary.html#certificationauthority" title="ver glosario">Autoridad
Certificadora</a> crea una firma generando un hash a partir de la
<em>Clave Pública</em> que lleva incorporada en un
<em>Certificado</em>, después encriptando el hash con su propia
<em>Clave Privada</em>. Solo las claves públicas de las CAs
pueden desencriptar la firma, verificando que la CA ha autentificado a
la entidad de red propietaria del <em>Certificado</em>.<br />
Consulte: <a href="ssl/">Encriptado SSL/TLS</a></dd>
<dt><a name="handler" id="handler">Handler</a></dt>
<dd>Es una representación
interna de Apache de una acción a ser ejecutada cuando se llama a
un fichero. Generalmente, los ficheros tienen un handler (manejador)
implícito, basado en el tipo de fichero. Normalmente, todos los
ficheros son simplemente servidos por el servidor, pero sobre algunos
tipos de ficheros se ejecutan acciones complementarias. Por ejemplo,
el handler <code>cgi-script</code> designa los ficheros a ser
procesados como <a class="glossarylink" href="./glossary.html#cgi" title="ver glosario">CGIs</a>.<br /> Consulte: <a href="handler.html">Uso de Handlers en Apache</a></dd>
<dt><a name="apacheextensiontool" id="apacheextensiontool">Herramienta de extensión de
Apache.</a> <a name="apxs" id="apxs">(apxs)</a></dt>
<dd>Es un script escrito en Perl que ayuda a compilar el código
fuente de algunos <a class="glossarylink" href="./glossary.html#module" title="ver glosario">módulos</a> para
convertirlos en Objetos Dinámicos Compartidos (<a class="glossarylink" href="./glossary.html#dso.html" title="ver glosario">DSO</a>s)
y ayuda a instalarlos en el Servidor Web de Apache.<br />
Consulte: Manual de: <code class="program"><a href="./programs/apxs.html">apxs</a></code></dd>
<dt><a name="hash" id="hash">Hash</a></dt>
<dd>Algoritmo matemático de un solo sentido e irreversible, que genera
una cadena de una determinada longitud de otra cadena de
cualquier tamaño. Diferentes entradas darán diferentes hashes
(dependiendo de la función hash.)
</dd>
<dt><a name="virtualhosting">Hosting Virtual</a></dt> <dd>Se trata de
servir diferentes sitios web con una sola entidad de Apache. <em>El
hosting virtual de IPs</em> diferencia los sitios web basándose en sus
direcciones IP, mientras que el <em>hosting virtual basado en
nombres</em> usa solo el nombre del host y de esta manera puede alojar
muchos sitios web con la misma dirección IP.<br /> Consulte: <a href="vhosts/">Documentación sobre Hosting Virtual en
Apache</a></dd>
<dt><a name="uniformresourceidentifier">Identificador de Recursos
Uniforme</a> <a name="URI">(URI)</a></dt> <dd>Una cadena de caracteres
compacta para identificar un recurso físico o abstracto. Se
define formalmente en la <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a>. Los URIs que
se usan en world-wide web se refieren normalmente como <a href="#url">URLs</a>.</dd>
<dt><a name="servernameindication" id="servernameindication">Indicador del Nombre del servidor</a>
<a name="sni" id="sni"> Server Name Indication (SNI) </a></dt>
<dd>Una función SSL que permite pasar el nombre de host del servidor deseado
en el mensaje inicial del protocolo de enlace SSL, para que el servidor web
pueda seleccionar la configuración correcta del host virtual para usar en el
procesamiento del protocolo de enlace SSL. Se añadió a SSL
con las extensiones TLS en el RFC 3546. <br />
See: <a href="ssl/ssl_faq.html">the SSL FAQ</a>
and <a href="http://www.ietf.org/rfc/rfc3546.txt">RFC 3546</a>
</dd>
<dt><a name="commongatewayinterface" id="commongatewayinterface">Interfaz de Pasarela Común.</a> <a name="cgi"> Common Gateway Interface (CGI)</a></dt>
<dd>Una definición estándar para
un interfaz entre un servidor web y un programa externo que permite
hacer peticiones de servicio a los programas externos. Este interfaz
esta definido en el <a href="http://www.ietf.org/rfc/rfc3875">RFC-3875</a>.<br />
Consulte: <a href="howto/cgi.html">Contenido Dinámico con CGI</a>
</dd>
<dt><a name="uniformresourcelocator">Localizador de Recursos
Uniforme</a> <a name="url">(URL)</a></dt>
<dd>El nombre de un recurso
en Internet. Es la manera informal de decir lo que formalmente se
llama un <a href="#uniformresourceidentifier">Identificador de
Recursos Uniforme</a>. Las URLs están compuestas normalmente por
un esquema, tal como <code>http</code> o <code>https</code>, un nombre
de host, y una ruta. Una URL para esta página es
<code>http://httpd.apache.org/docs/2.4/glossary.html</code>.</dd>
<dt><a name="module" id="module">Módulo</a></dt>
<dd>Una parte independiente
de un programa. La mayor parte de la funcionalidad de Apache
está contenida en módulos que pueden incluirse o excluirse.
Los módulos que se compilan con el binario <code class="program"><a href="./programs/httpd.html">httpd</a></code>de Apache se
llaman <em>módulos estáticos</em>, mientras que los que se
almacenan de forma separada y pueden ser cargados de forma opcional,
se llaman <em>módulos dinámicos</em> o <a class="glossarylink" href="./glossary.html#dso" title="ver glosario">DSOs</a>.
Los módulos que están incluidos por defecto de llaman
<em>módulos base</em>. Hay muchos módulos disponibles para
Apache que no se distribuyen con la <a class="glossarylink" href="./glossary.html#tarball" title="ver glosario">tarball</a> del
Servidor HTTP Apache. Estos módulos son llamados
<em>módulos de terceros</em>.<br /> Consulte: <a href="mod/">Índice de Módulos</a></dd>
<dt><a name="method" id="method">Método</a></dt>
<dd>En el contexto de <a class="glossarylink" href="./glossary.html#http" title="ver glosario">HTTP</a>, es una acción a ejecutar sobre un recurso,
especificado en la líneas de petición por el cliente.
Algunos de los métodos disponibles en HTTP son <code>GET</code>,
<code>POST</code>, y <code>PUT</code>.</dd>
<dt><a name="messagedigest" id="messagedigest">Mensaje Resumen (Message Digest)</a></dt>
<dd>Un hash de un
mensaje, el cual pude ser usado para verificar que el contenido del
mensaje no ha sido alterado durante la transmisión.<br />
Consulte: <a href="ssl/">Encriptado SSL/TLS</a></dd>
<dt><a name="mime-type" id="mime-type">MIME-type</a></dt>
<dd>Una manera de describir
el tipo de documento a ser transmitido. Su nombre viene del hecho de
que su formato se toma de las Extensiones del "Multipurpose Internet
Mail". Consiste en dos componentes, uno principal y otro secundario,
separados por una barra. Algunos ejemplos son <code>text/html</code>,
<code>image/gif</code>, y <code>application/octet-stream</code>. En
HTTP, el tipo MIME se transmite en la <a class="glossarylink" href="./glossary.html#header" title="ver glosario">cabecera</a>
del <code>Tipo Contenido</code>.<br /> Consulte: <a href="mod/mod_mime.html">mod_mime</a></dd>
<dt><a name="modulemagicnumber" id="modulemagicnumber">Módulo del Número Mágico</a>
(<a name="mmn">MMN Module Magic
Number</a>)</dt> <dd> El módulo del número
mágico es una constante definida en el código
fuente de Apache que está asociado con la compatibilidad binaria
de los módulos. Ese número cambia cuando cambian las
estructuras internas de Apache, las llamadas a funciones y otras
partes significativas de la interfaz de programación de manera
que la compatibilidad binaria no puede garantizarse sin cambiarlo. Si
cambia el número mágico de módulo, todos los
módulos de terceros tienen que ser al menos recompilados, y
algunas veces, incluso hay que introducir ligeras modificaciones para
que funcionen con la nueva versión de Apache </dd>
<dt><a name="fully-qualifieddomain-name" id="fully-qualifieddomain-name">Nombre de dominio
completamente qualificado</a> <a name="fqdn">(FQDN)</a></dt>
<dd>El
nombre único de una entidad de red, que consiste en un nombre de
host y un nombre de dominio que puede traducirse a una dirección
IP. Por ejemplo, <code>www</code> es un nombre de host,
<code>example.com</code> es un nombre de dominio, y
<code>www.example.com</code> es un nombre de dominio completamente
qualificado.</dd>
<dt><a name="dynamicsharedobject" id="dynamicsharedobject">Objetos Dinámicos
Compartidos</a> <a name="dso">(DSO, dinamic shared objects)</a></dt>
<dd>Los <a class="glossarylink" href="./glossary.html#module" title="ver glosario">Módulos</a> compilados de forma separada al
binario httpd de Apache se pueden cargar según se necesiten.<br /> Consulte: <a href="dso.html">Soporte de Objetos Dinámicos
Compartidos</a></dd>
<dt><a name="openssl" id="openssl">OpenSSL</a></dt>
<dd>El toolkit Open Source para SSL/TLS<br />
Ver: <a href="http://www.openssl.org/">http://www.openssl.org/</a></dd>
<dt><a name="passphrase">Pass Phrase o frase de contraseña</a></dt>
<dd>La palabra o frase
que protege los archivos de clave privada. Evita que usuarios no
autorizados los encripten. Normalmente es solo la clave de
encriptado/desencriptado usada por los <a class="glossarylink" href="./glossary.html#cipher" title="ver glosario">Algoritmos de
Cifrado</a>.<br /> Consulte: <a href="ssl/">Encriptado
SSL/TLS</a></dd>
<dt><a name="certificatsigningrequest" id="certificatsigningrequest">Petición de firma de
Certificado.</a> <a name="csr">(CSR)</a></dt>
<dd>Es la petición a
una <a class="glossarylink" href="./glossary.html#certificationauthority" title="ver glosario">Autoridad Certificadora</a> para
que firme un <a class="glossarylink" href="./glossary.html#certificate" title="ver glosario">certificado</a> aún sin
firmar. La Autoridad Certificadora firma el <em>Certificado</em> con
la <a class="glossarylink" href="./glossary.html#privatekey" title="ver glosario">Clave Privada</a> de su
<em>certificado</em>. Una vez que el CSR está firmado, se
convierte en un auténtico certificado.<br />
Consulte: <a href="ssl/">Encriptado SSL/TLS</a></dd>
<dt><a name="hypertexttransferprotocol" id="hypertexttransferprotocol">Protocolo de Transferencia de
Hipertexto</a> <a name="http">(HTTP)</a></dt>
<dd>Es el protocolo de
transmisión estádar usado en la World Wide Web. Apache
implementa la versión 1.1 de este protocolo, al que se hace
referencia como HTTP/1.1 y definido por el <a href="http://ietf.org/rfc/rfc2616.txt">RFC 2616</a>.</dd>
<dt><a name="https" id="https">HTTPS</a></dt>
<dd>Protocolo de transferencia de
Hipertexto (Seguro), es el mecanismo de comunicación encriptado
estándar en World Wide Web. En realidad es HTTP sobre <a class="glossarylink" href="./glossary.html#ssl" title="ver glosario">SSL</a>.<br /> Consulte: <a href="ssl/">Encriptado
SSL/TLS</a></dd>
<dt><a name="proxy" id="proxy">Proxy</a></dt> <dd>Un servidor intermedio que se
pone entre el cliente y el <em>servidor de origen</em>. Acepta las
peticiones de los clientes, las transmite al servidor de origen, y
después devuelve la respuesta del servidor de origen al
cliente. Si varios clientes piden el mismo contenido, el proxy sirve
el contenido desde su caché, en lugar de pedirlo cada vez que lo
necesita al servidor de origen, reduciendo con esto el tiempo de
respuesta.<br /> Consulte: <a href="mod/mod_proxy.html">mod_proxy</a></dd>
<dt><a name="reverseproxy" id="reverseproxy">Proxy Inverso</a></dt>
<dd>Es un servidor
<a href="proxy">proxy</a> que se presenta al cliente como si fuera un
<em>servidor de origen</em>. Es útil para esconder el
auténtico servidor de origen a los clientes por cuestiones de
seguridad, o para equilibrar la carga.</dd>
<dt><a name="securesocketslayer" id="securesocketslayer">SSL, Capa de Conexión Segura </a> <a name="ssl">Secure Sockets Layer(SSL)</a></dt> <dd>Es un protocolo creado por Netscape
Communications Corporation para la autenticación en
comunicaciones en general y encriptado sobre redes TCP/IP. Su
aplicación más popular es en <em>HTTPS</em>, ejemplo.: el Protocolo de
Transferencia de Hipertexto (HTTP) sobre SSL.<br /> Consulte: <a href="ssl/">Encriptado SSL/TLS</a></dd>
<dt><a name="ssleay" id="ssleay">SSLeay</a></dt> <dd>La implementación
original de la librería SSL/TLS desarrollada por Eric
A. Young</dd>
<dt><a name="serversideincludes" id="serversideincludes">Server Side Includes</a> <a name="ssi">(SSI)</a></dt> <dd>Una técnica para incluir directivas de
proceso en archivos HTML.<br /> Consulte: <a href="howto/ssi.html">Introducción a Server Side
Includes</a></dd>
<dt><a name="session" id="session">Sesión</a></dt> <dd>Información del
contexto de una comunicación en general.</dd>
<dt><a name="publickeycryptography" id="publickeycryptography">Sistema Criptográfico de Clave
Pública</a></dt> <dd>El estudio y aplicación de sistemas de
encriptado asimétricos, que usa una clave para encriptar y otra
para desencriptar. Una clave de cada uno de estos tipos constituye un
par de claves. También se llama Criptografía Asimétrica.<br />
Consulte: <a href="ssl/"> Encriptado SSL/TLS</a></dd>
<dt><a name="subrequest" id="subrequest">Subconsulta</a></dt>
<dd>Apache proporciona una API de subconsultasd a los módulos,
que permiten a otros sistemas de ficheros o paths de URL ser parcial o totalmente evaluados
por el servidor. Un ejemplo de los que usan esta API sería
<code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>,
<code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code>, y <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>.
</dd>
<dt><a name="tarball" id="tarball">Tarball</a></dt> <dd>Un grupo de ficheros
puestos en un solo paquete usando la utilidad <code>tar</code>. Las
distribuciones Apache se almacenan en ficheros comprimidos con tar o
con pkzip.</dd>
<dt><a name="ciphertext" id="ciphertext">Texto cifrado.</a></dt>
<dd>El resultado de
haber aplicado a un <a class="glossarylink" href="./glossary.html#plaintext" title="ver glosario">texto plano</a> un <a class="glossarylink" href="./glossary.html#cipher" title="ver glosario">algoritmo de cifrado</a>.<br /> Consultar: <a href="ssl/">Encriptado SSL/TLS</a></dd>
<dt><a name="plaintext" id="plaintext">Texto plano</a></dt>
<dd>Un texto no encriptado.</dd>
<dt><a name="transportlayersecurity" id="transportlayersecurity">Transport
Layer Security</a> <a name="tls">(TLS)</a></dt> <dd>Es el sucesor del protocolo SSL, creado
por el "Internet Engineering Task Force" (IETF) para la
autentificación en comunicaciones en general y encriptado sobre
redes TCP/IP. La versión 1 de TLS es casi idéntica a la
versión 3 de SSL.<br /> Consulte: <a href="ssl/">Encriptado
SSL/TLS</a></dd>
<dt><a name="environmentvariable" id="environmentvariable">Variable de Entorno</a> <a name="env-variable">(env-variable)</a></dt>
<dd>Variables que
gestionan el shell del sistema operativo y que se usan para guardar
información y para la comunicación entre programas. Apache
también contiene variables internas que son referidas como
variables de entorno, pero que son almacenadas en las estructuras
internas de Apache, en lugar de en el entorno del shell.<br />
Consulte: <a href="env.html">Variables de entorno de Apache</a></dd>
<dt><a name="x.509" id="x.509">X.509</a></dt> <dd>Un esquema de certificado de
autentificación recomendado por la International
Telecommunication Union (ITU-T) que se usa en la autentificación
SSL/TLS.<br /> Consulte: <a href="ssl/">Encriptado SSL/TLS</a></dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/glossary.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/glossary.html" title="Español"> es </a> |
<a href="./fr/glossary.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/glossary.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/glossary.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/getting-started.html.ru.utf8 0000664 0001751 0001751 00000052426 14743132254 022352 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Начало работы - HTTP сервер Apache Версия 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Модули</a> | <a href="./mod/directives.html">Директивы</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Глоссарий</a> | <a href="./sitemap.html">Карта сайта</a></p>
<p class="apache">HTTP сервер Apache Версия 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Начало работы</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/getting-started.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/getting-started.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ru/getting-started.html" title="Russian"> ru </a></p>
</div>
<p>Если вы абсолютный новичок в работе с HTTP-сервером Apache или
в запуске веб-сайтов вообще, вы можете не знать с чего начать или какие
вопросы задавать. Этот документ познакомит вас с основами.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#clientserver">Клиенты, серверы и URL-адреса</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#dns">Имена хостов и DNS</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configuration">Файлы конфигурации и директивы</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#content">Контент веб-сайта</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#logs">Файлы журналов и устранение неполадок</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">Что дальше?</a></li>
</ul><h3>См. также</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="clientserver" id="clientserver">Клиенты, серверы и URL-адреса</a></h2>
<p>Адреса в Интернете записываются с помощью URL — Uniform Resource
Locator (унифицированный указатель ресурса), который указывает на
используемый протокол (например, <code>http</code>), имя сервера
(например, <code>www.apache.org</code>), URL-путь (например,
<code>/docs/current/getting-started.html</code>) и, возможно,
строку запроса (например, <code>?arg=value</code>), используемую для
передачи серверу дополнительных аргументов.</p>
<p>Клиент (например, веб-браузер) подключается к серверу
(например, вашему HTTP-серверу Apache), используя определённый протокол,
и отправляет <strong>запрос</strong> на ресурс, используя URL-путь.</p>
<p>URL-путь может обозначать множество вещей на сервере. Это может быть
файл (как <code>getting-started.html</code>), обработчик
(как <a href="mod/mod_status.html">server-status</a>) или файл какой-то
программы (как <code>index.php</code>). Мы рассмотрим это подробней ниже,
в разделе <a href="#content">Контент веб-сайта</a>.</p>
<p>Сервер отправляет <strong>ответ</strong>, содержащий код состояния и,
опционально, тело ответа. Код состояния указывает, был ли запрос успешно
обработан, а если нет, то какая ошибка произошла.
Это говорит клиенту, что он должен делать с ответом.
Вы можете прочитать о возможных кодах ответа на
<a href="http://wiki.apache.org/httpd/CommonHTTPStatusCodes">
Вики HTTP-сервера Apache</a>.</p>
<p>Детали транзакции и условия возникновения ошибки записываются
в файлы журналов. Это описывается более подробно ниже, в разделе
<a href="#logs">Файлы журналов и устранение неполадок</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="dns" id="dns">Имена хостов и DNS</a></h2>
<p>Для того чтобы соединиться с сервером, клиент сначала должен преобразовать
имя сервера в IP-адрес — место в Интернете, где находится сервер.
Таким образом, чтобы ваш веб-сервер был доступен, необходимо,
чтобы имя сервера было в DNS.</p>
<p>Если вы не знаете как это сделать, вам нужно обратиться к сетевому
администратору или поставщику услуг Интернета (провайдеру).
Они могут сделать это для вас.</p>
<p>Несколько хостов могут указывать на один и тот же IP-адрес,
а один физический сервер может иметь больше одного IP-адреса.
Таким образом на одном физическом сервере вы можете запустить больше одного
сайта с помощью особенности: <a href="vhosts/">виртуальные хосты</a>.</p>
<p>Если вы тестируете сервер, не имеющий выхода в Интернет, можете поместить
имена хостов в файл hosts для того что бы имя разрешалось локально.
Например, вы можете добавить запись для отправки запросов к
<code>www.example.com</code> на локальный компьютер, для тестирования.
Эта запись будет выглядеть так:</p>
<div class="example"><p><code>
127.0.0.1 www.example.com
</code></p></div>
<p>Файл hosts, скорее всего, расположен в <code>/etc/hosts</code> или
<code>C:\Windows\system32\drivers\etc\hosts</code>.</p>
<p>Вы можете узнать больше о файле
<a href="http://en.wikipedia.org/wiki/Hosts_(file)">hosts</a> и больше о
<a href="http://en.wikipedia.org/wiki/Domain_Name_System">DNS</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuration" id="configuration">Файлы конфигурации и директивы</a></h2>
<p>HTTP-сервер Apache настроен с помощью простых текстовых файлов.
Эти файлы могут располагаться в разных местах, в зависимости от того как вы
установили сервер. Общие места расположения файлов можно найти в
<a href="http://wiki.apache.org/httpd/DistrosDefaultLayout">Вики
HTTP-сервера Apache</a>. Если вы установили httpd из исходного кода,
то расположение файлов конфигурации по умолчанию следующее:
<code>/usr/local/apache2/conf</code>.
По умолчанию файл конфигурации называется <code>httpd.conf</code>.
Это тоже может варьироваться в сторонних дистрибутивах сервера.</p>
<p>Конфигурация часто разбивается на несколько небольших файлов, для
удобства управления. Эти файлы загружаются через директиву
<code class="directive"><a href="./mod/core.html#include">Include</a></code>.
Имена или расположения этих файлов конфигурации
могут сильно отличаться от одной установки к другой.
Расположите и разделите эти файлы наиболее подходящим для
<strong>вас</strong> образом. Если расположение файлов по умолчанию,
не имеет смысла для вас, не стесняйтесь изменить его.</p>
<p>Сервер настраивается путём размещения <a href="mod/quickreference.html">
директив конфигурации</a> в этих файлах конфигурации.
Директива — это ключевое слово с одним или несколькими аргументами,
устанавливающими её значение.</p>
<p>На вопрос: «<em>Где я должен прописать эту директиву?</em>» – обычно
отвечают, там где ты хочешь использовать её. Если это глобальная настройка,
она должна располагаться в конфигурационном файле вне разделов
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>,
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> или других
разделов. Если настройка относится только к конкретному каталогу,
значит она должна быть внутри секции
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
которая описывает этот каталог, и так далее.
Смотри документ <a href="sections.html">Разделы конфигурации</a>
с подробным описанием вышеуказанных разделов.</p>
<p>В дополнение к основному файлу конфигурации, некоторые директивы могут
располагаться в файлах <code>.htaccess</code>, расположенных в папках с
контентом. Файлы <code>.htaccess</code> в первую очередь предназначены для
людей у которых нет доступа к главному конфигурационному файлу сервера.
Вы можете узнать больше о файлах <code>.htaccess</code> в инструкции
<a href="howto/htaccess.html"><code>.htaccess</code></a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="content" id="content">Контент веб-сайта</a></h2>
<p>Содержимое сайта может принимать различные формы, но в широком смысле
разделяется на статический и динамический контент.</p>
<p>Статический контент — это, например, HTML-файлы, файлы изображений,
CSS-файлы и другие файлы, которые просто лежат на диске.
Директива <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> указывает
где в вашей файловой системе, вы должны разместить эти файлы.
Эта директива устанавливается глобально или отдельно для каждого
виртуального хоста. Посмотрите в своём файле(ах) конфигурации,
чтобы узнать, как именно эта директива используется на вашем сервере.</p>
<p>Обычно, когда запрашивается каталог, без указания имени файла, то будет
отдан документ с именем <code>index.html</code>. Например, если для директивы
<code>DocumentRoot</code> установлено значение <code>/var/www/html</code>
и приходит запрос на адрес
<code>http://www.example.com/work/</code>,
то файл расположенный по пути
<code>/var/www/html/work/index.html</code>
будет отдан клиенту.</p>
<p>Динамический контент — это всё что генерируется во время запроса и может
изменяться от запроса к запросу. Существует множество способов создания
динамического контента. Различные <a href="handler.html">обработчики</a>
доступны для генерации содержимого. Могут быть написаны специальные
<a href="howto/cgi.html">CGI программы</a> для генерации контента на сайте.</p>
<p>Для написания кода с разнообразным функционалом
могут использоваться сторонние модули, такие как mod_php.
Множество сторонних приложений, написанных на различных языках
программирования, и утилит доступны для скачивания и установки
на ваш HTTP-сервер Apache.
Поддержка сторонних продуктов выходит за рамки этой документации.
При необходимости вы должны самостоятельно найти их документацию
или форумы поддержки, где вы сможете получить ответы на свои вопросы.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="logs" id="logs">Файлы журналов и устранение неполадок</a></h2>
<p>Для вас, как администратора HTTP-сервера Apache,
самые ценные активы — это файлы журналов (лог-файлы),
в частности, журнал ошибок. Исправление любой проблемы без журнала ошибок
можно сравнить с вождением автомобиля с закрытыми глазами.</p>
<p>Расположение журнала ошибок задаётся директивой
<code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code>,
которая может быть установлена глобально или для каждого виртуального хоста.
Записи в журнале ошибок расскажут вам, что и когда пошло не так.
Зачастую они также смогут подсказать, как что-то исправить.
Каждая запись в журнале ошибок содержит код ошибки,
по которому вы можете поискать в Интернете более подробное
описание того, как решить проблему.
Вы также можете настроить журнал ошибок так, чтобы в него записывался
идентификатор журнала, который можно сопоставить с записями в журнале
доступа — это поможет определить, какой запрос какую ошибку вызвал.</p>
<p>Больше о логирование вы можете узнать в
<a href="logs.html">документации о журналах</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Что дальше?</a></h2>
<p>Теперь, когда вы знакомы с основами, пора двигаться дальше.</p>
<p>Этот документ содержит только базовую информацию.
Мы надеемся, что она поможет вам начать работу,
но есть множество других вещей, о которых вам, возможно, нужно узнать.</p>
<ul>
<li><a href="http://httpd.apache.org/download.cgi">Загрузки</a></li>
<li><a href="install.html">Установка</a></li>
<li><a href="configuring.html">Настройка</a></li>
<li><a href="invoking.html">Старт</a></li>
<li><a href="http://wiki.apache.org/httpd/FAQ">Часто задаваемые вопросы</a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/getting-started.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/getting-started.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ru/getting-started.html" title="Russian"> ru </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/getting-started.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Глоссарий</a> | <a href="./sitemap.html">Карта сайта</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/install.html.tr.utf8 0000664 0001751 0001751 00000072076 14743132254 020715 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Derleme ve Kurulum - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Derleme ve Kurulum</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belge Apache HTTP Sunucusunun sadece Unix ve Unix benzeri
sistemlerde derlenmesini ve kurulmasını kapsar. Windows üzerinde
derleme ve kurulum için <a href="platform/windows.html">Apache HTTP
Sunucusunun Microsoft Windows ile kullanımı</a> ve <a href="platform/win_compiling.html">Apache HTTP
Sunucusunun Microsoft Windows için Derlenmesi</a> bölümüne bakınız.
Diğer platformlar için ise <a href="platform/">platform</a>
belgelerine bakınız.</p>
<p>Apache HTTP Sunucusunun, derleme ortamını oluşturmak için çoğu Açık
Kaynak Kodlu projenin yaptığı gibi <code>libtool</code> ve
<code>autoconf</code> kullanır.</p>
<p>Eğer sadece sürüm yükseltiyorsanız (2.4.8’dwn 2.4.9’a yükseltmek
gibi) lütfen doğrudan <a href="#upgrading">Yükseltme</a> bölümüne
atlayınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Tez canlılar için genel bir bakış</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#requirements">Gereksinimler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#download">İndirme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extract">Paketi açma</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configure">Kaynak ağacının yapılandırılması</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#compile">Derleme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">Kurulum</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#customize">Kişiselleştirme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#test">Deneme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#upgrading">Yükseltme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#thirdp">Üçüncü parti paketler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="programs/configure.html">Kaynak ağacının yapılandırılması</a></li><li><a href="invoking.html">Apache httpd’nin başlatılması</a></li><li><a href="stopping.html">Durdurma ve yeniden başlatma</a></li><li><a href="#comments_section">Yorumlar</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="overview" id="overview">Tez canlılar için genel bir bakış</a></h2>
<dl>
<dt>Fedora/CentOS/Red Hat Enterprise Linux üzerinde kurulum</dt>
<dd>
<pre class="prettyprint lang-">sudo yum install httpd
sudo systemctl enable httpd
sudo systemctl start httpd</pre>
<div class="warning">Bu dağıtımların yeni sürümlerinde <code>yum</code>
yerine <code>dnf</code> kullanılmaktadır.<code>yum</code>. Daha ayrıntılı
bilgi için <a href="https://fedoraproject.org/wiki/Apache_HTTP_Server">Fedora projesinin
belgelerine</a> bakınız.</div>
</dd>
<dt>Ubuntu/Debian üzerinde kurulum</dt>
<dd>
<pre class="prettyprint lang-">sudo apt install apache2
sudo service apache2 start</pre>
<div class="warning">Daha ayrıntılı bilgi için <a href="https://help.ubuntu.com/lts/serverguide/httpd.html">Ubuntu
belgelerine</a> bakınız.</div>
</dd>
<dt>Kaynak koddan kurulum</dt>
<dd>
<table>
<tr>
<td><a href="#download">İndirme</a></td>
<td><a href="http://httpd.apache.org/download.cgi#apache24">http://httpd.apache.org/download.cgi</a> adresinden en son
dağıtımı indirin.
</td>
</tr>
<tr>
<td><a href="#extract">Paketi açma</a></td>
<td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar<br />
$ cd httpd-<em>NN</em></code></td>
</tr>
<tr>
<td><a href="#configure">Yapılandırma</a></td>
<td><code>$ ./configure --prefix=<em>ÖNEK</em></code>
</td>
</tr>
<tr>
<td><a href="#compile">Derleme</a></td>
<td><code>$ make</code> </td>
</tr>
<tr>
<td><a href="#install">Kurulum</a></td>
<td><code>$ make install</code> </td>
</tr>
<tr>
<td><a href="#customize">Kişiselleştirme</a></td>
<td><code>$ vi <em>ÖNEK</em>/conf/httpd.conf</code> </td>
</tr>
<tr>
<td><a href="#test">Deneme</a></td>
<td><code>$ <em>ÖNEK</em>/bin/apachectl -k start</code>
</td>
</tr>
</table>
<p><em>NN</em> yerine kuracağınız sürümü, <code><em>ÖNEK</em></code>
yerine de dosya sisteminde sunucunun altına kurulacağı dizin yolunu
yazınız. <code><em>ÖNEK</em></code> belirtilmezse
<code>/usr/local/apache2</code> öntanımlıdır.</p>
<p>Derleme ve kurulum işleminin her aşaması, Apache HTTPd Sunucusunun
derlenmesi ve kurulması için gerekenler başta olmak üzere aşağıda
ayrıntılı olarak açıklanmıştır.</p>
</dd>
</dl>
<div class="warning">Kullandığınız platformu burada göremiyor musunuz?
<a href="http://httpd.apache.org/docs-project/">Bu belgeleri geliştirmek
için gelin bize yardımcı olun.</a></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="requirements" id="requirements">Gereksinimler</a></h2>
<p>Apache httpd’yi derleyebilmek için şunlar mevcut olmalıdır:</p>
<dl>
<dt>APR ve APR-Util</dt>
<dd>APR ve APR-Util'in sisteminizde kurulu olduğundan emin olun. Kurulu
değilse veya sisteminizce sağlanmış sürümlerini kullanmak
istemiyorsanız APR ve APR-Util'in ikisini birden <a href="http://apr.apache.org/">Apache APR</a>'den indirin ve onları
Apache httpd dağıtımını açtığınız dizinin altında
<code>/httpd_kaynakkod_kök_dizini/srclib/apr</code> ve
<code>/httpd_kaynakkod_kök_dizini/srclib/apr-util</code> dizinlerine
açın (Dizin isimlerinin sürüm numarası içermemesine dikkat edin,
örneğin, APR dağıtımı
<code>/httpd_kaynakkod_kök_dizini/srclib/apr/</code> altında olsun.)
ve <code>./configure</code> betiğinin <code>--with-included-apr</code>
seçeneğini kullanın. Bazı platformlarda, httpd'nin, kurulu APR ve
APR-Util kopyanıza karşın derlenmesini sağlamak için ilgili
<code>-dev</code> paketlerini kurmanız gerekebilir.</dd>
<dt>Perl-Uyumlu Düzenli İfade Kütüphanesi (PCRE)</dt>
<dd>Bu kütüphane gereklidir, ancak artık httpd ile birlikte
dağıtılmamaktadır. Kaynak kodunu <a href="http://www.pcre.org/">http://www.pcre.org</a> sitesinden indirin ve bir port veya paket
olarak kurun. Eğer derleme sisteminiz PCRE kurulumunuz tarafından
kurulan <code>pcre-config</code> betiğini bulamazsa
<code>--with-pcre</code> seçeneğini kullanarak yerini belirtin. Bazı
platformlarda, httpd'nin, kurulu PCRE kopyanıza karşın derlenmesini
sağlamak için ilgili <code>-dev</code> paketlerini kurmanız
gerekebilir.</dd>
<dt>Disk Alanı</dt>
<dd>Geçici olarak en azından 50 MB boş disk alanınız olduğundan emin
olunuz. Kurulumdan sonra sunucu yaklaşık 10 MB disk alanı kaplıyor
olacaktır. Asıl disk alanı gereksinimi seçtiğiniz yapılandırma
seçeneklerine, üçüncü parti modüllere ve şüphesiz sitenizin veya sunucu
üzerindeki sitelerin boyutlarına göre değişiklik
gösterecektir.</dd>
<dt>ANSI-C Derleyici ve Derleme Sistemi</dt>
<dd>Bir ANSI-C derleyicinin kurulu olduğundan emin olunuz. <a href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
tarafından dağıtılan <a href="http://gcc.gnu.org/">GNU C derleyicisini
(GCC)</a> kullanmanız önerilir. GCC yoksa en azından satıcınızın
derleyicisinin ANSI uyumlu olduğundan emin olunuz. Ayrıca,
<code>PATH</code> ortam değişkeninizin içerdiği yollarda
<code>make</code> gibi temel derleme araçları da bulunmalıdır.</dd>
<dt>Zamanın doğru belirlenmesi</dt>
<dd>HTTP protokolünün elemanları sunuldukları tarih ve saate göre ifade
edilirler. Bu bakımdan sisteminizdeki zaman ayarlama oluşumunun
ayarlarını gözden geçirmenizin tam sırasıdır. Bu amaçla, Ağ Zaman
Protokolüne (NTP) göre çalışan <code>ntpdate</code> veya
<code>xntpd</code> programları kullanılır. NTP yazılımları ve halka
açık zaman sunucuları hakkında daha ayrıntılı bilgi için <a href="http://www.ntp.org">NTP sitesine bakınız</a>.</dd>
<dt><a href="http://www.perl.org/">Perl 5</a> [SEÇİMLİK]</dt>
<dd>Perl ile yazılmış <code class="program"><a href="./programs/apxs.html">apxs</a></code> veya
<code class="program"><a href="./programs/dbmmanage.html">dbmmanage</a></code> gibi bazı betikleri desteklemek için
Perl 5 yorumlayıcısı gerekir (5.003 veya daha yeni sürümleri
yeterlidir). Eğer <code class="program"><a href="./programs/configure.html">configure</a></code> betiği sisteminizde
Perl 5 yorumlayıcısı
bulamazsa bu betikleri kullanamazsınız. Ancak, bu durum Apache
HTTPd’nin derlenip kurulmasına engel değildir.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="download" id="download">İndirme</a></h2>
<p>Apache HTTP Sunucusunu, çeşitli yansıların da listelendiği <a href="http://httpd.apache.org/download.cgi">Apache HTTP Sunucusu
indirme sayfasından</a> indirebilirsiniz. Unix benzeri sistemler
kullanan Apache HTTPd kullanıcılarının kaynak paketlerinden birini
indirip derlemeleri daha iyi olacaktır. Derleme işlemi (aşağıda
açıklanmıştır) kolaydır ve sunucunuzu ihtiyaçlarınıza uygun olarak
kişiselleştirmenize imkan tanır. Ayrıca, hazır derlenmiş paketler
çoğunlukla en son kaynak sürüm kadar güncel değildirler. Eğer böyle bir
paket indirmişseniz, kurarken paketin içinde bulunan
<code>INSTALL.bindist</code> dosyasındaki talimatlara uyunuz.</p>
<p>İndirme işleminin ardından Apache HTTP Sunucusunun eksiksiz ve
değişikliğe uğramamış olduğunun doğrulanması önemlidir. Bu indirilen
tar paketinin PGP imzasına göre sınanması ile sağlanabilir. Bunun nasıl
yapılacağı <a href="http://httpd.apache.org/download.cgi#verify">indirme
sayfasında</a> anlatıldığı gibi <a href="http://httpd.apache.org/dev/verification.html">PGP
kullanımının</a> anlatıldığı daha geniş bir örnek de vardır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="extract" id="extract">Paketi açma</a></h2>
<p>Apache HTTP Sunucusu tar paketinden sıkıştırmayı kaldırdıktan sonra tar
arşivinden dosyaları çıkarmak basit bir işlemdir:</p>
<div class="example"><p><code>
$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar
</code></p></div>
<p>Bu işlem bulunduğunuz dizinin içinde dağıtımın kaynak dosyalarını
içeren yeni bir dizin oluşturacaktır. Sunucuyu derleme işlmine
başlayabilmek için önce <code>cd</code> ile bu dizine geçmelisiniz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configure" id="configure">Kaynak ağacının yapılandırılması</a></h2>
<p>Sonraki adım, Apache HTTPd kaynak ağacının platformunuza ve kişisel
gereksinimlerinize uygun olarak yapılandırılmasıdır. Bu işlem dağıtımın
kök dizininde bulunan <code class="program"><a href="./programs/configure.html">configure</a></code> betiği kullanılarak
yapılır. (Apache HTTPd kaynak ağacının resmen dağıtıma girmemiş bir
sürümünü indiren geliştiricilerin sistemlerinde <code>autoconf</code> ve
<code>libtool</code> kurulu olması ve sonraki adıma geçmek için
<code>buildconf</code> çalıştırmaları gerekir. Bu işlem resmi
dağıtımlar için gerekli değildir.)</p>
<p>Kaynak ağacını tamamen öntanımlı seçenekler kullanılarak derlemek için
<code>./configure</code> komutunu vermek yeterlidir. Öntanımlı
seçenekleri değiştirmek için <code class="program"><a href="./programs/configure.html">configure</a></code> betiği
çeşitli değişkenler ve komut satırı seçenekleri kabul eder.</p>
<p>En önemli seçenek, Apache HTTP Sunucusunun kurulacağı yerin
belirlenmesini, dolayısıyla Apache’nin bu konumda doğru olarak
çalışması için yapılandırılmasını sağlayan <code>--prefix</code>’tir.
Kurulacak dosyaların yerleri ile ilgili daha ayrıntılı denetim ek <a href="programs/configure.html#installationdirectories">yapılandırma
seçenekleri</a> ile mümkün kılınmıştır.</p>
<p>Bu noktada ayrıca, Apache HTTPd’de hangi özelliklerin bulunmasını
istediğinizi <a href="mod/">modülleri</a> etkin kılarak veya iptal
ederek belirtebilirsiniz. Apache, öntanımlı olarak içerilmiş pek çok
modülle gelir. Bunlar çalışma anında devereye sokulup çıkarılabilen <a href="dso.html">paylaşımlaı nesneler (DSO'lar)</a> olarak derlenebilir.
Ayrıca, istediğiniz modülleri derleme sırasında
<code>--enable-<var>module</var>=static</code> seçeneğini kullanarak
durağan olarak derleyebilirsiniz. Ek modüller <code>--enable-
<var>modül</var></code> seçenekleri kullanılarak etkinleştirilir.
Buradaki <code><var>modül</var></code>, önünden <code>mod_</code> dizgesi
kaldırılmış ve içindeki altçizgi imleri tire imleri ile değiştirilmiş
modül ismidir. Temel modülleri de benzer şekilde
<code>--disable-<var>modül</var></code> seçenekleriyle iptal
edebilirsiniz. <code class="program"><a href="./programs/configure.html">configure</a></code> betiği mevcut olmayan
modüller için sizi uyarmayıp, seçeneği yok saymakla yetineceğinden, bu
seçenekleri kullanırken dikkatli olmalısınız.</p>
<p>Ek olarak, bazen kullandığınız derleyici, kütüphaneler veya başlık
dosyalarının yerleri hakkında <code class="program"><a href="./programs/configure.html">configure</a></code> betiğine
ilave bilgiler sağlamanız gerekir. Bu işlem
<code class="program"><a href="./programs/configure.html">configure</a></code> betiğine ya ortam değişkenleriyle ya da
komut satırı seçenekleriyle bilgi aktarılarak yapılır. Daha fazla bilgi
için <code class="program"><a href="./programs/configure.html">configure</a></code> kılavuz sayfasına bakınız.</p>
<p>Apache’yi derlerken ne gibi olasılıklara sahip olduğunuz hakkında bir
izlenim edinmeniz için aşağıda tipik bir örneğe yer verilmiştir. Bu
örnekte, Apache’nin <code>/sw/pkg/apache</code> önekiyle başlayan
dizinlere kurulması, belli bir derleyici ve derleyici seçenekleriyle
derlenmesi ve <code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code> ve
<code class="module"><a href="./mod/mod_lua.html">mod_lua</a></code>modüllerinin de DSO mekanizması üzerinden
daha sonra yüklenmek üzere derlenmesi istenmektedir:</p>
<div class="example"><p><code>
$ CC="pgcc" CFLAGS="-O2" \<br />
./configure --prefix=/sw/pkg/apache \<br />
--enable-ldap=shared \<br />
--enable-lua=shared
</code></p></div>
<p><code class="program"><a href="./programs/configure.html">configure</a></code> betiği başlatıldığında sisteminizde
mevcut özelliklerin işe yararlığını sınamak ve sonradan sunucuyu
derlemek için kullanılacak Makefile dosyalarını oluşturmak için bir kaç
dakika çalışacaktır.</p>
<p><code class="program"><a href="./programs/configure.html">configure</a></code> seçeneklerinin tamamı ayrıtılı olarak
<code class="program"><a href="./programs/configure.html">configure</a></code> kılavuz sayfasında açıklanmıştır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="compile" id="compile">Derleme</a></h2>
<p>Artık, Apache HTTPd paketini şekillendiren çeşitli parçaları derlemek
için basitçe aşağıdaki komutu verebilirsiniz:</p>
<div class="example"><p><code>$ make</code></p></div>
<p>Bu komutu verdikten sonra lütfen sabırlı olunuz. Temel yapılandırmanın
derlenmesi bir kaç dakika alsa da modüllerin derlenmesi donanımınıza ve
seçtiğiniz modüllerin sayısına bağlı olarak daha uzun süre
gerektirecektir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">Kurulum</a></h2>
<p>Şimdi sıra <code><em>ÖNEK</em></code> dizini altına kurulmak üzere
yapılandırdığınız (yukarı <code>--prefix</code> seçeneğine bakınız)
paketi kurmaya geldi. Basitçe şu komutu veriniz:</p>
<div class="example"><p><code># make install</code></p></div>
<p><code><em>ÖNEK</em></code> dizininde genellikle yazma izinlerinin
sınırlı oluşu nedeniyle bu adım genellikle root yetkilerini
gerektirir.</p>
<p>Eğer sürüm yükseltiyorsanız, kurulum sırasında mevcut yapılandırma
dosyalarının ve belgelerin üzerine yazılmayacaktır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="customize" id="customize">Kişiselleştirme</a></h2>
<p>Bu adımda, Apache HTTP Sunucunuzu <code><em>ÖNEK</em>/conf/</code>
dizini altındaki <a href="configuring.html">yapılandırma
dosyalarını</a> düzenleyerek kişiselleştirebilirsiniz.</p>
<div class="example"><p><code>$ vi <em>ÖNEK</em>/conf/httpd.conf</code></p></div>
<p>Bu kılavuz ve kullanılabilecek <a href="mod/directives.html">yapılandırma yönergelerinin</a> kılavuzlarını
<code><em>ÖNEK</em>/<a href="./">docs/manual/</a></code> altında
bulabileceğiniz gibi en son sürümünü daima <a href="http://httpd.apache.org/docs/2.4/">http://httpd.apache.org/docs/2.4/</a> adresinde
bulabilirsiniz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="test" id="test">Deneme</a></h2>
<p>Artık Apache HTTP Sunucunuzu <a href="invoking.html">başlatmaya</a>
hazırsınız. Hemen şu komutu verin:</p>
<div class="example"><p><code>$ <em>ÖNEK</em>/bin/apachectl -k start</code></p></div>
<p><code>http://localhost/</code> üzerinden ilk belgeniz için bir istek
yapmalısınız. Genellikle <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> olarak bilinen
<code><em>ÖNEK</em>/htdocs/</code> altındaki sayfayı görürsünüz.
Çalışmakta olan sunucuyu <a href="stopping.html">durdurmak</a> için şu
komutu verebilirsiniz:</p>
<div class="example"><p><code>$ <em>ÖNEK</em>/bin/apachectl -k stop</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="upgrading" id="upgrading">Yükseltme</a></h2>
<p>Sürüm yükseltme işleminin ilk adımı, sitenizi etkileyen değişiklikleri
öğrenmek için dağıtım duyurusunu ve kaynak paketindeki
<code>CHANGES</code> dosyasını okumaktır. Ana sürümlerden yükseltme
yapıyorsanız (2.0’ten 2.2’ye veya 2.2’den 2.4’e gibi), derleme anı ve
çalışma anı yapılandırmalarındaki ana farklılıklar elle ayarlamalar
yapmanızı gerektirecektir. Ayrıca, tüm modüllerin de modül API’sindeki
değişikliklere uyum sağlaması için yükseltilmesi gerekecektir.</p>
<p>Aynı ana sürüm içinde yükseltme yapmak (2.2.55’ten 2.2.57’ye
yükseltmek gibi) daha kolaydır. <code>make install</code> işlemi,
mevcut yapılandırma ve günlük dosyalarınızın ve belgelerin üzerine
yazmayacaktır. Ek olarak, geliştiriciler alt sürüm değişikliklerinde
<code class="program"><a href="./programs/configure.html">configure</a></code> seçenekleri, çalışma anı yapılandırması
veya modül API’sinde uyumsuz değişiklikler yapmamaya özen
göstereceklerdir. Çoğu durumda, aynı <code class="program"><a href="./programs/configure.html">configure</a></code> komut
satırını, aynı yapılandırma dosyasını kullanabileceksiniz ve tüm
modülleriniz de çalışmaya devam edebilecektir.</p>
<p>Aynı ana sürüm içinde yükseltme işlemine, eski kaynak ağacının kök
dizininde veya kurulu sunucunuzun <code>build</code> dizininde
bulacağınız <code>config.nice</code> dosyasını yeni kaynak ağacının kök
dizinine kopyalamak suretiyle başlayabilirsiniz. Bu dosya evvelce
kaynak ağacını yapılandırmakta kullandığınız
<code class="program"><a href="./programs/configure.html">configure</a></code> komut satırını içerir.
<code>config.nice</code> dosyasında yapmak istediğiniz değişiklikler
varsa yaptıktan sonra şu komutları veriniz:</p>
<div class="example"><p><code>
$ ./config.nice<br />
$ make<br />
$ make install<br />
$ <em>ÖNEK</em>/bin/apachectl -k graceful-stop<br />
$ <em>ÖNEK</em>/bin/apachectl -k start<br />
</code></p></div>
<div class="warning">Her yeni sürümü hizmete sokmadan önce daima çalışma
ortamınızda denemeniz gerekir. Örneğin, yükseltme işlemini
sonuçlandırmadan önce eski sürümün çalışmasını durdurmadan yenisini
farklı bir <code>--prefix</code> ile kurabilir ve farklı bir port ile
(<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergesini
ayarlamak suretiyle) çalıştırabilirsiniz.</div>
<p>Özgün <code class="program"><a href="./programs/configure.html">configure</a></code> seçeneklerinizi değiştirmek veya
yeni seçenekler eklemek isterseniz bunları <code>config.nice</code>
betiğine komut satırı argümanları olarak belirtebilirsiniz:</p>
<div class="example"><p><code>
$ ./config.nice --prefix=/home/dnm/apache --with-port=90
</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="thirdp" id="thirdp">Üçüncü parti paketler</a></h2>
<p>Üçüncü partilerin çoğunun, Apache HTTP Sunucusunun belli bir platforma
kurulumu için paketlenmiş kendi dağıtımları vardır. Çeşitli Linux
dağıtımları, üçüncü parti Windows paketleri, Mac OS X, Solaris ve daha
pek çokları bunlar arasında sayılabilir.r</p>
<p>Yazılım lisansımız bu çeşit yeniden dağıtımlara izin verdiği gibi
bunları cesaretlendirir de. Ancak, sunucunun kurulum ve yapılandırmasının
belgelerimizde belittiğimizden farklı olması gibi bir durum ortaya
çıkabilir. Ne yazık ki, bu durum yakın zamanda değişecekmiş gibi
görünmüyor.</p>
<p>Bu <a href="http://wiki.apache.org/httpd/DistrosDefaultLayout">üçüncü parti
dağıtımlarla ilgili bir açıklamaya</a> HTTP
Sunucu wikisinde yer verilmiş olup bunların şu anki durumunu
yansıtmaktadır. Ancak, yine de, dağıtımınızın belli platformlarla ilgili
paket yönetimi ve kurulum işlemleri hakkında bilgi sahibi olmanız
gerekmektir.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/install.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/invoking.html.tr.utf8 0000664 0001751 0001751 00000032614 14743132254 021065 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTPd’nin başlatılması - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache HTTPd’nin başlatılması</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" title="Türkçe"> tr </a></p>
</div>
<p>Apache normal olarak, Windows'ta bir hizmet olarak çalışır. Ayrıntılı
bilgi için <a href="platform/windows.html#winsvc">Apache HTTPD’nin bir
hizmet olarak çalıştırılması</a> bölümüne bakınız.</p>
<p>Unix’te ise artalanda isteklere yanıt vermek için sürekli çalışan bir
artalan sürecidir. Bu belgede <code class="program"><a href="./programs/httpd.html">httpd</a></code>’nin nasıl
çalıştırılacağı açıklanmaktadır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#startup">Apache Nasıl Başlatılır?</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errors">Başlatma Sırasındaki Hatalar</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#boot">Sistem Açılışında Başlatma</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#info">Ek Bilgiler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="stopping.html">Durdurma ve Yeniden Başlatma</a></li><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="#comments_section">Yorumlar</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="startup" id="startup">Apache Nasıl Başlatılır?</a></h2>
<p>Yapılandırma dosyasında <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergesi ile öntanımlı olan port
80 (veya 1024’ten küçük herhangi bir port) belirtilmişse Apache HTTP
Sunucusunu başlatmak için root yetkileri gerekecektir. Sunucu başlatılıp
günlük dosyalarını açmak gibi bazı ön hazırlık etkinliklerinde
bulunduktan sonra istemcilerden gelen istekleri dinlemek ve yanıt vermek
için çeşitli <em>çocuk</em> süreçler başlatır. Ana
<code class="program"><a href="./programs/httpd.html">httpd</a></code> süreci root kullanıcısının aidiyetinde
çalışmasını sürdürürken çocuk süreçler daha az yetkili bir kullanıcının
aidiyetinde çalışır. Bu işlem seçilen <a href="mpm.html">Çok Süreçlilik
Modülü</a> tarafından denetlenir.</p>
<p><code class="program"><a href="./programs/httpd.html">httpd</a></code>’yi çalıştırmak için önerilen yöntem
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> betiğini kullanmaktır. Bu betik,
<code class="program"><a href="./programs/httpd.html">httpd</a></code>’nin bazı işletim sistemlerinde işlevini
gerektiği gibi yerine getirebilmesi için gereken belli ortam
değişkenlerini ayarlar ve <code class="program"><a href="./programs/httpd.html">httpd</a></code>’yi çalıştırır.
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code>, komut satırı argümanlarını
<code class="program"><a href="./programs/httpd.html">httpd</a></code>’ye aktarabildiğinden gerekli
<code class="program"><a href="./programs/httpd.html">httpd</a></code> seçenekleri <code class="program"><a href="./programs/apachectl.html">apachectl</a></code>
betiğine komut satırı seçenekleri olarak belirtilebilir. Ayrıca,
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> betiğinin içeriğini doğrudan düzenlemek
suretiyle betiğin başlangıç satırlarındaki <code>HTTPD</code>
değişkenine <code class="program"><a href="./programs/httpd.html">httpd</a></code> çalıştırılabilir dosyasının doğru
yerini ve <em>daima</em> mevcut olmasını istediğiniz komut satırı
seçeneklerini belirtebilirsiniz.</p>
<p><code>httpd</code> çalıştırıldığında yaptığı ilk şey <a href="configuring.html">yapılandırma dosyası</a>
<code>httpd.conf</code>’u bulup okumaktır. Bu dosyanın yeri derleme
sırasında belirtilmekteyse de <code>-f</code> komut satırı seçeneği
kullanılarak çalıştırma sırasında belirtmek de mümkündür:</p>
<div class="example"><p><code>/usr/local/apache2/bin/apachectl -f
/usr/local/apache2/conf/httpd.conf</code></p></div>
<p>Başlatma sırasında herşey yolunda giderse sunucu kendini uçbirimden
ayıracak ve hemen ardından uçbirim, komut istemine düşecektir. Bu,
sunucunun etkin ve çalışmakta olduğunu gösterir. Artık tarayıcınızı
kullanarak sunucuya bağlanabilir ve <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> dizinindeki deneme sayfasını
görebilirsiniz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errors" id="errors">Başlatma Sırasındaki Hatalar</a></h2>
<p>Apache başlatma sırasında ölümcül bir sorunla karşılaşacak olursa
çıkmadan önce sorunu açıklayan bir iletiyi konsola veya <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> yönergesi ile belirtilen hata
günlüğüne yazacaktır. En çok karşılaşılan hata iletilerinden biri
"<code>Unable to bind to Port ...</code>" dizgesidir. Bu iletiye
genellikle şu iki durumdan biri sebep olur:</p>
<ul>
<li>Sunucunun, root yetkileri gerektiren bir portu kullanmak üzere root
kullanıcısı tarafından çalıştırılmamış olması.</li>
<li>Aynı portu kullanan başka bir Apache Sunucusunun veya başka bir HTTP
sunucusunun zaten çalışmakta oluşu.</li>
</ul>
<p>Bu ve diğer sorun çözme talimatları için Apache <a href="http://wiki.apache.org/httpd/FAQ">SSS</a>’sini inceleyiniz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="boot" id="boot">Sistem Açılışında Başlatma</a></h2>
<p>Sunucunuzun sistem yeniden başlatıldıktan sonra çalışmasına devam
etmesini istiyorsanız sistem başlatma betiklerinize (genellikle ya
<code>rc.local</code> dosyasıdır ya da bir <code>rc.N</code> dizininde
bir dosyadır) <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> betiği için bir çağrı
eklemelisiniz. Bu, Apache sunucunuzu root yetkileriyle başlatacaktır.
Bunu yapmadan önce sunucunuzun güvenlik ve erişim kısıtlamaları
bakımından gerektiği gibi yapılandırıldığından emin olunuz.</p>
<p><code class="program"><a href="./programs/apachectl.html">apachectl</a></code> betiği, bir standart SysV init betiği gibi
davranacak şekilde tasarlanmıştır. <code>start</code>,
<code>restart</code> ve <code>stop</code> argümanlarını kabul edebilir
ve bunları <code class="program"><a href="./programs/httpd.html">httpd</a></code>’ye uygun sinyallere dönüştürebilir.
Bu bakımdan, çoğunlukla uygun init dizinlerinden birine
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> betiği için basitçe bir bağ
yerleştirebilirsiniz. Fakat bunu yapmadan önce betiğin sisteminizin
gereklerini yerine getirdiğinden emin olunuz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="info" id="info">Ek Bilgiler</a></h2>
<p><code class="program"><a href="./programs/httpd.html">httpd</a></code>, <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> ve sunucuyla
gelen diğer destek programlarının komut satırı seçenekleri hakkında ek
bilgi <a href="programs/">Sunucu ve Destek Programları</a> sayfasında
bulunabilir. Ayrıca, Apache dağıtımında bulunan tüm <a href="mod/">modüller</a> ve bunlarla sağlanan <a href="mod/directives.html">yönergeler</a> hakkında da belgeler
vardır.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/invoking.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/logs.html.tr.utf8 0000664 0001751 0001751 00000125163 14743132254 020207 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Günlük Dosyaları - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Günlük Dosyaları</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/logs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/logs.html" title="Türkçe"> tr </a></p>
</div>
<p>Bir HTTP sunucusunu verimli şekilde yönetebilmek için oluşabilecek
sorunlardan başka sunucunun başarımı ve etkinliği hakkında da bazı geri
bildirimler almak gerekir. Apache HTTP Sunucusu çok kapsamlı ve esnek
bir günlükleme yeteneğine sahiptir. Bu belgede sunucunun günlükleme
yeteneğini nasıl yapılandıracağınızdan ve günlük kayıtlarını nasıl
yorumlayacağınızdan bahsedilecektir.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Giriş</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#security">Güvenlik Uyarısı</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errorlog">Hata Günlüğü</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#permodule">Modüllere göre günlükleme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#accesslog">Erişim Günlüğü</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rotation">Günlük Çevrimi</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#piped">Borulu Günlükler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Sanal Konaklar</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">Diğer Günlük Dosyaları</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="overview" id="overview">Giriş</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td /></tr></table>
<p>Apache HTTP Sunucusu, isteğin ilk alınışından itibaren, URL eşleme
işlemleri, bağlantının son çözümlemesi ve bu işlemler sırasına ortaya çıkan
hatalar da dahil olmak üzere sunucunuzda meydana gelen herşeyi günlüklemek
için çok çeşitli mekanizmalar içerir. Buna ek olarak, günlükleme
yetenekleri sağlayan üçüncü parti modüller de kullanılabilir veya mevcut
günlük dosyalarına girdiler enjekte edilebilir. Ayrıca, CGI programları,
PHP betikleri ve benzerleri sunucu hata günlüğüne kendi iletilerini
gönderebilirler.</p>
<p>Bu belgede Apache HTTP Sunucusunun standart parçası olan günlükleme
modülleri hakkında bilgi verilecektir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Güvenlik Uyarısı</a></h2>
<p>Apache httpd’nin günlük dosyalarını yazdığı dizine yazabilen birinin sunucuyu
başlatan kullanıcı kimliğine (bu genellikle root olur) erişim
kazanabileceğine hemen hemen kesin gözüyle bakılabilir. Sonuçlarının
neler olacağını kestiremiyorsanız günlüklerin yazıldığı dizinde <em>hiç
kimseye</em> yazma erişimi vermeyin; ayrıntılı bilgi için <a href="misc/security_tips.html">güvenlik ipuçları</a> belgesine
bakınız.</p>
<p>Buna ilaveten, günlük dosyaları istemci tarafından sağlanmış bilgiler
de içerebilir. Bu nedenle, kötü niyetli istemcilerin günlük dosyalarına
denetim karakterleri girmeleri olasılığına karşı ham günlükler ele
alınırken dikkatli olunmalıdır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errorlog" id="errorlog">Hata Günlüğü</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code></li><li><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code></li></ul></td></tr></table>
<p>İsmi ve yeri <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> yönergesi
ile belirtilen sunucu hata günlüğü, en önemli günlük dosyasıdır. Apache
httpd tarafından istekler işlenirken saptanan hatalar ve tanı bilgileri
bu dosyaya gönderilir. Sunucuyu başlatırken veya sunucu çalışırken bir
sorunla karşılaşıldığında, neyin yanlış gittiğini öğrenmek için
bakılacak ilk yer burasıdır. Günlük kaydı çoğunlukla sorunun nasıl
düzeltileceği ile ilgili ayrıntıları da içerir.</p>
<p>Hata günlüğü normal olarak bir dosyaya yazılır (genellikle, dosyanın
ismi Unix sistemlerinde <code>error_log</code>, OS/2 ve Windows’ta ise
<code>error.log</code>’dur). Ayrıca, Unix sistemlerinde sunucunun
hataları <code>syslog</code>’a veya <a href="#piped">borulamak suretiyle
bir programa</a> aktarması da mümkündür.</p>
<p>Hata günlüğünün biçemi <code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code> yönergesi ile belirlenir. Bu yönergeyi
kullanarak günlüklenen değerleri özelleştirebilirsiniz. Bir biçem
belirtmezseniz öntanımlı biçem kullanılır. Örnek tipik bir hata iletisi
içermektedir:</p>
<div class="example"><p><code>
[Fri Sep 09 10:42:29.902022 2011] [core:error] [pid 35708:tid 4328636416]
[client 72.15.99.187] Dosya yok: /usr/local/apache2/htdocs/favicon.ico
</code></p></div>
<p>Günlük girdisinin ilk öğesi iletinin yazıldığı tarih ve saatten oluşur.
İkincisi iletiyi üreten modülün ismi (bu durumda: core) ile raporlanan
bilginin önem derecesini belirtir. Bunu varsa sürecin kimliği ve yine
varsa evre kimliği izler. Sonraki öğe hatanın üretilmesine sebep olan
istemcinin IP adresini içerir. Kalanı iletinin kendisidir (duruma
bakılırsa bir dosyaya yapılan istek yerine getirilememiş).</p>
<p>Hata günlüğünde görünebilecek ileti çeşitliliği oldukça fazladır. Çoğu
yukarıdaki örneğin benzeridir. Hata günlüğü ayrıca, CGI betiklerinin
hata ayıklama çıktılarını da içerir. Bir CGI betiği tarafından standart
hataya (<code>stderr</code>) yazılan her türlü bilgi doğrudan hata
günlüğüne kopyalanır.</p>
<p>Hata günlüğüne ve erişim günlüğüne <code>%L</code> dizgeciği konularak
erişim günlüğündeki girdi ile hata günlüğündeki girdiyi ilişkilendirecek
bir günlük girdisi kimliği oluşturulabilir.
<code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code> yüklüyse günlük girdisi kimliği olarak
onun eşsiz istek kimliği de kullanılır.</p>
<p>Sunucuyu denerken olası sorunlara karşı hata günlüğünü sürekli
izlemelisiniz. Unix sistemlerinde bunu şöyle bir komutla
sağlayabilirsiniz:</p>
<div class="example"><p><code>
tail -f error_log
</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="permodule" id="permodule">Modüllere göre günlükleme</a></h2>
<p><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> yönergesi, günlük
iletisinin üretilmesine sebep olan modüle bağlı bir önem seviyesi
belirleyebilmenizi sağlar. Bu yolla sorun yaşadığınız modülle ilgili
günlük musluklarını sonuna kadar açabiliri ek olarak ilgilendiğiniz diğer
modüllerle ilgili ayrıntıları da edinebilirsiniz. Özellikle
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> veya <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> gibi
modüllerde yapılmak isteneni denerken neler olup bittiğini ayrıntılarıyla
bilmek istediğiniz durumlarda kullanışlıdır.</p>
<p>Bunu <code class="directive">LogLevel</code> yönergesinde modülün ismini
belirterek yapabilirsiniz:</p>
<pre class="prettyprint lang-config">LogLevel info rewrite:trace5</pre>
<p>Bu satırla ana <code class="directive">LogLevel</code> info'ya ayarlanırken
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> için musluk <code>trace5</code> seviyesine
kadar açılmaktadır.</p>
<div class="note">Bu yönerge, Apache HTTP Sunucusunun evvelki sürümlerinde mevcut olan
<code>RewriteLog</code> gibi günlükleme modüllerinin yerini almıştır.
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="accesslog" id="accesslog">Erişim Günlüğü</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li></ul></td></tr></table>
<p>Sunucu erişim günlüğü sunucu tarafından işleme alınan tüm istekleri
kaydeder. Erişim günlüğünün yeri ve içeriği <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> yönergesi ile belirlenir.
<code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> yönergesi ile
günlük içeriğini kişiselleştirmek mümkündür. Bu bölümde sunucunun
bilgileri erişim günlüğüne kaydetmesi için nasıl yapılandırılacağından
bahsedilecektir.</p>
<p>Bilginin erişim günlüğünde saklanması günlük yönetiminde ilk
adımı oluşturur. Sonraki adım yararlı istatistikleri üretmek için bu
bilgiyi incelemektir. Günlük incelemesi bu belgenin kapsamına dahil
değildir ve aslında bu işlem sunucunun yaptığı işlerden biri
değildir.</p>
<p>Apache httpd’nin çeşitli sürümlerinde erişim günlüklerini denetlemek
için kullanılan diğer modüller ve yönergeler arasında mod_log_referer,
mod_log_agent modülleri ve <code>TransferLog</code> yönergesi
sayılabilir. Artık, daha eski tüm diğer yönergelerin işlevselliklerini
bir araya toplayan <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> yönergesi kullanılmaktadır.</p>
<p>Erişim günlüğünün girdi biçemi kolayca isteğe göre
düzenlenebilmektedir. Biçemi belirtmekte kullanılan biçem dizgesi, C
tarzı printf(1) biçem dizgesini andırır. Sonraki bölümlerde bazı
örneklere yer verilmiştir. Biçem dizgesini oluşturan belirteçlerin tam
listesi için <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code> belgesinin <a href="mod/mod_log_config.html#formats">Günlük Girdilerinin
Kişiselleştirilmesi</a> bölümüne bakınız.</p>
<h3><a name="common" id="common">Ortak Günlük Biçemi (OGB)</a></h3>
<p>Erişim günlüğü için sıklıkla kullanılan bir yapılandırma:</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common</pre>
<p>İlk satırda belli bir biçem dizgesi için <code>common</code> diye bir
<em>takma ad</em> tanımlanmaktadır. Biçem dizgesi, sunucuya hangi
belli bir bilgi parçalarını günlükleyeceğini söyleyen % imli biçem
belirteçlerinden oluşur. Biçem dizgesine ayrıca dizgesel sabitler de
yerleştirilebilir ve bunlar erişim günlüğüne oldukları gibi
kopyalanırlar. Biçem dizgesi içinde çift tırnak karakteri (") biçem
dizgesini vaktinden önce sonlandırmaması için ters bölü çizgisi ile
öncelenmelidir. Biçem dizgesi ayrıca, satır sonlarını belirtmek için
"<code>\n</code>" ve sekmeleri belirtmek için "<code>\t</code>"
denetim karakterlerini de içerebilir.</p>
<p><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> yönergesi
evvelce tanımlanmış bir <em>takma adı</em> kullanarak yeni bir günlük
dosyası tanımlar. Erişim günlüğünün dosya ismi bölü çizgisi ile
başlamadıkça dosya yolunun <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> değerine göreli olduğu varsayılır.</p>
<p>Yukarıdaki yapılandırma günlük dosyasına girdileri Ortak Günlük
Biçemi (Common Log Format) adı verilen standart biçemde yazar.
Bu standart biçem başka HTTP sunucuları tarafından da kullanılır ve
çoğu günlük inceleme yazılımı tarafından tanınır. Ortak Günlük
Biçeminde üretilen günlük girdileri şöyle görünür:</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
</code></p></div>
<p>Bu günlük girdisini parça parça açıklayalım:</p>
<dl>
<dt><code>127.0.0.1</code> (<code>%h</code>)</dt>
<dd>Bu, sunucuya istek yapan istemcinin (uzak konağın) IP adresidir.
Eğer <code class="directive"><a href="./mod/core.html#hostnamelookups">HostnameLookups</a></code>
yönergesine <code>On</code> değeri atanmışsa sunucu bu IP adresi
için DNS sorgusu yapacak ve IP adresi yerine bulduğu konak ismini
yazmaya çalışacaktır. Bununla birlikte, bu işlem sunucuyu epeyce
yavaşlattığından önerilmemektedir. Konak isimlerini saptamak için en
iyisi günlük girdilerini <code class="program"><a href="./programs/logresolve.html">logresolve</a></code> gibi bir
günlük işlemcisinden geçirmektir. Burada raporlanan IP adresi
doğrudan istemcinin IP adresi olmayabilir. Eğer sunucu ile istemci
arasında bir vekil sunucu varsa bu IP adresi, vekil sunucunun IP
adresi olacaktır.</dd>
<dt><code>-</code> (<code>%l</code>)</dt>
<dd>Çıktıdaki bir "tire" imi istenen bilgi parçasının mevcut olmadığı
anlamına gelir. Bu durumda, mevcut olmayan bilgi istemci makine
üzerinde <code>identd</code> tarafından belirlenen istemcinin RFC
1413 kimliğidir. Bu bilgi oldukça güvenilmezdir ve sıkıca denetlenen
iç ağlar haricinde hemen hemen asla kullanılmamalıdır. Apache,
<code class="directive"><a href="./mod/mod_ident.html#identitycheck">IdentityCheck</a></code> yönergesine
<code>On</code> değeri atanmış olmadıkça bu bilgiyi saptamaya
uğraşmaz.</dd>
<dt><code>frank</code> (<code>%u</code>)</dt>
<dd>Bu, belge isteğinde bulunan kişinin HTTP kimlik doğrulamasıyla
saptanan kullanıcı kimliğidir. Bu değer CGI betiklerine
<code>REMOTE_USER</code> ortam değişkeni ile sağlanır. Eğer istek
için durum kodu 401 ise (aşağıya bakınız) henüz kullanıcının kimliği
doğrulanmamış olacağından bu değere güvenilmemelidir. Eğer belge
parola korumalı değilse günlüğün bu kısmı da yukarıdaki gibi
"<code>-</code>" olacaktır.</dd>
<dt><code>[10/Oct/2000:13:55:36 -0700]</code>
(<code>%t</code>)</dt>
<dd>İsteğin alındığı tarih ve saat. Biçemi şöyledir:
<p class="indent">
<code>[gün/ay/yıl:saat:dakika:saniye dilim]<br />
gün = 2 hane<br />
ay = 3 harf<br />
yıl = 4 hane<br />
saat = 2 hane<br />
dakika = 2 hane<br />
saniye = 2 hane<br />
dilim = (`+' | `-') 4 hane</code>
</p>
<p>Günlük biçem dizgesinde zaman gösterim biçemini
<code>%{<em>biçem</em>}t</code> şeklinde belirtmek de mümkündür.
Buradaki <code><em>biçem</em></code> dizgesi, stardart C
kütüphanesindeki <code>strftime(3)</code> işlevi için tanımlanmış
biçem belirteçleriyle veya desteklenen özel belirteçlerle
oluşturulabilir. Ayrıntılı bilgi için <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code>
<a href="mod/mod_log_config.html#formats">biçem dizgelerine</a>
bakın.</p>
</dd>
<dt><code>"GET /apache_pb.gif HTTP/1.0"</code>
(<code>\"%r\"</code>)</dt>
<dd>İstemciden alınan istek satırının çift tırnaklar arasında
gösterilmesi istenmiştir. İstek satırı en yararlı bilgi parçalarını
içerir. Birincisi, istemci tarafından kullanılan yöntem
<code>GET</code>’miş. İkinci olarak istemci
<code>/apache_pb.gif</code> dosyasını istemiş ve üçüncü olarak
istemci <code>HTTP/1.0</code> protokolünü kullanmış. İstek satırının
bazı parçalarını bağımsız olarak da günlüklemek mümkündür. Örneğin,
"<code>%m %U%q %H</code>" dizgesi, yöntem, yol, sorgu dizgesi ve
protokolü kaydedecektir; bu dizge "<code>%r</code>" biçem
belirtecinin tek başına yaptığı işi yapar.</dd>
<dt><code>200</code> (<code>%>s</code>)</dt>
<dd>Bu, sunucunun istemciye gönderdiği durum kodudur. İsteğin
başarıyla yerine getirilip getirilmediğini gösterdiği için bu bilgi
çok değerlidir. Durum kodu 2 ile başlıyorsa istek başarıyla yerine
getirilmiştir, 3 ile başlıyorsa yönlendirilmiştir, 4 ile başlıyorsa
istemci tarafında bir hata oluşmuştur, 5 ile başlıyorsa sunucuda bir
hata oluşmuştur. Olası hata kodlarının tam listesi <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">RFC2616 Hiper
Metin Aktarım Protokolü</a>nün 10. bölümünde bulunabilir.</dd>
<dt><code>2326</code> (<code>%b</code>)</dt>
<dd>Son parça istemciye döndürülen nesnenin yanıt başlığı hariç
uzunluğudur. Eğer istemciye bir içerik döndürülmemişse bu değer
"<code>-</code>" olacaktır. Bunun yerine günlüğe "<code>0</code>"
yazdırmak için <code>%B</code> belirtecini kullanınız.</dd>
</dl>
<h3><a name="combined" id="combined">Birleşik Günlük Biçemi</a></h3>
<p>Sıklıkla kullanılan diğer bir biçem dizgesi Birleşik Günlük Biçemi
(Combined Log Format) olup şöyle kullanılabilir:</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" combined
CustomLog log/access_log combined</pre>
<p>Bu biçem ilaveten 2 alan içermesi dışında Ortak Günlük Biçemi ile
aynıdır. İlave alanların ikisi de <code>%{<em>başlık</em>}i</code>
biçeminde olup buradaki <code><em>başlık</em></code>, HTTP isteğindeki
başlık alanlarından biridir. Bu biçemin kullanıldığı bir erişim
günlüğü girdisi şöyle olurdu:</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
"http://www.example.com/start.html" "Mozilla/4.08 [en]
(Win98; I ;Nav)"
</code></p></div>
<p>Ek alanlar:</p>
<dl>
<dt><code>"http://www.example.com/start.html"</code>
(<code>\"%{Referer}i\"</code>)</dt>
<dd>HTTP istek başlığı "Referer". İstemcinin raporladığı isteğin
kaynaklandığı URI. (Bu isteğin yapılmasını sağlayan bağlantıyı
içeren URL veya istek bir sayfanın bileşenleri ile ilgiliyse istenen
sayfanın URL’si olabilir.)</dd>
<dt><code>"Mozilla/4.08 [en] (Win98; I ;Nav)"</code>
(<code>\"%{User-agent}i\"</code>)</dt>
<dd>Tarayıcı kimliğini içeren HTTP istek başlığı. Bu istemcinin
tarayıcısının raporladığı kendi tanıtım bilgisidir.</dd>
</dl>
<h3><a name="multiple" id="multiple">Çok Sayıda Erişim Günlüğü</a></h3>
<p>Yapılandırma dosyasında çok sayıda <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> yönergesi kullanarak çok
sayıda erişim günlüğü kolayca oluşturulabilir. Örneğin aşağıdaki
yönergelerle 3 tane erişim günlüğü oluşturulacaktır. İlki temel OGB
bilgisini içerirken diğer ikisi isteğin kaynaklandığı yeri ve tarayıcı
kimliğini içerir. Son iki <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> satırı ayrıca, <code>ReferLog</code> ve
<code>AgentLog</code> yönergelerinin etkilerinin nasıl taklit
edileceğini de göstermektedir.</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common
CustomLog logs/referer_log "%{Referer}i -> %U"
CustomLog logs/agent_log "%{User-agent}i"</pre>
<p>Bu örnek ayrıca, <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> yönergesi ile bir takma ad tanımlamanın şart
olmadığını da göstermektedir. Günlük biçemi doğrudan <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> yönergesinde
belirtilebilir.</p>
<h3><a name="conditional" id="conditional">Şarta Bağlı Günlükler</a></h3>
<p>Bazı durumlarda istemcinin yaptığı isteğe bağlı olarak erişim
günlüğünde belli girdilerin dışlanması gerekebilir. Bu, <a href="env.html">ortam değişkenleri</a> sayesinde kolayca yerine
getirilebilir. Önce isteğin belli koşulları sağladığını belirten bir
ortam değişkeni ataması yapılır. Bu işlem <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> yönergesi ile yapılır.
Sonra da, ortam değişkenine bağlı olarak isteklerin günlüğe dahil
edilip edilmeyeceği <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> yönergesinin
<code>env=</code> deyimi kullanılarak belirtilir. Bazı örnekler:</p>
<pre class="prettyprint lang-config"># yerel konaktan kaynaklanan istekleri imleyelim
SetEnvIf Remote_Addr "127\.0\.0\.1" kaydetme
# robots.txt dosyası isteklerini imleyelim
SetEnvIf Request_URI "^/robots\.txt$" kaydetme
# Kalanları günlüğe kaydedelim
CustomLog logs/access_log common env=!kaydetme</pre>
<p>Başka bir örnek olarak, Türkçe belge isteklerini bir dosyaya diğer
dillerdeki istekleri başka bir dosyaya kaydedelim.</p>
<pre class="prettyprint lang-config">SetEnvIf Accept-Language "tr" turkce
CustomLog logs/turkce_log common env=turkce
CustomLog logs/diger_diller_log common env=!turkce</pre>
<p>Bir arabellekleme senaryosuna arabelleğin verimli kullanılıp
kullanılmadığını bilmek isteyelim. Bu basitçe şöyle yapılabilir:</p>
<pre class="prettyprint lang-config">SetEnv CACHE_MISS 1
LogFormat "%h %l %u %t "%r " %>s %b %{CACHE_MISS}e" common-cache
CustomLog logs/access_log common-cache</pre>
<p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> önce <code class="module"><a href="./mod/mod_env.html">mod_env</a></code> modülünü
çalıştıracak ve başarılı olunduğu takdirde içeriği onsuz teslim
edecektir. Bu durumda arabellek kaybı <code>1</code> olarak
günlüklenirken arabellek sunumu <code>-</code> olarak
günlüklenecektir.</p>
<p><code>env=</code> sözdizimine ek olarak, <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> HTTP yanıt kodudaki koşul
değerlerini günlüklemeyi de destekler:</p>
<pre class="prettyprint lang-config">LogFormat "%400,501{User-agent}i" browserlog
LogFormat "%!200,304,302{Referer}i" refererlog</pre>
<p>Bu örnekte, HTTP durum kodu 400 veya 501 ise <code>User-agent</code>
başlığı günlüklenecektir. Aksi takdirde, günlüğe bir "-" yazılacaktır.
Benzer şekilde ikinci örnekte, HTTP durum kodu 200, 304 veya 302
<strong>değilse</strong> (durum kodlarının öncesindeki "!" imine
dikkat) <code>Referer</code> başlığı günlüklenecektir.</p>
<p>Koşula bağlı günlük kaydının çok esnek ve güçlü olabileceğini
göstermiş olsak da günlük içeriğini denetlemenin tek yolu bu değildir.
Günlük dosyaları sunucu etkinliğini eksiksiz olarak kaydedebildikleri
takdirde daha yararlı olurlar. Günlük dosyalarını sonradan işleme tabi
tutarak istenmeyen girdileri kaldırılmış bir kopya almak hem kolay hem
de daha yararlıdır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="rotation" id="rotation">Günlük Çevrimi</a></h2>
<p>Yükü ağır sunucularda günlük dosyalarına kaydedilen bilginin miktarı
çok büyük boyutlara ulaşabilir. 10.000 istek içeren bir erişim günlüğü
yaklaşık 1MB yer kaplar. Etkin günlük dosyasını belirli aralıklarla
değiştirmek veya silmek gerekebilir. Apache httpd çalışırken dosyayı sürekli
açık tuttuğu ve yazdığı için bu işlem sunucu çalışırken yapılamaz. Bu
bakımdan, günlük dosyası değiştirildikten veya silindikten sonra yeni
dosyanın açılması için <a href="stopping.html">sunucunun yeniden
başlatılması</a> gerekir.</p>
<p><a href="stopping.html#graceful">Nazikçe yeniden başlatmak</a>
suretiyle sunucunun, mevcut ve bekleyen bağlantıları kaybetmeden yeni
günlük dosyalarını açması sağlanabilir. Bununla birlikte, bu işlem
sırasında sunucunun eski isteklere sunumu bitirene kadar eski günlük
dosyalarına yazmaya devam edebilmesi gerekir. Bu bakımdan, yeniden
başlatmanın ardından eski günlük dosyaları üzerinde bir işlem yapmadan
önce biraz beklemek gerekir. Günlük dosyalarını döndürürken kullanılan
senaryolarda genellikle eski günlük dosyaları yer kazanmak için
sıkıştırılırlar:</p>
<div class="example"><p><code>
mv access_log access_log.old<br />
mv error_log error_log.old<br />
apachectl graceful<br />
sleep 600<br />
gzip access_log.old error_log.old
</code></p></div>
<p>Günlük çevrimi yapmanın başka bir yolu da sonraki bölümde açıklandığı
gibi <a href="#piped">borulu günlükler</a> kullanmaktır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="piped" id="piped">Borulu Günlükler</a></h2>
<p>Apache httpd hata ve erişim günlüklerini doğrudan bir dosyaya yazmak
yerine bir boru üzerinden başka bir sürece yazabilir. Bu yetenek ana
sunucuya herhangi bir kod eklemeksizin günlükleme esnekliğini şaşırtıcı
derecede arttırır. Günlükler boruya yazılmak istenirse dosya ismini boru
karakteriyle ("<code>|</code>") değiştirip ardına günlük girdilerini
standart girdisinden kabul edecek programın ismini eklemek yeterlidir.
Apache httpd başlatıldığı zaman borulu günlük işlemini de
başlatacaktır. Eğer sunucu çalışırken günlükleri kabul eden süreç
çökerse Apache httpd bu programı yeniden başlatır. (Bu son özelliği
sebebiyle bu tekniğe “güvenilir borulu günlükleme” adını veriyoruz.)</p>
<p>Borulu günlük süreçleri ana Apache httpd süreci tarafından başlatılır
ve bu süreçler ana Apache httpd sürecinin kullanıcı kimliğini miras
alırlar. Yani borulu günlükleme programları aslında root tarafından
çalıştırılmış gibi olur. Bu bakımdan, bu programları basit ve güvenilir
kılmak çok önemlidir.</p>
<p>Borulu günlüklerin önemli kullanım alanlarından biri de sunucuyu
yeniden başlatmak gerekmeksizin günlük çevrimini mümkün kılmaktır.
Apache HTTP sunucusu bu amaçla kullanılmak üzere
<code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> diye bir program içerir. Örneğin,
günlükleri 24 saatte bir döndürmek isterseniz bunu şöyle
yapabilirsiniz:</p>
<pre class="prettyprint lang-config">CustomLog "|/usr/local/apache/bin/rotatelogs /var/log/access_log 86400" common</pre>
<p>Borunun diğer ucundaki süreci başlatacak komutun tırnak içine
alındığına dikkat ediniz. Bu örnekler erişim günlüğü için verilmişse de
aynı teknik hata günlüğü için de kullanılabilir.</p>
<p>Hariçten bir uygulama olarak <a href="http://www.cronolog.org/">cronolog</a> isminde buna benzer ancak
çok daha esnek bir program daha vardır.</p>
<p>Borulu günlükler de şarta bağlı günlükleme kadar güçlü olmakla beraber
çevrimdışı ardıl işlemler gibi daha basit çözümler için
kullanılmamalıdır.</p>
<p>Öntanımlı olarak borulu günlük süreci bir kabuk kullanmadan
çalıştırılır. Kabuk kullanarak (genelde <code>/bin/sh -c</code> ile)
yapılmak istenirse "<code>|</code>" yerine "<code>|$</code>"
kullanılır:</p>
<pre class="prettyprint lang-config"># Kabuk kullanarak "rotatelogs" çalıştırmak
CustomLog "|$/usr/local/apache/bin/rotatelogs /var/log/access_log 86400" common</pre>
<p>Bu, Apache 2.2 için öntanımlı davranıştı. Kabuk özelliklerine bağlı
olarak, yeniden başlatma sırasındaki sinyal işleme sorunları ve günlük
borulama uygulamasının yaşam süresi için ek bir kabuk süreci ile
sonuçlanabilir. Apache 2.2 ile uyumluluk açısından "<code>||</code>"
gösterimi de desteklenmekte olup "<code>|</code>" kullanımına
eşdeğerdir.</p>
<div class="note"><h3>Windows'ta yığın alanı</h3>
<p>Windows'ta çok sayıda borulu günlükleme süreci çalışırken ve özellikle
HTTPD bir hizmet olarak çalışıyorsa sorunlar baş gösterebilir. Bunun
başlıca sebebi masaüstü yığın alanının (heap) dışına taşılmasıdır. Her
hizmete ayrılan masüstü yığın alanı, kayıt defterindeki
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\SessionManager\SubSystems\Windows
kaydındaki üçüncü değiştirge olan <code>SharedSection</code>
değeridir. <strong>Bu değeri değiştirirken çok dikkatli olun</strong>;
bu, Windows kayıt defterini değiştirirken verilen normal
uyarılardandır, fakat eğer bu değer çok yüksek olursa masaüstü yığın
alanının tükenebileceği dikkate alınmalıdır.</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="virtualhost" id="virtualhost">Sanal Konaklar</a></h2>
<p>Bir sunucu çok sayıda <a href="vhosts/">sanal konak</a> ile hizmet
sunarken bunların günlük kayıtları için çeşitli seçenekler mevcuttur.
İlk seçenekte, sanki sunucu tek bir konakla hizmet sunuyormuş gibi
günlük kaydı yapılır. Günlükleme yönergelerini <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> bölümlerinin dışına, ana sunucu
bağlamına yerleştirerek tüm isteklerin aynı erişim ve hata günlüğüne
yazılmasını sağlamak olasıdır. Bu teknik, tek tek sanal konaklar için
kolayca istatistik toplamaya izin vermez.</p>
<p>Eğer <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
veya <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> yönergesi bir
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> bölümüne
yerleştirilirse bu sanal konağa bütün erişimler veya hatalar belirtilen
dosyaya günlüklenecektir. Böyle günlükleme yönergeleri içermeyen sanal
konakların günlükleri hala ana sunucunun hata ve erişim günlüklerine
yazılmaya devam edecektir. Bu teknik az sayıda sanal konak barındıran
sunucular için çok kullanışlıdır. Fakat sanal konak sayısı çok fazlaysa
bu teknikle günlük dosyalarını yönetmek çok karmaşık bir hal alabilir.
Ayrıca, <a href="vhosts/fd-limits.html">yetersiz dosya tanıtıcısı</a>
sorunlarıyla çok sık karşılaşılabilir.</p>
<p>Erişim günlükleri için çok az bir fedakarlıkla çok iyi bir çözüm vardır.
Günlük biçemine sanal konaklarla ilgili bilgi eklemek suretiyle tüm
konakların aynı günlük dosyasını kullanmaları olasıdır. Böylece günlük
dosyası sonradan her sanal konak için ayrı bir dosya oluşturmak üzere
ayrıştırılabilir. Örneğin, bu işlem için şu yönergeler kullanılıyor
olsun:</p>
<pre class="prettyprint lang-config">LogFormat "%v %l %u %t \"%r\" %>s %b" ortaksankon
CustomLog logs/access_log ortaksankon</pre>
<p><code>%v</code> belirteci isteği sunan sanal konağın ismini günlüğe
yazmak için kullanılır. Daha sonra <a href="programs/split-logfile.html">split-logfile</a> gibi bir program
kullanarak, bu dosyadan her sanal konak için ayrı birer dosya elde
edilebilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Diğer Günlük Dosyaları</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#bufferedlogs">BufferedLogs</a></code></li><li><code class="directive"><a href="./mod/mod_log_forensic.html#forensiclog">ForensicLog</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptloglength">ScriptLogLength</a></code></li></ul></td></tr></table>
<h3>Gönderilen ve alınan bayt sayısının günlüklenmesi</h3>
<p><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code> modülü <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> yönergesinde kullanılan
biçem belirteçlerine alınan ve gönderilen bayt sayıları için iki
belirteç (%I ve %O) ekler.</p>
<h3>Adli Günlük</h3>
<p><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code> modülü istemci isteklerinin kanıt
olarak kullanılmak amacıyla günlüklenmesini sağlar. Günlükleme her
istek için isteğe hizmet sunmadan önce ve sonra olmak üzere iki defa
yapılır. Böylece günlük dosyasında başarılı her istek için iki satır
bulunur. Adli günlükleme çok sıkı kurallara tabi olup
kişiselleştirilemez. Güvenlik ve hata ayıklama aracı olarak yararlı
değildir.</p>
<h3><a name="pidfile" id="pidfile">PID Dosyası</a></h3>
<p>Apache httpd başlatıldığında, ana httpd sürecinin kimliği (PID)
<code>logs/httpd.pid</code> dosyasına kaydedilir. Bu dosyanın ismi
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> yönergesi ile
değiştirilebilir. Bu süreç kimliği sistem yöneticisi tarafından ana
sürece sinyal göndererek artalan sürecini sonlandırmak veya yeniden
başlatmak için kullanılır. Windows üzerinde bu işlem için
<code>-k</code> komut satırı seçeneği kullanılır. Bu konuda daha
ayrıntılı bilgi edinmek için <a href="stopping.html">Durdurma ve
Yeniden Başlatma</a> belgesine bakınız.</p>
<h3><a name="scriptlog" id="scriptlog">Betik Günlüğü</a></h3>
<p><code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code> yönergesi CGI
betiklerinin girdi ve çıktılarını kaydetmenizi mümkün kılmak suretiyle
hata ayıklamaya yardımcı olur. Bu sadece deneysel amaçla kullanılmalı,
asıl sunucuya uygulanmamalıdır. <a href="mod/mod_cgi.html">mod_cgi</a>
belgesinde daha fazla bilgi bulunabilir.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/logs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/logs.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/logs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/install.html.ja.utf8 0000664 0001751 0001751 00000067115 14743132254 020660 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>コンパイルとインストール - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>コンパイルとインストール</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>この文書で扱う範囲は、Unix や Unix に類似したシステムでの
Apache のコンパイルとインストールです。 Windows における
コンパイルとインストールに関しては「<a href="platform/windows.html">Microsoft
Windows で Apache を使う</a>」をご覧下さい。
その他のプラットホームに関しては「<a href="platform/">プラットホーム</a>」をご覧下さい。</p>
<p>Apache 2.0 では他の Open Source プロジェクトと同様、
ビルド環境構築に <code>libtool</code> と <code>autoconf</code>
を使うようになっています。</p>
<p>マイナーバージョンからその次のバージョンにアップグレードする
(2.2.50 から 2.2.51 へ等) 場合は、まず <a href="#upgrading">
アップグレード</a>をご覧下さい。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">概要 (せっかちな人向け)</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#requirements">必要なもの</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#download">ダウンロード</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extract">展開</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configure">ソースツリーを設定する</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#compile">ビルド</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">インストール</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#customize">カスタマイズ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#test">テスト</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#upgrading">アップグレード</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="programs/configure.html">ソースツリーの設定</a></li><li><a href="invoking.html">Apacheの起動</a></li><li><a href="stopping.html">Apacheの停止と再起動</a></li><li><a href="#comments_section">コメント</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="overview" id="overview">概要 (せっかちな人向け)</a></h2>
<table>
<tr>
<td><a href="#download">ダウンロード</a></td>
<td><code>$ lynx http://httpd.apache.org/download.cgi</code>
</td>
</tr>
<tr>
<td><a href="#extract">展開</a></td>
<td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar<br />
$ cd httpd-<em>NN</em></code></td>
</tr>
<tr>
<td><a href="#configure">設定</a></td>
<td><code>$ ./configure --prefix=<em>PREFIX</em></code>
</td>
</tr>
<tr>
<td><a href="#compile">コンパイル</a></td>
<td><code>$ make</code> </td>
</tr>
<tr>
<td><a href="#install">インストール</a></td>
<td><code>$ make install</code> </td>
</tr>
<tr>
<td><a href="#customize">カスタマイズ</a></td>
<td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
</tr>
<tr>
<td><a href="#test">テスト</a></td>
<td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
</td>
</tr>
</table>
<p><em>NN</em> は最新のバージョンナンバーに、
<em>PREFIX</em> はインストールするサーバでのファイルシステムのパスに、
置き換えてください。<em>PREFIX</em> を指定しなかった場合は、
デフォルトの <code>/usr/local/apache2</code> になります。</p>
<p>Apache httpd のコンパイルとインストールに必要なものをはじめとして、
コンパイルとインストールについては、次に詳しく記述されています。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="requirements" id="requirements">必要なもの</a></h2>
<p>Apache のビルドには次のものが必要です:</p>
<dl>
<dt>ディスクスペース</dt>
<dd>ディスクに少なくとも 50 MB の一時的な空き容量があるように
気を付けてください。インストール後は Apache は 10 MB 程度の
ディスクスペースを占めます。実際に必要になるディスクスペースは、
設定オプションやサードパーティー製モジュールをどう選択するかによって
大きく変わるでしょう。</dd>
<dt>ANSI-C コンパイラとビルドシステム</dt>
<dd>ANSI-C コンパイラをインストールしておいて下さい。お薦めは <a href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
による <a href="http://www.gnu.org/software/gcc/gcc.html">GNU C
compiler (GCC)</a> です。GCC がない場合は、
少なくとも提供されているコンパイラが ANSI 準拠であることを確認しておいて下さい。
それから、変数 <code>PATH</code> には <code>make</code>
といった基本的なビルドツールが含まれている必要があります。</dd>
<dt>時刻を正確にする</dt>
<dd>HTTP プロトコルの要素は日時の時刻で表現されています。ですから、
正確な時刻にシンクロさせる機能をシステムに設定することを吟味してみて下さい。
Network Time Protocol (NTP) をベースとした ntpdate や xntpd プログラムが
この目的によく用いられます。NTP ソフトウェアや公開 NTP
サーバに関する詳細は、<a href="http://www.ntp.org">NTP ホームページ</a> をご覧下さい。</dd>
<dt><a href="http://www.perl.org/">Perl 5</a>
[オプション]</dt>
<dd>提供されているスクリプト幾つか、例えば <code class="program"><a href="./programs/apxs.html">apxs</a></code> や
<code class="program"><a href="./programs/dbmmanage.html">dbmmanage</a></code> は
Perl で書かれているので、Perl
5 インタプリタが必要になります (5.003 以降)。
Perl インタプリタを複数インストールしている (たとえば全体のシステムの一部
としてインストールされている Perl 4 と、自分で追加でインストールした
Perl 5 があるなどの) 場合、<code>--with-perl</code> オプション (下記参照)
を使って <code class="program"><a href="./programs/configure.html">configure</a></code> が意図したものを使うように
明示的に指定すると良いでしょう。
<code class="program"><a href="./programs/configure.html">configure</a></code> スクリプトで Perl 5 インタプリタが
見つからない場合は、この影響を受けるサポートスクリプトが使えなくなります。
もちろん、Apache httpd のコンパイルとインストールは問題なく行えます。</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="download" id="download">ダウンロード</a></h2>
<p>Apache HTTP サーバは <a href="http://httpd.apache.org/download.cgi">Apache HTTP
サーバダウンロードサイト</a>からダウンロードできますし、
同じ場所に幾つかのミラーサイトもリストしています。
UNIX に類似するシステムで Apache を使うユーザは、ソースを
ダウンロードしてビルドしたほうが良いでしょう。
ビルドの手順（下記）は簡単ですし、そのおかげでニーズに
見合ったカスタマイズを簡単にできます。
さらに、バイナリのリリースはソースリリースよりも
遅れていることがよくあります。
それでもバイナリをダウンロードしたのであれば、
ディストリビューションの中にある <code>INSSTALL.bindist</code>
ファイルの説明に従ってください。</p>
<p>ダウンロード後、ダウンロードしたものが Apache HTTP
サーバの完全で改竄されていないバージョンであることを
検証することが重要です。これはダウンロードした tarball の PGP 署名を
テストすることによって検証します。
この手順の詳細は <a href="http://httpd.apache.org/download.cgi#verify">ダウンロード
ページ</a> にあり、さらに詳しい例は <a href="http://httpd.apache.org/dev/verification.html">PGP の使用
</a> に記載されています。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="extract" id="extract">展開</a></h2>
<p>Apache HTTPD の tarball
からソースファイルを展開して取り出すとは、
単なる圧縮の解除と tar の展開です:</p>
<div class="example"><p><code>
$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar
</code></p></div>
<p>配布用のソースコードがある現在いるディレクトリの下に、
新しいディレクトリが作られます。
サーバをコンパイルする段階に進む前に、そのディレクトリに
<code>cd</code> で移動してください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configure" id="configure">ソースツリーを設定する</a></h2>
<p>次のステップは、あなたのプラットホームと
個人的な要求に合うように Apache
ソースツリーを設定することです。
これは配布ディレクトリのルートディレクトリにある、
<code class="program"><a href="./programs/configure.html">configure</a></code>
スクリプトで行ないます。
(Apache ソースツリーの未リリース
版をダウンロードした開発者は、次のステップに進む前に
<code>autoconf</code> と<code>libtool</code>
をインストールして <code>buildconf</code>
を実行する必要があります。
公式リリースではこの作業は必要ありません。) </p>
<p>デフォルトオプションを使ってソースツリーを全て設定する
のであれば、単純に <code>./configure</code> とタイプしてください。
デフォルトオプションを変更できるように、<code class="program"><a href="./programs/configure.html">configure</a></code>
には様々な変数やコマンドラインオプションが用意されています。</p>
<p>最も重要なオプションは、Apache がこの後でインストールされる位置
<code>--prefix</code> です。Apache は、このインストール位置に
おいて正常に動作するように設定しなければならないからです。
さらに詳細なファイル位置の制御は追加の <a href="programs/configure.html#installationdirectories">設定オプション
</a> でできます。</p>
<p>この時点で、<a href="mod/">モジュール</a> を有効にしたり
無効にしたりすることで Apache 本体に含まれる <a href="programs/configure.html#optionalfeatures">機能</a>
を指定できます。Apache 本体にはデフォルトで、モジュールの <a href="mod/module-dict.html#Status">Base</a> セットが
含まれます。その他のモジュールは
<code>--enable-<var>module</var></code> オプションで
有効になります。ここで <var>module</var> はモジュールの名前で、
つまりそれはモジュールの名前から <code>mod_</code> 文字列を取り除いた後に
アンダースコアをダッシュで置換した文字列です。
これとは別の方法で <code>--enable-<var>module</var>=shared</code>
オプションを使って、モジュールを<a href="dso.html">
シェアードオブジェクト (DSO)</a> -- 実行時にロードしたり
アンロードしたりできる形式 -- としてコンパイルすることもできます。
同様に、<code>--disable-<var>module</var></code> オプションで
Base モジュールを無効化することもできます。
これらのオプションを使っているときに、もし指定したモジュールが存在しなくても
<code class="program"><a href="./programs/configure.html">configure</a></code> は警告を上げることなく、単純にオプションを
無視することに気をつけてください。</p>
<p>上記に加えて、<code class="program"><a href="./programs/configure.html">configure</a></code> スクリプトに、
コンパイラ、ライブラリ、ヘッダファイルの位置を追加情報として渡す
必要がある場合があります。このような場合には、環境変数あるいは
コマンドラインオプションで <code class="program"><a href="./programs/configure.html">configure</a></code> に渡します。
詳細に関しては <code class="program"><a href="./programs/configure.html">configure</a></code> マニュアルページ
をご覧ください。あるいは <code>--help</code> オプションつきで
<code class="program"><a href="./programs/configure.html">configure</a></code> を呼び出してください。</p>
<p>ちょっとどんなことができるかを見せましょう。
ここで典型的な例として、<code>/sw/pkg/apache</code>
というインストールツリーでコンパイラとフラグを指定して、
さらに二つの追加モジュール <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> と
<code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> を後で DSO
メカニズムでロードするようにコンパイルしてみます:</p>
<div class="example"><p><code>
$ CC="pgcc" CFLAGS="-O2" \<br />
./configure --prefix=/sw/pkg/apache \<br />
--enable-rewrite=shared \<br />
--enable-speling=shared
</code></p></div>
<p><code class="program"><a href="./programs/configure.html">configure</a></code> を実行したら、システムの機能を
テストしたり、後でサーバをコンパイルするために必要な Makefile
を生成したりするのに数分間かかるでしょう。</p>
<p>個々の <code class="program"><a href="./programs/configure.html">configure</a></code> オプションの詳細に関しては
<code class="program"><a href="./programs/configure.html">configure</a></code> マニュアルページ
をご覧ください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="compile" id="compile">ビルド</a></h2>
<p>これで Apache の様々なパーツをビルドすることができます。
次のコマンドを単純に実行するだけです:</p>
<div class="example"><p><code>$ make</code></p></div>
<p>基本的な設定をするのに数分かかりますが、
あらかじめご了承ください。
また、時間はハードウェアや有効にしたモジュールの数に
大きく依存するでしょう。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">インストール</a></h2>
<p>さて、設定したインストール <em>PREFIX</em>
(前述の <code>--prefix</code> オプションを参照)
以下にパッケージをインストールする段階になりました。
次のコマンドを実行してください:</p>
<div class="example"><p><code>$ make install</code></p></div>
<p>通常 <em>PREFIX</em> は書き込みパーミッションが制限されている
ディレクトリになっているので、このステップは通常は
ルート権限が必要です。</p>
<p>アップグレードする場合は、インストールでは設定ファイルや
ドキュメントファイルの上書きは行いません。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="customize" id="customize">カスタマイズ</a></h2>
<p>次に <code><em>PREFIX</em>/conf/</code> 以下にある <a href="configuring.html">設定ファイル</a>を編集して、
Apache HTTP サーバをカスタマイズします。</p>
<div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
<p><code><em>PREFIX</em>/docs/manual/</code> や
<a href="./">docs/manual/</a> にある Apache マニュアルをざっと見てください。
または、<a href="http://httpd.apache.org/docs/2.4/">http://httpd.apache.org/docs/2.4/</a>
にあるマニュアル最新版、<a href="mod/directives.html">設定ディレクティブ</a>に当たってみてください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="test" id="test">テスト</a></h2>
<p>次のコマンドを実行して Apache HTTP サーバを<a href="invoking.html">開始</a>できます:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k start</code></p></div>
<p>URL <code>http://localhost/</code> を通して最初のドキュメントに対する
リクエストを発行する事ができるはずです。これで見える
ウェブページは <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
以下に置かれたもので、通常は
<code><em>PREFIX</em>/htdocs/</code> でしょう。
サーバを再び<a href="stopping.html">停止</a>するには、
次のコマンドを実行します:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k stop</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="upgrading" id="upgrading">アップグレード</a></h2>
<p>アップグレードでまず行なうべきことは、リリースアナウンスと
ソースディストリビューションに入っている <code>CHANGES</code> を読んで、
自身のサイトに対して影響を及ぼす変更点を探すことです。
メジャーリリース間の変更をする場合 (例えば 1.3 から 2.0 へ、2.0 から 2.2 へ)
は、コンパイル時や実行時の設定に大きな差異があるでしょうから、
手動の調整が必要になるでしょう。モジュールも全て、API
の変更に合わせるためにアップグレードが必要になるでしょう。</p>
<p>マイナーバージョンから次のバージョンにアップグレードする場合
(例えば 2.2.55 から 2.2.57 へ) は、もっと簡単です。
<code>make install</code> を実行しても今あるドキュメント、
ログファイル、設定ファイルは上書きされません。
さらに、マイナーバージョン間では <code class="program"><a href="./programs/configure.html">configure</a></code> オプション、
実行時の設定、モジュール API に不整合が起こらないように、
開発者は最大限の努力をしています。
大抵の場合、同一の <code class="program"><a href="./programs/configure.html">configure</a></code> コマンドライン、
同一の設定ファイル、モジュール全てが正常に動作するはずです。</p>
<p>マイナーバージョンでアップグレードする場合は、
既にインストールされているサーバの <code>build</code> ディレクトリ内か、
以前インストールに使ったソースコードツリーの最上位ディレクトリ内にある、
<code>config.nice</code> ファイルを探してください。
このファイルにはソースツリーを設定した時に使った
<code class="program"><a href="./programs/configure.html">configure</a></code> コマンドラインが、そのまま入っています。
次のバージョンにアップグレードする場合は <code>config.nice</code>
ファイルを新しいバージョンのソースツリーにコピーし、
必要であればそれを編集した後に、次のように実行します。</p>
<div class="example"><p><code>
$ ./config.nice<br />
$ make<br />
$ make install<br />
$ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
$ <em>PREFIX</em>/bin/apachectl -k start<br />
</code></p></div>
<div class="warning">新しいバージョンを使用する場合は、
実際に運用を始める前に、必ず自分用の環境でテストすべきです。
最終的にアップグレードする前に、非互換性がないかをテストするために、
例えば、異なる <code>--prefix</code> と異なるポート (<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> ディレクティブで設定します)
を使用することで、古いバージョンに影響を与えずに新しいバージョンを
インストールし、実行できます。</div>
<p>もとの <code class="program"><a href="./programs/configure.html">configure</a></code> に追加する形で、
追加の引数を <code>config.nice</code> に渡すこともできます:</p>
<div class="example"><p><code>
$ ./config.nice --prefix=/home/test/apache --with-port=90
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/install.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/invoking.html.ja.utf8 0000664 0001751 0001751 00000034056 14743132254 021034 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache の起動 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Apache の起動</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Windows 上では、Apache は通常はサービスとして実行されます。
詳細に関しては、「<a href="platform/windows.html#winsvc">
サービスとして実行する</a>」をご覧下さい。</p>
<p>Unixでは、<code class="program"><a href="./programs/httpd.html">httpd</a></code>
プログラムが、バックグラウンドで常にリクエスト処理を行う
デーモンとして実行されます。この文書ではどのように
<code class="program"><a href="./programs/httpd.html">httpd</a></code> を起動するかについて記述しています。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#startup">Apache の起動方法</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errors">起動時のエラー</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#boot">ブート時の起動</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#info">追加情報</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="stopping.html">停止と再起動</a></li><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="#comments_section">コメント</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="startup" id="startup">Apache の起動方法</a></h2>
<p>もし、設定ファイル中で指定されている
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
がデフォルトの 80 (もしくは 1024 以下の他のポート)
である場合は、Apache を起動するためには root
権限が必要になりますが、
これはこの特権ポートにバインドするためです。
起動して、一度ログファイルを開くといった準備のための
動作を幾つか実行した後は、クライアントからのリクエストに対する
listen と応答を実際に行う<em>子</em>プロセスを起動します。
メインの <code class="program"><a href="./programs/httpd.html">httpd</a></code> プロセスは root 権限で走り続けますが、
子プロセスはもっと低い権限で走ります。
これは選択した<a href="mpm.html">マルチプロセッシングモジュール</a>で制御されます。</p>
<p>推奨の <code class="program"><a href="./programs/httpd.html">httpd</a></code> 実行プログラムの起動方法は、
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code>
制御スクリプトを使用する方法です。このスクリプトは、<code class="program"><a href="./programs/httpd.html">httpd</a></code>
がオペレーティングシステム上で正常に動作するように必要な環境変数を
適切に設定して、<code class="program"><a href="./programs/httpd.html">httpd</a></code> バイナリを起動します。
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> はどんなコマンドライン引数も通過させますので、
<code class="program"><a href="./programs/httpd.html">httpd</a></code> のどのコマンドラインオプションも
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> のオプションとして使用できます。
また、<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> スクリプトを直接編集し、
スクリプト先頭付近の <code>HTTPD</code> 変数を変更することで、
<code class="program"><a href="./programs/httpd.html">httpd</a></code> バイナリの正しい位置を指定したり、<em>常に</em>
付加させるコマンドライン引数を指定したりすることができます。</p>
<p><code class="program"><a href="./programs/httpd.html">httpd</a></code> が起動されてまず最初にすることは、
<a href="configuring.html">設定ファイル</a>
<code>httpd.conf</code> の位置を特定して読み込むことです。
このファイルの位置はコンパイル時に設定されますが、実行時に
<code>-f</code> コマンドラインオプションを使って
位置を指定することもできます。例えば次のようにです。</p>
<div class="example"><p><code>/usr/local/apache2/bin/apachectl -f
/usr/local/apache2/conf/httpd.conf</code></p></div>
<p>スタートアップが万事上手くいったら、サーバはターミナルから
切り離されて、コマンドプロンプトが即座に戻ってくるでしょう。
これはサーバが起動している状態を示しています。
その後はブラウザでサーバに接続して、
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
ディレクトリのテストページを見ることができるでしょう。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errors" id="errors">起動時のエラー</a></h2>
<p>Apache は、起動時に致命的な問題に遭遇すると、
終了する前に、コンソールか
<code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code>
のどちらかに問題を記述したメッセージを出力します。
最もよくあるエラーメッセージは
「<code>Unable to bind to Port ...</code>」
です。このメッセージは普通は次のどちらかが原因です。</p>
<ul>
<li>root でログインしていない時に、
特権ポートでサーバを起動しようとした。</li>
<li>同じポートに既にバインドされている Apache
がもう一つあるときや他のウェブサーバが存在している時に、
サーバを開始しようとした。</li>
</ul>
<p>より多くの問題解決の方策の説明は、
Apache <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> をご覧下さい。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="boot" id="boot">ブート時の起動</a></h2>
<p>システムがリブートした後でも
サーバが実行され続けるようにしたい場合は、
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code>
を呼び出すものをシステムスタートアップファイル
(通常 <code>rc.local</code> や <code>rc.N</code>
内のファイル) に追加しなければなりません。
この方法では Apache を root 権限で起動します。
これをする前に、セキュリティやアクセス制限が
適切に設定されていていることを確認してください。</p>
<p><code class="program"><a href="./programs/apachectl.html">apachectl</a></code> スクリプトは通常は、標準的な SysV init
スクリプトとして動作するように設計されています。
<code>start</code>, <code>restart</code>, <code>stop</code>
といった引数をとって、<code class="program"><a href="./programs/httpd.html">httpd</a></code>
への適切なシグナルに変換します。
ですから、通常は単に適切な init ディレクトリ内から
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> へリンクすることができます。しかし、
念のためシステムの要求に合致していることを確認してください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="info" id="info">追加情報</a></h2>
<p><code class="program"><a href="./programs/httpd.html">httpd</a></code> や
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code>、サーバに含まれていたその他補助プログラムの、
コマンドラインオプションに関する追加情報は、
<a href="programs/">サーバと補助プログラム</a>ページに
記載されています。
Apache 配布に含まれている全<a href="mod/">モジュール</a>、
それによって提供される<a href="mod/directives.html">ディレクティブ</a>
のドキュメントもあります。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/invoking.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/logs.html.ko.euc-kr 0000664 0001751 0001751 00000072035 14743132254 020472 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>α - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>α</h1>
<div class="toplang">
<p><span> : </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/logs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/logs.html" title="Korean"> ko </a> |
<a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>ȿ Ϸ ϴ Բ
Ȱ ɿ ˾ƾ Ѵ. ġ ſ ̰
α Ѵ. α ϴ
α Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#security"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errorlog"> α (Error Log)</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#accesslog"> α (Access Log)</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rotation">α ȯ (Log Rotation)</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#piped">α </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">ȣƮ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">ٸ α</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="security" id="security"> </a></h2>
<p> ġ α ִ 丮
ִٸ ( root) ϴ uid Ȯ
ִ. ̸ ʰ αװ 丮
<em></em>. ڼ <a href="misc/security_tips.html"> </a> ϶.</p>
<p>, Ŭ̾Ʈ αϿ ״
ϵȴ. ǰ ִ Ŭ̾Ʈ αϿ ڸ
Ƿ, α ٷ궧 ؾ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errorlog" id="errorlog"> α (Error Log)</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code></li></ul></td></tr></table>
<p><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> þ
߿ α α ̸ ġ Ѵ.
ġ Ͽ û óϴ
Ѵ. ϰų ϴµ
ִٸ ߸Ǿ ġ ˷ִ
̰ Ѵ.</p>
<p> α״ ( н ýۿ
<code>error_log</code>, OS/2
<code>error.log</code>) Ͽ ϵȴ. н ýۿ
<code>syslog</code> <a href="#piped">
Ͽ ٸ α</a> ִ.</p>
<p> α Ӱ ڼϴ.
κ α ִ.
, .</p>
<div class="example"><p><code>
[Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1]
client denied by server configuration:
/export/home/live/ap/htdocs/test
</code></p></div>
<p>α ù° ¥ ð̴. ι°
ϴ ɰ Ÿ. <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> þ α
ϵǴ ɰ ִ. °
Ŭ̾Ʈ IP ̴ּ.
, Ŭ̾Ʈ źϵ
Ǿٰ ִ. û ( ΰ ƴ)
Ͻý ε δ.</p>
<p> α ſ پ ִ.
κ ϴ. CGI ũƮ µ
α ϵȴ. CGI ũƮ <code>stderr</code>
״ α ȴ.</p>
<p> α ߰ϰ .
û α <a href="#accesslog">
α</a> ϴ . ,
ڵ尡 403 α . α״
Ƿ Ͽ Ȳ
߰ ִ.</p>
<p>˻Ҷ α 캸
. н ýۿ Ѵ:</p>
<div class="example"><p><code>
tail -f error_log
</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="accesslog" id="accesslog"> α (Access Log)</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li></ul></td></tr></table>
<p> α״ óϴ û Ѵ.
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
þ α ġ Ѵ. <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> þ
Ͽ α ִ.
α ϴ Ѵ.</p>
<p> α ϴ α
̴. ܰ мϿ 踦
̴. Ϲ α м ؼ ٷ ,
α м ƴϴ. α м
α мϴ Ʈ ؼ <a href="http://dmoz.org/Computers/Software/Internet/Site_Management/Log_Analysis/">Open Directory</a>
϶.</p>
<p>ġ mod_log_referer, mod_log_agent,
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
þ Ͽ α ٷ.
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
þ þ ̾Ҵ.</p>
<p> α ſ ϴ. C
printf(1) Ĺڿ ſ Ĺڿ Ͽ
Ѵ. . Ĺڿ 밡
˷ <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code> <a href="mod/mod_log_config.html#formats">Ĺڿ</a>
϶.</p>
<h3><a name="common" id="common">Common α </a></h3>
<p> α .</p>
<div class="example"><p><code>
LogFormat "%h %l %u %t \"%r\" %>s %b" common<br />
CustomLog logs/access_log common
</code></p></div>
<p> α Ĺڿ <em></em>
<code>common</code> Ѵ. Ĺڿ ۼƮ
þ Ǹ, ˸.
Ĺڿ Ϲ ڸ ״ α µȴ.
ǥ (<code>"</code>) ϰ ʹٸ 齽
տ ٿ Ĺڿ ƴ ǥѴ. Ĺڿ
ٹٲ "<code>\n</code>", "<code>\t</code>"
Ư ڸ ִ.</p>
<p><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
þ <em></em> ϴ ο α
. α ϸ
<code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> ̴.</p>
<p> α(Common Log Format, CLF)̶
α Ѵ. ٸ 鵵 ̷
ǥ α , α м α
ִ. CLF α :</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
</code></p></div>
<p> α κ Ѵ.</p>
<dl>
<dt><code>127.0.0.1</code> (<code>%h</code>)</dt>
<dd> û Ŭ̾Ʈ( ȣƮ) IP
̴ּ. <code class="directive"><a href="./mod/core.html#hostnamelookups">HostnameLookups</a></code>
<code>On</code>̶ ȣƮ ãƼ IP ּ ڸ
. ſ
Ƿ õ ʴ´. ȣƮ ˷ ߿
<a href="programs/logresolve.html">logresolve</a>
α óϴ α ϴ .
IP ּҴ ڰ ϴ ǻ ּҰ
ƴ ִ. Ͻ ڿ ̿ Ѵٸ,
ǻ ּҰ ƴ϶ Ͻ ּҰ ϵ ̴.</dd>
<dt><code>-</code> (<code>%l</code>)</dt>
<dd>¿ "ȣ" û Ÿ.
Ŭ̾Ʈ ǻ
<code>identd</code> Ŭ̾Ʈ RFC 1413
ſ̴. ſ ,
Ǵ Ʈ ƴ϶ ϸ
ȵȴ. <code class="directive"><a href="./mod/core.html#identitycheck">IdentityCheck</a></code>
<code>On</code> ƴ϶ ġ
˾ƺ õ ʴ´.</dd>
<dt><code>frank</code> (<code>%u</code>)</dt>
<dd>̴ HTTP ˾Ƴ û
userid̴. CGI ũƮ
<code>REMOTE_USER</code> ȯ溯 Ѱ. û
ڵ尡 401̶ (Ʒ ) ڰ
ġ ʾǷ ȵȴ. ȣ
ȣ ʴ´ٸ
"<code>-</code>"̴.</dd>
<dt><code>[10/Oct/2000:13:55:36 -0700]</code>
(<code>%t</code>)</dt>
<dd>
ûó ģ ð.
:
<p class="indent">
<code>[day/month/year:hour:minute:second zone]<br />
day = 2<br />
month = 3<br />
year = 4<br />
hour = 2<br />
minute = 2<br />
second = 2<br />
zone = (`+' | `-') 4</code>
</p>
α Ĺڿ <code>%{format}t</code> Ͽ
ٸ ð ִ. <code>format</code>
C ǥ ̺귯 <code>strftime(3)</code> .
</dd>
<dt><code>"GET /apache_pb.gif HTTP/1.0"</code>
(<code>\"%r\"</code>)</dt>
<dd>Ŭ̾Ʈ û ֵǥ ִ. û
ſ ִ. ù°, Ŭ̾Ʈ
<code>GET</code>̴. °, Ŭ̾Ʈ ڿ
<code>/apache_pb.gif</code> ûѴ. °, Ŭ̾Ʈ
<code>HTTP/1.0</code> Ѵ. û
κ α ִ. , Ĺڿ
"<code>%m %U%q %H</code>" "<code>%r</code>" Ȱ
, , ǹڿ, αѴ.</dd>
<dt><code>200</code> (<code>%>s</code>)</dt>
<dd>̴ Ŭ̾Ʈ ڵ̴.
(2 ϴ ڵ) û Ͽ, (4
ϴ ڵ) Ŭ̾Ʈ ִ, (5 ϴ
ڵ) ִ ˷ֹǷ ſ ߿ϴ.
ڵ ü <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">HTTP
Ծ</a> (RFC2616 section 10) ã ִ.</dd>
<dt><code>2326</code> (<code>%b</code>)</dt>
<dd> ϰ Ŭ̾Ʈ
ũ⸦ Ÿ. Ŭ̾Ʈ
ٸ "<code>-</code>"̴.
"<code>0</code>" αϷ
<code>%B</code> Ѵ.</dd>
</dl>
<h3><a name="combined" id="combined">Combined α </a></h3>
<p> Ǵ ٸ Ĺڿ յȷα(Combined
Log Format)̴. Ѵ.</p>
<div class="example"><p><code>
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\"" combined<br />
CustomLog log/access_log combined
</code></p></div>
<p> ߰ ϰ Common
α İ . ߰ ۼƮ þ
<code>%{<em>header</em>}i</code> Ѵ. ⼭
<em>header</em> ڸ HTTP û ̸
ִ. α״ :</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
"http://www.example.com/start.html" "Mozilla/4.08 [en]
(Win98; I ;Nav)"
</code></p></div>
<p>߰ :</p>
<dl>
<dt><code>"http://www.example.com/start.html"</code>
(<code>\"%{Referer}i\"</code>)</dt>
<dd>"Referer" ( Ʋʾ) HTTP û .
Ŭ̾Ʈ ߴٰ ˸ Ʈ̴.
(, <code>/apache_pb.gif</code> ũϿų
Ʈ̴.)</dd>
<dt><code>"Mozilla/4.08 [en] (Win98; I ;Nav)"</code>
(<code>\"%{User-agent}i\"</code>)</dt>
<dd>User-Agent HTTP û . Ŭ̾Ʈ
ڽſ ˸ ĺ̴.</dd>
</dl>
<h3><a name="multiple" id="multiple"> α</a></h3>
<p>Ͽ <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> þ
ϸ αװ . ,
α . ù° ⺻ CLF
ϰ, ι° ° referer
Ѵ. <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
<code>ReferLog</code> <code>AgentLog</code> þ
䳻 ִ ش.</p>
<div class="example"><p><code>
LogFormat "%h %l %u %t \"%r\" %>s %b" common<br />
CustomLog logs/access_log common<br />
CustomLog logs/referer_log "%{Referer}i -> %U"<br />
CustomLog logs/agent_log "%{User-agent}i"
</code></p></div>
<p>, <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> ݵ
ʿ ش. <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> þ
α ִ.</p>
<h3><a name="conditional" id="conditional">Ǻ α</a></h3>
<p>Ŭ̾Ʈ û ݿ ش α
ʰ ִ. <a href="env.html">ȯ溯</a>
ϸ ذȴ. , Ŭ̾Ʈ Ư
ϸ ȯ溯 Ѵ. ۾ <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> Ѵ.
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
þ <code>env=</code> Ͽ ȯ溯
û ְų . :</p>
<div class="example"><p><code>
# loop-back ̽ û ǥѴ<br />
SetEnvIf Remote_Addr "127\.0\.0\.1" dontlog<br />
# robots.txt Ͽ û ǥѴ<br />
SetEnvIf Request_URI "^/robots\.txt$" dontlog<br />
# α <br />
CustomLog logs/access_log common env=!dontlog
</code></p></div>
<p>ٸ û αϿ ϰ,
û ٸ αϿ ϴ 츦
غ.</p>
<div class="example"><p><code>
SetEnvIf Accept-Language "en" english<br />
CustomLog logs/english_log common env=english<br />
CustomLog logs/non_english_log common env=!english
</code></p></div>
<p>Ǻ α״ ſ ϰ , ̰ α
ϴ ƴϴ. α
ൿ Ҷ ϴ. ߿ ʴ û
ϰ α мϴ .</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="rotation" id="rotation">α ȯ (Log Rotation)</a></h2>
<p> ٻ αϿ Ǵ ſ
. α״ û 1MB ̻ Ѵ.
α űų α ֱ
Ȱ ʿ䰡 ִ. ġ ִ ȿ
αϿ ϶ α ȯ
. α űų <a href="stopping.html"></a>Ͽ, α
Ѵ.</p>
<p><em></em> ϸ Ŭ̾Ʈ
Ȥ ʰ α ִ.
̸ û
α ؾ Ѵ. Ƿ
α óϱ ٸ ʿ䰡 ִ. Ϲ
α ȯϰ, ũ ϱ
α Ѵ:</p>
<div class="example"><p><code>
mv access_log access_log.old<br />
mv error_log error_log.old<br />
apachectl graceful<br />
sleep 600<br />
gzip access_log.old error_log.old
</code></p></div>
<p>α ȯϴ ٸ <a href="#piped"> α</a> ϴ ̴.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="piped" id="piped">α </a></h2>
<p>ġ α α Ͽ
ʰ ٸ μ ִ.
ϸ ڵ带 ߰ʰ ſ ϰ
α ó ִ. α ϸ
ڸ "<code>|</code>" ڿ ǥԷ
α ϸ ȴ. ġ
Ҷ α μ ϰ,
Ǵ μ ٽ Ѵ. (
ɶ 츮 " ִ α"
θ.)</p>
<p> α μ θ ġ httpd μ
, μ userid . , α
α root ȴ. Ƿ α ϰ
ϰ ſ ߿ϴ.</p>
<p> θ ü ɾ ǥ ϶.
α , α .</p>
<p> ʰ α ȯ ִ
α ϴ ߿ . ġ ̸
<a href="programs/rotatelogs.html">rotatelogs</a>
α Ѵ. 24ð α ȯѴٸ:</p>
<div class="example"><p><code>
CustomLog "|/usr/local/apache/bin/rotatelogs
/var/log/access_log 86400" common
</code></p></div>
<p>ٸ Ʈ <a href="http://www.cronolog.org/">cronolog</a>
ξ α ȯ α ִ.</p>
<p>Ǻ α α״ ſ ,
߿ óϴ ؼ
ȵȴ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">ȣƮ</a></h2>
<p> <a href="vhosts/">ȣƮ</a> ִ
Ҷ α ٷ ִ. ,
ȣƮ Ѱ α ִ. <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
ƴ ּ α þ θ û
α α ϵȴ. ȣƮ
ó .</p>
<p><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
ȿ <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
<code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> þ
ϸ ش ȣƮ û
Ͽ ϵȴ. α þ ٸ ȣƮ
ּ α α Ѵ. ȣƮ
ſ , ȣƮ ٸ ϱ
. , <a href="vhosts/fd-limits.html">ϱڰ
</a> Ѵ.</p>
<p> α ſ ذå ִ. α Ĺڿ
ȣƮ ߰ϸ ȣƮ α
ϰ, ߿ α ȣƮ ִ.
, þ .</p>
<div class="example"><p><code>
LogFormat "%v %l %u %t \"%r\" %>s %b"
comonvhost<br />
CustomLog logs/access_log comonvhost
</code></p></div>
<p><code>%v</code> û ϴ ȣƮ ̸
Ѵ. ߿ <a href="programs/other.html">split-logfile</a>
α α ȣ ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">ٸ α</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritelog">RewriteLog</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptloglength">ScriptLogLength</a></code></li></ul></td></tr></table>
<h3><a name="pidfile" id="pidfile">PID </a></h3>
<p>ġ Ҷ <code>logs/httpd.pid</code>
Ͽ θ httpd μ process id Ѵ.
ϸ <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>
þ ִ. process-id ڰ θ μ
ñ׳ ϰų ϶ Ѵ.
-k ɼ Ѵ. ڼ
<a href="stopping.html">ߴܰ </a>
϶.</p>
<h3><a name="scriptlog" id="scriptlog">ũƮ α</a></h3>
<p> <code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code> þ Ͽ
CGI ũƮ Է° ִ. þ
Ʈθ ؾ Ѵ. ϴ
ϸ ȵȴ. ڼ <a href="mod/mod_cgi.html">mod_cgi</a> ϶.</p>
<h3><a name="rewritelog" id="rewritelog">ۼ α</a></h3>
<p><a href="mod/mod_rewrite.html">mod_rewrite</a> ϰ
Ѵٸ <code class="directive"><a href="./mod/mod_rewrite.html#rewritelog">RewriteLog</a></code> ʿ䰡
ִ. α ۼ û ȯϴ
ڼ ˷ش. ڼ <code class="directive"><a href="./mod/mod_rewrite.html#rewriteloglevel">RewriteLogLevel</a></code> þ
Ѵ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/logs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/logs.html" title="Korean"> ko </a> |
<a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/logs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_4.html.tr.utf8 0000664 0001751 0001751 00000075243 14743132254 022401 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Sunucusu 2.4'te Yeni olan Özellikler - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache HTTP Sunucusu 2.4'te Yeni olan Özellikler</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/new_features_2_4.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_4.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./tr/new_features_2_4.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belgede Apache HTTP Sunucusunun 2.2 ve 2.4 sürümleri arasındaki
başlıca farklara değinilmiştir. 2.0 sürümüne göre yeni özellikler için <a href="new_features_2_2.html">Apache 2.2’de Yeni olan Özellikler</a>
belgesine bakınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Çekirdekteki Gelişmeler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#newmods">Yeni Modüller</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Modüllerdeki Gelişmeler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Programlardaki Gelişmeler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#documentation">Belgelendirme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Modül Geliştirici Değişiklikleri</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="core" id="core">Çekirdekteki Gelişmeler</a></h2>
<dl>
<dt>Çalışma anında yüklenebilen MPM'ler</dt>
<dd>Çok sayıda MPM artık <a href="mpm.html#dynamic">yüklenebilir
modül</a> olarak derlenebilmektedir. Kullanılacak MPM'in seçimi
çalışma anında <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
yönergesi üzerinden yapılabilmektedir.</dd>
<dt>Event MPM</dt>
<dd><a href="mod/event.html">Event MPM</a> artık deneysel değil, ancak
tam olarak desteklenmiyor.</dd>
<dt>Eşzamansıza destek</dt>
<dd>MPM'leri ve platformları desteklemek için eşzamansız okuma/yazmaya
destek iyileştirildi.</dd>
<dt>Modul bazında ve dizin bazına LogLevel yapılandırması</dt>
<dd><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> artık her modül ve her
dizin için yapılandırılabilmektedir. <code>debug</code> log
seviyesinin üstüne <code>trace1</code>'den <code>trace8</code>'e
kadar yeni log seviyeleri eklendi.</dd>
<dt>İstek bazında yapılandırma bölümleri</dt>
<dd><code class="directive"><a href="./mod/core.html#if"><If></a></code>,
<code class="directive"><a href="./mod/core.html#elseif"><ElseIf></a></code>,
ve <code class="directive"><a href="./mod/core.html#else"><Else></a></code> bölümleri
artık HTTP isteklerine dayalı olarak yapılandırılabilmektedir.</dd>
<dt>Genel amaçlı ifade çözümleyici</dt>
<dd>Yeni ifade çözümleyici
<code class="directive"><a href="./mod/mod_setenvif.html#setenvifexpr">SetEnvIfExpr</a></code>,
<code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>,
<code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>,
<code class="directive"><a href="./mod/core.html#if"><If></a></code> ve
benzeri yönergelerde ortak bir sözdizimi kullanarak <a href="expr.html">karmaşık durumlar</a> belirtmeyi mümkün kılmaktadır.
</dd>
<dt>Milisaniye cinsinden KeepAliveTimeout</dt>
<dd><code class="directive"><a href="./mod/core.html#keepalivetimeout">KeepAliveTimeout</a></code> milisaniye
cinsinden belirtmek artık mümkündür.</dd>
<dt>NameVirtualHost yönergesi</dt>
<dd>Artık gerekmemekte ve kullanımı önerilmemektedir.</dd>
<dt>Yapılandırma geçersizleştirme</dt>
<dd>Yeni <code class="directive"><a href="./mod/core.html#allowoverridelist">AllowOverrideList</a></code>
yönergesi <code>.htaccess</code> dosyalarında kullanılabilen
yönergelerde daha ince ayarlara izin vermektedir.</dd>
<dt>Yapılandırma dosyası değişkenleri</dt>
<dd>Yapılandırmada değişkenler <code class="directive"><a href="./mod/core.html#define">Define</a></code> yönergesi ile tanımlanabilmekte, böylece aynı
değer yapılandırmada bir çok yerde kullanılıyorsa daha temiz bir
görünüm elde edilebilmektedir.</dd>
<dt>Azaltılmış bellek kullanımı</dt>
<dd>Bir çok yeni özelliğe karşın, 2.4.x'te 2.2.x'e nazaran bellek
kullanımı azaltılmıştır.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="newmods" id="newmods">Yeni Modüller</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></dt>
<dd><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> için FastCGI Protokolü sağlayıcısı</dd>
<dt><code class="module"><a href="./mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code></dt>
<dd><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> için SCGI Protokolü sağlayıcısı</dd>
<dt><code class="module"><a href="./mod/mod_proxy_express.html">mod_proxy_express</a></code></dt>
<dd><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> için devingen olarak yapılandırılmış tam
tersinir vekiller sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_remoteip.html">mod_remoteip</a></code></dt>
<dd>İstek başlıklarında bir yük dengeleyici veya bir vekil tarafından
sunulan IP adres listeli bir istek için görünen istemci IP adresi ve
konak adını değiştirir.</dd>
<dt><code class="module"><a href="./mod/mod_heartmonitor.html">mod_heartmonitor</a></code>,
<code class="module"><a href="./mod/mod_lbmethod_heartbeat.html">mod_lbmethod_heartbeat</a></code></dt>
<dd><code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> modülünün arka sunuculardaki
etkin bağlantı sayısı üzerindeki yük dengeleme kararlarına dayalı işlem
yapmasını sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_html.html">mod_proxy_html</a></code></dt>
<dd>Başta bir üçüncü parti modüldü. Arka plandaki sağlayıcının vekil
istemcileri için geçersiz URL'ler ürettiği tersinir vekil durumlarında
HTML bağlarının düzeltilmesini sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_sed.html">mod_sed</a></code></dt>
<dd><code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code> modülünün geliştirilmiş hali olup
yanıt gövdesinin sed'in tüm gücü ile yeniden düzenlenebilmesini
sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_auth_form.html">mod_auth_form</a></code></dt>
<dd>Formlara dayalı kimlik kanıtlamayı etkinleştirir.</dd>
<dt><code class="module"><a href="./mod/mod_session.html">mod_session</a></code></dt>
<dd>Çerezleri ve veritabanı deposunu kullanarak istemciler için oturum
durumunun saklanmasını etkinleştirir.</dd>
<dt><code class="module"><a href="./mod/mod_allowmethods.html">mod_allowmethods</a></code></dt>
<dd>Kimlik Doğrulama ve Yetkilendirme ile etkileşmeyen belli HTTP
yöntemlerine sınır koymak için yeni bir modül.</dd>
<dt><code class="module"><a href="./mod/mod_lua.html">mod_lua</a></code></dt>
<dd>Küçük iş mantıksal işlevleri ve yapılandırması için httpd içine <a href="http://www.lua.org/">Lua</a> dilini gömer.</dd>
<dt><code class="module"><a href="./mod/mod_log_debug.html">mod_log_debug</a></code></dt>
<dd>İstek işlemlerinin farklı aşamalarına özelleştirilebilir hata
ayıklama günlüğü eklenmesini sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_buffer.html">mod_buffer</a></code></dt>
<dd>Girdi ve çıktı süzgeç yığıtlarına tampon bellek sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_data.html">mod_data</a></code></dt>
<dd>Yanıt gövdesini bir RFC2397 veri URL'sine dönüştürür.</dd>
<dt><code class="module"><a href="./mod/mod_ratelimit.html">mod_ratelimit</a></code></dt>
<dd>İstemciler için band genişliği oranında sınırlama sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_request.html">mod_request</a></code></dt>
<dd>Kullanılabilir HTTP istek gövdelerini yapmak ve elde etmek için
Süzgeçleri sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code></dt>
<dd>Çıktı süzgeci yığıtı üzerinden bir yanıt olarak bir istek gövdesinin
yansısını sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_slotmem_shm.html">mod_slotmem_shm</a></code></dt>
<dd>Yuva temelli bir paylaşımlı bellek sağlayıcı sağlar (scoreboard
olarak da bilinir).</dd>
<dt><code class="module"><a href="./mod/mod_xml2enc.html">mod_xml2enc</a></code></dt>
<dd>Başta bir üçüncü parti modüldü. libxml2 temelli süzgeç modüllerinde
i18n'i destekler.</dd>
<dt><code class="module"><a href="./mod/mod_macro.html">mod_macro</a></code> (2.4.5'den itibaren kullanılabilir)</dt>
<dd>Yapılandırma dosyalarında makro kullanımını sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_wstunnel.html">mod_proxy_wstunnel</a></code> (2.4.5'den itibaren
kullanılabilir)</dt>
<dd>Web-socket tünelleri için destek.</dd>
<dt><code class="module"><a href="./mod/mod_authnz_fcgi.html">mod_authnz_fcgi</a></code> (2.4.10'dan itibaren
kullanılabilir)</dt>
<dd>Kimlik kanıtlama ve/veya istemcileri yetkilendirmek için FastCGI
yetkilendirme uygulamalarını etkinleştirir.</dd>
<dt><code class="module"><a href="./mod/mod_http2.html">mod_http2</a></code> (2.4.17'den itibaren kullanılabilir)</dt>
<dd>HTTP/2 aktarım katmanı desteği.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_http2.html">mod_proxy_http2</a></code> (2.4.19'dan itibaren
kullanılabilir)</dt>
<dd><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> için HTTP/2 Protokol arayüzü</dd>
<dt><code class="module"><a href="./mod/mod_proxy_hcheck.html">mod_proxy_hcheck</a></code> (2.4.21'den itibaren
kullanılabilir)</dt>
<dd>Uzak vekil artuç sunucuları için bağımsız özdevinimli sağlık
sınamalarını destekler.</dd>
<dt><code class="module"><a href="./mod/mod_brotli.html">mod_brotli</a></code> (2.4.26'dan itibaren kullanılabilir)</dt>
<dd>Brotli sıkıştırma algoritması desteği.</dd>
<dt><code class="module"><a href="./mod/mod_md.html">mod_md</a></code> (2.4.30'dan itibaren kullanılabilir)</dt>
<dd>Sertifika sağlama işlemi için ACME protokolü desteği.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_uwsgi.html">mod_proxy_uwsgi</a></code> (2.4.30'dan itibaren
kullanılabilir)</dt>
<dd><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> UWSGI ağ geçidi modülü.</dd>
<dt><code class="module"><a href="./mod/mod_socache_redis.html">mod_socache_redis</a></code> (2.4.39'dan itibaren
kullanılabilir)</dt>
<dd><a href="http://redis.io/">Redis</a> tabanlı paylaşımlı nesne
arabelleği sağlayıcı için destek.</dd>
<dt><code class="module"><a href="./mod/mod_systemd.html">mod_systemd</a></code> (2.4.42'den itibaren
kullanılabilir)</dt>
<dd>systemd bütünleştirmesi. Httpd'nin systemd <code>Type=notify</code>
ile bir hizmette kullanılmasına izin verir.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Modüllerdeki Gelişmeler</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> bir istemci sertifikasının doğrulama
durumunu sınamak için bir OCSP sunucusunu kullanmak üzere
yapılandırılabilir. Öntanımlı yanıtlayıcı, istemci sertifikasının
kendisinde tasarlanmış yanıtlayıcının tercih edilip edilmeyeceği
kararına bağlı olarak yapılandırılabilir.</dd>
<dd><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>, ayrıca, sunucunun istemciyle anlaşma
sırasında kendi sertifikasının OCSP doğrulamasını umursamazca sağlayıp
aktardığı durumda OCSP zımbalamasını da destekler.</dd>
<dd><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>, sunucular arasında SSL Oturumu verisini
memcached üzerinden paylaşmak üzere yapılandırılabilir.</dd>
<dd>RSA ve DSA'ya ek olarak EC anahtarları da artık desteklenmektedir.
</dd>
<dd>TLS-SRP için destek (2.4.4 itibariyle kullanılabilir).</dd>
<dt><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dt>
<dd><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> yönergesi bir
<code class="directive"><a href="./mod/core.html#location">Location</a></code> veya
<code class="directive"><a href="./mod/core.html#locationmatch">LocationMatch</a></code> bloku içinde en
verimli şekilde yapılandırılabilir ve büyük sayıların varlığı durumunda
geleneksel iki değiştirgeli sözdiziminin de üzerinde belirgin bir
başarım artışı sağlar.</dd>
<dd>Vekil istekleri için kullanılan kaynak adresi artık
yapılandırılabilmektedir.</dd>
<dd>Artalanda Unix alan soketleri için destek (2.4.7 itibariyle
kullanılabilir).</dd>
<dt><code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></dt>
<dd>Dengeleme yöneticisi üzerinden BalancerMembers için daha fazla
çalışma anı yapılandırması</dd>
<dd>Çalışma anında dengeleme yöneticisi üzerinden başka BalancerMembers
eklenebilir.</dd>
<dd>Çalışma anı yapılandırmasına yönelik dengeleyici değiştirgeleri</dd>
<dd>BalancerMembers için 'Drain' değeri belirtilebilir; böylece sadece
mevcut yapışık oturumlara yanıt verirler ve bunların güzellikle hattan
alınması mümkün olur.</dd>
<dd>Balancer ayarları sunucu yeniden başlatılssa bile kalıcı olabilir.
</dd>
<dt><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></dt>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> CACHE süzgeci, arabellekleme üzerinde daha
hassas denetim sağlamak için istenirse süzgeç zincirinin belli bir
noktasına yerleştirilebilmektedir.</dd>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> artık HEAD isteklerini
arabellekleyebiliyor.</dd>
<dd>Mümkün olduğunda, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> yönergeleri sunucu
bazında değil, dizin bazında belirtilebiliyor.</dd>
<dd>Arabellekli URL'lerin temel URL'si özelleştirilebiliyor; böylece
arabelleğin bir bölümü aynı uç URL önekini paylaşabiliyor.</dd>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>, ardalanda bir sağlayıcının olmadığı
durumda (5xx hatası), arabelleklenmiş bayat içeriği sunabiliyor.</dd>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> artık bir X-Cache başlığına bir
HIT/MISS/REVALIDATE yerleştirebiliyor.</dd>
<dt><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dt>
<dd>Bir hata durumunda öntanımlı hata dizgisi yerine bir hata sayfası
sunmayı sağlayan 'onerror' özniteliği için 'include' elemanı içinde
destek.</dd>
<dt><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>, <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>,
<code class="module"><a href="./mod/mod_isapi.html">mod_isapi</a></code>, ...</dt>
<dd>Başlıkların ortam değişkenlerine dönüşümü, başlık zerki yoluyla bazı
olası karşı-site-betik saldırılarının hafifletilmesinden önce daha
hızlı ve doğru yapılmaktadır. Geçersiz karakterler (altçizgiler dahil)
içeren başlık isimleri artık sessizce bırakılmaktadır.<a href="env.html">Apache'deki Ortam değişkenleri</a>, böyle başlıkları
gerektiren bozulmuş meşru istemcilerin çevresinden dolanabilen
göstericilere sahiptir. (Bu durum, bu değişkenleri kullanan tüm
modülleri etkiler.)</dd>
<dt><code class="module"><a href="./mod/mod_authz_core.html">mod_authz_core</a></code> Yetkilendirme Kuralları
Taşıyıcıları</dt>
<dd>Gelişkin yetkilendirme kuralları artık <code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code> yönergesi ve <code class="directive"><a href="./mod/mod_authz_core.html#requireall"><RequireAll></a></code> gibi
ilgili taşıyıcı yönergeler kullanılarak belirtilebilmektedir.</dd>
<dt><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></dt>
<dd><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> bildik yeniden yazma senaryolarını
basitleştirmek için <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> yönergesine
<code>[QSD]</code> (Query String Discard=sorgu dizgisini iptal) ve
<code>[END]</code> seçeneklerini sağlamaktadır.</dd>
<dd><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> içinde
karmaşık mantıksal ifadeler kullanımını mümkün kılmaktadır.</dd>
<dd>SQL sorgularının <code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> işlevleri olarak
kullanılması sağlanmıştır.</dd>
<dt><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>, <code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></dt>
<dd><code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> kümelenmiş gruplara destek sağlar.
</dd>
<dd><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code> zaman aşımlarını işleme sokabilmek için
<code class="directive"><a href="./mod/mod_ldap.html#ldapconnectionpoolttl">LDAPConnectionPoolTTL</a></code>,
<code class="directive"><a href="./mod/mod_ldap.html#ldaptimeout">LDAPTimeout</a></code> ve birtakım
başka geliştirmeler sahiptir. Özellikle, bir LDAP sunucusunun boşta
kalmış bağlantılarını bıraktıran bir durumsal güvenlik duvarı
varlığında gerekli ayarlamaları yapmak için kullanışlıdır.</dd>
<dd><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>, artık, LDAP araç kiti kullanarak sağlanan
hata ayıklama bilgisini günlüklemek için <code class="directive"><a href="./mod/mod_ldap.html#ldaplibrarydebug">LDAPLibraryDebug</a></code> yönergesini
içermektedir.</dd>
<dt><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></dt>
<dd><code class="module"><a href="./mod/mod_info.html">mod_info</a></code> önceden çözümlenmiş yapılandırmayı artık
sunucunun başlatılması sırasında standart çıktıya
dökümleyebilmektedir.</dd>
<dt><code class="module"><a href="./mod/mod_auth_basic.html">mod_auth_basic</a></code></dt>
<dd>Temel kimlik kanıtlamayı taklit eden yeni temel mekanizma
(2.4.5 itibariyle kullanılabilmektedir).</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="programs" id="programs">Programlardaki Gelişmeler</a></h2>
<dl>
<dt><code class="program"><a href="./programs/fcgistarter.html">fcgistarter</a></code></dt>
<dd>Yeni FastCGI artalan sunucusu başlatma aracı</dd>
<dt><code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code></dt>
<dd>Arabellekli URL'ler, istenirse metadata'yı da dahil ederek
listelenebilmektedir.</dd>
<dd>Bazı URL'ler arabellekten tek tek silinebilmektedir.</dd>
<dd>Dosya boyutları belirtilen blok boyutuna yukarı doğru
yuvarlanabilmekte, böylece dosya boyutu sınırları diskteki gerçek
boyutlarla daha iyi eşlenebilmektedir.</dd>
<dd>Arabellek boyutu artık, diskteki dosyaların boyutuna göre bir
sınıra ek olarak veya bunun yerine dosya düğümü sayısı ile
sınırlanabilmektedir.</dd>
<dt><code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code></dt>
<dd>Artık geçerli günlük dosyasına bir bağ oluşturulabiliyor.</dd>
<dd>Artık özel bir döndürme sonrası betiği çalıştırılabiliyor.</dd>
<dt><code class="program"><a href="./programs/htpasswd.html">htpasswd</a></code>, <code class="program"><a href="./programs/htdbm.html">htdbm</a></code></dt>
<dd>Bcrypt algoritması için destek (2.4.4 itibariyle
kullanılabilmektedir).</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="documentation" id="documentation">Belgelendirme</a></h2>
<dl>
<dt>mod_rewrite</dt>
<dd><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> belgeleri, yeniden düzenlenerek,
genel kullanıma ve örneklere odaklı olarak ve diğer çözümlerin hangi
durumlarda daha uygun olduğu da gösterilerek hemen hemen tamamen
yeniden yazıldı. <a href="rewrite/">Yeniden Yazma Kılavuzu</a> artık
bir sayfa olmaktan çıkıp, çok daha ayrıntılı ve daha iyi düzenlenmiş
bir bölüm haline geldi.</dd>
<dt>mod_ssl</dt>
<dd><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> belgeleri, evvelki teknik ayrıntılara ek
olarak başlarken seviyesinde daha fazla örnekle büyük oranda
genişletildi.</dd>
<dt>Önbellek Kullanım Kılavuzu</dt>
<dd><a href="caching.html">Önbellek Kullanım Kılavuzu</a>
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> tarafından sağlanan RFC2616 HTTP/1.1
önbellekleme özellikleri arasıda daha iyi ayrım yapılabilmesi için ve
<a href="socache.html">socache</a> arayüzü ile sağlanan soysal
anahtar/değer önbelleklemesi yanında <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code>
gibi mekanizmalarla sağlanan özelleştirilebilir arabelleklemeyi de
kapsamak üzere yeniden yazıldı.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="developer" id="developer">Modül Geliştirici Değişiklikleri</a></h2>
<dl>
<dt>Yapılandırma Denetleme Kancası Eklendi</dt>
<dd>Yeni bir kanca, <code>check_config</code> kancası,
<code>pre_config</code> ve <code>open_logs</code> kancaları arasında
çalışmak üzere eklendi. Ayrıca, <code class="program"><a href="./programs/httpd.html">httpd</a></code>'ye
<code>-t</code> seçeneği verildiğinde <code>test_config</code>
kancasından önce çalışır. <code>check_config</code> kancası, modüllerin
karşılıklı bağımlı yapılandırma yönergesi değerlerini yeniden
yoklamasını ve iletiler konsola hala günlüklenebiliyorken bunların
ayarlanabilmesini sağlar. Temel <code>open_logs</code> kanca işlevi
konsol çıktısını hata günlüğüne yönlendirmeden önce hatalı yapılandırma
sorunlarına karşı kullanıcı uyarılabilir.</dd>
<dt>İfade Çözümleyici Eklendi</dt>
<dd>Artık genel amaçlı bir ifade çözümleyicimiz var. API
<var>ap_expr.h</var> içinde incelenebilir. Evvelce
<code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> içinde gerçeklenmiş olan ifade çözümleyiciden
esinlenildi.</dd>
<dt>Yetkilendirme Kuralları Taşıyıcıları</dt>
<dd>Yetkilendirme modülleri, <code class="directive"><a href="./mod/mod_authz_core.html#requireall"><RequireAll></a></code> gibi gelişmiş yetkilendirme
kuralı taşıyıcılarını desteklemek için ap_register_auth_provider()
üzerinden artık bir sağlayıcı olarak çalıştırılabilmektedir.</dd>
<dt>Küçük Nesne Arabellekleme Arayüzü</dt>
<dd><var>ap_socache.h</var>, evvelki <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> oturum
arabelleği gerçeklenimine dayalı olarak küçük veri nesnelerini
arabelleklemek için sağlayıcı temelli bir arayüz ortaya koyar.
Paylaşımlı bellek çevrimsel tamponu kullanan sağlayıcılar, disk bazlı
dbm dosyaları ve memcache ile dağıtılan arabellekler şu an
desteklenmektedir.</dd>
<dt>Arabellek Durum Kancası Eklendi</dt>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> modülü artık, arabellekleme kararı bilinir
olduğunda çağrılan yeni bir <code>cache_status</code> kancası içeriyor.
Öntanımlı gerçeklenim, yanıta istemlik bir <code>X-Cache</code> ve
<code>X-Cache-Detail</code> ekleyebilmektedir.</dd>
</dl>
<p>Geliştirici belgeleri <a href="developer/new_api_2_4.html">API
değişikliklerinin ayrıntılı bir listesini</a> içermektedir.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/new_features_2_4.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_4.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./tr/new_features_2_4.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_4.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_0.html.ko.euc-kr 0000664 0001751 0001751 00000035031 14743132254 022650 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache 2.0 ο - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache 2.0 ο </h1>
<div class="toplang">
<p><span> : </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ġ 1.3 2.0 ֵ
Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">ٽ κп </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module"> </a></li>
</ul><h3></h3><ul class="seealso"><li><a href="upgrading.html">1.3 2.0 ̵</a></li><li><a href="#comments_section">Comments</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="core" id="core">ٽ κп </a></h2>
<dl>
<dt>н </dt>
<dd>POSIX 带 ϴ н ýۿ ġ
μ ȥؼ ִ.
δ ƴ Ȯ尡ɼ(scalability) δ.</dd>
<dt>ο ý</dt>
<dd> ý <code>autoconf</code> <code>libtool</code>
ϵ ۼǾ. ġ ý ٸ
Ű .</dd>
<dt> </dt>
<dd> ġ ִ
. <code class="module"><a href="./mod/mod_echo.html">mod_echo</a></code> ۼǾ.</dd>
<dt>н ÷ </dt>
<dd>Apache 2.0 BeOS, OS/2, н
÷ ȭǾ. ġ ̵
÷ װ ȴ POSIX ȣȯ
ü API ÷ Ư <a href="mpm.html">ó </a>
(MPM) Apache Portable Runtime (APR) Ͽ ȴ.</dd>
<dt>ο ġ API</dt>
<dd> API 2.0 ߴ. 1.3
켱 . 2.0 ̸ κ ڵ
óϸ, (hook) Ѵ.
, ġ ٽ κ ʰ ο
ϴ Լ ߰Ǿ.</dd>
<dt>IPv6 </dt>
<dd> Apache Portable Runtine ̺귯 IPv6 ϴ
ýۿ ġ ⺻ IPv6 ٸ. ,
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>,
<code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code>,
<code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> þ
IPv6 ּҸ Ѵ. (,
"<code>Listen [2001:db8::1]:8080</code>").</dd>
<dt></dt>
<dd> ġ 帧
ͷ ִ. <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>
<code>INCLUDES</code> Ͽ CGI ũƮ ¿
Server Side Include þ ó ִ.
<code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> CGI α
ڵ鷯 ϴ Ͱ ܺ α ͷ
ְ Ѵ.</dd>
<dt>ٱ </dt>
<dd> 乮 SSI
Ͽ ٱ ȴ. ڴ ϵ ܰ
ִ.</dd>
<dt> </dt>
<dd>ȥ ִ þ . ȥ
ִ <code>Port</code> <code>BindAddress</code> þ
IP ּ ῡ
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> þ
Ѵ. <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
þ ̷ǰ ȣƮ νĿ
Ʈ Ѵ.</dd>
<dt>Windows NT ڵ ü </dt>
<dd>Windows NT Apache 2.0 ϸ ڵ
utf-8 Ѵ. ϸ ڵ Ͻý
Ǿ, Windows 2000 Windows XP Windows NT
ýۿ ٱ Ѵ. <em> Windows 95,
98, ME ʰ, Ͻý ٿ ý
ڵ Ѵ.</em></dd>
<dt>ǥ ̺귯 Updated</dt>
<dd>Apache 2.0 <a href="http://www.pcre.org/">Perlȣȯ
ǥ ̺귯 (Perl Compatible Regular Expression
Library)</a> (PCRE) Ѵ. ǥĿ
Perl 5 ִ.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module"> </a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>Apache 2.0 ߰Ǿ. OpenSSL
ϴ SSL/TLS ȣȭ ̽.</dd>
<dt><code class="module"><a href="./mod/mod_dav.html">mod_dav</a></code></dt>
<dd>Apache 2.0 ߰Ǿ.
ø ϱ HTTP Distributed Authoring and Versioning
(DAV) ǥ Ѵ.</dd>
<dt><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></dt>
<dd>Apache 2.0 ߰Ǿ. Ʈ 뷮
̱ ؼ û
ִ.</dd>
<dt><code class="module"><a href="./mod/mod_auth_ldap.html">mod_auth_ldap</a></code></dt>
<dd>Apache 2.0.41 ߰Ǿ. HTTP
Basic Authentication ϴ LDAP ͺ̽
Ѵ. õ <code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>
Ǯ(connection pool) ϰ, ijѴ.</dd>
<dt><code class="module"><a href="./mod/mod_auth_digest.html">mod_auth_digest</a></code></dt>
<dd> Ͽ μ ij Ѵ.</dd>
<dt><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></dt>
<dd>Apache 2.0 ߰Ǿ.
ȯ ۼ Ѵ.</dd>
<dt><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></dt>
<dd>Apache 2.0 ߰Ǿ. Apache 1.3
<code>mod_mmap_static</code> ɿ ij
߰ߴ.</dd>
<dt><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></dt>
<dd> Apache 2.0 .
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> ϴ û
ְ, 쿡 ִ.</dd>
<dt><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dt>
<dd> Ͻ ο ̿ϰ
HTTP/1.1 Ͻø ϱ ۼǾ. ߰
ο <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
Ͻ (
) . <code><Directory "proxy:..."></code>
ʴ´. <code>proxy_connect</code>,
<code>proxy_ftp</code>, <code>proxy_http</code>
ϴ .</dd>
<dt><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></dt>
<dd>ο <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code>
þ Ŭ̾Ʈ NOT ACCEPTABLE̳ MULTIPLE CHOICES
Ѵ. ߰
˰ MultiViews ˰ ϰ
Ǿ, ִ ο
type map ߰Ǿ.</dd>
<dt><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code></dt>
<dd>ڵ 丮
HTML ǥ ְ Ǿ, Ͽ
ļ ڼ , 丮 ϵī
ɷ ִ.</dd>
<dt><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dt>
<dd>ο þ Ͽ SSI ⺻ ±
ħ ± ְ, ð SSI ܿ
Ͽ ְ Ǿ. mod_include (
Perl ǥ ) ǥ Ľ̰
<code class="module"><a href="./mod/mod_include.html">mod_include</a></code> <code>$0</code>
... <code>$9</code> ִ.</dd>
<dt><code class="module"><a href="./mod/mod_auth_dbm.html">mod_auth_dbm</a></code></dt>
<dd> <code class="directive"><a href="./mod/mod_auth_dbm.html#authdbmtype">AuthDBMType</a></code>
þ Ͽ DBM ͺ̽ Ѵ.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_0.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_2.html.ko.euc-kr 0000664 0001751 0001751 00000022731 14743132254 022655 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ġ 2.2 ο - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>ġ 2.2 ο </h1>
<div class="toplang">
<p><span> : </span><a href="./en/new_features_2_2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_2.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ko/new_features_2_2.html" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_2.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ġ 2.0 2.2 ֵ
Ѵ. 1.3 ο <a href="new_features_2_0.html">2.0 ο </a>
϶.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">ٽ κп </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer"> ڿ </a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="core" id="core">ٽ κп </a></h2>
<dl>
<dt>Authn/Authz</dt>
<dd>...</dd>
<dt>ij</dt>
<dd>...</dd>
<dt>Ͻ</dt>
<dd>ο <code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code>
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> Ϻл Ѵ.
ο <code class="module"><a href="./mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code> <a href="http://tomcat.apache.org/">ġ Ĺ</a>
ϴ <code>Apache JServ Protocol 1.3 </code>
Ѵ.</dd>
<dt>ȶ </dt>
<dd><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> ͼ
ִ. û , , ȯ溯
ְ, 2.0 ǽɽ
ش.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module"> </a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></dt>
<dd> 2.0 <code>mod_auth_ldap</code>
2.2 <code>Authn/Authz</code> ű ̴. <code class="directive"><a href="./mod/core.html#require">Require</a></code> þ LDAP
Ӽ(attribute) ˻ ִ
߰Ǿ.</dd>
<dt><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></dt>
<dd>ġ о þ ϸ ٹȣ
ִ <code>?config</code> ƱԸƮ ߰Ǿ.
û (hook) <code>httpd -V</code>
ش.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="developer" id="developer"> ڿ </a></h2>
<dl>
<dt>APR 1.0 API</dt>
<dd>ġ 2.2 APR 1.0 API Ѵ. <code>APR</code>
<code>APR-Util</code> Ǿ Լ
ɺ . ڼ <a href="http://apr.apache.org/">APR Ʈ</a> ϶.</dd>
<dt> α </dt>
<dd>Ŭ̾Ʈ ῡ α ϱ
Լ <code>ap_log_cerror</code> ߰ߴ. α
ϸ Ŭ̾Ʈ IP ּҰ ´.</dd>
<dt> Ʈ ߰</dt>
<dd>ڰ httpd <code>-t</code> ɼ 쿡
Ư ڵ带 ϵ <code>test_config</code>
߰ߴ.</dd>
<dt> MPM ũ </dt>
<dd> MPM ũ⸦ ϱ
<code>ThreadStackSize</code> þ ߰ߴ.
ũ ⺻ ÷ Ϻ ڰ
쿡 ʿϴ.</dd>
<dt> ó</dt>
<dd> Ϳ ڽ ó 信 ùٸ
ϴ Ȯ å ־. ʹ
<code>ap_register_output_filter_protocol</code> Ȥ
<code>ap_filter_protocol</code> ȣ Ͽ ϻ
<code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> ѱ
ִ.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/new_features_2_2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_2.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ko/new_features_2_2.html" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_2.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_2.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_2.html.pt-br 0000664 0001751 0001751 00000025471 14743132254 022107 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="pt-br" xml:lang="pt-br"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Descrição das novas funcionalidades do Apache 2.2 - Servidor HTTP Apache Versão 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Diretrizes</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossário</a> | <a href="./sitemap.html">Mapa do site</a></p>
<p class="apache">Servidor HTTP Apache Versão 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentação</a> > <a href="./">Versão 2.4</a></div><div id="page-content"><div id="preamble"><h1>Descrição das novas funcionalidades do Apache 2.2</h1>
<div class="toplang">
<p><span>Línguas Disponíveis: </span><a href="./en/new_features_2_2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_2.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ko/new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_2.html" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_2.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Esta tradução pode estar desatualizada.
Confira a versão em Inglês para mudanças recentes.</div>
<p>Esse documento descreve algumas das principais mudanças
entre as versões 2.0 e 2.2 do Servidor HTTP Apache.
Para a lista de mudanças desde a versão 1.3, veja a página
de documentação <a href="new_features_2_0.html">novas funcionalidades
do Apache 2.0</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Principais Melhorias</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Melhorias nos Módulos</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Mudanças ao Desenvolvedor de Módulos</a></li>
</ul><h3>Veja também</h3><ul class="seealso"><li><a href="#comments_section">Comentários</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="core" id="core">Principais Melhorias</a></h2>
<dl>
<dt>Authn/Authz</dt>
<dd>...</dd>
<dt>Caching</dt>
<dd>...</dd>
<dt>Proxying</dt>
<dd>O novo módulo <code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> fornece
serviços de carregamento de balenceamento para <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>. O novo módulo <code class="module"><a href="./mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code> oferece suporte para o <code>Protocolo Apache JServ
versão 1.3</code>, usado pelo <a href="http://tomcat.apache.org/">Apache Tomcat</a>.</dd>
<dt>Filtragem Inteligente (Smart Filtering)</dt>
<dd>O <code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> introduz configuração dinâmica para
o filtro de saída de dados. Permitindo que os filtros sejam
condicionalmente inseridos, baseando-se nos cabeçalhos <em>Request</em> ou <em>Response</em> ou em variáveis do
ambiente, ele acaba com os problemas de dependências e pedidos
da arquitetura 2.0.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Melhorias nos Módulos</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></dt>
<dd>Este módulo é uma migração do <code>mod_auth_ldap</code>,
da versão 2.0 para a estrutura 2.2 de <code>Authn/Authz</code>.
As novas funcionalidades incluem o uso de atributos LDAP e
filtros de procura complexos na diretriz <code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code>.</dd>
<dt><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></dt>
<dd>Adicionado um novo argumento <code>?config</code> que
mostra a configuração das diretrizes analisadas pelo
Apache, incluindo o nome do arquivo e o número da linha.
Esse módulo também mostra a ordem de todos os ganchos de
pedidos (request hooks) e informações adicionais sobre
a compilação, similar ao comando <code>httpd -V</code>.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="developer" id="developer">Mudanças ao Desenvolvedor de Módulos</a></h2>
<dl>
<dt>API do APR 1.0</dt>
<dd>O Apache 2.2 utiliza a API do APR 1.0. Todas as funções e
símbolos antigos foram removidos do <code>APR</code> e
<code>APR-Util</code>. Para mais detalhes, visite o
<a href="http://apr.apache.org/">Website do APR</a>.</dd>
<dt>Registros de Erros de Conexão (logs)</dt>
<dd>Uma nova função <code>ap_log_cerror</code>, foi adicionada
para registrar erros que ocorrem na conexão do cliente.
Quando documentado no diário de log, a mensagem inclui o
endereço IP do cliente.</dd>
<dt>Adicionado Gancho de Teste de Configuração</dt>
<dd>Um novo gancho (hook), <code>test_config</code> foi
adicionado para auxiliar módulos que querem executar
códigos especiais apenas quando o usuário passa o
parâmetro <code>-t</code> para o httpd.</dd>
<dt>Ajustar o Stacksize dos "Threaded MPM's"</dt>
<dd>Uma nova diretriz chamada <code>ThreadStackSize</code>,
foi adicionada para ajustar o tamanho das stacks em todos
os threadeds MPMs. Essa é uma prática necessário para alguns
módulos de terceiros em plataformas com tamanhos de stacks
pequenos por padrão.</dd>
<dt>Negociação de Protocolo para filtros de saída</dt>
<dd>No passado, todo filtro era responsável por garantir
a geração de cabeçalhos de resposta correto que os afetava.
Os filtros agora podem delegar o gerenciamento de protocolos
comuns para <code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>, usando chamadas
de <code>ap_register_output_filter_protocol</code> ou
<code>ap_filter_protocol</code>.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Línguas Disponíveis: </span><a href="./en/new_features_2_2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_2.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ko/new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_2.html" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_2.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentários</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_2.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licenciado sob a <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Diretrizes</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossário</a> | <a href="./sitemap.html">Mapa do site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/ 0000775 0001751 0001751 00000000000 15032766627 016677 5 ustar covener covener httpd-2.4.64/docs/manual/programs/rotatelogs.html.ko.euc-kr 0000664 0001751 0001751 00000023626 14743132254 023545 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>rotatelogs - ġ α ȯϱ
α α - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>rotatelogs - ġ α ȯϱ
α α</h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/rotatelogs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/rotatelogs.html" title="Korean"> ko </a> |
<a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>rotatelogs</code> ġ α
α̴. :</p>
<div class="example"><p><code>
CustomLog "|bin/rotatelogs /var/logs/logfile 86400" common
</code></p></div>
<p> /var/logs/logfile.nnnn . nnnn
α ý۽ð̴ ( ð ȯⰣ
̴. cron ũƮ óϱ ). ȯⰣ
(⼭ 24 ð) ο α Ѵ.</p>
<div class="example"><p><code>
CustomLog "|bin/rotatelogs /var/logs/logfile 5M" common
</code></p></div>
<p> α ũⰡ 5 ްƮ ɶ
ȯѴ.</p>
<div class="example"><p><code>
ErrorLog "|bin/rotatelogs /var/logs/errorlog.%Y-%m-%d-%H_%M_%S 5M"
</code></p></div>
<p> α ũⰡ 5 ްƮ ɶ
<code>errorlog.YYYY-mm-dd-HH_MM_SS</code>
α ȯѴ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#portability">ðɼ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p><code><strong>rotatelogs</strong>
[ -<strong>l</strong> ]
<var>logfile</var>
[ <var>rotationtime</var> [ <var>offset</var> ]] |
[ <var>filesize</var>M ]</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<dl>
<dt><code>-l</code></dt>
<dd>ȯֱ GMT ð Ѵ. (BST DST )
GMT ð ϴ ȯ濡 <code>-l</code> ϸ ġ
ִ!</dd>
<dt><code><var>logfile</var></code></dt>
<dd>α ο ̸. <var>logfile</var> '%' ڰ
ִٸ <code>strftime(3)</code> Ĺڿ óѴ.
'%' ڰ ٸ ڿ ʴ ð <var>.nnnnnnnnnn</var>
ڵ δ. Ⱓ ۽ð Ѵ.</dd>
<dt><code><var>rotationtime</var></code></dt>
<dd>α ȯ ʴ ð.</dd>
<dt><code><var>offset</var></code></dt>
<dd>UTC д ð. ϸ 0 Ͽ UTC
Ѵ. , UTC -5 ð ð Ѵٸ
ƱԸƮ <code>-300</code> Ѵ.</dd>
<dt><code><var>filesize</var>M</code></dt>
<dd>ð ƴ ũ⸦ Ҷ ްƮ ִ ũ
ڿ <code>M</code> δ. rotationtime offset
Ķ Ѵ.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="portability" id="portability">ðɼ</a></h2>
<p> α Ĺڿ ǥ <code>strftime(3)</code>
ؾ Ѵ. ̺귯 Ư Ȯ
<code>strftime(3)</code> manpage ϶.</p>
<table class="bordered"><tr><td><code>%A</code></td><td>(ȭ) ̸</td></tr>
<tr class="odd"><td><code>%a</code></td><td>(ȭ) 3- ̸</td></tr>
<tr><td><code>%B</code></td><td>(ȭ) ̸</td></tr>
<tr class="odd"><td><code>%b</code></td><td>(ȭ) 3- ̸</td></tr>
<tr><td><code>%c</code></td><td>(ȭ) ¥ ð</td></tr>
<tr class="odd"><td><code>%d</code></td><td>2-ڸ </td></tr>
<tr><td><code>%H</code></td><td>2-ڸ ð (24 ð ð)</td></tr>
<tr class="odd"><td><code>%I</code></td><td>2-ڸ ð (12 ð ð)</td></tr>
<tr><td><code>%j</code></td><td>3-ڸ ¥</td></tr>
<tr class="odd"><td><code>%M</code></td><td>2-ڸ </td></tr>
<tr><td><code>%m</code></td><td>2-ڸ </td></tr>
<tr class="odd"><td><code>%p</code></td><td>(ȭ) 12 ð ð am/pm</td></tr>
<tr><td><code>%S</code></td><td>2-ڸ </td></tr>
<tr class="odd"><td><code>%U</code></td><td>2-ڸ ϼ ( ù
Ͽ)</td></tr>
<tr><td><code>%W</code></td><td>2-ڸ ϼ ( ù
)</td></tr>
<tr class="odd"><td><code>%w</code></td><td>1-ڸ ϼ ( ù°
Ͽ)</td></tr>
<tr><td><code>%X</code></td><td>(ȭ) ð</td></tr>
<tr class="odd"><td><code>%x</code></td><td>(ȭ) ¥</td></tr>
<tr><td><code>%Y</code></td><td>4-ڸ </td></tr>
<tr class="odd"><td><code>%y</code></td><td>2-ڸ </td></tr>
<tr><td><code>%Z</code></td><td>ð ̸</td></tr>
<tr class="odd"><td><code>%%</code></td><td>ڱ״ `%'</td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/rotatelogs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/rotatelogs.html" title="Korean"> ko </a> |
<a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/rotatelogs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/apxs.html 0000664 0001751 0001751 00000000562 13710016232 020520 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: apxs.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: apxs.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: apxs.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: apxs.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/httpd.html.tr.utf8 0000664 0001751 0001751 00000033517 14743132254 022221 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>httpd - Apache Hiper Metin Aktarım Protokolü Sunucusu - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>httpd - Apache Hiper Metin Aktarım Protokolü Sunucusu</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/httpd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/httpd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/httpd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/httpd.html" title="Türkçe"> tr </a></p>
</div>
<p><strong><code>httpd</code></strong>, Apache Hiper Metin Aktarım
Protokolü (HTTP) sunucusu programıdır. Tek başına çalışan bir artalan
süreci olarak tasarlanmıştır. Bu tarz kullanıldığında istekleri işleme
sokmak için çocuk süreçlerden ve evrelerden oluşan bir havuz
oluşturur.</p>
<p>Genelde, <strong><code>httpd</code></strong>'nin doğrudan çağrılmaması
gerekir. Unix ve benzerlerinde <code class="program"><a href="../programs/apachectl.html">apachectl</a></code>
aracılığıyla, <a href="../platform/windows.html#winsvc">Windows NT, 2000
ve XP</a>'de bir hizmet olarak, <a href="../platform/windows.html#wincons">Windows 9x ve ME</a>'de ise bir
konsol uygulaması olarak çalıştırılır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="../invoking.html">Apache httpd'nin Başlatılması</a></li><li><a href="../stopping.html">Apache httpd'nin Durdurulması</a></li><li><a href="../configuring.html">Yapılandırma Dosyaları</a></li><li><a href="../platform/">Platforma Özgü Belgeler</a></li><li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>httpd</strong> [ -<strong>d</strong>
<var>sunucu-kök-dizini</var> ] [ -<strong>f</strong>
<var>yapılandırma-dosyası</var> ]
[ -<strong>C</strong> <var>yönerge</var> ] [ -<strong>c</strong>
<var>yönerge</var> ] [ -<strong>D</strong> <var>parametre</var> ]
[ -<strong>e</strong> <var>seviye</var> ] [ -<strong>E</strong>
<var>dosya</var> ]
[ <strong>-k</strong> start | restart | graceful | stop | graceful-stop ]
[ -<strong>h</strong> ]
[ -<strong>l</strong> ] [ -<strong>L</strong> ] [ -<strong>S</strong> ]
[ -<strong>t</strong> ] [ -<strong>v</strong> ] [ -<strong>V</strong> ]
[ -<strong>X</strong> ] [ -<strong>M</strong> ] [ -<strong>T</strong> ]
</code></p>
<p><a href="../platform/windows.html">Windows sistemlerinde</a>, ek
olarak şunlar vardır:</p>
<p><code><strong>httpd</strong> [ -<strong>k</strong> install | config |
uninstall ] [ -<strong>n</strong> <var>isim</var> ]
[ -<strong>w</strong> ]</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code><strong>-d</strong> <var>sunucu-kök-dizini</var></code></dt>
<dd><var>sunucu-kök-dizini</var>'ni <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> yönergesine ilk değer olarak atar. Yapılandırma
dosyasındaki bir <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>
yönergesiyle bu atama geçersiz kılınabilir. Bu seçenek belirtilmediği
takdirde <code>/usr/local/apache2</code> dizini öntanımlıdır.</dd>
<dt><code><strong>-f</strong> <var>yapılandırma-dosyası</var></code></dt>
<dd>Başlatma sırasında <var>yapılandırma-dosyası</var>'ndaki yönergeler
kullanılır. Eğer <var>yapılandırma-dosyası</var> bir / ile başlamıyorsa
dosyanın <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> yönergesinin
değerine göreli olduğu varsayılır. Seçenek belirtilmediği takdirde
<code>conf/httpd.conf</code> öntanımlı değerdir.</dd>
<dt><code><strong>-k</strong> <code>start | restart | graceful | stop |
graceful-stop</code></code></dt>
<dd><strong><code>httpd</code></strong>'yi başlatmak, durdurmak ve yeniden
başlatmak için sinyal gönderir. Daha ayrıntılı bilgi edinmek için <a href="../stopping.html">Apache httpd'nin Durdurulması</a> belgesine
bakınız.</dd>
<dt><code><strong>-C</strong> <var>yönerge</var></code></dt>
<dd>Yapılandırma <var>yönerge</var>'sini yapılandırma dosyalarını okumadan
önce işleme sokar.</dd>
<dt><code><strong>-c</strong> <var>yönerge</var></code></dt>
<dd>Yapılandırma <var>yönerge</var>'sini yapılandırma dosyalarını
okuduktan sonra işleme sokar.</dd>
<dt><code><strong>-D</strong> <var>parametre</var></code></dt>
<dd>Sunucu başlatılırken veya yeniden başlatılırken komutları şarta bağlı
olarak işleme sokmak veya atlamak için yapılandırma dosyalarında
kullanılan <code class="directive"><a href="../mod/core.html#ifdefine"><IfDefine></a></code>
bölümlerinde kullanılmak üzere bir yapılandırma <var>parametre</var>'si
tanımlar. Ayrıca, <code>-DNO_DETACH</code> (ana sürecin çatallanmasını
engellemek için), <code>-DFOREGROUND</code> (ana sürecin
<code>setsid()</code> ve benzerlerinden çağrılmasını engellemek için)
gibi daha az bilinen bazı başlatma parametrelerini atamakta da
kullanılabilir.</dd>
<dt><code><strong>-e</strong> <var>seviye</var></code></dt>
<dd>Hata günlüğü seviyesi olarak <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> yönergesine sunucu başlatılırken <var>seviye</var>
değerini atar. Bu seçenek, başlatma sırasındaki sorunları saptamak
amacıyla hata iletilerinin ayrıntı seviyesini geçici olarak arttırmak
için kullanılır.</dd>
<dt><code><strong>-E</strong> <var>dosya</var></code></dt>
<dd>Sunucunun başlatılması sırasında hata iletilerinin belirtilen
<var>dosya</var>'ya gönderilmesini sağlar.</dd>
<dt><code><strong>-h</strong></code></dt>
<dd>Mevcut komut satırı seçeneklerinin kısa bir özetini çıktılar.</dd>
<dt><code><strong>-l</strong></code></dt>
<dd>Sunucunun içinde derlenmiş modüllerin listesini çıktılar. Bu liste
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> yönergesi kullanılarak
devingen olarak yüklenen modülleri içermez.</dd>
<dt><code><strong>-L</strong></code></dt>
<dd>Durağan modüllerce sağlanmış yönergeleri olası değerleriyle geçerli
konumlarına yerleştirerek listeler. Paylaşımlı modüllerce sağlanan
yönergeleri listelemez.</dd>
<dt><code><strong>-M</strong></code></dt>
<dd>Yüklü durağan ve paylaşımlı modülleri listeler.</dd>
<dt><code><strong>-S</strong></code></dt>
<dd>Yapılandırma dosyasından çözümlenmiş haliyle ayarları gösterir (şu an
sadece sanal konak ayarları gösterilmektedir).</dd>
<dt><code><strong>-T</strong></code> (2.3.8 ve sonrasında
kullanılabilmektedir)</dt>
<dd>Başlatma ve yeniden başlatma sırasında belge kökü sınanmadan
geçilir.</dd>
<dt><code><strong>-t</strong></code></dt>
<dd>Yapılandırma dosyasını sözdizimi hatalarına karşı denetler. Program
sözdizimini denetledikten sonra sözdizimi geçerliyse 0 ile, değilse
sıfırdan farklı bir değerle çıkar.
<code><strong>-D</strong>DUMP_VHOSTS</code> seçeneği ile birlikte
kullanılmışsa ek olarak sanal konak ayrıntıları da basılır.
<code><strong>-D</strong>DUMP_MODULES</code> seçeneği ile ise ek olarak
tüm modüller listelenir.</dd>
<dt><code><strong>-v</strong></code></dt>
<dd><strong><code>httpd</code></strong> sürümünü basar ve çıkar.</dd>
<dt><code><strong>-V</strong></code></dt>
<dd>Sürümü ve <strong><code>httpd</code></strong> kurulum parametrelerini
basar ve çıkar.</dd>
<dt><code><strong>-X</strong></code></dt>
<dd><strong><code>httpd</code></strong> hata ayıklama kipinde çalışır. Tek
çocuk süreç başlatılır ve sunucu konsolu terketmez.</dd>
</dl>
<p>Aşağıdaki seçenekler sadece <a href="../platform/windows.html">Windows
platformunda geçerlidir</a>:</p>
<dl>
<dt><code><strong>-k</strong> install | config | uninstall</code></dt>
<dd>Parametreler bakımından sırasıyla: Apache httpd bir Windows NT hizmeti
haline getirilir; başlatma seçenekleri Apache httpd hizmeti için
değiştirilir; ve Apache httpd hizmeti sistemden kaldırılır.</dd>
<dt><code><strong>-n</strong> <var>isim</var></code></dt>
<dd>Sinyal gönderilecek Apache httpd hizmetinin <var>ismi</var>.</dd>
<dt><code><strong>-w</strong></code></dt>
<dd>Hata durumunda konsol penceresi açık tutularak hata iletilerinin
okunması sağlanır.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/httpd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/httpd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/httpd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/httpd.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/httpd.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/index.html.tr.utf8 0000664 0001751 0001751 00000016124 14743132254 022200 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Sunucu ve Destek Programları - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Sunucu ve Destek Programları</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/programs/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/programs/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Bu sayfada Apache HTTP Sunucusuna dahil tüm çalıştırılabilir programlar
tanıtılmıştır.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="index" id="index">Dizin</a></h2>
<dl>
<dt><code class="program"><a href="../programs/httpd.html">httpd</a></code></dt>
<dd>Apache hiper metin aktarım protokolü sunucusu.</dd>
<dt><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></dt>
<dd>Apache HTTP Sunucusu denetim arayüzü.</dd>
<dt><code class="program"><a href="../programs/ab.html">ab</a></code></dt>
<dd>Apache HTTP Sunucusu başarım ölçme aracı.</dd>
<dt><code class="program"><a href="../programs/apxs.html">apxs</a></code></dt>
<dd>Apache HTTP Sunucusu eklenti aracı (APache eXtenSion tool).</dd>
<dt><code class="program"><a href="../programs/configure.html">configure</a></code></dt>
<dd>Kaynak ağacını yapılandırır.</dd>
<dt><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></dt>
<dd>Kullanıcı kimlik doğrulama dosyalarını temel kimlik doğrulaması için
DBM biçeminde oluşturur ve günceller.</dd>
<dt><code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code></dt>
<dd>Bir FastCGI programını çalıştırır.</dd>
<dt><code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code></dt>
<dd>Disk arabelleğini temizler.</dd>
<dt><code class="program"><a href="../programs/htdigest.html">htdigest</a></code></dt>
<dd>Kullanıcı kimlik doğrulama dosyalarını özet kimlik doğrulaması için
oluşturur ve günceller.</dd>
<dt><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></dt>
<dd>DBM parola veritabanlarını idare eder.</dd>
<dt><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code></dt>
<dd>Kullanıcı kimlik doğrulama dosyalarını temel kimlik doğrulaması için
oluşturur ve günceller.</dd>
<dt><code class="program"><a href="../programs/httxt2dbm.html">httxt2dbm</a></code></dt>
<dd><code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> ile kullanmak
üzere DBM dosyaları oluşturur.</dd>
<dt><code class="program"><a href="../programs/logresolve.html">logresolve</a></code></dt>
<dd>Apache günlük dosyalarındaki IP adreslerini konak isimlerine
dönüştürür.</dd>
<dt><code class="program"><a href="../programs/log_server_status.html">log_server_status</a></code></dt>
<dd>Sunucunun durumunu düzenli aralıklarla günlüğe kaydeder.</dd>
<dt><code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code></dt>
<dd>Sunucuyu öldürmek gerekmeksizin günlük dosyalarının döndürülmesini
sağlar.</dd>
<dt><code class="program"><a href="../programs/split-logfile.html">split-logfile</a></code></dt>
<dd>Bir çok konaklı günlük dosyasını konak başına bir günlük dosyası düşecek şekilde böler.</dd>
<dt><code class="program"><a href="../programs/suexec.html">suexec</a></code></dt>
<dd>Bir dosyayı belli bir kullanıcı adına çalıştırır.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/programs/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/programs/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htdbm.html 0000664 0001751 0001751 00000000436 13710016232 020643 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: htdbm.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: htdbm.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: htdbm.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/logresolve.html.tr.utf8 0000664 0001751 0001751 00000016040 14743132254 023247 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>logresolve - Apache günlük dosyalarındaki IP adreslerini konak
isimlerine dönüştürür - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>logresolve - Apache günlük dosyalarındaki IP adreslerini konak
isimlerine dönüştürür</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/logresolve.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/logresolve.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/logresolve.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/logresolve.html" title="Türkçe"> tr </a></p>
</div>
<p><code><strong>logresolve</strong></code>, Apache'nin erişim
günlüklerindeki IP adreslerini çözümlemek için bir ardıl işlem
uygulamasıdır. İsim sunucunuza bindirdiği yükü en aza indirmek için
<code><strong>logresolve</strong></code> kendi arabelleğinde oluşturduğu
eşleme tablosunu kullanır.</p>
<p>Apache günlük dosyasını standart girdisinden okur. IP adresleri günlük
dosyası satırlarında ilk bileşen olmalı ve sonraki bileşenlerden bir
boşluk ile ayrılmalıdır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>logresolve</strong> [ -<strong>s</strong>
<var>dosyaismi</var> ] [ -<strong>c</strong> ] <
<var>günlük_dosyası</var> > <var>yeni_günlük_dosyası</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code>-s <var>dosyaismi</var></code></dt>
<dd>İstatistiklerin kaydedileceği dosyanın ismi belirtilir.</dd>
<dt><code>-c</code></dt>
<dd><code><strong>logresolve</strong></code> uygulamasının bazı DNS
sorguları yapmasına sebep olur: IP adresine karşılık olan konak ismini
bulduktan sonra özgün adresle karşılaştırmak için bu konak ismine karşılık
gelen IP adresini sorgular.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/logresolve.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/logresolve.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/logresolve.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/logresolve.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/logresolve.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/rotatelogs.html.tr.utf8 0000664 0001751 0001751 00000045705 14743132254 023263 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>rotatelogs - Apache günlüklerini döndürmek için borulu günlük kayıt
programı - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>rotatelogs - Apache günlüklerini döndürmek için borulu günlük kayıt
programı</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/rotatelogs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/rotatelogs.html" title="Türkçe"> tr </a></p>
</div>
<p><code><strong>rotatelogs</strong></code>, Apache'nin borulu günlük
dosyaları özelliği ile birlikte kullanmak için tasarlanmış basit bir
programdır. Günlük dosyasının azami boyutuna göre veya belli aralıklarla
günlük dosyalarını döndürür.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Örnekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#portability">Taşınabilirlik</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>rotatelogs</strong>
[ -<strong>l</strong> ]
[ -<strong>L</strong> <var>isim</var> ]
[ -<strong>p</strong> <var>program</var> ]
[ -<strong>f</strong> ]
[ -<strong>D</strong> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
[ -<strong>e</strong> ]
[ -<strong>c</strong> ]
[ -<strong>n</strong> <var>dosya_sayısı</var> ]
<var>dosyaismi</var>
<var>süre</var>|<var>boyut</var>(B|K|M|G)
[ <var>saat_farkı</var> ]</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code><strong>-l</strong></code></dt>
<dd>GMT yerine yerel zamanın kullanılmasını sağlar.</dd>
<dt><code><strong>-L</strong></code> <var>bagismi</var></dt>
<dd><p>Belirtilen bağ dosyası ismine geçerli günlük dosyasından kalıcı bir bağ
oluşturulur. <code>tail -F bagismi</code> gibi bir komut kullanılarak
günlüğün sürekli izlenmesi için kullanılabilir.</p>
<p>Bağ ismi mutlak bir yol içermiyorsa, <code>rotatelogs</code>'un çalışma
dizinine, <code>rotatelogs</code> sunucu tarafından çalıştırılıyorsa
<code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> dizinine görelidir.</p>
</dd>
<dt><code><strong>-p</strong></code> <var>program</var></dt>
<dd>Belirtildiği takdirde, <code><strong>rotatelogs</strong></code> yeni
bir günlük dosyasının her açılışında belirtilen programı çalıştırır. Yeni
açılan dosyanın ismi programa ilk argüman olarak aktarılır. Bu işlem bir
döndürme sonrası yapılırsa eski günlük dosyası ikinci argüman olarak
aktarılır. <code><strong>rotatelogs</strong></code> işlemini sürdürmek için
belirtilen programın sonlanmasını beklemez, dolayısıyla sonlanma soucunda
döndürülen hata kodunu günlüğe kaydetmez. Çalıştırılan program
<code><strong>rotatelogs</strong></code> ile aynı stdin, stdout ve stderr'i
kullanır ve ortamı da miras alır.</dd>
<dt><code><strong>-f</strong></code></dt>
<dd>İlk günlük giridisinin okunmasını beklemeden
<code><strong>rotatelogs</strong></code> başlar başlamaz günlük
dosyasının açılmasını sağlar. Çok meşgul sitelerde, sunucu başlatılıp ilk
istek sunuluncaya kadar geçen zamanda günlük dosyasının yokluğu
özdevinimli işlemler yapan bazı günlükleme araçlarında sorunlara yol
açabilir. Bu seçenek bu gibi durumlarda yararlıdır.</dd>
<dt><code><strong>-D</strong></code></dt>
<dd>Günlük dosyasının yerleştirileceği dizini (eğer yoksa) üst dizinleri ile
birlikte yapılandırır. Bu, <code>strftime(3)</code> işlevinin sırf dosya için
değil yol için de kullanılmasını sağlar.</dd>
<dt><code><strong>-t</strong></code></dt>
<dd>Günlük dosyasının döndürülmek yerine tepeden kırpılmasına sebep olur.
Günlüğün <code><strong>tail</strong></code> gibi bir araç tarafından gerçek
zamanda işlendiği ve veriyi saklamanın gerekmediği durumda kullanışlıdır.
Dosya ismine bir sonek eklenmez, ancak biçem dizgesi '%' karakteri
içeriyorsa buna uyulur.</dd>
<dt><code>-T</code></dt>
<dd>Açıldığında ilk günlük dosyası dışındaki tüm dosyaların kırpılmasına
neden olur. Bu, biçem dizgesi ayın günü gibi döngüsel bir şey içerdiğinde
kullanışlıdır. 2.4.56 ve sonrasında mevcuttur.
</dd>
<dt><code><strong>-v</strong></code></dt>
<dd>Standart hataya verilen çıktı daha ayrıntılı olur. Çıktı,
yapılandırma çözümlemesinin sonuçlarını ve tüm dosya açma/kapama
işlemlerini içerir.</dd>
<dt><code><strong>-e</strong></code></dt>
<dd>Günlüğü standart çıktıya basar. Günlüğün zincirdeki ilgili araç
tarafından gerçek zamanda işlenmesi gerektiğinde kullanışlıdır.</dd>
<dt><code><strong>-c</strong></code></dt>
<dd>Boş olsa bile her döngüde günlük dosyası oluşturur.</dd>
<dt><code><strong>-n</strong> <var>dosya_sayısı</var></code></dt>
<dd>Zaman damgalarına bakılmaksızın bir dosya serisi açılır. Bu seçenek
döndürme ve başlatma sırasında günlük dosyalarının üzerine yazar.
Örneğin -n3 belirtilirse <var>dosyaismi</var>, <var>dosyaismi.1</var>,
<var>dosyaismi.2</var> serisi açılır ve <var>dosyaismi</var>'nin üzerine
yazılır.<br />
Bu uygulama <var>dosyaismi</var> dosyasını ilk açtığında, dosya yalnızca
<code>-t</code> seçeneği de belirtilmişse kırpılır. Sonraki her döngü,
daima hedef dosya kırpılarak başlar. <code>-t</code> ve mevcut günlük
dosyaları olmadan boyuta dayalı döndürme için bu seçenek, ilk günlük
girişlerinin <var>dosyaismi.1</var>'e gönderilmesine ve
<var>dosyaismi.n</var> henüz kullanılmamış olsa bile
<var>dosyaismi.1</var>'deki girdilerin korunmaması gibi sezgisel
olmayan davranışlara neden olabilir.<br />
2.4.5 ve sonraki sürümler içindir.</dd>
<dt><code><var>dosyaismi</var></code></dt>
<dd><p>Günlük dosyasının ismi yoluyla birlikte belirtilir.
<var>dosyaismi</var> '%' karakterleri içeriyorsa bunlar
<code>strftime(3)</code> biçem belirteçleri olarak ele alınır. Aksi
takdirde, özdevinimli olarak <var>.nnnnnnnnnn</var> uzantısı üretilir.
(<code><strong>-t</strong></code> seçeneği kullanılmadıkça) Uzantı saniye
cinsindendir ve her iki durumda da bu değer, mevcut döngü
diliminin başlangıcına göre hesaplanır. Örneğin, döndürmenin 86400
saniyede bir yapılacağı belirtilmişse, <code>strftime(3)</code> biçeminde
oluşturulan saat, dakika ve saniye alanları, 24 saatlik sürenin
başlangıcını (geceyarısı) göstermek üzere sıfırlarla doldurulur.</p>
<p><code>strftime(3)</code> dosyaismi biçemlemesi kullanılırken, günlük
dosyası biçeminin günlük dosyası döndürülürken her zaman farklı bir dosya
ismi üretecek yeterlilikte parçacıklı yapıya sahip olduğundan emin
olmalısınız. Aks takdirde döndürme işlemi yeni bir dosya başlatmak yerine
hep aynı dosyanın üzerine yazar. Örneğin, <var>logfile</var> için
<code>/var/log/errorlog.%Y-%m-%d</code> belirtilmişse 5 mega baytta bir
yeni bir günlük dosyasına başlanacaktır. Fakat 5 megabayta gün içinde iki
kez ulaşılırsa aynı günlük dosyası üretilir ve günlük hep aynı dosyanın
üzerine yazılır.</p>
<p>Günlük dosyası mutlak bir yol içermiyorsa, <code>rotatelogs</code>'un
çalışma dizinine, <code>rotatelogs</code> sunucu tarafından
çalıştırılıyorsa <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>
dizinine görelidir.</p>
</dd>
<dt><code><var>süre</var></code></dt>
<dd>Günlük dosyasının yenisinin kaç saniyede bir açılacağı belirtilir.
Örneğin, bu süre 3600 saniye ise günlük dosyası her saat başında
yenilenir; 86400 saniye ise her geceyarısı yenilenir. (Bu süre zarfında
günlüğe kaydedilecek bir olay gerçekleşmemişse dosya oluşturulmaz.)</dd>
<dt><code><var>boyut</var>(B|K|M|G)</code></dt>
<dd>Boyuta göre döndürme için azami dosya boyutu. Belirtilenin bir süre
değil de bir boyut değeri olarak ele alınması için değerin sonuna şu
karakterlerden biri eklenmelidir: <code>B</code> (Bayt), <code>K</code>
(kilobayt), <code>M</code> (megabayt), <code>G</code> (gigabayt).
<p>Süre ve boyut birlikte belirtilmişse boyut süreden sonra
belirtilmelidir. Dosya yenilemesi, bunlardan hangisi daha önce aşılırsa o
zaman gerçekleşir.</p></dd>
<dt><code><var>saat_farkı</var></code></dt>
<dd>Koordinatlı evrensel zamana göre "dakika" farkı. Belirtilmezse, sıfır
öntanımlıdır. Örneğin, -5 saatlik bir zaman diliminde bulunuyorsanız bu
değer <code>-300</code> olmalıdır. Çoğu durumda, bunun yerine
<code><strong>-l</strong></code> seçeneğini kullanmak gerekir.</dd>
</dl>
</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">Örnekler</a></h2>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs /var/log/logfile 86400" common</pre>
</div>
<p>nnnn, günlük kaydının başladığı sistem zamanı olmak üzere
/var/log/logfile.nnnn dosyası oluşturulur. Bu zaman, daima döngü
süresinin katları olacağından bunu cron betiklerinizi eşzamanlamakta
kullanabilirsiniz. Her döngü süresinin sonunda (burada 24 saat sonra)
yeni bir günlük dosyası açılır.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -l /var/log/logfile.%Y.%m.%d 86400" common</pre>
</div>
<p>yyyy, yıl; mm, ay; dd, ayın gününü belirtmek üzere
/var/log/logfile.yyyy.mm.dd dosyası oluşturulur. Her gün yerel zamanla
geceyarısı yeni bir günlük dosyasına geçilecektir.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs /var/log/logfile 5M" common</pre>
</div>
<p>Günlük dosyası 5 megabaytlık olunca yenisinin oluşturulmasını sağlar.
</p>
<div class="example"><pre class="prettyprint lang-config">ErrorLog "|bin/rotatelogs /var/log/errorlog.%Y-%m-%d-%H_%M_%S 5M"</pre>
</div>
<p>Hata günlüğünün 5 megabaytta bir
<code>errorlog.YYYY-mm-dd-HH_MM_SS</code> biçemli bir isimle
oluşturulmasını sağlar.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -t /var/log/logfile 86400" common</pre>
</div>
<p><code>/var/log/logfile</code> dosyasını oluşturur, sunucu başlatılırken ve günde
bir kere dosyanın tepesi kırpılır. Bu senaryoda ayrı bir sürecin (tail
gibi) dosyayı gerçek zamanlı işleyeceği umulur.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -T /var/log/logfile.%d 86400" common</pre>
</div>
<p>Sunucu ayın birinde başlatılırsa (veya yeniden başlatılırsa), bu,
<code>/var/log/logfile.01</code> dosyasının sonuna eklenir. Ayın ikinci
günü bir günlük girişi yazıldığında, <code>/var/log/logfile.02</code>
kırpılır ve en üste yeni girdiler eklenir. Bu örnek, özel bir bakım
gerektirmeden yaklaşık 1 aylık günlük tutar.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="portability" id="portability">Taşınabilirlik</a></h2>
<p>Aşağıdaki günlük dosyası biçem belirteçlerinin tüm
<code>strftime(3)</code> gerçeklenimlerince desteklenmesi gerekir.
Kullandığınız kütüphaneye özgü belirteçler için sisteminizdeki
<code>strftime(3)</code> kılavuz sayfasına bakınız.</p>
<table class="bordered"><tr><td><code>%A</code></td><td>tam gün ismi (yerelleştirilmiş)</td></tr>
<tr class="odd"><td><code>%a</code></td><td>3 harflik gün ismi
(yerelleştirilmiş)</td></tr>
<tr><td><code>%B</code></td><td>tam ay ismi (yerelleştirilmiş)</td></tr>
<tr class="odd"><td><code>%b</code></td><td>3 harflik ay ismi (yerelleştirilmiş)</td></tr>
<tr><td><code>%c</code></td><td>tarih ve saat (yerelleştirilmiş)</td></tr>
<tr class="odd"><td><code>%d</code></td><td>2 haneli ay günü numarası</td></tr>
<tr><td><code>%H</code></td><td>2 haneli saat (24 saatlik)</td></tr>
<tr class="odd"><td><code>%I</code></td><td>2 haneli saat (12 saatlik)</td></tr>
<tr><td><code>%j</code></td><td>3 hanelik yıl günü numarası</td></tr>
<tr class="odd"><td><code>%M</code></td><td>2 haneli dakika</td></tr>
<tr><td><code>%m</code></td><td>2 haneli ay</td></tr>
<tr class="odd"><td><code>%p</code></td><td>12 saatlik kip için öö/ös
(yerelleştirilmiş)</td></tr>
<tr><td><code>%S</code></td><td>2 haneli saniye</td></tr>
<tr class="odd"><td><code>%U</code></td><td>2 haneli yılın hafta numarası
(Haftanın ilk gününün Pazar olduğu varsayımıyla)</td></tr>
<tr><td><code>%W</code></td><td>2 haneli yılın hafta numarası
(Haftanın ilk gününün Pazartesi olduğu varsayımıyla)</td></tr>
<tr class="odd"><td><code>%w</code></td><td>1 hanelik haftanın gün numarası
(Haftanın ilk gününün Pazar olduğu varsayımıyla)</td></tr>
<tr><td><code>%X</code></td><td>saat (yerelleştirilmiş)</td></tr>
<tr class="odd"><td><code>%x</code></td><td>tarih (yerelleştirilmiş)</td></tr>
<tr><td><code>%Y</code></td><td>4 hanelik yıl</td></tr>
<tr class="odd"><td><code>%y</code></td><td>2 hanelik yıl</td></tr>
<tr><td><code>%Z</code></td><td>zaman dilimi ismi</td></tr>
<tr class="odd"><td><code>%%</code></td><td>`%' iminin kendisi</td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/rotatelogs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/rotatelogs.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/rotatelogs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/index.html 0000664 0001751 0001751 00000001046 13710016232 020652 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: index.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: index.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: index.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: index.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: index.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
URI: index.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/dbmmanage.html 0000664 0001751 0001751 00000000606 13710016232 021457 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: dbmmanage.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: dbmmanage.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: dbmmanage.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: dbmmanage.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/htdigest.html.fr.utf8 0000664 0001751 0001751 00000021046 14740503670 022666 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htdigest - Gestion des fichiers d'utilisateurs pour
l'authentification à base de condensés - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>htdigest - Gestion des fichiers d'utilisateurs pour
l'authentification à base de condensés</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htdigest.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htdigest.html" title="Français"> fr </a> |
<a href="../ko/programs/htdigest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htdigest.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>htdigest</code> permet de créer et maintenir les fichiers
textes dans lesquels sont stockés des noms d'utilisateurs, des
domaines de protection (realms) et des mots de passe pour
l'authentification à base de condensés des utilisateurs HTTP.
L'accès aux ressources du serveur HTTP Apache peut être limité aux
seuls utilisateurs enregistrés dans les fichiers créés par
<code>htdigest</code>.</p>
<p>Cette page de manuel ne décrit que les arguments de la ligne de
commande. Pour plus de détails à propos des directives nécessaires à
la configuration de l'authentification à base de condensés dans
<code class="program"><a href="../programs/httpd.html">httpd</a></code>, voir le manuel Apache qui est fourni avec
la distribution et peut être consulté à <a href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Considérations à propos de sécurité</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>htdigest</strong> [ -<strong>c</strong> ]
<var>fichier-mots-de-passe</var> <var>realm</var>
<var>nom-utilisateur</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">options</a></h2>
<dl>
<dt><code>-c</code></dt>
<dd>Crée le fichier <var>fichier-mots-de-passe</var>. Si
<var>fichier-mots-de-passe</var> existe déjà, il est tout d'abord
supprimé.</dd>
<dt><code><var>fichier-mots-de-passe</var></code></dt>
<dd>Nom du fichier contenant les noms utilisateurs, realms et mots
de passe. Si l'option <code>-c</code> est spécifiée, le fichier est
créé s'il n'existe pas, ou supprimé et recréé s'il existe
déjà.</dd>
<dt><code><var>realm</var></code></dt>
<dd>Le nom du domaine de protection auquel le nom d'utilisateur
appartient. Voir <a href="http://tools.ietf.org/html/rfc2617#section-3.2.1">http://tools.ietf.org/html/rfc2617#section-3.2.1</a>
pour plus de détails.</dd>
<dt><code><var>nom-utilisateur</var></code></dt>
<dd>Le nom d'utilisateur à créer ou mettre à jour dans le
<var>fichier-mots-de-passe</var>. Si <var>nom-utilisateur</var> est
absent de ce fichier, une nouvelle entrée est ajoutée. Si
l'utilisateur existe déjà, le mot de passe est modifié.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Considérations à propos de sécurité</a></h2>
<p>En tant qu'exécutable setuid, ce programme n'est pas sûr. En
conséquence, évitez de lui attribuer des permissions setuid.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htdigest.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htdigest.html" title="Français"> fr </a> |
<a href="../ko/programs/htdigest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htdigest.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htdigest.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/httxt2dbm.html.fr.utf8 0000664 0001751 0001751 00000020050 14740503670 022765 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>httxt2dbm - Génère des fichiers dbm à utiliser avec
RewriteMap - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>httxt2dbm - Génère des fichiers dbm à utiliser avec
RewriteMap</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/httxt2dbm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/httxt2dbm.html" title="Français"> fr </a> |
<a href="../tr/programs/httxt2dbm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>httxt2dbm</code> permet, à partir d'une entrée au format
texte, de générer des fichiers dbm à utiliser dans les directives
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> avec le type
de table <code>dbm</code>.
</p>
<p>Si le fichier de sortie existe déjà, il ne sera pas tronqué. Les
nouvelles clés seront ajoutées et les clés préexistantes mises à
jour.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></li><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>httxt2dbm</strong>
[ -<strong>v</strong> ]
[ -<strong>f</strong> <var>TYPE_DBM</var> ]
-<strong>i</strong> <var>TEXTE_SOURCE</var>
-<strong>o</strong> <var>SORTIE_DBM</var>
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-v</code></dt>
<dd>Sortie plus verbeuse</dd>
<dt><code>-f <var>TYPE_DBM</var></code></dt>
<dd>Spécifie le type DBM à utiliser pour le fichier de sortie.
S'il n'est pas spécifié, c'est la valeur par défaut de
l'<a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> qui sera utilisée. Les types disponibles
sont :
<code>GDBM</code> pour les fichiers GDBM,
<code>SDBM</code> pour les fichiers SDBM,
<code>DB</code> pour les fichiers DB,
<code>NDBM</code> pour les fichiers NDBM,
<code>default</code> pour le type DBM par défaut
</dd>
<dt><code>-i <var>TEXTE_SOURCE</var></code></dt>
<dd>Le fichier d'entrée à partir duquel le fichier dbm sera créé. Le
fichier doit être formaté de façon à ne contenir qu'un seul
enregistrement par ligne, de la forme : <code>clé valeur</code>.
Voir la documentation de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> pour plus de détails à
propos du format de ce fichier et de sa signification.
</dd>
<dt><code>-o <var>SORTIE_DBM</var></code></dt>
<dd>Nom du fichier dbm de sortie.</dd>
</dl>
</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">Exemples</a></h2>
<div class="example"><p><code>
httxt2dbm -i rewritemap.txt -o rewritemap.dbm<br />
httxt2dbm -f SDBM -i rewritemap.txt -o rewritemap.dbm<br />
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/httxt2dbm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/httxt2dbm.html" title="Français"> fr </a> |
<a href="../tr/programs/httxt2dbm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/httxt2dbm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/ab.html.ko.euc-kr 0000664 0001751 0001751 00000030614 14743132254 021737 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ab - ġ ɰ˻ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>ab - ġ ɰ˻ </h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/ab.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/ab.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/ab.html" title="Korean"> ko </a> |
<a href="../tr/programs/ab.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>ab</code> ġ ؽƮ (HTTP)
˻ϴ(benchmarking) ̴. ġ
ϴ ˷ش. Ư ġ ʴ
û ϴ ˷ش.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs"></a></li>
</ul><h3></h3><ul class="seealso"><li><a href="httpd.html">httpd</a></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p><code><strong>ab</strong>
[ -<strong>A</strong> <var>auth-username</var>:<var>password</var> ]
[ -<strong>c</strong> <var>concurrency</var> ]
[ -<strong>C</strong> <var>cookie-name</var>=<var>value</var> ]
[ -<strong>d</strong> ]
[ -<strong>e</strong> <var>csv-file</var> ]
[ -<strong>g</strong> <var>gnuplot-file</var> ]
[ -<strong>h</strong> ]
[ -<strong>H</strong> <var>custom-header</var> ]
[ -<strong>i</strong> ]
[ -<strong>k</strong> ]
[ -<strong>n</strong> <var>requests</var> ]
[ -<strong>p</strong> <var>POST-file</var> ]
[ -<strong>P</strong> <var>proxy-auth-username</var>:<var>password</var> ]
[ -<strong>q</strong> ]
[ -<strong>s</strong> ]
[ -<strong>S</strong> ]
[ -<strong>t</strong> <var>timelimit</var> ]
[ -<strong>T</strong> <var>content-type</var> ]
[ -<strong>v</strong> <var>verbosity</var>]
[ -<strong>V</strong> ]
[ -<strong>w</strong> ]
[ -<strong>x</strong> <var><table>-attributes</var> ]
[ -<strong>X</strong> <var>proxy</var>[:<var>port</var>] ]
[ -<strong>y</strong> <var><tr>-attributes</var> ]
[ -<strong>z</strong> <var><td>-attributes</var> ]
[http://]<var>hostname</var>[:<var>port</var>]/<var>path</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<dl>
<dt><code>-A <var>auth-username</var>:<var>password</var></code></dt>
<dd> BASIC Authentication Ѵ.
<code>:</code> ڸ ȣ base64 ڵϿ
Ѵ. 䱸ϴ (<em> </em>,
401 ʿ並 ) ڿ Ѵ.</dd>
<dt><code>-c <var>concurrency</var></code></dt>
<dd>ÿ ûϴ û. ⺻ ѹ û
.</dd>
<dt><code>-C <var>cookie-name</var>=<var>value</var></code></dt>
<dd>û <code>Cookie:</code> ߰Ѵ. ƱԸƮ
<code><var>name</var>=<var>value</var></code>
̴. ɼ ִ.</dd>
<dt><code>-d</code></dt>
<dd>"percentage served within XX [ms] table"
ʴ´. (ȣȯ ).</dd>
<dt><code>-e <var>csv-file</var></code></dt>
<dd>û óϴµ ɸ (и ) ð (1%
100%) ǥ (CSV) Ѵ.
̹ ''Ͽ 'gnuplot' Ϻ
ϴ.</dd>
<dt><code>-g <var>gnuplot-file</var></code></dt>
<dd> 'gnuplot' Ȥ TSV (Tab separate values,
) Ͽ Ѵ. Gnuplot, IDL, Mathematica,
Igor, Excel α ̷
ִ. ù° ٿ ̸ ´. </dd>
<dt><code>-h</code></dt>
<dd> Ѵ.</dd>
<dt><code>-H <var>custom-header</var></code></dt>
<dd>û ߰Ѵ. ƱԸƮ ݷ
(<em> </em>,
<code>"Accept-Encoding: zip/zop;8bit"</code>) ȿ
̴.</dd>
<dt><code>-i</code></dt>
<dd><code>GET</code> <code>HEAD</code> û Ѵ.</dd>
<dt><code>-k</code></dt>
<dd>HTTP KeepAlive Ѵ. <em> </em>,
HTTP ǿ û Ѵ. ⺻ KeepAlive
ʴ´.</dd>
<dt><code>-n <var>requests</var></code></dt>
<dd> ˻ϱ û. ⺻ û
ѹ Ϲ ɰ˻ .</dd>
<dt><code>-p <var>POST-file</var></code></dt>
<dd>POST ڷ .</dd>
<dt><code>-P <var>proxy-auth-username</var>:<var>password</var></code></dt>
<dd>Ͻø BASIC Authentication Ѵ.
<code>:</code> ڸ ȣ base64 ڵϿ
Ѵ. Ͻð 䱸ϴ (<em> </em>,
401 ʿ並 ) ڿ Ѵ.</dd>
<dt><code>-q</code></dt>
<dd>150 ̻ û <code>ab</code> 10% Ȥ
100 û <code>ǥؿ</code> Ȳ Ѵ.
<code>-q</code> ɼ ʴ´.</dd>
<dt><code>-s</code></dt>
<dd> ߰Ͽ Ͽٸ (<code>ab -h</code>
Ȯ ִ) <code>http</code> SSL
<code>https</code> Ѵ. ̰
<em>ſ</em> ̴. Ƹ ̴.</dd>
<dt><code>-S</code></dt>
<dd>߰ ǥ ʰ, հ ߰ ̰
ǥ ũ / ʴ´.
ּ//ִ Ѵ. (ȣȯ ).</dd>
<dt><code>-t <var>timelimit</var></code></dt>
<dd> ˻ϴ ִ ʴ ð.
<code>-n 50000</code> Ѵ. ð
˻Ҷ Ѵ. ⺻ ð ˻Ѵ.</dd>
<dt><code>-T <var>content-type</var></code></dt>
<dd>POST ڷ Content-type .</dd>
<dt><code>-v <var>verbosity</var></code></dt>
<dd> ڼ Ѵ. <code>4</code> ̸̻
, <code>3</code> ̸̻ (404, 202, )
ڵ带, <code>2</code> ̸̻ (warning)
(info) Ѵ.</dd>
<dt><code>-V</code></dt>
<dd> ϰ Ѵ.</dd>
<dt><code>-w</code></dt>
<dd> HTML ǥ Ѵ. ⺻ ǥ 濡
ۼѴ.</dd>
<dt><code>-x <var><table>-attributes</var></code></dt>
<dd><code><table></code> Ӽ ڿ.
Ӽ <code><table <var></var> ></code>
߰Ѵ.</dd>
<dt><code>-X <var>proxy</var>[:<var>port</var>]</code></dt>
<dd>Ͻ Ͽ ûѴ.</dd>
<dt><code>-y <var><tr>-attributes</var></code></dt>
<dd><code><tr></code> Ӽ ڿ.</dd>
<dt><code>-z <var><td>-attributes</var></code></dt>
<dd><code><td></code> Ӽ ڿ.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="bugs" id="bugs"></a></h2>
<p> ̰ ۸ Ѵ.
ƱԸƮ, , ٸ ܺ Էµ
о̸鼭 ִ.</p>
<p> α HTTP/1.x ʴ´;
'ϴ' 丸 ´. <code>strstr(3)</code>
ſ ӵ ִ; <em></em>,
ɺٴ <code>ab</code> ϰ
ִ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/ab.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/ab.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/ab.html" title="Korean"> ko </a> |
<a href="../tr/programs/ab.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/ab.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/apachectl.html.tr.utf8 0000664 0001751 0001751 00000032413 14743132254 023014 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>apachectl - Apache HTTP Sunucusu Denetim Arayüzü - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>apachectl - Apache HTTP Sunucusu Denetim Arayüzü</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/apachectl.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apachectl.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apachectl.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apachectl.html" title="Türkçe"> tr </a></p>
</div>
<p><code><strong>apachectl</strong></code> Apache Hiper Metin Aktarım
Protokolü (HTTP) sunucusu için bir denetim aracıdır. Sistem
yöneticisinin Apache <strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> artalan
sürecini denetimi altında tutabilmesine yardımcı olmak amacıyla
tasarlanmıştır.</p>
<p><code><strong>apachectl</strong></code> iki kipte işleyebilir.
İlkinde, <strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> komutu için basit
bir önyüz gibi davranarak, gerekli ortam değişkenlerini atar ve
belirtilen komut satırı seçenekleriyle
<strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> sürecini başlatır. İkinci
kipte ise, <code><strong>apachectl</strong></code> bir SysV başlatma
betiği olarak <code><strong>start</strong></code>,
<code><strong>restart</strong></code>,
<code><strong>stop</strong></code> gibi tek sözcüklük basit argümanlar
alır ve bunları uygun sinyallere dönüştürerek
<strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong>'ye gönderir.</p>
<p>Eğer Apache kurulumunuzda standart dışı dosya yolları kullanmışsanız,
<strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> programına uygun yolları
atamak için <code><strong>apachectl</strong></code> betiğini elden
geçirmelisiniz. Bu arada gerek gördüğünüz
<strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> komut satırı argümanlarını da
belirtebilirsiniz. Ayrıntılar için betik içindeki açıklamalara
bakınız.</p>
<p><code><strong>apachectl</strong></code> betiği başarı durumunda 0
çıkış değeri ile döner. Bir hata durumunda ise sıfırdan farklı bir
değerle döner. Daha fazla bilgi için betik içindeki açıklamalara
bakınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="../invoking.html">Apache'nin Başlatılması</a></li><li><a href="../stopping.html">Apache'nin Durdurulması</a></li><li><a href="../configuring.html">Yapılandırma Dosyaları</a></li><li><a href="../platform/">Platform Belgeleri</a></li><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>apachectl</strong></code> önyüz kipinde çalıştığında
<strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> programının bütün komut
satırı argümanlarını kabul edebilir.</p>
<p><code><strong>apachectl</strong> [ <var>httpd-argümanları</var> ]
</code></p>
<p>SysV başlatma betiği kipinde ise,
<code><strong>apachectl</strong></code> aşağıda tanımlanan basit, tek
sözcüklük komutları kabul eder.</p>
<p><code><strong>apachectl</strong> <var>komut</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<p>Burada sadece SysV başlatma betiğine özgü seçeneklere yer verilmiştir.
Diğer argümanlar için <strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> kılavuz
sayfasına bakınız.</p>
<dl>
<dt><code><strong>start</strong></code></dt>
<dd>Apache <strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> artalan sürecini
başlatır. Zaten çalışmaktaysa bir hata verir. <code><strong>apachectl
-k start</strong></code> komutuna eşdeğerdir.</dd>
<dt><code><strong>stop</strong></code></dt>
<dd>Apache <strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> artalan sürecini
durdurur. <code><strong>apachectl -k stop</strong></code> komutuna
eşdeğerdir.</dd>
<dt><code><strong>restart</strong></code></dt>
<dd>Apache <strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> artalan sürecini
yeniden başlatır; çalışmıyorsa çalıştırılır. Artalan sürecinin ölü
olmadığından emin olmak için yeniden başlatmadan önce
<code><strong>configtest</strong></code> seçeneği verilmiş gibi
yapılandırma dosyaları sınanır. <code><strong>apachectl -k
restart</strong></code> komutuna eşdeğerdir.</dd>
<dt><code><strong>fullstatus</strong></code></dt>
<dd><strong><code class="module"><a href="../mod/mod_status.html">mod_status</a></code></strong> üzerinden tam bir
durum raporu gösterir. Bunun çalışması için sunucuda
<strong><code class="module"><a href="../mod/mod_status.html">mod_status</a></code></strong> etkinleştirilmiş olmalı
ve sisteminizde <code><strong>lynx</strong></code> gibi bir metin
kipi HTTP tarayıcı kurulu olmalıdır. Durum raporuna erişmek için
kullanılacak adres betik içinde <code>STATUSURL</code> değişkenine
atanabilir.</dd>
<dt><code><strong>status</strong></code></dt>
<dd>Özet halinde bir durum raporu gösterir. O an sunulmakta olan
isteklerin gösterilmemesi dışında
<code><strong>fullstatus</strong></code> seçeneği gibidir.</dd>
<dt><code><strong>graceful</strong></code></dt>
<dd>Apache <strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> artalan sürecini
<em>nazikçe</em> yeniden başlatır; çalışmıyorsa çalıştırılır. O an
hizmet sunmakta olan çocuk süreçleri hemen durdurmaması dışında
normal yeniden başlatma gibidir. Bir yan etki olarak eski günlük
dosyaları hemen kapatılmaz. Yani, günlük dosyalarını döndüren bir
betik kullanıyorsanız yenilerini başlatmadan önce eski dosyaların
tamamen kapandığından emin olmak için belli bir süre beklemeniz
gerekecektir. Artalan sürecinin ölü olmadığından emin olmak için
yeniden başlatmadan önce <code><strong>configtest</strong></code>
seçeneği verilmiş gibi yapılandırma dosyaları sınanır.
<code><strong>apachectl -k graceful</strong></code> komutuna
eşdeğerdir.</dd>
<dt><code><strong>graceful-stop</strong></code></dt>
<dd>Apache <strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> artalan sürecini
<em>nazikçe</em> durdurur. O an hizmet sunmakta olan çocuk süreçleri
hemen durdurmaması dışında normal durdurma gibidir. Bir yan etki
olarak eski günlük dosyaları hemen kapatılmaz.
<code><strong>apachectl -k graceful-stop</strong></code> komutuna
eşdeğerdir.</dd>
<dt><code><strong>configtest</strong></code></dt>
<dd>Yapılandırma dosyasında sözdizimi denetimi yapılmasını sağlar.
Yapılandırma dosyaları çözümlenir ve bir sorun yoksa bir <code>Syntax
Ok</code> raporu verilir fakat, bir hata varsa o hataya ilişkin
ayrıntılı bilgi verilir. <code><strong>apachectl -t</strong></code>
komutuna eşdeğerdir.</dd>
</dl>
<p>Aşağıdaki seçenek eski sürümlerde kullanılmaktaydı, fakat artık
kullanılmamaktadır.</p>
<dl>
<dt><code>startssl</code></dt>
<dd><strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> programını SSL destekli
başlatmak için, yapılandırma dosyanızı ilgili yönergeleri içermesi
için elden geçirmeli ve normal <code><strong>apachectl
start</strong></code> komutunu kullanmalısınız.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/apachectl.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apachectl.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apachectl.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apachectl.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/apachectl.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/apachectl.html.fr.utf8 0000664 0001751 0001751 00000030211 14740503670 022771 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>apachectl - L'interface de contrôle du serveur HTTP
Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>apachectl - L'interface de contrôle du serveur HTTP
Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/apachectl.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apachectl.html" title="Français"> fr </a> |
<a href="../ko/programs/apachectl.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apachectl.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>apachectl</code> est un frontal pour le serveur HTTP
Apache. Il a été conçu pour aider l'administrateur à contrôler le
fonctionnement du démon Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p>
<p>Le script <code>apachectl</code> possède deux modes de
fonctionnement. Il peut fonctionner en tant que simple frontal
de la commande <code class="program"><a href="../programs/httpd.html">httpd</a></code> et ne fait alors que
définir toute variable d'environnement nécessaire, puis invoque
<code class="program"><a href="../programs/httpd.html">httpd</a></code> en lui passant tout argument de ligne de
commande souhaité. Il peut aussi fonctionner en tant que script
d'initialisation SysV n'acceptant qu'un seul argument tel que
<code>start</code>, <code>restart</code> et <code>stop</code>, et
traduisant ce dernier en signaux appropriés pour le démon
<code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p>
<p>Si votre installation d'Apache utilise des chemins non
standards, vous devrez éditer le script <code>apachectl</code> afin
de définir les chemins appropriés pour le binaire
<code class="program"><a href="../programs/httpd.html">httpd</a></code>. Vous pouvez aussi spécifier tout argument
de ligne de commande de <code class="program"><a href="../programs/httpd.html">httpd</a></code> nécessaire. Voir
les commentaires dans le script pour plus de détails.</p>
<p>Le script <code>apachectl</code> renvoie une valeur égale à 0 en
cas de succès, et une valeur supérieure à 0 en cas de problème.
Voir les commentaires dans le script pour plus de détails.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Résumé</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../invoking.html">Démarrer Apache</a></li><li><a href="../stopping.html">Arrêter Apache</a></li><li><a href="../configuring.html">Fichiers de
configuration</a></li><li><a href="../platform/">Documentation spécifique aux
plates-formes</a></li><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Résumé</a></h2>
<p>En mode frontal (pass-through), <code>apachectl</code> peut spécifier
tous les arguments qu'accepte le binaire <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p>
<p><code><strong>apachectl</strong> [ <var>argument-httpd</var> ]</code></p>
<p>En mode script d'initialisation SysV, <code>apachectl</code>
n'accepte qu'un seul des arguments définis ci-dessous.</p>
<p><code><strong>apachectl</strong> <var>commande</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<p>Seules les options du style initialisation SysV sont décrites ici.
Les autres arguments sont décrits dans la page de manuel de
<code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p>
<dl>
<dt><code>start</code></dt>
<dd>Démarre le démon Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Renvoie une erreur
s'il est déjà en cours d'exécution. Équivalent à <code>apachectl -k
start</code>.</dd>
<dt><code>stop</code></dt>
<dd>Arrête le démon Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Équivalent à
<code>apachectl -k stop</code>.</dd>
<dt><code>restart</code></dt>
<dd>Redémarre le démon Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Si le démon
n'est pas en cours d'exécution, il est démarré. Cette option vérifie
automatiquement les fichiers de configuration (de la même manière que
l'option <code>configtest</code> ) avant de lancer le redémarrage, afin
d'être sûr que le fonctionnement du démon ne sera pas compromis.
Equivalent à <code>apachectl -k restart</code>.</dd>
<dt><code>fullstatus</code></dt>
<dd>Affiche le rapport d'état complet du module
<code class="module"><a href="../mod/mod_status.html">mod_status</a></code>. Pour que ceci fonctionne,
<code class="module"><a href="../mod/mod_status.html">mod_status</a></code> doit être activé dans votre serveur et vous
devez disposer d'un navigateur en mode texte tel que <code>lynx</code>
sur votre système. L'URL utilisée pour accéder au rapport d'état peut
être modifiée en définissant la variable <code>STATUSURL</code> dans le
script.</dd>
<dt><code>status</code></dt>
<dd>Affiche un rapport d'état succinct. Similaire à l'option
<code>fullstatus</code>, excepté que la liste des requêtes en cours de
traitement est omise.</dd>
<dt><code>graceful</code></dt>
<dd>Redémarre le démon Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code> en douceur. Si le
démon n'est pas en cours d'exécution, il est démarré. À la différence
d'un redémarrage normal, les connexions en cours ne sont pas fermées.
Comme effet de bord, les anciens fichiers journaux ne seront pas fermés
immédiatement. Cela signifie que si l'on utilise un script de rotation
des journaux, un délai suffisant sera nécessaire afin d'être sûr que les
fichiers journaux seront bien fermés avant leur traitement par le script
de rotation. Cette option vérifie
automatiquement les fichiers de configuration (de la même manière que
l'option <code>configtest</code> ) avant de lancer le redémarrage, afin
d'être sûr que le fonctionnement du démon ne sera pas compromis.
Équivalent à <code>apachectl -k graceful</code>.</dd>
<dt><code>graceful-stop</code></dt>
<dd>Arrête le démon Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code> en douceur. À la
différence d'un arrêt normal, les connexions en cours ne sont pas
fermées. Comme effet de bord, les anciens fichiers journaux ne seront
pas fermés immédiatement. Équivalent à <code>apachectl -k
graceful-stop</code>.</dd>
<dt><code>configtest</code></dt>
<dd>Effectue une vérification de la syntaxe du fichier de configuration.
Avec cette option, le script parcourt le fichier de configuration et
renvoie soit <code>Syntax Ok</code>, soit des informations détaillées à
propos des éventuelles erreurs de syntaxe. Equivalent à <code>apachectl
-t</code>.</dd>
</dl>
<p>Les options suivantes étaient disponibles dans les anciennes versions
et ont été supprimées.</p>
<dl>
<dt><code>startssl</code></dt>
<dd>Pour démarrer <code class="program"><a href="../programs/httpd.html">httpd</a></code> avec le support SSL, vous
devez éditer votre fichier de configuration et y inclure les
directives appropriées, puis utiliser la commande de démarrage normale
<code>apachectl start</code>.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/apachectl.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apachectl.html" title="Français"> fr </a> |
<a href="../ko/programs/apachectl.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apachectl.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/apachectl.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/suexec.html 0000664 0001751 0001751 00000000572 13710016232 021042 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: suexec.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: suexec.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: suexec.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: suexec.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/ab.html.fr.utf8 0000664 0001751 0001751 00000051201 14740503670 021431 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ab - L'outil de test des performances du serveur HTTP
Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>ab - L'outil de test des performances du serveur HTTP
Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/ab.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/ab.html" title="Français"> fr </a> |
<a href="../ko/programs/ab.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/ab.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>ab</code> est un utilitaire qui vous permet de tester les
performances de votre serveur HTTP Apache. Il a été conçu pour vous
donner une idée du degré de performances de votre installation
d'Apache. Il vous permet en particulier de déterminer le nombre de
réquêtes que votre installation d'Apache est capable de servir par
seconde.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#output">Sortie</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Bogues</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>ab</strong>
[ -<strong>A</strong> <var>nom-utilisateur</var>:<var>mot-de-passe</var> ]
[ -<strong>b</strong> <var>taille-tampon</var> ]
[ -<strong>B</strong> <var>adresse-locale</var> ]
[ -<strong>c</strong> <var>simultanéité</var> ]
[ -<strong>C</strong> <var>nom-cookie</var>=<var>valeur</var> ]
[ -<strong>d</strong> ]
[ -<strong>e</strong> <var>fichier-csv</var> ]
[ -<strong>E</strong> <var>fichier du certificat client</var> ]
[ -<strong>f</strong> <var>protocole</var> ]
[ -<strong>g</strong> <var>fichier-gnuplot</var> ]
[ -<strong>h</strong> ]
[ -<strong>H</strong> <var>en-tête-personnalisé</var> ]
[ -<strong>i</strong> ]
[ -<strong>k</strong> ]
[ -<strong>l</strong> ]
[ -<strong>m</strong> <var>HTTP-method</var> ]
[ -<strong>n</strong> <var>requêtes</var> ]
[ -<strong>p</strong> <var>fichier-POST</var> ]
[ -<strong>P</strong>
<var>nom-utilisateur-mandataire</var>:<var>mot-de-passe</var> ]
[ -<strong>q</strong> ]
[ -<strong>r</strong> ]
[ -<strong>s</strong> <var>timeout</var> ]
[ -<strong>S</strong> ]
[ -<strong>t</strong> <var>limite-de-durée</var> ]
[ -<strong>T</strong> <var>type-de-contenu</var> ]
[ -<strong>u</strong> <var>fichier PUT</var> ]
[ -<strong>v</strong> <var>verbosité</var>]
[ -<strong>V</strong> ]
[ -<strong>w</strong> ]
[ -<strong>x</strong> <var><table>-attributs</var> ]
[ -<strong>X</strong> <var>mandataire</var>[:<var>port</var>] ]
[ -<strong>y</strong> <var><tr>-attributs</var> ]
[ -<strong>z</strong> <var><td>-attributs</var> ]
[ -<strong>Z</strong> <var>algorithme-chiffrement</var> ]
[http[s]://]<var>nom-serveur</var>[:<var>port</var>]/<var>chemin</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-A <var>nom-utilisateur</var>:<var>mot-de-passe</var></code></dt>
<dd>Fournit le support d'une authentification de base vers le
serveur. Les nom-utilisateur et mot-de-passe sont séparés par un
seul caractère <code>:</code> et transmis sous forme codée base64.
La chaîne est envoyée que le serveur en ait besoin ou non (qu'il ait
renvoyé un code "401 authentication needed" ou non).</dd>
<dt><code>-b <var>taille-tampon</var></code></dt>
<dd>Taille du tampon d'émission/réception TCP, en octets.</dd>
<dt><code>-B <var>adresse-locale</var></code></dt>
<dd>Adresse à laquelle se rattacher lors des connexions sortantes.</dd>
<dt><code>-c <var>simultanéité</var></code></dt>
<dd>Nombre de requêtes à effectuer simultanément. Par défaut, une
seule requête est effectuée à la fois.</dd>
<dt><code>-C <var>nom-cookie</var>=<var>valeur</var></code></dt>
<dd>Ajoute une ligne <code>Cookie:</code> à la requête. L'argument
se présente en général sous la forme d'une
paire <code><var>nom</var>=<var>valeur</var></code>. Ce champ peut
être répété.</dd>
<dt><code>-d</code></dt>
<dd>N'affiche pas le "pourcentage servi dans la table XX [ms]".
(support de l'héritage).</dd>
<dt><code>-e <var>fichier-csv</var></code></dt>
<dd>Enregistre des valeurs séparées par des virgules (CSV) dans un
fichier, indiquant pour chaque pourcentage (de 1% à 100 %), le temps
(en millisecondes) mis pour servir ce pourcentage de requêtes. Ce
fichier est en général plus utile qu'un fichier 'gnuplot', car les
résultats sont déjà sous forme binaire.</dd>
<dt><code>-E <var>fichier du certificat client</var></code></dt>
<dd>Utilise le certificat client au format PEM qu'il contient pour
s'authentifier auprès du serveur lors d'une connexion à un site web sous
SSL. Ce fichier doit contenir le certificat client suivi des certificats
intermédiaires et de la clé privé. Disponible à partir de la version 2.4.36
du serveur HTTP Apache.</dd>
<dt><code>-f <var>protocole</var></code></dt>
<dd>Spécifie le protocole SSL/TLS (SSL2, SSL3, TLS1, TLS1.1, TLS1.2, or ALL).
TLS1.1 et TLS1.2 sont supportés à partir de la version 2.4.4 du
serveur HTTP Apache.</dd>
<dt><code>-g <var>fichier-gnuplot</var></code></dt>
<dd>Enregistre toutes les valeurs mesurées dans un fichier 'gnuplot'
ou TSV (valeurs séparées par des tabulations). Ce fichier peut être
facilement importé dans des programmes comme Gnuplot, IDL,
Mathematica, Igor ou même Excel. La première ligne du fichier
contient les noms des valeurs.</dd>
<dt><code>-h</code></dt>
<dd>Affiche une aide à propos de l'utilisation du programme.</dd>
<dt><code>-H <var>en-tête-personnalisé</var></code></dt>
<dd>Ajoute des en-têtes supplémentaires à la requête. L'argument se
présente sous la forme d'une ligne d'en-tête valide, autrement dit
une paire champ/valeur séparés par un caractère ':' (par exemple
<code>"Accept-Encoding: zip/zop;8bit"</code>).</dd>
<dt><code>-i</code></dt>
<dd>Effectue des requêtes <code>HEAD</code> plutôt que
<code>GET</code>.</dd>
<dt><code>-k</code></dt>
<dd>Active la fonctionnalité des connexions HTTP persistantes
(KeepAlive), c'est à dire effectue plusieurs requêtes au cours d'une
seule session HTTP. Cette fonctionnalité est désactivée par
défaut.</dd>
<dt><code>-l</code></dt>
<dd>Ne signale pas les erreurs si la taille de la réponse n'est pas
constante. Cette option peut s'avérer utile pour les pages
dynamiques. Disponible à partir de la version 2.4.7 du serveur HTTP
Apache.
</dd>
<dt><code>-m <var>HTTP-method</var></code></dt>
<dd>Méthode HTTP personnalisée à utiliser pour les requêtes.
Disponible à partir de la version 2.4.10 du serveur HTTP
Apache.</dd>
<dt><code>-n <var>requêtes</var></code></dt>
<dd>Nombre de requêtes à effectuer au cours du test de performances.
Par défaut, une seule requête est effectuée, ce qui ne permet pas
d'obtenir des résultats représentatifs.</dd>
<dt><code>-p <var>fichier-POST</var></code></dt>
<dd>Fichier contenant les données pour les requêtes POST.
Assurez-vous de spécifier aussi le paramètre <code>-T</code>.</dd>
<dt><code>-P <var>nom-utilisateur-mandataire</var>:<var>mot-de-passe</var></code></dt>
<dd>Fournit les informations d'authentification basique pour un
mandataire en-route. Les nom d'utilisateur et mot de passe sont
séparés par un simple caractère <code>:</code> et envoyés sur le
réseau codés en base64. La chaîne est envoyée, que le mandataire en
ait besoin ou non (qu'il ait renvoyé un code "407 proxy
authentication needed" ou non).</dd>
<dt><code>-q</code></dt>
<dd>Lorsque plus de 150 requêtes sont traitées, <code>ab</code>
affiche la progression du traitement sur <code>stderr</code> tous
les 10% du nombre total ou toutes les 100 requêtes. Le drapeau
<code>-q</code> permet de supprimer ces messages.</dd>
<dt><code>-r</code></dt>
<dd>Ne s'arrête pas en cas d'erreur de réception du socket.</dd>
<dt><code>-s <var>timeout</var></code></dt>
<dd>Temps maximum d'attente en secondes du socket avant de considérer
le délai comme dépassé. La valeur par défaut est de 30 secondes.
Disponible à partir de la version 2.4.4 du serveur HTTP
Apache.</dd>
<dt><code>-S</code></dt>
<dd>N'affiche ni les valeurs de déviation standards et médianes, ni
les messages d'erreur et d'avertissement lorsque les valeurs
médianes et moyennes sont égales à une ou deux fois la valeur de
déviation standard. Par défaut les valeurs mini/moyenne/maxi sont
affichées (support de l'héritage).</dd>
<dt><code>-t <var>limite-durée</var></code></dt>
<dd>Durée maximale en secondes du test de performances. Ceci
implique un <code>-n 50000</code> en interne. Utilisez cette option
si vous souhaitez tester les performances du serveur pendant une
durée fixée à l'avance. Par défaut, il n'y a pas de limite de
durée.</dd>
<dt><code>-T <var>type-contenu</var></code></dt>
<dd>Valeur de l'en-tête Content-type à utiliser pour les données
POST/PUT, par exemple
<code>application/x-www-form-urlencoded</code>.
La valeur par défaut est <code>text/plain</code>.</dd>
<dt><code>-u <var>fichier PUT</var></code></dt>
<dd>Fichier contenant des données PUT. Ne pas oublier de spécifier
aussi <code>-T</code>.</dd>
<dt><code>-v <var>verbosité</var></code></dt>
<dd>Définit le niveau de verbosité - les niveaux <code>4</code> et
supérieurs permettent d'afficher des informations à propos des
en-têtes, les niveaux <code>3</code> et supérieurs les codes de
réponse (404, 200, etc...), et les niveaux <code>2</code> et
supérieurs les messages d'avertissement et d'information.</dd>
<dt><code>-V</code></dt>
<dd>Affiche le numéro de version et s'arrête.</dd>
<dt><code>-w</code></dt>
<dd>Affiche les résultats dans des tables HTML. La table par défaut
comporte deux colonnes sur fond blanc.</dd>
<dt><code>-x <var><table>-attributs</var></code></dt>
<dd>La chaîne à utiliser comme attributs pour
<code><table></code>. Les attributs sont insérés
<code><table <var>ici</var> ></code>.</dd>
<dt><code>-X <var>mandataire</var>[:<var>port</var>]</code></dt>
<dd>Utilise un serveur mandataire pour les requêtes.</dd>
<dt><code>-y <var><tr>-attributs</var></code></dt>
<dd>La chaîne à utiliser comme attributs pour
<code><tr></code>.</dd>
<dt><code>-z <var><td>-attributs</var></code></dt>
<dd>La chaîne à utiliser comme attributs pour
<code><td></code>.</dd>
<dt><code>-Z <var>algorithme-chiffrement</var></code></dt>
<dd>Spécifie l'algorithme de chiffrement SSL/TLS (Voir les
algorithme de chiffrement openssl).</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="output" id="output">Sortie</a></h2>
<p>Vous touverez dans ce qui suit la liste des valeurs retournées
par <code>ab</code> :
</p>
<dl>
<dt>Server Software</dt>
<dd>La valeur, si elle existe, de l'en-tête HTTP
<var>server</var> renvoyée dans la première réponse réussie.
Elle comporte tous les caractères de l'en-tête jusqu'à ce qu'un
caractère de valeur décimale 32 soit rencontré (le plus souvent
un espace ou une fin de ligne).</dd>
<dt>Server Hostname</dt>
<dd>Le nom DNS ou l'adresse IP fourni dans la ligne de commande.</dd>
<dt>Server Port</dt>
<dd>Le port auquel ab est connecté. Si la ligne de commande ne
spécifie aucun port, le port par défaut sera 80 pour http et 443
pour https.</dd>
<dt>SSL/TLS Protocol</dt>
<dd>Les paramètres de protocole négociés entre le client et le
serveur. Uniquement si SSL est utilisé.</dd>
<dt>Document Path</dt>
<dd>L'URI de la requête interprété à partir de la chaîne de la
ligne de commande.</dd>
<dt>Document Length</dt>
<dd>Il s'agit de la taille en octets du premier document renvoyé
avec succès. Si la taille du document est modifiée au cours
du test, la réponse est considérée comme une erreur.</dd>
<dt>Concurrency Level</dt>
<dd>Le nombre de clients simultanés utilisés au cours du test.</dd>
<dt>Time taken for tests</dt>
<dd>Il s'agit du temps écoulé entre le moment de la première
connexion au socket et la réception de la dernière
réponse.</dd>
<dt>Complete requests</dt>
<dd>Le nombre de réponses reçues avec succès.</dd>
<dt>Failed requests</dt>
<dd>Le nombre de requêtes considérées comme erronées. Si ce
nombre est différent de 0, une ligne supplémentaire indiquera le
nombre de requêtes ayant échoué suite à un problème de
connexion, de lecture, de taille de contenu erronée ou
d'exceptions.</dd>
<dt>Write errors</dt>
<dd>Le nombre d'erreurs rencontrées en cours d'écriture (broken pipe).</dd>
<dt>Non-2xx responses</dt>
<dd>Le nombre de réponses dont le code était en dehors de la
série 200. Si toutes les réponses appartiennent à la série 200,
cette ligne est absente.</dd>
<dt>Keep-Alive requests</dt>
<dd>Le nombre de connexions promues à l'état de connexions
persistantes.</dd>
<dt>Total body sent</dt>
<dd>Si le test a été configuré dans ce sens, il s'agit du nombre
total d'octets envoyés au cours du test. Ce champ est omis si le
test ne prévoyait pas d'envoi de corps.</dd>
<dt>Total transferred</dt>
<dd>Le nombre total d'octets reçus du serveur. Ce nombre
correspond à peu près au nombre d'octets envoyés sur la ligne.</dd>
<dt>HTML transferred</dt>
<dd>Le nombre total d'octets utiles (contenus) reçus du serveur.
Ce nombre n'inclut pas les octets correspondant aux en-têtes
HTTP.</dd>
<dt>Requests per second</dt>
<dd>Il s'agit du nombre de requêtes par seconde. Il correspond
au nombre de requêtes divisé par la durée totale du traitement.</dd>
<dt>Time per request</dt>
<dd>La durée moyenne du traitement d'une requête. La première
valeur est calculée selon la formule <code>concurrency *
timetaken * 1000 / done</code>, alors que la seconde valeur est
calculée selon la formule <code>timetaken * 1000 / done</code>.</dd>
<dt>Transfer rate</dt>
<dd>Le taux de transfert calculé selon la formule
<code>totalread / 1024 / timetaken</code>.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="bugs" id="bugs">Bogues</a></h2>
<p>De nombreux tampons de taille fixe sont déclarés statiquement.
Combiné avec l'interprétation poussive des arguments de la ligne de
commande, les en-têtes de réponse du serveur et autres entrées
externes, ceci peut vous affecter.</p>
<p>HTTP/1.x n'est pas complètement implémenté ; seules certaines
formes de réponses 'attendues' sont acceptées. L'utilisation
relativement intense de <code>strstr(3)</code> provoque un affichage
en tête de profil, ce qui peut faire croire à un problème de
performances ; en d'autres termes, vous mesurez les performances de
<code>ab</code> plutôt que celles du serveur.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/ab.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/ab.html" title="Français"> fr </a> |
<a href="../ko/programs/ab.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/ab.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/ab.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/index.html.fr.utf8 0000664 0001751 0001751 00000015665 14740503670 022174 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Le serveur et ses utilitaires - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Le serveur et ses utilitaires</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/programs/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/programs/" title="Français"> fr </a> |
<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Cette page documente tous les utilitaires inclus
dans le serveur HTTP Apache.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="index" id="index">Index</a></h2>
<dl>
<dt><code class="program"><a href="../programs/httpd.html">httpd</a></code></dt>
<dd>Le serveur de protocole de transfert hypertexte Apache</dd>
<dt><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></dt>
<dd>L'interface de contrôle du serveur HTTP Apache</dd>
<dt><code class="program"><a href="../programs/ab.html">ab</a></code></dt>
<dd>L'outil de test de performances du serveur HTTP Apache</dd>
<dt><code class="program"><a href="../programs/apxs.html">apxs</a></code></dt>
<dd>L'outil de gestion des extensions Apache</dd>
<dt><code class="program"><a href="../programs/configure.html">configure</a></code></dt>
<dd>Configuration de l'arborescence des sources</dd>
<dt><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></dt>
<dd>Crée et met à jour les fichiers d'authentification utilisateurs au
format DBM pour une authentification basique</dd>
<dt><code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code></dt>
<dd>Lance un programme fastcgi</dd>
<dt><code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code></dt>
<dd>Nettoie le cache sur disque</dd>
<dt><code class="program"><a href="../programs/htdigest.html">htdigest</a></code></dt>
<dd>Crée et met à jour les fichiers d'authentification pour une
authentification sommaire</dd>
<dt><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></dt>
<dd>Manipulation des bases de données DBM des mots de passe.</dd>
<dt><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code></dt>
<dd>Crée et met à jour les fichiers d'authentification pour une
authentification basique</dd>
<dt><code class="program"><a href="../programs/httxt2dbm.html">httxt2dbm</a></code></dt>
<dd>Crée des fichiers dbm destinés à être utilisés avec
RewriteMap</dd>
<dt><code class="program"><a href="../programs/logresolve.html">logresolve</a></code></dt>
<dd>Résolution des noms d'hôtes en adresses IP dans les fichiers
de traces d'Apache</dd>
<dt><code class="program"><a href="../programs/log_server_status.html">log_server_status</a></code></dt>
<dd>Journalisation périodique du statut du serveur</dd>
<dt><code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code></dt>
<dd>Rotation des traces d'Apache sans devoir arrêter le serveur</dd>
<dt><code class="program"><a href="../programs/split-logfile.html">split-logfile</a></code></dt>
<dd>Divise un journal pour plusieurs hôtes virtuels en journaux
spécifiques à chaque hôte</dd>
<dt><code class="program"><a href="../programs/suexec.html">suexec</a></code></dt>
<dd>Change d'utilisateur pour l'exécution de certains programmes</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/programs/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/programs/" title="Français"> fr </a> |
<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htdbm.html.fr.utf8 0000664 0001751 0001751 00000050402 14740503670 022147 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htdbm - Manipuler des bases de données DBM de mots de
passe - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>htdbm - Manipuler des bases de données DBM de mots de
passe</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htdbm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htdbm.html" title="Français"> fr </a> |
<a href="../tr/programs/htdbm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>htdbm</code> permet de manipuler des fichiers au format DBM
ou sont stockés des nom d'utilisateurs et mots de passe à des fins
d'authentification de base des utilisateurs HTTP via le module
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>. Voir la documentation de
<code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> pour plus de détails à propos de ces
fichiers DBM.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Bugs</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">Valeur renvoyée</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Considérations à propos de sécurité</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#restrictions">Restrictions</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></li><li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>htdbm</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
[ -<strong>i</strong> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>nom-fichier</var> <var>nom-utilisateur</var></code></p>
<p><code><strong>htdbm</strong> -<strong>b</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>nom-fichier</var> <var>nom-utilisateur</var> <var>mot-de-passe</var></code></p>
<p><code><strong>htdbm</strong> -<strong>n</strong>
[ -<strong>i</strong> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>nom-utilisateur</var></code></p>
<p><code><strong>htdbm</strong> -<strong>nb</strong>
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>nom-utilisateur</var> <var>mot-de-passe</var></code></p>
<p><code><strong>htdbm</strong> -<strong>v</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
[ -<strong>i</strong> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>nom-fichier</var> <var>nom-utilisateur</var></code></p>
<p><code><strong>htdbm</strong> -<strong>vb</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>nom-fichier</var> <var>nom-utilisateur</var> <var>mot-de-passe</var></code></p>
<p><code><strong>htdbm</strong> -<strong>x</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
<var>nom-fichier</var> <var>nom-utilisateur</var></code></p>
<p><code><strong>htdbm</strong> -<strong>l</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-b</code></dt>
<dd>Utilise le mode batch ; en d'autres termes, le mot de passe est
extrait de la ligne de commande au lieu d'être demandé à
l'opérateur. Cette option doit être utilisée avec la plus grande
prudence, car <strong>le mot de passe est visible en clair</strong>
dans la ligne de commande. Pour utiliser un script, voir l'option
<code>-i</code>.</dd>
<dt><code>-i</code></dt>
<dd>Lit le mot de passe depuis stdin sans vérification (à utiliser
dans le cadre d'un script).</dd>
<dt><code>-c</code></dt>
<dd>Crée le <var>fichier-mots-de-passe</var>. Si
<var>fichier-mots-de-passe</var> existe déjà, il est réécrit et
tronqué. Cette option ne peut pas être combinée avec l'option
<code>-n</code>.</dd>
<dt><code>-n</code></dt>
<dd>Affiche les résultats sur la sortie standard et ne met pas à
jour la base de données. Cette option modifie la syntaxe de la ligne
de commande, car l'argument <var>fichier-mots-de-passe</var> (en
général le premier) est omis. Elle ne peut pas être combinée avec
l'option <code>-c</code>.</dd>
<dt><code>-m</code></dt>
<dd>Utilise un hachage MD5 pour les mots de passe. Sous Windows
et Netware, c'est l'option par défaut..</dd>
<dt><code>-B</code></dt>
<dd>Utilise l'algorythme de hachage bcrypt pour les mots de
passe. C'est un algorythme actuellement considéré comme sûr.</dd>
<dt><code>-C</code></dt>
<dd>Ce drapeau n'est autorisé qu'en conjonction avec le drapeau
<code>-B</code> (hachage bcrypt). Il permet de définir la durée
de traitement pour l'algorythme de chiffrement bcrypt (plus elle est
longue, plus la sécurité est élevée, mais la rapidité est diminuée
d'autant) ; la valeur par défaut est 5, les valeurs valides vont de
4 à 31.</dd>
<dt><code>-d</code></dt>
<dd>Utilise un hachage <code>crypt()</code> pour les mots de
passe. C'est l'option par défaut sur toutes les plates-formes, sauf
Windows et Netware. Bien que <code>htdbm</code> supporte ce
chiffrement sur toutes les plates-formes, il n'est pas supporté par
le serveur <code class="program"><a href="../programs/httpd.html">httpd</a></code> sous Windows et Netware. Cet
algorythme est considéré comme <strong>non sûr</strong> selon les
standards actuels.</dd>
<dt><code>-s</code></dt>
<dd>Utilise le hachage SHA pour les mots de passe. Facilite la
migration vers/depuis les serveurs Netscape qui utilisent le format
LDAP Directory Interchange (ldif). Cet
algorythme est considéré comme <strong>non sûr</strong> selon les
standards actuels.</dd>
<dt><code>-p</code></dt>
<dd>Utilise des mots de passe au format texte en clair. Bien que
<code>htdbm</code> supporte ce format sur toutes les plates-formes,
le démon <code class="program"><a href="../programs/httpd.html">httpd</a></code> n'accepte les mots de passe au
format texte en clair que sous Windows et Netware.</dd>
<dt><code>-l</code></dt>
<dd>Affiche chaque nom d'utilisateur de la base de données
accompagné de son commentaire sur la sortie standard.</dd>
<dt><code>-v</code></dt>
<dd>Vérifie une association nom d'utilisateur/mot de passe. Le
programme affichera un message indiquant si le mot de passe fourni
est valide. Si le mot de passe n'est pas valide, le programme
s'arrête et renvoie un code d'erreur 3.</dd>
<dt><code>-x</code></dt>
<dd>Supprime l'utilisateur. Si le nom d'utilisateur existe dans le
fichier DBM spécifié, il sera supprimé.</dd>
<dt><code>-t</code></dt>
<dd>Interprète le dernier paramètre en tant que commentaire. Avec
cette option, il est possible d'ajouter une chaîne supplémentaire à
la fin de la ligne de commande ; le contenu de cette chaîne sera
stocké dans la base de données dans le champ "Comment" associé au
nom d'utilisateur spécifié.</dd>
<dt><code><var>nom-fichier</var></code></dt>
<dd>Le nom du fichier au format DBM en général sans l'extension
<code>.db</code>, <code>.pag</code>, ou <code>.dir</code>. Avec
l'option <code>-c</code>, le fichier DBM est mis à jour s'il existe
ou créé dans le cas contraire.</dd>
<dt><code><var>nom-utilisateur</var></code></dt>
<dd>Le nom d'utilisateur à créer ou mettre à jour dans le
<var>fichier-mots-de-passe</var>. Si <var>nom-utilisateur</var>
n'existe pas dans ce fichier, une entrée est ajoutée. S'il existe,
son mot de passe est modifié.</dd>
<dt><code><var>mot-de-passe</var></code></dt>
<dd>Le mot de passe en clair destiné à être haché et stocké dans
le fichier DBM. Ne s'utilise qu'avec l'option <code>-b</code>.</dd>
<dt><code>-T<var>DBTYPE</var></code></dt>
<dd>Type de fichier DBM (SDBM, GDBM, DB, ou "default").</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="bugs" id="bugs">Bugs</a></h2>
<p>Vous devez garder à l'esprit qu'il existe de nombreux formats de
fichiers DBM différents, et que selon toute vraisemblance, des
bibliothèques pour plus d'un format sont présentes sur votre
système. Les trois exemples de base sont SDBM, NDBM, le projet GNU
GDBM, et Berkeley/Sleepycat DB 2/3/4. Malheureusement, toutes ces
bibliothèques
utilisent des formats de fichiers différents, et vous devez vous
assurer que le format de fichier utilisé par <var>nom-fichier</var>
correspond au format attendu par <code>htdbm</code>.
Actuellement, <code>htdbm</code> n'a aucun moyen de savoir à
quel type de fichier DBM il a à faire. S'il est utilisé avec un
format inapproprié, il ne renverra rien, ou pourra créer un fichier
DBM différent avec un nom différent, ou au pire, va corrompre le
fichier DBM si vous avez tenté de le modifier.</p>
<p>Vous pouvez utiliser le programme <code>file</code> fourni par la
plupart des systèmes Unix pour déterminer le format d'un fichier
DBM.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">Valeur renvoyée</a></h2>
<p><code>htdbm</code> renvoie 0 ("true") si les nom d'utilisateur et
mot de passe ont été créés ou mis à jour avec succès dans le fichier
DBM. <code>htdbm</code> renvoie <code>1</code> s'il a rencontré un
problème d'accès aux fichiers, <code>2</code> si la ligne de
commande comportait une erreur de syntaxe, <code>3</code> si le mot
de passe a été fourni interactivement et s'il est invalide pour
l'entrée considérée, <code>4</code> si l'opération a été
interrompue, <code>5</code> si une valeur est trop longue (nom
utilisateur, nom fichier, mot de passe, ou l'enregistrement après
son élaboration), <code>6</code> si le nom d'utilisateur contient
des caractères illégaux (voir la section <a href="#restrictions">Restrictions</a>), et <code>7</code> si le
fichier n'est pas un fichier de mots de passe DBM valide.</p>
</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">Exemples</a></h2>
<div class="example"><p><code>
htdbm /usr/local/etc/apache/.utilisateurs-htdbm jsmith
</code></p></div>
<p>Ajoute ou modifie le mot de passe de l'utilisateur
<code>jsmith</code>. Le mot de passe est demandé à l'opérateur. Sous
Windows, le mot de passe sera haché en utilisant l'algorithme MD5
Apache modifié ; dans les autres cas, c'est la routine
<code>crypt()</code> du système qui sera utilisée. Si le fichier
n'existe pas, <code>htdbm</code> s'arrêtera et renverra une
erreur.</p>
<div class="example"><p><code>
htdbm -c /home/doe/public_html/.htdbm jane
</code></p></div>
<p>Crée un nouveau fichier et y enregistre une entrée pour
l'utilisateur <code>jane</code>. Le mot de passe est demandé à
l'opérateur. Si le fichier existe et ne peut pas être lu, ou ne peut
pas être écrit, il ne sera pas modifié et
<code>htdbm</code> affichera un message et renverra un code
d'erreur.</p>
<div class="example"><p><code>
htdbm -mb /usr/web/.htdbm-tous jones Pwd4Steve
</code></p></div>
<p>Chiffre le mot de passe entré avec la ligne de commande
(<code>Pwd4Steve</code>) à l'aide de l'algorithme MD5, et
l'enregistre dans le fichier spécifié.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Considérations à propos de sécurité</a></h2>
<p>Les fichiers de mots de passe Web tels que ceux que gère
<code>htdbm</code> ne doivent <em>pas</em> être stockés dans
l'espace d'URI du serveur Web -- en d'autres termes, il ne doit pas
être possible d'y accéder à l'aide d'un navigateur.</p>
<p>L'utilisation de l'option <code>-b</code> est déconseillée, car
lorsqu'il est utilisé, le mot de passe apparaît en clair sur la
ligne de commande.</p>
<p>Notez que lorsque vous utilisez l'algorythme
<code>crypt()</code>, seuls les 8 premiers caractères du mot de
passe sont pris en compte. Si le mot de passe fourni est plus long,
les caractères supplémentaires seront ignorés sans avertissement.</p>
<p>L'algorythme de hachage SHA ne permet pas de spécifier une valeur
d'initialisation pour la génération de nombres aléatoires (salting)
: un mot de passe donné ne possède ainsi qu'une seule représentation
hachée. Les algorythmes <code>crypt()</code> et MD5 permettent quant à
eux des représentations hachées multiples en acceptant comme
paramètre une chaîne d'initialisation (salt), rendant les attaques à
base de dictionnaires contre les mots de passe plus difficiles.</p>
<p>Les algorythmes SHA et <code>crypt()</code> sont considérés comme
non sûrs selon les standards actuels.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="restrictions" id="restrictions">Restrictions</a></h2>
<p>Sur la plate-forme Windows, les mots de passe hachés avec
<code>htdbm</code> ont une taille limitée à <code>255</code>
caractères. Si le mot de passe fourni est plus long, il sera tronqué
à 255 caractères.</p>
<p>L'algorithme MD5 utilisé par <code>htdbm</code> est spécifique à
Apache ; les mots de passe hachés en utilisant cet algorithme
seront inutilisables sur d'autres serveurs Web.</p>
<p>Les noms d'utilisateurs ont une taille limitée à <code>255</code>
octets et ne doivent pas contenir de caractère <code>:</code>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htdbm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htdbm.html" title="Français"> fr </a> |
<a href="../tr/programs/htdbm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htdbm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/apachectl.html.en 0000664 0001751 0001751 00000026554 14737241666 022130 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>apachectl - Apache HTTP Server Control Interface - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>apachectl - Apache HTTP Server Control Interface</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/apachectl.html" title="English"> en </a> |
<a href="../fr/programs/apachectl.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apachectl.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apachectl.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>apachectl</code> is a front end to the Apache HyperText
Transfer Protocol (HTTP) server. It is designed to help the
administrator control the functioning of the Apache
<code class="program"><a href="../programs/httpd.html">httpd</a></code> daemon.</p>
<p>The <code>apachectl</code> script can operate in two modes.
First, it can act as a simple front-end to the <code class="program"><a href="../programs/httpd.html">httpd</a></code>
command that simply sets any necessary environment variables and
then invokes <code class="program"><a href="../programs/httpd.html">httpd</a></code>, passing through any command line
arguments. Second, <code>apachectl</code> can act as a SysV init
script, taking simple one-word arguments like <code>start</code>,
<code>restart</code>, and <code>stop</code>, and translating them
into appropriate signals to <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p>
<p>If your Apache installation uses non-standard paths, you will
need to edit the <code>apachectl</code> script to set the
appropriate paths to the <code class="program"><a href="../programs/httpd.html">httpd</a></code> binary. You can also
specify any necessary <code class="program"><a href="../programs/httpd.html">httpd</a></code> command line arguments.
See the comments in the script for details.</p>
<p>The <code>apachectl</code> script returns a 0 exit value on
success, and >0 if an error occurs. For more details, view
the comments in the script.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../invoking.html">Starting Apache</a></li><li><a href="../stopping.html">Stopping Apache</a></li><li><a href="../configuring.html">Configuration Files</a></li><li><a href="../platform/">Platform Docs</a></li><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p>When acting in pass-through mode, <code>apachectl</code> can take
all the arguments available for the <code class="program"><a href="../programs/httpd.html">httpd</a></code>
binary.</p>
<p><code><strong>apachectl</strong> [ <var>httpd-argument</var> ]</code></p>
<p>When acting in SysV init mode, <code>apachectl</code> takes simple,
one-word commands, defined below.</p>
<p><code><strong>apachectl</strong> <var>command</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<p>Only the SysV init-style options are defined here. Other arguments
are defined on the <code class="program"><a href="../programs/httpd.html">httpd</a></code> manual page.</p>
<dl>
<dt><code>start</code></dt>
<dd>Start the Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code> daemon. Gives an error if it
is already running. This is equivalent to <code>apachectl -k
start</code>.</dd>
<dt><code>stop</code></dt>
<dd>Stops the Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code> daemon. This is equivalent to
<code>apachectl -k stop</code>.</dd>
<dt><code>restart</code></dt>
<dd>Restarts the Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code> daemon. If the daemon is
not running, it is started. This command automatically checks the
configuration files as in <code>configtest</code> before initiating
the restart to make sure the daemon doesn't die. This is equivalent
to <code>apachectl -k restart</code>.</dd>
<dt><code>fullstatus</code></dt>
<dd>Displays a full status report from <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>.
For this to work, you need to have <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> enabled
on your server and a text-based browser such as <code>lynx</code>
available on your system. The URL used to access the status report
can be set by editing the <code>STATUSURL</code> variable in the
script.</dd>
<dt><code>status</code></dt>
<dd>Displays a brief status report. Similar to the
<code>fullstatus</code> option, except that the list of requests
currently being served is omitted.</dd>
<dt><code>graceful</code></dt>
<dd>Gracefully restarts the Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code> daemon. If the
daemon is not running, it is started. This differs from a normal
restart in that currently open connections are not aborted. A side
effect is that old log files will not be closed immediately. This
means that if used in a log rotation script, a substantial delay may
be necessary to ensure that the old log files are closed before
processing them. This command automatically checks the configuration
files as in <code>configtest</code> before initiating the
restart to make sure Apache doesn't die. This is equivalent to
<code>apachectl -k graceful</code>.</dd>
<dt><code>graceful-stop</code></dt>
<dd>Gracefully stops the Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code> daemon.
This differs from a normal stop in that currently open connections are not
aborted. A side effect is that old log files will not be closed immediately.
This is equivalent to <code>apachectl -k graceful-stop</code>.</dd>
<dt><code>configtest</code></dt>
<dd>Run a configuration file syntax test. It parses the configuration
files and either reports <code>Syntax Ok</code>
or detailed information about the particular syntax error. This is
equivalent to <code>apachectl -t</code>.</dd>
</dl>
<p>The following option was available in earlier versions but has been removed.</p>
<dl>
<dt><code>startssl</code></dt>
<dd>To start <code class="program"><a href="../programs/httpd.html">httpd</a></code> with SSL support, you should edit
your configuration file to include the relevant directives and then
use the normal <code>apachectl start</code>.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/apachectl.html" title="English"> en </a> |
<a href="../fr/programs/apachectl.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apachectl.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apachectl.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/apachectl.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htcacheclean.html.en 0000664 0001751 0001751 00000034344 14737241666 022602 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htcacheclean - Clean up the disk cache - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>htcacheclean - Clean up the disk cache</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/htcacheclean.html" title="English"> en </a> |
<a href="../fr/programs/htcacheclean.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>htcacheclean</code> is used to keep the size of
<code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>'s storage within a given size limit, or
limit on inodes in use. This tool can run either manually or in daemon mode.
When running in daemon mode, it sleeps in the background and checks the cache
directory at regular intervals for cached content to be removed. You can stop
the daemon cleanly by sending it a TERM or INT signal. When run manually, a
once off check of the cache directory is made for cached content to be
removed. If one or more URLs are specified, each URL will be deleted from
the cache, if present.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#delete">Deleting a specific URL</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#list">Listing URLs in the Cache</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">Exit Status</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>htcacheclean</strong>
[ -<strong>D</strong> ]
[ -<strong>v</strong> ]
[ -<strong>t</strong> ]
[ -<strong>r</strong> ]
[ -<strong>n</strong> ]
[ -<strong>R</strong><var>round</var> ]
-<strong>p</strong><var>path</var>
[ -<strong>l</strong><var>limit</var> ]
[ -<strong>L</strong><var>limit</var> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>n</strong> ]
[ -<strong>t</strong> ]
[ -<strong>i</strong> ]
[ -<strong>P</strong><var>pidfile</var> ]
[ -<strong>R</strong><var>round</var> ]
-<strong>d</strong><var>interval</var>
-<strong>p</strong><var>path</var>
[ -<strong>l</strong><var>limit</var> ]
[ -<strong>L</strong><var>limit</var> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>v</strong> ]
[ -<strong>R</strong><var>round</var> ]
-<strong>p</strong><var>path</var>
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>D</strong> ]
[ -<strong>v</strong> ]
[ -<strong>t</strong> ]
[ -<strong>R</strong><var>round</var> ]
-<strong>p</strong><var>path</var>
<var>url</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-d<var>interval</var></code></dt>
<dd>Daemonize and repeat cache cleaning every <var>interval</var> minutes.
This option is mutually exclusive with the <code>-D</code>, <code>-v</code>
and <code>-r</code> options. To shutdown the daemon cleanly, just send it
a <code>SIGTERM</code> or <code>SIGINT</code>.</dd>
<dt><code>-D</code></dt>
<dd>Do a dry run and don't delete anything. This option is mutually
exclusive with the <code>-d</code> option. When doing a dry run and
deleting directories with <code>-t</code>, the inodes reported deleted
in the stats cannot take into account the directories deleted, and will
be marked as an estimate.</dd>
<dt><code>-v</code></dt>
<dd>Be verbose and print statistics. This option is mutually exclusive
with the <code>-d</code> option.</dd>
<dt><code>-r</code></dt>
<dd>Clean thoroughly. This assumes that the Apache web server is
not running (otherwise you may get garbage in the cache). This option
is mutually exclusive with the <code>-d</code> option and implies
the <code>-t</code> option.</dd>
<dt><code>-n</code></dt>
<dd>Be nice. This causes slower processing in favour of other
processes. <code>htcacheclean</code> will sleep from time to time
so that (a) the disk IO will be delayed and (b) the kernel can schedule
other processes in the meantime.</dd>
<dt><code>-t</code></dt>
<dd>Delete all empty directories. By default only cache files are
removed, however with some configurations the large number of
directories created may require attention. If your configuration
requires a very large number of directories, to the point that
inode or file allocation table exhaustion may become an issue, use
of this option is advised.</dd>
<dt><code>-p<var>path</var></code></dt>
<dd>Specify <var>path</var> as the root directory of the disk cache. This
should be the same value as specified with the <code class="directive"><a href="../mod/mod_cache_disk.html#cacheroot">CacheRoot</a></code> directive.</dd>
<dt><code>-P<var>pidfile</var></code></dt>
<dd>Specify <var>pidfile</var> as the name of the file to write the
process ID to when daemonized.</dd>
<dt><code>-R<var>round</var></code></dt>
<dd>Specify <var>round</var> as the amount to round sizes up to, to
compensate for disk block sizes. Set to the block size of the cache
partition.</dd>
<dt><code>-l<var>limit</var></code></dt>
<dd>Specify <var>limit</var> as the total disk cache size limit. The value
is expressed in bytes by default (or attaching <code>B</code> to the
number). Attach <code>K</code> for Kbytes, <code>M</code> for
MBytes or <code>G</code> for Gbytes.</dd>
<dt><code>-L<var>limit</var></code></dt>
<dd>Specify <var>limit</var> as the total disk cache inode limit.
<code>K</code>, <code>M</code> or <code>G</code> suffix can also be
used.</dd>
<dt><code>-i</code></dt>
<dd>Be intelligent and run only when there was a modification of the disk
cache. This option is only possible together with the <code>-d</code>
option.</dd>
<dt><code>-a</code></dt>
<dd>List the URLs currently stored in the cache. Variants of the same URL
will be listed once for each variant.</dd>
<dt><code>-A</code></dt>
<dd>List the URLs currently stored in the cache, along with their
attributes in the following order: url, header size, body size, status,
entity version, date, expiry, request time, response time, body present,
head request.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="delete" id="delete">Deleting a specific URL</a></h2>
<p>If <code>htcacheclean</code> is passed one or more URLs, each URL will
be deleted from the cache. If multiple variants of an URL exists, all
variants would be deleted.</p>
<p>When a reverse proxied URL is to be deleted, the effective URL is
constructed from the <strong>Host</strong> header, the
<strong>port</strong>, the <strong>path</strong> and the
<strong>query</strong>. Note the '?' in the URL must always be specified
explicitly, whether a query string is present or not. For example, an
attempt to delete the path <strong>/</strong> from the server
<strong>localhost</strong>, the URL to delete would be
<strong>http://localhost:80/?</strong>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="list" id="list">Listing URLs in the Cache</a></h2>
<p>By passing the <code>-a</code> or <code>-A</code> options to
<code>htcacheclean</code>, the URLs within the cache will be listed
as they are found, one URL per line. The <code>-A</code> option
dumps the full cache entry after the URL, with fields in the
following order:</p>
<dl>
<dt>url</dt><dd>The URL of the entry.</dd>
<dt>header size</dt><dd>The size of the header in bytes.</dd>
<dt>body size</dt><dd>The size of the body in bytes.</dd>
<dt>status</dt><dd>Status of the cached response.</dd>
<dt>entity version</dt><dd>The number of times this entry has been
revalidated without being deleted.</dd>
<dt>date</dt><dd>Date of the response.</dd>
<dt>expiry</dt><dd>Expiry date of the response.</dd>
<dt>request time</dt><dd>Time of the start of the request.</dd>
<dt>response time</dt><dd>Time of the end of the request.</dd>
<dt>body present</dt><dd>If 0, no body is stored with this request,
1 otherwise.</dd>
<dt>head request</dt><dd>If 1, the entry contains a cached HEAD
request with no body, 0 otherwise.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">Exit Status</a></h2>
<p><code>htcacheclean</code> returns a zero status ("true") if all
operations were successful, <code>1</code> otherwise. If an URL is
specified, and the URL was cached and successfully removed,
<code>0</code> is returned, <code>2</code> otherwise. If an error
occurred during URL removal, <code>1</code> is returned.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/htcacheclean.html" title="English"> en </a> |
<a href="../fr/programs/htcacheclean.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htcacheclean.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/ab.html 0000664 0001751 0001751 00000000552 13710016232 020126 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: ab.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: ab.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: ab.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: ab.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/fcgistarter.html.en 0000664 0001751 0001751 00000015024 14737241666 022507 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>fcgistarter - Start a FastCGI program - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>fcgistarter - Start a FastCGI program</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/fcgistarter.html" title="English"> en </a> |
<a href="../fr/programs/fcgistarter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/fcgistarter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p />
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#note">Note</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></li><li><a href="#comments_section">Comments</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="note" id="note">Note</a></h2>
<p>Currently only works on Unix systems.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>fcgistarter</strong>
-<strong>c</strong> <var>command</var>
-<strong>p</strong> <var>port</var>
[ -<strong>i</strong> <var>interface</var> ]
-<strong>N</strong> <var>num</var>
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-c <var>command</var></code></dt>
<dd>Absolute path of the FastCGI program</dd>
<dt><code>-p <var>port</var></code></dt>
<dd>Port which the program will listen on</dd>
<dt><code>-i <var>interface</var></code></dt>
<dd>Interface which the program will listen on</dd>
<dt><code>-N <var>num</var></code></dt>
<dd>Number of instances of the program</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/fcgistarter.html" title="English"> en </a> |
<a href="../fr/programs/fcgistarter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/fcgistarter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/fcgistarter.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/suexec.html.tr.utf8 0000664 0001751 0001751 00000015722 14743132254 022370 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>suexec - harici programları çalıştırmadan önce kullanıcıyı değiştirir - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>suexec - harici programları çalıştırmadan önce kullanıcıyı değiştirir</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/suexec.html" title="Türkçe"> tr </a></p>
</div>
<p><code><strong>suexec</strong></code>, CGI programlarını çalıştırmadan
önce Apache HTTP Sunucusu tarafından kullanıcı değiştirmek için kullanılır.
Bunu yapabilmek için sunucunun <code>root</code> tarafından çalıştırılmış
olması gerekir. HTTP artalan süreci normalde <code>root</code> aidiyetinde
çalışmadığından <code><strong>suexec</strong></code>'in çalıştırılabilir
dosyasının sahibi <code>root</code> olmalı, setuid biti etkin
(<code>u+s</code>) olmalı ve dosyaya <code>root</code> dışında hiç kimse
yazamamalıdır.</p>
<p><code><strong>suexec</strong></code> güvenlik modeli ve kavramlar
hakkında bilgi edinmek için suexec belgesine (<a href="../suexec.html">http://httpd.apache.org/docs/2.4/suexec.html</a>) bakınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>suexec</strong> -<strong>V</strong></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code><strong>-V</strong></code></dt>
<dd><code>root</code> iseniz, bu seçenek
<code><strong>suexec</strong></code>
derleme seçeneklerini gösterir. Güvenlik sebebiyle tüm yapılandırma
seçenekleri sadece derleme sırasında değiştirilebilir.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/suexec.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/suexec.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/ab.html.tr.utf8 0000664 0001751 0001751 00000050723 14743132254 021456 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ab - Apache HTTP sunucusu başarım ölçme aracı - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>ab - Apache HTTP sunucusu başarım ölçme aracı</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/ab.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/ab.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/ab.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/ab.html" title="Türkçe"> tr </a></p>
</div>
<p><code><strong>ab</strong></code> Apache Hiper Metin Aktarım Protokolü
(HTTP) sunucunuzun başarımını ölçmek amacıyla kullanabileceğiniz bir
kıyaslama aracıdır. Mevcut Apache kurulumunuzun görevini nasıl yerine
getirdiği hakkında bir izlenim edinmeniz için tasarlanmıştır.
Özellikle, Apache kurulumunuzun saniyede kaç isteği sunma yeteneğinde
olduğunu gösterir.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#output">Çıktı</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Börtü böcek</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>ab</strong>
[ -<strong>A</strong> <var>yetkili-kullanıcı:parola</var> ]
[ -<strong>b</strong> <var>tampon-boyu</var> ]
[ -<strong>B</strong> <var>yerel-adres</var> ]
[ -<strong>c</strong> <var>bağlantı-sayısı</var> ]
[ -<strong>C</strong> <var>çerez-ismi=değer</var> ]
[ -<strong>d</strong> ]
[ -<strong>e</strong> <var>csv-dosyası</var> ]
[ -<strong>E</strong> <var>istemci-sertifikası-dosyası</var> ]
[ -<strong>f</strong> <var>protokol</var> ]
[ -<strong>g</strong> <var>gnuplot-dosyası</var> ]
[ -<strong>h</strong> ]
[ -<strong>H</strong> <var>özel-başlık</var> ]
[ -<strong>i</strong> ]
[ -<strong>k</strong> ]
[ -<strong>l</strong> ]
[ -<strong>m</strong> <var>HTTP-yöntemi</var> ]
[ -<strong>n</strong> <var>istek-sayısı</var> ]
[ -<strong>p</strong> <var>POST-dosyası</var> ]
[ -<strong>P</strong> <var>vekil-yetkilisi:parola</var> ]
[ -<strong>q</strong> ]
[ -<strong>r</strong> ]
[ -<strong>s</strong> <var>zamanasimi</var> ]
[ -<strong>S</strong> ]
[ -<strong>t</strong> <var>saniye</var> ]
[ -<strong>T</strong> <var>içerik-türü</var> ]
[ -<strong>u</strong> <var>PUT-dosyası</var> ]
[ -<strong>v</strong> <var>ayrıntı-düzeyi</var>]
[ -<strong>V</strong> ]
[ -<strong>w</strong> ]
[ -<strong>x</strong> <var><table>-öznitelikleri</var> ]
[ -<strong>X</strong> <var>vekil</var>[:<var>port</var>] ]
[ -<strong>y</strong> <var><tr>-öznitelikleri</var> ]
[ -<strong>z</strong> <var><td>-öznitelikleri</var> ]
[ -<strong>Z</strong> <var>şifre-kümesi</var> ]
[http[s]://]<var>konakadı</var>[:<var>port</var>]/<var>dizin</var>
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code><strong>-A</strong>
<var>yetkili-kullanıcı</var>:<var>parola</var></code></dt>
<dd>Sunucuya TEMEL Kimlik Doğrulamada kullanılmak üzere kanıt sağlar.
Kullanıcı adı ile parola arasına sadece <code>:</code> konur ve
sunucunun buna ihtiyacı olup olmadığına bakılmaksızın (yani, bir "401
kimlik doğrulaması gerekli" yanıtı beklenmeden) bağlantı üzerinden
base64 kodlu olarak sunucuya gönderilir.</dd>
<dt><code><strong>-b</strong> <var>tampon-boyu</var></code></dt>
<dd>TCP gönderme/alma tamponlarının bayt cinsinden uzunluğu.</dd>
<dt><code><strong>-B</strong> <var>yerel-adres</var></code></dt>
<dd>Uzak bağlantılar yaparken dinlenecek adres.</dd>
<dt><code><strong>-c</strong> <var>bağlantı-sayısı</var></code></dt>
<dd>Aynı anda işleme sokulacak bağlantı sayısı. Aynı anda bir bağlantı
öntanımlı değerdir.</dd>
<dt><code><strong>-C</strong>
<var>çerez-ismi</var>=<var>değer</var></code></dt>
<dd>İsteğe bir <code>Cookie:</code> satırı ekler. Argüman olarak
genellikle bir <code><var>isim=değer</var></code> çifti kullanılır. Bu
çiftler birden fazla olabilir.</dd>
<dt><code><strong>-d</strong></code></dt>
<dd>"percentage served within XX [ms] table" iletisi gösterilmez. (Geriye
uyumluluk için vardır).</dd>
<dt><code><strong>-e</strong> <var>csv-dosyası</var></code></dt>
<dd>Sunulan isteğin birim zamanda (milisaniye) ne kadarının (yüzde
cinsinden) sunulduğunu gösteren virgül ayraçlı değerler (CSV) dosyası.
Sonuçlar 'bobin haline' getirilmiş olduğundan doğal olarak 'gnuplot'
dosyasından daha yararlıdır.</dd>
<dt><code>-E <var>istemci-sertifikası-dosyası</var></code></dt>
<dd>Bir SSL sitesine bağlanırken, sunucu ile kimlik doğrulaması için
PEM biçeminde sağlanan sertifika kullanılır. Dosyanın sırayla istemci
sertifikasını, ara sertifikaları ve özel anahtarı içermesi beklenir.
2.4.36 ve sonrasında kullanılabilir.</dd>
<dt><code><strong>-f</strong> <var>protokol</var></code></dt>
<dd>SSL/TLS protokolü belirtilir (SSL2, SSL3, TLS1, TLS1.1, TLS1.2 veya
ALL). TLS1.1 ve TLS1.2 desteği 2.4.4 ve sonraki sürümler
içindir.</dd>
<dt><code><strong>-g</strong> <var>gnuplot-dosyası</var></code></dt>
<dd>Ölçülen değerler bir 'gnuplot' veya TSV (sekme ayraçlı değerler)
dosyasına yazılır. Bu dosya, Gnuplot, IDL, Mathematica, Igor hatta
Excel tarafından veri dosyası olarak kabul edilir. Veri sütunlarının
başlıkları dosyanın ilk satırında bulunur. </dd>
<dt><code><strong>-h</strong></code></dt>
<dd>Kullanım bilgisi gösterir.</dd>
<dt><code><strong>-H</strong> <var>özel-başlık</var></code></dt>
<dd>İsteğe fazladan başlık ekler. <var>özel-başlık</var>, aralarında iki
nokta imi bulunan bir isim-değer çifti olarak belirtilir. Örnek:
<code>"Accept-Encoding: zip/zop;8bit"</code></dd>
<dt><code><strong>-i</strong></code></dt>
<dd><code>GET</code> istekleri yerine <code>HEAD</code> istekleri
yapılır.</dd>
<dt><code><strong>-k</strong></code></dt>
<dd>HTTP KeepAlive (kalıcı bağlantı) özelliğini etkinleştirir, yani tek
bir oturum içinde çok sayıda isteğe hizmet sunulabilir. Özellik
öntanımlı olarak kapalıdır.</dd>
<dt><code><strong>-l</strong></code></dt>
<dd>Yanıtarın uzunluğu sabit değilse hataları raporlamaz. Özdevinimli
sayfalarda kullanışlı olabilir. 2.4.7 ve sonraki sürümler
içindir.</dd>
<dt><code><strong>-m</strong> <var>HTTP-yöntemi</var></code></dt>
<dd>İstekler için özel HTTP yöntemi, belirtilir.
2.4.10 ve sonraki sürümler içindir.</dd>
<dt><code><strong>-n</strong> <var>istek-sayısı</var></code></dt>
<dd>Kıyaslama oturumu sırasında sunucuya uygulanacak istek sayısı.
Öntanımlı olarak hiçbir başarım ölçütü sağlamayan tek bir istek
yapılır.</dd>
<dt><code><strong>-p</strong> <var>POST-dosyası</var></code></dt>
<dd>POST isteği ile ilgili verileri içeren dosya. Ayrıca
<code><strong>-T</strong></code> seçeneğini de belirtmeyi
unutmayın..</dd>
<dt><code><strong>-P</strong>
<var>vekil-yetkilisi</var>:<var>parola</var></code></dt>
<dd>Vekil sunucuya TEMEL Kimlik Doğrulamasında kullanılacak kanıtları
sağlar. Kullanıcı adı ile parola arasına sadece <code>:</code> konur ve
vekilin buna ihtiyacı olup olmadığına bakılmaksızın (yani, bir "407
vekilde kimlik doğrulaması gerekiyor" yanıtı beklenmeden) bağlantı
üzerinden base64 kodlu olarak sunucuya gönderilir.</dd>
<dt><code><strong>-q</strong></code></dt>
<dd>İstek sayısı 150'den fazla olduğunda,
<code><strong>ab</strong></code> her 100 veya %10 istekte bir, standart
hataya bir işlenen istek sayacı çıktılar.
<code><strong>-q</strong></code> seçeneği bu çıktının üretilmemesini
sağlar.</dd>
<dt><code><strong>-r</strong></code></dt>
<dd>Soket hata alsa bile program çıkmaz.</dd>
<dt><code><strong>-s</strong> <var>zamanasimi</var></code></dt>
<dd>Soket zaman aşımına uğramadan önce beklenecek azami saniye sayısı.
30 saniye öntanımlı süredir.
2.4.4 ve sonraki sürümler içindir.</dd>
<dt><code><strong>-S</strong></code></dt>
<dd>Ortalama ve ortanca değerler arasında bir veya iki standart sapmadan
fazlası varsa ne ortalama değer ne standart sapma değeri ne de
uyarı/hata iletileri gösterilir. Öntanımlı olarak,
asgari/ortalama/azami değerler gösterilir. (Geriye uyumluluk).</dd>
<dt><code><strong>-t</strong> <var>saniye</var></code></dt>
<dd>Ölçümleme işleminin ne kadar süreyle uygulanacağı belirtilir. Dahili
olarak <code><strong>-n 50000</strong></code> seçeneği uygulanır. Bunu
belli bir süreye göre kıyaslama yapmak amacıyla kullanabilirsiniz.
Öntanımlı olarak bir süre kısıtlaması yoktur.</dd>
<dt><code><strong>-T</strong> <var>içerik-türü</var></code></dt>
<dd>POST/PUT verisi için kullanılacak içerik türü belirtilir. Örnek:
<code>application/x-www-form-urlencoded</code>.
Öntanımlı değer: <code>text/plain</code>.</dd>
<dt><code><strong>-v</strong> <var>ayrıntı-düzeyi</var></code></dt>
<dd>Çıktının ayrıntı düzeyi belirtilir. <code>4</code> ve üstü ile
başlıklar hakkında bilgi, <code>3</code> ve üstü ile yanıt kodları
(404, 200, vb.), <code>2</code> ve üstü ile ise uyarı ve bilgi
iletileri gösterilir.</dd>
<dt><code>-u <var>PUT-dosyası</var></code></dt>
<dd>PUT verisini içeren dosya. Ayrıca, <code>-T</code> seçeneğini
belirtmeyi de unutmayın.</dd>
<dt><code><strong>-V</strong></code></dt>
<dd>Sürüm bilgilerini gösterir ve çıkar.</dd>
<dt><code><strong>-w</strong></code></dt>
<dd>Sonuçları HTML tabloları olarak basar. Öntanımlı tablo, beyaz
artalanlı ve iki sütunludur.</dd>
<dt><code><strong>-x</strong>
<var><table>-öznitelikleri</var></code></dt>
<dd><code><table></code> etiketinde kullanılacak öznitelikler
belirtilir. Belirtilen öznitelikler etiket içine <code><table
<var>buraya</var> ></code> biçeminde yerleştirilir.</dd>
<dt><code><strong>-X</strong>
<var>vekil</var>[:<var>port</var>]</code></dt>
<dd>İstekler için bir vekil sunucu kullanılır.</dd>
<dt><code><strong>-y</strong>
<var><tr>-öznitelikleri</var></code></dt>
<dd><code><tr></code> etiketinde kullanılacak öznitelikler
belirtilir.</dd>
<dt><code><strong>-z</strong>
<var><td>-öznitelikleri</var></code></dt>
<dd><code><td></code> etiketinde kullanılacak öznitelikler
belirtilir.</dd>
<dt><code>-Z <var>şifre-kümesi</var></code></dt>
<dd>SSL/TLS şifre kümesi belirtilir
(<code><strong>openssl</strong></code>(1) şifrelerine bakınız).</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="output" id="output">Çıktı</a></h2>
<p>Aşağıda <code><strong>ab</strong></code> tarafından döndürülen değerler
açıklanmıştır:</p>
<dl>
<dt>Server Software</dt>
<dd>İlk başarılı yanıtın, varsa, <var>server</var> HTTP başlığında
döndürülen değer. Bu başlıktaki başlangıçtan 32 ondalık değerli
karaktere (genellikle boşluk veya CR/LF karakteri) kadar tüm
karakterleri içerir.</dd>
<dt>Server Hostname</dt>
<dd>Komut satırında belirtilen DNS veya IP adresi.</dd>
<dt>Server Port</dt>
<dd><code><strong>ab</strong></code>'nin bağlandığı port. Komut
satırında port belirtilmemişse, öntanımlı olarak http için 80, https
için 443'tür.</dd>
<dt>SSL/TLS Protocol</dt>
<dd>İstemci le sunucu arasında uzlaşılmış protokol değerleri. Bu sadece
SSL kullanılıyorsa çıktılanır.</dd>
<dt>Document Path</dt>
<dd>Komut satırı dizgesinden çözümlenen isteğin URI'si.</dd>
<dt>Document Length</dt>
<dd>Başarıyla döndürülen ilk belgenin bayt cinsinden uzunluğu. Eğer
belge uzunluğu sınama sırasında değişirse yanıt bir hata
içerecektir.</dd>
<dt>Concurrency Level</dt>
<dd>Sınama sırasında kullanılan eşzamanlı istemcilerin sayısı.</dd>
<dt>Time taken for tests</dt>
<dd>İlk soket bağlantısının alındığı andan son yanıtın alındığı ana
kadar geçen süre.</dd>
<dt>Complete requests</dt>
<dd>Alınan başarılı yanıtların sayısı.</dd>
<dt>Failed requests</dt>
<dd>Başarısızlık olarak addedilen isteklerin sayısı. Sayı sıfırdan
büyükse, diğer satırda, bağlanma, okuma, yanlış içerik uzunluğu,
istisnalar gibi sebeplerle başarısız olmuş istekler gösterilir.</dd>
<dt>Write errors</dt>
<dd>Başarısız yazma hatalarının (kırık boru) sayısı.</dd>
<dt>Non-2xx responses</dt>
<dd>200 serisi yanıt kodları ile açıklanamayan yanıtların sayısı. Tüm
yanıtlar 200 olursa bu alan çıktılanmaz.</dd>
<dt>Keep-Alive requests</dt>
<dd>Keep-Alive isteklerinde sonuçlanan bağlantı sayısı.</dd>
<dt>Total body sent</dt>
<dd>Sınamanın parçası olarak veri gönderimi yapılandırılmışsa, bu
sınama sırasında gönderilen toplam bayt sayısıdır. Sınama sırasında
gövde gönderilmiyorsa bu alan çıktılanmaz.</dd>
<dt>Total transferred</dt>
<dd>Sunucudan alınan toplam bayt sayısı. Bu sayı aslında hattan
gönderilen bayt sayısıdır.</dd>
<dt>HTML transferred</dt>
<dd>Sunucudan alınan belge baytlarının sayısı. Bu sayı HTTP
başlıklarının bayt sayısını içermez.</dd>
<dt>Requests per second</dt>
<dd>Saniyedeki istek sayısı. İstek sayısının toplam süreye
oranıdır.</dd>
<dt>Time per request</dt>
<dd>İstek başına harcanan süre. İlk değer <code>eşzamanlılık * süre *
1000 / biten</code> formülüyle hesaplanırken ikincisi için
<code>süre * 1000 / biten</code> formülü kullanılır.</dd>
<dt>Transfer rate</dt>
<dd><code>okunantoplam / 1024 / süre</code> formülüyle hesaplanan
aktarım hızı.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="bugs" id="bugs">Börtü böcek</a></h2>
<p>Duruk bildirimli sabit uzunlukta çeşitli tamponlar vardır.
Sunucudan gelen yanıt başlıkları ve diğer harici girdiler, komut satırı
argümanları ile birlikte basitçe çözümlenir, bu size can sıkıcı
gelebilir.</p>
<p>HTTP/1.x protokolünü tamamen gerçeklemez; sadece yanıtların 'belli
başlı' bazı biçimlerini kabul eder. Aksi takdirde,
<code><strong>strstr</strong></code>(3) işlevinin yoğun kullanımı
nedeniyle sunucu yerine <code><strong>ab</strong></code>'nin başarımını
ölçerdiniz.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/ab.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/ab.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/ab.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/ab.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/ab.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/apxs.html.tr.utf8 0000664 0001751 0001751 00000053524 14743132254 022051 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>apxs - Apache Eklenti Aracı - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>apxs - Apache Eklenti Aracı</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/apxs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apxs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apxs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apxs.html" title="Türkçe"> tr </a></p>
</div>
<p><code><strong>apxs</strong></code>, Apache Hiper Metin Aktarım
Protokolü (HTTP) sunucusu için ek modül derleme ve kurulum aracıdır. Bu
araç sayesinde, bir veya daha fazla kaynak veya nesne
<var>dosya</var>sından bir devingen paylaşımlı nesne (DSO - "Dynamic
Shared Object" kısaltması) derlemek ve bu nesneyi (modülü) Apache
sunucusuna çalışma anında <strong><code class="module"><a href="../mod/mod_so.html">mod_so</a></code></strong>
modülünün <strong><code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code></strong> yönergesi üzerinden yüklemek mümkün
olmaktadır.</p>
<p>Bu eklenti mekanizmasını platformunuzda kullanmak için DSO desteğinin
olması ve <strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong> programının
<strong><code class="module"><a href="../mod/mod_so.html">mod_so</a></code></strong> modülünü içerecek şekilde
derlenmiş olması gerekir. Eğer bunlar mevcut değilse
<strong><code>apxs</code></strong> aracı durumu size bildirecektir. Bunu
aşağıdaki komutla kendiniz de sınayabilirsiniz:</p>
<div class="example"><p><code>
$ httpd -l
</code></p></div>
<p><strong><code class="module"><a href="../mod/mod_so.html">mod_so</a></code></strong> modülü gösterilen listede yer
almalıdır. Bu gereksinimler sağlandığı takdirde
<strong><code>apxs</code></strong> aracı sayesinde DSO mekanizması
üzerinden kendi modüllerinizi kurmak suretiyle Apache sunucunuzun
işlevselliğini kolayca arttırabilirsiniz. Örnek bir uygulama:</p>
<div class="example"><p><code>
$ apxs -i -a -c mod_foo.c<br />
gcc -fpic -DSHARED_MODULE -I/dosya/yolu/apache/include -c mod_foo.c<br />
ld -Bshareable -o mod_foo.so mod_foo.o<br />
cp mod_foo.so /dosya/yolu/apache/modules/mod_foo.so<br />
chmod 755 /dosya/yolu/apache/modules/mod_foo.so<br />
[`foo' modülü /dosya/yolu/apache/etc/httpd.conf'ta etkinleştiriliyor]<br />
$ apachectl restart<br />
/dosya/yolu/apache/sbin/apachectl restart: httpd not running, trying to start<br />
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
/dosya/yolu/apache/sbin/apachectl restart: httpd started<br />
$ _
</code></p></div>
<p><var>dosya</var> olarak bir C kaynak dosyası (.c), bir nesne dosyası
(.o) ve hatta bir kütüphane arşivi archive (.a) belirtebilirsiniz.
<strong><code>apxs</code></strong> aracı bu dosya uzantılarını
tanıdığından C dosyalarını derleme işleminden, arşiv ve nesne
dosyalarını ise doğrudan ilintileme işleminden geçirir. Fakat böyle
önceden derlenmiş nesne dosyalarını kullanırken, devingen paylaşımlı
nesne olarak kullanılmalarını sağlamak üzere konumdan bağımsız kod (PIC)
üretecek şekilde derlenmiş olduklarından emin olmalısınız. Örneğin
GCC'yi bunun için daima <strong><code>-fpic</code></strong> seçeneği ile
kullanmalısınız. Diğer C derleyiciler için,
<strong><code>apxs</code></strong>'in nesne dosyalarını derlerken
kullanacağı seçenekleri öğrenmek için o derleyicilerin kılavuz
sayfalarına bakınız.</p>
<p>Apache'deki DSO desteği ile ilgili daha ayrıntılı bilgi edinmek için
<strong><code class="module"><a href="../mod/mod_so.html">mod_so</a></code></strong> belgesini okumakla yetinmeyip
<code>src/modules/standard/mod_so.c</code> kaynak dosyasını da
okuyunuz.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Örnekler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>apxs</strong> -<strong>g</strong>
[ -<strong>S</strong> <var>isim=değer</var> ]
-<strong>n</strong> <var>modüladı</var></code></p>
<p><code><strong>apxs</strong> -<strong>q</strong>
[ -<strong>v</strong> ]
[ -<strong>S</strong> <var>isim=değer</var> ]
<var>sorgu</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>c</strong>
[ -<strong>S</strong> <var>isim=değer</var> ]
[ -<strong>o</strong> <var>dso-dosyası</var> ]
[ -<strong>I</strong> <var>include-dizini</var> ]
[ -<strong>D</strong> <var>isim=değer</var> ]
[ -<strong>L</strong> <var>lib-dizini</var> ]
[ -<strong>l</strong> <var>kütüphane-adı</var> ]
[ -<strong>Wc,</strong><var>derleyici-seçenekleri</var> ]
[ -<strong>Wl,</strong><var>ilintileyici-seçenekleri</var> ]
[ -<strong>p</strong> ]
<var>dosya</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>i</strong>
[ -<strong>S</strong> <var>isim=değer</var> ]
[ -<strong>n</strong> <var>modüladı</var> ]
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]
<var>dso-dosyası</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>e</strong>
[ -<strong>S</strong> <var>isim=değer</var> ]
[ -<strong>n</strong> <var>modüladı</var> ]
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]
<var>dso-dosyası</var> ...</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<h3><a name="options.common" id="options.common">Ortak Seçenekler</a></h3>
<dl>
<dt><code><strong>-n</strong> <var>modüladı</var></code></dt>
<dd><code><strong>-i</strong></code> (kurulum) ve
<code><strong>-g</strong></code> (şablon üretimi)
seçenekleri için modül ismi belirtmek amacıyla kullanılır. Bir modül
ismi belirtmek için bu seçeneği kullanın.
<code><strong>-g</strong></code> seçeneği için bu gereklidir.
<code><strong>-i</strong></code> seçeneği için ise araç, modül
ismini kaynağın ismine bakarak veya (son çare olarak) dosya isminden
tahmin etmeye çalışarak saptamaya çalışır.</dd>
</dl>
<h3><a name="options.query" id="options.query">Sorgu Seçenekleri</a></h3>
<dl>
<dt><code><strong>-q</strong> <var>sorgu</var></code></dt>
<dd><code>httpd</code>'yi derlemekte kullanılacak değişkenler ve
ortam ayarları için bir sorgu gerçekleştirir. When invoked without
<code><var>sorgu</var></code> belirtilmeksizin çağrıldığında, bilinen
değişkenleri değerleriyle birlikte basar. İsteğe bağlı
<code><strong>-v</strong></code> seçeneği liste çıktısını biçemler.
<p>Modülünüzü yükleyecek <code><strong>httpd</strong></code>'yi
derlemek için kullanılacak ayarları elle belirtmek için kullanılır.
Örneğin, Apache'nin C başlık dosyalarının yerini kendi Makefile
dosyalarınızın içinde şöyle belirtebilirsiniz:</p>
<div class="example"><p><code>
INC=-I`apxs -q INCLUDEDIR`
</code></p></div></dd>
</dl>
<h3><a name="options.conf" id="options.conf">Yapılandırma Seçenekleri</a></h3>
<dl>
<dt><code><strong>-S</strong> <var>isim=değer</var></code></dt>
<dd>Bu seçenek yukarıda açıklanan <code><strong>apxs</strong></code>
ayarlarını değiştirir.</dd>
</dl>
<h3><a name="options.template" id="options.template">Şablon Üretme Seçenekleri</a></h3>
<dl>
<dt><code><strong>-g</strong></code></dt>
<dd><code><var>modüladı</var></code> (<strong><code>-n</code></strong>
seçeneğine bakınız) adında bir alt dizin oluşturur ve içine iki dosya
yerleştirir: Kendi modülünüzü oluşturabilmeniz için veya
<code><strong>apxs</strong></code> mekanizmaları ile hemen oynamaya
başlayabilmeniz için <code>mod_<var>modüladı</var>.c</code> adında bir
modül kaynak dosyası örneği ve bu modülü derleyip kurmayı
kolaylaştırmak için bir <code>Makefile</code> dosyası.</dd>
</dl>
<h3><a name="options.dso" id="options.dso">DSO Derleme Seçenekleri</a></h3>
<dl>
<dt><code><strong>-c</strong></code></dt>
<dd>Bu seçenek derleme yapılacağını belirtir. Önce belirtilen C kaynak
<var>dosyalar</var>ını (.c), nesne dosyalarını (.o) elde etmek için
derler. Sonra bunları kalan nesne dosyaları (.o ve .a) ile
ilintileyerek <var>dso-dosyası</var> adında bir devingen paylaşımlı
nesne oluşturur. Eğer <strong><code>-o</code></strong> seçeneği ile
modül ismi belirtilmemişse <var>dosyalar</var> arasındaki ilk dosyanın
ismine bakarak dosya ismi tahmin edilmeye çalışılır ve
<code>mod_<var>isim</var>.so</code> dosya adı bu isimden elde
edilir.</dd>
<dt><code><strong>-o</strong> <var>dso-dosyası</var></code></dt>
<dd>Oluşturulacak devingen paylaşımlı nesnenin ismini belirtmek için
kullanılır. Modül ismi bu seçenekle belirtilmez ve <var>dosya</var>
listesinden bir isim tahmini de yapılamazsa son çare olarak
<code>mod_unknown.so</code> ismi kullanılır.</dd>
<dt><code><strong>-D</strong> <var>isim=değer</var></code></dt>
<dd>Bu seçenek doğrudan derleme komutlarına aktarılır. Bu seçeneği
derleme işlemine kendi tanımlarınızı belirtmek için kullanın.</dd>
<dt><code><strong>-I</strong> <var>include-dizini</var></code></dt>
<dd>Bu seçenek doğrudan derleme komutlarına aktarılır. Bu seçeneği
derleme işleminde kullanılmak üzere kendi başlık dosyalarınızı içeren
dizinleri arama yollarına eklemek için kullanın.</dd>
<dt><code><strong>-L</strong> <var>lib-dizini</var></code></dt>
<dd>Bu seçenek doğrudan derleme komutlarına aktarılır. Bu seçeneği
derleme işleminde kullanılmak üzere kendi kütüphane dizinlerinizi
arama yollarına eklemek için kullanın.</dd>
<dt><code><strong>-l</strong> <var>kütüphane-adı</var></code></dt>
<dd>Bu seçenek doğrudan derleme komutlarına aktarılır. Bu seçeneği
derleme işleminde kullanılmak üzere kendi kütüphanelerinizi arama
yollarına eklemek için kullanın.</dd>
<dt><code><strong>-Wc</strong>,<var>derleyici-seçenekleri</var></code></dt>
<dd>Bu seçenek <code>libtool --mode=compile</code> komutuna doğrudan
seçenek aktarmak için kullanılır. Bu seçeneği yerel derleyiciniz için
gereken ek seçenekleri belirtmek için kullanın.</dd>
<dt><code><strong>-Wl</strong>,<var>ilintileyici-seçenekleri</var></code></dt>
<dd>Bu seçenek <code>libtool --mode=link</code> komutuna doğrudan
seçenek aktarmak için kullanılır. Bu seçeneği yerel ilintileyiciniz
için gereken ek seçenekleri belirtmek için kullanın.</dd>
<dt><code><strong>-p</strong></code></dt>
<dd>Bu seçenek apxs'in apr/apr-util kütüphaneleriyle ilintilenmesini
sağlar. apr/apr-util kütüphanelerini kullanan yardımcı uygulamaları
derlerken yararlıdır.</dd>
</dl>
<h3><a name="options.dsoinstall" id="options.dsoinstall">DSO Kurulum ve Yapılandırma Seçenekleri</a></h3>
<dl>
<dt><code><strong>-i</strong></code></dt>
<dd>Kurulum işlemini belirtir ve devingen olarak paylaşımlı nesneleri
sunucunun <var>modules</var> dizinine kurar.</dd>
<dt><code><strong>-a</strong></code></dt>
<dd>İlgili <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> satırını
Apache'nin <code>httpd.conf</code> yapılandırma dosyasına özdevinimli
olarak ekleyerek veya böyle bir satır varsa bunu etkin kılarak modülü
etkinleştirir.</dd>
<dt><code><strong>-A</strong></code></dt>
<dd><strong><code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code></strong>
yönergesini daha sonra etkinleştirmek üzere satırın başına bir diyez
imi (<code>#</code>) yerleştirmesi dışında
<strong><code>-a</code></strong> seçeneği ile aynıdır.</dd>
<dt><code><strong>-e</strong></code></dt>
<dd>Modülü kurmaya çalışmaksızın Apache'nin <code>httpd.conf</code>
yapılandırma dosyasını <strong><code>-i</code></strong> işlemine
benzer şekilde <strong><code>-a</code></strong> ve
<strong><code>-A</code></strong> seçenekleri ile düzenleme işlemini
belirtir.</dd>
</dl>
</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">Örnekler</a></h2>
<p>Apache'nin sunucu işlevselliğini genişletmek amacıyla kullanacağınız
<code>mod_foo.c</code> adında bir Apache modülünüz olduğunu varsayalım.
Öncelikle, C kaynak dosyasını, Apache sunucusuna çalışma anında
yüklenmeye uygun bir paylaşımlı nesne olarak derlemeniz gerekir. Bunu
sağlamak için şu komutları vermelisiniz:</p>
<div class="example"><p><code>
$ apxs -c mod_foo.c<br />
/dosya/yolu/libtool --mode=compile gcc ... -c mod_foo.c<br />
/dosya/yolu/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
$ _
</code></p></div>
<p>Bundan sonra, Apache yapılandırmanızın bu paylaşımlı nesneyi yüklemek
için bir <strong><code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code></strong> yönergesi içermesini
sağlamalısınız. <strong><code>apxs</code></strong> bu adımı
basitleştirmek amacıyla, paylaşımlı nesneyi sunucunun <var>modules</var>
dizinine özdevinimli olarak kurmak ve <code>httpd.conf</code> dosyasını
buna uygun olarak güncellemek için bir yol sağlar. Bu sonuç şöyle elde
edilebilir:</p>
<div class="example"><p><code>
$ apxs -i -a mod_foo.la<br />
/dosya/yolu/instdso.sh mod_foo.la /path/to/apache/modules<br />
/dosya/yolu/libtool --mode=install cp mod_foo.la /dosya/yolu/apache/modules
...
chmod 755 /dosya/yolu/apache/modules/mod_foo.so<br />
[`foo' modülü /dosya/yolu/apache/conf/httpd.conf'da etkinleştiriliyor] <br />
$ _
</code></p></div>
<p>Yapılandıma dosyasına (eğer yoksa) şu satır eklenir:</p>
<div class="example"><p><code>
LoadModule foo_module modules/mod_foo.so
</code></p></div>
<p>Bunu öntanımlı olarak iptal etmek isterseniz
<strong><code>-A</code></strong> seçeneğini kullanmanız gerekir:</p>
<div class="example"><p><code>
$ apxs -i -A mod_foo.c
</code></p></div>
<p><strong><code>apxs</code></strong> mekanizmalarını hızlıca denemek
için örnek bir Apache modül şablonunu ve bir Makefile dosyasını şöyle
oluşturabilirsiniz:</p>
<div class="example"><p><code>
$ apxs -g -n foo<br />
Creating [DIR] foo<br />
Creating [FILE] foo/Makefile<br />
Creating [FILE] foo/modules.mk<br />
Creating [FILE] foo/mod_foo.c<br />
Creating [FILE] foo/.deps<br />
$ _
</code></p></div>
<p>Ardından bu örnek modülü bir paylaşımlı nesne olarak derleyip Apache
sunucusuna yükleyebilirsiniz:</p>
<div class="example"><p><code>
$ cd foo<br />
$ make all reload<br />
apxs -c mod_foo.c<br />
/dosya/yolu/libtool --mode=compile gcc ... -c mod_foo.c<br />
/dosya/yolu/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
apxs -i -a -n "foo" mod_foo.la<br />
/dosya/yolu/instdso.sh mod_foo.la /dosya/yolu/apache/modules<br />
/dosya/yolu/libtool --mode=install cp mod_foo.la /dosya/yolu/apache/modules
...
chmod 755 /dosya/yolu/apache/modules/mod_foo.so<br />
[`foo' modülü /dosya/yolu/apache/conf/httpd.conf'ta etkinleştiriliyor]<br />
apachectl restart<br />
/dosya/yolu/apache/sbin/apachectl restart: httpd not running, trying to start<br />
chmod 755 /dosya/yolu/apache/modules/mod_foo.so<br />
[`foo' modülü /dosya/yolu/apache/etc/httpd.conf'ta etkinleştiriliyor]<br />
apachectl restart<br />
/dosya/yolu/apache/sbin/apachectl restart: httpd not running, trying to start<br />
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
/dosya/yolu/apache/sbin/apachectl restart: httpd started<br />
$ _
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/apxs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apxs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apxs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apxs.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/apxs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/apxs.html.ko.euc-kr 0000664 0001751 0001751 00000043043 14743132254 022330 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>apxs - APache eXtenSion - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>apxs - APache eXtenSion </h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/apxs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apxs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apxs.html" title="Korean"> ko </a> |
<a href="../tr/programs/apxs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>apxs</code> ġ ؽƮ
(HTTP) Ȯ ϰ ġϴ ̴.
ҽ Ʈ<var></var> ,
<code class="module"><a href="../mod/mod_so.html">mod_so</a></code> <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> þ ߿
ġ о ִ ü(DSO) .</p>
<p> ̷ Ȯ Ϸ ÷ DSO
ϰ ġ <code>httpd</code>
<code class="module"><a href="../mod/mod_so.html">mod_so</a></code> ؾ Ѵ.
<code>apxs</code>
ʴ´. ɾ Ͽ ϴ ˾ƺ
ִ</p>
<div class="example"><p><code>
$ httpd -l
</code></p></div>
<p>Ͽ <code class="module"><a href="../mod/mod_so.html">mod_so</a></code> ; Ѵ.
ϸ <code>apxs</code> DSO ġϿ
ġ Ȯ ִ:</p>
<div class="example"><p><code>
$ apxs -i -a -c mod_foo.c<br />
gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo.c<br />
ld -Bshareable -o mod_foo.so mod_foo.o<br />
cp mod_foo.so /path/to/apache/modules/mod_foo.so<br />
chmod 755 /path/to/apache/modules/mod_foo.so<br />
[activating module `foo' in /path/to/apache/etc/httpd.conf]<br />
$ apachectl restart<br />
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start<br />
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
/path/to/apache/sbin/apachectl restart: httpd started<br />
$ _
</code></p></div>
<p>ƱԸƮ <var>files</var> C ҽ (.c) ̳
Ʈ (.o), ̺귯 (.a) ִ.
<code>apxs</code> Ȯڸ ڵ C ҽ
ϰ, Ʈ ũ Ѵ.
Ʈ Ϸ о ִ
ü ϱ ݵ Ʈ ġڵ(PIC,
position independent code) ؾ Ѵ. GCC
<code>-fpic</code> ϸ ȴ. ٸ C Ϸ
ϰų <code>apxs</code> Ʈ Ҷ
ϴ ɼ ϶.</p>
<p>ġ DSO ڼ
<code class="module"><a href="../mod/mod_so.html">mod_so</a></code> ϰų
<code>src/modules/standard/mod_so.c</code> ҽ о.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples"></a></li>
</ul><h3></h3><ul class="seealso"><li><a href="apachectl.html">apachectl</a></li><li><a href="httpd.html">httpd</a></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p><code><strong>apxs</strong> -<strong>g</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
-<strong>n</strong> <var>modname</var></code></p>
<p><code><strong>apxs</strong> -<strong>q</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
<var>query</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>c</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
[ -<strong>o</strong> <var>dsofile</var> ]
[ -<strong>I</strong> <var>incdir</var> ]
[ -<strong>D</strong> <var>name</var>=<var>value</var> ]
[ -<strong>L</strong> <var>libdir</var> ]
[ -<strong>l</strong> <var>libname</var> ]
[ -<strong>Wc,</strong><var>compiler-flags</var> ]
[ -<strong>Wl,</strong><var>linker-flags</var> ]
<var>files</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>i</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
[ -<strong>n</strong> <var>modname</var> ]
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]
<var>dso-file</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>e</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
[ -<strong>n</strong> <var>modname</var> ]
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]
<var>dso-file</var> ...</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<h3><a name="options.common" id="options.common"> ɼ</a></h3>
<dl>
<dt><code>-n <var>modname</var></code></dt>
<dd><code>-i</code> (install) <code>-g</code> (template
generation) ɼ Ҷ Ѵ.
ɼ Ͽ Ѵ. <code>-g</code>
ɼ Ѵٸ ɼ ݵ ؾϰ,
<code>-i</code> ɼ Ѵٸ <code>apxs</code>
ҽ ( õ) ϸ ̸ Ѵ.</dd>
</dl>
<h3><a name="options.query" id="options.query"> ɼ</a></h3>
<dl>
<dt><code>-q</code></dt>
<dd><code>apxs</code> ˾Ƴ. <var>query</var>
ִ: <code>CC</code>, <code>CFLAGS</code>,
<code>CFLAGS_SHLIB</code>, <code>INCLUDEDIR</code>,
<code>LD_SHLIB</code>, <code>LDFLAGS_SHLIB</code>,
<code>LIBEXECDIR</code>, <code>LIBS_SHLIB</code>,
<code>SBINDIR</code>, <code>SYSCONFDIR</code>, <code>TARGET</code>.
<p> ˾Ƴ Ѵ.</p>
<div class="example"><p><code>
INC=-I`apxs -q INCLUDEDIR`
</code></p></div>
<p> , ġ C Ѵٸ
Makefile Ѵ.</p></dd>
</dl>
<h3><a name="options.conf" id="options.conf"> ɼ</a></h3>
<dl>
<dt><code>-S <var>name</var>=<var>value</var></code></dt>
<dd> ɼ apxs Ѵ.</dd>
</dl>
<h3><a name="options.template" id="options.template">ߺ(template) ɼ</a></h3>
<dl>
<dt><code>-g</code></dt>
<dd>丮 <var>name</var> (<code>-n</code>
ɼ ) װ ΰ :
<code>mod_<var>name</var>.c</code> ߺ ҽϷ,
ڽ 鶧 ߺ ϰų apxs
غ Ѵ. ٸ ϰ
ġϱ <code>Makefile</code>̴.</dd>
</dl>
<h3><a name="options.dso" id="options.dso">DSO ɼ</a></h3>
<dl>
<dt><code>-c</code></dt>
<dd> Ѵ. <var>files</var> C
ҽϵ(.c) Ʈ(.o) ϰ,
<var>files</var> Ʈϵ(.o .a)
ũϿ ü <var>dsofile</var> .
<code>-o</code> ɼ <var>files</var>
ù° ϸ ̸ Ͽ
<code>mod_<var>name</var>.so</code> Ѵ.</dd>
<dt><code>-o <var>dsofile</var></code></dt>
<dd> ü ϸ Ѵ. ̸
ʰ <var>files</var> Ͽ ̸
ϸ <code>mod_unknown.so</code> ̸
Ѵ.</dd>
<dt><code>-D <var>name</var>=<var>value</var></code></dt>
<dd> ɼ ɾ Ѵ.
϶ ڽ define ߰Ѵ.</dd>
<dt><code>-I <var>incdir</var></code></dt>
<dd> ɼ ɾ Ѵ.
϶ include ã 丮 ߰Ѵ.</dd>
<dt><code>-L <var>libdir</var></code></dt>
<dd> ɼ Ŀ ɾ Ѵ.
϶ ̺귯 ã 丮 ߰Ѵ.</dd>
<dt><code>-l <var>libname</var></code></dt>
<dd> ɼ Ŀ ɾ Ѵ.
϶ ̺귯 ߰Ѵ.</dd>
<dt><code>-Wc,<var>compiler-flags</var></code></dt>
<dd> ɼ ߰ ɼ <var>compiler-flags</var>
<code>libtool --mode=compile</code> ɾ Ѵ.
Ϸ Ư ɼ ߰Ҷ Ѵ.</dd>
<dt><code>-Wl,<var>linker-flags</var></code></dt>
<dd> ɼ ߰ ɼ <var>linker-flags</var>
<code>libtool --mode=link</code> ɾ Ѵ. Ŀ
Ư ɼ ߰Ҷ Ѵ.</dd>
</dl>
<h3><a name="options.dsoinstall" id="options.dsoinstall">DSO ġ ɼ</a></h3>
<dl>
<dt><code>-i</code></dt>
<dd>ġ Ѵ. ü
<var>modules</var> 丮 ġѴ.</dd>
<dt><code>-a</code></dt>
<dd>ġ <code>httpd.conf</code> Ͽ
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>
߰ϰų ̹ ִٸ ȰȭϿ ϵ
.</dd>
<dt><code>-A</code></dt>
<dd><code>-a</code> , <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> þ տ
칰(<code>#</code>) δ. <em></em>,
߿ ֵ غѴ.</dd>
<dt><code>-e</code></dt>
<dd> Ѵ. <code>-a</code> Ȥ <code>-A</code>
ɼǰ , <code>-i</code> ɰ
ġʰ ġ
<code>httpd.conf</code> ϸ Ѵ.</dd>
</dl>
</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>
<p>ġ Ȯϴ <code>mod_foo.c</code>
ġ ִٰ . ɾ Ͽ
C ҽ ġ о ü Ѵ:</p>
<div class="example"><p><code>
$ apxs -c mod_foo.c<br />
/path/to/libtool --mode=compile gcc ... -c mod_foo.c<br />
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
$ _
</code></p></div>
<p> ü о̴ <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> þ ġ
߰Ѵ. <code>apxs</code> ڵ ü
"modules" 丮 ġϰ <code>httpd.conf</code>
˸° Ͽ ۾ ģ. Ѵ:</p>
<div class="example"><p><code>
$ apxs -i -a mod_foo.la<br />
/path/to/instdso.sh mod_foo.la /path/to/apache/modules<br />
/path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
...
chmod 755 /path/to/apache/modules/mod_foo.so<br />
[/path/to/apache/conf/httpd.conf `foo' ȰȭѴ]<br />
$ _
</code></p></div>
<p> </p>
<div class="example"><p><code>
LoadModule foo_module modules/mod_foo.so
</code></p></div>
<p>Ͽ ٸ ߰Ѵ. ⺻
ʴ´ٸ <code>-A</code> ɼ Ѵ. <em></em></p>
<div class="example"><p><code>
$ apxs -i -A mod_foo.c
</code></p></div>
<p>apxs Ϸ ġ ߺ
Makefile ִ:</p>
<div class="example"><p><code>
$ apxs -g -n foo<br />
Creating [DIR] foo<br />
Creating [FILE] foo/Makefile<br />
Creating [FILE] foo/modules.mk<br />
Creating [FILE] foo/mod_foo.c<br />
Creating [FILE] foo/.deps<br />
$ _
</code></p></div>
<p> ٷ ߺ ü Ͽ ġ
еѴ:</p>
<div class="example"><p><code>
$ cd foo<br />
$ make all reload<br />
apxs -c mod_foo.c<br />
/path/to/libtool --mode=compile gcc ... -c mod_foo.c<br />
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
apxs -i -a -n "foo" mod_foo.la<br />
/path/to/instdso.sh mod_foo.la /path/to/apache/modules<br />
/path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
...
chmod 755 /path/to/apache/modules/mod_foo.so<br />
[/path/to/apache/conf/httpd.conf `foo' ȰȭѴ]<br />
apachectl restart<br />
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start<br />
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
/path/to/apache/sbin/apachectl restart: httpd started<br />
$ _
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/apxs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apxs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apxs.html" title="Korean"> ko </a> |
<a href="../tr/programs/apxs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/apxs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/httpd.html 0000664 0001751 0001751 00000000566 13710016232 020674 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: httpd.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: httpd.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: httpd.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: httpd.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/apachectl.html.ko.euc-kr 0000664 0001751 0001751 00000023430 14743132254 023277 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>apachectl - ġ ̽ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>apachectl - ġ ̽</h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/apachectl.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apachectl.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apachectl.html" title="Korean"> ko </a> |
<a href="../tr/programs/apachectl.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>apachectl</code> ġ ؽƮ
(HTTP) մ̴. α ڰ
ġ <a href="httpd.html">httpd</a> ϵ
´.</p>
<p><code>apachectl</code> ũƮ ΰ Ѵ.
ù° <code>httpd</code> θ ũƮ
Ͽ, ʿ ȯ溯 ϰ ƱԸƮ
<code>httpd</code> Ѵ. ι°
<code>apachectl</code> SysV init ũƮ Ͽ,
<code>start</code>, <code>restart</code>, <code>stop</code>
Ѵܾ ƱԸƮ Ƽ <code>httpd</code>
ȣ .</p>
<p>ġ Ϲ ο ġ ʾҴٸ,
<code>httpd</code> η <code>apachectl</code> ũƮ
ؾ Ѵ. , <code>httpd</code> ƱԸƮ
߰ ִ. ڼ ũƮ ּ
϶.</p>
<p><code>apachectl</code> ũƮ ڵ 0,
>0 ȯѴ. ڼ ũƮ ּ
϶.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="../invoking.html">ġ </a></li><li><a href="../stopping.html">ġ ߴ</a></li><li><a href="../configuring.html"></a></li><li><a href="../platform/">÷ </a></li><li><a href="httpd.html">httpd</a></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p> ũƮ ϸ, <code>apachectl</code>
<a href="httpd.html">httpd</a> ƱԸƮ ´.</p>
<p><code><strong>apachectl</strong> [ <var>httpd-argument</var> ]</code></p>
<p>SysV init ϸ, <code>apachectl</code> Ʒ
Ѵܾ ɾ ´.</p>
<p><code><strong>apachectl</strong> <var>command</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<p>⼭ SysV init- ɼǸ Ѵ. ٸ ɼ <a href="httpd.html">httpd</a> manpage Ѵ.</p>
<dl>
<dt><code>start</code></dt>
<dd>ġ <code>httpd</code> Ѵ. ̹ ̶
. <code>apachectl -k start</code> .</dd>
<dt><code>stop</code></dt>
<dd>ġ <code>httpd</code> ߴѴ. <code>apachectl
-k stop</code> .</dd>
<dt><code>restart</code></dt>
<dd>ġ <code>httpd</code> Ѵ.
ƴ϶, Ѵ. ۽ Ȯϱ
ڵ <code>configtest</code> ɰ
˻Ѵ. <code>apachectl -k restart</code> .</dd>
<dt><code>fullstatus</code></dt>
<dd><code class="module"><a href="../mod/mod_status.html">mod_status</a></code> Ѵ.
ϱؼ <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>
ϰ, ýۿ <code>lynx</code> ڱ
ʿϴ. ϴ URL ũƮ
<code>STATUSURL</code> Ͽ ִ.</dd>
<dt><code>status</code></dt>
<dd> Ѵ. <code>fullstatus</code> ɼǰ
, û ʴ´.</dd>
<dt><code>graceful</code></dt>
<dd>ġ <code>httpd</code> ݰ(gracefully) Ѵ.
ƴ϶, Ѵ. Ϲ ۰
ִ ʴ´. , α ʴ´.
, αȯ ũƮ Ѵٸ, α
óϱ α ϱ ٷ
Ѵ. ġ ۽ Ȯϱ
ڵ <code>configtest</code> ɰ
˻Ѵ. <code>apachectl -k graceful</code> .</dd>
<dt><code>configtest</code></dt>
<dd> ˻Ѵ. а <code>Syntax
Ok</code> Ȥ Ư ڼ ˷ش.
<code>apachectl -t</code> .</dd>
</dl>
<p>Ʒ ɼ , ̴.</p>
<dl>
<dt><code>startssl</code></dt>
<dd><code>apachectl -k start -DSSL</code> . 츮
ɾ ϰų SSL ϵ
<code>httpd.conf</code> <code class="directive"><a href="../mod/core.html#ifdefine"><IfDefine></a></code> ϱ Ѵ.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/apachectl.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apachectl.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apachectl.html" title="Korean"> ko </a> |
<a href="../tr/programs/apachectl.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/apachectl.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/configure.html.ko.euc-kr 0000664 0001751 0001751 00000132673 14743132254 023346 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>configure - ҽ Ʈ Ѵ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>configure - ҽ Ʈ Ѵ</h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/configure.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/configure.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/configure.html" title="Korean"> ko </a> |
<a href="../tr/programs/configure.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>configure</code> ũƮ Ư ÷ ġ
ϰ ġϱ ҽ Ʈ Ѵ.
ɼ Ͽ ϴ 䱸ǿ °
ִ.</p>
<p>ҽ ֻ 丮 ִ ũƮ н
н ýۿ Ѵ. ٸ ÷ Ѵٸ
<a href="../platform/">÷</a> ϶.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#env">ȯ溯</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="../install.html">ϰ ġ</a></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p><code>configure</code> ũƮ ֻ
丮 ؾ Ѵ.</p>
<p><code><strong>./configure</strong> [<var>OPTION</var>]...
[<var>VAR</var>=<var>VALUE</var>]...</code></p>
<p>ȯ溯 ( , <code>CC</code>, <code>CFLAGS</code>,
...) Ϸ, <code><var>VAR</var>=<var>VALUE</var></code>
Ѵ. <a href="#env">Ʒ</a> ȯ溯
Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<ul>
<li><a href="#configurationoptions"> ɼ</a></li>
<li><a href="#installationdirectories">ġ 丮</a></li>
<li><a href="#systemtypes">ý </a></li>
<li><a href="#optionalfeatures"> </a></li>
<li><a href="#supportopt"> α ɼ</a></li>
</ul>
<h3><a name="configurationoptions" id="configurationoptions"> ɼ</a></h3>
<p> ɼǵ <code>configure</code> ü ൿ
ش.</p>
<dl>
<dt><code>-C</code></dt>
<dt><code>--config-cache</code></dt>
<dd><code>--cache-file=config.cache</code> .</dd>
<dt><code>--cache-file=<var>FILE</var></code></dt>
<dd>˻ <var>FILE</var> Ͽ ijѴ.
⺻ ˻ ʴ´.</dd>
<dt><code>-h</code></dt>
<dt><code>--help [short|recursive]</code></dt>
<dd> ϰ Ѵ. <code>short</code> ƱԸƮ
Ű Ư ɼǸ Ѵ. <code>recursive</code>
ƱԸƮ Ե Ű ª
ش.</dd>
<dt><code>-n</code></dt>
<dt><code>--no-create</code></dt>
<dd><code>configure</code> ũƮ ,
ʴ´. ɼ makefile
˻ Ȯغ ϴ.</dd>
<dt><code>-q</code></dt>
<dt><code>--quiet</code></dt>
<dd>߿ <code>checking ...</code>
ʴ´.</dd>
<dt><code>--srcdir=<var>DIR</var></code></dt>
<dd><var>DIR</var> 丮 ҽ 丮 Ѵ.
⺻ configure ִ 丮 Ȥ 丮
<code>..</code>̴.</dd>
<dt><code>--silent</code></dt>
<dd><code>--quiet</code> .</dd>
<dt>-V</dt>
<dt>--version</dt>
<dd>۱ ϰ Ѵ.</dd>
</dl>
<h3><a name="installationdirectories" id="installationdirectories">ġ 丮</a></h3>
<p> ɼǵ ġ 丮 Ѵ. ġ ġ
(layout) ٸ.</p>
<dl>
<dt><code>--prefix=<var>PREFIX</var></code></dt>
<dd>ŰĿ <var>PREFIX</var> ġѴ.
⺻ <code>/usr/local/apache2</code>̴.</dd>
<dt><code>--exec-prefix=<var>EPREFIX</var></code></dt>
<dd>ŰĿ <var>EPREFIX</var> ġѴ.
⺻ <var>PREFIX</var> 丮̴.</dd>
</dl>
<p>⺻ <code>make install</code>
<code>/usr/local/apache2/bin</code>,
<code>/usr/local/apache2/lib</code> ġ
ġѴ. <code>--prefix=$HOME</code>
<code>--prefix</code> ɼ Ͽ
<code>/usr/local/apache2</code> ̿ ġ 丮
ִ.</p>
<h4><a name="layout" id="layout">丮 </a></h4>
<dl>
<dt><code>--enable-layout=<var>LAYOUT</var></code></dt>
<dd>ġ ġ <var>LAYOUT</var>
ҽڵ ũƮ Ѵ. ϸ
ġ ġ ִ.
<code>config.layout</code> Ͽ ְ,
̸ Ͽ ִ. Ͽ
<code><Layout
FOO>...</Layout></code> еǸ,
κ <code>FOO</code> ̸ Ÿ.
⺻ <code>Apache</code>̴.</dd>
</dl>
<h4><a name="directoryfinetuning" id="directoryfinetuning">ġ 丮
ڼ </a></h4>
<p>ġ 丮 Ѵٸ Ʒ ɼ Ѵ.
丮 ⺻ <code>autoconf</code> ϸ,
ٸ ϶.</p>
<dl>
<dt><code>--bindir=<var>DIR</var></code></dt>
<dd> <var>DIR</var> ġѴ.
Ͽ Ʈ ڿ
<code>htpasswd</code> <code>dbmmanage</code>
α Եȴ. <var>DIR</var> ⺻
<code><var>EPREFIX</var>/bin</code>̴.</dd>
<dt><code>--datadir=<var>DIR</var></code></dt>
<dd>Ű б ڷḦ <var>DIR</var>
ġѴ. <code>datadir</code> ⺻
<code><var>PREFIX</var>/share</code>̴.
<code>autoconf</code> ɼ
ʴ´.</dd>
<dt><code>--includedir=<var>DIR</var></code></dt>
<dd>C <var>DIR</var> ġѴ.
<code>includedir</code> ⺻
<code><var>EPREFIX</var>/include</code>̴.</dd>
<dt><code>--infodir=<var>DIR</var></code></dt>
<dd>info <var>DIR</var> ġѴ.
<code>infodir</code> ⺻
<code><var>PREFIX</var>/info</code>̴. ɼ
ʴ´.</dd>
<dt><code>--libdir=<var>DIR</var></code></dt>
<dd>Ʈڵ ̺귯 <var>DIR</var> ġѴ.
<code>libdir</code> ⺻
<code><var>EPREFIX</var>/lib</code>̴.</dd>
<dt><code>--libexecdir=<var>DIR</var></code></dt>
<dd>α (, ) <var>DIR</var>
ġѴ. <code>libexecdir</code> ⺻
<code><var>EPREFIX</var>/libexec</code>̴.</dd>
<dt><code>--localstatedir=<var>DIR</var></code></dt>
<dd>Ǵ ӽ <var>DIR</var> ġѴ.
<code>localstatedir</code> ⺻
<code><var>PREFIX</var>/var</code>̴.
<code>autoconf</code> ɼ
ʴ´.</dd>
<dt><code>--mandir=<var>DIR</var></code></dt>
<dd>man <var>DIR</var> ġѴ.
<code>mandir</code> ⺻
<code><var>EPREFIX</var>/man</code>̴.</dd>
<dt><code>--oldincludedir=<var>DIR</var></code></dt>
<dd>gcc ƴ Ϸ C <var>DIR</var>
ġѴ. <code>oldincludedir</code> ⺻
<code>/usr/include</code>̴. <code>autoconf</code>
ɼ ʴ´.</dd>
<dt><code>--sbindir=<var>DIR</var></code></dt>
<dd>ý ڿ <var>DIR</var> ġѴ.
ý ڿ ̶ ġ ϴµ
ʿ <code>httpd</code>, <code>apachectl</code>,
<code>suexec</code> α Ѵ.
<code>sbindir</code> ⺻
<code><var>EPREFIX</var>/sbin</code>̴.</dd>
<dt><code>--sharedstatedir=<var>DIR</var></code></dt>
<dd>Ǵ Ű ڷḦ <var>DIR</var>
ġѴ. <code>sharedstatedir</code> ⺻
<code><var>PREFIX</var>/com</code>̴.
<code>autoconf</code> ɼ
ʴ´.</dd>
<dt><code>--sysconfdir=<var>DIR</var></code></dt>
<dd> <code>httpd.conf</code>,
<code>mime.types</code> б ӽ ڷḦ
<var>DIR</var> ġѴ. <code>sysconfdir</code>
⺻ <code><var>PREFIX</var>/etc</code>̴.</dd>
</dl>
<h3><a name="systemtypes" id="systemtypes">ý </a></h3>
<p>ٸ ýۿ ġ
ϱ(cross-compile)ϱ ɼǵ̴.
ýۿ ϴ Ϲ ,
ɼ ʴ´.</p>
<dl>
<dt><code>--build=<var>BUILD</var></code></dt>
<dd> ϴ ý Ѵ. ⺻
<code>config.guess</code> ũƮ ̴.</dd>
<dt><code>--host=<var>HOST</var></code></dt>
<dd> ý Ѵ. <var>HOST</var>
⺻ <var>BUILD</var>̴.</dd>
<dt><code>--target=<var>TARGET</var></code></dt>
<dd><var>TARGET</var> ý Ϸ 鶧
Ѵ. ⺻ <var>HOST</var>̴.
<code>autoconf</code> ɼ ġ ʹ
.</dd>
</dl>
<h3><a name="optionalfeatures" id="optionalfeatures"> </a></h3>
<p> ɼ Ѵ.</p>
<h4><a name="generaloptfeat" id="generaloptfeat">Ϲ </a></h4>
<p>Ϲ Ͽ ϰ :</p>
<dl>
<dt><code>--disable-<var>FEATURE</var></code></dt>
<dd><var>FEATURE</var> .
<code>--enable-<var>FEATURE</var>=no</code> .</dd>
<dt><code>--enable-<var>FEATURE</var>[=<var>ARG</var>]</code></dt>
<dd><var>FEATURE</var> Ѵ. <var>ARG</var>
⺻ <code>yes</code>̴.</dd>
<dt><code>--enable-<var>MODULE</var>=shared</code></dt>
<dd>ش DSO Ѵ.</dd>
<dt><code>--enable-<var>MODULE</var>=static</code></dt>
<dd>ϴ ⺻ ũȴ.
ɼ ũ Ѵ.</dd>
</dl>
<div class="note"><h3></h3>
<code>configure</code> <var>foo</var>
<code>--enable-<var>foo</var></code> ص
˷ Ƿ ؼ Էؾ Ѵ.
</div>
<h4><a name="enabledmodules" id="enabledmodules">⺻ ϴ </a></h4>
<p> ⺻ ϵDZ ʴ´ٸ
Ѵ. ɼ Ư
Ѵ.</p>
<dl>
<dt><code>--disable-actions</code></dt>
<dd><code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code> ϴ û
ൿ ʴ´.</dd>
<dt><code>--disable-alias</code></dt>
<dd><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> ϴ û
Ͻý ٸ κ ϴ
ʴ´.</dd>
<dt><code>--disable-asis</code></dt>
<dd><code class="module"><a href="../mod/mod_asis.html">mod_asis</a></code> ϴ as-is
ʴ´.</dd>
<dt><code>--disable-auth</code></dt>
<dd><code class="module"><a href="../mod/mod_auth.html">mod_auth</a></code> ϴ ں
ʴ´. ڸ ȣ
Ϲ Ͽ ϴ HTTP Basic Authentication
Ѵ.</dd>
<dt><code>--disable-autoindex</code></dt>
<dd><code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> ϴ 丮
ʴ´.</dd>
<dt><code>--disable-access</code></dt>
<dd><code class="module"><a href="../mod/mod_access.html">mod_access</a></code> ϴ ȣƮ
ʴ´.</dd>
<dt><code>--disable-cgi</code></dt>
<dd> MPM ϴ CGI ũƮ ϴ
<code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> ⺻ Ѵ.
ɼ ϸ CGI ʴ´.</dd>
<dt><code>--disable-cgid</code></dt>
<dd> MPM <code class="module"><a href="../mod/worker.html">worker</a></code>
<code class="module"><a href="../mod/perchild.html">perchild</a></code> ϴ ⺻
<code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code> CGI ũƮ Ѵ.
ɼ ϸ CGI ʴ´.</dd>
<dt><code>--disable-charset-lite</code></dt>
<dd><code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> ϴ
ȯ ʴ´. EBCDIC ýۿ
⺻ Ѵ.</dd>
<dt><code>--disable-dir</code></dt>
<dd><code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> ϴ 丮 û
ó ʴ´.</dd>
<dt><code>--disable-env</code></dt>
<dd><code class="module"><a href="../mod/mod_env.html">mod_env</a></code> ϴ ȯ溯 /
ʴ´.</dd>
<dt><code>--disable-http</code></dt>
<dd>HTTP ó ʴ´. <code>http</code>
ϴµ ⺻ ̴.
ٸ 쿡
ϴ. <strong>ڽ ϴ Ȯ
Ѵٸ ɼ </strong>
<br />
: ũȴ.</dd>
<dt><code>--disable-imagemap</code></dt>
<dd><code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code> ϴ imagemap
ʴ´.</dd>
<dt><code>--disable-include</code></dt>
<dd><code class="module"><a href="../mod/mod_include.html">mod_include</a></code> ϴ Server Side
Includes ʴ´.</dd>
<dt><code>--disable-log-config</code></dt>
<dd><code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> ϴ α
ʴ´. û
α .</dd>
<dt><code>--disable-mime</code></dt>
<dd><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> û ϸ Ȯڿ
ൿ (mime-type, , ,
ڵ) Ѵ. ( Ͽ) Ȯڸ
MIME ʴ Ϲ õ ʴ´.</dd>
<dt><code>--disable-negotiation</code></dt>
<dd><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> ϴ
ʴ´.</dd>
<dt><code>--disable-setenvif</code></dt>
<dd><code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> ϴ
ȯ溯 ϴ ʴ´.</dd>
<dt><code>--disable-status</code></dt>
<dd><code class="module"><a href="../mod/mod_status.html">mod_status</a></code> ϴ μ/
ʴ´.</dd>
<dt><code>--disable-userdir</code></dt>
<dd><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code> ϴ û ں
丮 ϴ ʴ´.</dd>
</dl>
<h4><a name="disabledmodules" id="disabledmodules">⺻ ʴ </a></h4>
<p>⺻ ϵǴ , Ϸ
Ȥ <code>most</code> <code>all</code> Ű带
Ͽ ؾ ϴ ִ.
Ʒ ɼǵ Ѵ.</p>
<dl>
<dt><code>--enable-auth-anon</code></dt>
<dd><code class="module"><a href="../mod/mod_auth_anon.html">mod_auth_anon</a></code> ϴ
Ѵ.</dd>
<dt><code>--enable-auth-dbm</code></dt>
<dd><code class="module"><a href="../mod/mod_auth_dbm.html">mod_auth_dbm</a></code> ڸ ȣ
DBM ͺ̽ Ͽ ϴ HTTP Basic
Authentication Ѵ. Ϸ
ɼ Ѵ.</dd>
<dt><code>--enable-auth-digest</code></dt>
<dd><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> ϴ RFC2617
Digest authentication Ѵ.
Ϲ Ͽ Ѵ.</dd>
<dt><code>--enable-authnz-ldap</code></dt>
<dd><code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> ϴ LDAP
Ѵ.</dd>
<dt><code>--enable-cache</code></dt>
<dd><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> ϴ ϴ
ij Ѵ. ſ ϰ ų Ͻ
ijϴ
ִ. ּ Ѱ (storage management
module) ( , <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>
<code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code>) ؾ Ѵ.</dd>
<dt><code>--enable-cern-meta</code></dt>
<dd><code class="module"><a href="../mod/mod_cern_meta.html">mod_cern_meta</a></code> ϴ CERN Ÿ
Ѵ.</dd>
<dt><code>--enable-charset-lite</code></dt>
<dd><code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> ϴ
ȯ Ѵ. EBCDIC ýۿ
⺻ Եȴ. ٸ ýۿ Խ
Ѵ.</dd>
<dt><code>--enable-dav</code></dt>
<dd><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> ϴ WebDAV
ó Ѵ. <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>
Ͻý ڿ Ѵ.
<code>--enable-dav</code> ϸ ڵ Ѵ.<br />
: <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> <code>http</code>
ؾ Ѵ.</dd>
<dt><code>--enable-dav-fs</code></dt>
<dd><code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> ϴ DAV Ͻý
ڿ Ѵ.
<code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> ̱
<code>--enable-dav</code> ؾ Ѵ.</dd>
<dt><code>--enable-deflate</code></dt>
<dd><code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> ϴ
ڵ Ѵ.</dd>
<dt><code>--enable-disk-cache</code></dt>
<dd><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> ϴ ũ
ij Ѵ.</dd>
<dt><code>--enable-expires</code></dt>
<dd><code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code> ϴ Expires
Ѵ.</dd>
<dt><code>--enable-ext-filter</code></dt>
<dd><code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code> ϴ ܺ
Ѵ.</dd>
<dt><code>--enable-file-cache</code></dt>
<dd><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> ϴ
ij Ѵ.</dd>
<dt><code>--enable-headers</code></dt>
<dd><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> ϴ HTTP
Ѵ.</dd>
<dt><code>--enable-info</code></dt>
<dd><code class="module"><a href="../mod/mod_info.html">mod_info</a></code> ϴ
Ѵ.</dd>
<dt><code>--enable-ldap</code></dt>
<dd><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> ϴ LDAP ij̰
Ǯ Ѵ.</dd>
<dt><code>--enable-logio</code></dt>
<dd><code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> ϴ α
Ʈ ϴ Ѵ.</dd>
<dt><code>--enable-mem-cache</code></dt>
<dd><code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code> ϴ
ij Ѵ.</dd>
<dt><code>--enable-mime-magic</code></dt>
<dd><code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code> ϴ MIME
type ڵ ν Ѵ.</dd>
<dt><code>--enable-isapi</code></dt>
<dd><code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code> ϴ isapi Ȯ
Ѵ.</dd>
<dt><code>--enable-proxy</code></dt>
<dd><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> ϴ Ͻ/Ʈ
Ѵ. <code>CONNECT</code>, <code>FTP</code>,
<code>HTTP</code> Ͻ
<code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code>,
<code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>,
<code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>
Ѵ. <code>--enable-proxy</code> ϸ
ڵ Ѵ.</dd>
<dt><code>--enable-proxy-connect</code></dt>
<dd><code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code> ϴ
<code>CONNECT</code> û Ͻ
Ѵ. <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>
Ȯ̹Ƿ, <code>--enable-proxy</code> ؾ
Ѵ.</dd>
<dt><code>--enable-proxy-ftp</code></dt>
<dd><code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> ϴ
<code>FTP</code> û Ͻ Ѵ.
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> Ȯ̹Ƿ,
<code>--enable-proxy</code> ؾ Ѵ.</dd>
<dt><code>--enable-proxy-http</code></dt>
<dd><code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> ϴ
<code>HTTP</code> û Ͻ Ѵ.
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> Ȯ̹Ƿ,
<code>--enable-proxy</code> ؾ Ѵ.</dd>
<dt><code>--enable-rewrite</code></dt>
<dd><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ϴ Ģ
URL Ѵ.</dd>
<dt><code>--enable-so</code></dt>
<dd><code class="module"><a href="../mod/mod_so.html">mod_so</a></code> ϴ DSO Ѵ.
<code>--enable-mods-shared</code> ɼ ϸ
ڵ Ѵ.</dd>
<dt><code>--enable-speling</code></dt>
<dd><code class="module"><a href="../mod/mod_spelling.html">mod_spelling</a></code> ϴ URL
Ϲ Ǽ ġ Ѵ.</dd>
<dt><code>--enable-ssl</code></dt>
<dd><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> ϴ SSL/TLS
Ѵ.</dd>
<dt><code>--enable-unique-id</code></dt>
<dd><code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code> ϴ û
ĺڸ Ѵ.</dd>
<dt><code>--enable-usertrack</code></dt>
<dd><code class="module"><a href="../mod/mod_usertrack.html">mod_usertrack</a></code> ϴ ڼ
Ѵ.</dd>
<dt><code>--enable-vhost-alias</code></dt>
<dd><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> ϴ 뷮
ȣƮ Ѵ.</dd>
</dl>
<h4><a name="developermodules" id="developermodules">ڸ </a></h4>
<p> Ʈ ڿԸ ϸ, ⺻
ʴ´. Ϸ ɼ Ѵ.
ʿ Ȯġʴٸ .</p>
<dl>
<dt><code>--enable-bucketeer</code></dt>
<dd><code>mod_bucketeer</code> ϴ Ŷ(bucket)
Ѵ.</dd>
<dt><code>--enable-case-filter</code></dt>
<dd><code>mod_case_filter</code> 빮ںȯ
ߺ Ѵ.</dd>
<dt><code>--enable-case-filter-in</code></dt>
<dd><code>mod_case_filter_in</code> 빮ںȯ Է
ߺ Ѵ.</dd>
<dt><code>--enable-echo</code></dt>
<dd><code class="module"><a href="../mod/mod_echo.html">mod_echo</a></code> ϴ ECHO
Ѵ.</dd>
<dt><code>--enable-example</code></dt>
<dd>ߺ <code class="module"><a href="../mod/mod_example.html">mod_example</a></code>
Ѵ.</dd>
<dt><code>--enable-optional-fn-export</code></dt>
<dd><code>mod_optional_fn_export</code> ϴ
Լ Ʈ(exporter) Ѵ.</dd>
<dt><code>--enable-optional-fn-import</code></dt>
<dd><code>mod_optional_fn_import</code> ϴ
Լ Ʈ(importer) Ѵ.</dd>
<dt><code>--enable-optional-hook-export</code></dt>
<dd><code>mod_optional_hook_export</code> ϴ
(hook) Ʈ Ѵ.</dd>
<dt><code>--enable-optional-hook-import</code></dt>
<dd><code>mod_optional_hook_import</code> ϴ
Ʈ Ѵ.</dd>
</dl>
<h4><a name="modules" id="modules">MPM ڰ </a></h4>
<p> ɼ Ͽ ʿ ó ڰ
߰Ѵ:</p>
<dl>
<dt><code>--with-module=<var>module-type</var>:<var>module-file</var>
</code></dt>
<dd><p>ڰ ũ Ͽ
߰Ѵ. ġ ҽ Ʈ
<code>modules/<var>module-type</var></code>
ҽ <code><var>module-file</var></code> ã
װ ҽ ־ Ѵ. װ ٸ
<code>configure</code> <var>module-file</var>
ϰζ ϰ ҽ
<var>module-type</var> 丮 Ϸ
õѴ.</p>
<p> ɼ ҽ Ѱ ܺ ߰ϴµ
ϴ. 簡
ؾ Ѵ.</p>
<div class="note"><h3></h3>
ũ ƴ DSO Ѵٸ
<a href="apxs.html">apxs</a> ϶.</div>
</dd>
<dt><code>--with-mpm=MPM</code></dt>
<dd> ۹ Ѵ. Ȯ Ѱ <a href="../mpm.html">ó</a> ؾ Ѵ.
ϴ ü <a href="../mpm.html#defaults">⺻ MPM</a> Ѵ.
ִ MPM <code class="module"><a href="../mod/beos.html">beos</a></code>,
<code class="module"><a href="../mod/leader.html">leader</a></code>, <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code>,
<code class="module"><a href="../mod/perchild.html">perchild</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>,
<code class="module"><a href="../mod/threadpool.html">threadpool</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code>
ִ.</dd>
</dl>
<h4><a name="otheroptfeat" id="otheroptfeat">Ÿ ɼ</a></h4>
<dl>
<dt><code>--enable-maintainer-mode</code></dt>
<dd> Ͻ ۵Ѵ.</dd>
<dt><code>--enable-mods-shared=<var>MODULE-LIST</var></code></dt>
<dd>
<p> Ѵ. ,
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> þ
Ͽ о鿩 Ѵ.</p>
<p><var>MODULE-LIST</var>
ǥ ̴. տ
<code>mod_</code> . :</p>
<div class="example"><p><code>
--enable-mods-shared='headers rewrite dav'
</code></p></div>
<p>, Ư Ű <code>all</code> <code>most</code>
ִ. ,</p>
<div class="example"><p><code>
--enable-mods-shared=most
</code></p></div>
<p> κ DSO Ѵ.
</p>
</dd>
<dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
<dd><code>--enable-mods-shared</code> ,
ɼ ũѴ. ,
<code>httpd</code> ϸ
ִ. <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> о
ʿ䰡 .</dd>
<dt><code>--enable-v4-mapped</code></dt>
<dd>IPv6 IPv4 ó ֵ Ѵ.</dd>
<dt><code>--with-port=<var>PORT</var></code></dt>
<dd><code>httpd</code> ٸ Ʈ Ѵ.
Ʈȣ <code>httpd.conf</code> 鶧
δ. ⺻ 80̴.</dd>
<dt><code>--with-program-name</code></dt>
<dd>ٸ ϸ Ѵ. ⺻
<code>httpd</code>̴.</dd>
</dl>
<h3><a name="packages" id="packages">߰ Ű </a></h3>
<p> ɼ ߰ Ű Ѵ.</p>
<h4><a name="generalpackages" id="generalpackages">Ϲ </a></h4>
<p>Ϲ Ͽ ߰ Ű
ٷ:</p>
<dl>
<dt><code>--with-<var>PACKAGE</var>[=<var>ARG</var>]</code></dt>
<dd>Ű <var>PACKAGE</var> Ѵ.
<var>ARG</var> ⺻ <code>yes</code>̴.</dd>
<dt><code>--without-<var>PACKAGE</var></code></dt>
<dd>Ű <var>PACKAGE</var> ʴ´.
<code>--with-<var>PACKAGE</var>=no</code> .
<code>autoconf</code> ɼ ġ ʹ
谡 .</dd>
</dl>
<h4><a name="packageopt" id="packageopt">Ư Ű</a></h4>
<dl>
<dt><code>--with-apr=<var>DIR</var>|<var>FILE</var></code></dt>
<dd><code>httpd</code> ҽ Ե Apache Portable
Runtime (APR) ڵ ϵȴ.
̹ ġ APR ϰ ʹٸ
<code>configure</code> <code>apr-config</code>
ũƮ θ ˷־ Ѵ. APR ġ ,
ϸ, 丮 ִ. 丮
丮 丮 <code>bin</code>
<code>apr-config</code> ־ Ѵ.</dd>
<dt><code>--with-apr-util=<var>DIR</var>|<var>FILE</var></code></dt>
<dd><code>httpd</code> ҽ Ե Apache Portable
Runtime Utilities (APU) ڵ
ϵȴ. ̹ ġ APU ϰ ʹٸ
<code>configure</code> <code>apu-config</code>
ũƮ θ ˷־ Ѵ. APU ġ ,
ϸ, 丮 ִ. 丮
丮 丮 <code>bin</code>
<code>apu-config</code> ־ Ѵ.</dd>
<dt><code>--with-ssl=<var>DIR</var></code></dt>
<dd><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> ϴ
<code>configure</code> ġ OpenSSL ã´.
ɼ Ͽ SSL/TLS 丮θ
˷ ִ.</dd>
<dt><code>--with-z=<var>DIR</var></code></dt>
<dd>(<code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> ϴ
) ʿϴٸ ڵ <code>configure</code>
ġ <code>zlib</code> ̺귯 ã´.
ɼ Ͽ ̺귯 丮θ
˷ ִ.</dd>
</dl>
<p><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> DBM <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> ġ
Ϻ ã Ű/
ͺ̽ Ѵ. APU SDBM ־
ּ ͺ̽ ִ. ٸ
ͺ̽ ϰ ʹٸ Ʒ ɼ Ѵ:</p>
<dl>
<dt><code>--with-gdbm[=<var>path</var>]</code></dt>
<dd><var>path</var> ,
<code>configure</code> Ϲ ˻ο ġ
GNU DBM ϰ ̺귯 ã´.
<var>path</var> ϸ <code>configure</code>
<code><var>path</var>/lib</code>
<code><var>path</var>/include</code> ʿ
ã´. <var>path</var> ο
̺귯 θ ݷ ̿ ΰ
ִ.</dd>
<dt><code>--with-ndbm[=<var>path</var>]</code></dt>
<dd><code>--with-gdbm</code> ġ New DBM
ã´.</dd>
<dt><code>--with-berkeley-db[=<var>path</var>]</code></dt>
<dd><code>--with-gdbm</code> ġ Berkeley
DB ã´.</dd>
</dl>
<div class="note"><h3></h3>
<p>DBM ɼ APU ϸ APU ũƮ
ȴ. <code>--with-apr-util</code> Ͽ
̹ ġ APU Ѵٸ DBM ɼ ҿ .</p>
<p> DBM ִ.
DBM ִ.</p>
</div>
<h3><a name="supportopt" id="supportopt"> α ɼ</a></h3>
<dl>
<dt><code>--enable-static-support</code></dt>
<dd> α ũ Ϸ .
, ʿ ̺귯 ϵ
Ѵ. ɼ ⺻
α ũѴ.</dd>
<dt><code>--enable-suexec</code></dt>
<dd> ϴ μ uid gid ϴ
<code><a href="suexec.html">suexec</a></code> Ϸ
ɼ Ѵ. <strong>suid Ȼ
Ѵٸ ɼ .</strong>
<code>suexec</code> ϴ ɼ
<a href="#suexec">Ʒ</a> Ѵ.</dd>
</dl>
<p> ɼ Ͽ α ũ
ִ:</p>
<dl>
<dt><code>--enable-static-ab</code></dt>
<dd><code><a href="ab.html">ab</a></code> ũ
Ϸ Ѵ.</dd>
<dt><code>--enable-static-checkgid</code></dt>
<dd><code>checkgid</code> ũ Ϸ
Ѵ.</dd>
<dt><code>--enable-static-htdbm</code></dt>
<dd><code>htdbm</code> ũ Ϸ
Ѵ.</dd>
<dt><code>--enable-static-htdigest</code></dt>
<dd><code><a href="htdigest.html">htdigest</a></code>
ũ Ϸ Ѵ.</dd>
<dt><code>--enable-static-htpasswd</code></dt>
<dd><code><a href="htpasswd.html">htpasswd</a></code>
ũ Ϸ Ѵ.</dd>
<dt><code>--enable-static-logresolve</code></dt>
<dd><code><a href="logresolve.html">logresolve</a></code>
ũ Ϸ Ѵ.</dd>
<dt><code>--enable-static-rotatelogs</code></dt>
<dd><code><a href="rotatelogs.html">rotatelogs</a></code>
ũ Ϸ Ѵ.</dd>
</dl>
<h4><a name="suexec" id="suexec">suexec ɼ</a></h4>
<p>Ʒ ɼ <code><a href="../suexec.html">suexec</a></code> ڼ Ѵ.
ڼ <a href="../suexec.html#install">suEXEC
ġ</a> ϶.</p>
<dl>
<dt><code>--with-suexec-bin</code></dt>
<dd>suexec θ Ѵ. ⺻
<code>--sbindir</code>̴ (<a href="#directoryfinetuning">ġ 丮 ڼ
</a> ).</dd>
<dt><code>--with-suexec-caller</code></dt>
<dd><code>suexec</code> ڸ Ѵ.
ڴ <code>httpd</code> ϴ ڿ
ƾ Ѵ.</dd>
<dt><code>--with-suexec-docroot</code></dt>
<dd><code>suexec</code> ɼ 丮
Ʒ ִ ϸ ִ. ⺻
<code>--datadir/htdocs</code>.</dd>
<dt><code>--with-suexec-gidmin</code></dt>
<dd><code>suexec</code> ּ GID Ѵ.
⺻ 100̴.</dd>
<dt><code>--with-suexec-logfile</code></dt>
<dd><code>suexec</code> αϸ Ѵ. αϸ
⺻ <code>suexec_log</code>̰,
<code>--logfiledir</code> ġѴ.</dd>
<dt><code>--with-suexec-safepath</code></dt>
<dd><code>suexec</code> ϴ μ
<code>PATH</code> ȯ溯 Ѵ. ⺻
<code>/usr/local/bin:/usr/bin:/bin</code>̴.</dd>
<dt><code>--with-suexec-userdir</code></dt>
<dd> 丮 <code>suexec</code>
ִ ( ִ) 丮 Ѵ.
<code>suexec</code>
(<code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code> ϴ) ں
丮 Ҷ ʿϴ. ⺻
<code>public_html</code>̴.</dd>
<dt><code>--with-suexec-uidmin</code></dt>
<dd><code>suexec</code> ּ UID Ѵ.
⺻ 100̴.</dd>
<dt><code>--with-suexec-umask</code></dt>
<dd><code>suexec</code> ϴ μ
<code>umask</code> Ѵ. ⺻ ϴ ý
⺻ .</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="env" id="env">ȯ溯</a></h2>
<p><code>configure</code> ϰų ʿ ٸ
̸̳ ġ ִ ̺귯 α ã ִ
ȯ溯 ִ.</p>
<dl>
<dt><code>CC</code></dt>
<dd>Ͽ C Ϸ ɾ Ѵ.</dd>
<dt><code>CFLAGS</code></dt>
<dd>϶ ϱ ٶ C Ϸ ɼ Ѵ.</dd>
<dt><code>CPP</code></dt>
<dd> C ó ɾ Ѵ.</dd>
<dt><code>CPPFLAGS</code></dt>
<dd>C/C++ ó ɼ. , ʿ
<var>includedir</var> 丮 ִٸ
<code>-I<var>includedir</var></code> Ѵ.</dd>
<dt><code>LDFLAGS</code></dt>
<dd>Ŀ ɼ. , ̺귯 ʿ
<var>libdir</var> 丮 ִٸ
<code>-L<var>libdir</var></code> Ѵ.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/configure.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/configure.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/configure.html" title="Korean"> ko </a> |
<a href="../tr/programs/configure.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/configure.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/log_server_status.html.fr.utf8 0000664 0001751 0001751 00000014354 14740503670 024631 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>log_server_status - Enregistrement périodique de l'état du serveur - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>log_server_status - Enregistrement périodique de l'état du serveur</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/log_server_status.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/log_server_status.html" title="Français"> fr </a></p>
</div>
<p>Ce script perl a été conçu pour être exécuté à intervalles
réguliers via un déclencheur de type cron. Il se connecte au serveur
pour en extraire des informations quant à son état. Il formate ces
informations sous la forme d'une seule ligne qu'il enregistre dans
un fichier. Vous devez éditer la valeur des variables en tête de
script afin de définir le chemin du fichier de sortie. Pour que ce
script puisse fonctionner, <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> doit au
préalable être chargé et configuré.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configure" id="configure">Mode d'emploi</a></h2>
<p>Le script contient les sections suivantes :</p>
<pre class="prettyprint lang-perl">my $wherelog = "/usr/local/apache2/logs/"; # Le fichier de sortie sera
# du style "/usr/local/apache2/logs/19960312"
my $server = "localhost"; # Nom du serveur, par exemple "www.foo.com"
my $port = "80"; # Port d'écoute du serveur
my $request = "/server-status/?auto"; # Requête à soumettre</pre>
<p>Ces variables doivent contenir des valeurs correctes, et le
gestionnaire <code>/server-status</code> doit être configuré pour le
répertoire considéré. En outre, l'utilisateur qui exécute le script doit
avoir les droits d'écriture sur le chemin du fichier de sortie.</p>
<p>L'exécution périodique du script via cron permet d'obtenir un jeu de
rapports d'état qui pourra être utilisé à des fins d'analyse
statistique.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/log_server_status.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/log_server_status.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/log_server_status.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/split-logfile.html.fr.utf8 0000664 0001751 0001751 00000014150 14740503670 023623 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>split-logfile - Eclatement des journaux en fonction des serveurs
virtuels - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>split-logfile - Eclatement des journaux en fonction des serveurs
virtuels</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/split-logfile.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/split-logfile.html" title="Français"> fr </a></p>
</div>
<p>Ce script perl permet d'extraire un journal pour chaque serveur
virtuel à partir d'un journal d'accès global du serveur web. Pour
que ce script fonctionne, le premier champ de chaque ligne du
journal global doit contenir l'identité du serveur virtuel ; ce
champ aura été ajouté à la directive <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> via la variable
"<code>%v</code>".
</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="split-logfile" id="split-logfile">Mode d'emploi</a></h2>
<p>Création d'un fichier journal comportant l'identité du serveur
virtuel considéré :</p>
<pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" combined_plus_vhost
CustomLog logs/access_log combined_plus_vhost</pre>
<p>Un fichier journal sera créé dans le répertoire à partir duquel
vous exécutez le script pour chaque serveur virtuel qui apparaît
dans le journal global. Ces fichiers journaux seront nommés à partir
du nom du serveur virtuel considéré, avec l'extension
<code>.log</code>.</p>
<p>Le fichier journal global est lu depuis l'entrée standard stdin.
Les entrées de ce journal sont alors ajoutées au journal du serveur
virtuel correspondant.</p>
<div class="example"><p><code>split-logfile < access_log</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/split-logfile.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/split-logfile.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/split-logfile.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/dbmmanage.html.tr.utf8 0000664 0001751 0001751 00000035535 14743132254 023013 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>dbmmanage - DBM biçemli kullanıcı kimlik doğrulama dosyalarını yönetir - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>dbmmanage - DBM biçemli kullanıcı kimlik doğrulama dosyalarını yönetir</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/dbmmanage.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/dbmmanage.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/dbmmanage.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/dbmmanage.html" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Bu çeviri güncel olmayabilir. Son değişiklikler için İngilizce sürüm geçerlidir.</div>
<p><code><strong>dbmmanage</strong></code>,
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> üzerinden HTTP kullanıcılarının temel
kimlik doğrulaması için kullanıcı isimlerinin ve parolalarının
saklanmasında kullanılacak DBM dosyalarını oluşturmak ve güncellemek için
kullanılır. Apache HTTP sunucusunun mevcut özkaynaklarının kullanımı
sadece <code><strong>dbmmanage</strong></code> tarafından oluşturulan
dosyalarda listelenmiş kullanıcılara tahsis edilebilir. Bu program
sadece, kullanıcı isimleri bir DBM dosyasında saklanmak istenirse işe
yarar. Düz metin bir veritabanı kullanmak isterseniz
<strong><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code></strong> sayfasına bakınız.</p>
<p>DBM parola veritabanı sağlayan diğer bir araç da
<strong><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></strong>'dir.</p>
<p>Bu kılavuz sayfası sadece komut satırı değiştirgelerini listeler.
Kullanıcı kimlik doğrulamasını
<strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong>'de yapılandırmak için gerekli
yönergelerle ilgili ayrıntılar için Apache dağıtımının bir parçası olan
ve <a href="http://httpd.apache.org/"> http://httpd.apache.org/</a>
adresinde de bulunan Apache HTTP Sunucusu Belgelerine bakınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Hatalar</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></li><li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li><li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></li><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>dbmmanage</strong> [ <var>kodlama</var> ]
<var>dosyaismi</var> add|adduser|check|delete|update
<var>kullanıcı</var>
[ <var>şifreli_parola</var>
[ <var>grup</var>[,<var>grup</var>...]
[ <var>açıklama</var> ] ] ]</code></p>
<p><code><strong>dbmmanage</strong> <var>dosyaismi</var>
view [ <var>kullanıcı</var> ]</code></p>
<p><code><strong>dbmmanage</strong> <var>dosyaismi</var> import</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code><var>dosyaismi</var></code></dt>
<dd>DBM dosyasının ismi. Genellikle, <code>.db</code>, <code>.pag</code>
veya <code>.dir</code> eklentisi olmaksızın belirtilir.</dd>
<dt><code><var>kullanıcı</var></code></dt>
<dd>İşlemleri gerçekleştirecek kullanıcı ismi.
<code><var>kullanıcı</var></code> ismi ikinokta imi (<code>:</code>)
içeremez.</dd>
<dt><code><var>şifreli_parola</var></code></dt>
<dd><code><strong>update</strong></code> ve
<code><strong>add</strong></code> komutları için kullanılacak şifreli
paroladır. Parolanın istenmesini sağlamak, fakat hemen ardından alanları
doldurmak için bir tire imi (<code>-</code>) kullanabilirsiniz. Buna ek
olarak, <code><strong>update</strong></code> komutunu kullanırken özgün
parolaya dokunulmaması için bir nokta imi (<code>.</code>)
kullanabilirsiniz.</dd>
<dt><code><var>grup</var></code></dt>
<dd>Kullanıcının üyesi olduğu grup. Grup ismi ikinokta imi
(<code>:</code>) içeremez.Kullanıcıyı bir gruba atamadan açıklama alanını
doldurmak istiyorsanız bir tire imi (<code>-</code>) kullanabilirsiniz.
Buna ek olarak, <code><strong>update</strong></code> komutunu kullanırken
özgün gruba dokunulmaması için bir nokta imi (<code>.</code>)
kullanabilirsiniz.</dd>
<dt><code><var>açıklama</var></code></dt>
<dd>Adı ve soyadı, eposta adresi gibi kullanıcıyla ilgili bir takım
bilgiler buraya yazılır. Sunucu bu alanı gözardı eder.</dd>
</dl>
<h3><a name="options.encodings" id="options.encodings">Kodlamalar</a></h3>
<dl>
<dt><code><strong>-d</strong></code></dt>
<dd>CRYPT şifrelemesi (Win32 ve Netware hariç, öntanımlı)</dd>
<dt><code><strong>-m</strong></code></dt>
<dd>MD5 şifrelemesi (Win32 ve Netware için öntanımlı)</dd>
<dt><code><strong>-s</strong></code></dt>
<dd>SHA1 şifrelemesi</dd>
<dt><code><strong>-p</strong></code></dt>
<dd>düz metin (<em>önerilmez</em>)</dd>
</dl>
<h3><a name="options.commands" id="options.commands">Komutlar</a></h3>
<dl>
<dt><code><strong>add</strong></code></dt>
<dd><code><var>şifreli_parola</var></code>'yı kullanarak
<code><var>dosyaismi</var></code> dosyasına
<code><var>kullanıcı</var></code> için bir girdi ekler.
<div class="example"><p><code>dbmmanage passwords.dat add rbowen foKntnEF3KSXA</code></p></div>
</dd>
<dt><code><strong>adduser</strong></code></dt>
<dd>Parola sorduktan sonra <code><var>dosyaismi</var></code>
dosyasına <code><var>kullanıcı</var></code> için bir girdi ekler.
<div class="example"><p><code>dbmmanage passwords.dat adduser krietz</code></p></div>
</dd>
<dt><code><strong>check</strong></code></dt>
<dd>Parola sorduktan sonra belirtilen <code><var>kullanıcı</var></code>,
<code><var>dosyaismi</var></code> dosyasında var mı diye bakar; varsa
belirtilen parolayı kullanıcınınkiyle eşleştirmeye çalışır.
<div class="example"><p><code>dbmmanage passwords.dat check rbowen</code></p></div>
</dd>
<dt><code><strong>delete</strong></code></dt>
<dd><code><var>dosyaismi</var></code> dosyasından
<code><var>kullanıcı</var></code> girdisini siler.
<div class="example"><p><code>dbmmanage passwords.dat delete rbowen</code></p></div>
</dd>
<dt><code><strong>import</strong></code></dt>
<dd>Standart girdiden
<code><var>kullanıcı</var>:<var>parola</var></code> satırlarını (her
satırda bir tane) okur ve bunları <code><var>dosyaismi</var></code>
dosyasına ekler. Parola şifrelenmiş olmalıdır.</dd>
<dt><code><strong>update</strong></code></dt>
<dd>Belirtilen <code><var>kullanıcı</var></code>'nın
<code><var>dosyaismi</var></code> dosyasında mevcut olması dışında
<code><strong>adduser</strong></code> komutu gibidir.
<div class="example"><p><code>dbmmanage passwords.dat update rbowen</code></p></div>
</dd>
<dt><code><strong>view</strong></code></dt>
<dd>Sadece, DBM dosyasının içeriğini gösterir. Bir
<code><var>kullanıcı</var></code> belirtirseniz sadece o kaydı
gösterir.
<div class="example"><p><code>dbmmanage passwords.dat view</code></p></div>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="bugs" id="bugs">Hatalar</a></h2>
<p>Birden fazla DBM dosya biçemi vardır ve büyük bir olasılıkla da
sisteminizde bu birden fazla biçemle ilgili kütüphaneler vardır. SDBM,
NDBM, GNU'nun GDBM projesi ve Berkeley DB 2 bunların başlıcalarıdır. Ne
yazık ki, bu kütüphanelerin her birinin dosya biçimleri farklıdır. Bu
bakımdan, <code><var>dosyaismi</var></code> dosyasında kullanılan dosya
biçeminin <code><strong>dbmmanage</strong></code> tarafından kullanılanla
aynı biçemde olduğundan emin olmalısınız.
<code><strong>dbmmanage</strong></code> hangi tür DBM dosyasına baktığını
saptayacak yeterliliğe sahip değildir. Yanlış biçemli bir dosya
belirtirseniz hiçbir şey dönmeyebileceği gibi, başka isimde bir DBM
dosyasının oluşturulması veya daha da kötüsü üzerine yazmaya
çalışıyorsanız DBM dosyasının bozulması bile olasıdır.</p>
<p><code><strong>dbmmanage</strong></code> programının başlangıcında
<code>@AnyDBM::ISA</code> dizisi olarak tanımlanmış DBM biçem
tercihlerinin bir listesi vardır. Berkeley DB 2 biçemini tercih
ettiğimizden <code><strong>dbmmanage</strong></code> sistem
kütüphanelerini şu sıraya göre arar: Berkeley DB 2, NDBM, GDBM ve SDBM.
<code><strong>dbmmanage</strong></code> DBM dosyası hareketleri için bu
sıralamaya göre bulduğu ilk kütüphaneyi kullanacaktır. Sıralama Perl'deki
<code>dbmopen()</code> çağrısının kullandığından faklı olduğu gibi
Perl'deki standart <code>@AnyDBM::ISA</code> sıralamasından da oldukça
farklıdır. Bu bakımdan, DBM dosyalarınızı yönetmek için Perl ile yazılmış
başka araçlar kullanıyorsanız, onların da bu tercih sırasını izlemesini
sağlamalısınız. Benzer şekilde, bu dosyalara erişmek için diğer dillerde
(C gibi) yazılmış programlar kullanıyorsanız bunlar için de aynı durum
geçerlidir.</p>
<p>Unix sistemlerinde, kullanılan DBM dosyasının biçemini öğrenmek için
<code><strong>file</strong></code> programı kullanılabilir.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/dbmmanage.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/dbmmanage.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/dbmmanage.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/dbmmanage.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/dbmmanage.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/dbmmanage.html.ko.euc-kr 0000664 0001751 0001751 00000026616 14743132254 023277 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>dbmmanage - DBM Ѵ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>dbmmanage - DBM Ѵ</h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/dbmmanage.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/dbmmanage.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/dbmmanage.html" title="Korean"> ko </a> |
<a href="../tr/programs/dbmmanage.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>dbmmanage</code> HTTP basic authentication
ڸ ȣ ϴ DBM
Ѵ. ġ ڿ <code>dbmmanage</code>
Ͽ ڿԸ ִ. ڸ
DBM Ͽ ϵ α ִ.
Ϲ ͺ̽ Ϸ <a href="htpasswd.html">htpasswd</a> ϶.</p>
<p> manpage ɼǸ Ѵ. <a href="httpd.html">httpd</a> ϴ þ
ġ Եְ <a href="http://httpd.apache.org">http://httpd.apache.org/</a>
ִ ġ ϶.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs"></a></li>
</ul><h3></h3><ul class="seealso"><li><a href="httpd.html">httpd</a></li><li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li><li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p><code><strong>dbmmanage</strong> [ <var>encoding</var> ]
<var>filename</var> add|adduser|check|delete|update
<var>username</var>
[ <var>encpasswd</var>
[ <var>group</var>[,<var>group</var>...]
[ <var>comment</var> ] ] ]</code></p>
<p><code><strong>dbmmanage</strong> <var>filename</var>
view [ <var>username</var> ]</code></p>
<p><code><strong>dbmmanage</strong> <var>filename</var> import</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<dl>
<dt><code><var>filename</var></code></dt>
<dd>DBM ϸ. <code>.db</code>,
<code>.pag</code>, <code>.dir</code> Ȯڸ .</dd>
<dt><code><var>username</var></code></dt>
<dd>۾ ڸ. <var>username</var> ݷ(<code>:</code>)
.</dd>
<dt><code><var>encpasswd</var></code></dt>
<dd><code>update</code> <code>add</code> ɿ
̹ ȣȭ ȣ̴. ȣ ߿ ϰ
ȣ(<code>-</code>) Ѵ. , <code>update</code>
Ҷ ħǥ(<code>.</code>) ϸ
ȣ ״ д.</dd>
<dt><code><var>group</var></code></dt>
<dd>ڰ . ݷ(<code>:</code>)
. ڸ 쿡 ߰
ä ʹٸ ȣ(<code>-</code>) Ѵ. ,
<code>update</code> Ҷ ħǥ(<code>.</code>)
Ѵٸ ״ д.</dd>
<dt><code><var>comment</var></code></dt>
<dd> ̸, ּ ڿ ̴.
Ѵ.</dd>
</dl>
<h3><a name="options.encodings" id="options.encodings">ڵ</a></h3>
<dl>
<dt><code>-d</code></dt>
<dd>crypt ȣȭ (Win32 Netware ƴ϶ ⺻)</dd>
<dt><code>-m</code></dt>
<dd>MD5 ȣȭ (Win32 Netware ⺻)</dd>
<dt><code>-s</code></dt>
<dd>SHA1 ȣȭ</dd>
<dt><code>-p</code></dt>
<dd>ȣ ״ (<em>õ </em>)</dd>
</dl>
<h3><a name="options.commands" id="options.commands"></a></h3>
<dl>
<dt><code>add</code></dt>
<dd>ȣȭ ȣ <var>encpasswd</var> Ͽ
<var>filename</var> <var>username</var> ߰Ѵ.</dd>
<dt><code>adduser</code></dt>
<dd>ȣ <var>filename</var>
<var>username</var> ߰Ѵ.</dd>
<dt><code>check</code></dt>
<dd>ȣ <var>filename</var>
<var>username</var> ְ ȣ ġϴ ˻Ѵ.</dd>
<dt><code>delete</code></dt>
<dd><var>filename</var> <var>username</var>
Ѵ.</dd>
<dt><code>import</code></dt>
<dd><code>STDIN</code>
<code><var>username</var>:<var>password</var></code>
(ٿ ϳ) о <var>filename</var> ߰Ѵ.
ȣ ̹ ȣȭ־ Ѵ.</dd>
<dt><code>update</code></dt>
<dd><code>adduser</code> ɰ ,
<var>filename</var> ̹ <var>username</var> ִ
ȮѴ.</dd>
<dt><code>view</code></dt>
<dd>DBM Ѵ. <var>username</var>
ϸ Ư Ѵ.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="bugs" id="bugs"></a></h2>
<p> ٸ DBM ĵ ְ ýۿ
Ŀ ̺귯 ؾ Ѵ.
ǥ װ SDBM, NDBM, GNU Ʈ GDBM,
Berkeley DB 2̴. ̺귯 ٸ
Ѵ. <var>filename</var> ϴ
<code>dbmmanage</code> ϴ İ
Ȯؾ Ѵ. <code>dbmmanage</code> DBM
˾Ƴ Ѵ. ٸ ϸ ƹϵ ʰų,
ٸ ̸ DBM ų, ־ Ͽ
DBM ĥ ִ.</p>
<p><code>dbmmanage</code> α պκп ִ
<code>@AnyDBM::ISA</code> 迭 DBM ȣ̴.
츮 Berkeley DB 2 ȣϹǷ
<code>dbmmanage</code> ý ̺귯 ã
Berkeley DB 2, NDBM, GDBM, SDBM ̴. <code>dbmmanage</code>
ã ̺귯 Ͽ DBM ۾
Ѵ. Perl <code>dbmopen()</code> ȣ
ϴ Perl ǥ <code>@AnyDBM::ISA</code>
ٸ. ٸ Ͽ DBM Ѵٸ
Ѵ. C ٸ ۼ α
Ͽ ٷ 쿡 .</p>
<p>κ н ýۿ <code>file</code> α
DBM Ȯ ִ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/dbmmanage.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/dbmmanage.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/dbmmanage.html" title="Korean"> ko </a> |
<a href="../tr/programs/dbmmanage.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/dbmmanage.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htdbm.html.tr.utf8 0000664 0001751 0001751 00000047430 14743132254 022173 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htdbm - DBM parola veritabanlarını yönetir - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>htdbm - DBM parola veritabanlarını yönetir</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/htdbm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htdbm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/htdbm.html" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Bu çeviri güncel olmayabilir. Son değişiklikler için İngilizce sürüm geçerlidir.</div>
<p><code><strong>htdbm</strong></code>,
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> üzerinden HTTP kullanıcılarının temel
kimlik doğrulaması için kullanıcı isimlerinin ve parolalarının
saklanmasında kullanılacak DBM dosyalarını yönetmek için kullanılır. DBM
dosyaları hakkında daha ayrıntılı bilgi edinmek için
<strong><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></strong> sayfasına bakınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Hatalar</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">Çıkış Durumu</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Örnekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Güvenlik Değerlendirmeleri</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#restrictions">Kısıtlamalar</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></li><li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>htdbm</strong>
[ -<strong>T</strong><var>VTtürü</var> ]
[ -<strong>i</strong> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>bedel</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>parola-dosyası</var> <var>kullanıcı</var></code></p>
<p><code><strong>htdbm</strong> -<strong>b</strong>
[ -<strong>T</strong><var>VTtürü</var> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>bedel</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>parola-dosyası</var> <var>kullanıcı</var> <var>parola</var></code></p>
<p><code><strong>htdbm</strong> -<strong>n</strong>
[ -<strong>i</strong> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>bedel</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>kullanıcı</var></code></p>
<p><code><strong>htdbm</strong> -<strong>nb</strong>
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>bedel</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>kullanıcı</var> <var>parola</var></code></p>
<p><code><strong>htdbm</strong> -<strong>v</strong>
[ -<strong>T</strong><var>VTtürü</var> ]
[ -<strong>i</strong> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>bedel</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>parola-dosyası</var> <var>kullanıcı</var></code></p>
<p><code><strong>htdbm</strong> -<strong>vb</strong>
[ -<strong>T</strong><var>VTtürü</var> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong>
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>bedel</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>parola-dosyası</var> <var>kullanıcı</var> <var>parola</var></code></p>
<p><code><strong>htdbm</strong> -<strong>x</strong>
[ -<strong>T</strong><var>VTtürü</var> ]
<var>parola-dosyası</var> <var>kullanıcı</var></code></p>
<p><code><strong>htdbm</strong> -<strong>l</strong>
[ -<strong>T</strong><var>VTtürü</var> ]
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code><strong>-b</strong></code></dt>
<dd>Betik kipi; parola için istek yapmak yerine parola komut satırından
verilir. <strong>Parola komut satırında görünür</strong> olacağından çok
dikkatli kullanmak gerekir. Betik kullanımı için
<code><strong>-i</strong></code> seçeneğine bakınız.</dd>
<dt><code><strong>-i</strong></code></dt>
<dd>Parolayı doğrulamaksızın standart girdiden okur (betik kullanımı
için).</dd>
<dt><code><strong>-c</strong></code></dt>
<dd><code><var>parola-dosyası</var></code> oluşturur. Dosya mevcutsa,
dosya silinip yeniden yazılır. Bu seçenek
<code><strong>-n</strong></code> seçeneği ile birlikte kullanılamaz.</dd>
<dt><code><strong>-n</strong></code></dt>
<dd>Sonuçları veritabanında güncellemek yerine standart çıktıya gönderir.
<code><var>parola-dosyası</var></code> belirtilmediğinden, bu seçenek
komut satırı sözdizimini değiştirir. Bu seçenek
<code><strong>-c</strong></code> seçeneği ile birlikte kullanılamaz.</dd>
<dt><code><strong>-m</strong></code></dt>
<dd>Parolalar için MD5 şifrelemesi kullanılır. Windows ve Netware
için bu öntanımlıdır.</dd>
<dt><code><strong>-B</strong></code></dt>
<dd>Parolalar için bcrypt şifrelemesi kullanılır. Şu an için çok güvenli
kabul edilmektedir.</dd>
<dt><code><strong>-C</strong> <var>bedel</var></code></dt>
<dd>Bu seçenek sadece <code><strong>-B</strong></code> (bcrypt şifrelemesi)
seçeneği ile birlikte kullanılabilir. Bcrypt algoritmasına hesaplama
süresini belirtir (daha yüksek değerler daha güvenlidir, öntanımlı 5,
geçerli değerler: 4 - 31).</dd>
<dt><code><strong>-d</strong></code></dt>
<dd>Parolaları şifrelemek için <code>crypt()</code> kullanılır. Windows,
ve Netware dışında öntanımlıdır.
<code><strong>htdbm</strong></code> tarafından tüm platformlarda
destekleniyor olsa da Windows ve Netware üzerinde
<code class="program"><a href="../programs/httpd.html">httpd</a></code> sunucusu tarafından desteklenmez. Bu algoritma
günümüz standartlarında <strong>güvenilmez</strong> kabul
edilmektedir.</dd>
<dt><code><strong>-s</strong></code></dt>
<dd>Parolalar için SHA şifrelemesi kullanılır. LDAP Dizin değişim
biçemini (ldif) kullanarak Netscape sunucularına/sunucularından göçü
kolaylaştırır. Bu algoritma günümüz standartlarında
<strong>güvenilmez</strong> kabul edilmektedir.</dd>
<dt><code><strong>-p</strong></code></dt>
<dd>Düz metin parolalar kullanılır. <code><strong>htdbm</strong></code>
tarafından tüm platformlarda destekleniyor olsa da Windows, Netware ve
TPF üzerinde <code class="program"><a href="../programs/httpd.html">httpd</a></code> sunucusu tarafından sadece düz
metin parolalar kabul edilir.</dd>
<dt><code><strong>-l</strong></code></dt>
<dd>Veritabanındaki kullanıcıları açıklamalarıyla birlikte standart
çıktıya gönderir.</dd>
<dt><code><strong>-v</strong></code></dt>
<dd>Kullanıcı adını ve parolasını doğrular. Program belirtilen parolanın
geçerli olup olmadığını belirten bir ileti basar. Eğer parola geçersizse
program hata kodu 3 ile çıkar.</dd>
<dt><code><strong>-x</strong></code></dt>
<dd>Kullanıcıyı siler. Kullanıcı belirtilen DBM dosyasında mevcutsa
silinir.</dd>
<dt><code><strong>-t</strong></code></dt>
<dd>Son değiştirgenin bir açıklama olarak yorumlanmasını sağlar. Bu
seçenek kullanıldığında komut satırının sonuna fazladan bir dizge
eklenebilir. Bu dizge, veritabanında belirtilen kullanıcının "Comment"
alanında saklanır.</dd>
<dt><code><var>parola-dosyası</var></code></dt>
<dd>DBM dosyasının ismi. Genellikle, <code>.db</code>, <code>.pag</code>
veya <code>.dir</code> eklentisi olmaksızın belirtilir.
<code><strong>-c</strong></code> seçeneği ile birlikte verilmişse ve DBM
dosyası mevcut değilse dosya oluşturulur, mevcutsa dosya güncellenir.</dd>
<dt><code><var>kullanıcı</var></code></dt>
<dd><code><var>parola-dosyası</var></code>'nda oluşturulacak veya
güncellenecek kullanıcı ismi. <code><var>kullanıcı</var></code> bu
dosyada mevcut değilse yeni bir girdi eklenir. Girdi mevcutsa parolası
değiştirilir.</dd>
<dt><code><var>parola</var></code></dt>
<dd>Şifrelenip DBM dosyasında saklanacak düz metin parola. Sadece
<code><strong>-b</strong></code> seçeneği ile kullanılır.</dd>
<dt><code><strong>-T</strong> <var>VTtürü</var></code></dt>
<dd>DBM dosyasının türü; SDBM, GDBM, DB, veya "default" olabilir.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="bugs" id="bugs">Hatalar</a></h2>
<p>Birden fazla DBM dosya biçemi vardır ve büyük bir olasılıkla da
sisteminizde bu birden fazla biçemle ilgili kütüphaneler vardır. SDBM,
NDBM, GNU'nun GDBM projesi ve Berkeley/Sleepycat DB 2/3/4 bunların
başlıcalarıdır. Ne yazık ki, bu kütüphanelerin her birinin dosya
biçimleri farklıdır. Bu bakımdan, <code><var>dosyaismi</var></code>
dosyasında kullanılan dosya biçeminin <code><strong>htdbm</strong></code>
tarafından kullanılanla aynı biçemde olduğundan emin olmalısınız.
<code><strong>htdbm</strong></code> hangi tür DBM dosyasına baktığını
saptayacak yeterliliğe sahip değildir. Yanlış biçemli bir dosya
belirtirseniz hiçbir şey dönmeyebileceği gibi, başka isimde bir DBM
dosyasının oluşturulması veya daha da kötüsü üzerine yazmaya
çalışıyorsanız DBM dosyasının bozulması bile olasıdır.</p>
<p>Unix sistemlerinde, kullanılan DBM dosyasının biçemini öğrenmek için
<code><strong>file</strong></code> programı kullanılabilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">Çıkış Durumu</a></h2>
<p><code><strong>htdbm</strong></code>, kullanıcı ismi ve parolasını DBM
dosyasına başarıyla eklemiş veya güncellemişse <code>0</code>, dosyalara
erişirken bir sorun çıkmışsa <code>1</code>, komut satırında bir
sözdizimi hatası varsa <code>2</code>, parola etkileşimli alınmış fakat
girdi ile eşleşme sağlanamamışsa <code>3</code>, işlem kesintiye
uğramışsa <code>4</code>, bir değer çok uzunsa <code>5</code> (kullanıcı,
parola, dosya ismi veya açıklama), kullanıcı ismi kuraldışı karakter
içeriyorsa (<a href="#restrictions">Kısıtlamalar</a> bölümüne bakınız)
<code>6</code> ve dosya geçerli bir DBM parola dosyası değilse
<code>7</code> değeriyle döner.</p>
</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">Örnekler</a></h2>
<div class="example"><p><code>
htdbm /usr/local/etc/apache/.htdbm-users jsmith
</code></p></div>
<p><code>jsmith</code> kullanıcısı için parolayı ekler veya değiştirir.
Parolayı vermesi için kullanıcıya parola isteği yapılır. Windows üzerinde
çalıştırılırsa parola Apache MD5 algoritması ile şifrelenir, aksi
takdirde sistemin <code>crypt()</code> yordamı kullanılır. Dosya mevcut
değilse <code><strong>htdbm</strong></code> beklenen hiçbir işlemi
yapmadan bir hata vererek çıkar.</p>
<div class="example"><p><code>
htdbm -c /home/doe/public_html/.htdbm jane
</code></p></div>
<p>Yeni bir dosya oluşturur ve kullanıcı <code>jane</code> için kaydı bir
girdi olarak bu dosyaya yazar. Dosya mevcutsa fakat okunamıyor veya
yazılamıyorsa dosyada bir değişiklik yapılmaz ve
<code><strong>htdbm</strong></code> bir ileti gösterip bir hata durumu
ile çıkar.</p>
<div class="example"><p><code>
htdbm -mb /usr/web/.htdbm-all jones Pwd4Steve
</code></p></div>
<p>Komut satırından verilen parolayı (<code>Pwd4Steve</code>) MD5
algoritmasıyla şifreler ve bunu belirtilen dosyada saklar.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Güvenlik Değerlendirmeleri</a></h2>
<p><code><strong>htdbm</strong></code> tarafından yönetilen parola
dosyalarına sunucunun URI uzayından erişilememelidir; yani dosya bir
tarayıcı ile okunabilecek bir yerde bulunmamalıdır.</p>
<p>Komut satırında parolanın şifrelenmemiş olarak görünmesi sebebiyle
<code><strong>-b</strong></code> seçeneğinin kullanımından kaçınılmasını
öneriyoruz.</p>
<p><code>crypt()</code> algoritması kullanılırken, parolayı
şekillendirmek için parolanın ilk 8 baytının kullanılacağına dikkat
ediniz. Eğer parola 8 bayttan uzunsa kalanlar bir uyarı verilmeksizin
iptal edilir.</p>
<p>SHA şifreleme biçeminde tuz kullanılmaz; yani, bir parolanın
sadece bir şifreli gösterimi olabilir. <code>crypt()</code> ve
MD5 biçemleri parolanın önüne rasgele üretilmiş bir tuz dizgesi
eklediklerinden sözlük saldırılarına karşı daha dayanıklıdır.</p>
<p>SHA ve <code>crypt()</code> biçimleri günümüz standartlarında
<strong>güvenilmez</strong> kabul edilmektedir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="restrictions" id="restrictions">Kısıtlamalar</a></h2>
<p>Windows platformunda, <code><strong>htdbm</strong></code>
ile şifrelenen parolalar <code>255</code> karakterden daha uzun olamaz.
255 karakterden sonrası kırpılır.</p>
<p><code><strong>htdbm</strong></code> tarafından kullanılan MD5
algoritması Apache yazılımına özeldir; bu algoritma ile şifrelenen
parolalar başka HTTP sunucularında kullanılamayabilir.</p>
<p>Kullanıcı isimleri <code>255</code> bayttan uzun olamaz ve iki nokta
imi (<code>:</code>) içeremez.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/htdbm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htdbm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/htdbm.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htdbm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/apxs.html.en 0000664 0001751 0001751 00000046542 14737241666 021156 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>apxs - APache eXtenSion tool - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>apxs - APache eXtenSion tool</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/apxs.html" title="English"> en </a> |
<a href="../fr/programs/apxs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apxs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apxs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>apxs</code> is a tool for building and installing extension
modules for the Apache HyperText Transfer Protocol (HTTP) server. This is
achieved by building a dynamic shared object (DSO) from one or more source
or object <var>files</var> which then can be loaded into the Apache server
under runtime via the <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>
directive from <code class="module"><a href="../mod/mod_so.html">mod_so</a></code>.</p>
<p>So to use this extension mechanism your platform has to support the DSO
feature and your Apache <code class="program"><a href="../programs/httpd.html">httpd</a></code> binary has to be built with the
<code class="module"><a href="../mod/mod_so.html">mod_so</a></code> module. The <code>apxs</code> tool automatically
complains if this is not the case. You can check this yourself by manually
running the command</p>
<div class="example"><p><code>
$ httpd -l
</code></p></div>
<p>The module <code class="module"><a href="../mod/mod_so.html">mod_so</a></code> should be part of the displayed list.
If these requirements are fulfilled you can easily extend your Apache
server's functionality by installing your own modules with the DSO mechanism
by the help of this <code>apxs</code> tool:</p>
<div class="example"><p><code>
$ apxs -i -a -c mod_foo.c<br />
gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo.c<br />
ld -Bshareable -o mod_foo.so mod_foo.o<br />
cp mod_foo.so /path/to/apache/modules/mod_foo.so<br />
chmod 755 /path/to/apache/modules/mod_foo.so<br />
[activating module `foo' in /path/to/apache/etc/httpd.conf]<br />
$ apachectl restart<br />
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start<br />
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
/path/to/apache/sbin/apachectl restart: httpd started<br />
$ _
</code></p></div>
<p>The arguments <var>files</var> can be any C source file (.c), a object
file (.o) or even a library archive (.a). The <code>apxs</code> tool
automatically recognizes these extensions and automatically used the C
source files for compilation while just using the object and archive files
for the linking phase. But when using such pre-compiled objects make sure
they are compiled for position independent code (PIC) to be able to use them
for a dynamically loaded shared object. For instance with GCC you always
just have to use <code>-fpic</code>. For other C compilers consult its
manual page or at watch for the flags <code>apxs</code> uses to compile the
object files.</p>
<p>For more details about DSO support in Apache read the documentation of
<code class="module"><a href="../mod/mod_so.html">mod_so</a></code> or perhaps even read the
<code>src/modules/standard/mod_so.c</code> source file.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Examples</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>apxs</strong> -<strong>g</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
-<strong>n</strong> <var>modname</var></code></p>
<p><code><strong>apxs</strong> -<strong>q</strong>
[ -<strong>v</strong> ]
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
<var>query</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>c</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
[ -<strong>o</strong> <var>dsofile</var> ]
[ -<strong>I</strong> <var>incdir</var> ]
[ -<strong>D</strong> <var>name</var>=<var>value</var> ]
[ -<strong>L</strong> <var>libdir</var> ]
[ -<strong>l</strong> <var>libname</var> ]
[ -<strong>Wc,</strong><var>compiler-flags</var> ]
[ -<strong>Wl,</strong><var>linker-flags</var> ]
<var>files</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>i</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
[ -<strong>n</strong> <var>modname</var> ]
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]
<var>dso-file</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>e</strong>
[ -<strong>S</strong> <var>name</var>=<var>value</var> ]
[ -<strong>n</strong> <var>modname</var> ]
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]
<var>dso-file</var> ...</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<h3><a name="options.common" id="options.common">Common Options</a></h3>
<dl>
<dt><code>-n <var>modname</var></code></dt>
<dd>This explicitly sets the module name for the <code>-i</code> (install)
and <code>-g</code> (template generation) option. Use this to explicitly
specify the module name. For option <code>-g</code> this is required, for
option <code>-i</code> the <code>apxs</code> tool tries to determine the
name from the source or (as a fallback) at least by guessing it from the
filename.</dd>
</dl>
<h3><a name="options.query" id="options.query">Query Options</a></h3>
<dl>
<dt><code>-q</code></dt>
<dd>Performs a query for variables and environment settings used to
build <code>httpd</code>. When invoked without <var>query</var> parameters,
it prints all known variables and their values. The optional <code>-v</code>
parameter formats the list output.
<p>Use this to manually determine settings used to build the
<code>httpd</code> that will load your module. For instance use</p>
<div class="example"><p><code>
INC=-I`apxs -q INCLUDEDIR`
</code></p></div>
<p>inside your own Makefiles if you need manual access to Apache's C
header files.</p></dd>
</dl>
<h3><a name="options.conf" id="options.conf">Configuration Options</a></h3>
<dl>
<dt><code>-S <var>name</var>=<var>value</var></code></dt>
<dd>This option changes the apxs settings described above.</dd>
</dl>
<h3><a name="options.template" id="options.template">Template Generation Options</a></h3>
<dl>
<dt><code>-g</code></dt>
<dd>This generates a subdirectory <var>name</var> (see option
<code>-n</code>) and there two files: A sample module source file named
<code>mod_<var>name</var>.c</code> which can be used as a template for
creating your own modules or as a quick start for playing with the
apxs mechanism. And a corresponding <code>Makefile</code> for even easier
build and installing of this module.</dd>
</dl>
<h3><a name="options.dso" id="options.dso">DSO Compilation Options</a></h3>
<dl>
<dt><code>-c</code></dt>
<dd>This indicates the compilation operation. It first compiles the C
source files (.c) of <var>files</var> into corresponding object files (.o)
and then builds a dynamically shared object in <var>dsofile</var> by
linking these object files plus the remaining object files (.o and .a) of
<var>files</var>. If no <code>-o</code> option is specified the output
file is guessed from the first filename in <var>files</var> and thus
usually defaults to <code>mod_<var>name</var>.so</code>.</dd>
<dt><code>-o <var>dsofile</var></code></dt>
<dd>Explicitly specifies the filename of the created dynamically shared
object. If not specified and the name cannot be guessed from the
<var>files</var> list, the fallback name <code>mod_unknown.so</code> is
used.</dd>
<dt><code>-D <var>name</var>=<var>value</var></code></dt>
<dd>This option is directly passed through to the compilation command(s).
Use this to add your own defines to the build process.</dd>
<dt><code>-I <var>incdir</var></code></dt>
<dd>This option is directly passed through to the compilation command(s).
Use this to add your own include directories to search to the build
process.</dd>
<dt><code>-L <var>libdir</var></code></dt>
<dd>This option is directly passed through to the linker command. Use this
to add your own library directories to search to the build process.</dd>
<dt><code>-l <var>libname</var></code></dt>
<dd>This option is directly passed through to the linker command. Use this
to add your own libraries to search to the build process.</dd>
<dt><code>-Wc,<var>compiler-flags</var></code></dt>
<dd>This option passes <var>compiler-flags</var> as additional flags to
the <code>libtool --mode=compile</code> command. Use this to add local
compiler-specific options.</dd>
<dt><code>-Wl,<var>linker-flags</var></code></dt>
<dd>This option passes <var>linker-flags</var> as additional
flags to the <code>libtool --mode=link</code> command. Use this
to add local linker-specific options.</dd>
<dt><code>-p</code></dt>
<dd>This option causes apxs to link against the apr/apr-util libraries.
This is useful when compiling helper programs that use the apr/apr-util
libraries.</dd>
</dl>
<h3><a name="options.dsoinstall" id="options.dsoinstall">DSO Installation and Configuration Options</a></h3>
<dl>
<dt><code>-i</code></dt>
<dd>This indicates the installation operation and installs one or more
dynamically shared objects into the server's <var>modules</var>
directory.</dd>
<dt><code>-a</code></dt>
<dd>This activates the module by automatically adding a corresponding
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> line to Apache's
<code>httpd.conf</code> configuration file, or by enabling it if it
already exists.</dd>
<dt><code>-A</code></dt>
<dd>Same as option <code>-a</code> but the created <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directive is prefixed with a hash
sign (<code>#</code>), <em>i.e.</em>, the module is just prepared for
later activation but initially disabled.</dd>
<dt><code>-e</code></dt>
<dd>This indicates the editing operation, which can be used with the
<code>-a</code> and <code>-A</code> options similarly to the
<code>-i</code> operation to edit Apache's <code>httpd.conf</code>
configuration file without attempting to install the module.</dd>
</dl>
</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">Examples</a></h2>
<p>Assume you have an Apache module named <code>mod_foo.c</code> available
which should extend Apache's server functionality. To accomplish this you
first have to compile the C source into a shared object suitable for loading
into the Apache server under runtime via the following command:</p>
<div class="example"><p><code>
$ apxs -c mod_foo.c<br />
/path/to/libtool --mode=compile gcc ... -c mod_foo.c<br />
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
$ _
</code></p></div>
<p>Then you have to update the Apache configuration by making sure a
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directive is present to
load this shared object. To simplify this step <code>apxs</code> provides
an automatic way to install the shared object in its "modules" directory
and updating the <code>httpd.conf</code> file accordingly. This can be
achieved by running:</p>
<div class="example"><p><code>
$ apxs -i -a mod_foo.la<br />
/path/to/instdso.sh mod_foo.la /path/to/apache/modules<br />
/path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
...
chmod 755 /path/to/apache/modules/mod_foo.so<br />
[activating module `foo' in /path/to/apache/conf/httpd.conf]<br />
$ _
</code></p></div>
<p>This way a line named</p>
<div class="example"><p><code>
LoadModule foo_module modules/mod_foo.so
</code></p></div>
<p>is added to the configuration file if still not present. If you want to
have this disabled per default use the <code>-A</code> option,
<em>i.e.</em></p>
<div class="example"><p><code>
$ apxs -i -A mod_foo.c
</code></p></div>
<p>For a quick test of the apxs mechanism you can create a sample Apache
module template plus a corresponding Makefile via:</p>
<div class="example"><p><code>
$ apxs -g -n foo<br />
Creating [DIR] foo<br />
Creating [FILE] foo/Makefile<br />
Creating [FILE] foo/modules.mk<br />
Creating [FILE] foo/mod_foo.c<br />
Creating [FILE] foo/.deps<br />
$ _
</code></p></div>
<p>Then you can immediately compile this sample module into a shared object
and load it into the Apache server:</p>
<div class="example"><p><code>
$ cd foo<br />
$ make all reload<br />
apxs -c mod_foo.c<br />
/path/to/libtool --mode=compile gcc ... -c mod_foo.c<br />
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
apxs -i -a -n "foo" mod_foo.la<br />
/path/to/instdso.sh mod_foo.la /path/to/apache/modules<br />
/path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
...
chmod 755 /path/to/apache/modules/mod_foo.so<br />
[activating module `foo' in /path/to/apache/conf/httpd.conf]<br />
apachectl restart<br />
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start<br />
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
/path/to/apache/sbin/apachectl restart: httpd started<br />
$ _
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/apxs.html" title="English"> en </a> |
<a href="../fr/programs/apxs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/apxs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apxs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/apxs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/configure.html.fr.utf8 0000664 0001751 0001751 00000117140 14740503670 023035 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>configure - Configure l'arborescence des sources - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>configure - Configure l'arborescence des sources</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/configure.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/configure.html" title="Français"> fr </a> |
<a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/configure.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Le script <code>configure</code> permet de configurer
l'arborescence des sources afin de compiler et installer le serveur
HTTP Apache sur votre plate-forme spécifique. De nombreuses options
vous permettent de compiler un serveur correspondant à vos propres
besoins.</p>
<p>Ce script, situé dans le répertoire racine de la distribution des
sources, ne concerne que la compilation sur les systèmes Unix et
apparentés. Pour les autres plates-formes, voir la <a href="../platform/">documentation spécifique</a> de ces
dernières.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Résumé</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#env">Variables d'environnement</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../install.html">Compilation et installation</a></li><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Résumé</a></h2>
<p>Vous devez appeler le script <code>configure</code> depuis le
répertoire racine de la distribution.</p>
<p><code><strong>./configure</strong> [<var>OPTION</var>]...
[<var>VARIABLE</var>=<var>VALEUR</var>]...</code></p>
<p>Pour définir des variables d'environnement (par exemple
<code>CC</code>,<code>CFLAGS</code>, etc...), utilisez la clause
<code><var>VARIABLE</var>=<var>VALEUR</var></code>. Voir <a href="#env">ci-dessous</a> pour la description de quelques variables
usuelles.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<ul>
<li><a href="#configurationoptions">Options de Configuration</a></li>
<li><a href="#installationdirectories">Répertoires d'installation</a></li>
<li><a href="#systemtypes">Types de Systèmes</a></li>
<li><a href="#optionalfeatures">Fonctionnalités optionnelles</a></li>
<li><a href="#supportopt">Options pour les programmes support</a></li>
</ul>
<h3><a name="configurationoptions" id="configurationoptions">Options de Configuration</a></h3>
<p>Les options suivantes affectent le comportement du script
<code>configure</code>.</p>
<dl>
<dt><code>-C</code></dt>
<dt><code>--config-cache</code></dt>
<dd>C'est un alias pour <code>--cache-file=config.cache</code></dd>
<dt><code>--cache-file=<var>FICHIER</var></code></dt>
<dd>Les résultats des tests seront mis en cache dans le fichier
<var>FICHIER</var>. Cette option est désactivée par défaut.</dd>
<dt><code>-h</code></dt>
<dt><code>--help [short|recursive]</code></dt>
<dd>Affichage de l'aide et sortie du script. Avec l'argument
<code>short</code>, seules les options spécifiques à ce paquet
seront affichées. L'argument <code>recursive</code> permet
d'afficher l'aide de tous les paquets inclus.</dd>
<dt><code>-n</code></dt>
<dt><code>--no-create</code></dt>
<dd>Le script <code>configure</code> s'exécute normalement, mais
ne crée pas les fichiers résultants. Ceci permet de vérifier les
résultats des tests avant de générer les fichiers makefile pour la
compilation.</dd>
<dt><code>-q</code></dt>
<dt><code>--quiet</code></dt>
<dd>Les messages <code>checking ...</code> ne sont pas affichés au
cours du processus de configuration.</dd>
<dt><code>--srcdir=<var>DIR</var></code></dt>
<dd>Définit le répertoire <var>DIR</var> comme répertoire des
fichiers sources. Par défaut, c'est le répertoire où se situe le
script <code>configure</code>, ou le répertoire parent.</dd>
<dt><code>--silent</code></dt>
<dd>Identique à <code>--quiet</code></dd>
<dt>-V</dt>
<dt>--version</dt>
<dd>Affichage des informations de copyright et sortie du
script.</dd>
</dl>
<h3><a name="installationdirectories" id="installationdirectories">Répertoires
d'installation</a></h3>
<p>Ces options permettent de spécifier le répertoire d'installation.
L'arborescence de l'installation dépend de l'organisation (layout)
sélectionnée.</p>
<dl>
<dt><code>--prefix=<var>PREFIX</var></code></dt>
<dd>Installe les fichiers indépendants de l'architecture dans
<var>PREFIX</var>. Par défaut, le répertoire d'installation est
<code>/usr/local/apache2</code>.</dd>
<dt><code>--exec-prefix=<var>EPREFIX</var></code></dt>
<dd>Installe les fichiers dépendants de l'architecture dans
<var>EPREFIX</var>. La valeur par défaut de cette option
correspond à la valeur de la variable
<var>PREFIX</var>.</dd>
</dl>
<p>Par défaut, <code>make install</code> va installer tous les
fichiers dans <code>/usr/local/apache2/bin</code>,
<code>/usr/local/apache2/lib</code>, etc... Vous pouvez cependant
spécifier un préfixe d'installation autre que
<code>/usr/local/apache2</code> en utilisant l'option
<code>--prefix</code> (par exemple <code>--prefix=$HOME</code>).</p>
<h4><a name="layout" id="layout">Spécifier une organisation (layout) des
répertoires</a></h4>
<dl>
<dt><code>--enable-layout=<var>LAYOUT</var></code></dt>
<dd>Configure le code source et les scripts de compilation de
façon à ce que l'arborescence d'installation adopte
l'organisation <var>LAYOUT</var>. Ceci vous permet de spécifier
des chemins séparés pour chaque type de fichier de
l'installation du serveur HTTP Apache. Le fichier
<code>config.layout</code> contient de nombreux exemples de
configurations, et vous pouvez créer vos propres configurations
personnalisées en vous basant sur ces exemples. Les différentes
organisations contenues dans ce fichier sont enregistrées sous
forme de sections <code><Layout
FOO>...</Layout></code> et référencées dans ce cas par
le nom <code>FOO</code>. L'organisation par défaut
est <code>Apache</code>.</dd>
</dl>
<h4><a name="directoryfinetuning" id="directoryfinetuning">Configuration avancée des
répertoires d'installation</a></h4>
<p>Pour une définition plus précise des répertoires
d'installation, utilisez les options ci-dessous. Notez que les
répertoires par défaut sont définis par <code>autoconf</code>, et
que leurs valeurs sont écrasées par les valeurs correspondantes
définies lors du choix de l'organisation des répertoires
(layout).</p>
<dl>
<dt><code>--bindir=<var>DIR</var></code></dt>
<dd>Installe les exécutables utilisateur dans <var>DIR</var>.
Les exécutables utilisateur sont des programmes support comme
<code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>, <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code>,
etc..., et destinés aux administrateurs du site. Par défaut,
<var>DIR</var> est défini à
<code><var>EPREFIX</var>/bin</code>.</dd>
<dt><code>--datadir=<var>DIR</var></code></dt>
<dd>Installe les données non modifiables indépendantes de
l'architecture dans <var>DIR</var>. Par défaut,
<code>datadir</code> est défini à
<code><var>PREFIX</var>/share</code>. Cette option est fournie
par autoconf et actuellement inutilisée.</dd>
<dt><code>--includedir=<var>DIR</var></code></dt>
<dd>Installe les fichiers d'en-têtes C dans <var>DIR</var>. Par
défaut, <code>includedir</code> est défini à
<code><var>EPREFIX</var>/include</code>.</dd>
<dt><code>--infodir=<var>DIR</var></code></dt>
<dd>Installe la documentation info dans <var>DIR</var>. Par
défaut, <code>infodir</code> est défini à
<code><var>PREFIX</var>/info</code>. Cette option est
actuellement inutilisée.</dd>
<dt><code>--libdir=<var>DIR</var></code></dt>
<dd>Installe les fichiers objet des bibliothèques dans
<var>DIR</var>. Par défaut, <code>libdir</code> est défini à
<code><var>EPREFIX</var>/lib</code>.</dd>
<dt><code>--libexecdir=<var>DIR</var></code></dt>
<dd>Installe les exécutables du programme (autrement dit les
modules partagés) dans <var>DIR</var>. Par défaut,
<code>libexecdir</code> est défini à
<code><var>EPREFIX</var>/modules</code>.</dd>
<dt><code>--localstatedir=<var>DIR</var></code></dt>
<dd>Installe les données temporaires modifiables spécifiques à
la machine dans
<var>DIR</var>. Par défaut, <code>localstatedir</code> est
défini à <code><var>PREFIX</var>/var</code>. Cette option est
fournie par <code>autoconf</code> et est actuellement
inutilisée.</dd>
<dt><code>--mandir=<var>DIR</var></code></dt>
<dd>Installe les pages de manuel dans <var>DIR</var>. Par
défaut, <code>mandir</code> est défini à
<code><var>EPREFIX</var>/man</code>.</dd>
<dt><code>--oldincludedir=<var>DIR</var></code></dt>
<dd>Installe les fichiers d'en-têtes C pour les programmes
autres que gcc dans <var>DIR</var>. Par défaut,
<code>oldincludedir</code> est défini à
<code>/usr/include</code>. Cette option est fournie par
<code>autoconf</code> et est actuellement inutilisée.</dd>
<dt><code>--sbindir=<var>DIR</var></code></dt>
<dd>Installe les exécutables de l'administrateur système dans
<var>DIR</var>. Ce sont les programmes du serveur comme
<code class="program"><a href="../programs/httpd.html">httpd</a></code>, <code class="program"><a href="../programs/apachectl.html">apachectl</a></code>,
<code class="program"><a href="../programs/suexec.html">suexec</a></code>, etc..., qui sont nécessaires à
l'exécution du serveur HTTP Apache. Par défaut,
<code>sbindir</code> est défini à
<code><var>EPREFIX</var>/sbin</code>.</dd>
<dt><code>--sharedstatedir=<var>DIR</var></code></dt>
<dd>Installe les données modifiables indépendantes de
l'architecture dans <var>DIR</var>. Par défaut,
<code>sharedstatedir</code> est défini à
<code><var>PREFIX</var>/com</code>. Cette option est fournie par
<code>autoconf</code> et est actuellement inutilisée.</dd>
<dt><code>--sysconfdir=<var>DIR</var></code></dt>
<dd>Installe les données non modifiables spécifiques à la
machine comme les fichiers de configuration du serveur
<code>httpd.conf</code>, <code>mime.types</code>, etc... dans
<var>DIR</var>. Par défaut, <code>sysconfdir</code> est défini à
<code><var>PREFIX</var>/conf</code>.</dd>
</dl>
<h3><a name="systemtypes" id="systemtypes">Types de systèmes</a></h3>
<p>Ces options sont utilisées pour la cross-compilation du serveur
HTTP Apache afin de pouvoir l'utiliser sur un autre système. Dans le
cas général où la compilation et l'exécution du serveur ont lieu sur
le même système, ces options ne sont pas utilisées.</p>
<dl>
<dt><code>--build=<var>BUILD</var></code></dt>
<dd>Définit le type du système sur lequel les outils sont
compilés. Par défaut, il s'agit de la chaîne renvoyée par le
script <code>config.guess</code>.</dd>
<dt><code>--host=<var>HOST</var></code></dt>
<dd>Définit le type du système sur lequel le serveur s'exécutera.
Par défaut, <var>HOST</var> est identique à <var>BUILD</var>.</dd>
<dt><code>--target=<var>TARGET</var></code></dt>
<dd>Configure pour construire des compilateurs pour le type de
système <var>TARGET</var>. Par défaut, <var>TARGET</var> est
identique à <var>HOST</var>. Cette option est fournie par
<code>autoconf</code> et n'est pas requise par le serveur HTTP
Apache.</dd>
</dl>
<h3><a name="optionalfeatures" id="optionalfeatures">Fonctionnalités
optionnelles</a></h3>
<p>Ces options vous permettent de configurer avec précision les
fonctionnalités de votre futur serveur HTTP.</p>
<h4><a name="generaloptfeat" id="generaloptfeat">Syntaxe générale</a></h4>
<p>D'une manière générale, vous pouvez utiliser la syntaxe
suivante pour activer ou désactiver une fonctionnalité :</p>
<dl>
<dt><code>--disable-<var>FONCTIONNALITE</var></code></dt>
<dd>Désactive la fonctionnalité <var>FONCTIONNALITE</var>.
Identique à
<code>--enable-<var>FONCTIONNALITE</var>=no</code>.</dd>
<dt><code>--enable-<var>FONCTIONNALITE</var>[=<var>ARG</var>]</code></dt>
<dd>Active la fonctionnalité <var>FONCTIONNALITE</var>. La
valeur par défaut de <var>ARG</var> est <code>yes</code>.</dd>
<dt><code>--enable-<var>MODULE</var>=shared</code></dt>
<dd>Le module spécifié sera compilé en tant que module DSO. Par
défaut, les modules activés sont liés dynamiquement.</dd>
<dt><code>--enable-<var>MODULE</var>=static</code></dt>
<dd>Le module correspondant sera lié statiquement.</dd>
</dl>
<div class="note"><h3>Note</h3>
Si vous spécifiez <code>--enable-<var>foo</var></code>, et si
<var>foo</var> n'existe pas, <code>configure</code> ne le
signalera pas ; vous devez donc prendre soin de taper les
options correctement.
</div>
<h4><a name="choosemodules" id="choosemodules">Choix des modules à compiler</a></h4>
<p>La plupart des modules sont compilés par défaut et ils doivent être
désactivés de manière explicite ou via le mots-clé <code>few</code> (voir
ci-dessous <code>--enable-modules</code>,
<code>--enable-mods-shared</code> et <code>--enable-mods-static</code>
pour une explication plus détaillée), ou
<code>--enable-modules=none</code> pour les désactiver tous.</p>
<p>Par défaut, les autres modules ne sont pas compilés et doivent
être activés explicitement, ou en utilisant les mots-clés
<code>all</code> ou <code>reallyall</code> pour être disponibles.</p>
<p>Pour déterminer quels modules sont compilés par défaut,
exécutez la commande <code>./configure -h</code> ou
<code>./configure --help</code>, et consultez les <code>Optional
Features</code>. Par exemple, supposons que vous soyez intéressé
par les modules <code>mod_example1</code> et
<code>mod_example2</code>, et que vous voyiez ceci :</p>
<div class="example"><pre>Optional Features:
...
--disable-example1 example module 1
--enable-example2 example module 2
...</pre></div>
<p>Le module <code>mod_example1</code> est ici activé par
défaut, et vous devez spécifier <code>--disable-example1</code>
si vous ne voulez pas le compiler. Par contre, le module
<code>mod_example2</code> est désactivé par défaut, et vous
devez spécifier <code>--enable-example2</code> si vous voulez le
compiler.</p>
<h4><a name="mpms" id="mpms">Modules Multi-Processus</a></h4>
<p>Les <a href="../mpm.html">Modules Multi-Processus</a>, ou MPMs,
constituent le coeur du serveur. Un seul MPM doit être actif pour
que le serveur puisse fonctionner. Vous trouverez la liste des
MPMs disponibles à <a href="../mod/">module index page</a>.</p>
<p>Les MPMs peuvent être compilés en tant que modules DSO pour un
chargement dynamique, ou liés statiquement avec le serveur, et
sont activés via les options suivantes :</p>
<dl>
<dt><code>--with-mpm=MPM</code></dt>
<dd>
<p>Sélectionne le MPM par défaut pour votre serveur. Si les
MPMs sont compilés en tant que modules DSO (voir
<code>--enable-mpms-shared</code>), cette option spécifie le
MPM qui sera chargé par défaut selon le fichier de
configuration. Dans le cas contraire, cette option spécifie le
seul MPM disponible qui sera lié statiquement avec le
serveur.</p>
<p>Si cette option est omise, c'est le <a href="../mpm.html#defaults">MPM par défaut</a> pour votre
système d'exploitation qui sera utilisé.</p>
</dd>
<dt><code>--enable-mpms-shared=<var>Liste de MPM</var></code></dt>
<dd>
<p>Définit une liste de MPMs à compiler en tant que modules
dynamiquement partagés (DSO). Un de ces modules doit être
chargé dynamiquement via la directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>.</p>
<p><var>Liste de MPM</var> est une liste, entourée
d'apostrophes, de noms de MPM séparés par des espaces. Par
exemple :</p>
<div class="example"><p><code>
--enable-mpms-shared='prefork worker'
</code></p></div>
<p>Vous pouvez aussi utiliser le mot-clé <code>all</code>, ce
qui aura pour effet de spécifier tous les MPMs qui supportent
le chargement dynamique sur la plate-forme considérée, et de
les compiler en tant que modules DSO. Par exemple :</p>
<div class="example"><p><code>
--enable-mpms-shared=all
</code></p></div>
</dd>
</dl>
<h4><a name="modules" id="modules">Modules tiers</a></h4>
<p>Pour ajouter des modules tiers, utilisez les options suivantes
:</p>
<dl>
<dt><code>--with-module=<var>type-module</var>:<var>fichier-module</var>[,
<var>type-module</var>:<var>fichier-module</var>]</code></dt>
<dd><p>Ajoute un ou plusieurs modules tiers à la liste des
modules liés statiquement. Le fichier source du module
<var>fichier-module</var> sera recherché dans le sous-répertoire
<var>type-module</var> de l'arborescence des sources de votre
serveur HTTP Apache. S'il ne l'y trouve pas,
<code>configure</code> considèrera <var>fichier-module</var>
comme un chemin de fichier absolu et essaiera de copier le
fichier source dans le sous-répertoire <var>type-module</var>.
Si ce sous-répertoire n'existe pas, il sera créé et un fichier
<code>Makefile.in</code> standard y sera enregistré.</p>
<p>Cette option est conçue pour ajouter de petits modules
externes ne comportant qu'un seul fichier source. Pour des
modules plus complexes, vous devrez lire la documentation du
fournisseur du module.</p>
<div class="note"><h3>Note</h3>
Si vous voulez compiler un module DSO (lié de manière
dynamique au lieu de statique), utilisez le programme
<code class="program"><a href="../programs/apxs.html">apxs</a></code>.</div>
</dd>
</dl>
<h4><a name="otheroptfeat" id="otheroptfeat">Options cumulatives et autres
options</a></h4>
<dl>
<dt><code>--enable-maintainer-mode</code></dt>
<dd>Active les avertissements de débogage et de compilation et
charge tous les modules compilés.</dd>
<dt><code>--enable-mods-shared=<var>LISTE-MODULES</var></code></dt>
<dd>
<p>Définit une liste de modules à activer et à compiler en
tant que modules dynamiques partagés. Cela signifie que ces
modules doivent être chargés dynamiquement en utilisant la
directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>.</p>
<p><var>LISTE-MODULES</var> est une liste, entourée
d'apostrophes, de noms de modules
séparés par des espaces. Les noms
des modules sont spécifiés sans le préfixe <code>mod_</code>.
Par exemple :</p>
<div class="example"><p><code>
--enable-mods-shared='headers rewrite dav'
</code></p></div>
<p>Vous pouvez aussi utiliser les mots-clés <code>reallyall</code>,
<code>all</code>, <code>most</code> et <code>few</code>. Par
exemple,</p>
<div class="example"><p><code>
--enable-mods-shared=most
</code></p></div>
<p>va compiler la plupart des modules en tant que modules DSO,</p>
<div class="example"><p><code>
--enable-mods-shared=few
</code></p></div>
<p>ne compilera qu'un jeu de modules de base.</p>
<p>Le jeu par défaut correspond au mot-clé <code>most</code>.</p>
<p>Les directives <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> correspondant aux
différents modules choisis sont automatiquement générées dans
le fichier de configuration principal. Par défaut, toutes ces
directives sont mises en commentaire, sauf pour les modules
requis ou ceux explicitement sélectionnés par un argument
<code>--enable-nom-module</code> du script configure. Vous
pouvez modifier le jeu de modules chargé en activant ou
désactivant les directives <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> dans le fichier
<code>httpd.conf</code>. En outre, les directives <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> peuvent être activées
pour tous les modules compilés via l'option
<code>--enable-load-all-modules</code> du script configure.</p>
</dd>
<dt><code>--enable-mods-static=<var>MODULE-LIST</var></code></dt>
<dd>Cette option produit le même effet que l'option
<code>--enable-mods-shared</code>, à l'exception que les modules
seront liés statiquement. Cela signifie que les modules
spécifiés seront toujours disponibles au cours du fonctionnement
de <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Ils n'ont pas besoin d'être chargés
via la directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>.</dd>
<dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
<dd>Cette option se comporte comme
<code>--enable-mods-shared</code>, et va aussi lier les modules
concernés dynamiquement. Le mot-clé spécial <code>none</code>
désactive la compilation de tous les modules.</dd>
<dt><code>--enable-v4-mapped</code></dt>
<dd>Permet aux sockets IPv6 de traiter les connexions IPv4.</dd>
<dt><code>--with-port=<var>PORT</var></code></dt>
<dd>Permet de définir le port que le programme
<code class="program"><a href="../programs/httpd.html">httpd</a></code> va écouter. Ce numéro de port est
utilisé lors de la génération du fichier de configuration
<code>httpd.conf</code>. Sa valeur par défaut est 80.</dd>
<dt><code>--with-program-name</code></dt>
<dd>Permet de définir un nom d'exécutable alternatif. Le nom par
défaut est <code>httpd</code>.</dd>
</dl>
<h3><a name="packages" id="packages">Paquets optionnels</a></h3>
<p>Ces options permettent de définir des paquets optionnels.</p>
<h4><a name="generalpackages" id="generalpackages">Syntaxe générale</a></h4>
<p>D'une manière générale, vous pouvez utiliser la syntaxe
suivante pour définir un paquet optionnel :</p>
<dl>
<dt><code>--with-<var>PAQUET</var>[=<var>ARG</var>]</code></dt>
<dd>Utilise le paquet <var>PAQUET</var>. La valeur par défaut de
<var>ARG</var> est <code>yes</code>.</dd>
<dt><code>--without-<var>PAQUET</var></code></dt>
<dd>N'utilise pas le paquet <var>PAQUET</var>. Cette option est
identique à <code>--with-<var>PAQUET</var>=no</code>. Elle est
fournie par <code>autoconf</code> mais n'est pas très utile pour
le serveur HTTP Apache.</dd>
</dl>
<h4><a name="packageopt" id="packageopt">Paquets spécifiques</a></h4>
<dl>
<dt><code>--with-apr=<var>REP</var>|<var>FICHIER</var></code></dt>
<dd>La <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">Bibliothèque pour la portabilité
d'Apache ou
Apache Portable Runtime</a> (APR) fait partie de la
distribution des sources de httpd et est compilée
automatiquement avec le serveur HTTP. Si vous voulez utiliser
une APR déjà installée à la place, vous devez indiquer à
<code>configure</code> le chemin du script
<code>apr-config</code>. Vous pouvez spécifier le chemin absolu
et le nom ou le répertoire d'installation de l'APR.
<code>apr-config</code> doit se trouver dans ce répertoire ou
dans le sous-repertoire <code>bin</code>.</dd>
<dt><code>--with-apr-util=<var>REP</var>|<var>FICHIER</var></code></dt>
<dd>Les utilitaires pour la Bibliothèque pour la portabilité
d'Apache ou Apache Portable Runtime Utilities (APU) font partie de la
distribution des sources de httpd et sont compilés
automatiquement avec le serveur HTTP. Si vous voulez utiliser
des APU déjà installés à la place, vous devez indiquer à
<code>configure</code> le chemin du script
<code>apu-config</code>. Vous pouvez spécifier le chemin absolu
et le nom ou le répertoire d'installation des APU.
<code>apu-config</code> doit se trouver dans ce répertoire ou
dans le sous-repertoire <code>bin</code>.</dd>
<dt><code>--with-ssl=<var>REP</var></code></dt>
<dd>Si <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> a été activé,
<code>configure</code> recherche une installation d'OpenSSL.
Vous pouvez définir le répertoire de la boîte à outils SSL/TLS à
la place.</dd>
<dt><code>--with-z=<var>REP</var></code></dt>
<dd><code>configure</code> recherche automatiquement une
bibliothèque <code>zlib</code> installée si la configuration de
vos sources en nécessite une (par exemple lorsque
<code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> est activé). Vous pouvez définir le
répertoire de la bibliothèque de compression à la place.</dd>
</dl>
<p>De nombreuses fonctionnalités du serveur HTTP Apache, y compris
les directives <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> DBM de
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> et <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>
utilisent une base de données simple
de la forme clé/valeur pour une recherche rapide d'informations.
SDBM, inclus dans les APU, est donc toujours disponible. Si vous
souhaitez utiliser d'autres types de bases de données, utilisez
les options suivantes afin de les activer :</p>
<dl>
<dt><code>--with-gdbm[=<var>chemin</var>]</code></dt>
<dd>Si aucun <var>chemin</var> n'est spécifié,
<code>configure</code> va rechercher les fichiers d'en-têtes et
les bibliothèques d'une installation DBM GNU dans les chemins
standards. Avec un <var>chemin</var> explicite,
<code>configure</code> recherchera les fichiers concernés dans
<code><var>chemin</var>/lib</code> et
<code><var>chemin</var>/include</code>. En fait,
<var>chemin</var> permet de spécifier plusieurs chemins
d'en-têtes et bibliothèques spécifiques en les séparant par des
caractères ':'.</dd>
<dt><code>--with-ndbm[=<var>chemin</var>]</code></dt>
<dd>Identique à <code>--with-gdbm</code>, mais recherche une
installation de New DBM.</dd>
<dt><code>--with-berkeley-db[=<var>chemin</var>]</code></dt>
<dd>Identique à <code>--with-gdbm</code>, mais recherche une
installation de Berkeley DB.</dd>
</dl>
<div class="note"><h3>Note</h3>
<p>Les options DBM sont fournies par les APU et passées en
paramètres à son script de configuration. Elles sont inutiles
lorsqu'on utilise des APU déjà installés définis par
<code>--with-apr-util</code>.</p>
<p>Vous pouvez utiliser plusieurs implémentations DBM avec votre
serveur HTTP. Le type DBM approprié sera choisi au cours de la
configuration de l'exécution à chaque démarrage.</p>
</div>
<h3><a name="supportopt" id="supportopt">Options pour les programmes de
support</a></h3>
<dl>
<dt><code>--enable-static-support</code></dt>
<dd>Permet de compiler une version des binaires de support liés
statiquement. En d'autres termes, la compilation produira un
exécutable indépendant comportant toutes les bibliothèques
nécessaires. Sans cette option, les binaires de supports sont liés
dynamiquement.</dd>
<dt><code>--enable-suexec</code></dt>
<dd>Utilisez cette option pour activer la programme
<code class="program"><a href="../programs/suexec.html">suexec</a></code>, qui vous permet de définir un uid et un
gid pour les processus lancés. <strong>N'utilisez cette option que
si vous maîtrisez toutes les implications en matière de sécurité
de l'exécution d'un binaire suid sur votre serveur.</strong>
D'autres options permettent de configurer
<code class="program"><a href="../programs/suexec.html">suexec</a></code> comme décrit <a href="#suexec">ci-dessous</a>.</dd>
</dl>
<p>Il est possible de lier statiquement le binaire d'un programme
support particulier en utilisant les options suivantes :</p>
<dl>
<dt><code>--enable-static-ab</code></dt>
<dd>Compile une version liée statiquement du programme
<code class="program"><a href="../programs/ab.html">ab</a></code>.</dd>
<dt><code>--enable-static-checkgid</code></dt>
<dd>>Compile une version liée statiquement du programme
<code>checkgid</code>.</dd>
<dt><code>--enable-static-htdbm</code></dt>
<dd>Compile une version liée statiquement du programme <code class="program"><a href="../programs/htdbm.html">htdbm</a></code>.</dd>
<dt><code>--enable-static-htdigest</code></dt>
<dd>Compile une version liée statiquement du programme <code class="program"><a href="../programs/htdigest.html">htdigest</a></code>.</dd>
<dt><code>--enable-static-htpasswd</code></dt>
<dd>Compile une version liée statiquement du programme <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>.</dd>
<dt><code>--enable-static-logresolve</code></dt>
<dd>Compile une version liée statiquement du programme <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>.</dd>
<dt><code>--enable-static-rotatelogs</code></dt>
<dd>Compile une version liée statiquement du programme <code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code>.</dd>
</dl>
<h4><a name="suexec" id="suexec">Options de configuration de <code>suexec</code></a></h4>
<p>Les options suivantes permettent de définir avec précision le
comportement du programme <code class="program"><a href="../programs/suexec.html">suexec</a></code>. Voir <a href="suexec.html#install">Configurer et installer suEXEC</a>
pour plus de détails.</p>
<dl>
<dt><code>--with-suexec-bin</code></dt>
<dd>Définit le chemin du binaire <code class="program"><a href="../programs/suexec.html">suexec</a></code>. La
valeur par défaut est <code>--sbindir</code> (voir <a href="#directoryfinetuning">Définition précise des répertoires
d'installation</a>).</dd>
<dt><code>--with-suexec-caller</code></dt>
<dd>Définit l'utilisateur qui a l'autorisation d'appeler
<code class="program"><a href="../programs/suexec.html">suexec</a></code>. Il est en général souhaitable que ce
soit le même que celui sous lequel <code class="program"><a href="../programs/httpd.html">httpd</a></code>
s'exécute.</dd>
<dt><code>--with-suexec-docroot</code></dt>
<dd>Définit l'arborescence des répertoires dans laquelle le
lancement des exécutables via <code class="program"><a href="../programs/suexec.html">suexec</a></code> est
autorisé. La valeur par défaut est
<code>--datadir/htdocs</code>.</dd>
<dt><code>--with-suexec-gidmin</code></dt>
<dd>Définit la valeur de GID la plus basse autorisée comme
valeur cible pour <code class="program"><a href="../programs/suexec.html">suexec</a></code>. La valeur par
défaut est 100.</dd>
<dt><code>--with-suexec-logfile</code></dt>
<dd>Définit le nom du fichier journal de
<code class="program"><a href="../programs/suexec.html">suexec</a></code>. La valeur par défaut est
<code>--logfiledir/suexec_log</code>.</dd>
<dt><code>--with-suexec-safepath</code></dt>
<dd>Définit la valeur de la variable d'environnement
<code>PATH</code> pour les processus lancés par
<code class="program"><a href="../programs/suexec.html">suexec</a></code>. La valeur par défaut est
<code>/usr/local/bin:/usr/bin:/bin</code>.</dd>
<dt><code>--with-suexec-userdir</code></dt>
<dd>Définit le sous-répertoire du répertoire utilisateur qui
contient tous les exécutables pouvant être lancés par
<code class="program"><a href="../programs/suexec.html">suexec</a></code>. Cette option est nécessaire si vous
souhaitez utiliser <code class="program"><a href="../programs/suexec.html">suexec</a></code> avec des
répertoires utilisateurs (définis via
<code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>). La valeur par défaut est
<code>public_html</code>.</dd>
<dt><code>--with-suexec-uidmin</code></dt>
<dd>Définit la valeur d'UID la plus basse autorisée comme
valeur cible pour <code class="program"><a href="../programs/suexec.html">suexec</a></code>. La valeur par
défaut est 100.</dd>
<dt><code>--with-suexec-umask</code></dt>
<dd>Définit le masque de permissions <code>umask</code> pour les
processus lancés par <code class="program"><a href="../programs/suexec.html">suexec</a></code>. Il correspond
par défaut au masque défini par la configuration de votre
système.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="env" id="env">Variables d'environnement</a></h2>
<p>Certaines variables d'environnement permettent de modifier les
choix effectués par <code>configure</code>, ou d'aider ce dernier à
trouver les bibliothèques et programmes possédant des noms et chemins
non standards.</p>
<dl>
<dt><code>CC</code></dt>
<dd>Définit la commande du compilateur C à utiliser pour la
compilation.</dd>
<dt><code>CFLAGS</code></dt>
<dd>Définit les paramètres du compilateur C que vous voulez utiliser
pour la compilation.</dd>
<dt><code>CPP</code></dt>
<dd>Définit la commande du préprocesseur C à utiliser.</dd>
<dt><code>CPPFLAGS</code></dt>
<dd>Définit les paramètres du préprocesseur C/C++, par exemple
<code>-I<var>répertoire-include</var></code>, si certains de vos
fichiers d'en-têtes se trouvent dans le répertoire non standard
<var>répertoire-include</var>.</dd>
<dt><code>LDFLAGS</code></dt>
<dd>Définit les paramètres de l'éditeur de liens, par exemple
<code>-L<var>répertoire-lib</var></code>, si certaines de vos
bibliothèques se trouvent dans le répertoire non standard
<var>répertoire-lib</var>.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/configure.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/configure.html" title="Français"> fr </a> |
<a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/configure.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/configure.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htpasswd.html.tr.utf8 0000664 0001751 0001751 00000045045 14743132254 022732 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htpasswd - Temel kimlik doğrulama dosyalarını yönetir - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>htpasswd - Temel kimlik doğrulama dosyalarını yönetir</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/htpasswd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htpasswd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htpasswd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htpasswd.html" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Bu çeviri güncel olmayabilir. Son değişiklikler için İngilizce sürüm geçerlidir.</div>
<p><code><strong>htpasswd</strong></code>, HTTP kullanıcılarının temel
kimlik doğrulaması için kullanıcı isimlerinin ve parolalarının
saklanmasında kullanılacak düz metin dosyalarını oluşturmak ve güncellemek
için kullanılır. <code><strong>htpasswd</strong></code>, güncelleme
sırasında yazmak veya okumak için bir dosyaya erişemezse beklenen hiçbir
işlemi yapmaz ve hata vererek çıkar.</p>
<p>Apache HTTP sunucusunun mevcut özkaynaklarının kullanımı
sadece <code><strong>htpasswd</strong></code> tarafından oluşturulan
dosyalarda listelenmiş kullanıcılara tahsis edilebilir.
<code><strong>htpasswd</strong></code> sadece düz metin dosyalarda
saklanmış kullanıcı isimlerini ve parolalarını yönetirse de, diğer veri
saklama türleri için parolayı şifreleyip gösterebilir. Bir DBM veritabanı
kullanmak isterseniz <strong><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></strong> ve
<strong><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></strong> sayfasına bakınız.</p>
<p><code><strong>htpasswd</strong></code>, parolaları şifrelemek için
bcrypt, Apache'nin kendine özgü MD5 algoritması, SHA1 ya da sistemin
<code>crypt()</code> yordamını kullanır. Bu bakımdan
<code><strong>htpasswd</strong></code> tarafından yönetilen dosyalar farklı
algoritmalarla şifrelenmiş parolalar içerebilir.</p>
<p>Bu kılavuz sayfası sadece komut satırı değiştirgelerini listeler.
Kullanıcı kimlik doğrulamasını
<strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong>'de yapılandırmak için gerekli
yönergelerle ilgili ayrıntılar için Apache dağıtımının bir parçası olan
ve <a href="http://httpd.apache.org/"> http://httpd.apache.org/</a>
adresinde de bulunan Apache HTTP Sunucusu Belgelerine bakınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">Çıkış Durumu</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Örnekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Güvenlik Değerlendirmeleri</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#restrictions">Kısıtlamalar</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></li><li>Kaynak paketinin support/SHA1 dizinindeki betikler.</li><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>htpasswd</strong>
[ -<strong>c</strong> ]
[ -<strong>i</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>bedel</var> ]
[ -<strong>D</strong> ]
[ -<strong>v</strong> ] <var>parola-dosyası</var> <var>kullanıcı</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>b</strong>
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>bedel</var> ]
[ -<strong>D</strong> ]
[ -<strong>v</strong> ] <var>parola-dosyası</var> <var>kullanıcı</var>
<var>parola</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>n</strong>
[ -<strong>i</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>bedel</var> ] <var>kullanıcı</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>nb</strong>
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>bedel</var> ] <var>kullanıcı</var>
<var>parola</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code><strong>-b</strong></code></dt>
<dd>Betik kipi; parola için istek yapmak yerine parola komut satırından
verilir. <strong>Parola komut satırında görünür</strong> olacağından çok
dikkatli kullanmak gerekir. Betik kullanımı için
<code><strong>-i</strong></code> seçeneğine bakınız.
2.4.4 ve sonraki sürümler içindir.</dd>
<dt><code><strong>-i</strong></code></dt>
<dd>Parolayı doğrulamaksızın standart girdiden okur (betik kullanımı
için).</dd>
<dt><code><strong>-c</strong></code></dt>
<dd><code><var>parola-dosyası</var></code> oluşturur. Dosya mevcutsa,
dosya silinip yeniden yazılır. Bu seçenek
<code><strong>-n</strong></code> seçeneği ile birlikte kullanılamaz.</dd>
<dt><code><strong>-n</strong></code></dt>
<dd>Sonuçları veritabanında güncellemek yerine standart çıktıya gönderir.
Bu seçenek, Apache'nin metin veriler içermeyen veri depolarına dahil
edilebilecek parolaları üretmekte yararlıdır.
<code><var>parola-dosyası</var></code> belirtilmediğinden, bu seçenek
komut satırı sözdizimini değiştirir. Bu seçenek
<code><strong>-c</strong></code> seçeneği ile birlikte kullanılamaz.</dd>
<dt><code><strong>-m</strong></code></dt>
<dd>Parolalar için MD5 şifrelemesi kullanılır.
Bu 2.2.18 sürümünden beri öntanımlıdır.</dd>
<dt><code><strong>-B</strong></code></dt>
<dd>Parolalar için bcrypt şifrelemesi kullanılır. Şu an için çok güvenli
kabul edilmektedir.</dd>
<dt><code><strong>-C</strong> <var>bedel</var></code></dt>
<dd>Bu seçenek sadece <code><strong>-B</strong></code> (bcrypt şifrelemesi)
seçeneği ile birlikte kullanılabilir. Bcrypt algoritmasına hesaplama
süresini belirtir (daha yüksek değerler daha güvenlidir, öntanımlı 5,
geçerli değerler: 4 - 17).</dd>
<dt><code><strong>-d</strong></code></dt>
<dd>Parolaları şifrelemek için <code>crypt()</code> kullanılır.
<code><strong>htpasswd</strong></code> tarafından tüm platformlarda
destekleniyor olsa da Windows, Netware ve TPF üzerinde
<code class="program"><a href="../programs/httpd.html">httpd</a></code> sunucusu tarafından desteklenmez. Bu algoritma
günümüz standartlarında <strong>güvenilmez</strong> kabul
edilmektedir. 2.2.17 sürümüne kadar öntanımlı algoritma olarak
kullanılmıştı.</dd>
<dt><code><strong>-s</strong></code></dt>
<dd>Parolalar için SHA şifrelemesi kullanılır. LDAP Dizin değişim
biçemini (ldif) kullanarak Netscape sunucularına/sunucularından göçü
kolaylaştırır.Bu algoritma günümüz standartlarında
<strong>güvenilmez</strong> kabul edilmektedir.</dd>
<dt><code><strong>-p</strong></code></dt>
<dd>Düz metin parolalar kullanılır. <code><strong>htpasswd</strong></code>
tarafından tüm platformlarda destekleniyor olsa da Windows, Netware ve
TPF üzerinde <code class="program"><a href="../programs/httpd.html">httpd</a></code> sunucusu tarafından sadece düz
metin parolalar kabul edilir.</dd>
<dt><code><strong>-D</strong></code></dt>
<dd>Kullanıcıyı siler. Kullanıcı belirtilen dosyada mevcutsa
silinir.</dd>
<dt><code>-v</code></dt>
<dd>Parolayı doğrular. Verilen parolayı belitilen htpasswd dosyasında
saklanan kullanıcı parolası ile karşılaştırarak doğrulama yapar.
2.4.5 ve sonraki sürümler içindir.</dd>
<dt><code><var>parola-dosyası</var></code></dt>
<dd>Kullanıcı ismini ve parolasını içeren dosyanın ismi.
<code><strong>-c</strong></code> seçeneği verilmişse ve dosya mevcut
değilse oluşturulur, dosya mevcutsa silinip yeniden oluşturulur.</dd>
<dt><code><var>kullanıcı</var></code></dt>
<dd><code><var>parola-dosyası</var></code>'nda oluşturulacak veya
güncellenecek kullanıcı ismi. <code><var>kullanıcı</var></code> bu
dosyada mevcut değilse yeni bir girdi eklenir. Girdi mevcutsa parolası
değiştirilir.</dd>
<dt><code><var>parola</var></code></dt>
<dd>Şifrelenip dosyada saklanacak düz metin parola. Sadece
<code><strong>-b</strong></code> seçeneği ile kullanılır.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">Çıkış Durumu</a></h2>
<p><code><strong>htpasswd</strong></code>, kullanıcı ismi ve parolasını DBM
dosyasına başarıyla eklemiş veya güncellemişse <code>0</code>, dosyalara
erişirken bir sorun çıkmışsa <code>1</code>, komut satırında bir
sözdizimi hatası varsa <code>2</code>, parola etkileşimli alınmış fakat
girdi ile eşleşme sağlanamamışsa <code>3</code>, işlem kesintiye
uğramışsa <code>4</code>, bir değer çok uzunsa <code>5</code> (kullanıcı,
parola, dosya ismi veya açıklama), kullanıcı ismi kuraldışı karakter
içeriyorsa (<a href="#restrictions">Kısıtlamalar</a> bölümüne bakınız)
<code>6</code> ve dosya geçerli bir DBM parola dosyası değilse
<code>7</code> değeriyle döner.</p>
</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">Örnekler</a></h2>
<div class="example"><p><code>
htpasswd /usr/local/etc/apache/.htpasswd-users jsmith
</code></p></div>
<p><code>jsmith</code> kullanıcısı için parolayı ekler veya değiştirir.
Parolayı vermesi için kullanıcıya parola isteği yapılır.
Parola takviyeli Apache MD5 algoritması ile şifrelenir. Dosya mevcut
değilse <code><strong>htpasswd</strong></code> beklenen hiçbir işlemi
yapmadan bir hata vererek çıkar.</p>
<div class="example"><p><code>
htpasswd -c /home/doe/public_html/.htpasswd jane
</code></p></div>
<p>Yeni bir dosya oluşturur ve kullanıcı <code>jane</code> için kaydı bir
girdi olarak bu dosyaya yazar. Dosya mevcutsa fakat okunamıyor veya
yazılamıyorsa dosyada bir değişiklik yapılmaz ve
<code><strong>htpasswd</strong></code> bir ileti gösterip bir hata durumu
ile çıkar.</p>
<div class="example"><p><code>
htpasswd -db /usr/web/.htpasswd-all jones Pwd4Steve
</code></p></div>
<p>Komut satırından verilen parolayı (<code>Pwd4Steve</code>) <code>crypt()</code>
algoritmasıyla şifreler ve bunu belirtilen dosyada saklar.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Güvenlik Değerlendirmeleri</a></h2>
<p><code><strong>htpasswd</strong></code> tarafından yönetilen parola
dosyalarına sunucunun URI uzayından erişilememelidir; yani dosya bir
tarayıcı ile okunabilecek bir yerde bulunmamalıdır.</p>
<p>Bu program bir setuid çalıştırılabiliri olarak güvenilir olmadığından
<em>setuid yapılmamalıdır</em>.</p>
<p>Komut satırında parolanın şifrelenmemiş olarak görünmesi sebebiyle
<code><strong>-b</strong></code> seçeneğinin kullanımından kaçınılmasını
öneriyoruz.</p>
<p><code>crypt()</code> algoritması kullanılırken, parolayı
şekillendirmek için parolanın ilk 8 baytının kullanılacağına dikkat
ediniz. Eğer parola 8 bayttan uzunsa kalanlar bir uyarı verilmeksizin
iptal edilir.</p>
<p>SHA şifreleme biçeminde tuz kullanılmaz; yani, bir parolanın
sadece bir şifreli gösterimi olabilir. <code>crypt()</code> ve
MD5 biçemleri parolanın önüne rasgele üretilmiş bir tuz dizgesi
eklediklerinden sözlük saldırılarına karşı daha dayanıklıdırlar.</p>
<p>SHA ve <code>crypt()</code> biçimleri günümüz standartlarında
<strong>güvenilmez</strong> kabul edilmektedir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="restrictions" id="restrictions">Kısıtlamalar</a></h2>
<p>Windows platformuda, <code><strong>htpasswd</strong></code>
ile şifrelenen parolalar <code>255</code> karakterden daha uzun olamaz.
255 karakterden sonrası kırpılır.</p>
<p><code><strong>htpasswd</strong></code> tarafından kullanılan MD5
algoritması Apache yazılımına özeldir; bu algoritma ile şifrelenen
parolalar başka HTTP sunucularında kullanılamayabilir.</p>
<p>Kullanıcı isimleri <code>255</code> bayttan uzun olamaz ve iki nokta
imi (<code>:</code>) içeremez.</p>
<p>Bir bcrypt parolasının karma değerini hesaplamanın maliyeti,
<code>-C</code> seçeneğinde belirtilen tur sayısı ile artar.
<code>apr-util</code> kitaplığının <code>1.6.0</code> ve sonraki
sürümleri için azami tur sayısı 17 ile sınırlıdır.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/htpasswd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htpasswd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htpasswd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htpasswd.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htpasswd.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htcacheclean.html.tr.utf8 0000664 0001751 0001751 00000036145 14743132254 023500 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htcacheclean - Disk arabelleğini temizler - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>htcacheclean - Disk arabelleğini temizler</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htcacheclean.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htcacheclean.html" title="Türkçe"> tr </a></p>
</div>
<p><code><strong>htcacheclean</strong></code>,
<code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> deposunun boyutlarını belli sınırlar
içinde veya kullanımdaki dosya düğümlerinin sınırları içinde tutmak için
kullanılır. Bu araç ya elle ya da bir artalan süreci
olarak çalıştırılır. Artalan süreci olarak çalıştırıldığında, silinecek
arabellek içeriğini tespit etmek için arabellek dizinlerine belli
aralıklarla bakmak dışında uykuda olur. Artalan sürecini temiz olarak
durdurmak için TERM veya INT sinyali göndermeniz yeterlidir. Elle
çalıştırıldığında, silinecek arabellek içeriğini tespit etmek için
arabellek dizinlerine bir kereliğine bakar. Bir veya daha fazla URL
belirtilmesi durumunda arabellekte olanlar arabellekten silinir.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#delete">Belli bir URL'nin silinmesi</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#list">Arabellekteki URL'lerin listelenmesi</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">Çıkış Durumu</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code></li><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>htcacheclean</strong>
[ -<strong>D</strong> ]
[ -<strong>v</strong> ]
[ -<strong>t</strong> ]
[ -<strong>r</strong> ]
[ -<strong>n</strong> ]
[ -<strong>R</strong><var>boyut</var> ]
-<strong>p</strong><var>yol</var>
[ -<strong>l</strong><var>sınır</var> |
[ -<strong>L</strong><var>sınır</var> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>n</strong> ]
[ -<strong>t</strong> ]
[ -<strong>i</strong> ]
[ -<strong>P</strong><var>piddosyası</var> ]
[ -<strong>R</strong><var>boyut</var> ]
-<strong>d</strong><var>süre</var>
-<strong>p</strong><var>yol</var>
[ -<strong>l</strong><var>sınır</var> |
[ -<strong>L</strong><var>sınır</var> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>v</strong> ]
[ -<strong>R</strong><var>boyut</var> ]
-<strong>p</strong><var>yol</var>
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>D</strong> ]
[ -<strong>v</strong> ]
[ -<strong>t</strong> ]
[ -<strong>R</strong><var>boyut</var> ]
-<strong>p</strong><var>yol</var>
<var>url</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code><strong>-d</strong><var> süre</var></code></dt>
<dd>Artalanda çalışarak <code><var>süre</var></code> dakikada bir
arabelleği temizler. Bu seçenek <code><strong>-D</strong></code>,
<code><strong>-v</strong></code> ve <code><strong>-r</strong></code>
seçenekleri ile birlikte kullanılamaz. Artalan sürecini temiz olarak
sonlandırmak için <code>SIGTERM</code> veya <code>SIGINT</code> göndermek
yeterlidir.</dd>
<dt><code><strong>-D</strong></code></dt>
<dd>Kuru kuruya çalışıp, hiçbir şeyi silmez.
<code><strong>-d</strong></code> seçeneği ile birlikte kullanılamaz. Kuru
çalıştırma sırasında <code><strong>-t</strong></code> seçeneği ile dizinler
silinmek istenirse, statlarda silinmiş görünen dosya düğümleri silinmiş
dizinler olarak hesaba katılmaz ve tahmini olarak imlenir.</dd>
<dt><code><strong>-v</strong></code></dt>
<dd>Çıktı daha ayrıntılı olur. <code><strong>-d</strong></code> seçeneği
ile birlikte kullanılamaz.</dd>
<dt><code><strong>-r</strong></code></dt>
<dd>İyice temizlik yapılır. Bunun için Apache HTTP sunucusunun
çalışmadığı varsayılır (aksi takdirde arabellek içeriği bozulabilir).
<code><strong>-t</strong></code> seçeneğinin de uygulanmasını sağlar.
<code><strong>-d</strong></code> seçeneği ile birlikte kullanılamaz.</dd>
<dt><code><strong>-n</strong></code></dt>
<dd>Nazik olur. Diğer süreçlerin yararına daha yavaş çalışır. (a) disk
G/Ç işlemlerinde gecikmeler olursa ve (b) çekirdek bu arada başka bir
süreci öne çekmişse <code><strong>htcacheclean</strong></code> uyumayı
tercih edecektir.</dd>
<dt><code><strong>-t</strong></code></dt>
<dd>Tüm boş dizinleri siler. Öntanımlı olarak, sadece arabellek dosyaları
silinirse de bazı yapılandırmalarda büyük miktarda dizin oluşturulması bu
seçeneğin kullanılmasını gerektirebilir. Yapılandırmanız çok sayıda dizin
gerektiriyorsa ve dosya düğümlerinin veya dosya ayırma tablolarının
tükenmesi sözkonusu ise bu seçeneğin kullanılması önerilir.</dd>
<dt><code><strong>-p</strong><var> yol</var></code></dt>
<dd><code><var>yol</var></code>, disk arabelleğinin kök dizini olarak
belirtilir. <code class="directive"><a href="../mod/mod_cache_disk.html#cacheroot">CacheRoot</a></code>
yönergesinde belirtilen dizin olmalıdır.</dd>
<dt><code><strong>-P</strong><var>piddosyası</var></code></dt>
<dd>Artalan süreci olarak çalışmada süreç kimliğinin yazılacağı dosyanın
adını belirtmek için kullanılır.</dd>
<dt><code><strong>-R</strong><var>boyut</var></code></dt>
<dd>Disk bloklarının boyunu denkleştirmek için yuvarlanacak üst boyutu
belirtmekte kullanılır. Arabellek bölümünün blok boyutunu belirler.</dd>
<dt><code><strong>-l</strong><var> sınır</var></code></dt>
<dd><code><var>sınır</var></code>, disk arabelleğinin toplam boyutu
olarak belirtilir. Değerin öntanımlı olarak bayt cinsinden belirtileceği
varsayılır. Değerin sonuna kilobayt için <code>K</code>, megabayt
<code>M</code>, Gbayt için <code>G</code> harfi konulabilir.</dd>
<dt><code><strong>-L</strong><var>limit</var></code></dt>
<dd>Disk arabellek dosyası düğümü toplamının sınırını belirlemekte
kullanılır. Değerin sonuna kilobayt için <code>K</code>, megabayt
<code>M</code>, Gbayt için <code>G</code> harfi konulabilir.</dd>
<dt><code><strong>-i</strong></code></dt>
<dd>Akıllı olup sadece disk arabelleği değiştiği zaman çalışır. Bu
seçenek <code><strong>-d</strong></code> seçeneği ile birlikte
belirtilmek zorundadır.</dd>
<dt><code><strong>-a</strong></code></dt>
<dd>O an arabellekte saklanmakta olan URL'leri listeler. Birden fazla aynı
URL varsa yalnız biri listelenir.</dd>
<dt><code><strong>-A</strong></code></dt>
<dd>O an arabellekte saklanmakta olan URL'leri öznitelikleri ile listeler.
Öznitelikler şu sırayla verilir: url, header size, body size, status,
entity version, date, expiry, request time, response time, body present,
head request</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="delete" id="delete">Belli bir URL'nin silinmesi</a></h2>
<p><code><strong>htcacheclean</strong></code> tarafından aktarılan URL'ler
arabellekten silinir. Bir URL birden fazla mevcutsa hepsi silinir.</p>
<p>Ters vekilli bir URL silinmişse, etkin URL <strong>Host</strong> başlığı
<strong>port</strong>, <strong>yol</strong> ve <strong>sorgu</strong> ile
oluşturulur. Bir sorgu dizgesi olsun olmasın, URL içinde '?' daima açıkça
belirtilmelidir. Örneğin, <strong>localhost</strong> sunucusundaki
<strong>/</strong> yolu silinmek istenirse silinecek URL
<strong>http://localhost:80/?</strong> olurdu.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="list" id="list">Arabellekteki URL'lerin listelenmesi</a></h2>
<p><code><strong>htcacheclean</strong></code>'e
<code><strong>-a</strong></code> veya <code><strong>-A</strong></code>
seçeneğinin aktarılmasıyla, arabellekteki URL'ler bulundukça her satıra bir
URL gelecek biçemde listelenir. <code><strong>-A</strong></code> seçeneği
URL'nin ardından arabellek içeriğini tamamını şu sırayla dökümler:</p>
<dl>
<dt>url</dt><dd>Öğenin URL'si.</dd>
<dt>header size</dt><dd>Bayt cinsinden başlık uzunluğu.</dd>
<dt>body size</dt><dd>Bayt cinsinden gövde uzunluğu.</dd>
<dt>status</dt><dd>Arabellekteki yanıtın durumu.</dd>
<dt>entity version</dt><dd>Öğenin silinmeksizin kaç kere
doğrulandığı.</dd>
<dt>date</dt><dd>Yanıt tarihi.</dd>
<dt>expiry</dt><dd>Yanıtın zaman aşımı tarihi.</dd>
<dt>request time</dt><dd>İsteğin başlama zamanı.</dd>
<dt>response time</dt><dd>İsteğin bitiş zamanı.</dd>
<dt>body present</dt><dd>0 ise istekle birlikte gövde saklanmaz, 1 ise
saklanır.</dd>
<dt>head request</dt><dd>1 ise, öğe, gövde olmaksızın arabellekli bir
HEAD isteği içerir, 0 ise içermez.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">Çıkış Durumu</a></h2>
<p><code><strong>htcacheclean</strong></code>, tüm işlemler başarıyla
yerine getirildiğinde <code>0</code>, aksi takdirde <code>1</code>
döndürür. Bir URL belirtildiğinde, bu URL arablleklenmi ve silinmişse
<code>0</code>, aksi takdirde <code>2</code> döndürür. URL'nin silinmesi
sırasında bir hata oluşursa <code>1</code> döndürür.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htcacheclean.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htcacheclean.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htcacheclean.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htpasswd.html.ko.euc-kr 0000664 0001751 0001751 00000032663 14743132254 023220 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htpasswd - basic authentication
Ѵ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>htpasswd - basic authentication
Ѵ</h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/htpasswd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htpasswd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htpasswd.html" title="Korean"> ko </a> |
<a href="../tr/programs/htpasswd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>htpasswd</code> HTTP basic authentication
ڸ ȣ ϴ Ϲ ϰ Ѵ.
<code>htpasswd</code> ų ٸ,
¸ ȯϰ ƹ͵ ʴ´.</p>
<p>ġ ڿ <code>htpasswd</code> Ͽ
ڿԸ ִ. α ڸ
ȣ ϴ Ϲ Ѵ. ٸ ڷ
ȣ ȣȭϿ ִ. DBM
ͺ̽ Ϸ <a href="dbmmanage.html">dbmmanage</a> ϶.</p>
<p><code>htpasswd</code> ġ Ư MD5 Ȥ ý
<code>crypt()</code> Ͽ ȣ ȣȭѴ.
<code>htpasswd</code> ϴ ȣ
ִ. , Ͽ MD5 ȣȭ ȣ
ϴ ڿ <code>crypt()</code> ȣȭ ȣ
ϴ ִ.</p>
<p> manpage ɼǸ Ѵ. <a href="httpd.html">httpd</a> ϴ þ
ġ Եְ <a href="http://httpd.apache.org">http://httpd.apache.org/</a>
ִ ġ ϶.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">ڵ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Ȼ </a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#restrictions"></a></li>
</ul><h3></h3><ul class="seealso"><li><a href="httpd.html">httpd</a></li><li> SHA1 ϴ ũƮ ִ.</li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p><code><strong>htpasswd</strong>
[ -<strong>c</strong> ]
[ -<strong>m</strong> ]
[ -<strong>D</strong> ] <var>passwdfile</var> <var>username</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>b</strong>
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>d</strong> |
-<strong>p</strong> |
-<strong>s</strong> ]
[ -<strong>D</strong> ] <var>passwdfile</var> <var>username</var>
<var>password</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>n</strong>
[ -<strong>m</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ] <var>username</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>nb</strong>
[ -<strong>m</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ] <var>username</var> <var>password</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<dl>
<dt><code>-b</code></dt>
<dd>ġ(batch) 带 Ѵ. <em> </em>, ȣ
ʰ ´. <strong>ȣ
巯Ƿ</strong>, ɼ ſ ؼ ؾ
Ѵ.</dd>
<dt><code>-c</code></dt>
<dd><var>passwdfile</var> . <var>passwdfile</var>
̹ Ѵٸ, . ɼ <code>-n</code> ɼǰ
.</dd>
<dt><code>-n</code></dt>
<dd> ʰ ǥ Ѵ.
ġ ̿ ȣ Ҷ ϴ.
( ù° ƱԸƮ) <var>passwdfile</var> ƱԸƮ
ٸ. <code>-c</code> ɼǰ
.</dd>
<dt><code>-m</code></dt>
<dd>MD5 Ͽ ȣ ȣȭѴ. Windows, Netware,
TPF ⺻̴.</dd>
<dt><code>-d</code></dt>
<dd><code>crypt()</code> Ͽ ȣ ȣȭѴ.
Windows, Netware, TPF ÷ ⺻̴.
÷ <code>htpasswd</code>
, Windows, Netware, TPF <a href="httpd.html">httpd</a>
ʴ´.</dd>
<dt><code>-s</code></dt>
<dd>ȣ SHA ȣȭѴ. LDAP 丮ȯ(ldif)
Ͽ Netscape ų ö ϴ.</dd>
<dt><code>-p</code></dt>
<dd>ȣ ״ Ѵ. ÷ <code>htpasswd</code>
, Windows, Netware, TPF <a href="httpd.html">httpd</a>
Ϲ ȣ ´.</dd>
<dt><code>-D</code></dt>
<dd>ڸ Ѵ. htpasswd Ͽ ڸ ִٸ
Ѵ.</dd>
<dt><code><var>passwdfile</var></code></dt>
<dd>ڸ ȣ ϴ ϸ. <code>-c</code>
ٸ , ִٸ .</dd>
<dt><code><var>username</var></code></dt>
<dd><var>passwdfile</var> ų ڸ.
<var>username</var> Ͽ ٸ ߰Ѵ.
ִٸ ȣ Ѵ.</dd>
<dt><code><var>password</var></code></dt>
<dd>ȣȭϿ Ͽ ȣ. <code>-b</code>
ɼǰ ִ.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">ڵ</a></h2>
<p><code>htpasswd</code> <var>passwdfile</var> ڸ
ȣ ߰ϰų ("") ڵ
0 ȯѴ. <code>htpasswd</code> Ͽ Ҷ
<code>1</code>, ߸
<code>2</code>, Է ȣ Ȯ ٽ Է
ġ <code>3</code>, ߴܵ
<code>4</code>, (ڸ, ϸ, ȣ, )
ʹ <code>5</code>, ڸ ʴ
ڰ Ե <a href="#restrictions"> </a> )
<code>6</code>, ùٸ ȣ ƴ
<code>7</code> ȯѴ.</p>
</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>
<div class="example"><p><code>
htpasswd /usr/local/etc/apache/.htpasswd-users jsmith
</code></p></div>
<p> <code>jsmith</code> ȣ ߰ϰų Ѵ.
ڿ ȣ . Windows ýۿ ϸ
ȣ ġ Ư MD5 ˰ Ͽ ȣȭϰ,
ƴϸ ý <code>crypt()</code> Լ Ѵ.
ٸ <code>htpasswd</code> ƹ ϵ ʰ
.</p>
<div class="example"><p><code>
htpasswd -c /home/doe/public_html/.htpasswd jane
</code></p></div>
<p> Ͽ <code>jane</code>
߰Ѵ. ڿ ȣ . аų
ٸ, <code>htpasswd</code> ʰ
¸ ȯѴ.</p>
<div class="example"><p><code>
htpasswd -mb /usr/web/.htpasswd-all jones Pwd4Steve
</code></p></div>
<p> ȣ(<code>Pwd4Steve</code>) MD5 ˰
ȣȭϿ Ͽ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Ȼ </a></h2>
<p><code>htpasswd</code> ϴ ȣ
URI <em>ȵȴ</em>. ,
Ѵ.</p>
<p> ȣȭ ȣ ϱ <code>-b</code>
ɼ õ ʴ´.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="restrictions" id="restrictions"></a></h2>
<p>Windows MPE ÷ <code>htpasswd</code> ȣȭϴ
ȣ ̸ <code>255</code> ڷ Ѵ. ȣ
255ڿ ©.</p>
<p><code>htpasswd</code> ϴ MD5 ˰ ġ
Ʈ Ư ̴. ̸ Ͽ ȣȭ ȣ
ٸ .</p>
<p>ڸ <code>255</code> Ʈ ѵǰ <code>:</code>
ڸ .</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/htpasswd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htpasswd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htpasswd.html" title="Korean"> ko </a> |
<a href="../tr/programs/htpasswd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htpasswd.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/fcgistarter.html.tr.utf8 0000664 0001751 0001751 00000015231 14743132254 023404 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>fcgistarter - Bir FastCGI betiğini çalıştır - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>fcgistarter - Bir FastCGI betiğini çalıştır</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/fcgistarter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/fcgistarter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/fcgistarter.html" title="Türkçe"> tr </a></p>
</div>
<p />
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#note">Bilginize</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></li><li><a href="#comments_section">Yorumlar</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="note" id="note">Bilginize</a></h2>
<p>Şimdilik sadece Unix sistemlerinde çalışmaktadır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>fcgistarter</strong>
-<strong>c</strong> <var>komut</var>
-<strong>p</strong> <var>port</var>
[ -<strong>i</strong> <var>arabirim</var> ]
-<strong>N</strong> <var>sayı</var>
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code><strong>-c</strong> <var>komut</var></code></dt>
<dd>Çalıştırılacak FastCGI betiğinin mutlak yolu</dd>
<dt><code><strong>-p</strong> <var>port</var></code></dt>
<dd>Betiğin dinleyeceği port</dd>
<dt><code><strong>-i</strong> <var>arabirim</var></code></dt>
<dd>Betiğin dinleyeceği arabirim</dd>
<dt><code><strong>-N</strong> <var>sayı</var></code></dt>
<dd>Betik örneklerinin sayısı</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/fcgistarter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/fcgistarter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/fcgistarter.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/fcgistarter.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htdigest.html.ko.euc-kr 0000664 0001751 0001751 00000016364 14743132254 023176 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htdigest - digest authentication
Ѵ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>htdigest - digest authentication
Ѵ</h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/htdigest.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htdigest.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htdigest.html" title="Korean"> ko </a> |
<a href="../tr/programs/htdigest.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>htdigest</code> HTTP digest authentication
ڸ, , ȣ ϴ Ϲ
Ѵ. ġ ڿ <code>htdigest</code>
Ͽ ڿԸ ִ.</p>
<p> manpage ɼǸ Ѵ. <a href="httpd.html">httpd</a> digest authentication
ϴ þ ġ Եְ
<a href="http://httpd.apache.org">http://httpd.apache.org/</a>
ִ ġ ϶.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="httpd.html">httpd</a></li><li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p><code><strong>htdigest</strong> [ -<strong>c</strong> ]
<var>passwdfile</var> <var>realm</var> <var>username</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<dl>
<dt><code>-c</code></dt>
<dd><var>passwdfile</var> . <var>passwdfile</var>
̹ ִٸ .</dd>
<dt><code><var>passwdfile</var></code></dt>
<dd>ڸ, , ȣ ϸ. <code>-c</code>
ٸ , ִٸ
ٽ .</dd>
<dt><code><var>realm</var></code></dt>
<dd>ڸ ̸.</dd>
<dt><code><var>username</var></code></dt>
<dd><var>passwdfile</var> ų ڸ. Ͽ
<var>username</var> ٸ ߰Ѵ. ִٸ ȣ
Ѵ.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/htdigest.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htdigest.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htdigest.html" title="Korean"> ko </a> |
<a href="../tr/programs/htdigest.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htdigest.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htpasswd.html.fr.utf8 0000664 0001751 0001751 00000051576 14740503670 022723 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htpasswd - Gestion des fichiers d'utilisateurs pour
l'authentification de base - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>htpasswd - Gestion des fichiers d'utilisateurs pour
l'authentification de base</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htpasswd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htpasswd.html" title="Français"> fr </a> |
<a href="../ko/programs/htpasswd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htpasswd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>htpasswd</code> permet de créer et de maintenir les
fichiers textes où sont stockés les noms d'utilisateurs et mots de
passe pour l'authentification de base des utilisateurs HTTP. Si
<code>htpasswd</code> rencontre un problème d'accès à un fichier,
que ce soit pour écrire dans le fichier de sortie, ou pour lire le
fichier d'entrée dans le but de le mettre à jour, il renvoie un code
d'erreur et n'effectue aucune modification.</p>
<p>Il est possible de limiter l'accès aux ressources du serveur HTTP
Apache aux seuls utilisateurs présents dans les fichiers créés par
<code>htpasswd</code>. Ce programme ne sait gérer les noms
d'utilisateurs et mots de passe que s'ils sont stockés dans des
fichiers textes. Il peut cependant hacher et afficher les mots de
passe à des fins d'utilisation dans d'autres types de bases de
données. Pour utiliser une base de données DBM, voir le programme
<code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> ou <code class="program"><a href="../programs/htdbm.html">htdbm</a></code>.</p>
<p><code>htpasswd</code> hache les mots de passe en utilisant bcrypt, une
version de MD5 modifiée pour Apache, SHA-1 ou la routine système
<code>crypt()</code>. Les hachages de type SHA-2 (SHA-256 and SHA-512) sont
pris en charge pour <code>crypt()</code>. Les fichiers gérés par
<code>htpasswd</code> peuvent contenir un mélange de différents types de
codage des mots de passe ; par exemple, certaines entrées utilisateur
pourront comporter des mots de passe hachés avec bcrypt ou MD5, alors que
d’autres dans le même fichier pourront comporter des mots de passe hachés
avec <code>crypt()</code>.</p>
<p>Cette page de manuel ne décrit que les arguments de la ligne de
commande. Pour plus de détails à propos des directives nécessaires à
la configuration de l'authentification des utilisateurs dans
<code class="program"><a href="../programs/httpd.html">httpd</a></code>, voir le manuel Apache qui est fourni avec
la distribution ou peut être consulté à <a href="http://httpd.apache.org">http://httpd.apache.org/</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">Valeur renvoyée</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Considérations à propos de sécurité</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#restrictions">Restrictions</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></li><li>Les scripts fournis avec la distibution d'Apache et situés dans
support/SHA1.</li><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>htpasswd</strong>
[ -<strong>c</strong> ]
[ -<strong>i</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>2</strong> |
-<strong>5</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>r</strong> <var>rounds</var> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>D</strong> ]
[ -<strong>v</strong> ] <var>fichier-mots-de-passe</var> <var>nom-utilisateur</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>b</strong>
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>2</strong> |
-<strong>5</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>r</strong> <var>rounds</var> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>D</strong> ]
[ -<strong>v</strong> ] <var>fichier-mots-de-passe</var> <var>nom-utilisateur</var>
<var>mot-de-passe</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>n</strong>
[ -<strong>i</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>2</strong> |
-<strong>5</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>r</strong> <var>rounds</var> ]
[ -<strong>C</strong> <var>cost</var> ] <var>nom-utilisateur</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>nb</strong>
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>2</strong> |
-<strong>5</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>r</strong> <var>rounds</var> ]
[ -<strong>C</strong> <var>cost</var> ] <var>nom-utilisateur</var>
<var>mot-de-passe</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-b</code></dt>
<dd>Utilise le mode batch ; c'est à dire, extrait le mot de passe de
la ligne de commande au lieu de le demander à l'opérateur. Cette
option doit être utilisée avec la plus grande prudence, car
<strong>le mot de passe est visible en clair</strong> dans la ligne
de commande. Pour utiliser un script, voir l'option
<code>-i</code>.
Disponible à partir de la version 2.4.4 du serveur HTTP Apache.</dd>
<dt><code>-i</code></dt>
<dd>Lit le mot de passe depuis stdin sans vérification (à utiliser
dans les scripts).</dd>
<dt><code>-c</code></dt>
<dd>Crée le <var>fichier-mots-de-passe</var>. Si
<var>fichier-mots-de-passe</var> existe déjà, il est réécrit et
tronqué. Cette option ne peut pas être combinée avec l'option
<code>-n</code>.</dd>
<dt><code>-n</code></dt>
<dd>Affiche le résultat du traitement sur la sortie standard au lieu
de mettre à jour le fichier. Ceci peut s'avérer utile pour générer
des enregistrements de mots de passe qu'Apache pourra utiliser à des
fins d'inclusion dans des fichiers de données au format autre que
texte. Cette option modifie la syntaxe de la ligne de commande, car
l'argument <var>fichier-mots-de-passe</var> (en général le premier)
est omis. Elle ne peut pas être combinée avec l'option
<code>-c</code> option.</dd>
<dt><code>-m</code></dt>
<dd>Utilise le hachage MD5 pour les mots de passe. C'est le
comportement par défaut (depuis la version 2.2.18).</dd>
<dt><code>-2</code></dt>
<dd>Utilise les hachages SHA-256 basés sur <code>crypt()</code> pour les
mots de passe. Pris en charge sur la plupart des plateformes de style Unix.</dd>
<dt><code>-5</code></dt>
<dd>Utilise les hachages SHA-512 basés sur <code>crypt()</code> pour les
mots de passe. Pris en charge sur la plupart des plateformes de style Unix.</dd>
<dt><code>-B</code></dt>
<dd>Utilise bcrypt pour hacher les mots de passe. c'est un
algorythme de chiffrement actuellement considéré comme sûr.</dd>
<dt><code>-C</code></dt>
<dd>Ce drapeau n'est autorisé qu'en conjonction avec le drapeau
<code>-B</code> (hachage bcrypt). Il permet de définir la durée
de traitement pour l'algorytme bcrypt (plus elle est longue,
meilleure sera la sécurité, mais inférieure la rapidité). La valeur
par défaut est 5 et les valeurs autorisées vont de 4 à 17.</dd>
<dt><code>-r</code></dt>
<dd>Ce drapeau n’est autorisé qu’en combinaison avec les drapeaux
<code>-2</code> ou <code>-5</code>. Il permet de définir le nombre de passes
de hachage utilisé pour les algorithmes SHA-2 (un nombre élevé améliore la
sécurité mais le traitement est plus lent ; la valeur par défaut est 5000.</dd>
<dt><code>-d</code></dt>
<dd>Utilise le hachage <code>crypt()</code> pour les mots de
passe. Cette option n'est pas supportée par le
serveur <code class="program"><a href="../programs/httpd.html">httpd</a></code> sous Windows ou Netware. Cet
algorithme limite la longueur des mots de passe à 8 caractères ; il
est considéré comme <strong>non sur</strong> du point de vue des
standards actuels. C'était l'algorithme par défaut jusqu'à la
version 2.2.17.</dd>
<dt><code>-s</code></dt>
<dd>Utilise le hachage SHA-1 (160-bit) pour les mots de passe. Facilite la
migration vers/depuis les serveurs Netscape qui utilisent le format
LDAP Directory Interchange (ldif). Cet algorithme
est considéré comme <strong>non sûr</strong> du point de vue des
normes actuelles.</dd>
<dt><code>-p</code></dt>
<dd>Enregistre les mots de passe en clair. Bien que
<code>htpasswd</code> supporte la création des mots de passe en
clair sur toutes les plates-formes, le démon
<code class="program"><a href="../programs/httpd.html">httpd</a></code> n'accepte les mots de passe en clair que
sous Windows et Netware.</dd>
<dt><code>-D</code></dt>
<dd>Supprime un utilisateur, sous réserve qu'il existe dans le
fichier spécifié par htpasswd.</dd>
<dt><code>-v</code></dt>
<dd>Vérifie si le mot de passe fourni correspond au mot de passe de
l'utilisateur enregistré dans le fichier de mots de passe spécifié.
Disponible à partir de la version 2.4.5 du serveur HTTP Apache.</dd>
<dt><code><var>fichier-mots-de-passe</var></code></dt>
<dd>Le nom du fichier contenant les noms d'utilisateurs et mots de
passe. Avec l'option <code>-c</code>, le fichier est créé s'il
n'existe pas, ou réécrit et tronqué s'il existe déjà.</dd>
<dt><code><var>nom-utilisateur</var></code></dt>
<dd>Le nom d'utilisateur à créer ou mettre à jour dans le
<var>fichier-mots-de-passe</var>. Si <var>nom-utilisateur</var>
n'existe pas, une nouvelle entrée est ajoutée. Dans le cas
contraire, le mot de passe est modifié.</dd>
<dt><code><var>mot-de-passe</var></code></dt>
<dd>Le mot de passe en clair et destiné à être haché puis stocké
dans le fichier. Cet argument ne s'utilise qu'avec l'option
<code>-b</code>.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">Valeur renvoyée</a></h2>
<p><code>htpasswd</code> renvoie 0 ("true") si le nom d'utilisateur
et le mot de passe ont été enregistrés ou mis à jour avec succès
dans le <var>fichier-mots-de-passe</var>. <code>htpasswd</code>
renvoie <code>1</code> s'il a rencontré un problème d'accès aux
fichiers, <code>2</code> si la ligne de commande comportait une
erreur de syntaxe, <code>3</code> si le mot de passe entré
interactivement ne correspondait pas au nom d'utilisateur,
<code>4</code> si l'opération a été interrompue, <code>5</code> si
une valeur était trop longue (nom-utilisateur, nom-fichier,
mot-de-passe, ou l'enregistrement résultant), <code>6</code> si le
nom d'utilisateur contenait des caractères illégaux (voir la section
<a href="#restrictions">Restrictions</a>), et <code>7</code> si le
fichier spécifié n'était pas un fichier de mots de passe
valide.</p>
</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">Exemples</a></h2>
<div class="example"><p><code>
htpasswd /usr/local/etc/apache/.utilisateurs-htpasswd jsmith
</code></p></div>
<p>Ajoute ou modifie le mot de passe de l'utilisateur
<code>jsmith</code>. Le mot de passe est demandé à l'opérateur. Le
mot de passe sera haché en utilisant l'algorithme MD5
modifié pour Apache. Si le fichier spécifié
n'existe pas, <code>htpasswd</code> renverra un code d'erreur.</p>
<div class="example"><p><code>
htpasswd -c /home/doe/public_html/.htpasswd jane
</code></p></div>
<p>Crée un nouveau fichier de mots de passe et y enregistre une
entrée pour l'utilisateur <code>jane</code>. Le mot de passe est
demandé à l'opérateur. Si le fichier existe et ne peut être ni lu ni
écrit, il n'est pas modifié et <code>htpasswd</code> affichera un
message et renverra un code d'erreur.</p>
<div class="example"><p><code>
htpasswd -db /usr/web/.htpasswd-tous jones Pwd4Steve
</code></p></div>
<p>Chiffre le mot de passe spécifié dans la ligne de commande
(<code>Pwd4Steve</code>) en utilisant l'algorithme
<code>crypt()</code>, et le stocke dans le fichier spécifié.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Considérations à propos de sécurité</a></h2>
<p>Les fichiers de mots de passe Web comme ceux que gère
<code>htpasswd</code> ne doivent <em>pas</em> être situés dans
l'espace d'URI du serveur Web -- en d'autres termes, il ne doit pas
être possible d'y accéder à partir d'un navigateur.</p>
<p>En tant qu'exécutable setuid, ce programme n'est pas sûr, et il
ne faut par conséquent <em>pas</em> lui attribuer de permissions
setuid.</p>
<p>L'utilisation de l'option <code>-b</code> est déconseillée, car
avec elle, les mots de passe apparaissent en clair sur la ligne de
commande.</p>
<p>Notez qu'avec l'algorithme <code>crypt()</code>, seuls les huit
premiers caractères du mot de passe spécifié sont pris en compte. Si
le mot de passe spécifié est plus long, les caractères
supplémentaires sont ignorés.</p>
<p>Le format de hachage SHA-1 n'utilise pas d'amorçage aléatoire
(salting) : à un mot de passe donné correspond une seule
représentation hachée. Les formats <code>crypt()</code> et MD5
permutent la représentation en la préfixant par une chaîne d'amorce
aléatoire, afin de rendre les attaques de mots de passe à base de
dictionnaires plus difficiles.</p>
<p>Les algorithmes de chiffrement SHA-1 et <code>crypt()</code>
sont considérés comme <strong>non surs</strong> du point de vue des
standards actuels.</p>
<p>Les formats de <code>crypt()</code> basés sur SHA-2 (SHA-256 et SHA-512)
sont pris en charge sur la plupart des systèmes de style Unix récents et
respectent la spécification de <a href="https://www.akkadia.org/drepper/SHA-crypt.txt">https://www.akkadia.org/drepper/SHA-crypt.txt</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="restrictions" id="restrictions">Restrictions</a></h2>
<p>Sur les plates-formes Windows, la taille des mots de passe
hachés avec <code>htpasswd</code> est limitée à <code>255</code>
caractères. Les mots de passe dont la taille est supérieure seront
tronqués.</p>
<p>L'algorithme MD5 utilisé par <code>htpasswd</code> est spécifique
à Apache ; les mots de passe hachés en utilisant cet algorithme
seront inutilisables sur d'autres serveurs Web.</p>
<p>La taille des noms d'utilisateurs est limitée à <code>255</code>
octets et ceux-ci ne doivent pas contenir de caractère
<code>:</code>.</p>
<p>Le coût en performances de la génération de la valeur de hashage d'un mot
de passe bcrypt augmente avec le nombre de passes spécifié par l'option
<code>-C</code>. A partir de sa version <code>1.6.0</code>, la bibliothèque
<code>apr-util</code> limite le nombre de passes à 17.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htpasswd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htpasswd.html" title="Français"> fr </a> |
<a href="../ko/programs/htpasswd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htpasswd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htpasswd.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/httpd.html.en 0000664 0001751 0001751 00000027713 14737241666 021325 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>httpd - Apache Hypertext Transfer Protocol Server - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>httpd - Apache Hypertext Transfer Protocol Server</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/httpd.html" title="English"> en </a> |
<a href="../fr/programs/httpd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/httpd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/httpd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>httpd</code> is the Apache HyperText Transfer Protocol
(HTTP) server program. It is designed to be run as a standalone
daemon process. When used like this it will create a pool of
child processes or threads to handle requests.</p>
<p>In general, <code>httpd</code> should not be invoked directly,
but rather should be invoked via <code class="program"><a href="../programs/apachectl.html">apachectl</a></code> on Unix-based systems or <a href="../platform/windows.html#winsvc">as a service on Windows NT,
2000 and XP</a> and <a href="../platform/windows.html#wincons">as
a console application on Windows 9x and ME</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../invoking.html">Starting Apache httpd</a></li><li><a href="../stopping.html">Stopping Apache httpd</a></li><li><a href="../configuring.html">Configuration Files</a></li><li><a href="../platform/">Platform-specific Documentation</a></li><li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>httpd</strong> [ -<strong>d</strong>
<var>serverroot</var> ] [ -<strong>f</strong> <var>config</var> ]
[ -<strong>C</strong> <var>directive</var> ] [ -<strong>c</strong>
<var>directive</var> ] [ -<strong>D</strong> <var>parameter</var> ]
[ -<strong>e</strong> <var>level</var> ] [ -<strong>E</strong>
<var>file</var> ]
[ <strong>-k</strong> start|restart|graceful|stop|graceful-stop ]
[ -<strong>h</strong> ]
[ -<strong>l</strong> ] [ -<strong>L</strong> ] [ -<strong>S</strong> ]
[ -<strong>t</strong> ] [ -<strong>v</strong> ] [ -<strong>V</strong> ]
[ -<strong>X</strong> ] [ -<strong>M</strong> ] [ -<strong>T</strong> ]
</code></p>
<p>On <a href="../platform/windows.html">Windows systems</a>, the
following additional arguments are available:</p>
<p><code><strong>httpd</strong> [ -<strong>k</strong>
install|config|uninstall ] [ -<strong>n</strong> <var>name</var> ]
[ -<strong>w</strong> ]</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-d <var>serverroot</var></code></dt>
<dd>Set the initial value for the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> directive to
<var>serverroot</var>. This can be overridden by the ServerRoot
directive in the configuration file. The default is
<code>/usr/local/apache2</code>.</dd>
<dt><code>-f <var>config</var></code></dt>
<dd>Uses the directives in the file <var>config</var> on startup. If
<var>config</var> does not begin with a /, then it is taken to be a
path relative to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. The default is
<code>conf/httpd.conf</code>.</dd>
<dt><code>-k <code>start|restart|graceful|stop|graceful-stop</code></code></dt>
<dd>Signals <code>httpd</code> to start, restart, or stop. See <a href="../stopping.html">Stopping Apache httpd</a> for more information.</dd>
<dt><code>-C <var>directive</var></code></dt>
<dd>Process the configuration <var>directive</var> before reading
config files.</dd>
<dt><code>-c <var>directive</var></code></dt>
<dd>Process the configuration <var>directive</var> after reading config
files.</dd>
<dt><code>-D <var>parameter</var></code></dt>
<dd>Sets a configuration <var>parameter </var>which can be used with
<code class="directive"><a href="../mod/core.html#ifdefine"><IfDefine></a></code> sections
in the configuration files to conditionally skip or process commands
at server startup and restart. Also can be used to set certain
less-common startup parameters including <code>-DNO_DETACH</code>
(prevent the parent from forking) and <code>-DFOREGROUND</code>
(prevent the parent from calling <code>setsid()</code> et al).</dd>
<dt><code>-e <var>level</var></code></dt>
<dd>Sets the <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> to
<var>level</var> during server startup. This is useful for
temporarily increasing the verbosity of the error messages to find
problems during startup.</dd>
<dt><code>-E <var>file</var></code></dt>
<dd>Send error messages during server startup to <var>file</var>.</dd>
<dt><code>-h</code></dt>
<dd>Output a short summary of available command line options.</dd>
<dt><code>-l</code></dt>
<dd>Output a list of modules compiled into the server. This will
<strong>not</strong> list dynamically loaded modules included using
the <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directive.</dd>
<dt><code>-L</code></dt>
<dd>Output a list of directives provided by static modules, together with expected arguments and
places where the directive is valid. Directives provided by shared modules are not listed.</dd>
<dt><code>-M</code></dt>
<dd>Dump a list of loaded Static and Shared Modules.</dd>
<dt><code>-S</code></dt>
<dd>Show the settings as parsed from the config file (currently only
shows the virtualhost settings).</dd>
<dt><code>-T</code> (Available in 2.3.8 and later)</dt>
<dd>Skip document root check at startup/restart.</dd>
<dt><code>-t</code></dt>
<dd>Run syntax tests for configuration files only. The program
immediately exits after these syntax parsing tests with either a return code
of 0 (Syntax OK) or return code not equal to 0 (Syntax Error). If -D
<var>DUMP</var>_<var>VHOSTS </var>is also set, details of the virtual host
configuration will be printed. If -D <var>DUMP</var>_<var>MODULES </var> is
set, all loaded modules will be printed.</dd>
<dt><code>-v</code></dt>
<dd>Print the version of <code>httpd</code>, and then exit.</dd>
<dt><code>-V</code></dt>
<dd>Print the version and build parameters of <code>httpd</code>, and
then exit.</dd>
<dt><code>-X</code></dt>
<dd>Run httpd in debug mode. Only one worker will be started and the
server will not detach from the console.</dd>
</dl>
<p>The following arguments are available only on the <a href="../platform/windows.html">Windows platform</a>:</p>
<dl>
<dt><code>-k install|config|uninstall</code></dt>
<dd>Install Apache httpd as a Windows NT service; change startup options for
the Apache httpd service; and uninstall the Apache httpd service.</dd>
<dt><code>-n <var>name</var></code></dt>
<dd>The <var>name</var> of the Apache httpd service to signal.</dd>
<dt><code>-w</code></dt>
<dd>Keep the console window open on error so that the error message can
be read.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/httpd.html" title="English"> en </a> |
<a href="../fr/programs/httpd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/httpd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/httpd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/httpd.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/httpd.html.ko.euc-kr 0000664 0001751 0001751 00000026063 14743132254 022503 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>httpd - ġ ؽƮ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>httpd - ġ ؽƮ </h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/httpd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/httpd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/httpd.html" title="Korean"> ko </a> |
<a href="../tr/programs/httpd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>httpd</code> ġ ؽƮ
(HTTP) α̴. ü(standalone) μ
ϵ Ǿ. Ѵٸ û óϱ ڽ
μ .</p>
<p>Ϲ <code>httpd</code> ϱ⺸ٴ
н ýۿ <a href="apachectl.html">apachectl</a> , <a href="../platform/windows.html#winsvc">2000, XP
</a>, <a href="../platform/windows.html#wincons">Windows
9x ME ݼ α</a> ؾ Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="../invoking.html">ġ </a></li><li><a href="../stopping.html">ġ ߴ</a></li><li><a href="../configuring.html"></a></li><li><a href="../platform/">÷ </a></li><li><a href="apachectl.html">apachectl</a></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p><code><strong>httpd</strong> [ -<strong>d</strong>
<var>serverroot</var> ] [ -<strong>f</strong> <var>config</var> ]
[ -<strong>C</strong> <var>directive</var> ] [ -<strong>c</strong>
<var>directive</var> ] [ -<strong>D</strong> <var>parameter</var> ]
[ -<strong>e</strong> <var>level</var> ] [ -<strong>E</strong>
<var>file</var> ] [ <strong>-k</strong> start|restart|graceful|stop ]
[ -<strong>R</strong> <var>directory</var> ] [ -<strong>h</strong> ]
[ -<strong>l</strong> ] [ -<strong>L</strong> ] [ -<strong>S</strong> ]
[ -<strong>t</strong> ] [ -<strong>v</strong> ] [ -<strong>V</strong> ]
[ -<strong>X</strong> ] [ -<strong>M</strong> ]</code></p>
<p><a href="../platform/windows.html">Windows ý</a>
ƱԸƮ ߰ ִ:</p>
<p><code><strong>httpd</strong> [ -<strong>k</strong>
install|config|uninstall ] [ -<strong>n</strong> <var>name</var> ]
[ -<strong>w</strong> ]</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<dl>
<dt><code>-d <var>serverroot</var></code></dt>
<dd><code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> þ
⺻ <var>serverroot</var> Ѵ. Ͽ ServerRoot
þ Ͽ ִ. ⺻
<code>/usr/local/apache2</code>̴.</dd>
<dt><code>-f <var>config</var></code></dt>
<dd>Ҷ <var>config</var> Ͽ ִ þ Ѵ.
<var>config</var> / <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> ̴. ⺻
<code>conf/httpd.conf</code>̴.</dd>
<dt><code>-k <code>start|restart|graceful|stop</code></code></dt>
<dd><code>httpd</code> , , ߴѴ. ڼ
<a href="../stopping.html">ġ ߴϱ</a> ϶.</dd>
<dt><code>-C <var>directive</var></code></dt>
<dd> б <var>directive</var> þ óѴ.</dd>
<dt><code>-c <var>directive</var></code></dt>
<dd> б <var>directive</var> þ óѴ.</dd>
<dt><code>-D <var>parameter</var></code></dt>
<dd> Ȥ ۽ ɾ óϱ
<code class="directive"><a href="../mod/core.html#ifdefine"><IfDefine></a></code>
ǿ <var>parameter</var> Ѵ.</dd>
<dt><code>-e <var>level</var></code></dt>
<dd> ϴµ <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code>
<var>level</var> Ѵ. ̴ ã
ڼ ϴ.</dd>
<dt><code>-E <var>file</var></code></dt>
<dd> ϴµ <var>file</var> .</dd>
<dt><code>-R <var>directory</var></code></dt>
<dd> <code>SHARED_CORE</code> Ģ Ͽ
Ʈ <var>directory</var> Ѵ.</dd>
<dt><code>-h</code></dt>
<dd> ִ ɼǵ ª Ѵ.</dd>
<dt><code>-l</code></dt>
<dd> Ѵ. <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> þ Ͽ
о̴ <strong>ʴ´</strong>.</dd>
<dt><code>-L</code></dt>
<dd>þ þ ƱԸƮ þ ҿ
Ѵ.</dd>
<dt><code>-M</code></dt>
<dd>о Ѵ.</dd>
<dt><code>-S</code></dt>
<dd>Ͽ о ش ( ȣƮ
ش).</dd>
<dt><code>-t</code></dt>
<dd> ˻縸 Ѵ. α ˻
( ùٸ ) 0̳ ( ִ ) 0 ƴ
ڵ Ѵ. -D <var>DUMP</var>_<var>VHOSTS</var>
ϸ ȣƮ ڼ Ѵ. -D
<var>DUMP</var>_<var>MODULES</var> ϸ о
Ѵ.</dd>
<dt><code>-v</code></dt>
<dd><code>httpd</code> ϰ Ѵ.</dd>
<dt><code>-V</code></dt>
<dd><code>httpd</code> Ķ ϰ
Ѵ.</dd>
<dt><code>-X</code></dt>
<dd> · Ѵ. μ θ
ϰ, ֿܼ ʴ´.</dd>
</dl>
<p> ƱԸƮ <a href="../platform/windows.html">Windows
÷</a> ִ:</p>
<dl>
<dt><code>-k install|config|uninstall</code></dt>
<dd>ġ Windows NT ġѴ; ġ
ɼ Ѵ; ġ ġ .</dd>
<dt><code>-n <var>name</var></code></dt>
<dd>ġ <var>name</var>.</dd>
<dt><code>-w</code></dt>
<dd> ϸ ܼâ ش.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/httpd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/httpd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/httpd.html" title="Korean"> ko </a> |
<a href="../tr/programs/httpd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/httpd.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/configure.html.tr.utf8 0000664 0001751 0001751 00000122776 14743132254 023065 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>configure - kaynak ağacını yapılandırır - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>configure - kaynak ağacını yapılandırır</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/configure.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/configure.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/configure.html" title="Türkçe"> tr </a></p>
</div>
<p><code>configure</code> betiği, Apache HTTP Sunucusunun kaynak kodlarını
belli bir platform için yapılandırmakta ve derlemekte kullanılır.
Sunucuyu kişisel gereksinimlerinize uygun şekilde derlemek için çeşitli
seçeneklere sahiptir.</p>
<p>Bu betik Apache HTTP Sunucusu kaynak paketinin kök dizininde bulunur ve
sadece Unix ve benzeri sistemlerde kullanılabilir. Kaynak paketinin
diğer platformalarda yapılandırılması ve derlenmesi hakkında bilgi
edinmek için <a href="../platform/">platform</a> belgelerine bakınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Komut Satırı</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#env">Ortam Değişkenleri</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="../install.html">Derleme ve Kurulum</a></li><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Komut Satırı</a></h2>
<p><code>configure</code> betiğini kaynak paketinin kök dizininden başka
bir yere kopyalayıp çalıştırmamalısınız.</p>
<p><code><strong>./configure</strong> [<var>seçenek</var>]...
[<var>değişken=değer</var>]...</code></p>
<p><code>CC</code>, <code>CFLAGS</code> gibi ortam değişkenlerini
<code><var>değişken</var>=<var>değer</var></code> atamaları biçiminde
kullanabilirsiniz. Kullanışlı değişkenlerin bazıları <a href="#env">aşağıda</a> açıklanmıştır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<ul>
<li><a href="#configurationoptions">Yapılandırma seçenekleri</a></li>
<li><a href="#installationdirectories">Kurulum dizinleri</a></li>
<li><a href="#systemtypes">Sistem türleri</a></li>
<li><a href="#optionalfeatures">Seçimlik özellikler</a></li>
<li><a href="#supportopt">Destek programları için seçenekler</a></li>
</ul>
<h3><a name="configurationoptions" id="configurationoptions">Yapılandırma seçenekleri</a></h3>
<p>Aşağıdaki seçenekler <code>configure</code> betiğinin kendi davranışını
belirlemekte kullanılır.</p>
<dl>
<dt><code>-C</code></dt>
<dt><code>--config-cache</code></dt>
<dd><code>--cache-file=config.cache</code> için bir kısaltmadır.</dd>
<dt><code>--cache-file=<var>dosya</var></code></dt>
<dd>Sınama sonuçları <code><var>dosya</var></code> dosyasında saklanır.
Bu seçenek açıkça belirtilmedikçe işlevsizdir.</dd>
<dt><code>-h</code></dt>
<dt><code>--help [short|recursive]</code></dt>
<dd>Yardım metnini basar ve çıkar. <code>short</code> değeriyle sadece
bu pakete özgü seçenekler listelenir. <code>recursive</code> değeriyle
ise paketin içindeki tüm paketler için kısa bir yardım metni
basılır.</dd>
<dt><code>-n</code></dt>
<dt><code>--no-create</code></dt>
<dd><code>configure</code> betiği normal olarak çalışır fakat herhangi
bir çıktı dosyası üretmez. Derleme için <code>Makefile</code>
dosyalarını üretmeksizin sınamaların sonuçlarını görmek için
yararlıdır.</dd>
<dt><code>-q</code></dt>
<dt><code>--quiet</code></dt>
<dd>Yapılandırma sürecinde <code>checking ...</code> iletilerini basmaz.
</dd>
<dt><code>--srcdir=<var>dizin</var></code></dt>
<dd><code><em>dizin</em></code> dizinini kaynak dosyaları dizini olarak
tanımlar. <code>configure</code> betiğinin bulunduğu dizin veya bir
üst dizin öntanımlıdır.</dd>
<dt><code>--silent</code></dt>
<dd><code>--quiet</code> ile aynı.</dd>
<dt>-V</dt>
<dt>--version</dt>
<dd>Telif hakkı bilgilerini gösterir ve çıkar.</dd>
</dl>
<h3><a name="installationdirectories" id="installationdirectories">Kurulum dizinleri</a></h3>
<p>Bu seçenekler kurulum dizinlerini tanımlar. Kurulum dizinleri seçilmiş
yerleşime bağımlıdır.</p>
<dl>
<dt><code>--prefix=<var>PREFIX</var></code></dt>
<dd>Mimariden bağımsız dosyalar <code><em>PREFIX</em></code> dizininin
altına kurulur. <code>/usr/local/apache2</code> öntanımlı kurulum
dizinidir.</dd>
<dt><code>--exec-prefix=<var>EPREFIX</var></code></dt>
<dd>Mimariye bağımlı dosyalar <code><em>EPREFIX</em></code> dizininin
altına kurulur. Bunun için <code><em>PREFIX</em></code> dizini
öntanımlı kurulum dizinidir.</dd>
</dl>
<p>Öntanımlı olarak, <code>make install</code> tüm dosyaların
<code>/usr/local/apache2/bin</code>, <code>/usr/local/apache2/lib</code>
gibi dizinlere kurulmasını sağlar. Kurulum dizini önekini örneğin,
<code>--prefix=$HOME</code> şeklinde belirterek kurulumun başka bir yere
yapılmasını sağlayabilirsiniz.</p>
<h4><a name="layout" id="layout">Bir dizin yerleşimi tanımlamak</a></h4>
<dl>
<dt><code>--enable-layout=<var>LAYOUT</var></code></dt>
<dd>Kaynak kodu ve derleme betikleri kurulum ağacının
<code><em>LAYOUT</em></code> yerleşimine dayalı olduğu varsayımıyla
yapılandırılır. Bu seçenek sayesinde Apache HTTP Sunucusu kurulumu
içinde her dosya türü için farklı bir yer belirleyebilirsiniz.
<code>config.layout</code> dosyasında böyle yapılandırma örnekleri
vardır. Örnekleri izleyerek kendi yapılandırmanızı
oluşturabilirsiniz. Bu dosyada örneğin <code>FOO</code> isimli
yerleşim <code><Layout FOO>...</Layout></code> bölümü
içinde düzenlenmiştir ve her yerleşim için böyle ayrı bir bölüm
vardır. Öntanımlı yerleşim <code>Apache</code>’dir.</dd>
</dl>
<h4><a name="directoryfinetuning" id="directoryfinetuning">Kurulum dizinlerinde ince ayar</a></h4>
<p>Kurulum dizinlerini daha iyi denetim altında tutmak için aşağıdaki
seçenekler kullanılır. Lütfen, dizin öntanımlılarının
<code>autoconf</code> tarafından tanımlandığına ve seçilen yerleşim
ayarlarının bunları yerini aldığına dikkat ediniz.</p>
<dl>
<dt><code>--bindir=<var>dizin</var></code></dt>
<dd>Kullanıcı tarafından çalıştırılabilen dosyalar
<code><em>dizin</em></code> dizinine kurulur. Bunlar
<code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>, <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> gibi site
yönetimi için yararlı destek programlarıdır. Öntanımlı olarak bu
dosyalar <code><var>EPREFIX</var>/bin</code> dizinine kurulur.</dd>
<dt><code>--datadir=<var>dizin</var></code></dt>
<dd>Mimariden bağımsız salt okunur veriler <code><em>dizin</em></code>
dizinine kurulur. Bunların öntanımlı kurulum dizini
<code><var>PREFIX</var>/share</code> dizinidir. Bu seçenek
<code>autoconf</code> tarafından atanır ve şimdilik
kullanılmamıştır.</dd>
<dt><code>--includedir=<var>dizin</var></code></dt>
<dd>C başlık dosyaları <code><em>dizin</em></code> dizinine kurulur.
Bunların öntanımlı kurulum dizini
<code><var>PREFIX</var>/include</code> dizinidir.</dd>
<dt><code>--infodir=<var>dizin</var></code></dt>
<dd>Info belgeleri <code><em>dizin</em></code> dizinine kurulur.
Bunların öntanımlı kurulum dizini
<code><var>PREFIX</var>/info</code> dizinidir. Bu seçenek şimdilik
kullanılmamıştır.</dd>
<dt><code>--libdir=<var>dizin</var></code></dt>
<dd>Nesne kod kütüphaneleri <code><em>dizin</em></code> dizinine
kurulur. Bunların öntanımlı kurulum dizini
<code><var>PREFIX</var>/lib</code> dizinidir.</dd>
<dt><code>--libexecdir=<var>dizin</var></code></dt>
<dd>Paylaşımlı modüller gibi program dosyaları
<code><em>dizin</em></code> dizinine kurulur. Öntanımlı olarak
<code>libexecdir</code> bu dizini
<code><var>EPREFIX</var>/modules</code> olarak tanımlar.</dd>
<dt><code>--localstatedir=<var>dizin</var></code></dt>
<dd>Düzenlenebilir tek makinelik veri <code><em>dizin</em></code>
dizinine kurulur. Öntanımlı olarak <code>localstatedir</code> bu
dizini <code><var>PREFIX</var>/var</code> olarak tanımlar. Bu
seçenek <code>autoconf</code> tarafından atanır ve şimdilik
kullanılmamıştır.</dd>
<dt><code>--mandir=<var>dizin</var></code></dt>
<dd>Kılavuz sayfaları <code><em>dizin</em></code> dizinine kurulur.
Öntanımlı olarak <code>mandir</code> bu dizini
<code><var>EPREFIX</var>/man</code> olarak tanımlar.</dd>
<dt><code>--oldincludedir=<var>dizin</var></code></dt>
<dd>GCC harici C başlık dosyaları <code><em>dizin</em></code> dizinine
kurulur. Öntanımlı olarak <code>oldincludedir</code> bu dizini
<code>/usr/include</code> olarak tanımlar. Bu seçenek
<code>autoconf</code> tarafından atanır ve şimdilik
kullanılmamıştır.</dd>
<dt><code>--sbindir=<var>dizin</var></code></dt>
<dd>Sistem yöneticisi tarafından kullanılabilen programlar
<code><em>dizin</em></code> dizinine kurulur. Bunlar
<code class="program"><a href="../programs/httpd.html">httpd</a></code>, <code class="program"><a href="../programs/apachectl.html">apachectl</a></code>,
<code class="program"><a href="../programs/suexec.html">suexec</a></code> gibi Apache HTTP Sunucusunu çalıştırmak
için gereken programlardır. Öntanımlı olarak <code>sbindir</code> bu
dizini <code><var>EPREFIX</var>/sbin</code> olarak tanımlar.</dd>
<dt><code>--sharedstatedir=<var>dizin</var></code></dt>
<dd>Mimariye bağımlı düzenlenebilir veriler
<code><em>dizin</em></code> dizinine kurulur. Öntanımlı olarak
<code>sharedstatedir</code> bu dizini
<code><var>PREFIX</var>/com</code> olarak tanımlar. Bu seçenek
<code>autoconf</code> tarafından atanır ve şimdilik
kullanılmamıştır.</dd>
<dt><code>--sysconfdir=<var>dizin</var></code></dt>
<dd><code>httpd.conf</code>, <code>mime.types</code> gibi tek
makinelik salt okunur sunucu yapılandırma dosyaları
<code><em>dizin</em></code> dizinine kurulur. Öntanımlı olarak
<code>sysconfdir</code> bu dizini
<code><var>PREFIX</var>/conf</code> olarak tanımlar.</dd>
</dl>
<h3><a name="systemtypes" id="systemtypes">Sistem türleri</a></h3>
<p>Bu seçenekleri Apache HTTP Sunucusunu başka bir platformda çalıştırmak
üzere çapraz derleme yaparken kullanılır. Normal durumlarda sunucu
derlendiği platformda çalıştırıldığından bu seçenekler kullanılmaz.</p>
<dl>
<dt><code>--build=<var>derleme-ortamı</var></code></dt>
<dd>Derleme araçlarının derleneceği sistemin sistem türünü tanımlar.
<code>config.guess</code> betiği ile elde edilen sonuç
öntanımlıdır.</dd>
<dt><code>--host=<var>çalışma-ortamı</var></code></dt>
<dd>Sunucunun çalışacağı sistemin sistem türünü tanımlar. Öntanımlı
sistem türü <code><var>derleme-ortamı</var></code>’dır.</dd>
<dt><code>--target=<var>hedef-ortam</var></code></dt>
<dd>Derleyicileri <code><var>hedef-ortam</var></code> sistem türü için
yapılandırır. Öntanımlı sistem türü
<code><var>çalışma-ortamı</var></code>’dır. Bu seçenek
<code>autoconf</code> tarafından atanır ve Apache HTTP Sunucusu için
gerekli değildir.</dd>
</dl>
<h3><a name="optionalfeatures" id="optionalfeatures">Seçimlik özellikler</a></h3>
<p>Bu seçenekler HTTP sunucunuzun sahip olmasını istediğiniz özelliklerin
hassas olarak ayarlanmasını sağlar.</p>
<h4><a name="generaloptfeat" id="generaloptfeat">Genel sözdizimi</a></h4>
<p>Bir özelliği etkin kılmak veya iptal etmek için genellikle şu
sözdizimi kullanılır:</p>
<dl>
<dt><code>--disable-<var>özellik</var></code></dt>
<dd>Sunucu <code><em>özellik</em></code> özelliğine sahip olmaz. Bu
seçenek<code>--enable-<var>özellik</var>=no</code> seçeneğine
eşdeğerdir.</dd>
<dt><code>--enable-<var>özellik</var>[=<var>değer</var>]</code></dt>
<dd>Sunucu <code><var>özellik</var></code> özelliğine sahip olur.
<code><var>değer</var></code> belirtilmediği takdirde
<code>yes</code> (evet) öntanımlıdır.</dd>
<dt><code>--enable-<var>modül</var>=shared</code></dt>
<dd>Belirtilen modül DSO modülü olarak derlenir. Öntanımlı olarak
etkin modüller devingen ilintilenir.</dd>
<dt><code>--enable-<var>modül</var>=static</code></dt>
<dd>Belirtilen modül durağan ilintilenir.</dd>
</dl>
<div class="note"><h3>Bilginize</h3>
<p><code>--enable-<var>filanca</var></code> seçeneğinin varlığı
<code>configure</code> betiğinin <code><var>filanca</var></code> diye
bir modül var olmasa bile bundan şikayetçi olmasına sebep olmaz. Bu
bakımdan dikkatli olunuz.</p>
</div>
<h4><a name="choosemodules" id="choosemodules">Derlenecek modüllerin seçimi</a></h4>
<p>Modüllerin çoğu öntanımlı olarak derlenir ve ya açıkça iptal edilmek
ya da <code>few</code> anahtar sözcüğü
kullanılarak kaldırılmak zorunda kalınır (ayrıntılar için
<code>--enable-modules</code>, <code>--enable-mods-shared</code> ve
<code>--enable-mods-static</code> seçeneklerine bakın). Bir grubu
tamamen kaldırmak için <code>--enable-modules=none</code> gerekir.</p>
<p>Öntanımlı olarak derlenmeyenler ise ya açıkça etkin kılınmak ya da
<code>all</code> veya <code>reallyall</code> anahtar sözcükleriyle
kullanılabilir yapılmak zorunda kalınır.</p>
<p>Hangi modüllerin öntanımlı olarak derlendiğini öğrenmek için
<code>./configure -h</code> veya <code>./configure --help</code>
komutunu çalıştırın ve çıktıdaki <code>Optional Features</code>
bölümüne bakın. Örnek olarak, <code>mod_example1</code> ve
<code>mod_example2</code> modülleriyle ilgilendiğinizi
varsayalım:</p>
<div class="example"><pre>Optional Features:
...
--disable-example1 example module 1
--enable-example2 example module 2
...</pre></div>
<p>Burada, <code>mod_example1</code> öntanımlı olarak etkindir ve
derlenmemesini istiyorsanız <code>--disable-example1</code>
seçeneğini kullanmalısınız. <code>mod_example2</code> ise öntanımlı
olarak derlenmemektedir ve derlenmesini istiyorsanız
<code>--enable-example2</code> seçeneğini kullanmalısınız.</p>
<h4><a name="mpms" id="mpms">Çok Süreçlilik Modülleri</a></h4>
<p><a href="../mpm.html">Çok Süreçlilik Modülleri</a> veya MPM'ler
sunucunun temel davranışını belirler. Sunucuya yüklenebilecek azami MPM
sayısı birdir. Kullanılabilecek modüller <a href="../mod/">modül
dizini</a>nde listelenmiştir.</p>
<p>MPM'ler devingen yükleme için DSO olarak derlenebileceği gibi
sunucuyla duruk olarak da ilintilenebilir ve bunlar aşağıdaki
seçeneklerle etkin kılınır:</p>
<dl>
<dt><code>--with-mpm=MPM</code></dt>
<dd>
<p>Sunucu için öntanımlı MPM'i seçer. MPM'ler DSO modülleri olarak
derleniyorsa (bak <code>--enable-mpms-shared</code>), bu seçenek
öntanımlı yapılandırma dosyasında yüklenecek MPM'i seçer. Aksi
takdirde, sunucuyla duruk olarak ilintilenecek, kullanılabilir tek
MPM'i seçer.</p>
<p>Bu seçenek belirtilmezse, işletim sisteminiz için
<a href="../mpm.html#defaults">öntanımlı olan MPM</a> seçilir.</p>
</dd>
<dt><code>--enable-mpms-shared=<var>MPM-LISTESİ</var></code></dt>
<dd>
<p>MPM'leri devingen paylaşımlı modül olarak etkinleştirir.
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> yönergesi
kullanılarak bu modüllerden biri devingen olarak yüklenmelidir.</p>
<p><var>MPM-LISTESİ</var> MPM'lerin aralarına boşluk bırakılarak ve
tamamı tek tırnaklarla sarmalanarak oluşturulmuş bir listesidir.
Örnek:</p>
<div class="example"><p><code>
--enable-mpms-shared='prefork worker'
</code></p></div>
<p>Ek olarak, kullandığınız platformda devingen yüklemeyi destekleyen
ve DSO modülü olarak derlenmiş tüm modülleri seçmek için
<code>all</code> anahtar sözcüğünü de kullanabilirsiniz. Örnek:</p>
<div class="example"><p><code>
--enable-mpms-shared=all
</code></p></div>
</dd>
</dl>
<h4><a name="modules" id="modules">Üçüncü parti modüller</a></h4>
<p>Üçüncü parti modülleri etkin kılmak için şu seçenekler kullanılır:</p>
<dl>
<dt><code>--with-module=<var>modül-türü</var>:<var>modül-dosyası</var>[,<var>modül-türü</var>:<var>modül-dosyası</var>]</code></dt>
<dd><p>Durağan ilintili modüller listesine belirtilen modülleri ekler.
Modül kaynak dosyası <code><var>modül-dosyası</var></code>, önce
Apache HTTP Sunucusu kaynak ağacı altında
<code>modules/<var>modül-türü</var></code> alt dizininde aranır.
Modül orada değilse <code>configure</code> betiği
<code><var>modül-dosyası</var></code> ile bir mutlak dosya yolu
belirtildiği varsayımıyla kaynak dosyasını
<code><var>modül-türü</var></code> alt dizinine kopyalamaya çalışır.
Alt dizin mevcut değilse oluşturulur ve içine standart bir
<code>Makefile.in</code> yerleştirilir.</p>
<p>Bu seçenek tek kaynak dosyasından oluşan küçük harici modülleri
eklemek için yararlıdır. Daha karmaşık modüller için modül üreticisi
tarafından sağlanan belgelere bakınız.</p>
<div class="note"><h3>Bilginize</h3>
<p>Durağan ilintili modüller yerine bir DSO modülü derlemek
isterseniz <code class="program"><a href="../programs/apxs.html">apxs</a></code> programını kullanınız.</p>
</div>
</dd>
</dl>
<h4><a name="otheroptfeat" id="otheroptfeat">Kümeleme seçenekleri ve diğerleri</a></h4>
<dl>
<dt><code>--enable-maintainer-mode</code></dt>
<dd>Hata ayıklama iletileri ve derleme sırasındaki uyarıların
gösterilmesi etkin kılınır ve derlenmiş tüm modüller yüklenir.</dd>
<dt><code>--enable-mods-shared=<var>modül-listesi</var></code></dt>
<dd>
<p>Etkinleştirilip devingen paylaşımlı modül olarak derlenecek
modüllerin listesi belirtilir. Yani, bu modüller <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> yönergesi kullanılarak
devingen olarak yüklenir.</p>
<p><code><var>modül-listesi</var></code> tırnak içine alınmış boşluk
ayraçlı modül isimleri listesidir. Modül isimleri önlerindeki
<code>mod_</code> öneki olmaksızın belirtilirler. Örnek:</p>
<div class="example"><p><code>
--enable-mods-shared='headers rewrite dav'
</code></p></div>
<p><code><var>modül-listesi</var></code> yerine
<code>reallyall</code>, <code>all</code>, <code>most</code> ve
<code>few</code> anahtar sözcükleri de belirtilebilir. Örneğin,</p>
<div class="example"><p><code>
--enable-mods-shared=most
</code></p></div>
<p>seçeneği ile çoğu modül DSO modülü olarak derlenir,</p>
<div class="example"><p><code>
--enable-mods-shared=few
</code></p></div>
<p>seçeneği ile sadece en temel modüller derlenir.</p>
<p><code>most</code> öntanımlıdır.</p>
<p>Seçilen modüller için <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> yönergeleri ana yapılandırma dosyasında
kendiliğinden üretilir. Öntanımlı olarak, <code>--enable-foo</code>
yapılandıma seçeneği ile açıkça seçilen modüller ve gerekli olanlar
dışında kalan <code>LoadModule</code> yönergeleri açıklama haline
getirilir. Yüklü modülleri <code>httpd.conf</code> dosyasındaki
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> yönergelerini
etkin kılarak veya açıklama haline getirerek değiştirebilirsiniz.
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> yönergelerine ek
olarak, derlenmiş tüm modüller
<code>--enable-load-all-modules</code> yapılandırma seçeneği ile de
etkinleştirilebilir.</p></dd>
<dt><code>--enable-mods-static=<var>modül-listesi</var></code></dt>
<dd>Bu seçenek modülleri devingen değil de durağan ilintilemek dışında
<code>--enable-mods-shared</code> seçeneğine benzer. Yani bu
modüller <code class="program"><a href="../programs/httpd.html">httpd</a></code> çalıştırılır çalıştırılmaz etkin
olurlar. Yüklenmeleri için <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> yönergesine ihtiyaçları
yoktur.</dd>
<dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
<dd>Bu seçenek <code>--enable-mods-shared</code> gibi davranır ve ek
olarak belirtilen modülleri devingen olarak ilintiler.Özel
<code>none</code> anahtar sözcüğü tüm modüllerin derlenmesini iptal
eder.</dd>
<dt><code>--enable-v4-mapped</code></dt>
<dd>IPv6 soketlierinin IPv4 bağlantılar üzerinde kullanılması mümkün
olur.</dd>
<dt><code>--with-port=<var>port</var></code></dt>
<dd>Bu seçenek <code class="program"><a href="../programs/httpd.html">httpd</a></code>'nin dinleyeceği portu
belirler. Bu port <code>httpd.conf</code> yapılandırma dosyası
üretilirken kullanılır. 80. port öntanımlıdır.</dd>
<dt><code>--with-program-name</code></dt>
<dd>Öntanımlı olan <code>httpd</code> yerine başka bir çalıştırabilir
ismi tanımlar.</dd>
</dl>
<h3><a name="packages" id="packages">Seçimlik paketler</a></h3>
<p>Buradaki seçenekler seçimlik paketleri tanımlamak için kullanılır.</p>
<h4><a name="generalpackages" id="generalpackages">Genel sözdizimi</a></h4>
<p>Bir seçimlik paketi tanımlamak için genellikle şöyle bir sözdizimi
kullanılır:</p>
<dl>
<dt><code>--with-<var>paket</var>[=<var>değer</var>]</code></dt>
<dd><code><var>paket</var></code> paketi kullanılır. Öntanımlı
<code><var>değer</var></code> <code>yes</code>’tir.</dd>
<dt><code>--without-<var>paket</var></code></dt>
<dd><code><var>paket</var></code> paketi kullanılmaz. Öntanımlı
<code><var>değer</var></code> <code>no</code>’dur. Bu seçenek
<code>autoconf</code> tarafından sağlanmıştır ve Apache HTTP
Sunucusu için pek yararlı değildir.</dd>
</dl>
<h4><a name="packageopt" id="packageopt">Özel paketler</a></h4>
<dl>
<dt><code>--with-apr=<var>dizin</var>|<var>dosya</var></code></dt>
<dd><a class="glossarylink" href="../glossary.html#apr" title="sözlüğe bakınız">Apache Taşınabilir Arayüzü</a> (APR)
httpd kaynak paketinin bir parçası olup HTTP Sunucu ile birlikte
derlenir. Eğer kendi kurulu APR’nizi kullanmak isterseniz bunu
<code>configure</code> betiğine <code>apr-config</code> betiğinin
yolunu belirterek ifade edebilirsiniz. Kurulu APR için bid dizin,
dosya ismi veya mutlak dosya yolu belirtebilirsiniz.
<code>apr-config</code> ya belirttiğiniz dizinde ya da
<code>bin</code> alt dizininde bulunmalıdır.</dd>
<dt><code>--with-apr-util=<var>dizin</var>|<var>dosya</var></code></dt>
<dd>Apache Taşınabilir Arayüzü Araçları (APU) httpd kaynak paketinin
bir parçası olup HTTP Sunucu ile birlikte derlenir. Eğer kendi
kurulu APU’nuzu kullanmak isterseniz bunu <code>configure</code>
betiğine <code>apu-config</code> betiğinin yolunu belirterek ifade
edebilirsiniz. Kurulu APR için bir dizin, dosya ismi veya mutlak
dosya yolu belirtebilirsiniz. <code>apr-config</code> ya
belirttiğiniz dizinde ya da <code>bin</code> alt dizininde
bulunmalıdır.</dd>
<dt><code>--with-ssl=<var>dizin</var></code></dt>
<dd><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> modülü etkinse <code>configure</code>
betiği kurulu bir OpenSSL arayacaktır. Kendi SSL/TLS kurulumunuzun
yolunu bu seçenekle belirtebilirsiniz.</dd>
<dt><code>--with-z=<var>dizin</var></code></dt>
<dd>Yapılandırmanız gerektirdiği takdirde (örneğin,
<code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> etkinse) <code>configure</code> betiği
kurulu <code>zlib</code> kütüphanesinin yerini tespit etmeye
çalışacaktır. Kendi sıkıştırma kütüphanenizin yerini bu seçenekle
belirtebilirsiniz.</dd>
</dl>
<p>Apache HTTP Sunucusunun çeşitli bölümleri,
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> modülü ve <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
modülünün <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
yönergesi bilgilere erişimi hızlandırmak için basit anahtar/değer
veritabanları kullanırlar. SDBM, APU içinde mevcut olduğundan bu
veritabanı her zaman kullanılabilir durumdadır. Eğer başka veritabanı
türleri kullanmak isterseniz aşağıdaki seçeneklerle bunları etkin
kılabilirsiniz:</p>
<dl>
<dt><code>--with-gdbm[=<var>dizin-yolu</var>]</code></dt>
<dd>Bir <code><var>dizin-yolu</var></code> belirtilmemişse
<code>configure</code> betiği GNU DBM kurulumunun kütüphanelerini ve
başlık dosyalarını bulunması olası yerlerde arar. Bir
<code><var>dizin-yolu</var></code> belirtilmişse
<code>configure</code> betiği kurulumun kütüphanelerini
<code><var>dizin-yolu</var>/lib</code> altında, başlık dosyalarını
ise <code><var>dizin-yolu</var>/include</code> altında arayacaktır.
Bundan başka, başlık ve kütüphane dosyalarının bulundukları yerler
iki nokta imi ile ayrılarak <code><var>dizin-yolu</var></code>
olarak belirtilebilir.</dd>
<dt><code>--with-ndbm[=<var>dizin-yolu</var>]</code></dt>
<dd>New DBM kurulumunu araştırması dışında <code>--with-gdbm</code>
seçeneği gibidir.</dd>
<dt><code>--with-berkeley-db[=<var>dizin-yolu</var>]</code></dt>
<dd>Berkeley DB kurulumunu araştırması dışında
<code>--with-gdbm</code> seçeneği gibidir.</dd>
</dl>
<div class="note"><h3>Bilginize</h3>
<p>DBM seçenekleri APU tarafından sağlanmış olup onun yapılandırma
betiğine aktarılır. Bu seçenekler <code>--with-apr-util</code>
seçeneği ile tanımlanmış bir kurulu APU varsa kullanışlı olur.</p>
<p>HTTP sunucunuz ile birlikte birden fazla DBM gerçeklenimi
kullanabilirsiniz. Kullanılacak DBM türünü her zaman çalışma anı
yapılandırmanızla yapılandırabilirsiniz.</p>
</div>
<h3><a name="supportopt" id="supportopt">Destek programları için seçenekler</a></h3>
<dl>
<dt><code>--enable-static-support</code></dt>
<dd>Destek programlarını durağan ilintili olarak derler. Yani
çalıştırılabilirin kullandığı bütün kütüphaneler kodla
bütünleştirilir. Bu seçenek belirtilmedikçe destek programları daima
devingen ilintili olarak derlenir.</dd>
<dt><code>--enable-suexec</code></dt>
<dd>Çatallanan sürecin kullanıcı ve grup kimliklerinin
değiştirilebilmesini sağlayan <code class="program"><a href="../programs/suexec.html">suexec</a></code> programının
kullanımını etkinleştirir. <strong>Sunucunuz üzerinde suid biti
etkinleştirilmiş bir program çalıştırmanın sistem güvenliğinde
yaratacağı sorunlar hakkında bir fikriniz yoksa bu seçeneği
etkinleştirmeyin</strong>. <code class="program"><a href="../programs/suexec.html">suexec</a></code> yapılandırma
seçenekleri <a href="#suexec">aşağıda</a> açıklanmıştır.</dd>
</dl>
<p>Tek bir destek programını aşağıdaki seçenekleri kullanarak bir durağan
ilintili çalıştırılabilir olarak derleyebilirsiniz:</p>
<dl>
<dt><code>--enable-static-ab</code></dt>
<dd><code class="program"><a href="../programs/ab.html">ab</a></code> programının durağan ilintili sürümü
derlenir.</dd>
<dt><code>--enable-static-checkgid</code></dt>
<dd><code>checkgid</code> programının durağan ilintili sürümü
derlenir.</dd>
<dt><code>--enable-static-htdbm</code></dt>
<dd><code class="program"><a href="../programs/htdbm.html">htdbm</a></code> programının durağan ilintili sürümü
derlenir.</dd>
<dt><code>--enable-static-htdigest</code></dt>
<dd><code class="program"><a href="../programs/htdigest.html">htdigest</a></code> programının durağan ilintili sürümü
derlenir.</dd>
<dt><code>--enable-static-htpasswd</code></dt>
<dd><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> programının durağan ilintili sürümü
derlenir.</dd>
<dt><code>--enable-static-logresolve</code></dt>
<dd><code class="program"><a href="../programs/logresolve.html">logresolve</a></code> programının durağan ilintili sürümü
derlenir.</dd>
<dt><code>--enable-static-rotatelogs</code></dt>
<dd><code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code> programının durağan ilintili sürümü
derlenir.</dd>
</dl>
<h4><a name="suexec" id="suexec"><code>suexec</code> yapılandırma seçenekleri</a></h4>
<p>Aşağıdaki seçeneklerle <code class="program"><a href="../programs/suexec.html">suexec</a></code> programının
davranışı hassas bir şekilde ayarlanabilir. Daha ayrıntılı bilgi için
<a href="suexec.html#install">suEXEC yapılandırması ve kurulumu</a>na
bakınız.</p>
<dl>
<dt><code>--with-suexec-bin</code></dt>
<dd>Bu seçenek ile <code class="program"><a href="../programs/suexec.html">suexec</a></code> çalıştırılabilirinin yeri
belirtilir. Öntanımlı olarak <code>--sbindir</code> ile belirtilen
dizine kurulur (<a href="#directoryfinetuning">Kurulum dizinlerinde
ince ayar</a> konusuna bakınız).</dd>
<dt><code>--with-suexec-caller</code></dt>
<dd>Bu seçenek ile <code class="program"><a href="../programs/suexec.html">suexec</a></code>’i çalıştırabilecek
kullanıcı belirtilir. Normalde <code class="program"><a href="../programs/httpd.html">httpd</a></code> programını
çalıştıran kullanıcı olmalıdır.</dd>
<dt><code>--with-suexec-docroot</code></dt>
<dd>Bu seçenek ile <code class="program"><a href="../programs/suexec.html">suexec</a></code>'e erişebilecek
çalıştırılabilirlerin altında bulunacağı dizin belirtilir.
<code>--datadir/htdocs</code> öntanımlıdır.</dd>
<dt><code>--with-suexec-gidmin</code></dt>
<dd><code class="program"><a href="../programs/suexec.html">suexec</a></code> için hedef kullanıcı olmasına izin
verilen en küçük grup kimliğini tanımlamak için kullanılır. 100
öntanımlıdır.</dd>
<dt><code>--with-suexec-logfile</code></dt>
<dd><code class="program"><a href="../programs/suexec.html">suexec</a></code> günlük dosyasının ismi belirtilir.
Öntanımlı olarak bu dosyanın ismi <code>suexec_log</code> olup
<code>--logfiledir</code> seçeneği ile belirtilen dizin altında
bulunur.</dd>
<dt><code>--with-suexec-safepath</code></dt>
<dd><code class="program"><a href="../programs/suexec.html">suexec</a></code> tarafından çalıştırılacak süreçlerin
çalıştırılabilirlerinin bulunabileceği dizinleri <code>PATH</code>
ortam değişkenine tanımlamak için kullanılır.
<code>/usr/local/bin:/usr/bin:/bin</code> öntanımlıdır.</dd>
<dt><code>--with-suexec-userdir</code></dt>
<dd>Bu seçenek, kullanıcı dizinleri altında <code class="program"><a href="../programs/suexec.html">suexec</a></code>
tarafından çalıştırılacak süreçlerin çalıştırılabilirlerinin
bulunabileceği alt dizini tanımlar. <code class="program"><a href="../programs/suexec.html">suexec</a></code>
programını (<code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code> tarafından sağlanan)
kullanıcıya özel dizinlerde kullanmak istediğinizde bu gereklidir.
<code>public_html</code> alt dizini öntanımlıdır.</dd>
<dt><code>--with-suexec-uidmin</code></dt>
<dd><code class="program"><a href="../programs/suexec.html">suexec</a></code> için hedef kullanıcı olmasına izin
verilen en küçük kullanıcı kimliğini tanımlamak için kullanılır.
100 öntanımlıdır.</dd>
<dt><code>--with-suexec-umask</code></dt>
<dd><code class="program"><a href="../programs/suexec.html">suexec</a></code> tarafından çalıştırılacak süreçler için
<code>umask</code> tanımlar. Sisteminiz için geçerli ayarlar
öntanımlıdır.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="env" id="env">Ortam Değişkenleri</a></h2>
<p><code>configure</code> betiğinin yerleri ve isimleri standartlara uygun
olmayan kütüphaneleri ve programları bulmasını yardımcı olan veya
<code>configure</code> betiği tarafından yapılan bazı seçimleri
değiştirmenizi sağlayacak bazı ortam değişkenleri vardır.</p>
<dl>
<dt><code>CC</code></dt>
<dd>Bu değişkenle derleme sırasında kullanılacak C derleyici komutu
tanımlanır.</dd>
<dt><code>CFLAGS</code></dt>
<dd>Bu değişkenle derleme sırasında kullanılacak C derleyici seçenekleri
tanımlanır.</dd>
<dt><code>CPP</code></dt>
<dd>Bu değişkenle derleme sırasında kullanılacak C önişlemci komutu
tanımlanır.</dd>
<dt><code>CPPFLAGS</code></dt>
<dd>C/C++ önişlemci seçenekleri tanımlanır. Örneğin, eğer başlık
dosyaları standart yerlerinde değil de
<code><var>includedir</var></code> dizinindeyse bunu
<code>-I<var>includedir</var></code> seçeneği olarak
belirtebilirsiniz.</dd>
<dt><code>LDFLAGS</code></dt>
<dd>İlintileyici seçenekleri tanımlanır. Örneğin, eğer kütüphane
dosyalarınız standart yerlerinde değil de
<code><var>libdir</var></code> dizinindeyse bunu
<code>-L<var>libdir</var></code> seçeneği olarak belirtebilirsiniz.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/configure.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/configure.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/configure.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/configure.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htcacheclean.html.ko.euc-kr 0000664 0001751 0001751 00000021656 14743132254 023765 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htcacheclean - ũ ij ûѴ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>htcacheclean - ũ ij ûѴ</h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htcacheclean.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htcacheclean.html" title="Korean"> ko </a> |
<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>htcacheclean</code> <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>
ϴ 뷮 ѵ Ѵ.
ϰų (daemon) ִ. α
ϸ 忡 ڰ ִٰ ֱ ij
丮 ִ ˻Ѵ. TERM̳
INT ñ׳ ϰ Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">ڵ</a></li>
</ul><h3></h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p><code><strong>htcacheclean</strong>
[ -<strong>D</strong> ]
[ -<strong>v</strong> ]
[ -<strong>r</strong> ]
[ -<strong>n</strong> ]
-<strong>p</strong><var>path</var>
-<strong>l</strong><var>limit</var></code></p>
<p><code><strong>htcacheclean</strong> -<strong>b</strong>
[ -<strong>n</strong> ]
[ -<strong>i</strong> ]
-<strong>d</strong><var>interval</var>
-<strong>p</strong><var>path</var>
-<strong>l</strong><var>limit</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<dl>
<dt><code>-d<var>interval</var></code></dt>
<dd> Ͽ <var>interval</var> и ij
ûѴ. ɼ <code>-D</code>, <code>-v</code>,
<code>-r</code> ɼǰ Բ . ϰ
Ϸ <code>SIGTERM</code> Ȥ
<code>SIGINT</code> ñ׳ ȴ.</dd>
<dt><code>-D</code></dt>
<dd>˻縸 ϰ ƹ͵ ʴ´. ɼ
<code>-d</code> ɼǰ Բ .</dd>
<dt><code>-v</code></dt>
<dd>ڼ 踦 Ѵ. ɼ <code>-d</code> ɼǰ
Բ .</dd>
<dt><code>-r</code></dt>
<dd> ûѴ. ġ ʴ´ٰ Ѵ
( Ѵٸ ij ̻ ȴ). ɼ
<code>-d</code> ɼǰ Բ .</dd>
<dt><code>-n</code></dt>
<dd>ģϰ(nice) Ѵ. ٸ μ
Ѵ. <code>htcacheclean</code> ڰԵǿ
(1) ũ ǰ (2) Ŀ ٸ μ
ִ.</dd>
<dt><code>-p<var>path</var></code></dt>
<dd><var>path</var> ũ ij ֻ 丮 Ѵ.
<code class="directive"><a href="../mod/mod_cache_disk.html#cacheroot">CacheRoot</a></code>
þ ؾ Ѵ.</dd>
<dt><code>-l<var>limit</var></code></dt>
<dd>ü ũ ij 뷮 <var>limit</var> Ѵ.
⺻ (Ȥ ڿ <code>B</code> ̸) Ʈ
̴. ųιƮ <code>K</code>, ްƮ
<code>M</code> ڿ δ.</dd>
<dt><code>-i</code></dt>
<dd> ũ ij 쿡 Ѵ.
ɼ <code>-d</code> ɼǰ Բ ִ.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">ڵ</a></h2>
<p><code>htcacheclean</code> ۾ 쿡
("") ڵ 0 ȯϰ, 쿡 <code>1</code>
ȯѴ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htcacheclean.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htcacheclean.html" title="Korean"> ko </a> |
<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htcacheclean.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/index.html.es 0000664 0001751 0001751 00000016336 14743132254 021302 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>El Servidor Apache y Programas de Soporte - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="../images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a></div><div id="page-content"><div id="preamble"><h1>El Servidor Apache y Programas de Soporte</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/programs/" title="Español"> es </a> |
<a href="../fr/programs/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Esta página contiene toda la documentación sobre los programas
ejecutables incluidos en el servidor Apache.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="index" id="index">Índice</a></h2>
<dl>
<dt><code class="program"><a href="../programs/httpd.html">httpd</a></code></dt>
<dd>Servidor Apache del Protocolo de Transmisión de
Hipertexto (HTTP)</dd>
<dt><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></dt>
<dd>Interfaz de control del servidor HTTP Apache </dd>
<dt><code class="program"><a href="../programs/ab.html">ab</a></code></dt>
<dd>Herramienta de benchmarking del Servidor HTTP Apache</dd>
<dt><code class="program"><a href="../programs/apxs.html">apxs</a></code></dt>
<dd>Herramienta de Extensión de Apache</dd>
<dt><code class="program"><a href="../programs/configure.html">configure</a></code></dt>
<dd>Configuración de la estructura de directorios de Apache</dd>
<dt><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></dt>
<dd>Crea y actualiza los archivos de autentificación de usuarios
en formato DBM para autentificación básica</dd>
<dt><code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code></dt>
<dd>Ejecuta un programa FastCGI.</dd>
<dt><code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code></dt>
<dd>Vacía la caché del disco.</dd>
<dt><code class="program"><a href="../programs/htdigest.html">htdigest</a></code></dt>
<dd>Crea y actualiza los ficheros de autentificación de usuarios
para autentificación tipo digest</dd>
<dt><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></dt>
<dd>Manipula la base de datos DBM de contraseñas.</dd>
<dt><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code></dt>
<dd>Crea y actualiza los ficheros de autentificación de usuarios
para autentificación tipo básica</dd>
<dt><code class="program"><a href="../programs/httxt2dbm.html">httxt2dbm</a></code></dt>
<dd>Crea ficheros dbm para que se usen con RewriteMap</dd>
<dt><code class="program"><a href="../programs/logresolve.html">logresolve</a></code></dt>
<dd>Resuelve los nombres de host para direcciones IP que están
en los ficheros log de Apache</dd>
<dt><code class="program"><a href="../programs/log_server_status.html">log_server_status</a></code></dt>
<dd>Logea de forma periódica el estado del servidor.</dd>
<dt><code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code></dt>
<dd>Renueva los logs de Apache sin tener que parar el servidor</dd>
<dt><code class="program"><a href="../programs/split-logfile.html">split-logfile</a></code></dt>
<dd>Divide un archivo de registro multi-host virtual en
archivos de registro por host</dd>
<dt><code class="program"><a href="../programs/suexec.html">suexec</a></code></dt>
<dd>Programa para cambiar la identidad de
usuario con la que se ejecuta un CGI</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/programs/" title="Español"> es </a> |
<a href="../fr/programs/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/logresolve.html.ko.euc-kr 0000664 0001751 0001751 00000015334 14743132254 023540 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>logresolve - ġ α IP-ּҸ ȣƮ
ȯѴ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>logresolve - ġ α IP-ּҸ ȣƮ
ȯѴ</h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/logresolve.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/logresolve.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/logresolve.html" title="Korean"> ko </a> |
<a href="../tr/programs/logresolve.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><code>logresolve</code> ġ ٷαϿ ִ
IP-ּҸ ã ó α̴. Ӽ ϸ
ּȭϱ logresolve ؽ̺ ij
Ѵ. , IP ּҰ αϿ ó ö ã´.</p>
<p>ǥԷ ġ α д´. ù°
IP ּ̰, κа еǾ Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p><code><strong>logresolve</strong> [ -<strong>s</strong>
<var>filename</var> ] [ -<strong>c</strong> ] <
<var>access_log</var> > <var>access_log.new</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<dl>
<dt><code>-s <var>filename</var></code></dt>
<dd>踦 ϸ Ѵ.</dd>
<dt><code>-c</code></dt>
<dd><code>logresolve</code> DNS ˻縦 ϵ Ѵ:
IP ּҷ ȣƮ ã ȣƮ ٽ IP ּҵ
ãƼ ϳ ּҿ ġϴ ˻Ѵ.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/logresolve.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/logresolve.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/logresolve.html" title="Korean"> ko </a> |
<a href="../tr/programs/logresolve.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/logresolve.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htdigest.html.tr.utf8 0000664 0001751 0001751 00000020656 14743132254 022711 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htdigest - Özet kimlik doğrulama dosyalarını yönetir - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>htdigest - Özet kimlik doğrulama dosyalarını yönetir</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/htdigest.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htdigest.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htdigest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htdigest.html" title="Türkçe"> tr </a></p>
</div>
<p><code><strong>htdigest</strong></code>, HTTP kullanıcılarının digest
türü kimlik doğrulaması için kullanıcı isimlerinin ve parolalarının
saklanmasında kullanılacak düz metin dosyalarını oluşturmak ve güncellemek
için kullanılır. Apache HTTP sunucusunun mevcut özkaynaklarının kullanımı
sadece <code><strong>htdigest</strong></code> tarafından oluşturulan
dosyalarda listelenmiş kullanıcılara tahsis edilebilir.</p>
<p>Bu kılavuz sayfası sadece komut satırı değiştirgelerini listeler.
Kullanıcı kimlik doğrulamasını
<strong><code class="program"><a href="../programs/httpd.html">httpd</a></code></strong>'de yapılandırmak için gerekli
yönergelerle ilgili ayrıntılar için Apache dağıtımının bir parçası olan
ve <a href="http://httpd.apache.org/"> http://httpd.apache.org/</a>
adresinde de bulunan Apache HTTP Sunucusu Belgelerine bakınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Güvenlik Değerlendirmeleri</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>htdigest</strong> [ -<strong>c</strong> ]
<var>parola-dosyası</var> <var>bölge</var> <var>kullanıcı</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code><strong>-c</strong></code></dt>
<dd><code><var>parola-dosyası</var></code> oluşturur. Dosya mevcutsa,
dosya silinip yeniden yazılır.</dd>
<dt><code><var>parola-dosyası</var></code></dt>
<dd>Kullanıcı ismi, parola ve bölge bilgilerini içeren dosyanın ismi.
<code><strong>-c</strong></code> seçeneği verilmişse ve dosya mevcut
değilse oluşturulur, dosya mevcutsa silinip yeniden oluşturulur.</dd>
<dt><code><var>bölge</var></code></dt>
<dd>Kullanıcının mensup olduğu bölge ismi. Daha fazla bilgi için:
<a href="http://tools.ietf.org/html/rfc2617#section-3.2.1">
http://tools.ietf.org/html/rfc2617#section-3.2.1</a></dd>
<dt><code><var>kullanıcı</var></code></dt>
<dd><code><var>parola-dosyası</var></code>'nda oluşturulacak veya
güncellenecek kullanıcı ismi. <code><var>kullanıcı</var></code> bu
dosyada mevcut değilse yeni bir girdi eklenir. Girdi mevcutsa parolası
değiştirilir.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Güvenlik Değerlendirmeleri</a></h2>
<p>Bu program bir setuid çalıştırılabiliri olarak güvenilir olmadığından
<em>setuid yapılmamalıdır</em>.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/htdigest.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htdigest.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htdigest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htdigest.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htdigest.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/httxt2dbm.html.tr.utf8 0000664 0001751 0001751 00000017770 14743132254 023021 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>httxt2dbm - RewriteMap ile kullanmak için DBM dosyaları üretir - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>httxt2dbm - RewriteMap ile kullanmak için DBM dosyaları üretir</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/httxt2dbm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/httxt2dbm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/httxt2dbm.html" title="Türkçe"> tr </a></p>
</div>
<p><code><strong>httxt2dbm</strong></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> ile kullanmak için düz metin
dosyalardan DBM dosyaları üretir.</p>
<p>Çıktı dosyası mevcutsa dosya kırpılmaz. Yeni anahtarlar eklenir,
mevcutlar da güncellenir.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Kullanım</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Seçenekler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Örnekler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></li><li><a href="#comments_section">Yorumlar</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="synopsis" id="synopsis">Kullanım</a></h2>
<p><code><strong>httxt2dbm</strong>
[ -<strong>v</strong> ]
[ -<strong>f</strong> <var>DBM_türü</var> ]
-<strong>i</strong> <var>kaynak_metin</var>
-<strong>o</strong> <var>çıktı_DBM</var>
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Seçenekler</a></h2>
<dl>
<dt><code><strong>-v</strong></code></dt>
<dd>Çıktı daha ayrıntılı olur.</dd>
<dt><code><strong>-f</strong> <var>DBM_türü</var></code></dt>
<dd>Çıktı için kullanılacak DBM türü belirtilir. Belirtilmediği takdirde
<a class="glossarylink" href="../glossary.html#apr" title="sözlüğe bakınız">APR</a> öntanımlısı kullanılır. Belirtilebilecek DBM
türleri:
GDBM dosyalar için <code>GDBM</code>,
SDBM dosyalar için <code>SDBM</code>,
Berkeley DB dosyalar için <code>DB</code>,
NDBM dosyalar için <code>NDBM</code>,
öntanımlı DBM türü için <code>default</code>
</dd>
<dt><code><strong>-i</strong> <var>kaynak_metin</var></code></dt>
<dd>DBM dosyasının üretiminde kullanılacak girdi dosyası belirtilir. Bu
dosya, her satırda bir kayıt bulunmak üzere her satırı şöyle biçemlenmiş
olmalıdır:
<code>anahtar değer</code>.
Bu dosyanın biçemi ve manası ile ilgili ayrıntılar için <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> yönergesinin açıklamasına
bakınız.
</dd>
<dt><code><strong>-o</strong> <var>çıktı_DBM</var></code></dt>
<dd>Çıktılanacak DBM dosyasının ismi belirtilir.</dd>
</dl>
</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">Örnekler</a></h2>
<div class="example"><p><code>
httxt2dbm -i rewritemap.txt -o rewritemap.dbm<br />
httxt2dbm -f SDBM -i rewritemap.txt -o rewritemap.dbm<br />
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/httxt2dbm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/httxt2dbm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/httxt2dbm.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/httxt2dbm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/other.html 0000664 0001751 0001751 00000000566 13710016232 020672 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: other.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: other.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: other.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: other.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/index.html.en 0000664 0001751 0001751 00000015133 14737241666 021302 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Server and Supporting Programs - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Server and Supporting Programs</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/" title="English"> en </a> |
<a href="../es/programs/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/programs/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>This page documents all the executable programs included
with the Apache HTTP Server.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="index" id="index">Index</a></h2>
<dl>
<dt><code class="program"><a href="../programs/httpd.html">httpd</a></code></dt>
<dd>Apache hypertext transfer protocol server</dd>
<dt><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></dt>
<dd>Apache HTTP server control interface</dd>
<dt><code class="program"><a href="../programs/ab.html">ab</a></code></dt>
<dd>Apache HTTP server benchmarking tool</dd>
<dt><code class="program"><a href="../programs/apxs.html">apxs</a></code></dt>
<dd>APache eXtenSion tool</dd>
<dt><code class="program"><a href="../programs/configure.html">configure</a></code></dt>
<dd>Configure the source tree</dd>
<dt><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></dt>
<dd>Create and update user authentication files in DBM format
for basic authentication</dd>
<dt><code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code></dt>
<dd>Start a FastCGI program</dd>
<dt><code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code></dt>
<dd>Clean up the disk cache</dd>
<dt><code class="program"><a href="../programs/htdigest.html">htdigest</a></code></dt>
<dd>Create and update user authentication files for digest
authentication</dd>
<dt><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></dt>
<dd>Manipulate DBM password databases.</dd>
<dt><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code></dt>
<dd>Create and update user authentication files for basic
authentication</dd>
<dt><code class="program"><a href="../programs/httxt2dbm.html">httxt2dbm</a></code></dt>
<dd>Create dbm files for use with RewriteMap</dd>
<dt><code class="program"><a href="../programs/logresolve.html">logresolve</a></code></dt>
<dd>Resolve hostnames for IP-addresses in Apache
logfiles</dd>
<dt><code class="program"><a href="../programs/log_server_status.html">log_server_status</a></code></dt>
<dd>Periodically log the server's status</dd>
<dt><code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code></dt>
<dd>Rotate Apache logs without having to kill the server</dd>
<dt><code class="program"><a href="../programs/split-logfile.html">split-logfile</a></code></dt>
<dd>Split a multi-vhost logfile into per-host logfiles</dd>
<dt><code class="program"><a href="../programs/suexec.html">suexec</a></code></dt>
<dd>Switch User For Exec</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/" title="English"> en </a> |
<a href="../es/programs/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/programs/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/index.html.zh-cn.utf8 0000664 0001751 0001751 00000015030 14743132254 022565 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP 服务器与支持程序 - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">模块</a> | <a href="../mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Apache HTTP 服务器与支持程序</h1>
<div class="toplang">
<p><span>可用语言: </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/programs/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/programs/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">此翻译可能过期。要了解最近的更改，请阅读英文版。</div>
<p>本页描述了 Apache HTTP 服务器包含的所有可执行程序。</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="index" id="index">索引</a></h2>
<dl>
<dt><code class="program"><a href="../programs/httpd.html">httpd</a></code></dt>
<dd>Apache 服务器。</dd>
<dt><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></dt>
<dd>Apache HTTP 服务器控制工具。</dd>
<dt><code class="program"><a href="../programs/ab.html">ab</a></code></dt>
<dd>Apache HTTP 服务器性能基准工具。</dd>
<dt><code class="program"><a href="../programs/apxs.html">apxs</a></code></dt>
<dd>Apache 扩展工具。</dd>
<dt><code class="program"><a href="../programs/configure.html">configure</a></code></dt>
<dd>配置源代码。</dd>
<dt><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></dt>
<dd>为基本认证创建和更新 DBM 格式的用户认证文件。</dd>
<dt><code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code></dt>
<dd>启动 FastCGI 程序。</dd>
<dt><code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code></dt>
<dd>清理磁盘缓存。</dd>
<dt><code class="program"><a href="../programs/htdigest.html">htdigest</a></code></dt>
<dd>为摘要认证创建和更新用户认证文件。</dd>
<dt><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></dt>
<dd>操作 DBM 密码数据库。</dd>
<dt><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code></dt>
<dd>为基本认证创建和更新用户认证文件。</dd>
<dt><code class="program"><a href="../programs/httxt2dbm.html">httxt2dbm</a></code></dt>
<dd>为 RewriteMap 创建 dbm 文件。</dd>
<dt><code class="program"><a href="../programs/logresolve.html">logresolve</a></code></dt>
<dd>将 Apache 日志文件中的 IP 地址解析到主机名称。</dd>
<dt><a href="other.html#log_server_status">log_server_status</a></dt>
<dd>周期性的记录服务器状态。</dd>
<dt><code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code></dt>
<dd>不关闭 Apache 而切换日志文件。</dd>
<dt><a href="other.html#split-logfile">split-logfile</a></dt>
<dd>将多个虚拟主机的日志文件按照主机拆分。</dd>
<dt><code class="program"><a href="../programs/suexec.html">suexec</a></code></dt>
<dd>执行外部程序前切换用户。</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>可用语言: </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/programs/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/programs/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/other.html.tr.utf8 0000664 0001751 0001751 00000012344 14743132254 022212 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Diğer Programlar - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a> > <a href="./">Programlar</a></div><div id="page-content"><div id="preamble"><h1>Diğer Programlar</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/programs/other.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/other.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/other.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/other.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu sayfada daha önce belgelenen programlar şimdi kendi belgelerine
sahiptir. Bu sayfaya verilmiş bağlantıları lütfen güncelleyin.</p>
<p><code class="program"><a href="../programs/log_server_status.html">log_server_status</a></code></p>
<p><code class="program"><a href="../programs/split-logfile.html">split-logfile</a></code></p>
</div>
</div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/programs/other.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/other.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/other.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/other.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/other.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/other.html.ko.euc-kr 0000664 0001751 0001751 00000015135 14743132254 022477 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Other Programs - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>Other Programs</h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/other.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/other.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/other.html" title="Korean"> ko </a> |
<a href="../tr/programs/other.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> Ͽ manpage , ġ Ե
α̴. ڵ ̵ ġ ʴ´.
<code>support/</code> 丮 α
ã ִ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#log_server_status">log_server_status</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#split-logfile">split-logfile</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="log_server_status" id="log_server_status">log_server_status</a></h2>
<p> perl ũƮ cron ϵ Ǿ.
ũƮ Ͽ ٿεѴ.
ٷ Ͽ Ͽ Ѵ. α
ġ Ϸ ũƮ պκ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="split-logfile" id="split-logfile">split-logfile</a></h2>
<p> perl ũƮ յ ٷα
Ϸ . ù° ("<code>%v</code>"
߰) ȣƮ ̰, αϸ 丮
ȣƮ + "<code>.log</code>" Ѵ.</p>
<p>յ α ǥԷ д´.
αϵ鿡 ߰Ѵ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/other.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/other.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/other.html" title="Korean"> ko </a> |
<a href="../tr/programs/other.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/other.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/index.html.ko.euc-kr 0000664 0001751 0001751 00000012765 14743132254 022473 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title> α - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1> α</h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/programs/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/programs/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/" title="Korean"> ko </a> |
<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>ġ Ե α̴.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="index" id="index"></a></h2>
<dl>
<dt><a href="httpd.html">httpd</a></dt>
<dd>ġ ؽƮ </dd>
<dt><a href="apachectl.html">apachectl</a></dt>
<dd>ġ ̽</dd>
<dt><a href="ab.html">ab</a></dt>
<dd>ġ ɰ˻ </dd>
<dt><a href="apxs.html">apxs</a></dt>
<dd>ġ Ȯ (APache eXtenSion tool)</dd>
<dt><a href="configure.html">configure</a></dt>
<dd>ҽ Ʈ Ѵ</dd>
<dt><a href="dbmmanage.html">dbmmanage</a></dt>
<dd>basic authentication DBM
Ѵ</dd>
<dt><a href="htcacheclean.html">htcacheclean</a></dt>
<dd>ũ ij ûѴ</dd>
<dt><a href="htdigest.html">htdigest</a></dt>
<dd>digest authentication
Ѵ</dd>
<dt><a href="htpasswd.html">htpasswd</a></dt>
<dd>basic authentication
Ѵ</dd>
<dt><a href="logresolve.html">logresolve</a></dt>
<dd>ġ α IP-ּҸ ȣƮ ȯѴ</dd>
<dt><a href="rotatelogs.html">rotatelogs</a></dt>
<dd> ʰ ġ α ȯѴ</dd>
<dt><a href="suexec.html">suexec</a></dt>
<dd> ڸ Ѵ (Switch User For Exec)</dd>
<dt><a href="other.html">ٸ α</a></dt>
<dd>manpage .</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../es/programs/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="../fr/programs/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/" title="Korean"> ko </a> |
<a href="../tr/programs/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/programs/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/fcgistarter.html.fr.utf8 0000664 0001751 0001751 00000015166 14740503670 023376 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>fcgistarter - Démarrer un programme FastCGI - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>fcgistarter - Démarrer un programme FastCGI</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/fcgistarter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/fcgistarter.html" title="Français"> fr </a> |
<a href="../tr/programs/fcgistarter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p />
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#note">Note</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></li><li><a href="#comments_section">Commentaires</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="note" id="note">Note</a></h2>
<p>Ne fonctionne actuellement que sur les systèmes de type Unix.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>fcgistarter</strong>
-<strong>c</strong> <var>commande</var>
-<strong>p</strong> <var>port</var>
[ -<strong>i</strong> <var>interface</var> ]
-<strong>N</strong> <var>nombre</var>
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-c <var>commande</var></code></dt>
<dd>Le chemin absolu du programme FastCGI</dd>
<dt><code>-p <var>port</var></code></dt>
<dd>Port sur lequel le programme va se mettre en écoute</dd>
<dt><code>-i <var>interface</var></code></dt>
<dd>Interface sur laquelle le programme va se mettre en écoute</dd>
<dt><code>-N <var>nombre</var></code></dt>
<dd>Nombre d'instances du programme</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/fcgistarter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/fcgistarter.html" title="Français"> fr </a> |
<a href="../tr/programs/fcgistarter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/fcgistarter.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/dbmmanage.html.fr.utf8 0000664 0001751 0001751 00000034471 14740503670 022774 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>dbmmanage - Gestion des fichiers d'authentification des
utilisateurs au format DBM - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>dbmmanage - Gestion des fichiers d'authentification des
utilisateurs au format DBM</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/dbmmanage.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/dbmmanage.html" title="Français"> fr </a> |
<a href="../ko/programs/dbmmanage.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/dbmmanage.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>dbmmanage</code> permet de créer et de maintenir les
fichiers au format DBM où sont stockés les noms d'utilisateurs et
mots de passe à des fins d'authentification de base des utilisateurs
HTTP via le module <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>. Il est possible
de restreindre l'accès aux ressources disponibles sur le serveur
HTTP Apache aux seuls utilisateurs spécifiés dans les fichiers créés
par <code>dbmmanage</code>. Ce programme ne peut être utilisé
qu'avec des fichiers d'utilisateurs au format DBM. Pour
l'utilisation de fichiers textes, voir le programme
<code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>.</p>
<p>Le programme <code class="program"><a href="../programs/htdbm.html">htdbm</a></code> est aussi un utilitaire
permettant de maintenir une base de données de mots de passe DBM.</p>
<p>Cette page de manuel ne décrit que les arguments de la ligne de
commande. Pour plus de détails à propos des directives nécessaires
pour configurer l'authentification des utilisateurs dans
<code class="program"><a href="../programs/httpd.html">httpd</a></code>, voir le manuel httpd qui est fourni avec
la distribution d'Apache, ou peut être consulté à <a href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Bogues</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></li><li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li><li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></li><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>dbmmanage</strong> [ <var>codage</var> ]
<var>nom-fichier</var> add|adduser|check|delete|update
<var>nom-utilisateur</var>
[ <var>mot-de-passe-haché</var>
[ <var>groupe</var>[,<var>groupe</var>...]
[ <var>commentaire</var> ] ] ]</code></p>
<p><code><strong>dbmmanage</strong> <var>nom-fichier</var>
view [ <var>nom-utilisateur</var> ]</code></p>
<p><code><strong>dbmmanage</strong> <var>nom-fichier</var>import</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code><var>nom-fichier</var></code></dt>
<dd>Le nom du fichier au format DBM, en général sans l'extension
<code>.db</code>, <code>.pag</code>, ou <code>.dir</code>.</dd>
<dt><code><var>nom-utilisateur</var></code></dt>
<dd>L'utilisateur concerné par l'opération effectuée. Le
<var>nom-utilisateur</var> ne doit pas contenir de caractère
<code>:</code>.</dd>
<dt><code><var>mot-de-passe-haché</var></code></dt>
<dd>C'est le mot de passe sous sa forme hachée à utiliser avec les
commandes <code>update</code> et <code>add</code>. Vous pouvez
utiliser un tiret (<code>-</code>) si vous voulez que le mot de
passe vous soit demandé, mais remplissez les champs par la suite. En
outre, avec la commande <code>update</code>, un point
(<code>.</code>) permet de conserver le mot de passe original.</dd>
<dt><code><var>groupe</var></code></dt>
<dd>Un groupe dont l'utilisateur est membre. Un nom de groupe ne
doit pas contenir de caractère (<code>:</code>). Vous pouvez
utiliser un tiret (<code>-</code>) si vous ne voulez pas associer
l'utilisateur à un groupe, mais remplissez le champ commentaire. En
outre, avec la commande <code>update</code>, un point
(<code>.</code>) permet de conserver le groupe original.</dd>
<dt><code><var>commentaire</var></code></dt>
<dd>C'est l'endroit où vous pouvez enregistrer diverses informations
à propos de l'utilisateur telles que son nom réel, sont e-mail,
etc... Le serveur ignore ce champ.</dd>
</dl>
<h3><a name="options.encodings" id="options.encodings">Codages</a></h3>
<dl>
<dt><code>-d</code></dt>
<dd>hachage crypt (hachage par défaut sauf sous Win32,
Netware)</dd>
<dt><code>-m</code></dt>
<dd>hachage MD5 (hachage par défaut sous Win32,
Netware)</dd>
<dt><code>-s</code></dt>
<dd>hachage SHA1</dd>
<dt><code>-p</code></dt>
<dd>en clair (<em>déconseillé</em>)</dd>
</dl>
<h3><a name="options.commands" id="options.commands">Commandes</a></h3>
<dl>
<dt><code>add</code></dt>
<dd>Ajoute une entrée pour <var>nom-utilisateur</var> à
<var>nom-fichier</var> en utilisant le mot de passe haché
<var>mot-de-passe-haché</var>.
<div class="example"><p><code>dbmmanage passwords.dat add rbowen foKntnEF3KSXA</code></p></div>
</dd>
<dt><code>adduser</code></dt>
<dd>Demande un mot de passe puis ajoute une entrée pour
<var>nom-utilisateur</var> à <var>nom-fichier</var>.
<div class="example"><p><code>dbmmanage passwords.dat adduser krietz</code></p></div>
</dd>
<dt><code>check</code></dt>
<dd>Demande un mot de passe puis vérifie si
<var>nom-utilisateur</var> est présent dans <var>nom-fichier</var>
et si son mot de passe correspond au mot de passe fourni.
<div class="example"><p><code>dbmmanage passwords.dat check rbowen</code></p></div>
</dd>
<dt><code>delete</code></dt>
<dd>Supprime l'entrée <var>nom-utilisateur</var> de
<var>nom-fichier</var>.
<div class="example"><p><code>dbmmanage passwords.dat delete rbowen</code></p></div>
</dd>
<dt><code>import</code></dt>
<dd>Lit les entrées
<code><var>nom-utilisateur</var>:<var>mot-de-passe</var></code>
(une par ligne) depuis <code>STDIN</code>, et les ajoute à
<var>nom-fichier</var>. Les mots de passe doivent être déjà
chiffrés.</dd>
<dt><code>update</code></dt>
<dd>Identique à la commande <code>adduser</code>, à l'exception
que la présence de <var>nom-utilisateur</var> dans
<var>nom-fichier</var> est vérifiée.
<div class="example"><p><code>dbmmanage passwords.dat update rbowen</code></p></div>
</dd>
<dt><code>view</code></dt>
<dd>Affiche le contenu du fichier DBM. Si vous spécifiez un
<var>nom-utilisateur</var>, seule l'entrée correspondante est
affichée.
<div class="example"><p><code>dbmmanage passwords.dat view</code></p></div>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="bugs" id="bugs">Bogues</a></h2>
<p>Vous devez garder à l'esprit qu'il existe de nombreux formats de
fichiers DBM différents, et que selon toute vraisemblance, des
bibliothèques pour plus d'un format sont présentes sur votre
système. Les trois exemples de base sont SDBM, NDBM, le projet GNU
GDBM, et Berkeley DB 2. Malheureusement, toutes ces bibliothèques
utilisent des formats de fichiers différents, et vous devez vous
assurer que le format de fichier utilisé par <var>nom-fichier</var>
correspond au format attendu par <code>dbmmanage</code>.
Actuellement, <code>dbmmanage</code> n'a aucun moyen de savoir à
quel type de fichier DBM il a à faire. S'il est utilisé avec un
format inapproprié, il ne renverra rien, ou pourra créer un fichier
DBM différent avec un nom différent, ou au pire, va corrompre le
fichier DBM si vous avez tenté de le modifier.</p>
<p><code>dbmmanage</code> possède une liste de préférences en
matière de formats DBM, définies dans le tableau
<code>@AnyDBM::ISA</code> au début du programme. Comme nous
préférons le format de fichier Berkeley DB 2, l'ordre dans lequel
<code>dbmmanage</code> va rechercher les bibliothèques système est
Berkeley DB 2, puis NDBM, GDBM et enfin SDBM. La première
bibliothèque trouvée sera celle que <code>dbmmanage</code> tentera
d'utiliser pour toutes les opérations sur les fichiers DBM. Cette
ordre est sensiblement différent de l'ordre standard de Perl
<code>@AnyDBM::ISA</code>, et de l'ordre utilisé par l'appel
<code>dbmopen()</code> de Perl ; si vous utilisez un autre
utilitaire pour gérer vos fichiers DBM, il doit donc se conformer à
l'ordre de préférence indiqué précédemment. Vous devez prêter la
même attention si vous utilisez des programmes écrits dans d'autres
langages, comme C, pour accéder à ces fichiers.</p>
<p>Vous pouvez utiliser le programme <code>file</code> fourni par la
plupart des systèmes Unix pour déterminer le format d'un fichier
DBM.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/dbmmanage.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/dbmmanage.html" title="Français"> fr </a> |
<a href="../ko/programs/dbmmanage.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/dbmmanage.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/dbmmanage.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/rotatelogs.html.fr.utf8 0000664 0001751 0001751 00000046514 14740503670 023245 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>rotatelogs - Rotation des journaux d'Apache par redirection de
ces derniers dans un "pipe" - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>rotatelogs - Rotation des journaux d'Apache par redirection de
ces derniers dans un "pipe"</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/rotatelogs.html" title="Français"> fr </a> |
<a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>rotatelogs</code> est un programme simple à utiliser en
conjonction avec la fonctionnalité d'Apache de redirection dans un
"pipe" des fichiers journaux. Il supporte une rotation basée sur un
intervalle de temps ou une taille maximale du journal.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#portability">Portabilité</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>rotatelogs</strong>
[ -<strong>l</strong> ]
[ -<strong>L</strong> <var>nom-lien</var> ]
[ -<strong>p</strong> <var>programme</var> ]
[ -<strong>f</strong> ]
[ -<strong>D</strong> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
[ -<strong>e</strong> ]
[ -<strong>c</strong> ]
[ -<strong>n</strong> <var>nombre-de-fichiers</var> ]
<var>fichier-journal</var>
<var>heure-de-rotation</var>|<var>taille-fichier</var>(B|K|M|G)
[ <var>décalage</var> ]</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-l</code></dt>
<dd>Utilise le temps local plutôt que GMT comme base pour l'intervalle
de temps ou pour le formatage de <code>strftime(3)</code> avec une
rotation basée sur la taille.</dd>
<dt><code>-L</code> <var>nom-lien</var></dt>
<dd><p>Etablit un lien physique entre le fichier journal courant et le lien
spécifié. Cette option permet de consulter le journal de manière
continue malgré les rotations via une commande du style <code>tail -F
nom-lien</code>.</p>
<p>Si le nom du lien spécifié n'est pas un chemin absolu, il est relatif au
répertoire de travail de <code>rotatelogs</code> qui correspond à la valeur de
la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> lorsque la commande
<code>rotatelogs</code> est exécutée par le serveur.
</p>
</dd>
<dt><code>-p</code> <var>programme</var></dt>
<dd>Avec cette option, <code>rotatelogs</code> exécutera le programme
<var>programme</var> chaque fois qu'un nouveau fichier journal sera
ouvert. Le nom du fichier nouvellement ouvert est passé comme premier
argument au programme. Si l'exécution se produit après une rotation,
l'ancien nom du fichier journal est passé au programme comme second
argument. <code>rotatelogs</code>
n'attend pas la fin du <var>programme</var> pour continuer son
exécution, et cessera tout enregistrement de codes d'erreur lorsqu'il
aura terminé son processus. Le <var>programme</var> utilise les mêmes
canaux stdin, stdout, et stderr que rotatelogs, et hérite de son
environnement.</dd>
<dt><code>-f</code></dt>
<dd>Ouvre le fichier journal immédiatement, dès que
<code>rotatelogs</code> démarre, au lieu d'attendre la lecture de la
première entrée de journal (pour les sites peu chargés, il peut
s'écouler un temps substantiel entre le démarrage du serveur et le
traitement de la première requête, temps pendant lequel le fichier
journal associé n'"existe" pas, ce qui peut causer des problèmes à
certains utilitaires de journalisation automatiques).</dd>
<dt><code>-D</code></dt>
<dd>Crée les répertoires parents du chemin du fichier journal s'ils
n'existent pas déjà, ce qui permet d'utiliser le format
<code>strftime(3)</code> dans les chemins au lieu du nom de fichier seul.</dd>
<dt><code>-t</code></dt>
<dd>Provoque une troncature du fichier journal au lieu d'une rotation.
Cela peut s'avérer utile lorsqu'un journal est élaboré en temps réel par
une commande telle que tail, l'archivage des données n'étant ici pas
nécessaire. Si aucun suffixe n'est ajouté au nom de fichier, les
chaînes de format contenant des caractères '%' sont cependant
respectées.
</dd>
<dt><code>-T</code></dt>
<dd>Provoque la troncature de tous les fichiers journaux lors de leur ouverture,
à l'exception du fichier journal initial. Cela s'avère utile lorsque la chaîne
de formatage contient quelque chose qui va se répéter de manière cyclique, comme
le jour du mois par exemple. Disponible à partir de la version 2.4.56 du serveur
HTTP Apache.
</dd>
<dt><code>-v</code></dt>
<dd>Affiche une sortie verbeuse sur STDERR. La sortie contient le
résultat de l'interprétation de la configuration, ainsi que toutes les
opérations d'ouverture et de fermeture de fichiers.</dd>
<dt><code>-c</code></dt>
<dd>Crée un fichier journal pour chaque intervalle, même s'il est vide.</dd>
<dt><code>-e</code></dt>
<dd>Envoie les messages de journalisation vers stdout. Ceci s'avère
utile lorsque les journaux doivent être traités par un autre programme.</dd>
<dt><code>-n <var>nombre-de-fichiers</var></code></dt>
<dd>Utilise une liste circulaire de noms de fichiers sans repères de temps.
Cette option permet d'écraser des fichiers journaux au démarrage et au cours de
la rotation. Avec -n 3, la série de fichiers conservés sera "logfile",
"logfile.1", "logfile.2" avec écrasement de "logfile".
<br />
Lorsque ce programme ouvre « logfile », ce dernier sera seulement tronqué si
l'option <code>-t</code> est aussi spécifiée. Toute rotation subséquente sera
précédée d'une troncature du fichier cible. Dans le cas d'une rotation basée sur
la taille sans l'option <code>-t</code> et si des fichiers journaux sont déjà en
place, cette option peut provoquer des résultats inattendus comme l'envoi des
entrées de journal initiales vers « logfile.1 », les entrées de « logfile.1 »
n'étant pas conservées, même si des fichiers « logfile.n » n'ont pas encore été
utilisés.
<br />
Disponible à partir de la version 2.4.5 du serveur HTTP Apache.</dd>
<dt><code><var>fichier-journal</var></code></dt>
<dd><p>Le chemin et le nom de base du fichier journal. Si
<var>fichier-journal</var> contient des caractères '%', il est considéré
comme une chaîne de formatage pour <code>strftime(3)</code>. Dans le cas
contraire, le suffixe <var>.nnnnnnnnnn</var> est automatiquement ajouté
et correspond au temps en secondes (sauf si l'option -t est spécifiée).
Les deux formats calculent le temps
de démarrage depuis le début de la période courante. Par exemple, si un
temps de rotation de 86400 est spécifié, les champs heure, minute et
seconde créés à partir du format <code>strftime(3)</code> auront tous
pour valeur 0, en référence au début de la période de 24 heures courante
(minuit).</p>
<p>Si vous utilisez le formatage de noms de fichiers
<code>strftime(3)</code>, assurez-vous que le format du fichier journal
possède une granularité suffisamment importante pour générer un nom de
fichier différent à chaque rotation des journaux. Si ce n'est pas le
cas, la rotation va écraser le fichier existant au lieu d'en générer un
nouveau. Par exemple, si <var>fichier-journal</var> était
<code>/var/log/errorlog.%Y-%m-%d</code> avec une rotation à 5
mégaoctets, et si la limite de 5 mégaoctets a été atteinte deux fois
dans la même journée, le même nom de fichier va être généré, et la
rotation va écraser le fichier existant.</p>
<p>Si le nom du fichier journal n'est pas un chemin absolu, il est relatif au
répertoire de travail de <code>rotatelogs</code> qui correspond à la valeur de
la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> lorsque la commande
<code>rotatelogs</code> est exécutée par le serveur.
</p>
</dd>
<dt><code><var>temps-rotation</var></code></dt>
<dd>Le temps entre deux rotations des fichiers journaux en secondes. La
rotation intervient au début de cet intervalle. Par exemple, si le temps
de rotation est de 3600, la rotation des fichiers journaux s'effectuera
au début de chaque heure ; si le temps de rotation est de 86400, la
rotation des fichiers journaux s'effectuera chaque nuit à minuit. (Si
aucune donnée n'est enregistrée au cours d'un intervalle, aucun fichier
ne sera créé).</dd>
<dt><code><var>taille-fichier</var>(B|K|M|G)</code></dt>
<dd>La taille maximale du fichier suivie par une des lettres
<code>B</code> (Octets), <code>K</code> (KOctets), <code>M</code> (MOctets)
ou <code>G</code> (GOctets).
<p>
Lorsque temps et taille sont spécifiés, la taille doit l'être après le
temps. La rotation interviendra alors aussitôt que l'une des deux limites
(temps ou taille) sera atteinte.
</p>
</dd>
<dt><code><var>décalage</var></code></dt>
<dd>Le décalage en minutes par rapport au temps UTC. Par défaut, le
décalage est considéré comme nul et c'est le temps UTC qui est utilisé.
Par exemple, pour utiliser le temps local de la zone UTC -5 heures,
spécifiez une valeur de <code>-300</code> pour cette option. Dans la
plupart des cas, il vaut mieux utiliser l'option <code>-l</code> que
spécifier un décalage.</dd>
</dl>
</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">Exemples</a></h2>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs /var/log/fichier-journal 86400" common</pre>
</div>
<p>Cette directive crée les fichiers /var/log/fichier-journal.nnnn
où nnnn correspond au temps système auquel la journalisation
démarre effectivement (ce temps sera toujours un multiple du temps
de rotation, si bien que vous pouvez synchroniser les scripts cron
avec lui). A la fin de chaque temps de rotation (ici après 24
heures), une nouvelle journalisation démarre.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -l /var/log/fichier-journal.%Y.%m.%d 86400" common</pre>
</div>
<p>Cette directive crée les fichiers
/var/log/fichier-journal.yyyy.mm.dd où yyyy correspond à l'année,
mm au mois et dd au jour du mois. La journalisation basculera vers
un nouveau fichier chaque jour à minuit, temps local.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs /var/log/fichier-journal 5M" common</pre>
</div>
<p>Cette directive va effectuer une rotation du fichier journal
chaque fois que la taille de ce dernier atteindra 5 MOctets.</p>
<div class="example"><pre class="prettyprint lang-config">ErrorLog "|bin/rotatelogs /var/log/journal-erreurs.%Y-%m-%d-%H_%M_%S 5M"</pre>
</div>
<p>Cette directive va effectuer une rotation du fichier journal des
erreurs chaque fois que la taille de ce dernier atteindra 5
MOctets, et le nom du fichier journal se présentera sous
la forme <code>journal-erreurs.YYYY-mm-dd-HH_MM_SS</code>.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -t /var/log/journal 86400" common</pre>
</div>
<p>Cet exemple crée le fichier <code>/var/log/journal</code> en le
tronquant au démarrage, puis une fois par jour. Ce scénario implique qu'un
processus séparé (tel que tail) traite le fichier en temps réel.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -T /var/log/logfile.%d 86400" common</pre>
</div>
<p>Si le serveur est démarré ou redémarré le premier du mois, cela s'ajoute à la
fin de <code>/var/log/logfile.01</code>. Lorsqu'une entrée de journal est écrite
le deux du mois, <code>/var/log/logfile.02</code> est tronqué et les nouvelles
entrées seront ajoutées à partir du début du fichier. Cet exemple conserve
environ 1 mois de journaux sans nécessiter de maintenance externe.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="portability" id="portability">Portabilité</a></h2>
<p>Les substitutions des chaînes de format du fichier journal suivantes
doivent être supportées par toutes les implémentations de
<code>strftime(3)</code> ; voir la page de manuel de
<code>strftime(3)</code> pour les extensions spécifiques à une
bibliothèque.</p>
<table class="bordered"><tr><td><code>%A</code></td><td>nom du jour de la semaine en entier
(localisé)</td></tr>
<tr class="odd"><td><code>%a</code></td><td>nom du jour de la semaine sur 3
caractères (localisé)</td></tr>
<tr><td><code>%B</code></td><td>nom du mois en entier (localisé)</td></tr>
<tr class="odd"><td><code>%b</code></td><td>nom du mois sur 3 caractères (localisé)</td></tr>
<tr><td><code>%c</code></td><td>date et heure (localisé)</td></tr>
<tr class="odd"><td><code>%d</code></td><td>jour du mois sur 2 chiffres</td></tr>
<tr><td><code>%H</code></td><td>heure sur 2 chiffres (de 0 à 24h)</td></tr>
<tr class="odd"><td><code>%I</code></td><td>heure sur 2 chiffres (de 0 à 12h)</td></tr>
<tr><td><code>%j</code></td><td>jour de l'année sur 3 chiffres</td></tr>
<tr class="odd"><td><code>%M</code></td><td>minutes sur 2 chiffres</td></tr>
<tr><td><code>%m</code></td><td>mois sur 2 chiffres</td></tr>
<tr class="odd"><td><code>%p</code></td><td>suffixe am/pm pour l'heure de 0 à 12h
(localisé)</td></tr>
<tr><td><code>%S</code></td><td>secondes sur 2 chiffres</td></tr>
<tr class="odd"><td><code>%U</code></td><td>semaine de l'année sur 2 chiffres
(Dimanche est le premier jour de la semaine)</td></tr>
<tr><td><code>%W</code></td><td> semaine de l'année sur 2 chiffres
(Lundi est le premier jour de la semaine)</td></tr>
<tr class="odd"><td><code>%w</code></td><td>jour de la semaine sur 1 chiffre
(Dimanche est le premier jour de la semaine)</td></tr>
<tr><td><code>%X</code></td><td>heure (localisée)</td></tr>
<tr class="odd"><td><code>%x</code></td><td>date (localisée)</td></tr>
<tr><td><code>%Y</code></td><td>année sur 4 chiffres</td></tr>
<tr class="odd"><td><code>%y</code></td><td>année sur 2 chiffres</td></tr>
<tr><td><code>%Z</code></td><td>nom de la zone de temps</td></tr>
<tr class="odd"><td><code>%%</code></td><td>caractère littéral `%'</td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/rotatelogs.html" title="Français"> fr </a> |
<a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/rotatelogs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/other.html.fr.utf8 0000664 0001751 0001751 00000012404 14740503670 022172 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Autres programmes - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>Autres programmes</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/other.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/other.html" title="Français"> fr </a> |
<a href="../ko/programs/other.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/other.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Cette page contenait la documentation de programmes qui possèdent
maintenant leurs propres pages de documentation. Merci de bien
vouloir mettre à jour vos liens.</p>
<p><code class="program"><a href="../programs/log_server_status.html">log_server_status</a></code></p>
<p><code class="program"><a href="../programs/split-logfile.html">split-logfile</a></code></p>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/other.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/other.html" title="Français"> fr </a> |
<a href="../ko/programs/other.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/other.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/other.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/ab.html.en 0000664 0001751 0001751 00000045424 14737241666 020563 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ab - Apache HTTP server benchmarking tool - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>ab - Apache HTTP server benchmarking tool</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/ab.html" title="English"> en </a> |
<a href="../fr/programs/ab.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/ab.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/ab.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>ab</code> is a tool for benchmarking your Apache Hypertext
Transfer Protocol (HTTP) server. It is designed to give you an impression
of how your current Apache installation performs. This especially shows
you how many requests per second your Apache installation is capable of
serving.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#output">Output</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Bugs</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>ab</strong>
[ -<strong>A</strong> <var>auth-username</var>:<var>password</var> ]
[ -<strong>b</strong> <var>windowsize</var> ]
[ -<strong>B</strong> <var>local-address</var> ]
[ -<strong>c</strong> <var>concurrency</var> ]
[ -<strong>C</strong> <var>cookie-name</var>=<var>value</var> ]
[ -<strong>d</strong> ]
[ -<strong>e</strong> <var>csv-file</var> ]
[ -<strong>E</strong> <var>client-certificate file</var> ]
[ -<strong>f</strong> <var>protocol</var> ]
[ -<strong>g</strong> <var>gnuplot-file</var> ]
[ -<strong>h</strong> ]
[ -<strong>H</strong> <var>custom-header</var> ]
[ -<strong>i</strong> ]
[ -<strong>k</strong> ]
[ -<strong>l</strong> ]
[ -<strong>m</strong> <var>HTTP-method</var> ]
[ -<strong>n</strong> <var>requests</var> ]
[ -<strong>p</strong> <var>POST-file</var> ]
[ -<strong>P</strong> <var>proxy-auth-username</var>:<var>password</var> ]
[ -<strong>q</strong> ]
[ -<strong>r</strong> ]
[ -<strong>s</strong> <var>timeout</var> ]
[ -<strong>S</strong> ]
[ -<strong>t</strong> <var>timelimit</var> ]
[ -<strong>T</strong> <var>content-type</var> ]
[ -<strong>u</strong> <var>PUT-file</var> ]
[ -<strong>v</strong> <var>verbosity</var>]
[ -<strong>V</strong> ]
[ -<strong>w</strong> ]
[ -<strong>x</strong> <var><table>-attributes</var> ]
[ -<strong>X</strong> <var>proxy</var>[:<var>port</var>] ]
[ -<strong>y</strong> <var><tr>-attributes</var> ]
[ -<strong>z</strong> <var><td>-attributes</var> ]
[ -<strong>Z</strong> <var>ciphersuite</var> ]
[http[s]://]<var>hostname</var>[:<var>port</var>]/<var>path</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-A <var>auth-username</var>:<var>password</var></code></dt>
<dd>Supply BASIC Authentication credentials to the server. The username and
password are separated by a single <code>:</code> and sent on the wire
base64 encoded. The string is sent regardless of whether the server needs
it (<em>i.e.</em>, has sent an 401 authentication needed).</dd>
<dt><code>-b <var>windowsize</var></code></dt>
<dd>Size of TCP send/receive buffer, in bytes.</dd>
<dt><code>-B <var>local-address</var></code></dt>
<dd>Address to bind to when making outgoing connections.</dd>
<dt><code>-c <var>concurrency</var></code></dt>
<dd>Number of multiple requests to perform at a time. Default is one
request at a time.</dd>
<dt><code>-C <var>cookie-name</var>=<var>value</var></code></dt>
<dd>Add a <code>Cookie:</code> line to the request. The argument is
typically in the form of a <code><var>name</var>=<var>value</var></code>
pair. This field is repeatable.</dd>
<dt><code>-d</code></dt>
<dd>Do not display the "percentage served within XX [ms] table". (legacy
support).</dd>
<dt><code>-e <var>csv-file</var></code></dt>
<dd>Write a Comma separated value (CSV) file which contains for each
percentage (from 1% to 100%) the time (in milliseconds) it took to serve
that percentage of the requests. This is usually more useful than the
'gnuplot' file; as the results are already 'binned'.</dd>
<dt><code>-E <var>client-certificate-file</var></code></dt>
<dd>When connecting to an SSL website, use the provided client certificate
in PEM format to authenticate with the server. The file is expected to
contain the client certificate, followed by intermediate certificates,
followed by the private key. Available in 2.4.36 and later.</dd>
<dt><code>-f <var>protocol</var></code></dt>
<dd>Specify SSL/TLS protocol (SSL2, SSL3, TLS1, TLS1.1, TLS1.2, or ALL).
TLS1.1 and TLS1.2 support available in 2.4.4 and later.</dd>
<dt><code>-g <var>gnuplot-file</var></code></dt>
<dd>Write all measured values out as a 'gnuplot' or TSV (Tab separate
values) file. This file can easily be imported into packages like Gnuplot,
IDL, Mathematica, Igor or even Excel. The labels are on the first line of
the file. </dd>
<dt><code>-h</code></dt>
<dd>Display usage information.</dd>
<dt><code>-H <var>custom-header</var></code></dt>
<dd>Append extra headers to the request. The argument is typically in
the form of a valid header line, containing a colon-separated field-value
pair (<em>i.e.</em>, <code>"Accept-Encoding: zip/zop;8bit"</code>).</dd>
<dt><code>-i</code></dt>
<dd>Do <code>HEAD</code> requests instead of <code>GET</code>.</dd>
<dt><code>-k</code></dt>
<dd>Enable the HTTP KeepAlive feature, <em>i.e.</em>, perform multiple
requests within one HTTP session. Default is no KeepAlive.</dd>
<dt><code>-l</code></dt>
<dd>Do not report errors if the length of the responses is not constant. This
can be useful for dynamic pages.
Available in 2.4.7 and later.
</dd>
<dt><code>-m <var>HTTP-method</var></code></dt>
<dd>Custom HTTP method for the requests.
Available in 2.4.10 and later.</dd>
<dt><code>-n <var>requests</var></code></dt>
<dd>Number of requests to perform for the benchmarking session. The default
is to just perform a single request which usually leads to
non-representative benchmarking results.</dd>
<dt><code>-p <var>POST-file</var></code></dt>
<dd>File containing data to POST. Remember to also set <code>-T</code>.</dd>
<dt><code>-P <var>proxy-auth-username</var>:<var>password</var></code></dt>
<dd>Supply BASIC Authentication credentials to a proxy en-route. The
username and password are separated by a single <code>:</code> and sent on
the wire base64 encoded. The string is sent regardless of whether the
proxy needs it (<em>i.e.</em>, has sent an 407 proxy authentication
needed).</dd>
<dt><code>-q</code></dt>
<dd>When processing more than 150 requests, <code>ab</code> outputs a
progress count on <code>stderr</code> every 10% or 100 requests or so. The
<code>-q</code> flag will suppress these messages.</dd>
<dt><code>-r</code></dt>
<dd>Don't exit on socket receive errors.</dd>
<dt><code>-s <var>timeout</var></code></dt>
<dd>Maximum number of seconds to wait before the socket times out.
Default is 30 seconds.
Available in 2.4.4 and later.</dd>
<dt><code>-S</code></dt>
<dd>Do not display the median and standard deviation values, nor display
the warning/error messages when the average and median are more than
one or two times the standard deviation apart. And default to the
min/avg/max values. (legacy support).</dd>
<dt><code>-t <var>timelimit</var></code></dt>
<dd>Maximum number of seconds to spend for benchmarking. This implies a
<code>-n 50000</code> internally. Use this to benchmark the server within a
fixed total amount of time. Per default there is no timelimit.</dd>
<dt><code>-T <var>content-type</var></code></dt>
<dd>Content-type header to use for POST/PUT data, eg.
<code>application/x-www-form-urlencoded</code>.
Default is <code>text/plain</code>.</dd>
<dt><code>-u <var>PUT-file</var></code></dt>
<dd>File containing data to PUT. Remember to also set <code>-T</code>.</dd>
<dt><code>-v <var>verbosity</var></code></dt>
<dd>Set verbosity level - <code>4</code> and above prints information on
headers, <code>3</code> and above prints response codes (404, 200, etc.),
<code>2</code> and above prints warnings and info.</dd>
<dt><code>-V</code></dt>
<dd>Display version number and exit.</dd>
<dt><code>-w</code></dt>
<dd>Print out results in HTML tables. Default table is two columns wide,
with a white background.</dd>
<dt><code>-x <var><table>-attributes</var></code></dt>
<dd>String to use as attributes for <code><table></code>. Attributes
are inserted <code><table <var>here</var> ></code>.</dd>
<dt><code>-X <var>proxy</var>[:<var>port</var>]</code></dt>
<dd>Use a proxy server for the requests.</dd>
<dt><code>-y <var><tr>-attributes</var></code></dt>
<dd>String to use as attributes for <code><tr></code>.</dd>
<dt><code>-z <var><td>-attributes</var></code></dt>
<dd>String to use as attributes for <code><td></code>.</dd>
<dt><code>-Z <var>ciphersuite</var></code></dt>
<dd>Specify SSL/TLS cipher suite (See openssl ciphers)</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="output" id="output">Output</a></h2>
<p>The following list describes the values returned by <code>ab</code>:
</p>
<dl>
<dt>Server Software</dt>
<dd>The value, if any, returned in the <var>server</var> HTTP header
of the first successful response. This includes all characters in the
header from beginning to the point a character with decimal value of 32
(most notably: a space or CR/LF) is detected.</dd>
<dt>Server Hostname</dt>
<dd>The DNS or IP address given on the command line</dd>
<dt>Server Port</dt>
<dd>The port to which ab is connecting. If no port is given on the
command line, this will default to 80 for http and 443 for
https.</dd>
<dt>SSL/TLS Protocol</dt>
<dd>The protocol parameters negotiated between the client and server.
This will only be printed if SSL is used.</dd>
<dt>Document Path</dt>
<dd>The request URI parsed from the command line string.</dd>
<dt>Document Length</dt>
<dd>This is the size in bytes of the first successfully returned document.
If the document length changes during testing, the response is
considered an error.</dd>
<dt>Concurrency Level</dt>
<dd>The number of concurrent clients used during the test</dd>
<dt>Time taken for tests</dt>
<dd>This is the time taken from the moment the first socket connection
is created to the moment the last response is received</dd>
<dt>Complete requests</dt>
<dd>The number of successful responses received</dd>
<dt>Failed requests</dt>
<dd>The number of requests that were considered a failure. If the
number is greater than zero, another line will be printed showing the
number of requests that failed due to connecting, reading, incorrect
content length, or exceptions.</dd>
<dt>Write errors</dt>
<dd>The number of errors that failed during write (broken pipe).</dd>
<dt>Non-2xx responses</dt>
<dd>The number of responses that were not in the 200 series of response
codes. If all responses were 200, this field is not printed.</dd>
<dt>Keep-Alive requests</dt>
<dd>The number of connections that resulted in Keep-Alive requests</dd>
<dt>Total body sent</dt>
<dd>If configured to send data as part of the test, this is the total
number of bytes sent during the tests. This field is omitted if the test
did not include a body to send.</dd>
<dt>Total transferred</dt>
<dd>The total number of bytes received from the server. This number
is essentially the number of bytes sent over the wire.</dd>
<dt>HTML transferred</dt>
<dd>The total number of document bytes received from the server. This
number excludes bytes received in HTTP headers</dd>
<dt>Requests per second</dt>
<dd>This is the number of requests per second. This value is the result
of dividing the number of requests by the total time taken</dd>
<dt>Time per request</dt>
<dd>The average time spent per request. The first value is calculated
with the formula <code>concurrency * timetaken * 1000 / done</code>
while the second value is calculated with the formula
<code>timetaken * 1000 / done</code></dd>
<dt>Transfer rate</dt>
<dd>The rate of transfer as calculated by the formula
<code>totalread / 1024 / timetaken</code></dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="bugs" id="bugs">Bugs</a></h2>
<p>There are various statically declared buffers of fixed length. Combined
with the lazy parsing of the command line arguments, the response headers
from the server and other external inputs, this might bite you.</p>
<p>It does not implement HTTP/1.x fully; only accepts some 'expected' forms
of responses. The rather heavy use of <code>strstr(3)</code> shows up top
in profile, which might indicate a performance problem; <em>i.e.</em>, you
would measure the <code>ab</code> performance rather than the server's.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/ab.html" title="English"> en </a> |
<a href="../fr/programs/ab.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/ab.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/ab.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/ab.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/dbmmanage.html.en 0000664 0001751 0001751 00000032455 14737241666 022114 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>dbmmanage - Manage user authentication files in DBM format - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>dbmmanage - Manage user authentication files in DBM format</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/dbmmanage.html" title="English"> en </a> |
<a href="../fr/programs/dbmmanage.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/dbmmanage.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/dbmmanage.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>dbmmanage</code> is used to create and update the DBM format files
used to store usernames and password for basic authentication of HTTP users
via <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>.
Resources available from the Apache HTTP server can be restricted to just
the users listed in the files created by <code>dbmmanage</code>. This
program can only be used when the usernames are stored in a DBM file. To
use a flat-file database see <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>.</p>
<p>Another tool to maintain a DBM password database is
<code class="program"><a href="../programs/htdbm.html">htdbm</a></code>.</p>
<p>This manual page only lists the command line arguments. For details of
the directives necessary to configure user authentication in
<code class="program"><a href="../programs/httpd.html">httpd</a></code> see the httpd manual, which is part of
the Apache distribution or can be found at <a href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Bugs</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></li><li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li><li><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>dbmmanage</strong> [ <var>encoding</var> ]
<var>filename</var> add|adduser|check|delete|update
<var>username</var>
[ <var>encpasswd</var>
[ <var>group</var>[,<var>group</var>...]
[ <var>comment</var> ] ] ]</code></p>
<p><code><strong>dbmmanage</strong> <var>filename</var>
view [ <var>username</var> ]</code></p>
<p><code><strong>dbmmanage</strong> <var>filename</var> import</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code><var>filename</var></code></dt>
<dd>The filename of the DBM format file. Usually without the extension
<code>.db</code>, <code>.pag</code>, or <code>.dir</code>.</dd>
<dt><code><var>username</var></code></dt>
<dd>The user for which the operations are performed. The <var>username</var>
may not contain a colon (<code>:</code>).</dd>
<dt><code><var>encpasswd</var></code></dt>
<dd>This is the already hashed password to use for the
<code>update</code> and <code>add</code> commands. You may use a hyphen
(<code>-</code>) if you want to get prompted for the password, but fill
in the fields afterwards. Additionally when using the <code>update</code>
command, a period (<code>.</code>) keeps the original password
untouched.</dd>
<dt><code><var>group</var></code></dt>
<dd>A group, which the user is member of. A groupname may not contain a
colon (<code>:</code>). You may use a hyphen (<code>-</code>) if you don't
want to assign the user to a group, but fill in the comment field.
Additionally when using the <code>update</code> command, a period
(<code>.</code>) keeps the original groups untouched.</dd>
<dt><code><var>comment</var></code></dt>
<dd>This is the place for your opaque comments about the user, like
realname, mailaddress or such things. The server will ignore this
field.</dd>
</dl>
<h3><a name="options.encodings" id="options.encodings">Encodings</a></h3>
<dl>
<dt><code>-d</code></dt>
<dd>crypt hashing (default, except on Win32, Netware)</dd>
<dt><code>-m</code></dt>
<dd>MD5 hashing (default on Win32, Netware)</dd>
<dt><code>-s</code></dt>
<dd>SHA1 hashing</dd>
<dt><code>-p</code></dt>
<dd>plaintext (<em>not recommended</em>)</dd>
</dl>
<h3><a name="options.commands" id="options.commands">Commands</a></h3>
<dl>
<dt><code>add</code></dt>
<dd>Adds an entry for <var>username</var> to <var>filename</var> using the
hashed password <var>encpasswd</var>.
<div class="example"><p><code>dbmmanage passwords.dat add rbowen foKntnEF3KSXA</code></p></div>
</dd>
<dt><code>adduser</code></dt>
<dd>Asks for a password and then adds an entry for <var>username</var> to
<var>filename</var>.
<div class="example"><p><code>dbmmanage passwords.dat adduser krietz</code></p></div>
</dd>
<dt><code>check</code></dt>
<dd>Asks for a password and then checks if <var>username</var> is in
<var>filename</var> and if it's password matches the specified one.
<div class="example"><p><code>dbmmanage passwords.dat check rbowen</code></p></div>
</dd>
<dt><code>delete</code></dt>
<dd>Deletes the <var>username</var> entry from <var>filename</var>.
<div class="example"><p><code>dbmmanage passwords.dat delete rbowen</code></p></div>
</dd>
<dt><code>import</code></dt>
<dd>Reads <code><var>username</var>:<var>password</var></code> entries
(one per line) from <code>STDIN</code> and adds them to
<var>filename</var>. The passwords already have to be crypted.</dd>
<dt><code>update</code></dt>
<dd>Same as the <code>adduser</code> command, except that it makes
sure <var>username</var> already exists in <var>filename</var>.
<div class="example"><p><code>dbmmanage passwords.dat update rbowen</code></p></div>
</dd>
<dt><code>view</code></dt>
<dd>Just displays the contents of the DBM file. If you specify a
<var>username</var>, it displays the particular record only.
<div class="example"><p><code>dbmmanage passwords.dat view</code></p></div>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="bugs" id="bugs">Bugs</a></h2>
<p>One should be aware that there are a number of different DBM file formats
in existence, and with all likelihood, libraries for more than one format
may exist on your system. The three primary examples are SDBM, NDBM, the GNU
project's GDBM, and Berkeley DB 2. Unfortunately, all these libraries use
different file formats, and you must make sure that the file format used
by <var>filename</var> is the same format that <code>dbmmanage</code>
expects to see. <code>dbmmanage</code> currently has no way of determining
what type of DBM file it is looking at. If used against the wrong format,
will simply return nothing, or may create a different DBM file with a
different name, or at worst, it may corrupt the DBM file if you were
attempting to write to it.</p>
<p><code>dbmmanage</code> has a list of DBM format preferences, defined by
the <code>@AnyDBM::ISA</code> array near the beginning of the program. Since
we prefer the Berkeley DB 2 file format, the order in which
<code>dbmmanage</code> will look for system libraries is Berkeley DB 2,
then NDBM, then GDBM and then SDBM. The first library found will be the
library <code>dbmmanage</code> will attempt to use for all DBM file
transactions. This ordering is slightly different than the standard
<code>@AnyDBM::ISA</code> ordering in Perl, as well as the ordering used by
the simple <code>dbmopen()</code> call in Perl, so if you use any other
utilities to manage your DBM files, they must also follow this preference
ordering. Similar care must be taken if using programs in other languages,
like C, to access these files.</p>
<p>One can usually use the <code>file</code> program supplied with most
Unix systems to see what format a DBM file is in.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/dbmmanage.html" title="English"> en </a> |
<a href="../fr/programs/dbmmanage.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/dbmmanage.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/dbmmanage.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/dbmmanage.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/suexec.html.ko.euc-kr 0000664 0001751 0001751 00000015241 14743132254 022650 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>suexec - ܺ α ϱ ڸ Ѵ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/"></a> | <a href="../mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>suexec - ܺ α ϱ ڸ Ѵ</h1>
<div class="toplang">
<p><span> : </span><a href="../en/programs/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/suexec.html" title="Korean"> ko </a> |
<a href="../tr/programs/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>ġ CGI α ϱ ٸ ڷ
ȯϱ <code>suexec</code> Ѵ. ̸ Ϸ
<code>root</code> ؾ Ѵ.
<code>root</code> ʱ
<code>suexec</code> Ͽ setuid Ʈ ϰ
<code>root</code> ̾ Ѵ. <code>root</code>̿
ٸ ڰ ȵȴ.</p>
<p>suexec ȸ suexec
(<a href="http://httpd.apache.org/docs/2.4/suexec.html">http://httpd.apache.org/docs/2.4/suexec.html</a>) ϶.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis"></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">ɼ</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="synopsis" id="synopsis"></a></h2>
<p><code><strong>suexec</strong> -<strong>V</strong></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">ɼ</a></h2>
<dl>
<dt><code>-V</code></dt>
<dd><code>root</code> ϸ <code>suexec</code>
ɼ Ѵ. Ȼ ɼ
ִ.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="../en/programs/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/suexec.html" title="Korean"> ko </a> |
<a href="../tr/programs/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/suexec.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html"></a> | <a href="../sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/apxs.html.fr.utf8 0000664 0001751 0001751 00000052514 14740503670 022032 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>apxs - Utilitaire pour les extensions d'Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>apxs - Utilitaire pour les extensions d'Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/apxs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apxs.html" title="Français"> fr </a> |
<a href="../ko/programs/apxs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apxs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>apxs</code> est un utilitaire permettant de compiler et
d'installer des modules en tant qu'extensions du serveur HTTP
Apache. A cet effet, un objet dynamique partagé (DSO) est compilé à
partir d'un ou plusieurs <var>fichiers</var> sources ou objets et
peut être chargé pendant l'exécution du serveur Apache via la
directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> du
module <code class="module"><a href="../mod/mod_so.html">mod_so</a></code>.</p>
<p>Pour pouvoir utiliser ce mécanisme d'extensions, votre
plate-forme doit supporter la fonctionnalité DSO, et votre binaire
<code class="program"><a href="../programs/httpd.html">httpd</a></code> Apache doit être compilé avec le module
<code class="module"><a href="../mod/mod_so.html">mod_so</a></code>. Si ce n'est pas le cas, l'utilitaire
<code>apxs</code> vous le signalera. Vous pouvez aussi vérifier
vous-même ces prérequis en exécutant manuellement la commande :</p>
<div class="example"><p><code>
$ httpd -l
</code></p></div>
<p>Le module <code class="module"><a href="../mod/mod_so.html">mod_so</a></code> doit faire partie de la liste
des modules affichée. Si ces prérequis sont présents, vous pouvez
facilement étendre les fonctionnalités de votre serveur Apache en
installant vos propres modules à l'aide de l'utilitaire
<code>apxs</code>, via le mécanisme DSO :</p>
<div class="example"><p><code>
$ apxs -i -a -c mod_foo.c<br />
gcc -fpic -DSHARED_MODULE -I/chemin/vers/apache/include -c mod_foo.c<br />
ld -Bshareable -o mod_foo.so mod_foo.o<br />
cp mod_foo.so /chemin/vers/apache/modules/mod_foo.so<br />
chmod 755 /chemin/vers/apache/modules/mod_foo.so<br />
[activation du module `foo' dans /chemin/vers/apache/etc/httpd.conf]<br />
$ apachectl restart<br />
/chemin/vers/apache/sbin/apachectl restart: httpd not running, trying to start<br />
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
/chemin/vers/apache/sbin/apachectl restart: httpd started<br />
$ _
</code></p></div>
<p>Les arguments <var>fichiers</var> peuvent correspondre à un
fichier source C (.c), un fichier objet (.o) ou même une archive de
bibliothèques (.a). L'utilitaire <code>apxs</code> reconnaît
automatiquement ces extensions et utilise automatiquement les
fichiers source C pour la compilation, et les fichiers objets et
archives pour l'édition de liens. Cependant, si vous utilisez des
fichiers objets précompilés, assurez-vous que leur code soit
indépendant de la position (PIC), afin de pouvoir les utiliser avec
un objet partagé chargé dynamiquement. Avec GCC, par exemple, il
vous suffit de toujours utiliser l'option de compilation
<code>-fpic</code>. Pour les autres compilateurs C, consultez leur
page de manuel, ou vérifiez les drapeaux qu'<code>apxs</code>
utilise pour compiler les fichiers objets.</p>
<p>Pour plus de détails à propos du support DSO dans Apache, lire la
documentation du module <code class="module"><a href="../mod/mod_so.html">mod_so</a></code>, ou même, consultez
le fichier source <code>src/modules/standard/mod_so.c</code>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>apxs</strong> -<strong>g</strong>
[ -<strong>S</strong> <var>nom</var>=<var>valeur</var> ]
-<strong>n</strong> <var>nom-module</var></code></p>
<p><code><strong>apxs</strong> -<strong>q</strong>
[ -<strong>v</strong> ]
[ -<strong>S</strong> <var>nom</var>=<var>valeur</var> ]
<var>requête</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>c</strong>
[ -<strong>S</strong> <var>nom</var>=<var>valeur</var> ]
[ -<strong>o</strong> <var>fichier-dso</var> ]
[ -<strong>I</strong> <var>répertoire-inc</var> ]
[ -<strong>D</strong> <var>nom</var>=<var>valeur</var> ]
[ -<strong>L</strong> <var>répertoire-lib</var> ]
[ -<strong>l</strong> <var>nom-bibliothèque</var> ]
[ -<strong>Wc,</strong><var>options-compilation</var> ]
[ -<strong>Wl,</strong><var>options-edition-liens</var> ]
<var>fichiers</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>i</strong>
[ -<strong>S</strong> <var>nom</var>=<var>valeur</var> ]
[ -<strong>n</strong> <var>nom-module</var> ]
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]
<var>fichier-dso</var> ...</code></p>
<p><code><strong>apxs</strong> -<strong>e</strong>
[ -<strong>S</strong> <var>nom</var>=<var>valeur</var> ]
[ -<strong>n</strong> <var>nom-module</var> ]
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]
<var>fichier-dso</var> ...</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<h3><a name="options.common" id="options.common">Options courantes</a></h3>
<dl>
<dt><code>-n <var>nom-module</var></code></dt>
<dd>Définit explicitement le nom du module pour les options
<code>-i</code> (install) et <code>-g</code> (génération de
modèles). Utilisez cette option pour spécifier de manière
explicite le nom du module. Pour l'option <code>-g</code>, cette
option est nécessaire ; pour l'option <code>-i</code>,
l'utilitaire <code>apxs</code> tente de déterminer le nom du
module à partir des sources, ou (à défaut) en le déduisant du nom
de fichier.</dd>
</dl>
<h3><a name="options.query" id="options.query">Options de requête</a></h3>
<dl>
<dt><code>-q</code></dt>
<dd>Effectue une requête à propos des variables et de
l'environnement utilisés pour compiler <code>httpd</code>.
Lorsqu'elle est invoquée sans paramètre <var>requête</var>, cette
option affiche toutes les variables connues, ainsi que leurs
valeurs. Le paramètre optionnel <code>-v</code> formate la liste
affichée.
<p>Utilisez cette option pour déterminer manuellement les options
utilisées pour compiler le binaire <code>httpd</code> qui chargera
votre module. Ajoutez par exemple</p>
<div class="example"><p><code>
INC=-I`apxs -q INCLUDEDIR`
</code></p></div>
<p>dans vos propres Makefiles si vous devez accéder manuellement
aux fichiers d'en-têtes C d'Apache.</p></dd>
</dl>
<h3><a name="options.conf" id="options.conf">Options de configuration</a></h3>
<dl>
<dt><code>-S <var>nom</var>=<var>valeur</var></code></dt>
<dd>Cette option permet de modifier la configuration d'apxs
décrite ci-dessus.</dd>
</dl>
<h3><a name="options.template" id="options.template">Option de génération des
modèles</a></h3>
<dl>
<dt><code>-g</code></dt>
<dd>Cette option permet de générer un sous-répertoire
<var>nom</var> (voir option <code>-n</code>) contenant deux
fichiers : le premier fichier est un exemple de fichier source de
module nommé <code>mod_<var>nom</var>.c</code> que l'on peut
utiliser comme modèle pour créer ses propres modules, ou comme
point de départ pour se familiariser avec le mécanisme apxs ; le
second fichier est le <code>Makefile</code> correspondant
facilitant la compilation et l'installation de ce module.</dd>
</dl>
<h3><a name="options.dso" id="options.dso">Options de compilation DSO</a></h3>
<dl>
<dt><code>-c</code></dt>
<dd>Cette option indique une opération de compilation. Tout
d'abord, les fichiers sources (.c) spécifiés par
<var>fichiers</var> sont compilés en fichiers objets
correspondants (.o), puis un objet dynamiquement partagé
<var>fichier-dso</var> est compilé via une édition de liens de ces
fichiers objets avec les autres fichiers objets (.o and .a)
spécifiés par <var>fichiers</var>. Si l'option <code>-o</code>
n'est pas spécifiée, le nom du fichier résultant est déduit du
premier nom de fichier spécifié par <var>fichiers</var>, et ainsi
prend en général pour valeur par défaut
<code>mod_<var>nom</var>.so</code>.</dd>
<dt><code>-o <var>fichier-dso</var></code></dt>
<dd>Spécifie de manière explicite le nom de fichier de l'objet
partagé dynamiquement créé. Sans cette option, et si le nom ne
peut pas être déduit de la liste <var>fichiers</var>, c'est le nom
par défaut <code>mod_unknown.so</code> qui sera utilisé.</dd>
<dt><code>-D <var>nom</var>=<var>valeur</var></code></dt>
<dd>Cette option est transmise directement à la commande de
compilation. Vous pouvez l'utiliser pour ajouter vos propres
définitions au processus de compilation. </dd>
<dt><code>-I <var>répertoire-inc</var></code></dt>
<dd>Cette option est transmise directement à la commande de
compilation. Vous pouvez l'utiliser pour ajouter vos propres
chemins de recherche des répertoires <code>include</code> au processus de
compilation.</dd>
<dt><code>-L <var>répertoire-lib</var></code></dt>
<dd>Cette option est transmise directement à la commande d'édition
de liens. Vous pouvez l'utiliser pour ajouter vos propres
chemins de recherche des répertoires de bibliothèques au processus
de compilation.</dd>
<dt><code>-l <var>nom-bibliothèque</var></code></dt>
<dd>Cette option est transmise directement à la commande d'édition
de liens. Vous pouvez l'utiliser pour ajouter vos propres
bibliothèques à rechercher au processus de compilation.</dd>
<dt><code>-Wc,<var>options-compilation</var></code></dt>
<dd>Cette option transmet les <var>options-compilation</var> en
tant qu'options supplémentaires à la commande <code>libtool
--mode=compile</code>. Vous pouvez l'utiliser pour ajouter des
options locales spécifiques au compilateur.</dd>
<dt><code>-Wl,<var>options-edition-liens</var></code></dt>
<dd>Cette option transmet les <var>options-edition-liens</var> en
tant qu'options supplémentaires à la commande <code>libtool
--mode=link</code>. Vous pouvez l'utiliser pour ajouter des
options locales spécifiques à l'éditeur de liens.</dd>
<dt><code>-p</code></dt>
<dd>Avec cette option, apxs effectue l'édition de liens avec les
bibliothèques apr/apr-util. Elle permet de compiler les programmes
helper qui utilisent les bibliothèques apr/apr-util.</dd>
</dl>
<h3><a name="options.dsoinstall" id="options.dsoinstall">Options d'installation et de configuration DSO</a></h3>
<dl>
<dt><code>-i</code></dt>
<dd>Cette option indique une opération d'installation et installe
un ou plusieurs objets dynamiquement partagés dans le répertoire
<var>modules</var> du serveur.</dd>
<dt><code>-a</code></dt>
<dd>Cette option active le module en ajoutant automatiquement une
directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>
correspondante au fichier de configuration d'Apache
<code>httpd.conf</code>, ou en l'activant s'il existe déjà.</dd>
<dt><code>-A</code></dt>
<dd>Identique à l'option <code>-a</code>, à la différence que la
directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> créée
est préfixée par un caractère dièse (<code>#</code>) ; le module
est ainsi préparé pour une activation ultérieure, mais est
désactivé dans un premier temps.</dd>
<dt><code>-e</code></dt>
<dd>Cette option indique une opération d'édition de liens et peut
être utilisée avec les options <code>-a</code> et <code>-A</code>
de la même manière qu'au cours de l'opération d'installation pour
éditer le fichier de configuration d'Apache
<code>httpd.conf</code>, sans toutefois installer le module.</dd>
</dl>
</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">Exemples</a></h2>
<p>Supposons que vous disposiez d'un module Apache nommé
<code>mod_foo.c</code> et destiné à étendre les fonctionnalités du
serveur. Pour ce faire, vous devez tout d'abord compiler le fichier
source C en un objet partagé pouvant être chargé dans le serveur
Apache à l'exécution, via la commande suivante :</p>
<div class="example"><p><code>
$ apxs -c mod_foo.c<br />
/chemin/vers/libtool --mode=compile gcc ... -c mod_foo.c<br />
/chemin/vers/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
$ _
</code></p></div>
<p>Vous devez ensuite vérifier la configuration d'Apache en vous
assurant qu'une directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> est bien présente pour
charger cet objet partagé. Pour simplifier cette étape,
<code>apxs</code> propose une méthode automatique d'installation de
l'objet partagé dans son répertoire "modules", et de mise à jour du
fichier <code>httpd.conf</code> en conséquence. Pour bénéficier de
cette automatisation, utilisez la commande suivante :</p>
<div class="example"><p><code>
$ apxs -i -a mod_foo.la<br />
/chemin/vers/instdso.sh mod_foo.la /chemin/vers/apache/modules<br />
/chemin/vers/libtool --mode=install cp mod_foo.la /chemin/vers/apache/modules
...
chmod 755 /chemin/vers/apache/modules/mod_foo.so<br />
[activation du module `foo' dans /chemin/vers/apache/conf/httpd.conf]<br />
$ _
</code></p></div>
<p>Une ligne contenant</p>
<div class="example"><p><code>
LoadModule foo_module modules/mod_foo.so
</code></p></div>
<p>est alors ajoutée au fichier de configuration si ce n'est pas
déjà fait. Si vous voulez que le module soit désactivé par défaut,
utilisez l'option <code>-A</code> comme suit :</p>
<div class="example"><p><code>
$ apxs -i -A mod_foo.c
</code></p></div>
<p>Pour un test rapide du mécanisme apxs, vous pouvez créer un
exemple de modèle de module Apache, ainsi que le Makefile
correspondant via :</p>
<div class="example"><p><code>
$ apxs -g -n foo<br />
Creating [DIR] foo<br />
Creating [FILE] foo/Makefile<br />
Creating [FILE] foo/modules.mk<br />
Creating [FILE] foo/mod_foo.c<br />
Creating [FILE] foo/.deps<br />
$ _
</code></p></div>
<p>Vous pouvez ensuite compiler immédiatement ce module exemple en
objet partagé et le charger dans le serveur Apache :</p>
<div class="example"><p><code>
$ cd foo<br />
$ make all reload<br />
apxs -c mod_foo.c<br />
/chemin/vers/libtool --mode=compile gcc ... -c mod_foo.c<br />
/chemin/vers/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo<br />
apxs -i -a -n "foo" mod_foo.la<br />
/chemin/vers/instdso.sh mod_foo.la /chemin/vers/apache/modules<br />
/chemin/vers/libtool --mode=install cp mod_foo.la /chemin/vers/apache/modules
...
chmod 755 /chemin/vers/apache/modules/mod_foo.so<br />
[activation du module `foo' dans /chemin/vers/apache/conf/httpd.conf]<br />
apachectl restart<br />
/chemin/vers/apache/sbin/apachectl restart: httpd not running, trying to start<br />
[Tue Mar 31 11:27:55 1998] [debug] mod_so.c(303): loaded module foo_module<br />
/chemin/vers/apache/sbin/apachectl restart: httpd started<br />
$ _
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/apxs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/apxs.html" title="Français"> fr </a> |
<a href="../ko/programs/apxs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/apxs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/apxs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htcacheclean.html.fr.utf8 0000664 0001751 0001751 00000036745 14740503670 023471 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htcacheclean - Nettoyage du cache sur disque - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>htcacheclean - Nettoyage du cache sur disque</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htcacheclean.html" title="Français"> fr </a> |
<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>htcacheclean</code> permet de maintenir la taille de
l'espace de stockage réservé à <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> en
dessous d'une limite de taille donnée ou d'inodes utilisés. Cet
utilitaire peut s'exécuter
soit manuellement, soit en mode démon. Lorsqu'il fonctionne en mode
démon, il se met en attente en arrière-plan et recherche à
intervalles réguliers dans le répertoire du cache les contenus à
supprimer. Pour arrêter proprement le démon, vous pouvez lui envoyer
un signal TERM ou INT. Lorsqu'il est lancé manuellement, une
recherche des contenus du cache qui peuvent être supprimés est
effectuée une seule fois. Si une ou plusieurs URLs sont spécifiées,
chacune d'entre elles sera supprimée du cache, si elle est présente.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#delete">Suppression d'une URL particulière</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#list">Affichage des URLs présentes dans le cache</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">Valeur renvoyée</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code></li><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>htcacheclean</strong>
[ -<strong>D</strong> ]
[ -<strong>v</strong> ]
[ -<strong>t</strong> ]
[ -<strong>r</strong> ]
[ -<strong>n</strong> ]
[ -<strong>R</strong><var>arrondi</var> ]
-<strong>p</strong><var>chemin</var>
[ -<strong>l</strong><var>limite</var> ]
[ -<strong>L</strong><var>limite</var> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>n</strong> ]
[ -<strong>t</strong> ]
[ -<strong>i</strong> ]
[ -<strong>P</strong><var>fichier-pid</var> ]
[ -<strong>R</strong><var>arrondi</var> ]
-<strong>d</strong><var>intervalle</var>
-<strong>p</strong><var>chemin</var>
[ -<strong>l</strong><var>limite</var> ]
[ -<strong>L</strong><var>limite</var> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>v</strong> ]
[ -<strong>R</strong><var>arrondi</var> ]
-<strong>p</strong><var>chemin</var>
[ -<strong>a</strong> ]
[ -<strong>A</strong> ]</code></p>
<p><code><strong>htcacheclean</strong>
[ -<strong>D</strong> ]
[ -<strong>v</strong> ]
[ -<strong>t</strong> ]
[ -<strong>R</strong><var>arrondi</var> ]
-<strong>p</strong><var>chemin</var>
<var>url</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-d<var>intervalle</var></code></dt>
<dd>Configure en mode démon et planifie le nettoyage du cache toutes
les <var>intervalle</var> minutes. Cette option et les options
<code>-D</code>, <code>-v</code> et <code>-r</code> s'excluent
mutuellement. Pour arrêter le démon proprement, il suffit de lui
envoyer un signal <code>SIGTERM</code> ou <code>SIGINT</code>.</dd>
<dt><code>-D</code></dt>
<dd>Le programme s'exécute mais ne supprime aucun contenu ("dry run"). Cette
option et l'option <code>-d</code> s'excluent mutuellement. Si ce mode
est combiné avec la suppression des répertoires avec
<code>-t</code>, les inodes signalés comme supprimés dans les
statistiques ne peuvent pas prendre en compte les répertoires
supprimés, et seront marqués en tant qu'estimation.</dd>
<dt><code>-v</code></dt>
<dd>Exécution verbeuse et affichage de statistiques. Cette
option et l'option <code>-d</code> s'excluent mutuellement.</dd>
<dt><code>-r</code></dt>
<dd>Nettoyage en profondeur. Le serveur web Apache doit être arrêté
(dans le cas contraire, il risque de rester des déchets dans le
cache). Cette option implique l'option <code>-t</code> et s'exclue
mutuellement avec l'option <code>-d</code>.</dd>
<dt><code>-n</code></dt>
<dd>Exécution en retrait. L'exécution du programme est ralentie en
faveur des autres processus. <code>htcacheclean</code> s'interrompt
de temps en temps de façon à ce que a) les entrées/sorties disque
soient retardées et b) que le noyau puisse mettre ce temps
processeur à disposition des autres processus.</dd>
<dt><code>-t</code></dt>
<dd>Supprime tous les répertoires vides. Par défaut, seuls les
fichiers sont supprimés du cache ; avec certaines configurations,
cependant, un grand nombre de répertoires sont créés et méritent que
l'on y prête attention. Si votre configuration nécessite un grand
nombre de répertoires, au point que le remplissage de la table
d'inodes ou d'allocation de fichiers puisse poser problème,
l'utilisation de cette option est conseillée.</dd>
<dt><code>-p<var>chemin</var></code></dt>
<dd>Définit <var>chemin</var> comme répertoire racine du cache sur
disque. Cette valeur doit correspondre à celle spécifiée par la
directive <code class="directive"><a href="../mod/mod_disk_cache.html#cacheroot">CacheRoot</a></code>.</dd>
<dt><code>-P<var>fichier-pid</var></code></dt>
<dd>Permet de spécifier <var>fichier-pid</var> comme nom du fichier
dans le lequel sera enregistré l'identifiant du processus en mode
démon.</dd>
<dt><code>-R<var>round</var></code></dt>
<dd>Permet de spécifier le plus petit commun multiple de la taille
du cache, afin de tenir compte de la taille des blocs. Définir ce
paramètre à la taille d'un bloc de la partition du cache.</dd>
<dt><code>-l<var>limite</var></code></dt>
<dd>Définit <var>limite</var> comme la taille maximale du cache sur
disque. La valeur s'exprime par défaut en octets (ou en ajoutant le
suffixe <code>B</code> à la valeur). Ajoutez le suffixe
<code>K</code> pour Ko, <code>M</code> pour Mo ou <code>G</code> pour
Go.</dd>
<dt><code>-L<var>limite</var></code></dt>
<dd>Spécifie <var>limite</var> comme la limite totale en inodes du cache
disque. Là aussi, on peut ajouter le suffixe <code>K</code> pour Ko,
<code>M</code> pour Mo ou <code>G</code> pour Go.</dd>
<dt><code>-i</code></dt>
<dd>Exécution intelligente. Le programme ne s'exécute que lorsque le
cache sur disque a été modifié. Cette option ne peut s'utiliser
qu'avec l'option <code>-d</code>.</dd>
<dt><code>-a</code></dt>
<dd>Affiche la liste des URLs actuellement stockées dans le cache.
Les variantes de la même URL seront listées une seule fois par
variante.</dd>
<dt><code>-A</code></dt>
<dd>Affiche la liste des URLs actuellement stockées dans le cache,
ainsi que leurs attributs dans l'ordre suivant : url, header size,
body size, status, entity version, date, expiry, request time,
response time, body present, head request.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="delete" id="delete">Suppression d'une URL particulière</a></h2>
<p>Si une ou plusieurs URLs sont passées en argument à
<code>htcacheclean</code>, chacune d'entre elles sera supprimée du
cache. S'il existe plusieurs variantes de ces URLs, elles seront
toutes supprimées.</p>
<p>Lorsqu'une URL mandatée en inverse doit être supprimée, l'URL
effective est construite à partir de l'en-tête
<strong>Host</strong>, du <strong>port</strong>, du
<strong>chemin</strong> et de la <strong>requête</strong>. Notez que
le '?' doit toujours être spécifié explicitement dans l'URL, qu'une
chaîne de paramètres soit présente ou non. Par exemple, pour
supprimer le chemin <strong>/</strong> du serveur
<strong>localhost</strong>, l'URL devra être spécifiée comme suit :
<strong>http://localhost:80/?</strong>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="list" id="list">Affichage des URLs présentes dans le cache</a></h2>
<p>Les options <code>-a</code> ou <code>-A</code> permettent
d'afficher les URLs présentes dans le cache telles qu'elles s'y
trouvent, une URL par ligne. L'option <code>-A</code> affiche
l'entrée du cache complète pour chaque URL, avec ses différents
champs dans l'ordre suivant :</p>
<dl>
<dt>url</dt><dd>L'URL de l'entrée considérée.</dd>
<dt>header size</dt><dd>La taille de l'en-tête en octets.</dd>
<dt>body size</dt><dd>La taille du corps en octets.</dd>
<dt>status</dt><dd>Etat de la réponse en cache.</dd>
<dt>entity version</dt><dd>Le nombre de fois que cette entrée a
été revalidée sans être effacée.</dd>
<dt>date</dt><dd>Date de la réponse.</dd>
<dt>expiry</dt><dd>Date d'expiration de la réponse.</dd>
<dt>request time</dt><dd>Date du début de la requête.</dd>
<dt>response time</dt><dd>Date de la fin de la requête.</dd>
<dt>body present</dt><dd>Ce champ contient la valeur 0 si aucun
corps n'est stocké avec cette requête, 1 dans le cas contraire.</dd>
<dt>head request</dt><dd>Ce champ contient la valeur 1 si
l'entrée comporte une requête HEAD en cache sans corps, 0 dans
le cas contraire.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">Valeur renvoyée</a></h2>
<p><code>htcacheclean</code> renvoie zéro ("true") si toutes les
opérations se sont déroulées normalement, et <code>1</code> dans le
cas contraire. Si une URL est spécifiée, et si cette URL était
présente dans le cache et a été supprimée avec succès,
<code>htcacheclean</code> renvoie <code>0</code>, et <code>2</code>
dans le cas contraire. Si une erreur est survenue au cours de la
suppression de l'URL, <code>htcacheclean</code> renvoie
<code>1</code>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htcacheclean.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htcacheclean.html" title="Français"> fr </a> |
<a href="../ko/programs/htcacheclean.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htcacheclean.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htcacheclean.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/httpd.html.fr.utf8 0000664 0001751 0001751 00000031377 14740503670 022206 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>httpd - Le serveur HTTP d'Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>httpd - Le serveur HTTP d'Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/httpd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/httpd.html" title="Français"> fr </a> |
<a href="../ko/programs/httpd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/httpd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>httpd</code> est le programme du serveur HTTP d'Apache. Il
a été conçu pour fonctionner sous forme de processus démon
indépendant. Lorsqu'il est utilisé ainsi, il va créer un jeu de
processus enfants ou de threads qui traiteront les requêtes.</p>
<p>En général, <code>httpd</code> n'est pas invoqué directement,
mais plutôt via <code class="program"><a href="../programs/apachectl.html">apachectl</a></code> sur les systèmes de
style Unix ou <a href="../platform/windows.html#winsvc">en tant que service sous
Windows NT, 2000 et XP</a> et <a href="../platform/windows.html#wincons">comme application de
console sous Windows 9x et ME</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../invoking.html">Démarrer Apache httpd</a></li><li><a href="../stopping.html">Arrêter Apache httpd</a></li><li><a href="../configuring.html">Fichiers de configuration</a></li><li><a href="../platform/">Documentations spécifiques aux
plates-formes</a></li><li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>httpd</strong> [ -<strong>d</strong>
<var>racine-serveur</var> ] [ -<strong>f</strong> <var>config</var> ]
[ -<strong>C</strong> <var>directive</var> ] [ -<strong>c</strong>
<var>directive</var> ] [ -<strong>D</strong> <var>paramètre</var> ]
[ -<strong>e</strong> <var>niveau</var> ] [ -<strong>E</strong>
<var>fichier</var> ]
[ <strong>-k</strong> start|restart|graceful|stop|graceful-stop ]
[ -<strong>h</strong> ]
[ -<strong>l</strong> ] [ -<strong>L</strong> ] [ -<strong>S</strong> ]
[ -<strong>t</strong> ] [ -<strong>v</strong> ] [ -<strong>V</strong> ]
[ -<strong>X</strong> ] [ -<strong>M</strong> ] [ -<strong>T</strong> ]
</code></p>
<p>Sur les <a href="../platform/windows.html">systèmes Windows</a>,
les options additionnelles suivantes sont disponibles :</p>
<p><code><strong>httpd</strong> [ -<strong>k</strong>
install|config|uninstall ] [ -<strong>n</strong> <var>nom</var> ]
[ -<strong>w</strong> ]</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-d <var>racine-serveur</var></code></dt>
<dd>Définit la valeur initiale de la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> à <var>racine-serveur</var>. Cette
valeur peut être écrasée par la directive ServerRoot du fichier de
configuration. La valeur par défaut est
<code>/usr/local/apache2</code>.</dd>
<dt><code>-f <var>config</var></code></dt>
<dd>Utilise les directives du fichier <var>config</var> au démarrage. Si
<var>config</var> ne commence pas par un '/', il est considéré comme
relatif au chemin défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. La valeur par défaut est
<code>conf/httpd.conf</code>.</dd>
<dt><code>-k <code>start|restart|graceful|stop|graceful-stop</code></code></dt>
<dd>Permet de démarrer, redémarrer ou arrêter <code>httpd</code>. Voir <a href="../stopping.html">Arrêter Apache httpd</a> pour plus d'informations.</dd>
<dt><code>-C <var>directive</var></code></dt>
<dd>Exécute la directive de configuration <var>directive</var> avant de
lire les fichiers de configurations.</dd>
<dt><code>-c <var>directive</var></code></dt>
<dd>Exécute la directive de configuration <var>directive</var> après
avoir lu les fichiers de configurations.</dd>
<dt><code>-D <var>paramètre</var></code></dt>
<dd>Définit un <var>paramètre</var> de configuration à utiliser dans les
sections <code class="directive"><a href="../mod/core.html#ifdefine"><IfDefine></a></code>
des fichiers de configuration, ces dernières permettant d'exécuter ou
non des
commandes au démarrage ou au redémarrage du serveur. Sert aussi à
définir certains paramètres de démarrage moins courants comme
<code>-DNO_DETACH</code> (empêche le processus parent de lancer des
processus enfants) et <code>-DFOREGROUND</code> (empêche le processus
parent d'appeler <code>setsid()</code> et autres).</dd>
<dt><code>-e <var>niveau</var></code></dt>
<dd>Définit la directive <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> à
<var>niveau</var> pendant le démarrage du serveur. Ceci permet
d'augmenter temporairement la verbosité des messages d'erreur afin de
déterminer les problèmes de démarrage.</dd>
<dt><code>-E <var>fichier</var></code></dt>
<dd>Envoie les messages d'erreur de démarrage vers le fichier
<var>fichier</var>.</dd>
<dt><code>-h</code></dt>
<dd>Affiche un bref résumé des options de ligne de commande
disponibles.</dd>
<dt><code>-l</code></dt>
<dd>Affiche la liste des modules compilés dans le le serveur. Ce
paramètre n'affiche <strong>pas</strong> les modules chargés
dynamiquement via la directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>.</dd>
<dt><code>-L</code></dt>
<dd>Affiche une liste des directives fournies par les modules statiques
avec les arguments associés, ainsi que les contextes dans lesquels elles
sont valides. Les directives fournies par les modules partagés
(dynamiques) ne sont pas affichées).</dd>
<dt><code>-M</code></dt>
<dd>Affiche une liste des modules statiques et des modules chargés
dynamiquement.</dd>
<dt><code>-S</code></dt>
<dd>Affiche la configuration telle qu'elle est issue de l'interprétation
du fichier de configuration (actuellement, seule la configuration des
serveurs virtuels est affichée).</dd>
<dt><code>-T</code> (disponible depuis la version 2.3.8)</dt>
<dd>Empêche la vérification de la racine des documents (DocumentRoot) au
démarrage/redémarrage.</dd>
<dt><code>-t</code></dt>
<dd>Exécute une vérification de syntaxe pour les fichiers de
configuration seulement. Le programme se termine immédiatement après ces
tests de vérification de syntaxe avec soit un code de retour de 0
(syntaxe OK), soit un code de retour différent de 0 (erreur de
syntaxe). Si -D <var>DUMP</var>_<var>VHOSTS </var> est défini, les
détails de la configuration des serveurs virtuels seront affichés. Si -D
<var>DUMP</var>_<var>MODULES </var> est défini, tous les modules chargés
seront affichés.</dd>
<dt><code>-v</code></dt>
<dd>Print the version of <code>httpd</code>, and then exit.</dd>
<dt><code>-V</code></dt>
<dd>Le programme affiche la version et les paramètres de compilation de
<code>httpd</code>, puis se termine.</dd>
<dt><code>-X</code></dt>
<dd>Exécute httpd en mode debug. Un seul processus sera démarré, et le
serveur ne rendra pas la main à la console.</dd>
</dl>
<p>Les arguments suivants ne sont disponibles que sur la <a href="../platform/windows.html">plate-forme Windows</a> :</p>
<dl>
<dt><code>-k install|config|uninstall</code></dt>
<dd>Respectivement : installe Apache httpd en tant que service Windows NT ;
modifie les options de démarrage du service Apache httpd ; désinstalle le
service Apache httpd.</dd>
<dt><code>-n <var>nom</var></code></dt>
<dd>Le <var>nom</var> du service Apache httpd à actionner.</dd>
<dt><code>-w</code></dt>
<dd>Garde la console Windows ouverte en cas de problème de façon à ce
que le message d'erreur puisse être lu.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/httpd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/httpd.html" title="Français"> fr </a> |
<a href="../ko/programs/httpd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/httpd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/httpd.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/logresolve.html.fr.utf8 0000664 0001751 0001751 00000016223 14740503670 023235 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>logresolve - Résoud les adresses IP en noms d'hôtes dans les
fichiers journaux d'Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>logresolve - Résoud les adresses IP en noms d'hôtes dans les
fichiers journaux d'Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/logresolve.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/logresolve.html" title="Français"> fr </a> |
<a href="../ko/programs/logresolve.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/logresolve.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>logresolve</code> est un programme agissant après
traitement pour résoudre les adresses IP dans les journaux d'accès
d'Apache. Pour minimiser la charge de votre serveur de noms,
logresolve possède son propre cache interne sous forme d'une table
de hashage. Cela implique que chaque numéro IP ne fera l'objet
d'une requête DNS que la première fois où il est rencontré dans le
fichier journal.</p>
<p>Le programme reçoit le fichier journal sur son entrée standard.
Les adresses IP doivent se trouver en tête de chaque ligne et
doivent être séparées du reste de la ligne par un espace.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>logresolve</strong> [ -<strong>s</strong>
<var>nom-fichier</var> ] [ -<strong>c</strong> ] <
<var>access_log</var> > <var>access_log.new</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-s <var>nom-fichier</var></code></dt>
<dd>Spécifie le nom du fichier où seront enregistrées des
statistiques.</dd>
<dt><code>-c</code></dt>
<dd>Avec cette option, <code>logresolve</code> effectue certaines
vérifications DNS : après avoir trouvé le nom d'hôte correspondant à une
adresse IP, <code>logresolve</code> effectue une recherche DNS sur ce
nom d'hôte et vérifie si une des adresses IP trouvées correspond à
l'adresse originale.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/logresolve.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/logresolve.html" title="Français"> fr </a> |
<a href="../ko/programs/logresolve.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/logresolve.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/logresolve.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/suexec.html.fr.utf8 0000664 0001751 0001751 00000015545 14740503670 022356 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>suexec - Change d'utilisateur avant l'exécution d'un programme
externe - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>suexec - Change d'utilisateur avant l'exécution d'un programme
externe</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/suexec.html" title="Français"> fr </a> |
<a href="../ko/programs/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>suexec</code> permet au serveur HTTP Apache de changer
d'utilisateur avant d'exécuter un programme CGI. Pour ce faire, il
doit être exécuté par <code>root</code>. A cet effet, comme le
démon HTTP ne s'exécute en général pas en tant que
<code>root</code>, l'exécutable <code>suexec</code> doit posséder
le bit setuid et avoir comme propriétaire <code>root</code>. Seul
<code>root</code> doit en posséder les droits en écriture.</p>
<p>Pour plus d'informations à propos des concepts et du modèle de
sécurité du programme suexec, veuillez vous reporter à sa
documentation : <a href="http://httpd.apache.org/docs/2.4/suexec.html">http://httpd.apache.org/docs/2.4/suexec.html</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>suexec</strong> -<strong>V</strong></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-V</code></dt>
<dd>Si vous êtes <code>root</code>, cette option permet d'afficher les
options de compilation du programme <code>suexec</code>. Pour des
raisons de sécurité, toutes les options de configuration ne sont
modifiables qu'à la compilation.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/suexec.html" title="Français"> fr </a> |
<a href="../ko/programs/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/suexec.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/configure.html.en 0000664 0001751 0001751 00000112034 14737241666 022152 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>configure - Configure the source tree - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>configure - Configure the source tree</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/configure.html" title="English"> en </a> |
<a href="../fr/programs/configure.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/configure.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>The <code>configure</code> script configures the source tree
for compiling and installing the Apache HTTP Server on your
particular platform. Various options allow the compilation of a
server corresponding to your personal requirements.</p>
<p>This script, included in the root directory of the source
distribution, is for compilation on Unix and Unix-like systems
only. For other platforms, see the <a href="../platform/">platform</a> documentation.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#env">Environment variables</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../install.html">Compiling and Installing</a></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p>You should call the <code>configure</code> script from within the
root directory of the distribution.</p>
<p><code><strong>./configure</strong> [<var>OPTION</var>]...
[<var>VAR</var>=<var>VALUE</var>]...</code></p>
<p>To assign environment variables (e.g. <code>CC</code>,
<code>CFLAGS</code> ...), specify them as
<code><var>VAR</var>=<var>VALUE</var></code>. See <a href="#env">below</a>
for descriptions of some of the useful variables.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<ul>
<li><a href="#configurationoptions">Configuration options</a></li>
<li><a href="#installationdirectories">Installation directories</a></li>
<li><a href="#systemtypes">System types</a></li>
<li><a href="#optionalfeatures">Optional features</a></li>
<li><a href="#supportopt">Options for support programs</a></li>
</ul>
<h3><a name="configurationoptions" id="configurationoptions">Configuration options</a></h3>
<p>The following options influence the behavior of
<code>configure</code> itself.</p>
<dl>
<dt><code>-C</code></dt>
<dt><code>--config-cache</code></dt>
<dd>This is an alias for <code>--cache-file=config.cache</code></dd>
<dt><code>--cache-file=<var>FILE</var></code></dt>
<dd>The test results will be cached in file <var>FILE</var>.
This option is disabled by default.</dd>
<dt><code>-h</code></dt>
<dt><code>--help [short|recursive]</code></dt>
<dd>Output the help and exit. With the argument <code>short</code> only
options specific to this package will displayed. The argument
<code>recursive</code> displays the short help of all the included
packages.</dd>
<dt><code>-n</code></dt>
<dt><code>--no-create</code></dt>
<dd>The <code>configure</code> script is run normally but does
not create output files. This is useful to check the test results
before generating makefiles for compilation.</dd>
<dt><code>-q</code></dt>
<dt><code>--quiet</code></dt>
<dd>Do not print <code>checking ...</code> messages during the
configure process.</dd>
<dt><code>--srcdir=<var>DIR</var></code></dt>
<dd>Defines directory <var>DIR</var> to be the source file directory.
Default is the directory where <code>configure</code> is located, or
the parent directory.</dd>
<dt><code>--silent</code></dt>
<dd>Same as <code>--quiet</code></dd>
<dt>-V</dt>
<dt>--version</dt>
<dd>Display copyright information and exit.</dd>
</dl>
<h3><a name="installationdirectories" id="installationdirectories">Installation
directories</a></h3>
<p>These options define the installation directory. The installation
tree depends on the selected layout.</p>
<dl>
<dt><code>--prefix=<var>PREFIX</var></code></dt>
<dd>Install architecture-independent files in <var>PREFIX</var>.
By default the installation directory is set to
<code>/usr/local/apache2</code>.</dd>
<dt><code>--exec-prefix=<var>EPREFIX</var></code></dt>
<dd>Install architecture-dependent files in <var>EPREFIX</var>.
By default the installation directory is set to the
<var>PREFIX</var> directory.</dd>
</dl>
<p>By default, <code>make install</code> will install all the files in
<code>/usr/local/apache2/bin</code>, <code>/usr/local/apache2/lib</code>
etc. You can specify an installation prefix other than
<code>/usr/local/apache2</code> using <code>--prefix</code>,
for instance <code>--prefix=$HOME</code>.</p>
<h4><a name="layout" id="layout">Define a directory layout</a></h4>
<dl>
<dt><code>--enable-layout=<var>LAYOUT</var></code></dt>
<dd>Configure the source code and build scripts to assume an
installation tree based on the layout <var>LAYOUT</var>. This allows
you to separately specify the locations for each type of file within
the Apache HTTP Server installation. The <code>config.layout</code>
file contains several example configurations, and you can also create
your own custom configuration following the examples. The different
layouts in this file are grouped into <code><Layout
FOO>...</Layout></code> sections and referred to by name as
in <code>FOO</code>. The default layout is <code>Apache</code>.</dd>
</dl>
<h4><a name="directoryfinetuning" id="directoryfinetuning">Fine tuning of the installation
directories</a></h4>
<p>For better control of the installation directories, use the options
below. Please note that the directory defaults are set by
<code>autoconf</code> and are overwritten by the corresponding layout
setting.</p>
<dl>
<dt><code>--bindir=<var>DIR</var></code></dt>
<dd>Install user executables in <var>DIR</var>. The user executables
are supporting programs like <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>,
<code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code>, etc. which are useful for site
administrators. By default <var>DIR</var> is set to
<code><var>EPREFIX</var>/bin</code>.</dd>
<dt><code>--datadir=<var>DIR</var></code></dt>
<dd>Install read-only architecture-independent data in <var>DIR</var>.
By default <code>datadir</code> is set to
<code><var>PREFIX</var>/share</code>. This option is offered by
<code>autoconf</code> and currently unused.</dd>
<dt><code>--includedir=<var>DIR</var></code></dt>
<dd>Install C header files in <var>DIR</var>. By default
<code>includedir</code> is set to
<code><var>EPREFIX</var>/include</code>.</dd>
<dt><code>--infodir=<var>DIR</var></code></dt>
<dd>Install info documentation in <var>DIR</var>.
By default <code>infodir</code> is set to
<code><var>PREFIX</var>/info</code>. This option is currently
unused.</dd>
<dt><code>--libdir=<var>DIR</var></code></dt>
<dd>Install object code libraries in <var>DIR</var>. By default
<code>libdir</code> is set to
<code><var>EPREFIX</var>/lib</code>.</dd>
<dt><code>--libexecdir=<var>DIR</var></code></dt>
<dd>Install the program executables (i.e., shared modules) in
<var>DIR</var>. By default <code>libexecdir</code> is set to
<code><var>EPREFIX</var>/modules</code>.</dd>
<dt><code>--localstatedir=<var>DIR</var></code></dt>
<dd>Install modifiable single-machine data in <var>DIR</var>.
By default <code>localstatedir</code> is set to
<code><var>PREFIX</var>/var</code>. This option is offered by
<code>autoconf</code> and currently unused.</dd>
<dt><code>--mandir=<var>DIR</var></code></dt>
<dd>Install the man documentation in <var>DIR</var>. By default
<code>mandir</code> is set to
<code><var>EPREFIX</var>/man</code>.</dd>
<dt><code>--oldincludedir=<var>DIR</var></code></dt>
<dd>Install C header files for non-gcc in <var>DIR</var>.
By default <code>oldincludedir</code> is set to
<code>/usr/include</code>. This option is offered by
<code>autoconf</code> and currently unused.</dd>
<dt><code>--sbindir=<var>DIR</var></code></dt>
<dd>Install the system administrator executables in <var>DIR</var>.
Those are server programs like <code class="program"><a href="../programs/httpd.html">httpd</a></code>,
<code class="program"><a href="../programs/apachectl.html">apachectl</a></code>, <code class="program"><a href="../programs/suexec.html">suexec</a></code>, etc. which
are necessary to run the Apache HTTP Server. By default
<code>sbindir</code> is set to
<code><var>EPREFIX</var>/sbin</code>.</dd>
<dt><code>--sharedstatedir=<var>DIR</var></code></dt>
<dd>Install modifiable architecture-independent data in <var>DIR</var>.
By default <code>sharedstatedir</code> is set to
<code><var>PREFIX</var>/com</code>. This option is offered by
<code>autoconf</code> and currently unused.</dd>
<dt><code>--sysconfdir=<var>DIR</var></code></dt>
<dd>Install read-only single-machine data like the server configuration
files <code>httpd.conf</code>, <code>mime.types</code>, etc. in
<var>DIR</var>. By default <code>sysconfdir</code> is set to
<code><var>PREFIX</var>/conf</code>.</dd>
</dl>
<h3><a name="systemtypes" id="systemtypes">System types</a></h3>
<p>These options are used to cross-compile the Apache HTTP Server to run on
another system. In normal cases, when building and running the server on
the same system, these options are not used.</p>
<dl>
<dt><code>--build=<var>BUILD</var></code></dt>
<dd>Defines the system type of the system on which the tools are being
built. It defaults to the result of the script
<code>config.guess</code>.</dd>
<dt><code>--host=<var>HOST</var></code></dt>
<dd>Defines the system type of the system on which the server will run.
<var>HOST</var> defaults to <var>BUILD</var>.</dd>
<dt><code>--target=<var>TARGET</var></code></dt>
<dd>Configure for building compilers for the system type
<var>TARGET</var>. It defaults to <var>HOST</var>. This option is
offered by <code>autoconf</code> and not necessary for the Apache HTTP
Server.</dd>
</dl>
<h3><a name="optionalfeatures" id="optionalfeatures">Optional Features</a></h3>
<p>These options are used to fine tune the features your HTTP server will
have.</p>
<h4><a name="generaloptfeat" id="generaloptfeat">General syntax</a></h4>
<p>Generally you can use the following syntax to enable or disable a
feature:</p>
<dl>
<dt><code>--disable-<var>FEATURE</var></code></dt>
<dd>Do not include <var>FEATURE</var>. This is the same as
<code>--enable-<var>FEATURE</var>=no</code>.</dd>
<dt><code>--enable-<var>FEATURE</var>[=<var>ARG</var>]</code></dt>
<dd>Include <var>FEATURE</var>. The default value for <var>ARG</var>
is <code>yes</code>.</dd>
<dt><code>--enable-<var>MODULE</var>=shared</code></dt>
<dd>The corresponding module will be built as a DSO module.
By default enabled modules are linked dynamically.</dd>
<dt><code>--enable-<var>MODULE</var>=static</code></dt>
<dd>The corresponding module will be linked statically.</dd>
</dl>
<div class="note"><h3>Note</h3>
<code>configure</code> will not complain about
<code>--enable-<var>foo</var></code> even if <var>foo</var> doesn't
exist, so you need to type carefully.
</div>
<h4><a name="choosemodules" id="choosemodules">Choosing modules to compile</a></h4>
<p>Most modules are compiled by default and have to be disabled
explicitly or by using the keyword <code>few</code>
(see <code>--enable-modules</code>, <code>--enable-mods-shared</code>
and <code>--enable-mods-static</code> below for further explanation)
or <code>--enable-modules=none</code> to be removed as a group.</p>
<p>Other modules are not compiled by default and have to be enabled
explicitly or by using the keywords <code>all</code> or
<code>reallyall</code> to be available.</p>
<p>To find out which modules are compiled by default, run
<code>./configure -h</code> or <code>./configure --help</code>
and look under <code>Optional Features</code>. Suppose you
are interested in <code>mod_example1</code> and
<code>mod_example2</code>, and you
see this:</p>
<div class="example"><pre>Optional Features:
...
--disable-example1 example module 1
--enable-example2 example module 2
...</pre></div>
<p>Then <code>mod_example1</code> is enabled by default,
and you would use <code>--disable-example1</code> to not
compile it. <code>mod_example2</code> is disabled by
default, and you would use <code>--enable-example2</code>
to compile it.</p>
<h4><a name="mpms" id="mpms">Multi-Processing Modules</a></h4>
<p><a href="../mpm.html">Multi-Processing Modules</a>, or MPMs, implement
the basic behavior of the server. A single MPM must be active in order
for the server to function. The list of available MPMs appears on the
<a href="../mod/">module index page</a>.</p>
<p>MPMs can be built as DSOs for dynamic loading or statically linked with
the server, and are enabled using the following options:</p>
<dl>
<dt><code>--with-mpm=MPM</code></dt>
<dd>
<p>Choose the default MPM for your server. If MPMs are built as DSO
modules (see <code>--enable-mpms-shared</code>), this directive
selects the MPM which will be loaded in the default configuration
file. Otherwise, this directive selects the only available MPM,
which will be statically linked into the server.</p>
<p>If this option is omitted, the <a href="../mpm.html#defaults">default
MPM</a> for your operating system will be used.</p>
</dd>
<dt><code>--enable-mpms-shared=<var>MPM-LIST</var></code></dt>
<dd>
<p>Enable a list of MPMs as dynamic shared modules. One of these
modules must be loaded dynamically using the
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directive.</p>
<p><var>MPM-LIST</var> is a space-separated list of MPM names
enclosed by quotation marks. For example:</p>
<div class="example"><p><code>
--enable-mpms-shared='prefork worker'
</code></p></div>
<p>Additionally you can use the special keyword <code>all</code>,
which will select all MPMs which support dynamic loading on the
current platform and build them as DSO modules. For example:</p>
<div class="example"><p><code>
--enable-mpms-shared=all
</code></p></div>
</dd>
</dl>
<h4><a name="modules" id="modules">Third-party modules</a></h4>
<p>To add additional third-party modules use the following options:</p>
<dl>
<dt><code>--with-module=<var>module-type</var>:<var>module-file</var>[,
<var>module-type</var>:<var>module-file</var>]</code></dt>
<dd><p>Add one or more third-party modules to the list of statically linked
modules. The module source file <code><var>module-file</var></code>
will be searched in the <code>modules/<var>module-type</var></code>
subdirectory of your Apache HTTP server source tree. If it is not found
there <code>configure</code> is considering <var>module-file</var> to be
an absolute file path and tries to copy the source file into the
<var>module-type</var> subdirectory. If the subdirectory doesn't
exist it will be created and populated with a standard
<code>Makefile.in</code>.</p>
<p>This option is useful to add small external modules consisting of
one source file. For more complex modules you should read the
vendor's documentation.</p>
<div class="note"><h3>Note</h3>
If you want to build a DSO module instead of a statically linked
use <code class="program"><a href="../programs/apxs.html">apxs</a></code>.</div>
</dd>
</dl>
<h4><a name="otheroptfeat" id="otheroptfeat">Cumulative and other options</a></h4>
<dl>
<dt><code>--enable-maintainer-mode</code></dt>
<dd>Turn on debugging and compile time warnings
and load all compiled modules.</dd>
<dt><code>--enable-mods-shared=<var>MODULE-LIST</var></code></dt>
<dd>
<p>Defines a list of modules to be enabled and build as dynamic
shared modules. This mean, these module have to be loaded
dynamically by using the <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directive.</p>
<p><var>MODULE-LIST</var> is a space separated list of modulenames
enclosed by quotation marks. The module names are given without the
preceding <code>mod_</code>. For example:</p>
<div class="example"><p><code>
--enable-mods-shared='headers rewrite dav'
</code></p></div>
<p>Additionally you can use the special keywords <code>reallyall</code>,
<code>all</code>, <code>most</code> and <code>few</code>.
For example,</p>
<div class="example"><p><code>
--enable-mods-shared=most
</code></p></div>
<p>will compile most modules and build them as DSO modules,</p>
<div class="example"><p><code>
--enable-mods-shared=few
</code></p></div>
<p>will only compile a very basic set of modules.</p>
<p>The default set is <code>most</code>.</p>
<p>The <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directives for
the chosen modules will be automatically generated in the main
configuration file. By default, all those directives will be commented
out except for the modules that are either required or explicitly selected
by a configure <code>--enable-foo</code> argument. You can change the set
of loaded modules by activating or deactivating the <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directives in
<code>httpd.conf</code>. In addition the
<code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directives for all
built modules can be activated via the configure option
<code>--enable-load-all-modules</code>.</p>
</dd>
<dt><code>--enable-mods-static=<var>MODULE-LIST</var></code></dt>
<dd>This option behaves similar to <code>--enable-mods-shared</code>,
but will link the given modules statically. This mean, these modules
will always be present while running <code class="program"><a href="../programs/httpd.html">httpd</a></code>. They need
not be loaded with <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>.</dd>
<dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
<dd>This option behaves like to <code>--enable-mods-shared</code>,
and will also link the given modules dynamically. The special
keyword <code>none</code> disables the build of all modules.</dd>
<dt><code>--enable-v4-mapped</code></dt>
<dd>Allow IPv6 sockets to handle IPv4 connections.</dd>
<dt><code>--with-port=<var>PORT</var></code></dt>
<dd>This defines the port on which <code class="program"><a href="../programs/httpd.html">httpd</a></code> will listen.
This port number is used when generating the configuration file
<code>httpd.conf</code>. The default is 80.</dd>
<dt><code>--with-program-name</code></dt>
<dd>Define an alternative executable name. The default is
<code>httpd</code>.</dd>
</dl>
<h3><a name="packages" id="packages">Optional packages</a></h3>
<p>These options are used to define optional packages.</p>
<h4><a name="generalpackages" id="generalpackages">General syntax</a></h4>
<p>Generally you can use the following syntax to define an optional
package:</p>
<dl>
<dt><code>--with-<var>PACKAGE</var>[=<var>ARG</var>]</code></dt>
<dd>Use the package <var>PACKAGE</var>. The default value for
<var>ARG</var> is <code>yes</code>.</dd>
<dt><code>--without-<var>PACKAGE</var></code></dt>
<dd>Do not use the package <var>PACKAGE</var>. This is the same as
<code>--with-<var>PACKAGE</var>=no</code>. This option is provided by
<code>autoconf</code> but not very useful for the Apache HTTP
Server.</dd>
</dl>
<h4><a name="packageopt" id="packageopt">Specific packages</a></h4>
<dl>
<dt><code>--with-apr=<var>DIR</var>|<var>FILE</var></code></dt>
<dd>The <a class="glossarylink" href="../glossary.html#apr" title="see glossary">Apache Portable Runtime</a> (APR)
is part of the httpd
source distribution and will automatically be build together with the
HTTP server. If you want to use an already installed APR instead you
have to tell <code>configure</code> the path to the
<code>apr-config</code> script. You may set the absolute path and name
or the directory to the installed APR. <code>apr-config</code> must
exist within this directory or the subdirectory
<code>bin</code>.</dd>
<dt><code>--with-apr-util=<var>DIR</var>|<var>FILE</var></code></dt>
<dd>The Apache Portable Runtime Utilities (APU) are part of the
httpd source distribution and will automatically be build
together with the HTTP server. If you want to use an already installed
APU instead you have to tell <code>configure</code> the path to the
<code>apu-config</code> script. You may set the absolute path and name
or the directory to the installed APU. <code>apu-config</code> must
exist within this directory or the subdirectory
<code>bin</code>.</dd>
<dt><code>--with-ssl=<var>DIR</var></code></dt>
<dd>If <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> has been enabled <code>configure</code>
searches for an installed OpenSSL. You can set the directory path
to the SSL/TLS toolkit instead.</dd>
<dt><code>--with-z=<var>DIR</var></code></dt>
<dd><code>configure</code> searches automatically for an installed
<code>zlib</code> library if your source configuration requires one
(e.g., when <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> is enabled). You can set the
directory path to the compression library instead.</dd>
</dl>
<p>Several features of the Apache HTTP Server, including
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> and <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>'s DBM
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> use simple
key/value databases for quick lookups of information. SDBM is included
in the APU, so this database is always available. If you would like to
use other database types, use the following options to enable
them:</p>
<dl>
<dt><code>--with-gdbm[=<var>path</var>]</code></dt>
<dd>If no <var>path</var> is specified, <code>configure</code> will
search for the include files and libraries of a GNU DBM
installation in the usual search paths. An explicit
<var>path</var> will cause <code>configure</code> to look in
<code><var>path</var>/lib</code> and
<code><var>path</var>/include</code> for the relevant files.
Finally, the <var>path</var> may specify specific include and
library paths separated by a colon.</dd>
<dt><code>--with-ndbm[=<var>path</var>]</code></dt>
<dd>Like <code>--with-gdbm</code>, but searches for a New DBM
installation.</dd>
<dt><code>--with-berkeley-db[=<var>path</var>]</code></dt>
<dd>Like <code>--with-gdbm</code>, but searches for a Berkeley DB
installation.</dd>
</dl>
<div class="note"><h3>Note</h3>
<p>The DBM options are provided by the APU and passed through to its
configuration script. They are useless when using an already
installed APU defined by <code>--with-apr-util</code>.</p>
<p>You may use more then one DBM implementation together with your
HTTP server. The appropriated DBM type will be configured within
the runtime configuration at each time.</p>
</div>
<h3><a name="supportopt" id="supportopt">Options for support programs</a></h3>
<dl>
<dt><code>--enable-static-support</code></dt>
<dd>Build a statically linked version of the support binaries. This
means, a stand-alone executable will be built with all the necessary
libraries integrated. Otherwise the support binaries are linked
dynamically by default.</dd>
<dt><code>--enable-suexec</code></dt>
<dd>Use this option to enable <code class="program"><a href="../programs/suexec.html">suexec</a></code>, which allows you to set
uid and gid for spawned processes. <strong>Do not use this
option unless you understand all the security implications of
running a suid binary on your server.</strong> Further options
to configure <code class="program"><a href="../programs/suexec.html">suexec</a></code> are described <a href="#suexec">below</a>.</dd>
</dl>
<p>It is possible to create a statically linked binary of a single
support program by using the following options:</p>
<dl>
<dt><code>--enable-static-ab</code></dt>
<dd>Build a statically linked version of <code class="program"><a href="../programs/ab.html">ab</a></code>.</dd>
<dt><code>--enable-static-checkgid</code></dt>
<dd>Build a statically linked version of <code>checkgid</code>.</dd>
<dt><code>--enable-static-htdbm</code></dt>
<dd>Build a statically linked version of <code class="program"><a href="../programs/htdbm.html">htdbm</a></code>.</dd>
<dt><code>--enable-static-htdigest</code></dt>
<dd>Build a statically linked version of <code class="program"><a href="../programs/htdigest.html">htdigest</a></code>.</dd>
<dt><code>--enable-static-htpasswd</code></dt>
<dd>Build a statically linked version of <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>.</dd>
<dt><code>--enable-static-logresolve</code></dt>
<dd>Build a statically linked version of <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>.</dd>
<dt><code>--enable-static-rotatelogs</code></dt>
<dd>Build a statically linked version of <code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code>.</dd>
</dl>
<h4><a name="suexec" id="suexec"><code>suexec</code> configuration options</a></h4>
<p>The following options are used to fine tune the behavior of <code class="program"><a href="../programs/suexec.html">suexec</a></code>. See <a href="suexec.html#install">Configuring and installing suEXEC</a>
for further information.</p>
<dl>
<dt><code>--with-suexec-bin</code></dt>
<dd>This defines the path to <code class="program"><a href="../programs/suexec.html">suexec</a></code> binary.
Default is <code>--sbindir</code> (see <a href="#directoryfinetuning">Fine tuning of installation directories</a>).</dd>
<dt><code>--with-suexec-caller</code></dt>
<dd>This defines the user allowed to call <code class="program"><a href="../programs/suexec.html">suexec</a></code>.
It should be the same as the user under which
<code class="program"><a href="../programs/httpd.html">httpd</a></code> normally runs.</dd>
<dt><code>--with-suexec-docroot</code></dt>
<dd>This defines the directory tree under which <code class="program"><a href="../programs/suexec.html">suexec</a></code> access is allowed for executables. Default value is
<code>--datadir/htdocs</code>.</dd>
<dt><code>--with-suexec-gidmin</code></dt>
<dd>Define this as the lowest GID allowed to be a target user for
<code class="program"><a href="../programs/suexec.html">suexec</a></code>. The default value is 100.</dd>
<dt><code>--with-suexec-logfile</code></dt>
<dd>This defines the filename of the <code class="program"><a href="../programs/suexec.html">suexec</a></code> logfile.
By default the logfile is named <code>suexec_log</code> and located in
<code>--logfiledir</code>.</dd>
<dt><code>--with-suexec-safepath</code></dt>
<dd>Define the value of the environment variable <code>PATH</code> to
be set for processes started by <code class="program"><a href="../programs/suexec.html">suexec</a></code>. Default
value is <code>/usr/local/bin:/usr/bin:/bin</code>.</dd>
<dt><code>--with-suexec-userdir</code></dt>
<dd>This defines the subdirectory under the user's directory that
contains all executables for which <code class="program"><a href="../programs/suexec.html">suexec</a></code> access
is allowed. This setting is necessary when you want to use
<code class="program"><a href="../programs/suexec.html">suexec</a></code> together with user-specific directories (as
provided by <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>). The default is
<code>public_html</code>.</dd>
<dt><code>--with-suexec-uidmin</code></dt>
<dd>Define this as the lowest UID allowed to be a target user for
<code class="program"><a href="../programs/suexec.html">suexec</a></code>. The default value is 100.</dd>
<dt><code>--with-suexec-umask</code></dt>
<dd>Set <code>umask</code> for processes started by
<code class="program"><a href="../programs/suexec.html">suexec</a></code>. It defaults to your system settings.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="env" id="env">Environment variables</a></h2>
<p>There are some useful environment variables to override the choices made by
<code>configure</code> or to help it to find libraries and programs with
nonstandard names or locations.</p>
<dl>
<dt><code>CC</code></dt>
<dd>Define the C compiler command to be used for compilation.</dd>
<dt><code>CFLAGS</code></dt>
<dd>Set C compiler flags you want to use for compilation.</dd>
<dt><code>CPP</code></dt>
<dd>Define the C preprocessor command to be used.</dd>
<dt><code>CPPFLAGS</code></dt>
<dd>Set C/C++ preprocessor flags, e.g. <code>-I<var>includedir</var></code>
if you have headers in a nonstandard directory <var>includedir</var>.</dd>
<dt><code>LDFLAGS</code></dt>
<dd>Set linker flags, e.g. <code>-L<var>libdir</var></code> if you have
libraries in a nonstandard directory <var>libdir</var>.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/configure.html" title="English"> en </a> |
<a href="../fr/programs/configure.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/configure.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/configure.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htdbm.html.en 0000664 0001751 0001751 00000044513 14737241666 021275 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htdbm - Manipulate DBM password databases - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>htdbm - Manipulate DBM password databases</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/htdbm.html" title="English"> en </a> |
<a href="../fr/programs/htdbm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/htdbm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>htdbm</code> is used to manipulate the DBM format files used to
store usernames and password for basic authentication of HTTP users via
<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>. See the <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code>
documentation for more information about these DBM files.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Bugs</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">Exit Status</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Examples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Security Considerations</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#restrictions">Restrictions</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code></li><li><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>htdbm</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
[ -<strong>i</strong> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>filename</var> <var>username</var></code></p>
<p><code><strong>htdbm</strong> -<strong>b</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>filename</var> <var>username</var> <var>password</var></code></p>
<p><code><strong>htdbm</strong> -<strong>n</strong>
[ -<strong>i</strong> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>username</var></code></p>
<p><code><strong>htdbm</strong> -<strong>nb</strong>
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>username</var> <var>password</var></code></p>
<p><code><strong>htdbm</strong> -<strong>v</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
[ -<strong>i</strong> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>filename</var> <var>username</var></code></p>
<p><code><strong>htdbm</strong> -<strong>vb</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
<var>filename</var> <var>username</var> <var>password</var></code></p>
<p><code><strong>htdbm</strong> -<strong>x</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
<var>filename</var> <var>username</var></code></p>
<p><code><strong>htdbm</strong> -<strong>l</strong>
[ -<strong>T</strong><var>DBTYPE</var> ]
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-b</code></dt>
<dd>Use batch mode; <em>i.e.</em>, get the password from the command line
rather than prompting for it. This option should be used with extreme care,
since <strong>the password is clearly visible</strong> on the command
line. For script use see the <code>-i</code> option.</dd>
<dt><code>-i</code></dt>
<dd>Read the password from stdin without verification (for script usage).</dd>
<dt><code>-c</code></dt>
<dd>Create the <var>passwdfile</var>. If <var>passwdfile</var> already
exists, it is rewritten and truncated. This option cannot be combined with
the <code>-n</code> option.</dd>
<dt><code>-n</code></dt>
<dd>Display the results on standard output rather than updating a
database. This option changes the syntax of the command line, since the
<var>passwdfile</var> argument (usually the first one) is omitted. It
cannot be combined with the <code>-c</code> option.</dd>
<dt><code>-m</code></dt>
<dd>Use MD5 hashing for passwords. On Windows and Netware, this is
the default.</dd>
<dt><code>-B</code></dt>
<dd>Use bcrypt hashing for passwords. This is currently considered to
be very secure.</dd>
<dt><code>-C</code></dt>
<dd>This flag is only allowed in combination with <code>-B</code> (bcrypt
hashing). It sets the computing time used for the bcrypt algorithm
(higher is more secure but slower, default: 5, valid: 4 to 31).</dd>
<dt><code>-d</code></dt>
<dd>Use <code>crypt()</code> hashing for passwords. The default on all
platforms but Windows and Netware. Though possibly supported by
<code>htdbm</code> on all platforms, it is not supported by the
<code class="program"><a href="../programs/httpd.html">httpd</a></code> server on Windows and Netware.
This algorithm is <strong>insecure</strong> by today's standards.</dd>
<dt><code>-s</code></dt>
<dd>Use SHA hashing for passwords. Facilitates migration from/to Netscape
servers using the LDAP Directory Interchange Format (ldif).
This algorithm is <strong>insecure</strong> by today's standards.</dd>
<dt><code>-p</code></dt>
<dd>Use plaintext passwords. Though <code>htdbm</code> will support
creation on all platforms, the <code class="program"><a href="../programs/httpd.html">httpd</a></code> daemon will
only accept plain text passwords on Windows and Netware.</dd>
<dt><code>-l</code></dt>
<dd>Print each of the usernames and comments from the database on
stdout.</dd>
<dt><code>-v</code></dt>
<dd>Verify the username and password. The program will print a message
indicating whether the supplied password is valid. If the password is
invalid, the program exits with error code 3.</dd>
<dt><code>-x</code></dt>
<dd>Delete user. If the username exists in the specified DBM file, it
will be deleted.</dd>
<dt><code>-t</code></dt>
<dd>Interpret the final parameter as a comment. When this option is
specified, an additional string can be appended to the command line; this
string will be stored in the "Comment" field of the database, associated
with the specified username.</dd>
<dt><code><var>filename</var></code></dt>
<dd>The filename of the DBM format file. Usually without the extension
<code>.db</code>, <code>.pag</code>, or <code>.dir</code>. If
<code>-c</code> is given, the DBM file is created if it does not already
exist, or updated if it does exist.</dd>
<dt><code><var>username</var></code></dt>
<dd>The username to create or update in <var>passwdfile</var>. If
<var>username</var> does not exist in this file, an entry is added. If it
does exist, the password is changed.</dd>
<dt><code><var>password</var></code></dt>
<dd>The plaintext password to be hashed and stored in the DBM file.
Used only with the <code>-b</code> flag.</dd>
<dt><code>-T<var>DBTYPE</var></code></dt>
<dd>Type of DBM file (SDBM, GDBM, DB, or "default").</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="bugs" id="bugs">Bugs</a></h2>
<p>One should be aware that there are a number of different DBM file
formats in existence, and with all likelihood, libraries for more than
one format may exist on your system. The three primary examples are
SDBM, NDBM, GNU GDBM, and Berkeley/Sleepycat DB 2/3/4. Unfortunately,
all these libraries use different file formats, and you must make sure
that the file format used by <var>filename</var> is the same format that
<code>htdbm</code> expects to see. <code>htdbm</code> currently has
no way of determining what type of DBM file it is looking at. If used
against the wrong format, will simply return nothing, or may create a
different DBM file with a different name, or at worst, it may corrupt
the DBM file if you were attempting to write to it.</p>
<p>One can usually use the <code>file</code> program supplied with most
Unix systems to see what format a DBM file is in.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">Exit Status</a></h2>
<p><code>htdbm</code> returns a zero status ("true") if the username and
password have been successfully added or updated in the DBM File.
<code>htdbm</code> returns <code>1</code> if it encounters some problem
accessing files, <code>2</code> if there was a syntax problem with the
command line, <code>3</code> if the password was entered interactively and
the verification entry didn't match, <code>4</code> if its operation was
interrupted, <code>5</code> if a value is too long (username, filename,
password, or final computed record), <code>6</code> if the username
contains illegal characters (see the <a href="#restrictions">Restrictions
section</a>), and <code>7</code> if the file is not a valid DBM password
file.</p>
</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">Examples</a></h2>
<div class="example"><p><code>
htdbm /usr/local/etc/apache/.htdbm-users jsmith
</code></p></div>
<p>Adds or modifies the password for user <code>jsmith</code>. The user
is prompted for the password. If executed on a Windows system, the password
will be hashed using the modified Apache MD5 algorithm; otherwise, the
system's <code>crypt()</code> routine will be used. If the file does not
exist, <code>htdbm</code> will do nothing except return an error.</p>
<div class="example"><p><code>
htdbm -c /home/doe/public_html/.htdbm jane
</code></p></div>
<p>Creates a new file and stores a record in it for user <code>jane</code>.
The user is prompted for the password. If the file exists and cannot be
read, or cannot be written, it is not altered and <code>htdbm</code>
will display a message and return an error status.</p>
<div class="example"><p><code>
htdbm -mb /usr/web/.htdbm-all jones Pwd4Steve
</code></p></div>
<p>Encrypts the password from the command line (<code>Pwd4Steve</code>)
using the MD5 algorithm, and stores it in the specified file.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Security Considerations</a></h2>
<p>Web password files such as those managed by <code>htdbm</code> should
<em>not</em> be within the Web server's URI space -- that is, they should
not be fetchable with a browser.</p>
<p>The use of the <code>-b</code> option is discouraged, since when it is
used the plaintext password appears on the command line.</p>
<p>When using the <code>crypt()</code> algorithm, note that only the first
8 characters of the password are used to form the password. If the supplied
password is longer, the extra characters will be silently discarded.</p>
<p>The SHA hashing option does not use salting: for a given password,
there is only one hashed representation. The <code>crypt()</code> and
MD5 formats permute the representation by prepending a random salt string,
to make dictionary attacks against the passwords more difficult.</p>
<p>The SHA and <code>crypt()</code> formats are insecure by today's
standards.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="restrictions" id="restrictions">Restrictions</a></h2>
<p>On the Windows platform, passwords hashed with
<code>htdbm</code> are limited to no more than <code>255</code>
characters in length. Longer passwords will be truncated to 255
characters.</p>
<p>The MD5 algorithm used by <code>htdbm</code> is specific to the Apache
software; passwords hashed using it will not be usable with other Web
servers.</p>
<p>Usernames are limited to <code>255</code> bytes and may not include the
character <code>:</code>.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/htdbm.html" title="English"> en </a> |
<a href="../fr/programs/htdbm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/htdbm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htdbm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/httxt2dbm.html.en 0000664 0001751 0001751 00000017324 14737241666 022117 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>httxt2dbm - Generate dbm files for use with RewriteMap - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>httxt2dbm - Generate dbm files for use with RewriteMap</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/httxt2dbm.html" title="English"> en </a> |
<a href="../fr/programs/httxt2dbm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/httxt2dbm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>httxt2dbm</code> is used to generate dbm files from text input, for
use in <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> with the
<code>dbm</code> map type.</p>
<p>If the output file already exists, it will not be truncated. New keys will be
added and existing keys will be updated.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Examples</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>httxt2dbm</strong>
[ -<strong>v</strong> ]
[ -<strong>f</strong> <var>DBM_TYPE</var> ]
-<strong>i</strong> <var>SOURCE_TXT</var>
-<strong>o</strong> <var>OUTPUT_DBM</var>
</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-v</code></dt>
<dd>More verbose output</dd>
<dt><code>-f <var>DBM_TYPE</var></code></dt>
<dd>Specify the DBM type to be used for the output. If not specified, will
use the <a class="glossarylink" href="../glossary.html#apr" title="see glossary">APR</a> Default. Available types are:
<code>GDBM</code> for GDBM files,
<code>SDBM</code> for SDBM files,
<code>DB</code> for berkeley DB files,
<code>NDBM</code> for NDBM files,
<code>default</code> for the default DBM type.
</dd>
<dt><code>-i <var>SOURCE_TXT</var></code></dt>
<dd>Input file from which the dbm is to be created. The file should be formatted
with one record per line, of the form: <code>key value</code>.
See the documentation for <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> for
further details of this file's format and meaning.
</dd>
<dt><code>-o <var>OUTPUT_DBM</var></code></dt>
<dd>Name of the output dbm files.</dd>
</dl>
</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">Examples</a></h2>
<div class="example"><p><code>
httxt2dbm -i rewritemap.txt -o rewritemap.dbm<br />
httxt2dbm -f SDBM -i rewritemap.txt -o rewritemap.dbm<br />
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/httxt2dbm.html" title="English"> en </a> |
<a href="../fr/programs/httxt2dbm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/programs/httxt2dbm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/httxt2dbm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htpasswd.html.en 0000664 0001751 0001751 00000044752 14737241666 022041 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htpasswd - Manage user files for basic authentication - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>htpasswd - Manage user files for basic authentication</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/htpasswd.html" title="English"> en </a> |
<a href="../fr/programs/htpasswd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htpasswd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htpasswd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>htpasswd</code> is used to create and update the flat-files used to
store usernames and password for basic authentication of HTTP users. If
<code>htpasswd</code> cannot access a file, such as not being able to write
to the output file or not being able to read the file in order to update it,
it returns an error status and makes no changes.</p>
<p>Resources available from the Apache HTTP server can be restricted to
just the users listed in the files created by <code>htpasswd</code>. This
program can only manage usernames and passwords stored in a flat-file. It
can hash and display password information for use in other types of data
stores, though. To use a DBM database see <code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> or
<code class="program"><a href="../programs/htdbm.html">htdbm</a></code>.</p>
<p><code>htpasswd</code> hashes passwords using either bcrypt, a
version of MD5 modified for Apache, SHA-1, or the system's
<code>crypt()</code> routine. SHA-2-based hashes (SHA-256 and
SHA-512) are supported for <code>crypt()</code>. Files managed by
<code>htpasswd</code> may contain a mixture of different encoding
types of passwords; some user records may have bcrypt or
MD5-hashed passwords while others in the same file may have
passwords hashed with <code>crypt()</code>.</p>
<p>This manual page only lists the command line arguments. For details of
the directives necessary to configure user authentication in
<code class="program"><a href="../programs/httpd.html">httpd</a></code> see the Apache manual, which is part of the
Apache distribution or can be found at <a href="http://httpd.apache.org">http://httpd.apache.org/</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">Exit Status</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Examples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Security Considerations</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#restrictions">Restrictions</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></li><li>The scripts in support/SHA1 which come with the
distribution.</li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>htpasswd</strong>
[ -<strong>c</strong> ]
[ -<strong>i</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>2</strong> |
-<strong>5</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>r</strong> <var>rounds</var> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>D</strong> ]
[ -<strong>v</strong> ] <var>passwdfile</var> <var>username</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>b</strong>
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>2</strong> |
-<strong>5</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>r</strong> <var>rounds</var> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>D</strong> ]
[ -<strong>v</strong> ] <var>passwdfile</var> <var>username</var>
<var>password</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>n</strong>
[ -<strong>i</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>2</strong> |
-<strong>5</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>r</strong> <var>rounds</var> ]
[ -<strong>C</strong> <var>cost</var> ] <var>username</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>nb</strong>
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>2</strong> |
-<strong>5</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>r</strong> <var>rounds</var> ]
[ -<strong>C</strong> <var>cost</var> ] <var>username</var>
<var>password</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-b</code></dt>
<dd>Use batch mode; <em>i.e.</em>, get the password from the command line
rather than prompting for it. This option should be used with extreme care,
since <strong>the password is clearly visible</strong> on the command
line. For script use see the <code>-i</code> option.
Available in 2.4.4 and later.</dd>
<dt><code>-i</code></dt>
<dd>Read the password from stdin without verification (for script usage).</dd>
<dt><code>-c</code></dt>
<dd>Create the <var>passwdfile</var>. If <var>passwdfile</var> already
exists, it is rewritten and truncated. This option cannot be combined with
the <code>-n</code> option.</dd>
<dt><code>-n</code></dt>
<dd>Display the results on standard output rather than updating a file.
This is useful for generating password records acceptable to Apache for
inclusion in non-text data stores. This option changes the syntax of the
command line, since the <var>passwdfile</var> argument (usually the first
one) is omitted. It cannot be combined with the <code>-c</code> option.</dd>
<dt><code>-m</code></dt>
<dd>Use MD5 hashing for passwords. This is the default (since version
2.2.18).</dd>
<dt><code>-2</code></dt>
<dd>Use SHA-256 <code>crypt()</code> based hashes for passwords. This is
supported on most Unix platforms.</dd>
<dt><code>-5</code></dt>
<dd>Use SHA-512 <code>crypt()</code> based hashes for passwords. This is
supported on most Unix platforms.</dd>
<dt><code>-B</code></dt>
<dd>Use bcrypt hashing for passwords. This is currently considered to
be very secure.</dd>
<dt><code>-C</code></dt>
<dd>This flag is only allowed in combination with <code>-B</code> (bcrypt
hashing). It sets the computing time used for the bcrypt algorithm
(higher is more secure but slower, default: 5, valid: 4 to 17).</dd>
<dt><code>-r</code></dt>
<dd>This flag is only allowed in combination with <code>-2</code>
or <code>-5</code>. It sets the number of hash rounds used for the
SHA-2 algorithms (higher is more secure but slower; the default is
5,000).</dd>
<dt><code>-d</code></dt>
<dd>Use <code>crypt()</code> hashing for passwords. This is not
supported by the <code class="program"><a href="../programs/httpd.html">httpd</a></code> server on Windows and
Netware. This algorithm limits the password length to 8 characters.
This algorithm is <strong>insecure</strong> by today's standards.
It used to be the default algorithm until version 2.2.17.</dd>
<dt><code>-s</code></dt>
<dd>Use SHA-1 (160-bit) hashing for passwords. Facilitates migration
from/to Netscape servers using the LDAP Directory Interchange
Format (ldif). This algorithm is <strong>insecure</strong> by
today's standards.</dd>
<dt><code>-p</code></dt>
<dd>Use plaintext passwords. Though <code>htpasswd</code> will support
creation on all platforms, the <code class="program"><a href="../programs/httpd.html">httpd</a></code> daemon will
only accept plain text passwords on Windows and Netware.</dd>
<dt><code>-D</code></dt>
<dd>Delete user. If the username exists in the specified htpasswd file, it
will be deleted.</dd>
<dt><code>-v</code></dt>
<dd>Verify password. Verify that the given password matches the password
of the user stored in the specified htpasswd file.
Available in 2.4.5 and later.</dd>
<dt><code><var>passwdfile</var></code></dt>
<dd>Name of the file to contain the user name and password. If
<code>-c</code> is given, this file is created if it does not already exist,
or rewritten and truncated if it does exist.</dd>
<dt><code><var>username</var></code></dt>
<dd>The username to create or update in <var>passwdfile</var>. If
<var>username</var> does not exist in this file, an entry is added. If it
does exist, the password is changed.</dd>
<dt><code><var>password</var></code></dt>
<dd>The plaintext password to be hashed and stored in the file. Only
used with the <code>-b</code> flag.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">Exit Status</a></h2>
<p><code>htpasswd</code> returns a zero status ("true") if the username and
password have been successfully added or updated in the
<var>passwdfile</var>. <code>htpasswd</code> returns <code>1</code> if it
encounters some problem accessing files, <code>2</code> if there was a
syntax problem with the command line, <code>3</code> if the password was
entered interactively and the verification entry didn't match,
<code>4</code> if its operation was interrupted, <code>5</code> if a value
is too long (username, filename, password, or final computed record),
<code>6</code> if the username contains illegal characters (see the
<a href="#restrictions">Restrictions section</a>), and <code>7</code>
if the file is not a valid password file.</p>
</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">Examples</a></h2>
<div class="example"><p><code>
htpasswd /usr/local/etc/apache/.htpasswd-users jsmith
</code></p></div>
<p>Adds or modifies the password for user <code>jsmith</code>. The user
is prompted for the password. The password will be hashed using the
modified Apache MD5 algorithm. If the file does not exist,
<code>htpasswd</code> will do nothing except return an error.</p>
<div class="example"><p><code>
htpasswd -c /home/doe/public_html/.htpasswd jane
</code></p></div>
<p>Creates a new file and stores a record in it for user <code>jane</code>.
The user is prompted for the password. If the file exists and cannot be
read, or cannot be written, it is not altered and <code>htpasswd</code>
will display a message and return an error status.</p>
<div class="example"><p><code>
htpasswd -db /usr/web/.htpasswd-all jones Pwd4Steve
</code></p></div>
<p>Encrypts the password from the command line (<code>Pwd4Steve</code>)
using the <code>crypt()</code> algorithm, and stores it in the specified
file.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Security Considerations</a></h2>
<p>Web password files such as those managed by <code>htpasswd</code> should
<em>not</em> be within the Web server's URI space -- that is, they should
not be fetchable with a browser.</p>
<p>This program is not safe as a setuid executable. Do <em>not</em> make it
setuid.</p>
<p>The use of the <code>-b</code> option is discouraged, since when it is
used the plaintext password appears on the command line.</p>
<p>When using the <code>crypt()</code> algorithm, note that only the first
8 characters of the password are used to form the password. If the supplied
password is longer, the extra characters will be silently discarded.</p>
<p>The SHA-1 hashing format does not use salting: for a given
password, there is only one hashed representation. The
<code>crypt()</code> and MD5 formats permute the representation by
prepending a random salt string, to make dictionary attacks
against the passwords more difficult.</p>
<p>The SHA-1 and <code>crypt()</code> formats are insecure by
today's standards.</p>
<p>The SHA-2-based <code>crypt()</code> formats (SHA-256 and
SHA-512) are supported on most modern Unix systems, and follow the
specification at <a href="https://www.akkadia.org/drepper/SHA-crypt.txt">https://www.akkadia.org/drepper/SHA-crypt.txt</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="restrictions" id="restrictions">Restrictions</a></h2>
<p>On the Windows platform, passwords hashed with
<code>htpasswd</code> are limited to no more than <code>255</code>
characters in length. Longer passwords will be truncated to 255
characters.</p>
<p>The MD5 algorithm used by <code>htpasswd</code> is specific to the Apache
software; passwords hashed using it will not be usable with other Web
servers.</p>
<p>Usernames are limited to <code>255</code> bytes and may not include the
character <code>:</code>.</p>
<p>The cost of computing a bcrypt password hash value increases
with the number of rounds specified by the <code>-C</code> option.
The <code>apr-util</code> library enforces a maximum number of
rounds of 17 in version <code>1.6.0</code> and later.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/htpasswd.html" title="English"> en </a> |
<a href="../fr/programs/htpasswd.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htpasswd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htpasswd.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htpasswd.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/log_server_status.html.en 0000664 0001751 0001751 00000013766 14737241666 023757 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>log_server_status - Log periodic status summaries - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>log_server_status - Log periodic status summaries</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/log_server_status.html" title="English"> en </a> |
<a href="../fr/programs/log_server_status.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This perl script is designed to be run at a frequent interval by
something like cron. It connects to the server and downloads the status
information. It reformats the information to a single line and logs it to
a file. Adjust the variables at the top of the script to specify the
location of the resulting logfile. <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> will
need to be loaded and configured in order for this script to do its
job.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="configure" id="configure">Usage</a></h2>
<p>The script contains the following section.</p>
<pre class="prettyprint lang-perl">my $wherelog = "/usr/local/apache2/logs/"; # Logs will be like "/usr/local/apache2/logs/19960312"
my $server = "localhost"; # Name of server, could be "www.foo.com"
my $port = "80"; # Port on server
my $request = "/server-status/?auto"; # Request to send</pre>
<p>You'll need to ensure that these variables have the correct values,
and you'll need to have the <code>/server-status</code> handler
configured at the location specified, and the specified log location
needs to be writable by the user which will run the script.</p>
<p>Run the script periodically via cron to produce a daily log file,
which can then be used for statistical analysis.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/log_server_status.html" title="English"> en </a> |
<a href="../fr/programs/log_server_status.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/log_server_status.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/split-logfile.html.en 0000664 0001751 0001751 00000013413 14737241666 022744 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>split-logfile - Split up multi-vhost logfiles - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>split-logfile - Split up multi-vhost logfiles</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/split-logfile.html" title="English"> en </a> |
<a href="../fr/programs/split-logfile.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This perl script will take a combined Web server access log file and
break its contents into separate files. It assumes that the first field of
each line is the virtual host identity, put there using the "<code>%v</code>"
variable in <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code>.
</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="split-logfile" id="split-logfile">Usage</a></h2>
<p>Create a log file with virtual host information in it:</p>
<pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" combined_plus_vhost
CustomLog logs/access_log combined_plus_vhost</pre>
<p>Log files will be created, in the directory where you run the
script, for each virtual host name that appears in the combined log file.
These logfiles will named after the hostname, with a
<code>.log</code> file extension.</p>
<p>The combined log file is read from stdin. Records read will be appended
to any existing log files.</p>
<div class="example"><p><code>split-logfile < access_log</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/split-logfile.html" title="English"> en </a> |
<a href="../fr/programs/split-logfile.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/split-logfile.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/htdigest.html.en 0000664 0001751 0001751 00000017744 14737241666 022020 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>htdigest - manage user files for digest authentication - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>htdigest - manage user files for digest authentication</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/htdigest.html" title="English"> en </a> |
<a href="../fr/programs/htdigest.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htdigest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htdigest.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>htdigest</code> is used to create and update the flat-files used
to store usernames, realm and password for digest authentication of HTTP
users. Resources available from the Apache HTTP server can be restricted
to just the users listed in the files created by <code>htdigest</code>.</p>
<p>This manual page only lists the command line arguments. For details of
the directives necessary to configure digest authentication in
<code class="program"><a href="../programs/httpd.html">httpd</a></code> see the Apache manual, which is part
of the Apache distribution or can be found at
<a href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Security Considerations</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>htdigest</strong> [ -<strong>c</strong> ]
<var>passwdfile</var> <var>realm</var> <var>username</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-c</code></dt>
<dd>Create the <var>passwdfile</var>. If <var>passwdfile</var> already
exists, it is deleted first.</dd>
<dt><code><var>passwdfile</var></code></dt>
<dd>Name of the file to contain the username, realm and password. If
<code>-c</code> is given, this file is created if it does not already
exist, or deleted and recreated if it does exist.</dd>
<dt><code><var>realm</var></code></dt>
<dd>The realm name to which the user name belongs. See
<a href="http://tools.ietf.org/html/rfc2617#section-3.2.1">
http://tools.ietf.org/html/rfc2617#section-3.2.1</a> for more details.
</dd>
<dt><code><var>username</var></code></dt>
<dd>The user name to create or update in <var>passwdfile</var>. If
<var>username</var> does not exist is this file, an entry is added. If it
does exist, the password is changed.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Security Considerations</a></h2>
<p>This program is not safe as a setuid executable. Do <em>not</em> make it
setuid.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/htdigest.html" title="English"> en </a> |
<a href="../fr/programs/htdigest.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/htdigest.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htdigest.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/htdigest.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/rotatelogs.html.en 0000664 0001751 0001751 00000042333 14737241666 022360 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>rotatelogs - Piped logging program to rotate Apache logs - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>rotatelogs - Piped logging program to rotate Apache logs</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/rotatelogs.html" title="English"> en </a> |
<a href="../fr/programs/rotatelogs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>rotatelogs</code> is a simple program for use in
conjunction with Apache's piped logfile feature. It supports
rotation based on a time interval or maximum size of the log.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Examples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#portability">Portability</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>rotatelogs</strong>
[ -<strong>l</strong> ]
[ -<strong>L</strong> <var>linkname</var> ]
[ -<strong>p</strong> <var>program</var> ]
[ -<strong>f</strong> ]
[ -<strong>D</strong> ]
[ -<strong>t</strong> ]
[ -<strong>v</strong> ]
[ -<strong>e</strong> ]
[ -<strong>c</strong> ]
[ -<strong>n</strong> <var>number-of-files</var> ]
<var>logfile</var>
<var>rotationtime</var>|<var>filesize</var>(B|K|M|G)
[ <var>offset</var> ]</code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-l</code></dt>
<dd>Causes the use of local time rather than GMT as the base for the
interval or for <code>strftime(3)</code> formatting with size-based
rotation.</dd>
<dt><code>-L</code> <var>linkname</var></dt>
<dd><p>Causes a hard link to be made from the current logfile
to the specified link name. This can be used to watch
the log continuously across rotations using a command like
<code>tail -F linkname</code>.</p>
<p>If the linkname is not an absolute
path, it is relative to <code>rotatelogs</code>' working directory,
which is the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> when
<code>rotatelogs</code> is run by the server.
</p>
</dd>
<dt><code>-p</code> <var>program</var></dt>
<dd>If given, <code>rotatelogs</code> will execute the specified
program every time a new log file is opened. The filename of the
newly opened file is passed as the first argument to the program. If
executing after a rotation, the old log file is passed as the second
argument. <code>rotatelogs</code> does not wait for the specified
program to terminate before continuing to operate, and will not log
any error code returned on termination. The spawned program uses the
same stdin, stdout, and stderr as rotatelogs itself, and also inherits
the environment.</dd>
<dt><code>-f</code></dt>
<dd>Causes the logfile to be opened immediately, as soon as
<code>rotatelogs</code> starts, instead of waiting for the
first logfile entry to be read (for non-busy sites, there may be
a substantial delay between when the server is started
and when the first request is handled, meaning that the
associated logfile does not "exist" until then, which
causes problems from some automated logging tools)</dd>
<dt><code>-D</code></dt>
<dd>Creates the parent directories of the path that the log file will be
placed in if they do not already exist. This allows <code>strftime(3)</code>
formatting to be used in the path and not just the filename.</dd>
<dt><code>-t</code></dt>
<dd>Causes the logfile to be truncated instead of rotated. This is
useful when a log is processed in real time by a command like tail,
and there is no need for archived data. No suffix will be added to
the filename, however format strings containing '%' characters
will be respected.
</dd>
<dt><code>-T</code></dt>
<dd>Causes all but the initial logfile to be truncated when opened.
This is useful when the format string contains something that will
loop around, such as the day of the month. Available in 2.4.56 and later.
</dd>
<dt><code>-v</code></dt>
<dd>Produce verbose output on STDERR. The output contains
the result of the configuration parsing, and all file open and
close actions.</dd>
<dt><code>-e</code></dt>
<dd>Echo logs through to stdout. Useful when logs need to be further
processed in real time by a further tool in the chain.</dd>
<dt><code>-c</code></dt>
<dd>Create log file for each interval, even if empty.</dd>
<dt><code>-n <var>number-of-files</var></code></dt>
<dd>Use a circular list of filenames without timestamps. This option overwrites
log files at startup and during rotation. With -n 3, the series of log
files opened would be "logfile", "logfile.1", "logfile.2", then overwriting
"logfile".
<br />
When this program first opens "logfile", the file will only be truncated if <code>-t</code> is also provided. Every subsequent rotation will
always begin with truncation of the target file. For size based rotation without <code>-t</code> and existing log files in place,
this option may result in unintuitive behavior such as initial log entries being sent to "logfile.1", and entries in "logfile.1" not being preserved
even if later "logfile.n" have not yet been used.
<br />
Available in 2.4.5 and later.</dd>
<dt><code><var>logfile</var></code></dt>
<dd><p>The path plus basename of the logfile. If <var>logfile</var>
includes any '%' characters, it is treated as a format string for
<code>strftime(3)</code>. Otherwise, the suffix
<var>.nnnnnnnnnn</var> is automatically added and is the time in
seconds (unless the -t option is used). Both formats compute the
start time from the beginning of the current period. For example,
if a rotation time of 86400 is specified, the hour, minute, and
second fields created from the <code>strftime(3)</code> format will
all be zero, referring to the beginning of the current 24-hour
period (midnight).</p>
<p>When using <code>strftime(3)</code> filename formatting,
be sure the log file format has enough granularity to produce
a different file name each time the logs are rotated. Otherwise
rotation will overwrite the same file instead of starting a new
one. For example, if <var>logfile</var> was
<code>/var/log/errorlog.%Y-%m-%d</code> with log rotation at 5
megabytes, but 5 megabytes was reached twice in the same day, the
same log file name would be produced and log rotation would keep
writing to the same file.</p>
<p>If the logfile is not an absolute
path, it is relative to <code>rotatelogs</code>' working directory,
which is the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> when
<code>rotatelogs</code> is run by the server.
</p>
</dd>
<dt><code><var>rotationtime</var></code></dt>
<dd>The time between log file rotations in seconds. The rotation
occurs at the beginning of this interval. For example, if the
rotation time is 3600, the log file will be rotated at the beginning
of every hour; if the rotation time is 86400, the log file will be
rotated every night at midnight. (If no data is logged during an
interval, no file will be created.)</dd>
<dt><code><var>filesize</var>(B|K|M|G)</code></dt>
<dd>The maximum file size in followed by exactly one of the letters
<code>B</code> (Bytes), <code>K</code> (KBytes), <code>M</code> (MBytes)
or <code>G</code> (GBytes).
<p>
When time and size are specified, the size must be given after the time.
Rotation will occur whenever either time or size limits are reached.
</p>
</dd>
<dt><code><var>offset</var></code></dt>
<dd>The number of minutes offset from UTC. If omitted, zero is
assumed and UTC is used. For example, to use local time in the zone
UTC -5 hours, specify a value of <code>-300</code> for this argument.
In most cases, <code>-l</code> should be used instead of specifying
an offset.</dd>
</dl>
</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">Examples</a></h2>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs /var/log/logfile 86400" common</pre>
</div>
<p>This creates the files /var/log/logfile.nnnn where nnnn is
the system time at which the log nominally starts (this time
will always be a multiple of the rotation time, so you can
synchronize cron scripts with it). At the end of each rotation
time (here after 24 hours) a new log is started.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -l /var/log/logfile.%Y.%m.%d 86400" common</pre>
</div>
<p>This creates the files /var/log/logfile.yyyy.mm.dd where
yyyy is the year, mm is the month, and dd is the day of the month.
Logging will switch to a new file every day at midnight, local time.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs /var/log/logfile 5M" common</pre>
</div>
<p>This configuration will rotate the logfile whenever it reaches
a size of 5 megabytes.</p>
<div class="example"><pre class="prettyprint lang-config">ErrorLog "|bin/rotatelogs /var/log/errorlog.%Y-%m-%d-%H_%M_%S 5M"</pre>
</div>
<p>This configuration will rotate the error logfile whenever it
reaches a size of 5 megabytes, and the suffix to the logfile name
will be created of the form
<code>errorlog.YYYY-mm-dd-HH_MM_SS</code>.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -t /var/log/logfile 86400" common</pre>
</div>
<p>This creates the file <code>/var/log/logfile</code>, truncating the file at
startup and then truncating the file once per day. It is expected
in this scenario that a separate process (such as tail) would
process the file in real time.</p>
<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -T /var/log/logfile.%d 86400" common</pre>
</div>
<p>If the server is started (or restarted) on the first of the month, this
appends to <code>/var/log/logfile.01</code>. When a log entry is written on the
second of the month, <code>/var/log/logfile.02</code> is truncated and new entries
will be added to the top. This example keeps approximately 1 months worth of
logs without external maintenance.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="portability" id="portability">Portability</a></h2>
<p>The following logfile format string substitutions should be
supported by all <code>strftime(3)</code> implementations, see
the <code>strftime(3)</code> man page for library-specific
extensions.</p>
<table class="bordered"><tr><td><code>%A</code></td><td>full weekday name (localized)</td></tr>
<tr class="odd"><td><code>%a</code></td><td>3-character weekday name (localized)</td></tr>
<tr><td><code>%B</code></td><td>full month name (localized)</td></tr>
<tr class="odd"><td><code>%b</code></td><td>3-character month name (localized)</td></tr>
<tr><td><code>%c</code></td><td>date and time (localized)</td></tr>
<tr class="odd"><td><code>%d</code></td><td>2-digit day of month</td></tr>
<tr><td><code>%H</code></td><td>2-digit hour (24 hour clock)</td></tr>
<tr class="odd"><td><code>%I</code></td><td>2-digit hour (12 hour clock)</td></tr>
<tr><td><code>%j</code></td><td>3-digit day of year</td></tr>
<tr class="odd"><td><code>%M</code></td><td>2-digit minute</td></tr>
<tr><td><code>%m</code></td><td>2-digit month</td></tr>
<tr class="odd"><td><code>%p</code></td><td>am/pm of 12 hour clock (localized)</td></tr>
<tr><td><code>%S</code></td><td>2-digit second</td></tr>
<tr class="odd"><td><code>%U</code></td><td>2-digit week of year
(Sunday first day of week)</td></tr>
<tr><td><code>%W</code></td><td>2-digit week of year
(Monday first day of week)</td></tr>
<tr class="odd"><td><code>%w</code></td><td>1-digit weekday
(Sunday first day of week)</td></tr>
<tr><td><code>%X</code></td><td>time (localized)</td></tr>
<tr class="odd"><td><code>%x</code></td><td>date (localized)</td></tr>
<tr><td><code>%Y</code></td><td>4-digit year</td></tr>
<tr class="odd"><td><code>%y</code></td><td>2-digit year</td></tr>
<tr><td><code>%Z</code></td><td>time zone name</td></tr>
<tr class="odd"><td><code>%%</code></td><td>literal `%'</td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/rotatelogs.html" title="English"> en </a> |
<a href="../fr/programs/rotatelogs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/rotatelogs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/other.html.en 0000664 0001751 0001751 00000012267 14737241666 021321 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Other Programs - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>Other Programs</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/other.html" title="English"> en </a> |
<a href="../fr/programs/other.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/other.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/other.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This page used to contain documentation for programs which now
have their own docs pages. Please update any links.</p>
<p><code class="program"><a href="../programs/log_server_status.html">log_server_status</a></code></p>
<p><code class="program"><a href="../programs/split-logfile.html">split-logfile</a></code></p>
</div>
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/other.html" title="English"> en </a> |
<a href="../fr/programs/other.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/other.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/other.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/other.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/logresolve.html.en 0000664 0001751 0001751 00000015512 14737241666 022355 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>logresolve - Resolve IP-addresses to hostnames in Apache
log files - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>logresolve - Resolve IP-addresses to hostnames in Apache
log files</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/logresolve.html" title="English"> en </a> |
<a href="../fr/programs/logresolve.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/logresolve.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/logresolve.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>logresolve</code> is a post-processing program to
resolve IP-addresses in Apache's access logfiles. To minimize
impact on your nameserver, logresolve has its very own internal
hash-table cache. This means that each IP number will only be
looked up the first time it is found in the log file.</p>
<p>Takes an Apache log file on standard input. The IP addresses
must be the first thing on each line and must be separated from
the remainder of the line by a space.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>logresolve</strong> [ -<strong>s</strong>
<var>filename</var> ] [ -<strong>c</strong> ] <
<var>access_log</var> > <var>access_log.new</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-s <var>filename</var></code></dt>
<dd>Specifies a filename to record statistics.</dd>
<dt><code>-c</code></dt>
<dd>This causes <code>logresolve</code> to apply some DNS checks:
after finding the hostname from the IP address, it looks up the IP
addresses for the hostname and checks that one of these matches the
original address.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/logresolve.html" title="English"> en </a> |
<a href="../fr/programs/logresolve.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/logresolve.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/logresolve.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/logresolve.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/suexec.html.en 0000664 0001751 0001751 00000015262 14737241666 021472 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>suexec - Switch user before executing external programs - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>suexec - Switch user before executing external programs</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/suexec.html" title="English"> en </a> |
<a href="../fr/programs/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p><code>suexec</code> is used by the Apache HTTP Server to switch
to another user before executing CGI programs. In order to achieve this,
it must run as <code>root</code>. Since the HTTP daemon normally doesn't
run as <code>root</code>, the <code>suexec</code> executable needs the
setuid bit set and must be owned by <code>root</code>. It should never be
writable for any other person than <code>root</code>.</p>
<p>For further information about the concepts and the security model
of suexec please refer to the suexec documentation (<a href="http://httpd.apache.org/docs/2.4/suexec.html">http://httpd.apache.org/docs/2.4/suexec.html</a>).</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="synopsis" id="synopsis">Synopsis</a></h2>
<p><code><strong>suexec</strong> -<strong>V</strong></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-V</code></dt>
<dd>If you are <code>root</code>, this option displays the compile options of
<code>suexec</code>. For security reasons all configuration options are
changeable only at compile time.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/suexec.html" title="English"> en </a> |
<a href="../fr/programs/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../ko/programs/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/suexec.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/programs/configure.html 0000664 0001751 0001751 00000000606 13710016232 021525 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: configure.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: configure.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: configure.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: configure.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/httxt2dbm.html 0000664 0001751 0001751 00000000452 13710016232 021463 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: httxt2dbm.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: httxt2dbm.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: httxt2dbm.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/htcacheclean.html 0000664 0001751 0001751 00000000622 13710016232 022144 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: htcacheclean.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: htcacheclean.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: htcacheclean.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: htcacheclean.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/logresolve.html 0000664 0001751 0001751 00000000612 13710016232 021722 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: logresolve.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: logresolve.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: logresolve.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: logresolve.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/apachectl.html 0000664 0001751 0001751 00000000606 13710016232 021470 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: apachectl.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: apachectl.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: apachectl.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: apachectl.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/fcgistarter.html 0000664 0001751 0001751 00000000460 13710016232 022057 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: fcgistarter.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: fcgistarter.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: fcgistarter.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/htpasswd.html 0000664 0001751 0001751 00000000602 13710016232 021375 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: htpasswd.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: htpasswd.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: htpasswd.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: htpasswd.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/log_server_status.html 0000664 0001751 0001751 00000000341 13710016232 023312 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: log_server_status.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: log_server_status.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/split-logfile.html 0000664 0001751 0001751 00000000331 13710016232 022311 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: split-logfile.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: split-logfile.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/htdigest.html 0000664 0001751 0001751 00000000602 13710016232 021353 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: htdigest.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: htdigest.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: htdigest.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: htdigest.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/programs/rotatelogs.html 0000664 0001751 0001751 00000000612 13710016232 021724 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: rotatelogs.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: rotatelogs.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: rotatelogs.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: rotatelogs.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/ 0000775 0001751 0001751 00000000000 15032766627 016526 5 ustar covener covener httpd-2.4.64/docs/manual/rewrite/flags.html.en 0000664 0001751 0001751 00000132223 14737241666 021116 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>RewriteRule Flags - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>RewriteRule Flags</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/flags.html" title="English"> en </a> |
<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document discusses the flags which are available to the
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directive,
providing detailed explanations and examples.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_b">B (escape backreferences)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_bnp">BNP|backrefnoplus (don't escape space to +)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_bctls">BCTLS</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_bne">BNE</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_c">C|chain</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_co">CO|cookie</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_dpi">DPI|discardpath</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_e">E|env</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_end">END</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_f">F|forbidden</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_g">G|gone</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_h">H|handler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_l">L|last</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_n">N|next</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_nc">NC|nocase</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_ne">NE|noescape</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_ns">NS|nosubreq</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_p">P|proxy</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_pt">PT|passthrough</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_qsa">QSA|qsappend</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_qsd">QSD|qsdiscard</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_qsl">QSL|qslast</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_r">R|redirect</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_s">S|skip</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_t">T|type</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_unsafe_allow_3f">UnsafeAllow3F</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_unsafe_prefix_stat">UnsafePrefixStat</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_unc">UNC</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="introduction" id="introduction">Introduction</a></h2>
<p>A <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> can have
its behavior modified by one or more flags. Flags are included in
square brackets at the end of the rule, and multiple flags are separated
by commas.</p>
<pre class="prettyprint lang-config">RewriteRule pattern target [Flag1,Flag2,Flag3]</pre>
<p>Each flag (with a few exceptions) has a short form, such as
<code>CO</code>, as well as a longer form, such as <code>cookie</code>.
While it is most common to use
the short form, it is recommended that you familiarize yourself with the
long form, so that you remember what each flag is supposed to do.
Some flags take one or more arguments. Flags are not case sensitive.</p>
<p>Flags that alter metadata associated with the request (T=, H=, E=)
have no affect in per-directory and htaccess context, when a substitution
(other than '-') is performed during the same round of rewrite processing.
</p>
<p>Presented here are each of the available flags, along with an example
of how you might use them.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_b" id="flag_b">B (escape backreferences)</a></h2>
<p>The [B] flag instructs <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to escape non-alphanumeric
characters before applying the transformation.</p>
<p><code>mod_rewrite</code> has to unescape URLs before mapping them,
so backreferences are unescaped at the time they are applied.
Using the B flag, non-alphanumeric characters in backreferences
will be escaped. For example, consider the rule:</p>
<p>For similar escaping of server-variables, see
the "escape" <a href="#mapfunc">mapping-function</a></p>
<pre class="prettyprint lang-config">RewriteRule "^search/(.*)$" "/search.php?term=$1"</pre>
<p>Given a search term of 'x & y/z', a browser will encode it as
'x%20%26%20y%2Fz', making the request 'search/x%20%26%20y%2Fz'. Without the B
flag, this rewrite rule will map to 'search.php?term=x & y/z', which
isn't a valid URL, and so would be encoded as
<code>search.php?term=x%20&y%2Fz=</code>, which is not what was intended.</p>
<p>With the B flag set on this same rule, the parameters are re-encoded
before being passed on to the output URL, resulting in a correct mapping to
<code>/search.php?term=x%20%26%20y%2Fz</code>.</p>
<pre class="prettyprint lang-config">RewriteRule "^search/(.*)$" "/search.php?term=$1" [B,PT]</pre>
<p>Note that you may also need to set <code class="directive"><a href="../mod/core.html#allowencodedslashes">AllowEncodedSlashes</a></code> to <code>On</code> to get this
particular example to work, as httpd does not allow encoded slashes in URLs, and
returns a 404 if it sees one.</p>
<p>This escaping is particularly necessary in a proxy situation,
when the backend may break if presented with an unescaped URL.</p>
<p>An alternative to this flag is using a <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> to capture against %{THE_REQUEST} which will capture
strings in the encoded form.</p>
<p>In 2.4.26 and later, you can limit the escaping to specific characters
in backreferences by listing them: <code>[B=#?;]</code>. Note: The space
character can be used in the list of characters to escape, but you must quote
the entire third argument of <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
and the space must not be the last character in the list.</p>
<pre class="prettyprint lang-config"># Escape spaces and question marks. The quotes around the final argument
# are required when a space is included.
RewriteRule "^search/(.*)$" "/search.php?term=$1" "[B= ?]"</pre>
<p>To limit the characters escaped this way, see <a href="#flag_bne">#flag_bne</a>
and <a href="#flag_bctls">#flag_bctls</a></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_bnp" id="flag_bnp">BNP|backrefnoplus (don't escape space to +)</a></h2>
<p>The [BNP] flag instructs <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to escape the space character
in a backreference to %20 rather than '+'. Useful when the backreference
will be used in the path component rather than the query string.</p>
<pre class="prettyprint lang-config"># Escape spaces to %20 in the path instead of + as used in form submission via
# the query string
RewriteRule "^search/(.*)$" "/search.php/$1" "[B,BNP]"</pre>
<p>This flag is available in version 2.4.26 and later.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_bctls" id="flag_bctls">BCTLS</a></h2>
<p>The [BCTLS] flag is similar to the [B] flag, but only escapes
control characters and the space character. This is the same set of
characters rejected when they are copied into the query string unencoded.
</p>
<pre class="prettyprint lang-config"># Escape control characters and spaces
RewriteRule "^search/(.*)$" "/search.php/$1" "[BCTLS]"</pre>
<p>This flag is available in version 2.4.57 and later.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_bne" id="flag_bne">BNE</a></h2>
<p>The list of characters in [BNE=...] are treated as exclusions to the
characters of the [B] or [BCTLS] flags. The listed characters will not be
escaped.
</p>
<pre class="prettyprint lang-config"># Escape the default characters, but leave /
RewriteRule "^search/(.*)$" "/search.php?term=$1" "[B,BNE=/]"</pre>
<p>This flag is available in version 2.4.57 and later.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_c" id="flag_c">C|chain</a></h2>
<p>The [C] or [chain] flag indicates that the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> is chained to the next
rule. That is, if the rule matches, then it is processed as usual and
control moves on to the next rule. However, if it does not match, then
the next rule, and any other rules that are chained together, are
skipped.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_co" id="flag_co">CO|cookie</a></h2>
<p>The [CO], or [cookie] flag, allows you to set a cookie when a
particular <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
matches. The argument consists of three required fields and five optional
fields.</p>
<p>The full syntax for the flag, including all attributes, is as
follows:</p>
<div class="example"><p><code>
[CO=NAME:VALUE:DOMAIN:lifetime:path:secure:httponly:samesite]
</code></p></div>
<p>If a literal ':' character is needed in any of the cookie fields, an
alternate syntax is available. To opt-in to the alternate syntax, the cookie
"Name" should be preceded with a ';' character, and field separators should be
specified as ';'.</p>
<div class="example"><p><code>
[CO=;NAME;VALUE:MOREVALUE;DOMAIN;lifetime;path;secure;httponly;samesite]
</code></p></div>
<p>You must declare a name, a value, and a domain for the cookie to be set.</p>
<dl>
<dt>Domain</dt>
<dd>The domain for which you want the cookie to be valid. This may be a
hostname, such as <code>www.example.com</code>, or it may be a domain,
such as <code>.example.com</code>. It must be at least two parts
separated by a dot. That is, it may not be merely <code>.com</code> or
<code>.net</code>. Cookies of that kind are forbidden by the cookie
security model.</dd>
</dl>
<p>You may optionally also set the following values:</p>
<dl>
<dt>Lifetime</dt>
<dd>The time for which the cookie will persist, in minutes.</dd>
<dd>A value of 0 indicates that the cookie will persist only for the
current browser session. This is the default value if none is
specified.</dd>
<dt>Path</dt>
<dd>The path, on the current website, for which the cookie is valid,
such as <code>/customers/</code> or <code>/files/download/</code>.</dd>
<dd>By default, this is set to <code>/</code> - that is, the entire
website.</dd>
<dt>Secure</dt>
<dd>If set to <code>secure</code>, <code>true</code>, or <code>1</code>,
the cookie will only be permitted to be translated via secure (https)
connections.</dd>
<dt>httponly</dt>
<dd>If set to <code>HttpOnly</code>, <code>true</code>, or
<code>1</code>, the cookie will have the <code>HttpOnly</code> flag set,
which means that the cookie is inaccessible to JavaScript code on
browsers that support this feature.</dd>
<dt>samesite</dt>
<dd>If set to anything other than <code>false</code> or <code>0</code>, the <code>SameSite</code>
attribute is set to the specified value. Typical values are <code>None</code>,
<code>Lax</code>, and <code>Strict</code>. Available in 2.4.47 and later.</dd>
</dl>
<p>Consider this example:</p>
<pre class="prettyprint lang-config">RewriteEngine On
RewriteRule "^/index\.html" "-" [CO=frontdoor:yes:.example.com:1440:/]</pre>
<p>In the example give, the rule doesn't rewrite the request.
The "-" rewrite target tells mod_rewrite to pass the request
through unchanged. Instead, it sets a cookie
called 'frontdoor' to a value of 'yes'. The cookie is valid for any host
in the <code>.example.com</code> domain. It is set to expire in 1440
minutes (24 hours) and is returned for all URIs.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_dpi" id="flag_dpi">DPI|discardpath</a></h2>
<p>The DPI flag causes the PATH_INFO portion of the rewritten URI to be
discarded.</p>
<p>This flag is available in version 2.2.12 and later.</p>
<p>In per-directory context, the URI each <code class="directive">RewriteRule</code>
compares against is the concatenation of the current values of the URI
and PATH_INFO.</p>
<p>The current URI can be the initial URI as requested by the client, the
result of a previous round of mod_rewrite processing, or the result of
a prior rule in the current round of mod_rewrite processing.</p>
<p>In contrast, the PATH_INFO that is appended to the URI before each
rule reflects only the value of PATH_INFO before this round of
mod_rewrite processing. As a consequence, if large portions
of the URI are matched and copied into a substitution in multiple
<code class="directive">RewriteRule</code> directives, without regard for
which parts of the URI came from the current PATH_INFO, the final
URI may have multiple copies of PATH_INFO appended to it.</p>
<p>Use this flag on any substitution where the PATH_INFO that resulted
from the previous mapping of this request to the filesystem is not of
interest. This flag permanently forgets the PATH_INFO established
before this round of mod_rewrite processing began. PATH_INFO will
not be recalculated until the current round of mod_rewrite processing
completes. Subsequent rules during this round of processing will see
only the direct result of substitutions, without any PATH_INFO
appended.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_e" id="flag_e">E|env</a></h2>
<p>With the [E], or [env] flag, you can set the value of an environment
variable. Note that some environment variables may be set after the rule
is run, thus unsetting what you have set. See <a href="../env.html">the
Environment Variables document</a> for more details on how Environment
variables work.</p>
<p>The full syntax for this flag is:</p>
<pre class="prettyprint lang-config">[E=VAR:VAL]
[E=!VAR]</pre>
<p><code>VAL</code> may contain backreferences (<code>$N</code> or
<code>%N</code>) which are expanded.</p>
<p>Using the short form</p>
<div class="example"><p><code>
[E=VAR]
</code></p></div>
<p>you can set the environment variable named <code>VAR</code> to an
empty value.</p>
<p>The form</p>
<div class="example"><p><code>
[E=!VAR]
</code></p></div>
<p>allows to unset a previously set environment variable named
<code>VAR</code>.</p>
<p>Environment variables can then be used in a variety of
contexts, including CGI programs, other RewriteRule directives, or
CustomLog directives.</p>
<p>The following example sets an environment variable called 'image' to a
value of '1' if the requested URI is an image file. Then, that
environment variable is used to exclude those requests from the access
log.</p>
<pre class="prettyprint lang-config">RewriteRule "\.(png|gif|jpg)$" "-" [E=image:1]
CustomLog "logs/access_log" combined env=!image</pre>
<p>Note that this same effect can be obtained using <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>. This technique is offered as
an example, not as a recommendation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_end" id="flag_end">END</a></h2>
<p>Using the [END] flag terminates not only the current round of rewrite
processing (like [L]) but also prevents any subsequent rewrite
processing from occurring in per-directory (htaccess) context.</p>
<p>This does not apply to new requests resulting from external
redirects.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_f" id="flag_f">F|forbidden</a></h2>
<p>Using the [F] flag causes the server to return a 403 Forbidden status
code to the client. While the same behavior can be accomplished using
the <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> directive, this
allows more flexibility in assigning a Forbidden status.</p>
<p>The following rule will forbid <code>.exe</code> files from being
downloaded from your server.</p>
<pre class="prettyprint lang-config">RewriteRule "\.exe" "-" [F]</pre>
<p>This example uses the "-" syntax for the rewrite target, which means
that the requested URI is not modified. There's no reason to rewrite to
another URI, if you're going to forbid the request.</p>
<p>When using [F], an [L] is implied - that is, the response is returned
immediately, and no further rules are evaluated.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_g" id="flag_g">G|gone</a></h2>
<p>The [G] flag forces the server to return a 410 Gone status with the
response. This indicates that a resource used to be available, but is no
longer available.</p>
<p>As with the [F] flag, you will typically use the "-" syntax for the
rewrite target when using the [G] flag:</p>
<pre class="prettyprint lang-config">RewriteRule "oldproduct" "-" [G,NC]</pre>
<p>When using [G], an [L] is implied - that is, the response is returned
immediately, and no further rules are evaluated.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_h" id="flag_h">H|handler</a></h2>
<p>Forces the resulting request to be handled with the specified
handler. For example, one might use this to force all files without a
file extension to be parsed by the php handler:</p>
<pre class="prettyprint lang-config">RewriteRule "!\." "-" [H=application/x-httpd-php]</pre>
<p>
The regular expression above - <code>!\.</code> - will match any request
that does not contain the literal <code>.</code> character.
</p>
<p>This can be also used to force the handler based on some conditions.
For example, the following snippet used in per-server context allows
<code>.php</code> files to be <em>displayed</em> by <code>mod_php</code>
if they are requested with the <code>.phps</code> extension:</p>
<pre class="prettyprint lang-config">RewriteRule "^(/source/.+\.php)s$" "$1" [H=application/x-httpd-php-source]</pre>
<p>The regular expression above - <code>^(/source/.+\.php)s$</code> - will
match any request that starts with <code>/source/</code> followed by 1 or
n characters followed by <code>.phps</code> literally. The backreference
$1 referrers to the captured match within parenthesis of the regular
expression.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_l" id="flag_l">L|last</a></h2>
<p>The [L] flag causes <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> to stop processing
the rule set. In most contexts, this means that if the rule matches, no
further rules will be processed. This corresponds to the
<code>last</code> command in Perl, or the <code>break</code> command in
C. Use this flag to indicate that the current rule should be applied
immediately without considering further rules.</p>
<p>If you are using <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> in either
<code>.htaccess</code> files or in
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections,
it is important to have some understanding of how the rules are
processed. The simplified form of this is that once the rules have been
processed, the rewritten request is handed back to the URL parsing
engine to do what it may with it. It is possible that as the rewritten
request is handled, the <code>.htaccess</code> file or
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> section
may be encountered again, and thus the ruleset may be run again from the
start. Most commonly this will happen if one of the rules causes a
redirect - either internal or external - causing the request process to
start over.</p>
<p>It is therefore important, if you are using <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directives in one of these
contexts, that you take explicit steps to avoid rules looping, and not
count solely on the [L] flag to terminate execution of a series of
rules, as shown below.</p>
<p> An alternative flag, [END], can be used to terminate not only the
current round of rewrite processing but prevent any subsequent
rewrite processing from occurring in per-directory (htaccess)
context. This does not apply to new requests resulting from external
redirects.</p>
<p>The example given here will rewrite any request to
<code>index.php</code>, giving the original request as a query string
argument to <code>index.php</code>, however, the <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> ensures that if the request
is already for <code>index.php</code>, the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> will be skipped.</p>
<pre class="prettyprint lang-config">RewriteBase "/"
RewriteCond "%{REQUEST_URI}" !=/index.php
RewriteRule "^(.*)" "/index.php?req=$1" [L,PT]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_n" id="flag_n">N|next</a></h2>
<p>
The [N] flag causes the ruleset to start over again from the top, using
the result of the ruleset so far as a starting point. Use
with extreme caution, as it may result in loop.
</p>
<p>
The [Next] flag could be used, for example, if you wished to replace a
certain string or letter repeatedly in a request. The example shown here
will replace A with B everywhere in a request, and will continue doing
so until there are no more As to be replaced.
</p>
<pre class="prettyprint lang-config">RewriteRule "(.*)A(.*)" "$1B$2" [N]</pre>
<p>You can think of this as a <code>while</code> loop: While this
pattern still matches (i.e., while the URI still contains an
<code>A</code>), perform this substitution (i.e., replace the
<code>A</code> with a <code>B</code>).</p>
<p>In 2.4.8 and later, this module returns an error after 10,000 iterations to
protect against unintended looping. An alternative maximum number of
iterations can be specified by adding to the N flag. </p>
<pre class="prettyprint lang-config"># Be willing to replace 1 character in each pass of the loop
RewriteRule "(.+)[><;]$" "$1" [N=32000]
# ... or, give up if after 10 loops
RewriteRule "(.+)[><;]$" "$1" [N=10]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_nc" id="flag_nc">NC|nocase</a></h2>
<p>Use of the [NC] flag causes the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to be matched in a
case-insensitive manner. That is, it doesn't care whether letters appear
as upper-case or lower-case in the matched URI.</p>
<p>In the example below, any request for an image file will be proxied
to your dedicated image server. The match is case-insensitive, so that
<code>.jpg</code> and <code>.JPG</code> files are both acceptable, for
example.</p>
<pre class="prettyprint lang-config">RewriteRule "(.*\.(jpg|gif|png))$" "http://images.example.com$1" [P,NC]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_ne" id="flag_ne">NE|noescape</a></h2>
<p>By default, special characters, such as <code>&</code> and
<code>?</code>, for example, will be converted to their hexcode
equivalent for rules that result in external redirects.
Using the [NE] flag prevents that from happening.
</p>
<pre class="prettyprint lang-config">RewriteRule "^/anchor/(.+)" "/bigpage.html#$1" [NE,R]</pre>
<p>
The above example will redirect <code>/anchor/xyz</code> to
<code>/bigpage.html#xyz</code>. Omitting the [NE] will result in the #
being converted to its hexcode equivalent, <code>%23</code>, which will
then result in a 404 Not Found error condition.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_ns" id="flag_ns">NS|nosubreq</a></h2>
<p>Use of the [NS] flag prevents the rule from being used on
subrequests. For example, a page which is included using an SSI (Server
Side Include) is a subrequest, and you may want to avoid rewrites
happening on those subrequests. Also, when <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>
tries to find out information about possible directory default files
(such as <code>index.html</code> files), this is an internal
subrequest, and you often want to avoid rewrites on such subrequests.
On subrequests, it is not always useful, and can even cause errors, if
the complete set of rules are applied. Use this flag to exclude
problematic rules.</p>
<p>To decide whether or not to use this rule: if you prefix URLs with
CGI-scripts, to force them to be processed by the CGI-script, it's
likely that you will run into problems (or significant overhead)
on sub-requests. In these cases, use this flag.</p>
<p>
Images, javascript files, or css files, loaded as part of an HTML page,
are not subrequests - the browser requests them as separate HTTP
requests.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_p" id="flag_p">P|proxy</a></h2>
<p>Use of the [P] flag causes the request to be handled by
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, and handled via a proxy request. For
example, if you wanted all image requests to be handled by a back-end
image server, you might do something like the following:</p>
<pre class="prettyprint lang-config">RewriteRule "/(.*)\.(jpg|gif|png)$" "http://images.example.com/$1.$2" [P]</pre>
<p>Use of the [P] flag implies [L] - that is, the request is immediately
pushed through the proxy, and any following rules will not be
considered.</p>
<p>
You must make sure that the substitution string is a valid URI
(typically starting with <code>http://</code><em>hostname</em>) which can be
handled by the <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. If not, you will get an
error from the proxy module. Use this flag to achieve a
more powerful implementation of the <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> directive,
to map remote content into the namespace of the local server.</p>
<div class="warning">
<h3>Security Warning</h3>
<p>Take care when constructing the target URL of the rule, considering
the security impact from allowing the client influence over the set of
URLs to which your server will act as a proxy. Ensure that the scheme
and hostname part of the URL is either fixed, or does not allow the
client undue influence.</p>
</div>
<div class="warning">
<h3>Performance warning</h3>
<p>Using this flag triggers the use of <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, without
handling of persistent connections as the default worker is used in this case,
which does not handle connection pooling/reuse.</p>
<p>In order to use persistent connections you need to setup a
<code class="directive"><a href="../mod/mod_proxy.html#proxy">Proxy</a></code> block at least for the scheme
and host part of the target URL containing a
<code class="directive"><a href="../mod/mod_proxy.html#proxyset">ProxySet</a></code> directive where you e.g. set
a timeout.</p>
<p>If you set it up with <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> or
<code class="directive"><a href="../mod/mod_proxy.html#proxypassmatch">ProxyPassMatch</a></code> persistent connections
will be used automatically.</p>
</div>
<p>Note: <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> must be enabled in order
to use this flag.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_pt" id="flag_pt">PT|passthrough</a></h2>
<p>
The target (or substitution string) in a RewriteRule is assumed to be a
file path, by default. The use of the [PT] flag causes it to be treated
as a URI instead. That is to say, the
use of the [PT] flag causes the result of the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to be passed back through
URL mapping, so that location-based mappings, such as <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code>, or <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>, for example, might have a
chance to take effect.
</p>
<p>
If, for example, you have an
<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>
for /icons, and have a <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> pointing there, you should
use the [PT] flag to ensure that the
<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> is evaluated.
</p>
<pre class="prettyprint lang-config">Alias "/icons" "/usr/local/apache/icons"
RewriteRule "/pics/(.+)\.jpg$" "/icons/$1.gif" [PT]</pre>
<p>
Omission of the [PT] flag in this case will cause the Alias to be
ignored, resulting in a 'File not found' error being returned.
</p>
<p>The <code>PT</code> flag implies the <code>L</code> flag:
rewriting will be stopped in order to pass the request to
the next phase of processing.</p>
<p>Note that the <code>PT</code> flag is implied in per-directory
contexts such as
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections
or in <code>.htaccess</code> files. The only way to circumvent that
is to rewrite to <code>-</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_qsa" id="flag_qsa">QSA|qsappend</a></h2>
<p>
When the replacement URI contains a query string, the default behavior
of <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> is to discard
the existing query string, and replace it with the newly generated one.
Using the [QSA] flag causes the query strings to be combined.
</p>
<p>Consider the following rule:</p>
<pre class="prettyprint lang-config">RewriteRule "/pages/(.+)" "/page.php?page=$1" [QSA]</pre>
<p>With the [QSA] flag, a request for <code>/pages/123?one=two</code> will be
mapped to <code>/page.php?page=123&one=two</code>. Without the [QSA]
flag, that same request will be mapped to
<code>/page.php?page=123</code> - that is, the existing query string
will be discarded.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_qsd" id="flag_qsd">QSD|qsdiscard</a></h2>
<p>
When the requested URI contains a query string, and the target URI does
not, the default behavior of <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> is to copy that query
string to the target URI. Using the [QSD] flag causes the query string
to be discarded.
</p>
<p>This flag is available in version 2.4.0 and later.</p>
<p>
Using [QSD] and [QSA] together will result in [QSD] taking precedence.
</p>
<p>
If the target URI has a query string, the default behavior will be
observed - that is, the original query string will be discarded and
replaced with the query string in the <code>RewriteRule</code> target
URI.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_qsl" id="flag_qsl">QSL|qslast</a></h2>
<p>
By default, the first (left-most) question mark in the substitution
delimits the path from the query string. Using the [QSL] flag instructs
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to instead split
the two components using the last (right-most) question mark. </p>
<p>
This is useful when mapping to files that have literal question marks in
their filename. If no query string is used in the substitution,
a question mark can be appended to it in combination with this flag. </p>
<p> This flag is available in version 2.4.19 and later.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_r" id="flag_r">R|redirect</a></h2>
<p>
Use of the [R] flag causes a HTTP redirect to be issued to the browser.
If a fully-qualified URL is specified (that is, including
<code>http://servername/</code>) then a redirect will be issued to that
location. Otherwise, the current protocol, servername, and port number
will be used to generate the URL sent with the redirect.
</p>
<p>
<em>Any</em> valid HTTP response status code may be specified,
using the syntax [R=305], with a 302 status code being used by
default if none is specified. The status code specified need not
necessarily be a redirect (3xx) status code. However,
if a status code is outside the redirect range (300-399) then the
substitution string is dropped entirely, and rewriting is stopped as if
the <code>L</code> were used.</p>
<p>In addition to response status codes, you may also specify redirect
status using their symbolic names: <code>temp</code> (default),
<code>permanent</code>, or <code>seeother</code>.</p>
<p>
You will almost always want to use [R] in conjunction with [L] (that is,
use [R,L]) because on its own, the [R] flag prepends
<code>http://thishost[:thisport]</code> to the URI, but then passes this
on to the next rule in the ruleset, which can often result in 'Invalid
URI in request' warnings.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_s" id="flag_s">S|skip</a></h2>
<p>The [S] flag is used to skip rules that you don't want to run. The
syntax of the skip flag is [S=<em>N</em>], where <em>N</em> signifies
the number of rules to skip (provided the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">
RewriteRule</a></code> and any preceding <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">
RewriteCond</a></code> directives match). This can be thought of as a
<code>goto</code> statement in your rewrite ruleset. In the following
example, we only want to run the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">
RewriteRule</a></code> if the requested URI doesn't correspond with an
actual file.</p>
<pre class="prettyprint lang-config"># Is the request for a non-existent file?
RewriteCond "%{REQUEST_FILENAME}" !-f
RewriteCond "%{REQUEST_FILENAME}" !-d
# If so, skip these two RewriteRules
RewriteRule ".?" "-" [S=2]
RewriteRule "(.*\.gif)" "images.php?$1"
RewriteRule "(.*\.html)" "docs.php?$1"</pre>
<p>This technique is useful because a <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> only applies to the
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> immediately
following it. Thus, if you want to make a <code>RewriteCond</code> apply
to several <code>RewriteRule</code>s, one possible technique is to
negate those conditions and add a <code>RewriteRule</code> with a [Skip] flag. You can
use this to make pseudo if-then-else constructs: The last rule of
the then-clause becomes <code>skip=N</code>, where N is the
number of rules in the else-clause:</p>
<pre class="prettyprint lang-config"># Does the file exist?
RewriteCond "%{REQUEST_FILENAME}" !-f
RewriteCond "%{REQUEST_FILENAME}" !-d
# Create an if-then-else construct by skipping 3 lines if we meant to go to the "else" stanza.
RewriteRule ".?" "-" [S=3]
# IF the file exists, then:
RewriteRule "(.*\.gif)" "images.php?$1"
RewriteRule "(.*\.html)" "docs.php?$1"
# Skip past the "else" stanza.
RewriteRule ".?" "-" [S=1]
# ELSE...
RewriteRule "(.*)" "404.php?file=$1"
# END</pre>
<p>It is probably easier to accomplish this kind of configuration using
the <code class="directive"><If></code>, <code class="directive"><ElseIf></code>, and <code class="directive"><Else></code> directives instead.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_t" id="flag_t">T|type</a></h2>
<p>Sets the MIME type with which the resulting response will be
sent. This has the same effect as the <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> directive.</p>
<p>For example, you might use the following technique to serve Perl
source code as plain text, if requested in a particular way:</p>
<pre class="prettyprint lang-config"># Serve .pl files as plain text
RewriteRule "\.pl$" "-" [T=text/plain]</pre>
<p>Or, perhaps, if you have a camera that produces jpeg images without
file extensions, you could force those images to be served with the
correct MIME type by virtue of their file names:</p>
<pre class="prettyprint lang-config"># Files with 'IMG' in the name are jpg images.
RewriteRule "IMG" "-" [T=image/jpg]</pre>
<p>Please note that this is a trivial example, and could be better done
using <code class="directive"><a href="../mod/core.html#filesmatch"><FilesMatch></a></code>
instead. Always consider the alternate
solutions to a problem before resorting to rewrite, which will
invariably be a less efficient solution than the alternatives.</p>
<p>
If used in per-directory context, use only <code>-</code> (dash)
as the substitution <em>for the entire round of mod_rewrite processing</em>,
otherwise the MIME-type set with this flag is lost due to an internal
re-processing (including subsequent rounds of mod_rewrite processing).
The <code>L</code> flag can be useful in this context to end the
<em>current</em> round of mod_rewrite processing.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_unsafe_allow_3f" id="flag_unsafe_allow_3f">UnsafeAllow3F</a></h2>
<p> Setting this flag is required to allow a rewrite to continue If the
HTTP request being written has an encoded question mark, '%3f', and the
rewritten result has a '?' in the substiution. This protects from a malicious
URL taking advantage of a capture and re-substitution of the encoded
question mark.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_unsafe_prefix_stat" id="flag_unsafe_prefix_stat">UnsafePrefixStat</a></h2>
<p> Setting this flag is required in server-scoped substitutions
start with a variable or backreference and resolve to a filesystem path.
These substitutions are not prefixed with the document root.
This protects from a malicious URL causing the expanded substitution to
map to an unexpected filesystem location.</p>
<p>Available in Apache HTTP Server 2.4.60 and later.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_unc" id="flag_unc">UNC</a></h2>
<p> Setting this flag prevents the merging of multiple leading slashes,
as used in Windows UNC paths. The flag is not necessary when the rules
substitution starts with multiple literal slashes.</p>
<p>Available in Apache HTTP Server 2.4.62 and later.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/flags.html" title="English"> en </a> |
<a href="../fr/rewrite/flags.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/flags.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/proxy.html.en 0000664 0001751 0001751 00000016754 14737241666 021215 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Using mod_rewrite for Proxying - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Using mod_rewrite for Proxying</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/proxy.html" title="English"> en </a> |
<a href="../fr/rewrite/proxy.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
<a href="../mod/mod_rewrite.html">reference documentation</a>. It describes
how to use the RewriteRule's [P] flag to proxy content to another server.
A number of recipes are provided that describe common scenarios.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="dynamic-proxy" id="dynamic-proxy">Proxying Content with mod_rewrite</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>
mod_rewrite provides the [P] flag, which allows URLs to be passed,
via mod_proxy, to another server. Two examples are given here. In
one example, a URL is passed directly to another server, and served
as though it were a local URL. In the other example, we proxy
missing content to a back-end server.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>To simply map a URL to another server, we use the [P] flag, as
follows:</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteBase "/products/"
RewriteRule "^widget/(.*)$" "http://product.example.com/widget/$1" [P]
ProxyPassReverse "/products/widget/" "http://product.example.com/widget/"</pre>
<p>In the second example, we proxy the request only if we can't find
the resource locally. This can be very useful when you're migrating
from one server to another, and you're not sure if all the content
has been migrated yet.</p>
<pre class="prettyprint lang-config">RewriteCond "%{REQUEST_FILENAME}" !-f
RewriteCond "%{REQUEST_FILENAME}" !-d
RewriteRule "^/(.*)" "http://old.example.com/$1" [P]
ProxyPassReverse "/" "http://old.example.com/"</pre>
</dd>
<dt>Discussion:</dt>
<dd><p>In each case, we add a <code class="directive"><a href="../mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> directive to ensure
that any redirects issued by the backend are correctly passed on to
the client.</p>
<p>Consider using either <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> or <code class="directive"><a href="../mod/mod_proxy.html#proxypassmatch">ProxyPassMatch</a></code> whenever possible in
preference to mod_rewrite.</p>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/proxy.html" title="English"> en </a> |
<a href="../fr/rewrite/proxy.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/proxy.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/vhosts.html.en 0000664 0001751 0001751 00000030246 14737241666 021352 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Dynamic mass virtual hosts with mod_rewrite - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Dynamic mass virtual hosts with mod_rewrite</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/vhosts.html" title="English"> en </a> |
<a href="../fr/rewrite/vhosts.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
<a href="../mod/mod_rewrite.html">reference documentation</a>. It describes
how you can use <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> to create dynamically
configured virtual hosts.</p>
<div class="warning">mod_rewrite is not the best way to configure
virtual hosts. You should first consider the <a href="../vhosts/mass.html">alternatives</a> before resorting to
mod_rewrite. See also the "<a href="avoid.html#vhosts">how to avoid
mod_rewrite</a> document.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#per-hostname">Virtual Hosts For Arbitrary Hostnames</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#simple.rewrite">Dynamic
Virtual Hosts Using <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#xtra-conf">Using a Separate Virtual Host Configuration File</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="per-hostname" id="per-hostname">Virtual Hosts For Arbitrary Hostnames</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>We want to automatically create a virtual host for every hostname
which resolves in our domain, without having to create
new VirtualHost sections.</p>
<p>In this recipe, we assume that we'll be using the hostname
<code>www.<strong>SITE</strong>.example.com</code> for each
user, and serve their content out of
<code>/home/<strong>SITE</strong>/www</code>.</p>
</dd>
<dt>Solution:</dt>
<dd>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap lowercase int:tolower
RewriteCond "${lowercase:%{<strong>HTTP_HOST</strong>}}" "^www\.<strong>([^.]+)</strong>\.example\.com$"
RewriteRule "^(.*)" "/home/<strong>%1</strong>/www$1"</pre>
</dd>
<dt>Discussion</dt>
<dd>
<div class="warning">You will need to take care of the DNS
resolution - Apache does
not handle name resolution. You'll need either to create CNAME
records for each hostname, or a DNS wildcard record. Creating DNS
records is beyond the scope of this document.</div>
<p>The internal <code>tolower</code> RewriteMap directive is used to
ensure that the hostnames being used are all lowercase, so that there is
no ambiguity in the directory structure which must be created.</p>
<p>Parentheses used in a <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> are captured into the
backreferences <code>%1</code>, <code>%2</code>, etc, while parentheses
used in <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> are
captured into the backreferences <code>$1</code>, <code>$2</code>,
etc.</p>
<p>
As with many techniques discussed in this document, mod_rewrite really
isn't the best way to accomplish this task. You should, instead,
consider using <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> instead, as it will much
more gracefully handle anything beyond serving static files, such as any
dynamic content, and Alias resolution.
</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="simple.rewrite" id="simple.rewrite">Dynamic
Virtual Hosts Using <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></a></h2>
<p>This extract from <code>httpd.conf</code> does the same
thing as <a href="#per-hostname">the first example</a>. The first
half is very similar to the corresponding part above, except for
some changes, required for backward compatibility and to make the
<code>mod_rewrite</code> part work properly; the second half
configures <code>mod_rewrite</code> to do the actual work.</p>
<p>Because <code>mod_rewrite</code> runs before other URI translation
modules (e.g., <code>mod_alias</code>), <code>mod_rewrite</code> must
be told to explicitly ignore any URLs that would have been handled
by those modules. And, because these rules would otherwise bypass
any <code>ScriptAlias</code> directives, we must have
<code>mod_rewrite</code> explicitly enact those mappings.</p>
<pre class="prettyprint lang-config"># get the server name from the Host: header
UseCanonicalName Off
# splittable logs
LogFormat "%{Host}i %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
<Directory "/www/hosts">
# ExecCGI is needed here because we can't force
# CGI execution in the way that ScriptAlias does
Options FollowSymLinks ExecCGI
</Directory>
RewriteEngine On
# a ServerName derived from a Host: header may be any case at all
RewriteMap lowercase int:tolower
## deal with normal documents first:
# allow Alias "/icons/" to work - repeat for other aliases
RewriteCond "%{REQUEST_URI}" "!^/icons/"
# allow CGIs to work
RewriteCond "%{REQUEST_URI}" "!^/cgi-bin/"
# do the magic
RewriteRule "^/(.*)$" "/www/hosts/${lowercase:%{SERVER_NAME}}/docs/$1"
## and now deal with CGIs - we have to force a handler
RewriteCond "%{REQUEST_URI}" "^/cgi-bin/"
RewriteRule "^/(.*)$" "/www/hosts/${lowercase:%{SERVER_NAME}}/cgi-bin/$1" [H=cgi-script]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="xtra-conf" id="xtra-conf">Using a Separate Virtual Host Configuration File</a></h2>
<p>This arrangement uses more advanced <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
features to work out the translation from virtual host to document
root, from a separate configuration file. This provides more
flexibility, but requires more complicated configuration.</p>
<p>The <code>vhost.map</code> file should look something like
this:</p>
<div class="example"><p><code>
customer-1.example.com /www/customers/1<br />
customer-2.example.com /www/customers/2<br />
# ...<br />
customer-N.example.com /www/customers/N<br />
</code></p></div>
<p>The <code>httpd.conf</code> should contain the following:</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap lowercase int:tolower
# define the map file
RewriteMap vhost "txt:/www/conf/vhost.map"
# deal with aliases as above
RewriteCond "%{REQUEST_URI}" "!^/icons/"
RewriteCond "%{REQUEST_URI}" "!^/cgi-bin/"
RewriteCond "${lowercase:%{SERVER_NAME}}" "^(.+)$"
# this does the file-based remap
RewriteCond "${vhost:%1}" "^(/.*)$"
RewriteRule "^/(.*)$" "%1/docs/$1"
RewriteCond "%{REQUEST_URI}" "^/cgi-bin/"
RewriteCond "${lowercase:%{SERVER_NAME}}" "^(.+)$"
RewriteCond "${vhost:%1}" "^(/.*)$"
RewriteRule "^/cgi-bin/(.*)$" "%1/cgi-bin/$1" [H=cgi-script]</pre>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/vhosts.html" title="English"> en </a> |
<a href="../fr/rewrite/vhosts.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/vhosts.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/remapping.html 0000664 0001751 0001751 00000000321 13710016232 021347 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: remapping.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: remapping.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/proxy.html 0000664 0001751 0001751 00000000311 13710016232 020545 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: proxy.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: proxy.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/avoid.html 0000664 0001751 0001751 00000000311 13710016232 020466 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: avoid.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: avoid.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/intro.html 0000664 0001751 0001751 00000000311 13710016232 020517 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: intro.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: intro.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/tech.html 0000664 0001751 0001751 00000000307 13710016232 020314 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: tech.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: tech.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/index.html.zh-cn.utf8 0000664 0001751 0001751 00000014344 14743132254 022423 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache mod_rewrite - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">模块</a> | <a href="../mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="../images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Apache mod_rewrite</h1>
<div class="toplang">
<p><span>可用语言: </span><a href="../en/rewrite/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/rewrite/" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">此翻译可能过期。要了解最近的更改，请阅读英文版。</div>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> 提供了基于<a href="intro.html#regex">正则表达式</a>规则动态修改传入的请求的 URL 的方法。
这允许你以自己喜欢的任意方法映射任意 URL 到你的内部 URL 结构。</p>
<p>它支持无限的规则，以及为每个规则附加条件，从而提供了一个真正灵活且强大的 URL
操作机制。URL 操作可以依赖于各种测试，例如服务器变量，环境变量，HTTP
头，时戳，甚至外部数据库查询等，以便完成 URL 单元匹配。</p>
<p>这个模块在服务器上下文 (<code>httpd.conf</code>)，虚拟主机上下文 (<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> 指令块)，目录上下文
(<code>.htaccess</code> 文件和 <code><Directory></code>
指令块) 对完整的 URL (包含目录信息部分和查询字符串部分) 操作。
重写结果可以导致新的规则处理，内部的后续处理，外部请求重定向，甚至透过内部代理，
这取决于你为规则附加的<a href="flags.html">标志</a>。</p>
<p>既然 mod_rewrite 这么强大，它当然是相当复杂。这篇文档作为<a href="../mod/mod_rewrite.html">参考手册</a>的补充，试图减轻一些复杂性，
提供你可能使用 mod_rewrite 的常见场景的有充分注释的例子。
但是，我们也试图告诉你，在什么时候你不应当使用 mod_rewrite，
可以使用其它标准的 Apache 特性来达到目的，以避免无谓的复杂性。</p>
<ul>
<li><a href="../mod/mod_rewrite.html">mod_rewrite 参考手册</a></li>
<li><a href="intro.html">正则表达式与 mod_rewrite 入门</a></li>
<li><a href="remapping.html">使用 mod_rewrite 重定向和重新映射 URL</a></li>
<li><a href="access.html">使用 mod_rewrite 控制访问</a></li>
<li><a href="vhosts.html">动态虚拟主机与 mod_rewrite</a></li>
<li><a href="proxy.html">动态代理与 mod_rewrite</a></li>
<li><a href="rewritemap.html">使用 RewriteMap</a></li>
<li><a href="advanced.html">高级技术与诀窍</a></li>
<li><a href="avoid.html">何时 <strong>不要</strong>使用 mod_rewrite</a></li>
<li><a href="flags.html">RewriteRule 标志</a></li>
<li><a href="tech.html">技术细节</a></li>
</ul>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>参见</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">mod_rewrite 参考手册</a></li><li><a href="../urlmapping.html">从 URL 映射到文件系统</a></li><li><a href="http://wiki.apache.org/httpd/Rewrite">mod_rewrite
wiki</a></li><li><a href="../glossary.html">术语</a></li></ul></div>
</div>
<div class="bottomlang">
<p><span>可用语言: </span><a href="../en/rewrite/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/rewrite/" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="../glossary.html">术语</a> | <a href="../sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/index.html.tr.utf8 0000664 0001751 0001751 00000015543 14743132254 022033 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache mod_rewrite - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="../images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="../">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache mod_rewrite</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="../en/rewrite/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/rewrite/" title="Türkçe"> tr </a> |
<a href="../zh-cn/rewrite/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> modülü gelen URL isteklerinde değişiklik
yapabilmek için <a href="intro.html#regex">düzenli ifade</a> kurallarına
dayalı, devingen bir yol sunar. Böylece, keyfi URL'leri dahili URL
yapınızla kolayca eşleyebilirsiniz.</p>
<p>Gerçekten esnek ve güçlü bir URL kurgulama mekanizması oluşturmak için
sınısız sayıda kural ve her kural için de sınırsız sayıda koşul destekler.
URL değişiklikleri çeşitli sınamalara dayanır; sunucu değişkenleri, HTTP
başlıkları, ortam değişkenleri, zaman damgaları hatta çeşitli biçimlerde
harici veritabanı sorguları bile bu amaçla kullanılabilir.</p>
<p>Yeniden yazma kuralları URL’lerin tamamında (path-info kısmı ve sorgu
dizgesi dahil) hem sunucu bağlamında (<code>httpd.conf</code>) hem sanal
konaklar bağlamında (<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> bölümleri), hem de dizin bağlamında
(<code>.htaccess</code> dosyaları ve <code><Directory></code>
bölümleri) çalışır ve URL üzerinde sorgu dizgesi bölümleri bile
oluşturabilir. Kurallara atadığınız <a href="flags.html">seçeneklere</a>
bağlı olarak, yeniden yazılan URL sonuçta dahili işlemlerde, harici
yönlendirmelerde ve vekalet işlemlerinde kullanılabilir.</p>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> modülü çok güçlü olduğundan, gerçekten çok
karmaşık olabilir. Bu belge, <a href="../mod/mod_rewrite.html">başvuru
belgeleri</a>nin tamamlayıcısı olup karmaşıklığı biraz azaltmaya çalışır
ve <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ile elde edilebilen ortak senaryoların
oldukça açıklamalı örneklerini sağlar. Fakat ayrıca,
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> modülünü kullanmamanız, yerine standart
Apache özelliklerini kullanmanız gereken durumları da göstermeye,
böylece gereksiz karmaşıklıktan kurtulmanızı sağlamaya çalıştık.</p>
<ul>
<li><a href="../mod/mod_rewrite.html">mod_rewrite başvuru belgesi</a></li>
<li><a href="intro.html">mod_rewrite ve düzenli ifadelere giriş</a></li>
<li><a href="remapping.html">URL yönlendirme ve yeniden eşlemede mod_rewrite kullanımı</a></li>
<li><a href="access.html">Erişimi denetlemekte mod_rewrite kullanımı</a></li>
<li><a href="vhosts.html">mod_rewrite ile devingen sanal konaklar</a></li>
<li><a href="proxy.html">mod_rewrite ile devingen vekalet</a></li>
<li><a href="rewritemap.html">RewriteMap kullanımı</a></li>
<li><a href="advanced.html">İleri teknikler</a></li>
<li><a href="avoid.html">mod_rewrite ne zaman kullanıl<strong>maMA</strong>lı</a></li>
<li><a href="flags.html">RewriteRule seçenekleri</a></li>
<li><a href="tech.html">Teknik ayrıntılar</a></li>
</ul>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">mod_rewrite başvuru belgesi</a>
</li><li><a href="../urlmapping.html">URL’lerin Dosya Sistemine Eşlenmesi</a></li><li><a href="http://wiki.apache.org/httpd/Rewrite">mod_rewrite wiki</a>
</li><li><a href="../glossary.html">Terimler</a></li></ul></div>
</div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="../en/rewrite/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/rewrite/" title="Türkçe"> tr </a> |
<a href="../zh-cn/rewrite/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="../mod/">Modüller</a> | <a href="../mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="../glossary.html">Terimler</a> | <a href="../sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/vhosts.html 0000664 0001751 0001751 00000000313 13710016232 020714 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: vhosts.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: vhosts.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/access.html.fr.utf8 0000664 0001751 0001751 00000035560 14740503670 022151 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Utiliser mod_rewrite pour le contrôle d'accès - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Utiliser mod_rewrite pour le contrôle d'accès</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/access.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/access.html" title="Français"> fr </a></p>
</div>
<p>Ce document est un complément à la <a href="../mod/mod_rewrite.html">documentation de référence</a> de
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il explique comment utiliser
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour contrôler l'accès à diverses
ressources, ainsi que d'autres techniques en rapport. Il contient de
nombreux exemples d'utilisation courante de mod_rewrite avec une
description détaillée de leur fonctionnement.</p>
<div class="warning">Vous devez vous attacher à comprendre le
fonctionnement des exemples, car la plupart d'entre eux ne
fonctionneront pas sur votre système si vous vous contentez de les
copier/coller dans vos fichiers de configuration.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#blocked-inline-images">Blocage du référencement à chaud (Hotlinking) d'images</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#blocking-of-robots">Blocage des robots</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#host-deny">Rejet des clients contenus dans une liste de proscrits</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#referer-deflector">Aiguillage basé sur l'en-tête Referer</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module mod_rewrite</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en
correspondance</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Serveurs mandataires</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</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="blocked-inline-images" id="blocked-inline-images">Blocage du référencement à chaud (Hotlinking) d'images</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Cette technique vous permet d'interdire à d'autres sites
d'inclure directement vos images dans leurs pages. On fait
souvent référence à cette pratique sous le nom de
référencement à chaud (Hotlinking) qui entraîne l'utilisation
de votre bande passante pour servir des contenus faisant
partie du site de quelqu'un d'autre.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>Cette technique repose sur la valeur de la variable
optionnelle <code>HTTP_REFERER</code>. Certaines personnes
pourront donc contourner cette limitation. Pour la plupart des
utilisateurs cependant, la requête échouera, en ce sens que
l'image ne sera pas affichée depuis le site tiers.</p>
<p>Il y a plusieurs manières de gérer cette situation.</p>
<p>Dans le premier exemple, nous rejetons tout simplement la
requête si elle ne provenait pas d'une page appartenant à notre
site. Pour les besoins de cet exemple, nous supposons que le nom
de votre site est <code>www.example.com</code>.</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_REFERER}" "!^$"
RewriteCond "%{HTTP_REFERER}" "!www.example.com" [NC]
RewriteRule "\.(gif|jpg|png)$" "-" [F,NC]</pre>
<p>Dans le second exemple, plutôt que de rejeter la requête,
nous affichons une autre image à la place.</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_REFERER}" "!^$"
RewriteCond "%{HTTP_REFERER}" "!www.example.com" [NC]
RewriteRule "\.(gif|jpg|png)$" "/images/go-away.png" [R,NC]</pre>
<p>Dans le troisième exemple, nous redirigeons la requête vers
une image appartenant à un autre site.</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_REFERER}" "!^$"
RewriteCond "%{HTTP_REFERER}" "!www.example.com" [NC]
RewriteRule "\.(gif|jpg|png)$" "http://other.example.com/image.gif" [R,NC]</pre>
<p>De tous ces exemples, les deux derniers semblent les plus
efficaces pour faire en sorte que les gens arrêtent de
référencer vos images à chaud, car il ne verront pas les images
qu'ils s'attendent à voir.</p>
</dd>
<dt>Discussion :</dt>
<dd>
<p>Si vous ne voulez pas rediriger la requête, mais
simplement interdire l'accès à la ressource, vous pouvez y
parvenir sans utiliser mod_rewrite :</p>
<pre class="prettyprint lang-config">SetEnvIf Referer "example\.com" localreferer
<FilesMatch "\.(jpg|png|gif)$">
Require env localreferer
</FilesMatch></pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="blocking-of-robots" id="blocking-of-robots">Blocage des robots</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>
Dans cet exemple, nous allons discuter d'une méthode permettant
de bloquer les requêtes persistentes en provenance d'un robot
particulier, ou d'un navigateur.</p>
<p>La méthode classique pour exclure un robot consiste à définir
un fichier, <code>/robots.txt</code> qui spécifie les parties de
votre site web pour lesquelles vous voulez exclure les robots.
Malheureusement, certains robots ne tiennent pas compte de ces
fichiers.
</p>
<p>Notez qu'il existe des méthodes d'exclusion qui n'utilisent
pas mod_rewrite. Notez aussi que toute technique qui repose sur
le contenu de la chaîne client <code>USER_AGENT</code> peut être
contournée très facilement car cette chaîne peut être modifiée.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>On utilise un jeu de règles qui spécifie le répertoire à
protéger, ainsi que la chaîne client <code>USER_AGENT</code> qui
identifie le robot malin ou envahissant.</p>
<p>Dans cet exemple, nous bloquons un robot nommé
<code>Vilain_Robot</code> pour le répertoire
<code>/secret/fichiers</code>. Si vous voulez bloquer ce client
seulement depuis une source particulière, vous pouvez aussi
spécifier un intervalle d'adresses IP.</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_USER_AGENT}" "^NameOfBadRobot"
RewriteCond "%{REMOTE_ADDR}" "=123\.45\.67\.[8-9]"
RewriteRule "^/secret/files/" "-" [F]</pre>
</dd>
<dt>Discussion :</dt>
<dd>
<p>
Vous pouvez cependant parvenir au même résultat sans utiliser
mod_rewrite via la méthode alternative suivante :
</p>
<pre class="prettyprint lang-config">SetEnvIfNoCase User-Agent "^NameOfBadRobot" goaway
<Location "/secret/files">
<RequireAll>
Require all granted
Require not env goaway
</RequireAll>
</Location></pre>
<p>
Comme indiqué plus haut, il est aisé de contourner cette
technique, simplement en modifiant le contenu de l'en-tête
<code>USER_AGENT</code>. Si vous subissez une attaque en règle,
vous allez devoir réfléchir à un blocage à un niveau supérieur,
par exemple une règle de filtrage de votre pare-feu.
</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="host-deny" id="host-deny">Rejet des clients contenus dans une liste de proscrits</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Nous voulons interdire l'accès à notre serveur aux clients
contenus dans une liste de proscrits similaire à
<code>hosts.deny</code>.</p>
</dd>
<dt>Solution :</dt>
<dd>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap hosts-deny "txt:/path/to/hosts.deny"
RewriteCond "${hosts-deny:%{REMOTE_ADDR}|NOT-FOUND}" "!=NOT-FOUND" [OR]
RewriteCond "${hosts-deny:%{REMOTE_HOST}|NOT-FOUND}" "!=NOT-FOUND"
RewriteRule "^" "-" [F]</pre>
<div class="example"><p><code>
##<br />
## hosts.deny<br />
##<br />
## ATTENTION! Ceci est une table de correspondances, non une liste,<br />
## même si elle est traitée comme telle. mod_rewrite<br />
## l'interprète comme une liste de paires clé/valeur, et<br />
## chaque entrée doit au moins posséder une valeur par<br />
## défaut "-".<br />
<br />
193.102.180.41 -<br />
bsdti1.sdm.de -<br />
192.76.162.40 -<br />
</code></p></div>
</dd>
<dt>Discussion :</dt>
<dd>
<p>
La seconde condition RewriteCond présuppose que HostNameLookups est
défini à On, de façon à ce que les adresses IP des clients puissent
être résolues. Dans le cas contraire, vous devez supprimer la
seconde condition, ainsi que le drapeau <code>[OR]</code> de la
première.
</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="referer-deflector" id="referer-deflector">Aiguillage basé sur l'en-tête Referer</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Redirige les requêtes en fonction du Referer de provenance de
la requête, avec des cibles différentes pour chaque Referer.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>Le jeu de règles suivant utilise un fichier de correspondances pour
associer chaque Referer à une cible de redirection.</p>
<pre class="prettyprint lang-config">RewriteMap deflector "txt:/path/to/deflector.map"
RewriteCond "%{HTTP_REFERER}" !=""
RewriteCond "${deflector:%{HTTP_REFERER}}" "=-"
RewriteRule "^" "%{HTTP_REFERER}" [R,L]
RewriteCond "%{HTTP_REFERER}" !=""
RewriteCond "${deflector:%{HTTP_REFERER}|NOT-FOUND}" "!=NOT-FOUND"
RewriteRule "^" "${deflector:%{HTTP_REFERER}}" [R,L]</pre>
<p>Le fichier de correspondances contient les cibles de
redirection associées à chaque Referer, ou, si nous voulons
simplement rediriger les requêtes vers leur Referer, un "-" est
inscrit dans le fichier de correspondances :</p>
<pre class="prettyprint lang-config">##
## deflector.map
##
http://badguys.example.com/bad/index.html -
http://badguys.example.com/bad/index2.html -
http://badguys.example.com/bad/index3.html http://somewhere.example.com/</pre>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/access.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/access.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/access.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/htaccess.html.fr.utf8 0000664 0001751 0001751 00000013206 14740503670 022476 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_rewrite et les fichiers .htaccess - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>mod_rewrite et les fichiers .htaccess</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/htaccess.html" title="Français"> fr </a></p>
</div>
<p>Ce document est un complément de la <a href="../mod/mod_rewrite.html">documentation de référence</a> du module
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il décrit les changements apportés aux règles
lorsqu'on utilise mod_rewrite dans les fichiers .htaccess, et comment
travailler avec ces changements.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module mod_rewrite</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en
correspondance</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Serveurs mandataires</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</a></li></ul></div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/htaccess.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/htaccess.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/avoid.html.fr.utf8 0000664 0001751 0001751 00000042122 14740503670 022002 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Quand ne pas utiliser mod_rewrite - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Quand ne pas utiliser mod_rewrite</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/avoid.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/avoid.html" title="Français"> fr </a></p>
</div>
<p>Ce document est un complément à la <a href="../mod/mod_rewrite.html">Documentation de référence</a> de
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il décrit peut-être un des concepts les
plus importants à propos de <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> - à savoir, quand doit-on éviter
de l'utiliser.</p>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> doit être considéré comme un dernier recours,
lorsqu'aucune alternative n'est possible. Utiliser mod_rewrite lorsqu'il
existe des alternatives plus simples conduit à des configurations
confuses, fragiles, et difficiles à maintenir. La compréhension des
autres alternatives disponibles est une étape très importante sur le
chemin de la maîtrise de <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
<p>Vous devez vous attacher à comprendre le
fonctionnement des exemples, car la plupart d'entre eux ne
fonctionneront pas sur votre système si vous vous contentez de les
copier/coller dans vos fichiers de configuration.</p>
<p>Le cas le plus courant dans lequel <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> est
l'outil approprié est la situation où la seule solution envisageable
nécessite l'accès aux fichiers de configuration du serveur, alors que
cet accès ne vous est pas accordé. Certaines directives de configuration
ne sont disponibles que dans le fichier de configuration du serveur. Si
vous ne pouvez agir que sur les fichiers .htaccess, vous devrez donc
vous tourner vers <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#redirect">Redirection simple</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#alias">Alias d'URL</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#vhosts">Hébergement virtuel</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#proxy">Mandat simple</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#setenv">Test de variables d'environnement</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module mod_rewrite</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en
correspondance</a></li><li><a href="access.html">Contrôle d'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Serveurs mandataires</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="#comments_section">Commentaires</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="redirect" id="redirect">Redirection simple</a></h2>
<p><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> fournit les directives <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code> et <code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> qui permettent de
rediriger une URL vers une autre. Plutôt que d'utiliser la directive
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> pour ce genre de
redirection simple d'une URL ou d'une classe d'URLs vers une autre, on
préfèrera l'utilisation de ces directives. En outre, avec
<code>RedirectMatch</code>, vous pouvez inclure une expression
rationnelle dans votre critère de redirection, ce qui vous permet de
bénéficier de nombreux avantages de la directive
<code>RewriteRule</code>.</p>
<p>Une utilisation courante de la directive <code>RewriteRule</code> est
la redirection de toute une classe d'URLs. Par exemple, toutes les URLs
faisant référence au répertoire <code>/un</code> doivent être
redirigées vers <code>http://un.example.com/</code>, ou toutes les
requêtes <code>http</code> doivent être redirigées vers
<code>https</code>.</p>
<p>Pour ce faire, il est préférable d'utiliser la directive
<code>Redirect</code>. Souvenez-vous que la directive
<code>Redirect</code> conserve les informations relatives au chemin. En
d'autres termes, la redirection d'une URL <code>/un</code> va aussi
rediriger toutes les URLs de niveaux inférieurs comme
<code>/un/deux.html</code> et <code>/un/trois/quatre.html</code>.</p>
<p>Pour rediriger les URLs sous <code>/un</code> vers
<code>http://un.example.com/</code>, utilisez cette définition :</p>
<pre class="prettyprint lang-config">Redirect /one/ http://one.example.com/</pre>
<p>Pour rediriger un nom d'hôte vers un autre nom d'hôte, par exemple
<code>example.com</code> vers <code>www.example.com</code>, voir la
méthode <a href="remapping.html#canonicalhost">Noms d'hôtes canoniques</a>.</p>
<p>Pour rediriger les URLs <code>http</code> vers <code>https</code>,
utilisez cette définition :</p>
<pre class="prettyprint lang-config"><VirtualHost *:80>
ServerName www.example.com
Redirect "/" "https://www.example.com/"
</VirtualHost>
<VirtualHost *:443>
ServerName www.example.com
# ... insérer ici la configuration SSL
</VirtualHost></pre>
<p>L'utilisation de la directive <code>RewriteRule</code> pour accomplir
cette tâche peut se justifier s'il existe d'autres directives
<code>RewriteRule</code> dans la même portée. En effet, lorsque des
directives <code>Redirect</code> et <code>RewriteRule</code> se trouvent
dans la même portée, les directives <code>RewriteRule</code> sont
exécutées en premier, sans tenir compte de leur ordre d'apparition dans
le fichier de configuration.</p>
<p>Dans le cas de la redirection <em>http-vers-https</em>, l'utilisation
de règles <code>RewriteRule</code> se justifie si vous n'avez pas accès
au fichier de configuration principal, et devez donc accomplir cette
tâche au sein d'un fichier <code>.htaccess</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="alias" id="alias">Alias d'URL</a></h2>
<p>La directive <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> permet
de mettre en correspondance un URI avec un répertoire, ce dernier étant
en général situé en dehors de l'arborescence définie par la directive
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. Bien qu'il soit
possible d'effectuer cette mise en correspondance avec
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, il est préférable d'utiliser la directive
<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> pour des raisons de simplicité
et de performances.</p>
<div class="example"><h3>Utilisation de la directive Alias</h3><pre class="prettyprint lang-config">Alias "/cats" "/var/www/virtualhosts/felines/htdocs"</pre>
</div>
<p>
Pour effectuer cette mise en correspondance, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
s'impose si vous n'avez pas accès aux fichiers de configuration du
serveur. En effet, la directive Alias ne peut pas être utilisée dans un
fichier <code>.htaccess</code>, mais seulement dans un contexte de
serveur principal ou de serveur virtuel.
</p>
<p>En outre, vous pouvez arriver au même résultat avec les liens
symboliques, pourvu que <code>Options FollowSymLinks</code> soit activé
sur votre serveur.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="vhosts" id="vhosts">Hébergement virtuel</a></h2>
<p>Bien qu'il soit possible de gérer les <a href="vhosts.html">serveurs
virtuels avec mod_rewrite</a>, il s'agit rarement de la bonne méthode.
Il est pratiquement toujours préférable de créer des blocs
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> individuels.
Dans l'éventualité où vous devez gérer
un grand nombre de serveurs virtuels, vous devez vous tourner vers
<code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> pour créer ces serveurs
automatiquement.</p>
<p>Il est aussi possible d'utiliser des modules comme <code class="module"><a href="../mod/mod_macro.html">mod_macro</a></code> pour
créer un grand nombre de serveurs virtuels dynamiquement.</p>
<p>L'utilisation de <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour la création de
serveurs virtuels peut se révéler appropriée si votre service
d'hébergement ne vous permet pas d'accéder aux fichiers de configuration
du serveur, et que vous soyez par conséquent obligé de passer par les
fichiers <code>.htaccess</code>.</p>
<p>Voir le document <a href="vhosts.html">création de serveurs virtuels
avec mod_rewrite</a> pour plus de détails sur la manière d'y parvenir si
cela semble être tout de même la meilleure approche.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Mandat simple</a></h2>
<p>La directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> fournit
le drapeau <a href="flags.html#flag_p">[P]</a> qui permet de faire passer les URIs
réécrits par <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>.</p>
<pre class="prettyprint lang-config">RewriteRule "^/?images(.*)" "http://serveur-images.local/images$1" [P]</pre>
<p>Cependant, dans les nombreux cas où aucune correspondance au modèle
n'est vraiment nécessaire, comme dans l'exemple ci-dessus, il est
préférable d'utiliser la directive <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>. L'exemple précédent pourrait
être remplacé par :</p>
<pre class="prettyprint lang-config">ProxyPass "/images/" "http://serveur-images.local/images/"</pre>
<p>Que vous utilisiez <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> ou <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>, vous devrez dans tous les cas
utiliser aussi la directive <code class="directive"><a href="../mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> pour intercepter les
redirections en provenance du serveur d'arrière-plan :</p>
<pre class="prettyprint lang-config">ProxyPassReverse "/images/" "http://serveur-images.local/images/"</pre>
<p>Vous devrez cependant tout de même utiliser <code>RewriteRule</code>
lorsque d'autres <code>RewriteRule</code>s se trouvent dans la même portée,
car elles agissent en général avant les directives
<code>ProxyPass</code>, et peuvent ainsi les court-circuiter.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="setenv" id="setenv">Test de variables d'environnement</a></h2>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> est souvent utilisé pour effectuer une
action en fonction de la présence ou de l'absence d'une variable
d'environnement particulière ou d'un en-tête de requête, ce qui peut
être accompli de manière plus efficace via la directive <code class="directive"><a href="../mod/core.html#if"><If></a></code>.</p>
<p>Considérons par exemple le scénario courant où la directive
<code class="directive">RewriteRule</code> est utilisée pour forcer un nom
d'hôte canonique, tel que <code>www.example.com</code> au lieu de
<code>example.com</code>. Il est possible d'utiliser à la place la
directive <code class="directive"><a href="../mod/core.html#if"><If></a></code> comme
suit :</p>
<pre class="prettyprint lang-config"><If "req('Host') != 'www.example.com'">
Redirect "/" "http://www.example.com"
</If></pre>
<p>On peut utiliser cette technique dans de nombreux scénarios courant
pour remplacer <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour effectuer des actions
en fonction d'en-têtes de requêtes ou de réponses, ou de variables
d'environnement.</p>
<p>Voir en particulier la <a href="../expr.html">documentation sur
l'évaluation des expressions</a> pour une vue d'ensemble des types
d'expressions que vous pouvez utiliser dans les sections <code class="directive"><a href="../mod/core.html#if"><If></a></code>,
ainsi que dans certaines directives.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/avoid.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/avoid.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/avoid.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/advanced.html.fr.utf8 0000664 0001751 0001751 00000043172 14740503670 022453 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Advanced Techniques with mod_rewrite - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Advanced Techniques with mod_rewrite</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/advanced.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/advanced.html" title="Français"> fr </a></p>
</div>
<p>Ce document complète la <a href="../mod/mod_rewrite.html">documentation de référence</a> du
module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il présente un certain nombre
de techniques avancées quant à
l'utilisation de mod_rewrite.</p>
<div class="warning">Notez que la plupart des exemples ne fonctionneront
pas en l'état dans la configuration particulière de votre serveur ; il
est donc important de bien comprendre leur fonctionnement, plutôt que de
simplement les copier/coller dans votre configuration.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#sharding">Distribution de la charge entre plusieurs serveurs
d'arrière-plan en fonction de l'adresse IP</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#on-the-fly-content">Régéneration de contenu à la volée</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#load-balancing">Répartition de charge</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#structuredhomedirs">Répertoires Home structurés</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirectanchors">Redirection des ancrages</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#time-dependent">Réécriture dépendant de l'heure</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#setenvvars">Définir des variables d'environnement en fonction de
certaines parties de l'URL</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en
correspondance</a></li><li><a href="access.html">Contrôler l'accès</a></li><li><a href="vhosts.html">serveurs virtuels</a></li><li><a href="proxy.html">serveurs mandataires</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</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="sharding" id="sharding">Distribution de la charge entre plusieurs serveurs
d'arrière-plan en fonction de l'adresse IP</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>La fragmentation ou "sharding" est une technique courante de
distribution de la charge du serveur ou de l'espace de stockage.
Quand on utilise cette méthode, un serveur frontal utilise l'URL
pour répartir de manière appropriée les utilisateurs et objets
entre différents serveurs d'arrière-plan.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>On maintient une table de correspondance entre utilisateurs et
serveurs cibles dans des fichiers externes. Ces derniers se
présentent comme suit :</p>
<div class="example"><p><code>
utilisateur1 serveur_physique_utilisateur1<br />
utilisateur2 serveur_physique_utilisateur2<br />
# etc ...
</code></p></div>
<p>Tout ceci est enregistré dans un fichier
<code>correspondances-utilisateurs-serveurs</code>. Le but est de
faire correspondre</p>
<div class="example"><p><code>
/u/utilisateur1/chemin
</code></p></div>
<p>avec</p>
<div class="example"><p><code>
http://serveur_physique_utilisateur1/u/utilisateur/chemin
</code></p></div>
<p>il n'est ainsi pas nécessaire que tous les chemins URL soient
valides sur tous les serveurs physiques d'arrière-plan. Le jeu de
règles suivant fait tout ceci pour nous, en s'appuyant sur les
fichiers de correspondances, en supposant que serveur0 est un
serveur par défaut qui sera utilisé lorsqu'un utilisateur ne
possèdera pas d'entrée dans la table de correspondances :</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap users-to-hosts "txt:/path/to/map.users-to-hosts"
RewriteRule "^/u/([^/]+)/?(.*)" "http://${users-to-hosts:$1|server0}/u/$1/$2"</pre>
</dd>
</dl>
<p>Voir la documentation de <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> et le <a href="./rewritemap.html">RewriteMap HowTo</a> pour une description plus
approfondie de la syntaxe de cette directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="on-the-fly-content" id="on-the-fly-content">Régéneration de contenu à la volée</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Nous voulons générer du contenu de manière dynamique, mais le
conserver de manière statique lorsqu'il a été généré. La règle
suivante vérifie l'existence du fichier statique, et le génère
s'il est absent. Les fichiers statiques peuvent être supprimés
périodiquement si on le désire (par exemple via cron), et seront
régénérés à la demande.</p>
</dd>
<dt>Solution :</dt>
<dd>
A cet effet, on utilise le jeu de règles suivant :
<pre class="prettyprint lang-config"># Cet exemple n'est valable que dans un contexte de répertoire
RewriteCond "%{REQUEST_URI}" "!-U"
RewriteRule "^(.+)\.html$" "/regenerate_page.cgi" [PT,L]</pre>
<p>L'opérateur <code>-U</code> permet de déterminer si la chaîne
de test (dans ce cas <code>REQUEST_URI</code>) est une URL valide.
Pour ce faire, il utilise une sous-requête. Si cette sous-requête
échoue, ou en d'autres termes, si la ressource demandée n'existe pas,
cette règle invoque le programme CGI
<code>/regenerate_page.cgi</code> qui génère la ressource
demandée et la sauvegarde dans le répertoire des documents, de
façon à ce qu'une copie statique puisse être servie lors d'une
demande ultérieure.</p>
<p>De cette façon, les documents qui ne sont pas mis à jour
régulièrement peuvent être servis sous une forme statique. Si ces
documents doivent être réactualisés, on peut les supprimer du
répertoire des documents, et ils seront ainsi régénérés à la
prochaine demande.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="load-balancing" id="load-balancing">Répartition de charge</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Nous voulons répartir la charge de manière aléatoire entre
plusieurs serveurs en utilisant mod_rewrite.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>Pour y parvenir, nous allons utiliser la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> et une liste de
serveurs.</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap lb "rnd:/path/to/serverlist.txt"
RewriteRule "^/(.*)" "http://${lb:servers}/$1" [P,L]</pre>
<p><code>liste-serveurs.txt</code> contiendra la liste des serveurs :</p>
<div class="example"><p><code>
## liste-serveurs.txt<br />
<br />
serveurs un.example.com|deux.example.com|trois.example.com<br />
</code></p></div>
<p>Si vous voulez qu'un serveur se voit confier d'avantage de charge que
les autres, faites le figurer plusieurs fois dans la liste.</p>
</dd>
<dt>Discussion</dt>
<dd>
<p>Apache possède un module de répartition de charge -
<code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> - beaucoup plus souple et présentant
plus de fonctionnalités dans ce domaine que mod_rewrite.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="structuredhomedirs" id="structuredhomedirs">Répertoires Home structurés</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Certains sites avec des milliers d'utilisateurs organisent
les répertoires utilisateurs de manière structurée, c'est à
dire que chaque répertoire utilisateur se trouve dans un
sous-répertoire dont le nom commence (par exemple) par le
premier caractère du nom de l'utilisateur. Ainsi,
<code>/~larry/chemin</code> correspond à
<code>/home/<strong>l</strong>/larry/public_html/chemin</code>, alors
que <code>/~waldo/chemin</code> correspond à
<code>/home/<strong>w</strong>/waldo/public_html/chemin</code>.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>On utilise le jeu de règles suivant pour développer les
URLs avec tilde selon l'organisation structurée précédente.</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^/~(<strong>([a-z])</strong>[a-z0-9]+)(.*)" "/home/<strong>$2</strong>/$1/public_html$3"</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirectanchors" id="redirectanchors">Redirection des ancrages</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Par défaut, la redirection vers un ancrage HTML ne fonctionne
pas, car mod_rewrite échappe le caractère <code>#</code> en le
transformant en <code>%23</code>, ce qui rend la redirection
inopérante.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>On utilise le drapeau <code>[NE]</code> dans la règle
<code>RewriteRule</code>. NE signifie "No Escape".
</p>
</dd>
<dt>Discussion :</dt>
<dd>Cette technique fonctionne bien entendu pour tout autre
caractère spécial que mod_rewrite, par défaut, code pour insertion
dans une URL.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="time-dependent" id="time-dependent">Réécriture dépendant de l'heure</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Nous voulons servir des contenus différents selon l'heure du
jour en utilisant mod_rewrite.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>Il existe de nombreuses variables nommées
<code>TIME_xxx</code> utilisables dans les conditions de
réécriture. Utilisées en conjonction avec les modèles de
comparaison lexicographique spéciaux <code><STRING</code>,
<code>>STRING</code> et <code>=STRING</code>, elles
permettent d'effectuer des redirections dépendant de
l'heure :</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteCond "%{TIME_HOUR}%{TIME_MIN}" ">0700"
RewriteCond "%{TIME_HOUR}%{TIME_MIN}" "<1900"
RewriteRule "^foo\.html$" "foo.day.html" [L]
RewriteRule "^foo\.html$" "foo.night.html"</pre>
<p>Avec cet exemple, l'URL <code>foo.html</code> renvoie
le contenu de <code>foo.jour.html</code> durant le
créneau horaire <code>07:01-18:59</code>, et le contenu de
<code>foo.nuit.html</code> le reste du temps.</p>
<div class="warning"><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>, les mandataires
intermédiaires et les navigateurs peuvent chacun mettre en cache
les réponses et ainsi afficher une des deux pages en dehors de
la fenêtre de temps configurée. On peut utiliser
<code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code> pour contourner ce problème. Il est
cependant bien plus commode de servir un contenu dynamique, et
de le personnaliser en fonction de l'heure du jour.</div> </dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="setenvvars" id="setenvvars">Définir des variables d'environnement en fonction de
certaines parties de l'URL</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Nous voulons parfois conserver une certaine forme de statut
lorsqu'une réécriture a eu lieu. Par exemple, vous souhaitez
consigner le fait que cette réécriture a eu lieu, et vous servir
plus tard de cette information pour déterminer si une requête était
concernée par cette réécriture. Pour ce faire, on peut utiliser
une variable d'environnement.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>Utiliser le drapeau [E] pour définir une variable
d'environnement.</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^/cheval/(.*)" "/poney/$1" [E=<strong>rewritten:1</strong>]</pre>
<p>Plus loin dans votre jeu de règles, vous pouvez vérifier le
contenu de cette variable d'environnement via une directive
RewriteCond :</p>
<pre class="prettyprint lang-config">RewriteCond "%{ENV:rewritten}" "=1"</pre>
<p>Notez que les variables d'environnement ne survivent pas à une
redirection externe. Vous devez alors utiliser le drapeau [CO] pour définir
un cookie. Pour les redirections de niveau répertoire et htaccess où la
substitution finale est traitée en tant que redirection interne, les
variables d'environnement du tour de réécriture précédent sont préfixées par
"REDIRECT_".</p>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/advanced.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/advanced.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/advanced.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/flags.html.fr.utf8 0000664 0001751 0001751 00000144167 14740503670 022010 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Les drapeaux de réécriture - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Les drapeaux de réécriture</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/flags.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/flags.html" title="Français"> fr </a></p>
</div>
<p>Ce document décrit les drapeaux disponibles dans la directive
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, en fournissant
des explications détaillées et des exemples.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_b">B (échappement dans les références arrières)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_bnp">BNP|backrefnoplus (ne pas échapper
l'espace en +)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_c">C|chain</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_co">CO|cookie</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_dpi">DPI|discardpath</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_e">E|env</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_end">END</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_f">F|forbidden</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_g">G|gone</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_h">H|handler</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_l">L|last</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_n">N|next</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_nc">NC|nocase</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_ne">NE|noescape</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_ns">NS|nosubreq</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_p">P|proxy</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_pt">PT|passthrough</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_qsa">QSA|qsappend</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_qsd">QSD|qsdiscard</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_qsl">QSL|qslast</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_r">R|redirect</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_s">S|skip</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_t">T|type</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_unsafe_allow_3f">UnsafeAllow3F</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_unsafe_prefix_stat">UnsafePrefixStat</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flag_unc">UNC</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection and remise en
correspondance</a></li><li><a href="access.html">Contrôle d'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Mise en cache</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</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="introduction" id="introduction">Introduction</a></h2>
<p>Le comportement d'une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> peut être modifié par un ou
plusieurs drapeaux. Les drapeaux sont situés en fin de règle, entourés
de crochets, et séparés le cas échéant par des virgules.</p>
<pre class="prettyprint lang-config">RewriteRule pattern target [Flag1,Flag2,Flag3]</pre>
<p>Chaque drapeau (à quelques exceptions près)
possède une forme courte, comme <code>CO</code>, ainsi qu'une forme longue,
comme <code>cookie</code>. Bien que
la forme courte soit la plus couramment utilisée, nous vous recommandons
de vous familiariser avec les drapeaux sous leur forme longue, afin de
bien mémoriser ce que chaque drapeau est supposé faire.
Certains drapeaux acceptent un ou plusieurs arguments. Les drapeaux ne
sont pas sensibles à la casse.</p>
<p>Les drapeaux qui modifient les métadonnées associées à la requête
(T=, H=, E=) n'ont aucun effet dans un contexte de répertoire ou de
fichier htaccess, lorsqu'une substitution (autre que '-') est effectuée
au cours de la même passe du processus de réécriture.
</p>
<p>Chaque drapeau disponible est présenté ici, avec un exemple
d'utilisation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_b" id="flag_b">B (échappement dans les références arrières)</a></h2>
<p>Avec le drapeau [B], la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> échappe les caractères
non-alphanumériques avant d'appliquer la transformation.</p>
<p><code>mod_rewrite</code> doit supprimer les séquences d'échappement
des URLs avant leur
mise en correspondance avec le système de fichiers ; les séquences
d'échappement sont donc supprimées des références arrières au moment où
ces dernières sont appliquées. Avec le drapeau B, les caractères
non-alphanumériques des références arrières seront échappés. Considérons
par exemple cette règle :</p>
<p>Pour un échappement similaire des variables du serveur, voir la <a href="#mapfunc">fonction de mappage</a> "escape".
</p>
<pre class="prettyprint lang-config">RewriteRule "^search/(.*)$" "/search.php?term=$1"</pre>
<p>Soit le terme de recherche 'x & y/z' ; un navigateur va le coder
en 'x%20%26%20y%2Fz', transformant la requête en
'search/x%20%26%20y%2Fz'. Sans le drapeau B, cette règle de réécriture
va réécrire la requête en 'search.php?term=x & y/z', ce qui ne
correspond pas à une URL valide et cette dernière sera encodée en
<code>search.php?term=x%20&y%2Fz=</code>, ce qui ne correspond pas à
ce que l'on souhaitait.</p>
<p>Avec le drapeau B, les paramètres sont réencodés avant d'être passés
à l'URL résultante, ce qui fournit une réécriture correcte en
<code>/search.php?term=x%20%26%20y%2Fz</code>.</p>
<pre class="prettyprint lang-config">RewriteRule "^search/(.*)$" "/search.php?term=$1" [B,PT]</pre>
<p>Notez que vous devrez peut-être aussi définir la
directive <code class="directive"><a href="../mod/core.html#allowencodedslashes">AllowEncodedSlashes</a></code>
à <code>On</code> pour
que cet exemple particulier fonctionne, car httpd ne permet pas les
slashes encodés dans les URLs, et renvoie une erreur 404 s'il en
rencontre un.</p>
<p>Ce processus d'échappement est en particulier nécessaire dans le
contexte d'un mandataire, où l'accès au serveur d'arrière-plan échouera
si on présente à ce dernier une URL non échappée.</p>
<p>Une alternative à ce drapeau consiste à utiliser une directive
<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> pour capturer
%{THE_REQUEST}, les chaînes capturées se présentant
alors sous la forme codée.</p>
<p>A partir
de la version 2.4.26, vous pouvez limiter l'échappement dans les
références arrières à une liste de caractères que vous pouvez spécifiez comme
dans cet exemple : <code>[B=#?;]</code>. Notez que l'espace peut faire
partie de la liste des caractères à échapper, mais que vous devez mettre entre
guillemets le troisième argument de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> et que l'espace ne doit pas
être le dernier caractère de cette liste.
</p>
<pre class="prettyprint lang-config"># Échappement des espaces et des points d'interrogation. Les guillemets autour
# du dernier argument sont obligatoires lorsque l'espace est inclus.
RewriteRule "^search/(.*)$" "/search.php?term=$1" "[B= ?]"</pre>
<p>Pour définir la liste des caractères à échapper de cette manière, voir <a href="#flag_bne">#flag_bne</a> et <a href="#flag_bctls">#flag_bctls</a></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_bnp" id="flag_bnp">BNP|backrefnoplus (ne pas échapper
l'espace en +)</a></h2>
<p>Si le drapeau [BNP] est spécifié, la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> échappera le caractère
espace en %20 au lieu de '+' dans les références arrières. Ceci s'avère
utile lorsque la référence arrière est utilisée dans la partie chemin,
et non dans les paramètres de la requête.</p>
<pre class="prettyprint lang-config"># Échappe le caractère espace en %20 dans le chemin au lieu de + comme dans la
# soumission de formulaire à l'aide de la chaîne de paramètres
RewriteRule "^search/(.*)$" "/search.php/$1" "[B,BNP]"</pre>
<p>Ce drapeau est disponible à partir de la version 2.4.26 du serveur HTTP
Apache.</p>
<h3><a name="flag_bctls" id="flag_bctls">BCTLS</a></h3>
<p>Le drapeau [BCTLS] est similaire à [B], à la différence que seuls les espaces
et les caractères de contrôle sont échappés. Il s'agit du même jeu de caractères
rejetés lorsqu'ils sont copiés dans la chaîne de paramètres non codée.
</p>
<pre class="prettyprint lang-config"># Échappe les espaces et les caractères de contrôle
RewriteRule "^search/(.*)$" "/search.php/$1" "[BCTLS]"</pre>
<p>Ce drapeau est disponible à partir de la version 2.4.57 du serveur HTTP
Apache.</p>
<h3><a name="flag_bne" id="flag_bne">BNE</a></h3>
<p>Les caractères listés dans [BNE=...] sont exclus des listes de caractères
correspondant aux drapeaux [B] ou [BCTLS]. Ils ne seront donc pas échappés.
</p>
<pre class="prettyprint lang-config"># Échappe les caractères par défaut, sauf /
RewriteRule "^search/(.*)$" "/search.php?term=$1" "[B,BNE=/]"</pre>
<p>Ce drapeau est disponible à partir de la version 2.4.57 du serveur HTTP
Apache.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_c" id="flag_c">C|chain</a></h2>
<p>Le drapeau [C] ou [chain] indique que la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est chaînée avec la
suivante. Autrement dit, si la règle s'applique, elle est traitée
normalement et passe le contrôle à la règle suivante. Par contre, si
elle ne s'applique pas, la règle suivante, ainsi que toutes les règles
chaînées qui suivent, seront sautées.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_co" id="flag_co">CO|cookie</a></h2>
<p>Le drapeau [CO], ou [cookie], vous permet de définir un cookie
lorsqu'une règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
s'applique. Il possède trois arguments obligatoires et
cinq arguments optionnels.</p>
<p>La syntaxe complète de ce drapeau, avec tous ses attributs, est la
suivante :</p>
<div class="example"><p><code>
[CO=NAME:VALUE:DOMAIN:lifetime:path:secure:httponly:samesite]
</code></p></div>
<p>Si un caractère littéral ':' doit être insérer dans un des champs du
cookie, une autre syntaxe est disponible. Pour utiliser cette syntaxe
alternative, le contenu du champ "Name" doit être précédé du caractère
';', et les sépateurs de champs deviendront des ';'.</p>
<div class="example"><p><code>
[CO=;NAME;VALUE:MOREVALUE;DOMAIN;lifetime;path;secure;httponly;samesite]
</code></p></div>
<p>Vous devez déclarer un nom, une valeur et un domaine pour que
le cookie puisse être défini.</p>
<dl>
<dt>Domain</dt>
<dd>Le domaine pour lequel vous souhaitez que le cookie soit valide. Ce
peut être un nom de serveur, comme <code>www.example.com</code>, ou un
domaine, comme <code>.example.com</code>. Il doit comporter au moins
deux parties séparées par un point. C'est à dire que vous ne pouvez pas
utiliser les valeurs <code>.com</code> ou <code>.net</code>. En effet,
ce style de cookie est interdit par le modèle de sécurité des cookies.</dd>
</dl>
<p>Vous pouvez aussi définir les valeurs suivantes :</p>
<dl>
<dt>Lifetime</dt>
<dd>La durée de vie du cookie, en minutes.</dd>
<dd>Une valeur de 0 indique une durée de vie correspondant à la session
courante du navigateur. Il s'agit de la valeur par défaut.</dd>
<dt>Path</dt>
<dd>Le chemin, sur le site web concerné, pour lequel le cookie est
valide, du style <code>/clients/</code> or
<code>/fichiers/telechargement/</code>.</dd>
<dd>La valeur par défaut est <code>/</code> - c'est à dire l'ensemble du
site web.</dd>
<dt>Secure</dt>
<dd>Si cet argument a pour valeur <code>secure</code>,
<code>true</code>, ou <code>1</code>, le cookie ne pourra être transmis
que dans le cadre d'une connexion sécurisée (https).</dd>
<dt>httponly</dt>
<dd>Si cet argument a pour valeur <code>HttpOnly</code>,
<code>true</code>, ou <code>1</code>, le cookie aura son drapeau
<code>HttpOnly</code> activé, ce qui signifie qu'il sera inaccessible au
code JavaScript pour les navigateurs qui supportent cette
fonctionnalité.</dd>
<dt>samesite</dt>
<dd>S'il est différent de <code>false</code> ou <code>0</code>, l'attribut
<code>SameSite</code> est défini à la valeur spécifiée. Les valeurs typiques
sont <code>None</code>, <code>Lax</code> et <code>Strict</code>. Disponible à
partir de la version 2.4.47 du serveur HTTP Apache.</dd>
</dl>
<p>Voici un exemple :</p>
<pre class="prettyprint lang-config">RewriteEngine On
RewriteRule "^/index\.html" "-" [CO=frontdoor:yes:.example.com:1440:/]</pre>
<p>Dans l'exemple ci-dessus, la règle ne réécrit
pas la requête. La cible de réécriture "-"
indique à mod_rewrite de transmettre la requête sans
modification. Par contre, il
définit un cookie nommé 'frontdoor' avec une valeur 'yes'. Le cookie est
valide pour tout hôte situé dans le domaine <code>.example.org</code>. Sa
durée de vie est limitée à 1440 minutes (24 heures), et il sera renvoyé
pour tous les URIs.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_dpi" id="flag_dpi">DPI|discardpath</a></h2>
<p>Avec le drapeau DPI, la partie PATH_INFO de l'URI
réécrit est supprimée.</p>
<p>Ce drapeau est disponible dans les versions 2.2.12 et supérieures.</p>
<p>Dans un contexte de répertoire, l'URI mis en comparaison par chaque
règle <code class="directive">RewriteRule</code> est la concaténation des
valeurs courantes de l'URI et de PATH_INFO.</p>
<p>L'URI courant peut être l'URI initial tel qu'il a été fourni par le
client, le résultat d'une passe précédente du processus de réécriture,
ou le résultat de la règle précédente dans le processus courant de
réécriture.</p>
<p>Par contre, la partie PATH_INFO ajoutée à l'URI avant chaque règle ne
reflète que la valeur de PATH_INFO avant la passe courante du processus
de réécriture. En conséquence, si de larges portions de l'URI
correspondent et sont traduites via plusieurs directives
<code class="directive">RewriteRule</code>, sans prendre en compte
quelles parties de l'URI provenaient du PATH_INFO courant, l'URI final
pourra se voir ajouter plusieurs copies de PATH_INFO.</p>
<p>Utilisez ce drapeau pour toute substitution où la présence du PATH_INFO qui
résultait de la mise en correspondance précédente de cette requête avec
le système de fichier n'est pas nécessaire. Avec ce drapeau, le
PATH_INFO établi avant que cette passe du processus de réécriture ne
débute est oublié. PATH_INFO ne sera pas recalculé tant que la passe
courante du processus de réécriture ne sera pas achevée. Les règles
suivantes de cette passe ne verront que le résultat direct des
substitutions, sans aucun PATH_INFO ajouté.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_e" id="flag_e">E|env</a></h2>
<p>Avec le drapeau [E], ou [env], vous pouvez définir la valeur d'une
variable d'environnement. Notez que certaines variables d'environnement
peuvent être définies après le traitement de la règle, annulant par
la-même ce que vous avez défini. Voir le <a href="../env.html">document
sur les variables d'environnement</a> pour plus de détails sur le
fonctionnement des variables d'environnement.</p>
<p>La syntaxe complète pour ce drapeau est :</p>
<pre class="prettyprint lang-config">[E=!VAR]</pre>
<p><code>VAL</code> peut comporter des références arrières
(<code>$N</code> ou <code>%N</code>) qui seront développées.</p>
<p>En utilisant la version courte</p>
<div class="example"><p><code>
[E=VAR]
</code></p></div>
<p>vous pouvez définir la variable d'environnement nommée
<code>VAR</code> avec une valeur vide.</p>
<p>La forme</p>
<div class="example"><p><code>
[E=!VAR]
</code></p></div>
<p>permet d'annuler la définition de la variable <code>VAR</code>.</p>
<p>Les variables d'environnement s'emploient dans différents contextes,
comme les programmes CGI, d'autres directives RewriteRule, ou des
directives CustomLog.</p>
<p>L'exemple suivant définit une variable d'environnement nommée 'image'
avec une valeur de '1' si l'URI de la requête correspond à un fichier
image. Cette variable d'environnement est ensuite utilisée pour exclure
une telle requête du journal des accès.</p>
<pre class="prettyprint lang-config">RewriteRule "\.(png|gif|jpg)$" "-" [E=image:1]
CustomLog "logs/access_log" combined env=!image</pre>
<p>Notez que le même effet peut être obtenu à l'aide de la directive
<code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>. Cette technique
est présentée à titre d'exemple et non de recommandation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_end" id="flag_end">END</a></h2>
<p>L'utilisation du drapeau [END] permet non seulement de terminer le
processus de réécriture en cours (comme [L]), mais aussi d'empêcher tout
processus de réécriture ultérieur dans un contexte de répertoire
(htaccess).</p>
<p>Ceci ne s'applique pas aux nouvelles requêtes résultant d'une
redirection externe.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_f" id="flag_f">F|forbidden</a></h2>
<p>L'utilisation du drapeau [F] permet de faire envoyer par le serveur au
client un code de statut "403 Forbidden". Le même effet peut être obtenu à
l'aide de la directive <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code>,
mais ce drapeau offre plus de souplesse dans l'attribution d'un statut
Forbidden.</p>
<p>La règle suivante va interdire la téléchargement de fichiers
<code>.exe</code> depuis votre serveur.</p>
<pre class="prettyprint lang-config">RewriteRule "\.exe" "-" [F]</pre>
<p>Cet exemple utilise la syntaxe "-" pour la cible de réécriture, ce
qui signifie que l'URI de la requête n'est pas modifié. Il n'y a aucune
raison de réécrire un URI, si vous avez l'intention d'interdire la
requête.</p>
<p>Lorsqu'on utilise [F], [L] est implicite - c'est à dire que la
réponse est renvoyée immédiatement, et aucune autre règle n'est évaluée.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_g" id="flag_g">G|gone</a></h2>
<p>Le drapeau [G] permet de faire envoyer par le serveur un code de statut
"410 Gone" avec la réponse. Ce code indique qu'une ressource qui était
disponible auparavant ne l'est plus actuellement.</p>
<p>Comme dans le cas du drapeau [F], on utilise en général la syntaxe
"-" pour la cible de réécriture lorsqu'on utilise le drapeau [G] :</p>
<pre class="prettyprint lang-config">RewriteRule "oldproduct" "-" [G,NC]</pre>
<p>Lorsqu'on utilise [G], [L] est implicite - c'est à dire que la
réponse est renvoyée immédiatement, et aucune autre règle n'est évaluée.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_h" id="flag_h">H|handler</a></h2>
<p>Force le traitement de la requête résultante par le gestionnaire
spécifié. Par exemple, on peut utiliser ce drapeau pour forcer
l'interprétation de tous les fichiers sans extension par le gestionnaire
php :</p>
<pre class="prettyprint lang-config">RewriteRule "!\." "-" [H=application/x-httpd-php]</pre>
<p>
L'expression rationnelle ci-dessus - <code>!\.</code> - correspond à
toute requête qui ne contient pas le caractère <code>.</code>.
</p>
<p>On peut aussi utiliser ce drapeau pour forcer l'utilisation d'un
certain gestionnaire en fonction de certaines conditions. Par exemple,
l'extrait suivant utilisé dans un contexte de niveau serveur permet de
faire en sorte que les fichiers <code>.php</code> soient
<em>affichés</em> par <code>mod_php</code> dans le cas où ils font
l'objet d'une requête avec l'extension <code>.phps</code> :</p>
<pre class="prettyprint lang-config">RewriteRule "^(/source/.+\.php)s$" "$1" [H=application/x-httpd-php-source]</pre>
<p>L'expression rationnelle ci-dessus -
<code>^(/source/.+\.php)s$</code> - va correspondre à toute requête qui
débutera par <code>/source/</code>, continuera par 1 ou n caractères
puis par <code>.phps</code>. La référence arrière $1 fait référence à la
correspondance capturée entre parenthèses de l'expression
rationnelle.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_l" id="flag_l">L|last</a></h2>
<p>Lorsque le drapeau [L] est présent, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
arrête le traitement du jeu de règles. Cela signifie dans la plupart des
situations que si la règle s'applique, aucune autre règle ne sera
traitée. Ce drapeau correspond à la commande Perl <code>last</code>, ou
à la commande <code>break</code> en C. Utilisez ce drapeau pour indiquer
que la règle courante doit être appliquée immédiatement, sans tenir
compte des règles ultérieures.</p>
<p>Si vous utilisez des règles <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> dans des fichiers
<code>.htaccess</code> ou des sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, il est important d'avoir quelques
notions sur la manière dont les règles sont traitées. Pour simplifier,
une fois les règles traitées, la requête réécrite est passée à nouveau
au moteur d'interprétation des URLs afin que ce dernier puisse la
traiter. Il est possible qu'au cours du traitement de la requête
réécrite, le fichier <code>.htaccess</code> ou la section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> soient à nouveau
rencontrés, entraînant un nouveau traitement du jeu de règles depuis le
début. Cette situation se présente le plus souvent lorsqu'une des règles
provoque une redirection - interne ou externe - ce qui réinitialise le
traitement de la requête.</p>
<p>Si vous utilisez des directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> dans un de ces contextes,
il importe par conséquent de prévoir explicitement des étapes permettant
d'éviter un bouclage infini sur les règles,
et de ne pas compter seulement sur
le drapeau [L] pour terminer l'exécution d'une série de règles, comme
décrit ci-dessous.</p>
<p>Un autre drapeau, [END], permet non seulement d'interrompre le cycle
courant du processus de réécriture, mais aussi d'empêcher toute
réécriture ultérieure dans le contexte de répertoire (htaccess). Ceci ne
s'applique pas aux nouvelles requêtes résultant de redirections
externes.</p>
<p>Dans l'exemple donné ici, toute requête est réécrite en
<code>index.php</code>, la requête originale étant ajoutée comme chaîne
de requête en argument à <code>index.php</code> ; cependant, la
directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> permet de s'assurer que si
la requête concerne déjà <code>index.php</code>, la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> sera sautée.</p>
<pre class="prettyprint lang-config">RewriteBase "/"
RewriteCond "%{REQUEST_URI}" !=/index.php
RewriteRule "^(.*)" "/index.php?req=$1" [L,PT]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_n" id="flag_n">N|next</a></h2>
<p>Le drapeau [N] provoque un redémarrage du traitement des règles
depuis le début, en utilisant le résultat du jeu de règles, sous
réserve qu'il existe un point de démarrage ; à utiliser avec précautions
car il peut provoquer un bouclage infini.
</p>
<p>
Le drapeau [Next] peut servir, par exemple,
à remplacer de manière répétitive
une chaîne de caractère ou une lettre dans une requête. Dans l'exemple
suivant, chaque occurence de A sera remplacée par B dans la requête, et
ceci jusqu'il n'y ait plus de A à remplacer.
</p>
<pre class="prettyprint lang-config">RewriteRule "(.*)A(.*)" "$1B$2" [N]</pre>
<p>Vous pouvez vous représenter ce traitement comme une boucle
<code>while</code> : tant que le modèle de la règle correspond (c'est à
dire, tant que l'URI contient un <code>A</code>),
effectuer la substitution (c'est à dire, remplacer le <code>A</code> par
un <code>B</code>).</p>
<p>A partir de la version 2.4.8, ce module renvoie une erreur après
10000 itérations afin d'éviter les boucles infinies. Ce nombre maximum
d'itération peut être modifié via le drapeau N.</p>
<pre class="prettyprint lang-config"># On veut remplacer 1 caractère à chaque itération de la boucle
RewriteRule "(.+)[><;]$" "$1" [N=32000]
# ... ou s'arrêter après 10 itérations
RewriteRule "(.+)[><;]$" "$1" [N=10]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_nc" id="flag_nc">NC|nocase</a></h2>
<p>Avec le drapeau [NC], le modèle de la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est comparé à la requête de
manière insensible à la casse. C'est à dire que cette comparaison
s'effectue sans tenir compte des majuscules/minuscules dans l'URI
comparé.</p>
<p>Dans l'exemple suivant, toute requête pour un fichier image sera
transmise par Apache à votre serveur d'images dédié. La correspondance est
insensible à la casse, si bien que par exemple, <code>.jpg</code> aussi
bien que <code>.JPG</code> seront acceptés.</p>
<pre class="prettyprint lang-config">RewriteRule "(.*\.(jpg|gif|png))$" "http://images.example.com$1" [P,NC]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_ne" id="flag_ne">NE|noescape</a></h2>
<p>Par défaut, les caractères spéciaux, comme <code>&</code> et
<code>?</code>, sont convertis en leur équivalent hexadécimal pour les règles
qui génèrent des redirections externes. Le drapeau [NE] permet d'éviter cette
conversion.</p>
<pre class="prettyprint lang-config">RewriteRule "^/anchor/(.+)" "/bigpage.html#$1" [NE,R]</pre>
<p>
Dans l'exemple ci-dessus, <code>/anchor/xyz</code> est réécrit en
<code>/bigpage.html#xyz</code>. En l'absence du drapeau [NE], le #
aurait été converti en son équivalent hexadécimal, <code>%23</code>, ce
qui aurait provoqué un code d'erreur "404 Not Found".
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_ns" id="flag_ns">NS|nosubreq</a></h2>
<p>Le drapeau [NS] empêche la règle de s'appliquer aux sous-requêtes.
Par exemple, une page incluse au moyen d'une SSI (Server
Side Include) est une sous-requête, et vous ne voudrez probablement pas que
la réécriture s'applique à ces sous-requêtes. Ainsi, lorsque
<code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> recherche des informations à propos des
fichiers par défaut du répertoire (comme les fichiers
<code>index.html</code>), il s'agit d'une sous-requête interne, et vous
ne désirez en général pas que ces sous-requêtes soient réécrites. Cette
réécriture
n'est pas toujours utile pour les sous-requêtes, et peut même causer des
erreurs si l'ensemble du jeu de règles est appliqué. L'utilisation de
ce drapeau permet d'exclure les règles qui peuvent poser problème.</p>
<p>Comment déterminer si vous devez utiliser cette règle ou non : si
vous préfixez les URLs avec des scripts CGI, afin de forcer leur
traitement par le script CGI, vous vous exposez à des problèmes (ou du
moins à une surcharge significative) avec les sous-requêtes. Dans ces
cas, vous devez utiliser ce drapeau.</p>
<p>
Les images, scripts java, ou fichiers css, chargés en tant que partie
d'une page html, ne sont pas des sous-requêtes - le navigateur les
appelle sous forme de requêtes HTTP à part entière.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_p" id="flag_p">P|proxy</a></h2>
<p>L'utilisation du drapeau [P] entraîne le traitement de la requête par
le module <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, et ceci via une requête de
mandataire. Par exemple, si vous voulez que toutes les requêtes d'images
soient traitées par un serveur d'images annexe, vous pouvez utiliser
une règle de ce style :</p>
<pre class="prettyprint lang-config">RewriteRule "/(.*)\.(jpg|gif|png)$" "http://images.example.com/$1.$2" [P]</pre>
<p>L'utilisation du drapeau [P] provoque aussi l'effet du drapeau [L] -
autrement dit, la requête est immédiatement envoyée au mandataire, et
toute règle ultérieure sera ignorée.</p>
<p>
Vous devez vous assurer que la chaîne de substitution soit un URI valide
(commençant typiquement par <code>http://</code><em>nom-serveur</em>)
qui puisse être traitée par le module <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. Dans
le cas contraire, le module mandataire vous renverra une erreur.
L'utilisation de ce drapeau implémente de manière plus puissante la
directive <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>, pour
faire correspondre le contenu distant à l'espace de nommage du serveur
local.</p>
<div class="warning">
<h3>Avertissement à propos de la sécurité</h3>
<p>Lors de la construction de l'URL cible de la règle, il convient
de prendre en compte l'impact en matière de sécurité qu'aura le
fait de permettre au client d'influencer le jeu d'URLs pour
lesquelles votre serveur agira en tant que mandataire.
Assurez-vous que la partie protocole://nom-serveur de l'URL soit
fixe, ou ne permette pas au client de l'influencer induement.</p>
</div>
<div class="warning">
<h3>Avertissement au sujet des performances</h3>
<p>Utiliser ce drapeau fait intervenir <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> sans la
gestion des connexions persistantes car dans ce cas, c'est le worker par
défaut qui est utilisé, et ce dernier ne gère pas la mise en commun et la
réutilisation des connexions.</p>
<p>Pour utiliser les connexions persistantes, vous devez définir un bloc
<code class="directive"><a href="../mod/mod_proxy.html#proxy">Proxy</a></code>, au moins pour les parties
protocole et hôte de l'URL cible, et contenant une directive <code class="directive"><a href="../mod/mod_proxy.html#proxyset">ProxySet</a></code> où vous définissez par exemple un
délai.</p>
<p>Si vous le définissez avec une directive <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> ou <code class="directive"><a href="../mod/mod_proxy.html#proxypassmatch">ProxyPassMatch</a></code>, les connexions persistantes
seront automatiquement utilisées.</p>
</div>
<p>Note: <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> doit être activé pour pouvoir
utiliser ce drapeau.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_pt" id="flag_pt">PT|passthrough</a></h2>
<p>
Par défaut, la cible (ou chaîne de substitution) d'une règle
RewriteRule est sensée être un chemin de fichier. Avec le drapeau [PT],
par contre, elle est traitée comme un URI. Autrement dit, avec le
drapeau [PT], le résultat de la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est passé à nouveau au
système de mise en correspondance des URLs avec le système de fichiers,
de façon à ce que les systèmes de mise en correspondance basés sur les
chemins de fichiers, comme la directive <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code>, ou <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>, par exemple, puissent avoir une
chance d'accomplir leur tâche.
</p>
<p>
Si par exemple, vous avez un <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> pour /icons, et une règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> qui renvoie vers /icons,
vous devez utiliser le drapeau [PT] pour être sûr que l'<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> sera bien évalué.
</p>
<pre class="prettyprint lang-config">Alias "/icons" "/usr/local/apache/icons"
RewriteRule "/pics/(.+)\.jpg$" "/icons/$1.gif" [PT]</pre>
<p>
Dans l'exemple précédent, en l'absence du drapeau [PT], l'Alias aurait
été ignoré, ce qui aurait provoqué une erreur 'File not found'.
</p>
<p>Avec le drapeau <code>PT</code>, le drapeau <code>L</code> est
implicite : la réécriture s'arrêtera afin de transmettre la requête à la
phase suivante du traitement.</p>
<p>Notez que le drapeau <code>PT</code> est implicite dans des contextes
de répertoire comme les sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou les fichiers
<code>.htaccess</code>. Le seul moyen de contourner ceci consiste à
réécrire vers <code>-</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_qsa" id="flag_qsa">QSA|qsappend</a></h2>
<p>
Quand l'URI de remplacement contient une chaîne de requête, le
comportement par défaut de la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est de supprimer la <code>
query string</code> (il s'agit des paramètres éventuellement passés dans l'URL après le
caractère <code>?</code>, usuellement pour les formulaires traités par la
méthode HTTP <code>GET</code>) existante, et de la remplacer par celle nouvellement créée.
Avec le drapeau [QSA], les chaînes de requête peuvent être combinées.
</p>
<p>Considérons la règle suivante :</p>
<pre class="prettyprint lang-config">RewriteRule "/pages/(.+)" "/page.php?page=$1" [QSA]</pre>
<p>Avec le drapeau [QSA], une requête pour
<code>/pages/123?one=two</code> sera réécrite en
<code>/page.php?page=123&one=two</code>. Sans le drapeau [QSA], la
même requête sera réécrite en <code>/page.php?page=123</code> -
autrement dit, la chaîne de requête (<code>query string</code>) existante sera supprimée.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_qsd" id="flag_qsd">QSD|qsdiscard</a></h2>
<p>
Lorsque l'URI de la requête contient une chaîne de paramètres, et si
l'URI cible n'en contient pas, le comportement par défaut de la
directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> consiste à copier cette
chaîne de paramètres dans l'URI cible. Avec le drapeau [QSD], la chaîne
de paramètres est supprimée.
</p>
<p>Ce drapeau est disponible dans les versions 2.4.0 et supérieures.</p>
<p>
Lorsque les drapeaux [QSD] et [QSA] sont utilisés ensemble, c'est le
drapeau [QSD] qui l'emporte.
</p>
<p>
Si l'URI cible possède une chaîne de paramètres, le comportement par
défaut sera respecté - c'est à dire que la chaîne de paramètres
originale sera supprimée et remplacée par la chaîne de paramètres de
l'URI cible.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_qsl" id="flag_qsl">QSL|qslast</a></h2>
<p>
Par défaut, le premier (le plus à gauche) point d'interrogation de la
substitution sépare le chemin de la requête de sa chaîne de paramètres. Avec le
drapeau [QSL] au contraire, les deux composants seront séparés en utilisant le
dernier (le plus à droite) point d'interrogation.</p>
<p>
Cela peut s'avérer utile lorsqu'on recherche un fichier dont le nom contient des
points d'interrogation. Si aucune chaîne de paramètre n'est présente dans la
substitution, il est alors possible d'ajouter un point d'interrogation à la fin
et d'utiliser ce drapeau.</p>
<p>Ce drapeau est disponible à partir de la version 2.4.19 du serveur HTTP
Apache.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_r" id="flag_r">R|redirect</a></h2>
<p>
L'utilisation du drapeau [R] provoque l'envoi d'une redirection au
navigateur. Si une URL pleinement qualifiée (FQDN - fully qualified domain name)
est spécifiée (c'est à dire incluant <code>http://nom-du-serveur/</code>),
une redirection sera effectuée vers cette adresse. Dans le cas contraire,
le protocole courant, le nom du serveur et le numéro de port seront
utilisés pour générer l'URL envoyée avec la redirection.
</p>
<p><em>Tout</em> code de statut de réponse HTTP valide peut être
spécifié, en utilisant la syntaxe [R=305], le code de statut 302 étant
utilisé par défaut si aucun code n'est spécifié. Le code de statut
spécifié n'est pas nécessairement un code de statut
de redirection (3xx). Cependant, si le code de statut est en dehors de la plage des codes de
redirection (300-399), la chaîne de substitution est entièrement
supprimée, et la réécriture s'arrête comme si le drapeau <code>L</code>
était utilisé.</p>
<p>En plus des codes de statut de réponse, vous pouvez spécifier les
codes de redirection en utilisant leurs noms symboliques :
<code>temp</code> (défaut), <code>permanent</code>, ou
<code>seeother</code>.</p>
<p>
Vous utiliserez presque toujours [R] en conjonction avec [L] (c'est à
dire [R,L]), car employé seul, le drapeau [R] préfixe l'URI avec
<code>http://cet-hôte[:ce-port]</code>, mais passe ensuite cette adresse
à la règle suivante, ce qui provoquera le plus souvent des
avertissements 'Invalid URI in request'.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_s" id="flag_s">S|skip</a></h2>
<p>Le drapeau [S] sert à sauter des règles que vous ne voulez pas voir
exécuter. La syntaxe du drapeau [S] est [S=<em>N</em>], où
<em>N</em> correspond au nombre de règles à sauter (sous
réserve que la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> corresponde et qu'au moins
une condition <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
préalable soit vérifiée).
Ceci peut s'interpréter comme une instruction
<code>goto</code> dans votre jeu de règles de réécriture. Dans
l'exemple suivant, nous ne voulons exécuter la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> que si l'URI demandé ne
correspond pas à un fichier existant.</p>
<pre class="prettyprint lang-config"># La requête concerne-t-elle un fichier qui n'existe pas ?
RewriteCond "%{REQUEST_FILENAME}" !-f
RewriteCond "%{REQUEST_FILENAME}" !-d
# Si c'est la cas, on saute les deux règles de réécriture suivantes
RewriteRule ".?" "-" [S=2]
RewriteRule "(.*\.gif)" "images.php?$1"
RewriteRule "(.*\.html)" "docs.php?$1"</pre>
<p>Cette technique trouve son utilité dans le fait qu'une directive
<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> ne s'applique
qu'à la règle qui la suit immédiatement. Ainsi, si vous voulez
qu'une directive <code>RewriteCond</code> s'applique à plusieurs règles
<code>RewriteRule</code>, une technique possible consiste à inverser ces
conditions et ajouter une <code>RewriteRule</code> avec le drapeau [Skip]. Cette technique permet
d'élaborer des pseudo-constructions if-then-else : la dernière règle du
bloc then contiendra <code>skip=N</code>, où N est le nombre de règles
contenues dans le bloc else :</p>
<pre class="prettyprint lang-config"># Est-ce que le fichier existe ?
RewriteCond "%{REQUEST_FILENAME}" !-f
RewriteCond "%{REQUEST_FILENAME}" !-d
# Créer une structure conditionnelle if-then-else en sautant 3 lignes si nous
# avions l'intention d'aller au bloc "else".
RewriteRule ".?" "-" [S=3]
# Si le fichier existe, alors :
RewriteRule "(.*\.gif)" "images.php?$1"
RewriteRule "(.*\.html)" "docs.php?$1"
# Passer le bloc "else".
RewriteRule ".?" "-" [S=1]
# ELSE...
RewriteRule "(.*)" "404.php?file=$1"
# END</pre>
<p>Il est probablement plus aisé de définir ce genre de configuration
via les directives <code class="directive"><If></code>, <code class="directive"><ElseIf></code>, et <code class="directive"><Else></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_t" id="flag_t">T|type</a></h2>
<p>Définit le type MIME de la réponse résultante renvoyée. L'effet est
identique à celui de la directive <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code>.</p>
<p>Par exemple, vous pouvez utiliser la technique suivante pour servir
du code source Perl en tant que plein texte, s'il est requis d'une
certaine manière :</p>
<pre class="prettyprint lang-config"># Sert les fichier .pl en tant que plein texte
RewriteRule "\.pl$" "-" [T=text/plain]</pre>
<p>Ou encore, si vous possédez une caméra qui produit des fichiers
images jpeg sans extension, vous pouvez forcer le renvoi de ces images
avec le type MIME correct en se basant sur le nom du fichier :</p>
<pre class="prettyprint lang-config"># Les fichiers dont le nom contient 'IMG' sont des images jpg.
RewriteRule "IMG" "-" [T=image/jpg]</pre>
<p>Notez cependant qu'il s'agit d'un exemple trivial, et que le problème
aurait pu être résolu en utilisant à la place la directive <code class="directive"><a href="../mod/core.html#filesmatch"><FilesMatch></a></code>. Il faut toujours
envisager la possibilité d'une solution alternative à un problème avant
d'avoir recours à la réécriture, qui sera toujours moins efficace qu'une
solution alternative.</p>
<p>
Dans un contexte de niveau répertoire, n'utilisez que <code>-</code>
(tiret) comme substitution, <em>dans toute la séquence de réécriture de
mod_rewrite</em>, sinon le type MIME défini avec ce drapeau
sera perdu suite à un retraitement interne (y compris les séquences de
réécriture suivantes de mod_rewrite). Dans ce contexte, vous pouvez
utiliser le drapeau <code>L</code> pour terminer la séquence
<em>courante</em> de réécriture de mod_rewrite.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_unsafe_allow_3f" id="flag_unsafe_allow_3f">UnsafeAllow3F</a></h2>
<p>Il est nécessaire de définir ce drapeau pour permettre à une réécriture
de continuer si la requête HTTP en cours d’écriture possède un point d'interrogation encodé, « %3f », et si le résultat réécrit contient un « ? » dans
la substitution. Cela protège d’une URL malveillante tirant avantage d’une
capture et d’une resubstitution du point d'interrogation encodé.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_unsafe_prefix_stat" id="flag_unsafe_prefix_stat">UnsafePrefixStat</a></h2>
<p>La définition de ce drapeau est requise dans les substitutions à
l'échelle du serveur qui commencent par une variable ou une référence
arrière et se résolvent en un chemin du système de fichiers. Ces
substitutions ne sont pas préfixées par la racine des documents. Cela protège
d’une URL malveillante faisant correspondre la substitution expansée à un
emplacement non souhaité du système de fichiers.</p>
<p>Disponible à partir de la version 2.4.60 du serveur HTTP Apache.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flag_unc" id="flag_unc">UNC</a></h2>
<p>Définir ce drapeau empêche la fusion des slashes de début multiples tels
que ceux utilisés dans les chemins UNC de Windows. Ce drapeau n’est pas
nécessaire lorsque la substitution de la règle commence par des slashes
multiples littéraux.</p>
<p>Disponible à partir de la version 2.4.62 du serveur HTTP Apache.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/flags.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/flags.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/flags.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/proxy.html.fr.utf8 0000664 0001751 0001751 00000017471 14740503670 022072 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Utilisation de mod_rewrite comme mandataire - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Utilisation de mod_rewrite comme mandataire</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/proxy.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/proxy.html" title="Français"> fr </a></p>
</div>
<p>Ce document est un complément de la <a href="../mod/mod_rewrite.html">documentation de référence</a> du module
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il décrit comment utiliser le drapeau [P]
de la directive RewriteRule pour mandater un contenu vers un autre
serveur. Plusieurs recettes décrivant des scénarios courants sont
fournies.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en
correspondance</a></li><li><a href="access.html">Contrôle d'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</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="dynamic-proxy" id="dynamic-proxy">Mandater du contenu avec mod_rewrite</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>
mod_rewrite implémente le drapeau [P] qui permet de passer des URLs,
via mod_proxy, à un autre serveur. Deux exemples sont fournis ici.
Dans le premier, une URL est passée directement à un autre serveur,
et servie comme si c'était une URL locale. Dans le deuxième, nous
mandatons un contenu manquant vers un serveur d'arrière-plan.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>Pour passer une URL à un autre serveur, on utilise le drapeau
[P] comme suit :</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteBase "/produits/"
RewriteRule "^widget/(.*)$" "http://produits.example.com/widget/$1" [P]
ProxyPassReverse "/produits/objet/" "http://produits.example.com/objet/"</pre>
<p>Dans le deuxième exemple, nous ne mandatons la requête que si nous
ne trouvons pas la ressource localement. Ceci peut s'avérer très
utile lorsque vous effectuez une migration d'un serveur vers un
autre, et que vous n'êtes pas certain que tout le contenu a déjà été
migré.</p>
<pre class="prettyprint lang-config">RewriteCond "%{REQUEST_FILENAME}" !-f
RewriteCond "%{REQUEST_FILENAME}" !-d
RewriteRule "^/(.*)" "http://ancien.exemple.com/$1" [P]
ProxyPassReverse "/" "http://ancien.exemple.com/"</pre>
</dd>
<dt>Discussion :</dt>
<dd><p>Dans les deux cas, on ajoute une directive <code class="directive"><a href="../mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> afin de s'assurer
que toute redirection en provenance du serveur d'arrière-plan est
renvoyée correctement au client.</p>
<p>Chaque fois que cela est possible, préférez l'utilisation de la
directive <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> ou
<code class="directive"><a href="../mod/mod_proxy.html#proxypassmatch">ProxyPassMatch</a></code> à
mod_rewrite.</p>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/proxy.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/proxy.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/proxy.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/vhosts.html.fr.utf8 0000664 0001751 0001751 00000032314 14740503670 022230 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Hébergement virtuel de masse avec mod_rewrite - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Hébergement virtuel de masse avec mod_rewrite</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/vhosts.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/vhosts.html" title="Français"> fr </a></p>
</div>
<p>Ce document est un complément à la <a href="../mod/mod_rewrite.html">documentation de référence</a> du module
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il décrit comment créer des serveurs
virtuels dynamiquement configurés en utilisant
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
<div class="warning">L'utilisation de mod_rewrite n'est pas la meilleure
méthode pour configurer des serveurs virtuels. Vous devez dans un
premier temps tenter de résoudre votre problème via ces <a href="../vhosts/mass.html">d'autres méthodes</a> avant d'avoir
recours à mod_rewrite. Voir aussi le document <a href="avoid.html#vhosts">Comment éviter l'utilisation de
mod_rewrite</a>.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#per-hostname">Serveurs virtuels pour des noms d'hôtes arbitraires</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#simple.rewrite">Configuration dynamique de serveurs
virtuels via <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#xtra-conf">Utilisation d'un fichier de configuration
du serveur virtuel séparé</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en
correspondance</a></li><li><a href="access.html">Contrôle d'accès</a></li><li><a href="proxy.html">Serveurs mandataires</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</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="per-hostname" id="per-hostname">Serveurs virtuels pour des noms d'hôtes arbitraires</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Nous voulons créer automatiquement un serveur virtuel pour tout
nom d'hôte qui peut être résolu dans notre domaine, sans avoir à
créer de nouvelle section VirtualHost.</p>
<p>Dans cet exemple, nous supposons que nous utilisons le nom d'hôte
<code>www.<strong>SITE</strong>.example.com</code> pour chaque
utilisateur, et que nous servons leur contenu depuis
<code>/home/<strong>SITE</strong>/www</code>.</p>
</dd>
<dt>Solution :</dt>
<dd>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap lowercase int:tolower
RewriteCond "${lowercase:%{<strong>HTTP_HOST</strong>}}" "^www\.<strong>([^.]+)</strong>\.example\.com$"
RewriteRule "^(.*)" "/home/<strong>%1</strong>/www$1"</pre>
</dd>
<dt>Discussion</dt>
<dd>
<div class="warning">Vous devez vérifier le bon fonctionnement de la
résolution DNS - Apache ne gère pas la résolution de nom. Vous
devrez créer soit des enregistrements CNAME pour chaque nom d'hôte,
soit un enregistrement DNS avec caractères génériques. La création
des enregistrements DNS est en dehors du sujet de ce document.</div>
<p>La directive RewriteMap interne <code>tolower</code> permet de
s'assurer que les noms d'hôtes utilisés seront tous en minuscules, de
façon à éviter toute ambiguité dans la structure des répertoires qui
doit être créée.</p>
<p>Les contenus des parenthèses utilisées dans une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> sont enregistrés dans les
références arrières <code>%1</code>, <code>%2</code>, etc..., alors que
les contenus des parenthèses utilisées dans une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> le sont dans les
références arrières <code>$1</code>, <code>$2</code>, etc...</p>
<p>
Comme c'est le cas pour de nombreuses techniques discutées dans ce
document, mod_rewrite n'est vraiment pas la meilleure méthode pour
accomplir cette tâche. Vous devez plutôt vous tourner vers
<code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>, car ce dernier sera bien plus à même
de gérer tout ce qui est au delà du domaine des fichiers statiques,
comme les contenus dynamiques et la résolution des alias.
</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="simple.rewrite" id="simple.rewrite">Configuration dynamique de serveurs
virtuels via <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></a></h2>
<p>Cet extrait du fichier <code>httpd.conf</code> permet d'obtenir
le même résultat que <a href="#per-hostname">le premier exemple</a>.
La première moitié est très similaire à la partie correspondante
ci-dessus, excepté quelques modifications requises à des fins de
compatibilité ascendante et pour faire en sorte que la partie
<code>mod_rewrite</code> fonctionne correctement ; la seconde moitié
configure <code>mod_rewrite</code> pour effectuer le travail
proprement dit.</p>
<p>Comme <code>mod_rewrite</code> s'exécute avant tout autre module
de traduction d'URI (comme <code>mod_alias</code>), il faut lui
ordonner explicitement d'ignorer toute URL susceptible d'être
traitée par ces autres modules. Et comme ces règles auraient sinon
court-circuité toute directive <code>ScriptAlias</code>, nous devons
faire en sorte que <code>mod_rewrite</code> déclare explicitement
ces correspondances.</p>
<pre class="prettyprint lang-config"># extrait le nom de serveur de l'en-tête Host:
UseCanonicalName Off
# journaux dissociables
LogFormat "%{Host}i %h %l %u %t \"%r\" %s %b" vcommon
CustomLog "logs/access_log" vcommon
<Directory "/www/hosts">
# ExecCGI est nécessaire ici car on ne peut pas forcer l'exécution
# des CGI à la manière de ScriptAlias
Options FollowSymLinks ExecCGI
</Directory>
RewriteEngine On
# un nom de serveur extrait d'un en-tête Host: peut être dans n'importe
# quelle casse
RewriteMap lowercase int:tolower
## on s'occupe tout d'abord des documents normaux :<br />
# permet à Alias "/icons/" de fonctionner - répéter pour les autres
RewriteCond "%{REQUEST_URI}" "!^/icons/"
# permet aux CGIs de fonctionner
RewriteCond "%{REQUEST_URI}" "!^/cgi-bin/"
# le coeur du traitement
RewriteRule "^/(.*)$" "/www/hosts/${lowercase:%{SERVER_NAME}}/docs/$1"
## on s'occupe maintenant des CGIs - on doit forcer l'utilisation d'un
# gestionnaire
RewriteCond "%{REQUEST_URI}" "^/cgi-bin/"
RewriteRule "^/(.*)$" "/www/hosts/${lowercase:%{SERVER_NAME}}/cgi-bin/$1" [H=cgi-script]</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="xtra-conf" id="xtra-conf">Utilisation d'un fichier de configuration
du serveur virtuel séparé</a></h2>
<p>Cette construction utilise des fonctionnalités plus avancées de
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour effectuer la traduction depuis le
serveur virtuel vers la racine des documents, à partir d'un fichier
de configuration séparé. Elle est plus souple mais nécessite une
configuration plus compliquée.</p>
<p>Le fichier <code>vhost.map</code> devrait ressembler à ceci :</p>
<div class="example"><p><code>
www.client-1.example.com /www/clients/1<br />
www.client-2.example.com /www/clients/2<br />
# ...<br />
www.client-N.example.com /www/clients/N<br />
</code></p></div>
<p>On doit ajouter à <code>httpd.conf</code> :</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap lowercase int:tolower
# définit le fichier de correspondances
RewriteMap vhost "txt:/www/conf/vhost.map"
# on s'occupe des alias comme ci-dessus
RewriteCond "%{REQUEST_URI}" "!^/icons/"
RewriteCond "%{REQUEST_URI}" "!^/cgi-bin/"
RewriteCond "${lowercase:%{SERVER_NAME}}" "^(.+)$"
# on effectue ici la remise en correspondance à base de fichier
RewriteCond "${vhost:%1}" "^(/.*)$"
RewriteRule "^/(.*)$" "%1/docs/$1"
RewriteCond "%{REQUEST_URI}" "^/cgi-bin/"
RewriteCond "${lowercase:%{SERVER_NAME}}" "^(.+)$"
RewriteCond "${vhost:%1}" "^(/.*)$"
RewriteRule "^/cgi-bin/(.*)$" "%1/cgi-bin/$1" [H=cgi-script]</pre>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/vhosts.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/vhosts.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/vhosts.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/rewritemap.html 0000664 0001751 0001751 00000000323 13710016232 021546 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: rewritemap.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: rewritemap.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/intro.html.fr.utf8 0000664 0001751 0001751 00000061066 14740503670 022043 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Introduction au module Apache mod_rewrite - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Introduction au module Apache mod_rewrite</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/intro.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/intro.html" title="Français"> fr </a></p>
</div>
<p>Ce document est un complément à la <a href="../mod/mod_rewrite.html">documentation de référence</a> du module
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il décrit les concepts de base dont la
connaissance est nécessaire pour l'utilisation de
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. D'autres documents entrent d'avantage dans
les détails, mais celui-ci devrait aider le débutant à se mouiller les
pieds.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#regex">Expressions rationnelles</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewriterule">Les bases des règles de réécriture</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flags">Drapeaux de réécriture</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewritecond">Conditions de réécriture</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewritemap">Tables de réécriture</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#htaccess">Fichiers .htaccess</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du
module mod_rewrite</a></li><li><a href="remapping.html">Redirection and remise en
correspondance</a></li><li><a href="access.html">Contrôle d'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Mise en cache</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</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="introduction" id="introduction">Introduction</a></h2>
<p>Le module Apache <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> est un module puissant
et sophistiqué qui permet la réécriture des URLs. Grâce à lui, vous
pouvez effectuer quasiment tous les types de réécriture d'URLs dont vous
avez besoin. Il est cependant assez complexe, et peut paraître
intimidant au débutant. Certains ont aussi tendance à traiter les
règles de réécriture comme des incantations magiques, et à les utiliser
sans vraiment comprendre leur manière d'agir.</p>
<p>Ce document a pour ambition d'être suffisamment explicite pour
permettre la compréhension, et non la copie en aveugle, de ce qui suit.
</p>
<p>Gardez à l'esprit que de nombreuses tâches de manipulation d'URLs
courantes n'ont pas besoin de la puissance et de la complexité de
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Pour les tâches simples, voir
<code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> et la documentation sur la <a href="../urlmapping.html">Mise en correspondance des URLs avec le
système de fichiers</a>.</p>
<p>Enfin, avant de procéder, assurez-vous d'avoir configuré le niveau de
journalisation de <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> à un des niveaux de trace
via la directive <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code>. Bien que
ceci risque de vous submerger sous une énorme quantité d'informations,
le débogage des problèmes avec la configuration de
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> est à ce prix car vous verrez alors
exactement comment chaque règle est traitée.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="regex" id="regex">Expressions rationnelles</a></h2>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> utilise le vocabulaire des <a href="http://pcre.org/">Expressions rationnelles compatibles Perl</a>.
Ce document n'a pas pour prétention d'être une référence détaillée des
expressions rationnelles. A cet effet, nous recommandons les <a href="http://pcre.org/pcre.txt">pages de manuel de PCRE</a>, la <a href="http://perldoc.perl.org/perlre.html">page de manuel des
expressions rationnelles Perl</a>, et l'ouvrage <a href="http://shop.oreilly.com/product/9780596528126.do">Mastering
Regular Expressions, by Jeffrey Friedl</a>.</p>
<p>Dans ce document, nous avons pour but de vous fournir suffisamment de
vocabulaire des expressions rationnelles pour vous mettre le pied à
l'étrier, sans être dépassé, en espérant que les directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> vous apparaîtront comme des
formules scientifiques, plutôt que comme des incantations magiques.</p>
<h3><a name="regexvocab" id="regexvocab">Vocabulaire des expressions rationnelles</a></h3>
<p>Vous trouverez dans ce qui suit le minimum à connaître pour être en
mesure d'écrire des expressions rationnelles et des règles <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. Ceci ne représente
certainement pas un vocabulaire des expressions rationnelles complet,
mais constitue un bon point de départ, et devrait vous aider à
déchiffrer les expressions rationnelles simples, et à écrire vos propres
expressions.</p>
<table>
<tr>
<th>Motif</th>
<th>Signification</th>
<th>Exemple</th>
</tr>
<tr>
<td><code>.</code></td>
<td>Correspond à tout caractère unique</td>
<td><code>c.t</code> correspondra à <code>cat</code>,
<code>cot</code>, <code>cut</code>, etc.</td>
</tr>
<tr>
<td><code>+</code></td>
<td>Répète le caractère de correspondance précédent une ou plusieurs fois</td>
<td><code>a+</code> correspond à <code>a</code>, <code>aa</code>,
<code>aaa</code>, etc.</td>
</tr>
<tr><td><code>*</code></td>
<td>Répète le caractère de correspondance
précédent zéro ou plusieurs fois</td>
<td><code>a*</code> correspond à tout ce à quoi correspond
<code>a+</code>, mais correspond aussi à la chaîne vide.</td>
</tr>
<tr>
<td><code>?</code></td>
<td>Rend la correspondance optionnelle.</td>
<td><code>colou?r</code> correspondra à <code>color</code> et <code>colour</code>.</td>
</tr>
<tr>
<td><code>\</code></td>
<td>Echappe le caractère suivant</td>
<td><code>\.</code> correspondra à <code>.</code> (le point) et non <em>à
tout caractère unique</em> comme expliqué plus haut</td>
</tr>
<tr>
<td><code>^</code></td>
<td>Appelé ancrage, correspond au début de la
chaîne</td>
<td><code>^a</code> correspond à une chaîne qui commence par
<code>a</code></td>
</tr>
<tr>
<td><code>$</code></td>
<td>L'autre ancrage, correspond à la fin de
la chaîne.</td>
<td><code>a$</code> correspond à une chaîne qui se termine par
<code>a</code>.</td>
</tr>
<tr>
<td><code>( )</code></td>
<td>Regroupe plusieurs caractères en une
seule entité, et conserve une correspondance à des fins d'utilisation
dans une référence arrière.</td>
<td><code>(ab)+</code>
correspond à <code>ababab</code> - à savoir, le <code>+</code>
s'applique au groupe.
Pour plus de détails sur les références arrières, voir <a href="#InternalBackRefs">ci-dessous</a>.</td>
</tr>
<tr>
<td><code>[ ]</code></td>
<td>Une classe de caractères - correspond à
un des caractères de la classe</td>
<td><code>c[uoa]t</code> correspond à <code>cut</code>,
<code>cot</code> ou <code>cat</code>.</td>
</tr>
<tr>
<td><code>[^ ]</code></td>
<td>Négation de la classe de caractères -
correspond à tout caractère ne faisant pas partie de la classe</td>
<td><code>c[^/]t</code> correspond à <code>cat</code> ou
<code>c=t</code> mais pas à <code>c/t</code></td>
</tr>
</table>
<p>Avec <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, le caractère <code>!</code> peut
préfixer une expression rationnelle afin d'en exprimer la négation.
Autrement dit, une chaîne ne correspondra que si elle ne correspond pas
à l'expression située après le <code>!</code>.</p>
<h3><a name="InternalBackRefs" id="InternalBackRefs">Disponibilité des références
arrières dans les expressions rationnelles</a></h3>
<p>Vous devez vous souvenir d'une chose importante : chaque fois
que vous utilisez des parenthèses dans un <em>Modèle</em> ou dans
un des <em>modèles de conditions</em>, des références arrières
sont créées en interne et peuvent être rappelées via les chaînes
<code>$N</code> et <code>%N</code> (voir ci-dessous). Ces
références sont disponibles lors de la
création de la chaîne de substitution d'une directive
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> ou de la
chaîne de test d'une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>.</p>
<p>Les captures dans les modèles de directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> sont paradoxalement
disponibles dans toutes les directives <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> qui précèdent, car
les expressions des directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> sont évaluées avant
les conditions individuelles.</p>
<p>La figure 1 montre à quels endroits les
références arrières sont suceptibles
d'être développées, et illustre le flux des comparaisons
effectuées par les règles RewriteRule et
RewriteCond. Dans les chapitres suivants, nous examinerons comment
utiliser ces références arrières, donc ne vous affolez pas si
elles vous paraissent un peu exotiques au premier abord.</p>
<p class="figure">
<img src="../images/rewrite_backreferences.png" alt="Flux des comparaisons effectuées par les règles RewriteRule et RewriteCond" /><br />
<dfn>Figure 1 :</dfn> Le cheminement d'une référence arrière à
travers une règle.<br />
Dans cet exemple, une requête pour <code>/test/1234</code> serait
transformée en
<code>/admin.foo?page=test&id=1234&host=admin.example.com</code>.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewriterule" id="rewriterule">Les bases des règles de réécriture</a></h2>
<p>Une règle de réécriture <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est constituée de trois
arguments séparés par des espaces. Les arguments sont :</p>
<ol>
<li><var>Modèle</var>: le modèle des URLs auxquelles la règle doit
s'appliquer;</li>
<li><var>Substitution</var>: vers quoi la requête correspondante doit être
transformée;</li>
<li><var>[drapeaux]</var>: options affectant la requête réécrite.</li>
</ol>
<p>Le <var>Modèle</var> est une <a href="#regex">expression
rationnelle</a>. Au sein de la première règle de réécriture, ou jusqu'à
ce qu'une substitution survienne, elle est comparée au chemin de
l'URL de la requête entrante (la
partie située après le nom d'hôte mais avant tout point d'interrogation
qui indique le début d'une chaîne de paramètres de
requête) ou, dans un contexte de répertoire, au chemin de la
requête relativement au répertoire pour lequel la
règle est définie. Lorsqu'une substitution a eu lieu, les
règles suivantes effectuent leurs comparaisons par rapport à la valeur
substituée.</p>
<p class="figure">
<img src="../images/syntax_rewriterule.png" alt="Syntaxe de la directive RewriteRule" /><br />
<dfn>Figure 2 :</dfn> Syntaxe de la directive RewriteRule.
</p>
<p>La chaîne de <var>Substitution</var> peut, quant à elle, être de
trois types :</p>
<dl>
<dt>1. Un chemin complet du système de fichiers vers une ressource</dt>
<dd>
<pre class="prettyprint lang-config">RewriteRule "^/games" "/usr/local/games/web/puzzles.html"</pre>
<p>Ceci peut faire correspondre une requête à toute localisation voulue de
votre système de fichiers, un peu comme la directive <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>.</p>
</dd>
<dt>2. Un chemin web vers une ressource</dt>
<dd>
<pre class="prettyprint lang-config">RewriteRule "^/games$" "/puzzles.html"</pre>
<p>Si la directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> a
pour valeur <code>/usr/local/apache2/htdocs</code>, cette règle va faire
correspondre les requêtes pour <code>http://example.com/games</code> au
chemin <code>/usr/local/apache2/htdocs/puzzles.html</code>.</p>
</dd>
<dt>3. Une URL absolue</dt>
<dd>
<pre class="prettyprint lang-config">RewriteRule "^/produits/vues$" "http://site2.example.com/voirproduits.html" [R]</pre>
<p>Ceci informe le client qu'il doit effectuer une nouvelle requête vers
l'URL spécifiée.</p>
</dd>
</dl>
<div class="warning">Notez que <strong>1</strong> et <strong>2</strong>
possèdent exactement la même syntaxe. Par contre, dans le cas de
<strong>1</strong>, le niveau racine du chemin cible (par exemple
<code>/usr/</code>) existe dans le système de fichiers, alors que ce n'est pas
le cas avec <strong>2</strong> (par exemple, il n'y a pas de répertoire
<code>/bar/</code> au niveau de la racine du système de fichiers).</div>
<p>La chaîne de <var>Substitution</var> peut aussi contenir des
<em>références arrières</em> vers des parties du chemin d'URL entrant
correspondant au <var>Modèle</var>. Considérons ce qui suit :</p>
<pre class="prettyprint lang-config">RewriteRule "^/produits/(.*)/view$" "/var/web/produitsdb/$1"</pre>
<p>La variable <code>$1</code> sera remplacée par tout texte
correspondant à l'expression située entre les parenthèses dans le
<var>Modèle</var>. Par exemple, une requête pour
<code>http://example.com/produits/r14df/vue</code> correspondra au
chemin <code>/var/web/produitsdb/r14df</code>.</p>
<p>S'il y a plus d'une expression entre parenthèses, elle seront
accessibles selon leur ordre d'apparition via les variables
<code>$1</code>, <code>$2</code>, <code>$3</code>, etc...</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flags" id="flags">Drapeaux de réécriture</a></h2>
<p>Le comportement d'une règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> peut être modifié par la
présence d'un ou plusieurs drapeaux en fin de règle. Par exemple, les
conditions de correspondance d'une règle peuvent être rendues
insensibles à la casse par la présence du drapeau <code>[NC]</code> :
</p>
<pre class="prettyprint lang-config">RewriteRule "^puppy.html" "petitchien.html" [NC]</pre>
<p>Pour une liste des drapeaux disponibles, leurs significations, et des
exemples, voir le document <a href="flags.html">Drapeaux de
réécriture</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewritecond" id="rewritecond">Conditions de réécriture</a></h2>
<p>Il est possible d'utiliser une ou plusieurs directives <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> pour restreindre les types
de requêtes auxquelles devra s'appliquer la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> suivante. Le premier
argument est une variable décrivant une caractéristique de la requête,
le second argument est une <a href="#regex">expression rationnelle</a>
qui doit correspondre à la variable, et un troisième argument optionnel
est une liste de drapeaux qui modifient la manière dont la
correspondance est évaluée.</p>
<p class="figure">
<img src="../images/syntax_rewritecond.png" alt="Syntaxe de la directive RewriteCond" /><br />
<dfn>Figure 3 :</dfn> Syntaxe de la directive RewriteCond
</p>
<p>Par exemple, pour renvoyer toutes les requêtes en provenance d'une
certaine tranche d'adresses IP vers un autre serveur, vous pouvez
utiliser :</p>
<pre class="prettyprint lang-config">RewriteCond "%{REMOTE_ADDR}" "^10\.2\."
RewriteRule "(.*)" "http://intranet.example.com$1"</pre>
<p>Si vous spécifiez plus d'une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>, ces directives
doivent toutes être satisfaites pour que la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> suivante s'applique. Par exemple,
pour interdire les requêtes qui contiennent le mot "hack" dans la chaîne
de requête, sauf si elles contiennent aussi un cookie contenant le mot
"go", vous pouvez utiliser :</p>
<pre class="prettyprint lang-config">RewriteCond "%{QUERY_STRING}" "hack"
RewriteCond "%{HTTP_COOKIE}" !go
RewriteRule "." "-" [F]</pre>
<p>Notez que le point d'exclamation indique une correspondance négative
; ainsi, la règle n'est appliquée que si le cookie ne contient pas "go"</p>
<p>Les correspondances dans les expressions rationnelles contenues dans
les directives <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
peuvent constituer des parties de la chaîne de <var>Substitution</var>
de la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> via
les variables <code>%1</code>, <code>%2</code>, etc... Par
exemple, ce qui suit va diriger la requête vers un répertoire différent
en fonction du nom d'hôte utilisé pour accéder au site :</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_HOST}" "(.*)"
RewriteRule "^/(.*)" "/sites/%1/$1"</pre>
<p>Si la requête concernait <code>http://example.com/foo/bar</code>,
alors <code>%1</code> contiendrait <code>example.com</code> et
<code>$1</code> contiendrait <code>foo/bar</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewritemap" id="rewritemap">Tables de réécriture</a></h2>
<p>La directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
permet en quelque sorte de faire appel à une fonction externe pour
effectuer la réécriture à votre place. Tout ceci est décrit plus en
détails dans la <a href="rewritemap.html">Documentation
supplémentaire sur RewriteMap</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="htaccess" id="htaccess">Fichiers .htaccess</a></h2>
<p>La réécriture est en général définie au niveau de la configuration du
serveur principal (en dehors de toute section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>) ou dans une section <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>. Il s'agit là de la
manière la plus simple de mettre en oeuvre la réécriture et nous la
recommandons. Il est possible, cependant, de mettre en oeuvre la
réécriture au sein d'une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou d'un fichier <a href="../howto/htaccess.html"><code>.htaccess</code></a> ; ce type de
configuration est cependant plus complexe. Cette technique est appelée
réécriture par répertoire.</p>
<p>La principale différence avec les réécritures au niveau du serveur réside
dans le fait que le préfixe du chemin du répertoire contenant le fichier
<code>.htaccess</code> est supprimé avant la mise en correspondance dans
la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. De
plus, on doit utiliser la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code> pour s'assurer que la
requête est correctement mise en correspondance.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/intro.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/intro.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/intro.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/tech.html.fr.utf8 0000664 0001751 0001751 00000034315 14740503670 021630 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Détails techniques sur le module Apache mod_rewrite - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Détails techniques sur le module Apache mod_rewrite</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/tech.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/tech.html" title="Français"> fr </a></p>
</div>
<p>Ce document passe en revue certains détails techniques à propos du
module mod_rewrite et de la mise en correspondance des URLs</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#InternalAPI">Phases de l'API</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#InternalRuleset">Traitement du jeu de règles</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module mod_rewrite</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en
correspondance</a></li><li><a href="access.html">Contrôle d'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Mise en cache</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</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="InternalAPI" id="InternalAPI">Phases de l'API</a></h2>
<p>Le traitement des requêtes par le serveur HTTP Apache se
déroule en plusieurs phases. Au cours de chaque phase, un ou
plusieurs modules peuvent être appelés pour traiter la partie
concernée du cycle de vie de la requête. Les différentes phases
peuvent consister en traduction d'URL en nom de fichier,
authentification, autorisation, gestion de contenu ou journalisation (la
liste n'est pas exhaustive).</p>
<p>mod_rewrite agit dans deux de ces phases (ou accroches - hooks -
comme on les nomme souvent) pour la réécriture des URLs.</p>
<p>Tout d'abord, il utilise le hook traduction URL vers nom de
fichier qui intervient après la lecture de la requête HTTP, mais
avant le processus d'autorisation. Ensuite, il utilise le hook
Fixup, qui intervient après les phases d'autorisation, après la
lecture des fichiers de configuration de niveau répertoire (fichiers
<code>.htaccess</code>), mais avant l'appel du gestionnaire de
contenu.</p>
<p>Ainsi, lorsqu'une requête arrive et une fois le serveur
correspondant ou le serveur virtuel déterminé, le moteur de
réécriture commence à traiter toute directive apparaissant dans la
configuration de niveau serveur (autrement dit dans le
fichier de configuration principal du serveur et les sections
<code class="directive"><a href="../mod/core.html#virtualhost"><Virtualhost></a></code>).
Tout ce processus s'exécute au cours de la phase de traduction URL
vers nom de fichier.</p>
<p>Quelques étapes plus loin, une fois les répertoires de données
finaux trouvés, les directives de configuration de niveau répertoire
(fichiers <code>.htaccess</code> et sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>) sont appliquées. Ce processus
s'exécute au cours de la phase Fixup.</p>
<p>Dans tous ces cas, mod_rewrite réécrit le
<code>REQUEST_URI</code> soit vers une nouvelle URL, soit vers un
nom de fichier.</p>
<p>Dans un contexte de niveau répertoire (autrement dit dans les
fichiers <code>.htaccess</code> et les sections
<code>Directory</code>), les règles de réécriture s'appliquent après
la traduction de l'URL en nom de fichier. C'est pourquoi le chemin
URL auquel mod_rewrite compare initialement les directives
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est le
chemin complet vers le nom de fichier traduit amputé de la partie
répertoires (y compris le dernier slash).</p>
<p>Un exemple : si les règles se trouvent dans
/var/www/foo/.htaccess et si une requête pour /foo/bar/baz est
traité, une expression comme ^bar/baz$ correspondra.</p>
<p>Si une substitution intervient dans un contexte de répertoire,
une nouvelle sous-requête interne est générée avec la nouvelle URL,
ce qui relance le traitement des phases de la requête. Si la
substitution est un chemin relatif, la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code> détermine le chemin URL
devant préfixer cette substitution. Dans un contexte de répertoire,
il faut s'assurer de créer des règles qui
n'effectueront pas de substitution au
cours d'une passe ultérieure du processus de réécriture au niveau
répertoire afin d'éviter les bouclages . Voir <a href="http://wiki.apache.org/httpd/RewriteLooping">Bouclage dans le
processus de réécriture</a> pour une discussion plus détaillée à
propos de ce problème.</p>
<p>En conséquence de cette manipulation de l'URL , vous devrez
pensez à confectionner différemment vos règles de réécriture dans un
contexte de niveau répertoire. En particulier, rappelez-vous que le
chemin de répertoire sera absent de l'URL que vos règles de
réécriture verront. Voici quelques exemples qui permettront de
clarifier les choses :</p>
<table class="bordered">
<tr>
<th>Position de la règle</th>
<th>Règle</th>
</tr>
<tr>
<td>Section VirtualHost</td>
<td>RewriteRule "^/images/(.+)\.jpg" "/images/$1.gif"</td>
</tr>
<tr>
<td>Fichier .htaccess à la racine des documents</td>
<td>RewriteRule "^images/(.+)\.jpg" "images/$1.gif"</td>
</tr>
<tr>
<td>Fichier .htaccess dans le répertoire images</td>
<td>RewriteRule "^(.+)\.jpg" "$1.gif"</td>
</tr>
</table>
<p>Pour une étude plus approfondie de la manière dont mod_rewrite
manipule les URLs dans les différents contextes, vous pouvez
consulter les <a href="../mod/mod_rewrite.html#logging">entrées du
journal</a> générées au cours du processus de réécriture.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="InternalRuleset" id="InternalRuleset">Traitement du jeu de règles</a></h2>
<p>Maintenant, quand mod_rewrite se lance dans ces deux phases de
l'API, il lit le jeu de règles configurées depuis la structure
contenant sa configuration (qui a été elle-même créée soit au
démarrage d'Apache pour le contexte du serveur, soit lors du
parcours des répertoires par le noyau d'Apache pour le contexte de
répertoire). Puis le moteur de réécriture est démarré avec le jeu
de règles contenu (une ou plusieurs règles associées à leurs
conditions). En lui-même, le mode opératoire du moteur de
réécriture d'URLs est exactement le même dans les deux contextes
de configuration. Seul le traitement du résultat final diffère.</p>
<p>L'ordre dans lequel les règles sont définies est important car
le moteur de réécriture les traite selon une chronologie
particulière (et pas très évidente). Le principe est le suivant :
le moteur de réécriture traite les règles (les directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>) les unes
à la suite des autres, et lorsqu'une règle s'applique, il parcourt
les éventuelles conditions (directives
<code>RewriteCond</code>directives) associées.
Pour des raisons historiques, les
conditions précèdent les règles, si bien que le déroulement du
contrôle est un peu compliqué. Voir la figure 1 pour plus de
détails.</p>
<p class="figure">
<img src="../images/rewrite_process_uri.png" alt="Flux des comparaisons des directives RewriteRule et RewriteCond" /><br />
<dfn>Figure 1:</dfn>Déroulement du contrôle à travers le jeu de
règles de réécriture
</p>
<p>L'URL est tout d'abord comparée au
<em>Modèle</em> de chaque règle. Lorsqu'une règle ne s'applique
pas, mod_rewrite stoppe immédiatement le traitement de cette règle
et passe à la règle suivante. Si l'URL correspond au
<em>Modèle</em>, mod_rewrite recherche la présence de conditions
correspondantes (les directives Rewritecond apparaissant dans la
configuration juste
avant les règles de réécriture). S'il n'y en a pas, mod_rewrite remplace
l'URL par une chaîne élaborée à partir de la chaîne de
<em>Substitution</em>, puis passe à la règle suivante. Si des
conditions sont présentes, mod_rewrite lance un bouclage
secondaire afin de les traiter selon l'ordre dans lequel elles
sont définies. La logique de traitement des conditions est
différente : on ne compare pas l'URL à un modèle. Une chaîne de
test <em>TestString</em> est tout d'abord élaborée en développant
des variables, des références arrières, des recherches dans des
tables de correspondances, etc..., puis cette chaîne de test est
comparée au modèle de condition <em>CondPattern</em>. Si le modèle
ne correspond pas, les autres conditions du jeu ne sont pas
examinées et la règle correspondante ne s'applique pas. Si le
modèle correspond, la condition suivante est examinée et ainsi de
suite jusqu'à la dernière condition. Si toutes les conditions sont
satisfaites, le traitement de la règle en cours se poursuit avec
le remplacement de l'URL par la chaîne de <em>Substitution</em>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/tech.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/tech.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/tech.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/avoid.html.en 0000664 0001751 0001751 00000037457 14737241666 021141 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>When not to use mod_rewrite - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>When not to use mod_rewrite</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/avoid.html" title="English"> en </a> |
<a href="../fr/rewrite/avoid.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
<a href="../mod/mod_rewrite.html">reference documentation</a>. It describes
perhaps one of the most important concepts about <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> - namely,
when to avoid using it.</p>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> should be considered a last resort, when other
alternatives are found wanting. Using it when there are simpler
alternatives leads to configurations which are confusing, fragile, and
hard to maintain. Understanding what other alternatives are available is
a very important step towards <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> mastery.</p>
<p>Note that many of these examples won't work unchanged in your
particular server configuration, so it's important that you understand
them, rather than merely cutting and pasting the examples into your
configuration.</p>
<p>The most common situation in which <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> is
the right tool is when the very best solution requires access to the
server configuration files, and you don't have that access. Some
configuration directives are only available in the server configuration
file. So if you are in a hosting situation where you only have .htaccess
files to work with, you may need to resort to
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#redirect">Simple Redirection</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#alias">URL Aliasing</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#vhosts">Virtual Hosting</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#proxy">Simple Proxying</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#setenv">Environment Variable Testing</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="#comments_section">Comments</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="redirect" id="redirect">Simple Redirection</a></h2>
<p><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> provides the <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code> and <code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> directives, which provide a
means to redirect one URL to another. This kind of simple redirection of
one URL, or a class of URLs, to somewhere else, should be accomplished
using these directives rather than <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. <code>RedirectMatch</code>
allows you to include a regular expression in your redirection criteria,
providing many of the benefits of using <code>RewriteRule</code>.</p>
<p>A common use for <code>RewriteRule</code> is to redirect an entire
class of URLs. For example, all URLs in the <code>/one</code> directory
must be redirected to <code>http://one.example.com/</code>, or perhaps
all <code>http</code> requests must be redirected to
<code>https</code>.</p>
<p>These situations are better handled by the <code>Redirect</code>
directive. Remember that <code>Redirect</code> preserves path
information. That is to say, a redirect for a URL <code>/one</code> will
also redirect all URLs under that, such as <code>/one/two.html</code>
and <code>/one/three/four.html</code>.</p>
<p>To redirect URLs under <code>/one</code> to
<code>http://one.example.com</code>, do the following:</p>
<pre class="prettyprint lang-config">Redirect "/one/" "http://one.example.com/"</pre>
<p>To redirect one hostname to another, for example
<code>example.com</code> to <code>www.example.com</code>, see the
<a href="remapping.html#canonicalhost">Canonical Hostnames</a>
recipe.</p>
<p>To redirect <code>http</code> URLs to <code>https</code>, do the
following:</p>
<pre class="prettyprint lang-config"><VirtualHost *:80>
ServerName www.example.com
Redirect "/" "https://www.example.com/"
</VirtualHost>
<VirtualHost *:443>
ServerName www.example.com
# ... SSL configuration goes here
</VirtualHost></pre>
<p>The use of <code>RewriteRule</code> to perform this task may be
appropriate if there are other <code>RewriteRule</code> directives in
the same scope. This is because, when there are <code>Redirect</code>
and <code>RewriteRule</code> directives in the same scope, the
<code>RewriteRule</code> directives will run first, regardless of the
order of appearance in the configuration file.</p>
<p>In the case of the <em>http-to-https</em> redirection, the use of
<code>RewriteRule</code> would be appropriate if you don't have access
to the main server configuration file, and are obliged to perform this
task in a <code>.htaccess</code> file instead.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="alias" id="alias">URL Aliasing</a></h2>
<p>The <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> directive
provides mapping from a URI to a directory - usually a directory outside
of your <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. Although it
is possible to perform this mapping with <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>,
<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> is the preferred method, for
reasons of simplicity and performance.</p>
<div class="example"><h3>Using Alias</h3><pre class="prettyprint lang-config">Alias "/cats" "/var/www/virtualhosts/felines/htdocs"</pre>
</div>
<p>
The use of <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> to perform this mapping may be
appropriate when you do not have access to the server configuration
files. Alias may only be used in server or virtualhost context, and not
in a <code>.htaccess</code> file.
</p>
<p>Symbolic links would be another way to accomplish the same thing, if
you have <code>Options FollowSymLinks</code> enabled on your
server.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="vhosts" id="vhosts">Virtual Hosting</a></h2>
<p>Although it is possible to handle <a href="vhosts.html">virtual hosts
with mod_rewrite</a>, it is seldom the right way. Creating individual
<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> blocks is
almost always the right way to go. In the
event that you have an enormous number of virtual hosts, consider using
<code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> to create these hosts automatically.</p>
<p>Modules such as <code class="module"><a href="../mod/mod_macro.html">mod_macro</a></code> are
also useful for creating a large number of virtual hosts dynamically.</p>
<p>Using <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> for vitualhost creation may be
appropriate if you are using a hosting service that does not provide
you access to the server configuration files, and you are therefore
restricted to configuration using <code>.htaccess</code> files.</p>
<p>See the <a href="vhosts.html">virtual hosts with mod_rewrite</a>
document for more details on how you might accomplish this if it still
seems like the right approach.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Simple Proxying</a></h2>
<p><code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> provides the <a href="flags.html#flag_p">[P]</a> flag to pass rewritten URIs through
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>.</p>
<pre class="prettyprint lang-config">RewriteRule "^/?images(.*)" "http://imageserver.local/images$1" [P]</pre>
<p>However, in many cases, when there is no actual pattern matching
needed, as in the example shown above, the <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> directive is a better choice.
The example here could be rendered as:</p>
<pre class="prettyprint lang-config">ProxyPass "/images/" "http://imageserver.local/images/"</pre>
<p>Note that whether you use <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> or <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>, you'll still need to use the
<code class="directive"><a href="../mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> directive to
catch redirects issued from the back-end server:</p>
<pre class="prettyprint lang-config">ProxyPassReverse "/images/" "http://imageserver.local/images/"</pre>
<p>You may need to use <code>RewriteRule</code> instead when there are
other <code>RewriteRule</code>s in effect in the same scope, as a
<code>RewriteRule</code> will usually take effect before a
<code>ProxyPass</code>, and so may preempt what you're trying to
accomplish.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="setenv" id="setenv">Environment Variable Testing</a></h2>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> is frequently used to take a particular
action based on the presence or absence of a particular environment
variable or request header. This can be done more efficiently using the
<code class="directive"><a href="../mod/core.html#if"><If></a></code> directive.</p>
<p>Consider, for example, the common scenario where
<code class="directive">RewriteRule</code> is used to enforce a canonical
hostname, such as <code>www.example.com</code> instead of
<code>example.com</code>. This can be done using the <code class="directive"><a href="../mod/core.html#if"><If></a></code> directive, as shown here:</p>
<pre class="prettyprint lang-config"><If "req('Host') != 'www.example.com'">
Redirect "/" "http://www.example.com/"
</If></pre>
<p>This technique can be used to take actions based on any request
header, response header, or environment variable, replacing
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> in many common scenarios.</p>
<p>See especially the <a href="../expr.html">expression evaluation
documentation</a> for a overview of what types of expressions you can
use in <code class="directive"><a href="../mod/core.html#if"><If></a></code> sections,
and in certain other directives.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/avoid.html" title="English"> en </a> |
<a href="../fr/rewrite/avoid.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/avoid.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/intro.html.en 0000664 0001751 0001751 00000054242 14737241666 021161 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache mod_rewrite Introduction - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Apache mod_rewrite Introduction</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/intro.html" title="English"> en </a> |
<a href="../fr/rewrite/intro.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
<a href="../mod/mod_rewrite.html">reference documentation</a>. It
describes the basic concepts necessary for use of
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Other documents go into greater detail,
but this doc should help the beginner get their feet wet.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#regex">Regular Expressions</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewriterule">RewriteRule Basics</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#flags">Rewrite Flags</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewritecond">Rewrite Conditions</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewritemap">Rewrite maps</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#htaccess">.htaccess files</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="introduction" id="introduction">Introduction</a></h2>
<p>The Apache module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> is a very powerful and
sophisticated module which provides a way to do URL manipulations. With
it, you can do nearly all types of URL rewriting that you may need. It
is, however, somewhat complex, and may be intimidating to the beginner.
There is also a tendency to treat rewrite rules as magic incantation,
using them without actually understanding what they do.</p>
<p>This document attempts to give sufficient background so that what
follows is understood, rather than just copied blindly.
</p>
<p>Remember that many common URL-manipulation tasks don't require the
full power and complexity of <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. For simple
tasks, see <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> and the documentation
on <a href="../urlmapping.html">mapping URLs to the
filesystem</a>.</p>
<p>Finally, before proceeding, be sure to configure
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>'s log level to one of the trace levels using
the <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> directive. Although this
can give an overwhelming amount of information, it is indispensable in
debugging problems with <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> configuration, since
it will tell you exactly how each rule is processed.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="regex" id="regex">Regular Expressions</a></h2>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> uses the <a href="http://pcre.org/">Perl Compatible
Regular Expression</a> vocabulary. In this document, we do not attempt
to provide a detailed reference to regular expressions. For that, we
recommend the <a href="http://pcre.org/pcre.txt">PCRE man pages</a>, the
<a href="http://perldoc.perl.org/perlre.html">Perl regular
expression man page</a>, and <a href="http://shop.oreilly.com/product/9780596528126.do">Mastering
Regular Expressions, by Jeffrey Friedl</a>.</p>
<p>In this document, we attempt to provide enough of a regex vocabulary
to get you started, without being overwhelming, in the hope that
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>s will be scientific
formulae, rather than magical incantations.</p>
<h3><a name="regexvocab" id="regexvocab">Regex vocabulary</a></h3>
<p>The following are the minimal building blocks you will need, in order
to write regular expressions and <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>s. They certainly do not
represent a complete regular expression vocabulary, but they are a good
place to start, and should help you read basic regular expressions, as
well as write your own.</p>
<table>
<tr>
<th>Character</th>
<th>Meaning</th>
<th>Example</th>
</tr>
<tr>
<td><code>.</code></td>
<td>Matches any single character</td>
<td><code>c.t</code> will match <code>cat</code>, <code>cot</code>,
<code>cut</code>, etc</td>
</tr>
<tr>
<td><code>+</code></td>
<td>Repeats the previous match one or more times</td>
<td><code>a+</code> matches <code>a</code>, <code>aa</code>,
<code>aaa</code>, etc</td>
</tr>
<tr>
<td><code>*</code></td>
<td>Repeats the previous match zero or more times</td>
<td><code>a*</code> matches all the same things <code>a+</code> matches,
but will also match an empty string</td>
</tr>
<tr>
<td><code>?</code></td>
<td>Makes the match optional</td>
<td><code>colou?r</code> will match <code>color</code> and
<code>colour</code></td>
</tr>
<tr>
<td><code>\</code></td>
<td>Escape the next character</td>
<td><code>\.</code> will match <code>.</code> (dot) and not <em>any single
character</em> as explain above</td>
</tr>
<tr>
<td><code>^</code></td>
<td>Called an anchor, matches the beginning of the string</td>
<td><code>^a</code> matches a string that begins with <code>a</code></td>
</tr>
<tr>
<td><code>$</code></td>
<td>The other anchor, this matches the end of the string</td>
<td><code>a$</code> matches a string that ends with <code>a</code></td>
</tr>
<tr>
<td><code>( )</code></td>
<td>Groups several characters into a single unit, and captures a match
for use in a backreference</td>
<td><code>(ab)+</code> matches <code>ababab</code> - that is, the
<code>+</code> applies to the group. For more on backreferences see
<a href="#InternalBackRefs">below</a></td>
</tr>
<tr>
<td><code>[ ]</code></td>
<td>A character class - matches one of the characters</td>
<td><code>c[uoa]t</code> matches <code>cut</code>, <code>cot</code> or
<code>cat</code></td>
</tr>
<tr>
<td><code>[^ ]</code></td>
<td>Negative character class - matches any character not specified</td>
<td><code>c[^/]t</code> matches <code>cat</code> or <code>c=t</code> but
not <code>c/t</code></td></tr>
</table>
<p>In <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> the <code>!</code> character can be
used before a regular expression to negate it. This is, a string will
be considered to have matched only if it does not match the rest of
the expression.</p>
<h3><a name="InternalBackRefs" id="InternalBackRefs">Regex Back-Reference Availability</a></h3>
<p>One important thing here has to be remembered: Whenever you
use parentheses in <em>Pattern</em> or in one of the
<em>CondPattern</em>, back-references are internally created
which can be used with the strings <code>$N</code> and
<code>%N</code> (see below). These are available for creating
the <em>Substitution</em> parameter of a
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> or
the <em>TestString</em> parameter of a
<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>.</p>
<p> Captures in the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> patterns are (counterintuitively) available to
all preceding
<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> directives,
because the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
expression is evaluated before the individual conditions.</p>
<p>Figure 1 shows to which
locations the back-references are transferred for expansion as
well as illustrating the flow of the RewriteRule, RewriteCond
matching. In the next chapters, we will be exploring how to use
these back-references, so do not fret if it seems a bit alien
to you at first.
</p>
<p class="figure">
<img src="../images/rewrite_backreferences.png" alt="Flow of RewriteRule and RewriteCond matching" /><br />
<dfn>Figure 1:</dfn> The back-reference flow through a rule.<br />
In this example, a request for <code>/test/1234</code> would be transformed into <code>/admin.foo?page=test&id=1234&host=admin.example.com</code>.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewriterule" id="rewriterule">RewriteRule Basics</a></h2>
<p>A <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> consists
of three arguments separated by spaces. The arguments are</p>
<ol>
<li><var>Pattern</var>: which incoming URLs should be affected by the rule;</li>
<li><var>Substitution</var>: where should the matching requests be sent;</li>
<li><var>[flags]</var>: options affecting the rewritten request.</li>
</ol>
<p>The <var>Pattern</var> is a <a href="#regex">regular expression</a>.
It is initially (for the first rewrite rule or until a substitution occurs)
matched against the URL-path of the incoming request (the part after the
hostname but before any question mark indicating the beginning of a query
string) or, in per-directory context, against the request's path relative
to the directory for which the rule is defined. Once a substitution has
occurred, the rules that follow are matched against the substituted
value.
</p>
<p class="figure">
<img src="../images/syntax_rewriterule.png" alt="Syntax of the RewriteRule directive" /><br />
<dfn>Figure 2:</dfn> Syntax of the RewriteRule directive.
</p>
<p>The <var>Substitution</var> can itself be one of three things:</p>
<dl>
<dt>1. A full filesystem path to a resource</dt>
<dd>
<pre class="prettyprint lang-config">RewriteRule "^/games" "/usr/local/games/web/puzzles.html"</pre>
<p>This maps a request to an arbitrary location on your filesystem, much
like the <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> directive.</p>
</dd>
<dt>2. A web-path to a resource</dt>
<dd>
<pre class="prettyprint lang-config">RewriteRule "^/games$" "/puzzles.html"</pre>
<p>If <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> is set
to <code>/usr/local/apache2/htdocs</code>, then this directive would
map requests for <code>http://example.com/games</code> to the
path <code>/usr/local/apache2/htdocs/puzzles.html</code>.</p>
</dd>
<dt>3. An absolute URL</dt>
<dd>
<pre class="prettyprint lang-config">RewriteRule "^/product/view$" "http://site2.example.com/seeproduct.html" [R]</pre>
<p>This tells the client to make a new request for the specified URL.</p>
</dd>
</dl>
<div class="warning">Note that <strong>1</strong> and <strong>2</strong> have exactly the same syntax. The difference between them is that in the case of <strong>1</strong>, the top level of the target path (i.e., <code>/usr/</code>) exists on the filesystem, where as in the case of <strong>2</strong>, it does not. (i.e., there's no <code>/bar/</code> as a root-level directory in the filesystem.)</div>
<p>The <var>Substitution</var> can also
contain <em>back-references</em> to parts of the incoming URL-path
matched by the <var>Pattern</var>. Consider the following:</p>
<pre class="prettyprint lang-config">RewriteRule "^/product/(.*)/view$" "/var/web/productdb/$1"</pre>
<p>The variable <code>$1</code> will be replaced with whatever text
was matched by the expression inside the parenthesis in
the <var>Pattern</var>. For example, a request
for <code>http://example.com/product/r14df/view</code> will be mapped
to the path <code>/var/web/productdb/r14df</code>.</p>
<p>If there is more than one expression in parenthesis, they are
available in order in the
variables <code>$1</code>, <code>$2</code>, <code>$3</code>, and so
on.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="flags" id="flags">Rewrite Flags</a></h2>
<p>The behavior of a <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> can be modified by the
application of one or more flags to the end of the rule. For example, the
matching behavior of a rule can be made case-insensitive by the
application of the <code>[NC]</code> flag:
</p>
<pre class="prettyprint lang-config">RewriteRule "^puppy.html" "smalldog.html" [NC]</pre>
<p>For more details on the available flags, their meanings, and
examples, see the <a href="flags.html">Rewrite Flags</a> document.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewritecond" id="rewritecond">Rewrite Conditions</a></h2>
<p>One or more <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
directives can be used to restrict the types of requests that will be
subject to the
following <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. The
first argument is a variable describing a characteristic of the
request, the second argument is a <a href="#regex">regular
expression</a> that must match the variable, and a third optional
argument is a list of flags that modify how the match is evaluated.</p>
<p class="figure">
<img src="../images/syntax_rewritecond.png" alt="Syntax of the RewriteCond directive" /><br />
<dfn>Figure 3:</dfn> Syntax of the RewriteCond directive
</p>
<p>For example, to send all requests from a particular IP range to a
different server, you could use:</p>
<pre class="prettyprint lang-config">RewriteCond "%{REMOTE_ADDR}" "^10\.2\."
RewriteRule "(.*)" "http://intranet.example.com$1"</pre>
<p>When more than
one <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> is
specified, they must all match for
the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to be
applied. For example, to deny requests that contain the word "hack" in
their query string, unless they also contain a cookie containing
the word "go", you could use:</p>
<pre class="prettyprint lang-config">RewriteCond "%{QUERY_STRING}" "hack"
RewriteCond "%{HTTP_COOKIE}" !go
RewriteRule "." "-" [F]</pre>
<p>Notice that the exclamation mark specifies a negative match, so the rule is only applied if the cookie does not contain "go".</p>
<p>Matches in the regular expressions contained in
the <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>s can be
used as part of the <var>Substitution</var> in
the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> using the
variables <code>%1</code>, <code>%2</code>, etc. For example, this
will direct the request to a different directory depending on the
hostname used to access the site:</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_HOST}" "(.*)"
RewriteRule "^/(.*)" "/sites/%1/$1"</pre>
<p>If the request was for <code>http://example.com/foo/bar</code>,
then <code>%1</code> would contain <code>example.com</code>
and <code>$1</code> would contain <code>foo/bar</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewritemap" id="rewritemap">Rewrite maps</a></h2>
<p>The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive
provides a way to call an external function, so to speak, to do your
rewriting for you. This is discussed in greater detail in the <a href="rewritemap.html">RewriteMap supplementary documentation</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="htaccess" id="htaccess">.htaccess files</a></h2>
<p>Rewriting is typically configured in the main server configuration
setting (outside any <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> section) or
inside <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>
containers. This is the easiest way to do rewriting and is
recommended. It is possible, however, to do rewriting
inside <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
sections or <a href="../howto/htaccess.html"><code>.htaccess</code>
files</a> at the expense of some additional complexity. This technique
is called per-directory rewrites.</p>
<p>The main difference with per-server rewrites is that the path
prefix of the directory containing the <code>.htaccess</code> file is
stripped before matching in
the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. In addition, the <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code> should be used to assure the request is properly mapped.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/intro.html" title="English"> en </a> |
<a href="../fr/rewrite/intro.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/intro.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/index.html.fr.utf8 0000664 0001751 0001751 00000016331 14740503670 022012 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Le module Apache mod_rewrite - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Le module Apache mod_rewrite</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/" title="Français"> fr </a> |
<a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/rewrite/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> permet de modifier les requêtes
entrantes dynamiquement, en fonction de règles manipulant des <a href="intro.html#regex">expressions rationnelles</a>. Vous pouvez
ainsi relier des URLs arbitraires à votre propre structure d'URLs
interne comme vous le souhaitez.</p>
<p>Il fournit un
mécanisme de manipulation d'URL particulièrement souple et
puissant en supportant un nombre illimité de règles et de
conditions attachées à chaque règle. Les manipulations d'URLs
peuvent dépendre de tests variés : les URLs peuvent
être finement caractérisées en fonction de variables du serveur,
de variables d'environnement, d'en-têtes HTTP, de repères
temporels, de recherches dans des bases de données
externes, ou même de requêtes vers des bases de données externes
et de différents gestionnaires ou programmes externes.</p>
<p>Les règles de réécriture peuvent agir sur l'ensemble des URLs (la partie chemin
et la chaîne de paramètres) et peuvent être utilisées dans le contexte du serveur principal
(<code>httpd.conf</code>), mais aussi dans le contexte des
serveurs virtuels (sections <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>), ou dans le
contexte des
répertoires (fichiers <code>.htaccess</code> et blocs
<code><Directory></code>. Le résultat
réécrit peut conduire vers d'autres règles à un
traitement secondaire interne, une redirection vers une requête
externe ou même l'envoi vers un serveur mandataire, en fonction
des <a href="flags.html">drapeaux</a> que vous attachez aux
règles</p>
<p>mod_rewrite étant très puissant, il peut par
conséquent être très complexe. Ce document
complète la <a href="../mod/mod_rewrite.html">documentation de
référence du module mod_rewrite</a>, et est sensé alléger un
peu cette complexité, et présenter des exemples largement
commentés, ainsi que des situations courantes que vous
pourrez traiter avec mod_rewrite. Mais nous voulons aussi vous
montrer des situations où vous ne devrez pas utiliser
mod_rewrite, et lui préférer d'autres
fonctionnalités standard d'Apache, évitant ainsi
d'entrer dans une complexité inutile.</p>
<ul>
<li><a href="../mod/mod_rewrite.html">documentation de
référence de mod_rewrite</a></li>
<li><a href="intro.html">Introduction aux expressions rationnelles et à
mod_rewrite</a></li>
<li><a href="remapping.html">Utilisation de mod_rewrite pour la
redirection et la remise en correspondance avec le système de
fichiers des URLs</a></li>
<li><a href="access.html">Utilisation de mod_rewrite pour le
contrôle d'accès</a></li>
<li><a href="vhosts.html">Les serveurs virtuels dynamiques avec mod_rewrite</a></li>
<li><a href="proxy.html">Les serveurs mandataires dynamiques avec mod_rewrite</a></li>
<li><a href="rewritemap.html">Utilisation de RewriteMap</a></li>
<li><a href="advanced.html">Techniques avancées</a></li>
<li><a href="avoid.html">Quand <strong>NE PAS</strong> utiliser mod_rewrite</a></li>
<li><a href="flags.html">Drapeaux de réécriture</a></li>
<li><a href="tech.html">Détails techniques</a></li>
</ul>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation de
référence de mod_rewrite</a></li><li><a href="../urlmapping.html">Mise en correspondance des URLs
avec le système de fichiers</a></li><li><a href="http://wiki.apache.org/httpd/Rewrite">wiki mod_rewrite
</a></li><li><a href="../glossary.html">Glossaire</a></li></ul></div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/" title="Français"> fr </a> |
<a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/rewrite/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/rewritemap.html.fr.utf8 0000664 0001751 0001751 00000066131 14740503670 023065 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Utilisation de RewriteMap - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Utilisation de RewriteMap</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/rewritemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/rewritemap.html" title="Français"> fr </a></p>
</div>
<p>Ce document est un complément à la <a href="../mod/mod_rewrite.html">documentation de référence</a> du
module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il décrit l'utilisation de la
directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>, et
fournit des exemples pour chacun des différents types de
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p>
<div class="warning">Notez que la plupart de ces exemples ne
fonctionneront pas en l'état dans le contexte de votre configuration
particulière ; vous devez donc vous attacher à les
comprendre, plutôt que de simplement les insérer dans votre
configuration par copier/coller.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#int">int: Fonction interne</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#txt">txt: tables de correspondances au format texte</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rnd">rnd: Fichier texte à valeurs de substitution multiples
choisies de manière aléatoire</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#dbm">dbm: Fichier condensé DBM</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#prg">prg: Programme de réécriture externe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#dbd">dbd ou fastdbd: requête SQL</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#summary">Résumé</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module
mod_rewrite</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en
correspondance</a></li><li><a href="access.html">Contrôle d'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Mise en cache</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</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="introduction" id="introduction">Introduction</a></h2>
<p>
La directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
définit une fonction externe qui peut être appelée depuis une
directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> ou
<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> pour
accomplir une réécriture trop compliquée, ou trop spécialisée pour
être effectuée à partir d'expressions rationnelles. Vous trouverez
ci-dessous les différents types disponibles pour la source de
données, ceux-ci étant par ailleurs énumérés dans la documentation de
référence de <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p>
<p>La syntaxe de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> est la suivante
:</p>
<pre class="prettyprint lang-config">RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em></pre>
<p>L'argument <a id="mapfunc" name="mapfunc"><em>MapName</em></a>
est un nom arbitraire que vous associez à la table de
correspondances, et que vous
pourrez utilisez par la suite dans les directives de réécriture. Les
recherches dans la table de correspondance s'effectuent en
respectant cette syntaxe :</p>
<p class="indent">
<strong>
<code>${</code> <em>nom-map</em> <code>:</code>
<em>clé-recherche</em>
<code>}</code> <br /> <code>${</code> <em>nom-map</em> <code>:</code>
<em>clé-recherche</em> <code>|</code> <em>DefaultValue</em> <code>}</code>
</strong>
</p>
<p>Lorsque cette syntaxe est employée, la table de correspondances
<em>nom-map</em> est consultée et la clé <em>clé-recherche</em>
recherchée. Si la clé est trouvée, la fonction de recherche dans la
table de correspondance est remplacée par <em>SubstValue</em>, ou
par <em>DefaultValue</em> dans le cas contraire, ou par la chaîne
vide si aucune <em>DefaultValue</em> n'a été spécifiée.</p>
<p>Par exemple, vous pouvez définir une directive
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> comme suit :</p>
<pre class="prettyprint lang-config">RewriteMap examplemap "txt:/path/to/file/map.txt"</pre>
<p>Vous pourrez par la suite utiliser cette table de correspondances
dans une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> comme suit :</p>
<pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1}"</pre>
<p>Il est possible de spécifier une valeur par défaut qui sera utilisée
si la recherche dans la table de correspondances est infructueuse :</p>
<pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1|/not_found.html}"</pre>
<div class="note"><h3>Contexte de répertoire et fichiers.htaccess</h3>
<p>
Vous ne pouvez utiliser la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> ni dans
les sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, ni dans les fichiers
<code>.htaccess</code>. Vous devez déclarer la table de correspondances
au niveau du serveur principal ou dans un contexte de serveur virtuel.
En revanche, si vous ne pouvez pas déclarer la table dans une section
<Directory> ou dans un fichier <code>.htaccess</code>, vous
pourrez y faire référence dans ces contextes, une fois cette table
créée.
</p>
</div>
<p>Les sections suivantes décrivent les différents types de tables de
correspondances <em>type-map</em> disponibles, et fournissent des
exemples pour chacun d'entre eux.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="int" id="int">int: Fonction interne</a></h2>
<p>Lorsque le type-map <code>int</code> est spécifié, la source est
une des fonctions RewriteMap internes disponibles. Les développeurs
de modules peuvent fournir des fonctions internes supplémentaires en
les enregistrant via l'API <code>ap_register_rewrite_mapfunc</code>.
Les fonctions fournies par défaut sont :
</p>
<ul>
<li><strong>toupper</strong>:<br />
Met tous les caractères de la clé en majuscules.</li>
<li><strong>tolower</strong>:<br />
Met tous les caractères de la clé en minuscules.</li>
<li><strong>escape</strong>:<br />
Protège les caractères spéciaux de la clé en les
transformant en leur code hexadécimal.</li>
<li><strong>unescape</strong>:<br />
Retraduit les codes hexadécimaux de la clé en caractères
spéciaux.</li>
</ul>
<p>
Pour utiliser une de ces fonctions, créez une
<code>RewriteMap</code> faisant référence à cette fonction int, et
utilisez-la dans votre règle <code>RewriteRule</code> :
</p>
<p> <strong>Redirige un URI vers son équivalent en minuscules</strong></p>
<pre class="prettyprint lang-config">RewriteMap lc int:tolower
RewriteRule "(.*)" "${lc:$1}" [R]</pre>
<div class="note">
<p>Notez que cet exemple n'est fourni qu'à titre d'illustration,
et ne constitue en aucun cas une recommandation. Si vous voulez
rendre des URLs insensibles à la casse, vous devez plutôt vous
tourner vers <code class="module"><a href="../mod/mod_speling.html">mod_speling</a></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="txt" id="txt">txt: tables de correspondances au format texte</a></h2>
<p>Lorsqu'un type-map <code>txt</code> est utilisé, la source-map
est un chemin du système de fichiers vers un fichier de
correspondances au format texte, contenant sur chaque ligne une
paire clé/valeur séparées par un espace. Il est possible d'insérer
des commentaires sous la forme de chaînes commençant par le caractère
'#'.</p>
<p>Voici un exemple d'entrées valides dans un fichier de
correspondances :</p>
<div class="example"><p><code>
# Ligne de commentaires<br />
<strong><em>clé</em> <em>valeur-substitution</em></strong><br />
<strong><em>clé</em> <em>valeur-substitution</em></strong> # commentaire<br />
</code></p></div>
<p>Lorsque la table de correspondance fait l'objet d'une recherche,
la valeur spécifiée est recherchée dans le premier champ, et si elle
est trouvée, la valeur de substitution est renvoyée.</p>
<p>Par exemple, nous pourrions utiliser un fichier de
correspondances pour traduire des noms de produits en identifiants
produits pour obtenir des URLs plus simples à mémoriser, en
utilisant la recette suivante :</p>
<p><strong>Product to ID configuration</strong></p>
<pre class="prettyprint lang-config">RewriteMap product2id "txt:/etc/apache2/productmap.txt"
RewriteRule "^/product/(.*)" "/prods.php?id=${product2id:$1|NOTFOUND}" [PT]</pre>
<p>Nous supposons ici que le script <code>prods.php</code> sait quoi
faire lorsqu'il reçoit un argument <code>id=NOTFOUND</code>, dans
le cas où le produit ne se trouve pas dans la table de
correspondances.</p>
<p>Le fichier <code>/etc/apache2/map-produit.txt</code> contient ce
qui suit :</p>
<div class="example"><h3>Fichier de correspondances Produit - Identifiant</h3><p><code>
##<br />
## map-produit.txt - Fichier de correspondances Produit - Identifiant<br />
##<br />
<br />
TELEVISION 993<br />
STEREO 198<br />
CANNE-A-PECHE 043<br />
BALLON-BASKET 418<br />
TELEPHONE 328
</code></p></div>
<p>Ainsi, lorsqu'une requête pour
<code>http://example.com/produit/TELEVISION</code> arrive, la directive
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> s'applique, et la
requête est transformée en interne en <code>/prods.php?id=993</code>.</p>
<div class="note"><h3>Note: fichiers .htaccess</h3>
L'exemple donné est conçu pour être utilisé dans un contexte de
serveur principal ou de serveur virtuel. Si vous voulez l'utiliser
dans un fichier <code>.htaccess</code>, vous devrez supprimer le
slash de début dans le modèle de réécriture afin que ce dernier
puisse correspondre à toute URL :
<pre class="prettyprint lang-config">RewriteRule "^product/(.*)" "/prods.php?id=${product2id:$1|NOTFOUND}" [PT]</pre>
</div>
<div class="note"><h3>Recherches mises en cache</h3>
<p>
Les clés de recherche sont mises en cache par httpd jusqu'à ce que
le <code>mtime</code> (date de modification) du fichier de
correspondances soit modifié, ou que le serveur httpd soit
redémarré, ce qui améliore les performances pour les tables de
correspondances consultées par de nombreuses requêtes.
</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="rnd" id="rnd">rnd: Fichier texte à valeurs de substitution multiples
choisies de manière aléatoire</a></h2>
<p>Lorsque le type-map spécifié est <code>rnd</code>, la source est
un chemin du système de fichiers vers un fichier de correspondances
au format texte dont chaque ligne contient une clé, et une ou
plusieurs valeurs séparées par le caractère <code>|</code>. Si une
clé convient, une des valeurs correspondantes sera choisie de
manière aléatoire.</p>
<p>Par exemple, vous pouvez utiliser le fichier de correspondances
et les directives suivants pour implémenter une répartition de
charge aléatoire entre plusieurs serveurs d'arrière-plan, par
l'intermédiaire d'un mandataire inverse. Les images sont envoyées
vers un des serveurs de l'ensemble 'statique', tandis que tout le
reste est envoyé vers un des serveurs de l'ensemble 'dynamique'.</p>
<div class="example"><h3>Fichier de correspondances</h3><p><code>
##<br />
## map.txt -- table de réécriture<br />
##<br />
<br />
statique www1|www2|www3|www4<br />
dynamique www5|www6
</code></p></div>
<p><strong>Directives de configuration</strong></p>
<pre class="prettyprint lang-config">RewriteMap servers "rnd:/path/to/file/map.txt"
RewriteRule "^/(.*\.(png|gif|jpg))" "http://${servers:static}/$1" [NC,P,L]
RewriteRule "^/(.*)" "http://${servers:dynamic}/$1" [P,L]</pre>
<p>Ainsi, lorsqu'une image est demandée et que la première règle
convient, <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> recherche la chaîne
<code>statique</code> dans le fichier de correspondances qui
renvoie un des noms de serveurs spécifiés de manière aléatoire,
ce dernier étant utilisé dans la cible de la règle
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>.</p>
<p>Si vous voulez qu'un des serveurs soit plus souvent sollicité que
les autres (par exemple s'il possède plus de mémoire, et peut donc
traiter d'avantage de requêtes), spécifiez-le plusieurs fois dans la
liste des serveurs.</p>
<div class="example"><p><code>
statique www1|www1|www2|www3|www4
</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="dbm" id="dbm">dbm: Fichier condensé DBM</a></h2>
<p>Lorsque le type-map <code>dbm</code> est utilisé, la source est
un chemin du système de fichiers vers un fichier de données DBM
contenant des paires clé/valeur permettant d'effectuer la
correspondance. Le fonctionnement est identique à celui du type-map
<code>txt</code>, mais beaucoup plus rapide car un fichier DBM est
indexé, alors qu'un fichier texte ne l'est pas. L'accès à la clé
recherchée est donc plus rapide.</p>
<p>Vous pouvez éventuellement spécifier un type dbm particulier :</p>
<pre class="prettyprint lang-config">RewriteMap examplemap "dbm=sdbm:/etc/apache/mapfile.dbm"</pre>
<p>Ce type peut être choisi parmi <code>sdbm</code>, <code>gdbm</code>,
<code>ndbm</code> ou <code>db</code>. Il est
cependant recommandé d'utiliser l'utilitaire <a href="../programs/httxt2dbm.html">httxt2dbm</a> fourni avec le
serveur HTTP Apache, car il utilise la bibliothèque DBM appropriée,
à savoir celle qui a été utilisée lors de la compilation de httpd.</p>
<p>Pour créer un fichier dbm, créez tout d'abord un fichier de
correspondances au format texte comme décrit dans la section <a href="#txt">txt</a>. Traitez ensuite ce fichier avec
<code>httxt2dbm</code> :</p>
<div class="example"><p><code>
$ httxt2dbm -i fichier-map.txt -o fichier-map.map
</code></p></div>
<p>Vous pouvez alors faire référence au fichier obtenu dans votre
directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> :</p>
<pre class="prettyprint lang-config">RewriteMap mapname "dbm:/etc/apache/mapfile.map"</pre>
<div class="note">
<p>Notez qu'avec certains types dbm, plusieurs fichiers possédant le
même nom de base sont créés. Par exemple, vous pouvez obtenir deux
fichiers nommés <code>fichier-map.map.dir</code> et
<code>fichier-map.map.pag</code>. Ceci est tout à fait normal, et vous
ne devez utiliser que le nom de base <code>fichier-map.map</code> dans votre
directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p>
</div>
<div class="note"><h3>Mise en cache des recherches</h3>
<p>
Les clés de recherche sont mises en cache par httpd jusqu'à ce que
le <code>mtime</code> (date de modification) du fichier de
correspondances soit modifié, ou que le serveur httpd soit
redémarré, ce qui améliore les performances pour les tables de
correspondances consultées par de nombreuses requêtes.
</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="prg" id="prg">prg: Programme de réécriture externe</a></h2>
<p>Lorque le type-map <code>prg</code> est spécifié, la source est
un chemin du système de fichiers vers un programme exécutable
destiné à effectuer la mise en correspondance. Il peut s'agir d'un
fichier binaire compilé, ou d'un programme en langage interprété
comme Perl ou Python.</p>
<p>Ce programme est lancé une fois au démarrage du serveur HTTP
Apache, puis communique avec le moteur de réécriture via
<code>STDIN</code> et <code>STDOUT</code>. En d'autres termes, pour
chaque recherche de correspondance, il reçoit un argument via
<code>STDIN</code>, et doit renvoyer en guise de réponse une chaîne
terminée par un caractère nouvelle-ligne sur <code>STDOUT</code>. Si
la recherche de correspondance est infructueuse, le programme doit
l'indiquer en retournant la chaîne de quatre caractères
"<code>NULL</code>".</p>
<p>Les programmes de réécriture externes ne sont pas lancés s'il
n'ont pas été définis dans un contexte où la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriteengine">RewriteEngine</a></code> est définie à
<code>on</code>.</p>
<p>Par défaut, les programmes de réécriture externes sont lancés par
l'utilisateur/groupe qui a démarré httpd. Pour changer ce comportement, il
est possible sur les systèmes de style Unix de spécifier un autre couple
utilisateur/groupe via le troisième argument de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>, et ceci au format
<code>utilisateur:groupe</code>.</p>
<p>Cette fonctionnalité utilise le mutex <code>rewrite-map</code>
nécessaire à la fiabilité des communications avec le programme. Le
mécanisme de mutex et le fichier verrou peuvent être définis via la
directive <code class="directive"><a href="../mod/core.html#mutex">Mutex</a></code>.</p>
<p>Voici un exemple simple qui remplace tous les tirets par des
caractères de soulignement dans l'URI de la requête.</p>
<p><strong>Configuration de la réécriture</strong></p>
<pre class="prettyprint lang-config">RewriteMap d2u "prg:/www/bin/dash2under.pl" apache:apache
RewriteRule "-" "${d2u:%{REQUEST_URI}}"</pre>
<p><strong>dash2under.pl</strong></p>
<pre class="prettyprint lang-perl"> #!/usr/bin/perl
$| = 1; # Turn off I/O buffering
while (<STDIN>) {
s/-/_/g; # Remplace tous les tirets par des caractères de soulignement
print $_;
}</pre>
<div class="note"><h3>Mises en garde !</h3>
<ul>
<li>Votre programme doit être le plus
simple possible. Si le programme se bloque, httpd va attendre
indéfiniment une réponse de sa part, et par conséquent ne répondra plus
aux requêtes.</li>
<li>Assurez-vous de bien désactiver la mise en tampon dans votre
programme. En Perl, ceci est effectué à la seconde ligne du script de
l'exemple - <code>$| = 1;</code> - La syntaxe sera bien entendu
différente dans
d'autres langages. Si les entrées/sorties sont mises en tampon, httpd va
attendre une sortie, et va par conséquent se bloquer.</li>
<li>Rappelez-vous qu'il n'existe qu'une copie du programme lancé au
démarrage du serveur, et que toutes les requêtes vont devoir passer par
ce goulot d'étranglement. Ceci peut provoquer des ralentissements
significatifs si de nombreuses requêtes doivent être traitées, ou si le
script lui-même est très lent.</li>
</ul>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="dbd" id="dbd">dbd ou fastdbd: requête SQL</a></h2>
<p>Lorsque le type-map <code>dbd</code> ou <code>fastdbd</code> est
spécifié, la source est une requête SQL SELECT qui reçoit un
argument et renvoie une seule valeur.</p>
<p>Pour que cette requête puisse être exécutée,
<code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> doit être configuré pour attaquer la base
de données concernée.</p>
<p>Ce type-map existe sous deux formes. Avec le type-map
<code>dbd</code>, la requête est exécutée à chaque demande, tandis
qu'avec le type-map <code>fastdbd</code>, les recherches dans la
base de données sont mises en cache en interne. <code>fastdbd</code>
est donc plus efficace et donc plus rapide ; par contre, il ne
tiendra pas compte des modifications apportées à la base de données
jusqu'à ce que le serveur soit redémarré.</p>
<p>Si une requête renvoie plusieurs enregistrements, un de ceux-ci
sera sélectionné aléatoirement.</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">RewriteMap ma-requete "fastdbd:SELECT destination FROM rewrite WHERE source = %s"</pre>
</div>
<div class="note"><h3>Note</h3>
<p>Le nom de la requête est transmis au pilote de base de données en tant
que label pour une requête SQL préparée, et doit donc respecter toutes les
règles imposées par votre base de données (comme la sensibilité à la casse).</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="summary" id="summary">Résumé</a></h2>
<p>La directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> peut apparaître
plusieurs fois. Utilisez une directive
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> pour chaque fonction de mise en
correspondance pour déclarer son fichier de correspondances.</p>
<p>Bien que l'on ne puisse pas <strong>déclarer</strong> de fonction
de mise en correspondance dans un contexte de répertoire (fichier
<code>.htaccess</code> ou section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>), il est
possible d'utiliser cette fonction dans un tel contexte.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/rewritemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/rewritemap.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/rewritemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/advanced.html.en 0000664 0001751 0001751 00000037657 14737241666 021606 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Advanced Techniques with mod_rewrite - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Advanced Techniques with mod_rewrite</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/advanced.html" title="English"> en </a> |
<a href="../fr/rewrite/advanced.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
<a href="../mod/mod_rewrite.html">reference documentation</a>. It provides
a few advanced techniques using mod_rewrite.</p>
<div class="warning">Note that many of these examples won't work unchanged in your
particular server configuration, so it's important that you understand
them, rather than merely cutting and pasting the examples into your
configuration.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#sharding">URL-based sharding across multiple backends</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#on-the-fly-content">On-the-fly Content-Regeneration</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#load-balancing">Load Balancing</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#structuredhomedirs">Structured Userdirs</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirectanchors">Redirecting Anchors</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#time-dependent">Time-Dependent Rewriting</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#setenvvars">Set Environment Variables Based On URL Parts</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="sharding" id="sharding">URL-based sharding across multiple backends</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>A common technique for distributing the burden of
server load or storage space is called "sharding".
When using this method, a front-end server will use the
url to consistently "shard" users or objects to separate
backend servers.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>A mapping is maintained, from users to target servers, in
external map files. They look like:</p>
<div class="example"><p><code>
user1 physical_host_of_user1<br />
user2 physical_host_of_user2<br />
# ... and so on
</code></p></div>
<p>We put this into a <code>map.users-to-hosts</code> file. The
aim is to map;</p>
<div class="example"><p><code>
/u/user1/anypath
</code></p></div>
<p>to</p>
<div class="example"><p><code>
http://physical_host_of_user1/u/user/anypath
</code></p></div>
<p>thus every URL path need not be valid on every backend physical
host. The following ruleset does this for us with the help of the map
files assuming that server0 is a default server which will be used if
a user has no entry in the map:</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap users-to-hosts "txt:/path/to/map.users-to-hosts"
RewriteRule "^/u/([^/]+)/?(.*)" "http://${users-to-hosts:$1|server0}/u/$1/$2"</pre>
</dd>
</dl>
<p>See the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
documentation and the <a href="./rewritemap.html">RewriteMap HowTo</a>
for more discussion of the syntax of this directive.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="on-the-fly-content" id="on-the-fly-content">On-the-fly Content-Regeneration</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>We wish to dynamically generate content, but store it
statically once it is generated. This rule will check for the
existence of the static file, and if it's not there, generate
it. The static files can be removed periodically, if desired (say,
via cron) and will be regenerated on demand.</p>
</dd>
<dt>Solution:</dt>
<dd>
This is done via the following ruleset:
<pre class="prettyprint lang-config"># This example is valid in per-directory context only
RewriteCond "%{REQUEST_URI}" "!-U"
RewriteRule "^(.+)\.html$" "/regenerate_page.cgi" [PT,L]</pre>
<p>The <code>-U</code> operator determines whether the test string
(in this case, <code>REQUEST_URI</code>) is a valid URL. It does
this via a subrequest. In the event that this subrequest fails -
that is, the requested resource doesn't exist - this rule invokes
the CGI program <code>/regenerate_page.cgi</code>, which generates
the requested resource and saves it into the document directory, so
that the next time it is requested, a static copy can be served.</p>
<p>In this way, documents that are infrequently updated can be served in
static form. if documents need to be refreshed, they can be deleted
from the document directory, and they will then be regenerated the
next time they are requested.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="load-balancing" id="load-balancing">Load Balancing</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>We wish to randomly distribute load across several servers
using mod_rewrite.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>We'll use <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> and a list of servers
to accomplish this.</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap lb "rnd:/path/to/serverlist.txt"
RewriteRule "^/(.*)" "http://${lb:servers}/$1" [P,L]</pre>
<p><code>serverlist.txt</code> will contain a list of the servers:</p>
<div class="example"><p><code>
## serverlist.txt<br />
<br />
servers one.example.com|two.example.com|three.example.com<br />
</code></p></div>
<p>If you want one particular server to get more of the load than the
others, add it more times to the list.</p>
</dd>
<dt>Discussion</dt>
<dd>
<p>Apache comes with a load-balancing module -
<code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> - which is far more flexible and
featureful than anything you can cobble together using mod_rewrite.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="structuredhomedirs" id="structuredhomedirs">Structured Userdirs</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>Some sites with thousands of users use a
structured homedir layout, <em>i.e.</em> each homedir is in a
subdirectory which begins (for instance) with the first
character of the username. So, <code>/~larry/anypath</code>
is <code>/home/<strong>l</strong>/larry/public_html/anypath</code>
while <code>/~waldo/anypath</code> is
<code>/home/<strong>w</strong>/waldo/public_html/anypath</code>.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>We use the following ruleset to expand the tilde URLs
into the above layout.</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^/~(<strong>([a-z])</strong>[a-z0-9]+)(.*)" "/home/<strong>$2</strong>/$1/public_html$3"</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirectanchors" id="redirectanchors">Redirecting Anchors</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>By default, redirecting to an HTML anchor doesn't work,
because mod_rewrite escapes the <code>#</code> character,
turning it into <code>%23</code>. This, in turn, breaks the
redirection.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>Use the <code>[NE]</code> flag on the
<code>RewriteRule</code>. NE stands for No Escape.
</p>
</dd>
<dt>Discussion:</dt>
<dd>This technique will of course also work with other
special characters that mod_rewrite, by default, URL-encodes.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="time-dependent" id="time-dependent">Time-Dependent Rewriting</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>We wish to use mod_rewrite to serve different content based on
the time of day.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>There are a lot of variables named <code>TIME_xxx</code>
for rewrite conditions. In conjunction with the special
lexicographic comparison patterns <code><STRING</code>,
<code>>STRING</code> and <code>=STRING</code> we can
do time-dependent redirects:</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteCond "%{TIME_HOUR}%{TIME_MIN}" ">0700"
RewriteCond "%{TIME_HOUR}%{TIME_MIN}" "<1900"
RewriteRule "^foo\.html$" "foo.day.html" [L]
RewriteRule "^foo\.html$" "foo.night.html"</pre>
<p>This provides the content of <code>foo.day.html</code>
under the URL <code>foo.html</code> from
<code>07:01-18:59</code> and at the remaining time the
contents of <code>foo.night.html</code>.</p>
<div class="warning"><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>, intermediate proxies
and browsers may each cache responses and cause the either page to be
shown outside of the time-window configured.
<code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code> may be used to control this
effect. You are, of course, much better off simply serving the
content dynamically, and customizing it based on the time of day.</div>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="setenvvars" id="setenvvars">Set Environment Variables Based On URL Parts</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>At times, we want to maintain some kind of status when we
perform a rewrite. For example, you want to make a note that
you've done that rewrite, so that you can check later to see if a
request came via that rewrite. One way to do this is by setting an
environment variable.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>Use the [E] flag to set an environment variable.</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^/horse/(.*)" "/pony/$1" [E=<strong>rewritten:1</strong>]</pre>
<p>Later in your ruleset you might check for this environment
variable using a RewriteCond:</p>
<pre class="prettyprint lang-config">RewriteCond "%{ENV:rewritten}" "=1"</pre>
<p>Note that environment variables do not survive an external
redirect. You might consider using the [CO] flag to set a
cookie. For per-directory and htaccess rewrites, where the final
substitution is processed as an internal redirect, environment
variables from the previous round of rewriting are prefixed with
"REDIRECT_". </p>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/advanced.html" title="English"> en </a> |
<a href="../fr/rewrite/advanced.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/advanced.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/index.html.en 0000664 0001751 0001751 00000015061 14737241666 021131 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache mod_rewrite - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache mod_rewrite</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/" title="English"> en </a> |
<a href="../fr/rewrite/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/rewrite/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> provides a way to modify incoming
URL requests, dynamically, based on <a href="intro.html#regex">regular
expression</a> rules. This allows you to map arbitrary URLs onto
your internal URL structure in any way you like.</p>
<p>It supports an unlimited number of rules and an
unlimited number of attached rule conditions for each rule to
provide a really flexible and powerful URL manipulation
mechanism. The URL manipulations can depend on various tests:
server variables, environment variables, HTTP
headers, time stamps, external database lookups, and various other
external programs or handlers, can be used to achieve granular URL
matching.</p>
<p>Rewrite rules can operate on the full URLs, including the path-info
and query string portions, and may be used in per-server context
(<code>httpd.conf</code>), per-virtualhost context (<code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> blocks), or
per-directory context (<code>.htaccess</code> files and <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> blocks). The
rewritten result can lead to further rules, internal
sub-processing, external request redirection, or proxy
passthrough, depending on what <a href="flags.html">flags</a> you
attach to the rules.</p>
<p>Since mod_rewrite is so powerful, it can indeed be rather
complex. This document supplements the <a href="../mod/mod_rewrite.html">reference documentation</a>, and
attempts to allay some of that complexity, and provide highly
annotated examples of common scenarios that you may handle with
mod_rewrite. But we also attempt to show you when you should not
use mod_rewrite, and use other standard Apache features instead,
thus avoiding this unnecessary complexity.</p>
<ul>
<li><a href="../mod/mod_rewrite.html">mod_rewrite reference
documentation</a></li>
<li><a href="intro.html">Introduction to regular expressions and mod_rewrite</a></li>
<li><a href="remapping.html">Using mod_rewrite for redirection and remapping of URLs</a></li>
<li><a href="access.html">Using mod_rewrite to control access</a></li>
<li><a href="vhosts.html">Dynamic virtual hosts with mod_rewrite</a></li>
<li><a href="proxy.html">Dynamic proxying with mod_rewrite</a></li>
<li><a href="rewritemap.html">Using RewriteMap</a></li>
<li><a href="advanced.html">Advanced techniques</a></li>
<li><a href="avoid.html">When <strong>NOT</strong> to use mod_rewrite</a></li>
<li><a href="flags.html">RewriteRule Flags</a></li>
<li><a href="tech.html">Technical details</a></li>
</ul>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">mod_rewrite reference
documentation</a></li><li><a href="../urlmapping.html">Mapping URLs to the Filesystem</a></li><li><a href="http://wiki.apache.org/httpd/Rewrite">mod_rewrite
wiki</a></li><li><a href="../glossary.html">Glossary</a></li></ul></div>
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/" title="English"> en </a> |
<a href="../fr/rewrite/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="../zh-cn/rewrite/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/rewritemap.html.en 0000664 0001751 0001751 00000060613 14737241666 022204 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Using RewriteMap - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Using RewriteMap</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/rewritemap.html" title="English"> en </a> |
<a href="../fr/rewrite/rewritemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
<a href="../mod/mod_rewrite.html">reference documentation</a>. It describes
the use of the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive,
and provides examples of each of the various <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> types.</p>
<div class="warning">Note that many of these examples won't work unchanged in your
particular server configuration, so it's important that you understand
them, rather than merely cutting and pasting the examples into your
configuration.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#int">int: Internal Function</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#txt">txt: Plain text maps</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rnd">rnd: Randomized Plain Text</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#dbm">dbm: DBM Hash File</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#prg">prg: External Rewriting Program</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#dbd">dbd or fastdbd: SQL Query</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#summary">Summary</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="introduction" id="introduction">Introduction</a></h2>
<p>
The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive
defines an external function which can be called in the context of
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> or
<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> directives to
perform rewriting that is too complicated, or too specialized to be
performed just by regular expressions. The source of this lookup can
be any of the types listed in the sections below, and enumerated in
the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> reference
documentation.</p>
<p>The syntax of the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
directive is as follows:</p>
<pre class="prettyprint lang-config">RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em>
</pre>
<p>The <a id="mapfunc" name="mapfunc"><em>MapName</em></a> is an
arbitrary name that you assign to the map, and which you will use in
directives later on. Arguments are passed to the map via the
following syntax:</p>
<p class="indent">
<strong>
<code>${</code> <em>MapName</em> <code>:</code> <em>LookupKey</em>
<code>}</code> <br /> <code>${</code> <em>MapName</em> <code>:</code>
<em>LookupKey</em> <code>|</code> <em>DefaultValue</em> <code>}</code>
</strong>
</p>
<p>When such a construct occurs, the map <em>MapName</em> is
consulted and the key <em>LookupKey</em> is looked-up. If the
key is found, the map-function construct is substituted by
<em>SubstValue</em>. If the key is not found then it is
substituted by <em>DefaultValue</em> or by the empty string
if no <em>DefaultValue</em> was specified.</p>
<p>For example, you can define a
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> as:</p>
<pre class="prettyprint lang-config">RewriteMap examplemap "txt:/path/to/file/map.txt"</pre>
<p>You would then be able to use this map in a
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> as follows:</p>
<pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1}"</pre>
<p>A default value can be specified in the event that nothing is found
in the map:</p>
<pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1|/not_found.html}"</pre>
<div class="note"><h3>Per-directory and .htaccess context</h3>
<p>
The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive may not be
used in <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections or
<code>.htaccess</code> files. You must
declare the map in server or virtualhost context. You may use the map,
once created, in your <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> and
<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> directives in those
scopes. You just can't <strong>declare</strong> it in those scopes.</p>
</div>
<p>The sections that follow describe the various <em>MapType</em>s that
may be used, and give examples of each.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="int" id="int">int: Internal Function</a></h2>
<p>When a MapType of <code>int</code> is used, the MapSource is one
of the available internal <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
functions. Module authors can provide
additional internal functions by registering them with the
<code>ap_register_rewrite_mapfunc</code> API.
The functions that are provided by default are:
</p>
<ul>
<li><strong>toupper</strong>:<br />
Converts the key to all upper case.</li>
<li><strong>tolower</strong>:<br />
Converts the key to all lower case.</li>
<li><strong>escape</strong>:<br />
Translates special characters in the key to
hex-encodings.</li>
<li><strong>unescape</strong>:<br />
Translates hex-encodings in the key back to
special characters.</li>
</ul>
<p>
To use one of these functions, create a <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> referencing
the int function, and then use that in your <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>:
</p>
<p> <strong>Redirect a URI to an all-lowercase version of itself</strong></p>
<pre class="prettyprint lang-config">RewriteMap lc int:tolower
RewriteRule "(.*)" "${lc:$1}" [R]</pre>
<div class="note">
<p>Please note that the example offered here is for
illustration purposes only, and is not a recommendation. If you want
to make URLs case-insensitive, consider using
<code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code> instead.
</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="txt" id="txt">txt: Plain text maps</a></h2>
<p>When a MapType of <code>txt</code> is used, the MapSource is a filesystem path to a
plain-text mapping file, containing one space-separated key/value pair
per line. Optionally, a line may contain a comment, starting with
a '#' character.</p>
<p>A valid text rewrite map file will have the following syntax:</p>
<div class="example"><p><code>
# Comment line<br />
<strong><em>MatchingKey</em> <em>SubstValue</em></strong><br />
<strong><em>MatchingKey</em> <em>SubstValue</em></strong> # comment<br />
</code></p></div>
<p>When the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> is invoked
the argument is looked for in the
first argument of a line, and, if found, the substitution value is
returned.</p>
<p>For example, we can use a mapfile to translate product names to
product IDs for easier-to-remember URLs, using the following
recipe:</p>
<p><strong>Product to ID configuration</strong></p>
<pre class="prettyprint lang-config">RewriteMap product2id "txt:/etc/apache2/productmap.txt"
RewriteRule "^/product/(.*)" "/prods.php?id=${product2id:$1|NOTFOUND}" [PT]</pre>
<p>We assume here that the <code>prods.php</code> script knows what
to do when it received an argument of <code>id=NOTFOUND</code> when
a product is not found in the lookup map.</p>
<p>The file <code>/etc/apache2/productmap.txt</code> then contains
the following:</p>
<div class="example"><h3>Product to ID map</h3><p><code>
##<br />
## productmap.txt - Product to ID map file<br />
##<br />
<br />
television 993<br />
stereo 198<br />
fishingrod 043<br />
basketball 418<br />
telephone 328
</code></p></div>
<p>Thus, when <code>http://example.com/product/television</code> is
requested, the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> is
applied, and the request
is internally mapped to <code>/prods.php?id=993</code>.</p>
<div class="note"><h3>Note: .htaccess files</h3>
The example given is crafted to be used in server or virtualhost
scope. If you're planning to use this in a <code>.htaccess</code>
file, you'll need to remove the leading slash from the rewrite
pattern in order for it to match anything:
<pre class="prettyprint lang-config">RewriteRule "^product/(.*)" "/prods.php?id=${product2id:$1|NOTFOUND}" [PT]</pre>
</div>
<div class="note"><h3>Cached lookups</h3>
<p>
The looked-up keys are cached by httpd until the <code>mtime</code>
(modified time) of the mapfile changes, or the httpd server is
restarted. This ensures better performance on maps that are called
by many requests.
</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="rnd" id="rnd">rnd: Randomized Plain Text</a></h2>
<p>When a MapType of <code>rnd</code> is used, the MapSource is a
filesystem path to a plain-text mapping file, each line of which
contains a key, and one or more values separated by <code>|</code>.
One of these values will be chosen at random if the key is
matched.</p>
<p>For example, you can use the following map
file and directives to provide a random load balancing between
several back-end servers, via a reverse-proxy. Images are sent
to one of the servers in the 'static' pool, while everything
else is sent to one of the 'dynamic' pool.</p>
<div class="example"><h3>Rewrite map file</h3><p><code>
##<br />
## map.txt -- rewriting map<br />
##<br />
<br />
static www1|www2|www3|www4<br />
dynamic www5|www6
</code></p></div>
<p><strong>Configuration directives</strong></p>
<pre class="prettyprint lang-config">RewriteMap servers "rnd:/path/to/file/map.txt"
RewriteRule "^/(.*\.(png|gif|jpg))" "http://${servers:static}/$1" [NC,P,L]
RewriteRule "^/(.*)" "http://${servers:dynamic}/$1" [P,L]</pre>
<p>So, when an image is requested and the first of these rules is
matched, <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> looks up the string
<code>static</code> in the map file, which returns one of the
specified hostnames at random, which is then used in the
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> target.</p>
<p>If you wanted to have one of the servers more likely to be chosen
(for example, if one of the server has more memory than the others,
and so can handle more requests) simply list it more times in the
map file.</p>
<div class="example"><p><code>
static www1|www1|www2|www3|www4
</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="dbm" id="dbm">dbm: DBM Hash File</a></h2>
<p>When a MapType of <code>dbm</code> is used, the MapSource is a
filesystem path to a DBM database file containing key/value pairs to
be used in the mapping. This works exactly the same way as the
<code>txt</code> map, but is much faster, because a DBM is indexed,
whereas a text file is not. This allows more rapid access to the
desired key.</p>
<p>You may optionally specify a particular dbm type:</p>
<pre class="prettyprint lang-config">RewriteMap examplemap "dbm=sdbm:/etc/apache/mapfile.dbm"</pre>
<p>The type can be <code>sdbm</code>, <code>gdbm</code>, <code>ndbm</code>
or <code>db</code>.
However, it is recommended that you just use the <a href="../programs/httxt2dbm.html">httxt2dbm</a> utility that is
provided with Apache HTTP Server, as it will use the correct DBM library,
matching the one that was used when httpd itself was built.</p>
<p>To create a dbm file, first create a text map file as described
in the <a href="#txt">txt</a> section. Then run
<code>httxt2dbm</code>:</p>
<div class="example"><p><code>
$ httxt2dbm -i mapfile.txt -o mapfile.map
</code></p></div>
<p>You can then reference the resulting file in your
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive:</p>
<pre class="prettyprint lang-config">RewriteMap mapname "dbm:/etc/apache/mapfile.map"</pre>
<div class="note">
<p>Note that with some dbm types, more than one file is generated, with
a common base name. For example, you may have two files named
<code>mapfile.map.dir</code> and <code>mapfile.map.pag</code>. This is
normal, and you need only use the base name <code>mapfile.map</code> in
your <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive.</p>
</div>
<div class="note"><h3>Cached lookups</h3>
<p>
The looked-up keys are cached by httpd until the <code>mtime</code>
(modified time) of the mapfile changes, or the httpd server is
restarted. This ensures better performance on maps that are called
by many requests.
</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="prg" id="prg">prg: External Rewriting Program</a></h2>
<p>When a MapType of <code>prg</code> is used, the MapSource is a
filesystem path to an executable program which will providing the
mapping behavior. This can be a compiled binary file, or a program
in an interpreted language such as Perl or Python.</p>
<p>This program is started once, when the Apache HTTP Server is
started, and then communicates with the rewriting engine via
<code>STDIN</code> and <code>STDOUT</code>. That is, for each map
function lookup, it expects one argument via <code>STDIN</code>, and
should return one new-line terminated response string on
<code>STDOUT</code>. If there is no corresponding lookup value, the
map program should return the four-character string
"<code>NULL</code>" to indicate this.</p>
<p>External rewriting programs are not started if they're defined in
a context that does not have <code class="directive"><a href="../mod/mod_rewrite.html#rewriteengine">RewriteEngine</a></code> set to
<code>on</code>.</p>
<p>By default, external rewriting programs are run as the
user:group who started httpd. This can be changed on UNIX systems
by passing user name and group name as third argument to
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> in the
<code>username:groupname</code> format.</p>
<p>This feature utilizes the <code>rewrite-map</code> mutex,
which is required for reliable communication with the program.
The mutex mechanism and lock file can be configured with the
<code class="directive"><a href="../mod/core.html#mutex">Mutex</a></code> directive.</p>
<p>A simple example is shown here which will replace all dashes with
underscores in a request URI.</p>
<p><strong>Rewrite configuration</strong></p>
<pre class="prettyprint lang-config">RewriteMap d2u "prg:/www/bin/dash2under.pl" apache:apache
RewriteRule "-" "${d2u:%{REQUEST_URI}}"</pre>
<p><strong>dash2under.pl</strong></p>
<pre class="prettyprint lang-perl">#!/usr/bin/perl
$| = 1; # Turn off I/O buffering
while (<STDIN>) {
s/-/_/g; # Replace dashes with underscores
print $_;
}</pre>
<div class="note"><h3>Caution!</h3>
<ul>
<li>Keep your rewrite map program as simple as possible. If the program
hangs, it will cause httpd to wait indefinitely for a response from the
map, which will, in turn, cause httpd to stop responding to
requests.</li>
<li>Be sure to turn off buffering in your program. In Perl this is done
by the second line in the example script: <code>$| = 1;</code> This will
of course vary in other languages. Buffered I/O will cause httpd to wait
for the output, and so it will hang.</li>
<li>Remember that there is only one copy of the program, started at
server startup. All requests will need to go through this one bottleneck.
This can cause significant slowdowns if many requests must go through
this process, or if the script itself is very slow.</li>
</ul>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="dbd" id="dbd">dbd or fastdbd: SQL Query</a></h2>
<p>When a MapType of <code>dbd</code> or <code>fastdbd</code> is
used, the MapSource is a SQL SELECT statement that takes a single
argument and returns a single value.</p>
<p><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> will need to be configured to point at
the right database for this statement to be executed.</p>
<p>There are two forms of this MapType.
Using a MapType of <code>dbd</code> causes the query to be
executed with each map request, while using <code>fastdbd</code>
caches the database lookups internally. So, while
<code>fastdbd</code> is more efficient, and therefore faster, it
won't pick up on changes to the database until the server is
restarted.</p>
<p>If a query returns more than one row, a random row from
the result set is used.</p>
<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">RewriteMap myquery "fastdbd:SELECT destination FROM rewrite WHERE source = %s"</pre>
</div>
<div class="note"><h3>Note</h3>
<p>The query name is passed to the database driver as a label for
an SQL prepared statement, and will therefore need to follow any rules
(such as case-sensitivity) required for your database.</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="summary" id="summary">Summary</a></h2>
<p>The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive can
occur more than once. For each mapping-function use one
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive to declare
its rewriting mapfile.</p>
<p>While you cannot <strong>declare</strong> a map in
per-directory context (<code>.htaccess</code> files or
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> blocks) it is
possible to <strong>use</strong> this map in per-directory context.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/rewritemap.html" title="English"> en </a> |
<a href="../fr/rewrite/rewritemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/rewritemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/remapping.html.fr.utf8 0000664 0001751 0001751 00000074311 14740503670 022667 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Redirection et remise en correspondance avec mod_rewrite - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Redirection et remise en correspondance avec mod_rewrite</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/remapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/remapping.html" title="Français"> fr </a></p>
</div>
<p>Ce document est un complément à la <a href="../mod/mod_rewrite.html">Documentation de référence</a> de
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il montre comment utiliser
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour rediriger et remettre en
correspondance une requête. Il contient de
nombreux exemples d'utilisation courante de mod_rewrite avec une
description détaillée de leur fonctionnement.</p>
<div class="warning">Vous devez vous attacher à comprendre le
fonctionnement des exemples, car la plupart d'entre eux ne
fonctionneront pas sur votre système si vous vous contentez de les
copier/coller dans vos fichiers de configuration.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#old-to-new">De l'ancienne à la nouvelle URL (en interne)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#old-to-new-extern">De l'ancien au nouveau (en externe)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#movehomedirs">Ressource déplacée vers un autre serveur</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#static-to-dynamic">De statique à dynamique</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#backward-compatibility">Compatibilité ascendante dans le cadre d'une modification
d'extension de nom de fichier</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#canonicalhost">Noms d'hôtes canoniques</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multipledirs">Recherche de pages dans plus d'un répertoire</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#archive-access-multiplexer">Redirection vers des serveurs géographiquement distribués</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#browser-dependent-content">Contenu dépendant du navigateur</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#canonicalurl">URLs canoniques</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moveddocroot">Déplacement du répertoire <code>DocumentRoot</code></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#fallback-resource">Ressource par défaut</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewrite-query">Rewrite query string</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module mod_rewrite</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="access.html">Contrôler l'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Serveurs mandataires</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</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="old-to-new" id="old-to-new">De l'ancienne à la nouvelle URL (en interne)</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Supposons que nous ayons récemment renommé la page
<code>foo.html</code> en <code>bar.html</code>, et voulions
maintenant que l'ancienne URL soit toujours valide à des fins
de compatibilité ascendante. En fait, on voudrait que le
changement de nom soit transparent aux utilisateurs de
l'ancienne URL.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>On réécrit l'ancienne URL en interne vers la nouvelle via
la règle suivante :</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^<strong>/foo</strong>\.html$" "<strong>/bar</strong>.html" [PT]</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="old-to-new-extern" id="old-to-new-extern">De l'ancien au nouveau (en externe)</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Supposons toujours que nous ayons récemment renommé la page
<code>foo.html</code> en <code>bar.html</code>, et voulions
maintenant que l'ancienne URL soit toujours valide à des fins
de compatibilité ascendante. En revanche, nous voulons cette
fois que la nouvelle URL soit suggérée aux utilisateurs de
l'ancienne URL, c'est à dire que l'adresse vue depuis leur
navigateur doit également être modifiée.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>On force une redirection HTTP vers la nouvelle URL, ce qui
entraîne une modification de celle du navigateur et aussi de ce
que voit l'utilisateur :</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^<strong>foo</strong>\.html$" "<strong>bar</strong>.html" [<strong>R</strong>]</pre>
</dd>
<dt>Discussion</dt>
<dd>
<p>Dans l'exemple <a href="#old-to-new-intern">interne</a>, on a utilisé mod_rewrite afin
de dissimuler la redirection au client. Dans cet exemple, en
revanche, on aurait pu se contenter d'une directive Redirect :</p>
<pre class="prettyprint lang-config">Redirect "/foo.html" "/bar.html"</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="movehomedirs" id="movehomedirs">Ressource déplacée vers un autre serveur</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Si une ressource a été déplacée vers un autre serveur, vous
pouvez faire en sorte que les URLs de l'ancien serveur continuent
de fonctionner pendant un certain temps, afin de laisser au
utilisateurs le temps de modifier leurs favoris.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>Vous pouvez utiliser <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour
rediriger ces URLs vers le nouveau serveur, mais vous pouvez aussi
utiliser les directives Redirect ou RedirectMatch.</p>
<pre class="prettyprint lang-config">#Avec mod_rewrite
RewriteEngine on
RewriteRule "^/docs/(.+)" "http://nouveau.example.com/docs/$1" [R,L]</pre>
<pre class="prettyprint lang-config">#Avec RedirectMatch
RedirectMatch "^/docs/(.*)" "http://nouveau.example.com/docs/$1"</pre>
<pre class="prettyprint lang-config">#Avec Redirect
Redirect "/docs/" "http://nouveau.example.com/docs/"</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="static-to-dynamic" id="static-to-dynamic">De statique à dynamique</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Comment transformer une page statique <code>foo.html</code>
en sa variante dynamique <code>foo.cgi</code> de manière
transparente, c'est à dire sans en avertir le
navigateur/utilisateur.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>On réécrit simplement l'URL en script CGI et force le
gestionnaire de contenu à <strong>cgi-script</strong> de façon
à ce que le script s'exécute en tant que programme CGI.
Ainsi, une requête vers <code>/~quux/foo.html</code> conduit
en interne à l'invocation de
<code>/~quux/foo.cgi</code>.</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteBase "/~quux/"
RewriteRule "^foo\.html$" "foo.cgi" [H=<strong>cgi-script</strong>]</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="backward-compatibility" id="backward-compatibility">Compatibilité ascendante dans le cadre d'une modification
d'extension de nom de fichier</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Comment conférer une compatibilité ascendante aux URLs
(existant encore virtuellement) après avoir migré
<code>document.YYYY</code> vers <code>document.XXXX</code>,
c'est à dire après avoir par exemple traduit un lot de
fichiers <code>.html</code> en fichiers <code>.php</code>
?</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>On réécrit simplement le nom du fichier en son nom
de base et vérifie s'il existe aussi avec la nouvelle
extension. Si c'est le cas, on utilise ce nom, sinon on
réécrit l'URL sous sa forme originale.</p>
<pre class="prettyprint lang-config"># jeu de règles assurant une compatibilité ascendante en réécrivant<br />
# document.html en document.php si et seulement si document.php<br />
# existe
<Directory "/var/www/htdocs">
RewriteEngine on
RewriteBase "/var/www/htdocs"
RewriteCond "$1.php" -f
RewriteCond "$1.html" !-f
RewriteRule "^(.*).html$" "$1.php"
</Directory></pre>
</dd>
<dt>Discussion</dt>
<dd>
<p>Cet exemple utilise une fonctionnalité souvent méconnue de
mod_rewrite, en tirant avantage de l'ordre d'exécution du jeu de
règles. En particulier, mod_rewrite évalue la partie gauche des
règles de réécriture avant d'évaluer les directives RewriteCond. En
conséquence, $1 est déjà défini au moment où les directives
RewriteCond sont évaluées. Ceci nous permet de tester l'existence du
fichier original (<code>document.html</code>) et du fichier cible
(<code>document.php</code>) en utilisant le même nom de base.</p>
<p>Ce jeu de règles est conçu pour une utilisation dans un contexte
de répertoire (au sein d'une section <Directory> ou d'un
fichier .htaccess), de façon à ce que les vérifications
<code>-f</code> effectuent leurs recherches dans le bon répertoire.
Vous serez peut-être amené à définir une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code> pour spécifier le
répertoire de base à partir duquel vous travaillez.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="canonicalhost" id="canonicalhost">Noms d'hôtes canoniques</a></h2>
<dl>
<dt>Description :</dt>
<dd>Le but de cette règle est de préférer l'utilisation d'un nom
d'hôte particulier à d'autres noms d'hôte utilisables
pour atteindre le même site. Par exemple, si vous voulez
utiliser <strong>www.example.com</strong> à la place de
<strong>example.com</strong>, vous pouvez utiliser une solution
du style :</dd>
<dt>Solution :</dt>
<dd>
<p>Pour y parvenir, il vaut mieux se passer de mod_rewrite, et utiliser
plutôt la directive <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code> dans
une section de serveur virtuel pour le/les noms d'hôte non canoniques.</p>
<pre class="prettyprint lang-config"><VirtualHost *:80>
ServerName undesired.example.com
ServerAlias example.com notthis.example.com
Redirect "/" "http://www.example.com/"
</VirtualHost>
<VirtualHost *:80>
ServerName www.example.com
</VirtualHost></pre>
<p>Vous pouvez aussi utiliser la directive <code class="directive"><a href="../mod/core.html#if"><If></a></code> :</p>
<pre class="prettyprint lang-config"><If "%{HTTP_HOST} != 'www.example.com'">
Redirect "/" "http://www.example.com/"
</If></pre>
<p>Ou, par exemple, pour rediriger une portion de votre site vers HTTPS
:</p>
<pre class="prettyprint lang-config"><If "%{SERVER_PROTOCOL} != 'HTTPS'">
Redirect "/admin/" "https://www.example.com/admin/"
</If></pre>
<p>Si, pour une raison particulière, vous voulez tout de même utiliser
<code>mod_rewrite</code> - dans le cas, par exemple, où vous avez besoin
d'un jeu plus important de règles de réécritures - vous pouvez utiliser
la recette suivante :</p>
<p>Pour les sites écoutant sur un port autre que 80:</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_HOST}" "!^www\.example\.com" [NC]
RewriteCond "%{HTTP_HOST}" "!^$"
RewriteCond "%{SERVER_PORT}" "!^80$"
RewriteRule "^/?(.*)" "http://www.example.com:%{SERVER_PORT}/$1" [L,R,NE]</pre>
<p>Et pour un site écoutant sur le port 80</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_HOST}" "!^www\.example\.com" [NC]
RewriteCond "%{HTTP_HOST}" "!^$"
RewriteRule "^/?(.*)" "http://www.example.com/$1" [L,R,NE]</pre>
<p>
Si vous souhaitez que cette règle s'applique à tous les noms de
domaine - en d'autres termes, si vous voulez rediriger
<strong>example.com</strong> vers
<strong>www.example.com</strong> pour toutes les valeurs
possibles de <strong>example.com</strong>, vous pouvez utiliser
le jeu de règles suivants :</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_HOST}" "!^www\." [NC]
RewriteCond "%{HTTP_HOST}" "!^$"
RewriteRule "^/?(.*)" "http://www.%{HTTP_HOST}/$1" [L,R,NE]</pre>
<p>
Vous pouvez utiliser ce jeu de règles aussi bien dans le fichier
de configuration de votre serveur principal que dans un fichier
<code>.htaccess</code> placé dans le répertoire défini par la
directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> du serveur.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="multipledirs" id="multipledirs">Recherche de pages dans plus d'un répertoire</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>Une ressource peut exister dans plusieurs répertoires, et nous
voulons rechercher cette ressource dans ces répertoires
lorsqu'elle fait l'objet d'une requête. Il est possible que nous
ayons récemment réorganisé la structure de notre site en
répartissant son contenu dans plusieurs répertoires.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>Le jeu de règles suivant recherche la ressource dans deux
répertoires, et s'il ne la trouve dans aucun des deux, il tentera
simplement de la servir à partir de l'adresse fournie dans la
requête.</p>
<pre class="prettyprint lang-config">RewriteEngine on
# on cherche tout d'abord dans dir1/...
# ... et si on trouve, on est content et on arrête :
RewriteCond "%{DOCUMENT_ROOT}/<strong>dir1</strong>/%{REQUEST_URI}" -f
RewriteRule "^(.+)" "%{DOCUMENT_ROOT}/<strong>dir1</strong>/$1" [L]
# on cherche ensuite dans dir2/...
# ... et si on trouve, on est content et on arrête :
RewriteCond "%{DOCUMENT_ROOT}/<strong>dir2</strong>/%{REQUEST_URI}" -f
RewriteRule "^(.+)" "%{DOCUMENT_ROOT}/<strong>dir2</strong>/$1" [L]
# sinon, on continue la recherche avec d'autres directives Alias
# ou ScriptAlias, etc...
RewriteRule "^" "-" [PT]</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="archive-access-multiplexer" id="archive-access-multiplexer">Redirection vers des serveurs géographiquement distribués</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Notre site web possède de nombreux miroirs, et nous voulons
rediriger les utilisateurs vers celui qui se situe dans le pays où
ils se trouvent. </p>
</dd>
<dt>Solution :</dt>
<dd>
<p>En consultant le nom d'hôte du client demandeur, on détermine le
pays dans lequel il se trouve. S'il est impossible d'effectuer une
recherche sur leur adresse IP, on se rabat sur un serveur par
défaut.</p>
<p>Nous allons utiliser une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> afin de construire une
liste des serveurs que nous voulons utiliser.</p>
<pre class="prettyprint lang-config">HostnameLookups on
RewriteEngine on
RewriteMap multiplex "txt:/path/to/map.mirrors"
RewriteCond "%{REMOTE_HOST}" "([a-z]+)$ [NC]"
RewriteRule "^/(.*)$" "${multiplex:<strong>%1</strong>|http://www.example.com/}$1" [R,L]</pre>
<div class="example"><p><code>
## liste_miroirs -- Table de correspondance pays - serveurs<br />
<br />
de http://www.exemple.de/<br />
uk http://www.exemple.uk/<br />
com http://www.example.com/<br />
##EOF##
</code></p></div>
</dd>
<dt>Discussion</dt>
<dd>
<div class="warning">Ce jeu de règles nécessite la définition à
<code>on</code> de la directive <code class="directive"><a href="../mod/core.html#hostnamelookups">HostNameLookups</a></code>, ce qui peut induire une
baisse de performance significative.</div>
<p>La directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> extrait la dernière
partie du nom d'hôte du client demandeur - le code du pays - et la
règle de réécriture qui suit utilise cette valeur pour rechercher le
serveur miroir approprié dans le fichier de correspondances.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="browser-dependent-content" id="browser-dependent-content">Contenu dépendant du navigateur</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Nous voulons fournir des contenus différents en fonction du
navigateur (user-agent) qui effectue la requête.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>Nous devons déterminer quel contenu servir, en nous basant
sur l'en-tête HTTP "User-Agent". La
configuration suivante effectue ceci : si l'en-tête HTTP
"User-Agent" commence par "Mozilla/3", le nom de la page
<code>foo.html</code> est réécrit en <code>foo.NS.html</code>
et la réécriture s'arrête. Si le navigateur est "Lynx" ou
"Mozilla" version 1 ou 2, l'URL devient
<code>foo.20.html</code>. Tous les autres navigateurs
reçoivent la page <code>foo.32.html</code>. Tout ceci est
effectué par le jeu de règles suivant :</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_USER_AGENT}" "^<strong>Mozilla/3</strong>.*"
RewriteRule "^foo\.html$" "foo.<strong>NS</strong>.html" [<strong>L</strong>]
RewriteCond "%{HTTP_USER_AGENT}" "^Lynx/" [OR]
RewriteCond "%{HTTP_USER_AGENT}" "^Mozilla/[12]"
RewriteRule "^foo\.html$" "foo.<strong>20</strong>.html" [<strong>L</strong>]
RewriteRule "^foo\.html$" "foo.<strong>32</strong>.html" [<strong>L</strong>]</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="canonicalurl" id="canonicalurl">URLs canoniques</a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>Sur certains serveurs, une ressource peut posséder plusieurs
URLs. Il y a en général les URLs canoniques (celles qui sont
réellement distribuées et utilisées), et celles qui correspondent à
des raccourcis, les URLs internes, etc... Quelle que soit l'adresse
que l'utilisateur fournit dans la requête, il devrait finalement
voir l'URL canonique dans la barre d'adresse de son navigateur.</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>Nous effectuons une redirection HTTP externe pour toutes les
URLs non canoniques afin de les corriger dans la barre d'adresse
du navigateur, et ceci pour toutes les requêtes futures. Dans le
jeu de règles suivant, nous remplaçons <code>/matous</code> et
<code>/minettes</code> par le canonique <code>/chats</code>.</p>
<pre class="prettyprint lang-config">RewriteRule "^/(matous|minettes)/(.*)" "/chats/$2" [R]</pre>
</dd>
<dt>Discussion :</dt>
<dd>On serait mieux inspiré d'utiliser ici les directives Redirect ou
RedirectMatch :
<pre class="prettyprint lang-config">RedirectMatch "^/(matous|minettes)/(.*)" "/chats/$2"</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moveddocroot" id="moveddocroot">Déplacement du répertoire <code>DocumentRoot</code></a></h2>
<dl>
<dt>Description :</dt>
<dd>
<p>En général, le répertoire <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> du serveur web correspond à l'URL
"<code>/</code>". Ce répertoire ne contient cependant pas forcément des
ressources de première importance pour l'utilisateur. Par exemple, vous
préférerez peut-être que le répertoire d'accueil d'un visiteur accédant
pour la première fois à votre site soit un répertoire particulier
<code>/a-propos-de/</code>. Pour y parvenir, utilisez le jeu de règles
suivant :</p>
</dd>
<dt>Solution :</dt>
<dd>
<p>On redirige l'URL <code>/</code> vers
<code>/a-propos-de/</code> :
</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^/$" "/a-propos-de/" [<strong>R</strong>]</pre>
<p>Notez que l'on peut aussi y parvenir en utilisant la directive
<code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> :</p>
<pre class="prettyprint lang-config">RedirectMatch "^/$" "http://example.com/a-propos-de/"</pre>
<p>Notez aussi que cet exemple ne réécrit que l'URL racine. En d'autres
termes, il réécrit une requête pour <code>http://example.com/</code>,
mais pas pour une requête <code>http://example.com/page.html</code>. Si
vous avez effectivement modifié la racine de vos documents - c'est à dire
si <strong>tous</strong> vos contenus se trouvent dans un
sous-répertoire, il est largement préférable de modifier simplement
votre directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, ou de
déplacer l'ensemble du contenu vers le répertoire supérieur, plutôt que
de réécrire les URLs.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="fallback-resource" id="fallback-resource">Ressource par défaut</a></h2>
<dl>
<dt>Description :</dt>
<dd>Vous voulez qu'une seule ressource (disons un certain fichier tel
que index.php) soit servie pour toutes les requêtes à destination d'un
certain répertoire, sauf pour celles qui concernent une ressource
existant effectivement comme une image, ou un fichier css.</dd>
<dt>Solution :</dt>
<dd>
<p>Depuis la version 2.2.16, vous pouvez y parvenir via la directive
<code class="directive"><a href="../mod/mod_dir.html#fallbackresource">FallbackResource</a></code> :</p>
<pre class="prettyprint lang-config"><Directory "/var/www/my_blog">
FallbackResource "index.php"
</Directory></pre>
<p>Cependant, si vos besoins étaient plus complexes, vous pouviez, dans
les versions plus anciennes d'Apache, utiliser un jeu de règles du style
:</p>
<pre class="prettyprint lang-config"><Directory "/var/www/my_blog">
RewriteBase "/my_blog"
RewriteCond "/var/www/my_blog/%{REQUEST_FILENAME}" !-f
RewriteCond "/var/www/my_blog/%{REQUEST_FILENAME}" !-d
RewriteRule "^" "index.php" [PT]
</Directory></pre>
<p>D'autre part, si vous voulez transmettre l'URI de la requête en tant
que chaîne de paramètres à index.php, vous pouvez remplacer cette règle
de réécriture par :</p>
<pre class="prettyprint lang-config">RewriteRule "(.*)" "index.php?$1" [PT,QSA]</pre>
<p>Notez que l'on peut utiliser ces jeux de règles aussi bien dans un
fichier <code>.htaccess</code> que dans une section
<Directory>.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite-query" id="rewrite-query">Rewrite query string</a></h2>
<dl>
<dt>Description :</dt>
<dd>Vous voulez extraire une valeur particulière d'une chaîne de
paramètres d'une URL, et soit la remplacer, soit l'incorporer dans un
autre composant de l'URL.</dd>
<dt>Solutions :</dt>
<dd>
<p>Dans la plupart des solutions de cette section, on utilise la même
condition qui stocke la valeur recherchée dans la référence arrière %2.
%1 est le début de la requête, et %3 ce qui reste. Cette condition est
un peu complexe car elle introduit de la flexibilité et évite les
doubles perluettes '&&' dans les substitutions.</p>
<ul>
<li>Cette solution supprime le couple clé/valeur recherché :
<pre class="prettyprint lang-config"># Remove mykey=???
RewriteCond "%{QUERY_STRING}" "(.*(?:^|&))mykey=([^&]*)&?(.*)&?$"
RewriteRule "(.*)" "$1?%1%3"</pre>
</li>
<li>Cette solution remplace la partie de l'URL qui suit la valeur
recherchée par un '?' :
<pre class="prettyprint lang-config"># Copy from query string to PATH_INFO
RewriteCond "%{QUERY_STRING}" "(.*(?:^|&))mykey=([^&]*)&?(.*)&?$"
RewriteRule "(.*)" "$1/products/%2/?" [PT]</pre>
</li>
<li>Cette solution utilise la valeur recherchée dans une deuxième
condition ::
<pre class="prettyprint lang-config"># Capture the value of mykey in the query string
RewriteCond "%{QUERY_STRING}" "(.*(?:^|&))mykey=([^&]*)&?(.*)&?$""
RewriteCond "%2" !=not-so-secret-value
RewriteRule "(.*)" - [F]</pre>
</li>
<li>Cette solution produit l'effet inverse des précédentes ; elle
copie des composantes du chemin (peut-être PATH_INFO) depuis l'URL
vers sa chaîne de paramètres :
<pre class="prettyprint lang-config"># The desired URL might be /products/kitchen-sink, and the script expects
# /path?products=kitchen-sink.
RewriteRule "^/?path/([^/]+)/([^/]+)" "/path?$1=$2" [PT]</pre>
</li>
</ul>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/remapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/remapping.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/remapping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/access.html.en 0000664 0001751 0001751 00000034216 14737241666 021266 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Using mod_rewrite to control access - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Using mod_rewrite to control access</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/access.html" title="English"> en </a> |
<a href="../fr/rewrite/access.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
<a href="../mod/mod_rewrite.html">reference documentation</a>. It describes
how you can use <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> to control access to
various resources, and other related techniques.
This includes many examples of common uses of mod_rewrite,
including detailed descriptions of how each works.</p>
<div class="warning">Note that many of these examples won't work unchanged in your
particular server configuration, so it's important that you understand
them, rather than merely cutting and pasting the examples into your
configuration.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#blocked-inline-images">Forbidding Image "Hotlinking"</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#blocking-of-robots">Blocking of Robots</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#host-deny">Denying Hosts in a Reject List</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#referer-deflector">Referer-based Deflector</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="blocked-inline-images" id="blocked-inline-images">Forbidding Image "Hotlinking"</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>The following technique forbids the practice of other sites
including your images inline in their pages. This practice is
often referred to as "hotlinking", and results in
your bandwidth being used to serve content for someone else's
site.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>This technique relies on the value of the
<code>HTTP_REFERER</code> variable, which is optional. As
such, it's possible for some people to circumvent this
limitation. However, most users will experience the failed
request, which should, over time, result in the image being
removed from that other site.</p>
<p>There are several ways that you can handle this
situation.</p>
<p>In this first example, we simply deny the request, if it didn't
initiate from a page on our site. For the purpose of this example,
we assume that our site is <code>www.example.com</code>.</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_REFERER}" "!^$"
RewriteCond "%{HTTP_REFERER}" "!www.example.com" [NC]
RewriteRule "\.(gif|jpg|png)$" "-" [F,NC]</pre>
<p>In this second example, instead of failing the request, we display
an alternate image instead.</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_REFERER}" "!^$"
RewriteCond "%{HTTP_REFERER}" "!www.example.com" [NC]
RewriteRule "\.(gif|jpg|png)$" "/images/go-away.png" [R,NC]</pre>
<p>In the third example, we redirect the request to an image on some
other site.</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_REFERER}" "!^$"
RewriteCond "%{HTTP_REFERER}" "!www.example.com" [NC]
RewriteRule "\.(gif|jpg|png)$" "http://other.example.com/image.gif" [R,NC]</pre>
<p>Of these techniques, the last two tend to be the most effective
in getting people to stop hotlinking your images, because they will
simply not see the image that they expected to see.</p>
</dd>
<dt>Discussion:</dt>
<dd>
<p>If all you wish to do is deny access to the resource, rather
than redirecting that request elsewhere, this can be
accomplished without the use of mod_rewrite:</p>
<pre class="prettyprint lang-config">SetEnvIf Referer "example\.com" localreferer
<FilesMatch "\.(jpg|png|gif)$">
Require env localreferer
</FilesMatch></pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="blocking-of-robots" id="blocking-of-robots">Blocking of Robots</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>
In this recipe, we discuss how to block persistent requests from
a particular robot, or user agent.</p>
<p>The standard for robot exclusion defines a file,
<code>/robots.txt</code> that specifies those portions of your
website where you wish to exclude robots. However, some robots
do not honor these files.
</p>
<p>Note that there are methods of accomplishing this which do
not use mod_rewrite. Note also that any technique that relies on
the clients <code>USER_AGENT</code> string can be circumvented
very easily, since that string can be changed.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>We use a ruleset that specifies the directory to be
protected, and the client <code>USER_AGENT</code> that
identifies the malicious or persistent robot.</p>
<p>In this example, we are blocking a robot called
<code>NameOfBadRobot</code> from a location
<code>/secret/files</code>. You may also specify an IP address
range, if you are trying to block that user agent only from the
particular source.</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_USER_AGENT}" "^NameOfBadRobot"
RewriteCond "%{REMOTE_ADDR}" "=123\.45\.67\.[8-9]"
RewriteRule "^/secret/files/" "-" [F]</pre>
</dd>
<dt>Discussion:</dt>
<dd>
<p>
Rather than using mod_rewrite for this, you can accomplish the
same end using alternate means, as illustrated here:
</p>
<pre class="prettyprint lang-config">SetEnvIfNoCase User-Agent "^NameOfBadRobot" goaway
<Location "/secret/files">
<RequireAll>
Require all granted
Require not env goaway
</RequireAll>
</Location></pre>
<p>
As noted above, this technique is trivial to circumvent, by simply
modifying the <code>USER_AGENT</code> request header. If you
are experiencing a sustained attack, you should consider blocking
it at a higher level, such as at your firewall.
</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="host-deny" id="host-deny">Denying Hosts in a Reject List</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>We wish to maintain a list of hosts, rather like
<code>hosts.deny</code>, and have those hosts blocked from
accessing our server.</p>
</dd>
<dt>Solution:</dt>
<dd>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteMap hosts-deny "txt:/path/to/hosts.deny"
RewriteCond "${hosts-deny:%{REMOTE_ADDR}|NOT-FOUND}" "!=NOT-FOUND" [OR]
RewriteCond "${hosts-deny:%{REMOTE_HOST}|NOT-FOUND}" "!=NOT-FOUND"
RewriteRule "^" "-" [F]</pre>
<div class="example"><p><code>
##<br />
## hosts.deny<br />
##<br />
## ATTENTION! This is a map, not a list, even when we treat it as such.<br />
## mod_rewrite parses it for key/value pairs, so at least a<br />
## dummy value "-" must be present for each entry.<br />
##<br />
<br />
193.102.180.41 -<br />
bsdti1.sdm.de -<br />
192.76.162.40 -<br />
</code></p></div>
</dd>
<dt>Discussion:</dt>
<dd>
<p>
The second RewriteCond assumes that you have HostNameLookups turned
on, so that client IP addresses will be resolved. If that's not the
case, you should drop the second RewriteCond, and drop the
<code>[OR]</code> flag from the first RewriteCond.
</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="referer-deflector" id="referer-deflector">Referer-based Deflector</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>Redirect requests based on the Referer from which the request
came, with different targets per Referer.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>The following ruleset uses a map file to associate each Referer
with a redirection target.</p>
<pre class="prettyprint lang-config">RewriteMap deflector "txt:/path/to/deflector.map"
RewriteCond "%{HTTP_REFERER}" !=""
RewriteCond "${deflector:%{HTTP_REFERER}}" "=-"
RewriteRule "^" "%{HTTP_REFERER}" [R,L]
RewriteCond "%{HTTP_REFERER}" !=""
RewriteCond "${deflector:%{HTTP_REFERER}|NOT-FOUND}" "!=NOT-FOUND"
RewriteRule "^" "${deflector:%{HTTP_REFERER}}" [R,L]</pre>
<p>The map file lists redirection targets for each referer, or, if
we just wish to redirect back to where they came from, a "-" is
placed in the map:</p>
<pre class="prettyprint lang-config">##
## deflector.map
##
http://badguys.example.com/bad/index.html -
http://badguys.example.com/bad/index2.html -
http://badguys.example.com/bad/index3.html http://somewhere.example.com/</pre>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/access.html" title="English"> en </a> |
<a href="../fr/rewrite/access.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/access.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/htaccess.html.en 0000664 0001751 0001751 00000012763 14737241666 021625 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_rewrite and .htaccess files - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>mod_rewrite and .htaccess files</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/htaccess.html" title="English"> en </a> |
<a href="../fr/rewrite/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
<a href="../mod/mod_rewrite.html">reference documentation</a>. It describes
the way that the rules change when you use mod_rewrite in .htaccess files,
and how to deal with these changes.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</a></li></ul></div>
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/htaccess.html" title="English"> en </a> |
<a href="../fr/rewrite/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/htaccess.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/remapping.html.en 0000664 0001751 0001751 00000070042 14737241666 022004 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Redirecting and Remapping with mod_rewrite - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Redirecting and Remapping with mod_rewrite</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/remapping.html" title="English"> en </a> |
<a href="../fr/rewrite/remapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
<a href="../mod/mod_rewrite.html">reference documentation</a>. It describes
how you can use <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> to redirect and remap
request. This includes many examples of common uses of mod_rewrite,
including detailed descriptions of how each works.</p>
<div class="warning">Note that many of these examples won't work unchanged in your
particular server configuration, so it's important that you understand
them, rather than merely cutting and pasting the examples into your
configuration.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#old-to-new">From Old to New (internal)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#old-to-new-extern">Rewriting From Old to New (external)</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#movehomedirs">Resource Moved to Another Server</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#static-to-dynamic">From Static to Dynamic</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#backward-compatibility">Backward Compatibility for file extension change</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#canonicalhost">Canonical Hostnames</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multipledirs">Search for pages in more than one directory</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#archive-access-multiplexer">Redirecting to Geographically Distributed Servers</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#browser-dependent-content">Browser Dependent Content</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#canonicalurl">Canonical URLs</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#moveddocroot">Moved <code>DocumentRoot</code></a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#fallback-resource">Fallback Resource</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewrite-query">Rewrite query string</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="old-to-new" id="old-to-new">From Old to New (internal)</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>Assume we have recently renamed the page
<code>foo.html</code> to <code>bar.html</code> and now want
to provide the old URL for backward compatibility. However,
we want that users of the old URL even not recognize that
the pages was renamed - that is, we don't want the address to
change in their browser.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>We rewrite the old URL to the new one internally via the
following rule:</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^<strong>/foo</strong>\.html$" "<strong>/bar</strong>.html" [PT]</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="old-to-new-extern" id="old-to-new-extern">Rewriting From Old to New (external)</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>Assume again that we have recently renamed the page
<code>foo.html</code> to <code>bar.html</code> and now want
to provide the old URL for backward compatibility. But this
time we want that the users of the old URL get hinted to
the new one, i.e. their browsers Location field should
change, too.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>We force a HTTP redirect to the new URL which leads to a
change of the browsers and thus the users view:</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^<strong>/foo</strong>\.html$" "<strong>bar</strong>.html" [<strong>R</strong>]</pre>
</dd>
<dt>Discussion</dt>
<dd>
<p>In this example, as contrasted to the <a href="#old-to-new-intern">internal</a> example above, we can simply
use the Redirect directive. mod_rewrite was used in that earlier
example in order to hide the redirect from the client:</p>
<pre class="prettyprint lang-config">Redirect "/foo.html" "/bar.html"</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="movehomedirs" id="movehomedirs">Resource Moved to Another Server</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>If a resource has moved to another server, you may wish to have
URLs continue to work for a time on the old server while people
update their bookmarks.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>You can use <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> to redirect these URLs
to the new server, but you might also consider using the Redirect
or RedirectMatch directive.</p>
<pre class="prettyprint lang-config">#With mod_rewrite
RewriteEngine on
RewriteRule "^/docs/(.+)" "http://new.example.com/docs/$1" [R,L]</pre>
<pre class="prettyprint lang-config">#With RedirectMatch
RedirectMatch "^/docs/(.*)" "http://new.example.com/docs/$1"</pre>
<pre class="prettyprint lang-config">#With Redirect
Redirect "/docs/" "http://new.example.com/docs/"</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="static-to-dynamic" id="static-to-dynamic">From Static to Dynamic</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>How can we transform a static page
<code>foo.html</code> into a dynamic variant
<code>foo.cgi</code> in a seamless way, i.e. without notice
by the browser/user.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>We just rewrite the URL to the CGI-script and force the
handler to be <strong>cgi-script</strong> so that it is
executed as a CGI program.
This way a request to <code>/~quux/foo.html</code>
internally leads to the invocation of
<code>/~quux/foo.cgi</code>.</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteBase "/~quux/"
RewriteRule "^foo\.html$" "foo.cgi" [H=<strong>cgi-script</strong>]</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="backward-compatibility" id="backward-compatibility">Backward Compatibility for file extension change</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>How can we make URLs backward compatible (still
existing virtually) after migrating <code>document.YYYY</code>
to <code>document.XXXX</code>, e.g. after translating a
bunch of <code>.html</code> files to <code>.php</code>?</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>We rewrite the name to its basename and test for
existence of the new extension. If it exists, we take
that name, else we rewrite the URL to its original state.</p>
<pre class="prettyprint lang-config"># backward compatibility ruleset for
# rewriting document.html to document.php
# when and only when document.php exists
<Directory "/var/www/htdocs">
RewriteEngine on
RewriteBase "/var/www/htdocs"
RewriteCond "$1.php" -f
RewriteCond "$1.html" !-f
RewriteRule "^(.*).html$" "$1.php"
</Directory></pre>
</dd>
<dt>Discussion</dt>
<dd>
<p>This example uses an often-overlooked feature of mod_rewrite,
by taking advantage of the order of execution of the ruleset. In
particular, mod_rewrite evaluates the left-hand-side of the
RewriteRule before it evaluates the RewriteCond directives.
Consequently, $1 is already defined by the time the RewriteCond
directives are evaluated. This allows us to test for the existence
of the original (<code>document.html</code>) and target
(<code>document.php</code>) files using the same base filename.</p>
<p>This ruleset is designed to use in a per-directory context (In a
<Directory> block or in a .htaccess file), so that the
<code>-f</code> checks are looking at the correct directory path.
You may need to set a <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code> directive to specify the
directory base that you're working in.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="canonicalhost" id="canonicalhost">Canonical Hostnames</a></h2>
<dl>
<dt>Description:</dt>
<dd>The goal of this rule is to force the use of a particular
hostname, in preference to other hostnames which may be used to
reach the same site. For example, if you wish to force the use
of <strong>www.example.com</strong> instead of
<strong>example.com</strong>, you might use a variant of the
following recipe.</dd>
<dt>Solution:</dt>
<dd>
<p>The very best way to solve this doesn't involve mod_rewrite at all,
but rather uses the <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code>
directive placed in a virtual host for the non-canonical
hostname(s).</p>
<pre class="prettyprint lang-config"><VirtualHost *:80>
ServerName undesired.example.com
ServerAlias example.com notthis.example.com
Redirect "/" "http://www.example.com/"
</VirtualHost>
<VirtualHost *:80>
ServerName www.example.com
</VirtualHost></pre>
<p>You can alternatively accomplish this using the
<code class="directive"><a href="../mod/core.html#if"><If></a></code>
directive:</p>
<pre class="prettyprint lang-config"><If "%{HTTP_HOST} != 'www.example.com'">
Redirect "/" "http://www.example.com/"
</If></pre>
<p>Or, for example, to redirect a portion of your site to HTTPS, you
might do the following:</p>
<pre class="prettyprint lang-config"><If "%{SERVER_PROTOCOL} != 'HTTPS'">
Redirect "/admin/" "https://www.example.com/admin/"
</If></pre>
<p>If, for whatever reason, you still want to use <code>mod_rewrite</code>
- if, for example, you need this to work with a larger set of RewriteRules -
you might use one of the recipes below.</p>
<p>For sites running on a port other than 80:</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_HOST}" "!^www\.example\.com" [NC]
RewriteCond "%{HTTP_HOST}" "!^$"
RewriteCond "%{SERVER_PORT}" "!^80$"
RewriteRule "^/?(.*)" "http://www.example.com:%{SERVER_PORT}/$1" [L,R,NE]</pre>
<p>And for a site running on port 80</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_HOST}" "!^www\.example\.com" [NC]
RewriteCond "%{HTTP_HOST}" "!^$"
RewriteRule "^/?(.*)" "http://www.example.com/$1" [L,R,NE]</pre>
<p>
If you wanted to do this generically for all domain names - that
is, if you want to redirect <strong>example.com</strong> to
<strong>www.example.com</strong> for all possible values of
<strong>example.com</strong>, you could use the following
recipe:</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_HOST}" "!^www\." [NC]
RewriteCond "%{HTTP_HOST}" "!^$"
RewriteRule "^/?(.*)" "http://www.%{HTTP_HOST}/$1" [L,R,NE]</pre>
<p>These rulesets will work either in your main server configuration
file, or in a <code>.htaccess</code> file placed in the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> of the server.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="multipledirs" id="multipledirs">Search for pages in more than one directory</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>A particular resource might exist in one of several places, and
we want to look in those places for the resource when it is
requested. Perhaps we've recently rearranged our directory
structure, dividing content into several locations.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>The following ruleset searches in two directories to find the
resource, and, if not finding it in either place, will attempt to
just serve it out of the location requested.</p>
<pre class="prettyprint lang-config">RewriteEngine on
# first try to find it in dir1/...
# ...and if found stop and be happy:
RewriteCond "%{DOCUMENT_ROOT}/<strong>dir1</strong>/%{REQUEST_URI}" -f
RewriteRule "^(.+)" "%{DOCUMENT_ROOT}/<strong>dir1</strong>/$1" [L]
# second try to find it in dir2/...
# ...and if found stop and be happy:
RewriteCond "%{DOCUMENT_ROOT}/<strong>dir2</strong>/%{REQUEST_URI}" -f
RewriteRule "^(.+)" "%{DOCUMENT_ROOT}/<strong>dir2</strong>/$1" [L]
# else go on for other Alias or ScriptAlias directives,
# etc.
RewriteRule "^" "-" [PT]</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="archive-access-multiplexer" id="archive-access-multiplexer">Redirecting to Geographically Distributed Servers</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>We have numerous mirrors of our website, and want to redirect
people to the one that is located in the country where they are
located.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>Looking at the hostname of the requesting client, we determine
which country they are coming from. If we can't do a lookup on their
IP address, we fall back to a default server.</p>
<p>We'll use a <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
directive to build a list of servers that we wish to use.</p>
<pre class="prettyprint lang-config">HostnameLookups on
RewriteEngine on
RewriteMap multiplex "txt:/path/to/map.mirrors"
RewriteCond "%{REMOTE_HOST}" "([a-z]+)$" [NC]
RewriteRule "^/(.*)$" "${multiplex:<strong>%1</strong>|http://www.example.com/}$1" [R,L]</pre>
<div class="example"><p><code>
## map.mirrors -- Multiplexing Map<br />
<br />
de http://www.example.de/<br />
uk http://www.example.uk/<br />
com http://www.example.com/<br />
##EOF##
</code></p></div>
</dd>
<dt>Discussion</dt>
<dd>
<div class="warning">This ruleset relies on
<code class="directive"><a href="../mod/core.html#hostnamelookups">HostNameLookups</a></code>
being set <code>on</code>, which can be
a significant performance hit.</div>
<p>The <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
directive captures the last portion of the hostname of the
requesting client - the country code - and the following RewriteRule
uses that value to look up the appropriate mirror host in the map
file.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="browser-dependent-content" id="browser-dependent-content">Browser Dependent Content</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>We wish to provide different content based on the browser, or
user-agent, which is requesting the content.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>We have to decide, based on the HTTP header "User-Agent",
which content to serve. The following config
does the following: If the HTTP header "User-Agent"
contains "Mozilla/3", the page <code>foo.html</code>
is rewritten to <code>foo.NS.html</code> and the
rewriting stops. If the browser is "Lynx" or "Mozilla" of
version 1 or 2, the URL becomes <code>foo.20.html</code>.
All other browsers receive page <code>foo.32.html</code>.
This is done with the following ruleset:</p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_USER_AGENT}" "^<strong>Mozilla/3</strong>.*"
RewriteRule "^foo\.html$" "foo.<strong>NS</strong>.html" [<strong>L</strong>]
RewriteCond "%{HTTP_USER_AGENT}" "^Lynx/" [OR]
RewriteCond "%{HTTP_USER_AGENT}" "^Mozilla/[12]"
RewriteRule "^foo\.html$" "foo.<strong>20</strong>.html" [<strong>L</strong>]
RewriteRule "^foo\.html$" "foo.<strong>32</strong>.html" [<strong>L</strong>]</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="canonicalurl" id="canonicalurl">Canonical URLs</a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>On some webservers there is more than one URL for a
resource. Usually there are canonical URLs (which are be
actually used and distributed) and those which are just
shortcuts, internal ones, and so on. Independent of which URL the
user supplied with the request, they should finally see the
canonical one in their browser address bar.</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>We do an external HTTP redirect for all non-canonical
URLs to fix them in the location view of the Browser and
for all subsequent requests. In the example ruleset below
we replace <code>/puppies</code> and <code>/canines</code>
by the canonical <code>/dogs</code>.</p>
<pre class="prettyprint lang-config">RewriteRule "^/(puppies|canines)/(.*)" "/dogs/$2" [R]</pre>
</dd>
<dt>Discussion:</dt>
<dd>
This should really be accomplished with Redirect or RedirectMatch
directives:
<pre class="prettyprint lang-config">RedirectMatch "^/(puppies|canines)/(.*)" "/dogs/$2"</pre>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="moveddocroot" id="moveddocroot">Moved <code>DocumentRoot</code></a></h2>
<dl>
<dt>Description:</dt>
<dd>
<p>Usually the <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
of the webserver directly relates to the URL "<code>/</code>".
But often this data is not really of top-level priority. For example,
you may wish for visitors, on first entering a site, to go to a
particular subdirectory <code>/about/</code>. This may be accomplished
using the following ruleset:</p>
</dd>
<dt>Solution:</dt>
<dd>
<p>We redirect the URL <code>/</code> to
<code>/about/</code>:
</p>
<pre class="prettyprint lang-config">RewriteEngine on
RewriteRule "^/$" "/about/" [<strong>R</strong>]</pre>
<p>Note that this can also be handled using the <code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> directive:</p>
<pre class="prettyprint lang-config">RedirectMatch "^/$" "http://example.com/about/"</pre>
<p>Note also that the example rewrites only the root URL. That is, it
rewrites a request for <code>http://example.com/</code>, but not a
request for <code>http://example.com/page.html</code>. If you have in
fact changed your document root - that is, if <strong>all</strong> of
your content is in fact in that subdirectory, it is greatly preferable
to simply change your <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>
directive, or move all of the content up one directory,
rather than rewriting URLs.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="fallback-resource" id="fallback-resource">Fallback Resource</a></h2>
<dl>
<dt>Description:</dt>
<dd>You want a single resource (say, a certain file, like index.php) to
handle all requests that come to a particular directory, except those
that should go to an existing resource such as an image, or a css file.</dd>
<dt>Solution:</dt>
<dd>
<p>As of version 2.2.16, you should use the <code class="directive"><a href="../mod/mod_dir.html#fallbackresource">FallbackResource</a></code> directive for this:</p>
<pre class="prettyprint lang-config"><Directory "/var/www/my_blog">
FallbackResource "index.php"
</Directory></pre>
<p>However, in earlier versions of Apache, or if your needs are more
complicated than this, you can use a variation of the following rewrite
set to accomplish the same thing:</p>
<pre class="prettyprint lang-config"><Directory "/var/www/my_blog">
RewriteBase "/my_blog"
RewriteCond "/var/www/my_blog/%{REQUEST_FILENAME}" !-f
RewriteCond "/var/www/my_blog/%{REQUEST_FILENAME}" !-d
RewriteRule "^" "index.php" [PT]
</Directory></pre>
<p>If, on the other hand, you wish to pass the requested URI as a query
string argument to index.php, you can replace that RewriteRule with:</p>
<pre class="prettyprint lang-config">RewriteRule "(.*)" "index.php?$1" [PT,QSA]</pre>
<p>Note that these rulesets can be used in a <code>.htaccess</code>
file, as well as in a <Directory> block.</p>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite-query" id="rewrite-query">Rewrite query string</a></h2>
<dl>
<dt>Description:</dt>
<dd>You want to capture a particular value from a query string
and either replace it or incorporate it into another component
of the URL.</dd>
<dt>Solutions:</dt>
<dd>
<p> Many of the solutions in this section will all use the same condition,
which leaves the matched value in the %2 backreference. %1 is the beginining
of the query string (up to the key of intererest), and %3 is the remainder. This
condition is a bit complex for flexibility and to avoid double '&&' in the
substitutions.</p>
<ul>
<li>This solution removes the matching key and value:
<pre class="prettyprint lang-config"># Remove mykey=???
RewriteCond "%{QUERY_STRING}" "(.*(?:^|&))mykey=([^&]*)&?(.*)&?$"
RewriteRule "(.*)" "$1?%1%3"</pre>
</li>
<li>This solution uses the captured value in the URL substitution,
discarding the rest of the original query by appending a '?':
<pre class="prettyprint lang-config"># Copy from query string to PATH_INFO
RewriteCond "%{QUERY_STRING}" "(.*(?:^|&))mykey=([^&]*)&?(.*)&?$"
RewriteRule "(.*)" "$1/products/%2/?" [PT]</pre>
</li>
<li>This solution checks the captured value in a subsequent condition:
<pre class="prettyprint lang-config"># Capture the value of mykey in the query string
RewriteCond "%{QUERY_STRING}" "(.*(?:^|&))mykey=([^&]*)&?(.*)&?$"
RewriteCond "%2" !=not-so-secret-value
RewriteRule "(.*)" - [F]</pre>
</li>
<li>This solution shows the reverse of the previous ones, copying
path components (perhaps PATH_INFO) from the URL into the query string.
<pre class="prettyprint lang-config"># The desired URL might be /products/kitchen-sink, and the script expects
# /path?products=kitchen-sink.
RewriteRule "^/?path/([^/]+)/([^/]+)" "/path?$1=$2" [PT]</pre>
</li>
</ul>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/remapping.html" title="English"> en </a> |
<a href="../fr/rewrite/remapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/remapping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/advanced.html 0000664 0001751 0001751 00000000317 13710016232 021137 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: advanced.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: advanced.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/index.html 0000664 0001751 0001751 00000000571 13710016232 020503 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: index.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: index.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: index.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
URI: index.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/access.html 0000664 0001751 0001751 00000000313 13710016232 020627 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: access.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: access.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/htaccess.html 0000664 0001751 0001751 00000000317 13710016232 021167 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: htaccess.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: htaccess.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/rewrite/tech.html.en 0000664 0001751 0001751 00000031516 14737241666 020750 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache mod_rewrite Technical Details - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="../images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Apache mod_rewrite Technical Details</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/tech.html" title="English"> en </a> |
<a href="../fr/rewrite/tech.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document discusses some of the technical details of mod_rewrite
and URL matching.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#InternalAPI">API Phases</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#InternalRuleset">Ruleset Processing</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="InternalAPI" id="InternalAPI">API Phases</a></h2>
<p>The Apache HTTP Server handles requests in several phases. At
each of these phases, one or more modules may be called upon to
handle that portion of the request lifecycle. Phases include things
like URL-to-filename translation, authentication, authorization,
content, and logging. (This is not an exhaustive list.)</p>
<p>mod_rewrite acts in two of these phases (or "hooks", as they are
often called) to influence how URLs may be rewritten.</p>
<p>First, it uses the URL-to-filename translation hook, which occurs
after the HTTP request has been read, but before any authorization
starts. Secondly, it uses the Fixup hook, which is after the
authorization phases, and after per-directory configuration files
(<code>.htaccess</code> files) have been read, but before the
content handler is called.</p>
<p>So, after a request comes in and a corresponding server or
virtual host has been determined, the rewriting engine starts
processing any <code>mod_rewrite</code> directives appearing in the
per-server configuration. (i.e., in the main server configuration file
and <code class="directive"><a href="../mod/core.html#virtualhost"><Virtualhost></a></code>
sections.) This happens in the URL-to-filename phase.</p>
<p>A few steps later, once the final data directories have been found,
the per-directory configuration directives (<code>.htaccess</code>
files and <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> blocks) are applied. This
happens in the Fixup phase.</p>
<p>In each of these cases, mod_rewrite rewrites the
<code>REQUEST_URI</code> either to a new URL, or to a filename.</p>
<p>In per-directory context (i.e., within <code>.htaccess</code> files
and <code>Directory</code> blocks), these rules are being applied
after a URL has already been translated to a filename. Because of
this, the URL-path that mod_rewrite initially compares <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directives against
is the full filesystem path to the translated filename with the current
directories path (including a trailing slash) removed from the front.</p>
<p> To illustrate: If rules are in /var/www/foo/.htaccess and a request
for /foo/bar/baz is being processed, an expression like ^bar/baz$ would
match.</p>
<p> If a substitution is made in per-directory context, a new internal
subrequest is issued with the new URL, which restarts processing of the
request phases. If the substitution is a relative path, the <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code> directive
determines the URL-path prefix prepended to the substitution.
In per-directory context, care must be taken to
create rules which will eventually (in some future "round" of per-directory
rewrite processing) not perform a substitution to avoid looping.
(See <a href="http://wiki.apache.org/httpd/RewriteLooping">RewriteLooping</a>
for further discussion of this problem.)</p>
<p>Because of this further manipulation of the URL in per-directory
context, you'll need to take care to craft your rewrite rules
differently in that context. In particular, remember that the
leading directory path will be stripped off of the URL that your
rewrite rules will see. Consider the examples below for further
clarification.</p>
<table class="bordered">
<tr>
<th>Location of rule</th>
<th>Rule</th>
</tr>
<tr>
<td>VirtualHost section</td>
<td>RewriteRule "^/images/(.+)\.jpg" "/images/$1.gif"</td>
</tr>
<tr>
<td>.htaccess file in document root</td>
<td>RewriteRule "^images/(.+)\.jpg" "images/$1.gif"</td>
</tr>
<tr>
<td>.htaccess file in images directory</td>
<td>RewriteRule "^(.+)\.jpg" "$1.gif"</td>
</tr>
</table>
<p>For even more insight into how mod_rewrite manipulates URLs in
different contexts, you should consult the <a href="../mod/mod_rewrite.html#logging">log entries</a> made during
rewriting.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="InternalRuleset" id="InternalRuleset">Ruleset Processing</a></h2>
<p>Now when mod_rewrite is triggered in these two API phases, it
reads the configured rulesets from its configuration
structure (which itself was either created on startup for
per-server context or during the directory walk of the Apache
kernel for per-directory context). Then the URL rewriting
engine is started with the contained ruleset (one or more
rules together with their conditions). The operation of the
URL rewriting engine itself is exactly the same for both
configuration contexts. Only the final result processing is
different.</p>
<p>The order of rules in the ruleset is important because the
rewriting engine processes them in a special (and not very
obvious) order. The rule is this: The rewriting engine loops
through the ruleset rule by rule (<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directives) and
when a particular rule matches it optionally loops through
existing corresponding conditions (<code>RewriteCond</code>
directives). For historical reasons the conditions are given
first, and so the control flow is a little bit long-winded. See
Figure 1 for more details.</p>
<p class="figure">
<img src="../images/rewrite_process_uri.png" alt="Flow of RewriteRule and RewriteCond matching" /><br />
<dfn>Figure 1:</dfn>The control flow through the rewriting ruleset
</p>
<p>First the URL is matched against the
<em>Pattern</em> of each rule. If it fails, mod_rewrite
immediately stops processing this rule, and continues with the
next rule. If the <em>Pattern</em> matches, mod_rewrite looks
for corresponding rule conditions (RewriteCond directives,
appearing immediately above the RewriteRule in the configuration).
If none are present, it substitutes the URL with a new value, which is
constructed from the string <em>Substitution</em>, and goes on
with its rule-looping. But if conditions exist, it starts an
inner loop for processing them in the order that they are
listed. For conditions, the logic is different: we don't match
a pattern against the current URL. Instead we first create a
string <em>TestString</em> by expanding variables,
back-references, map lookups, <em>etc.</em> and then we try
to match <em>CondPattern</em> against it. If the pattern
doesn't match, the complete set of conditions and the
corresponding rule fails. If the pattern matches, then the
next condition is processed until no more conditions are
available. If all conditions match, processing is continued
with the substitution of the URL with
<em>Substitution</em>.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/tech.html" title="English"> en </a> |
<a href="../fr/rewrite/tech.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/tech.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/rewrite/flags.html 0000664 0001751 0001751 00000000311 13710016232 020460 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: flags.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: flags.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/mpm.html.ko.euc-kr 0000664 0001751 0001751 00000023427 14743132254 020320 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ó (MPM) - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>ó (MPM)</h1>
<div class="toplang">
<p><span> : </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> ó (Multi-Processing Module) ̸,
ġ ̸ ϴ Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Ұ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#choosing">MPM ϱ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#defaults">MPM ⺻</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="introduction" id="introduction">Ұ</a></h2>
<p>ġ پ ȯ پ ÷
ֵ ϰ ϰ Ǿ. ٸ ÷ ٸ
ȯ ٸ 䱸ϸ, ȿ
ϴ ٸ ִ. ġ ȭ ̷
پ ȯ濡 ؿԴ. ʹ Ͻ
Ȥ о Ͽ
ִ.</p>
<p>Apache 2.0 ̷ ȭ 踦 ⺻
κп Ȯߴ. ý Ʈ Ʈ ϰ,
û Ƶ̸, Ƶ û óϱ ڽĵ鿡
йϴ ó (Multi-Processing Modules, MPMs)
ִ.</p>
<p> ȭϸ ΰ ߿
ִ:</p>
<ul>
<li><code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code> Apache 1.3
POSIX ü Ʈ ִ ,
ġ پ ü ϰ ȿ
ִ. Ưȭ MPM ٸ
ü ȴ.</li>
<li> Ư Ʈ 䱸ǿ Ưȭ ִ.
Ȯ尡ɼ(scalability) ʿ Ʈ
<code class="module"><a href="./mod/worker.html">worker</a></code> MPM ϰ,
Ʈ ȣȯ ʿ Ʈ
<code class="module"><a href="./mod/prefork.html">prefork</a></code>ing MPM ִ.
߰ ٸ ھ̵ ȣƮ ϴ
(<code class="module"><a href="./mod/perchild.html">perchild</a></code>) Ư ɵ
ȴ.</li>
</ul>
<p>ڰ MPM ٸ ġ
δ. ֵ ̴ ѹ MPM ؾ
Ѵٴ ̴. 밡 MPM <a href="mod/">
</a> ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="choosing" id="choosing">MPM ϱ</a></h2>
<p>MPMs ߿ Ͽ ϵǾ Ѵ.
带 ϴ Ϸ ˸ Լ
ȭ ִ. н MPM 带
ƴϹǷ, MPM ߿ õǾ ġ
ϵɶ ġ ӵ .</p>
<p>ϴ MPM Ϸ ./configure ũƮ
with-mpm= <em>NAME</em> ƱԸƮ ϶. <em>NAME</em>
ϴ MPM ̸̴.</p>
<p> <code>./httpd -l</code> ɾ
MPM ִ. ɾ MPM Ͽ ϵ
˷ش.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="defaults" id="defaults">MPM ⺻</a></h2>
<p> ǥ ü ⺻ MPM ش. Ͻ
ٸ MPM õȴ.</p>
<table>
<tr><td>BeOS</td><td><code class="module"><a href="./mod/beos.html">beos</a></code></td></tr>
<tr><td>Netware</td><td><code class="module"><a href="./mod/mpm_netware.html">mpm_netware</a></code></td></tr>
<tr><td>OS/2</td><td><code class="module"><a href="./mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
<tr><td>н</td><td><code class="module"><a href="./mod/prefork.html">prefork</a></code></td></tr>
<tr><td></td><td><code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mpm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_0.html.pt-br 0000664 0001751 0001751 00000042627 14743132254 022107 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="pt-br" xml:lang="pt-br"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Descrição das novas funcionalidades do Apache 2.0 - Servidor HTTP Apache Versão 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Diretrizes</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossário</a> | <a href="./sitemap.html">Mapa do site</a></p>
<p class="apache">Servidor HTTP Apache Versão 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentação</a> > <a href="./">Versão 2.4</a></div><div id="page-content"><div id="preamble"><h1>Descrição das novas funcionalidades do Apache 2.0</h1>
<div class="toplang">
<p><span>Línguas Disponíveis: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Esta tradução pode estar desatualizada.
Confira a versão em Inglês para mudanças recentes.</div>
<p>Esse documento descreve algumas das mudanças principais
entre as versões 1.3 e 2.0 do Servidor HTTP Apache.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Principais Melhorias</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Melhorias nos Módulos</a></li>
</ul><h3>Veja também</h3><ul class="seealso"><li><a href="upgrading.html">Atualizando da versão 1.3 para 2.0</a></li><li><a href="#comments_section">Comentários</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="core" id="core">Principais Melhorias</a></h2>
<dl>
<dt>Threading Unix</dt>
<dd>Em sistemas Unix com suporte a threads POSIX, o Apache pode
funcionar em modo híbrido multiprocesso e multithread. Não funciona
em todas configurações, mas melhora a escalabilidade em muitas.</dd>
<dt>Novo Sistema de Compilação</dt>
<dd>O sistema de compilação foi reescrito do zero para utilizar o
<code>autoconf</code> e o <code>libtool</code>, tornando a
configuração do sistema Apache mais similar a de outros
pacotes.</dd>
<dt>Suporte Multi-protocolo</dt>
<dd>O Apache possui agora uma infraestrutura feita para suportar
múltiplos protocolos. O módulo <code class="module"><a href="./mod/mod_echo.html">mod_echo</a></code> é um
exemplo ilustrativo de sua utilização.</dd>
<dt>Suporte Aperfeiçoado para Plataformas Não-Unix</dt>
<dd>O Apache 2.0 está mais rápido e mais estável em plataformas
Não-Unix como BeOS, OS/2 e Windows. Com a introdução de módulos
<a href="mpm.html">multi-processamento</a> (MPMs) específicos e a
Apache Portable Runtime (APR), essas plataformas estão implementando
as suas APIs nativas, evitando as camadas de emulação POSIX que se
mostravam lentas e defeituosas.</dd>
<dt>Nova API Apache</dt>
<dd>A API para módulos mudou significativamente na versão 2.0.
Muitos dos problemas de ordenamento/prioridade da versão
1.3 foram resolvidos. A versão 2.0 faz o ordenamento automático
"per-hook" para permitir mais flexibilidade. Novas chamadas foram
adicionadas para fornecer capacidades adicionais sem a necessidade
de se aplicar nenhum patch ao servidor Apache principal.</dd>
<dt>Suporte IPv6</dt>
<dd>Em sistemas onde o IPv6 é suportado pela biblioteca de base
Apache Portable Runtime, o Apache monitora por padrão
as interfaces IPv6. Em adição as diretrizes <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>, <code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code> e <code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code>, suportam correntes (strings) de
endereços numéricos do tipo IPv6. (ex. "<code>Listen
[2001:db8::1]:8080</code>").</dd>
<dt>Filtrando</dt>
<dd>Os módulos do Apache agora são feito filtros que
agem na corrente do conteúdo na medida que este é entregue, tanto
na entrada quando na saída de dados do servidor. É possível então,
por exemplo, que o retorno de dados de scripts CGI sejam analisados
pelas diretrizes do "Server Side Include" usando o filtro <code>INCLUDES</code> do <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>. O módulo <code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>, permite que programas externos trabalhem
como filtros do mesmo modo que aplicações CGI funcionam como
manipuladores.</dd>
<dt>Respostas de Erro Multi-linguais</dt>
<dd>Mensagens de erro para o navegador agora são fornecidas em
diversas línguas, usando documentos SSI. Podem ser personalizadas
pelo administrador que desejar definir seus próprios
padrões.</dd>
<dt>Configuração Simplificada</dt>
<dd>Muitas diretrizes confusas foram simplificadas. Entre elas,
<code>Port</code> e <code>BindAddress</code> não existem
mais; apenas a diretriz <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
é usada para direcionar endereços IP; a diretriz <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> especifica o nome do servidor
e o número da porta apenas para redirecionamento e reconhecimento
de hospedeiros virtuais.</dd>
<dt>Suporte Nativo ao Unicode do Windows NT</dt>
<dd>O Apache 2.0 para Windows NT agora usa utf-8 para codificação
de todos os nomes de arquivos. A tradução para o sistema
base Unicode, torna possível o suporte multi-lingual para todas
as instalações da família NT, incluindo o Windows 2000 e Windows XP.
<em>Esse suporte não se estende ao Windows 95, 98 ou ME, que
continuam usando o código de páginas da máquina local para o
acesso ao sistema de arquivos.</em></dd>
<dt>Biblioteca de Expressões Regulares Atualizada</dt>
<dd>O Apache 2.0 inclui a <a href="http://www.pcre.org/">Biblioteca
de Expressões Regulares Compatíveis Perl</a> (PCRE). Todas as
avaliações de expressões regulares usam a mais poderosa sintaxe
do Perl 5.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Melhorias nos Módulos</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>Novo módulo no Apache 2.0. Esse módulo é uma interface
para os protocolos de codificação SSL/TLS fornecidos pela
OpenSSL.</dd>
<dt><code class="module"><a href="./mod/mod_dav.html">mod_dav</a></code></dt>
<dd>Novo módulo no Apache 2.0. Este módulo implementa as
especificações de Autoria Distribuída e Versões (Distributed
Authoring and Versioning - DAV) para HTTP, para a publicação
e a manutenção de conteúdo da web.</dd>
<dt><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></dt>
<dd>Novo módulo no Apache 2.0. Esse módulo permite o suporte
a navegadores que solicitam que o conteúdo seja comprimido antes
da entrega, economizando banda da rede.</dd>
<dt><code class="module"><a href="./mod/mod_auth_ldap.html">mod_auth_ldap</a></code></dt>
<dd>Novo módulo no Apache 2.0.41. Este módulo permite que
bancos de dados LDAP sejam usados para armazenar credenciais
para Autenticação Básica HTTP. Um módulo que o acompanha <code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>, fornece a conciliação de conexões e armazenamento
de resultados.</dd>
<dt><code class="module"><a href="./mod/mod_auth_digest.html">mod_auth_digest</a></code></dt>
<dd>Inclui suporte adicional para armazenamento de sessões
através de processos que usam memória compartilhada.</dd>
<dt><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></dt>
<dd>Novo módulo no Apache 2.0. Este modo experimental permite a
tradução de tabelas de caracteres ou re-codificação.</dd>
<dt><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></dt>
<dd>Novo módulo no Apache 2.0. Esse módulo inclui a funcionalidade
do <code>mod_mmap_static</code> do Apache 1.3, além de disponibilizar
outras possibilidades de armazenamento.</dd>
<dt><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></dt>
<dd>Este módulo está muito mais flexível no Apache 2.0. Pode
modificar pedidos de cabeçalhos usados pelo <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>, e incondicionalmente pode ajustar cabeçalhos de respostas.</dd>
<dt><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dt>
<dd>O módulo proxy foi totalmente reescrito para levar vantagem
da nova infraestrutura de filtro e implementar um proxy mais fiel e
de acordo com o padrão HTTP/1.1. Além disso, uma nova seção
de configuração <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code> fornece controles mais legíveis (e internamente
mais rápidos) para sites com proxies; configurações
sobrecarregadas <code><Directory "proxy:..."></code>, não
são suportadas. O módulo agora é dividido em suporte
de protocolos específicos incluindo <code>proxy_connect</code>,
<code>proxy_ftp</code> e <code>proxy_http</code>.</dd>
<dt><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></dt>
<dd>A nova diretriz <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code> pode ser usada para assegurar que
o cliente receba um único documento em todos os casos, ao invés de
respostas "NOT ACCEPTABLE" ou "MULTIPLE CHOICES". Novos algoritmos
de negociação e visões múltiplas (MultiViews) foram organizados para
obter resultados mais consistentes e uma nova forma de tipo de mapa
(map type) que podem incluir o conteúdo de documentos é fornecido.</dd>
<dt><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code></dt>
<dd>As listagens de diretórios automáticas podem ser
configuradas para usar tabelas HTML para formatações mais limpas
e permitir controles mais acurados de classificação, incluindo
ordenação por versão e filtro da lista de
diretórios através de caracteres-coringa.</dd>
<dt><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dt>
<dd>Novas diretrizes permitem que as tags padrões <em>start</em> e
<em>end</em> para elementos SSI, possam ser alteradas e permitir que
as configurações de formatos de erro e hora sejam incluídos no
arquivo de configuração principal, ao invés de serem adicionadas
ao documento SSI. Resultados de análises de expressões regulares
e agrupamento (baseadas na sintaxe de expressões regulares do Perl)
podem ser obtidas usando as variáveis do módulo <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>, de <code>$0</code> a <code>$9</code>.</dd>
<dt><code class="module"><a href="./mod/mod_auth_dbm.html">mod_auth_dbm</a></code></dt>
<dd>Agora suporta múltiplos tipos de banco de dados similares ao DBM,
usando a diretriz <a href="../2.0/mod/mod_auth_dbm.html#AuthDBMType">
<code>AuthDBMType</code></a>
.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Línguas Disponíveis: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentários</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_0.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licenciado sob a <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Diretrizes</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossário</a> | <a href="./sitemap.html">Mapa do site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/mpm.html.zh-cn.utf8 0000664 0001751 0001751 00000026417 14743132254 020430 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>多处理模块(MPM) - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">模块</a> | <a href="./mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="./glossary.html">术语</a> | <a href="./sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>多处理模块(MPM)</h1>
<div class="toplang">
<p><span>可用语言: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">此翻译可能过期。要了解最近的更改，请阅读英文版。</div>
<p>本文档介绍了什么是多处理模块，以及 Apache HTTP 服务器如何使用它们。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">介绍</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#defaults">默认 MPM</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#static">构建 MPM 为静态模块</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#dynamic">构建 MPM 为动态模块</a></li>
</ul><h3>参见</h3><ul class="seealso"><li><a href="#comments_section">评论</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="introduction" id="introduction">介绍</a></h2>
<p>Apache HTTP 服务器被设计为一个功能强大，并且灵活的 web 服务器，
可以在很多平台与环境中工作。不同平台和不同的环境往往需要不同
的特性，或可能以不同的方式实现相同的特性最有效率。Apache httpd
通过模块化的设计来适应各种环境。这种设计允许网站管理员通过在
编译时或运行时，选择哪些模块将会加载在服务器中，来选择服务器特性。</p>
<p>Apache HTTP 服务器 2.0 扩展此模块化设计到最基本的 web 服务器功能。
它提供了可以选择的多处理模块(MPM)，用来绑定到网络端口上，接受请求，
以及调度子进程处理请求。</p>
<p>扩展到这一级别的服务器模块化设计，带来两个重要的好处:</p>
<ul>
<li>Apache httpd 能更优雅，更高效率的支持不同的平台。尤其是
Apache httpd 的 Windows 版本现在更有效率了，因为
<code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code> 能使用原生网络特性取代在
Apache httpd 1.3 中使用的 POSIX 层。它也可以扩展到其它平台
来使用专用的 MPM。</li>
<li>Apache httpd 能更好的为有特殊要求的站点定制。例如，要求
更高伸缩性的站点可以选择使用线程的 MPM，即
<code class="module"><a href="./mod/worker.html">worker</a></code> 或 <code class="module"><a href="./mod/event.html">event</a></code>；
需要可靠性或者与旧软件兼容的站点可以使用
<code class="module"><a href="./mod/prefork.html">prefork</a></code>。</li>
</ul>
<p>在用户看来，MPM 很像其它 Apache httpd 模块。主要是区别是，在任何时间，
必须有一个，而且只有一个 MPM 加载到服务器中。可用的 MPM 列表位于
<a href="mod/">模块索引页面</a>。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="defaults" id="defaults">默认 MPM</a></h2>
<p>下表列出了不同系统的默认 MPM。如果你不在编译时选择，那么它就是你将要使用的 MPM。</p>
<table class="bordered"><tr><td>Netware</td><td><code class="module"><a href="./mod/mpm_netware.html">mpm_netware</a></code></td></tr>
<tr class="odd"><td>OS/2</td><td><code class="module"><a href="./mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
<tr><td>Unix</td><td><code class="module"><a href="./mod/prefork.html">prefork</a></code>，<code class="module"><a href="./mod/worker.html">worker</a></code> 或
<code class="module"><a href="./mod/event.html">event</a></code>，取决于平台特性</td></tr>
<tr class="odd"><td>Windows</td><td><code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
</table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="static" id="static">构建 MPM 为静态模块</a></h2>
<p>在全部平台中，MPM 都可以构建为静态模块。在构建时选择一种
MPM，链接到服务器中。如果要改变 MPM，必须重新构建。</p>
<p>为了使用指定的 MPM，请在执行 <code class="program"><a href="./programs/configure.html">configure</a></code> 脚本
时，使用参数 <code>--with-mpm=<em>NAME</em></code>。<em>NAME</em>
是指定的 MPM 名称。</p>
<p>编译完成后，可以使用 <code>./httpd -l</code> 来确定选择的 MPM。
此命令会列出编译到服务器程序中的所有模块，包括 MPM。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="dynamic" id="dynamic">构建 MPM 为动态模块</a></h2>
<p>在 Unix 或类似平台中，MPM 可以构建为动态模块，与其它动态模块一样在运行时加载。
构建 MPM 为动态模块允许通过修改 <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
指令内容来改变 MPM，而不用重新构建服务器程序。</p>
<p>在执行 <code class="program"><a href="./programs/configure.html">configure</a></code> 脚本时，使用
<code>--enable-mpms-shared</code> 选项可以启用此特性。
当给出的参数为 <code><em>all</em></code> 时，所有此平台支持的 MPM
模块都会被安装。还可以在参数中给出模块列表。</p>
<p>默认 MPM，可以自动选择或者在执行 <code class="program"><a href="./programs/configure.html">configure</a></code>
脚本时通过 <code>--with-mpm</code> 选项来指定，然后出现在生成的服务器配置文件中。
编辑 <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> 指令内容可以选择不同的 MPM。</p>
</div></div>
<div class="bottomlang">
<p><span>可用语言: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">评论</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mpm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="./glossary.html">术语</a> | <a href="./sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_0.html.tr.utf8 0000664 0001751 0001751 00000042573 14743132254 022375 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Sunucusu 2.0’da Yeni olan Özellikler - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache HTTP Sunucusu 2.0’da Yeni olan Özellikler</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belgede Apache HTTP Sunucusunun 1.3 ve 2.0 sürümleri arasındaki
başlıca değişikliklerin bazılarına değinilmiştir.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Çekirdekteki Gelişmeler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Modüllerdeki Gelişmeler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="upgrading.html">1.3’ten 2.0’a Yükseltme</a></li><li><a href="#comments_section">Yorumlar</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="core" id="core">Çekirdekteki Gelişmeler</a></h2>
<dl>
<dt>Unix Evreleri</dt>
<dd>POSIX evreleri desteği olan Unix sistemlerinde Apache httpd, çok evreli
kipte çok süreçlilik şeklinde melez bir yapıda çalışır. Bu bir çok
bakımdan ölçeklenebilirliği arttırsa da bütün yapılandırmalarda
sağlanamaz.</dd>
<dt>Yeni Paket Derleme Sistemi</dt>
<dd>Yeni kaynak paketi derleme sistemi <code>autoconf</code> ve
<code>libtool</code>’a dayalı olarak sıfırdan, yeni baştan yazıldı.
Böylece Apache httpd’nin paket yapılandırma sistemi diğer paketlerinkiyle
benzerlik kazanmış oldu.</dd>
<dt>Çok Sayıda Protokol Desteği</dt>
<dd>Apache HTTP Sunucusu artık çok sayıda protokol ile hizmet sunacak bir
alt yapıya sahiptir. Örneğin, <code class="module"><a href="./mod/mod_echo.html">mod_echo</a></code> modülü bu
amaçla yazılmıştır.</dd>
<dt>Unix dışı platformalara daha iyi destek</dt>
<dd>Apache HTTP Sunucusu 2.0 sürümleri, BeOS, OS/2, Windows gibi Unix olmayan
platformlarda daha hızlı ve daha kararlı çalışacak duruma
getirilmiştir. Genelde iyi geliştirilmemiş olan dolayısıyla istenen
başarımı sağlayamayan POSIX taklit katmanlarının kullanımından
vazgeçilmiş, platforma özgü <a href="mpm.html">çok süreçlilik
modülleri</a> (MPM) ve Apache Taşınabilirlik Arayüzü (APR) sayesinde
bu platformlar artık kendi doğal programlama arayüzleriyle
gerçeklenir olmuştur.</dd>
<dt>Yeni Apache httpd Programlama Arayüzü</dt>
<dd>Modüller için kullanılan programlama arayüzü 2.0 sürümüyle önemli
değişikliklere uğramıştır. 1.3 sürümünde görülen modüllerle ilgili
sıralama/öncelik sorunlarının çoğu giderilmiştir. 2.0 sürümü bu
işlemleri daha bir özdevimli yapar olmuştur; daha fazla esneklik
sağlamak için artık kancalı modül sıralaması kullanılabilmektedir.
Ayrıca, arayüze, Apache HTTP Sunucususu çekirdeğini yamamaya gerek kalmadan
modüllerle sunucu yeteneklerinin arttırılabilmesini sağlayan yeni
çağrılar eklenmiştir.</dd>
<dt>IPv6 Desteği</dt>
<dd>IPv6’nın Apache Taşınabilirlik Arayüzü kütüphanesi tarafından
desteklendiği sistemlerde Apache httpd öntanımlı olarak IPv6 soketlerini
dinler. Bundan başka, <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>, <code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code> ve <code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> yönergelerinin IPv6 sayısal adres
dizgelerini desteklemesi sağlanmıştır.<br />Örnek: <code>Listen
[2001:db8::1]:8080</code></dd>
<dt>Süzme</dt>
<dd>Apache httpd modülleri, artık, sunucuya teslim edilen veya sunucudan
teslim alınan içerik akımları üzerinde süzgeç gibi davranacak şekilde
yazılabilmektedir. Bu sayede, örneğin CGI betiklerinin çıktılarının
<code class="module"><a href="./mod/mod_include.html">mod_include</a></code> modülünün <code>INCLUDES</code> süzgeci
kullanılarak SSI yönergeleri için çözümlenmesi mümkündür. CGI
programlarının birer eylemci olarak davranması gibi,
<code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> modülü de harici programların birer
süzgeç olarak davranabilmesini mümkün kılar.</dd>
<dt>Çok Dilli Hata Yanıtları</dt>
<dd>Hata yanıtlarının tarayıcılara yönelik iletileri artık SSI
belgeleri kullanılarak çeşitli dillerde sağlanabilmektedir. Bunlar
ayrıca yönetici tarafından görünüş ve kullanışlılık tutarlılığı
bakımından kişiselleştirilebilmektedir.</dd>
<dt>Basitleştirilmiş Yapılandırma</dt>
<dd>Bazı yönergelerle ilgili kafa karışıklıkları giderilmiştir.
Bilhassa belli bir IP adresini dinlemek için kullanılan
<code>Port</code> ve <code>BindAddress</code> yönergeleri ile ilgili
karışıklığın önüne geçmek için sadece <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> yönergesi yeterli olmaktadır. <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> yönergesi ise sadece yönlendirme
ve sanal konak tanıma amacıyla sunucu ismi ve port belirtiminde
kullanılmaktadır.</dd>
<dt>Doğal Windows NT Unicode Desteği</dt>
<dd>Apache httpd 2.0, Windows NT üzerinde artık tüm dosya sistemi
kodlamalarında utf-8 kullanmaktadır. Bu destek, Windows 2000 ve
Windows XP dahil tüm Windows NT temelli sistemlere çok dillilik
desteğini sağlamak üzere mevcut Unicode dosya sistemine doğrudan
uyarlanır. <em>Dosya sisteminde makinenin yerel karakter kodlamasını
kullanan kullanan Windows 95, 98 ve ME için bu destek
yoktur.</em></dd>
<dt>Düzenli İfade Kütüphanesi Güncellemesi</dt>
<dd>Apache httpd 2.0’da <a href="http://www.pcre.org/">Perl uyumlu düzenli
ifade kütüphanesi</a> bulunur. Tüm düzenli ifadelerde artık çok daha
güçlü olan Perl 5 sözdizimi kullanılmaktadır.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Modüllerdeki Gelişmeler</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>Apache httpd 2.0’da yeni olan bu modül, OpenSSL tarafından sağlanan
SSL/TLS şifreleme protokollerine bir arayüzdür.</dd>
<dt><code class="module"><a href="./mod/mod_dav.html">mod_dav</a></code></dt>
<dd>Apache httpd 2.0’da yeni olan bu modül, site içeriğinin destek ve bakımı
için HTTP dağıtık yazım ve sürüm yönetimi (DAV - Distributed
Authoring and Versioning) belirtimini gerçekler.</dd>
<dt><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></dt>
<dd>Apache httpd 2.0’da yeni olan bu modül sayesinde ağ band genişliğinden
daha verimli yararlanabilmek için içeriğin sıkıştırılarak
gönderilmesini talep eden tarayıcıların desteklenmesi mümkün
olmuştur.</dd>
<dt><code class="module">mod_auth_ldap</code></dt>
<dd>Apache httpd 2.0.41’de yeni olan bu modül, HTTP temel kimlik
doğrulamasında kullanılan delillerin saklanması için LDAP
veritabanının kullanılabilmesini mümkün kılar. Kardeş modülü olan
<code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code> ise bağlantı havuzlaması ve sonuçların
önbelleğe alınması ile ilgilenir.</dd>
<dt><code class="module"><a href="./mod/mod_auth_digest.html">mod_auth_digest</a></code></dt>
<dd>Paylaşımlı belleği kullanan süreçlere karşı oturum önbelleklemesi
için ek destek içerir.</dd>
<dt><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></dt>
<dd>Apache httpd 2.0’da yeni olan bu deneysel modül, karakter kümesi
dönüşümleri veya kaydı için destek sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></dt>
<dd>Apache httpd 2.0’da yeni olan bu modül, Apache HHP Sunucusu 1.3’teki
<code>mod_mmap_static</code> modülünün işlevselliğini içermenin
yanında buna önbellekleme yetenekleri de ekler.</dd>
<dt><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></dt>
<dd>Bu modül Apache httpd 2.0’da daha esnek hale getirilmiştir. Artık
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> tarafından kullanılan istek başlıkları
değiştirilebilmekte ve bunlar yanıt başlıklarına şartlı olarak
atanabilmektedir.</dd>
<dt><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dt>
<dd>Bu modül HTTP/1.1 uyumlu vekaleti daha güvenilir kılmak ve yeni
süzgeç alt yapısının getirilerinden de yararlanmak amacıyla yeni
baştan yazılmıştır. Bunun yanında, <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code> bölümünün yeni hali vekil siteleri
desteklemek bakımından daha okunabilir (ve kendi içinde daha hızlı)
olması sağlanmıştır; <code><Directory "proxy:..."></code>
yapılandırması artık desteklenmemektedir. Modül,
<code>proxy_connect</code>, <code>proxy_ftp</code> ve
<code>proxy_http</code> şeklinde her biri belli bir protokolü
destekleyen ayrı modüllere bölünmüştür.</dd>
<dt><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></dt>
<dd>Yeni <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code> yönergesi sayesinde istemciye
“Kabul edilebilir bir gösterim çeşidi yok” ya da “Çok sayıda seçim
belirtilmiş” yanıtını döndürmek yerine tüm durumlara uyan bir
sayfanın gönderilebilmesi sağlanmıştır. Bundan başka, uzlaşım ve
<code>MultiViews</code> algoritmaları daha tutarlı sonuçlar elde
etmek amacıyla elden geçirilmiş ve belge içeriği ile daha iyi eşleşen
yeni bir tür eşlem yapısı sağlanmıştır.</dd>
<dt><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code></dt>
<dd>Dizin içeriklerinin özdevimli listelenmesi artık HTML tabloları
kullanılacak şekilde yapılandırılabilmektedir. Böylece sayfa daha iyi
biçemlenebilmekte, içerik daha hassas sıralanabilmekte, sürüm
numarasına göre sıralama yapılabilmekte ve dosya ismi kalıpları
kullanılarak sadece istenen içerik listelenebilmektedir.</dd>
<dt><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dt>
<dd>Yeni yönergeler, değiştirilecek SSI elemanları için öntanımlı
başlangıç ve bitiş etiketlerine izin vermekte, hataların ve zaman
biçemleme yapılandırmalarının SSI belgesinde değil ana yapılandırma
dosyasında bulunması mümkün olmaktadır. Düzenli ifadelerin gruplanmış
sonuçları (Perl düzenli ifade sözdizimi kullanılmaktadır)
<code class="module"><a href="./mod/mod_include.html">mod_include</a></code> modülünün <code>$0</code> ..
<code>$9</code> değişkenleri sayesinde kullanılabilmektedir.</dd>
<dt><code class="module">mod_auth_dbm</code></dt>
<dd><code class="directive">AuthDBMType</code> yönergesi
sayesinde artık çok sayıda DBM tarzı veritabanı türü
desteklenmektedir.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_0.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_2.html.tr.utf8 0000664 0001751 0001751 00000050661 14743132254 022374 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Sunucusu 2.2’de Yeni olan Özellikler - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache HTTP Sunucusu 2.2’de Yeni olan Özellikler</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/new_features_2_2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_2.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ko/new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_2.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belgede Apache HTTP Sunucusunun 2.0 ve 2.2 sürümleri arasındaki
başlıca farklara değinilmiştir. 1.3 sürümüne göre yeni özellikler için <a href="new_features_2_0.html">Apache 2.0’da Yeni olan Özellikler</a>
belgesine bakınız.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Çekirdekteki Gelişmeler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Modüllerdeki Gelişmeler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Programlardaki Gelişmeler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Modül Geliştirici Değişiklikleri</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="core" id="core">Çekirdekteki Gelişmeler</a></h2>
<dl>
<dt>Authn/Authz</dt>
<dd>Mevcut kimlik doğrulama ve yetkilendirme modüllerinin iç işleyişi
yeniden düzenlendi. Yeni <code>mod_authn_alias</code> modülü
(2.3/2.4 sürümlerinde kaldırılmıştır) belli kimlik doğrulama
yapılandırmalarını büyük oranda basitleştirebilir. Bu değişikliklerin
kullanıcıları ve modül yazarlarını nasıl etkilediğini öğrenmek için
<a href="#module">modül değişikliklerine</a> ve <a href="#developer">geliştirici değişikliklerine</a> bakabilirsiniz.</dd>
<dt>Önbellekleme</dt>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>, <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> ve
<code>mod_mem_cache</code> (2.3/2.4 sürümlerinde kaldırılmıştır)
modüllerinde büyük oranda değişikliğe gidilerek bunlar deneysel
olmaktan çıkarılıp üretim amaçlı modüller haline getirildiler.
<code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> tarafından kullanılan disk
alanının <code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code> tarafından
düzenli aralıklarla temizlenebilmesi sağlandı.</dd>
<dt>Yapılandırma</dt>
<dd>Öntanımlı yapılandırma basitleştirildi ve modüler bir yapıya
kavuşturuldu. Sık kullanılan ortak özellikleri etkinleştirmekte
kullanılan yapılandırmalar gruplanarak bunların Apache ile gelmesi ve
ana sunucu yapılandırılırken yapılandırmaya kolayca eklenebilmesi
sağlandı.</dd>
<dt>Nazikçe Durdurma</dt>
<dd><code class="module"><a href="./mod/prefork.html">prefork</a></code>, <code class="module"><a href="./mod/worker.html">worker</a></code> ve
<code class="module"><a href="./mod/event.html">event</a></code> MPM’leri artık <code class="program"><a href="./programs/httpd.html">httpd</a></code>’yi <a href="stopping.html#gracefulstop"><code>graceful-stop</code></a>
sinyali sayesinde nazikçe durdurabilmektedir.
<code class="program"><a href="./programs/httpd.html">httpd</a></code> programının sonlandırılmasındaki gecikmelere
karşı bir önlem olarak, isteğe bağlı bir zaman aşımı belirtmeyi
mümkün kılan <code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> yönergesi
sayesinde sunum sürüyor olsa bile <code class="program"><a href="./programs/httpd.html">httpd</a></code>
sonlandırılabilmektedir.</dd>
<dt>Vekil Sunucu</dt>
<dd>Yeni <code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> modülü ile
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> için yük dengeleme hizmetleri sağlanmış,
yeni <code class="module"><a href="./mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code> modülü ile <a href="http://tomcat.apache.org/">Apache Tomcat</a> tarafından
kullanılan <em>Apache JServ Protokolünün 1.3 sürümü</em> için destek
eklenmiştir.</dd>
<dt>Düzenli İfade Kütüphanesi Güncellemesi</dt>
<dd>Apache, <a href="http://www.pcre.org/">Perl uyumlu düzenli ifade
kütüphanesinin 5.0 sürümünü</a> (PCRE) içermektedir.
<code class="program"><a href="./programs/configure.html">configure</a></code> betiğinin <code>--with-pcre</code>
seçeneği sayesinde <code class="program"><a href="./programs/httpd.html">httpd</a></code> programı PCRE destekli
olarak derlenebilmektedir.</dd>
<dt>Akıllı Süzme</dt>
<dd><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> çıktı süzgeç zincirinin devingen olarak
yapılandırılmasını sağlar. Süzgeçlerin herhangi bir istek veya yanıt
başlığına veya bir ortam değişkenine dayanarak koşullu olarak
yerleştirilmesini mümkün kılar ve bunu yaparken 2.0 mimarisindeki
sorunlu bağımlılıklar ve sıralama sorunlarının da üstesinden
gelir.</dd>
<dt>Büyük Dosya (>2GB) Desteği</dt>
<dd><code class="program"><a href="./programs/httpd.html">httpd</a></code> artık günümüzün 32 bitlik Unix
sistemlerinde bulunan 2 GB’lık büyük dosyaları destekleyecek tarzda
derlenebilmektedir. 2 GB’lık istek gövdelerine destek de ayrıca
eklenmiştir.</dd>
<dt>Event MPM</dt>
<dd><code class="module"><a href="./mod/event.html">event</a></code> MPM modülü sürekli bağlantı isteklerinin
işlenmesi ve bağlantıların kabul edilmesi için ayrı bir evre
kullanır. Sürekli bağlantı (keepalive) isteklerinin işlenmesi
geleneksel olarak httpd’nin buna bir <code class="module"><a href="./mod/worker.html">worker</a></code>
adamasını gerektirirdi. Bu adanmış <code class="module"><a href="./mod/worker.html">worker</a></code> bağlantı
zaman aşımına uğrayıncaya değin tekrar kullanılamazdı.</dd>
<dt>SQL Veritabanı Desteği</dt>
<dd><code class="module"><a href="./mod/mod_dbd.html">mod_dbd</a></code> modülü <code>apr_dbd</code> arayüzü ile
birlikte, ihtiyacı olan modüllere SQL desteği sağlar. Evreli MPM’ler
için bağlantı havuzlamasını destekler.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Modüllerdeki Gelişmeler</a></h2>
<dl>
<dt>Authn/Authz</dt>
<dd>Kimlik Doğrulama, Yetkilendirme ve Erişim Denetimi ile ilgili
modüller özetli kimlik doğrulamasına daha iyi destek sağlamak
amacıyla yeniden isimlendirildi. Örneğin, <code>mod_auth</code>
modülü şimdi <code class="module"><a href="./mod/mod_auth_basic.html">mod_auth_basic</a></code> ve
<code class="module"><a href="./mod/mod_authn_file.html">mod_authn_file</a></code> diye iki modüle bölünmüştür.;
<code>mod_auth_dbm</code> modülünün ismi
<code class="module"><a href="./mod/mod_authn_dbm.html">mod_authn_dbm</a></code> ve <code>mod_access</code> modülünün
ismi de <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code> olarak değiştirilmiştir.
Ayrıca, belli kimlik doğrulama yapılandırmalarını basitleştirmek
üzere <code>mod_authn_alias</code> diye yeni bir modül vardır
(2.3/2.4 sürümlerinde kaldırılmıştır).
</dd>
<dt><code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></dt>
<dd>Bu modül 2.0 sürümü <code>mod_auth_ldap</code> modülünün 2.2
<code>Authn/Authz</code> arayüzüne bir uyarlamasıdır. <code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code> yönergesine LDAP
öznitelik değerlerinin ve karmaşık arama süzgeçlerinin kullanımı gibi
yeni özellikler eklenmiştir.</dd>
<dt><code class="module"><a href="./mod/mod_authz_owner.html">mod_authz_owner</a></code></dt>
<dd>Dosya sistemi üzerindeki dosyalara erişimi dosya sahibine göre
düzenleyebilmeyi sağlayan yeni bir modüldür.</dd>
<dt><code class="module"><a href="./mod/mod_version.html">mod_version</a></code></dt>
<dd>Çalışan sunucunun sürüm numarasına göre belli yapılandırma
bloklarını etkinleştirebilen bir modüldür.</dd>
<dt><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></dt>
<dd>Apache tarafından çözümlenen haliyle yapılandırma yönergelerinin
gösterilmesini sağlayan yeni <code>?config</code> parametresini
ekler. Modül ayrıca, <code>httpd -V</code>’nin yaptığı gibi ek olarak
derleme bilgisini ve tüm istek kancalarının sırasını da gösterir.</dd>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>TLS şifrelemesini HTTP/1.1 için güncelleyen <a href="http://www.ietf.org/rfc/rfc2817.txt">RFC 2817</a> için destek
sağlar.</dd>
<dt><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code></dt>
<dd><code>mod_imap</code> modülünün ismi yanlış anlamalara meydan
vermemek için <code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code> olarak değiştirildi.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="programs" id="programs">Programlardaki Gelişmeler</a></h2>
<dl>
<dt><code class="program"><a href="./programs/httpd.html">httpd</a></code></dt>
<dd>Mevcut yapılandırmaya göre yüklenen modülleri listelemek için
<code>-M</code> diye yeni bir komut satırı seçeneği eklendi.
<code>-l</code> seçeneğinin aksine, bu seçenekle elde edilen liste
<code class="module"><a href="./mod/mod_so.html">mod_so</a></code> üzerinden yüklenen DSO’ları içerir.</dd>
<dt><code class="program"><a href="./programs/httxt2dbm.html">httxt2dbm</a></code></dt>
<dd><code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> yönergesinde
<code>dbm</code> eşlem türü ile kullanmak üzere metin girdilerden DBM
dosyaları üretmek için kullanılan yeni bir program.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="developer" id="developer">Modül Geliştirici Değişiklikleri</a></h2>
<dl>
<dt><a class="glossarylink" href="./glossary.html#apr" title="sözlüğe bakınız">APR</a> 1.0 Programlama Arayüzü</dt>
<dd>Apache 2.2’de APR 1.0 API kullanılmıştır. Kullanımı önerilmeyen
tüm işlevler ve simgeler <code>APR</code> ve
<code>APR-Util</code>’den kaldırılmıştır. Ayrıntılar için <a href="http://apr.apache.org/">APR Sitesine bakınız</a>.</dd>
<dt>Authn/Authz</dt>
<dd>Dağıtımla gelen kimlik doğrulama ve yetkilendirme modüllerinin
isimleri aşağıdaki gibi değiştirildi:
<ul>
<li><code>mod_auth_*</code> -> HTTP kimlik doğrulamasını
gerçekleştiren modüller.</li>
<li><code>mod_authn_*</code> -> Kimlik doğrulamasının artalanına
destek sağlayan modüller.</li>
<li><code>mod_authz_*</code> -> Yetkilendirmeyi (veya erişimi)
gerçekleştiren modüller.</li>
<li><code>mod_authnz_*</code> -> Kimlik doğrulama ve
yetkilendirmeyi birlikte gerçekleştiren modüller.</li>
</ul>
Yeni kimlik doğrulama artalanının oluşturulmasını büyük oranda
kolaylaştıran yeni bir kimlik doğrulama artalanı sağlayıcı şeması
vardır.</dd>
<dt>Bağlantı Hatalarının Günlüklenmesi</dt>
<dd>İstemci bağlantısında ortaya çıkan hataları günlüğe kaydetmek için
<code>ap_log_cerror</code> isminde yeni bir işlev eklendi. Böyle bir
durumda günlük kaydı istemcinin IP adresini içermektedir.</dd>
<dt>Deneme Yapılandırma Kancası Eklendi</dt>
<dd>Kullanıcı, <code class="program"><a href="./programs/httpd.html">httpd</a></code>’yi sadece <code>-t</code>
seçeneği ile kullandığı takdirde özel kod icra edilmesini isteyen
modüllere yardımcı olmak üzere <code>test_config</code> diye yeni bir
kanca işlev eklendi.</dd>
<dt>Evreli MPM’lerin Yığıt Boyutunun Ayarlanması</dt>
<dd>Tüm evreli MPM’lerin yığıt boyutunu ayarlamak üzere <code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code> isminde yeni bir
yönerge eklendi. Öntanımlı yığıt boyutunun küçük olduğu platformlarda
bazı üçüncü parti modüller tarafından buna ihtiyaç duyulmaktadır.</dd>
<dt>Çıktı süzgeçlerinde protokoller</dt>
<dd>Evvelce her süzgeç etkilediğini yanıt başlıklarının doğru olarak
üretilmesini sağlamak zorundaydı. Süzgeçler artık protokol yönetimini
<code>ap_register_output_filter_protocol</code> veya
<code>ap_filter_protocol</code> işlevi üzerinden
<code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> modülüne devredebilmektedir.</dd>
<dt>İzleme kancası eklendi</dt>
<dd>İzleme kancası, modüllerin ana (tepe) süreçteki sıradan/zamanlanmış
işlerini yapacak modülleri etkinleştirir.</dd>
<dt>Düzenli ifade programlama aryüzü değişti</dt>
<dd><code>pcreposix.h</code> başlık dosyası artık yok; yerine
<code>ap_regex.h</code> dosyası geçti. Eski başlık dosyasınca ifade
olunan POSIX.2 <code>regex.h</code> gerçeklenimi şimdi
<code>ap_</code> isim alanı altında <code>ap_regex.h</code> başlık
dosyasındadır. <code>regcomp</code>, <code>regexec</code> gibi
işlevlerin yerine de artık <code>ap_regcomp</code>,
<code>ap_regexec</code> işlevleri geçerlidir.</dd>
<dt>DBD Arayüzü (SQL Veritabanı API)</dt>
<dd><p>Apache 1.x ve 2.0’da, modüller, SQL veritabanlarını kendileri
yönetebilmek için sorumluluğu alacak bir SQL artalanına ihtiyaç
duymaktadır. Her biri kendi bağlantısına sahip bir sürü modül
olduğunda bu yöntem çok verimsiz olabilmektedir.</p>
<p>Apache 2.1 ve sonrasında veritabanı bağlantılarını (evreli olsun
olmasın MPM’lerin eniyilenmiş stratejileri dahil) yönetmek için
<code>ap_dbd</code> arayüzü kullanılmıştır. APR 1.2 ve sonrasında ise
veritabanı ile etkileşim <code>apr_dbd</code> arayüzüyle
sağlanmıştır.</p>
<p>Yeni modüllerin tüm SQL veritabanı işlemlerinde bu arayüzü
kullanmaları ÖNERİlir. Mevcut uygulamaların uygulanabildiği takdirde
hem kullanıcılarına önerilen bir seçenek olarak hem de şeffaf olarak
kullanmak üzere kendilerini güncellemeleri ÖNERİir.</p></dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/new_features_2_2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_2.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ko/new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_2.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_2.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_0.html.ja.utf8 0000664 0001751 0001751 00000045071 14743132254 022336 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache 2.0 の新機能の概要 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Apache 2.0 の新機能の概要</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>この文書では、Apache HTTP サーババージョン 1.3 と 2.0
の主な違いについて記述しています。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">コア機能の拡張</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">モジュールの拡張</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="upgrading.html">1.3 から 2.0 へのアップグレード</a></li><li><a href="#comments_section">コメント</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="core" id="core">コア機能の拡張</a></h2>
<dl>
<dt>Unix のスレッド</dt>
<dd>POSIX スレッドをサポートしている Unix システム上では、
Apache はマルチプロセス、マルチスレッドのハイブリッドモードで
実行できるようになりました。これにより
多くの設定においてスケーラビリティが向上します。</dd>
<dt>新しいビルドシステム</dt>
<dd>ビルドシステムは <code>autoconf</code> と <code>libtool</code>
に基づいたものになるように、
新しく書き直されました。これにより、Apache の configure のシステムは
他のパッケージと似たものになりました。</dd>
<dt>マルチプロトコルサポート</dt>
<dd>Apache に複数のプロトコルを扱うための機構が備わりました。
例として <code class="module"><a href="./mod/mod_echo.html">mod_echo</a></code> が書かれています。</dd>
<dt>Unix 以外のプラットフォームのサポートの改善</dt>
<dd>Apache 2.0 は BeOS、OS/2、Windows などの Unix 以外の
プラットフォームで、より速く、より安定して動作するようになりました。
プラットフォーム特有の <a href="mpm.html">マルチプロセッシングモジュール</a> (MPM) と
Apache Portable Runtime (APR) の導入により、
ネイティヴの API で実装されるようになり、
バグが多く、性能の悪いことが多い POSIX エミュレーションレイヤの使用を
回避することができました。</dd>
<dt>新しい Apache API</dt>
<dd>2.0 ではモジュールの API が大きく変わりました。
1.3 にあったモジュールの順番/優先度の問題の多くは
なくなっているはずです。2.0 は優先度の選択をほとんどを自動的に行ない、
モジュールの順番はより柔軟性を高めるためにフック毎に行なわれるように
なりました。また、コア Apache サーバにパッチをあてることなく
追加のモジュール機能を提供することができるように新しい関数が
追加されました。</dd>
<dt>IPv6 サポート</dt>
<dd>Apache が使用している Apache Portable Runtime library が
IPv6 をサポートしているシステムでは Apache は デフォルトで
IPv6 のソケットを listen します。さらに、
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>,
<code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code>,
<code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code>
の各ディレクティブが IPv6 のアドレスを
サポートするようになりました (例えば、
"<code>Listen [2001:db8::1]:8080</code>")。</dd>
<dt>フィルタ</dt>
<dd>Apache のモジュールはサーバから送られてきたり、サーバへ
送るストリームに対して動作するフィルタとして書くことができるように
なりました。これにより、例えば CGI スクリプトの出力を
<code class="module"><a href="./mod/mod_include.html">mod_include</a></code> の <code>INCLUDES</code> フィルタを使って
Server Side Include のディレクティブを解析する、
というようなことが可能になりました。<code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>
で外部プログラムをフィルタとして動作させることができます。
これは CGI プログラムをハンドラとして動作させるのと
よく似た方法でできます。</dd>
<dt>多言語エラー応答</dt>
<dd>ブラウザへのエラー応答のメッセージが、SSI の文書を使って
複数の言語で提供されるようになりました。見ための一貫性を保つために
管理者がカスタマイズすることもできます。</dd>
<dt>設定の簡素化</dt>
<dd>多くの混乱を招きがちなディレクティブが簡素化されました。
よく混乱を引き起こしていた <code>Port</code> ディレクティブと
<code>Bind</code> ディレクティブは
なくなりました。<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
ディレクティブのみが IP アドレスのバインドに使われます。
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> ディレクティブでは
リダイレクトと vhost の認識のためだけにサーバの名前とポート番号を
指定します。</dd>
<dt>Windows NT のネイティヴ Unicode サポート</dt>
<dd>Windows NT 上の Apache 2.0 はファイル名の文字エンコード全てに
utf-8 を使うようになりました。これらは Unicode ファイルシステムに
直接変換されるので、Windows 2000 と Windows XP を含む、全ての
Windows NT 系で多言語サポートが提供されます。
<em>このサポートは、ファイルシステムのアクセス時にローカルの
コードページを使う Windows 95, 98, ME には適用されません。</em></dd>
<dt>正規表現ライブラリのアップデート</dt>
<dd>Apache 2.0 は <a href="http://www.pcre.org/">Perl
互換正規表現ライブラリ (PCRE) </a>を含んでいます。
正規表現の評価には、より強力になった Perl 5
構文を使用します。</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">モジュールの拡張</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>Apache 2.0 の新モジュール。このモジュールは OpenSSL が
提供する SSL/TLS 暗号プロトコルへのインタフェースです。</dd>
<dt><code class="module"><a href="./mod/mod_dav.html">mod_dav</a></code></dt>
<dd>Apache 2.0 の新モジュール。このモジュールはウェブコンテンツを
送り、維持するための規格
HTTP Distributed Authoring and Versioning (DAV) を実装しています。</dd>
<dt><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></dt>
<dd>Apache 2.0 の新モジュール。送信前に送信内容を圧縮して
ネットワーク帯域を節約する、というリクエストをブラウザが
要求できるようにします。</dd>
<dt><code class="module"><a href="./mod/mod_auth_ldap.html">mod_auth_ldap</a></code></dt>
<dd>Apache 2.0.41 の新モジュール。HTTP 基本認証の証明書を保存するのに、
LDAP データベースを使用できるようになります。
関連モジュールの <code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code> で、
コネクションのプール機能と結果のキャッシュ機能が提供されます。</dd>
<dt><code class="module"><a href="./mod/mod_auth_digest.html">mod_auth_digest</a></code></dt>
<dd>このモジュールは共有メモリを使うことにより、プロセスをまたいだ
セッションのキャッシュをサポートするようになりました。</dd>
<dt><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></dt>
<dd>Apache 2.0 の新モジュール。この実験的なモジュールは
キャラクタセットの変換や再符号化を可能にします。</dd>
<dt><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></dt>
<dd>Apache 2.0 の新モジュール。このモジュールには、
Apache 1.3 における <code>mod_mmap_static</code> 機能が含まれ、
また、追加のキャッシュ機能が加わっています。</dd>
<dt><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></dt>
<dd>このモジュールは Apache 2.0 で非常に柔軟性が
高くなりました。<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>
で使われるリクエストのヘッダを変更できるようになりましたし、
応答ヘッダを条件に応じて設定できるようになりました。</dd>
<dt><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dt>
<dd>proxy モジュールは新しいフィルタの機構を利用するためと、
より信頼できる、HTTP/1.1 に準拠した proxy を実装するために
完全に書き直されました。さらに、新しい
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
設定セクションがproxy されるサイトのより読みやすく (内部的にもより速い)
設定を提供します。オーバーロードされた
<code><Directory "proxy:... ></code>
設定はサポートされていません。このモジュールは <code>proxy_connect</code>,
<code>proxy_ftp</code>, <code>proxy_http</code>
といった、特定のプロトコルをサポートする
モジュールに分割されるようになりました。</dd>
<dt><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></dt>
<dd>クライアントが NOT ACCEPTABLE や MULTIPLE CHOICES 応答の
代わりに常に単独の文書を受けとるようにするために、新しいディレクティブ
<code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code>
を使うことができるようになりました。
さらに、より一貫性のある結果を提供するために
ネゴシエーションと MultiViews のアルゴリズムが改善され、
文書の内容を含めることのできる、新しい形式のタイプマップが
提供されるようになりました。</dd>
<dt><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code></dt>
<dd>Autoindex されるディレクトリの内容一覧が、
きれいに表示されるために HTML のテーブルを使うように
設定できるようになりました。また、バージョンによるソーティングなど、
より細かいソーティングの制御ができるようになり、ディレクトリ
の内容一覧をワイルドカードにより選別することができるようにもなりました。</dd>
<dt><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dt>
<dd>新しいディレクティブにより、SSI のデフォルトの開始タグと終了タグを
変更できるようになりました。また、エラーと時刻の形式の設定が SSI の
文書中ではなく、主設定ファイル中で行なえるようになりました。
正規表現の解析とグループ化の結果 (Perl の正規表現の構文に
基づいたものになりました) を <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>
の変数 $0 .. $9 により取得できるようになりました。</dd>
<dt><code class="module"><a href="./mod/mod_auth_dbm.html">mod_auth_dbm</a></code></dt>
<dd><code class="directive"><a href="./mod/mod_auth_dbm.html#authdbmtype">AuthDBMType</a></code>
ディレクティブにより、複数の DBM 型のデータベースをサポートする
ようになりました。</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_0.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sections.html.ko.euc-kr 0000664 0001751 0001751 00000062175 14743132254 021361 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title> - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1> </h1>
<div class="toplang">
<p><span> : </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/sections.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sections.html" title="Korean"> ko </a> |
<a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><a href="configuring.html"></a> ִ
þ ü ǰų, Ư 丮, , ȣƮ,
URL ִ. ٸ þ
ϱ ̳ <code>.htaccess</code>
ϴ Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#types"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#file-and-web">Ͻý۰ </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">ȣƮ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#proxy">Ͻ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#whatwhere">ȿ þ
ֳ?</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#mergin">ǵ ϴ </a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="types" id="types"> </a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>ǿ ΰ ִ. κ ſû óȴ.
شϴ û ȿ þ Ѵ. ݴ, <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>
Ҷ óѴ. Ҷ ° ̸ ȿ ִ
þ û ȴ. ƴϸ ȿ ִ þ
Ѵ.</p>
<p><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>
þ <code>httpd</code> ĶͰ ִ
쿡 ȿ þ Ѵ. ,
<code>httpd -DClosedForNow</code> 쿡
û ٸ Ʈ ̷ǵȴ:</p>
<div class="example"><p><code>
<IfDefine ClosedForNow><br />
Redirect / http://otherserver.example.com/<br />
</IfDefine>
</code></p></div>
<p><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>
þ Ư Ե 쿡 ȿ þ
Ѵٴ ϰ ſ ϴ.
ϰų տ <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> ־ Ѵ.
þ Ư ġ ٸ ʿ䰡
ؾ Ѵ.
ֱ ϱ ϴ þ ȿ θ ȵȴ.</p>
<p> <code class="module"><a href="./mod/mod_mime_magic.html">mod_mime_magic</a></code> <code class="directive"><a href="./mod/mod_mime_magic.html#mimemagicfiles">MimeMagicFiles</a></code> þ
óѴ.</p>
<div class="example"><p><code>
<IfModule mod_mime_magic.c><br />
MimeMagicFile conf/magic<br />
</IfModule>
</code></p></div>
<p><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>
<code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>
˻ տ "!" ٿ ִ. , ǵ
ļ Ͽ ȿ ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="file-and-web" id="file-and-web">Ͻý۰ </a></h2>
<p> Ǵ Ͻý۰ (webspace)
Ư ҿ ϴ ͵̴. ̸
ϴ ߿ϴ. Ͻý ü 忡 ũ
̴. , ⺻ ġ ġ ϸ н
Ͻý <code>/usr/local/apache2</code>,
Ͻý <code>"c:/Program Files/Apache
Group/Apache2"</code> ġȴ. (ġ
, ƴ, ϶.) ݴ
ϰ Ŭ̾Ʈ Ե Ʈ ̴.
н ⺻ ġ ġ
<code>/dir/</code> Ͻý
<code>/usr/local/apache2/htdocs/dir/</code> شѴ.
Ÿ̽ ֱ ݵ
Ͻýۿ ʿ .</p>
<h3><a name="filesystem" id="filesystem">Ͻý </a></h3>
<p><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
<code class="directive"><a href="./mod/core.html#files"><Files></a></code> þ
ǥ ϴ þ Ͻý Ư κп þ
Ѵ. <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> þ Ե þ
Ͻý 丮 丮 ȴ. <a href="howto/htaccess.html">.htaccess </a> ص
. , 丮 (index)
<code>/var/web/dir1</code> 丮 丮 (index)
ϴ.</p>
<div class="example"><p><code>
<Directory /var/web/dir1><br />
Options +Indexes<br />
</Directory>
</code></p></div>
<p><code class="directive"><a href="./mod/core.html#files"><Files></a></code> ǿ Ե þ
丮 ִ ̸ Ͽ ȴ.
ּκп ִ , ҿ
<code>private.html</code>̶ ̸
źѴ.</p>
<div class="example"><p><code>
<Files private.html><br />
Order allow,deny<br />
Deny from all<br />
</Files>
</code></p></div>
<p>Ͻý Ư κп ִ Īϱ <code class="directive"><a href="./mod/core.html#files"><Files></a></code> <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
Ѵ. ,
<code>/var/web/dir1/private.html</code>,
<code>/var/web/dir1/subdir2/private.html</code>,
<code>/var/web/dir1/subdir3/private.html</code>
<code>/var/web/dir1/</code> 丮 Ʒ ִ ̸
<code>private.html</code> źѴ.</p>
<div class="example"><p><code>
<Directory /var/web/dir1><br />
<Files private.html><br />
Order allow,deny<br />
Deny from all<br />
</Files><br />
</Directory>
</code></p></div>
<h3><a name="webspace" id="webspace"> </a></h3>
<p><code class="directive"><a href="./mod/core.html#location"><Location></a></code>
þ ̿ شϴ ǥ ϴ þ ݴ
Ư ٲ۴. , /private
ϴ URL- źεȴ.
<code>http://yoursite.example.com/private</code>,
<code>http://yoursite.example.com/private123</code>,
<code>http://yoursite.example.com/private/dir/file.html</code>
<code>/private</code> ڿ ϴ û شȴ.</p>
<div class="example"><p><code>
<Location /private><br />
Order Allow,Deny<br />
Deny from all<br />
</Location>
</code></p></div>
<p><code class="directive"><a href="./mod/core.html#location"><Location></a></code>
þ Ͻýۿ ʿ䰡 . Ư
URL <code class="module"><a href="./mod/mod_status.html">mod_status</a></code> ϴ ġ ڵ鷯
Ű ش. Ͻýۿ <code>server-status</code>
ʿ.</p>
<div class="example"><p><code>
<Location /server-status><br />
SetHandler server-status<br />
</Location>
</code></p></div>
<h3><a name="wildcards" id="wildcards">ϵī ǥ</a></h3>
<p><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>
þ C ǥ ̺귯 <code>fnmatch</code>
ϴ ϵī ڸ ִ.
"*" ڴ ڿ̶ Ÿ, "?" ڴ Ѱ
Ÿ, "[<em>seq</em>]" <em>seq</em> ߿ ڸ Ÿ.
ϵī嵵 "/" ڸ Ÿ Ѵ. ڴ
ؾ Ѵ.</p>
<p> ʿϸ perlȣȯ <a href="glossary.html#regex">ǥ</a> ϴ <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>, <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>
ִ. Ʒ տ ǥ
ϸ þ Ǵ ϴ .</p>
<p> 丮 ϴ ǥ ϵī
:</p>
<div class="example"><p><code>
<Directory /home/*/public_html><br />
Options Indexes<br />
</Directory>
</code></p></div>
<p>ǥ Ͽ ѹ Ͽ
ź ִ:</p>
<div class="example"><p><code>
<FilesMatch \.(?i:gif|jpe?g|png)$><br />
Order allow,deny<br />
Deny from all<br />
</FilesMatch>
</code></p></div>
<h3><a name="whichwhen" id="whichwhen"> ϳ</a></h3>
<p>Ͻý ǰ ϳ ϴ
ſ . Ͻýۿ ִ ü þ Ҷ
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>
Ѵ. (Ÿ̽ ) Ͻýۿ
ʴ ü þ Ҷ <code class="directive"><a href="./mod/core.html#location"><Location></a></code> Ѵ.</p>
<p>Ͻýۿ ִ ü ϱ <code class="directive"><a href="./mod/core.html#location"><Location></a></code> ϸ
ȵȴ. ٸ (URL) Ͻý ҿ
Ƿ, ɾ ȸ ֱ ̴.
캸:</p>
<div class="example"><p><code>
<Location /dir/><br />
Order allow,deny<br />
Deny from all<br />
</Location>
</code></p></div>
<p> <code>http://yoursite.example.com/dir/</code>
ûѴٸ ۵Ѵ. ҹڸ ʴ Ͻý
Ѵٸ Եdz?
<code>http://yoursite.example.com/DIR/</code> ûϿ
ȸ ִ. ݴ <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> þ ûϿ
ҿ Ǵ 뿡 ȴ. (ܴ Ͻý
ũ ϴ . ɺũ Ͽ 丮
Ͻý ҿ ִ. <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> þ ɺũ .
Ƿ ؼ <code class="directive"><a href="./mod/core.html#options">Options</a></code> þ Ͽ ɺũ
ؾ Ѵ.)</p>
<p>Ƹ ҹڸ ϴ Ͻý ϹǷ
̷ Ͼ ʴ´ٰ . ٸ
ε ġ Ͻý ġ
϶. ϸ Ͻý ؾ
Ѵ. Ģ ܰ ϳ ִ.
<code><Location /></code> ǿ θ Ư
URL ƴ û ǹǷ Ϻϰ ϴ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">ȣƮ</a></h2>
<p><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
Ư ȣƮ Ǵ þ Ѵ. ̴
ǻͿ ٸ ȣƮ Ҷ
ϴ. ڼ <a href="vhosts/">ȣƮ </a>
϶.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Ͻ</a></h2>
<p><code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
<code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>
URL <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> Ͻ
ϴ 쿡 ȴ. , Ͻ
<code>cnn.com</code> Ʈ .</p>
<div class="example"><p><code>
<Proxy http://cnn.com/*><br />
Order allow,deny<br />
Deny from all<br />
</Proxy>
</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="whatwhere" id="whatwhere">ȿ þ
ֳ?</a></h2>
<p> Ǿȿ ִ þ ˷ þ
<a href="mod/directive-dict.html#Context"></a> Ȯ϶.
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
밡 þ <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#files"><Files></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code>, <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>, <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>, <code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code> ǿ 밡ϴ.
, ܰ ִ:</p>
<ul>
<li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> þ
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
ǿ ִ.</li>
<li><code>FollowSymLinks</code>, <code>SymLinksIfOwnerMatch</code>,
<code class="directive"><a href="./mod/core.html#options">Options</a></code> <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> ̳
<code>.htaccess</code> Ͽ ִ.</li>
<li><code class="directive"><a href="./mod/core.html#options">Options</a></code> þ
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>
<code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></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="mergin" id="mergin">ǵ ϴ </a></h2>
<p> ſ Ư ȴ.
þ ؼϴ ߿ ֱ
ϴ ߿ϴ.</p>
<p>ϴ :</p>
<ol>
<li> (ǥ ʴ) <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> <code>.htaccess</code>
ÿ Ͼ (쿡 <code>.htaccess</code>
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
ϵ ִ)</li>
<li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code> (
<code><Directory ~></code>)</li>
<li><code class="directive"><a href="./mod/core.html#files"><Files></a></code> <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code> ÿ Ͼ</li>
<li><code class="directive"><a href="./mod/core.html#location"><Location></a></code> <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> ÿ Ͼ</li>
</ol>
<p><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> ϰ ǵ
Ͽ óȴ. ( 1) <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> 丮
ª Ϳ óȴ. ,
<code><Directory /var/web/dir></code>
<code><Directory /var/web/dir/subdir></code>
óѴ. 丮 Īϴ <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
ִٸ ̵ óѴ. <code class="directive"><a href="./mod/core.html#include">Include</a></code> þ
<code class="directive"><a href="./mod/core.html#include">Include</a></code> þ ġ
ִ ó óѴ.</p>
<p><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> ȿ Ե
ȣƮ ۿ ִ ش <em>Ŀ</em> ȴ.
ȣƮ ȿ ּ ִ.</p>
<p><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> û Ҷ, <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
ó <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> ǰ .</p>
<p> Ѵ.</p>
<div class="note"><h3> </h3>
<code><Location></code>/<code><LocationMatch></code>
(<code>Aliases</code> <code>DocumentRoot</code> Ͽ
URL ϸ ȯϴ) ̸ ܰ óȴ.
Ŀ Ѵ.
</div>
<h3><a name="merge-examples" id="merge-examples"></a></h3>
<p> ϴ ϴ . ̵ û
ȴٰ ϸ þ A > B > C > D > E
óȴ.</p>
<div class="example"><p><code>
<Location /><br />
E<br />
</Location><br />
<br />
<Files f.html><br />
D<br />
</Files><br />
<br />
<VirtualHost *><br />
<Directory /a/b><br />
B<br />
</Directory><br />
</VirtualHost><br />
<br />
<DirectoryMatch "^.*b$"><br />
C<br />
</DirectoryMatch><br />
<br />
<Directory /a/b><br />
A<br />
</Directory><br />
<br />
</code></p></div>
<p> . <code class="directive"><a href="./mod/core.html#location"><Location></a></code> ߿ óϹǷ
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
ǿ ִ Ѱ ϴ.
, ϴ ߿ϹǷ ϶!</p>
<div class="example"><p><code>
<Location /><br />
Order deny,allow<br />
Allow from all<br />
</Location><br />
<br />
# ! <Directory> ƹ ȿ <br />
<Directory /><br />
Order allow,deny<br />
Allow from all<br />
Deny from badguy.example.com<br />
</Directory>
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/sections.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sections.html" title="Korean"> ko </a> |
<a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sections.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/server-wide.html.tr.utf8 0000664 0001751 0001751 00000030636 14743132254 021477 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Sunucu Genelinde Yapılandırma - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Sunucu Genelinde Yapılandırma</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/server-wide.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/server-wide.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belgede <code class="module"><a href="./mod/core.html">core</a></code> modülü ile sağlanan ve sunucunun temel
işlemlerini yapılandırmakta kullanılan yönergelerden bazıları
açıklanmıştır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#identification">Sunucu Kimliği</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#locations">Dosyaların Yerleri</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#resource">Özkaynak Kullanımının Sınırlanması</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#implementation">Gerçeklenimle ilgili Seçimler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="identification" id="identification">Sunucu Kimliği</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code></li><li><code class="directive"><a href="./mod/core.html#serversignature">ServerSignature</a></code></li><li><code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li></ul></td></tr></table>
<p><code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code> ve <code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> yönergeleri, hata iletileri gibi
sunucu tarafından üretilen belgelerde sunucu ile ilgili hangi bilgilerin
sunulacağını belirlerler. <code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> yönergesi sunucunun HTTP yanıt başlığı
alanının değerini belirler.</p>
<p><code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>,
<code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> ve
<code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
yönergeleri, sunucu tarafından, özüne yönelik URL’leri nasıl
oluşturacağını saptamak için kullanılır. Örneğin bir istemci bir dizin
isteğinde bulunurken URL’nin sonuna bölü çizgisi eklemese bile
Apache httpd’nin istemciyi bölü çizgisi ile bitirilmiş URL yoluna
yönlendirmesi gerekir; böylece istemci belge içindeki göreli
bağlantıları doğru şekilde çözümleyebilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="locations" id="locations">Dosyaların Yerleri</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code></li><li><code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code></li></ul></td></tr></table>
<p>Bu yönergeler Apache httpd’nin doğru işlem yapması için gereksinim
duyduğu çeşitli dosyaların yerlerini belirlerler. Bölü çizgisi (/) ile
başlamayan dosya yolları kullanıldığında bu dosyaların yerlerinin
<code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> yönergesinde belirtilen
dizine göre belirtildiği varsayılır; root olmayan kullanıcılar
tarafından yazılabilen dosya yollarına dosya yerleştirmemeye dikkat
ediniz. Bu konuda daha ayrıntılı bilgi edinmek için <a href="misc/security_tips.html#serverroot">güvenlik ipuçları</a>
belgesine bakınız.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="resource" id="resource">Özkaynak Kullanımının Sınırlanması</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#limitrequestbody">LimitRequestBody</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfields">LimitRequestFields</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfieldsize">LimitRequestFieldsize</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestline">LimitRequestLine</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitcpu">RLimitCPU</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitmem">RLimitMEM</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitnproc">RLimitNPROC</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code></li></ul></td></tr></table>
<p><code>LimitRequest*</code> yönergeleri, Apache httpd’nin istemcilerden
gelen istekleri okumak için kullanacağı özkaynakların miktarları ile
ilgili sınırlamalar koymak için kullanılırlar. Bu değerleri sınırlamak
suretiyle bazı hizmet reddi saldırılarının etkileri azaltılabilir.</p>
<p><code>RLimit*</code> yönergeleri ise Apache httpd’nin çocuk süreçleri
tarafından çatallanabilen özkaynakların miktarlarını sınırlamakta
kullanılırlar. Özellikle de CGI betikleri ve SSI çalıştırma komutları
tarafından kullanılan özkaynakları denetlemekte kullanılırlar.</p>
<p><code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code> yönergesi
bazı platformlarda yığıt boyutunu denetim altında tutmak için
kullanılır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="implementation" id="implementation">Gerçeklenimle ilgili Seçimler</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code></li></ul></td></tr></table>
<p><code class="directive">Mutex</code> yönergesi, <a class="glossarylink" href="./glossary.html#apr" title="sözlüğe bakınız">APR</a>'nin
öntanımlı seçimi ile ilgili işlevsel ve başarımsal sorunlarına çare
bulmada ilgili gerçeklenimi mutex'ler için değiştirmekte
kullanılabilir.</p>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/server-wide.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/server-wide.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/server-wide.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sitemap.html.ko.euc-kr 0000664 0001751 0001751 00000056071 14743132254 021172 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Ʈ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page">
<div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div>
<div id="page-content"><div id="preamble"><h1>Ʈ</h1>
<div class="toplang">
<p><span> : </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p>
<a href="./">Apache HTTP Server Version 2.4 </a>
ش.</p>
</div>
<div id="quickview"><ul id="toc">
<li><img alt="" src="./images/down.gif" /> <a href="#release">ǥ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">ġ ϱ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#vhosts">ġ ȣƮ </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#faq">ġ </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ssl">ġ SSL/TLS ȣȭ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#howto">ħ, 丮, HowTo</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#platform">÷ </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">ġ α</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#misc">Ÿ ġ </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">ġ </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#index"> </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="release" id="release">ǥ</a></h2>
<ul><li><a href="upgrading.html">1.3 2.0 ̵</a></li>
<li><a href="new_features_2_0.html">ġ 2.0 ο </a></li>
<li><a href="license.html">ġ ̼</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="using" id="using">ġ ϱ</a></h2>
<ul><li><a href="install.html">ġ ϰ ġ</a></li>
<li><a href="invoking.html">ġ </a></li>
<li><a href="stopping.html"> ߴܰ </a></li>
<li><a href="configuring.html"></a></li>
<li><a href="sections.html"> Directory, Location, Files
ϳ</a></li>
<li><a href="server-wide.html"> </a></li>
<li><a href="logs.html">α</a></li>
<li><a href="urlmapping.html">URL Ͻýۿ </a></li>
<li><a href="misc/security_tips.html"> </a></li>
<li><a href="dso.html">ü (DSO) </a></li>
<li><a href="content-negotiation.html"> (content negotiation)</a></li>
<li><a href="custom-error.html"> </a></li>
<li><a href="bind.html">ġ ּҿ Ʈ </a></li>
<li><a href="mpm.html">ó (MPM)</a></li>
<li><a href="env.html">ġ ȯ溯</a></li>
<li><a href="handler.html">ġ ڵ鷯 </a></li>
<li><a href="filter.html"></a></li>
<li><a href="suexec.html">suEXEC </a></li>
<li><a href="misc/perf-tuning.html"> Ʈ</a></li>
<li><a href="misc/rewriteguide.html">URL ۼ(rewriting) ħ</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="vhosts" id="vhosts">ġ ȣƮ </a></h2>
<ul><li class="separate"><a href="vhosts/"></a></li>
<li><a href="vhosts/name-based.html"≯ ȣƮ</a></li>
<li><a href="vhosts/ip-based.html">IP ȣƮ </a></li>
<li><a href="vhosts/mass.html">뷮 ȣƮ ϱ</a></li>
<li><a href="vhosts/examples.html">ȣƮ </a></li>
<li><a href="vhosts/details.html">ȣƮ ã ڼ </a></li>
<li><a href="vhosts/fd-limits.html">ϱ(file descriptor) Ѱ</a></li>
<li><a href="dns-caveats.html">DNS ġ õ </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="faq" id="faq">ġ </a></h2>
<ul><li><a href="faq/"></a></li>
<li><a href="faq/support.html"></a></li>
<li><a href="faq/error.html"></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="ssl" id="ssl">ġ SSL/TLS ȣȭ</a></h2>
<ul><li class="separate"><a href="ssl/">Ұ</a></li>
<li><a href="ssl/ssl_intro.html">SSL/TLS ȣȭ: Ұ</a></li>
<li><a href="ssl/ssl_compat.html">SSL/TLS ȣȭ: ȣȯ</a></li>
<li><a href="ssl/ssl_howto.html">SSL/TLS ȣȭ: How-To</a></li>
<li><a href="ssl/ssl_faq.html">SSL/TLS ȣȭ: FAQ</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="howto" id="howto">ħ, 丮, HowTo</a></h2>
<ul><li class="separate"><a href="howto/"></a></li>
<li><a href="howto/auth.html"></a></li>
<li><a href="howto/cgi.html">CGI </a></li>
<li><a href="howto/ssi.html">Server Side Includes Ұ</a></li>
<li><a href="howto/htaccess.html">.htaccess </a></li>
<li><a href="howto/public_html.html">ں 丮</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="platform" id="platform">÷ </a></h2>
<ul><li class="separate"><a href="platform/"></a></li>
<li><a href="platform/windows.html">Microsoft Windows ġ
ϱ</a></li>
<li><a href="platform/win_compiling.html">Microsoft Windows
ġ ϱ</a></li>
<li><a href="platform/netware.html">Novell NetWare ġ
ϱ</a></li>
<li><a href="platform/perf-hp.html">HPUX
ϱ</a></li>
<li><a href="platform/ebcdic.html">ġ EBCDIC </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="programs" id="programs">ġ α</a></h2>
<ul><li class="separate"><a href="programs/"></a></li>
<li><a href="programs/httpd.html">Manpage: httpd</a></li>
<li><a href="programs/ab.html">Manpage: ab</a></li>
<li><a href="programs/apachectl.html">Manpage: apachectl</a></li>
<li><a href="programs/apxs.html">Manpage: apxs</a></li>
<li><a href="programs/configure.html">Manpage: configure</a></li>
<li><a href="programs/dbmmanage.html">Manpage: dbmmanage</a></li>
<li><a href="programs/htcacheclean.html">Manpage: htcacheclean</a></li>
<li><a href="programs/htdigest.html">Manpage: htdigest</a></li>
<li><a href="programs/htpasswd.html">Manpage: htpasswd</a></li>
<li><a href="programs/logresolve.html">Manpage: logresolve</a></li>
<li><a href="programs/rotatelogs.html">Manpage: rotatelogs</a></li>
<li><a href="programs/suexec.html">Manpage: suexec</a></li>
<li><a href="programs/other.html">ٸ α</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="misc" id="misc">Ÿ ġ </a></h2>
<ul><li class="separate"><a href="misc/"></a></li>
<li><a href="misc/relevant_standards.html">õ ǥص</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="modules" id="modules">ġ </a></h2>
<ul><li><a href="mod/module-dict.html">ġ ϴµ
</a></li>
<li><a href="mod/directive-dict.html">ġ þ ϴµ
</a></li>
</ul><ul><li><a href="mod/core.html">ġ ٽ </a></li>
<li><a href="mod/mpm_common.html">ġ MPM þ</a></li>
<li><a href="mod/event.html">ġ MPM event</a></li>
<li><a href="mod/mpm_netware.html">ġ MPM netware</a></li>
<li><a href="mod/mpmt_os2.html">ġ MPM os2</a></li>
<li><a href="mod/prefork.html">ġ MPM prefork</a></li>
<li><a href="mod/mpm_winnt.html">ġ MPM winnt</a></li>
<li><a href="mod/worker.html">ġ MPM worker</a></li>
</ul><ul><li><a href="mod/mod_access_compat.html">ġ mod_access_compat</a></li>
<li><a href="mod/mod_actions.html">ġ mod_actions</a></li>
<li><a href="mod/mod_alias.html">ġ mod_alias</a></li>
<li><a href="mod/mod_allowmethods.html">ġ mod_allowmethods</a></li>
<li><a href="mod/mod_asis.html">ġ mod_asis</a></li>
<li><a href="mod/mod_auth_basic.html">ġ mod_auth_basic</a></li>
<li><a href="mod/mod_auth_digest.html">ġ mod_auth_digest</a></li>
<li><a href="mod/mod_auth_form.html">ġ mod_auth_form</a></li>
<li><a href="mod/mod_authn_anon.html">ġ mod_authn_anon</a></li>
<li><a href="mod/mod_authn_core.html">ġ mod_authn_core</a></li>
<li><a href="mod/mod_authn_dbd.html">ġ mod_authn_dbd</a></li>
<li><a href="mod/mod_authn_dbm.html">ġ mod_authn_dbm</a></li>
<li><a href="mod/mod_authn_file.html">ġ mod_authn_file</a></li>
<li><a href="mod/mod_authn_socache.html">ġ mod_authn_socache</a></li>
<li><a href="mod/mod_authnz_fcgi.html">ġ mod_authnz_fcgi</a></li>
<li><a href="mod/mod_authnz_ldap.html">ġ mod_authnz_ldap</a></li>
<li><a href="mod/mod_authz_core.html">ġ mod_authz_core</a></li>
<li><a href="mod/mod_authz_dbd.html">ġ mod_authz_dbd</a></li>
<li><a href="mod/mod_authz_dbm.html">ġ mod_authz_dbm</a></li>
<li><a href="mod/mod_authz_groupfile.html">ġ mod_authz_groupfile</a></li>
<li><a href="mod/mod_authz_host.html">ġ mod_authz_host</a></li>
<li><a href="mod/mod_authz_owner.html">ġ mod_authz_owner</a></li>
<li><a href="mod/mod_authz_user.html">ġ mod_authz_user</a></li>
<li><a href="mod/mod_autoindex.html">ġ mod_autoindex</a></li>
<li><a href="mod/mod_brotli.html">ġ mod_brotli</a></li>
<li><a href="mod/mod_buffer.html">ġ mod_buffer</a></li>
<li><a href="mod/mod_cache.html">ġ mod_cache</a></li>
<li><a href="mod/mod_cache_disk.html">ġ mod_cache_disk</a></li>
<li><a href="mod/mod_cache_socache.html">ġ mod_cache_socache</a></li>
<li><a href="mod/mod_cern_meta.html">ġ mod_cern_meta</a></li>
<li><a href="mod/mod_cgi.html">ġ mod_cgi</a></li>
<li><a href="mod/mod_cgid.html">ġ mod_cgid</a></li>
<li><a href="mod/mod_charset_lite.html">ġ mod_charset_lite</a></li>
<li><a href="mod/mod_data.html">ġ mod_data</a></li>
<li><a href="mod/mod_dav.html">ġ mod_dav</a></li>
<li><a href="mod/mod_dav_fs.html">ġ mod_dav_fs</a></li>
<li><a href="mod/mod_dav_lock.html">ġ mod_dav_lock</a></li>
<li><a href="mod/mod_dbd.html">ġ mod_dbd</a></li>
<li><a href="mod/mod_deflate.html">ġ mod_deflate</a></li>
<li><a href="mod/mod_dialup.html">ġ mod_dialup</a></li>
<li><a href="mod/mod_dir.html">ġ mod_dir</a></li>
<li><a href="mod/mod_dumpio.html">ġ mod_dumpio</a></li>
<li><a href="mod/mod_echo.html">ġ mod_echo</a></li>
<li><a href="mod/mod_env.html">ġ mod_env</a></li>
<li><a href="mod/mod_example_hooks.html">ġ mod_example_hooks</a></li>
<li><a href="mod/mod_expires.html">ġ mod_expires</a></li>
<li><a href="mod/mod_ext_filter.html">ġ mod_ext_filter</a></li>
<li><a href="mod/mod_file_cache.html">ġ mod_file_cache</a></li>
<li><a href="mod/mod_filter.html">ġ mod_filter</a></li>
<li><a href="mod/mod_headers.html">ġ mod_headers</a></li>
<li><a href="mod/mod_heartbeat.html">ġ mod_heartbeat</a></li>
<li><a href="mod/mod_heartmonitor.html">ġ mod_heartmonitor</a></li>
<li><a href="mod/mod_http2.html">ġ mod_http2</a></li>
<li><a href="mod/mod_ident.html">ġ mod_ident</a></li>
<li><a href="mod/mod_imagemap.html">ġ mod_imagemap</a></li>
<li><a href="mod/mod_include.html">ġ mod_include</a></li>
<li><a href="mod/mod_info.html">ġ mod_info</a></li>
<li><a href="mod/mod_isapi.html">ġ mod_isapi</a></li>
<li><a href="mod/mod_lbmethod_bybusyness.html">ġ mod_lbmethod_bybusyness</a></li>
<li><a href="mod/mod_lbmethod_byrequests.html">ġ mod_lbmethod_byrequests</a></li>
<li><a href="mod/mod_lbmethod_bytraffic.html">ġ mod_lbmethod_bytraffic</a></li>
<li><a href="mod/mod_lbmethod_heartbeat.html">ġ mod_lbmethod_heartbeat</a></li>
<li><a href="mod/mod_ldap.html">ġ mod_ldap</a></li>
<li><a href="mod/mod_log_config.html">ġ mod_log_config</a></li>
<li><a href="mod/mod_log_debug.html">ġ mod_log_debug</a></li>
<li><a href="mod/mod_log_forensic.html">ġ mod_log_forensic</a></li>
<li><a href="mod/mod_logio.html">ġ mod_logio</a></li>
<li><a href="mod/mod_lua.html">ġ mod_lua</a></li>
<li><a href="mod/mod_macro.html">ġ mod_macro</a></li>
<li><a href="mod/mod_md.html">ġ mod_md</a></li>
<li><a href="mod/mod_mime.html">ġ mod_mime</a></li>
<li><a href="mod/mod_mime_magic.html">ġ mod_mime_magic</a></li>
<li><a href="mod/mod_negotiation.html">ġ mod_negotiation</a></li>
<li><a href="mod/mod_nw_ssl.html">ġ mod_nw_ssl</a></li>
<li><a href="mod/mod_privileges.html">ġ mod_privileges</a></li>
<li><a href="mod/mod_proxy.html">ġ mod_proxy</a></li>
<li><a href="mod/mod_proxy_ajp.html">ġ mod_proxy_ajp</a></li>
<li><a href="mod/mod_proxy_balancer.html">ġ mod_proxy_balancer</a></li>
<li><a href="mod/mod_proxy_connect.html">ġ mod_proxy_connect</a></li>
<li><a href="mod/mod_proxy_express.html">ġ mod_proxy_express</a></li>
<li><a href="mod/mod_proxy_fcgi.html">ġ mod_proxy_fcgi</a></li>
<li><a href="mod/mod_proxy_fdpass.html">ġ mod_proxy_fdpass</a></li>
<li><a href="mod/mod_proxy_ftp.html">ġ mod_proxy_ftp</a></li>
<li><a href="mod/mod_proxy_hcheck.html">ġ mod_proxy_hcheck</a></li>
<li><a href="mod/mod_proxy_html.html">ġ mod_proxy_html</a></li>
<li><a href="mod/mod_proxy_http.html">ġ mod_proxy_http</a></li>
<li><a href="mod/mod_proxy_http2.html">ġ mod_proxy_http2</a></li>
<li><a href="mod/mod_proxy_scgi.html">ġ mod_proxy_scgi</a></li>
<li><a href="mod/mod_proxy_uwsgi.html">ġ mod_proxy_uwsgi</a></li>
<li><a href="mod/mod_proxy_wstunnel.html">ġ mod_proxy_wstunnel</a></li>
<li><a href="mod/mod_ratelimit.html">ġ mod_ratelimit</a></li>
<li><a href="mod/mod_reflector.html">ġ mod_reflector</a></li>
<li><a href="mod/mod_remoteip.html">ġ mod_remoteip</a></li>
<li><a href="mod/mod_reqtimeout.html">ġ mod_reqtimeout</a></li>
<li><a href="mod/mod_request.html">ġ mod_request</a></li>
<li><a href="mod/mod_rewrite.html">ġ mod_rewrite</a></li>
<li><a href="mod/mod_sed.html">ġ mod_sed</a></li>
<li><a href="mod/mod_session.html">ġ mod_session</a></li>
<li><a href="mod/mod_session_cookie.html">ġ mod_session_cookie</a></li>
<li><a href="mod/mod_session_crypto.html">ġ mod_session_crypto</a></li>
<li><a href="mod/mod_session_dbd.html">ġ mod_session_dbd</a></li>
<li><a href="mod/mod_setenvif.html">ġ mod_setenvif</a></li>
<li><a href="mod/mod_slotmem_plain.html">ġ mod_slotmem_plain</a></li>
<li><a href="mod/mod_slotmem_shm.html">ġ mod_slotmem_shm</a></li>
<li><a href="mod/mod_so.html">ġ mod_so</a></li>
<li><a href="mod/mod_socache_dbm.html">ġ mod_socache_dbm</a></li>
<li><a href="mod/mod_socache_dc.html">ġ mod_socache_dc</a></li>
<li><a href="mod/mod_socache_memcache.html">ġ mod_socache_memcache</a></li>
<li><a href="mod/mod_socache_redis.html">ġ mod_socache_redis</a></li>
<li><a href="mod/mod_socache_shmcb.html">ġ mod_socache_shmcb</a></li>
<li><a href="mod/mod_speling.html">ġ mod_speling</a></li>
<li><a href="mod/mod_ssl.html">ġ mod_ssl</a></li>
<li><a href="mod/mod_status.html">ġ mod_status</a></li>
<li><a href="mod/mod_substitute.html">ġ mod_substitute</a></li>
<li><a href="mod/mod_suexec.html">ġ mod_suexec</a></li>
<li><a href="mod/mod_systemd.html">ġ mod_systemd</a></li>
<li><a href="mod/mod_unique_id.html">ġ mod_unique_id</a></li>
<li><a href="mod/mod_unixd.html">ġ mod_unixd</a></li>
<li><a href="mod/mod_userdir.html">ġ mod_userdir</a></li>
<li><a href="mod/mod_usertrack.html">ġ mod_usertrack</a></li>
<li><a href="mod/mod_version.html">ġ mod_version</a></li>
<li><a href="mod/mod_vhost_alias.html">ġ mod_vhost_alias</a></li>
<li><a href="mod/mod_watchdog.html">ġ mod_watchdog</a></li>
<li><a href="mod/mod_xml2enc.html">ġ mod_xml2enc</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="developer" id="developer"> </a></h2>
<ul><li class="separate"><a href="developer/"></a></li>
<li><a href="developer/API.html">Apache API </a></li>
<li><a href="developer/debugging.html">APR Ҵ </a></li>
<li><a href="developer/documenting.html">Apache 2.0 ȭ</a></li>
<li><a href="developer/hooks.html">Apache 2.0 (hook) Լ</a></li>
<li><a href="developer/modules.html">Apache 1.3 Apache 2.0
ϱ</a></li>
<li><a href="developer/request.html">Apache 2.0 ûó</a></li>
<li><a href="developer/filters.html">Apache 2.0 ۹</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="index" id="index"> </a></h2>
<ul><li><a href="glossary.html"></a></li>
<li><a href="mod/"> </a></li>
<li><a href="mod/directives.html">þ </a></li>
<li><a href="mod/quickreference.html">þ </a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sitemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sections.html.ja.utf8 0000664 0001751 0001751 00000101471 14743132254 021033 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>セクションの設定 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>セクションの設定</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/sections.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sections.html" title="Japanese"> ja </a> |
<a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p><a href="configuring.html">設定ファイル</a>中のディレクティブは
サーバ全体に適用されたり、特定のディレクトリやファイル、ホスト、URL にのみ
適用されるように制限したりすることができます。この文書は設定用のセクションの
コンテナや <code>.htaccess</code> ファイルを使って他の設定ディレクティブの
スコープを変更する方法を説明します。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#types">設定用セクションコンテナの種類</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#file-and-web">ファイルシステムとウェブ空間</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">バーチャルホスト</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#proxy">プロクシ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#whatwhere">どのディレクティブが使えるの?</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#mergin">セクションのマージ方法</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="types" id="types">設定用セクションコンテナの種類</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mod_version.html">mod_version</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>コンテナには二つの基本となる種類があります。ほとんどのコンテナは
各リクエストに対して評価されます。その場合、コンテナ中のディレクティブは
コンテナにマッチするリクエストにのみ適用されます。一方、
<code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>,
<code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>,
<code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
コンテナは
サーバの起動時と再起動時にのみ評価されます。起動時に条件が真であれば、
コンテナ中のディレクティブはすべてのリクエストに適用されます。条件が
偽であれば、コンテナ中のディレクティブは無視されます。</p>
<p><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> ディレクティブは
<code class="program"><a href="./programs/httpd.html">httpd</a></code> コマンドラインで適切なパラメータが定義されたときにのみ
適用されるディレクティブを囲います。例えば次の設定では、サーバが
<code>httpd -DClosedForNow</code> を使って起動されたときだけすべての
リクエストを別のサイトにリダイレクトします:</p>
<div class="example"><p><code>
<IfDefine ClosedForNow><br />
Redirect / http://otherserver.example.com/<br />
</IfDefine>
</code></p></div>
<p><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> は
非常に似ていますが、代わりにサーバ上でモジュールが使用可能な場合にのみ
適用可能なディレクティブを囲います。モジュールはサーバに
静的に組み込まれているか、動的に組み込むようになっていて、設定ファイル中で
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> の行がより前の
部分に書かれている必要があります。このディレクティブは特定のモジュールの
存在に関わらず設定ファイルが動作する必要がある場合にのみ使ってください。
常に動作して欲しいディレクティブを囲むために使うべきではありません。
存在しないモジュールに関する有用なエラーメッセージの発生を抑制してしまいますので。
</p>
<p>次の例では、<code class="module"><a href="./mod/mod_mime_magic.html">mod_mime_magic</a></code> があるときにのみ <code class="directive"><a href="./mod/mod_mime_magic.html#mimemagicfiles">MimeMagicFiles</a></code> ディレクティブが
適用されます。</p>
<div class="example"><p><code>
<IfModule mod_mime_magic.c><br />
MimeMagicFile conf/magic<br />
</IfModule>
</code></p></div>
<p><code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
ディレクティブは
<code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> や
<code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>と、
とてもよく似ていますが、稼働中のサーバのバージョンが特定のバージョンの時にのみ
適用されます。様々なバージョンの httpd を様々な設定で動作させることになる場合で、
テストスイートや巨大なネットワークでの用途を想定して、
このモジュールは設計されています。</p>
<div class="example"><p><code>
<IfVersion >= 2.1><br />
<span class="indent">
# this happens only in versions greater or<br />
# equal 2.1.0.<br />
</span>
</IfVersion>
</code></p></div>
<p><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>,
<code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>,
<code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code> ディレクティブは
テストの前に "!" を付けることで否定の条件を適用することができます。
また、これらのセクションはより複雑な制限を課すために入れ子にすることができます。
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="file-and-web" id="file-and-web">ファイルシステムとウェブ空間</a></h2>
<p>最もよく使われる設定のセクションコンテナはファイルシステムやウェブ空間の
特定の場所の設定を変更するものです。まず、この二つの違いを理解することが
大切です。ファイルシステムはオペレーティングシステムから見たディスクの内容です。
たとえば、デフォルトのインストールでは Apache は Unix ファイルシステムでは
<code>/usr/local/apache2</code> に、Windows ファイルシステムでは
<code>"c:/Program Files/Apache Group/Apache2"</code> に存在します。
(Apache では Windows でもパスセパレータとしてスラッシュを使うことに
気をつけてください。) 対照的に、ウェブ空間はあなたのサイトを
ウェブサーバから配信されるものとして見たもので、クライアントに見えるものです。
デフォルトの Unix 上の Apache のインストールではウェブ空間の
<code>/dir/</code> というパスはファイルシステムの
<code>/usr/local/apache2/htdocs/dir/</code> というパスに対応します。
ウェブページはデータベースや他の場所から動的に生成することもできますので、
ウェブ空間はファイルシステムに直接マップする必要はありません。</p>
<h3><a name="filesystem" id="filesystem">ファイルシステムコンテナ</a></h3>
<p><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> ディレクティブと
<code class="directive"><a href="./mod/core.html#files"><Files></a></code> ディレクティブ、それと
それらの正規表現版はディレクティブをファイルシステムの一部分に対して適用します。
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> セクションの
中のディレクティブは指定されたディレクトリとそのすべてのサブディレクトリに
適用されます。<a href="howto/htaccess.html">.htaccess ファイル</a>を
使うことでも同じ効果を得ることができます。例えば、次の設定では
<code>/var/web/dir1</code> とすべてのサブディレクトリに対して
ディレクトリインデックスを行ないます。</p>
<div class="example"><p><code>
<Directory /var/web/dir1><br />
Options +Indexes<br />
</Directory>
</code></p></div>
<p><code class="directive"><a href="./mod/core.html#files"><Files></a></code> セクションの
中にあるディレクティブはどのディレクトリにあるかに関わらず、指定された名前の
すべてのファイルに適用されます。ですから例えば以下の設定ディレクティブが
設定ファイルの主セクションに書かれたときには、すべての場所の
<code>private.html</code> という名前のファイルへのアクセスを拒否します。</p>
<div class="example"><p><code>
<Files private.html><br />
Order allow,deny<br />
Deny from all<br />
</Files>
</code></p></div>
<p>ファイルシステムの特定の場所にあるファイルを指定するために、
<code class="directive"><a href="./mod/core.html#files"><Files></a></code> セクションと
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> セクションを
組み合わせることができます。例えば、次の設定では
<code>/var/web/dir1/private.html</code>,
<code>/var/web/dir1/subdir2/private.html</code>,
<code>/var/web/dir1/subdir3/private.html</code> など、
<code>/var/web/dir1/</code> ディレクトリの下にあるすべての
<code>private.html</code> へのアクセスを拒否します。</p>
<div class="example"><p><code>
<Directory /var/web/dir1><br />
<Files private.html><br />
Order allow,deny<br />
Deny from all<br />
</Files><br />
</Directory>
</code></p></div>
<h3><a name="webspace" id="webspace">ウェブ空間コンテナ</a></h3>
<p>一方、<code class="directive"><a href="./mod/core.html#location"><Location></a></code>
ディレクティブとその<a class="glossarylink" href="./glossary.html#regex" title="用語集を参照">正規表現</a>版は
ウェブ空間上の内容に対して設定を変更します。
たとえば、次の設定では /private で始まる URL パスへのアクセスを制限します。
具体的には、
<code>http://yoursite.example.com/private</code>,
<code>http://yoursite.example.com/private123</code>,
<code>http://yoursite.example.com/private/dir/file.html</code>
へのリクエストや、
他の同様に <code>/private</code> 文字列で始まるリクエストに
適用されます。</p>
<div class="example"><p><code>
<Location /private><br />
Order Allow,Deny<br />
Deny from all<br />
</Location>
</code></p></div>
<p><code class="directive"><a href="./mod/core.html#location"><Location></a></code>
ディレクティブはファイルシステムと関係ある必要が全くありません。
たとえば次の例では、どのようにして特定の URL を
<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>で提供されている Apache
内部ハンドラにマップするかを示しています。ファイルシステムに
<code>server-status</code> というファイルが存在する必要はありません。</p>
<div class="example"><p><code>
<Location /server-status><br />
SetHandler server-status<br />
</Location>
</code></p></div>
<h3><a name="wildcards" id="wildcards">ワイルドカードと正規表現</a></h3>
<p><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>
ディレクティブでは、 C 標準ライブラリの <code>fnmatch</code> のように
shell スタイルのワイルドカードキャラクタが使用できます。
"*" 文字は任意の文字列にマッチし、"?" 文字は任意の 1 文字にマッチし、
"[<em>seq</em>]" は <em>seq</em> の任意の文字にマッチします。
"/" 文字はどのワイルドカードでもマッチされません。
明示的に指定する必要があります。</p>
<p>これより柔軟なマッチングが必要な場合は、これらのコンテナに正規表現
(regex) 版である
<code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>,
<code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>,
<code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>
があり、マッチを選択するのに perl 互換<a class="glossarylink" href="./glossary.html#regex" title="用語集を参照">正規表現</a>を使用できます。しかし、次の設定のマージに目を通して、
regex セクションを使用することで、ディレクティブの適用がどのように
変化するか把握しておいてください。</p>
<p>全ユーザディレクトリの設定を変更する、非 regex
ワイルドカードセクションは次のようになります。</p>
<div class="example"><p><code>
<Directory /home/*/public_html><br />
Options Indexes<br />
</Directory>
</code></p></div>
<p>regex セクションを使用することで、画像ファイルの多くのタイプに対する
アクセスを一度に拒否できます。</p>
<div class="example"><p><code>
<FilesMatch \.(?i:gif|jpe?g|png)$><br />
Order allow,deny<br />
Deny from all<br />
</FilesMatch>
</code></p></div>
<h3><a name="whichwhen" id="whichwhen">いつ何を使うか</a></h3>
<p>ファイルシステムコンテナとウェブ空間コンテナを使い分けるのは、
実際には非常に簡単です。ファイルシステムに依存する
オブジェクトにディレクティブを適応する場合は、必ず
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> か
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>
を使用します。ファイルシステムに依存しないオブジェクト
(データベースから生成されるウェブページなど)
にディレクティブを適用する際には、
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>
を使用します。</p>
<p>ファイルシステム上のオブジェクトへのアクセスを制限するために、
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>
を決して使用ないようにしましょう。
同一のファイルシステム位置にマップしている、ウェブ空間位置 (URL)
が多数あって、設定した制限を迂回されてしまうかもしれないからです。
例えば次の設定を考えてみましょう。</p>
<div class="example"><p><code>
<Location /dir/><br />
Order allow,deny<br />
Deny from all<br />
</Location>
</code></p></div>
<p><code>http://yoursite.example.com/dir/</code>
へのリクエストでは上手く動作します。しかし大文字小文字を区別しない
ファイルシステムを使っていたらどうなるでしょう?
<code>http://yoursite.example.com/DIR/</code>
へのリクエストで簡単にアクセス制限を迂回されてしまいます。これに対して
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
ディレクティブを使用すると、どのように呼び出されたかに関わらず
その場所から提供される内容に適用されます。
(例外はファイルシステムのリンクです。シンボリックリンクを使って、
同一のディレクトリを複数のファイルシステムに設置できます。
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
ディレクティブはパス名をリセットすることなくシンボリックリンクを
辿ります。ですから、高度なセキュリティが要求される場合は、
適切に <code class="directive"><a href="./mod/core.html#options">Options</a></code>
ディレクティブを使用してシンボリックリンクを無効にするべきです。)</p>
<p>大文字小文字を区別するファイルシステムを使用しているから上記のことは
無関係だと思われるかもしれませんが、
同一のファイルシステム位置に複数のウェブ空間位置をマップする方法は、
他にいくらでもあるということを覚えていてください。
ですからできる限りファイルシステムコンテナを使用してください。
しかしながら一つだけ例外があります。
<code><Location /></code> セクションはどんな URL
にも関わらず適用されるので、完全に安全です。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">バーチャルホスト</a></h2>
<p><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
コンテナは特定のホストに適用するディレクティブを格納します。
一台のマシンで複数のホストを異なる設定で提供したいときに有用です。
詳細に関しては<a href="vhosts/">バーチャルホストドキュメント</a>を
ご覧下さい。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">プロクシ</a></h2>
<p><code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
と <code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>
コンテナは、特定の URL にマッチする <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>
プロクシサーバを経由してアクセスしたサイトに対してのみ適用される
設定ディレクティブを格納します。例えば次の設定は、<code>cnn.com</code>
ウェブサイトにアクセスするために用いられるプロクシサーバを
制限します。</p>
<div class="example"><p><code>
<Proxy http://cnn.com/*><br />
Order allow,deny<br />
Deny from all<br />
</Proxy>
</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="whatwhere" id="whatwhere">どのディレクティブが使えるの?</a></h2>
<p>どのタイプの設定セクションでどのディレクティブが使用できるかは、
ディレクティブの <a href="mod/directive-dict.html#Context">Context</a>
を見てください。
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
で使用可能なものは全て、同様に
<code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>,
<code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>,
<code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>,
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>,
<code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>
セクションで使用可能です。しかしながら幾つか例外も存在します。</p>
<ul>
<li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> ディレクティブは
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
セクションでのみ使用可能です。</li>
<li><code>FollowSymLinks</code> と <code>SymLinksIfOwnerMatch</code> の
<code class="directive"><a href="./mod/core.html#options">Options</a></code> は、
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
セクションか <code>.htaccess</code> ファイルでのみ使用可能です。</li>
<li><code class="directive"><a href="./mod/core.html#options">Options</a></code> ディレクティブは、
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>
と <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></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="mergin" id="mergin">セクションのマージ方法</a></h2>
<p>マージの順番は以下のようになっています:</p>
<ol>
<li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> (正規表現無し) と
<code>.htaccess</code> を同時に (<code>.htaccess</code> が許可されていれば、それが
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> を上書きします)
</li>
<li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>
(と <code><Directory ~></code></li>
<li><code class="directive"><a href="./mod/core.html#files"><Files></a></code> と
<code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code> を同時に</li>
<li><code class="directive"><a href="./mod/core.html#location"><Location></a></code> と
<code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> を同時に</li>
</ol>
<p><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
以外は、それぞれのグループは設定ファイルに現れた順番に処理されます。
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> (上のグループ 1)
はディレクトリが短いものから長いものへと処理されます。ですから、
例えば <code><Directory /var/web/dir1></code> は
<code><Directory /var/web/dir/subdir></code> の前に処理されます。複数の
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> セクションが
同じディレクトリに
適用される場合は、設定ファイル中の順番に従って処理されます。
<code class="directive"><a href="./mod/core.html#include">Include</a></code>
によって挿入された設定は 挿入しているファイルの
<code class="directive"><a href="./mod/core.html#include">Include</a></code>
ディレクティブの位置にあったかのように扱われます。</p>
<p><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> セクション中のセクションは
バーチャルホストの定義の外側の対応するセクションの
<em>後</em>に適用されます。これによりバーチャルホストが
メインのサーバ設定を上書きできるようなります。</p>
<p><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> でリクエストが処理される場合は、
処理順番のうち、<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> コンテナの部分が
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
コンテナに取って代わられます。</p>
<p>後のセクションのディレクティブが前のセクションのものを上書きします。</p>
<div class="note"><h3>技術メモ</h3>
実際には、名前を変換する段階 (URL
をファイル名にマップするために <code>Alias</code> や
<code>DocumentRoot</code> が使用されるところ) の直前に
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>/<code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>
が行なわれます。
これらを適用した結果は変換が終わった後に完全に捨てられます。
</div>
<h3><a name="merge-examples" id="merge-examples">例</a></h3>
<p>次はマージの順番を示すための恣意的な例になっています。
リクエスト全てに適用されるとして、本例のディレクティブは
A > B > C > D > E の順番に適用されます。</p>
<div class="example"><p><code>
<Location /><br />
E<br />
</Location><br />
<br />
<Files f.html><br />
D<br />
</Files><br />
<br />
<VirtualHost *><br />
<Directory /a/b><br />
B<br />
</Directory><br />
</VirtualHost><br />
<br />
<DirectoryMatch "^.*b$"><br />
C<br />
</DirectoryMatch><br />
<br />
<Directory /a/b><br />
A<br />
</Directory><br />
<br />
</code></p></div>
<p>もっと具体的な、次の例を考えてみましょう。
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
セクションに設置されたアクセス制限に関わらず、
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>
セクションが最後に評価されて、サーバへのアクセスは制限されません。
言い換えれば、マージの順番は重要で、注意して使用してください!</p>
<div class="example"><p><code>
<Location /><br />
Order deny,allow<br />
Allow from all<br />
</Location><br />
<br />
# Woops! This <Directory> section will have no effect<br />
<Directory /><br />
Order allow,deny<br />
Allow from all<br />
Deny from badguy.example.com<br />
</Directory>
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/sections.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sections.html" title="Japanese"> ja </a> |
<a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sections.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/server-wide.html.ko.euc-kr 0000664 0001751 0001751 00000024645 14743132254 021766 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title> - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1> </h1>
<div class="toplang">
<p><span> : </span><a href="./en/server-wide.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/server-wide.html" title="Korean"> ko </a> |
<a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> <code class="module"><a href="./mod/core.html">core</a></code> ⺻ ൿ
ϱ ϴ þ Ϻθ Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#identification"> ĺ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#locations"> ġ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#resource">ڿ </a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="identification" id="identification"> ĺ</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code></li><li><code class="directive"><a href="./mod/core.html#serversignature">ServerSignature</a></code></li><li><code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code></li></ul></td></tr></table>
<p><code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code>
<code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> þ
ϴ
Ѵ. <code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code>
þ HTTP Ѵ.</p>
<p> <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
<code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code>
þ Ͽ ڱ URL . ,
Ŭ̾Ʈ 丮 û 丮 ڿ
ġ ڿ ü ̸
Ŭ̾Ʈ ̷ƮϿ, Ŭ̾Ʈ
ùٷ ã Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="locations" id="locations"> ġ</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#lockfile">LockFile</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code></li><li><code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code></li></ul></td></tr></table>
<p> þ ġ ϱ ʿ
ϵ ġ Ѵ. θ (/)
, <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>
ã´. root ƴ ڿ
ִ ο ʵ ض. ڼ
<a href="misc/security_tips.html#serverroot"> </a>
϶.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="resource" id="resource">ڿ </a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#limitrequestbody">LimitRequestBody</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfields">LimitRequestFields</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfieldsize">LimitRequestFieldsize</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestline">LimitRequestLine</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitcpu">RLimitCPU</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitmem">RLimitMEM</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitnproc">RLimitNPROC</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code></li></ul></td></tr></table>
<p><code class="directive">LimitRequest</code>* þ ġ
Ŭ̾Ʈ û ڿ Ѵ. ̷
Ͽ ź(denial of service)
ִ.</p>
<p><code class="directive">RLimit</code>* þ ġ ڽ
ϴ μ ڿ Ѵ. Ư CGI
ũƮ SSI exec ɾ ڿ Ѵ.</p>
<p><code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code>
þ ũ⸦ ϱ Netware Ѵ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/server-wide.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/server-wide.html" title="Korean"> ko </a> |
<a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/server-wide.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sitemap.html.ja.utf8 0000664 0001751 0001751 00000064554 14743132254 020660 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Site Map - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page">
<div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div>
<div id="page-content"><div id="preamble"><h1>Site Map</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>このページは現時点で利用可能な
<a href="./">Apache HTTP サーババージョン 2.4 のドキュメンテーション</a>
の一覧です。</p>
</div>
<div id="quickview"><ul id="toc">
<li><img alt="" src="./images/down.gif" /> <a href="#release">リリースのメモ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Apache HTTP サーバの使用</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#vhosts">Apache バーチャルホストドキュメント</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#faq">Apache サーバのよくある質問</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ssl">Apache の SSL/TLS 暗号化</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#howto">ガイド、チュートリアル、ハウツー</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#platform">プラットフォーム固有の情報</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Apache HTTP サーバとサポートプログラム</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#misc">Apache その他</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Apache モジュール</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">開発者のためのドキュメント</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#index">用語集と索引</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="release" id="release">リリースのメモ</a></h2>
<ul><li><a href="upgrading.html">2.2 から 2.4 へのアップグレード</a></li>
<li><a href="new_features_2_4.html">Apache 2.3/2.4 の新機能</a></li>
<li><a href="new_features_2_2.html">Apache 2.1/2.2 の新機能</a></li>
<li><a href="new_features_2_0.html">Apache 2.0 の新機能</a></li>
<li><a href="license.html">Apache License</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="using" id="using">Apache HTTP サーバの使用</a></h2>
<ul><li><a href="install.html">Apache のコンパイルとインストール</a></li>
<li><a href="invoking.html">Apache の起動</a></li>
<li><a href="stopping.html">サーバの停止と再起動</a></li>
<li><a href="configuring.html">設定ファイル</a></li>
<li><a href="sections.html">Directory, Location, Files セクションの動作方法</a></li>
<li><a href="caching.html">Content Caching</a></li>
<li><a href="server-wide.html">サーバ全体の設定</a></li>
<li><a href="logs.html">ログファイル</a></li>
<li><a href="urlmapping.html">URL からファイルシステム上の位置へのマップ</a></li>
<li><a href="misc/security_tips.html">セキュリティのコツ</a></li>
<li><a href="dso.html">動的共有オブジェクト (DSO) サポート</a></li>
<li><a href="content-negotiation.html">コンテントネゴシエーション</a></li>
<li><a href="custom-error.html">カスタムエラーレスポンス</a></li>
<li><a href="bind.html">Apache が使用するアドレスとポートの設定</a></li>
<li><a href="mpm.html">マルチプロセッシングモジュール (MPM)</a></li>
<li><a href="env.html">Apache における環境変数</a></li>
<li><a href="handler.html">Apache のハンドラの使用</a></li>
<li><a href="filter.html">フィルタ</a></li>
<li><a href="suexec.html">suEXEC サポート</a></li>
<li><a href="misc/perf-tuning.html">性能に関するヒント</a></li>
<li><a href="misc/rewriteguide.html">URL リライトガイド</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="vhosts" id="vhosts">Apache バーチャルホストドキュメント</a></h2>
<ul><li class="separate"><a href="vhosts/">概略</a></li>
<li><a href="vhosts/name-based.html">名前ベースのバーチャルホスト</a></li>
<li><a href="vhosts/ip-based.html">IP ベースのバーチャルホストのサポート</a></li>
<li><a href="vhosts/mass.html">動的に設定された大規模バーチャルホスト</a></li>
<li><a href="vhosts/examples.html">VirtualHost の例</a></li>
<li><a href="vhosts/details.html">バーチャルホストのマッチングの詳しい説明</a></li>
<li><a href="vhosts/fd-limits.html">ファイル記述子の限界</a></li>
<li><a href="dns-caveats.html">DNS と Apache とに関係する問題</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="faq" id="faq">Apache サーバのよくある質問</a></h2>
<ul><li><a href="faq/">概略</a></li>
<li><a href="faq/background.html">背景の説明</a></li>
<li><a href="faq/support.html">サポート</a></li>
<li><a href="faq/error.html">エラーメッセージ</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="ssl" id="ssl">Apache の SSL/TLS 暗号化</a></h2>
<ul><li class="separate"><a href="ssl/">概略</a></li>
<li><a href="ssl/ssl_intro.html">SSL/TLS 暗号化: 入門</a></li>
<li><a href="ssl/ssl_compat.html">SSL/TLS 暗号化: 互換性</a></li>
<li><a href="ssl/ssl_howto.html">SSL/TLS 暗号化: ハウツー</a></li>
<li><a href="ssl/ssl_faq.html">SSL/TLS 暗号化: FAQ</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="howto" id="howto">ガイド、チュートリアル、ハウツー</a></h2>
<ul><li class="separate"><a href="howto/">概略</a></li>
<li><a href="howto/auth.html">認証</a></li>
<li><a href="howto/cgi.html">CGI による動的コンテンツ</a></li>
<li><a href="howto/ssi.html">Server Side Includes 入門</a></li>
<li><a href="howto/htaccess.html">.htaccess ファイル</a></li>
<li><a href="howto/public_html.html">ユーザ毎のウェブディレクトリ</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="platform" id="platform">プラットフォーム固有の情報</a></h2>
<ul><li class="separate"><a href="platform/">概略</a></li>
<li><a href="platform/windows.html">Microsoft Windows での Apache の使用</a></li>
<li><a href="platform/win_compiling.html">Microsoft Windows での Apache
のコンパイル</a></li>
<li><a href="platform/netware.html">Novell NetWare で Apache を使う</a></li>
<li><a href="platform/perf-hp.html">HPUX で高性能ウェブサーバを実行する</a></li>
<li><a href="platform/ebcdic.html">EBCDIC 版 Apache</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="programs" id="programs">Apache HTTP サーバとサポートプログラム</a></h2>
<ul><li class="separate"><a href="programs/">概略</a></li>
<li><a href="programs/httpd.html">マニュアルページ: httpd</a></li>
<li><a href="programs/ab.html">マニュアルページ: ab</a></li>
<li><a href="programs/apachectl.html">マニュアルページ: apachectl</a></li>
<li><a href="programs/apxs.html">マニュアルページ: apxs</a></li>
<li><a href="programs/configure.html">マニュアルページ: configure</a></li>
<li><a href="programs/dbmmanage.html">マニュアルページ: dbmmanage</a></li>
<li><a href="programs/htcacheclean.html">マニュアルページ: htcacheclean</a></li>
<li><a href="programs/htdbm.html">マニュアルページ: htdbm</a></li>
<li><a href="programs/htdigest.html">マニュアルページ: htdigest</a></li>
<li><a href="programs/htpasswd.html">マニュアルページ: htpasswd</a></li>
<li><a href="programs/logresolve.html">マニュアルページ: logresolve</a></li>
<li><a href="programs/rotatelogs.html">マニュアルページ: rotatelogs</a></li>
<li><a href="programs/suexec.html">マニュアルページ: suexec</a></li>
<li><a href="programs/other.html">他のプログラム</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="misc" id="misc">Apache その他</a></h2>
<ul><li class="separate"><a href="misc/">概略</a></li>
<li><a href="misc/relevant_standards.html">関連する標準規格</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="modules" id="modules">Apache モジュール</a></h2>
<ul><li><a href="mod/module-dict.html">Apache ディレクティブの説明に使われる用語</a></li>
<li><a href="mod/directive-dict.html">Apache ディレクティブを説明に使われる用語</a></li>
</ul><ul><li><a href="mod/core.html">Apache コア機能</a></li>
<li><a href="mod/mpm_common.html">Apache MPM 共通ディレクティブ</a></li>
<li><a href="mod/event.html">Apache MPM event</a></li>
<li><a href="mod/mpm_netware.html">Apache MPM netware</a></li>
<li><a href="mod/mpmt_os2.html">Apache MPM os2</a></li>
<li><a href="mod/prefork.html">Apache MPM prefork</a></li>
<li><a href="mod/mpm_winnt.html">Apache MPM winnt</a></li>
<li><a href="mod/worker.html">Apache MPM worker</a></li>
</ul><ul><li><a href="mod/mod_access_compat.html">Apache モジュール mod_access_compat</a></li>
<li><a href="mod/mod_actions.html">Apache モジュール mod_actions</a></li>
<li><a href="mod/mod_alias.html">Apache モジュール mod_alias</a></li>
<li><a href="mod/mod_allowmethods.html">Apache モジュール mod_allowmethods</a></li>
<li><a href="mod/mod_asis.html">Apache モジュール mod_asis</a></li>
<li><a href="mod/mod_auth_basic.html">Apache モジュール mod_auth_basic</a></li>
<li><a href="mod/mod_auth_digest.html">Apache モジュール mod_auth_digest</a></li>
<li><a href="mod/mod_auth_form.html">Apache モジュール mod_auth_form</a></li>
<li><a href="mod/mod_authn_anon.html">Apache モジュール mod_authn_anon</a></li>
<li><a href="mod/mod_authn_core.html">Apache モジュール mod_authn_core</a></li>
<li><a href="mod/mod_authn_dbd.html">Apache モジュール mod_authn_dbd</a></li>
<li><a href="mod/mod_authn_dbm.html">Apache モジュール mod_authn_dbm</a></li>
<li><a href="mod/mod_authn_file.html">Apache モジュール mod_authn_file</a></li>
<li><a href="mod/mod_authn_socache.html">Apache モジュール mod_authn_socache</a></li>
<li><a href="mod/mod_authnz_fcgi.html">Apache モジュール mod_authnz_fcgi</a></li>
<li><a href="mod/mod_authnz_ldap.html">Apache モジュール mod_authnz_ldap</a></li>
<li><a href="mod/mod_authz_core.html">Apache モジュール mod_authz_core</a></li>
<li><a href="mod/mod_authz_dbd.html">Apache モジュール mod_authz_dbd</a></li>
<li><a href="mod/mod_authz_dbm.html">Apache モジュール mod_authz_dbm</a></li>
<li><a href="mod/mod_authz_groupfile.html">Apache モジュール mod_authz_groupfile</a></li>
<li><a href="mod/mod_authz_host.html">Apache モジュール mod_authz_host</a></li>
<li><a href="mod/mod_authz_owner.html">Apache モジュール mod_authz_owner</a></li>
<li><a href="mod/mod_authz_user.html">Apache モジュール mod_authz_user</a></li>
<li><a href="mod/mod_autoindex.html">Apache モジュール mod_autoindex</a></li>
<li><a href="mod/mod_brotli.html">Apache モジュール mod_brotli</a></li>
<li><a href="mod/mod_buffer.html">Apache モジュール mod_buffer</a></li>
<li><a href="mod/mod_cache.html">Apache モジュール mod_cache</a></li>
<li><a href="mod/mod_cache_disk.html">Apache モジュール mod_cache_disk</a></li>
<li><a href="mod/mod_cache_socache.html">Apache モジュール mod_cache_socache</a></li>
<li><a href="mod/mod_cern_meta.html">Apache モジュール mod_cern_meta</a></li>
<li><a href="mod/mod_cgi.html">Apache モジュール mod_cgi</a></li>
<li><a href="mod/mod_cgid.html">Apache モジュール mod_cgid</a></li>
<li><a href="mod/mod_charset_lite.html">Apache モジュール mod_charset_lite</a></li>
<li><a href="mod/mod_data.html">Apache モジュール mod_data</a></li>
<li><a href="mod/mod_dav.html">Apache モジュール mod_dav</a></li>
<li><a href="mod/mod_dav_fs.html">Apache モジュール mod_dav_fs</a></li>
<li><a href="mod/mod_dav_lock.html">Apache モジュール mod_dav_lock</a></li>
<li><a href="mod/mod_dbd.html">Apache モジュール mod_dbd</a></li>
<li><a href="mod/mod_deflate.html">Apache モジュール mod_deflate</a></li>
<li><a href="mod/mod_dialup.html">Apache モジュール mod_dialup</a></li>
<li><a href="mod/mod_dir.html">Apache モジュール mod_dir</a></li>
<li><a href="mod/mod_dumpio.html">Apache モジュール mod_dumpio</a></li>
<li><a href="mod/mod_echo.html">Apache モジュール mod_echo</a></li>
<li><a href="mod/mod_env.html">Apache モジュール mod_env</a></li>
<li><a href="mod/mod_example_hooks.html">Apache モジュール mod_example_hooks</a></li>
<li><a href="mod/mod_expires.html">Apache モジュール mod_expires</a></li>
<li><a href="mod/mod_ext_filter.html">Apache モジュール mod_ext_filter</a></li>
<li><a href="mod/mod_file_cache.html">Apache モジュール mod_file_cache</a></li>
<li><a href="mod/mod_filter.html">Apache モジュール mod_filter</a></li>
<li><a href="mod/mod_headers.html">Apache モジュール mod_headers</a></li>
<li><a href="mod/mod_heartbeat.html">Apache モジュール mod_heartbeat</a></li>
<li><a href="mod/mod_heartmonitor.html">Apache モジュール mod_heartmonitor</a></li>
<li><a href="mod/mod_http2.html">Apache モジュール mod_http2</a></li>
<li><a href="mod/mod_ident.html">Apache モジュール mod_ident</a></li>
<li><a href="mod/mod_imagemap.html">Apache モジュール mod_imagemap</a></li>
<li><a href="mod/mod_include.html">Apache モジュール mod_include</a></li>
<li><a href="mod/mod_info.html">Apache モジュール mod_info</a></li>
<li><a href="mod/mod_isapi.html">Apache モジュール mod_isapi</a></li>
<li><a href="mod/mod_lbmethod_bybusyness.html">Apache モジュール mod_lbmethod_bybusyness</a></li>
<li><a href="mod/mod_lbmethod_byrequests.html">Apache モジュール mod_lbmethod_byrequests</a></li>
<li><a href="mod/mod_lbmethod_bytraffic.html">Apache モジュール mod_lbmethod_bytraffic</a></li>
<li><a href="mod/mod_lbmethod_heartbeat.html">Apache モジュール mod_lbmethod_heartbeat</a></li>
<li><a href="mod/mod_ldap.html">Apache モジュール mod_ldap</a></li>
<li><a href="mod/mod_log_config.html">Apache モジュール mod_log_config</a></li>
<li><a href="mod/mod_log_debug.html">Apache モジュール mod_log_debug</a></li>
<li><a href="mod/mod_log_forensic.html">Apache モジュール mod_log_forensic</a></li>
<li><a href="mod/mod_logio.html">Apache モジュール mod_logio</a></li>
<li><a href="mod/mod_lua.html">Apache モジュール mod_lua</a></li>
<li><a href="mod/mod_macro.html">Apache モジュール mod_macro</a></li>
<li><a href="mod/mod_md.html">Apache モジュール mod_md</a></li>
<li><a href="mod/mod_mime.html">Apache モジュール mod_mime</a></li>
<li><a href="mod/mod_mime_magic.html">Apache モジュール mod_mime_magic</a></li>
<li><a href="mod/mod_negotiation.html">Apache モジュール mod_negotiation</a></li>
<li><a href="mod/mod_nw_ssl.html">Apache モジュール mod_nw_ssl</a></li>
<li><a href="mod/mod_privileges.html">Apache モジュール mod_privileges</a></li>
<li><a href="mod/mod_proxy.html">Apache モジュール mod_proxy</a></li>
<li><a href="mod/mod_proxy_ajp.html">Apache モジュール mod_proxy_ajp</a></li>
<li><a href="mod/mod_proxy_balancer.html">Apache モジュール mod_proxy_balancer</a></li>
<li><a href="mod/mod_proxy_connect.html">Apache モジュール mod_proxy_connect</a></li>
<li><a href="mod/mod_proxy_express.html">Apache モジュール mod_proxy_express</a></li>
<li><a href="mod/mod_proxy_fcgi.html">Apache モジュール mod_proxy_fcgi</a></li>
<li><a href="mod/mod_proxy_fdpass.html">Apache モジュール mod_proxy_fdpass</a></li>
<li><a href="mod/mod_proxy_ftp.html">Apache モジュール mod_proxy_ftp</a></li>
<li><a href="mod/mod_proxy_hcheck.html">Apache モジュール mod_proxy_hcheck</a></li>
<li><a href="mod/mod_proxy_html.html">Apache モジュール mod_proxy_html</a></li>
<li><a href="mod/mod_proxy_http.html">Apache モジュール mod_proxy_http</a></li>
<li><a href="mod/mod_proxy_http2.html">Apache モジュール mod_proxy_http2</a></li>
<li><a href="mod/mod_proxy_scgi.html">Apache モジュール mod_proxy_scgi</a></li>
<li><a href="mod/mod_proxy_uwsgi.html">Apache モジュール mod_proxy_uwsgi</a></li>
<li><a href="mod/mod_proxy_wstunnel.html">Apache モジュール mod_proxy_wstunnel</a></li>
<li><a href="mod/mod_ratelimit.html">Apache モジュール mod_ratelimit</a></li>
<li><a href="mod/mod_reflector.html">Apache モジュール mod_reflector</a></li>
<li><a href="mod/mod_remoteip.html">Apache モジュール mod_remoteip</a></li>
<li><a href="mod/mod_reqtimeout.html">Apache モジュール mod_reqtimeout</a></li>
<li><a href="mod/mod_request.html">Apache モジュール mod_request</a></li>
<li><a href="mod/mod_rewrite.html">Apache モジュール mod_rewrite</a></li>
<li><a href="mod/mod_sed.html">Apache モジュール mod_sed</a></li>
<li><a href="mod/mod_session.html">Apache モジュール mod_session</a></li>
<li><a href="mod/mod_session_cookie.html">Apache モジュール mod_session_cookie</a></li>
<li><a href="mod/mod_session_crypto.html">Apache モジュール mod_session_crypto</a></li>
<li><a href="mod/mod_session_dbd.html">Apache モジュール mod_session_dbd</a></li>
<li><a href="mod/mod_setenvif.html">Apache モジュール mod_setenvif</a></li>
<li><a href="mod/mod_slotmem_plain.html">Apache モジュール mod_slotmem_plain</a></li>
<li><a href="mod/mod_slotmem_shm.html">Apache モジュール mod_slotmem_shm</a></li>
<li><a href="mod/mod_so.html">Apache モジュール mod_so</a></li>
<li><a href="mod/mod_socache_dbm.html">Apache モジュール mod_socache_dbm</a></li>
<li><a href="mod/mod_socache_dc.html">Apache モジュール mod_socache_dc</a></li>
<li><a href="mod/mod_socache_memcache.html">Apache モジュール mod_socache_memcache</a></li>
<li><a href="mod/mod_socache_redis.html">Apache モジュール mod_socache_redis</a></li>
<li><a href="mod/mod_socache_shmcb.html">Apache モジュール mod_socache_shmcb</a></li>
<li><a href="mod/mod_speling.html">Apache モジュール mod_speling</a></li>
<li><a href="mod/mod_ssl.html">Apache モジュール mod_ssl</a></li>
<li><a href="mod/mod_status.html">Apache モジュール mod_status</a></li>
<li><a href="mod/mod_substitute.html">Apache モジュール mod_substitute</a></li>
<li><a href="mod/mod_suexec.html">Apache モジュール mod_suexec</a></li>
<li><a href="mod/mod_systemd.html">Apache モジュール mod_systemd</a></li>
<li><a href="mod/mod_unique_id.html">Apache モジュール mod_unique_id</a></li>
<li><a href="mod/mod_unixd.html">Apache モジュール mod_unixd</a></li>
<li><a href="mod/mod_userdir.html">Apache モジュール mod_userdir</a></li>
<li><a href="mod/mod_usertrack.html">Apache モジュール mod_usertrack</a></li>
<li><a href="mod/mod_version.html">Apache モジュール mod_version</a></li>
<li><a href="mod/mod_vhost_alias.html">Apache モジュール mod_vhost_alias</a></li>
<li><a href="mod/mod_watchdog.html">Apache モジュール mod_watchdog</a></li>
<li><a href="mod/mod_xml2enc.html">Apache モジュール mod_xml2enc</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="developer" id="developer">開発者のためのドキュメント</a></h2>
<ul><li class="separate"><a href="developer/">概略</a></li>
<li><a href="developer/API.html">Apache API メモ</a></li>
<li><a href="developer/debugging.html">APR
のメモリアロケーションのデバッグ</a></li>
<li><a href="developer/documenting.html">Apache 2.0 の説明を書く</a></li>
<li><a href="developer/hooks.html">Apache 2.0 フック関数</a></li>
<li><a href="developer/modules.html">Apache 1.3 から Apache 2.0 にモジュールを
移植する</a></li>
<li><a href="developer/request.html">Apache 2.0 のリクエスト処理</a></li>
<li><a href="developer/filters.html">Apache 2.0 のフィルタの動作の仕方</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="index" id="index">用語集と索引</a></h2>
<ul><li><a href="glossary.html">用語集</a></li>
<li><a href="mod/">モジュール索引</a></li>
<li><a href="mod/directives.html">ディレクティブ索引</a></li>
<li><a href="mod/quickreference.html">ディレクティブ クイックリファレンス</a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sitemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/server-wide.html.ja.utf8 0000664 0001751 0001751 00000030024 14743132254 021433 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>サーバ全体の設定 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>サーバ全体の設定</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./en/server-wide.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/server-wide.html" title="Japanese"> ja </a> |
<a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>このドキュメントでは<code class="module"><a href="./mod/core.html">core</a></code>
サーバのディレクティブの中で、
基本動作を設定するためのものを説明します。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#identification">サーバ ID</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#locations">ファイルの位置</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#resource">リソースの制限</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="identification" id="identification">サーバ ID</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code></li><li><code class="directive"><a href="./mod/core.html#serversignature">ServerSignature</a></code></li><li><code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li></ul></td></tr></table>
<p><code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code> ディレクティブと
<code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code>
ディレクティブは、エラーメッセージなどのサーバが作るドキュメントに、
どのようなサーバの情報を表示するかを制御します。
<code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> ディレクティブは、Server HTTP
レスポンスヘッダフィールドの値を設定します。</p>
<p><code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>,
<code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code>,
<code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
ディレクティブは、サーバが自分自身を参照する URL
を作るときに使われます。
たとえば、クライアントがディレクトリを要求して、
そのディレクトリ名の最後にスラッシュが付いていないような場合には、
ドキュメントの相対的な参照を正しく解決できるようにするために、
Apache は最後のスラッシュを含んだ完全なパスにクライアントを
リダイレクトさせる必要があります。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="locations" id="locations">ファイルの位置</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#lockfile">LockFile</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code></li><li><code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code></li></ul></td></tr></table>
<p>これらのディレクティブは Apache
が適切な動作をするために必要な各種ファイルの位置を制御します。
パスがスラッシュ (/) で始まっていないときは、ファイルは
<code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> からの相対パスとして
探されます。root
以外のユーザが書き込み可能なパスにファイルを置く場合は注意が必要です。
詳細は<a href="misc/security_tips.html#serverroot">「セキュリティ情報」</a>
を参照してください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="resource" id="resource">リソースの制限</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#limitrequestbody">LimitRequestBody</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfields">LimitRequestFields</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfieldsize">LimitRequestFieldsize</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestline">LimitRequestLine</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitcpu">RLimitCPU</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitmem">RLimitMEM</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitnproc">RLimitNPROC</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code></li></ul></td></tr></table>
<p><code class="directive">LimitRequest</code>* ディレクティブは Apache
がクライアントからのリクエスト読み込みで使う
リソースを制限するために使われます。これらの値を制限することで、
いくつかのサービス拒否攻撃は影響を和らげることができます。</p>
<p><code class="directive">RLimit</code>* ディレクティブは、Apache の子プロセスから
fork されたプロセスが使用するリソースを制限するために使われます。
特に、これは CGI スクリプトと SSI exec
コマンドで使われるリソースを制御します。</p>
<p><code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code> は Netware
でのみ、スタックの大きさを制御するために使われます。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./en/server-wide.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/server-wide.html" title="Japanese"> ja </a> |
<a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/server-wide.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sitemap.html.es 0000664 0001751 0001751 00000063460 14743132254 020003 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Mapa de este sitio web - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="./images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="./">Versión 2.4</a></div>
<div id="page-content"><div id="preamble"><h1>Mapa de este sitio web</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">Esta traducción podría estar
obsoleta. Consulte la versión en inglés de la
documentación para comprobar si se han producido cambios
recientemente.</div>
<p>Esta página contiene la lista con los documentos actualmente
disponibles de la <a href="./">Versión 2.4 de la
Documentación del Servidor HTTP Apache</a>.</p>
</div>
<div id="quickview"><ul id="toc">
<li><img alt="" src="./images/down.gif" /> <a href="#release">Notas de la Versión</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Funcionamiento del Servidor HTTP Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#vhosts">Documentación sobre Hosting Virtual en Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#faq">Preguntas Más Frecuentes sobre Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ssl">Encriptado SSL/TLS con Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#howto">Guías, Tutoriales, y HowTos</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#platform">Notas específicas sobre plataformas</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Programas de soporte y el Servidor HTTP Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#misc">Documentación adicional sobre Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Módulos de Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Documentación para desarrolladores</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#index">Glosario e Índice</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="release" id="release">Notas de la Versión</a></h2>
<ul><li><a href="upgrading.html">Pasar a usar Apache 2.0 desde Apache 1.3</a></li>
<li><a href="new_features_2_0.html">Nuevas funcionalidades de Apache 2.0</a></li>
<li><a href="license.html">Licencia Apache</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="using" id="using">Funcionamiento del Servidor HTTP Apache</a></h2>
<ul><li><a href="install.html">Compilación e Instalación de Apache</a></li>
<li><a href="invoking.html">Iniciar Apache</a></li>
<li><a href="stopping.html">Parar y reiniciar Apache</a></li>
<li><a href="configuring.html">Ficheros de Configuración</a></li>
<li><a href="sections.html">Funcionamiento de las secciones Directory, Location y Files</a></li>
<li><a href="server-wide.html">Configuración Básica de Apache</a></li>
<li><a href="logs.html">Archivos Log</a></li>
<li><a href="urlmapping.html">Mapear URLs a ubicaciones de un sistema de ficheros</a></li>
<li><a href="misc/security_tips.html">Consejos de Seguridad</a></li>
<li><a href="dso.html">Soporte de Objetos Dinámicos Compartidos (DSO)</a></li>
<li><a href="content-negotiation.html">Negociación de Contenido</a></li>
<li><a href="custom-error.html">Mensajes de Error Personalizados</a></li>
<li><a href="bind.html">Fijar las direcciones y los puertos que usa Apache</a></li>
<li><a href="mpm.html">Módulos de Multiproceso (MPMs)</a></li>
<li><a href="env.html">Variables de entorno en Apache</a></li>
<li><a href="handler.html">El uso de Handlers en Apache</a></li>
<li><a href="filter.html">Filtros</a></li>
<li><a href="suexec.html">Soporte de suEXEC</a></li>
<li><a href="misc/perf-tuning.html">Rendimiento del servidor</a></li>
<li><a href="misc/rewriteguide.html">Documentación adicional sobre mod_rewrite</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="vhosts" id="vhosts">Documentación sobre Hosting Virtual en Apache</a></h2>
<ul><li class="separate"><a href="vhosts/">Visión General</a></li>
<li><a href="vhosts/name-based.html">Hosting Virtual basado en nombres</a></li>
<li><a href="vhosts/ip-based.html">Soporte de Hosting Virtual Basado en IPs</a></li>
<li><a href="vhosts/mass.html">Configurar de forma Dinámica el Hosting Virtual masivo en Apache</a></li>
<li><a href="vhosts/examples.html">Ejemplos de Hosting Virtual</a></li>
<li><a href="vhosts/details.html">Discusión en profundidad sobre los tipos de Hosting Virtual</a></li>
<li><a href="vhosts/fd-limits.html">Limitaciones de los descriptores de ficheros</a></li>
<li><a href="dns-caveats.html">Asuntos relacionados con DNS y Apache</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="faq" id="faq">Preguntas Más Frecuentes sobre Apache</a></h2>
<ul><li><a href="faq/">Visión General</a></li>
<li><a href="faq/support.html">Soporte</a></li>
<li><a href="faq/error.html">Mensajes de error</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="ssl" id="ssl">Encriptado SSL/TLS con Apache</a></h2>
<ul><li class="separate"><a href="ssl/">Visión General</a></li>
<li><a href="ssl/ssl_intro.html">Encriptado SSL/TLS: Introducción</a></li>
<li><a href="ssl/ssl_compat.html">Encriptado SSL/TLS: Compatibilidad</a></li>
<li><a href="ssl/ssl_howto.html">Encriptado SSL/TLS: How-To</a></li>
<li><a href="ssl/ssl_faq.html">Encriptado SSL/TLS: Preguntas Frecuentes</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="howto" id="howto">Guías, Tutoriales, y HowTos</a></h2>
<ul><li class="separate"><a href="howto/">Visión General</a></li>
<li><a href="howto/auth.html">Autentificación</a></li>
<li><a href="howto/cgi.html">Contenido Dinámico con CGIs</a></li>
<li><a href="howto/ssi.html">Introducción a Server Side Includes</a></li>
<li><a href="howto/htaccess.html">Archivos .htaccess</a></li>
<li><a href="howto/public_html.html">Directorios web para cada usuario</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="platform" id="platform">Notas específicas sobre plataformas</a></h2>
<ul><li class="separate"><a href="platform/">Visión General</a></li>
<li><a href="platform/windows.html">Usar Apache con Microsoft Windows</a></li>
<li><a href="platform/win_compiling.html">Compilar Apache para
Microsoft Windows</a></li>
<li><a href="platform/netware.html">Usar
Apache con Novell NetWare</a></li>
<li><a href="platform/perf-hp.html">Servidor Web de alto rendimiento con
HPUX</a></li>
<li><a href="platform/ebcdic.html">La versión EBCDIC de
Apache</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="programs" id="programs">Programas de soporte y el Servidor HTTP Apache</a></h2>
<ul><li class="separate"><a href="programs/">Visión General</a></li>
<li><a href="programs/httpd.html">Página de Ayuda: httpd</a></li>
<li><a href="programs/ab.html">Página de Ayuda: ab</a></li>
<li><a href="programs/apachectl.html">Página de Ayuda: apachectl</a></li>
<li><a href="programs/apxs.html">Página de Ayuda: apxs</a></li>
<li><a href="programs/configure.html">Página de Ayuda: configure</a></li>
<li><a href="programs/dbmmanage.html">Página de Ayuda: dbmmanage</a></li>
<li><a href="programs/htcacheclean.html">Página de Ayuda: htcacheclean</a></li>
<li><a href="programs/htdigest.html">Página de Ayuda: htdigest</a></li>
<li><a href="programs/htpasswd.html">Página de Ayuda: htpasswd</a></li>
<li><a href="programs/logresolve.html">Página de Ayuda: logresolve</a></li>
<li><a href="programs/rotatelogs.html">Página de Ayuda: rotatelogs</a></li>
<li><a href="programs/suexec.html">Página de Ayuda: suexec</a></li>
<li><a href="programs/other.html">Otros Programas</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="misc" id="misc">Documentación adicional sobre Apache</a></h2>
<ul><li class="separate"><a href="misc/">Visión General</a></li>
<li><a href="misc/relevant_standards.html">Estándares Importantes</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="modules" id="modules">Módulos de Apache</a></h2>
<ul><li><a href="mod/module-dict.html">Definiciones de términos usados
para describir los módulos de Apache</a></li>
<li><a href="mod/directive-dict.html">Definiciones de términos
usados para describir las directivas de Apache</a></li>
</ul><ul><li><a href="mod/core.html">Funcionalidad Básica de Apache</a></li>
<li><a href="mod/mpm_common.html">Directivas Comunes de los MPM de
Apache</a></li>
<li><a href="mod/event.html">MPM de Apache event</a></li>
<li><a href="mod/mpm_netware.html">MPM de Apache netware</a></li>
<li><a href="mod/mpmt_os2.html">MPM de Apache os2</a></li>
<li><a href="mod/prefork.html">MPM de Apache prefork</a></li>
<li><a href="mod/mpm_winnt.html">MPM de Apache winnt</a></li>
<li><a href="mod/worker.html">MPM de Apache worker</a></li>
</ul><ul><li><a href="mod/mod_access_compat.html">Módulo Apache mod_access_compat</a></li>
<li><a href="mod/mod_actions.html">Módulo Apache mod_actions</a></li>
<li><a href="mod/mod_alias.html">Módulo Apache mod_alias</a></li>
<li><a href="mod/mod_allowmethods.html">Módulo Apache mod_allowmethods</a></li>
<li><a href="mod/mod_asis.html">Módulo Apache mod_asis</a></li>
<li><a href="mod/mod_auth_basic.html">Módulo Apache mod_auth_basic</a></li>
<li><a href="mod/mod_auth_digest.html">Módulo Apache mod_auth_digest</a></li>
<li><a href="mod/mod_auth_form.html">Módulo Apache mod_auth_form</a></li>
<li><a href="mod/mod_authn_anon.html">Módulo Apache mod_authn_anon</a></li>
<li><a href="mod/mod_authn_core.html">Módulo Apache mod_authn_core</a></li>
<li><a href="mod/mod_authn_dbd.html">Módulo Apache mod_authn_dbd</a></li>
<li><a href="mod/mod_authn_dbm.html">Módulo Apache mod_authn_dbm</a></li>
<li><a href="mod/mod_authn_file.html">Módulo Apache mod_authn_file</a></li>
<li><a href="mod/mod_authn_socache.html">Módulo Apache mod_authn_socache</a></li>
<li><a href="mod/mod_authnz_fcgi.html">Módulo Apache mod_authnz_fcgi</a></li>
<li><a href="mod/mod_authnz_ldap.html">Módulo Apache mod_authnz_ldap</a></li>
<li><a href="mod/mod_authz_core.html">Módulo Apache mod_authz_core</a></li>
<li><a href="mod/mod_authz_dbd.html">Módulo Apache mod_authz_dbd</a></li>
<li><a href="mod/mod_authz_dbm.html">Módulo Apache mod_authz_dbm</a></li>
<li><a href="mod/mod_authz_groupfile.html">Módulo Apache mod_authz_groupfile</a></li>
<li><a href="mod/mod_authz_host.html">Módulo Apache mod_authz_host</a></li>
<li><a href="mod/mod_authz_owner.html">Módulo Apache mod_authz_owner</a></li>
<li><a href="mod/mod_authz_user.html">Módulo Apache mod_authz_user</a></li>
<li><a href="mod/mod_autoindex.html">Módulo Apache mod_autoindex</a></li>
<li><a href="mod/mod_brotli.html">Módulo Apache mod_brotli</a></li>
<li><a href="mod/mod_buffer.html">Módulo Apache mod_buffer</a></li>
<li><a href="mod/mod_cache.html">Módulo Apache mod_cache</a></li>
<li><a href="mod/mod_cache_disk.html">Módulo Apache mod_cache_disk</a></li>
<li><a href="mod/mod_cache_socache.html">Módulo Apache mod_cache_socache</a></li>
<li><a href="mod/mod_cern_meta.html">Módulo Apache mod_cern_meta</a></li>
<li><a href="mod/mod_cgi.html">Módulo Apache mod_cgi</a></li>
<li><a href="mod/mod_cgid.html">Módulo Apache mod_cgid</a></li>
<li><a href="mod/mod_charset_lite.html">Módulo Apache mod_charset_lite</a></li>
<li><a href="mod/mod_data.html">Módulo Apache mod_data</a></li>
<li><a href="mod/mod_dav.html">Módulo Apache mod_dav</a></li>
<li><a href="mod/mod_dav_fs.html">Módulo Apache mod_dav_fs</a></li>
<li><a href="mod/mod_dav_lock.html">Módulo Apache mod_dav_lock</a></li>
<li><a href="mod/mod_dbd.html">Módulo Apache mod_dbd</a></li>
<li><a href="mod/mod_deflate.html">Módulo Apache mod_deflate</a></li>
<li><a href="mod/mod_dialup.html">Módulo Apache mod_dialup</a></li>
<li><a href="mod/mod_dir.html">Módulo Apache mod_dir</a></li>
<li><a href="mod/mod_dumpio.html">Módulo Apache mod_dumpio</a></li>
<li><a href="mod/mod_echo.html">Módulo Apache mod_echo</a></li>
<li><a href="mod/mod_env.html">Módulo Apache mod_env</a></li>
<li><a href="mod/mod_example_hooks.html">Módulo Apache mod_example_hooks</a></li>
<li><a href="mod/mod_expires.html">Módulo Apache mod_expires</a></li>
<li><a href="mod/mod_ext_filter.html">Módulo Apache mod_ext_filter</a></li>
<li><a href="mod/mod_file_cache.html">Módulo Apache mod_file_cache</a></li>
<li><a href="mod/mod_filter.html">Módulo Apache mod_filter</a></li>
<li><a href="mod/mod_headers.html">Módulo Apache mod_headers</a></li>
<li><a href="mod/mod_heartbeat.html">Módulo Apache mod_heartbeat</a></li>
<li><a href="mod/mod_heartmonitor.html">Módulo Apache mod_heartmonitor</a></li>
<li><a href="mod/mod_http2.html">Módulo Apache mod_http2</a></li>
<li><a href="mod/mod_ident.html">Módulo Apache mod_ident</a></li>
<li><a href="mod/mod_imagemap.html">Módulo Apache mod_imagemap</a></li>
<li><a href="mod/mod_include.html">Módulo Apache mod_include</a></li>
<li><a href="mod/mod_info.html">Módulo Apache mod_info</a></li>
<li><a href="mod/mod_isapi.html">Módulo Apache mod_isapi</a></li>
<li><a href="mod/mod_lbmethod_bybusyness.html">Módulo Apache mod_lbmethod_bybusyness</a></li>
<li><a href="mod/mod_lbmethod_byrequests.html">Módulo Apache mod_lbmethod_byrequests</a></li>
<li><a href="mod/mod_lbmethod_bytraffic.html">Módulo Apache mod_lbmethod_bytraffic</a></li>
<li><a href="mod/mod_lbmethod_heartbeat.html">Módulo Apache mod_lbmethod_heartbeat</a></li>
<li><a href="mod/mod_ldap.html">Módulo Apache mod_ldap</a></li>
<li><a href="mod/mod_log_config.html">Módulo Apache mod_log_config</a></li>
<li><a href="mod/mod_log_debug.html">Módulo Apache mod_log_debug</a></li>
<li><a href="mod/mod_log_forensic.html">Módulo Apache mod_log_forensic</a></li>
<li><a href="mod/mod_logio.html">Módulo Apache mod_logio</a></li>
<li><a href="mod/mod_lua.html">Módulo Apache mod_lua</a></li>
<li><a href="mod/mod_macro.html">Módulo Apache mod_macro</a></li>
<li><a href="mod/mod_md.html">Módulo Apache mod_md</a></li>
<li><a href="mod/mod_mime.html">Módulo Apache mod_mime</a></li>
<li><a href="mod/mod_mime_magic.html">Módulo Apache mod_mime_magic</a></li>
<li><a href="mod/mod_negotiation.html">Módulo Apache mod_negotiation</a></li>
<li><a href="mod/mod_nw_ssl.html">Módulo Apache mod_nw_ssl</a></li>
<li><a href="mod/mod_privileges.html">Módulo Apache mod_privileges</a></li>
<li><a href="mod/mod_proxy.html">Módulo Apache mod_proxy</a></li>
<li><a href="mod/mod_proxy_ajp.html">Módulo Apache mod_proxy_ajp</a></li>
<li><a href="mod/mod_proxy_balancer.html">Módulo Apache mod_proxy_balancer</a></li>
<li><a href="mod/mod_proxy_connect.html">Módulo Apache mod_proxy_connect</a></li>
<li><a href="mod/mod_proxy_express.html">Módulo Apache mod_proxy_express</a></li>
<li><a href="mod/mod_proxy_fcgi.html">Módulo Apache mod_proxy_fcgi</a></li>
<li><a href="mod/mod_proxy_fdpass.html">Módulo Apache mod_proxy_fdpass</a></li>
<li><a href="mod/mod_proxy_ftp.html">Módulo Apache mod_proxy_ftp</a></li>
<li><a href="mod/mod_proxy_hcheck.html">Módulo Apache mod_proxy_hcheck</a></li>
<li><a href="mod/mod_proxy_html.html">Módulo Apache mod_proxy_html</a></li>
<li><a href="mod/mod_proxy_http.html">Módulo Apache mod_proxy_http</a></li>
<li><a href="mod/mod_proxy_http2.html">Módulo Apache mod_proxy_http2</a></li>
<li><a href="mod/mod_proxy_scgi.html">Módulo Apache mod_proxy_scgi</a></li>
<li><a href="mod/mod_proxy_uwsgi.html">Módulo Apache mod_proxy_uwsgi</a></li>
<li><a href="mod/mod_proxy_wstunnel.html">Módulo Apache mod_proxy_wstunnel</a></li>
<li><a href="mod/mod_ratelimit.html">Módulo Apache mod_ratelimit</a></li>
<li><a href="mod/mod_reflector.html">Módulo Apache mod_reflector</a></li>
<li><a href="mod/mod_remoteip.html">Módulo Apache mod_remoteip</a></li>
<li><a href="mod/mod_reqtimeout.html">Módulo Apache mod_reqtimeout</a></li>
<li><a href="mod/mod_request.html">Módulo Apache mod_request</a></li>
<li><a href="mod/mod_rewrite.html">Módulo Apache mod_rewrite</a></li>
<li><a href="mod/mod_sed.html">Módulo Apache mod_sed</a></li>
<li><a href="mod/mod_session.html">Módulo Apache mod_session</a></li>
<li><a href="mod/mod_session_cookie.html">Módulo Apache mod_session_cookie</a></li>
<li><a href="mod/mod_session_crypto.html">Módulo Apache mod_session_crypto</a></li>
<li><a href="mod/mod_session_dbd.html">Módulo Apache mod_session_dbd</a></li>
<li><a href="mod/mod_setenvif.html">Módulo Apache mod_setenvif</a></li>
<li><a href="mod/mod_slotmem_plain.html">Módulo Apache mod_slotmem_plain</a></li>
<li><a href="mod/mod_slotmem_shm.html">Módulo Apache mod_slotmem_shm</a></li>
<li><a href="mod/mod_so.html">Módulo Apache mod_so</a></li>
<li><a href="mod/mod_socache_dbm.html">Módulo Apache mod_socache_dbm</a></li>
<li><a href="mod/mod_socache_dc.html">Módulo Apache mod_socache_dc</a></li>
<li><a href="mod/mod_socache_memcache.html">Módulo Apache mod_socache_memcache</a></li>
<li><a href="mod/mod_socache_redis.html">Módulo Apache mod_socache_redis</a></li>
<li><a href="mod/mod_socache_shmcb.html">Módulo Apache mod_socache_shmcb</a></li>
<li><a href="mod/mod_speling.html">Módulo Apache mod_speling</a></li>
<li><a href="mod/mod_ssl.html">Módulo Apache mod_ssl</a></li>
<li><a href="mod/mod_status.html">Módulo Apache mod_status</a></li>
<li><a href="mod/mod_substitute.html">Módulo Apache mod_substitute</a></li>
<li><a href="mod/mod_suexec.html">Módulo Apache mod_suexec</a></li>
<li><a href="mod/mod_systemd.html">Módulo Apache mod_systemd</a></li>
<li><a href="mod/mod_unique_id.html">Módulo Apache mod_unique_id</a></li>
<li><a href="mod/mod_unixd.html">Módulo Apache mod_unixd</a></li>
<li><a href="mod/mod_userdir.html">Módulo Apache mod_userdir</a></li>
<li><a href="mod/mod_usertrack.html">Módulo Apache mod_usertrack</a></li>
<li><a href="mod/mod_version.html">Módulo Apache mod_version</a></li>
<li><a href="mod/mod_vhost_alias.html">Módulo Apache mod_vhost_alias</a></li>
<li><a href="mod/mod_watchdog.html">Módulo Apache mod_watchdog</a></li>
<li><a href="mod/mod_xml2enc.html">Módulo Apache mod_xml2enc</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="developer" id="developer">Documentación para desarrolladores</a></h2>
<ul><li class="separate"><a href="developer/">Visión General</a></li>
<li><a href="developer/API.html">Notas sobre la API de Apache</a></li>
<li><a href="developer/debugging.html">Debugear la Reserva de Memoria en APR</a></li>
<li><a href="developer/documenting.html">Documentando Apache 2.0</a></li>
<li><a href="developer/hooks.html">Funciones Hook de Apache 2.0</a></li>
<li><a href="developer/modules.html">Convertir Módulos de Apache 1.3 a Apache 2.0</a></li>
<li><a href="developer/request.html">Procesamiento de Peticiones en Apache 2.0</a></li>
<li><a href="developer/filters.html">Funcionamiento de los filtros en Apache 2.0</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="index" id="index">Glosario e Índice</a></h2>
<ul><li><a href="glossary.html">Glosario</a></li>
<li><a href="mod/">Índice de Módulos</a></li>
<li><a href="mod/directives.html">Índice de Directivas</a></li>
<li><a href="mod/quickreference.html">Guía Rápida de
Referencia de Directivas</a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sitemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sitemap.html.zh-cn.utf8 0000664 0001751 0001751 00000057652 14743132254 021306 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="zh-cn" xml:lang="zh-cn"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>站点导航 - Apache HTTP 服务器 版本 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page">
<div id="page-header">
<p class="menu"><a href="./mod/">模块</a> | <a href="./mod/directives.html">指令</a> | <a href="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="./glossary.html">术语</a> | <a href="./sitemap.html">网站导航</a></p>
<p class="apache">Apache HTTP 服务器版本 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div>
<div id="page-content"><div id="preamble"><h1>站点导航</h1>
<div class="toplang">
<p><span>可用语言: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">此翻译可能过期。要了解最近的更改，请阅读英文版。</div>
<p>本页列出了
<a href="./">Apache HTTP 服务器 2.4
的全部文档</a>。</p>
</div>
<div id="quickview"><ul id="toc">
<li><img alt="" src="./images/down.gif" /> <a href="#release">发行说明</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">使用 Apache HTTP 服务器</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#vhosts">Apache 虚拟主机文档</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rewrite">URL 改写指南</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ssl">Apache SSL/TLS 加密</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#howto">指南与教程</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#platform">平台相关说明</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Apache HTTP 服务器与支持程序</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#misc">Apache 杂项文档</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Apache 模块</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">开发者文档</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#index">术语与索引</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="release" id="release">发行说明</a></h2>
<ul><li><a href="upgrading.html">从 2.2 升级到 2.4</a></li>
<li><a href="new_features_2_4.html">Apache 2.3/2.4 的新特性</a></li>
<li><a href="new_features_2_2.html">Apache 2.1/2.2 的新特性</a></li>
<li><a href="new_features_2_0.html">Apache 2.0 的新特性</a></li>
<li><a href="license.html">Apache 许可证</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="using" id="using">使用 Apache HTTP 服务器</a></h2>
<ul><li><a href="install.html">编译与安装 Apache</a></li>
<li><a href="invoking.html">启动 Apache</a></li>
<li><a href="stopping.html">停止与重启 Apache</a></li>
<li><a href="configuring.html">配置文件</a></li>
<li><a href="sections.html">配置片段</a></li>
<li><a href="caching.html">缓存指南</a></li>
<li><a href="server-wide.html">服务器全局配置</a></li>
<li><a href="logs.html">日志文件</a></li>
<li><a href="urlmapping.html">从 URL 映射到文件系统</a></li>
<li><a href="misc/security_tips.html">安全技巧</a></li>
<li><a href="dso.html">动态共享对象(DSO)</a></li>
<li><a href="content-negotiation.html">内容协商</a></li>
<li><a href="custom-error.html">定制错误响应</a></li>
<li><a href="bind.html">绑定指定地址与端口</a></li>
<li><a href="mpm.html">多处理模块(MPM)</a></li>
<li><a href="env.html">环境变量</a></li>
<li><a href="handler.html">Apache 的处理器</a></li>
<li><a href="filter.html">过滤器</a></li>
<li><a href="suexec.html">执行 CGI 前的用户切换(suEXEC)</a></li>
<li><a href="misc/perf-tuning.html">性能调谐</a></li>
<li><a href="http://wiki.apache.org/httpd/FAQ">常见问题</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="vhosts" id="vhosts">Apache 虚拟主机文档</a></h2>
<ul><li class="separate"><a href="vhosts/">概述</a></li>
<li><a href="vhosts/name-based.html">基于名称的虚拟主机</a></li>
<li><a href="vhosts/ip-based.html">基于 IP 的虚拟主机</a></li>
<li><a href="vhosts/mass.html">动态配置的大规模虚拟主机</a></li>
<li><a href="vhosts/examples.html">虚拟主机样例</a></li>
<li><a href="vhosts/details.html">虚拟主机匹配的深入讨论</a></li>
<li><a href="vhosts/fd-limits.html">文件句柄限制</a></li>
<li><a href="dns-caveats.html">Apache 的 DNS 相关问题</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="rewrite" id="rewrite">URL 改写指南</a></h2>
<ul><li class="separate"><a href="rewrite/">概述</a></li>
<li><a href="mod/mod_rewrite.html">mod_rewrite 参考文档</a></li>
<li><a href="rewrite/intro.html">简介</a></li>
<li><a href="rewrite/flags.html">标志</a></li>
<li><a href="rewrite/tech.html">技术细节</a></li>
<li><a href="rewrite/remapping.html">重新映射 URL</a></li>
<li><a href="rewrite/access.html">访问控制</a></li>
<li><a href="rewrite/advanced.html">高级技术</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="ssl" id="ssl">Apache SSL/TLS 加密</a></h2>
<ul><li class="separate"><a href="ssl/">概述</a></li>
<li><a href="ssl/ssl_intro.html">SSL/TLS 加密: 简介</a></li>
<li><a href="ssl/ssl_compat.html">SSL/TLS 加密: 兼容性</a></li>
<li><a href="ssl/ssl_howto.html">SSL/TLS 加密: 常见操作</a></li>
<li><a href="ssl/ssl_faq.html">SSL/TLS 加密: 常见问题</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="howto" id="howto">指南与教程</a></h2>
<ul><li class="separate"><a href="howto/">概述</a></li>
<li><a href="howto/auth.html">认证，授权与访问控制</a></li>
<li><a href="howto/cgi.html">CGI 与动态内容</a></li>
<li><a href="howto/ssi.html">服务器端插入</a></li>
<li><a href="howto/htaccess.html">.htaccess 文件</a></li>
<li><a href="howto/public_html.html">用户私人网站目录(public_html)</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="platform" id="platform">平台相关说明</a></h2>
<ul><li class="separate"><a href="platform/">概述</a></li>
<li><a href="platform/windows.html">在 Microsoft Windows 中使用 Apache</a></li>
<li><a href="platform/win_compiling.html">为 Microsoft Windows 编译 Apache</a></li>
<li><a href="platform/netware.html">在 Novell NetWare 中使用 Apache</a></li>
<li><a href="platform/perf-hp.html">在 HPUX 中运行高性能 web 服务器</a></li>
<li><a href="platform/ebcdic.html">Apache 与 EBCDIC 系统</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="programs" id="programs">Apache HTTP 服务器与支持程序</a></h2>
<ul><li class="separate"><a href="programs/">概述</a></li>
<li><a href="programs/httpd.html">手册: httpd</a></li>
<li><a href="programs/ab.html">手册: ab</a></li>
<li><a href="programs/apachectl.html">手册: apachectl</a></li>
<li><a href="programs/apxs.html">手册: apxs</a></li>
<li><a href="programs/configure.html">手册: configure</a></li>
<li><a href="programs/dbmmanage.html">手册: dbmmanage</a></li>
<li><a href="programs/htcacheclean.html">手册: htcacheclean</a></li>
<li><a href="programs/htdbm.html">手册: htdbm</a></li>
<li><a href="programs/htdigest.html">手册: htdigest</a></li>
<li><a href="programs/htpasswd.html">手册: htpasswd</a></li>
<li><a href="programs/logresolve.html">手册: logresolve</a></li>
<li><a href="programs/rotatelogs.html">手册: rotatelogs</a></li>
<li><a href="programs/suexec.html">手册: suexec</a></li>
<li><a href="programs/other.html">其它程序</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="misc" id="misc">Apache 杂项文档</a></h2>
<ul><li class="separate"><a href="misc/">概述</a></li>
<li><a href="misc/relevant_standards.html">相关标准</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="modules" id="modules">Apache 模块</a></h2>
<ul><li><a href="mod/module-dict.html">描述模块的术语</a></li>
<li><a href="mod/directive-dict.html">描述指令的术语</a></li>
</ul><ul><li><a href="mod/core.html">Apache 核心特性</a></li>
<li><a href="mod/mpm_common.html">Apache MPM 通用指令</a></li>
<li><a href="mod/event.html">Apache MPM event</a></li>
<li><a href="mod/mpm_netware.html">Apache MPM netware</a></li>
<li><a href="mod/mpmt_os2.html">Apache MPM os2</a></li>
<li><a href="mod/prefork.html">Apache MPM prefork</a></li>
<li><a href="mod/mpm_winnt.html">Apache MPM winnt</a></li>
<li><a href="mod/worker.html">Apache MPM worker</a></li>
</ul><ul><li><a href="mod/mod_access_compat.html">Apache 模块 mod_access_compat</a></li>
<li><a href="mod/mod_actions.html">Apache 模块 mod_actions</a></li>
<li><a href="mod/mod_alias.html">Apache 模块 mod_alias</a></li>
<li><a href="mod/mod_allowmethods.html">Apache 模块 mod_allowmethods</a></li>
<li><a href="mod/mod_asis.html">Apache 模块 mod_asis</a></li>
<li><a href="mod/mod_auth_basic.html">Apache 模块 mod_auth_basic</a></li>
<li><a href="mod/mod_auth_digest.html">Apache 模块 mod_auth_digest</a></li>
<li><a href="mod/mod_auth_form.html">Apache 模块 mod_auth_form</a></li>
<li><a href="mod/mod_authn_anon.html">Apache 模块 mod_authn_anon</a></li>
<li><a href="mod/mod_authn_core.html">Apache 模块 mod_authn_core</a></li>
<li><a href="mod/mod_authn_dbd.html">Apache 模块 mod_authn_dbd</a></li>
<li><a href="mod/mod_authn_dbm.html">Apache 模块 mod_authn_dbm</a></li>
<li><a href="mod/mod_authn_file.html">Apache 模块 mod_authn_file</a></li>
<li><a href="mod/mod_authn_socache.html">Apache 模块 mod_authn_socache</a></li>
<li><a href="mod/mod_authnz_fcgi.html">Apache 模块 mod_authnz_fcgi</a></li>
<li><a href="mod/mod_authnz_ldap.html">Apache 模块 mod_authnz_ldap</a></li>
<li><a href="mod/mod_authz_core.html">Apache 模块 mod_authz_core</a></li>
<li><a href="mod/mod_authz_dbd.html">Apache 模块 mod_authz_dbd</a></li>
<li><a href="mod/mod_authz_dbm.html">Apache 模块 mod_authz_dbm</a></li>
<li><a href="mod/mod_authz_groupfile.html">Apache 模块 mod_authz_groupfile</a></li>
<li><a href="mod/mod_authz_host.html">Apache 模块 mod_authz_host</a></li>
<li><a href="mod/mod_authz_owner.html">Apache 模块 mod_authz_owner</a></li>
<li><a href="mod/mod_authz_user.html">Apache 模块 mod_authz_user</a></li>
<li><a href="mod/mod_autoindex.html">Apache 模块 mod_autoindex</a></li>
<li><a href="mod/mod_brotli.html">Apache 模块 mod_brotli</a></li>
<li><a href="mod/mod_buffer.html">Apache 模块 mod_buffer</a></li>
<li><a href="mod/mod_cache.html">Apache 模块 mod_cache</a></li>
<li><a href="mod/mod_cache_disk.html">Apache 模块 mod_cache_disk</a></li>
<li><a href="mod/mod_cache_socache.html">Apache 模块 mod_cache_socache</a></li>
<li><a href="mod/mod_cern_meta.html">Apache 模块 mod_cern_meta</a></li>
<li><a href="mod/mod_cgi.html">Apache 模块 mod_cgi</a></li>
<li><a href="mod/mod_cgid.html">Apache 模块 mod_cgid</a></li>
<li><a href="mod/mod_charset_lite.html">Apache 模块 mod_charset_lite</a></li>
<li><a href="mod/mod_data.html">Apache 模块 mod_data</a></li>
<li><a href="mod/mod_dav.html">Apache 模块 mod_dav</a></li>
<li><a href="mod/mod_dav_fs.html">Apache 模块 mod_dav_fs</a></li>
<li><a href="mod/mod_dav_lock.html">Apache 模块 mod_dav_lock</a></li>
<li><a href="mod/mod_dbd.html">Apache 模块 mod_dbd</a></li>
<li><a href="mod/mod_deflate.html">Apache 模块 mod_deflate</a></li>
<li><a href="mod/mod_dialup.html">Apache 模块 mod_dialup</a></li>
<li><a href="mod/mod_dir.html">Apache 模块 mod_dir</a></li>
<li><a href="mod/mod_dumpio.html">Apache 模块 mod_dumpio</a></li>
<li><a href="mod/mod_echo.html">Apache 模块 mod_echo</a></li>
<li><a href="mod/mod_env.html">Apache 模块 mod_env</a></li>
<li><a href="mod/mod_example_hooks.html">Apache 模块 mod_example_hooks</a></li>
<li><a href="mod/mod_expires.html">Apache 模块 mod_expires</a></li>
<li><a href="mod/mod_ext_filter.html">Apache 模块 mod_ext_filter</a></li>
<li><a href="mod/mod_file_cache.html">Apache 模块 mod_file_cache</a></li>
<li><a href="mod/mod_filter.html">Apache 模块 mod_filter</a></li>
<li><a href="mod/mod_headers.html">Apache 模块 mod_headers</a></li>
<li><a href="mod/mod_heartbeat.html">Apache 模块 mod_heartbeat</a></li>
<li><a href="mod/mod_heartmonitor.html">Apache 模块 mod_heartmonitor</a></li>
<li><a href="mod/mod_http2.html">Apache 模块 mod_http2</a></li>
<li><a href="mod/mod_ident.html">Apache 模块 mod_ident</a></li>
<li><a href="mod/mod_imagemap.html">Apache 模块 mod_imagemap</a></li>
<li><a href="mod/mod_include.html">Apache 模块 mod_include</a></li>
<li><a href="mod/mod_info.html">Apache 模块 mod_info</a></li>
<li><a href="mod/mod_isapi.html">Apache 模块 mod_isapi</a></li>
<li><a href="mod/mod_lbmethod_bybusyness.html">Apache 模块 mod_lbmethod_bybusyness</a></li>
<li><a href="mod/mod_lbmethod_byrequests.html">Apache 模块 mod_lbmethod_byrequests</a></li>
<li><a href="mod/mod_lbmethod_bytraffic.html">Apache 模块 mod_lbmethod_bytraffic</a></li>
<li><a href="mod/mod_lbmethod_heartbeat.html">Apache 模块 mod_lbmethod_heartbeat</a></li>
<li><a href="mod/mod_ldap.html">Apache 模块 mod_ldap</a></li>
<li><a href="mod/mod_log_config.html">Apache 模块 mod_log_config</a></li>
<li><a href="mod/mod_log_debug.html">Apache 模块 mod_log_debug</a></li>
<li><a href="mod/mod_log_forensic.html">Apache 模块 mod_log_forensic</a></li>
<li><a href="mod/mod_logio.html">Apache 模块 mod_logio</a></li>
<li><a href="mod/mod_lua.html">Apache 模块 mod_lua</a></li>
<li><a href="mod/mod_macro.html">Apache 模块 mod_macro</a></li>
<li><a href="mod/mod_md.html">Apache 模块 mod_md</a></li>
<li><a href="mod/mod_mime.html">Apache 模块 mod_mime</a></li>
<li><a href="mod/mod_mime_magic.html">Apache 模块 mod_mime_magic</a></li>
<li><a href="mod/mod_negotiation.html">Apache 模块 mod_negotiation</a></li>
<li><a href="mod/mod_nw_ssl.html">Apache 模块 mod_nw_ssl</a></li>
<li><a href="mod/mod_privileges.html">Apache 模块 mod_privileges</a></li>
<li><a href="mod/mod_proxy.html">Apache 模块 mod_proxy</a></li>
<li><a href="mod/mod_proxy_ajp.html">Apache 模块 mod_proxy_ajp</a></li>
<li><a href="mod/mod_proxy_balancer.html">Apache 模块 mod_proxy_balancer</a></li>
<li><a href="mod/mod_proxy_connect.html">Apache 模块 mod_proxy_connect</a></li>
<li><a href="mod/mod_proxy_express.html">Apache 模块 mod_proxy_express</a></li>
<li><a href="mod/mod_proxy_fcgi.html">Apache 模块 mod_proxy_fcgi</a></li>
<li><a href="mod/mod_proxy_fdpass.html">Apache 模块 mod_proxy_fdpass</a></li>
<li><a href="mod/mod_proxy_ftp.html">Apache 模块 mod_proxy_ftp</a></li>
<li><a href="mod/mod_proxy_hcheck.html">Apache 模块 mod_proxy_hcheck</a></li>
<li><a href="mod/mod_proxy_html.html">Apache 模块 mod_proxy_html</a></li>
<li><a href="mod/mod_proxy_http.html">Apache 模块 mod_proxy_http</a></li>
<li><a href="mod/mod_proxy_http2.html">Apache 模块 mod_proxy_http2</a></li>
<li><a href="mod/mod_proxy_scgi.html">Apache 模块 mod_proxy_scgi</a></li>
<li><a href="mod/mod_proxy_uwsgi.html">Apache 模块 mod_proxy_uwsgi</a></li>
<li><a href="mod/mod_proxy_wstunnel.html">Apache 模块 mod_proxy_wstunnel</a></li>
<li><a href="mod/mod_ratelimit.html">Apache 模块 mod_ratelimit</a></li>
<li><a href="mod/mod_reflector.html">Apache 模块 mod_reflector</a></li>
<li><a href="mod/mod_remoteip.html">Apache 模块 mod_remoteip</a></li>
<li><a href="mod/mod_reqtimeout.html">Apache 模块 mod_reqtimeout</a></li>
<li><a href="mod/mod_request.html">Apache 模块 mod_request</a></li>
<li><a href="mod/mod_rewrite.html">Apache 模块 mod_rewrite</a></li>
<li><a href="mod/mod_sed.html">Apache 模块 mod_sed</a></li>
<li><a href="mod/mod_session.html">Apache 模块 mod_session</a></li>
<li><a href="mod/mod_session_cookie.html">Apache 模块 mod_session_cookie</a></li>
<li><a href="mod/mod_session_crypto.html">Apache 模块 mod_session_crypto</a></li>
<li><a href="mod/mod_session_dbd.html">Apache 模块 mod_session_dbd</a></li>
<li><a href="mod/mod_setenvif.html">Apache 模块 mod_setenvif</a></li>
<li><a href="mod/mod_slotmem_plain.html">Apache 模块 mod_slotmem_plain</a></li>
<li><a href="mod/mod_slotmem_shm.html">Apache 模块 mod_slotmem_shm</a></li>
<li><a href="mod/mod_so.html">Apache 模块 mod_so</a></li>
<li><a href="mod/mod_socache_dbm.html">Apache 模块 mod_socache_dbm</a></li>
<li><a href="mod/mod_socache_dc.html">Apache 模块 mod_socache_dc</a></li>
<li><a href="mod/mod_socache_memcache.html">Apache 模块 mod_socache_memcache</a></li>
<li><a href="mod/mod_socache_redis.html">Apache 模块 mod_socache_redis</a></li>
<li><a href="mod/mod_socache_shmcb.html">Apache 模块 mod_socache_shmcb</a></li>
<li><a href="mod/mod_speling.html">Apache 模块 mod_speling</a></li>
<li><a href="mod/mod_ssl.html">Apache 模块 mod_ssl</a></li>
<li><a href="mod/mod_status.html">Apache 模块 mod_status</a></li>
<li><a href="mod/mod_substitute.html">Apache 模块 mod_substitute</a></li>
<li><a href="mod/mod_suexec.html">Apache 模块 mod_suexec</a></li>
<li><a href="mod/mod_systemd.html">Apache 模块 mod_systemd</a></li>
<li><a href="mod/mod_unique_id.html">Apache 模块 mod_unique_id</a></li>
<li><a href="mod/mod_unixd.html">Apache 模块 mod_unixd</a></li>
<li><a href="mod/mod_userdir.html">Apache 模块 mod_userdir</a></li>
<li><a href="mod/mod_usertrack.html">Apache 模块 mod_usertrack</a></li>
<li><a href="mod/mod_version.html">Apache 模块 mod_version</a></li>
<li><a href="mod/mod_vhost_alias.html">Apache 模块 mod_vhost_alias</a></li>
<li><a href="mod/mod_watchdog.html">Apache 模块 mod_watchdog</a></li>
<li><a href="mod/mod_xml2enc.html">Apache 模块 mod_xml2enc</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="developer" id="developer">开发者文档</a></h2>
<ul><li class="separate"><a href="developer/">概述</a></li>
<li><a href="developer/API.html">Apache API 说明</a></li>
<li><a href="developer/debugging.html">在 APR 中调试内存分配</a></li>
<li><a href="developer/documenting.html">Apache 2.x 文档</a></li>
<li><a href="developer/hooks.html">Apache 2.x 钩子函数</a></li>
<li><a href="developer/modules.html">将模块从 Apache 1.3 移植到 Apache 2.x</a></li>
<li><a href="developer/request.html">Apache 2.x 中的请求处理</a></li>
<li><a href="developer/filters.html">Apache 2.x 中的过滤器</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="index" id="index">术语与索引</a></h2>
<ul><li><a href="glossary.html">术语</a></li>
<li><a href="mod/">模块索引</a></li>
<li><a href="mod/directives.html">指令索引</a></li>
<li><a href="mod/quickreference.html">指令快速参考</a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>可用语言: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">评论</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sitemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />基于 <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="http://wiki.apache.org/httpd/FAQ">常见问题</a> | <a href="./glossary.html">术语</a> | <a href="./sitemap.html">网站导航</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sections.html.tr.utf8 0000664 0001751 0001751 00000122636 14743132254 021074 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Yapılandırma Bölümleri - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Yapılandırma Bölümleri</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/sections.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sections.html" title="Türkçe"> tr </a></p>
</div>
<p><a href="configuring.html">Yapılandırma dosyaları</a>ndaki
yönergeler sunucunun tamamına uygulanacağı gibi sadece belli dizinler,
dosyalar, konaklar veya URL’lere uygulanmakla sınırlanabilir. Bu
belgede, yapılandırma bölümü taşıyıcılarınının veya
<code>.htaccess</code> dosyalarının, yapılandırma dosyalarındaki diğer
yönergelerin etki alanlarını değiştirtirmek için nasıl kullanılacağı
açıklanmıştır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#types">Yapılandırma Bölümü Taşıyıcılarının Türleri</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#file-and-web">Dosya Sistemi, Site Alanı ve Mantıksal İfadeler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Sanal Konaklar</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#proxy">Vekil</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#whatwhere">Hangi Yönergelere İzin Veriliyor?</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#merging">Bölümler Nasıl Katıştırılır?</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="types" id="types">Yapılandırma Bölümü Taşıyıcılarının Türleri</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mod_version.html">mod_version</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#if"><If></a></code></li><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/mod_md.html#mdomainsetsection"><MDomainSet></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>İki temel taşıyıcı türü vardır. Taşıyıcıların çoğu her istek için
değerlendirmeye alınır. Taşıyıcılardaki yönergeler ise sadece bu
taşıyıcılarla eşleşen istekler için uygulanır. Diğer yandan,
<code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>,
<code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> ve
<code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
taşıyıcıları sadece sunucu başlatılırken veya yeniden başlatılırken
değerlendirmeye alınır. Başlatma sırasında gerektirdikleri koşullar
sağlanıyorsa içerdikleri yönergeler tüm isteklere uygulanır. Aksi
takdirde, içerdikleri yönergeler yok sayılır.</p>
<p><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> yönergesi
sadece <code class="program"><a href="./programs/httpd.html">httpd</a></code> komut satırında uygun parametreler
tanımlanmışsa uygulanabilecek yönergeleri içerir. Örneğin, aşağıdaki
yapılandırma ile tüm isteklerin diğer siteye yönlendirilebilmesi sadece
sunucu <code>httpd -DClosedForNow</code> komut satırı ile başlatıldığı
takdirde mümkün olur:</p>
<pre class="prettyprint lang-config"><IfDefine ClosedForNow>
Redirect "/" "http://otherserver.example.com/"
</IfDefine></pre>
<p><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> yönergesi
sadece belli bir modülün sunucuda kullanılabilir durumda olması halinde
uygulanabilecek yönergeleri içerir. Modülün ya sunucuyla birlikte durağan
olarak derlenmiş olması ya da devingen olarak derlenmiş ve yapılandırma
dosyasında yönergeden önce o modüle ilişkin bir <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> satırının bulunması gerekir. Bu
yönergeyi sadece belli bir modülün varlığının veya yokluğunun
yapılandırma dosyanızın çalışmasını etkilememesini istediğiniz durumlarda
kullanmalısınız. Eksik modüllerle ilgili hata iletilerini
engellediğinden, taşıyıcı içine, her zaman çalışması istenen yönergeler
konulmamalıdır.</p>
<p>Aşağıdaki örnekte, <code class="directive"><a href="./mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code> yönergesi sadece
<code class="module"><a href="./mod/mod_mime_magic.html">mod_mime_magic</a></code> modülü mevcutsa uygulanacaktır.</p>
<pre class="prettyprint lang-config"><IfModule mod_mime_magic.c>
MimeMagicFile "conf/magic"
</IfModule></pre>
<p><code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
yönergesi sunucunun belli bir sürümünün çalıştırılması halinde
uygulanabilecek yönergeleri içerebilmesi dışında <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> ve <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> yönergeleri gibidir.
<code class="module"><a href="./mod/mod_version.html">mod_version</a></code> modülü farklı httpd sürümleri ve farklı
yapılandırmalarla büyük ağlarda çalışmayı mümkün kılmak veya sürüm
denemeleri yapabilmek amacıyla tasarlanmıştır.</p>
<pre class="prettyprint lang-config"><IfVersion >= 2.4>
# burası sadece 2.4.0 veya daha üstü sürümlerde
# iş görür.
</IfVersion></pre>
<p><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>,
<code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> ve
<code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
yönergelerinin önüne "!" konularak olumsuz koşullar için uygulanabilir.
Ayrıca, bu bölümler daha karmaşık sınırlamalar elde etmek amacıyla bir
diğerinin içinde kullanılabilirler.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="file-and-web" id="file-and-web">Dosya Sistemi, Site Alanı ve Mantıksal İfadeler</a></h2>
<p>En sık kullanılan yapılandırma bölümü taşıyıcıları dosya sistemindeki
veya site alanındaki belli yerlerin yapılandırmalarını değiştirmekte
kullanılanlardır. Öncelikle, bu ikisi arasındaki farkları bilmek
önemlidir. Dosya sistemi disklerinizin işletim sistemi tarafından size
gösterilen halidir. Örneğin, öntanımlı kurulumda Apache httpd, Unix
sistemlerinde <code>/usr/local/apache2</code> altındayken Windows
sistemlerinde <code>"c:/Program Files/Apache Group/Apache2"</code>
altındadır. (Bilgi: Windows için bile, Apache httpd yapılandırma
dosyalarında dosya yolu belirtilirken tersbölü değil normal bölü
karakterleri kullanılır.) Site alanı ise sunucu tarafından istemciye
sunulan dizin ağacıdır. Yani, site alanı içindeki <code>/dir/</code>
dizini, Apache httpd’nin Unix üzerinde dosya sistemine öntanımlı olarak
kurulduğu yer göz önüne alınarak, dosya sistemindeki
<code>/usr/local/apache2/htdocs/dir/</code> dizinine karşılıktır. Site
sayfaları veritabanlarından veya başka yerlerden devingen olarak
üretilebildiğinden site alanlarının doğrudan dosya sistemine eşlenmesi
gerekli değildir.</p>
<h3><a name="filesystem" id="filesystem">Dosya Sistemi Taşıyıcıları</a></h3>
<p><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
ve <code class="directive"><a href="./mod/core.html#files"><Files></a></code>
taşıyıcıları, <a class="glossarylink" href="./glossary.html#regex" title="sözlüğe bakınız">düzenli ifade</a> karşılıkları
ile beraber, yönergeleri dosya sisteminin parçalarına uygularlar. Bir
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> bölümü
içindeki yönergeler belli bir dosya sistemi dizinine ve onun alt
dizinlerine uygulanır. Aynı etki <a href="howto/htaccess.html">.htaccess
dosyaları</a> kullanılarak da sağlanabilir. Örneğin aşağıdaki
yapılandırmada, <code>/var/web/dir1</code> dizini ve alt dizinlerinde
dizin içeriğinin listelenmesi etkin kılınmaktadır.</p>
<pre class="prettyprint lang-config"><Directory "/var/web/dir1">
Options +Indexes
</Directory></pre>
<p>Bir <code class="directive"><a href="./mod/core.html#files"><Files></a></code> bölümü
içindeki yönergeler, hangi dizinde bulunduğuna bakılmaksızın ismi
belirtilen dosyalara uygulanır. Örneğin, aşağıdaki yapılandırma
yönergeleri yapılandırma dosyasının ana bölümüne yerleştirildiği takdirde
<code>gizli.html</code> isimli dosyalara nerede bulunursa bulunsun
erişime izin vermeyecektir.</p>
<pre class="prettyprint lang-config"><Files "gizli.html">
Require all denied
</Files></pre>
<p>Dosya sisteminin belli bir yerindeki belli dosyalarla ilgili yaptırımlar
için <code class="directive"><a href="./mod/core.html#files"><Files></a></code> ve
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> bölümleri
birlikte kullanılabilir. Örneğin, aşağıdaki yapılandırma
<code>/var/web/dir1/gizli.html</code>,
<code>/var/web/dir1/subdir2/gizli.html</code>,
<code>/var/web/dir1/subdir3/gizli.html</code> ve
<code>/var/web/dir1/</code> altında bulunabilecek diğer tüm
<code>gizli.html</code> dosyalarına erişimi yasaklar.</p>
<pre class="prettyprint lang-config"><Directory "/var/web/dir1"><br />
<Files "gizli.html"><br />
Require all denied
</Files><br />
</Directory></pre>
<h3><a name="webspace" id="webspace">Site Alanı Taşıyıcıları</a></h3>
<p><code class="directive"><a href="./mod/core.html#location"><Location></a></code> yönergesi
ve yönergenin <a class="glossarylink" href="./glossary.html#regex" title="sözlüğe bakınız">düzenli ifade</a> karşılığı
site alanındaki içerik için yapılandırmayı değiştirir. Örneğin aşağıdaki
yapılandırma, <code>/gizli</code> ile başlayan URL yollarına erişimi
engeller. Özellikle, <code>http://siteniz.mesela.dom/gizli</code>,
<code>http://siteniz.mesela.dom/gizli123</code> ve
<code>http://siteniz.mesela.dom/gizli/dir/dosya.html</code>
istekleri yanında <code>/gizli</code> ile başlayan diğer isteklere de
uygulanır.</p>
<pre class="prettyprint lang-config"><LocationMatch "^/gizli">
Require all denied
</LocationMatch></pre>
<p>Dosya sistemi ile etkileşime girmeyen herşey için
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>
yönergesi gerekir. Aşağıdaki örnekte, belli bir URL’nin
<code class="module"><a href="./mod/mod_status.html">mod_status</a></code> modülü tarafından sağlanan bir dahili
Apache eylemcisine nasıl eşlenebileceği gösterilmiştir. Bu örnek
için dosya sisteminde <code>server-status</code> adında bir dosya
veya dizin bulunması gerekli değildir.</p>
<pre class="prettyprint lang-config"><Location "/server-status">
SetHandler server-status
</Location></pre>
<h3><a name="overlapping-webspace" id="overlapping-webspace">Site Alanında Çakışma</a></h3>
<p>Belli bölümler ve yönergeler değerlendirilirken çakışan iki URL bir URL
olarak dikkate alınır. <code class="directive"><a href="./mod/core.html#location"><Location></a></code> yönergesi için bu şöyle olurdu:</p>
<pre class="prettyprint lang-config"><Location "/foo">
</Location>
<Location "/foo/bar">
</Location></pre>
<p>Diğer yandan <code class="directive"><a href="./mod/mod_alias.html#takma adlar"><Takma
adlar></a></code> tam tersi eşlenir:</p>
<pre class="prettyprint lang-config">Alias "/foo/bar" "/srv/www/uncommon/bar"
Alias "/foo" "/srv/www/common/foo"</pre>
<p>Aynısı <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code>
yönergeleri için de geçerlidir:</p>
<pre class="prettyprint lang-config">ProxyPass "/special-area" "http://special.example.com" smax=5 max=10
ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofailover=On</pre>
<h3><a name="wildcards" id="wildcards">Dosya Adı Şablonları ve Düzenli İfadeler</a></h3>
<p><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code> ve
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>
yönergelerinde, Standart C kütüphanesindeki <code>fnmatch</code>
işlevindeki gibi kabuk tarzı dosya ismi kalıpları kullanılabilir. "*"
karakteri herhangi bir karakter dizisi ile eşleşirken "?" karakteri tek
tek karakterlerle ve "[<em>seq</em>]" kalıbı ise <em>seq</em> içindeki
her karakterle eşleşir. "/" karakteri her hangi bir kalıp karakteri ile
eşleşmez; açıkça belirtilmesi gerekir.</p>
<p>Daha esnek bir eşleşmenin gerekli olduğu durumlar için her taşıyıcının
bir düzenli ifade karşılığı vardır. <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code> ve <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> yönergelerinde gerekli
eşleşmeleri seçmek için perl uyumlu <a class="glossarylink" href="./glossary.html#regex" title="sözlüğe bakınız">düzenli
ifadelerin</a> kullanımına izin verilir. Ayrıca, yönergelerin
uygulanışının düzenli ifade bölümleri kullanılarak nasıl
değiştirileceğini öğrenmek için, aşağıda, yapılandırmanın
katıştırılmasıyla ilgili bölüme de bakınız.</p>
<p>Tüm kullanıcı dizinlerine ilişkin yapılandırmayı değiştirmek için dosya
ismi kalıpları şöyle kullanılabilirdi:</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html">
Options Indexes
</Directory></pre>
<p>Düzenli ifade bölümleri kullanarak çeşitli türlerdeki resim dosyalarına
erişimi bir defada yasaklayabiliriz:</p>
<pre class="prettyprint lang-config"><FilesMatch "\.(?i:gif|jpe?g|png)$">
Require all denied
</FilesMatch></pre>
<p><strong>İsimli gruplar ve geriye başvurular</strong> içeren düzenli
ifadeler ortama eklenirken ilgili isimler büyük harfli yapılır. Böylece,
URL'lere ve dosya yolları elemanlarına <a href="expr.html">ifadelerin
içinden</a> ve <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> gibi modüllerden başvurmak
mümkün olur.</p>
<pre class="prettyprint lang-config"><DirectoryMatch "^/var/www/combined/(?<SITENAME>[^/]+)">
Require ldap-group "cn=%{env:MATCH_SITENAME},ou=combined,o=Example"
</DirectoryMatch></pre>
<h3><a name="expressions" id="expressions">Mantıksal İfadeler</a></h3>
<p><code class="directive"><a href="./mod/core.html#if"><If></a></code> yönergesi bir
mantıksal ifade olarak belirtilebilen bir kurala bağlı olarak
yapılandırmayı değiştirebilir. Örneğin, aşağıdaki yapılandırmada,
<code>HTTP Referer</code> başlığı "http://www.example.com/" ile
başlamıyorsa erişimi yasaklar.</p>
<pre class="prettyprint lang-config"><If "!(%{HTTP_REFERER} -strmatch 'http://www.example.com/*')">
Require all denied
</If></pre>
<h3><a name="whichwhen" id="whichwhen">Ne, Ne Zaman Kullanılır?</a></h3>
<p>Dosya sistemi taşıyıcıları ile site alanı taşıyıcıları arasında seçim
yapmak aslında oldukça kolaydır. Dosya sisteminde bulunan nesnelere
uygulanacak yönergeler için daima <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> veya <code class="directive"><a href="./mod/core.html#files"><Files></a></code> kullanılır. Dosya sisteminde bulunmayan nesnelere
(bir sayfanın bir veritabanı tarafından üretilmesi gibi) uygulanacak
yönergeler için ise <code class="directive"><a href="./mod/core.html#location"><Location></a></code> kullanılır.</p>
<p>Dosya sistemindeki nesnelere erişimi kısıtlarken asla
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>
kullanmamak önemlidir. Bunun sebebi farklı site alanı konumlarının
(URL’ler) aynı dosya sistemi konumuna eşlenebilmesi dolayısıyla
kısıtlamalarınızın etrafından dolaşılabilmesine izin vermesidir.
Örneğin, aşağıdaki yapılandırmayı ele alalım:</p>
<pre class="prettyprint lang-config"><Location "/dir/">
Require all denied
</Location></pre>
<p><code>http://siteniz.mesela.dom/dir/</code> için bir istek yapılmışsa
bu doğru çalışacaktır. Fakat dosya sistemi harf büyüklüğüne duyarsızsa
ne olacak? Kısıtlamanız, istek
<code>http://siteniz.mesela.dom/DIR/</code>
şeklinde yapılarak kolayca geçersiz kılınabilir. Halbuki <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> yönergesi isteğin
nasıl yapıldığına bakılmaksızın bu konumdan sunulan her türlü içeriğe
uygulanacaktı. (Dosya sistemi bağlarıyla bu da aşılabilir. Sembolik
bağlar kullanılarak aynı dizin dosya sisteminin bir çok yerine
yerleştirilebilir. <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> yönergesi dosya yolunu sıfırlamaksızın sembolik
bağları izleyecektir. Bu bakımdan, en yüksek seviyede güvenlik için uygun
<code class="directive"><a href="./mod/core.html#options">Options</a></code> yönergesi ile sembolik
bağların izlenmesi devredışı bırakılabilir.)</p>
<p>Belki de siz sırf harf büyüklüğüne duyarlı bir dosya sistemi
kullanıyorsunuz diye böyle uygulamalara ihtiyacınız olmadığını düşünüyor
olabilirsiniz, fakat aynı site alanını çok sayıda dosya sistemi konumuna
eşleyecek daha bir sürü yol bulunduğunu unutmayınız. Bu bakımdan dosya
sisteminde yapacağınız kısıtlamalarda daima dosya sistemi taşıyıcılarını
kullanmalısınız. Bununla birlikte bu kuralın da bir istisnası vardır.
Yapılandırma kısıtlamalarının bir <code><Location "/"></code> bölümü
içine koyulması, bu bölüme konan yönergelerin etki alanının belli bir URL
ile sınırlı olmaması nedeniyle mükemmelen güvenlidir.</p>
<h3><a name="nesting" id="nesting">Bölüm iç içeliği</a></h3>
<p>Bazı bölüm türleri başka bölüm türlerinin içinde olabilir. Bir yandan,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code> bölümü
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> bölümünün
içinde bulunabilirken diğer yandan bir <code class="directive"><a href="./mod/core.html#if"><If></a></code> bölümü <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code> ve <code class="directive"><a href="./mod/core.html#files"><Files></a></code> bölümlerinde bulunabilir fakat
başka bir <code class="directive"><a href="./mod/core.html#if"><If></a></code> bölümünün
içinde bulunamaz. Bu bölümlerin düzenli ifadeli türevleri de benzer tarzda
davranır.</p>
<p>İç içe bölümler, aynı türdeki iç içe olmayan bölümlerin sonrasına
yerleştirilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">Sanal Konaklar</a></h2>
<p><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
taşıyıcısının içinde belli bir konağa uygulanan yönergeler bulunur.
Aynı makinede çok sayıda konağı farklı yapılandırmalarla sunuyorsanız
bu taşıyıcı çok işinize yarar. Daha fazla bilgi için
<a href="vhosts/">Sanal Konak Belgeleri</a> bölümüne bakınız.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Vekil</a></h2>
<p><code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
ve <code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>
taşıyıcıları, sadece belli bir URL ile eşleşen <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>
vekil sunucusu üzerinden erişilen sitelere uygulanan yapılandırma
yönergelerini bulundururlar. Örneğin aşağıdaki yapılandırma
<code>example.com</code> sitesine erişim için vekil sunucunun
sadece ağdaki bazı kullanıcılar tarafından kullanılabilmesini sağlayacaktır.</p>
<pre class="prettyprint lang-config"><Proxy "http://www.example.com/*">
Require host bizimki.example.com
</Proxy></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="whatwhere" id="whatwhere">Hangi Yönergelere İzin Veriliyor?</a></h2>
<p>Hangi yönergelere hangi yapılandırma bölümlerinde izin verildiğini
öğrenmek için yönerge <a href="mod/directive-dict.html#Context">bağlamına</a> bakınız. <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> bölümlerinde
izin verilen herşeye sözdizimsel olarak ayrıca
<code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>,
<code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>,
<code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>,
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
ve <code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>
bölümlerinde de izin verilir. Yine de bazı istisnai durumlar
mevcuttur:</p>
<ul>
<li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> yönergesi sadece
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
bölümlerinde çalışır.</li>
<li><code class="directive"><a href="./mod/core.html#options">Options</a></code> yönergesinin
<code>FollowSymLinks</code> ve <code>SymLinksIfOwnerMatch</code>
seçenekleri sadece <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> bölümlerinde veya <code>.htaccess</code>
dosyalarında çalışır.</li>
<li><code class="directive"><a href="./mod/core.html#options">Options</a></code> yönergesi
<code class="directive"><a href="./mod/core.html#files"><Files></a></code> ve
<code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>
bölümlerinde kullanılamaz.</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="merging" id="merging">Bölümler Nasıl Katıştırılır?</a></h2>
<p>Yapılandırma bölümleri belli bir sıra ile uygulanır. Yapılandırma
yönergelerinin yorumlanışı üzerinde önemli etkilere sahip olabilmesi
nedeniyle neyin ne zaman çalıştığını anlamak çok önemlidir.</p>
<p>Yapılandırma bölümlerinin katıştırılma sırası şöyledir:</p>
<ol>
<li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> (düzenli ifadeler hariç)
ve <code>.htaccess</code> aynı anda işleme sokulur
(<code>.htaccess</code> ile eğer izin verilmişse <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> içindeki bazı
yönergeler geçersiz kılınabileceği için).</li>
<li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>
(ve <code><Directory "~"></code>).</li>
<li><code class="directive"><a href="./mod/core.html#files"><Files></a></code> ve
<code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code> aynı anda
işleme sokulur.</li>
<li><code class="directive"><a href="./mod/core.html#location"><Location></a></code>
ve <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>
aynı anda işleme sokulur.</li>
<li><code class="directive"><a href="./mod/core.html#if"><If></a></code> bölümleri,
önceki bağlamlardan herhangi birinin içine alınmış olsalar bile.
</li>
</ol>
<p>Bazı önemli durumlar:</p>
<ul>
<li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
bölümündekiler hariç, her grup, yapılandırma dosyasında bulundukları
sıraya göre işleme sokulurlar. Örneğin, 4. grupta <em>/foo/bar</em> için yapılan
bir istek <code><Location "/foo/bar"></code> ve <code><Location
"/foo"></code> bölümleriyle de eşleşir ve bunlar yapılandırma
dosyalarında bulundukları sıraya göre değerlendirilir.</li>
<li>Yukarıda 1. grup olan <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> bölümü en kısa dizin elemanından en uzun
dizin elemanına doğru işleme sokulur. Yani, örneğin, <code><Directory
"/var/web/dir"></code> bölümü <code><Directory
"/var/web/dir/subdir"></code> bölümünden önce işleme sokulacaktır.</li>
<li>Eğer aynı dizin için birden fazla <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> bölümü varsa bunlar yapılandırma
dosyasında bulundukları sıraya göre işleme sokulurlar.</li>
<li><code class="directive"><a href="./mod/core.html#include">Include</a></code> yönergeleri ile
yapılandırmaya dahil edilen dosyaların içerikleri <code class="directive"><a href="./mod/core.html#include">Include</a></code> yönergesinin bulunduğu yere konulduktan
sonra işleme sokulurlar.</li>
<li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
bölümlerinin içindeki bölümler, sanal konak tanımı dışındaki
karşılıklarından <em>sonra</em> uygulanırlar. Bu yöntemle ana sunucu
yapılandırmasındaki tanımlar geçersiz kılınabilir</li>
<li>İstek <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> tarafından sunulduğu takdirde,
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code> taşıyıcısı
işlem sırasında <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> taşıyıcısının yerini alır.</li>
<li>katıştırma düzeni üzerindeki etkisi nedeniyle, ilgili yapılandırma
yönergelerini <code class="directive"><a href="./mod/core.html#if"><If></a></code>'in
içinde ve dışında karıştırırken dikkatli olunmalıdır. Doğrudan
<code class="directive"><a href="./mod/core.html#else"><Else></a></code> kullanımının
yardımı olabilir.</li>
<li><code>.htaccess</code> içinde <code class="directive"><a href="./mod/core.html#if"><If></a></code> kullanıldığında, üst dizindeki sarmalanmış
yönergeler, alt dizinde sarmalanmamış yönergelerden <em>sonra</em>
birleştirilir.</li>
</ul>
<div class="note"><h3>Bazı Teknik Bilgiler</h3>
Aslında, isim dönüşüm aşamasından (<code>Aliases</code> ve
<code>DocumentRoots</code>, URL’leri dosya isimlerine eşlemek için
kullanılırken) hemen önce uygulanan bir
<code><Location></code>/<code><LocationMatch></code> dizisi
vardır. Bu dizinin sonuçları isim dönüşüm aşaması tamamlandıktan sonra
tamamen elden çıkarılır.
</div>
<h3><a name="relationship-module-configuration" id="relationship-module-configuration">Modüllerle
yapılandırma bölümleri arasındaki ilişki</a></h3>
<p>Yapılandırma bölümlerini okurken örneğin <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
gibi belli modüllerin yönergelerinin bu bölümlere nasıl katılacağı ve
ne zaman nasıl işleneceği gibi sorular sıkça aklımızdan geçer. Bunun
belli bir yanıtı yoktur ve biraz temel bilgi gerektirir. Her httpd
modülü yapılandırmasını kendi yönetir ve httpd.conf içindeki
yönergelerinin her biri belli bir bağlamdaki bir yapılandırmayı
belirtir. httpd bir komutu okunduğu sırada çalıştırmaz.</p>
<p>Çalışma anında, httpd çekirdeği geçerli isteğe hangilerinin
uygulanacağını belirlemek için yukarıda açıklanan sırada tanımlı
yapılandırma bölümlerini tekrar tekrar okur. Eşleşen ilk bölümün bu
istek için geçerli yapılandırmayı içerdiği varsayılır. Eğer alt
bölümlerden biri de eşleşmişse bu bölümlerde yönergeleri bulunan her
modüle yapılandırmasını iki bölüm arasında katıştırma şansı verilir.
Sonuç üçüncü bir yapılandırma olup işlem bütün yapılandırma bölümleri
değerlendirilene kadar sürer.</p>
<p>Yukarıdaki adımların ardından HTTP isteğiyle ilgili "asıl" işlem
başlar: her modül ondan istenen görevleri gerçekleştirme şansına sahip
olur. Nasıl davranacaklarını belirlemek için kendilerinin katıştırılmış
son yapılandırmalarını http çekirdeğinden alabilirler.</p>
<p>Sürecin tamamı bir örnekle görselleştirilebilir. Aşağıdaki örnekte
belli bir HTTP başlığını ayarlamak için <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code>
modülünün <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code> yönergesi
kullanılmıştır. <code>/example/index.html</code> isteği için httpd
<code>CustomHeaderName</code> başlığına hangi değeri atayacaktır?
</p>
<pre class="prettyprint lang-config"><Directory "/">
Header set CustomHeaderName bir
<FilesMatch ".*">
Header set CustomHeaderName yedi
</FilesMatch>
</Directory>
<Directory "/example">
Header set CustomHeaderName iki
</Directory></pre>
<ul>
<li><code class="directive">Directory</code> "/" eşleşir ve ilk yapılandırma
olarak <code>CustomHeaderName</code> başlığı <code>bir</code>
değeriyle oluşturulur.</li>
<li><code class="directive">Directory</code> "/example" eşleşir ve
<code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> modülünün koduna göre bir katıştırma
durumundan yeni değer eskiyi geçersiz kılacağından yeni bir
yapılandırma ile <code>CustomHeaderName</code> başlığının değeri
<code>iki</code> yapılır.</li>
<li><code class="directive">FilesMatch</code> ".*" eşleşir ve başka bir
katıştırma fırsatı doğar: <code>CustomHeaderName</code> başlığının
değeri <code>yedi</code> yapılır.</li>
<li>Neticede HHP isteğinin sonraki adımlarında
<code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> çağrılıp <code>yedi</code> değeri
atanmış <code>CustomHeaderName</code> başlığını işleme sokması
istenecektir. <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> normalde işini yapmak
için bu yapılandırmayı kullanacaktır. Fakat bundan, bir yönergenin
gerekli olmaması veya kullanımdan kaldırılması ve benzeri nedenlerle
yapılandırmada iptal edilmesi gibi daha karmaşık bir eylemi bir
modülün gerçekleştiremeyeceği anlamı çıkarılmamalıdır.</li>
</ul>
<p><code class="directive">Directory</code> ile aynı katıştırma sırasından dolayı
bu durum .htaccess için de geçerlidir. Burada anlaşılması gereken husus,
<code class="directive">Directory</code> ve <code class="directive">FilesMatch</code>
gibi yapılandırma bölümlerinin <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code> veya <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> gibi modüle özgü
yönergelerle karşılaştırılmamasıdır, çünkü bunlar farklı seviyelerde
işlem görür.
</p>
<h3><a name="merge-examples" id="merge-examples">Bazı Örnekler</a></h3>
<p>Aşağıdaki yapay örnekte katıştırma sırası gösterilmiştir. Hepsinin aynı
isteğe uygulandığı varsayımıyla, bu örnekteki yönergeler A > B > C
> D > E sırasıyla uygulanacaktır.</p>
<pre class="prettyprint lang-config"><Location "/">
E
</Location>
<Files "f.html">
D
</Files>
<VirtualHost *>
<Directory "/a/b">
B
</Directory>
</VirtualHost>
<DirectoryMatch "^.*b$">
C
</DirectoryMatch>
<Directory "/a/b">
A
</Directory></pre>
<p>Daha somut bir örnek olarak aşağıdakini ele alalım.
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
bölümlerindeki erişim sınırlamaları ne olursa olsun <code class="directive"><a href="./mod/core.html#location"><Location></a></code> bölümü son olarak
değerlendirmeye alınacak ve sunucuya sınırsız erişim verecektir.
Başka bir deyişle, katıştırma sırası önemlidir, bu nedenle dikkatli
olmalısınız!</p>
<pre class="prettyprint lang-config"><Location "/">
Require all granted
</Location>
# Alooo! Bu <Directory> bölümünün hiçbir hükmü yok.
<Directory "/">
<RequireAll>
Require all granted
Require not host kkadam.example.com
</RequireAll>
</Directory></pre>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/sections.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sections.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sections.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sitemap.html.de 0000664 0001751 0001751 00000064220 14743132254 017757 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="de" xml:lang="de"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Seitenindex - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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-Server</a> > <a href="http://httpd.apache.org/docs/">Dokumentation</a> > <a href="./">Version 2.4</a></div>
<div id="page-content"><div id="preamble"><h1>Seitenindex</h1>
<div class="toplang">
<p><span>Verfügbare Sprachen: </span><a href="./de/sitemap.html" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<div class="outofdate">Diese Übersetzung ist möglicherweise
nicht mehr aktuell. Bitte prüfen Sie die englische Version auf
die neuesten Änderungen.</div>
<p>Diese Seite verzeichnet die zur Zeit verfügbaren Dokumente der
<a href="./">Dokumentation zum Apache HTTP Server Version
2.4</a>.</p>
</div>
<div id="quickview"><ul id="toc">
<li><img alt="" src="./images/down.gif" /> <a href="#release">Hinweise zur Version</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Bedienung des Apache HTTP Servers</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#vhosts">Apache-Dokumentation zu virtuellen Hosts</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rewrite">Einführung in die URL-Manipulation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ssl">SSL/TLS-Verschlüsselung des Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#howto">Praxis / Anleitungen</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#platform">Plattform-spezifische Anmerkungen</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Apache HTTP Server und Hilfsprogramme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#misc">Weitere Apache-Dokumentationen</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Apache-Module</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Dokumentation für Entwickler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#index">Glossar und Index</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="release" id="release">Hinweise zur Version</a></h2>
<ul><li><a href="upgrading.html">Upgrade von 2.2 auf 2.4</a></li>
<li><a href="new_features_2_4.html">Neue Funktionen in Version 2.3/2.4</a></li>
<li><a href="new_features_2_2.html">Neue Funktionen in Version 2.1/2.2</a></li>
<li><a href="new_features_2_0.html">Neue Funktionen in Version 2.0</a></li>
<li><a href="license.html">Apache-Lizenz</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="using" id="using">Bedienung des Apache HTTP Servers</a></h2>
<ul><li><a href="install.html">Kompilieren und Installieren</a></li>
<li><a href="invoking.html">Apache starten</a></li>
<li><a href="stopping.html">Beenden und Neustarten des Servers</a></li>
<li><a href="configuring.html">Konfigurationsdateien</a></li>
<li><a href="sections.html">Konfigurationsabschnitte</a></li>
<li><a href="caching.html">Caching von Inhalten</a></li>
<li><a href="server-wide.html">Serverweite Konfiguration</a></li>
<li><a href="logs.html">Log-Dateien</a></li>
<li><a href="urlmapping.html">URLs auf das Dateisystem abbilden</a></li>
<li><a href="dso.html">Dynamic Shared Object (DSO)</a></li>
<li><a href="content-negotiation.html">Content Negotiation</a></li>
<li><a href="custom-error.html">Individuelle Fehlermeldungen</a></li>
<li><a href="bind.html">Bestimmen der vom Apache verwendeten Adressen und Ports</a></li>
<li><a href="mpm.html">Multi-Processing-Module (MPMs)</a></li>
<li><a href="env.html">Umgebungsvariablen</a></li>
<li><a href="expr.html">Parsen von Ausdrücken</a></li>
<li><a href="handler.html">Handler</a></li>
<li><a href="filter.html">Filter</a></li>
<li><a href="socache.html">Unterstützung für gemeinsame Objekt-Zwischenspeicher</a></li>
<li><a href="suexec.html">suEXEC Unterstützung</a></li>
<li><a href="dns-caveats.html">Probleme bezüglich DNS und Apache</a></li>
<li><a href="http://wiki.apache.org/httpd/FAQ">Häufig gestellte Fragen
(FAQ)</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="vhosts" id="vhosts">Apache-Dokumentation zu virtuellen Hosts</a></h2>
<ul><li class="separate"><a href="vhosts/">Übersicht</a></li>
<li><a href="vhosts/name-based.html">Namensbasierte virtuelle Hosts</a></li>
<li><a href="vhosts/ip-based.html">IP-basierte virtuelle Hosts</a></li>
<li><a href="vhosts/mass.html">Dynamisch konfiguriertes Massen-Virtual-Hosting</a></li>
<li><a href="vhosts/examples.html">Beispiele für virtuelle Hosts in
typischen Installationen</a></li>
<li><a href="vhosts/details.html">Tiefergehende Erörterung der Zuweisung
virtueller Hosts</a></li>
<li><a href="vhosts/fd-limits.html">Datei-Deskriptor-Begrenzungen</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="rewrite" id="rewrite">Einführung in die URL-Manipulation</a></h2>
<ul><li class="separate"><a href="rewrite/">Übersicht</a></li>
<li><a href="mod/mod_rewrite.html">Referenz-Dokumentation von
mod_rewrite</a></li>
<li><a href="rewrite/intro.html">Einführung in reguläre Ausdrücke und mod_rewrite</a></li>
<li><a href="rewrite/remapping.html">Verwendung von mod_rewrite, um URLs umzuleiten oder umzuschreiben</a></li>
<li><a href="rewrite/access.html">Zugriffskontrolle mit mod_rewrite</a></li>
<li><a href="rewrite/vhosts.html">Dynamische virtuelle Hosts mit mod_rewrite</a></li>
<li><a href="rewrite/proxy.html">Dynamische Proxy-Konfigurationen mit mod_rewrite</a></li>
<li><a href="rewrite/rewritemap.html">RewriteMap einsetzen</a></li>
<li><a href="rewrite/advanced.html">Fortgeschrittene Techniken</a></li>
<li><a href="rewrite/avoid.html">Wann man auf mod_rewrite verzichten sollte</a></li>
<li><a href="rewrite/flags.html">Schalter / Flags</a></li>
<li><a href="rewrite/tech.html">Technische Details</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="ssl" id="ssl">SSL/TLS-Verschlüsselung des Apache</a></h2>
<ul><li class="separate"><a href="ssl/">Übersicht</a></li>
<li><a href="ssl/ssl_intro.html">SSL/TLS-Verschlüsselung: Einführung</a></li>
<li><a href="ssl/ssl_compat.html">SSL/TLS-Verschlüsselung: Kompatibilität</a></li>
<li><a href="ssl/ssl_howto.html">SSL/TLS-Verschlüsselung: Praxis</a></li>
<li><a href="ssl/ssl_faq.html">SSL/TLS-Verschlüsselung: FAQ</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="howto" id="howto">Praxis / Anleitungen</a></h2>
<ul><li class="separate"><a href="howto/">Übersicht</a></li>
<li><a href="howto/auth.html">Authentisierung und Autorisierung</a></li>
<li><a href="howto/access.html">Zugriffskontrolle</a></li>
<li><a href="howto/cgi.html">Dynamische Inhalte mit CGI</a></li>
<li><a href="howto/ssi.html">Einführung in Server Side Includes</a></li>
<li><a href="howto/htaccess.html">.htaccess-Dateien</a></li>
<li><a href="howto/public_html.html">Web-Verzeichnisse für Benutzer</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="platform" id="platform">Plattform-spezifische Anmerkungen</a></h2>
<ul><li class="separate"><a href="platform/">Übersicht</a></li>
<li><a href="platform/windows.html">Apache unter Microsoft
Windows einsetzen</a></li>
<li><a href="platform/win_compiling.html">Kompilieren des Apache für
Microsoft Windows</a></li>
<li><a href="platform/rpm.html">Apache auf RPM-basierten Systemen einsetzen</a></li>
<li><a href="platform/netware.html">Apache unter Novell NetWare einsetzen</a></li>
<li><a href="platform/perf-hp.html">Einen Hochleistungs-Web-Server auf
HPUX betreiben</a></li>
<li><a href="platform/ebcdic.html">Die Apache EBCDIC-Portierung</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="programs" id="programs">Apache HTTP Server und Hilfsprogramme</a></h2>
<ul><li class="separate"><a href="programs/">Übersicht</a></li>
<li><a href="programs/httpd.html">httpd</a></li>
<li><a href="programs/ab.html">ab</a></li>
<li><a href="programs/apachectl.html">apachectl</a></li>
<li><a href="programs/apxs.html">apxs</a></li>
<li><a href="programs/configure.html">configure</a></li>
<li><a href="programs/dbmmanage.html">dbmmanage</a></li>
<li><a href="programs/fcgistarter.html">fcgistarter</a></li>
<li><a href="programs/htcacheclean.html">htcacheclean</a></li>
<li><a href="programs/htdbm.html">htdbm</a></li>
<li><a href="programs/htdigest.html">htdigest</a></li>
<li><a href="programs/htpasswd.html">htpasswd</a></li>
<li><a href="programs/httxt2dbm.html">httxt2dbm</a></li>
<li><a href="programs/logresolve.html">logresolve</a></li>
<li><a href="programs/log_server_status.html">log_server_status</a></li>
<li><a href="programs/rotatelogs.html">rotatelogs</a></li>
<li><a href="programs/split-logfile.html">split-logfile</a></li>
<li><a href="programs/suexec.html">suexec</a></li>
<li><a href="programs/other.html">Sonstige Programme</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="misc" id="misc">Weitere Apache-Dokumentationen</a></h2>
<ul><li class="separate"><a href="misc/">Übersicht</a></li>
<li><a href="misc/perf-tuning.html">Performance-Hinweise</a></li>
<li><a href="misc/security_tips.html">Tipps zur Sicherheit</a></li>
<li><a href="misc/relevant_standards.html">Wichtige Standards</a></li>
<li><a href="misc/password_encryptions.html">Verschlüsselungsformate für Passworte</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="modules" id="modules">Apache-Module</a></h2>
<ul><li><a href="mod/module-dict.html">Erklärung der Fachbegriffe zu Apache-Modulen</a></li>
<li><a href="mod/directive-dict.html">Erklärung der Fachbegriffe zu Apache-Direktiven</a></li>
</ul><ul><li><a href="mod/core.html">Apache-Kernfunktionen</a></li>
<li><a href="mod/mpm_common.html">Allgemeine Direktiven der Apache-MPMs</a></li>
<li><a href="mod/event.html">Apache-MPM event</a></li>
<li><a href="mod/mpm_netware.html">Apache-MPM netware</a></li>
<li><a href="mod/mpmt_os2.html">Apache-MPM os2</a></li>
<li><a href="mod/prefork.html">Apache-MPM prefork</a></li>
<li><a href="mod/mpm_winnt.html">Apache-MPM winnt</a></li>
<li><a href="mod/worker.html">Apache-MPM worker</a></li>
</ul><ul><li><a href="mod/mod_access_compat.html">Apache-Modul mod_access_compat</a></li>
<li><a href="mod/mod_actions.html">Apache-Modul mod_actions</a></li>
<li><a href="mod/mod_alias.html">Apache-Modul mod_alias</a></li>
<li><a href="mod/mod_allowmethods.html">Apache-Modul mod_allowmethods</a></li>
<li><a href="mod/mod_asis.html">Apache-Modul mod_asis</a></li>
<li><a href="mod/mod_auth_basic.html">Apache-Modul mod_auth_basic</a></li>
<li><a href="mod/mod_auth_digest.html">Apache-Modul mod_auth_digest</a></li>
<li><a href="mod/mod_auth_form.html">Apache-Modul mod_auth_form</a></li>
<li><a href="mod/mod_authn_anon.html">Apache-Modul mod_authn_anon</a></li>
<li><a href="mod/mod_authn_core.html">Apache-Modul mod_authn_core</a></li>
<li><a href="mod/mod_authn_dbd.html">Apache-Modul mod_authn_dbd</a></li>
<li><a href="mod/mod_authn_dbm.html">Apache-Modul mod_authn_dbm</a></li>
<li><a href="mod/mod_authn_file.html">Apache-Modul mod_authn_file</a></li>
<li><a href="mod/mod_authn_socache.html">Apache-Modul mod_authn_socache</a></li>
<li><a href="mod/mod_authnz_fcgi.html">Apache-Modul mod_authnz_fcgi</a></li>
<li><a href="mod/mod_authnz_ldap.html">Apache-Modul mod_authnz_ldap</a></li>
<li><a href="mod/mod_authz_core.html">Apache-Modul mod_authz_core</a></li>
<li><a href="mod/mod_authz_dbd.html">Apache-Modul mod_authz_dbd</a></li>
<li><a href="mod/mod_authz_dbm.html">Apache-Modul mod_authz_dbm</a></li>
<li><a href="mod/mod_authz_groupfile.html">Apache-Modul mod_authz_groupfile</a></li>
<li><a href="mod/mod_authz_host.html">Apache-Modul mod_authz_host</a></li>
<li><a href="mod/mod_authz_owner.html">Apache-Modul mod_authz_owner</a></li>
<li><a href="mod/mod_authz_user.html">Apache-Modul mod_authz_user</a></li>
<li><a href="mod/mod_autoindex.html">Apache-Modul mod_autoindex</a></li>
<li><a href="mod/mod_brotli.html">Apache-Modul mod_brotli</a></li>
<li><a href="mod/mod_buffer.html">Apache-Modul mod_buffer</a></li>
<li><a href="mod/mod_cache.html">Apache-Modul mod_cache</a></li>
<li><a href="mod/mod_cache_disk.html">Apache-Modul mod_cache_disk</a></li>
<li><a href="mod/mod_cache_socache.html">Apache-Modul mod_cache_socache</a></li>
<li><a href="mod/mod_cern_meta.html">Apache-Modul mod_cern_meta</a></li>
<li><a href="mod/mod_cgi.html">Apache-Modul mod_cgi</a></li>
<li><a href="mod/mod_cgid.html">Apache-Modul mod_cgid</a></li>
<li><a href="mod/mod_charset_lite.html">Apache-Modul mod_charset_lite</a></li>
<li><a href="mod/mod_data.html">Apache-Modul mod_data</a></li>
<li><a href="mod/mod_dav.html">Apache-Modul mod_dav</a></li>
<li><a href="mod/mod_dav_fs.html">Apache-Modul mod_dav_fs</a></li>
<li><a href="mod/mod_dav_lock.html">Apache-Modul mod_dav_lock</a></li>
<li><a href="mod/mod_dbd.html">Apache-Modul mod_dbd</a></li>
<li><a href="mod/mod_deflate.html">Apache-Modul mod_deflate</a></li>
<li><a href="mod/mod_dialup.html">Apache-Modul mod_dialup</a></li>
<li><a href="mod/mod_dir.html">Apache-Modul mod_dir</a></li>
<li><a href="mod/mod_dumpio.html">Apache-Modul mod_dumpio</a></li>
<li><a href="mod/mod_echo.html">Apache-Modul mod_echo</a></li>
<li><a href="mod/mod_env.html">Apache-Modul mod_env</a></li>
<li><a href="mod/mod_example_hooks.html">Apache-Modul mod_example_hooks</a></li>
<li><a href="mod/mod_expires.html">Apache-Modul mod_expires</a></li>
<li><a href="mod/mod_ext_filter.html">Apache-Modul mod_ext_filter</a></li>
<li><a href="mod/mod_file_cache.html">Apache-Modul mod_file_cache</a></li>
<li><a href="mod/mod_filter.html">Apache-Modul mod_filter</a></li>
<li><a href="mod/mod_headers.html">Apache-Modul mod_headers</a></li>
<li><a href="mod/mod_heartbeat.html">Apache-Modul mod_heartbeat</a></li>
<li><a href="mod/mod_heartmonitor.html">Apache-Modul mod_heartmonitor</a></li>
<li><a href="mod/mod_http2.html">Apache-Modul mod_http2</a></li>
<li><a href="mod/mod_ident.html">Apache-Modul mod_ident</a></li>
<li><a href="mod/mod_imagemap.html">Apache-Modul mod_imagemap</a></li>
<li><a href="mod/mod_include.html">Apache-Modul mod_include</a></li>
<li><a href="mod/mod_info.html">Apache-Modul mod_info</a></li>
<li><a href="mod/mod_isapi.html">Apache-Modul mod_isapi</a></li>
<li><a href="mod/mod_lbmethod_bybusyness.html">Apache-Modul mod_lbmethod_bybusyness</a></li>
<li><a href="mod/mod_lbmethod_byrequests.html">Apache-Modul mod_lbmethod_byrequests</a></li>
<li><a href="mod/mod_lbmethod_bytraffic.html">Apache-Modul mod_lbmethod_bytraffic</a></li>
<li><a href="mod/mod_lbmethod_heartbeat.html">Apache-Modul mod_lbmethod_heartbeat</a></li>
<li><a href="mod/mod_ldap.html">Apache-Modul mod_ldap</a></li>
<li><a href="mod/mod_log_config.html">Apache-Modul mod_log_config</a></li>
<li><a href="mod/mod_log_debug.html">Apache-Modul mod_log_debug</a></li>
<li><a href="mod/mod_log_forensic.html">Apache-Modul mod_log_forensic</a></li>
<li><a href="mod/mod_logio.html">Apache-Modul mod_logio</a></li>
<li><a href="mod/mod_lua.html">Apache-Modul mod_lua</a></li>
<li><a href="mod/mod_macro.html">Apache-Modul mod_macro</a></li>
<li><a href="mod/mod_md.html">Apache-Modul mod_md</a></li>
<li><a href="mod/mod_mime.html">Apache-Modul mod_mime</a></li>
<li><a href="mod/mod_mime_magic.html">Apache-Modul mod_mime_magic</a></li>
<li><a href="mod/mod_negotiation.html">Apache-Modul mod_negotiation</a></li>
<li><a href="mod/mod_nw_ssl.html">Apache-Modul mod_nw_ssl</a></li>
<li><a href="mod/mod_privileges.html">Apache-Modul mod_privileges</a></li>
<li><a href="mod/mod_proxy.html">Apache-Modul mod_proxy</a></li>
<li><a href="mod/mod_proxy_ajp.html">Apache-Modul mod_proxy_ajp</a></li>
<li><a href="mod/mod_proxy_balancer.html">Apache-Modul mod_proxy_balancer</a></li>
<li><a href="mod/mod_proxy_connect.html">Apache-Modul mod_proxy_connect</a></li>
<li><a href="mod/mod_proxy_express.html">Apache-Modul mod_proxy_express</a></li>
<li><a href="mod/mod_proxy_fcgi.html">Apache-Modul mod_proxy_fcgi</a></li>
<li><a href="mod/mod_proxy_fdpass.html">Apache-Modul mod_proxy_fdpass</a></li>
<li><a href="mod/mod_proxy_ftp.html">Apache-Modul mod_proxy_ftp</a></li>
<li><a href="mod/mod_proxy_hcheck.html">Apache-Modul mod_proxy_hcheck</a></li>
<li><a href="mod/mod_proxy_html.html">Apache-Modul mod_proxy_html</a></li>
<li><a href="mod/mod_proxy_http.html">Apache-Modul mod_proxy_http</a></li>
<li><a href="mod/mod_proxy_http2.html">Apache-Modul mod_proxy_http2</a></li>
<li><a href="mod/mod_proxy_scgi.html">Apache-Modul mod_proxy_scgi</a></li>
<li><a href="mod/mod_proxy_uwsgi.html">Apache-Modul mod_proxy_uwsgi</a></li>
<li><a href="mod/mod_proxy_wstunnel.html">Apache-Modul mod_proxy_wstunnel</a></li>
<li><a href="mod/mod_ratelimit.html">Apache-Modul mod_ratelimit</a></li>
<li><a href="mod/mod_reflector.html">Apache-Modul mod_reflector</a></li>
<li><a href="mod/mod_remoteip.html">Apache-Modul mod_remoteip</a></li>
<li><a href="mod/mod_reqtimeout.html">Apache-Modul mod_reqtimeout</a></li>
<li><a href="mod/mod_request.html">Apache-Modul mod_request</a></li>
<li><a href="mod/mod_rewrite.html">Apache-Modul mod_rewrite</a></li>
<li><a href="mod/mod_sed.html">Apache-Modul mod_sed</a></li>
<li><a href="mod/mod_session.html">Apache-Modul mod_session</a></li>
<li><a href="mod/mod_session_cookie.html">Apache-Modul mod_session_cookie</a></li>
<li><a href="mod/mod_session_crypto.html">Apache-Modul mod_session_crypto</a></li>
<li><a href="mod/mod_session_dbd.html">Apache-Modul mod_session_dbd</a></li>
<li><a href="mod/mod_setenvif.html">Apache-Modul mod_setenvif</a></li>
<li><a href="mod/mod_slotmem_plain.html">Apache-Modul mod_slotmem_plain</a></li>
<li><a href="mod/mod_slotmem_shm.html">Apache-Modul mod_slotmem_shm</a></li>
<li><a href="mod/mod_so.html">Apache-Modul mod_so</a></li>
<li><a href="mod/mod_socache_dbm.html">Apache-Modul mod_socache_dbm</a></li>
<li><a href="mod/mod_socache_dc.html">Apache-Modul mod_socache_dc</a></li>
<li><a href="mod/mod_socache_memcache.html">Apache-Modul mod_socache_memcache</a></li>
<li><a href="mod/mod_socache_redis.html">Apache-Modul mod_socache_redis</a></li>
<li><a href="mod/mod_socache_shmcb.html">Apache-Modul mod_socache_shmcb</a></li>
<li><a href="mod/mod_speling.html">Apache-Modul mod_speling</a></li>
<li><a href="mod/mod_ssl.html">Apache-Modul mod_ssl</a></li>
<li><a href="mod/mod_status.html">Apache-Modul mod_status</a></li>
<li><a href="mod/mod_substitute.html">Apache-Modul mod_substitute</a></li>
<li><a href="mod/mod_suexec.html">Apache-Modul mod_suexec</a></li>
<li><a href="mod/mod_systemd.html">Apache-Modul mod_systemd</a></li>
<li><a href="mod/mod_unique_id.html">Apache-Modul mod_unique_id</a></li>
<li><a href="mod/mod_unixd.html">Apache-Modul mod_unixd</a></li>
<li><a href="mod/mod_userdir.html">Apache-Modul mod_userdir</a></li>
<li><a href="mod/mod_usertrack.html">Apache-Modul mod_usertrack</a></li>
<li><a href="mod/mod_version.html">Apache-Modul mod_version</a></li>
<li><a href="mod/mod_vhost_alias.html">Apache-Modul mod_vhost_alias</a></li>
<li><a href="mod/mod_watchdog.html">Apache-Modul mod_watchdog</a></li>
<li><a href="mod/mod_xml2enc.html">Apache-Modul mod_xml2enc</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="developer" id="developer">Dokumentation für Entwickler</a></h2>
<ul><li class="separate"><a href="developer/">Übersicht</a></li>
<li><a href="developer/API.html">Anmerkungen zur Apache-API</a></li>
<li><a href="developer/new_api_2_4.html">API-Änderungen im Apache HTTPD
2.4</a></li>
<li><a href="developer/modguide.html">Module für Apache HTTPD 2.4 entwickeln</a></li>
<li><a href="developer/documenting.html">Apache HTTPD dokumentieren</a></li>
<li><a href="developer/hooks.html">Hook-Funktionen des Apache 2.x</a></li>
<li><a href="developer/modules.html">Module von 1.3 nach 2.x konvertieren</a></li>
<li><a href="developer/request.html">Verarbeitung der Anfragen in Version 2.x</a></li>
<li><a href="developer/filters.html">Wie Filter in Version 2.x funktionieren</a></li>
<li><a href="developer/output-filters.html">Richtlinien für Ausgangsfilter in Version 2.x</a></li>
<li><a href="developer/thread_safety.html">Thread-Sicherheit in Version 2.x</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="index" id="index">Glossar und Index</a></h2>
<ul><li><a href="glossary.html">Glossar</a></li>
<li><a href="mod/">Modul-Index</a></li>
<li><a href="mod/directives.html">Direktiven-Index</a></li>
<li><a href="mod/quickreference.html">Kurzreferenz der Direktiven</a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Verfügbare Sprachen: </span><a href="./de/sitemap.html" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Kommentare</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sitemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Lizenziert unter der <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Module</a> | <a href="./mod/directives.html">Direktiven</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossar</a> | <a href="./sitemap.html">Seitenindex</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sitemap.html.tr.utf8 0000664 0001751 0001751 00000065504 14743132254 020707 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Site Haritası - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div>
<div id="page-content"><div id="preamble"><h1>Site Haritası</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Bu sayfada <a href="./">Apache HTTP Sunucusu Sürüm 2.4
Belgeleri</a>nin tamamı listelenmiştir.</p>
</div>
<div id="quickview"><ul id="toc">
<li><img alt="" src="./images/down.gif" /> <a href="#release">Sürümlerin Dağıtım Bilgileri</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Apache HTTP Sunucusunun Kullanımı</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#vhosts">Apache Sanal Konak (VirtualHost) Belgeleri</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rewrite">URL’lerin Yeniden Yazılması</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ssl">Apache SSL/TLS Şifrelemesi</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#howto">Kılavuzlar, Öğreticiler ve Nasıllar</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#platform">Platformlara Özgü Bilgiler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Apache HTTP Sunucusu ve Desteklenen Programlar</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#misc">Çeşitli Belgeler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Apache Modülleri</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Geliştirici Belgeleri</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#index">Terimler ve Dizin</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="release" id="release">Sürümlerin Dağıtım Bilgileri</a></h2>
<ul><li><a href="upgrading.html">2.4’e 2.2’den yükseltme</a></li>
<li><a href="new_features_2_4.html">2.3/2.4’teki yeni özellikler</a></li>
<li><a href="new_features_2_2.html">Apache 2.1/2.2’deki yeni özellikler</a></li>
<li><a href="new_features_2_0.html">Apache 2.0’daki yeni özellikler</a></li>
<li><a href="license.html">Apache Lisansı</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="using" id="using">Apache HTTP Sunucusunun Kullanımı</a></h2>
<ul><li><a href="install.html">Derleme ve Kurulum</a></li>
<li><a href="invoking.html">Sunucuyu Başlatma</a></li>
<li><a href="stopping.html">Sunucuyu Durdurma ve Yeniden Başlatma</a></li>
<li><a href="configuring.html">Yapılandırma Dosyaları</a></li>
<li><a href="sections.html">Directory, Location ve Files Bölümleri Nasıl Çalışır</a></li>
<li><a href="caching.html">İçerik Bellekleme</a></li>
<li><a href="server-wide.html">Sunucu Genelinde Yapılandırma</a></li>
<li><a href="logs.html">Günlük Dosyaları</a></li>
<li><a href="urlmapping.html">URL’lerin Dosya Sistemi ile Eşlenmesi</a></li>
<li><a href="dso.html">Devingen Paylaşımlı Nesne (DSO) Desteği</a></li>
<li><a href="content-negotiation.html">İçerik Dili Uzlaşımı</a></li>
<li><a href="custom-error.html">Özel Hata Yanıtları</a></li>
<li><a href="bind.html">Sunucunun Kullandığı Adreslerin ve Portların Ayarlanması</a></li>
<li><a href="mpm.html">Çok Süreçlilik Modülleri (MPM’ler)</a></li>
<li><a href="env.html">Ortam Değişkenleri</a></li>
<li><a href="expr.html">Apache'de İfadelerin Çözümlenmesi</a></li>
<li><a href="handler.html">Eylemci Kullanımı</a></li>
<li><a href="filter.html">Süzgeçler</a></li>
<li><a href="socache.html">Paylaşımlı Nesne Arabelleği Desteği</a></li>
<li><a href="suexec.html">CGI için Suexec Desteği</a></li>
<li><a href="dns-caveats.html">DNS ile ilgili Konular ve Apache</a></li>
<li><a href="http://wiki.apache.org/httpd/FAQ">Sıkça Sorulan Sorular</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="vhosts" id="vhosts">Apache Sanal Konak (VirtualHost) Belgeleri</a></h2>
<ul><li class="separate"><a href="vhosts/">Genel Bakış</a></li>
<li><a href="vhosts/name-based.html">İsme göre Sanal Konak Desteği</a></li>
<li><a href="vhosts/ip-based.html">IP Adresine göre Sanal Konak Desteği</a></li>
<li><a href="vhosts/mass.html">Sanal Konakların Devingen olarak Yapılandırılması</a></li>
<li><a href="vhosts/examples.html">VirtualHost Örnekleri</a></li>
<li><a href="vhosts/details.html">Sanal Konak Eşleştirmesinin Derinliğine İncelenmesi</a></li>
<li><a href="vhosts/fd-limits.html">Dosya Tanıtıcı Sınırlamaları</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="rewrite" id="rewrite">URL’lerin Yeniden Yazılması</a></h2>
<ul><li class="separate"><a href="rewrite/">Genel Bakış</a></li>
<li><a href="mod/mod_rewrite.html">mod_rewrite Başvuru Belgesi</a></li>
<li><a href="rewrite/intro.html">mod_rewrite ve düzenli ifadelere giriş</a></li>
<li><a href="rewrite/remapping.html">URL'lerin yeniden eşlenmesi ve
yönlendirilmesi içinmod_rewrite kullanımı</a></li>
<li><a href="rewrite/access.html">Erişim denetimi için mod_rewrite
kullanımı</a></li>
<li><a href="rewrite/vhosts.html">mod_rewrite ile devingen sanal konaklar</a></li>
<li><a href="rewrite/proxy.html">mod_rewrite ile devingen vekil kullanımı</a></li>
<li><a href="rewrite/rewritemap.html">RewriteMap kullanımı</a></li>
<li><a href="rewrite/advanced.html">İleri seviye teknikler</a></li>
<li><a href="rewrite/avoid.html">mod_rewrite ne zaman kullanılMAZ</a></li>
<li><a href="rewrite/flags.html">RewriteRule Seçenekleri</a></li>
<li><a href="rewrite/tech.html">Teknik Ayrıntılar</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="ssl" id="ssl">Apache SSL/TLS Şifrelemesi</a></h2>
<ul><li class="separate"><a href="ssl/">Genel Bakış</a></li>
<li><a href="ssl/ssl_intro.html">SSL/TLS Şifrelemesi: Giriş</a></li>
<li><a href="ssl/ssl_compat.html">SSL/TLS Şifrelemesi: Uyumluluk</a></li>
<li><a href="ssl/ssl_howto.html">SSL/TLS Şifrelemesi: Nasıl</a></li>
<li><a href="ssl/ssl_faq.html">SSL/TLS Şifrelemesi: SSS</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="howto" id="howto">Kılavuzlar, Öğreticiler ve Nasıllar</a></h2>
<ul><li class="separate"><a href="howto/">Genel Bakış</a></li>
<li><a href="howto/auth.html">Kimlik Doğrulama ve Yetkilendirme</a></li>
<li><a href="howto/access.html">Erişim Denetimi</a></li>
<li><a href="howto/cgi.html">CGI ile Devingen İçerik</a></li>
<li><a href="howto/ssi.html">Sunucu Taraflı İçerik Yerleştirme (SSI)</a></li>
<li><a href="howto/htaccess.html">.htaccess Dosyaları</a></li>
<li><a href="howto/public_html.html">Kullanıcı Dizinleri (public_html)</a></li>
<li><a href="howto/reverse_proxy.html">Ters Vekil Yapılandırma Rehberi</a></li>
<li><a href="howto/http2.html">HTTP/2 rehberi</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="platform" id="platform">Platformlara Özgü Bilgiler</a></h2>
<ul><li class="separate"><a href="platform/">Genel Bakış</a></li>
<li><a href="platform/windows.html">Microsoft
Windows ile Apache Kullanımı</a></li>
<li><a href="platform/win_compiling.html">Microsoft Windows için Apache Derleme</a></li>
<li><a href="platform/rpm.html">RPM Temelli Sistemlerde Apache Kullanımı</a></li>
<li><a href="platform/netware.html">Novell NetWare ile Apache Kullanımı</a></li>
<li><a href="platform/perf-hp.html">HPUX üzerinde Yüksek Başarımlı HTTP Sunucusu Çalıştırma</a></li>
<li><a href="platform/ebcdic.html">Apache EBCDIC Portu</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="programs" id="programs">Apache HTTP Sunucusu ve Desteklenen Programlar</a></h2>
<ul><li class="separate"><a href="programs/">Genel Bakış</a></li>
<li><a href="programs/httpd.html">Kılavuz Sayfası: httpd</a></li>
<li><a href="programs/ab.html">Kılavuz Sayfası: ab</a></li>
<li><a href="programs/apachectl.html">Kılavuz Sayfası: apachectl</a></li>
<li><a href="programs/apxs.html">Kılavuz Sayfası: apxs</a></li>
<li><a href="programs/configure.html">Kılavuz Sayfası: configure</a></li>
<li><a href="programs/dbmmanage.html">Kılavuz Sayfası: dbmmanage</a></li>
<li><a href="programs/fcgistarter.html">Kılavuz Sayfası: fcgistarter</a></li>
<li><a href="programs/htcacheclean.html">Kılavuz Sayfası: htcacheclean</a></li>
<li><a href="programs/htdbm.html">Kılavuz Sayfası: htdbm</a></li>
<li><a href="programs/htdigest.html">Kılavuz Sayfası: htdigest</a></li>
<li><a href="programs/htpasswd.html">Kılavuz Sayfası: htpasswd</a></li>
<li><a href="programs/httxt2dbm.html">Kılavuz Sayfası: httxt2dbm</a></li>
<li><a href="programs/logresolve.html">Kılavuz Sayfası: logresolve</a></li>
<li><a href="programs/log_server_status.html">Kılavuz Sayfası: log_server_status</a></li>
<li><a href="programs/rotatelogs.html">Kılavuz Sayfası: rotatelogs</a></li>
<li><a href="programs/split-logfile.html">Kılavuz Sayfası: split-logfile</a></li>
<li><a href="programs/suexec.html">Kılavuz Sayfası: suexec</a></li>
<li><a href="programs/other.html">Diğer Programlar</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="misc" id="misc">Çeşitli Belgeler</a></h2>
<ul><li class="separate"><a href="misc/">Genel Bakış</a></li>
<li><a href="misc/perf-tuning.html">Başarım Arttırma İpuçları</a></li>
<li><a href="misc/security_tips.html">Güvenlik İpuçları</a></li>
<li><a href="misc/relevant_standards.html">İlgili Standartlar</a></li>
<li><a href="misc/password_encryptions.html">Parola Şifreleme Çeşitleri</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="modules" id="modules">Apache Modülleri</a></h2>
<ul><li><a href="mod/module-dict.html">Apache modüllerini tanımlamakta kullanılan terimlerin açıklamaları</a></li>
<li><a href="mod/directive-dict.html">Apache yönergelerini tanımlamakta kullanılan terimlerin açıklamaları</a></li>
</ul><ul><li><a href="mod/core.html">Apache Temel Özellikleri</a></li>
<li><a href="mod/mpm_common.html">Apache MPM Ortak Yönergeleri</a></li>
<li><a href="mod/event.html">Apache MPM event</a></li>
<li><a href="mod/mpm_netware.html">Apache MPM netware</a></li>
<li><a href="mod/mpmt_os2.html">Apache MPM os2</a></li>
<li><a href="mod/prefork.html">Apache MPM prefork</a></li>
<li><a href="mod/mpm_winnt.html">Apache MPM winnt</a></li>
<li><a href="mod/worker.html">Apache MPM worker</a></li>
</ul><ul><li><a href="mod/mod_access_compat.html">Apache Modülü mod_access_compat</a></li>
<li><a href="mod/mod_actions.html">Apache Modülü mod_actions</a></li>
<li><a href="mod/mod_alias.html">Apache Modülü mod_alias</a></li>
<li><a href="mod/mod_allowmethods.html">Apache Modülü mod_allowmethods</a></li>
<li><a href="mod/mod_asis.html">Apache Modülü mod_asis</a></li>
<li><a href="mod/mod_auth_basic.html">Apache Modülü mod_auth_basic</a></li>
<li><a href="mod/mod_auth_digest.html">Apache Modülü mod_auth_digest</a></li>
<li><a href="mod/mod_auth_form.html">Apache Modülü mod_auth_form</a></li>
<li><a href="mod/mod_authn_anon.html">Apache Modülü mod_authn_anon</a></li>
<li><a href="mod/mod_authn_core.html">Apache Modülü mod_authn_core</a></li>
<li><a href="mod/mod_authn_dbd.html">Apache Modülü mod_authn_dbd</a></li>
<li><a href="mod/mod_authn_dbm.html">Apache Modülü mod_authn_dbm</a></li>
<li><a href="mod/mod_authn_file.html">Apache Modülü mod_authn_file</a></li>
<li><a href="mod/mod_authn_socache.html">Apache Modülü mod_authn_socache</a></li>
<li><a href="mod/mod_authnz_fcgi.html">Apache Modülü mod_authnz_fcgi</a></li>
<li><a href="mod/mod_authnz_ldap.html">Apache Modülü mod_authnz_ldap</a></li>
<li><a href="mod/mod_authz_core.html">Apache Modülü mod_authz_core</a></li>
<li><a href="mod/mod_authz_dbd.html">Apache Modülü mod_authz_dbd</a></li>
<li><a href="mod/mod_authz_dbm.html">Apache Modülü mod_authz_dbm</a></li>
<li><a href="mod/mod_authz_groupfile.html">Apache Modülü mod_authz_groupfile</a></li>
<li><a href="mod/mod_authz_host.html">Apache Modülü mod_authz_host</a></li>
<li><a href="mod/mod_authz_owner.html">Apache Modülü mod_authz_owner</a></li>
<li><a href="mod/mod_authz_user.html">Apache Modülü mod_authz_user</a></li>
<li><a href="mod/mod_autoindex.html">Apache Modülü mod_autoindex</a></li>
<li><a href="mod/mod_brotli.html">Apache Modülü mod_brotli</a></li>
<li><a href="mod/mod_buffer.html">Apache Modülü mod_buffer</a></li>
<li><a href="mod/mod_cache.html">Apache Modülü mod_cache</a></li>
<li><a href="mod/mod_cache_disk.html">Apache Modülü mod_cache_disk</a></li>
<li><a href="mod/mod_cache_socache.html">Apache Modülü mod_cache_socache</a></li>
<li><a href="mod/mod_cern_meta.html">Apache Modülü mod_cern_meta</a></li>
<li><a href="mod/mod_cgi.html">Apache Modülü mod_cgi</a></li>
<li><a href="mod/mod_cgid.html">Apache Modülü mod_cgid</a></li>
<li><a href="mod/mod_charset_lite.html">Apache Modülü mod_charset_lite</a></li>
<li><a href="mod/mod_data.html">Apache Modülü mod_data</a></li>
<li><a href="mod/mod_dav.html">Apache Modülü mod_dav</a></li>
<li><a href="mod/mod_dav_fs.html">Apache Modülü mod_dav_fs</a></li>
<li><a href="mod/mod_dav_lock.html">Apache Modülü mod_dav_lock</a></li>
<li><a href="mod/mod_dbd.html">Apache Modülü mod_dbd</a></li>
<li><a href="mod/mod_deflate.html">Apache Modülü mod_deflate</a></li>
<li><a href="mod/mod_dialup.html">Apache Modülü mod_dialup</a></li>
<li><a href="mod/mod_dir.html">Apache Modülü mod_dir</a></li>
<li><a href="mod/mod_dumpio.html">Apache Modülü mod_dumpio</a></li>
<li><a href="mod/mod_echo.html">Apache Modülü mod_echo</a></li>
<li><a href="mod/mod_env.html">Apache Modülü mod_env</a></li>
<li><a href="mod/mod_example_hooks.html">Apache Modülü mod_example_hooks</a></li>
<li><a href="mod/mod_expires.html">Apache Modülü mod_expires</a></li>
<li><a href="mod/mod_ext_filter.html">Apache Modülü mod_ext_filter</a></li>
<li><a href="mod/mod_file_cache.html">Apache Modülü mod_file_cache</a></li>
<li><a href="mod/mod_filter.html">Apache Modülü mod_filter</a></li>
<li><a href="mod/mod_headers.html">Apache Modülü mod_headers</a></li>
<li><a href="mod/mod_heartbeat.html">Apache Modülü mod_heartbeat</a></li>
<li><a href="mod/mod_heartmonitor.html">Apache Modülü mod_heartmonitor</a></li>
<li><a href="mod/mod_http2.html">Apache Modülü mod_http2</a></li>
<li><a href="mod/mod_ident.html">Apache Modülü mod_ident</a></li>
<li><a href="mod/mod_imagemap.html">Apache Modülü mod_imagemap</a></li>
<li><a href="mod/mod_include.html">Apache Modülü mod_include</a></li>
<li><a href="mod/mod_info.html">Apache Modülü mod_info</a></li>
<li><a href="mod/mod_isapi.html">Apache Modülü mod_isapi</a></li>
<li><a href="mod/mod_lbmethod_bybusyness.html">Apache Modülü mod_lbmethod_bybusyness</a></li>
<li><a href="mod/mod_lbmethod_byrequests.html">Apache Modülü mod_lbmethod_byrequests</a></li>
<li><a href="mod/mod_lbmethod_bytraffic.html">Apache Modülü mod_lbmethod_bytraffic</a></li>
<li><a href="mod/mod_lbmethod_heartbeat.html">Apache Modülü mod_lbmethod_heartbeat</a></li>
<li><a href="mod/mod_ldap.html">Apache Modülü mod_ldap</a></li>
<li><a href="mod/mod_log_config.html">Apache Modülü mod_log_config</a></li>
<li><a href="mod/mod_log_debug.html">Apache Modülü mod_log_debug</a></li>
<li><a href="mod/mod_log_forensic.html">Apache Modülü mod_log_forensic</a></li>
<li><a href="mod/mod_logio.html">Apache Modülü mod_logio</a></li>
<li><a href="mod/mod_lua.html">Apache Modülü mod_lua</a></li>
<li><a href="mod/mod_macro.html">Apache Modülü mod_macro</a></li>
<li><a href="mod/mod_md.html">Apache Modülü mod_md</a></li>
<li><a href="mod/mod_mime.html">Apache Modülü mod_mime</a></li>
<li><a href="mod/mod_mime_magic.html">Apache Modülü mod_mime_magic</a></li>
<li><a href="mod/mod_negotiation.html">Apache Modülü mod_negotiation</a></li>
<li><a href="mod/mod_nw_ssl.html">Apache Modülü mod_nw_ssl</a></li>
<li><a href="mod/mod_privileges.html">Apache Modülü mod_privileges</a></li>
<li><a href="mod/mod_proxy.html">Apache Modülü mod_proxy</a></li>
<li><a href="mod/mod_proxy_ajp.html">Apache Modülü mod_proxy_ajp</a></li>
<li><a href="mod/mod_proxy_balancer.html">Apache Modülü mod_proxy_balancer</a></li>
<li><a href="mod/mod_proxy_connect.html">Apache Modülü mod_proxy_connect</a></li>
<li><a href="mod/mod_proxy_express.html">Apache Modülü mod_proxy_express</a></li>
<li><a href="mod/mod_proxy_fcgi.html">Apache Modülü mod_proxy_fcgi</a></li>
<li><a href="mod/mod_proxy_fdpass.html">Apache Modülü mod_proxy_fdpass</a></li>
<li><a href="mod/mod_proxy_ftp.html">Apache Modülü mod_proxy_ftp</a></li>
<li><a href="mod/mod_proxy_hcheck.html">Apache Modülü mod_proxy_hcheck</a></li>
<li><a href="mod/mod_proxy_html.html">Apache Modülü mod_proxy_html</a></li>
<li><a href="mod/mod_proxy_http.html">Apache Modülü mod_proxy_http</a></li>
<li><a href="mod/mod_proxy_http2.html">Apache Modülü mod_proxy_http2</a></li>
<li><a href="mod/mod_proxy_scgi.html">Apache Modülü mod_proxy_scgi</a></li>
<li><a href="mod/mod_proxy_uwsgi.html">Apache Modülü mod_proxy_uwsgi</a></li>
<li><a href="mod/mod_proxy_wstunnel.html">Apache Modülü mod_proxy_wstunnel</a></li>
<li><a href="mod/mod_ratelimit.html">Apache Modülü mod_ratelimit</a></li>
<li><a href="mod/mod_reflector.html">Apache Modülü mod_reflector</a></li>
<li><a href="mod/mod_remoteip.html">Apache Modülü mod_remoteip</a></li>
<li><a href="mod/mod_reqtimeout.html">Apache Modülü mod_reqtimeout</a></li>
<li><a href="mod/mod_request.html">Apache Modülü mod_request</a></li>
<li><a href="mod/mod_rewrite.html">Apache Modülü mod_rewrite</a></li>
<li><a href="mod/mod_sed.html">Apache Modülü mod_sed</a></li>
<li><a href="mod/mod_session.html">Apache Modülü mod_session</a></li>
<li><a href="mod/mod_session_cookie.html">Apache Modülü mod_session_cookie</a></li>
<li><a href="mod/mod_session_crypto.html">Apache Modülü mod_session_crypto</a></li>
<li><a href="mod/mod_session_dbd.html">Apache Modülü mod_session_dbd</a></li>
<li><a href="mod/mod_setenvif.html">Apache Modülü mod_setenvif</a></li>
<li><a href="mod/mod_slotmem_plain.html">Apache Modülü mod_slotmem_plain</a></li>
<li><a href="mod/mod_slotmem_shm.html">Apache Modülü mod_slotmem_shm</a></li>
<li><a href="mod/mod_so.html">Apache Modülü mod_so</a></li>
<li><a href="mod/mod_socache_dbm.html">Apache Modülü mod_socache_dbm</a></li>
<li><a href="mod/mod_socache_dc.html">Apache Modülü mod_socache_dc</a></li>
<li><a href="mod/mod_socache_memcache.html">Apache Modülü mod_socache_memcache</a></li>
<li><a href="mod/mod_socache_redis.html">Apache Modülü mod_socache_redis</a></li>
<li><a href="mod/mod_socache_shmcb.html">Apache Modülü mod_socache_shmcb</a></li>
<li><a href="mod/mod_speling.html">Apache Modülü mod_speling</a></li>
<li><a href="mod/mod_ssl.html">Apache Modülü mod_ssl</a></li>
<li><a href="mod/mod_status.html">Apache Modülü mod_status</a></li>
<li><a href="mod/mod_substitute.html">Apache Modülü mod_substitute</a></li>
<li><a href="mod/mod_suexec.html">Apache Modülü mod_suexec</a></li>
<li><a href="mod/mod_systemd.html">Apache Modülü mod_systemd</a></li>
<li><a href="mod/mod_unique_id.html">Apache Modülü mod_unique_id</a></li>
<li><a href="mod/mod_unixd.html">Apache Modülü mod_unixd</a></li>
<li><a href="mod/mod_userdir.html">Apache Modülü mod_userdir</a></li>
<li><a href="mod/mod_usertrack.html">Apache Modülü mod_usertrack</a></li>
<li><a href="mod/mod_version.html">Apache Modülü mod_version</a></li>
<li><a href="mod/mod_vhost_alias.html">Apache Modülü mod_vhost_alias</a></li>
<li><a href="mod/mod_watchdog.html">Apache Modülü mod_watchdog</a></li>
<li><a href="mod/mod_xml2enc.html">Apache Modülü mod_xml2enc</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="developer" id="developer">Geliştirici Belgeleri</a></h2>
<ul><li class="separate"><a href="developer/">Genel Bakış</a></li>
<li><a href="developer/API.html">Apache API Bilgileri</a></li>
<li><a href="developer/new_api_2_4.html">Apache HTTPD 2.4'te API güncellemeleri</a></li>
<li><a href="developer/modguide.html">Apache HTTPD 2.4 için Modül Geliştirme</a></li>
<li><a href="developer/documenting.html">Apache HTTPD'nin Belgelendirilmesi</a></li>
<li><a href="developer/hooks.html">Apache 2.x Kullanıcı İşlevleri</a></li>
<li><a href="developer/modules.html">Modüllerin 1.3’ten Apache 2.x’e Dönüştürülmesi</a></li>
<li><a href="developer/request.html">2.x’de İsteklerin İşlenmesi</a></li>
<li><a href="developer/filters.html">2.x’de Süzgeçler Nasıl Çalışır</a></li>
<li><a href="developer/output-filters.html">2.x'de çıktı süzgeçleri için yol göstericiler</a></li>
<li><a href="developer/thread_safety.html">2.x'de Çok Evrelilik Konuları</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="index" id="index">Terimler ve Dizin</a></h2>
<ul><li><a href="glossary.html">Terimler</a></li>
<li><a href="mod/">Modül Dizini</a></li>
<li><a href="mod/directives.html">Yönerge Dizini</a></li>
<li><a href="mod/quickreference.html">Hızlı Yönerge Kılavuzu</a></li>
<li><a href="mod/overrides.html">.htaccess için Geçersizleştirme Sınıfları</a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sitemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/stopping.html.ja.utf8 0000664 0001751 0001751 00000047754 14743132254 021064 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Server の停止と再起動 - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Apache HTTP Server の停止と再起動</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>この文書では Unix に類似したシステムでの
Apache HTTP Serverの停止と再起動について扱っています。
Windows NT, 2000, XP ユーザは<a href="platform/windows.html#winsvc">サービスとして
httpd を実行する</a>で、Windows 9x, MEユーザは<a href="platform/windows.html#wincons">コンソールアプリケーションとして
httpd を実行する</a>で、
これらのプラットホームでの使用方法をご覧下さい。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">イントロダクション</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#term">急な停止</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#graceful">緩やかな再起動</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#hup">急な再起動</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#gracefulstop">緩やかな停止</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="invoking.html">Starting</a></li><li><a href="#comments_section">コメント</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="introduction" id="introduction">イントロダクション</a></h2>
<p>Apache HTTP Server を停止したり再起動したりするためには、実行されている
<code class="program"><a href="./programs/httpd.html">httpd</a></code> プロセスにシグナルを送る必要があります。
シグナルを送るには二つの方法があります。
一つ目はプロセスに直接シグナルを送る unix の <code>kill</code>
コマンドを使用する方法です。
システムを見ればたくさんの <code class="program"><a href="./programs/httpd.html">httpd</a></code> が
実行されているのに気が付くでしょうが、シグナルを送るのは
親プロセスだけで、それ以外の個々のプロセスには
シグナルを送らないで下さい。その親プロセスの pid は
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>
に書かれています。これはつまり、親以外のプロセスに
シグナルを送る必要すらない、ということです。
親プロセスに送ることができる 4 種類のシグナルがあります:
<code><a href="#term">TERM</a></code>,
<code><a href="#hup">HUP</a></code>,
<code><a href="#graceful">USR1</a></code>,
<code><a href="#gracefulstop">WINCH</a></code>
です。これらの説明については続きをご覧下さい。</p>
<p>親プロセスにシグナルを送るには、
次のようなコマンドを発行して下さい:</p>
<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
<p><code class="program"><a href="./programs/httpd.html">httpd</a></code> プロセスにシグナルを送る 2 番目の方法は
<code>-k</code> というコマンドライン引数を使用することです。
下で説明されているように、<code>stop</code>, <code>restart</code>,
<code>graceful</code>, <code>graceful-stop</code> を指定できます。
これらは <code class="program"><a href="./programs/httpd.html">httpd</a></code> の引数ですが、
制御用のスクリプト <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> はそれらの引数をそのまま
<code class="program"><a href="./programs/httpd.html">httpd</a></code> に渡します。</p>
<p><code class="program"><a href="./programs/httpd.html">httpd</a></code> にシグナルを送った後、
実行状況を次のコマンドで読むことができます:</p>
<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
<p>ここに挙げた例は、各自の
<code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>
と
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>
の設定に適合するように適宜修正して下さい。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="term" id="term">急な停止</a></h2>
<dl><dt>シグナル: TERM</dt>
<dd><code>apachectl -k stop</code></dd>
</dl>
<p><code>TERM</code> あるいは <code>stop</code>
シグナルを親プロセスに送ると、即座に子プロセス全てを kill しようとします。
子プロセスを完全に kill し終わるまでに数秒かかるかもしれません。
その後、親プロセス自身が終了します。
処理中のリクエストは全て停止され、もはやリクエストに対する
応答はされません。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="graceful" id="graceful">緩やかな再起動</a></h2>
<dl><dt>シグナル: USR1</dt>
<dd><code>apachectl -k graceful</code></dd>
</dl>
<p>親プロセスは <code>USR1</code> あるいは <code>graceful</code>
シグナルを受け取ると、子プロセスに現在のリクエストの処理の後に終了する
(あるいは何もしていなければすぐに終了する)
ように<em>助言</em>します。
親プロセスは設定ファイルを再読込して、ログファイルを開き直します。
子プロセスが徐々になくなるに従って、
新しい<em>世代</em>の設定による子プロセスに置き換えていきます。
そして、これらが新たなリクエストに即座に応答し始めます。</p>
<p>このコードは常に
MPM のプロセス制御ディレクティブの設定を重視しますので、
クライアントのリクエストを扱うプロセスとスレッドの数を再起動の処理中も
適切な値に維持されます。。また、次のようにして
<code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
を守ります:
少なくとも 1 秒後に <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> 個の新しい子プロセスが
生成されていなければ、その数になるように適宜プロセスを生成します。
この挙動は現在の負荷に対して適切な子プロセスの数と
<code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> パラメータでの
希望の数の両方を維持しようとしています。</p>
<p><code class="module"><a href="./mod/mod_status.html">mod_status</a></code> を
使用している場合は、<code>USR1</code> シグナルが送られた際に
サーバ統計がゼロに<strong>設定されない</strong>ことに
注意してください。
サーバが新しいリクエストに応答不能な時間を最小にするように
(リクエストは OS によってキューに追加されるので絶対に紛失はしません)、
また同時に、希望のチューニングパラメータを守るように
コードは書かれています。
このようにするために、世代をまたがった全子プロセスの追跡に使われている
<em>スコアボード</em>を維持しなければなりません。</p>
<p>status モジュールは、緩やかな再起動以前から開始して
リクエストに応答し続けている子プロセスを特定するために、
<code>G</code> を使うこともします。</p>
<p>現在、<code>USR1</code> を使うログ移動スクリプトでは、
再起動前の子プロセスがログを書き終わったことを確証する方法が
ありません。古いログに対して何かする前に、
<code>USR1</code> シグナルを送った後いくらか適当な時間待つことを
提案します。例えば、帯域の狭い通信路のユーザのリクエストのほとんどが 10
分以下で完了しているということが分かっていれば、
古いログに何かする前に 15 分待つということです。</p>
<div class="note"><p>再起動が発行されると設定ファイルの構文チェックがまず走り、
設定ファイルに (構文上の) 誤りがないかチェックされます。
誤りがあった場合エラーメッセージでその旨が示され、サーバは再起動されません。
こうすることでサーバが終了しているけれども再起動できないという状況を
防ぎ、サーバが機能不全な状態になるのを防いでいます。</p>
<p>ただしこれでもサーバが正しく再起動することは保証されません。
設定ファイルの意味的な内容を構文と同様に検証したい場合は、
非 root ユーザで <code class="program"><a href="./programs/httpd.html">httpd</a></code> を起動しようとすればわかります。
もしエラーがなければ、ソケットやログを開こうとして
root でないため
(もしくは実行中の <code class="program"><a href="./programs/httpd.html">httpd</a></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="hup" id="hup">急な再起動</a></h2>
<dl><dt>シグナル: HUP</dt>
<dd><code>apachectl -k restart</code></dd>
</dl>
<p><code>HUP</code> あるいは <code>restart</code> シグナルを親プロセスに送ると、
<code>TERM</code> と同様に子プロセスを kill しますが、
親プロセスは終了しません。
設定ファイルを再読込して、ログファイル全てを開き直します。
その後、新しい子プロセスを起動して応答を続けます。</p>
<p><code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
を使っている場合は、<code>HUP</code> が送られた場合に
サーバ統計がゼロに設定されることに注意してください。</p>
<div class="note">graceful 再起動時は、再起動前に構文チェックが行われます。
もし構文エラーがあればその旨が示され、再起動は行われません。</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="gracefulstop" id="gracefulstop">緩やかな停止</a></h2>
<dl><dt>Signal: WINCH</dt>
<dd><code>apachectl -k graceful-stop</code></dd>
</dl>
<p><code>WINCH</code> や <code>graceful-stop</code> シグナルを受け取ると、
親プロセスは子プロセスに現在処理中のリクエストの後に終了する
(あるいは処理中のものが何もなければ直ちに終了する)
ように<em>アドバイス</em>します。
その後親プロセスは <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>
を削除し、ポートでの Listen を全て停止します。
親プロセスはどの子プロセスがリクエスト処理中かを監視し続けています。
全ての子プロセスが終了するか
<code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code>
で設定した時間が過ぎると、親プロセスも終了します。
タイムアウトに達した場合、残りの子プロセスには <code>TERM</code>
シグナルが送信され強制的に終了されます。</p>
<p>"graceful" 状態の場合 <code>TERM</code> シグナルを受け取ると、
親プロセスも子プロセスもすぐに終了します。しかしながら
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>
が削除されてしまっているので、<code>apachectl</code>
や <code>httpd</code> にこのシグナルを送ることはできません。</p>
<div class="note"><p><code>graceful-stop</code> を使うとまったく同一に設定された
複数の <code class="program"><a href="./programs/httpd.html">httpd</a></code> を同時に実行することができます。
httpd を緩やかにアップグレードするのにはとても便利ですが、
設定ファイルによってはデッドロックやレースコンディションを
引き起こすこともあります。</p>
<p>ディスク上のファイルを使うもの、たとえばロックファイル
(<code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>) や Unix ソケットファイル
(<code class="directive"><a href="./mod/mod_cgid.html#scriptsock">ScriptSock</a></code>)
などはサーバの PID を含めて管理されていて、
共存できるよう注意が払われています。
しかしその他設定ディレクティブやサードパーティ製のモジュール、
CGI ユーティリティのパーシステント層などで
ディスク上にロックファイルや状態管理ファイルを
使っている場合は、実行されている複数の <code class="program"><a href="./programs/httpd.html">httpd</a></code>
が互いに衝突しないように気をつけなければなりません。</p>
<p><code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> 形式のパイプを使ったログといった、
その他潜在的なレースコンディションについても注意しなければなりません。
複数の <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> が同じファイルを同時に
rotate しようとすると、互いにログファイルを破壊してしまいます。</p>
</div>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/stopping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/stopping.html.ko.euc-kr 0000664 0001751 0001751 00000035254 14743132254 021373 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>ߴܰ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>ߴܰ </h1>
<div class="toplang">
<p><span> : </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> н ýۿ ġ ߴϰ ϴ
ִ. NT, 2000, XP ڴ <a href="platform/windows.html#winsvc"> ġ
ϱ</a>, 9x ME ڴ <a href="platform/windows.html#wincons">ݼ α
ġ ϱ</a> ÷ ġ ۹ ִ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Ұ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#term"> ߴ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#graceful"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#hup"> </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#race">η: ñ׳ΰ ̽ </a></li>
</ul><h3></h3><ul class="seealso"><li><a href="programs/httpd.html">httpd</a></li><li><a href="programs/apachectl.html">apachectl</a></li><li><a href="#comments_section">Comments</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="introduction" id="introduction">Ұ</a></h2>
<p>ġ ߴϰ Ϸ ϰ ִ
<code>httpd</code> μ ñ׳ Ѵ. ñ׳
ΰ. ϳ н <code>kill</code>
ɾ Ͽ μ ñ׳ ̴.
ýۿ <code>httpd</code> , <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> pid ϵ θܿ
ٸ μ ñ׳(signal) ȵȴ. , θ̿ܿ
ٸ μ ñ׳ ʿ䰡 ٴ ̴. θ
ִ ñ׳ , <code><a href="#term">TERM</a></code>, <code><a href="#hup">HUP</a></code>, <code><a href="#graceful">USR1</a></code>̴.</p>
<p> θ ñ׳ :</p>
<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
<p><code>httpd</code> μ ñ׳ ٸ
ɼ <code>-k</code> ϴ ̴. Ʒ
<code>stop</code>, <code>restart</code>, <code>graceful</code>
<a href="programs/httpd.html">httpd</a> ƱԸƮ̴.
ƱԸƮ <code>httpd</code> ϴ, <a href="programs/apachectl.html">apachectl</a> ũƮ
ϱ Ѵ.</p>
<p><code>httpd</code> ñ׳ , ɾ
Ȳ ִ:</p>
<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
<p> <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> ˸° ϶.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="term" id="term"> ߴ</a></h2>
<dl><dt>ñ׳: TERM</dt>
<dd><code>apachectl -k stop</code></dd>
</dl>
<p><code>TERM</code>̳ <code>stop</code> ñ׳ θ
ڽ δ. ڽ ̴µ
ʰ ɸ ִ. θ Ѵ. ó û
ߴܵǰ, ̻ û ʴ´.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="graceful" id="graceful"> </a></h2>
<dl><dt>ñ׳: USR1</dt>
<dd><code>apachectl -k graceful</code></dd>
</dl>
<p><code>USR1</code>̳ <code>graceful</code> ñ׳
θ θ μ ڽĵ鿡 û
ó ϶ (Ȥ ƹ͵ ó ʴٸ
϶) <em>Ѵ</em>. θ
ٽа αϵ ٽ . ڽ θ
ڽĴ ο <em></em> ڽ
Ͽ û óϰ Ѵ.</p>
<div class="note"> (graceful restart) <code>USR1</code>
÷ (<code>WINCH</code> )
ٸ ñ׳ ִ. <code>apachectl graceful</code>
÷ ˸ ñ׳ .</div>
<p> MPM μ þ
Ͽ, ۵ Ŭ̾Ʈ ϴ μ 尡
ϵ Ǿ. Դٰ <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>,
ּ StartServersŭ ο ڽ ȸ ڽ
StartServers ǵ . , α
Ͽ ˸ ڽ ϸ,
<code class="directive">StartServers</code> Ķͷ
븦 Ѵ.</p>
<p><code class="module"><a href="./mod/mod_status.html">mod_status</a></code> ڴ <code>USR1</code>
谡 0 <strong></strong>
̴. ο û (ü ̵ ť Ƽ
쿡 Ҿ ʴ´) ó ϴ ð
ּȭϰ Ʃ Ķ ϵ .
̸ 밣 ڽ ϴ <em>scoreboard</em>
Ѵ.</p>
<p>status Ͽ
û óϰ ִ ڽ <code>G</code> ˷ش.</p>
<p>δ <code>USR1</code> ϴ αȯ ũƮ
ڽ αۼ ƴ ִ
. 츮 <code>USR1</code> ñ׳
ð α ٷ絵 Ѵ.
뿪 κ ġµ 10
Ȱɸٸ, α ٷ 15 ٸ.</p>
<div class="note">Ͽ ִٸ ۽ θ
ʰ Ѵ. , Ҷ
ڽ ǵ д. (ڽĵ ڽ û
óϰ "ݰ Ѵ".) ̴ Ҷ
ȴ. ڽ ٸ Ʈ Ѵ.
<code>-t</code> ɼ(<a href="programs/httpd.html">httpd</a> )
˻ ִ. ̷ ˻絵 ùٷ
Ѵ. ƴ ǹ̸
˻Ϸ root ƴ ڷ <code>httpd</code> غ ִ.
root ƴϱ (ƴϸ Ʈ ϴ
<code>httpd</code> DZ) ٸ ϰ
α õϴ ̴. ٸ
Ѵٸ Ƹ Ͽ ̴.
ϱ ľѴ.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="hup" id="hup"> </a></h2>
<dl><dt>ñ׳: HUP</dt>
<dd><code>apachectl -k restart</code></dd>
</dl>
<p><code>HUP</code>̳ <code>restart</code> ñ׳
θ <code>TERM</code> ڽ
θ ʴ´. θ ٽа
α ٽ . ο ڽĵ
Ѵ.</p>
<p><code class="module"><a href="./mod/mod_status.html">mod_status</a></code> ڴ <code>HUP</code>
谡 0 ִ.</p>
<div class="note">Ͽ ִٸ ص θ
ʰ ̴. ̸ ϴ ϶.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="race" id="race">η: ñ׳ΰ ̽ </a></h2>
<p>Apache 1.2b9 ۰ ñ׳ο
<em>̽ (race condition)</em> ־. (̽
ڸ, ߸ȶ Ͼ
Ѵ ʴ ð ΰ .) "ùٸ"
ִ ŰĿ 츮 ̷ ִ ذߴ.
ŰĿ ̽
϶.</p>
<p><code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code>
ũ ϴ ŰĴ scoreboard Ʈ ɼ
ִ. (<code>HUP</code>) "bind: Address already in use"
Ȥ (<code>USR1</code> ) "long lost child came home!"
ִ. ڴ ɰ ̰, ڴ
scoreboard slot Ұ . ̰
ϱ õѴ. ذϱ ſ
. κ ŰĴ scoreboard
ʴ´. ϴ ŰĶ <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code> ϶.</p>
<p> ŰĿ ӵǴ HTTP (KeepAlive)
ι° û óϴ ڽĿ ణ ̽
ִ. ڽ û û б
ִ. ʹ ʰ ߰Ͽ 1.2 Ŀ
Ǿ. Ʈ ̳ ðѶ KeepAlive
Ŭ̾Ʈ ̷ 츦 ؾϱ ̷л
ȵȴ. ˻ϱ ʿ 20 ϴ
Ŭ̾Ʈ ̳ Ʈ
о̱ ʴ´ٸ ȵȴ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/stopping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/stopping.html.tr.utf8 0000664 0001751 0001751 00000047067 14743132254 021114 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Sunucusunun Durdurulması ve Yeniden Başlatılması - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache HTTP Sunucusunun Durdurulması ve Yeniden Başlatılması</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belge Apache HTTP Sunucusunun Unix benzeri sistemlerde durdurulması
ve yeniden başlatılması konularını kapsar. Windows NT, 2000 ve XP
kullanıcıları Apache HTTPd’yi bu platformlarda nasıl denetimlerine
alacaklarını öğrenmek için <a href="platform/windows.html#winsvc">httpd’nin Bir Hizmet Olarak Çalıştırılması</a> sayfasına, Windows 9x ve
ME kullanıcıları ise <a href="platform/windows.html#wincons">httpd’nin
Bir Konsol Uygulaması Olarak Çalıştırılması</a> sayfasına
bakabilirler.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Giriş</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#term">Hemen Durdur</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#graceful">Nazikçe Yeniden Başlat</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#hup">Hemen Yeniden Başlat</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#gracefulstop">Nazikçe Durdur</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="invoking.html">Başlatma</a></li><li><a href="#comments_section">Yorumlar</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="introduction" id="introduction">Giriş</a></h2>
<p>Apache HTTP Sunucusunu durdurmak ve yeniden başlatmak için çalışan
<code class="program"><a href="./programs/httpd.html">httpd</a></code> süreçlerine bir sinyal göndermeniz gerekir.
Sinyal göndermek için iki yol vardır. İlki, süreçlere doğrudan sinyal
göndermek için unix <code>kill</code> komutunun kullanımıdır. Bu
suretle, sisteminizde çalışmakta olan bir çok <code class="program"><a href="./programs/httpd.html">httpd</a></code>
sürecini uyarabilirsiniz ama süreç kimliği <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> yönergesi ile belirtilen dosyada
tutulan ana süreç dışında hiçbirine sinyal göndermemelisiniz. Başka
bir deyişle, ana süreç haricinde hiçbir sürece sinyal göndermeye normal
olarak ihtiyacınız olmaması gerekir. Ana sürece gönderebileceğiniz
dört çeşit sinyal vardır:
<code><a href="#term">TERM</a></code>,
<code><a href="#graceful">USR1</a></code>,
<code><a href="#hup">HUP</a></code> ve
<code><a href="#gracefulstop">WINCH</a></code>. Bunlar yeri geldikçe
açıklanacaktır.</p>
<p>Ana sürece <code>kill</code> ile sinyal göndermek için şöyle bir
komut verebilirsiniz:</p>
<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
<p><code class="program"><a href="./programs/httpd.html">httpd</a></code> süreçlerine sinyal göndermenin ikinci yolu
<code>-k</code> komut satırı seçeneğini şu değerlerden biri ile
kullanmaktır: <code>stop</code>, <code>restart</code>,
<code>graceful</code> ve <code>graceful-stop</code>. Bunlar aşağıda
açıklanacaktır. <code>-k</code> komut satırı seçeneği
<code class="program"><a href="./programs/httpd.html">httpd</a></code>’ye ait olsa da ana sürece bu sinyalleri
göndermek için <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> betiğini kullanmanızı
öneririz. <code class="program"><a href="./programs/apachectl.html">apachectl</a></code>, komut satırı seçeneklerini
<code class="program"><a href="./programs/httpd.html">httpd</a></code>’ye aktaracaktır.</p>
<p><code class="program"><a href="./programs/httpd.html">httpd</a></code>’ye sinyal gönderdikten sonra olup biteni şu
komutla izleyebilirsiniz:</p>
<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
<p>Bu örnekleri, kendi <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> ve
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> yönergelerinizdeki
ayarlara uygun olarak değiştirdikten sonra kullanınız.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="term" id="term">Hemen Durdur</a></h2>
<dl><dt>Sinyal: TERM</dt>
<dd><code>apachectl -k stop</code></dd>
</dl>
<p>Ana sürece <code>TERM</code> veya <code>stop</code> sinyali
göndererek tüm çocukların bir an önce öldürülmeye çalışılmasını sağlamış
olursunuz. Tüm çocukların öldürülmesi bir kaç saniye sürebilir. Son
olarak ana süreç çıkacaktır. Yanıtlanmakta olan istekler hemen
sonlandırılacak ve artık isteklere yanıt verilmeyecektir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="graceful" id="graceful">Nazikçe Yeniden Başlat</a></h2>
<dl><dt>Sinyal: USR1</dt>
<dd><code>apachectl -k graceful</code></dd>
</dl>
<p>Ana sürece <code>USR1</code> veya <code>graceful</code> sinyalinin
gönderilmesi, çocuklara ellerindeki mevcut işleri bitirdikten sonra
(veya sundukları bir şey yoksa hemen) çıkmalarının <em>önerilmesi</em>
demektir. Ana süreç kendi yapılandırma dosyalarını yeniden okur ve
kendi günlük dosyalarını yeniden açar. Ana sürecin öldürdüğü her sürecin
yerine yeni yapılandırma <em>kuşağından</em> bir süreç başlatır ve hemen
yeni isteklere hizmet sunulmaya başlanır.</p>
<p>Bu kod MPM’lerin süreçleri denetleyen yönergelerine daima uyacak
şekilde tasarlanmıştır. Bu suretle, istemcilere hizmet sunacak çocuk
süreçler ve evreler, yeniden başlatma işleminde de uygun sayıda
sağlanmış olur. Bununla birlikte, <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> yönergesinde şöyle
davranılır: İlk saniye içinde en azından <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> sayıda yeni çocuk
oluşturulmamışsa iş olmayan bir devreyi geçiştirecek kadarı oluşturulur.
Ardından sunucunun mevcut yükünü karşılamak için gereken sayıda çocuk
süreç oluşturulur. Bu suretle, kod her ikisi için de gereğini yerine
getirmeye çalışmış olur.</p>
<p><code class="module"><a href="./mod/mod_status.html">mod_status</a></code> kullanıcıları <code>USR1</code>
gönderildiği zaman sunucu istatistiklerinin sıfırlanmadığı konusunda
uyarılacaktır. Kod, sunucunun yeni isteklere yanıt veremediği zamanı en
aza indirmenin yanısıra ayar parametrelerinize de uymak üzere
tasarlanmıştır (yeni istekler işletim sistemi tarafından kuyruğa
alınacağından bir istek kaybı olayı yaşanmaz). Bunu sağlamak için, her
iki kuşağın çocuklarının izini sürecek bir <em>çetele</em> tutulur.</p>
<p><code class="module"><a href="./mod/mod_status.html">mod_status</a></code> modülü, nazikçe yeniden başlat komutunun
verilmesinden önce başlamış ve sunulmaya devam eden isteklere bakan
çocukları imlemek için ayrıca bir <code>G</code> (Graceful’un baş harfi)
kullanır.</p>
<p>Günlük dosyası döndürme betiğine, yeniden başlatma öncesi günlüğe yazan
tüm çocukların işini bitirdiğini <code>USR1</code> kullanarak
bildirmenin bir yolu yoktur. Önerimiz, eski günlük kaydı üzerinde bir
işlem yapmaya başlamadan önce <code>USR1</code> sinyali gönderilmesinin
ardından belli bir süre beklenilmesi olacaktır. Örneğin, düşük band
genişliğine sahip istemcilere hizmet sunan çoğu sürecin işinin 10
dakikadan önce bitmeyeceğini gözönüne alarak eski günlük üzerinde işlem
yapmaya başlamak için 15 dakika beklenebilir.</p>
<div class="note">
<p>Bir yeniden başlatma isteğinde, yapılandırma dosyalarında bir hata
olmadığından emin olmak için önce bir sözdizimi denetimi yapılır. Eğer
yapılandırma dosyalarınızda bir hata varsa bu sözdizimi hatasıyla ilgili
bir hata iletisi alırsınız ve sunucu yeniden başlamayı reddeder. Bu
yolla, bir hata sonucu sunucunun çökerek yeniden başlamaması nedeniyle
işlevsiz bir sunucuyla başbaşa kalmanız önlenmiştir.</p>
<p>Ancak, bu hala sunucunuzun düzgünce yeniden başlatılmasını garanti
etmeyecektir. Yapılandırma dosyalarınızı sözdizimi denetiminin yanında
anlamlandırılması bakımından da sınamak için
<code class="program"><a href="./programs/httpd.html">httpd</a></code>’nin root olmayan bir kullanıcı tarafından
çalıştırılmasını deneyebilirsiniz. Eğer yapılandırma dosyalarında bir
hata yoksa soketleri ve günlük dosyalarını açmaya çalışırken root
aidiyetinde çalışmadığından veya çalışmakta olan asıl sunucu bu portları
zaten dinlediğinden başarısız olacaktır. Eğer başka bir sebeple
başarısız olursa olası sebep bir yapılandırma dosyası hatasıdır ve asıl
sunucuya ‘nazikçe yeniden başla’ komutunu vermeden önce bu hatayı
düzeltmeniz gerekir.</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="hup" id="hup">Hemen Yeniden Başlat</a></h2>
<dl><dt>Sinyal: HUP</dt>
<dd><code>apachectl -k restart</code></dd>
</dl>
<p>Ana sürece <code>HUP</code> veya <code>restart</code> sinyalinin
gönderilmesi tüm çocukların <code>TERM</code> sinyali gönderilmiş gibi
öldürülmesine sebep olur fakat ana sürecin çıkmasını sağlamaz.
Ana süreç yapılandırma dosyalarını yeniden okur ve günlük kayıt
dosyalarını yeniden açar. Bunların ardından isteklere yanıt verecek yeni
kuşak çocukları oluşturmaya başlar.</p>
<p><code class="module"><a href="./mod/mod_status.html">mod_status</a></code> kullanıcıları bir <code>HUP</code> sinyalı
gönderildiğinde sunucu istatistiklerinin sıfırlandığı konusunda
uyarılırlar.</p>
<div class="note">‘Nazikçe yeniden başlat’ komutundaki gibi yeniden başlatma öncesi
bir sözdizimi denetimi yapılır. Eğer yapılandırma dosyalarınızda
sözdizimi hatası varsa yeniden başlatma işlemi gerçekleşmez ve sözdizimi
hatalarıyla ilgili bildirim alırsınız.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="gracefulstop" id="gracefulstop">Nazikçe Durdur</a></h2>
<dl><dt>Sinyal: WINCH</dt>
<dd><code>apachectl -k graceful-stop</code></dd>
</dl>
<p>Ana sürecin <code>WINCH</code> veya <code>graceful-stop</code>
sinyalini alması, çocuklara ellerindeki mevcut işleri bitirdikten sonra
(veya sundukları bir şey yoksa hemen) çıkmalarının <em>önerilmesine</em>
sebep olur. Ana süreç bunun hemen ardından <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> dosyasını siler ve port
dinlemeyi keser. Ana süreç çalışmaya ve isteklere yanıt vermekte olan
çocuk süreçleri izlemeye devam eder. Tüm çocuklar işlerini bitirip
çıktığında veya <code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> ile belirtilen
zaman aşımı dolduğunda ana süreç de kendini sonlandırır. Eğer zaman aşımı
devreye girmişse o an çalışmakta olan çocuk süreçlere <code>TERM</code>
sinyali gönderilerek hemen çıkmaları sağlanır.</p>
<p>Bir <code>TERM</code> sinyali ile "graceful" durumundaki tüm çocuklar
ve ana süreç hemen sonlandırılacaktır. Bununla birlikte, <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> dosyası da silineceğinden, artık
<code>apachectl</code> veya <code>httpd</code>’yi bu sinyali göndermek
için kullanamayacaksınız.</p>
<div class="note"><p><code>graceful-stop</code> sinyali, aynı anda, aynı yapılandırma
ile çok sayıda <code class="program"><a href="./programs/httpd.html">httpd</a></code> kopyasının çalıştırılabilmesine
imkan verir. Bu, Apache nazikçe yükseltileceği zaman güçlü bir özellik
haline gelmekteyse de, bazı yapılandırmalarda yarış koşullarının
oluşmasına ve kısır çekişmelere (deadlock) sebep olabilir.</p>
<p>Sunucunun süreç kimliğini içeren kilit dosyaları (<code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>) ve Unix soket dosyaları
(<code class="directive"><a href="./mod/mod_cgid.html#scriptsock">ScriptSock</a></code>) gibi dosyaların
disk üzerindeki mevcudiyetlerinin sorunsuz olarak devam ettiğinden emin
olunmaya çalışılmalıdır. Ayrıca, bir yapılandırma yönergesi, üçüncü
parti bir modül veya kalıcı CGI uygulamalarına ait disk kilit veya durum
dosyaları olabilir; <code class="program"><a href="./programs/httpd.html">httpd</a></code>’nin birden fazla kopyasının
çalışması nedeniyle bu dosyaların da üzerine yazılmadığından emin
olunmaya çalışılmalıdır.</p>
<p><code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> tarzı borulu günlükleme kullanımı gibi
durumlarda yarış koşullarının oluşması olasılığına karşı uyanık
olunmalıdır. Aynı günlük kayıt dosyalarını aynı anda döndürmeye çalışan
birden fazla <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> kopyasının çalıştırılması
halinde bunların her biri diğerlerinin günlük kayıt dosyalarının kaybına
sebep olabilir.</p></div>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/stopping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/suexec.html.tr.utf8 0000664 0001751 0001751 00000076066 14743132254 020546 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>SuEXEC Desteği - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>SuEXEC Desteği</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/suexec.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/suexec.html" title="Türkçe"> tr </a></p>
</div>
<p><strong>SuEXEC</strong> özelliği, Apache HTTP Sunucusu kullanıcılarına
<strong>CGI</strong> ve <strong>SSI</strong> programlarını sunucunun
aidiyetinde çalıştığı kullanıcıdan farklı bir kullanıcının aidiyetinde
çalıştırma olanağı verir. Normalde, <strong>CGI</strong> ve
<strong>SSI</strong> programlarını çalıştıranla sunucuyu çalıştıran
aynı kullanıcıdır.</p>
<p>Gerektiği gibi kullanıldığında bu özellik, kullanıcılara
<strong>CGI</strong> ve <strong>SSI</strong> programlarını çalıştırma
ve geliştirmeye izin vermekle ortaya çıkan güvenlik risklerini azaltır.
Bununla birlikte, <strong>suEXEC</strong> gerektiği gibi
yapılandırılmadığı takdirde bazı sorunlara yol açabilir ve bilgisayar
güvenliğinizde yeni delikler ortaya çıkmasına sebep olabilir.
Güvenlikle ilgili mevcut sorunlarla başa çıkmada ve <em>setuid
root</em> programları yönetmekte bilgi ve deneyim sahibi değilseniz
<strong>suEXEC</strong> kullanmayı kesinlikle düşünmemenizi
öneririz.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#before">Başlamadan önce</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#model">SuEXEC Güvenlik Modeli</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">suEXEC’in Yapılandırılması ve Kurulumu</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#enable">suEXEC’in etkin kılınması ve iptal edilmesi</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#usage">SuEXEC’in kullanımı</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#debug">SuEXEC ve hata ayıklama</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#jabberwock">Uyarılar ve Örnekler</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="before" id="before">Başlamadan önce</a></h2>
<p>Belgeye balıklama dalmadan önce, suexec'i kullanacağınız ortam ve
kendiniz hakkında yapılmış çeşitli kabuller hakkında bilgi sahibi
olmalısınız.</p>
<p>Öncelikle, üzerinde <strong>setuid</strong> va <strong>setgid</strong>
işlemlerinin yapılabildiği Unix türevi bir işletim sistemi
kullandığınızı varsayıyoruz. Tüm komut örnekleri buna dayanarak
verilmiştir. Bu desteğe sahip başka platformlar varsa onlardaki
yapılandırma burada anlattığımız yapılandırmadan farklı olabilir.</p>
<p>İkinci olarak, bilgisayarınızın güvenliği ve yönetimi ile ilgili bazı
temel kavramları bildiğinizi kabul ediyoruz. Buna
<strong>setuid/setgid</strong> işlemlerinin sisteminiz ve güvenlik
seviyesi üzerindeki etkilerini bilmek dahildir.</p>
<p>Üçüncü olarak, <strong>suEXEC</strong> kodunun
<strong>değiştirilmemiş</strong> bir sürümünü kullandığınızı
varsayıyoruz. Tüm suEXEC kodu, geliştiricilerin yanında sayısız beta
kullanıcısı tarafından dikkatle incelenmiş ve denenmiştir. Kodların hem
basit hem de sağlam bir şekilde güvenli olması için gerekli tüm
önlemler alınmıştır. Bu kodun değiştirilmesi beklenmedik sorunlara ve
yeni güvenlik risklerine yol açabilir. Özellikle güvenlikle ilgili
programlarda deneyimli değilseniz suEXEC kodunda kesinlikle bir
değişiklik yapmamalısınız. Değişiklik yaparsanız kodlarınızı gözden
geçirmek ve tartışmak üzere Apache HTTP Sunucusu geliştirme ekibi ile
paylaşmanızı öneririz.</p>
<p>Dördüncü ve son olarak, Apache HTTP Sunucusu geliştirme ekibinin
suEXEC’i öntanımlı httpd kurulumunun bir parçası yapmama kararından
bahsetmek gerekir. Bunun sonucu olarak, suEXEC yapılandırması sistem
yöneticisinin ayrıntılı bir incelemesini gerektirir. Gerekli incelemeden
sonra yönetici tarafından suEXEC yapılandırma seçeneklerine karar
verilip, normal yollardan sisteme kurulumu yapılır. Bu seçeneklerin
belirlenmesi, suEXEC işlevselliğinin kullanımı sırasında sistem
güvenliğini gerektiği gibi sağlamak için yönetici tarafından dikkatle
saptanmayı gerektirir. Bu sürecin ayrıntılarının yöneticiye bırakılma
sebebi, suEXEC kurulumunu, suEXEC’i dikkatle kullanacak yeterliliğe sahip
olanlarla sınırlama beklentimizdir.</p>
<p>Hala bizimle misiniz? Evet mi? Pekala, o halde devam!</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="model" id="model">SuEXEC Güvenlik Modeli</a></h2>
<p>SuEXEC yapılandırması ve kurulumuna girişmeden önce biraz da
gerçekleşmesini istediğiniz güvenlik modelinin ayrıntıları üzerinde
duralım. Böylece, suEXEC’in içinde olup bitenleri ve sisteminizin
güvenliği için alınacak önlemleri daha iyi anlayabilirsiniz.</p>
<p><strong>suEXEC</strong> işlevselliği, Apache HTTP Sunucusu tarafından
gerektiği takdirde artalanda çalıştırılan bir setuid programa dayanır.
Bu program, bir CGI veya SSI betiğine bir HTTP isteği yapıldığı zaman,
bu betiği, yöneticinin ana sunucunun aidiyetinde çalıştığı kullanıcıdan
farklı olarak seçtiği bir kullanıcının aidiyetinde çalıştırmak için
çağrılır. Böyle bir istek geldiğinde, Apache httpd artalandaki setuid
programına, HTTP isteği yapılan programın ismiyle beraber aidiyetinde
çalışacağı kullanıcı ve grup kimliklerini de aktarır.</p>
<p>Artalanda çalıştırılan setuid program başarıyı ve başarısızlığı
aşağıdaki süreci izleyerek saptar. Bunlardan herhangi biri başarısız
olursa program başarısızlık durumunu günlüğe kaydeder ve bir hata
vererek çıkar. Aksi takdirde çalışmaya devam eder.</p>
<ol>
<li>
<strong>Setuid programı çalıştıran kullanıcı sistemin geçerli
kullanıcılarından biri mi?</strong>
<p class="indent">Bu, setuid programı çalıştıran kullanıcının
sistemin gerçek bir kullanıcısı olduğunudan emin olunmasını sağlar.
</p>
</li>
<li>
<strong>Setuid program yeterli sayıda argümanla çağrılmış mı?
</strong>
<p class="indent">Apache HTTP Sunucusunun artalanda çağırdığı
setuid program ancak yeterli sayıda argüman sağlandığı takdirde
çalışacaktır. Argümanların sayısını ve sırasını Apache HTTP sunucusu
bilir. Eğer setuid program yeterli sayıda argümanla çağrılmamışsa
ya kendisinde bir değişiklik yapılmıştır ya da kurulu Apache httpd
çalıştırılabilirinin suEXEC ile ilgili kısmında yanlış giden bir
şeyler vardır.</p>
</li>
<li>
<strong>Bu geçerli kullanıcının bu setuid programı çalıştırma
yetkisi var mı?</strong>
<p class="indent">Sadece tek bir kullanıcı (Apache’nin aidiyetinde
çalıştığı kullanıcı) bu programı çalıştırmaya yetkilidir.</p>
</li>
<li>
<strong>Hedef CGI veya SSI programı hiyerarşik olarak güvenliği
bozacak bir dosya yolu üzerinde mi?</strong>
<p class="indent">Hedef CGI veya SSI programının dosya yolu '/' veya
'..' ile başlıyor mu? Buna izin verilmez. Hedef CGI veya SSI
programı suEXEC’in belge kök dizininde yer almalıdır (aşağıda
<code>--with-suexec-docroot=<em>DİZİN</em></code> seçeneğine
bakınız).</p>
</li>
<li>
<strong>Hedef kullanıcı ismi geçerli mi?</strong>
<p class="indent">Hedef kullanıcı mevcut mu?</p>
</li>
<li>
<strong>Hedef grup ismi geçerli mi?</strong>
<p class="indent">Hedef grup mevcut mu?</p>
</li>
<li>
<strong>Hedef kullanıcı <code>root</code> değil, değil mi?</strong>
<p class="indent">Mevcut durumda, <code>root</code> kullanıcısının
CGI/SSI programlarını çalıştırmasına izin verilmemektedir.</p>
</li>
<li>
<strong>Hedef kullanıcı kimliği asgari kullanıcı numarasından
<em>BÜYÜK</em> mü?</strong>
<p class="indent">Asgari kullanıcı numarası yapılandırma sırasında
belirtilir. Böylece CGI/SSI programlarını çalıştırmasına izin
verilecek olası en düşük kullanıcı numarasını belirlemeniz mümkün
kılınmıştır. Bu bazı “sistem” hesaplarını devreden çıkarmak için
yararlıdır.</p>
</li>
<li>
<strong>Hedef grup <code>root</code> değil, değil mi?</strong>
<p class="indent"><code>root</code> grubunun CGI/SSI
programlarını çalıştırmasına izin verilmemektedir.</p>
</li>
<li>
<strong>Hedef grup numarası asgari grup numarasından
<em>BÜYÜK</em> mü?</strong>
<p class="indent">Asgari grup numarası yapılandırma sırasında
belirtilir. Böylece CGI/SSI programlarını çalıştırmasına izin
verilecek olası en düşük grup numarasını belirlemeniz mümkün
kılınmıştır. Bu bazı “sistem” hesaplarını devreden çıkarmak için
yararlıdır.</p>
</li>
<li>
<strong>Apache’nin artalanda çağırdığı setuid program hedef
kullanıcı ve grubun aidiyetine geçebildi mi?</strong>
<p class="indent">Bu noktadan itibaren program setuid ve setgid
çağrıları üzerinden hedef kullanıcı ve grubun aidiyetine geçer.
Erişim grubu listesi de ayrıca kullanıcının üyesi olduğu tüm
gruplara genişletilir.</p>
</li>
<li>
<strong>Hedef CGI/SSI programının bulunduğu dizine geçebildik mi?
</strong>
<p class="indent">Dizin mevcut değilse dosyaları da içeremez. Hedef
dizine geçemiyorsak bu, dizin mevcut olmadığından olabilir.</p>
</li>
<li>
<strong>Hedef dizin Apache için izin verilen yerlerden biri mi?
</strong>
<p class="indent">İstek sunucunun normal bir bölümü için yapılmış
olsa da istenen dizin acaba suEXEC’in belge kök dizini altında mı?
Yani, istenen dizin, suEXEC’in aidiyetinde çalıştığı kullanıcının
ev dizini altında bulunan, <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> ile belirtilen dizinin altında mı? (<a href="#install">suEXEC’in yapılandırma seçeneklerine</a>
bakınız).</p>
</li>
<li>
<strong>Hedef dizin başkaları tarafından yazılabilen bir dizin değil,
değil mi?</strong>
<p class="indent">Başkaları da yazabilsin diye bir dizin açmıyoruz;
dizin içeriğini sadece sahibi değiştirebilmelidir.</p>
</li>
<li>
<strong>Hedef CGI/SSI programı mevcut mu?</strong>
<p class="indent">Mevcut değilse çalıştırılamaz.</p>
</li>
<li>
<strong>Hedef CGI/SSI program dosyasına başkaları tarafından
yazılamıyor, değil mi?</strong>
<p class="indent">Hedef CGI/SSI programının dosyasına sahibinden
başka kimsenin bir şeyler yazmasını istemeyiz.</p>
</li>
<li>
<strong>Hedef CGI/SSI program setuid veya setgid <em>değil</em>,
değil mi?</strong>
<p class="indent">UID/GID‘i tekrar değiştirecek programlar
çalıştırmayı istemeyiz.</p>
</li>
<li>
<strong>Hedef kullanıcı/grup, programın kullanıcı/grubu ile aynı mı?
</strong>
<p class="indent">Hedef kullanıcı dosyanın sahibi mi?</p>
</li>
<li>
<strong>İşlemlerin güvenle yapılabilmesi için süreç ortamını
başarıyla temizleyebildik mi?</strong>
<p class="indent">suEXEC, sürecin çalışacağı ortama güvenli bir
program çalıştırma yolu sağlamaktan başka, yapılandırma sırasında
oluşturulan güvenli ortam değişkenleri listesinde isimleri bulunan
ortam değişkenlerinden başkasını aktarmayacaktır.</p>
</li>
<li>
<strong>Hedef CGI/SSI programı haline gelip çalışabildik mi?</strong>
<p class="indent">Burası suEXEC’in bitip CGI/SSI programının
başladığı yerdir.</p>
</li>
</ol>
<p>Bu süreç suEXEC güvenlik modelinin standart işlemlerini oluşturur.
Biraz zorlayıcı ve CGI/SSI tasarımına yeni kurallar ve sınırlamalar
getiriyor olsa da düşünülen güvenliği adım adım sağlayacak şekilde
tasarlanmıştır.</p>
<p>Düzgün bir suEXEC yapılandırmasının hangi güvenlik risklerinden
kurtulmayı sağladığı ve bu güvenlik modelinin sunucu yapılandırmasıyla
ilgili sorumluluklarınızı nasıl sınırlayabildiği hakkında daha
ayrıntılı bilgi edinmek için bu belgenin <a href="#jabberwock">"Uyarılar ve Örnekler"</a> bölümüne bakınız.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">suEXEC’in Yapılandırılması ve Kurulumu</a></h2>
<p>Eğlence başlıyor.</p>
<p><strong>suEXEC yapılandırma seçenekleri</strong><br />
</p>
<dl>
<dt><code>--enable-suexec</code></dt>
<dd>Bu seçenek, hiçbir zaman öntanımlı olarak kurulmayan ve
etkinleştirilmeyen suEXEC özelliğini etkin kılar. suEXEC özelliğini
kullanma isteğinizi Apache’nin kabul edebilmesi için
<code>--enable-suexec</code> seçeneğinin yanında en azından bir tane
de <code>--with-suexec-xxxxx</code> seçeneği belirtilmiş
olmalıdır.</dd>
<dt><code>--with-suexec-bin=<em>YOL</em></code></dt>
<dd>Güvenlik sebebiyle <code>suexec</code> çalıştırılabilirinin
bulunduğu yer sunucu koduna yazılır. Bu seçenekle öntanımlı yol
değiştirilmiş olur. Örnek:<br />
<code>--with-suexec-bin=/usr/sbin/suexec</code></dd>
<dt><code>--with-suexec-caller=<em>KULLANICI</em></code></dt>
<dd>Normalde httpd’nin aidiyetinde çalıştığı <a href="mod/mpm_common.html#user">kullanıcı</a>dır. Bu, suEXEC
çalıştırıcısını çalıştırmasına izin verilen tek kullanıcıdır.</dd>
<dt><code>--with-suexec-userdir=<em>DİZİN</em></code></dt>
<dd><p>Kullanıcıların ev dizinleri altında suEXEC’in erişmesine izin
verilen alt dizinin yerini tanımlar. Bu dizin altında suEXEC
kullanıcısı tarafından çalıştırılacak tüm programlar "güvenilir"
olmalıdır. Eğer “basit” bir <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> yönergesi kullanıyorsanız ( içinde “*”
bulunmayan), bunun aynı dizin olması gerekir. Eğer burada belirtilen
dizin, <code>passwd</code> dosyasında kullanıcı için belirtilmiş
dizinin altında <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code>
yönergesinde belirtilen dizin olmadığı takdirde suEXEC işini
gerektiği gibi yapmayacaktır. Öntanımlı değer
<code>public_html</code>’dir.</p>
<p>Eğer, sanal konaklarınızın herbiri farklı <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> yönergeleri içeriyorsa
burada belirtilecek dizinin üst dizininin hepsinde aynı olması
gerekir. <strong>Aksi takdirde, "~<em><code>kullanıcı</code></em>"
istekleri düzgün çalışmayacaktır.</strong></p></dd>
<dt><code>--with-suexec-docroot=<em>DİZİN</em></code></dt>
<dd>httpd için belge kök dizinini belirler. Bu, (<code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code>’lardan başka) suEXEC için
kullanılacak tek hiyerarşi olacaktır. Öntanımlı dizin sonuna
"<code>/htdocs</code>" eklenmiş <code>--datadir</code> dizinidir.
Yani, seçeneği "<code>--datadir=/home/apache</code>" olarak
belirtmişseniz suEXEC çalıştırıcısı için belge kök dizini
"<code>/home/apache/htdocs</code>" olur.</dd>
<dt><code>--with-suexec-uidmin=<em>UID</em></code></dt>
<dd>suEXEC kullanıcısının kullanıcı kimliği olarak izin verilen en
düşük değeri belirler. Çoğu sistemde bu ya 500’dür ya da 100; 100
öntanımlıdır.</dd>
<dt><code>--with-suexec-gidmin=<em>GID</em></code></dt>
<dd>suEXEC kullanıcısının grup kimliği olarak izin verilen en düşük
değeri belirler. Çoğu sistemde bu 100 olup, seçeneğin de öntanımlı
değeridir.</dd>
<dt><code>--with-suexec-logfile=<em>DOSYA</em></code></dt>
<dd>suEXEC hareketlerinin ve hatalarının kaydedileceği günlük
dosyasının adını belirler (denetim ve hata ayıklama için
kullanışlıdır). Öntanımlı günlük dosyası ismi
"<code>suexec_log</code>" olup yeri (<code>--logfiledir</code>
seçeneği ile belirtilen) günlük dosyaları dizinidir.</dd>
<dt><code>--with-suexec-safepath=<em>YOL</em></code></dt>
<dd>CGI çalıştırılabilirlerine aktarılacak güvenilir <code>PATH</code>
ortam değişkeninin değerini tanımlar.
"<code>/usr/local/bin:/usr/bin:/bin</code>" öntanımlıdır.</dd>
</dl>
<h3>SuEXEC çalıştırıcısının derlenmesi ve kurulumu</h3>
<p>SuEXEC özelliğini <code>--enable-suexec</code> seçeneği ile
etkinleştirdiyseniz <code>make</code> komutunu verdiğinizde httpd
ile birlikte <code>suexec</code> çalıştırılabilir dosyası da
derlenecektir.</p>
<p>Tüm bileşenler derlendikten sonra <code>make install</code> komutunu
vererek kurulumu tamamlayabilirsiniz. <code>suexec</code>
çalıştırılabilir dosyası <code>--sbindir</code> seçeneği ile
tanımlanan dizine kurulacaktır; öntanımlı yeri
<code>/usr/local/apache2/bin/</code> dizinidir.</p>
<p>Kurulum adımında <strong><em>root yetkisine</em></strong> sahip
olmanız gerektiğini unutmayın. Çalıştırıcıya kullanıcı kimliğinin
atanabilmesi ve dosyanın sahibi olan kullanıcı kimliği ile
çalıştırılabilmesini mümkün kılan bitinin etkin kılınabilmesi için
kurulumun <code><em>root</em></code> tarafından yapılması
önemlidir.</p>
<h3>Paranoyak yetkilendirme</h3>
<p>SuEXEC çalıştırıcısı kendini çalıştıran kullanıcının
<code class="program"><a href="./programs/configure.html">configure</a></code> betiğine
<code>--with-suexec-caller</code> seçeneği ile belirtilen kullanıcı
olup olmadığına bakacaksa da, bu sınamanın da bir sistem veya
kütüphane çağrısı ile istismar edilmiş olma ihtimali gözardı
edilmemelidir. Bunun meydana gelmesini önlemek için ve genelde
yapıldığı gibi dosyanın izinlerini suEXEC çalıştırıcısı sadece
httpd'nin aidiyetinde çalıştığı grup tarafından çalıştırılacak
şekilde ayarlayınız.</p>
<p>Örneğin, sunucunuz şöyle yapılandırılmışsa:</p>
<pre class="prettyprint lang-config">User www
Group webgroup</pre>
<p>Ve <code class="program"><a href="./programs/suexec.html">suexec</a></code> çalıştırılabilir de
<code>/usr/local/apache2/bin/</code> dizinine kurulmuşsa şu komutları
vermelisiniz:</p>
<div class="example"><p><code>
chgrp apache-grup /usr/local/apache2/bin/suexec<br />
chmod 4750 /usr/local/apache2/bin/suexec<br />
</code></p></div>
<p>Böylece suEXEC çalıştırıcısını httpd’yi çalıştıran grubun
üyelerinden başkasının çalıştıramayacağından emin olabilirsiniz.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="enable" id="enable">suEXEC’in etkin kılınması ve iptal edilmesi</a></h2>
<p>httpd başlatıldığı sırada <code class="program"><a href="./programs/suexec.html">suexec</a></code> çalıştırıcısı için
<code>--sbindir</code> seçeneği ile tanımlanan dizine bakar (seçeneğin
öntanımlı değeri <code>/usr/local/apache/sbin/suexec</code>’tir). httpd
düzgün yapılandırılmış bir suEXEC çalıştırıcısı bulduğu takdirde hata
günlüğüne şöyle bir ileti yazacaktır:</p>
<div class="example"><p><code>
[notice] suEXEC mechanism enabled (wrapper: <var>/dosya/yolu/suexec</var>)
</code></p></div>
<p>Sunucu başlatıldığında bu ileti yazılmazsa sunucu ya çalıştırıcı
programı umduğu yerde bulamamıştır ya da dosyanın <em>setuid</em> biti
<em>root</em> tarafından etkin kılınmamıştır.</p>
<p>SuEXEC mekanizmasını etkin kılmak istediğiniz sunucu çalışmaktaysa
sunucuyu önce öldürmeli sonra yeniden başlatmalısınız. Basit bir
<code>HUP</code> veya <code>USR1</code> sinyali ile yeniden başlamasını
sağlamak yeterli olmayacaktır.</p>
<p>SuEXEC mekanizmasını iptal etmek için ise <code class="program"><a href="./programs/suexec.html">suexec</a></code>
dosyasını sildikten sonra httpd'yi öldürüp yeniden başlamalısınız.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="usage" id="usage">SuEXEC’in kullanımı</a></h2>
<p>CGI programlarına yapılan isteklerin suEXEC çalıştırıcısı tarafından
yerine getirilebilmesi için sanal konağın bir <code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> yönergesi içermesi veya
isteğin <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code> tarafından işleme konulması
gerekir.</p>
<p><strong>Sanal Konaklar:</strong><br />SuEXEC çalıştırıcısını farklı
bir kullanıcı ile etkin kılmanın tek yolu <code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> bölümleri içinde <code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> yönergesini
kullanmaktır. Bu yönergede ana sunucuyu çalıştıran kullanıcıdan farklı
bir kullanıcı belirterek ilgili sanal konak üzerinden CGI kaynakları
için yapılan tüm isteklerin belirtilen <em>kullanıcı</em> ve
<em>grup</em> tarafından çalıştırılması sağlanır. Bu yönergeyi
içermeyen sanal konaklar için ana sunucunun kullanıcısı
öntanımlıdır.</p>
<p><strong>Kullanıcı dizinleri:</strong><br />
<code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code> tarafından işleme sokulan tüm istekler için
suEXEC çalıştırıcısı istek yapılan kullanıcı dizininin sahibinin
aidiyetinde çalıştırılacaktır. Bu özelliğin çalışması için tek
gereklilik, kullanıcının SuEXEC çalıştırıcısı için etkin kılınmış olması
ve çalıştırıcının yukarıdaki <a href="#model">güvenlik sınamalarından</a>
geçebilmesidir. Ayrıca, <code>--with-suexec-userdir</code> <a href="#install">derleme</a> seçeneğinin açıklamasına da bakınız.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="debug" id="debug">SuEXEC ve hata ayıklama</a></h2>
<p>SuEXEC çalıştırıcısı yukarıda değinildiği gibi günlük bilgilerini
<code>--with-suexec-logfile</code> seçeneği ile belirtilen dosyaya
yazacaktır. Çalıştırıcıyı doğru yapılandırarak kurduğunuzdan emin olmak
istiyorsanız, yolunda gitmeyen şeyler var mı diye bu günlük dosyasına
bakmayı ihmal etmeyin.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="jabberwock" id="jabberwock">Uyarılar ve Örnekler</a></h2>
<p><strong>UYARI!</strong> Bu bölüm henüz bitmedi.</p>
<p>SuEXEC çalıştırıcısından dolayı sunucu ayarlarına bazı sınırlamalar
getiren bir kaç önemli nokta mevcuttur. SuEXEC ile ilgili hata
bildiriminde bulunmadan önce bunlara bir göz atmalısınız.</p>
<p><strong>suEXEC ile ilgili önemli noktalar</strong></p>
<ul>
<li>Hiyerarşik sınırlamalar
<p class="indent">Güvenlik ve verimlilik adına, tüm suEXEC
isteklerinin sanal konaklar için üst düzey belge kökünün altındaki
dosyalarla, kullanıcı dizinleri için ise üst düzey bireysel belge
köklerinin altındaki dosyalarla sınırlı kalması gerekir. Örneğin,
dört sanal konağınız varsa ve suEXEC çalıştırıcısının
getirilerinden faydalanmak istiyorsanız, sanal konaklarınızın belge
kök dizinlerini ana sunucunun belge kök dizininin altında kalacak
şekilde yapılandırmanız gerekir (örnek yolda).</p>
</li>
<li>SuEXEC'in <code>PATH</code> ortam değişkeni
<p class="indent">Bunu değiştirmek tehlikeli olabilir. Bu değişkende
tanımladığınız her yolun <strong>güvenli</strong> bir dizini işaret
ettiğinden emin olmalısınız. Başkalarının oralarda bir truva atı
çalıştırmasını istemiyorsanız buna çok dikkat ediniz.</p>
</li>
<li>SuEXEC kodunda değişiklik
<p class="indent">Gerçekte ne yaptığınızı bilmiyorsanız bu,
<strong>büyük bir sorun</strong> olabilir. Böyle şeyler yapmaktan
mümkün olduğunca uzak durmalısınız.</p>
</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/suexec.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/suexec.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/suexec.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/bind.html.fr.utf8 0000664 0001751 0001751 00000041005 14740503670 020132 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Ecoute sélective - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Ecoute sélective</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/bind.html" title="Français"> fr </a> |
<a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/bind.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Configuration du serveur HTTP Apache pour l'écoute
sur un port et une adresse IP spécifiques.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Vue d'ensemble</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#reload">Changer la configuration de l'écoute au redémarrage</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ipv6">Remarques spécifiques à IPv6</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#protocol">Spécification du protocole avec Listen</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Qu'en est-il avec les serveurs virtuels</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="vhosts/">Serveurs virtuels</a></li><li><a href="dns-caveats.html">Problèmes liés au DNS</a></li><li><a href="#comments_section">Commentaires</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="overview" id="overview">Vue d'ensemble</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mpm_common.html">mpm_common</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table>
<p>Au démarrage de httpd, un port et une adresse lui sont associés sur
l'hôte local et le serveur se met en attente de l'arrivée d'une requête.
Par défaut, le serveur écoute toutes les adresses de l'hôte local.
Cependant, on peut lui préciser des ports et des adresses spécifiques à
écouter, ou une combinaison des deux. Tout ceci est souvent associé avec la
fonctionnalité des <a href="vhosts/">serveurs virtuels</a> qui détermine la
manière dont <code>httpd</code> répond aux différents ports, noms d'hôtes et
adresses IP.</p>
<p>La directive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> permet
d'indiquer au serveur qu'il ne doit accepter des requêtes que sur le(s)
port(s) spécifiés ou une combinaison adresse/port. Si seul un numéro de port
est spécifié dans la directive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>, le serveur se met à l'écoute sur ce
port et sur toutes les interfaces réseau. Si une adresse IP est spécifiée
en plus du port, le serveur va écouter sur ce port et uniquement sur
l'interface réseau correspondante. On peut utiliser plusieurs directives
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> pour spécifier plusieurs
adresses et ports à écouter. Le serveur répondra alors aux requêtes sur tous
les ports et adresses spécifiés.</p>
<p>Par exemple, pour faire en sorte que le serveur accepte des connexions
sur les ports 80 et 8000 et sur toutes les interfaces, utilisez :</p>
<div class="example"><pre class="prettyprint lang-config">Listen 80
Listen 8000</pre>
</div>
<p>Pour faire en sorte que le serveur accepte des connexions sur le port 80
pour une interface, et sur le port 8000 pour une
autre interface, utilisez :</p>
<div class="example"><pre class="prettyprint lang-config">Listen 192.0.2.1:80
Listen 192.0.2.5:8000</pre>
</div>
<p>Les adresses IPv6 doivent être mises entre crochets, comme dans
l'exemple suivant :</p>
<div class="example"><pre class="prettyprint lang-config">Listen [2001:db8::a00:20ff:fea7:ccea]:80</pre>
</div>
<div class="warning"><p>Des directives <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
imbriquées provoqueront une erreur fatale qui
empêchera le serveur de démarrer.</p>
<div class="example"><p><code>
(48)Address already in use: make_sock: could not bind to address [::]:80
</code></p></div>
<p>Voir <a href="http://wiki.apache.org/httpd/CouldNotBindToAddress">cette
discussion dans le wiki</a> pour plus de détails à propos de la résolution
de ce problème.</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="reload" id="reload">Changer la configuration de l'écoute au redémarrage</a></h2>
<p>Lorsque httpd est redémarré, certaines remarques sont à prendre en compte
quant aux modifications apportées aux directives <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>. Au cours du redémarrage, httpd
conserve la liaison avec les ports de la configuration précédente afin
d'éviter l'obtention d'un message d'erreur "Connection refused" lors d'une
tentative ultérieure de connexion au serveur. Si les modifications apportées au jeu de
directives <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> utilisé entrent
en conflit avec ce dernier, le serveur refusera de redémarrer.</p>
<p>Par exemple, modifier la configuration suivante :</p>
<div class="example"><pre class="prettyprint lang-config">Listen 127.0.0.1:80</pre>
</div>
<p>pour utiliser la suivante pourra échouer car écouter le port 80 sur
toutes les adresses IP entre en conflit avec une écoute sélective du port 80
sur la seule adresse IP 127.0.0.1.</p>
<div class="example"><pre class="prettyprint lang-config">Listen 80</pre>
</div>
<p>Pour qu'une telle modification de configuration soit prise en compte avec
succès, il est nécessaire d'arrêter, puis de démarrer le serveur.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="ipv6" id="ipv6">Remarques spécifiques à IPv6</a></h2>
<p>Un nombre croissant de plateformes implémentent IPv6, et
<a class="glossarylink" href="./glossary.html#apr" title="voir glossaire">APR</a> supporte IPv6 sur la plupart d'entre elles,
ce qui permet à httpd d'allouer des points de connexion (sockets) IPv6
et de traiter des requêtes envoyées sur IPv6.</p>
<p>Les administrateurs de httpd doivent se préoccuper de la possibilité
pour un point de connexion IPv6 de traiter à la fois des connexions IPv4
et des connexions IPv6.
Le traitement de connexions IPv4 avec un point de connexion IPv6 utilise
des adresses IPv6 traduites en IPv4 qui sont autorisées par défaut sur la
plupart des plateformes, mais sont interdites par défaut sous FreeBSD, NetBSD,
et OpenBSD, afin de respecter la politique de sécurité du système sur ces plateformes.
Sur les systèmes où ces adresses sont interdites par défaut, un
paramètre spécial du script <code class="program"><a href="./programs/configure.html">configure</a></code> permet de modifier
ce comportement pour httpd.</p>
<p>En revanche, sur certaines plateformes comme Linux et Tru64, la
<strong>seule</strong> manière de gérer à la fois IPv6 et IPv4 passe
par l'utilisation d'adresses traduites. Si vous voulez que <code>httpd</code> gère
des connexions IPv4 et IPv6 avec un minimum de points de connexion,
ce qui nécessite l'utilisation d'adresses IPv6 traduites en IPv4,
utilisez l'option <code>--enable-v4-mapped</code> du script <code class="program"><a href="./programs/configure.html">configure</a></code>.</p>
<p>L'option <code>--enable-v4-mapped</code> est utilisée par défaut sur
toutes les plateformes sauf FreeBSD, NetBSD, et OpenBSD ;
votre httpd a donc probablement été construit avec cette option.</p>
<p>Si vous souhaitez que httpd ne gère que des connexions IPv4, sans se
soucier de ce que votre plateforme et APR supportent, spécifiez une adresse
IPv4 dans toutes les directives
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>, comme dans l'exemple
suivant :</p>
<div class="example"><pre class="prettyprint lang-config">Listen 0.0.0.0:80
Listen 192.0.2.1:80</pre>
</div>
<p>Si votre plateforme le supporte et si vous souhaitez que httpd gère
des connexions IPv4 et IPv6 sur des points de connexion séparés
(c'est à dire désactiver la traduction des adresses IPv6 au format IPv4),
utilisez l'option <code>--disable-v4-mapped</code> du script
<code class="program"><a href="./programs/configure.html">configure</a></code>. <code>--disable-v4-mapped</code> est
utilisée par défaut sur FreeBSD, NetBSD, et OpenBSD.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="protocol" id="protocol">Spécification du protocole avec Listen</a></h2>
<p>Dans la plupart des configurations, le second paramètre optionnel
<var>protocol</var> de la directive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> n'est pas obligatoire. S'il
n'est pas spécifié, les protocoles par défaut
sont <code>https</code> pour le port 443, et <code>http</code> pour
tous les autres ports. Le protocole sert à déterminer quel module
doit traiter une requête, et à appliquer les optimisations
spécifiques au protocole à l'aide de la directive <code class="directive"><a href="./mod/core.html#acceptfilter">AcceptFilter</a></code>.</p>
<p>Vous ne devez définir le protocole que si vous travaillez avec
des ports non standards. Par exemple, pour travailler en
<code>https</code> sur le port 8443 :</p>
<div class="example"><pre class="prettyprint lang-config">Listen 192.170.2.1:8443 https</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">Qu'en est-il avec les serveurs virtuels</a></h2>
<p> La directive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> n'implémente pas les serveurs virtuels.
Elle indique simplement au serveur principal sur quels adresses et ports
il doit écouter. Si aucune directive
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
n'est présente, le serveur se comportera de la même façon pour toutes
les requêtes acceptées. En revanche, la directive
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
peut être utilisée pour provoquer une réaction différente du serveur
pour un ou plusieurs adresses ou ports. Pour implémenter un serveur virtuel,
on doit d'abord indiquer au serveur sur quels adresses et ports il doit écouter.
Ensuite, une section
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
doit être créée pour le couple adresse+port spécifié afin de définir le
comportement de cet hôte virtuel. Notez que si la directive
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
est définie pour une adresse et un port sur lesquels le serveur n'est pas censé
écouter, cet hôte virtuel ne sera pas accessible.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/bind.html" title="Français"> fr </a> |
<a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/bind.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/bind.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/custom-error.html.fr.utf8 0000664 0001751 0001751 00000035016 14740503670 021664 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Messages d'erreur personnalisés - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Messages d'erreur personnalisés</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Le serveur HTTP Apache fournit des messages d'erreur génériques
pour les codes de statut 4xx ou 5xx ; ces messages sont cependant
relativement austères, imprécis, et peuvent s'avérer intimidants
pour les visiteurs du site. Si vous le souhaitez, vous pouvez
afficher des messages d'erreur plus conviviaux, dans un langage
autre que l'anglais, ou même sous une forme plus en adéquation avec
le style de votre site.</p>
<p>Il est possible de définir des messages d'erreur personnalisés
pour chaque code de statut HTTP associé à une condition d'erreur -
c'est à dire tout code de statut 4xx ou 5xx.</p>
<p>De plus, il est possible de
personnaliser le message d'erreur en fonction d'un jeu de valeurs
fourni, en utilisant les <a href="howto/ssi.html">Inclusions Côté
Serveur (SSI)</a>. Un programme CGI ou un autre gestionnaire
dynamique (PHP, mod_perl, etc...) peut aussi utiliser ces variables
pour gérer les conditions d'erreur.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuration</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#variables">Variables disponibles</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#custom">Personnalisation des messages d'erreur</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#multi-lang">Messages d'erreur personnalisés
multilingues</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="configuration" id="configuration">Configuration</a></h2>
<p>Les messages d'erreur personnalisés sont configurés via la
directive <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>, qui
peut être utilisée dans un contexte global, serveur virtuel ou
répertoire. On peut utiliser cette directive dans les fichiers
.htaccess si <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> est
définie à FileInfo.</p>
<pre class="prettyprint lang-config">ErrorDocument 500 "Désolé, notre script s'est
crashé ; comme c'est dommage !"
ErrorDocument 500 /cgi-bin/crash-recover
ErrorDocument 500 http://error.example.com/server_error.html
ErrorDocument 404 /errors/not_found.html
ErrorDocument 401 /subscription/how_to_subscribe.html</pre>
<p>La syntaxe de la directive <code>ErrorDocument</code> est :</p>
<pre class="prettyprint lang-config">ErrorDocument <code_3_chiffres> <action></pre>
<p>où action peut être traitée comme :</p>
<ol>
<li>Une URL de redirection local (si l'action commence par un "/").</li>
<li>Une URL de redirection externe (si action est une URL valide).</li>
<li>Le texte à afficher (si l'action ne répond à aucune des
deux conditions précédentes). Entourez le texte de guillemets (")
s'il contient plusieurs mots.</li>
</ol>
<p>Dans le cas d'une redirection vers une URL locale, des variables
d'environnement supplémentaires sont définies de façon à ce que la
réponse puisse être personnalisée par la suite. Elles ne sont pas
envoyées aux URLs externes.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="variables" id="variables">Variables disponibles</a></h2>
<p>La redirection vers une autre URL peut être utile, mais
seulement s'il est possible de transmettre certaines informations
qui pourront être utilisées pour expliquer ou journaliser
la condition d'erreur ou le problème plus clairement.</p>
<p>Pour y parvenir, lorsque la redirection d'erreur est envoyée,
des variables d'environnement supplémentaires sont définies à
partir des en-têtes de la requête originale en préfixant le nom
d'origine de l'en-tête par 'REDIRECT_', ce qui permet de fournir au
message d'erreur le contexte de la requête originelle.</p>
<p>Par exemple, en plus des variables d'environnement habituelles,
vous pouvez recevoir ce qui suit :</p>
<div class="example"><p><code>
REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/jpeg, image/png<br />
REDIRECT_HTTP_USER_AGENT=Mozilla/5.0 Fedora/3.5.8-1.fc12 Firefox/3.5.8<br />
REDIRECT_PATH=.:/bin:/usr/local/bin:/sbin<br />
REDIRECT_QUERY_STRING=<br />
REDIRECT_REMOTE_ADDR=121.345.78.123<br />
REDIRECT_REMOTE_HOST=client.example.com<br />
REDIRECT_SERVER_NAME=www.example.edu<br />
REDIRECT_SERVER_PORT=80<br />
REDIRECT_SERVER_SOFTWARE=Apache/2.2.15<br />
REDIRECT_URL=/cgi-bin/buggy.pl
</code></p></div>
<p>Les variables d'environnement <code>REDIRECT_</code> sont
créées à partir des variables d'environnement préexistantes à la
redirection qui sont préfixées par la chaîne <code>REDIRECT_</code> ;
par exemple, <code>HTTP_USER_AGENT</code> devient
<code>REDIRECT_HTTP_USER_AGENT</code>.</p>
<p><code>REDIRECT_URL</code>, <code>REDIRECT_STATUS</code>, et
<code>REDIRECT_QUERY_STRING</code> sont systématiquement définies,
les autres variables n'étant définies que si l'en-tête
correspondant existait avant la condition d'erreur.</p>
<p><strong>Aucune</strong> d'entre elles ne sera définie si votre
directive <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
spécifie une redirection <em>externe</em> (toute URL commençant
par un protocole du style <code>http:</code>, même si elle fait
référence au même hôte que le serveur).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="custom" id="custom">Personnalisation des messages d'erreur</a></h2>
<p>Si vous faites pointer votre directive
<code>ErrorDocument</code> vers certains gestionnaires
dynamiques comme les inclusions côté serveur, les scripts CGI ou
d'autres gestionnaires, vous pouvez utiliser les variables
d'environnement supplémentaires disponibles pour personnaliser
le message.</p>
<p>Si la directive ErrorDname-basedocument spécifie une redirection locale
vers un script CGI, ce dernier doit ajouter un en-tête
"<code>Status:</code>" dans sa sortie afin de s'assurer du bon
acheminement jusqu'au client de la condition d'erreur qui a
provoqué cette redirection. Par exemple, un script Perl spécifié
par une directive ErrorDocument pourrait contenir ce qui suit
:</p>
<pre class="prettyprint lang-perl">...
print "Content-type: text/html\n";
printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"};
...</pre>
<p>Si un script est dédié à la gestion d'une condition d'erreur
spécifique, telle que <code>404 Not Found</code>, il
peut utiliser le code et le texte de l'erreur spécifiques à la
place.</p>
<p>Notez que si la réponse contient un en-tête
<code>Location:</code> (afin d'initier une redirection côté
client), le script <em>doit</em> émettre un en-tête approprié
(comme <code>302 Found</code>). Dans le cas contraire,
l'en-tête <code>Location:</code> ne produira aucun effet.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="multi-lang" id="multi-lang">Messages d'erreur personnalisés
multilingues</a></h2>
<p>Vous trouverez dans la distribution du serveur HTTP Apache un
répertoire contenant des messages d'erreur personnalisés traduits en
16 langues différentes. Pour activer cette fonctionnalité, vous
pouvez aussi inclure un fichier de configuration qui se trouve dans
le répertoire de configuration <code>conf/extra</code>.</p>
<p>Dans le fichier de configuration de votre serveur, vous trouverez
un groupe de lignes du style :</p>
<pre class="prettyprint lang-config"> # Multi-language error messages
#Include conf/extra/httpd-multilang-errordoc.conf</pre>
<p>Décommentez la ligne <code>Include</code> pour activer cette
fonctionnalité, et présenter des messages d'erreur dont le langage
sera négocié en fonction du langage préféré défini au niveau du
navigateur du client.</p>
<p>De plus, ces documents contiennent diverses variables
<code>REDIRECT_</code>, de façon à ce que l'utilisateur final
dispose d'informations supplémentaires à propos de ce qui a pu se
produire, et de ce qu'il est susceptible de faire maintenant.</p>
<p>Ces documents peuvent être personnalisés en fournissant autant
d'informations utiles que vous le souhaitez aux utilisateurs à
propos de votre site, et de ce qu'ils sont susceptibles d'y trouver.</p>
<p>Pour pouvoir utiliser cette fonctionnalité, vous devez activer
<code class="module"><a href="./mod/mod_include.html">mod_include</a></code> et <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/custom-error.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/suexec.html.ko.euc-kr 0000664 0001751 0001751 00000060131 14743132254 021014 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>suEXEC - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>suEXEC </h1>
<div class="toplang">
<p><span> : </span><a href="./en/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/suexec.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/suexec.html" title="Korean"> ko </a> |
<a href="./tr/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p><strong>suEXEC</strong> ġ <strong>CGI</strong>
<strong>SSI</strong> α ID
ƴ ٸ ID ϵ Ѵ. CGI SSI α
ϸ ڿ ڷ Ѵ.</p>
<p> ϸ ڰ CGI SSI α
ϰ Ҷ ִ
ִ. suEXEC ϰ Ǹ
ǻͿ ο ִ. <em>setuid root</em>
α ̷ α ϴٸ suEXEC
ʱ ٶ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#before">ϱ </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#model">suEXEC ȸ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">suEXEC ġ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#enable">suEXEC Ű </a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#usage">suEXEC ϱ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#debug">suEXEC ϱ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#jabberwock">ٽ ѹ ϶: </a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="before" id="before">ϱ </a></h2>
<p>ϱ 켱 ġ .</p>
<p> <strong>setuid</strong> <strong>setgid</strong>
н ü Ѵٰ Ѵ.
ɾ 鵵 Ѵ. suEXEC ϴ ٸ ÷
ϴٸ ٸ ִ.</p>
<p>ι°, ǻ ⺻ ͼϴٰ
Ѵ. <strong>setuid/setgid</strong> ɰ
̵ ý۰ ȿ ġ ذ Եȴ.</p>
<p>°, suEXEC ڵ <strong></strong>
Ѵٰ Ѵ. ڿ Ÿ͵
suEXEC õ ڵ带 ɽ ϰ ˻ߴ.
ڵ带 ϰ ϰ Ȯ ϱ Ǹ
. ڵ带 ϸ ġ ο
ִ. αֿ ſ ˰
ڵ带 캸 ġ ۾ ǻ簡 ٸ
suEXEC ڵ带 ʱ <strong></strong> Ѵ.</p>
<p>° , ġ suEXEC ġ
⺻ġ <strong>ʱ</strong> ߴ. ᱹ
ڰ Ǹ ￩ suEXEC ؾ Ѵ. suEXEC
ڴ Ϲ ġ suEXEC
ġ ִ. suEXEC ϴ ý å
ڴ ְ 캸 ؾ Ѵ.
̷ suEXEC Ҹŭ ְ ȣ
suEXEC ϵ ġ ϱ ̴.</p>
<p> ϱ ϴ°? ? . !</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="model" id="model">suEXEC ȸ</a></h2>
<p>suEXEC ϰ ġϱ 츮 ȸ
Ѵ. ̸ Ȯ suEXEC ȿ Ͼ
ý ؾ
ִ.</p>
<p><strong>suEXEC</strong> ġ θ setuid
"wrapper" α Ѵ. wrapper ڰ
ּ ٸ userid ϵ CGI SSI α
HTTP û Ҹ. ̷ û ġ suEXEC
wrapper α α ڿ
ID Ѵ.</p>
<p> wrapper и Ѵ.
ϳ ϸ α з ϵǰ
Ѵ. Ѵ:</p>
<ol>
<li>
<strong>wrapper ϴ ڰ ý
ΰ?</strong>
<p class="indent">
wrapper ϴ ڰ ý
ȮѴ.
</p>
</li>
<li>
<strong> ƱԸƮ wrapper ϴ°?</strong>
<p class="indent">
wrapper ƱԸƮ ־߸ ȴ.
ġ ȴ. wrapper
ƱԸƮ ϸ ŷǾų ġ suEXEC
ִ ̴.
</p>
</li>
<li>
<strong> ڰ wrapper ϵ Ǿ?</strong>
<p class="indent">
ڰ wrapper ϵ Ǿ?
(ġ ) α
ִ.
</p>
</li>
<li>
<strong> CGI SSI α
°?</strong>
<p class="indent">
CGI SSI α '/' ϰų
'..' °? ̵ . CGI/SSI
α suEXEC root (Ʒ
<code>--with-suexec-docroot=<em>DIR</em></code> )
־ Ѵ.
</p>
</li>
<li>
<strong> ڸ ȿѰ?</strong>
<p class="indent">
ڰ ϴ°?
</p>
</li>
<li>
<strong> ȿѰ?</strong>
<p class="indent">
ϴ°?
</p>
</li>
<li>
<strong> ڰ superuser <em>ƴѰ</em>?</strong>
<p class="indent">
suEXEC <code><em>root</em></code> CGI/SSI
α Ѵ.
</p>
</li>
<li>
<strong> userid ּ ID ں <em>ū</em>?</strong>
<p class="indent">
ּ ID ڸ Ѵ. CGI/SSI
α ִ userid ּġ
ִ. "ýۿ" Ҷ ϴ.
</p>
</li>
<li>
<strong> superuser <em>ƴѰ</em>?</strong>
<p class="indent">
suEXEC <code><em>root</em></code> CGI/SSI
α Ѵ.
</p>
</li>
<li>
<strong> groupid ּ ID ں <em>ū</em>?</strong>
<p class="indent">
ּ ID ڸ Ѵ. CGI/SSI
α ִ groupid ּġ
ִ. "ýۿ" Ҷ ϴ.
</p>
</li>
<li>
<strong>wrapper ڿ
ִ°?</strong>
<p class="indent">
ܰ迡 α setuid setgid ȣ Ͽ
ڿ ȴ. , ٸ
ڰ ش ʱȭȴ.
</p>
</li>
<li>
<strong>CGI/SSI α ִ 丮 丮
ִ°?</strong>
<p class="indent">
丮 ʴٸ . ̰
丮 ٸ 丮
̴.
</p>
</li>
<li>
<strong>丮 ġ ȿ ִ°?</strong>
<p class="indent">
Ϲ κ û ûϴ 丮
suEXEC root Ʒ ִ°? UserDir û
ûϴ 丮 suEXEC userdir (<a href="#install">suEXEC ɼ</a> ) 丮
Ʒ ִ°?
</p>
</li>
<li>
<strong>ٸ 丮 <em>°</em>?</strong>
<p class="indent">
丮 ٸ α ʴ´.
ڸ 丮 ִ.
</p>
</li>
<li>
<strong> CGI/SSI α ϴ°?</strong>
<p class="indent">
ʴٸ .
</p>
</li>
<li>
<strong>ٸ CGI/SSI α
<em>°</em>?</strong>
<p class="indent">
ڿ CGI/SSI α ϱ ʴ´.
</p>
</li>
<li>
<strong> CGI/SSI α setuid setgid
<em>ƴѰ</em>?</strong>
<p class="indent">
츮 α ٽ UID/GID ϱ ʴ´.
</p>
</li>
<li>
<strong> / α / ?</strong>
<p class="indent">
ڰ ΰ?
</p>
</li>
<li>
<strong> μ ȯ溯 û
ִ°?</strong>
<p class="indent">
suEXEC ( ) PATH ,
(̰͵ ) ȯ溯 Ͽ ŵ
μ ȯ溯 .
</p>
</li>
<li>
<strong> CGI/SSI α
ִ°?</strong>
<p class="indent">
⼭ suEXEC CGI/SSI α Ѵ.
</p>
</li>
</ol>
<p>̰ suEXEC wrapper ȸ ǥ ̴. ټ
ϰ CGI/SSI 迡 ο , ο
ΰ Ѵܰ辿 ɽ .</p>
<p> ִ
suEXEC ִ
<a href="#jabberwock">"ٽ ѹ ϶"</a>
϶.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">suEXEC ġ</a></h2>
<p> ִ Ѵ.</p>
<p><strong>suEXEC ɼ</strong><br />
</p>
<dl>
<dt><code>--enable-suexec</code></dt>
<dd> ɼ ⺻ ġǰų Ȱȭʴ suEXEC
ȰȭѴ. APACI suEXEC Ƶ̷
<code>--enable-suexec</code> ɼǿܿ
<code>--with-suexec-xxxxx</code> ɼ ּ Ѱ
ʿϴ.</dd>
<dt><code>--with-suexec-bin=<em>PATH</em></code></dt>
<dd><code>suexec</code> ̳ʸ δ Ȼ
ϵǾ Ѵ. ⺻ Ϸ ɼ
Ѵ. <em> </em>
<code>--with-suexec-bin=/usr/sbin/suexec</code></dd>
<dt><code>--with-suexec-caller=<em>UID</em></code></dt>
<dd> ġ ϴ <a href="mod/mpm_common.html#user">ڸ</a>. α
ִ ڴ.</dd>
<dt><code>--with-suexec-userdir=<em>DIR</em></code></dt>
<dd>suEXEC Ǵ Ȩ丮 丮
Ѵ. 丮 ִ
suEXEC Ƿ, α "ؾ" Ѵ. (
, "*" ) "" UserDir þ Ѵٸ
ؾ Ѵ. UserDir þ passwd Ͽ
Ȩ丮 ٸ suEXEC
۵ ʴ´. ⺻ "public_html"̴.<br />
ȣƮ ٸ UserDir Ѵٸ
θ 丮 ȿ ֵ ؾ ϰ, θ 丮
´. <strong>̷ , "~userdir"
cgi û ۵ ʴ´!</strong></dd>
<dt><code>--with-suexec-docroot=<em>DIR</em></code></dt>
<dd>ġ DocumentRoot Ѵ. ̴ suEXEC
ִ (UserDirs ) ̴. ⺻ 丮
<code>--datadir</code> "/htdocs" ̴.
<em> </em> "<code>--datadir=/home/apache</code>"
ߴٸ suEXEC wrapper document root
"/home/apache/htdocs" 丮 Ѵ.</dd>
<dt><code>--with-suexec-uidmin=<em>UID</em></code></dt>
<dd>suEXEC ּ UID Ѵ.
κ ýۿ 500̳ 100 ϴ. ⺻
100̴.</dd>
<dt><code>--with-suexec-gidmin=<em>GID</em></code></dt>
<dd>suEXEC ּ GID Ѵ.
κ ýۿ 100 ϹǷ ⺻̴.</dd>
<dt><code>--with-suexec-logfile=<em>FILE</em></code></dt>
<dd> suEXEC ۵ (ó )
αϸ Ѵ. ⺻ α ̸
"suexec_log"̰ ǥ α 丮
(<code>--logfiledir</code>) ġѴ.</dd>
<dt><code>--with-suexec-safepath=<em>PATH</em></code></dt>
<dd>CGI Ͽ Ѱ PATH ȯ溯 Ѵ.
⺻ "/usr/local/bin:/usr/bin:/bin"̴.</dd>
</dl>
<p><strong>suEXEC wrapper ϰ ġϱ</strong><br />
<code>--enable-suexec</code> ɼ suEXEC ϰ
<code>make</code> ɾ ϸ <code>suexec</code>
(ġ Բ) ڵ .<br />
<code>make install</code> ɾ
Ͽ ġ ִ. ̳ʸ <code>suexec</code>
<code>--sbindir</code> ɼ 丮 ġȴ.
⺻ ġ "/usr/local/apache2/sbin/suexec"̴.<br />
ġ <strong><em>root </em></strong> ʿ
϶. wrapper ID ϱؼ ڰ
<code><em>root</em></code>̰ ϸ setuserid Ʈ
Ǿ Ѵ.</p>
<p><strong> Ѽ</strong><br />
suEXEC wrapper ڽ ڰ ɼ
<code>--with-suexec-caller</code> ùٸ
Ȯ , ˻ suEXEC ϴ ýȣ
Ȥ ̺귯 Լ ۵Ǿ ִ. ̸ ϸ
Ϲ ̹Ƿ ġ ϴ 츸
suEXEC ֵ Ͻý ؾ Ѵ.</p>
<p> , ϰ:</p>
<div class="example"><p><code>
User www<br />
Group webgroup<br />
</code></p></div>
<p><code>suexec</code> "/usr/local/apache2/sbin/suexec"
ġϿٸ, ؾ Ѵ:</p>
<div class="example"><p><code>
chgrp webgroup /usr/local/apache2/bin/suexec<br />
chmod 4750 /usr/local/apache2/bin/suexec<br />
</code></p></div>
<p> ġ ϴ 츸 suEXEC wrapper
ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="enable" id="enable">suEXEC Ű </a></h2>
<p>ġ Ҷ <code>--sbindir</code> ɼ
丮 <code>suexec</code> (⺻
"/usr/local/apache2/sbin/suexec") ã´. ġ
suEXEC wrapper ߰ϸ α(error
log) Ѵ:</p>
<div class="example"><p><code>
[notice] suEXEC mechanism enabled (wrapper: <em>/path/to/suexec</em>)
</code></p></div>
<p> ߿ ̷ ٸ ҿ
wrapper α ã ߰ų, <em>setuid
root</em> ġʾұ ̴.</p>
<p>ó suEXEC ϰ Ͱ ̹ ġ
̶, ġ ̰ ٽ ؾ Ѵ.
HUP̳ USR1 ñ׳η ϴ δ ʴ. </p>
<p>suEXEC ȻϷ <code>suexec</code>
ġ ̰ ؾ Ѵ. </p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="usage" id="usage">suEXEC ϱ</a></h2>
<p>CGI α û <code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> þ
ȣƮ û Ͽų <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>
û óϴ 쿡 suEXEC wrapper ȣѴ.</p>
<p><strong>ȣƮ:</strong><br /> suEXEC wrapper
ϴ Ѱ <code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> ǿ <code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> þ
ϴ ̴. þ ּ ID ٸ
ϸ CGI ڿ û <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
<em>User</em> <em>Group</em> ȴ.
þ <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> ּ
userid Ѵ.</p>
<p><strong> 丮:</strong><br />
<code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code> û óѴٸ suEXEC
wrapper ȣϿ, û 丮 شϴ
ID CGI α Ѵ. Ϸ
ID CGI ְ ũƮ <a href="#model">
˻</a> ؾ Ѵ. <a href="#install">
ɼ</a> <code>--with-suexec-userdir</code> ϶.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="debug" id="debug">suEXEC ϱ</a></h2>
<p>suEXEC wrapper α ٷ
<code>--with-suexec-logfile</code> ɼ Ͽ
. wrapper ùٷ ϰ ġߴٸ ߸Ǿ
αϿ error_log .</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="jabberwock" id="jabberwock">ٽ ѹ ϶: </a></h2>
<p><strong>!</strong> ִ.
ġ <a href="http://httpd.apache.org/docs/2.4/suexec.html">¶
</a> ֽ ϶.</p>
<p>wrapper ϴ ̷ο ִ.
suEXEC õ "" ϱ ̵ 캸 ٶ.</p>
<ul>
<li><strong>suEXEC </strong></li>
<li>
丮
<p class="indent">
Ȱ ȿ suEXEC û ȣƮ
ֻ document root Ȥ userdir û
ֻ document root ȿ ؾ Ѵ.
, ȣƮ װ ߴٸ ȣƮ
suEXEC ̿ϱ ȣƮ document root
ġ ۿ ʿ䰡 ִ.
( .)
</p>
</li>
<li>
suEXEC PATH ȯ溯
<p class="indent">
ϸ ִ. ϴ ΰ
<strong> ִ</strong> 丮 Ȯ϶.
װ ִ Ʈ̸ ϱ
̴.
</p>
</li>
<li>
suEXEC ڵ ϱ
<p class="indent">
ݺؼ , ϴ õѴٸ
<strong>ū </strong> ִ. 쿡
.
</p>
</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/suexec.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/suexec.html" title="Korean"> ko </a> |
<a href="./tr/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/suexec.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/urlmapping.html.tr.utf8 0000664 0001751 0001751 00000067731 14743132254 021427 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="tr" xml:lang="tr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>URL’lerin Dosya Sistemi ile Eşleştirilmesi - Apache HTTP Sunucusu Sürüm 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p>
<p class="apache">Apache HTTP Sunucusu Sürüm 2.4</p>
<img alt="" src="./images/feather.png" /></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 Sunucusu</a> > <a href="http://httpd.apache.org/docs/">Belgeleme</a> > <a href="./">Sürüm 2.4</a></div><div id="page-content"><div id="preamble"><h1>URL’lerin Dosya Sistemi ile Eşleştirilmesi</h1>
<div class="toplang">
<p><span>Mevcut Diller: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/urlmapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/urlmapping.html" title="Türkçe"> tr </a></p>
</div>
<p>Bu belgede, bir istekte belirtilen URL’nin sunulacak dosyanın dosya
sistemindeki yerini bulmak için Apache HTTP Sunucusu tarafından nasıl
kullanıldığı açıklanmaktadır.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#related">İlgili Modüller ve Yönergeler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#documentroot"><code>DocumentRoot</code></a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#outside">Belge Kök Dizini Dışındaki Dosyalar</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#user">Kullanıcı Dizinleri</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#redirect">URL Yönlendirme</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#proxy">Karşı Vekil</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rewrite">Yeniden Yazma Motoru</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#notfound">Dosya orada yok</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">Diğer URL Eşleme Modülleri</a></li>
</ul><h3>Ayrıca bakınız:</h3><ul class="seealso"><li><a href="#comments_section">Yorumlar</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="related" id="related">İlgili Modüller ve Yönergeler</a></h2>
<table class="related"><tr><th>İlgili Modüller</th><th>İlgili Yönergeler</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_alias.html">mod_alias</a></code></li><li><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code></li><li><code class="module"><a href="./mod/mod_dir.html">mod_dir</a></code></li><li><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</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_proxy.html">mod_proxy</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code></li><li><code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code></li><li><code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_speling.html#checkspelling">CheckSpelling</a></code></li><li><code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="documentroot" id="documentroot"><code>DocumentRoot</code></a></h2>
<p>Yapılan bir isteğe hangi dosyanın sunulacağına karar verirken
httpd’nin öntanımlı davranışı istek için URL yolunu (URL’den konak ismi
ve port ayrıldıktan sonra kalan kısım) alıp bunu yapılandırma dosyasında
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> yönergesi ile
belirtilen dizinin sonuna eklemektir. Bu nedenle, <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> altındaki dizinler ve dosyalar
sitenin dışardan görünen temel belge ağacını oluştururlar.</p>
<p>Örneğin, <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> yönergesine
<code>/var/http/html</code> atanmış olsun.
<code>http://example.com/balıklar/zargana.html</code> şeklindeki bir
istek için istemciye <code>/var/http/html/balıklar/zargana.html</code>
dosyası sunulur.</p>
<p>Bir dizin istenirse (<code>/</code> ile biten bir yol belirtilmesi
durumu), sunulacak dosya <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> yönergesinde belirtilen dosya olacaktır.
Örneğin, <code>DocumentRoot</code> yukarıdaki gibi belirtimiş ve siz de
şunu belirtmişseniz:</p>
<div class="example"><p><code>DirectoryIndex index.html index.php</code></p></div>
<p><code>http://www.example.com/fish/</code> isteği, httpd'nin
<code>/var/www/html/fish/index.html</code> dosyasını sunmaya, bu dosya
bulunmuyorsa <code>/var/www/html/fish/index.php</code> dosyasını sunmaya
çalışmasına sebep olacaktır.</p>
<p>Bu dosyaların ikisi de bulunmuyorsa sonraki adım,
<code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code> yüklü ve uygun şekilde yapılandırılmışsa
bir dizin içeriği dosyası sağlamaya çalışmak olacaktır.</p>
<p>httpd ayrıca, sunucunun birden fazla konak için istek kabul etmesini
sağlayan <a href="vhosts/">sanal barındırmaya</a> da muktedirdir. Bu
durumda her sanal konak için ayrı bir <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> belirtilebileceği gibi sunulacak içeriğin
istekte bulunulan IP adresi veya konak ismine dayanarak devingen olarak
saptanmasını sağlayabilen <code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code> modülüyle
gelen yönergeler de kullanılabilir.</p>
<p><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> yönergesi
yapılandırma dosyanızda ana sunucu için bir tane ve muhtemelen
oluşturduğunuz her <a href="vhosts/">sanal konak</a> için de birer
tanedir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="outside" id="outside">Belge Kök Dizini Dışındaki Dosyalar</a></h2>
<p>Bazen dosya sisteminde doğrudan <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> altında bulunmayan dosyalara da erişim izni
vermek gerekir. httpd’de bunu sağlamanın çeşitli yolları vardır. Unix
sistemlerinde sembolik bağlar sayesinde dosya sisteminin farklı
yerlerindeki dosyaları ve dizinleri <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> altındaymış gibi göstermek mümkündür.
<code class="directive"><a href="./mod/core.html#options">Options</a></code> yönergesine değer olarak
<code>FollowSymLinks</code> veya <code>SymLinksIfOwnerMatch</code>
atanmadıkça httpd olası güvenlik açıklarına karşı öntanımlı olarak
sembolik bağları izlemez.</p>
<p>Bundan başka, dosya sisteminin farklı parçalarını belge kök dizini
altında göstermek için <code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code>
yönergesi de kullanılabilir. Örneğin,</p>
<pre class="prettyprint lang-config">Alias "/belgeler" "/var/http"</pre>
<p>yapılandırması ile
<code>http://example.com/belgeler/dizin/dosya.html</code> URL’si için
dosya sistemindeki <code>/var/http/dizin/dosya.html</code> dosyası
sunulacaktır. Hedef dizindeki dosyaları birer <a class="glossarylink" href="./glossary.html#cgi" title="sözlüğe bakınız">CGI</a> betiği olarak imlemesi dışında <code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code> yönergesi de aynı şekilde
çalışır.</p>
<p>Biraz daha fazla esnekliğin gerektiği durumlarda <a class="glossarylink" href="./glossary.html#regex" title="sözlüğe bakınız">düzenli ifadelere</a> dayalı eşleşmeler sağlamak
üzere <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code> ve <code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code> yönergelerinin gücünden
yararlanılabilir. Örneğin,</p>
<pre class="prettyprint lang-config">ScriptAliasMatch "^/~([a-zA-Z0-9]+)/cgi-bin/(.+)" "/home/$1/cgi-bin/$2"</pre>
<p>satırı sayesinde <code>http://example.com/~user/cgi-bin/betik.cgi</code>
URL’si <code>/home/user/cgi-bin/betik.cgi</code> dosyası ile
eşleştirilir ve dosya bir CGI betiği olarak çalıştırılırdı.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="user" id="user">Kullanıcı Dizinleri</a></h2>
<p>Geleneksel olarak Unix sistemlerinde belli bir kullanıcının (örn,
<em>birisi</em>) ev dizinine <code>~birisi/</code> şeklinde atıfta
bulunulabilir. <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code> modülü bu özelliği site
üzerinden kullanıcıların ev dizinlerindeki dosyaları kişisel sayfalar
olarak sunmalarını sağlamak üzere kullanır. Örnek:</p>
<div class="example"><p><code>http://example.com/~birisi/dosya.html</code></p></div>
<p>Güvenlik sebebiyle kullanıcıların ev dizinlerine doğrudan HTTP erişimi
vermek uygun olmaz. Bu bakımdan, kullanıcının ev dizini altında HTTP
erişimi verilecek dosyaların bulunduğu dizini belirtmek için <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> yönergesi sağlanmıştır.
Öntanımlı olan <code>Userdir public_html</code> yapılandırması ile
yukarıdaki gibi bir URL kullanıcının ev dizini (<code>/etc/passwd</code>
dosyasında belirtilir) <code>/home/birisi/</code> altında yer alan
<code>/home/birisi/public_html/dosya.html</code> dosyası ile
eşleşirdi.</p>
<p>Ev dizininin yerinin <code>/etc/passwd</code> dosyasında belirtilmediği
sistemlerde kullanılmak üzere <code>Userdir</code> yönergesinin başka
kullanım şekilleri de vardır.</p>
<p>Bazı kişiler (genellikle URL üzerinde <code>%7e</code> olarak
kodlanması sebebiyle) "~" simgesini biçimsiz bulabilir ve kullanıcı
dizinlerini imlemek için başka bir karakter kullanmayı tercih
edebilirler. Bu işlevsellik <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code> tarafından
desteklenmemektedir. Ancak, kullanıcı dizinleri düzgün şekilde
yapılandırılmışsa istenen etki <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code> yönergesi ile sağlanabilir.
Örneğin, <code>http://example.com/sayfalar/birisi/dosya.html</code>
URL’si ile <code>/home/birisi/public_html/dosya.html</code> dosyasını
eşlemek için <code>AliasMatch</code> yönergesi şöyle
kullanılabilirdi:</p>
<pre class="prettyprint lang-config">AliasMatch "^/sayfalar/([a-zA-Z0-9]+)(/(.*))?$" "/home/$1/public_html/$3"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirect" id="redirect">URL Yönlendirme</a></h2>
<p>Yukarıdaki bölümlerde açıklanan yapılandırma yönergeleri httpd’ye
içeriği dosya sisteminin belli bir yerinden alıp istemciye göndermesini
söyler. Bazen istemciye, istediği içeriğe farklı bir URL ile
erişebileceğini ve bu URL için ayrı bir istek yapması gerektiğini
bildirmek gerekir. Bu işleme <em>yönlendirme</em> adı verilir ve bu
işlevsellik <code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code> yönergesi
ile sağlanır. Örneğin, <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
altındaki <code>/foo/</code> dizininin içeriğinin <code>/bar/</code>
adında yeni bir dizine taşınması halinde istemciye yeni konumun
bildirilmesi şöyle sağlanabilirdi:</p>
<pre class="prettyprint lang-config">Redirect permanent "/foo/" "http://example.com/bar/"</pre>
<p>Bu atama sayesinde <code>/foo/</code> ile başlayan URL yolları
<code>example.com</code> sunucundaki <code>/bar/</code> dizini altındaki
içeriğe yönlendirilmektedir. Yönlendirmeyi aynı sunucu üzerinde yapmak
zorunda değilsiniz, bu yönerge ile başka bir sunucuya da yönlendirme
yapabilirsiniz.</p>
<p>httpd ayrıca, yeniden yazma ile ilgili daha karmaşık sorunlara çözüm
olarak <code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> diye bir
yönerge daha sağlar. Örneğin bir sitenin baş sayfasını diğer isteklerden
ayrı olarak farklı bir siteye yönlendirmek için yönergeyi şöyle
kullanabilirsiniz:</p>
<pre class="prettyprint lang-config">RedirectMatch permanent "^/$" "http://example.com/ilksayfa.html"</pre>
<p>Bundan başka, bir sitedeki tüm sayfalara yapılan istekleri başka bir
siteye geçici olarak yönlendirmek için şöyle bir şey yapabilirsiniz:</p>
<pre class="prettyprint lang-config">RedirectMatch temp ".*" "http://mesela.example.com/ilksayfa.html"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Karşı Vekil</a></h2>
<p>httpd ayrıca, uzak sunuculardaki belgelerin yerel sunucunun URL
alanına getirilmesini de mümkün kılar. Bu tekniğe HTTP sunucunun
belgeleri uzak bir sunucudan alıp istemciye sunmasını sağlayarak bir
vekil sunucu gibi davranması nedeniyle <em>ters vekalet</em> adı
verilir. Belgelerin istemciye özkaynağın bulunduğu sunucudan
geliyormuş gibi değilde doğrudan isteği yaptığı sunucudan geliyormuş
gibi sunulması nedeniyle bu işlem normal vekaletten farklıdır.</p>
<p>Aşağıdaki örnekte, istemci <code>/foo/</code> dizini altından bir belge
istemekte, sunucu ise bu belgeyi <code>dahili.example.com</code>
üzerindeki <code>/bar/</code> dizininden alıp istemciye yerel sunucudan
geliyormuş gibi sunmaktadır:</p>
<pre class="prettyprint lang-config">ProxyPass "/foo/" "http://dahili.example.com/bar/"
ProxyPassReverse "/foo/" "http://dahili.example.com/bar/"
ProxyPassReverseCookieDomain dahili.example.com harici.example.com
ProxyPassReverseCookiePath "/foo/" "/bar/"</pre>
<p><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> sunucuyu uygun
belgeleri alması için yapılandırırken <code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> yönergesi <code>dahili.example.com</code>
sunucusundan kaynaklanan yönlendirmeleri yeniden yazar, böylece bunların
yerel sunucudaki yerleri belirlenmiş olur. Benzer şekilde, <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code> ve
<code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code>
yönergeleri de arka sunucu tarafından atanan çerezleri yeniden yazar.</p>
<p>Yalnız, belgelerin içindeki hiperbağların yeniden yazılmayacağına
dikkat ediniz. Dolayısıyla, belge içinde
<code>dahili.example.com</code>’u ismiyle hedef alan mutlak hiperbağlar
varsa bunlar istemci tarafından vekil sunucudan değil doğrudan
<code>dahili.example.com</code>’dan istenecektir. Bir sayfanın içindeki bu
bağları (ve diğer içeriği) <code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code> modülü
kullanılarak istemciye sunuluyormuşçasına değiştirebilirsiniz.</p>
<pre class="prettyprint lang-config">Substitute "s/dahili\.example\.com/harici.example.com/i"</pre>
<p>HTML ve XHTML’de hiperbağları daha bilgece yeniden yazabilen
<code class="module"><a href="./mod/mod_proxy_html.html">mod_proxy_html</a></code> modülü de kullanılabilir. Yeniden
yazılması gereken URL eşlemlerini oluşturmanızı sağlar, böylece karmaşık
vekil senaryoları oluşturulabilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">Yeniden Yazma Motoru</a></h2>
<p>Daha güçlü ikameler gerektiğinde <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> modülü
tarafından sağlanan yeniden yazma motoru işe yarayabilir. Bu modüldeki
yönergeler sunulacak içeriğin yerine karar vermek için kaynak IP adresi,
tarayıcı türü gibi isteğe özgü özellikleri kullanırlar.
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> modülü buna ek olarak isteğin nasıl ele
alınacağına karar vermek için harici yazılımları ve veritabanlarını
kullanabilir. Yeniden yazma motoru yukarıda değinilen üç eşleşme türünü
de uygulayabilecek yetenektedir: Dahili yönlendirmeler (rumuzlar),
harici yönlendirmeler ve vekalet. <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> modülü
tarafından sağlanan yeteneklerin ayrıntılı açıklamaları ve bunların
kullanım örnekleri ayrıntılı olarak <a href="rewrite/">mod_rewrite
belgeleri</a>nde bulunmaktadır.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="notfound" id="notfound">Dosya orada yok</a></h2>
<p>Kaçınılmaz olarak, dosya sisteminde mevcut olmayan dosyalar için de
istek yapılacaktır. Bunun çeşitli sebepleri olabilir. Bazı durumlarda
bu, belgelerin yerlerininin değiştirilmesinin bir sonucu olabilir. Bu
durumda yapılacak en iyi şey, istemciyi belgeyi yeni yerinden istemesi
için bilgilendirmek amacıyla <a href="#redirect">URL yönlendirmesi</a>
kullanmaktır. Bu şekilde, içeriğin yeri değişse bile eski yer imlerinin
ve hiperbağların çalışmaya devam edeceklerinden emin olabilirsiniz.</p>
<p>"Dosya orada yok" ("File Not Found") hatalarının diğer bir bildik
sebebi de URL’lerin hiperbağlarda veya doğrudan tarayıcıda kasıtlı ya da
kasıtsız, yanlış yazılmasıdır. Bu tür sorunlarda yardımcı olması için
httpd <code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> (sic) adında bir modülle gelir. Bu
modül etkin kılındığında htpd, "Dosya orada yok" ("File Not Found")
hatalarının önünü kesip başka bir yerde benzer isimde bir dosya var mı
diye bakar. Böyle bir dosya varsa, <code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code>
istemciye dosyanın doğru yerini bildiren bir HTTP yönlendirmesi yollar.
Benzer çok sayıda dosya varsa bunlar istemciye bir liste halinde
sunulur.</p>
<p><code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> modülünün en yararlı özelliklerinden biri
de dosya isimlerini harf büyüklüğüne duyarsız olarak arayabilmesidir.
Dosya isimlerinde harf büyüklüğünün önemli olduğu Unix benzeri sistemler
hakkında bilgisi olmayan kullanıcılara sahip sistemlerin kullanıcılarına
bu büyük yarar sağlar. Fakat modülün URL düzeltmekten başka şeyler için
de kullanılması, istemcilerden gelen neredeyse her isteğin URL
yönlendirmesine konu olmasına sebep olarak sunucunun yükünü
arttırabilir.</p>
<p><code class="module"><a href="./mod/mod_dir.html">mod_dir</a></code> modülü sanal URI'leri, onları sunan gerçek
kaynağa eşlemekte kullanılan <code class="directive"><a href="./mod/mod_dir.html#fallbackresource">FallbackResource</a></code> yönergesini içerir. Bir 'ön denetleyici'
gerçeklerken <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> modülünün kullanılmasını
sağlamak için çok kullanışlıdır.</p>
<p>Yerinde bulunmayan içeriğin bulunması çabalarının tümü Apache’nin 404
(Dosya orada yok) HTTP durum kodlu bir hata sayfası döndürmesine yol
açar. Bu sayfanın içeriği <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> yönergesi ile denetlenebilir ve <a href="custom-error.html">Hata Yanıtlarının Kişiselleştirilmesi</a>
bölümünde anlatıldığı gibi oldukça esnek bir şekilde
kişiselleştirilebilir.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Diğer URL Eşleme Modülleri</a></h2>
<p>URL eşlemede kullanılabilecek diğer modüller:</p>
<ul>
<li><code class="module"><a href="./mod/mod_actions.html">mod_actions</a></code> - Bir isteği, özkaynağın MIME türüne veya
istek yöntemine bakarak bir CGI betiğine eşler.</li>
<li><code class="module"><a href="./mod/mod_dir.html">mod_dir</a></code> - URL'yi sonlandıran bölü çizgisini
<code>index.html</code> bir dosyaya eşler.</li>
<li><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code> - Bir isteği, bir HTML belge içindeki
bir resme yapılan kullanıcı tıklamalarına dayanarak bir URL'ye
eşler.</li>
<li><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> - Dil veya içerik sıkıştırması gibi
kullanıcı tercihlerine dayanarak uygun bir belgeyi seçer.</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Mevcut Diller: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/urlmapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/urlmapping.html" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Yorumlar</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/urlmapping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br /><a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> altında lisanslıdır.</p>
<p class="menu"><a href="./mod/">Modüller</a> | <a href="./mod/directives.html">Yönergeler</a> | <a href="http://wiki.apache.org/httpd/FAQ">SSS</a> | <a href="./glossary.html">Terimler</a> | <a href="./sitemap.html">Site Haritası</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/content-negotiation.html.fr.utf8 0000664 0001751 0001751 00000116272 14740503670 023217 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Négociation de contenu - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Négociation de contenu</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/content-negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/content-negotiation.html" title="Français"> fr </a> |
<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Apache HTTPD prend en charge la négociation de
contenu telle qu'elle est décrite
dans la spécification HTTP/1.1. Il peut choisir la meilleure représentation
d'une ressource en fonction des préférences du navigateur pour ce qui
concerne le type de media, les langages, le jeu de caractères et son
encodage. Il implémente aussi quelques fonctionnalités pour traiter de
manière plus intelligente les requêtes en provenance de navigateurs qui
envoient des informations de négociation incomplètes.</p>
<p>La négociation de contenu est assurée par le module
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> qui est compilé par défaut
dans le serveur.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#about">À propos de la négociation de contenu</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#negotiation">La négociation avec httpd</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#methods">Les méthodes de négociation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#better">Ajustement des valeurs de qualité</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extensions">Extensions à la négociation de contenu
transparente</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#naming">Remarques à propos des liens hypertextes et des
conventions de nommage</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#caching">Remarque sur la mise en cache</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="about" id="about">À propos de la négociation de contenu</a></h2>
<p>Une ressource peut être disponible selon différentes représentations.
Par exemple, elle peut être disponible en différents langages ou pour
différents types de média, ou une combinaison des deux.
Pour faire le meilleur choix, on peut fournir à l'utilisateur une page
d'index, et le laisser choisir. Cependant, le serveur peut souvent faire
ce choix automatiquement. Cela est possible car les navigateurs peuvent
envoyer des informations sur les
représentations qu'ils préfèrent à l'intérieur de chaque requête.
Par exemple, un navigateur peut indiquer
qu'il préfère voir les informations en français, mais qu'en cas
d'impossibilité l'anglais peut convenir. Les navigateurs indiquent leurs
préférences à l'aide d'en-têtes dans la requête. Pour ne demander que des
représentations en français, le navigateur peut utiliser l'en-tête :</p>
<div class="example"><p><code>Accept-Language: fr</code></p></div>
<p>Notez qu'il ne sera tenu compte de cette préférence que s'il existe un
choix de représentations et que ces dernières varient en fonction
du langage.</p>
<p>À titre d'exemple d'une requête plus complexe, ce navigateur a été
configuré pour accepter le français et l'anglais, avec une préférence pour
le français, et accepter différents types de média, avec une préférence
pour HTML par rapport à au texte plat (« plain text ») ou autres types de fichiers texte, et
avec une préférence pour GIF ou JPEG par rapport à tout autre type de
média, mais autorisant tout autre type de média en dernier ressort :</p>
<div class="example"><p><code>
Accept-Language: fr; q=1.0, en; q=0.5<br />
Accept: text/html; q=1.0, text/*; q=0.8, image/gif; q=0.6, image/jpeg; q=0.6, image/*; q=0.5, */*; q=0.1
</code></p></div>
<p>httpd prend en charge la négociation de contenu « server driven » (telle qu'elle
est définie dans la spécification HTTP/1.1), où c'est le serveur qui
décide quelle est la meilleure représentation à renvoyer pour la ressource
demandée. Il prend entièrement en charge les en-têtes de requête
<code>Accept</code>, <code>Accept-Language</code>,
<code>Accept-Charset</code> et <code>Accept-Encoding</code>.
httpd prend aussi en charge la négociation de contenu transparente, qui est un
protocole de négociation expérimental défini dans les RFC 2295 et 2296.
Il ne prend pas en charge la négociation de fonctionnalité (feature negotiation)
telle qu'elle est définie dans ces RFCs.</p>
<p>Une <strong>ressource</strong> est une entité conceptuelle identifiée
par un URI (RFC 2396). Un serveur HTTP comme le serveur HTTP Apache
propose l'accès à des
<strong>représentations</strong> de la ressource à l'intérieur de son
espace de nommage, chaque représentation étant composée d'une séquence
d'octets avec la définition d'un type de media, d'un jeu de caractères,
d'un encodage, etc. À un instant donné, chaque ressource peut être
associée avec zéro, une ou plusieurs représentations. Si plusieurs
représentations sont disponibles, la ressource est qualifiée de
<strong>négociable</strong> et chacune de ses représentations se nomme
<strong>variante</strong>. Les différences entre les
variantes disponibles d'une ressource négociable constituent les
<strong>dimensions</strong> de la négociation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="negotiation" id="negotiation">La négociation avec httpd</a></h2>
<p>Pour négocier une ressource, on doit fournir au serveur des
informations à propos de chacune des variantes. Il y a deux manières
d'y parvenir :</p>
<ul>
<li>Utiliser une liste de correspondances de type (« type-map ») (<em>c'est à dire</em>
un fichier <code>*.var</code>) qui nomme explicitement les fichiers
contenant les variantes, ou</li>
<li>Utiliser une recherche « multivues », où le serveur effectue une
recherche de correspondance sur un motif de nom de fichier implicite et
fait son choix parmi les différents résultats.</li>
</ul>
<h3><a name="type-map" id="type-map">Utilisation d'un fichier de
correspondances de types (type-map)</a></h3>
<p>Une liste de correspondances de types est un document associé au
gestionnaire <code>type-map</code> (ou, dans un souci de compatibilité
ascendante avec des configurations de httpd plus anciennes, le
<a class="glossarylink" href="./glossary.html#type mime" title="voir glossaire">type MIME</a>
<code>application/x-type-map</code>). Notez que pour utiliser cette
fonctionnalité, vous devez, dans le fichier de configuration, définir un
gestionnaire qui associe un suffixe de fichier à une <code>type-map</code>,
ce qui se fait simplement en ajoutant</p>
<pre class="prettyprint lang-config">AddHandler type-map .var</pre>
<p>dans le fichier de configuration du serveur.</p>
<p>Les fichiers de correspondances de types doivent posséder le même nom que
la ressource qu'ils décrivent, avec pour extension
<code>.var</code>. Dans l'exemple ci-dessous, la ressource a pour
nom <code>foo</code>, et le fichier de correspondances se nomme donc
<code>foo.var</code>.</p>
<p>Ce fichier doit comporter une entrée pour chaque variante
disponible ; chaque entrée consiste en une ligne contiguë d'en-têtes au
format HTTP. Les entrées sont séparées par des lignes vides. Les lignes
vides à l'intérieur d'une entrée sont interdites. Par convention, le
fichier de correspondances de types débute par une entrée concernant l'entité
considérée dans son ensemble (bien que ce ne soit pas obligatoire, et
ignoré si présent). Un exemple de fichier de
correspondances de types est fourni
ci-dessous.</p>
<p>Les URIs de ce fichier sont relatifs à la localisation du fichier
de correspondances de types. En général, ces fichiers se trouveront dans le
même répertoire que le fichier de correspondances de types, mais ce
n'est pas obligatoire. Vous pouvez utiliser des URIs absolus ou
relatifs pour tout fichier situé sur le même serveur que le fichier
de correspondances.</p>
<div class="example"><p><code>
URI: foo<br />
<br />
URI: foo.en.html<br />
Content-type: text/html<br />
Content-language: en<br />
<br />
URI: foo.fr.de.html<br />
Content-type: text/html;charset=iso-8859-2<br />
Content-language: fr, de<br />
</code></p></div>
<p>Notez aussi qu'un fichier de correspondances de types prend le pas sur
les extensions de noms de fichiers, même si les Multivues sont activées.
Si les variantes sont de qualités différentes, on doit l'indiquer
à l'aide du paramètre « qs » à la suite du type de média, comme pour cette
image
(disponible aux formats JPEG, GIF, ou ASCII-art) : </p>
<div class="example"><p><code>
URI: foo<br />
<br />
URI: foo.jpeg<br />
Content-type: image/jpeg; qs=0.8<br />
<br />
URI: foo.gif<br />
Content-type: image/gif; qs=0.5<br />
<br />
URI: foo.txt<br />
Content-type: text/plain; qs=0.01<br />
</code></p></div>
<p>Les valeurs de qs peuvent varier de 0.000 à 1.000. Notez que toute
variante possédant une valeur de qs de 0.000 ne sera jamais choisie.
Les variantes qui n'ont pas de paramètre qs défini se voient attribuer
une valeur de 1.0. Le paramètre qs indique la qualité relative de la
variante comparée à celle des autres variantes disponibles, sans tenir
compte des capacités du client. Par exemple, un fichier JPEG possède
en général une qualité supérieure à celle d'un fichier ASCII s'il
représente une photographie. Cependant, si la ressource représentée est
un ASCII art original, la représentation ASCII sera de meilleure qualité
que la représentation JPEG. Ainsi une valeur de qs est associée à une
variante en fonction de la nature de la ressource qu'elle représente.</p>
<p>La liste complète des en-têtes reconnus est disponible dans la
documentation sur les <a href="mod/mod_negotiation.html#typemaps">correspondances de types du
module mod_negotiation</a>.</p>
<h3><a name="multiviews" id="multiviews">Multivues (option Multiviews)</a></h3>
<p><code>MultiViews</code> est une option qui s'applique à un répertoire,
ce qui signifie qu'elle peut être activée à l'aide d'une directive
<code class="directive"><a href="./mod/core.html#options">Options</a></code> à l'intérieur d'une section
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code> ou <code class="directive"><a href="./mod/core.html#files"><Files></a></code> dans
<code>httpd.conf</code>, ou (si <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> est correctement positionnée) dans
des fichiers
<code>.htaccess</code>. Notez que <code>Options All</code>
n'active pas <code>MultiViews</code> ; vous devez activer cette option en
la nommant explicitement.</p>
<p>L'effet de <code>MultiViews</code> est le suivant : si le serveur reçoit
une requête pour <code>/tel/répertoire/foo</code>, si
<code>MultiViews</code> est activée pour
<code>/tel/répertoire</code> et si
<code>/tel/répertoire/foo</code> n'existe <em>pas</em>, le serveur parcourt
le répertoire à la recherche de fichiers nommés foo.*, et simule
littéralement une correspondance de types (type map) qui liste tous ces
fichiers, en leur associant les mêmes types de média et encodages de
contenu qu'ils auraient eu si le client avait demandé l'accès à l'un
d'entre eux par son nom. Il choisit ensuite ce qui correspond le mieux
aux besoins du client.</p>
<p><code>MultiViews</code> peut aussi s'appliquer à la recherche du fichier
nommé par la directive <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, si le serveur tente d'indexer
un répertoire. Si les fichiers de configuration spécifient</p>
<pre class="prettyprint lang-config">DirectoryIndex index</pre>
<p>le serveur va choisir entre <code>index.html</code>
et <code>index.html3</code> si les deux fichiers sont présents. Si aucun
n'est présent, alors qu’<code>index.cgi</code> existe,
le serveur l'exécutera.</p>
<p>Si, parcequ'elle n'est pas reconnue par <code>mod_mime</code>,
l'extension d'un des fichiers du répertoire ne permet pas de
déterminer son jeu de caractères, son type de contenu, son langage, ou son
encodage,
le résultat dépendra de la définition de la directive <code class="directive"><a href="./mod/mod_mime.html#multiviewsmatch">MultiViewsMatch</a></code>. Cette directive détermine
si les gestionnaires (handlers), les filtres et autres types d'extensions
peuvent participer à la négociation MultiVues.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="methods" id="methods">Les méthodes de négociation</a></h2>
<p>Une fois obtenue la liste des variantes pour une ressource donnée,
httpd dispose de deux méthodes pour choisir la meilleure variante à
renvoyer, s'il y a lieu, soit à partir d'un fichier de
correspondances de types, soit en se basant sur les noms de fichier du
répertoire. Il n'est pas nécessaire de connaître en détails comment la
négociation fonctionne réellement pour pouvoir utiliser les fonctionnalités
de négociation de contenu de httpd. La suite de ce document explique
cependant les méthodes utilisées pour ceux ou celles qui sont
intéressés(ées). </p>
<p>Il existe deux méthodes de négociation :</p>
<ol>
<li><strong>La négociation effectuée par le serveur selon l'algorithme
de httpd</strong> est utilisée par défaut. L'algorithme de
httpd est
expliqué plus en détails ci-dessous. Quand cet algorithme est utilisé,
httpd peut parfois « bricoler » le facteur de qualité (qs) d'une dimension
particulière afin d'obtenir un meilleur résultat.
La manière dont httpd peut modifier les facteurs de qualité est
expliquée plus en détails ci-dessous.</li>
<li><strong>La négociation de contenu transparente</strong> est utilisée
quand le navigateur le demande explicitement selon le mécanisme défini
dans la RFC 2295. Cette méthode de négociation donne au navigateur le
contrôle total du choix de la meilleure variante ; le résultat dépend
cependant de la spécificité des algorithmes utilisés par le navigateur.
Au cours du processus de négociation transparente, le navigateur peut
demander à httpd d'exécuter l'« algorithme de sélection de variante à
distance » défini dans la RFC 2296.</li>
</ol>
<h3><a name="dimensions" id="dimensions">Les dimensions de la négociation</a></h3>
<table>
<tr valign="top">
<th>Dimension</th>
<th>Notes</th>
</tr>
<tr valign="top">
<td>Type de média</td>
<td>Le navigateur affiche ses préférences à l'aide du champ d'en-tête
<code>Accept</code>. Chaque type de média peut se voir associé un facteur de
qualité. La description de la variante peut aussi avoir un facteur de
qualité (le paramètre « qs »).</td>
</tr>
<tr valign="top">
<td>Langage</td>
<td>Le navigateur affiche ses préférences à l'aide du champ d'en-tête
<code>Accept-Language</code>. Chaque langue peut se voir associé un facteur de
qualité. Les variantes peuvent être associées avec zéro, un ou
plusieurs langages.</td>
</tr>
<tr valign="top">
<td>Encodage</td>
<td>Le navigateur affiche ses préférences à l'aide du champ d'en-tête
<code>Accept-Encoding</code>. Chaque encodage peut se voir associé un facteur de
qualité.</td>
</tr>
<tr valign="top">
<td>Jeu de caractères</td>
<td>Le navigateur affiche ses préférences à l'aide du champ d'en-tête
<code>Accept-Charset</code>. Chaque jeu de caractère peut se voir associé un facteur de
qualité. Les variantes peuvent préciser un jeu de caractères comme
paramètre du type de média.</td>
</tr>
</table>
<h3><a name="algorithm" id="algorithm">L'algorithme de négociation de
httpd</a></h3>
<p>httpd peut utiliser l'algorithme suivant pour choisir la « meilleure »
variante (s'il y en a une) à renvoyer au navigateur. Cet algorithme n'est pas
configurable. Il fonctionne comme suit :</p>
<ol>
<li>En premier lieu, pour chaque dimension de la négociation, consulter
le champ d'en-tête <em>Accept*</em> approprié et assigner une qualité à
chaque variante. Si l'en-tête <em>Accept*</em> pour toute dimension
implique que la variante n'est pas acceptable, éliminer cette dernière.
S'il ne reste plus de variante, aller à l'étape 4.</li>
<li>
Choisir la « meilleure » variante par élimination. Chacun des tests
suivants est effectué dans cet ordre. Toute variante non sélectionnée
à l'issue d'un test est éliminée. Après chaque test, s'il reste une
seule variante, choisir cette dernière comme celle qui correspond le
mieux puis aller à l'étape 3. S'il reste plusieurs variantes, passer
au test suivant.
<ol>
<li>Multiplier le facteur de qualité de l'en-tête
<code>Accept</code> par le facteur de qualité « qs » pour le type de
média de ces variantes, et choisir la variante qui possède la valeur
la plus importante.</li>
<li>Sélectionner les variantes qui possèdent le facteur de qualité
de langage le plus haut.</li>
<li>Sélectionner les variantes dont le langage correspond le mieux,
en se basant sur l'ordre des langages de l'en-tête
<code>Accept-Language</code> (s'il existe), ou de la directive
<code>LanguagePriority</code> (si elle existe).</li>
<li>Sélectionner les variantes possédant le paramètre de média
« level » le plus élevé (utilisé pour préciser la version des types de
média text/html).</li>
<li>Sélectionner les variantes possédant le paramètre de média
« charset » (jeu de caractères) qui correspond le mieux, en se basant
sur la ligne d'en-tête <code>Accept-Charset</code> . Le jeu de
caractères ISO-8859-1 est acceptable sauf s'il est explicitement
exclus. Les variantes avec un type de média <code>text/*</code>
mais non explicitement associées avec un jeu de caractères
particulier sont supposées être en ISO-8859-1.</li>
<li>Sélectionner les variantes dont le paramètre de média « charset »
associé n'est <em>pas</em> ISO-8859-1. S'il n'en existe pas,
sélectionner toutes les variantes.</li>
<li>Sélectionner les variantes avec le meilleur encodage. S'il existe
des variantes avec un encodage acceptable pour le client,
sélectionner celles-ci. Sinon, s'il existe des variantes encodées et
des variantes non encodées, ne sélectionner que les variantes non
encodées. Si toutes les variantes sont encodées ou si aucune
ne l'est, sélectionner toutes les variantes.</li>
<li>Sélectionner les variantes dont le contenu a la longueur
la plus courte.</li>
<li>Sélectionner la première des variantes restantes. Il s'agira
soit de la première variante listée dans le fichier de
correspondances de types, soit, quand les variantes sont lues depuis
le répertoire, la première par ordre alphabétique quand elles sont
triées selon le code ASCII.</li>
</ol>
</li>
<li>L'algorithme a maintenant sélectionné une variante considérée comme
la « meilleure », il la renvoie donc au client en guise de réponse.
L'en-tête HTTP <code>Vary</code> de la réponse est renseigné de façon à
indiquer les dimensions de la négociation (les navigateurs et les caches
peuvent utiliser cette information lors de la mise en cache de la
ressource). Travail terminé.</li>
<li>Le passage par cette étape signifie qu'aucune variante n'a été
sélectionnée (parce qu'aucune n'est acceptable pour le navigateur).
Envoyer une réponse avec un code de statut 406 (qui signifie « Aucune
représentation acceptable ») et un corps comportant un document HTML qui
affiche les variantes disponibles. Renseigner aussi l'en-tête HTTP
<code>Vary</code> de façon à indiquer les dimensions de la variante.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="better" id="better">Ajustement des valeurs de qualité</a></h2>
<p>Parfois httpd modifie les valeurs de qualité par rapport à celles qui
découleraient d'une stricte interprétation de l'algorithme de négociation
de httpd ci-dessus, cela afin d’améliorer les résultats de l'algorithme pour
les navigateurs qui envoient des informations incomplètes ou inappropriées.
Certains des navigateurs les plus populaires envoient des informations dans
l'en-tête <code>Accept</code> qui, sans ce traitement, provoqueraient la
sélection d'une variante inappropriée dans de nombreux cas. Quand un
navigateur envoie des informations complètes et correctes ces ajustements
ne sont pas effectués.</p>
<h3><a name="wildcards" id="wildcards">Types de média et caractères génériques</a></h3>
<p>L'en-tête de requête <code>Accept:</code> indique les types de média
souhaités. Il peut aussi contenir des types de média avec caractères
génériques, comme « image/* » ou « */* » où * correspond à n'importe quelle
chaîne de caractères. Ainsi une requête contenant :</p>
<div class="example"><p><code>Accept: image/*, */*</code></p></div>
<p>indiquerait que tout type de média est acceptable, avec une préférence
pour les types commençant par « image/ ».
Certains navigateurs ajoutent par défaut des types de média avec caractères
génériques aux types explicitement nommés qu'ils peuvent gérer.
Par exemple :</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*
</code></p></div>
<p>Cela indique que les types explicitement listés sont préférés, mais
qu'une représentation avec un type différent de ces derniers conviendra
aussi. Les valeurs de qualités explicites,
afin de préciser ce que veut vraiment le navigateur, s'utilisent
comme suit :</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*; q=0.01
</code></p></div>
<p>Les types explicites n'ont pas de facteur de qualité, la valeur par
défaut de leur préférence est donc de 1.0 (la plus haute). Le type avec
caractères génériques */* se voit attribuer une préférence basse de 0.01,
si bien que les types autres que ceux explicitement listés ne seront
renvoyés
que s'il n'existe pas de variante correspondant à un type explicitement
listé.</p>
<p>Si l'en-tête <code>Accept:</code> ne contient <em>pas</em> de
facteur de qualité, httpd positionne la valeur de qualité de
« */* », si présent, à 0.01 pour simuler l'effet désiré. Il positionne aussi
la valeur de qualité des types avec caractères génériques au format
« type/* » à 0.02 (ils sont donc préférés à ceux correspondant à « */* »). Si
un type de média dans l'en-tête <code>Accept:</code> contient un facteur de
qualité, ces valeurs spéciales ne seront <em>pas</em> appliquées, de façon
à ce que les requêtes de navigateurs qui envoient les informations
explicites à prendre en compte fonctionnent comme souhaité.</p>
<h3><a name="exceptions" id="exceptions">Exceptions dans la négociation du
langage</a></h3>
<p>A partir de la version 2.0 de httpd, certaines exceptions ont été
ajoutées à l'algorithme de négociation afin de ménager une issue de secours
quand la négociation ne trouve aucun langage correspondant.</p>
<p>Quand un client demande une page sur votre serveur, si ce dernier ne
parvient pas à trouver une page dont la langue correspond à l'en-tête
<code>Accept-language</code> envoyé par le navigateur, il enverra au client
une réponse « Aucune variante acceptable » ou « Plusieurs choix possibles ».
Pour éviter ces
messages d'erreur, il est possible de configurer httpd de façon que,
dans ces cas, il ignore l'en-tête <code>Accept-language</code> et fournisse
tout de même un document, même s'il ne correspond pas exactement à la
demande explicite du client. La directive <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code>
peut être utilisée pour éviter ces messages d'erreur et leur substituer une
page dont le langage sera déterminé en fonction du contenu de la directive
<code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>.</p>
<p>Le serveur va aussi essayer d'étendre sa recherche de correspondance aux
sous-ensembles de langages quand aucune correspondance exacte ne peut être
trouvée. Par exemple, si un client demande des documents possédant le
langage <code>en-GB</code>, c'est à dire anglais britannique, le standard
HTTP/1.1 n'autorise normalement pas le serveur à faire correspondre cette
demande à un document dont le langage est simplement <code>en</code>
(notez qu'inclure <code>en-GB</code> et non <code>en</code> dans l'en-tête
<code>Accept-Language</code> constitue une quasi-erreur de configuration,
car il est très peu probable qu'un lecteur qui comprend l'anglais
britannique, ne comprenne pas l'anglais en général. Malheureusement, de
nombreux clients ont réellement des configurations par défaut de ce type).
Cependant, si aucune autre correspondance de langage n'est possible, et si le
serveur est sur le point de renvoyer une erreur « Aucune variable
acceptable » ou de choisir le langage défini par la directive <code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>, le serveur ignorera
la spécification du sous-ensemble de langage et associera la demande en
<code>en-GB</code> à des documents en <code>en</code>. Implicitement,
httpd ajoute le langage parent à la liste de langages acceptés par le
client avec une valeur de qualité très basse. Notez cependant que si le
client demande « en-GB; q=0.9, fr; q=0.8 », et si le serveur dispose de
documents estampillés « en » et « fr », c'est le document « fr » qui sera
renvoyé, tout cela dans un souci de compatibilité avec la spécification
HTTP/1.1 et afin de fonctionner efficacement avec les clients
correctement configurés.</p>
<p>Pour prendre en charge les techniques avancées (comme les cookies ou les chemins
d'URL spéciaux) afin de déterminer le langage préféré de l'utilisateur, le
module <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> reconnaît la
<a href="env.html">variable d'environnement</a>
<code>prefer-language</code>
depuis la version 2.0.47 de httpd. Si elle est définie et contient un
symbole de langage approprié, <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> va essayer
de sélectionner une variante correspondante. S'il n'existe pas de telle
variante, le processus normal de négociation sera lancé.</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">SetEnvIf Cookie "language=(.+)" prefer-language=$1
Header append Vary cookie</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="extensions" id="extensions">Extensions à la négociation de contenu
transparente</a></h2>
<p>httpd étend le protocole de négociation de contenu transparente (RFC
2295) comme suit. Un nouvel élément <code>{encodage ..}</code> est utilisé dans
les listes de variantes pour marquer celles qui ne sont disponibles qu'avec un
encodage de contenu spécifique. L'implémentation de l'algorithme
RVSA/1.0 (RFC 2296) est étendue à la reconnaissance de variantes encodées dans
la liste, et à leur utilisation en tant que variantes candidates à partir du
moment où leur encodage satisfait au contenu de l'en-tête de requête
<code>Accept-Encoding</code>. L'implémentation RVSA/1.0 n'arrondit pas les
facteurs de qualité calculés à 5 décimales avant d'avoir choisi la meilleure
variante.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="naming" id="naming">Remarques à propos des liens hypertextes et des
conventions de nommage</a></h2>
<p>Si vous utilisez la négociation de langage, vous avez le choix entre
différentes conventions de nommage, car les fichiers peuvent posséder
plusieurs extensions, et l'ordre dans lequel ces dernières apparaissent
est en général sans rapport (voir la documentation sur le module <a href="mod/mod_mime.html#multipleext">mod_mime</a>
pour plus de détails).</p>
<p>Un fichier type possède une extension liée au type MIME
(<em>par exemple</em>, <code>html</code>), mais parfois aussi une
extension liée à l'encodage (<em>par exemple</em>, <code>gz</code>),
et bien sûr une extension liée au langage
(<em>par exemple</em>, <code>en</code>) quand plusieurs variantes de
langage sont disponibles pour ce fichier.</p>
<p>Exemples :</p>
<ul>
<li>foo.en.html</li>
<li>foo.html.en</li>
<li>foo.en.html.gz</li>
</ul>
<p>Ci-dessous d'autres exemples de noms de fichiers avec des liens
hypertextes valables et non valables :</p>
<table class="bordered">
<tr>
<th>Nom fichier</th>
<th>lien valide</th>
<th>Lien invalide</th>
</tr>
<tr>
<td><em>foo.html.en</em></td>
<td>foo<br />
foo.html</td>
<td>-</td>
</tr>
<tr>
<td><em>foo.en.html</em></td>
<td>foo</td>
<td>foo.html</td>
</tr>
<tr>
<td><em>foo.html.en.gz</em></td>
<td>foo<br />
foo.html</td>
<td>foo.gz<br />
foo.html.gz</td>
</tr>
<tr>
<td><em>foo.en.html.gz</em></td>
<td>foo</td>
<td>foo.html<br />
foo.html.gz<br />
foo.gz</td>
</tr>
<tr>
<td><em>foo.gz.html.en</em></td>
<td>foo<br />
foo.gz<br />
foo.gz.html</td>
<td>foo.html</td>
</tr>
<tr>
<td><em>foo.html.gz.en</em></td>
<td>foo<br />
foo.html<br />
foo.html.gz</td>
<td>foo.gz</td>
</tr>
</table>
<p>En regardant la table ci-dessus, vous remarquerez qu'il est toujours
possible d'utiliser le nom de fichier sans extension dans un lien
(<em>par exemple</em>, <code>foo</code>). L'avantage est de pouvoir
dissimuler le type réel du fichier associé à un document et de pouvoir
le modifier
ultérieurement, <em>par exemple</em>, de <code>html</code> à
<code>shtml</code> ou <code>cgi</code> sans avoir à
mettre à jour aucun lien.</p>
<p>Si vous souhaitez continuer à utiliser un type MIME dans vos liens
(<em>par exemple </em> <code>foo.html</code>), l'extension liée au langage
(y compris une extension liée à l'encodage s'il en existe une)
doit se trouver à droite de l'extension liée au type MIME
(<em>par exemple</em>, <code>foo.html.en</code>).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="caching" id="caching">Remarque sur la mise en cache</a></h2>
<p>Quand un cache stocke une représentation, il l'associe avec l'URL de la
requête. Lorsque cette URL est à nouveau demandée, le cache peut utiliser
la représentation stockée. Cependant, si la ressource est négociable au
niveau du serveur, il se peut que seule la première variante demandée soit
mise en cache et de ce fait, la correspondance positive du cache peut
entraîner une réponse inappropriée. Pour
éviter cela, httpd marque par
défaut toutes les réponses qui sont renvoyées après une négociation de
contenu comme « non-cachables » par les clients HTTP/1.0. httpd prend
aussi en charge les fonctionnalités du protocole HTTP/1.1 afin de permettre la mise
en cache des réponses négociées.</p>
<p>Pour les requêtes en provenance d'un client compatible HTTP/1.0
(un navigateur ou un cache), la directive <code class="directive"><a href="./mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code> peut être utilisée
pour permettre la mise en cache des réponses qui ont fait l'objet d'une
négociation. Cette directive peut intervenir dans la configuration au
niveau du serveur ou de l'hôte virtuel, et n'accepte aucun argument. Elle
n'a aucun effet sur les requêtes en provenance de clients HTTP/1.1.</p>
<p>Pour les clients HTTP/1.1, httpd envoie un en-tête de réponse HTTP
<code>Vary</code> afin d'indiquer les dimensions de la négociation pour
cette réponse. Les caches peuvent
utiliser cette information afin de déterminer
si une requête peut être servie à partir de la copie locale. Pour inciter
un cache à utiliser la copie locale sans tenir compte des dimensions de la
négociation, définissez la
<a href="env.html#special">variable d'environnement</a>
<code>force-no-vary</code>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/content-negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/content-negotiation.html" title="Français"> fr </a> |
<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/content-negotiation.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/env.html.fr.utf8 0000664 0001751 0001751 00000103340 14740503670 020007 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache httpd et les variables d'environnement - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache httpd et les variables d'environnement</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/env.html" title="Français"> fr </a> |
<a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Deux types de variables d'environnement affectent le serveur
HTTP Apache.</p>
<p>Le premier type correspond aux variables d'environnement
contrôlées par le système d'exploitation sous-jacent et définies
avant le démarrage du serveur. Leurs valeurs peuvent être utilisées
directement dans les fichiers de configuration, et peuvent
éventuellement être transmises aux scripts CGI et SSI à l’aide de la
directive PassEnv.</p>
<p>Le second type correspond aux variables nommées appelées aussi
<em>variables d'environnement</em> dans lesquelles le serveur HTTP
Apache stocke des informations via un mécanisme spécial. Ces
informations peuvent servir à contrôler diverses opérations comme
l'enregistrement des traces ou le contrôle d'accès. On utilise aussi ces
variables dans le mécanisme de communication avec les programmes externes
comme les scripts CGI. Ce document présente différentes méthodes pour
manipuler et utiliser ces variables.</p>
<p>Bien que ces variables soient référencées comme <em>variables
d'environnement</em>, il ne faut pas les confondre avec les variables
d'environnement contrôlées par le système d'exploitation sous-jacent.
En fait, ces variables sont stockées et manipulées dans une structure
interne à Apache httpd. Elles ne deviennent de véritables variables
d'environnement du système d'exploitation que lorsqu'elles sont mises à la
disposition de scripts CGI et de scripts inclus côté serveur (SSI). Si vous
souhaitez manipuler l'environnement du système d'exploitation sous lequel
le serveur s'exécute, vous devez utiliser les mécanismes standards de
manipulation de l'environnement fournis par l'interpréteur de commandes
(shell) de votre système d'exploitation.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#setting">Définition des variables d'environnement</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Utilisation des variables d'environnement</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#special">Variables d'environnement à usage spécial</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Exemples</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="setting" id="setting">Définition des variables d'environnement</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr></table>
<h3><a name="basic-manipulation" id="basic-manipulation">Manipulations de base de l'environnement</a></h3>
<p>La méthode la plus élémentaire pour définir une variable
d'environnement au niveau d'Apache httpd consiste à utiliser la directive
inconditionnelle <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code>. Les variables peuvent aussi être transmises depuis
l'environnement du shell à partir duquel le serveur a été démarré en
utilisant la directive
<code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code>.</p>
<h3><a name="conditional" id="conditional">Définitions conditionnelles en fonction des requêtes</a></h3>
<p>Pour plus de souplesse, les directives fournies par le module
<code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> permettent de définir les
variables d'environnement en tenant compte des caractéristiques
de chaque requête. Par exemple, une
variable pourrait n'être définie que lorsqu'un navigateur spécifique
(User-Agent) a généré la requête, ou seulement quand un en-tête
Referer particulier est présent. La directive
<code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> du module
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> qui utilise l'option
<code>[E=...]</code> pour définir
les variables d'environnement apporte encore plus de souplesse.</p>
<h3><a name="unique-identifiers" id="unique-identifiers">Identifiants uniques</a></h3>
<p>Finalement, le module <code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code> définit la variable
d'environnement <code>UNIQUE_ID</code> pour chaque requête à une valeur
qui est garantie unique parmi « toutes » les requêtes sous des
conditions très spécifiques.</p>
<h3><a name="standard-cgi" id="standard-cgi">Variables CGI standards</a></h3>
<p>En plus de l'ensemble des variables d'environnement internes à la
configuration d'Apache httpd et de celles transmises depuis le shell,
les scripts CGI et les pages SSI
se voient affectés un ensemble de variables
d'environnement contenant des méta-informations à propos de la requête
comme préconisé dans la
<a href="http://www.ietf.org/rfc/rfc3875">spécification
sur les CGIs</a>.</p>
<h3><a name="caveats" id="caveats">Quelques mises en garde</a></h3>
<ul>
<li>Les directives de manipulation de l'environnement ne permettent
pas de supplanter ou modifier les variables CGI standards.</li>
<li>Lorsqu'on utilise <code class="program"><a href="./programs/suexec.html">suexec</a></code> pour exécuter des
scripts CGI, l'environnement est nettoyé et réduit à un ensemble de
variables <em>sûres</em> avant l'exécution du script. La liste des
variables <em>sûres</em> est définie à la compilation dans
<code>suexec.c</code>.</li>
<li>Pour des raisons de portabilité, les noms des variables
d'environnement ne peuvent contenir que des lettres, des chiffres et
le caractère « souligné ». En outre, le premier caractère ne doit pas
être un chiffre. Les caractères qui ne satisfont pas à ces conditions
seront remplacés par un caractère « souligné » quand ils seront
transmis aux scripts CGI et aux pages SSI.</li>
<li>Les contenus d'en-têtes HTTP transmis aux scripts de type
CGI ou autre à l’aide de variables d'environnement constituent un
cas particulier (voir plus loin). Leur nom est converti en
majuscules et seuls les tirets sont remplacés par des
caractères '_' (« souligné ») ; si le format du nom de l'en-tête
n'est pas valide, celui-ci est ignoré. Voir <a href="#fixheader">plus loin</a> pour une solution de
contournement du problème.</li>
<li>La directive <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> s'exécute assez tard au
cours du traitement de la requête, ce qui signifie que des
directives telles que <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> et <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> ne verront pas
les variables qu'elle aura définies.</li>
<li>Lorsque le serveur cherche un chemin via une <a class="glossarylink" href="./glossary.html#subrequest" title="voir glossaire">sous-requête</a> interne (par exemple la
recherche d'un <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>), ou lorsqu'il génère un
listing du contenu d'un répertoire à l’aide du module
<code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code>, la sous-requête n'hérite pas des
variables d'environnement spécifiques à la requête. En outre, à cause
des phases de l'API auxquelles <code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> prend
part, les directives <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> ne sont pas évaluées
séparément dans la sous-requête.</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="using" id="using">Utilisation des variables d'environnement</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</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_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code></li><li><code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr></table>
<h3><a name="cgi-scripts" id="cgi-scripts">Scripts CGI</a></h3>
<p>La communication d'informations aux scripts CGI constitue une des
principales utilisations des variables d'environnement. Comme indiqué
plus haut, l'environnement transmis aux scripts CGI comprend des
méta-informations standards à propos de la requête, en plus des
variables définies dans la configuration d'Apache httpd. Pour plus de
détails, se référer au
<a href="howto/cgi.html">tutoriel CGI</a>.</p>
<h3><a name="ssi-pages" id="ssi-pages">Pages SSI</a></h3>
<p>Les documents inclus côté serveur (SSI) traités par le filtre
<code>INCLUDES</code> du module <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>,
peuvent afficher les
variables d'environnement à l'aide de l'élément <code>echo</code>,
et peuvent utiliser des variables d'environnement dans les éléments
de contrôle de flux pour rendre certaines parties d'une page
conditionnelles en fonction des caractéristiques de la requête.
Apache httpd fournit aussi les variables d'environnement CGI standards
aux pages SSI
comme indiqué plus haut. Pour plus de détails, se référer au
<a href="howto/ssi.html">tutoriel SSI</a>.</p>
<h3><a name="access-control" id="access-control">Contrôle d'accès</a></h3>
<p>L'accès au serveur peut être contrôlé en fonction de la valeur de
variables d'environnement à l'aide des directives
<code>Require env</code> et <code>Require not env</code>.
En association avec la directive
<code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, cela confère une
grande souplesse au contrôle d'accès au serveur en fonction des
caractéristiques du client. Par exemple, vous pouvez utiliser ces
directives pour interdire l'accès depuis un navigateur particulier
(User-Agent).
</p>
<h3><a name="logging" id="logging">Enregistrement conditionnel des traces</a></h3>
<p>Les variables d'environnement peuvent être enregistrées dans le
fichier de log des accès à l'aide de l'option <code>%e</code> de la
directive <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>.
En outre, la décision de tracer ou non les requêtes peut être prise
en fonction de l'état de variables d'environnement en utilisant la
forme conditionnelle de la directive
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>. En
association avec la directive <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, cela confère une grande souplesse au contrôle
du traçage des requêtes. Par exemple, vous pouvez choisir de ne pas
tracer les requêtes pour des noms de fichiers se terminant par
<code>gif</code>, ou encore de ne tracer que les requêtes des clients
n'appartenant pas à votre sous-réseau.</p>
<h3><a name="response-headers" id="response-headers">En-têtes de réponse conditionnels</a></h3>
<p>La directive <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>
peut se baser sur la présence ou l'absence d'une variable
d'environnement pour décider si un certain en-tête HTTP sera placé
dans la réponse au client. Cela permet, par exemple, de n'envoyer un
certain en-tête de réponse que si un en-tête correspondant est présent
dans la requête du client.</p>
<h3><a name="external-filter" id="external-filter">Activation de filtres externes</a></h3>
<p>Les filtres externes configurés par le module
<code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> à l'aide de la directive <code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code> peuvent être
activés de manière conditionnelle en fonction d'une variable
d'environnement à l'aide des options
<code>disableenv=</code> et <code>enableenv=</code>.</p>
<h3><a name="url-rewriting" id="url-rewriting">Réécriture d'URL</a></h3>
<p>La forme <code>%{ENV:<em>variable</em>}</code> de
<em>TestString</em> dans la
directive <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
permet au moteur de réécriture du module
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> de prendre des
décisions conditionnées par des variables d'environnement.
Notez que les variables accessibles dans
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> sans le préfixe
<code>ENV:</code> ne sont pas de véritables variables
d'environnement. Ce sont plutôt des variables spécifiques à
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
qui ne sont pas accessibles pour les autres modules.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="special" id="special">Variables d'environnement à usage spécial</a></h2>
<p>Des problèmes d'interopérabilité ont conduit à l'introduction de
mécanismes permettant de modifier le comportement d'Apache httpd lorsqu'il
dialogue avec certains clients. Afin de rendre ces mécanismes aussi
souples que possible, ils sont invoqués en définissant des variables
d'environnement, en général à l'aide de la directive
<code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, bien que les
directives <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> et
<code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> puissent aussi être
utilisées, par exemple.</p>
<h3><a name="downgrade" id="downgrade">downgrade-1.0</a></h3>
<p>Cela force le traitement d'une requête comme une requête HTTP/1.0
même si elle a été rédigée dans un langage plus récent.</p>
<h3><a name="force-gzip" id="force-gzip">force-gzip</a></h3>
<p>Si le filtre <code>DEFLATE</code> est activé, cette variable
d'environnement ignorera les réglages accept-encoding de votre
navigateur et enverra une sortie compressée inconditionnellement.</p>
<h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3>
<p>Cette variable entraîne la suppression de tout champ
<code>Vary</code> des en-têtes de la réponse avant que cette dernière
soit renvoyée au client. Certains clients n'interprètent pas ce champ
correctement, et la définition de cette variable permet de contourner
ce problème, mais implique aussi la définition de
<strong>force-response-1.0</strong>.</p>
<h3><a name="force-response" id="force-response">force-response-1.0</a></h3>
<p>Cette variable force une réponse en langage HTTP/1.0 aux clients
qui envoient des requêtes dans le même langage. Elle fut implémentée à
l'origine suite à des problèmes avec les mandataires d'AOL. Certains
clients en langage HTTP/1.0 ne réagissent pas correctement face à une
réponse en langage HTTP/1.1, et cette variable peut être utilisée pour
assurer l'interopérabilité avec eux.</p>
<h3><a name="gzip-only-text-html" id="gzip-only-text-html">gzip-only-text/html</a></h3>
<p>Positionnée à « 1 », cette variable désactive le filtre en sortie
<code>DEFLATE</code> fourni par le module <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> pour les
types de contenu autres que <code>text/html</code>. Si vous préférez
utiliser des fichiers compressés statiquement,
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> évalue aussi la variable (non
seulement pour gzip, mais aussi pour tous les encodages autres que
« identity »).</p>
<h3><a name="no-gzip" id="no-gzip">no-gzip</a></h3>
<p>Quand cette variable est définie, le filtre <code>DEFLATE</code> du
module <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> est désactivé, et
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> refusera de délivrer des ressources
encodées.</p>
<h3><a name="no-cache" id="no-cache">no-cache</a></h3>
<p><em>Disponible dans les versions 2.2.12 et ultérieures d'Apache httpd</em></p>
<p>Lorsque cette variable est définie,
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> ne sauvegardera pas de réponse
susceptible d'être mise en cache. Cette variable d'environnement
n'a aucune incidence sur le fait qu'une réponse déjà enregistrée
dans le cache soit utilisée ou non pour la requête courante.</p>
<h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
<p>Quand cette variable est définie, la directive
<code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code> est désactivée.</p>
<h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3>
<p>Cette variable modifie le comportement du module
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>. Si elle contient un symbole de
langage (tel que <code>en</code>, <code>ja</code>
ou <code>x-klingon</code>), <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> essaie de
délivrer une variante dans ce langage. S'il n'existe pas de telle
variante, le processus normal de
<a href="content-negotiation.html">négociation</a> s'applique.</p>
<h3><a name="redirect-carefully" id="redirect-carefully">redirect-carefully</a></h3>
<p>Cette variable force le serveur à être plus prudent lors de l'envoi
d'une redirection au client. Elle est en général utilisée quand un
client présente un problème connu avec les redirections. Elle fut
implémentée à l'origine suite a un problème rencontré avec le logiciel
WebFolders de Microsoft qui ne gère pas correctement les redirections
vers des ressources de type répertoire via des méthodes DAV.</p>
<h3><a name="suppress-error-charset" id="suppress-error-charset">suppress-error-charset</a></h3>
<p><em>Disponible dans les versions postérieures à 2.0.54</em></p>
<p>Quand Apache httpd génère une redirection en réponse à une requête client,
la réponse inclut un texte destiné à être affiché au cas où le client ne
suivrait pas, ou ne pourrait pas suivre automatiquement la redirection.
Habituellement, Apache httpd marque ce texte en accord avec le jeu de caractères
qu'il utilise, à savoir ISO-8859-1.</p>
<p> Cependant, si la redirection fait référence à une page qui utilise un
jeu de caractères différent, certaines versions de navigateurs obsolètes
essaieront d'utiliser le jeu de caractères du texte de la redirection
plutôt que celui de la page réelle.
Cela peut entraîner, par exemple, un rendu incorrect du Grec.</p>
<p>Si cette variable d'environnement est définie, Apache httpd omettra le jeu de
caractères pour le texte de la redirection, et les navigateurs obsolètes
précités utiliseront correctement celui de la page de destination.</p>
<div class="warning">
<h3>Note concernant la sécurité</h3>
<p>L'envoi de pages d'erreur sans spécifier un jeu de caractères peut
conduire à des attaques de type "cross-site-scripting" pour les
navigateurs qui ne respectent pas la spécification HTTP/1.1 (MSIE) et
tentent de déduire le jeu de caractères à partir du contenu. De tels
navigateurs peuvent être facilement trompés et utiliser le jeu de
caractères UTF-7 ; les contenus des données en entrée de type UTF-7
(comme les URI de requête) ne seront alors plus protégés par les
mécanismes d'échappement usuels conçus pour prévenir les attaques
de type "cross-site-scripting".</p>
</div>
<h3><a name="proxy" id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked,
proxy-sendcl, proxy-chain-auth, proxy-interim-response, proxy-initial-not-pooled</a></h3>
<p>Ces directives modifient le comportement protocolaire du module
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>. Voir la documentation sur
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> et <code class="module"><a href="./mod/mod_proxy_http.html">mod_proxy_http</a></code> pour plus de détails.</p>
<h3><a name="cgilike" id="cgilike">ap_trust_cgilike_cl</a></h3>
<p><em>Disponible à partir de la version 2.4.59 du serveur HTTP Apache</em></p>
<p>Cette variable permet à un script qui s’exécute dans un module de type CGI
de fournir son propre en-tête de réponse HTTP Content-Length. Elle ne doit
être définie que dans les sections de configuration qui contiennent des
scripts de confiance.</p>
</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">Exemples</a></h2>
<h3><a name="fixheader" id="fixheader">Transmission du contenu d'en-têtes non valides aux scripts
CGI</a></h3>
<p>Avec la version 2.4, Apache httpd est plus strict avec la conversion
des en-têtes HTTP en variables d'environnement dans
<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code> et d'autres modules : dans les versions
précédentes, tout caractère non valable dans les noms d'en-têtes
était tout simplement remplacé par un caractère '_', ce qui
pouvait exposer à des attaques de type cross-site-scripting via
injection d'en-têtes (voir <a href="http://events.ccc.de/congress/2007/Fahrplan/events/2212.en.html">Bogues
du Web inhabituelles</a>, planche 19/20).</p>
<p>Si vous devez prendre en charge un client qui envoie des en-têtes non
conformes et si ceux-ci ne peuvent pas être corrigés, il existe
une solution de contournement simple mettant en jeu les modules
<code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> et <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code>,
et permettant de prendre en compte ces en-têtes :</p>
<pre class="prettyprint lang-config"># L'exemple suivant montre comment prendre en compte un en-tête<br />
# Accept_Encoding non conforme envoyé par un client.
#
SetEnvIfNoCase ^Accept.Encoding$ ^(.*)$ fix_accept_encoding=$1
RequestHeader set Accept-Encoding %{fix_accept_encoding}e env=fix_accept_encoding</pre>
<h3><a name="misbehaving" id="misbehaving">Modification du comportement protocolaire face à des clients
réagissant de manière non conforme</a></h3>
<p>Les versions antérieures recommandaient l'ajout de ces lignes dans
httpd.conf pour tenir compte de problèmes connus avec certains clients.
Comme les clients concernés sont maintenant très peu utilisés, cet
ajout n'est pratiquement plus nécessaire.</p>
<pre class="prettyprint lang-config">#
# The following directives modify normal HTTP response behavior.
# The first directive disables keepalive for Netscape 2.x and browsers that
# spoof it. There are known problems with these browser implementations.
# The second directive is for Microsoft Internet Explorer 4.0b2
# which has a broken HTTP/1.1 implementation and does not properly
# support keepalive when it is used on 301 or 302 (redirect) responses.
#
BrowserMatch "Mozilla/2" nokeepalive
BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
#
# The following directive disables HTTP/1.1 responses to browsers which
# are in violation of the HTTP/1.0 spec by not being able to grok a
# basic 1.1 response.
#
BrowserMatch "RealPlayer 4\.0" force-response-1.0
BrowserMatch "Java/1\.0" force-response-1.0
BrowserMatch "JDK/1\.0" force-response-1.0</pre>
<h3><a name="no-img-log" id="no-img-log">Ne pas tracer les requêtes pour des images dans le fichier de
trace des accès</a></h3>
<p>Dans cet exemple, les requêtes pour des images n'apparaissent pas
dans le fichier de trace des accès. Il peut être facilement adapté pour
empêcher le traçage de répertoires particuliers, ou de requêtes
en provenance de certains hôtes.</p>
<pre class="prettyprint lang-config">SetEnvIf Request_URI \.gif image-request
SetEnvIf Request_URI \.jpg image-request
SetEnvIf Request_URI \.png image-request
CustomLog "logs/access_log" common env=!image-request</pre>
<h3><a name="image-theft" id="image-theft">Prévention du « Vol d'image »</a></h3>
<p>Cet exemple montre comment empêcher les utilisateurs ne faisant pas
partie de votre serveur d'utiliser des images de votre serveur comme
images en ligne dans leurs pages. Cette configuration n'est pas
recommandée, mais elle peut fonctionner dans des circonstances bien
définies. Nous supposons que toutes vos images sont enregistrées dans
un répertoire nommé <code>/web/images</code>.</p>
<pre class="prettyprint lang-config">SetEnvIf Referer "^http://www\.example\.com/" local_referal
# Autorise les navigateurs qui n'envoient aucune information de Referer
SetEnvIf Referer "^$" local_referal
<Directory "/web/images">
Require env local_referal
</Directory></pre>
<p>Pour plus d'informations sur cette technique, voir le tutoriel sur
ServerWatch
"<a href="https://www.serverwatch.com/guides/keeping-your-images-from-adorning-other-sites/">Keeping Your Images from Adorning Other Sites</a>".</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/env.html" title="Français"> fr </a> |
<a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/env.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/getting-started.html.fr.utf8 0000664 0001751 0001751 00000042322 14740503670 022326 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Pour démarrer - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Pour démarrer</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/getting-started.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/getting-started.html" title="Français"> fr </a> |
<a href="./ru/getting-started.html" hreflang="ru" rel="alternate" title="Russian"> ru </a></p>
</div>
<p>Si vous ne connaissez rien au serveur HTTP Apache, ou même au
fonctionnement d'un site web, vous vous demandez probablement par où
commencer et quelles questions poser. Ce document vous permettra de
parcourir les bases du sujet.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#clientserver">Clients, serveurs et URLs</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#dns">Noms d'hôte et DNS</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configuration">Fichiers de configuration et directives</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#content">Contenu du site web</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#logs">Fichiers journaux et résolution des problèmes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">Et maintenant, comment faire pour aller plus loin ?</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="clientserver" id="clientserver">Clients, serveurs et URLs</a></h2>
<p>
Les adresses des pages web sur la Toile se présentent sous forme d'URLs
- Uniform Resource Locators - qui comportent un protocole (par
exemple <code>http</code>), un nom de serveur (par exemple
<code>www.apache.org</code>), un chemin (par exemple
<code>/docs/current/getting-started.html</code>), et le cas échéant
une chaîne de paramètres (query string) (par exemple <code>?arg=value</code>)
permettant de transmettre des informations supplémentaires au serveur.
</p>
<p>Un client (par exemple un navigateur web) se connecte à un serveur
(par exemple votre serveur HTTP Apache) avec un protocole spécifique, et
effectue une <strong>requête</strong> pour une ressource en spécifiant
son chemin.</p>
<p>Un chemin peut représenter plusieurs types de ressources sur le
serveur. Il peut s'agir d'un fichier (comme
<code>getting-started.html</code>), d'un gestionnaire (comme <a href="mod/mod_status.html">server-status</a>) ou d'une sorte quelconque de
programme (comme <code>index.php</code>). Nous décrirons tout cela plus
en détails ci-dessous dans la section <a href="#content">Contenu d'un
site web</a>.</p>
<p>
Le serveur envoie alors une <strong>réponse</strong> comportant un code
d'état, et éventuellement un corps de réponse. Le code d'état indique si
la requête a été traitée avec succès, ou dans la négative, quel type
d'erreur a été rencontré. Le client est alors censé savoir quoi faire de
la réponse. Vous pouvez vous familiariser avec les différents codes
d'état en consultant le <a href="http://wiki.apache.org/httpd/CommonHTTPStatusCodes">Wiki du
serveur HTTP Apache</a>.</p>
<p>Les détails de la transaction, ainsi que les erreurs rencontrées,
sont enregistrés dans des fichiers journaux. Tout cela est décrit en
détails ci-dessous dans la section <a href="#logs">Débogage et fichiers
journaux</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="dns" id="dns">Noms d'hôte et DNS</a></h2>
<p>Pour se connecter à un serveur, le client doit tout d'abord traduire
le nom du serveur en adresse IP, cette dernière permettant de localiser
le serveur sur Internet. Ainsi, pour que votre serveur web soit
accessible, son nom doit être enregistré dans le DNS.</p>
<p>Si vous ne savez pas comment effectuer cet enregistrement, vous
devez contacter votre administrateur réseau ou votre fournisseur
d'accès à Internet afin qu'il effectue cette opération pour vous.</p>
<p>Plusieurs noms d'hôte peuvent pointer vers la même adresse IP, et
plusieurs adresses IP peuvent être attachées au même serveur physique.
Vous pouvez ainsi héberger plusieurs serveurs web sur le même serveur
physique grâce au mécanisme des <a href="vhosts/">serveurs virtuels</a>.</p>
<p>Pour tester un serveur non encore accessible sur Internet, vous
pouvez renseigner son nom d'hôte dans votre fichier hosts afin
d'effectuer une résolution de nom locale. Par exemple, pour tester le
serveur web <code>www.example.com</code> depuis le serveur physique qui
l'héberge, vous pouvez ajouter la ligne suivante au fichier hosts de ce
dernier : </p>
<div class="example"><p><code>
127.0.0.1 www.example.com
</code></p></div>
<p>En général, le fichier hosts se trouve dans le répertoire
<code>/etc</code> sur les systèmes de style Unix, ou
<code>C:\Windows\system32\drivers\etc</code> sous Windows.</p>
<p>Vous trouverez plus de détails à propos du fichier hosts à <a href="http://en.wikipedia.org/wiki/Hosts_(file)">Wikipedia.org/wiki/Hosts_(file)</a>,
et à propos du DNS à <a href="http://en.wikipedia.org/wiki/Domain_Name_System">Wikipedia.org/wiki/Domain_Name_System</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuration" id="configuration">Fichiers de configuration et directives</a></h2>
<p>La configuration du serveur HTTP Apache s'effectue via de simples
fichiers texte. Ces fichiers peuvent se trouver dans de nombreux
endroits différents en fonction du mode d'installation du serveur. Vous
trouverez les positions courantes de ces fichiers dans le <a href="http://wiki.apache.org/httpd/DistrosDefaultLayout">wiki httpd</a>.
Si vous installez httpd depuis le code source, le répertoire par défaut
des fichiers de configuration est <code>/usr/local/apache2/conf</code>.
Le nom du fichier de configuration par défaut est en général
<code>httpd.conf</code>, mais peut aussi varier en fonction des
distributions tierces du serveur.</p>
<p>L'ensemble de la configuration est en général divisé en plusieurs
fichiers afin d'en faciliter la gestion. Ces fichiers sont inclus dans
le fichier de configuration principal via la directive <code class="directive"><a href="./mod/core.html#include">Include</a></code>. Les noms ou positions de ces fichiers
ne sont pas figés et peuvent varier considérablement d'une distribution
à l'autre. N'hésitez pas à les arranger et subdiviser selon
<strong>vos</strong> goûts et besoins, quitte à en modifier
l'organisation par défaut.</p>
<p>La configuration du serveur s'effectue via des <a href="mod/quickreference.html">directives de configuration</a> que l'on
insère dans les fichiers de configuration. Une directive se compose d'un
mot-clé suivi d'un ou plusieurs arguments qui définissent sa valeur.</p>
<p>La réponse à la question "<em>Où dois-je placer cette directive ?</em>"
dépend en général du niveau auquel cette directive doit être prise en compte.
S'il s'agit du niveau global, elle doit être placée dans le fichier de
configuration principal, et en dehors de toute section <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code>, <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> ou de toute autre section. Sinon, si par
exemple elle ne doit s'appliquer qu'à un répertoire particulier, elle doit être
placée dans la section <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> qui fait référence à ce répertoire. Voir la
documentation sur les <a href="sections.html">Sections de configuration</a> pour
plus de détails.</p>
<p>En complément des fichiers de configuration principaux, certaines directives
peuvent être insérées dans des fichiers <code>.htaccess</code> que l'on place
directement dans le répertoire concerné. Les fichiers <code>.htaccess</code>
sont essentiellement destinés aux personnes qui n'ont pas accès aux fichiers de
configuration du serveur. Vous trouverez plus de détails à propos des fichiers
<code>.htaccess</code> dans ce <a href="howto/htaccess.html"><code>.htaccess</code>howto</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="content" id="content">Contenu du site web</a></h2>
<p>Si le contenu du site web peut se présenter sous de nombreuses
formes, il en existe deux principales : les
contenus statiques et les contenus dynamiques.</p>
<p>Les contenus statiques sont par exemple les fichiers HTML, les
images, les fichiers CSS et tout autre fichier résidant dans le système
de fichiers. La directive <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> permet de définir la position
dans l'arborescence du site où vous devez placer ces fichiers. Cette
directive peut être définie au niveau global, ou au niveau de chaque
serveur virtuel. Vous pouvez consulter vos fichiers de configuration
pour vérifier la manière dont cette directive est définie pour votre
serveur.</p>
<p>En général, et si aucun nom de fichier n'est spécifié dans la
requête, c'est une page de nom <code>index.html</code> qui sera
renvoyée. Par exemple, si la directive <code>DocumentRoot</code> est
définie à <code>/var/www/html</code>, et si une requête est effectuée
pour l'adresse <code>http://www.example.com/work/</code>, c'est le
fichier <code>/var/www/html/work/index.html</code> qui sera envoyé au
client par le serveur.</p>
<p>Un contenu dynamique est un contenu qui est généré au moment du
traitement de la requête, et qui peut différer d'une requête à l'autre.
Ces contenus dynamiques peuvent être générés de nombreuses manières par
l'intermédiaire de <a href="handler.html">gestionnaires de contenu</a>
ou "handlers". Il est aussi possible de créer des <a href="howto/cgi.html">programmes CGI</a> pour générer le contenu de
votre site.</p>
<p>Enfin, on peut utiliser des modules tiers comme mod_php pour écrire
du code permettant d'effectuer de nombreuses choses. De nombreuses
applications tierces écrites à partir de divers langages ou outils sont
disponibles en téléchargement et peuvent être installées sur votre
serveur HTTP Apache. Le support de ces applications est en dehors du sujet de
ce document, et nous vous invitons à consulter le site de leur éditeur
pour accéder à leur documentation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="logs" id="logs">Fichiers journaux et résolution des problèmes</a></h2>
<p>En tant qu'administrateur d'un serveur HTTP Apache, vos sources
d'informations principales sont les fichiers journaux, et en particulier
le journal des erreurs. Toute tentative de résolution d'un problème sans
consulter le journal des erreurs revient à essayer de conduire les yeux
fermés.</p>
<p>La position dans le système de fichiers du journal des erreurs est
spécifiée par la directive <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code>
qui peut être définie au niveau global, ou au niveau de chaque serveur
virtuel. Chaque entrée du journal des erreurs vous informe sur la nature
des problèmes et le moment de leur survenue. En outre, elle vous indique
souvent comment résoudre le problème. Chaque message d'erreur contient
un code d'erreur que vous pouvez utiliser pour effectuer une recherche
en ligne afin d'obtenir une description plus détaillée de la manière de
résoudre le problème. Vous pouvez aussi configurer votre journal des
erreurs de manière à ce qu'il enregistre un identifiant d'erreur que
vous pourrez ensuite utiliser pour effectuer une corrélation avec le
journal des accès afin de déterminer quelle requête est à l'origine de
l'erreur.</p>
<p>Vous trouverez plus de détails à ce sujet dans la <a href="logs.html">Documentation sur la journalisation</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Et maintenant, comment faire pour aller plus loin ?</a></h2>
<p>La question des prérequis étant réglée, il est temps de passer aux
choses sérieuses.</p>
<p>Ce document ne couvre que les notions de base. Nous espérons qu'il
vous permettra de mettre le pied à l'étrier, mais il y a encore de
nombreuses choses que vous devez savoir.</p>
<ul>
<li><a href="http://httpd.apache.org/download.cgi">Téléchargement</a></li>
<li><a href="install.html">Installation</a></li>
<li><a href="configuring.html">Configuration</a></li>
<li><a href="invoking.html">Démarrage du serveur</a></li>
<li><a href="http://wiki.apache.org/httpd/FAQ">Foire aux questions</a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/getting-started.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/getting-started.html" title="Français"> fr </a> |
<a href="./ru/getting-started.html" hreflang="ru" rel="alternate" title="Russian"> ru </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/getting-started.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/urlmapping.html.ja.utf8 0000664 0001751 0001751 00000063316 14743132254 021367 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>URL からファイルシステム上の位置へのマップ - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>URL からファイルシステム上の位置へのマップ</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/urlmapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/urlmapping.html" title="Japanese"> ja </a> |
<a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p>この文書は Apache がリクエストの URL から送信するファイルの
ファイルシステム上の位置を決定する方法を説明します。</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#related">関連するモジュールとディレクティブ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#outside">DocumentRoot 外のファイル</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#user">ユーザディレクトリ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#redirect">URL リダイレクション</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#proxy">リバースプロキシ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rewrite">リライトエンジン</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#notfound">File Not Found</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="related" id="related">関連するモジュールとディレクティブ</a></h2>
<table class="related"><tr><th>関連モジュール</th><th>関連ディレクティブ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code></li><li><code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code></li><li><code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_speling.html#checkspelling">CheckSpelling</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritematch">RewriteMatch</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="documentroot" id="documentroot">DocumentRoot</a></h2>
<p>リクエストに対してどのファイルを送信するかを決定するときの
Apache のデフォルトの動作は、リクエストの URL-Path (URL のホスト名と
ポート番号の後に続く部分) を取り出して設定ファイルで指定されている
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
の最後に追加する、というものです。ですから、
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
の下のディレクトリやファイルがウェブから見える基本のドキュメントの木構造を
なします。</p>
<p>Apache にはサーバが複数のホストへのリクエストを受け取る
<a href="vhosts/">バーチャルホスト</a> の機能もあります。
この場合、それぞれのバーチャルホストに対して違う
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
を指定することができます。また、<code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code>
モジュールにより提供されるディレクティブを使って、
送信するためのコンテンツの場所をリクエストされた IP
アドレスやホスト名から動的に決めることもできます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="outside" id="outside">DocumentRoot 外のファイル</a></h2>
<p>ファイルシステム上の、
厳密には <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
の下にはない部分へのウェブアクセスを許可する必要がある
場合がよくあります。Apache はこのために複数の方法を用意しています。
Unix システムでは、ファイルシステムの他の部分をシンボリックリンクを
使って <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
の下に持ってくることができます。セキュリティ上の理由により、
Apache は該当するディレクトリの
<code class="directive"><a href="./mod/core.html#options">Options</a></code> の設定に
<code>FollowSymLinks</code> か <code>SymLinksIfOwnerMatch</code> が
ある場合にのみシンボリックリンクをたどります。</p>
<p>代わりの方法として、<code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code>
ディレクティブを使ってファイルシステムの任意の部分をウェブの空間に
マップできます。たとえば、</p>
<div class="example"><p><code>Alias /docs /var/web</code></p></div>
<p>という設定のときは、URL
<code>http://www.example.com/docs/dir/file.html</code> には
<code>/var/web/dir/file.html</code> が送信されます。
<code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code> も、
対象となっているパスが CGI スクリプトとして扱われるという追加の
効果以外は同じように動作します。</p>
<p>もっと柔軟な設定が必要な状況では、
<code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code> ディレクティブや
<code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code> ディレクティブ
を使って強力な正規表現に基づいたマッチと置換を行なうことができます。
たとえば、</p>
<div class="example"><p><code>ScriptAliasMatch ^/~([a-zA-Z0-9]+)/cgi-bin/(.+)
/home/$1/cgi-bin/$2</code></p></div>
<p>は <code>http://example.com/~user/cgi-bin/script.cgi</code> への
リクエストを <code>/home/user/cgi-bin/script.cgi</code> というパスへ
マップし、このマップの結果としてのファイルを CGI スクリプトとして
扱います。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="user" id="user">ユーザディレクトリ</a></h2>
<p>伝統的に Unix システムではユーザ <em>user</em> のホームディレクトリを
<code>~user/</code> として参照できます。<code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>
モジュールはこの概念をウェブに拡張して、
それぞれのユーザのホームディレクトリのファイルを
以下のような URL を使ってアクセスできるようにします。</p>
<div class="example"><p><code>http://www.example.com/~user/file.html</code></p></div>
<p>セキュリティの観点から、ウェブからユーザのホームディレクトリへ
直接アクセスできるようにすることは適切ではありません。ですから、
<code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> ディレクティブには
ユーザのホームディレクトリの下の、ウェブファイルの
置かれているディレクトリを指定します。デフォルトの設定の
<code>Userdir public_html</code> を使うと、上の URL は
<code>/home/user/public_html/file.html</code> というようなファイルに
マップされます。ここで、<code>/home/user/</code> は
<code>/etc/passwd</code> で指定されているユーザのホームディレクトリです。</p>
<p><code class="directive"><a href="./mod/mod_userdir.html#userdir">Userdir</a></code> には、
<code>/etc/passwd</code> にホームディレクトリの位置が書かれていない
システムでも使うことのできる他の形式もあります。</p>
<p>中にはシンボル "~" (<code>%7e</code> のように符号化されることが多い)
を格好が悪いと思って、ユーザのディレクトリを表すために別の文字列の
使用を好む人がいます。mod_userdir はこの機能をサポートしていません。
しかし、ユーザのホームディレクトリが規則的な構成のときは、
<code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code> を使って望みの
効果を達成することができます。たとえば、
<code>http://www.example.com/upages/user/file.html</code> が
<code>/home/user/public_html/file.html</code> にマップされるようにするには、
以下のように <code>AliasMatch</code> ディレクティブを使います:</p>
<div class="example"><p><code>AliasMatch ^/upages/([a-zA-Z0-9]+)/?(.*)
/home/$1/public_html/$2</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="redirect" id="redirect">URL リダイレクション</a></h2>
<p>上の節で説明した設定用のディレクティブは Apache に
ファイルシステムの特定の場所からコンテンツを取ってきて
クライアントに送り返すようにします。ときには、その代わりに
クライアントにリクエストされたコンテンツは別の URL にあることを
知らせて、クライアントが新しい URL へ新しいリクエストを行なうように
する方が望ましいことがあります。これは<em>リダイレクション</em>と
呼ばれていて、<code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code>
ディレクティブにより実装されています。たとえば、
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> の下のディレクトリ
<code>/foo/</code> が新しいディレクトリ <code>/bar/</code> に移動したときは、
以下のようにしてクライアントが新しい場所のコンテンツをリクエストするように
指示することができます:</p>
<div class="example"><p><code>Redirect permanent /foo/
http://www.example.com/bar/</code></p></div>
<p>これは、<code>/foo/</code> で始まるすべての URL-Path を、
<code>www.example.com</code> サーバの <code>/bar/</code> が
<code>/foo/</code> に置換されたものにリダイレクトします。
サーバは自分自身のサーバだけでなく、どのサーバにでもクライアントを
リダイレクトすることができます。</p>
<p>Apache はより複雑な書き換えの問題のために、
<code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> ディレクティブを
提供しています。たとえば、サイトのホームページを違うサイトにリダイレクト
するけれど、他のリクエストはそのまま扱う、というときは以下の設定を
使います:</p>
<div class="example"><p><code>RedirectMatch permanent ^/$
http://www.example.com/startpage.html</code></p></div>
<p>あるいは、一時的にサイトのすべてのページを他のサイトの特定の
ページへリダイレクトするときは、以下を使います:</p>
<div class="example"><p><code>RedirectMatch temp .*
http://othersite.example.com/startpage.html</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="proxy" id="proxy">リバースプロキシ</a></h2>
<p>Apache は遠隔地にあるドキュメントをローカルのサーバの URL 空間に
持ってくることもできます。この手法は<em>リバースプロキシ</em>と呼ばれています。
ウェブサーバが遠隔地のドキュメントを取得してクライアントに送り返すのが
プロキシサーバの動作のように見えるからです。クライアントにはドキュメントが
リバースプロキシサーバから送られてきているように見える点が通常の
プロキシとは異なります。</p>
<p>次の例では、クライアントが <code>/foo/</code> ディレクトリの下にある
ドキュメントをリクエストすると、サーバが <code>internal.example.com</code> の
<code>/bar/</code> ディレクトリから取得して、さもローカルサーバからの
ドキュメントのようにしてクライアントに返します。</p>
<div class="example"><p><code>
ProxyPass /foo/ http://internal.example.com/bar/<br />
ProxyPassReverse /foo/ http://internal.example.com/bar/<br />
ProxyPassReverseCookieDomain internal.example.com public.example.com<br />
ProxyPassReverseCookiePath /foo/ /bar/
</code></p></div>
<p><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> ディレクティブは
サーバが適切なドキュメントを取得するように設定し、
<code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> ディレクティブは
<code>internal.example.com</code> からのリダイレクトがローカルサーバの
適切なディレクトリを指すように書き換えます。
同様に <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code>
と <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code>
でバックエンド側サーバの発行した Cookie を書き換えることができます。</p>
<p>ただし、ドキュメントの中のリンクは書き換えられない、
ということは知っておいてください。
ですから、<code>internal.example.com</code> への絶対パスによるリンクでは、
クライアントがプロキシサーバを抜け出して <code>internal.example.com</code> に
直接リクエストを送る、ということになります。
サードパーティ製モジュールの <a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a>
は、HTML と XHTML 中のリンクを書き換えることができます。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">リライトエンジン</a></h2>
<p>より一層強力な置換が必要なときは、<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
が提供するリライトエンジンが役に立つでしょう。
このモジュールにより提供されるディレクティブは
ブラウザの種類、リクエスト元の IP アドレスなどのリクエストの特徴を
使って送り返すコンテンツの場所を決めます。さらに、<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
は外部のデータベースファイルやプログラムを使ってリクエストの扱い方を
決めることもできます。リライトエンジンは上で挙げられている三つのマッピング
すべてを行なうことができます: 内部のリダイレクト (エイリアス)、
外部のリダイレクト、プロキシです。mod_rewrite を使う多くの実用的な例は
<a href="misc/rewriteguide.html">URL リライトガイド</a>
で説明されています。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="notfound" id="notfound">File Not Found</a></h2>
<p>必ず、リクエストされた URL に対応するファイルがファイルシステムに
無いという場合が発生します。これが起こるのにはいくつかの理由があります。
場合によっては、ドキュメントを別の場所に移動した結果であることがあります。
この場合は、クライアントにリソースの新しい位置を知らせるために
<a href="#redirect">URL リダイレクション</a>を使うのが最善の方法です。
そうすることによって、リソースは新しい位置に移動しているけれども、
古いブックマークやリンクが動作し続けるようにすることができます。</p>
<p>"File Not Found" エラーのもう一つのよくある理由は、
ブラウザへの直接入力や HTML リンクからの偶発的な URL の入力間違いです。
Apache はこの問題を改善するために、<code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code>
モジュール (意図的な綴り間違い)
(訳注: 正しくは spelling) を提供しています。このモジュールが
使用されているときは、"File Not Found" エラーを横取りして、
似たファイル名のリソースを探します。もし一つだけ見つかった場合は
mod_speling はクライアントに正しい位置を知らせるために HTTP リダイレクトを
送ります。もし複数の「近い」ファイルが見つかった場合は、それら
代替となりえるもののリストがクライアントに表示されます。</p>
<p>mod_speling の非常に有用な機能は、大文字小文字を区別せずに
ファイル名を比較するものです。これは URL と unix の
ファイルシステムが両方とも大文字小文字を区別するものである、
ということをユーザが知らないシステムで役に立ちます。ただし、
時折の URL 訂正程度で済まず、mod_speling をより多く使用すると、サーバに
さらなる負荷がかかります。すべての「正しくない」リクエストの後に
URL のリダイレクトとクライアントからの新しいリクエストがくることに
なりますから。</p>
<p>コンテンツの位置を決めようとするすべての試みが失敗すると、
Apache は、HTTP ステータスコード 404 (file not found) と共に
エラーページを返します。このエラーページの外観は
<code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
ディレクティブで制御され、
<a href="custom-error.html">カスタムエラーレスポンス</a> で
説明されているように、柔軟な設定を行なうことができます。</p>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/urlmapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/urlmapping.html" title="Japanese"> ja </a> |
<a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/urlmapping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/caching.html.fr.utf8 0000664 0001751 0001751 00000160764 14740503670 020630 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Guide de la mise en cache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Guide de la mise en cache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/caching.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/caching.html" title="Français"> fr </a> |
<a href="./tr/caching.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document complète la documentation de référence des modules
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>, <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>,
<code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> et du programme <a href="programs/htcacheclean.html">htcacheclean</a>.
Il décrit l'utilisation des fonctionnalités de mise en
cache du serveur HTTP Apache
pour accélérer les services web et mandataire, tout en évitant les problèmes
courants et les erreurs de configuration.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#http-caching">Mise en cache HTTP à trois états RFC2616</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Exemples de configuration du cache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#socache-caching">Mise en cache générale d'objets partagés à deux états de forme
clé/valeur</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#file-caching">Mise en cache à base de fichiers spécialisés</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#security">Considérations sur la sécurité</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="introduction" id="introduction">Introduction</a></h2>
<p>Le serveur HTTP Apache offre tout un ensemble de fonctionnalités
de mise en cache qui ont été conçues pour améliorer les performances
du serveur de différentes manières.</p>
<dl>
<dt>Mise en cache HTTP à trois états RFC2616</dt>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> et son module de fournisseur
<code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> proposent une mise en cache
intelligente de niveau HTTP. Le contenu proprement dit est
stocké dans le cache, et mod_cache vise à respecter tous les
en-têtes HTTP, ainsi que les options qui contrôlent la mise en
cache du contenu comme décrit dans la <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">Section
13 de la RFC2616</a>. <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> peut gérer des
configurations de mise en cache simples, mais aussi complexes
comme dans les cas où vous avez à faire à des contenus mandatés,
à des contenus locaux dynamiques, ou lorsque vous avez besoin
d'accélérer l'accès aux fichiers locaux situés sur disque
supposé lent.
</dd>
<dt>Mise en cache d'objets partagés de forme clé/valeur à deux
états</dt>
<dd>
L'<a href="socache.html">API du cache d'objets partagés</a> (socache)
et ses modules de fournisseurs
proposent une mise en cache d'objets partagés à base de
couples clé/valeur de niveau serveur. Ces modules sont
conçus pour la mise en cache de données de bas niveau comme
les sessions SSL et les données d'authentification. les
serveurs d'arrière-plan permettent le stockage des données
au niveau serveur en mémoire partagée, ou au niveau
datacenter dans un cache comme memcache ou distcache.
</dd>
<dt>Mise en cache de fichiers spécialisée</dt>
<dd>
<code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> offre la possibilité de
précharger des fichiers en mémoire au démarrage du serveur,
et peut améliorer les temps d'accès et sauvegarder les
gestionnaires de fichiers pour les fichiers qui font l'objet
d'accès fréquents, évitant ainsi d'avoir à accéder au disque
à chaque requête.
</dd>
</dl>
<p>Pour tirer parti efficacement de ce document, les bases de HTTP doivent
vous être familières, et vous devez avoir lu les sections
<a href="urlmapping.html">Mise en correspondance des
URLs avec le système de fichiers</a> et
<a href="content-negotiation.html">Négociation sur le contenu</a>
du guide de l'utilisateur.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="http-caching" id="http-caching">Mise en cache HTTP à trois états RFC2616</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code></li><li><code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code></li><li><code class="directive"><a href="./mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code></li></ul></td></tr></table>
<p>Le module <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> permet de tirer avantage du
mécanisme de mise en cache en ligne faisant partie
intégrante du protocole HTTP, et décrit dans la <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">section
13 de la RFC2616</a>.</p>
<p>A la différence d'un cache simple clé/valeur à deux états où le
contenu est supprimé lorsqu'il est périmé, un cache HTTP comporte un
mécanisme permettant de conserver temporairement un contenu périmé,
de demander au serveur original si ce contenu périmé a été modifié,
et dans le cas contraire de le rendre à nouveau valable.</p>
<p>Une entrée d'un cache HTTP peut se présenter sous un de ces trois
états :</p>
<dl>
<dt>Frais</dt>
<dd>
Si un contenu est suffisamment récent (plus jeune que sa
<strong>durée de fraîcheur</strong>), il est considéré comme
<strong>frais</strong>. Un cache HTTP peut servir un contenu
frais sans avoir à demander quoi que ce soit au serveur
d'origine.
</dd>
<dt>Périmé</dt>
<dd>
<p>Si le contenu est trop ancien (plus vieux que sa
<strong>durée de fraîcheur</strong>), il est considéré comme
<strong>périmé</strong>. Un cache HTTP doit contacter le serveur
original pour vérifier si le contenu, même s'il est périmé, est
encore à jour avant de le servir au client. Soit le serveur
original va répondre en envoyant un contenu de remplacement si
le contenu périmé n'est plus à jour, soit dans le cas idéal il
renverra un code pour signaler au cache que le contenu est
encore à jour, et qu'il est inutile de le générer ou de
l'envoyer à nouveau. Le contenu repasse à l'état "frais" et le
cycle continue.</p>
<p>Le protocole HTTP permet au cache de servir des données
périmées dans certaines circonstances, comme lorsqu'une
tentative de rafraîchir une entrée depuis un serveur original
se solde par un échec avec un code d'erreur 5xx, ou lorsqu'une
autre requête est déjà en train d'essayer de rafraîchir la même
entrée. Dans ces cas, un en-tête <code>Warning</code> est ajouté
à la réponse.</p>
</dd>
<dt>Non Existent</dt>
<dd>
Si le cache est plein, il se réserve la possibilité de supprimer
des entrées pour faire de la place. Une entrée peut être
supprimée à tout moment, qu'elle soit fraîche ou périmée.
L'outil <a href="programs/htcacheclean.html">htcacheclean</a>
peut être utilisé à la demande, ou lancé en tant que démon afin
de conserver la taille du cache ou le nombre d'inodes en deçà de
valeurs spécifiées. Cet outil essaie cependant de
supprimer les entrées périmées avant les entrées fraîches.
</dd>
</dl>
<p>Le fonctionnement détaillé d'un cache HTTP est décrit dans la <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">Section
13 de la RFC2616</a>.</p>
<h3>Interaction avec le serveur</h3>
<p>Le module <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> interagit avec le serveur
à deux niveaux possibles en fonction de la directive <code class="directive"><a href="./mod/mod_cache.html#cachequickhandler">CacheQuickHandler</a></code> :
</p>
<dl>
<dt>Phase de gestion rapide</dt>
<dd>
<p>Cette phase se déroule très tôt au cours du traitement de
la requête, juste après l'interprétation de cette dernière. Si
le contenu se trouve dans le cache, il est servi immédiatement
et pratiquement tout le reste du traitement de la requête est
court-circuité.</p>
<p>Dans ce scénario, le cache se comporte comme s'il avait
été "boulonné" à l'entrée du serveur.</p>
<p>Ce mode possède les meilleures performances car la
majorité des traitements au niveau du serveur sont
court-circuités. Cependant, il court-circuite aussi les
phases d'authentification et d'autorisation du traitement
au niveau du serveur, et il doit donc être utilisé avec
prudence lorsque que ces phases sont importantes.</p>
<p>Les requêtes comportant un en-tête "Authorization"
(comme par exemple l'authentification HTTP basique) ne
peuvent être ni mises en cache, ni servies depuis ce
dernier lorsque <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> s'exécute dans
cette phase.</p>
</dd>
<dt>Phase de gestion normale</dt>
<dd>
<p>Cette phase se déroule très tard au cours du traitement
de la requête, en fait après toutes les phases de ce
traitement.</p>
<p>Dans ce scénario, le cache se comporte comme s'il avait
été "boulonné" à la sortie du serveur.</p>
<p>Ce mode offre la plus grande souplesse, car il permet
de faire intervenir la mise en cache en un point
précisément spécifié de la chaîne de filtrage, et le
contenu issu du cache peut être filtré ou personnalisé
avant d'être servi au client.</p>
</dd>
</dl>
<p>Si l'URL ne se trouve pas dans le cache,
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> ajoutera un <a href="filter.html">filtre</a> à la chaîne de filtrage afin
d'enregistrer la réponse dans le cache, puis passera la main
pour permettre le déroulement normal de la suite du traitement
de la requête. Si la mise en cache du contenu est autorisée, il
sera enregistré dans le cache pour pouvoir être servi à nouveau
; dans le cas contraire, le contenu sera ignoré.</p>
<p>Si le contenu trouvé dans le cache est périmé, le module
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> convertit la requête en
<strong>requête conditionnelle</strong>. Si le serveur original
renvoie une réponse normale, elle est enregistrée dans le cache
en lieu et place du contenu périmé. Si le serveur original
renvoie une réponse "304 Not Modified", le contenu repasse à
l'état "frais" et est servi par le filtre au lieu d'être
sauvegardé.</p>
<h3>Amélioration du taux de présence dans le cache</h3>
<p>Lorsqu'un serveur virtuel est connu sous la forme d'un des
nombreux alias du serveur, la définition de la directive
<code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> à
<code>On</code> peut augmenter de manière significative le nombre
de correspondances positives dans le cache. Cela est dû au fait
que la clé du cache contient le nom d'hôte du serveur virtuel.
Avec <code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> positionnée
à <code>On</code>,
les hôtes virtuels possédant plusieurs noms de serveur ou alias ne
généreront pas d'entités de cache différentes, et le contenu sera mis en
cache en faisant référence au nom d'hôte canonique.</p>
<h3>Durée de fraîcheur</h3>
<p>Un contenu bien formé destiné à être mis en cache doit déclarer
explicitement une durée de fraîcheur à l'aide des champs
<code>max-age</code> ou <code>s-maxage</code> de l'en-tête
<code>Cache-Control</code>, ou en incluant un en-tête
<code>Expires</code>.</p>
<p>De plus, un client peut passer outre la durée de fraîcheur
définie pour le serveur d'origine en ajoutant son propre en-tête
<code>Cache-Control</code> à la requête. Dans ce cas, c'est la
durée de fraîcheur la plus basse entre la requête et la réponse
qui l'emporte.</p>
<p>Lorsque cette durée de fraîcheur est absente de la requête ou
de la réponse, une durée de fraîcheur par défaut s'applique. La
durée de fraîcheur par défaut des entrées du cache est d'une heure
; elle peut cependant être facilement modifiée à l'aide de
la directive <code class="directive"><a href="./mod/mod_cache.html#cachedefaultexpire">CacheDefaultExpire</a></code>.</p>
<p>Si une réponse ne contient pas d'en-tête <code>Expires</code> mais
inclut un en-tête <code>Last-Modified</code>, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
peut déduire une durée de fraîcheur en se basant sur une
heuristique, qui peut être contrôlée à l'aide de la directive <code class="directive"><a href="./mod/mod_cache.html#cachelastmodifiedfactor">CacheLastModifiedFactor</a></code>.</p>
<p>Pour les contenus locaux, ou les contenus distants qui ne
spécifient pas leur propre en-tête <code>Expires</code>,
<code class="module"><a href="./mod/mod_expires.html">mod_expires</a></code> permet de régler finement la durée de
fraîcheur à l'aide des paramètres <code>max-age</code> et
<code>Expires</code>.</p>
<p>On peut aussi contrôler la durée de fraîcheur maximale en utilisant
la directive <code class="directive"><a href="./mod/mod_cache.html#cachemaxexpire">CacheMaxExpire</a></code>.</p>
<h3>Guide succinct des requêtes conditionnelles</h3>
<p>Lorsqu'un contenu du cache est périmé, httpd modifie la requête
pour en faire une requête conditionnelle</p>
<p>Lorsque la réponse originale du cache contient un en-tête
<code>ETag</code>, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> ajoute un en-tête
<code>If-None-Match</code> à la requête envoyée au serveur
d'origine. Lorsque la réponse originale du cache contient un en-tête
<code>Last-Modified</code>, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> ajoute un en-tête
<code>If-Modified-Since</code> à la requête envoyée au serveur
d'origine. Dans ces deux cas, la requête devient une requête
<strong>conditionnelle</strong>.</p>
<p>Lorsqu'un serveur d'origine reçoit une requête conditionnelle,
il vérifie si le paramètre Etag ou Last-Modified a été modifié en
fonction des paramètres de la requête. Si ce n'est pas le cas, il
répondra avec le message lapidaire "304 Not Modified". Cela
informe le cache que le contenu est périmé mais encore à jour, et
peut être utilisé tel quel pour les prochaines requêtes jusqu'à ce
qu'il atteigne à nouveau sa date de péremption.</p>
<p>Si le contenu a été modifié, il est servi comme s'il s'agissait
d'une requête normale et non conditionnelle.</p>
<p>Les requêtes conditionnelles offrent deux avantages. D'une
part, il est facile de déterminer si le contenu du serveur
d'origine correspond à celui situé
dans le cache, et ainsi d'économiser la consommation de ressources
nécessaire au transfert du contenu dans son ensemble.</p>
<p>D'autre part, un serveur d'origine bien conçu sera configuré de
telle manière que les requêtes conditionnelles nécessitent pour
leur production bien moins de ressources qu'une réponse complète.
Dans le cas des fichiers statiques, il suffit en général d'un
appel système de type <code>stat()</code> ou similaire pour
déterminer si la taille ou la date de modification du fichier a
été modifiée. Ainsi, même un contenu local pourra être servi plus
rapidement depuis le cache s'il n'a pas été modifié.</p>
<p>Il serait souhaitable que tous les serveurs d'origine
supportent les requêtes conditionnelles, car dans le cas
contraire, ils répondent comme s'il s'agissait d'une requête
normale, et le cache répond comme si le contenu avait été
modifié et enregistre ce dernier. Le cache se comporte alors
comme un simple cache à deux état, où le contenu est servi s'il
est à jour, ou supprimé dans le cas contraire.</p>
<h3>Que peut-on mettre en cache ?</h3>
<p>La liste complète des conditions nécessaires pour qu'une
réponse puisse être enregistrée dans un cache HTTP est fournie
dans la <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html#sec13.4">section
13.4 Response Cacheability de la RFC2616</a>, et peut se résumer
ainsi :</p>
<ol>
<li>La mise en cache doit être activée pour cette URL. Voir les
directives <code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code> et <code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code>.</li>
<li>Si la reponse possède un code de statut HTTP autre que 200, 203, 300, 301
ou 410, elle doit aussi comporter un en-tête "Expires" ou
"Cache-Control".</li>
<li>La requête doit être de type HTTP GET.</li>
<li>Si la réponse contient un en-tête "Authorization:", elle doit aussi
contenir une option "s-maxage", "must-revalidate" ou "public" dans l'en-tête
"Cache-Control:".</li>
<li>Si l'URL contient une chaîne de requête
(provenant par exemple d'une méthode GET de formulaire HTML), elle ne
sera pas mise en cache, à moins que la réponse ne
spécifie explicitement un délai d'expiration à l'aide d'un
en-tête "Expires:" ou une directive max-age ou s-maxage de
l'en-tête "Cache-Control:" comme indiqué dans les
sections 13.2.1. et 13.9 de la RFC2616.</li>
<li>Si la réponse a un statut de 200 (OK), elle doit aussi contenir
au moins un des en-têtes "Etag", "Last-Modified" ou
"Expires", ou une directive max-age ou s-maxage de
l'en-tête "Cache-Control:", à moins que la directive
<code class="directive"><a href="./mod/mod_cache.html#cacheignorenolastmod">CacheIgnoreNoLastMod</a></code>
ne précise d'autres contraintes.</li>
<li>Si la réponse contient l'option "private" dans un en-tête
"Cache-Control:", elle ne sera pas mise en cache à moins que la
directive
<code class="directive"><a href="./mod/mod_cache.html#cachestoreprivate">CacheStorePrivate</a></code>
ne précise d'autres contraintes.</li>
<li>De même, si la réponse contient l'option "no-store" dans un en-tête
"Cache-Control:", elle ne sera pas mise en cache à moins que la
directive
<code class="directive"><a href="./mod/mod_cache.html#cachestorenostore">CacheStoreNoStore</a></code>
n'ait été utilisée.</li>
<li>Une réponse ne sera pas mise en cache si elle comporte un en-tête
"Vary:" contenant le caractère "*" qui correspond à toute
chaîne de caractères.</li>
</ol>
<h3>Qu'est ce qui ne doit pas être mis en cache ?</h3>
<p>Le client qui crée la requête ou le serveur d'origine qui
génère la réponse doit être à même de déterminer si le contenu
doit pouvoir être mis en cache ou non en définissant correctement
l'en-tête <code>Cache-Control</code>, et
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> sera alors en mesure de satisfaire les
souhaits du client ou du serveur de manière appropriée.
</p>
<p>Les contenus qui varient au cours du temps, ou en fonction de
particularités de la requête non prises en compte par la
négociation HTTP ne doivent pas être mis en cache. Ce type de
contenu doit se déclarer lui-même "à ne pas mettre en cache" à l'aide de
l'en-tête <code>Cache-Control</code>.</p>
<p>Si le contenu change souvent, suite par exemple à une durée de
fraîcheur de l'ordre de la minute ou de la seconde, il peut tout
de même être mis en cache, mais il est alors fortement souhaitable
que le serveur d'origine supporte correctement les
<strong>requêtes conditionnelles</strong> afin que des réponses
complètes ne soient pas systématiquement générées.</p>
<p>Un contenu qui varie en fonction d'en-têtes de requête fournis
par le client peut être mis en cache, sous réserve d'une
utilisation appropriée de l'en-tête de réponse <code>Vary</code>.</p>
<h3>Contenu variable et/ou négocié</h3>
<p>Lorsque le serveur d'origine est configuré pour servir des
contenus différents en fonction de la valeur de certains en-têtes
de la requête, par exemple pour servir une ressource en plusieurs
langages à partir d'une seule URL, le mécanisme de mise en cache
d'HTTP permet de mettre en cache plusieurs variantes de la même
page à partir d'une seule URL.</p>
<p>Pour y parvenir, le serveur d'origine ajoute un en-tête
<code>Vary</code> pour indiquer quels en-têtes doivent être pris
en compte par un cache pour déterminer si deux variantes sont
différentes l'une de l'autre.</p>
<p>Si par exemple, une réponse est reçue avec l'en-tête Vary suivant,</p>
<div class="example"><p><code>
Vary: negotiate,accept-language,accept-charset
</code></p></div>
<p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> ne servira aux demandeurs que le contenu
mis en cache qui correspond au contenu des en-têtes accept-language et
accept-charset de la requête originale.</p>
<p>Plusieurs variantes d'un contenu peuvent être mises en cache
simultanément ; <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> utilise l'en-tête
<code>Vary</code> et les valeurs correspondantes des en-têtes de
la requête spécifiés dans ce dernier pour
déterminer quelle variante doit être servie au client.</p>
</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">Exemples de configuration du cache</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code></li><li><code class="module"><a href="./mod/mod_cache_socache.html">mod_cache_socache</a></code></li><li><code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cacheroot">CacheRoot</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code></li><li><code class="directive"><a href="./mod/mod_cache_socache.html#cachesocache">CacheSocache</a></code></li></ul></td></tr></table>
<h3><a name="disk" id="disk">Mise en cache sur disque</a></h3>
<p>Le module <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> s'appuie sur des
implémentations de stockage sous-jacentes spécifiques pour gérer
le cache ; à ce titre, <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> fournit la
prise en charge de la mise en cache sur disque.</p>
<p>En général, le module se configure comme suit :</p>
<pre class="prettyprint lang-config">CacheRoot "/var/cache/apache/"
CacheEnable disk /
CacheDirLevels 2
CacheDirLength 1</pre>
<p>Il est important de savoir que, les fichiers mis en cache étant stockés
localement, la mise en cache par l'intermédiaire du système d'exploitation
sera en général aussi appliquée à leurs accès. Si bien que même si les
fichiers sont stockés sur disque, s'il font l'objet d'accès fréquents,
il est probable que le système d'exploitation s'appliquera à ce qu'ils
soient servis à partir de la mémoire.</p>
<h3>Comprendre le stockage dans le cache</h3>
<p>Pour stocker des entités dans le cache,
le module <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> crée une empreinte (hash) de 22
caractères de l'URL qui a fait l'objet d'une requête. Cette empreinte
comprend le nom d'hôte, le protocole, le port, le chemin et tout argument
de type CGI associé à l'URL, ainsi que les éléments
spécifiés dans l'en-tête Vary afin d'être sûr que plusieurs URLs
n'interfèrent pas entre elles.</p>
<p>Chaque position de l'empreinte peut contenir un caractère
choisi parmi 64 caractères différents, il y a donc
64^22 possibilités pour une empreinte. Par exemple, une URL peut posséder
l'empreinte <code>xyTGxSMO2b68mBCykqkp1w</code>. Cette empreinte est
utilisée pour préfixer les noms de fichiers spécifiques à cette URL à
l'intérieur du cache ; cependant, elle est tout d'abord placée dans les
répertoires du cache selon les directives
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code> et
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code>.</p>
<p>La directive
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code>
définit le nombre de niveaux de sous-répertoires, et
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code>
le nombre de caractères composant le nom des sous-répertoires. Dans
l'exemple donné plus haut, l'empreinte se trouvera à :
<code>/var/cache/apache/x/y/TGxSMO2b68mBCykqkp1w</code>.</p>
<p>Cette technique a pour but principal de réduire le nombre de
sous-répertoires ou de fichiers contenus dans un répertoire particulier,
car le fonctionnement de la plupart des systèmes de fichiers est ralenti
quand ce nombre augmente. Avec la valeur "1" pour la directive
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code>,
il peut y avoir au plus 64 sous-répertoires à un niveau quelconque.
Avec la valeur "2", il peut y en avoir 64 * 64, etc...
A moins d'avoir une bonne raison pour ne pas le faire, l'utilisation de
la valeur "1" pour la directive
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code>
est recommandée.</p>
<p>Le paramétrage de la directive
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code>
dépend du nombre de fichiers que vous pensez stocker dans le cache.
Avec une valeur de "2" comme dans l'exemple donné plus haut,
4096 sous-répertoires peuvent être créés au total. Avec 1 million de
fichiers dans le cache, cela équivaut à environ 245 URLs mises en cache
dans chaque répertoire.</p>
<p>Chaque URL nécessite au moins deux fichiers dans le cache. Ce sont en
général un fichier ".header", qui contient des meta-informations à propos
de l'URL, comme la date de son arrivée à expiration,
et un fichier ".data" qui est la copie exacte du contenu à servir.</p>
<p>Dans le cas d'un contenu négocié via l'en-tête "Vary", un répertoire
".vary" sera créé pour l'URL en question. Ce répertoire contiendra de
multiples fichiers ".data" correspondant aux différents contenus
négociés.</p>
<h3>Maintenance du cache sur disque</h3>
<p>Le module <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> n'effectue aucune
régulation de l'espace disque utilisé par le cache, bien qu'il
s'arrête en douceur en cas d'erreur disque et se comporte alors
comme si le cache n'avait jamais existé.</p>
<p>Par contre, l'utilitaire
<a href="programs/htcacheclean.html">htcacheclean</a> fourni avec
httpd
vous permet de nettoyer le cache périodiquement.
Déterminer la fréquence à laquelle lancer <a href="programs/htcacheclean.html">htcacheclean</a> et la taille souhaitée
pour le cache est une tâche relativement complexe et il vous faudra de
nombreux essais et erreurs pour arriver à sélectionner des valeurs
optimales.</p>
<p><a href="programs/htcacheclean.html">htcacheclean</a> opère selon deux
modes. Il peut s'exécuter comme démon résident, ou être lancé
périodiquement par cron. <a href="programs/htcacheclean.html">htcacheclean</a> peut mettre une heure
ou plus pour traiter de très grands caches (plusieurs dizaines de
Gigaoctets) et si vous l'exécutez à partir de cron, il vous est
conseillé de déterminer la durée typique d'un traitement, afin d'éviter
d'exécuter plusieurs instances à la fois.</p>
<p>Il est aussi conseillé d'attribuer un niveau de priorité "nice"
approprié à htcacheclean de façon à ce qu'il n'effectue pas trop
d'accès disque pendant le fonctionnement du serveur.</p>
<p class="figure">
<img src="images/caching_fig1.gif" alt="" width="600" height="406" /><br />
<a id="figure1" name="figure1"><dfn>Figure 1</dfn></a>: Croissance
typique du cache / séquence de nettoyage.</p>
<p>Comme <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> ne tient pas compte de l'espace
utilisé, vous devez vous assurer que
<a href="programs/htcacheclean.html">htcacheclean</a> est configuré de
façon à laisser suffisamment d'"espace de croissance"
à la suite d'un nettoyage.</p>
<h3><a name="memcache" id="memcache">Cache en mémoire</a></h3>
<p>En utilisant le module <code class="module"><a href="./mod/mod_cache_socache.html">mod_cache_socache</a></code>,
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> peut mettre en cache des données à partir de
diverses implémentations aussi nommées "fournisseurs". Par exemple, en
utilisant le module <code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code>, on peut
spécifier que c'est <a href="http://memcached.org">memcached</a> qui doit
être utilisé comme mécanisme de stockage sous-jacent.</p>
<p>Typiquement, le module sera configuré comme suit :</p>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache memcache:memcd.example.com:11211</pre>
<p>En outre, il est possible de spécifier plusieurs serveurs
<code>memcached</code> en les ajoutant à la fin de la ligne
<code>CacheSocache memcache:</code> et en les séparant par des virgules :</p>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache memcache:mem1.example.com:11211,mem2.example.com:11212</pre>
<p>Divers autres fournisseurs <code class="module"><a href="./mod/mod_cache_socache.html">mod_cache_socache</a></code> utilisent
aussi ce format. Par exemple :</p>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache shmcb:/path/to/datafile(512000)</pre>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache dbm:/path/to/datafile</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="socache-caching" id="socache-caching">Mise en cache générale d'objets partagés à deux états de forme
clé/valeur</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authn_socache.html">mod_authn_socache</a></code></li><li><code class="module"><a href="./mod/mod_socache_dbm.html">mod_socache_dbm</a></code></li><li><code class="module"><a href="./mod/mod_socache_dc.html">mod_socache_dc</a></code></li><li><code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code></li><li><code class="module"><a href="./mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code></li><li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authn_socache.html#authncachesocache">AuthnCacheSOCache</a></code></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslstaplingcache">SSLStaplingCache</a></code></li></ul></td></tr></table>
<p>Le serveur HTTP Apache fournit un cache d'objets partagés de bas
niveau pour la mise en cache d'informations comme les sessions SSL
ou les données d'authentification dans l'interface <a href="socache.html">socache</a>.</p>
<p>Pour chaque implémentation, un module supplémentaire est fourni
qui offre les services d'arrière-plan suivants :</p>
<dl>
<dt><code class="module"><a href="./mod/mod_socache_dbm.html">mod_socache_dbm</a></code></dt>
<dd>Cache d'objets partagés basé sur DBM.</dd>
<dt><code class="module"><a href="./mod/mod_socache_dc.html">mod_socache_dc</a></code></dt>
<dd>Cache d'objets partagés basé sur Distcache.</dd>
<dt><code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code></dt>
<dd>Cache d'objets partagés basé sur Memcache.</dd>
<dt><code class="module"><a href="./mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code></dt>
<dd>Cache d'objets partagés basé sur la mémoire partagée.</dd>
</dl>
<h3><a name="mod_authn_socache-caching" id="mod_authn_socache-caching">Mise en cache des données d'authentification</a></h3>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authn_socache.html">mod_authn_socache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authn_socache.html#authncachesocache">AuthnCacheSOCache</a></code></li></ul></td></tr></table>
<p>Le module <code class="module"><a href="./mod/mod_authn_socache.html">mod_authn_socache</a></code> permet la mise en
cache des données issues d'une authentification, diminuant ainsi
la charge des serveurs d'authentification d'arrière-plan.</p>
<h3><a name="mod_ssl-caching" id="mod_ssl-caching">Mise en cache des sessions SSL</a></h3>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslstaplingcache">SSLStaplingCache</a></code></li></ul></td></tr></table>
<p>Le module <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> utilise l'interface
<code>socache</code> pour fournir un cache de session et un cache
de base.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="file-caching" id="file-caching">Mise en cache à base de fichiers spécialisés</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code></li><li><code class="directive"><a href="./mod/mod_file_cache.html#mmapfile">MMapFile</a></code></li></ul></td></tr></table>
<p>Sur les plateformes où le système de fichiers peut être lent, ou
lorsque les descripteurs de fichiers sont gourmands en ressources,
il est possible de précharger des fichiers en mémoire au démarrage
du serveur.</p>
<p>Sur les systèmes où l'ouverture des fichiers est lente, il est
possible d'ouvrir le fichier au démarrage du serveur et de mettre en
cache le descripteur de fichier. Ces options peuvent vous aider sur
les systèmes où l'accès aux fichiers statiques est lent.</p>
<h3><a name="filehandle" id="filehandle">Mise en cache des descripteurs de fichier</a></h3>
<p>Le processus d'ouverture d'un fichier peut être en soi une
source de ralentissement, en particulier sur les systèmes de
fichiers sur le réseau. httpd permet d'éviter ce ralentissement en
maintenant un cache des descripteurs de fichiers ouverts pour les
fichiers souvent servis. Actuellement, httpd fournit une seule
implémentation de mise en cache des descripteurs de fichiers.</p>
<h4>CacheFile</h4>
<p>La forme la plus basique de mise en cache que propose httpd
est la mise en cache des descripteurs de fichiers fournie par le
module <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code>. Plutôt que de mettre en
cache le contenu des fichiers, ce cache maintient une table des
descripteurs de fichiers ouverts. Les fichiers devant faire
l'objet d'une mise en cache de ce type sont spécifiés dans le
fichier de configuration via la directive <code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code>.</p>
<p>La directive <code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code> informe httpd
qu'il doit ouvrir le fichier lors de son démarrage et qu'il doit
réutiliser le descripteur de fichier mis en cache pour tous les
accès futurs à ce fichier.</p>
<pre class="prettyprint lang-config">CacheFile /usr/local/apache2/htdocs/index.html</pre>
<p>Si vous désirez mettre en cache un grand nombre de fichiers
de cette manière, vous devez vous assurer que le nombre maximal
de fichiers ouverts pour votre système d'exploitation est défini
à une valeur suffisante.</p>
<p>Bien que l'utilisation de la directive <code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code> n'entraîne pas de
mise en cache du contenu du fichier proprement dit, elle
implique que si le fichier est modifié pendant l'exécution du
serveur, ces modifications ne seront pas prises en compte. Le
fichier sera toujours servi dans l'état où il se trouvait au
moment du démarrage du serveur.</p>
<p>Si le fichier est supprimé pendant l'exécution du serveur, ce
dernier conservera le descripteur de fichier ouvert associé et
servira le fichier dans l'état où il se trouvait au
moment du démarrage du serveur. Cela signifie aussi que même si
le fichier a été supprimé, et n'apparaît donc plus dans le
système de fichiers, l'espace disque libéré ne sera disponible
qu'une fois le serveur httpd arrêté et donc le descripteur de
fichier fermé.</p>
<h3><a name="inmemory" id="inmemory">In-Memory Caching</a></h3>
<p>Servir un contenu directement depuis la mémoire système est
universellement reconnu comme la méthode la plus rapide. Lire des fichiers
depuis un contrôleur de disque ou pire, depuis un réseau distant est plus
lent de plusieurs ordres de grandeur. Les contrôleurs de disque réalisent
en général des opérations mécaniques, et l'accès au réseau est limité par la
bande passante dont vous disposez. Par contre, les temps d'accès à la
mémoire sont de l'ordre de la nano-seconde.</p>
<p>Cependant la mémoire système n'est pas bon marché ; à capacité égale,
c'est de loin le type de stockage le plus coûteux et il est important de
s'assurer qu'elle est utilisée efficacement. Le fait de mettre en cache
des fichiers en mémoire diminue d'autant la quantité de mémoire système
disponible. Comme nous le verrons plus loin, ce n'est pas un problème en
soi dans le cas de la mise en cache par l'intermédiaire du système
d'exploitation, mais si l'on utilise la mise en cache en mémoire propre à
httpd, il faut prendre garde à ne pas allouer trop de mémoire au cache.
Sinon le système sera contraint d'utiliser le swap, ce qui dégradera
sensiblement les performances.</p>
<h4>Mise en cache par l'intermédiaire du système d'exploitation</h4>
<p>Dans la plupart des systèmes d'exploitation modernes, c'est le noyau
qui gère directement la mise en cache en mémoire des données relatives
aux fichiers. C'est une fonctionnalité puissante, et les systèmes
d'exploitation s'en acquittent fort bien pour la plus grande partie.
Considérons par exemple, dans le cas de Linux, la différence entre le
temps nécessaire à la première lecture d'un fichier et le temps
nécessaire à sa deuxième lecture;</p>
<div class="example"><pre>colm@coroebus:~$ time cat testfile > /dev/null
real 0m0.065s
user 0m0.000s
sys 0m0.001s
colm@coroebus:~$ time cat testfile > /dev/null
real 0m0.003s
user 0m0.003s
sys 0m0.000s</pre></div>
<p>Même pour ce petit fichier, il y a une grande différence entre les
temps nécessaires pour lire le fichier. Cela est dû au fait que le
noyau a mis en cache le contenu du fichier en mémoire.</p>
<p>En s'assurant de toujours pouvoir disposer de mémoire système, vous
pouvez être assuré qu'il y aura de plus en plus de contenus de fichiers
stockés dans ce cache. Cela peut s'avérer une méthode de mise en cache en
mémoire très efficace, et ne nécessite aucune configuration supplémentaire
de httpd.</p>
<p>De plus, comme le système d'exploitation sait si des fichiers ont été
supprimés ou modifiés, il peut effacer automatiquement des contenus de
fichiers du cache lorsque cela s'avère nécessaire. Cela constitue un gros
avantage par rapport à la mise en cache en mémoire de httpd qui n'a aucune
possibilité de savoir si un fichier a été modifié.</p>
<p>En dépit des performances et des avantages de la mise en cache
automatique par le système d'exploitation, la mise en cache en mémoire
peut être effectuée plus efficacement par httpd dans certaines
circonstances.</p>
<h4>Mise en cache à l'aide de la directive MMapFile</h4>
<p>La directive <code class="directive"><a href="./mod/mod_file_cache.html#mmapfile">MMapFile</a></code>
fournie par le module <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> vous permet de
demander à httpd de charger un contenu de fichier statique en mémoire lors
de son démarrage (à l'aide de l'appel système mmap). httpd utilisera le
contenu chargé en mémoire pour satisfaire ultérieurement toutes les
demandes d'accès à ce fichier.</p>
<pre class="prettyprint lang-config">MMapFile /usr/local/apache2/htdocs/index.html</pre>
<p>Comme dans le cas de la directive
<code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code>, toute
modification du fichier ne sera plus prise en compte par httpd une fois
ce dernier démarré.</p>
<p> La directive
<code class="directive"><a href="./mod/mod_file_cache.html#mmapfile">MMapFile</a></code> ne gardant
pas la trace de la quantité de mémoire qu'elle alloue, vous devez prendre
garde de ne pas en abuser. Chaque processus enfant de httpd utilisant
sa propre réplique de la mémoire allouée, il est donc d'une importance
critique de s'assurer que les fichiers chargés ne sont pas d'une taille
trop importante afin d'épargner au système l'utilisation du swap.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Considérations sur la sécurité</a></h2>
<h3>Autorisation et contrôle d'accès</h3>
<p>Utiliser <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> revient sensiblement à la même
chose qu'avoir un mandataire inverse intégré (reverse-proxy). Les requêtes
seront servies par le module de mise en cache sauf si ce dernier
détermine qu'un processus d'arrière-plan doit être appelé. La mise en
cache de ressources locales modifie considérablement le modèle de
sécurité de httpd.</p>
<p>Comme le parcours de la hiérarchie d'un système de fichiers pour
examiner le contenu d'éventuels fichiers
<code>.htaccess</code> serait une opération très coûteuse en ressources,
annulant partiellement de ce fait l'intérêt de la mise en cache
(accélérer le traitement des requêtes),
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> ne se préoccupe pas de savoir s'il a
l'autorisation de servir une entité mise en cache. En d'autres termes,
si <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> a mis en cache un certain contenu, ce
dernier sera servi à partir du cache tant qu'il ne sera pas arrivé à
expiration.</p>
<p>Si par exemple, votre configuration autorise l'accès à une ressource
en fonction de l'adresse IP, vous devez vous assurer que ce contenu n'est
pas mis en cache. Ceci est possible en utilisant la directive
<code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code>, ou le module
<code class="module"><a href="./mod/mod_expires.html">mod_expires</a></code>. Livré à lui-même,
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> - pratiquement comme un mandataire inverse -
mettrait en cache le contenu lors de sa mise à dispisotion, et le servirait ensuite
à tout client, vers n'importe quelle adresse IP.</p>
<p>Lorsque la directive <code class="directive"><a href="./mod/mod_cache.html#cachequickhandler">CacheQuickHandler</a></code> est définie à
<code>Off</code>, toutes les phases du traitement de la requête
sont exécutées et le modèle de sécurité reste le même.</p>
<h3>Piratages locaux</h3>
<p>Etant donné que les réponses vers les utilisateurs finaux peuvent être
servies depuis le cache, ce dernier est une cible potentielle pour ceux
qui veulent défigurer un contenu ou interférer avec lui. Il est important
de garder à l'esprit que l'utilisateur sous lequel tourne
httpd doit
toujours avoir l'accès en écriture dans le cache. Ceci est en contraste
total avec la recommandation usuelle d'interdire à l'utilisateur sous
lequel tourne Apache
l'accès en écriture à tout contenu.</p>
<p>Si l'utilisateur sous lequel tourne Apache est compromis,
par exemple à cause d'une
faille de sécurité dans un processus CGI, il est possible que le cache
fasse l'objet d'une attaque. Il est relativement aisé d'insérer ou de
modifier une entité dans le cache en utilisant le module
<code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>.</p>
<p>Cela représente un risque relativement élevé par rapport aux autres
types d'attaques qu'il est possible de mener sous l'utilisateur apache.
Si vous utilisez <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>, vous devez garder ceci à
l'esprit : effectuez toujours les mises à jour de httpd quand des
correctifs de sécurité sont annoncés et exécutez les processus CGI sous un
utilisateur autre qu'apache en utilisant <a href="suexec.html">suEXEC</a>
dans la mesure du possible.</p>
<h3>Empoisonnement du cache (Cache Poisoning)</h3>
<p>Si vous utilisez httpd comme serveur mandataire avec mise en cache,
vous vous exposez aussi à un éventuel "Empoisonnement du
cache" (Cache poisoning). L'empoisonnement du cache est un terme général
pour désigner les attaques au cours desquelles l'attaquant fait en sorte
que le serveur mandataire renvoie à un contenu incorrect (et souvent
indésirable) en provenance du serveur d'origine.
</p>
<p>Par exemple, si les serveur DNS qu'utilise votre système où tourne
httpd sont vulnérables à l'empoisonnement du cache des DNS, un attaquant
pourra contrôler vers où httpd se connecte lorsqu'il demande un contenu
depuis le serveur d'origine.
Un autre exemple est constitué par les attaques ainsi nommées
"Dissimulation de requêtes HTTP" (HTTP request-smuggling).</p>
<p>Ce document n'est pas le bon endroit pour une discussion approfondie
à propos de la Dissimulation de requêtes HTTP (utilisez plutôt votre
moteur de recherche favori) ; il est cependant important de savoir qu'il
est possible d'élaborer une série de requêtes, et d'exploiter une
vulnérabilité d'un serveur web d'origine de façon que l'attaquant
puisse contrôler entièrement le contenu renvoyé par le mandataire.</p>
<h3>Déni de Service / Cachebusting</h3>
<p>Le mécanisme utilisé via l'en-tête Vary permet de mettre en
cache simultanément plusieurs variantes d'une ressource avec la
même URL. Le cache sélectionne la variante correcte à envoyer au
client en fonction des valeurs d'en-tête fournies par ce dernier.
Ce mécanisme peut devenir un problème lorsqu'on tente d'appliquer
le mécanisme des variantes à un en-tête connu pour pouvoir
posséder un grand nombre de valeurs
possibles en utilisation normal, comme par exemple l'en-tête
<code>User-Agent</code>. En fonction de la popularité du site web,
des milliers ou même des millions d'entrées de cache dupliquées
peuvent être créées pour la même URL, submergeant les autres
entrées du cache.</p>
<p>Dans d'autres cas, il peut être nécessaire de modifier l'URL
d'une ressource particulière à chaque requête, en général en lui
ajoutant une chaîne "cachebuster". Si ce contenu est déclaré comme
pouvant être mis en cache par un serveur avec une durée de
fraîcheur significative, ces entrées peuvent submerger les entrées
légitimes du cache. Alors que <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> fournit
une directive <code class="directive"><a href="./mod/mod_cache.html#cacheignoreurlsessionidentifiers">CacheIgnoreURLSessionIdentifiers</a></code>,
cette dernière doit être utilisée avec prudence pour s'assurer que
les caches du navigateur ou du mandataire le plus proche
(downstream proxy) ne sont pas victimes du même problème de Déni de
service.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/caching.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/caching.html" title="Français"> fr </a> |
<a href="./tr/caching.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/caching.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/dns-caveats.html.fr.utf8 0000664 0001751 0001751 00000032615 14740503670 021435 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Problèmes liés au DNS avec le serveur HTTP Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Problèmes liés au DNS avec le serveur HTTP Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/dns-caveats.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dns-caveats.html" title="Français"> fr </a> |
<a href="./ja/dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dns-caveats.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dns-caveats.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Cette page pourrait se résumer ainsi : configurez le
serveur HTTP Apache de façon
à ce qu'il n'ait pas besoin de résolution DNS pour interpréter les
fichiers de configuration. Si httpd doit effectuer des résolutions
DNS pour interpréter les fichiers de configuration, votre serveur
pourra présenter des problèmes de fiabilité (en d'autres termes,
il est possible qu'il refuse de démarrer), ou d'attaques par déni ou
usurpation de service (y compris l'attribution de requêtes à un
serveur virtuel autre que le serveur virtuel voulu).</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#example">Un exemple simple</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#denial">Déni de service</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#main">L'adresse du "serveur principal"</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#tips">Conseils pour éviter ce genre de problème</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="example" id="example">Un exemple simple</a></h2>
<pre class="prettyprint lang-config"># Ceci est un exemple de mauvaise configuration ; ne l'utilisez pas comme base
# de configuration
<VirtualHost www.example.dom>
ServerAdmin webgirl@example.dom
DocumentRoot "/www/example"
</VirtualHost></pre>
<p>Pour fonctionner correctement, le serveur a absolument besoin de deux
informations à propos de chaque serveur virtuel : le nom du serveur
défini par la directive <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>, et au moins une adresse IP à
laquelle le serveur va se rattacher et répondre. L'exemple ci-dessus
ne comporte pas d'adresse IP, si bien que httpd devra utiliser le
DNS pour trouver l'adresse IP de <code>www.example.dom</code>. Si pour
une raison quelconque, le DNS n'est pas disponible au moment où
votre serveur interprète son fichier de configuration, ce serveur
virtuel <strong>ne sera pas pris en compte dans la
configuration</strong>. Il sera incapable de
répondre à toute requête pour ce serveur virtuel.</p>
<p>Supposons que l'adresse de <code>www.example.dom</code> soit
192.0.2.1, et examinons cet extrait de configuration :</p>
<pre class="prettyprint lang-config"># Ceci est un exemple de mauvaise configuration ; ne l'utilisez pas comme base
# de configuration
<VirtualHost 192.0.2.1>
ServerAdmin webgirl@example.dom
DocumentRoot "/www/example"
</VirtualHost></pre>
<p>Cette fois, httpd doit effectuer une recherche DNS inverse pour
trouver le nom <code>ServerName</code> de ce serveur virtuel. Si
cette recherche inverse échoue, le serveur virtuel sera
partiellement désactivé. Si le serveur
virtuel est à base de nom, il sera en fait totalement désactivé,
mais s'il est à base d'adresse IP, il fonctionnera probablement.
Cependant, httpd échouera s'il doit générer une URL complète pour
le serveur qui inclut ce nom de serveur (comme dans le cas d'une
redirection).</p>
<p>Voici un extrait de configuration qui permet d'éviter ces deux
types de problèmes :</p>
<pre class="prettyprint lang-config"><VirtualHost 192.0.2.1>
ServerName www.example.dom
ServerAdmin webgirl@example.dom
DocumentRoot "/www/example"
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="denial" id="denial">Déni de service</a></h2>
<p>Considérons cet extrait de configuration :</p>
<pre class="prettyprint lang-config"><VirtualHost www.example1.dom>
ServerAdmin webgirl@example1.dom
DocumentRoot "/www/example1"
</VirtualHost>
<VirtualHost www.example2.dom>
ServerAdmin webguy@example2.dom
DocumentRoot "/www/example2"
</VirtualHost></pre>
<p>Supposons que vous ayez assigné 192.0.2.1 à
<code>www.example1.dom</code> et 192.0.2.2 à <code>www.example2.dom</code>. En
outre, supposons que <code>example1.dom</code> gère son propre DNS. Avec
cette configuration, <code>example1.dom</code> sera en mesure de
détourner tout trafic destiné à <code>example2.dom</code>. Pour y
parvenir, tout ce qu'ils ont à faire consiste à
assigner 192.0.2.2 à
<code>www.example1.dom</code>. Comme ils gèrent leur propre DNS, vous ne
pouvez pas les empêcher de faire pointer l'enregistrement
<code>www.example1.dom</code> vers l'adresse qu'ils veulent.</p>
<p>Les requêtes à destination de 192.0.2.2 (y compris toutes celles
où l'utilisateur à tapé une URL de la forme
<code>http://www.example2.dom/quelquepart</code>), seront toutes servies
par le serveur virtuel <code>example1.dom</code>. Une meilleur
compréhension de la raison pour laquelle ceci peut se produire
nécessite une discussion plus approfondie à propos de la manière
dont httpd associe les requêtes entrantes aux différents serveurs
virtuels qui vont les servir. Un document de base décrivant ceci <a href="vhosts/details.html">est disponible</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="main" id="main">L'adresse du "serveur principal"</a></h2>
<p><a href="vhosts/name-based.html">Le support des
serveurs virtuels à base de nom</a> oblige httpd à
connaître la/les adresse(s) IP de l'hôte sur
lequel <code class="program"><a href="./programs/httpd.html">httpd</a></code> s'exécute. Pour obtenir cette
adresse, soit il utilise la directive <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> globale (si elle est présente),
soit il fait appel à la fonction C <code>gethostname</code> (qui
doit renvoyer le même nom que la commande shell "hostname"). Il
effectue ensuite une recherche DNS sur cette adresse. Pour le
moment, il n'existe aucun moyen d'éviter cette recherche DNS.</p>
<p>Si vous craignez que cette recherche DNS échoue parce que votre
serveur DNS est arrêté, vous pouvez insérer le nom d'hôte dans le
fichier <code>/etc/hosts</code> (où il est probablement déjà
enregistré afin que la machine démarre correctement). Assurez-vous
ensuite que la machine est configurée pour utiliser
<code>/etc/hosts</code> dans le cas où la recherche DNS échoue.
Suivant le système d'exploitation que vous utilisez, vous y
parviendrez en éditant <code>/etc/resolv.conf</code>, ou
<code>/etc/nsswitch.conf</code>.</p>
<p>Si votre serveur n'a aucune autre raison d'effectuer des
recherches DNS, vous pouvez définir la variable d'environnement
<code>HOSTRESORDER</code> à "local", et vous serez alors en mesure
d'exécuter httpd. Tout dépend du système d'exploitation et des
bibliothèques de résolution de noms que vous utilisez. Elle affecte
aussi les programmes CGI, à moins que vous n'utilisiez
<code class="module"><a href="./mod/mod_env.html">mod_env</a></code> pour contrôler l'environnement. Il est
conseillé de consulter les pages de manuel ou les FAQs de votre
système d'exploitation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="tips" id="tips">Conseils pour éviter ce genre de problème</a></h2>
<ul>
<li>
utilisez des adresses IP au sein des <code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code>
</li>
<li>
utilisez des adresses IP avec la directive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
</li>
<li>
vérifiez que tous les serveurs virtuels possèdent un nom
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> explicite
</li>
<li>créez un serveur virtuel <code><VirtualHost
_default_:*></code> qui n'a aucune page à servir</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/dns-caveats.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dns-caveats.html" title="Français"> fr </a> |
<a href="./ja/dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dns-caveats.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dns-caveats.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/dns-caveats.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/handler.html.fr.utf8 0000664 0001751 0001751 00000031143 14740503670 020635 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Utilisation des gestionnaires d'Apache (handlers) - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Utilisation des gestionnaires d'Apache (handlers)</h1>
<div class="toplang">
<p><span>Langues Disponibles: </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" 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="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Ce document décrit l'utilisation des gestionnaires d'Apache (handlers).</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">Qu'est-ce qu'un gestionnaire ?</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Exemples</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programmer">Note du développeur</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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">Qu'est-ce qu'un gestionnaire ?</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</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_imagemap.html">mod_imagemap</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>Un "gestionnaire" est une représentation interne à Apache de l'action
qui doit être entreprise quand un fichier est appelé. En général, les
fichiers ont des gestionnaires implicites, basés sur le type du fichier.
Normalement, tous les fichiers sont traités simplement par le serveur,
mais certains types de fichiers sont "gérés" séparément.</p>
<p>Les gestionnaires peuvent aussi être configurés explicitement,
soit en fonction des extensions des noms de fichier, soit en fonction
du chemin du fichier,
sans faire référence au type de fichier. Ceci a le double avantage d'être
une solution plus élégante, et aussi d'autoriser à associer à la fois
un type <strong>et</strong> un gestionnaire avec un fichier. (Voir aussi <a href="mod/mod_mime.html#multipleext">Fichiers avec extensions
multiples</a>.)</p>
<p>Les gestionnaires peuvent être soit partie intégrante
du serveur ou inclus dans un module, soit ajoutés à l'aide de la directive
<code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code>. Les gestionnaires
intégrés dans la distribution standard se présentent comme suit :</p>
<ul>
<li><strong>default-handler</strong>: envoie le fichier en utilisant
le <code>default_handler()</code>, qui est le gestionnaire utilisé par
défaut pour traiter les contenus statiques. (core)</li>
<li><strong>send-as-is</strong>: envoie les fichiers avec en-têtes HTTP
tels quels. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
<li><strong>cgi-script</strong>: traite le fichier comme un
script CGI. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
<li><strong>imap-file</strong>: Traite le fichier comme un ensemble
de règles de descriptions d'images (imagemap).
(<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code>)</li>
<li><strong>server-info</strong>: Extrait des informations sur la
configuration du serveur. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
<li><strong>server-status</strong>: Rédige un rapport sur le statut
du serveur. (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
<li><strong>type-map</strong>: Traite le fichier comme une description
de type pour la négociation du contenu.
(<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">Exemples</a></h2>
<h3><a name="example1" id="example1">Modification d'un contenu statique à l'aide d'un script CGI</a></h3>
<p>Les directives suivantes vont faire en sorte que les requêtes pour
des fichiers possédant une extension <code>html</code> déclenchent
l'exécution du script CGI <code>footer.pl</code>.</p>
<pre class="prettyprint lang-config">Action add-footer /cgi-bin/footer.pl
AddHandler add-footer .html</pre>
<p>À ce moment-là, le script CGI se charge d'envoyer le document
initialement demandé (référencé par la variable d'environnement
<code>PATH_TRANSLATED</code>) et d'effectuer tous ajout ou modification
voulus.</p>
<h3><a name="example2" id="example2">Fichiers avec en-têtes HTTP</a></h3>
<p>Les directives suivantes vont activer le gestionnaire
<code>send-as-is</code>, qui est utilisé pour les fichiers qui possèdent
leurs propres en-têtes HTTP. Tous les fichiers situés dans le répertoire
<code>/web/htdocs/asis/</code> seront traités par le gestionnaire
<code>send-as-is</code>, sans tenir compte de l'extension
de leur nom de fichier.</p>
<pre class="prettyprint lang-config"><Directory "/web/htdocs/asis">
SetHandler send-as-is
</Directory></pre>
</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">Note du développeur</a></h2>
<p>Pour implémenter la fonctionnalité des gestionnaires, l'
<a href="developer/API.html">API Apache</a> a fait l'objet d'un ajout
que vous pourriez être amené à utiliser.
Plus précisément, un nouvel enregistrement a été ajouté à la structure
<code>request_rec</code> :</p>
<pre class="prettyprint lang-c">char *handler</pre>
<p>Si vous voulez que votre module déclenche l'utilisation d'un
gestionnaire, il vous suffit de définir <code>r->handler</code> avec
le nom du gestionnaire à n'importe quel moment avant l'étape
<code>invoke_handler</code>
de la requête. Les gestionnaires sont implémentés comme auparavant,
quoique l'on utilise le nom du gestionnaire à la place d'un type
de contenu. Bien que ce ne soit pas obligatoire, la convention de nommage
des gestionnaires stipule l'utilisation d'un mot composé séparé par des
tirets, sans slashes, afin de ne pas interférer avec l'espace de nommage
des types de média.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </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" 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="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/handler.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/logs.html.fr.utf8 0000664 0001751 0001751 00000130357 14740503670 020173 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Fichiers journaux - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Fichiers journaux</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/logs.html" title="Français"> fr </a> |
<a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Pour véritablement gérer un serveur web,
il est nécessaire de disposer d'un
retour d'informations à propos de l'activité et des performances du
serveur, ainsi que de tout problème qui pourrait survenir. Le serveur HTTP
Apache propose des fonctionnalités de journalisation souples et très
complètes. Ce document décrit comment configurer ces fonctionnalités de
journalisation et interpréter le contenu des journaux.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Vue d'ensemble</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#security">Avertissement à propos de la sécurité</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errorlog">Journal des erreurs</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#permodule">Journalisation par module</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#accesslog">Journal des accès</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rotation">Rotation des journaux</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#piped">Journaux redirigés</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Hôtes virtuels</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">Autres fichiers journaux</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="overview" id="overview">Vue d'ensemble</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td /></tr></table>
<p>
Le serveur HTTP Apache fournit toute une variété de mécanismes
différents pour la journalisation de tout ce qui peut se passer au
sein de votre serveur, depuis la requête initiale, en passant par le
processus de mise en correspondance des URLs, et jusqu'à la fermeture
de la connexion, y compris toute erreur pouvant survenir au cours du
traitement. De plus, certains modules tiers fournissent des
fonctionnalités de journalisation ou insèrent des entrées dans les
fichiers journaux existants, et les applications comme les programmes
CGI, les scripts PHP ou autres gestionnaires peuvent envoyer des
messages vers le journal des erreurs du serveur.
</p>
<p>
Ce document décrit le fonctionnement des modules de journalisation
fournis en standard avec le serveur httpd.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Avertissement à propos de la sécurité</a></h2>
<p>Tout utilisateur qui a les droits en écriture sur le répertoire dans
lequel Apache httpd écrit ses journaux pourra quasi
certainement avoir accès à l'uid sous lequel le serveur est démarré, en
l'occurrence habituellement root. N'accordez <em>PAS</em> aux utilisateurs
l'accès en écriture au répertoire dans lequel les journaux sont stockés
sans savoir exactement quelles en seraient les conséquences ; voir le
document <a href="misc/security_tips.html">conseils sur la sécurité</a>
pour plus de détails.</p>
<p>En outre, les journaux peuvent contenir des informations fournies
directement par un client, sans caractères d'échappement. Des clients mal
intentionnés peuvent donc insérer des caractères de contrôle dans les
journaux, et il convient par conséquent d'être très prudent lors de la
manipulation des journaux bruts.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errorlog" id="errorlog">Journal des erreurs</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code></li></ul></td></tr></table>
<p>Le journal des erreurs du serveur, dont le nom et la localisation sont
définis par la directive <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code>,
est le journal le plus important. C'est dans celui-ci
que le démon Apache httpd va envoyer les informations de diagnostic et
enregistrer toutes les erreurs qui surviennent lors du traitement des
requêtes. Lorsqu'un problème survient au démarrage du serveur ou pendant
son fonctionnement, la première chose à faire est de regarder dans ce
journal, car il vous renseignera souvent sur le problème rencontré et
la manière d'y remédier.</p>
<p>Le journal des erreurs est habituellement enregistré dans un fichier
(en général <code>error_log</code> sur les systèmes de type Unix et
<code>error.log</code> sur Windows et OS/2). Sur les systèmes de type Unix,
le serveur peut aussi enregistrer ses erreurs dans
<code>syslog</code> ou les
<a href="#piped">rediriger vers un programme</a> par l'intermédiaire d'un
tube de communication (pipe).</p>
<p>Le format par défaut du journal des erreurs est descriptif et de forme
relativement libre. Certaines informations apparaissent cependant dans la
plupart des entrées du journal. Voici un message typique
à titre d'exemple : </p>
<div class="example"><p><code>
[Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1]
client denied by server configuration:
/export/home/live/ap/htdocs/test
</code></p></div>
<p>Le premier champ de l'entrée du journal est la date et l'heure du
message. Le second champ indique la sévérité de l'erreur rapportée. La
directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> permet de
restreindre le type des erreurs qui doivent être enregistrées
dans le journal des erreurs en définissant leur niveau de sévérité. Le
troisième champ contient l'adresse IP du client qui a généré l'erreur.
Vient ensuite le message proprement dit, qui indique dans ce cas que le
serveur a été configuré pour interdire l'accès au client. Le serveur
indique le chemin système du document requis (et non
son chemin web).</p>
<p>Une grande variété de messages différents peuvent apparaître dans le
journal des erreurs. La plupart d'entre eux sont similaires à l'exemple
ci-dessus. Le journal des erreurs peut aussi contenir des informations de
débogage en provenance de scripts CGI. Toute information qu'un script CGI
écrit sur la sortie d'erreurs standard <code>stderr</code> sera recopiée
telle quelle dans le journal des erreurs.</p>
<p>La directive <code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code>
vous permet de personnaliser le format du journal des erreurs, et de
définir les informations à journaliser. Si
<code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code> est présent, vous pouvez utiliser le
drapeau <code>%L</code> à la fois dans le journal des erreurs et
dans le
journal des accès, ce qui aura pour effet de générer un identifiant
d'entrée qui vous permettra de corréler les entrées du journal des
erreurs avec celles du journal des accès.</p>
<p>Pendant la phase de test, il est souvent utile de visualiser en continu
le journal des erreurs afin de détecter tout problème éventuel. Sur les
systèmes de type Unix, ceci s'effectue à l'aide de la commande :</p>
<div class="example"><p><code>
tail -f error_log
</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="permodule" id="permodule">Journalisation par module</a></h2>
<p>La directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> permet
de spécifier un niveau de sévérité de journalisation pour chaque
module. Vous pouvez ainsi résoudre un problème propre à un module particulier
en augmentant son volume de journalisation sans augmenter ce volume
pour les autres modules. Ceci est particulièrement utile lorsque
vous voulez obtenir des détails sur le fonctionnement de modules
comme <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> ou <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
<p>Pour ce faire, vous devez spécifier le nom du module dans votre
directive <code class="directive">LogLevel</code> :</p>
<pre class="prettyprint lang-config">LogLevel info rewrite:trace5</pre>
<p>Dans cet exemple, le niveau de journalisation général est défini
à info, et à <code>trace5</code> pour <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
<div class="note">Cette directive remplace les directives de journalisation par
module des versions précédentes du serveur, comme
<code>RewriteLog</code>.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="accesslog" id="accesslog">Journal des accès</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li></ul></td></tr></table>
<p>Le journal des accès au serveur
enregistre toutes les requêtes que traite
ce dernier. La localisation et le contenu du journal des accès sont définis
par la directive <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>.
La directive <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
permet de simplifier la sélection du contenu du journal. Cette section
décrit comment configurer le serveur pour l'enregistrement des informations
dans le journal des accès.</p>
<p>Le stockage d'informations dans le journal des accès
n'est que le point de départ de la gestion de la journalisation. L'étape
suivante consiste à analyser ces informations de façon à pouvoir en
extraire des statistiques utiles. L'analyse de journaux en général est en
dehors du sujet de ce document et ne fait pas vraiment partie intégrante
du travail du serveur web lui-même.</p>
<p>Différentes versions du démon Apache httpd utilisaient d'autres modules
et directives pour contrôler la journalisation des accès, à l'instar de
mod_log_referer, mod_log_agent, et de la directive
<code>TransferLog</code>. La directive
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> rassemble
désormais les fonctionnalités de toutes les anciennes directives.</p>
<p>Le format du journal des accès est hautement configurable. Il est
défini à l'aide d'une chaîne de format qui ressemble sensiblement à la
chaîne de format de style langage C de printf(1). Vous trouverez quelques
exemples dans les sections suivantes. Pour une liste exhaustive de ce que
peut contenir une chaîne de format, vous pouvez vous référer au chapitre
<a href="mod/mod_log_config.html#formats">chaînes de format</a> de la
documentation du module <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code>.</p>
<h3><a name="common" id="common">Format habituel du journal</a></h3>
<p>Voici une configuration typique pour le journal des accès :</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common</pre>
<p>Ici est définie l'<em>identité</em> <code>common</code> qui est
ensuite associée à une chaîne de format de journalisation particulière.
La chaîne de format est constituée de directives débutant par le
caractère %, chacune d'entre elles indiquant au serveur d'enregistrer
un élément particulier d'information. Des caractères littéraux peuvent
aussi être insérés dans la chaîne de format ; il seront copiés tels
quels dans le flux de sortie destiné à la journalisation.
Les guillemets (<code>"</code>) doivent être échappées en les faisant
précéder d'un anti-slash (<code>\</code>) afin qu'elles ne soient pas
interprétées comme la fin de la chaîne de format. La chaîne de format
peut aussi contenir les caractères de contrôle spéciaux
"<code>\n</code>" et "<code>\t</code>" pour insérer respectivement
un passage à la ligne et une tabulation.</p>
<p>La directive <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
définit un nouveau fichier journal en l'associant à l'identité
précédemment définie. Le chemin du nom de fichier associé au journal
des accès est relatif au chemin défini par la directive
<code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>, sauf s'il
débute par un slash.</p>
<p>La configuration ci-dessus va enregistrer les entrées de
journalisation selon un format connu sous le nom de
Common Log Format (CLF) pour "Format de journalisation standard".
Ce format standard peut être produit par de nombreux serveurs web
différents et lu par de nombreux programmes d'analyse de journaux.
Les entrées de fichier journal générées selon le format CLF
ressemblent à ceci :</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
</code></p></div>
<p>Chaque partie de cette entrée de journal est décrite
dans ce qui suit.</p>
<dl>
<dt><code>127.0.0.1</code> (<code>%h</code>)</dt>
<dd>Il s'agit de l'adresse IP du client (l'hôte distant) qui a envoyé
la requête au serveur. Si la directive
<code class="directive"><a href="./mod/core.html#hostnamelookups">HostnameLookups</a></code> est positionnée à
<code>On</code>, le serveur va essayer de déterminer le nom de l'hôte
et de l'enregistrer à la place de l'adresse IP. Cette configuration
n'est cependant pas recommandée car elle peut ralentir le serveur de
manière significative. Il est par conséquent préférable d'utiliser un
processeur d'analyse de journaux a posteriori
tel que <code class="program"><a href="./programs/logresolve.html">logresolve</a></code>
pour déterminer les noms d'hôte. L'adresse IP indiquée ici n'est pas
nécessairement l'adresse IP de la machine devant laquelle se trouve
l'utilisateur. Si un serveur mandataire s'intercale entre le serveur
et l'utilisateur, l'adresse indiquée sera celle du mandataire et non
celle de la machine à l'origine de la requête.</dd>
<dt><code>-</code> (<code>%l</code>)</dt>
<dd>Le "trait d'union" indique que la portion d'information
correspondante n'est pas disponible. Dans le cas présent, l'information
non disponible est l'identité (RFC 1413) du client telle que déterminée
par <code>identd</code> sur la machine cliente. Cette information est
très peu fiable et ne devrait jamais être utilisée, sauf dans le cas
de réseaux internes étroitement contrôlés. Le démon httpd ne cherchera
d'ailleurs à obtenir cette information que si la directive
<code class="directive"><a href="./mod/mod_ident.html#identitycheck">IdentityCheck</a></code> est positionnée
à <code>On</code>.</dd>
<dt><code>frank</code> (<code>%u</code>)</dt>
<dd>Il s'agit de l'identifiant utilisateur de la personne qui a
demandé le document, issu d'une authentification HTTP.
Ce même identifiant est en général fourni aux scripts CGI par
l'intermédiaire de la valeur de la variable d'environnement
<code>REMOTE_USER</code>. Si le statut de la requête (voir plus loin)
est 401, cette identifiant n'est pas fiable car l'utilisateur n'est
pas encore authentifié. Si le document n'est pas protégé par
mot de passe, cette partie d'information sera représentée par
"<code>-</code>", comme la partie précédente.</dd>
<dt><code>[10/Oct/2000:13:55:36 -0700]</code>
(<code>%t</code>)</dt>
<dd>
L'heure à laquelle la requête a été reçue.
Le format est le suivant :
<p class="indent">
<code>[jour/mois/année:heure:minutes:secondes zone]<br />
jour = 2*chiffre<br />
mois = 3*lettre<br />
année = 4*chiffre<br />
heure = 2*chiffre<br />
minutes = 2*chiffre<br />
secondes = 2*chiffre<br />
zone = (`+' | `-') 4*chiffre</code>
</p>Il est possible de modifier le format d'affichage de l'heure
en spécifiant <code>%{format}t</code> dans la chaîne de format du
journal, où <code>format</code> est une chaîne de format
de la forme de celle de la fonction <code>strftime(3)</code>
de la bibliothèque C standard, ou choisie parmi les
formats spéciaux supportés. Pour plus de détails,
reportez-vous aux. <a href="mod/mod_log_config.html#formats">chaînes de format</a>
de <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code>.
</dd>
<dt><code>"GET /apache_pb.gif HTTP/1.0"</code>
(<code>\"%r\"</code>)</dt>
<dd>La ligne de la requête du client est placée entre guillemets.
Elle contient de nombreuses informations utiles. Tout d'abord, la
méthode utilisée par le client est <code>GET</code>. Ensuite, le
client a demandé la ressource <code>/apache_pb.gif</code>, et enfin,
le client a utilisé le protocole <code>HTTP/1.0</code>. Il est aussi
possible d'enregistrer séparément une ou plusieurs parties de la
requête. Par exemple, la chaîne de format "<code>%m %U %q %H</code>"
va enregistrer la méthode, le chemin, la chaîne de la requête et le
protocole, ce qui donnera le même résultat que
"<code>%r</code>".</dd>
<dt><code>200</code> (<code>%>s</code>)</dt>
<dd>C'est le code de statut que le serveur retourne au client. Cette
information est très importante car elle indique si la requête a fait
l'objet d'une réponse positive (codes commençant par 2), une
redirection (codes commençant par 3), une erreur due au client (codes
commençant par 4), ou une erreur due au serveur (codes commençant
par 5). Vous trouverez la liste complète des codes de statut possibles
dans la <a href="http://www.w3.org/Protocols/rfc2616/ rfc2616.txt">specification HTTP</a> (RFC2616 section 10).</dd>
<dt><code>2326</code> (<code>%b</code>)</dt>
<dd>La dernière partie indique la taille de l'objet retourné au client,
en-têtes non compris. Si aucun contenu n'a été retourné au client, cette
partie contiendra "<code>-</code>". Pour indiquer l'absence de contenu
par "<code>0</code>", utilisez <code>%B</code> au lieu de
<code>%b</code>.</dd>
</dl>
<h3><a name="combined" id="combined">Combined Log Format (Format de journalisation combiné)</a></h3>
<p>Une autre chaîne de format couramment utilisée est le
"Combined Log Format" (Format de journalisation combiné). Il s'utilise
comme suit :</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" combined
CustomLog log/access_log combined</pre>
<p>Ce format est identique au Common Log Format, avec deux champs
supplémentaires. Chacun de ces deux champs utilise la directive
commençant par le caractère "%" <code>%{<em>header</em>}i</code>,
où <em>header</em> peut être n'importe quel en-tête de requête HTTP.
Avec ce format, le journal des accès se présentera comme suit :</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
"http://www.example.com/start.html" "Mozilla/4.08 [en]
(Win98; I ;Nav)"
</code></p></div>
<p>Les champs supplémentaires sont :</p>
<dl>
<dt><code>"http://www.example.com/start.html"</code>
(<code>\"%{Referer}i\"</code>)</dt>
<dd>L'en-tête "Referer" (sic) de la requête HTTP. Il indique le site
depuis lequel le client prétend avoir lancé sa requête. (Ce doit être
la page qui contient un lien vers <code>/apache_pb.gif</code> ou
inclut ce dernier fichier).</dd>
<dt><code>"Mozilla/4.08 [en] (Win98; I ;Nav)"</code>
(<code>\"%{User-agent}i\"</code>)</dt>
<dd>L'en-tête User-Agent de la requête HTTP. C'est une information
d'identification que le navigateur du client envoie à propos
de lui-même.</dd>
</dl>
<h3><a name="multiple" id="multiple">Journaux d'accès multiples</a></h3>
<p>Plusieurs journaux d'accès peuvent être créés en spécifiant tout
simplement plusieurs directives
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> dans le
fichier de configuration. Par exemple, les directives suivantes vont
créer trois journaux d'accès. Le premier contiendra les informations
de base CLF, le second les informations du Referer, et le troisième
les informations sur le navigateur. Les deux dernières directives
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> montrent
comment simuler les effets des directives <code>ReferLog</code> et
<code>AgentLog</code>.</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common
CustomLog logs/referer_log "%{Referer}i -> %U"
CustomLog logs/agent_log "%{User-agent}i"</pre>
<p>Cet exemple montre aussi qu'il n'est pas obligatoire d'associer
une chaîne de format à un alias au moyen de la directive
<code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>. Elle peut
être définie directement dans la ligne de la directive
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>.</p>
<h3><a name="conditional" id="conditional">Journalisation conditionnelle</a></h3>
<p>Il est parfois souhaitable d'exclure certaines entrées des journaux
d'accès en fonction des caractéristiques de la requête du client. On
peut aisément accomplir ceci à l'aide des
<a href="env.html">variables d'environnement</a>. Tout d'abord, une
variable d'environnement doit être définie pour indiquer que la
requête remplit certaines conditions. Pour ceci, on utilise en général
la directive <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>,
puis la clause <code>env=</code> de la directive
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> pour inclure
ou exclure les requêtes pour lesquelles
la variable d'environnement est définie.
Quelques exemples :</p>
<pre class="prettyprint lang-config"># Marque les requêtes en provenance de l'interface loop-back
SetEnvIf Remote_Addr "127\.0\.0\.1" dontlog
# Marque les requêtes pour le fichier robots.txt
SetEnvIf Request_URI "^/robots\.txt$" dontlog
# Journalise toutes les autres requêtes
CustomLog logs/access_log common env=!dontlog</pre>
<p>Autre exemple, imaginons l'enregistrement des requêtes en provenance
d'utilisateurs de langue anglaise dans un journal, et celles des autres
utilisateurs dans un autre journal.</p>
<pre class="prettyprint lang-config"> SetEnvIf Accept-Language "en" english
CustomLog logs/english_log common env=english
CustomLog logs/non_english_log common env=!english</pre>
<p>Dans le contexte d'une mise en cache, il peut être
intéressant de connaître l'efficacité du cache. Pour y parvenir,
on pourrait utiliser cette méthode simple :</p>
<pre class="prettyprint lang-config">SetEnv CACHE_MISS 1
LogFormat "%h %l %u %t "%r " %>s %b %{CACHE_MISS}e" common-cache
CustomLog logs/access_log common-cache</pre>
<p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> va s'exécuter avant
<code class="module"><a href="./mod/mod_env.html">mod_env</a></code>, et si son action est couronnée de
succès, il délivrera le contenu sans faire appel à ce dernier. Si
l'URL se trouve dans le cache, la valeur journalisée sera alors
<code>-</code>, tandis que dans le cas contraire elle sera
<code>1</code>.</p>
<p>En plus de la syntaxe <code>env=</code>, la directive <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> supporte les
valeurs de journalisation conditionnelles basées sur le code de la
réponse HTTP :</p>
<pre class="prettyprint lang-config">LogFormat "%400,501{User-agent}i" browserlog
LogFormat "%!200,304,302{Referer}i" refererlog</pre>
<p>Dans le premier exemple, le <code>User-agent</code> sera
enregistré si le code d'état HTTP est 400 ou 501. Dans le cas
contraire, c'est un caractère "-" qui sera enregistré à la place.
Dans le second exemple, le <code>Referer</code> sera enregistré si
le code d'état HTTP n'est <strong>pas</strong> 200, 304, ou 302
(remarquez le caractère "!" avant les codes d'état).</p>
<p>Bien que nous venions de montrer que la journalisation conditionnelle
est souple et très puissante, cette méthode de contrôle du contenu des
journaux n'est pas la seule. Les fichiers journaux sont plus utiles
quand ils contiennent un enregistrement complet de l'activité du serveur,
et il est souvent plus aisé de simplement traiter à posteriori les fichiers
journaux pour supprimer les requêtes que vous ne voulez pas y voir
apparaître.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="rotation" id="rotation">Rotation des journaux</a></h2>
<p>Même dans le cas d'un serveur modérément sollicité, la quantité
d'informations stockées dans les fichiers journaux est très importante.
Le fichier journal des accès grossit en général d'1 Mo ou plus toutes
les 10000 requêtes. Il est par conséquent nécessaire d'effectuer
périodiquement la rotation des journaux en déplaçant ou supprimant les
fichiers correspondants. On ne peut pas le faire pendant que le serveur
est en cours d'exécution, car Apache httpd va continuer à écrire dans l'ancien
fichier journal aussi longtemps qu'il le maintiendra ouvert.
C'est pourquoi le serveur doit être
<a href="stopping.html">redémarré</a> après le déplacement ou la
suppression des fichiers journaux de façon à ce qu'il en ouvre
de nouveaux.</p>
<p>Avec un redémarrage <em>graceful</em>, on peut faire en sorte que le
serveur ouvre de nouveaux fichiers journaux sans perdre de connexions
existantes ou en cours avec les clients. Cependant, pour que ceci soit
possible, le serveur doit continuer à écrire dans les anciens fichiers
journaux pendant qu'il termine le traitement des requêtes en cours.
Il est donc nécessaire d'attendre un certain temps après le rédémarrage
avant d'effectuer tout traitement sur les fichiers journaux. Voici un
scénario typique dans lequel on effectue une simple rotation des
journaux en compressant les anciens fichiers correspondants afin
de gagner de l'espace disque :</p>
<div class="example"><p><code>
mv access_log access_log.old<br />
mv error_log error_log.old<br />
apachectl graceful<br />
sleep 600<br />
gzip access_log.old error_log.old
</code></p></div>
<p>La section suivante présente une autre méthode de rotation des journaux
qui consiste à utiliser les
<a href="#piped">journaux redirigés</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="piped" id="piped">Journaux redirigés</a></h2>
<p>Nous avons vu que le démon httpd écrivait les informations de
journalisation des erreurs et des accès dans un fichier journal ;
il peut aussi
rediriger ces informations vers un autre processus par l'intermédiaire d'un
tube de communication (pipe). Cette fonctionnalité améliore
considérablement la souplesse de la journalisation, sans ajouter de code
au serveur principal. Pour rediriger les informations de journalisation
vers un tube de communication, remplacez simplement le nom de fichier
journal par
le caractère pipe "<code>|</code>", suivi du nom de l'exécutable qui va
recueillir les entrées de journal sur son entrée
standard. Le serveur va
lancer le processus de redirection des journaux au moment du démarrage du
serveur, et le relancera s'il cesse de fonctionner
pendant l'exécution du serveur.
(Nous dénommons cette technique "journalisation
redirigée fiable" grâce à cette dernière fonctionnalité.)</p>
<p>Les processus de journalisation redirigée sont lancés par le processus
httpd parent, et héritent de l'UID de ce dernier. Cela signifie que les
programmes de journalisation dirigée s'exécutent généralement en tant que
root. Il est donc très important que ces programmes soient simples et
sécurisés.</p>
<p>Un des grands avantages de la journalisation redirigée est la possibilité
d'effectuer la rotation des journaux sans avoir à redémarrer le serveur. Pour
accomplir cette tâche, le serveur HTTP Apache fournit un programme simple
appelé <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code>. Par exemple, pour une rotation des
journaux toutes les 24 heures, ajoutez ces lignes :</p>
<pre class="prettyprint lang-config">CustomLog "|/usr/local/apache/bin/rotatelogs /var/log/access_log 86400" common</pre>
<p>Notez que l'ensemble de la commande qui sera appelée par le tube de
communication a été placée entre guillemets. Bien que cet exemple
concerne le journal des accès, la même technique peut être utilisée
pour le journal des erreurs.</p>
<p>Comme la journalisation conditionnelle, la journalisation redirigée est
un outil très puissant, mais si elle existe, il est préférable d'utiliser
une solution plus simple comme le traitement à posteriori hors ligne.</p>
<p>Par défaut, le processus de redirection du journal est lancé sans
invoquer un shell. Pour invoquer un shell, utilisez "<code>|$</code>"
au lieu de "<code>|</code>" (en général avec <code>/bin/sh -c</code>)
:</p>
<pre class="prettyprint lang-config"># Invocation de "rotatelogs" en utilisant un shell
CustomLog "|$/usr/local/apache/bin/rotatelogs /var/log/access_log 86400" common</pre>
<p>Il s'agissait du comportement par défaut sous Apache 2.2. Selon
les spécificités du shell, ceci peut générer un processus shell
supplémentaire pour toute la durée du programme de redirection du
journal, et induire des problèmes de gestion de signaux au cours du
redémarrage. La notation "<code>||</code>" est aussi supportée pour
des raisons de compatibilité avec Apache 2.2 et est équivalente à
"<code>|</code>".</p>
<div class="note"><h3>Note à propos de la plateforme Windows</h3>
<p>Notez que sous Windows, la mémoire allouée au bureau (desktop
heap) peut devenir insuffisante si vous utilisez de nombreux
processus vers lesquels sont redirigés des journaux via un pipe, et
ceci particulièrement si httpd s'exécute en tant que service. La
quantité de mémoire du bureau allouée à chaque service est spécifiée
dans le troisième argument du paramètre <code>SharedSection</code>
de la clé de registre
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\SessionManager\SubSystems\Windows.
<strong>Modifiez cette valeur avec prudence</strong> ; les
précautions d'usage s'imposent lorsqu'on modifie la base de registre,
mais vous pouvez aussi saturer la mémoire du bureau si vous
spécifiez une valeur trop élevée.</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="virtualhost" id="virtualhost">Hôtes virtuels</a></h2>
<p>Lorsqu'un serveur possède plusieurs <a href="vhosts/">hôtes virtuels</a>, il existe de nombreuses solutions pour gérer
les fichiers journaux. Par exemple, on peut utiliser les journaux comme
s'il s'agissait d'un serveur avec un seul hôte. Il suffit pour cela de
placer les directives de journalisation en dehors des sections
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> au niveau
du serveur principal, ce qui a pour effet de journaliser toutes les
requêtes dans le même journal des accès et des erreurs. Cette technique
est cependant inappropriée pour recueillir des statistiques sur chaque
hôte virtuel individuellement.</p>
<p>Si des directives <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> ou
<code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> sont placées dans une section
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>, toutes les
requêtes ou erreurs pour cet hôte virtuel ne seront enregistrées que dans
le fichier spécifié. Tout hôte virtuel qui ne possède pas de directives de
journalisation verra ses requêtes enregistrées dans le journal du serveur
principal. Cette technique est appropriée pour un petit nombre d'hôtes
virtuels, mais si ce nombre est important, elle peut devenir compliquée à
gérer. En outre, des problèmes de <a href="vhosts/fd-limits.html">nombre de descripteurs
de fichiers insuffisant</a> peuvent rapidement apparaître.</p>
<p>Il existe un très bon compromis pour le journal des accès. En intégrant
les informations à propos de l'hôte virtuel à la chaîne de format du
journal, il est possible de journaliser tous les hôtes dans le même
journal, puis de séparer ultérieurement le journal en plusieurs journaux
individuels. Considérons par exemple les directives suivantes :</p>
<pre class="prettyprint lang-config">LogFormat "%v %l %u %t \"%r\" %>s %b" comonvhost
CustomLog logs/access_log comonvhost</pre>
<p>Le champ <code>%v</code> sert à enregistrer le nom de l'hôte virtuel qui
traite la requête. Un programme tel que <a href="programs/split-logfile.html">split-logfile</a> peut ensuite être utilisé
pour générer "à froid" autant de journaux que d'hôtes virtuels.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Autres fichiers journaux</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#bufferedlogs">BufferedLogs</a></code></li><li><code class="directive"><a href="./mod/mod_log_forensic.html#forensiclog">ForensicLog</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptloglength">ScriptLogLength</a></code></li></ul></td></tr></table>
<h3>Enregistrement du nombre réel d'octets envoyés et reçus</h3>
<p>Le module <code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code> fournit deux champs
<code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> supplémentaires
(%I et %O) qui permettent d'enregistrer le nombre réel d'octets reçus et
envoyés sur le réseau.</p>
<h3>Journalisation de style investigation judiciaire (forensic logging)</h3>
<p>Le module <code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code> permet la journalisation
à des fins d'investigation judiciaire des requêtes des clients. La
journalisation est effectuée avant et après le traitement de la requête,
qui fait donc l'objet de deux entrées dans le journal. Le générateur de
journaux d'investigation est très strict et ne permet aucune
personnalisation. C'est un inestimable outil de débogage et de sécurité.</p>
<h3><a name="pidfile" id="pidfile">Fichier PID</a></h3>
<p>Au démarrage, le démon httpd Apache enregistre l'identifiant du
processus httpd parent dans le fichier <code>logs/httpd.pid</code>.
Le nom de ce fichier peut être modifié à l'aide de la directive
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>. Cet identifiant
permet à l'administrateur de redémarrer et arrêter le démon en
envoyant des signaux au processus parent ; sous Windows, vous devez
utiliser l'option de ligne de commande -k. Pour plus de détails,
consulter la page <a href="stopping.html">Arrêt et redémarrage</a>.</p>
<h3><a name="scriptlog" id="scriptlog">Journal des scripts</a></h3>
<p>Afin de faciliter le débogage, la directive
<code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code> vous permet
d'enregistrer les entrées et sorties des scripts CGI. Elle ne doit être
utilisée que pendant la phase de test, et en aucun cas sur un
serveur en production. Vous trouverez plus d'informations dans la
documentation du module <a href="mod/mod_cgi.html">mod_cgi</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/logs.html" title="Français"> fr </a> |
<a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/logs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/expr.html.fr.utf8 0000664 0001751 0001751 00000115070 14740503670 020200 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Les expressions dans le serveur HTTP Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Les expressions dans le serveur HTTP Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/expr.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/expr.html" title="Français"> fr </a></p>
</div>
<p>Historiquement, il existe de nombreuses variantes dans la syntaxe
des expressions permettant d'exprimer une condition dans les
différents modules du serveur HTTP Apache. À ce titre, des travaux sont
en cours pour n'utiliser qu'une seule variante nommée
<em>ap_expr</em>, pour toutes les directives de configuration. Ce
document décrit l'interpréteur d'expressions <em>ap_expr</em>.
</p>
<p>Le type d'expression <em>ap_expr</em> est appelé à remplacer la
plupart des autres types d'expressions dans HTTPD. Par exemple, la
directive obsolète <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code> peut être remplacée par la
directive <a href="mod/mod_authz_core.html#reqexpr">Require
expr</a>.
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#grammar">Syntaxe en Forme de Backus-Naur</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#vars">Variables</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#binop">Opérateurs binaires</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#unnop">Opérateurs unaires</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#functions">Fonctions</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Exemples d'expressions</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">Autres</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#sslrequire">Comparaison avec SSLRequire</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#compatibility">Historique de version</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="directive"><a href="./mod/core.html#if">If</a></code></li><li><code class="directive"><a href="./mod/core.html#if"><If></a></code></li><li><code class="directive"><a href="./mod/core.html#elseif"><ElseIf></a></code></li><li><code class="directive"><a href="./mod/core.html#else"><Else></a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_auth_basic.html#authbasicfake">AuthBasicFake</a></code></li><li><code class="directive"><a href="./mod/mod_auth_form.html#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code></li><li><code class="directive"><a href="./mod/mod_auth_form.html#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code></li><li><code class="directive"><a href="./mod/mod_auth_form.html#authformlogoutlocation">AuthFormLogoutLocation</a></code></li><li><code class="directive"><a href="./mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="./mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifexpr">SetEnvIfExpr</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#requestheader">RequestHeader</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code></li><li><a href="mod/mod_authz_core.html#reqexpr">Require expr</a></li><li><a href="mod/mod_authnz_ldap.html#requser">Require ldap-user</a></li><li><a href="mod/mod_authnz_ldap.html#reqgroup">Require ldap-group</a></li><li><a href="mod/mod_authnz_ldap.html#reqdn">Require ldap-dn</a></li><li><a href="mod/mod_authnz_ldap.html#reqattribute">Require ldap-attribute</a></li><li><a href="mod/mod_authnz_ldap.html#reqfilter">Require ldap-filter</a></li><li><a href="mod/mod_authnz_ldap.html#reqsearch">Require ldap-search</a></li><li><a href="mod/mod_authz_dbd.html#reqgroup">Require dbd-group</a></li><li><a href="mod/mod_authz_dbm.html#reqgroup">Require dbm-group</a></li><li><a href="mod/mod_authz_groupfile.html#reqgroup">Require group</a></li><li><a href="mod/mod_authz_host.html#reqhost">Require host</a></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code></li><li><code class="directive"><a href="./mod/mod_log_debug.html#logmessage">LogMessage</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><a href="#comments_section">Commentaires</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="grammar" id="grammar">Syntaxe en Forme de Backus-Naur</a></h2>
<p>La <a href="http://fr.wikipedia.org/wiki/Forme_de_Backus-Naur">Forme de Backus-Naur</a>
(souvent abrégée en BNF, de l'anglais Backus-Naur Form) est une notation permettant de décrire
les règles syntaxiques des langages de programmation. En
général, les expressions représentent des valeurs booléennes. Dans
ce cas, le point de départ de la BNF est <code>expr</code>.
Cependant, certaines directives comme <code class="directive"><a href="./mod/mod_log_debug.html#logmessage">LogMessage</a></code> utilisent comme
paramètres des expressions qui représentent des chaînes de
caractères. Dans ce cas, le point de départ de la BNF est
<code>string</code>.
</p>
<blockquote>
<pre>expr ::= "<strong>true</strong>" | "<strong>false</strong>"
| "<strong>!</strong>" expr
| expr "<strong>&&</strong>" expr
| expr "<strong>||</strong>" expr
| "<strong>(</strong>" expr "<strong>)</strong>"
| comp
comp ::= stringcomp
| integercomp
| unaryop word
| word binaryop word
| word "<strong>in</strong>" "<strong>{</strong>" wordlist "<strong>}</strong>"
| word "<strong>in</strong>" listfunction
| word "<strong>=~</strong>" regex
| word "<strong>!~</strong>" regex
stringcomp ::= word "<strong>==</strong>" word
| word "<strong>!=</strong>" word
| word "<strong><</strong>" word
| word "<strong><=</strong>" word
| word "<strong>></strong>" word
| word "<strong>>=</strong>" word
integercomp ::= word "<strong>-eq</strong>" word | word "<strong>eq</strong>" word
| word "<strong>-ne</strong>" word | word "<strong>ne</strong>" word
| word "<strong>-lt</strong>" word | word "<strong>lt</strong>" word
| word "<strong>-le</strong>" word | word "<strong>le</strong>" word
| word "<strong>-gt</strong>" word | word "<strong>gt</strong>" word
| word "<strong>-ge</strong>" word | word "<strong>ge</strong>" word
wordlist ::= word
| wordlist "<strong>,</strong>" word
word ::= word "<strong>.</strong>" word
| digit
| "<strong>'</strong>" string "<strong>'</strong>"
| "<strong>"</strong>" string "<strong>"</strong>"
| variable
| rebackref
| function
string ::= stringpart
| string stringpart
stringpart ::= cstring
| variable
| rebackref
cstring ::= ...
digit ::= [0-9]+
variable ::= "<strong>%{</strong>" varname "<strong>}</strong>"
| "<strong>%{</strong>" funcname "<strong>:</strong>" funcargs "<strong>}</strong>"
rebackref ::= "<strong>$</strong>" [0-9]
function ::= funcname "<strong>(</strong>" word "<strong>)</strong>"
listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>"</pre>
</blockquote>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="vars" id="vars">Variables</a></h2>
<p>L'interpréteur d'expressions fournit plusieurs variables de la
forme <code>%{HTTP_HOST}</code>. Notez que la valeur d'une variable
peut dépendre de la phase du traitement de la requête au cours de
laquelle elle est évaluée. Par exemple, une expression utilisée dans
une directive <code class="directive"><If ></code> sera évaluée avant
la phase d'authentification. Par conséquent, la variable
<code>%{REMOTE_USER}</code> ne sera pas encore définie à ce stade.</p>
<p>Les variables suivantes contiennent la valeur de l'en-tête de
requête HTTP correspondant. La <a href="#functions">fonction</a>
<code>req</code> permet d'extraire les valeurs des autres
en-têtes. L'utilisation de ces variables peut provoquer
l'ajout du nom d'en-tête correspondant à l'en-tête Vary de la
réponse HTTP, sauf spécification contraire pour la directive
qui accepte l'expression comme paramètre. La <a href="#functions">function</a> <code>req_novary</code> permet de
modifier ce comportement.</p>
<table class="bordered"><tr class="header"><th>Nom</th></tr>
<tr><td><code>HTTP_ACCEPT</code></td></tr>
<tr class="odd"><td><code>HTTP_COOKIE</code></td></tr>
<tr><td><code>HTTP_FORWARDED</code></td></tr>
<tr class="odd"><td><code>HTTP_HOST</code></td></tr>
<tr><td><code>HTTP_PROXY_CONNECTION</code></td></tr>
<tr class="odd"><td><code>HTTP_REFERER</code></td></tr>
<tr><td><code>HTTP_USER_AGENT</code></td></tr>
</table>
<p>Autres variables liées aux requêtes</p>
<table class="bordered"><tr class="header"><th>Nom</th><th>Description</th></tr>
<tr><td><code>REQUEST_METHOD</code></td>
<td>La méthode HTTP de la requête entrante (par exemple
<code>GET</code>)</td></tr>
<tr class="odd"><td><code>REQUEST_SCHEME</code></td>
<td>Le protocole associé à l'URI de la requête</td></tr>
<tr><td><code>REQUEST_URI</code></td>
<td>La partie chemin de l'URI de la requête</td></tr>
<tr class="odd"><td><code>DOCUMENT_URI</code></td>
<td>Idem <code>REQUEST_URI</code></td></tr>
<tr><td><code>REQUEST_FILENAME</code></td>
<td>Le chemin complet dans le système de fichiers local du
fichier ou du script correspondant à la requête, si le serveur
l'a dèjà déterminé à l'instant où <code>REQUEST_FILENAME</code>
est référencée. Dans le cas contraire, comme dans un
contexte de serveur virtuel, même valeur que <code>REQUEST_URI</code> </td></tr>
<tr class="odd"><td><code>SCRIPT_FILENAME</code></td>
<td>Identique à <code>REQUEST_FILENAME</code></td></tr>
<tr><td><code>LAST_MODIFIED</code></td>
<td>La date et heure de dernière modification du fichier au
format <code>20101231235959</code>, si elle est déjà connue du
serveur au moment où <code>LAST_MODIFIED</code> est référencé.
</td></tr>
<tr class="odd"><td><code>SCRIPT_USER</code></td>
<td>Le nom d'utilisateur du propriétaire du script.</td></tr>
<tr><td><code>SCRIPT_GROUP</code></td>
<td>Le nom du groupe auquel appartient le script.</td></tr>
<tr class="odd"><td><code>PATH_INFO</code></td>
<td>L'information relative au nom de chemin située en fin, voir
la directive <code class="directive"><a href="./mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></td></tr>
<tr><td><code>QUERY_STRING</code></td>
<td>La chaîne de paramètres de la requête courante</td></tr>
<tr class="odd"><td><code>IS_SUBREQ</code></td>
<td>"<code>true</code>" si la requête courante est une
sous-requête, "<code>false</code>" dans le cas contraire</td></tr>
<tr><td><code>THE_REQUEST</code></td>
<td>La requête complète (par exemple "<code>GET /index.html
HTTP/1.1</code>")</td></tr>
<tr class="odd"><td><code>REMOTE_ADDR</code></td>
<td>L'adresse IP de l'hôte distant</td></tr>
<tr><td><code>REMOTE_PORT</code></td>
<td>Le port de l'hôte distant (versions 2.4.26 et supérieures)</td></tr>
<tr class="odd"><td><code>REMOTE_HOST</code></td>
<td>Le nom d'hôte de l'hôte distant</td></tr>
<tr><td><code>REMOTE_USER</code></td>
<td>Le nom de l'utilisateur authentifié, s'il existe (non
disponible à l'intérieur d'un bloc <code class="directive"><If></code>)</td></tr>
<tr class="odd"><td><code>REMOTE_IDENT</code></td>
<td>Le nom de l'utilisateur défini par <code class="module"><a href="./mod/mod_ident.html">mod_ident</a></code></td></tr>
<tr><td><code>SERVER_NAME</code></td>
<td>La valeur de la directive <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> du serveur virtuel courant</td></tr>
<tr class="odd"><td><code>SERVER_PORT</code></td>
<td>Le port associé au serveur virtuel courant ; voir la
directive <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code></td></tr>
<tr><td><code>SERVER_ADMIN</code></td>
<td>La valeur de la directive <code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code> du serveur virtuel courant</td></tr>
<tr class="odd"><td><code>SERVER_PROTOCOL</code></td>
<td>Le protocole utilisé par la requête</td></tr>
<tr><td><code>DOCUMENT_ROOT</code></td>
<td>La valeur de la directive <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> du serveur virtuel
courant</td></tr>
<tr class="odd"><td><code>AUTH_TYPE</code></td>
<td>La valeur de la directive <code class="directive"><a href="./mod/mod_authn_core.html#authtype">AuthType</a></code> (par exemple
"<code>basic</code>")</td></tr>
<tr><td><code>CONTENT_TYPE</code></td>
<td>Le type de contenu de la réponse (non
disponible à l'intérieur d'un bloc <code class="directive"><If></code>)</td></tr>
<tr class="odd"><td><code>HANDLER</code></td>
<td>Le nom du <a href="handler.html">gestionnaire</a> qui a
généré la réponse</td></tr>
<tr><td><code>HTTP2</code></td>
<td>"<code>on</code>" si la requête utilise http/2,
"<code>off</code>" dans le cas contraire</td></tr>
<tr class="odd"><td><code>HTTPS</code></td>
<td>"<code>on</code>" si la requête utilise https,
"<code>off</code>" dans le cas contraire</td></tr>
<tr><td><code>IPV6</code></td>
<td>"<code>on</code>" si la connexion utilise IPv6,
"<code>off</code>" dans le cas contraire</td></tr>
<tr class="odd"><td><code>REQUEST_STATUS</code></td>
<td>Le code d'erreur HTTP de la requête (non
disponible à l'intérieur d'un bloc <code class="directive"><If></code>)</td></tr>
<tr><td><code>REQUEST_LOG_ID</code></td>
<td>L'identifiant du message d'erreur associé à la requête (voir
la directive <code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code>)</td></tr>
<tr class="odd"><td><code>CONN_LOG_ID</code></td>
<td>L'identifiant du message d'erreur associé à la connexion
(voir la directive <code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code>)</td></tr>
<tr><td><code>CONN_REMOTE_ADDR</code></td>
<td>L'adresse IP du correspondant pour la connexion (voir le module
<code class="module"><a href="./mod/mod_remoteip.html">mod_remoteip</a></code>)</td></tr>
<tr class="odd"><td><code>CONTEXT_PREFIX</code></td>
<td /></tr>
<tr><td><code>CONTEXT_DOCUMENT_ROOT</code></td>
<td /></tr>
</table>
<p>Variables diverses</p>
<table class="bordered"><tr class="header"><th>Nom</th><th>Description</th></tr>
<tr><td><code>TIME_YEAR</code></td>
<td>L'année courante (par exemple <code>2010</code>)</td></tr>
<tr class="odd"><td><code>TIME_MON</code></td>
<td>Le mois courant (<code>01</code>, ..., <code>12</code>)</td></tr>
<tr><td><code>TIME_DAY</code></td>
<td>Le jour courant dans le mois (<code>01</code>, ...)</td></tr>
<tr class="odd"><td><code>TIME_HOUR</code></td>
<td>Les heures de la date courante (<code>00</code>, ...,
<code>23</code>)</td></tr>
<tr><td><code>TIME_MIN</code></td>
<td>Les minutes de la date courante</td></tr>
<tr class="odd"><td><code>TIME_SEC</code></td>
<td>Les secondes de la date courante</td></tr>
<tr><td><code>TIME_WDAY</code></td>
<td>Le jour de la semaine (à partir de <code>0</code> pour
dimanche)</td></tr>
<tr class="odd"><td><code>TIME</code></td>
<td>La date et heure au format <code>20101231235959</code></td></tr>
<tr><td><code>SERVER_SOFTWARE</code></td>
<td>La chaîne contenant la version du serveur</td></tr>
<tr class="odd"><td><code>API_VERSION</code></td>
<td>La date de la version de l'API (module magic number)</td></tr>
</table>
<p>Certains modules, comme <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>, définissent des
variables supplémentaires.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="binop" id="binop">Opérateurs binaires</a></h2>
<p>À l'exception de quelques opérateurs de comparaison internes, les
opérateurs binaires sont de la forme
"<code>-[a-zA-Z][a-zA-Z0-9_]+</code>", autrement dit un signe moins
et au moins deux caractères. Le nom est insensible à la casse. Les
modules peuvent fournir des opérateurs binaires supplémentaires.</p>
<h3><a name="comp" id="comp">Opérateurs de comparaison</a></h3>
<table class="bordered"><tr class="header"><th>Nom</th><th>Alternative</th> <th>Description</th></tr>
<tr><td><code>==</code></td>
<td><code>=</code></td>
<td>Egalité de chaînes</td></tr>
<tr class="odd"><td><code>!=</code></td>
<td />
<td>Inégalité de chaînes</td></tr>
<tr><td><code><</code></td>
<td />
<td>Chaîne inférieure à</td></tr>
<tr class="odd"><td><code><=</code></td>
<td />
<td>Chaîne inférieure ou égale à</td></tr>
<tr><td><code>></code></td>
<td />
<td>Chaîne supérieure à</td></tr>
<tr class="odd"><td><code>>=</code></td>
<td />
<td>Chaîne supérieure ou égale à</td></tr>
<tr><td><code>=~</code></td>
<td />
<td>La chaîne correspond à l'expression rationnelle</td></tr>
<tr class="odd"><td><code>!~</code></td>
<td />
<td>La chaîne ne correspond pas à l'expression rationnelle</td></tr>
<tr><td><code>-eq</code></td>
<td><code>eq</code></td>
<td>Egalité d'entiers</td></tr>
<tr class="odd"><td><code>-ne</code></td>
<td><code>ne</code></td>
<td>Inégalité d'entiers</td></tr>
<tr><td><code>-lt</code></td>
<td><code>lt</code></td>
<td>Entier inférieur à</td></tr>
<tr class="odd"><td><code>-le</code></td>
<td><code>le</code></td>
<td>Entier inférieur ou égal à</td></tr>
<tr><td><code>-gt</code></td>
<td><code>gt</code></td>
<td>Entier supérieur à</td></tr>
<tr class="odd"><td><code>-ge</code></td>
<td><code>ge</code></td>
<td>Entier supérieur ou égal à</td></tr>
</table>
<h3><a name="binaryother" id="binaryother">Autres opérateurs binaires</a></h3>
<table class="bordered"><tr class="header"><th>Nom</th><th>Description</th></tr>
<tr><td><code>-ipmatch</code></td>
<td>L'adresse IP correspond à adresse/masque</td></tr>
<tr class="odd"><td><code>-strmatch</code></td>
<td>la chaîne de gauche correspond au modèle constitué par la
chaîne de droite (contenant des caractères génériques *, ?, [])</td></tr>
<tr><td><code>-strcmatch</code></td>
<td>idem <code>-strmatch</code>, mais insensible à la casse</td></tr>
<tr class="odd"><td><code>-fnmatch</code></td>
<td>idem <code>-strmatch</code>, mais les slashes ne sont pas
pris en compte par les caractères génériques</td></tr>
</table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="unnop" id="unnop">Opérateurs unaires</a></h2>
<p>Les opérateurs unaires acceptent un seul argument et sont
de la forme "<code>-[a-zA-Z]</code>",
autrement dit le signe moins et un caractère. Le nom <em>est</em>
sensible à la casse. Les modules peuvent fournir des opérateurs
unaires supplémentaires.</p>
<table class="bordered"><tr class="header"><th>Nom</th><th>Description</th><th>Remarques particulières</th></tr>
<tr><td><code>-d</code></td>
<td>L'argument est traité comme un nom de fichier.
Vrai si le fichier existe et correspond à un
répertoire</td><td>oui</td></tr>
<tr class="odd"><td><code>-e</code></td>
<td>L'argument est traité comme un nom de fichier. Vrai si le
fichier (ou dir ou special) existe</td><td>oui</td></tr>
<tr><td><code>-f</code></td>
<td>L'argument est traité comme un nom de fichier. Vrai si le
fichier existe et correspond à un fichier
régulier</td><td>oui</td></tr>
<tr class="odd"><td><code>-s</code></td>
<td>L'argument est traité comme un nom de fichier. Vrai si le
fichier existe et n'est pas vide</td><td>oui</td></tr>
<tr><td><code>-L</code></td>
<td>L'argument est traité comme un nom de fichier. Vrai si le
fichier existe et correspond à un lien
symbolique</td><td>oui</td></tr>
<tr class="odd"><td><code>-h</code></td>
<td>L'argument est traité comme un nom de fichier. Vrai si le
fichier existe et correspond à un lien symbolique
(identique à <code>-L</code>)</td><td>oui</td></tr>
<tr><td><code>-F</code></td>
<td>Vrai si la chaîne correspond a un fichier valide, accessible
avec tous les contrôles d'accès configurés pour ce chemin. A
cette fin, une sous-requête effectue la vérification, et vous
devez utiliser ce drapeau avec soin car il peut impacter les
performances de votre serveur !</td><td /></tr>
<tr class="odd"><td><code>-U</code></td>
<td>Vrai si la chaîne correspond a une URL valide, accessible
avec tous les contrôles d'accès configurés pour ce chemin. A
cette fin, une sous-requête effectue la vérification, et vous
devez utiliser ce drapeau avec soin car il peut impacter les
performances de votre serveur !</td><td /></tr>
<tr><td><code>-A</code></td>
<td>Alias pour <code>-U</code></td><td /></tr>
<tr class="odd"><td><code>-n</code></td>
<td>Vrai si la chaîne n'est pas vide</td><td /></tr>
<tr><td><code>-z</code></td>
<td>Vrai si la chaîne est vide</td><td /></tr>
<tr class="odd"><td><code>-T</code></td>
<td>Faux si la chaîne est vide, "<code>0</code>",
"<code>off</code>", "<code>false</code>", ou "<code>no</code>"
(insensibilité à la casse). Vrai dans le cas contraire.</td><td /></tr>
<tr><td><code>-R</code></td>
<td>Idem "<code>%{REMOTE_ADDR} -ipmatch ...</code>", en plus
efficace
</td><td /></tr>
</table>
<p>Les opérateurs marqués comme "restreints" ne sont pas disponibles
avec certains modules comme <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="functions" id="functions">Fonctions</a></h2>
<p>Normalement, les fonctions dont la valeur est une chaîne acceptent une chaîne
comme argument et renvoient une chaîne. Les noms de fonctions sont
insensibles à la casse. Les modules peuvent fournir des fonctions
supplémentaires.</p>
<table class="bordered"><tr class="header"><th>Nom</th><th>Description</th><th>Notes particulières</th></tr>
<tr><td><code>req</code>, <code>http</code></td>
<td>Lit l'en-tête de requête HTTP ; les noms
d'en-tête correspondants peuvent être ajoutés
à l'en-tête Vary,
voir ci-dessous</td><td /></tr>
<tr class="odd"><td><code>req_novary</code></td>
<td>Identique à <code>req</code>, mais aucun nom d'en-tête n'est
ajouté à l'en-tête Vary</td><td /></tr>
<tr><td><code>resp</code></td>
<td>Lit l'en-tête de réponse HTTP (La plupart des en-têtes de la réponse
ne seront pas encore définis pendant le traitement de la directive
<code class="directive"><If></code>)</td><td /></tr>
<tr class="odd"><td><code>reqenv</code></td>
<td>Recherche une variable d'environnement de requête (on
peut aussi utiliser le raccourci <code>v</code>).
</td>
<td>ordonnancement</td></tr>
<tr><td><code>osenv</code></td>
<td>Recherche une variable d'environnement du système
d'exploitation</td><td /></tr>
<tr class="odd"><td><code>note</code></td>
<td>Recherche une note de requête</td><td>ordonnancement</td></tr>
<tr><td><code>env</code></td>
<td>Renvoie le premier résultat positif de <code>note</code>,
<code>reqenv</code>, <code>osenv</code></td><td>ordonnancement</td></tr>
<tr class="odd"><td><code>tolower</code></td>
<td>Convertit une chaîne en minuscules</td><td /></tr>
<tr><td><code>toupper</code></td>
<td>Convertit une chaîne en majuscules</td><td /></tr>
<tr class="odd"><td><code>escape</code></td>
<td>Echappe les caractères spéciaux en codage hexadécimal</td><td /></tr>
<tr><td><code>unescape</code></td>
<td>"Déséchappe" les chaînes codées
en hexadécimal, en ne gardant encodés que les slashes; renvoie la chaîne vide
si la séquence %00 est rencontrée</td><td /></tr>
<tr class="odd"><td><code>base64</code></td>
<td>Encode la chaîne en base64</td><td /></tr>
<tr><td><code>unbase64</code></td>
<td>Décode les chaînes codées en base64, renvoie une chaîne
tronquée si le caractère 0x00 est rencontré</td><td /></tr>
<tr class="odd"><td><code>md5</code></td>
<td>Génère un hash de la chaîne en utilisant MD5, puis code le
hash obtenu en hexadécimal</td><td /></tr>
<tr><td><code>sha1</code></td>
<td>Génère un hash de la chaîne en utilisant SHA1, puis encode
le hash obtenu en hexadécimal</td><td /></tr>
<tr class="odd"><td><code>file</code></td>
<td>Lit le contenu d'un fichier(fins de lignes incluses, si
elles existent)</td><td>limité</td></tr>
<tr><td><code>filesize</code></td>
<td>Renvoie la taille d'un fichier (ou 0 si le fichier n'existe
pas ou ne correspond pas à un fichier régulier)</td><td>limité</td></tr>
<tr class="odd"><td><code>ldap</code></td>
<td>Echappe les caractères selon la RFC4514 (Echappement des
noms distinctifs LDAP - DN) et la RFC4515 (Echappement des
filtres LDAP).<br />
Disponible à partir de la version 2.4.53 du serveur HTTP
Apache.</td><td /></tr>
</table>
<p>Les fonctions marquées comme "limité" dans la dernière colonne ne sont
pas disponibles avec certains modules comme
<code class="module"><a href="./mod/mod_include.html">mod_include</a></code>.</p>
<p>Les fonctions marquées comme "ordonnancement" dans la dernière colonne
nécessitent une attention particulière pour l'ordonnancement des différents
composants du serveur, spécialement lorsque la fonction est utilisée au sein
d'une directive <<code class="directive"><a href="./mod/core.html#if">If</a></code>> qui est
évaluée relativement tôt.</p>
<div class="note">
<h3>Ordonnancement des variables d'environnement</h3>
Lorsque des variables d'environnement sont évaluées au sein d'une directive
<<code class="directive"><a href="./mod/core.html#if">If</a></code>>, il est important de tenir
compte du moment où cette évaluation intervient dans le traitement de la
requête. Par exemple, toute directive définie en dehors d'un contexte de
serveur virtuel (directory, location, htaccess) aura peu de chance d'être
déjà exécutée. Ainsi la directive <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> est une directive qui s'exécute
avant cette évaluation.
<br />
<br />
Lorsque <code>reqenv</code> est utilisé en dehors de la directive
<<code class="directive"><a href="./mod/core.html#if">If</a></code>>, l'évaluation survient en
général plus tard, mais le moment exact dépend de la directive dans laquelle
l'expression a été utilisée.
</div>
<p>Lorsque les fonctions <code>req</code> ou <code>http</code> sont
utilisées, le nom d'en-tête sera automatiquement ajouté à l'en-tête
Vary de la réponse HTTP, sauf spécification contraire pour la
directive qui accepte l'expression comme paramètre. La
fonction <code>req_novary</code> permet d'empêcher l'ajout de noms
d'en-têtes à l'en-tête Vary.</p>
<p>En plus des fonctions dont la valeur est une chaîne, il existe
aussi des fonctions dont la valeur est une liste, qui acceptent une
chaîne comme argument, et renvoient une liste de mots, autrement dit
une liste de chaînes. La liste de mot peut être utilisée avec
l'opérateur spécial <code>-in</code>. Les noms de fonctions sont
insensibles à la casse. Les modules peuvent fournir des fonctions
supplémentaires.</p>
<p>Il n'existe pas de fonctions internes dont la valeur est une
liste. Le module <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> fournit la fonction
<code>PeerExtList</code>. Voir la description de la directive
<code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code> pour plus de
détails (notez que la fonction <code>PeerExtList</code> peut aussi
être utilisée en dehors de la directive <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code>).</p>
</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">Exemples d'expressions</a></h2>
<p>Les exemples suivants montent comment utiliser les
expressions pour évaluer les requêtes :</p>
<pre class="prettyprint lang-config"># Comparer le nom d'hôte avec example.com et rediriger vers
# www.example.com si le nom d'hôte correspond
<If "%{HTTP_HOST} == 'example.com'">
Redirect permanent "/" "http://www.example.com/"
</If>
# Forcer le type text/plain si un fichier fait l'objet d'une
# requête dont la chaîne de paramètres contient 'forcetext'
<If "%{QUERY_STRING} =~ /forcetext/">
ForceType text/plain
</If>
# N'autoriser l'accès à ce contenu que pendant les heures de
# travail
<Directory "/foo/bar/business">
Require expr %{TIME_HOUR} -gt 9 && %{TIME_HOUR} -lt 17
</Directory>
# Vérifie si un en-tête HTTP correspond à une des valeurs d'une liste
<If "%{HTTP:X-example-header} in { 'foo', 'bar', 'baz' }">
La définition de l'en-tête correspond à une des valeurs recherchées
</If>
# Recherche la valeur d'une expression rationnelle dans une variable
# d'environnement, et renvoie la négation du résultat.
<If "! reqenv('REDIRECT_FOO') =~ /bar/">
La condition est vérifiée
</If>
# Vérifie le résultat de la recherche d'une correspondance d'URI dans un
# contexte de répertoire avec l'option -f
<Directory "/var/www">
AddEncoding x-gzip gz
<If "-f '%{REQUEST_FILENAME}.unzipme' && ! %{HTTP:Accept-Encoding} =~ /gzip/">
SetOutputFilter INFLATE
</If>
</Directory>
# Vérifie l'adresse IP du client
<If "-R '192.168.1.0/24'">
Header set matched true
</If>
# Exemple de fonction dans un contexte booléen
<If "md5('foo') == 'acbd18db4cc2f85cedef654fccc4a4d8'">
Header set checksum-matched true
</If>
# Function example in string context
Header set foo-checksum "expr=%{md5:foo}"
# L'exemple suivant retarde l'évaluation de la clause de condition par rapport à
# <If>
Header always set CustomHeader my-value "expr=%{REQUEST_URI} =~ m#^/special_path\.php$#"
# Journalisation conditionnelle
CustomLog logs/access-errors.log common "expr=%{REQUEST_STATUS} >= 400"
CustomLog logs/access-errors-specific.log common "expr=%{REQUEST_STATUS} -in {'405','410'}"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Autres</a></h2>
<table class="bordered"><tr class="header"><th>Nom</th><th>Alternative</th> <th>Description</th></tr>
<tr><td><code>-in</code></td>
<td><code>in</code></td>
<td>chaîne contenue dans une liste de mots</td></tr>
<tr class="odd"><td><code>/regexp/</code></td>
<td><code>m#regexp#</code></td>
<td>Expression rationnelle (la seconde forme permet de spécifier
des délimiteurs autres que /)</td></tr>
<tr><td><code>/regexp/i</code></td>
<td><code>m#regexp#i</code></td>
<td>Expression rationnelle insensible à la casse</td></tr>
<tr class="odd"><td><code>$0 ... $9</code></td>
<td />
<td>Références arrières dans les expressions rationnelles</td></tr>
</table>
<h3><a name="rebackref" id="rebackref">Références arrières dans les expressions rationnelles</a></h3>
<p>Les chaînes <code>$0</code> ... <code>$9</code> permettent de
référencer les groupes de capture en provenance d'expressions
rationnelles précédemment exécutées et mises en correspondance avec
succès. Elles ne peuvent normalement être utilisées que dans la
même expression que celle mise en correspondance, mais certains
modules permettent de les utiliser de manière spéciale.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="sslrequire" id="sslrequire">Comparaison avec SSLRequire</a></h2>
<p>La syntaxe <em>ap_expr</em> consiste principalement en une
surcouche de la syntaxe de la directive obsolète <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code>. Vous pouvez consulter la
liste de leur différences dans la documentation de la directive
<code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="compatibility" id="compatibility">Historique de version</a></h2>
<p>La <a href="#functions">fonction</a> <code>req_novary</code> est
disponible à partir de la version 2.4.4 du serveur HTTP Apache.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/expr.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/expr.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/expr.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/glossary.html.fr.utf8 0000664 0001751 0001751 00000104011 14740503670 021056 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Glossaire - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Glossaire</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/glossary.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/glossary.html" title="Français"> fr </a> |
<a href="./ja/glossary.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce glossaire définit la terminologie courante relative à Apache en
particulier, et aux serveurs web en général. Vous trouverez plus
d'informations sur chaque concept dans les liens fournis.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="definitions" id="definitions">Définitions</a></h2>
<dl>
<dt><a name="algorithm" id="algorithm">Algorithme</a></dt>
<dd>Une formule sans ambiguité ou un jeu de règles destinées à
résoudre un problème en un nombre fini d'étapes. Les algorithmes de
chiffrement sont en général appelés
<dfn>Ciphers</dfn>.
</dd>
<dt><a name="cipher" id="cipher">Algorithme de chiffrement
(Cipher)</a></dt>
<dd>Un algorithme ou un système de chiffrement des données.
Quelques exemples : DES, IDEA, RC4, etc.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="apr" id="APR">APR</a></dt>
<dd>Voir "Bibliothèques pour la portabilité d'Apache"
</dd>
<dt><a name="tarball" id="tarball">Archive Tar (Tarball)</a></dt>
<dd>Un paquetage de fichiers rassemblés dans une archive
à l'aide de l'utilitaire <code>tar</code>.
Les distributions d'Apache sont stockées dans des Archives Tar compressées
ou en utilisant pkzip.
</dd>
<dt><a name="authentication" id="authentication">Authentification </a></dt>
<dd>L'identification formelle d'une entité du réseau comme un serveur, un
client, ou un utilisateur.<br />
Voir : <a href="howto/auth.html">Authentification, Autorisation, et
contrôle d'accès</a>
</dd>
<dt><a name="certificationauthority" id="certificationauthority">Autorité de Certification
(Certification Authority)</a>
<a name="ca" id="ca">(CA)</a></dt>
<dd>Un tiers de confiance habilité à signer des certificats pour des entités
du réseau qu'il a authentifiées selon des critères basés sur la sécurité.
Les autres entités du réseau peuvent alors utiliser la signature pour
vérifier qu'une CA a authentifié le porteur du certificat.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="apacheportableruntime" id="apacheportableruntime">Bibliothèques pour la portabilité d'Apache
(Apache Portable Runtime)</a> <a name="apr" id="apr">(APR)</a></dt>
<dd>Un jeu de bibliothèques qui fournit la plupart des interfaces de base
entre le serveur et le système d'exploitation. APR est développé
parallèlement au serveur HTTP Apache comme projet indépendant.<br />
Voir : <a href="http://apr.apache.org/">Apache Portable Runtime
Project</a>
</dd>
<dt><a name="certificate" id="certificate">Certificat (Certificate)</a></dt>
<dd>Un ensemble de données servant à authentifier des entités du
réseau comme un serveur ou un client. Un certificat contient des ensembles
d'informations X509 à propos de son propriétaire (appelé sujet/subject)
et de l'<a class="glossarylink" href="./glossary.html#certificationauthority" title="voir glossaire">Autorité de Certification
(Certification Authority) ou CA</a> signataire (appelée
le fournisseur/issuer), ainsi que la
<a class="glossarylink" href="./glossary.html#publickey" title="voir glossaire">clé publique (public
key)</a> du propriétaire et la
signature de la CA. Les entités du réseau vérifient ces signatures
en utilisant les certificats des Autorités de Certification.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="publickeycryptography" id="publickeycryptography">Chiffrement à Clé Publique
(Public Key Cryptography)</a></dt>
<dd>L'étude et l'application des systèmes de chiffrement asymétriques,
qui utilisent une clé pour le chiffrement et une autre pour le
déchiffrement. Les deux clés correspondantes constituent une paire de clés.
Appelé aussi chiffrement asymétrique.
<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="privatekey" id="privatekey">Clé Privée (Private Key)</a></dt>
<dd>La clé secrète dans un système de
<a class="glossarylink" href="./glossary.html#publickeycryptography" title="voir glossaire">chiffrement à clé publique</a>,
utilisée pour déchiffrer les messages entrants et signer
les messages sortants.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="publickey" id="publickey">Clé Publique (Public Key)</a></dt>
<dd>La clé accessible au public dans un système de <a class="glossarylink" href="./glossary.html#publickeycryptography" title="voir glossaire">Chiffrement à clé publique</a>,
utilisée pour chiffrer les messages destinés uniquement à son
propriétaire et déchiffrer les signatures
faites par son propriétaire.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="connect" id="connect">CONNECT</a></dt>
<dd>Une <a class="glossarylink" href="./glossary.html#method" title="voir glossaire">méthode</a> HTTP pour encapsuler
des données brutes dans HTTP. Elle peut aussi être utilisée pour encapsuler
d'autres protocoles, comme le protocole SSL.
</dd>
<dt><a name="context" id="context">Contexte (Context)</a></dt>
<dd>Une portion des <a class="glossarylink" href="./glossary.html#configurationfile" title="voir glossaire">
fichiers de configuration</a> dans laquelle certains types de
<a class="glossarylink" href="./glossary.html#directive" title="voir glossaire">directives</a> sont autorisés.<br />
Voir : <a href="mod/directive-dict.html#Context">Termes utilisés
pour décrire les directives d'Apache</a>
</dd>
<dt><a name="accesscontrol" id="accesscontrol">Contrôle d'accès
(Access Control)</a></dt>
<dd>La restriction d'accès à des zones du réseau. Habituellement
dans un contexte Apache,
la restriction d'accès à certaines <em>URLs</em>.<br />
Voir : <a href="howto/auth.html">Authentification, Autorisation et
Contrôle d'accès</a>
</dd>
<dt><a name="securesocketslayer" id="securesocketslayer">
Couche des Points de connexion Sécurisés
(Secure Sockets Layer)
</a> <a name="ssl" id="ssl">(SSL)</a></dt>
<dd>Un protocole créé par Netscape Communications Corporation pour
l'authentification et le chiffrement généraux des communications dans les
réseaux TCP/IP. L'utilisation la plus connue est <em>HTTPS</em>, autrement dit
le Protocole de Transfert Hypertexte (HTTP) au dessus de SSL.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="subrequest" id="subrequest">Sous-requête</a></dt>
<dd>Apache possède une API des sous-requêtes pour les modules qui
permettent l'évaluation complète ou partielle par le serveur de
chemins d'autres systèmes de fichiers ou d'URL. Par exemple, la
directive <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>,
les modules <code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code> et
<code class="module"><a href="./mod/mod_include.html">mod_include</a></code> utilisent cette API.
</dd>
<dt><a name="symmetriccryptophraphy" id="symmetriccryptophraphy">
Cryptographie Symétrique (Symmetric Cryptography)</a></dt>
<dd>L'étude et l'application des <em>Algorithmes de chiffrement</em> qui
utilisent une clé secrète unique pour les opérations de chiffrement et de
déchiffrement.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="export-crippled" id="export-crippled">
Dégradé pour l'exportation
(Export-Crippled)</a></dt>
<dd>Diminué en terme de puissance cryptographique (et de sécurité)
afin de respecter les Règles de l'Administration des Exportations
des Etats-Unis (Export Administration Regulations ou EAR).
Les logiciels de cryptographie dégradés pour l'exportation sont limités
à une clé de petite taille, et produisent un
<em>Texte crypté</em> qui peut en général être décrypté
par force brute.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="certificatsigningrequest" id="certificatsigningrequest">Demande de signature de certificat
(Certificate Signing Request)</a>
<a name="csr" id="csr">(CSR)</a></dt>
<dd>La soumission d'un <a class="glossarylink" href="./glossary.html#certificate" title="voir glossaire">certificat</a>
non signé à une <a class="glossarylink" href="./glossary.html#certificationauthority" title="voir glossaire">Autorité de
certification</a>, qui le signe avec la <a class="glossarylink" href="./glossary.html#privatekey" title="voir glossaire">Clé privée</a> de leur
<em>Certificat</em> de CA. Une fois le CSR signé, il devient un vrai
certificat.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="directive" id="directive">Directive</a></dt>
<dd>Une commande de configuration qui contrôle un ou plusieurs aspects du
comportement d'Apache. Les directives sont placées dans le <a class="glossarylink" href="./glossary.html#configurationfile" title="voir glossaire">Fichier de configuration</a><br />
Voir : <a href="mod/directives.html">Index des directives</a>
</dd>
<dt><a name="configurationdirective" id="configurationdirective">Directive de configuration
(Configuration Directive)</a></dt>
<dd>Voir : <a class="glossarylink" href="./glossary.html#directive" title="voir glossaire">Directive</a></dd>
<dt><a name="header" id="header">En-tête (Header)</a></dt>
<dd>La partie de la requête et de la réponse
<a class="glossarylink" href="./glossary.html#http" title="voir glossaire">HTTP</a> qui est envoyée avant le contenu
proprement dit, et contient des méta-informations décrivant le contenu.
</dd>
<dt><a name="regularexpression" id="regularexpression">Expression Rationnelle
(Regular Expression)</a>
<a name="regex" id="regex">(Regex)</a></dt>
<dd>Une méthode pour décrire un modèle sous forme de texte - par exemple,
"tous les mots qui commencent par la lettre A" ou "tous les numéros de
téléphone à 10 chiffres" ou encore "Toutes les phrases contenant 2 virgules,
et aucun Q majuscule". Les expressions rationnelles sont très utiles dans
Apache car elles vous permettent d'appliquer certains attributs à des
ensembles de fichiers ou ressources avec une grande flexibilité
- par exemple, tous les fichiers .gif et .jpg situés dans tout répertoire
nommé "images", pourraient être enregistrés comme
"<code>/images/.*(jpg|gif)$</code>". Lorsque l'on utilise des
expressions rationnelles pour la substitution de chaînes, les
variables spéciales $1 ... $9 contiennent des références arrières
vers les parties regroupées (entre parenthèses) de l'expression
qui correspond. La variable spéciale $0 contient une référence
arrière vers l'ensemble de l'expression qui correspond. Pour
insérer un caractère littéral "dollar" dans la chaîne de
remplacement, il faut l'échapper avec un anti-slash. Pour des
raisons historiques, la variable & peut être utilisée en tant
qu'alias de $0 dans certains cas, mais ceci n'est plus possible
depuis la version 2.3.6. Apache utilise les Expressions
Rationnelles Compatibles avec Perl fournies par la librairie <a href="http://www.pcre.org/">PCRE</a>. Vous trouverez plus
d'information à propos de la syntaxe des expressions rationnelles
PCRE sur ce site, ou dans le <a href="http://en.wikipedia.org/wiki/PCRE">Wikipedia de la PCRE</a>.
</dd>
<dt><a name="configurationfile" id="configurationfile">
Fichier de configuration
(Configuration File)</a></dt>
<dd>Un fichier texte contenant des
<a class="glossarylink" href="./glossary.html#directive" title="voir glossaire">Directives</a>
qui contrôlent la configuration d'Apache.<br />
Voir : <a href="configuring.html">Fichiers de configuration</a>
</dd>
<dt><a name="filter" id="filter">Filtre (Filter)</a></dt>
<dd>Un traitement appliqué aux données envoyées ou reçues par le serveur.
Les filtres en entrée traitent les données envoyées au serveur par le
client, alors que les filtres en sortie traitent les documents sur le
serveur avant qu'ils soient envoyés au client.
Par exemple, le filtre en sortie
<code>INCLUDES</code>
traite les documents pour les
<a class="glossarylink" href="./glossary.html#ssi" title="voir glossaire">Server Side Includes (Inclusions côté Serveur)
</a>.<br />
Voir : <a href="filter.html">Filtres</a>
</dd>
<dt><a name="handler" id="handler">Gestionnaire (Handler)</a></dt>
<dd>Une représentation interne à Apache de l'action à entreprendre
quand un fichier est appelé. En général, les fichiers ont des gestionnaires
implicites, basés sur le type de fichier. Normalement, tous les
fichiers sont directement servis par le serveur, mais certains
types de fichiers sont "gérés" séparément. Par exemple, le gestionnaire
<code>cgi-script</code> désigne les fichiers qui doivent être traités
comme <a class="glossarylink" href="./glossary.html#cgi" title="voir glossaire">CGIs</a>.<br />
Voir : <a href="handler.html">Utilisation des gestionnaires d'Apache</a>
</dd>
<dt><a name="hash" id="hash">Hachage (Hash)</a></dt>
<dd>Un algorithme mathématique à sens unique, irréversible, générant une
chaîne de longueur fixe à partir d'une autre chaîne de longueur quelconque.
Des chaînes différentes en entrée vont normalement produire des chaînes
différentes en sortie (selon la fonction de hachage).
</dd>
<dt><a name="virtualhosting" id="virtualhosting">Hébergement Virtuel
(Virtual Hosting)</a></dt>
<dd>Servir des sites web multiples en utilisant une seule instance d'Apache.
Les <em>Hôtes virtuels basés sur IP</em> différencient les sites web en se
basant sur leur adresse IP, alors que les
<em>Hôtes virtuels basés sur le nom</em> utilisent uniquement le nom d'hôte
et peuvent en conséquence héberger de nombreux sites avec la même
adresse IP.<br />
Voir la <a href="vhosts/">Documentation des Hôtes Virtuels d'Apache</a>
</dd>
<dt><a name="htaccess" id="htaccess">.htaccess</a></dt>
<dd>Un <a class="glossarylink" href="./glossary.html#configurationfile" title="voir glossaire">fichier de configuration</a>
placé à un certain niveau de l'arborescence du site web, et appliquant des
<a class="glossarylink" href="./glossary.html#directive" title="voir glossaire">directives</a> de configuration au
répertoire dans lequel il est placé, ainsi qu'à tous ses sous-répertoires.
En dépit de son nom, ce fichier peut contenir pratiquement tout type de
directive, et pas seulement des directives de contrôle d'accès.<br />
Voir : <a href="configuring.html">Fichiers de configuration</a>
</dd>
<dt><a name="httpd.conf" id="httpd.conf">httpd.conf</a></dt>
<dd>Le <a class="glossarylink" href="./glossary.html#configurationfile" title="voir glossaire">fichier de configuration
</a> principal d'Apache. Sa localisation par défaut est
<code>/usr/local/apache2/conf/httpd.conf</code>, mais ceci peut être
changé en utilisant des options de compilation ou d'exécution.<br />
Voir : <a href="configuring.html">Fichiers de configuration</a>
</dd>
<dt><a name="https" id="https">HTTPS</a></dt>
<dd>Le Protocole de Transfert Hypertexte (Sécurisé), le mécanisme de
communication cryptée standard sur le World Wide Web.
Il s'agit en fait de HTTP au dessus de
<a class="glossarylink" href="./glossary.html#ssl" title="voir glossaire">SSL</a>.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="uniformresourceidentifier" id="uniformresourceidentifier">Identificateur de Ressource Uniformisé
(Uniform Resource Identifier)</a>
<a name="URI" id="URI">(URI)</a></dt>
<dd>Une chaîne de caractères compacte servant à identifier une ressource
abstraite ou physique. Elle est formellement définie par la <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a>. Les URIs
utilisées sur le world-wide web sont souvent appelées <a class="glossarylink" href="./glossary.html#url" title="voir glossaire">URLs</a>.
</dd>
<dt><a name="serversideincludes" id="serversideincludes">
Inclusions Côté Serveur
(Server Side Includes)</a> <a name="ssi" id="ssi">(SSI)
</a></dt>
<dd>Une technique permettant d'englober des directives de traitement dans
des fichiers HTML.<br />
Voir : <a href="howto/ssi.html">Introduction aux Inclusions Côté Serveur</a>
</dd>
<dt><a name="servernameindication" id="servernameindication">Indication du nom du serveur</a> <a name="sni" id="sni">(SNI)</a></dt>
<dd>Une fonctionnalité SSL permettant de spécifier le
nom du serveur désiré dans le message initial de la
négociation SSL, de façon à ce que le serveur web
puisse choisir la bonne configuration de serveur virtuel à
utiliser pendant le déroulement de la négociation SSL.
Cette fonctionnalité a été ajoutée
à SSL lorsque sont apparues les extensions TLS, RFC 3546.<br />
Voir <a href="ssl/ssl_faq.html">la FAQ SSL</a>
et <a href="http://www.ietf.org/rfc/rfc3546.txt">la RFC 3546</a>
</dd>
<dt><a name="commongatewayinterface" id="commongatewayinterface">
Interface commune avec les programmes externes
(Common Gateway Interface)</a>
<a name="cgi" id="cgi">(CGI)</a></dt>
<dd>La définition standard d'une interface entre un serveur web et un
programme externe pour permettre à ce dernier de traiter des requêtes.
Il existe une <a href="http://www.ietf.org/rfc/rfc3875">RFC
informationnelle</a> qui en couvre les spécificités.<br />
Voir : <a href="howto/cgi.html">Contenu dynamique avec CGI</a>
</dd>
<dt><a name="uniformresourcelocator" id="uniformresourcelocator">
Localisation de Ressource Uniformisée
(Uniform Resource Locator)
</a> <a name="url" id="url">(URL)</a></dt>
<dd>Le nom/adresse d'une ressource sur l'Internet. Il s'agit du terme
informel commun pour ce qui est formellement défini comme <a class="glossarylink" href="./glossary.html#uniformresourceidentifier" title="voir glossaire">
Identificateur de Ressource Uniformisé</a>.
Les URLs sont généralement construites selon un schéma, comme
<code>http</code> ou
<code>https</code>, un nom d'hôte, et un chemin. Une URL pour cette page
pourrait être
<code>http://httpd.apache.org/docs/2.4/glossary.html</code>.
</dd>
<dt><a name="proxy" id="proxy">Mandataire (Proxy)</a></dt>
<dd>Un serveur intermédiaire qui se situe entre le client et le
<em>serveur d'origine</em>.
Il prend en compte les requêtes des clients, les transmet au serveur
d'origine, puis renvoie la réponse du serveur d'origine au client.
Si plusieurs clients demandent le même contenu, le mandataire peut l'extraire
de son cache, plutôt que le demander au serveur d'origine
à chaque fois, ce qui réduit le temps de réponse.<br />
Voir : <a href="mod/mod_proxy.html">mod_proxy</a>
</dd>
<dt><a name="reverseproxy" id="reverseproxy">Mandataire inverse
(Reverse Proxy)</a></dt>
<dd>Un serveur <a class="glossarylink" href="./glossary.html#proxy" title="voir glossaire">mandataire</a> qui est vu du client
comme un <em>serveur d'origine</em>. Ceci peut s'avérer utile pour
dissimuler le serveur d'origine réel au client pour des raisons de sécurité,
ou pour répartir la charge.
</dd>
<dt><a name="method" id="method">Méthode (Method)</a></dt>
<dd>Dans le contexte <a class="glossarylink" href="./glossary.html#http" title="voir glossaire">HTTP</a>, une action à
effectuer sur une ressource spécifiée dans la ligne de requête
par le client. Parmi les méthodes disponibles dans HTTP, on trouve
<code>GET</code>, <code>POST</code>,
et <code>PUT</code>.
</dd>
<dt><a name="module" id="module">Module</a></dt>
<dd>Une partie indépendante d'un programme. De nombreuses fonctionnalités
d'Apache sont fournies par des modules que vous pouvez choisir d'inclure
ou d'exclure. Les modules qui sont compilés dans le binaire
<code class="program"><a href="./programs/httpd.html">httpd</a></code> sont appelés <dfn>modules statiques</dfn>, alors
que les modules qui existent séparément et peuvent être chargés
optionnellement à l'exécution sont appelés
<dfn>modules dynamiques</dfn> ou <a class="glossarylink" href="./glossary.html#dso" title="voir glossaire">DSOs</a>.
Les modules qui sont inclus par défaut sont appelés
<dfn>modules de base</dfn>. De nombreux modules disponibles pour Apache
ne se trouvent pas dans l'<a class="glossarylink" href="./glossary.html#tarball" title="voir glossaire">archive</a>
du Serveur HTTP Apache . Il sont appelés
<dfn>modules tiers</dfn>.<br />
Voir : <a href="mod/">Index des modules</a>
</dd>
<dt><a name="passphrase" id="passphrase">Mot de Passe (Pass Phrase)</a></dt>
<dd>Le mot ou la phrase qui protège les fichiers de clés privées.
Il empêche les utilisateurs non autorisés de les déchiffrer. En général,
il s'agit simplement de la clé secrète de chiffrement/déchiffrement
utilisée pour les <a class="glossarylink" href="./glossary.html#cipher" title="voir glossaire">Algorithmes de chiffrement</a>.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="fully-qualifieddomain-name" id="fully-qualifieddomain-name">Nom de domaine entièrement qualifié
(Fully-Qualified Domain-Name)</a>
<a name="fqdn" id="fqdn">(FQDN)</a></dt>
<dd>Le nom unique d'une entité du réseau, comprenant un nom d'hôte et un
nom de domaine qui peuvent être résolus en une adresse IP. Par exemple,
<code>www</code> est un nom d'hôte, <code>example.com</code> est un nom
de domaine, et <code>www.example.com</code> est un nom de domaine
entièrement qualifié.
</dd>
<dt><a name="modulemagicnumber" id="modulemagicnumber">
Nombre Magique des Modules
(Module Magic Number)</a>
(<a name="mmn" id="mmn">MMN</a>)</dt>
<dd>Le Nombre Magique des Modules est une constante définie dans le code
source d'Apache et associée à la compatibilité binaire des modules.
Sa valeur est modifiée quand des structures internes d'Apache, des appels
de fonctions et d'autres parties significatives de l'API sont modifiées
de telle façon que la compatibilité binaire ne peut plus être garantie.
En cas de changement de MMN, tous les modules tiers doivent être au
moins recompilés, et parfois même légèrement modifiés afin de pouvoir
fonctionner avec la nouvelle version d'Apache.
</dd>
<dt><a name="dynamicsharedobject" id="dynamicsharedobject">
Objet Dynamique Partagé (Dynamic Shared Object)
</a> <a name="dso" id="dso">(DSO)</a></dt>
<dd><a class="glossarylink" href="./glossary.html#module" title="voir glossaire">Modules</a> compilés en dehors du binaire
Apache <code class="program"><a href="./programs/httpd.html">httpd</a></code> et qui peuvent être
chargés à la demande.<br />
Voir : <a href="dso.html">Support des objets dynamiques partagés</a>
</dd>
<dt><a name="openssl" id="openssl">OpenSSL</a></dt>
<dd>L'ensemble d'outils Open Source pour SSL/TLS<br />
Voir <a href="http://www.openssl.org/">http://www.openssl.org/</a>#
</dd>
<dt><a name="apacheextensiontool" id="apacheextensiontool">
Outil de gestion des extensions Apache
(APache eXtension Tool)</a>
<a name="apxs" id="apxs">(apxs)</a></dt>
<dd>Un script Perl qui aide à la compilation des sources de <a class="glossarylink" href="./glossary.html#module" title="voir glossaire">module</a> sous forme d'Objets Dynamiques Partagés
(Dynamic Shared Objects ou
<a class="glossarylink" href="./glossary.html#dso" title="voir glossaire">DSO</a>s) et facilite leur installation
dans le serveur Web Apache.<br />
Voir : Page de manuel : <code class="program"><a href="./programs/apxs.html">apxs</a></code>
</dd>
<dt><a name="plaintext" id="plaintext">Plein Texte (Plaintext)</a></dt>
<dd>Le texte non chiffré.</dd>
<dt><a name="hypertexttransferprotocol" id="hypertexttransferprotocol">Protocole de Transfert Hypertexte
(HyperText Transfer Protocol)</a>
<a name="http" id="hhtp">(HTTP)</a></dt>
<dd>Le protocole de transmission standard utilisé sur le World Wide Web.
Apache implémente la version 1.1 du protocole, référencée comme HTTP/1.1 et
définie par la
<a href="http://ietf.org/rfc/rfc2616.txt">RFC 2616</a>.
</dd>
<dt><a name="messagedigest" id="messagedigest">Résumé de message
(Message Digest)</a></dt>
<dd>Un hachage du message, qui peut être utilisé pour vérifier
que son contenu n'a pas été altéré durant le transfert.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="transportlayersecurity" id="transportlayersecurity">
Sécurité de la couche Transport
(Transport Layer Security)
</a> <a name="tls" id="tls">(TLS)</a></dt>
<dd>Le protocole successeur de SSL, créé par l'Internet Engineering Task
Force (IETF) pour l'authentification et le chiffrement généraux des
communications dans les réseaux TCP/IP. TLS version 1 est pratiquement
identique à SSL version 3.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="session" id="session">Session</a></dt>
<dd>Les informations sur le contexte d'une communication en général.</dd>
<dt><a name="digitalsignature" id="digitalsignature">Signature numérique
(Digital Signature)</a></dt>
<dd>Un bloc de texte crypté qui valide un certificat ou un autre fichier.
Une <a class="glossarylink" href="./glossary.html#certificationauthority" title="voir glossaire">Autorité de certification</a>
crée une signature en générant une empreinte de la <em>Clé publique</em>
fournie avec le <em>Certificat</em>; la CA chiffre ensuite l'empreinte
avec sa propre <em>Clé privée</em>. Seule la clé publique de la CA
peut décrypter la signature, ce qui permet de vérifier que la CA a bien
authentifié l'entité du réseau qui possède le
<em>Certificat</em>.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="ssleay" id="ssleay">SSLeay</a></dt>
<dd>La bibliothèque originelle d'implémentation de SSL/TLS développée par
Eric A. Young
</dd>
<dt><a name="ciphertext" id="ciphertext">Texte crypté
(Ciphertext)</a></dt>
<dd>Le résultat du passage d'un document
<a class="glossarylink" href="./glossary.html#plaintext" title="voir glossaire">Plaintext</a> (Plein texte) par un
<a class="glossarylink" href="./glossary.html#cipher" title="voir glossaire">Cipher</a>.<br />
Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
<dt><a name="mime-type" id="mime-type">Type MIME (MIME-type)</a></dt>
<dd>Une méthode pour décrire le type de document transmis. Son nom
vient du fait que son format est issu des Multipurpose
Internet Mail Extensions (Extensions Multi-usages de la
Messagerie par Internet) . Il comprend un type majeur et un type
mineur, séparés par un slash (barre oblique). On trouve
entre autres types <code>text/html</code>,
<code>image/gif</code>, et <code>application/octet-stream</code>. Dans
HTTP, le type MIME est transmis dans l'
<a class="glossarylink" href="./glossary.html#header" title="voir glossaire">en-tête</a> <code>Content-Type</code>.<br />
Voir : <a href="mod/mod_mime.html">mod_mime</a>
</dd>
<dt><a name="environmentvariable" id="environmentvariable">
Variable d'environnement
(Environment Variable)</a> <a name="env-variable" id="env-variable">(env-variable)</a></dt>
<dd>Ce sont des variables nommées gérées par le shell du système
d'exploitation, et servant au stockage d'informations et à la
communication entre les programmes. Apache possède aussi des variables
internes considérées comme variables d'environnement, mais stockées dans
des structures internes à Apache, et non dans l'environnement
du shell.<br />
Voir : <a href="env.html">Les variables d'environnement dans Apache</a>
</dd>
<dt><a name="x.509" id="x.509">X.509</a></dt>
<dd>Une norme de certificat d'authentification recommandée par l'International
Telecommunication Union (ITU-T) et utilisée pour
l'authentification SSL/TLS.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/glossary.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/glossary.html" title="Français"> fr </a> |
<a href="./ja/glossary.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/glossary.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/invoking.html.fr.utf8 0000664 0001751 0001751 00000032653 14740503670 021053 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Démarrage d'Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Démarrage d'Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Sous Windows, Apache est habituellement lancé en tant que
service. Pour plus de détails, voir <a href="platform/windows.html#winsvc">Démarrer Apache en tant
que service</a>.</p>
<p>Sous Unix, le programme <code class="program"><a href="./programs/httpd.html">httpd</a></code>
est lancé en mode démon et s'exécute de manière permanente en
arrière-plan pour gérer les requêtes. Ce document décrit comment invoquer
<code class="program"><a href="./programs/httpd.html">httpd</a></code>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#startup">Comment Apache démarre</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errors">Erreurs en cours de démarrage</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#boot">Lancement au démarrage du système</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#info">Informations supplémentaires</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="stopping.html">Arrêt et redémarrage</a></li><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="#comments_section">Commentaires</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="startup" id="startup">Comment Apache démarre</a></h2>
<p>Si la directive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
spécifiée dans le fichier de configuration est à sa valeur par défaut
de 80 (ou tout autre port inférieur à 1024), il est nécessaire de
posséder les privilèges root pour pouvoir démarrer apache, et lui
permettre d'être associé à ce port privilégié. Lorsque le serveur est
démarré, il effectue quelques opérations préliminaires
comme ouvrir ses fichiers de log, puis il lance plusieurs processus
<em>enfants</em> qui ont pour rôle d'écouter et de répondre aux
requêtes des clients. Le processus <code>httpd</code> principal
continue à s'exécuter sous l'utilisateur root, tandis que les processus
enfants s'exécutent sous un utilisateur aux privilèges restreints.
Ceci s'effectue par la voie du
<a href="mpm.html">Module Multi-Processus (MPM)</a>.</p>
<p>Il est recommandé d'utiliser le script de contrôle
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> pour invoquer l'exécutable
<code class="program"><a href="./programs/httpd.html">httpd</a></code>. A cet effet, ce script définit certaines variables
d'environnement nécessaires pour permettre à
<code class="program"><a href="./programs/httpd.html">httpd</a></code> de fonctionner correctement sous certains systèmes
d'exploitation.
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> accepte des arguments de ligne de
commande ;
ainsi toute option de <code class="program"><a href="./programs/httpd.html">httpd</a></code> peut aussi être utilisée avec
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code>. Vous pouvez aussi éditer directement le
script <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> en modifiant la variable
<code>HTTPD</code> située en début de script pour spécifier la
localisation du binaire <code class="program"><a href="./programs/httpd.html">httpd</a></code> et tout argument de ligne
de commande que vous souhaitez voir <em>systématiquement</em> présent.</p>
<p>La première chose qu'effectue <code class="program"><a href="./programs/httpd.html">httpd</a></code> quand il est
invoqué est de localiser et lire le <a href="configuring.html">fichier de configuration</a>
<code>httpd.conf</code>. La localisation de ce fichier est définie à la
compilation, mais il est possible d'en spécifier une autre à
l'exécution en utilisant l'option de ligne de commande <code>-f</code> comme suit:</p>
<div class="example"><p><code>/usr/local/apache2/bin/apachectl -f
/usr/local/apache2/conf/httpd.conf</code></p></div>
<p>Si tout se passe bien pendant le démarrage, le serveur va se dissocier
du terminal et l'invite de commande réapparaîtra presque immédiatement.
Ceci indique que le serveur a démarré et est en cours d'exécution.
À partir de ce moment, vous pouvez utiliser votre navigateur pour vous connecter
au serveur et afficher la page de test située dans le répertoire défini
par la directive <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errors" id="errors">Erreurs en cours de démarrage</a></h2>
<p>Si un problème fatal survient pendant le démarrage
d'Apache, ce dernier va
afficher un message décrivant le problème sur la console ou
enregistrer ces informations dans le fichier défini par la directive
<code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> avant de quitter.
Un des messages d'erreur les plus courants est "<code>Unable
to bind to Port ...</code>". Ce message d'erreur est habituellement
provoqué par :</p>
<ul>
<li>Une tentative de démarrage du serveur avec un port privilégié sans
être connecté root</li>
<li>Une tentative de démarrage du serveur alors qu'une autre instance
d'Apache ou un autre serveur web est déjà associé au même port.</li>
</ul>
<p>Pour plus d'instructions de dépannage, consultez la
<a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> Apache.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="boot" id="boot">Lancement au démarrage du système</a></h2>
<p>Si vous souhaitez que votre serveur web soit automatiquement
disponible après
un redémarrage du système, vous devez ajouter un appel à
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> à vos
fichiers de démarrage système (en général <code>rc.local</code> ou un
fichier dans un répertoire <code>rc.N</code>), ce qui démarrera Apache sous
l'utilisateur root. Avant de faire ceci, assurez-vous que votre serveur
soit correctement configuré en ce qui concerne la sécurité et les
restrictions d'accès.</p>
<p>Le script <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> est conçu pour fonctionner
comme un script d'initialisation SysV standard ; il accepte les arguments
<code>start</code>, <code>restart</code>, et <code>stop</code>
et les traduit en signaux appropriés pour
<code class="program"><a href="./programs/httpd.html">httpd</a></code>, et il suffit en général d'installer
un lien vers
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> dans le répertoire d'initialisation approprié.
Mais prenez soin de vérifier les besoins exacts de votre système
en la matière.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="info" id="info">Informations supplémentaires</a></h2>
<p>Des informations supplémentaires à propos des options en ligne de
commande de <code class="program"><a href="./programs/httpd.html">httpd</a></code> et <code class="program"><a href="./programs/apachectl.html">apachectl</a></code>
ainsi que d'autres programmes support inclus dans la distribution
sont disponibles sur la page
<a href="programs/">Le serveur et ses programmes support</a>.
Il existe aussi une documentation sur tous les <a href="mod/">modules</a> inclus dans la distribution Apache
et les <a href="mod/directives.html">directives</a>
qu'ils supportent.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/invoking.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/install.html.fr.utf8 0000664 0001751 0001751 00000072653 14740503670 020701 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Compilation et installation - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Compilation et installation</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document couvre l'installation et la compilation du serveur
HTTP Apache
sur les systèmes Unix et similaires seulement. Pour la compilation et
l'installation sous Windows, voir <a href="platform/windows.html">Utiliser le serveur HTTP Apache avec Microsoft
Windows</a> et <a href="platform/win_compiling.html">Compilation
d'Apache sous Microsoft Windows</a>. Pour les autres plateformes, se
référer à la documentation par
<a href="platform/">plateforme</a>.</p>
<p>Apache httpd utilise <code>libtool</code> et <code>autoconf</code>
afin de créer un environnement de construction similaire à la plupart
des projets Open Source .</p>
<p>Si vous effectuez une mise à jour depuis une version mineure vers
la suivante (par exemple, 2.4.8 à 2.4.9), veuillez passer à la section
<a href="#upgrading">mise à jour</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Aperçu pour les plus pressés</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#requirements">Prérequis</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#download">Téléchargement</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extract">Extraction</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configure">Configuration de l'arborescence des sources</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#compile">Construction</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">Installation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#customize">Personnalisation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#test">Test</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#upgrading">Mise à jour</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#thirdp">Paquets tiers</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="programs/configure.html">Configuration de l'arborescence
des sources</a></li><li><a href="invoking.html">Démarrer Apache httpd</a></li><li><a href="stopping.html">Arrêt et redémarrage</a></li><li><a href="#comments_section">Commentaires</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="overview" id="overview">Aperçu pour les plus pressés</a></h2>
<dl>
<dt>Installation sous Fedora/CentOS/Red Hat Enterprise Linux</dt>
<dd>
<pre class="prettyprint lang-">sudo yum install httpd
sudo service httpd start</pre>
<div class="warning">Les dernières versions de ces distributions préfèrent
<code>dnf</code> à <code>yum</code>. Voir la <a href="https://fedoraproject.org/wiki/Apache_HTTP_Server">documentation du
projet Fedora</a> pour des informations spécifiques à cette plateforme.</div>
</dd>
<dt>Installation sous Ubuntu/Debian</dt>
<dd>
<pre class="prettyprint lang-">sudo apt install apache2
sudo service apache2 start</pre>
<div class="warning">Voir la <a href="https://help.ubuntu.com/lts/serverguide/httpd.html">documentation
Ubuntu</a> pour des informations spécifiques à cette plateforme.</div>
</dd>
<dt>Installation à partir des sources</dt>
<dd>
<table>
<tr>
<td><a href="#download">Téléchargement</a></td>
<td>Téléchargez la dernière version depuis <a href="http://httpd.apache.org/download.cgi#apache24">http://httpd.apache.org/download.cgi</a>
</td>
</tr>
<tr>
<td><a href="#extract">Extraction</a></td>
<td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar<br />
$ cd httpd-<em>NN</em></code></td>
</tr>
<tr>
<td><a href="#configure">Configuration</a></td>
<td><code>$ ./configure --prefix=<em>PREFIX</em></code>
</td>
</tr>
<tr>
<td><a href="#compile">Compilation</a></td>
<td><code>$ make</code> </td>
</tr>
<tr>
<td><a href="#install">Installation</a></td>
<td><code>$ make install</code> </td>
</tr>
<tr>
<td><a href="#customize">Personnalisation</a></td>
<td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
</tr>
<tr>
<td><a href="#test">Test</a></td>
<td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
</td>
</tr>
</table>
<p><em>NN</em> doit être remplacé par le numéro de version courant,
et <em>PREFIX</em> par le
chemin du répertoire d'installation. Si
<em>PREFIX</em> n'est pas spécifié, le chemin du répertoire
d'installation prendra sa valeur par défaut, à savoir
<code>/usr/local/apache2</code>.</p>
<p>Chaque étape du processus de compilation et d'installation est
décrite plus en détails ci-dessous, à commencer par les prérequis
pour compiler et installer Apache httpd.</p>
</dd>
</dl>
<div class="warning">L'installation sous votre plateforme favorite n'est pas
traitée ici ? N'hésitez pas à nous <a href="http://httpd.apache.org/docs-project/">aider à compléter cette
documentation</a> en nous faisant profiter de votre expérience.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="requirements" id="requirements">Prérequis</a></h2>
<p>Les prérequis pour la construction d'Apache httpd sont les suivants:</p>
<dl>
<dt>APR et APR-Util</dt>
<dd>APR et APR-Util doivent être déjà installés sur votre système.
Si ce n'est pas le cas, ou si vous préférez ne pas utiliser les
versions fournies par le système, téléchargez les dernières
versions d'APR et APR-Util depuis <a href="http://apr.apache.org/">Apache APR</a>, décompressez-les
respectivement dans <code>/racine_sources_httpd/srclib/apr</code> et
<code>/racine_sources_httpd/srclib/apr-util</code> (les noms des répertoires ne
doivent pas comporter de numéros de versions ; par exemple, la
distribution d'APR doit se trouver dans /racine_sources_httpd/srclib/apr/), et
utilisez l'option <code>--with-included-apr</code> du script
<code>./configure</code>. Sur certaines plateformes, vous devrez
peut-être installer les paquets <code>-dev</code> correspondants
pour permettre la compilation de httpd avec les versions
installées d'APR et APR-Util.</dd>
<dt>Bibliothèque d'expressions rationnelles compatibles Perl
(PCRE)</dt>
<dd>Cette bibliothèque est nécessaire mais n'est plus fournie avec la
distribution de httpd. Téléchargez le code source depuis <a href="http://www.pcre.org/">http://www.pcre.org</a> ou installez
un portage du paquet. Si votre suite de compilation ne trouve pas
le script pcre-config installé au cours du processus de
construction de PCRE, indiquez son chemin via l'option
<code>--with-pcre</code> du script <code>./configure</code>. Sur
certaines plateformes, vous devrez
peut-être installer les paquets <code>-dev</code> correspondants
pour permettre la compilation de httpd avec la version
installée de PCRE.</dd>
<dt>Espace disque</dt>
<dd>Assurez-vous d'avoir au moins 50 Mo d'espace disque disponible
temporaire. Après l'installation le serveur occupe
approximativement 10 Mo d'espace disque. L'espace disque réellement
nécessaire va varier considérablement en fonction de vos options
de configuration, de la présence éventuelle de
modules tiers, et bien entendu de la taille de votre site web et
des sites que vous hébergez sur votre serveur.</dd>
<dt>Compilateur ANSI-C et système de construction</dt>
<dd>Vous devez disposer d'un compilateur ANSI-C. Le compilateur <a href="http://gcc.gnu.org/">GNU C (GCC)</a> de la <a href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
est recommandé. Si vous ne possédez pas GCC,
assurez-vous au moins que votre compilateur soit compatible ANSI.
En outre, votre <code>PATH</code> doit contenir
les outils de construction de base tels que <code>make</code>.</dd>
<dt>Connaissance de l'heure exacte</dt>
<dd>Les éléments du protocole HTTP font référence à l'heure du jour.
Par conséquent, il est nécessaire d'équiper votre système d'un
dispositif de synchronisation du temps. Les programmes
<code>ntpdate</code> ou <code>xntpd</code>, basés sur le protocole NTP,
sont couramment utilisés à cet effet.
Voir la <a href="http://www.ntp.org">page d'accueil de NTP</a>
pour plus de détails à propos du logiciel NTP et des serveurs
de temps publics.</dd>
<dt><a href="http://www.perl.org/">Perl 5</a>
[OPTIONNEL]</dt>
<dd>L'interpréteur Perl 5 (les versions 5.003 ou supérieures conviennent)
est nécessaire pour l'exécution de certains scripts comme
<code class="program"><a href="./programs/apxs.html">apxs</a></code> ou <code class="program"><a href="./programs/dbmmanage.html">dbmmanage</a></code>
(qui sont écrits en Perl).
Si le script <code class="program"><a href="./programs/configure.html">configure</a></code> ne trouve pas d'interpréteur
Perl 5, vous ne pourrez pas utiliser les scripts qui en ont besoin.
Bien entendu, vous pourrez tout de même construire et utiliser
Apache httpd.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="download" id="download">Téléchargement</a></h2>
<p>Le serveur HTTP Apache peut être téléchargé à partir du
<a href="http://httpd.apache.org/download.cgi">site de téléchargement
du serveur HTTP Apache</a>, qui fournit la liste de nombreux miroirs.
Il sera plus commode à la plupart des utilisateurs d'Apache sur les
systèmes UNIX ou similaires de télécharger et de compiler
la version sources. Le processus de construction (décrit ci-dessous) est
simple, et vous permet de personnaliser votre serveur selon vos besoins.
En outre, les versions binaires sont souvent plus anciennes que les
dernières versions sources. Si vous téléchargez une version binaire,
suivez les instructions décrites dans le fichier
<code>INSTALL.bindist</code> inclus dans la distribution.</p>
<p>Après le téléchargement, il est important de vérifier que vous
disposez d'une version complète et non modifiée du serveur HTTP Apache.
Vous pouvez le faire en testant l'archive téléchargée à l'aide de
la signature PGP. Vous trouverez les détails de cette opération sur la <a href="http://httpd.apache.org/download.cgi#verify">page de téléchargement</a> ainsi qu'un exemple précis décrivant <a href="http://httpd.apache.org/dev/verification.html">l'utilisation de
PGP</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="extract" id="extract">Extraction</a></h2>
<p>L'extraction des sources depuis l'archive du serveur HTTP Apache consiste
simplement à décompresser et à désarchiver cette dernière :</p>
<div class="example"><p><code>
$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar
</code></p></div>
<p>Ceci créera, dans le répertoire courant, un nouveau répertoire
contenant le code source de la distribution. Vous devrez vous positionner
dans ce répertoire avant de procéder à la compilation du serveur.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configure" id="configure">Configuration de l'arborescence des sources</a></h2>
<p>L'étape suivante consiste à configurer l'arborescence des sources
d'Apache en fonction de votre plateforme et de vos besoins personnels.
Le script <code class="program"><a href="./programs/configure.html">configure</a></code>, situé à la racine du
répertoire de la distribution, a été conçu à cet effet
(Les développeurs qui téléchargent
une version non officielle de l'arborescence des sources d'Apache
devront disposer de
<code>autoconf</code> et <code>libtool</code> et
exécuter <code>buildconf</code> avant de passer à l'étape suivante,
ce qui n'est pas nécessaire pour les versions officielles).</p>
<p>Pour configurer l'arborescence des sources avec les valeurs par défaut
pour toutes les options, entrez simplement <code>./configure</code>.
Pour modifier les valeurs des options, <code class="program"><a href="./programs/configure.html">configure</a></code>
accepte toute une variété de variables et
d'options de ligne de commande.</p>
<p>L'option la plus importante <code>--prefix</code> est le chemin
du répertoire d'installation d'Apache, car Apache doit être configuré
en fonction de ce chemin pour pouvoir fonctionner correctement.
Il est possible de définir plus finement le chemin d'installation des fichiers
à l'aide d'<a href="programs/configure.html#installationdirectories">options
supplémentaires de configure</a>.</p>
<p>À ce niveau, vous pouvez aussi spécifier de quelles <a href="programs/configure.html#optionalfeatures">fonctionnalités</a> vous
voulez disposer dans Apache en activant ou désactivant des <a href="mod/">modules</a>. Apache est fourni avec un grand nombre de
modules inclus par défaut. Ils seront compilés en tant qu'<a href="dso.html">objets partagés (DSOs)</a> qui pourront être chargés
ou déchargés à l'exécution. Vous pouvez aussi choisir de compiler
les modules statiquement via l'option
<code>--enable-<var>module</var>=static</code>.</p>
<p>Des modules supplémentaires peuvent être activés à l'aide de l'option
<code>--enable-<var>module</var></code>, où
<var>module</var> est le nom du module sans la chaîne
<code>mod_</code> et où tout caractère de soulignement est converti
en tiret. D'une manière similaire,
vous pouvez désactiver des modules à l'aide de l'option
<code>--disable-<var>module</var></code>. Faites très attention
en utilisant ces options, car <code class="program"><a href="./programs/configure.html">configure</a></code> n'est pas en
mesure de vous avertir si le module que vous avez spécifié n'existe pas;
il ignorera tout simplement l'option.</p>
<p>En outre, vous devrez peut-être fournir au script
<code class="program"><a href="./programs/configure.html">configure</a></code> des informations supplémentaires sur
le chemin de votre compilateur, de vos bibliothèques, ou de vos fichiers
d'en-têtes. A cet effet, vous pouvez passer des options de ligne de
commande ou des variables d'environnement au script
<code class="program"><a href="./programs/configure.html">configure</a></code>. Pour plus d'informations, voir la
page de manuel de <code class="program"><a href="./programs/configure.html">configure</a></code>, ou lancez le script
<code class="program"><a href="./programs/configure.html">configure</a></code> avec l'option <code>--help</code>.
</p>
<p>Pour vous faire une idée des possibilités qui s'offrent à vous, voici
un exemple typique de compilation d'Apache avec le répertoire
d'installation <code>/sw/pkg/apache</code>, un compilateur et des drapeaux
particuliers et les deux modules additionnels <code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>
et <code class="module"><a href="./mod/mod_lua.html">mod_lua</a></code> :</p>
<div class="example"><p><code>
$ CC="pgcc" CFLAGS="-O2" \<br />
./configure --prefix=/sw/pkg/apache \<br />
--enable-ldap=shared \<br />
--enable-lua=shared
</code></p></div>
<p>Plusieurs minutes peuvent être nécessaires à
<code class="program"><a href="./programs/configure.html">configure</a></code> pour tester la disponibilité des
fonctionnalités
au sein de votre système, et construire les Makefiles qui seront utilisés
par la suite pour compiler le serveur.</p>
<p>Vous trouverez une description détaillée des options de
<code class="program"><a href="./programs/configure.html">configure</a></code> dans sa page de manuel.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="compile" id="compile">Construction</a></h2>
<p>Vous pouvez maintenant construire les différents éléments qui
composent le paquet Apache en lançant tout simplement la commande :</p>
<div class="example"><p><code>$ make</code></p></div>
<p>Vous devez être patient, car il faut plusieurs minutes pour compiler
une configuration de base, et cette durée peut varier considérablement
en fonction de votre matériel et du nombre de modules que vous avez activés.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">Installation</a></h2>
<p>Il est temps maintenant d'installer le paquet dans le répertoire
d'installation défini par <em>PREFIX</em> (voir plus haut l'option
<code>--prefix</code>) en lançant:</p>
<div class="example"><p><code>$ make install</code></p></div>
<p>Cette étape nécessite habituellement les privilèges
de root, car <em>PREFIX</em> est en général un
répertoire possèdant des droits en écriture
restreints.</p>
<p>Si vous effectuez une mise à jour, l'installation n'écrasera pas
vos fichiers de configuration ou autres documents.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="customize" id="customize">Personnalisation</a></h2>
<p>Ensuite, vous pourrez personnaliser votre Serveur HTTP Apache en
éditant les <a href="configuring.html">fichiers de configuration</a>
situés dans <code><em>PREFIX</em>/conf/</code>.</p>
<div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
<p>Consultez le manuel d'Apache situé dans
<code><em>PREFIX</em>/docs/manual/</code> ou
<a href="http://httpd.apache.org/docs/2.4/">http://httpd.apache.org/docs/2.4/</a> pour la version la plus
récente de ce manuel et la liste complète des <a href="mod/directives.html">directives de configuration</a> disponibles.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="test" id="test">Test</a></h2>
<p>Vous pouvez maintenant <a href="invoking.html">démarrer</a> votre
serveur HTTP Apache en lançant:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k start</code></p></div>
<p>Vous devriez alors pouvoir requérir votre premier document
à l'aide de l'URL <code>http://localhost/</code>. La page web que vous
voyez est située dans le répertoire défini par la directive
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>,
qui est généralement <code><em>PREFIX</em>/htdocs/</code>.
Pour <a href="stopping.html">arrêter</a> le serveur, lancez:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k stop</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="upgrading" id="upgrading">Mise à jour</a></h2>
<p>La première étape d'une mise à jour consiste à lire l'annonce de la
sortie de la nouvelle version et le fichier <code>CHANGES</code>
dans la distribution des sources afin de déceler toutes les modifications
qui pourraient affecter votre site. Lors d'un changement majeur de version
(par exemple de 2.0 à 2.2 ou de 2.2 à 2.4),
il y aura certainement des différences importantes quant à la
configuration de la compilation et de l'exécution qui nécessiteront des
ajustements manuels. Tous les
modules devront aussi être mis à jour pour qu'ils s'adaptent aux
changements de l'API des modules.</p>
<p>La mise à jour d'une version mineure à la suivante (par exemple, de
2.2.55 à 2.2.57) est plus aisée. Le processus <code>make install</code>
n'écrasera aucun de vos documents existants, fichiers de log,
ou fichiers de configuration. De plus, les développeurs font tout
leur possible pour éviter les changements entraînant une
incompatibilité dans les options de
<code class="program"><a href="./programs/configure.html">configure</a></code>, la configuration de l'exécution, ou l'API
des modules d'une version mineure à l'autre. Dans la plupart des cas,
vous pourrez utiliser une ligne de commande
<code class="program"><a href="./programs/configure.html">configure</a></code> identique, le même fichier de configuration,
et tous vos modules continueront de fonctionner.</p>
<p>Pour effectuer une mise à jour entre deux versions mineures,
commencez par trouver le fichier
<code>config.nice</code> dans le répertoire de <code>construction</code>
de votre serveur installé ou à la racine de l'arborescence des sources
de votre ancienne installation. Il contient la reproduction exacte de la
ligne de commande <code class="program"><a href="./programs/configure.html">configure</a></code> que vous avez utilisée pour
configurer l'arborescence des sources. Ensuite, pour mettre à jour
l'ancienne version vers la nouvelle,
il vous suffit de copier le fichier <code>config.nice</code> dans
l'arborescence des sources de la nouvelle version, de l'éditer pour
effectuer toute modification souhaitée, et de lancer :</p>
<div class="example"><p><code>
$ ./config.nice<br />
$ make<br />
$ make install<br />
$ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
$ <em>PREFIX</em>/bin/apachectl -k start<br />
</code></p></div>
<div class="warning">Vous devez toujours effectuer un test de la nouvelle
version dans votre environnement avant de la mettre en production.
Par exemple, vous pouvez installer et exécuter la nouvelle version
en parallèle avec l'ancienne en utilisant une option
<code>--prefix</code> et un port différents (en ajustant la directive
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>) afin de déceler toute
incompatibilité avant d'effectuer la mise à jour définitive.</div>
<p>Vous pouvez ajouter des arguments supplémentaires à
<code>config.nice</code> ; ils seront alors ajoutés aux options de
votre script <code class="program"><a href="./programs/configure.html">configure</a></code> original :</p>
<div class="example"><p><code>
$ ./config.nice --prefix=/home/test/apache --with-port=90
</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="thirdp" id="thirdp">Paquets tiers</a></h2>
<p>De nombreux tiers fournissent leur propre distribution du
serveur HTTP Apache à installer sur une plate-forme particulière. On
peut citer les différentes distributions Linux, divers
paquets tiers Windows, Mac OS X, Solaris et de nombreux autres.</p>
<p>Notre license logicielle non seulement permet, mais aussi
encourage ce genre de redistribution. Cependant, ceci conduit à une
situation ou l'organisation de la configuration et les valeurs par
défaut de votre installation du serveur peuvent ne pas correspondre
à ce qui est écrit dans la documentation. Bien que fâcheuse, cette
situation n'est pas appelée à évoluer de sitôt.</p>
<p>Une <a href="http://wiki.apache.org/httpd/DistrosDefaultLayout">description
de ces distributions tierces</a> est maintenue dans le wiki du
serveur HTTP, et doit en refléter l'état actuel. Vous devrez
cependant vous familiariser par vous-même avec la gestion du paquet
de votre plate-forme particulière et les procédures d'installation.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/install.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_0.html.fr.utf8 0000664 0001751 0001751 00000044427 14740503670 022360 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Vue d'ensemble des nouvelles fonctionnalités de la
version 2.0 du serveur HTTP Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Vue d'ensemble des nouvelles fonctionnalités de la
version 2.0 du serveur HTTP Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document décrit les changements majeurs apportés entre les
versions 1.3 et 2.0 du serveur HTTP Apache.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Améliorations du Système de Base</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Amélioration des Modules</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="upgrading.html">Migrer à 2.0 depuis la version 1.3</a></li><li><a href="#comments_section">Commentaires</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="core" id="core">Améliorations du Système de Base</a></h2>
<dl>
<dt>Threading Unix</dt>
<dd>Sur les systèmes Unix qui supportent les threads
POSIX, Apache httpd
peut à présent tourner en mode hybride multi-processus et
multi-threadé, ce qui augmente l'extensibilité et la performance
du serveur pour la plupart des configurations.</dd>
<dt>Nouveau Système de Compilation</dt>
<dd>Le processus de compilation a été refait de A à Z;
il utilise à présent <code>autoconf</code> et <code>libtool</code>,
ce qui rend la compilation d'Apache httpd plus familière aux utilisateurs
d'autre logiciels de mème type.</dd>
<dt>Support Multiprotocole</dt>
<dd>Le serveur HTTP Apache dispose désormais de
l'infrastructure nécessaire pour supporter
d'autres protocoles. Le module <code class="module"><a href="./mod/mod_echo.html">mod_echo</a></code> illustre ces
possibilités.</dd>
<dt>Support amélioré des Plate-formes non-Unix</dt>
<dd>Le serveur HTTP Apache 2.0 se montre plus rapide et plus stable sur les plate-formes
non Unix, telles BeOS, OS/2, NetWare et Windows. L'apparition des
<a href="mpm.html">Modules Multi-Processus</a> (MPMs), ainsi que de
la bibliothèque "Apache Portable Runtime" (APR) permet à Apache de
tirer parti des API natives de ces plate-formes, sans s'appuyer sur leurs
couches POSIX souvent boguées et peu optimisées.</dd>
<dt>Nouvelle API d'Apache httpd</dt>
<dd>L'Interface de Programmation (API) des modules a beaucoup changé
avec le passage à la version 2.0.
Les problèmes d'ordre et de priorité des modules, rencontrés
avec la version 1.3, devraient maintenant être résolus. Apache 2.0
gère ces problèmes de façon automatique. L'ordre des modules
est géré au moyen de "crochets" (hooks), ce qui rend la gestion
flexible. De nouveaux appels ont été également créés
afin de permettre l'implémentation d'autres fonctions dans les modules,
sans devoir corriger le noyau du serveur HTTP Apache.</dd>
<dt>Support IPv6</dt>
<dd>Sur les systèmes où la bibliothèque Apache Portable Runtime
supporte IPv6, Apache peut par défaut écouter sur des interfaces
de connexions IPv6. Les directives <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>,
<code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code> et
<code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> supportent également
les adresses IPv6 (comme par exemple, dans "<code>Listen[2001:db8::1]:8080</code>").</dd>
<dt>Filtering</dt>
<dd>Il est maintenant possible d'écrire des modules
pour Apache httpd pour filtrer
les flux de données entrant ou sortant du serveur. A titre d'exemple,
il est possible de filtrer des directives Server Side Include de la sortie
standard d'un script CGI, au moyen du filtre <code>INCLUDES</code> fourni
par le module <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>. Le module
<code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> permet quant à lui l'utilisation comme
filtres de programmes externes à Apache, de la même manière
qu'on peut utiliser des programmes CGI comme Handlers.</dd>
<dt>Réponses d'Erreurs Multilangues</dt>
<dd>Les messages d'erreur envoyés au navigateur existent à présent en
plusieurs langues avec des documents SSI. Ces messages peuvent être
personnalisés par l'administrateur afin de s'intégrer avec le site web.</dd>
<dt>Simplification de la Configuration</dt>
<dd>Beaucoup de directives, auparavant peu claires, ont été simplifiées.
Les directives <code>Port</code> et <code>BindAddress</code>, souvent
sources d'incompréhension, ont disparus. Désormais seule la directive
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> sert de liaison pour les
adresses IP; la directive <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> ne
précise le nom du serveur et son port que pour les redirections et la
gestion des hôtes virtuels.</dd>
<dt>Support natif de l'Unicode sous Windows NT</dt>
<dd>Apache httpd 2.0 sur Windows NT utilise à présent l'utf-8 pour tous les
noms de fichiers. Ces noms de fichiers sont directement traduits vers
l'encodage Unicode du système de fichiers, ce qui permet le support
multilangue pour toutes les installations sur la famille NT de Windows, y
compris Windows 2000 et Windows XP.<em>Ce support n'est pas fonctionnel
pour Windows 95, 98 ni ME, qui utilisent les pages de code locales pour
les accès au système de fichiers, comme auparavant.</em></dd>
<dt>Mise à jour de la Bibliothèque d'Expressions Rationnelles</dt>
<dd>Apache httpd 2.0 contient la <a href="http://www.pcre.org/">bibliothèque
d'expressions rationnelles compatible Perl </a>(Perl Compatible Regular
Expression Library - PCRE). Toutes les expressions rationnelles sont dont
gérées avec la syntaxe de Perl 5, plus puissante.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Amélioration des Modules</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>Apparu dans Apache httpd 2.0, ce module est une interface aux protocoles de
chiffrement SSL/TLS fournis par OpenSSL.</dd>
<dt><code class="module"><a href="./mod/mod_dav.html">mod_dav</a></code></dt>
<dd>Apparu dans Apache httpd 2.0, ce module implémente les spécifications HTTP de
gestion distribuée de versions et de rédaction (Distributed Authoring and
Versioning - DAV), destinées à la mise en ligne et à la maintenance des
contenus Web.</dd>
<dt><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></dt>
<dd>Module apparu dans Apache httpd 2.0, mod_deflate permet aux navigateurs qui
le supportent de demander la compression des contenus envoyés par le serveur.
Cela a l'avantage de réduite l'occupation de la bande passante.</dd>
<dt><code class="module">mod_auth_ldap</code></dt>
<dd>Apparu dans Apache httpd 2.0.41, ce module permet aux administrateurs
d'utiliser un arbre LDAP pour gérer la base d'utilisateurs pour les
Authentifications Basiques HTTP. Un module voisin,
<code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>, permet de globaliser les connexions à l'arbre LDAP
et de garder en mémoire cache ces accès.</dd>
<dt><code class="module"><a href="./mod/mod_auth_digest.html">mod_auth_digest</a></code></dt>
<dd>Améliore les fonctions de cache sur une session entre les différents
processus, en utilisant de la mémoire partagée.</dd>
<dt><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></dt>
<dd>Apparu dans Apache httpd 2.0, ce module expérimental permet la conversion
et l'enregistrement entre jeux de caractères.</dd>
<dt><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></dt>
<dd>Apparu dans Apache httpd 2.0, ce module implémente les fonctionnalités du
module <code>mod_mmap_static</code> présent du serveur
HTTP Apache 1.3, et offre des
fonctions plus avancées pour la gestion du cache.</dd>
<dt><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></dt>
<dd>Ce module gagne beaucoup de flexibilité avec Apache
httpd 2.0 : on peut
désormais l'utiliser pour modifier les en-têtes des requêtes
utilisés par <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>, et pour positionner les
en-têtes des réponses de manière conditionnelle.</dd>
<dt><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dt>
<dd>Le module proxy a été réécrit de A à Z. Il tire
maintenant avantage de la nouvelle infrastructure de filtrage, et implémente
un mandataire plus fiable, et conforme aux normes HTTP/1.1. De nouvelles
sections de configuration ajoutées à
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
donnent un contrôle plus lisible et un traitement plus rapide des requêtes
mandatées ; les configurations surchargées <code><Directory
"proxy:..."></code> ne sont pas supportées. Le module a aussi été
fragmenté en plusieurs modules qui gèrent chacun leur protocole :
<code>proxy_connect</code>, <code>proxy_ftp</code> et
<code>proxy_http</code>.</dd>
<dt><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></dt>
<dd>Une nouvelle directive, <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code> a été ajoutée,
elle permet de garantir que le client reçoit un seul document dans tous les
cas, au lieu de réponses NOT ACCEPTABLE ou MULTIPLE CHOICES. Les
algorithmes gérant la négociation et les vues multiples (MultiViews) ont
été nettoyés et donnent des réponses plus logiques. Un nouveau format de
carte de types (map type) qui peut gérer le contenu de documents a
aussi été ajouté.</dd>
<dt><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code></dt>
<dd>Les listes auto-générées par Autoindex sont à présent
configurables, et peuvent utiliser des tables HTML pour une mise en forme plus propre.
L'ordre d'affichage des fichiers est également finement paramètrable,
comme pour le tri par version, et le filtrage par caractères jokers du
listage du répertoire.</dd>
<dt><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dt>
<dd>De nouvelles directives permettent de modifier la valeur par défaut
des drapeaux <em>start</em> et <em>end</em> des éléments SSI. Ces directives
permettent à la configuration d'affichage de dates et heures d'être
effectuée dans le fichier de configuration principal, plutôt que dans le
document SSI. Les réponses données par des recherches par expressions
rationnelles (qui gèrent à présent les regex Perl) sont
recupérées au moyen des variables <code>$0</code> à <code>$9</code>.</dd>
<dt><code class="module">mod_auth_dbm</code></dt>
<dd>Plusieurs bases de données DBM sont supportées, et sélectionnables
via la directive <code class="directive">AuthDBMType</code>.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_0.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/stopping.html.es 0000664 0001751 0001751 00000046513 14743132254 020204 0 ustar covener covener <?xml version="1.0" encoding="ISO-8859-1"?>
<!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="es" xml:lang="es"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Iniciar y Parar el servidor Apache - Servidor HTTP Apache Versión 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p>
<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
<img alt="" src="./images/feather.png" /></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/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="./">Versión 2.4</a></div><div id="page-content"><div id="preamble"><h1>Iniciar y Parar el servidor Apache</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Esta traducción podría estar
obsoleta. Consulte la versión en inglés de la
documentación para comprobar si se han producido cambios
recientemente.</div>
<p>Este documento explica como iniciar y parar el servidor Apache
en sistemas tipo Unix. Los usuarios de Windows NT, 2000 y XP
deben consultar la sección <a href="platform/windows.html#winsvc">Ejecutar Apache como un
servicio</a> y los usuario de Windows 9x y ME deben consultar <a href="platform/windows.html#wincons">Ejecutar Apache como una
Aplicación de Consola</a> para obtener información
sobre como controlar Apache en esas plataformas.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introducción</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#term">Parar Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#graceful">Reinicio Graceful</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#hup">Reiniciar Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#race">Apéndice: señales y race conditions</a></li>
</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="programs/httpd.html">httpd</a></li><li><a href="programs/apachectl.html">apachectl</a></li><li><a href="#comments_section">Comentarios</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="introduction" id="introduction">Introducción</a></h2>
<p>Para parar y reiniciar Apache, hay que enviar la señal
apropiada al proceso padre <code>httpd</code> que se esté
ejecutando. Hay dos maneras de enviar estas señales. En
primer lugar, puede usar el comando de Unix <code>kill</code> que
envía señales directamente a los procesos. Puede que
tenga varios procesos <code>httpd</code> ejecutandose en su
sistema, pero las señales deben enviarse solamente al proceso
padre, cuyo pid está especificado en la directiva <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>. Esto quiere decir que no
debe necesitar enviar señales a ningún proceso excepto
al proceso padre. Hay tres señales que puede enviar al
proceso padre: <code><a href="#term">TERM</a></code>, <code><a href="#hup">HUP</a></code>, y <code><a href="#graceful">USR1</a></code>, que van a ser descritas a
continuación.</p>
<p>Para enviar una señal al proceso padre debe escribir un
comando como el que se muestra en el ejemplo:</p>
<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
<p>La segunda manera de enviar señales a los procesos
<code>httpd</code> es usando las opciones de línea de
comandos <code>-k</code>: <code>stop</code>, <code>restart</code>,
y <code>graceful</code>, como se muestra más abajo. Estas
opciones se le pueden pasar al binario <a href="programs/httpd.html">httpd</a>, pero se recomienda que se
pasen al script de control <a href="programs/apachectl.html">apachectl</a>, que a su vez los
pasará a <code>httpd</code>.</p>
<p>Después de haber enviado las señales que desee a
<code>httpd</code>, puede ver como progresa el proceso
escribiendo:</p>
<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
<p>Modifique estos ejemplos para que coincidan con la
configuración que tenga especificada en las directivas
<code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> y <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> en su fichero principal de
configuración.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="term" id="term">Parar Apache</a></h2>
<dl><dt>Señal: TERM</dt>
<dd><code>apachectl -k stop</code></dd>
</dl>
<p>Enviar las señales <code>TERM</code> o <code>stop</code>
al proceso padre hace que se intenten eliminar todos los procesos
hijo inmediatamente. Esto puede tardar algunos minutos. Una vez
que hayan terminado todos los procesos hijo, terminará el
proceso padre. Cualquier petición en proceso terminará
inmediatanmente, y ninguna petición posterior será
atendida.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="graceful" id="graceful">Reinicio Graceful</a></h2>
<dl><dt>Señal: USR1</dt>
<dd><code>apachectl -k graceful</code></dd>
</dl>
<p>Las señales <code>USR1</code> o <code>graceful</code>
hacen que el proceso padre <em>indique</em> a sus hijos que
terminen después de servir la petición que estén
atendiendo en ese momento (o de inmediato si no están
sirviendo ninguna petición). El proceso padre lee de nuevo
sus ficheros de configuración y vuelve a abrir sus ficheros
log. Conforme cada hijo va terminando, el proceso padre lo va
sustituyendo con un hijo de una nueva <em>generación</em> con
la nueva configuración, que empeciezan a servir peticiones
inmediatamente.</p>
<div class="note">En algunas plataformas que no permiten usar
<code>USR1</code> para reinicios graceful, puede usarse una
señal alternativa (como <code>WINCH</code>). Tambien puede
usar <code>apachectl graceful</code> y el script de control
enviará la señal adecuada para su plataforma.</div>
<p>Apache está diseñado para respetar en todo momento la
directiva de control de procesos de los MPM, así como para
que el número de procesos y hebras disponibles para servir a
los clientes se mantenga en los valores adecuados durante el
proceso de reinicio. Aún más, está diseñado
para respetar la directiva <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> de la siguiente
manera: si después de al menos un segundo el nuevo hijo de la
directiva <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
no ha sido creado, entonces crea los suficientes para se atienda
el trabajo que queda por hacer. Así, se intenta mantener
tanto el número de hijos adecuado para el trabajo que el
servidor tenga en ese momento, como respetar la configuración
determinada por los parámetros de la directiva
<code class="directive">StartServers</code>.</p>
<p>Los usuarios del módulo <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
notarán que las estadísticas del servidor
<strong>no</strong> se ponen a cero cuando se usa la señal
<code>USR1</code>. Apache fue escrito tanto para minimizar el
tiempo en el que el servidor no puede servir nuevas peticiones
(que se pondrán en cola por el sistema operativo, de modo que
se no se pierda ningún evento), como para respetar sus
parámetros de ajuste. Para hacer esto, tiene que guardar el
<em>scoreboard</em> usado para llevar el registro de los procesos
hijo a través de las distintas generaciones.</p>
<p>El mod_status también usa una <code>G</code> para indicar
que esos hijos están todavía sirviendo peticiones
previas al reinicio graceful.</p>
<p>Actualmente no existe ninguna manera de que un script con un
log de rotación usando <code>USR1</code> sepa con seguridad
que todos los hijos que se registraron en el log con anterioridad
al reinicio han terminado. Se aconseja que se use un retardo
adecuado después de enviar la señal <code>USR1</code>
antes de hacer nada con el log antiguo. Por ejemplo, si la mayor
parte las visitas que recibe de usuarios que tienen conexiones de
baja velocidad tardan menos de 10 minutos en completarse, entoces
espere 15 minutos antes de hacer nada con el log antiguo.</p>
<div class="note">Si su fichero de configuración tiene errores cuando
haga el reinicio, entonces el proceso padre no se reinciciará
y terminará con un error. En caso de un reinicio graceful,
también dejará a los procesos hijo ejecutandose mientras
existan. (Estos son los hijos de los que se está saliendo de
forma graceful y que están sirviendo sus últimas
peticiones.) Esto provocará problemas si intenta reiniciar el
servidor -- no será posible conectarse a la lista de puertos
de escucha. Antes de reiniciar, puede comprobar que la sintaxis de
sus ficheros de configuracion es correcta con la opción de
línea de comandos <code>-t</code> (consulte <a href="programs/httpd.html">httpd</a>). No obstante, esto no
garantiza que el servidor se reinicie correctamente. Para
comprobar que no hay errores en los ficheros de
configuración, puede intentar iniciar <code>httpd</code> con
un usuario diferente a root. Si no hay errores, intentará
abrir sus sockets y logs y fallará porque el usuario no es
root (o porque el <code>httpd</code> que se está ejecutando
en ese momento ya está conectado a esos puertos). Si falla
por cualquier otra razón, entonces casi seguro que hay
algún error en alguno de los ficheros de configuración y
debe corregir ese o esos errores antes de hacer un reinicio
graceful.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="hup" id="hup">Reiniciar Apache</a></h2>
<dl><dt>Señal: HUP</dt>
<dd><code>apachectl -k restart</code></dd>
</dl>
<p>El envío de las señales <code>HUP</code> o
<code>restart</code> al proceso padre hace que los procesos hijo
terminen como si le enviá ramos la señal
<code>TERM</code>, para eliminar el proceso padre. La diferencia
está en que estas señales vuelven a leer los archivos de
configuración y vuelven a abrir los ficheros log. Se genera
un nuevo conjunto de hijos y se continúa sirviendo
peticiones.</p>
<p>Los usuarios del módulo <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
notarán que las estadísticas del servidor se ponen a
cero cuando se envía la señal <code>HUP</code>.</p>
<div class="note">Si su fichero de configuración contiene errores, cuando
intente reiniciar, el proceso padre del servidor no se
reiniciará, sino que terminará con un error. Consulte
más arriba cómo puede solucionar este problema.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="race" id="race">Apéndice: señales y race conditions</a></h2>
<p>Con anterioridad a la versión de Apache 1.2b9 había
varias <em>race conditions</em> implicadas en las señales
para parar y reiniciar procesos (una descripción sencilla de
una race condition es: un problema relacionado con el momento en
que suceden las cosas, como si algo sucediera en momento en que no
debe, y entonces el resultado esperado no se corresponde con el
obtenido). Para aquellas arquitecturas que tienen el conjunto de
características "adecuadas", se han eliminado tantas race
conditions como ha sido posible. Pero hay que tener en cuenta que
todavía existen race conditions en algunas arquitecturas.</p>
<p>En las arquitecturas que usan un <code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code> en disco, existe la
posibilidad de que se corrompan los scoreboards. Esto puede hacer
que se produzca el error "bind: Address already in use"
(después de usar<code>HUP</code>) o el error "long lost child
came home!" (después de usar <code>USR1</code>). En el
primer caso se trata de un error irrecuperable, mientras que en el
segundo, solo ocurre que el servidor pierde un slot del
scoreboard. Por lo tanto, sería aconsejable usar reinicios
graceful, y solo hacer reinicios normales de forma
ocasional. Estos problemas son bastante complicados de solucionar,
pero afortunadamente casi ninguna arquitectura necesita un fichero
scoreboard. Consulte la documentación de la directiva
<code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code> para ver
las arquitecturas que la usan.</p>
<p>Todas las arquitecturas tienen una pequeña race condition
en cada proceso hijo implicada en la segunda y subsiguientes
peticiones en una conexión HTTP persistente
(KeepAlive). Puede ser que el servidor termine después de
leer la línea de petición pero antes de leer cualquiera
de las cebeceras de petición. Hay una solución que fue
descubierta demasiado tarde para la incluirla en versión
1.2. En teoria esto no debe suponer ningún problema porque el
cliente KeepAlive ha de esperar que estas cosas pasen debido a los
retardos de red y a los timeouts que a veces dan los
servidores. En la practica, parece que no afecta a nada más
-- en una sesión de pruebas, un servidor se reinició
veinte veces por segundo y los clientes pudieron navegar sin
problemas por el sitio web sin encontrar problemas ni para
descargar una sola imagen ni encontrar un solo enlace roto. </p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/stopping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Licencia bajo los términos de la <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Módulos</a> | <a href="./mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="./glossary.html">Glosario</a> | <a href="./sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/suexec.html.ja.utf8 0000664 0001751 0001751 00000102324 14743132254 020476 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="ja" xml:lang="ja"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>suEXEC サポート - Apache HTTP サーバ バージョン 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">モジュール</a> | <a href="./mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p>
<p class="apache">Apache HTTP サーバ バージョン 2.4</p>
<img alt="" src="./images/feather.png" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>suEXEC サポート</h1>
<div class="toplang">
<p><span>翻訳済み言語: </span><a href="./en/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/suexec.html" title="Japanese"> ja </a> |
<a href="./ko/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">この日本語訳はすでに古くなっている
可能性があります。
最近更新された内容を見るには英語版をご覧下さい。
</div>
<p><strong>suEXEC</strong>
機能により、Apache ユーザは Web サーバを実行しているユーザ ID とは
異なるユーザ ID で <strong>CGI</strong> プログラムや <strong>SSI</strong>
プログラムを実行することができます。CGI プログラムまたは SSI
プログラムを実行する場合、通常は web サーバと同じユーザで実行されます。
</p>
<p>適切に使用すると、この機能によりユーザが個別の CGI
や SSI プログラムを開発し実行することで生じるセキュリティ上の危険を、
かなり減らすことができます。しかし、suEXEC の設定が不適切だと、
多くの問題が生じ、あなたのコンピュータに新しいセキュリティホールを
作ってしまう可能性があります。あなたが <em>setuid root</em>
されたプログラムと、それらから生じるセキュリティ上の問題の管理に
詳しくないようなら、suEXEC の使用を検討しないように強く推奨します。
</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#before">始める前に</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#model">suEXEC セキュリティモデル</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">suEXEC
の設定とインストール</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#enable">suEXEC
の有効化と無効化</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#usage">suEXEC の使用</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#debug">suEXEC のデバッグ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#jabberwock">とかげに注意: 警告と事例</a></li>
</ul><h3>参照</h3><ul class="seealso"><li><a href="#comments_section">コメント</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="before" id="before">始める前に</a></h2>
<p>この文書の先頭に飛ぶ前に、Apache
グループとこの文書での仮定を知っておくべきでしょう。
</p>
<p>第 1 に、あなたが <strong>setuid</strong> と
<strong>setgid</strong> 操作が可能な UNIX
由来のオペレーティングシステムを使っていることを想定しています。
これは、すべてのコマンド例にあてはまります。
その他のプラットホームでは、もし suEXEC
がサポートされていたとしても設定は異なるかもしれません。</p>
<p>第 2 に、あなたが使用中のコンピュータの
セキュリティに関する基本的な概念と、それらの管理について詳しいことを
想定しています。これは、<strong>setuid/setgid</strong>
操作、あなたのシステム上でのその操作による様々な効果、
セキュリティレベルについてあなたが理解しているということを含みます。
</p>
<p>第 3 に、<strong>改造されていない</strong> suEXEC
コードの使用を想定しています。suEXEC のコードは、
多くのベータテスタだけでなく、開発者によっても注意深く精査され
テストされています。それらの注意により、簡潔で信頼できる安全な
コードの基盤が保証されます。このコードを改変することで、
予期されない問題や新しいセキュリティ上の危険が生じることがあります。
セキュリティプログラミングの詳細に通じていて、
今後の検討のために成果を Apache
グループと共有しようと思うのでなければ、suEXEC
コードは変えないことを <strong>強く</strong>推奨します。</p>
<p>第 4 に、これが最後ですが、suEXEC を Apache
のデフォルトインストールには<strong>含めない</strong>ことが
Apache グループで決定されています。これは、suEXEC
の設定には管理者の詳細にわたる慎重な注意が必要だからです。
suEXEC の様々な設定について検討が終われば、管理者は suEXEC
を通常のインストール方法でインストールすることができます。
これらの設定値は、suEXEC
機能の使用中にシステムセキュリティを適切に保つために、
管理者によって慎重に決定され指定されることが必要です。
この詳細な手順により、Apache グループは、suEXEC
のインストールについて、注意深く十分に検討してそれを使用することを
決定した場合に限っていただきたいと考えています。
</p>
<p>それでも進みますか? よろしい。では、先へ進みましょう!</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="model" id="model">suEXEC セキュリティモデル</a></h2>
<p>suEXEC の設定とインストールを始める前に、
まず実装しようとしているセキュリティモデルについて論じておきます。
それには、suEXEC の内部で行なわれていること、
システムのセキュリティを保証するために警告されることを
よく理解しておいた方がよいでしょう。</p>
<p><strong>suEXEC</strong> は、Apache web
サーバから呼び出される setuid された "wrapper"
プログラムが基本となっています。設計した CGI、または SSI
プログラムへの HTTP リクエストがあると、この wrapper
が呼び出されます。このようなリクエストがあると、Apache
はそのプログラムが実行される際のプログラム名とユーザ ID とグループ
ID を指定して suEXEC wrapper を実行します。
</p>
<p>それから、wrapper は成功または失敗を決定するため
以下の処理を行ないます。これらの状態のうち一つでも失敗した場合、
プログラムは失敗をログに記録してエラーで終了します。
そうでなければ、後の処理が続けられます。</p>
<ol>
<li>
<strong>wrapper
を実行しているユーザはこのシステムの正当なユーザか?</strong>
<p class="indent">
これは、wrapper を実行しているユーザが
本当にシステムの利用者であることを保証するためです。
</p>
</li>
<li>
<strong>wrapper が適切な数の引数で呼び出されたか?</strong>
<p class="indent">
wrapper は適切な数の引数が与えられた場合にのみ実行されます。
適切な引数のフォーマットは Apache Web サーバに解釈されます。
適切な数の引数を受け取らなければ、攻撃をされたか
あなたの Apache バイナリの suEXEC の部分が
どこかおかしい可能性があります。
</p>
</li>
<li>
<strong>この正当なユーザは wrapper
の実行を許可されているか?</strong>
<p class="indent">
このユーザは wrapper 実行を許可されたユーザですか?
ただ一人のユーザ (Apache ユーザ) だけが、
このプログラムの実行を許可されます。
</p>
</li>
<li>
<strong>対象の CGI, SSI プログラムが安全でない階層の参照をしているか?
</strong>
<p class="indent">
対象の CGI, SSI プログラムが '/' から始まる、または
'..' による参照を行なっていますか? これらは許可されません。
対象のプログラムは suEXEC のドキュメントルート
(下記の <code>--with-suexec-docroot=<em>DIR</em></code> を参照)
内に存在しなければなりません。
</p>
</li>
<li>
<strong>対象となるユーザ名は正当なものか?</strong>
<p class="indent">
対象となるユーザ名は存在していますか?
</p>
</li>
<li>
<strong>対象となるグループ名は正当なものか?</strong>
<p class="indent">
対象となるグループ名は存在していますか?
</p>
</li>
<li>
<strong>目的のユーザはスーパーユーザでは<em>ない</em>か?
</strong>
<p class="indent">
今のところ、suEXEC は <code><em>root</em></code> による CGI/SSI
プログラムの実行を許可していません。
</p>
</li>
<li>
<strong>対象となるユーザ ID は、最小の ID
番号よりも<em>大きい</em>か? </strong>
<p class="indent">
最小ユーザ ID 番号は設定時に指定されます。これは、
CGI/SSI プログラム実行を許可されるユーザ ID
のとりうる最小値です。これは
"system" 用のアカウントを閉め出すのに有効です。
</p>
</li>
<li>
<strong>対象となるグループはスーパーユーザのグループでは
<em>ない</em>か?</strong>
<p class="indent">
今のところ、suEXEC は 'root' グループによる CGI/SSI
プログラムの実行を許可していません。
</p>
</li>
<li>
<strong>対象となるグループ ID は最小の ID
番号よりも<em>大きい</em>か?</strong>
<p class="indent">
最小グループ ID 番号は設定時に指定されます。これは、
CGI/SSI プログラム実行を許可されるグループ
ID のとりうる最小値です。
これは "system" 用のグループを閉め出すのに有効です。
</p>
</li>
<li>
<strong>wrapper が正常に対象となるユーザとグループになれるか?
</strong>
<p class="indent">
ここで、setuid と setgid
の起動によりプログラムは対象となるユーザとグループになります。
グループアクセスリストは、
ユーザが属しているすべてのグループで初期化されます。
</p>
</li>
<li>
<strong>CGI/SSI プログラムが置かれているディレクトリに移動
(change directory) できるか?</strong>
<p class="indent">
ディレクトリが存在しないなら、そのファイルも存在しないかもしれません。
ディレクトリに移動できないのであれば、おそらく存在もしないでしょう。
</p>
</li>
<li>
<strong>ディレクトリが Apache のドキュメントツリー内にあるか?
</strong>
<p class="indent">
リクエストがサーバ内のものであれば、
要求されたディレクトリが suEXEC のドキュメントルート配下にありますか?
リクエストが UserDir のものであれば、要求されたディレクトリが suEXEC
のユーザのドキュメントルート配下にありますか?
(<a href="#install">suEXEC 設定オプション</a> 参照)
</p>
</li>
<li>
<strong>ディレクトリを他のユーザが書き込めるようになって
<em>いない</em>か?</strong>
<p class="indent">
ディレクトリを他ユーザに開放しないようにします。
所有ユーザだけがこのディレクトリの内容を改変できるようにします。
</p>
</li>
<li>
<strong>対象となる CGI/SSI プログラムは存在するか?</strong>
<p class="indent">
存在しなければ実行できません。
</p>
</li>
<li>
<strong>対象となる CGI/SSI プログラムファイルが他アカウントから
書き込めるようになって<em>いない</em>か?</strong>
<p class="indent">
所有者以外には CGI/SSI プログラムを変更する権限は与えられません。
</p>
</li>
<li>
<strong>対象となる CGI/SSI プログラムが setuid または setgid
されて<em>いない</em>か?</strong>
<p class="indent">
UID/GID を再度変更してのプログラム実行はしません
</p>
</li>
<li>
<strong>対象となるユーザ/グループがプログラムの
ユーザ/グループと同じか?</strong>
<p class="indent">
ユーザがそのファイルの所有者ですか?
</p>
</li>
<li>
<strong>安全な動作を保証するための環境変数クリアが可能か?
</strong>
<p class="indent">
suEXEC は、安全な環境変数のリスト
(これらは設定時に作成されます) 内の変数として渡される安全な
PATH 変数 (設定時に指定されます) を設定することで、
プロセスの環境変数をクリアします。
</p>
</li>
<li>
<strong>対象となる CGI/SSI プログラムを exec して実行できるか?</strong>
<p class="indent">
ここで suEXEC が終了し、対象となるプログラムが開始されます。
</p>
</li>
</ol>
<p>ここまでが suEXEC の wrapper
におけるセキュリティモデルの標準的な動作です。もう少し厳重に
CGI/SSI 設計についての新しい制限や規定を取り入れることもできますが、
suEXEC はセキュリティに注意して慎重に少しずつ開発されてきました。
</p>
<p>このセキュリティモデルを用いて
サーバ設定時にどのように許すことを制限するか、また、suEXEC
を適切に設定するとどのようなセキュリティ上の危険を避けられるかに
関するより詳しい情報については、<a href="#jabberwock">"とかげに注意"
(Beware the Jabberwock)</a> の章を参照してください。
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">suEXEC
の設定とインストール</a></h2>
<p>ここから楽しくなります。</p>
<p><strong>suEXEC
設定オプション</strong><br />
</p>
<dl>
<dt><code>--enable-suexec</code></dt>
<dd>このオプションは、デフォルトではインストールされず、
有効にはならない suEXEC 機能を有効にします。
suEXEC を使うように APACI に要求するには、<code>--enable-suexec</code>
オプションにあわせて少なくとも一つは <code>--with-suexec-xxxxx</code>
オプションが指定されなければなりません。</dd>
<dt><code>--with-suexec-bin=<em>PATH</em></code></dt>
<dd>セキュリティ上の理由により、<code>suexec</code> バイナリのパスはサーバに
ハードコードされている必要があります。デフォルトのパスを
変えたいときはこのオプションを使ってください。<em>例えば</em>、
<code>--with-suexec-bin=/usr/sbin/suexec</code> のように。</dd>
<dt><code>--with-suexec-caller=<em>UID</em></code></dt>
<dd>Apache を通常動作させる<a href="mod/mpm_common.html#user">ユーザ名</a>を指定します。
このユーザだけが suexec の実行を許可されたユーザになります。</dd>
<dt><code>--with-suexec-userdir=<em>DIR</em></code></dt>
<dd>suEXEC がアクセスを許されるユーザホームディレクトリ配下の
サブディレクトリを指定します。
このディレクトリ以下の全実行ファイルは、"安全な"プログラムになるよう、
suEXEC がそのユーザとして実行できるようにします。
"単純な" UserDir ディレクティブを使っている場合
(すなわち "*" を含まないもの)、これと同じ値を設定すべきです。
Userdir ディレクティブがそのユーザのパスワードファイル内の
ホームディレクトリと同じ場所を指していなければ、
suEXEC は適切に動作しません。デフォルトは "public_html" です。
<br />
各 UserDir が異なった仮想ホストを設定している場合、
それらを全て一つの親ディレクトリに含めて、
その親ディレクトリの名前をここで指定する必要があります。
<strong>このように指定されなければ "~userdir" cgi
へのリクエストが動作しません。</strong></dd>
<dt><code>--with-suexec-docroot=<em>DIR</em></code></dt>
<dd>Apache のドキュメントルートを設定します。これが suEXEC
の動作で使用する唯一のディレクトリ階層になります (UserDir
の指定は別)。デフォルトでは <code>--datedir</code> に "/htdocs"
というサフィックスをつけたものです。
"<code>--datadir=/home/apache</code>" として設定すると、
suEXEC wrapper にとって "/home/apache/htdocs"
がドキュメントルートとして使われます。</dd>
<dt><code>--with-suexec-uidmin=<em>UID</em></code></dt>
<dd>suEXEC の対象ユーザとして許される UID の最小値を指定します。
大抵のシステムでは 500 か 100 が一般的です。
デフォルト値は 100 です。</dd>
<dt><code>--with-suexec-gidmin=<em>GID</em></code></dt>
<dd>suEXEC の対象グループとして許される GID
の最小値を指定します。大抵のシステムでは 100 が一般的なので、
デフォルト値としても 100 が使われています。</dd>
<dt><code>--with-suexec-logfile=<em>FILE</em></code></dt>
<dd>suEXEC の処理とエラーが記録されるファイル名を指定します。
(監査やデバッグ目的に有用)
デフォルトではログファイルは "suexec_log" という名前で、
標準のログファイルディレクトリ (<code>--logfiledir</code>) に置かれます。
</dd>
<dt><code>--with-suexec-safepath=<em>PATH</em></code></dt>
<dd>CGI 実行ファイルに渡される安全な PATH 環境変数です。
デフォルト値は "/usr/local/bin:/usr/bin:/bin" です。
</dd>
</dl>
<p><strong>suEXEC wrapper
のコンパイルとインストール</strong><br />
<code>--enable-suexec</code> オプションで suEXEC 機能を有効にすると、
"make" コマンドを実行した時に <code>suexec</code> のバイナリ (Apache 自体も)
が自動的に作成されます。
<br />
すべての構成要素が作成されると、それらのインストールには
<code>make install</code> コマンドが実行できます。バイナリイメージの <code>suexec</code>
は <code>--sbindir</code> オプションで指定されたディレクトリにインストールされます。
デフォルトの場所は "/usr/local/apache/bin/suexec" です。<br />
インストール時には <strong><em>root</em></strong>
権限が必要なので注意してください。wrapper がユーザ ID
を設定するために、所有者 <code><em>root</em></code>
でのセットユーザ ID
ビットをそのファイルのモードに設定しなければなりません。
</p>
<p><strong>安全なパーミッションを設定する</strong><br />
suEXEC ラッパーは、<code>--with-suexec-caller</code> <code class="program"><a href="./programs/configure.html">configure</a></code>
オプションで指定した正しいユーザで起動されていることを確認しますが、
システム上でこのチェックが行なわれる前に、
suEXEC が呼ぶシステムやライブラリが脆弱である可能性は残ります。対抗策として、
一般に良い習慣ともされいますが、
ファイルシステムパーミッションを使って
Apache の実行時のグループのみが suEXEC を実行できるように
するのが良いでしょう。</p>
<p>たとえば、次のようにサーバが設定されていたとします。</p>
<div class="example"><p><code>
User www<br />
Group webgroup<br />
</code></p></div>
<p><code class="program"><a href="./programs/suexec.html">suexec</a></code> が "/usr/local/apache2/bin/suexec"
にインストールされていた場合、次のように設定する必要があります。</p>
<div class="example"><p><code>
chgrp webgroup /usr/local/apache2/bin/suexec<br />
chmod 4750 /usr/local/apache2/bin/suexec<br />
</code></p></div>
<p>これで Apache が実行されるグループのみが
suEXEC ラッパーを実行できるということを
確証します。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="enable" id="enable">suEXEC
の有効化と無効化</a></h2>
<p>起動時に、Apache は <code>--sbindir</code>
オプションで設定されたディレクトリで
<code>suexec</code> を探します
(デフォルトは "/usr/local/apache/sbin/suexec") 。
適切に設定された suEXEC がみつかると、
エラーログに以下のメッセージが出力されます。</p>
<div class="example"><p><code>
[notice] suEXEC mechanism enabled (wrapper: <var>/path/to/suexec</var>)
</code></p></div>
<p>サーバ起動時にこのメッセージが出ない場合、
大抵はサーバが想定した場所で wrapper プログラムが見つからなかったか、
<em>setuid root</em> としてインストールされていないかです。</p>
<p>suEXEC の仕組みを使用するのが初めてで、Apache が既に動作中であれば、
Apache を kill して、再起動しなければなりません。HUP シグナルや
USR1 シグナルによる単純な再起動では不十分です。</p>
<p>suEXEC を無効にする場合は、<code>suexec</code> ファイルを削除してから
Apache を kill して再起動します。
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="usage" id="usage">suEXEC の使用</a></h2>
<p>CGI プログラムへのリクエストが suEXEC ラッパーを呼ぶのは、
<code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> ディレクティブを
含むバーチャルホストへのリクエストか、<code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code> により
処理されたリクエストの場合に限ります。</p>
<p><strong>仮想ホスト:</strong><br />
suEXEC wrapper の使い方として、
<code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> 設定での
<code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code>
ディレクティブを通したものがあります。
このディレクティブをメインサーバのユーザ ID
と異なるものにすると、CGI リソースへのすべてのリクエストは、その
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> で指定された <em>User</em> と
<em>Group</em> として実行されます。<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
でこのディレクティブが指定されていない場合、
メインサーバのユーザ ID が想定されます。</p>
<p><strong>ユーザディレクトリ:</strong><br />
<code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code> により処理されたリクエストは
リクエストされたユーザディレクトリのユーザ ID で CGI プログラムを
実行するために suEXEC ラッパーを呼びます。
この機能を動作させるために必要なことは、CGI
をそのユーザで実行できること、そのスクリプトが上記の<a href="#model">セキュリティ検査</a>をパスできることです。
<a href="#install">コンパイル
時のオプション</a> <code>--with-suexec-userdir</code> も参照してください。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="debug" id="debug">suEXEC のデバッグ</a></h2>
<p>suEXEC wrapper は、上記で述べた <code>--with-suexec-logfile</code>
オプションで指定されたファイルにログ情報を記録します。
wrapper を適切に設定、インストールできていると思う場合、
どこで迷っているか見ようとするならこのログとサーバの
エラーログを見るとよいでしょう。</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="jabberwock" id="jabberwock">とかげに注意: 警告と事例</a></h2>
<p><strong>注意!</strong>
この章は完全ではありません。この章の最新改訂版については、
Apache グループの<a href="http://httpd.apache.org/docs/2.4/suexec.html">
オンラインドキュメント</a>版を参照してください。
</p>
<p>サーバの設定に制限をもうける wrapper について、
いくつか興味深い点があります。suEXEC に関する "バグ"
を報告する前にこれらを確認してください。</p>
<ul>
<li><strong>suEXEC の興味深い点</strong></li>
<li>階層構造の制限
<p class="indent">
セキュリティと効率の理由から、<code>suEXEC</code> の全てのリクエストは
仮想ホストへのリクエストにおける最上位のドキュメントルート内か、
ユーザディレクトリへのリクエストにおける個々のユーザの最上位の
ドキュメントルート内に残らなければなりません。
例えば、四つの仮想ホストを設定している場合、
仮想ホストの suEXEC に有利なように、メインの Apache
ドキュメント階層の外側に全ての仮想ホストのドキュメントルートを
構築する必要があります。(例は後日記載)
</p>
</li>
<li>suEXEC の PATH 環境変数
<p class="indent">
これを変更するのは危険です。この指定に含まれる各パスが
<strong>信頼できる</strong>
ディレクトリであることを確認してください。
世界からのアクセスにより、誰かがホスト上でトロイの木馬
を実行できるようにはしたくないでしょう。
</p>
</li>
<li>suEXEC コードの改造
<p class="indent">
繰り返しますが、何をやろうとしているか把握せずにこれをやると
<strong>大きな問題</strong>を引き起こしかねません。
可能な限り避けてください。
</p>
</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>翻訳済み言語: </span><a href="./en/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/suexec.html" title="Japanese"> ja </a> |
<a href="./ko/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/suexec.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />この文書は <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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">用語</a> | <a href="./sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/urlmapping.html.ko.euc-kr 0000664 0001751 0001751 00000046516 14743132254 021711 0 ustar covener covener <?xml version="1.0" encoding="EUC-KR"?>
<!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="ko" xml:lang="ko"><head>
<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>URL Ͻý ġ ϱ - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/"></a> | <a href="./mod/directives.html">þ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>URL Ͻý ġ ϱ</h1>
<div class="toplang">
<p><span> : </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/urlmapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/urlmapping.html" title="Korean"> ko </a> |
<a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate"> ֽ ƴմϴ.
ֱٿ ϼ.</div>
<p> û URL ġ
Ͻýۻ ġ ã Ѵ.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#related">õ þ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#outside">DocumentRoot ۿ ִ ϵ</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#user"> 丮</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#redirect">URL ̷(Redirection)</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#proxy">Ͻ(Reverse Proxy)</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rewrite">ۼ (Rewriting Engine)</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#notfound">File Not Found</a></li>
</ul><h3></h3><ul class="seealso"><li><a href="#comments_section">Comments</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="related" id="related">õ þ</a></h2>
<table class="related"><tr><th>õ </th><th>õ þ</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code></li><li><code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code></li><li><code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_speling.html#checkspelling">CheckSpelling</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritematch">RewriteMatch</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="documentroot" id="documentroot">DocumentRoot</a></h2>
<p>û ġ ϱ
⺻ û URL-(URL ȣƮ Ʈ ڿ
κ) Ͽ <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> ڿ δ.
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> Ʒִ
ϰ 丮 Ե ⺻ ̴.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="outside" id="outside">DocumentRoot ۿ ִ ϵ</a></h2>
<p> Ͻýۿ <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> Ʒ κ
ʿ䰡 ִ. ġ
ִ. н ýۿ ɺũ Ͽ
Ͻý ٸ κ <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> Ʒ ִ.
ġ ش 丮 <code class="directive"><a href="./mod/core.html#options">Options</a></code>
<code>FollowSymLinks</code>
<code>SymLinksIfOwnerMatch</code> ִ 쿡 ɺũ
.</p>
<p>, <code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code>
þ Ͻý Ư κ Ѵ.
ٸ</p>
<div class="example"><p><code>Alias /docs /var/web</code></p></div>
<p>URL <code>http://www.example.com/docs/dir/file.html</code>
<code>/var/web/dir/file.html</code> Ѵ.
ο ִ CGI ũƮ ϴ
ϰ <code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
þ Ѵ.</p>
<p><code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code>
<code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code>
þ ǥı ġ Ͽ
ϴ. ,</p>
<div class="example"><p><code>ScriptAliasMatch ^/~([a-zA-Z0-9]+)/cgi-bin/(.+)
/home/$1/cgi-bin/$2</code></p></div>
<p> <code>http://example.com/~user/cgi-bin/script.cgi</code>
û <code>/home/user/cgi-bin/script.cgi</code>
ϰ, ش CGI ũƮ Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="user" id="user"> 丮</a></h2>
<p>н ý Ư <em>user</em>
Ȩ丮 <code>~user/</code> ĪѴ.
<code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>
ȮϿ, URL Ȩ丮
ȿ ִ Ѵ.</p>
<div class="example"><p><code>http://www.example.com/~user/file.html</code></p></div>
<p>Ȼ Ȩ丮
ȵȴ. <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code>
þ Ȩ丮 ϵ 丮
Ѵ. ⺻ <code>Userdir public_html</code> ϰ
<code>/home/user/</code> <code>/etc/passwd</code>
Ȩ丮, URL
<code>/home/user/public_html/file.html</code> Ѵ.</p>
<p>, <code>Userdir</code> þ <code>/etc/passwd</code>
Ȩ丮 ġ ʴ ý ٸ
¸ ִ.</p>
<p> ( <code>%7e</code> ڵǴ)
"~" ȣ ̻Ͽ ٸ 丮 Ÿ
;Ѵ. mod_userdir ʴ´.
Ȩ丮 Ģ ִٸ, <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code> þ Ͽ
ϴ ȿ ִ. ,
<code>AliasMatch</code> þ ϸ
<code>http://www.example.com/upages/user/file.html</code>
<code>/home/user/public_html/file.html</code> Ѵ:</p>
<div class="example"><p><code>AliasMatch ^/upages/([a-zA-Z0-9]+)/?(.*)
/home/$1/public_html/$2</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="redirect" id="redirect">URL ̷(Redirection)</a></h2>
<p>տ þ ġ Ͻý Ư
ҿ ִ Ŭ̾Ʈ .
û ٸ URL ִٰ Ŭ̾Ʈ ˷־,
Ŭ̾Ʈ URL ûϵ
ִ. ̸ <em>̷(redirection)</em>̶ ϸ,
<code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code> þ
Ѵ. , <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> Ʒ <code>/foo/</code>
丮 <code>/bar/</code> 丮 Űٸ
Ŭ̾Ʈ ο ġ ûϵ Ѵ:</p>
<div class="example"><p><code>Redirect permanent /foo/
http://www.example.com/bar/</code></p></div>
<p> <code>www.example.com</code> <code>/foo/</code>
ϴ URL-δ <code>/foo/</code> <code>/bar/</code>
ٲ URL ̷ǵȴ. Ŭ̾Ʈ ܿ
ٸ ε ̷ ִ.</p>
<p>, ġ ۼ
<code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code>
þ Ѵ. , ٸ û ״ ΰ Ʈ
Ȩ û ٸ Ʈ ̷Ϸ:</p>
<div class="example"><p><code>RedirectMatch permanent ^/$
http://www.example.com/startpage.html</code></p></div>
<p>ӽ÷ Ʈ ٸ Ʈ Ư
̷Ϸ:</p>
<div class="example"><p><code>RedirectMatch temp .*
http://othersite.example.com/startpage.html</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="proxy" id="proxy">Ͻ(Reverse Proxy)</a></h2>
<p>ġ ٸ ִ URL
ִ. ͼ
Ŭ̾Ʈ ϴ Ͻ ϱ ̷
<em>Ͻ(reverse proxying)</em> Ѵ. Ŭ̾Ʈ
忡 Ͻ ִ ó ̹Ƿ Ϲ
Ͻÿʹ ٸ.</p>
<p>Ʒ Ŭ̾Ʈ <code>/foo/</code> ִ
ûϸ, <code>internal.example.com</code>
<code>/bar/</code> 丮 ͼ ġ
־ ó Ŭ̾Ʈ .</p>
<div class="example"><p><code>
ProxyPass /foo/ http://internal.example.com/bar/<br />
ProxyPassReverse /foo/ http://internal.example.com/bar/
</code></p></div>
<p><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code>
ϸ, <code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> þ
<code>internal.example.com</code> ̷ ۼϿ
̷ 丮 Ű Ѵ.
, <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code>
<code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code>
Ű ۼѴ.</p>
<p> ȿ ִ ũ ۼ ϶.
<code>internal.example.com</code> 븵ũ Ŭ̾Ʈ
Ͻü ƴ϶ <code>internal.example.com</code>
ûϰ Ѵ. ڰ <a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a>
Ͽ HTML XHTML ִ ũ ۼ ִ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">ۼ (Rewriting Engine)</a></h2>
<p> ġȯ ʿҶ <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
ۼ ȴ. þ
Ŭ̾Ʈ IP ּ û Ư¡ ִ
ִ. , mod_rewrite û
ó ϱ ܺ ͺ̽ ̳
α ִ. ۼ ٷ
, , ̷ (alias), ܺ ̷,
Ͻ, θ Ѵ. mod_rewrite ϴ
<a href="misc/rewriteguide.html">URL ۼ ħ</a>
Ѵ.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="notfound" id="notfound">File Not Found</a></h2>
<p>ᱹ û URL ϴ Ͻýۿ ã
̴. ִ.
ٸ Ű ִ. Ŭ̾Ʈ
<a href="#redirect">URL ̷</a> ڿ ο
ġ ˷ִ . ڿ Űܵ
ϸũ ũ ȿϴ.</p>
<p>"File Not Found" ٸ Ϲ
Ȥ HTML ũ URL ߸ Էµ ̴. ġ
<code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> ( Ʋ ʾ)
̿ ´. ϸ "File Not Found"
ϴ ϸ ڿ ã´.
߰ϸ mod_speling Ŭ̾Ʈ ùٸ ġ
HTTP ̷Ѵ. "" ִٸ
Ŭ̾Ʈ .</p>
<p>mod_speling Ư ҹڸ ʰ
ϸ ϴ ̴. н Ͻý۰ URL
ҹ ϴ ڰ ִ ýۿ
ȴ. mod_speling URL ľѴٸ, "߸"
û URL ̷ǰ Ŭ̾Ʈ ο û
ϾǷ δ ȴ.</p>
<p>ã õ ϸ ġ HTTP status code 404
(file not found) .
<code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> þ
ϸ, <a href="custom-error.html"> </a>
Ͽ ִ.</p>
</div></div>
<div class="bottomlang">
<p><span> : </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/urlmapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/urlmapping.html" title="Korean"> ko </a> |
<a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/urlmapping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html"></a> | <a href="./sitemap.html">Ʈ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/configuring.html.fr.utf8 0000664 0001751 0001751 00000045611 14740503670 021537 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Fichiers de configuration - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Fichiers de configuration</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/configuring.html" title="Français"> fr </a> |
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document décrit les fichiers utilisés pour configurer
le Serveur HTTP Apache.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#main">Fichiers de configuration principaux</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#syntax">Syntaxe des fichiers de configuration</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Modules</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#scope">Portée des directives</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#htaccess">Fichiers .htaccess</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="main" id="main">Fichiers de configuration principaux</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#include">Include</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code></li></ul></td></tr></table>
<p>La configuration du serveur HTTP Apache est effectuée en plaçant des <a href="mod/directives.html">directives</a> dans des fichiers de
configuration au format texte. Le fichier de configuration principal se nomme
en général
<code>httpd.conf</code>. La localisation de ce fichier est définie
à la compilation, mais peut être redéfinie à l'aide de l'option
de ligne de commande <code>-f</code>. En outre, d'autres fichiers de
configuration peuvent être ajoutés à l'aide de la directive
<code class="directive"><a href="./mod/core.html#include">Include</a></code>, et des caractères de
remplacement
peuvent être utilisés pour inclure de nombreux fichiers de configuration.
Des directives de tous types peuvent être placées dans chacun de ces fichiers
de configuration. Les modifications dans les fichiers de configuration
principaux ne sont prises en compte par httpd que lorsque le serveur
est démarré ou redémarré.</p>
<p>Le serveur lit aussi un fichier contenant les types de document mime ;
ce fichier est défini par la directive <code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code>,
et se nomme <code>mime.types</code> par défaut.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="syntax" id="syntax">Syntaxe des fichiers de configuration</a></h2>
<p>Les fichiers de configuration de httpd contiennent une directive
par ligne.
On peut utiliser l'anti-slash "\" comme dernier caractère d'une ligne
pour indiquer que la directive continue à la ligne suivante.
Il ne doit y avoir aucun caractère ni espace entre l'anti-slash et
la fin de la ligne.</p>
<p>Les arguments des directives sont séparés les uns des autres par
des espaces. Si un argument contient des espaces, il doit être
entouré de guillemets.</p>
<p>Les directives dans les fichiers de configuration ne sont pas
sensibles à la casse, mais leurs arguments le sont souvent. Les lignes
qui débutent par le caractère "#" sont interprétées comme des
commentaires, et sont ignorées. Les commentaires ne doivent
<strong>pas</strong> apparaître sur la même ligne qu'une directive
de configuration. Les espaces précédant une directive
sont ignorés ; vous pouvez par conséquent indenter les directives
afin d'améliorer la lisibilité. Les lignes vides sont
aussi ignorées.</p>
<p>Les valeurs des variables d'environnement ou des variables définies via
la directive <code class="directive"><a href="./mod/core.html#define">Define</a></code> peuvent être
utilisées dans le fichier de configuration en utilisant la syntaxe
<code>${VAR}</code>. Si "VAR" est le nom d'une variable valable, la valeur
de la variable est alors substituée à la chaîne <code>${VAR}</code>, et le
processus de lecture du fichier de configuration continue comme si la
chaîne correspondant à la valeur de la variable s'y était trouvée
littéralement. Les variables définies via la directive <code class="directive"><a href="./mod/core.html#define">Define</a></code> l'emportent sur les autres variables
d'environnement de l'interpréteur de commande. Si la variable "VAR" n'est
pas trouvée, la chaîne <code>${VAR}</code> n'est pas modifiée, et un
avertissement est enregistré dans le journal. Le caractère ":" est interdit
dans les noms de variables afin d'éviter tout conflit avec la syntaxe de la
directive <code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p>
<p>Seules les variables d'environnement de l'interpréteur de commande
définies avant le démarrage du serveur peuvent être utilisées en extension.
Les variables d'environnement définies dans le fichier de configuration
lui-même, par exemple avec <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code>,
prennent effet trop tard pour pouvoir être utilisées en extension au sein
du fichier de configuration.</p>
<p>La longueur maximale d'une ligne dans un fichier de configuration
normal, après substitution des variables et fusion des lignes
interrompues, est approximativement de 16 Mo. Dans les <a href="configuring.html#htaccess">fichiers .htaccess</a>, la longueur
maximale est de 8190 caractères.</p>
<p>Vous pouvez vérifier l'absence d'erreurs de syntaxe dans vos fichiers
de configuration sans démarrer le serveur à l'aide de la commande
<code>apachectl configtest</code> ou de l'option de ligne de commande
<code>-t</code>.</p>
<p>Vous pouvez utiliser la définition <code>-DDUMP_CONFIG</code> de
<code class="module"><a href="./mod/mod_info.html">mod_info</a></code> pour afficher la configuration avec tous
les fichiers inclus et les variables d'environnement évaluées, tous
les commentaires et les sections <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> et <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> non actives ayant
été supprimés. Cependant, la sortie ne reflète
pas les fusions ou écrasements pouvant intervenir en cas de
définitions multiples de directives.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="modules" id="modules">Modules</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>httpd est un serveur modulaire. Ceci implique que seules les
fonctionnalités les plus courantes sont incluses dans le serveur de base.
Les fonctionnalités étendues sont fournies à l'aide de <a href="mod/">modules</a> qui peuvent être chargés dans httpd.
Par défaut, un jeu de <a href="mod/module-dict.html#Status">modules de base</a> est inclus dans le
serveur à la compilation. Si le serveur est compilé de façon à utiliser
les <a href="dso.html">modules chargés dynamiquement</a>,
alors les modules peuvent être compilés séparément et chargés à
n'importe quel moment à l'aide de la directive
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>.
Dans le cas contraire, httpd doit être recompilé pour ajouter ou
supprimer des modules.
Les directives de configuration peuvent être incluses de manière
conditionnelle selon la présence ou l'absence d'un module particulier
en les plaçant dans un bloc <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>.</p>
<p>Pour voir quels modules ont été compilés avec le serveur,
vous pouvez utiliser l'option de ligne de commande <code>-l</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="scope" id="scope">Portée des directives</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>Les directives placées dans les fichiers de configuration principaux
s'appliquent au serveur dans son ensemble. Si vous souhaitez modifier la
configuration d'une partie du serveur seulement, vous pouvez limiter la
portée de vos directives en les plaçant dans une section
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#files"><Files></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code> ou <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>.
Ces sections limitent le champ d'application des directives qu'elles
contiennent à des URls ou des portions du système de fichiers particulières.
Elles peuvent aussi être imbriquées, ce qui permet
une configuration très fine.</p>
<p>httpd peut servir simultanément de nombreux sites web au travers des <a href="vhosts/">Serveurs Virtuels</a>. La portée des directives peut ainsi
être limitée en les plaçant dans des sections <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>, afin qu'elles ne s'appliquent
qu'aux requêtes pour un site web particulier.</p>
<p>Bien que la plupart des directives puissent être placées dans
chacune de ces sections, certaines d'entre elles n'ont aucun sens
dans certains contextes.
Par exemple, les directives qui contrôlent la création des processus
n'ont de sens que dans le contexte du serveur global. Pour déterminer
quelles directives peuvent être placées dans quelles sections, consultez
le <a href="mod/directive-dict.html#Context">Contexte</a> de la
directive. Pour plus d'informations, nous fournissons des détails dans
<a href="sections.html">Comment fonctionnent les sections Directory,
Location et Files</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="htaccess" id="htaccess">Fichiers .htaccess</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
<p>httpd permet la gestion décentralisée de la configuration
à l'aide de fichiers spéciaux placés dans l'arborescence du site web.
Ces fichiers spéciaux se nomment en général <code>.htaccess</code>,
mais tout autre nom peut être spécifié à l'aide de la directive
<code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code>.
Les directives placées dans les fichiers <code>.htaccess</code>
s'appliquent au répertoire dans lequel vous avez placé le fichier,
ainsi qu'à tous ses sous-répertoires.
La syntaxe des fichiers <code>.htaccess</code> est la même que celle
des fichiers de configuration principaux. Comme les fichiers
<code>.htaccess</code> sont lus à chaque requête, les modifications de
ces fichiers prennent effet immédiatement.</p>
<p>Pour déterminer quelles directives peuvent être placées
dans les fichiers <code>.htaccess</code>, consultez le
<a href="mod/directive-dict.html#Context">Contexte</a> de la
directive. L'administrateur du serveur peut contrôler quelles
directives peuvent être placées dans les fichiers
<code>.htaccess</code> en définissant la directive
<code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
dans les fichiers de configuration principaux.</p>
<p>Pour plus d'informations sur les fichiers <code>.htaccess</code>,
se référer au <a href="howto/htaccess.html">tutoriel .htaccess</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/configuring.html" title="Français"> fr </a> |
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/configuring.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/dso.html.fr.utf8 0000664 0001751 0001751 00000054422 14740503670 020012 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Prise en charge des objets dynamiques partagés (DSO) - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Prise en charge des objets dynamiques partagés (DSO)</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dso.html" title="Français"> fr </a> |
<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>La conception modulaire du serveur HTTP Apache permet à l'administrateur
de choisir les fonctionnalités à inclure dans le serveur en sélectionnant
un certain nombre de modules. Les modules seront compilés en tant
qu'Objets Dynamiques Partagés (Dynamic Shared Objects ou DSOs)
qui mènent une existence séparée du fichier binaire principal
<code class="program"><a href="./programs/httpd.html">httpd</a></code>. Les modules DSO peuvent être compilés en
même temps que le serveur, ou compilés et ajoutés ultérieurement via
l'Outil des Extensions à Apache (Apache Extension Tool ou
<code class="program"><a href="./programs/apxs.html">apxs</a></code>).</p>
<p>Les modules peuvent aussi être intégrés statiquement dans le
binaire <code class="program"><a href="./programs/httpd.html">httpd</a></code> lors de la compilation de ce
dernier.</p>
<p>Ce document décrit l'utilisation des modules DSO ainsi que les dessous
de leur fonctionnement.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#implementation">Implémentation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#usage">Mode d'emploi succinct</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#background">Les dessous du fonctionnement des DSO</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#advantages">Avantages et inconvénients</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="implementation" id="implementation">Implémentation</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>La prise en charge de DSO pour le chargement de modules individuels d'Apache
httpd est
assuré par un module nommé <code class="module"><a href="./mod/mod_so.html">mod_so</a></code> qui doit être compilé
statiquement dans le coeur d'Apache httpd. Il s'agit du seul module avec le
module <code class="module"><a href="./mod/core.html">core</a></code> à ne pas pouvoir être compilé en tant que
module DSO lui-même. Pratiquement tous les autres modules d'Apache httpd
distribués seront alors compilés en tant que modules DSO. Une fois
compilé en tant que module DSO nommé <code>mod_foo.so</code>, un
module peut être chargé en mémoire au
démarrage ou redémarrage du serveur à l'aide de
la directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> du module
<code class="module"><a href="./mod/mod_so.html">mod_so</a></code> placée
dans votre fichier <code>httpd.conf</code>.</p>
<p>La compilation en mode DSO peut être désactivée pour certains
modules via l'option <code>--enable-mods-static</code> du script
<code class="program"><a href="./programs/configure.html">configure</a></code>, comme expliqué dans la <a href="install.html">Documentation sur l'installation</a>.</p>
<p>Un utilitaire permet de simplifier la création de
fichiers DSO pour les modules d'Apache httpd
(particulièrement pour les modules tiers) ; il s'agit du programme nommé
<code class="program"><a href="./programs/apxs.html">apxs</a></code> (<dfn>APache
eXtenSion</dfn>). On peut l'utiliser pour construire des modules de type
DSO <em>en dehors</em> de l'arborescence des sources d'Apache httpd. L'idée est
simple : à l'installation du serveur HTTP Apache, la procédure <code>make install</code>
du script <code class="program"><a href="./programs/configure.html">configure</a></code> installe les fichiers d'en-têtes
d'Apache httpd et positionne, pour la plateforme de compilation, les drapeaux du compilateur et de
l'éditeur de liens à l'intérieur du programme
<code class="program"><a href="./programs/apxs.html">apxs</a></code> qui sera utilisé pour la construction de fichiers DSO.
Il est ainsi possible d'utiliser le programme <code class="program"><a href="./programs/apxs.html">apxs</a></code>
pour compiler ses sources de modules Apache httpd sans avoir besoin de
l'arborescence des sources de la distribution d'Apache, et sans avoir à
régler les drapeaux du compilateur et de l'éditeur de liens pour la prise en charge de DSO.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="usage" id="usage">Mode d'emploi succinct</a></h2>
<p>Afin que vous puissiez vous faire une idée des fonctionnalités DSO
du serveur HTTP Apache 2.x, en voici un résumé court et concis :</p>
<ol>
<li>
<p>Construire et installer un module Apache httpd <em>faisant partie de la
distribution</em>, par exemple <code>mod_foo.c</code>,
en tant que module DSO <code>mod_foo.so</code> :</p>
<div class="example"><p><code>
$ ./configure --prefix=/chemin/vers/installation --enable-foo<br />
$ make install
</code></p></div>
</li>
<li>
<p>Configurer le serveur HTTP Apache avec tous les modules
activés. Seul un jeu de modules de base sera chargé au
démarrage du serveur. Vous pouvez modifier ce jeu de modules
chargés au démarrage en activant ou désactivant les directives <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> correspondantes dans le
fichier <code>httpd.conf</code>.</p>
<div class="example"><p><code>
$ ./configure --enable-mods-shared=all<br />
$ make install
</code></p></div>
<p>L'argument <code>most</code> de l'option
<code>--enable-modules</code> indique que tous les modules
non-expérimentaux ou qui ne sont pas là à titre d'exemple seront
compilés.</p>
</li>
<li>
<p>Certains modules ne sont utilisés que par les développeurs et
ne seront pas compilés. Si vous voulez les utiliser, spécifiez
l'option <em>all</em>. Pour compiler tous les modules disponibles,
y compris les modules de développeurs, spécifiez l'option
<em>reallyall</em>. En outre, la directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> peut être activée pour tous
les modules compilés via l'option du script configure
<code>--enable-load-all-modules</code>.</p>
<div class="example"><p><code>
$ ./configure --enable-mods-shared=reallyall --enable-load-all-modules<br />
$ make install
</code></p></div>
</li>
<li>
Construire et installer un module Apache httpd <em>tiers</em>, par exemple
<code>mod_foo.c</code>, en tant que module DSO
<code>mod_foo.so</code> <em>en dehors</em> de l'arborescence des sources
d'Apache httpd à l'aide du programme <code class="program"><a href="./programs/apxs.html">apxs</a></code> :
<div class="example"><p><code>
$ cd /chemin/vers/module_tiers<br />
$ apxs -cia mod_foo.c
</code></p></div>
</li>
</ol>
<p>Dans tous les cas, une fois le module partagé compilé, vous devez
ajouter une directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
dans le fichier <code>httpd.conf</code> pour qu'Apache httpd active le module.</p>
<p>Voir la <a href="programs/apxs.html">documentation sur apxs</a>
pour plus de détails.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="background" id="background">Les dessous du fonctionnement des DSO</a></h2>
<p>Les clones modernes d'UNIX proposent un mécanisme
appelé édition de liens et chargement dynamiques d'
<em>Objets Dynamiques Partagés</em> (DSO), qui permet de construire un
morceau de programme dans un format spécial pour le rendre chargeable
à l'exécution dans l'espace d'adressage d'un programme exécutable.</p>
<p>Ce chargement peut s'effectuer de deux manières : automatiquement par
un programme système appelé <code>ld.so</code> quand un programme
exécutable est démarré, ou manuellement à partir du programme en cours
d'exécution à l’aide de sa propre interface système vers le chargeur Unix à l'aide
des appels système <code>dlopen()/dlsym()</code>.</p>
<p>Dans la première méthode, les DSO sont en général appelés
<em>bibliothèques partagées</em> ou encore <em>bibliothèques DSO</em>, et
possèdent des noms du style
<code>libfoo.so</code> ou <code>libfoo.so.1.2</code>. Ils résident dans un
répertoire système (en général <code>/usr/lib</code>)
et le lien avec le programme exécutable est établi à la compilation en
ajoutant <code>-lfoo</code> à la commande de l'éditeur de liens. Les
références à la bibliothèque sont ainsi codées en dur dans le fichier du
programme exécutable de façon qu'au démarrage du programme, le
chargeur Unix soit capable de localiser <code>libfoo.so</code> dans
<code>/usr/lib</code>, dans des chemins codés en dur à l'aide d'options de
l'éditeur de liens comme <code>-R</code> ou dans des chemins définis par la
variable d'environnement
<code>LD_LIBRARY_PATH</code>. Le chargeur peut dès lors résoudre tous les symboles
(jusque là non encore résolus) du DSO dans le programme exécutable.</p>
<p>Les symboles du programme exécutable ne sont en général pas
référencés par le DSO (car c'est une bibliothèque de code à usage général
et réutilisable),
et ainsi aucune résolution supplémentaire n'est nécessaire. De son côté,
le programme exécutable ne doit accomplir aucune action particulière
pour utiliser les
symboles du DSO car toutes les résolutions sont effectuées par le chargeur
Unix. En fait, le code permettant d'invoquer
<code>ld.so</code> fait partie du code de démarrage pour l'exécution qui
est lié dans tout programme exécutable non statiquement lié.
L'avantage du chargement dynamique du code d'une bibliothèque partagée est
évident : le code de la bibliothèque ne doit être stocké qu'une seule fois
dans une bibliothèque système telle que <code>libc.so</code>, ce qui permet
d'économiser de l'espace disque pour les autres programmes.</p>
<p>Dans la seconde méthode, les DSO sont en général appelés <em>objets
partagés</em> ou <em>fichiers DSO</em>, et peuvent être nommés avec
l'extension de son choix (bien que le nom conseillé soit du style
<code>foo.so</code>). Ces fichiers résident en général dans un répertoire
spécifique à un programme, et aucun lien n'est automatiquement établi avec
le programme exécutable dans lequel ils sont utilisés.
Le programme exécutable charge manuellement le DSO à l'exécution dans son
espace d'adressage à l'aide de l'appel système <code>dlopen()</code>.
A ce moment, aucune résolution de symboles du DSO n'est effectuée pour le
programme exécutable. Par contre le chargeur Unix
résoud automatiquement tout symbole du DSO (non encore résolu)
faisant partie de l'ensemble de symboles exporté par le programme
exécutable et ses bibliothèques DSO déjà chargées (et en particulier tous
les symboles de la bibliothèque à tout faire <code>libc.so</code>).
De cette façon, le DSO prend connaissance de l'ensemble de symboles du
programme exécutable comme s'il avait été lié statiquement avec lui
auparavant.</p>
<p>Finalement, pour tirer profit de l'API des DSO, le programme exécutable
doit résoudre certains symboles du DSO à l'aide de l'appel système
<code>dlsym()</code> pour une utilisation ultérieure dans les tables de
distribution, <em>etc.</em> En d'autres termes, le programme exécutable doit
résoudre manuellement tous les symboles dont il a besoin pour pouvoir les
utiliser.
Avantage d'un tel mécanisme : les modules optionnels du programme n'ont pas
besoin d'être chargés (et ne gaspillent donc pas de ressources mémoire)
tant qu'il ne sont pas nécessaires au programme en question. Si nécessaire,
ces modules peuvent être chargés dynamiquement afin d'étendre les
fonctionnalités de base du programme.</p>
<p>Bien que ce mécanisme DSO paraisse évident, il comporte au moins une
étape difficile : la résolution des symboles depuis le programme exécutable
pour le DSO lorsqu'on utilise un DSO pour étendre les fonctionnalités d'un
programme (la seconde méthode). Pourquoi ? Parce que la « résolution
inverse » des symboles DSO à partir du jeu de symboles du programme
exécutable dépend de la conception de la bibliothèque (la bibliothèque n'a
aucune information sur le programme qui l'utilise) et n'est ni standardisée
ni disponible sur toutes les plateformes. En pratique, les symboles globaux
du programme exécutable ne sont en général pas réexportés et donc
indisponibles pour l'utilisation dans un DSO. Trouver une méthode pour
forcer l'éditeur de liens à exporter tous les symboles globaux est le
principal problème que l'on doit résoudre lorsqu'on utilise un DSO pour
étendre les fonctionnalités d'un programme au moment de son exécution.</p>
<p>L'approche des bibliothèques partagées est la plus courante, parce que
c'est dans cette optique que le mécanisme DSO a été conçu ; c'est cette
approche qui est ainsi
utilisée par pratiquement tous les types de bibliothèques que fournit le
système d'exploitation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="advantages" id="advantages">Avantages et inconvénients</a></h2>
<p>Les fonctionnalités ci-dessus basées sur les DSO présentent les
avantages suivants :</p>
<ul>
<li>Le paquetage du serveur est plus flexible à l'exécution car le
processus serveur peut être assemblé à l'exécution via la
directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> du fichier de
configuration <code>httpd.conf</code> plutôt que par des options du script
<code class="program"><a href="./programs/configure.html">configure</a></code> à la compilation. Par exemple,
on peut ainsi exécuter différentes instances du serveur
(standard et version SSL, version minimale et version dynamique
[mod_perl, mod_php], <em>etc.</em>) à partir d'une seule installation
d'Apache httpd.</li>
<li>Le paquetage du serveur peut être facilement étendu avec des modules
tiers, même après l'installation. Ceci présente un gros
avantage pour les mainteneurs de paquetages destinés aux distributions,
car ils peuvent créer un paquetage Apache httpd de base, et des paquetages
additionnels contenant des extensions telles que PHP, mod_perl, mod_fastcgi,
<em>etc.</em></li>
<li>Une facilité de prototypage des modules Apache httpd, car la paire
DSO/<code class="program"><a href="./programs/apxs.html">apxs</a></code> vous permet d'une part de travailler en
dehors de l'arborescence des sources d'Apache httpd, et d'autre part de n'avoir
besoin que de la commande <code>apxs -i</code>
suivie d'un <code>apachectl restart</code> pour introduire une nouvelle
version de votre module fraîchement développé dans le serveur HTTP Apache
en cours d'exécution.</li>
</ul>
<p>Inconvénients des DSO :</p>
<ul>
<li>Le serveur est environ 20 % plus lent au démarrage
à cause des résolutions de symboles supplémentaires que le chargeur
Unix doit effectuer.</li>
<li>Le serveur est environ 5 % plus lent à l'exécution
sur certaines plates-formes, car le code indépendant de la position (PIC)
nécessite parfois des manipulations compliquées en assembleur pour
l'adressage relatif qui ne sont pas toujours aussi rapides que celles
que permet l'adressage absolu.</li>
<li>Comme les modules DSO ne peuvent pas être liés avec d'autres
bibliothèques basées sur DSO (<code>ld -lfoo</code>) sur toutes les
plates-formes
(par exemple, les plates-formes basées sur a.out ne fournissent en
général pas cette fonctionnalité alors que les plates-formes basées sur
ELF le font), vous ne pouvez pas utiliser le mécanisme DSO pour tous les
types de modules. Ou en d'autres termes, les modules compilés comme
fichiers DSO sont contraints de n'utiliser que les symboles du coeur
d'Apache httpd, de la bibliothèque C
(<code>libc</code>) et toutes autres bibliothèques statiques ou
dynamiques utilisées par le coeur d'Apache httpd, ou d'archives statiques
(<code>libfoo.a</code>) contenant du code indépendant de la
position (PIC).
Il y a deux solutions pour utiliser un autre type de code : soit le
coeur d'Apache httpd contient déjà lui-même une référence au code, soit vous
chargez le code vous-même à l’aide de <code>dlopen()</code>.</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/dso.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/dso.html" title="Français"> fr </a> |
<a href="./ja/dso.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dso.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dso.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/dso.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/filter.html.fr.utf8 0000664 0001751 0001751 00000040014 14740503670 020502 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Filtres - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Filtres</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/filter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/filter.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/filter.html" title="Français"> fr </a> |
<a href="./ja/filter.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/filter.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/filter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document décrit l'utilisation des filtres avec Apache.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#intro">Le filtrage avec Apache 2</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#smart">Filtrage intelligent</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#service">Présentation des filtres en tant que service HTTP</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Utilisation des filtres</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="intro" id="intro">Le filtrage avec Apache 2</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code></li><li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></li><li><code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code></li><li><code class="module"><a href="./mod/mod_buffer.html">mod_buffer</a></code></li><li><code class="module"><a href="./mod/mod_data.html">mod_data</a></code></li><li><code class="module"><a href="./mod/mod_ratelimit.html">mod_ratelimit</a></code></li><li><code class="module"><a href="./mod/mod_reqtimeout.html">mod_reqtimeout</a></code></li><li><code class="module"><a href="./mod/mod_request.html">mod_request</a></code></li><li><code class="module"><a href="./mod/mod_sed.html">mod_sed</a></code></li><li><code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code></li><li><code class="module"><a href="./mod/mod_xml2enc.html">mod_xml2enc</a></code></li><li><code class="module"><a href="./mod/mod_proxy_html.html">mod_proxy_html</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_filter.html#filterchain">FilterChain</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprotocol">FilterProtocol</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_reflector.html#reflectorheader">ReflectorHeader</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilteroptions">ExtFilterOptions</a></code></li><li><code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code></li><li><code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code></li></ul></td></tr></table>
<p>La chaîne de filtrage est disponible depuis la version 2.0 d'Apache,
et permet aux applications de traiter les données en entrée et en sortie
d'une manière hautement flexible et configurable, quelle que soit la
provenance de ces données. Il est possible de pré-traiter les données
en entrée, et post-traiter les données en sortie, selon
vos souhaits.
Ces traitements sont tout à fait indépendants des traditionnelles phases
de traitement des requêtes.</p>
<p class="figure">
<img src="images/filter_arch.png" width="569" height="392" alt="les filtres peuvent s'enchaîner, perpendiculairement au traitement des requêtes" />
</p>
<p>Voici quelques exemples de filtrage avec la distribution standard d'Apache:</p>
<ul>
<li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>, implémente les inclusions côté serveur.</li>
<li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>, implémente le cryptage SSL (https).</li>
<li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>, implémente la compression/décompression
à la volée.</li>
<li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code>, transcodage entre différents
jeux de caractères.</li>
<li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>, utilisation d'un programme externe
comme filtre.</li>
</ul>
<p>Apache utilise aussi plusieurs filtres en interne pour accomplir des tâches
comme le découpage des grosses requêtes (chunking) et la gestion des
requêtes portant sur une partie d'un fichier (byte-range).</p>
<p>Un grand choix d'applications sont implémentées par des modules de filtrage
tiers. En voici quelques exemples :</p>
<ul>
<li>Traitement et réécriture HTML et XML</li>
<li>Transformations XSLT et inclusions XML (XIncludes)</li>
<li>Support de l'espace de nommage XML</li>
<li>Gestion du chargement de fichier et décodage des formulaires HTML</li>
<li>Traitement d'image</li>
<li>Protection des applications vulnérables comme les scripts PHP</li>
<li>Edition de texte par Chercher/Remplacer</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="smart" id="smart">Filtrage intelligent</a></h2>
<p class="figure">
<img src="images/mod_filter_new.png" width="423" height="331" alt="Le filtrage intelligent applique différents fournisseurs de filtrage en fonction de l'état du traitement de la requête" />
</p>
<p><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>, inclus dans les version 2.1 et supérieures
d'Apache, permet de configurer la chaîne de filtrage dynamiquement
à l'exécution.
Ainsi par exemple, vous pouvez définir un proxy pour réécrire du code HTML
avec un filtre HTML et traiter des images JPEG avec un filtre totalement
séparé, bien que le proxy ne possède aucune information préliminaire
sur ce que le serveur à l'origine des données à filtrer va envoyer.
Ceci fonctionne grâce à l'utilisation d'un gestionnaire de filtre,
qui distribue les tâches à différents fournisseurs de filtrage en fonction
du contenu réel à filtrer à l'exécution. Tout filtre peut se voir soit
inséré directement dans la chaîne et lancé inconditionnellement, soit
utilisé comme un fournisseur de filtrage et inséré dynamiquement.
Par exemple,</p>
<ul>
<li>un filtre de traitement HTML sera lancé uniquement si le contenu est
de type text/html ou application/xhtml+xml</li>
<li>Un filtre de compression sera lancé uniquement si les données en entrée
sont de type compressible et non déjà compressées</li>
<li>Un filtre de conversion de jeux de caractères ne sera inséré que si
le document texte n'est pas déjà dans le jeu de caractères voulu</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="service" id="service">Présentation des filtres en tant que service HTTP</a></h2>
<p>Les filtres permettent de traiter les requêtes des clients avant
traitement par le serveur, ainsi que les contenus issus du serveur avant de les renvoyer
au client. Le module <code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code> permet aussi
d'utiliser les filtres pour traiter les requêtes des clients avant de
les renvoyer directement à ces derniers.</p>
<p>Le module <code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code> reçoit les requêtes POST des
clients, et en répercute le corps dans la requête POST constituant la
réponse, lors de l'envoi de cette dernière au client en passant à travers la
pile de filtres en sortie.</p>
<p>Cette technique peut être utilisée comme alternative à un service web
s'exécutant à l'intérieur de la pile d'un serveur d'applications, où un
filtre en sortie effectue la transformation requise sur le corps de la
requête. Par exemple, on peut utiliser le module
<code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> pour fournir un service général de
compression ; un filtre de transformation d'images peut aussi se voir
mué en service de transformation d'images.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="using" id="using">Utilisation des filtres</a></h2>
<p>Il y a deux manières d'utiliser le filtrage : Simple et Dynamique.
En général, vous utiliserez l'une ou l'autre méthode; le mélange des deux
peut avoir des conséquences inattendues (bien que le filtrage simple en entrée
puisse être associé sans problème avec le filtrage simple ou dynamique
en sortie).</p>
<p>La méthode Simple est la seule permettant de configurer les filtres
en entrée, et suffit pour les filtres en sortie pour lesquels vous avez besoin
d'une chaîne de filtres statique.
Les directives correspondantes sont
<code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code>,
<code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code>, et
<code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code>.</p>
<p>La méthode Dynamique permet une configuration dynamique des filtres en
sortie à la fois statique et flexible, comme discuté dans la page
<code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>.
Les directives correspondantes sont
<code class="directive"><a href="./mod/mod_filter.html#filterchain">FilterChain</a></code>,
<code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code>, et
<code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code>.</p>
<p>Une autre directive <code class="directive"><a href="./mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code> est encore supportée,
mais obsolète. Utilisez la
configuration dynamique à la place.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/filter.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/filter.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/filter.html" title="Français"> fr </a> |
<a href="./ja/filter.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/filter.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/filter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/filter.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/index.html.fr.utf8 0000664 0001751 0001751 00000022735 14740503670 020336 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Documentation du Serveur HTTP Apache Version 2.4
- Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="index-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></div>
<div class="up"><a href="http://httpd.apache.org/docs-project/"><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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a></div>
<div id="page-content"><h1>Documentation du Serveur HTTP Apache Version 2.4
</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<form method="get" action="https://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Recherche Google" type="submit" /><input value="10" name="num" type="hidden" /><input value="fr" name="hl" type="hidden" /><input value="UTF-8" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="Version 2.4" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value=""List-Post"" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form>
<table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">Notes de version</a></h2>
<ul><li><a href="new_features_2_4.html">Nouvelles fonctionnalités dApache 2.3/2.4</a></li>
<li><a href="new_features_2_2.html">Nouvelles fonctionnalités d'Apache 2.1/2.2</a></li>
<li><a href="new_features_2_0.html.fr">Nouvelles fonctionnalités d'Apache 2.0</a></li>
<li><a href="upgrading.html">Mise à jour de la version 2.2 vers la version 2.4</a></li>
<li><a href="license.html">Licence Apache</a></li>
</ul>
</div><div class="category"><h2><a name="manual" id="manual">Manuel de référence</a></h2>
<ul><li><a href="install.html">Compilation et installation</a></li>
<li><a href="invoking.html">Démarrage</a></li>
<li><a href="stopping.html">Arrêt ou redémarrage</a></li>
<li><a href="mod/quickreference.html">Directives de configuration à l'exécution</a></li>
<li><a href="mod/">Modules</a></li>
<li><a href="mpm.html">Modules multi-processus (MPMs)</a></li>
<li><a href="filter.html">Filtres</a></li>
<li><a href="handler.html">Gestionnaires</a></li>
<li><a href="expr.html">Interpréteur d'expressions</a></li>
<li><a href="mod/overrides.html">Index des directives disponibles dans les
fichiers .htaccess</a></li>
<li><a href="programs/">Le serveur et ses utilitaires</a></li>
<li><a href="glossary.html">Glossaire</a></li>
</ul>
</div></td><td><div class="category"><h2><a name="usersguide" id="usersguide">Guide de l'utilisateur</a></h2>
<ul><li><a href="getting-started.html">Bien démarrer</a></li>
<li><a href="bind.html">Ecoute sélective</a></li>
<li><a href="configuring.html">Fichiers de configuration</a></li>
<li><a href="sections.html">Sections de configuration</a></li>
<li><a href="caching.html">Mise en cache du contenu</a></li>
<li><a href="content-negotiation.html">Négociation sur le contenu</a></li>
<li><a href="dso.html">Objets Dynamiques Partagés (DSO)</a></li>
<li><a href="env.html">Variables d'environnement</a></li>
<li><a href="logs.html">Fichiers de traces</a></li>
<li><a href="urlmapping.html">Mise en correspondance des URLs avec le système de fichiers</a></li>
<li><a href="misc/perf-tuning.html">Optimisation des performances</a></li>
<li><a href="misc/security_tips.html">Conseils sur la sécurité</a></li>
<li><a href="server-wide.html">Configuration à l'échelle du serveur</a></li>
<li><a href="ssl/">Chiffrement SSL/TLS</a></li>
<li><a href="suexec.html">Exécution des CGI avec suexec</a></li>
<li><a href="rewrite/">Réécriture des URLs avec mod_rewrite</a></li>
<li><a href="vhosts/">Hôtes virtuels</a></li>
</ul>
</div></td><td class="col3"><div class="category"><h2><a name="howto" id="howto">Recettes / Tutoriels</a></h2>
<ul><li><a href="howto/auth.html">Authentification et autorisation</a></li>
<li><a href="howto/access.html">Contrôle d'accès</a></li>
<li><a href="howto/cgi.html">CGI: Contenu dynamique</a></li>
<li><a href="howto/htaccess.html">Fichiers .htaccess</a></li>
<li><a href="howto/ssi.html">Server Side Includes (SSI)</a></li>
<li><a href="howto/public_html.html">Répertoires Web des utilisateurs (public_html)</a></li>
<li><a href="howto/reverse_proxy.html">Guide de configuration des mandataires
inverses</a></li>
<li><a href="howto/http2.html">Guide HTTP/2</a></li>
</ul>
</div><div class="category"><h2><a name="platform" id="platform">Notes spécifiques aux différentes plateformes</a></h2>
<ul><li><a href="platform/windows.html">Microsoft Windows</a></li>
<li><a href="platform/rpm.html">Systèmes basés sur les paquet RPM (Redhat / CentOS / Fedora)</a></li>
<li><a href="platform/netware.html">Novell NetWare</a></li>
<li><a href="platform/ebcdic.html">Portage EBCDIC</a></li>
</ul>
</div><div class="category"><h2><a name="other" id="other">Autres sujets</a></h2>
<ul><li><a href="http://wiki.apache.org/httpd/FAQ">Foire Aux Questions</a></li>
<li><a href="sitemap.html">Plan du site</a></li>
<li><a href="developer/">Documentation du développeur</a></li>
<li><a href="http://httpd.apache.org/docs-project/">Aide pour la
documentation</a></li>
<li><a href="misc/">Autres notes</a></li>
<li><a href="http://wiki.apache.org/httpd/">Wiki</a></li>
</ul>
</div></td></tr></table></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/mpm.html.fr.utf8 0000664 0001751 0001751 00000034576 14740503670 020026 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Modules multi-processus (MPMs) - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Modules multi-processus (MPMs)</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Ce document décrit ce qu'est un Module Multi-Processus, ainsi
que la manière dont ces modules sont utilisés par le serveur HTTP Apache.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#defaults">MPM par défaut</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#static">Compiler un module MPM en tant que module
statique</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#dynamic">Compiler un module MPM en tant que module
DSO (Dynamic Shared Object)</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="introduction" id="introduction">Introduction</a></h2>
<p>La conception du serveur HTTP Apache en fait un serveur web puissant et
flexible pouvant fonctionner sur une très grande variété de
plateformes et toute une gamme d'environnements différents. Plateformes
différentes et environnements différents signifient souvent fonctionnalités
différentes, ou utilisation de différentes méthodes pour
implémenter la même fonctionnalité le plus efficacement possible.
Apache httpd s'est toujours accomodé d'une grande variété d'environnements
grâce à sa conception modulaire. Cette conception autorise le webmaster
à choisir quelles fonctionnalités seront incluses
dans le serveur en sélectionnant les modules à charger soit à la
compilation, soit à l'exécution.</p>
<p>Le serveur HTTP Apache 2.0 a étendu cette conception modulaire aux
fonctions les plus
élémentaires d'un serveur web. Le serveur est fourni avec une variété de
Modules Multi-Processus (MPMs) qui
sont responsables de l'association aux ports réseau de la machine,
acceptent les requêtes, et se chargent de répartir ces dernières
entre les différents processus enfants.</p>
<p>L'extension de la conception modulaire à ce niveau du serveur
comporte deux avantages importants :</p>
<ul>
<li>Apache httpd peut supporter plus proprement et efficacement une grande
variété de systèmes d'exploitation. En particulier, la version Windows
du serveur est maintenant beaucoup plus efficace, depuis que
<code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code> peut utiliser les fonctionnalités réseau
natives à la place de la couche POSIX utilisée par
Apache httpd 1.3. Cet avantage s'étend aussi aux systèmes d'exploitation
qui implémentent des MPMs spécialisés.</li>
<li>le serveur est plus à même de répondre aux besoins d'un site
particulier. Par exemple, les sites qui sont très sollicités peuvent
utiliser un MPM threadé comme
<code class="module"><a href="./mod/worker.html">worker</a></code> ou <code class="module"><a href="./mod/event.html">event</a></code>, tandis que les sites
qui privilégient la stabilité ou la compatibilité avec des logiciels
plus anciens peuvent utiliser un module comme
<code class="module"><a href="./mod/prefork.html">prefork</a></code>.</li>
</ul>
<p>Du point de vue de l'utilisateur, les MPMs ne sont pas différents des
autres modules Apache httpd. La principale différence réside dans le fait qu'un
et un seul MPM à la fois doit être chargé
lorsque le serveur s'exécute. La liste des
MPMs disponibles est fournie dans <a href="mod/">l'index des
modules</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="defaults" id="defaults">MPM par défaut</a></h2>
<p>La table suivante fournit la liste des MPMs par défaut pour divers
systèmes d'exploitation. Il s'agit du MPM qui sera utilisé si
vous n'en spécifiez pas un autre à la compilation.</p>
<table class="bordered"><tr><td>Netware</td><td><code class="module"><a href="./mod/mpm_netware.html">mpm_netware</a></code></td></tr>
<tr class="odd"><td>OS/2</td><td><code class="module"><a href="./mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
<tr><td>Unix</td><td><code class="module"><a href="./mod/prefork.html">prefork</a></code>, <code class="module"><a href="./mod/worker.html">worker</a></code>,
ou <code class="module"><a href="./mod/event.html">event</a></code>, selon les possibilités de la plate-forme</td></tr>
<tr class="odd"><td>Windows</td><td><code class="module"><a href="./mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
</table>
<div class="note"><p>Ici, 'Unix' sous-entend les systèmes d'exploitation de type
Unix, comme Linux, BSD, Solaris, Mac OS X, etc...</p></div>
<p>Dans le cas des systèmes d'exploitation de type Unix, le choix du MPM
à installer est orienté par deux questions :</p>
<p>1. Est-ce que le système supporte les threads ?</p>
<p>2. Est-ce que le système supporte le polling thread-safe (et en
particulier les fonctions kqueue et epoll) ?</p>
<p>Si la réponse aux deux questions est 'oui', le MPM par défaut sera
<code class="module"><a href="./mod/event.html">event</a></code>.</p>
<p>Si la réponse à la première question est 'oui', et la réponse à la
deuxième 'non', le MPM par défaut sera <code class="module"><a href="./mod/worker.html">worker</a></code>.</p>
<p>Si la réponse aux deux questions est 'non', le MPM par défaut sera
<code class="module"><a href="./mod/prefork.html">prefork</a></code>.</p>
<p>En pratique, cela signifie que le MPM par défaut sera presque
toujours <code class="module"><a href="./mod/event.html">event</a></code> car tous les systèmes d'exploitation
modernes satisfont aux deux conditions.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="static" id="static">Compiler un module MPM en tant que module
statique</a></h2>
<p>Les modules MPM peuvent être compilés en tant que modules
statiques sur toutes les plates-formes. A la compilation d'Apache, un
seul module MPM doit être choisi pour être compilé et lié avec le
serveur. La recompilation du serveur sera donc nécessaire si vous
souhaitez changer de module MPM.</p>
<p>Pour choisir un module MPM autre que le MPM par défaut,
utiliser l'argument
<code>--with-mpm=<em>NOM</em></code> du script
<code class="program"><a href="./programs/configure.html">configure</a></code>. <em>NOM</em> est le nom
du MPM désiré.</p>
<p>Une fois le serveur compilé, il est possible de savoir quel MPM
a été choisi à l'aide de la commande <code>./httpd -l</code>.
Cette commande fournit la liste de tous les modules compilés
avec le serveur, y compris le MPM.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="dynamic" id="dynamic">Compiler un module MPM en tant que module
DSO (Dynamic Shared Object)</a></h2>
<p>Sous Unix et les plates-formes similaires, les modules MPM
peuvent être compilés en tant que modules DSO et chargés
dynamiquement dans le serveur comme tout module DSO. Compiler les
modules MPM en tant que modules DSO permet de changer de MPM en
modifiant la directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> concernée, sans avoir à
recompiler le serveur.</p>
<pre class="prettyprint lang-config">LoadModule mpm_prefork_module modules/mod_mpm_prefork.so</pre>
<p>Toute tentative de charger plusieurs modules MPM via la directive
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> empêchera le
serveur de démarrer et affichera l'erreur suivante :</p>
<div class="example"><p><code>AH00534: httpd: Configuration error: More than one MPM
loaded.</code></p></div>
<p>Cette fonctionnalité est activée via l'option
<code>--enable-mpms-shared</code> du script
<code class="program"><a href="./programs/configure.html">configure</a></code>. Si on ajoute l'argument
<code><em>all</em></code>, tous les modules MPM disponibles sur la
plate-forme considérée seront installés. Cet argument peut aussi
contenir une liste de modules MPM à installer.</p>
<p>Le module MPM par défaut, sélectionné automatiquement ou spécifié
via l'option <code>--with-mpm</code> du script
<code class="program"><a href="./programs/configure.html">configure</a></code>, sera chargé via une directive
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> du fichier de
configuration du serveur généré. Pour choisir un autre module MPM,
vous devrez donc modifier cette directive</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./de/mpm.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/mpm.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/mpm.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/mpm.html" title="Français"> fr </a> |
<a href="./ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/mpm.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/mpm.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mpm.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sections.html.fr.utf8 0000664 0001751 0001751 00000123453 14740503670 021055 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Sections de configuration - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Sections de configuration</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/sections.html" title="Français"> fr </a> |
<a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Les directives des <a href="configuring.html">fichiers de configuration</a> peuvent s'appliquer
au serveur dans son ensemble, ou seulement à des répertoires, fichiers, hôtes,
ou URLs particuliers. Ce document décrit comment utiliser les conteneurs de
sections de configuration ou les fichiers <code>.htaccess</code> pour
modifier la portée des directives de configuration.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#types">Types de conteneurs de sections de
configuration</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#file-and-web">Système de fichiers,
arborescence du site web et expressions booléennes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Serveurs virtuels</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#proxy">Mandataire</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#whatwhere">Quelles sont les directives autorisées ?</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#merging">Comment les sections sont combinées entre elles</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="types" id="types">Types de conteneurs de sections de
configuration</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mod_version.html">mod_version</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#if"><If></a></code></li><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/mod_md.html#mdomainsetsection"><MDomainSet></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>Il existe deux grands types de conteneurs. La plupart des conteneurs sont
évalués pour chaque requête. Les directives qu'ils contiennent s'appliquent
seulement aux requêtes qui sont concernées par le conteneur. En revanche,
les conteneurs
<code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>, <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> et
<code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code> sont
évalués seulement au démarrage et au redémarrage du serveur.
Si leurs conditions sont vérifiées au démarrage, les directives qu'ils contiennent
s'appliqueront à toutes les requêtes. Si leurs conditions ne sont pas vérifiées, les
directives qu'ils contiennent seront ignorées.</p>
<p>Le conteneur <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>
contient des directives qui ne seront appliquées que si un paramètre
approprié a été défini dans la ligne de commande de <code class="program"><a href="./programs/httpd.html">httpd</a></code>.
Par exemple,
avec la configuration suivante, toutes les requêtes seront redirigées vers
un autre site si le serveur est démarré en utilisant la ligne de commande :
<code>httpd -DClosedForNow</code> :</p>
<pre class="prettyprint lang-config"><IfDefine ClosedForNow>
Redirect "/" "http://otherserver.example.com/"
</IfDefine></pre>
<p>Le conteneur <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>
est similaire ; les directives qu'il contient ne s'appliqueront que si
un module particulier est disponible au niveau du serveur.
Le module doit être soit compilé statiquement dans le serveur, soit
dynamiquement et dans ce cas, la ligne <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> correspondante doit apparaître
plus haut dans le fichier de configuration. Ce conteneur ne doit être
utilisé que dans le cas où votre fichier de configuration doit être valable
indépendamment de la présence ou de l'absence de certains modules.
Il ne doit pas contenir de directives que vous souhaitez voir s'appliquer
systématiquement, car vous pouvez perdre ainsi de précieux messages d'erreur
à propos de modules manquants.</p>
<p>Dans l'exemple suivant, la directive <code class="directive"><a href="./mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code> ne s'appliquera que si le
module <code class="module"><a href="./mod/mod_mime_magic.html">mod_mime_magic</a></code> est disponible.</p>
<pre class="prettyprint lang-config"><IfModule mod_mime_magic.c>
MimeMagicFile "conf/magic"
</IfModule></pre>
<p>Le conteneur
<code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
est similaire aux conteneurs <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> et <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> ; les directives qu'il contient ne
s'appliqueront que si une version particulière du serveur s'exécute. Ce
conteneur a été conçu pour une utilisation dans les suites de tests
et les grands réseaux qui doivent prendre en compte différentes versions
et configurations de httpd.</p>
<pre class="prettyprint lang-config"><IfVersion >= 2.4>
# les directives situées ici ne s'appliquent que si la version <br />
# est supérieure ou égale à 2.4.0.
</IfVersion></pre>
<p><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>,
<code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> et
<code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
peuvent inverser leur test conditionnel en le faisant précéder d'un « ! ».
De plus, ces sections peuvent être imbriquées afin de définir des restrictions
plus complexes.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="file-and-web" id="file-and-web">Système de fichiers,
arborescence du site web et expressions booléennes</a></h2>
<p>Les conteneurs de sections de configuration les plus couramment utilisés
sont ceux qui modifient la configuration de points particuliers du système de
fichiers ou de l'arborescence du site web. Tout d'abord, il est important de
comprendre la différence entre les deux. Le système de fichiers est une vue de
vos disques tels qu'ils sont perçus par votre système d'exploitation. Par
exemple, avec une installation par défaut, Apache httpd est situé dans
<code>/usr/local/apache2</code> pour le système de fichiers UNIX, ou
<code>"c:/Program Files/Apache Group/Apache2"</code> pour le système de
fichiers Windows (notez que des slashes directs doivent toujours être utilisés
comme séparateur de chemin dans les fichiers de configuration d'Apache httpd,
même sous Windows). Quant à l'arborescence du site web, il s'agit d'une vue de
votre site telle que présentée par le serveur web et perçue par le client.
Ainsi le chemin <code>/dir/</code> dans l'arborescence du site web correspond
au chemin <code>/usr/local/apache2/htdocs/dir/</code> dans le système de
fichiers pour une installation d'Apache httpd par défaut sous UNIX. En outre,
l'arborescence du site web n'a pas besoin de correspondre en permanence au
système de fichiers, car les pages web peuvent être générées dynamiquement à
partir de bases de données ou d'autres emplacements.</p>
<h3><a name="filesystem" id="filesystem">Conteneurs de système de fichiers</a></h3>
<p>Les conteneurs <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
et <code class="directive"><a href="./mod/core.html#files"><Files></a></code>,
ainsi que leurs équivalents acceptant les
<a class="glossarylink" href="./glossary.html#regex" title="voir glossaire">expressions rationnelles</a>,
appliquent des directives à certaines parties du système de fichiers.
Les directives contenues dans une section <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> s'appliquent au répertoire
précisé, ainsi qu'à tous ses sous-répertoires et aux fichiers que ces
derniers contiennent.
Le même effet peut être obtenu en utilisant les <a href="howto/htaccess.html">fichiers .htaccess</a>. Par exemple, avec la
configuration suivante, l'indexation sera activée pour le répertoire
<code>/var/web/dir1</code> et tous ses sous-répertoires.</p>
<pre class="prettyprint lang-config"><Directory "/var/web/dir1">
Options +Indexes
</Directory></pre>
<p>Les directives contenues dans une section <code class="directive"><a href="./mod/core.html#files"><Files></a></code> s'appliquent à tout fichier
avec le nom spécifié, quel que soit le répertoire dans lequel il se trouve.
Ainsi par exemple, les directives de configuration suivantes, si elles sont
placées dans la section principale du fichier de configuration, vont interdire
l'accès à tout fichier nommé <code>private.html</code> quel que soit
l'endroit où il se trouve.</p>
<pre class="prettyprint lang-config"><Files "private.html">
Require all denied
</Files></pre>
<p>Pour faire référence à des fichiers qui se trouvent en des points
particuliers du système de fichiers, les sections
<code class="directive"><a href="./mod/core.html#files"><Files></a></code> et
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
peuvent être combinées. Par exemple, la configuration suivante va interdire
l'accès à <code>/var/web/dir1/private.html</code>,
<code>/var/web/dir1/subdir2/private.html</code>,
<code>/var/web/dir1/subdir3/private.html</code>, ainsi que toute instance de
<code>private.html</code> qui se trouve dans l'arborescence
<code>/var/web/dir1/</code>.</p>
<pre class="prettyprint lang-config"><Directory "/var/web/dir1">
<Files "private.html">
Require all denied
</Files>
</Directory></pre>
<h3><a name="webspace" id="webspace">Conteneurs de l'arborescence du site web</a></h3>
<p>le conteneur <code class="directive"><a href="./mod/core.html#location"><Location></a></code>
et son équivalent acceptant les
<a class="glossarylink" href="./glossary.html#regex" title="voir glossaire">expressions rationnelles</a> modifient quant à eux la
configuration de parties de l'arborescence du site web. Par exemple, la
configuration suivante interdit l'accès à toute URL dont la partie chemin
commence par /private.
En particulier, l'interdiction s'appliquera aux requêtes pour :
<code>http://yoursite.example.com/private</code>,
<code>http://yoursite.example.com/private123</code>, et
<code>http://yoursite.example.com/private/dir/file.html</code> ainsi qu'à
toute requête commençant par la chaîne de caractères <code>/private</code>.</p>
<pre class="prettyprint lang-config"><LocationMatch "^/private">
Require all denied
</LocationMatch></pre>
<p>Le conteneur <code class="directive"><a href="./mod/core.html#location"><Location></a></code>
n'a pas besoin de faire référence à un élément du système de fichiers.
À ce titre, l'exemple suivant montre comment faire correspondre une URL
particulière à un gestionnaire interne du serveur HTTP Apache fourni par le module
<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>.
Il n'est pas nécessaire de trouver un fichier nommé <code>server-status</code>
dans le système de fichiers.</p>
<pre class="prettyprint lang-config"><Location "/server-status">
SetHandler server-status
</Location></pre>
<h3><a name="overlapping-webspace" id="overlapping-webspace">Espace web imbriqué</a></h3>
<p>Pour contrôler deux URLs imbriquées, on doit tenir compte de l'ordre
dans lequel certaines sections ou directives sont évaluées. Pour
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>, on doit
avoir :</p>
<pre class="prettyprint lang-config"><Location "/foo">
</Location>
<Location "/foo/bar">
</Location></pre>
<p>Les directives <code class="directive"><a href="./mod/mod_alias.html#alias"><Alias></a></code>, quant à elles, sont évaluées vice-versa :</p>
<pre class="prettyprint lang-config">Alias "/foo/bar" "/srv/www/uncommon/bar"
Alias "/foo" "/srv/www/common/foo"</pre>
<p>Ceci est aussi vrai pour les directives <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> :</p>
<pre class="prettyprint lang-config">ProxyPass "/special-area" "http://special.example.com" smax=5 max=10
ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofailover=On</pre>
<h3><a name="wildcards" id="wildcards">Caractères de remplacement
et expressions rationnelles</a></h3>
<p>Les conteneurs <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#files"><Files></a></code> et <code class="directive"><a href="./mod/core.html#location"><Location></a></code> peuvent utiliser des caractères de
remplacement de style shell comme dans la fonction <code>fnmatch</code> de la
bibliothèque C standard. Le caractère « * » correspond à toute séquence de
caractères, « ? » à un caractère seul, et « [<em>seq</em>] » à tout caractère
contenu dans <em>seq</em>. Le caractère « / » ne peut pas faire l'objet d'un
remplacement ; il doit être spécifié explicitement.</p>
<p>Si une définition des critères de correspondance encore plus souple est
nécessaire, chaque conteneur possède son équivalent acceptant les expressions
rationnelles : <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code> et <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> acceptent les <a class="glossarylink" href="./glossary.html#regex" title="voir glossaire">expressions rationnelles</a> compatibles Perl pour définir
les critères de correspondance. Mais voyez plus loin la section à propos de la
combinaison des sections de configuration pour comprendre comment l'utilisation
de conteneurs avec des expressions rationnelles va modifier la manière dont les
directives sont appliquées.</p>
<p>Un conteneur qui modifie la configuration de tous les répertoires
utilisateurs à l'aide de caractères de remplacement mais sans utiliser les
expressions rationnelles pourrait ressembler à ceci :</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html">
Options Indexes
</Directory></pre>
<p>Avec les conteneurs utilisant les expressions rationnelles,
on peut interdire l'accès à de nombreux types de fichiers d'images
simultanément :</p>
<pre class="prettyprint lang-config">+<FilesMatch "\.(?i:gif|jpe?g|png)$">
Require all denied
</FilesMatch></pre>
<p>Les expressions rationnelles contenant des <strong>groupes nommés et
des références arrières</strong> sont ajoutées à l'environnement avec
leur nom en majuscules. Cela permet de référencer des éléments de
chemins de fichiers et d'URLs depuis une <a href="expr.html">expression</a> et au sein de modules comme
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
<pre class="prettyprint lang-config"><DirectoryMatch "^/var/www/combined/(?<SITENAME>[^/]+)">
Require ldap-group "cn=%{env:MATCH_SITENAME},ou=combined,o=Example"
</DirectoryMatch></pre>
<h3><a name="expressions" id="expressions">Expressions booléennes</a></h3>
<p>La directive <code class="directive"><a href="./mod/core.html#if"><If></a></code>
permet de modifier la configuration en fonction d'une condition qui peut
être définie sous la forme d'une expression booléenne. Dans l'exemple
suivant, l'accès est interdit si l'en-tête HTTP Referer ne commence pas
par « http://www.example.com/ ».</p>
<pre class="prettyprint lang-config"><If "!(%{HTTP_REFERER} -strmatch 'http://www.example.com/*')">
Require all denied
</If></pre>
<h3><a name="whichwhen" id="whichwhen">Que faut-il utiliser et quand ?</a></h3>
<p>Choisir entre des conteneurs de système de fichiers et des conteneurs
d'arborescence du site web est vraiment très simple.
Pour appliquer des directives à des objets qui résident dans le système de
fichiers, utilisez toujours un conteneur <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> ou <code class="directive"><a href="./mod/core.html#files"><Files></a></code>. Pour appliquer des directives à des objets
qui ne résident pas dans le système de fichiers (comme une page web générée
par une base de données), utilisez un conteneur <code class="directive"><a href="./mod/core.html#location"><Location></a></code>.</p>
<p>Il ne faut jamais utiliser un conteneur <code class="directive"><a href="./mod/core.html#location"><Location></a></code> pour restreindre l'accès à des
objets du système de fichiers, car plusieurs emplacements de
l'arborescence du site web (URLs) peuvent correspondre au même emplacement
du système de fichier, ce qui peut permettre de contourner vos restrictions.
Par exemple, imaginez la configuration suivante :</p>
<pre class="prettyprint lang-config"><Location "/dir/">
Require all denied
</Location></pre>
<p>Elle fonctionne correctement si la requête appelle
<code>http://yoursite.example.com/dir/</code>. Mais que va-t-il se passer si
votre système de fichiers est insensible à la casse ? Votre restriction va
pouvoir être tout simplement contournée en envoyant une requête sur
<code>http://yoursite.example.com/DIR/</code>. Le conteneur <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, quant à lui, s'appliquera à
tout contenu servi à partir de cet emplacement, sans tenir compte de la manière
dont il est appelé. Les liens du système de fichiers constituent une exception.
Le même répertoire peut être placé dans plusieurs parties du système de fichiers
en utilisant des liens symboliques. Le conteneur <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> va suivre le lien symbolique sans modifier
le nom du chemin. Par conséquent, pour plus de sécurité, les liens symboliques
doivent être désactivés à l'aide de la directive <code class="directive"><a href="./mod/core.html#options">Options</a></code> appropriée.</p>
<p>Si vous pensez que vous n'êtes pas concerné par ce problème
parce que vous utilisez un système de fichiers sensible à la casse,
gardez à l'esprit qu'il y a de nombreuses autres manières pour faire
correspondre plusieurs emplacements de l'arborescence du site web au même
emplacement du système de fichiers. C'est pourquoi vous devez autant que
possible toujours utiliser les conteneurs de système de fichiers.
Il y a cependant une exception à cette règle. Placer des restrictions de
configuration dans un conteneur <code><Location
"/"></code> est absolument sans rique car ce conteneur va s'appliquer à
toutes les requêtes sans tenir compte de l'URL spécifique.</p>
<h3><a name="nesting" id="nesting">Imbrication des sections</a></h3>
<p>Certains types de sections peuvent être imbriqués : d'une part, on peut
utiliser les sections <code class="directive"><a href="./mod/core.html#files"><Files></a></code>
à l'intérieur des sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, d'autre part, on peut utiliser les
directives <code class="directive"><a href="./mod/core.html#if"><If></a></code> à l'intérieur
des sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code> et <code class="directive"><a href="./mod/core.html#files"><Files></a></code> (mais pas à l'intérieur d'une
autre section <code class="directive"><a href="./mod/core.html#if"><If></a></code>). Les
valeurs des expressions rationnelles correspondant aux sections citées se
comportent de manière identique.</p>
<p>Les sections imbriquées sont fusionnées après les sections
non-imbriquées de même type.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">Serveurs virtuels</a></h2>
<p>Le conteneur <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
contient des directives qui s'appliquent à des serveurs virtuels spécifiques.
Cela s'avère utile pour servir les contenus de plusieurs serveurs virtuels à
partir de la même machine, chacun d'entre eux possédant une configuration
différente. Pour de plus amples informations, voir la <a href="vhosts/">Documentation sur les serveurs virtuels</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Mandataire</a></h2>
<p>Les conteneurs
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
et <code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>
appliquent les directives de configuration qu'ils contiennent uniquement aux
sites qui correspondent à l'URL spécifiée et auxquels on a
accédé à l'aide du serveur mandataire du module <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>.
Par exemple, la configuration suivante n'autorisera qu'un sous-ensemble de
clients à accéder au site <code>www.example.com</code> en passant par le serveur
mandataire :</p>
<pre class="prettyprint lang-config"><Proxy "http://www.example.com/*">
Require host yournetwork.example.com
</Proxy></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="whatwhere" id="whatwhere">Quelles sont les directives autorisées ?</a></h2>
<p>Pour déterminer quelles sont les directives autorisées pour tel type de
section de configuration, vérifiez le <a href="mod/directive-dict.html#Context">Contexte</a> de la directive.
Tout ce qui est autorisé dans les sections
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
l'est aussi d'un point de vue syntaxique dans les sections
<code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>,
<code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>,
<code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>,
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
et <code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>.
Il y a cependant quelques exceptions :</p>
<ul>
<li>La directive <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
ne fonctionne que dans les sections
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>.</li>
<li>Les <code class="directive"><a href="./mod/core.html#options">Options</a></code> <code>FollowSymLinks</code> et
<code>SymLinksIfOwnerMatch</code> ne fonctionnent que dans les sections
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> ou les fichiers
<code>.htaccess</code>.</li>
<li>La directive <code class="directive"><a href="./mod/core.html#options">Options</a></code> ne peut pas être
utilisée dans les sections
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>
et <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></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="merging" id="merging">Comment les sections sont combinées entre elles</a></h2>
<p>Les sections de configuration sont appliquées dans un ordre très particulier.
Il est important de savoir comment cet ordre est défini car il peut avoir
des effets importants sur la manière dont les directives de configuration
sont interprétées.</p>
<p>L'ordre dans lequel les sections sont appliquées est :</p>
<ol>
<li> Les sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> (à l'exception des expressions
rationnelles) et les fichiers <code>.htaccess</code> sont appliquées
simultanément (avec la possibilité pour <code>.htaccess</code>, s'il y est
autorisé, de prévaloir sur <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>)</li>
<li>Les sections <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code> (et <code><Directory
"~"></code>)</li>
<li>Les sections <code class="directive"><a href="./mod/core.html#files"><Files></a></code>
et <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code> sont
appliquées simultanément</li>
<li>Les sections <code class="directive"><a href="./mod/core.html#location"><Location></a></code> et <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> sont appliquées simultanément</li>
<li>Les sections <code class="directive"><a href="./mod/core.html#if"><If></a></code>,
même si elles sont incluses dans un des contextes précédents. </li>
</ol>
<p>Quelques remarques importantes :</p>
<ul>
<li>Mises à part les sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, dans chaque groupe, les sections sont
traitées selon
l'ordre dans lequel elles apparaissent dans les fichiers de configuration.
Par exemple, une requête pour <em>/foo/bar</em> correspondra à
<code><Location "/foo/bar"></code> et <code><Location
"/foo"></code> (dans ce cas le groupe 4) : les deux sections seront
évaluées mais selon l'ordre dans lequel elles apparaissent dans le fichier
de configuration.</li>
<li>Les sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> (groupe 1 ci-dessus)
sont traitées dans l'ordre du répertoire le plus court vers le plus long.
Par exemple, <code><Directory "/var/web/dir"></code> sera
traitée avant <code><Directory
"/var/web/dir/subdir"></code>.</li>
<li>Si plusieurs sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> s'appliquent au même
répertoire, elles sont traitées selon l'ordre dans lequel elles
apparaissent dans le fichier de configuration.</li>
<li>Les sections de configuration incluses à l'aide de la directive <code class="directive"><a href="./mod/core.html#include">Include</a></code> sont traitées comme si elles se
trouvaient réellement dans le fichier qui les inclut à la position de la
directive
<code class="directive"><a href="./mod/core.html#include">Include</a></code>.</li>
<li>Les sections situées à l'intérieur de sections <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
sont appliquées <em>après</em> les sections correspondantes situées en
dehors de la définition du serveur virtuel, ce qui permet au serveur virtuel
de prévaloir sur la configuration du serveur global.</li>
<li>Quand la requête est servie par le module <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>,
le conteneur <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
prend la place du conteneur <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> dans l'ordre de traitement.</li>
<li>Il faut être très prudent lorsqu'on mélange des directives de
configuration similaires à l'intérieur et à l'extérieur d'une section
<code class="directive"><a href="./mod/core.html#if"><If></a></code> car leur ordre
d'apparition a de l'importance. A cet effet, l'utilisation explicite de la
directive <code class="directive"><a href="./mod/core.html#else"><Else></a></code>
peut vous y aider.
</li>
<li>Lorsqu'une section <code class="directive"><a href="./mod/core.html#if"><If></a></code> est utilisée dans un fichier <code>.htaccess</code>, les
directives incluses dans un répertoire parent seront fusionnées
<em>après</em> les directives non-incluses dans un sous-répertoire.
</li>
</ul>
<div class="note"><h3>Note technique</h3>
Une séquence <code><Location></code>/<code><LocationMatch></code>
est réellement traitée juste avant la phase de traduction du nom
(où <code>Aliases</code> et <code>DocumentRoots</code>
sont utilisés pour faire correspondre les URLs aux noms de fichiers).
Les effets de cette séquence disparaissent totalement lorsque
la traduction est terminée.
</div>
<h3><a name="relationship-module-configuration" id="relationship-module-configuration">Interactions entre
modules et sections de configuration</a></h3>
<p>Une question se pose souvent après avoir lu comment les sections de
configuration sont fusionnées : comment et quand les directives de modules
particuliers comme <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> sont-elles interprétées ? La
réponse n'est pas triviale et nécessite un approfondissement. Chaque module
httpd gère sa propre configuration, et chacune de ses directives dans
httpd.conf définit un élément de configuration dans un contexte particulier.
httpd n'exécute pas une commande au moment où elle est lue.</p>
<p>A l'exécution, le noyau de httpd parcourt les sections de configuration
dans l'ordre décrit ci-dessus afin de déterminer lesquelles s'appliquent à
la requête actuelle. Lorsqu'une première section s'applique, elle est
considérée comme la configuration actuelle pour cette requête. Si une
section suivante s'applique aussi, chaque module qui possède des directives
dans chacune de ces sections a la possibilité de fusionner sa configuration
entre ces deux sections. Il en résulte une troisième configuration et le
processus de fusion se poursuit jusqu'à ce que toutes les sections de
configuration aient été évaluées.</p>
<p>Après l'étape précédente, le traitement proprement dit de la requête HTTP
peut commencer : chaque module peut effectuer toute tâche qui lui incombe,
et pour déterminer de quelle manière il doit agir, il peut s'appuyer
sur le noyau de httpd pour retrouver sa configuration globale issue de la
fusion précédente.</p>
<p>Un exemple permet de mieux visualiser l'ensemble du processus. La
configuration suivante utilise la directive <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code> du module
<code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> pour définir un en-tête HTTP spécifique. Quelle
valeur httpd va-t-il affecter à l'en-tête <code>CustomHeaderName</code> pour
une requête vers <code>/example/index.html</code> ?
</p>
<pre class="prettyprint lang-config"><Directory "/">
Header set CustomHeaderName one
<FilesMatch ".*">
Header set CustomHeaderName three
</FilesMatch>
</Directory>
<Directory "/example">
Header set CustomHeaderName two
</Directory></pre>
<ul>
<li><code class="directive">Directory</code> "/" s'applique, et une configuration
initiale est créée qui définit l'en-tête <code>CustomHeaderName</code>
avec la valeur <code>one</code>.</li>
<li><code class="directive">Directory</code> "/example" s'applique, et comme
<code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> spécifie dans son code que
la valeur d'un en-tête doit être écrasée si ce dernier est défini à
nouveau, une nouvelle configuration est créée qui définit l'en-tête
<code>CustomHeaderName</code> avec la valeur <code>two</code>.</li>
<li><code class="directive">FilesMatch</code> ".*" s'applique, une nouvelle
opportunité de fusion survient, et l'en-tête <code>CustomHeaderName</code>
est défini à la valeur <code>three</code>.</li>
<li>Finalement, au cours des étapes suivantes du traitement de la
requête HTTP, <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> sera sollicité, et il se
basera sur la configuration qui a défini l'en-tête
<code>CustomHeaderName</code> à la valeur <code>three</code>.
<code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> utilise normalement cette configuration pour
accomplir sa tâche, à savoir définir des en-têtes HTTP. Cela ne veut
cependant pas dire qu'un module ne peut pas effectuer des actions plus
complexes comme désactiver des directives car elle ne sont pas
nécessaires ou obsolètes, etc.</li>
</ul>
<p>Ceci est aussi vrai pour les fichiers .htaccess car ils possèdent la même
priorité que les sections <code class="directive">Directory</code> dans l'ordre de
fusion. Il faut bien comprendre que les sections de configuration comme
<code class="directive">Directory</code> et <code class="directive">FilesMatch</code> ne
sont pas comparables avec les directives spécifiques de modules comme
<code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code> ou <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> car elles agissent à des
niveaux différents.
</p>
<h3><a name="merge-examples" id="merge-examples">Quelques exemples utiles</a></h3>
<p>Voici un exemple imaginaire qui montre l'ordre de combinaison des sections.
En supposant qu'elles s'appliquent toutes à la requête, les directives de
cet exemple seront appliquées dans l'ordre suivant : A > B > C > D >
E.</p>
<pre class="prettyprint lang-config"><Location "/">
E
</Location>
<Files "f.html">
D
</Files>
<VirtualHost *>
<Directory "/a/b">
B
</Directory>
</VirtualHost>
<DirectoryMatch "^.*b$">
C
</DirectoryMatch>
<Directory "/a/b">
A
</Directory></pre>
<p>Pour un exemple plus concret, considérez ce qui suit. Sans tenir compte
d'une quelconque restriction d'accès placée dans les sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, la section <code class="directive"><a href="./mod/core.html#location"><Location></a></code> sera
évaluée en dernier et permettra un accès au serveur sans aucune restriction.
En d'autres termes, l'ordre de la combinaison des sections est important ;
soyez donc prudent !</p>
<pre class="prettyprint lang-config"><Location "/">
Require all granted
</Location>
# Grrrr ! Cette section <Directory> n'aura aucun effet
<Directory "/">
<RequireAll>
Require all granted
Require not host badguy.example.com
</RequireAll>
</Directory></pre>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/sections.html" title="Français"> fr </a> |
<a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sections.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_4.html.fr.utf8 0000664 0001751 0001751 00000077162 14740503670 022366 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Vue d'ensemble des nouvelles fonctionnalités de la version 2.4 du
serveur HTTP Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Vue d'ensemble des nouvelles fonctionnalités de la version 2.4 du
serveur HTTP Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/new_features_2_4.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_4.html" title="Français"> fr </a> |
<a href="./tr/new_features_2_4.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document décrit les modifications majeures apportées par
la version 2.4 du serveur HTTP Apache. Pour les nouvelles fonctionnalités
ajoutées par la version 2.2, se référer au document
<a href="new_features_2_2.html">Nouvelles fonctionnalités
de la version 2.2</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Améliorations du noyau</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#newmods">Nouveau modules</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Améliorations des modules</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Améliorations des programmes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#documentation">Documentation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Modifications concernant les développeur de modules</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="core" id="core">Améliorations du noyau</a></h2>
<dl>
<dt>Modules multiprocessus (MPMs) chargeables à l'exécution</dt>
<dd>Plusieurs MPMs peuvent maintenant être <a href="mpm.html#dynamic">compilés en tant que modules
chargeables</a>. Le choix du MPM à utiliser s'effectue
à l'exécution via la directive <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>.</dd>
<dt>MPM Event</dt>
<dd>Le <a href="mod/event.html">MPM Event</a> n'en est plus au stade expérimental et est
maintenant pleinement supporté.</dd>
<dt>Support du mode asynchrone</dt>
<dd>Le support des lectures/écritures asynchrones pour les MPMs et
les plateformes qui l'implémentent a été amélioré.</dd>
<dt>Configuration du niveau de journalisation (LogLevel) par
module et par répertoire</dt>
<dd>La directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code>
peut maintenant être définie par module et par répertoire. Les
nouveaux niveaux <code>trace1</code> à <code>trace8</code> ont été
ajoutés au dessus du niveau de journalisation <code>debug</code>.</dd>
<dt>Sections de configuration au niveau requête</dt>
<dd>Les sections <code class="directive"><a href="./mod/core.html#if">If</a></code>,
<code class="directive"><a href="./mod/core.html#elseif"><ElseIf></a></code> et
<code class="directive"><a href="./mod/core.html#else"><Else></a></code>
permettent de définir une configuration en fonction de critères
liés à la requête.</dd>
<dt>Interpréteur d'expressions à usage général</dt>
<dd>Un nouvel interpréteur d'expressions permet de spécifier des
<a href="expr.html">conditions complexes</a> via des directives à
syntaxe commune comme <code class="directive"><a href="./mod/mod_setenvif.html#setenvifexpr">SetEnvIfExpr</a></code>, <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>, <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>,
<code class="directive"><a href="./mod/core.html#if"><If></a></code>, etc...
</dd>
<dt>KeepAliveTimeout en millisecondes</dt>
<dd>Il est maintenant possible de définir la directive <code class="directive"><a href="./mod/core.html#keepalivetimeout">KeepAliveTimeout</a></code> en millisecondes.
</dd>
<dt>Directive NameVirtualHost</dt>
<dd>Cette directive n'est plus nécessaire et est maintenant obsolète.</dd>
<dt>Directives autorisées dans les fichiers <code>.htaccess</code></dt>
<dd>La nouvelle directive <code class="directive"><a href="./mod/core.html#allowoverridelist">AllowOverrideList</a></code> permet de contrôler de
manière plus précise la liste des directives autorisées dans les
fichiers <code>.htaccess</code>.</dd>
<dt>Variables dans les fichiers de configuration</dt>
<dd>La directive <code class="directive"><a href="./mod/core.html#define">Define</a></code>
permet de définir des variables dans les fichiers de
configuration, améliorant ainsi la clareté de la présentation si
la même valeur est utilisée en plusieurs points de la
configuration.
</dd>
<dt>Diminution de la mémoire utilisée</dt>
<dd>Bien qu'elle propose de nombreuses nouvelles fonctionnalités,
la version 2.4.x tend à utiliser moins de mémoire que la version
2.2.x.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="newmods" id="newmods">Nouveau modules</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></dt>
<dd>Mise à disposition du protocole FastCGI pour
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code></dt>
<dd>Mise à disposition du protocole SCGI pour
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_express.html">mod_proxy_express</a></code></dt>
<dd>Ajoute à <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> la configuration dynamique
de mandataires inverses en masse.</dd>
<dt><code class="module"><a href="./mod/mod_remoteip.html">mod_remoteip</a></code></dt>
<dd>Remplace l'adresse IP distante et le nom d'hôte apparents du
client pour la requête courante par la liste d'adresses IP
présentée par un mandataire ou un répartiteur de charge via les
en-têtes de la requête.</dd>
<dt><code class="module"><a href="./mod/mod_heartmonitor.html">mod_heartmonitor</a></code>,
<code class="module"><a href="./mod/mod_lbmethod_heartbeat.html">mod_lbmethod_heartbeat</a></code></dt>
<dd>Permet à <code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> de répartir la
charge en fonction du nombre de connexions actives sur les
serveurs d'arrière-plan.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_html.html">mod_proxy_html</a></code></dt>
<dd>Anciennement module tiers, il supporte la correction des liens
HTML dans une situation de mandat inverse, où le serveur
d'arrière-plan génère des URLs qui ne sont pas valides du point de
vue des clients du mandataire.</dd>
<dt><code class="module"><a href="./mod/mod_sed.html">mod_sed</a></code></dt>
<dd>Une amélioration de <code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code> qui permet
d'éditer le corps de la réponse avec toute la puissance de la
commande sed.</dd>
<dt><code class="module"><a href="./mod/mod_auth_form.html">mod_auth_form</a></code></dt>
<dd>Implémente une authentification à base de formulaire.</dd>
<dt><code class="module"><a href="./mod/mod_session.html">mod_session</a></code></dt>
<dd>Permet de conserver les données de sessions des clients sous
forme de cookies ou dans une base de données.</dd>
<dt><code class="module"><a href="./mod/mod_allowmethods.html">mod_allowmethods</a></code></dt>
<dd>Permet de restreindre l'utilisation de
certaines méthodes HTTP sans interférer avec l'authentification et
l'autorisation.</dd>
<dt><code class="module"><a href="./mod/mod_lua.html">mod_lua</a></code></dt>
<dd>Embarque le langage <a href="http://www.lua.org/">Lua</a> dans
httpd pour la configuration et les fonctions logiques courantes
(Expérimental).</dd>
<dt><code class="module"><a href="./mod/mod_log_debug.html">mod_log_debug</a></code></dt>
<dd>Permet d'introduire une journalisation personnalisée à
différentes phases du traitement de la requête.</dd>
<dt><code class="module"><a href="./mod/mod_buffer.html">mod_buffer</a></code></dt>
<dd>Fournit un tampon pour les piles des filtres en entrée et en
sortie.</dd>
<dt><code class="module"><a href="./mod/mod_data.html">mod_data</a></code></dt>
<dd>Convertit un corps de réponse en URL de type données RFC2397.</dd>
<dt><code class="module"><a href="./mod/mod_ratelimit.html">mod_ratelimit</a></code></dt>
<dd>Permet de limiter la bande passante pour certains
clients.</dd>
<dt><code class="module"><a href="./mod/mod_request.html">mod_request</a></code></dt>
<dd>Fournit des filtres permettant de gérer et de mettre à
disposition les corps des requêtes HTTP.</dd>
<dt><code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code></dt>
<dd>Permet de renvoyer comme réponse le corps de la requête via la
pile du filtre de sortie.</dd>
<dt><code class="module"><a href="./mod/mod_slotmem_shm.html">mod_slotmem_shm</a></code></dt>
<dd>Met à disposition un fournisseur de mémoire partagée à base de
slots (du style tableau de bord).</dd>
<dt><code class="module"><a href="./mod/mod_xml2enc.html">mod_xml2enc</a></code></dt>
<dd>Anciennement module tiers, il supporte l'internationalisation
dans les modules de filtrage basés sur libxml2 (support du
markup)</dd>
<dt><code class="module"><a href="./mod/mod_macro.html">mod_macro</a></code> (disponible à partir de la version 2.4.5)</dt>
<dd>Permet d'utiliser des macros au sein des fichiers de
configuration.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_wstunnel.html">mod_proxy_wstunnel</a></code> (disponible à partir de la version 2.4.5)</dt>
<dd>Support des tunnels web-socket.</dd>
<dt><code class="module"><a href="./mod/mod_authnz_fcgi.html">mod_authnz_fcgi</a></code> (disponible à partir de la version 2.4.10)</dt>
<dd>Permet aux applications d'autorisation FastCGI d'authentifier
et/ou autoriser les clients.</dd>
<dt><code class="module"><a href="./mod/mod_http2.html">mod_http2</a></code> (disponible à partir de la version 2.4.17)</dt>
<dd>Support de la couche transport HTTP/2.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_http2.html">mod_proxy_http2</a></code> (disponible à partir de la version 2.4.19)</dt>
<dd>Support du protocole HTTP/2 pour <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dd>
<dt><code class="module"><a href="./mod/mod_proxy_hcheck.html">mod_proxy_hcheck</a></code> (disponible à partir de la version 2.4.21)</dt>
<dd>Support d'un bilan de santé dynamique indépendant pour les serveurs
d'arrière-plan mandatés distants.</dd>
<dt><code class="module"><a href="./mod/mod_brotli.html">mod_brotli</a></code> (disponible à partir de la version 2.4.26)</dt>
<dd>Support de l'algorithme de compression Brotli.</dd>
<dt><code class="module"><a href="./mod/mod_md.html">mod_md</a></code> (disponible à partir de la version 2.4.30)</dt>
<dd>Automatisation de l'obtention de certificats via le protocole ACME.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_uwsgi.html">mod_proxy_uwsgi</a></code> (disponible à partir de la version 2.4.30)</dt>
<dd>module passerelle UWSGI pour <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>.</dd>
<dt><code class="module"><a href="./mod/mod_socache_redis.html">mod_socache_redis</a></code> (disponible à partir de la version 2.4.39)</dt>
<dd>Supporte le fournisseur de cache d'objets partagés basé sur <a href="http://redis.io/">Redis</a>.</dd>
<dt><code class="module"><a href="./mod/mod_systemd.html">mod_systemd</a></code> (disponible à partir de la version 2.4.42)</dt>
<dd>intégration de systemd. Permet d'utiliser httpd en tant que service avec
le paramètre systemd <code>Type=notify</code>.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Améliorations des modules</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> peut maintenant vérifier la
validité des certificats clients en se connectant à
un serveur OCSP. Il est possible de définir un
répondeur par défaut, et de choisir si l'on
préfère le répondeur désigné
dans le certificat client.</dd>
<dd>En outre, <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> supporte maintenant
l'estampillage OCSP (OCSP stapling), qui permet au serveur
d'attester la validité de son certificat auprès du client au
cours de la phase de négociation de la connexion.</dd>
<dd>Enfin, <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> peut maintenant être configuré pour
que celui-ci partage les données de session SSL entre les serveurs
via memcached.</dd>
<dd>Le support des clés EC a été ajouté à celui des clés RSA et
DSA.</dd>
<dd>Support de TLS-SRP (disponible à partir de la version 2.4.4).</dd>
<dt><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dt>
<dd>La directive <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> est maintenant configurée
de manière optimale dans les sections <code class="directive"><a href="./mod/core.html#location">Location</a></code> ou <code class="directive"><a href="./mod/core.html#locationmatch">LocationMatch</a></code>, et offre un gain de
performances important par rapport à la syntaxe traditionnelle à
deux paramètres lorsqu'elle est présente en grand nombre.</dd>
<dd>Il est maintenant possible de configurer l'adresse source dans
les requêtes mandatées.</dd>
<dd>Support des sockets de type Unix vers le serveur
d'arrière-plan (disponible à partir de la version 2.4.7).</dd>
<dt><code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></dt>
<dd>Le gestionnaire de répartition de charge propose de nouvelles
fonctionnalités. Ainsi, les possibilités de configuration des
membres du groupe de répartition de charge pendant l'exécution ont
été améliorées (possibilité d'ajout d'un membre supplémentaire).</dd>
<dd>Configuration à l'exécution d'un sous-ensemble de paramètres
de répartition de charge.</dd>
<dd>Les membres du groupe de répartition peuvent être définis à
'Drain' de façon à ce qu'ils ne répondent qu'aux sessions
persistantes existantes, ce qui permet de les mettre hors ligne en
douceur.</dd>
<dd>Les règlages du répartiteur de charge peuvent être rendus
persistants après redémarrage.</dd>
<dt><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></dt>
<dd>Le filtre CACHE du module <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> peut être
inséré à un certain point de la chaîne de filtrage pour contrôler
plus finement la mise en cache.
</dd>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> peut maintenant mettre en cache des
requêtes HEAD.</dd>
<dd>Chaque fois que cela est possible, les directives de
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> peuvent maintenant être définies au
niveau du répertoire, et non plus seulement au niveau du serveur
principal.</dd>
<dd>L'URL de base des URLs en cache peut être personnalisée de
façon à ce qu'un cluster de caches puisse partager le même préfixe
d'URL.</dd>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> peut maintenant servir du contenu
non mis à jour lorsqu'un serveur d'arrière-plan n'est pas
disponible (erreur 5xx).</dd>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> peut maintenant insérer
HIT/MISS/REVALIDATE dans un en-tête X-Cache.</dd>
<dt><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dt>
<dd>Support de l'attribut 'onerror' dans un élément 'include',
permettant de renvoyer un message d'erreur personnalisé à la place
du message d'erreur par défaut.</dd>
<dt><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>, <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>,
<code class="module"><a href="./mod/mod_isapi.html">mod_isapi</a></code>, ...</dt>
<dd>La traduction des en-têtes en variables d'environnement est
plus stricte qu'avant, ce qui permet de diminuer l'exposition aux attaques
de type cross-site-scripting via injection d'en-têtes. Les noms
d'en-têtes contenant des caractères invalides (comme les caractères
de soulignement) ne sont plus convertis en variables d'environnement. Le document <a href="env.html">Les variables d'environnement dans Apache</a>
présente quelques pistes pour contourner ce problème avec les
clients anciens qui nécessitent de tels en-têtes (Ceci affecte
tous les modules qui utilisent ces variables d'environnement).</dd>
<dt><code class="module"><a href="./mod/mod_authz_core.html">mod_authz_core</a></code> Conteneurs de logique d'autorisation</dt>
<dd>La directive <code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code> et les directives de
conteneurs associées, comme <code class="directive"><a href="./mod/mod_authz_core.html#requireall"><RequireAll></a></code>, permettent de définir une
logique d'autorisation avancée.</dd>
<dt><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></dt>
<dd>La directive <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> dispose maintenant
des drapeaux <code>[QSD]</code> (Query String Discard) et
<code>[END]</code> qui permettent de simplifier les scénarios de
réécriture courants.</dd>
<dd>Possibilité d'utiliser des expressions booléennes complexes
dans la directive <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>.</dd>
<dd>Possibilité d'utiliser des requêtes SQL en tant que fonctions
dans la directive <code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</dd>
<dt><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>, <code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></dt>
<dd><code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> ajoute le support des
groupes imbriqués.</dd>
<dd><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code> apporte les directives <code class="directive"><a href="./mod/mod_ldap.html#ldapconnectionpoolttl">LDAPConnectionPoolTTL</a></code> et <code class="directive"><a href="./mod/mod_ldap.html#ldaptimeout">LDAPTimeout</a></code>, ainsi que d'autres
améliorations dans le traitement des délais. Ceci s'avère utile
pour les configurations où un pare-feu à mémoire d'état (stateful)
rejète les connexions inactives vers le serveur LDAP.</dd>
<dd><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code> propose la directive <code class="directive"><a href="./mod/mod_ldap.html#ldaplibrarydebug">LDAPLibraryDebug</a></code> qui permet de
journaliser les informations de débogage fournies par la boîte à
outils LDAP utilisée.</dd>
<dt><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></dt>
<dd><code class="module"><a href="./mod/mod_info.html">mod_info</a></code> est maintenant capable d'afficher la
configuration préinterprétée sur stdout au cours du démarrage du
serveur.</dd>
<dt><code class="module"><a href="./mod/mod_auth_basic.html">mod_auth_basic</a></code></dt>
<dd>Nouveau mécanisme générique permettant d'effectuer une
authentification basique (disponible à partir de la version 2.4.5).</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="programs" id="programs">Améliorations des programmes</a></h2>
<dl>
<dt><code class="program"><a href="./programs/fcgistarter.html">fcgistarter</a></code></dt>
<dd>Nouvel utilitaire pour le démarrage des démons
FastCGI.</dd>
<dt><code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code></dt>
<dd>Les URLs présentes dans le cache peuvent maintenant être
affichées, accompagnées éventuellement de leurs métadonnées.</dd>
<dd>Possibilité de supprimer explicitement des URLs individuelles
présentes dans le cache.</dd>
<dd>Les tailles de fichiers peuvent maintenant être arrondies au
multiple de la taille de bloc donnée, les limites de taille
collant de ce fait d'avantage à la taille réelle sur disque.</dd>
<dd>La taille du cache peut maintenant être limitée par le
nombre d'inodes, en plus de la possibilité de limitation par la
taille des fichiers.</dd>
<dt><code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code></dt>
<dd>Possibilité de créer un lien vers le fichier journal
courant.</dd>
<dd>Possibilité d'invoquer un script personnalisé après la
rotation.</dd>
<dt><code class="program"><a href="./programs/htpasswd.html">htpasswd</a></code>, <code class="program"><a href="./programs/htdbm.html">htdbm</a></code></dt>
<dd>Support de l'algorithme bcrypt (disponible à partir de la
version 2.4.4).
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="documentation" id="documentation">Documentation</a></h2>
<dl>
<dt>mod_rewrite</dt>
<dd>La documentation du module <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> a
été réorganisée et presque entièrement réécrite en mettant
l'accent sur les exemples et l'utilisation courante, ainsi que
sur l'incitation à utiliser d'autres solutions lorsque cela
s'avère plus approprié. Le document <a href="rewrite/">Rewrite
Guide</a> constitue maintenant une section de premier niveau ;
il est mieux organisé et contient beaucoup plus de détails.</dd>
<dt>mod_ssl</dt>
<dd>La documentation du module <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> a été
grandement améliorée, avec plus d'exemples et un niveau "Bien
démarrer" qui s'ajoutent aux détails techniques déjà présents
dans la précédente documentation.</dd>
<dt>Caching Guide</dt>
<dd>Le <a href="caching.html">Guide de la mise en cache</a> a
été réécrit afin de bien faire la différence entre les
fonctionnalités de mise en cache de la RFC2616 HTTP/1.1 fournies
par le module <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>, et la mise en cache
générique de type clé/valeur fournie par l'interface <a href="socache.html">socache</a>, mais aussi pour couvrir la mise
en cache spécialisée fournie par des mécanismes tels que ceux du
module <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code>.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="developer" id="developer">Modifications concernant les développeur de modules</a></h2>
<dl>
<dt>Ajout de code pour la vérification de la configuration</dt>
<dd>Une nouvelle fonction, <code>check_config</code>, a été ajoutée et
s'exécute entre les fonctions <code>pre_config</code> et
<code>open_logs</code>. Elle s'exécute aussi avant la fonction
<code>test_config</code> si l'option <code>-t</code> est passée au
démon <code class="program"><a href="./programs/httpd.html">httpd</a></code>. La fonction <code>check_config</code>
permet aux modules de vérifier l'interdépendance des valeurs des
directives de configuration et d'ajuster ces valeurs, alors que les
messages du serveur peuvent encore être affichés sur la console.
L'utilisateur est ainsi averti des erreurs de configuration avant que la
fonction du noyau <code>open_logs</code> ne redirige les sorties de la
console vers le journal des erreurs.</dd>
<dt>Ajout d'un analyseur syntaxique d'expressions</dt>
<dd>Nous disposons à présent d'un analyseur générique d'expressions, dont l'API
est décrite dans <var>ap_expr.h</var>. Il s'agit d'une adaptation de
l'analyseur qu'on trouvait auparavant dans <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>.</dd>
<dt>Conteneurs de logique d'autorisation</dt>
<dd>Afin de fournir une logique d'autorisation avancée via des
directives telles que <code class="directive"><a href="./mod/mod_authz_core.html#requireall"><RequireAll></a></code>, les modules d'autorisation
s'enregistrent maintenant en tant
que fournisseur par le biais de ap_register_auth_provider().</dd>
<dt>Interface de mise en cache des petits objets</dt>
<dd>Le fichier d'en-têtes <var>ap_socache.h</var> fournit une
interface à base de fournisseur pour la mise en cache des petits
objets de données, en s'inspirant de
l'implémentation précédente
du cache de session par <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>. Sont supportés
actuellement : les fournisseurs utilisant un tampon cyclique en
mémoire partagée, les fichiers dbm sur disque, et les caches
distribués de type memcache.</dd>
<dt>Ajout du point d'ancrage Cache Status</dt>
<dd>Le module <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> inclut maintenant un
nouveau point d'ancrage, <code>cache_status</code>, qui est appelé
lorsque la décision à propos de la mise en cache est connue. Il en
existe une implémentation par défaut qui ajoute les en-têtes
optionnels <code>X-Cache</code> et <code>X-Cache-Detail</code> à
la réponse.</dd>
</dl>
<p>La documentation du développeur contient une <a href="developer/new_api_2_4.html">liste détaillée des modifications
de l'API</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/new_features_2_4.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_4.html" title="Français"> fr </a> |
<a href="./tr/new_features_2_4.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_4.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/socache.html.fr.utf8 0000664 0001751 0001751 00000024357 14740503670 020636 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Le cache des objets partagés du serveur HTTP Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Le cache des objets partagés du serveur HTTP Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/socache.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/socache.html" title="Français"> fr </a></p>
</div>
<p>Le cache des objets partagés est un concept de partage de données
de base entre tous les processus d'un serveur, sans se préoccuper du
<a href="mpm.html">modèle de threads et de processus</a>. On
l'utilise lorsque les avantages apportés par le partage de données
entre processus contrebalance la perte de performances consécutive à
la communication interprocessus.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="providers" id="providers">Fournisseurs du cache d'objets partagés</a></h2>
<p>Le cache d'objets partagés en tant que tel est une abstraction.
Il est implémenté par cinq modules différents. Pour pouvoir
utiliser le cache, un ou plusieurs de ces modules doivent être
présents et configurés.</p>
<p>Le seul élément de configuration consiste à définir le
fournisseur de cache à utiliser. Ceci est de la responsabilité des
modules qui utilisent le cache, et pour cela, ils activent la
sélection via des directives telles que <code class="directive"><a href="./mod/mod_cache_socache.html#cachesocache">CacheSocache</a></code>, <code class="directive"><a href="./mod/mod_authn_socache.html#authncachesocache">AuthnCacheSOCache</a></code>, <code class="directive"><a href="./mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code>, et <code class="directive"><a href="./mod/mod_ssl.html#sslstaplingcache">SSLStaplingCache</a></code>.</p>
<p>Les fournisseurs actuellement disponibles sont :</p>
<dl>
<dt>"dbm" (<code class="module"><a href="./mod/mod_socache_dbm.html">mod_socache_dbm</a></code>)</dt>
<dd>Celui-ci utilise un fichier de hashage DBM. Le choix de la
DBM sous-jacente peut être configurable si la version
d'APR installée supporte de multiples implémentations de DBM.</dd>
<dt>"dc" (<code class="module"><a href="./mod/mod_socache_dc.html">mod_socache_dc</a></code>)</dt>
<dd>Celui-ci utilise les bibliothèques de mise en cache de sessions
distribuées <a href="http://distcache.sourceforge.net/">distcache</a>.</dd>
<dt>"memcache" (<code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code>)</dt>
<dd>Celui-ci utilise le système à hautes performances de mise en
cache d'objets de mémoire distribuée <a href="http://memcached.org/">memcached</a>.</dd>
<dt>"redis" (<code class="module"><a href="./mod/mod_socache_redis.html">mod_socache_redis</a></code>)</dt>
<dd>Celui-ci utilise le système de mise en cache d'objets de mémoire
distribuée à hautes performances <a href="http://redis.io/">Redis</a>.</dd>
<dt>"shmcb" (<code class="module"><a href="./mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code>)</dt>
<dd>Celui-ci utilise un tampon cyclique à hautes performances au
sein d'un segment de mémoire partagée.</dd>
</dl>
<p>L'API fournit les fonctions suivantes :</p>
<dl>
<dt>const char *create(ap_socache_instance_t **instance, const char *arg,
apr_pool_t *tmp, apr_pool_t *p);</dt>
<dd>Cette fonction permet de créer un cache de session basé sur
la chaîne de configuration spécifiée. Le pointeur d'instance
renvoyé dans le paramètre instance sera passé comme premier
argument des invocations subséquentes.</dd>
<dt>apr_status_t init(ap_socache_instance_t *instance, const char *cname,
const struct ap_socache_hints *hints,
server_rec *s, apr_pool_t *pool)</dt>
<dd>Cette fonction permet d'initialiser le cache. L'argument cname
doit avoir une longueur maximale de 16 caractères et permet
d'identifier de manière unique l'utilisateur du cache au sein du
serveur ; il est recommandé d'utiliser le nom du module, par
exemple "mod_ssl-sess". Comme cette chaîne peut être utilisée au
sein d'un système de fichiers, il est conseillé de n'utiliser que
des caractères alphanumériques [a-z0-9_-]. Si l'argument hints
n'est pas égal à NULL, il fournit un ensemble d'indications au
fournisseur. La valeur retournée est le code d'erreur APR.</dd>
<dt>void destroy(ap_socache_instance_t *instance, server_rec *s)</dt>
<dd>Cette fonction permet de détruire l'instance de cache
spécifiée.</dd>
<dt>apr_status_t store(ap_socache_instance_t *instance, server_rec *s,
const unsigned char *id, unsigned int idlen,
apr_time_t expiry,
unsigned char *data, unsigned int datalen,
apr_pool_t *pool)</dt>
<dd>Cette fonction permet de stocker un objet dans une instance de
cache.</dd>
<dt>apr_status_t retrieve(ap_socache_instance_t *instance, server_rec *s,
const unsigned char *id, unsigned int idlen,
unsigned char *data, unsigned int *datalen,
apr_pool_t *pool)</dt>
<dd>Cette fonction permet d'extraire un objet du cache.</dd>
<dt>apr_status_t remove(ap_socache_instance_t *instance, server_rec *s,
const unsigned char *id, unsigned int idlen,
apr_pool_t *pool)</dt>
<dd>Supprime un objet du cache.</dd>
<dt>void status(ap_socache_instance_t *instance, request_rec *r, int flags)</dt>
<dd>Renvoie le statut d'une instance de cache à destination de mod_status.</dd>
<dt>apr_status_t iterate(ap_socache_instance_t *instance, server_rec *s,
void *userctx, ap_socache_iterator_t *iterator,
apr_pool_t *pool)</dt>
<dd>Envoie tous les objets gardés en cache à une fonction pour traitement itératif.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/socache.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/socache.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/socache.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/urlmapping.html.fr.utf8 0000664 0001751 0001751 00000070620 14740503670 021401 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title> Mise en correspondance des URLs avec le système de fichiers - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1> Mise en correspondance des URLs avec le système de fichiers</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/urlmapping.html" title="Français"> fr </a> |
<a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document explique comment le serveur HTTP Apache utilise l'URL contenue dans une
requête pour déterminer le noeud du système de fichier à partir duquel le
fichier devra être servi.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#related">Modules et directives concernés</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#documentroot">Racine des documents (DocumentRoot)</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#outside">Fichiers situés en dehors de
l'arborescence DocumentRoot</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#user">Répertoires des utilisateurs</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#redirect">Redirection d'URL</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#proxy">Mandataire inverse (Reverse Proxy)</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rewrite">Moteur de réécriture</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#notfound">Fichier non trouvé (File Not Found)</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">Autres modules de mise en correspondance des
URLs</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="related" id="related">Modules et directives concernés</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</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_alias.html">mod_alias</a></code></li><li><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code></li><li><code class="module"><a href="./mod/mod_dir.html">mod_dir</a></code></li><li><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</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_proxy.html">mod_proxy</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code></li><li><code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code></li><li><code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_speling.html#checkspelling">CheckSpelling</a></code></li><li><code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="documentroot" id="documentroot">Racine des documents (DocumentRoot)</a></h2>
<p>La méthode par défaut de httpd pour déterminer quel fichier servir pour
une requête donnée, consiste à extraire le chemin du fichier de la requête
(la partie de l'URL qui suit le nom d'hôte et le port), puis de l'ajouter
à la fin de la valeur de la directive
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> définie dans vos fichiers
de configuration.
Ainsi, les fichiers et répertoires
situés en dessous de <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
constituent l'arborescence de base des documents qui seront visibles
depuis le web.</p>
<p>Par exemple, si la directive
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> contient
<code>/var/www/html</code>, une requête pour
<code>http://www.example.com/fish/guppies.html</code> retournera le
fichier <code>/var/www/html/fish/guppies.html</code> au client.</p>
<p>Si la requête concerne un répertoire (autrement dit un chemin se
terminant par un slash <code>/</code>), le nom du fichier qui sera
recherché et servi depuis ce répertoire est défini via la directive
<code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>. Par exemple,
supposons que <code>DocumentRoot</code> ait été définie comme
précédemment, et que vous ayez défini <code>DirectoryIndex</code>
comme suit :</p>
<div class="example"><p><code>DirectoryIndex index.html index.php</code></p></div>
<p>Si httpd reçoit alors une requête pour
<code>http://www.example.com/fish/</code>, il tentera de servir le
fichier <code>/var/www/html/fish/index.html</code>. Si ce fichier
n'existe pas, il tentera de servir le fichier
<code>/var/www/html/fish/index.php</code>.</p>
<p>Si aucun de ces fichiers existe, httpd tentera de générer et
d'afficher un index du répertoire, à condition que
<code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code> ait été chargé et configuré pour le
permettre.</p>
<p>httpd supporte aussi les <a href="vhosts/">Hôtes virtuels</a>,
ce qui lui permet de traiter des requêtes pour plusieurs hôtes.
Dans ce cas, un <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
différent peut être défini pour chaque hôte virtuel;
les directives fournies par le module
<code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code> peuvent aussi être utilisées afin de
déterminer dynamiquement le noeud approprié du système de fichiers
à partir duquel servir un contenu en fonction de l'adresse IP
ou du nom d'hôte.</p>
<p>La directive <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> est
définie dans le fichier de configuration de votre serveur principal
(<code>httpd.conf</code>), mais peut aussi être redéfinie pour chaque
<a href="vhosts/">Hôte virtuel</a> supplémentaire que vous avez créé.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="outside" id="outside">Fichiers situés en dehors de
l'arborescence DocumentRoot</a></h2>
<p>Il existe de nombreuses circonstances pour lesquelles il est nécessaire
d'autoriser l'accès web à des portions du système de fichiers qui ne se
trouvent pas dans l'arborescence <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>. httpd propose de nombreuses
solutions pour réaliser cela. Sur les systèmes Unix, les liens
symboliques permettent de rattacher d'autres portions du système de
fichiers au <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>. Pour des raisons de sécurité,
httpd ne suivra les liens symboliques que si les <code class="directive"><a href="./mod/core.html#options">Options</a></code> pour le répertoire concerné contiennent
<code>FollowSymLinks</code> ou <code>SymLinksIfOwnerMatch</code>.</p>
<p>Une autre méthode consiste à utiliser la directive <code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code> pour rattacher toute portion
du système de fichiers à l'arborescence du site web. Par exemple, avec</p>
<pre class="prettyprint lang-config">Alias "/docs" "/var/web"</pre>
<p>l'URL <code>http://www.example.com/docs/dir/file.html</code>
correspondra au fichier <code>/var/web/dir/file.html</code>. La
directive
<code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
fonctionne de la même manière, excepté que tout contenu localisé dans le
chemin cible sera traité comme un script <a class="glossarylink" href="./glossary.html#cgi" title="voir glossaire">CGI</a>.</p>
<p>Pour les situations qui nécessitent plus de flexibilité, vous disposez
des directives <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code>
et <code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code>
qui permettent des substitutions et comparaisons puissantes basées
sur les <a class="glossarylink" href="./glossary.html#regex" title="voir glossaire">expressions rationnelles</a>.
Par exemple,</p>
<pre class="prettyprint lang-config">ScriptAliasMatch "^/~([a-zA-Z0-9]+)/cgi-bin/(.+)" "/home/$1/cgi-bin/$2"</pre>
<p>fera correspondre une requête du style
<code>http://example.com/~user/cgi-bin/script.cgi</code> au chemin
<code>/home/user/cgi-bin/script.cgi</code>, et traitera le fichier résultant
comme un script CGI.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="user" id="user">Répertoires des utilisateurs</a></h2>
<p>Sur les systèmes Unix, on peut traditionnellement faire référence
au répertoire personnel d'un <em>utilisateur</em> particulier à l'aide de
l'expression <code>~user/</code>.
Le module <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>
étend cette idée au web en autorisant l'accès aux fichiers situés dans les
répertoires home des utilisateurs à l'aide d'URLs
comme dans ce qui suit :</p>
<div class="example"><p><code>http://www.example.com/~user/file.html</code></p></div>
<p>Pour des raisons de sécurité, il est déconseillé de permettre un accès
direct à un répertoire home d'utilisateur depuis le web. A cet effet, la
directive <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code>
spécifie un répertoire où sont situés les fichiers accessibles depuis le web
dans le répertoire home de l'utilisateur.
Avec la configuration par défaut
<code>Userdir public_html</code>, l'URL ci-dessus correspondra à un fichier
dont le chemin sera du style
<code>/home/user/public_html/file.html</code> où
<code>/home/user/</code> est le répertoire home de l'utilisateur tel qu'il
est défini dans <code>/etc/passwd</code>.</p>
<p>La directive <code>Userdir</code> met à votre disposition de nombreuses
formes différentes pour les systèmes où <code>/etc/passwd</code> ne
spécifie pas la localisation du répertoire home.</p>
<p>Certains jugent le symbole "~" (dont le code sur le web est souvent
<code>%7e</code>) inapproprié et préfèrent utiliser une chaîne de
caractères différente pour représenter les répertoires utilisateurs.
mod_userdir ne supporte pas cette fonctionnalité. Cependant, si les
répertoires home des utilisateurs sont structurés de manière rationnelle,
il est possible d'utiliser la directive
<code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code>
pour obtenir l'effet désiré. Par exemple, pour faire correspondre
<code>http://www.example.com/upages/user/file.html</code> à
<code>/home/user/public_html/file.html</code>, utilisez la directive
<code>AliasMatch</code> suivante :</p>
<pre class="prettyprint lang-config">AliasMatch "^/upages/([a-zA-Z0-9]+)(/(.*))?$" "/home/$1/public_html/$3"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirect" id="redirect">Redirection d'URL</a></h2>
<p>Les directives de configuration décrites dans les sections précédentes
demandent à httpd d'extraire un contenu depuis un emplacement spécifique
du système de fichiers
et de la retourner au client. Il est cependant parfois
souhaitable d'informer le
client que le contenu demandé est localisé à une URL différente, et de
demander au client d'élaborer une nouvelle requête avec la nouvelle URL.
Ce processus se nomme <em>redirection</em> et est implémenté par la
directive <code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code>.
Par exemple, si le contenu du répertoire <code>/foo/</code> sous
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> est déplacé vers le
nouveau répertoire <code>/bar/</code>, vous pouvez demander aux clients
de le requérir à sa nouvelle localisation comme suit :</p>
<pre class="prettyprint lang-config">Redirect permanent "/foo/" "http://www.example.com/bar/"</pre>
<p>Ceci aura pour effet de rediriger tout chemin d'URL commençant par
<code>/foo/</code> vers le même chemin d'URL sur le serveur
<code>www.example.com</code> en remplaçant <code>/foo/</code> par
<code>/bar/</code>. Vous pouvez rediriger les clients non seulement sur le
serveur d'origine, mais aussi vers n'importe quel autre serveur.</p>
<p>httpd propose aussi la directive <code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> pour traiter les problèmes
de réécriture d'une plus grande complexité. Par exemple, afin de rediriger
les requêtes pour la page d'accueil du site vers un site différent, mais
laisser toutes les autres requêtes inchangées, utilisez la
configuration suivante :</p>
<pre class="prettyprint lang-config">RedirectMatch permanent "^/$" "http://www.example.com/startpage.html"</pre>
<p>De même, pour rediriger temporairement toutes les pages d'un site
vers une page particulière d'un autre site, utilisez ce qui suit :</p>
<pre class="prettyprint lang-config">RedirectMatch temp ".*" "http://othersite.example.com/startpage.html"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Mandataire inverse (Reverse Proxy)</a></h2>
<p>httpd vous permet aussi de rapatrier des documents distants
dans l'espace des URL du serveur local.
Cette technique est appelée <em>mandataire inverse ou reverse
proxying</em> car le serveur web agit comme un serveur mandataire en
rapatriant les documents depuis un serveur distant puis les renvoyant
au client. Ceci diffère d'un service de mandataire usuel (direct) car, pour le client,
les documents semblent appartenir au serveur mandataire inverse.</p>
<p>Dans l'exemple suivant, quand les clients demandent des documents situés
dans le répertoire
<code>/foo/</code>, le serveur rapatrie ces documents depuis le répertoire
<code>/bar/</code> sur <code>internal.example.com</code>
et les renvoie au client comme s'ils appartenaient au serveur local.</p>
<pre class="prettyprint lang-config">ProxyPass "/foo/" "http://internal.example.com/bar/"
ProxyPassReverse "/foo/" "http://internal.example.com/bar/"
ProxyPassReverseCookieDomain internal.example.com public.example.com
ProxyPassReverseCookiePath "/foo/" "/bar/"</pre>
<p>La directive <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> configure
le serveur pour rapatrier les documents appropriés, alors que la directive
<code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code>
réécrit les redirections provenant de
<code>internal.example.com</code> de telle manière qu'elles ciblent le
répertoire approprié sur le serveur local. De manière similaire, les directives
<code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code>
et <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code>
réécrivent les cookies élaborés par le serveur d'arrière-plan.</p>
<p>Il est important de noter cependant, que les liens situés dans les documents
ne seront pas réécrits. Ainsi, tout lien absolu sur
<code>internal.example.com</code> fera décrocher le client
du serveur mandataire et effectuer sa requête directement sur
<code>internal.example.com</code>. Vous pouvez modifier ces liens (et
d'utres contenus) situés dans la page au moment où elle est envoyée au
client en utilisant le module <code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code>.</p>
<pre class="prettyprint lang-config">Substitute "s/internal\.example\.com/www.example.com/i"</pre>
<p>Le module <code class="module"><a href="./mod/mod_proxy_html.html">mod_proxy_html</a></code> rend possible une réécriture plus
élaborée des liens en HTML et XHTML. Il permet de créer des listes
d'URLs et de leurs réécritures, de façon à pouvoir gérer des scénarios
de réécriture complexes.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">Moteur de réécriture</a></h2>
<p>Le moteur de réécriture <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> peut s'avérer
utile lorsqu'une substitution plus puissante est nécessaire.
Les directives fournies par ce module peuvent utiliser des caractéristiques de la
requête comme le type de navigateur ou l'adresse IP source afin de décider
depuis où servir le contenu. En outre, mod_rewrite peut utiliser des
fichiers ou programmes de bases de données externes pour déterminer comment
traiter une requête. Le moteur de réécriture peut effectuer les trois types
de mise en correspondance discutés plus haut :
redirections internes (aliases), redirections externes, et services mandataires.
De nombreux exemples pratiques utilisant mod_rewrite sont discutés dans la
<a href="rewrite/">documentation détaillée de mod_rewrite</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="notfound" id="notfound">Fichier non trouvé (File Not Found)</a></h2>
<p>Inévitablement, apparaîtront des URLs qui ne correspondront à aucun
fichier du système de fichiers.
Ceci peut arriver pour de nombreuses raisons.
Il peut s'agir du déplacement de documents d'une
localisation vers une autre. Dans ce cas, le mieux est d'utiliser la
<a href="#redirect">redirection d'URL</a> pour informer les clients de la
nouvelle localisation de la ressource. De cette façon, vous êtes sur que
les anciens signets et liens continueront de fonctionner, même si la
ressource est déplacée.</p>
<p>Une autre cause fréquente d'erreurs "File Not Found" est l'erreur de
frappe accidentelle dans les URLs, soit directement dans le navigateur,
soit dans les liens HTML. httpd propose le module
<code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> (sic) pour tenter de résoudre ce problème.
Lorsque ce module est activé, il intercepte les erreurs
"File Not Found" et recherche une ressource possédant un nom de fichier
similaire. Si un tel fichier est trouvé, mod_speling va envoyer une
redirection HTTP au client pour lui communiquer l'URL correcte.
Si plusieurs fichiers proches sont trouvés, une liste des alternatives
possibles sera présentée au client.</p>
<p>mod_speling possède une fonctionnalité particulièrement utile :
il compare les noms de fichiers sans tenir compte de la casse.
Ceci peut aider les systèmes où les utilisateurs ne connaissent pas la
sensibilité des URLs à la casse et bien sûr les systèmes de fichiers unix.
Mais l'utilisation de mod_speling pour toute autre chose que la correction
occasionnelle d'URLs peut augmenter la charge du serveur, car chaque
requête "incorrecte" entraîne une redirection d'URL et une nouvelle requête
de la part du client.</p>
<p><code class="module"><a href="./mod/mod_dir.html">mod_dir</a></code> fournit la directive <code class="directive"><a href="./mod/mod_dir.html#fallbackresource">FallbackResource</a></code> qui permet d'associer
des URIs virtuels à une ressource réelle qui peut ainsi les servir.
Cette directive remplace avantageusement
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> lors de l'implémentation d'un
"contrôleur frontal".</p>
<p>Si toutes les tentatives pour localiser le contenu
échouent, httpd
retourne une page d'erreur avec le code de statut HTTP 404
(file not found). L'apparence de cette page est contrôlée à l'aide de la
directive <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
et peut être personnalisée de manière très flexible comme discuté dans le
document
<a href="custom-error.html">Réponses personnalisées aux erreurs</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Autres modules de mise en correspondance des
URLs</a></h2>
<p>Les autres modules disponibles pour la mise en correspondance des
URLs sont :</p>
<ul>
<li><code class="module"><a href="./mod/mod_actions.html">mod_actions</a></code> - Met une URL en correspondance
avec un script CGI en fonction de la méthode de la requête, ou du
type MIME de la ressource.</li>
<li><code class="module"><a href="./mod/mod_dir.html">mod_dir</a></code> - Permet une mise en correspondance
basique d'un slash terminal dans un fichier index comme
<code>index.html</code>.</li>
<li><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code> - Met en correspondance une
requête avec une URL en fonction de la zone d'une image intégrée à
un document HTML dans laquelle un utilisateur clique.</li>
<li><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> - Sélectionne le document
approprié en fonction de préférences du client telles que la langue
ou la compression du contenu.</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/urlmapping.html" title="Français"> fr </a> |
<a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/urlmapping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_2.html.fr.utf8 0000664 0001751 0001751 00000051360 14740503670 022354 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Aperçu des nouvelles fonctionnalités de la version
2.2 du serveur HTTP Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Aperçu des nouvelles fonctionnalités de la version
2.2 du serveur HTTP Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/new_features_2_2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_2.html" title="Français"> fr </a> |
<a href="./ko/new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_2.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document décrit quelques uns des changements principaux entre
les versions 2.0 et 2.2 du serveur HTTP Apache. Pour les
nouvelles fonctionnalités ajoutées depuis la version 1.3, se
référer au document
<a href="new_features_2_0.html">2.0 new features</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Améliorations du système de base</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Améliorations des modules</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Améliorations des programmes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Changements pour le développeur de module</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="core" id="core">Améliorations du système de base</a></h2>
<dl>
<dt>Authn/Authz</dt>
<dd>Les modules d'authentification et d'autorisation intégrés
ont été refondus. Le nouveau module
mod_authn_alias (supprimé dans la version 2.3/2.4) permet de
simplifier considérablement certaines configurations d'authentification.
Voir <a href="#module">modification des noms de modules</a>,
et
<a href="#developer">les changements pour le développeur</a>
pour plus d'informations sur les conséquences de ces
changements pour les utilisateurs et les développeurs de
modules.</dd>
<dt>Mise en cache</dt>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>, <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>, et
mod_mem_cache (supprimés dans la version 2.3/2.4) ont subi de nombreuses
modifications, et l'on considère qu'ils ont maintenant atteint
un degré de qualité suffisant pour leur mise en production. Le programme
<code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code> a été ajouté afin de rendre
plus propre la configuration du module
<code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>.</dd>
<dt>Configuration</dt>
<dd>L'agencement de la configuration par défaut a été simplifié
et modularisé. Les portions de configuration qui peuvent être
utilisées pour activer des fonctionnalités courantes sont
maintenant intégrées à Apache, et peuvent être facilement
ajoutées à la configuration principale du serveur.</dd>
<dt>Arrêt en douceur</dt>
<dd>Les modules MPM <code class="module"><a href="./mod/prefork.html">prefork</a></code>,
<code class="module"><a href="./mod/worker.html">worker</a></code> et <code class="module"><a href="./mod/event.html">event</a></code> permettent
maintenant l'arrêt en douceur de <code class="program"><a href="./programs/httpd.html">httpd</a></code>
au moyen du signal
<a href="stopping.html#gracefulstop"><code>graceful-stop</code></a>.
La directive <code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> a été ajoutée dans le but
de spécifier un délai optionnel, après lequel
<code class="program"><a href="./programs/httpd.html">httpd</a></code> s'arrêtera quel que soit le statut
des requêtes en cours.</dd>
<dt>Mise en oeuvre du proxy</dt>
<dd>Le nouveau module <code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> fournit
des services de répartition de charge (load balancing) pour le
module <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>.
Le nouveau module <code class="module"><a href="./mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code> ajoute le
support pour le
<code>Protocole JServ de Apache version 1.3</code> qu'utilise
<a href="http://tomcat.apache.org/">Apache Tomcat</a>.</dd>
<dt>Mise à jour de la bibliothèque des expressions rationnelles</dt>
<dd>La version 5.0 de la
<a href="http://www.pcre.org/">Perl Compatible Regular Expression
Library</a> (PCRE) est maintenant disponible.
<code class="program"><a href="./programs/httpd.html">httpd</a></code> peut être configuré pour utiliser une
PCRE choisie en passant l'option <code>--with-pcre</code> au
script configure.</dd>
<dt>Filtrage intelligent</dt>
<dd>Le module <code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> permet la configuration
dynamique de la chaîne de filtrage en sortie. Il permet
d'insérer des filtres conditionnels basés sur toute
requête, en-tête de réponse ou variable
d'environnement, et fait table rase des problèmes de dépendances
et d'ordonnancement rencontrés avec l'architecture 2.0.</dd>
<dt>Support des gros fichiers</dt>
<dd><code class="program"><a href="./programs/httpd.html">httpd</a></code> supporte maintenant les fichiers d'une taille supérieure
à 2GB sur les systèmes 32 bits UNIX modernes. Le support des
corps de requête d'une taille supérieure à 2GB a aussi été
ajouté.</dd>
<dt>Module MPM Event</dt>
<dd>Le module MPM <code class="module"><a href="./mod/event.html">event</a></code> utilise un thread séparé
pour gérer les requêtes "Keep alive" et accepter des connexions.
Les requêtes "Keep alive" requéraient traditionnellement un
processus httpd dédié pour leur gestion. Ce processus dédié
ne pouvait plus être réutilisé jusqu'à ce que le délai "Keep Alive"
soit écoulé.</dd>
<dt>Support des bases de données SQL</dt>
<dd>Le module <code class="module"><a href="./mod/mod_dbd.html">mod_dbd</a></code>, associé à l'environnement
<code>apr_dbd</code>, fournit le support SQL direct aux modules
qui en ont besoin. Supporte la mise en commun des connexions
dans les modules MPM threadés.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Améliorations des modules</a></h2>
<dl>
<dt>Authn/Authz</dt>
<dd>Les modules du répertoire aaa ont été renommés et fournissent
un support amélioré pour la méthode d'authentification <strong>digest</strong>. Par exemple, <code>mod_auth</code>
est maintenant scindé en deux modules : <code class="module"><a href="./mod/mod_auth_basic.html">mod_auth_basic</a></code> et
<code class="module"><a href="./mod/mod_authn_file.html">mod_authn_file</a></code>; <code>mod_auth_dbm</code> s'appelle maintenant
<code class="module"><a href="./mod/mod_authn_dbm.html">mod_authn_dbm</a></code>; <code>mod_access</code> a été renommé en
<code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>. Est également apparu le nouveau module
mod_authn_alias (supprimé dans la version 2.3/2.4) qui simplifie
certaines configurations d'authentification.
</dd>
<dt><code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></dt>
<dd>Ce module est un portage de la version 2.0 du module
<code>mod_auth_ldap</code> vers la version 2.2 du framework
<code>Authn/Authz</code>.
Les nouvelles fonctionnalités comprennent l'utilisation des valeurs
d'attributs LDAP et des filtres de recherche avancés dans la
directive <code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code>.</dd>
<dt><code class="module"><a href="./mod/mod_authz_owner.html">mod_authz_owner</a></code></dt>
<dd>Un nouveau module qui autorise l'accès à un fichier
en fonction de son propriétaire dans le système de
fichiers</dd>
<dt><code class="module"><a href="./mod/mod_version.html">mod_version</a></code></dt>
<dd>Un nouveau module qui permet d'activer des blocs de
configuration en fonction de la version du serveur en cours
d'exécution.</dd>
<dt><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></dt>
<dd>Un nouvel argument <code>?config</code> a été ajouté, qui permettra d'afficher
les directives de configuration telles qu'elles sont interprétées
par Apache, y compris le nom de fichier et le numéro de ligne.
Le module montre aussi l'ordre des points d'entrée de traitement d'une
requête (request hooks) ainsi que des informations de construction
supplémentaires, d'une manière similaire à <code>httpd -V</code>.</dd>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>Le support de la <a href="http://www.ietf.org/rfc/rfc2817.txt">RFC 2817</a> a été ajouté, ce qui permet de passer d'une
connexion en clair au chiffrement TLS.</dd>
<dt><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code></dt>
<dd><code>mod_imap</code> a été renommé en <code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code> afin
d'éviter une confusion pour les utilisateurs.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="programs" id="programs">Améliorations des programmes</a></h2>
<dl>
<dt><code class="program"><a href="./programs/httpd.html">httpd</a></code></dt>
<dd>Une nouvelle option de ligne de commande <code>-M</code>
a été ajoutée, qui fournit la liste de tous les modules chargés
en fonction de la configuration réelle. À la différence de l'option
<code>-l</code>, cette liste inclut les Objets Dynamiques Partagés
(DSOs) chargés par l'intermédiaire du module
<code class="module"><a href="./mod/mod_so.html">mod_so</a></code>.</dd>
<dt><code class="program"><a href="./programs/httxt2dbm.html">httxt2dbm</a></code></dt>
<dd>Un nouveau programme servant à générer des fichiers dbm à partir
d'une source au format texte, à utiliser avec la directive
<code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
et le type de mise en correspondance <code>dbm</code>.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="developer" id="developer">Changements pour le développeur de module</a></h2>
<dl>
<dt><a class="glossarylink" href="./glossary.html#apr" title="voir glossaire">APR</a> 1.0 API</dt>
<dd>Apache 2.2 utilise l'API APR 1.0. Toutes les fonctions et
symboles obsolètes ont été supprimés du code de <code>APR</code> et
<code>APR-Util</code>. Pour plus de détails, consultez le
<a href="http://apr.apache.org/">site web d'APR</a>.</dd>
<dt>Authn/Authz</dt>
<dd>Les modules d'authentification et d'autorisation intégrés ont
été renommés de la manière suivante:
<ul>
<li><code>mod_auth_*</code> -> Modules qui implémentent un mécanisme
d'authentification HTTP</li>
<li><code>mod_authn_*</code> -> Modules qui fournissent un dispositif
d'authentification en arrière-plan</li>
<li><code>mod_authz_*</code> -> Modules qui implémentent l'autorisation (ou l'accès)</li>
<li><code>mod_authnz_*</code> -> Modules qui implémentent à la fois
l'authentification & l'autorisation</li>
</ul>
L'organisation des méthodes d'authentification a également été revue, ce qui va simplifier
grandement l'ajout de nouvelles méthodes d'authentification.</dd>
<dt>Journalisation des erreurs de connexion</dt>
<dd>Une nouvelle fonction a été ajoutée, <code>ap_log_cerror</code>,
afin de pouvoir enregistrer les erreurs qui surviennent au cours de
la connexion du client. Une fois enregistré, le message inclut l'adresse IP du client.</dd>
<dt>Ajout d'une portion de code pour la vérification de la configuration</dt>
<dd>Un nouvel élément de traitement a été ajouté, <code>test_config</code>,
afin d'aider les modules qui ne veulent exécuter un code spécial
que si l'utilisateur passe le paramètre <code>-t</code> à
<code class="program"><a href="./programs/httpd.html">httpd</a></code>.</dd>
<dt>Définition de la taille de la pile pour les modules MPM en processus légers</dt>
<dd>Une nouvelle directive a été ajoutée, <code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code>
afin de définir la taille de la pile pour tous les modules MPM en processus légers (modules threadés).
Ceci s'avère nécessaire pour certains modules tiers sur des plateformes
dont la taille de la pile des threads par défaut est
trop petite.</dd>
<dt>Gestion de protocole pour les filtres en sortie</dt>
<dd>Par le passé, chaque filtre devait s'assurer que les en-têtes de
réponse corrects étaient générés dans la mesure où il les affectait.
Les filtres peuvent maintenant déléguer la gestion courante du
protocole au module
<code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>, à l'aide des appels
<code>ap_register_output_filter_protocol</code> ou
<code>ap_filter_protocol</code>.</dd>
<dt>Ajout d'un élément de traitement pour le processus père (monitor hook)</dt>
<dd>Ce nouvel élément de traitement permet aux modules de lancer
des jobs réguliers/planifiés au niveau du processus père
(root).</dd>
<dt>Modifications de l'API de traitement des expressions rationnelles</dt>
<dd>Le fichier d'en-tête <code>pcreposix.h</code> n'est plus disponible ;
il a été remplacé par le nouveau fichier
d'en-tête <code>ap_regex.h</code>. L'implémentation
POSIX.2 <code>regex.h</code> exposée dans l'ancien fichier d'en-tête
est maintenant disponible dans l'espace de nommage <code>ap_</code>
depuis <code>ap_regex.h</code>. Les appels à <code>regcomp</code>,
<code>regexec</code>, etc... peuvent être remplacés par des appels à
<code>ap_regcomp</code>, <code>ap_regexec</code>.</dd>
<dt>Cadre d'application DBD (API pour base de données SQL)</dt>
<dd><p>Avec Apache 1.x et 2.0, les modules nécessitant un processus
SQL d'arrière-plan devaient s'en charger eux-mêmes. En dehors du fait
de réinventer la roue, ceci peut s'avérer très inefficace, par
exemple lorsque plusieurs modules maintiennent chacun leurs
propres connexions.</p>
<p>Apache 2.1 et supérieur fournissent l'API <code>ap_dbd</code> qui
permet la gestion des connexions à la base de données (y compris
les stratégies optimisées pour les modules MPM threadés
et non threadés), tandis que APR 1.2 et supérieur fournissent
l'API <code>apr_dbd</code> qui permet l'interaction avec la
base de données.</p>
<p>Les nouveaux modules DEVRAIENT désormais utiliser ces APIs pour
toutes les opérations liées aux bases de données SQL.
De même, les applications existantes DEVRAIENT être mises à jour
lorsque c'est possible, que ce soit de manière transparente ou sous forme
d'une option recommandée à leurs utilisateurs.</p></dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/new_features_2_2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/new_features_2_2.html" title="Français"> fr </a> |
<a href="./ko/new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_2.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_2.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sitemap.html.fr.utf8 0000664 0001751 0001751 00000065715 14740503670 020676 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Plan du site - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div>
<div id="page-content"><div id="preamble"><h1>Plan du site</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>Cette page contient la liste des éléments actuellement disponibles de
la <a href="./">Documentation du serveur HTTP Apache Version
2.4</a>.</p>
</div>
<div id="quickview"><ul id="toc">
<li><img alt="" src="./images/down.gif" /> <a href="#release">Notes de version</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Utilisation du serveur HTTP Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#vhosts">Documentation des serveurs virtuels Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rewrite">Guide de réécriture d'URLs</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ssl">Chiffrement SSL/TLS avec Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#howto">Guides, Tutoriels, and Recettes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#platform">Notes spécifiques à certains systèmes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Le serveur HTTP Apache et ses programmes associés</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#misc">Documentations diverses sur Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Modules Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Documentation du développeur</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#index">Glossaire et Index</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="release" id="release">Notes de version</a></h2>
<ul><li><a href="upgrading.html">Mise à jour vers 2.4 depuis 2.2</a></li>
<li><a href="new_features_2_4.html">Nouvelles fonctionnalités d'Apache 2.3/2.4</a></li>
<li><a href="new_features_2_2.html">Nouvelles fonctionnalités d'Apache 2.1/2.2</a></li>
<li><a href="new_features_2_0.html">Nouvelles fonctionnalités d'Apache 2.0</a></li>
<li><a href="license.html">License Apache</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="using" id="using">Utilisation du serveur HTTP Apache</a></h2>
<ul><li><a href="install.html">Compilation et installation</a></li>
<li><a href="invoking.html">Démarrage</a></li>
<li><a href="stopping.html">Arrêt ou redémarrage</a></li>
<li><a href="configuring.html">Fichiers de configuration</a></li>
<li><a href="sections.html">Comment fonctionnent les sections Directory,
Location et Files</a></li>
<li><a href="caching.html">Mise en cache du contenu</a></li>
<li><a href="server-wide.html">Configuration niveau serveur</a></li>
<li><a href="logs.html">Fichiers de traces</a></li>
<li><a href="urlmapping.html">Mise en correspondance des URLs avec le système de fichiers</a></li>
<li><a href="dso.html">Objets Dynamiques Partagés (DSO)</a></li>
<li><a href="content-negotiation.html">Négociation sur le contenu</a></li>
<li><a href="custom-error.html">Messages d'erreur personnalisés</a></li>
<li><a href="bind.html">Définition des adresses et ports qu'utilise
Apache</a></li>
<li><a href="mpm.html">Modules multi-processus (MPMs)</a></li>
<li><a href="env.html">Les variables d'environnement d'Apache</a></li>
<li><a href="expr.html">L'interprétation des expressions dans Apache</a></li>
<li><a href="handler.html">Utilisation des gestionnaires d'Apache</a></li>
<li><a href="filter.html">Filtres</a></li>
<li><a href="socache.html">Support du cache des objets partagés</a></li>
<li><a href="suexec.html">Support de suEXEC</a></li>
<li><a href="dns-caveats.html">Considérations à propos de DNS et Apache</a></li>
<li><a href="http://wiki.apache.org/httpd/FAQ">Foire aux Questions</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="vhosts" id="vhosts">Documentation des serveurs virtuels Apache</a></h2>
<ul><li class="separate"><a href="vhosts/">Aperçu</a></li>
<li><a href="vhosts/name-based.html">Serveurs virtuels basés sur le nom</a></li>
<li><a href="vhosts/ip-based.html">Support des serveurs virtuels basés
sur l'adresse IP</a></li>
<li><a href="vhosts/mass.html">Configuration dynamique de l'hébergement
virtuel de masse</a></li>
<li><a href="vhosts/examples.html">Exemples de serveurs virtuels</a></li>
<li><a href="vhosts/details.html">Discussion approfondie à propos de la
sélection d'un serveur virtuel</a></li>
<li><a href="vhosts/fd-limits.html">Limitations inhérentes aux
descripteurs de fichiers</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="rewrite" id="rewrite">Guide de réécriture d'URLs</a></h2>
<ul><li class="separate"><a href="rewrite/">Survol</a></li>
<li><a href="mod/mod_rewrite.html">Documentation de référence de mod_rewrite</a></li>
<li><a href="rewrite/intro.html">Introduction à l'utilisation des expressions
rationnelles avec mod_rewrite</a></li>
<li><a href="rewrite/remapping.html">Utilisation de mod_rewrite pour les
redirections et la traduction des URLs</a></li>
<li><a href="rewrite/access.html">Utilisation de mod_rewrite pour le contrôle d'accès</a></li>
<li><a href="rewrite/vhosts.html">Les serveurs virtuels dynamique avec mod_rewrite</a></li>
<li><a href="rewrite/proxy.html">Le mandat dynamique avec mod_rewrite</a></li>
<li><a href="rewrite/rewritemap.html">Utilisation d'une table de
réécriture</a></li>
<li><a href="rewrite/advanced.html">Techniques avancées</a></li>
<li><a href="rewrite/avoid.html">Quand ne pas utiliser mod_rewrite</a></li>
<li><a href="rewrite/flags.html">Drapeaux de réécriture</a></li>
<li><a href="rewrite/tech.html">Détails techniques</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="ssl" id="ssl">Chiffrement SSL/TLS avec Apache</a></h2>
<ul><li class="separate"><a href="ssl/">Aperçu</a></li>
<li><a href="ssl/ssl_intro.html">Chiffrement SSL/TLS :
Introduction</a></li>
<li><a href="ssl/ssl_compat.html">Chiffrement SSL/TLS :
Compatibilité</a></li>
<li><a href="ssl/ssl_howto.html">Chiffrement SSL/TLS : Recettes</a></li>
<li><a href="ssl/ssl_faq.html">Chiffrement SSL/TLS : FAQ</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="howto" id="howto">Guides, Tutoriels, and Recettes</a></h2>
<ul><li class="separate"><a href="howto/">Aperçu</a></li>
<li><a href="howto/auth.html">Authentification et autorisation</a></li>
<li><a href="howto/access.html">Contrôle d'accès</a></li>
<li><a href="howto/cgi.html">Contenu dynamique avec CGI</a></li>
<li><a href="howto/ssi.html">Introduction aux Inclusions côté serveur
(Server Side Includes - SSI)</a></li>
<li><a href="howto/htaccess.html">Fichiers .htaccess</a></li>
<li><a href="howto/public_html.html">Répertoires web des
utilisateurs</a></li>
<li><a href="howto/reverse_proxy.html">Guide de configuration des mandataires
inverses</a></li>
<li><a href="howto/http2.html">Guide HTTP/2</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="platform" id="platform">Notes spécifiques à certains systèmes</a></h2>
<ul><li class="separate"><a href="platform/">Aperçu</a></li>
<li><a href="platform/windows.html">Utiliser Apache avec Microsoft
Windows</a></li>
<li><a href="platform/win_compiling.html">Compiler Apache pour
Microsoft Windows</a></li>
<li><a href="platform/rpm.html">Utilisation d'Apache avec les systèmes à
base de paquets RPM</a></li>
<li><a href="platform/netware.html">Utiliser Apache avec Novell
NetWare</a></li>
<li><a href="platform/perf-hp.html">Mise en oeuvre d'un serveur web
hautes performances sous HPUX</a></li>
<li><a href="platform/ebcdic.html">Le portage d'Apache sous EBCDIC</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="programs" id="programs">Le serveur HTTP Apache et ses programmes associés</a></h2>
<ul><li class="separate"><a href="programs/">Aperçu</a></li>
<li><a href="programs/httpd.html">Page de manuel : httpd</a></li>
<li><a href="programs/ab.html">Page de manuel : ab</a></li>
<li><a href="programs/apachectl.html">Page de manuel : apachectl</a></li>
<li><a href="programs/apxs.html">Page de manuel : apxs</a></li>
<li><a href="programs/configure.html">Page de manuel : configure</a></li>
<li><a href="programs/dbmmanage.html">Page de manuel : dbmmanage</a></li>
<li><a href="programs/fcgistarter.html">Page de manuel : fcgistarter</a></li>
<li><a href="programs/htcacheclean.html">Page de manuel : htcacheclean</a></li>
<li><a href="programs/htdbm.html">Page de manuel : htdbm</a></li>
<li><a href="programs/htdigest.html">Page de manuel : htdigest</a></li>
<li><a href="programs/htpasswd.html">Page de manuel : htpasswd</a></li>
<li><a href="programs/httxt2dbm.html">Page de manuel : httxt2dbm</a></li>
<li><a href="programs/logresolve.html">Page de manuel : logresolve</a></li>
<li><a href="programs/log_server_status.html">Page de manuel : log_server_status</a></li>
<li><a href="programs/rotatelogs.html">Page de manuel : rotatelogs</a></li>
<li><a href="programs/split-logfile.html">Page de manuel : split-logfile</a></li>
<li><a href="programs/suexec.html">Page de manuel : suexec</a></li>
<li><a href="programs/other.html">Autres programmes</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="misc" id="misc">Documentations diverses sur Apache</a></h2>
<ul><li class="separate"><a href="misc/">Aperçu</a></li>
<li><a href="misc/perf-tuning.html">Considérations à propos des
performances - Configuration fine d'Apache</a></li>
<li><a href="misc/security_tips.html">Conseils en matière de sécurité</a></li>
<li><a href="misc/relevant_standards.html">Standards concernés</a></li>
<li><a href="misc/password_encryptions.html">Formats de chiffrement des
mots de passe</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="modules" id="modules">Modules Apache</a></h2>
<ul><li><a href="mod/module-dict.html">Définitions des termes utilisés pour
décrire les modules Apache</a></li>
<li><a href="mod/directive-dict.html">Définitions des termes utilisés
pour décrire les directives Apache</a></li>
</ul><ul><li><a href="mod/core.html">Fonctionalités de Base Apache</a></li>
<li><a href="mod/mpm_common.html">Apache MPM : Directives Communes</a></li>
<li><a href="mod/event.html">Apache MPM event</a></li>
<li><a href="mod/mpm_netware.html">Apache MPM netware</a></li>
<li><a href="mod/mpmt_os2.html">Apache MPM os2</a></li>
<li><a href="mod/prefork.html">Apache MPM prefork</a></li>
<li><a href="mod/mpm_winnt.html">Apache MPM winnt</a></li>
<li><a href="mod/worker.html">Apache MPM worker</a></li>
</ul><ul><li><a href="mod/mod_access_compat.html">Module Apache mod_access_compat</a></li>
<li><a href="mod/mod_actions.html">Module Apache mod_actions</a></li>
<li><a href="mod/mod_alias.html">Module Apache mod_alias</a></li>
<li><a href="mod/mod_allowmethods.html">Module Apache mod_allowmethods</a></li>
<li><a href="mod/mod_asis.html">Module Apache mod_asis</a></li>
<li><a href="mod/mod_auth_basic.html">Module Apache mod_auth_basic</a></li>
<li><a href="mod/mod_auth_digest.html">Module Apache mod_auth_digest</a></li>
<li><a href="mod/mod_auth_form.html">Module Apache mod_auth_form</a></li>
<li><a href="mod/mod_authn_anon.html">Module Apache mod_authn_anon</a></li>
<li><a href="mod/mod_authn_core.html">Module Apache mod_authn_core</a></li>
<li><a href="mod/mod_authn_dbd.html">Module Apache mod_authn_dbd</a></li>
<li><a href="mod/mod_authn_dbm.html">Module Apache mod_authn_dbm</a></li>
<li><a href="mod/mod_authn_file.html">Module Apache mod_authn_file</a></li>
<li><a href="mod/mod_authn_socache.html">Module Apache mod_authn_socache</a></li>
<li><a href="mod/mod_authnz_fcgi.html">Module Apache mod_authnz_fcgi</a></li>
<li><a href="mod/mod_authnz_ldap.html">Module Apache mod_authnz_ldap</a></li>
<li><a href="mod/mod_authz_core.html">Module Apache mod_authz_core</a></li>
<li><a href="mod/mod_authz_dbd.html">Module Apache mod_authz_dbd</a></li>
<li><a href="mod/mod_authz_dbm.html">Module Apache mod_authz_dbm</a></li>
<li><a href="mod/mod_authz_groupfile.html">Module Apache mod_authz_groupfile</a></li>
<li><a href="mod/mod_authz_host.html">Module Apache mod_authz_host</a></li>
<li><a href="mod/mod_authz_owner.html">Module Apache mod_authz_owner</a></li>
<li><a href="mod/mod_authz_user.html">Module Apache mod_authz_user</a></li>
<li><a href="mod/mod_autoindex.html">Module Apache mod_autoindex</a></li>
<li><a href="mod/mod_brotli.html">Module Apache mod_brotli</a></li>
<li><a href="mod/mod_buffer.html">Module Apache mod_buffer</a></li>
<li><a href="mod/mod_cache.html">Module Apache mod_cache</a></li>
<li><a href="mod/mod_cache_disk.html">Module Apache mod_cache_disk</a></li>
<li><a href="mod/mod_cache_socache.html">Module Apache mod_cache_socache</a></li>
<li><a href="mod/mod_cern_meta.html">Module Apache mod_cern_meta</a></li>
<li><a href="mod/mod_cgi.html">Module Apache mod_cgi</a></li>
<li><a href="mod/mod_cgid.html">Module Apache mod_cgid</a></li>
<li><a href="mod/mod_charset_lite.html">Module Apache mod_charset_lite</a></li>
<li><a href="mod/mod_data.html">Module Apache mod_data</a></li>
<li><a href="mod/mod_dav.html">Module Apache mod_dav</a></li>
<li><a href="mod/mod_dav_fs.html">Module Apache mod_dav_fs</a></li>
<li><a href="mod/mod_dav_lock.html">Module Apache mod_dav_lock</a></li>
<li><a href="mod/mod_dbd.html">Module Apache mod_dbd</a></li>
<li><a href="mod/mod_deflate.html">Module Apache mod_deflate</a></li>
<li><a href="mod/mod_dialup.html">Module Apache mod_dialup</a></li>
<li><a href="mod/mod_dir.html">Module Apache mod_dir</a></li>
<li><a href="mod/mod_dumpio.html">Module Apache mod_dumpio</a></li>
<li><a href="mod/mod_echo.html">Module Apache mod_echo</a></li>
<li><a href="mod/mod_env.html">Module Apache mod_env</a></li>
<li><a href="mod/mod_example_hooks.html">Module Apache mod_example_hooks</a></li>
<li><a href="mod/mod_expires.html">Module Apache mod_expires</a></li>
<li><a href="mod/mod_ext_filter.html">Module Apache mod_ext_filter</a></li>
<li><a href="mod/mod_file_cache.html">Module Apache mod_file_cache</a></li>
<li><a href="mod/mod_filter.html">Module Apache mod_filter</a></li>
<li><a href="mod/mod_headers.html">Module Apache mod_headers</a></li>
<li><a href="mod/mod_heartbeat.html">Module Apache mod_heartbeat</a></li>
<li><a href="mod/mod_heartmonitor.html">Module Apache mod_heartmonitor</a></li>
<li><a href="mod/mod_http2.html">Module Apache mod_http2</a></li>
<li><a href="mod/mod_ident.html">Module Apache mod_ident</a></li>
<li><a href="mod/mod_imagemap.html">Module Apache mod_imagemap</a></li>
<li><a href="mod/mod_include.html">Module Apache mod_include</a></li>
<li><a href="mod/mod_info.html">Module Apache mod_info</a></li>
<li><a href="mod/mod_isapi.html">Module Apache mod_isapi</a></li>
<li><a href="mod/mod_lbmethod_bybusyness.html">Module Apache mod_lbmethod_bybusyness</a></li>
<li><a href="mod/mod_lbmethod_byrequests.html">Module Apache mod_lbmethod_byrequests</a></li>
<li><a href="mod/mod_lbmethod_bytraffic.html">Module Apache mod_lbmethod_bytraffic</a></li>
<li><a href="mod/mod_lbmethod_heartbeat.html">Module Apache mod_lbmethod_heartbeat</a></li>
<li><a href="mod/mod_ldap.html">Module Apache mod_ldap</a></li>
<li><a href="mod/mod_log_config.html">Module Apache mod_log_config</a></li>
<li><a href="mod/mod_log_debug.html">Module Apache mod_log_debug</a></li>
<li><a href="mod/mod_log_forensic.html">Module Apache mod_log_forensic</a></li>
<li><a href="mod/mod_logio.html">Module Apache mod_logio</a></li>
<li><a href="mod/mod_lua.html">Module Apache mod_lua</a></li>
<li><a href="mod/mod_macro.html">Module Apache mod_macro</a></li>
<li><a href="mod/mod_md.html">Module Apache mod_md</a></li>
<li><a href="mod/mod_mime.html">Module Apache mod_mime</a></li>
<li><a href="mod/mod_mime_magic.html">Module Apache mod_mime_magic</a></li>
<li><a href="mod/mod_negotiation.html">Module Apache mod_negotiation</a></li>
<li><a href="mod/mod_nw_ssl.html">Module Apache mod_nw_ssl</a></li>
<li><a href="mod/mod_privileges.html">Module Apache mod_privileges</a></li>
<li><a href="mod/mod_proxy.html">Module Apache mod_proxy</a></li>
<li><a href="mod/mod_proxy_ajp.html">Module Apache mod_proxy_ajp</a></li>
<li><a href="mod/mod_proxy_balancer.html">Module Apache mod_proxy_balancer</a></li>
<li><a href="mod/mod_proxy_connect.html">Module Apache mod_proxy_connect</a></li>
<li><a href="mod/mod_proxy_express.html">Module Apache mod_proxy_express</a></li>
<li><a href="mod/mod_proxy_fcgi.html">Module Apache mod_proxy_fcgi</a></li>
<li><a href="mod/mod_proxy_fdpass.html">Module Apache mod_proxy_fdpass</a></li>
<li><a href="mod/mod_proxy_ftp.html">Module Apache mod_proxy_ftp</a></li>
<li><a href="mod/mod_proxy_hcheck.html">Module Apache mod_proxy_hcheck</a></li>
<li><a href="mod/mod_proxy_html.html">Module Apache mod_proxy_html</a></li>
<li><a href="mod/mod_proxy_http.html">Module Apache mod_proxy_http</a></li>
<li><a href="mod/mod_proxy_http2.html">Module Apache mod_proxy_http2</a></li>
<li><a href="mod/mod_proxy_scgi.html">Module Apache mod_proxy_scgi</a></li>
<li><a href="mod/mod_proxy_uwsgi.html">Module Apache mod_proxy_uwsgi</a></li>
<li><a href="mod/mod_proxy_wstunnel.html">Module Apache mod_proxy_wstunnel</a></li>
<li><a href="mod/mod_ratelimit.html">Module Apache mod_ratelimit</a></li>
<li><a href="mod/mod_reflector.html">Module Apache mod_reflector</a></li>
<li><a href="mod/mod_remoteip.html">Module Apache mod_remoteip</a></li>
<li><a href="mod/mod_reqtimeout.html">Module Apache mod_reqtimeout</a></li>
<li><a href="mod/mod_request.html">Module Apache mod_request</a></li>
<li><a href="mod/mod_rewrite.html">Module Apache mod_rewrite</a></li>
<li><a href="mod/mod_sed.html">Module Apache mod_sed</a></li>
<li><a href="mod/mod_session.html">Module Apache mod_session</a></li>
<li><a href="mod/mod_session_cookie.html">Module Apache mod_session_cookie</a></li>
<li><a href="mod/mod_session_crypto.html">Module Apache mod_session_crypto</a></li>
<li><a href="mod/mod_session_dbd.html">Module Apache mod_session_dbd</a></li>
<li><a href="mod/mod_setenvif.html">Module Apache mod_setenvif</a></li>
<li><a href="mod/mod_slotmem_plain.html">Module Apache mod_slotmem_plain</a></li>
<li><a href="mod/mod_slotmem_shm.html">Module Apache mod_slotmem_shm</a></li>
<li><a href="mod/mod_so.html">Module Apache mod_so</a></li>
<li><a href="mod/mod_socache_dbm.html">Module Apache mod_socache_dbm</a></li>
<li><a href="mod/mod_socache_dc.html">Module Apache mod_socache_dc</a></li>
<li><a href="mod/mod_socache_memcache.html">Module Apache mod_socache_memcache</a></li>
<li><a href="mod/mod_socache_redis.html">Module Apache mod_socache_redis</a></li>
<li><a href="mod/mod_socache_shmcb.html">Module Apache mod_socache_shmcb</a></li>
<li><a href="mod/mod_speling.html">Module Apache mod_speling</a></li>
<li><a href="mod/mod_ssl.html">Module Apache mod_ssl</a></li>
<li><a href="mod/mod_status.html">Module Apache mod_status</a></li>
<li><a href="mod/mod_substitute.html">Module Apache mod_substitute</a></li>
<li><a href="mod/mod_suexec.html">Module Apache mod_suexec</a></li>
<li><a href="mod/mod_systemd.html">Module Apache mod_systemd</a></li>
<li><a href="mod/mod_unique_id.html">Module Apache mod_unique_id</a></li>
<li><a href="mod/mod_unixd.html">Module Apache mod_unixd</a></li>
<li><a href="mod/mod_userdir.html">Module Apache mod_userdir</a></li>
<li><a href="mod/mod_usertrack.html">Module Apache mod_usertrack</a></li>
<li><a href="mod/mod_version.html">Module Apache mod_version</a></li>
<li><a href="mod/mod_vhost_alias.html">Module Apache mod_vhost_alias</a></li>
<li><a href="mod/mod_watchdog.html">Module Apache mod_watchdog</a></li>
<li><a href="mod/mod_xml2enc.html">Module Apache mod_xml2enc</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="developer" id="developer">Documentation du développeur</a></h2>
<ul><li class="separate"><a href="developer/">Aperçu</a></li>
<li><a href="developer/API.html">Notes sur l'API Apache</a></li>
<li><a href="developer/new_api_2_4.html">Mises à jour de l'API dans Apache HTTPD 2.4</a></li>
<li><a href="developer/modguide.html">Développement de modules pour Apache HTTPD 2.4</a></li>
<li><a href="developer/documenting.html">Documentation d'Apache HTTPD</a></li>
<li><a href="developer/hooks.html">Fonctions d'accroche (Hook Functions)
d'Apache 2.x</a></li>
<li><a href="developer/modules.html">Convertir un module depuis la
version 1.3 vers la version 2.x</a></li>
<li><a href="developer/request.html">Traitement des requêtes avec
la version 2.x</a></li>
<li><a href="developer/filters.html">Fonctionnement des filtres dans la
version 2.x</a></li>
<li><a href="developer/output-filters.html">Guide des filtres en sortie
dans la version 2.x</a></li>
<li><a href="developer/thread_safety.html">Sécurité des
threads dans la version 2.x</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="index" id="index">Glossaire et Index</a></h2>
<ul><li><a href="glossary.html">Glossaire</a></li>
<li><a href="mod/">Index des modules</a></li>
<li><a href="mod/directives.html">Index des directives</a></li>
<li><a href="mod/quickreference.html">Référence rapide des directives</a></li>
<li><a href="mod/overrides.html">Index des directives disponibles dans les
fichiers .htaccess</a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sitemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/upgrading.html.fr.utf8 0000664 0001751 0001751 00000102635 14740503670 021205 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Mise à jour de la version 2.2 vers la version 2.4 - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Mise à jour de la version 2.2 vers la version 2.4</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/upgrading.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/upgrading.html" title="Français"> fr </a></p>
</div>
<p>Afin d'assister les utilisateurs lors de leurs opérations de mise à
jour, nous maintenons un document
qui comporte des informations critiques à l'attention des personnes qui
utilisent déjà le serveur HTTP Apache. Ces informations
ne sont que de brèves notes, et vous
trouverez plus d'informations dans le document <a href="new_features_2_4.html">Nouvelles fonctionnalités</a>, ou dans
le fichier <code>src/CHANGES</code>. Les développeurs d'applications
et de modules trouveront un résumé des modifications de l'API dans la
vue d'ensemble <a href="developer/new_api_2_4.html">Mises à jour de
l'API</a>.</p>
<p>Ce document présente les changements de comportement du serveur qui
peuvent nécessiter une modification de la configuration, et une
méthode pour utiliser la version 2.4 du serveur en parallèle avec la
version 2.2. Pour tirer parti des nouvelles fonctionnalités de la
version 2.4, reportez-vous au document "Nouvelles fonctionnalités".</p>
<p>Ce document ne décrit que les modifications intervenues entre les versions
2.2 et 2.4. Si vous effectuez une mise à jour depuis la version 2.0, vous
devez aussi consulter le
<a href="http://httpd.apache.org/docs/2.2/upgrading.html">document de mise
à jour de 2.0 vers 2.2.</a></p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#compile-time">Modifications des paramètres de compilation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#run-time">Modifications de la configuration à l'exécution</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#misc">Changements divers</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#third-party">Modules tiers</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#commonproblems">Problèmes de mise à jour courants</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="new_features_2_4.html">Vue d'ensemble des nouvelles
fonctionnalités du serveur HTTP Apache 2.4</a></li><li><a href="#comments_section">Commentaires</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="compile-time" id="compile-time">Modifications des paramètres de compilation</a></h2>
<p>Le processus de compilation est très similaire à celui de la
version 2.2. Dans la plupart des cas, vous pourrez utiliser votre
ancienne ligne de commande <code>configure</code> (telle qu'elle
est enregistrée dans le fichier <code>build/config.nice</code>
situé dans le répertoire de compilation du serveur). Voici certains
changements intervenus dans la configuration par défaut :</p>
<ul>
<li>Les modules suivants ont été supprimés : mod_authn_default,
mod_authz_default et mod_mem_cache. Si vous utilisiez
mod_mem_cache sous la version 2.2, vous devez maintenant utiliser
<code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> dans la version 2.4.</li>
<li>Toutes les implémentations de répartition de charge ont été
déplacées vers des sous-modules spécifiques de mod_proxy, comme
<code class="module"><a href="./mod/mod_lbmethod_bybusyness.html">mod_lbmethod_bybusyness</a></code>. Vous devrez compiler et
chargés tous les modules correspondants que votre configuration
utilise.</li>
<li>Le support de BeOS, TPF, et des anciennes plates-formes telles
que A/UX, Next, et Tandem a été supprimé, car
elles ne sont plus considérées comme maintenues.</li>
<li>configure: les modules dynamiques (DSO) sont compilés par
défaut</li>
<li>configure: par défaut, seul un jeu de modules de base est
chargé. Les autres directives <code class="directive">LoadModule</code>
sont mises en commentaires dans le fichier de configuration.</li>
<li>configure: le jeu de modules "most" est compilé par défaut</li>
<li>configure: le jeu de modules "reallyall" ajoute les modules de
développeur au jeu "all".</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="run-time" id="run-time">Modifications de la configuration à l'exécution</a></h2>
<p>Des changements significatifs dans la configuration de
l'autorisation, ainsi que quelques changements mineurs, peuvent
nécessiter une mise à jour des fichiers de configuration de la version
2.2 avant de les utiliser sous la version 2.4.</p>
<h3><a name="authz" id="authz">Autorisation</a></h3>
<p>Tout fichier de configuration qui gère des autorisations devra
probablement être mis à jour.</p>
<p>Vous devez vous reporter au document <a href="howto/auth.html">Authentification, autorisation et contrôle
d'accès</a>, et plus particulièrement à la section <a href="howto/auth.html#beyond">Pour aller plus loin qu'une simple
autorisation</a> qui explique les nouveaux mécanismes permettant de
contrôler l'ordre dans lequel les directives d'autorisation sont
appliquées.</p>
<p>Les directives qui contrôlent la manière dont les modules
d'autorisation réagissent lorsqu'ils ne reconnaissent pas
l'utilisateur authentifié ont été supprimées : elles comprennent les
directives AuthzLDAPAuthoritative, AuthzDBDAuthoritative,
AuthzDBMAuthoritative, AuthzGroupFileAuthoritative,
AuthzUserAuthoritative et AuthzOwnerAuthoritative. Ces directives
ont été remplacées par les directives plus explicites <code class="directive"><a href="./mod/mod_authz_core.html#requireany">RequireAny</a></code>, <code class="directive"><a href="./mod/mod_authz_core.html#requirenone">RequireNone</a></code>, et <code class="directive"><a href="./mod/mod_authz_core.html#requireall">RequireAll</a></code>.</p>
<p>Si vous utilisez <code class="module"><a href="./mod/mod_authz_dbm.html">mod_authz_dbm</a></code>, vous devez
mettre à jour votre configuration en remplaçant les directives du
style <code>Require group ...</code> par des directives du style
<code>Require dbm-group ...</code>.</p>
<h4><a name="access" id="access">Contrôle d'accès</a></h4>
<p>Dans la version 2.2, le contrôle d'accès basé sur le nom d'hôte
du client, son adresse IP, ou d'autres caractéristiques de la
requête était assuré via les directives <code class="directive"><a href="./mod/mod_access_compat.html#order">Order</a></code>, <code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code>, <code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code>, et <code class="directive"><a href="./mod/mod_access_compat.html#satisfy">Satisfy</a></code>.</p>
<p>Dans la version 2.4, ce contrôle d'accès est assuré, comme tout
contrôle d'autorisation, par le nouveau module
<code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>. Bien que le module
<code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> soit fourni à des fins de
compatibilité avec les anciennes configurations, les anciennes
directives de contrôle d'accès devront être remplacées par les
nouveaux mécanismes d'authentification.</p>
<div class="note"><h3>Mélanger anciennes et nouvelles directives</h3>
<p>Mélanger d'anciennes directives comme <code class="directive"><a href="./mod/mod_access_compat.html#order">Order</a></code>, <code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code> ou <code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code> avec des nouvelles comme
<code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code> est techniquement
possible mais déconseillé. En effet, <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> a
été conçu pour supporter des configurations ne contenant que des anciennes
directives afin de faciliter le passage à la version 2.4. Les
exemples ci-dessous vous permettront de vous faire une meilleure idée des
problèmes qui peuvent survenir.
</p>
</div>
<p>Voici quelques exemples de contrôle d'accès avec l'ancienne et
la nouvelle méthode :</p>
<p>Dans cet exemple, il n'y a pas d'authentification et toutes les requêtes sont rejetées :</p>
<div class="example"><h3>version 2.2 :</h3><pre class="prettyprint lang-config">Order deny,allow
Deny from all</pre>
</div>
<div class="example"><h3>version 2.4 :</h3><pre class="prettyprint lang-config">Require all denied</pre>
</div>
<p>Dans cet exemple, il n'y a pas d'authentification et toutes les requêtes sont acceptées :</p>
<div class="example"><h3>version 2.2 :</h3><pre class="prettyprint lang-config">Order allow,deny
Allow from all</pre>
</div>
<div class="example"><h3>version 2.4 :</h3><pre class="prettyprint lang-config">Require all granted</pre>
</div>
<p>Dans l'exemple suivant, il n'y a pas d'authentification et tous les
hôtes du domaine example.org ont l'autorisation d'accès, tous les autres
étant rejetés :</p>
<div class="example"><h3>version 2.2 :</h3><pre class="prettyprint lang-config">Order Deny,Allow
Deny from all
Allow from example.org</pre>
</div>
<div class="example"><h3>version 2.4 :</h3><pre class="prettyprint lang-config">Require host example.org</pre>
</div>
<p>Dans l'exemple suivant, tous les hôtes du domaine example.org
ont l'autorisation d'accès, tous les autres sont rejetés :</p>
<div class="example"><h3>version 2.2 :</h3><pre class="prettyprint lang-config">Order Deny,Allow
Deny from all
Allow from example.org</pre>
</div>
<div class="example"><h3>version 2.4 :</h3><pre class="prettyprint lang-config">Require host example.org</pre>
</div>
<p>Dans l'exemple suivant, le mélange d'anciennes et de nouvelles
directives produit des résultats inattendus.</p>
<div class="example"><h3>Mélange d'anciennes et de nouvelles directives : RESULTAT
INATTENDU</h3><pre class="prettyprint lang-config">DocumentRoot "/var/www/html"
<Directory "/">
AllowOverride None
Order deny,allow
Deny from all
</Directory>
<Location "/server-status">
SetHandler server-status
Require local
</Location>
access.log - GET /server-status 403 127.0.0.1
error.log - AH01797: client denied by server configuration: /var/www/html/server-status</pre>
</div>
<p>Pourquoi httpd interdit l'accès à server-status alors que la
configuration semble l'autoriser ? Parce que dans ce scénario de <a href="sections.html#merging">fusion</a> de configuration, les
directives de <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> sont prioritaires par
rapport à celles de <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>.</p>
<p>L'exemple suivant quant à lui produit un résultat conforme :</p>
<div class="example"><h3>Mélange d'anciennes et de nouvelles directives : RESULTAT
CONFORME</h3><pre class="prettyprint lang-config">DocumentRoot "/var/www/html"
<Directory "/">
AllowOverride None
Require all denied
</Directory>
<Location "/server-status">
SetHandler server-status
Order deny,allow
Deny from all
Allow From 127.0.0.1
</Location>
access.log - GET /server-status 200 127.0.0.1</pre>
</div>
<p>En conclusion, même si une configuration hybride peut fonctionner,
essayez de l'éviter lors de la mise à jour : soit conservez les anciennes
directives, puis migrez-les vers les nouvelles ultérieurement, soit
effectuez une migration immédiate de toutes les anciennes directives vers
les nouvelles.
</p>
<p>Dans de nombreuses configurations avec authentification où la directive
<code class="directive">Satisfy</code> était définie à sa valeur par défaut
<em>ALL</em>, les lignes de configuration qui désactivent le contrôle
d'accès basé sur l'hôte sont maintenant omises :</p>
<div class="example"><h3>Version 2.2 :</h3><pre class="prettyprint lang-config"># configuration en version 2.2 qui désactive le contrôle d'accès basé sur le nom
# d'hôte pour n'utiliser que l'authentification
Order Deny,Allow
Allow from all
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<div class="example"><h3>Version 2.4 :</h3><pre class="prettyprint lang-config"># Pas besoin de remplacer les directives de contrôle d'accès basées sur le nom
# d'hôte désactivées
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<p>Dans les configurations où l'authentification et le contrôle d'accès se
combinaient dans un but précis, les directives de contrôle d'accès doivent
être migrées. Dans l'exemple suivant, les requêtes qui correspondent aux
<em>deux</em> critères sont acceptées :</p>
<div class="example"><h3>Version 2.2 :</h3><pre class="prettyprint lang-config">Order allow,deny
Deny from all
# ALL est la valeur par défaut de Satisfy
Satisfy ALL
Allow from 127.0.0.1
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<div class="example"><h3>Version 2.4 :</h3><pre class="prettyprint lang-config">AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
<RequireAll>
Require valid-user
Require ip 127.0.0.1
</RequireAll></pre>
</div>
<p>Dans les configurations où l'authentification et le contrôle d'accès se
combinaient dans un but précis, les directives de contrôle d'accès doivent
être migrées. Dans l'exemple suivant, les requêtes qui correspondent à
<em>au moins un</em> critère sont acceptées :</p>
<div class="example"><h3>Version 2.2 :</h3><pre class="prettyprint lang-config">Order allow,deny
Deny from all
Satisfy any
Allow from 127.0.0.1
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<div class="example"><h3>Version 2.4 :</h3><pre class="prettyprint lang-config">AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
# Implicite : <RequireAny>
Require valid-user
Require ip 127.0.0.1</pre>
</div>
<h3><a name="config" id="config">Autres changements dans la configuration</a></h3>
<p>D'autres ajustements mineurs peuvent s'avérer nécessaires pour
certaines configurations particulières, comme décrit ci-dessous.</p>
<ul>
<li>La directive <code class="directive">MaxRequestsPerChild</code> a été renommée en
<code class="directive"><a href="./mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>;
ce nouveau nom reflète mieux l'usage de cette directive.
L'ancien nom est encore supporté.</li>
<li>La directive <code class="directive">MaxClients</code> a
été renommée en <code class="directive"><a href="./mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>; ce nouveau
nom reflète mieux l'usage de cette directive. Pour les
modules multiprocessus asynchrones, comme <code class="module"><a href="./mod/event.html">event</a></code>, le nombre
maximal de clients n'est pas équivalent au nombre de threads du
worker. L'ancien nom est encore supporté.</li>
<li>La directive <code class="directive"><a href="./mod/core.html#defaulttype">DefaultType</a></code> ne produit plus aucun
effet, si ce n'est d'émettre un avertissement si elle est
définie à une valeur autre que <code>none</code>. D'autres
directives de configuration la remplacent dans la version 2.4.
</li>
<li>La valeur par défaut de la directive <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> est maintenant
<code>None</code>.</li>
<li>La valeur par défaut de la directive <code class="directive"><a href="./mod/core.html#enablesendfile">EnableSendfile</a></code> est maintenant Off.</li>
<li>La valeur par défaut de la directive <code class="directive"><a href="./mod/core.html#fileetag">FileETag</a></code> est maintenant "MTime Size"
(sans INode).</li>
<li><code class="module"><a href="./mod/mod_dav_fs.html">mod_dav_fs</a></code>: le format du fichier <code class="directive"><a href="./mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> a changé pour les systèmes
avec inodes. L'ancien fichier <code class="directive"><a href="./mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> doit être supprimé dans le
cadre de la mise à jour.
</li>
<li>La directive <code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code>
n'accepte que les valeurs <code>On</code> ou <code>Off</code>.
Avant, toute valeur autre que "Off" ou "0" était traitée comme
"On".</li>
<li>Les directives AcceptMutex, LockFile, RewriteLock, SSLMutex,
SSLStaplingMutex et WatchdogMutexPath ont été remplacées par la
directive unique <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.
Vous devez évaluer l'impact de ces directives obsolètes dans
votre configuration version 2.2 afin de déterminer si elles
peuvent être simplement supprimées, ou si elles doivent être
remplacées par la directive <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.</li>
<li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>: la directive <code class="directive"><a href="./mod/mod_cache.html#cacheignoreurlsessionidentifiers">CacheIgnoreURLSessionIdentifiers</a></code>
effectue maintenant une correspondance exacte dans la chaîne de
paramètres au lieu d'une correspondance partielle. Si votre
configuration mettait en jeu des sous-chaînes comme
<code>sessionid</code> pour correspondre à
<code>/une-application/image.gif;jsessionid=123456789</code>,
vous devez maintenant utiliser la chaîne de correspondance
complète <code>jsessionid</code>.
</li>
<li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>: le second paramètre de la
directive <code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code>
ne concerne les contenus en mandat direct que s'ils débutent par
le protocole approprié. Dans les versions 2.2 et antérieures, un
paramètre tel que '/' concernait tous les contenus.</li>
<li><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>: la directive <code class="directive"><a href="./mod/mod_ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></code> s'utilise
maintenant exclusivement au sein d'une configuration de niveau
répertoire. Si vous utilisez cette directive, passez en revue
votre configuration pour vous assurer qu'elle est bien présente
dans tous les contextes de répertoire nécessaires.</li>
<li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>: la syntaxe de la directive
<code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code> utilise
maintenant une expression booléenne pour déterminer si un filtre
s'applique.
</li>
<li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>:
<ul>
<li>L'élément <code>#if expr</code> utilise maintenant le
nouvel <a href="expr.html">interpréteur d'expressions</a>.
L'ancienne syntaxe peut être réactivée via la directive
<code class="directive"><a href="./mod/mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></code>.
</li>
<li>Dans la portée du répertoire, une directive de
configuration SSI* ne provoque plus la réinitialisation à
leur valeur par défaut de toutes les directives SSI* de
niveau répertoire.</li>
</ul>
</li>
<li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code> : l'option
<code>DebugLevel</code> a été supprimée en faveur d'une
configuration de la directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> au niveau répertoire.
</li>
<li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> : l'option
<code>DebugLevel</code> a été supprimée en faveur d'une
configuration de la directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> au niveau répertoire.
</li>
<li><code class="module"><a href="./mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code>: certaines applications web
ne fonctionneront plus correctement avec la nouvelle
configuration de <code>PATH_INFO</code> qui est différente de
celle de la version 2.2. La configuration
précédente peut être
restaurée en définissant la variable
<code>proxy-scgi-pathinfo</code>.</li>
<li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>: le contrôle de révocation des
certificats basé sur les CRL doit être maintenant explicitement
configuré via la directive <code class="directive"><a href="./mod/mod_ssl.html#sslcarevocationcheck">SSLCARevocationCheck</a></code>.
</li>
<li><code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code>: la taille maximale d'une
ligne est maintenant 1Mo.
</li>
<li><code class="module"><a href="./mod/mod_reqtimeout.html">mod_reqtimeout</a></code>: si ce module est chargé, il
définit maintenant certains temps d'attente par défaut.</li>
<li><code class="module"><a href="./mod/mod_dumpio.html">mod_dumpio</a></code>: la directive
<code class="directive">DumpIOLogLevel</code> n'est plus supportée. Les
données sont toujours enregistrées au niveau <code>trace7</code>
de <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code></li>
<li>Jusqu'à la version 2.2, sur les plateformes de style Unix,
les commandes de redirection des logs définies via <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> ou <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> étaient invoquées
en utilisant <code>/bin/sh -c</code>. A
partir de la version 2.4, les commandes de redirection des logs
sont exécutées directement. Pour retrouver l'ancien
comportement, voir la <a href="logs.html#piped">documentation
sur la redirection des logs</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="misc" id="misc">Changements divers</a></h2>
<ul>
<li><code class="module"><a href="./mod/mod_auto_index.html">mod_auto_index</a></code>: extrait maintenant les titres
et affiche la description pour les fichiers .xhtml qui étaient
jusqu'alors ignorés.</li>
<li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> : le format par défaut des variables
<code>*_DN</code> a changé. Il est cependant encore possible
d'utiliser l'ancien format via la nouvelle option
<code>LegacyDNStringFormat</code> de la directive <code class="directive"><a href="./mod/mod_ssl.html#ssloptions">SSLOptions</a></code>. Le protocole SSLv2 n'est
plus supporté. Les directives <code class="directive"><a href="./mod/mod_ssl.html#sslproxycheckpeercn">SSLProxyCheckPeerCN</a></code> et
<code class="directive"><a href="./mod/mod_ssl.html#sslproxycheckpeerexpire">SSLProxyCheckPeerExpire</a></code>
sont maintenant définies par défaut à On, et les requêtes mandatées
vers des serveurs HTTPS possèdant des certificats non conformes ou
périmés échoueront donc avec un code d'erreur 502 (Bad gateway).</li>
<li><code class="program"><a href="./programs/htpasswd.html">htpasswd</a></code> utilise maintenant par défaut les
condensés MD5 sur toutes les plates-formes.</li>
<li>La directive <code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code> n'a plus aucun effet, si
ce n'est l'émission d'un avertissement. Toute combinaison
adresse/port apparaissant dans plusieurs serveurs virtuels est
traitée implicitement comme un serveur virtuel basé sur le nom.
</li>
<li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> n'effectue plus de compression
s'il s'aperçoit que la quantité de données ajoutée par la
compression est supérieure à la quantité de données à compresser.
</li>
<li>Les pages d'erreur multilingues de la version 2.2.x ne
fonctionneront qu'après avoir été corrigées pour
respecter la nouvelle syntaxe de l'élément <code>#if expr=</code>
du module <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>, ou si la directive
<code class="directive"><a href="./mod/mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></code> a
été activée pour le répertoire contenant les pages d'erreur.
</li>
<li>La fonctionnalité fournie par <code>mod_authn_alias</code>
dans les précédentes versions (en fait la directive
<code class="directive"><a href="./mod/mod_authn_core.html#authnprovideralias">AuthnProviderAlias</a></code>)
est maintenant fournie par <code class="module"><a href="./mod/mod_authn_core.html">mod_authn_core</a></code>.
</li>
<li>Les directives RewriteLog et RewriteLogLevel ont été
supprimées. Leur fonctions sont maintenant assurées par la
directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> qui permet de définir
un niveau de journalisation approprié pour le module
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>. Voir aussi la section <a href="mod/mod_rewrite.html#logging">journalisation de
mod_rewrite</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="third-party" id="third-party">Modules tiers</a></h2>
<p>Tous les modules tiers doivent être recompilés pour la
version 2.4 avant d'être chargés.</p>
<p>De nombreux modules tiers conçus pour la version 2.2
fonctionneront sans changement avec le serveur HTTP Apache
version 2.4. Certains nécessiteront cependant des modifications ; se
reporter à la vue d'ensemble <a href="developer/new_api_2_4.html">Mise à jour de l'API</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="commonproblems" id="commonproblems">Problèmes de mise à jour courants</a></h2>
<ul><li>Erreurs au démarrage :
<ul>
<li><code>Invalid command 'User', perhaps misspelled or defined by
a module not included in the server configuration</code> - chargez
le module <code class="module"><a href="./mod/mod_unixd.html">mod_unixd</a></code></li>
<li><code>Invalid command 'Require', perhaps misspelled or defined
by a module not included in the server configuration</code>, ou
<code>Invalid command 'Order', perhaps misspelled or defined by a
module not included in the server configuration</code> - chargez
le module <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code>, ou mettez à jour
vers la version 2.4 les directives d'autorisation.</li>
<li><code>Ignoring deprecated use of DefaultType in line NN of
/path/to/httpd.conf</code> - supprimez la directive <code class="directive"><a href="./mod/core.html#defaulttype">DefaultType</a></code> et remplacez-la par les
directives de configuration appropriées.</li>
<li><code>Invalid command 'AddOutputFilterByType', perhaps misspelled
or defined by a module not included in the server configuration
</code> - la directive <code class="directive"><a href="./mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code> qui était
jusqu'alors implémentée par le module core, l'est maintenant par
le module mod_filter, qui doit donc être chargé.</li>
</ul></li>
<li>Erreurs de traitement des requêtes :
<ul>
<li><code>configuration error: couldn't check user: /path</code> -
chargez le module <code class="module"><a href="./mod/mod_authn_core.html">mod_authn_core</a></code>.</li>
<li>Les fichiers <code>.htaccess</code> ne sont pas traités -
Vérifiez la présence d'une directive <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> appropriée ; sa valeur par
défaut est maintenant <code>None</code>.</li>
</ul>
</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/upgrading.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/upgrading.html" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/upgrading.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/server-wide.html.fr.utf8 0000664 0001751 0001751 00000030640 14740503670 021455 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Configuration à l'échelle du serveur - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Configuration à l'échelle du serveur</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/server-wide.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/server-wide.html" title="Français"> fr </a> |
<a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document explique le fonctionnement de certaines directives du serveur
de base qui sont utilisées pour configurer les opérations élémentaires du
serveur.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#identification">Identification du serveur</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#locations">Localisation des fichiers</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#resource">Limitation de l'utilisation des ressources</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#implementation">Choix d'implémentation</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="identification" id="identification">Identification du serveur</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code></li><li><code class="directive"><a href="./mod/core.html#serversignature">ServerSignature</a></code></li><li><code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li></ul></td></tr></table>
<p>Les directives <code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code> et
<code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> contrôlent la nature des
informations à propos du serveur qui seront affichées dans les documents
générés par le serveur comme les messages d'erreur. La directive
<code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> définit la valeur du
champ d'en-tête de la réponse du serveur HTTP.</p>
<p>Le serveur utilise les directives
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>,
<code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> et
<code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code> pour
déterminer la manière de construire des URLs vers ses propres ressources.
Par exemple, quand un client émet une requête vers un répertoire, mais
n'ajoute pas le slash final au nom du répertoire, httpd doit rediriger le
client vers le nom complet incluant le slash final afin que le client
puisse résoudre correctement les références relatives présentes dans
le document.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="locations" id="locations">Localisation des fichiers</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code></li><li><code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code></li></ul></td></tr></table>
<p>Ces directives contrôlent la localisation des différents fichiers
nécessaires au bon fonctionnement de httpd. Quand le chemin utilisé ne
commence pas par un slash (/), la localisation des fichiers est relative
à la valeur de la directive
<code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>. Soyez prudent avec la
localisation de fichiers dans des répertoires où les utilisateurs non root
ont les droits en écriture. Voir la documention sur les
<a href="misc/security_tips.html#serverroot">Conseils à propos
de la sécurité</a> pour plus de détails.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="resource" id="resource">Limitation de l'utilisation des ressources</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#limitrequestbody">LimitRequestBody</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfields">LimitRequestFields</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfieldsize">LimitRequestFieldsize</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestline">LimitRequestLine</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitcpu">RLimitCPU</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitmem">RLimitMEM</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitnproc">RLimitNPROC</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code></li></ul></td></tr></table>
<p>Les directives <code class="directive">LimitRequest</code>* permettent de
limiter la quantité de ressources consommées par httpd pour le traitement
des requêtes des clients. Cette limitation permet de minimiser les effets
de certains types d'attaques par déni de service.</p>
<p>Les directives <code class="directive">RLimit</code>* permettent de limiter la
quantité de ressources utilisable par les processus initiés (forked) par
les processus enfants httpd. Elles permettent en particulier de contrôler
les ressources utilisées par les scripts CGI et les commandes exec des
"Inclusions côté serveur" (Server Side Includes ou SSI).</p>
<p>La directive <code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code>
permet sur certaines plates-formes de contrôler la taille de la pile.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="implementation" id="implementation">Choix d'implémentation</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code></li></ul></td></tr></table>
<p>La directive <code class="directive">Mutex</code> permet de modifier
l'implémentation sous-jacente des mutex, afin de résoudre les
problèmes de fonctionnement ou de performance dus au choix par
défaut d'<a class="glossarylink" href="./glossary.html#apr" title="voir glossaire">APR</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/server-wide.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/server-wide.html" title="Français"> fr </a> |
<a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/server-wide.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/suexec.html.fr.utf8 0000664 0001751 0001751 00000100366 14740503670 020520 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Support suEXEC - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Support suEXEC</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/suexec.html" title="Français"> fr </a> |
<a href="./ja/suexec.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>La fonctionnalité <strong>suEXEC</strong> permet
l'exécution des programmes <strong>CGI</strong> et
<strong>SSI</strong> sous un utilisateur autre que celui sous
lequel s'exécute le serveur web qui appelle ces programmes.
Normalement, lorsqu'un programme CGI ou SSI est lancé, il
s'exécute sous le même utilisateur que celui du serveur web qui
l'appelle.</p>
<p>Utilisée de manière appropriée, cette fonctionnalité peut
réduire considérablement les risques de sécurité encourus
lorsqu'on autorise les utilisateurs à développer et faire
s'exécuter des programmes CGI ou SSI de leur cru. Cependant, mal
configuré, suEXEC peut causer de nombreux problèmes et même créer
de nouvelles failles dans la sécurité de votre ordinateur. Si
vous n'êtes pas familier avec la gestion des programmes
<em>setuid root</em> et les risques de sécurité qu'ils comportent,
nous vous recommandons vivement de ne pas tenter
d'utiliser suEXEC.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#before">Avant de commencer</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#model">Modèle de sécurité de suEXEC</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">Configurer et installer suEXEC</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#enable">Activation et désactivation
de suEXEC</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#usage">Utilisation de suEXEC</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#debug">Débogage de suEXEC</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#jabberwock">Avis à la population !
Avertissements et exemples</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</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="before" id="before">Avant de commencer</a></h2>
<p>Avant de foncer tête baissée dans la lecture de ce document,
vous devez tenir compte de certaines hypothèses concernant vous-même
et l'environnement dans lequel vous allez utiliser suexec.</p>
<p>Premièrement, vous devez utiliser un système d'exploitation
UNIX ou dérivé, capable d'effectuer des opérations
<strong>setuid</strong> et <strong>setgid</strong>. Tous les
exemples de commande sont donnés en conséquence. D'autres
plates-formes, même si elles supportent suEXEC, peuvent
avoir une configuration différente.</p>
<p>Deuxièmement, vous devez être familier avec les concepts de base
relatifs à la sécurité de votre ordinateur et son administration.
Ceci implique la compréhension des opérations
<strong>setuid/setgid</strong> et des différents effets qu'elles
peuvent produire sur votre système et son niveau de sécurité.</p>
<p>Troisièmement, vous devez utiliser une version
<strong>non modifiée</strong> du code de suEXEC. L'ensemble du
code de suEXEC a été scruté et testé avec soin par les développeurs
et de nombreux bêta testeurs. Toutes les précautions ont été prises
pour s'assurer d'une base sûre de code non seulement simple, mais
aussi solide. La modification de ce code peut causer des problèmes
inattendus et de nouveaux risques de sécurité. Il est
<strong>vivement</strong> recommandé de ne pas modifier le code de
suEXEC, à moins que vous ne soyez un programmeur spécialiste des
particularités liées à la sécurité, et souhaitez partager votre
travail avec l'équipe de développement du serveur HTTP Apache afin
de pouvoir en discuter.</p>
<p>Quatrièmement et dernièrement, l'équipe de développement du
serveur HTTP Apache a décidé de ne
<strong>PAS</strong> inclure suEXEC dans l'installation par défaut
d'Apache httpd. Pour pouvoir mettre en oeuvre suEXEC, l'administrateur
doit porter la plus grande attention aux détails. Après avoir bien
réfléchi aux différents points de la configuration de suEXEC,
l'administrateur peut l'installer selon les méthodes classiques.
Les valeurs des paramètres de configuration doivent être
déterminées et spécifiées avec soin par l'administrateur, afin de
maintenir la sécurité du système de manière appropriée lors de
l'utilisation de la fonctionnalité suEXEC. C'est par le biais de
ce processus minutieux que nous espérons réserver
l'installation de suEXEC aux administrateurs prudents et
suffisamment déterminés à vouloir l'utiliser.</p>
<p>Vous êtes encore avec nous ? Oui ? Bien.
Alors nous pouvons continuer !</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="model" id="model">Modèle de sécurité de suEXEC</a></h2>
<p>Avant d'installer et configurer suEXEC, nous allons tout d'abord
décrire le modèle de sécurité que vous êtes sur le point
d'implémenter. Vous devriez ainsi mieux comprendre ce qui se passe
vraiment à l'intérieur de suEXEC et quelles précautions ont été
prises pour préserver la sécurité de votre système.</p>
<p><strong>suEXEC</strong> est basé sur un programme "conteneur"
(wrapper) setuid qui est appelé par le serveur HTTP Apache principal.
Ce conteneur est appelé quand une requête HTTP concerne
un programme CGI ou SSI que l'administrateur
a décidé de faire s'exécuter
sous un utilisateur autre que celui du serveur principal.
Lorsqu'il reçoit une telle requête, Apache httpd fournit au conteneur
suEXEC le nom du programme, ainsi que les identifiants utilisateur
et groupe sous lesquels le programme doit s'exécuter.</p>
<p>Le conteneur effectue ensuite les vérifications suivantes afin
de déterminer la réussite ou l'échec du processus -- si une seule
de ces conditions n'est pas vérifiée, le programme journalise
l'erreur et se termine en retournant un code d'erreur, sinon il
continue :</p>
<ol>
<li>
<strong>L'utilisateur qui exécute le conteneur est-il un
utilisateur valide de ce système ?</strong>
<p class="indent">
Ceci permet de s'assurer que l'utilisateur qui exécute le
conteneur est vraiment un utilisateur appartenant au système.
</p>
</li>
<li>
<strong>Le conteneur a-t-il été appelé avec un nombre
d'arguments correct ?</strong>
<p class="indent">
Le conteneur ne s'exécutera que si on lui fournit un nombre
d'arguments correct. Le serveur HTTP apache sait quel est le
bon format des arguments. Si le conteneur ne reçoit pas un
nombre d'arguments correct, soit il a été modifié,
soit quelque chose ne va pas dans la portion suEXEC de
votre binaire Apache httpd.
</p>
</li>
<li>
<strong>Cet utilisateur valide est-il autorisé à exécuter le
conteneur ?</strong>
<p class="indent">
Cet utilisateur est-il celui autorisé à exécuter le
conteneur ? Un seul utilisateur (celui d'Apache) est
autorisé à exécuter ce programme.
</p>
</li>
<li>
<strong>Le chemin du programme CGI ou SSI cible est-il
non sûr ?</strong>
<p class="indent">
Le chemin du programme CGI ou SSI cible débute-t-il par un
'/' ou contient-il une référence arrière '..' ? Ceci est
interdit ; le programme CGI ou SSI cible doit se trouver dans
la hiérarchie de la racine des documents de suEXEC (voir
<code>--with-suexec-docroot=<em>DIR</em></code> ci-dessous).
</p>
</li>
<li>
<strong>Le nom utilisateur cible est-il valide ?</strong>
<p class="indent">
L'utilisateur cible existe-t-il ?
</p>
</li>
<li>
<strong>Le nom du groupe cible est-il valide ?</strong>
<p class="indent">
Le groupe cible existe-t-il ?
</p>
</li>
<li>
<strong>L'utilisateur cible n'est-il <em>PAS</em>
superutilisateur ?</strong>
<p class="indent">
suEXEc ne permet pas à
<code><em>root</em></code> d'exécuter des programmes CGI/SSI.
</p>
</li>
<li>
<strong>Le numéro de l'identifiant de l'utilisateur cible
est-il <em>SUPERIEUR</em> au numéro d'identifiant
minimum ?</strong>
<p class="indent">
Le numéro d'identifiant utilisateur minimum est défini à
l'exécution du script configure. Ceci vous permet de définir
le numéro d'identifiant utilisateur le plus bas qui sera
autorisé à éxécuter des programmes CGI/SSI. En particulier,
cela permet d'écarter les comptes système.
</p>
</li>
<li>
<strong>Le groupe cible n'est-il <em>PAS</em> le groupe
superutilisateur ?</strong>
<p class="indent">
Actuellement, suEXEC ne permet pas au groupe
<code><em>root</em></code> d'exécuter des programmes CGI/SSI.
</p>
</li>
<li>
<strong> Le numéro d'identifiant du groupe cible est-il
<em>SUPERIEUR</em> au numéro d'identifiant minimum ?</strong>
<p class="indent">
Le numéro d'identifiant de groupe minimum est spécifié lors
de l'exécution du script configure. Ceci vous permet de
définir l'identifiant de groupe le plus bas possible qui sera
autorisé à exécuter des programmes CGI/SSI, et est
particulièrement utile pour écarter les groupes "système".
</p>
</li>
<li>
<strong>Le conteneur peut-il obtenir avec succès l'identité
des utilisateur et groupe cibles ?</strong>
<p class="indent">
C'est ici que le programme obtient l'identité des utilisateur
et groupe cibles via des appels à setuid et setgid. De même,
la liste des accès groupe est initialisée avec tous les
groupes auxquels l'utilisateur cible appartient.
</p>
</li>
<li>
<strong>Peut-on se positionner dans le répertoire dans dequel
sont situés les programmes CGI/SSI ?</strong>
<p class="indent">
S'il n'existe pas, il ne peut pas contenir de fichier. Et si
l'on ne peut pas s'y positionner, il n'existe probablement
pas.
</p>
</li>
<li>
<strong>Le répertoire est-il dans l'espace web
de httpd ?</strong>
<p class="indent">
Si la requête concerne une portion de la racine du serveur,
le répertoire demandé est-il dans la hiérarchie de la racine
des documents de suEXEC ? Si la requête concerne un
<code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code>, le répertoire demandé est-il dans
la hiérarchie du répertoire défini comme le répertoire
utilisateur de suEXEC (voir les
<a href="#install">options de configuration de suEXEC</a>) ?
</p>
</li>
<li>
<strong>L'écriture dans le répertoire est-elle interdite pour
un utilisateur autre que le propriétaire </strong>
<p class="indent">
Le répertoire ne doit pas être ouvert aux autres
utilisateurs ; seul l'utilisateur propriétaire doit pouvoir
modifier le contenu du répertoire.
</p>
</li>
<li>
<strong>Le programme CGI/SSI cible existe-t-il ?</strong>
<p class="indent">
S'il n'existe pas, il ne peut pas être exécuté.
</p>
</li>
<li>
<strong>Les utilisateurs autres que le propriétaire n'ont-ils
<em>PAS</em> de droits en écriture sur le programme
CGI/SSI ?</strong>
<p class="indent">
Les utilisateurs autres que le propriétaire ne doivent pas
pouvoir modifier le programme CGI/SSI.
</p>
</li>
<li>
<strong>Le programme CGI/SSI n'est-il <em>PAS</em> setuid ou
setgid ?</strong>
<p class="indent">
Les programmes cibles ne doivent pas pouvoir modifier à
nouveau les identifiants utilisateur/groupe.
</p>
</li>
<li>
<strong>Le couple utilisateur/groupe cible est-il le même que
celui du programme ?</strong>
<p class="indent">
L'utilisateur est-il le propriétaire du fichier ?
</p>
</li>
<li>
<strong>Peut-on nettoyer avec succès l'environnement des
processus afin de garantir la sûreté des opérations ?</strong>
<p class="indent">
suExec nettoie l'environnement des processus en établissant
un chemin d'exécution sûr (défini lors de la configuration),
et en ne passant que les variables dont les noms font partie
de la liste de l'environnement sûr (créée de même lors de la
configuration).
</p>
</li>
<li>
<strong>Le conteneur peut-il avec succès se substituer au
programme CGI/SSI cible et s'exécuter ?</strong>
<p class="indent">
C'est là où l'exécution de suEXEC s'arrête et où commence
celle du programme CGI/ssi cible.
</p>
</li>
</ol>
<p>Ce sont les opérations standards effectuées par le modèle de
sécurité du conteneur suEXEC. Il peut paraître strict et est
susceptible d'imposer de nouvelles limitations et orientations
dans la conception des programmes CGI/SSI, mais il a été développé
avec le plus grand soin, étape par étape, en se focalisant sur
la sécurité.</p>
<p>Pour plus d'informations sur la mesure dans laquelle ce modèle
de sécurité peut limiter vos possibilités au regard de la
configuration du serveur, ainsi que les risques de sécurité qui
peuvent être évités grâce à une configuration appropriée de suEXEC,
se référer à la section <a href="#jabberwock">"Avis à la population !"</a> de ce document.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">Configurer et installer suEXEC</a></h2>
<p>C'est ici que nous entrons dans le vif du sujet.</p>
<p><strong>Options de configuration de suEXEC</strong><br />
</p>
<dl>
<dt><code>--enable-suexec</code></dt>
<dd>Cette option active la fonctionnalité suEXEC qui n'est
jamais installée ou activée par défaut. Au moins une option
<code>--with-suexec-xxxxx</code> doit accompagner l'option
<code>--enable-suexec</code> pour qu'APACI (l'utilitaire de
configuration de la compilation d'Apache) accepte votre demande
d'utilisation de la fonctionnalité suEXEC.</dd>
<dt><code>--with-suexec-bin=<em>PATH</em></code></dt>
<dd>Le chemin du binaire <code>suexec</code> doit être codé en
dur dans le serveur pour des raisons de sécurité. Cette option
vous permet de modifier le chemin par défaut.
<em>Par exemple</em>
<code>--with-suexec-bin=/usr/sbin/suexec</code></dd>
<dt><code>--with-suexec-caller=<em>UID</em></code></dt>
<dd>L'<a href="mod/mpm_common.html#user">utilisateur</a> sous
lequel httpd s'exécute habituellement. C'est le seul utilisateur
autorisé à exécuter le wrapper suEXEC.</dd>
<dt><code>--with-suexec-userdir=<em>DIR</em></code></dt>
<dd>Cette option définit le sous-répertoire de la hiérarchie des
répertoires utilisateurs dans lequel l'utilisation
de suEXEC sera autorisée. Tous les exécutables situés dans ce
répertoire seront exécutables par suEXEC sous l'utilisateur
cible ; ces programmes doivent donc être sûrs. Si vous utilisez
une directive <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code>
"simple" (c'est à dire ne contenant pas de
"*"), l'option --with-suexec-userdir
devra contenir la même valeur. SuEXEC ne fonctionnera pas
correctement si la directive <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> contient une valeur
différente du répertoire home de l'utilisateur tel qu'il est
défini dans le fichier <code>passwd</code>. la valeur par défaut
est "<code>public_html</code>".<br />
Si vous avez plusieurs hôtes virtuels avec une directive
<code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> différente
pour chacun d'entre eux, vous devrez faire en sorte que chaque
UserDir possède un répertoire parent commun ; donnez alors à
l'option --with-suexec-userdir le nom
de ce répertoire commun. <strong>Si tout ceci n'est pas défini
correctement, les requêtes CGI "~userdir" ne fonctionneront
pas !</strong></dd>
<dt><code>--with-suexec-docroot=<em>DIR</em></code></dt>
<dd>Cette option fonctionne comme la directive DocumentRoot pour
httpd. Il s'agit de la seule hiérarchie (en dehors des directives
<code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code>) dans laquelle la fonctionnalité suEXEC
pourra être utilisée. La valeur par défaut est la valeur de
<code>--datadir</code> accompagnée du suffixe
"<code>/htdocs</code>" ;
<em>Par exemple</em>, si vous exécutez configure avec
"<code>--datadir=/home/apache</code>", la valeur
"<code>/home/apache/htdocs</code>" sera utilisée par défaut comme
racine des documents pour le conteneur suEXEC.</dd>
<dt><code>--with-suexec-uidmin=<em>UID</em></code></dt>
<dd>Cette option définit l'identifiant utilisateur le plus bas
avec lequel un utilisateur pourra être la cible de
suEXEC. 500 ou 100 sont des valeurs courantes sur la plupart des
systèmes. la valeur par défaut est 100.</dd>
<dt><code>--with-suexec-gidmin=<em>GID</em></code></dt>
<dd>Cette option définit l'identifiant de groupe le plus bas
avec lequel un utilisateur pourra être la cible de
suEXEC. 100 est une valeur courante sur la plupart des
systèmes et est par conséquent la valeur par défaut.</dd>
<dt><code>--with-suexec-logfile=<em>FILE</em></code></dt>
<dd>Cette option permet de définir le fichier dans lequel
toutes les transactions et erreurs de suEXEC seront journalisées
(à des fins d'analyse ou de débogage). Par défaut, le fichier
journal se nomme "<code>suexec_log</code>" et se trouve dans votre
répertoire standard des fichiers journaux défini par
<code>--logfiledir</code></dd>
<dt><code>--with-suexec-safepath=<em>PATH</em></code></dt>
<dd>Cette option permet de définir une variable d'environnement
PATH sûre à passer aux exécutables CGI. La valeur par défaut
est "<code>/usr/local/bin:/usr/bin:/bin</code>".</dd>
</dl>
<h3>Compilation et installation du conteneur suEXEC</h3>
<p>Si vous avez activé la fonctionnalité suEXEC à l'aide de
l'option <code>--enable-suexec</code>, le binaire
<code>suexec</code> sera automatiquement construit (en même temps
que httpd) lorsque vous exécuterez la commande
<code>make</code>.</p>
<p>Lorsque tous les composants auront été construits, vous pourrez
exécuter la commande <code>make install</code> afin de les
installer. Le binaire <code>suexec</code> sera installé dans le
répertoire défini à l'aide de l'option <code>--sbindir</code>. La
localisation par défaut est "/usr/local/apache2/bin/suexec".</p>
<p>Veuillez noter que vous aurez besoin des
<strong><em>privilèges root</em></strong> pour passer l'étape de
l'installation. Pour que le conteneur puisse changer
l'identifiant utilisateur, il doit avoir comme propriétaire
<code><em>root</em></code>, et les droits du fichier doivent
inclure le bit d'exécution setuserid.</p>
<h3>>Mise en place de permissions pour
paranoïaque</h3>
<p>Bien que le conteneur suEXEC vérifie que l'utilisateur qui
l'appelle correspond bien à l'utilisateur spécifié à l'aide de
l'option <code>--with-suexec-caller</code> du programme
<code class="program"><a href="./programs/configure.html">configure</a></code>, il subsiste toujours le risque qu'un
appel système ou une bibliothèque fasse appel à suEXEC avant que
cette vérification ne soit exploitable sur votre système. Pour
tenir compte de ceci, et parce que c'est en général la meilleure
pratique, vous devez utiliser les permissions du système de
fichiers afin de vous assurer que seul le groupe sous lequel
s'exécute httpd puisse faire appel à suEXEC.</p>
<p>Si, par exemple, votre serveur web est configuré pour
s'exécuter en tant que :</p>
<pre class="prettyprint lang-config">User www
Group webgroup</pre>
<p>et <code class="program"><a href="./programs/suexec.html">suexec</a></code> se trouve à
"/usr/local/apache2/bin/suexec", vous devez exécuter les
commandes</p>
<div class="example"><p><code>
chgrp webgroup /usr/local/apache2/bin/suexec<br />
chmod 4750 /usr/local/apache2/bin/suexec<br />
</code></p></div>
<p>Ceci permet de s'assurer que seul le groupe sous lequel httpd
s'exécute (ici webgroup) puisse faire appel au conteneur
suEXEC.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="enable" id="enable">Activation et désactivation
de suEXEC</a></h2>
<p>Au démarrage, httpd vérifie la présence du fichier
<code class="program"><a href="./programs/suexec.html">suexec</a></code> dans le répertoire défini par
l'option <code>--sbindir</code> du script configure (le
répertoire par défaut est "/usr/local/apache/sbin/suexec"). Si
httpd trouve un conteneur suEXEC correctement configuré, il
enregistrera le message suivant dans le journal des erreurs :</p>
<div class="example"><p><code>
[notice] suEXEC mechanism enabled (wrapper: <var>/path/to/suexec</var>)
</code></p></div>
<p>Si ce message n'est pas généré au démarrage du serveur, ce
dernier ne trouve probablement pas le programme conteneur à
l'endroit où il est sensé être, ou l'exécutable suexec n'est pas
installé en <em>setuid root</em>.</p>
<p>Si le serveur HTTP Apache est déjà en cours d'exécution, et si
vous activez le mécanisme suEXEC pour la première fois, vous
devez arrêter et redémarrer httpd. Un redémarrage
à l'aide d'un simple signal HUP ou USR1 suffira. </p>
<p>Pour désactiver suEXEC, vous devez supprimer le fichier
<code class="program"><a href="./programs/suexec.html">suexec</a></code>, puis arrêter et redémarrer
httpd.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="usage" id="usage">Utilisation de suEXEC</a></h2>
<p>Les requêtes pour des programmes CGI ne feront appel au
conteneur suEXEC que si elles concernent un hôte virtuel
contenant une directive <code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code>, ou si elles sont
traitées par <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>.</p>
<p><strong>Hôtes virtuels :</strong><br /> Une des méthodes
d'utilisation du conteneur suEXEC consiste à insérer une
directive <code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> dans une section
<code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code>. En définissant
des valeurs différentes de celles du serveur principal, toutes les
requêtes pour des ressources CGI seront exécutées sous
les <em>User</em> et <em>Group</em> définis pour cette section
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>. Si cette
directive est absente de la section <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>, l'utilisateur du
serveur principal sera pris par défaut</p>
<p><strong>Répertoires des utilisateurs :</strong><br /> Avec
cette méthode, les
requêtes traitées par <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code> appelleront le
conteneur suEXEC pour exécuter le programme CGI sous l'identifiant
utilisateur du répertoire utilisateur concerné. Seuls prérequis
pour pouvoir accéder à cette fonctionnalité : l'exécution des CGI
doit être activée pour l'utilisateur concerné, et le script doit
passer avec succès le test des <a href="#model">vérifications de
sécurité</a> décrit plus haut. Voir aussi l'
<a href="#install">option de compilation</a>
<code>--with-suexec-userdir</code>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="debug" id="debug">Débogage de suEXEC</a></h2>
<p>Le conteneur suEXEC va écrire ses informations de journalisation
dans le fichier défini par l'option de compilation
<code>--with-suexec-logfile</code> comme indiqué plus haut. Si vous
pensez avoir configuré et installé correctement le conteneur,
consultez ce journal, ainsi que le journal des erreurs du serveur
afin de déterminer l'endroit où vous avez fait fausse route.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="jabberwock" id="jabberwock">Avis à la population !
Avertissements et exemples</a></h2>
<p><strong>NOTE !</strong> Cette section est peut-être
incomplète.</p>
<p>Quelques points importants du conteneur peuvent
imposer des contraintes du point de vue de la configuration du
serveur. Veuillez en prendre connaissance avant de soumettre un
rapport de bogue à propos de suEXEC.</p>
<p><strong>Points importants à propos de suEXEC</strong></p>
<ul>
<li>
Limitations concernant la hiérarchie.
<p class="indent">
Pour des raisons de sécurité et d'efficacité, toutes les
requêtes suEXEC ne doivent concerner que des ressources
situées dans la racine des documents définie pour les
requêtes concernant un hôte virtuel, ou des ressources
situées dans la racine des documents définies pour les
requêtes concernant un répertoire utilisateur. Par exemple,
si vous avez configuré quatre hôtes virtuels, vous devrez
définir la structure des racines de documents de vos hôtes
virtuels en dehors d'une hiérarchie de documents principale
de httpd, afin de tirer parti de suEXEC dans le contexte des
hôtes virtuels (Exemple à venir).
</p>
</li>
<li>
La variable d'environnement PATH de suEXEC
<p class="indent">
Modifier cette variable peut s'avérer dangereux. Assurez-vous
que tout chemin que vous ajoutez à cette variable est un
répertoire <strong>de confiance</strong>. Vous n'avez
probablement pas l'intention d'ouvrir votre serveur de façon
à ce que l'on puisse y exécuter un cheval de Troie.
</p>
</li>
<li>
Modification de suEXEC
<p class="indent">
Encore une fois, ceci peut vous causer de
<strong>graves ennuis</strong> si vous vous y essayez sans
savoir ce que vous faites. Evitez de vous y risquer dans la
mesure du possible.
</p>
</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/suexec.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/suexec.html" title="Français"> fr </a> |
<a href="./ja/suexec.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/suexec.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/caching.html.en 0000664 0001751 0001751 00000145246 14737241666 017746 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Caching Guide - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Caching Guide</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/caching.html" title="English"> en </a> |
<a href="./fr/caching.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./tr/caching.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document supplements the <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>,
<code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>, <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> and <a href="programs/htcacheclean.html">htcacheclean</a> reference documentation.
It describes how to use the Apache HTTP Server's caching features to accelerate web and
proxy serving, while avoiding common problems and misconfigurations.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#http-caching">Three-state RFC2616 HTTP caching</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Cache Setup Examples</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#socache-caching">General Two-state Key/Value Shared Object Caching</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#file-caching">Specialized File Caching</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#security">Security Considerations</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="introduction" id="introduction">Introduction</a></h2>
<p>The Apache HTTP server offers a range of caching features that
are designed to improve the performance of the server in various
ways.</p>
<dl>
<dt>Three-state RFC2616 HTTP caching</dt>
<dd>
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
and its provider modules
<code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>
provide intelligent, HTTP-aware caching. The content itself is stored
in the cache, and mod_cache aims to honor all of the various HTTP
headers and options that control the cacheability of content
as described in
<a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">Section
13 of RFC2616</a>.
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
is aimed at both simple and complex caching configurations, where
you are dealing with proxied content, dynamic local content or
have a need to speed up access to local files on a potentially
slow disk.
</dd>
<dt>Two-state key/value shared object caching</dt>
<dd>
The <a href="socache.html">shared object cache API</a> (socache)
and its provider modules provide a
server wide key/value based shared object cache. These modules
are designed to cache low level data such as SSL sessions and
authentication credentials. Backends allow the data to be stored
server wide in shared memory, or datacenter wide in a cache such
as memcache or distcache.
</dd>
<dt>Specialized file caching</dt>
<dd>
<code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code>
offers the ability to pre-load
files into memory on server startup, and can improve access
times and save file handles on files that are accessed often,
as there is no need to go to disk on each request.
</dd>
</dl>
<p>To get the most from this document, you should be familiar with
the basics of HTTP, and have read the Users' Guides to
<a href="urlmapping.html">Mapping URLs to the Filesystem</a> and
<a href="content-negotiation.html">Content negotiation</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="http-caching" id="http-caching">Three-state RFC2616 HTTP caching</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code></li><li><code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code></li><li><code class="directive"><a href="./mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code></li></ul></td></tr></table>
<p>The HTTP protocol contains built in support for an in-line caching
mechanism
<a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">
described by section 13 of RFC2616</a>, and the
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> module can be used to take advantage of
this.</p>
<p>Unlike a simple two state key/value cache where the content
disappears completely when no longer fresh, an HTTP cache includes
a mechanism to retain stale content, and to ask the origin server
whether this stale content has changed and if not, make it fresh
again.</p>
<p>An entry in an HTTP cache exists in one of three states:</p>
<dl>
<dt>Fresh</dt>
<dd>
If the content is new enough (younger than its <strong>freshness
lifetime</strong>), it is considered <strong>fresh</strong>. An
HTTP cache is free to serve fresh content without making any
calls to the origin server at all.
</dd>
<dt>Stale</dt>
<dd>
<p>If the content is too old (older than its <strong>freshness
lifetime</strong>), it is considered <strong>stale</strong>. An
HTTP cache should contact the origin server and check whether
the content is still fresh before serving stale content to a
client. The origin server will either respond with replacement
content if not still valid, or ideally, the origin server will
respond with a code to tell the cache the content is still
fresh, without the need to generate or send the content again.
The content becomes fresh again and the cycle continues.</p>
<p>The HTTP protocol does allow the cache to serve stale data
under certain circumstances, such as when an attempt to freshen
the data with an origin server has failed with a 5xx error, or
when another request is already in the process of freshening
the given entry. In these cases a <code>Warning</code> header
is added to the response.</p>
</dd>
<dt>Non Existent</dt>
<dd>
If the cache gets full, it reserves the option to delete content
from the cache to make space. Content can be deleted at any time,
and can be stale or fresh. The <a href="programs/htcacheclean.html">htcacheclean</a> tool can be
run on a once off basis, or deployed as a daemon to keep the size
of the cache within the given size, or the given number of inodes.
The tool attempts to delete stale content before attempting to
delete fresh content.
</dd>
</dl>
<p>Full details of how HTTP caching works can be found in
<a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">
Section 13 of RFC2616</a>.</p>
<h3>Interaction with the Server</h3>
<p>The <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> module hooks into the server in two
possible places depending on the value of the
<code class="directive"><a href="./mod/mod_cache.html#cachequickhandler">CacheQuickHandler</a></code> directive:
</p>
<dl>
<dt>Quick handler phase</dt>
<dd>
<p>This phase happens very early on during the request processing,
just after the request has been parsed. If the content is
found within the cache, it is served immediately and almost
all request processing is bypassed.</p>
<p>In this scenario, the cache behaves as if it has been "bolted
on" to the front of the server.</p>
<p>This mode offers the best performance, as the majority of
server processing is bypassed. This mode however also bypasses the
authentication and authorization phases of server processing, so
this mode should be chosen with care when this is important.</p>
<p> Requests with an "Authorization" header (for example, HTTP Basic
Authentication) are neither cacheable nor served from the cache
when <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> is running in this phase.</p>
</dd>
<dt>Normal handler phase</dt>
<dd>
<p>This phase happens late in the request processing, after all
the request phases have completed.</p>
<p>In this scenario, the cache behaves as if it has been "bolted
on" to the back of the server.</p>
<p>This mode offers the most flexibility, as the potential exists
for caching to occur at a precisely controlled point in the filter
chain, and cached content can be filtered or personalized before
being sent to the client.</p>
</dd>
</dl>
<p>If the URL is not found within the cache, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
will add a <a href="filter.html">filter</a> to the filter stack in order
to record the response to the cache, and then stand down, allowing normal
request processing to continue. If the content is determined to be
cacheable, the content will be saved to the cache for future serving,
otherwise the content will be ignored.</p>
<p>If the content found within the cache is stale, the
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> module converts the request into a
<strong>conditional request</strong>. If the origin server responds with
a normal response, the normal response is cached, replacing the content
already cached. If the origin server responds with a 304 Not Modified
response, the content is marked as fresh again, and the cached content
is served by the filter instead of saving it.</p>
<h3>Improving Cache Hits</h3>
<p>When a virtual host is known by one of many different server aliases,
ensuring that <code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> is
set to <code>On</code> can dramatically improve the ratio of cache hits.
This is because the hostname of the virtual-host serving the content is
used within the cache key. With the setting set to <code>On</code>
virtual-hosts with multiple server names or aliases will not produce
differently cached entities, and instead content will be cached as
per the canonical hostname.</p>
<h3>Freshness Lifetime</h3>
<p>Well formed content that is intended to be cached should declare an
explicit freshness lifetime with the <code>Cache-Control</code>
header's <code>max-age</code> or <code>s-maxage</code> fields, or
by including an <code>Expires</code> header.</p>
<p>At the same time, the origin server defined freshness lifetime can
be overridden by a client when the client presents their own
<code>Cache-Control</code> header within the request. In this case,
the lowest freshness lifetime between request and response wins.</p>
<p>When this freshness lifetime is missing from the request or the
response, a default freshness lifetime is applied. The default
freshness lifetime for cached entities is one hour, however
this can be easily over-ridden by using the <code class="directive"><a href="./mod/mod_cache.html#cachedefaultexpire">CacheDefaultExpire</a></code> directive.</p>
<p>If a response does not include an <code>Expires</code> header but does
include a <code>Last-Modified</code> header, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
can infer a freshness lifetime based on a heuristic, which can be
controlled through the use of the <code class="directive"><a href="./mod/mod_cache.html#cachelastmodifiedfactor">CacheLastModifiedFactor</a></code> directive.</p>
<p>For local content, or for remote content that does not define its own
<code>Expires</code> header, <code class="module"><a href="./mod/mod_expires.html">mod_expires</a></code> may be used to
fine-tune the freshness lifetime by adding <code>max-age</code> and
<code>Expires</code>.</p>
<p>The maximum freshness lifetime may also be controlled by using the
<code class="directive"><a href="./mod/mod_cache.html#cachemaxexpire">CacheMaxExpire</a></code>.</p>
<h3>A Brief Guide to Conditional Requests</h3>
<p>When content expires from the cache and becomes stale, rather than
pass on the original request, httpd will modify the request to make
it conditional instead.</p>
<p>When an <code>ETag</code> header exists in the original cached
response, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> will add an
<code>If-None-Match</code> header to the request to the origin server.
When a <code>Last-Modified</code> header exists in the original
cached response, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> will add an
<code>If-Modified-Since</code> header to the request to the origin
server. Performing either of these actions makes the request
<strong>conditional</strong>.</p>
<p>When a conditional request is received by an origin server, the
origin server should check whether the ETag or the Last-Modified
parameter has changed, as appropriate for the request. If not, the
origin should respond with a terse "304 Not Modified" response. This
signals to the cache that the stale content is still fresh should be
used for subsequent requests until the content's new freshness lifetime
is reached again.</p>
<p>If the content has changed, then the content is served as if the
request were not conditional to begin with.</p>
<p>Conditional requests offer two benefits. Firstly, when making such
a request to the origin server, if the content from the origin
matches the content in the cache, this can be determined easily and
without the overhead of transferring the entire resource.</p>
<p>Secondly, a well designed origin server will be designed in such
a way that conditional requests will be significantly cheaper to
produce than a full response. For static files, typically all that is
involved is a call to <code>stat()</code> or similar system call, to
see if the file has changed in size or modification time. As such, even
local content may still be served faster from the cache if it has not
changed.</p>
<p>Origin servers should make every effort to support conditional
requests as is practical, however if conditional requests are not
supported, the origin will respond as if the request was not
conditional, and the cache will respond as if the content had changed
and save the new content to the cache. In this case, the cache will
behave like a simple two state cache, where content is effectively
either fresh or deleted.</p>
<h3>What Can be Cached?</h3>
<p>The full definition of which responses can be cached by an HTTP
cache is defined in
<a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html#sec13.4">
RFC2616 Section 13.4 Response Cacheability</a>, and can be summed up as
follows:</p>
<ol>
<li>Caching must be enabled for this URL. See the <code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code> and <code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code> directives.</li>
<li>If the response has an HTTP status code other than 200, 203, 300,
301 or 410 it must also specify an "Expires" or "Cache-Control" header.
</li>
<li>The request must be a HTTP GET request.</li>
<li>If the response contains an "Authorization:" header, it must
also contain an "s-maxage", "must-revalidate" or "public" option
in the "Cache-Control:" header, or it won't be cached.</li>
<li>If the URL included a query string (e.g. from a HTML form GET
method) it will not be cached unless the response specifies an
explicit expiration by including an "Expires:" header or the max-age
or s-maxage directive of the "Cache-Control:" header, as per RFC2616
sections 13.9 and 13.2.1.</li>
<li>If the response has a status of 200 (OK), the response must
also include at least one of the "Etag", "Last-Modified" or
the "Expires" headers, or the max-age or s-maxage directive of
the "Cache-Control:" header, unless the
<code class="directive"><a href="./mod/mod_cache.html#cacheignorenolastmod">CacheIgnoreNoLastMod</a></code>
directive has been used to require otherwise.</li>
<li>If the response includes the "private" option in a "Cache-Control:"
header, it will not be stored unless the
<code class="directive"><a href="./mod/mod_cache.html#cachestoreprivate">CacheStorePrivate</a></code> has been
used to require otherwise.</li>
<li>Likewise, if the response includes the "no-store" option in a
"Cache-Control:" header, it will not be stored unless the
<code class="directive"><a href="./mod/mod_cache.html#cachestorenostore">CacheStoreNoStore</a></code> has been
used.</li>
<li>A response will not be stored if it includes a "Vary:" header
containing the match-all "*".</li>
</ol>
<h3>What Should Not be Cached?</h3>
<p>It should be up to the client creating the request, or the origin
server constructing the response to decide whether or not the content
should be cacheable or not by correctly setting the
<code>Cache-Control</code> header, and <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> should
be left alone to honor the wishes of the client or server as appropriate.
</p>
<p>Content that is time sensitive, or which varies depending on the
particulars of the request that are not covered by HTTP negotiation,
should not be cached. This content should declare itself uncacheable
using the <code>Cache-Control</code> header.</p>
<p>If content changes often, expressed by a freshness lifetime of minutes
or seconds, the content can still be cached, however it is highly
desirable that the origin server supports
<strong>conditional requests</strong> correctly to ensure that
full responses do not have to be generated on a regular basis.</p>
<p>Content that varies based on client provided request headers can be
cached through intelligent use of the <code>Vary</code> response
header.</p>
<h3>Variable/Negotiated Content</h3>
<p>When the origin server is designed to respond with different content
based on the value of headers in the request, for example to serve
multiple languages at the same URL, HTTP's caching mechanism makes it
possible to cache multiple variants of the same page at the same URL.</p>
<p>This is done by the origin server adding a <code>Vary</code> header
to indicate which headers must be taken into account by a cache when
determining whether two variants are different from one another.</p>
<p>If for example, a response is received with a vary header such as;</p>
<div class="example"><p><code>
Vary: negotiate,accept-language,accept-charset
</code></p></div>
<p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> will only serve the cached content to
requesters with accept-language and accept-charset headers
matching those of the original request.</p>
<p>Multiple variants of the content can be cached side by side,
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> uses the <code>Vary</code> header and the
corresponding values of the request headers listed by <code>Vary</code>
to decide on which of many variants to return to the client.</p>
</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">Cache Setup Examples</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code></li><li><code class="module"><a href="./mod/mod_cache_socache.html">mod_cache_socache</a></code></li><li><code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cacheroot">CacheRoot</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code></li><li><code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code></li><li><code class="directive"><a href="./mod/mod_cache_socache.html#cachesocache">CacheSocache</a></code></li></ul></td></tr></table>
<h3><a name="disk" id="disk">Caching to Disk</a></h3>
<p>The <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> module relies on specific backend store
implementations in order to manage the cache, and for caching to disk
<code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> is provided to support this.</p>
<p>Typically the module will be configured as so;</p>
<pre class="prettyprint lang-config">CacheRoot "/var/cache/apache/"
CacheEnable disk /
CacheDirLevels 2
CacheDirLength 1</pre>
<p>Importantly, as the cached files are locally stored, operating system
in-memory caching will typically be applied to their access also. So
although the files are stored on disk, if they are frequently accessed
it is likely the operating system will ensure that they are actually
served from memory.</p>
<h3>Understanding the Cache-Store</h3>
<p>To store items in the cache, <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> creates
a 22 character hash of the URL being requested. This hash incorporates
the hostname, protocol, port, path and any CGI arguments to the URL,
as well as elements defined by the Vary header to ensure that multiple
URLs do not collide with one another.</p>
<p>Each character may be any one of 64-different characters, which mean
that overall there are 64^22 possible hashes. For example, a URL might
be hashed to <code>xyTGxSMO2b68mBCykqkp1w</code>. This hash is used
as a prefix for the naming of the files specific to that URL within
the cache, however first it is split up into directories as per
the <code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code> and
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code>
directives.</p>
<p><code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code>
specifies how many levels of subdirectory there should be, and
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code>
specifies how many characters should be in each directory. With
the example settings given above, the hash would be turned into
a filename prefix as
<code>/var/cache/apache/x/y/TGxSMO2b68mBCykqkp1w</code>.</p>
<p>The overall aim of this technique is to reduce the number of
subdirectories or files that may be in a particular directory,
as most file-systems slow down as this number increases. With
setting of "1" for
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code>
there can at most be 64 subdirectories at any particular level.
With a setting of 2 there can be 64 * 64 subdirectories, and so on.
Unless you have a good reason not to, using a setting of "1"
for <code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code>
is recommended.</p>
<p>Setting
<code class="directive"><a href="./mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code>
depends on how many files you anticipate to store in the cache.
With the setting of "2" used in the above example, a grand
total of 4096 subdirectories can ultimately be created. With
1 million files cached, this works out at roughly 245 cached
URLs per directory.</p>
<p>Each URL uses at least two files in the cache-store. Typically
there is a ".header" file, which includes meta-information about
the URL, such as when it is due to expire and a ".data" file
which is a verbatim copy of the content to be served.</p>
<p>In the case of a content negotiated via the "Vary" header, a
".vary" directory will be created for the URL in question. This
directory will have multiple ".data" files corresponding to the
differently negotiated content.</p>
<h3>Maintaining the Disk Cache</h3>
<p>The <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> module makes no attempt to
regulate the amount of disk space used by the cache, although it
will gracefully stand down on any disk error and behave as if the
cache was never present.</p>
<p>Instead, provided with httpd is the <a href="programs/htcacheclean.html">htcacheclean</a> tool which allows you
to clean the cache periodically. Determining how frequently to run <a href="programs/htcacheclean.html">htcacheclean</a> and what target size to
use for the cache is somewhat complex and trial and error may be needed to
select optimal values.</p>
<p><a href="programs/htcacheclean.html">htcacheclean</a> has two modes of
operation. It can be run as persistent daemon, or periodically from
cron. <a href="programs/htcacheclean.html">htcacheclean</a> can take up to an hour
or more to process very large (tens of gigabytes) caches and if you are
running it from cron it is recommended that you determine how long a typical
run takes, to avoid running more than one instance at a time.</p>
<p>It is also recommended that an appropriate "nice" level is chosen for
htcacheclean so that the tool does not cause excessive disk io while the
server is running.</p>
<p class="figure">
<img src="images/caching_fig1.gif" alt="" width="600" height="406" /><br />
<a id="figure1" name="figure1"><dfn>Figure 1</dfn></a>: Typical
cache growth / clean sequence.</p>
<p>Because <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> does not itself pay attention
to how much space is used you should ensure that
<a href="programs/htcacheclean.html">htcacheclean</a> is configured to
leave enough "grow room" following a clean.</p>
<h3><a name="memcache" id="memcache">Caching to memcached</a></h3>
<p>Using the <code class="module"><a href="./mod/mod_cache_socache.html">mod_cache_socache</a></code> module, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
can cache data from a variety of implementations (aka: "providers"). Using the
<code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code> module, for example, one can specify that
<a href="http://memcached.org">memcached</a> is to be used as the
the backend storage mechanism.</p>
<p>Typically the module will be configured as so:</p>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache memcache:memcd.example.com:11211</pre>
<p>Additional <code>memcached</code> servers can be specified by
appending them to the end of the <code>CacheSocache memcache:</code>
line separated by commas:</p>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache memcache:mem1.example.com:11211,mem2.example.com:11212</pre>
<p>This format is also used with the other various <code class="module"><a href="./mod/mod_cache_socache.html">mod_cache_socache</a></code>
providers. For example:</p>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache shmcb:/path/to/datafile(512000)</pre>
<pre class="prettyprint lang-config">CacheEnable socache /
CacheSocache dbm:/path/to/datafile</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="socache-caching" id="socache-caching">General Two-state Key/Value Shared Object Caching</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authn_socache.html">mod_authn_socache</a></code></li><li><code class="module"><a href="./mod/mod_socache_dbm.html">mod_socache_dbm</a></code></li><li><code class="module"><a href="./mod/mod_socache_dc.html">mod_socache_dc</a></code></li><li><code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code></li><li><code class="module"><a href="./mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code></li><li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authn_socache.html#authncachesocache">AuthnCacheSOCache</a></code></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslstaplingcache">SSLStaplingCache</a></code></li></ul></td></tr></table>
<p>The Apache HTTP server offers a low level shared object cache for
caching information such as SSL sessions, or authentication credentials,
within the <a href="socache.html">socache</a> interface.</p>
<p>Additional modules are provided for each implementation, offering the
following backends:</p>
<dl>
<dt><code class="module"><a href="./mod/mod_socache_dbm.html">mod_socache_dbm</a></code></dt>
<dd>DBM based shared object cache.</dd>
<dt><code class="module"><a href="./mod/mod_socache_dc.html">mod_socache_dc</a></code></dt>
<dd>Distcache based shared object cache.</dd>
<dt><code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code></dt>
<dd>Memcache based shared object cache.</dd>
<dt><code class="module"><a href="./mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code></dt>
<dd>Shared memory based shared object cache.</dd>
</dl>
<h3><a name="mod_authn_socache-caching" id="mod_authn_socache-caching">Caching Authentication Credentials</a></h3>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authn_socache.html">mod_authn_socache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authn_socache.html#authncachesocache">AuthnCacheSOCache</a></code></li></ul></td></tr></table>
<p>The <code class="module"><a href="./mod/mod_authn_socache.html">mod_authn_socache</a></code> module allows the result of
authentication to be cached, relieving load on authentication backends.</p>
<h3><a name="mod_ssl-caching" id="mod_ssl-caching">Caching SSL Sessions</a></h3>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslstaplingcache">SSLStaplingCache</a></code></li></ul></td></tr></table>
<p>The <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> module uses the <code>socache</code> interface
to provide a session cache and a stapling cache.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="file-caching" id="file-caching">Specialized File Caching</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code></li><li><code class="directive"><a href="./mod/mod_file_cache.html#mmapfile">MMapFile</a></code></li></ul></td></tr></table>
<p>On platforms where a filesystem might be slow, or where file
handles are expensive, the option exists to pre-load files into
memory on startup.</p>
<p>On systems where opening files is slow, the option exists to
open the file on startup and cache the file handle. These
options can help on systems where access to static files is
slow.</p>
<h3><a name="filehandle" id="filehandle">File-Handle Caching</a></h3>
<p>The act of opening a file can itself be a source of delay, particularly
on network filesystems. By maintaining a cache of open file descriptors
for commonly served files, httpd can avoid this delay. Currently httpd
provides one implementation of File-Handle Caching.</p>
<h4>CacheFile</h4>
<p>The most basic form of caching present in httpd is the file-handle
caching provided by <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code>. Rather than caching
file-contents, this cache maintains a table of open file descriptors. Files
to be cached in this manner are specified in the configuration file using
the <code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code>
directive.</p>
<p>The
<code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code> directive
instructs httpd to open the file when it is started and to re-use
this file-handle for all subsequent access to this file.</p>
<pre class="prettyprint lang-config">CacheFile /usr/local/apache2/htdocs/index.html</pre>
<p>If you intend to cache a large number of files in this manner, you
must ensure that your operating system's limit for the number of open
files is set appropriately.</p>
<p>Although using <code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code>
does not cause the file-contents to be cached per-se, it does mean
that if the file changes while httpd is running these changes will
not be picked up. The file will be consistently served as it was
when httpd was started.</p>
<p>If the file is removed while httpd is running, it will continue
to maintain an open file descriptor and serve the file as it was when
httpd was started. This usually also means that although the file
will have been deleted, and not show up on the filesystem, extra free
space will not be recovered until httpd is stopped and the file
descriptor closed.</p>
<h3><a name="inmemory" id="inmemory">In-Memory Caching</a></h3>
<p>Serving directly from system memory is universally the fastest method
of serving content. Reading files from a disk controller or, even worse,
from a remote network is orders of magnitude slower. Disk controllers
usually involve physical processes, and network access is limited by
your available bandwidth. Memory access on the other hand can take mere
nano-seconds.</p>
<p>System memory isn't cheap though, byte for byte it's by far the most
expensive type of storage and it's important to ensure that it is used
efficiently. By caching files in memory you decrease the amount of
memory available on the system. As we'll see, in the case of operating
system caching, this is not so much of an issue, but when using
httpd's own in-memory caching it is important to make sure that you
do not allocate too much memory to a cache. Otherwise the system
will be forced to swap out memory, which will likely degrade
performance.</p>
<h4>Operating System Caching</h4>
<p>Almost all modern operating systems cache file-data in memory managed
directly by the kernel. This is a powerful feature, and for the most
part operating systems get it right. For example, on Linux, let's look at
the difference in the time it takes to read a file for the first time
and the second time;</p>
<div class="example"><pre>colm@coroebus:~$ time cat testfile > /dev/null
real 0m0.065s
user 0m0.000s
sys 0m0.001s
colm@coroebus:~$ time cat testfile > /dev/null
real 0m0.003s
user 0m0.003s
sys 0m0.000s</pre></div>
<p>Even for this small file, there is a huge difference in the amount
of time it takes to read the file. This is because the kernel has cached
the file contents in memory.</p>
<p>By ensuring there is "spare" memory on your system, you can ensure
that more and more file-contents will be stored in this cache. This
can be a very efficient means of in-memory caching, and involves no
extra configuration of httpd at all.</p>
<p>Additionally, because the operating system knows when files are
deleted or modified, it can automatically remove file contents from the
cache when necessary. This is a big advantage over httpd's in-memory
caching which has no way of knowing when a file has changed.</p>
<p>Despite the performance and advantages of automatic operating system
caching there are some circumstances in which in-memory caching may be
better performed by httpd.</p>
<h4>MMapFile Caching</h4>
<p><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code> provides the
<code class="directive"><a href="./mod/mod_file_cache.html#mmapfile">MMapFile</a></code> directive, which
allows you to have httpd map a static file's contents into memory at
start time (using the mmap system call). httpd will use the in-memory
contents for all subsequent accesses to this file.</p>
<pre class="prettyprint lang-config">MMapFile /usr/local/apache2/htdocs/index.html</pre>
<p>As with the
<code class="directive"><a href="./mod/mod_file_cache.html#cachefile">CacheFile</a></code> directive, any
changes in these files will not be picked up by httpd after it has
started.</p>
<p> The <code class="directive"><a href="./mod/mod_file_cache.html#mmapfile">MMapFile</a></code>
directive does not keep track of how much memory it allocates, so
you must ensure not to over-use the directive. Each httpd child
process will replicate this memory, so it is critically important
to ensure that the files mapped are not so large as to cause the
system to swap memory.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Security Considerations</a></h2>
<h3>Authorization and Access Control</h3>
<p>Using <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> in its default state where
<code class="directive"><a href="./mod/mod_cache.html#cachequickhandler">CacheQuickHandler</a></code> is set to
<code>On</code> is very much like having a caching reverse-proxy bolted
to the front of the server. Requests will be served by the caching module
unless it determines that the origin server should be queried just as an
external cache would, and this drastically changes the security model of
httpd.</p>
<p>As traversing a filesystem hierarchy to examine potential
<code>.htaccess</code> files would be a very expensive operation,
partially defeating the point of caching (to speed up requests),
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> makes no decision about whether a cached
entity is authorised for serving. In other words; if
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> has cached some content, it will be served
from the cache as long as that content has not expired.</p>
<p>If, for example, your configuration permits access to a resource by IP
address you should ensure that this content is not cached. You can do this
by using the <code class="directive"><a href="./mod/mod_cache.html#cachedisable">CacheDisable</a></code>
directive, or <code class="module"><a href="./mod/mod_expires.html">mod_expires</a></code>. Left unchecked,
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> - very much like a reverse proxy - would cache
the content when served and then serve it to any client, on any IP
address.</p>
<p>When the <code class="directive"><a href="./mod/mod_cache.html#cachequickhandler">CacheQuickHandler</a></code>
directive is set to <code>Off</code>, the full set of request processing
phases are executed and the security model remains unchanged.</p>
<h3>Local exploits</h3>
<p>As requests to end-users can be served from the cache, the cache
itself can become a target for those wishing to deface or interfere with
content. It is important to bear in mind that the cache must at all
times be writable by the user which httpd is running as. This is in
stark contrast to the usually recommended situation of maintaining
all content unwritable by the Apache user.</p>
<p>If the Apache user is compromised, for example through a flaw in
a CGI process, it is possible that the cache may be targeted. When
using <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>, it is relatively easy to
insert or modify a cached entity.</p>
<p>This presents a somewhat elevated risk in comparison to the other
types of attack it is possible to make as the Apache user. If you are
using <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> you should bear this in mind -
ensure you upgrade httpd when security upgrades are announced and
run CGI processes as a non-Apache user using <a href="suexec.html">suEXEC</a> if possible.</p>
<h3>Cache Poisoning</h3>
<p>When running httpd as a caching proxy server, there is also the
potential for so-called cache poisoning. Cache Poisoning is a broad
term for attacks in which an attacker causes the proxy server to
retrieve incorrect (and usually undesirable) content from the origin
server.</p>
<p>For example if the DNS servers used by your system running httpd
are vulnerable to DNS cache poisoning, an attacker may be able to control
where httpd connects to when requesting content from the origin server.
Another example is so-called HTTP request-smuggling attacks.</p>
<p>This document is not the correct place for an in-depth discussion
of HTTP request smuggling (instead, try your favourite search engine)
however it is important to be aware that it is possible to make
a series of requests, and to exploit a vulnerability on an origin
webserver such that the attacker can entirely control the content
retrieved by the proxy.</p>
<h3>Denial of Service / Cachebusting</h3>
<p>The Vary mechanism allows multiple variants of the same URL to be
cached side by side. Depending on header values provided by the client,
the cache will select the correct variant to return to the client. This
mechanism can become a problem when an attempt is made to vary on a
header that is known to contain a wide range of possible values under
normal use, for example the <code>User-Agent</code> header. Depending
on the popularity of the particular web site thousands or millions of
duplicate cache entries could be created for the same URL, crowding
out other entries in the cache.</p>
<p>In other cases, there may be a need to change the URL of a particular
resource on every request, usually by adding a "cachebuster" string to
the URL. If this content is declared cacheable by a server for a
significant freshness lifetime, these entries can crowd out
legitimate entries in a cache. While <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>
provides a
<code class="directive"><a href="./mod/mod_cache.html#cacheignoreurlsessionidentifiers">CacheIgnoreURLSessionIdentifiers</a></code>
directive, this directive should be used with care to ensure that
downstream proxy or browser caches aren't subjected to the same denial
of service issue.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/caching.html" title="English"> en </a> |
<a href="./fr/caching.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./tr/caching.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/caching.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/dns-caveats.html.en 0000664 0001751 0001751 00000030573 14737241666 020556 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Issues Regarding DNS and Apache HTTP Server - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Issues Regarding DNS and Apache HTTP Server</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/dns-caveats.html" title="English"> en </a> |
<a href="./fr/dns-caveats.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dns-caveats.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dns-caveats.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This page could be summarized with the statement: don't
configure Apache HTTP Server in such a way that it relies on DNS resolution
for parsing of the configuration files. If httpd requires DNS
resolution to parse the configuration files then your server
may be subject to reliability problems (ie. it might not start up),
or denial and theft of service attacks (including virtual hosts able
to steal hits from other virtual hosts).</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#example">A Simple Example</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#denial">Denial of Service</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#main">The "main server" Address</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#tips">Tips to Avoid These Problems</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="example" id="example">A Simple Example</a></h2>
<pre class="prettyprint lang-config"># This is a misconfiguration example, do not use on your server
<VirtualHost www.example.dom>
ServerAdmin webgirl@example.dom
DocumentRoot "/www/example"
</VirtualHost></pre>
<p>In order for the server to function properly, it absolutely needs
to have two pieces of information about each virtual host: the
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> and at least one
IP address that the server will bind and respond to. The above
example does not include the IP address, so httpd must use DNS
to find the address of <code>www.example.dom</code>. If for some
reason DNS is not available at the time your server is parsing
its config file, then this virtual host <strong>will not be
configured</strong>. It won't be able to respond to any hits
to this virtual host.</p>
<p>Suppose that <code>www.example.dom</code> has address 192.0.2.1.
Then consider this configuration snippet:</p>
<pre class="prettyprint lang-config"># This is a misconfiguration example, do not use on your server
<VirtualHost 192.0.2.1>
ServerAdmin webgirl@example.dom
DocumentRoot "/www/example"
</VirtualHost></pre>
<p>This time httpd needs to use reverse DNS to find the
<code>ServerName</code> for this virtualhost. If that reverse
lookup fails then it will partially disable the virtualhost.
If the virtual host is name-based then it will effectively be
totally disabled, but if it is IP-based then it will mostly
work. However, if httpd should ever have to generate a full
URL for the server which includes the server name (such as when a
Redirect is issued), then it will fail to generate a valid URL.</p>
<p>Here is a snippet that avoids both of these problems:</p>
<pre class="prettyprint lang-config"><VirtualHost 192.0.2.1>
ServerName www.example.dom
ServerAdmin webgirl@example.dom
DocumentRoot "/www/example"
</VirtualHost></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="denial" id="denial">Denial of Service</a></h2>
<p>Consider this configuration snippet:</p>
<pre class="prettyprint lang-config"><VirtualHost www.example1.dom>
ServerAdmin webgirl@example1.dom
DocumentRoot "/www/example1"
</VirtualHost>
<VirtualHost www.example2.dom>
ServerAdmin webguy@example2.dom
DocumentRoot "/www/example2"
</VirtualHost></pre>
<p>Suppose that you've assigned 192.0.2.1 to
<code>www.example1.dom</code> and 192.0.2.2 to
<code>www.example2.dom</code>. Furthermore, suppose that
<code>example1.dom</code> has control of their own DNS. With this
config you have put <code>example1.dom</code> into a position where
they can steal all traffic destined to <code>example2.dom</code>. To
do so, all they have to do is set <code>www.example1.dom</code> to
192.0.2.2. Since they control their own DNS you can't stop them
from pointing the <code>www.example1.dom</code> record wherever they
wish.</p>
<p>Requests coming in to 192.0.2.2 (including all those where
users typed in URLs of the form
<code>http://www.example2.dom/whatever</code>) will all be served by
the <code>example1.dom</code> virtual host. To better understand why
this happens requires a more in-depth discussion of how httpd
matches up incoming requests with the virtual host that will
serve it. A rough document describing this <a href="vhosts/details.html">is available</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="main" id="main">The "main server" Address</a></h2>
<p><a href="vhosts/name-based.html">Name-based
virtual host support</a> requires httpd to know
the IP address(es) of the host that <code class="program"><a href="./programs/httpd.html">httpd</a></code>
is running on. To get this address it uses either the global
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
(if present) or calls the C function <code>gethostname</code>
(which should return the same as typing "hostname" at the
command prompt). Then it performs a DNS lookup on this address.
At present there is no way to avoid this lookup.</p>
<p>If you fear that this lookup might fail because your DNS
server is down then you can insert the hostname in
<code>/etc/hosts</code> (where you probably already have it so
that the machine can boot properly). Then ensure that your
machine is configured to use <code>/etc/hosts</code> in the
event that DNS fails. Depending on what OS you are using this
might be accomplished by editing <code>/etc/resolv.conf</code>,
or maybe <code>/etc/nsswitch.conf</code>.</p>
<p>If your server doesn't have to perform DNS for any other
reason then you might be able to get away with running httpd
with the <code>HOSTRESORDER</code> environment variable set to
"local". This all depends on what OS and resolver libraries you
are using. It also affects CGIs unless you use
<code class="module"><a href="./mod/mod_env.html">mod_env</a></code> to control the environment. It's best
to consult the man pages or FAQs for your OS.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="tips" id="tips">Tips to Avoid These Problems</a></h2>
<ul>
<li>
use IP addresses in
<code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code>
</li>
<li>
use IP addresses in
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
</li>
<li>
ensure all virtual hosts have an explicit
<code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>
</li>
<li>create a <code><VirtualHost _default_:*></code>
server that has no pages to serve</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/dns-caveats.html" title="English"> en </a> |
<a href="./fr/dns-caveats.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/dns-caveats.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/dns-caveats.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/dns-caveats.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/dns-caveats.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/filter.html.en 0000664 0001751 0001751 00000035532 14737241666 017633 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Filters - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Filters</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/filter.html" title="English"> en </a> |
<a href="./es/filter.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/filter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/filter.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/filter.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/filter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document describes the use of filters in Apache.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#intro">Filtering in Apache 2</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#smart">Smart Filtering</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#service">Exposing Filters as an HTTP Service</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Using Filters</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="intro" id="intro">Filtering in Apache 2</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code></li><li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></li><li><code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code></li><li><code class="module"><a href="./mod/mod_buffer.html">mod_buffer</a></code></li><li><code class="module"><a href="./mod/mod_data.html">mod_data</a></code></li><li><code class="module"><a href="./mod/mod_ratelimit.html">mod_ratelimit</a></code></li><li><code class="module"><a href="./mod/mod_reqtimeout.html">mod_reqtimeout</a></code></li><li><code class="module"><a href="./mod/mod_request.html">mod_request</a></code></li><li><code class="module"><a href="./mod/mod_sed.html">mod_sed</a></code></li><li><code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code></li><li><code class="module"><a href="./mod/mod_xml2enc.html">mod_xml2enc</a></code></li><li><code class="module"><a href="./mod/mod_proxy_html.html">mod_proxy_html</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_filter.html#filterchain">FilterChain</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprotocol">FilterProtocol</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code></li><li><code class="directive"><a href="./mod/mod_reflector.html#reflectorheader">ReflectorHeader</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilteroptions">ExtFilterOptions</a></code></li><li><code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code></li><li><code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code></li></ul></td></tr></table>
<p>The Filter Chain is available in Apache 2.0 and higher,
and enables applications to process incoming and outgoing data
in a highly flexible and configurable manner, regardless of
where the data comes from. We can pre-process incoming data,
and post-process outgoing data, at will. This is basically
independent of the traditional request processing phases.</p>
<p class="figure">
<img src="images/filter_arch.png" width="569" height="392" alt="Filters can be chained, in a Data Axis orthogonal to request processing" />
</p>
<p>Some examples of filtering in the standard Apache distribution are:</p>
<ul>
<li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>, implements server-side includes.</li>
<li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>, implements SSL encryption (https).</li>
<li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>, implements compression/decompression on the fly.</li>
<li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code>, transcodes between different character sets.</li>
<li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>, runs an external program as a filter.</li>
</ul>
<p>Apache also uses a number of filters internally to perform
functions like chunking and byte-range handling.</p>
<p>A wider range of applications are implemented by third-party filter
modules. A few of these are:</p>
<ul>
<li>HTML and XML processing and rewriting</li>
<li>XSLT transforms and XIncludes</li>
<li>XML Namespace support</li>
<li>File Upload handling and decoding of HTML Forms</li>
<li>Image processing</li>
<li>Protection of vulnerable applications such as PHP scripts</li>
<li>Text search-and-replace editing</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="smart" id="smart">Smart Filtering</a></h2>
<p class="figure">
<img src="images/mod_filter_new.png" width="423" height="331" alt="Smart filtering applies different filter providers according to the state of request processing" />
</p>
<p><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>, included in Apache 2.1 and later,
enables the filter chain to be configured dynamically at run time.
So for example you can set up a proxy to rewrite
HTML with an HTML filter and JPEG images with a completely
separate filter, despite the proxy having no prior information
about what the origin server will send. This works by using a
filter harness, that dispatches to different providers according
to the actual contents at runtime. Any filter may be either
inserted directly in the chain and run unconditionally, or
used as a provider and inserted dynamically. For example,</p>
<ul>
<li>an HTML processing filter will only run if the content is
text/html or application/xhtml+xml</li>
<li>A compression filter will only run if the input is a
compressible type and not already compressed</li>
<li>A charset conversion filter will be inserted if a text
document is not already in the desired charset</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="service" id="service">Exposing Filters as an HTTP Service</a></h2>
<p>Filters can be used to process content originating from the client in
addition to processing content originating on the server using the
<code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code> module.</p>
<p><code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code> accepts POST requests from clients, and reflects
the content request body received within the POST request back in the response,
passing through the output filter stack on the way back to the client.</p>
<p>This technique can be used as an alternative to a web service running within
an application server stack, where an output filter provides the transformation
required on the request body. For example, the <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code>
module might be used to provide a general compression service, or an image
transformation filter might be turned into an image transformation service.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="using" id="using">Using Filters</a></h2>
<p>There are two ways to use filtering: Simple and Dynamic.
In general, you should use one or the other; mixing them can
have unexpected consequences (although simple Input filtering
can be mixed freely with either simple or dynamic Output filtering).</p>
<p>The Simple Way is the only way to configure input filters, and is
sufficient for output filters where you need a static filter chain.
Relevant directives are
<code class="directive"><a href="./mod/core.html#setinputfilter">SetInputFilter</a></code>,
<code class="directive"><a href="./mod/core.html#setoutputfilter">SetOutputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>,
<code class="directive"><a href="./mod/mod_mime.html#removeinputfilter">RemoveInputFilter</a></code>, and
<code class="directive"><a href="./mod/mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></code>.</p>
<p>The Dynamic Way enables both static and flexible, dynamic configuration
of output filters, as discussed in the <code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> page.
Relevant directives are
<code class="directive"><a href="./mod/mod_filter.html#filterchain">FilterChain</a></code>,
<code class="directive"><a href="./mod/mod_filter.html#filterdeclare">FilterDeclare</a></code>, and
<code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code>.</p>
<p>One further directive <code class="directive"><a href="./mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code> is still supported,
but deprecated. Use dynamic configuration instead.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/filter.html" title="English"> en </a> |
<a href="./es/filter.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/filter.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/filter.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/filter.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/filter.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/filter.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/custom-error.html.en 0000664 0001751 0001751 00000033121 14737241666 020777 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Custom Error Responses - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Custom Error Responses</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/custom-error.html" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Although the Apache HTTP Server provides generic error responses
in the event of 4xx or 5xx HTTP status codes, these responses are
rather stark, uninformative, and can be intimidating to site users.
You may wish to provide custom error responses which are either
friendlier, or in some language other than English, or perhaps which
are styled more in line with your site layout.</p>
<p>Customized error responses can be defined for any HTTP status
code designated as an error condition - that is, any 4xx or 5xx
status.</p>
<p>Additionally, a set of values are provided, so
that the error document can be customized further based on the
values of these variables, using <a href="howto/ssi.html">Server
Side Includes</a>. Or, you can have error conditions handled by a
cgi program, or other dynamic handler (PHP, mod_perl, etc) which
makes use of these variables.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuration</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#variables">Available Variables</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#custom">Customizing Error Responses</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#multi-lang">Multi Language Custom Error Documents</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="configuration" id="configuration">Configuration</a></h2>
<p>Custom error documents are configured using the <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> directive,
which may be used in global,
virtualhost, or directory context. It may be used in .htaccess files
if <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> is set to
FileInfo.</p>
<pre class="prettyprint lang-config">ErrorDocument 500 "Sorry, our script crashed. Oh dear"
ErrorDocument 500 /cgi-bin/crash-recover
ErrorDocument 500 http://error.example.com/server_error.html
ErrorDocument 404 /errors/not_found.html
ErrorDocument 401 /subscription/how_to_subscribe.html</pre>
<p>The syntax of the <code>ErrorDocument</code> directive is:</p>
<pre class="prettyprint lang-config">ErrorDocument <3-digit-code> <action></pre>
<p>where the action will be treated as:</p>
<ol>
<li>A local URL to redirect to (if the action begins with a "/").</li>
<li>An external URL to redirect to (if the action is a valid URL).</li>
<li>Text to be displayed (if none of the above). The text must be
wrapped in quotes (") if it consists of more than one word.</li>
</ol>
<p>When redirecting to a local URL, additional environment variables
are set so that the response can be further customized. They are not sent to
external URLs.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="variables" id="variables">Available Variables</a></h2>
<p>Redirecting to another URL can be useful, but only if some
information can be passed which can then be used to explain or log
the error condition more clearly.</p>
<p>To achieve this, when the error redirect is sent, additional
environment variables will be set, which will be generated from
the headers provided to the original request by prepending
'REDIRECT_' onto the original header name. This provides the error
document the context of the original request.</p>
<p>For example, you might receive, in addition to more usual
environment variables, the following.</p>
<div class="example"><p><code>
REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/jpeg, image/png<br />
REDIRECT_HTTP_USER_AGENT=Mozilla/5.0 Fedora/3.5.8-1.fc12 Firefox/3.5.8<br />
REDIRECT_PATH=.:/bin:/usr/local/bin:/sbin<br />
REDIRECT_QUERY_STRING=<br />
REDIRECT_REMOTE_ADDR=121.345.78.123<br />
REDIRECT_REMOTE_HOST=client.example.com<br />
REDIRECT_SERVER_NAME=www.example.edu<br />
REDIRECT_SERVER_PORT=80<br />
REDIRECT_SERVER_SOFTWARE=Apache/2.2.15<br />
REDIRECT_URL=/cgi-bin/buggy.pl
</code></p></div>
<p><code>REDIRECT_</code> environment variables are created from
the environment variables which existed prior to the
redirect. They are renamed with a <code>REDIRECT_</code>
prefix, <em>i.e.</em>, <code>HTTP_USER_AGENT</code> becomes
<code>REDIRECT_HTTP_USER_AGENT</code>.</p>
<p><code>REDIRECT_URL</code>, <code>REDIRECT_STATUS</code>, and
<code>REDIRECT_QUERY_STRING</code> are guaranteed to be set, and
the other headers will be set only if they existed prior to the
error condition.</p>
<p><strong>None</strong> of these will be
set if the <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> target is an
<em>external</em> redirect (anything starting with a
scheme name like <code>http:</code>, even if it refers to the same host
as the server).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="custom" id="custom">Customizing Error Responses</a></h2>
<p>If you point your <code>ErrorDocument</code> to some variety of
dynamic handler such as a server-side include document, CGI
script, or some variety of other handler, you may wish to use the
available custom environment variables to customize this
response.</p>
<p>If the ErrorDocument specifies a local redirect to a CGI
script, the script should include a "<code>Status:</code>"
header field in its output in order to ensure the propagation
all the way back to the client of the error condition that
caused it to be invoked. For instance, a Perl ErrorDocument
script might include the following:</p>
<pre class="prettyprint lang-perl">...
print "Content-type: text/html\n";
printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"};
...</pre>
<p>If the script is dedicated to handling a particular error
condition, such as <code>404 Not Found</code>, it can
use the specific code and error text instead.</p>
<p>Note that if the response contains <code>Location:</code>
header (in order to issue a client-side redirect), the script
<em>must</em> emit an appropriate <code>Status:</code> header
(such as <code>302 Found</code>). Otherwise the
<code>Location:</code> header may have no effect.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="multi-lang" id="multi-lang">Multi Language Custom Error Documents</a></h2>
<p>Provided with your installation of the Apache HTTP Server is a
directory of custom error documents translated into 16 different
languages. There's also a configuration file in the
<code>conf/extra</code> configuration directory that can be included
to enable this feature.</p>
<p>In your server configuration file, you'll see a line such as:</p>
<pre class="prettyprint lang-config"># Multi-language error messages
#Include conf/extra/httpd-multilang-errordoc.conf</pre>
<p>Uncommenting this <code>Include</code> line will enable this
feature, and provide language-negotiated error messages, based on
the language preference set in the client browser.</p>
<p>Additionally, these documents contain various of the
<code>REDIRECT_</code> variables, so that additional information can
be provided to the end-user about what happened, and what they can
do now.</p>
<p>These documents can be customized to whatever degree you wish to
provide more useful information to users about your site, and what
they can expect to find there.</p>
<p><code class="module"><a href="./mod/mod_include.html">mod_include</a></code> and <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>
must be enabled to use this feature.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/custom-error.html" title="English"> en </a> |
<a href="./es/custom-error.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/custom-error.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sitemap.html.en 0000664 0001751 0001751 00000063615 14737542416 020010 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Sitemap - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div>
<div id="page-content"><div id="preamble"><h1>Sitemap</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>This page lists the currently available documents of the
<a href="./">Apache HTTP Server Version 2.4
Documentation</a>.</p>
</div>
<div id="quickview"><ul id="toc">
<li><img alt="" src="./images/down.gif" /> <a href="#release">Release Notes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#using">Using the Apache HTTP Server</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#vhosts">Apache Virtual Host documentation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rewrite">URL Rewriting Guide</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#ssl">Apache SSL/TLS Encryption</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#howto">Guides, Tutorials, and HowTos</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#platform">Platform-specific Notes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Apache HTTP Server and Supporting Programs</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#misc">Apache Miscellaneous Documentation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Apache modules</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Developer Documentation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#index">Glossary and Index</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="release" id="release">Release Notes</a></h2>
<ul><li><a href="upgrading.html">Upgrading to 2.4 from 2.2</a></li>
<li><a href="new_features_2_4.html">New features with Apache 2.3/2.4</a></li>
<li><a href="new_features_2_2.html">New features with Apache 2.1/2.2</a></li>
<li><a href="new_features_2_0.html">New features with Apache 2.0</a></li>
<li><a href="license.html">Apache License</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="using" id="using">Using the Apache HTTP Server</a></h2>
<ul><li><a href="install.html">Compiling and Installing Apache</a></li>
<li><a href="invoking.html">Starting Apache</a></li>
<li><a href="stopping.html">Stopping and Restarting the Server</a></li>
<li><a href="configuring.html">Configuration Files</a></li>
<li><a href="sections.html">How Directory, Location and Files sections work</a></li>
<li><a href="caching.html">Content Caching</a></li>
<li><a href="server-wide.html">Server-Wide Configuration</a></li>
<li><a href="logs.html">Log Files</a></li>
<li><a href="urlmapping.html">Mapping URLs to Filesystem Locations</a></li>
<li><a href="dso.html">Dynamic Shared Object (DSO) support</a></li>
<li><a href="content-negotiation.html">Content Negotiation</a></li>
<li><a href="custom-error.html">Custom error responses</a></li>
<li><a href="bind.html">Setting which addresses and ports Apache uses</a></li>
<li><a href="mpm.html">Multi-Processing Modules (MPMs)</a></li>
<li><a href="env.html">Environment Variables in Apache</a></li>
<li><a href="expr.html">Expression Parsing in Apache</a></li>
<li><a href="handler.html">Apache's Handler Use</a></li>
<li><a href="filter.html">Filters</a></li>
<li><a href="socache.html">Shared Object Cache Support</a></li>
<li><a href="suexec.html">suEXEC Support</a></li>
<li><a href="dns-caveats.html">Issues Regarding DNS and Apache</a></li>
<li><a href="http://wiki.apache.org/httpd/FAQ">Frequently Asked Questions</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="vhosts" id="vhosts">Apache Virtual Host documentation</a></h2>
<ul><li class="separate"><a href="vhosts/">Overview</a></li>
<li><a href="vhosts/name-based.html">Name-based Virtual Hosts</a></li>
<li><a href="vhosts/ip-based.html">IP-based Virtual Host Support</a></li>
<li><a href="vhosts/mass.html">Dynamically configured mass virtual hosting</a></li>
<li><a href="vhosts/examples.html">VirtualHost Examples</a></li>
<li><a href="vhosts/details.html">An In-Depth Discussion of Virtual Host Matching</a></li>
<li><a href="vhosts/fd-limits.html">File descriptor limitations</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="rewrite" id="rewrite">URL Rewriting Guide</a></h2>
<ul><li class="separate"><a href="rewrite/">Overview</a></li>
<li><a href="mod/mod_rewrite.html">mod_rewrite reference
documentation</a></li>
<li><a href="rewrite/intro.html">Introduction to regular expressions and
mod_rewrite</a></li>
<li><a href="rewrite/remapping.html">Using mod_rewrite for redirection and
remapping of URLs</a></li>
<li><a href="rewrite/access.html">Using mod_rewrite to control access</a></li>
<li><a href="rewrite/vhosts.html">Dynamic virtual hosts with mod_rewrite</a></li>
<li><a href="rewrite/proxy.html">Dynamic proxying with mod_rewrite</a></li>
<li><a href="rewrite/rewritemap.html">Using RewriteMap</a></li>
<li><a href="rewrite/advanced.html">Advanced techniques</a></li>
<li><a href="rewrite/avoid.html">When NOT to use mod_rewrite</a></li>
<li><a href="rewrite/flags.html">RewriteRule Flags</a></li>
<li><a href="rewrite/tech.html">Technical details</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="ssl" id="ssl">Apache SSL/TLS Encryption</a></h2>
<ul><li class="separate"><a href="ssl/">Overview</a></li>
<li><a href="ssl/ssl_intro.html">SSL/TLS Encryption: An Introduction</a></li>
<li><a href="ssl/ssl_compat.html">SSL/TLS Encryption: Compatibility</a></li>
<li><a href="ssl/ssl_howto.html">SSL/TLS Encryption: How-To</a></li>
<li><a href="ssl/ssl_faq.html">SSL/TLS Encryption: FAQ</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="howto" id="howto">Guides, Tutorials, and HowTos</a></h2>
<ul><li class="separate"><a href="howto/">Overview</a></li>
<li><a href="howto/auth.html">Authentication and Authorization</a></li>
<li><a href="howto/access.html">Access Control</a></li>
<li><a href="howto/cgi.html">Dynamic Content with CGI</a></li>
<li><a href="howto/ssi.html">Introduction to Server Side Includes</a></li>
<li><a href="howto/htaccess.html">.htaccess files</a></li>
<li><a href="howto/public_html.html">Per-user web directories</a></li>
<li><a href="howto/reverse_proxy.html">Reverse proxy setup guide</a></li>
<li><a href="howto/http2.html">HTTP/2 guide</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="platform" id="platform">Platform-specific Notes</a></h2>
<ul><li class="separate"><a href="platform/">Overview</a></li>
<li><a href="platform/windows.html">Using Apache with Microsoft
Windows</a></li>
<li><a href="platform/win_compiling.html">Compiling Apache for
Microsoft Windows</a></li>
<li><a href="platform/rpm.html">Using Apache With RPM Based Systems</a></li>
<li><a href="platform/netware.html">Using Apache with Novell NetWare</a></li>
<li><a href="platform/perf-hp.html">Running a High-Performance Web
Server on HPUX</a></li>
<li><a href="platform/ebcdic.html">The Apache EBCDIC Port</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="programs" id="programs">Apache HTTP Server and Supporting Programs</a></h2>
<ul><li class="separate"><a href="programs/">Overview</a></li>
<li><a href="programs/httpd.html">Manual Page: httpd</a></li>
<li><a href="programs/ab.html">Manual Page: ab</a></li>
<li><a href="programs/apachectl.html">Manual Page: apachectl</a></li>
<li><a href="programs/apxs.html">Manual Page: apxs</a></li>
<li><a href="programs/configure.html">Manual Page: configure</a></li>
<li><a href="programs/dbmmanage.html">Manual Page: dbmmanage</a></li>
<li><a href="programs/fcgistarter.html">Manual Page: fcgistarter</a></li>
<li><a href="programs/htcacheclean.html">Manual Page: htcacheclean</a></li>
<li><a href="programs/htdbm.html">Manual Page: htdbm</a></li>
<li><a href="programs/htdigest.html">Manual Page: htdigest</a></li>
<li><a href="programs/htpasswd.html">Manual Page: htpasswd</a></li>
<li><a href="programs/httxt2dbm.html">Manual Page: httxt2dbm</a></li>
<li><a href="programs/logresolve.html">Manual Page: logresolve</a></li>
<li><a href="programs/log_server_status.html">Manual Page:
log_server_status</a></li>
<li><a href="programs/rotatelogs.html">Manual Page: rotatelogs</a></li>
<li><a href="programs/split-logfile.html">Manual Page: split-logfile</a></li>
<li><a href="programs/suexec.html">Manual Page: suexec</a></li>
<li><a href="programs/other.html">Other Programs</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="misc" id="misc">Apache Miscellaneous Documentation</a></h2>
<ul><li class="separate"><a href="misc/">Overview</a></li>
<li><a href="misc/perf-tuning.html">Performance Notes - Apache Tuning</a></li>
<li><a href="misc/security_tips.html">Security Tips</a></li>
<li><a href="misc/relevant_standards.html">Relevant Standards</a></li>
<li><a href="misc/password_encryptions.html">Password Encryption Formats</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="modules" id="modules">Apache modules</a></h2>
<ul><li><a href="mod/module-dict.html">Definitions of terms used to describe Apache modules</a></li>
<li><a href="mod/directive-dict.html">Definitions of terms used to describe Apache directives</a></li>
</ul><ul><li><a href="mod/core.html">Apache Core Features</a></li>
<li><a href="mod/mpm_common.html">Apache MPM Common Directives</a></li>
<li><a href="mod/event.html">Apache MPM event</a></li>
<li><a href="mod/mpm_netware.html">Apache MPM netware</a></li>
<li><a href="mod/mpmt_os2.html">Apache MPM os2</a></li>
<li><a href="mod/prefork.html">Apache MPM prefork</a></li>
<li><a href="mod/mpm_winnt.html">Apache MPM winnt</a></li>
<li><a href="mod/worker.html">Apache MPM worker</a></li>
</ul><ul><li><a href="mod/mod_access_compat.html">Apache Module mod_access_compat</a></li>
<li><a href="mod/mod_actions.html">Apache Module mod_actions</a></li>
<li><a href="mod/mod_alias.html">Apache Module mod_alias</a></li>
<li><a href="mod/mod_allowmethods.html">Apache Module mod_allowmethods</a></li>
<li><a href="mod/mod_asis.html">Apache Module mod_asis</a></li>
<li><a href="mod/mod_auth_basic.html">Apache Module mod_auth_basic</a></li>
<li><a href="mod/mod_auth_digest.html">Apache Module mod_auth_digest</a></li>
<li><a href="mod/mod_auth_form.html">Apache Module mod_auth_form</a></li>
<li><a href="mod/mod_authn_anon.html">Apache Module mod_authn_anon</a></li>
<li><a href="mod/mod_authn_core.html">Apache Module mod_authn_core</a></li>
<li><a href="mod/mod_authn_dbd.html">Apache Module mod_authn_dbd</a></li>
<li><a href="mod/mod_authn_dbm.html">Apache Module mod_authn_dbm</a></li>
<li><a href="mod/mod_authn_file.html">Apache Module mod_authn_file</a></li>
<li><a href="mod/mod_authn_socache.html">Apache Module mod_authn_socache</a></li>
<li><a href="mod/mod_authnz_fcgi.html">Apache Module mod_authnz_fcgi</a></li>
<li><a href="mod/mod_authnz_ldap.html">Apache Module mod_authnz_ldap</a></li>
<li><a href="mod/mod_authz_core.html">Apache Module mod_authz_core</a></li>
<li><a href="mod/mod_authz_dbd.html">Apache Module mod_authz_dbd</a></li>
<li><a href="mod/mod_authz_dbm.html">Apache Module mod_authz_dbm</a></li>
<li><a href="mod/mod_authz_groupfile.html">Apache Module mod_authz_groupfile</a></li>
<li><a href="mod/mod_authz_host.html">Apache Module mod_authz_host</a></li>
<li><a href="mod/mod_authz_owner.html">Apache Module mod_authz_owner</a></li>
<li><a href="mod/mod_authz_user.html">Apache Module mod_authz_user</a></li>
<li><a href="mod/mod_autoindex.html">Apache Module mod_autoindex</a></li>
<li><a href="mod/mod_brotli.html">Apache Module mod_brotli</a></li>
<li><a href="mod/mod_buffer.html">Apache Module mod_buffer</a></li>
<li><a href="mod/mod_cache.html">Apache Module mod_cache</a></li>
<li><a href="mod/mod_cache_disk.html">Apache Module mod_cache_disk</a></li>
<li><a href="mod/mod_cache_socache.html">Apache Module mod_cache_socache</a></li>
<li><a href="mod/mod_cern_meta.html">Apache Module mod_cern_meta</a></li>
<li><a href="mod/mod_cgi.html">Apache Module mod_cgi</a></li>
<li><a href="mod/mod_cgid.html">Apache Module mod_cgid</a></li>
<li><a href="mod/mod_charset_lite.html">Apache Module mod_charset_lite</a></li>
<li><a href="mod/mod_data.html">Apache Module mod_data</a></li>
<li><a href="mod/mod_dav.html">Apache Module mod_dav</a></li>
<li><a href="mod/mod_dav_fs.html">Apache Module mod_dav_fs</a></li>
<li><a href="mod/mod_dav_lock.html">Apache Module mod_dav_lock</a></li>
<li><a href="mod/mod_dbd.html">Apache Module mod_dbd</a></li>
<li><a href="mod/mod_deflate.html">Apache Module mod_deflate</a></li>
<li><a href="mod/mod_dialup.html">Apache Module mod_dialup</a></li>
<li><a href="mod/mod_dir.html">Apache Module mod_dir</a></li>
<li><a href="mod/mod_dumpio.html">Apache Module mod_dumpio</a></li>
<li><a href="mod/mod_echo.html">Apache Module mod_echo</a></li>
<li><a href="mod/mod_env.html">Apache Module mod_env</a></li>
<li><a href="mod/mod_example_hooks.html">Apache Module mod_example_hooks</a></li>
<li><a href="mod/mod_expires.html">Apache Module mod_expires</a></li>
<li><a href="mod/mod_ext_filter.html">Apache Module mod_ext_filter</a></li>
<li><a href="mod/mod_file_cache.html">Apache Module mod_file_cache</a></li>
<li><a href="mod/mod_filter.html">Apache Module mod_filter</a></li>
<li><a href="mod/mod_headers.html">Apache Module mod_headers</a></li>
<li><a href="mod/mod_heartbeat.html">Apache Module mod_heartbeat</a></li>
<li><a href="mod/mod_heartmonitor.html">Apache Module mod_heartmonitor</a></li>
<li><a href="mod/mod_http2.html">Apache Module mod_http2</a></li>
<li><a href="mod/mod_ident.html">Apache Module mod_ident</a></li>
<li><a href="mod/mod_imagemap.html">Apache Module mod_imagemap</a></li>
<li><a href="mod/mod_include.html">Apache Module mod_include</a></li>
<li><a href="mod/mod_info.html">Apache Module mod_info</a></li>
<li><a href="mod/mod_isapi.html">Apache Module mod_isapi</a></li>
<li><a href="mod/mod_lbmethod_bybusyness.html">Apache Module mod_lbmethod_bybusyness</a></li>
<li><a href="mod/mod_lbmethod_byrequests.html">Apache Module mod_lbmethod_byrequests</a></li>
<li><a href="mod/mod_lbmethod_bytraffic.html">Apache Module mod_lbmethod_bytraffic</a></li>
<li><a href="mod/mod_lbmethod_heartbeat.html">Apache Module mod_lbmethod_heartbeat</a></li>
<li><a href="mod/mod_ldap.html">Apache Module mod_ldap</a></li>
<li><a href="mod/mod_log_config.html">Apache Module mod_log_config</a></li>
<li><a href="mod/mod_log_debug.html">Apache Module mod_log_debug</a></li>
<li><a href="mod/mod_log_forensic.html">Apache Module mod_log_forensic</a></li>
<li><a href="mod/mod_logio.html">Apache Module mod_logio</a></li>
<li><a href="mod/mod_lua.html">Apache Module mod_lua</a></li>
<li><a href="mod/mod_macro.html">Apache Module mod_macro</a></li>
<li><a href="mod/mod_md.html">Apache Module mod_md</a></li>
<li><a href="mod/mod_mime.html">Apache Module mod_mime</a></li>
<li><a href="mod/mod_mime_magic.html">Apache Module mod_mime_magic</a></li>
<li><a href="mod/mod_negotiation.html">Apache Module mod_negotiation</a></li>
<li><a href="mod/mod_nw_ssl.html">Apache Module mod_nw_ssl</a></li>
<li><a href="mod/mod_privileges.html">Apache Module mod_privileges</a></li>
<li><a href="mod/mod_proxy.html">Apache Module mod_proxy</a></li>
<li><a href="mod/mod_proxy_ajp.html">Apache Module mod_proxy_ajp</a></li>
<li><a href="mod/mod_proxy_balancer.html">Apache Module mod_proxy_balancer</a></li>
<li><a href="mod/mod_proxy_connect.html">Apache Module mod_proxy_connect</a></li>
<li><a href="mod/mod_proxy_express.html">Apache Module mod_proxy_express</a></li>
<li><a href="mod/mod_proxy_fcgi.html">Apache Module mod_proxy_fcgi</a></li>
<li><a href="mod/mod_proxy_fdpass.html">Apache Module mod_proxy_fdpass</a></li>
<li><a href="mod/mod_proxy_ftp.html">Apache Module mod_proxy_ftp</a></li>
<li><a href="mod/mod_proxy_hcheck.html">Apache Module mod_proxy_hcheck</a></li>
<li><a href="mod/mod_proxy_html.html">Apache Module mod_proxy_html</a></li>
<li><a href="mod/mod_proxy_http.html">Apache Module mod_proxy_http</a></li>
<li><a href="mod/mod_proxy_http2.html">Apache Module mod_proxy_http2</a></li>
<li><a href="mod/mod_proxy_scgi.html">Apache Module mod_proxy_scgi</a></li>
<li><a href="mod/mod_proxy_uwsgi.html">Apache Module mod_proxy_uwsgi</a></li>
<li><a href="mod/mod_proxy_wstunnel.html">Apache Module mod_proxy_wstunnel</a></li>
<li><a href="mod/mod_ratelimit.html">Apache Module mod_ratelimit</a></li>
<li><a href="mod/mod_reflector.html">Apache Module mod_reflector</a></li>
<li><a href="mod/mod_remoteip.html">Apache Module mod_remoteip</a></li>
<li><a href="mod/mod_reqtimeout.html">Apache Module mod_reqtimeout</a></li>
<li><a href="mod/mod_request.html">Apache Module mod_request</a></li>
<li><a href="mod/mod_rewrite.html">Apache Module mod_rewrite</a></li>
<li><a href="mod/mod_sed.html">Apache Module mod_sed</a></li>
<li><a href="mod/mod_session.html">Apache Module mod_session</a></li>
<li><a href="mod/mod_session_cookie.html">Apache Module mod_session_cookie</a></li>
<li><a href="mod/mod_session_crypto.html">Apache Module mod_session_crypto</a></li>
<li><a href="mod/mod_session_dbd.html">Apache Module mod_session_dbd</a></li>
<li><a href="mod/mod_setenvif.html">Apache Module mod_setenvif</a></li>
<li><a href="mod/mod_slotmem_plain.html">Apache Module mod_slotmem_plain</a></li>
<li><a href="mod/mod_slotmem_shm.html">Apache Module mod_slotmem_shm</a></li>
<li><a href="mod/mod_so.html">Apache Module mod_so</a></li>
<li><a href="mod/mod_socache_dbm.html">Apache Module mod_socache_dbm</a></li>
<li><a href="mod/mod_socache_dc.html">Apache Module mod_socache_dc</a></li>
<li><a href="mod/mod_socache_memcache.html">Apache Module mod_socache_memcache</a></li>
<li><a href="mod/mod_socache_redis.html">Apache Module mod_socache_redis</a></li>
<li><a href="mod/mod_socache_shmcb.html">Apache Module mod_socache_shmcb</a></li>
<li><a href="mod/mod_speling.html">Apache Module mod_speling</a></li>
<li><a href="mod/mod_ssl.html">Apache Module mod_ssl</a></li>
<li><a href="mod/mod_status.html">Apache Module mod_status</a></li>
<li><a href="mod/mod_substitute.html">Apache Module mod_substitute</a></li>
<li><a href="mod/mod_suexec.html">Apache Module mod_suexec</a></li>
<li><a href="mod/mod_systemd.html">Apache Module mod_systemd</a></li>
<li><a href="mod/mod_unique_id.html">Apache Module mod_unique_id</a></li>
<li><a href="mod/mod_unixd.html">Apache Module mod_unixd</a></li>
<li><a href="mod/mod_userdir.html">Apache Module mod_userdir</a></li>
<li><a href="mod/mod_usertrack.html">Apache Module mod_usertrack</a></li>
<li><a href="mod/mod_version.html">Apache Module mod_version</a></li>
<li><a href="mod/mod_vhost_alias.html">Apache Module mod_vhost_alias</a></li>
<li><a href="mod/mod_watchdog.html">Apache Module mod_watchdog</a></li>
<li><a href="mod/mod_xml2enc.html">Apache Module mod_xml2enc</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="developer" id="developer">Developer Documentation</a></h2>
<ul><li class="separate"><a href="developer/">Overview</a></li>
<li><a href="developer/API.html">Apache API notes</a></li>
<li><a href="developer/new_api_2_4.html">API updates in Apache HTTPD 2.4</a></li>
<li><a href="developer/modguide.html">Developing modules for Apache HTTPD 2.4</a></li>
<li><a href="developer/documenting.html">Documenting Apache HTTPD</a></li>
<li><a href="developer/hooks.html">Apache 2.x Hook Functions</a></li>
<li><a href="developer/modules.html">Converting Modules from 1.3 to 2.x</a></li>
<li><a href="developer/request.html">Request Processing in 2.x</a></li>
<li><a href="developer/filters.html">How Filters Work in 2.x</a></li>
<li><a href="developer/output-filters.html">Guidelines for output filters in 2.x</a></li>
<li><a href="developer/thread_safety.html">Thread Safety Issues in 2.x</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="index" id="index">Glossary and Index</a></h2>
<ul><li><a href="glossary.html">Glossary</a></li>
<li><a href="mod/">Module index</a></li>
<li><a href="mod/directives.html">Directive index</a></li>
<li><a href="mod/quickreference.html">Directive Quick-Reference</a></li>
<li><a href="mod/overrides.html">Override class index for .htaccess</a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./de/sitemap.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/sitemap.html" title="English"> en </a> |
<a href="./es/sitemap.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/sitemap.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sitemap.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sitemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sitemap.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/sitemap.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sitemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/content-negotiation.html.en 0000664 0001751 0001751 00000103404 14737241666 022330 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Content Negotiation - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Content Negotiation</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/content-negotiation.html" title="English"> en </a> |
<a href="./fr/content-negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Apache HTTPD supports content negotiation as described in
the HTTP/1.1 specification. It can choose the best
representation of a resource based on the browser-supplied
preferences for media type, languages, character set and
encoding. It also implements a couple of features to give
more intelligent handling of requests from browsers that send
incomplete negotiation information.</p>
<p>Content negotiation is provided by the
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> module, which is compiled in
by default.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#about">About Content Negotiation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#negotiation">Negotiation in httpd</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#methods">The Negotiation Methods</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#better">Fiddling with Quality
Values</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extensions">Extensions to Transparent Content
Negotiation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#naming">Note on hyperlinks and naming conventions</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#caching">Note on Caching</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="about" id="about">About Content Negotiation</a></h2>
<p>A resource may be available in several different
representations. For example, it might be available in
different languages or different media types, or a combination.
One way of selecting the most appropriate choice is to give the
user an index page, and let them select. However it is often
possible for the server to choose automatically. This works
because browsers can send, as part of each request, information
about what representations they prefer. For example, a browser
could indicate that it would like to see information in French,
if possible, else English will do. Browsers indicate their
preferences by headers in the request. To request only French
representations, the browser would send</p>
<div class="example"><p><code>Accept-Language: fr</code></p></div>
<p>Note that this preference will only be applied when there is
a choice of representations and they vary by language.</p>
<p>As an example of a more complex request, this browser has
been configured to accept French and English, but prefer
French, and to accept various media types, preferring HTML over
plain text or other text types, and preferring GIF or JPEG over
other media types, but also allowing any other media type as a
last resort:</p>
<div class="example"><p><code>
Accept-Language: fr; q=1.0, en; q=0.5<br />
Accept: text/html; q=1.0, text/*; q=0.8, image/gif; q=0.6, image/jpeg; q=0.6, image/*; q=0.5, */*; q=0.1
</code></p></div>
<p>httpd supports 'server driven' content negotiation, as
defined in the HTTP/1.1 specification. It fully supports the
<code>Accept</code>, <code>Accept-Language</code>,
<code>Accept-Charset</code> and <code>Accept-Encoding</code>
request headers. httpd also supports 'transparent'
content negotiation, which is an experimental negotiation
protocol defined in RFC 2295 and RFC 2296. It does not offer
support for 'feature negotiation' as defined in these RFCs.</p>
<p>A <strong>resource</strong> is a conceptual entity
identified by a URI (RFC 2396). An HTTP server like Apache HTTP Server
provides access to <strong>representations</strong> of the
resource(s) within its namespace, with each representation in
the form of a sequence of bytes with a defined media type,
character set, encoding, etc. Each resource may be associated
with zero, one, or more than one representation at any given
time. If multiple representations are available, the resource
is referred to as <strong>negotiable</strong> and each of its
representations is termed a <strong>variant</strong>. The ways
in which the variants for a negotiable resource vary are called
the <strong>dimensions</strong> of negotiation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="negotiation" id="negotiation">Negotiation in httpd</a></h2>
<p>In order to negotiate a resource, the server needs to be
given information about each of the variants. This is done in
one of two ways:</p>
<ul>
<li>Using a type map (<em>i.e.</em>, a <code>*.var</code>
file) which names the files containing the variants
explicitly, or</li>
<li>Using a 'MultiViews' search, where the server does an
implicit filename pattern match and chooses from among the
results.</li>
</ul>
<h3><a name="type-map" id="type-map">Using a type-map file</a></h3>
<p>A type map is a document which is associated with the handler
named <code>type-map</code> (or, for backwards-compatibility with
older httpd configurations, the <a class="glossarylink" href="./glossary.html#mime-type" title="see glossary">MIME-type</a>
<code>application/x-type-map</code>). Note that to use this
feature, you must have a handler set in the configuration that
defines a file suffix as <code>type-map</code>; this is best done
with</p>
<pre class="prettyprint lang-config">AddHandler type-map .var</pre>
<p>in the server configuration file.</p>
<p>Type map files should have the same name as the resource
which they are describing, followed by the extension
<code>.var</code>. In the examples shown below, the resource is
named <code>foo</code>, so the type map file is named
<code>foo.var</code>.</p>
<p>This file should have an entry for each available
variant; these entries consist of contiguous HTTP-format header
lines. Entries for different variants are separated by blank
lines. Blank lines are illegal within an entry. It is
conventional to begin a map file with an entry for the combined
entity as a whole (although this is not required, and if
present will be ignored). An example map file is shown below.</p>
<p>URIs in this file are relative to the location of the type map
file. Usually, these files will be located in the same directory as
the type map file, but this is not required. You may provide
absolute or relative URIs for any file located on the same server as
the map file.</p>
<div class="example"><p><code>
URI: foo<br />
<br />
URI: foo.en.html<br />
Content-type: text/html<br />
Content-language: en<br />
<br />
URI: foo.fr.de.html<br />
Content-type: text/html;charset=iso-8859-2<br />
Content-language: fr, de<br />
</code></p></div>
<p>Note also that a typemap file will take precedence over the
filename's extension, even when Multiviews is on. If the
variants have different source qualities, that may be indicated
by the "qs" parameter to the media type, as in this picture
(available as JPEG, GIF, or ASCII-art): </p>
<div class="example"><p><code>
URI: foo<br />
<br />
URI: foo.jpeg<br />
Content-type: image/jpeg; qs=0.8<br />
<br />
URI: foo.gif<br />
Content-type: image/gif; qs=0.5<br />
<br />
URI: foo.txt<br />
Content-type: text/plain; qs=0.01<br />
</code></p></div>
<p>qs values can vary in the range 0.000 to 1.000. Note that
any variant with a qs value of 0.000 will never be chosen.
Variants with no 'qs' parameter value are given a qs factor of
1.0. The qs parameter indicates the relative 'quality' of this
variant compared to the other available variants, independent
of the client's capabilities. For example, a JPEG file is
usually of higher source quality than an ASCII file if it is
attempting to represent a photograph. However, if the resource
being represented is an original ASCII art, then an ASCII
representation would have a higher source quality than a JPEG
representation. A qs value is therefore specific to a given
variant depending on the nature of the resource it
represents.</p>
<p>The full list of headers recognized is available in the <a href="mod/mod_negotiation.html#typemaps">mod_negotiation
typemap</a> documentation.</p>
<h3><a name="multiviews" id="multiviews">Multiviews</a></h3>
<p><code>MultiViews</code> is a per-directory option, meaning it
can be set with an <code class="directive"><a href="./mod/core.html#options">Options</a></code>
directive within a <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code> or <code class="directive"><a href="./mod/core.html#files"><Files></a></code> section in
<code>httpd.conf</code>, or (if <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> is properly set) in
<code>.htaccess</code> files. Note that <code>Options All</code>
does not set <code>MultiViews</code>; you have to ask for it by
name.</p>
<p>The effect of <code>MultiViews</code> is as follows: if the
server receives a request for <code>/some/dir/foo</code>, if
<code>/some/dir</code> has <code>MultiViews</code> enabled, and
<code>/some/dir/foo</code> does <em>not</em> exist, then the
server reads the directory looking for files named foo.*, and
effectively fakes up a type map which names all those files,
assigning them the same media types and content-encodings it
would have if the client had asked for one of them by name. It
then chooses the best match to the client's requirements.</p>
<p><code>MultiViews</code> may also apply to searches for the file
named by the <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> directive, if the
server is trying to index a directory. If the configuration files
specify</p>
<pre class="prettyprint lang-config">DirectoryIndex index</pre>
<p>then the server will arbitrate between <code>index.html</code>
and <code>index.html3</code> if both are present. If neither
are present, and <code>index.cgi</code> is there, the server
will run it.</p>
<p>If one of the files found when reading the directory does not
have an extension recognized by <code>mod_mime</code> to designate
its Charset, Content-Type, Language, or Encoding, then the result
depends on the setting of the <code class="directive"><a href="./mod/mod_mime.html#multiviewsmatch">MultiViewsMatch</a></code> directive. This
directive determines whether handlers, filters, and other
extension types can participate in MultiViews negotiation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="methods" id="methods">The Negotiation Methods</a></h2>
<p>After httpd has obtained a list of the variants for a given
resource, either from a type-map file or from the filenames in
the directory, it invokes one of two methods to decide on the
'best' variant to return, if any. It is not necessary to know
any of the details of how negotiation actually takes place in
order to use httpd's content negotiation features. However the
rest of this document explains the methods used for those
interested. </p>
<p>There are two negotiation methods:</p>
<ol>
<li><strong>Server driven negotiation with the httpd
algorithm</strong> is used in the normal case. The httpd
algorithm is explained in more detail below. When this
algorithm is used, httpd can sometimes 'fiddle' the quality
factor of a particular dimension to achieve a better result.
The ways httpd can fiddle quality factors is explained in
more detail below.</li>
<li><strong>Transparent content negotiation</strong> is used
when the browser specifically requests this through the
mechanism defined in RFC 2295. This negotiation method gives
the browser full control over deciding on the 'best' variant,
the result is therefore dependent on the specific algorithms
used by the browser. As part of the transparent negotiation
process, the browser can ask httpd to run the 'remote
variant selection algorithm' defined in RFC 2296.</li>
</ol>
<h3><a name="dimensions" id="dimensions">Dimensions of Negotiation</a></h3>
<table>
<tr valign="top">
<th>Dimension</th>
<th>Notes</th>
</tr>
<tr valign="top">
<td>Media Type</td>
<td>Browser indicates preferences with the <code>Accept</code>
header field. Each item can have an associated quality factor.
Variant description can also have a quality factor (the "qs"
parameter).</td>
</tr>
<tr valign="top">
<td>Language</td>
<td>Browser indicates preferences with the
<code>Accept-Language</code> header field. Each item can have
a quality factor. Variants can be associated with none, one or
more than one language.</td>
</tr>
<tr valign="top">
<td>Encoding</td>
<td>Browser indicates preference with the
<code>Accept-Encoding</code> header field. Each item can have
a quality factor.</td>
</tr>
<tr valign="top">
<td>Charset</td>
<td>Browser indicates preference with the
<code>Accept-Charset</code> header field. Each item can have a
quality factor. Variants can indicate a charset as a parameter
of the media type.</td>
</tr>
</table>
<h3><a name="algorithm" id="algorithm">httpd Negotiation Algorithm</a></h3>
<p>httpd can use the following algorithm to select the 'best'
variant (if any) to return to the browser. This algorithm is
not further configurable. It operates as follows:</p>
<ol>
<li>First, for each dimension of the negotiation, check the
appropriate <em>Accept*</em> header field and assign a
quality to each variant. If the <em>Accept*</em> header for
any dimension implies that this variant is not acceptable,
eliminate it. If no variants remain, go to step 4.</li>
<li>
Select the 'best' variant by a process of elimination. Each
of the following tests is applied in order. Any variants
not selected at each test are eliminated. After each test,
if only one variant remains, select it as the best match
and proceed to step 3. If more than one variant remains,
move on to the next test.
<ol>
<li>Multiply the quality factor from the <code>Accept</code>
header with the quality-of-source factor for this variants
media type, and select the variants with the highest
value.</li>
<li>Select the variants with the highest language quality
factor.</li>
<li>Select the variants with the best language match,
using either the order of languages in the
<code>Accept-Language</code> header (if present), or else
the order of languages in the <code>LanguagePriority</code>
directive (if present).</li>
<li>Select the variants with the highest 'level' media
parameter (used to give the version of text/html media
types).</li>
<li>Select variants with the best charset media
parameters, as given on the <code>Accept-Charset</code>
header line. Charset ISO-8859-1 is acceptable unless
explicitly excluded. Variants with a <code>text/*</code>
media type but not explicitly associated with a particular
charset are assumed to be in ISO-8859-1.</li>
<li>Select those variants which have associated charset
media parameters that are <em>not</em> ISO-8859-1. If
there are no such variants, select all variants
instead.</li>
<li>Select the variants with the best encoding. If there
are variants with an encoding that is acceptable to the
user-agent, select only these variants. Otherwise if
there is a mix of encoded and non-encoded variants,
select only the unencoded variants. If either all
variants are encoded or all variants are not encoded,
select all variants.</li>
<li>Select the variants with the smallest content
length.</li>
<li>Select the first variant of those remaining. This
will be either the first listed in the type-map file, or
when variants are read from the directory, the one whose
file name comes first when sorted using ASCII code
order.</li>
</ol>
</li>
<li>The algorithm has now selected one 'best' variant, so
return it as the response. The HTTP response header
<code>Vary</code> is set to indicate the dimensions of
negotiation (browsers and caches can use this information when
caching the resource). End.</li>
<li>To get here means no variant was selected (because none
are acceptable to the browser). Return a 406 status (meaning
"No acceptable representation") with a response body
consisting of an HTML document listing the available
variants. Also set the HTTP <code>Vary</code> header to
indicate the dimensions of variance.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="better" id="better">Fiddling with Quality
Values</a></h2>
<p>httpd sometimes changes the quality values from what would
be expected by a strict interpretation of the httpd
negotiation algorithm above. This is to get a better result
from the algorithm for browsers which do not send full or
accurate information. Some of the most popular browsers send
<code>Accept</code> header information which would otherwise
result in the selection of the wrong variant in many cases. If a
browser sends full and correct information these fiddles will not
be applied.</p>
<h3><a name="wildcards" id="wildcards">Media Types and Wildcards</a></h3>
<p>The <code>Accept:</code> request header indicates preferences
for media types. It can also include 'wildcard' media types, such
as "image/*" or "*/*" where the * matches any string. So a request
including:</p>
<div class="example"><p><code>Accept: image/*, */*</code></p></div>
<p>would indicate that any type starting "image/" is acceptable,
as is any other type.
Some browsers routinely send wildcards in addition to explicit
types they can handle. For example:</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*
</code></p></div>
<p>The intention of this is to indicate that the explicitly listed
types are preferred, but if a different representation is
available, that is ok too. Using explicit quality values,
what the browser really wants is something like:</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*; q=0.01
</code></p></div>
<p>The explicit types have no quality factor, so they default to a
preference of 1.0 (the highest). The wildcard */* is given a
low preference of 0.01, so other types will only be returned if
no variant matches an explicitly listed type.</p>
<p>If the <code>Accept:</code> header contains <em>no</em> q
factors at all, httpd sets the q value of "*/*", if present, to
0.01 to emulate the desired behavior. It also sets the q value of
wildcards of the format "type/*" to 0.02 (so these are preferred
over matches against "*/*". If any media type on the
<code>Accept:</code> header contains a q factor, these special
values are <em>not</em> applied, so requests from browsers which
send the explicit information to start with work as expected.</p>
<h3><a name="exceptions" id="exceptions">Language Negotiation Exceptions</a></h3>
<p>New in httpd 2.0, some exceptions have been added to the
negotiation algorithm to allow graceful fallback when language
negotiation fails to find a match.</p>
<p>When a client requests a page on your server, but the server
cannot find a single page that matches the
<code>Accept-language</code> sent by
the browser, the server will return either a "No Acceptable
Variant" or "Multiple Choices" response to the client. To avoid
these error messages, it is possible to configure httpd to ignore
the <code>Accept-language</code> in these cases and provide a
document that does not explicitly match the client's request. The
<code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code>
directive can be used to override one or both of these error
messages and substitute the servers judgement in the form of the
<code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>
directive.</p>
<p>The server will also attempt to match language-subsets when no
other match can be found. For example, if a client requests
documents with the language <code>en-GB</code> for British
English, the server is not normally allowed by the HTTP/1.1
standard to match that against a document that is marked as simply
<code>en</code>. (Note that it is almost surely a configuration
error to include <code>en-GB</code> and not <code>en</code> in the
<code>Accept-Language</code> header, since it is very unlikely
that a reader understands British English, but doesn't understand
English in general. Unfortunately, many current clients have
default configurations that resemble this.) However, if no other
language match is possible and the server is about to return a "No
Acceptable Variants" error or fallback to the <code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>, the server
will ignore the subset specification and match <code>en-GB</code>
against <code>en</code> documents. Implicitly, httpd will add
the parent language to the client's acceptable language list with
a very low quality value. But note that if the client requests
"en-GB; q=0.9, fr; q=0.8", and the server has documents
designated "en" and "fr", then the "fr" document will be returned.
This is necessary to maintain compliance with the HTTP/1.1
specification and to work effectively with properly configured
clients.</p>
<p>In order to support advanced techniques (such as cookies or
special URL-paths) to determine the user's preferred language,
since httpd 2.0.47 <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> recognizes
the <a href="env.html">environment variable</a>
<code>prefer-language</code>. If it exists and contains an
appropriate language tag, <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> will
try to select a matching variant. If there's no such variant,
the normal negotiation process applies.</p>
<div class="example"><h3>Example</h3><pre class="prettyprint lang-config">SetEnvIf Cookie "language=(.+)" prefer-language=$1
Header append Vary cookie</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="extensions" id="extensions">Extensions to Transparent Content
Negotiation</a></h2>
<p>httpd extends the transparent content negotiation protocol (RFC
2295) as follows. A new <code>{encoding ..}</code> element is used in
variant lists to label variants which are available with a specific
content-encoding only. The implementation of the RVSA/1.0 algorithm
(RFC 2296) is extended to recognize encoded variants in the list, and
to use them as candidate variants whenever their encodings are
acceptable according to the <code>Accept-Encoding</code> request
header. The RVSA/1.0 implementation does not round computed quality
factors to 5 decimal places before choosing the best variant.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="naming" id="naming">Note on hyperlinks and naming conventions</a></h2>
<p>If you are using language negotiation you can choose between
different naming conventions, because files can have more than
one extension, and the order of the extensions is normally
irrelevant (see the <a href="mod/mod_mime.html#multipleext">mod_mime</a> documentation
for details).</p>
<p>A typical file has a MIME-type extension (<em>e.g.</em>,
<code>html</code>), maybe an encoding extension (<em>e.g.</em>,
<code>gz</code>), and of course a language extension
(<em>e.g.</em>, <code>en</code>) when we have different
language variants of this file.</p>
<p>Examples:</p>
<ul>
<li>foo.en.html</li>
<li>foo.html.en</li>
<li>foo.en.html.gz</li>
</ul>
<p>Here some more examples of filenames together with valid and
invalid hyperlinks:</p>
<table class="bordered">
<tr>
<th>Filename</th>
<th>Valid hyperlink</th>
<th>Invalid hyperlink</th>
</tr>
<tr>
<td><em>foo.html.en</em></td>
<td>foo<br />
foo.html</td>
<td>-</td>
</tr>
<tr>
<td><em>foo.en.html</em></td>
<td>foo</td>
<td>foo.html</td>
</tr>
<tr>
<td><em>foo.html.en.gz</em></td>
<td>foo<br />
foo.html</td>
<td>foo.gz<br />
foo.html.gz</td>
</tr>
<tr>
<td><em>foo.en.html.gz</em></td>
<td>foo</td>
<td>foo.html<br />
foo.html.gz<br />
foo.gz</td>
</tr>
<tr>
<td><em>foo.gz.html.en</em></td>
<td>foo<br />
foo.gz<br />
foo.gz.html</td>
<td>foo.html</td>
</tr>
<tr>
<td><em>foo.html.gz.en</em></td>
<td>foo<br />
foo.html<br />
foo.html.gz</td>
<td>foo.gz</td>
</tr>
</table>
<p>Looking at the table above, you will notice that it is always
possible to use the name without any extensions in a hyperlink
(<em>e.g.</em>, <code>foo</code>). The advantage is that you
can hide the actual type of a document rsp. file and can change
it later, <em>e.g.</em>, from <code>html</code> to
<code>shtml</code> or <code>cgi</code> without changing any
hyperlink references.</p>
<p>If you want to continue to use a MIME-type in your
hyperlinks (<em>e.g.</em> <code>foo.html</code>) the language
extension (including an encoding extension if there is one)
must be on the right hand side of the MIME-type extension
(<em>e.g.</em>, <code>foo.html.en</code>).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="caching" id="caching">Note on Caching</a></h2>
<p>When a cache stores a representation, it associates it with
the request URL. The next time that URL is requested, the cache
can use the stored representation. But, if the resource is
negotiable at the server, this might result in only the first
requested variant being cached and subsequent cache hits might
return the wrong response. To prevent this, httpd normally
marks all responses that are returned after content negotiation
as non-cacheable by HTTP/1.0 clients. httpd also supports the
HTTP/1.1 protocol features to allow caching of negotiated
responses.</p>
<p>For requests which come from a HTTP/1.0 compliant client
(either a browser or a cache), the directive <code class="directive"><a href="./mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code> can be
used to allow caching of responses which were subject to
negotiation. This directive can be given in the server config or
virtual host, and takes no arguments. It has no effect on requests
from HTTP/1.1 clients.</p>
<p>For HTTP/1.1 clients, httpd sends a <code>Vary</code> HTTP
response header to indicate the negotiation dimensions for the
response. Caches can use this information to determine whether a
subsequent request can be served from the local copy. To
encourage a cache to use the local copy regardless of the
negotiation dimensions, set the <code>force-no-vary</code> <a href="env.html#special">environment variable</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/content-negotiation.html" title="English"> en </a> |
<a href="./fr/content-negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/content-negotiation.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/glossary.html.en 0000664 0001751 0001751 00000074020 14737241666 020204 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Glossary - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Glossary</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/glossary.html" title="English"> en </a> |
<a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/glossary.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/glossary.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This glossary defines some of the common terminology related to Apache in
particular, and web serving in general. More information on each concept
is provided in the links.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="definitions" id="definitions">Definitions</a></h2>
<dl>
<dt><a name="accesscontrol" id="accesscontrol">Access Control</a></dt>
<dd>The restriction of access to network realms. In an Apache context
usually the restriction of access to certain <em>URLs</em>.<br /> See: <a href="howto/auth.html">Authentication, Authorization, and Access
Control</a>
</dd>
<dt><a name="algorithm" id="algorithm">Algorithm</a></dt>
<dd>An unambiguous formula or set of rules for solving a problem in a finite
number of steps. Algorithms for encryption are usually called
<dfn>Ciphers</dfn>.
</dd>
<dt><a name="apacheextensiontool" id="apacheextensiontool">APache
eXtension Tool</a> <a name="apxs" id="apxs">(apxs)</a></dt>
<dd>A perl script that aids in compiling <a class="glossarylink" href="./glossary.html#module" title="see glossary">module</a> sources into Dynamic Shared Objects
(<a class="glossarylink" href="./glossary.html#dso" title="see glossary">DSO</a>s) and helps install them in the
Apache Web server.<br />
See: Manual Page: <code class="program"><a href="./programs/apxs.html">apxs</a></code>
</dd>
<dt><a name="apacheportableruntime" id="apacheportableruntime">Apache Portable Runtime</a> <a name="apr" id="apr">(APR)</a></dt>
<dd>A set of libraries providing many of the basic interfaces
between the server and the operating system. APR is developed
parallel to the Apache HTTP Server as an independent project.<br />
See: <a href="http://apr.apache.org/">Apache Portable Runtime
Project</a>
</dd>
<dt><a name="authentication" id="authentication">Authentication</a></dt>
<dd>The positive identification of a network entity such as a server, a
client, or a user.<br />
See: <a href="howto/auth.html">Authentication, Authorization, and Access
Control</a>
</dd>
<dt><a name="certificate" id="certificate">Certificate</a></dt>
<dd>A data record used for authenticating network entities such
as a server or a client. A certificate contains X.509 information pieces
about its owner (called the subject) and the signing <a class="glossarylink" href="./glossary.html#certificationauthority" title="see glossary">Certification Authority</a> (called
the issuer), plus the owner's <a class="glossarylink" href="./glossary.html#publickey" title="see glossary">public
key</a> and the
signature made by the CA. Network entities verify these signatures
using CA certificates.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="certificatsigningrequest" id="certificatsigningrequest">Certificate Signing Request</a>
<a name="csr" id="csr">(CSR)</a></dt>
<dd>An unsigned <a class="glossarylink" href="./glossary.html#certificate" title="see glossary">certificate</a> for
submission to a <a class="glossarylink" href="./glossary.html#certificationauthority" title="see glossary">Certification
Authority</a>, which signs it with the <a class="glossarylink" href="./glossary.html#privatekey" title="see glossary">Private Key</a> of their CA
<em>Certificate</em>. Once the CSR is signed, it becomes a real
certificate.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="certificationauthority" id="certificationauthority">Certification Authority</a>
<a name="ca" id="ca">(CA)</a></dt>
<dd>A trusted third party whose purpose is to sign certificates for network
entities it has authenticated using secure means. Other network entities
can check the signature to verify that a CA has authenticated the bearer
of a certificate.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="cipher" id="cipher">Cipher</a></dt>
<dd>An algorithm or system for data encryption. Examples are DES, IDEA, RC4,
etc.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="ciphertext" id="ciphertext">Ciphertext</a></dt>
<dd>The result after <a class="glossarylink" href="./glossary.html#plaintext" title="see glossary">Plaintext</a> is
passed through a <a class="glossarylink" href="./glossary.html#cipher" title="see glossary">Cipher</a>.<br /> See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="commongatewayinterface" id="commongatewayinterface">Common
Gateway Interface</a> <a name="cgi" id="cgi">(CGI)</a></dt>
<dd>A standard definition for an interface between a web server and an
external program that allows the external program to service requests.
There is an <a href="http://www.ietf.org/rfc/rfc3875">Informational
RFC</a> which covers the specifics.<br />
See: <a href="howto/cgi.html">Dynamic Content with CGI</a>
</dd>
<dt><a name="configurationdirective" id="configurationdirective">Configuration Directive</a></dt>
<dd>See: <a class="glossarylink" href="./glossary.html#directive" title="see glossary">Directive</a></dd>
<dt><a name="configurationfile" id="configurationfile">Configuration
File</a></dt>
<dd>A text file containing <a class="glossarylink" href="./glossary.html#directive" title="see glossary">Directives</a>
that control the configuration of Apache.<br />
See: <a href="configuring.html">Configuration Files</a>
</dd>
<dt><a name="connect" id="connect">CONNECT</a></dt>
<dd>An HTTP <a class="glossarylink" href="./glossary.html#method" title="see glossary">method</a> for proxying raw data
channels over HTTP. It can be used to encapsulate other protocols, such as
the SSL protocol.
</dd>
<dt><a name="context" id="context">Context</a></dt>
<dd>An area in the <a class="glossarylink" href="./glossary.html#configurationfile" title="see glossary">configuration
files</a> where certain types of <a class="glossarylink" href="./glossary.html#directive" title="see glossary">directives</a> are allowed.<br />
See: <a href="mod/directive-dict.html#Context">Terms Used to Describe
Apache Directives</a>
</dd>
<dt><a name="digitalsignature" id="digitalsignature">Digital
Signature</a></dt>
<dd>An encrypted text block that validates a certificate or other file. A
<a class="glossarylink" href="./glossary.html#certificationauthority" title="see glossary">Certification Authority</a>
creates a signature by generating a hash of the <em>Public Key</em>
embedded in a <em>Certificate</em>, then encrypting the hash with its own
<em>Private Key</em>. Only the CA's public key can decrypt the signature,
verifying that the CA has authenticated the network entity that owns the
<em>Certificate</em>.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="directive" id="directive">Directive</a></dt>
<dd>A configuration command that controls one or more aspects of Apache's
behavior. Directives are placed in the <a class="glossarylink" href="./glossary.html#configurationfile" title="see glossary">Configuration File</a><br />
See: <a href="mod/directives.html">Directive Index</a>
</dd>
<dt><a name="dynamicsharedobject" id="dynamicsharedobject">Dynamic
Shared Object</a> <a name="dso" id="dso">(DSO)</a></dt>
<dd><a class="glossarylink" href="./glossary.html#module" title="see glossary">Modules</a> compiled separately from the
Apache <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary that can be loaded on-demand.<br />
See: <a href="dso.html">Dynamic Shared Object Support</a>
</dd>
<dt><a name="environmentvariable" id="environmentvariable">Environment
Variable</a> <a name="env-variable" id="env-variable">(env-variable)</a></dt>
<dd>Named variables managed by the operating system shell and used to store
information and communicate between programs. Apache also contains
internal variables that are referred to as environment variables, but are
stored in internal Apache structures, rather than in the shell
environment.<br />
See: <a href="env.html">Environment Variables in Apache</a>
</dd>
<dt><a name="export-crippled" id="export-crippled">Export-Crippled</a></dt>
<dd>Diminished in cryptographic strength (and security) in order to comply
with the United States' Export Administration Regulations (EAR).
Export-crippled cryptographic software is limited to a small key size,
resulting in <em>Ciphertext</em> which usually can be decrypted by brute
force.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="filter" id="filter">Filter</a></dt>
<dd>A process that is applied to data that is sent or received by the
server. Input filters process data sent by the client to the server,
while output filters process documents on the server before they are sent
to the client. For example, the <code>INCLUDES</code> output filter
processes documents for <a class="glossarylink" href="./glossary.html#ssi" title="see glossary">Server Side
Includes</a>.<br />
See: <a href="filter.html">Filters</a>
</dd>
<dt><a name="fully-qualifieddomain-name" id="fully-qualifieddomain-name">Fully-Qualified Domain-Name</a>
<a name="fqdn" id="fqdn">(FQDN)</a></dt>
<dd>The unique name of a network entity, consisting of a hostname and a
domain name that can resolve to an IP address. For example,
<code>www</code> is a hostname, <code>example.com</code> is a domain name,
and <code>www.example.com</code> is a fully-qualified domain name.
</dd>
<dt><a name="handler" id="handler">Handler</a></dt>
<dd>An internal Apache representation of the action to be performed when a
file is called. Generally, files have implicit handlers, based on the file
type. Normally, all files are simply served by the server, but certain
file types are "handled" separately. For example, the
<code>cgi-script</code> handler designates files to be processed as
<a class="glossarylink" href="./glossary.html#cgi" title="see glossary">CGIs</a>.<br />
See: <a href="handler.html">Apache's Handler Use</a>
</dd>
<dt><a name="hash" id="hash">Hash</a></dt>
<dd>A mathematical one-way, irreversible algorithm generating a string with
fixed-length from another string of any length. Different input strings
will usually produce different hashes (depending on the hash function).
</dd>
<dt><a name="header" id="header">Header</a></dt>
<dd>The part of the <a class="glossarylink" href="./glossary.html#http" title="see glossary">HTTP</a> request and
response that is sent before the actual content, and that contains
meta-information describing the content.
</dd>
<dt><a name="htaccess" id="htaccess">.htaccess</a></dt>
<dd>A <a class="glossarylink" href="./glossary.html#configurationfile" title="see glossary">configuration file</a> that
is placed inside the web tree and applies configuration <a class="glossarylink" href="./glossary.html#directive" title="see glossary">directives</a> to the directory where it is
placed and all sub-directories. Despite its name, this file can hold
almost any type of directive, not just access-control directives.<br />
See: <a href="configuring.html">Configuration Files</a>
</dd>
<dt><a name="httpd.conf" id="httpd.conf">httpd.conf</a></dt>
<dd>The main Apache <a class="glossarylink" href="./glossary.html#configurationfile" title="see glossary">configuration
file</a>. The default location is
<code>/usr/local/apache2/conf/httpd.conf</code>, but it may be moved using
run-time or compile-time configuration.<br />
See: <a href="configuring.html">Configuration Files</a>
</dd>
<dt><a name="hypertexttransferprotocol" id="hypertexttransferprotocol">HyperText Transfer Protocol</a>
<a name="http" id="hhtp">(HTTP)</a></dt>
<dd>The standard transmission protocol used on the World Wide Web. Apache
implements version 1.1 of the protocol, referred to as HTTP/1.1 and
defined by <a href="http://ietf.org/rfc/rfc2616.txt">RFC 2616</a>.
</dd>
<dt><a name="https" id="https">HTTPS</a></dt>
<dd>The HyperText Transfer Protocol (Secure), the standard encrypted
communication mechanism on the World Wide Web. This is actually just HTTP
over <a class="glossarylink" href="./glossary.html#ssl" title="see glossary">SSL</a>.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="method" id="method">Method</a></dt>
<dd>In the context of <a class="glossarylink" href="./glossary.html#http" title="see glossary">HTTP</a>, an action to
perform on a resource, specified on the request line by the client. Some
of the methods available in HTTP are <code>GET</code>, <code>POST</code>,
and <code>PUT</code>.
</dd>
<dt><a name="messagedigest" id="messagedigest">Message Digest</a></dt>
<dd>A hash of a message, which can be used to verify that the contents of
the message have not been altered in transit.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="mime-type" id="mime-type">MIME-type</a></dt>
<dd>A way to describe the kind of document being transmitted. Its name
comes from that fact that its format is borrowed from the Multipurpose
Internet Mail Extensions. It consists of a major type and a minor type,
separated by a slash. Some examples are <code>text/html</code>,
<code>image/gif</code>, and <code>application/octet-stream</code>. In
HTTP, the MIME-type is transmitted in the <code>Content-Type</code>
<a class="glossarylink" href="./glossary.html#header" title="see glossary">header</a>.<br />
See: <a href="mod/mod_mime.html">mod_mime</a>
</dd>
<dt><a name="module" id="module">Module</a></dt>
<dd>An independent part of a program. Much of Apache's functionality is
contained in modules that you can choose to include or exclude. Modules
that are compiled into the Apache <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary are
called <dfn>static modules</dfn>, while modules that are stored
separately and can be optionally loaded at run-time are called
<dfn>dynamic modules</dfn> or <a class="glossarylink" href="./glossary.html#dso" title="see glossary">DSOs</a>.
Modules that are included by default
are called <dfn>base modules</dfn>. Many modules are available for Apache
that are not distributed as part of the Apache HTTP Server <a class="glossarylink" href="./glossary.html#tarball" title="see glossary">tarball</a>. These are referred to as
<dfn>third-party modules</dfn>.<br />
See: <a href="mod/">Module Index</a>
</dd>
<dt><a name="modulemagicnumber" id="modulemagicnumber">Module Magic
Number</a> (<a name="mmn" id="mmn">MMN</a>)</dt>
<dd>Module Magic Number is a constant defined in the Apache source code that
is associated with binary compatibility of modules. It is changed when
internal Apache structures, function calls and other significant parts of
API change in such a way that binary compatibility cannot be guaranteed
any more. On MMN change, all third party modules have to be at least
recompiled, sometimes even slightly changed in order to work with the new
version of Apache.
</dd>
<dt><a name="openssl" id="openssl">OpenSSL</a></dt>
<dd>The Open Source toolkit for SSL/TLS<br />
See <a href="http://www.openssl.org/">http://www.openssl.org/</a>#
</dd>
<dt><a name="passphrase" id="passphrase">Pass Phrase</a></dt>
<dd>The word or phrase that protects private key files. It prevents
unauthorized users from encrypting them. Usually it's just the secret
encryption/decryption key used for <a class="glossarylink" href="./glossary.html#cipher" title="see glossary">Ciphers</a>.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="plaintext" id="plaintext">Plaintext</a></dt>
<dd>The unencrypted text.</dd>
<dt><a name="privatekey" id="privatekey">Private Key</a></dt>
<dd>The secret key in a <a class="glossarylink" href="./glossary.html#publickeycryptography" title="see glossary">Public Key
Cryptography</a> system, used to decrypt incoming messages and
sign outgoing ones.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="proxy" id="proxy">Proxy</a></dt>
<dd>An intermediate server that sits between the client and the <em>origin
server</em>. It accepts requests from clients, transmits those requests
on to the origin server, and then returns the response from the origin
server to the client. If several clients request the same content, the
proxy can deliver that content from its cache, rather than requesting it
from the origin server each time, thereby reducing response time.<br />
See: <a href="mod/mod_proxy.html">mod_proxy</a>
</dd>
<dt><a name="publickey" id="publickey">Public Key</a></dt>
<dd>The publicly available key in a <a class="glossarylink" href="./glossary.html#publickeycryptography" title="see glossary">Public Key Cryptography</a> system,
used to encrypt messages bound for its owner and to decrypt signatures
made by its owner.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="publickeycryptography" id="publickeycryptography">Public Key Cryptography</a></dt>
<dd>The study and application of asymmetric encryption systems, which use
one key for encryption and another for decryption. A corresponding pair of
such keys constitutes a key pair. Also called Asymmetric Cryptography.
<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="regularexpression" id="regularexpression">Regular Expression</a>
<a name="regex" id="regex">(Regex)</a></dt>
<dd>A way of describing a pattern in text - for example, "all the words that
begin with the letter A" or "every 10-digit phone number" or even "Every
sentence with two commas in it, and no capital letter Q". Regular
expressions are useful in Apache because they let you apply certain
attributes against collections of files or resources in very flexible ways
- for example, all .gif and .jpg files under any "images" directory could
be written as "<code>/images/.*(jpg|gif)$</code>". In places where
regular expressions are used to replace strings, the special variables
$1 ... $9 contain backreferences to the grouped parts (in parentheses) of
the matched expression. The special variable $0 contains a backreference
to the whole matched expression. To write a literal dollar sign in a
replacement string, it can be escaped with a backslash. Historically, the
variable & could be used as alias for $0 in some places. This is no
longer possible since version 2.3.6. Apache uses Perl Compatible Regular
Expressions provided by the <a href="http://www.pcre.org/">PCRE</a>
library. You can find more documentation about PCRE's regular expression
syntax at that site, or at
<a href="http://en.wikipedia.org/wiki/PCRE">Wikipedia</a>.
</dd>
<dt><a name="reverseproxy" id="reverseproxy">Reverse Proxy</a></dt>
<dd>A <a class="glossarylink" href="./glossary.html#proxy" title="see glossary">proxy</a> server that appears to the client
as if it is an <em>origin server</em>. This is useful to hide the real
origin server from the client for security reasons, or to load balance.
</dd>
<dt><a name="securesocketslayer" id="securesocketslayer">Secure Sockets
Layer</a> <a name="ssl" id="ssl">(SSL)</a></dt>
<dd>A protocol created by Netscape Communications Corporation for general
communication authentication and encryption over TCP/IP networks. The most
popular usage is <em>HTTPS</em>, i.e. the HyperText Transfer Protocol (HTTP)
over SSL.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="servernameindication" id="servernameindication">Server Name
Indication</a> <a name="sni" id="sni">(SNI)</a></dt>
<dd>An SSL function that allows passing the desired server
hostname in the initial SSL handshake message, so that the web
server can select the correct virtual host configuration to use
in processing the SSL handshake. It was added to SSL starting
with the TLS extensions, RFC 3546. <br />
See: <a href="ssl/ssl_faq.html">the SSL FAQ</a>
and <a href="http://www.ietf.org/rfc/rfc3546.txt">RFC 3546</a>
</dd>
<dt><a name="serversideincludes" id="serversideincludes">Server Side
Includes</a> <a name="ssi" id="ssi">(SSI)</a></dt>
<dd>A technique for embedding processing directives inside HTML files.<br />
See: <a href="howto/ssi.html">Introduction to Server Side Includes</a>
</dd>
<dt><a name="session" id="session">Session</a></dt>
<dd>The context information of a communication in general.</dd>
<dt><a name="ssleay" id="ssleay">SSLeay</a></dt>
<dd>The original SSL/TLS implementation library developed by Eric A.
Young
</dd>
<dt><a name="subrequest" id="subrequest">Subrequest</a></dt>
<dd>Apache provides a subrequest API to modules that allows other
filesystem or URL paths to be partially or fully evaluated by
the server. Example consumers of this API are
<code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>,
<code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code>, and <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>.
</dd>
<dt><a name="symmetriccryptophraphy" id="symmetriccryptophraphy">Symmetric
Cryptography</a></dt>
<dd>The study and application of <em>Ciphers</em> that use a single secret key
for both encryption and decryption operations.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="tarball" id="tarball">Tarball</a></dt>
<dd>A package of files gathered together using the <code>tar</code> utility.
Apache distributions are stored in compressed tar archives or using
pkzip.
</dd>
<dt><a name="transportlayersecurity" id="transportlayersecurity">Transport
Layer Security</a> <a name="tls" id="tls">(TLS)</a></dt>
<dd>The successor protocol to SSL, created by the Internet Engineering Task
Force (IETF) for general communication authentication and encryption over
TCP/IP networks. TLS version 1 is nearly identical with SSL version 3.<br />
See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
<dt><a name="uniformresourcelocator" id="uniformresourcelocator">Uniform
Resource Locator</a> <a name="url" id="url">(URL)</a></dt>
<dd>The name/address of a resource on the Internet. This is the common
informal term for what is formally called a <a class="glossarylink" href="./glossary.html#uniformresourceidentifier" title="see glossary">Uniform Resource Identifier</a>.
URLs are usually made up of a scheme, like <code>http</code> or
<code>https</code>, a hostname, and a path. A URL for this page might
be <code>http://httpd.apache.org/docs/2.4/glossary.html</code>.
</dd>
<dt><a name="uniformresourceidentifier" id="uniformresourceidentifier">Uniform Resource Identifier</a>
<a name="URI" id="URI">(URI)</a></dt>
<dd>A compact string of characters for identifying an abstract or physical
resource. It is formally defined by <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a>. URIs used on the
world-wide web are commonly referred to as <a class="glossarylink" href="./glossary.html#url" title="see glossary">URLs</a>.
</dd>
<dt><a name="virtualhosting" id="virtualhosting">Virtual Hosting</a></dt>
<dd>Serving multiple websites using a single instance of Apache. <em>IP
virtual hosting</em> differentiates between websites based on their IP
address, while <em>name-based virtual hosting</em> uses only the name of the
host and can therefore host many sites on the same IP address.<br />
See: <a href="vhosts/">Apache Virtual Host documentation</a>
</dd>
<dt><a name="x.509" id="x.509">X.509</a></dt>
<dd>An authentication certificate scheme recommended by the International
Telecommunication Union (ITU-T) which is used for SSL/TLS authentication.<br /> See: <a href="ssl/">SSL/TLS Encryption</a>
</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./de/glossary.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/glossary.html" title="English"> en </a> |
<a href="./es/glossary.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/glossary.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/glossary.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/glossary.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/glossary.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/glossary.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/index.html.en 0000664 0001751 0001751 00000022156 14737241666 017453 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache HTTP Server Version 2.4
Documentation - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="index-page">
<div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></div>
<div class="up"><a href="http://httpd.apache.org/docs-project/"><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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a></div>
<div id="page-content"><h1>Apache HTTP Server Version 2.4
Documentation</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<form method="get" action="https://www.google.com/search"><p><input name="as_q" value="" type="text" /> <input value="Google Search" type="submit" /><input value="10" name="num" type="hidden" /><input value="en" name="hl" type="hidden" /><input value="UTF-8" name="ie" type="hidden" /><input value="Google Search" name="btnG" type="hidden" /><input name="as_epq" value="Version 2.4" type="hidden" /><input name="as_oq" value="" type="hidden" /><input name="as_eq" value=""List-Post"" type="hidden" /><input value="" name="lr" type="hidden" /><input value="i" name="as_ft" type="hidden" /><input value="" name="as_filetype" type="hidden" /><input value="all" name="as_qdr" type="hidden" /><input value="any" name="as_occt" type="hidden" /><input value="i" name="as_dt" type="hidden" /><input value="httpd.apache.org" name="as_sitesearch" type="hidden" /><input value="off" name="safe" type="hidden" /></p></form>
<table id="indextable"><tr><td class="col1"><div class="category"><h2><a name="release" id="release">Release Notes</a></h2>
<ul><li><a href="new_features_2_4.html">New features with Apache 2.3/2.4</a></li>
<li><a href="new_features_2_2.html">New features with Apache 2.1/2.2</a></li>
<li><a href="new_features_2_0.html">New features with Apache 2.0</a></li>
<li><a href="upgrading.html">Upgrading to 2.4 from 2.2</a></li>
<li><a href="license.html">Apache License</a></li>
</ul>
</div><div class="category"><h2><a name="manual" id="manual">Reference Manual</a></h2>
<ul><li><a href="install.html">Compiling and Installing</a></li>
<li><a href="invoking.html">Starting</a></li>
<li><a href="stopping.html">Stopping or Restarting</a></li>
<li><a href="mod/quickreference.html">Run-time Configuration Directives</a></li>
<li><a href="mod/">Modules</a></li>
<li><a href="mpm.html">Multi-Processing Modules (MPMs)</a></li>
<li><a href="filter.html">Filters</a></li>
<li><a href="handler.html">Handlers</a></li>
<li><a href="expr.html">Expression parser</a></li>
<li><a href="mod/overrides.html">Override Class Index for .htaccess</a></li>
<li><a href="programs/">Server and Supporting Programs</a></li>
<li><a href="glossary.html">Glossary</a></li>
</ul>
</div></td><td><div class="category"><h2><a name="usersguide" id="usersguide">Users' Guide</a></h2>
<ul><li><a href="getting-started.html">Getting Started</a></li>
<li><a href="bind.html">Binding to Addresses and Ports</a></li>
<li><a href="configuring.html">Configuration Files</a></li>
<li><a href="sections.html">Configuration Sections</a></li>
<li><a href="caching.html">Content Caching</a></li>
<li><a href="content-negotiation.html">Content Negotiation</a></li>
<li><a href="dso.html">Dynamic Shared Objects (DSO)</a></li>
<li><a href="env.html">Environment Variables</a></li>
<li><a href="logs.html">Log Files</a></li>
<li><a href="urlmapping.html">Mapping URLs to the Filesystem</a></li>
<li><a href="misc/perf-tuning.html">Performance Tuning</a></li>
<li><a href="misc/security_tips.html">Security Tips</a></li>
<li><a href="server-wide.html">Server-Wide Configuration</a></li>
<li><a href="ssl/">SSL/TLS Encryption</a></li>
<li><a href="suexec.html">Suexec Execution for CGI</a></li>
<li><a href="rewrite/">URL Rewriting with mod_rewrite</a></li>
<li><a href="vhosts/">Virtual Hosts</a></li>
</ul>
</div></td><td class="col3"><div class="category"><h2><a name="howto" id="howto">How-To / Tutorials</a></h2>
<ul><li><a href="howto/auth.html">Authentication and Authorization</a></li>
<li><a href="howto/access.html">Access Control</a></li>
<li><a href="howto/cgi.html">CGI: Dynamic Content</a></li>
<li><a href="howto/htaccess.html">.htaccess files</a></li>
<li><a href="howto/ssi.html">Server Side Includes (SSI)</a></li>
<li><a href="howto/public_html.html">Per-user Web Directories (public_html)</a></li>
<li><a href="howto/reverse_proxy.html">Reverse proxy setup guide</a></li>
<li><a href="howto/http2.html">HTTP/2 guide</a></li>
</ul>
</div><div class="category"><h2><a name="platform" id="platform">Platform Specific Notes</a></h2>
<ul><li><a href="platform/windows.html">Microsoft Windows</a></li>
<li><a href="platform/rpm.html">RPM-based Systems (Redhat / CentOS / Fedora)</a></li>
<li><a href="platform/netware.html">Novell NetWare</a></li>
<li><a href="platform/ebcdic.html">EBCDIC Port</a></li>
</ul>
</div><div class="category"><h2><a name="other" id="other">Other Topics</a></h2>
<ul><li><a href="http://wiki.apache.org/httpd/FAQ">Frequently Asked Questions</a></li>
<li><a href="sitemap.html">Sitemap</a></li>
<li><a href="developer/">Documentation for Developers</a></li>
<li><a href="http://httpd.apache.org/docs-project/">Helping with the documentation</a></li>
<li><a href="misc/">Other Notes</a></li>
<li><a href="http://wiki.apache.org/httpd/">Wiki</a></li>
</ul>
</div></td></tr></table></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./da/" hreflang="da" rel="alternate" title="Dansk"> da </a> |
<a href="./de/" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/" title="English"> en </a> |
<a href="./es/" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./ru/" hreflang="ru" rel="alternate" title="Russian"> ru </a> |
<a href="./tr/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/stopping.html.fr.utf8 0000664 0001751 0001751 00000047252 14740503670 021073 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="fr" xml:lang="fr"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Arrêt et redémarrage du serveur HTTP Apache - Serveur HTTP Apache Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png" /></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/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Arrêt et redémarrage du serveur HTTP Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Ce document couvre l'arrêt et le redémarrage du
serveur HTTP Apache sur
les systèmes Unix et similaires. Les utilisateurs de Windows NT, 2000
and XP doivent consulter
<a href="platform/windows.html#winsvc">Exécuter httpd en tant que
service</a> et les utilisateurs de Windows 9x et ME doivent consulter
<a href="platform/windows.html#wincons">Exécuter httpd comme une
application de type console</a> pour plus d'informations sur le contrôle
de httpd à partir de ces plateformes.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#term">Arrêter immédiatement</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#graceful">Redémarrage en douceur</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#hup">Redémarrer immédiatement</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#gracefulstop">Arrêt en douceur</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="invoking.html">Démarrage</a></li><li><a href="#comments_section">Commentaires</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="introduction" id="introduction">Introduction</a></h2>
<p>Afin d'arrêter ou redémarrer le serveur HTTP Apache, vous devez envoyer un signal aux
processus <code class="program"><a href="./programs/httpd.html">httpd</a></code> en cours d'exécution. Les signaux
peuvent être envoyés de deux manières. La
première méthode consiste à
utiliser la commande unix <code>kill</code>
pour envoyer directement des signaux aux processus. Vous pouvez remarquer
que plusieurs processus <code class="program"><a href="./programs/httpd.html">httpd</a></code> s'exécutent sur votre
système, mais il vous suffit d'envoyer les signaux au processus parent,
dont le PID est enregistré dans le fichier précisé par la directive
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>. Autrement dit, vous
n'aurez jamais besoin d'envoyer des signaux à aucun des
processus enfants, mais seulement au processus parent. Quatre types
de signaux peuvent être envoyés au processus parent :
<code><a href="#term">TERM</a></code>,
<code><a href="#graceful">USR1</a></code>,
<code><a href="#hup">HUP</a></code>, et
<code><a href="#gracefulstop">WINCH</a></code>, qui
seront décrit plus loin.</p>
<p>Pour envoyer un signal au processus parent, vous devez entrer une commande
du style :</p>
<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
<p>La seconde méthode permettant d'envoyer des signaux aux processus
<code class="program"><a href="./programs/httpd.html">httpd</a></code>
consiste à utiliser les options <code>stop</code>,
<code>restart</code>, <code>graceful</code> et
<code>graceful-stop</code> du commutateur <code>-k</code> de la ligne
de commande comme décrit ci-dessous. Ce sont des arguments du binaire
<code class="program"><a href="./programs/httpd.html">httpd</a></code>, mais il est recommandé de les utiliser
avec le script de contrôle <code class="program"><a href="./programs/apachectl.html">apachectl</a></code>, qui se
chargera de les passer à <code class="program"><a href="./programs/httpd.html">httpd</a></code>.</p>
<p>Après avoir envoyé un signal à <code class="program"><a href="./programs/httpd.html">httpd</a></code>, vous pouvez
suivre le cours de son action en entrant :</p>
<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
<p>Adaptez ces exemples en fonction de la définition de vos directives
<code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> et
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="term" id="term">Arrêter immédiatement</a></h2>
<dl><dt>Signal: TERM</dt>
<dd><code>apachectl -k stop</code></dd>
</dl>
<p>A la réception du signal <code>TERM</code> ou <code>stop</code>,
le processus parent tente immédiatement
de tuer tous ses processus enfants. Cela peut durer plusieurs secondes.
Après cela, le processus parent lui-même se termine. Toutes les requêtes
en cours sont terminées, et plus aucune autre n'est traitée.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="graceful" id="graceful">Redémarrage en douceur</a></h2>
<dl><dt>Signal: USR1</dt>
<dd><code>apachectl -k graceful</code></dd>
</dl>
<p>A la réception du signal <code>USR1</code> ou
<code>graceful</code>, le
processus parent envoie aux processus enfants
<em>l'ordre</em> de se terminer une fois leur requête courante
traitée (ou de se terminer immédiatement s'ils n'ont plus rien à traiter).
Le processus parent relit ses fichiers de configuration et
réouvre ses fichiers de log. Chaque fois qu'un enfant s'éteint, le
processus parent le remplace par un processus
enfant de la nouvelle <em>génération</em> de la
configuration, et celui-ci commence immédiatement à traiter les
nouvelles requêtes.</p>
<p>Ce code est conçu pour toujours respecter la directive de contrôle
de processus des modules MPMs, afin que les nombres de processus et de
threads
disponibles pour traiter les demandes des clients soient maintenus à
des valeurs appropriées tout au long du processus de démarrage.
En outre, il respecte la directive
<code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> de la manière
suivante : si après une seconde au moins <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> nouveaux processus
enfants n'ont pas été créés, un nombre suffisant de processus
supplémentaires est créé pour combler le manque. Ainsi le code
tente de maintenir à la fois le nombre approprié de processus enfants
en fonction de la charge du serveur, et le nombre de processus défini par la
directive <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>.</p>
<p>Les utilisateurs du module <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
noteront que les statistiques du serveur ne sont <strong>pas</strong>
remises à zéro quand un signal <code>USR1</code> est envoyé. Le code
a été conçu à la fois pour minimiser la durée durant laquelle le
serveur ne peut pas traiter de nouvelles requêtes (elle sont mises en
file d'attente par le système d'exploitation, et ne sont ainsi jamais
perdues) et pour respecter vos paramètres de personnalisation.
Pour y parvenir, il doit conserver le
<em>tableau</em> utilisé pour garder la trace de tous les processus
enfants au cours des différentes générations.</p>
<p>Dans son état des processus,
le module status utilise aussi un caractère <code>G</code> afin d'indiquer
quels processus enfants ont encore des traitements de requêtes en cours
débutés avant que l'ordre graceful restart ne soit donné.</p>
<p>Pour l'instant, il est impossible pour un script de rotation
des logs utilisant
<code>USR1</code> de savoir de manière certaine si tous les processus
enfants inscrivant des traces de pré-redémarrage sont terminés.
Nous vous suggérons d'attendre un délai suffisant après l'envoi du
signal <code>USR1</code>
avant de faire quoi que ce soit avec les anciens logs. Par exemple,
si la plupart de vos traitements durent moins de 10 minutes pour des
utilisateurs empruntant des liaisons à faible bande passante, alors vous
devriez attendre 15 minutes avant de faire quoi que ce soit
avec les anciens logs.</p>
<div class="note">
<p>Lorsque vous initiez un redémarrage, une vérification de
la syntaxe est tout d'abord effectuée, afin de s'assurer qu'il n'y a
pas d'erreurs dans les fichiers de configuration. Si votre fichier de
configuration comporte des erreurs de syntaxe, vous recevrez un message
d'erreur les concernant, et le serveur refusera de redémarrer. Ceci
permet d'éviter la situation où un serveur a
été arrêté et ne peut plus redémarrer,
et où vous vous retrouvez avec un serveur hors-service.</p>
<p>Ceci ne garantit pas encore que le serveur va redémarrer
correctement. Pour vérifier la sémantique des fichiers de configuration
en plus de leur syntaxe, vous pouvez essayer de démarrer
<code class="program"><a href="./programs/httpd.html">httpd</a></code> sous un utilisateur non root.
S'il n'y a pas d'erreur, il tentera d'ouvrir ses sockets et ses fichiers
de log et échouera car il n'a pas les privilèges root (ou parce que
l'instance actuelle de
<code class="program"><a href="./programs/httpd.html">httpd</a></code> est déjà associée à ces ports). S'il échoue
pour toute autre raison, il y a probablement une erreur dans le
fichier de configuration et celle-ci doit être corrigée avant de lancer
le redémarrage en douceur.</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="hup" id="hup">Redémarrer immédiatement</a></h2>
<dl><dt>Signal: HUP</dt>
<dd><code>apachectl -k restart</code></dd>
</dl>
<p>A la réception du signal <code>HUP</code> ou
<code>restart</code>, le
processus parent tue ses processus enfants comme pour le signal
<code>TERM</code>, mais le processus parent ne se termine pas.
Il relit ses fichiers de configuration, et réouvre ses fichiers de log.
Puis il donne naissance à un nouveau jeu de processus enfants
et continue de traiter les requêtes.</p>
<p>Les utilisateurs du module <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
noteront que les statistiques du serveur sont remises à zéro quand un
signal <code>HUP</code> est envoyé.</p>
<div class="note">Comme dans le cas d'un redémarrage "graceful", une
vérification de la syntaxe est effectuée avant que le
redémarrage ne soit tenté. Si votre fichier de configuration comporte
des erreurs de syntaxe, le redémarrage ne sera pas effectué, et
vous recevrez un message concernant ces erreurs.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="gracefulstop" id="gracefulstop">Arrêt en douceur</a></h2>
<dl><dt>Signal : WINCH</dt>
<dd><code>apachectl -k graceful-stop</code></dd>
</dl>
<p>A la réception du signal <code>WINCH</code> ou
<code>graceful-stop</code>, le
processus parent <em>ordonne</em> à ses processus enfants
de s'arrêter après le traitement de leur requête en cours
(ou de s'arrêter immédiatement s'ils n'ont plus de requête à traiter).
Le processus parent va alors supprimer son fichier
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> et cesser l'écoute
de tous ses ports. Le processus parent va continuer à s'exécuter,
et va surveiller les processus enfants
qui ont encore des requêtes à traiter. Lorsque tous les processus enfants
ont terminé leurs traitements et se sont arrêtés ou lorsque le délai
spécifié par la directive <code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> a été atteint,
le processus parent s'arrêtera à son tour. Si ce délai est atteint,
tout processus enfant encore en cours d'exécution se verra envoyer
le signal <code>TERM</code>
afin de le forcer à s'arrêter.</p>
<p>L'envoi du signal <code>TERM</code> va arrêter immédiatement
les processus parent et enfants en état "graceful". Cependant,
comme le fichier <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>
aura été supprimé, vous ne pourrez pas utiliser
<code>apachectl</code> ou <code>httpd</code> pour envoyer ce signal.</p>
<div class="note"><p>Le signal <code>graceful-stop</code> vous permet d'exécuter
simultanément plusieurs instances de <code class="program"><a href="./programs/httpd.html">httpd</a></code>
avec des configurations identiques. Ceci s'avère une fonctionnalité
puissante quand vous effectuez des mises à jour "en douceur"
de httpd ; cependant, cela peut aussi causer des blocages fatals et des
situations de compétition (race conditions)
avec certaines configurations.</p>
<p>On a pris soin de s'assurer que les fichiers sur disque
comme les fichiers verrou (<code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>) et les fichiers socket Unix
(<code class="directive"><a href="./mod/mod_cgid.html#scriptsock">ScriptSock</a></code>) contiennent le PID
du serveur, et coexistent sans problème. Cependant, si une directive de
configuration, un module tiers ou une CGI résidente utilise un autre
verrou ou fichier d'état sur disque, il faut prendre soin de s'assurer
que chaque instance de <code class="program"><a href="./programs/httpd.html">httpd</a></code> qui s'exécute
n'écrase pas les fichiers des autres instances.</p>
<p>Vous devez aussi prendre garde aux autres situations de compétition,
comme l'enregistrement des logs avec un transfert de ceux-ci
via un pipe vers le programme <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code>. Plusieurs instances
du programme <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> qui tentent d'effectuer
une rotation des mêmes fichiers de log en même temps peuvent détruire
mutuellement leurs propres fichiers de log.</p></div>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/stopping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/configuring.html.en 0000664 0001751 0001751 00000042557 14737241666 020665 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Configuration Files - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Configuration Files</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" title="English"> en </a> |
<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document describes the files used to configure Apache HTTP
Server.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#main">Main Configuration Files</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#syntax">Syntax of the Configuration Files</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Modules</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#scope">Scope of Directives</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#htaccess">.htaccess Files</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="main" id="main">Main Configuration Files</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#include">Include</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code></li></ul></td></tr></table>
<p>Apache HTTP Server is configured by placing <a href="mod/directives.html">directives</a> in plain text
configuration files. The main configuration file is usually called
<code>httpd.conf</code>. The location of this file is set at
compile-time, but may be overridden with the <code>-f</code>
command line flag. In addition, other configuration files may be
added using the <code class="directive"><a href="./mod/core.html#include">Include</a></code>
directive, and wildcards can be used to include many configuration
files. Any directive may be placed in any of these configuration
files. Changes to the main configuration files are only
recognized by httpd when it is started or restarted.</p>
<p>The server also reads a file containing mime document types;
the filename is set by the <code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code> directive,
and is <code>mime.types</code> by default.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="syntax" id="syntax">Syntax of the Configuration Files</a></h2>
<p>httpd configuration files contain one directive per line.
The backslash "\" may be used as the last character on a line
to indicate that the directive continues onto the next line.
There must be no other characters or white space between the
backslash and the end of the line.</p>
<p>Arguments to directives are separated by whitespace. If an
argument contains spaces, you must enclose that argument in quotes.</p>
<p>Directives in the configuration files are case-insensitive,
but arguments to directives are often case sensitive. Lines
that begin with the hash character "#" are considered
comments, and are ignored. Comments may <strong>not</strong> be
included on the same line as a configuration directive.
White space occurring before a directive is ignored, so
you may indent directives for clarity. Blank lines are also ignored.</p>
<p>The values of variables defined with the <code class="directive"><a href="./mod/core.html#define">Define</a></code> of or shell environment variables can
be used in configuration file lines using the syntax <code>${VAR}</code>.
If "VAR" is the name of a valid variable, the value of that variable is
substituted into that spot in the configuration file line, and processing
continues as if that text were found directly in the configuration file.
Variables defined with <code class="directive"><a href="./mod/core.html#define">Define</a></code> take
precedence over shell environment variables.
If the "VAR" variable is not found, the characters <code>${VAR}</code>
are left unchanged, and a warning is logged.
Variable names may not contain colon ":" characters, to avoid clashes with
<code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>'s syntax.</p>
<p>Only shell environment variables defined before the server is started
can be used in expansions. Environment variables defined in the
configuration file itself, for example with <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code>, take effect too late to be used for
expansions in the configuration file.</p>
<p>The maximum length of a line in normal configuration files, after
variable substitution and joining any continued lines, is approximately
16 MiB. In <a href="configuring.html#htaccess">.htaccess files</a>, the
maximum length is 8190 characters.</p>
<p>You can check your configuration files for syntax errors
without starting the server by using <code>apachectl
configtest</code> or the <code>-t</code> command line
option.</p>
<p>You can use <code class="module"><a href="./mod/mod_info.html">mod_info</a></code>'s <code>-DDUMP_CONFIG</code> to
dump the configuration with all included files and environment
variables resolved and all comments and non-matching
<code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> and
<code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> sections
removed. However, the output does not reflect the merging or overriding
that may happen for repeated directives.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="modules" id="modules">Modules</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
<p>httpd is a modular server. This implies that only the most
basic functionality is included in the core server. Extended
features are available through <a href="mod/">modules</a> which can be loaded
into httpd. By default, a <a href="mod/module-dict.html#Status">base</a> set of modules is
included in the server at compile-time. If the server is
compiled to use <a href="dso.html">dynamically loaded</a>
modules, then modules can be compiled separately and added at
any time using the <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
directive.
Otherwise, httpd must be recompiled to add or remove modules.
Configuration directives may be included conditional on a
presence of a particular module by enclosing them in an <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> block. However,
<code class="directive"><IfModule></code> blocks are not
required, and in some cases may mask the fact that you're missing an
important module.</p>
<p>To see which modules are currently compiled into the server,
you can use the <code>-l</code> command line option. You can also
see what modules are loaded dynamically using the <code>-M</code>
command line option.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="scope" id="scope">Scope of Directives</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>Directives placed in the main configuration files apply to
the entire server. If you wish to change the configuration for
only a part of the server, you can scope your directives by
placing them in <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#files"><Files></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code>, and <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>
sections. These sections limit the application of the
directives which they enclose to particular filesystem
locations or URLs. They can also be nested, allowing for very
fine grained configuration.</p>
<p>httpd has the capability to serve many different websites
simultaneously. This is called <a href="vhosts/">Virtual
Hosting</a>. Directives can also be scoped by placing them
inside <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
sections, so that they will only apply to requests for a
particular website.</p>
<p>Although most directives can be placed in any of these
sections, some directives do not make sense in some contexts.
For example, directives controlling process creation can only
be placed in the main server context. To find which directives
can be placed in which sections, check the <a href="mod/directive-dict.html#Context">Context</a> of the
directive. For further information, we provide details on <a href="sections.html">How Directory, Location and Files sections
work</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="htaccess" id="htaccess">.htaccess Files</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
<p>httpd allows for decentralized management of configuration
via special files placed inside the web tree. The special files
are usually called <code>.htaccess</code>, but any name can be
specified in the <code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code>
directive. Directives placed in <code>.htaccess</code> files
apply to the directory where you place the file, and all
sub-directories. The <code>.htaccess</code> files follow the
same syntax as the main configuration files. Since
<code>.htaccess</code> files are read on every request, changes
made in these files take immediate effect.</p>
<p>To find which directives can be placed in
<code>.htaccess</code> files, check the <a href="mod/directive-dict.html#Context">Context</a> of the
directive. The server administrator further controls what
directives may be placed in <code>.htaccess</code> files by
configuring the <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
directive in the main configuration files.</p>
<p>For more information on <code>.htaccess</code> files, see
the <a href="howto/htaccess.html">.htaccess tutorial</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/configuring.html" title="English"> en </a> |
<a href="./fr/configuring.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/configuring.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/getting-started.html.en 0000664 0001751 0001751 00000036336 14737241666 021456 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Getting Started - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Getting Started</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/getting-started.html" title="English"> en </a> |
<a href="./fr/getting-started.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ru/getting-started.html" hreflang="ru" rel="alternate" title="Russian"> ru </a></p>
</div>
<p>If you're completely new to the Apache HTTP Server, or even to running
a website at all, you might not know where to start, or what questions to
ask. This document walks you through the basics.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#clientserver">Clients, Servers, and URLs</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#dns">Hostnames and DNS</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuration Files and Directives</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#content">Web Site Content</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#logs">Log Files and Troubleshooting</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">What's next?</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="clientserver" id="clientserver">Clients, Servers, and URLs</a></h2>
<p>
Addresses on the Web are expressed with URLs - Uniform Resource Locators
- which specify a protocol (e.g. <code>http</code>), a servername (e.g.
<code>www.apache.org</code>), a URL-path (e.g.
<code>/docs/current/getting-started.html</code>), and possibly a query
string (e.g. <code>?arg=value</code>) used to pass additional
arguments to the server.
</p>
<p>A client (e.g., a web browser) connects to a server (e.g., your Apache HTTP Server),
with the specified protocol, and makes a <strong>request</strong> for a resource using the
URL-path.</p>
<p>The URL-path may represent any number of things on the server. It may
be a file (like <code>getting-started.html</code>) a handler (like <a href="mod/mod_status.html">server-status</a>) or some kind of program
file (like <code>index.php</code>). We'll discuss this more below in
the <a href="#content">Web Site Content</a> section.</p>
<p>
The server will send a <strong>response</strong> consisting of a status
code and, optionally, a response body.
The status code indicates whether the request was successful, and, if not, what
kind of error condition there was. This tells the client what it should
do with the response. You can read about the possible response codes in
<a href="http://wiki.apache.org/httpd/CommonHTTPStatusCodes">HTTP Server
wiki</a>.</p>
<p>Details of the transaction, and any error conditions, are written to
log files. This is discussed in greater detail below in the <a href="#logs">Logs Files and Troubleshooting</a> section.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="dns" id="dns">Hostnames and DNS</a></h2>
<p>In order to connect to a server, the client will first have to resolve
the servername to an IP address - the location on the Internet where the
server resides. Thus, in order for your web server to be reachable, it
is necessary that the servername be in DNS.</p>
<p>If you don't know how to do this, you'll need to contact your network
administrator, or Internet service provider, to perform this step for
you.</p>
<p>More than one hostname may point to the same IP address, and more
than one IP address can be attached to the same physical server. Thus, you
can run more than one web site on the same physical server, using a
feature called <a href="vhosts/">virtual hosts</a>.</p>
<p>If you are testing a server that is not Internet-accessible, you
can put host names in your hosts file in order to do local resolution.
For example, you might want to put a record in your hosts file to map a
request for <code>www.example.com</code> to your local system, for
testing purposes. This entry would look like:</p>
<div class="example"><p><code>
127.0.0.1 www.example.com
</code></p></div>
<p>A hosts file will probably be located at <code>/etc/hosts</code> or
<code>C:\Windows\system32\drivers\etc\hosts</code>.</p>
<p>You can read more about the hosts file at <a href="http://en.wikipedia.org/wiki/Hosts_(file)">Wikipedia.org/wiki/Hosts_(file)</a>, and
more about DNS at <a href="http://en.wikipedia.org/wiki/Domain_Name_System">Wikipedia.org/wiki/Domain_Name_System</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configuration" id="configuration">Configuration Files and Directives</a></h2>
<p>The Apache HTTP Server is configured via simple text files.
These files may be located any of a variety of places, depending on how
exactly you installed the server. Common locations for these files may
be found <a href="http://wiki.apache.org/httpd/DistrosDefaultLayout">in
the httpd wiki</a>. If you installed httpd from source, the default
location of the configuration files is
<code>/usr/local/apache2/conf</code>. The default configuration file is
usually called <code>httpd.conf</code>. This, too, can vary in
third-party distributions of the server.</p>
<p>The configuration is frequently broken into multiple smaller files,
for ease of management. These files are loaded via the <code class="directive"><a href="./mod/core.html#include">Include</a></code> directive. The names or locations of
these sub-files are not magical, and may vary greatly from one
installation to another. Arrange and subdivide these files as
makes the most sense to <strong>you</strong>. If the file arrangement
you have by default doesn't make sense to you, feel free to rearrange it.</p>
<p>The server is configured by placing <a href="mod/quickreference.html">configuration directives</a> in these
configuration files. A directive is a keyword followed by one or more
arguments that set its value.</p>
<p>The question of "<em>Where should I put that
directive?</em>" is generally answered by considering where you want a
directive to be effective. If it is a global setting, it should appear
in the configuration file, outside of any <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code>, <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>, or other section. If it is to
apply only to a particular directory, then it should go inside a
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> section referring to
that directory, and so on. See the <a href="sections.html">Configuration
Sections</a> document for further discussion of these sections.</p>
<p>In addition to the main configuration files, certain directives may go in
<code>.htaccess</code> files located in the content directories.
<code>.htaccess</code> files are primarily for people who do not have
access to the main server configuration file(s). You can read more about
<code>.htaccess</code> files in the <a href="howto/htaccess.html"><code>.htaccess</code> howto</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="content" id="content">Web Site Content</a></h2>
<p>Web site content can take many different forms, but may be broadly
divided into static and dynamic content.</p>
<p>Static content is things like HTML files, image files, CSS files,
and other files that reside in the filesystem. The <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> directive specifies where in your
filesystem you should place these files. This directive is either set
globally, or per virtual host. Look in your configuration file(s) to
determine how this is set for your server.</p>
<p>Typically, a document called <code>index.html</code> will be served
when a directory is requested without a file name being specified. For
example, if <code>DocumentRoot</code> is set to
<code>/var/www/html</code> and a request is made for
<code>http://www.example.com/work/</code>, the file
<code>/var/www/html/work/index.html</code> will be served to the
client.</p>
<p>Dynamic content is anything that is generated at request
time, and may change from one request to another. There are numerous
ways that dynamic content may be generated. Various <a href="handler.html">handlers</a> are available to generate content. <a href="howto/cgi.html">CGI programs</a> may be written to generate
content for your site.</p>
<p>Third-party modules like mod_php may be used to write code that does a
variety of things. Many third-party applications, written using a
variety of languages and tools, are available for download and
installation on your Apache HTTP Server. Support of these third-party
things is beyond the scope of this documentation, and you should find
their documentation or other support forums to answer your questions
about them.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="logs" id="logs">Log Files and Troubleshooting</a></h2>
<p>As an Apache HTTP Server administrator, your most valuable assets are
the log files, and, in particular, the error log. Troubleshooting any
problem without the error log is like driving with your eyes closed.</p>
<p>The location of the error log is defined by the <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> directive, which may be set globally,
or per virtual host. Entries in the error log tell you what went wrong,
and when. They often also tell you how to fix it. Each error log message
contains an error code, which you can search for online for even more
detailed descriptions of how to address the problem. You can also
configure your error log to contain a log ID which you can then
correlate to an access log entry, so that you can determine what request
caused the error condition.</p>
<p>You can read more about logging in the <a href="logs.html">logs
documentation</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">What's next?</a></h2>
<p>Once you have the prerequisites under your belt, it's time to move
on.</p>
<p>This document covers only the bare basics. We hope that this gets you
started, but there are many other things that you might need to
know.</p>
<ul>
<li><a href="http://httpd.apache.org/download.cgi">Download</a></li>
<li><a href="install.html">Install</a></li>
<li><a href="configuring.html">Configure</a></li>
<li><a href="invoking.html">Start</a></li>
<li><a href="http://wiki.apache.org/httpd/FAQ">Frequently Asked Questions</a></li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/getting-started.html" title="English"> en </a> |
<a href="./fr/getting-started.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ru/getting-started.html" hreflang="ru" rel="alternate" title="Russian"> ru </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/getting-started.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/logs.html.en 0000664 0001751 0001751 00000116034 14737241666 017307 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Log Files - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Log Files</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/logs.html" title="English"> en </a> |
<a href="./fr/logs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>In order to effectively manage a web server, it is necessary
to get feedback about the activity and performance of the
server as well as any problems that may be occurring. The Apache HTTP Server
provides very comprehensive and flexible logging
capabilities. This document describes how to configure its
logging capabilities, and how to understand what the logs
contain.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Overview</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#security">Security Warning</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errorlog">Error Log</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#permodule">Per-module logging</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#accesslog">Access Log</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rotation">Log Rotation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#piped">Piped Logs</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Virtual Hosts</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">Other Log Files</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="overview" id="overview">Overview</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td /></tr></table>
<p>
The Apache HTTP Server provides a variety of different mechanisms for
logging everything that happens on your server, from the initial
request, through the URL mapping process, to the final resolution of
the connection, including any errors that may have occurred in the
process. In addition to this, third-party modules may provide logging
capabilities, or inject entries into the existing log files, and
applications such as CGI programs, or PHP scripts, or other handlers,
may send messages to the server error log.
</p>
<p>
In this document we discuss the logging modules that are a standard
part of the http server.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Security Warning</a></h2>
<p>Anyone who can write to the directory where Apache httpd is
writing a log file can almost certainly gain access to the uid
that the server is started as, which is normally root. Do
<em>NOT</em> give people write access to the directory the logs
are stored in without being aware of the consequences; see the
<a href="misc/security_tips.html">security tips</a> document
for details.</p>
<p>In addition, log files may contain information supplied
directly by the client, without escaping. Therefore, it is
possible for malicious clients to insert control-characters in
the log files, so care must be taken in dealing with raw
logs.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errorlog" id="errorlog">Error Log</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code></li><li><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code></li></ul></td></tr></table>
<p>The server error log, whose name and location is set by the
<code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> directive, is the
most important log file. This is the place where Apache httpd
will send diagnostic information and record any errors that it
encounters in processing requests. It is the first place to
look when a problem occurs with starting the server or with the
operation of the server, since it will often contain details of
what went wrong and how to fix it.</p>
<p>The error log is usually written to a file (typically
<code>error_log</code> on Unix systems and
<code>error.log</code> on Windows and OS/2). On Unix systems it
is also possible to have the server send errors to
<code>syslog</code> or <a href="#piped">pipe them to a
program</a>.</p>
<p>The format of the error log is defined by the <code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code> directive, with which you
can customize what values are logged. A default is format defined
if you don't specify one. A typical log message follows:</p>
<div class="example"><p><code>
[Fri Sep 09 10:42:29.902022 2011] [core:error] [pid 35708:tid 4328636416]
[client 72.15.99.187] File does not exist: /usr/local/apache2/htdocs/favicon.ico
</code></p></div>
<p>The first item in the log entry is the date and time of the
message. The next is the module producing the message (core, in this
case) and the severity level of that message. This is followed by
the process ID and, if appropriate, the thread ID, of the process
that experienced the condition. Next, we have the client address
that made the request. And finally is the detailed error message,
which in this case indicates a request for a file that did not
exist.</p>
<p>A very wide variety of different messages can appear in the
error log. Most look similar to the example above. The error
log will also contain debugging output from CGI scripts. Any
information written to <code>stderr</code> by a CGI script will
be copied directly to the error log.</p>
<p>Putting a <code>%L</code> token in both the error log and the access
log will produce a log entry ID with which you can correlate the entry
in the error log with the entry in the access log. If
<code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code> is loaded, its unique request ID will be
used as the log entry ID, too.</p>
<p>During testing, it is often useful to continuously monitor
the error log for any problems. On Unix systems, you can
accomplish this using:</p>
<div class="example"><p><code>
tail -f error_log
</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="permodule" id="permodule">Per-module logging</a></h2>
<p>The <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> directive
allows you to specify a log severity level on a per-module basis. In
this way, if you are troubleshooting a problem with just one
particular module, you can turn up its logging volume without also
getting the details of other modules that you're not interested in.
This is particularly useful for modules such as
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> or <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> where you
want to know details about what it's trying to do.</p>
<p>Do this by specifying the name of the module in your
<code class="directive">LogLevel</code> directive:</p>
<pre class="prettyprint lang-config">LogLevel info rewrite:trace5</pre>
<p>This sets the main <code class="directive">LogLevel</code> to info, but
turns it up to <code>trace5</code> for
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
<div class="note">This replaces the per-module logging directives, such as
<code>RewriteLog</code>, that were present in earlier versions of
the server.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="accesslog" id="accesslog">Access Log</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li></ul></td></tr></table>
<p>The server access log records all requests processed by the
server. The location and content of the access log are
controlled by the <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
directive. The <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
directive can be used to simplify the selection of
the contents of the logs. This section describes how to configure the server
to record information in the access log.</p>
<p>Storing the information in the access log is only
the start of log management. The next step is to analyze this
information to produce useful statistics. Log analysis in
general is beyond the scope of this document, and not really
part of the job of the web server itself.
</p>
<p>Various versions of Apache httpd have used other modules and
directives to control access logging, including
mod_log_referer, mod_log_agent, and the
<code>TransferLog</code> directive. The <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> directive now subsumes
the functionality of all the older directives.</p>
<p>The format of the access log is highly configurable. The format
is specified using a format string that looks much like a C-style
printf(1) format string. Some examples are presented in the next
sections. For a complete list of the possible contents of the
format string, see the <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code> <a href="mod/mod_log_config.html#formats">format strings</a>.</p>
<h3><a name="common" id="common">Common Log Format</a></h3>
<p>A typical configuration for the access log might look as
follows.</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common</pre>
<p>This defines the <em>nickname</em> <code>common</code> and
associates it with a particular log format string. The format
string consists of percent directives, each of which tell the
server to log a particular piece of information. Literal
characters may also be placed in the format string and will be
copied directly into the log output. The quote character
(<code>"</code>) must be escaped by placing a backslash before
it to prevent it from being interpreted as the end of the
format string. The format string may also contain the special
control characters "<code>\n</code>" for new-line and
"<code>\t</code>" for tab.</p>
<p>The <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
directive sets up a new log file using the defined
<em>nickname</em>. The filename for the access log is relative to
the <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> unless it
begins with a slash.</p>
<p>The above configuration will write log entries in a format
known as the Common Log Format (CLF). This standard format can
be produced by many different web servers and read by many log
analysis programs. The log file entries produced in CLF will
look something like this:</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
</code></p></div>
<p>Each part of this log entry is described below.</p>
<dl>
<dt><code>127.0.0.1</code> (<code>%h</code>)</dt>
<dd>This is the IP address of the client (remote host) which
made the request to the server. If <code class="directive"><a href="./mod/core.html#hostnamelookups">HostnameLookups</a></code> is
set to <code>On</code>, then the server will try to determine
the hostname and log it in place of the IP address. However,
this configuration is not recommended since it can
significantly slow the server. Instead, it is best to use a
log post-processor such as <code class="program"><a href="./programs/logresolve.html">logresolve</a></code> to determine
the hostnames. The IP address reported here is not
necessarily the address of the machine at which the user is
sitting. If a proxy server exists between the user and the
server, this address will be the address of the proxy, rather
than the originating machine.</dd>
<dt><code>-</code> (<code>%l</code>)</dt>
<dd>The "hyphen" in the output indicates that the requested
piece of information is not available. In this case, the
information that is not available is the RFC 1413 identity of
the client determined by <code>identd</code> on the clients
machine. This information is highly unreliable and should
almost never be used except on tightly controlled internal
networks. Apache httpd will not even attempt to determine
this information unless <code class="directive"><a href="./mod/mod_ident.html#identitycheck">IdentityCheck</a></code> is set
to <code>On</code>.</dd>
<dt><code>frank</code> (<code>%u</code>)</dt>
<dd>This is the userid of the person requesting the document
as determined by HTTP authentication. The same value is
typically provided to CGI scripts in the
<code>REMOTE_USER</code> environment variable. If the status
code for the request (see below) is 401, then this value
should not be trusted because the user is not yet
authenticated. If the document is not password protected,
this part will be "<code>-</code>" just like the previous
one.</dd>
<dt><code>[10/Oct/2000:13:55:36 -0700]</code>
(<code>%t</code>)</dt>
<dd>
The time that the request was received.
The format is:
<p class="indent">
<code>[day/month/year:hour:minute:second zone]<br />
day = 2*digit<br />
month = 3*letter<br />
year = 4*digit<br />
hour = 2*digit<br />
minute = 2*digit<br />
second = 2*digit<br />
zone = (`+' | `-') 4*digit</code>
</p>
<p>It is possible to have the time displayed in another format
by specifying <code>%{format}t</code> in the log format
string, where <code>format</code> is either as in
<code>strftime(3)</code> from the C standard library,
or one of the supported special tokens. For details see
the <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code> <a href="mod/mod_log_config.html#formats">format strings</a>.</p>
</dd>
<dt><code>"GET /apache_pb.gif HTTP/1.0"</code>
(<code>\"%r\"</code>)</dt>
<dd>The request line from the client is given in double
quotes. The request line contains a great deal of useful
information. First, the method used by the client is
<code>GET</code>. Second, the client requested the resource
<code>/apache_pb.gif</code>, and third, the client used the
protocol <code>HTTP/1.0</code>. It is also possible to log
one or more parts of the request line independently. For
example, the format string "<code>%m %U%q %H</code>" will log
the method, path, query-string, and protocol, resulting in
exactly the same output as "<code>%r</code>".</dd>
<dt><code>200</code> (<code>%>s</code>)</dt>
<dd>This is the status code that the server sends back to the
client. This information is very valuable, because it reveals
whether the request resulted in a successful response (codes
beginning in 2), a redirection (codes beginning in 3), an
error caused by the client (codes beginning in 4), or an
error in the server (codes beginning in 5). The full list of
possible status codes can be found in the <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">HTTP
specification</a> (RFC2616 section 10).</dd>
<dt><code>2326</code> (<code>%b</code>)</dt>
<dd>The last part indicates the size of the object returned
to the client, not including the response headers. If no
content was returned to the client, this value will be
"<code>-</code>". To log "<code>0</code>" for no content, use
<code>%B</code> instead.</dd>
</dl>
<h3><a name="combined" id="combined">Combined Log Format</a></h3>
<p>Another commonly used format string is called the Combined
Log Format. It can be used as follows.</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" combined
CustomLog log/access_log combined</pre>
<p>This format is exactly the same as the Common Log Format,
with the addition of two more fields. Each of the additional
fields uses the percent-directive
<code>%{<em>header</em>}i</code>, where <em>header</em> can be
any HTTP request header. The access log under this format will
look like:</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
"http://www.example.com/start.html" "Mozilla/4.08 [en]
(Win98; I ;Nav)"
</code></p></div>
<p>The additional fields are:</p>
<dl>
<dt><code>"http://www.example.com/start.html"</code>
(<code>\"%{Referer}i\"</code>)</dt>
<dd>The "Referer" (sic) HTTP request header. This gives the
site that the client reports having been referred from. (This
should be the page that links to or includes
<code>/apache_pb.gif</code>).</dd>
<dt><code>"Mozilla/4.08 [en] (Win98; I ;Nav)"</code>
(<code>\"%{User-agent}i\"</code>)</dt>
<dd>The User-Agent HTTP request header. This is the
identifying information that the client browser reports about
itself.</dd>
</dl>
<h3><a name="multiple" id="multiple">Multiple Access Logs</a></h3>
<p>Multiple access logs can be created simply by specifying
multiple <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
directives in the configuration
file. For example, the following directives will create three
access logs. The first contains the basic CLF information,
while the second and third contain referer and browser
information. The last two <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> lines show how
to mimic the effects of the <code>ReferLog</code> and <code>AgentLog</code> directives.</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common
CustomLog logs/referer_log "%{Referer}i -> %U"
CustomLog logs/agent_log "%{User-agent}i"</pre>
<p>This example also shows that it is not necessary to define a
nickname with the <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> directive. Instead,
the log format can be specified directly in the <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> directive.</p>
<h3><a name="conditional" id="conditional">Conditional Logs</a></h3>
<p>There are times when it is convenient to exclude certain
entries from the access logs based on characteristics of the
client request. This is easily accomplished with the help of <a href="env.html">environment variables</a>. First, an
environment variable must be set to indicate that the request
meets certain conditions. This is usually accomplished with
<code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>. Then the
<code>env=</code> clause of the <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> directive is used to
include or exclude requests where the environment variable is
set. Some examples:</p>
<pre class="prettyprint lang-config"># Mark requests from the loop-back interface
SetEnvIf Remote_Addr "127\.0\.0\.1" dontlog
# Mark requests for the robots.txt file
SetEnvIf Request_URI "^/robots\.txt$" dontlog
# Log what remains
CustomLog logs/access_log common env=!dontlog</pre>
<p>As another example, consider logging requests from
english-speakers to one log file, and non-english speakers to a
different log file.</p>
<pre class="prettyprint lang-config">SetEnvIf Accept-Language "en" english
CustomLog logs/english_log common env=english
CustomLog logs/non_english_log common env=!english</pre>
<p>In a caching scenario one would want to know about
the efficiency of the cache. A very simple method to
find this out would be:</p>
<pre class="prettyprint lang-config">SetEnv CACHE_MISS 1
LogFormat "%h %l %u %t "%r " %>s %b %{CACHE_MISS}e" common-cache
CustomLog logs/access_log common-cache</pre>
<p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> will run before
<code class="module"><a href="./mod/mod_env.html">mod_env</a></code> and, when successful, will deliver the
content without it. In that case a cache hit will log
<code>-</code>, while a cache miss will log <code>1</code>.</p>
<p>In addition to the <code>env=</code> syntax, <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> supports logging values
conditional upon the HTTP response code:</p>
<pre class="prettyprint lang-config">LogFormat "%400,501{User-agent}i" browserlog
LogFormat "%!200,304,302{Referer}i" refererlog</pre>
<p>In the first example, the <code>User-agent</code> will be
logged if the HTTP status code is 400 or 501. In other cases, a
literal "-" will be logged instead. Likewise, in the second
example, the <code>Referer</code> will be logged if the HTTP
status code is <strong>not</strong> 200, 304, or 302. (Note the
"!" before the status codes.</p>
<p>Although we have just shown that conditional logging is very
powerful and flexible, it is not the only way to control the
contents of the logs. Log files are more useful when they
contain a complete record of server activity. It is often
easier to simply post-process the log files to remove requests
that you do not want to consider.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="rotation" id="rotation">Log Rotation</a></h2>
<p>On even a moderately busy server, the quantity of
information stored in the log files is very large. The access
log file typically grows 1 MB or more per 10,000 requests. It
will consequently be necessary to periodically rotate the log
files by moving or deleting the existing logs. This cannot be
done while the server is running, because Apache httpd will continue
writing to the old log file as long as it holds the file open.
Instead, the server must be <a href="stopping.html">restarted</a> after the log files are
moved or deleted so that it will open new log files.</p>
<p>By using a <em>graceful</em> restart, the server can be
instructed to open new log files without losing any existing or
pending connections from clients. However, in order to
accomplish this, the server must continue to write to the old
log files while it finishes serving old requests. It is
therefore necessary to wait for some time after the restart
before doing any processing on the log files. A typical
scenario that simply rotates the logs and compresses the old
logs to save space is:</p>
<div class="example"><p><code>
mv access_log access_log.old<br />
mv error_log error_log.old<br />
apachectl graceful<br />
sleep 600<br />
gzip access_log.old error_log.old
</code></p></div>
<p>Another way to perform log rotation is using <a href="#piped">piped logs</a> as discussed in the next
section.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="piped" id="piped">Piped Logs</a></h2>
<p>Apache httpd is capable of writing error and access log
files through a pipe to another process, rather than directly
to a file. This capability dramatically increases the
flexibility of logging, without adding code to the main server.
In order to write logs to a pipe, simply replace the filename
with the pipe character "<code>|</code>", followed by the name
of the executable which should accept log entries on its
standard input. The server will start the piped-log process when
the server starts, and will restart it if it crashes while the
server is running. (This last feature is why we can refer to
this technique as "reliable piped logging".)</p>
<p>Piped log processes are spawned by the parent Apache httpd
process, and inherit the userid of that process. This means
that piped log programs usually run as root. It is therefore
very important to keep the programs simple and secure.</p>
<p>One important use of piped logs is to allow log rotation
without having to restart the server. The Apache HTTP Server
includes a simple program called <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code>
for this purpose. For example, to rotate the logs every 24 hours, you
can use:</p>
<pre class="prettyprint lang-config">CustomLog "|/usr/local/apache/bin/rotatelogs /var/log/access_log 86400" common</pre>
<p>Notice that quotes are used to enclose the entire command
that will be called for the pipe. Although these examples are
for the access log, the same technique can be used for the
error log.</p>
<p>As with conditional logging, piped logs are a very powerful
tool, but they should not be used where a simpler solution like
off-line post-processing is available.</p>
<p>By default the piped log process is spawned without invoking
a shell. Use "<code>|$</code>" instead of "<code>|</code>"
to spawn using a shell (usually with <code>/bin/sh -c</code>):</p>
<pre class="prettyprint lang-config"># Invoke "rotatelogs" using a shell
CustomLog "|$/usr/local/apache/bin/rotatelogs /var/log/access_log 86400" common</pre>
<p>This was the default behaviour for Apache 2.2.
Depending on the shell specifics this might lead to
an additional shell process for the lifetime of the logging
pipe program and signal handling problems during restart.
For compatibility reasons with Apache 2.2 the notation
"<code>||</code>" is also supported and equivalent to using
"<code>|</code>".</p>
<div class="note"><h3>Windows note</h3>
<p>Note that on Windows, you may run into problems when running many piped
logger processes, especially when HTTPD is running as a service. This is
caused by running out of desktop heap space. The desktop heap space given
to each service is specified by the third argument to the
<code>SharedSection</code> parameter in the
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\SessionManager\SubSystems\Windows
registry value. <strong>Change this value with care</strong>; the normal
caveats for changing the Windows registry apply, but you might also exhaust
the desktop heap pool if the number is adjusted too high.</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="virtualhost" id="virtualhost">Virtual Hosts</a></h2>
<p>When running a server with many <a href="vhosts/">virtual
hosts</a>, there are several options for dealing with log
files. First, it is possible to use logs exactly as in a
single-host server. Simply by placing the logging directives
outside the <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> sections in the
main server context, it is possible to log all requests in the
same access log and error log. This technique does not allow
for easy collection of statistics on individual virtual
hosts.</p>
<p>If <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
or <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code>
directives are placed inside a
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
section, all requests or errors for that virtual host will be
logged only to the specified file. Any virtual host which does
not have logging directives will still have its requests sent
to the main server logs. This technique is very useful for a
small number of virtual hosts, but if the number of hosts is
very large, it can be complicated to manage. In addition, it
can often create problems with <a href="vhosts/fd-limits.html">insufficient file
descriptors</a>.</p>
<p>For the access log, there is a very good compromise. By
adding information on the virtual host to the log format
string, it is possible to log all hosts to the same log, and
later split the log into individual files. For example,
consider the following directives.</p>
<pre class="prettyprint lang-config">LogFormat "%v %l %u %t \"%r\" %>s %b" comonvhost
CustomLog logs/access_log comonvhost</pre>
<p>The <code>%v</code> is used to log the name of the virtual
host that is serving the request. Then a program like <a href="programs/split-logfile.html">split-logfile</a> can be used to
post-process the access log in order to split it into one file
per virtual host.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Other Log Files</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#bufferedlogs">BufferedLogs</a></code></li><li><code class="directive"><a href="./mod/mod_log_forensic.html#forensiclog">ForensicLog</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptloglength">ScriptLogLength</a></code></li></ul></td></tr></table>
<h3>Logging actual bytes sent and received</h3>
<p><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code> adds in two additional
<code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> fields
(%I and %O) that log the actual number of bytes received and sent
on the network.</p>
<h3>Forensic Logging</h3>
<p><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code> provides for forensic logging of
client requests. Logging is done before and after processing a
request, so the forensic log contains two log lines for each
request. The forensic logger is very strict with no customizations.
It can be an invaluable debugging and security tool.</p>
<h3><a name="pidfile" id="pidfile">PID File</a></h3>
<p>On startup, Apache httpd saves the process id of the parent
httpd process to the file <code>logs/httpd.pid</code>. This
filename can be changed with the <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> directive. The
process-id is for use by the administrator in restarting and
terminating the daemon by sending signals to the parent
process; on Windows, use the -k command line option instead.
For more information see the <a href="stopping.html">Stopping
and Restarting</a> page.</p>
<h3><a name="scriptlog" id="scriptlog">Script Log</a></h3>
<p>In order to aid in debugging, the
<code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code> directive
allows you to record the input to and output from CGI scripts.
This should only be used in testing - not for live servers.
More information is available in the <a href="mod/mod_cgi.html">mod_cgi</a> documentation.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/logs.html" title="English"> en </a> |
<a href="./fr/logs.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/logs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_4.html.en 0000664 0001751 0001751 00000070257 14737241666 021504 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Overview of new features in Apache HTTP Server 2.4 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Overview of new features in Apache HTTP Server 2.4</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/new_features_2_4.html" title="English"> en </a> |
<a href="./fr/new_features_2_4.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./tr/new_features_2_4.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document describes some of the major changes between the
2.2 and 2.4 versions of the Apache HTTP Server. For new features since
version 2.0, see the <a href="new_features_2_2.html">2.2 new features</a>
document.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Core Enhancements</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#newmods">New Modules</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Module Enhancements</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Program Enhancements</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#documentation">Documentation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Module Developer Changes</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="core" id="core">Core Enhancements</a></h2>
<dl>
<dt>Run-time Loadable MPMs</dt>
<dd>Multiple MPMs can now be <a href="mpm.html#dynamic">built
as loadable modules</a> at compile time.
The MPM of choice can be configured at run time via <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> directive.</dd>
<dt>Event MPM</dt>
<dd>The <a href="mod/event.html">Event MPM</a> is no longer experimental
but is now fully supported.</dd>
<dt>Asynchronous support</dt>
<dd>Better support for asynchronous read/write for supporting MPMs and
platforms.</dd>
<dt>Per-module and per-directory LogLevel configuration</dt>
<dd>The <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> can now be
configured per module and per directory. New levels <code>trace1</code>
to <code>trace8</code> have been added above the <code>debug</code> log
level.</dd>
<dt>Per-request configuration sections</dt>
<dd><code class="directive"><a href="./mod/core.html#if"><If></a></code>,
<code class="directive"><a href="./mod/core.html#elseif"><ElseIf></a></code>,
and <code class="directive"><a href="./mod/core.html#else"><Else></a></code>
sections can be used to set the configuration based on per-request
criteria.</dd>
<dt>General-purpose expression parser</dt>
<dd>A new expression parser allows to specify
<a href="expr.html">complex conditions</a> using a common syntax
in directives like
<code class="directive"><a href="./mod/mod_setenvif.html#setenvifexpr">SetEnvIfExpr</a></code>,
<code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>,
<code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>,
<code class="directive"><a href="./mod/core.html#if"><If></a></code>,
and others.
</dd>
<dt>KeepAliveTimeout in milliseconds</dt>
<dd>It is now possible to specify <code class="directive"><a href="./mod/core.html#keepalivetimeout">KeepAliveTimeout</a></code> in milliseconds.
</dd>
<dt>NameVirtualHost directive</dt>
<dd>No longer needed and is now deprecated.</dd>
<dt>Override Configuration</dt>
<dd>The new <code class="directive"><a href="./mod/core.html#allowoverridelist">AllowOverrideList</a></code>
directive allows more fine grained control which directives are
allowed in <code>.htaccess</code> files. </dd>
<dt>Config file variables</dt>
<dd>It is now possible to <code class="directive"><a href="./mod/core.html#define">Define</a></code>
variables in the configuration, allowing a clearer representation
if the same value is used at many places in the configuration.
</dd>
<dt>Reduced memory usage</dt>
<dd>Despite many new features, 2.4.x tends to use less memory than
2.2.x.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="newmods" id="newmods">New Modules</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></dt>
<dd>FastCGI Protocol backend for <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dd>
<dt><code class="module"><a href="./mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code></dt>
<dd>SCGI Protocol backend for <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dd>
<dt><code class="module"><a href="./mod/mod_proxy_express.html">mod_proxy_express</a></code></dt>
<dd>Provides dynamically configured mass reverse proxies for
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dd>
<dt><code class="module"><a href="./mod/mod_remoteip.html">mod_remoteip</a></code></dt>
<dd>Replaces the apparent client remote IP address and hostname for the request
with the IP address list presented by a proxies or a load balancer via
the request headers.</dd>
<dt><code class="module"><a href="./mod/mod_heartmonitor.html">mod_heartmonitor</a></code>,
<code class="module"><a href="./mod/mod_lbmethod_heartbeat.html">mod_lbmethod_heartbeat</a></code></dt>
<dd>Allow <code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> to base loadbalancing decisions
on the number of active connections on the backend servers.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_html.html">mod_proxy_html</a></code></dt>
<dd>Formerly a third-party module, this supports fixing of HTML
links in a reverse proxy situation, where the backend generates
URLs that are not valid for the proxy's clients.</dd>
<dt><code class="module"><a href="./mod/mod_sed.html">mod_sed</a></code></dt>
<dd>An advanced replacement of <code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code>, allows
to edit the response body with the full power of sed.</dd>
<dt><code class="module"><a href="./mod/mod_auth_form.html">mod_auth_form</a></code></dt>
<dd>Enables form-based authentication.</dd>
<dt><code class="module"><a href="./mod/mod_session.html">mod_session</a></code></dt>
<dd>Enables the use of session state for clients, using cookie or
database storage.</dd>
<dt><code class="module"><a href="./mod/mod_allowmethods.html">mod_allowmethods</a></code></dt>
<dd>New module to restrict certain HTTP methods without interfering with
authentication or authorization.</dd>
<dt><code class="module"><a href="./mod/mod_lua.html">mod_lua</a></code></dt>
<dd>Embeds the <a href="http://www.lua.org/">Lua</a> language into httpd,
for configuration and small business logic functions. (Experimental)</dd>
<dt><code class="module"><a href="./mod/mod_log_debug.html">mod_log_debug</a></code></dt>
<dd>Allows the addition of customizable debug logging at different phases of the
request processing.</dd>
<dt><code class="module"><a href="./mod/mod_buffer.html">mod_buffer</a></code></dt>
<dd>Provides for buffering the input and output filter stacks</dd>
<dt><code class="module"><a href="./mod/mod_data.html">mod_data</a></code></dt>
<dd>Convert response body into an RFC2397 data URL</dd>
<dt><code class="module"><a href="./mod/mod_ratelimit.html">mod_ratelimit</a></code></dt>
<dd>Provides Bandwidth Rate Limiting for Clients</dd>
<dt><code class="module"><a href="./mod/mod_request.html">mod_request</a></code></dt>
<dd>Provides Filters to handle and make available HTTP request bodies</dd>
<dt><code class="module"><a href="./mod/mod_reflector.html">mod_reflector</a></code></dt>
<dd>Provides Reflection of a request body as a response via the output filter stack.</dd>
<dt><code class="module"><a href="./mod/mod_slotmem_shm.html">mod_slotmem_shm</a></code></dt>
<dd>Provides a Slot-based shared memory provider (ala the scoreboard).</dd>
<dt><code class="module"><a href="./mod/mod_xml2enc.html">mod_xml2enc</a></code></dt>
<dd>Formerly a third-party module, this supports internationalisation
in libxml2-based (markup-aware) filter modules.</dd>
<dt><code class="module"><a href="./mod/mod_macro.html">mod_macro</a></code> (available since 2.4.5)</dt>
<dd>Provide macros within configuration files.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_wstunnel.html">mod_proxy_wstunnel</a></code> (available since 2.4.5)</dt>
<dd>Support web-socket tunnels.</dd>
<dt><code class="module"><a href="./mod/mod_authnz_fcgi.html">mod_authnz_fcgi</a></code> (available since 2.4.10)</dt>
<dd>Enable FastCGI authorizer applications to authenticate and/or
authorize clients.</dd>
<dt><code class="module"><a href="./mod/mod_http2.html">mod_http2</a></code> (available since 2.4.17)</dt>
<dd>Support for the HTTP/2 transport layer.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_http2.html">mod_proxy_http2</a></code> (available since 2.4.19)</dt>
<dd>HTTP/2 Protocol backend for <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dd>
<dt><code class="module"><a href="./mod/mod_proxy_hcheck.html">mod_proxy_hcheck</a></code> (available since 2.4.21)</dt>
<dd>Support independent dynamic health checks for remote proxiy backend servers.</dd>
<dt><code class="module"><a href="./mod/mod_brotli.html">mod_brotli</a></code> (available since 2.4.26)</dt>
<dd>Support the Brotli compression algorithm.</dd>
<dt><code class="module"><a href="./mod/mod_md.html">mod_md</a></code> (available since 2.4.30)</dt>
<dd>Support the ACME protocol to automate certificate provisionning.</dd>
<dt><code class="module"><a href="./mod/mod_proxy_uwsgi.html">mod_proxy_uwsgi</a></code> (available since 2.4.30)</dt>
<dd>UWSGI gateway module for <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>.</dd>
<dt><code class="module"><a href="./mod/mod_socache_redis.html">mod_socache_redis</a></code> (available since 2.4.39)</dt>
<dd>Support <a href="http://redis.io/">Redis</a> based shared object cache provider.</dd>
<dt><code class="module"><a href="./mod/mod_systemd.html">mod_systemd</a></code> (available since 2.4.42)</dt>
<dd>systemd integration. It allows httpd to be used in a service with the systemd
<code>Type=notify</code>.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Module Enhancements</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> can now be configured to use an
OCSP server to check the validation status of a client
certificate. The default responder is configurable, along with
the decision on whether to prefer the responder designated in
the client certificate itself.</dd>
<dd><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> now also supports OCSP stapling, where the
server pro-actively obtains an OCSP verification of its certificate and
transmits that to the client during the handshake. </dd>
<dd><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> can now be configured to share SSL Session
data between servers through memcached</dd>
<dd>EC keys are now supported in addition to RSA and DSA.</dd>
<dd>Support for TLS-SRP (available in 2.4.4 and later).</dd>
<dt><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dt>
<dd>The <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> directive
is now most optimally configured within a
<code class="directive"><a href="./mod/core.html#location">Location</a></code> or
<code class="directive"><a href="./mod/core.html#locationmatch">LocationMatch</a></code>
block, and offers a significant performance advantage over the traditional
two-parameter syntax when present in large numbers.</dd>
<dd>The source address used for proxy requests is now configurable.</dd>
<dd>Support for Unix domain sockets to the backend (available in 2.4.7
and later).</dd>
<dt><code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></dt>
<dd>More runtime configuration changes for BalancerMembers via balancer-manager</dd>
<dd>Additional BalancerMembers can be added at runtime via balancer-manager</dd>
<dd>Runtime configuration of a subset of Balancer parameters</dd>
<dd>BalancerMembers can be set to 'Drain' so that they only respond to existing sticky
sessions, allowing them to be taken gracefully offline.</dd>
<dd>Balancer settings can be persistent after restarts.</dd>
<dt><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></dt>
<dd>The <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> CACHE filter can be optionally inserted
at a given point in the filter chain to provide fine control over caching.
</dd>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> can now cache HEAD requests.</dd>
<dd>Where possible, <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> directives can now be set
per directory, instead of per server.</dd>
<dd>The base URL of cached URLs can be customised, so that a cluster of
caches can share the same endpoint URL prefix.</dd>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> is now capable of serving stale cached
data when a backend is unavailable (error 5xx).</dd>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> can now insert HIT/MISS/REVALIDATE into
an X-Cache header.</dd>
<dt><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dt>
<dd>Support for the 'onerror' attribute within an 'include' element,
allowing an error document to be served on error instead of the default
error string.</dd>
<dt><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>, <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>,
<code class="module"><a href="./mod/mod_isapi.html">mod_isapi</a></code>, ...</dt>
<dd>Translation of headers to environment variables is more strict than
before to mitigate some possible cross-site-scripting attacks via header
injection. Header names containing invalid characters (including underscores)
are no longer converted to environment variables. <a href="env.html">Environment Variables
in Apache</a> has some pointers on how to work around broken legacy
clients which require such headers. (This affects all modules which
use these environment variables.)</dd>
<dt><code class="module"><a href="./mod/mod_authz_core.html">mod_authz_core</a></code> Authorization Logic Containers</dt>
<dd>Advanced authorization logic may now be specified using the
<code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code> directive
and the related container directives, such as
<code class="directive"><a href="./mod/mod_authz_core.html#requireall"><RequireAll></a></code>.</dd>
<dt><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></dt>
<dd><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> adds the <code>[QSD]</code>
(Query String Discard) and <code>[END]</code> flags for
<code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to
simplify common rewriting scenarios.</dd>
<dd>Adds the possibility to use complex boolean expressions in <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>.</dd>
<dd>Allows the use of SQL queries as <code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> functions.</dd>
<dt><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>, <code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></dt>
<dd><code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> adds support for nested groups.</dd>
<dd><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code> adds
<code class="directive"><a href="./mod/mod_ldap.html#ldapconnectionpoolttl">LDAPConnectionPoolTTL</a></code>,
<code class="directive"><a href="./mod/mod_ldap.html#ldaptimeout">LDAPTimeout</a></code>, and
other improvements in the handling of timeouts.
This is especially useful for setups where a
stateful firewall drops idle connections to the LDAP server.</dd>
<dd><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code> adds
<code class="directive"><a href="./mod/mod_ldap.html#ldaplibrarydebug">LDAPLibraryDebug</a></code> to log
debug information provided by the used LDAP toolkit.</dd>
<dt><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></dt>
<dd><code class="module"><a href="./mod/mod_info.html">mod_info</a></code> can now dump the pre-parsed configuration
to stdout during server startup.</dd>
<dt><code class="module"><a href="./mod/mod_auth_basic.html">mod_auth_basic</a></code></dt>
<dd>New generic mechanism to fake basic authentication (available in
2.4.5 and later).</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="programs" id="programs">Program Enhancements</a></h2>
<dl>
<dt><code class="program"><a href="./programs/fcgistarter.html">fcgistarter</a></code></dt>
<dd>New FastCGI daemon starter utility</dd>
<dt><code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code></dt>
<dd>Current cached URLs can now be listed, with optional metadata
included.</dd>
<dd>Allow explicit deletion of individual cached URLs from the
cache.</dd>
<dd>File sizes can now be rounded up to the given block size, making
the size limits map more closely to the real size on disk.</dd>
<dd>Cache size can now be limited by the number of inodes, instead
of or in addition to being limited by the size of the files on
disk.</dd>
<dt><code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code></dt>
<dd>May now create a link to the current log file.</dd>
<dd>May now invoke a custom post-rotate script.</dd>
<dt><code class="program"><a href="./programs/htpasswd.html">htpasswd</a></code>, <code class="program"><a href="./programs/htdbm.html">htdbm</a></code></dt>
<dd>Support for the bcrypt algorithm (available in 2.4.4 and later).
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="documentation" id="documentation">Documentation</a></h2>
<dl>
<dt>mod_rewrite</dt>
<dd>The <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> documentation has been
rearranged and almost completely rewritten, with a focus on
examples and common usage, as well as on showing you when other
solutions are more appropriate. The <a href="rewrite/">Rewrite
Guide</a> is now a top-level section with much more detail and
better organization.</dd>
<dt>mod_ssl</dt>
<dd>The <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> documentation has been greatly
enhanced, with more examples at the getting started level, in
addition to the previous focus on technical details.</dd>
<dt>Caching Guide</dt>
<dd>The <a href="caching.html">Caching Guide</a> has been rewritten
to properly distinguish between the RFC2616 HTTP/1.1 caching
features provided by <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>, and the generic
key/value caching provided by the <a href="socache.html">socache</a>
interface, as well as to cover specialised caching provided by
mechanisms such as <code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code>.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="developer" id="developer">Module Developer Changes</a></h2>
<dl>
<dt>Check Configuration Hook Added</dt>
<dd>A new hook, <code>check_config</code>, has been added which runs
between the <code>pre_config</code> and <code>open_logs</code>
hooks. It also runs before the <code>test_config</code> hook
when the <code>-t</code> option is passed to
<code class="program"><a href="./programs/httpd.html">httpd</a></code>. The <code>check_config</code> hook
allows modules to review interdependent configuration directive
values and adjust them while messages can still be logged to the
console. The user can thus be alerted to misconfiguration problems
before the core <code>open_logs</code> hook function redirects
console output to the error log.</dd>
<dt>Expression Parser Added</dt>
<dd>We now have a general-purpose expression parser, whose API is
exposed in <var>ap_expr.h</var>. This is adapted from the
expression parser previously implemented in
<code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>.</dd>
<dt>Authorization Logic Containers</dt>
<dd>Authorization modules now register as a provider, via
ap_register_auth_provider(), to support advanced authorization logic,
such as <code class="directive"><a href="./mod/mod_authz_core.html#requireall"><RequireAll></a></code>.</dd>
<dt>Small-Object Caching Interface</dt>
<dd>The <var>ap_socache.h</var> header exposes a provider-based
interface for caching small data objects, based on the previous
implementation of the <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> session cache.
Providers using a shared-memory cyclic buffer, disk-based dbm
files, and a memcache distributed cache are currently
supported.</dd>
<dt>Cache Status Hook Added</dt>
<dd>The <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> module now includes a new
<code>cache_status</code> hook, which is called when the caching
decision becomes known. A default implementation is provided
which adds an optional <code>X-Cache</code> and
<code>X-Cache-Detail</code> header to the response.</dd>
</dl>
<p>The developer documentation contains a
<a href="developer/new_api_2_4.html">detailed list of API changes</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/new_features_2_4.html" title="English"> en </a> |
<a href="./fr/new_features_2_4.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./tr/new_features_2_4.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_4.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/stopping.html.en 0000664 0001751 0001751 00000042625 14737241666 020212 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Stopping and Restarting Apache HTTP Server - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Stopping and Restarting Apache HTTP Server</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document covers stopping and restarting Apache HTTP Server on
Unix-like systems. Windows NT, 2000 and XP users should see
<a href="platform/windows.html#winsvc">Running httpd as a
Service</a> and Windows 9x and ME users should see <a href="platform/windows.html#wincons">Running httpd as a
Console Application</a> for information on how to control
httpd on those platforms.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#term">Stop Now</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#graceful">Graceful Restart</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#hup">Restart Now</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#gracefulstop">Graceful Stop</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="invoking.html">Starting</a></li><li><a href="#comments_section">Comments</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="introduction" id="introduction">Introduction</a></h2>
<p>In order to stop or restart the Apache HTTP Server, you must send a signal to
the running <code class="program"><a href="./programs/httpd.html">httpd</a></code> processes. There are two ways to
send the signals. First, you can use the unix <code>kill</code>
command to directly send signals to the processes. You will
notice many <code class="program"><a href="./programs/httpd.html">httpd</a></code> executables running on your system,
but you should not send signals to any of them except the parent,
whose pid is in the <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>. That is to say you
shouldn't ever need to send signals to any process except the
parent. There are four signals that you can send the parent:
<code><a href="#term">TERM</a></code>,
<code><a href="#graceful">USR1</a></code>,
<code><a href="#hup">HUP</a></code>, and
<code><a href="#gracefulstop">WINCH</a></code>, which
will be described in a moment.</p>
<p>To send a signal to the parent you should issue a command
such as:</p>
<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
<p>The second method of signaling the <code class="program"><a href="./programs/httpd.html">httpd</a></code> processes
is to use the <code>-k</code> command line options: <code>stop</code>,
<code>restart</code>, <code>graceful</code> and <code>graceful-stop</code>,
as described below. These are arguments to the <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary, but we recommend that
you send them using the <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> control script, which
will pass them through to <code class="program"><a href="./programs/httpd.html">httpd</a></code>.</p>
<p>After you have signaled <code class="program"><a href="./programs/httpd.html">httpd</a></code>, you can read about
its progress by issuing:</p>
<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
<p>Modify those examples to match your <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> and <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> settings.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="term" id="term">Stop Now</a></h2>
<dl><dt>Signal: TERM</dt>
<dd><code>apachectl -k stop</code></dd>
</dl>
<p>Sending the <code>TERM</code> or <code>stop</code> signal to
the parent causes it to immediately attempt to kill off all of its
children. It may take it several seconds to complete killing off
its children. Then the parent itself exits. Any requests in
progress are terminated, and no further requests are served.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="graceful" id="graceful">Graceful Restart</a></h2>
<dl><dt>Signal: USR1</dt>
<dd><code>apachectl -k graceful</code></dd>
</dl>
<p>The <code>USR1</code> or <code>graceful</code> signal causes
the parent process to <em>advise</em> the children to exit after
their current request (or to exit immediately if they're not
serving anything). The parent re-reads its configuration files and
re-opens its log files. As each child dies off the parent replaces
it with a child from the new <em>generation</em> of the
configuration, which begins serving new requests immediately.</p>
<p>This code is designed to always respect the process control
directive of the MPMs, so the number of processes and threads
available to serve clients will be maintained at the appropriate
values throughout the restart process. Furthermore, it respects
<code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> in the
following manner: if after one second at least <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> new children have not
been created, then create enough to pick up the slack. Hence the
code tries to maintain both the number of children appropriate for
the current load on the server, and respect your wishes with the
<code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>
parameter.</p>
<p>Users of <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
will notice that the server statistics are <strong>not</strong>
set to zero when a <code>USR1</code> is sent. The code was
written to both minimize the time in which the server is unable
to serve new requests (they will be queued up by the operating
system, so they're not lost in any event) and to respect your
tuning parameters. In order to do this it has to keep the
<em>scoreboard</em> used to keep track of all children across
generations.</p>
<p>The status module will also use a <code>G</code> to indicate
those children which are still serving requests started before
the graceful restart was given.</p>
<p>At present there is no way for a log rotation script using
<code>USR1</code> to know for certain that all children writing
the pre-restart log have finished. We suggest that you use a
suitable delay after sending the <code>USR1</code> signal
before you do anything with the old log. For example if most of
your hits take less than 10 minutes to complete for users on
low bandwidth links then you could wait 15 minutes before doing
anything with the old log.</p>
<div class="note">
<p>When you issue a restart, a syntax check is first run, to
ensure that there are no errors in the configuration files.
If your configuration file has errors in it, you will get an
error message about that syntax error, and the server will refuse to
restart. This avoids the situation where the server halts and then
cannot restart, leaving you with a non-functioning server.</p>
<p>This still will not
guarantee that the server will restart correctly. To check the
semantics of the configuration files as well as the syntax, you
can try starting <code class="program"><a href="./programs/httpd.html">httpd</a></code> as a non-root user. If there
are no errors it will attempt to open its sockets and logs and fail
because it's not root (or because the currently running
<code class="program"><a href="./programs/httpd.html">httpd</a></code> already has those ports bound). If it fails
for any other reason then it's probably a config file error and the error
should be fixed before issuing the graceful restart.</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="hup" id="hup">Restart Now</a></h2>
<dl><dt>Signal: HUP</dt>
<dd><code>apachectl -k restart</code></dd>
</dl>
<p>Sending the <code>HUP</code> or <code>restart</code> signal to
the parent causes it to kill off its children like in
<code>TERM</code>, but the parent doesn't exit. It re-reads its
configuration files, and re-opens any log files. Then it spawns a
new set of children and continues serving hits.</p>
<p>Users of <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
will notice that the server statistics are set to zero when a
<code>HUP</code> is sent.</p>
<div class="note">As with a graceful restart, a syntax check is run before the
restart is attempted. If your configuration file has errors in it, the
restart will not be attempted, and you will receive notification of the
syntax error(s).</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="gracefulstop" id="gracefulstop">Graceful Stop</a></h2>
<dl><dt>Signal: WINCH</dt>
<dd><code>apachectl -k graceful-stop</code></dd>
</dl>
<p>The <code>WINCH</code> or <code>graceful-stop</code> signal causes
the parent process to <em>advise</em> the children to exit after
their current request (or to exit immediately if they're not
serving anything). The parent will then remove its <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> and cease listening on
all ports. The parent will continue to run, and monitor children
which are handling requests. Once all children have finalised
and exited or the timeout specified by the <code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> has been
reached, the parent will also exit. If the timeout is reached,
any remaining children will be sent the <code>TERM</code> signal
to force them to exit.</p>
<p>A <code>TERM</code> signal will immediately terminate the
parent process and all children when in the "graceful" state. However
as the <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> will
have been removed, you will not be able to use
<code>apachectl</code> or <code>httpd</code> to send this signal.</p>
<div class="note"><p>The <code>graceful-stop</code> signal allows you to run multiple
identically configured instances of <code class="program"><a href="./programs/httpd.html">httpd</a></code> at the
same time. This is a powerful feature when performing graceful
upgrades of httpd, however it can also cause deadlocks and race
conditions with some configurations.</p>
<p>Care has been taken to ensure that on-disk files such as lock files
(<code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>) and Unix socket files
(<code class="directive"><a href="./mod/mod_cgid.html#scriptsock">ScriptSock</a></code>) contain the server
PID, and should coexist without problem. However, if a configuration
directive, third-party module or persistent CGI utilises any other on-disk
lock or state files, care should be taken to ensure that multiple running
instances of <code class="program"><a href="./programs/httpd.html">httpd</a></code> do not clobber each other's files.</p>
<p>You should also be wary of other potential race conditions, such as
using <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> style piped logging. Multiple running
instances of <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code> attempting to rotate the same
logfiles at the same time may destroy each other's logfiles.</p></div>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/stopping.html" title="English"> en </a> |
<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/stopping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/stopping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/stopping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/handler.html.en 0000664 0001751 0001751 00000027444 14737241666 017766 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache's Handler Use - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache's Handler Use</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/handler.html" 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="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div>
<p>This document describes the use of Apache's Handlers.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#definition">What is a Handler</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#examples">Examples</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programmer">Programmer's Note</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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">What is a Handler</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</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_imagemap.html">mod_imagemap</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>A "handler" is an internal Apache representation of the
action to be performed when a file is called. Generally, files
have implicit handlers, based on the file type. Normally, all
files are simply served by the server, but certain file types
are "handled" separately.</p>
<p>Handlers may also be configured explicitly,
based on either filename extensions or on location,
without relation to file type. This is
advantageous both because it is a more elegant solution, and
because it also allows for both a type <strong>and</strong> a
handler to be associated with a file. (See also <a href="mod/mod_mime.html#multipleext">Files with Multiple
Extensions</a>.)</p>
<p>Handlers can either be built into the server or included in
a module, or they can be added with the <code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code> directive. The
built-in handlers in the standard distribution are as
follows:</p>
<ul>
<li><strong>default-handler</strong>: Send the file using the
<code>default_handler()</code>, which is the handler used by
default to handle static content. (core)</li>
<li><strong>send-as-is</strong>: Send file with HTTP headers
as is. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
<li><strong>cgi-script</strong>: Treat the file as a CGI
script. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
<li><strong>imap-file</strong>: Parse as an imagemap rule
file. (<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code>)</li>
<li><strong>server-info</strong>: Get the server's
configuration information. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
<li><strong>server-status</strong>: Get the server's status
report. (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
<li><strong>type-map</strong>: Parse as a type map file for
content negotiation. (<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">Examples</a></h2>
<h3><a name="example1" id="example1">Modifying static content using a CGI script</a></h3>
<p>The following directives will cause requests for files with
the <code>html</code> extension to trigger the launch of the
<code>footer.pl</code> CGI script.</p>
<pre class="prettyprint lang-config">Action add-footer /cgi-bin/footer.pl
AddHandler add-footer .html</pre>
<p>Then the CGI script is responsible for sending the
originally requested document (pointed to by the
<code>PATH_TRANSLATED</code> environment variable) and making
whatever modifications or additions are desired.</p>
<h3><a name="example2" id="example2">Files with HTTP headers</a></h3>
<p>The following directives will enable the
<code>send-as-is</code> handler, which is used for files which
contain their own HTTP headers. All files in the
<code>/web/htdocs/asis/</code> directory will be processed by
the <code>send-as-is</code> handler, regardless of their
filename extensions.</p>
<pre class="prettyprint lang-config"><Directory "/web/htdocs/asis">
SetHandler send-as-is
</Directory></pre>
</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">Programmer's Note</a></h2>
<p>In order to implement the handler features, an addition has
been made to the <a href="developer/API.html">Apache API</a> that
you may wish to make use of. Specifically, a new record has
been added to the <code>request_rec</code> structure:</p>
<pre class="prettyprint lang-c">char *handler</pre>
<p>If you wish to have your module engage a handler, you need
only to set <code>r->handler</code> to the name of the
handler at any time prior to the <code>invoke_handler</code>
stage of the request. Handlers are implemented as they were
before, albeit using the handler name instead of a content
type. While it is not necessary, the naming convention for
handlers is to use a dash-separated word, with no slashes, so
as to not invade the media type name-space.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/handler.html" 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="./tr/handler.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> |
<a href="./zh-cn/handler.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/handler.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/license.html.en 0000664 0001751 0001751 00000036764 14737241666 020000 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>The Apache License, Version 2.0 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>The Apache License, Version 2.0</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/license.html" title="English"> en </a></p>
</div>
<p class="centered">Apache License<br />
Version 2.0, January 2004<br />
<a href="http://www.apache.org/licenses/">http://www.apache.org/licenses/</a><br /><br />
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION</p>
<ol>
<li><strong>Definitions</strong><br />
<p>"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.</p>
<p>"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.</p>
<p>"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.</p>
<p>"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.</p>
<p>"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.</p>
<p>"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.</p>
<p>"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).</p>
<p>"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.</p>
<p>"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."</p>
<p>"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.</p></li>
<li><strong>Grant of Copyright License.</strong> Subject to the terms
and conditions of this License, each Contributor hereby grants to You
a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
irrevocable copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.</li>
<li><strong>Grant of Patent License.</strong> Subject to the terms
and conditions of this License, each Contributor hereby grants to You a
perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.</li>
<li><strong>Redistribution.</strong> You may reproduce and distribute
copies of the Work or Derivative Works thereof in any medium, with or
without modifications, and in Source or Object form, provided that You
meet the following conditions:
<ol class="lo-A">
<li>You must give any other recipients of the Work or
Derivative Works a copy of this License; and</li>
<li>You must cause any modified files to carry prominent notices
stating that You changed the files; and</li>
<li>You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and</li>
<li>If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.</li>
</ol>
<p>You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.</p></li>
<li><strong>Submission of Contributions.</strong> Unless You explicitly
state otherwise, any Contribution intentionally submitted for inclusion
in the Work by You to the Licensor shall be under the terms and
conditions of this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.</li>
<li><strong>Trademarks.</strong> This License does not grant permission
to use the trade names, trademarks, service marks, or product names of
the Licensor, except as required for reasonable and customary use in
describing the origin of the Work and reproducing the content of the
NOTICE file.</li>
<li><strong>Disclaimer of Warranty.</strong> Unless required by
applicable law or agreed to in writing, Licensor provides the Work (and
each Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.</li>
<li><strong>Limitation of Liability.</strong> In no event and under no
legal theory, whether in tort (including negligence), contract, or
otherwise, unless required by applicable law (such as deliberate and
grossly negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.</li>
<li><strong>Accepting Warranty or Additional Liability.</strong> While
redistributing the Work or Derivative Works thereof, You may choose to
offer, and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.</li>
</ol>
<p class="centered">END OF TERMS AND CONDITIONS</p>
<p class="centered">APPENDIX: How to apply the Apache License to your
work.</p>
<p>To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.</p>
<div class="example"><pre>Copyright [yyyy] [name of copyright owner]
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.</pre></div>
</div>
</div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/license.html" title="English"> en </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/license.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_2.html.en 0000664 0001751 0001751 00000045120 14737241666 021471 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Overview of new features in Apache HTTP Server 2.2 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Overview of new features in Apache HTTP Server 2.2</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/new_features_2_2.html" title="English"> en </a> |
<a href="./fr/new_features_2_2.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ko/new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_2.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document describes some of the major changes between the
2.0 and 2.2 versions of the Apache HTTP Server. For new features since
version 1.3, see the <a href="new_features_2_0.html">2.0 new features</a>
document.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Core Enhancements</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Module Enhancements</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#programs">Program Enhancements</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#developer">Module Developer Changes</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="core" id="core">Core Enhancements</a></h2>
<dl>
<dt>Authn/Authz</dt>
<dd>The bundled authentication and authorization modules have
been refactored. The new mod_authn_alias(already removed from 2.3/2.4)
module can greatly simplify certain authentication configurations.
See <a href="#module">module name changes</a>, and
<a href="#developer">the developer changes</a> for more
information about how these changes affects users and module
writers.</dd>
<dt>Caching</dt>
<dd><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>, <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>, and
mod_mem_cache(already removed from 2.3/2.4) have undergone a lot of changes, and
are now considered production-quality. <code class="program"><a href="./programs/htcacheclean.html">htcacheclean</a></code>
has been introduced to clean up <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>
setups.</dd>
<dt>Configuration</dt>
<dd>The default configuration layout has been simplified and
modularised. Configuration snippets which can be used to
enable commonly-used features are now bundled with Apache, and
can be easily added to the main server config.</dd>
<dt>Graceful stop</dt>
<dd>The <code class="module"><a href="./mod/prefork.html">prefork</a></code>, <code class="module"><a href="./mod/worker.html">worker</a></code> and
<code class="module"><a href="./mod/event.html">event</a></code> MPMs now allow <code class="program"><a href="./programs/httpd.html">httpd</a></code>
to be shutdown gracefully via the
<a href="stopping.html#gracefulstop"><code>graceful-stop</code></a>
signal. The <code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> directive
has been added to specify an optional timeout, after which
<code class="program"><a href="./programs/httpd.html">httpd</a></code> will terminate regardless of the status
of any requests being served.</dd>
<dt>Proxying</dt>
<dd>The new <code class="module"><a href="./mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> module provides
load balancing services for <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>.
The new <code class="module"><a href="./mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code> module adds support for the
<code>Apache JServ Protocol version 1.3</code> used by
<a href="http://tomcat.apache.org/">Apache Tomcat</a>.</dd>
<dt>Regular Expression Library Updated</dt>
<dd>Version 5.0 of the
<a href="http://www.pcre.org/">Perl Compatible Regular Expression
Library</a> (PCRE) is now included. <code class="program"><a href="./programs/httpd.html">httpd</a></code> can be
configured to use a system installation of PCRE by passing the
<code>--with-pcre</code> flag to configure.</dd>
<dt>Smart Filtering</dt>
<dd><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code> introduces dynamic configuration
to the output filter chain. It enables filters to be conditionally
inserted, based on any Request or Response header or environment
variable, and dispenses with the more problematic dependencies and
ordering problems in the 2.0 architecture.</dd>
<dt>Large File Support</dt>
<dd><code class="program"><a href="./programs/httpd.html">httpd</a></code> is now built with support for files larger
than 2GB on modern 32-bit Unix systems. Support for handling
>2GB request bodies has also been added.</dd>
<dt>Event MPM</dt>
<dd>The <code class="module"><a href="./mod/event.html">event</a></code> MPM uses a separate thread to handle
Keep Alive requests and accepting connections. Keep Alive requests
have traditionally required httpd to dedicate a worker to handle it.
This dedicated worker could not be used again until the Keep Alive
timeout was reached.</dd>
<dt>SQL Database Support</dt>
<dd><code class="module"><a href="./mod/mod_dbd.html">mod_dbd</a></code>, together with the <code>apr_dbd</code>
framework, brings direct SQL support to modules that need it.
Supports connection pooling in threaded MPMs.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Module Enhancements</a></h2>
<dl>
<dt>Authn/Authz</dt>
<dd>Modules in the aaa directory have been renamed and offer
better support for digest authentication. For example,
<code>mod_auth</code> is now split into
<code class="module"><a href="./mod/mod_auth_basic.html">mod_auth_basic</a></code> and
<code class="module"><a href="./mod/mod_authn_file.html">mod_authn_file</a></code>; <code>mod_auth_dbm</code> is now
called <code class="module"><a href="./mod/mod_authn_dbm.html">mod_authn_dbm</a></code>; <code>mod_access</code> has
been renamed <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>. There is also a new
mod_authn_alias(already removed from 2.3/2.4) module for simplifying
certain authentication configurations.
</dd>
<dt><code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></dt>
<dd>This module is a port of the 2.0
<code>mod_auth_ldap</code> module to the 2.2 <code>Authn/Authz</code>
framework. New features include using LDAP attribute values and
complicated search filters in the
<code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code> directive.</dd>
<dt><code class="module"><a href="./mod/mod_authz_owner.html">mod_authz_owner</a></code></dt>
<dd>A new module that authorizes access to files based
on the owner of the file on the file system</dd>
<dt><code class="module"><a href="./mod/mod_version.html">mod_version</a></code></dt>
<dd>A new module that allows configuration blocks to be enabled based on the
version number of the running server.</dd>
<dt><code class="module"><a href="./mod/mod_info.html">mod_info</a></code></dt>
<dd>Added a new <code>?config</code> argument which will show
the configuration directives as parsed by Apache, including
their file name and line number. The module also
shows the order of all request hooks and additional
build information, similar to <code>httpd -V</code>.</dd>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>Added a support for
<a href="http://www.ietf.org/rfc/rfc2817.txt">RFC 2817</a>, which
allows connections to upgrade from clear text to TLS encryption.</dd>
<dt><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code></dt>
<dd><code>mod_imap</code> has been renamed to
<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code> to avoid user confusion.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="programs" id="programs">Program Enhancements</a></h2>
<dl>
<dt><code class="program"><a href="./programs/httpd.html">httpd</a></code></dt>
<dd>A new command line option <code>-M</code> has been added that
lists all modules that are loaded based on the current
configuration. Unlike the <code>-l</code> option, this list
includes DSOs loaded via <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>.</dd>
<dt><code class="program"><a href="./programs/httxt2dbm.html">httxt2dbm</a></code></dt>
<dd>A new program used to generate dbm files from text input,
for use in <code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
with the <code>dbm</code> map type.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="developer" id="developer">Module Developer Changes</a></h2>
<dl>
<dt><a class="glossarylink" href="./glossary.html#apr" title="see glossary">APR</a> 1.0 API</dt>
<dd>Apache 2.2 uses the APR 1.0 API. All deprecated functions and
symbols have been removed from <code>APR</code> and
<code>APR-Util</code>. For details, see the
<a href="http://apr.apache.org/">APR Website</a>.</dd>
<dt>Authn/Authz</dt>
<dd>The bundled authentication and authorization modules have
been renamed along the following lines:
<ul>
<li><code>mod_auth_*</code> -> Modules that implement an HTTP
authentication mechanism</li>
<li><code>mod_authn_*</code> -> Modules that provide a backend
authentication provider</li>
<li><code>mod_authz_*</code> -> Modules that implement
authorization (or access)</li>
<li><code>mod_authnz_*</code> -> Module that implements both
authentication & authorization</li>
</ul>
There is a new authentication backend provider
scheme which greatly eases the construction of new authentication
backends.</dd>
<dt>Connection Error Logging</dt>
<dd>A new function, <code>ap_log_cerror</code> has been added to log
errors that occur with the client's connection. When logged,
the message includes the client IP address.</dd>
<dt>Test Configuration Hook Added</dt>
<dd>A new hook, <code>test_config</code> has been added to aid
modules that want to execute special code only when the user passes
<code>-t</code> to <code class="program"><a href="./programs/httpd.html">httpd</a></code>.</dd>
<dt>Set Threaded MPM's Stacksize</dt>
<dd>A new directive, <code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code> has been added to
set the stack size on all threaded MPMs. This is required
for some third-party modules on platforms with small default
thread stack size.</dd>
<dt>Protocol handling for output filters</dt>
<dd>In the past, every filter has been responsible for ensuring
that it generates the correct response headers where it affects
them. Filters can now delegate common protocol management to
<code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>, using the
<code>ap_register_output_filter_protocol</code> or
<code>ap_filter_protocol</code> calls.</dd>
<dt>Monitor hook added</dt>
<dd>Monitor hook enables modules to run regular/scheduled jobs
in the parent (root) process.</dd>
<dt>Regular expression API changes</dt>
<dd>The <code>pcreposix.h</code> header is no longer available;
it is replaced by the new <code>ap_regex.h</code> header. The
POSIX.2 <code>regex.h</code> implementation exposed by the old
header is now available under the <code>ap_</code> namespace
from <code>ap_regex.h</code>. Calls to <code>regcomp</code>,
<code>regexec</code> and so on can be replaced by calls to
<code>ap_regcomp</code>, <code>ap_regexec</code>.</dd>
<dt>DBD Framework (SQL Database API)</dt>
<dd><p>With Apache 1.x and 2.0, modules requiring an SQL backend
had to take responsibility for managing it themselves. Apart
from reinventing the wheel, this can be very inefficient, for
example when several modules each maintain their own connections.</p>
<p>Apache 2.1 and later provides the <code>ap_dbd</code> API for
managing database connections (including optimised strategies
for threaded and unthreaded MPMs), while APR 1.2 and later provides
the <code>apr_dbd</code> API for interacting with the database.</p>
<p>New modules SHOULD now use these APIs for all SQL database
operations. Existing applications SHOULD be upgraded to use it
where feasible, either transparently or as a recommended option
to their users.</p></dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/new_features_2_2.html" title="English"> en </a> |
<a href="./fr/new_features_2_2.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ko/new_features_2_2.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_2.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_2.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_2.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/socache.html.en 0000664 0001751 0001751 00000023046 14737241666 017750 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Shared Object Cache in Apache HTTP Server - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page" class="no-sidebar"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Shared Object Cache in Apache HTTP Server</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/socache.html" title="English"> en </a> |
<a href="./fr/socache.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>The Shared Object Cache provides a means to share simple data
across all a server's workers, regardless of <a href="mpm.html">thread
and process models</a>. It is used where the advantages of sharing
data across processes outweigh the performance overhead of
inter-process communication.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="providers" id="providers">Shared Object Cache Providers</a></h2>
<p>The shared object cache as such is an abstraction. Five different
modules implement it. To use the cache, one or more of these modules
must be present, and configured.</p>
<p>The only configuration required is to select which cache provider
to use. This is the responsibility of modules using the cache, and
they enable selection using directives such as
<code class="directive"><a href="./mod/mod_cache_socache.html#cachesocache">CacheSocache</a></code>,
<code class="directive"><a href="./mod/mod_authn_socache.html#authncachesocache">AuthnCacheSOCache</a></code>,
<code class="directive"><a href="./mod/mod_ssl.html#sslsessioncache">SSLSessionCache</a></code>, and
<code class="directive"><a href="./mod/mod_ssl.html#sslstaplingcache">SSLStaplingCache</a></code>.</p>
<p>Currently available providers are:</p>
<dl>
<dt>"dbm" (<code class="module"><a href="./mod/mod_socache_dbm.html">mod_socache_dbm</a></code>)</dt>
<dd>This makes use of a DBM hash file.
The choice of underlying DBM used may be configurable
if the installed APR version supports multiple DBM implementations.</dd>
<dt>"dc" (<code class="module"><a href="./mod/mod_socache_dc.html">mod_socache_dc</a></code>)</dt>
<dd>This makes use of the <a href="http://distcache.sourceforge.net/">distcache</a>
distributed session caching libraries.</dd>
<dt>"memcache" (<code class="module"><a href="./mod/mod_socache_memcache.html">mod_socache_memcache</a></code>)</dt>
<dd>This makes use of the <a href="http://memcached.org/">memcached</a>
high-performance, distributed memory object caching system.</dd>
<dt>"redis" (<code class="module"><a href="./mod/mod_socache_redis.html">mod_socache_redis</a></code>)</dt>
<dd>This makes use of the <a href="http://redis.io/">Redis</a>
high-performance, distributed memory object caching system.</dd>
<dt>"shmcb" (<code class="module"><a href="./mod/mod_socache_shmcb.html">mod_socache_shmcb</a></code>)</dt>
<dd>This makes use of a high-performance cyclic buffer inside a
shared memory segment.</dd>
</dl>
<p>The API provides the following functions:</p>
<dl>
<dt>const char *create(ap_socache_instance_t **instance, const char *arg,
apr_pool_t *tmp, apr_pool_t *p);</dt>
<dd>Create a session cache based on the given configuration string.
The instance pointer returned in the instance parameter will be
passed as the first argument to subsequent invocations.</dd>
<dt>apr_status_t init(ap_socache_instance_t *instance, const char *cname,
const struct ap_socache_hints *hints,
server_rec *s, apr_pool_t *pool)</dt>
<dd>Initialize the cache. The cname must be of maximum length 16
characters, and uniquely identifies the consumer of the cache
within the server; using the module name is recommended, e.g.
"mod_ssl-sess". This string may be used within a filesystem
path so use of only alphanumeric [a-z0-9_-] characters is
recommended. If hints is non-NULL, it gives a set of hints for
the provider. Return APR error code.</dd>
<dt>void destroy(ap_socache_instance_t *instance, server_rec *s)</dt>
<dd>Destroy a given cache instance object.</dd>
<dt>apr_status_t store(ap_socache_instance_t *instance, server_rec *s,
const unsigned char *id, unsigned int idlen,
apr_time_t expiry,
unsigned char *data, unsigned int datalen,
apr_pool_t *pool)</dt>
<dd>Store an object in a cache instance.</dd>
<dt>apr_status_t retrieve(ap_socache_instance_t *instance, server_rec *s,
const unsigned char *id, unsigned int idlen,
unsigned char *data, unsigned int *datalen,
apr_pool_t *pool)</dt>
<dd>Retrieve a cached object.</dd>
<dt>apr_status_t remove(ap_socache_instance_t *instance, server_rec *s,
const unsigned char *id, unsigned int idlen,
apr_pool_t *pool)</dt>
<dd>Remove an object from the cache.</dd>
<dt>void status(ap_socache_instance_t *instance, request_rec *r, int flags)</dt>
<dd>Dump the status of a cache instance for mod_status.</dd>
<dt>apr_status_t iterate(ap_socache_instance_t *instance, server_rec *s,
void *userctx, ap_socache_iterator_t *iterator,
apr_pool_t *pool)</dt>
<dd>Dump all cached objects through an iterator callback.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/socache.html" title="English"> en </a> |
<a href="./fr/socache.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/socache.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/urlmapping.html.en 0000664 0001751 0001751 00000064022 14737241666 020520 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Mapping URLs to Filesystem Locations - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Mapping URLs to Filesystem Locations</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/urlmapping.html" title="English"> en </a> |
<a href="./fr/urlmapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document explains how the Apache HTTP Server uses the URL of a request
to determine the filesystem location from which to serve a
file.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#related">Related Modules and Directives</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#outside">Files Outside the DocumentRoot</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#user">User Directories</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#redirect">URL Redirection</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#proxy">Reverse Proxy</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rewrite">Rewriting Engine</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#notfound">File Not Found</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">Other URL Mapping Modules</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="related" id="related">Related Modules and Directives</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</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_alias.html">mod_alias</a></code></li><li><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code></li><li><code class="module"><a href="./mod/mod_dir.html">mod_dir</a></code></li><li><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</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_proxy.html">mod_proxy</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code></li><li><code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code></li><li><code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_speling.html#checkspelling">CheckSpelling</a></code></li><li><code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code></li></ul></td></tr></table>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="documentroot" id="documentroot">DocumentRoot</a></h2>
<p>In deciding what file to serve for a given request, httpd's
default behavior is to take the URL-Path for the request (the part
of the URL following the hostname and port) and add it to the end
of the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> specified
in your configuration files. Therefore, the files and directories
underneath the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
make up the basic document tree which will be visible from the
web.</p>
<p>For example, if <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
were set to <code>/var/www/html</code> then a request for
<code>http://www.example.com/fish/guppies.html</code> would result
in the file <code>/var/www/html/fish/guppies.html</code> being
served to the requesting client.</p>
<p>If a directory is requested (i.e. a path ending with
<code>/</code>), the file served from that directory is defined by
the <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> directive.
For example, if <code>DocumentRoot</code> were set as above, and
you were to set:</p>
<div class="example"><p><code>DirectoryIndex index.html index.php</code></p></div>
<p>Then a request for <code>http://www.example.com/fish/</code> will
cause httpd to attempt to serve the file
<code>/var/www/html/fish/index.html</code>. In the event that
that file does not exist, it will next attempt to serve the file
<code>/var/www/html/fish/index.php</code>.</p>
<p>If neither of these files existed, the next step is to
attempt to provide a directory index, if
<code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code> is loaded and configured to permit
that.</p>
<p>httpd is also capable of <a href="vhosts/">Virtual
Hosting</a>, where the server receives requests for more than one
host. In this case, a different <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> can be specified for each
virtual host, or alternatively, the directives provided by the
module <code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code> can
be used to dynamically determine the appropriate place from which
to serve content based on the requested IP address or
hostname.</p>
<p>The <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> directive
is set in your main server configuration file
(<code>httpd.conf</code>) and, possibly, once per additional <a href="vhosts/">Virtual Host</a> you create.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="outside" id="outside">Files Outside the DocumentRoot</a></h2>
<p>There are frequently circumstances where it is necessary to
allow web access to parts of the filesystem that are not strictly
underneath the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>. httpd offers several
different ways to accomplish this. On Unix systems, symbolic links
can bring other parts of the filesystem under the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>. For security reasons,
httpd will follow symbolic links only if the <code class="directive"><a href="./mod/core.html#options">Options</a></code> setting for the relevant
directory includes <code>FollowSymLinks</code> or
<code>SymLinksIfOwnerMatch</code>.</p>
<p>Alternatively, the <code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code> directive will map any part
of the filesystem into the web space. For example, with</p>
<pre class="prettyprint lang-config">Alias "/docs" "/var/web"</pre>
<p>the URL <code>http://www.example.com/docs/dir/file.html</code>
will be served from <code>/var/web/dir/file.html</code>. The
<code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code> directive
works the same way, with the additional effect that all content
located at the target path is treated as <a class="glossarylink" href="./glossary.html#cgi" title="see glossary">CGI</a> scripts.</p>
<p>For situations where you require additional flexibility, you
can use the <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code>
and <code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code>
directives to do powerful <a class="glossarylink" href="./glossary.html#regex" title="see glossary">regular
expression</a> based matching and substitution. For
example,</p>
<pre class="prettyprint lang-config">ScriptAliasMatch "^/~([a-zA-Z0-9]+)/cgi-bin/(.+)" "/home/$1/cgi-bin/$2"</pre>
<p>will map a request to
<code>http://example.com/~user/cgi-bin/script.cgi</code> to the
path <code>/home/user/cgi-bin/script.cgi</code> and will treat
the resulting file as a CGI script.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="user" id="user">User Directories</a></h2>
<p>Traditionally on Unix systems, the home directory of a
particular <em>user</em> can be referred to as
<code>~user/</code>. The module <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>
extends this idea to the web by allowing files under each user's
home directory to be accessed using URLs such as the
following.</p>
<div class="example"><p><code>http://www.example.com/~user/file.html</code></p></div>
<p>For security reasons, it is inappropriate to give direct
access to a user's home directory from the web. Therefore, the
<code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> directive
specifies a directory underneath the user's home directory
where web files are located. Using the default setting of
<code>Userdir public_html</code>, the above URL maps to a file
at a directory like
<code>/home/user/public_html/file.html</code> where
<code>/home/user/</code> is the user's home directory as
specified in <code>/etc/passwd</code>.</p>
<p>There are also several other forms of the
<code>Userdir</code> directive which you can use on systems
where <code>/etc/passwd</code> does not contain the location of
the home directory.</p>
<p>Some people find the "~" symbol (which is often encoded on the
web as <code>%7e</code>) to be awkward and prefer to use an
alternate string to represent user directories. This functionality
is not supported by mod_userdir. However, if users' home
directories are structured in a regular way, then it is possible
to use the <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code>
directive to achieve the desired effect. For example, to make
<code>http://www.example.com/upages/user/file.html</code> map to
<code>/home/user/public_html/file.html</code>, use the following
<code>AliasMatch</code> directive:</p>
<pre class="prettyprint lang-config">AliasMatch "^/upages/([a-zA-Z0-9]+)(/(.*))?$" "/home/$1/public_html/$3"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirect" id="redirect">URL Redirection</a></h2>
<p>The configuration directives discussed in the above sections
tell httpd to get content from a specific place in the filesystem
and return it to the client. Sometimes, it is desirable instead to
inform the client that the requested content is located at a
different URL, and instruct the client to make a new request with
the new URL. This is called <em>redirection</em> and is
implemented by the <code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code> directive. For example, if
the contents of the directory <code>/foo/</code> under the
<code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> are moved
to the new directory <code>/bar/</code>, you can instruct clients
to request the content at the new location as follows:</p>
<pre class="prettyprint lang-config">Redirect permanent "/foo/" "http://www.example.com/bar/"</pre>
<p>This will redirect any URL-Path starting in
<code>/foo/</code> to the same URL path on the
<code>www.example.com</code> server with <code>/bar/</code>
substituted for <code>/foo/</code>. You can redirect clients to
any server, not only the origin server.</p>
<p>httpd also provides a <code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> directive for more
complicated rewriting problems. For example, to redirect requests
for the site home page to a different site, but leave all other
requests alone, use the following configuration:</p>
<pre class="prettyprint lang-config">RedirectMatch permanent "^/$" "http://www.example.com/startpage.html"</pre>
<p>Alternatively, to temporarily redirect all pages on one site
to a particular page on another site, use the following:</p>
<pre class="prettyprint lang-config">RedirectMatch temp ".*" "http://othersite.example.com/startpage.html"</pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Reverse Proxy</a></h2>
<p>httpd also allows you to bring remote documents into the URL space
of the local server. This technique is called <em>reverse
proxying</em> because the web server acts like a proxy server by
fetching the documents from a remote server and returning them to the
client. It is different from normal (forward) proxying because, to the client,
it appears the documents originate at the reverse proxy server.</p>
<p>In the following example, when clients request documents under the
<code>/foo/</code> directory, the server fetches those documents from
the <code>/bar/</code> directory on <code>internal.example.com</code>
and returns them to the client as if they were from the local
server.</p>
<pre class="prettyprint lang-config">ProxyPass "/foo/" "http://internal.example.com/bar/"
ProxyPassReverse "/foo/" "http://internal.example.com/bar/"
ProxyPassReverseCookieDomain internal.example.com public.example.com
ProxyPassReverseCookiePath "/foo/" "/bar/"</pre>
<p>The <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> configures
the server to fetch the appropriate documents, while the
<code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code>
directive rewrites redirects originating at
<code>internal.example.com</code> so that they target the appropriate
directory on the local server. Similarly, the
<code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code>
and <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code>
rewrite cookies set by the backend server.</p>
<p>It is important to note, however, that
links inside the documents will not be rewritten. So any absolute
links on <code>internal.example.com</code> will result in the client
breaking out of the proxy server and requesting directly from
<code>internal.example.com</code>. You can modify these links (and other
content) in a page as it is being served to the client using
<code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code>.</p>
<pre class="prettyprint lang-config">Substitute "s/internal\.example\.com/www.example.com/i"</pre>
<p>For more sophisticated rewriting of links in HTML and XHTML, the
<code class="module"><a href="./mod/mod_proxy_html.html">mod_proxy_html</a></code> module is also available. It allows you
to create maps of URLs that need to be rewritten, so that complex
proxying scenarios can be handled.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="rewrite" id="rewrite">Rewriting Engine</a></h2>
<p>When even more powerful substitution is required, the rewriting
engine provided by <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
can be useful. The directives provided by this module can use
characteristics of the request such as browser type or source IP
address in deciding from where to serve content. In addition,
mod_rewrite can use external database files or programs to
determine how to handle a request. The rewriting engine is capable
of performing all three types of mappings discussed above:
internal redirects (aliases), external redirects, and proxying.
Many practical examples employing mod_rewrite are discussed in the
<a href="rewrite/">detailed mod_rewrite documentation</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="notfound" id="notfound">File Not Found</a></h2>
<p>Inevitably, URLs will be requested for which no matching
file can be found in the filesystem. This can happen for
several reasons. In some cases, it can be a result of moving
documents from one location to another. In this case, it is
best to use <a href="#redirect">URL redirection</a> to inform
clients of the new location of the resource. In this way, you
can assure that old bookmarks and links will continue to work,
even though the resource is at a new location.</p>
<p>Another common cause of "File Not Found" errors is
accidental mistyping of URLs, either directly in the browser,
or in HTML links. httpd provides the module
<code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> (sic) to help with
this problem. When this module is activated, it will intercept
"File Not Found" errors and look for a resource with a similar
filename. If one such file is found, mod_speling will send an
HTTP redirect to the client informing it of the correct
location. If several "close" files are found, a list of
available alternatives will be presented to the client.</p>
<p>An especially useful feature of mod_speling, is that it will
compare filenames without respect to case. This can help
systems where users are unaware of the case-sensitive nature of
URLs and the unix filesystem. But using mod_speling for
anything more than the occasional URL correction can place
additional load on the server, since each "incorrect" request
is followed by a URL redirection and a new request from the
client.</p>
<p><code class="module"><a href="./mod/mod_dir.html">mod_dir</a></code> provides <code class="directive"><a href="./mod/mod_dir.html#fallbackresource">FallbackResource</a></code>, which can be used to map virtual
URIs to a real resource, which then serves them. This is a very
useful replacement for <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> when implementing
a 'front controller'</p>
<p>If all attempts to locate the content fail, httpd returns
an error page with HTTP status code 404 (file not found). The
appearance of this page is controlled with the
<code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> directive
and can be customized in a flexible manner as discussed in the
<a href="custom-error.html">Custom error responses</a>
document.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Other URL Mapping Modules</a></h2>
<p>Other modules available for URL mapping include:</p>
<ul>
<li><code class="module"><a href="./mod/mod_actions.html">mod_actions</a></code> - Maps a request to a CGI script
based on the request method, or resource MIME type.</li>
<li><code class="module"><a href="./mod/mod_dir.html">mod_dir</a></code> - Provides basic mapping of a trailing
slash into an index file such as <code>index.html</code>.</li>
<li><code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code> - Maps a request to a URL based
on where a user clicks on an image embedded in a HTML document.</li>
<li><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> - Selects an appropriate
document based on client preferences such as language or content
compression.</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/urlmapping.html" title="English"> en </a> |
<a href="./fr/urlmapping.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/urlmapping.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/invoking.html.en 0000664 0001751 0001751 00000031057 14737241666 020170 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Starting Apache - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Starting Apache</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>On Windows, Apache is normally run as a service.
For details, see <a href="platform/windows.html#winsvc">Running Apache as a Service</a>.
</p>
<p>On Unix, the <code class="program"><a href="./programs/httpd.html">httpd</a></code> program
is run as a daemon that executes continuously in the
background to handle requests. This document describes how
to invoke <code class="program"><a href="./programs/httpd.html">httpd</a></code>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#startup">How Apache Starts</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errors">Errors During Start-up</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#boot">Starting at Boot-Time</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#info">Additional Information</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="stopping.html">Stopping and Restarting</a></li><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="#comments_section">Comments</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="startup" id="startup">How Apache Starts</a></h2>
<p>If the <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
specified in the configuration file is default of 80 (or any other
port below 1024), then it is necessary to have root privileges in
order to start apache, so that it can bind to this privileged
port. Once the server has started and performed a few preliminary
activities such as opening its log files, it will launch several
<em>child</em> processes which do the work of listening for and
answering requests from clients. The main <code>httpd</code>
process continues to run as the root user, but the child processes
run as a less privileged user. This is controlled by the selected
<a href="mpm.html">Multi-Processing Module</a>.</p>
<p>The recommended method of invoking the <code class="program"><a href="./programs/httpd.html">httpd</a></code>
executable is to use the <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> control script. This
script sets certain environment variables that are necessary for
<code class="program"><a href="./programs/httpd.html">httpd</a></code> to function correctly under some operating
systems, and then invokes the <code class="program"><a href="./programs/httpd.html">httpd</a></code> binary.
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> will pass through any command line
arguments, so any <code class="program"><a href="./programs/httpd.html">httpd</a></code> options may also be used with
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code>. You may also directly edit the
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> script by changing the <code>HTTPD</code>
variable near the top to specify the correct location of the
<code class="program"><a href="./programs/httpd.html">httpd</a></code> binary and any command-line arguments that you
wish to be <em>always</em> present.</p>
<p>The first thing that <code class="program"><a href="./programs/httpd.html">httpd</a></code> does when it is
invoked is to locate and read the <a href="configuring.html">configuration file</a>
<code>httpd.conf</code>. The location of this file is set at
compile-time, but it is possible to specify its location at run
time using the <code>-f</code> command-line option as in</p>
<div class="example"><p><code>/usr/local/apache2/bin/apachectl -f
/usr/local/apache2/conf/httpd.conf</code></p></div>
<p>If all goes well during startup, the server will detach from
the terminal and the command prompt will return almost
immediately. This indicates that the server is up and running.
You can then use your browser to connect to the server and view
the test page in the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> directory.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errors" id="errors">Errors During Start-up</a></h2>
<p>If Apache suffers a fatal problem during startup, it will
write a message describing the problem either to the console or
to the <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> before
exiting. One of the most common error messages is "<code>Unable
to bind to Port ...</code>". This message is usually caused by
either:</p>
<ul>
<li>Trying to start the server on a privileged port when not
logged in as the root user; or</li>
<li>Trying to start the server when there is another instance
of Apache or some other web server already bound to the same
Port.</li>
</ul>
<p>For further trouble-shooting instructions, consult the
Apache <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="boot" id="boot">Starting at Boot-Time</a></h2>
<p>If you want your server to continue running after a system
reboot, you should add a call to <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> to your
system startup files (typically <code>rc.local</code> or a file in
an <code>rc.N</code> directory). This will start Apache as
root. Before doing this ensure that your server is properly
configured for security and access restrictions.</p>
<p>The <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> script is designed to act like a
standard SysV init script; it can take the arguments
<code>start</code>, <code>restart</code>, and <code>stop</code>
and translate them into the appropriate signals to
<code class="program"><a href="./programs/httpd.html">httpd</a></code>. So you can often simply link
<code class="program"><a href="./programs/apachectl.html">apachectl</a></code> into the appropriate init directory. But be
sure to check the exact requirements of your system.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="info" id="info">Additional Information</a></h2>
<p>Additional information about the command-line options of <code class="program"><a href="./programs/httpd.html">httpd</a></code> and <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> as well as other support
programs included with the server is available on the
<a href="programs/">Server and Supporting Programs</a> page.
There is also documentation on all the <a href="mod/">modules</a> included with the Apache distribution
and the <a href="mod/directives.html">directives</a> that they
provide.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./de/invoking.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/invoking.html" title="English"> en </a> |
<a href="./es/invoking.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/invoking.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/invoking.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/invoking.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/invoking.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/invoking.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/new_features_2_0.html.en 0000664 0001751 0001751 00000037062 14737241666 021475 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Overview of new features in Apache HTTP Server 2.0 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Overview of new features in Apache HTTP Server 2.0</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document describes some of the major changes between the
1.3 and 2.0 versions of the Apache HTTP Server.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#core">Core Enhancements</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#module">Module Enhancements</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="upgrading.html">Upgrading to 2.0 from 1.3</a></li><li><a href="#comments_section">Comments</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="core" id="core">Core Enhancements</a></h2>
<dl>
<dt>Unix Threading</dt>
<dd>On Unix systems with POSIX threads support, Apache httpd can
now run in a hybrid multiprocess, multithreaded mode. This
improves scalability for many, but not all configurations.</dd>
<dt>New Build System</dt>
<dd>The build system has been rewritten from scratch to be
based on <code>autoconf</code> and <code>libtool</code>.
This makes Apache httpd's configuration system more similar to
that of other packages.</dd>
<dt>Multiprotocol Support</dt>
<dd>Apache HTTP Server now has some of the infrastructure in place to
support serving multiple protocols. <code class="module"><a href="./mod/mod_echo.html">mod_echo</a></code> has
been written as an example.</dd>
<dt>Better support for non-Unix
platforms</dt>
<dd>Apache HTTP Server 2.0 is faster and more stable on non-Unix
platforms such as BeOS, OS/2, and Windows. With the
introduction of platform-specific <a href="mpm.html">multi-processing modules</a> (MPMs) and the
Apache Portable Runtime (APR), these platforms are now
implemented in their native API, avoiding the often buggy and
poorly performing POSIX-emulation layers.</dd>
<dt>New Apache httpd API</dt>
<dd>The API for modules has changed significantly for 2.0.
Many of the module-ordering/-priority problems from 1.3 should
be gone. 2.0 does much of this automatically, and module ordering
is now done per-hook to allow more flexibility. Also, new calls
have been added that provide additional module capabilities
without patching the core Apache HTTP Server.</dd>
<dt>IPv6 Support</dt>
<dd>On systems where IPv6 is supported by the underlying
Apache Portable Runtime library, Apache httpd gets IPv6 listening
sockets by default. Additionally, the <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>, <code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code>, and <code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> directives support
IPv6 numeric address strings (e.g., "<code>Listen
[2001:db8::1]:8080</code>").</dd>
<dt>Filtering</dt>
<dd>Apache httpd modules may now be written as filters which act on
the stream of content as it is delivered to or from the
server. This allows, for example, the output of CGI scripts to
be parsed for Server Side Include directives using the
<code>INCLUDES</code> filter in <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>. The
module <code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> allows external programs to
act as filters in much the same way that CGI programs can act as
handlers.</dd>
<dt>Multilanguage Error Responses</dt>
<dd>Error response messages to the browser are now provided in
several languages, using SSI documents. They may be customized
by the administrator to achieve a consistent look and feel.</dd>
<dt>Simplified configuration</dt>
<dd>Many confusing directives have been simplified. The often
confusing <code>Port</code> and <code>BindAddress</code> directives
are gone; only the <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
directive is used for IP address binding; the <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> directive specifies the
server name and port number only for redirection and vhost
recognition.</dd>
<dt>Native Windows NT Unicode Support</dt>
<dd>Apache httpd 2.0 on Windows NT now uses utf-8 for all filename
encodings. These directly translate to the underlying Unicode
file system, providing multilanguage support for all Windows
NT-based installations, including Windows 2000 and Windows XP.
<em>This support does not extend to Windows 95, 98 or ME, which
continue to use the machine's local codepage for filesystem
access.</em></dd>
<dt>Regular Expression Library Updated</dt>
<dd>Apache httpd 2.0 includes the <a href="http://www.pcre.org/">Perl
Compatible Regular Expression Library</a> (PCRE). All regular
expression evaluation now uses the more powerful Perl 5
syntax.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="module" id="module">Module Enhancements</a></h2>
<dl>
<dt><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code></dt>
<dd>New module in Apache httpd 2.0. This module is an interface
to the SSL/TLS encryption protocols provided by
OpenSSL.</dd>
<dt><code class="module"><a href="./mod/mod_dav.html">mod_dav</a></code></dt>
<dd>New module in Apache httpd 2.0. This module implements the HTTP
Distributed Authoring and Versioning (DAV) specification for
posting and maintaining web content.</dd>
<dt><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code></dt>
<dd>New module in Apache httpd 2.0. This module allows supporting
browsers to request that content be compressed before delivery,
saving network bandwidth.</dd>
<dt><code class="module">mod_auth_ldap</code></dt>
<dd>New module in Apache httpd 2.0.41. This module allows an LDAP
database to be used to store credentials for HTTP Basic
Authentication. A companion module, <code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>
provides connection pooling and results caching.</dd>
<dt><code class="module"><a href="./mod/mod_auth_digest.html">mod_auth_digest</a></code></dt>
<dd>Includes additional support for session caching across
processes using shared memory.</dd>
<dt><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code></dt>
<dd>New module in Apache httpd 2.0. This experimental module allows
for character set translation or recoding.</dd>
<dt><code class="module"><a href="./mod/mod_file_cache.html">mod_file_cache</a></code></dt>
<dd>New module in Apache httpd 2.0. This module includes the
functionality of <code>mod_mmap_static</code> in Apache HTTP
Server version 1.3, plus adds further caching abilities.</dd>
<dt><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></dt>
<dd>This module is much more flexible in Apache httpd 2.0. It can now
modify request headers used by <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>, and
it can conditionally set response headers.</dd>
<dt><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></dt>
<dd>The proxy module has been completely rewritten to take
advantage of the new filter infrastructure and to implement a
more reliable, HTTP/1.1 compliant proxy. In addition, new
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
configuration sections provide more readable (and internally
faster) control of proxied sites; overloaded <code><Directory
"proxy:..."></code> configuration are not supported. The module
is now divided into specific protocol support modules including
<code>proxy_connect</code>, <code>proxy_ftp</code> and
<code>proxy_http</code>.</dd>
<dt><code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></dt>
<dd>A new <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code> directive can be used to assure that
the client receives a single document in all cases, rather than
NOT ACCEPTABLE or MULTIPLE CHOICES responses. In addition, the
negotiation and MultiViews algorithms have been cleaned up to
provide more consistent results and a new form of type map that
can include document content is provided.</dd>
<dt><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code></dt>
<dd>Autoindex'ed directory listings can now be configured to
use HTML tables for cleaner formatting, and allow finer-grained
control of sorting, including version-sorting, and wildcard
filtering of the directory listing.</dd>
<dt><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></dt>
<dd>New directives allow the default start and end tags for SSI elements
to be changed and allow for error and time format configuration
to take place in the main configuration file rather than in the
SSI document. Results from regular expression parsing and grouping
(now based on Perl's regular expression syntax) can be retrieved
using <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>'s variables <code>$0</code>
.. <code>$9</code>.</dd>
<dt><code class="module">mod_auth_dbm</code></dt>
<dd>Now supports multiple types of DBM-like databases using the
<code class="directive">AuthDBMType</code> directive.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./de/new_features_2_0.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/new_features_2_0.html" title="English"> en </a> |
<a href="./fr/new_features_2_0.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/new_features_2_0.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/new_features_2_0.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./pt-br/new_features_2_0.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a> |
<a href="./tr/new_features_2_0.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/new_features_2_0.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/server-wide.html.en 0000664 0001751 0001751 00000027604 14737241666 020603 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Server-Wide Configuration - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Server-Wide Configuration</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/server-wide.html" title="English"> en </a> |
<a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document explains some of the directives provided by
the <code class="module"><a href="./mod/core.html">core</a></code> server which are used to configure
the basic operations of the server.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#identification">Server Identification</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#locations">File Locations</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#resource">Limiting Resource Usage</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#implementation">Implementation Choices</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="identification" id="identification">Server Identification</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code></li><li><code class="directive"><a href="./mod/core.html#serversignature">ServerSignature</a></code></li><li><code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code></li><li><code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li></ul></td></tr></table>
<p>The <code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code> and
<code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> directives
control what information about the server will be presented
in server-generated documents such as error messages. The
<code class="directive"><a href="./mod/core.html#servertokens">ServerTokens</a></code> directive
sets the value of the Server HTTP response header field.</p>
<p>The <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code>,
<code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> and
<code class="directive"><a href="./mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>
directives are used by the server to determine how to construct
self-referential URLs. For example, when a client requests a
directory, but does not include the trailing slash in the
directory name, httpd must redirect the client to the full
name including the trailing slash so that the client will
correctly resolve relative references in the document.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="locations" id="locations">File Locations</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#scoreboardfile">ScoreBoardFile</a></code></li><li><code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code></li></ul></td></tr></table>
<p>These directives control the locations of the various files
that httpd needs for proper operation. When the pathname used
does not begin with a slash (/), the files are located relative
to the <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>. Be careful
about locating files in paths which are writable by non-root users.
See the <a href="misc/security_tips.html#serverroot">security tips</a>
documentation for more details.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="resource" id="resource">Limiting Resource Usage</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#limitrequestbody">LimitRequestBody</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfields">LimitRequestFields</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestfieldsize">LimitRequestFieldsize</a></code></li><li><code class="directive"><a href="./mod/core.html#limitrequestline">LimitRequestLine</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitcpu">RLimitCPU</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitmem">RLimitMEM</a></code></li><li><code class="directive"><a href="./mod/core.html#rlimitnproc">RLimitNPROC</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code></li></ul></td></tr></table>
<p>The <code class="directive">LimitRequest</code>*
directives are used to place limits on the amount of resources
httpd will use in reading requests from clients. By limiting
these values, some kinds of denial of service attacks can be
mitigated.</p>
<p>The <code class="directive">RLimit</code>* directives
are used to limit the amount of resources which can be used by
processes forked off from the httpd children. In particular,
this will control resources used by CGI scripts and SSI exec
commands.</p>
<p>The <code class="directive"><a href="./mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code>
directive is used with some platforms to control the stack size.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="implementation" id="implementation">Implementation Choices</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code></li></ul></td></tr></table>
<p>The <code class="directive">Mutex</code> directive can be used to change
the underlying implementation used for mutexes, in order to relieve
functional or performance problems with <a class="glossarylink" href="./glossary.html#apr" title="see glossary">APR</a>'s
default choice.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/server-wide.html" title="English"> en </a> |
<a href="./fr/server-wide.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/server-wide.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/server-wide.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/server-wide.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/server-wide.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/upgrading.html.en 0000664 0001751 0001751 00000073756 14737241666 020340 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Upgrading to 2.4 from 2.2 - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Upgrading to 2.4 from 2.2</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/upgrading.html" title="English"> en </a> |
<a href="./fr/upgrading.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>In order to assist folks upgrading, we maintain a document
describing information critical to existing Apache HTTP Server users. These
are intended to be brief notes, and you should be able to find
more information in either the <a href="new_features_2_4.html">New Features</a> document, or in
the <code>src/CHANGES</code> file. Application and module developers
can find a summary of API changes in the <a href="developer/new_api_2_4.html">API updates</a> overview.</p>
<p>This document describes changes in server behavior that might
require you to change your configuration or how you use the server
in order to continue using 2.4 as you are currently using 2.2.
To take advantage of new features in 2.4, see the New Features
document.</p>
<p>This document describes only the changes from 2.2 to 2.4. If you
are upgrading from version 2.0, you should also consult the <a href="http://httpd.apache.org/docs/2.2/upgrading.html">2.0 to 2.2
upgrading document.</a></p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#compile-time">Compile-Time Configuration Changes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#run-time">Run-Time Configuration Changes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#misc">Misc Changes</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#third-party">Third Party Modules</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#commonproblems">Common problems when upgrading</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="new_features_2_4.html">Overview of new features in
Apache HTTP Server 2.4</a></li><li><a href="#comments_section">Comments</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="compile-time" id="compile-time">Compile-Time Configuration Changes</a></h2>
<p>The compilation process is very similar to the one used in
version 2.2. Your old <code>configure</code> command line (as
found in <code>build/config.nice</code> in the installed server
directory) can be used in most cases. There are some changes in
the default settings. Some details of changes:</p>
<ul>
<li>These modules have been removed: mod_authn_default,
mod_authz_default, mod_mem_cache. If you were using
mod_mem_cache in 2.2, look at <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> in
2.4.</li>
<li>All load balancing implementations have been moved to
individual, self-contained mod_proxy submodules, e.g.
<code class="module"><a href="./mod/mod_lbmethod_bybusyness.html">mod_lbmethod_bybusyness</a></code>. You might need
to build and load any of these that your configuration
uses.</li>
<li>Platform support has been removed for BeOS, TPF, and
even older platforms such as A/UX, Next, and Tandem. These were
believed to be broken anyway.</li>
<li>configure: dynamic modules (DSO) are built by default</li>
<li>configure: By default, only a basic set of modules is loaded. The
other <code class="directive">LoadModule</code> directives are commented
out in the configuration file.</li>
<li>configure: the "most" module set gets built by default</li>
<li>configure: the "reallyall" module set adds developer modules
to the "all" set</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="run-time" id="run-time">Run-Time Configuration Changes</a></h2>
<p>There have been significant changes in authorization configuration,
and other minor configuration changes, that could require changes to your 2.2
configuration files before using them for 2.4.</p>
<h3><a name="authz" id="authz">Authorization</a></h3>
<p>Any configuration file that uses authorization will likely
need changes.</p>
<p>You should review the <a href="howto/auth.html">Authentication,
Authorization and Access Control Howto</a>, especially the section
<a href="howto/auth.html#beyond">Beyond just authorization</a>
which explains the new mechanisms for controlling the order in
which the authorization directives are applied.</p>
<p>Directives that control how authorization modules respond when they don't match
the authenticated user have been removed: This includes
AuthzLDAPAuthoritative, AuthzDBDAuthoritative, AuthzDBMAuthoritative,
AuthzGroupFileAuthoritative, AuthzUserAuthoritative,
and AuthzOwnerAuthoritative. These directives have been replaced by the
more expressive <code class="directive"><a href="./mod/mod_authz_core.html#requireany">RequireAny</a></code>,
<code class="directive"><a href="./mod/mod_authz_core.html#requirenone">RequireNone</a></code>, and
<code class="directive"><a href="./mod/mod_authz_core.html#requireall">RequireAll</a></code>.</p>
<p>If you use <code class="module"><a href="./mod/mod_authz_dbm.html">mod_authz_dbm</a></code>, you must port your
configuration to use <code>Require dbm-group ...</code> in place
of <code>Require group ...</code>.</p>
<h4><a name="access" id="access">Access control</a></h4>
<p>In 2.2, access control based on client hostname, IP address,
and other characteristics of client requests was done using the
directives <code class="directive"><a href="./mod/mod_access_compat.html#order">Order</a></code>, <code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code>, <code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code>, and <code class="directive"><a href="./mod/mod_access_compat.html#satisfy">Satisfy</a></code>.</p>
<p>In 2.4, such access control is done in the same way as other
authorization checks, using the new module
<code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>. The old access control idioms
should be replaced by the new authentication mechanisms,
although for compatibility with old configurations, the new
module <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> is provided.</p>
<div class="note"><h3>Mixing old and new directives</h3>
<p>Mixing old directives like <code class="directive"><a href="./mod/mod_access_compat.html#order">Order</a></code>, <code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code> or <code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code> with new ones like
<code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code> is technically possible
but discouraged. <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> was created to support
configurations containing only old directives to facilitate the 2.4 upgrade.
Please check the examples below to get a better idea about issues that might arise.
</p>
</div>
<p>Here are some examples of old and new ways to do the same
access control.</p>
<p>In this example, there is no authentication and all requests are denied.</p>
<div class="example"><h3>2.2 configuration:</h3><pre class="prettyprint lang-config">Order deny,allow
Deny from all</pre>
</div>
<div class="example"><h3>2.4 configuration:</h3><pre class="prettyprint lang-config">Require all denied</pre>
</div>
<p>In this example, there is no authentication and all requests are allowed.</p>
<div class="example"><h3>2.2 configuration:</h3><pre class="prettyprint lang-config">Order allow,deny
Allow from all</pre>
</div>
<div class="example"><h3>2.4 configuration:</h3><pre class="prettyprint lang-config">Require all granted</pre>
</div>
<p>In the following example, there is no authentication and all hosts in the example.org domain
are allowed access; all other hosts are denied access.</p>
<div class="example"><h3>2.2 configuration:</h3><pre class="prettyprint lang-config">Order Deny,Allow
Deny from all
Allow from example.org</pre>
</div>
<div class="example"><h3>2.4 configuration:</h3><pre class="prettyprint lang-config">Require host example.org</pre>
</div>
<p>In the following example, mixing old and new directives leads to
unexpected results.</p>
<div class="example"><h3>Mixing old and new directives: NOT WORKING AS EXPECTED</h3><pre class="prettyprint lang-config">DocumentRoot "/var/www/html"
<Directory "/">
AllowOverride None
Order deny,allow
Deny from all
</Directory>
<Location "/server-status">
SetHandler server-status
Require local
</Location>
access.log - GET /server-status 403 127.0.0.1
error.log - AH01797: client denied by server configuration: /var/www/html/server-status</pre>
</div>
<p>Why httpd denies access to servers-status even if the configuration seems to allow it?
Because <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> directives take precedence
over the <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code> one in this configuration
<a href="sections.html#merging">merge</a> scenario.</p>
<p>This example conversely works as expected:</p>
<div class="example"><h3>Mixing old and new directives: WORKING AS EXPECTED</h3><pre class="prettyprint lang-config">DocumentRoot "/var/www/html"
<Directory "/">
AllowOverride None
Require all denied
</Directory>
<Location "/server-status">
SetHandler server-status
Order deny,allow
Deny from all
Allow From 127.0.0.1
</Location>
access.log - GET /server-status 200 127.0.0.1</pre>
</div>
<p>So even if mixing configuration is still
possible, please try to avoid it when upgrading: either keep old directives and then migrate
to the new ones on a later stage or just migrate everything in bulk.
</p>
<p>In many configurations with authentication, where the value of the
<code class="directive">Satisfy</code> was the default of <em>ALL</em>, snippets
that simply disabled host-based access control are omitted:</p>
<div class="example"><h3>2.2 configuration:</h3><pre class="prettyprint lang-config"># 2.2 config that disables host-based access control and uses only authentication
Order Deny,Allow
Allow from all
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<div class="example"><h3>2.4 configuration:</h3><pre class="prettyprint lang-config"># No replacement of disabling host-based access control needed
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<p>In configurations where both authentication and access control were meaningfully combined, the
access control directives should be migrated. This example allows requests meeting <em>both</em> criteria:</p>
<div class="example"><h3>2.2 configuration:</h3><pre class="prettyprint lang-config">Order allow,deny
Deny from all
# Satisfy ALL is the default
Satisfy ALL
Allow from 127.0.0.1
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<div class="example"><h3>2.4 configuration:</h3><pre class="prettyprint lang-config">AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
<RequireAll>
Require valid-user
Require ip 127.0.0.1
</RequireAll></pre>
</div>
<p>In configurations where both authentication and access control were meaningfully combined, the
access control directives should be migrated. This example allows requests meeting <em>either</em> criteria:</p>
<div class="example"><h3>2.2 configuration:</h3><pre class="prettyprint lang-config">Order allow,deny
Deny from all
Satisfy any
Allow from 127.0.0.1
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<div class="example"><h3>2.4 configuration:</h3><pre class="prettyprint lang-config">AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
# Implicitly <RequireAny>
Require valid-user
Require ip 127.0.0.1</pre>
</div>
<h3><a name="config" id="config">Other configuration changes</a></h3>
<p>Some other small adjustments may be necessary for particular
configurations as discussed below.</p>
<ul>
<li><code class="directive">MaxRequestsPerChild</code> has been renamed to
<code class="directive"><a href="./mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>,
describes more accurately what it does. The old name is still
supported.</li>
<li><code class="directive">MaxClients</code> has been renamed to
<code class="directive"><a href="./mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>,
which describes more accurately what it does. For async MPMs, like
<code class="module"><a href="./mod/event.html">event</a></code>, the maximum number of clients is not
equivalent than the number of worker threads. The old name is still
supported.</li>
<li>The <code class="directive"><a href="./mod/core.html#defaulttype">DefaultType</a></code>
directive no longer has any effect, other than to emit a
warning if it's used with any value other than
<code>none</code>. You need to use other configuration
settings to replace it in 2.4.
</li>
<li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> now
defaults to <code>None</code>.</li>
<li><code class="directive"><a href="./mod/core.html#enablesendfile">EnableSendfile</a></code> now
defaults to Off.</li>
<li><code class="directive"><a href="./mod/core.html#fileetag">FileETag</a></code> now
defaults to "MTime Size" (without INode).</li>
<li><code class="module"><a href="./mod/mod_dav_fs.html">mod_dav_fs</a></code>: The format of the <code class="directive"><a href="./mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> file has changed for
systems with inodes. The old <code class="directive"><a href="./mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> file must be deleted on
upgrade.
</li>
<li><code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code> only
accepts values of <code>On</code> or <code>Off</code>.
Previously, any value other than "Off" or "0" was treated as
"On".</li>
<li>Directives AcceptMutex, LockFile, RewriteLock, SSLMutex,
SSLStaplingMutex, and WatchdogMutexPath have been replaced
with a single <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>
directive. You will need to evaluate any use of these removed
directives in your 2.2 configuration to determine if they can
just be deleted or will need to be replaced using <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.</li>
<li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>: <code class="directive"><a href="./mod/mod_cache.html#cacheignoreurlsessionidentifiers">CacheIgnoreURLSessionIdentifiers</a></code>
now does an exact match against the query string instead of a
partial match. If your configuration was using partial
strings, e.g. using <code>sessionid</code> to match
<code>/someapplication/image.gif;jsessionid=123456789</code>,
then you will need to change to the full string
<code>jsessionid</code>.
</li>
<li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>: The second parameter to
<code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code> only
matches forward proxy content if it begins with the correct
protocol. In 2.2 and earlier, a parameter of '/' matched all
content.</li>
<li><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>: <code class="directive"><a href="./mod/mod_ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></code> is now
consistently a per-directory setting only. If you use this
directive, review your configuration to make sure it is
present in all the necessary directory contexts.</li>
<li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>: <code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code> syntax has changed and
now uses a boolean expression to determine if a filter is applied.
</li>
<li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>:
<ul>
<li>The <code>#if expr</code> element now uses the new <a href="expr.html">expression parser</a>. The old syntax can be
restored with the new directive <code class="directive"><a href="./mod/mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></code>.
</li>
<li>An SSI* config directive in directory scope no longer causes
all other per-directory SSI* directives to be reset to their
default values.</li>
</ul>
</li>
<li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code>: The <code>DebugLevel</code>
option has been removed in favour of per-module <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> configuration.
</li>
<li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>: The <code>DebugLevel</code>
option has been removed in favour of per-module <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> configuration.
</li>
<li><code class="module"><a href="./mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code>: The default setting for
<code>PATH_INFO</code> has changed from httpd 2.2, and
some web applications will no longer operate properly with
the new <code>PATH_INFO</code> setting. The previous setting
can be restored by configuring the <code>proxy-scgi-pathinfo</code>
variable.</li>
<li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>: CRL based revocation checking
now needs to be explicitly configured through <code class="directive"><a href="./mod/mod_ssl.html#sslcarevocationcheck">SSLCARevocationCheck</a></code>.
</li>
<li><code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code>: The maximum line length is now
limited to 1MB.
</li>
<li><code class="module"><a href="./mod/mod_reqtimeout.html">mod_reqtimeout</a></code>: If the module is loaded, it
will now set some default timeouts.</li>
<li><code class="module"><a href="./mod/mod_dumpio.html">mod_dumpio</a></code>: <code class="directive">DumpIOLogLevel</code>
is no longer supported. Data is always logged at <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> <code>trace7</code>.</li>
<li>On Unix platforms, piped logging commands configured using
either <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> or
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> were invoked using
<code>/bin/sh -c</code> in 2.2 and earlier. In 2.4 and later,
piped logging commands are executed directly. To restore the
old behaviour, see the <a href="logs.html#piped">piped logging
documentation</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="misc" id="misc">Misc Changes</a></h2>
<ul>
<li><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code>: will now extract titles and
display descriptions for .xhtml files, which were previously
ignored.</li>
<li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>: The default format of the <code>*_DN</code>
variables has changed. The old format can still be used with the new
<code>LegacyDNStringFormat</code> argument to <code class="directive"><a href="./mod/mod_ssl.html#ssloptions">SSLOptions</a></code>. The SSLv2 protocol is
no longer supported. <code class="directive"><a href="./mod/mod_ssl.html#sslproxycheckpeercn">SSLProxyCheckPeerCN
</a></code> and <code class="directive"><a href="./mod/mod_ssl.html#sslproxycheckpeerexpire">SSLProxyCheckPeerExpire
</a></code> now default to On, causing proxy requests to HTTPS hosts
with bad or outdated certificates to fail with a 502 status code (Bad
gateway)</li>
<li><code class="program"><a href="./programs/htpasswd.html">htpasswd</a></code> now uses MD5 hash by default on
all platforms.</li>
<li>The <code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code>
directive no longer has any effect, other than to emit a
warning. Any address/port combination appearing in multiple
virtual hosts is implicitly treated as a name-based virtual host.
</li>
<li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> will now skip compression if it knows
that the size overhead added by the compression is larger than the data
to be compressed.
</li>
<li>Multi-language error documents from 2.2.x may not work unless
they are adjusted to the new syntax of <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>'s
<code>#if expr=</code> element or the directive
<code class="directive"><a href="./mod/mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></code> is
enabled for the directory containing the error documents.
</li>
<li>The functionality provided by <code>mod_authn_alias</code>
in previous versions (i.e., the <code class="directive"><a href="./mod/mod_authn_core.html#authnprovideralias">AuthnProviderAlias</a></code> directive)
has been moved into <code class="module"><a href="./mod/mod_authn_core.html">mod_authn_core</a></code>.
</li>
<li>The RewriteLog and RewriteLogLevel directives have been removed.
This functionality is now provided by configuring the appropriate
level of logging for the <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> module using
the <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> directive.
See also the <a href="mod/mod_rewrite.html#logging">mod_rewrite logging</a>
section.</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="third-party" id="third-party">Third Party Modules</a></h2>
<p>All modules must be recompiled for 2.4 before being loaded.</p>
<p>Many third-party modules designed for version 2.2 will
otherwise work unchanged with the Apache HTTP Server version 2.4.
Some will require changes; see the <a href="developer/new_api_2_4.html">API
update</a> overview.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="commonproblems" id="commonproblems">Common problems when upgrading</a></h2>
<ul><li>Startup errors:
<ul>
<li><code>Invalid command 'User', perhaps misspelled or defined by a module not included in the server configuration</code> - load module <code class="module"><a href="./mod/mod_unixd.html">mod_unixd</a></code></li>
<li><code>Invalid command 'Require', perhaps misspelled or defined by a module not included in the server configuration</code>, or
<code>Invalid command 'Order', perhaps misspelled or defined by a module not included in the server configuration</code>
- load module <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code>, or update configuration to 2.4 authorization directives.</li>
<li><code>Ignoring deprecated use of DefaultType in line NN of /path/to/httpd.conf</code> - remove <code class="directive"><a href="./mod/core.html#defaulttype">DefaultType</a></code>
and replace with other configuration settings.</li>
<li><code>Invalid command 'AddOutputFilterByType', perhaps misspelled
or defined by a module not included in the server configuration
</code> - <code class="directive"><a href="./mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code>
has moved from the core to mod_filter, which must be loaded.</li>
</ul></li>
<li>Errors serving requests:
<ul>
<li><code>configuration error: couldn't check user: /path</code> -
load module <code class="module"><a href="./mod/mod_authn_core.html">mod_authn_core</a></code>.</li>
<li><code>.htaccess</code> files aren't being processed - Check for an
appropriate <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> directive;
the default changed to <code>None</code> in 2.4.</li>
</ul>
</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/upgrading.html" title="English"> en </a> |
<a href="./fr/upgrading.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/upgrading.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/install.html.en 0000664 0001751 0001751 00000065737 14737241666 020026 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Compiling and Installing - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Compiling and Installing</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>This document covers compilation and installation of the Apache HTTP Server
on Unix and Unix-like systems only. For compiling and
installation on Windows, see <a href="platform/windows.html">Using Apache HTTP Server with Microsoft
Windows</a> and <a href="platform/win_compiling.html">Compiling Apache for Microsoft Windows</a>.
For other platforms, see the <a href="platform/">platform</a> documentation.</p>
<p>Apache httpd uses <code>libtool</code> and <code>autoconf</code>
to create a build environment that looks like many other Open Source
projects.</p>
<p>If you are upgrading from one minor version to the next (for
example, 2.4.8 to 2.4.9), please skip down to the <a href="#upgrading">upgrading</a> section.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Overview for the
impatient</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#requirements">Requirements</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#download">Download</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extract">Extract</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#configure">Configuring the source tree</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#compile">Build</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">Install</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#customize">Customize</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#test">Test</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#upgrading">Upgrading</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#thirdp">Third-party packages</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="programs/configure.html">Configure the source tree</a></li><li><a href="invoking.html">Starting Apache httpd</a></li><li><a href="stopping.html">Stopping and Restarting</a></li><li><a href="#comments_section">Comments</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="overview" id="overview">Overview for the
impatient</a></h2>
<dl>
<dt>Installing on Fedora/CentOS/Red Hat Enterprise Linux</dt>
<dd>
<pre class="prettyprint lang-">sudo yum install httpd
sudo systemctl enable httpd
sudo systemctl start httpd</pre>
<div class="warning">Newer releases of these distros use
<code>dnf</code> rather than <code>yum</code>. See <a href="https://fedoraproject.org/wiki/Apache_HTTP_Server">the
Fedora project's documentation</a> for platform-specific notes.</div>
</dd>
<dt>Installing on Ubuntu/Debian</dt>
<dd>
<pre class="prettyprint lang-">sudo apt install apache2
sudo service apache2 start</pre>
<div class="warning">See <a href="https://help.ubuntu.com/lts/serverguide/httpd.html">Ubuntu's documentation</a> for platform-specific notes.</div>
</dd>
<dt>Installing from source</dt>
<dd>
<table>
<tr>
<td><a href="#download">Download</a></td>
<td>Download the latest release from <a href="http://httpd.apache.org/download.cgi#apache24">http://httpd.apache.org/download.cgi</a>
</td>
</tr>
<tr>
<td><a href="#extract">Extract</a></td>
<td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar<br />
$ cd httpd-<em>NN</em></code></td>
</tr>
<tr>
<td><a href="#configure">Configure</a></td>
<td><code>$ ./configure --prefix=<em>PREFIX</em></code>
</td>
</tr>
<tr>
<td><a href="#compile">Compile</a></td>
<td><code>$ make</code> </td>
</tr>
<tr>
<td><a href="#install">Install</a></td>
<td><code>$ make install</code> </td>
</tr>
<tr>
<td><a href="#customize">Customize</a></td>
<td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
</tr>
<tr>
<td><a href="#test">Test</a></td>
<td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code>
</td>
</tr>
</table>
<p><em>NN</em> must be replaced with the current version
number, and <em>PREFIX</em> must be replaced with the
filesystem path under which the server should be installed. If
<em>PREFIX</em> is not specified, it defaults to
<code>/usr/local/apache2</code>.</p>
<p>Each section of the compilation and installation process is
described in more detail below, beginning with the requirements
for compiling and installing Apache httpd.</p>
</dd>
</dl>
<div class="warning">Don't see your favorite platform mentioned
here? <a href="http://httpd.apache.org/docs-project/">Come help us
improve this doc.</a></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="requirements" id="requirements">Requirements</a></h2>
<p>The following requirements exist for building Apache httpd:</p>
<dl>
<dt>APR and APR-Util</dt>
<dd>Make sure you have APR and APR-Util already installed on
your system. If you don't, or prefer to not use the system-provided
versions, download the latest versions of both APR and APR-Util
from <a href="http://apr.apache.org/">Apache APR</a>, unpack
them into <code>/httpd_source_tree_root/srclib/apr</code> and <code>/httpd_source_tree_root/srclib/apr-util</code>
(be sure the directory names do not have version numbers; for example,
the APR distribution must be under /httpd_source_tree_root/srclib/apr/) and use
<code>./configure</code>'s <code>--with-included-apr</code>
option. On some platforms, you may have to install the
corresponding <code>-dev</code> packages to allow httpd to build
against your installed copy of APR and APR-Util.</dd>
<dt>Perl-Compatible Regular Expressions Library (PCRE)</dt>
<dd>This library is required but not longer bundled with httpd.
Download the source code from <a href="http://www.pcre.org/">http://www.pcre.org</a>,
or install a Port or Package. If your build system can't find
the pcre-config script installed by the PCRE build, point to it
using the <code>--with-pcre</code> parameter. On some platforms,
you may have to install the corresponding <code>-dev</code>
package to allow httpd to build against your installed copy
of PCRE.</dd>
<dt>Disk Space</dt>
<dd>Make sure you have at least 50 MB of temporary free disk
space available. After installation the server occupies
approximately 10 MB of disk space. The actual disk space
requirements will vary considerably based on your chosen
configuration options, any third-party modules, and, of course,
the size of the web site or sites that you have on the server.</dd>
<dt>ANSI-C Compiler and Build System</dt>
<dd>Make sure you have an ANSI-C compiler installed. The <a href="http://gcc.gnu.org/">GNU C
compiler (GCC)</a> from the <a href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
is recommended. If you don't have GCC
then at least make sure your vendor's compiler is ANSI
compliant. In addition, your <code>PATH</code> must contain
basic build tools such as <code>make</code>.</dd>
<dt>Accurate time keeping</dt>
<dd>Elements of the HTTP protocol are expressed as the time of
day. So, it's time to investigate setting some time
synchronization facility on your system. Usually the
<code>ntpdate</code> or <code>xntpd</code> programs are used for
this purpose which are based on the Network Time Protocol (NTP).
See the <a href="http://www.ntp.org">NTP
homepage</a> for more details about NTP software and public
time servers.</dd>
<dt><a href="http://www.perl.org/">Perl 5</a>
[OPTIONAL]</dt>
<dd>For some of the support scripts like <code class="program"><a href="./programs/apxs.html">apxs</a></code> or <code class="program"><a href="./programs/dbmmanage.html">dbmmanage</a></code> (which are
written in Perl) the Perl 5 interpreter is required (versions
5.003 or newer are sufficient). If no Perl 5 interpreter is found by the
<code class="program"><a href="./programs/configure.html">configure</a></code> script, you will not be able to use
the affected support scripts. Of course, you will still be able to
build and use Apache httpd.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="download" id="download">Download</a></h2>
<p>The Apache HTTP Server can be downloaded from the <a href="http://httpd.apache.org/download.cgi">Apache HTTP Server
download site</a>, which lists several mirrors. Most users of
Apache on unix-like systems will be better off downloading and
compiling a source version. The build process (described below) is
easy, and it allows you to customize your server to suit your needs.
In addition, binary releases are often not up to date with the latest
source releases. If you do download a binary, follow the instructions
in the <code>INSTALL.bindist</code> file inside the distribution.</p>
<p>After downloading, it is important to verify that you have a
complete and unmodified version of the Apache HTTP Server. This
can be accomplished by testing the downloaded tarball against the
PGP signature. Details on how to do this are available on the <a href="http://httpd.apache.org/download.cgi#verify">download
page</a> and an extended example is available describing the <a href="http://httpd.apache.org/dev/verification.html">use of
PGP</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="extract" id="extract">Extract</a></h2>
<p>Extracting the source from the Apache HTTP Server tarball is a
simple matter of uncompressing, and then untarring:</p>
<div class="example"><p><code>
$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar
</code></p></div>
<p>This will create a new directory under the current directory
containing the source code for the distribution. You should
<code>cd</code> into that directory before proceeding with
compiling the server.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="configure" id="configure">Configuring the source tree</a></h2>
<p>The next step is to configure the Apache source tree for your
particular platform and personal requirements. This is done using
the script <code class="program"><a href="./programs/configure.html">configure</a></code> included in
the root directory of the distribution. (Developers downloading
an unreleased version of the Apache source tree will need to have
<code>autoconf</code> and <code>libtool</code> installed and will
need to run <code>buildconf</code> before proceeding with the next
steps. This is not necessary for official releases.)</p>
<p>To configure the source tree using all the default options,
simply type <code>./configure</code>. To change the default
options, <code class="program"><a href="./programs/configure.html">configure</a></code> accepts a variety of variables
and command line options.</p>
<p>The most important option is the location <code>--prefix</code>
where Apache is to be installed later, because Apache has to be
configured for this location to work correctly. More fine-tuned
control of the location of files is possible with additional <a href="programs/configure.html#installationdirectories">configure
options</a>.</p>
<p>Also at this point, you can specify which <a href="programs/configure.html#optionalfeatures">features</a> you
want included in Apache by enabling and disabling <a href="mod/">modules</a>. Apache comes with a wide range of modules
included by default. They will be compiled as
<a href="dso.html">shared objects (DSOs)</a> which can be loaded
or unloaded at runtime.
You can also choose to compile modules statically by using the option
<code>--enable-<var>module</var>=static</code>.</p>
<p>Additional modules are enabled using the
<code>--enable-<var>module</var></code> option, where
<var>module</var> is the name of the module with the
<code>mod_</code> string removed and with any underscore converted
to a dash. Similarly, you can disable modules with the
<code>--disable-<var>module</var></code> option. Be careful when
using these options, since <code class="program"><a href="./programs/configure.html">configure</a></code> cannot warn you
if the module you specify does not exist; it will simply ignore the
option.</p>
<p>In addition, it is sometimes necessary to provide the
<code class="program"><a href="./programs/configure.html">configure</a></code> script with extra information about the
location of your compiler, libraries, or header files. This is
done by passing either environment variables or command line
options to <code class="program"><a href="./programs/configure.html">configure</a></code>. For more information, see the
<code class="program"><a href="./programs/configure.html">configure</a></code> manual page. Or invoke
<code class="program"><a href="./programs/configure.html">configure</a></code> using the <code>--help</code> option.</p>
<p>For a short impression of what possibilities you have, here
is a typical example which compiles Apache for the installation
tree <code>/sw/pkg/apache</code> with a particular compiler and flags
plus the two additional modules <code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code> and
<code class="module"><a href="./mod/mod_lua.html">mod_lua</a></code>:</p>
<div class="example"><p><code>
$ CC="pgcc" CFLAGS="-O2" \<br />
./configure --prefix=/sw/pkg/apache \<br />
--enable-ldap=shared \<br />
--enable-lua=shared
</code></p></div>
<p>When <code class="program"><a href="./programs/configure.html">configure</a></code> is run it will take several minutes to
test for the availability of features on your system and build
Makefiles which will later be used to compile the server.</p>
<p>Details on all the different <code class="program"><a href="./programs/configure.html">configure</a></code> options are
available on the <code class="program"><a href="./programs/configure.html">configure</a></code> manual page.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="compile" id="compile">Build</a></h2>
<p>Now you can build the various parts which form the Apache
package by simply running the command:</p>
<div class="example"><p><code>$ make</code></p></div>
<p>Please be patient here, since a base configuration takes
several minutes to compile and the time will vary widely
depending on your hardware and the number of modules that you
have enabled.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">Install</a></h2>
<p>Now it's time to install the package under the configured
installation <em>PREFIX</em> (see <code>--prefix</code> option
above) by running:</p>
<div class="example"><p><code>$ make install</code></p></div>
<p>This step will typically require root privileges, since
<em>PREFIX</em> is usually a directory with restricted write
permissions.</p>
<p>If you are upgrading, the installation will not overwrite
your configuration files or documents.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="customize" id="customize">Customize</a></h2>
<p>Next, you can customize your Apache HTTP server by editing
the <a href="configuring.html">configuration files</a> under
<code><em>PREFIX</em>/conf/</code>.</p>
<div class="example"><p><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code></p></div>
<p>Have a look at the Apache manual under
<code><em>PREFIX</em>/docs/manual/</code> or consult <a href="http://httpd.apache.org/docs/2.4/">http://httpd.apache.org/docs/2.4/</a> for the most recent
version of this manual and a complete reference of available <a href="mod/directives.html">configuration directives</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="test" id="test">Test</a></h2>
<p>Now you can <a href="invoking.html">start</a> your Apache
HTTP server by immediately running:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k start</code></p></div>
<p>You should then be able to request your first document
via the URL <code>http://localhost/</code>. The web page you see is located
under the <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>,
which will usually be <code><em>PREFIX</em>/htdocs/</code>.
Then <a href="stopping.html">stop</a> the server again by
running:</p>
<div class="example"><p><code>$ <em>PREFIX</em>/bin/apachectl -k stop</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="upgrading" id="upgrading">Upgrading</a></h2>
<p>The first step in upgrading is to read the release announcement
and the file <code>CHANGES</code> in the source distribution to
find any changes that may affect your site. When changing between
major releases (for example, from 2.0 to 2.2 or from 2.2 to 2.4),
there will likely be major differences in the compile-time and
run-time configuration that will require manual adjustments. All
modules will also need to be upgraded to accommodate changes in the
module API.</p>
<p>Upgrading from one minor version to the next (for example, from
2.2.55 to 2.2.57) is easier. The <code>make install</code>
process will not overwrite any of your existing documents, log
files, or configuration files. In addition, the developers make
every effort to avoid incompatible changes in the
<code class="program"><a href="./programs/configure.html">configure</a></code> options, run-time configuration, or the
module API between minor versions. In most cases you should be able to
use an identical <code class="program"><a href="./programs/configure.html">configure</a></code> command line, an identical
configuration file, and all of your modules should continue to
work.</p>
<p>To upgrade across minor versions, start by finding the file
<code>config.nice</code> in the <code>build</code> directory of
your installed server or at the root of the source tree for your
old install. This will contain the exact
<code class="program"><a href="./programs/configure.html">configure</a></code> command line that you used to
configure the source tree. Then to upgrade from one version to
the next, you need only copy the <code>config.nice</code> file to
the source tree of the new version, edit it to make any desired
changes, and then run:</p>
<div class="example"><p><code>
$ ./config.nice<br />
$ make<br />
$ make install<br />
$ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br />
$ <em>PREFIX</em>/bin/apachectl -k start<br />
</code></p></div>
<div class="warning">You should always test any new version in your
environment before putting it into production. For example, you
can install and run the new version along side the old one by
using a different <code>--prefix</code> and a
different port (by adjusting the <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> directive) to test for any
incompatibilities before doing the final upgrade.</div>
<p>You can pass additional arguments to <code>config.nice</code>,
which will be appended to your original <code class="program"><a href="./programs/configure.html">configure</a></code>
options:</p>
<div class="example"><p><code>
$ ./config.nice --prefix=/home/test/apache --with-port=90
</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="thirdp" id="thirdp">Third-party packages</a></h2>
<p>A large number of third parties provide their own packaged
distributions of the Apache HTTP Server for installation on
particular platforms. This includes the various Linux distributions,
various third-party Windows packages, Mac OS X, Solaris, and many
more.</p>
<p>Our software license not only permits, but encourages, this kind
of redistribution. However, it does result in a situation where the
configuration layout and defaults on your installation of the server
may differ from what is stated in the documentation. While
unfortunate, this situation is not likely to change any time
soon.</p>
<p>A <a href="http://wiki.apache.org/httpd/DistrosDefaultLayout">description
of these third-party distributions</a> is maintained in the HTTP
Server wiki, and should reflect the current state of these
third-party distributions. However, you will need to familiarize
yourself with your particular platform's package management and
installation procedures.</p>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./de/install.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="./en/install.html" title="English"> en </a> |
<a href="./es/install.html" hreflang="es" rel="alternate" title="Español"> es </a> |
<a href="./fr/install.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/install.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/install.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/install.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/install.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/sections.html.en 0000664 0001751 0001751 00000113012 14737241666 020163 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Configuration Sections - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Configuration Sections</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/sections.html" title="English"> en </a> |
<a href="./fr/sections.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>Directives in the <a href="configuring.html">configuration files</a> may apply to the
entire server, or they may be restricted to apply only to particular
directories, files, hosts, or URLs. This document describes how to
use configuration section containers or <code>.htaccess</code> files
to change the scope of other configuration directives.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#types">Types of Configuration Section Containers</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#file-and-web">Filesystem, Webspace, and Boolean Expressions</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Virtual Hosts</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#proxy">Proxy</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#whatwhere">What Directives are Allowed?</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#merging">How the sections are merged</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="types" id="types">Types of Configuration Section Containers</a></h2>
<table class="related"><tr><th>Related Modules</th><th>Related Directives</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mod_version.html">mod_version</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#if"><If></a></code></li><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/mod_md.html#mdomainsetsection"><MDomainSet></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
<p>There are two basic types of containers. Most containers are
evaluated for each request. The enclosed directives are applied only
for those requests that match the containers. The <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>, <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>, and
<code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
containers, on the other hand, are evaluated only at server startup
and restart. If their conditions are true at startup, then the
enclosed directives will apply to all requests. If the conditions are
not true, the enclosed directives will be ignored.</p>
<p>The <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> directive
encloses directives that will only be applied if an appropriate
parameter is defined on the <code class="program"><a href="./programs/httpd.html">httpd</a></code> command line. For example,
with the following configuration, all requests will be redirected
to another site only if the server is started using
<code>httpd -DClosedForNow</code>:</p>
<pre class="prettyprint lang-config"><IfDefine ClosedForNow>
Redirect "/" "http://otherserver.example.com/"
</IfDefine></pre>
<p>The <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>
directive is very similar, except it encloses directives that will
only be applied if a particular module is available in the server.
The module must either be statically compiled in the server, or it
must be dynamically compiled and its <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> line must be earlier in the
configuration file. This directive should only be used if you need
your configuration file to work whether or not certain modules are
installed. It should not be used to enclose directives that you want
to work all the time, because it can suppress useful error messages
about missing modules.</p>
<p>In the following example, the <code class="directive"><a href="./mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code> directive will be
applied only if <code class="module"><a href="./mod/mod_mime_magic.html">mod_mime_magic</a></code> is available.</p>
<pre class="prettyprint lang-config"><IfModule mod_mime_magic.c>
MimeMagicFile "conf/magic"
</IfModule></pre>
<p>The <code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
directive is very similar to <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> and <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>, except it encloses directives that will
only be applied if a particular version of the server is executing. This
module is designed for the use in test suites and large networks which have to
deal with different httpd versions and different configurations.</p>
<pre class="prettyprint lang-config"><IfVersion >= 2.4>
# this happens only in versions greater or
# equal 2.4.0.
</IfVersion></pre>
<p><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>,
<code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>, and the
<code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
can apply negative conditions by preceding their test with "!".
Also, these sections can be nested to achieve more complex
restrictions.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="file-and-web" id="file-and-web">Filesystem, Webspace, and Boolean Expressions</a></h2>
<p>The most commonly used configuration section containers are the
ones that change the configuration of particular places in the
filesystem or webspace. First, it is important to understand the
difference between the two. The filesystem is the view of your disks
as seen by your operating system. For example, in a default install,
Apache httpd resides at <code>/usr/local/apache2</code> in the Unix
filesystem or <code>"c:/Program Files/Apache Group/Apache2"</code> in
the Windows filesystem. (Note that forward slashes should always be
used as the path separator in Apache httpd configuration files, even for Windows.) In contrast,
the webspace is the view of your site as delivered by the web server
and seen by the client. So the path <code>/dir/</code> in the
webspace corresponds to the path
<code>/usr/local/apache2/htdocs/dir/</code> in the filesystem of a
default Apache httpd install on Unix. The webspace need not map directly to
the filesystem, since webpages may be generated dynamically
from databases or other locations.</p>
<h3><a name="filesystem" id="filesystem">Filesystem Containers</a></h3>
<p>The <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
and <code class="directive"><a href="./mod/core.html#files"><Files></a></code>
directives, along with their <a class="glossarylink" href="./glossary.html#regex" title="see glossary">regex</a>
counterparts, apply directives to
parts of the filesystem. Directives enclosed in a <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> section apply to
the named filesystem directory and all subdirectories of that
directory (as well as the files in those directories).
The same effect can be obtained using <a href="howto/htaccess.html">.htaccess files</a>. For example, in the
following configuration, directory indexes will be enabled for the
<code>/var/web/dir1</code> directory and all subdirectories.</p>
<pre class="prettyprint lang-config"><Directory "/var/web/dir1">
Options +Indexes
</Directory></pre>
<p>Directives enclosed in a <code class="directive"><a href="./mod/core.html#files"><Files></a></code> section apply to any file with
the specified name, regardless of what directory it lies in.
So for example, the following configuration directives will,
when placed in the main section of the configuration file,
deny access to any file named <code>private.html</code> regardless
of where it is found.</p>
<pre class="prettyprint lang-config"><Files "private.html">
Require all denied
</Files></pre>
<p>To address files found in a particular part of the filesystem, the
<code class="directive"><a href="./mod/core.html#files"><Files></a></code> and
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> sections
can be combined. For example, the following configuration will deny
access to <code>/var/web/dir1/private.html</code>,
<code>/var/web/dir1/subdir2/private.html</code>,
<code>/var/web/dir1/subdir3/private.html</code>, and any other instance
of <code>private.html</code> found under the <code>/var/web/dir1/</code>
directory.</p>
<pre class="prettyprint lang-config"><Directory "/var/web/dir1">
<Files "private.html">
Require all denied
</Files>
</Directory></pre>
<h3><a name="webspace" id="webspace">Webspace Containers</a></h3>
<p>The <code class="directive"><a href="./mod/core.html#location"><Location></a></code>
directive and its <a class="glossarylink" href="./glossary.html#regex" title="see glossary">regex</a> counterpart, on
the other hand, change the
configuration for content in the webspace. For example, the following
configuration prevents access to any URL-path that begins in /private.
In particular, it will apply to requests for
<code>http://yoursite.example.com/private</code>,
<code>http://yoursite.example.com/private123</code>, and
<code>http://yoursite.example.com/private/dir/file.html</code> as well
as any other requests starting with the <code>/private</code> string.</p>
<pre class="prettyprint lang-config"><LocationMatch "^/private">
Require all denied
</LocationMatch></pre>
<p>The <code class="directive"><a href="./mod/core.html#location"><Location></a></code>
directive need not have anything to do with the filesystem.
For example, the following example shows how to map a particular
URL to an internal Apache HTTP Server handler provided by <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>.
No file called <code>server-status</code> needs to exist in the
filesystem.</p>
<pre class="prettyprint lang-config"><Location "/server-status">
SetHandler server-status
</Location></pre>
<h3><a name="overlapping-webspace" id="overlapping-webspace">Overlapping Webspace</a></h3>
<p>In order to have two overlapping URLs one has to consider the order in which
certain sections or directives are evaluated. For
<code class="directive"><a href="./mod/core.html#location"><Location></a></code> this would be:</p>
<pre class="prettyprint lang-config"><Location "/foo">
</Location>
<Location "/foo/bar">
</Location></pre>
<p><code class="directive"><a href="./mod/mod_alias.html#alias"><Alias></a></code>es on the other hand,
are mapped vice-versa:</p>
<pre class="prettyprint lang-config">Alias "/foo/bar" "/srv/www/uncommon/bar"
Alias "/foo" "/srv/www/common/foo"</pre>
<p>The same is true for the <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code>
directives:</p>
<pre class="prettyprint lang-config">ProxyPass "/special-area" "http://special.example.com" smax=5 max=10
ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofailover=On</pre>
<h3><a name="wildcards" id="wildcards">Wildcards and Regular Expressions</a></h3>
<p>The <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>, and
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>
directives can each use shell-style wildcard characters as in
<code>fnmatch</code> from the C standard library. The character "*"
matches any sequence of characters, "?" matches any single character,
and "[<em>seq</em>]" matches any character in <em>seq</em>. The "/"
character will not be matched by any wildcard; it must be specified
explicitly.</p>
<p>If even more flexible matching is required, each
container has a regular expression (regex) counterpart <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>, and <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> that allow
perl-compatible
<a class="glossarylink" href="./glossary.html#regex" title="see glossary">regular expressions</a>
to be used in choosing the matches. But see the section below on
configuration merging to find out how using regex sections will change
how directives are applied.</p>
<p>A non-regex wildcard section that changes the configuration of
all user directories could look as follows:</p>
<pre class="prettyprint lang-config"><Directory "/home/*/public_html">
Options Indexes
</Directory></pre>
<p>Using regex sections, we can deny access to many types of image files
at once:</p>
<pre class="prettyprint lang-config"><FilesMatch "\.(?i:gif|jpe?g|png)$">
Require all denied
</FilesMatch></pre>
<p>Regular expressions containing <strong>named groups and
backreferences</strong> are added to the environment with the
corresponding name in uppercase. This allows elements of filename paths
and URLs to be referenced from within <a href="expr.html">expressions</a>
and modules like <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
<pre class="prettyprint lang-config"><DirectoryMatch "^/var/www/combined/(?<SITENAME>[^/]+)">
Require ldap-group "cn=%{env:MATCH_SITENAME},ou=combined,o=Example"
</DirectoryMatch></pre>
<h3><a name="expressions" id="expressions">Boolean expressions</a></h3>
<p>The <code class="directive"><a href="./mod/core.html#if"><If></a></code>
directive change the configuration depending on a condition which can be
expressed by a boolean expression. For example, the following configuration
denies access if the HTTP Referer header does not start with
"http://www.example.com/".</p>
<pre class="prettyprint lang-config"><If "!(%{HTTP_REFERER} -strmatch 'http://www.example.com/*')">
Require all denied
</If></pre>
<h3><a name="whichwhen" id="whichwhen">What to use When</a></h3>
<p>Choosing between filesystem containers and webspace containers is
actually quite easy. When applying directives to objects that reside
in the filesystem always use <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> or <code class="directive"><a href="./mod/core.html#files"><Files></a></code>. When applying directives to objects
that do not reside in the filesystem (such as a webpage generated from
a database), use <code class="directive"><a href="./mod/core.html#location"><Location></a></code>.</p>
<p>It is important to never use <code class="directive"><a href="./mod/core.html#location"><Location></a></code> when trying to restrict
access to objects in the filesystem. This is because many
different webspace locations (URLs) could map to the same filesystem
location, allowing your restrictions to be circumvented.
For example, consider the following configuration:</p>
<pre class="prettyprint lang-config"><Location "/dir/">
Require all denied
</Location></pre>
<p>This works fine if the request is for
<code>http://yoursite.example.com/dir/</code>. But what if you are on
a case-insensitive filesystem? Then your restriction could be easily
circumvented by requesting
<code>http://yoursite.example.com/DIR/</code>. The <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> directive, in
contrast, will apply to any content served from that location,
regardless of how it is called. (An exception is filesystem links.
The same directory can be placed in more than one part of the
filesystem using symbolic links. The <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> directive will follow the symbolic
link without resetting the pathname. Therefore, for the highest level
of security, symbolic links should be disabled with the appropriate
<code class="directive"><a href="./mod/core.html#options">Options</a></code> directive.)</p>
<p>If you are, perhaps, thinking that none of this applies to you
because you use a case-sensitive filesystem, remember that there are
many other ways to map multiple webspace locations to the same
filesystem location. Therefore you should always use the filesystem
containers when you can. There is, however, one exception to this
rule. Putting configuration restrictions in a <code><Location
"/"></code> section is perfectly safe because this section will apply
to all requests regardless of the specific URL.</p>
<h3><a name="nesting" id="nesting">Nesting of sections</a></h3>
<p>Some section types can be nested inside other section types. On the one
hand, <code class="directive"><a href="./mod/core.html#files"><Files></a></code> can be used
inside <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>. On
the other hand, <code class="directive"><a href="./mod/core.html#if"><If></a></code> can
be used inside <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>, and <code class="directive"><a href="./mod/core.html#files"><Files></a></code> sections (but not inside another
<code class="directive"><a href="./mod/core.html#if"><If></a></code>). The regex
counterparts of the named section behave identically.</p>
<p>Nested sections are merged after non-nested sections of the same type.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">Virtual Hosts</a></h2>
<p>The <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
container encloses directives that apply to specific hosts.
This is useful when serving multiple hosts from the same machine
with a different configuration for each. For more information,
see the <a href="vhosts/">Virtual Host Documentation</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Proxy</a></h2>
<p>The <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
and <code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>
containers apply enclosed configuration directives only
to sites accessed through <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>'s proxy server
that match the specified URL. For example, the following configuration
will allow only a subset of clients to access the
<code>www.example.com</code> website using the proxy server:</p>
<pre class="prettyprint lang-config"><Proxy "http://www.example.com/*">
Require host yournetwork.example.com
</Proxy></pre>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="whatwhere" id="whatwhere">What Directives are Allowed?</a></h2>
<p>To find out what directives are allowed in what types of
configuration sections, check the <a href="mod/directive-dict.html#Context">Context</a> of the directive.
Everything that is allowed in
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
sections is also syntactically allowed in
<code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>,
<code class="directive"><a href="./mod/core.html#files"><Files></a></code>,
<code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>,
<code class="directive"><a href="./mod/core.html#location"><Location></a></code>,
<code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>,
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>,
and <code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>
sections. There are some exceptions, however:</p>
<ul>
<li>The <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> directive
works only in <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
sections.</li>
<li>The <code>FollowSymLinks</code> and
<code>SymLinksIfOwnerMatch</code> <code class="directive"><a href="./mod/core.html#options">Options</a></code> work only in <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> sections or
<code>.htaccess</code> files.</li>
<li>The <code class="directive"><a href="./mod/core.html#options">Options</a></code> directive cannot
be used in <code class="directive"><a href="./mod/core.html#files"><Files></a></code>
and <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>
sections.</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="merging" id="merging">How the sections are merged</a></h2>
<p>The configuration sections are applied in a very particular order.
Since this can have important effects on how configuration directives
are interpreted, it is important to understand how this works.</p>
<p>The order of merging is:</p>
<ol>
<li> <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> (except regular expressions)
and <code>.htaccess</code> done simultaneously (with
<code>.htaccess</code>, if allowed, overriding
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>)</li>
<li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>
(and <code><Directory "~"></code>)</li>
<li><code class="directive"><a href="./mod/core.html#files"><Files></a></code> and <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code> done
simultaneously</li>
<li><code class="directive"><a href="./mod/core.html#location"><Location></a></code>
and <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> done simultaneously</li>
<li><code class="directive"><a href="./mod/core.html#if"><If></a></code> sections, even when
they are enclosed in any of the preceding contexts.
</li>
</ol>
<p>Some important remarks:</p>
<ul>
<li>Apart from <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, within each group the sections are
processed in the order they appear in the configuration files.
For example, a request for <em>/foo/bar</em> will match
<code><Location "/foo/bar"></code> and
<code><Location "/foo"></code> (group 4 in this case):
both sections will be evaluated
but in the order they appear in the configuration files.</li>
<li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
(group 1 above) is processed in the order shortest directory
component to longest. For example,
<code><Directory "/var/web/dir"></code> will be processed before
<code><Directory "/var/web/dir/subdir"></code>.</li>
<li>If multiple <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> sections apply
to the same directory they are processed in the configuration file
order.</li>
<li>Configurations included via the <code class="directive"><a href="./mod/core.html#include">Include</a></code> directive will be treated as if
they were inside the including file at the location of the
<code class="directive"><a href="./mod/core.html#include">Include</a></code> directive.</li>
<li>Sections inside <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> sections
are applied <em>after</em> the corresponding sections outside
the virtual host definition. This allows virtual hosts to
override the main server configuration.</li>
<li>When the request is served by <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>, the
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
container takes the place of the <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> container in the processing
order.</li>
<li> Caution should be exercised when mixing related configuration
directives inside and outside of <code class="directive"><a href="./mod/core.html#if"><If></a></code> because of the effect on merging order. Explicit use
of <code class="directive"><a href="./mod/core.html#else"><Else></a></code> can help.
</li>
<li> When <code class="directive"><a href="./mod/core.html#if"><If></a></code> is
used in <code>.htaccess</code>, the enclosed directives in a parent
directory will be merged <em>after</em> non-enclosed directives in a
subdirectory.</li>
</ul>
<div class="note"><h3>Technical Note</h3>
There is actually a
<code><Location></code>/<code><LocationMatch></code>
sequence performed just before the name translation phase
(where <code>Aliases</code> and <code>DocumentRoots</code>
are used to map URLs to filenames). The results of this
sequence are completely thrown away after the translation has
completed.
</div>
<h3><a name="relationship-module-configuration" id="relationship-module-configuration">Relationship between modules and configuration sections</a></h3>
<p>One question that often arises after reading how configuration sections are
merged is related to how and when directives of specific modules like <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
are processed. The answer is not trivial and needs a bit of background.
Each httpd module manages its own configuration, and each of its directives in httpd.conf specify one piece
of configuration in a particular context. httpd does not execute a command as it is read.</p>
<p>At runtime, the core of httpd iterates over the defined configuration sections in the order
described above to determine which ones apply to the current request. When the first section matches,
it is considered the current configuration for this request. If a subsequent section matches too,
then each module with a directive in either of the sections is given a chance to merge its configuration between the two sections. The result is a third configuration, and the process goes on until all the configuration sections
are evaluated.</p>
<p>After the above step, the "real" processing of the HTTP request begins: each module has a chance to run
and perform whatever tasks they like. They can retrieve their own final merged configuration from the core
of the httpd to determine how they should act.</p>
<p>An example can help to visualize the whole process. The following configuration uses the
<code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code> directive of <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> to set
a specific HTTP header. What value will httpd set in the <code>CustomHeaderName</code> header for a request to
<code>/example/index.html</code> ?
</p>
<pre class="prettyprint lang-config"><Directory "/">
Header set CustomHeaderName one
<FilesMatch ".*">
Header set CustomHeaderName three
</FilesMatch>
</Directory>
<Directory "/example">
Header set CustomHeaderName two
</Directory></pre>
<ul>
<li><code class="directive">Directory</code> "/" matches and an initial configuration to set the <code>CustomHeaderName</code> header with the value <code>one</code> is created.</li>
<li><code class="directive">Directory</code> "/example" matches, and since <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> specifies in its code to override in case of a merge, a new configuration is created to set the <code>CustomHeaderName</code> header with the value <code>two</code>.</li>
<li><code class="directive">FilesMatch</code> ".*" matches and another merge opportunity arises, causing the <code>CustomHeaderName</code> header to be set with the value <code>three</code>.</li>
<li>Eventually during the next steps of the HTTP request processing <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> will be called and it will receive the configuration to set the <code>CustomHeaderName</code> header with the value <code>three</code>. <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> normally uses this configuration to perform its job, namely setting the foo header. This does not mean that a module can't perform a more complex action like discarding directives because not needed or deprecated, etc..</li>
</ul>
<p>This is true for .htaccess too since they have the same priority as <code class="directive">Directory</code> in the merge order. The important concept to understand is that configuration sections like <code class="directive">Directory</code> and <code class="directive">FilesMatch</code> are not comparable to module specific directives like <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code> or <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> because they operate on different levels.
</p>
<h3><a name="merge-examples" id="merge-examples">Some useful examples</a></h3>
<p>Below is an artificial example to show the order of
merging. Assuming they all apply to the request, the directives in
this example will be applied in the order A > B > C > D >
E.</p>
<pre class="prettyprint lang-config"><Location "/">
E
</Location>
<Files "f.html">
D
</Files>
<VirtualHost *>
<Directory "/a/b">
B
</Directory>
</VirtualHost>
<DirectoryMatch "^.*b$">
C
</DirectoryMatch>
<Directory "/a/b">
A
</Directory></pre>
<p>For a more concrete example, consider the following. Regardless of
any access restrictions placed in <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> sections, the <code class="directive"><a href="./mod/core.html#location"><Location></a></code> section will be
evaluated last and will allow unrestricted access to the server. In
other words, order of merging is important, so be careful!</p>
<pre class="prettyprint lang-config"><Location "/">
Require all granted
</Location>
# Whoops! This <Directory> section will have no effect
<Directory "/">
<RequireAll>
Require all granted
Require not host badguy.example.com
</RequireAll>
</Directory></pre>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/sections.html" title="English"> en </a> |
<a href="./fr/sections.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/sections.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/suexec.html.en 0000664 0001751 0001751 00000071074 14737241666 017643 0 ustar covener covener <?xml version="1.0" encoding="UTF-8"?>
<!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="en" xml:lang="en"><head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>suEXEC Support - Apache HTTP Server Version 2.4</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p>
<p class="apache">Apache HTTP Server Version 2.4</p>
<img alt="" src="./images/feather.png" /></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 Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>suEXEC Support</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="./en/suexec.html" title="English"> en </a> |
<a href="./fr/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/suexec.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>The <strong>suEXEC</strong> feature provides users of the Apache
HTTP Server the ability
to run <strong>CGI</strong> and <strong>SSI</strong> programs
under user IDs different from the user ID of the calling
web server. Normally, when a CGI or SSI program executes, it
runs as the same user who is running the web server.</p>
<p>Used properly, this feature can reduce
considerably the security risks involved with allowing users to
develop and run private CGI or SSI programs. However, if suEXEC
is improperly configured, it can cause any number of problems
and possibly create new holes in your computer's security. If
you aren't familiar with managing <em>setuid root</em> programs
and the security issues they present, we highly recommend that
you not consider using suEXEC.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#before">Before we begin</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#model">suEXEC Security Model</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#install">Configuring & Installing
suEXEC</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#enable">Enabling & Disabling
suEXEC</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#usage">Using suEXEC</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#debug">Debugging suEXEC</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#jabberwock">Beware the Jabberwock:
Warnings & Examples</a></li>
</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</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="before" id="before">Before we begin</a></h2>
<p>Before jumping head-first into this document,
you should be aware that certain assumptions are made about you and
the environment in which you will be using suexec.</p>
<p>First, it is assumed that you are using a UNIX
derivative operating system that is capable of
<strong>setuid</strong> and <strong>setgid</strong> operations.
All command examples are given in this regard. Other platforms,
if they are capable of supporting suEXEC, may differ in their
configuration.</p>
<p>Second, it is assumed you are familiar with
some basic concepts of your computer's security and its
administration. This involves an understanding of
<strong>setuid/setgid</strong> operations and the various
effects they may have on your system and its level of
security.</p>
<p>Third, it is assumed that you are using an
<strong>unmodified</strong> version of suEXEC code. All code
for suEXEC has been carefully scrutinized and tested by the
developers as well as numerous beta testers. Every precaution
has been taken to ensure a simple yet solidly safe base of
code. Altering this code can cause unexpected problems and new
security risks. It is <strong>highly</strong> recommended you
not alter the suEXEC code unless you are well versed in the
particulars of security programming and are willing to share
your work with the Apache HTTP Server development team for consideration.</p>
<p>Fourth, and last, it has been the decision of
the Apache HTTP Server development team to <strong>NOT</strong> make suEXEC part of
the default installation of Apache httpd. To this end, suEXEC
configuration requires of the administrator careful attention
to details. After due consideration has been given to the
various settings for suEXEC, the administrator may install
suEXEC through normal installation methods. The values for
these settings need to be carefully determined and specified by
the administrator to properly maintain system security during
the use of suEXEC functionality. It is through this detailed
process that we hope to limit suEXEC
installation only to those who are careful and determined
enough to use it.</p>
<p>Still with us? Yes? Good. Let's move on!</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="model" id="model">suEXEC Security Model</a></h2>
<p>Before we begin configuring and installing
suEXEC, we will first discuss the security model you are about
to implement. By doing so, you may better understand what
exactly is going on inside suEXEC and what precautions are
taken to ensure your system's security.</p>
<p><strong>suEXEC</strong> is based on a setuid
"wrapper" program that is called by the main Apache HTTP Server.
This wrapper is called when an HTTP request is made for a CGI
or SSI program that the administrator has designated to run as
a userid other than that of the main server. When such a
request is made, Apache httpd provides the suEXEC wrapper with the
program's name and the user and group IDs under which the
program is to execute.</p>
<p>The wrapper then employs the following process
to determine success or failure -- if any one of these
conditions fail, the program logs the failure and exits with an
error, otherwise it will continue:</p>
<ol>
<li>
<strong>Is the user executing this wrapper a valid user of
this system?</strong>
<p class="indent">
This is to ensure that the user executing the wrapper is
truly a user of the system.
</p>
</li>
<li>
<strong>Was the wrapper called with the proper number of
arguments?</strong>
<p class="indent">
The wrapper will only execute if it is given the proper
number of arguments. The proper argument format is known
to the Apache HTTP Server. If the wrapper is not receiving
the proper number of arguments, it is either being
hacked, or there is something wrong with the suEXEC
portion of your Apache httpd binary.
</p>
</li>
<li>
<strong>Is this valid user allowed to run the
wrapper?</strong>
<p class="indent">
Is this user the user allowed to run this wrapper? Only
one user (the Apache user) is allowed to execute this
program.
</p>
</li>
<li>
<strong>Does the target CGI or SSI program have an unsafe
hierarchical reference?</strong>
<p class="indent">
Does the target CGI or SSI program's path contain a leading
'/' or have a '..' backreference? These are not allowed; the
target CGI/SSI program must reside within suEXEC's document
root (see <code>--with-suexec-docroot=<em>DIR</em></code>
below).
</p>
</li>
<li>
<strong>Is the target user name valid?</strong>
<p class="indent">
Does the target user exist?
</p>
</li>
<li>
<strong>Is the target group name valid?</strong>
<p class="indent">
Does the target group exist?
</p>
</li>
<li>
<strong>Is the target user <em>NOT</em> superuser?</strong>
<p class="indent">
suEXEC does not allow <code><em>root</em></code>
to execute CGI/SSI programs.
</p>
</li>
<li>
<strong>Is the target userid <em>ABOVE</em> the minimum ID
number?</strong>
<p class="indent">
The minimum user ID number is specified during
configuration. This allows you to set the lowest possible
userid that will be allowed to execute CGI/SSI programs.
This is useful to block out "system" accounts.
</p>
</li>
<li>
<strong>Is the target group <em>NOT</em> the superuser
group?</strong>
<p class="indent">
Presently, suEXEC does not allow the <code><em>root</em></code>
group to execute CGI/SSI programs.
</p>
</li>
<li>
<strong>Is the target groupid <em>ABOVE</em> the minimum ID
number?</strong>
<p class="indent">
The minimum group ID number is specified during
configuration. This allows you to set the lowest possible
groupid that will be allowed to execute CGI/SSI programs.
This is useful to block out "system" groups.
</p>
</li>
<li>
<strong>Can the wrapper successfully become the target user
and group?</strong>
<p class="indent">
Here is where the program becomes the target user and
group via setuid and setgid calls. The group access list
is also initialized with all of the groups of which the
user is a member.
</p>
</li>
<li>
<strong>Can we change directory to the one in which the target
CGI/SSI program resides?</strong>
<p class="indent">
If it doesn't exist, it can't very well contain files. If we
can't change directory to it, it might as well not exist.
</p>
</li>
<li>
<strong>Is the directory within the httpd webspace?</strong>
<p class="indent">
If the request is for a regular portion of the server, is
the requested directory within suEXEC's document root? If
the request is for a <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code>, is the requested directory
within the directory configured as suEXEC's userdir (see
<a href="#install">suEXEC's configuration options</a>)?
</p>
</li>
<li>
<strong>Is the directory <em>NOT</em> writable by anyone
else?</strong>
<p class="indent">
We don't want to open up the directory to others; only
the owner user may be able to alter this directories
contents.
</p>
</li>
<li>
<strong>Does the target CGI/SSI program exist?</strong>
<p class="indent">
If it doesn't exists, it can't very well be executed.
</p>
</li>
<li>
<strong>Is the target CGI/SSI program <em>NOT</em> writable
by anyone else?</strong>
<p class="indent">
We don't want to give anyone other than the owner the
ability to change the CGI/SSI program.
</p>
</li>
<li>
<strong>Is the target CGI/SSI program <em>NOT</em> setuid or
setgid?</strong>
<p class="indent">
We do not want to execute programs that will then change
our UID/GID again.
</p>
</li>
<li>
<strong>Is the target user/group the same as the program's
user/group?</strong>
<p class="indent">
Is the user the owner of the file?
</p>
</li>
<li>
<strong>Can we successfully clean the process environment
to ensure safe operations?</strong>
<p class="indent">
suEXEC cleans the process's environment by establishing a
safe execution PATH (defined during configuration), as
well as only passing through those variables whose names
are listed in the safe environment list (also created
during configuration).
</p>
</li>
<li>
<strong>Can we successfully become the target CGI/SSI program
and execute?</strong>
<p class="indent">
Here is where suEXEC ends and the target CGI/SSI program begins.
</p>
</li>
</ol>
<p>This is the standard operation of the
suEXEC wrapper's security model. It is somewhat stringent and
can impose new limitations and guidelines for CGI/SSI design,
but it was developed carefully step-by-step with security in
mind.</p>
<p>For more information as to how this security
model can limit your possibilities in regards to server
configuration, as well as what security risks can be avoided
with a proper suEXEC setup, see the <a href="#jabberwock">"Beware the Jabberwock"</a> section of this
document.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="install" id="install">Configuring & Installing
suEXEC</a></h2>
<p>Here's where we begin the fun.</p>
<p><strong>suEXEC configuration
options</strong><br />
</p>
<dl>
<dt><code>--enable-suexec</code></dt>
<dd>This option enables the suEXEC feature which is never
installed or activated by default. At least one
<code>--with-suexec-xxxxx</code> option has to be provided
together with the <code>--enable-suexec</code> option to let
APACI accept your request for using the suEXEC feature.</dd>
<dt><code>--with-suexec-bin=<em>PATH</em></code></dt>
<dd>The path to the <code>suexec</code> binary must be hard-coded
in the server for security reasons. Use this option to override
the default path. <em>e.g.</em>
<code>--with-suexec-bin=/usr/sbin/suexec</code></dd>
<dt><code>--with-suexec-caller=<em>UID</em></code></dt>
<dd>The <a href="mod/mpm_common.html#user">username</a> under which
httpd normally runs. This is the only user allowed to
execute the suEXEC wrapper.</dd>
<dt><code>--with-suexec-userdir=<em>DIR</em></code></dt>
<dd>Define to be the subdirectory under users' home
directories where suEXEC access should be allowed. All
executables under this directory will be executable by suEXEC
as the user so they should be "safe" programs. If you are
using a "simple" <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code>
directive (ie. one without a "*" in it) this should be set to the same
value. suEXEC will not work properly in cases where the <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> directive points to
a location that is not the same as the user's home directory
as referenced in the <code>passwd</code> file. Default value is
"<code>public_html</code>".<br />
If you have virtual hosts with a different <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> for each,
you will need to define them to all reside in one parent
directory; then name that parent directory here. <strong>If
this is not defined properly, "~userdir" cgi requests will
not work!</strong></dd>
<dt><code>--with-suexec-docroot=<em>DIR</em></code></dt>
<dd>Define as the DocumentRoot set for httpd. This will be
the only hierarchy (aside from <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code>s) that can be used for suEXEC behavior. The
default directory is the <code>--datadir</code> value with the suffix
"<code>/htdocs</code>", <em>e.g.</em> if you configure with
"<code>--datadir=/home/apache</code>" the directory
"<code>/home/apache/htdocs</code>" is used as document root for the
suEXEC wrapper.</dd>
<dt><code>--with-suexec-uidmin=<em>UID</em></code></dt>
<dd>Define this as the lowest UID allowed to be a target user
for suEXEC. For most systems, 500 or 100 is common. Default
value is 100.</dd>
<dt><code>--with-suexec-gidmin=<em>GID</em></code></dt>
<dd>Define this as the lowest GID allowed to be a target
group for suEXEC. For most systems, 100 is common and
therefore used as default value.</dd>
<dt><code>--with-suexec-logfile=<em>FILE</em></code></dt>
<dd>This defines the filename to which all suEXEC
transactions and errors are logged (useful for auditing and
debugging purposes). By default the logfile is named
"<code>suexec_log</code>" and located in your standard logfile
directory (<code>--logfiledir</code>).</dd>
<dt><code>--with-suexec-safepath=<em>PATH</em></code></dt>
<dd>Define a safe PATH environment to pass to CGI
executables. Default value is
"<code>/usr/local/bin:/usr/bin:/bin</code>".</dd>
</dl>
<h3>Compiling and installing the suEXEC wrapper</h3>
<p>If you have enabled the suEXEC feature with the
<code>--enable-suexec</code> option the <code>suexec</code> binary
(together with httpd itself) is automatically built if you execute
the <code>make</code> command.</p>
<p>After all components have been built you can execute the
command <code>make install</code> to install them. The binary image
<code>suexec</code> is installed in the directory defined by the
<code>--sbindir</code> option. The default location is
"/usr/local/apache2/bin/suexec".</p>
<p>Please note that you need <strong><em>root
privileges</em></strong> for the installation step. In order
for the wrapper to set the user ID, it must be installed as
owner <code><em>root</em></code> and must have the setuserid
execution bit set for file modes.</p>
<h3>Setting paranoid permissions</h3>
<p>Although the suEXEC wrapper will check to ensure that its
caller is the correct user as specified with the
<code>--with-suexec-caller</code> <code class="program"><a href="./programs/configure.html">configure</a></code>
option, there is
always the possibility that a system or library call suEXEC uses
before this check may be exploitable on your system. To counter
this, and because it is best-practise in general, you should use
filesystem permissions to ensure that only the group httpd
runs as may execute suEXEC.</p>
<p>If for example, your web server is configured to run as:</p>
<pre class="prettyprint lang-config">User www
Group webgroup</pre>
<p>and <code class="program"><a href="./programs/suexec.html">suexec</a></code> is installed at
"/usr/local/apache2/bin/suexec", you should run:</p>
<div class="example"><p><code>
chgrp webgroup /usr/local/apache2/bin/suexec<br />
chmod 4750 /usr/local/apache2/bin/suexec<br />
</code></p></div>
<p>This will ensure that only the group httpd runs as can even
execute the suEXEC wrapper.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="enable" id="enable">Enabling & Disabling
suEXEC</a></h2>
<p>Upon startup of httpd, it looks for the file
<code class="program"><a href="./programs/suexec.html">suexec</a></code> in the directory defined by the
<code>--sbindir</code> option (default is
"/usr/local/apache/sbin/suexec"). If httpd finds a properly
configured suEXEC wrapper, it will print the following message
to the error log:</p>
<div class="example"><p><code>
[notice] suEXEC mechanism enabled (wrapper: <var>/path/to/suexec</var>)
</code></p></div>
<p>If you don't see this message at server startup, the server is
most likely not finding the wrapper program where it expects
it, or the executable is not installed <em>setuid root</em>.</p>
<p>If you want to enable the suEXEC mechanism for the first time
and an Apache HTTP Server is already running you must kill and
restart httpd. Restarting it with a simple HUP or USR1 signal
will not be enough. </p>
<p>If you want to disable suEXEC you should kill and restart
httpd after you have removed the <code class="program"><a href="./programs/suexec.html">suexec</a></code> file.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="usage" id="usage">Using suEXEC</a></h2>
<p>Requests for CGI programs will call the suEXEC wrapper only if
they are for a virtual host containing a <code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> directive or if
they are processed by <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>.</p>
<p><strong>Virtual Hosts:</strong><br /> One way to use the suEXEC
wrapper is through the <code class="directive"><a href="./mod/mod_suexec.html#suexecusergroup">SuexecUserGroup</a></code> directive in
<code class="directive"><a href="./mod/core.html#virtualhost">VirtualHost</a></code> definitions. By
setting this directive to values different from the main server
user ID, all requests for CGI resources will be executed as the
<em>User</em> and <em>Group</em> defined for that <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>. If this
directive is not specified for a <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> then the main server userid
is assumed.</p>
<p><strong>User directories:</strong><br /> Requests that are
processed by <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code> will call the suEXEC
wrapper to execute CGI programs under the userid of the requested
user directory. The only requirement needed for this feature to
work is for CGI execution to be enabled for the user and that the
script must meet the scrutiny of the <a href="#model">security
checks</a> above. See also the
<code>--with-suexec-userdir</code> <a href="#install">compile
time option</a>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="debug" id="debug">Debugging suEXEC</a></h2>
<p>The suEXEC wrapper will write log information
to the file defined with the <code>--with-suexec-logfile</code>
option as indicated above. If you feel you have configured and
installed the wrapper properly, have a look at this log and the
error_log for the server to see where you may have gone astray.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="jabberwock" id="jabberwock">Beware the Jabberwock:
Warnings & Examples</a></h2>
<p><strong>NOTE!</strong> This section may not be
complete.</p>
<p>There are a few points of interest regarding
the wrapper that can cause limitations on server setup. Please
review these before submitting any "bugs" regarding suEXEC.</p>
<p><strong>suEXEC Points Of Interest</strong></p>
<ul>
<li>
Hierarchy limitations
<p class="indent">
For security and efficiency reasons, all suEXEC requests
must remain within either a top-level document root for
virtual host requests, or one top-level personal document
root for userdir requests. For example, if you have four
VirtualHosts configured, you would need to structure all
of your VHosts' document roots off of one main httpd
document hierarchy to take advantage of suEXEC for
VirtualHosts. (Example forthcoming.)
</p>
</li>
<li>
suEXEC's PATH environment variable
<p class="indent">
This can be a dangerous thing to change. Make certain
every path you include in this define is a
<strong>trusted</strong> directory. You don't want to
open people up to having someone from across the world
running a trojan horse on them.
</p>
</li>
<li>
Altering the suEXEC code
<p class="indent">
Again, this can cause <strong>Big Trouble</strong> if you
try this without knowing what you are doing. Stay away
from it if at all possible.
</p>
</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="./en/suexec.html" title="English"> en </a> |
<a href="./fr/suexec.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="./ja/suexec.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/suexec.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/suexec.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/suexec.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2025 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/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html> httpd-2.4.64/docs/manual/server-wide.html 0000664 0001751 0001751 00000000751 13710016232 020147 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: server-wide.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: server-wide.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: server-wide.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: server-wide.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: server-wide.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/convenience.map 0000664 0001751 0001751 00000111347 14236245221 020032 0 ustar covener covener # Mapping from directive names to URLs
# GENERATED FROM XML -- DO NOT EDIT
# You may use it as follows:
# RewriteEngine On
# RewriteMap dir2url txt:/path/to/convenience.map
# RewriteCond ${dir2url:$1} (.+)
# RewriteRule ^/+([^/]+)$ /manual/%1 [R=301,NE,L]
acceptfilter mod/core.html#acceptfilter
acceptpathinfo mod/core.html#acceptpathinfo
accessfilename mod/core.html#accessfilename
action mod/mod_actions.html#action
addalt mod/mod_autoindex.html#addalt
addaltbyencoding mod/mod_autoindex.html#addaltbyencoding
addaltbytype mod/mod_autoindex.html#addaltbytype
addcharset mod/mod_mime.html#addcharset
adddefaultcharset mod/core.html#adddefaultcharset
adddescription mod/mod_autoindex.html#adddescription
addencoding mod/mod_mime.html#addencoding
addhandler mod/mod_mime.html#addhandler
addicon mod/mod_autoindex.html#addicon
addiconbyencoding mod/mod_autoindex.html#addiconbyencoding
addiconbytype mod/mod_autoindex.html#addiconbytype
addinputfilter mod/mod_mime.html#addinputfilter
addlanguage mod/mod_mime.html#addlanguage
addmoduleinfo mod/mod_info.html#addmoduleinfo
addoutputfilter mod/mod_mime.html#addoutputfilter
addoutputfilterbytype mod/mod_filter.html#addoutputfilterbytype
addtype mod/mod_mime.html#addtype
alias mod/mod_alias.html#alias
aliasmatch mod/mod_alias.html#aliasmatch
allow mod/mod_access_compat.html#allow
allowconnect mod/mod_proxy_connect.html#allowconnect
allowencodedslashes mod/core.html#allowencodedslashes
allowmethods mod/mod_allowmethods.html#allowmethods
allowoverride mod/core.html#allowoverride
allowoverridelist mod/core.html#allowoverridelist
anonymous mod/mod_authn_anon.html#anonymous
anonymous_logemail mod/mod_authn_anon.html#anonymous_logemail
anonymous_mustgiveemail mod/mod_authn_anon.html#anonymous_mustgiveemail
anonymous_nouserid mod/mod_authn_anon.html#anonymous_nouserid
anonymous_verifyemail mod/mod_authn_anon.html#anonymous_verifyemail
asyncrequestworkerfactor mod/event.html#asyncrequestworkerfactor
authbasicauthoritative mod/mod_auth_basic.html#authbasicauthoritative
authbasicfake mod/mod_auth_basic.html#authbasicfake
authbasicprovider mod/mod_auth_basic.html#authbasicprovider
authbasicusedigestalgorithm mod/mod_auth_basic.html#authbasicusedigestalgorithm
authdbduserpwquery mod/mod_authn_dbd.html#authdbduserpwquery
authdbduserrealmquery mod/mod_authn_dbd.html#authdbduserrealmquery
authdbmgroupfile mod/mod_authz_dbm.html#authdbmgroupfile
authdbmtype mod/mod_authn_dbm.html#authdbmtype
authdbmuserfile mod/mod_authn_dbm.html#authdbmuserfile
authdigestalgorithm mod/mod_auth_digest.html#authdigestalgorithm
authdigestdomain mod/mod_auth_digest.html#authdigestdomain
authdigestnoncelifetime mod/mod_auth_digest.html#authdigestnoncelifetime
authdigestprovider mod/mod_auth_digest.html#authdigestprovider
authdigestqop mod/mod_auth_digest.html#authdigestqop
authdigestshmemsize mod/mod_auth_digest.html#authdigestshmemsize
authformauthoritative mod/mod_auth_form.html#authformauthoritative
authformbody mod/mod_auth_form.html#authformbody
authformdisablenostore mod/mod_auth_form.html#authformdisablenostore
authformfakebasicauth mod/mod_auth_form.html#authformfakebasicauth
authformlocation mod/mod_auth_form.html#authformlocation
authformloginrequiredlocation mod/mod_auth_form.html#authformloginrequiredlocation
authformloginsuccesslocation mod/mod_auth_form.html#authformloginsuccesslocation
authformlogoutlocation mod/mod_auth_form.html#authformlogoutlocation
authformmethod mod/mod_auth_form.html#authformmethod
authformmimetype mod/mod_auth_form.html#authformmimetype
authformpassword mod/mod_auth_form.html#authformpassword
authformprovider mod/mod_auth_form.html#authformprovider
authformsitepassphrase mod/mod_auth_form.html#authformsitepassphrase
authformsize mod/mod_auth_form.html#authformsize
authformusername mod/mod_auth_form.html#authformusername
authgroupfile mod/mod_authz_groupfile.html#authgroupfile
authldapauthorizeprefix mod/mod_authnz_ldap.html#authldapauthorizeprefix
authldapbindauthoritative mod/mod_authnz_ldap.html#authldapbindauthoritative
authldapbinddn mod/mod_authnz_ldap.html#authldapbinddn
authldapbindpassword mod/mod_authnz_ldap.html#authldapbindpassword
authldapcharsetconfig mod/mod_authnz_ldap.html#authldapcharsetconfig
authldapcompareasuser mod/mod_authnz_ldap.html#authldapcompareasuser
authldapcomparednonserver mod/mod_authnz_ldap.html#authldapcomparednonserver
authldapdereferencealiases mod/mod_authnz_ldap.html#authldapdereferencealiases
authldapgroupattribute mod/mod_authnz_ldap.html#authldapgroupattribute
authldapgroupattributeisdn mod/mod_authnz_ldap.html#authldapgroupattributeisdn
authldapinitialbindasuser mod/mod_authnz_ldap.html#authldapinitialbindasuser
authldapinitialbindpattern mod/mod_authnz_ldap.html#authldapinitialbindpattern
authldapmaxsubgroupdepth mod/mod_authnz_ldap.html#authldapmaxsubgroupdepth
authldapremoteuserattribute mod/mod_authnz_ldap.html#authldapremoteuserattribute
authldapremoteuserisdn mod/mod_authnz_ldap.html#authldapremoteuserisdn
authldapsearchasuser mod/mod_authnz_ldap.html#authldapsearchasuser
authldapsubgroupattribute mod/mod_authnz_ldap.html#authldapsubgroupattribute
authldapsubgroupclass mod/mod_authnz_ldap.html#authldapsubgroupclass
authldapurl mod/mod_authnz_ldap.html#authldapurl
authmerging mod/mod_authz_core.html#authmerging
authname mod/mod_authn_core.html#authname
authncachecontext mod/mod_authn_socache.html#authncachecontext
authncacheenable mod/mod_authn_socache.html#authncacheenable
authncacheprovidefor mod/mod_authn_socache.html#authncacheprovidefor
authncachesocache mod/mod_authn_socache.html#authncachesocache
authncachetimeout mod/mod_authn_socache.html#authncachetimeout
authnprovideralias mod/mod_authn_core.html#authnprovideralias
authnzfcgicheckauthnprovider mod/mod_authnz_fcgi.html#authnzfcgicheckauthnprovider
authnzfcgidefineprovider mod/mod_authnz_fcgi.html#authnzfcgidefineprovider
authtype mod/mod_authn_core.html#authtype
authuserfile mod/mod_authn_file.html#authuserfile
authzdbdlogintoreferer mod/mod_authz_dbd.html#authzdbdlogintoreferer
authzdbdquery mod/mod_authz_dbd.html#authzdbdquery
authzdbdredirectquery mod/mod_authz_dbd.html#authzdbdredirectquery
authzdbmtype mod/mod_authz_dbm.html#authzdbmtype
authzprovideralias mod/mod_authz_core.html#authzprovideralias
authzsendforbiddenonfailure mod/mod_authz_core.html#authzsendforbiddenonfailure
balancergrowth mod/mod_proxy.html#balancergrowth
balancerinherit mod/mod_proxy.html#balancerinherit
balancermember mod/mod_proxy.html#balancermember
balancerpersist mod/mod_proxy.html#balancerpersist
brotlialteretag mod/mod_brotli.html#brotlialteretag
brotlicompressionmaxinputblock mod/mod_brotli.html#brotlicompressionmaxinputblock
brotlicompressionquality mod/mod_brotli.html#brotlicompressionquality
brotlicompressionwindow mod/mod_brotli.html#brotlicompressionwindow
brotlifilternote mod/mod_brotli.html#brotlifilternote
browsermatch mod/mod_setenvif.html#browsermatch
browsermatchnocase mod/mod_setenvif.html#browsermatchnocase
bufferedlogs mod/mod_log_config.html#bufferedlogs
buffersize mod/mod_buffer.html#buffersize
cachedefaultexpire mod/mod_cache.html#cachedefaultexpire
cachedetailheader mod/mod_cache.html#cachedetailheader
cachedirlength mod/mod_cache_disk.html#cachedirlength
cachedirlevels mod/mod_cache_disk.html#cachedirlevels
cachedisable mod/mod_cache.html#cachedisable
cacheenable mod/mod_cache.html#cacheenable
cachefile mod/mod_file_cache.html#cachefile
cacheheader mod/mod_cache.html#cacheheader
cacheignorecachecontrol mod/mod_cache.html#cacheignorecachecontrol
cacheignoreheaders mod/mod_cache.html#cacheignoreheaders
cacheignorenolastmod mod/mod_cache.html#cacheignorenolastmod
cacheignorequerystring mod/mod_cache.html#cacheignorequerystring
cacheignoreurlsessionidentifiers mod/mod_cache.html#cacheignoreurlsessionidentifiers
cachekeybaseurl mod/mod_cache.html#cachekeybaseurl
cachelastmodifiedfactor mod/mod_cache.html#cachelastmodifiedfactor
cachelock mod/mod_cache.html#cachelock
cachelockmaxage mod/mod_cache.html#cachelockmaxage
cachelockpath mod/mod_cache.html#cachelockpath
cachemaxexpire mod/mod_cache.html#cachemaxexpire
cachemaxfilesize mod/mod_cache_disk.html#cachemaxfilesize
cacheminexpire mod/mod_cache.html#cacheminexpire
cacheminfilesize mod/mod_cache_disk.html#cacheminfilesize
cachenegotiateddocs mod/mod_negotiation.html#cachenegotiateddocs
cachequickhandler mod/mod_cache.html#cachequickhandler
cachereadsize mod/mod_cache_disk.html#cachereadsize
cachereadtime mod/mod_cache_disk.html#cachereadtime
cacheroot mod/mod_cache_disk.html#cacheroot
cachesocache mod/mod_cache_socache.html#cachesocache
cachesocachemaxsize mod/mod_cache_socache.html#cachesocachemaxsize
cachesocachemaxtime mod/mod_cache_socache.html#cachesocachemaxtime
cachesocachemintime mod/mod_cache_socache.html#cachesocachemintime
cachesocachereadsize mod/mod_cache_socache.html#cachesocachereadsize
cachesocachereadtime mod/mod_cache_socache.html#cachesocachereadtime
cachestaleonerror mod/mod_cache.html#cachestaleonerror
cachestoreexpired mod/mod_cache.html#cachestoreexpired
cachestorenostore mod/mod_cache.html#cachestorenostore
cachestoreprivate mod/mod_cache.html#cachestoreprivate
cgidscripttimeout mod/mod_cgid.html#cgidscripttimeout
cgimapextension mod/core.html#cgimapextension
cgipassauth mod/core.html#cgipassauth
cgivar mod/core.html#cgivar
charsetdefault mod/mod_charset_lite.html#charsetdefault
charsetoptions mod/mod_charset_lite.html#charsetoptions
charsetsourceenc mod/mod_charset_lite.html#charsetsourceenc
checkbasenamematch mod/mod_speling.html#checkbasenamematch
checkcaseonly mod/mod_speling.html#checkcaseonly
checkspelling mod/mod_speling.html#checkspelling
chrootdir mod/mod_unixd.html#chrootdir
contentdigest mod/core.html#contentdigest
cookiedomain mod/mod_usertrack.html#cookiedomain
cookieexpires mod/mod_usertrack.html#cookieexpires
cookiehttponly mod/mod_usertrack.html#cookiehttponly
cookiename mod/mod_usertrack.html#cookiename
cookiesamesite mod/mod_usertrack.html#cookiesamesite
cookiesecure mod/mod_usertrack.html#cookiesecure
cookiestyle mod/mod_usertrack.html#cookiestyle
cookietracking mod/mod_usertrack.html#cookietracking
coredumpdirectory mod/mpm_common.html#coredumpdirectory
customlog mod/mod_log_config.html#customlog
dav mod/mod_dav.html#dav
davdepthinfinity mod/mod_dav.html#davdepthinfinity
davgenericlockdb mod/mod_dav_lock.html#davgenericlockdb
davlockdb mod/mod_dav_fs.html#davlockdb
davmintimeout mod/mod_dav.html#davmintimeout
dbdexptime mod/mod_dbd.html#dbdexptime
dbdinitsql mod/mod_dbd.html#dbdinitsql
dbdkeep mod/mod_dbd.html#dbdkeep
dbdmax mod/mod_dbd.html#dbdmax
dbdmin mod/mod_dbd.html#dbdmin
dbdparams mod/mod_dbd.html#dbdparams
dbdpersist mod/mod_dbd.html#dbdpersist
dbdpreparesql mod/mod_dbd.html#dbdpreparesql
dbdriver mod/mod_dbd.html#dbdriver
defaulticon mod/mod_autoindex.html#defaulticon
defaultlanguage mod/mod_mime.html#defaultlanguage
defaultruntimedir mod/core.html#defaultruntimedir
defaulttype mod/core.html#defaulttype
define mod/core.html#define
deflatebuffersize mod/mod_deflate.html#deflatebuffersize
deflatecompressionlevel mod/mod_deflate.html#deflatecompressionlevel
deflatefilternote mod/mod_deflate.html#deflatefilternote
deflateinflatelimitrequestbody mod/mod_deflate.html#deflateinflatelimitrequestbody
deflateinflateratioburst mod/mod_deflate.html#deflateinflateratioburst
deflateinflateratiolimit mod/mod_deflate.html#deflateinflateratiolimit
deflatememlevel mod/mod_deflate.html#deflatememlevel
deflatewindowsize mod/mod_deflate.html#deflatewindowsize
deny mod/mod_access_compat.html#deny
directory mod/core.html#directory
directorycheckhandler mod/mod_dir.html#directorycheckhandler
directoryindex mod/mod_dir.html#directoryindex
directoryindexredirect mod/mod_dir.html#directoryindexredirect
directorymatch mod/core.html#directorymatch
directoryslash mod/mod_dir.html#directoryslash
documentroot mod/core.html#documentroot
dtraceprivileges mod/mod_privileges.html#dtraceprivileges
dumpioinput mod/mod_dumpio.html#dumpioinput
dumpiooutput mod/mod_dumpio.html#dumpiooutput
else mod/core.html#else
elseif mod/core.html#elseif
enableexceptionhook mod/mpm_common.html#enableexceptionhook
enablemmap mod/core.html#enablemmap
enablesendfile mod/core.html#enablesendfile
error mod/core.html#error
errordocument mod/core.html#errordocument
errorlog mod/core.html#errorlog
errorlogformat mod/core.html#errorlogformat
example mod/mod_example_hooks.html#example
expiresactive mod/mod_expires.html#expiresactive
expiresbytype mod/mod_expires.html#expiresbytype
expiresdefault mod/mod_expires.html#expiresdefault
extendedstatus mod/core.html#extendedstatus
extfilterdefine mod/mod_ext_filter.html#extfilterdefine
extfilteroptions mod/mod_ext_filter.html#extfilteroptions
fallbackresource mod/mod_dir.html#fallbackresource
fileetag mod/core.html#fileetag
files mod/core.html#files
filesmatch mod/core.html#filesmatch
filterchain mod/mod_filter.html#filterchain
filterdeclare mod/mod_filter.html#filterdeclare
filterprotocol mod/mod_filter.html#filterprotocol
filterprovider mod/mod_filter.html#filterprovider
filtertrace mod/mod_filter.html#filtertrace
flushmaxpipelined mod/core.html#flushmaxpipelined
flushmaxthreshold mod/core.html#flushmaxthreshold
forcelanguagepriority mod/mod_negotiation.html#forcelanguagepriority
forcetype mod/core.html#forcetype
forensiclog mod/mod_log_forensic.html#forensiclog
globallog mod/mod_log_config.html#globallog
gprofdir mod/core.html#gprofdir
gracefulshutdowntimeout mod/mpm_common.html#gracefulshutdowntimeout
group mod/mod_unixd.html#group
h2copyfiles mod/mod_http2.html#h2copyfiles
h2direct mod/mod_http2.html#h2direct
h2earlyhints mod/mod_http2.html#h2earlyhints
h2maxsessionstreams mod/mod_http2.html#h2maxsessionstreams
h2maxworkeridleseconds mod/mod_http2.html#h2maxworkeridleseconds
h2maxworkers mod/mod_http2.html#h2maxworkers
h2minworkers mod/mod_http2.html#h2minworkers
h2moderntlsonly mod/mod_http2.html#h2moderntlsonly
h2outputbuffering mod/mod_http2.html#h2outputbuffering
h2padding mod/mod_http2.html#h2padding
h2push mod/mod_http2.html#h2push
h2pushdiarysize mod/mod_http2.html#h2pushdiarysize
h2pushpriority mod/mod_http2.html#h2pushpriority
h2pushresource mod/mod_http2.html#h2pushresource
h2serializeheaders mod/mod_http2.html#h2serializeheaders
h2streammaxmemsize mod/mod_http2.html#h2streammaxmemsize
h2tlscooldownsecs mod/mod_http2.html#h2tlscooldownsecs
h2tlswarmupsize mod/mod_http2.html#h2tlswarmupsize
h2upgrade mod/mod_http2.html#h2upgrade
h2windowsize mod/mod_http2.html#h2windowsize
header mod/mod_headers.html#header
headername mod/mod_autoindex.html#headername
heartbeataddress mod/mod_heartbeat.html#heartbeataddress
heartbeatlisten mod/mod_heartmonitor.html#heartbeatlisten
heartbeatmaxservers mod/mod_heartmonitor.html#heartbeatmaxservers
heartbeatstorage mod/mod_lbmethod_heartbeat.html#heartbeatstorage
heartbeatstorage mod/mod_heartmonitor.html#heartbeatstorage
hostnamelookups mod/core.html#hostnamelookups
httpprotocoloptions mod/core.html#httpprotocoloptions
identitycheck mod/mod_ident.html#identitycheck
identitychecktimeout mod/mod_ident.html#identitychecktimeout
if mod/core.html#if
ifdefine mod/core.html#ifdefine
ifdirective mod/core.html#ifdirective
iffile mod/core.html#iffile
ifmodule mod/core.html#ifmodule
ifsection mod/core.html#ifsection
ifversion mod/mod_version.html#ifversion
imapbase mod/mod_imagemap.html#imapbase
imapdefault mod/mod_imagemap.html#imapdefault
imapmenu mod/mod_imagemap.html#imapmenu
include mod/core.html#include
includeoptional mod/core.html#includeoptional
indexheadinsert mod/mod_autoindex.html#indexheadinsert
indexignore mod/mod_autoindex.html#indexignore
indexignorereset mod/mod_autoindex.html#indexignorereset
indexoptions mod/mod_autoindex.html#indexoptions
indexorderdefault mod/mod_autoindex.html#indexorderdefault
indexstylesheet mod/mod_autoindex.html#indexstylesheet
inputsed mod/mod_sed.html#inputsed
isapiappendlogtoerrors mod/mod_isapi.html#isapiappendlogtoerrors
isapiappendlogtoquery mod/mod_isapi.html#isapiappendlogtoquery
isapicachefile mod/mod_isapi.html#isapicachefile
isapifakeasync mod/mod_isapi.html#isapifakeasync
isapilognotsupported mod/mod_isapi.html#isapilognotsupported
isapireadaheadbuffer mod/mod_isapi.html#isapireadaheadbuffer
keepalive mod/core.html#keepalive
keepalivetimeout mod/core.html#keepalivetimeout
keptbodysize mod/mod_request.html#keptbodysize
languagepriority mod/mod_negotiation.html#languagepriority
ldapcacheentries mod/mod_ldap.html#ldapcacheentries
ldapcachettl mod/mod_ldap.html#ldapcachettl
ldapconnectionpoolttl mod/mod_ldap.html#ldapconnectionpoolttl
ldapconnectiontimeout mod/mod_ldap.html#ldapconnectiontimeout
ldaplibrarydebug mod/mod_ldap.html#ldaplibrarydebug
ldapopcacheentries mod/mod_ldap.html#ldapopcacheentries
ldapopcachettl mod/mod_ldap.html#ldapopcachettl
ldapreferralhoplimit mod/mod_ldap.html#ldapreferralhoplimit
ldapreferrals mod/mod_ldap.html#ldapreferrals
ldapretries mod/mod_ldap.html#ldapretries
ldapretrydelay mod/mod_ldap.html#ldapretrydelay
ldapsharedcachefile mod/mod_ldap.html#ldapsharedcachefile
ldapsharedcachesize mod/mod_ldap.html#ldapsharedcachesize
ldaptimeout mod/mod_ldap.html#ldaptimeout
ldaptrustedclientcert mod/mod_ldap.html#ldaptrustedclientcert
ldaptrustedglobalcert mod/mod_ldap.html#ldaptrustedglobalcert
ldaptrustedmode mod/mod_ldap.html#ldaptrustedmode
ldapverifyservercert mod/mod_ldap.html#ldapverifyservercert
limit mod/core.html#limit
limitexcept mod/core.html#limitexcept
limitinternalrecursion mod/core.html#limitinternalrecursion
limitrequestbody mod/core.html#limitrequestbody
limitrequestfields mod/core.html#limitrequestfields
limitrequestfieldsize mod/core.html#limitrequestfieldsize
limitrequestline mod/core.html#limitrequestline
limitxmlrequestbody mod/core.html#limitxmlrequestbody
listen mod/mpm_common.html#listen
listenbacklog mod/mpm_common.html#listenbacklog
listencoresbucketsratio mod/mpm_common.html#listencoresbucketsratio
loadfile mod/mod_so.html#loadfile
loadmodule mod/mod_so.html#loadmodule
location mod/core.html#location
locationmatch mod/core.html#locationmatch
logformat mod/mod_log_config.html#logformat
logiotrackttfb mod/mod_logio.html#logiotrackttfb
loglevel mod/core.html#loglevel
logmessage mod/mod_log_debug.html#logmessage
luaauthzprovider mod/mod_lua.html#luaauthzprovider
luacodecache mod/mod_lua.html#luacodecache
luahookaccesschecker mod/mod_lua.html#luahookaccesschecker
luahookauthchecker mod/mod_lua.html#luahookauthchecker
luahookcheckuserid mod/mod_lua.html#luahookcheckuserid
luahookfixups mod/mod_lua.html#luahookfixups
luahookinsertfilter mod/mod_lua.html#luahookinsertfilter
luahooklog mod/mod_lua.html#luahooklog
luahookmaptostorage mod/mod_lua.html#luahookmaptostorage
luahookpretranslate mod/mod_lua.html#luahookpretranslate
luahooktranslatename mod/mod_lua.html#luahooktranslatename
luahooktypechecker mod/mod_lua.html#luahooktypechecker
luainherit mod/mod_lua.html#luainherit
luainputfilter mod/mod_lua.html#luainputfilter
luamaphandler mod/mod_lua.html#luamaphandler
luaoutputfilter mod/mod_lua.html#luaoutputfilter
luapackagecpath mod/mod_lua.html#luapackagecpath
luapackagepath mod/mod_lua.html#luapackagepath
luaquickhandler mod/mod_lua.html#luaquickhandler
luaroot mod/mod_lua.html#luaroot
luascope mod/mod_lua.html#luascope
macro mod/mod_macro.html#macro
maxconnectionsperchild mod/mpm_common.html#maxconnectionsperchild
maxkeepaliverequests mod/core.html#maxkeepaliverequests
maxmemfree mod/mpm_common.html#maxmemfree
maxrangeoverlaps mod/core.html#maxrangeoverlaps
maxrangereversals mod/core.html#maxrangereversals
maxranges mod/core.html#maxranges
maxrequestworkers mod/mpm_common.html#maxrequestworkers
maxspareservers mod/prefork.html#maxspareservers
maxsparethreads mod/mpm_common.html#maxsparethreads
maxthreads mod/mpm_netware.html#maxthreads
mdactivationdelay mod/mod_md.html#mdactivationdelay
mdbaseserver mod/mod_md.html#mdbaseserver
mdcachallenges mod/mod_md.html#mdcachallenges
mdcertificateagreement mod/mod_md.html#mdcertificateagreement
mdcertificateauthority mod/mod_md.html#mdcertificateauthority
mdcertificatecheck mod/mod_md.html#mdcertificatecheck
mdcertificatefile mod/mod_md.html#mdcertificatefile
mdcertificatekeyfile mod/mod_md.html#mdcertificatekeyfile
mdcertificatemonitor mod/mod_md.html#mdcertificatemonitor
mdcertificateprotocol mod/mod_md.html#mdcertificateprotocol
mdcertificatestatus mod/mod_md.html#mdcertificatestatus
mdchallengedns01 mod/mod_md.html#mdchallengedns01
mdcontactemail mod/mod_md.html#mdcontactemail
mddrivemode mod/mod_md.html#mddrivemode
mdexternalaccountbinding mod/mod_md.html#mdexternalaccountbinding
mdhttpproxy mod/mod_md.html#mdhttpproxy
mdmember mod/mod_md.html#mdmember
mdmembers mod/mod_md.html#mdmembers
mdmessagecmd mod/mod_md.html#mdmessagecmd
mdmuststaple mod/mod_md.html#mdmuststaple
mdnotifycmd mod/mod_md.html#mdnotifycmd
mdomain mod/mod_md.html#mdomain
mdomainset mod/mod_md.html#mdomainset
mdportmap mod/mod_md.html#mdportmap
mdprivatekeys mod/mod_md.html#mdprivatekeys
mdrenewmode mod/mod_md.html#mdrenewmode
mdrenewwindow mod/mod_md.html#mdrenewwindow
mdrequirehttps mod/mod_md.html#mdrequirehttps
mdserverstatus mod/mod_md.html#mdserverstatus
mdstapleothers mod/mod_md.html#mdstapleothers
mdstapling mod/mod_md.html#mdstapling
mdstaplingkeepresponse mod/mod_md.html#mdstaplingkeepresponse
mdstaplingrenewwindow mod/mod_md.html#mdstaplingrenewwindow
mdstoredir mod/mod_md.html#mdstoredir
mdwarnwindow mod/mod_md.html#mdwarnwindow
memcacheconnttl mod/mod_socache_memcache.html#memcacheconnttl
mergeslashes mod/core.html#mergeslashes
mergetrailers mod/core.html#mergetrailers
metadir mod/mod_cern_meta.html#metadir
metafiles mod/mod_cern_meta.html#metafiles
metasuffix mod/mod_cern_meta.html#metasuffix
mimemagicfile mod/mod_mime_magic.html#mimemagicfile
minspareservers mod/prefork.html#minspareservers
minsparethreads mod/mpm_common.html#minsparethreads
mmapfile mod/mod_file_cache.html#mmapfile
modemstandard mod/mod_dialup.html#modemstandard
modmimeusepathinfo mod/mod_mime.html#modmimeusepathinfo
multiviewsmatch mod/mod_mime.html#multiviewsmatch
mutex mod/core.html#mutex
namevirtualhost mod/core.html#namevirtualhost
noproxy mod/mod_proxy.html#noproxy
nwssltrustedcerts mod/mod_nw_ssl.html#nwssltrustedcerts
nwsslupgradeable mod/mod_nw_ssl.html#nwsslupgradeable
options mod/core.html#options
order mod/mod_access_compat.html#order
outputsed mod/mod_sed.html#outputsed
passenv mod/mod_env.html#passenv
pidfile mod/mpm_common.html#pidfile
privilegesmode mod/mod_privileges.html#privilegesmode
protocol mod/core.html#protocol
protocolecho mod/mod_echo.html#protocolecho
protocols mod/core.html#protocols
protocolshonororder mod/core.html#protocolshonororder
proxy mod/mod_proxy.html#proxy
proxy100continue mod/mod_proxy.html#proxy100continue
proxyaddheaders mod/mod_proxy.html#proxyaddheaders
proxybadheader mod/mod_proxy.html#proxybadheader
proxyblock mod/mod_proxy.html#proxyblock
proxydomain mod/mod_proxy.html#proxydomain
proxyerroroverride mod/mod_proxy.html#proxyerroroverride
proxyexpressdbmfile mod/mod_proxy_express.html#proxyexpressdbmfile
proxyexpressdbmtype mod/mod_proxy_express.html#proxyexpressdbmtype
proxyexpressenable mod/mod_proxy_express.html#proxyexpressenable
proxyfcgibackendtype mod/mod_proxy_fcgi.html#proxyfcgibackendtype
proxyfcgisetenvif mod/mod_proxy_fcgi.html#proxyfcgisetenvif
proxyftpdircharset mod/mod_proxy_ftp.html#proxyftpdircharset
proxyftpescapewildcards mod/mod_proxy_ftp.html#proxyftpescapewildcards
proxyftplistonwildcard mod/mod_proxy_ftp.html#proxyftplistonwildcard
proxyhcexpr mod/mod_proxy_hcheck.html#proxyhcexpr
proxyhctemplate mod/mod_proxy_hcheck.html#proxyhctemplate
proxyhctpsize mod/mod_proxy_hcheck.html#proxyhctpsize
proxyhtmlbufsize mod/mod_proxy_html.html#proxyhtmlbufsize
proxyhtmlcharsetout mod/mod_proxy_html.html#proxyhtmlcharsetout
proxyhtmldoctype mod/mod_proxy_html.html#proxyhtmldoctype
proxyhtmlenable mod/mod_proxy_html.html#proxyhtmlenable
proxyhtmlevents mod/mod_proxy_html.html#proxyhtmlevents
proxyhtmlextended mod/mod_proxy_html.html#proxyhtmlextended
proxyhtmlfixups mod/mod_proxy_html.html#proxyhtmlfixups
proxyhtmlinterp mod/mod_proxy_html.html#proxyhtmlinterp
proxyhtmllinks mod/mod_proxy_html.html#proxyhtmllinks
proxyhtmlmeta mod/mod_proxy_html.html#proxyhtmlmeta
proxyhtmlstripcomments mod/mod_proxy_html.html#proxyhtmlstripcomments
proxyhtmlurlmap mod/mod_proxy_html.html#proxyhtmlurlmap
proxyiobuffersize mod/mod_proxy.html#proxyiobuffersize
proxymatch mod/mod_proxy.html#proxymatch
proxymaxforwards mod/mod_proxy.html#proxymaxforwards
proxypass mod/mod_proxy.html#proxypass
proxypassinherit mod/mod_proxy.html#proxypassinherit
proxypassinterpolateenv mod/mod_proxy.html#proxypassinterpolateenv
proxypassmatch mod/mod_proxy.html#proxypassmatch
proxypassreverse mod/mod_proxy.html#proxypassreverse
proxypassreversecookiedomain mod/mod_proxy.html#proxypassreversecookiedomain
proxypassreversecookiepath mod/mod_proxy.html#proxypassreversecookiepath
proxypreservehost mod/mod_proxy.html#proxypreservehost
proxyreceivebuffersize mod/mod_proxy.html#proxyreceivebuffersize
proxyremote mod/mod_proxy.html#proxyremote
proxyremotematch mod/mod_proxy.html#proxyremotematch
proxyrequests mod/mod_proxy.html#proxyrequests
proxyscgiinternalredirect mod/mod_proxy_scgi.html#proxyscgiinternalredirect
proxyscgisendfile mod/mod_proxy_scgi.html#proxyscgisendfile
proxyset mod/mod_proxy.html#proxyset
proxysourceaddress mod/mod_proxy.html#proxysourceaddress
proxystatus mod/mod_proxy.html#proxystatus
proxytimeout mod/mod_proxy.html#proxytimeout
proxyvia mod/mod_proxy.html#proxyvia
proxywebsocketfallbacktoproxyhttp mod/mod_proxy_wstunnel.html#proxywebsocketfallbacktoproxyhttp
qualifyredirecturl mod/core.html#qualifyredirecturl
readbuffersize mod/core.html#readbuffersize
readmename mod/mod_autoindex.html#readmename
receivebuffersize mod/mpm_common.html#receivebuffersize
redirect mod/mod_alias.html#redirect
redirectmatch mod/mod_alias.html#redirectmatch
redirectpermanent mod/mod_alias.html#redirectpermanent
redirecttemp mod/mod_alias.html#redirecttemp
redisconnpoolttl mod/mod_socache_redis.html#redisconnpoolttl
redistimeout mod/mod_socache_redis.html#redistimeout
reflectorheader mod/mod_reflector.html#reflectorheader
regexdefaultoptions mod/core.html#regexdefaultoptions
registerhttpmethod mod/core.html#registerhttpmethod
remoteipheader mod/mod_remoteip.html#remoteipheader
remoteipinternalproxy mod/mod_remoteip.html#remoteipinternalproxy
remoteipinternalproxylist mod/mod_remoteip.html#remoteipinternalproxylist
remoteipproxiesheader mod/mod_remoteip.html#remoteipproxiesheader
remoteipproxyprotocol mod/mod_remoteip.html#remoteipproxyprotocol
remoteipproxyprotocolexceptions mod/mod_remoteip.html#remoteipproxyprotocolexceptions
remoteiptrustedproxy mod/mod_remoteip.html#remoteiptrustedproxy
remoteiptrustedproxylist mod/mod_remoteip.html#remoteiptrustedproxylist
removecharset mod/mod_mime.html#removecharset
removeencoding mod/mod_mime.html#removeencoding
removehandler mod/mod_mime.html#removehandler
removeinputfilter mod/mod_mime.html#removeinputfilter
removelanguage mod/mod_mime.html#removelanguage
removeoutputfilter mod/mod_mime.html#removeoutputfilter
removetype mod/mod_mime.html#removetype
requestheader mod/mod_headers.html#requestheader
requestreadtimeout mod/mod_reqtimeout.html#requestreadtimeout
require mod/mod_authz_core.html#require
requireall mod/mod_authz_core.html#requireall
requireany mod/mod_authz_core.html#requireany
requirenone mod/mod_authz_core.html#requirenone
rewritebase mod/mod_rewrite.html#rewritebase
rewritecond mod/mod_rewrite.html#rewritecond
rewriteengine mod/mod_rewrite.html#rewriteengine
rewritemap mod/mod_rewrite.html#rewritemap
rewriteoptions mod/mod_rewrite.html#rewriteoptions
rewriterule mod/mod_rewrite.html#rewriterule
rlimitcpu mod/core.html#rlimitcpu
rlimitmem mod/core.html#rlimitmem
rlimitnproc mod/core.html#rlimitnproc
satisfy mod/mod_access_compat.html#satisfy
scoreboardfile mod/mpm_common.html#scoreboardfile
script mod/mod_actions.html#script
scriptalias mod/mod_alias.html#scriptalias
scriptaliasmatch mod/mod_alias.html#scriptaliasmatch
scriptinterpretersource mod/core.html#scriptinterpretersource
scriptlog mod/mod_cgi.html#scriptlog
scriptlogbuffer mod/mod_cgi.html#scriptlogbuffer
scriptloglength mod/mod_cgi.html#scriptloglength
scriptsock mod/mod_cgid.html#scriptsock
securelisten mod/mod_nw_ssl.html#securelisten
seerequesttail mod/core.html#seerequesttail
sendbuffersize mod/mpm_common.html#sendbuffersize
serveradmin mod/core.html#serveradmin
serveralias mod/core.html#serveralias
serverlimit mod/mpm_common.html#serverlimit
servername mod/core.html#servername
serverpath mod/core.html#serverpath
serverroot mod/core.html#serverroot
serversignature mod/core.html#serversignature
servertokens mod/core.html#servertokens
session mod/mod_session.html#session
sessioncookiename mod/mod_session_cookie.html#sessioncookiename
sessioncookiename2 mod/mod_session_cookie.html#sessioncookiename2
sessioncookieremove mod/mod_session_cookie.html#sessioncookieremove
sessioncryptocipher mod/mod_session_crypto.html#sessioncryptocipher
sessioncryptodriver mod/mod_session_crypto.html#sessioncryptodriver
sessioncryptopassphrase mod/mod_session_crypto.html#sessioncryptopassphrase
sessioncryptopassphrasefile mod/mod_session_crypto.html#sessioncryptopassphrasefile
sessiondbdcookiename mod/mod_session_dbd.html#sessiondbdcookiename
sessiondbdcookiename2 mod/mod_session_dbd.html#sessiondbdcookiename2
sessiondbdcookieremove mod/mod_session_dbd.html#sessiondbdcookieremove
sessiondbddeletelabel mod/mod_session_dbd.html#sessiondbddeletelabel
sessiondbdinsertlabel mod/mod_session_dbd.html#sessiondbdinsertlabel
sessiondbdperuser mod/mod_session_dbd.html#sessiondbdperuser
sessiondbdselectlabel mod/mod_session_dbd.html#sessiondbdselectlabel
sessiondbdupdatelabel mod/mod_session_dbd.html#sessiondbdupdatelabel
sessionenv mod/mod_session.html#sessionenv
sessionexclude mod/mod_session.html#sessionexclude
sessionexpiryupdateinterval mod/mod_session.html#sessionexpiryupdateinterval
sessionheader mod/mod_session.html#sessionheader
sessioninclude mod/mod_session.html#sessioninclude
sessionmaxage mod/mod_session.html#sessionmaxage
setenv mod/mod_env.html#setenv
setenvif mod/mod_setenvif.html#setenvif
setenvifexpr mod/mod_setenvif.html#setenvifexpr
setenvifnocase mod/mod_setenvif.html#setenvifnocase
sethandler mod/core.html#sethandler
setinputfilter mod/core.html#setinputfilter
setoutputfilter mod/core.html#setoutputfilter
ssiendtag mod/mod_include.html#ssiendtag
ssierrormsg mod/mod_include.html#ssierrormsg
ssietag mod/mod_include.html#ssietag
ssilastmodified mod/mod_include.html#ssilastmodified
ssilegacyexprparser mod/mod_include.html#ssilegacyexprparser
ssistarttag mod/mod_include.html#ssistarttag
ssitimeformat mod/mod_include.html#ssitimeformat
ssiundefinedecho mod/mod_include.html#ssiundefinedecho
sslcacertificatefile mod/mod_ssl.html#sslcacertificatefile
sslcacertificatepath mod/mod_ssl.html#sslcacertificatepath
sslcadnrequestfile mod/mod_ssl.html#sslcadnrequestfile
sslcadnrequestpath mod/mod_ssl.html#sslcadnrequestpath
sslcarevocationcheck mod/mod_ssl.html#sslcarevocationcheck
sslcarevocationfile mod/mod_ssl.html#sslcarevocationfile
sslcarevocationpath mod/mod_ssl.html#sslcarevocationpath
sslcertificatechainfile mod/mod_ssl.html#sslcertificatechainfile
sslcertificatefile mod/mod_ssl.html#sslcertificatefile
sslcertificatekeyfile mod/mod_ssl.html#sslcertificatekeyfile
sslciphersuite mod/mod_ssl.html#sslciphersuite
sslcompression mod/mod_ssl.html#sslcompression
sslcryptodevice mod/mod_ssl.html#sslcryptodevice
sslengine mod/mod_ssl.html#sslengine
sslfips mod/mod_ssl.html#sslfips
sslhonorcipherorder mod/mod_ssl.html#sslhonorcipherorder
sslinsecurerenegotiation mod/mod_ssl.html#sslinsecurerenegotiation
sslocspdefaultresponder mod/mod_ssl.html#sslocspdefaultresponder
sslocspenable mod/mod_ssl.html#sslocspenable
sslocspnoverify mod/mod_ssl.html#sslocspnoverify
sslocspoverrideresponder mod/mod_ssl.html#sslocspoverrideresponder
sslocspproxyurl mod/mod_ssl.html#sslocspproxyurl
sslocsprespondercertificatefile mod/mod_ssl.html#sslocsprespondercertificatefile
sslocsprespondertimeout mod/mod_ssl.html#sslocsprespondertimeout
sslocspresponsemaxage mod/mod_ssl.html#sslocspresponsemaxage
sslocspresponsetimeskew mod/mod_ssl.html#sslocspresponsetimeskew
sslocspuserequestnonce mod/mod_ssl.html#sslocspuserequestnonce
sslopensslconfcmd mod/mod_ssl.html#sslopensslconfcmd
ssloptions mod/mod_ssl.html#ssloptions
sslpassphrasedialog mod/mod_ssl.html#sslpassphrasedialog
sslprotocol mod/mod_ssl.html#sslprotocol
sslproxycacertificatefile mod/mod_ssl.html#sslproxycacertificatefile
sslproxycacertificatepath mod/mod_ssl.html#sslproxycacertificatepath
sslproxycarevocationcheck mod/mod_ssl.html#sslproxycarevocationcheck
sslproxycarevocationfile mod/mod_ssl.html#sslproxycarevocationfile
sslproxycarevocationpath mod/mod_ssl.html#sslproxycarevocationpath
sslproxycheckpeercn mod/mod_ssl.html#sslproxycheckpeercn
sslproxycheckpeerexpire mod/mod_ssl.html#sslproxycheckpeerexpire
sslproxycheckpeername mod/mod_ssl.html#sslproxycheckpeername
sslproxyciphersuite mod/mod_ssl.html#sslproxyciphersuite
sslproxyengine mod/mod_ssl.html#sslproxyengine
sslproxymachinecertificatechainfile mod/mod_ssl.html#sslproxymachinecertificatechainfile
sslproxymachinecertificatefile mod/mod_ssl.html#sslproxymachinecertificatefile
sslproxymachinecertificatepath mod/mod_ssl.html#sslproxymachinecertificatepath
sslproxyprotocol mod/mod_ssl.html#sslproxyprotocol
sslproxyverify mod/mod_ssl.html#sslproxyverify
sslproxyverifydepth mod/mod_ssl.html#sslproxyverifydepth
sslrandomseed mod/mod_ssl.html#sslrandomseed
sslrenegbuffersize mod/mod_ssl.html#sslrenegbuffersize
sslrequire mod/mod_ssl.html#sslrequire
sslrequiressl mod/mod_ssl.html#sslrequiressl
sslsessioncache mod/mod_ssl.html#sslsessioncache
sslsessioncachetimeout mod/mod_ssl.html#sslsessioncachetimeout
sslsessionticketkeyfile mod/mod_ssl.html#sslsessionticketkeyfile
sslsessiontickets mod/mod_ssl.html#sslsessiontickets
sslsrpunknownuserseed mod/mod_ssl.html#sslsrpunknownuserseed
sslsrpverifierfile mod/mod_ssl.html#sslsrpverifierfile
sslstaplingcache mod/mod_ssl.html#sslstaplingcache
sslstaplingerrorcachetimeout mod/mod_ssl.html#sslstaplingerrorcachetimeout
sslstaplingfaketrylater mod/mod_ssl.html#sslstaplingfaketrylater
sslstaplingforceurl mod/mod_ssl.html#sslstaplingforceurl
sslstaplingrespondertimeout mod/mod_ssl.html#sslstaplingrespondertimeout
sslstaplingresponsemaxage mod/mod_ssl.html#sslstaplingresponsemaxage
sslstaplingresponsetimeskew mod/mod_ssl.html#sslstaplingresponsetimeskew
sslstaplingreturnrespondererrors mod/mod_ssl.html#sslstaplingreturnrespondererrors
sslstaplingstandardcachetimeout mod/mod_ssl.html#sslstaplingstandardcachetimeout
sslstrictsnivhostcheck mod/mod_ssl.html#sslstrictsnivhostcheck
sslusername mod/mod_ssl.html#sslusername
sslusestapling mod/mod_ssl.html#sslusestapling
sslverifyclient mod/mod_ssl.html#sslverifyclient
sslverifydepth mod/mod_ssl.html#sslverifydepth
startservers mod/mpm_common.html#startservers
startthreads mod/mpm_common.html#startthreads
stricthostcheck mod/core.html#stricthostcheck
substitute mod/mod_substitute.html#substitute
substituteinheritbefore mod/mod_substitute.html#substituteinheritbefore
substitutemaxlinelength mod/mod_substitute.html#substitutemaxlinelength
suexec mod/mod_unixd.html#suexec
suexecusergroup mod/mod_suexec.html#suexecusergroup
threadlimit mod/mpm_common.html#threadlimit
threadsperchild mod/mpm_common.html#threadsperchild
threadstacksize mod/mpm_common.html#threadstacksize
timeout mod/core.html#timeout
tlscertificate mod/mod_tls.html#tlscertificate
tlsciphersprefer mod/mod_tls.html#tlsciphersprefer
tlscipherssuppress mod/mod_tls.html#tlscipherssuppress
tlsengine mod/mod_tls.html#tlsengine
tlshonorclientorder mod/mod_tls.html#tlshonorclientorder
tlsoptions mod/mod_tls.html#tlsoptions
tlsprotocol mod/mod_tls.html#tlsprotocol
tlsproxyca mod/mod_tls.html#tlsproxyca
tlsproxyciphersprefer mod/mod_tls.html#tlsproxyciphersprefer
tlsproxycipherssuppress mod/mod_tls.html#tlsproxycipherssuppress
tlsproxyengine mod/mod_tls.html#tlsproxyengine
tlsproxymachinecertificate mod/mod_tls.html#tlsproxymachinecertificate
tlsproxyprotocol mod/mod_tls.html#tlsproxyprotocol
tlssessioncache mod/mod_tls.html#tlssessioncache
tlsstrictsni mod/mod_tls.html#tlsstrictsni
traceenable mod/core.html#traceenable
transferlog mod/mod_log_config.html#transferlog
typesconfig mod/mod_mime.html#typesconfig
undefine mod/core.html#undefine
undefmacro mod/mod_macro.html#undefmacro
unsetenv mod/mod_env.html#unsetenv
use mod/mod_macro.html#use
usecanonicalname mod/core.html#usecanonicalname
usecanonicalphysicalport mod/core.html#usecanonicalphysicalport
user mod/mod_unixd.html#user
userdir mod/mod_userdir.html#userdir
vhostcgimode mod/mod_privileges.html#vhostcgimode
vhostcgiprivs mod/mod_privileges.html#vhostcgiprivs
vhostgroup mod/mod_privileges.html#vhostgroup
vhostprivs mod/mod_privileges.html#vhostprivs
vhostsecure mod/mod_privileges.html#vhostsecure
vhostuser mod/mod_privileges.html#vhostuser
virtualdocumentroot mod/mod_vhost_alias.html#virtualdocumentroot
virtualdocumentrootip mod/mod_vhost_alias.html#virtualdocumentrootip
virtualhost mod/core.html#virtualhost
virtualscriptalias mod/mod_vhost_alias.html#virtualscriptalias
virtualscriptaliasip mod/mod_vhost_alias.html#virtualscriptaliasip
watchdoginterval mod/mod_watchdog.html#watchdoginterval
xbithack mod/mod_include.html#xbithack
xml2encalias mod/mod_xml2enc.html#xml2encalias
xml2encdefault mod/mod_xml2enc.html#xml2encdefault
xml2startparse mod/mod_xml2enc.html#xml2startparse
httpd-2.4.64/docs/manual/new_features_2_0.html 0000664 0001751 0001751 00000001310 13751537426 021054 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: new_features_2_0.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: new_features_2_0.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: new_features_2_0.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: new_features_2_0.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: new_features_2_0.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: new_features_2_0.html.pt-br
Content-Language: pt-br
Content-type: text/html; charset=ISO-8859-1
URI: new_features_2_0.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/LICENSE 0000664 0001751 0001751 00000026136 10147723030 016041 0 ustar covener covener Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
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.
httpd-2.4.64/docs/manual/content-negotiation.html 0000664 0001751 0001751 00000001021 13710016232 021672 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: content-negotiation.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: content-negotiation.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: content-negotiation.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: content-negotiation.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: content-negotiation.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/getting-started.html 0000664 0001751 0001751 00000000474 13741307256 021037 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: getting-started.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: getting-started.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: getting-started.html.ru.utf8
Content-Language: ru
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/configuring.html 0000664 0001751 0001751 00000001104 13710016232 020216 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: configuring.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: configuring.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: configuring.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: configuring.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: configuring.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: configuring.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/dns-caveats.html 0000664 0001751 0001751 00000000751 13710016232 020123 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: dns-caveats.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: dns-caveats.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: dns-caveats.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: dns-caveats.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: dns-caveats.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/filter.html 0000664 0001751 0001751 00000001046 13710016232 017176 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: filter.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: filter.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: filter.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: filter.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: filter.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: filter.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/invoking.html 0000664 0001751 0001751 00000001212 13710016232 017530 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: invoking.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: invoking.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: invoking.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: invoking.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: invoking.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: invoking.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: invoking.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/new_features_2_2.html 0000664 0001751 0001751 00000001010 13710016232 021031 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: new_features_2_2.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: new_features_2_2.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: new_features_2_2.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: new_features_2_2.html.pt-br
Content-Language: pt-br
Content-type: text/html; charset=ISO-8859-1
URI: new_features_2_2.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/upgrading.html 0000664 0001751 0001751 00000000321 13710016232 017664 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: upgrading.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: upgrading.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/custom-error.html 0000664 0001751 0001751 00000001112 13710016232 020344 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: custom-error.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: custom-error.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: custom-error.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: custom-error.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: custom-error.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: custom-error.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/BUILDING 0000664 0001751 0001751 00000000146 11562045315 016152 0 ustar covener covener For instructions on building the manual, see
<https://httpd.apache.org/docs-project/docsformat.html>.
httpd-2.4.64/docs/manual/handler.html 0000664 0001751 0001751 00000001211 13710016232 017320 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: handler.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: handler.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: handler.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: handler.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: handler.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: handler.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
URI: handler.html.zh-cn.utf8
Content-Language: zh-cn
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/logs.html 0000664 0001751 0001751 00000000706 13710016232 016657 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: logs.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: logs.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: logs.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: logs.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: logs.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/sections.html 0000664 0001751 0001751 00000000732 13710016232 017541 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: sections.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: sections.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: sections.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: sections.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: sections.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/stopping.html 0000664 0001751 0001751 00000001212 13710016232 017547 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: stopping.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: stopping.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: stopping.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: stopping.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: stopping.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: stopping.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: stopping.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/glossary.html 0000664 0001751 0001751 00000001212 13710016232 017547 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: glossary.html.de
Content-Language: de
Content-type: text/html; charset=ISO-8859-1
URI: glossary.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: glossary.html.es
Content-Language: es
Content-type: text/html; charset=ISO-8859-1
URI: glossary.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: glossary.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: glossary.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: glossary.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/new_features_2_4.html 0000664 0001751 0001751 00000000477 13710016232 021053 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: new_features_2_4.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: new_features_2_4.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: new_features_2_4.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/urlmapping.html 0000664 0001751 0001751 00000000744 13710016232 020073 0 ustar covener covener # GENERATED FROM XML -- DO NOT EDIT
URI: urlmapping.html.en
Content-Language: en
Content-type: text/html; charset=UTF-8
URI: urlmapping.html.fr.utf8
Content-Language: fr
Content-type: text/html; charset=UTF-8
URI: urlmapping.html.ja.utf8
Content-Language: ja
Content-type: text/html; charset=UTF-8
URI: urlmapping.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
URI: urlmapping.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
httpd-2.4.64/docs/manual/images/ 0000775 0001751 0001751 00000000000 15032766613 016305 5 ustar covener covener httpd-2.4.64/docs/manual/images/feather.png 0000664 0001751 0001751 00000051231 13154224322 020420 0 ustar covener covener PNG
IHDR ; bKGD 6 6 68~ pHYs tIME - tEXtComment Created with GIMPW IDATxwxUו$TB$Q m qlv'v8L&3d2%ɤMIq&̤ql'km\q0# !ބzq$Tsmtkϩ; 5y?
\ -)yі$s.ͽ[_ Hԫ9 <xF5+}ضQ| n!x!c&"" Ax5 < z~xiGb;~ -5H
EEƶ~դ <xHx{=_wj1uv^b"u ="މ *'^mz0|xiN/+4$HPS-˴]|1<xAc;?$V>*'RZI$o&"" GD0efT P,:("\|a -@'3&py}>r؛G<?'[? jKFw- H-ҾZɻ JY1溻r30KD/> + v(ɵVZ*(Q iZVUX`աΥ~#;/C=Zl_- 틝vی9bA5"2 dcpT#XȲ}%%gkc@ГL 9bAEɐnz<Mk9c}vȀBH>W%H祏$T钸.;/K bI>)]u4 ,doNb#
""la7aGv^n"ceK+Frߍ5V7&yFR <Ù}K) 0!k}*O\bzIU_D~(Ybo1gV2U\99#20w )p:؎_"-3
r]"
8Gv f8ʴ5k,
;4۷ wucI]X/Pmr(; Gȟ/ I}wˌI+Ddw*e^ȧLALn,0EEExYEZO&[>< X^~|PrD
Otzݿ "*&} 3i} <Oɸu,pA`2PDv TysSFJ|3y_'IK䖢sinϞWsA6YC<F b!:h#a-Gq|$Zc}/^uj'מN 7[MxWC~]"X&"bE[;CoLkXЏjf;Rw߈:BpZ4|Qv
HߓbޖߠUY }W{Jh+GO[~*"='Joxt1*X?*3Õ@
ERGre1wFJQv EZPDO
-y n:Mo=]V RXH3֦$\ca+ i7<zD=Ȁ>u#gΚ lI~VDM,ʇE wd1Sްw*cC&ܨ7 GE1QL; ˇedX{ok=<끼
|[N"o.#!aCC:&Xgi ocaN~hU֜iod )y
.y+A5F_ͿZLT5s.c& @w o3$DO F3-NorPI ~,%xqd
-=ArlEOZ
zlyh6ix8uⳄƵT$y 8ZgnU&6i}Ȱ-;B"l(ɝoM.Jq AB,"m)(/yn9M[⬝ ]Ya?>5gNHl8:-)AxAm hmXK̶A|ɶLtEe BzTt G1B #đNTдnbw'$3&
& JƚbMRx[τ+X)7/@LU>o"cOSoGbnTmDJ"_(BW-f|-Zbc&`Y KlWsjݏh*}(Y}{b,UՇJ; 2}^mie XVfĹDvy/}S|qPKaM hRQ6ϕؚIÍڼai 8Fq3pI LS]&`im]݃}G`bo ia kM?ew3֠Dڭb˖ްa HN
[b#WkIxxV+3B [ઘ9盺vu K$R/?|`XޞrwW |;wmy.(yfkvޗ}D#娪Rm"ɜN?VFOCk &56$/݃L;,*c1B[0Jۂ8t
FQ!ȆD.؏J֪챷Qq7sXq`r)<uV3W?uؑ
z`8}y ے;LOM
âF 1/5*ucuuD~>& -( >mVޯ,#a~)jp 2Cz&#KJ|?klh DbAIf o@*)p$~Z!RFp:qr&&!1{eFX⾔{qO9|_l_cC}P
rF^͚e7r!8#FH֜9| ˙tE)/(/Zy+y~A<x|@o { ߝ & :
ǀ?ԁpn(Dj|&J#dL[6 *"ND94nܩ EyE$3dI7 "TF^l%[OyQoG\E?mfa;qnᠺ9_|(w֡u+ ˃&qUj m|Qxb շs:( 7~#hS]ߜ6R Y0>7"+-T7挘 Y\_.& ٥= :{y1<T/sʋ1+Y"qO1Cꙭ('v qoS--(bmTSVŔw( < pĀ m~{pIa s+)8uUD$R:m~FO&0{U3je4co?SpYX^4+wh (ōQ]8=@V'#c,OzU6-WPUwR8>Kn(;d1|~MΖp |d + *3ƒۖUQO*RĪ%IoMvpYuڈȝӪ6f_o߈p' ?{-)ece+c@2Y*<ێ$ zgT!qD='};2G67;Vx{,WG# < `jnVb6MEی:wo{ 3=TSs}{vD9 >>`v* ]Ɉ:)(/n;3Gr&ߘ?e#N>nlL sK%c^9&k5@m9sݼ"|lUY<xpK >'uO #%k0RDk n?M v;_g$0ke!hZbQP|/,SLnv:X5PI EGˇ h]; T喎3>gzAyc/ DQ pj;pBn%cR d BhH(%A-Uu0Q%SDIf l|6'kTy:@K2d!b]o+܌=ux[뱘>
\] jd0݂7e{p Tu j{wmH؝J$4BG+T~!NN;Cg-%8RIJ MkѮ-,٬G`8
8Kc}Aq]H-˘1]]vuo*wG-T9كFWB?(/9M <."Ahx)j;!I[~Bs"oҎ;y]~o%x-ވBYٙ 8W4wugG<qLz5q$%6hT~|9{ĕ4,e[Cݏ.ߺu:uY57GD\S8b~M <1T?z/m!Z.Id;7z&*td/#i&"Il{Zwucuy}qz<R.Iˊ^9K(D,nq"ghϹ屏<֭ρ%e MD|~OcB=w+M <'['ڧ mTa?5h:XdZ\OZv5V֬ *mr) Y=MgӢv/<Q'~QDzdZ#ъ<{{@ܭ[.E "C =o:sp?߂<5)N"p*&f̞Gˏb%B&y#x>vB Z|ETP^r]$kU뱓//v^{_֯"ҫ)pK+KF`Bjz'?KI5 TyfMyy{K*QW(K;O? ꜆K*JL t8BgF $|-gN!Lĉj^
j=@Ijz?N]};>4,_G,D."iQ=b'Z1m,][4Z ם-?q\C~9e ? . _du
nL˕Ѡj6rPͼ;
/ &-ݶſZZc F4۾`GEd켋pa`x@@`Ղ5c# mXzK"
W퓏+]HVm?3 l u#.m$AjoGqRZU^ 4fY5"DnAX.Jc-g,eniEs<-J(fp('Jb[DX}iE{+\/Խ/+G6;k<7sJPZFI<m(0ϘHC^ p9C"<
[q11BXJ\Dnz -%&"%$tKXҎK"M!e͍Xm$a/bT~nc\bpZ43\?rزR0smcbUM%N5g8KݥTF~ߗ7[[
`\/}Ei<YC)
qՅdOcS3 F0By#6 h$?=Ljn?IbOB+$urzG#6W̞z{4 fYrrĥj%%}#D\5k}؇s >qc(;1 ݣʘMK
g. Ő J>V܃[WBU<AO4)&j"ȭTƬmo=xWƀk8qõ7a%i/ rIe%.-U[,$VWŊTy+km^>m9s ,V zv7gA>saEq=#.ٲ@ԧlK <-@R '{abi)vkSө]vr3^nmR`ޞ;ѫpgHb@RPQRݯNaM?rT?3+x>9yY]6[|-nowHQ K*JoZƘ_ "x='wY.R."pUVꁿҸmgN`"izq$/=Yջo.cHYNn5\A//,ehRGUeWZRY3"]rĀJYˋ*zE_Z]Y>!yUY]³@ERgM0Pnzx]4bS E P6NWqt(YA4~L>R.^R3;R]GJNA< gZ* Y(LuY\4KG\f@/
W0wgXd`0 + YEKn܋Y21}T'rͲ_[upw(ȔFKm<xp~8pH1(U<N" N @7n)+VQ̓j۬IX떀Gڕdܭė>UED.Wa<Uy խVb%yO+rĎ ʋ 'E9un W@Z[$w*LFdL?3r +K@]zT `Y{{[^Y(;UD)As;w~Ss[ⲝ`Lka1Of 8\U@jS/Ps8g*0-HGWF{ETAL^ΐ6)H]o$`Nv*0jv^Y d|N=(k7].X 3%5NY?[rjxn9SʼAj6lwma[ҢbO~Шna A p.JhU5U<нJ' MLʪT?09u \ $ibRV^џ EL'>4KƐGbWU
ť
s r ް=;%%OG o]VVqѢʽUe%"`T<puLDžď F+ϡ9 N"gCY "%ϑ$m
;_F +U֠c~N ~S>M7P*e+DQ^|)nЦEJH%:Xc~沽H,J҂ys{6d
<3LO
kcjEVwmò~;n)ʍ;^U 1gcg=pYX
=Dm4W*E!'XȻ~?;ENU}Z1EΕjԊЍ#![V 7*k䖊T=,& i]oTRW/ 'G9;Սj[ߗ(㕈V[B2Ƿ
Q=F#{Ss`F<e3 $ 3羰rO(?Օ}pcl# A\ 7 4`鎜|%4q XT43WUqn,{d^rd]?Ύ,7G[i-jmGͷ5@5㮹Xc3ڌiH(ѦB_۩XA{FZ\ׇWlsye*<䬏
܁``0WA:EƘe y4p D53zU?p.+0qT? gj NFUT=8458Ih1 4/ ,+E`(;X- w{~:V=h0l\S瞥gMg_D̝ӟWBյe 71cV7e{p~HRc8s4en IDAT /ijW{]@j[<5gy_K 2ǔ~.v*nےp6Q 8TGK+K(b'}y$bϒe#
|l !W$K<NȃYH_U?ԜxNP5Q!eBV
~ 2oOI:7Vo6JnR8
a˚
|8%/ݷi RArn(C ܞ5+?/Gcѧ P=w7m{LjWUI<0D"T?G%]fAeW`ZmͳXwM+"5Oiu 3 ed32Vnt(ԺX*h "
AU
KN# [a"J@Ʋ$p.Gs"C+ *""]E~0?}e=$=x87 \DTU?P_ńm*>+/(H \ԋbBA -pٳle9ݳKUY<D^beouKE
+梲=Cf }bX 8@ ~ Or^1. Κ?~x0i s <ډj݊ѨCͦWz{%BYӅ"rx
,/\;r_]\^|xs'#uwHn 97/./%0w""kr-(/ypB`Y{<*0 {K C[Ծ w)'o4qq=y._;
iL-lOq9X*²w)9C9<;?CqwzcY\ ܰ#'C]7Ϟ<× W0zn
iտpg^QLb f
kyŸ;.vqQ_f&S n " 2K*5`.0Y`YG\Z+ @\9Q5 n#7{m9y,-/sD O n
7 7wy[ w[vep7q Lg'^g{x
`\[{\i$B r{X]s5ϾLR\X(`[,]ĸk 96-eMJ
̲GdN婘c>|鱡năY\" WG z YZYpd('_V\
WHF'\EۗU6u%|M `t|koX}hw= F
=av;\1{οVU` zrjގim錻r~Xu-
ݞ7ƧrK=pX o=FyDU{f sַr
;Zߪ ۳'+>;G$'lڑIro9G ̽rzi _34#G JzQIe4z6Hipg%%1
Խ]tgeL2vzѪST=Տm?i 5 f 4S. ߌ]hk"lُoi}ޏ뀢|w8b)D }ZZQ, > ˶gsfOّ5ޞk<eu|뭙y. rŎl)Dܸ{Y;%熼^>1jԍ(zBp5 iw<1&T㹧YI`D|goOB\i[ 1]1߹A})70hRP p0Tζ26| w*|U]5kve<̿Lo=\PQaϴ]K0ذu컖 (זo}@ LZΓW
g9ۨQ6b DN̲ŲXfOx:$Dv"@W?bj`BsANh]Cs7R_ko\142HΟ-CcJDmW-R>Dn*;r^ > =>MCEz#GPo{W/hs|>=;e&O
ֵmJ ^(Mn9HO,"lk =LaO(u?, uvP\NOj}UK3o'x ' ;CJ= AD̘Ɣ[ }]83Vk&!^+(<,f
ErD]F>1fѨj5+w*ܜPm. <墊} B@DVDTD
OxFUF,s}AٞC ;RdF
Uza ]u^Aîٞ\HG>ŸkP,!nif`p:e%Y.{HGJc-,Vc6
nX9qbxԞYr+
7k)yUW_4I]A; Yܷ0 <&ogVа]{ϔeE8ܫҥ![G"@_E?EEIϊH`0g(%.WAՁz x]=*5ks' rQKk$ ?]>>Bt K>w>jPN{_&t҃{h#:-ڼH Z +0Jg^stM,O+oP^6N[ "g~Υ*O]\'<:
Dž)V>X7
[}%#) viC?'RY^f@HK( QI<HA· *oۊ 8(%v Tqt$Nhu]{=v'LQ«RǴn w3ع"W;"b=4;}p/ܡ<7xvnƹyވ|o$#Y[Tխf` ;*`.WջCAB
3 x?|vg)eOK֭ijjӫӣAp4 y&&?U Aܙa4/,HDK*K^tcG .A\m{|ϋ# 8*cKDfT+KOT|ȠwP7~uqEKˋyaTx;>~7vnRjnSpͥnI=J=Kݭ1./ 8uR, p91FrG2Fv"qS;5twm]?gވ;qx\; *J6;T &#
w|qE<0 <д0u ޮ$kV0Mo$DR\К "2C$זTUa))1BmλJK]jb,D혪Ɉ\S83oPb/)/qEͪ!E l{:!`ZWT|Xipqh&8 c/1bֶÑ:rI?q jvҰ [- k"d^qoPӎפ{{c2?w6"z-wmdSD}ķ \H0,99E Ǣ# ޣERfҳ-pضdr [y1Jqow3ҀT %%~B<v|4ѿZZT [/
c&I=b\8Lҏ@ SX$`XK-EM/˜vKໟϢX;-ݿeK{q|N&t5D#IAyɈ[/Jp$ëᭋ ?I(4Qcp`پ w'Η^? Ty1Ja4?̩W0QsuI0k ZtFbCd^
dq%qw G.{7L4F[e4V u:5u+)Mާح2֭"yLNx <x OTSf)N Xģ(JնǭYrmĚ=:q'&M ¥ <x#a aܑxۇ$3 YBCNdI] |
ȸd%iKڢ;F.
]UWQc-9@}.U IΚL;54X_p_q!'"h <xI]`,ZHNN-aaNm+8څbm+`qV2vKd3b -'k+ޟyX7K;k-x: '" < MOS鸇=EĚÜxypz;߳ud\ccU < ԗ xu+@pB-xQ37FjKŤk^|YU#p <xp`XρG뛨+=\vj%s N6j`ג6o < SpNb\C9c/tI\lV0iE " < b jh8p0isg2 h>~K)ssKxYDI <x]@U35&x=Ahi@%C&2pN <x#p3՚CuPf:.^D}Qʎt3J؝+5| s,Y Wx/<չ <x8W1 *0@)"'"vjsڢ9$Mb§{8muRqd|%V 둷 <x$~"B$(laMċ. \@U^ Uا!)xZf}Zȗ w U
G<HHD&O Aa5AcgOc\ Nx$N } froyM <Q K ꇁ Jsu#5
8bb; \s5ڭӻߩ3}W23 "ys <xxϘF?VJ4w$DvT?+mf2 h>^MM6պғ"br y {'W-D_Rٲ=x4bs<yڦT`iөFT,!&6V@sHɚHU>Uwc<m"o_/ǗıP(eM>5 <x$aiui/^`o1PՀ',Al[r j[Kp][%&gM$P\eWJxau <x#np XfMū{)D,q9ѦH6- cX&,MÁԖF);S,%L\113&P]yMy\p*2'@܀^s{{ԫ//SB,~
*(͇TLӉv x3f B9vOԞmLK&md/Ŕ5 wA6 ,=(ybGwT2},߰,{l <x#pw8| :%X.(̔ 8 a+ țʔes\E L0]G}-N 讃 >EKu#M¿ ܐXTx <w!7,穝 yPciǑ?#Ǩ8B
M `1b-"M4 #g"r&]05Ed'}{F
z )̺d.Gv kmI |K
1 XCp w2iV~l=9c)ۃ <o*_U@rY2)=~K? )c Y+gۇQ!.}9Lm~TKYwa!P ,"#o <xx?"oDLY8Cofg\ySN&AwJSƲu\6%}"R5 <x8_1T?7MXPjf V,fڒlI* +ELBn[ZC2f|*RΤ!?2 ̃ <xo)`\{ ' D!uR:Y˲inX6yk S{c#o<dRj/Y)AklK4i=xG}F'6j w|qcv4B%NJ#)3ȡ 2ff65P}Z7rkj[U-Q&O]Mʄ6^S3@fƘƤ})`ssseYɭG"Uiii-"Pqj wniX,Vɺ!xD"mo $ ,h4|(p-7t͍h4PUUU.[ZZfHGPehjjfvjk=P-bb 2 >|8iĉZu)0
1ZSSSFO v˻жˁļN\|@Ub`1;Ut1w ->|o $czRhnbKD#|Z_ǾeZھ'Q&o'3y.z.dHMO3|]D.ZuE_hyYD.nڶN iT,C7osp @4]eE"٪?ܷo}=
־- oUUnU}*[HdN(ڵ?o"2,kPWP,ssssV02~ q ~>">epծ89))韁;D$Ec >o?l)&sbu9R?ocS 7GQ`̄4/AZ`eJۨ\KבwV^y{."W[P(t㪪ԁ8m{NgeY={vQ4]qգLyeY?1w ?~|LuO'ݹs؞Oϗ: @+_c KE#w"]KD6|1tF" 2N
۶ 0<4e(9VuBd kx:ߎ[#L5ITld=t2\soLֲll
O|*##ڌHXuX<۶/--
udffIͪYpEEE |y7|s} TO:/!/}Lp8 ?~|1>˲-"PhK$Y< =pU
> i3o֓(RA҂dYq B9!?Rh:/͜sIvŚ4ޛTuB7ƉȊNuds3'͝.
̐v RSSomݺ'"?"?Oo1{UŲ"XD.63c>vKU~uU 60 l;ɓ' Rs3f̸pMHdtޱc֞Ou5 ڠ,]cǎ}XDu>^c&caUX5ٲ"nYyaojjZ|kR uV_ff"re7W@L f%Nu4=ZZZ:3v*5IU:ZB[//ܯz ]C
?вt׳oo?oܻE^/#j ]*3cL?ro8 .\h"a IDATn_맱q8hv,,ʲ \oy1|15`_SS8'1m,eԤw>ǝ8:j$,1Weir [n25mgeayH']1H$>+`)kN,s?1o_v*cm9V ן g~IUuL
d+in1ӻ8:ORM6RpйF~kDp٭ɓ)ƘNy,:_j*s, R:FWMi1@X.v c}Tߝż={
8pI'pYz"2_M UT f '%?rwQUY & !A@_.le9"X;*ZnnhrVnj3:3:QqwuuE(O $w=gHytBwI~G_{y}瞻>, @Ļ@vrP(
@#DJٖ-'O.kkkkD3R 9sG:u^OD'+sMMeYֿ^t5jԡh4z̿]<,z8ń&۶+r#e}[kضgYuDpo( Ic4H `> #qt?='L cW V jMD ]k\d#">\v=' *{ u
" etz{@ߑߝGK.˿>:3́:Åw䳭w}=\a8{GQ5!YLD!" vC(9Ϝ Q c0lXCm o5 leHa }_x3݇h̘17W (BYYYlj|lYַ BquFBGh4Zm =3M8r3bB P>} ͟{! 9&6ejll\b08̼Ak}w< q"*11cٰ۟OD&=m ,r|,o oA v^$cs )**jȇ;TO12/cZpڜS{@D?E?xfJJRkc:4iRTkC"z*J"Z
g} o6669iҤ :3$mO
-ZtE)u0 'lEƣ琡7鉮|,|Z[)6P(tèlikC0\ ;ط*gM 4$GD#ǵ <GDqD4϶w >22m^ OD&ݿ b- X,P{T(g*L5nuyye *>z8v Fpx9_y*l`2Iq[WW`0zVknn>' g8U h%7]۵7} WλY" mgd) {4; oZ߶琚+DT \ L`Eyyy]k(y4LH^趀vʱ.5daȪ̮ {쉦pq
)|V G S !?PW{ d=|^C.3E)("*O v M
BGwwwV ,}mJ"֏#ѓZ!3#gxRu+hER}naa-Ɍї."Y5nܸ\pC\l˼sΦyIU"{ؠ8묳ƧhCc>l l1cF>sS] @w{ 7`1aX E.(AD lgID8 *qgS f[\ b{1]
wyk@$"/1 }H$r]:mUiiDT$555 jY1[~R+ЮU>@2WUU)fn06Is[g(:&+33gzNDct4zvVZv ] pumopdbL?̝Z뛇ݻ@k}S"s=O U?*=2JPX,6ue3ᐙ6 y"Pf[D&6f^(@MM5@^Bg PF]װ }=4:cOF dlt:uj h[Y~x)WED_:riqnM,z(nT\ͼ6 5
E٥Rq Dα iBJ7Cbpa#}G螽| lٲ \ s!T`. D;سN;=&X- ! o CD>/^Gpkf^
9 Q.˲9%TϒOѭJ y%
\̛. \Vlnn~1Gݐ*m 2W KF,\8TEEEf(oI@m#єR`-=D.**: f(gx5~wꊳz }23s˲n !˲nX^RR#ms:RjmۯfDэp J"z:i0"uW`z~$sIW`yԨQ$N+++76"՝;hymp ͧ ;"H]<t4) vy&omY\kͨ|vƌyGKJ2'kY*"Z:zJ+>`jݹ.8-"OJ
}\kk )(/3eSW']]]HC_s5Wwuu51-yy+=)V &ZW'O'8ZoG)^0z=;xD"%˲ j-"W7uOo{I~}7WDdLgtuu3;ץ:N3 93->̟h}A}K}b$u5R602ADZﶷ%+bͩ>I忣0qP`}= PJ-afN#('Xc ˛]#+DsY>߸WIYv:q
T}Bfnřy3o3}\ãґs+G0s<; 3QZ'N$] Je 3W3}|%cƠN4/x J~kϤ y ŚePc5WHʙb┻sDtACk}]EEEw
ȽY ۶WsDh}<`544>Htu8jEҩ&N"h)-L'w|eY}-p]" (OׯωmHW MDNܣZCޡr m{0
LZF vqO
z1-"Q^|\)uݍ&<𘈬 JJJVdqv:Ydv]wCww\y2Ӕ"RʶqO0";2ںtw t^}
"dkktG )"z|`
[>#?!kٶ_[tYғy"3/߿P(T2WWWK,!x<$ -ȑ#/16:d...n,x<>EDaSEQTeYcr f1m"FDvzeYKV .˲UJGD~|Nyeݕd+{?i^5 ޯSxǸ$C6*}|%J<;7n02d]h4:_Ŧ766e)͋3x ).}~[[[ DPD${|!" 0x." xCD@# f, GD`0 9XDdKm <Ǽg~Ws`0rс7+ڴi1k
O |ۨ`0 s"R`+ 44b:\p7 4n|n0 Cm ݈tPUu4, s: _`1cf%Г;F`0 MM
/8EE JD;
`Ƚٮ;EcCcl0 Cn:|ɗ:L7g: D al0 C""#^;uk]v `~`0r߉KrF `:XEDS'"65 ah& ^ IENDB` httpd-2.4.64/docs/manual/images/reverse-proxy-arch.png 0000664 0001751 0001751 00000026666 12663316405 022575 0 ustar covener covener PNG
IHDR ) M \ tEXtSoftware Adobe ImageReadyqe< -XIDATxp\WOK,˲ Ƕ ĿF!YBKJBZT- 3Tl-D@
J,N j`.d `fnv$v ;jۊ O?nd ߏ~~uyG V _V|[?csD>Fo"sDxV1W9j]tnQvίy]yt4,5\ (H"qD61?̍Z^C ,\ª3jP%}S!)p UZq
\[L*5CA:іU4 "1. iTV8^wP-Gy^ gQW'ZÖ #
,!vx%։Op'lΧLN[BM*m"8O~ަE6[Uj M9vP/gzcn ҈haIXzC-X!!>A|X J]zy0%br K#(c|XX|"
䲌LOXY\f.+
@рYCBFBrYXH9s9n餰vzR㍋7(z;"U#Z-l]?fZ:YZ@XOeKX5'">n~ 5EcB$ocG
cc
S:@/E hݻkqGmG2t @Fk
p%-9BC~gfQ0>+LsskvCLn)W@r\p`5d [:<, {^↫cx{s< ɸPc:9>NaדV:X0X64x_-D [ br'G+
+8&jLρR
)DKlT7ߠ/dJ<rSPMXAT¤)L:S[M7xߧu\F)չnݺ tJ\1ez*=կ:M %4~ʌ!?+~ھ} "ə|o; 0"RvM>ω!t):}Md/c@?=ھc$owZ>?>> ~ "t; <A љm6jϝo#?!PO|{e$- ag)-Tkg¿04Ǩ 4"Pڥg> ڵkFe [< xz1r2X֏.O?rc Ox T2 %8D"ID쬫]{|J,; R+P_oZsKxjM6G>Q~K P<wiUUՌ$LƝK,'(I XV+**ijjJ,%RnT ||+|S$M#TV#? =C Sp'-T&i;NeT
dtA @LE??y&(q[ҙ3N={.[NYQ,nO?KoKg镗_ = ( q;'!JYnw/S,EIUD:/BǫtUGPW*(>h}q')ٕqI&ݹܼq .Nx|fU@;w;
R%RO5zn!L.ܷ˵3{LLRJ/Zf
5H~{*jT :~{%7N 2'cN2Kt2tO.}gMMG;|6'(4*p D`%2ݵw
WMh KS"3ĺO9)INqqZ_]?@Joód2if972xXŅ[7bZFY)PqG|J&}^]6ZPh`<ZRz\5ʬ
x%;Aյĥl/rKuϬuT]]O--@J M`!TƜ\n{1et1Ԓ 1L6#Xq#Xq#]|- D
@aޢ_Ok }9- yfLi"9 ;(Lǽ *NqEJf
67S}}}J$r",z˭~jٻ)x2 *._ f
hyu+HKƲWw98/=;zu.]"z "U\ݑ ;wu#Nڵ&z%e= 1tH T<s]#]tBuG4ǎ g}RB; . zeM I0eVZ)mmⰢ֭kgKkkf
#d&^z.@ŝ G~X\x/^ؘiDH8<l.K_'-\3r?sRAĜwTR}x%@ we9 wCd댹ؓ)e=9@
T/c2KK٬yv.PYcOxƨׯ_sFoxRPP- bYϟ=чjq*P#P_$vl<-wwz뭨.%P; REJueU~ėXɤBe(i\.vy Դ3?-DtE`e~,=]U]( @ך:+<|D>g8%Ǩdf p2EE IXKb6YPf9.Zc|
@ךPBrvoMNNQC*++=O2*EeȴLqb5u,VzXxjz5}"
̙ߔt]6龽{iΝTfQPx>OPĐl%fK8}5:
T鈕_MB* T)7i /]v> _aC$s<Y"!Nz^0wUڈQ "U@<6ߤRKcc]y[.[5{|lcBZI9i&KJqD
BfƠWpÆ
-[ owhQeeUfL%6ڙqg
_En jq2Vԍ7 "DK[]kX0QN={ȧ, *q@@rCс@b[UUUh۶mnٖTq2Es K*Tm쫫o,u^&NaJD @UR1jN -L<Ãj R`+&~Nt=&> r+@P8է&S)peYcWb?U ~Ju0 E.A_= / *,)> " ) D
R @ " H D
R @ e $oOg H k3z0A_tyL/;OwuNJ}ynn,LGQ%ZPi!H- m~J"E+lu
4یry_c" #U:,AG sFy)c9lqs]o &9^ 7
C ;6!lf^ Dx/DKݾC<1<LJ}M @ ct>Y7 ]pƸE2.W? d:
1F`+m(s aqo0b#4[ <3n(H ǣ ^s%z3cڵkTWWG >}1c͛ 9QvU3$,#BXҨpN
a(&\V!^ƕ3KE/&,9î壮| vs2ū "UܼkSOѕ+W2֯^&''%^xIn{9z H<+t7~8Vϫݱvat#0¢# X\,QKp->ٕYbRשw@iVZEUUUN٤-4]xog?Y\
-؉Ee%myjān ytWQu'E<
Ե'K,E ;__|kjjdx zgs $/+*"b6NFK,\, :*PBK,w`( >cuX.M9D ,̙tlmmXDE*dΜ *t'&&`f֭WTTج:8n H~?㩝۪yh6N%fY:HnѨe$|s T˗sN $_0A D
R 2f[G'\ `I R @ " ) D
R @ " H D
@ ) H R " d[ܩ%(]$ H)OM*:J2bU M
,_7 B*
tDGOH}TjQi@ U;Wr
2̸ipmT5#rY5HXDѱw "UXH70 " ) D
" ) H-QC<Q XRMR< ̟wm\1=J(
XdJn<)۶j2<|4M ":Ma7yoȷz ܛo.صkRΝ
% J*:UfP7>7+ZEڵkՂdcR7hGO=y5e2:B Ɗoݺutbǧ *6J7}쩫vjl_} 9qFV*~ ^)qh-s| RAwyMNYT8-P @J3@|Qe=-W|d'}t=ueԮYr cB
@J?+RYL*ݸXAlJ:oCtOi||n6RDmm%_ҧ*ZXyw?@Q2䴯[ R 9#IڒRb::4 TJJ:9i䫻j_\8)"RM#ĩE^pdEj2VTEtO\/^03kWReeX>7P90BeyR1Ϊڤr'y^ƝT瘩iJ** l^$w;6o㎌ΛZnܸQ(}:TRE *+)zh-b^-|Ab-&ַ1aN(oSz(Os#={ӗnڞ)C9f\5;@բߓ"`jj*cyFફ{܈M77nӀhtD C3Oo?u_3 |"l (ic1 Q5s<QrLA#xe JZ>A*>/agԦO}jv:lŋ鮻rB:s Q_!RE؋saXq>QWX;zjI+r=cZ9 /
c{8 a I;ej: n|@r˻*
oOYR*&7cESUhʹ2\+˲Xrtyi+W=1Vut BpL97u
*[)l1l\ #b*)M_VL~ى ϯwn ?X Y(ӥ3
u?'cebH=Bn65G
@V_4 R_bvg7xnVu;o<vѨUU-qZz5mٲ~'F\1aɴ{cWn tGx-\VQh
4O<=(t@E`W3l_ʲ";Üضml%yZ c
7~ 7l] y
I7Zu~X`<s7*L0Cx]BpY/>L`H9x>#P>`lU_g _;SiaYN~{ƹuoqY&&(,X?Bo=i: Y(,3g*UR
%SN<*Y)kv [>~()yˑ&kjtח
z"{W/\m!JO Dj$C REꙞ爕Z(<5пu^sueHDj-8bN,jF\[ݻ|. "$U)%PɈ6[PF;t<JwܱcG} Es*Lh"%J~#Pi/\xAE Я)c60' E$RCVKzwRq 늪ׯxeVھ=;HQ] n U܄3eK,;gÿZ_W|cMJ7IR OPzXS݉ѯҘX+|2O c:PnIj97T(~ py(].?cD[c4?wYY\~Q/v (FKJ~_F`<ilEm{)wgӦMtO_ݫ;BO;tFޮ {\:? # m_Qz%_ ynqc4C$ž#L\NWB,:AaJ3oL٢P,f#Bz!Q.HOXEoMƞ0`ݳg>%VT+K*t/,~!Jfr1c6
a19Ae]aY(7!J}bsY$,QTq~ u".wNPz+s >Aa3j:FD>CUoP"Nxq,d F ܊ZFKʍeayM3c$^F r-"w4VG#d.b=#1 xzmYtq L] vlH}}O +1VQGS'{i_eŊ- kE+bjrr/6
،_ÐpӚ1)s`/,N8r9rM R,
l]5U atEu0h $IAHPԗ~3/}ʍHU5ɘ V~6LPeZ^Ze"5 UVU-;3ZA'D# F 0[EAwѸ{ƍ:
_= "%vrh劉X%bEQCB@r@ eu Qn!ҹ(vw/1/WmUҔo-ʢT /EރkЂdʢϝ;lgTЛIE]n[g 7.K&LaTd(s^ױ<|nyrﰈYb=rD ^测2%GUf:HW0*w%/8'?T˟Gi1(.W6~ njmA8Wr)G-~z<u9TˋOӯ#TriI9! v_ =4]>ܶHAG _:hOv#KB&8H-*cfm9>_ʂq_)۱ڿ||λp-5Z(!I:aZ]'Ԣ_icEvX钥Tt )ҨZ7{kH;i֭tʕy ?&Uyϼs[}=@3ľϗzZt0It맺oۦ/W}ξ*] _y>r 5 P"~eBJ*헻OQszv<4NA7oBg?FGgihF *:t A#J8:ɒ1`t x1%WܒHBcR RBW˕mJU}k?ط_<@~'yb~Rv_%U <&}Mǟ'sNMu5~ HoՋ'۳gK
&E}/b+_ p^2tnd(n :uӏ 3); s]J/)+X<~b1*(t bbjN)}za u
@1{E <rsx
wJ 46ڢÍwߥO?ہ>5 X,|a% |L ˶N ,>7-P{mS)peYcWb?U`%i ϏRKp'9r *(^ Ƽ ) D
R @ " H D
R Toy `|[qI (rM*nQ:y~REo?4Q) |+C?79Y"ױ*zTjQi@ FW2,8A XiKݽż&3n#
{`E
x6#rY5 tA($0' #| @ " H @a.y`+J+pw,) H RTѯ=R*09~m @7nJ
9#9RD<]. j"KgPԌ Dt=t|رct5߾}ؘntRM2R6?'#FDhե{4یry_c" #)="D'a5džQ^g X0[| q@^{z)rJիW /8s=G== \zsXYMh02Xu>"`M[9mp,4
hfahQ0,\O sÜs9&<Q w2GyOׯӓO>Iάmzp+++)H,Jy$ɞڪz+0F1nZH χX
աqütݩ(lz c
>cz1^oRͿ~v[r}L>oVRzTԗ%:{Xlq>%R# (@Red, bÖQLTy~ia+Ed 伍Uu-:E\bx5.vw$b
m+ͅ r7e DI6b]#8Va< ,b!v2
㮲D].]]4O1]X<ߜ.AAJ 07q-sClݺS***hll,`Nnmnb9"2d\%*Bd&hebA/s|L,.cǣ "Uvnjj~WK4YYCS,OWM/:y^6Ib7=ۊ
D%xFh6̢0b,,47\U.9o8 rv6s|(%ҔCbR] ._\P~G}?HH͇H" R @ 1=:J K
" g[ ƅCk")eq*:Rj09!4[VT: 'K~F|pB U;,Dp %Rb Ǯ Po('sT^jޡrvڒ2Z-(A'9H_Y; R @ " H D
R @ EG,պctҤj)0KTI`b-<^ {#|(P|Rz˾~MMihX&&u}ɥZr R $eFҥKY]I; R+ ;-d>11$ attr=|TQQ^ "2l,6>u{ee%z1VWWM.պ=H c]x1:Zn zʰ{.ڲeK7_ׯH Ν7ϟϺI; R+'kƬۯ]$ 3466VuK|O!R%ݍt~͚ۧ^ ""WsVrzԊP[[<z!Pw @Vlڴ)D"$ rt-GTB< X2R3DYSSC/Q}}X,TjWih/qy (?]P)-:4[YC.A
5k\a!=* sY|G CsWPy9\bs[\)?[CO8oHXy =^`~XB ,b0;XPL#b0cs-Υ>y-WrZ|aa[o/>
sMV XOZG{r"#(
k!j"kmq
5]B X}x[XX11bb],N؍y09co^/D
uM,T1n% 1
|Lk DFo c b7MQ]"l|blHo>9FXR R M5w !`yO7vvrXY`]v]fEV
p24qr #('etº\nq"DdcЙeN ЇLC\FK}92oB #|. r_yz]a tBlsc]2nc 2AhBEsXvG<1Qfs]C.W2rG85nͧɓBvG X R @ " ) D
R @ yw7 F[6JaR{9S @ X653 IENDB` httpd-2.4.64/docs/manual/images/rewrite_process_uri.png 0000664 0001751 0001751 00000320467 11744236202 023115 0 ustar covener covener PNG
IHDR tEXtSoftware Adobe ImageReadyqe< "iTXtXML:com.adobe.xmp <?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?> <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="Adobe XMP Core 5.0-c061 64.140949, 2010/12/07-10:57:01 "> <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> <rdf:Description rdf:about="" xmlns:xmp="http://ns.adobe.com/xap/1.0/" xmlns:xmpMM="http://ns.adobe.com/xap/1.0/mm/" xmlns:stRef="http://ns.adobe.com/xap/1.0/sType/ResourceRef#" xmp:CreatorTool="Adobe Photoshop CS5.1 Windows" xmpMM:InstanceID="xmp.iid:966495DA847011E1BD8ABD14E281E1C1" xmpMM:DocumentID="xmp.did:966495DB847011E1BD8ABD14E281E1C1"> <xmpMM:DerivedFrom stRef:instanceID="xmp.iid:966495D8847011E1BD8ABD14E281E1C1" stRef:documentID="xmp.did:966495D9847011E1BD8ABD14E281E1C1"/> </rdf:Description> </rdf:RDF> </x:xmpmeta> <?xpacket end="r"?> ܝV IDATxZ TSW~Y !pGqąภTKqVe =).պv챊 4SZ<vpFAP"@ d#{o.I瞜w abD>SAZm< x>12^;K 8hYEщ
m!6>@c0Ow
ڰ &auvl0l\Jh4&߆7G
5wrdo
| f5%m0(= qǜ[n X@r5/^%, xMF4 mh7t VOND-</*;jtK*
Ze BQh b;x^ݞ95F1D
uAJH:Dly,- kI
@u[E۹@~~cc852bܜ52j!V foslRMNmU_ŊMsw;Qh;@2@6fKXpc90
~lAkF
8]h0j\]n{(ڑ,\8 '.XY1`vbOL~G e<`Cm0!·Qz|ie85q] o$G1W'>g}s60$$й{om:7m_ Qܥ5ɾR N}*{+ӟ(% N;{UG8pb>mݺu4N0
J@_,%htwg铪\hdUuӴH`ܴC3:88X18l+-㸳y& k `CH6ATRϗH$'N0.VYY9s7U_ظjҚ/Md9]M um+y)uaI6,J+5NHy>G|Kߣ4F. /
/UΖ ֝ka3 Lܾ@vE_[x/Roxyt#Bv!!, V~3ZIG7`N@>} TݳVsfxٳg
@g
eK\z
1ey:xY,5$ULQ! IIna p:G6Kn9{@Qլf7+y0h%jjKn9_6z+hs{&_-LH$ iiqI'O-U5Yrz܍Xز<|7WWа/^)]_۶+w76][s#!`0hlyPQQK;6̗Վ 5%Hc.ܱ#z6mڴ|'M2fmR\.
3Tȕz0ӵ23v*Rt
BM>I);]dd. 4v
ˏUVǦgrhaa!!Rf& y&e]3vǩպ!8u3pۡx<^{ DxaUcL)-a!59l^ ݀sEmX- z;DE f- 8<S3f pc Z=VR JF_<>`>/
}NOwc
.{ Q$t 4+"a1x^ WV<Ixz Ƃ2;++ ]}NExn4`E}dGr7+\Gwd7d:yb\UJ5֩Bd{{\9KgM/J~&#|@T.:\V] sTJ$.OLpdBCpV
T6G SD jD2#8 tLPo/D&w LU, 9g_jյO9}wJa80{ލܱWȷx8ULS躃X_ RSVv]epbRmhpa3!
"S ՛C7%X
Z[2x5ri G;ۛ|~uq6]UYxI@D2p ~=9{lֿ/Pau2+7'O~w '
pU G =arIwi@̔ߡԨ
} 9Ll<jPCrn kzr;r7*(RF!% 'ݼsXJ#2O?MXa=eø P}ftMtxAF\V7kd<mŽo^(}X]#ևO?\هƎ]oOqX skI8 IST.½ $^?&,<yi A@!
(n)X
nmn Zo}T-eVǮ]uEH0 *$6 IHA^1$$`7_p9sssgj1ٮ_Fv@&ω[7<
1pt'8=p~1~o߬/۠Icg", h ϾH[`ڰk .Evɴhibs2tFm,u_~\ZZʮ|uEYQ -4 7|M)8lb ;ww*T9)! Bo~yο!*opuky6h,R!(,R p@)G}W.T
@cW+tو%:bqOOa `l jkˎ+ fCPWeɡ T/y}wOqc> PuvP S,d4[V~VZ,D+Hk)S93GZ \}L/ 'r^!j:ڞM,wsz( eA__]y\C $ lި߿9<==띝ƌՄw39 ̏Ng,
[J
jw#vSK@q|v !@(մ;5.c"zO
r$@xxjLN
I[n!$Σf)W*jmgϞZMk/dw#F0KR9dW!{4 }'C2QS}xH(2#^?eIyk?ϸ<Xr20-\lB f )[ S2U
-m3#dfeemܸѰ:M# G}KtŻ%)HZPxb^ՙ_ ot[Bѡ9?O4.aߦl2f#/?'Ö&nCooztCU&v,086lXo=f5`q,$)@= ?8PH:4I`|vwBhi&5m)pN;^p8&%|S
74"H!+Ԑ B-%>|dn?(GZL&쬱>OzlJ-F=#Gboܤhl 8֯OK\&Oimm߾`TG Yׄu|Nsul`{KmY6tw* ދ%]ɸmOq(_6YӘAp ¨\`^D
ܶb)eJ
x<90Q R7gNƙfTVVt1R%`iIԘ+lONN 6]K* Lq3fd<
Xl<"C )3q> +$sâ )) ^l@z]&ut#BѩK:JsNW \;V K?p@}+nvUuOOY+hSEDDݢ;x=MtG&4g@7 Uci&N%fX6R i% ~61)>+≲?>p|'PӨ%ЍW6$ YKU'Yzrۚ778ͦ58 )k3͢>&k[T=P犞f#e<&xCWra?[ r|֭WnTiX@A:V*ȹ!+ W<ͩTk5~T;䭣1OhPuI p(h Q >k
UjXu"y.$).~r<kKo) 1fNThB>n B x и$FTzNᵈD虾ajƠD-^/ԫkv.J6VBWg
aߓ
v-".|90.mO6t| x&>hkXU[
a\,tGݕÀL-! _J2_EAD]j:'lWy~(0E()jWZ7S6IH9F` 2l
xe!Y@ÀC};q{Wyh>v zMYCJٔV,RdC5CW1.&G㺎~}oqo2^|;6~J0( v3RJvɼwr
\Q,znDB,S:a&qkk+Bh'~$>~\&X<c/O,7tƬ?>./D}rN V> J5|n p *j Ţ |f̛9=O" ^./ܜ|<q9 (m Tvf@MYeM"ZpCU"*T+V PԢ|`UD+Ped_d
$$efHBX9{osn hT;PTK5Ec羵 0S`Q kr _m#MBQJj+w u3^@x *)"n*nBbK) + NMf1677e; }q)e:Kab 7r^4Ws7vO} \#JYYll3d _OOo?|7-DľH)n}Fq;
7l?uyI "9=,'_X -D0#
0a@A
ċD:>"*AD@X hli[EA1p 2 A9|FUqgWFݻЖsDгWq۔l
zP% ԓ>ph}bG: /z<Ll>KsP(fٷnљtppG5X@^Xs?6 ZLhn-eg\Ja'0}iK @,DoE3Uפ+
v&y¡(x$ "j&T!zfB sPU c(n D4g=r K<&|Z ZEni88Fp7}ndkꨣ(n0UňeԨB0
2?^_A,z%MـLa2D̒m<|0<:sV~C8eĊ/LfRS{p F\dv+m I|Cg
=3ᗢ XCMOOy 巤 7=`n (b\iЍ "4$D8|dByyO>y|fmDR(22 :س=BO;L(cZ l"E i]RH_`?ON{1 2nEE/x˱U6mެ,_2 :&E.
@8<G/g~l3k߉yD` A2M17vikkk
ŐOdRc(V$Q/ p8(y`,g(Vg d[ΥW>W>Ikra+344TEE{7Fu l|w9[wm"3Bt"(L'bF*!Zw
/̏
9"H!bٍS B( oȘBx }}A'US&+;*++ ;¾vZ}~VRPNUSS3""B=MǬj}hc}=joytsՏ8, +<QĊXr.Dy d
fsꚫcY;1
3OB.:ui ]d%S(z0^+lI xiJh r;f) F,WA@M.I*JMII\s뮫H&b¢v(t Tf}/R|E7 44aM6!4&&&|+$'w V5ظ hso~oKII vG>{Jn^6*
r#0w:G309v֓\vϹ2Q <c`/; Øt?g?ϣIoK0]b&9S?
4
+CxIrߡO, i
p>z
6w;z0wQO讀s1r)%9~_ '#P
yyÇ>}Z1¢)eM V#j+55)v7OKJK
^; ; gr͖.<%C48C凙h8))˗y9[mU
>ͬnn
9n
uuu M"{?{&>WESɳ\nUU喽EE, >hƻ'aLOO_e-D+OOOL ƨUA8x0}0#۸qcݺ8q;tZב Gss]b,4!!] 38_"266 ߆7].+v x^]g>roxΣ pzv =wQD~:q1bSB%
}/xacCrrocD"1E]QHCn\]Ո1:1]yd)s(32 OHb歬>;y
s Մ(&iiiUUUakW2a@^-ҝJ-q0舱Z]]?`_ł_SbZ},Ie E%%!"*,/~7I5o@̇UlX LEވLS999={Bc\N\i.ydcN-+9w6Ar
riooo555**++?
"?Oymm
rgՑtu6/`[2glA{ %U)wmA
r`jFu:y2ݿ}gƤ*3-=v["~G
E(yl¬<iO3M*,^2" z#+4&g(ЧYa>+D[5Fd2n*{mnni>@dUX7oH݉[Oڄ/|TaLaP^FFF_O&<>T`9& T#3;ȴW/e @Vt!hWEl ْBU 2pe>rǪ?k XG5tUʻʸ9{8?`kM#TJ-+G)5 XUz* 00N+`zj- Jc$\ʰu2m\
I> iu55C٥Ϭ&Û< <#K 1ʖt֘߷E9QFAd?o"C8]öb)g3^VCXf] A^fovҥ/ۃRճ_YY=#[2mҸ9-9KOV_ < v!ay1Q+g鋮BPң%kx~XfK{̗\xI/˭k3.)Wv;g_.H)iTuIЫh-/\5O6]V^RSsANQb YKƋF3^mFuNN**.סO.he__V]lg>XFY a)OQCKY647ط?ڀ[l//N;.=@k (7pt @z?`_d7/}-.Q,u?y^̸g#BҒŝ Li6|?AװGPU_)`r7z[٨k\IS UL3;M٭VvC:"E~H H)s,7OXV+f,X& Ty % ` ';R 6h&3x0p vۻ_ I|w`-e+
%hs۾ oߎ6Thg
M _; B&$[`Fc{' NjRj MՔ$gΔ>S,Mb<dN!0+RgecQpa.Lޠ/o0 ?v:riFX p ]9g4VU -5-6$_Ȼ(=YX@EFPT=X+Qc&n
."U)23;]Aa]&} 3w̼ss= u'F$ໍLa _R( #x9~W'K AdAJں,k4Ψ#&0ǖ rM݇BL,Ma5,t {|v=1 Qrֲ&{+:q Ywf^}hs+*&)Fu{ȩgk8"cT}e qvY.khL d4 RIyZ< [lt5_~X/3l.9leރlD$
[z 8pرc^eM.j+;{@TzðL0A4t3j~~lT~
_gR@!bH^H:_O8 {< ^mBFY "F{C6Ś|
<oo fLjD /*y2 ܮNg# ]`pFqf͓KpdgytZ Eӂ븽Kl=av$J`6,ubI(-LnRz/f/1z_xG6a2LJ*9l`a3$#@(A 7
A%7
\뿊[ȃ"|' vJ1~j *<[( gV}oGrFkxg,jm\f(~4ANEB
IAE f3"0<!tנ QdHTnC!a=d:MI îZYZe*`&EAub_yK _(=dIq83($fvkk F Lϧq7$tu{>$F!'_ڻgMyd kic].&u!m_W_kfjlio*7msD!Pg7RJ&jkH}4KuObf ?NfjHU}7SeޣP(S'KqqC4bzE[NqmZ#Jj䕬]/Rϰ~TP{|
sBX'T&:+eW.g-^ҶI tG
Si[ JRwNjq2HZ%\!0)}"Rc~G\}6 W*|QHfCds"ᑹcxoB3\#> 1ΝH4\+/QaT"T~OxpI@aqTbָ%1>$2V
5a-bah{R ћUrS3aĐ` l;tqKDo CMDo$w
;"|,}/ ϴOvRx8ul*|~Jogc ҍ5Jeo/姮|rNqrqgEwwm
% -)&GqtSΝsytߧHw#++AEEԽb' \uo_g?Nl
*` 4hw v#+ϼjo&Fv˽ A w P3Y^efBJg.51) ^ʠ-^V_N 1yxƴؘpQv4
EbDLr[*wΣ>6na~^:v'|@QTb&4#
1Г#LHcH8Tт9 ˤ$ %Pw?k* 0AK;a> , v̓&DM*e_8g⑮
QN0B#ʵt]s%(6RRR>=+92jUDKZz![Ge F$KC+U ^C AП\
+[ t~ "܊), dPT <Ho#, ~#-ʆĻiOr[?ޚ m@z')+ Zج^~1]yYk%0
H;j
}<& 䱁V.ʫΜ9{H.D0^"#&Y^?]/OdKL, ᬽ&?Wwi훚=-rp%"at E1 T`HnUerNK)IK1
Y"
"U7l{D^×/ݶ77rQּ\ R:S$*fB$Z|Z^f~S={i5$:U6zL:4
?uw2a=?+V {ܑ[y*,A nۨG"x' !; e0ZcmmN3=&0 bow z#R'n>NWWWOOOuG
zO/ıj:INVmQSfβCwrw6k{z¨#8{fZ#P1I{/>`fKQ?ZPjqVמ㝝_7o, Eɓ෦FƋM>S;@kw̞ a W\QC؊a+z=3:E믿}#b f3$iRֶOj:j~Pl =z5;(%) 5N9Xu
rmӄEm~YŜ9s
aMu҂ںR>\6UoO{[@KI=oo'
ɥtd=( t:](j @E)3cxOVwNewЍs~\i/~Isƾ@7њS7#B0UrZ|TdJ52@&CRE lܶeS eH﮾ضhp7}wG^Lw.W\+1*#G
Y?$tsijFAv2˰Z\Bd}zo$Rua9VQ7
g| bZcTZXX444PT0p53nbJܼ]۰ Т7N
uIII}uآ ؐPDzl>vͿEVVn2`
|ފ
g ~0O% s'\p%"bݤA#<%
8 NNNg6Y 'Dx;uÁ7t A Ν:} Z)p\{:q FMHoHoK
"ݏ6x<Irެ ~É <x NʝuuܜQL.DbB|\@`7J1 9ͨ@MA i>lfgY/%/ĕ|2D" Axtr36\= Le&Nwvv$];GzCQNUe>Puv`bZ}ek=Q#1*nfB8
#p"b(
{W,6@u%^cG@p#""W1TL<{7Lz PVYR_'zA]\\z _-ͥEF*b 2zBr-[d\k+d_
k=`ZƱL]fYSg?m<\t)k`累t &OӼ|k j]RTDbYLMDQB"Rf tÓLLDƑ4S(BkI`$ Id`><Z "Uqуa&f@pz~w @ܡtxϳ3k2 ^#dn:dT7I-KǼkkkc.<u4\6ڨ]σ{yuu# ӼBl=Fz Q||!n=o.LS!~{$QV ,?v C%Z(=s3<cz't*B bJ!C
( K/>IϩN*K)((JMMݺukyy=6Mױ}tvIԺu*ڔ eY:gQB|crm ݻvZǵJˢ$͊zEvG1vOoRlȯ7WÎ̴`٣vʕ]Eۅ
?^N:b^b}MN DUf3LMy1evYM3ªI
{ګ/ C
ax-(W߾ 7~|f7A@G:D
F|/ HbNsQ|7=o %C<!Kkܗ[X:%쯾t [6DyEe85PUc@yYhѭ[:^ Qxq:jVjGy"%A#,YqFſ
F^4d"HT CܴՀ߲1$ur:VW yQ8\]OUwnll<tɽJQ{ D_!?*[mnX-ݾa)jn >9YXAo@j'T/5'jmRRR(odY^c!w.=C G[l?>-g⩢~-؈ ğHӨ}^^ P( ;YB>LK3EZm%<gLv;d1TQX<]IWvvv---$%|E]~_U( ƪhT%DE 1
0vW 1}zhho~aqQ0;{u.ct{ cչЬ1n-;>l%ꏓoh1}
>`(VVVmsӦM7nܐd, ٵԳfCݶm۲e˾#Gڔԅ휠\_`稷U $ͪ
7 b9%ԡ4|&MԧOp#2Ϝ93::~gx v|\ _ h
qVܲ9w2f
_x3f|--!ZB} h$/}5N/@(;'lLʹ0r}wbG7{ (a-~oEm q8(ipZnա4z-hT{;w+[vh4qK֎Rjbq8<w뾬m,/n>1$եՠ
h /$VYބqt{ b
tz62}>RԳ у [C3 ,U;̚y
KVNgL Wk|f͚pY2ֹ K7@)*`%L,wT. :U'N)R X'*^5_O
~5EEELIMO;kRW
N6y:dA$
"1gzm'uP@QQQsU;{< ɰX,ի! ^Ԯ#| =W_&6UK}O{qMw͚5];}͛7{"N j =(}:
+4<3u[ U["@i&P;zݼpa$Ś Utr6C\lgkt-G
/+2
Fkx}T-(TAm@
Ҋ*6zO N-VieEFbՠ ysiANTz4gͼ*~vpt o HrdvWXrK *<1P bUE@O@K6l\5]k' @ &
[w BQx h.
qD2G'ܸd"UӅ`H^[݃mU4aHxܣV)Q
VPP Bpj'[3t"(7/''ie88ijF5[ې6560*ˎ 5P$ 3TB5BK_?_kkk( Ԍf*{*ϳjoky_-tdg}y6.` HgHwv?& 36D< !t ǀض|@,q{o0,\ ĈN)&4L}: K 7~*t_zbQOpNJuS?Zv?毹7Vmwjl~ji\b]٧ -BmF:XDBu & >ےTuDB,u'[a#<lNU'S(ɎeNTQÄ-KOQROI~9r o@o(+5&"⛑k32 mjjh&.F{
LLX<=\4O7J`Ʊ _݁ !ufH 9~숸T@by2eAmxzW/(cW %3ˀ(
6RSEA]f̜akk
|QB84y|p@a)r[hS.%xւe?^ x}ĈkNqJ%}ۜeOFjmF=2kcB]cccڣ$Ok{͖lU
`y1-r!.OQ
qm=ÜDaDY[&y^,{/fdB x^H<:[u&%?|͗\ `^[A=U 8!dj 5'~- R !m<}Hsf
ăr&0e r]s?(by̌O~XAd/32/ݽ&9
],m\,W/ m&p99գ ք=4gI: GN}a?o>~=@ Ganr *7M~3ദQ%处 qwq{rϳP ^.mCy
b)A$uyKfn1P"xٞp!y[Vn\ &m~8'Fѵl>e O};3EQO/ ܖmS5!to1Nkf#ĺ>+. g]:1w ΝVH?^D^ ~c`ՆZVy>Bn=7.o ,\!la*&|Oqs2Q>pL x=& {;kE7A=` 7;Fbź=6J<U("^R٘
6k\Ƒ?P phiP
0ᮉ#41Wzn3)# qpI "E_ԨKF( _G;/ ߥ=Ѽq:?p i4W.;0zjফ%)W7Gd2WވD8ښaxɴa):z{e>[P!YEGocf<tm0OjbAe,Id; }1K]Nޥfeg2 (^cܴ3҃&8::VX`O3!KLyӧ)1`Mr}<oQƨ݅I62MIN lHU9K"3|0܌N'ظ4y(g
9&n C: Ղǁ~X?EM StyB QH/HU2z>i4ӽo1gz 9 /or:kY<TF
q{q1b|ON _?aXV_}"mƻ(L_E(A<߭G=2.Y/c3 ,ރm>4MlKL=kͪаyf<U4X*!sS J!Xl:9 I`:H7zEzbr*`bS8={<={Ŋ7D(H ғM68 "bp~7潟z21 lQEFXqrhl ֠5(8,M&`,UUH8Mh!-5aJi$Ő+
n!W 5H6Fjmu`A\V-ȦR$cm68t)mCmfed"zT ę%5O Ɩ],4w54PyAؒ8Z =<\_mt()pgeM:Gò%=toN[ %Cv RQ8~QAv|F%7Ә ^ PSd絔ܪ-=5:@ Ĩ,
W];ס%L/;F6O$0 b*֝OƲ|FWvvvܹ3 *++ﯻs2<nLzğ <qK $v kiӦiӦDFFN4鳛;Am[ą<' ٭}UI{uqRSSa픇H$|$+yS>gۙP<:h̻J
>r[o( $-
ͬ==Hamy{ |Hł0bD~-4B0hg)1,Er)ТaCtT 27Txk @@,
X)pIof.1HކeK `hgKS n
NHL$ST7px?g<yݲ@Ae_{ދAV/ 4gW\]j˷됡 H =z!26#m(ߦ8Dc Ugs 39?ܴ I%F D/9bp !Q.(dDŽ uYh˖-Æ
k
2S U"ZuPKjJ021B ZĪ|vH$"qUZZ2D*D,Uʗ 'NŎn<Ɖ%P] Ji/cJeK q0sxm mg{e=O<|ut{H_L34}0A- 9Y MDέd]O}X샽hh:yiY K {U^tKFU愔^ U@۲q @ 8kb%x<}n$` ,
xh f[+ P|DѼ5E_$V/<#2jd|ai_^[IAN7%Kye4Yg8 ,<.T5-9Ar1ΤǑm\ ]u!qޘ:K}e.C /5 x$sm1
f<tFVhbuq\vz)(6}| !MP9 ۈ,JՈ[Ʃ!8 ,~V'_ q %Cū0.6V J+M L(x;)<Yb"
idh981)69qeee\\ɓ'Y,VˊH}+H
500hi-%qL 7.L
uaLCa2¢ 71
pD6 *EitJEm?*Bl A/T wtʢb
br`; M,7!Q(߯%=%
JܓE#Z׀o
vpPſKRh].סN __H`/?.mN"@/p3UA$U;:8|v(KY* (43j϶5?-ع
kVJpuihɎjfQUhI ups SVywm;MDCG>r0&2륝Iٻ7oCovw`yT͕0@&1t vhybec9ףWĒnVso. ._2S7
*:wO2c m>1֫< /Ѣ kX!B/]3I !}3Ԯf-,\?^ hժ[4QKoxn=t)}l31Ҩ'!֭cLXդ6n/ q7^ %͡jFo}bڦåg zR⮹z;ÈH_Fcb
겠S94FVM(
`P@$2MD KDDcT{&I"
(4Ƌ1ǀ./W|l4/BL3ϭisU:D3]Ǣj5-<DRA,ai1R2%]\0/<HnXRKkԳ.0(Ph*PIL2C>@"וBj(ǹ_>8k`;QWQЋ=>-"5$ikU֖4{</@@
,5Pl{Zk qtD FnN0=h;qE|[vX9T3pBK 2xw%]FS916MZ{~^ Ӻ/ 1u wX
qp8w#W W[1Mm řGT4M^|& P hlWG 9l4
Yx/{ ѣ˄Gl ʹ}E]kd1 T>}MJ~x1gPh įR?% ё̄DqoJ3cPw=!I\/s!SݞwYLY'aiYދ=XWO#RDe>v~֝O4ɃV
jk
{8)s8BF> UtK(,:dl%&≳2yC2ذeYh "۴!>=5աB:k/;ޗ vj-&
3-$,̕#/6Bo25HVw
++˿i'8$s8Hbo7npN ՙE- N?C# U<zE9Sǒ#ZvWiz.b@P6@g. {{ ;v nAƍrʏgTTΝ>Lګ'l*L 5 ^C|@W&'qW4
sbyi lJ
l{rK9,awmVfΜ9}tǾ0Qh&n{vtnwm@|(lOoL{B
s˪co{e/9zgD7v CeR 1k3KNG0IN{}mb
/Xhc7RR3)TOk<p#q(lh}6vk91OvWQļD<Qϳ\t]= =h"pR?; k|:_
jKU !F$ /+gpYe
tpBO/0 ڿ U|hQ~
Ʋa}b O
I2WroMR路 7<t/cPv[X-$2uԐ0uFeT5n#1S zm)DzA7]S5} з-8"NA}LC?SZZZEEE
XemB
?] D0,dMMM"Q;C +bR}~='<Th@{.b
y}Eb6[^vF4F;b R
ɓI7nX[[C?*6|Kz폿"f!Mc<Y wEr{k p¹s֒bR &&ްa8ݻwĉ?Dh`-|mm:0=300 fffwк&TWWquu 2dڏg_*iČ-.\) ı9rNԢ2|4uԠ pT;w 4HYV6 F eeeŀ +$wiyB!xĦ'JE1!% f,$cǎg0vD nJ2ssxpfZ2<dCr2R xU6}=*(( Çs*N^^^K8%Co#x}R S Xe{oI9O0Hzj2gώ
8 NY .>&C{"TerqN7ʯǯ
W"]IzYf֭xZtF3Uo)KZG* X o &pvppPBhwY_qF0f]3RaM*rkn.-RfCz* Pki^ UJ]x1М ka7'XHHH
8'7m -L0A}&`jjj=assyH굡|ϐ; \X226u4kYT"xFt75 by?,U ͛7/_o T -?s -N<y
K Ry<Y^nr!A`1h9z<]üv6Vz@ quz> $I LnM
v=`mDfe~/.-{Y^# =zɒ%666M|>rq$RT.1XLYqUQAq DwTsŁ۞mc[?ZKpw]9 ;z!",:ѣGرc#X /{q+/&itℓ W AF ,lc!4 끒dN~EPqT[q+A*34tTW0>`1O )04$oZ^gpA1 H.RoXSE- X К*OU]7'BcY 1\ :guS%y('{%Ǽ.?G ֭[D;vh_UgK24H(r%I'ϙS袵$Xx E75G
P!ݚ[ 1Qk+ <r@\F^<Jޝť"ܲݫ :}v_V%Ɓ3Pǫ^oO;c(iQ(wfz6ܧH̎Y
\HB''ǏO>^i:S=5g뼱D?I6rҩ.pk~gͲj[JAЙi<T>:*@x%x|@D
H*e(*ª$ /PTy<.G`%hPL&A'Dd<V UTT9<>L%rk|.L/$Bx|OA`.R唦g'QLM͌ Xlm W=F Spp0B"ok~qx ŵ l ͬ ldnw=cż
< FJBf^\^ujwq:,kGScS---t>jb@O E9 ^N@F-S*ߤ`n@ 3dU<K.]ZW3]vqBD:i)ZL-Jx71AJɧ33lL
UTT
?b@5WwmX'c"%8XjhH0
u0h4DџT1|F|7Qi_˵ݎ'\QRm-俣vvЬ711aÆfΜ9 j
LZ$UTTܴCómT1j IQLL455`mb=w/s7eb5`-f[PD]̍_84uؐ[Km
"w;٪x)l<mݍ.E=Dϙ;v X6,>Oۭ}O=R+CTjONSpSM**3-NeN/7աl͝i<AqܿK.i-Pi ҲZq^|}';s)"ؕP d&&m #͈^HZ,Uo'bjX ntE] g x O~
?nFЉR :WZB-1 [cg*UP(cԽ͐J W*Wnɿc`PTQﾶ:8&H/`@Diu]BQc'$^&\nUOG>s7,dd QK~}!aan,_ ȍ\9]{~jNTK t+
-7f~*KuS##c߆opݻ#l6ZPcmfak(U#bx5w-ĝlLkq"ߐ:dcE9ZfdtHn +2 *+ 孢Am3P'$$Ŧ0Ŷ @ӧP(]ov@j^CD^[MaMހ/H$cO xx< xd%bSgF 5ҩedKS###np^ynԍ'*A-r :uax aa'nCT'x4Z P.|(99NBheojlh-$ [21$k$"%=]IΡMص.5իwX ~[ry짤v̮NEhIф*Fzz+W@/b2۶m+..Vf{tl;vC *Y\r֭655{n~<y2ṣG~DŽ# ;Jiok8i?F&0svXt/| .첲lmm*!/ywnv BD,Ā.uo_ pˆM@9n_0h`JFpݎ#cySKK Af X(N , !Py ;rkp;Rvq,YI%+6$eV<p
ҝR ol:Kzt B2T!s $. y R.dpqQ> Gm~K ];w~֬Y@72J.d^yYC㨒>v:::-D<F[ 2Bi\YSSc
{f>~&ߣ'oג1^
&S<g?eL-}x" TL!g<`UXv>\sD@U_sa 98-o~/^盛J/K eN6֓ Â::}!~.(qÿ
[},MO(m;{{ģ>O˽?99y iiigΜ<88Q eW24j<$G,$Z o.9cӢYQT ̜9fT*c+D"aXmH͏FUTT"Q1Їεs <8%%H{_1kf dp@?%n7xC s=wwz^ Y },r ,cW ER{YZqMI%O/LJJpttnjSn.lGjAϥaBDR['< ߛk~Aٴ{n//ϟggg
nC7>y5}5YIy= j=zX7_6'lIL O>ƍZjnݢ V_zQ5ȳ]4yv3T["i`A :ivXT>?5F366 @W\`A+/ Z7I*F=HE>bQLUe**dWGe'UW1t9yk2Amo8 qqqrଯ?6+妕y[)="z-ٕ27Ecu@p&UCtvq1~((K ϗ <<<<yҊj > ]\Ukba
dD"9y$w@ԶԠ&e,Ӻʊ395 ! B00dB\z&D5DL蹼kGK߿} YdքB_ڱ
ۚoM>===
"ǃs1B6 $ yhGN߷}VO?]npxlv*U 1o<
UXXx3**ŋu`<O{o/ᨐ̀ --- ֍7M6رc
.;E&
4]DľJMšM
ɗePBL9{?gy ApYl:'A Nv' cƌѣXXXB |7# 1Zm$ >%4z 8?ecbd&ioˤRNʍ.pLz5 5SCw7xٽ+ X(
<*K\FjF (u.8aGKܪC3qԒΎfr\Wi _8bKAs:"gM uWd2饴bf ˧gN:Egms$@̵̧"!Ǡcуlz~xą c'|q]A!So{r'&: ߫
ML BKN =ilm2Kj==C Lo ilZAk
>T*ҥK;*e%9I4A'_x˖"5<JRr"MMm6OD<2!ܽ1) BEbiY5p]p츙bS'
(S7(~入w^9s挗˨-OoODfKKKsrhK#WsF$SWfðdU55'Nb! rH̳T[OC'v B0E_G=%
_ @1ct߽"Hl&~A xU3 #3 8,^JJO7M]K}G9(Q_(b[e~ 2j(ϟiR&` (ZT__Nw~>vopw2aԫX.=M۾Ȭ`?no
A`:-. Az tOPΎ;oqocd$
ǍwΝ@-ͮV#(
|RKVVV=l[&I;:I؋A AMjkH+ R,t!CR [9 F ͉љL '> s]p1ٳ|͎*$rzu >8|Kl۶ @k"sq5 ljRԭ:ϸl[V-TI\69 T% x@(IYT(IJѻ K9Ec܁yb%@ܣ
@b`]m 2qN@:."[0KEXyPoNIf$)[&NصkאUV|A$Ϻ Ӽ[=J0ox/J] P8.]TO_
g]V@[ w0vave <.>)%9'rsثAY
+8<!ϣAQT<5&ƌ]=suC=ɗU'j{ww#0HWS E|k A ?9b)p
+ R{ٕ47ߖN 4[Y".uv7pE/CtWQ,`1w7O6ŋk9Y"rTPt _L%L X cO"pRLXU?0hՎlfAb& &Fp2 ^ G߫
}q&N~QWSf]<:~=lHWHX3p"˷ =eZ2عytfvFfZvb5_FMs̬ͭj %, 6[E۹7455ʆ ~9s4RcE=
`s:Zwq2aOnJx
h֮F&zzz Or=_SgY&)/ukh [OxcY#*++oܸQ7e%zI>rӌ
ת*&$/SBܭ3E8Kqnif^+H]]kܭi;պTG[M pWAݘYwEbIq{>kdi'kc4tp ݜl
^&x.'}BaA7|@$ܥ-KB@J p s"U
A,3gR KҒruLL@
Gll%legjdh6=iBw&,ںmP|?T8otǎ>|2wC
]?dТze,W+rYMS0rc轍]m{2U/p1ksf8/ FK~KK\@ KzZJus mId5ϏsT >GB
dB70 Q1$~%Ǫai6,<}O<uGMM#oga`۸U
NOcK
M?<qSTA`bX4-1YQ3 Fal\9R;)}iWQ|'^sujPؾD@,Ad]2$ ȳ]XM@~awQ:tbQgx0}B'Kx:6300o^>v
LRϜ$UTCMgHX_88-e2b[`>w 3jÜs=3 yH=TW7nz=:+Px<^dC;>hv͓H!`0(lF13*s|p%-v DOziInzLKo"4[ Qޙ-,̌M1M\tݞi> f^1@o'/ t2Aq>[ݽ6.pr/w .` 5 ,8n}np2! sA_SSuGWV#n.< ՅW1XeeoI+2@\TKGcY6.&F&:::$u|9n+4 VG`q^
B xYiU\Z۷ENWhׅѬiy9h77/
mUכn 2N`f&5Ͽ['( $5 Z
AjP
+> @:dXWug]YjMkHq'gYL9 @A-yxxaˍ`JKDkc F>}&HN״[ٙkh("BK?w 9x1]ʁ k5h:ݸ{lԈn Zֱ˟.Z:(n+_,]g-mּZlN ?s #k*AE_~L(ty!ĝ/,ǵ3`M*fӧ~vp]A[Rj0gmgEڸYzw2e-/@,ϛ]'"(cqP"Ctes9Vi`WqE
sgxXR!¢be2Ëuf}VBhK:~x4j%3D_HY20F|tNZQnf|gMBs_8j1 nIAٳ>Bc S#!ʱRME. 6$1Tg5R(_wP"7H xWAS"~" &u֪J3+) 3x
!V?W<3m_a RS-NDIև&* iN\KTvy~V y<cߴGP
Qhϭ#YI* O6Rw4 wӋ:ZIڪagOͽ6`*lqܮgO7Zjl5' 1pxlY13%60gm=7,qp?mϯZT<[h2pdeu/ͥ&|, #_6/O:jmm$RdӥM7WE^K&n?_
$/ :ڹu:p/cBhȰ~ML _ u16 *'(WMm՟nvA; x,\V-YO_*-gpTI^`ԗ'
"E=p\pH+"2 8
e ɫRwb
-=\Țz=僔uteeo
}oJ9 #MRʹ@$=ǒ;ndg R5 ȳ:E(#$wÏ;@(@h >BX !V3wLvi yp$J?c݈A4u
K,DB9(UQ'/p vrܷD=-0yND1&ϒbQ|';w ;ƌ8>gql{O=tH IYya gHIA&
fLrw?;RDģ ntvRܛ.Tlfhlh:a܁O%7BOźuҚKꦽk] fR$^*j-M8<.?8;?Mܬ~ϫ5cN U qpyyy Pǚx9(h4iXl
>Sjp_Gq2DQ_#GYiQ|WI'wY{dR2x:!D__L&7NMw g
=tC%U-"x(/1j>js $pt&z٩8SE# IT3θ8*d+oV QcDqj|.+<hܤrMLjHTu!K.74oQZ9εO|栥W('/A ' #ϮOOBjpD7
DNxBEwR_:hX!
j~I?1[EkTzJ] REimU )^n4uՈzKH&*ɘ _$H![0bHj9_U!TI8tf*zNj nc`*Ju
H(ڭݝkk k`* ({=.7f3sf̿5KVa8" ]:@Gj,EL$˫EEU"%(WƯ5PkC5
6`ダ\ C#ĵŋDeբ2~J^uZ7Ƥ2)l:ͤ0($]u
8ƤX²*$T`2@])drK<#rR2Tt2OGF~[mz^ Y^u=u*T\mkOR )Jh7iJ!F^O_GN"`qE\P&Fn2*ATAhBIf1Hm/qa]f啗ٕ\\Vzl_#R<(:y\qZ!PuXGskMe.
`hͨ Yĵ2Tf@.<Έ(`diM%#?@ҥB]gf:l}<kj/ۘ1T$ʹ:,kޞF<[Ft@2}gg n6OBH\{l:yi / l ;Ur䞶} K1O( {qmt?-b r2'X F=< RM&9%b ٶy{o$p7\0б%Dȋۦf7'3yO`ɦT3 dVlB_$W_f~pc'' j9r?2 (#]ZW( brOTcP-TKxsEj9%ERHw?Ç2DU9m,Ht]V+ hR ?8~5??R<
+y ;OӦgd-8>G"i)t7o7}_خMZ;l"բU{5<eeddP((Riig\}cRb&U 0 Bʃ(!/vmM`4A^: _ ^XYSuZALe00"_x>x !tl\rƵ
=V=<<ҠE8I'
7<~) ϤũJ+ymGf2$4P_Dd2$2JNF%Qh@N(^sJجu2`֜&0)A qZ!t0/![cb0w˸U%pxQo$]7 N Ӓ rE14zL=F,# ~kVw*<[ *r5:{Zo%C53KV fܞ hG_J
qBr=>BA>6+ЁqEOtaRXXn£㳊u Ԧ\,ғ)f|y4;t;vcNBsx`*DBn:"4G"U3rW4^A[-^2aԺA<qPд1-z,? ""5{a Y-Ki/;'"T̴`];}8wuXIZ V)ݺU )Ǫl'<o^y+ ͉?)ZtfU ?C.UƪDѩw l<%OLheX,dj~poj^Ǐ 퉃aXK|>NVeP&,y)P`reEK a*>Ʀ9c"0h<N&!Nf|9O|СM/oޚ8Q෨B8<말+&D&`h nKgZ/ (e$8EP [wUD ȇ pIC @ wE$rdE@؇!yґԤF]&P5u-&g+I~<% % /m獊EBF¥B'CR`HpYR6iXW=hM ^;5g/Ȳc+A1 8}{ vh570kaX J//=e {l?)ٺiμy/""ssgE
$o9g_<UD;H_5gˮ GJ(ǦNer6h90˦*ڡƶS0<ы h'#0iww!|c)xs >ݫsb:TtUZ@}Q: ~c? -qŢAa/\|' U^?SLX iʀ=)w/tS۳(D4 Gm^ԷۺIfe/xg@;&ۧs0lTMd^YG2NA w$Ri42MV௴Fv[&x h$˶OA\{h3!dH@iL\$c, !)C9| o x[20"0QJBV2' )2ưJH )B%.LK8-SB 9#6o>uAQ]]rBѱأO~T6(,Jkwv$>_0t
S0Oz𡲿6Dů zl+;M^y8DcY:CH{̃vϽ})Kr)X;O`Nt<y79䚌:;tϯyXC"c^n0Tߋn8u+wmYKGրt aj]vӧO_lY1;wڵ @p_o$@ȫ5f8F
GbT ݍ'e%JI|]
Ww a60Qm Esedd<y222Q҇*Dejc6m
@o%բmcwi~:B$imޫo&3! !B;>9h7xWB=/$# ?rv['
Gr1*$BѨ
aٚ4F
\}mvjZ"Kń:AS M#L)$D c&K *}t,s"Iu;v;ը0P h(UR.'uf
BnXLTN_
EO.ٓ
b[[F}}͆o}zqEmSبjC= u!Y-5z*\o;)5 䶅gda-/_'D2^4|btߤm$, `NI%5 `7 #}/6 *R{F8Qb,
8i
~b |B^zy@/&.3ӷnڳ*i3q±ص?x'ֲ}
oSgJ{>}qߊgwyY L%[K Ҏ8ϕћg 8ȯwy.o[} ?y깿qN>pS!PL! K2s6:@W}a aߴ/_}0
{HIPI'WpPGs&-X
'ſD"]yz,Ɗ%^xɀ LL͋:&*6=-&PB_J
yP؈S+z3|'Fytf7UG^xb)p!cgvU! ҟY6oUj;[6 yV%<u6:gy [^ <I:LoKc'~N,1J[=cCߺ`5fN3xf6sjZ7Oe{ ={9GnH!rgM ]̅*CO1eQe]l>V,.ؽtE6֧WfL=ƿ
!{쾵I JJ
(NQ$'Ղ'$e9m-"ȋ DT6[ B[ ~_%ҢWØB>17f\FiI" hjpelt9 5g/+wdY{b5+Em 4l
}3=XD:{*;4ZQi!7CӻF~AR!qE'N-
鸴}75. MeQ'c%.Cun
=BݿC"kP}=+ڄr|}Q;, K ZlƥC=ղI|H$_j%$JG*-"4`xp" '#TB(0 e!t!\# K0ӁVfK\TJrHKEcàvMR O"s:}Ƴ&w ?0\^$˯̦s/C2|1sJ Tg6vh*GF| i-(dOi*o1G$&auyu. ҎMr_G: Rɡ4ffP:?s>и36 @M0砓~qPF.&[sΥ, ;m6d^:yȄo ]ec V>3mL=iMWn[D
Ě>RަV㊛UMQ4%acjfJ: CWf@HdݗoYsr~`ꪭ5limIpeOmI-^3fFu, 8 4MbwBES=,)SV =qb/¶|g<rifY鷜
+p :.?jvvS^'CD" vw% el`` ,N!NE,J0
`|{rAE {kYTBB,8Z2=nߞٽ nh7<k2 #{ B9OMR$>pkP
MƤ_L`js ^\Z*{w0^$i+n.bRo_sTg=_#%ibaEQϿ녃T1vڐrE6 3K_Λn ~h} q9Fb(`.!FqB%T~UX {ק`r*IJ:6gF`" np=zfm ;ܶ늵L!*Xݍ䗀bGsG{p\8ʹOߢam^dG7>? Ϳ%\8"$$Kmb)7O~
{ 56PC+& # 뷮7͝ZMެ/e3$B~w
J@ qĄ##"` R(DHpRلoPĄ';:*,NwOU`5;6ѵDWW}Jtݨm=Eu &HAR@oHkt
$egi ! I>< bOgh൪
89k(^+(oA<{!DHG >.lsv( ZkkkUL2eԩ}y$otI{Bm UPтj3bqx] cj 8u(soxIhvwCo"0 X G 0&s@jV|lXXX~&tرcG]zĶK) 8 XDn&sCM]2Kx 4a5?
W!Q9Xb 6ZdN_WG
BDm8""|ܹ{ٳÇ/_6{ ~v 6*F*mu пNe(r2LlD1D
` ~?Ms5rdy{hkikk+Bں1NwQN8&H-dj#;C_*fggcɒ%ond. tؖ'6.Ԍ Hl QȐXQ)_bh hd@5#KVm^kͬϽute'g[R ME?R#.Ğ\qR=L&ɽ#5Xb"##bbb#8)zM`M sQ
@ u dϮDQ
E=s->=䎴w7w0>çEH VV .
jؐ,KJ
pvp~eYd%5kݚB
+
wyZh0) ztn&bQM-n a|> 33366V(2aNx S{Z6ٴwaFK<^:5a1u|w[zap`ih{q!ӌȳֶAec(@HP^O|pyB4kwY4&5YDM 'JLtXt97sJ4 ;vj$AzE֢A_竰cmP ZβM!樂%s5njA<L?Xωt =uQtn'_qDļɝ δG%ݗ #k$_ͺIv''&Fwxc04hkPCׯM.R4|K+|ed\ nr .#8 T$˸'`, &C i* |poҨPDi00jneNeD>hK) &3P+;4ͪE-˗9HC)C@pkk6 M,ךW|Y'제 8E$RBYX:X$b| ^[3 $f5RR%l 8`gСÇ4iR^) \??並Q7ʉe$a.l F#;:X
[4e q5_,[ͪ/^xƍ &<yc8:.uF&lltt\n_}hf [qӀHUUU.r^vn,#eҮA[O `w~U]ab
#'.*s FLo"קGvhlh tݥUjAAAXX=7oތm<bԥAc\h-0x
s2tEƂ@]:K6ĉO<mhdddTTBX^r,rOGʤ\:Ƥ"'F.&hʽJSV+7K&M@EbUn8.WSNYYYEGGWVV*$a9Gb`Mv린e8&ڃ=l4jb7+͢J>@ops ]<<LJa¸qܹ
P8r?yi]_|HL&377WK[lؔAi̖[[~"jw~Nz; {l^'ߝ 9B O:Hffff [liF[&n4c4rLFe{ݖp!6ecҥt: //yٳGQߦN'T*uqF"IK$u/F˴?C$ݖ =zL8^ZN{;v۷o9 D"QT~I<.X (cۂ:hk-TWW_zu@I&XBYsy͛aÆbﯰ|SDX?){Z8v?_.G#}H$xb;P( ?~s_|uKS ('#hb#Uh1ϩ6bzСC;vҚ1csQ'8 ٶm[H20X *iQj8:bøK,:9 L6iSjrBYdɄ ˛"rA]\ݻwvvv}\\ [zE Dzq6(oW&cW0lԩӦMl'k_ڵccckjvΫ䵈5; 5Ki) L}kKz+ `5
4@6Qf<F b5P '4ش Xb="I* pЎ ;>zٳMW*|Ӭdʕ|> P *0k]5zLfelV㭽Z7}{ny'ek4N/_3ڵSѣ )Z5_
1ϟ?Q@z+, B| +GHHr+*--TxiyNI,WheyCo4\?'1E?NTͨU>}ĵkannLC<ױ[եNx,dU]b@̠.nW&X0AG | pPrN-nTsN*RSSO:ui%Ho
swQ _w661z~31eVģ
b *S>)5<0?P{֭k߾ŋ^bh_۵kPѣϟ?\
sn/xhK$>0H"-<|"n wp|_#zUӨY00wq֯jҥ 0@=` ;#&Lh2T$~z s玉{njq&;FVF&R _ۛTiu h[Y+<+|ϵb/L:It,e){Bj&Q-l'~/^,
d}+ k}nݺFFF`a)cv\DTKK9 C7T#0Ub[xI@nN?}1n=,Rk1N>(M!DE"ǧL⢴2 Yooy&)) P*eTyvt3 bD-nW,B9Fe> .O5 Jqpu- DhUo5(rԈSɥK1{Sup=ڵkRf1 ;UYY{nUUj@oh9^g+BPtucQ V/
rc ]/?DcAu({<|-'qg on%qP WfcG.w 8::Zo<_=5lsxx82663gǏ3Fxt5¨N)a` D<7V.RH b_]/N,訴 JEn
$֭[} \25 EE L/cEs?*k"ǐNkSݐGO<)*&Nz-w
!WtRi4 W(֬hS 83^]bb"0l6P߽=;ѰLI;_WM UFIعfW$2ǭPh [r m \ Њ(: `._H&-lklj0GJg:cq"
{[MPaVI[YvuHq6FNn%WTUY{MیG[z + K8eW)RCE`3q}۽_L%((盛};ċ{wOGpU_'_UZV5dW *I\k`OJNk8
Eck vѬ\qPRI4RH}mg &/$SVLnhԥUmBd!/I" uǯ K*H(9p;iG xooOcADmݙ)S>:H(u:<eW7_[}- R̤֩ev`'##899eee=|7[}CON2*lo8dӺM~5z[
'#'D bW` ]@2nC 2rYiO;L-RESRV\f
8F/CBEj2f;ovVZPŷŮ5 =:k,}v{P
f9ŷN*t71)F&# \4u ] w7@x?
˗/M72ӦM](VzڭRgx/U>ze>æk`b &/<0ot1*`Zؘ%I B+'-gU ъr|wUT\xI $YF`i/$u6eC2~
a\Tڭ[ muY0WnKPqFs'::ǧw={}A+Ͱx^A^IdRNjQNf~am錦no'
3122J> ⢼ܔbmU[o{!`|JQ D .WјbA5PȲX< xd*!HHBLpƆ C<JQ Ш J F!K@"TYL@& !0) 4
S)u6662ѡ-af 1I_5_k],R.]x"))ijjjur$/EX>=y|[? Sk=>`i#>O:u?%bޝ<t*u{2\Uʍб%M544X(.dNa X㋊R)Ry%O=|
7*4DLb:rR[|{. ?;+0uu5@>L#LJȋ412100TQQ!PkS ի bO?s]qJ.*/9҃Fkp};sLΚ5k6lИdWxEEQeZm\-ec,]A* ~ Gr܌ se29( 9HGgM]`@ IJ!tkmfN`;v pժUw
fy)d+(BikAEVhiiM12]5 ̾ ]]*(ŵ=Ik)s 2):4IE۳
o,N<9eʔ :UT
Y鹥ɰ&KE9A
ң-ڲMLL
YGj1^nWrM\f7J<H(NOJ ic5$:YxQnOm.;bUdA&LjJ-fEQ[b !644400h> SPXCѺ@⢓ ;O#3===P`iiЙ% HϘía/o9JPUzp*Guq1qG*gq0[U&!( aBRQ!A^<&0@\ !S*Ja
D`(,a-gSLǽsN<м/ !7`#'>"0H𫯯a /^4k4}zfZ.2ZBپ] `a/"ަ{}wn
|u2C
F*0ɇRp)ay+ L}' 8ى6UܧәFwXAx`[`O|Eҍ_?U#hLg].L0E*Eb&eK=:8Cb7& ~Z!E|ILF寣\n}]`` }+ vl6bZ[%$?d1ںәAdRyIUbZ#]_ <4445̡y@ ,o
eYZ3U@nʖGj@PZ(,<9(NW<y#7.,[p%tDkWYVPEJz_Dx }>s\QwԄ/Wܐ,w;ȗlTHn?_x@RRR`ؑFFF) #';*;omg-0#i4wnnNzJ< >=ru윔[m=me]rBΡiB:3O[}%a@ m) o&.A.3I^c+@E B4:{ "( TX$>Q(₊Nfzjiik.((6V~535+ωx&k[jae䣣`0Zˬev_D"A^~nj|.QσΤ`(Fe}RD*eTy|.ΖxL*IP FXLsa2B4*J!:&&0~pgΏ/"ә*l
&
[rFBܲD[O]cC}}p"+--+`l3@[Wg[jY UvnAVf}}5qSVLX
B4* utt[PɠI6Rf(/,,/MySbafc4Y[L.-~i`O60624{Z ' M
B1 2u4E!1،$ cCS`.
AJvu\w&Yj?@t]"q0͏8{k6cHTEG4˭ egT *z{!ʮ;ų}w877PX$zzzZZZm H}DOA4c PV\e@vald䢮NR[P//ز0bAm'o r_?4qqҲ\TN Z6%!l#9Au*21Q9Pwc5&ﳄqT0eN;?#99Fee̱[:ػkK2x@ $ۨwd
k'%sU<I
/UofntwPg7(rd~R] L!WU'$E; f&FFJPlr _& @fjbjm 8F^L|DՅJ#gdSl< SUU3ZJ5U6`,dX[Ȧ=ڛ{hk˘aH n}d ݽ8Rvlv3"=+bX>X~ύ&['UrF8;k4cISRR~'d§2b3P6Z:(ņo%7Yz<zj{{{JR`.-Sǖ'Be
2!Z J
"~/_J.?,ۊQud}رɓ' ̂ p\(nܸ~k=W< Bm 8.OcG
{V̉!D3K:5Weee/_
Zn]})MJԦEBdHse?|A & >ŋ
r_t e@B`J= E_;jdXRYðSH1æJݻwZZZ JA$s?Bb)$Af[0
- eYs#[^As[B D&#WBطH$R^grb.g
aVVVkMt*)7鋊7GG̈́В &8DN@ Pu^sĩ4ϳ\8b7pۋ:融 z s%狊[)Z18x7yv1''ۛBݻK+IͬQknbH
$HQ#}ht橋p.ƫo~n#<i ;ƿ [}ՈcԲ?sD^c >zĀ+\*zz܃!Kd#V,],#hAлsI+qqR 0\^^>zq=вBCxj1Qc:%8Y| ˶O*EM jS`nF3q&wN6hzl6$C8LϠDR7Կ?g*Ϝ1eakH NWT] UVkVW$_.D2I&π?$''J 'N?J]@ cZd\7//p")2'' ETTR{o㕞}lLXcv5%n[b9@ *K2!UEǯ:p|S.{TRc)V]4ߢ%֘*$Ґ7 bk~m|nĭvv izu &h:")~^ғwE==FuJ9}̢A}{}YSM ~?-_鼿kj,A乵564$cfkԹ 0իǎ 4hP( OcH k6ݼ
)A"$m hUj2y\MH'ԩPgϞ8qٳ_[Ͽϩ}JsJO7~MҲ1%$RhkԖ,beȔGvh L7 +++JYpv"8 NTttExXm q~:+ mÔBwܦ
NA'\ 4M0vbŊ{ؼC:#
~TTT<<866($>q$wFXCZ#[%1I3f8p fff\.#F(}3+)a\aczUZB6K |a--r-[Ԝ{ǵK;h-] V< 9*6RA yb 16`c&|}u`<dfk hiEcOfqE7r zI
+QieWo5 N/v1Fɚ,[L,,"UgWzSPςuprx
;WWW+///@_NRSYZR[#դjS]&?&Z8:0s^}jE<-4mB@'tU$2-T6ʤ^Q y{Ȑ!@Λ7&j}L[Q GWM- iLjی CjE}ܲb2+fPeOnG(L sgڵ'O^~}fmjgNӽf!3=#O!}z#?▢1s0F%koeVx q={,''PUUɓ'95ps:1i< ^?MI:ۣ_Y"B%
K!__J-WC#˶Nh1TdӦMg>uTͩ6<sSl+6NƟX{ K!e%fi2W? ѽᘮ
D0RD"ۃu ݹs
\St)VjcP\ETGqH$|!2@l>Mc4UX3gΘLr(WEGRz
|>cǎ&&&7o><O0??S F0[
ߖɢRlL$;լz̽ulp2EMEɵwc WH,Yr~U'ν)5QFFFwqqq!!!5 ~WrZ^$: ~?,O\sX\k7P
HC ? WRV1+:qPFi
9'9WU7gгׯ+ 8bG{B4a_zU
-:,·0ҡQTg[UaFW r"V.t1
d%Xۃ|92?e:i̸GC3 V!CI&-\l
[,aJ~oF' /4##X866#0*wd'E _;0}t *HQP*D(4UJ8*ۻgg GN< AurfRՃ/ƾ W_Q t@}njllܥK/]vOx'֞^6Y^-P{Ǐ n߾|#'N 5~}xS@ X$ eh, [M H 61w]:~疎>_r@kwBP(܌,z6 <
rz#Gqwwwvvrww4M,@,`{n&,x<T*R&L ٳgV%h tdћ%\Wr+: |{*:j{ɻI ,m{oNN 5 SL9x ;-[s3f0 3MaS3>|]N<zjЮݹsX]YZ-2{z 5"2+\۵ v%d
9>2Uˀ\> *1dd˴5RSH Yz N>}Ŋ >l2+5Ekcc ѽ{# <ӧ^?i[7/D*FX"$Ebt b'ppBiY(Q,tY
Fk=o*"00 ,e)I ѽ{w
Z/ |H6JD+<}UgONT 蓞WNck5>~LJȏneblfjjd~')ˉͮ`QGvO0<**cҤI÷>b_ѣ]k7 PlC
Rsj;z04+0\) 3vp86楮Eܭ'τfz7{(TTY%B2uQA!IVb&HDopvna-]+?]2" M$ŚwI Y=a 4
E <k` Y7/Ni`#
Jg[ss:2v8|٬.O ><2ә|V
.M1 yԽ;7͜aV m@X$/A%Uxk[+pV;x'Uri7Wiev!]] t*^JxcX* 7aJyUGyV>\M*<--- s6EAtTl l>4qXV`5LOPQH
啒"B*vjۯ G
530bDpOCj|VVQfv
_ hܚ)#V=|9³MWjg ke}[e{sAȑ#'N 6h͑w^ Y555pֻO!
RF }+6%*dLJo&-g ō< S/z]y-*)#d 8bp~HX*Ex}O͚kw 6m t kg|gʇmj!҉{C4eZeVwkFk ;4k ;;7?Nho
#.y{ryE9JBH,擩,@8|fEU&I,W bJSU"PRNtk={PSCS V
Gdh yb?eH(ALZ2ԩ<f̘g֬}1;
XB\. /-De &&x
켲K7M#CCC3' VUMEEF_R WzʕFn.9s&00kp,VCcmjbjmUR`0fQ 6 .98{0L%(|ޮc> 8FP锘9[%/7sU__˫WysΝk4;)u.* Hƾ ?;ukM[]C-WB)2nLl=ISS~8YP-uئS/3
ʺ'~YuHwv+1Qv g&Y>ۧ{ذaݻwYYW X4|Jfmcgا!;=7R 7 (ueW(_60jb#I%Z
`5ܩ_|elk]ZIJmxBᛒҷo[nѣG5N?J_5Þ Fs SSk҂`a!6.N ғ\&zj
+^~fw_n9_1o[1 gAgZa7ϰs|]|N]W]Ǐߺuk>}<yfxjȦ'W~UX?FeeeAAAnvT[jii59Y1y|V~rD>OG]iIեR7oۺr'2©G%70_{TMloaBEަW V
K2{萭ӧuv;w7٘U#]W
q(ag֙qИT_t[˕}
^EZJb&mx&@Y*0?Vߜ֡K+UdVfldd ɋᄅb>E0 5Sq'FnehѺ5;/̬9d?Lumg°&P
8Fz|^Yi4ibK}%6n{/Ο?ݟ]"x8éFel_o
Ybӝa ʨge"]eQiS
zfYձ kM ei Pgϻ3ܡɦ4}6mvt:]$EEEݸqcÆ
_^0pkHAu,MYTD I!iz4D
*y_O./5 jۺ bhS SWDQםm&
u OnÜ ፓI}~+!QB~]\\.;@H& DTTW[m uT먣nQZQg Պ(C
Yd%;i!Eq'{{}|BBBZE[Y ?yԏɥl'O(4FJGI$d" $A% zD4Cw0KV=pb'%O
xV}'0gcI#Zoܾȿ[VJ`7j9gѓ#|Cv>bi
(P
;;Fط +?UphjJӉ$8441 ׯn+ lj|5cP#
U }t2 1{ 0/v`Ap דm8 3 q=qfTw[HXzҀة'4|GSzEN2=jGE-~HfgҵAV F7!~EYuU)|=WW#WяG'" )lʽ̛gh ,H x
g=7pyuwD |d]1o7= _m3BNl̶wtsE`i q`VإF{}k6])zN_/
YTkW/eN /;& y 9i0²;~>Ixl|rƼ9 ="E8~EA4h~z=L3F x:s0 9^7( _8s~d''
}P]>y߃?U-6X ǟI%\|x7nJMjUW TxęC<Ft:nY.ZW%A?bݳG?{~=7|~5볏
N% q
?A0wb:fA
$Y$#t0tW'l2tEANɥ?ϫH<dկ?DRi40'BD[ yY2̐JBH yuFIJ xQFP|>?&&՝nu`~O۠MoKzi0(VH]9>^n0:U8 3"/y8]qo9dg;djT0ŎK%5lfa
{($_ 6 '>zAJk0ٞl :fv'5B ٸt q(?Lyq 8,F5) }?%>*+˯%gFyь+0dʕϩoomjg$<Taњ8ꪪ*DP' <͘!*43. Feii|bk@PƦ`BGL t!Ѽ\Nv Ձvg x=,..nӦMK9ikl-ގs<
N'XPZTQUh jcoޖw' +X;p Y,Nv1tl-U^;t}ÜR 䅰^1:Һh[8Z l'C9\.H$AEI·*0w k)ןöw%x|e !SL*y(\M$:<f4 u[[N5BYT^Sq sf#<1Gl&Tu0t<
DA #>ەrK8R(W !aAx)7"@5 ͉b' + |?}ĀV]1ם $-8lsR$B#yVeJZe[Zzai5<GڬBY34> S7=y2=l|2w͇drHecL}g?fta DgWjyϞWWyƠcʇ / dsN IdsoU옷/mBoH_f9lG]mpl
ylݽo\w^zke [ϞxE{\Z=щ˾ I`o' >gڹFɟػfCwkCuNGYfv?ȚE
wlS0_? f=ЪTC`-&DRhC~;8B ('ue}h 됬lȦÏf9~][ɻfJ'mIr(;/ gnN)2ֲ gi^/#
F:rcuN(^Ĉ~Xr#
F\T-t1;z-C\wj*)w3ј r%
Y*J1 cjO
- ]CG h@l
(5MAǕ
t;S9nsv@֖NNΞ /_)#08 =c?{b8>`W[.л./l?Y<;f {Ucs?5sF͊?}DX]b
7hC-)yIrp::iJ_P
Z4 ^ÂF(J%J:%
H p6E Ic~-QS
Fs nqhߺ }ł;IS t1#Z%J!UaEiWEw7o $H/6}SQn[\τ)s-[Ku1c4?{T9t2=JP6TN5r'0BpqSFpwrz.~3?2@ЄcW
Q
$.hVWGB~Y_?ox|Y<[o[#1_o:=D\}`Е$]K w؈?rε
MY'w RtҐW"tO%P: 8`P~i,
R^( Pΐ] PŌ-oPZܦH,,)*~d 3* Tt//*sY9:855Z]f՚Q /gI$R$ t$`q
/M%آ7O kV=ۚ~*Q^~\10Aw]װ:}x<QMLp:YN}ި}V +]{xr^y`=@VJ(` {bCw;}fS}m @mO7>>Y6N>-NJۋ}elA=wp J4S<k6r bno}-onrJL5OL9Aax<(Sҭ˞Ӟon/d %ұؠ: Ӝ;YgdZg'b+[3<v Huu5hKl>: ug\wܚ?߹#{7M C֊%~AE} !4ܹ͜ S>*u9: m0ߡ
ې s7ؔ^ VoP[nڷ̟XxՎ8|d&(c&L& ?.U{q9.v=vy
HϞrD :lzn-<ĹaJbuW+*n݆t8\W CR C((ʩ"iTl*[q` Q2)U&U4XHy.1?BڃxV & @з!%K+? .Z6qSډ@6\nXD:t7dŧЪa,1w+6WI7 5wCqup8/-ܰH. ܻxT++2'Uf?E[ff=A45 rq
;fN:t)i{ ?O? [ms 71P988 /d@|3Rx×'c> `T+3[ٌ ɯݷq3@
zNj '
1 6\( 6yβ1_K x,F >az݆N#2q-9<
7D6w7n`0Ifu LZ vM%xG2VlozK@H$ڢLE#ܭcҽ<Q|zC~n ̊hx5GmO[e1]
i pR
=bl,/vPF8&(plcI@u\~d`e5A7$EtB^Uvxo gql-.Mj uQ10m8ٵÂ^ Mj\j"~O)S=(bHKM2k UФ}VO,B,sO=t0
ΨX(_zTJ`klqug@ll9`@5 q, %v1{돝}qy*+[KFQT-v̑>}^Eb-! t?gQ ).Ъ&LZe%Cm9adY 1~x ?u"n<I{ط[bxUZQs
3p-Nb
赁 c+3sf٢<v.('|CDD0/ٽmJMۂ3g9jGyvڹ19[N,{.Bޠ2Ry+&Uk ה7Jj!yA| <{93;Q
KM}
zmM7''R*yAvr]*>?Uױd^Oen>G|%iY:h3v>EyDZ]/.[tJ0qssui.]*55eShU'!F
ů#Gv!a.z&ϟBת_EunJAK:t;m|<Qd]w }iT %5zE^P$;sv#q |[bwc f.rNC_OktG4 *R\*4/?
5<&L^'n~PegAP¦HeQds گ'}~ĿsGv8_D#IVRIX Ռlh;L(-UHd /.6]Ly1t?$e: heJqF; LO,{y? ˥[r ݘ&[v gMma{8l=um [,xvW>9>vʩ/FpJ{hjέ
w 3 +'r2
M-qT!Vt mOww|?/K!3y$cTI*A9^H;egLQ k=O#Jy3lkV0J.uqjLJp&vv^mņ9LZH }4}i^ ޛo ȴ|rEqUʕ>(sې=Q$Ȩ!RT
%FsJFRh}@ʊu55|= 5 }=9ű aT~ԞHd":{V' ۣr/6;C%̦d2R }}B0j~}@!@jdFvdܫ}o1j.v| 0a.UhGO,=i]<W7M'G^1< m_qt<θ/>ySi?o6FQ /ӈЄ͇GS&|z m5 Y1£/YE/Qs7[8wʶ[&6_Y^k T~v kZ[fL[2w'`hԞ~w U)$#6˶^1 Rwј 诺#$SD !1B<vvX:/ j֔z_½m\|()#ۇ ҫ[m$N/`h" b4k,
߸V<efzi:mRe@Ny5j `0@B1ak̏PMm2n6B(q" LB䣗s~~L? 0[&lOj[}26* ~>y .kƬc},SSYX
~ф DDe9, (3 ҪRQ}<. co jB_.~t jǶz"'U$)t1 9JG[[&SO.h3F aXT
AyIλ[;^gd<| !P(&>"LU5&MI:)iR+$5yy,_͑qX7Ks ^ފb8T*KDŏ% A!6LKi esG\ Á`oj L nX\{N*1
D"(/ή0yzc к݇a9_
i;n,0?E8#($@#C*a]~a6rq;BL ~)YdO0sLՉBcT=|
/Z*Eg$+JM (Oy{DW r: LbF9葼{xZ#۞cggG&_ZJ/96[ЈympO3b['XҤjcFo@cw,ZDZX1w'=S(@a\jŦ8 潭ÿiv$)㢅EƄ{O1PǨ. ]n0ɴLGYNIG|OJy=|s \xGn7_op i@_ 9wziiRDsO2/gGabW2~ v]WoZM^ha X +˧CU:r~M,}*#ө,;Lt\rgn?>VNs?r~w?l Z{'c>/O/IQ"]+_kq[irA!9\;ۂs
|<QM&NV לgW<+;y/R0鱽]ͬ =lUhkZH( 23*N\]8*L ~}&UnޯLyX%Sgm˲ZgJPaĀ ښʵejVM d"FdGwqYB@
,HH(GXWjejJeZtbQ
UzE!J
\#;&I[ $,:эeBmMqAA Á[`* 8ʹ_NB ;;-P<@\˹.mWh(H7ٙoc#6_A
-uR-`" I@ ØTZ A -Fjt 7-N ZK0f B :DCj7H25Nej\ E!a9" A6v9kp`#BK 斪 VJUJ `Lb8V ϦY,&j)fXw\Dy,:3b sy mgU -erma軬b%` ,feֿl[3D
h4#ia$b#/$Bev"-_HVB*4)icʱsLXJ 9 !.kt+W`RN*ʂruzaBϢx G ɒe'
*F,I0"H :Z<DYĔZ\ҩ49Όb- <k!d: kA<QQ&L/Oʑf*Pq6B; l#Ka$`M˗gRdyer9&Ur: -x=>CcQ#MY
AK52ƄH] F"63Z,)GV--kV|Wk z'~m2UV26<*<D F\`8K
̂]M DlG.PGM-{++WhZS>+Yh$Zr8L# 8A攨^&~_ &lo;Q3 o{62z`8^xP ^V" ҄b$7YdDB
1Oic hN>R&/KY9[x8ؚrTYUSOB0bokW"[,Ϫx] nQϦ702w
XFaD
ewew",D,_Q ! F" ]6Rh'j-ಌ\#4:"9O4 N:ZZKXa # :֛
ha.A,2zj_~T|Ev\bdG1*#> *ʫ|
E:4j#qw3Sz_J7p5^d3"PqKql1glXF2>³KM9]m:71\j:I)9Kf\F53`7Sc1PO>~}EEeN`Z255],痪ι2G Al 0_슆nf[:y V
WZֺukVaW>w03dȐ?]S"܈Ƚ4N{5qjaV".P 0NM.&F5w%K l "+X,ֶmۼ O䖪=ͼ6ڔ3Ks
"~XFRB7SFv| oݺu grX' >}]HI\Všɉ9ҎA6ߴq6#+,zwN2LqhFs3ӡh k㯨 W:
]}}I#Xu$lOާ2>6#b>)
eq9tHTT}U
11 x$K\pKC.JKl ߣ[ӳQDtLwٮu* 9
@sYÞ
^;K2;ogw VV~Q?+UMѭSj"N/P,9",o|NF"_r
Nvځe{6;9"&o+pk'{ P<ܶx)`ZO1ۅY֥?~❣;Jb){;X 6yJߖ0n|Z4ԁ )gr L+Fȴ{,>ˌƳRql4}T.,7yF8"1ovf+g)"PN}SȴQ[*50_^#BCo$" &_Q'45 #4ɤqtV? "
Po8
<z@Ow
6}ǙC sg#mZBiOL2xݝC(k IU >0%Kz xe-^]>yx>۶ij 63<')* XHY&OYDEL˹{l1l:{}Q3D<`C?
UI~L|MO<-DĞْo$wDˎ/0U?75E<],a2|g7yp %)r_nBE5*"bõԯ
7": ˤ30{y:/.*pWfй D2KWpf'(ΉX,>e\ o"z+YJ8EʤпAPL&4mQ|gTEe[UfuE|뇒Wgj+/n_25ՃBk ?)Xs~mGVȋrHĠ 9D1a ]l!fzaDr&ȹVqʞPq A8aH \SS$⪥뷺ڞfAÆ h.7 # P(ޣƬ7slmDlw쐁-!zwrT=V]u<x _VuO}i}lh~zŲKJn 6o@33 5sGnml3*ilm|WOJʑ Ńݬ_Kۮ8bAoύQ{&7 Ы5jC
K"ڢ²r ,VBtTpϭm?c$uU?lt !X
Li Nq˗/GQt
c@T?Nakw`4GW?> Uvae @=b=}˗w~:q5=<55*ς{nq|XmJ٠}<4ai= b\Ж8& s8ܓ0[*B<P14+%\[@L HM)^8RdI!J*P>^9ٚјEJIH&̌B!wp3s3h k! ":23
$kl#I+\#[9C2 ')O8:@qe ayT'%)`:E!Tʒ,)eki@ iF">L0 LĆ.`drg'8Y kkʴPG:B}H
.vfcc"&eёW^f~W~{yYzRCoR,Ī牙OͶk>ۺ2mO}*?1(hP ÃfL*ۣ̣uo$qtf^W=Z`Qtq/&
KIO_3.=S$0JWI+`{V@fNHD;ώ"BmV-Z?Ƅ0̧BnFl6=M¢M&ܚ1_t4Uomlx, _h;:=VId"EāSޔ" uz YIjLx|o1W ]Y:A1 N
5|,
E&tܡ,ep
sYlƞ c- !2݇)P;'3occwD%7E;֔Cd-oaZds\R]ٰtPi/wd@ oxO`Ŗ^܂Sgߊ[`.<o (r r
" 72{-` `;_Fw`0mґQo$H1bdϣzx"4Dv ]$2( ztrL]l^0C!Ol'@[v;tuKw-:w݁>.4% 5JPyrrJŊF8)J &i~}eG1 iLgFȟHa*
^}&4 l ^/{D
IGYtfD}:D^u<+F=
k.Eƺ5;gOݾ_7'{y^GF?Ma!Z {SQg$[ى^q):γCuav.]A j(Ҽ8«CPB\3s?{t'gGWvnygfs W`z
&\Bݖ<7>1
RƃS:p? 4ȴq_ܦ<Ȧ9gj_
l41G}·]7٭ ŷx䐂8ǩvz7o4lбy&իsVig ^f_xkv
MVH1B;)` D/-@(PH3
ӜLٚ~nQTX i?.x !Ja-0rJ
)1PQJ^Q4͇X0+!
bR< TPS=&I8SE/AlT/5[ V!LA) )f k :`)ʃlz ԐJEa`,G
XP$(B wecϕ1;o niQ~ì<v#,?@+ϟ_xE(֜ ?@02B5@A}jڌĖ-[vY"jjE# .Qnb)f "& ɢ!E(DҞ8
e?& &z@T] #N̶r4c\0Bo#Sh6n ݿ} fTq?+ @d2qevbTP %P"APe0@b@,eʏ(suc:y<=S@f8% < 6%'%uL i>Ck)\]\Xph4&%1grf5ӸV(MLOm=y*uޞАktJt":}n1$6KѩYJ. 9#㑙 7s.40 Q&-Z1*d?{
WyO/'&LcSӕcŅ&-|iVJ13!<SR VuQa)NBs:S'7KSLo%udž=a6.VL[,5!]jfcF_lDZFl n2aFVk4gJ 0 c2RVWhDf,
0J>bT
YP%>j :3˦38
| [8p#\jR)(? ?-Dh!mZaÝ:Nߐ
]0z{cx={
990~pb?UKpsO+ۛ4]quk^i70Y^ڇ?[aX-1,=<\ {W6A(}dzM{ă^|v
5b R ,aiXi@"!J0OjkČs*^\i!,xz^L
?d*o
:gD[
gX a`a <V[#|^Pt)Կ˄I} q8O1$EvzRb1B
0O^ddN¸bW}b#﮼̮95SB6$?ݲ RY{{ѝ25<pJ+ww
8ucCZNX 1n7;$z{@̺IgNz4^AUJq%<B+
(WGi%$}F*Z| vf"vKu`dE"G*أ7.JB UN5^N=xo?=*>lDۙc cg><HQ&|ˁ̱sRC'MlX-4vF
;qpSNk|de tq\3oeOX5vfW"֦ka/ -i7ojGfjľyoE{k/^Ȟ;|nڲ<˨ogw& <j )sKf}519ٿْtNq۞a :uՇ0wn'~ۈ$^ W> QNsvU=ˮ`C$)0JGiSB hx=!@=8??ȵp0J'Ҙ[qĞ,{qTAF [ZShTj}%hή1 @R
Z<U!bPO|7U,sܥ5KVq /ѵM-hϟƗ>tc4=yfN"Pt|xvyӺi0xΈI [sQȔnmLf1kӜ"|5WǮf! i`!y4oعeє1 PbNft-N 46g,Z5me*ZG_,5ďO իߥ*VT !YEa nfod*26[o"w t\Ai)ܤix0zRQȲHdz֣.Tn}|si {4T:HR%(5:~HH#ԫoǠJAk!xȦc!LFt4e AޞRJt.6T!'2>F pdC X_y$\M)0Xx909O lGPҤB0&r$B[Qp -O^{QҨ =iޤ}P P$x$A!Л#0 T#p oDŽ49eY
9!K" K 4 bq!e1zM&oɾ!5A!?Nh|ܚSQlG7wp- | ߱.U gNML8˵VZ7z0AryNRxB瘬0u.ߠ@a|r 6@̈lS g2!YLN,1q3,Ny P('8~6BR. 'ibӆME 1E(q K.Ȓ"RbFIyaAV))a 0%{ /X2ɯ50j U l['[SLaىٸъ@hEJlW(eTZoج^~ZFF^4gȫwuEM ~iۘr 儤\wcCaQwt*=s.֍"NM|DxY]EZJƅRіP;O`6D`QiErJC, !@!B*P " JsX PW$s vu5jJ
uMR@|^;v5kX.}N7v@P%TkgW\ ~mi`hTANAr'KS D.DA%6w:1-wks6B%t~V
Z T0x0jJևRDSj3 -[01J`) Y(
qcrJSh!<|L@ZQd9oßW"fֶ]^naܵ4%ʀQ;ga"ZRl+kMV`cQRksusK+s>_ aTRfweaM=G˕ Xw縹ɔCWӔZ" Ҩ ZuzI_?kL?i8 ). _M dư2 4h ba::ڞ A@:}WX%dW쿑8 Ψ긍ˤ
o{Q#_&@4 2~AúunNbF `nA~X iװ Dtȴ'3v ӵ mv'?no/̡?cswr?֭}6
ޘ339wȖb;np@N/1YÀLMM]Trya,FM"ZG~*,#837DmL5WX,ύ@V. LQ0{T`&hFWwB,ki+oOK4kL?X1 u}ֆv c87kY3^l+(w;ȪE˩5[ᨲ o~ k,;"a9[ ֵ֎sѢMvѵlFxXw4vlYhOVM9X KJ"I-8!Q,fYAu[e)VwHD67 sbҡ%YݻG45þBBm=Ү!+H!Y9-F; %A9(! p-A6~ʂ>?ٶatRۨQ LY 8ka;<=` U+cHcbk[6UeY+D:Y5@V|S+V"0La(Cl6utQ{9;h=qڋ")Ρ;!--{xҷ%D'V,:w},i;!LHNA u̜d۟;Omh
"
I9DF` DG+ٰ͐KVl7,pN Lx96Y,fbB<d&'/$~M| (-bY-rQ[81nz>4 T9ՁZpܾ6t3";t
taFXQa1E
J" qiޛ Y(hLzװ{a}eexy5Ƀ/> Co(ø1NߦH+BV~ᓡ[qJ^}Y<+ZЕs ׀=J@2(w^ ,+?_fɇPqC<SS:| е:Q2]JjM`QA= K5Z5.:foS7!FVfl#f̄J"ޤJq ȢԤrTl gge%#TݳP0%Ѐ~Ha anirsƜonice˵lkېtb(آyCW&bvA+dy9q?SD BBg4dOo<seV&l>^o)U020)]SoIu&`&I1 ;? rk EYY*ވ3o|, CxEA̛w2ħBda@ 6ɳ\#q
pe~*;-%q3Ә\ ]|V>N{6hf/BX1q+rJTsۧY bNmnN^l@S!߂$m~^{ctp_9W\=e=[TiWxxGΞ=['
`!WM5wtîDE|o_G=M
kD|a!☌ucu;u C+KB^3A/Q׆0)`LiQ fogb,\Q#3WjB{n0~X"$$dͫիKKKnZ
a{HBmj p834diNAW eX_WbAC:8fFYnqQ) NAUΌ N!Dg-|
N틀<&ciaajbbp@ -H)
t6pw
:4,,ik֬Yi@\\h'*jӦM-AQQf) ,ߴq=- *{X=P ƩjWPe@
['حn+X Wgwb,Bsj: Dt)]ȗk f#[[u 4>K
ѻiLQse$%%uرCK.c؍7 رʪkW[[3!yeɖbN[džG:Z
0h4_gςbYtEyw1?3
ظ3!-qaMz,580w~<omh 3ͱ1EG68T jNqqfޜ[!OE3 t%'^k"ݘB2<^Z}Qxxe2و#Ξ=m۶/V^ Na6mYŊU'UZ|v? KO. JRNB&&*o
)2-7?Գ-R o[Sp(5}iN Os'g N.$=# $ܷ嘎GPb7yA~¹c xB
+((I3UqF Oٰ͖%9j̸}G$0UtM T(te֢5C141_{y".Ќ ?bӘFf8 @JZjgϞۏ7gΜ9P(ѣGA]jQ.&7|aQ$. '~a4HyctmmjTGf6~=i+߶ɂ<g/ZhEľ:/{'Ȑ)9#Ϝ;~[{Ox}{Hu~k`Vr==vӄgֳ-2HmWB=K|w3. $2Uϼ' !".Pg)n 5@~⛫:@ߒl/幧{5Rmƍ&&&cƌ5܀&MݻO>yy߄z_X9F>W" I`0;7
q)
Gq
%)=CܭU|QD5TH&2)!aa :N96 ժ2D xWPi1sG LF<fU Q (KKs318֨>a+93W!n%
x GdaDZbksM*iUP2rb`ÙPOw|ܹ߷*tpp/^\^^.pW&hB?jB ٴLFȪY|kĔ$9"?\;xB,f{eާ @lCW5?4(k ˦Uߙm!@ B ޒ){irO,|}lAvm߬66Ϲ봖}iVdpFȊcw]9_*dP\>k Y+̳doʡsJ. ޡ\E"cZKPg λA贺4ōgblH0~ YkrwʉٿPՀO>
JjѢ FY;&&V-i>\3 N,Ѕ'\OLZMG .UroRJwL 56/\7TR b~gggZ{*
>kC[;"~!IRT'$g>B!od 1 @T>(Re%9v̂&&v&&`ͺx(m m\*P ܍5,
i7n\dɬYjϑNjD{A-1"[\ZQgF$UCP p+r@3ѭ}g!dq\"H$bٵ<<-cC\jt".2cʼnȜա͘eڵ ٺu
9w]Ȯ4u#\m6 (;PFSSSX !P I֠ #ofY4sÈޔrWe:Cɇ=ͽDucָ"fHfBdbdϊRvMm;wy3ѣd=}דOlfYjܣ){(Jal ȴy]-O"f"e?'N<L;|'e͈!6J/^ 6lXpppDD̙3% JީMmI)Scb@8=N5t3_ ".͠e)-3yBQw
+Էt# :uɩփطo_~~~XX`ג_BQ_ GwyqYzy[ƔSX6jٻ' =?y;dȐK.ݻw/4T V'O|'OԪB`i=`Zv-(ҥKk[FGUd>T(u'M)DR֔46O1͔,Hym"Kk|7+;鲅 xΝ;eeeCMII9ydƍ 8PJDA6t ճgOP۶moj+$l&ؤ]ג$6u5]Mw^KH exSpt$" cF7&Ms7(jnn~mpÀjOqNVGZVӧOEEEW~:8~MPPT*ӹs-5ARj
eqUqmf6ӥy"63$dK5_IpcRUWtGץK ;vc7lfG Y KU.ot7a5LKK?<y h33f͚]r0,S elUԲג
qWDbc3+6s06O?ɘv ƈYf]vo߾h SK'7?˴6o`U=%.\ݻ;;W^YZZQRRR^^^]@<1[
n.4Btжu,"/F82Tƶ*[1ڎ ryV%ѣ~-[ƦֲT=RM~[0L4x%UV5n866V"xzz+S tG\,=ˢ~Z=l|f;T|W hUμN$˗r_|,Yyǎ zjsʵ14pH kkǏ-Zd7ni4ڶ`\(fDC m3!sZzDxގ<~GLF
z7sX721_DFF\TTtҥmۆ&''#}Z e< SVXfg̘P(*πJxEVb[Pj,'{<4ÃMj<%_.U錍 ~T
9@EV GEE=<)) @#*ԁ!-[a'NVΝ;ϟqFPk :
1 ֞VUԧZ-n%g*ŝe {rӏJ
YfWZZ,ˁ={Y])~L[Թx555=r8PTÆ
\dRɒaҴ:ћN早M94HÌ@-FEyzZuիWHHHDDĴi ݴiSBBÇ Rkt_C<yOy ;[[[i\<)/Uj! _~ed!Sa#ŚA/knm!bP@?/Eoh?AU| ܁ >|ĉB(└ӧOɅFRl ^pTEFݟ<yRK=瀖N|Kɹ[~yr/#V"T5b˓.!6zϽkl ymgbpla^wӧX,n߾mbbҮ];`zPjp1~$!Ctuv0/@U ޯÂ~E2!aFĝw\߯Z6᭒
*TF5D/ƥ*7S*"66 -[pAm>
lذ`̘1cĉmڴiҤ ǎ %1 Eo^fe/?KK.
} udtZqD:5h"b?m@+=qdjٺ16p1ޢJD c啔lLЯ_ [[ۭ[+TILF` @iL^V(4Z8\\Pes #j ;snk3O2*"bOSX|G1ʀOٳYf*t8Q>gU}AիK.;w =zWZ*
aAj s^:Il -\ HîH$ i9 #l-x(IPqeR~w_xqtC @KD$?fx+!E Leee[i9/^4lh_`A =AU<)+<}{O_^^>x_p[n'Ο??u QZ$M~_"28Y- v(Ti*&?4+9F] \%VI[.:[aifB>a, Ƅl5Qcy(i?Vf<rP(6xXy%J2pѢE ;v$
V e2eCJ@ 2ŋ'Mm66305@" m,mM\Y}FC!(QdZ;8XIl_xve\UeOQY;ݺ<ŃBɱo:{SiޕHm=7+b̂2ufrL>婩z2>}:K,\ܧO[nFr8**Ν; mzP@
eWeݻϞ=۲eKFbz* }y$U[)4uY$_G,AN\>3+Й@u<y^Fr.G7 O'* -nɍ[[pCsJO4m~AkέWƳ1ߗuí ^6Pkx O Qn
0`ǎ ᧟~ڵ%_AJOw}s ? =ںu똘WJ$mذ T 2U쫴K_?6E>[tltZ BR_E${`3[CZ6i hem[{vO ^N-}`vPN
3W]oY "z0 2Y#ei } %c~VjFׄɓ-99{ VҞ<yB$ŋF0lƍ.\ wѵg[ōcS
3{0`@Zpa۶m <m4@NNN_fLq"78%6Hmmoaegq@D HJgp,+f(J'O goKiѓjY>'8yd\}~4K1lorb^etazutOĐ~ ȴ-cB>= W\C- V ~v}]pUn"X9kQ ]6 JJJVZ}v///0,+Vƞ9sXy<5>/3:YXQ TݭmEP /Dt_K;W :ړ< _{nN 1qNj:/L|F/J\\\<eʔٳ ©_ڙqtݻw'N~V @svǭ&Mx_SQ)1{j(,.Aj aWRpZRK@`+wC JДJm]M\,l9~| WA &vl+jT;NTt/ zʦIsQ 9}fٳ< oȑ˖-h9`꺁ܲؼܴrQ"21 ldCL~=SI3*5GަC J~7i o?asnض5;rsRzQ!صnWxCIiQmCMhAP 49x E3δlڈѾ;<CA(& 8|oEissLۿtCBt]-E$df(gi| g=)0Fs=9s캚6Cdk`0~mof5ӂf&Lpp0{3f̛7OTs'((iӦJ:=Q/{)s29㕂=4rU{4`?<rRpC}q57,4;Xܟf`?,P2 t~,fL_{ևEBs`Ց-Ͼ|/z5<5;6, WN9A߮4e{tڼsj7 Q~F! ~;W4GKsCl`w 4eK~9ri^ǵ釶LO767×R2XK6wx>nP DZ< kBSAy^vzanĞkehsPye
mZyBb
5
l8%oGY# L9kĎ+YZ_PQuu{89f
,߬촂BHoZEŤ Q6''g]b87WhС;tP^wǾ̐jMkSPҠy<ЌZ_v$ -08-큜 k`RtU,d4tXL]q'|_M#C-R.KXybCiG3S;Ϳ|A8iJZ7tw Ru_gx3 :_t;i } K[GML]4VY^&S Y SIK+P
Jbw {МBg=M7sMv|ZqfG7f-o~ wgCJ7&I@ G7kQBMF=+)j
*NCtbV!f{1o\"b:,7sk`j|T&;;Ʀ2Ç
N9s&===88J
*sSD&7+if ZЄ'4qa`*]< ǜ<%V/˚2g4R(ݻٳ/_fX :t<y3r93L_Vbm`cf-B.}@Ax&ڪ8bWM05ԛ'UCCL+&n_"j0w U\ *$QRIaU h!EwL4;փ6!uVZj\Ô 4YAQ7 J= Qʤ)&IhBzlִCߎ6t6bNyZ BV^|`5# 5ԫЖTFfIgД2MAvIVf:j!1g0dL\߉ʄ=ϒ#om^paʔ)}gΝ[ Yti x7o111嗀/TOҦ%BWbkK`~4*m(1/ (RQ^ 2c9y뗴"u9KB7mKީ03 ::_766?|0xǎ _h4wp337drPqIo| ".aӫ%ȥl[eo;5^ޥX1>NЈjN!mՀGɇtkL>/X&AL3 `[!)vnbPJc?s+ te{7oe,`p<2ȅ8,Vcx`MWun5SG7k=ϥ}<ݦ;A e¸
K^<FǰkZYE/4 ԣ G J#H4";#8)҉ئ"_g߉s\eYZP{&.?~
V:vسgv {DodItO6eae"{OY"""2AeȞ*C@ SVY-tIW]%߉Xyzܽy{m۶ 5j ;ִi^ze0իjժbp ٥9ˋm*,$"X 撄yDyVXĒ]l2XԑDL*_r}JϚ洽{p[l
#$ED t:Vf̆2^g!RB"S Ҽ\j) @, y @LKd X!t#GrJ:y$v9]VXMڵ?裊-W/qyULP at]3?A0 YCV }0czCoq/Ր_9|A 6
d֗E Ѩ4rG3_+i/әs f _K T <zl6pU#> #l:2qԩX,~C\~
],'Cuăy5JZ1=J2Af6L_'âHHjʃѩ.?Yq 2ʀ+2fy̠0\ 0gʝV%(b,hK|+@$yB>h/ K9{=w|JJ ӊˊr4$\{~lĠeb٦D&}#K֛] &Laʕ+bX Yf< ̙3t7b8 +eŰ Ԡs BVBpP +іH@ B^>hm@@ (Lv=[Um˾{PCT`opx턀٠tetƂl ʀ".?ˉ% 5E٧O wqqq]v7o eZ:pӆ`<A~˲`җX,:/J*+B9|!ȗ: "4KRyu2)%JVPHop I @ Hwrw 8hpt; ]bID(e* "< @hq<A 4AS Il"w.C8\:KN]NmAYIaT͋ F`c:wk g ]`0̘1pW, Y1V2b=*ʕR`tC{Q
~BjР`H"|#Xg Q{ gnٹz\]erʲJ
`:</x&MwϪp吖ndޤ3-˾(=y$nЙ1dȷ ş~ܽҥ?
>?~䓇-Y@8)i@~|Bno3{y_;:V2g|;]s
j2O>=dU{tLcN˭:ݩF%*6o뮳9)yb|8\ T ?~K. c}`E]p oذ+ dŏ2b-fZ␓+j@#Hs%pPӚe`B: jɫ]֡~tБ>(sީX`Bp9JQΠB#Ub)?&>6"8?:lFC0!qdV FF}O-6;C M ;8na ҳXOg 3xif߽{DE¥ւ}v,$ez4qwmYZ^ϛE,|)n4 _r <k gO3"^Yis33?\j
*]e.^M:ڬsf6ڭC\R{1_P Dq eĠ& y#(#k#,@.3rKm?^)H6Xݛj5w?Lݸqcɒ%ϟ2eJN xqϞ=wڵjժC\2R}Pxt0el̰Z.]e H(A+D!`8! BW<h ҃9atԐb
B * R>$ -s?$/S|4mqB][7GDܽ|uj0i}|?MaJfuY{fcqX4/ j4`\) |y14
CAK{tzw-̈=S18u߽.; nZ1mzjsn}/;^cP#Ny[ݺ`DZFAt6ؓp2X Mg, L^U`Bz<$jI0N"0\(N`APW/JR;B2oP
~hNk8qŋ@z۵kׯ_4St:Š ?٬-oк0#C*R+ Plx]Vb()-rxE*D+ cyQ| Ti +/l&vp0 +ss qBE0*\1 ꡗYJbN(
*+S ܍\I矚gd[.')zqe3[p O; yN7D"$!Pfri7
~ɂu2PʐcL `"A;p9 RIY4v gߪt8o"^N|#ގ1Z}8su+]^nuA2t&>s&Akھ>!sC eac( b:QCU AE[nr
h
lrM}RhJO h?^?1#Mg1tR0$ [ͥ,Z(ْhQA~$- ?v/ W +M$&$ h /0.=*(BC>Gx z6'Z?7|Vte6
fyG_ 5mUq['BcqK`3䠱-M|4A#z
p#G7mlF}NqaQ-)xPXF(LIlZ8lAHF0_6.%~Ú[N ?va73!6]٨7;zap6H.܇!,+ޙE}8{ ((8 nm^YaAͥ!ı |\0p 0
*#e˖ҥK"EV6TF b?FŸ0 DG~2lUoҋuO#zh-=U^j6iqV)50D'W 9 U(<p z0@-Tk,+*bb^@?յ1? UV\KC,[zj-84:4T)?6$+ .#l ^&1z78@Re늋HMS NbyLG\j/1&DU߭ k)bf<.]"eJ* 嗗['ϧzSoˉ
ʴEv')Az NDpjid! ᣮk\uD *('R~K\lf)v
C!a ,DQ%\DeLKzˊEZ28AjQ >/
d( .xa˘ߕLLr d :!6^C,N㶍jQ˦^ǝ3~nԮE*І ~4 (CȲ\fHj-41 }Q/S M[qaIIYjZLDTZ_SJ#4quڼ_ԛFБm!ԅsZYz/8vc �@\m),,p6E|JEP~4u; AZSB^Q9)ㄘ((QPomp ]5ȫWo!
%Nջgsԃ;;Z,. @3z19+b(a7W
r\($ߣZzSNg0EX% թ-08BUIW @z6mAַ)?]h`@ܲ1 5m8c["UUǫ?FZf/<1بD.SUR&!Yrd/Օt EBS\![ZdŁR!M` # =ckg(O !O.+dGFG 4syJuee:;( O^W46`pB^"" 0#|2p);b(:1WpP$BU} !-ilPM'HDֺ8 #OF>Ȳs~{:}汳
B M%
P= 222 80h RY-r2騇Z옄cp$Q6Zu ^o}sp"f ð DGGO:`@ XpakooEăE"ǼSfK h/Ϧ #Zp`0֬Y 7fŒxU52[I;sxK3! <W<[{o&5*%l!>o`a3tխ),X ߰aC
̙3g.\hѢ | >С^_lٳp#p'6!༖_3IXY`T+ ؈_4425U'Ftnеkׂׯscǎ͛7F?DrE ΝԩSF:w\Ǯ-eea6ۋ__N7\W$VBK!2J^Er/* #~YBz[M䔔aÆ믯P( >|x۶mׯ_߃O.\
4h .IOO9<4Ay"Hp0
U:C
0 7Μ$&` qUYMS;!TXŧ ܱcGӦM 4h۷( oyyJ6F%z'恠&M[tǿ٭;'Oxi*˅( |E } 8o<m۶9s@>@Yf-Z7#I(X! wT΄8LCK@N a"Wsk$P 6\:dw@ !4eBu ;9y ҮA ?[Vmv; #&x)RfvSҳyu1Jl!H <x?XF
@
oٲʕ+k$zV H/6: !O`m(]wxkSzo8ae@ M&b0 :
! 107DI>80FD@utHA0j/:بߩRҨۂL:uyiPɦ Z|y$eltkPx _TK'~[<!h(ug6Y܀ *,?.fБq*3gjڥK"֥K08Aiǽk}q떵#_<qԉ{ wM0Q*И1b@!Tpٔn A];x /mRG
y7n\97 (/(ƥ is
Ie{h/p˚φw^yjAS>KWJS/>F,xW Rpͯ.CJ>xbƠAKBiu5 LU[ |ްª
7==}Сnڴ_nOY,W_}U_gqEv ZUw-0,
6z)2Q x,:tTȡ(rSb>)(Lfq#
ir聕{I
Cʊ0z_ag Ο;]B~-d}^;!t/ըá!'
7=oxH@X\! ܤ7]J8VuP\:#dPdG,ݹy|HVJ` 6 q'
U EQT.GDD =z۶m&iѢE_|{_n0VP_hN/0 EX.b`M %hMe, qcӉ̭G Q6'㪗0 )84>i? V̸ u;6op`oFH@%?4vFl ㈘;;Up{);aUZy<&\LC@P| &QasDJ#wUJhnT;Ȧzn0.yt(ᝂcO쫊VyjoN嵫@n
ǎ:4nL/eN7%JkE˝\~3E[5ŋl6;&&f;vXbF5kӧSSS'NoN'ؖ?{̮cTFbU,
t~; ;4^E*d't F ȍ0ƀXˠ7pt0C.܍ : &$I:m*#t i0)6[x" SqD ^p=L0h `qp<:I`|O Qr!Dz$x`&O"piƩ&e`yl"
{8Y̙3dϞ=+W,((7nٳg,X0s}tֳwڝ`nFԲOm^Л NviS`*|D 3X~+?# . DĜ`g8?]nCDV6 `\.> bӘ`\/lA*eU d{(x{< RIff&K40ټvwyСCR۹%?]+9Q*/<I!Ƈ2?BDjr@eeHoD}Z?Tzh46,)))$$dҤI9` .LIIiӦM~~L&ۼy3n^6uk9̗@`ȹ}s XB fl&% e8r K0wyLUP8 qөU?bxRJ*>JNNtԩS N6mΝrlRk>SC_ RvMo4l6Iċ (Y]ugݝkjha2|G"D" qՑY[/(>Վ;xwo@ $I7<1r_(H_%/i(RjrQFIAb'0/y?_:Aᬬ~]|wy2;{n6o\\\P(Չ Tlv3SM^O^np ρ` H7 xpäW.<qĔ'No }vX|̙uO
?ĶËij)Ft62?A'rbD@*N\rY#"Xs:ܹd+V(((h֬'|2apd:vX = ,e{Em"{4 cfgzP Xl^-:7
]{RTh#!\bzi:W- ٨2lNJJ733b3F&Pt( HԧO {3]g2"EF'Ǣ2+yev
X\2X
q@[6^g1/F6
UxG~IEDrrr~
?j;y&yb{o& %P<=[@8 4Z5W/bϞ=Ǐ 2dȓNjϟm'N
-*5uϦԫfZl;\I55@k8 ",w7BΟֻB̮ljU*Չ'F hѢ܋/͝;Iϳ!;do9ac߈CҜ{vB515(08 +5XLJ/yC:D7wرaÆ;w*
sCG `GͮnX4!8[?'17M`"$C %IN/җ$
n\PE$b !ȫ?)r'r MgQ.&1dBvpQD U0ܹs YfiiiCX,]zѣgΜϟ2e
W1ږOS;HWvQ2AŪ2%I⯫5#({ui+5h WqyPd^4n} U1Z828oٲٳ[HVVwݻw/F2[o[#8)-˼5إrqD'`ULϖWe]0 -E&ȣj! :bwy{%lh[#Uh4?^R%%%1B&-\099Y՞>}:((QmfɌ>b1,(3PFTep@(!Ix7fךfW7T1@jJt;R®O[PP0`[\sNgJJʡCtҡC6mT*hԨ盦n^'R<O?xpO¼eN'$RL% #(NGGe tg 9w1yD)W9-͖{&oAO^K~!8FsA
' +]0^oݭ[֭[7z@z,w<m5X2ڬYcOL&S}p]viٲeBB7N ~`!+0 h3ouvTJ2 U;Ʊ߲#t7o!7 &yOfvI_bCNzp7{}(F`vSAP:AT'a5{Nc2nwS6 H"PAݾP/K DueH. EEE 7|ի{y1d+TSY)I_ 8/ [ cƌXW:uΩ[mZ Rf՟ t.X'Y uYl |I !,i^CG~2IFf 7k7o\VgYf~60DuGmzmtjmKh7ao+P!5(AQ$,Fٴ}jAoﾵoGL/%իA hr=z9rwd^WIf /l۶m߾}|>yӧO߸q :vbŊM2)\mYSqrA A 2l&L &WCC5X'AQ z0J/IB $e͠ NPN n)nݚ :xIMgn̊W3QC/!ti(ifLtw=k;]b^ .FR4R-1'\a- I|}
ܹHffɓ >LE"QyyҥK/^|Eolݺま}))))5k{/Xf
8! UAcW]ցZ{% xƌ˖-&z,o9<$ 負w` 9y+aRW2 }Fja& "bUBN`<~!`gC}4yx<ě}kr 4!pq<8qkBϟއk t^l:s̔s}f&\) m-"=.֯C|qtr8/2%ٮrYC| FhW(}{Zj߾aÚ7o~ΝF5l@ܹs#GۀDO:O?*_s^ X.+t96U{iн|MLbR)@ꖚ]cS. %>O18,(6@$U{!dlsY< a 4ʈ~0B<^N鰀3aS
fqe@Ǡ%)C2N40r1Dzy \#L$]A'OOO7oܦM'O%`qTT㳳'߳gO@b1` @Q6//@+! J- MC. DZZZƍSSSAL!''oȨW ~!_~%I` ^@¡Iu"^M]me!t& SP& DPchi|]
xV .9 ~hժU߾}/^ּe˖m>رc@;#nsjw +2ݙ5+Oخ^߾}{
@f̘1o={ %kС`j
G~ 2wGjAcո,zX^ln9PظU-6兼 \Vh4Au}{äϝ5ٱG s 8ǫl39LZf2ScXBTz4&?#À ^NM6Mo+))xdɒΝ;C>REk _(S/_3D/_Wֆ fxpv˖-EَMX{~tkTs p̧o؛>\ɕJ&ZHK0B!Q{qYnOaNIa~^&T2Z%|՝e ZSw F+Vfq-nqb_#j!R nh4t%22rʕӧ]T**`^yvh⛉Q'MtUQ䧑r5Wn Z>_L&TVp` _V:%l(P@qUDP:uh`v V눍7 x]ЙC? wوۂ{FT$%)9ʘ 6 I@ Q ྲ R!/ܤCn#
|! _d2i!?~`BKΒ]l:=5Du"ĉQ*y2d믿v*{/9{ۇ-ٯB;w) tg P1.
nv0( O[%ٖFy\.Zb1,͒KC4j W
ֱsOZlaw.lr6ܳ fnVO6߸U:(6\.NnV+ň1cm61~;5P _3|e]G4y}i"fԖTӗ^O#/nu=J0Y B D"!'ZeXt:
̽<ӥe7 3/AH˚rٟy>xj6 z5?Uxes:F( O"cCGl @˭lc I1(tBPPaenl5nO&R*ԡQJ6IQp$aSV^=qLMn9n^IVn>1y.o0nIG
dAD֯Sc?1St \9|!-l5xٜ̐Ey9mw-x{Aʾm3 ZC` 'rKEZ앪&)ϯh/f0 y+UF!kGɎ =r~ϦV͎I*:t?RUP4yu6M;7TWC.//@8` !!?e Y
.;N@69TˈyP"D2bc,F
g*x,s c7mcPLxWh0M8)
$4#ߟ'!5<pu-nˀIN _^S~n\]2
[ ,ho/x!".k`z{_;4N/0oW]2!V캳Mmtr\5d@k;@Ο??77?^|| 'j*2|(T*2eİ;vb6[)/pA.TDb e%̖TA҂_7,k?9ֵsHݴydErXy}blY1b!ܻeG72M:_|psI=&J&jf5\ i# "qQ7B6g~LAI,h(͏ +$Ϝտ홵湻% WY➲*A]URgN}nSU[ ƍmv]#_?dg|s0FZydnd4uVd""\WDAW9 kӲbF tPF(E< B[PVY\ WUBiZ܅R Ѭ@2Jp(4#ԭ~QzkIIIoҤ `vG ݻu /x/4zsz>O0 lVdЛs,+(eAR RʮL> G6 &[ v"@( |rķ$W{Iow-Oڡb zpPnYquB:ʚ&.*S[I wJRW.)))..SNZZZbbӧ
ҥK1߀ 9r0$$po~z VZoĐd/_5Q+~
^GWB.k~vpv0O7DM #x8<oYzuDV+) /<>wl:^a$Eқu| jaB@T"l,( V
wKV ;w~W^|>_*^ܾ}E
<e˖ݺuR^5Q9% BT\{b Ul5Mwm&-E2J*g^7d]ƕP0J!?Aj̈́I脐H
ǞWH0R^։ry+7?FckU*k(19mޯUd5?u˅W!T v{ND"GNxmLr\F @XPK~ -evƥJL{Ra6X
g)q<R! yWh{5dkJd|hHjAA Vg*녪^12b ICr`Qj~V:U&'';i$@ x糲 ; x?'fnfcM:
?6b . ({< ६ -f9?
\za8$D .~̒ĶS =߿Ќ tNo
ypԂ2D)q5cb
o}),Fb(jE }NVV@ FXAͮ@LG!QlpV(23H_p} G Æ
۰aC FSdh`p"ݖF @ (?ĠĆy0q9C*w9ę<uz|wi`J l/Y;_q}oAVB BJBz
C 1$Re"B幀{,QCSSUُE
ُW
6W]odB>
FZjڵ;t Fzٿ>g _Ɍ-7 T-6 >p8AAA=7y)Y Xq;fMu b9 aAφU?P͇R{C
,F[ڵB3
aD$Hd
kģ 8VYka1JLI^(/Ȳj8 IEH-We n(O9x?^%TH 9
}[V˗/D
֑r股I O8!AqNǿ2 Q1\˞q+|y,QOg*{P겑:,8":2<U
?$HLzd \ ڬB!Uaa\[qr \Ě)Bi'wo;[v1> ݹ֠gJ>lم& w^j@mJJJsss[n x1fa93~ovP@2Nm=k 8-_Ųg.^UP
Yr6._v5M? _OV7-z7Uz*N|[aИtp /Fg$y P$xS]+*h!+ əūm<domsV0y\u ,EE۳Ϯٲ_g ~o%d;ZQpx{$Dװد62ew}wԩ ;^pӰۻkm>M.6<]cb6ۧ5 =t9 &m'u<xyJ%-{cj4y`ٱ#%LSZF
0Ͽ .:MmOs7,sdfA jw{a|RّQp%rNbMJR
OEM:|~ު^0l扱n wq} Ux
m[ΙzTn,ܻٸ|NlP#㺖@Pv9zl uXW0*+ {ԩSݺu<0 n-\ýEԏ
`bK}1Vf&"|!D!^SؽJ#3h@'АEo8k Y~) ,<&MZuI)y/v&~Rnv8W9?rxE=9X{, >ݮhzU:N]/ahZG5_=i߅8թV";{;?=AB^Ko}6uؠv 'V ^ѓNZ5teh{WlwzƩKVi@^MBLy:/~Lى?x K0PEk4 pWq~'9M{6 ?]-n
A}7/گq[cy\j%L8c]?7cIBBy "f~^F)I 1
uvR I>Z=
L \;z.Sl^f̘/F[fMf͎ ;kT,pĉO+CNZw"GwH 4+J$ZіN$j~=XdsJr psᖔl}ȸ
=o[`;ԻM{.&.Ws:]쨵~C]s թ ܰaN <zMΛ:dӭr/ FE|^W_mQa ?UnWҼP/)~qEEϬzo|վO_k`u^I!nA%x%w6맽gVOmq8I[|2LwanՑ j5몾sw&<^_Ifl4SHZ# ݸ RN[\hLo;N
}dNJxIVԼb:FG4o+V mР3''G |+ƍGϟ{CW
V HgNI tVdY>ڳi +Et VYUslF. jJ`M 4Ėo}gw MLڴ<H23!msRu~ގ_I{ŇG8|^z}fՖA.B&
qf+K(q0f=$ܦr2v[zo1h`rr㢦
KVi8bJ_b{!ɢ!vC8pnsYT
QF<趬/
.́JC^z
uEZ$
"tCߚ=qt?=1jQOq1GLi? Gr\i7FEī!U(rQA$Cw,ȰfZLV)Eϣu:ݙ3gׯ ?k֬iӦ3//ԩS;wܿ?bT
0Gg tӎ4gȃ"GՏZnߩ0 Sa)<ATlx2j̦T 8jJ P_f1S$ v N| 't۶궹
'%?{^o8\ 3k% iH
FQ*2LZa8˃z۵7RDܯ瘦} ~%uFx-x1Mf}<!|M]~}7+<WPcMzWTwmcl{N9) Q{SxgH_STfԢ\,8# jD|?=ɤ<IEsȒ UCj97"e?s3ͫ$T܊߶my睑#Gx< 8^z3fhٲaHh5pXRu4b_*7C6*rXn)w@nvHE(:;Jg`*=t&؇Pa70Xva A}Vռ0Jg Ah :Bd2`*k a ΄\ ~d1t 0i4 EP\oэIy0KU _RI!+JϤ!Ηxjj=Ԗa%() PH8\}J_}P>gg' fίZ+,*\mS-)Ӌ F _/T W>͛7;w.!LCݹsgIII Ȣa
\qSl [?dSJ@uc!\R l^ <* ȵyEZ |@S!_2>]Mm?9Kp' V( U^:,,Y Sh5?[=]vX,G }RohpfxZZ~ +R V7@-{4T5|?G0<GV;ePBP g\,+6ME(- %|@䣽ǥ>Nz1+u<+m(uӯK J$TUZaC?,yhd"vȿ- z@ xK +=(4еq( DmV:I#Mfek6-ő*IWge(Q-)Yʒ( vBFcY^/ s~ٲэ"{(L)ՑdL wM^NC", o[Njyd4 :<(x76;] :J+p: R/!I#ST؊_jawrDF#\VRY1xR+$LCbZr{Ԋ ]Y^OVd[Eȃp%C1ȗh `Ғ2mQ]!<HUz[){ᴍ@P7$ *=f¥2&Zd1 iѹ=ǎ+ZݸmRg(d| jt_yڋ TP" k >IP (I2l$$ : "<n RL"p ăOhC κM9AL. 1tċ1Τ#Fh 7æ]6v!, P(&!o1.\2z _m,ۿ:q%\!f#nTqW3OО[ h8^Jm |1/maĴj@~ߥo4I>Y62ɇRz}ik7 ^{Έa->+Fyݮ,RTe_7MOLE:EKS bЏ| G
ODHo&58 VT?:]]e e~ל| eŪE~:ouԱw/# .D5o ߛ"- & *`i_
Ysv #[Gd_6l)gFd8k(y+K/eo
MlrN.' !)0^Xz⧍G]3jov7<`qb}bU L˧0Zu9ǎ aY:7dzu/kӮ/q \.=^cq/CR@SP~=AhJIaZa+:_sg>ٞ*Л'ާ'~߹xpUx]f\}Ctr_BOB lqr!hK,} >c+ t pfd͖eieN#(ԡJQĨ #ߛau "
kYz_ =jzG~o_z:1Q aax)n/iժE]UILqr:Nyﰤ4 1,zZ} wB!k0Vݮ] HҾFd=| 3w
`_{EMOHh$ HN<D(ʡX
'(( Bl;;.D@B iv{_,K V0 bJ5( %_ ߷C
t]'y)7=AV친x?F@]%8bwFV2A˨,fF(?RlhJIni t[ " yG7 O(" ~xDvϐWyhV#<Fd PO_}a3>
(ph?ĥޓێTM ǯ#v})`r !9f{`q%:LvÙpp#6jWME+Wk=QkooK4A&ƅӬ4s "pn4E]<# 2p]<y4- F`=;9rcw8gGcdOr<ȳA:hOv ?c;o㷕:-
]hB6eSm)(_>uX`<1 ͻ3u~n@g{ڭiCfe6:Ӏ.^::Ec
Ѕye, U\bhzv U;w:m% 6)I ,
XDLH>CP3bv%;ǎA%/}H:zdL7\\XkTmN ަ}
?{iJh(`N*&G&m}COhl6Njbe>oh0\j8isZ y"VWQV+I
cOURt`HN-=ujėRRA/}rLHHPiR/J``LóQ ,CUrްl4RN1,XR*)Ȳ<i</cgAHr9VDa>T`Y$pv1a>> 4[1 $`Q`Il5&J
.o_`]EH$ؓt7~<A ٝ}ί9
}uB >2Dmi4"FO5qUG? Ꟙe|B5y a{.dV't{{&G/4 cƬץP L5SG_ycM#<O N}<a8I1-j&.%%'WR |D١eQֵl_7hES
pFdmI #Hb8*1
Sl.
փ^H1fl(2tlm;Q_]GIcO PiNXbl;eOoqx/n^ +uUHdЖ2Y
z}&4.L+xFgO]gݎ{ k1yj,O pp]9ȉ\ʙ{@wK`(.<ekFsԑXq&2Dv unzg 3E%qF}Q2n_\/%ݤ9"#~>~vhL QܓײLč8P_ }kJ"ZiZ2 DB8`I ++*\mt3RQ K[ZTneS_t^ <A5ueiDBQ$?BIJC(t 0yԳo{1U37ZU"ǡÆ \c*nsZ ySRFk9 Nw>Ml1Ot_:fRZ&T r7>S%OH#7Sp H0hTyJ hf`#XPUw w?|,cZ5_ ?Mne؈DV3$HM'LB8`z, #)?ED8GpTR$J8՚_E'| ;\!p|`lSA]=-vL@oHC_<_ cݨ-bʄ**OKBBHe;M6MxSV誨*q(Y 6~<W8titii%_(Msg[GfN8Qpk\Y) ųDkS5DNB.CT+̬U:-j44<]~Te"H9&]l:nIWaix ]9DLJZN5 yNtW֖jE%kM-
)avcS h/ MVU1IT$f)Ix1:43{PWr<527YcYt^>+W)> =^`[0/8y6_[Bɮjfn ?(ȼ
ƀʫ&Md d<] +(
"qbS""zz=Ґ}bY+-5U/w)6Stbƈց0lS ? 'd i<hͳCМ!SW·3
?a v5{ d:̀jcrL a:WYN] `*"1> γEZ&`jTAhp6F<ӒL
&$(ڒ( TR8hq 2,8qԡ ^f -Z %
/Ht_Q?.zwt@ .(HQ0&<A
NL0ddӻo=նQ*̾t$DyC,=P(gE Sϰ4GP*Fhh A '=M^VL][Q QUjgn&l>˱?}pt}/p۽݆oXuYD;B=|] (@N3###;m]oy ߿/mݸg
94Q.BH }lCI'm#xWnwtm٢ebblܰ>=g>A/5~)יP|BG ̢S#B*JY mFLҟ^,nyA&HmEMb)1R$Rs o *N`
'J` MEH 9so #F^o垻M|g?(| a&R{寏aA{h_thbcKk
%
Vk1 |w?{7,O #_⨢v¢ =M '/ȴZKᚕz_ ŵy5|@W%&': 0S u_I1Zt,ƛgkrF]" -~|ÖקN <%<shPP8}+û >wZ+_9aC0Gv}6"r à7" %6,`@ ap xЕmCK "DpCֹw% <<lsYmGvJB["NC4</i?J6{>v~(Fܲ t&+LcoL:N @~x
_?,i,_8w ?^ Ug&-*M=Y`hOeZo\Dl9Xki{˧}{c -ۺpފ2դ8^5߮iӒūN~Κ/7PVUm*r$?VU
ZS
"ّF~?dL»n9 MJ`
ئ lVޚ vbϧ~ȱͰ}şXC`Â eXD,bpZo_ m߲ДE;y ;oڻM34~+^5⛆"8R>s. f.A6M4b|?mFMԏ7*8
h0Py% u
F` B4&qfK/ g%/@?bD: |SP`i3omW^!ãNobT862xt
|. PÕ2ؔGa ޤ'bU5bA-zM"[7qcCejLfU5~D&9> PklcLLC/OܯXzc/ 賶 Y,zz܆ۦ~_p#96BP@$9M 0r_\m5oJw `{oG] <@s#dwl\8P虾dsc &f.zBI.[Mӕ5[}w&ô;w,sCMW4 j6!n7)Ѫib2cپ*/]tlf9\ylP m 7ŕD|]e ut3',k3PS)
ʦC psr,[T}'⽻Q[#PX%!!1at
dƿnZf
Lkr37eD|c9 1*U hbbf
" -{bU*Nc etjbڰMI6MtͲF|#'ZՇj?%`*
ŭXNK_4H,Qs*vHsAL<7)\XP0lg&:"шD(lփ @l9Xyt [gaCV {Og߲ ҉ RR&nI¡Jժ33㒓'ghHi0Ypv9U+ˋ$mPp"LMsMM!!(uƿu][&/j >r=~V V0yh(~ر3{߾صٚCnm e{û*6U9N M0+5
>ZJKIJmo}271Ż8>{b2>=\R z.~=m/?mۘ,S/}`C8IRP
4yN9wfc
#䡲c(B$%7Cq\T|r3)<DdSdxDtCOսm&Bn
Fquh'藛pGtw2m!j-oS>~}G 0g_{`ޝ/qU $}tOi$ț,faqİP_YY)=ˑ&$!qw]>ݲrkȸ4pҾ6.vUjuZxK! V^"?\xFedgm4C&O}읟3ύnٔ2-+_[sx :6vY{H"IfqXLpnD6J
*O3I)e"qi|kݣM2.c|H $S^TsdW1fCJxc5n.AZ@29'+ ɂŗV /617ɦD Y 8R}cR1|u#J|*:9iCZU1N{bN~DeuNq$ߘ]&&: Kh(bփ $ːq!j?t-Y+8:y%p# cP 8VWJ?]}Иgsu勖%:<:,r/&%&d.XBEc sZb0CO1\u%*yIhfn1Y|cD|K2ҽVKc;ːq!B
yw5yif )NNułF- YpHOOgiI) z M
3,Lp3Fp"1'q> j@%(@=E`1AHWWK`0ER|Α3'^p 'q _RPYSUGRHV<1[ii=NU<'@/gT"B/` o>PnGi]Ɍ[J>:8FP%9vC6- X³*jע痗jrkǗ1
1zRfRQ
a"H=u S{itx^ܿWKb<Pm'OPe ZC&fh@HvGЦNJw$7s<1zOVc:kaCC;s5k|v]ZfúW|P
t$!D˖\S
ԳG^h>|N?tXI11ZgXdh& " `X!5}' B&(<H>Hƅײ 9!SZg-)5;
:^WKVi6[tl{SZ:\PD| 6Ln6L[ghGh x^%s .Jbre&m*7!QB̛xE)=3rη|8lȐ]{=kAasnADQ 5EWࡃqUA s;;띵4w7PCc6N |r\E [tlוx"qՙTD DA.yU.[UV!dL6M1q[ֈou .氟:ul 2.e8ZGLbR?}5rV)5z
D5^$*FbC4'6Lb|8ģ:JZ ҜX?;\B%eJ!1|aW>Z G"
Pm%a8H(Ip܀e'1A#4**). rn %^gZzz,L2~y q|jhV4&2.X Ee#H0}ĭ[] "Z-9=ɑ`U(IÔ`yt 8=W
V:֞1Y : $_NV@K^*sGOŋ6e :ެDFr<^@\jV $Ew",K LjO, ũڼy٫T*cfoC<d"->V_sr "0CP X78 ijPLD(+JKKJiNgǬ :1f5Jf/6~L2.A \!1w*˸"M`rKZTCڒRmˍ#b`8EO "-&8h :0/EQ d"(8Q[Mº>9 J W"b0 cr sݥA16R
& 0.g%JQ7SN3 ႃL2rba0{@"E ;]~osFG\3E W *jJKNkCmw{z8 ݂L2 w+>Zn= 'q"0 r>o Eո5!)j7
w x#nRؒ4&>*8pP*1潺fL2{()'2KRT"K2bƯ( E3p/+bDgX<P Ak1zb\l(J0SV⪭U~SikQ u-W&b / ,|lQͨ#+n`D,+8_4}ź'Lk>~1獏&B:HPPQuaUz3
'x],6GAe#|MuUubO:[p^Cc@qX {
? w`Ae %Na>>ݩ["ڜ ۗ>T.[8.&EP@Cz蓗>iH wlUgOZC u皷(Q\ BA&/ڹdNC LmN{NӞ 앉XQ藓 ^y9 -Zh2 m ݲlz/7e Z?:7o 6ս, 11Ôe ~6プ( (U-ʂ z:gy17ѪP>1{e"qVq{k;xM;:`զ.YGڵ 2̝[T6'شn(\g` A<>ŔA;?~^/8%D
|^XhKji=7һCwݼ-#k2n\T{#EUu;NTyiJk5]kJf( gw/uKZ_Os Q͜ 8mE4*L2n'V<J2"O^_*He&ڥ2uj<λ "FBl7F?
aEx7j2ޢq)I
դUu
vV\&bMsՆKkK}<^ЩH0kvM]`U4,v\D}`GxAu4X `$#0mO8^ D8)NWv#SqFՂ U+qTd"q0ԍh`ym:1J q(E5ZtJ2ivEXBbXg4-Mvi۰p,8*Êp,`B[QuYgD;)IC ;?0Ec3 !@
&8@)BIb'cJQ5.r% P %>D ap!,c E@ /]ƀ
%nSM A@|6u !BCM_`ҤL73 ajT: IENDB` httpd-2.4.64/docs/manual/images/build_a_mod_4.png 0000664 0001751 0001751 00000116374 11740644603 021504 0 ustar covener covener PNG
IHDR tEXtSoftware Adobe ImageReadyqe< "iTXtXML:com.adobe.xmp <?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?> <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="Adobe XMP Core 5.0-c061 64.140949, 2010/12/07-10:57:01 "> <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> <rdf:Description rdf:about="" xmlns:xmp="http://ns.adobe.com/xap/1.0/" xmlns:xmpMM="http://ns.adobe.com/xap/1.0/mm/" xmlns:stRef="http://ns.adobe.com/xap/1.0/sType/ResourceRef#" xmp:CreatorTool="Adobe Photoshop CS5.1 Windows" xmpMM:InstanceID="xmp.iid:99301F9781A911E1BABBF68D28AB7070" xmpMM:DocumentID="xmp.did:99301F9881A911E1BABBF68D28AB7070"> <xmpMM:DerivedFrom stRef:instanceID="xmp.iid:99301F9581A911E1BABBF68D28AB7070" stRef:documentID="xmp.did:99301F9681A911E1BABBF68D28AB7070"/> </rdf:Description> </rdf:RDF> </x:xmpmeta> <?xpacket end="r"?>h pIDATxX}LSW?Bb
*t,]5ΙGf\ɚȂH6b\ Qd#%Rg ) uE!mJ-m-O?~{9V;277 {{{\4>==ȒzT5CC@>ߺ|/r ͖ˡ0_'dpp0(zz G4 Jӷ-cee*
.^{.%b1 C*XRp7Z̳KyyQ8 &@_Zi?r,f
Gv0\4"2[5%u hR.F4_sB!V{ A+BBgB]SGrvJxtD {o-{oS}_XT= <u}iEEMLL\NMeK@_O3UUj"% R;_焌<7lnkk;&*nݺ588-)w:Ɨ9ARKZ4ܔ U Ώ+..aoc N<{҂+iSx2CmJJ"1ˋ"KJJrrr 0ؤ#D ?![q'J]ujKa/k醄8fu<sK^1/*33 E|ڼ徯\>W5R/DA< 6"""66
)ځ 6i?WX @(G ɉ1 iQ 9r] wC)R ۢ9Urp!Fq/w>68uww?Jt)sdMY(ǭNV'< ^9y枞 $%%$l5&H IMn}P v5{ DZFeB#2wZ߿䔨(T:::L&SnnC< &Db
53RtJ}Զ||bbbp[mjjb<WGe~DT\d ccc8???44t% oD|?|l߳dee9cZ[[OVw > d6goً@ XtI}}>IgHȯEl
|:ET2ߝd^ VjBS`9q[0
vz .-2oioeQ:VIz;{煮\Bj
&riik tŠSH%2T[ѯNh}Ev DΦ|E9% 8pd $И~;(McqՕ }I{N;o(4tG?љF9n% eCW 1A&`gdD
L&_ SAݻFųJh*(S1~7V]+1} T钟ytLhxA^(viܙwkV!p2%[COׂnڑ4'Irہ~)B%x K0ʂIw0[ H 8@Rݚ$'F!$YL7jHXMXZ L, ǑRVK S_x e U M RQGK%-}(J#ĤPhX%Ma~Vg`ؽk,L v *[!}@H/_?և7n܀0=~!J7nߟ Dϟg.Kv~8_A [YYR6[ػA1+kUڝ;w=%2tW
M$666 "y@AAB8||zb-Wàʰ~ j{r4a`hcޓc o, }:ZZZh6EQ|*a$*(e %>x0!<Hj2M3 )(10ƥ80Dp6 A
eu {gImAC3 9J!Bv[ 444 콇kjIמZz5XL|PY {zB;}4b eO2& -e 8rsY9/
)
;
A F.6p0Zj[ZZp t B׃+Dȁ#`<znϙK| y{{+ܿ?0Ȁ177'mx@QQQj
1 [guxv
$ 4D "w% >~H4
k
4bDkƂc1Hnz8n*9S!seйA
ROTIA աt&q^t^
-$
S ͼ m n Y00ܺ
@eЭ 4>Đf? վ@3/4\Sǭ>qW|2 LSW2#3 LBi$Anj ,9u~朡\dhSt.,!tj D>.Xbq(fāOw^_)_R<9y{{9:y@~ߥ~&dCU`T_H^9 ~tA띭y;ڑy
sEKi
wV_bv k! ?(_y3 <D teǖ3@ύ|x
;V\آP\eV#<ȄZt{Kv܉EWAWHTɞc2e6a)Qtq [B)ѻ yX|":B 8_r@J^kim:ѕkÁ b$ [:KJA9 `çҢ;8
xɫI
ʮpH 37})Y T:a/ s`izIc 4~Oޞӯ% ۿ e{;ɫorQZZTRW0OS>lKg6*wMMb%### <nxB[91Θ:xigZS{4'j5Q } Qٳl2;9mg%11ZZZVDû&'&*IEh4__|VJh>#Y얫4^^^ ??P'`Gb7mP(W3 ~&**-2lҥK,<x%cttnn&&`
KAdW5kV\ fQ-·ۇBH>n ?q}mkѴB>N &twn70;Yin"-x{*)
QZ,Ew?(( YAI_q!#F)
c;qJxE
(xrVq0v$Ӑ%(Zp:`r x.&_|5k3 `(* )yP/GDe8 )q`Ed``3A88nx}C"9<;F4U@?^k!K.
V&w>;=`2SH\Dx<5T*OnD;, Kd"XE.baYS%<G2
U}
[& sGFW!8rHNN4UOR5MO_^K `8$ wHm[η-lXa2u:K<==#""d2 z ucb\b6mr(
gffw.,,tSn좢"c^]L;J"fX植3 ƀK}E%u.dm?#vOh S*ĵ$>Ps1CoY ?755x
v50Lj
3y>u6JmGNq:>nؿ`k
btqb-"CTZ$y.Ps #bex(*)-2mb%GfPB kWq^TTCm@̄bnCd< sdzBF*m:(P(5u;`Nvbux/
U8`¡ |)!lEqln 1<-YcЕ1 bz³$[0
0^ ]E*anjx`TG|X=b
ogbY
Ձٍ$m۪rm o#"B`X:вYj)V@D뿕X jXZ?kT݊Z+v jEQ c&$`@Jy/ė@ B{v=ܹ3o;{nd t\d
ܼ] Ǒ<S;ۭ-TW
G^z(S|Z ##x\sxtJzC!M*O(Njkl>1Aڭ=e;0ORIbes@]庨(Q/aH&$2
nTL./p=cŀQ"yۄ,f- .V%_ M( E*_Fn֙i~NjhԶ
E(P9X!&$."t}ik>ӱ\fjI*B_ם=(Hz솳ż١rSolي" +taÆb 1 ,aӁ6M~roꋢQE\I7|3"lPb]X;"XE 5# dJJ *%"gHmJE(#h+3ҁ4g!AH(EYI!r(a20RB8) Y.
7*$;د5NГ;qVpX`5q$~7D ލ)W -IH~`0{S
t1B3Qg^ڸ<)B o1)PZB$əo]m|_r 203Ao LE17 /G=-q"pUk@D<VVM}5 _#)+WBNr : REF2@,&K.}GzataCT荍|4* \yM ЌbQI,¸k.^Zd3H֢ϭ7~C_mwyBEsW|n>yGN/1ȏm ],Uvƙ"W\t"EU)'qыY䎄>}!B3I_ t%f} ~Qqd,L*],r 2+p^D)Z[L=H>4 -{6n0 %3zxR+LP.}2ή66NNNÇ)yQZTDww{yyA7|7S, UJWD.TT*^}<k~
avo*O2R ƠFT^Wش,RTս&>
3 p:NPHH_"ߵf+Ϗ9|#Çׯ_HNNhH{2v-g ?ĐB=Zl77R H!ݲF3c5lT]eP~`ٳgGj&iJ#'4X֖N F>zsI7En[XxѥٛYDp. eIGie
v ><00ޥ^PoyË`5/e3{_k<Tx)Fk.t0$SB$G7vxkY,I&(x/ qcNI7 ĊqSHyK?r#2%A ,$ rz1"/ RvJVjtRA*T8`̖S6(:`L0-X#"7 d]^'0Yp8FtֈaX}#Ͱrnll | $ Fɍ43";*|,+(@ a؍JB`Hf$0_9?EB,63"tVXaD j_ h־!sR݂B70aY{'3 ; 7Ԁ(=@^ĕ+; Z$@;VO\ɧFsG uP GQ .]% ]Fi(
{:)'ed!<9$4 '!
-[f٘C*1LZN`zB-fQ@S&ajDdZgE-[tD ,Vs_P*/srDFA9dB0@RAhrT8319z/CX<._L9p{ 8AbLs=e? }zK4^mz|rB!am}^_;z%.E!M&+&ʋ'2,U`SBKbKmg u=vEJ(RVVV?i12h>U_z ʮ&&&RY\hI7 Y/2]x#3Yfxnnn|>ǎ ֵk&L1Qv
&Նv ^ś^?
tmRgO( z
]7=IC u z ooo& j&
f
TP唜EKW=\KQqC
_oʡk {Y( v/^+t;
D#Go۶mΝL&0בMMtܣGYYYЩo JI"%%%**#
T<h٦G%,s5PH! Ignzy2(P_N,=3^D6г? >糚@{
3Rdhyb|!$$OUR6ݭJV]]]__ lHѣ=QhBy2qq떆<L֫ m&::k=NqFH& z 4<hd999֠" ڢ U4ϧs]: <!/ fh/
_RAiÓ9i鼼_I RĚOpY{ӦrFڡ_yyl"y4^Y[%# eb$E MY$ oY 5'
bv/ %bvD~2w]ΟC(@_@Q%: 2
c$!i!j"m!
}tլ1t kw;+7@6.LW:
bH}3 D%
?y4|4|X\C"&ݗG SWi%VsVݜ ỳ|'LBs56'ng"Hy>T$$T V9_ Ok44HD >C$j˓Mm8M&,5s{;#0cg:Ƕz$`n 6<4V$
Uߢ\ I (yV - aF6y*m&s~
9 h?r}u[d_k:_Òtu' {Oc-,HE,G}KV ğeWE/+vMglEaWc55!"5$IMId<w>fj~{Νs{{?R>$ prΜ6Գ!w$ݼ8җ{@j_MYy/雪tc7w(;jWU\/uuu; y
5?1 MQTnݑG<S8+f&ECqH&ႈ=q BT#6[LfNDt"A gG!>;#f
#֨=bR`#P-7hG^eyw^=WVr/ah' Jm^uL Ja'!>-q"dGE|vA'10I42Ǭ gkp#VkFAj2 hb$+*8
Ha% Q+p V[ s6i?:q(B\$AKу
9 <m* /:e 2k. obXZ[#l* ">s#}
Ōmk 1Wlۊq
'1c ij'FC{*]I>~= h3:h(E2MNa |c+ DI>)$ +, L-1
vL"sh!U47$p0p&uy g# h5(By Ƭ@ & d5D(V [m"{`vٟ411Qފ#`䪪B֜]49B oS[UN&=*{\# AnSRat|pk F[]7qAh|Tx#{1Ktc8B?xBd2o QTn~
Olv 'LC凐WFr愣f^D䂗# ۃ툾Ez*:nkm]کL# D@ J oo 6Wwݔhz~o#wQ5{ D(_ߤ)IݝLu w]eѦ&3 <Р}N^&
o=*-^KɕԈ@ t
kݛ% DB%D@[?9}4z|O_%#T'<MZ"#|E!i/o ә% l c 5to+cX%1xtƎaA H|nG xd r
kCqc ^]>I#YHi'^
5zAQՐ O 3w9 lEj*cyy;h y[\KE""g7<3Zw 9lDs1o|bbLH͝þ?z
`ɱ]p#
SQكۑeTWE8n[U/zUX;üT=fR rf:}v,E
|b4dQoGƯ[b$]W?/0 ɂKCAOC_A]+拍WxG?M*eKq k9%ĔIsMхBОK-ȶG 5{8ֵ]㻪~A
ky=sJ]dTat4}rǰ-W?YaaaEE'2&A Mصk-ݿ+
zi,UVuEGGgJ]v߾}[[[+w/_|c"Gr55y飫
-@*$ ?b'Cz)]ğ5|ًS͛7`w^2? oO{woU9-700 ERՍx@Um ~ `n j'M V]Q[
H< $υ9Q r:<2Mߤ٭.7#eeewe%|76Ig *[.Vv=>7377X_A]D}ݹa {
ZaϞ=><r[%K ?~\ T{ڵ,AȠnnn{a^z9# پg:R
;`ޣK+$;i3|"#{~t[|yI¢EL&BXkzXb]j;w izgG FYvޯGfIX`_v E/d c+C7 ZFP722sWsE<܌ b1Wk9d] 2{~zpæxj{}g V}z8~9ՖxGGH(}ppShBg 'ic+T{*wV$:ЯY?/Y\g8uwt,n$le Xy ۶mT}h{߿n Ȗx~r'&mY{@lf;;zW$͍ב#/.dFRKƣ}" BӢxA |#[Y cR "Ԡ_O 1& F5uř^F*<=Ѯ}ݻw : w >yI{ڋ&$$aD<-uBS/S>hWW,ddbaW1UlϢ %XB.2').L$@iݘ \ !ǑG>PZ Fbjb` \:'Cn9,1K-2ӓ+Wxzz*~Ui[g)
ŝ- (P̾
CCCccco6:`>}6Aj 2Oiԋ6m툌!ۜ9O^BHKCSH : iG S]&;WpHԩSpk^W"}0" R_vYZ/lXjgTt7n8{kDgaD?Ў?˜|# 9g3G,h`Á 5FsTm<(Xip*e.55wi}4itg~$-F>Ì40" 3l"ǀ҂HH4? +<I##h!|p-N P0L& H`B& "_
\L~c "6m
B$Fw+81 rCPB"[Qjp?[cA ." BwKkHSV,1$@&H$Ð%Ԧ6li s
I!A8b0'aˬ" '#
X֖ 5*%NC/
ekUx#hz92Mh=[#r 赳 D> D#\?6{#D-"aY"䙙]0"rAXTõhBh,) J89<-/HdIKmh@s~c bD
lȷZ98
9|qU R_p"!_D0µ.Afpk^ #ΐE\D|o&~ (ዾa,ÂPgA#ʹ,r~=y}זd~fȯuLD s2QRۄH:`_SNˑJ,xvvLߧ,ZHKK+**J$/[[[5$Ǎjkk o'XLMd+⽭~̱Z
Ϡܟnmccc[#|5##h2 P>zhTX֭[윗lvTWWz
Boڊ%FjtӖey飢5իW];}2>TT__z4aG n{h:Wtڑx{Y&%6}iݻJ@mh\.7::zfy6m>|8h*,'O>OH& I?^RRү8e]t?mƯeY[uME̝c_:~x#FܼyQ͒^+|t{訉)(yӜ4c333mmm+fee1vj9H*ŋ+W4B;zhAA5k@AAѡ [AJU>^ }
m_?4ꇢv˗-[~-yQydQrcӍ+LP^mˊzr@ KIB~$#^#f(4(߿ڂ===? ۡvRSSLfdd'-ru]4B)|?읊,fPx$:w͛ 7+UBzԁS<<<>0{Iggg+Cڌ"߿۷ cSɓcƌ<F999 Xkc!\;;;'''7p$;v8rȇη# ?0(x
TÑ!auV|J; aO5`P]VVkoo*Ã O
Ċ\|a`` ^wFZTjΝ; =jmm
˗/ 9'NEpcǎ 9[54VqiccA(}=)(g
pyXL(uGhP[| ɻ1f7?;GɄ8p%MTxd> SFYCx gvZe]|Gۻ=/tG<iyΤ}`/)vrYB$ dK
_٭U|gN?k+UJ~5
hcS.p!-]p!~2sKj Ifd]RH9ąHnL00@N sX!Es¨$H֓U!L`$4Ý[5W"I:FHu[2# i>
/X;_Tڶ38&x4qVaF |ԓ⭽QB6abG< Iiʞ-8i:#r~A̸3L" g8K4":F9"L_+q"?{JI C$s6g! :G,h4:ā i)rY;F--%حY 5(4VMՠև1
Q+F!4#1 Q53m ּ>W}l7TEef;QFa#tv1BE8~?_ PܟW4G@)W6wlQz1QmL+&Bql F r" !yAdq(|Dj״m矤88>wIs@:{
Uݛݹ69h]`XbgXQ
zljP[-aW XjEòJ"Z#K43a=6{߹w6d2}s;wsνi^ i:We@٪Y. D"Z8OjqLϞEֶ n9s?wyM=u+
e :(-Xnŋݻԥʪf=ݻ^VOa dܭWy(INX ϋ9a
\<) zZ"YǰIDձÒkoQް**;MP`qJbMJ$Rj6of?8I"^C+O!
8vKHxK- dy!BIH -ki|`'!,*"c("-{.@zJpR|Җ
SZJ%zV!=B>+QipA՛А\y$5~ nSN\VheEs R'J$*g. %ZՖՂբ*?
Ҽ ʇ0K@fg#$o(-6ЀdY`K v~dto; O[·4alTv*[3"X ȁ:$gOfcξ˹[uiD7tAbTՇaUsQ-zV̪]DWGw^o߆T^aY%R?~ej pyq(L< 0JH L=% [K1e0QT aK A4<@-qn
SJH`8 \ l)oXͅ|,JCk1 BIX ɣ #cqv $`RmQ?M#-l#Jg7zA<8ְl =R> jKE#*oF4eQI{mYa ?oJFw,vЍZHÑm(4p ɧ#
YpC9Ih ܍iml}"M8Ƒ⻠my38i]˶ Ohv ꒷h>z4_EݧSHʘ3[zS%Wsm|GzMjA㗨vVO8gKв)Kʇ&{[Xk<#NrV^2&ѐMT)툉B0 P"!i
XS&hɘu&O
Sp4b$w>xU-QKE >lChW )!i֤wrHϾ{5zGޏlFjUh__39MB.t{RKH]T푒 +H<!% I7L&-n BM{$
ujb Iy81ȜXbLYYIvKSHHУ ͟@?QV&2 F#𐌔`4=ՏCcDRKg*9[@ GB^րgk
-G|We%8 6bΩNk$_)\AQDEC"Iȣn1r Ͽ݇$\:Abzp0u]S|>qQqIяsJ+fn&#׃ŷADjS[HFHkj3XvXv3pDLƉȐD 1F[vp &'/b*#g!Ҹs} GB3^Nĥ8@
Dxz?oF| zD*8)˒hʾٰχ Fl?| 7Ahfyeَ439 '#+/wv-HgC˕)pPj_ )\$u ثloVTi^kY{Z [uEH9>y 'мHb 2([[2 /?C9>ms QxwvD`:ѐt-o!gA)esz A p^pH89 5 =Rp?\ ? 8uM4pT3Ht¹ - NBHM ) Yb25Ʉ&)u#3.אR
%Պ&*tN#@0n$n4!fO8"4RJIx{xbj-A^'BUsR5w~=;=2ȑ{gy pB;K\`' qHJC=_ɳуȳ[y߱mA)08!
lRz
HdeN<|m7? ~ !lz$/>4_g}M~~~;z._EG ѽAuVwuf3?c{p˵$qxDdiiEC%7m欍S7&m3I,4ݻ͓GXOE:Tyc-6CkL2ԛɟl{mp =sSZ#)k逐}"V~!%Iz>œoCt'9'P͓ribR?xe+U==GAjyMk9eo6_
n|R]yȻwܹr>cƩv'$TSSSE}eٰW83WD;&ޚƽ5YT|!b ~ZۅeB&oݧiןND4t% %hjwzEŏ;Xm۶hvZ]9Ig6{Ԭ~H@,[Pi!hifZtG=eFȡCVڷM[t7áѲeK#
W44ګۀy)$ۨF-ZtQgc[E) 8vf:Zٷ*dcrK 6mڨ # i (*:hGF/;l!ehb 뙅OFC<r$ڈ ehIlrp7 Cp ~cuz\Noۣhׯ_^hĚܡC1m߾(
ΐGI%%: W*%тZ: n3t*tZA>nݺ訲="] A/T卍Pj}2ڳ˗e=c+Oj[gYYg=vizֺuΝ;CCCAAy}ϟ?|/feO<bl]`<X+ -lꑒm4Z#=[Rˁ hq} óg qF0oqC455ȇT t4 4B߫x 4
2U61 BcP m :M_<T~E6,P[6<mDioI
zaa_w
իEb]6ZZ 0`"Հ)j qaZP>~1;wsɼ(А|<d4)fP@X?+y q;I >{0Ilciz$gqԳg*/^x T^٥ṉs}!}PRC6iNaB$wz'lG
K :::tġMqwKn.jժSַU~
P(j>~svZu+>ܛbi -=ZZZG7`<}dq~Ük7:mP"i =O111]SܹsgQ6^zɓgFEE]V2&r FP-R"[
[6`>r \287nj"DF{L>R"fk IJЫ*&m߲e 4Vj%߹`S
קOMZ&&_{A[
ȫ X3AJ;=5Ya捤Uj6zoa ^Մ D>`i>~`oRr 5|Æ
+sq/ի&X X]8+{ gB T)oq,6`utW_L =[0ǘFn+# .Ӌ|w`ywpᕮ lO۱'h^ dCB:|WX)u$`O<Y
J__ߢ#{BBBCA[E
`]cD+
>wxh0pVgbVF>wbMKs~YYlH%H8X㌀ W<
r |V`eN h!"=v_XZ"%Ҥ~UY,4 { ץ/};2ԩ28Ż'/ r϶:ϣW6)U-stt&0VT5*awl=݇|ԯ4,JA;W/ SGBh@-_?~zKCo-CL(@([#h,)L&%N_|+&8˦!RPb(rRB{L.E"5- i%+$h,Eh Båֺ6i !h] y1eIKˬٚ6~V3,(F ʴ= u`(=I= VyAHؚL6X[P}m>(=V|W+v5I0wFpw=zԗc4sej*rrBXӣ.IbP4&NeNqo=15!PE C9Er:#uw=zTӡ_~edddr5L^g; !IIM6v8PO2;X|F/=eȴ@q_DB}B li@b4>8K|dJDѼS҂0?Hc TAup+]G ( a2sL;;Q28͑e>U7?:Yݻ{y=}}:+MhrbBbKc\4RFLLP(:H>4 pr #X_u7X|_J!5Lj@Iq|||Y50r)T7!<7HD [>Gj';;{ܸqK.|EZ~^tV[Y t
J'M0רּ:=z5TR ɼX/v G8vp']kP%A選 ?~<==](H^mẎJ;eUa}*kX)ǰp#id S.bChİ5FƚaYYkNrCX6$$)
ü!5$)x!LFBX<bS D FFC$rYuB @P|B\;̟?[)#<ʜj/&!!nP@~Z[> &kՒϟ?^9F|ƥfK|0- :yO(0mI)N~惒YnA^vo߾իO*=rÆ
,v76,u8>>Ei#쳻3yxn^mxrt&%%ή^ WU ã5 <7BDDĖ-[G7wK{!.m (^AH|'bR38u5
J~ll, ui*h0)V A ,Qx_ZAWzYRU˶%eW L2`"T8 h kBJaMz$))IGGG1۪+\bW-UP!g ai )2CfL(z# ś N]W[_Bh
(mkȂH! "hNaNұY@#=DKm q) \ALpLN)LARvDpPx.9Uat$: x//0YHzY[W<FNB~|>E!JOS K?M/*W'ɏ*S8d*3*={6J#3Y`vyv
?ZLđL$R8M ߠAPu^ӗ MgIt?|?u(7 I8!48K -!- ΊpeIrZaA@ru%`=AYP2 rxbZx^2w35!du`ȕK7
f7_uC#7Wz!vʞ=YyB"K/T8 J,.Cr^vF<2b\),r+-(d:Q'dc
Ff DX=r=
!$_>Ik
FC:?@.ru N# T_ 1m3K2Yޛm. I`[KB~NrIYh \p!)͇A@ %qhCa0ibzRd\) گ0lv{w 5do HgfRWrTp'{߄2uFH>2͟$8'ǓZ FQMcVFvҠfzfë'"Ԫ~]~W̓VNx)|jjmtssɾ_5b?UP[|7Ծ}ݻ 8{7c TRUe>`Xǎ rW5g~9::|b=BCCmRܸs⚈b[[ &(qzסCf֕H[HRKp c~JJJ
~5e=bgg e˖aaa =ҥEN>-
5ʻg}ViY8c;ժMm zw+; lUm) [wѵHAAa,ɢѬG¸q@۷˫*짟~ 1bߓ'O`cǎUV-X@eэܭ[m,R0U؍/s}ԡfS3:}Nj4ҴlN j
Ν;=<<WE_~kAϵTwNƍsέm\ n:
8sWQFA4wW4%b00~U{QxP#MwGi*HqmQN5(z_VeF=5OkTlll߾}r
?3V'`}ǁK.<hϞ=n
HNM9oIA}55pˡ}$uѝ{ZTpא{L _'NtnOy;mnzdS cǎU:BBAN(~XXҧO 777-U=Fy44^}[TTD&-g
[E;W/= dZ>?o4 AGL&$$T̂tX9aVD,y~מ
dV`j@˝k4̙3AX[[ III?cҥ" :9+dա1
zɝ+ #Ls3M?{ږ~̬M nkyU
2;c֬YwF+1L` c@0w\PolU#
s;= ^FkLJ>s-9 =4fC7sFjj=dȐh
Z 2Ϟ=;'' lJ߯_?D} ZYGOw öWPVʕ,=RAk\Kh:|JG? FK)0Yr}MIIQJMI >d\Qu=
?<χ *
h:nxMb9W': >s-B!X%
(+A`ܸq0ڃW7o If nϙ TIN оA;X[[kA;&!Йcą&w||^
*CCC,.syp&Rv@ҳЌ k@
ȃNiV_p႕?f͚qς~):L飶s cEȑ#㏢"@x ^]Rr-4k,(kŊL'|r NA{ ~xZ wp;˗ׯ_t۷asĉQFYO5 %B 毿ZŅ@q{ 3f}<N lڴJdE/c2R K QA'N,((glVuСz1C> c%%!@J" |T
YYYk1s!O>MN <T^^^#+f0 m}t;BIgtl}רĬ_^
z,Y$))I ?p8/^#]ClޗKi 5Mp= W} dggC O݄B!MKΠS?/kf=B #[DDPq&jү@^34P"4gΜ9U9
jfhy= :Z@N"$ (9߀&I 9 ;k]tq_>B8qRgV,9\A u/)-RƌI7|>Q?Y!<+ @/=;4&ywA.hƄJ6V^V xrC*(?j,V= U6wl,Ɩ1
X@JI#`B'VYjDRP&Qq))Iꭧ)&U.'B5tL4u'/
^uBm&d"i
;>2 +oD8@*
o-</Km PA !d0ȓ&Î'z"t cߟ23 ܄ daвs:!nQʳ{'&\x1 C7;sul8u VSzjvOtlAHUxi:]ц {:Whb
)z왥oEZY.깟LkT0הx@goQ a ձ5
#w$P Oi Tye'\h4@Ӑ/LAC$<zI(WDq7 .';bys˩J |rQ7&GL1N(ȡ%C),ZY&g\w5@ӟ
}:wR7B輅CЃ*'Gĉh⋯ RC 6
mM 5|h ݁N4`c2Q+}y;b}tWp߽ ?>WPP?''R*"t2\U) &МL1\4&+|E2CXz\g +}m XDZ^pZi 7ʙ'>2CdIgӞ᧼sh%GО-݅wwTJ ' |1l J8@jX: oW>",r,G#D"?N,d4 `HOrW{NCQP2 &)cÏB&)W,+W|O͡1_E*O*I/`b Xu M,_nf#}BͮG Pqc&p*W[v==bߠ<wB=~<BOEv= aUBDz@p+g&"+1:2lN<I p e Tz9̲jxd7*S? #Cf1qNL}0tkO*Z^b n L| ܨA 28* [}R| lX{&{;4qD.[o SVw!f = |`T TI}8(mr#viDލ [vg@@vjOi>zNZAop-sG4A`x?3s"DK^PԞS*oe[)O0ajYhhEڈ4zWt\</%CA*˂6ty*i#ۧhgi
[ Ha8ˍ9"/c x\o. Y.w(sk641[7A0
< ҉ڢ?V6ChJ
%ڻ7~Jʚ
E^2Ha/CL!1ME6C YZlYDNTһs}-] sws# qGE nˏ=QR&+˖FC-vkL+ncڑ# 5]ꗣFR
Q58qiiͦNW t#O 9mF^qy!
/r/lSWAUz[
.g
y(/AoC>~}(4v=&B٧O)?kv# # q@"Jޜb A{_tږQ~[5EEEyYբbfs eK"۶m̍Tb|peݠv!P)kj@Sy
@/+@/_PWC8ՐnwggrVLQHz ᨑ.w4:HXA lI_}T|Nӷ2tP (vu%|~]]U9oɤuUˋX9WzՒdD}QAMM6<ZU#Bau XO`Yw#cޟ?se9BaY\sI13 耿L,ŢV)aepBl<
ř w 8"+aY$5Sl1q QV=/zTd_$LS2^<-xWeS_zIse ϾP~a#-0W =8 1umPXD "-h o j}3+pZ.V]jOM H4X3 'QnvvDQB?4C12Y.st,V/}?>(_p[ʏL[7K),AXO^( 2}7ƟR6*0-{~ J <1M:T z [RaQI9sY>MkX܊O+2 d`hR>/1rG
ˉ%+H#@.ą#4.l\bהkK# `ɼK -As #jd6d(AeO u%63f2/DVnD9Za8rp#gG_wk A
^>t}Sws 8sT*f ;H vRN{DDO`>ϧ4Iz>_?LMvGƒ m)$۔ttBt9 )`Xd(j?Jm*"gvB4 ^(\VpR 'mnDa>=/0Pz^N#ɐ?e㉉;F }D"I)Vu(qEzڢÍZ8˘̊JQ#_VeB&RrJW d4<y#-4.'z8?,#Hᔨ{(S'A"2l+
xCˠwBRq5FF#ͽ(Sw/:Opp
H{J7wÜ fۿ"Ư h(ALQCZ;\ {/K/tFL:NpϹ:p z~o~
:i?^K%&p.ߌDFg<W1H (!{/T[{yhAl)6mt c2r$ȔMeðغf G sY8!_=l8rYs!oBI683ce=" mMd z & m6o=3ķaش $զHծI
LB d)Ҝ)$"#IˏK/gFe"&DXфe5e'1EV8"(6d"/4SlAbˏ(}!R`Oo5aaꭹ|i"Tt FԷux 7o? 3a*a-]X(B <r~`ǎ [nԀa\CԤ(qOZAb#uůiJXnLzعhc.<xlǑܦ2)sP ;ۀT**"Gߜ\n]HfC~rQHIo
Vs"ZCeb ?~~e!$#b{)$C,
8[yǓe m~ 9{dLjtq($n2ʺ[zp3}e A ލ%(vUFPl ?J:5*_T ͑W7;8kEHfkXmW6rT 81x} *ͣ L#>H8kҹZgWR bתkB3O>ضS>N| 4&=!ZFX̐otӜ5
q>9o>H y8AY6F r*ny2եO]]QB7? Nέ0)W2*1 ^/ފվyUE -;QΛ %7gTxS(
"@"ț^tgْ @>͜ ENAJ20j` zJFwi
i "Dz~VIP?8sp+ט!Wn(vǻ귦kZ[^7n81v*q
NvɏB?/; }`,_=;}֧5ߎҧLDYɕޱuBdp vCZw锼C+o"4! d)'e=_e:+Ru60!C"6nGE@ . _6$ΒPR= OwM*!/zHΘM'-t) "ןK]<Jr 3 D ' 3ӳiRwRuFNz
i'B Y>+iq'3L=sV⾨4'x@PL+RpL7$ VX dʊG '[CޱBo.?7"b/^[ 0beHV,5փ6n/^]'8ΌTq` O|Wyg 2<ruGe%Wzu ?I 9"~ /;e=_! f@~
տG %J
M?x?8꺑OUUdDgC䚮1 .// ?
@wѰW]*}(裢{ G0 KOZۂNPJm=w I 6BRzvs(]vq dMMq;xP_o tiB̓*Eоs!IK,֝C.';D_:j24kZb Om\l k]ѕC~ ߜN \ł7+C|8dǞ߲|`|Zci؏aI &u9SR78H:pNg8B4lsm pU 5<r
D[H
LQѩas%hZ ?oIkGeCHOm")r72I/%轜KT1pP9z"~kOf
؍@: yQn.Λ gi$ﳈH\$tqNJtƗ I
KQh薵OG2R "j;SҰ9i3K"%KC!j0Qgq3R
giQ&3)M 3}&h;/I5): ?}O][æBo ^8v o
p㳕Q@lmVX Ύ) ᲧFʨOoTat5kM];vܪ-gJ'ϻJ[R#DvOfBivYxgږL!X@sGwe\g 1̥|i .b@|N;2?\[ݾ2ns߾6 0yqUVVα ߹Ƀ%
羐PT,--i[>}7GM =UC$ kG.\mޟل c_L&8& WBMKi2^ 7kik['N7kDͫuY玠%dK^"j=cg7~|\a( dB:#z[hnxVƕ^b07F<jk[q/ݶmۂ***^KaJ6ŋ\ҵ쥤\z0 2^b`q
=5kʼ{UUuuv aa}_Ħ7'L65~ 贁k;VK[4笈cƼ,HY13XR ~+B64iS/Qva7Z2pjy㽌lV+Z5: o/_?)nˏjWkI?5ulwYws5R)h.غZA]:СspA (
U˖-J(8G!EU " ::%-(Pt OeӇgݹkbs .]Tu WuRQFAY9Ȝ"5cp~J-e> )eS܊>'Ѷ+X=\Tou\
j2KKKAțfɥm3ͻI(MyWL($tjFWKPj
PH6mô|
:BD0TWu`
FoIqqԤj*"yy/^n!42Vn
GKY/\2U\ѕ8aR-Յ#/^? Knڝ|i"TXPȿѻ>g T j8#i*.SVM]]=W͛) g5/iEsU<ֹT6One
Pc\RXXPF nmݡgԀ ?C.E=z6ԙ) P!@3-~dd4G ˗/s2 6jPV }'hO >k9vњd{ o\5VR<HRbV
Zx%fJ`,`:`t(ȥ阚2QgyShf^jj. V@ I{""HXLB{ E5-Eun1Q+|U\0KE9= #/^<{,OR?Ǻ{jrߧ56*yӂ;$i)ܩS ;2M6gă%LmNV%o\VlbflWy (xoR \\⚝y kr纕 DcJ2Ta )<
]ZSTWa@ PHR+&/nEQ]{⍿-),I &ۨ*0ST:ׯ_QqTuo_>OQ6i\.d?}"#5ɣg:FfJܐׁ++Ce*vٙ}I zݫ7MG ^Co[)jPĞn%V899yΜ9VVV=z W
ݽ{ƍ.]
8pgPYlٲ˗/O<y3-W<ɦtjU+}fzr z{H
Paʮ
P`p_:pj z~wck^zhYA ?|HI'hAb-TDĭ#:ώ4`\-K =zɓ :t#\5;{~Vm_v-A=}:uȌ*~v5uE]qW*Uqy-՜1nn
*_jox<inA
Bh|lr{5: }^ʰU*iQM&- z1v:5P'm U]Y5ɑ7oѻ{NjU,A/ [Uo$:2~q
J*hB666 ;v6olkkkܖVN2\oppQv+eKr`` `;;+Vw=S<6D .B*< 5emC.{!ﴘ)F=I6( 7/&iYo=T[F150(\N\ QwF~XyٌݝFqx( (ɉRS7d%u#; ⚛DRZpr٩kH{Rg`5p&,r5*cPwIud1S)H_S:.]u\{!aٻW:/iY+tWl۾NӖuW˔F D~1.E U.]_HmذaCw+2'On߾X$3|'
>6WOڡk[Q-$:mwԨU!֭[q^Ne˖z[ХA8B Vzی`p :r͓JK@ ~ѩ蒟ko5NJ%*YFq]vsl{0$5"rD b O@G"ԀO_kG+FJp-J=n ȸGJ udx6VeDgE5
W*YЮ];:.]:<O}$'#ۢJ _:p<-
>IUVV7|\[=-U 8o>?? .|~nedVcl: 1j& wenv+ KǤ}| ف:⇻SvaoHN=K&@n&NKkoO1ƩXy#NI d%;ﾟ|uULd
ra %{qXcѠ,feAMv+`ff =᧚lO(hT}>?\+ '$ÐP.RBzQYGdٚ( Rm`7k2!6y'Zg/Y"\Ekh ʶh?MxXa3gMkeׁc Rd;vAOo?lY=ڶ,g>??ɩ000ٹn^ fB##JH'/3GJ]#`il1r%fa Ʌ9-%F qJ2qV\ Ø m2E2JosfP~.[K2n (vW" +$$$@UY?Fb_d5s]SgW;-_`#7`vu^3CCCS͚roޓt?377obb jjj`H6 J f߭}[qѻ6-sjL( eu
ׯ4gƌ_WYY5-gxNFӌ+SО gp: b)"^If6/AJ6<Mҹqt {?Hgҧm-<ݤ+ ҈i jAkK)y{% @-,(by帴I:P"i{ )g*"۷*$$*}TK˿&o6hRйrKщ'-Z5&&@sdffVVB
+gG?靶 + R1t(5[P {Mkt/e(A9 ͥ*z]_f["@F@,XPg# yg""sFE>cyli&IN)^}
v$VM5%R}SH
oذoĉ/<<!˿KQY˿eIUU5))'$$$>>uPJ9&@! 7""̬f
\ؤ'=.F$N /z!Np9"*'2i3QFɔ gǻ&VYc91vPrbahzO$GGꔠߟ1cFϞ=ܼe*=>Ccǎ>}:R@$5:5,t&3ENx U.wNZ~,-[Im> QO.qB[AP+$(7uqaC9:/Z<yQTPr Vtߛok]$ 9
C
f/N@ׯ_?,,$..N_.SpϊuEe[|?-s:A ]bUGJ8ҩdOiU}}[__ Z:59 s(h,kߝ,?ɮmЋJ欄;}wXDR#IX AdZҊ%ևb ;% Jtl"VTR<9'ɬ:'2P*ggq/U:-IO?dg0 649e>D7;=bY Ӡأ]څڔڠ52%{n% .yfr4kpsJJɓ=<<322&R? m㗒ͧ%) m@%V }7ä?2(2 Wi1uW5
i?yP$N j9%%$]&DZZjjdJJ YQrm@ ^;B{D
|77;w #[^>'W@@#n
{Nkڞ>(X~jlɿ:+)
%|ϝ 0
\K(+I6+ImN8LZ%P*a'9y4-,2i҈eY[(Y6DmpPJy֖ |M#uqƙPe;f Ee WΤtH@
JIS; Q4ۿzj)r<<b9<7"W(yrkГ5 P33:@E3IѦS
$Ģ. 2w Dn(эL!ukf
u܇FHm]#GhhM qFtۄJFN(ZOp 'D:7IƬVņS$;sP[ZP*6GoH Fn|4b'Hd>-9SZ tJ-8rrhϞ=#""jc5<w})VZ$ r!=][A_|A+K?m"##m_2 RadB(g״zwjS^SBIY4e|$2|YLbF"y'$C4禮 Ĥ%GOZ
u,tikw_99#8 "?S"R [%G
>hLL ފ
j|ggZ `-9DaAGQ
hIt"<DEE \7VZ; IC(4k'^w`Ai7 d@v<#p :چ Y9NJVt,&-jK)d$$Y`7dH {ԊZ GfJ'H$,"nV&SE۷Ǝox+nS+-Os*'d M:H=uuˑ4mٴ$T)YdPDB(G"bTChÊ*GOId+g~){(͚#aaa;wkXy]4ײD 5
$U˲NPh@Ã\UTc?ܕrHӢUQqutdAѣG&LZYYƶmm܄;r~
.tވkKO*5p@%e7f"J?f^K+Zb<srtRh4_ z *** nRpd44-ewD(?ŬbG+@|⅟w}=&Bǎ vܹ͛d>P&ԯ_˒Gj +,pEկk[)Wş|xJ*1"Ҭk*ko߾Cڵ{0Bc:{ .(QUU)84-
[p+~Ul3nAڪU1M >|Xvm.]
Ν۩S\62U4|jQQx |Sha^k5k}Q<*=6ɗsUS#|.:ԟPV@MզM(++%w<DOvvvU>_[
,Ey8l2;;;22255 J5u333[xE gGv}QhE&uuucccLMM[YPP5;`@$@@@8P@S϶ʰWFWXXRT,E^N 6VD 5x[
4qΧ@MID圹&8zxx@WzՁ#ݟ6VW~Vo%V ϟok[,;tS#F0` l3ldB_L>+^(uz:*4k^a
Kg"6?9(bP.o4Koy̍`
[~=}VX3.5kmm˕&B >|(pС9Çz t+\ MԩSoovv/^(oܹ3x ȑ#.ix p+px/pƠV:RhT7wy%/ f4n R U6(Typ@žqL qqq:OjiE 4nT*pڗڵkӧOOuvn ҤImڴ@h=\J
|Cz\h+>WƤcs @CZ^ue˪
EL\&spTXX䔟?h x+ R^go]ڷ4ޮw3esέ~jvl]$hXfddԓͬV>z($$ŋCFG IJJVsĈ_}>A ɓܨjǸ
6@ާO^iDp!x'Nm@y=VJ+T\kڳ:%\ȴ]~{VjwF]CCفV>{쯿emm
ԩSڎ\f Tm?hP9BHZ(4@cZ}AW< ygW 37a[}_H]IN۵Rˇ#Z]@vnׯϞ={neMѢEN8Ѡ縄}<!ѤsQ#|ZBUUfA @ VSC\WWT e?\X]X=+HPAa1cƿ[' lA:ydxxÇ!^(WWqՓHPAuT pT>1 @@^
88Ҙ |s ۷o
6/kem[w6RE/rs >2V+1^usnTQRS0qqq!!!f 4i@lKsG_ :t%\qp)##cĉ MpOB%uY5OݍG?ݽ3JȲqϞ=;u72 ]v
իWu%@777H jh
HDr+wU#8Hy"C[K.<#8R坼KPo߾w7oԻwy m% AEDD4P h5|%C5AȃA`@P=!!'Wʄ(7p U 4PAK>_mk3Oߜ" ?ŋІ1&@u(pKE T@Ch .P4`&u9B~o߾
q05'{ #xq*GTc:%ӗ_F~:`xA" ٳ'>Dv1w9s&~)))̝;w߿ ~AK =TAFZ]vˈA;G:<0PTHTT愧t_/88Q
T8
XZZ6 P3 嶩UӸU?~߾} ={u"\ſ ڀ"h!߅"q{o>h AĀ˖-_ =i=!x+* GqX ᨆ p (T ch]9PROdΝ2B5etx G5@+5(jOa?~ 0
+rG8j5#QB5::=qĉ=Y 'OW qG8H=իׯ_%EƎ `.qp nذۗ&N&\̣PL(ߝҝ_ &>!
1 ) $(w+ 7BP~$Z '< WOJ j/[~0
aUTΔ!@:W[bGƸ2Li3!66VOOo˖-)@F E*&4ͺR!?39fqmJ`۽H[~ZfU{ٵSLV"\
EnllUKoljn-n]fQOlS"T_FVVBOXʄFeReVZdJC B6 $Fbo+6PFAX,Q%l_֓$
t%bҨ0L䝴
H`D%}/
!+Y\{-ڛ%$)oE{ r|(@~
¯s $"#Z$SV)2R2h +r
/BːFQ<% +DqK]MFwpCˤ eȤNI{ia>$Db+82֤쬫,v)vnRq 3{_7#=pϿ3 "4ۘ>WywL2"y ǁ"#&2p_K"zYWVtQҜ [A>FtB>WDb8n)
@╗kelRN缹pS8c1\ߒd ;܉ 3rs·<ݥ/<VV9/H|@pyDڍ Ae<KU(7N;ry ?#Q!-&.~牢Krʥ\XQșˤ"V ֿL,欝Ge";-UXۙ_ T%@ 3D+xd{5<4+VS'/u@˓%F' ^yaeCh2G;*KՇVL]`h} CݡZfysMOg{uanNkCϤ$ODRꮾk7\<bW'BЬۥB~%b3diyt=hlu;/ fg#ۿcWC\,.
B& CB&GOR̰ J4=MלER㸿k>PvU9 a.υyWL?ѮușQNY#ቨ%2_d,FȾC~]Rw?fsS/sp(I?(+zH_ԏRN kt/R诎~ 2Ӕ5 2J 3 kfvUߚ
*Iw!SS8BAzG\#DCKoɉ~^k\N9#GnaD_WiCѴNoCV[k/\w>
f?O;^Vw~ 9BN%t՟e|>c2uR(Pd}Y uˮ?*3 b4S D[msֶ.gezY;H[uC>n'Z 2,h. w 3tqB`;. *v)D&kfR`˓g P)Uj&w
TYdM5k ϋ
Lym:p8F_|l1;#QaXUlzxT M>2D>-CH]0f D!4I~ hyRw W2ӵl aM O*:pOe^ssvV|_;x}]V t#ۊ%?st/8n/]A_R
ևE%T QSeGֺeAw*Y.߫d3x'Flf ,prW>V`p>-HDlC[, 9c26LM8L >ʒkiwױEs1è͡zd@$W>Djbs$4vOƉה&-bb/=~ g^34Rnzfïwu2{'O6[~ee%!VQ,uQ%fPץȨcPr}LO@5i1F*Jyq{#9I3vI¸[ͭY092 W
pfr8(o#gҀ !
K2n5\YB qG qQm Y=$= IENDB` httpd-2.4.64/docs/manual/images/filter_arch.tr.png 0000664 0001751 0001751 00000004706 11035423623 021716 0 ustar covener covener PNG
IHDR 9 PLTE 333ffff uIDATx^ˊ:`]A ̋VO1+ж!zC3KVުOg*¸!)3!T)!=3=3=3=#P~ ͳ3{DsWp <<)' }G ,;=sAez陞/{/2=3=/+3=ڇ'@{f~pځ6 }G)G= y^^hOIcA'3 *E_Yh)K: U?3תLT>2-ATfZ1Z^?YH#T=3V\ΊcHD+ RgG8 Pegr]<ճ@ēґVO 䜒~zNÉ)'-/?Z.B3
+<Ξ ϙk}Kis~#!ZWˁIJtsqRR|pHy {S{{b4rnXyn+Jֳ iǹy=u4(6 {h穃=Xc:ˮ{G9_{υ_
6V
P
R>U=ho w
? q7lP X H E^ ʃjOX0>xl 1y D(uQ)XL=N!n"<=y3bx ,2x!C &գGÏ_#=N[ /"Xe)^ʣ Cєҵ0O"@<&r I*ߊ%-Ey_u!4sSxR[dG6 Fz.BHbC=uQP<c=(s(ς S q婈</فXk|kĚ 5k}Z>k agg>?陞陞陞陞陞陞 O`Ͼ~Kz)@1 <ʫBOs( ߀ ;h ꇛmn
C y*ֈ6-m<tް=` |0S;xW% ]P
s]F]ԝf_rIbD}`β}<|r ꩒أ)?n0ϛunL 0w^@6o]i zL8|T'}~}}痡yLړUpv^"o>?_#fU$_=N:Ϯp>c{ Dìy`~_ofP{<xI|ί{~ǿw%(- Ӈ Q8?_.a aS:?=oCϏ s~y8W3eA8 y< y YC ¹U nU6MϞ zmc P[OX)3kL #O<- º]N /k@k=sןiSϟahFS _^쑋'Qv7y$lURs~}mU,ZF?8Iﱚ z
zKpO` ]:ϓ_·_bm M~62pdNWy͞'<t귪6zS~= ] o y~=
8d? {MA}7?} ]c<o8T !ϛ覇x1|Sx 7<<ȣ=A U
k 0_q Pq cw {c:փyeMiOG{ =RWf^{ j~ Bn&S\' =^N"K~K=NY AzO8R]~J S˯`GF={m /x}?!%z,I s{23=|~` Hs8 j|/kKg3[_([-֧C=NC=Oy4K0r,j0s,J0S,4̣<` q<, 8a<C͡<y|@ w@¯ɯLO6t 2_ 9A`Yu DCx bV]_
F{ A/@띞=] {x!д6N/JWwNR߿SQ }%8PKA xl S [H)( y 8<=6 3='ᘞ{gB_@ @XC b/ Ze/c}>/陞陞陞陞陞陞1ezgz gjo IENDB` httpd-2.4.64/docs/manual/images/mod_filter_new.png 0000664 0001751 0001751 00000002034 10671421551 022000 0 ustar covener covener PNG
IHDR K H" PLTE 1= IDATxNAgw4&.L;&$zEib+#4V"510фYQxD~ݒmw62' 9̜ʘ1cƌn[)K}6J1rE[B (/ 1%)!PU,<c yc2@To4'jIa̜~[@<<u?cAj00E6/vIܳ#_֚h
RVy{fQo^GӖ ljGQ x(yE6?QNFе(6t
!bW_2!b(V!wDe~$P"ҝ7jL4SSK2b0ů/pJFU P5Qq? zབ^+
)H^e_o4*tp^t&oe9!{˖϶sd/%6"rkd>yɰ#ڟAq;*9DJt- f y{YdgF)FB%eGɕ IQ냔'` 7:I0
rH.K!QzAC
S9B8
+U甌v/8JxN)w9z+-9N 9% Mm99hF_4WBM51\^ t';Sl{a"U E؋GQQ Uԣ/b( N%6wbI5,XWeQs4+mLosbH8̬geCCCyR7_-H06|8 *7z.AT8zv ^ tE+`Lu+~M=)A[T5 m1YqRe( J47[P?igYRE9 ^ v ߖ'g OsSB @6FˢMJDz
K֥;"be̘%?¥ IENDB` httpd-2.4.64/docs/manual/images/ssl_intro_fig2.png 0000664 0001751 0001751 00000002270 10671421551 021730 0 ustar covener covener PNG
IHDR ~Y sRGB gAMA a cHRM z& u0 ` : pQ< PLTE i- pHYs + IDATxQ0<xPs ~i *3 NY(|&t~˖2,꘥VY{~ q~ڞYfe/t8<+@ w X %2ڄј?OKqjxj"wz4 7 I d@AD(V֚$Y]$ e69: {&! z:
)q׃Ij^M9*Y~=_[7Q l"w,6sZ<]KQP 62P,]ˇ."sgKq>_ߏޚB%ҔASUmb 2cxP^뭚APˍ7zpm
ӐﱖF[Q֣$<]0 Z>e -ﮪ+aU>0dMuA&v FF8k>kДMy[ ɨ5nN3o "(|Am0 m~5n)%^ojrV, T
8rM baJS-(emEFӑu<n\ S H()]%}џ ,v
,Ă#d5,2ˬbBo ,2,2,2,z3KuW|9?`r6za!Y$6
ůWUV]χ !eD)_>ow,Գ:㊅ e}keoX%VÚ[eaMo8`gYy:.}c x kB2,2,2,2X SGdYfeYfeYfeY{dIIc:IcGuJ)Ne#)4Jf ]d̽Xs:i,2,2,2,2˫?=2,2,2,2ۘ$S2,G{,rdYfeYfeYfeYfNW2,J)urd. IENDB` httpd-2.4.64/docs/manual/images/caching_fig1.gif 0000664 0001751 0001751 00000040203 10302702336 021260 0 ustar covener covener GIF89aX %&&+++&'(555469:::789 4L(6H'>Y1;G>@B=CK4AQ,Fe3OpDDDEFHMMMNRXUUU]]]IOVIWhO^q]`eLb}ccdkkkgghimqoppssswxxIgLpSkPrOxQzLy~[xkefupXXYZ\`ycwkagfmkcou{tspx~vs{z~΄ێޔܜ֙ٞםܕڐх僳댴㊶댹킶㔹哻뜽䙾钾歼̤ͥԣ۫ҩ٢жƳʻĸȱСޯիڵͽĺ˳ҴۻѾԽٶߣ! , X H*\ȰÇ#JHŋ3jȱǏ C Iɓ(S\ɲ˗0cʜI͛8sɳϟ@
JѣH*]ʴӧPJJիXjʵׯ`Ê KٳhӪ]˶۷pʝKݻx˷߿ LÈ+^̸ǐ#KL˘3kg}K&
&ͨS wB
ɸ'Ei0٢o lѧܵOO`5cV.;cUpw-Md R3F~ɌϭOWJ<}V[?\h`<d ҄pxP cgAO"\pAkT Bt>V BjcPߎ<Rq@I>
@ h`mV ; c PF=e?bhLsA <d9TעȦ1(gUP(dMV(S !P O5C{eXwbS$dcB !@ ]h ť!(@
PA2Ǣ@J2Y(|
z h],f[S\Z뭏;\d !2ĉ= 'mua"B ֑+V;
p<JC0n
(*>Td`s~'p2IӞqhXh2
,m Ɉ{S5UeƔa ?[BpFd`߀c{c2n 1AnQNa~S?V d.(
dH+ꮳ ;^OGC^ O;<n=S o?_~~܃?; hV @,`x@2
(AF0 t`j aGhA
N%`WBr+!]XBNY' )H0ܠ}C 7 {( *qMbh#NчA"Њ`LU
6p H:x̣ > IBy; &$"3JZRQ$%1Ijғ$(EYO &QSfT$Y KN &air %-sa2%)ML]ǔe, Lil6JƬ&5yq^t.pN<g-Jv'% 12o JАH l@
ІfdC'JчpͨFOm E?Ғ6t&MRtt-}LvP6bt8MVLsSeuth=
v*ԢFMfԅ =z >q{ d~u &HԂ`u [u: Zt=z ':1r}T1[HOvӦb-1z PtS@ `@b:1vZ@M;֡Y³@ zΣJ}>۹BK L9-2t # D(? wV
-~@(Bjԭcg1)CB@hM`+Ow
~
@W T\~
.~@H_ETBحf{" P @e<܁h( `PE9" g[(KQp e/$@8.d<&9uf(DN PhNI .Y%tlǙ#1EC`'a
GAm0?}:4$JQ. @=h@ w -PǥA >RLC8ĩK1%=tzckEþ-o(X9$DARر*܁ &ςdֱ&o`h{[Yh#D1nC $ĀZ pw65ŧ\;!в(NQ
5 p<-8tWv]=衎qNo? ۭw+AlT{>J x. . BB'`<I,s eނ!2G N41jc`#+*WQ_
/OkBߋD} N<A *oXP@ Ao7Ԣ| ե> q!pD.&`hOW67~[JK}c
\
\[i~7-Fc̛
fa7&
0zv8~zgS3f6yK&^a'eKdox tA'v|!!" ppCa~tp __EeOw9 `
>G<Ѐ@
DjlTUQdeWdփDzhofzqQ 60b6S oC eSc9{F
q'
砄AS
qӅ 々LVZt c:}v jV
ip@
Cpx`*o C@\{eX5W^mphpH)qs#3wԖVqvo
p
0
Hx|KF !!` p
p`vO1cLdk6_4go6
pjj0|t `*)R lP[6h_8]SVAx
( :K85`ȅ,TRt]Ń`u{
6l]o :, w Whiu]_L{PYq_z ( `C!_0y7[Q_D
gzj HDiըX_`P aczp0 Gx!!PI^S)WgW0B eQw0tB(#t~KXaSc*MIE0]Gq}[M_Rh)u@
ט?AVUW0h|Kp@ g P1i8 `
r@ӧ@Q^X_UwpVqXƙɧ x0F9QeWyh^GKwp @w yzjY^8^R`ah
@ Ç
'"
yy 1\%wvkCvQ X8l~Jإ
P2
svj7f?XNg `R`^7k(n (ixoIUhX5_OeeP zE`* p &W7HXp:
>w( dJ
oC 0
~dufyh"8|
g2]_R& l(# P
G Э*qY@yev{ t0jڟъHDzȀDЋ4vYwR֛ `0zi"A[F7
^ss'w rws'#[0
pӹkxy wqp@ZwP| J9=S-@yp3b%e<fwo`g[J ZZUyɍ
| #XzنrkZ ,*EG2)UEmd;ew"Hz@
rK FI%Z߂@
p@P Ic_Uhs ]s7Ȍ+
+BԠaZ?r`
PXy{Eع7Q-0
kǻJ
XXX>qzڳ*wcdQgsv_+ L)
|ɲ$e _h^cWv@ q* xD RY 7]Z{`{#|yo+[
$U3LP c"Twk,qzfjpoQ
xvk7 Wsw^Qpu7e?kYquQɛ|)řnEq pvg[V5ixik-e\t[(
;aQY| U^3{sr )Xiq7ܜ&v%
xHq4<
p9W\Vf%SZ:HA fpR ! _B|ۮROp+`ϣw8)*O`&v
f^6 {IKGŘLtz qq]w 婩Zb0{ I0
z NE@m{Cw
l
u[\É e4'Buύ, XX9a}h7+l-I {}:S` *79 ӹp&Y :
jP` KuH 0^=ƪXi9GYFKZ sF<YZ`ӸYM 3EW aƐmKUAF=W5Oyk+vIlqeb |@~ǟ_3!i E` yectퟮ#vxڡ
P 6V Js0O(.K 5)v W|[[Ѿ@
ԼF ſD jY QJƛ~{ׂq^p P߆ih m;
MypB WL Spt
< i Ζ W\qZK0gl ![1[,qFRQVCPֻ])wT j \r0j\e~N/R aKn/e
}>5 v^B|q`xQ k
sP/p%.ʧװ~pX}{fֵc!QWnҋImLՏ @
r@uPZP_Bhsz ?uXck^OokZ) ; XJQu}ʉ h0{N&sHkQh ǎ$ O xKЏ (7P
v:XIO1_R=ߢ m+0 _i
h$5Ǥ{WO_~>t1C!^D ;VFD鯢 E_?yAb"B8hQ5ƔQ{' ÌNhSTUIaHYv̂jWj*);I RD.=p"
,*Z<yD;udLCjYQ"n|dʕ- fNp
LhңI&-4\T~k٭em;6ݢ,r5 8nАQ*&Sl1U][jm> <wOW ˓B%F
7pqcFr,M0-λR[vs@5zۭ; P
䍴.OtOh!3: t0Aq3cM~65䱬H#1ӌ3(I'2J)'2K-< PЁ"v8 . -߄3N9s `RNؠZhalܤ3QEeI;K)Vh:P3 *@ K%TIK1UʐTrD+j\wW_9`wbkaxA`A%~ /0-`
*7\\UYq[\]qKpq6,B /j*#C]^
y.w^v
@qv {lA8baXdK+e2q5f`U59gwg:hs ' a8Y""ȃ9F:kk}i) G5Xk߆;n i iY41晽&p)BXP'r/ w'"cR+<uWgݲjZz s|Fuw=f@xG]M=yg~2y铿G[ <☤eI
'3rA(ˇ?~e*ku}y/L7"݃6c< %:jD5i xV"A0 ܌ M|sq! U Ya+ DC-#
шG
!'9$. - "a!ET\c:X0QJTUw<)"a
=,j}G> c Ռ"PS^p 1I4=A) w$//K3e<Kc xc#AGd E$ e˄ǥ:n1(2]1d&ѹN#M3I$-a@Pp
Jv2
P~"s:%{_@G
|Q&E%zPe)p8H{$5:Ò+%:aN2 F ID- *d!*9kIENC8!|4SU Q!abOpTc_KKE> (|(E2qUyY5:=&wx
$?p*"(!5t_c K9Ynvz83=HBV3d-p$@fGvy*mGȪ e00!܁Ҹlw.wuu. {k'}uRbS.bE;1&ȁʈr]%_ձb| N@s50+[/[Hn>
Z+:nrDԭVx
qs9El9 W0[J"aȘ73a8Os(<d#yrr,DbB.Npv,MtxFKe Dx HA`5[ȗ,A6vrT=S% h'3+0SyK\l:u <$ -jT*y7>0RBq B u2B;A8="8bP)d:6mB\ q%nvI!
`'Ue/u9? v*P7:+ܓ%Ä5hY#ݝ5M4mb7/1{8f#cR|2Lġ-Zjݔ#9\]h:3y| 7bվyef4 3ډnN0 xI
V+a"@
> YǽUy T/an
j Ｕ5S庳]u >99|%?j,ryg ?A B4KrʏW<$넎ԉ^؟ -!H= ax/|<}q >(
+>~;}lׯ\yzL,<fZ֡:[ݑU
B@9h?#*~s7ۿ35m >pC@59 ܠs2BS@R.F@;I ˇ('oR d-Q[D<f#lҼ;Xx3;G+:KB Bo !xLs 3A@Z\,[/0$} Rz: 'l>c"?ߺ[&'@j1:>˓r`:"g LC+> ?VA6ԠCԨM Ɋ<DT3cDƉB;9b@5"hؓ3kZT U _Ads@1D$3Eb|7䟥{Ba%TLdCIK<@AtBK =P-i c
*ʃU?n,EdGF!xK_$c7>Gw\ ,F=}t~$ 8':MS?FTȘɇd4$xoǯjFﲿQ- dǓly<TSGb OLCEb F a$F4r.&x^87ICA+ɢd~]FbJtLHt"zCsxIlJ5$ɡ$[:%J$g~+IMlp zPsdļ2ʡJu2& U LG!ZGa!XL
:4T գ%xwK4dn<+l wr!DC
FR̶Kqd"HTpIL$CL*&(JTْ/v3O@PZH<GDOaE(4^ Av Ka$+(`-G, DN\L! d9B 44"ܰeXШ P!+LMB5L ͔p8vQ] y<-M~KQDR̩.(V2R<
RaR #M1yȈ.,<.ݜه`CeC=FP(#QOm0]8G]}F"J$TћB{
7_8kjPKBM\ӷD"W>/US] +$PJmOM] ~K+S6UQSnU-hI-T ݳ4/\T)Lu`="HV8
J3RV8Lg]q1zDV{|##+,VJ4&{.D%ZX\%XTXW/ClցNΕBXEdS+[_-YiOx<PmlUYrW}H=9؏%EMo!PHʝfҙ{(E^՝}s˰ٜ( @_hU YVYYLmڟ4~zϘBX֑,O'(n?M,+RmN N(0n XWo[#!?((ps[g e)]$>ЅyX,\+PXl ~_U <
/CQж][(!l5#w]9"0@0t \ut⳪?LvUs]XFm
50ܴuU{X.j0߂51?7sZM ( =4:] ?О_ _QkRe[ w)`=6%5@Eu-mx\bl
`%^Aul[-u.+//M@uW)xsbbq0](xxc[y|42 wYUq#aF226.Ѐ-H y
(e@ zwi)O9v@n@5)؆ - 0-e23 ,X 9lQ cc(8Q eP 2.wP~( 4zg 3-y 3(VL^y!nߡV 2( 2w8
P f cP
*@5P2Pf0c .Ї3Ѐx@Xj j( N3
`
.c .x 52P,Wֿ+@H0ǃ]f}xz P
(gm. eЇi(e0@ bR ˀ20
02 g0 PxXk10Ԅj#deaF-mBP͞1K.L^4f} @4~iނ.@ kl *h肐il&d5@2@c (j@ 5ˎ:3Z k%t`aI>j-.: wc60zЀKJ3 } j@de0
xvi ?~jZO`'ЄvXoJmf8*:. 4+
(}Ȁ5 *Ȁ0* + #i0 QȀ?#z f lyp 3>?ɇb }q$N X&~b q~H
AW y@A'4 G @?E l S4|}qql$b" _;c
\˾{kPWL7'ɹO O ^o Z 8CD$>Wչ+Y0SwvpnG+3]fOs-Zh C4RHϟțɛ !!mnVoM/,?P 뇥v)hkwWZ
( y#׀d8@ + jHr")
yj(i( c5 -+8w w`iL."if Zb_x ߔO -Ȁ~0
0pG jP5 ~i20j W X3 y4(w(n(zPtP(>~ȀTgedQ@h{ac ҿ{|g ~ nPȀȝ~0{+ Ȁ2fWx0 p
8 ~5 24 Xw1u!m^}V (hP1
2lp!b$!ƌ7r#Ȑ"GI-Åh%3̅~W&!f,<D$"1jnjR.Ra d(/Ywj*a?iH\\QY
/
0x0~lI!gȒ'SܱJ54c;Vq2 .C1hோi1ށ[ZOy|A"2z vXVPQmELu/2/H0 vdInIH#X IUӏUXQ2UQFwlQ1e*saUVO2TQtT0ƀijɔQ5bӏʀ^%c^9$_|ď7@!D%a:fbT~hɑ2L&& aTʷ? E3g
^Ts(24%|wO1},8)a&`vMz*&)IE|22i>2,˟ٵ-D5: ː4P<%`µSA @)Ԧ+Y:R>Q .}4`[asAA+lWUCxWHSAxqjP< 2 5nHDx2?)zqeQ @ IkIKbJ[I
X@P'_zj~5+SN'BHm)WI<`BM護<{w {^x; 9?S.y]wIsYgM1.>F'f ;; ?<<Ӯ@v ;!<O]P4?>>髿 `v]R;LA {3_+ `V< 2| #'HR`B! r/@j @EB, 8CBuC Hԡ%( ^3:U
mI (HC#.|Gγu͏$
sl_ ЀQPW^
bKgUEoAR;F0$5Fq$T p Vq 10(b h*c1p pJB (A
G M)DH!Րe92#A*( a
/{y(/b^3̏#ßy>jRd7
5͎P:¹}X2Å
v^Kc /qr$ vXl(GQ8t#(''wLVC
T]8H>"iS$
3VI 6{b
E.vMt !TT# B?2c3ꤦf %BUCY" +{wpb^@TrEVNYwaEE<xW8a&@Yk>d 0zQ*V2 D+K'+-!ɇ:
` SkMKi0!mPvyYF ="I>@F2k5V}B*uùaQj]@CSF CMTsKb=>$T}n^O~p}}cޛ27NҺ몕 0IYB/G )Ap Sx$͇-`h=" )z[ p !--My =a# E tRȔLd`8$d1/if<d 0 f\ؤUGۖP Y0P q <* ЋOHAaAg KR:0_(iY YLc
N͔&08;hqq k̺ϯrGf`%&
s ;+Yvmغ#X) m?yNj}'KaVERֆ0mevDümߺ*}8ƻ!w[AfKi❵Gq[
srsex&6n'Sk$/ /\><ڠM#6 ͗('.
z$5= 0W!1σ= ] AzG<֮c .D6l,+zY [N #کTwDjj>#Ж1Q~
F(d
|_CB" ;t d8 h_V!kLa`?Q~9bc o?l yי~Gx911pC0~a Am=F8t>'oUS0ET-C>`1-?C
2?pC:C0 EC- G C}I]^ C샞(D0k:`= Y0;' bD?*?-:x&ÑCXM`C1 E~1> +B܂8 :ܡB '(`'Db8|
a Db ` `aɠhRZTK.T1BC- :C''܂%
ʎr"(?@b =8: DU A"xы/=|B0=p!(=`>" v 5b8C 7t=`:%='>(`>C<bcC/K )=-%҂ rcCƠ=B:-8P`Q&0B:MK#UQ ZoemGcH i T[=HΐH
U^)ĕ,C=I
>ZW/?YLYV>iP-!%yE5T;
`Z[8NlΉWDdF%J"b?DZfkZBlbDZf@.D{m!kN^5_cסY90zUZNmgF̑ HUC &fyCD;'yf;&c' {u^/Zy>ݫ ~n{W%s B:V6~/mREp}h{ M]f|b%mޓΌb
F|Z F+b2rSl&CD4-B!.PMEIPi]eTO/@ )?-CIiCi;)[iC{1AITYEu9B驑(L2i x6XI:A䞤>USFC e}*jC bYUL6̥V b*J xÐ-yJAYBh%y
&: B:? Qfi'j{z)nӽ<kƩ2%b hT,8"bkjU(BLJY뿆S],,# kΨ:=SNl8]ټL2[ CcB 뼶jݫlbB&ޚkzS2,Af-&lMg zӹ- %ʖ0tƭ6!ޢl)F0 jl-UΩ~lqJ-Vn8 *!tFbI[E&f-6Ȑ\1lz|0.H,*WkJL/(6
e>k6RLn*?8 n6%Jm%Vk=Rm~2źlB-'ԝo4z] Zۂ
lѾ=HD8,V.b/_APFYɯ= l<<6 : 1'/17?1GO1WW1T1C/0q'q7q 11 q_EH 1 2 /H4 h@ $r p P x"O2%W%_2&g&o2'w'2((( @E" )r+/+r'2)+_ -/20% dJ4 t] 3;3|4a<4G34O54k5W36{6gsAl8w379388 99:G 83<23s >3@s;33s5Ss:<t<:/;4E7tEKC<G6 !SYѲH4II4JJ4KK4LǴL4MO 24OO4PP5QQu x1Q7S?5TGTO5UW5I'uNN[5WwW5XXK5V'S5ZZ5[XuIl[5]]5^OR4J `y va``vbn`#6cC6b b6c/cudvcOcg'hSvcodw6h[e+6dck{j{6lvkg6e`vfo6ovoK6pWd7qml i'r6n6pOhc6lvmSa6kvtc7j{v_m_wtxvuv_w<P4P|ӷ}K|7}w}~78wx~ ~ ۷3x#xw gx'8?k8G8/8xC7xsx'xxxCxw88K9{[8xOy;#y
999ǹ99繞9V@ ; httpd-2.4.64/docs/manual/images/mod_filter_old.gif 0000664 0001751 0001751 00000002316 10147723030 021744 0 ustar covener covener GIF87a 6 , 6 ڋH扦ʶ L
x.@ Ҙx"jScd[OU !_U%&h F -> Qf6Gw8EǸ6V8(h(Iy1h))JyTDƚ ,<L\l|| :
6k
ݽ#-^n~ C.?O_ oO_0 }7,X
sh 'Zq^8~1ȑ@4%ɕ,[:s 4kڼ3jTI
20
iGJ]45u)+V- ̪ӬX= S(Te%+EAc/ IL^݆ɔ*UFuw)A{&`9b!-,LbTEHN f~%,'`j}]}>nTf>ۻgmn?f<&9ԫ[P䃖~Ut_}r_?=g
H`s\n " d҅ n7.z!t JvkbUAYtv"q9Ȉ֚-"$θ&ո!h g4tIwe`XMiLEHIeyH#lBd `㚈0!%:q4 '*bNg`_ʓ&:袒NLX*ni
J8Zj:*r(w~z\ jPeR6 Ⱥ+1vGlM,ڈm}#yȏ}K%\r~2r^B$.fAص7kֲͶȞ ,3{Oќ
+q qR"* lLr2B 4̳r/sB]/?t's2MgU F5?!嚣9]uaMI^si6 chӎJwqm6i7;mtK"rw H&-橱ylgc6Y+ŷIyq!fr{;C[biQ ?B/>{/JɹG-2]>*;L On8{`#C}~ax2 h۽67O ؿpnc r@$J15,Tm"-S/ jp* ; httpd-2.4.64/docs/manual/images/mod_rewrite_fig1.gif 0000664 0001751 0001751 00000006705 10147723030 022216 0 ustar covener covener GIF87a , ڋH扦ʶ L
ĢL*̦ JԪjܮ N
(8HXhx)9IYiy jGzږ
+;K[k{;ؚ L\l|7 -]Bm
-^@n /?ONmߝ0 <8-TᴇrJ9i#vבG[(6^_$7LFV`ִyg![^<s5fr J4
?6HS,Dj"Ҫ[v z)A>$["km)u{큺bM@50ֻ0 w᷂dW"iqaG. 3vNxb9!֬u\N yƔu88ɗ7Ec. 6e Т"YxR i7Ԫ{e9|ʡd l!yfkXVp Y6 9Rzީg ^e(^p@
f Dl8{gX-ƈo&\Z:bv"Q uٵEbSgyXq }d_PZne^~ fbIff)h暽f.py˜tb睳g,|f_JhG >( .h 0ioT
.c|
**" \|6jƭꫢN3V룰JJl3Tˌ=笶F.n >.C\o &
o
pLp <r:0}1< J 19\kR|1. r"L
,ùk<3q
A
§"#tж\Lэ -{jNr"P T"[O |&b Կzq#r4m368a'2 }7 w!p8 ~H^!MhT .~韫k 5밟.|n{蹻;oo>s7!>o=gF/gx/~ᗯ觩`ǟ[دC¿*B "
\@,@0,lR >( t FHl
[R"P%@^H @.# ,:$*s ,qTLbC< Ub
[B,(z+Z hE2b>BaXŏ Ga҇x $;Lz);f d`ʢ(d"' g+ ]HZ dA46$mʷҒLk6tHukiCrԈ44z:9PV2&4 ]I9@/zRlg ;t j(zLBrĦ>C3T@V6Wf`D: 'H@le(xK
iy{F)b<ʀڈ3
ACJ!wj?=I HIQQ8"NMKU>t@MpRE#qwrȠ4Tj#t ғB)c5cBGIDźL䰭K#$%N6Ȏ=jRal JA;+
&h*eB [ϞI¬H[&^ DP\k5 ad~IKo+vRq! 7K˕o z,5Hui\]\ٝvF]Z껻.ț\!7 u
v[/ x< +Xz| a88`roeKJn 1< şP2
Ş1h Ʈб1x
7
ǜ2؈ #&p$
%ʍl#YR#d n9];di̘(5+932/;? Fc%|b=3S썳[ p<V'WgL@_ Q\z}Z LpquP"2K]4Mli(ښ|%KaO(GP?5XN1Q"c_sжm#<;m$ض!\1WTd
H!I8t+Qs~Ma# ~N2,(pJ\ f/v?e33ݷtS {V3P
~L.zSH y*U;oMcy> c>=&NU6(ĩThD )Q>Ɏ-zOXt5)iqV)A Bqq>nf~/dWureMhG$^u|[
N3̲'k=t{w?>h{*kgTԋ> }ex>нOރ ͟iOgv?o ?7G_
6(@`J 2ӀB9-G7f7+",Fr!*8!X6(x.d+#XWz?3v#'rF IC6?ȁ+
C893/4X+o\7
E38KӅql|3<F3g*؆,i:vx#e3&#jHgBqs+un|XHZwÃa;c6Vh!` (5Ycch{ ,1ȉY_h5wcC貄81Hs8R (AЌQ [;hۘ_*\?0ሎ騎@ 03] ^)Iii~8yr zvsI YpiIVii?v7!mlm6PjxgX eC->w0&Gl$ɑCtA(9@yl:)iGUin REvyRiB"JxboRbqXV钥xPnPN E%hsaEBɕ+;xIuٖԴ?"Mt1vA)x`PqL'WNi_ uqɗ Gk`v3R7P{PetTy9n<GUٚ|~
+x 65L"rsTJyvW5eSwYz Noŝ uExxN5O xxhIRbAoɖOzIsiUwAiztv a
*JjZɡ" *#J%= jP+/
1Z&(*-@58;ʣ=:&7F1EjG
@irբMP*SJUjWY[ʥ]W ; httpd-2.4.64/docs/manual/images/apache_header.gif 0000664 0001751 0001751 00000007764 10147723030 021527 0 ustar covener covener GIF89aX> 1 1 1 9))!J R { Z1 R ){ !kR kcBB1 RJ J{ Jk kRRRccc{{{ 1 1 ) ! 9 cc { B c B B k k R ) R { ƭ ! , X> pH,Ȥrl:ШtJZجvzC
xL.znp~>>B==?UbI=?P> =
B=b>L I $
*#DM k=$# .xz1J w#JHqHY
P P #< < Jp81`_[6DrUɳG Q{} J@Qc 2L5 _d2'ϳhӪ5 +TU R 4p'j8Q`9,B6G`v˘33{È(0*À OW`k ȱc hsS!!7'S+^8Hw@TY"=c :"`C' p'OM J%=eBT6ܠ
0 7 dc߈$` X Fm: a( PB|hN|&F)lXt Mh h%d` `n;8CDF0
pʰd 1@ .G埀j& e 0@`Ha=pF`$2@ 1 xd. ꫰
Ѐ*A5b6U
` h: i7*z .' !B+qP` `H vU<iې6xG$3T(j n_98z5+bo(p Q th@ 0iP =FB{C6@ꜥ
{&"L7@ ,I#RhY~bUSɆ3 G*1
p.)C6 8@ hӌ7I*@@g$\ְ jOe0@&&K04
)w2@@7tA@g7t7(zͨ!J#0xztqkSaTZj8L0!qz:7w7@ t/<D@|!
Q<GEpttmk tXE090(}'`4 v67nC>
T
lTEIG/ ɀ@ @dJ (Kh $0<˙JPU-7{wxp k* r],M `a,%
5x% E*T)jlĒӑ p0 _
^W7`z]"0 ClA@8G-1 f
hk@hcF5a3$hyP^/Zϊ X o4G^iɠw9f@v,A BeI \LPP
p3M4GI A u# TOЅE$Hhu4ͱ(\
@@"q(À
6
͎UE-pC
vR>3`nkhƦ9`
J0M賂 5\p #Z1ǣ˚MJУ`HbgΝ@w3mB7xdǦl``)PǻvJ@y *_`RBXQh:Fa+oz,JSH<<РGNdvmk9"P ˊ5vFp Iѭ>B&:A !n|Q0jN[zz@Fjt0gL8αwc>,HA c @tU6 ɹX6ʁj~% ?7<mt@zj6gç C,bsI E=γ>πg
h ZЂ<A6'մxҹ\`:8^c /pf̃͟}f a`Z0$ހvMb.Z~4n
hGn1RN5Jݶttf~ 4̊ KkHj*Z\@Y[Oc"G;Ҋn@`v:d;.ٍr ~Au<3fF ccٰ^ĥ$<q@TPg3HOҗ B
*L"0X"1Y g036k3X˫0;5:d 'ўJ] @ x ћ;? HK<AAP e J^ZQ:hfMi5az80;ʹP2 { (zȶ;Џ
px{b3'j TH 8X
! -Sa) hXBgx(::%5!
F'}XxMg+ `
PuhmC 3Q1'oS) dvT/Gn&&=sMa hKM !
Cg }Z\lCy `u) hͦ lOWu1A!v\,s07Y(PTA:Xt\8 s&pM>WP|^k^ b p%ׅ؉2" ) l
mOhUhu,Mub@x{dk|8V%(w(p ȥ #!% #0v؍4
cBh,W6mCfn9H9!VTa FhA+? Z2 1 `9I_y s`FXLqD֓d`2
ň*i=
,<+X>@ 0M s 6 & s$yD={a2 K$t. fyh=) Eu Er `[ T/\KP$y ]% p;1!!1!9P7iyF'T R 63 Fdm134o(Qk9=#&©o pd! ;FA!" ]wi铫Y7;@NDbQw?|RX"iGR |@Ӝ1shz6yX؝ ڠX]'$!-j 2 V @{-@/Bș- j::4ӥN
'剞>ec^ fv4 2X,ğgL T *)"[j5`|rBN$9fj
^뉛!o=bdQw$L
rPUTzZԉbZ7y$ Bo$#:(Su 4Y MyvW0Z::l9oʣ!c]T~7 q|b0ɜXJZֺpvB7&j Z 0;Q
cfn7 穮V TS
9ɀ+'-
*S5 ˑ p{{B#Nrbiz.v^y-#6ju,۲7`c>jz* mb\Ĭ >kDK ́;[GPR.[V{XZ\۵^`b;d[f{hjl۶nA ; httpd-2.4.64/docs/manual/images/down.gif 0000664 0001751 0001751 00000000070 10147723030 017724 0 ustar covener covener GIF89a s! , h.z ; httpd-2.4.64/docs/manual/images/bal-man.png 0000664 0001751 0001751 00000763705 12663316405 020341 0 ustar covener covener PNG
IHDR \c sRGB pHYs % %IR$ iTXtXML:com.adobe.xmp <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="XMP Core 5.4.0">
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
<rdf:Description rdf:about=""
xmlns:tiff="http://ns.adobe.com/tiff/1.0/">
<tiff:ResolutionUnit>2</tiff:ResolutionUnit>
<tiff:Compression>5</tiff:Compression>
<tiff:Orientation>1</tiff:Orientation>
<tiff:PhotometricInterpretation>2</tiff:PhotometricInterpretation>
</rdf:Description>
</rdf:RDF>
</x:xmpmeta>
Ү$ @ IDATx|^u} nRԢ%yʖm{'G|rMw6IMf4Ij'vl{'dC[ޛwxx(>e 8 .n}X__&ɐhC,,@[[wow{BaZ o2OwEwEf+:dT Ts/WT~o]'>Ollr葍$`Z+N.))I444ܯ*hmm+-/;+X X X X X X X X X X X X X XP<Z[['?~ā nnn{.jȂhS<>~ t ְr hP````````````Ryi'qi
xX}
=lk4xb@@@@@@@@@@@imi;]`d
m휮 鞵 v!X X X X X X X X X X@'''~yyyog} 5: ,@կ:bBpO : W,YAou߆Cqj1!'( ;ʋ`C8 -NՓ#E(RXXT5&NGN d鯦9w3m樞pq$ ɭҾw usqnpď 9" v9Pw8Xii 0@wʁ !X X X X X X X X X Xୱ@b1K0'\6V ~4w9x^IvIc,Ԝ`+KзIs[&uz ÂB sd,*HYYYouW}q0`p
M& | ps! teK:?Uܮٗ#M&xdI~#G:GhM !X XiLr68ڧZV D Nl{]vv jG$I:'Ooi 9Z_TO\GC[~57Hz "R>Rpu :r uekvihW/'J2uԓ[3
<+M f˖-r18qȰH\~q!2
7h=~Y:y>^*zGq[rQ }*yQ c4ε Qqu!7#Ǐ ?.۷o͛7eԨQ |`H t;w W7VK' Mk%g\ 関b>GjV*+8'9
Cy)B
6շ^,~\-DAir5$>I$?/_ZZeɡW#/:iZr<F[>:餫u;e$VYm\ns<L߿sqvgt Y8809J=k|qtOl쓎G }|O:-f^sBƏ a{n! t ;v$=^m?b IqKH <7砻?{wJͰr_q:pb <uKKIt)QVmCߑQW@VvA f%jLL 8:ihMȵ?]ƨc:Ώ9@8͛'zr¡97)&&D2K[ ><S:Uy ?p QRɋLF dK# ñ8/ ƥWN'O,oQ,ѣxbӧTVVvz~WOb[EI^UDwK*
'IDW
{ U jV w?-$y( =!N;
^_}_!mÓ[=p$dn=ijiV]_a[+!hO֎S Mn|~ RUUs NkQD({vT( y &O
p DT|K[O4 ̮._<
/|pt2bh-һwo۷] |Hv! ,,,,,,,,,,u ĞΠ p)۱ID F}w=]]V']aCFH7VHe4kk7}WS_Zιݪ# e֢Dē.W$O9=V[~|,-\.3gHus4 M
]yrw3rEBTN<zۑspFpy/wϞ=2k,wpS3G VTr?m<|#DZN3 5XO"3\? on|^~:4Lu6\_89`><y&IA [ܷnuVփn
q@@@@@@@@@-렫Ǡp*q>+ z֬[a/(=Zp6T q^WkbhOswqp*:MZ&s: T53~"!mJ8`I}k /
RT,+v'P'~JqPxD,5 N اӆegtdc]
M*eƃt4g#DFwFu*ԌZX7>/K< :+prC
Q &h)3i9+cǎu;Hx/C]n<6tG_s|NВWX <5s8ɼD&NI`9 \jǷ9!#FHqq; 駳)'Ӗo7/ׁ ?),,'!
f` <Fbu0W;}#lNbҔkih[ʌƇ[Lf \ΧI>OopbW 8o)>-بgN Gh0T=߂ !n6φp- 'UY7eGbÉ
gMW̗
x\Y0_Fwqlh'#7oq*8OaqQ[ -塚'ۇi Oqe
/ņ8O&X<G`ql4:} +t>y(>
iOGR}K[ Gղ8^q⟎O\A ZC>Fcϯ+icqWx4M.|VOM
b,.mLϏZy: qƟT4><9B:xnOj hFu[I 䘃Ӟvy=%sfJxoL"s}s^ bTTWqu+Kiukm:W$^TI ARWU,_q8 ymtN p߁3< Ae>Fyb-gIRڨY#6Kʱ#z@w8c%)FHps#(O=Q]q˦&5=rPThT ONjK)}4?nGާ1O<d͝=zAI'8;~ f &S:N(E<32aqntq6<]' ^\Y0_Fwqlh'#[7Zĥ}X6.o留V
b܇i _fidEˣy!SFg1x~GQ
ny?m8t:txQ:4pe>t⟎O:u6Jg
m cq ΩŇliITVNl8[V)Dqdor b[l-:XVKIqR7pW Iuh\f SkL9Cwu9rrh7<!֤!C2{ . giZ kݪZQ+o(*ëꢣrN 9R&\һTV5=%dXuCG \^VYg+ 3ɳ<88 }<GϻLqt
ޭPu"( d~\z: )qyh\Y8o48xj䄶u^s~C+̉cB@_Q`Puܶvz\te2O4Eyvys1⋤Yq]yC]w @UQ$=Du jb9@ (6ijo<~mᷟOR$iHn#m4>p~^Qf̘&خfCv0: Wr\A/c2 gqU:uk3݄8X X X X X X X X X=hx C u09z5R wՍƙ G29rieMz ΅;Jvrlooձ?[I1F9Z:GFuǗWW?.ZEy 7;N▗d w}+Y5p~p*>f⌣bN|}7x)3<ҕq ѽ[䡧G2v@<v=/"ʊtIy{BdRgX'UrZZKWZA貲RuY)XM):n%\ cHYik?^}i"Vq(}Vyry cĝ)a,h::٠[3~e+87<O(|յcU*Hz8ɃZ Ng:yPQM17AQ^MZ$' p[uoc;>.~҂k!Z<
c[-[
6''Nt'ꫮNZ̗ ӗ|^\69y"HEEcL|xX@@@@@@@@ tuT=KKm /Ԍ$GA&M֕V])y #V6D
si?D W_3q98DyT]j^'9XE/HHoY SĚ6_-}L, }rHP'
NƉd ؊!i 8}GcqF6:b ׇ~T~G-yUɳΓ /P҉c{o:Y5ygQ+/2D' ٲZ '7x Ȯ̋뮸P <T-*2\G lރ}@6ȃFV練oUΙ1
JO /y&ʠBٴaʿ <X#/=H Ҧ}WEs'ȒE˲
W I,?j$tB+ L
+^{D
v\rf
+fVʢVλLbQ?9:Fny2y?
%wV;"yE.inaݻϟ/&Mo `M>Y۵kV mr~6D5!X X X X X X X X Xj:Q[S; =FJJy5VͺAˀ5V+뚈eKE_.nU ұܻR/.R/}k{
ǺIuEʊKdZdذY :710B&(%3oNiWkv GF⒏2+sd
f |@_Mؾe/- 7T':̻2Jɨahmo)o|9]?߽<Zn;yH ʼ<.cG 7G%Fg>ay_xA:._s@ɺŏ]w',&X-^9>n ,-Zt v *dʕ2܉C]f6[O> ɨ៕o(ۚg˗?z<t_k - om}EqGOd峇wrt({~\/@*ş]<_? J:6m洕 槭Q8<8[Y%YgG1N gԘOoi0Q-8+w?
!
;=D>[B&D w1:76d Ϥ;nŬγYDa4+
|x6iJp90nl2lD7u8id]CSQ8l97&r~, 3|b 7<+\'
E{MyȀR슋drreݲA]_ue=orv}s oJH?sSKtsfJj[U-Y,[M7
K9vo#dMrqkn=Ȝ/:W/jlM
2nY2_z'0Z>& 9[ {3Ϛ%wnUzx7H {ݓ %pr쩲c:?tTuoHYr㵗>/}Mo/lC5-vM ݘwA7fN"\)#Ku~OzS /J : `C2 Y7uo 9rߜNOG\LT7&5:/\;!@Ydn,,,,,,,,,n4 3`vAӚI:ຂa`i8g SyGm8{-!=#p)ס+JmX g$(W4㼰5 f+qe3\~:< ,}L PӬٰ믗!u9䟾MyQ}{:[Uk ~Aq /<T4EUS&n@(LJsc4s +~:QkY[[ ,g= @EC /g͑~{lR<uL [L6XRf@*zͺNԣ$h+˗K^e+].͇tŸɵcK4ݫG'
&}
M "*K[qM M88\מं_nib3^qTU
2m03gt@`s:ya?lbpqY 4hPG ͮyNv<snI ,=gwUROweC_MK]Gyf*|O}NMWdj[g#/z䊟
٧BF\}r8vٹ:IOOcWA~:2hבuMq I}u|N2
E:R ϯu) s b:
=Y$+" ^}9> 4sfI| Z'Vٸ5YR9:H]P=-@^Mo <$Y/Тs ۷H)KRٳi6WVkU,N~ߵc}Rλ}˳%˴ֺS y2iT:C0@=y=oNvo>
r˟M^_Cmwi=R# $;wˊ[`nɉ&։ˑ<<B6o^{#\%cV-_[?c˄DL!+_zYwJEqXR.BW;c~8Y5jHdewq+++AmlQ}_7q# p\'>M4M o iB-|W%7н]6ش]|g(_TtEƩu6rG-Ω}*d7*79 `o]+MC~?Z&ĝ-p"#8%wb% ÇFO ܧ5 ] 8|QW1w3cf9TW}@} U /D 69eQ`!c6Yiֽ2z2U[ ط̽>r$Z] =e̙=SjvoW^[%cuKdqRtXóO224alnjb=EߑO^'Ž\)3λBDcK3=`M-zAeޙRu-TǯbH:TiEdYxpsgOɓ'J^%yfiUBG.]xGe͆]2 e愑z"F}^k( ,UvO"q
48eVӷg4> KS{l߱csmgDcz~4|S`[]& xZ ⷅc
m۶o>/\ t͉1gAY y[,k <~un{|B,?_ xN}:`f|eՓ>:SonO) >kd>V~MYf0~+*C9;_uQYJ|[骋6e ̚ҩN^IzdNW & BT8Z#{;Ɗ2w`YCR1}/~= ˧ۦU
Ż!Dg4ouLǎ|ݾgm;:[K%#>8zչP0lxZJF W ?p&DqS,4XIT ~5UaBVgT|h)9euȔY ߜ5&8Z[ձeb L]-yfF:ڃtmq][2).Cwo /[%u2h89ҷT't@8^*?*u;t~ <D}*xeǵ/vL6CZjO B赫᥋G:?th{> DT!]] LtWeTͻ˧gO1~\功I~.BMO=5 V]t:ʲg;ou%Pt8t舣 j5f9V8#3st>p l
Frp;~NjU{&r&(|> 'x9=S+k4^!mpm3 /`ih nph])+mꤏ0CNoݷpC~X|+ L^|a1pQ _ |<|:㕫8 ȉ8~O ;v<Ig<p O-0!/sŏg?LrOOO9 l^o7?t+2{&zJ~w_&L]>ݥ7={*/WLs)?Ol|葍pNztWҧTo~:(NsYۼys+**j:[ `' 5~4*n<
b-(/ʃ2`>LB)Lߞw T BƇncc0p9 1Dp<Ӄ
?
@Yl47<b
2< fE}yGq4q8.ak;'rq+6ab|B ,,,,,,,,,,9;cS'axC留_' ӝagrt 2<#6| `0:M'}D_a$&, fiKނ<p}>!(=pf¥V?OۛCi}y8O}Y0k 8\ӓ6y*Gq̟|IwVCee۶JNpmtјrKlcgwheGgzE M -O#$4Qh>S68ЁGL?xe~ga~ڧ48e>TiM o4i ǕbS3ӥ}[le<U ~ڧOq, t~ljKgT 3
y&]#Qh-KIKWf2|3b N Rѥ;!1|]b2gbqdŕeקF,WKEO*] T0_iB;lLQ8}84Xbc&yhb 5V7l K/}~ leFc
qNUT|/IeTwmߢ/u~Ω-rMƎ d u $֮]{(=` 3{88z;}~
s8, F:3CC0>>0G1Z@Q\+Ga ˎd
Q y}T7ंSfp,|8EaÏ3Ćkx>42< 4p]v q-qfC v<:,xߓ:`.? p#ƍi `q0<Sw|\k1ep(|Stͥn'PN;ȟ\xtz)IYgFpkjj[38PO````````l/^uY#p 8_~Ρqg;e~G!
DQ:Q\1^τKKKY\$/ ׁ| n*x n|
ޯG:*d].uuM'+ <p3 =V)yt@@@@@@@@ {}̘8vXFzna8| fx K%xSM#|:?sd\htrު\l:jy%k.rhy=o'[4{" [{JqN7!&S]Sv{>{ N7}c[: +8Wq²)?s.=U緣NoLB'[ -((HE\p3x* '0 ZgQsŁ4/ӇʼnM?
ntˈ E [lp_R.DU2[)7]]0_h:No1^'6X Tm Mɤ`S)J'4|q`bzg8~OpE/?6^7GetFcϧ|lTk,O ?XoI[lQÏ
xX>]l| a><o~3Z_p|FO,aph<sk2M/`>tIUnQʍ>,6<ѧ+7i2 n~ n:8^q0x<+G Tr f6T}x/|L&iQz*4f|
xdMҾLҩ&#Sgz4VN Wn0ʡ,U?Sw /+có27y
F 3:1#ãe
ޜ bNpe0 Tnt i}ކ%X }AQ'Ugbp :|~&ǗmeFK [ljO ``]sv}FHfQɆo8(Oc>[6)[p,OY\0ZN*o|h5|m3 }\? ōY>\pR23O,m&3&`qC6?< Cczg3 E&Qz
f8\p&?Zfy<M8<p nxq0p >ܧ1 Y>N h|~iÉ7X #6< F nxftQ~OǏr1<S|<?-.x aqǍ+7<?1H%>$m
` ܇yIb g| #x:1Ǐ}zFce>M&, ie>7R5 [Y , Gڤ2[q\Y.0i4>o+3X: +a%綸/4A" oLGsso8|KKK 'y9?*i@ 8xSnOiPדMhOHBʣ0ҵ1>
t8=/,+˶S\W u͵O
N.ϖ_xq)~K˖_xqrN] m ŋպ+6NF6l`xqLhW Ω<1Aa[
UWdgjp q6Nݻcݘ"y_89ß 6wyy8lODg x%et18O@@@@@-`ϫQ>^82AQ [ 3xY\S x e7~s1Z.Nx)!__dIor( }Kr?opp- ű<q* J
7Uޗgi!ot~Y ,קtd7\_F d[9i3)`e`~8zO`x>`p 'Jkt81(O_n05:3 +wdwЭ<6#cdppy
f-X/<A7Ôpf41ݯwΈqqu"@d2dWq uS0JZwZ 4݃X;H
x,N0A:ofVrbϞ='GUH8;vp" s6hf@HeӦMɧIGl -3gkx.[]wj~ ,3#;|4}:9较mdpqرc݀Utsz
0ᇣΏY ٳgw|s< %Q gH<YܳʌDtx3:+rxWމ+V Ч]fQc4¬A
F5 >38]}FOler(Oc`Q q(M <
g8\xx<`Q>6e"7+pYņc2y FH|X+7J 4ӐQz+1Gv8>lV\}QCMݻcǗBs<[lI&ɨQcmcdQ8=u˗m8! t<_3+ax7J
=Гm{}=i w7Ϝw$"$6"$&) /FN <绛VԷzUV늾=3ѓRҠ[ _T2`r3=|]OglT~O6 RU3c}v3fsBH#8?'}̙ꫯ-Ǐϩ , vA߿#dЂS=[d3rymVyeFO+O'Iw-kPSix e]Hz $J. $> Xf 381660YDLrdp
- cy~7+| :ZN cK4[tG4gm1YȷWeSf 2zAVwx=lzR-(0cg}hL+/gˋ
R?qxQ^Vf3> ~bm65Sssc;zXj Ӫ齕f:sУ 5 ;vlGFǍ1KqztΟ:u ͥ2R*G _Qֳbao 8X X X X{^}{|._C?2ݯtp k>ZtuqVi/0M
"$Y^ZBQyTiOGˢ2GCeh_ɵv_&***2:&ntv(N<+5,J\\]
u38ɣs6NL G I'$2} &_K
r?mGq2ilo& q\@spM<3~ʁ[p^ >veQ/^grxk */m-격;YGUT0;wgyՕU.m
;ᬳΒ3<ӽ̃a>cz[ -
&}Tih{Jo( V[^.7꘡T?Қ/h?I%与7# :t2i81|hrA4 f̘80*FҠ<,]T>OɄ QGE@]cUۧM֡^vاX>/%m
>IG6֕ΚON듥.cRo(IC%=TIDEB``w?ؽi yT5{у{Ɇ1i &<>[RC&׳VljCMPS҅]&tWfZqҕ&׀loe+3_> Co}<>.1qx݃xu2;ڜ~L ɓovTγL.$ O 8>'p$/ -[ g4pƦ7ov28c׃F )h23=p"9_~&lNLrmۜcLplOU'_N4\zիW/, >U?SɃ 7X},6>>~nŗvbP/|7|S^y\/11qL}3 k oc7Ojj?EARXOIF6TQyBlǙX~XXe;9 7;9
Ke{CZڗ
Vdz h
&Çw,3EO?~h ښcRѷT ֝cȑj7ѓnU0ٳk$tˎbۧ\ 2 NnB9y憓ꢃ 1 |Aַ.,n p.h<rHw1! ~"f.>OQYYޑFOc\uD' ד*wy_>q:rQ&/UUϣϊ& -"ݛ6 <{XYdlx_E냂rᇥ[xD
ey>=9K?//$zq5 / V%9|:#i=\Oϡt@ST Ok'th?8,`<K[ ]8z)_R>O
2r=C<~)+7^d8Nt7\1v\p_[iExS_fg? 5
6Ȃ ؗݑɥ>+Wu hgs;d^1p GXt<[> ik7Btwȡ ;r6f/m\&݁cMygkhnl^j<ϊ38Cn]yWd&u9$-ҔX"Z~-5WvE?|䳦 v,nygeʔ)>裮Nnf!`?oܹnb ! /DZnɒ%O|MFot38\C_]Y.ULVTi]WW+
ߖآZw㤰@v=ODi-㚮FN: "VI_91 }kB 2\lLڵk`Y2.gq" ns鸨֗9YA :R 5d> NOruii㰻!~r:7#o~xf,q2 @ IDATFΑDugl k<znkU]+F;? Ⱥ(78>qq>F s';j^d OB\;vqOgg t:_|EHr- >M*R!sI(Rn b~Y˜km_G_춺s@fIv=̗K/=y1x}{U|; }
n'둼wL=p yϻI;OЇTw,7iQ1qQXé 31[\0ob:1c+-NE]2> "ʠM{Td3IBУ/ypx_OhͪLc< C Z >`b OCCu w> zc*Nٴ2Zx9#ʸ=UR Z@. qeKahc_lBc,4?t/`:a%Ow#~$;S|BWR.^}? KBtkRi]'M
#.|5}ֺS1[So菝iOژx
7{|ee lNÉziX39p:PQLa &+>ieFl'xEzۻP-0P^5vxGU;}k2O\ @dɍD~B_u):03F0 7l
y̖0
)G
[J!Է6u֭s>.X}ښ ~fʼ3 uܓ<TFRW}X }I5"ޱV55-I~tJhNkNitV't,[7uI^QL2UF ک}cwX 7RGW6PO"$Zd놵ƺRw:c Pqk[m\-{v YgΕ7ef{>NOZa+Ky:7uv2}Y6[[]|p}xҮХ
I AovCk<Nl Dt19>~ƇzZH\c: -@zƀ ^8D]wuz]wɧ?=/5 G<nP95 _~U/?)iU.;Gv> ;Az]!&/R_4)gN`T8iavقA J#
u_?a3茏o:{𨔔gܿ$=45gyuܻ{4^},yy ?]Ə}c}+RYk{ΤCX4c#
:V?'uE V^qv
}?a
g L<ÒA?cu78Ƌt Kt5{
R}g
ѓ0~MO~`8Ѵ+m(v&0QwM7w3t-?s>rׁ
EsWr+smY4~F՛~`7 +NKG k5p;R͝I%f5D{0Ŋ34ܣу~MH {BVR)-\,,5%CKkrN/żbE>8f k 8b/j]q\ϗKtm5cn<Np2۽'Ya6L9gG9p~" 'Yɇld$W~B/_b= 4]]S4e;#.8nf0'<ps uh;OX`02h Eq10
$YI! o* N:q x8%?Q<zs9,/
5s#IG^gkk :SY*+A?G]X h]NU[o' DO/glimn+/ȔY6k*GnC' ;dM;嶛oow?"#&ϔr]>p̙4J6,[,<̘;[v{MivM ^)G䵗_RپeL՝
tAh jd+ecd
L:[Y/ᗓ=TLU}vTn GHF ^z
XIg!A?*;%߂6ވ
x**4QgriwpY$>%m{DLƝ/cIe+|r)qo 4} ι
Yb"C<3};Z ֪ϢxHnȶ5/ˢ>qҿl.?wOލ~r0ڪLYLFLvj<lckްMwq EyN Pѧp(plLT` Ήe{,0b$N/9I>Me,ȖvE9oø,⠛8Zh+2fġ@1Nd,я~A~Qq.Ѓ<c?=Q É?q am&\ps0WwYE=?]_N2Kf2lzĮ؍:PL!0_F< ?_z 8/[+Vp> !!ٌ
UֳA
9DJmZ"zTӼU'A*e<߯\rNLTlZr6_`cq s̽篵nxZl|*<6%%=X6>?`k ]=ڭB,j p*Wؘ>Y<Ǒõ]TT-W
'zN%(7$̀?A dvM.mq-Og.8 TVV :lnR0<pБ?:7dbuYd7ե9T>SW__.Mydh8q0i^kJ!;2tHw3`T&_|VRvY2kJk
Ɋ륰BΘ{ >@[Q֮\!V!Cȅ'U;V?C2W Q^kX\̜/7\sj 7dÎ2DZV._ȬrlF+ߐQ_[v6>KrȵΒj\}L:_ zɸ#cmZپi)R[O8n-6 {wVG@;]o=YFYb՜~ˌSFm%PiS'K2] t@U 6ʝpX\wVRTN+6Cm =VJ鎁IctH 8{Aojddx)/j QW&k ȑڦTN$};dQ=ݹFk<|tL7JtSvm,7o`8e mig!4DK
uR_=bT 'kmZe) ٿSw: 52d In۽Gk'Xവ 'nPn(2[Ϡ<fyeGh<}X6鶽V]Wlg/}R<AHO- *DZ|LJl#ҢNIkGd|s H=kypx` RlQny}&y L S="W9ОmfFiсSeԐ
]l{ټ}n Sʾ ٺy ՓfHϘ"U{έRPGf1GsoYq\wZ6i3j0̊Y T~>G
8otk9p*3w>9 \YVg8d62& >Lq3xƌ=]xw9ݗ\a} ;+ ;CNV ^RKL]"8ԓ v!`îHƍ_> 3f7CqP=8QC=38_.6nhexFİz3 d1Ø
['rY^E/lkG 7&$ uhҺC®yISFinmsȯ-oZ>5b>7$O )t̍C[@/m>m7#8ۀOAr-q4 V\<9I 8uv}DydFGO=&с~. &)i ?u:9` zЧ_х}}6-ˉ t4 1D0[#??u*z.3MGɹ ï$ ,?Pf (7rы!gV4 tnƆ&)).%/?>E,oB~q5}@˜[\+y<t7fzT>ٛ'WuL>}O_,_#B_}ny'n[n ]OOW-~rG?"k~w,W'ˮыUgͥjk\}B5{NYuVQ2~~P ӧɖ7WIqc:3mn(Eud*Yn'j@B9sӓkdD"dCL9|`+*JM#2oKzn؇ +ȃϮ?[Y"˜R$57瞕/Ξ,+_ ks&
'~s9^>EΛ1J^~wZztYjO̝2Z~]i 2E {aN JEȝ?o><:jKr;qq -o{|A Y X\<R ^) 1M5}@>tMRs'dˤkrۧ>%7>*3ϙ'M6뷻]
"w=Ջ%+䆏~N-' ~PceX<ȣ:iWOȜs/ԾH#$ BxX=?Ϭ?wڃ4+E@geAB.h x ܛ4qvڶI&-1ȡeԭْ_/I~r$mEcK<_G
`>3fugw.yY`@ OV $qqYoد@;[ WЮMУau<>
r|*Wϑ^j g_nR֭X"_X&Ϝ#[_.'Ţ+/</\xXLc_09n_ǐR#o1beۿ[
k^ rQJ*4<~qwL☸k_>i&xrMe1 <y8U8|64^~_FYL05S\fJt`}l|i<daƣlG1.^ G1]rA-匱nS{c_v%|{s;pae1x9C&×kzYLlws8;[ݡ_ Oxh ;"xpϣ/A?";a$Ҧ9Dc |vyBs`_2M'bK}w$ҼM97~^L#eFyouYW:Z/eIvjRfp zcoC:QwlM0h엑. se*=0lfz@[i6]|8" ǹړ/&&}g%}e} .(M?kߙ]gǪk |()D/~4]42!Wаl0Lps/e ǃCNtHAn?*? sN$MHe 9)ԕ1c :] T9MƩS;Q7 =T-&Ek]Oo|\*_/.+G| Ft Ͻ&[7kvf-U̚:L^1oq#Ȏt
u7W[:h .}<=HWx19wl{s;ZŻ+}-屪Oo$* ]zB}ĀHǴ9R5u-+d rlzmstx\~ 0qn="9[qmuC&.ҤnЇ:4p=r9g =)ojۏˍ|T
++G5r8"7,vEYl5z|Pgˮ u ;$4A'˕zp]wTe^زmR3su)4Rg2kd7eW':[*)/h˺
;drɘqfOUٳ}N&/^`Ww: vȇ.%+˯.C2we^z/] !xYA=wqlA08< v ?v4ޘ:_RGrL78ol >[
g" zRS4KryJ/um(.p{<ISwlmKto( =C}P^ _W~8ed uXWɊW,/,( +W]_ JۦۤfNVȇo\'HG=?L<rn i#V e JJ ># & ]̟Tȸ3c@uӟ92>H_¡ ıE=%/+UU}?nƊcBtbSYv営ؗe0b
ԁ1 8+ 6dȢN*,[رkޖy%<&8r}%Ȱ8gꫯv"2)&Qij"kLDŽ|&'Ѝ&Y/x_#b;
uLp0q}$ v$J7<? MSo=h_mnڝU_p}~ ;#/ pcs-UVV:~L;߰zGT:SNq~IWs5e.Q9Uϑ~J3lOɵZ *LcՁ>8Fcq́}-h o A SԩrӋg&rK:^VɄ}ɧ&3
K6?-)J JI .vg8}(?}l v[- i !O_qE j )v̉5c)n0A&ECSA\Lt2B`.^RUU ًZtU
K.4;.WGC1~YhK<%/_ZtvZ_JYq{̞:1/_O :M3"ҁr#r˧>,/ȉ3>xm@oT#Νl=*_xIιfY#mU
4CtHndđr`Y_VݺusBuLKqB߿_u9g|I#+Ȫҭ:?@o
ǥP[ }
)cU\+eԚ^^ tRK6CtR| iv[1P J>|}hu #M_}fW 0K
UIyPݦK,Fszk!Ckߠu[OA2">SY
]r@WĚ>yeRѯL_(I|iQꜣIn ߪ L߾^m$ =Ag8j e2iX`8u^27,hGi&ea9wDO;[Xo ϗz$vkK=WF7_U (ť".-/T˾{s P][Iۮͪ aR'*Վ6'$89w pm!zBo}&a"sӛ>*.NH}cB'[|FNy V:ٲv -%Q
ʰzkCԴY!@9Z{P^j)Ò-j!Rv1yc
wvϏ#+_W3I 0_\K#\ˌXqB/ *`x8R #ۯ5mବ\w gfnK5k05^I傃=%'Dy3^a"t'__:}eci&10NvĮLzf,ߗ , ɓ^
^t6>;'{7( ,pE1;vFCߨ]}` ŵ.Y.%ٲlɖ{ly@ < $@(IH^P cnMnj,|HsWƱa֝v朙ofgL[M\D rbE;#X^QTy(ؔǺeNNr560IkX`;6j3
АFbN_Q'Dk۸ؒ}+n}"ʫe=*
njs@VE
r？qQrˮZ>m) ?6Ƀ6M&":e9VK8tczL4~_6 WYo'lă;>؎8)g+##S&_K>ƗmزŝR+L5̄6fv+W ě"%=
; a&B~'-eRm=cG7><Cʗc :Zmj1^=EMϗഩcLΗgI[18y%
X8o>*dC`矌O_
O$ǙPz9{E|ɲ58HΔ4Wʪ $:vUcq w/uIB`[d`ifN~zhRˀh;j rc dROfm!w#{td7h1gL *Y҇J1waȟ6
ur3}US<2EW]Qmes v,Uj ˭ |1aw0{\ u", z*f u52&qYil(dee
@Nz/ iƜf@Qf RzTv6L Q'*\9^iغL:3p qb˃6E,/xp-֖sC
l-ZFK坏N'[:|(KĎ
K[*Wp]
er } '
F|B5b#ѷ{
Hgd7'`@뫞9s!D@mΡsÕ 5 ,pw4Ҵgw_jȣYXyo- asm2QӚӞh|g ⇞O ٶ&a?AVej^cw% nRF~~xPQ /\9*,mr|ǟtzg1
=!ڞ0(6$|;YX>m|/h3 1f6!_vCyrJ)-)V*JD}$yz)
ѭm5a؊<T4c%9 6Ug:fS~~8 {<0ǐjȓ|j6?Mtj?W29Ȳ?w\ÓRq} [ Ϫ aZvf<t &n O%
G*"
O-~T̻U2; WBfd)#ɴI.wp2}3'y'y7^8ȉnC 3= 6q%sb8Iy P<4~ʣ,r/wt^I4|'qJh lH2|W"<d
9r9we3݊^ `: g I"I.R/(a?I6n'.kO[14VS/~ h~Q/Wei>Y<wx>nI5_A`j 4 dͮ:ydad%e6/i Ә ZJaS 3)4zxV-5 3͇ ZP&~hr(i9kŭF;De"Gw\x8Sl_eᖗO#ێG &M[p3p`\s\XT<4()ڂ:|w. )RIe!=(~ګQ8O5`w{_߀ 1V 2+oݣ AVwn?n^s;Jnw?YϹX. 끅 Ƴ=C
æj]҈sʍ/ɶ] nĴS1 7On xǢ|"losF|<JJZ|3xg*˷5iv᧨6HV P!i
&0o<ŻRz$얂7ayBP䛏Î07x\\&;s'3O?1o ? k] bPVf
E9 2ti34\2R%g?BU %IG\lX6c;CՠZ~PeqM2[6c(Z1 +
pZ3px5(QvU4 caȓ] i`֬O䮀T?ǴcNYڊ l}v|ແW#nkg8>$n- ^' A:mz#"O)7=lt첩 8r)=RdPea@C #˥kYK~i-#|Vw~}MWf
?[o--+ny1-E >Ht.ۼ qёrܬg oG Lmö-r sgB'\Ai IS&WGl 8ä_-}DoA[Agu}!nG[i[ 5*]TP9XR ܞͳlg\IۡKj2IOeۂy) &ӧJ:l`4_m
M9, 'F+XNQ㷩Uҕ? Hq|HcQ孲騨R!ͭ,7'G .^qř9a ( eVE~}J#馡MwV&rfy F ̡K9ag eB]lOOyw4 ^z$,;1[9(A'@Na`]rb+??(|; OiM "藁0Jdy $jLx? w\>AJ,n1O7(~3OCN_;~>oڶ5
ynѼiM yn|s_3I[F|fXT;p8G<:cT.i}79=䁼Y
>S={QeS.~f()5N.{e03dY!`n
;+| g}KV2;CfH ;=@ /v4JK
?pF[p6 vΜ$ _ɼۼU\<8i_ ddu_ r!ێ[PG? Kq Pe#c{+/ÑN!Q'vУOGND dɌc<_nR%2DLI#EVᲒկ?OŒː5 <,d-YFy*[
(Mr>\:Y92}&*\ !7VLrl#g !}%3zXfHyi>Y9ʪf YO
D!ĉr!P^X4g6RmMRYaT_\13GgWN^}!dWZ/ "gs䂹r3CGM6
{!S."1*Q>b=rz)vDO6PZQQ8y
6A*lE6<f $r#c 4+I&l r32d* X^CakIs̈́Ir, I'J~d{H !1ˑj 7 c傾xi=>>a~4q 4h+_| PhDep2 l1Q>T'MsBGM~|pr~h|-teqΑ^ϽB!!q='@\KdKn: z2_ IVU1_4|Fx[ip-0'9v9
_$j%5G@LlӗwD :d7zfvo%eC#RV֡@YZޢhȅs.ƀi&Vb>r,h$]f5Ĥ~Ie4~9XFۃHAn8'x㎖|^yW<9&䘏9j*{,3Bǣ6p!xwuG
S|8f|_S eqш'Y$'ZlD*|%'s GוpݢIe u2ߝ5f,ĕJ*#=ϻZR+raxn}'BMAl{9Ե\'D_U||w=wEp. 7¹S7sϡZW5]+rLħ|VNXO(MrSOA =Io3,+'UvG{Xw-+ƱSb[Qɇ4|439h+әvEZ )홓-d ˿'/ PF۶bVn^m۷atcDAMp۰q!+mPldY1<
+38 g8m<Y{<LG yv3pݜEFpNrv,l`ޔ$P lMEN8r`! ]X2amk l&BS_U_|]zqo *my]])y
|^XdBawF^XSv|?3Ar8(%طoÃ2_ٟ6];G PJ Y)+zKW"Ss00i%ߏ^0 ˞yۓk?uH:Ijؔ}.`R4F4 ͯp;ߕמ2"s M.=W* ˨_Ocsȁ.o{vpDe X?sf\űwp%ώW9 ʐp; h
"k )N(LJ4v5M21Xy cy8\ij/1 ?FO|긊y*_͊+WT<L<sF*m0<y~;3?S
kZxۓeT[|4L8mC SQ랆w[C,?IyS?*'h.`hnҲjRܒIH:<*dB~ȗ g;AxNɶO; ' ?KgpቌQГ>.H:J^\5ɂw_ ߷ ѥu$SR)e?B|xT8Ny&=i9! |frF9)P/ہFi]pG vb Y;Fy*]Я4O
E峤صL q CNvp2?X4<A&zΑ \$˲*~a
ʆF
IOf͒\sM
#=re6/ǢeBdax (_6
`JR>PV]Q a6sƇQncp S !C>I#şŊ^q.RDN+\~Yl~ .ǎ#4Azb϶SSd{kI\h';LF1;1o[8<PA
;<R6^y* [icw֊\l;?)6%9G]"
Î(Hܴ, dT7jk aJ
mWW G ĝu
:3u]l
$W>-"*x qUJ?U*y7qŴjHqHݦl:〛
3FGM S6WU9ձ!Çe{]Q m9܊ Ǿ8.8Hq~O¹RIɁAő
J'FWeՉ&g_ki=`ȃ0e"%Cy!5ۃ lK|>8A{ Sy矶v*)kL? Ƿ.CT`|ͬ)aD/Oz'yp2w&,#
iXF_m(Z70]7:Vc<ee 7n/1;jdWrZ\&y_BB"DWlk ,]k֬FoS#cxjAY)LCXq, 0.Ѱ:h :g帍*@k*'V
?h6"v*ʒt+&bҊV0AGp_@ 0^i4gCZK%P)O_K 㔞4cZ'oM+~J -e嘌~xm˴1G"r[bZ҈ï( 3-it2(TZ0bq =W;cZ }Z>AZ@ >y7{Æh]]8ٝ 1ܹ%?aL2Z$|p '
:jYDVh)3`Y4-fڠ_9{Pcδo iyΒc *l 26s1a*ZSW IAY}TNWmmc,yxUǬPtG* eL #+^ 3?GʡtcZ֭ o~5oo+@oe8wҴǟqlC{Nk[ӼB@[Fmߗ*(KwR1;*s_c9/
MOFy'NܭEeƅt &+N beG4╮=[)
dR݆"y*n =ʼn /}VYl_'Ǻ/Es,vg穅7:)(= *ѯ f:vRLMT9KƙT& <s5GGc*M0uKJIj
/DK|$ ):|_i}i
gp' q d|~-%/!fgtvX[4A~to`"ѐI0!iՄH`mim߮qv=C i__{%9k,'Y^17%Ϯl[g٤0>MkMej:t.}eGU4vzE+
i eؾ 1qf'LZW?-UmtLMۑmNqH<U6i8T^ Hi0tnm782SZ[y~S2MC^6iGˇc~5-h&ۯn2c ̓m~un0v˦5iLJ˲{$d(oUQq2hkٶEt(/hmRv0h]yT9A~ޑ )/4O=_?Qj (3+={4Gs*0}vŭ'ͬDc<s6
n ;p8 A{Wx|ӍQro(] gr>"~`CA^W*wґ/"lvi4ekY\y @ IDAT3eV{˧3yJg1i}ޱe:[V>:1c/]AɂrT?m)Z ItњGcY)(^AAͭ.vGm^*6"!Fə`^&B>czʹ6?QjV;Vik\0\j+M9vVz
S[i3&HP~hItjk`kYO;m2ΛMe"t ?[-nQێk|0Mci8iڶȶyi5NeaLkin;
ÃFt\ۭaLk:
y2Ʀ Ʒ秎r4 ߦ6MP`\{`:[ģx;MVi36v<EI关4oȭ6t ߃ 8PژǞ{BKLG<'_Ãv0]x
&K#6$A~u6~-J6:26t oU5Ni;5uO u0}<Ύ,c<SVWpWW|H&eBiW>4h:\wIgX5
ٟw6cePJ:"PY 4hY gUTkzڜ] +ne`Lf C!p8w we~&_UjwU6-{L4!csR ykhfpѽOdY`YᾯWE-*7ؖLFg$>]
S ]-+wW{eQxOyGTЃ(<ijQYѶJpg MܮW2mg Y:w4w{gWavH?n_$`; -^x QX4p;;(~Ni!]&Wmº&:/Gɔvx+λTf#u^R+ѐ?uŶFQXWd)-aAA5+-7ȋqvaeR>q ;iTy'<`YHtۖk aJkuVKhZiIav{gWZ;H|4O4L0~oC!U@.6}/*>F>+f=RGp rk!W/8vn /#a<
iq8 "p0;8:B`l ; |'84uN*-g H{ 05mS!8o _ #*-Y.#s٫檨+ C!=E|{*"pg U;Ɵehylx{2;cO"w_7wgx'?NU^GJO=iʗ<v'4 A[egdA^w )EJ0;_JlYtiVm늺*窠k t-*;p8 C!2#/s] . SK_5_
zW3NGWét늹a<r4_p8 C!2"ƽ_Zue_|UN+ ੭ʸFK'}hڋ 銟|il m g?{/;&? rKcO 䒷t¶ch<l9AGGAzo
Ig׳n>מNgg{:7 Iy +?;f|Яi(^:ʧ*ti=e: OW˼t_He(>R
k/m{q~_ (DK-=^L dELo;ȯ3Oz0=4{ó=y7rUҵ:Cl4՛M gql; 6M$tA72j-i,^[;b##
r!p0#\{UWW`_'0OWx9>"ڰkV3Ż*7E#W^]Y6?!GI*!W]Y!Y4p\C!p8 C!p8 ?$C!p8 C!pDE)QqC!p8 C!8}a$9 C!p8 C *NA
p8 C!p8 C)k'!p8 C!p8 Qp
zTh\C!p8 C!p8 NAX;IC!p8 C!SУB" C!p8 C!p
Ir8 C!p8 @T p8 C!p8 S NC!p8 C!p8"иC!p8 C!p?v C!p8 C!GE8 C!p8 C`!p8 C!p8 {52RDLL & k,ޤj]/YKNW C!p8 @$ccNǙ}roMڮd/9]-w8 C!p8 A C!p8 C!/))i#JncWwf"U;Ch"^"ٔv f0ܦS7&Ӧw Mi<M[4LJVV A?#Elڼ4^m&[Զy)Ʃ FimۦJCnխuiѭ<mw0;]GAZOvkSeжm'Z']4Ö<Fm9 ۴6κm^v`vA;Wykxg
' ~4Nme,OM6?uHn
M,3Φ?F -<æ8~_ik-ÔNF 4v5h+M0\Jo3F~V6?;VmZ`xG~ʣ(}|klZ
H0Ӧ6_ۭ0uw6.(Kөjk<m-uNi4
`AZS
5AzWzpu&6Q7`8#iX NHcmklێ;GGc0c[Ãy h`hz6iLC5ܖC ?h5mZSYӰ;wvٹ C!p8 C!'Ĉ}cp8 C!p8 =G˷(!p8 C!p8 hK! C!p8 C! 7c(C!p8 C!p|Up
W]9 C!p8 CF)t9 C!p8 WUjڕ!p8 C!p8h~@W˜C!p8 C!p|Up
W]9 C!p8 CF ~ʜym$Ĵ ;Le9vy"Y#j.(鿃=xlK-I=uYKp8 C GS
z $^WGn2@ gaN,uX/3A@~$2uUzW 悚v; `[;Jrp8 @gUβ>Xx{^>
>e1/`++绽Z^G K{@XʕLJDsYtp8 A@tdt%=&Xk7#)9
5H_IcG!1 3h{hnn3
d $㭈G[xXx>nچD4# L0
f3e.,&Y_l/ۃy
KzB2Xzw
~ 0aXvbҾt> ;)Gl&L{ *ݺ .FS\"bS)mJ|gYׄu1#ǎCf]tOE$H.!p8 vS)W/WI@S=RqYcPN&<* ($&!X8%|ۿl? XARbʫPRnɉ|5^ <AdtKEz, 1s+ʣE^9[¥?? '
L68orM%:67g455GtS +xxJ[n2؈zSOṾ *ێ3R5qݷ㮇m3 )
z7g+R7OFK
zk}l߰
'rUcj3
zNϭ$/KZIݺݻ\2*xsbݒ#R\C!p8
(o[,(a )*QnW$ dAzE2I<Q|cdKtgY9n"+s)+/:hkWQ/Yu߅ O}R:Nģu%DPYVa!O3ܭ 6VAo%@|c҆kU&[+,:c/WԸN`ڑs WU4۾^X4w^ķix<0_A71}]Ы2Q-?{x[h<O FGoϝϻϞOOcxG,O -)0:+ĖM>؎?C近-e54Bړ^xhfbqx %3J M#f:cTnk pILUsgyΘ0غ o ~q#Z6?Zŧ5}rg g]eqpip8 @tm|b
QvvNR62呷ƛ# $ \an yp o):xD@X#> Æ
6nPrdl睄yL6+eLyIo0X
.dJcokz m=BjZNP5*ARLӖ" ) yUTasоo`ń1CQVل
x?KcS-lZ&l(UyP HL5{ cչ(?fQ ۖ3yfH|e ʕښQ+Xlpf"i++@LeIV.W.tAaY7pM8z8nX،<9ӚqEʇ
B ΦQY
IE ' y"jc, G:Avay)<MHTȊyz_!|d5hbbK 5G;oaQ|=!|SMOE>(WeQ>byME2\ @Zۜ ~ C!8X
R} jguOѦl
M OeR98Q7 B8oll2$+Ju GL0' \ KHJ! ɉ/WShȴ{&嬩(_qQ'y^` anߜSV#RNāJ*qmp|2V6 F䳻rgxM`ԅ:EoNoOk`[/JX<mD2I3iGCem"3NR Z<{XTHELJ?; ~hvqܴxjDѮ k-ZS Bdg%.7 {#RǦ5۫/doCib*J +GJ >MiIObgדDav ekmLʼn64J6K9L]IDzl<,g%*"dX( q2 /ߒƳ4>F~Oee!흄upCVjH<̻oz_|L[څ<!Zy\hy圖&ʶE3mE Ƿlţ!g<lol[A҄3M!dv;j9k 4r4[J|=.]I3ŴIFO-C #ZN=?'!]LYmDOL"%?5;!p8
zԩb >Dj V,+Q~#j g: #F``Yab3P -uXf
b-VZzI ppޫw&bȐ!(++[Uz2_rV!$grO> 6? 8NĕW-[EnGNCwOˋ6wá |KhmRm݂j J|RJ7d| 6{Y O:ei8!M_Ҳl6w[S
0lэ` h6
rQD@ Yك0 ֯^``[Є~v7rpX05cBb()edq~| .: 4ɇ#J*j(Z\ҵfm!+Y&ᙀ|=GhR5J
Wb▼g
ؑ3k ס1)0fX9lE6(:4 {hhKyߓ@0L(kꨪov`B V6#=rd=8{(ٲkmDyYYQmtbc ~0d`l֮LY2`<lYsG"yӏDYgS?!Xfrlٲ;* 2Oe$O6 $F!7;ӤQ%AmjG ,^%KW|p&a`P5 Mw#A
n8y?S ,OMx_j ]+cnj a9U[ K/A<q17aqtq<_U;hF&<,߆526slbbXSW3ZΟ˱3))]Q.t9V|o5
̾" 1
ghX*,[U
N}C,F>K؈
6bW2`|CCjtCT[ k˗/Iզ5x% FJGHnڙ-N8kbݺuҿv'" CoV)wRvVVZ&}fvQ/@<igC
V~ +VRSS/ %O12Y! aȱ8btMz`ĠU-l
Oqe. 1\+ 'j`GVZRJlT@E[ei墿\P/4bŲX`.^9D͠>F\"-!p8 8D1^hJ z
m }|GF4ߘ-ޟ~PZ3jΛ=k^EMI#g{ˊ=-}0la_}ëʳ3PWY==Qy ;ܓ77\u#^EwY ~5d '#5 Jx͗ o&Ml+o~Ы6
X돷8w[jF?a jBe=_t7ohuQ]?
K?1c#Q[<FeHJKض&DJvOxU~_#Ņ#R^?f? >35|ޢ
&;#+&l3Ls7=ɐݏi|}ҍwF'` [47zo> e=;?>[O+m5Ԓ //3 ;^m(/~FN{-esظj/ȧ{yS>䛡5?*"M;l7?/O tjPc?{_^`K kw[7Ԗ0~ƲJmXwh> yBe B&m0 oy wɇ'PZ4ﴵ|w\xm0z.=|u_tO9K [Ę=
/?]t8
w +g. {9D
9{CXi"]%EO kdK!ޝ?w<c.7?R Zo]pke7-bK:w^Ԉrm>~sWf;gx{ i|oݖr%Xg C!8{AAYU9,YC/o6!-aw=/ҋN XZ9PϾ3/*W3*fcǍr$@'=g¯QKA# mxzowUWYQ}\=K P=s_
t(5r7}wnwXndjv|o\3ۼ&S>֖WF7~xo15[} 뽟}Ʉ`^[Phm-˯. ?<c{RST &3 v' :ݛ:q K:Kt/[VT_~3M}y㻓[_*5~syn>~ d?Cff75x?`kY
I1}zp.?ϡTO}B4. x /ZgBK
2!B4OvnZ]u`t (Ze|
{EAgf6;ofشkww_т-e(-Z}3_X/>3;-e5owkQt$)+>wKC~0g0+!}
m$4W`
4\X;ƛ[ {ޫ
yWC:]$'`p">z >[`I_-ru
{ o7ZKpŬ7t7=CuoSׯO>BGyу +˾zɖ| n}?r䳘[J`}5o"P >+/6{ZWﳜnq8 A@(3Ɠ!ivSobX)o5}SXUxw=FN
'W| ƯSxC1EGg = 59IVaǟśWaCs[ ة;/ڪ.|b0y̛HO7alݱm#ސ<w3U&%{&5ij3jw"ExGF&5x g 9ޤ6x) >
F 1}2z6flo~rEx[cFc~qϿ76K 77^<cXB:9F7*lzH $u"o"~xHv'Ƽާ Fg?8X7yw<
LDX| Nj\~Y
[7÷^$9:g9;{ 2G t
alV> h >+7ށd}M k&V.]ﭕJjvf< } ~9C<k'fOu'bbdVaC{<;+lQ n>xFbtr,}K!- @PԌ^+>X21vH,^ s,ar)5Tyvrsjn>ӏ;~e20ap,X<|4SFjI\^{َ 7` GnVlY?^`)/UW~G]yKs [xG6_; }d[+& v͞<ƍ z&qOpYZ@uxu-,[ĸ˪䲾 } | Hջ*0*q X M9 sg$<͘6N.ܼ?[<,L:
s?|.}49VNܳ 6?-k.9URvXC&Sp/nLvf}2SBAN:,#ӕ'zC1k+GI] ,6OŕCy#-Yb|釸
MϰF7GLr;riYxnܵŘ8a QZ7ȑ ˸$VC?qرi%M٢.O$x5 1yhsa%#Ϲ?R +|[.w`)?o 'wm+Ҥ"K ;,93-w/kC|RO\'0O?i=
~1$'C0څ9I7~ C!8X [
8`RʰH~ |rp^?mYG_rnx1mp8?`R!{Xf HKޜ}#ʫAvU֊;܄Uۤ,g=_,D(ͥFAOwIHMĿEm ի sumE4ɀsE9n&`x~.yp>CS|\X_Gד3G}
]x}D O_,A$Yݕ6L&%yX|qAN97^v*>(܊F*9-.@J\ëBQο)mB~vG⤓NC-q
y ]*x S92NM-(O
.Z;W &"m
̗3EAk 7oߊ9#qمgc<7v69i|#ʉdSkRq)g#i>Y",<O MߘO<
'Ć 1~snY|ظD)KfԐ|l]'H#8
[4u3ĝD7Q;$캯OJeok;+y^BzqӰZ\l|xѣP'n qCKzUn; at>\U=EsrJ3.`ٸW݄k }Bo{Wo TsrKo\e 乩a7JvǞv 90HrJ>K1xxQBb,sWop\!h,/Kx\~Bh>/Yb?opŅ'r` a휣`?k9O5eR3N: 5
9}2rd;^1,xB
&p&cLn n N f(dG<q8]ȕ6ϻ2'
,K=ӎ nCKݍ} <qGhaGNG1`@Hf&fy.|7w[PYRF3!@ 2d* E_?EW_G%S،J#7
rVC8rQp/ F
|Xm瞂Rs$4
#1C<!Ƶ 'SNʼn
QƓ{/wQK
*p`b~ 9ㆽq8 C E`+ `VT>_FV/+(pQF9\!3N?(5~e5|7R\"/U;le!o܈EܩF. |q[&\%vEkd&) pᢜd /7&}ٸ=DCjސ P9OJBjǸqŏ/~|
r3{ ٮMҭ֙6l܄2Z.مͻ(! 5~yR&~kz{\*u(g{Xm0QRI3rXL=D1Nμ O$t-guOo\3%4}H-nɸ B9' xALrƅW 5Gm0yQ^A~ax}g"UI[JU7EeqҖ-;P'E<I!
8Kν7tL$t7\qFm?$Y Dze7NJ{.we$ "QP
l0crљl&[a >9&xTѯ'^ IS}D4u[Sx(a1d$#4fCDD? d^pzQS+>,@ߐNMNNI.._I&?LK{ hVTA(d[$7jKVq;f4ZZN8S[߈oC\蘚 J!e @ln[CƯr5b#?O'K?3m1#?POS'썅발sbj q7 5}??1{j\p1HK !KPLn7kh,a{-e<x墱r) Mo^c0~97O:l5]&Af@ֈش}G6| VI[UrNT v9xpHFT(ug;*2/["m4Mul&S?'Ț4a"HRo q8B|,mXҿYHw|W0$nqhK1qX l[+m1
zrcL[A_Z?s
P0/`re\L=TWdihҍ'Mo 'A%g C!r!6:[&L.5I@bgUQz'CtLO _?Eā. sZcZ!
EAoG＆?? ~Ȳ6jY vJv$Ō=QVV9i)trfĵI!B$;D(6wш|1V3~1d{+ 8x0~se o] O<W䠸>}sQsS08%+eGt l)\
o8]yXN
Hg !9 : 1
M>.r[e;$ Cb, ??E&6!}.MEN6Yݻ#eV\7M\n 1wׅdRIO@*猖ƨ[;c6eխYv)?d."sK1@nOMKWa[)m\wYz^`+-Z-Ãށe~&#ֺOJ2PWdv#4mձrT6vyf{CME1^דxU>o>c_yzȖ [cD6zڠϞ6R)i5^rċ;
/AgDYeUQ\; 33EeHpa ȴi/PȄȓfQe"Lnn- }N > i\^cVŎ[ 4aFrK>$I21!LТn 8r~D!p,YRrAtJȥx~iאܭڵß]
iغxFlh6N>}z@PSWU_|<ޘI&-+qM,?~ҖP"$m0N&LR7YΓ!W1b[vNÆg#Q M 7mu#ICBQsov%g_A|V ,}Jncdwg8C& wBgD
,>KĖ ι C!8 1:(Ah@ǑF70\h-ݶ"m=i+FVgZ1Ue0owzѵ&'^x<rlF1W6Zidť umD%rpksTfRP];ni܈Qp# :a8jJV?Ǥ)Sܹxg /= C,
Kw|mHMÂ^ЏOR9
۾a)~yO=$dmSHBAzBbTQE#eJel*%>( $ fVX7˭KIΘo5)S͊mMs
*( g~&QJU<8Hou.t] *yoD>e?vFsNƀI>I?~%1;oL~,& bwΜF#/QKl S}Wiv ܉ ן'x!Koϋ(D!V-X{c~3 VVEAi8'Wek7Mdg;}3DoDbRf:,gm}na*~dږVغETMw˕3ۊ_ad4._*(MQ~OR0%XiH*Jٳ<_,>ֱ
l!`Blۡ"ld3CLM~W<௶;\_ qï[ё2p Ζ{Jfc|W~n'LX=Z-0P^&xԠл. P>؎Dѧ7p+.7um^Rr QroyU\_/Rj_E cA:p8 )- Qe&N&s.lm26+OFYEr$z
nɨھC'g/s
gW X(Mm˲fTn.0N;Ͼ-3 2Ԣ+
-s3 C+mu5ìw^1 bׂ}iO/G#K.C]% u(腐;dŖ܃ e ~1헍r>TiG~| L_SGn/YtgsA~^J"@HO(i&}h=l!J_'IuF3 ]I=0IϥΒ$pl3/ڷdۈ9M #[TadT y~A=O }طю!NqT.Qo0gT km/͘῍r3z2bWCc#>RO 27
z2cڊ>*ʾ/_P=YUv ^4WbDX
y8#ͅu>g WS_r;ɯZH[Z]P.3B}GbRV]K \?;Ͻ ?JtmIȄJ:'iS=zg6>t
A(ۗecjb3weHy&BNQde5Fj-e]gz,2ܥ][q
wF._,s;KeD MshCL̞]0)\/FTV} g}9_rQCcٚ=wk' ~r>G7|FA/nہ_<6 ˻wr1n1By,FX[;]jyXiڭ Nm|<3s ɫyVc
,sr2x#8#0L~&ts-W_ C!85ΖAG2ѥ @ IDAT:"33Cґոu
il%M/4ayiértZdn[7 kD9yo]v)
)<=[h妵(:"[͙kp,9s *e5Jp@EH( !:Ji֯X3g^ U#ʧ\u&or\u%ekp)g
m>/]SZU\85{i%_\|?
e.kGDS,: UׯIrac*nM۶~}9ٻ7`r_jW_|9 0 q
&U:2 gw "7я }<12t9'W$m 43M-V/=B\r"잊!IQ>dVهBiΰ<k&e\
dk|/a:)!Y'4}Y u@3cV_֍N.ѕm'H6ex-$9݂P=?{_Uѽlwۻ,KK (( b &((**
+Et/,{ǘ{ę3̙̽9s߇;J
i*0 Z(}HKf,.,WԄ4{8dE=_xM1BqyYd g#(R+wpPGԎ:UQ=:jћ5'7A1#]Ǒ
+ԓi˚T@ZأN^-GB^settb]Ȧ\ґv!$'wD1M -
R3W͒G=Mjkwd!͡5RU9< ' ,h1JsGAn<g:~E$Đm;w?1?X;X\vGOрX\̇X*ɎG6لwRksqXX4ͤvs cmNA" H$'fyK!:45:,WR,# w<<Wl Y?r +?!>@.Δ2 3zhNH
n4Iv!H/Z'!z<",&M\^Mu|Uyu?/ HKkva ͩIͺ_bS0HkHJ_E%nǰm3"Z5MO aolILo@tgJMS8:!v
)IHHCKqq\ij;vVag<iӻ\ݳIfyU_& '(uFpQ'嚺1<S|O I +!-bڐ`t]:#Ą9- (B5Z=6 O
7 k&>ݳ[(9iJ#k w+iH
dwE9Y8}d/FM~+ۂi#>EzB8`e1?J% _Rt\-g
2hjJ2,$_<G"e%*%b4dO:>ƴJK]tz H "hA IqG9 `1]ś"hZI5<wF)5~3 V($ej0kQd\[:ű_g0vېDgzI(O eݙ}=(B#h}^1R[ՁyxdL84 /SOF 6dћk_L
CoHG:h `@n.KѶN~6Q?M 9ޮN7_Aծ-8}~, \0Yrbr?\s &7N xVT%NK_,şRZ&
. ]'csq t$5""YWǙUXXTGV!kֿd< DR9
-K.5lѺ?BBbZ9aϚX?&Gdc%:֑^j G [U Q.#*u'~As#4"_+Oζfyøeȑɸh/ϸ 9yd5>03BCT-$D@" P; l V M}PD+smu郦~a9QDĢIݽ}!x꘡O%43 N\\|0jٔV]ɷc|fMMu_b oR^'>ӬKN֫?.B J;z O=0nA r;zFSgՇ4&hcXnfcAF &aw"ZE!;N}"&\/Y9"4P얒UVMYd:niEga.] `I9Yh < $7EFيTPC8 ed̈\|sH@QK_]*ҙ~EIȀ$RxF du'lNhE H
]m|Ʀo8z) cpDNtb نOEd_<?l4 6k"FYoiYoR' Qb;xk˷_6Dp - =]:" 1
ʓZwR;7 #5l>25"!`]0
G 31"l`PQ$mi!Ю#) e9IxE"n"* ש&l'FY?OFH_h!8 QŒԋ9 W2+ѹCk k<T9Fqr۳q0KuG2%e~ <0`8x_GiD3DYağ 8=]D` 4C|:tl߮wOJd0JpL ~شSP?@#L}Ղ64!M4-5\ O J=Z''Qr*\i}J!;a} ,]9BC)bHϬk>5h[! p0\7Z<nDd۸kٮ+<
QYw@ۖxQ8y t$_Mh!秒{E? +' qd16:fû</L5k`hj,߭J
vd_ψ-8 =3 @ZU,h!6$'{ej^h`*m_J
, .2/3;vϡ.fp102d_#1wU xs$<d
:_w2R9y8NLm[zb&ЮS4X8ӓA ,ٌ~01hݼ)iآ0'
$cp-39~ :[2-9r g*?z,Pj M%/'J D@" Hvڊ&" ڼgo[5pU+ߢ=ʁW
Pٟh}t4IosJJvQͿU%wnՁx[ioڶs)y*d<L痌5آX 4o|O>w#gcEyN5-BF2Z [ͷ=FU)k`RgQJ*,WO)h~h%ČѯT>[4ӄY)e<g'䙲cHぉPl1A{K&oē(9>trݷްNkw晔R^6xKEZV)eHi~9zY-@LWߧmߚnq#ɣ ! (3V|<lXĤT(k$dDgгo(YUNYAi&y}5$kcApT(~DbϽʸ/q}:TT%7mR^k;+y
Fi
T'kM_-2cbmskc8[rK<zhr9)SԠorӮ+#xiqK&ŝ=\g z伞CyO
<ϕ2Q.by eʝuKA9CG%ǯ=h& YU gn3Iz*2oC]yذHq vxt5OyeC#L4_b?*}ľ*4M}V9o_,U]X\KVW"H$D/V1
?<,ѺÞ|$|vGT͡
ۤOF26`$9~{](>v{aCoGPM T-QS }*2HGj۹+tѣG* )* ɢ;GJvT8/>|
u
͍k`(&Mz
BAy|x˨Xa\Ψm݁u 4
UN,ml;t^UTkt > 9m/
|8ָwàb wcpN8g#6 ?Q%iʴ ߰0f,3&vG1 ^[uQ֎vi}nŠ;F`Эqzp, rf
p =X/ Q!} u
jFW!(84ֵ ;ԯ4r2vi ;v>s
&/BBt;pJhѾ^_wN
!ptNd50DEE( ;cb-D`1 y]S]D=ߍ`k[G\%RKu@pp>}C_& <|ؽPbg
J[\39^xk9> \La] }#Cmq|= V _uM ONB-͵2̜%ƨ#Kh* 6ڻ;>"ܛ4'>[G0~ (I<6t6;v] u2Hv _]DZ'p=.y%wqG[3>[kC \IF`6ݻӸp жԭ;7k6mѭ[J6k[<0Hݮ
]ruiӯ)ƍ _ _fn,Ix
~ l#:4C"1_/ 0w ^b z<8 ']^l7 [g<?>dTF!cMȮ:VyXg^^-dȌvŪFḢ֝^2t
dgҰȎu{;ga^= cѻ'Zn^ yX +j0yVƶDz3.o~BZ®C[ p(uUy.,Z K~t,d v1o*pqpg B|22Hr-IKKq2>>!Q{k6mݎ} ĭ={a з'iqzR iW8HZC^ p뭨}ڣ;t'}3^K27d4
låqd 1}ky C{pi˫D@" H$/3.64xEyy؛ϟd,č&pYNJbd#3+˪N c TA[fMrhUJj&U\W5!'(( I*WWa2O@idA0
ݝ I dmZh`! J)s 5.t
= ]Л|
#.I~:%.ةeHuޞ&g2cgTNSY"p%sDߚ{Y}&&덤sfy<%Y'4 5ՕEvN6A)5TK'('yGJ4)N1_h3'R{\؝\4aQZ.3mUϬVuwAЧE"SYA.xbV;8]1&!NAnA8_QZRr馏v;mzՆJz[RǨ/= 0㐑˒YHw'#ht~@oy#hhqzfV/\<wEeRPH5b3ԭ
u
Y*wZ^MCc,M BN&썎-抛 <3 1d#7
vA4d8Xō{Mv:
o1] [Fcw.r)c @Xx!"PTU49pBkK7-7fr0~3`1V+*i8S ?wwWmq K"99_w6㌏e>Q13k%vx ExT05O1}D[mc0 yٌO:}CU| W2Aǧ]".4JƄҒ+O? n"*
rɾFn^,Sd`ns% y\ D@" }n Fe}Ow=ƻ< A츚5U'WgÝ^74J'P\5dyS yQ|OKtNmҊo^&0Oc\M'uD4 H&Y<<u6(]M4VNO+#GAcrs _Y?:SXc r 5A RAF ^:Oߞ]1+b]B4 p7ygYs))|Zi"V_23w>u5RQcG+cx7ͼz|3m<
^~5pgp
%n>S:͟x)!(FSyY" H$7J
S<Y='hĈ
.O28'tI ǩ OD&jI1q
4 B 8N_iʳ(*m3Ph8?f<LE㤶)2O ^MiMW}W':9~uS
TDr AS]WEq'..pZmྡ?N"12rqظ^NӸ$pYK
qscru'֮r_AoۍƁ^Ve*`>TOmƵ13qZ}
ǁ0Rg"'Uk!sA¹Z^IWcnN~U cƨ=fL\zpXֳq<q ChDSkeD=zțr{ D8ԥogóFX/#b; 4n7g J~{4M>
2~0üp wBü6(i\g'Sdjfe87/4FTpgTr8^D@" HP@f$Ƞ k)OZL,XQ& sz]=Qė^yɛxizxMxEVM/3~~Hܐ65橱R䶾~7 T8
7>k64s no&iF[O}X3OpL;5o` V_ 1I'7F[ƣ6QcTCC<D?0WwX7>u!МnC{[
4ύviZj :Ր^ܨ,SjSZD@" H$wnwo_" " -%!k"#''
EG'0nÃq8cYD@" H$Dு 5*I }ldd!/9 D@" H$){_]"@s7`W H$D@" ?CΠ. K$htF@eD@" H$D([!K" w"H$D@" "|LE#ْH$D@" H$)]{N-H$D@" H$(ND@" H$D@" " kI%D@" H$D Q)#H$D@" H$Ww9ɷD@" H$D@" ?;ec$D@" H$D='H$D@" H$R@GulD@" H$D@" ]ߵ$D@" H$D@"B@
H$D@" H$+R@[" H$D@" HQ.]Q(4 79P L eU7azs-1ͥ(5/dgO77)#4zojj~ȫD@" H$? d6*)P E,-|_[ƘWc~I*A
qI`DǀIyShmZa<J CXL<BtES
K='P^sg .2HWk}|3|3==#빚P'V:4D md,/`iŎ1i1u~H-}{jU{&e"^H$D@" hT@G ¤nC/Y'u$DZZY?@WO}q7E2 B7EB0)e̟i,8 s^&Bs?<TUVfq ٘4g$VWZD7NK¤1
oy?|#fYUq?kWaY|T!JK00ά͆E] &idžƄ D@" H$^Q篹8o =ظxU)ptr
[ί1=?⪥s>$vT֨Lm~=Q>N;B0qz2<`km)v,xϟE~O7RU'UWϣB%J3!X:c =^Wc o4,ųg]OOOX[8s=q |("^y|QF7&媫i7f $UqVKkVWUU|lsih,y8z 8W`m /"ϼiuesOH@bR"%+ . 'aǚ]j%ؾ
1gI@4jjmMS4hzlF=^Iqx2,|S$Yex 6%^^$x*J
pTY9^Mtq;Y <`*S
%U ;~\gЬEs;z>'p'>
rp~am/wZ)ɘeNOp5x,rjʲ"=q{ _[{G8:8@(S'g~p Y935UL%W{LWgکr<BÛ8}S ̟ .nxV oێ`FZl2&UAVZ28p Nma+;$AM:ģH$D@" Ѐ>;>˗ѱM$V"*-MxOf9Mh<yD5H//O1-+A' Un%tp;NǦ./5O튓"wryLԅs~VwJshyE&W_I==^ O4nǘGL :Øٸ-"M1 Mة<Bq_qW^_K ++eܙCwR] 甇œlZ(RXT5Kq%: &b˂>u1;u]g|
RP! !<twW|N }'J'1mclql9tI37Sq/xhTLo/bp<
ܸs߀J=7PysKKX5u Eزu+ >ǖ%9紴GhX ? ?vB'n5`TA6q<~P<<}%&adžO"'o=^a|+ƛ n̓0+_OC p(,Μ<'u! /
mo$A8>9AÞBR|X;Fk]F㜟Kq<>NV(+3'[QaCÄqn؞mY߲}
'.'qQ]cei>Y8.x W_ <#D,
1ꮁp3AWX$%D@" H
k۫NdirXS_ܠuu@iQ&M"+T Mˊq!4#<v )0/Gx#;=
$X.Nj}㕚 {4],8{ЮkV"-# UE;9Eh g{!a6o{%c灓+MмscyTw(\ܢ
"<4( g#>^ȡra(I]$о2!48 1b MpuX!iPOsQBm#>v,Ѭysd
T"=5
a)ʈƓ9}
fN8t BzņRdevQs3ӑ[P\I(**!1>ASeҕBػefmַtGMYR#>%!KDDnv^|9ehabLT qOb^G<q['mϠ $?s>Y]۵*X G% jR1 Q$k*kL,k6\-
xЁƯ
-h\6w)qO˃]
ł,X %3 ~h٢l,kkG7i3 [Z ߗP
}Ygs`t iUQYI`%J/S[zj2,m PM}gO?D4
E"!=j<]IC|rCC{"15 aвslz!zE w{mQ0ڈ4x\DxOݻ2 '{T03Ʊ
,J{7/zW.*\7d8ypsBZiiutBYa'v v څGǾSvᨪ,ǃMƑp;? 9Q^g`-iCT4"7Ct8Nw2]|g4/V-.ŗ（s Uq=2 }~ v4 >
@>3>Ϙdž#: Oʍl4FM~kk7D@" H$ЅQ gf! RT"gWtֻ8,_bHe[ww cxnЫ > ç`!sS)Ev wv%^[}v[qØ佰(y|s
[XN>DEu_ QFHy>vmH4& %9IXd>+h-O`ւ%5 W+2v ývŻ\ La+ık>] )gꋳqM Jp1Ｕ ][ɃxY XV[%f<8nִ˜e<z ?9Ib|VQpo،an5
Sp0!o+4s>~U Fc5pG= Lk _A[HǺO?E ǫvhw%? m_awOwUEu "i1<`1F *8;;,L]jǎ Zw~>_JBA `Ud- K[xx"$.*uN9XpH.KWgaù#Ȅ -"dVx=[c' ?t?p&ᱲ( _y}㑱m!P<><nHuەj M6Y9l(_5vnW$.ɗcP!ݾ ߂ Uxp+Gò bGL#K!8xk/U}1lWf#{Gk3/,|]ne~|vLٟjơm?Wm=z #bhXakh سF_kWݒr VVռm J1/ 9 ~>z-4P]{ R7 6LP5!Z7
!DžH4)IsET_pw 3>82%4&jM۱-T|.z<i1 l -D`n#qSD@" H$L
$UHZyoO2eه +?mڮ\)SV-~F<%9*>] 4])V. ".^F9uxf}J|v
GI/PbOWDZܹJ$սDRQJ O*T.\dh|() Ps#J0=.-{Au,%!mkS<LRR +3s\pYIvAy{.#SJbJBZR %[cT^}n}l%!@)KWޞ9Ar JQN ~RPXȘ(ǮeKr+_W8Ru$z&%p%1RK8!bEbveeD YoVRkg]<EzQ~ru%#+[IMU^o2e2Q߱-k;SJJs')(iɗGFD),DIUTSW|GcR +;YD\Lyɗ}{+\:߮TVV+ǕD 4E{(6}-x;ec/,TŦc|.xN Fz\{rxrKI
뢢BX)**e
2+V2Xew)IlJA͊3ʵ P_Rrǻrb+xzβ R2
UO_iLImxlU) .} qJ~NK4&ǿTRj3
-y(4mWiQe )LZ]X0Cyu5=W( \DTTk}Q}YeD|:.R*>~UU$Un!Q6'2Or)^S.Ƨ*9i +^@맕;ʅuge7unP ?pk%+ ͨfʋ (k?rR/.U%y{(U<sYҜiʌ C5(>_LDѿ*<9cL-zrk۔g'|D\zLs֭ !̆=Ej̎})]Trsrr̷ D@" H$>̶ B 'u 2t^, DO{Oo;_:l<]8IRru NF,0lwDګo >;/n!ضK:`C@`3$_9_.(4T6s]>4 1ld: ǎC0KK\3C A0Ñ 6 't<9)9zxH.6l <!>82)M셨fio2U
% ]] g:VB
< [}θ[ s̬ag(kKƻx} ؉VaC'kȀXms$z
sj5 CRwgLy=,5bԸiTT`_((G |nJUǮ⚟|yV-1vF 5nx;aԬ{OgvʋpyvF=8GRpa/H, m
7? ]U" :bLYnv~u̞m| wS#y[ɺQ/Zh #( 7 ,ѫˑvIew9)iY A!`ks{ssQcE5Y1.ڹt$ :4mKB yʹHvEQR8\M[QͰ9tica /]sZ"CX.量jj iЍ WEG-ޘ:
#CEQHCޚ!D @jm h z4YvaeB8#xt"7\Zw`lZUU%ۃb'XܑlGI+ŧ
3_6BQg$GhGj<~9ʔ pb_yU{97CeHAπX[ !~s c!#gٖbx;%izw#9d#~ Sg.fp34X)Ò$ c{$b
H{Z@b:rz/xq۴nyjPQ,NF=(h%gz)C X5UMH[ 8$ ez@mMF" H$D@:bjJr
Ud1>]:ހϏO( pEn~!oGә2rD4; @ >0T$.DzII uӫK|76mފ6]Ea VĕĈI:!=[- <x# :G'} *PYウ~d l;@+3JZMyjccs 5:擥uEs\[Y&O 6d<TiN䩦 ڲYv%Kʹu&ޭ(N&X优u
oL+:lA<:e (Ƃ|N<)tN1|7WЦy K2ƼQ*K{j`Cƻ[ dB .(|v͂b
; A0:_`MsU ݜx1( <~H䔬{,H8jd濿^XMUmh!Ȇl g}w+xE6Mcy/]F$evqԊYXvgbX!psq$ؾ74#) GLLJd|g?;tw= (G^fP46 z79 wk6zS"
JU<J- IU/F(-ԅxLCx `K4*ASv. ص;W8w!E:&Њr*q̥-%] `eQZ`i £Z +eTŁή.4DGm}4w (= ? {މw
]ȕ }xqnJ ؽ
= D- A_ "tҢڐN:P9yZwd: 66Tu */ qɗN1c,xz
G^EmV4@>TD@" H$ zt}ba g/"e+9$Ԇv˛|* {:jE X[i i<e]B=x克w>!D,C)Iԃv]T֪`agLډ t&
G~"NV{mXG8kYtIpuWPfԖ.%Cdt+XPMA)0b$ˏ'!o{1_+2Dyɕ;\w)LM=_OW#{;hZm0* ʾ"'Bj]={ [S"d,Nk[?. 2<h:w[E(I
qh |kx{8Zp 0H-N,q&};I&|,: @ IDATLT2 s52m̰,) R/ x(i
#P{f:\?O= OAF
P^c`2T!ƊqHKKB-Hb=D -qEղD;Ap%!ŕƩ(%;bՈz2ddJ_nt9= εӸ el!B +x]싮훋x]vs$j*b 8~oph ͑x֛4!D ^T2
3h I_ga71ȹ>sɮ}j2 XDۼȠJiX K7k[wcݵ/
3݀ov**H8D'p$^d#: I!CW ~ay[.1ݴ&8*BV6/"))3, jM#Жŧoa߰r
ȺW "-
f^ha>;ꗇ0 HIJD5iUpblDh܃NYFBuҊqF`@ϥ#Suxm4g| H$D@"E@4PݻI$zTPSǐUrg_<OU?Ah` އFê|%di
ziVcǩxpB F9xyc ^x3V { j9>83Iת4
kفϿAָvQg*r n^]1uk0g9Uc+L{ i͆vpR9<[ &,R*3ۓdt$m^ /o;R˵Ť?DC >d
^#.g6ǻWNo%ruT= ?Ɗ P4/mb`wubA[RݍfnC ,_wwcJL,r |MI=&M g.RO3gDcnFw~krȭ[9YW J-OȮ\;#A M G}0ZN3wK:ӳ+'c+L @ޛ_ Kl]
^,O SXُ B;g L_ '@;G*]ݴÃvy@eu{v /OƠ`Sqf?lqhj{L{SAQZ,=O<K uO~CEF] sDz<C;1<C_6JQ*挞G罏V!^(v/ ~H~#ur,a|
ޝkڦ L3@|W ݽUAT#w+8o9z9K1 ebӸ{ œ~TlkG,]ڄq1/ H[,x ڎ/= /J|[ 4F )gZVAӟH) Ẁa;+кy0V/Cf-EVKt~ е C
\U7ۆ +VH £Av Py.M0Q1 wG_Ǹrt
A֭ѱuKTb>kIcհ+Ť䂎XU~&"M%nsȺ1{ kr!6
I8&Iz
NH$D@" GniwvqD vD\\<P\e_ǝtnؚtGCaԝ_I\|
7?Mh\!*%iD^-g8zwnL8y)';zvG[ m椾CgE Z\?Lq$<{"?s"x' c
"_gpU>ю&tSj#&ΎxMgzR6̞$[z[O]vF(щThld%3b0m,lk"7E r8*_xg N,ڣjLmKm _9ܿ/}
5tjnŠ V%(q«o,DvM5B"d졳^AoXmr ;GގXuf >p
CtPCjaaMNnbAHr/&Y tpY`)dݝvyaʶm;Dy*, ЪUp+ m
c^IW/%rx~>ٗvip Ek?> @_8.%ew ;ϊN*82vN$$@@I"\"m0nho`Rwf퐻Ơǜ>tUЮK/tܖId3Hw٢^R04q$Es&XH:Y9M6 0g=wÓܒi|7m U[H"Қ 넶ۡ_ɰK?P;7@ޫ32ѴEKzp-f//Bi1Ag<sӖiN~H~Qݿ0; WϜ@rz&
[JR*n,Ngͷ"w Bg/Ǐ ܰGC JgM<A~ AB- F$ Aڹ#2{Ogss L2ZpC ]N6=JN@>ÓD `aႭSKk;eEo{Z;+%G GPd
2S p1gh=B""ѽS0F؇"̚:B].%ѷ*lTb_rݤYPbR((ѮS(ݷvQ #H$D@"/C&nݨuUHdLxfҶtY<5*tƺ$]Wu:lzu\CBVe%ٶ"W}[\̴'sCAr$0cY
:slefT9s>lՏ Ey06FJ/cr %zĜq[P *"t6k,hPOr0rwr:L]z ^$sʆg3Fc騃[#:űl>mG*
'"-2TB
7F!u+iǀ~y czjO.ޝ;
ڷ^ x61cgmxfz
x&!4)[QGNJ V ֶ^xXY`4pIV̋I6]'|Ck.oys:hlL4'CὯ>G{2ǂ<3L[{'ј~ k/miF=kis;CAFI$D@" PzZ僧p.¹LLIyRB *txl( 3N{UfAiٰ uh54
4F,z 6UฆmIdἡj<ӄsLm#3hڮ[.ab^/X2_dILm Fm }Hp)WזSE0gH|st[US@NJgޅ Fjpa{pp~j@ 2IZReE:<G16%qƸiu; ƶ80p=l Kj AJG7>K(P3`OFŢcux5xG?Bxc9r]88ۧuhx UzUp!䋕Z
mKL顖w]焍v4Jܜr$c$D@" H4nj}bOB8t=Θ s<hzh B?̏Qٺ~z+Pekx2ӉSaU Rc9\_zPEQ"~tJ|^~>s%wvz>r^= oΓyzA5m1kB-zy gDh.[7T۪eVt64R&e72?M*1aLEʪcC9k3I%ݖ yґ +HwaFS¼\n)WP Dq 7֣Fi0mho(]sDZ\*nה_S ^n!^ԟ
;cy ,H$D@"BtI&O(J;qΥषgQvܨNsX}9.pY'jRm0o7"!H ĐIƤ.wc纉VΜW3rQPS֟^?=ӱucUo'g)80jF;ba
{o K" H$D@"`
tUbAyrX;MlRMH2S6eP1<>Ma^}Oz~jLjN84m2c
`z0Vh
bzkmx|zjV_8 ce`ZI]|b|ϾѺ
O%D@" H$hT@ׅjr@V
K` _?x{|M2eKXу c,8N4ijR]!(
ZOO/a[NLa(o$!]:%b |fW/k̯ WH 222 ٵU]~g!Tr EAz
YpeIqHL̀ w LtƢܿ%%,#|y^A]E1y
۸\WZ]4>Y ! qqȢ $l(paEIƢ!MɺjYٹZIљ՝΄a0' qtM#cj$^EZV><}ɪxhh6e[qaSPPR&?r,7^ŕ E\//D@" H$D^ֲBEv5|Xt
EY8X%k>Bh2buwEŦ Y 8ВDVh[x^F.繦I$v87A.:I*醲Gsilw~a= yq q 9qPeQ]ldѐ),.++[_nBn+6/lg;vUO_gNS[P dloKKīgqdS-w2~a8JnƼ) _ w#~*Jʷ^ŪMC>]Z⭅/SdQ!VU(M`v<:q #"0a>.eo`ދȼ/ł'/C?f$`װji{X9^-w/y%l..?sѣG ;3,!1:Y+&gYh?!~!1PS-߭"0_McL@t1|Awu
-㇟`p #XebR,Yqy!-@-Ř- D@" H$D^
eyx ~ܶd * voG~A>*-KJ5PJniN솨dg6ZV^ZJq6- ΪТD;+8P9ŅydvN.z}W
*.{ZK B$ŻuA NG#ДO q*]WE5\':L@5;''9{p
kڞ>gCۇ!Վ|7vU=n0K,31` ò믆Ү(-c;*iIh {A zU(WDJQ" wBM !JH='}k>;99{Wo!gf͚wfw֚5Y9yt~
\]UZ:G3n-4p<z A] 4ZwM0=IZ
9-6,{ ;'vatt lS3fOxلu߀3uf'Z ĊD_u۔r¹ ;v-C{s";5.Yi)P[sd'8+SX&kj.GC f ~.nNL m
WIrp^]W}4oj:&ǯ-ZaHu&ņ}g1oٳ}GCS
g_\VY]F< 9A@\>؉s1?[ SS
C" H$D@" ԃ@]A#6r?&|7 1n\$;6ïDvlx/#ܲ^=~;#)6"2^FcD.hd'_K._.-q}-mlS 'K}odb͗k`۰1JS,,_4tc3x%瀶
jN :`6@s ڂ+VDZ\ Ko| y7|u4k`O'M}]I?SPk]A X<[Ϳ wH
[+ޟOj"rSMLFͭ &>7#믐W -Lt 6sM w=;6">bN aWѺ Y e5h#sl]66; `Kl
ּ|C0Գ/y),g1Ν: (2i|, 9R^
g<]w),+ y p8퉾yh-jhi&QY% _p?m6I~P3յ3s"<?o({ Y :Afr"m7wtԛc;,X:=5 <t>MУP<;{D^r1 ڇglpk>Υ@=t^ n"ʌ0
, i
gbDH$D@" H$!P?A'R)?13ټ [7|hGEp`ۏX:V MݬyXُ;]e˖bqrfNr'1Q(ĿO0{0(F͋ѯl4;~O^.µXUT/%+k[l+tk ' ? ?Dьx\,?(/.{0ġq')ʲ+w7vpFHhuÈxJ&+++%0/NF<98b? =_j߮ 1 ,W#7: ߀ػ̪
z ?9
+ޜ^#] .k٨[_T8 E DRP*#&ˑ}h : 7P \T$;Wu-D~1R7ۙx" $R;H)[~ă1(#&Oa_(*}۹%UDZrrrE#R(x :* 6 aީV\Xtb>?,}վ-iϼq܄ܜ8L7߶e (V6
BNn b
[iYAxJ\t,-kE>Y;e+'o$D@" H$@}KU2{-1pn;v u mLǏ_'l@3Bͧ /|
K^" z % ,B#gdRj`uΈ{xݛ旯" G ErFrb2Lh {.x5ggl?P/zj(' '; %脞#;&nm""Kqn ֖j>G.%w&-ZS ڇZzZtNnc8ڪZIi .GA,QE. cWHOM&"jFdl=~&t $hx;wHΘ>z 4b ~-8y *
ұi-*.\|G^Qo^:~^7;O%ueXO\^1`z%bo-Q
]{}I~J+. Ç 0w ~F 䩡wPPUDF 2 ?'ރu:6
Ŷki!D
TW#VF\/&RMJKQ8^p o[]ߤ-&=զcVz&>&c;Ю 䕑ZJ
| $D@" H$_@-Q
[gOy 5Drxf,{q8\ %3 CfNٵw6I2yup-18)
v8y! f=!
]F$q71ĻD(/+bf'G}6"gL4N$첒" {j!^y58;}:Uq7Ԕ`fFv
oF%VUWpQQ_ kEJulAv$2]I{aNo//;oLoEh䄛HH͆~maRU
ŌkV
,PNQ$sӍ{VX>G\-4"+7`gژ
Ww6lSb(XDi
#פ gהB' ̛z-qADA_&,BOLi`JkFi?9'sbeg7ܶxYG?-Y쾠O ͜^َ?C}W(RG:!>~զ;}#<LWH?g T$FQJoN+!%D@" H$@ %Ѭ
a$|Ԍxa "@$ڱ[̞ZK>:4̊ G A- oTWdoA8f<Cѹ'vDZՕ* "nAjآ$Z_ 'v6Gy1r+IW(Օ6ͦ`֎DL3s+XVdvo.).\Ӝ9ZT(9::Q
Ol8O L
[ηOFWiE >3Q0;}Ԕd\QR\KFՀkD"/uqw +nI(cFߪ
QE˱`&o d L$'|\m^K&t|= {5ʼnXUMU4xAE+#Wt3ܼV32q..r㮜¢UqZXSjpb8z4Ǒ= Bd
Ggl9w +ɢnGOcpߗThNݜd
nE»o qkbB7Vx1s^6F~H$D@" H$zx A糢X^U,/F Vxs4ECo @H+EMM话FeH'Cx|9 v^C@<5, ?y݇L@ w3mJ_[vCO%ax8ڠ^b" -"!6|>wشMڙ
M, ~%o +#vޏ z7D'm
k/Uco BmGel%jLV6 1'4o o>;ܶqCƨ*مN:[HQ'兛nȹ s *rîڏ^Dj9+TƫE؋Gfb v8yH? BZ6B}x<|M+cGEKMGgCȤz][8 gS@Lz'V;-|CYg]x+ VSg>ǎBhrQxvwSxӟѡhv
ccXtiGc㏱O?ƕ Cu
L~c|lشE(Z5b8e
6m}g| RSD'~t2GęS"gܾ9z {FxǖUgBӆj=m@/?%D@" H$@}-h 㖖srF3tc¥ . V5n.mfDE_sjaDTJ sNClm\ { NM:c܈ARp-go WƑSu): rW/`kCBVI8Mܣm[q~s7Ydٚ_}iycz BL,G; macԧ#wܕ8b ^xx;96ݽ#-jShr+wEfT)ҟ3:t鋌cQ\DL?~_PEI=0ykxvXrg4KL*q^|巈hLQs\8waC!m^5\Xغ7F{a۶hLӘOg{:@nQpM;aGxZ 2 |\( p 8}67 g@&?Mк'R[""F&R?S v4aΌ'рگzb&JE|r
-QO MXqر_y%3:#oܳGt9&l[xUc#wb3]:>,}[XDҕ(X9Mp CصmN^>Kȃc%_~I$D@" H$ch-GF*83/(,t'2y9(6"A [T Jr7<&.s[^ZLngr47) E\8qR%"|FJm&Rdff.^A窛~w^C(fv>ǝ mAD=?\S{ xEevo ѭ%VS9b l8ի uPD˫M }tAp5aov#+p9awh့ F
Y(
(x4t#+qh,pKv7VLeK>qV/4P?("Po-2I:a ƨ>pwSZPGKEc ^Ds@QS |>["6*h<U]p V(FC&J+NY_ާ($D@" H$!%\ȐVjbI,eRGTϙzij(ĸVn)+Mp}r)
E0/Z+A'\c],qI [9"1FjZѫjH
CkpqLT'~Fh q]Q1:he?[DУlXS^K$D@" H$?$\ iI "_E\-Ff:+-Dq!+k]Gr9*H="2$Dz{civoݨY -1q5N\u*i崣 ela]Lm IoMdP[B2KSdɢhn+MA]zq 륗Z E[g4L:ZMZgjf9*ZI-/ƀ. h?OGpk[湥Ez\`L:Է8bX?vgK$D@" H$A1$FLLNhQoʫKύZÇhLepiL9?Ӟkvy}qzojkzD_nGox\gGۭsQD@" H$D
?%S\*òT\22kcz{z.0Y צ(F6rj@ѺQ|k.̺kON7r%D@" H$TWVS00
ſ)[ZJ vF'
\VXb9KsV1cjU<qe ]Z۰p- 5|^#4r/.8O|vk.w95Ek59jy9 aA;?d&[a1WS8SqxJ8ږә##!tC# w4dTߏƮ?]VI Oܯs<W,h羫c[+F^A!ÂP 95; =>j;G{Iɰtpp6Z뺊9am-ƀ 5x>,u {U_8kۮ Ev;<:~*F5JeBWCsHScuNfu
|EC
3MDߙsJufep'ڷ>@Yڶ%> iejƗT j2D@" H$D a
4?~.=|~ BXЧq ļIȳXJxqm4%~hs<}\F {f=^ ZudRee2v xMXa- prpJlg,xiߵuEw OB(V \vP[55m⋥ĸ#[?ʞX` n_ޏ<߆KDp
5 L ?"tR7J_v Džʕ!2֯߀y :&+x!Ay078{Qd~"Dh̽)7
Eu^UV >Zƣ=)ھU^룆Xg2T58f2ƺV&O]H`YjGKc|z|Mm)H7Rb< x? }~];jhG݉oOz8Z" amuKy=SY{4RשյVY%wg'Aĵq %Mv/P;b<!f#? NGCX psTkD@" H$D ybe|
t;GBs_+ /kj5T;ެ\k3#"͉tp&Z*+|5I (t)4úJPJǰqI+,T*+#]
tvBloJ)&:ދG|qR J|<|dr9YVh5꣒jUP/WOPX+̢5YWD]eQe|/42OQuu )y"W_ţ;ڃιO? ˗ #<1SӤ%FC$ ~-CcԨ :כq(#uR4?>KtTZîDBd@PJsEh%:]Mf^dTuE9{fc~}ŖX3%XÚ߽v}2u.qn-+-#NX cz qyt\ խ8r}{R.X}8A | _*ykXc奥Ԇ: z`驥h %Q ^ .|rg.GJV!>" D@" H$굠*sMԜqڷxֱM ~.2 E ܼoߌjsrAD0| \|N T8s3v 77{TZcީ5Y+qb>d4?
/]_pgL7M|\Ei k.O˥mнp Aqv2vl`bf0wXG L
q:N?Xb! Ξ#+g zj2la^mBX$ OD!0'p.9[ʎ,D; q5Y#yc)6Dˀ+l;s֡9VWbۮ}),%}a n< GD{y}c¸1s'F&܊0jxٚ#̬QaY`=7`'lftdML`o'b
>Y9ye "I9~sG{5
P^W>݀^
m}&gêM§1ԇp)OAh9 OGU~.H6_Pb" N AI5D^a1qpxt<{; EqY%<c1hʵO] bX+}QHg$Cԍ{{0 Hsr'`([}i>Eщh䅋;tmpƂpoд =9V"ZSJ]^JX1d:C(.ϖљ3y2|ܼwłUhA1 h\x. ?N^gWDϮu ho5D Wo?9~CFWv4e8s0riAa&._WP(L 'pcxir]A? oo2pV:͞n8k;
- -;c̈{.O <{zwiаdaݚOQ#2.O 1 b.F\R6p5 B(cӺk@E~/x]t#D@" H$DjA7'qq~GU_#c,g2 ea64l8wFE .)P-hDu ঠWp#!.&CV-Y K潂V3@\>zF.Ɉdfom Ϝ}:+$ѧc>%[X WiVLlx Hqo%U"\OǠEhWy| 7UO)YJ[u삡#GK&={S0>M͇"ѺsOX_WNV||, ^}eC,<$k-Op<;o `ᲵՕ}7b9: D$u.
IyfϘ)tW]`אUXj]>8
tnX\Bh*HYU&4NYY3bK+AFfk+dx9`̠U, 0~{8x"҉jIG쒒RUYD9Sy Pe>}ٓza q^]c(?OR"^c$L 6(ӧk[{r46;+d]< ,]bS+XSxj8,z J-a]]6?cin"#eE5~ iyXN7ֶ "o <<==1{o4n&eرa5 Sg1[T0`T4 CvaK+?PXGFeIVU,(}$L8 e~4s(ȹWUYZ OFs*/ #6i<
7-ΡoYFfaIn܊JcR Wh/ 4&P *Ѳc{յCƑαK7DSo_dZpYaJM6-
}E,QQ OD@" H$ ͰX5Mͭp6l
gj<K7{}Ъ}Wx4-# pA!H?)͕֒JDHOKEN^<|a9<"aWo«L? 2(&s6
E
Ĥ Naޢv<8A['a N.^ZLr}zd Sq|.,=BܽG (!P,Y-зcs?w 3 (3(wD?waj*hEbɢ7Т3<@VN6,r7p&zRnYXՙ=vj/w{t
D @ IDATZ D۶mkD3yU
/돤$4s(BRf&E D|> D"۶hB ?wI[. y xe: mb#p.+) v4^LȓB<8M LA{(YW_Vcޤ!q2<Q ~zG6-jo{טD AJЗKX{xj`W!˦"?q3h ܌b- _B
<;Ò}3 seN!
lэLHøpZY $&'B;bymXZUO4SftKsy E`c_dInGΣWOlsrώ#t,KƚբFs\ F_ 7x+yQg: :6=w? ^}n2xq[>pp_)Eslk
LÐ7e@cXw>fa 0VX! `9h ac =ebvV&<럎lT4@7
:7n .]Fn2y$9`5n
zيgB@PoD@" H$Do@_ZADk39Y+1gz 6 d Nǭ;3\̦̄ZGv "aFDUx߹j8{xѴ%E/яx&sU2-2r ngw YQ5]2C&79gL91wTV r[ِ4J8{zA%VVhܢ* abhޡ3| h,D.p "$5u+ș P hU(,[U";i5Y ws;4; xMi~=ap%KJJTiN.̝"M8Yy"/C% OWWU/_(g C{<_ xz ]̬lDaae<E8 qAgU*9 rcom"瓷,+RmO9 xiRثƟ*e*˫ȝ\ o qC;tD<7mE:r)ǫiI5(v@ۖИD2wK܄1m̄).KN~M{×`e8iSѥm[_IqJupm 9nn^Ʒ7ϡRAic
i E/p
EhjNTR3E: rs 0v$4W 1mhrg/Ans5GGO[Ơ] #mSGfsv ~mv֭2nfTcd 8e{?cJ*
S>]R̊
WRL 4dm?;X:ÿ fv{'h zrmWлV.p8</x[MM2Xy&/$D@" H$Ss&Wwwz8D 'B~C[ 4I`}Et&HWR $]$J&rJ-Z3+"s;fJ[r&wx+[ :61S" 0*~WS
*&u߹ 1'^U :JZ#^kQ܉p3 /Jg'Ga0beLEA@^ 0F{ 9Ss݂(aJ
h&2#O1{4X
M wpB{Z C 4j_y -k/c&M{N<*ʾ 5H ƲDmS?xS'r)y4 -ې S8zo@ Eơc_c{Ѻ]Wd aBǐ]-O֑k0e
eݶ<?ei1P `Zeb&4TjKmtyF1)!j/d O!Bdˑ[?;1퍟vC: 0fxot ]@J1L0l3{R8Yz[4+iCgݿgv"`9Ymha*'!
t$~KGDkjTv{SK x/*LŢ)$\m9B%yvDOwbXxK(N'KZ;
iIHwɝ6"֟o J
Wq LkSû
Xݡ y;lFeev,DLt0AclmGxGB" H$D@"?@-1҅sbxHu;x nD_Ɗ߇sp4n@D;d ~ {~y~b9t&VJ" @sX[u .? '2:ZTVق]42Y#e y(dms w gP\^
k SʻGUd˴F=윽D{LKxJxk tbQu3&Da~أr)籎5 =GO{`~O_ [ɷG{aʝ0![|\ fD\*sq|2u"o UkR0t| Vz-K Mz(D&k_, ڵMDjr"|9% :đڳiߴ6CB2t\1n;ۯQD
X:>}9qznf*6^7<;i(Sj)Ehg] }rJʐt Zt
P?L-SqB(˪!15@ܭ۴@SѦ]6Aߐ@ҞD@!Ո= *Lx'E|jZinݻ"r ÀuN
+Z)O=QF r Kx c㑟 'w yH.`a
H_!9+I1J+|~ĴGv wC
r5g#b^=:L~BZ
aPlm?yk>(?#51 Fvچ[nT<+hY"] V M^b۪ŶZ3w˜ 7o"# Z[w_PC" H$D@"FO-x=,.i9Y "}?|\4>E#$5@Bڸ9 )Mhܪ+DN HֳJP 5K=As)-- u_`gqG7Ğـ>Xq4cvoK{ŭy*:} 06 nv0
fyLmܤЀ Ƅ7S~.F@ p# k@ؓ556dEfm(*87z߾/ -4pTHM;*|$l*7qL[w:3z8Yן I0
ŢlPჱύE#hO4[W-m,d]}g*o
w "zɂ"7h5H"rِjYoա;>[0^~eyجXbڠ7{
- ۈ{Gq22G ȨAW(17)(uɴaˠ92_hŵk2c|о-qCX:%8 >'FN_@A얢Y 5'.-
zvi ך!^&ṗ 6z9tlӼp .9q1F}w&W4'w0~ i )X[͏?fB;NK v۶Č}0!ti鏘d3F>W Zc _/ B
JL{ Q@EڪPs^[dW /z۸7?ſ>Z=wcbX;|~ _gsXHӢԿٌV^0יӷèiǛxnx CFmv9IO]l>~
/_?f ßt9>jNEyMà;R" H$D@"BgSqa>.Kk;r$e=@ _ؑk:9Bt:V bz%tD{).$ْ)#bGQaiCDA\J" LȪLg&Ҿgxyy!VIEAnDKLJ{=LAnN>rCWj}_/ ?J
L.d]tq9.FAq)]\H7// HǧU =
bg
??X>rskje縠0Pug;=Y\"r "o1"Q_) աz6=YK\іFp}eZB&dPr(u-b aJ}2PO;P
<=\Rڣ⬖Y7Z"@5[
d_mqA WJ:O>-%4|nz\M^LxxH;*.\JgvS4 h?=CUܖj nT#wfMG˩b@$>h9L%'&$"X{^Ȣ16,LW,&
6"bi),9\t :8y!{p$fL#ot3"11e ͝;H
LWOovjz_h+
~x0֎n K5ˡy <U:zx8jrxF.s /HGttÇ4oBgWx;J"--
y%5 juEyHJ&-
7=E&' ,Liм\(Nr2&b~٘WHX3y32I$D@" H!A~;0 `=Rƨmuꑫ:qϹMP!?1c|o )KK\N*pjOp/>~~nv"*~6TsM} 齾uX/C(Y!W9u` 7? 0:
. ` ԇkORsw^N kct6Zh[W GyZx QS5ULqǕ]G~2SsOqj4~Y>[^ 4ԯuWB>H$D@" }Cj\ uu <MV )kЮ71Z9au}298=~M⤒~n(Y'~^'Ϡn5= ֵH\zr- ZAMJ }՞7?m>4pN,Az
5Y| ܦ[uDt#E !Uyw5OkHyj |/;V .6EI3m
QE;<,G-LrBC
}$+ I+gW|{q_E[T"=MktUչ :弚(iy՞>5Xy.o$D@" H$cA7X'GvzS*K#Tu;!~=7.GQj_<O!-F%+G!Ѿ?Ӟ3<rTaǝѳF"_,kT[_?I\#חjgAƌ U&K\p1uK_ĘQuoWW?Wor9Nu:վrD@" H$^קY%3 FqO<7Ɔɦ8Z\I4 ,KZ!a1D ]76oTA" H$D@" /B~4ZS&:ڟV_tLYnn8
Z[+LKyudje]jsaV5k2HpQ^Hn es% E̸խV\$ cTAj ,:u1xTseYqtz@ cQU]#3'Oni(E^5]ָVA{Zt6|ek嵲sC,GkC۪&lk2Z" H$D@" MitUEvD 68HDf~pkdKu=fbi%kp1DM0 z˰ȧHGyek>Q:j{0G#J5~sqn?ԅ z\㯟ѳ,+ztnCGZESh- 3qaEyV0p xwE% yf
kkKT;hZ7' (<EGuIU^4 , ۪*ޫ}163Uؽ[T5lFe uQPiߵRs !B}[֣ȥ &邬H)G(Qֶ`q 1ss-
;f>OYM>3`ƴnv696X?/dN::fq+Sƍ-
'EC Y{ ?zsD\POID>/c!T{ܧwE+}N2I$D@" H$*Zi=B Č9sQ\mJGYmm; o<%mj]A6D9@N pǪ}jO{A*w"݄>LU=P3?a-Ԥ~5SS
dsR+[m3>>>B|rx\YVZq}a},yuFZvCx3ZCd:E:=3:|IVtl ѯZ]Fŧ
\iJ 1^/. ȴ(YȠ10d TJ yDYOU7 !8^t3 I_a4O8|-2}g۫Jk*vŖ_°aM䜓9 6 ?,|C 8j愾v2@$=<V6t[Qqezh߬s,=ߚ uu繡9qWsnѨ=Z;BH$D@" H[
| <7w&
Wo˷ 2ns(*) h֦:&0D?q3Ոp
Wni ,l%7 Yv]D9ti~.|ZWxW:gd!' :uA렆.+'u ]*g!zEv= 9Č\X7@hO HT<qIE x&--mDEخ,Dl|*.>1abiаp ęX`:7[ pn{;,#;~§M}o 4i Fo/f
^]_zE<xxv Ӧ{YΔ
ôW{?
{ :آ[gHHSp#* m'< *Y,ĩc0>ޣ=QV+
x') =q`:8;~(nߩ_6Yn=
-pں}5:v!6siЙף.ػ o7P-I2q{4_> 6кyc܊r{ؘ\a
רljb@
\LǭLXU6`鄞=aUS'O! a=B嵅A_iIy0 :*,\ѣ{gTeP(1E^і s .A-fYٺsnhԗzc
TT.@~F2-܃nD# ]{]Ԯ@ zXD=[}B`xc;~>=ypiz%^zY43h¸7l>>^9<]C阺D>Hzw=|";:6 ^wnb߆Z4*$D@" H$5I>
S3 $ܽexBH&7S` FMĞE)bWCLyJʅ;E ^F!pѥS(v T v r`G!VXw Eؿ
hE1e t;dVi ~ƭQXf6>'ggܸx?n>JjSQif'Wͦ*ehŞ瑑#KWCTd`欗p:I6CBYIۆ^;ϼBY
s+K"EtFZ7\A%-<0e۰R35u*)vWΈX I| i1& )崂bIĸ
_{;D>-D FcIͯ?Z
G8(7"V⇷&E@_\ |\>
;N\Cii)2蘹ܽu Q+ĉ;+;%sWㅮDNKAAQm@Zpa^>bk8qJÿ m ,m>7
P #p(@N
w?998Hsxk2LA̱_:mLUprJ}
=ztU 371LVaF6}_\ &{4nS\t^|CHn;U?F?D^=0k'xGrVcq+02zN09Gu)v
>ZVvOKWl@V~r bص4AhZU-F 4+n@={RLJdnJƯТ8 SznJ
]6ͱHJ2X_$D@" H$X<ȥVӞV2P
3L\픓QDR%/7GIIIVn߸02oE^ߕA#g(i⾤HPS YGƋLUYR-喫+*UuTr^(+Q &*qN(X*;O^U*젼zm-Shw iJee h׃Ey\VJ*=TUQ)驩ʃʪURL兡aV+ə9J9ɾ}VicC*_Z,{q2õ
Us8U+~\tRR,Ey{oJqIÕ'cteԾQj{ה͕C*v,1e%Ec5YuU%m7VRMuի
e)~Uw(\ oM_1GgJNmwʷ4&E㛩l%2>YHQ<Jg+m,ZG*U*
?yNy(f/VrUt\VB
X`Te`Uu&)/(raJw^uin`(e |(e93sPNch
ejj?_PL]uUE" l $R┡ -.{ ި@+lUSOWO_iw"vWBqdCyۏe~2<zH, Vʱۢ^kJw*{Z-Xp*KP& %%''O)ו*-S
IywN
NHQ3n)6*9ywQEy(Od4w(K{o'D./]y/.eʏ QzN[$/JJaz D@" H$D8uql["Oyzw><,ɧ+pi3^[cV$kAlb qpO$ /KD:^Te"wbK-qΰ4Whצ%Ԗ6(/,&kg-~xkrq\ Wr\>} g+ r
V^m c; *j{Q좨k ⺊mZVlJ^$tH!! ޓrsr#ݝѼ{g̙s~3r̙\x@<Z\Be_5Gl8kK^N3!;A(ܻ/ AAk0b'dhkCdھGװS vT <vTh51n
mKos{SG3$Rl 0}."rPzi"xե,n,<Auցrs r =.q̗/5 mN6hCm< ^;
چr]G#}6\6O2ۻxE H'zZO
hdo\=?
ކSpQ|ˮ Pjuk {gwwC3N[Px.&LWi\1r VF .J s_H^ FeA1Д>!7143 1Qw?,x1$j o`l|F' QW9=-}pv&4)N%Nh @s̴g (.2T.A1s Q sSV~6`D]6.Ə@?o7j`\|\ٲIMkp+94SNauo=B#.i79ʪU" H$D@" @נa#.*> StN3>xy)
5p[ ^c3vtl :W.N8^wX3Ơ%0v1D72& l8=6hk B$y ]ݸlU $ցY577G
]Wbz
&|s>#}qFuGnm6y^h fx̞ I h4`W f;7b / p$mY o܋g Ȁvuq~ص0 c̭UQ=<E`WO2FVFWHxS;> d{yWS,;h q.NpvaȚ8 .ÕWAaa0ԟ y7tSYbtm#1^ x"Z=` [;q9BZkl${3Dő1xP=
l;n4HA䛨_hf1D84 dЎb}Hal{Nȃ&jy<o?<r .6B(QՏ|D vf, JkyDa"] 49?܅q8v|=/".${{ZA{cw!(8ͥ{@mc4hƙ8s~:6ⲻH]Qi3|2
.0D ;?7oNuPmtyH$D@" !ljw*4!]
GN;^tS&ODlx01FlXl- FaкaȎrFa ժ~wwuG}YPPUL"c#7ac" +G@(|ҊF* d,BiDuqk=J ;W^s= ~cԵF!î8 Mͷ2W'T@If+hn
(.EXDɒvi5Y#o&&it 7$$vKxؐm _=Xćhƹh,K567tt֝ j%lBlmۤG1QIh ch0!f;IFڛa27'>ۃ9ty?~ DxAmuxn=_9t҆{w@o
l@@DF FZKF"J&#AqpI Zil& 8@%
D= Ɩi sB3~uKg5lxݱ{NK<pe lʚrء^UbZka 6,\{VUՀ$zzboD{?P474Z%!iH&1gl8 kq9tЎ.@ = 89~
=]?D@" H$eN;慍o܉?vń^*ۣGM3gw/})7;4Uqq
7a -r(nMn;e؈ fH31fB<qطM8/_[&&
wއ G}x b0sTq0Taم#<^L
|4IA
Lt&w)s`=2v`ڣxH ;4o<6vR=+pq]t$Q:
@
4Wcf҆|b v{ &mzѾvx~
d.yˮ#x&G Ƽki3C/d8FQ-VRNxV3 efFMūO,EVZ4˓p8 ߄-hgӦr*3 #rnFVbĤغ6Ƌ+OM;y s;i<鉢0?g h%Nh:yD Y4/GHgGɃCCM3FZzXK+Fy0.ld Hm«ü v yi<mDvoe$f -e xi >'9;i M V#%y2 ~J ?֗Ȇ/BFu3- &4 :Će"1zʠA!琙V =DO94ȝ5=U" H$D@" }Z 9I8,-][n|TWd Ãu{s=dېo*\<r1L4)IGOc= 0 m@x {(0<XPNԶ#fR݉g'Q`eU
pAҀTĄ & ="
g_SSi-{rk <P(>Zb2r:aC.bF3nzب}w!\FO;h|'rs )֠ѤΔ*(9ù05L HIF-'fvpD
Iּ}jˑ_Th/4P 4A#M"uxt
_Z@z G͆ ,S ;&Rb\[*M13x Q &4CC(t ^\T
6! 7,uΡ8ZRN RSSL; 54^Z\vx %,zp Ww022I'g +<L:wr
GrJpW 8o7@|R
. 1ݸ
yƶN p CT?UeBػֿ{Pw{s쉌#55Fiu+kC!y_D$ەv?ɠk *ېHkɛq vs[I"fa^<^?ѳdz6 >aE"4t(ԗX"Z? GxђoYW ybQ[.>A.ږejk\.#6>)Iio@^ Ojƶp>L!iG]pNQ0,sxVt @|RWDy: D@" H$e1UH,v])~>m
k&Q_H)"hu 1v̳UA}S,bM&bQeƵtjF]i19mVVqho[m\09\4j#ml& \O4zԴ4۲z}^>_um|_m-Y-FZzA69نrZ=u} {&UWrk%9bKo7D@" H$1Ni3lwm`Ñ㚃zotmWqM;\QEb^58X-iW5_%|EctOu]z)+[- L7NyZ9\?NZ=A"t?*ZUyUQ OtTe<U_>n &"2(~fzKy260Q
˓a~TmYgAV :<NnShS*z_a? +syK} '"6`>~3r=YWMZ˨>,Zxps>{PފNA͵ż(T^ԯD@" H$iNk3:1>rjeVuiyZYiAMQz ?s̩qƓQMӕ5,s1jB+Ǹ7ͺK| Zb WFkoɡg[9ө<tZ\_Os&ןОIݒF" H$D@"i
t#ZUlͪV ٠5ڬ'o<b&*ӧuw[Q ҵ8iXX<KzhlkWfm/^H /'0;>r>$RH$D@" H"pJToe(V&gi>\z#Ӷ϶ξt89dݭe %>@mƭS} irn_jv8UtlΈIhoLg"Sf٢nV ' U$D@" H~'mW==fڥ8љvAB\,\ DÆ&lЄ t3fdXX"|{6ɈizAX];:Lݝ]$5T,Y:r}^ےNU҇xIlU
61qFiZ: ~d 5X$ 0a8U>D-$9O7{oaanIAB j rۨD *ǁ!ibu:g G=D0^ ?eG]S;¢1*sD c[ vM &8;;Ņ1:ý1)1()N GsqxL ODǒq>hxUՉ)x]6ġKyut;6im6~q1ڽʹzpP ίcZ_<n\ {V`ӗۊp"Ysj|O8z&r^F4B
sd zuS͙n6m_nT4 M_wAڂv'L8Nc Z5{SԻuoqYc@<t/7(,E7&&ID@" H$Dg {, ڔgט<m:6܍ >CKgpX@jH j:1U%Z9* 6T 8ބw< 8}1/w[|6{GV>:4O.#r[x0a _U-x<g3V< F:z;\4ǔ ܿut:Ro&u}{'%f(6c:Y~wjMh}DaL1#݅բ^: ?| `~$
̠sӋ` fn2`
X~}Ν0 <l۶
V}ZK}Ztd4 8} ف |&1]u @ IDATØhbjʪMV d?GQYе0[<Jy̓q M
W2j#2#
k?C l7݆cpt `:*cҭuCy}KCW^W!?l<jAUyOXΒ`3ByH o
jyNtmUD@" H$Dg#xݝ-|}Xr vW0mHL9 WQ(Cr:/IqlǁCfDDly # Ң4Lg-; #e%EFƴtXOc3 F<vlb3'O r*sDtl<b"CDd DQQ3tV5/m0$N|#ي<6r6y·rrBQqHK8{'Pv좙 9; g^lu}C o/asBhS(;v &rmVp/*>ߐh$
gڭBD,u y; +I PB .Ǝ؉"TVՉYO $YtzJK '
7Gő㰣Ss}taFYf F;;#KI~҉\no?[ϟRo 0ϋ1'pò۫.K :r$tuv~.C
QR i ٻZp n.;.$
(ځ 9YIAtzQ1ʎǠAiry\=8^GK@Ai 8DFaԔq 뛻qOE w'4T|9IIgWp^! )¼82
UIz6ה>s t֗lO wҧ
3+D} ԷcS*hmFEU-]Q]~ uH 4 8"VbĘpѿglWQ9%%t Jg >+"[
JL)߮++aU::>%έXêKei~ &8ѹ둈F=H FIi%}yӁC)]m:>:Rx0pjg' t yb-KP)E'
y,JŋA" H$D@"p8<H/r搗 LdxrvBh;V:&_x
L5 4mʫ;h<C\*vxm-:ʱ?!%+ ɵ,g'edas ]ᙏv`p'R^:_}0*%
n^Q߆'VۯZqټk_#mXbBo*, Ttaφmtd7[ojTĤEB8
IzڑՈ^}V<}qd6;oV翼a#҉?G;aD[ Q~C
vl:x }لKR:ȈbP҆mkƀBls228{`7o↥/ay ͫ>ĝ|Md<m]pqS(ki6W
y0WV)i0W㽍6f$jޡݶ
o|#3A=GlqiA:%7_ɳE 1, $bG/D<:2t\ܽ< .,FJtX#Df Ct| O.qfނ-x0}TtVবd%rേvL?d4 ƭKXywq|aDz
6}7WرcW MO|c{Wa_ wJ\i |1_ʃؑ_1Y`òz{V'_CtG, ݶZJG9tΟ5 d[_-PՉ xQ\eXtյ6u> :]ޖch> QL*q98/? rwF|+9ܽO [`}_ y MXs|f /# 16+}aOѠ^_ Y 'r1sr:J⎋U,+܁WW`ꤱH:7O˖He
vǢ^ǂ #
_2~5xS k>~?P;Wc2Wرa
ڰ⭏c܄qrNՅORgf<g;\wΨc} !%}f]pOE !s:&#|ޡ;D@" H$i[>aeuVJ哗BD%Z9sΔ>^9ZRT*BX?QOFeG/p%D-W0"eO?)+n8G/)ݔSEZH CeMդ,3\yS Q]wJGliPʕz Vn8A//T-Q4)Ю+uMʗ'=F_w rJqO+Y ?AC"^WY :W VY97o>ğ{Rҩ\yʑj]lS
??kT Fr` WAuJ akhQ^{%60!WtRQ[=,RYt4(AB^CHM>vBQj}Rە:aP.%@RU[ݪ̟&Qo{CrEÕX"0o3\ʎo?R^rRQ_ʢt? ^y S /RVI1R>)oYͣVhɬt46\Y-eǪQS*$T]ae0˿}JDne8YW]3
R(? <t;?a0Gh2(M')vR nѩ
]lڹG9N<qXʤ T*]rDR Y2_7r'T{Ne͏*
'/ܣ`bH=/&ה nSJkԶZ;'\<?ա|s_\I9VVЬܽ*6hG]y{FaeJ&{_+m]Fv%>RԦ4T)WS;? ջT_.;ڭKY٫WoQ: n]- PQY74(w+Nzieu*V(ҡ<'JS[R{"W 問UZ.o
3K(<4cPSomW
!JY'_V P&Cȧ?'蛔;
U\L>TT({yTϛ_oey$O(_l!mS |c6(>rrm
-JcJEuҭ>f6LD@" H$D p<'wo}~] cM
#F_pޜ+rn|V$G ֙Sѯ>?4Ǝ[ y߶H8'7M?a(l_5{6Scw?]} vM{<<
x jsS7}yJ݅?9'<8H >_7 W& #- ɩib2Z Rw{ƉCז"{6GU_Іe=(>Rݕh⊀@ޞ@ dz3u7{FdQ8l&YH!l9 ;Z*Bq-Oa!b1 \Ӈ 8~vco!qHK#t<JQӕyaFlU%9 6e 뮼Ii
5yMرq/\\?:A3ݨAJ6p u?dg7ZrU
/ƍqyh֟6ƣ=r93Кz-~Fk٭6{xxݓk0I:ƍ#<0 M\;ŋ2x8҇}Mh<QCDUF3 }TD@ֵ+
h g]"tNԆ w0ҁzKD- oV~"t/:A.-ƾC ː>/!ApSןoO߃f{)twua٣/b
t5V w\ 眇!.%&3i&g/k% LnY7\.!` aؑq#&Soo/]R/tTy9Q
R9Ӧ^aʄ9@HŨonǿI 2
w] N@0``
< ۉ=ތ=Ԇ]h8!c ! q-8zx6
LEK~ܻg S3Hqj\J.-+s%}-kﵘJ$D@" H~ߕ20pu?>ب0Am2i7R:;zP/0`">
/bt9z :*J
%üɋEg)ذ{ZO>Xp9x-C'L Mx?W<f$"س\ڛi+.n9
Ms 5[]Uo_͗1mT5ŝd^Y/W~o?{x}jL4bik4Z[Z2
YJj;pk<]in6͟nZUMk>fdmEpM@q{E 'wgZX02}b*{'tq[s ,3ŏV>AԴx-b
]*w*r!^~3̿t8swe ֊ӌZ Si}~,hrkgnxdL$[Jؑtv6 /X71J5|h<G7`en!se Z˽ug$2ހ4, HD K5ߗtSb~4O2*d*=Έ!wrx J+
vZ2p F#fqjB7= Bygr&"1!>CsK+^z.
G[ißDhii-dYPg)Pg5
ޤmK8ۉ/hZL"E= t>M{@WևpQVŌTpaLWa&xޱ ?\@OeGH =1X~ @HI:s\IXn#C( /_x0bd
bbïڲ
ii L<cGfĎ]3p6"\qyRek+ܢO^1hsݍaaruq$*#-N%BD2H$D@" HN@:6VJ4:gˑg3٘>yCP2WoڂfŇp31oKL믗#J[8;K%71o91f8Ekh(Z'<TM3qf< &fh0R>ԍd\uuc`!*`jPl~"300s
FLcs%"
_ۃ)d)ˆ =.s'9/}j@Bss3iS4 8V]nl0 VB5>2n<8s
)De ] [%לp uZh79ˮ|;vrk.[Tj'tV̾ \{bmjTf QɐjnUR ;n6pYx WR FdM`0oP1h/ig 0
5kR뵢4akoMАlpqc
iu\!Q|q(+B"0:5B7aC;{nV A֘
4PwBYǘ g^=uر H($/IG(^k}W /2۱n^LH |DMmG}[-RW5]ՆStf3%ǻ lh&/}~~у"i쩡˜Drǧ@X#,)3IhY3DŽ \i`mԖ0u
}W{+'4>#SutJ fkXq(Q y}8?g܄N2!,
)ޅ6+(,OP@N0 D@" H$3@_]+vv^dQ)fhs6p:c΅Ұ x4e 6l9 Gva §? '!ψisF#bLJ"(~> y6<vV78# 5huE)y#C|lݽ0KϠ ~ mMm5 Xtd
BYɑ{x
Xvǵpz8f
ZLq-k@Z/6l݁3f .. _q='0\bsvG! >~?= \Gb\f͜sMsS1lH 49]WP2́w\ߔ[Nv<b
x _vbN ފk
Ck=F0oj&Z _`
!rDBjVv /- &|7"X13'lG_lZ~^L x>w0;pu WEH:^M3Z DCk 5xރs'$cK MEF
GU;v"~!#
$ϯ~4{I\;T :h 67g4{6IW~!d|5̼q,6%0YTF'd _Nq:m*Ѧr=8; Qc]7+oDq
q-VF^2# mMj ͺ8z?I#]x }%b\] y[7Ya~O TH;i PRsbv( F b3+*Kc<P ;pтB.seFyW)W10 =|\j硡 چN!b18&&RKn[w 痸1y?*K>3]āv ?e>w̸v 0~It߫F%ϼڼq%3 u9[}Wƪ 2O˯*Ϡ D@" H$!@?hKğ쒣'zͤhq4h-.dQ~;1hƒ?B1s 2F[TI{㯊 h˱`D:Ȟ%Kؑá8{ i0+r\z \U HuƴV<W>)iPPxɴ6ګYDĐKLju6b4k#RNUh2:ʭ]sMڌpr?QzhK0|* nQh.GYE5鈫3! D7RS 11 ~HN&Nu ]|PIBp)V8+
q)h}4V"elZ@?4TlP<0ĴPBA5YhL Nǵve?%2 >!vw@(&&'#St2iCGbڄ,:ƭ!)}<&
]L^Ac5Nt $[+Aaq9b$2҇!زspQ5e<*O mxg1aD]ueV1t ]"5ǬG ȫaa C&LARrTWowX$~TpuWUȘ< q$;
q(#[1<-&ɤ]]E ~h.H 0QUgW LX0g
jKA7"3NS )'Å[z#M@\l\h>x 7 tT.@?vI'z(.o+p鼩2vN4U3 :D}PppC2( Z"v4L}2Nu 7Lm^!&k"bhP*( 4xU3Q5 /
jO}kh G)C2Gg,J{ (qwtڱQn^Hx Ϛ1^(.*EL1| ILJF/j<}0:s4 #9 >KΞԧ YSPET6"0*cɳ%t
FfbA OȫD@" H$D >fj+Q^Lk[+k6
eH$]
z.U˓Dӭ>^ZX9 "o @ngظ =O=֘e##WQp` t.:S7/l]>0H5l렿5wAծ* jXVB \UѦѝvtkujWN`WSmӭ-s8
jMOT^CuS%u$Z ~콠Q)Z/Z6s~4;N a>w<woNߺN5=Xvf5lVd9tuc#5^aĝ3vՊZUɖ6nUDF$D@" H$} pJw(yF57D(i^O攍 8δ"P9._UV
0JH֗S WW05jZt2q.d<lƖވ|MF50f Y.i\NpKp!']sJG'3猱'E JӌsU?k9Yծz^jcAhe$-nZrПfxzԸ ^==9^- }m,*5 }?QU#R3ΙNGRv^)S_7i"5X^^.Lj1V(G\_ ,| Vsܪ'E g ]ofm }\W^A) m$tثqsNn}H$D@" )gй}2:cUt5wWx:ES~^^^d\PJ4tC7Ѿ,z=Ժ͵7E`9 k :z?8c> <9Ʈ:R |QQhk<q͢3Ag:>9tݸt2k*Ε,`o4-TvUU9stF㦿j2q2>o_i> -o0ӌ\祿gV!mT|5j>)|nty&/PF@cј˫D@" H$D 8~<~ۏZcWa_D51_R1D@" H$DS8Fj[rbk}`̤qGDK$D@" H$\~73J%D@" H$D@"pXu$D@" H$D@" H~@"D@" H$D@" 'H$D@" H$_4hD@" H$D@" H~mk#*I$D@" H$D pc3$D@" H$D@" u8Q٧4OUMrH$D@" H$D. H$D@" H$DwI3֮͜߿ ;ltt5 =Fs4ηyCUϙNϻ?f[N3-vr}kiZ ?V^㯿._O}zGo~:ڽve^|AH^mDTsNM 6?k[&^4ET+N_9}q&}v: +3-w::}>~Zo+O_G_}ktgr˨OWʷ[w˟i>]A#>?GwIko~:;{o~ToVwOO@\\\ߤ'#6440L,y/H$D@" H$i 6CPsfQ.S^H$D@" H$BMo[zdD@" H$D@" H$*tq?*d&H$D@" H$cG
j U" H$D@" H$G@..?{ %D@" H$D@" 5@?k%D@" H$D@" =@?{ %D@" H$D@" 5@?k%D@" H$D@" =@?{ %D@" H$D@" 5@?k%D@" H$D@" =@?{ %D@" H$D@" 5@?k%D@" H$D@" =@?{ %D@" H$D@" 5@?k%D@" H$D@" =gAQ 7T!S udnNoPQGtƐyAi;n`Id=`~u;Sů56_bVUSCmtVڠ?~v_hII$D;Ǿ-| ,EmLlPףuҞ~FPH$oSU2rsFDgX9<3Jsn& fJ3G|ɨD@" H$g)
tؐe9cg=ߧg\>{&h8eg,%:e%5 q
ҵ|2
?;E?RrD@" H#Я}t5 F?o~e6լ
<-_c '
PfO #dcǞC 튺
w {{Ϊ{z[纘wRh&ތ [6# #1z08*clEG.,,}h<AQ3ntKc4α&TԠ-urr|}`/Tn;vc,*WWcj~P?yNE+59]K{ۺ8O4 N ?rw̘1 a SRgxދFg=(ܓ+ rBw11g*BbU;dN ?wˢwޛA'h bD) ]TM sBͦaW}\N8 ?jEԄ6堼Έ&CuUQ>Vms$tL s? +lDTrFd& TLqYcMB՞m?$ w%lk4|1Z
(m%9 ҂8. \x-T*JvtA!!ps&f caSL"6srqGpP\H=& (uvuGxD], g2t 흢ܽ=?WmuyF^amߑ\^ Xo
'5Ed^zSs@}:{p {~:T$L7>NBfGxV~ܜǿ, şaVOi=JjK"<1
FhԺ\D@" H~?} >Ez ){Df P9i @\CNG{әɊ֨|֣=D+'cEȑ#yP2LP.՛.ਗ\b4}k]rc۞ڭhX
oL[z[_Ez4uɁt_ BNdTQ-8B?r;Eu
字VyvWE KJM҂#ߥ<ߕ:}LéQ`r+JfS>ߨ|ڧTʤו[Tc:
]6?R?ʁZA[ݪm0tF.dxjijVjۇ 9ݕdݚ ōJ$^Vh%5wL]ʪW?'<.W xtܩ t= kwLt*wТ>F=rTٞT&9QÉ|.Vraɫ?:u#JuN}2Y۔EsG ϿVɯld,#?sZݵ^9r>X=߮\d+p_V+-նW(oQ%Q'?<v]l3f%U u:k7R͍_ӌۣop7[Q:wI`c7}rM5vw{W >fh/3Y
͡DYrno_t}(MUW.%D@" BMSFc6ӧ ncz%m-3 =ntvD}>XfSȰ3gG3NYY6sw<p4Ejkivecp26b݆Mؽm>xUlWqCU>pl
^ <:iT|~Č \lȲRQ5:xdf y46ӌ"82%0 xၭ5MK ? F ܊WpQN;nHtS0uD(7&l/}?Cw2kUYfIwa (.]bۦUeWχ3"s .j;D4[vR?dmEx!H ISRhm逫+sƛgDno2
m9љC
'`3N4B1N">BB
O ?8K>? ^j &] o;?;mط|21^ 4˫9g h:!ꌯ)#y'g b́3UӕrCV ];?_jwEIT_JNT~"cG3A(S/dRnAx{ Tvi(/ij.;6疊a<Y媒xdܬ
Q_PVVq^h?do[? Vܺ&|En ~vx/*,r E'QH3ݢZ7~cgAah$ }H
b<8h3=oP ?(Ϗݺ03'0BhC%ĉtN =\݉ѿ]m pr lʊ2I9ɁRg@TnxW߰ a% eD@" H$you'C)ҟiQQH6nőc0Ii?q"}wӁ\2oR #; 0zD҇Pp HfDDDK|'\=|DZ%7 =@;|qk Jɽdw6b۶{(UT>~H#G!*ď abCͼ$t`?b TVբ ~!yff"*,Uph=HĄ#n=Jб3w%F1~U {n ),B]c+C1dh2GZslڲ10i|@l-
jrA!u®5h$2?MӉͫqqLr@_#Mؾv
8{+o/Gx ;qn76k_jD=ܕPU߯C04b 5JbHD:clBq ؎ qIӑ5bXNPVrvރډ(
BL2}Y1cijǎu_cF1R@xFulÖp b R]'N2s?+;[w CBws5 ,1 !RG*Ї5{h|쩪DΡ:Ga9Ð;;+ r
!A6* ,zJFu.N,/:
Py>Mpp_ch8%TQXq).á}qrACnhk=8SV` -<CG ~0u`vvm.DIA <ܑ22Y""v&#rsq8E ^_N'L>=Wm)Ǥ":Bu]gO%eظ<іɃ~J?'U{g#!.(ؑQ ݡ^VzB=p d8U0<JvlǑupaȜG ؑZ% y{QR܂?%
:l_Ki s!<N*).l(!n awĄHK (wd4 f0E?^${wiò0g4S R*mx¿I۴^>N\`ˎ
}x fbKS~Ǥw(Q E/_l¦AuW|W5/?t7zjbl1o$֎蝽pÐ:e2 {_XűIHB<[hq-ҖmR+;uKB: B\ٻI~߁ww7gfΙsf6_)bqv=r۴EоUŷiNƙrAC?4o ݺt; 8 |da;Zm~MP_Jᵤ𫶽*6nފ4
@˗P9%2+ Yf;)}ѱ,k8o 7~ 8qÐPMyIt#)zDZe&D EqY5"ѽG/Duh
ٝ`mc?&&&&&&WT .1;jT+D ЖS֝J۳~G|ܯіn9ҜM>u<kղUm {蕩ZNAwbzk<^wXKWJןTy4v(>K+:0uumOhcST~ghaMt<G^{EAƘԳ>NJ 4^Kwϳ jgKUs>~g5ugڞw?*PN آտq=q#I!S{m;o&hRZv{{Դ_W4KABE:Fʹ7&~mޱ[;KZ?K=7iZ fh iܩq]us
ʵ5 ڶf^-56ĒV)sTi pWfnp%MֻW~ٰWL".?|Gu.>ZYiI5Gԭj kWoo-MR["l1uz!/i6x^{_r+ =l6E3#;^\~ ;o1mZLzB{@OƝC @ IDATk6h^xZkg5LT[iY)^axC 2F!.32I~݆wymtU2wfSڍ
&iQ|%h{jW7M;Fں V6hT! Wql6| GSm_| /״n i=YW_]W^UږEᘠ5"-OZ{njvsڱDesyo @Wy_^ ~xo<g/hSmҊIoܭ=%l^P<Ѝ
Vafc u7Eܕ%Tdiq-ܤqeil{Sq95Zeh鳵o>2B;o) ,L|Z=,mgji5Hw6Tej ^kZNIzrүzۍe7:&9j">8v
h [kZ v61V:?ypUM>Z5`˵2kco%o k1T~$Am`G
ƅ<\ ؼ/tz:߽|QDݳa1 oȈڀ,6 W:Muoam@Gɳ{emq-:H JӇJmoUܧ%7\-~w. IfJӘ5i,N'ӴS ۅ|
7h78VYýaʛϪB~w&
h*o&aw + VONţ_;JHݾ QO!ڑذj)EŴ:WӍ#1 bB[/|q=
ad}8Ař3qi[ 1۷m<mq: Wuz=)غv1?7Zڸ L Gž]?bܯU>{sH#Y"Z0ozj<:G"2`6{$>^]qݣ1%+@e9bO[⽇F0>O?a+ƪKpX4H`'Tb6ZwEO" |=
Qi1F
Nl;HgoIup [:oi^('Ds#f`}qn 2<7 A]~3*ńI~3s|p m׀N`L+9e^.t l7">F Hb*Gҍ>is_vpR O^``z:IzkyT; f'ޏ܍7AlDp: a9}; ¼ϯ5nHM©c;cS{A|Lx
b0@ :;ol G[zcڌ8|$q{3.pl䂏_P2nˠo]l 4䪐ms:{Er0
S3|"}{ooVub&9sޅx5ztZ]5F(7l#;T^BhUx8ޝu?Yp3& o[OaǶS營 ڒ^ nxi-c E*z6ދ{
F'n9!J_x &nsxю#Ľx$a H]ҪTVzESkյW@·j. ٿK{ggka/Wg݇:Nvpptˣwò_qϳԟ8A ^Np˹i [n ٨[8{;Z~to ><ܯ, #=7\Jt &2zhȌ=nV;,ڰwƑ_Ң|^:iqX ~+~2o ^N9_ jkXj5ݸ7هPy^98smO}s ?/>< 8+7n \=>Xt& s)ᆻb. ?_z@ɍ!:b|0 I ʘ[x܀R{Xb!&}#lZ :~7m[6 Tϙ Y
0oY. }Gp^ b k|LLLLLL"( D rB|xyn|횉A2g9bC;h@ 8p~tg=սQ#車شq *.?DِN}?}U㞑CF~8t7nDԢgqS6zWW+;W4M4z:4'[=X@ ;[JwR\FhkJ*<zVnArn߅Xwzޠ*+^ޥHKFhOFoT<0?]nFC^OQnÔ'az=SG\> ḞmvAMЮMKK@ *莛L*MnhֲjN6hͽ2sy&Aq;h"ְ
G)/Gnz"|ZhD=Γ 6mM#3PtFSFtZ)0A(jBb[lgغ'\N L1 GEIq--%Lczv>֒[# 0n bg$vľ8YYȱC09Yz Yn몭xݰ rsF0dҝ=yV{[4S7 " k_9sTu
)q#<
M]! QDvpsr|u-gr SxHL9ö _+ *ԣ_3p "\<a)2D u c$7W_H_װxBuG<rSS4 rҲ]:c 0؉q*dr'd! 'Ú4ݧ07-EH=**_)rxy% 0^Q4xwS0z{Wp!7.ڻʈPgzGhܟ]553Ԍsuf:F]='?*{xv(qcN<?\Ń8`in?ש9dx 0bcJWlgG{6o-rt©[%n []VV^.,! <8^
qjqm Ve ު/F%&T=N,P ٍ ͅǼ{d遃xA>oCn*'T '.Ӓ\'lwt~.J}$α;G/+73Gbh~'6 qfY<rwL $R}vx{ G `QЫgy8¹mL\4/p9
}]QN
S9 $)n2vlƲ> |صMIGj R?&&&&&&W-^w
.A ֠D@ȵa[ _Ãlqx豧٘Wɕ+c)QrӶ~%?DIر'^}-pS?z ?1auaw8^ cUt<8v<"""c-162=*~~ӇԽ6] = 6#Wl[-$uN[UWWʨ s`UW7--0NK
CAF, 9z' G6pw E|ՔOZD ԅBPdmsHt6 II҃ ]
`ꌕwmhXE]^.JM;7}nK_#Dekmg (ʕ Tң#d|q$jR73&k#~vR9YpQ$H%49U\
мCIZ%0,Slۀm ]- kpO*GrI 7'x Vrُ .qHPV .8G^ԥ $oW'^ ZӠtU1 )Gx yY⑯DO"9NTu{l *Ш VA!PV5qg_/' M[keJ\>A"\Y&K-<j`JR4,8DC05ЅW V])>U\.pk2 g(U5;''u>LևC`M0n \t Xgڑ˒"H| Gr_rRekq!Ty/赱WYia9nfݦ2kO?3 y_w 6luH : 7~C8Kyk>Caøw?9
y3Z} OxC [T3gC@-떳: 6 (-mc"5
a\RÉ\T9 @`nqpZt31~D4oM^܊ +
~!NA XND۶;BxnNߥ"!<8Dw/в]^x \
t# iW.mGOɃ٧eqG,p,!sb (e.WsOdaS05ßIE2\+AAy)Ttl:)¶!>BR+Ƥ·
m%.z6 ߦk[,&h}b>Vt57N0p0YNVB X#)\֢y8wlѕCѱq#.O-vG),A.~
r t 6-ڇ5<SJBn9 B9ItYmbR/[;
CG1w'x:.<!?!9gSH_nx.m|
<L*t(I9I91Y_ÿ%I)@eX:g~yR;ܾ5R R
:x؊tE<ܲcʹ ]9@38&}θJEb-O&Jo>3P!T S*QYm;Ƽ[ l=59lYwtu"{] ^̐4R:<>5)]w.1Ki\P
ˢnCޤf LيfG{'_ORYVLنH: w-+ q8IزA{ xB3ݍ 3h:O{g1TC^8O97og. 8MAr8i=Ӊ9ت!l
ĺH[nQl*j|<-V^{eP
=
By=+! f.ZЮT(N'cē冶h&H"aYT!4e: zeÃ$YBB|Yփ*xx{=-J,dVީМ}*6뒝2 ʶ:QuZƮo =;1/ .(i\6,udq~6psOAz4 w܉Fpn> [ egzpN0B2 G?OTqk-B "q\lNNO磪]:O| ό}U#.TЩ :n7z <W^KgR-crfF}:TܹhkGTMf+[G[ E rґWT
Bl\to "so '@u*Tf; #@RqgLKw966|Sܧ-F9 X=/gc[сVXnfrI7-'nol2)Gyx&<xaisNzҤ(\!] S?&&&&&&WPqRg|K) PP }x?xQlxsLt&|]Ǹ J
n]鷀%: IX0s^W } !ݲ
|9b
bzr*;&{Py'ܨ(OV0.GPq
K/T
(dGwR CIS K8`T $P/
E9(P*PXQܳ\I+k(~ m?liwM >?IONFr :oyUJ+]Z 㩇
w=j/$Ƣz<5'dg(Q_
\pF̸b TO !TWu<o~_<.Ahڡ+iYW4kT)g?{%<F+êb| <>? (Я"7X,ʨ'^ .*gfCqr ^[tpmdZU(WB\
JR/ CL ~XA,:Sik ylwZB/x
k|RS%7,bNOyvjzT~gRų:3YTPT/ƈij3@K Py(XXqP4>ݑ `|^8Ib3
[.9ə!:7
EyB.ȫt܍d{ NSް-XWɆO-eT6фn@)W:dcC0+9g<
k/-X ]</Y9Xf:B3\``Wm8qǻ9m+O
Ŋk0v\ uUs7ۡYv@`{s^aW!tꍙ_¢I{(Yú ' .
0%O ~h?'zSė.Gii|c!<4
]pv7hoa呧gp?KzeĶ~; }՝ȴЊXL =*Gdp9M/WDvM1`y'a h^Z ^n]x k , NG"'g`ϩ˸sH\ԭ0e > {B :h"` /I-dJt4 r*/&EȦ7-:3>VCPVKe~&$A'֩ek a͑xi \̞1Q6d: Ę٫0q kh< 0yX7,K-\$|R^Ų`S$bj .гcfTti#>i' Moz-CԵ6 q-Q4\U\\AAYM5bMۋ{ ; l|:&ȇѷ$nթn,ط*N.TЩxcӺXs/Gu <tE6cbH8<|P86Gl]H=#,V
YBy9qBZwۺyxճN| QPD$xd$n-g+< xے*<o1G!}A{V e
&Ѫ֬PuX˷S#ud<x<(h~֗Oצ;z6ą*y_1|]HZo{Wƫ3oc7uň?Qi[>-zwXz ̰y MgCWj뮡g6iw,EţC1wDs^+ KTGWWgFzy -swj:z#RP5~0P;he10+Qd {!AR Bk w /;"MoCh͇
#xU)]7 k9hMФk{ ͨP Wsɠq9`ޫnmoSvbw X ZYGt1aFʠ*珞:/QK y XK7OĠCSt H"]' Ŝ
9x e >wr/ I[s1uF4j h |e տ _oǺxm2.UvK sZPsݙs% |7#&.t%ﬧu<h%S1+n{viU^9%o-oŶwb}.y[<W$:li`c)[c[ [*t 6"
E". gV.<Q8r g+-==Ejz?% _' ?S{k / M 3D s
l{z {?o/saќxr1
]y
[{I_6ţ xgHN ګ|Y==1? } yy}{ Ą`˅d ~
=@$x=qg=v نڦ8yH!/ ~Cz6gckU<τ)CU2^BhwC1v{XCw ˖ [ k,>?ߥaћ` xP#zXV; Jl3\
Z/wEMG<݃J+.#ʙ]0C#Ó=w&G {QE7[F!hۦ5|čOE2e >:#I \<O` OsAfMÛyh4Д{H
Uꎐ`Ӆ3):-$QllҔvG '7n v|I rEgffC|zI
"H f3 z{QIKCZV.ݞT W*Igyk]x!܇(/>X7IK`):}A H /(=O>Fܓ 3;K+OWWS]T!uҽ<VXZT!0()AV_ <(+Ǎ1KU0'`(bg`2`,<"}f؉X/WE4m7@%=x` OS{߹)-gtN˻ uU ʢ{97m6
ݝȺʩ } \$"⒪ #G!{%&|u u8xZ5[E'][sh5df"rM
Q\]K\<Uk w䱮%/0ԟ{CDSG0݊ݩ(Vzi t/.FNnyaHrHL5˃> $ƥ~A
P5%+%ɉ(,뱜d#ɷz?˧ Y |J~i0? +dpJ&O(wvwCrSNۊ\\nA`HCx{vXס+cƾ[,T̗Ƴ3a Tqv<8v^渐S7 $n^BӧR9VOGI )HOG6.G𐑨߳wqFXF:3<X/8 ND'"=^</^hNOo9,UGx'_`nRH}kT6??mC&[B}߽䥂DDl8 HGxz\nn HIρ7DÕn4#%49 ` 2Hrp+y8~rxp 9 ͚7WE-ZΝI"3[Yxj+ 7gUJ=մ ;>FJy^9'J}MhT)a惦 ,QR q)v+48I ډG7.|Z# <m( jI ӝ\y^I }q(e$<[y -G'HOGrz&86FB)<D0 Vwޘs=rS)/pS_YD Vm
TRb/}[2[+i4^< <>nRmjm"`"`"`"`"`"pe!pQ]aV%}iJHGPtu2,j4V<z O] '\Kbx+"Qm7'7%Hk[o a 3Ke WqDL6
wONJ1)뭡'8r*1#VYzb@.-7J
v8(kwp^icCAI\my-مb3-fr0{ׅIeWRH!9}fT- F*/.L_yntrĆʛs9߁G<R+:+H~
Fz?u
yVg
lp?Q
D^|q(I|ąlpwh."A
~6\ w5zE@]DZD*+-W_\(aOE.ERY &\MLٮT$U\ o-ֲP~n䡄$ oɧ$/<2 S~؉!7߉.iO3xٱx_1s&_'ȧ:%p^z]|ywk~}C / O\dfsa]>7.^^UA6Z |GX
E3 0}}9ߗC}Uy x{b7,Llm)ǰ`v<4Lz
z}M`30000"M!]( hG 1uSH|dX5D $門Iz^y{_^ԇX9Q.NVv>fui U[WI'ebc!yuB^Vm ]_0c
3#ܯK\(Ua@*I(F9FNRn2 :]4*3&6Huxnzc6{ n_x3[#ʚ+@2 0?Qx+i]̭
TY};"OQAS!%,9RU[ KLQ/"/*|o3ǺtV'A3/Y ^c`-Z<WGӉ#~ُ]QJ7l>hz*D1`MAqq+e{X% km鏗~kQJ܉\BӨ0Wlv:4]ʓU]YԭoG*Rr$Xt#U?%^3T y_ȚNl[?۵̲YnHZy@[ ++4nU/z RUdZ a=@Br qD cyI2cyixzZ!l>'*H\ y f:uc ⦯+d\ 㩼 V2 H߱QH: nuruv&_4F>M5w37P,UFLWhߖ2
|:HgNcI_H$H<Qrީm{ T&|= &&&&&&W>& !<{nĿxF?ww]ӈCΗ//EGFܺqWQ"߶*
F9nF̛Fn~M{$Ѯ.yMٳr &!Æ rzcAQq L:< ( O
/o$^}q=362N{9iu|.'W_N\umد"P^ w9 F<x<%] {/3?WA'ԤDDD
KjKu>1Lr~Tg~ w?c&&&&W5~U7Y ZߕՄ@ʓ
.H<݅Y ]]gTnZNRq#c a~\=
ӖfMLLLLLLLLLLLL`j߳sW$DDDDDDDDDDDDDJGTЯ4700000000000*0J\
ނ&&&&&&&&&&&&&W~U4Y + SA[ФDDDDDDDDDDDD@TЯf4+a"`"`"`"`"`"`"`"`"`"`"`"p#`*Wz \^4
VVVf>L XioP.F |tY\.]n*N^$uUHS]:Sui1,?{nM *?,DDDDDDDD e2000.VB0wY7BR3߄UUUSf6mlll #ޖ6Wdqvuu|`"`"`"`"p!! ___\m?)EX(//W"nnnSPc
JKKQRRwwwX"} lΞ= '''t pttT?uL
2̹2]-OMK{{&(|eRpŹ,tݻwW%r_ef\6P[\\ 4mT)PZ
"::!!!BYYRC@@!22R)|h"YP*"۶mCÆ
tՎUF}OnݪS犊
S8gMG ̿-ZP 0Wkoyyy8t萚'`,AdD˖-pG v[t3\\RA@V]\\ԤpuBϨLUVJ9Xѯd쟁Q!m x)!YW&"0៉
i73jAEƭ5mݺ+Ċnz7]]-ʗ,Њ(+-+92JosXXZ V`ѿ#9yDDDDG
LXb=Xi
+"@X8dy~YC{
`+xP&oWWQh` bokb<3~/
.,IӅo
G^]_+~Inza]z!^voi'3j/Iz%Wu[3FTWIt>n8xv ծS!4nu;Wi8Dʓ~Yw~+//q~=/]οS FcQ+tH|#_M'i/'nK*Rej?6jNL(Rh'>hF2dLzR*t#ue;Ht T}
L6ti|uk03AZ
VH[USx$2|0W[ON҆t
R&Vk~gٟaq's
n-2WӪv
iA66ēHاHKݥd!OυAgdУfݤI}Jwޯ_Sڍ߶WI+C>^5ZV1q2>$RA!1VԎԟ$T3~Y KcQSSԸ7Q4Bŧ]8ϟ{e~Dƈ?Rn}Hxohtc̐mk ՟qlqV [/2Rz ]02nCFzia^'45/q,7R_A[-_]^:3*FUd+--V}{<PJ U.s;lalj0&/
Nu]^9-egYxɄkIޞ.'g
(uE-KP]wOdͳxQf ]Pɕ0S7SG`(RYߒ K mmPR\DTlm[SP2%=5JBZR2
? UZjK% ?9srE@?B0$aJxslGEΡaG7cqvv!Qm ɧ>ڌ}&
se9_T
?zK;q"|p~9uE<7SUU^J'i iEZx0'=gF~D7șH{1 yGbHT ˋ r#]왗,Qp2UU -1m^rnIjǏYo%yU:|jmmY2WR]T2mrB
KߨܜJ-{{H#
궡чοZ`kYn!\T3ȷJ6 4M-*g]YzX %H60K.lz<3ԝ45dk[w %AƧ+Jt %?^+
g82SȷpC`(8 8z!بKƽYh/.τ~ %% dF %Q'}J,R{<|,.Ə5[ڣ-u6]xL~K~/UW,c%ȳ枺f-W}WOd>x9νv^.W KCV$CZZ:W', 3Ik{s i-χKMI|ɷVRBQ"_rl] 5BI8>GUK mQ^*gʫ9QOkNed˸r$ZÊx;JǼ& i|Ӣ/q^L -UV j7'B7?jxޅ|*ekǤڻ敉Ղ*j$Ua%~8n
B1|04
GuE) څe+ף ݄Qʩ".N|2yVUQȢbLLtiEAԆ.4VЎXz=!7ބ"iEАx2 @v~ Zw鏡u#kQ|
K4Lxjrg"dǘT z&--
UW X c^ ]:0IM0
e9FzimtJX+ Wf/+ܙGa5X4U6@ѮC
0?7ۺ ǓգZ6Ţ<gR}u~ :֕4{%Ti N9}zo~ 8rϵ`VW"`ZtFY[\=Xf-~~ӥ3:E]{MY ªNo> k\ ,tXء0g/[ƈ~U >( zF
sB.Y,,CY '3C#Xp * B "4E6 2Y ϼ;G 2)eGe_ :JP
eU`i]?(%Riwꢞ-o L7LcHǺ&7O~QdݩQml=ۼ kvO." #5 MCz+!V]E-ۨymA~f0 s_چ`_ b_;K>/M =j%,B,)x)
[HZiG
7dѤl~-Ng
l?URcOБy~zI#}}}X"?Wxk_'!v#M5!A+k[$oynOR#_&,͈džM ݻF́(3t]T^)6w!e SRGMPTD:-Whl[>L8 9yE p帨Ϡpb^6l:{Q V3F,Xu$cr__'^( $bH=V1Y:]!!={uGXPC@{ w@c vTYgEDEi3vtVRG蒺<hkIWێ':_ Oڅ4U,m[[f N-z>>AD*+KvQcЛ8! ؉ٵe @ IDAT7aٹ y@>Iߒ9{[% ]ݻIѸi]pFKh D:Hڏ4 r-Ռ9IYܜX5zvFadDDŽCXl-* )cBw4m;\5mjC:*{C'bۮn۵=2Nb7cQg[ mÃPyGƟF[ֿjزr) :{O 6훅[$D\$Xbs/#[#c{Cxֻ,MSL#1clSx"u#*B-s3\$'A2h;[{qx0J Ӱvn6uI۞OR 'R9IMʪ&%51 d4bNNbMK< Ѥq88cצR
G5"AG{Dj+u 2Zh%wp"T쨔RjDj+;87pPAT,VpR-ߎeSk IJ,"\iiebɖ-$ހ<_w{ \9>Y"[Oqx𥳐hFAD;Z7;#H E0aeEu@$L*4-#."[UaEx쥏x7?<N\ X<sV-[&mG#_opEEĆ <-]$8hP-峜K;т#8)m 8>%/;mmNGٰ~ c=&b)@Qnqމe *]%eΆbHc} (E r]Rȧ@6Q-Hфl{ ǓBxC6o}>,ʈK\aZ"-e.%RUB̽H>rAl
C ؗ*%=I`j+H**mieJټP۵g?]ӟ¢:%vjql {;Z .H
uJX)W m O
lj~"לmAEUzזc OnZQ|tWuKbL>K"6,SB@H=Nѣc+IwC#?5V&/RXT [{V|BsEZWڲ
Y_;8OKDo_ 2ү*&RRX+G[͌ko D ǚm+\YLR mP XVui +i :
;YVd.?-ZpA.]WQpI~em_^.N& paz }V5> JRbcg3%+Znm"(^e_??,@H?lmFaۈ :Siu /"gI)M5c
5mB2IUT2=䷤v:d<agLLbq^\x% /Y yy|UCN<~aD$d|$ ߎ֫ ~a FuQ,ۢGFh~$ss)#V 8o @fb &6nlԞ 0ɱ ˂\A!:4Ic?nRg߶2n[Y+SAޖx} * kѹl|>jI鷧aȼ%<"TJ9g$Cx0hKhSｈ@W9<EI{'g.J|)\~;'+?vJepo摡jT +%"b=En{%} Qw=V<ѫ}٭n{cQ1@
w~AxA tp$|*Mo)T &&&&W%T$Bl K7n
<5 _R9o *4*'w~GLFk
Vb_+W"\5 :6GXv3|p~p"5wjBlفVHOMc!vhܼ
뇶Ð+7' .8z0^ٻ'| ʢM둘S ~R KFq9N? -a } VT`t茾}qHC' +0MCp~lٺgW#E;\ IW&^k
Cyسsw@'ǎ#}:rFغ| NݎʼnE E ұ#ص{/ʨm 7
d$eCsl h\.x#wtZY%h[7) ! 6ޮ5. <pP]xl;w `"uׯ/ xǏFc玝827qzp @hFk'N'$:}b[бyԔRI&z3T<LA)6
EС]+qز7
CaW~Gb^-Á.E tF~Axu84u)n|3,3[9VdD*p`nwyTȫ2
.XLq; ߔ v놖!mX6dvl^Y-@.=q yԕr*N{yQ>ú@˸_#t {^ OxqMCՈ쪊(/ǚNeJH`t[5o.,
*h2 HIʯ+}혚7h zuAINX2{_N`p ݆
[
G/F+܂;bв]xЀz8:=\" d;{ _aHݏ ώK#ߛkJW}C6MCIg H~Oh.
]:@zQZ!-"ɖDlۼQY)G4mE~Iݺu fm:GnhDzBY; ~=khl?6E`g eghܮEQQY4.JupD{zȢ# Gvn¢QPE*
9uFרpEKYh0\eL`Om]@DIe]6oފSe]ZEa8߀N V@LJ> Np ֯_1qqrG[z |z* Xk `? ; zd`?q {0Q8,SʹW,3eqVL ޥ1yu썼S}
:j[G֣M>WF7|\pݧ78cM81h@4t{m9qDZB ;k^_ݱa
6ksfb{`
Rl|}pK 4vT% ]Ȼm^8zm2
D.-C{aЛ.tҬSXhʩufL]Ey,G`Uv:RsёzsvsFqoߍjk@Nʷ |s;[Xg[.
n_6v
gk^3ޘ69a} =5_Ͼ@%X o _+נ{H#_͛;OeQ { ?Jh>@+<4is
Kb[ZDJ9wosضcF EX._D ڏ!-# N֧ yc+-i0}GJjG=dza8p$ {
a.$ŎMk靘^
Ƶ2 ڵ-Šڋl!B$ DDDDBVjoǦMQ L2u,G3&Q]_~.0uo߹1\01syzl_%f.܍;zpHCw ۹`S Z,6ˠMϼ&\* ⋵'~˴`O$;JPI|7S4m'ORO[AQMUKnX O݃s%68p&t"0Sw'`O8|(+ŤzUså*}F˨MF(([=%],$ӍogßZRƒ羮vރ-qat1y7jmq3OъTLzg>:uPWd#/3 klƈG_Íظf} ^AhʼnxSO|c8Sp< V9XъEuwWw)x7ᡝ}Īl" ^2 84ꂆΕ66 >iAk }w%>o4o6&q{|;S:{.wmј>3!v 8dwA@ eV7?l ^܃ w
rW'b;h|]wapsm;صǾœ&xjHg?>jllh؈)(pADT@,DEDETnf,Xws>&Ew~,Əuԅ}o
25PlXٳfRxx(Ȗyu;K0LѓTeu C R <mz ϽLf8, 8#C))ϝ
R),U>zΟuFAvf?z6gBvYزx~Q[1)DE*?+Gw ;wƑ1ot 3Ժ Xy(Jb%NŘu֕xp*Z=&7fg}d ?OV?*VGْQE ,Ci W82< /q% ᗱem\%
΅~ՑĦ-Ck2:-W0a_Fd9d,1ӯ#X=wKf6 ` c>^
bǃᘕ$ż)x!%hFtUfRb4.؆fh"{vI-CJ\F勰ϡѫB\ q: f!#& ?N^%&0Mq}? Ԯ |&JGY/28{J6iV1q!
#_{11ZMJ&W\5 UFgےqݙ>ұ
><b. %,ݐOT?Agj"U̙6$^nZ?|
&ކ EƟ{ Py=ŕkȫ,FyL>9q15t0D|շ*ϼYX"8gRՇ_a~z& A[B*!!\vHGZ"!>N!n#q`B|8n4y jǑSh#*ص'UWjS ET_߱;WEzp![D\- p ݳ] BwfpfJ u~ B(A߯% dܳ(T8B%{۩2X0o~8iP) /Fa_1 :wi3'c./ikg㋽Tޥ+Հ3Mh!o QOx _" vd
@$ߡ)য়8~?}J8Qʼ᠆E\vjRk*%8!N48wzB 3||F,+{? 73/'3
]i:ާ*Ng 8Q\ㅹ-!>voYH#tXy
dvK$DD[2Yqz[><> "3F {胀BQř~L0A2 hȂ * ƨ$4]!WvT. ߎ$w\pCXvY4W-;ĴL|toʷcѷkkZkm
ie/gJ 9Sy/#\YXǠeV Zs{Д1 r3-إF᳞/bq FF / wJh|.蚓E_C 9)Ui yōޑ
"!u1|{sΕ-P+(S,
W5| +XkPqQ4wr%Gv]II: wyM;tDBo 3ШZ̲&vwv v6W%}cgxu8g㉓(LY YBHmPtkE\P 0a1n9jy
!?yTJb3~XV/V*3:p$zЊEWnB:#+-Kʸ?Pb^ EOTQ(rPjo!9 dŎ7.i9eA?a%QR) 9o݃d Vk ݣ-" E eqPMJis&m)d U,tt2M2)e&8 "iVJ*դx:Q3z @ 6 -"N F҆Mq+矯@G X3o$@Pt bbƓXz/UY:s__L6+M~@rJ_-2Qdf:ۅ; K` :LCIꄀС$* X7{rԷS\*8ߢ u|b<q( '\@rEpVB϶a.U
dE,_,M6$?S샢N5F7B S?ma!p.eQfTk
}gH%W0# жa ؼo UbȀHXHGq ҴBC17 kc
8};p"[xCter }D^!pl
4^<,A#Llٟ>A!xo"1vw:8\QUAe,>CC&}*\ed
g5NƭhdW JNɼ_ '-8=ѫ nm̝? 5BMQX tjB[!l2>2"ҫ9.K#<RŚ)_WLJRc y9v}?R8Rlݺ95Bur&^g^F38f_ȝ6&NK4UQƷ9aW`+*K}*tv3jyR it\2,>+%
,L.殿G:!زr>1#"& nս?~ 91WDx K@"V_u2|@\B(O唤T4Du^Ƥ"%lGBNHq/zm>Y+R= \Qj)^X7OdԪ2eJ" e;0b6l?=[z ϒL Nf|@gsi &.ڊF"90 Ѹf9iT /67A:w7b/֝8MǒwGd^"|)"`WUԊ~sqwG\ωK.lѴ^EގB5gOQA[|/y<bq8 -ꁕceu#\.pq0J+X6g=P9Zl[>$Џbᓨ_3 iw±g8t$4]IpUj_mjκ D^!8plM Z 8nY5E!J{$Ή{tEܢ ۡepK[l
& ` O7 @
A/[\a
Kg!V)ͦKgOE˰axn.6bcZ
ε,ѺEja=X+l*]vX&Ca qEK%6Cͳ H%Ⱥ9m1w?Ww%Qed'$AA p:4(}sMF[yl,c2ҡҸci sYd25ALF:(l0͓aعt/G'U$WhGD<\U|>79s/_g27joХIU Np)IwOmnTϕBï]l ߴ
7iɊ+/2/W[UUbo&cT?k7Xj=r`COB䥣6nF",4d ヅ;b0)
oT :tZk~p+>|{I _ (5~g w 5)EݗjZj>p$Ʒ^ńdnKiwoG"=%ě4hwiؤ ~ζ$̐w
ma;6cL VԭE mW`ݺabdJH(DF>zÃHj_?|WqRBjDNT*wX= )R* {M/Qb4cTo+V
.ŢՒUvҴI}LW [9Eof*QN*Պ9Qks: !3:"NHz l[1*}y 0")bq"p˞4ھf^`]WCtƊF Phx*\E⦷A\ oLw.=[֜ȋ<;jSD
ɰ)Y0Ȕ&BHIxyz>
U.g; 7$M dRP]q&N-jH9L~) g>i
a
}Jb<ud]R wع+T@6*0Q *vyŏ'jkw$ܑfPNHCXhQ4P
Cq a!aG5Hpl7ܽA nG]i5 #ᓋ֚$J
v2<pDiЗ^
s:ltp$Af J K0~aPfSdf:0% K:( "^\3c8+fO8X0Ri7ͶY 8 4=3 |l-Ukq HYZS(扵[<ԫ+6o.RD6 oX KI9O /es@s d\qp#HUFU/5Mn ?H<K ú|sxAx3Q"I HػEaҩI</F0|ǀ!жE XуXb%v : d,A+L%AݸV:9Z#*3U~ L♱{QDB 'ug
c8gÈ :3w.{sT0PөyVHm[1nE3Z3ᙗM8x,洞*Fgiݗ;LhWgJ0uWUc & TB1t1iԢPjP!6` vo D ֔lA%QX}SQBQڷ#ٸd&+=l\B=^' HT=3 R:,>_Rʢbْ8{G#ű]Qb!Qޔ:uk,xMe E)L!SFJ
4hbלKɔ*OԈѸvP>=`@@hG<bGҌSSW |@5ؘhܺ~Fw)M.H8IÞo ,b_/җpJĄy_3 D%"pHL+|(")𭨞 N:G7U
y/ￛIW+
(BI c'
4xa =E|;A)G4
VHʕ3ǐBYH)|gd(8ד(j+xx8X20_AشdfO~FfhbToHDnq _oO'Er&^㺄#c(V7\ #Ic82h+e,ǒ|>8y?4!3'(;[Ӥ|)xP!@(ҟ"=}S=wbqy ==pQ"fSQžӣ / ]hFiPHE4LH!S
c˶;T}Lk&1lz3.$$J2!s3uAH
{"l> 5Jg6.OͰ`Wp2Çv`t5.ͻ.
d ,]N $riOjdEw3 +]y0;+'ㆸ[J$hkR| ! i鈩 .3^]&Ķ0S}VJ-Uオg-E.ɲ6Yigx;|#n?Qsf+Av9iG JxejzJ'4[A95byJPlKhMuh#JےHy( YN cWs 1A|uFW, TYchF ɽ*lL}Xx.lہ"5ۣ$-rɬ2`]R]_.dh8x8LQJ:zR[/c㒝9?9NYD;W:>KSZI $@&N[V}"tetlوvdosqwD.j ÃNd_1ڮxҪ N"4q%GƯC\.X ntZ0}ZU܉ęc> ^_7mi:n G3(+D! eik^mP6BԥJ-
TjHL/+ ]Gfd(7ZVHe8x:&9qJ^ Js: Ke*a%,#y0,G&찾iF
^^p) 7a e< p5 V;bPƢ$G[h 9edU |#oɦ I8spj=_J~v\^z{5
D&z!!8`ki%Gr*h @}%8|MA#:.ƹO鳍̕G$>"3^Mf1ALx X*"DZ$$"AqzJ <h
IDMǏ.
fhA̭<
mͳ`x [;F$$vu 8yp$ҹ,l(+ׅt L c$DŽc#/[yRBX#C
QԐ¹j{)r/іQtIkeQ:WeG#q*ɔ"nVvZu٠^J
BP ȴ
QX82vX7]{{"ěHK(UU7mDN،+QGSaGR ( [QUO?#R0/v ^ NH<^CoHQhR*;Dq#ӹ"ۊ6ڨSMĹ03J)LMbo< H-{/-qY @)*P%H/[55C mN5Ճ2giA/ԢUX<n峴RՕ@&=KH$CB3":* G!T8 *DКǻ9/z7@ɗD홸z#X6 QFl I ESU4 (xd[mIOEFJy XJ?*7Ua7ErN ڃDicZtA-HQNoPMH=b#pĹuJ/ 2edeh́CM2V7/YR8.Жuw9:\U w X!R:ˁLZaOKXc+{ 'Fc+gJkWPǨ u{DS5CdiKj9Y\#D3GBljb0JA'erC QAT\c]hrzDU' {҃6ŏ_Mw:dXbjiNU7I{NԨ"r /G$j9J;I~F/KI0 Z4|1VWwK l Q4wKp9J1 ?LCF u%Yk8xL }$%toZ8$I+0uND;¯ásгD9BD 'D3dNp>qh g%ЮǛc y XbmPkRoٱ>/E:5xlسՖ"%˫LYr<d=_]2 w`
vx"ooḐS$må3% }$f&gڌ E nTۦ6?*;ҵ͈dݒq%O-_I)AkW
Y n +NL' |= u̡]2BY2A.a a|YauB%oƫC}aDJHKMѪQY+l
-
8{ގdžEE Dn!9"799G7C*,+`/W2c;m_ET<.
F> '(i_D
*Xl.{<D*j'3Ԍ~&xDڔe#&U[Wo*6Qc0ƨӷ6~+e:M#l8pC? yȑCXWjPZ~۷MgɅs>'TX8u5Q̿0b¯`܍'-( L0A
<b0+ IspaD9N) ort D[ }?JEuNTẄՋ3 W-o UHݽ{YjȗH_/Us|&c̨U:cQq,閐ډl咟O
U**iĵs emyi {o6Y
@]зg{x{=&~ 9LÇ RqxnH ,K%EV<jy5f3~f< M)oP]3u%MSskG4l? '/oZ<
u3Ti5¯S~/*.[slX.&|->G˽6 /y/y=;cW`mϣBbi7낑1/hs]ЩC{+D2
syK M%/6Xh/RnQչ iZ9tBab,B(EvнMCP12IP03Jg!gҏ<sL6GMT%EO/<)= !')y1{ ̕j>fs+Hk7F!U> )陕a\{K:8`
,쐚A_GigkJWf
i^aO]`V Xt
NƺXcT)G` ?笨KڬC/R^D:U>֠i'{{%)hU֘0k z念D:O *NsJȕ69jsTc+7j fQ%2X+ }Ћ.d)N/}$6ץs<{O|BgVMʫߩ9;@jF_*^(^_a.ga8*˻pM@g75ƅD< ŔZxಘ9c"Θo>h?ܫ(]:&F'
1O
*45m;6
hP*<3 >1>;f?I땔41 2>9[q=Ӥ2+<1xWx`?T#&yJxYƭ ǭT<(U6 ߌ C Vm T -wP%m
Bޯ_PZ3 f 5i+?~cо ٜm_Qs.w0_}_ĸh\tVmHOc @ 3SB\qj;%%JT][9Ho(ޤyq0k|*=)A5d[}D )Ge^) E[+ ^N\{,v
N.'H(] ћ 7XdXGCq1iG7DŽ7MN8>m:8Uz<絞4PD dy;Y
{/vS[I[ė{ [9cx\C V:H-rx?Z Dߥh)^.ލӭ0aDe۩xm#2Sj= x O[ODP$5.uhU5 54
D
-Y=u84r,OCFw =\\}X _o\ ~ֵ LB858e6!}CV?bteNa[(ID1+ Gм}/:GSC45۾ݮ<NBZFg{ס;ѹQ<}k3%2`( - o#/Ԣ
'seSRmL+L;|* /s}5>nL0A:P[TG[i}ɱ8ZD Jx&'ӉmeO6Q%'%3-G69́m*nVt\i&RT:IJspTdڴqg# NcyN-$/gЮA
ȅJZS#HZeɍ661
P'Wױ.fTKu ؠ%&$7SIt)+i#*9{Q/v;:G&+bFU Uc)JH9,:2#Aȣ1 <zXg Y:+بʹD6&&lZ)
DRv %@ɄRՎj:˖pxS%se\'"t|FV >g y,A7d'Gbį0vr9j<^s(k# /+iwa+A F 5 2g ݁Qqt8&28/]9ы f8<"Ȩh%wtBdIx
ScKk;uU˓TÞcӑ\˳I䙦 iLL5di"j9=[Nu6-%=OINKjzkcͅ <i+}-pdag"Бs욳OXQfdJD)fz/u3hue EPqbCKKb!cOƤx59Jp$dOBC&S9j欿;my;>Dr.2l g# H4K Iʴ$If9{%6
~\+V#UZJۖT}s'1H]JyRYdkhVݦ͑V'AT /sPΟNd^#_cN
D[9܉is,T !f kN*uVg-{w"Ⱦ0WCyQ]
;1%Swaie<Y<kxIlv WZ^Z!rfiK CPY3) G*; g5ϵM̲֥]˕g'5#5Yb.kK){M,bX<ʋJiH府̹(U9#4J` /kJ[d|ӠDfb!*w9PsyKgoʅ,2plt|) q\ Ȏ6 I![ Ul'9ʜy#cފpRcDlO-15@q ػy)^stֳKkpMٍIƵڢukHnط҇9TUpRgwOt5]k"="SR`$s=o cZ{Q}^{SLdϊ!Lq! >[2"?*g_ɪw)S [rqbjLXpo)E\PNp =&cK=B}";f5# O3;y/ k_1 .N3w#H; zk?DSG2eb'[~
EO[wD˜k &xYE-_Q>xM,Q=BN?9+ >'xR lS8eq%kr/Ԃ @ IDAT%2DWu*٦$&xa+ dH{mqy
Y`3]M0Ax(.8 "&*b&1&HM WjSO+hFR6vner`K8MwqT Blʚ bs}/:AT?&c&I"wٰ
O)̅.=qqa<$)Z'eHRPQ8R'@BƆL2\3#Uz(]:WWW̃TNy&txuϜeQ {HmBBI Gɍi*_~$F|B2,XSA XW_
0ڮ)/ȔNKR 1Z_}lGkƼ>.E5Z@>\$}a<$yx5Cƨyd䥗=$ 坌iED.@<8&\K+i~˓*`ϸ\
S }_m/sT;Nןy
`
N0Vp<1U[X>f#CN58 H^Rj>XSzu#ɞ~+#_ 3WeB #Z
RۓpR|/S$ikq^L}Pk- 9 C }-4j^= y=|Tcx_+>/ʓ:K^Z$o 5ge.(ǧx&Lk /HVVƴ8P}z16(19iuC{ 9@ᛯJ BP lY0'P 5f<H)KT묏A5ee
Nm 5YI:ah_ C m7e'x.JKR0mɠ8VqF愾J|$8ƛVW}|u .I2bG e O"m uDz.2om핵^eq,K! ,2"-eX@]
4P UzL0A Ml¯AVQ0CPD=M$lxdA/4)!t%ĉFH
A9/CBDw@)C%vR!A=VG"P3 Z2V. [ _N+ސ] U_KJ=W h#&?n,|eĔ HhA0j -cwyI|~R"+Dڝ) z"ǫ̲yG!>! 2~K$HcOi
Ԉ g g=Y@ kkA6 d=d SA yj
*0B-ؖ!.6ro_kN}0qxHws5^: F%Kyw{-62.Ȕ`raX'wd ߵ6 zwbqF1uPSezJdQ-eܽרx{<UQq*yzft*Ê8~JTߌGyNG6XwG
2ĹkǠ*ZLu9y6'%_c˽i\uAߙTi7{gFޥ}~ > `=S Hz0ӫ=_ݯz5@ٰk^y=!ܵưZzz}O`(C8^L0AJ<@"֚*UA
!oWcîaqWa_q<J\# \"8p8\2#ȉH>
I(H1L_A`-p@ʓćNm~8h%|2-ɿg_zla2?t鍿=h}Ǩ>>N 'n6=NZ[0 '_=FSAm s=~_]K!xY=RI
Lg^wK@\e G*1ʚ*\}Hkt=FUZ7$ v5 >6ݛ ` &<]x .ƵkԦ*&jY&KoedB6>
)qlH$q\>/yI*!Ǒ<JHɿ_ڤWJ=KzK %)/::ZAT̸LGڠ*xݩ˿azAK֟d*@1˹:"9 mLt:kH[e]XT^=Xc kIoG\ 5Oj$x)&}Pp0n+Gd
Ҿr\1"2 WO_Ĕ@/zUท}G{~}nG4ݼyL ` &x .uI]7: dA,t[ʆ$ؖ ( W'eCMN'p%|W=)_6C}C|eC~M[GN_` mH%i~6 -wrW#1ҟPzR>}<K8u z?L0/2Y̹딾\6a\_GRWY'Nw5ST)C핶z}d-@}KG_p
uA ܥ$&'z=շ G[F/%?iaʷr &{2G {^_2 ^ck'?<ncA|v & ` խ[ŋ:[7lZ ^(oXŧJdoׯ+i MJbSx trMު]B h CWӪl & `#Bࡆm:ĭ}Dh:|)"H\%`d ֦>x MϙIjoHOH.xYiA?ަ ` &< (A,U=w.Fs.%4^3aH*4>2
3Py(k]q )IOo~ǫ?Zc%hQ VK|%W~GwZN
"N珼_1~y/뽞~8y7$(cF|W^_;_/|W?I^ysjxZaʝq{v?@Ĺ_6r +/Y0~$H^ PF|ɆE>_?1x:WIǗ{i[0
/XWNqv% -3]M0A <@7nl {kW| m|bӧW?(?(w#wz'{!
hЯG{aNoQ6o -T_Qƨn: Uoݣ_Q穿ן|6dnGu4tV {!\ => 8+{{?G9/8YWI(y?Jǭςy 5 5| F&A͟2?W_ׂ1]pP{j~
o
~ן ^%ԆEHULbOdž _W܂4^K_#>Ҿݿz&H9` & C7\dQQF*nܸ xzӝ[0p|YtIi(TaJXߜcF")><řٙ鈍O+m\E/wp# u .ElHEga]}' N.(U.~^ycMZoR?-1{ g`Y%,cWzRX'jl4~woX}!Z#|Cꡐ, ;9V5 6<HcLa$5=%77%- ^-RXI E'0JKpUXap?z>AePfeX _ʿN1W5ܤ
xA jp3~r4nkql+ZڨgN!. a&xz<}ݕ4;=z }/3~{
^ = '/@ЪZ O XE` wWzaT'}#&N E+B6(3Rpq!m +ܿE L3xxUOMN@br==x滙R7^}{䊘" ` &<( ~2m
H8 ݻ|hnMV[Ep#<Dz-7GmtNCq
RɥǦES0n2%_GogniDl "Sjȳ g/*!akpQ J|UGbmjwhG:81llX8꼱p d@ 2d$_L?ӐI
]\ᨾ[<; H$yL:s(q Jpt
]zÈUVj Dť<ظt&3#\v 1RDH0@(J`fv*Vmzm:mH>0zm3rotvm;b
HCс1q*mOL58)qrbl Jvmǀz+oaצ߳ތµG݈!X~Ђzܱ!&$18z%Rc0'oxۗcРaHP^ _Kxakz!N/`1H
Q!:<JD& ` O- IrBlyb%86 iy6+#Z$T
ft ^:oW+f`yXw Mzs`^$ !?Z6]5}:Z6T+&'!5gގl9v,99p4Zf*!z+[$NhJdq
b y,
R)?0ZҲFb宓(㌜$܉*Q\IT"w7ABr2)U5}r6 u$2qX3c&8"R_Ll (?<H +~>N@
ņ&rc"~ 31V6
>.8sd;j6lY=Edyѥp}rnȧQqwX4&qWпÅѪk?_jYQ8~Jz!z'uNܹv
o7n6Sᵎ
q|"mN\Er_r?6֒\+;8;r"}ʚG3T Yi b5ɣx7kf+jdf65R/f6s ^ٓshY 0(;xo JEj /tvyXSoW
O
Je|d9pSJ][X%S2s!^ gBx0
Ż_O Fسa1d} od%$Ύy@!B6l LL0A#<q]X b\ {6\)_G^n}$Jm
WA
/Hؒ033ػ˅73s (]gjDk0qldS>2;4yz̝EvQR Pe+bP )7"֩
AU+{5*\W_ l[!ߢAhC-+]=K7 dew<d0EL'l?rиp¥;0oNeVptv?-
a y G(]to79*
:}ѵIB8k(Î +9b0Psسf:jnm LZܖ!i8g&b6vxQt J$8Ɠq*ŕk98yx-Vv]v 8}z,OQr:avmu<w:g.ʧ~|XY>Ze
aޏc`Ts;0{8WEi;u,fd>VQX4<iJTn #f#\R z酲yrL_s"1dau* }*^}9ĭ[i)H{*/_s(+s'_pMQ+G0ce?Envlو϶DJ~4fQ+`ϩȦGjM;QՎκmC^ I{Sڇ z ;7~K /^-B\E~&T)髲95_)<rothYԾٰ|!f.XL2cӭлhUTY<6& ` O38+'= M-MǏ Oе WnAB477L ښ{. >$,otZs,8^f+7C|oƓFR9}fFa8uh7npJ353[bƷ#Ʉ9<f0Y&_kP| VÖ%c234Q/| H/`VL;S -TBMЉŭm K~1w1 % aiv%-#!'bu }0m(O'_|
H|Fwt+[Crw,V LBwCZ~j'K;3GaKsN&+JJWzT BF@hhY
n+S mVAn`1H&p B5˽hR,(i#o7>w_mBLl jU(G;Y
mPTYQfRy+}-W O[ʩP{ M} h84W v|z?z g9 .U%*G@n ?!o
!Vx([9ɘ8jGGQT6,H\Pjs%~Yz,_Ѵ+b3y`m~X$Е#thV}o;~Pwapɫ Fװyiħ) |10*% EYcZ.U3#?Ė ;8 Q o_<腦f5qFl2 .{/c}ZFJBO tMM0A!$% BvZX9{ j߁c#40ތd4'<:,JEA'?`}VLI%=GEhsk[T t.-N*i.o};b͕._?YF+%"E}m0IGbz.B'0gF٢,8:[ݸUy,* JDZkTBg{P*nb65 qI NB9+6\k:@*wWm+ ZQ5¶בDK}[{&Oɂ/r
NB^-fI)Yf(ڠ J"
J::PuTWp{Nk{OIp҇CvO'v 5sBUlW̢\: 5b>13JKNŎc HEݸ,gBct~oȊMG&
ɌZ5G3P 5 ~ l@Z>w`nĄHJ!VCTR aaMk|RyVobzy"ZhOG?- ֗QLRSսєQQAu0+V
T 'a/:2eHg{9rӱwfTk U'm%rPQ.صq >{N~BJd: Ko o$$(* ^9imV h^q՚ TcL?& ` O 'FGg!hդx@O X
\Q ^_Z 6Gp,m-F "gNEIS_@Vgk"ը?D Kڊ"!2~[/}v
bSVt}&31k9#Vz@#Ld͌r#ɨlMق Բ#x$LU|/VRr9D-˖A:S q#/֕SX~-5?vk|3;j=N2#Yh5 /ޙ<4ILl$jqm8[]&1=%65iڳ 2|;]/eT6(,>yH_ 8imI"+#$gw5ۂĆ0v#sD
egnVT*4zR 53e_,'; CVg[2ڕ˒9bGZ!4b.!G.C_?r7fp4sg(QL͢V;; jVwq.AvJ4lMR{N#bSЪ}}2|ő)-|}ԕsظ<}1PIs/SI 4mP_Sm&%-n98J(FOG7JBF5=^ 0DX@ w+nL0A ?Ѷ+ S#j^֚lz x
lOB3899 bL\Ȱ:jFrHX<Yjs"t" 9 `F^O_ o~6SFouOgTOvj4Rq =&mC82z?p%e%H3H9*[!גa(Qo C| >5/(Eù՛E$4X ?w=L 3#}dO[' tLB{Dv
H7O6M/D8 LK['Us_B-wm @[C'B`?٪ P067n>4 :|:uyCE#_웟tp֙ X`:ʃ<rSq!u$/Â^v3Л3?^:,ia'v7T ) Egd,/͙^rRclh4`~n ~YR &#fii|XX23`>!4/ @+y-[cl|]9T=ˏ3VmG498ѝ8q5
AUQd/ ?#H
li~g'8[e̯,zL:M%cĒs0:BtM k_'Sx3oL0Am'|
hЮ x3݉;cheT }i6MS۫ ~;vƦKq` >O54LY3khe&]{֫\7qV 8 fzzRݬӾ7mߏ7o`ϖu91-Qvc ,<3D.~WEM5ȱz85+ oό}{U3 K'<ۮ#. /<кz1<:{x:e'")9'5=j= ^`iܸ~s~[nTY< "Tm~;QԜ'vl ]=GNX`
퍏Y@'fdĤHr}$甦O_Ȫq3V-3>Ü%q;:LR:H+$Xy5]Ӡ) xf8V-ˮv +B9]< |WxR&HD*ձp*4i 5 ѿa
8z$oGQSbu4㱖.~8_c]qvDs5d ?u<H͈:PvnXe \:EbZڇt N"ea(U K:,Y Va؟p]0e|=s D
fu4g2 7N+-F -< \å'0N\A71y<&ly≫g!x٠0o & !`1`~:"x%J<]驢 7~Vq Dw T.SsÞݻq&2CI-Ct&^+N#Ҷ\3V"I^nl
۪Q\]a*m ls7m`S|7z:!#9 kƯ+]`UE{zPPPD X{wZVwu^{A H IoKL) x͝rssccz y'Y7JAA{"ɓ&#a+t=kt?551УWtN` ODLˮh٠D0LR _̐lGGG+8<7j;٩k=pi TJKFbjSZ(MlgKybТMdMƌs0byI@dݍ[bD[VXIhٮ w>|cIߢ]:!Cv7n Dzgw
]_&ᣐf7 s~
U! }=Y?_Laѧq5ߟh taFN[v@~K{o.j7n.ox ;;##xpa'nm mߏ0#cS)Kz~W>*8233W D|E'Mn>L5 Wlã/iuyc9l1̹23`;s i| Rfm@,h%SAYOYf<@=2<
'ԎBzJwl;xI8:k8}[
мhXǙJ
IتI RB>D&IѠq3hQcal#07 fD\Tܴͮx~]VkPOψxtz6~7Ǵiߨ5r1a
\z~Z2 %whwJS n2sky\tzBh(e^tBm=1ˏy44-Y{VoDמW3ǼYS[
vǾ}x= `B < aǞ*eʙ_Gs$Ɲ_QM n**o<1ⅇF9&Kx.=!:WV7)Խ"$ׁ-hVe!w5%J~$Jgl݃,zy#cO%lR0+`\b
yx[ꊿ )m*G|ݻQN #||#W pʷ+p~68|E? =] G1σ3\1U*Ǝ|QO} n!-¡.mg]%EHIˈX.:61jp^
UQ>NLm<BeǎHq
c <MZhIQϢAN~1b^# k y|b@`Bt|8vۼy3((˰Ñ2҉Tdd"^ax~{hO}hkR,F ;dao^] N/v\{1z#-EubR-3Zg;D@u
=c_:ilbcuĨ0Kӕ y 2|BCT
x.#v9$٣2sF].^AY%H'ջFg4]] v@rƼ_ G|J k!y (ໂVxͱE kնI:Q8t`|^/0 QV^n6qΟCb$Jc
`X|];v@MyC < x8a0hI e #!?B4n%̩SrS
O>-84tv؈Ȫ۶o s#<d: g>.}U?,յ8QT՞<5jck~
9?: cނe<0ܧ|$۔TUs_UNpرjWՆ;]NJ > Evk
^w>6_ WaLmIHNq 4n(( kL zaO8~J'? 'L<Y4m40(f^f 8neTnKes{h>PMm;}g6yAe ~aVy̵̓-cWuuqWUpl½ſݖӽ;U2=4&
:Аu*}+_2yuUՎo{osq:kUun}X刧Dx
}UٖWw^W%շyUW^Օsw)sN<ב*uGg
EJv;c ܡΚeKO g/U ?q1 ^+Wݎρ"QP \u/ט[s؆ pM^F9WӦ(*PUsT9/_G4/"98 'dw (ծ;[ǻz0a T-(+fi_v'KaJ0S
Ú56BDM#?JIJܤx;LVʓRL ́I374l?ya
)5Ϧ|}Hw$#TĒrXGka9TTW% \:U/*0d¼9~ua߇b:ؗ'<2j[Nه?^ KVAV͝a]~~XQIpWw[·}v<\a'# Z4'f p<<g%\j]旌MuUS}=И*Gc<Vrc5 G_O Wm:WѾV5oǦY\Etz?y#6_eu'Nb!w z7>bAuB^PoeeΟ/ (<D`АalyTl;]}rvmۼD8">]yCmlHWޭ < 8.{}eCuUOų=.ox~NbU*oMʫΡUPl[WYWyArS"zT|*jl! -m-j*I]NE }B:wR;
*Y3uϋkז1WinE OW8www빅Aw j۴Ww>՝e+N9e+σ-
]zW.s[]PWWur] ]mګw_]Nύ]}oQM|ϕq?w\;Rv"/jPm{{~{ulVnGUNsk鑾 DQ)լ<F^mkMVO
**_7ƛ{RqnGrUw9 K萰+m?<{w-synUǖ:x.mG6˶U S-f x8.+
3zq*3 !$8%$HpˮV^֭[ j]ޛ>KEdl4ß#8I%}Y_Hnٲ۷7$[Gk~=5w4o ,@ƍV 5i .k)))HJJ2/q\:cm۶K(˟冫VB˖-g䊪hE\mUw6r2Ŭmڴ9a] }0aÀ |IMk~$ | lq}4NahGr Il g{tVӋQL c<~ .mU9Ͽ ljgS8ѺKLKx < 101,o < x0aÀ < x0a ǪOkɯ_#[Ǜ#_~ {dpkÀ#A8e L < x0a2lX2{0aC$c iaÀ < x0aÀ~aÀ < x0aÀ ?z0aÀ < x0aÀ
~BM < x0aÀ < Q1)ԙaÀ < x0aÀ'<.X < x0aÀ < xbS3À < x0aÀ N( x
5] < x0aÀ < x0GŀQg < x0a1@YY/ELgi /p 'RGnj! 9< x0aÀ < x0aq??cI`u=K9?UaÀ < x0aÀ ~/ K]Z]yzz:222<Ey_ hÔǢ?%%%ǢO!P}E MO}QyaǣyZ{x[>qϓxÉ?nxN{gm,
x2m f; 4P3d ]՚C||>.,YE^z(..6yv<Ƕ67UUppWynxj<7YUUUՎ;ڼUU{W~UjPmgj}8p0ݻZF
XQU U:v U?TU pVVԩSGE~RdTwu+?s5[~{J{s{_6^e5߅ؽ{7jժf~
ۖ-gw{U9h]`T}o۳W^m*_)55P%Vp{{l9{urWϕu3 j5?m VUO
OUugTf߿ 5kքK0ku-w8m[;w4Gddd9
uy^ϔ*rmW>Mܩʶ ܫm}DcG% T]J&]ϝ_^)**2UEGTߝ?TY;\8m;gujU ^UuT^|
p3Wݹ1`dhsLL
ou{ DNNq8j I>Ϗ6lKs6 ?1--+<Vտ㵼? ;O>L~Wuhڴay= M h,[5K .sݱc6oތN:P%p c9Y*a]vN8\=//|ڴir s+ŋM ͛7G~~Qg$ _W
9QwދP )zuKW -ZױI[0icK
41{͇`XpxuDGrss
~ڶmk_cY^s-C ΥHh}itxM"67n7D£]R]kd(CwX$-[ ]5ZV2СQq8% .V @ IDAT0Se uV3ʕ~S_=nY8UM5$Dԣo:ܱ׆KYXߣܱNU5F[^τ;PX^|ʫ CQ? O8:\X%[ iu-ԿC[DDc 3: µc;T waұp[;hnKqz<ۦ_:wr[|=
oڱخ#{ /53rT
Y։1 =~кPҘ_ttDcnQrrry_G{A
an /7U,$- fF ; iG!rN~M#Q*xmIyF++זcwp4 y eKu!6,cЂY}y`: tuPyV|:V8aWKa{VhZs\wU.} ֽ^noU1Ċ}á{ܿhqVזRu{D,T| o v}ŽE Sm LkTV&tr ~CHg?T\/C}inԿW+7#/Ku4=g*뤃y>j綼
<W.S~>iJ9sspre0y즌r^+,typ?7
Xg{[WV_͗VG@ō1kBcHT7=;8:TA:c#a] 7<Lɝ6_W^Ȥ¥¡|w|]3{sweyWSM= ݳw!"^w~Et[)JKPaMעR " XR(NK- v(m
9DM^*{>q``0 <.T_W?'p Nc?@?ҷZhC~w1dwi@yYw_sϾ8ᔟKHPw@x}m ^ ʖ~UEDX5NWkHpV~*Vs9c>T݃|f}Sj~+طÒV o:ʰjOPC~?K]?p k>$kX)Ed
8l-{ս}ǂO{D{EysT
" V~*;wƯ?}YL6}= ٽo[*2h:HҠ[]ÓlҜ~+^^M28$ MՔ9Tpb\0غ2hS#"F>avyS%RCo \s|b.ޠ}"yPCc4Ag&`d*mJhq`wsps2[! nQi[ ;v7,H.|ǧI7xOC-'x+v/KôώxWc0W*YLd I#4VOá£5J[.;4FK[2_[ φfdI+ mӚ`fCOt
m7G"bq-=̝*ڰtXPG:)Kt.[#/'aE$ @6oL'*&\ŅyHߗM/ #nB^ vXf؇M2mg7?Z5kvͦ m͊kUڧA),ž QRXIHPQg"G *2E,/nj2rm(q1Ki-Dz>!҄iG~ ,6VVf&Q5h0V 8\U= 'Hr9Q9.%J&??J"C(d8DZ U$NUSsfcp^"E?w݊x!=- E%RlE?1<"iH?Aywzva( F۶-Q֬X,Z4oT@ܩ
//8GQu/8p5 媫WU6iOTO;Jn?}/3 AAx?JeePetWw1@҄<Gsϰp҂X@ k3j{ O8[N
WY?vQa.DߤTCgGDEï$KX² 4(o, Z8p۲M<u<&)MQFQUF?2{_vs$hyrc3-kuuL0)d\d~rOeOZuT\n<fbu؟-FB,J
>K,ܪs}ozuT 14Trz,l{Hݟ4 ^òU{&Se3jy=SYUIH)D @(K&J,<:VAUWsa~vtQ-.ױO7"ȓB#3eŔC)BxDBG8CG4ʉ&]
iHn}RHg^ Zյka5٦~)5c mQVX@\䛐fι2ZLE#"2Y cmB RdKE~ʊ\B~fyg_ZC9M/tpn s*pTϴA/P͡nC2gsJѴYsLp^
'zpfG\PD0kQH1 $:ʭ b\*q z<NݪiЬ2h,j,9ܼܖcOmh\/;"͘}!KV!=SZ~R6Y3Pq349MM l_e?MBҘpDE>RfߗƖH}2#T>=#}.whS֗̇kc7^~Gӵ&Tvn^
[w!&5KA8q"%;?βW(uR\}E F,U9W2{ВظxG wξfeƣ %
%_<*WQg
FI&6,tθ. jkEcьYxPXtH .܍g[EFsHڔZ|/_,|.
1{nNiE k3k*YiW;jA:e0;JBkSO!;=f`Ѹz!s˽* \J+ Z" }Z g|%<;q~8Ms1|=ڱ ?="ɚ1oWxd&Ƒ UB
tvz<
a _t-ͅ6cm~C ؾ@Iւֵ#Ԫ : qm+ka8%> [V/k/$!撯˱Zt@~}\o'q*bVfMH5Ec<"adžbԗNj!C\d( G*똽b7bBI 3 Yg[ve6(Ozm4}7(ػîìap
7wIxxc2+u'ڵqyFF^T2 N/<[ѸWkC oK xՋǡ""̱ʻNe 4o_$e?1,|ݷ7v,FORLqy v:%V̽`+
=eꄱ.^y&5i1[^8
u &OQ#? sLWMZǀ /edn;ﾏКmp~2+蕩!O#_~̜%.ك!C.BGҔb
Ga9@q]xhEW%:* *AbX 2s,X>/Z7î࣯BX#2ϵ}k=
v ԍ ~sL3Lp%CХ}Sq }k\ w@v֓}Y{+ïl;CK{B^ ܴ/?2#c@HGӶ'a @Z @<z,-2c`2Ԇ1!]»_qJQ>n|Spn暪OE!LJ!M S}KsdDIIۊ; c ZIj(R]jǹZ
r'n A'uGpV{0{S>8wgV(93kwè3c,)/?×3РaI)sǝ=+`zJ6Hw<jb8c|Fi
.C+XљW,ΰPy5QrmÐx
qhR6
̯?^x غa%& 3` ]菫 =N:.K^FvD \qգ3ͫW7-qٗaĥ N# 55o}kQs"%>0rXDi/8A{kW͙oBzPiɵ+q=G3 .IJ1WYxܠcR9]v |ڋp<ѵ}28ϫşn zW_< "(a0k.Q \r \ry_+JD( fǟ~=; eX>.Y\tv gs R}҄d p Ɔ!|Z3i 8^]Kwu$(iڤաyhSZPJL4yLb2'K >$dވ7x 3h/@&BJ8o ԯIj:pz1V \4()f)a0ׅ3^}r {kIsd 7?Cpx,[ˈu ━7ۆ9yR=vn>Cnҁ9
kD`G'Dú5|,?XуP_1L {
W8Q!Hݶ o<÷]#?; _O/Ѱ@`EZFf}1pPnFɑ݄w~7kY;4RLyg]y SD%2f,; OAt \wi?DŽ!s.@|{V(?` /W$b qcFgx, gz*>
] qQHKς_q>o?;3_|kD8Բjxov13f]itB+¡QqQ?z}$=|4 ڕ ~6 )
|Z W0 F&} oK㚦|Y$p e(0F } \iM" k6alW^ٴ8: (z"
g<ӺO_ە#3Y o,<~&KWve.rlwQ#ߎ i-#wU
K; Y|}T:QɓpN_ Hi1Q[ںN
/' 1瞞y-e/&Q("U~ %Gs.,0(l=?n[ DL`TD5!eX^q5VVpZPFo Z7 b .Y9j<&ORyPąɋU\+y#/R[Pdh caH݆ ~}#,PkUݗf<D!G*KA߱aII=BV- _̘/>YFnh2 8@ nvnQ cȇ2@ʜڒ||jReH F'!>yuIQh)(fT{z[s%yv$D! =4Fsl*_X(3Iw 9l)`ǃM18v0 {<#&O?Zo.Z'SaJY' jѷq=
Ǎw܇Iزv!^{S|Z tnb :Rd9(42vj= 4>_Tn}IxhZn`F'!3u+xxoѣzc'gO<(y
TΧe/zq q9-+*!mw9yGyǁ r`W8{w4@@419TܹdSc4/(&| 1{($$s({!6- Enz#Y3!,B-\Jo-K)M??
ul4A^ܧ|.OdT J Y>o4F} DfP#AcڿZQ10Z^\(x$(đk-r d}9|=g)u%W Yfx.ܗmPdM'>ZDEx4\ E\s
[
-#]r}%ihE~~YNBYv; & \o4 _ ^3_$RX |RIWLd$
rܜeOMpk%<٤;#* :' 2 ;LPR} )?scDFE~ا#!k3uZ-9Cw5^Q3fҽFx(R{^ֺ<|njS-C(lfgs Ңz2PJ kWLt$ʬ#zF}7 F1ffˠ%9W); |;˲+f6ڥ F&#ky~q
б}4ǢqSb[5^;;^{xI҈hOC5}g`"RѡG6#3ш$nEO
LGSy7sf
+,C (i 2 >՜r/i6~3 {P[ XgTV8YGOC/8tՈKY 90vSQ[ /Or#<J .=?=O߳ {\(g"!T
iѯ|0=c1~:\Z_L^v
C?5z[FV )"yyZ\V
NNFc
QdRH/].dR%3
[sC |Xջo
GRT$F
L5|d'&- Q@NY0( + Tɬ#^ΆYw?i5!::d-nr21G;4 DFY
֜pmY@ĄGb/[f>7a@g
i&@HriD*!=ge6y.D%;f݁T]
j<sg6GpKx7v_ :NnM zy/sۖ2 yqgd5W-&/$ Q@VNnz.5 ¶fiHqfȡAk;3|knyS&#a4wy
6. Nc&r-װw1vESD'M[tH#C"I#/#mК/Lu#zIݟ4.,J}%]/m WbBh$I⪳[!2H؊mL
;v1)R+x^
H|7cF¢ gA
@ȒW? ];?$lg)7ehp Y_{EqÍڦ1-Q_|W^뎧K/Bv͑} WQ]6#EO\6lDsh2(uwfcI)qDpZH
#n]?Nk|k^̻#,0G;50! Fie/DI<wllڱB8_REGt o ?O> t X||x{~L?
/!I
_ \z :km. <m
:0aQ
ѭu}ثv:\WD2e јx 7D}<^˦M߈x2pmףUD,5<n{a ii`&@7f4}5 t?ר .g>uT=KeFlZ= te-=k"zͦhuqV8/IDv ̚:@ܴ+կs(_ ѡc'fWͥqFؾj b[#;]R42({)F$7L0
G_g_?7hBfK]b}MAn0;팩4unߎ(\1bdص`*8]7.:.wK~T 3?[&c-WCV4z-BjpCx%H`= KX ]瞋u4ŀ ?BQ{?cOBz~ "0pj ?(
4 KwHFFp'ewa2sJ}8 :3"-w!g|k-f#.I]k/=Lu&? My^;59ޤr^~#|xZ[ᗾo>GsD~~ylΏ71Jhق?kް
yr BqwS:
^l(b5w2V(S&6C8!Sl_āH.DDCe '#FN2fa5°!QQTP#0{ѣ]23g
DKzK
i&JelF:!I"QЉpN] &8t#1/3i%=Qwr=uAxwZĨާ+0tQ/"ͿM -Nð+.A`,~6q(
R#`M0 mʀ/2z:kA8YS&bqش}7 zab#X$ U D 7JiP[8&>l4#ighC!JWGs(n2Ѭ)x⅓_7yry?FH)9Y;Qt9ci9t<jR ~T͘mN/&OF<'(Ki
\/EC'3v]%{fgl[ [n )&se疡IBӺtG 3}v-6aԫ?<⣑c+
=uP,pW@0 ]ORQAC
riQ ̝bߎm) ۣ[wlIsaMemP7
K&
WFp^ f{)T%X2h̞ TuEd^Mpuנ1/#HeI;~_ -C.<C#ΣL,X5ЃACs* TnBFb[P2v1}I _R.^ ۢ60isT7Glj{ŧr DFQ\̞o訡Q9\T⏎]{0 gcaZsFFs-ٜ΄hܱ;n!^LCyR_ r4N<Xνb۷'bK0u܇=g PRU[wvرb"OC.@,v*^y3{v^s_G[ze$Lqrgf %Q<LryV%[65$m3sOW@J'm_:Z{<wL43fS)ܱf#κz\;liW4}.#gQsp'ӔZ4#Gau&w)
vaɘ2u&hܽe+:s! q%իI\¬tp7eTMdJ0Qyq$5N8>g^ C0{%k~}Nݶvq92L.~t8&xХTJbB0iT<>!_v`ξ?c<N EyߑnkOr Gٷc3>y
<?~+Zetxwq wscD39G 1i λJԍ*"4'm׆{q }bC%H?Ǘj4soI&JW̬~CoMÇ Eٷ xN{}=S%
Ù]Z犜QԹ */"W
S0xhs0{ tn lŷ}+.)a9o>j=-Db8pAnPh0I8B2GX3"`מHdػ"QZiMqf!_8kt/j㎻c? ;T&I'O܍2FIKF4@f5iÔz|b %1PC Bq6` LyާU༛KGw=zNwZ̧;NsC+ʰk.ӽꖖЪ_BS4 %ga;,Zsbv
L)4Gc[M-Ei;/㕩=bڼ W^b4,ͻ YB$z&k7-.ƻѨy9a* CMŽ |#FZ7e,zٴǛ9qΕlZ}n
2=~X!n4y7'|5|1i
$Hg%C|##?u3t|@W g6
KҸ g8ķN=H"0]7!qCDrHOorr=whп bD<GP Odl{Wpe5-/tB ~! K>9)f݈kE s$BÆT"}H ߅FRׅWmd*mKo`ףi8Q4&| }[/6,3p=]F>uDj b'{QP[0)d3N IZ
3ڰYze3Ͽ 3
ЦuK4lМkZ)4.ĝ'6/o' Tm@f9P) 2L7B鉢
c >z-t6i<٪u;oa=GY,h I Y/tnߊƧx)FtBMh٬)x! M_HV4G\c`{F<r
Qf T*fyiB$X)^ Jc 4p$7
Q4l* ^~i4_{ 1 }uݼƼ ~{;31}T-1DƴG:(cҹzHy1 x
o^<<v{#mBE|`Ո-,}l%E{llBA`*r0F,):D
[;y. Zi҇]cUȾ:
x |U'M+a4tliSfa ?gE3K3)7ίՊ`00q "ذ @cI Cy >&w9W8~ i9Oa
W?Q
9a|Ixl1.A`l}ףSԋ Z"``S1_"RW :%%l@3[{lxE|tz>4oݱ}Sok,)J+W4"@A9.Rs> r@|Fx;> ]y &g_´#Gpzطk=HŔoq9Ѡ F~N;L̚;I6AJF 22*]Y-;V;Zx~ۺܐzcf&ܺ؏NД&?zWGyr0k4lǜU@LF<Ŝ+1-ka>L|s:^o̻"4Of#ŶsܹHdz1H#ưv
ݽ o fO[ y;}0}+p
0tw!#]!GQ3#Â+f'<6SЫ)ţsNMs;+M&ڮg:V#/mq)=;~o&m7 qvKwQحjk:+Q@q<\E a8mqcr"z ?x?A!'3^-OÃZ k$O^G}< D u$"P {4SQO4<L5VaCxګ*Z"ȕ1O)E4t]vEinÙsfp8IG۳~Cqi߮ػa)ɛV='vr.1njcܐ]s><ҷ_
xe(VQ篏#K(`D/Kס1Kь{L>Wa҄<D'^wn4*Cihxh䝀
ǡ[09|=UפYOhUav:3/7ƀ1-cm)BplFSP.u( 9Ǒ2QAYs-˝sGDVΑ u:N45ЫD#rhEz/uہ2vy-Jìߛi\_psQ<f 6shhGW
H\Fi-Z$I=9[>}z"amTC+"]8ۉRwG=[ETf|3W3)(C/ErVhʇ!
ժ^QЍ=a{Jd R|mšx[8a4JR3,'εez 7Jinp~jк -݃s軴֭Y2InX<[S <'s
. b֡hS?n'xnEڴE!S?ࣷc^ vXf}XlsR1Nx? n OG aXJRJJyOAxdV<)'U(bPs?uo!w`xZy%q9ٍٓ<Jwb7 7 p/t,Xɾa4k'26ȹ_`զK4in<lWȰZ17mGOu5VD4i
<9ph)FPY(ZF2"٭:<KD$I ?| 3Z k/@*K"~SA;Qo5C q`&sXR*[/
]4}69qןoG='۰xQQ+C n\&VoI
["( wӢ/ ت-[1Mf
W
v)m43E/E֘{ Ko i )37fYDr _Q{dCexŦ |Cܱ-N= mh2-\ /;;Aزs_ehzJ/~ǧo` x#.;ř?RY~ŵs
Nm mxSR#eR܁|ܸv#^ 9_9?) >v m#;m\PSe>.w 羘AT z#Ɨ)TMa
&nxIl~,]8||7]}!zl%?FA
=)(ai&
֮!ui]N5 w^> ~0q0M])N!) nxҺv\G!S"aaF(;^6K"}\Js'~FoF|( m{!?6ϗamr Q9g@ ^gNjnf R~EWb@SP^~SS2. ٟLA}y|j⒛wnj<5uGtjY+6?e6Ԣ!awhQV,
!Xl +KVQ9WRHp
=_sqhT;}{=ס^dh,ڑ z
͑Y@LawLg0x0dژ7MyN- y 3pQhФeB5pKY,[?p
W?k+ _" PMgK½릒돔)E7~}D5K%SAaSC,c+ıXq(3.+ 8l24)31_e8h˫F9o31yDRXXl-:LB4pJw? &w
^z }JR $ `Ǩg *͝I^ 2B=$@J).Hї=_a
vΚh z
zYh % ϽO2BG 1`ғ?{
ߐ]?epo<
M|/3w > z=xddG[ ~Ԝiq ) `5 n7y>Cq߽2R36`fMig)bהm|4eXV?ӸdrIZc3NRع}QVtͩ ks#<FFM y=bQ` ~4rD#ƨx~xl\Q9Gx[5H SQ\=; "I{ޡ {Y]vNh6,wk@
ߥCM|ƾ=5ma#
'־Cc <RVp
g:!Ǹx/gwF"
m0X qF,j؝ٌ50XCC*hx<1"7:^<wIn6{Nag@(S`54룉;L|ԐFz6>
mO>5k%\ьփn
O6s. Z
yaTmtdᔓ1{16%؎U\t
g
s`8M{3(sʗxpy>;͎4xH J<Ji Y QY#Qy!
H
X:<`ֻQF#~? |d"ppbe]k(ƒ$Hui&? k
O0eV>m݂9)35 N}%ipN 4tL+sO793>eӖ8wu<6{_!x7pj(hfg^Ÿk0"ݘAQ
z -eci(ݟI&"?Z&m ϧu늴"}ￓ^C gي
ӐP0FTéđ`8]ui~ۮhѺ5:6mh^aY\<VJJJ+؇,PJݺ:5wb[3(:iZЊ֍9s] FϘ$imdd%d+IQvFR ïUs&`TYٸn\+s.LJi?]; vXFguPgm[.{X!CHxJѠQJP`QbXA \?CH: A/pJ)% x g %J*WB-k&cz/U P(R1"qWjܨ9+ M ss$-xd<C D>BD(X\,> &|Aoi8m
©yA +^0rgD6-ul"aX8W6CŲY|#4^߳0*T6ONd*7~~ԓ|;y]4%9ĘXrogI''F5x|Pr`/ [Hl܊LCB%r͞ks!7jh~y! @ IDATHH1<0 z}N$Ϗ4lؖkG^nhLA3s~muW B\z-Ŏ0ot~f̛NcД-ޅi .@w 8yޜslUg
{ZB"m t8/>l14kP(ӣs.6z:~) !~+̗R3N螑 к*eT②O̖Qf
ZM[/} {[=Nڠ0.KJ AzZNi)2$PO }L+:cpU* JEfh
bЯ]4YB{sNBF
LalY? y;@gL}KwHK`{وъ{^hVjۮj&co 0 Zu9->Uxɻi5! oT6v!T}X.&_suS _^ֶөy3Ҍ:DuŝQB< :oY\&GC 6gM>S;ԩdIRhȜf}`uxaXIof 3IIgKi,0[6kPxrh$ &¤?-}Uy?#JJcPdȨC}TY=*k"5]~CznY:H+?KL=~
a]FѶAHә
F.m٣Nq3/ QV _x2(Bayhkt
4eTA.-<WNXOGiTvG9X|;oÇOI'`{ v b/ @P< ~g9ȔUBdlf8nZ=JF<_ӴK:V y 6<R&'t7 Chy&ezB甜5)ֹ5Ű{;N'GFYKm{N3~,Թo8
G9! ΄GW'Ѹ%~LTR{ }AKpww)[*}k[Y꺵ݺQZJqi @W"yf{@7-;s̙sΜ3uj]`
uMޫ6KZZF ,`_
8տ8XonjAO#lt[5uk߾16A[A
-Jr-|_tZ7m1 o Ҥ²ڠQ!^2tdL~<!<3bX 7q<}`;Ǎ9aa4Λ[&}V< >z)e&WŌ 'S8qFdY=yb[EUQPw=ՌJxLZ }\
-.: .Pf`mH8obsDG6lb57gbn}ԜjMD,|ѮY NaNO_?}npFS.ql ]u+.89H 4tH'Lӳ<:so@rRD7CO b += Xɡs\g'] U
zq$uwWm좥+i gN2NvL̝ۄ7;1#*$%Rv~фV8<><u}yqr'7Y4h
G s8ՕǞȷ9]mŠ/QQy w`n0$$N+
8y8\A 1@?V "Ibvd2ߵwiðE\A-4ChS\\ryFm',̠ J,Wt-G 3&\oUyWDZF dHTUNc$4 N >o<{sC[+F'GTd
cţQ8l#gi<3KEf_LAȪMl:ۅ"y' 9˪PR cLj{!Fi\o=4" )ʕk|ӹJ&/bE9
9SԤB!c3p . >!/}N ڡw: P4q\ ͣCGQGeaT=4(VJA[TVjXx VIpUNvlKjy%BR7ӫږЦ]{ѿ#.]x Lg% sMj&$ar!\AeT ]ZJbuh
{ v-ZѼ'^ћNZ9hJ1٘>.YWlҌ:dsf< $Ѱa@z{ϬiWk{iPq[-X26قޥ^uI3L4(TNL)Yw֍Ц-QZ 4^, i^|^4W3c\:cLc(8mْ͛QX>L@8gv&b] >
r*" σqQ*ei}?͙M_.ص` @t
Yd:2[qe TlrZ mc5!. ~߶c7h(m<з̵fD?e61s ^ -yxxo\f@<)иJN24:)v\bFhm+;DL:NR߷>
/<nWm/^d}j0/7ie]~6|RhI3z~j0F% ݔdG"=tdu[vߞ[=[W/
̣YY*
&L5fp TU0qXdӄbhAȄV&C$WK5&<ía'91"C)HU4BNpުco<:m9ֳix7Ծ+ o!|\Ɲ":7,ْ!V
)۫2N4xmHtـ RWQ_ҩ$V-qn_? }'5?~3sU:r7 Υ$ K7$ёnz >W0[ B}GaiZpHiؗp6q? D\M@tH': /68a56pA
,?Z[b +j^5A GX%M+aK 46 ̠ `tlP M6
ԐƁmt.| 0}{u\ǚ"&c
WfE в@tθW`^l8}tDVjp
Lx-Mѹ\9NN$˷ DS y
:.Sz0"ՏP(XE&M5̎X$%A^a騭*C4SJ *[դ)wE 7 ;YlBè( |_1<>Pk#G rUs+^]*^2_hCv25xKwJ\]_p@!=\ѾZ8 ѧsSjOB qאf4v&[4蔳G9jNC8o!_J_ zōg#kl+dEںd((^tT):_/>Nͣ 9)fyQs=g1'3:Mqϰوݱ ?/E ߥ9.ί/ɧKF&!nz
ce#.1+c_(8 ݅o?x~EGБYMpQuc]_9' ۵G3IW+£m/jp}xEֵObʭj֖6Lg9\kҺ+}v'1쁇ߎ}xO'SebX
Sp^DGvMɚkq S<F6yq<k?$`ѢEӐ^ ĽFF7d졭Ag *( >x +HO+mφ
YhT7Iq` 3i)U!'|?yse|Eh Wv?TpMȵJzS 7 *}.,Y4e_~% ꘡&r5f쇌L.|ɝ˦UOC#&Cs~Xs>lJѴe
(QBÙ:1W9Hߒ6TV~k/mnq?&pqhJ<?~i9VK[v֎Zxz>2<5p\q%5l{_./3"Lm"v$R5js {o&~M 3CеC[ȑy<wL?G;vg>tсea͖\{?1jHw33.}!\ z<{]^c wʹ/pfA8}zt4)sՋxo$ʽ3s=uDtiy1?AM/gL}v\A_^dh zс{<X:#"=\wN8@NyW#ŭc/O3С`/^znss7 *ǻ[} Q|Gcyތwj&WE9c~;xЩ wM ' >NT+k F͐8K砺)7>// 8tÕ=[1ccxQpщ `yߡio\ww<: ĭ[ai.A0
r/t'
T>inaspZS O"nMTXgx:74QZ5ώxcnIth>).zHٲ o/>V jӑ ÆEtܖ>&w
7b̵\=Zp. ;F^%@{%OSt''28[~v2^c_Nɋ`pw?ǍhL泘q4DD0㘉лSK3Qu8{٩u&YM1[[fO
ѭb =+l!Js[=<&bڌe&].
N^%}!V,]v"QֿQ=}3rI;ވcK(;JOg{-x1:Ez[=uHG3ɡY|s}
@NxM杷Ď%erUyfn^|\'ͷGZm; ?;gcDlY! Gn<+N>x繗c0L.DŋO<h_m9f|^zWB)-[i;1W> ěA7.75_> ߛanOʅAtפ fd cwGj>f|yԸx,/ zᤒ>CIfgas 5ѣO?: p=_{贑Gj?>'_?˭å ]; c) -7bAսX
SydK>|{<q'27qy<>7FKN` (OP'q馕j v5si«ɿ]CG9S2XL l?e6?K.$pcl,®_~3;hBv]p\? oDBۨ0/t8@T
45+Vznfх }}Ϲ-BA 4 4ߜ=x,N )>?\8R&nL:Qc&c8C\ g^5tإ&m˅F->ɺUjmw 2u/C }r{b[ yFVa ˬV} vTKB}R\1n".W OfYsSsVz =gmI;$bwb? īOއsfb wu L
mW u ֚f\v ^ފOH5v&5Y0:^_
t'n8w= H 78-თ̛ѡM3qDŽB'l$a#6EڞӾ '^+?8Vشe-^-1~lNjExJMj訕97^(lnxg_'G5M7;|_啲>{`Ⱦ rD )?٘Od&"~[mN:!wfix<n kySSL$$-^H'1
мYC(Eu(;nl3lU913 'inr [}ݚHؘ_ap2FzFTsd(7ݎ/,+nu"]9FSFԿ'$Ԅ"ɚ 7ƙ$xy
1ӫX.W>2je[gpՊ0b' HL|~61Wde0t
\od%5ax洂. 7Sذ7］i`4 [ 0(,Oa֧)e17=
ƒ՝HIFa nc*7-{SOcL썧^ bSPO1W4aѼo ~_c~1hE;,sy7q$T! ¶m Cקm]ZDnm-P9X3Ma5x935Ѱ1K'm!Θ|,o0_zms$-5Y>
S:WЧ{o -7Egkpo<n,\
/ć}_Wm0#G cѣ
A}zp4 2{;6:u3פ7@>p[6檥lq- -Ā=ѐsI=M
PŰgx^G _+o<T<oֺ ]Xtx@8 |jeMҜ\<?`:m㬂m}egԀn<ｃqbqss\LKICZVQC!K+ 0a60qZ)+f}A?fP? ހckx*TX\feXȤ#D8gۣ07iFnŮ]?%o8~Tz%!a!*LC{]\ lۜJ7j
:r6'9>渱7{*cs-;&M[CIGc$WT8EKθne!|]X n hPIPP5
)#-6&~ЃgT64}oJob9 x[/G5i'>aZ хTuFOT)94r0oFnYڝb ʘVԙXmǬTcf= k(W _1@cFtH%l5j6l#W
<Fj-鈨U3
:ūt6-/+q'6xY=x<?E;2s>D0fTUIC0| կm ^r~tSދ31 ~C#8 ǟx !L V ]˦7~K@x~7zi' V@<;@߃Uuuά똎Vn;rr&ύm\
pEaiǡ9}Wj5vtTn FC;n2^M z)͚fC&\y"ހ' C~kuqr(NU}Ѧ` xϦO?-D>k|8y Juα&:3,|'t(
#(OC
8陗f]Rjӱ/nُxsXl"
Ih ݉+
8- `Y9d.NK$:[ǣ^4" *n>6m߆ ZۼYsM^*Wec5ѽ__zieK;WZ3y2;}" 4;c2=NH0eYўLޑcFVj*Ϲx
:Y< 1ɹF7sX O|eWa@fKv(| +P{.Ht5Fc:WXGW }صK1Q w\~5wBӆ\$wU!?k>"4G.ݩ :qbG=] <MDcF ٜնtuYuɔv$c @>F>Q'6Y%>`_+)w^C/#sn\"!Rd$
5WW+^\ˤְ GZF_U 0o9~ne_ \]E)H
3C%ϴM2ybϮ 6 8*yj(F#̪[6Y)4~ҁ+Ҳr[N:۹@GSl~A\z! w2Θc p$]+HI#x :g<ۚk5=)H20d =}PގA ;ӯ~ĺq '`Ȁ^ܺ^%R47z= 8P i2 plj$$AI\k]ٿb'SpNLўimv⮑Ћy m41*㱱lOFupkf ''ƈK?hܬ5o MDʕkl0
}{tFD<&ƵX=c ohs:hF 2[Bzr8?z"yAڨa5y<dVkqHY7?5q)Փs &¶*ʅpimsT42m5GU@!ŭС7 N0}UF9`K;tO4چa<]mel:IOP,Z9^:ܑԭ@a ~1 NlŐQcq砯x#7 s|Z֣ψ10e5=;l`/z-5o-u)Ի u+T~6+l@g7QSW6 e;V^O#:1FF码 U8χGn9JvaX C@#NdvuAs)abo04n=ؒHxcǙZ&@熯`Ͽ`$z+.ln:h9ԙl߀AFZƋOE X<ۨqs#Q~8YXI szrw0L%/HIj7MFHlOno :s"}S<
A9A*?&%!S69ґCIn^D{uu)t $! fT3ӏ6FcCj*įDQXv˛fsN|Qϲ (ౠ< Oy>2pQ}ڤhTdϬYѶxwΙYxQď#-/>}"/5D9 }6e%c̀!\ ,m R϶mZоAǽ/!1{lK}ɏ`U33\f ,9xͨf #:[ elh
m՜(謮#il 3f$:ʛa&t
0 NuD
?v.I>=#u
Db %Vx ]<mg ,'5la@s)6h
ȵPaj5]ehh%m!3_[XҸe4KKH?C#Æ<<ZHNNBHucg)mI-R*ܱeg j QJ437[G^Cɹ m3gȁl= ͨJ9}iT5<Z^pxQ+4rVt@n3H2 b{?eKh;:X_Y|y6W0 :
M(X^;*CUm3[JazVLLC5A
Nhb!c M|yՕ1ɦh#5p*>
v,8ЩS[[x=WVr$ wwkD~ jp'QyZA]ꤙ
ZXwx~T eN{u3zwk~7M~]Nb$Ǻ'l_wk6;uR@ζIȐKݥNN Dvbljik& Qnh ;W2Ϻ^&Q橽ygo5n-3ڒ)=MJgꪼuMG.J$yɈ=zb,V#ukɡۉvvB
Ud)z։[wY9!ҪnȦA]NjCmy9 D (G@E7,W
40KWiNAF(K1w]UHaGN5
hA%nӬMݠl;$Sλ+ⓧnG&K9&qU]tM7f!iFy3gbi(i^կ5+fA&8⎛Zԩjj v%Kdh>Zu5t6B]}plX(p}IgX S,˝jGe.e}>J:T_)<+1yɳx#wAGpҰ P{E- WrGɹHz:sDzDl㸌*F6r#GPGWqO8`$tI(M ?hL !`So _}t X^nL2P!dҮ._A:G]/ ,A &KʾHC3t Eɵ!7)D +*WtUPb&X?,uBN |D+\rʮjʎB齒uUyiO= ԍsyL4L=I~}HPZgKjWW/goq _$w7ztTDg
gI)M騌.~H<Q/+UU|#}"Y}'WKFפD7O:bPp,SKd>6+}23uuƆ7tU[:?/,dn!kXiӗ[$6D*Cu)S,GtU?I'#;BIX]6dpAZwf1v.k^L2*P뷈iN فX&ՌlҢX [:E}?^Yd@6xMeu~<mP&Y ʟK!t!{R?/Q;I YcPP2idߊXax8#|Ә̻ X NjE'#w%_cǖ-[L4n8/ ,w.A ݝ=,<0rybuJ
vaki |F绌
8*hߔ#"@<4v@2y2
S V/NqC;J* &18T:g
zC$n/GJ bJ ٥ǹЧ~s4HHu */gńk読bԠ0F1d4 Bq{2O iV1!I1N髑-7tv
͛77
?FԃD"&Q_kԚ*OJNm):W|a'DaS1,le ~ 6ӹ2DK~hIVH!"@1*TȘNS:Vdfl~9V PWQtW+- VPys"ArZ=!)ūZ u~ /4:xq 'sQyU`P4U ̈́\ jcWy</wF?D?ʒ+bQ)xWʣ`:Gt
%g]%SBSxw%Ru<k[ndЄt&7D(q fEާj"P&t*FxUڢ]VXY9yKgP}# ^ZO;.?oI ;`fLȐFK&m pt WTgGDsiԯY2}2JI2GɿkItPOe*8 ϶Y%# [Ю:Q#l)ɸˠt`KiHڶѮ?O HƼF,= mhϣWo??i?!-8u2^_+] {lJkdRDAH_Ootٖ0Mrni Lь5hSj#S\S\_ïg #O )fv*vޕtn1
)`ieV22|*Ww4uA"M ò_͚ФxʗxBm6UmTߒ3zr.*[="(';N|A\n ~y5}MjF䈤2rdi.]26 ɮDۊ.>6}߄)}J6א#Wb:tS9\_ggt` +*26q, ZZX<L__s? Ty6[\
"V G >NtpS}4XW`,/ޏ9n~%zq ko
VveO
?.[l16Q=@njuQCƔ;AvL)ԥBlqUs%83/ǥa`VYYL} zp8x~D 7?B -ffU78)\{IzB(.
\i)_[5ɥJ/6SI>1b\:Xh=Ž[ ڰ^2J)B~EoP-)XYV,\WBiu3i KJKc77vPܧ}BqW' ͌5 )'z/
?;oɅ##v>3)j
l9A^ԻLy}5y0Kù;8 I\8t$5#| C2_JP7_ÑyU>S<!u7Gж_0eDJOk
ũ) Kd 1fo5J2¤Q^ȣv?WJkov9]i]ҨBR.GtrAx,|,TY,t :o
ɩ]D //%hay44.y@x[S'y|G} R>s!H/
X5v|Nqy, XLҜ/p `}~k`I4N=5s?? shI?/8?J1%V-/QWXA8(
ruU _-l>܀lڅhO< |+@u60|u BZV^nz&wD99\h,
8ZwW/+ i%>5JCi('xO;ǗJϧxӂpʿEg/ٌB -XO%TV'T)E K q;M͞> 5b;}WR h?snTK#ebfG=p
.{ LCˣ*YPq'rpݳdj)FҌ\eq<.=%l{[)Mϲo.T / iWC ҵ"yi]y uMmWO
F-:AKX"̯|.z`Ӹǒ ʣ
Gu JU0$oVLnp m z[>PQeuJ䧫I6=m++_w$f RӖ, %+"l7=D ,][$e8#p\ogY 'FcXz$8+ңd˺RJ=Wp/݄$f?OVZ&e
N>T~FMzYr_WV=TZQѪpS^#
\|)N8{*}ѥU:?e,iu0Yd'$W\YA=~xһoe=GwV?N~]å=E Hrϲpq%ӖNwG Z[utpӥ#Go=#g oOzP|8Tv`#ʁ[V#~\W +\rp/NYu++pvDY2^}eVs
Ζuue7m ?4]Ч?]7xB8j,ҕ%dW4nr.M.@vT1yrh#CKo< WppxƟ}-sիѦMc kUYIujDA )Ӭ л jXǸtYZ ?|1uiiEt|ŏS(|Eq:.Eh!D~Z_>,§" j[9 &D t(v3:W6M'pj[oʢ嵭iE<NV*Oy5[
/ j[&+~^;R+2O|Ehd߶joq<*ui K q'[C_/H kETn"4)cOVm傽[K
dV @
>*&!+4*X~ O]ɇ˿ŔLt5%<CuJ< IB'w:_Z֯ʒ[',=Ei C Pv.Z}[OɈ&j[:Bi:ֵ ?[ExM\ -_}J?-]dɄBiqYt<F~{%ҹKc87l'N8p<P|s0@y\tɎҺ}wq9>uX~{</9^ dI%&T ӯG/9n$|_ >&|vߖ<N q^Wm ~o߾ ݻwرc
t
LWQס8%+AE@Uܟ Y?,{
_Z ~Y = 9EUy |4(jGWGGK+p/:"cJ8F{?H믯p)
0%x pPHB+/ N dk@^~=Pۊ)ɭxG0Buk#tVI;v00ru 8}&-4 ]4TP"~ m"JһKoW?>4}sOTA|5/۟<枥([hW j ~NvworCU_*C=CC'o >BUY d\sn*ɭBtEV%G˭F=KS* Hn(| 4yt#yQ==">v4<p xA8>S:~C0T'g?8qozwyJs^iyݷЧ?wh%ˣ
Z~&;+p|>
ƥt8)cɑiT/.'ʂ*._T .[6">stСՁ[M+
/Mgjpɹt$)W. Agi:3T';J]۸G(WgΜi\̷m`GR2.
AV@Թ_84
I ųG2heT ӿb1_+AF&id| MAt
Zd -A2.MGZNʪ.?e X͏t@FC訉<
A` -pք_)O ]/\Aߴi o&YPըY7Cg(# w(e HHя* Bt7|h\> @ IDAT .ϣp GfA\|yGN
w:im|y0 v>SWLJq便)-Υ#|(hI/P}7/P|I)D'm{hM.W#t͇[Dϑ'z?MFGwYps~Cx ߡUCSMwOɦdC[ KQ*Ϟ.QDq!%R|q8
\}K,+0_
' .w |Zyi*u Wݞɍ}__5f\ T¥PsTZt?MiqU\ywC 2*`hVx4: z;\UV,*P8<:VfH +ni84p }wYjkއyieW˧T4O!v*Ck }>q Yx`< 0 C}*8
-S i\+<eXYn&'p:%@ZIp :m/~h4A<vuPPxe_B#b_M[v0}?tز,/ z~WiMC|j)N M \һ\ЧKOLN<Qs]~xwVNRNg[imFAtO\~4tW!z! 76?~.
piCɃF8$h*:64In^յ~&Qi 'LZѪC7eui.^P] *N9w8(MiA^\Чam ȣxvC v$CN7t凾x6ЛBiسJ' ͻ 4
rpj@_kŗ,-t۽/59ܯ??C._ k}<2%+nmr.Oy9gE4}wY\G?=5{U^YyUWO~XK(ʃp=ܕ^ʪ+Gǜx(E~O*?PܛaʧR.}'b9U?2+eف?WV+裴tC cBKD ZI.T ^JH7!ŻIOV$Cg. }Jcax55dA) Wa ]<.A S~-`t`hVӤ[IJQV KKW*BU~Yi_:@6#k-~^wTF.|۰˦]ԇbi8MUV_
*_JyC:\-Ab`RD ~H]VщD1.% Ok
F[r9Q0KT$//O;z?B4 ^. &^[ )S qK?\Kt/q
jln'QxjtP=L[&[J?xm/;ꪮZ2<mYCeώX!uEݚԋ
5FOfF!;r\Fx5n&śtQ 2@[!uSbN>QAqx
o+ʢoYGme2 @*ge^9 +CQ͆ۻRr8A?\ **c[ boNplz
bZ5i ]hK[͵ 6 mheX7RvDn4ol N(e+
eG<"5CnQ+<x/ s \vz2bvţJu:Vh e-тV
-D U.]:!>:ApmoDLXY{aFIBzЩSGԯ[j|,_ ztfj:J (3lۘ8%ґ] qH+q̴36~ccMBn]ѤA]ɾ oK_S8@Ĵ8Y^5t
402ǻ<xD89q8lٶ FM
Oթ3ġ xw+fתM3=BjhѬ1Ԝdl5i5ͽV}2mݱ1غ-9{
:whX^Tqío )܇Дm'~'0he'"ehkn4m C "#= ͔-6`GlРQci
kEqv!#k"z5deU 94Y*WG֭QVk߅sS |,#鑋v cw`_X 4iX2I [)Y 4?dy:ܕ +/~prsvԨ
(_N6iS3|,; {k`UW [6aԈBwa݊EuK"Mv~J DZ surjjrjEp3]Wau2v<nm;f+m܌ڭEs ;1sOzwjM/CROׯ*kޱ['N<dtҜi7p( oՍ)
m}_a V-_Yv 4q 3HV^!DN A~* OtRȳ/ cN~-+bts(b\u)q>d8]u61<?cz ʥ?oomޭHgpfҭx o'p R[{7c
Wrdʙn}+$)PIWy:\K ﾃE#M \!}qF[Wg]p) ? W1xٸMQ8 TC({>Gj tD;*@Z|
|^z.t<\|X6y8(Q^뻕Bm\ã|XY2܁<u_2ZR !|_} M?o YmoX ߯ĝ4RѽvإIp'c}+~I}:`z$& J4}YT v 3o PͫϼѭٱsK}D|ګ &~<8:tkZ2a<zJ4pEZYK980a<xuذ)UM挆xѿsK~/0Ǟ wõSAz
K>
qhXeCbD$3+[֭C~
Wr/<V717%:7}7*: Ou)T[ꋥ
H!fBL>s4QaxpљǡiMK8~kjӵ
sO~f07=\`ߟǦ^muFѩי2.
/[
)`=h';W>CxBl^ AV5cw♅1D2ģEQ$z`.R{x/ŢG^Z /n?d~H|^"MZYYݺ>r?]u N 5@
ؕɱxɪ=ݲ6~Z'_x
iڂɜ] jfգ<ZZ 5h*0a"<1tյD% 9pɬaxį_cΛ< j+acbe UwW{<K݅q}`Ű =\
?*
R{ȍ' m8T$m9+QhZ/&uQRbϡE*Oy"{7z^i~Mq,wk\M|/zMBDm+/_y=ZE_o ]M<pN_tNBoݺu0/կx|%$fz3̛rkmI^ZjMvJRS2ܜ^FjO6e y9^t/qY^!') wMX,~,eez>Ze^fFgF^
KKrs \RG6qV(/`~"_;f~v/.>ʀ쥦ԤT7lmR@=
4/|Rvy)iBFr*iӋOHwd
L/';ecW˯(N__K"
]p{nmۼˋIs]r/'=ۺ~un/wm }%lc ϐߵ-۲9plp&ޏ~r^6vx=D E ntd1f.8~JG' i0:L:_jr"yy»Se%x~1;s_ /\]9
_ʩg;u /5d"
m۶ͣxܶv9B/%9ɡnK6'Ëٲ[*ORgR7%{);黷zww{c SFyt+]za͗{ϾEq4oX/goPolݺգC=^ HMAmZHz?b =? thmʡ˃y_:;{9^zV?}ߴTgS
6}/ Nޗ5^bSs=&eշ|.I9YeoPH}loWB
[53# sVX=d//×I;3]ko֒kO՛|s6(cmA\/5njY?z i}s,˦xWޙۼ+&t^GJ^ܮ ={)V|
侜TNjkeQu~#G??kQǓū6}m۰{ۼorӽ'D{>'ŋ%팉樂LZK O~>`{ &yWL]:i5]io
zs;ц?qyg~ G{'z
٫7r/6`)FK:LLѷDRÿ
g< ؐu-\;Zqu*uH&;=^̓ ~ǽWk_-tٽ"q&+N ች["'%֛MZ? Z~]0gyۓݻ~eeRvo7f! Ӥ.=&{rw,^qW]}8j~Qc*ѧ6Yz7oz/#3óû} w(yk֬bw'
m۴e;mez/wwxb}7k\o'Gނ/2*;ftFqepmqF/N# 宠
=ø.o3#fa2
ZmOUs䋭H]
LF sX>? bUNI EXw؇
A ڬ5~3of5M0fmHn M¢6b#Q7Xo{G{ӟM\2e &'~Ĉ!~dkX<wLD ;~^Iƅg!rH_tLG > 6y1si.e"s (Řs?ˏcФm
-c<&isb'IihD_Ņ| I9_fZ[QW A½o1~/pYitv4zt`t ܶ; ,nAܛ.扜\A$~Wf~<;% n!̖ 7ijT]qYh2~x&ŻCܗC«FIp o= 5#dd ;W2|
{1l@\t0ԩa2x-v;L Ǖq y0< WY+6W3~CY,D/9% E= 6p
RG"<ܒlٵ7䏜F
6S!͓l4YiaPrL eNo8+јWI|W_Mqrt7x<1G[$nۄ3ѩk[4w60όw_o)SG18V>V-W ú7]S{qVݸt+
y k2IXzNy8hAgٵr*pD=,<);=;1gNIN>;] OATx|;*Pɱ^nZ
?+oYFKб1;1C`bX9 jUæ8\Q&z A'jYW5Ï= ;tBG%/{ahk ygm,:6
RN}Wfgao߁CsY"RZQzrWJPflcqǢZhodHmw(mׁUOQ̧X: d@=qݸu
sQv+nF|A-F@hDE ȧ/a))8etq*ߨ hŭ
"AQ+G*c&/]-IhVWwPfIGtX
ghĘIѱcGثTZ+e\FX^۾g1q;b7j PZvꋩ݀WaqCx
w :l{ %k{g9>l#ѾGoL`8ӖVP+xx'Ѻta\<p$Ԫ; K< #*#,9..\'8Qh^1mqw8G="eV)G )cccʟfn :8y0rۿ B|a-cvɘz FcO-7\Ӧ\OuΆb͒ {
`*-/D$Nr OBf0^~,ν|$
>#AߖI8ܾYm(n7V^FO<ּSm¬UfnAO]VamjZ25ŭ4K ڄ|&{#09>?ƨQ⟶Cj2a{ ~kV30ډhyX`Gu6ݚdU
3[%atN@K2{9}%L}l\́\ 9n j,ێ_Yxyhz\ј0*c#ǧNt٨I8n'
θx<^=cxBz9>}WeYv7mL{N9mTLRh|86
OA|q'cO):q:֏iSvsf rhgĩ߫v@J&?xr"b })c /ۊ6C9}DZHd|y"ݚlOؒ>}mItX"%
gjͅף)<\AjShӎ=#ϳG"ת9d&
_m ק^M( lɁB $ry>4+#Q Z=nNŧ_*KM ?n>*0μ<& d
sf{he
r P/x nez9:JCǪv?.'X0=4 ۤo 瞍)];)݇XS^s[9bl 5Ga4@sE4(y Fr^U4oX
F͚umV/9b%HNWLGÍ5ދ>]l?
NjS ڵT/r0do/=|?lQU:ѭ-^~=xDjl2;|-$MX?'p qub"gВvZ '$^
_ >+>5aq?ѩ䚻c((V[9<{>q];pW`bs<@CjFEߩ>.~Pho]VY\ 9%um\ $W@ ;{2Ђ:QXX
hFo㾕U֑ݤÜ,l*at@YmٗqijPspܦի16:ihLZE_nHKIBu1xشr%$҂Y'pJ~&ۚ%[1 U&܁uKq1ٹx9Vp~ؓFǧ?Ts\} 'h}ʹ+YFO<mN܂k/>cԤp=gWIu3锟y2Z3>~ u%^x&"w5_N= ]q;?aw_bAѱ] χNc*+ eaѷUcOiR9 b]
<qbB3E%P^r*ss3b(L~^EhP
;Jisvq 1q< -'GXhٱ%z+' k töͻQ6'FuSj*6!6fvĕc#'1LH)DNaIJDfL"bwF!-u ijqzn\[UԤQ_yo /m] ;=5]`UE{%{G mquw-mk]]uuuvmk_*K Rh=3Mr!`pg ;̙oΝ3swo[^[ULVêeY/Vz& z;"p'#1'cܨdཟK!쉋8=
5q\) g7`ݨ>n]Q+ $2r{+\<X=aq~,DOG`F*MހߖpKVQۿ ec L>cz/k3g(DqyBO~JXRH9WHwGfIbrԃ>s= *C5'PuEͻ,?Ë (13w: c) !!N<|-Wa`k2kج]4# e`H~]Ԍ!HHJGRR"+\ U"߷qC%"{oɿ_p86,g|߷߄pjc =]߮i2 B?gX?:qXwdAwf)+
zjǿ+k8!^!MW0kkW(5+mRc<z/)V
~gʔ{4']h/CGOM. Xr'FL 8ڡbѐ7e~˓-QSoJ5!hhP5YCy3o~ _[aVe ߗ=-.pm|Nw&l1l>x?Ǟw;ZG5
[?ا@VZqc"u+/c?yoƈ@{j00 2 U
xFc7?%}a_gJ+.Oڠ[]js<2u(0P7
r-/s+8J &}~KQ[]լط }R^/+V5[yR^oa'j֢STlF]?hϳJ'?:doa+)g_O]p´Wtfu(.JI9U,^R\xcB9+R6w?6>q1q8x88a9S0yꅸ1k xcE1Q뽿?ߜ4>
/k` "9NmxH-ٺ{4-ڨ_e{C_F7
Pб㩮zИrbKKly/.x__Qcfm9FoB&[l l1괡 Wi2c -,.Y/NkfnVCpDWr*6?(Jz5ջB}qYkWӃ'¿?Z
TS t\R<nP0/RUf(xi(lgiI2: lQ)TϷ!w<|0H GJM%RIΧNd@
~C1Wi >1z!8.#yidpRG*een⡙'"̡{=~ae CN[r%!F<
iIcTWUU Q>wQpE~7{1~b35ɔc_yԫ
r z#{GLi#ӿI:}: +!Үe b}wY Ώojk </֣ڦgQU? <qkJ)jږFc p@Zc WS(
lby+g`
O殠
ߎH" 为StS݇{ s(2+uȕw1ELazG<hor;Tv| <J6:Cۼj$I"ffM
sohc -{IsXEsE|`\zx?c;=Y%_725sލ`8
JՀQkpOsOFMxǜ~f7@e*MXTS^%;~Nx, w<
e=` u1?`>VI)iƏD~p!ѐ-j[*bzҴ1mh|YX
jL9 8 K/NET:آ-T_Vx:c۹ܺFXmEtuFw UBi}rLtÎN{$Q `ԝLw[E=O?ٟ㫣:R^[ͭ*.R ;՞<K[H Gz9c_WI5[<5S̀k|^Ӌ'kӿqe~˾[[;Wͯh9 N䫌e yg_pDBPI$.t:5}N짌
V1,~P6-F'LҨX! i KC'~< N (K5jBy %?KϣQZWDEqVV7}ٸ(k*VhcCf<8Psźfjh. փ2n]{0']rjP }%cx,~9{/2FlCn~;|LGj ^jvq8!6D 1( !9p>!g/ZĈž#o>Tְ!r= '=_~κ8L9c8(˞7p2㾕Go ϟ;tkzFև cT4TE@ݓb^"+kѿܔ,ݹeHz18q 8('k'?g:-E_ox;vfݩJ]"$X
!G a&6-߄xMM +\eLNNV5C:IhޏU$QBknE 6iyABx8-x
c-CW_VUClBC@4 Z$3v#ּee]{݇J\
5r ]ƕZ2J<[ Zq_;O`*[]K )GǝO O]p2g+>V>dUי+5ŷ IG'rf3A ڏK;S ^?bSNncukߤI5OB(44qEp7VEp?x?+e7#YWIU*nat.TsrB\ME)vCveq}y:ڻSI* 3ƌm>~euc4_Iv÷ kn{
.ZAaC9$?yV5 X(\U˱Z&dǎXsǓ7/ݏ}圻~Z~Dy莫ДqF>_T8iNv&_q 8t}F&9fl|/6?PJ,|ojtdlb-'xc/)Iۓ} Xe{(_.PMO !RSmd,.WV|n(DZ%S"|+u+c?N{ގAQ/ji-HY;q cc;j\,8
wI 5XZR@ S7 Yv;rL~%g4PE56Un j j [ay[]qVZ^ȵ`^(F9 -~e {-
ureC{p'4j M67KQ~\Ԯg Lא xe>fqZHuP,n%;8j
BuՀ:|2zU`'
-tw̾ ^y*VK}}CN ?Q錊
wzo8
g$k*0kC bb-O gJH\L>
k؋Bxl?~ ܗ+E` OEfXӎ-njS_hO01yυ8ډí>U3cWpM+opw#^^nx~~\+_j
EJP)Z ؞VMՠ
\IA0cJa*R<:CMMZppEӿEg DmXd ]# o i+\y ٰ7TaE0h<6}}2xNSW¥
?N$sb bq :,.S|s@ =p-6!F6D/t華T(ٖ ߖ /̜IfeuM'OV07 kj|`x$HMO~^\GGh 3\P<%U⡧{?"*I[p4=YJNl<{|
$} 6Ѝn6"@41q5W<rlV ?\|w?DzzWã0| c8ĭ8F^KόՋ0kpo` نgb≧O_1g )F%+_ޏzߤOdKn}ZgZ{$_aaa_8\rp"( 5c2*&+3]u.[Xg=pڅsNǠߟwzKj$h)tD[${P]&_-ӧ У|>-+hoi`5dyӖXr |B!HgUDzUq7elב)ðj,d Q?/<ߨc ?e ̭ '^u*/7boQ2A)B~˶a Ȧ O9F0qxxLX]yaFQ#~ɷ;rZu @M2D-pjTn3:url 0^Yu<WϨIx_ cqoG`8;8vLrk傟"`ϱ6hI([gft~yr
ٛ6bg(J6?22Ѐn r6 w: AxO -:"y3/,0Qm3t5S;dMX9 |>FO[p#$HK1\Gkx;ϭ1cgK\ _zi&~\we8 [6{p,7o.eWp2j'\_aϾcƎV
^xm0Tfb[ $:lp$ny7>~ 9+q}/Q@\ƽy&{
}tFϲ/]몫Bk.;Ws C\rHE7
@xo\セOކp홋h܍WAC&=bN_ _$pl5{K)ݪGs{ΙY1u0ik@\xDs14܈DZV!.qFFh Wң^T7w
Gb|0FzxЊμ*Ll2N8&Qe 녑J
}3ecU |/V~w<WyEW1] @OzaIO Ǹ1b.9FcN A!'ÎUrkO;{hFb C9qd ;/;WNJW{'xa4^1Q/w`<n?a\ kh(8{ xpFuD H kx F
;5&BCp '"W*dO{ R cʇ
ϝKP TgNcbըGLJ4'Nѓq)m
dJŠ~%wAM`5-\&") ?ҽذzʐ84G'r";R,U9މ84Zqf"dJ BJV0M2|i,ʃ{ኾSQ?߉ [,w&+ZmS~gW2NE?khCPWѭ-ds:~2Bj9$?~K&65<|nGEwUǟc) h>4M;ZOe qݙ cN:E8Pպ#:Rb{+2TWKݗ6FJћ'CXN sOǀ49rQt ~CF`4;,^ q];d
!Q1pC|A8fpBz$v"0juT!zYN=Y1f|I%O&)BL$5`sCbj?G/5Y?) +_/I i+2bO. T`X|gX|
Πߞs
emsK MW>p ZuUشz),Z˖>_yn͈ѣ% ;pӀ]XSqI?{Ӿ
uT"o2p&Ϧ+NA[۸BM@qٺa=b,D&EdRz >1;n,\ĆU\~x085FP\ZDOM!¢S0đ\\z)rUە]}`hu})}Ibp1Vd.îzz8n4mS= ueߵ{ {\y P8a#q"Djtlcˣ{u9wOkڡz<]Ee zY)ۑ6` ¹?<*G
3>Ǐ"Õ!$ו n q'VsfSQUoJ/{s2ۮBS.A*dmPO3eW x90v ܔB;̽c/HEժH{%4㧌];8a
)GC C Ku$ hGb^?L3WՓ!Ž@+7'_Y / W7ZPys͖g_~ȷC!sR*j%sc4M aQxa @ IDATX6k&f|ݣ_dOh{Q.>sp}\ŝ( ."l & 'knl'a@FC_ G&e6%%InU"MYG{$4~emUVZEP'aTyNP;Vͺepƕ=Υ%4G3x~>
cG`eg %
(9ݻ©?`ߎIQI4 ^<azryV7r/%P*[%)[n$GBdGf}blLc4űTeϚ
[)j ā Bxn:78aRfby(گ GqeYj /TƼʳ:ۖ쇏CF?
v('냖ec`'eu 1WUƸ4\LX7'j{n|QڛXo`''¨U!HU?z u.3s#.㸚-5 ,cCcFU#Μ-PLjqH$3<j_wu3ph52cϳ4Lk孵,,1/ Z:md|0#9̫3>M`{nsN#X
{>b
Tno:V^V,5 DvVN+4Tz?Csi]}}$) #Qx (8{GǗ
A&ߵKQÓG(X5&hFǗ'Tam(Q
pagk:gTB2'Ov o8e`_^ZBNǻc͞ A0ݏ@Q)n{lF9JqCwƸ
3^\ R"Rn{c]UNk Ѱ$D{kiD8wC\UZj,]P|G7r˥+Nlq˗/erGj? ?݉E?56i:LM o$%%]V8yۡ^}l^ ҩM8ix]-bsǞiuOH23éc2m6G4Ok9Ν;
嶠bK~<Ko:߬u PvA2q$nA%8ԑ,9
O z߰yVJ,{Es4 17Mx mTɦ|
UU \s7cUU4;ܐ٪]";>~$.&4%$"ތ:p6
KʀJI%U8'#Y$GY8yZZb\&
rg[9UYHW[m_}eTIBA !^IwE:QE N48|%}<^rB u%܋a OQ}D~NW| ގhK)GG 6!}p@7ߡ(aT}=z+t'?gUңԵ΅O56 A[cy ۦw ]<84bq*w"j
gmVI9nT"#}г)ĝ3z'ECC^Y2bWԃK9rVuλ3"kmUi 8RI'?_&#SHqv|[<rqh5_+k U-ڽSz͇j~v8@okWo N&ﶼڳLVZ^(6|#umlCdhąj'r=B9> МxrU/=c[b<5~ŷqNA JAT'jlty u5PH-{Y^W<
;z y 4
P-B[nu0k ,G\Ӹ6/ la$7[)vo~[cs+Ϛ=L߷5?/Iao(/+H\[XJ_/,'?%.8yqޔkc<U&bMw:MϑkW@fɔQ| @C%kҷD@pN1mrEKO{wȌ 5=
vGϚמr$?{ 'I_x
]1f㜆mW4-Ri|o#vUd[}ռu|<kvC OvzH<4t<b=y/jJ ,
yfO+?O-:}K~ZԯN9sWMXr3 UqRK ;1#s + ;?:\:9Cynmݖ4Բ7"8*OM&U*mRUY85k{2*5 w
ޛ-i@U%[&ymB%g+ν?ٟBg Mesqoo
Ce1KhAW(ں0Zc0Zxk~WI]\kqZS4jVҢmO08^`i Vudvt19q<ȝ1]7,p9&uh9zǫ#|EU( oԷkzh>C2{n"yӜu6}giro?Z5zSCI뜟ٿœCGxYǗkGiqw^lO T]Iw헣-A8j~t1G![ Qaռ8ͅb-іZ6)%bvk^j:N{OڋIM,6k=tigKcÎ<qqiIul[)i+'mG]];w.vs/>P5QH6.֝B p2ä:6є1yjqs
桭V]9yjRJ&/ƺJ:q ͥZwMCShkBXmF:u֩nm6ԙ/,ʻc1B /YÝt42|r 2DÝҗI$
W % iSWVe jI_z[XVR"%%% 5GecNNf
T_"mEҥKM_dl!I>#ٯyXrz^}:>R~T8ڏ |a7vZOJS'H(m! 8EpoK\\ dԳ_Ѿlȉ
ڟL[D-u\XX
q>2"MVch;ya**F{Ryl* v 8 ɾ5~s֭Ч/ |:H= }"Z40ilj [nAc[SÜi
gWt|;گvZyZ~AD`+^6'uµ¿#z3ZÑGk4#- c =0iY
~_Y.mp| Ȯz=.hK;;ĽI=M LY{zr M}`g0? qt;טv~8{i
2撉=t=wI㮤=6 |krI9N+yM](Kl A `0 A kBTq?_S A `0 &Ym!Gt?Ty{}2Gq$$8N::kki;g#ss<^3 8t n6W%c).f7 A `0 ۛ hW@5cf0 A `0 @&{A `0 A `0Jh]T+Q :W)A C= ÂA `0 AZ0|pўmw[\ G6;x$N~B `u#`_wſr)S.\{
` ^$9RCmw F/D@IlA `0 A `0 ]G@djLܮf*`0 A `0 @"ЮH-w+C_(dM 5AR7Ҹ髤i8<ڢmi409=LDZ_5mxq[+~8ӕt|YItuv}k4[K/qE9k_艳[>-yp}:?:sNg4OWMǞ^/qgMG}k45?0MC:鉟;_ei-㜇^~:\u~_.4MqOsvښ業t:s|/t3
ͧ=NqVttZ9_k7{s^Yۺj?Ia i-M{4tyh#:9܋sNgZ:OyӲ#av{ &WޞVa:Ngkk-sN#~'t ŵECk .i[thtN^'W,q
tߞ=^Gap;=MC_]AwfP'2WA p#^xo0 A pt"
j6 A `0 vtYA#q _2(:3 A `0$ZZ^\res{A UD03(M4 !!!J7 A `0t7-t{j {7 G j^[[UVB G]! A `0 Z=<<TWW7Zբa
f0j eێg0 A `i+ˀVVOVF'e /]*:iz8Լx 6 ,ڂ
hwm'1z('=z n"Vs, A `0hW@\do {2n"<k?zBrztusG]m ?yCvpm߉U`":+S7*eFf꛰;J斑:N S} \ݱ
t k{89zfS;SA `0 AC4mW L ^`m lFM5(* u___xPprwD@%
Q%ePS[opWBdiٲsK@q(L[yYTx \h?*KQQUwOoz{+ Xq8jkC?:&7sJ/HĩD1Å@g75glΗ^j~6Ӵȳ8{xؑJUG2A:=4?0)=?{ {<o-Og0 A `0 sDp⁂ b?b_i9(8V,'|7ŕ89J-VIC 0*BɵAV-(ax;{{|ٰeDmyf}~ؐV>mUcɝ%Q +?yq BDʽ:&ϩ\z_Y9%ɉ+V }5
9RvMЈQ/a'%h[¤ (ـ瞸Ͼ UaI6k 5}W*Oʟ8ow
у-0@~|^%s=/oEB:?MqҸqxO4,[quXR59˯.Ck8*T:º)'sg0 A `0t_.0з7{J*(p
+}VG ><<\yvI*
R)0QUHL[YV?qAe{
yհwu ^/[kd8s愃/|yzz
xR&I=Z/a\/ '+L`xyy蒽\uyD! ߤeWT4-/ a!$t'iIEP|y2oo.ԣзx0Q[ ihx+
^ \Ա $ ďuaaxm *B&ǢEdRAՃUG,j_,ԫ.ԃ ۛ1$&V 1Gw/ L|"b&(ęHl=:!~Lt/|e Z}I%CX A `0 nCK*ݖa%DIE<ͻ] )`z\j 8d\
:5
v`ݚؾHJMG>i]Xv/5C;*& ir
zNLظ,S=ك #:!Qh>ˇ( 8!jS&q"P ZQ [6o®=oP( oƈ[A w`rvw|*ˀ J{voǚkW+%'SmBz-vnی-[KnIJGߔx @Z.H; q딌&l.ܵda_Qޱ7ea [ {p+'bS /ĆuPQ6 wBbKiSc:ݸUݗnSu5:\ Z¹8 ܭz:/_` h^[s w76]mcώ-WPTq胜
شm'c䍜 ť"=1
{U >HNc=dǓJ ZO*m Oo_D%OtxFlڜ Qqп"x Mc%sbeqUGFǠo X|5qg@Dx/TA!2FC|iC
lo2x8.Xzv/EjEإ
j. `0 A `8$+AǏ %"+eyX"ŻzY;d5uTQ
m^:ԟѬu8 },뫸c7g-&Da"IclՀ ѭxg,O`y+ϤklISyLK9ˏƃϼO#c- sMsQ`;oo~cx8 }Xx71Q^Ow~d',f|r1zqwɾ<|KxO1qJ(n%[`s?0;1|h(?ąpO:ه+ PxϿ)N [V-ƃ\E9R) *{ˊz؝62[Cfy:.:cě =:| ~ O
kO\OX| گ x# ;~3x\ 7g(68=?XU? <~$6,]3iSa._v/bL>dϜ) 폿C<qϽwu'mg^1܅߉]q+1+Ma^ǹbeƀSΜ_|g\dxKk ".*B,QT `0 A `
]nW2%b`
-X%_}#8ȡp{Mwᡷ>1 *y~-xW0y-U#*?zL xr BJZ2|( UWFAk2
,^' ?a><"Rcl !#.3 \pe3"0kƇxXUqp~ݏFbuw9?0w.<}"jKpER s͗Yx3ĝW_ذ@iVbWO3?PވK= `1*op~E]~wom>xƎj:P`% +&_k_\?UW&c
\QPͅN7P n"K=ǯ>=ݎq18)w=<>p1 6wgpb fQ8?{pcRN _Ut 8m?'?
o
)]^Hvǜo>V
w<iFs@\u 0o Ξߌ O; WM UC5V.Q '_p9' kͳfej]N
-Vyۮ_<x1z(L0Q7߇d`oM0iL_,[%Opə'˧s= bWX` *5zA8A `0 A蒀] v:A+UfC:/BvCEE vlS6e/FQ=h%!*bm˦,TQIkJ4T(f\P$$&*w`鋤HGgЇ
ѣLXA
Zֲ;w):{!ƌ JugGD)kET].d 6c ?k5gP
uv~ł[ y jH{'S[ܩde
OErlj*,,+JK}'*i' TWlh;TkOCֳ~3Ͻ 6 zѣ14! {7(נyS4N<n
M5BqeM˾vص:
NLQ{fI㊟ K5 {PVU# ޅqBc3r\}bj@]JJ
< TVne_6 &᪫E _ߵ ?=Gݛ`ܰ<B ⹝x{s~G!((!avo>x
'5 )}V|ض&oZ|8I2KʷY{Q E,,~7n ꊭ6vxP/)T -ܧs5 js?gC=3 `0 A `8t~:q[7Z0ON@߸(ԔRڻ _Q=R
Ű$%_zvzr5~-;tu֩T^h1ZTW[+W:6swVJd둍)Q
p1hRQ zSsսZ BT痋3p8FKq4Wxqﵯ{5[BT[/ҷ2cRV`'!~\M}uȦj5[6GO S *\qu<NyRr4
'ˤl~48i!V!wn0o]k8T1d8Fqu
U8P봓}t!wWNpLp;7 ہL܈?j8,yb`Me !2X
jHTպ!00?ƚ5I3^x71pd?VZT1Uy<H}qje
kqU K G YCm
wW
VKi`aXn-g.K_=[ cȾM#>R 5M\"g0 A `0 4"ʳAwpŗªl"T8ʚZ !>Yc_Q%zG#%9 .ػ٪e
9dZokh2
`7
ĺM[hͽ:1x6RV j(PtuF4o⇟А&̜Õ_,gtK}җJb o:P/{?XI#xk27ÎbZ6<t!O߇ TuuQGs,Z_ش~5|*(Ez շ?ZNn?]H?/RJT/⥬!χ's~sc
+N߉> ^8v Z{92O~#R
96.&>+qh.1Nq,|S 4M?_^yOES +w.^YA4hWլk㋄Ǫ|סWd R
VOye؋7 Sϻr+U,{QUK@;L= &nUh8}\PNl^:݅{[Eѐn-&J<hP yYj~[p`J$&O: 6Ozn4A `0 "`- l N^%@-- O9 T1%| 3O>[G&#Jxƹ"|6 (^18kL>]~Wyg%OJ6
4p&n?4:
KGw5 xzeQyMR]%^LVS`ĩ7scμ / SΙ=ࣗR*$Lr|幄 }
Y ]g}__1eo&r!6m o݇'Oè psg,iwO"#9eq`+Jt}}
N b S{+$+AZ vl ;w7kZjEܫ~^w]!i]&6sM7a@/K_GTɣiOxQ'F?ܓI5
Z§+(;)}?]7ߜ%^zb,d<熻1tP:2z w>/ Hr['_3kMEs@ڀQ ~қp-BE6ϴgsmk_sjg_!RϯqA `0 @"@cDz<jUٳgsvWRj^HΘ.ڟmT{B2 G;sylY1¢ /7ߋ,r RK~
OE{ytX4B ùJoٲq eۑ#C"bM&G&$!:2va jvRH 'g9[ږ_KKϠ8Wlݼ%uHP?ھM
^Xx^Bo9')/ 1qQm.(ؕm8PRJQ HIE9-oٱUk8(ADl<#eZi 悢=ںMHX[XdN2=yظa#XǬő純DҢ}F- 9# a<zmWVص܃&6Qh;h,J V^RL<ύ7mJO$R"4F((k,E
ލ^<rO97s2%B{>TOJIAemF^>SN
Ǭ?_ I*Hcx Ǜ7$Ɓ+s9ch/z؇ZnPq/u=ɓԑT! m9ط 5-*x0wx
vasj")1~^
7ȽBS=2:ǹ{ ;7coY #$oAmxnW:4Jya[\ W0s̚SrL-[gOF4yA `0 #i([1A++dP~y,_EWe\V[P@Jj-|qJ@HXgmݜyҲK^j.K+{ݸOY5mWNA<?%`oQ8'j\ɦ 'i2.Å/[NY꿇+Aۅ y jkO㙴ܢ]K5z>X
oW:x*.i Zcn['Ԥ,uD%Ҙ?1p|ZYI
s:Ԇ_J v,I 4rcgVa:dr#+əo>z5x |]\rxuf-eU:Sޜ0K4V ש6#tQڇjr~Ox6%!eՓ?i2I!mDڥڃμ܄OƓ` XQa#
LL4GE&
A `0 С22g0.UXG5i/D DC`8(4SkW u
A[RH$S#մm /V|AN+ggOל: y[ĒF/5QIOo8#Kؔ3gYn*ʇ2[OBxTz;)/k_<c$Vu/Az^YQH
WWYBqj*Mh"Z<<$8Z?G2gۉАHs. 0?jP!jReXg \%ֶۗyr*ppe+GړlthY_U)3PK .uN 0eNdpRiäA `0
貊UAYir
s# O yj*%5=.2 {<;}VY4ҴW[Vm1]&O3!kkΊc?k稇⣰ƀ"K>vg+a>Up.vܻplq'yu<}^صM4Ͷlg[WM[mqJHfХS2A `0 _b\V+g"jj* G?Zg48]:K_mӴŋYq%ɀ^TeB4]ߙ`y,+\[M ~:m@xμ< :G[r՟S/1 A `0 :зoߎX߿ (--UWH}||_ĉ"+bXϯY\___5(B E_=;}D{{{7җ^<N%oͷ
}%jB[B_0gGU/.k
~"??_rũrܝ/-,M0/u]+gGGuL_Tݏm+eۂd˹uD߹;c{\WV[}mWC_ʥ}o;ڪ+yu]iwq[lQ5 `0 A ГH}i\AT^=L; ۊ+8Ǖ~II s=,ujK]/mai9n[<l=ngy:H8ՙJ\s嗺i#·;ߚ8粶ǿ}͚58 3WA `0 /@+(+zP,d 5u\kW]IӕI_YUF"(ȳy;_ٟ%NkuUv=:mktтYWښ=eۺ/C4ڿ:#AߎOo0=_%#}8A `0 @OBC]SEYqrߚADYTU19زkQ;a8;/L[Ge)$>X ,_Rz; , &A `0 A-:e@+څ ʳ\H[Z_0v~>\m͙\]ᦎFI:[N1ݹx `ˎ@v& A `0 @P@D8U' 5T1P 09/Bu涝/8:%xpV |4Kc:w *D9;} d%\_kNc[kJq|sԧu: : mW Y0
lhAa~y{`P0}
z~HZ' G1#z2 `0 A pXP@WBu?{6ӝk(|FM1Z:Q1$_|jp{7>(I] h8`CiQhZeE/Y(x#|H^ sEȲ iEer;\
W( e! @}xMEk酺ji(/+EXLL>a5 kRS B>Խkig*ʳ8iSrŸ窷4rgܻs`p-$mvƌUު|Nq$qA `0 tUT^knL<ɏ-Jmt 3>"*aHV'KhCa%0:\<~mQKQ!X`cErE sg~]ˈ4&u
ps <jEb27aIgА,5ppa 1 %GI 4&Ք20\ kM%v< M,3-݈gyEѧ\Nri_6,>.u mMz~G}H[SmW=#GS
f]#_]]j ) ݝC'mN%F '9|{"eL "BT WAeBڒ#i>zmWˢy8 8b A `0 AW@tJO""_y8w5s
Z =v,"fܐX1kzK>!؞ Q8v8E!k*,Zq
Ǧ[gIl H"nE+ ۄZW < k-f.%QI])XA蟑*\[ ʒڎt 6 Ed*{b75 ,9\eQZ]daxJ|>,1~5Bzw/ 37Õ'*hx?>.؞ )}bAܿ -Ğj :
q<1w<x;eCAb̙37 {-0 Xd!X;6FFFJ< {v˱eNT' (ƲeSB_P 7i! b7xyI2\!q 6cLFߣ [QR݀#`h4NL{DS!6) A `0 @tag,#p ׆TRo
ǜ7 wہ &_/ g^+O<SѰ\|ӟqUSQs xA{|E
"ʪmO5g=$_)AX=~8s9^n>$㣙cPb V-Gi GE !/ݎpJ|xpΥW#Ư?|/q2>{nIT)G#k ԜWr vD;+D\YG y1 pۃ 1(+ _py1 _vZe/JUpÝO /GZ4 w+03H'}E\s3{~'uG=^zEΫ7F`ż/#xr7͍w)Ǝy
: *``roTsoެk0 A `0 t^@~M\<mn{mT})* ٌrO]_/0 "{ϸ
87gZ:CIE%aY @ IDAT1PQ)[%{w{9w f=̼;wwf&?\}[OWk։f[
qU _AD(gim2MX8:!,ׯ%Ju .㐕v[\ɨ ?Q)зC3ܹ ϼ>럗%2ll rRw0%_Б.ܒiŰ?۠pxrL?ڏ~3&FVf{s6yz*\BP 9z ޔ)Fk,xe
b| OAꈭ8>j9 GΈ
0w,\ 9GD]tuu#%ҮSwxDQ_-W mv|G<2+tm^ /G5嫽 '·0 sg>!FjV$DP(
B@!P#p 0pTl߀\ Q13"z}*L|iӭ-| m-aX Eh ɸgΡ
ӗ\hy`LzIX|t֨`"Vs`VP p7n rGwpvCnj輶Ӛz*z͚0]?';5TS;bS]Ib6"3-MW(J7_|HE?MEDw#1۾7@wrq7ß - `)h Cj`6fsL}3QިV&ŬF!ֈӚqs>gCѾQ 8Xg 8AqՋݼ`1B`d:M-ڣ^:ڭ *UCV1Xe &&m^Z%VY649;d 5FEF1'O"ϐWqqըg|e8z'`}G!P(
B@!_G :Ք7[)
5S.7IcfjEJtq#9
Ħ\bt s2286c
7M
M$af]i,8{)N 0s0}~g|T/ ~K1}63TF-3F\ɥޕ'ى39s&(}&t LmԀP/#/rԫNq;qONLsud禵Ƌ_!;St4 o@(۟t:zb={ EѠge#(։ψgQ]yj$Mq2݄iߏCgqFvm}
7
0!Iwwʛѩ${aL!Q"Aǵ8*ķ*(
B@!P(1Agi9ں kqZ1srP^s4S{6gJzM% |5; {>} ]N gҌYzۻ B}qr'D7 /tNL2dEۘ RlճEM8iJ]<i/AF.vw)'oZNm BcN ;
uP]L OY 6u'-ytƢ@=77>AL_go =f<8\;
x >DGk+$8 ؿ{NdOriFڝrIϼ:h i=;Bt̹8w8kTݸ7ECqs4cv*]i ј2`NI 4@҆pkU7ap1Į
HZ=k Yf<.ps gUP(
B@!P(C Πo[t{Mx5
;cGv9 VM6pK羏y6
b9rg ϒfA_7"Bg*DCbc}1%xdvTIggQj6(KUz8%bҳfo}2^}~? kE뼦]F_D@udދgh.欪FQhP
mZ%DλxF DXg"f>75*(=_<g'Y1Шv88cH319d&f- |)b|lҊǏF`np˾FOyԮG#nG ^.䕡
n} :LU}L ՛y qkj W!P(
B@!:*K~
ʕ^Ro* B$,h//o:6,g \=i&2^vjri3/>6+ o/3oC3PDGg!<$/h3tfr B뇝$t잜Դ <,< EH%۲ 8 !;#W._i;< i A!tɇo@ + 7b ЮHJ _o/n=#-Ek;GȅM"SQZvЖJE;"qerGOCFV^@
nt+2"!48 r+O
Cet1ZƴG b'DFGfnԗ"tKuHx%+-f$#7@
GBO9R?KM4l""B3iWAN^>|DK?Ro ᾝtBN6H"bOEȥ>N
>^d)`KWTLUd ́бcGDFF
_S(
B@!Pv]|7X1hof& !f؋i06YHzF"^[0T'Z]H ͼBW߀`_D=GmhkXDL(Gb_ڥV my$(tGR X'۹, "{ֲi&W<TGky2(,eK\&?S9H~n ""atnɠݻrmgĖ'r
Ϥis]>#iHhu3!
%>P\L"!:Omi}bİ 2p~L3<2F;oe?( w_^\Nj"8#"AÚͲ~wU(
B@!Pܖ HCA/42F$[a"8ppA|PT
6bs md Kق3TYk:42/l_6I獻,Ϻ^I#F XH|AY_
*4x[@B;XV4N b.q]L4 mUoKp;yOPq~lL欃sZIvq92> kNN)e:P<8W`?N6}N,e4/+ߝȔ;r2u:U!P(
B@!w p[γd\~kiF4y24y_N';!ȫ^+몗<e:z`{0N...pU([odvyF^VSoWK;*ʺe彽,S٠8=#ֶ{<YWv eUاq_2W_^iy8r^-*Z{VU,7%_//ף
B@!P(5%詩bM5Eg.LFʤ]$z,eəd myn%[s .?og_l2Ѻz>VW+֣RZ[?c) ?V~/j?V\ߕKK}AWVw%cC'OgGB@!P(
mP2WWWAr3+H3Q^?2MʖuyX<eKϲ/u Er94[nl^?˺ƙ|YYYzH~.vYVϲeٯ˒~+J__ Kǡ4\lc'ʪ˶6JKi /m+<~,,~GI}/@R>\˲EK9Ob_b!|/ǒs o/+˖y3bd3[Xʾ F<B@!P(
B^C3!ݦM "oW4dd#Kމ'e2r~YWbŊD0F2H}Y^ˊ|.MVȫ^^ʔuKg,W{gWt~iJ1[z.e4qi*?xڧ?e彽}^V?K94^^xgW[[ -~#AXb̲tiP(
B@!o%AgxV|W}iWײd^Ndd )k]F, F_]L}^deLYWq2^KYyOg&#JKriۮDIY&YYn܍~YJ]]eylieò6}R _})b*J!P(
B@!!p[γ 7 4]~_v뜬?0N4ᨯlbɼl(M-M4 v=IJ$kǺl(Rgʱ =\Uf?Dr:^|DMivPm,_
QiO2x>MQ 忹20:[Gh'd RUWiu# \?ŋ$?ݜ.ej{ {}>~{Yl^$^W(
B@!PܖM 9䱄LU9L D $ː,Hg[ l$QD
!Y2>$ɽ)^WGY>
kKbNHnive!5Jl>̾J
LK<EgME0H^O,
HkjlIՃ Օ퐞3lzZd_$$规s:rK Jx Ϭ/V:-*QWB@!P(
]@ѝG!kFD?^2zǵF2]&p\ 8q PN
xlT'W&\hŐ CEtw //:vfd}L/vCZ yj N.p@h$L縛o6 ⫻u-4dpf"$d qڙ[d/Co0.d0X
Lr4jAzF6_GŤ'7/G vkH;=RB`T/J3RRP@Xyx!(_ؚ ͌2n2ҙ6swsB幹gTD!4q9FyvGgb9K FPHIK77|rM8~8 _-'(\̔HLAʕFm̃6Lڹ
y<:RБīp-)*".6\n6SgP>?0>n/ٙ+.ڜI9 ng$f:R@'$(ϞBBr=]QaB)?+#6" n#QQ(
B@!PܓIS
|ts
uԅ_ .%y 'O9p ( ʕ!Bx7 D\9y_~#8 ;"ȜBlG7b<YK~u|x2zF|:(2bϱP"Bݑg0R͆ߧbÙ`φXfA )PebxsӰXӯ0v5q1d *ņi&e:!jL8Y~NA
>X˗eq0<7m
Ć;wN&d" ~h$EaO_R>]N݉1Ve)ѸvEB 6ec~<r>~7mҺ n_"62 uu"{wZj:~C{ gm+cA.Jꩽ䳯aDFN =+% nUп7$
Ч]pr,ى&MD ۃsc3!M;a옇]KQ< 1ޢ~-:G߸O lό*S2b~?nMKӞDT'^>nPxg5<Թ ~.|8]Nˇ1# 15ZRV"fl^;nHMIC a L䜖YI7o/gQ,['1ZBOw{.Ɯ-iiA~
B@!P(O Iqa\ 5P T\X JӬ6ZBИtҬ0 Ys2dFvĜ&8Ҍ5=YRB[
̙S0xwd];^x
O.\!b.ܾ)7 Yl) ۹Չ8s1=FcHtcR pݘ'éfۉZQ>g6-Xx`fZ[I6$6~;3߀.m1rp Pf͟>-t|pspB\@Qf-4P$ލb' sM\dơ][} >CG"lJp | , MG~ aBK9E 6d\ 9vC%+BhҶ'*̓C~^ SƸ!ma17"VMضn~\>5дa} op4'7/$ ߉~&aPx"4
]nq6&':z+4̫xaxcxv| p_WuFd
9p47m1magvi׀Re_I MxY;u;ʟr\oHHܛw̾xЖo芕0#մPd3S C)dD\թ=| 1ｧY8cz##;}F>6!?2vi>xmʃp!O*T|>)x\3B& EpGs8%/_' }'P(
B@!_IL /_3oph;\ XC 3L69 g/$ &*ݘ=M ?v]zezWHJ Elt4ZiY`&ebT 4"qfNDC[x*q
j-6~HBIQ=1ah#kLSvjFW.r#hT6VnylJ̓ \8\yJΛw ѴUM 8{㑑CiSUD,xU RѪaC4o
*hѬ|ҒO;OhT7FWRe4k"r'W kB٤)Pɟ`]0 ;/ƁPu Cs5[yr+2+n .>:9"9x 8Hԭ"*WEhu?4"?
FuJu&081SL/vQ4R.6($HE> )ԞuzD rϏnonz!ռ
~*{1Ӭ-d?=<iY е0"ĕGGbGb*
&9Q!s?yј4n8hC#4lg'N ƎAx}gu8P(
B@!':rt
ѡ8O.OvoDŽV5ۂh? L1e@=
ߢi8~~ͼFF* Dժr~kd|A.g] ݆|2bC#f^~O3Ɯt\Xjg-9$_,L&^cqsA\@|XZ͞EoH3DM.hޢϿe"AA8".\U< <~
=zt7iZA[k YZ3nqBv-Q>fEx:tbbD&22ŕy&o
VX0mhOZ P) -gvLm"fxۊۯ?o'v[:%lNf< N]`"J<:Ղ1w{j< SLsn #)K;ІzzG1_6텧ڛp Y@~Yf$]ƍ6m":ď o]#hL[K.6^n= [И{N FK"0 AZ)#B_->}QN ۏNmJ}s1G ® ۰z7y|pj,?·3گ\3iP,S89КE4o .ڼ
:uG0
k
?Q(
B@!Pܓ G 4h{OdᗏK2~Tx[7!p { Ķ)4+ 莺18Vn=C:yn );Zs;G _80Jع7T2yW#ց{TǡJL0rsp ,^
&3 v.
8shNo },[ǚp[LH1r3z
b/dn'ڨ<a bџȶPpquVfXn3frVXxixvJ6G =ģhGACUbu ?x>x-j**T(3n ^?)%y&0? [֮@N:s ״
<O?2UȽZ?ac~e@V$L ex74TQ51лkkxM KFyԮ Kx-0,2Fǡu+^ϛPsk{,17q W/ ߌe ߀5NgNaDh= GvmƦKޘÂsKQ$; B( 9{5x߬܅H?40Dcrm+~ߟ⟿&z z
y+CX|;F #1rAW(
B@!P[]0N
g$ L \ ig<tjR7 zENZ̩ٹ-B5c' i $IkmH @YGg# pڰ ޝSՅSEp^ݿFxgR? g?@E
xvqPL3Ei?Ĉ}4ćȏِ3'ZwZYi|B\F 0)b=v4
"?,Q IwyGy1bdfYʼnv1M@3o Fu0IHKK%sѥ}z Ubk)`6]aoe\rm1xtľ- 7ܗm^-,CxoZ
nnz|7ҎAo@ s"^(!Ĝۑh{"
?݉ Pl]ݰm/|]%f$&"-=
> tnY ,Gi m=~\t6[Ξb ȕc먿 my 'Vjp1^7 y j`io|tuL QE-7"ETӖG@\fy[ET7nV 13ݑf+l7_.ƀN5k;) =
y3{s gq%ހ=w 3%hX3
Z6% <+ӓv!31U+/юG!P(
B@!pO#pt
#>˛"XJ"HJfC]xU; ^6fAK(i.MFZG˴B_IT&澈?@,> }făѨIkL'^1]av[3kאȱF4͞<~ ˡv^hE.#{""f#\މZQl2DsѳO"Qp< l 4 p5
60`4b<xQq H%4^R
Eky+_Pcx\LH+!T0m<)y]ng|PET6nk'6A~ú\iuAP|Gԏ
sM7еUhOtG RZBѝ=C&jn=491xmˋJGƱ_AЙs8c=.ƚͻPFQ=$?0zriD=$#бE |SMNxlяs6x BI1~TP1g'b+cA
`m<َ{'@l_u0=[Ik1u-C eh&r\Wd?W,9<rW/]B9L< ,d?uhF-9XWtA^6^Z뗴VWB@!P(
*,f]Int25m;>-]Jظ| &|P 0~:4 +bTb=:rh2؈d9{z*<vnhW/>SG@*8w|nd(:thV (&rra rrZڟgcY ݆n<n3Ьhc|tk<w}F YXXo\+hНv6$ዏA(N3,Eظ ͠m=+syowT43WB|̜x]Y"̎qM.ރƀj(pv? }yM`|\Wō EIO߈-kǠf^ү;& #yMÛ?:[zV-yȣhD3
5=2
^atͿ7`
3 p|z^կVYLoeuNep^,EG h@K%jP[kdMɝ9DUmQ>`H~X^%*-9wt?*BH_"ٚ-Elty 6̼6wg4wIo{84- +0aPcB) N ~ 4, q=h'~ig> ~
cS X#\"J(
B@!P(Y)Vjѧ=!'n^y Q_@aƌZ8yf6Dyʹx% bl{v/>JC!1j|㉖|ԖҺێ眇]6 r5G) ԭ" u *W_E,Oￎ6
cǘ<1$Gpo4 'NCZMFXݧxoi97 y//.6RΘJ~Ddz^`rpI 6jDž3. 6h(mg'X֎4/B咎1FMftܖ{ nݻYЁfh
AH
HJ&#к1OI#
Tv }?]j#<SР6u)fr2e;OoZ ܍؇ Pp#GEFuXgX
h}_e!?uXmx:n
<JOT[7x"8zz$nb&ܼwصk/LӯcFX4Dlg#) L ՌkYӾ&Nݎ`ʰqغ(6D͡U,Sa:¯PيeY߬\=)
B@!P(
㝿mA1n: >>|{cE.i @ҝ|ҲrQaB+?
P>Z;f9~ں\Nr+13 vYRineJr WiظJf³DB̦P9R#ά'#3 tN/Fn<SXX`DrJ:pEY^G.h$mZ;1QDg[ N:)1ҩ<ODQqt ^kCG
L Z4::67sGXD®L Fdf;NMNDzVf~VDǔqtݓ(o, `11˞I!i@lR -tpA`S`2 FYL it ccȽ ļ}ٔ APY??)A:Aj[{hڒmZONK0iesТr/;-krx7U,-Nb r-vu hlnl5כ'OM|MyFpD@tVf&+i3<z<3w_sҮ< ^}gk8._ u}H o-Q]
B@!P( AH'!I6JMX V<k| J EiG 9 Z/aÅB 4unC;Ք0[O{)~Q0Іglڑ }W|[Sݼ
w9^'
B0)8k{_ĆޔM>hͥ.n[ SJlq6Ytr<?
Q "ǪO?0)ޘ6/S]2'v0z`z9xplrD?1 ^[㻢EvhѰ- n~ }*<xe{
~ۉռֹ?0|$>o}{)~˦Q
B@!P(%4[ZjU'hN[8]Qɡ bRO@(W8S\oL1վ 5LbI8v,>[.|DYhM9㡯#h2.~[ل iW gNҵd-<5W';uiu]ŚtQ&CXۑus${,
tvtj" QdlCzcݜm[y䪮!(~xguՑtyZ}J*77]ݭbl+.405k
m"k¥FەT2'rYRa2'HeTǬl: D7_3 F'>?} WndݓʫEZ nʫ=H[XuU3ढ
B@!P(;nK+Uw8 ?d2U! WF5AU
B@!Pr8:u8J)ˢ]y&vuuhMt6d3rƕgfJϳrFgr~.[-~mZ[g[L:O =z>]Θ=cV>R?<xyy [%/ K._V%m&38N
Ki_Z_ͅ;Օb]/p}^)i XN{,-b&vmep_ckz,Y&/F~2ߺ"s[Ɗ}LHYIJ+}_ z XRW{_mD$''vmZB@!P(
B BLOO D#W^&Z L:#eTKٜ Qek&?yܩ~nLV$Mme.ׅdrAJJHcLs^C,,u㲥m\.'Ɯˑzeql 8?"<㝴wmu7}!lpl+9N⡯3O 8/K{,=_Z[q&ĶtŶҷ/_~6~}_ /sJJk+Ao+p[q}Xݼ\pзv/pe_|yy /x
q^
B@!P(uqE*U%Y[ '$$B
m%eB b
:ϠI Ly BB@!P(
mԇ7c%<T(
B@!P(
yvqns *+pt5\YKy]xCYR2ʾc *,ʤ,el}2E+Sn%y vncnxST>eͷ薷+;CnenVC|u 2Y loަ; w`V'uP(
B@!-A |wkwUn"|S)J/S> Re++F]V^}?&+ Oznl Nӗzx3OZZI&c<K{x7|gDg.eUFn,MցW&dKO_OYe4fz;M_wO *
B@!P(%nO 2bowpJsyϞr"~xKQ:t&cŅt(~zބ\#yY8} <KWd`S{duS{t&;ͻMۗM煣'QPLgg-[e$87\*,\ĉ˸)nMP`¾=p%1ChZpDg[p> 8~b p ^iSaZ?'!;vBrA=3!3*vޏ i+_M8^ Ku}
ـK/>>T=֚ivPg.˸4r(3Ov~;[}.5LQl#qU=gs:zfat<R3TW`ρc0=_1)sǰ)XqO ?N[q^]
B@!P(
Ag MHIIDH(8#>:Y݃5Ԛ;Ht!#I8 G#;#
Go[<C <Mc?`0Hf+0E((gGr{lՇ<Y G*pԸ)._9֭[j*||1alwQլ?*D/YIHs]R='(^3AbOϪgaί B0@W2Ej<Qd}JbJ8M_ka l7!74<3C]nH /~KY k}V@?D|t >*uX3ia~ƪ:*NP҂J[9eڟb
qOXHc,[b'˘XK GV%`tfHȤS Lw\}[Qk[TH{[@Gܽ}[LY×riWLS7
BlkB $IDAT@!P(
ۺ1}s8wb^բl:S< o_x
?-f#R⎠@"Yd5+a Sz僼i&vƒG^Dt zO\E*XhtNh Q"㣜fr
9ȷ8!48J13!=# pr/\]fc-Lxs.i%rvsEˎ]N/, N(,0#95
rc" i0Q
%fĕC^N& $*p@yt=NKYh1h*]P1ނDWǧB&CѹM4z.$)2%d
q[lDA6Y##:ἤ!=-
ήnGp8 !/4@
1+D?t>Mx{S HpaLs? Ƴn Ԇ\\=DgV XL:؉oԣC-:wKdȣw/tv/ | 8ď
yԧv[V')deб^=<<Vo¦>chQ? .d aV\`au77*GÏt LGf _M[>F#<2Xɣ
_?aqC@؈<s r u dOJJ抐GsbQ}=ܜn Ҭ NbQ?D<Q[MH*
B@!P(u}TAJ?D 2#ocl6|ї(p@F k rr |9^H ͺ!Q|05t폷_ {
BM@}6w鎶a#?`F6J=q`l\8 RKϡ[p.w b$"وkL D;کL|QN5xz0v nnw?6.1i(T"2dIů?|e
#۱cbdUl | ge`'. ߃O]ǦLD\жUX'S'ADt,̖ 0nu46Lx<"B:oI/C-"],v7f hjĜey֝Rn_R</ª )xz"Ȝu+!ZpHXh3l!
7[ qCѫss8aφeXG3l۸ :-qN,]Ql݀pN'fb˨^)Y&' (4K G h.x{-냧^x]4`n~Hx Ԏ@!Wsq!9:!y7L0!4hxsػ ?2so#У
^?#q=ϓ =c1Jķ E7PZy"& "^^^ewH:fxjW+j">ȴK'N!0plz|5dOr]FNĄH7vo `$=8g= \ ˧q<!,h POd\ҭGQ1& }S>E=E8k G
L
B@!P(:AD4O$uW8i'<8o ˿F&pzԎ7'cUܾ2,)gЫU7xosP7b )2dg1={;6&5G VN7F23ŨcЯo/lY9z|H\ rm}W9deܙ<f *Gk3C䄉wAO3? O={iPޙ ,C.ڝ_O!>}zWN`xh7 Lcњ]Db/r6ۧ%z M3M:D"7A{hNhѮ Ok#wp0Ӭ;y`6MNJBaHъDYϥch״<w`;\@=A QzSطm/ėDϫЪv /Y[C%Llޥ!~ڻ5ѣ;~etf{VOlzn`w4j m{L6/]?! ǃZq| ワ{`c OL32[w7@Gbwx퍁0]N`2DE>+ ϼ_C
pz<0YW]
S( W ƾQ`*@DL Z>
1G 3סS( ZT %k\Ä#1`@ |(<7yfaHϦZ 00}dԙ+ <i6NGarعb.u+?"Ljo=C\O̘WX {7Dz`WWUd\'lO7#oKp. T?
B@!P(
{;ֈGjк]'9{K;|h8vcغr <C=w~:Uc1w1cj '-
hņWDxұhsf,?bQ^gxh@pp;1dKtI9 u˳MUQEG8bQ_b'ʗ+'[hS|;ޚ0ڵh,^%Zt /0hpHU\yjҎGjGԄ+"7*xw1zxW"u ~cnY^x5/w:dgAi G&<Ahk%ɼpkfW8thV7 D6uqhj| }`A fMYXH4V
+~Ɣ_cԀ.zBW@={ApEŸxwzݶWt1o') F rK@Zz&BcPZU>s.e 9ָg4{*lO7z< x-r?/GGV
FVXzq r:S}r-i$u3&<_< v##%)><F B ?nLMR>ky3a*5k̩S8r0RP'r~7^H^*/B|e\>q=[
OS/к
ZQAK4Ж#degАA"0ax˃K%67QDH8.[iS5n:O4SF6-0w7mh 9w "d"]z]P(
B@!оUVXDd9ߠ<uq3]$*uZ9a6kC"+#ĥfM0+u͜D*1ʹh:ܑhW}- O.yۋ$ Wm
.xBD17τ>!"_Sw!o_Ajj;`kzunETpX( :#/3^! үW@zј\iӈȦ7ɤ IC ;'tH;kPNnnp!-V栥Ҏڙvէ&qo
cu "F c&`ѿ}/L: ocSIq\#;w> -H
?bG>yMԪZŊ QP3aJDD{'r?k7VZ#N70t&<xTfX [\-5;Ov
/npqDrԎ()7N"@؉֏:wWH.ZeN o;mDrײi9iCm TO#VGr2l} *F*-GX<w^xǟÁׅ=fMI1p5)luF4``%"N\@n#֤ˁ ~Qaeσoh9|n 6"Cж ~(nłFPZ `=hXz89 0 %,9)(iQ CN&R0aǦ?ЪKg $U?
B@!P(
{ 5:ӷ<S
ZgO CL͞; MZ
Mqy N6t.bGrޡזrkހ'_at4\Ӥs^^K\rN%bKɮB:""0AtsGNf.Հ[l ;uK%$ o` m[ˉ/n`dN~9ș0+
fŅ[[Qjb#m8gÓۂ-zZaD-B`@d&`Ki?*
d ^rIk;r
T_oL}5jX71GwWĶѣpl~|֭E]N.];Һ}3oh/B-ρwތȽۛKx15͊LT[8ZH -p&B|t)?@3 ª_6؍ډQrZp?qwjFȬر!4LT _7? +ѦWOT{h6s9Pj |i0@b\IњGM'/s*Wj.#{_c^8&lE(?\mrF@1I| /ow&s^<)sv&G?{fh&>A/R?]Dha<;પ3I ְ'H(ZvZK]RXSmu:ZI"e
"V
ȆG~߹<^hjpߙ{Y=~9F~k-*9'^)CN6
dFeROt9{'|2Xl# L'} \Z@?nX4dx2 /L k' c?bLQf }7܋ᓇJYZ (E,;\)I q:T,30Oc91NN~ʺN |_< ^~ xʍ1uo.BvbL#^>>؎w WbD ށw~RKL3 EwüDwAjdD //O 9#I#:M?^Y{t<uZw BG0ԌaCw)SG?}qsF>cg};dpmc;HBn{e҂9!ײaQq{).*dgG-=.[ Ut 潘;EKqߓb9Rq?-g~Ь(_/k6 2|_ vڅZm\sq{&fet5:ſ}$kB21^6* BDHTlo
ĨdB),BGX ^A%1= }g{8ի#sDVcGŸbr |2)[l\Otμ 9o ef.E" gv`; |\y2=OWw
0iTo)-wiq()lr"~2G=)/E#}%Q.0#d^ yq3)(˸V 'kH臙į~;s./B"i
e)pob#{0Ƈm柍 e7PU L/d Vzjχ]elzp>g|U-E <q:,1t@O>, -d\Eo!p&tnnCDDd P,ũj0ww|i VI▯@T|od
yzK]qՕא_5PK q FeeP#aQ4"ITSor,^ /{ q0U 3fS'/6Vc˿
˯c=O1KEn?,+(@^Ƚܕ/ =(VlމN3rs Nl3fl Sl2
-
P Gɘ:nP+exu=rY^,ğx02]n]ƚ=+S 4Z忁M5r2UzԸ| ea >}8e=,_YoNЁCh !}GLa>q*B ^|1z"n },> _D wF u`>cYȉ 8.CGAya\Gl'
≧b˖M((چY6Rci뚌1S/EK
]lO65xeXP5wN.2 _gQ)t8d[ C}xr#'g ;R]iuB&<'
Y/"G wYÚ%ȋ5ذ O>|/MAɡb1c0f0iS=9!3d*/ Js ^+QXpD^rgL X6]7Gϱ9 9z/OcX+ڧ f;v@R̩ oC'ݜHHHHZ@CU*!6?? =z@~mK骡~[C}M\y FsWʬQi 9rT KTY*ECk{^ki GGn2ӱ Dzzۋ'u<IiE :,Oz~ ufc ϲcO5VqHL7EA/j$7!1Q .p
m
.SuYx ##Zu＄ { +^ 1jk5En2ޔ'݅+A1!u̿we}9N-[FZOq.Ljc5g%FFp=RrT&D1v Pϼr@8wv56ke3~=.*ү{{.Vcex,|Jy4\\CXCCGNC_0zeܼ0 Ƚ(/OD+YǪSqS2潓5 Q3w /1Qs
U'O!J ;H ?R"E̓ }W'ͽ(%'W
| ROǣKղ~z/ u\|C|OhBR/8:ɋ(/^ʤwoDF\6i~/}SK/e 7/G?HHHHH:5ǡö-5mZ>DDKAyge"jIL1L[>-{ۖXTǡ[Nd,x^25v ))l>,˓]`ƴ ENzxKӂ˨q.xpItnm1.<v5dPg{cތyYb@9ӂ|R!d[A87.
',ew˺+0a)
ϼ~ۤ]9(dGM6ZkCmٛVz#hQN9Fu:~ḥ6R}ˣi^gZv ʦ~II=2~:,YB $@$@$@$@fǠ{ zӽ2PeZ֖4UӽyotDMMl^y֣۬NZꨨF:R Ȗ4j8cv}ڶ8RY/sעxl=- ,Or%d5gzC|?iħfT2
w}x4 {Cd h#^ňֶtkgNC|zrBiHD( 7p'IS%~ AmCe|Qإcmx8(= MӶ#жgVT#V-|nX|$n;Ss7Ym}ݛkpytia%5\eud`ko\I \Դ^}TTyj1l$ w[ֺ \5.-iҵmn^}Ӽco:u_VVT#ڦvB;F-ӰCjL8T[?xP=Rrh5w 'IU[ZrCȽ>+۫sޤhgOd ,#\J0eϛ-߹lN9 QkT\j+XVSڎI;CƬl=^๑ FY]ްa*d3 Ok p/hm}싌R]Ɠ03y9fE8_uڕ[ĦP
77Kn5S_:Y~i
(B&h~{w^ 2BF$@$@$@$
$tLT:q/3pn5YH e+22L~١C]oWAm & Z-
IHHHHHHKi5H'n y /& ikPg$@$@$@$@g#Ф]+!lO$@$@$@$@$@$@NHf'k7ϒ$@$@$@$@$@$@$@g#d*2HHHHHHHAװv9߱cvڅv1ܽS 7f m %%b8@f f`o IHHHHHH'`
tu'%%=qR$
~ 77 /F@葑nR@zA$@$@$@$@$@$@$Т
qWwLzLa$@$@$B@R Vʒ@@SZ & @cϖIHHHHHH @z HHHHHHH@o=lHHHHHHhPHHHHHHZ
cϖIHHHHHH @z HHHHHHHf
^< IENDB` httpd-2.4.64/docs/manual/images/mod_filter_old.png 0000664 0001751 0001751 00000001342 12272200752 021763 0 ustar covener covener PNG
IHDR 6 I gAMA a cHRM z& u0 ` : pQ< PLTE U~ bKGD H IDATX혽n0|4*2u@${7 >C> cU *ceu4v|n)~;n"E]zZx<tERX3f ZWS6Dfji7^k[) ;nZnXvnz~FWl?r0䠌!Is6 6s/ X5WK*ԳimME5,֦rm툑RiU\~w| JfsJy)f*R/H\`BvAk{ D;f NY *9Uc/c3Qݍ& HXHRr($t+sBw Vh?[C(vrox_Rvx8fziDdat* 99aֳ du/|`2i&`ۑ+d.R7AMs4 %tEXtdate:create 2014-01-21T17:00:03+01:00F %tEXtdate:modify 2011-11-14T13:04:57+01:00$ IENDB` httpd-2.4.64/docs/manual/images/build_a_mod_3.png 0000664 0001751 0001751 00000144061 11740644603 021475 0 ustar covener covener PNG
IHDR W 0M tEXtSoftware Adobe ImageReadyqe< "iTXtXML:com.adobe.xmp <?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?> <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="Adobe XMP Core 5.0-c061 64.140949, 2010/12/07-10:57:01 "> <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> <rdf:Description rdf:about="" xmlns:xmp="http://ns.adobe.com/xap/1.0/" xmlns:xmpMM="http://ns.adobe.com/xap/1.0/mm/" xmlns:stRef="http://ns.adobe.com/xap/1.0/sType/ResourceRef#" xmp:CreatorTool="Adobe Photoshop CS5.1 Windows" xmpMM:InstanceID="xmp.iid:49A5E7D67F2B11E1837E8BE7A41B9359" xmpMM:DocumentID="xmp.did:49A5E7D77F2B11E1837E8BE7A41B9359"> <xmpMM:DerivedFrom stRef:instanceID="xmp.iid:49A5E7D47F2B11E1837E8BE7A41B9359" stRef:documentID="xmp.did:49A5E7D57F2B11E1837E8BE7A41B9359"/> </rdf:Description> </rdf:RDF> </x:xmpmeta> <?xpacket end="r"?>u ĥIDATxVkL U;3.Rж()@b-DCĦ?%@*5mIXS @@ X ]`Р vg\0YIKxrrsι|;.@WZ`#%9`e 1\ js7*h2#(P@?iw4>V+^%ا˲!)A8:;%k )H=7_ʕtzK GWlGYxUamːBev<Xe Z yeb9c]g3LⰞQux%H8T Ӏ26 glP'zTN|g+;GN< rYWTm[gKL3 ectMꌆ<Uiϴ ^&i"q!H@Ҥjnf%cUq{,Oޟ)j~a+XD}NO\GsAA+q{! N"OB&=W_oMKۓr"Qz/A+%WFcekgruqyFL6F;o!iVq 5o @A )_oUNwxWP[b qL Jjt83Aʍ[#kjV !IRʡq '%(د , mǺ* :fPg^ *Yċ
ؗ]!( Rb2O#i'&&+oL
䤃OGT7 栰7 sx
5.[zAp^_^2 ;6q}?uYhtT^RFO%֫+5<4XڝTdya
W=J =Bz{{;:0U 3yL794pQ*XE dsi ۍynLSq@7B SN7mnd ;5tlZ l>gkH随Ơmֶbc00 Y=vwwK . 555AFW15pX,<270sp=LAӲLdKzf8&SAl]TQQO222dk ܗLSWG҂[LFEM$]F?`fK-&F),LBpS@D¬ *Ec0[r^w,}l{-"eOr@.gO`ކ3 P '/$H[2_둟I]j.$fNmb?1p|P"~{d ̋ >/ߋT5]4n-`u!}V^s3ku9yO@ úJ2ɻAɐ!빧iw{J0`#+%Yk JWPD
jB4u嶅BVq?QO@@B:lfev68C{ t>%8C{8>mYpJrU<0{! f_ͅdL28"|tb8z&?AmmaS$ QOa~cV1ڧ
1pKAdVu 3`t
@3ĻM0XȻ ' :Lx]&~0}~t`& E 7;G+ը*OQ,mC/9xaGHR R屖; ya 6DãFd Fj0D }-^<'GwY |/rC^<h#tb566mT<j7= _gM3G,?x~pٲj5&W\UݲtJZR)nL4M&%,AQт`+V*ԵTRi*}`|qsxdS*Kf=l:VT|fxR{!)و8^R?J].6~p5 [f # .?$-=/d`C5EE
nb&`hΟ:9 Rκqf1߿+۵k/IJ9uBwt`=Zx1..!,, äcpWYpLIP/L~ZlmD sLN!ɓV? + aH 8| Y7'9;= <**
Nzs5z~QCt:V]% uԕ# 1 ( XEJ.Zw
(̸vE@\qiU*(+CT ID<H$rssCLvn͜Oɽ?~*)D7 D!%3<4ud}YFcXGah<#L& W< < !D-q 1?$g7feǾ⨈`ќT ('PAH&["?<B!0{{LO@g Gz@/ j%& <.5;-&eA& MN@ |%pYsб\ʗ_i [h5W.8ݍ-ْ[{XxDt~)osfXɓj W)6&\Z# 3SF'dV:#Fs Ut[c:J-ٸ7Ӵom%-G,?n0[ߧMV*150(;eeqi{-~D.JuƖ~g&T;V={yO~ni5U342?Gz: 'Xݗv|t
)`zOa TJX(cJ铻0 TWkVנ_.-? Qd x3͵ ˡRw
(CPU"fOq> hn\F>ڱYgXHJ veŢYG?H5/ٜe"/QS;LF.yp. L `dGXp[V ;A 69tkp<Xz$y-QxgG64u|f7*g ;$^ aljYO>'BS*w*CRx
?q9({XM=Xg/~.`@ T 7 4f[((4|a}Iɻ1^lf[Y tC~&rCȲ
B\!U\) c
}RXkg`
#=̙s45m궑 >{;A< [9HǛ:s
j OjOv'
sx+<*qS :"cOlK)r pɱ}RW T&/I2TŅ-$ 6u+´ꂣHo|♌|/-:_8
vګ8q5fnL#3ScN2 =_d +\LYF^P t:@J:;
4- #/Jq>o" d &^['gKh6bPQr([>LpOШTɧcz J~@ڗ$-PU Ս)IcN57}|A+V /p-U7mڄY@V
"U@ 'p;LזWu˺ĵAAo }ɇ1╴bVEoh6P@ß;'ľCYjM?oڲ/ P.ߕKyzJV54"M@V5wtv
_
NZh<54T9p 軺
(VS$7S2¨1 S5M5 7jkL- )P%i<jrrV>w̌ (wW==D` J5H
Ayy/yXG#l!Y m*6Ȉ\.EC(Î,)z|lz*0"wHaA| 9'0& dٳN
&Pip{[ϵAH<:> '0&LðAJfLL&ـ%Ȥ\ 7(NEaӝ\.ݝN7/hbc `Ry
F}['$Ynjjt:'t؉b[ ɞ ~slo%`Q ۺgaaD6AnqAI%DsŨ%Ds5q *&и>"DYaPfXdW=EMLr믧):uM俬<>rJVYfUݾ- e>F|[`bXe# @*q,' BN ^ec|In'؍0^a# JNZhO nK+_Fzڈ8:}JD*y
C-@+dPKƏ,Xm Tf*@xAJl[`fɩ#GO&ٲ ]fBג#G:Ss߯O#1@Qj #q1oPd7lO{hJ-~@ bk}J,n禔KZ2l}NƙTWn`u[ $# /CnA\̛x <r
NJ#\/Q tþ ( <{ieʙGmR*nqc\
7"nam|hpFR:l)I7{k fI<'76w ٳ~+P x dMwm Jch{?{vvKǁd`h"?td 9*0u `rL .0lYtew};" }
g,8E3l_aQT
كJS=+*q=e+:I`W( FJRt"y;{j{!8ml]}n,XC\楫.=j&@_+$\;jx~ ,+PˉX3}+%, |[ -`FXq <?cLF 2 lʫP"J
A1 5's\qc
PMݘaSFNAvNw=>j-/<\|Zݞu: R ϼsvf_Ft[?eE&.Ƽ<UQcjDHh%OڔHPK3IcE%$hQ wҧ=٩ݪ'<[1Eꦛ g,<?Bѝn)1k_1i.]ΜjJ
? i o>0
g CKyKOCQjtJ
u u\tjP#H%Y,-,R,s)M
э]l49iiA cImSѕdP4APA(0S,l /D9k/y,@k
.{z,Vuw9QBs^, ä$B"/E}>,/cPJ &@Qz6c(15̝v{E2~+# /Q;NAz)eA頻ӧuÜLb곝>;)7 oG]QN^>Ga[]ۼKx+n~RZ]lC"\z3 Lhl=)T 2 P>MPS7HDSݽ <RwH'50&!۰1m .%4Rh WOZ,$iKVUB,3}ݿK =,(Ti,Zyko=a##n$w%G@;X4n g'gDOI'Oa[WRLE1ȋ?\9qɓҘ¾=.kF%|m/tگeCqgsl G(n?fa \+3&.,a͚9CRY#("X!մ?ฮ 82vr% L;LMT*յk?. ڤ6664FbXxOӉpaCwMRE|m^Jv,،k 7A6@J ܝ\pn[S=J2ÉO7X,&h h 8ZA ;m%(U<G/OQc(֖*{ 택giԏ Oqf E)Ơ<>Q1f+q'Lzxؐ(͢~nn?Lѿ1 F@+p5gS$fvPK-tt4m߄.1S8NJQf[V'b ,҃t:Ȇ#555%^
jX,8x`'Vj§<'N 9ӹ<3T L(-9 T{0, uu 6{wo4Ăx&[,Z 5RˊJf9
! f ?~a|~6pNx~mm|8/]&XR(\Wy*a.Rkt,&yR֚֡='"5gM37nakk7Ro_ 99<o`ƌ JuYyUeysq8y:';;;AUUU0k+31Fb
3&^Hzaqfg:*Dz*b˾ Nw E6\ Z&; Iqk Y~Liэ!!?D;\P^\qv1$-=7$4H!].\0 PMn\f(xyy 8]xa4N ߡӨ< M\h谏rO,&I v-_t$qaZ1hTTTM0xιW+sy'/Km 9p>[`A}Q+wƌ3E
&{!0p:܍ fp^,,\u{
B,WTT<z`E4us bۚōM9@ a0.Tłt4q]xg,ZBxߢ6Y.({bJF-xӮ^ L
V C 326m{\",=% 3P7dȐ^u?Z.==8,iu{$Y`s#U`* Sz!l=7| x[w
p~8-IIUo,`{ >F-"P=kڑdg 1]ccEEHS/\yR oP(r!./@1uCxlkq-x F -;Ar@=8J 58ꀃiR[YYxHO_bpkf :3p#49}07j}J[NTG :}eƏC $vZVfv]CM[Z rPPh1qK88ɉf#20&.GܫЦ\\\DL\I
q'Or6$>>/,,&qCYEW}Ue(+4j/:Z3F ޞd,3ݟ:D N\_0$$/U
gk988 AsuuZ
Ha2P"q0\ ֦_Z9 _h֊QmErJʙ ٳĆLHN~5 0
S ێ ;e2٥_#"Ѡ*@7| ?<D BQZZh@
<S⚞k|Ba@6(j]։-κ(j[K(mG]⨊pE6a$$ Vq$>y{6o\y~юL)cBǾ
os;r@wt ɳK`eQy7& k탺\mhSf/X 3poAy%)n,L PxV7u_"<س/P3$0><wP}q}8ZjPQ/h)(I鬅 ȹ*}[[ @Jaj<
Gw -6G .^5wR owtNVѱ-ǰPh!-5y4z3 4b(婓_)%<۠wyڗdɚ " <sBB::UpIJ4oȃ4iƄ !a}ՋyfȰ7 >jPiP "
Y%O%ئLW(\ .08it!A363 Oߠ)$=[<!6@TɶOnX3룍 w@\+Y=B4uGEZlȊu"xE9zmAԱw㑴T
@`3uSb|Ezz>k`zV%aHϏo츱,& [WO
_EֽW\ڱ˛{56G{CQHy<chRLkjpP'GYF&Ւ͖bM(u@ Z5:0Dbj3<J{[mcPtߩ( )'Ӗ*($Nq5<<( ur
}!ݕtV?RznWրcgkJ%־IK'ӷgB[ ;}, ]UG88>mc" A?- Er~@bYkȷEw_\!]נ)Cg& rƠ g W.GQZYXAP]SRРY?'Ǥg_V[)oE[5Os[Z-+ ' Ci{wS5R:s|މk]m9`oǩ}d7ÄmR?yR7hjUo@WY ,7 M-L5k#dC>3&ciAGZ\R|`*2*x
630-u߆s4)v!hV0Ԋ+0[@9,< \˭'E8Ǯ#8DĝGF>"7gޯпe#5OۚI4
@+M;f"|?=tqUia
z-Cn(fJ(*ݦOZ ,Cڏ܈E/PVoӝP kah#Oh R<se0;|n'? gڕwVI{wT(7+ uGFQ鵡ISWd6CחW6ES_o lQ0:0 + }Ah3uVhXyS?3|bb Cp{!T
) >G>=[nΧYVal.:Bgݵ߄LZw't5wu WW\ۣ&Ji}ĽSz h ')
q p 3S 0pKI%NB.nBj^B $)S5 {z}Ƅ j 2R v dO8;kd,ۧ(]&Na 4@ nl
`(qB$-ω*{r{E^ ǡcl[_ Ͷ an[R @ ݾ=sf#b cM;1WMV8Nh4 >i)K8r,6FpL:xJi1w}TJ릯ꂠ $_72ǖv\ 9w T9
MlHzp2Ajb֯o 8
_
kg]1Ü і .Q" }"t` @@SPG85w<I>q
*Q-h;
>A, "~1) @lVG@ 55LAG-ˋY4u:<,ae5RTlM,z[Ix8v2\C9PTGN Ш?wxyQYo5[hWԎf/=6&ꗘC <x\-SVFݤi)ͻH+GǚR
6f9~wOq-2S]Y_WQecg^S)JJ,T}e w nYe߯<+]E5E%3j5; vZ:kj UèVYY>^WFm8#˒<V-6xabl>LS/okתN_2Kc4iξm>tVZ[[vƹ7Ί( ۙ :-=R% ==Ч{U5`]䁑F
|SK3yn{67?J*۷8طr PTT":bXHh5 oV]'=7q=q _DחX}Gݧ r^4l,VK- :֭Ԡ VՕ_j^x?ʆj)
?U^VQx1];~zϊ;nVѫ#E/4ܷݚuVZ[hC.l> BvQбOJ33C ( Q #1L] 2Y |A
Qh\ ƛ q}EWB#SyƪtsʴTe^ @P xXd$C>!CKS*zzvar;u
6rEX˂P3+M0'd-b̞ԭ+w.LU`j:1NvW0Q e8YyϝjpR^RY "gS겫L@冮^a̎DMWl n.AGn,~/*,,*/|i+E&}%Ӧ.psBm<ga.zqz%( 4/GY&J\F"y>]ҋ!cjлzHj r ܪ=1[M`V]+)t3*4p !fd9b@/.\ A0f0=ߢt-+ ߌt"|f .wE[? J\=k{)+EG"J|?ɴM 4 [~) K*6ŭB,ֆ0Nb }=(Knsvu ܯV ّ"_THu
Fgϧ `ŋI;Y kw^g.NKϥ&2-CNjcXV y?ZblõgZu(y>s}42<
h$qbziR$B䇓?-
mBRP{w^=߫4,-t.!XSD4 *aԿ n&-6w3R } bt[y`|Q=с
00'fL>#N碷,>IF XΰYׅ!KQ|'iG-
0bRءzRkmLb҈ٮ\\3kW4U`ઓ'$Q 'g1tܕvl6oZ w`} , k[fw默ݭ
h`
v=`X]lZ\ T}ϐ>ͳ" @\*-6-3KRiMMM- {tYFB_4EP [x+dlr[uPΧ %= nCΞW^^=}CW
8(A15w>1##ӮעZ\G_%m}H <^D,-,.wq>>j #]H6e laÖw`c 1VdLR52" k?ﰀZ1\֑:::S{xJ"HuvԨICNU81{VhQq˩L<@Qw;KrOz &LRiGG>y2~B@# nπT^.wg`W[[k; KC"Փ99.^v$`Þ7d?U&̚` w \}CC9<G;ԫ@W u[xh X\PPlb 87(X7zFJKlH侾+'ض2d耏gt`O5srA<|6{c_3oWL׳J A^`
G >}ӎVN[[ g
EKgQBeo@/'>C^PfXfb'5a܈ZZPT 岺sVWffۡ@nX \Xx.5I3/7ǷJ%}u 2,iJu ;UC|njMs (/wp`
vYr5jm/Zc W.Ϛk
5p҂{
}ۺNf*uBSqFE#k,<Q :Ť WJ+H5q=N 73Z-icn2:ӄ m HYz!!B9Z1<I35KXR7sƒ? <vڙ=:yt
%Q5X"+.*zP .d)6nxeE;"&"D
3?JbINt}Jy94`t1c?fJY
ʊ~VA\iRcP(/xђ- [ gzF6c.Zq%E%e
2|Y$Hrҩ@i,zN/
Tj ȻOGtpIBm {w虝J p
={QD.]`GL F1 w3?BQe.
o8~zUUMtUM]%g?I:`Ҥ`N$"c?Y\t0 `̢Eb⫪)B
iÆ%X
ɣTgtN0LOݳu/G Xu[aa A{2])8^1vP
<VZy7G}_ʄ uEfdybܒOU7vtǷ=Á^|jt<I3bK?W faܸcF>/]r5e`@ o_z͛M tJ]$
϶bh gWA 660[XXp8 @ H'hQ 4̜9fݧ
`zS=A 4U32k9॰ BP b0QUU]*az{k0b8+]dz/i5x*x+ ;`O_8k oMOZU䎮։7hإK'ԶHT~juU? >bflط/ɟ. ))OŅ u 9u#G{y9 ܿatnmӪF?&,-\Kohm|[k ffff F033K]e2 > F fX<}#G / mM| 6 zﴰI
v774-1{ H{gvƞ8KK^zLuWb |8zcO͙ /+PZWW}3>**OZ4I_KQ &"*[_i17G6Ah?#@o) V [juBBjHH 4a,H}}=혊ee55U FCop - |2ۿҽ{ճkIlBd=_/'v/ xYLV n溪I)R.HZrOOzY`4 Moѵ#ZAn@ \j] udiLL&kRi-h9
m GPS)HJ Ҳ¯Gɞ'WjΜ>bsi]LT.SdgWJ-11Oq o&[H322:uwu"ʠ Ze0@R)n> q)Cd@27\CGT"TFziVVR(p711^'EwGS4=|VflR)Oݻw ~}tR 5|i~F<[t EbJa8F~c#ӜMMMMݑ+j5БG,:7 j*>ij
8Ӆ dʊoccl+c%C_ ˚`:8^JG
6&jb;;V T@rz w~Ehݲμ3; o͌/X!ʥ9' Q/f 𭅙6VX\d/WW^uxմY+௲Ŷj~g{ݔi@ [lwk6v|¶z) F@mu߱:߽ -
}pР 0_j{l&ʑ5":1jqNJ6 lo JlM|.9k4@\Qs?JYmĢNFT0<)<9)-6)3a) ᡶ{egۙid4+O4%v{wl5j@HHHt Ʌt'T9
+gޭszcԂ?+]߯-igg EHM?2!Ó/ǫ8qi٬Wf]C5רjuRpKSu;z{|RaYjԥo8d\Nppe1aw%HUտE,R]6Ĝ42xXbL&k@Rb V-k 8>~]ݑO覗un8LFk (zArNNnAw$IoYIUnԽnUI\keˇ#i>Jſ%``
Yah v]\ˮU=)?(y -.V'c}߳etb\߀apuٽjƵiR*++iE
q)U2q
@[[VVV"9!LUsa\VJr4uHE ?D?#9#n38P+@`<z IΠN+_v(%Pf 8^/0pkPo#
DIZ[Zcu
**,I0H$0O
[B6iƸٮԞ&/JͰ3% iRFe~>nDPⁿm# MWp ğu U5|j4F;Y3ٝlI '4p v,V &d25:^ӣ jň"=f"> ap%P`* v Sa_G%ԃnmV;Le"1S2JI"H T '
ZWR. IE8iaOwݝ: ( yO^7<RYk \5 :֬A<З"E\+zݦX:bsJs?EY
$_.= <@LNK@I]/y!٩
b0G}b3Dq(gu;݈2}-8Z4Z+I74Jj VDD(xSOvHCGպ!fk C'k3w0SQT
0(|
DJj%+nP*xB <ԔULTJד`f!,uh)*ifHEdˈ<=G0l ?u a_w="B
k> ':-E zsM ?μ>Q3GB^{g]zc.LMKN%l6tFIJ3e5d M:hUm6B>s04̄{}|øOY]Ym0PUy7 VqถĂS4_Z;E/P ' Te'{Sh\ ywTNzA7.j@) ^ ^ hfȄi÷`*l@v 39[%Wf}.A/P0Vx̮eyΝe2'n Kҟ=q ]}`̌= ?j{;@Vǡ-\o36[}crM kZ{*̀
M?1}MUtzೊwA
ivwy/
? &j yӍsA
DrƸ ǿ$oz+چlHyrp&O4bJ o&7l~}zFy5$de 6ަ_̀h$%cB` ,=g ڤ]2%I1qQnMU$b0&0-x9Iq٢I37YO^܁qFk߬oBЄ0fv z{'x߬k X9Yy$|vF,G:-ru<dpU4Y?~JIjaf"Yt2~
ƝPE \BeY.Un[<|e4,QF'jCzM"Vh"`ղK R)}rj17 *7p/@N|>zvʦN˭X yҘeB 'd ,u(y%@ Y0i;# I*0VVHZ6z%0ڷ}\, pYTT`R ȕR 6^TΘȞqX|g:fOϧ.>-5"%U
@5φ^fmޔn,~QVx/&*'@ӯ!,&Ѫs8Ԓ劊xF;2:~a8=Z.~ן@npf#(4BU$' Z "M[dw^pd\OJHS.4ڏ]3GYhu߶qq8X35Tb&"<}VGfX.-:7i%& w^}0aaRQwNhl=8jR &kdX؟рe?̛9~l9v
TKZ(=G}Npji/ʠ [>onGkoDۮ<m+S^尺3@m[ ȵP +O۸J\%t5s@w% z3 :%b~ߌ2Riweh$a͖oJp\wHJηp1CZ5lN i4J% Rd4m^0~-&9zuM7+zkLaq aԭ @৷-̓ :
002}ЁMCw
P*QJ61| =NaQPQ @XmP J8cerMor$z hi#$x9O@m i!b(AI6 pg+LBIXVmx w
eer |{+-MθjB5u߬ek1I yI60/+
qlu:c (Ӟrէj j|d`TS1`bȎǶ>5J^J*y<8]]3j܋ PavvT
Úf:IZ /^|Y[2 4s=f2`02cra\<y_ȑ^C]MKH&>,q
uu;
>v욙.D_XU *X,k` b4Ng`9(4f*ͭ5ܐy0у\_BR߬8i=8,a+"lfoRV֤ ;
1р^=4)u45'd {ׅ>+JN>[/WW:TES]_2kf`xmdxV:Z 8on <E7;-y~xϩwԡ"2k3P^%_WJ15&wӧ z ~ cfXZV ka >t,bw M. z `Ioos嬢Wg\DqꌁFSˬE0$ԩ& Z~4F&YIW
Pl.̘Kw` %G h4_a言y^+̨%5!P|UWWI%*6:2Z qfqh 5 DdeYz{M 8T 5![.:El6&&: egL>[U&nEb:daF =EI &Sٴ .R WqZrι~
w'TS)+~Fʏ eN}}:6`J<[z
&%=̵Q!u
| q knPp-CQL_efl(w`,:èBЀjAۼL??/L F1 ڂ" )>!-I% ۹]+ӏT$m&z` <ܰ)#~f4Հ$3O6"Cݪ>k$c"s7%K^Ƅ%eP=Ujܝ'GX<y<. ~5v^8qq-11ML\ t/!1sfA<vCY)PȣCFE.o2蒮o"eoeW6dѧT Yцo_G:8tUR@nt[P}KW UGKɯVLT 8o!W^+*)/<3(̅|R ؏o f$i6iy SKee0fE0KRfhh0ikWOWRmLvl_f3d(; S\&_J)mFו4 a4J'442 jک0uٻsykjf18 T wdK!ȝdb$ETeo"ש>#Y0u@m3CǑ7Ϩ(2vrΪ]; bjL4랈=q8 ;.ؑC={tYt;'E9%gC/QdNl >yQ#Aѱ3)@VCGlBL
͇ҪO [?
\ AI T ؽ{/^iv .)Н 3m|} c+J2ru?s/ :d"F\ E{yxxka5RFeoFs47?c ֭{Nh
o&LP//\e?jp,[P! ˲n3Pyk 3 ;bG0pڸP\,&:F%xV*PQ@xjRtBca7f~# }d3 71=3Y7qʮ@?C`9oc1 b
C'pUI'\& (s
wӉ* _~ b(. `<ZVVXV;,4 b:MژY(CuM5Jr 2e, ɣ>JOɪw X?|zxرLrrr8
?}a&v5hzN\-) 8kQq g c"?O6B.g}y
ļٳN#͍._ /9{Β=h@F 5~wg<<>g%qJ4<DK; wܷV6=n-~ <en=3e&S毙"sE'nên]ֻKԅCoL}~Ď{n c^%Be /Nm=8&mCu/#Cu qJ~)l- gz#z #!LJd&,Aql
E4GOٷU$cR깑:y:yI I!3If ۹ ^|lbbпBMvv^eE13SڱC={ޝ{9#RLc8s3a;W brگTdt }Z+P8ft7<t\-YW?
9q~FV" T )rkNMs j'61TWsv&$ް^qoGIz i!)&cz*9``. -`U XL+nq< wztr5t0ͿP E}
e6OYQ5Lo - LVB-d X,kk p2f5
Y$'z >r:*ꞅYzfo`ll6RtZ ""~YZ 'd+]֒T,;[/8ZlrE|!77;G]ıHW.!lk_[ lRQ ~s'u!Mc(+gXGѩ p`Xt}UEWVvan -
O/ 8PFz GI: Uq=ztR&;q1дn=4e[9&B:Nrtf uA!G본=@qJ#hMWWXHӧL@m mRtt|nz`em6hP^::m[9s&{yam(V%TLehGa<Y>橾ƦC~8 .%XJ)3am( b
C iW0f2`^=Z1|K UE^0A*u<F\H8tP]$oef 34Tp++K*_T[I&Pe+^F2,6J"t69BLNde7 akZ s[G38*i*ZUqOI 6jOf$F oyNNNVVVjjڵ!H X,6w8v~cc+tOL,jʔq 3[* S 5Y''M2~QPJ\HBFԦll]1&]] uAmK*k'LӶ Կl*a^kP,C%DlƠN5X-&?mݯKWgTue:yo}ֿ_St <!9K,nq Ţ,f~״KuXclVk`4w ܼRL⪪*aa(7A72V
Iaj'Vgmm~r#)x<'6-Tdg<#A-MΝ<'N8(pߞ7oݿ{|==Ҳ
9-=τ+(+-nJCCv J%M E٪䔴 Qw:8Y J\[[,x.4hgOz*ɓȴ шQ3"^5 [M&E-`જiĔV0 C< +GЕJ%0"#:j{/,6jck߷o͕btڴӦ3n( 'ďCbb83믻Ξo`LqETT:
6zk"HD5hCPK=Ye٢Q &N&uRo KI[Q.hc
>w>}JiI2i{&>$%%IBX$+|N@ 4m0E+++i%
ب y9+&]U)=wWg.8wk ~͏}ۯwɮgN :g0/ʉ o'1YLjNxކS ;\q
+2Ma0 vI_s~
g0lB&2mњ_]}Yv68`ED0n8 }g
Nrs
s ;wx'Yjyy#G/z*n#qww!=
rq,)ʟ6m٭TW {vֹ+Woϟ?LC(j $U2d2[-{0Ls9Ժ1x"V&=ȕndo^H$k[[+O^'`a?̛fhR.6!:&k7vL`>?z;Gr~BQ`htWgg Y=ȭb8 pw%kiP i[VVkˀsZѯ_M6.>mSW<6nظo L1R`)(ׂ Fpe?;G?0#q\_UX\r4U$]] z<G"%ۼgq(\1~IJCLt, KH7ϜeTQ",`յ];3
>y-!0
ML 9|~qA) &>;(0l(LpL$OO͘> X,7~̖#\Q(tπ=}7Ԅpp#p)
_.i[eaҐ=sU(Y/ T ,%ET Fsyhɶ]+2" rnXæ+~vݏ\Ub}=/,+;㺹:/qn.-p Tʙ F9]# If u!y+sK|] HC-a/~ ڹY&%I-t߮S* ==#Gp9!aK뾟56-.|ݧ!Cz/^8M*@^Guθf.ff<F )?%$FDއa='BF y3 0,= "/m) 3נ9
B~1qCF*Ii^v >{wTR%uc {tR tư,\8Μ)zF6nۻg
Jƍq>++Q< Uo^^{懨!:sb5 WT)U*.ik>w/wC aܺDG7hI>0++e-]{3^;BMmO ^] =zgR WTv$ V*{p=fefJ!4J%.Tp~{``/vag{ 046.9==)= RZ 4k1w7W55WvEm2(Ļ>8O EEps5ѣV
*d=;XlT
`wްiKо=[_s$6Wv>c'nkaEM.c)N ]=CƎjllu^j yV!5Ujj+x5=}Ad&ܺWOo<V6< ]ں؉b`X5?ߘH*]o :)0`ȵ PIaŕ֓fr .k 1(@kbSؗhj ` +K]TY 7o:fo˻,U|(}W. B7*{p 4Se!1*73 ߳Coz:5 +'_=\ PS#k W0
O\dٶ=:{{y Ѽc۴Ԥ ;COuncc>Q..vD 02EiYixxlA!hQ &PB
C
@UX\uҁvgTPv&;"`OJ$ha*T14Ҭ ((ˤ۱G7ZZ[lPl<6jqDHdhv|-m!!B>p w_;} |tߵs߲"0鋚=<z~umS.{'S y9n⒒Co[|֖֭&V&$%J) @?\AϞ mjkV),.*,obL
,m&L K1rpk$ H𡠠0''Ȉӿ_[K
>$(*(\]'
r|#_M3N]FDMXR62X&LGp+#~ ۍhfC~Z*3_lՃG/^㏇/ ֲ躁,)yMJ " =SWupKO !G5ݘU"?%/Ok <K0g͜ &(TVci'{ 4 q Qɀ=߭M
*ZTTQ{w[M-:`XEel>}e~^9ćX̓AG=Q]~|lԅZ2Qhl\aq;l~zqw..-;{ũS; <9鞍1xirGSI!`L$..뜲2=iH:먎 ]]Iicdc˖PUs J J/ǷT?
UX:TI ;xZ 6D@0df<ɡuyHjY_J̯u F8gя!IUY A H?SPX2f'IE9ӾI&i < w~ MjhX5FD-E9\FuP̘N3 &:%%%-5aN0HB!-Za3RKAAc)̮ _!t0LЪ0-A'oKPu5Yg ~5L`6g屣jj~yxvû ssc67 D]@upݿ< {鮝?=~v"LPkm%*( i.:Oᦧ ѯ_G{zjySNȾGPd=Ff=3xfH 0 b֖~,ydg ^5I.g?DvSԓ0\bް߆3f ${~SD:.]<'H$7+W|*"s'pޒs {KO MMM o-53 lWHKK۳wyz2SjHvq'1'J!#K_ _( ?_ɓ+1 W*֙A@HpI͝^'Wju!]T h=H4 Am
C% <tUA&9+PR Lw##RS+פ6 <6L`*+++*:M.LxȀQTY9B҃@
h
tR
iiY\woSc-2 J
~*=c(*5T+x#'Y! ,x6])A訨9s},z _VhFJU:LTiŏ WWLLtiNe id b3w!s5&ILX&{k>t^)=Z*Ciitt֦fY~TJG99+((Qƛ Zр| [- =f U-YllnuɄbKԅ&&&ZZtA
/42~fN?M1p@vg =G.~VVVB
/kXBErjki[YYZXX Ƴ,5^im?<!8hy'ogj3(+SIFiR_~n 5 80!55-%%~toiB ԇ )y0 $ln4@$mnnTA" 3H:SLҲ* $@MH֗%B+ S*b0a` ^GDG8 .Zu |)2`$:ǎŸkzDUmLVRrNtL 6P7f,S?bb1 $Dc0HԹ+.%UbCC`aݧDq1 t1m`ANT+'''SSS'SV0NgdL}=:H
V8(QUZZ 7u`_%[8 ***D"QaaX,f hp01
LS 9/WTSMޓ: W23,ݭt7/A1BAr }nu u;0H5 |rrѫWYJssS:v<}NXUmk`Bdeeŧ%Y B[i <
?ӀVo(WVVҫy^|br?
wotbQE%vη ]XWמ}aYXX:" "`kb1{=c/.*(H,lߝߙ5KsYvgܹ={~]}_)UtR2k 1Hhn.8_QvSk
wn'?? &r1f@TĊKAxdh[xiZj!h_Qd+.Q9ZKN6u`(Oe[͢V 6_
x7d?]:@͕(Z( p֦Mk~E _"e(iͣ;X&(0@jay߾%&_;N!H~RXWU Nv*_^kE-i*f
Oy 8P^]GȬ_+
| *@9vv}*;(bJKF }Ea3yyzF̬G+Xypl|^ 0 '$e]9KkB\]C_ %
TxU'Ӏ.֖(ɛF ~s:<)Ls<.Q:i(͡X5 B!RYt?ydpPWF 7SQTࢲ\ʄ]9)F )t0l^Gf#53b*NUnd#qV `X(
H۷w%+.\=[+LT˺e߂
S0PF -8Vf
7p?"F,)-MIO7J~ )PXm'pP.Ne\hj?xX(T b:rmmFf7JۓJBHDa*X0rj . WC S!uS8&`Iݡg OLfz99nV&R2Xubh`R@5%z[{>bN)EUvEĂ66i`*䅋o>ۯWg`;EDV`gF12/׆^ mmR_(wrF]xC}ln$EŜf|YpK菷꿃 0fyeSxXF X[ϡi'O
Uh|Hu}_Gԋ"sL`R^cGG招W Y-˅Q=z ֪]'81|a hM7YxNH UK]~X(R ^ufk#_Am =˜4C)CT+U̿chӨ
MDT ]N+*eؿ& 3:7[nDDł
H6oާEdE(1 4ʐ~ٝTԦq \Se v
ծu@ãg
aĥHzW=B:R9f
m ` '_=;=D1UyiЪsS!z-00=L4t>
?%~U9 ˜څs%>Ai&) G;V(Jݽs'!g9Qr6-`sfxaMVX$i2rUqp+\ 0̟
^ƕAamr {r^fmX^a'8SOP4M>PkY&H\cr.? "$]=1~&(#
SoA}/C.dk%iJlZFnyt;bB -<m9\/{z ӠF
_$]&5M Ab(l87ri ( ]L0t8#<2>?r
Q#
,jmuOYrVS,$Z_KYd'C2"/_F<P7P ԠE])x_U+ !0qSm4% (N@qG GBWbZ
@P%,d2 TTEfue@q#1\NhM'1{* OMV,Uj (3Ǫbs!.YB`b)Qi0PIgٶ`9m:܃aD}| BYL(E#'+3V D\u+u>jY'wPn֒(`ry7n_<BP"+y6VSaD,RME|@`1Iqti啝f8B0(XB*`)g0b9ZݖEWH|GΌ &kew0٢ضYM1ϟ^{>j0]'o
U|H|*,1]FQԅ$p>ƥ) iԗ/$, `D 1T??
: uE"użf. sf^BI&Ǯn1GW u/#50TEӈ` lQ ؤZyKNZNMO~97E`ȴJJΧI$"Y&T4=~vn!Ьc1jb"E8g;3u[Ժa?O1FKs[Q[q 簧.NѰXF(P~}]2qG~8_&sՊW*
ʭꘕ 8~Gj۪Tv ^k\ qZ }*Tc+s(@@nl#Tgau0TFX'"3J| O-x` Ѥ>f+(gܵ?P-8mxX.e\^*:
n LDz| $WSɁ~K-ڭ.o9'AݝzM q9 W LfoQVTD4'qa/C|&aҽ(
02x YRq`I$Ǚ u p 1BÙ'^uqI]zF8;,v& c 3-O9G~c,059-DV\:ֱi" ^
Z>?z;AG BőCarNAwx j z3VzAGE
M Q~5P%y9deGwN9 r M(K=N`^^"T.Z^ȋٗ8mQ{ZKPcAkMJITQCl, X&uУ+ u[81Mnﴵ5c Pz4d[Vnme J2o+w]y\ =qja\_ޮaP+ F".HN})! O
ZF_#D\R6*nL_lAP
pсc4* rb?/E4s,*.qV~ XVݥ[l>pg
05G"uS V<]ga2m ʹ`Mq4{FQLaSa w `Z{o#a
R`h5(n5Lx#d kE
y.IQ3hPUlhVSLf
eQ$MJҔ4YV 6w D'gQg4{ ]8ͽI[α03*떝v\xi\(BK.Vz8/7SƵkQ'.<iPd [;w{
_k +"#s nFxʨyL E\o[wg {oP{^D9#ajtSF^F跥!U FQ+#_^KˊjN# NV\ oh$.u]mϠ ~"Ҕ_S(F67ʃ-]{ gλYS{fQ8b;ڨL9eG苹b+MpiV&ݾ+Mڙ1QW~.̫(ߜ2~ 4/|0?r!.9dBRFܽQpUEE.b",$n}@ D0zQHUi1ݏ*F^ͽ_+ ;rW 0W !Yl" {Ј@
o0 j7JJ JJo?G(0^\W6eǧ>sul0l'\4;IL4 ۷ @! <LHct@x_;Q h ~Ю#Mhy ;5wK^3I_;bϢgs sS\Iluu
|fׂ)ִk=pp&bVϖ2Q9_(oȄIȮf ωN^w @0ݨIW - /9 \+?7AlG rreem;7=I<'}=;m ou&Oy"{Q_9 4o Cg#⤣ܳO{-Py[N58i&#aXwna
sH!]{ K["h' * äL#\_ć!3A:
_=`P} ~˭qo&V\ zcR\ O:=h\'q =5\k> 6/XQL=g^iN np}42o%
0R 7o,"Fq
qSoA*@maO,(
Ea6Al(`Zə
eeD8vH^5\x bq 3anBUV e005 @S`8\Hߴm>Pjn .ս!_ jOKOs=~_yČ)=w]~[O]Y+&)@иPb`0
P`MiN̰bEtB eQʨ45*#A Q!^ D .ZEo1jT̈=8Vhc̘^1}Ado@M8 ɿHܩRAi`P Rmy6vꌜC%UtjԚ48`<xJ浇4݂`"]ѣ3T7M>\`DhҮn)Hh>ak 摂oP_Ҿ{;9b{[82f(RRd4#'57?$ vMWG V3m };Oq{cP )R_ 09_qw7IS(:x_@8rǫ]s02:=-
sd IE aXiCzm yO,}ܓ6 ^dv}IE8;pCێ ̴ M|ܞ-zx&e6bSʰ Ŧ[nPgCNV%o6]3s.Nmxң]O)q2?dD\~K< W i.Xy>ݧ ~n9yƽvmqx2Gcg?Fz/_fQEB
lhJ "a&6M [0;+?Ϫ݆(uU"F?Z,S4q?a.̔sR H]~.3e-R sLaHߩ
X:oWb1+MĂo ؛ĄΝd $Ef {ujby٩c"3SUR^|;"7_~L``5nա
C5# @A ? _bU^n;YPAQ6CLʊ$R @Ӑ2y4e
$H#۱9]^=գ 5@i wMXhֈ?l jIkcLz &I@5o 2oš^G4:hi
/۷Llv"D.ꙥ?.ވyjɖ;ת O䟘6oLd ִ?>_2M q ''t 4b)) /xt6Col4 (9~!`4d{.i# cy#MZiNذxخA9u
" < ox%2fDĭ/~* (גcɏ.ϯCq̜P:PMS4F[EpCUl0ލlP@Pg,>>nVI+JOӁ=1ϋ0%%ǼJIJԀ#a s>oG\x }Av ZiwO߶gWo }R!~_P 'TiJߜP9 9&G`RS
/]eG3 ōvZfb3rEU,vZ=bx1eH@r%SN) }Y#~b 0N"`", v Lə` IF1D8Q#r7Xbm@4 Uhά>Y
6=r. k8XĀ,|9V 9sQ ܗQXVv #5p< e}E @UdM:D<8fcx0d; E6͝{Z_+|P NWHvP52' k}(B
F9,w8}0Nhgw*P=B1 YŐ0VI%Ծ쯢)M03 n[ޝQ Z5j$IN,,{8-31;/0п;qa[T} @% G
Y*< WTXLe" 1kM~}F
U ˛7%A& cfŢȫ߾+7rdO.98873L7n9rөր64 ҁɋs FY'Jt ucE1]I&?I >̃^ /KՄH`ؿέ$4D8Qg4o7itr
v]"sgb5XE'Lzk S&.065ǽ ;|f8t`Ln[nEO1ޅoݚ/V[pm-R `f E8NH]A9wp$&v V˛g\ ̈)<XBD
8+2
PةU}~ 4Y#Wæ(hی vr4P D 55ƍkCwry܍6ZIOLLL-S* e6d`
zEːMyd鏣<b aWaAP;/r|+0 GZF أ£z2YC4i$(MC @qr" 'Pif:n_vs<5<?/[C7YA `8]MBf "Wq ߘ^
v&`(1)8 8.{ P(rHeQ=y>lР:%ft'^!xu| fѤVW@[ FZ1.r@9(Z=fWDĵ ~Wj?G,<Sb2<&>qdwHj/K=}g[;Onj, {^h \>JٳZx;^:
;_Jdt2F*9RYF2H]Hhл:zmZ|!+7yѹ\gIpμ_wMÁ?_~䟧ָ8xM K.] <q0{ Fx ׳0<zfWleeA)F(}IRN(qe 9Aq
ݽs?o%qؗ-,
" 4H efhR U|@MnWژ+
&vm}0gUICOKEyG+*aR
(ǂg\W IhVSt؋oP^Ύ # ƍ[]ҾC m*M aH5h`&e FFQZ(!%6-+)eуl5+I>_X}DHֲQGg ;da` ?ӫMZ$$r/v '?eۡE"ٰ?=xz%-+^V* XګO7kz>Vet} [GHBMӷr0v iB""^8ْeivX hf&vTjiwRȢ%>x~תUә'ՅI+;@gNg8x{ԡ;r$$
*&'ضQg]jyNi|D /jrH} mލѤ jH:Y.h ی
n(@dFFfXo ]4Wf5
HME ה@tZeVnZFvZLgEE*ux
PŊ<Q̯©;g蟒d^VufkK.m;^yL˻ٷ>yqMlۯ + zp%]yqr!cҒA}R )rƟ-8i肟'XYi V*/jѲ^ou(^uڹ; ?!1!I xxϟ7mLh{ z-{W6(uEX
*v1EcueQ$k`Ci"ȱm]ٷkro3D g/&PFc]oASPܫuq.L M0T`@Q OW/3f:{答`9y9{*-]lSVi (Qxd^cz e~ ,-u :
}ҍc@Y.hEa R`ҵܛ7/w25Ѿ{N%R[QlۡCwldrqq}}?b R)MF.ׯ-;
W̆a"UzQ%&)v2HL\`|4lUoe闛hN6㓔 Ips^qGmqa11kzƩ(Qe ^O
HvvUJOC5م D"Xre $7#cbԭu Dn\\">R2{cO=rԖV{֮^klꅱ837#:)ŹNn{t
A"ɹ})/"1k8שݤgQ6no^S& f2
lϊ|rԫ"V# #oY4b@FUd&"3#^feXۑF1gP+7Zӕ/y 1YHUzNj!f+wWSXEa z Jҩ;wi5D/ ߠgN^<\"_i?k?N ei%
͚s; 9) ; 9zʯq[ s9DppB#Z0p@굅_f0;
LA9=ε#
%ʄߋc~J|]>mWi9WfP&~T57? cdHAudI
_@wԕ0NuRR.{L`D`^P9;vUchw g ìt>}:/]D0oxTŞǼ8sgъ25\PΝF`*3G!=,qsթ%?n{G^A$iN*p]"0&UgP>r)wZ8|+=a/ ACc1sؿ6225\ XxgG]+s $2=9:78lY!}y!iJpt, 8Ľ37"Ki ~9_*
BU}d33 [
^
VPֽaU\HjÓ2 Z 'zy :y.d
˼hSQEQњnүZ5j=O_B"u4]оm S߿^5F> 66V)I۶R b1 `/m߭Ocbq50#,x~Lė?r" :.z\W4 8Reiwk\/Ֆ(N9M @faDz-aMpF4T Dvc;
8[7':2bdcG,YΞ4h<jIS4uHπ$
t[[𡝎N.oO1g₍m-?q}6^=Ε'YԱuo';WN:yis7LTg؆KcwhJ}dISu~X A%5omnsZAC#ő7S/{J&g xw YC$W|](J8pk$ >gRݿ&zcag/3~_>uE$ <9*`똾"͝]s/lީoL)=Дt)k=^JKi
smgYΊ'L3 ;7wTuN^7Z~N0%f BAk4hwOL
1[6W+ M\"zmgm\Am٢[rr7rД;9? 5{; v<U)g}&( 2Wڌpme=sKRoS=6
IyYFf}a#H5k 9|l.QE2މ~
*)J(Lܙߍ lu#;unvV//FWN;_dAqw߽}F"15{ hbE08֦M~ѳ'3 )lb@!eqɡn xe: !Dn/$ KnG3<nï t}-*:*S>6f<N ƭZԶ.JM~[PxԷ
A]^zQ,g{qM;`NK|ړ-TM/X7/Mƨ (n8}kQt[';g 0T$B֯/n_L']sw [#/8l(S.,WwufA2Hee XxJܴ,D,ioG_Oʽ<Ù_lXEbm'y V,f
jڭUvvA ӥsȑʔeOltqǺ
Һ\GZz3;R! "+'3}4ZyZe; U3ۖ 88oFcSNޛh(M@9t& ;w!vpLɿoj{T.w /AS o 0OguMF$XM#2H$iѢsǎLJG T}cE7+(¹s ^ӷ]Fv/^dfϞFEzy0 L~N\\ ;rҪN۶JK@ڥ}]oIGXxgo2LG@%(R(:y4o؆͑3TBhRH@1BNm
G&Po+4vXn fn>~ _vv%@#{w :qXfv雧to8's/CN ھ/ u;歋[En6pş!;{yYuOx A/V' Air: 56bl< B\ap1lk}[{KZ DG^|7>ĕ5 7>l8ۀ a+j㊕kĬoמloݐ.]~Tkl& iuOID= h3 ]NzVV& xȗnLH*0w ;w΅P̊20 Ntjw̵ .VejPsI:lE;P(4VJQI+K 0 Jݲs0pvxzXY[<AHADSh Nd"ZLf9p`Aԭ[[l&g i!ݱЏӖ Tj{P`*lm?L fylC,>vh@^(W"ȑC-T*!
;MHL{ߵKcG@7 #>Par[BhDaH
B 6j&YфID`#}~gm~|aD˅BV+{b
eJI9ig~BԴA~⊨IN\ɐH5kÆWw?
q52;3 h jP+ F&Vm|rl#Pz+AY
Q)!Si_Jbb5oU9uZ/~煥T$ry(R*-[J-ńbO Aޝ0qY||ڄ{zڸyrrM'L8E)hΜ>ۻϸ ܿC! MLL8aͫ*B @ BCfd!3dM-Ln $Ihsc 9
a/! 0߿kV Jj'?iA,8z}`AhZJUVV@AiK DƜXjah<.án|, |
j6dp zgSOz\vOi?yM||JNVX,SZ;[4 X,@ pvȢZ#3OLAuH3(`())y;բi3/h
KzZָr8gL\HjyhpJY1|UUQ Uޏʪ<gX)FQYۻe%
{
hl+EF#@,Q)%yEAA 2Y{'LL;PPӕveO2 GY֬^mߞߌ`&`˖m〗맭dv,wI7I{TYWIC -}p$G1+>C_0 bxƾr9չl$ xN-iMf|ig'tqpr0zZ ` $Lo_x4\C=zn]Aϣ## D9oz^aCUx#si?]r +` ?㉓FD<ielN 6}ⅳƌIt.8:Fs #+,`>g㠑cc 5e M+e_ 8P*~-YX*7zYEM8t~~S.ߵd J@_XYI 6 a<wͻ02?,1gꬋAU9ɵV }[i3 ? o1
䏰^dz5`$bM "2 *6ºu,Q3
8R悃*щvpBc'CLO ?aQzzFj ZKRCLĶI W9{T2
t У[ }.ضz衽:{ʋ7}<{ѷ}V,9U*IiڷXpڠ.(RBJ&@DyF.^zn!vecm% z6cirհnղi-s -[ZZ {Ub kXp# 4z`Z Dfzoܙ"3{*v[Yi1v OXx\Kڔf!e te(̈́MZ8w-xJ>rUb` > N$ MN66DӈDJPK,pei&]uz&"5/]@#)ɑK~e 7iKR= ~Ő[-ٽH{;ΝZCB/ |o>~˖Og))*ys :k~Y>srpG2qҒΝ7kѼEsW.4Չ)ǵg%}%]˝
)UGҊ>udV [LO ?=vnʱwEfv=1 F
u/z%>'OZ˲M`m F,0 Ft`ڎ`sٰq?
}6L9ɋ:~"3k.j
B.ԫc<o
Խtᰍ5 4 gِ'kf
BcV,\!tʟ3'l:~Dn[dd`3 F"Y
>7 fPM\ dAks%%*ʒl$up8"5LCֽCؐK
xGӦݻkϯ>'4o)3yͿ 4[<=\jO=OwhZ1?c@uW=AZtu%%CҢE333sc|y
.L֚
!4aiFV$HJT*TZFf
Xmxl@P 0IQfiki,1Un!egs+vM-Vx9Kď_% K-8 Ƨ Z/|3|X5D>8py /1K$b D*RP;_IA2R6mٵkǏ0h\蕣笈|rsV} a~]4qŅ(7SaӪ#3cF|yLbaOō gɎNd;{ݚu,xG?Ӵ1k=t`7#nnnz8QC(-W?0$P&v*Mܭʼ@oJB<-?COpnsPL&3rA!z5.T.$"RAcnέeRK` V, " @q AFLIW23FqzFޑ5i
K=skC& :| #mz ٰoٺ`hvڂ+2Mx{{\>`0xjfϚDJ?ao-?܂R 0`#2 \dg%f&&'+
LXBQ EqXϒ$ f \>㟔9f$d'o=w%]ܯ'R}\ a=`ZԬ>]]IRl.qq #1ۓaZ"ہ)"P>
Sovݖ<E6O<wמ E3w8{.]z}A ߸c :@F; = (
յj*xܻ9q
ÇXj]mRbp"^[2v̜/Yv3@]= s?n 0&[3d|#3DΓ:ջ >U,ZV;J5֯qK'G; |> }G*ėBwAC :V, T\BuwyxZ JTseuNA^fTT+ww9]RRfg'kذn~ wZ5,777<
u\/]ӥ xsf/X kV<}4Ҩ ڵf\|ѣyhޣiiw4d|BRp`MP$Г)ֲ?#zaTJ3c⟾J~TP"
̈1dj^n-), θu[j5(f 9PKTYzhxKum 㚖q !]h2 xGw!QS7
.n`S-ِqcm\goϝڪeC89,`ɲ
B똛ڥЧQ/Y1 }╋o73+wݚ9;v -*RDE]"0Hju:Я 5 }#'$;G,
-] 4!7~x>lh5kg Q[WϱawF^tɪ Ξ9a/e|QPpoJ}CG@ñ?aB%B_:C4kc#xw<
"̜&)X_PRut8K%Rd*$B""/7/4K}dۧW[n x(=J;v #Kvqvwtz@(5s[|y;? vԹ8VᣧmY7baw'NpH>b֮aB<0"T,t5pqs-͙Q
ٟn|;q/3>B<*RHϘџyS5n4|w{`\gw t3|/im7hqtB٥Kಥ\ 9ϓW("c˗OQQY~l26MNAYq lM-W[7k@WΔ7%#(dzfo};rԨ>MuptI5-0ML۷Ϙ5(dkr>u3N JY88O>I,ӓ#<t xQj4PV)`
:2JQ0 fQJ,ŕ0X ),T?sscJ#z
ٵ3DєbgˣhS.߯;vl7naaڶ&;r24횗_sKٸiS-\q ƾ]qߝ\ b#?<piC%"O-.vul8:$8P^ԓ ? &N|@CEpnͯg.1}ڡC?`oӨI'ONLH
쇠HzC4ˇ8k]6,4ya0nqhԮfp6,$ }$FLӪԬKO"KJ7͙8Ҩ:*4E V PersEń+7+4PT5vb >7~ӧÆXrNSŽuLNN>/ E+ULaC{۷+ lt!z*3ϑ&8x/;`(SD=ϯ%P`^D*qG K P*YY
V{3;E\90,bbڷl䓗bA AJZlFKa4qo pvpԱcGӿ|rB1$8o\n (.SظHD qx<%hpi9<pr MCwz%"aiWq
;U㇡̵]9|1IQ}>Jllg-`/]s;u Aʁ& ;~z Tj?.6~!WnV#=m5EaAu\\7._ DNN! b ;3Q:bs nsuog4PTaihԂi @^r~2+b?~=tH@,SK:
6mitjzL LA^UBxX("CpxF>r\"pv`p *6Р tRvvg' ''VVYz6; &&ۡ}A ؔ$=/ vNgݐb31`u}<LN:ZC 9"\p*4]KBEO AR@[ e10 εe2*'t KZ#'{999m H]59< ?ґRF5bZWzF-c+LQV>McccGD߿j]-6oЦ+?Lb</[|b): *8̬첼<-Efff" lS,QjZ[3bFRXxw<;ׯvݞ;oN
Ͻ܃5rϧJHܣ<GKM ;BޣT7
u0hh 4?V 3-x˴h?MKK>qp 47!|,)W)5̊fMUk"uap{mZD9jϗo=r'+l~ xL·m G |`Ϙ-@̌_v|<w*xa єI?]zV2S'o[ZnEOkCK-]>\G~gl2 )gA9O.qLX~~1hIkkiiЯX,@=
dPk'ǘ*TSPD t />
أ<@/b9으LA66母,`FD v<e7UWՄV7 xXHګ9VhH1qVNNVVVeOq6myÒRμ\n̬xzQ C>I _ 9r6:^^4m i$-G~
@*+uۉto^zԶ1^-&+z3}^ r.IQ~/x3wΤEBf? =~ >{Q'gg-^t
QOC|F I9q̊I w=iӦɘ?GF\ װVStzĹsf+lmezuőe2Ct0&r
3TPtBZ\P \uޕ7qյuHȖ lCb&mH9LK3L)3mg LZ&&I!-ЉKB1p sph FFúlZIwV+@0Xwy=^b㋘l/@1M,Au+kfXxqEJFssΆkWgsG#~*ENV~:#$V\ipb~`z{-sj<A,p۹ 7Sz> ((k
^UT8E(0=gXXZLÉ$c=/O E%OU } %KT";3G8 y[ Wp} ?y-p7oݻ^پ}
c'<V;wMvۖ_lq%x PkT @;\}QsKc4\!5[ 8VYR_?[ WW0^E<'Si/A 6!`CT8G "|ó̚HebC MAsTyF :DT?J9=B,x`ަRiPG>QSy"Xt.IDGijEIՅ@.saV8* ~F / <}幦,(;A36%SvHYMznNݬu
v:\mf?jmm÷_Zp8u<vtj$kh^]}/! 9z
f B/moDzˋ/ﳄǸuBã rC=ׇFFH K$ yT-JӜ<<,O0 @ : [QQH8ʙh'!I N,pq@\ixMM^?T@U&s Bg`@S ,1 ^RIpyTz HtRΏ֮YE'riTJ ; mzv5wlYfiݜ%=x埬p۽= lxuu?^Q=Âtr4nowTw>+ԂuV6ϙSe0i4E 1
2(`81XP, wZ-`pAv6 ^`;<#{pv{<LtBSE~<e+S\'|zՀ#$,pI D;NsQ- .]^ *Lhb#PbAĵZi>OWJn6)
z_}u%GAϴr1M8sz#}|./ٶM xg_/6Y3 kx<0cW/_iaIgϮ~kgOQ*}bt5q0~p$l#VNx p )@^r6]Ǖ
8ZC^N-l4
2@KpXH<?$wc\1Z}絀 L/D6 +*>_JY ƄA)8 ٳƋ:]`ʕ+Ϫ-4S 8|MeHg2o .ΒŌeG샗j|=m6\&Q47,nӼy3sre #ddAQ|O R
۽=]1 X,cDJD=B#4Ӊ U 4 `XVh!.0X'ĄX qf %JdB# +" X _T*js!17F*eNWNRJ5 :1^̙CqM% 8ǤIxGg\طhY 4K4TM+)+*L>4&QNdτ^H,L!rF"\yYVA !<rbN?X:`R p V+aXt:qӢ<̛SYT
0>sL5~9
y(weXG;6/`"hr
YbHP v 26N%㑓A{8-tB\xRɓ_S[E]Pt o| zkx=v[^]`h("99 $ِ cGADY66hؐ (N$@[̎sE|O2, xyuH"Wx 8y\ƙcC5U;J(QO[ }s|~pn?khQ&Q/a&a=C&AYB:q.M ߦ lO=UXVVV!tp vd28q-J
I NJdqX#-Y@Pehu877z#h$"!=yRQHm'֣% 8 0Iepl, BE( +/OѨsssA'B x
PF%/*1haRL
i}\ϟh=c!?<۽fu8@` Gg ?.o2+-*pTD c $xEGʰ+%PiqLW"| L cXjY> QZ L&O~&dRַ2 '2Ռ &ϰCm%$Iiۍ&e(RWϗf/p0T,VOOkpGFJJvTj|Oʰ d<?IP ELS=8y)iz>;ʰ@fM& :@H}4_8s 9B;+Q"s2+ńcx̚?gUG< IENDB` httpd-2.4.64/docs/manual/images/bal-man-b.png 0000664 0001751 0001751 00001164504 12663316405 020551 0 ustar covener covener PNG
IHDR sRGB pHYs % %IR$ iTXtXML:com.adobe.xmp <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="XMP Core 5.4.0">
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
<rdf:Description rdf:about=""
xmlns:tiff="http://ns.adobe.com/tiff/1.0/">
<tiff:ResolutionUnit>2</tiff:ResolutionUnit>
<tiff:Compression>5</tiff:Compression>
<tiff:Orientation>1</tiff:Orientation>
<tiff:PhotometricInterpretation>2</tiff:PhotometricInterpretation>
</rdf:Description>
</rdf:RDF>
</x:xmpmeta>
Ү$ @ IDATxx^y&WSEQ%r,x7ylln'mml+$.bQށ$Kyp03_9g9π222}}}ٖ[֗A\H-{ ds*mmmV4K dj`n-Z *`4~}K%G.Ed-·H gxdzwRᥰ_;C?;vN džk{!ϡS V}"M\cy ϴ36x x x x x x x x x x x x x W`gYLz?A ]<ۖ_>.-
x= \ a[HE Y 6< =K rBs D# `;4( p Ev3À<33 vj7 >]thPhm < +Okp*S#nVVICiU! H클t. +HP.yɣv
צVMMMhiiAgg );jp<塰#GDqq1XWz'/ y@@@@@@@@ڹ%AZ 3T:Cʡ0ɊqNO+ jpTUU9[vuAJq0qwz0/iQ:їɍહv{ttt~{vO 'O0cƌBzR@@@@@@@@@: 3qXi Ly06ؠrHCdS '>F.ҕ#:-Qu={ t6L43
hC2}ES m |Q8Lq68 $OO ';&d2|O z *8q'C:ӗ|pQKJWWWɓ`>}[Qty*)t9amрC*`]s)999NN~~/YN=> :&-x29Áfʥ|0Gyy9*++݊#:(/!\).2h> !ܗ!Z LhM 'C0߆8LR3\ZO&7 i`Ϝ) 2SN^o&^uuu3gܤG \ s@sZF cP]ZZt744)G eqUiԨQhO6qQlbNYs)tʧ<<}4ゖS:[h8x 2Qem~9A WWY9iZN%7*ϧeY>]&F:& $ cl ×+~鈓Mu 9r ,pVXIC <<<<<<<<<p<s s<s%+kLeiws']]k4MެkR@r6qA:o mؾ};f̘
A;X ?&\/. S.<5NHqbj
.M s_0V~ M9Jkm \"A5?:)%s:tEaC ď] uEe[mO ѣs8/t6>0OeQ/C4ʣ>Se!XV}> Uf$;'<~dzL> E>>Y٧Wy(Q2aʢUN:&ygΜ& >y9*_@@@@@@@@@Ey UFDh ϕh
5sd'm:tƗA^2U@@>aSeE> jJ{0٪6rST&I>GsGuӑGeDQ8PQ/Cʐ^/xGuVpEiUW&i}h9J~Yt/ ^KX w]Ϣ J&s H ȟcI@~Л|>^~8Tz$CO3: M pرcz-Cݾ *ǧ ;dY{z,P!\ dp
v@kGY$0[P0iPoo[*cyS88X*mPhS?^2'* #_!h} ĕ玻[h8 <4;n ё uOqhY2'gPz I <h"It>1ѲgR3|7 P8 ⳳ,{8p iu 0^`c6[p) 0}k(_T7z . ٩ܷK4KK=JCK _GT/8SoAhhrX55~x úOCT:ĉ[h.x x x x x x x x xr@
: Hswa0Iz~`A9θ/ E^{ eH˜LQѦ}^7bĈ? /y`Wt
|x ~$?JK9L94ڈƟCqI)&M v 2ub-UٕSi̞s.hm x"sy?g짍ugPԆq'"/˂sDC]5ZlĂL3N7e,k#;7>1e}jO]nuFO|BDžO'eI/7UxYEpkbII|%%*68Ocn ?Os! ++ =tinC倞r4уtP;JA ?h?.8L/!/'
sI2'O8`:iY &{UsъF E]1@Aͱ7/מ_W7/\^_`V{;ǰeQd9\9b232 V8s ,tN&y~,p6 9ٜa;k?a߉Z̓k lG ȳvl䘍 mGv'p֩+7'$v:٘κMP`ߣSp t%LG2X 9^[lo~ 1o/>ґ^IeÆF Yqou q<<<<<<<<<px vnsO*q@͕l\y㠞<U 9W)J )2PbٗC:?#UQ4g`E%䴅r;/W חG<d2g\$Л҈Is/}3& 'q㕋P[
6/^qZ@k{og;vlۈGOcX8o:pd
:ۚQЎ9WǴbF :Q0Lgؾk?L² وۏl&LS&2^xuW0w g(~mV3P8֭߄,\J ph>[aoGݙj䏚aDa6N ދ]oAFAL++Akc
lي L["L@KIlڼǒe1nd ܊z\dgd=~kNtU=_2%}6xO<~Jw&SpvIUw أ~T?iǃ'6?^_Q9 <<<<<<<<<~@֟j̠A9H'h d3hN6@')tyh;#LQd)(W(I~De[-ЀZ
>MJ~%Qh>ާ'ܗϳǰ} Fg"ׯCKhX^wV㱗7OkUaNBӱx`B#,}Ũ; OهaO[?y G)i 9JO5/Ds&J;#l)aL[YO ɽЂ\,\ Kreko
ï`΄x?f[m<g| fWGof N.o_> rZ>ǡfzwfLē~~Loh-w?Nv؎Cx~ LZ~'60uMPϝ SSuo(p⍓\6YcݕW^
w T@h@t ?r<~O:G:V~.ٽė G[O:
IAVP+h`Ε7mwנr+ ]D: ғ$٩ wi#'OԕJ q~i|Kɋw>f;#|
~Ё ٣6%cJvWc˞qt-2rlBe{Eexއ}Gc|/s_ǟmGVʏ״@{Y:j^y%y`M s&VM_ggVij݇P^P oQ<¾(ޛb^?{ j7_ݸע|D&^ٴ+nwet4 z-ݾşɟbI(J~Gvnۂo\Ҍ<73]2gݽ 5ω#s;>/7Rɕ ,3fnV |^ü)t$}۶mÚ5kD rw =3Ύ| u`v%G
tܓ=%Q=<Lc`zI )K,+0a1/CU`QZ:euY06Gs_bBt4=Pنl{Fowau:ڶ7`fbƴY`*hqP{(zl}FT9 V`jC5vMa7PӁ܄>Ǩ7 xV.=W͝7-~ ]c,؟]{ͶП>q7mGqnrF
_4ƍv.(1#2rgpnlu9]YZf{mcԸi2qul̘' D} yxkgt;ﶭhY1ܻf$_ D<T%N`wvOq
W<31cT"u~1^ .Dܧm^|9Ν8[oɮk٥pӵ6<x x x x x x x x x쁴t9@wPҢ ?Sepdp0p:Oٚ/_v QO .^'ׂ_~Ic+=ݝض%߾;JZb?a)
UVc֭#7,įw{{hwv9ise:~3ƍXm^éF=1e=Xy* كc^Պ*wt-\ݶ]k"lywgV? MX܄ o{ _/wݚ][m/<}593 xx'MM;p2h sGo6] X& F6j9?χ_`8 3'd230a\E'xP йa" G+2e 91G=s[g͚v~hSH
K9hT|9~RH N<y`"/0QpGL&uM;51Oo}Mw_~ &db
ß+uxQy Y X&ƕᵵo +&)_oFOYۍyS v#c_pix~\`pJ qn:۾َ2,^qVن93+Wh ξWEpl|_b7gٲd\4 ~V>7l\_? ͫ}0mhj c\a2D2\ Iuϣ.qQZ#]~]0U\W\iӦC_P8} s+{%
>^OL2r锭 y@@@@@@@@ ۢ]ڟ &x0ᗮ <n^2Tn89K!'Nw&' [PS[vT1ؽ\d?8^
GOxayΎVdmG D=vt939ݶ۶tyţ0UǏY8ƏF}~).imoB}c+FG?ysC=Z:0ζww4et{]s;&l-33kyζdۇmջ]p֟9
;nkS}Q~k ǖTV%y BGo*@q^NWנpd) D%;>̓ Lu\ y3,Xe'/%gxnetK_ \ z̀BǮ]*ߒ%Kjat~ 5@CQ$yq>,Y G,{+ r[i뱠 ]ݽ&~ׂ^=nl/ 8j nw o&&0l }]ݶbr[5yr= 6l:<䴷!#;ʙ#ro5xJle?tkbPuAd{s=^|Q8ބr~,#X8k+u]&?l%Iss$# ^r.Z'<Égl'ذa gΜ9ח@X<pg` y@@@@@@@@!@Orwl7n܈y湭ܒUB2ID
NP
FzaZbr gD<agr0+KZ_|&efCl!tL볉({uv9<vB ^ԜBCk'F bt{=)pv%t_Y&Zg[U~y(:^&ϣ 9rW]u6w8wYGh,x x x x x x x x xr@_NQ i ߣe"|QPE1$2T Չa,s1y|ZUvp/ӾVҞ )K5dn#AGzѰt
ܒ}/EϜlm,x^<F 0UNM=S۩o5@>\GˬII JcaY2>̗-LJz}+++ϛKCWiB9x x x x x x x x xr@ϼ ^fҥK]ɟb!:
H/ O0&)%_.}#Gti)#ᗥ|J>/̈́p]h SӒV ct қlE[y
HJ_2m#LI2YrV4
~٧c
>}tٳ}Ή,Mh:S~|dػ/ 2) &\__kׂ?5{lt(`Q! ć,\ `1_:6$>E;%|h|ͧnRRlh}`,ě .QG|? \:Dܗ!| W|L`{'jiH/>C
@|e3
[oQwƤI0w\j.2!x&bd1[Lo2x8ZmJJK&7} < qtRnɦ %(I.s\_g~Y3n}uBa J<x x x x x x x x x x2l@}n~~Yts[EqUUU. 1c Ir h( !Np &|;|)s p^ ҙѸC3H/))qe [ۇ{_@@@@@@@_
+y'ƌΟbN`O L+.> x2|} z˺_,L|E+~X }~ՅO&Cx3Ee$(t(8xTF y*~ڗ,*[zg(\83O>}uhokw+t
/x x x x x x x x x x<d؊e
~+| y0N: ,~̓ӲCvG+\yOWdDn>e} #P2t126~8㴐O;Mgfud 28=Á:cg =cyeF]]eG/ <9B
=0 ?r^&?x x x x x x x`( `_L\99ulnNhã,Gq<I6Ud.L4qr%rTҥEidmM7j[/d?GE'|)&rJN*Z>G:__AHO29qxɑ\0|-K>Ȧ8':|0h×%i|xR^ɉܗ KG8EuQZEA|&Z&GXx}SⓜҊzz('Ά8q0K&'>G:|N[t&q`g\>, qmaqqtlNKG ,N~:d6鈃4q`>`e__t&,܇|H7NҤ7N~ יJn*\T`zIL~2t91@'U9]>I78X*]>'?
˨`=JIA8"0 q<\PZNfT(o LCɓɑM%݂>=>m2ӑ^rSH&il G/ɈOXS%78=$O2z{;d EW*q8XT i3&# dvɏEu^l=NG l8z(''OWw2D|0 tttR9]lXʞ8| L E
FC<$#Iqq0v.q8d&#OXvP`4tRn*dʦT2MKqr^9iR58| LS'?ՕJ&i L&d.F8!^ J%W}Ct G#Ic s @ T@re42iu8wS}oeC*ᢴ3
U
7ڑQŴ{9ַ[gԾ}44\壝;s#4{k/<\ rHp}4\w^y9\[_@@{|c\u}bN,p+uA8a<(y8ꖎdl⣴%rO&#_2xTpՅOW~2zKIq#>p%0^8 E%4,T'>*882$KO'X F: eW3e KF M+`>-%KpU&eO>]TƗ! >`>·$9iI#(Nu}#>JO&jN0եCpJ/Q^CdGi8ߋo?W{}`˗>އ MQZHtQ|`>tt0
&g Ç<,_jWW^Ն1TwC'm|7 ^sߍcAnn|;Y:2V}<uFmM&+ԩSIQNqFKAԁa@]A:WݹeA/NB <<<<<09,q'֩<&4'ҤCI8+Qz`,SU(NHEu& <OCKFBb>.
Sc9i|d
:i`+ zTDi<'}(Ozt\x:$;&SݗW' s44KqDaQYIOW,Z
<\YTTbT2S. \dzū|k$hd18#FUs WcEO8\I: 6>R'! HM G?x- ܉gaHxԿiϥkrHS[/nF*6=~ݺٳn!o}es2 &gZMkmť0_ &t6+w+cǎu։PGth߾[otl *ߎtu<CG RNu^n?OƧ LyLOJW*/C(}.C5CJCo(He~f܇$[ /IHjbpһ(;\MǾ.0|t_l;bߥ9V C%ZB7^g J>vNl(Bnb(]J˥jw`m2-R9T9o2娮MtRH\~lCGi/ò7j(7> D#},4*Y R@@@@p=oGO/NY/=t .2La ގmŔEQgᳯƍz@اO<L~KILדpK Q9Gact _ Vq8zbG m:٠T ~(OE}Schdpuއx#?]5MRRBdF/s)GZ^L u'W<e]4qOF# *+S# 置sgt ܝs:v$\7@ts*!sb` ;g)I&U؆<R ~PIr(icDق%Ε6`kd~#N?M*\Ɉ,F?^|de*Ecw&Z6T6PqC&+' | ^K8>o2~]eG]e3ҥ8%92 g[ύ 3l8>jBgK)"ʣ:e/| 1%{V:O2=yEʎ p>
t aa0` nLf2x2=qq<)O}.//c5ȃ6$ ɏS84PJz+x jtVu_NօT&NWD8_ yl \6'Z)uN8ٷx0E ^0"z.D\NuW;(Ku^!0>W}<N V?'}ZnS UUU5+Kc s_\.{M#G /rD/X*tHfYIW\^0)7oQS[v/DgdZOZ}(33 nԸqcPbVktah,
rK:?(rLcq7SNu4 Cyաѭ&D BxN &xMM
&N: a:a~8Sٚk//=?g튳;zNQK?M*q2`>-[_wDgr^=JrtEtM>s)&ٔr4uRҟ,6YYr| = = Ys'K0ҋ'K.0 w Bϱc ]C ~ L˰
*
<ODldg*۠2'98/yN>%ϓ'r+#_ ̗r.Z啌td2[&SNR 89fbڽ{M6SH.w}h@#?mVN=Ǐ wΜ9TMqy2H˝?0^C+\ 31$W DLSeͣz89?'ck9'f;:'^WR_Q. _}Ww830.>&X@t̘1-Z:e_~f79p.VOWmdŶ1kjjrmeF^#|ȼ~_}Z䂫|: >2eDD
vGe%7& 8t-͘2eژ9rcǎ~ĉφ̛;sfͰ{e :
升'Od$oHYv;< |:>Y勗̑#G|v h|^\ئ8Ӿ7y{l_4l6wǑhl'(D=R6x~);btRۖ PSru ݩ+&
~Hסw_Ե%@1*-́x]KtvJQLs[<~.?IO23gб~ g@.ﳁG_m
7oB϶m(Z9*;ah ՙ
N~>vڅ@ٳgcyzU _yPs ϝΩr1pEO 3@ \ye],p&̹ͮ~le$~cOÅ;w 6IO-r\W*H:ɓL瘗k]\8%Kܸhe]zY c;vp_ V2:}y,I:%CuH #z'>e2KЗ~S! e' đ~Im2ɾg F!85Þ74G;KJ8mF{tv5!?yl`J[)?8Q;?NȗKq"A-A?F^E\ EqD)JOx$OKp_INsz|*' =ז
GI<QSN6ufG7 Ԉlם6m i.EML ?8w.x]NR2
2H֓C[<l%a~N 2 ({ XI`G 7mpW]u&O<Ёc~NTI O$OD'Kb ́ltP0HdEܒh>,AkdW`|Ioqz([t2P0@" RxGL%
ㅈ QMKעN>D"T
|p0aNg 'sPL:
dא*+?i [_eϫ»B{8 7q
F/+oA&ƽ|R.aʣx8 z\
_v[Ĵ%? =G_O\1Q=×8Sy?H>%>D'<r'OM>)Y<i9~8( 42WHPRvIt)'<}!{|yY昑UVVwr6`iM?8%=u(+j/9ʉ㸗ݲe˵M
'*'/qe2罗rl~<8 ݾ.!,J:?bY}Oe.8s&Gs~vPm)CxŶsbbѢE\jKo~~k;.2lRylCf=+zgXj8AZ[+<㥛9Nvq%MqŜ_ߺx=~_[N:Uf4Q~β//K<\Lq9i8)1+/EzPâ{ xop2ՙOw;k-Gk?;nw% 8R./&fE#@ 2ئ &Ljr< z} ^8[oNp6rH3h^k3G F2Oxa4 :aنlDt5ף' &%]^q5x:*&A=uu;UFv J:54cJ݄tuJw_ƌ g3uk]-8]]܂7V[Z>8hpcc+FLta~4om?:ZM^=̔F~uv ]2<QY&%ꌓMb9{'aRa.lq>#ͤu)+
Ӻ*wgb^'f%?Y>.T[SlL0&s/m6[)
y-=2m _ˉrX{<"O5sٚ/ZZ-F&MF9K~#dEO6p.wpYAn-mhmNv!WhFͷP`/hC=+bjnB#JJ1zT"bÕY98%#;hW~i<#n?y ~ح|]wu" 49uD-g 6}vhTTi={:P} ŶK̓O}͛Ⱥ[y>~J&6϶è-AO<W^y|/ԟm{z1ƌ 5kn`KyM9Eh##nLU5
Fb_>ٞ8Ԟw\JϔG (0J \P>n۷ow+qF q 76
4F_4d⸏Ss'ޗ/Z rY!;WXf!)99qF,_aŋ`fM2~ PiM6J'~ҳL=<t n =&(Hˀ,*%00ۺu7t!η=m$
8Klލ< s7}u j@G m p tM"Υ[s>30g \Ή %R9a>\eRu__D\4\eh?ieĝD<K&fgNNS#}QŅeyO}35LIʼ`@I<x ?82tR값ˢ DaAz֕W
5reC `yN_ oLSޛn0 &}O$řMٿ|oԟg ?O8]<dx?z GOBYqY,c?{{Y:k0Oo%98c^xMtk*\s3nX1 f <U֞>L ݊Eh9g~'Z CƳ;>Ԍkף=|g#ᕄj[ݯ^Ǿx &-Zܝw3DZ-6d(Տpr٦4> YM $C7ӎկ;i"u
8}#ު1p牲%&ު)?q د Gh3X{/><NZ)@ƕ`52
t/93 @ IDAT='!.vDO^DK|W_21^F?ڛڋ/`j6{P<s2O'_D_Vj䎟\ &/ ]Q4p
yM> ܵ Ͻ=vĊoK{ױ/ ݘ;w ϓ ?/-p}?8 |Alذ?OҲ~(iDe[Y_
]6 |6Nj5DRg[#C
r<ޯmX9 '+**= g͚IASϞ+o1m6oV^
D\xmS}-iks=ދkv&l.W dAo9fp+vb{\f ? ?ҫ8[s,U89&cU"- p+hO:dH/sSy N VC M>d* x4eL 鈃h7cNp>
d/e˖ '0&ѸJH1: O/ &.qD:_^Ɍ}&1NLR߁f/8gHV@z a^8k9s清B\OrO?*Eu
<}d+-ˇM5 l6˂jTGMS-bBYwjpA) Zh{m?y-HYJLMxk[EQOt6+d9mrq/HG%'އwٿ؏yWm6ECv^y
%|E8:X2/nqvpS8O"g
HN6sd]j xa:G
\F"; .a] ZF_wNBo]6)>[i?u$3Pn6vZ HFaR {):zԀ&?
xQvw
4lUcs6w4Dv8g\qw`Amqһ/t\_<z iq<㨸ط
0b2öm翂f?&#-= eܗ>CG QeX6{鳘\>E
ތvdtibfuYjL`gL [/ 9
# l ]>wNWڿJy͍gҎ2qB=SzQoݶƒk3]: t֛m2Fut vN_^V jl*3 ҘXLjewBLF hiwoL}JzLǚe3<:ZPg ( Q ]Xo9|Շ2VnJk6p |cӟۧ VYs;/5.|Q\hꜶvv¬ d}k~id־ {vXY}}vm!n#MgiC3`
8ܘ~X͘1N>юL ?wܢkjr|!llVC[<9<ߔ-k7#Q:2z ֶ,[1$ @GhͶ
=
%~[:1 mahMmCħ?q H ~ n@m &n/ym/ˠx捜un9 {Ӗ߁ۮYC;' IR܉Gfp>|ĠYuEHQ6sCgM74pWVV&$L~`&, ɱ վʫV.Bfduٽ*؋
'9V`03"{=cl7TlRXÜLɜpIgn\b؍[jOs9̼nl
Eug}/#m⺣<ںzw͏ud pZ;; f}o>eޞN475P`C@\Q?a Q7.-H\u `
Ƞ.}5nfM^O$2Ts\=kXl%d9{LGFeWSLqcC2qNr2۩K:R!hUx+\!5+wCWA:FO>'G'v1糉Ssg8'HC*:?n FԷyY%`>-k+9llS4$LyHK^O~N¤Wxg; x+k-@=Aw{7 j+{Qf]65 ͲwX-qH+_/muv>I9Nz0GZ/>g\K2}8 e\q2;7I\4/ۇO4<7,d \ɗ!ټC2Ge'Nm]]y fθ(w/1V6vTˆ5I9<<t:;8O 7k9=N6eI
C7Wl֍zI˜7$ޔ9K! x?n{A_O+ oPٍ3ƿшXy2Ĺk_$n÷d|%x<=||ނc8v{3 }U|fcAł?/wN ?mT516;_
6וʹP1 5
6&, ,2G.x@`DM0 :cǍRtm&'Ɣm&jNfEW={g~ןRL* C۷JYk ]Cx,ɷ Wߺ
2CUHx'lS/F^A};1x'Qߙn)lͫ>E`uxyYLޜeX ~$P4fmh:j3h+oM6 ^4pϞ>l+'۶w؎()Ukl /<='\^0z
Zu ڎWos
-: mO=}
L'Zn\3Gl+3hE>FZj:\t:66>fAh ʦU7v<:`sp!v[ lC$߈'cBŸUPfv-u+Zl9{vK<SZ:;]vZЛ_j>\x7]0&Z1j$Sh6|0z9vm| 7v+0;0s}bT=smnD v`ӛ\MH[5էQ1*ܱ*۪ڨoCem5pd6n;JlɡV[Z`ދYQw <>q#V̟a]vp$mg;g~uqpji5[?~M$tn gNޭkmht*̚T5>{ODLrF )+mb?s&+3}vّ͕k۟&.uEC[/agA7^QŨ ;n*<kS,.&[(Gʳ[g4z5aEf
E Zl~fOӶe{16G2a_eX?=~-|prJǕte`R.^W}@='lnLM,
PTafo$d .tԾ`}EWвsao|$IKܷ-->șxnLE )qRk(M ѕm/=ǭ&|||tj?x%tdY
߸
Kfë?NaEXh}
8AՉZc[s H7%)L!x /`"Q)[n+xr&#'8
F9,_r$ (LP`qD<G<³mM1~m pBcP?r%Ky* 6&2%0 OZҤJQ S1}Hٜ pጫ\ e" );.'N0
asLߓVm'2F2P>H L'|H }uL|4 F`"mdO K؇f_
?@0?זk-vm<Y? O.{u( |]<N>mO 5/Hull&=(H}& ~NyQ}:'1(K|R >6qLS6R$~Չci5\&#t.K$9`sض\2lgD]7uN-#+lqA~ci<L&
O4ixPsx3!< Xf^Ll fu x3 o ԗv٫,ۊى7_x O~<^92O/(> ̾n|۰?}( @x|cEIq/|
ͻ-9o7q|;o`=*Sp7?DX{W.ŝʖ} Ğ/Q,[O#6<ƌmZҹ?g: [fY` S݆I"Ϝ_y *[Aon|ힹӶ䏰S `3qMdQ} #߂Uw\ŴR n agfܰhG
jNbp͒YX#Xa n >1=7.g5wbt~bϣ
yilog] m=8&'XW> Ӌp>,U̼yqrݝxQ[fĿQ<|CbOa&66Jttgawc|^+&K1[G_cr[_;RoF]x;}S [GwoY gPY~XΪE-}lJ̞>قL4c峱pL *ླྀf5ݯkq lt\(
-o`wU7> M6!{M<g W,^ z̶gѪwaLN~cέ ǽ (^{^d_ &㵧GzOaM*T| OK5\tvY8ft)PV}N6<j,?{`z|Bn[5~bg{ mgwߋz0͝aO >O#$ f W}[3b>~Ǎ'Qk ij*\_z
ȶ
2C?Eg7A^bܳr4^c5r+/E^}Hf+jGE <#X} >݂_ ;qvnK6mx/w$>2nhgڻ
q-w1᧰q}z/N3v^n~{̙b۸gTkv/صYPSa*̝܆nI~p
7ؽ;MӾw^B|7i3Òk֬q>zU=8= 3'Ӟ%p6Vv,Ѳ]mCAVͰڪmEnu ,8 a>WjND30 Sk^Gcl hS+aᢥ7;|3:j06 e\N3J'-7=|sXf M&䏠b <06sKb({ Xiy6!۵5s L XHX_\4\oP %^Sq5sy 9c/}9{ 2h %ODZVqϝY- CҮheEq:q,G=0c@4@3
E ) ds)_A 'E8F$ Wy/Ac :lA)}{5'<8±?G헝!/sd{UTT8 ix.Z<.',uh//q9'WZy0|β1*d x}*Ӟ sYhc{ or@4Go?9W]>!86D~1WOy}%m-FZ a#\ri!zLGa:Q`ɷ# 1Mt[,5-Y6e?h#֗y q N6h7Fe徑t<TVV:μpgM00u}y,̣I`oJxPOm+*Fk] Ɵ?߰TpM _&oϰVr|}v6.muݓ`m-63^|cvlZ#'VGW%}صIO_gUbխ`\
~ۚ\1g)ϰ ɶ' :x#օ硯e4mه`
$O:ʹ pk3q5vC5*j. 64و#N6?뒶:V;l%LM&,k '6Xzna >>
-wjrGآZ@
~{@ms'rGf:1r X"J<>rrbQ߳kCB{s0VS DS6>4ڪvc9sUj͢?
a#lE
.X0=Wعl~)/YܢQk%A]]Pج_y>vŜ
ԞiUsʱj:c7l۽q$4wU`m ;j9>cjoFcy;P}<c=fh{aq V݂YS
kɶ^} k-yX^i ]+o]_?&`hwvٍ!38vF U\;nT i cGuOJ0 W\X_]/g
{ ػ4#=m[>&o' /N ܋6b 9]MU/Yq
Gƍsc1
L|52_msxbG# e8|FXmb2a EfS#6AS?
SIoW:gla(4w@mk MǦNi,Ze+v۹ [ۏbtN~ƛꎣ6ܵv۹b
]m غn=Jl{?i
5-Yr2N1;Oe;U#cygF.n!=laXؼþL~˽v Z_]}ndq5U:{îkmkmR Б*w͎8_ Z<Cؽy*rzЖo7k#:p7cr6so?{5L1@,
f3eO/8;Z;b?yVj܂^b~+ͰN6}wbG3;s)mC2<y{ x,s1\ d>_G2s
p CŬ8bb}{mvu` mڅ *g{M5n9,h*8c{Tyhl[|(߰MT6h 塜xy H bI/)dil1Wg9)]k
|]*3WvLz[2o0p<1#SHVkG23@S=$f+lt>AIǔ^Hܡ RaJצ~ a}Б:(k0%md yjMj/p
' hS]lUsN63 )_ d&'䗌a2 pZ.`;KKG:HQA$7QcLbro?͔{cb-1wRD@&.,,vJsf2̜9N;Ym =L JKz2Ni,βpCgt/h| s
[K7cc3ec$/{ <A_:_KLv5K4NB?}S14v:40M 4vپ3BL9kb2{[f36h++}3 PT:4ūrL)
ٴ?Xgtp2'NqOllcM@ԧ
݃NZUprDK@8ƁlIK:u2v*_,Τ0sl88GK(sN3hnâ,`.*M
W{J4'a0_^}1يgS2 E #FVM!Rd6K!Vu٫^CɏpZYe[g|z2 ,DO{3˗a_QKIJX~fˎc eFr{ĐOȢw^2xTt Ӷ'/-]!'FyU/G$fq PA'CsOKa cJq`vٰPƏ.5EX\L:iQ)m*9V&#by)`$ Yc\Wa)cZ\?qUts%fK;N 0;}qҥGÖrJ
N@]ss- SR:6l0fPMSqh]dӚu " 3[I
e3 LB2Ng
[yXQFY-+l,&/"Sx?/idzW#'_YlٻyX`<cvE+Q
Ok5 9O*
A :qْ "{ cd~0:#S:`[K0}[߃O A0l W! %ڨ\u2زQ ~*I䍗_ |W
#]eȑm,"KWn3gτ{c/0>W&z3MpX6-fCS|0,o-wl<y918|NP Y j;`[%Hi=\.&S*o*0i\b*X1>UB @
aJI&C1Cg{Y>AvHO[ymdVhԱ x|V/Qk3Kk$о`E2wʕ!s&*Yf'O GÜ6o Hz 5$^uGwl$P*$)Y8" ߢͭܧY.
LJUغ#6W|x8 |7N:4 7nӀ g58 h߄K. ~Hc4:asI}
MXʯcGO'~F9؊3+Ʈ(Wy ?AY}j z?a\,Yb >w,78 :E) H]lZ4
`QA%@cILW4JkZF99ifFE bN1u ө0F bF#ye* Ø]\OW.J=s0p\{PO^u>OygYrЃF+%,sW^&CSv0[KZb d3 `-ן/C?bŲeYq0 fLLhpf8֩fT4á-7б
L3&UW6\o7w` qbߐWmxNy۔SHkyp)kazqzߒrQyA4 }#OK $:M=@: 1Iھ',>g(
݂K;EKN0mp
Mˌvha'2:bӑ<YXaƇ4f.77tT9u|xxp} änl9Jw/n0a{\˔/~2䉻%G0k6R,X(co >XYl܋?sfqN 2#d>>(=T \'qXƽBnA<.55aAmeRO
SV2ٶu #mza^R[rX>ܾS2.%v~(b̴YX Ym[?avXحtȼ+^+K7/ZJ T0ďxrtfh|l%{RxR.+^(=/_}9e ~ 2ƛkԔOIX?_JR xUatt E,)ƞݾiKhy/0r&]w.uH"^f}{BJì8sjaH&c6}0v{WzfTaFN%F;o ,8!9h@y4Zx o]k.eC2u{{_(mgM{7ﮑY_ laXp>2yPCCR u·2G,zm,.C0Z,JoS^eʢy{0i ^qRwqw(/2R(4ßJLa2
?m=-e ٭ E}~n2/,9Ux"?[RR, m2O<}ѻdԫ%>,%*C93zdJJ ;\K.cFKYRPR!c{6Ɋ1c% 8|@kUO^=sߑ> )i}`3g8kJ<WǤwW=e</[ ɐ!˪Wɺ~WvaЅX_6-kZڵq;pn4^ Q.}=2||wSgH /+/ved V. ('ʎ O?%}/R&/q}X1tJg|[V˘!qB 2\x-ȍ7h1Ξ=ۼئ{}9s8;(K. u1+ ztXGa;2{.9O<r YXx|'MiAg@T~u{iw+;ݻ` 9ߛL.?~H/˔Odb :Njq؎ "cdmx/Ym 9) e<3>%Gk#>Op(o-ߊAafޠ@ E@
}nJib')
;]W W .i?-l;zO Ł$S&oWuO=) k
IGy; rgz3C_s
,MSz5-Ćq9= gUeWꢑ@}a8T'y([y3 }S4o_ÛsAh!0GÔmg% gߜ|tɯ>
4c[
XYT
kx4i8/WsѨ ppF<)}L"šZTtsɠ8,uU!7^b&ΐJ<J̣(z80_>1 tZv|:dKT~^iqJoF||X'Y oic cs M+i88
<;N LhY&YƳTr_J,+yS y043T 2, iBhTF:+3sj2>AHOc\i4> 6Q aFKIre=gau+|[s;jpmrIz]|oN#)8z%pH,ܹ#{x
d
S-v"`ijV'6q{oJ ~!. &y[^qV"~NhH/d<th?.Sϐ)s@Gnr Iʦhġ\GA=_ #IK9>0}8IM.^yUY}ɕȀn9ztm;B->$?\,. ~..'p}?s@\
ff2:˱ůˁ-mavũqLKϬiI%?֡Go)2eW(MAsK| (tarbi
y~ ga|G:fRS
Xs]VdwnNoR4R$]0ûy %ᠷ1O18\&=zv2<iŧ^zRcv^0:RP+$
Kߕv7cvenq&eU jlgk92< 3} aoߵ7O\,(k#I2c
p N6b,|f钒g,ҫ ;e* rŕw |f{ qѾ_SW 2$-r{ HOçZKQdcKJϡlSذ 8
^I8#a0,i
Q79H Pq0#a%VF[~2 KR2Qyeg YL
69p |K عoS^*}CV^,o.^(;cJeԃb,x9K 2pu29\ie52slp۲Y{!{֧J[p W^;b;rs_G zo Qi
a[& ƍg^-#U*ahH&3gL-?X&ckGv>!gnis=/}IyR_>OC%b uUc[H\IصGn}-6Jg2%Tf>Ğ^V|jչ$ ӫm:<gGAg)S8|?s -;V*xC+->6k,7Wm+ w^ģJ"[[hJfbXU'=Mۜ`KΔW@}|Ь2~gvlhSߦ]Ɨ7
N?ZzCMvYc).1C`_'_e25~:K?b:K2Lʡ0iGy+ xfF"uiD
i:g_&dGaz5^W. H\7bKR)jթLޫ\ P3ΦWtnY?]Ϭ]m:AHuҧ|EzmU:W Gt g8v8`Wۄt)9¯A& r0p;-
*ꥭ&Nc+ :Nt*7=J|`; +m,m:),<<_|ooΛR*3ĒeKig8똾_ȧ?iv`<e A䳯U"7 l吏y ڳ4^E4,? ?_V m֕]( 3Ē9}HFu(ȁ+$>Sj #7cbS`'Pi4tV^&
&g V>ِ!/ ~jeTpď2T6è>uA\W,/T5@.˭~P
3ڵǨ%
A 硪,|`}0hx*s
fH8ExNFOM%>P0Bڷ1Lwey >rLc9OQaVb",ϊb9哜-؛Kqj:M,%U] ݵ0
ЉAʇV0h;v yO|g˰ 2~(bF,\2L,PNm<#Ae X 1J|Py > <g@>g9[ ew^`U ?z
K|[5abCr!uUյxt489A9Q'\UQ&ajU<M̘+E23C\% $FLF{ 8<_^M 0_aҞ1f| RtyұN(L6DN1xYT\| ҰܝXXQ6\_T`)W*-.§P. O>-QR+1˴0 Dg,H(,$ B0Ϛ=uoܔ
ㅦγ3zBWABMg֢9mXEx21Hg]2#S Cփd<
sJQ P SQ |Lj=g%|VSTvf Vؠ- Fk )
1y QxWeC9?.g| 7(ׂ
ˠ];^=tB(g^ ԧq|qELm:WgM86=(*g7~ ||7mR<ޫ'%a2OTI 8 z[$m
P_Xv-qL^zߖŰ0} O|`d˰K¦ 1z| 5۞,~hnBSML hGWID;Tg0 ϰ~Ҳ ms`OybC@˓ g؉T) aˠaBC&˕;Dld:77\S>;) \HOtϴxb . ܊ [(zvt |ie'A WK*=ek . Vyć<U] nyH,.`pB4\ʲ=ZnWbMC s`A϶m*8F#Pf gG~eIYcZiЎ~2Qr C]nu_yYyݍPsvI2Kj0Ł l$!'3źGG H HL;#`v9˂ii1L`Y7ܽ _sXmH T ӖywR r!3'䜉c%Ɋό%ZA#l9 FG
q zOYXQY`!/+Y4,nǖ0`a|!{hUSoXeD G d6Cubz
IVlc;Ne7]tH-e1_4-
KӉrl]WIN:|OYOxN ,@5'0Y%LV5 ah qQ0"mS. 7K˼CzOog,˲x"a # EH:OH#N9G0v<9XŪ#a<0A3Zj뻇ќP
J ^xyaeT)Krn Ipf10t6%;L|B߯0z;Lu8 H4CT^6*7yPLi.Nh_)nƾ,N^gxiq0
0zAY`Fvks{vGd Ø~vm9M#,ayc<qiQ:qK{+,Leipy:Kȫɉ%teg4Zfm:9.- q?ip)0/M5#6'(uxNQL.7W:ŧ.x|p{9D<Y M 0pRyT/A I 91q,Z>l _:m+:a@gٳ^}uttjlY(S=VY7H+ K`L `i'y T
,&ۢDLNecBgr/a0A`~TQ$Egj4CEP2?HO>HƳ9ȇA<C }XICg* *One =s @ IDAT-`iU~Ag`ᤞ!Sz ^/o};V;Naz =(+4Rn6US M^p0xh}a|vXQhT
p zOdOaҨaאS^:4*+<[Oi8 ֠KNU ӔY&_Gs~BA9hi`\cv*OU&g/l;<h4f/5Ye cC|9cT^| -K"Mz< | Z&Iy ΠhrL:+^_F'ı$M84A*E
PՄ
ˊ8NϗݙS\yk7zр5f|>KAKdʦ vW㳥rI2m^OOOOu{kKOCϔ s"V%}{|?pךw
'zM_
4v1ΫMøh. lz|Gi_Ǿ-?;rY e\RqNڲmya|zC/Gu hۼp֖Cr|V,^
Q
銯`Oͦ-[G%pͅMD p~}){Oy\̲W:ձ LǴ]`x0-{O_O<x?UzGK?V ;wX W&ruv tnpgýs{Eʃ>͊F އ%\͇,h@.y5GtTNT3vavg~ sa+N?֔|s'`z<uSSGL*N?~[GoGi_ͥn+0k@'qiUOÂ>&Fm9ѮX} 14$𐰹LFшNe4au3=+Z%jNW,M>W4E oNg_/x &K]?=4[kA9'ܳr?.6`ӀPpv"Y0|?rߕv>fD|I0 hL0e5M |?(۾2y \Q?H -ܦikaPΖ
'}蠡roc=/-uFGG= R(ه5~(e[)zOIP4%'8K_H>k Xi4Ę}?Zx.ڽh4aIX\aCƧiRᨯ _m2[,9)!L8J\mi Y8Nel6kow[n0}v\Sך瓭G0JnM#&ֱc{Q7'a6FR
[|85BdZ
+ svs8 "ez\1Y ޢ
:H|Hn$s49å9bA9[A GF:aaar) 0 '&M |6Zv5D9:Loꗱ[38Lk\4O7&:
jNc8FcxRpW/^m|Ϭ{:r.Yh+S:rZ K&k9~Xzτ '!p8 | ő|&ȗ{D)㨵鍮ދzl gg'tif,r =X8/:D˾W>,aZ_x
1NÔW}֜SySc"ޫO:_m TrM]uזmVz;LyxF_d7G0< u?TMa|W '}0LmYټ6Mڦ۲5LU;HUC,Nuq&"ʿ4-ͫ$fZe+nj\0L5ͯv|صMGq
.Y%H Ҧp
qhƙnA`'<`Fp(9
N.חpzkυN# 1FgKt\մl~_qUW-#WEv}jI]bJbKmk>[WSy4M "|YAA-Wdn_CT^cQ +OXZbUs%?0q 닺UyN?d|S^ϧ:W] Q9}/%a릴 =y8e5%7Ly[]uRVz'V<Dpcٱ8۔ RGփ@]Cb[1_(4v:4>W >}-KӑdNO^Iy< #oK
ꤜh[W'LoPV0 XUoΠhcG:0 BkøU'bA㛒X
6=6MK儥Ŗu4|X+:ӡ LXޠΰ6kJ^5S1wC Vޅ +
1/g&5L3q49[Yu.{=H q3c|Pp8NĄ! @3uxE?:φ0tzyO\kzA^u(M7EcR*|v.L5G{nyͥ%;mȋcqMե0Za^77L2Tf^i4\UF4_2h4arlY' fP6qJ MA: :gq kS:ټG?{ WvhR96Qv^e*Ml({r5mK kL+}Ô%6ʢl;<Loq*/fܵrF]O?^k&ќ&ަ }46 UM0x[ fڎS :[Oyq 5>]Sq>_Tԡ4CZ
5S0[ypqʯy M-;(8O?N2,
|6voʧa`ЏW吞v18U|}` ԑΎ{WZؼE(އgXS^ rGZ;,tt8?!mJ ʰZrM9i TG4:G|ztzo4viޓa5^}P W0U~ ixP-_#)_hڃ6oSq6]sה)a?LGXeF o>QȫijIzZ_a Si5~PS a S^ٴR?LGXF oNL<.|mzt[װܦ&?LN0Fo_۠pC!p8 C! ?+U͝+9ŝmPkX4lZaOeh3Ny>MFk˳lv:ڎW>h d5LC4yvxSv~c\X) mP ÜMkiK i'OS4̖zciQg>ZXXхz["AL
Lc0.Lo&(CcSzt2dEl?L~0) ^7Ӗ֦QͅE 9 殃 % f_a-k["'mXaaLKf3^&ڵ%rTgX ױ5H--*74 Fa*[ަ
i h|6MK蔯|4ok; aaa8u
y4*_} kx4_1>LgP۴A (_WZztuhh}oN'h:t xWZZ]lVhq{~ܺuꗸ3qdPհ҅h5<\fhќ1>Hqv-7 ?:)3NS4a|6mPkޛexU>} 9ռFK;Tj^Ng^5M^W;|(o,q ƪ3iCTY0>זۜ *MSTh7G M҅dG eibIA^-X6%9AསO}t (OmGeqh }UM60 h:x8My*'̏F-\e3LӤta~ei ?(3 Ǣ7TݟreuFOi4̖gUvi|p F^ ;Odj*}פ|6]smG2.Z4S㛒4A=aoȯfSdB:M*'=Ѕ9 C!p8 Cl!gKGIG)E.-f?xgt_)/QJCPO9FHS "Q-jN4Ks< 2b HGO
/}.tv6ti
k?*8 WKsx|zo:&#,l8|T)\|,:OX4Gs6#,SCa~jKg% C!p8 C!pp9ީu8 C!p8 3m4ܵC!p8 C!p8@?G;C!p8 C!pv8 C!p8 9Bx!p8 C!p8 6@pC!p8 C!8G8 : C!p8 CF6!p8 C!p8 g#ZC!p8 C!p8F]; C!p8 C ! sSp8 C!p8 ghkC!p8 C!p#~wj C!p8 C!`# t
wp8 C!p8 s3NC!p8 C!p8l<ϳݵC!p8 C!p8 s֩t8 C!p8 CF ѣv8 C!p8 C s:pE\\\N/юB -2|Bs&22 ;y\t
34ʊMStbϷnTOUnΔX" Lp8 C!p8 p#s8 C!p8 D~&u C!p8 C!# '7Fَ!p8 C!p8 pKcʑ9 C!p8 CL" 3p8 C!p8 pz@92C!p8 C!pI~&u C!p8 C!#@(Gp8 C!p8 33$NC!/yytt8 C!8;$Ī& W<[0oĤ mKh*,, gZgSW;O_ - i)yr8B ڹ
kc8oa4 rjȁr8 C&q0sbunW`4,Ē @r|D/`+/vJdF+S|ϷS۩$Jt7m{*!p8 U5/6rtpo𔕖HYy%P$&Hzzb15Pbwm,J(ʓb)2r#19E2ө70mZw}n˨XU툏$IKKGۑO61&~"*$$,Krb1No;tv3\UYF^T<O@KbB+S!!D$55]Z$E\hr C!H wӵCߥ09o:>ՊP=%3y۹khW˒ #ɲc2{s_^љqs )Vc-o?!!Aa,I춒 ::aqAF{aN^8B,7|_Ap cuyڽWʪ<?S['ҵ{OiN,+>FIވR.?hT=/6ZlVv|⧿o~Ҷua/ ~(H]凷}MvԦJk\}wTz 379e$x JG&/l:&˲mF^<< dCb}ܰ¹|nC!p9p}, ވT~MȨ=NsN]4D
Cy٧3+NyhR TYtH~lVRW[$عġ^SS*5U0γerr2(oR$@Klܻ惇WgE`9{
QS} tɪV(*.ҳs}m)Pbl
zu%c~*%&w>+'
>yzyr:}1U881h]_cfhfomfjC#䌄T˪zRۚR[S?HjaPd"k"?q4֩iAFp[D,O>&K\UHF'=j> :
u" C!nbz hxa4? i6tv1+t& ^@yI )!
8 ѠtquN6CFޓt! _{q7yU%yw /Cۯ(?}}w24s 9+q2'Sl@ ]2X ߜ|5&
eR&,~Zu
ӗtGM#uV[^=O$5C1' !s~OWL3M,1oJ[s2a;fˑcd0vC}eм28҄S gh9Q(4,OtP Sg_XΗgq'N>|xsh:-o:e8 6Y~HJw3e ai+FK{nP
l#K"keJ*n*J{i flܐWv2Wa3(U||+\6Hatdv2`N:]2o+Y!w,Йw1m8L6)kFk}J Gͯ
-+y۷ u1kkjM4eQKC!p8/c.K/<mZ`&ZGrc5t41 7ќ2>ȯ< 'C=ŧe鼮2A<aߺoG'=] =vD'ؓʪ;!2Nr GfOo^cYӑ>39gǘv^X?A}T´õ\h,3LO}e2D |a1yW:MӠ|Rz htȕJI/ "}?vd }]Od&JB RWGzf:h46Q-XP\.i1L4HfklZ?'& QhW6H# )b B+l/h 4iq;[#cn_cߓуzHO~$U54y K1Cyk>xr@UnDOj3 㜁~cqƴ
SeZ 3\#1A\֢z5YRqʀ
RHy?^ [5~jBgp7 m?^]\zO!
o$nY& 3HZjKH>,uUvC!p8 QNDsh#
mk@jWcRő0$ ;I $)@ ;;y(/Ғ9v0 v0s vҾ];IDNk uUUʾ{%2j%-vɖzMD.]L vl}>+r *0Sj{Vߛ7W;߶ baNeeRTx =.զ B-۷6F.mP~YD~@9/IIoxzRVUՑLIj`7-qLl+{v Y~G:Z,O=z4_ rS-С}F+ L^*3Їք
F:YmI.]$=5tE#0
M;[% 8Ћ
~]mB*hAI²-|Y4Nfa ղHޝȇ[IvN{)e uĥʔSqa!A"")O2 ;<JQw@ |].{3`5ʩMZ&H&ʐNyJIq +(Ҳr<7|6}&
C;S GҠ+](K=^ =, 2!xntΝ;b )SZZN7Tle%rA?v?SCҹSFa~ImM̑d#8-)#qp1JNMC}#E5jd݆"Cwnf%N I
&cE{Q{tD;v11њn%%h촷A:VDҎ:&U2R|P4ͳ)'ǎCyRTRrd =l͌9m,#XϞ ;*G 6gFV[С=d`6+ Z6^k=c}o߮U=1-ezFWtwmOtUr{vgaY>>>h37ⓝC<XG:QXTj|HAY%:WY q(H b)Ns^.hPxsC!p4X{$7}vHjY]ydނhμV&ORz\Чբs%r,t@yW6RҭL ?N.x̚y 2i:R"7|R~IYi~%rRQst"OCΘA
qvk%̕;|GRaxtlxeo>'yI)S+&pph6sLpdaTY_Rw ڥ?+yI)^=Htȟ<a+;uOO"90
SIʂW |TVnIj{ _
ҿ{{?`S+[֬7|S,[&{Ih.E.>[eţ$;6+sȢ_V]7tL~ۧ>)_8uX_sGlGɥn>qlYD\H֯~_ L__p ҫӐ =Yz˧SF7ʃ߿gzVRRܙ:WXqU eH<~E董䊫fM)~=3ò B1U ϐ_F9S])"I?||bbuڳ}?ɾ
ٱYN2nh4u\9m}S`:SSQ,*O>N0 Pv="mP3 fv[gkJe2wl{`jMo2k序͐9ؗy lΜLn8\V~[;
{tZN?'rach,Yr(˗xٿѽr ;%6}UrWnΙY-yKޔҝ)|6m̞5]ci<>Q[)6.WJ[8X*㠳Z˼Wʒke2o/~|VvK.YQ zh'9U@|eyǞ|]2k2c2mDD۠F};dd;KeUoF(#G'_!3gLi)r u?Qv )] 7[ZE.Mt1}Usuq?fVWe<y⡿X=˷puI6biZ ?Wxyܓ v.UxfbI`NG]4`f
ʢțɼ7ʦ
\rQJ^ӟYLeRӖ#坿.n?\nΗk;Ioh'. C!8 =ܡgeV̛CǓ/SU8Dה{?^ s-7cL 2<݆eoz6hס rrrz/o^a[%^zC??=%_@ݛ[i5 9^un7q<
xOK\g`Dޣw~;fw=W aW{ oai9^VZr/;pnjԉ7C.Z~'ޱH"Pfl8({➟67f/~Fa2:o|?CacMѽ/jgV/[_wԣ*b˅оw4^ a?QgKKNiov~+o_hᯉsMy؟|RyWj?eI>v*#[/6|wdVoZ}?k{֫pi:A妕 \gcMO>/2兇Q=҄o]yOvz8J}Fa߸gW'QO|#y{64wr߆WWȞr]#aeWX^C5o^w#c}o|},{ޮH=p [i
}3LEGy^NIB'o+< kڤ .vϣCv4J%ez`z7^o9+(0?{0%gԷ
z/?jJC!pwDAd Pg
VOQcnjї_#u ? N9ǎ銸d72dݜ?H?,=,QIeIXyTyywHI(e N~_Qژt;oBcbqRrplŌ݀Y '_2cҽ(n?xeyg brIvy{|w&TtӟK5ݰI3eҥC;̬Uˮ??62⑲tɻ>\4v߭`ϒ)߹}RV<4 n 䏔Eci.
vz:yjYဴ"/Z
$I5{?X}jؤf,yWavx'Kuپ}s_Mt͒m8n_1]ۦ *oVdܡɺ
sL 3UE=>+O K-|lyҿW,tZٻ1&H2½;S 3临,{6n7O{˟a 䉻dªje$ofٺ 3XO5r(G=K2
4{! {%wG_M&\<V&[?O< 6JrcU3+T/Y){䝛?)fO_D6Hiҷgw,>yoM(ڱLeIrZ\C B}32WٱYzcYo&lI5 +sCrm.9(=}s2g'ٵqkߐ
)=et8y ʅGm7$@&
zHuM?aX\˩e1HNI8YF)Xж[?dp9b OMn ssW]ٲ
2S49wY6D^?MrR}~n:{K HMmu/lJ ::#cЅ 80H)/ 䂞 d9/#.+||7ΔȲ#7oTFJ<8 fZ& ,vȜ 0I5z" g3|I 2woeN<HMzy;kjcVI9 o; c{]k|tQ*<+OӮtb{Tayޟo xDž|l}L ʀnٲz[ʐctn6|WH.;&s+ãoJ~%i/.9RUU.;mq (ç}A_ėHU ^*S-meҩ] &mNswX8p8 y@!SAי<ݟq3f{aޔoVmcf+˽%o< o`v_g zOaouޱFǏ|?<xp#cw 2y5+s5 ryݰixGV _͠F]t^E}şӼ+6C_?\[-ss {z nTz ,y˻/o`i zdN[6ev;a{=omM7](?i<)=~L~Zujz oMxKg3>}Y{̍Fa6Nk oxǎ2pMzye _ (ewLX{v ^:RYtdݛ'#v2#,{/wTeSz:a?Uۂ,ӽ ]^/wy- cBx85A>X7QO{e I f7\}|\7O xfUN:sr{ Zmٴ{XaQ5?^%e׆Ïn 4 og[
{?Ȣޏ: =ZgTx<//+..n[+3
Ͱ~y[v֕$_"Oy+$~w旼 GYۼt2'ۧcy.M0⡗̠sۿ{l~
u[^=} ѽF:z`C<tėx/<KҮ7OyZEQphIpv9&ޯYޘx_z _*"ivO_goOA]k}בY^GW
͐Q| >qЗQS=y> u4uK_Qo|+,8mY»۟3#m^=#ۼ4"o6'~0_}^iu<qKf{'?uox6oV5g|ޢu ֧eł=?=wby Ͱ}6W ܼқn Ɗg4zzW?XT ?z'ec ^{oۻWYڧ>!p8 AgW!!ywLhg9e "$_x|)36 }:,zd|cӤS:[>&\p<)!o5k!_U81{"y&<M<\ s)ßJ:=zt14q}ܴdF)84?D2 >u%I;)r$ 0C2 ߕP} "8C`]p8O}M:4:Ȍ<CFKdcp6}6p0G EeuH}yn^ZG&pϔ [ i=O
-bz9co~,ND68Jd#fR1U|p3CS|iե8HI1JJ>uSrH'eX4`Z71+|a~Y~>y~+C aT쳞_`6Ϝ<_
-% .Io/V !gɖ1<YvGW2Dz (:Kٿ@*UIN'>lz?£{ڳ 3ݳZn& g}r6ʂ8pU2Zlߐ)y(B թjr H*^ ٿOKijVￕ\w\ ׁ2 wneaw&ve^ YiWa/xPc JjKkI.2BGdy??XUYQ&= }&+蒓 &ϸʳ+qKހ x=V'`>]JZ\1Z^V=G"t,
/&Us7ϩX@˻!μ\2Ѿ0L{BtS
Nag"lɖkC>1
qzu<?Vɐ4YY[Akgh[U
(fAj;e7I.a:`܄ ÇzVU/=`>]R XM}ךbg[n|슱,89<g%XCTU iiM\zګpE=Үko
_ vf=N6,
38< JZk^ 8Mzn p99vb&1+Rڶ^16θ6iҽG Go#wp8 y5vȾ>ߏ4˓rdJ<% OVXF
jF]yR囝ҳ2t-%Ke- }ÿDQkDlêC'n֕| nY85M_Jb瓮FƏbNw@9ON f~/\%\:;W\*<l[q(:ٰ~Z rYxµCfzu߸~qL#Зad60WhaIqZz[8 @Qt6-jq!;ֈp˿PcZ;d[AQX5 5 ~S@-07 Dw>ÀOU0dԵmZ0hxz0DӔrJL2~$MlD.3BRmŸс0|[ü ])o5ˣʦMeJ{
.-Tx\brJ
aqRb;RY<` 1j@%8 m֭VfH]<s OH& rmُ Qk*!U?{T˞]CV,^TTOqLnO`A >r*o3@yt%eܸqҿwO 7j~l-N(]-ڝZHm 'y& "ڧH>, @ IDAT&0'w2h5֙92zx%U~7+Y-< G7vXطnO]7;Ŧ> )FKNo@WDMf|aŒv'q 9-۶ӧ^jsW9蕒^&M; C ڽ͓Kmp w8=҆i]hymR/ ucn2ӛ
Qa@eBpuG$zx/+tC~u ̢ǟN л4A
( ذ`r{*(
Ez $@{o9oބP}nj)g<3̙sLO *lW@8\?9v .B0lDFI Z &^ijy][
F@#h%S$a2!t1,ӿH_wA4 DgJ+U?<tt]<"%XN欮?T 2VzPq!EbUNոrx㲄Qcí7\gzN8Z7*?Q^=b]Xl%wAft kf=IƜޚlE,4%<*_,~ n~Jn2j|k4tF*_CV^i ^#9>j9Jט S` e Ch9؏/&ߌ#?{EA-oz>UؓtT%,!Bɝ1)Ipʛ2?Tnv]0q˟#S7qo#7ΣG{ Hd@ ႃ .}'6OfAI^'.DyZ c 2!"J\6r!:7Z }ff屃YJUPm
XWRPM@~1V|8 q^*쥠l3>#$ЙV~>OVX 8QbZ5#Kvn\s5G<ZV<;]B 3VԳfƷAĭZN!Ifrg'İ pv3Y`QY]
c(Yun#!M~L& wzwm S.UqS
*~"z w;.}'xs Ao$8;Ż\{6h
9HڻG;tz*] wMǩ[ :*Y3F@#hkܙFufLej<)J
ZmC YԜ`-c
%'{V[ tƾ{}Pzѹ Qۀ+ނ³xS8xᯞ4.7;կ9!?Urx+')H|p!|X<+(jD@ߺS8o~t&o^Vp7~@p8͈˭)dS.LrH [Hߛ30HLsxґ:̜J?=a ZU;:3Tc r
q'1$g/[ >r7 &>ZJQIr<FĶ0g<7#ZPk芐eMz:ZШa^ P@߽ff5d dUe%W"B6-8ٟ| ߎ1# M_7?Gۤbj!UC02C8o߾-1hL 737~7=4JBX)ur@< EgSh$W@+5VF- Iq c'Ą+FZ,k7,>k^x>p|ѱDx1ԕ2h&6b ,",~S<1N,Y ;"bqi#V~u5[cD.4ze>əqFf6eB Č 2*:6sT-ZSn-{m,b% ĭpޮ]" 8>Ôk.GX֬
Gf ?z`-1$Ɓ&x([u9v|880 WNŦ5xW j2n[
7.=$!|/9%$T2ep5F@#; pTkq%hNRMA;IB M$yl
ȥv aJ+jML3e(
^N}FusD<Fу5W u.Q̉+p2( {jj8XݼwNGfWL y4+i*+S%N>%Tp« oߴA ԅg[`j8M7C=Te
hҿ#}f<< f )3ow u[i+ֵ!8!8@l+k?و9h6I9
A z`??NsJ2ѡ{?Y4Jj
eu{CV/umCѓ_͉y pݸ|:UDXU c-9ia7e] r움$ߍe &gyZ۫8]ݗ[ѽ~:`d],Jih+]ݜLhzwW\B1thXF^[K@7^-<1 ^fH LCaq%"<NϩYM?YpSz*Z^zvxlr$`pwB5V4gҜXW_+ s|?-@q J+āڭΠ2 T=rs # |@K{t /> go}a5Qgn0Ʊɼ=יn",B0T 6,ŵ#{?ƟT2;,j+Q néHOGT 9rXnZC?ZcީtaK$sU '2AF@#h0fcgsA)T dT)) DҁdGdt4.E]XŏEAf;ϾcE78%\ܫ+|]QV!{\p@՝ f+`#(!sq"_ ZSx%cWҤdޒq@dpEgg<R0?Yyȡ q'IUEUC"舉R #ʘܵD]8P8pimq@&x:r:Jh Av}9ӱ*E_e>c. TuB2>n 9 \w?ZtJ tыѧ\xzwu>"lO:jm>ߴCs C4K{j]Mb֕ebi|Zc˨Aߍ]v᥇Xh ,5{, 5w1 V+jtah/kq9{%FEPH Vꇋ'X=UV^@p=\ݻ2 xٝX#ᓏ>W_(H$Hd,d jʁl x^Fz͗vYWrMsZdC!1`}+j
VIW^W xHu
dK@ڠ2~
B΅;vPsJ
|BZGV/ߡ6J 1q }buko f ۛ|Y7߇뜌ޮB ]h)9{w9|=7gLlF6yߚґgwS:Eƛu!*>ұy|MP|d bZ$D<iwO`Î$8{}:b$x {<8
%í[ fe}~Zdq YTF@#h4;("XI_ddr1c<2H8g7[F
zoщf2t8b&%:K5҆q{x#.z^@{Mٳ .|E}"Z=y̍^{Q[C5 b ̛>gPc_aDKHQtM9]L3H u0e,Ğ?W*
z|E FGVzzuZ7z'Cw=;ƠW <" QyrfiǬӉf,Eo QFow_ q VyX=,-eSX~FN jkȸNi;Aq|| l_ Hæ_K>С i`7ƍGя~e\ LAΉ \ ط~(~ ^FJq8;}Ec
ûD-WTL?5C-"pH4ՓT^`bN47[]tuKC<wԆ1zc ZkѓmEjtiV_ZB~"$TPknNdp qg g/dcrx',>AQ@jlˬݑun*!(Q z ·5Ǔă.ϗ97v y!Zқ|5DZTY7雯nOwnAskAF,Mntl;p
ꋐpum>,XW [6Jx\Ч
4 (# lЍf3_80MMtY0k ukwaÆ}? ӑ:)6GzcC*0e tNe )a0ok{-QG#sBkTp ^:|gY }<
|q ڴ ƢaET[6QuDy9 'Z(@|Y(bo2!+pwŎ.9ЧF#{GD
x;X%څae߂F
>c<={p[Q$OP {K8 :ƞ>7"﵋7di,ՆX?y#dep)ErZ9֩~F3mSF@#h4 pB|<皏e6B[ﭸkv VeKsSm|LP_UML=%_g)gڞ(Ӿy^Uκz)WN{v"ަR}*-<&֭kW
gY4mU1);7VZYNkhx}˃. ~ U7<םUcH[y͟ =
kp,_4>% |5W6:4 '٪81*+/-zt۞! wu[A3%Mc w=j5,-[gP̳AUnyy͝!F<XB=ikw63iyv2ߟ:gO~<':dlױrWx~
mBB"m!>Fek%3<o+2d.-}y]>:ly˗}dJC/xvՖ i 6tw̱`4 #77[ӡ_B*A7A#-ymNv" ovdH m nFh.@M{Uot
zۚe(^䇞唙c L=PD2R&^hf uf8^bVn/j8쏿0FvO0c
\sSUNs8۶ xGK-2փƙܪW>]N#( Gm_F<mjfb.ĸ˨q~;|7o/4=%NQ(I YŅu}VgCmv7MYx9mޞf
y4BM:a˞Q1~6m(ʲ͛>DogkӄPۡ<=V){F#h42NV5p4QBVH.nO{ jz~zN64e9v(\8g5ԙڜ80LQ5i$&b+ P^VD3uC{<Z#[-= n;y m/FуIsc8:㹗^ã@Aa3E1Eznt5aT)2O{|\
z5p~1Y
3M@ɕdzP|ɛ* ;h vUx%c\Oc{+2oZQB&8J(elw7T/TwO =ҟ}EEވ C:7~L%5jvِdž*Ӌu͘%1ԑ~
}O>;8-
w:$t$'ߌuM.GY^vCfzV
["-܅<O?c7;J5(Þ,#Kb93ӌȞ#`u`}XO}')p15 틐 V]"o_0M6Pcn8}*_6$ }'\ y_*nA6gcXT6x8Y<o~թZx"K/|r% / ']xSw%P%t?~_z!DkfsKJmRK7 jk SSM.=;R<GwSo?ﻉ/@rN Ge˧߷b'U)y;w'04H9/Ց
9+G{
sm 7^u2 ij" < <m
l~|0nm1媋GS3vR+} Í<"8 %ZjW 3;o7@"dA=*[UGc,n?kFJ*GS Bzj3Td!$~~ t
ֶ`u~M
cV>yŔčWd Fr$xe8A?i4F@#߈,(qI*D*RLbue{r)1Ď 5qc| =q$6NzHۗ' ];ĵT.%\(lĽ!NC߶ v bݟ 7i v:A56yE,NǶm[!ȞPt;EI^:d+ m㔥ɭsO:jܘ
_oema"t =EETt øz?)ڙ¹
c&ڳiCjg+krP U)ܥ3I?gos; oܻν}2ӢfsJ 9whɤ #?s ĉb:sC
aaM t^'1Hx}4&n4l11i>e L
8x~s2229(
@dTZn θd ̵c=;<<e\q^q 45=}*Ȓʭ4RG
TcV }yVn)ɇ7A4:tָ(.6DVջ"[;ufH;YtJ E &Gʎ >Y41\LXioko9M7pj:I,(m];&48S3hl2 )X=˧_*V(<qw]:Ƹcj,_WP8De c 'HB%JNEFE"*5Zq Iʲb$.n$",VgX*m!AA.x
Vcozo ָ0 +J
L #5-XcZl CbhES} T2MҾ}({9sUcnTZj
=S m
+,[M=9% {"J G߶퐘~^g?1~}1X>@/,шEHp EPӎ`3Yc!$< |uj8p8ǟ5Dzoan&& F=mԝl|\G o3TsQ ()sBL weKN%)m6
CqhwRh4s )RS`݈bӎM|ߊ
y'22u)QHhЖ /wP
ۻ? 9<A8Q1ڵ#|0 G#h4:N+Kk̹armFՊS! Gi)';ꉓTfŘKr-'RL&喜a;bMT!Rx<#
R5'owb9IxV9q`9pPIwgtpJqg,
Ov 8GqE, Uq|Xup.A Y[%` n,QgmWMrOpVM6cNq`^zmm̃JzO;S-߯X
`;xd_iXM5eucwѻCk
yO +.L9Κfp9]CnO]4C ݓ 09bji:te 4/Ѭsj oc~?d<X£юo+N
t ;/y1٪*ܵiy<K|Vuu,k;5O
8>V04>4thc иCs%N#6V5h4gm˜њ XqNLeB'Z4
.
GMM>804"8x9NP,gşɏQ4,
@Y KB S),u$PIg$OU'jDY OMϖ>+R՞;m>Sh:y7l
!U & К'QL'Iv A;ýIWS2 >*g8Sޗ:XEu]Ƕ6Gc @iul3q{g#cOv=:* ejIhxڌ w=9Z)r:)^ɳXP>7 +R#Gses|J#
3G\6x2f:'WCoX
,^,o yN'b.7& e̍OfT4WRY_ g^hHw`<V
O'iD9|O|Lz;- , $xp,,x6 [mss5F@#B4ǚ iM8̍T15V19I5L
dŚX9 XIhZT48&Bgш` 6 4l)Aڊɫ>iޓ O0#IRЗ2ҶuK3'G4xrH0u4% *MԴ|zȧElhJ +U_ry~:yYjѳ걞9S!e9{c<Iy#O0M߷
4d ;$0l=0-<,ǻQ Rų#-cg`[mS#ﳕYD^>urgdѲJiq77hIvl4Jťi:.bnYZsc<˦LrczMiacVyx ձh4FХig38s p
S?U Mi:>7c3[ %TOoE,
4>sS?]
t3l*og|6x=:,R%UtWu=]^ǴXq,/gCLyΔnӼԑFtBqL>% !my}@tGN]qɥaCeޠ}: Ө.S c3w|+ܜ-l-N Shp:-^k|8U|C3qfH=Z'JG*^#h43g܃wf^ X ԣe(**BQqrn%U7:AA-Ͻ*UJDgҿF@#h43hLWh{] Z8CF@#h4 6qW)h4}vkLtF@#h4s- ۨ [ 5f!q~h4F@#h\yn*gvʎL#h4F@#7D:oȚfI#h4F@#h4Z@?wZT#h4F@#hho95F@#h4F@#8wF@#h4F@#7F@ Ѭi4F@#h4ϝ-h4F@#h41Z@wfM#h4F@#h ~nF@#h4F@#߸s4kF@#h4F@#p suK5F@#h4FoƝYh4F@#h4s-;}[h4F@#h4c\φ7O;99ωgS/ţ_zMCLz8h6fO j)ůGr $+\ [6[=ώU%O1_Ǥ/
Ƹ_{mXt*L,;^7jܾӧͻn."͍m1"/*Xt4ooSQF@#h4Wpјe2I=H+ ,c̉>sӌFh>$ϲt%oҶr6ٚА<5ߠ8O3uUs6ǻx[:f84=k32/ W@k $J=]ImjBi>y8R
iyIi.wV~()nG?h4F@#D0?eUpu@@` <\H>`M7G|͗k|v:Y? Օ[;s++asrTHѶ!4_.iM땸jn,rw:"h7]Pp,ӘR㧊2Գ->^*A%'/M(M K{EX(Ƒc'
!>jl 6(|YǐU\1pZOiq
Kꁐ0I:5ը#qř 侮Y٨ $, *b Z O=Z?ĴS7m'XvOhog 'C9Ѿ]<PSZ^[_
]sws#iABI)d^ sO
/櫫ā} VH10E%pb?C`e7ԽU`c=[M%] */A~azg}"e+(RxeE%
/Fe$r /w[Fˈ/[ q j\[2ςe1tuR'yϪʊ^Wc.
R$,zh4F@# S[ˊ |R,+ԸyRZF&b1nj.=L'Iz0ɧqm'D^ee+
Xul;_n-ߎ0
pD$ o
Ǩ߆8zkAV
?< 8C:Pֱ.#E%Or7`PW'[ ,ۮt{Ih3ё7IM0Ńu-/8'9`X8*'Wb9f'V*|ȊFc B;rs01Zn2}¢!dڈ~ ~puqAY^:\gNE {, tB,^iN|D̜6QAv*k<_C<tX%..
V$_Ye
lV~>'o
{
˿D>ź^}56Ҝ4,| 3
z"'WIL݅ϼ z]`n{ NOތ/ö?Dp;vV> Ueq/QasCMU )ABT'*f:o-Y cTKX7w~I -g/xw{u$^pwacqW#У;u#wOj\Ż)3O͝e2P߿[yθa5/_#CsQN*,| Wo"3\;
&Cp O%BU|>-]: ; ߂W_@_V7wCvpliЅwyth4F@#8whV@&_b'W)Z
:F$? ?X`0t75!745uM7L y]c~|Z9`n `2YhY]$UZl|]/K(};v`zIkNYH45M=YM.pwm9+ג%hu%0S|IYoi168+&)~=9d`QMU=$(lul[-<<<<PS] NpOzTWRF0W4n0PkrH jd,y[rl
iI4h$\ZYW¹Z3g ŋnŊ/@3h4KQ ~z -X| ~>\+:Z5jƔ
յpG51QgpŞj{R Tu]# >5ƪQ`!u֔fcs1yAWxl|; Nkj+˱th3jlj/7wzvibR-$_ꌅc'` ¢eXm f~;UqǰU{"
2ۇGH] M.HP<q(VcB% W>fFz#8N-\nL|u ny *gol\:28 ĔCq3 Ҝpݛҟ1v({`ۗWFRW%F=>|:ۆ>X<
n~կ`C|K?VK^_cVk w06_P3EHOڂA#3p5C=z'55zWF@#h4sftEˏbE$G~(,(* r
wI"&, wo-{7nBo 1KQ]O>1}/^퐖 ,9Epi+O]PY/\(;q1[.2:uAhlG,|lV^ˇ2ïŦ~¸Am֬PZUkжU0l$mLvnn=0a@Oo-tM3o@22@kZY߭ Cu zAHڶwP;9u-0mƍܧ3͆P_YD}Ԇ#%g(!^ U)az ^\(+Wݖv( +G"˕q;+o
jqc%kݛ/[ x3䉄-|a7F]3㯸" Οg˿Cqe-b;a h:?c {#'V ? ?6BԱhѠ=72.\2|Y*-\|xЭ·pۢ0Qh !X H@ }~va-q Wk;c>] p
ƔgWHt |pe(x
.q+!YL*@¾m`}v 8~/ YR[l8]\[
&]P8qg@Q+']zULah*>q}2h28t>1POOޥ܄Q4bνt'uw/Ǭ`o-WJqF7LE(<
K?;%W\ˆ+1f(sFiQn+ O Oqh$%^K7Ѿc~~رm;7>mZ(C.}CR |?q;i&
U\<!Uܶb.$4.Tw K}=;3! Ͻ O}. .JnY\-Fb}p òϸ~ wG|VG#h4FAnױɔ5TpB#ģW?S/>]=@M]3
35+O|0({".:YIG_ ڳ So(=fNS wG8&82gcؗVHo^f}>CʱLՄT,Mx0ٮk±0vb#濼NmEfR Ed ~\>=S'½< ٹE:\%| {C/iFKWt̘90!n{ ) 3j{pl!6Dl Sqŕc쨋ҫHFJψ7Wca沁u,_E˄}4e
&]7>^epabh~(Ŕ)ףSvލ*4ǿX֝bUpӤy~Uno)=]G,ON<)VZڲ I[2PW-~EWj)KhNkݷ?>[vr!(
8(EnvEZIOi>38KS˚T]u\Z< ډ:h "P!,'na:B;
ߋ1ySH+G-&L|sJ11Z# Enܴ㧌CLTf20{^XGw8&]? IߍZ.+3S'DD#.<o:@~ ;۶UE/<Z+Ǐ&x\T˛ Ķ;pYcn̚9 N1S#\ ,0oum\[G
<_dlf!'# MOYi /wEzF*~~ou [6_ k}ZqwC0ڨ,'+O?b舋 }D QRl
eߕ8`0C q@1$XOyb!"?
~ͺ xDAt$iʂF@#h4,j+C1ns%K"u4Y㢱g":_*.mctŗq&qo;uW_~]ڄ)FHI v |lEKV<7ѹW?v @w~ FQ`%X[Oew쉉=` cyJ?<ӫ3XE\pti 7 {/u#(<Ft N9UJRl@B| ڄK<(B.m8j-G V⪑v&][_<<xhC-n6 .B[jl=1$
v~J{.,AՐ)ޭbtJek Ʀ ѱ g@|cI:0Krv
c8LT!:3Nf@ܴxhʹ: כdu?u+q$-rD{^ n$z` 1w9}2B:D*M^I,S'We2_ >dž*k I -V[c̃ML7k ~YF¥ZHBfuȢ3@7C: @ IDATVDH*.;!,:UnZލymC~=ʎ3eVd]+1|0^-ѳ l=ݍ^>qg
bw';0<5 ^
H+BaKp"T^#!0s$?ŭ7\Dv7pPʢrЯ?yd38
ģ<tkL|rXܡ+Rћ1wĬ nD`
t*x9v)1 ;_c 栰4 O.
Pn; ; /c`xD⅏Vbu*:U' +Сc{h!C CpMp=Щ ֬ OA\\:-ga}=M Dz@Ӕjq<<RΖ>b!}!&etʗ%N ] g SO!Iygj9F-ǒW LJ{(L;a#ұW#: ̯6wF@#h4
Ju3DVN.N Oƽ_B {ȣV{ise;'"2΅nln:>wE[2jLyi .Xgi?mDtA0x5l݂)ÎͿ;DL7 PC掊d|[P]W[9n}>ܞBT<ei;1s=z``f& Ւ'ѐՔܷ?$ɫZvr:% z6oZnh'Ͳ2Q|_6bå ?
~1q4
uenpZ
l =7zCLJkUq#(F
Q=5[Ȱr[C$,YbzF%|4 珺QȢp^q?[inVe^ t;]VⲅKpQBUA^97v)dJ9X/Nܝ[
p7#MQk="خ$d c|*G@mV_`[*`
Z6E,%Muq`.Ā& |x?_ prTP)L$O3nQs7RQW}jac~"J+܈ݽpų:fz9/.,Oͽ-b6ğ )Cp5oP0ۆC"k a
ZӾlTUA#"=z{9o
CLBoH? g8~ ĩN-(4>>{8Q:gرw<Bth\s''k}v ]8>%1yc
\_U,5n E-+_{┱O^h4F@#p!ЬnhϩLe5CDy 7<q1aAwf/B;MwF]{#nA;{9c2Q߹f~nr2O'nld 7 +'g2^&ݖI
Y.5` ^;0ftA_UY&K~GZG
2IӴ#4 ԤnQd۴W?sX;0 {FmyI碂ywSM21
\4J ZcAA|LM_wEމcpr{n߭ѻoD41 Y<dHa=pgG۱&+m5? PQ>Y,N<1&߹s+Ȫ,9 OLaiS sn/9 VI_/VSoOOasRzSh(&bү"#ĕFpE<=]"Es1Ǚ<r]hdoQQ>jZr
Q}m" Y9VU`_p8Ǻ}=gZa?IW?ǧ`q(
x)ÅBztK2 陨%Ԕ#ea
"O:`#0ʴ\@7gwen9 .؟w A^*Ո#@/O eu!%KD*ހI Oz$K9p *eD,$TaøÛG j'ϸ\\Z烶* 1&«\<Ko좫,EBԟѾ>Ҳr->gqx{I% =)96ţҔ,?`9N$އp@4>yo]W1o ^y4uZc,;.tD)&ܖ1CI2~K 颗Z$ ZǨI^Y;ih4F@#p."`ME]9bLuQ6x|.+$ >'Nޭl qqڭ|5lw^+q^wP6{ӕ*0avGZMw<ᗌ@qc0~_Y Ee(/kV#xJo^IOۆ~T&v00
y{꜠cU1羗eA]}X/(Ms~W݄י&ӿ
"*& ݺweT|ɞX(ߕ&ٙ{//\㷞Bey 2lF se!>|q,z]+ $w' wݍo? ?m. (?Ya:WpZY&{k V\F\}xީtM/lE9e֒Tzh7QR(+FvA1<)
u9 4Pvݎ,нC,Kq,PB*;>SՓAg ރSi/ 98qtfd\#wUzAٻ/"Z
7>gYZ :K °!2C"|[ZDo ,ytf%wboԫ y4^Qb;@Vt x ϿqI+
.ӗ=d ȢX:S&ܖPAk
!PÅ^=ƎyW6_4 V>8tY8
f$| N]x,<w~ q><c̐be^?X(?gǷF6o9>z
QAbTهQP]Q9fqɥgmO3vVБھ1,]s݇iiH?_}БZH6EYIزm' HA;v" R>ګE. bܯ6 L>}?5M[ TB1xl8ƅbhX,~~ 2 Q\ȭa1/ž=')E n5b LF@#h4lzK
:_f-ڹNC&cM-EWī/cc^8{
#d KE"b0fiv7 _ꕃU}z{S3vQkp%+%=ZWaʘ] <^2FUXi<]&EY4" )6XmrYQ~vh:x:|];^4pԓ{UD<t%٨#Zt#3M{suT{Wڥ]SD͟<$S;8g4HS >4
-#"0{C8tۯb'h<vø0o.63.5$B:X?h-ǣ>BHև (RgPv}ٰ+n":Hq 6,F OO Ho#.oe98 s
٩x={dMYGwÑ Pk:u 닜p'ņo09B*"I.mhdDQmb&oJ$Л#n`w 8{Q(H3<& n~! kW[{0by+ͩ˻$'W3 -T| Tr1 ynlY=u8^_^}^Es^ <|pn*=z ފOSwoKB{oq7 ϿUd7G Lqؼ^mnСqp;`w]fhC Wj RV / -=nT;<6 ok? ĪO+}6Z ҰN@ӯb?'LF/V G["zGeaRrbSJJ] 7j?z0TQp7|#-oܪzrG1n\1| jqp(Ӛ{zg=G9sZO`ڕq%G,G!s- ?Kx֟O)ԧ @ GF>SS F@#h49'"=d]Jj
Klρi@tRFcA1W>
jm˨ (hDh:h3-ZH~v2rܟ h,</xR5ܢS}E_CoHjF~p%W zt9/='+۩E6mxBAa2y~Jr 9#6> A [}0϶
lQ RP%EE4 _5W6T"Zk֛E{/
[.m-US;ŷݏ<֮QZ5uǎPK\Vh(_di'هe,~¹QKl#zE0+*( m7A]9j-q=>-`sO++>9⼫6/ܿ+g{rL }B@ ljϥ]oժ
}
Sb| aX[ѣǻ!&&~鐱
]X(m;HAڝF pQad?I,Zro@Wʒ:>Y ŞØbkΉtȤVZ!WA4-c#1d
A4 -iQаPj㨢[7\
_Zz9ofe [\`Q9Y B.5yjc.yOS z!$0OIA| ף / .hE ~g@'l=ͥ%JIƅ
Xڡ ם%!$<¨dŴNaCM7` ^q P$ fR?cu<#7GI ^!\72@y8z .-2˘B.U[f'VNޭ*h4F@#p!pJ]h*h8cYWǴ:sw4)ML;>[{-Z1ɳ2oD0=VPy&V\IC0#zcKkd^$&387YT)ɸU" ߗ yFSf䵱p8!m㟱W!#okl:R)C
}؞%N©d%aYpў,e '7giBc;* C@7)@EP],X/^b J{IH ^Nf}>{h{ʚ5^Fl'Ŗé@gÉ)1%s KiߜCu҃m~Ƕd/T&̣K-[M _?}v9G0 #
c_. jk*mW]>=ߖn ڊkGellnT\/ K /r2M" H$D
%J&
2Ǿ'fd:]g#i̲֟b8q bAL.Y]{=TOhu3&4meBT^f#r=XӇ[ۜH{QYj3[ z\5YfL.n sU8u* =b+ y_,1:h/,ڨ5 mCH,)"R}P1l4br D~jNnLJ<հ8[Oh孯Fd[aZc +-
8r`?<:c`boaϲ1}ÃGǕylh `FT]ն`< Zmq$Dkc#}-t:b%o{}
T/ѿ*S9JPEi 汬jR n?hmrY%Ay ^;C(^ }p;Attᩏe&L=T\@mkcSy-}k
1^}f!$D@" H!]DP֞ԫJ ,?u'gus~=` hX#rZ.Vi(˩y.Mgʛr,ZVZ_-^ZO*L$X^N8gOuY?#?Rǿ//3_RD@" H$DF :[OkOT_DBA!z>|ypxvwj~t{˨y;T[} q)r< iiQyS u@T7 8TVW(Cόzbet|ZUJ Atq_E/D@" H$D@@G_M` ƏZhA挿x)p>u/qx&Cn'
4-5ggY^- F"T"Ȕ]_A `$CsB@ȡ|B7c]^S-kď˳FB %
jyDZOx}>N` {kUӍ8rP28`Lm
j6Ar:(f2?5Z/|]q+ӠX,,CG<#k*cDŃo,4T5:^Kw^:E1OW*H$D@" HA:t24RgWO ܋6:x0j(DqFQvZ_V#,cIzD4ӍJvOͫ:
K',_Aز4ӑ\%$BXEs]a#Qc-5%56 {6~]ȗy9.Bde+hmI͜ϥȲ߷ԹL;q*"-͍ k*Sgi tV:
nfC(,3>gY'ǩؔ]8uk TݩK4f6i"\N+_KV߷l G5Yګ?s5b#CT8w|5(=y6y9
| 6SFvĊj8mss",?@7C ~DY L+M|7cjO
Ӈ|:Ǥa[Y 7['̼v.
@Ց> ~
Q 0o5S! i |T[m[~Ŏ=GPRQ.1vl4 0u)mбp̩n\#l?uKTd=D@" H$tn$}ע߈ p
\"${᧿?~NN(#~ftFЌ5r|s &U dً^{wo! ]GRBw<H5?yuy EZuq ι
♕0P5vr7OG<N<\]LD ɨk((v+lsڒ,<d&6mw,Ag= 9<֖_%9gӦ;r2|=J}=z~zf ;
݇Ly3wΫg G＊a'|(+҂71p$; ނW%|wjo<nNͳ-D iRGQE@ ~Zb0}1[1yPL =[$ uYx|A<NUa]-w;nxEW6̾C
H~O4n]p#KH*Yϟ1 ,^8[ߜ? `-[>K$D@" H$FtqnĦ/G7!6e ֘ع Z5:cG
#
!-ᝐUq;t'K=J-Iloþ= =QWQ߷xa1%|WS Fcy!*1|deI}͢gH'{9q(e`d CA- {bEy8~&!sHxv
]m>7R{~e= PRGV0z`lI.;a=Kp̑Ehmƾq25 .^<|$.8J}_}1a0x:lQ2N.$QHaDu1NWc`[n /jշvp?} G 'l]9=.0z
X} ̙6 ]h@-;bƘx838. I=tInaB;:lK,yc,~ca̱鉛40ԗІ1:^NJI^&LE<aDgoՏb1s>pvS|a|{42ݨ-1}`4uŰ}J9E; ^c1$FG=4b 0쮕XZoG` uh\ $D@" H$ W٥lv m")=Uh1ݺ2vl's9 o_Y&(;G%"5 ּ<Obɨj%[XCp&zI@}qmiK G"Ss *ji"(wpDNV&N> صk'ҽgKXȮux㓭h3.VcтETG q&|}2͋m-,+egtr
j`ЬsV ϥ|N>Χ#5- 54CUDEPރc" Wf<}Bl;t
11
+@Me%v&LYԶ_^mg ]<9 jۋʷT#ċ>愮_ (z8D[n &SBqN6>~ Ƒ"l[߸e՜uQ/hlENv Єq FšoK.Tn^ٝ0kQCqv*f̘hBeEʔ!4 h *!q(2/< \ޮ"3 Mzs<7c#\<9jC
K__oJmB6M Os p06Y< D@" H$D@"`@+b =bҌkѫg$iS'ǩ |
F9WN-3E̟5.pG0Z=N$v[Vf#.w!p/4 K QǑ}w\58GpYpj'֩)G|']`֣}Q]1 gړ/羱n1tNZ~]Nn?c.x 7q#,)psRy*{bC#h(Ķ\o s"7,~}
WG}Y/ v]'@]V>p[7 G8 ;mHX i9bf2GD, pMhۡ /=<s YH?4碖;::iEh= kd4& Z+W[jJgqd խx!r>|c%
yЈ}` m-M4A
STf`;]N)6۷DOZ J Np7k`ֺf!&(anL'p|EHsJ{/ eMgmO87U⽗ ` 4T]Z '3^
Mn997d H$D@" H fVdJ~"o oґ{% aGph#]%7QGV'N6az⼙/.>19,#گ 6o
<F\x! HΟbscl
N6hn%d2ނnTmmԀb "W^ލcǐ=Жx/>@mef@L۞r)mJ95[T (c^Fϒ+ c)%2n8"\BpHDBs[zc3x#E rUpdݝA砩w(~]<ضq(=pxj83ZE1AfXSw'`YOmt0 (ALP m)eeIx>x+<\l1wdMEu6"NҮ s}x ߎH1 _AJb|4fZM0!CZqB&@''lɰ | M @Nj~U xg=x& ?>cI+J# y'H$D@" H.%ֲۉ@ya k!g( Z Sw 93i =;a9@q rEfowG;3o~
OxrsSF%cUi{w m6JhD90VigE$69<"1ё-WLݖ
Fep:-B:jdQ5xqPr&~љV0v#f ̫眢JanJ[C# sEvH'M>NMހ/8֑{3L) ˩mn%uD 0e" xh־N}H(,zY%LkKs"}<|!F
/?w=PkЀ&7Vmh X)J3aN[s)wBiE؞wvJQYc>L;*i[]f$KmO`Ֆ#xVs m .e $n>>(,.Fq&[KKk< ćm 4cl ^"͎*1l\Za:R=) D@" H$D@"`@(|;ypBեHK>a
<LV}).h[Iq H[6Il#'ě9g9
T
w#k}vEK4v骪F!n"jZ`v-<dEˆ8
"ojq^|ݠnqRuUa进lۈ"܄q o:n$v,x}}=DҪ @_W\EWkZeceT ճ:ϙ٩ g
@P' 9ތsS]✼rŊɊw\κns;JJj|+5|־7m|nFNmh"?\g-#ojvw.U݉}\5rRףgDJRI mL8zz"<sh=!<]0& cwnjm>NmI7k|o`'F5b=3oo-~zѱڽ;?{G8 ҧ~? ش Z+;qgxvDyY)'z~"
ΪL7>ʋD@" H$D@" BbmUKӈ=V[+:g#lcWOn)ƃFԎQu;ֿ]^d*1:Qٖ1 H,} 8g㕷N@ol|y;
]qwO hq^f
Z<~JDzw?LW\DF"q|j l\iHuqK{@pno>ftf
u S,x Nȧc+Y ֽɏ7o+[X
yu|"Fvxh@ (8vTct:̇5vCK)>! ?E]>opnQ$]ZIQr +p b챘xMic-Yq:S6qb_px{*} FAn&'`xIX;<8^ͭ ukboWaf㹗}? sJ: 9b"F[1/=yƎcY ' ,uL 9 )1B^x{1[삱X)< Ef~yF p$O !dt|Ii9sXJ:w F@<K}'PE_D@" H$D@"p)ll*2hBNN
\q#rAThZ9gj,FʙTj;aҭ;Q]^:DDv拤
(%]t3jd
sgS_L[]#aO^d LSPM`DK _XJ29:̌P^NDhG>K;
wt
U6Gv#ge'י,Ե9!2"XH*+Djjl36Vx}P*uߵk8 LF+w;7 [UčtV?; Жk{tFh[梲Ŵ]AxDEVh8#=5 Nֻu`> x8 Qs,-ERFtT8zQ^ nndlv:ZB~94ULRY/C a &|D&] d#)2ؠ{XDw0w/'Wx
E͓ uUek A
N?dFޙWձT_M6!0 K[[rB6WaL /1 ݨ}LA3YFLtTJ_D@" H$D@"`F]#2߱1/ui$@m2Zv5t|w|MJ̺eN}y:BX?z m 6H} k9/։Ӭg7g4aB!)\:QVPՙYhڑL-]O[8vxLRtȫD@" H$D@" `.C)Z&,|13-
1Y.'ӏg\ ?s=ф*rGӮ n,\Sf.AK-bBBG.#^i[ԹJAڢ, Ɖ&ODm$")j.MV^/.cQ^<um_{
#[%1uTk^ i c8hi(&}4̩ .CjE>#H$D@" H t.l$o)a¢l-t?am[U¦E MxZrZz9KW wv]F1J8:MM$UK+cLyiix}'44}R:V k:YGM25ݵ>ўQ2?_nȟ%I$D@" H$cށb֫ dQ9-4P{k__fy G6bW+f
;K` 9+Ɲ/hm~g{_!㯌M" H$Dͪivq. ʦezf>[ZZ(:T:EZ^,(ӓS$XׯOsfYv2*tWW;X5\NKEfZdZԳuԛ0V3Zu#{-t$ -9px=x2P0n_%K_{Ɯ8Ӵg8QWk4kZ&ݕXKu!ק{U~DQkmf} Z2ɫD@" H$DK1}s.YN!_GݼBx,k nu f gq7tyA.\q\4ҢMBJfeDF'dGKiqTt^ YJ:N[٨;ׯnyWe (D]^>5Xpd:b4uve\l;Z{:.'0Y[+ZW[#4nwΟ?CN{wtP;;6č_
/>!_)'#1# j q&=1dj*qA=gD\奟ɔL9:{sK Ξ?p< {:KhzC`K~cƈPG;ml<(ErY=֜vz3u CrG,=8Dn WRx VU;O4n(F_VBr{G.0Εp#cWjj'&6Wm GMeh 1ʤrdx|jCDEu,UXZz=v;jKc]5ʫ WgQ/?D@" H$t7`غ > W|/Ne3 #ږܚiD8o
|nX(4( fg 81V?2zb!d[ϤCui>^}{(N\J0ԺԶ5 YS{!Gۣۢd0b̘`186|PN`C[s#&Dyux>z3 ix}hie$}[k~eL8 o~ sr˖|qx.:n
M-s1v <'ilFCU6n܈Çcͪ1ze݅]U1}jO
LcB%QC
s
1ycҼ3ƫ_tr5⩖3o7s]M
5U]=(k:}{ofyfTP/Xj |8.Ʒx/u.ﳆ*ňN/
bvu,ƻ(>f{Q͖BÃerΡi(U"H$D@" _ )Wa3x]y 'nEBdҪiJ:8- L L *!HEf{zF6 '+h@VN7u\L4 lJ
(Z&? &#Vhu d;++ piBVnBtGOFr 7%B) } a<"Դ!6>|{QPP\s2;Z~ǙqaYX@T6ߛH U3ȺP7jɿ{h'?XSӧȇ|-' 1psr
$_YB>ӻ *)QIMEi
KЭgw8<N#ɷ8a[@c %p BA]vprLj_U_Jef'3fNoC1O 89_~ WW]L ?M@LH,ǥv @ IDATz" ?
P kއ |Q!^h&\ hU3sh)Ù3IEPhF~<W' ʺ_v CN*ic9ZZ ;ңzu;" *p*)Eh\&$jZE:dνzE"? f䐏tR8M?W!gSSJ8:"G :{8@>=@WD3r3 5=m6N:(@l9ӵ!$D]>Ә· b |4ӎtbpq|kSMcjt#] ilGҙ4ۡk^>\6:#-9wF Be_2ف.~ Z4zZ{3]C:Q\ _/d9gbCw`/*щ WI
y#H$D@" #`BGZj}8ׄCӶd["!H-믧-^8sl% < Ū՟{\""CQv%cYp7 w-61v)ŀ$PS| h04!vܵ 2^ A
\Exy8`'/D/]= πH; ۇC_w<1m>U/~#F *3_xX' mU~*gYz(<^Zg[=0l` ;~
Ͻ%܉x> r :a0Ri{ʦxaApw `ȸ+`!vr1
킺<
|3>.
>|iaPb/;ǖߋg G>Èm~9 }ݏygß7 DŽa+l#7] DDBWohOD8}F`ʰ\8UG]#z_07Ȁ϶g+_;ϛ|\{|A!m߷fbqp JsR|<o<] `ooo"nh{a}@ i܋BψN?ҫ^] "]tӖwt܆J|!}31XvW1m "Q~<r ZaP+oT_v A-M :s#8
k!9)p 0窩lģw,Giqņ"/_"T?h/EF~ġay˭O wDh I{`z"ve+h.#ϼAcĸ}`0'KsfNûX(C_;l݈ 4 =VL7T[p0&Nd{R
E7#q(a]>Ͼv/7)DLpl۔DH8V~<jxz̡x ;hx-Qچz|{vi琴e \iDAxg>rZ'wăH$D@" sQm !ϯa=G*3.<u5JQQRZVdg(wNܽjH;c2q-JQA<(E%
_o]/dm?u^: U2*)Co{Zi3{։[*m[I~rd~2o'͇ }W*+?Dݬ`cJ~~R^Y-k{s1 Skں$8d++qpW<+gmUu8%VV*ԖҲR%~e1i$nvT1G6#iJy^_n+%7T^j(畞)9i7 $g]P~ }(%5-"-/;S+^USxN3D|8]14)
gb*Uj
RQ╃\[pFٯ'/TY揔)<ը}GوT<uL S= 㕔0m@u ymV;UգPbGWj=S%zB%g0>5 J;(|])SZnT߰BS]2֧* 55JYBc bIqQjƪ"c9V+>urCS*[IRg(ޓnW۔MJ΅bB
ʜ{^QD״)Ҕf,7U {xNX~^`:뫔 EٹeJzab0)%) =7ެpUK)RP<{e(͊R}w2הc 3N(]i|~ZoyA2 ɚnS}H/S ͵ʚ)C>4XyʒI<:*E9V|k_UK {S,wSҖz aSܬ$AItr\ؠ457)5Օ^=uPEzvQmضOW*kRFO N2 $D@" H$\r6`hiDܔ[j[܆W^y mMصi/G{ݔY +؈SUZ)Do;
+PNtV4iw
O}
vHĨm@HW 'wn CfvPgϞAr4ә_ +P3|__Ug pO!]$/IGy Wlҭ:^O7oيYEd̀duvPF0nr L#Vn"{b1hh rLۥw__4
ˀ;m;gU˺,:} u"h'& w/'KSv3gdg!Ķ}oǃ\V6t k/{ #\^F{ H@PXB|we_t
sZmo<#m%hhAȤOWjqQ!MDr ~~{|x3~]X-;
sQAGh OʼnR`ϝw!mc*p6v%*d7G0I;1t\y < > (-oG>g7o<rHw`X@G#!!8͍1?ctakLH
2rRPYHŋg 4;- z_.SoıDoPny|ƆatWO O[DzL ڍV< h.n@| Uq<i'M>m6t
pB3 rCWԀ Qĸu ..xP~![lB:2юw [_KbPhp5x{ x-JH?D@" H$>w%5m# 'cF&PAB8{ d[6\/ލp">-$d*5 h0!qn{C|ږ{ϐ+6"s6tі> ik5Ye3o7#SF{eٖV[[;"w;-mxꓣ
N6mЇQ>MPv.H$=[wi#VDA%466 .$zyfj .,Fx:*hJV 6½(K`7i̹ o&R,Ă#.. -d={T G۰y |[~{
"ocm>AW\hv|zz!f@XR]Z7F4@u4 U0q2vrΦDBmm ~(>JIE6
ff?l!~ 5sGW[;{2R6'he }ƣ={@ U'f
,Lmh6=n WBA\ԓt;ѱ7> W1pbbK/,v ;2:2CwG[d) m݂GbCg:&|҇ ;γWzzj-Ci~mjl\B^d}Z\ [cə9{6(b#bng ӕ&6$v릅f#1 @6X0|wCG
8ⓗ 7W@+tL<w
ogzhrvDi k<#MdWh_#QtWD@" H$_Ktg
ɤ lT :08y0 E (g5S2ﺐwӱ\8©2J;%j -5@03,[8 =ȸZ5);W + RdK"g6F=|g_{b̠4!b8yBvD(`[Ro', i&>R_t\
f b;8mK"aط:\9<z1a2j#:{aZ O%m%
(/s#gX"%f <EgcTǕ#go̺ҪfI,;{!~sCĆ4<d9)ŖWuNEws9 go/}F(L9)p
<&Z֥Y|
lMh VT{#\u#H4*+h21֤ofmw"0 27!dAxfT=O0cۛ]X
㦣h*ѳcz| N3^}B1pݷ3y4͛Sz "?휠: nO6e L)(UبDfO6~GQ3Pu1j,3`i t huA~x2X]ӀF¥<L?_Ag<-FNJ9mejLM^@B=qb^m4<ɺH:!d:ݒJ CȀjHJlRYH$D@" H\kڶ FsiiA9+|7鋤n遧\p
K+_Y#ZHYu
3V
imO 4m\I.!M&eΥKu̸y) ']{7c$^}:|3dA+^~z˷^?
< !i eO3:bH =
eHpjŚoAgRrL䀷5dm2+a~8}w퇝x'EElzwJMG%T5ctB">}~ ۖ,EKi?RuUx5 qn LE'io:U '^, *s5Drh}oDaľdދV5 %CV&3(4t`h 2Vfln@`aa2Ŧc[{'oI}^s { O )$ږOXkTK`r8cë㮓ywངWk&FA:~ T^Mwq+_FUdځ8]'^?ft LӻEs1ЂMYFN*)-#~cЧG)\Mniǽ d
L IFҾw@'BBP3<X0`QxǏ1nL <ʛ&?YO`^}8T& p/{Fc*Q*z
N+apȧu8>Qx! n0vGёo y;
Jp/1+"U _~cŇ9S0
*?&@<t
})<} ݁Wn[s U5"ǨmchgJ`s=Yq1i xUȱz1 :H<#H$D@" !@ +f e\qL=3iBEhrt9'xa0[7$$&AY' *) GinJA|(ZkFdl Dt}`>݄&9gSIV9 K~C/y,{p<9ړP 1a
G^]LvW=>CǓߠp=68!ChZp Ţg@ m[rK7 :FãQ%0` }UC5?Nb։o7 \jU5 ~ kUZr! {vA~i#&Aua&v>@.ig;xGV {w?O1`@xRi%ࡣ%yѴ
=~TSd^hAZg!brd ݿ,G#A6
y` Gf^1G8 < .h jg]AfdÀ' cPI'#dU-4apXr3Sk>4& 1pm ,m)swݎƨ357tF" i{
-pF|@끢T`-w# }NQ
ե8x$z
rvd s-]1j(Dt&7wzC8p4\}1adtrqmi ND<{xp7prpsH6 ɥ`߄d Am+#Mػc;%Og 7GqrHOA9eXN/Fs}5Ә ' IzΞ>}Vݼ0ppuq)¸ ~!5j7߽Cq ¹ ?{H!Q4"y.Զc~K!8rd A&M zw=C" t6#H$D@" +#1A7jtrދ TN<>/-ʢE-.cΦ?sLw.]+s3di==B]q\-Z =Ev`u 1aYFFEYd\u1@/GeTڤO21$X2&3ڊC;Z>^^OE?hVt巐c̠K1<ZլlLVM )¢z9\^{֮L-֜_T.s~e o@u-i*H$D@" k"p- }ds3k Z^#ed@<S .|,Yw@ OuΤ˻LV9Cߺ>MEJU ,j2 *'?lg|m:KZ^A?U#B !2vT/M"i-Le3TRa4U^Se FR
'!4a0ʱs@Y>4E"|GiziҌ-ku ,(jbQVvxS~Y?M9Z֯Ƙ5Z.
zS6˺j hrIoF0KW렗e&%D@" H$5..5
fbc?69.H>߫@76kzf*nB5I6-^gJi"EkDY#1emYNgYJYMWk4ݬZ~x~dhyMy:ta{\V+Cҵ$n,_e&J]6h3d Nt nO RXե3&y Xi:9,ҧiDQ&_ίUqM%2^顥[xqq.4\XuiztD@" H$D/ t V+˶E1 !bctL@4/Jf#_ofhq<2'g4Χ'LE;ѽhֿi 16;L+N=lD@" H$Dߋe :CR &Fq{)#?s uȥ0j{Q|GnϷKJm8#NI`](I$D@" H$i.KYB9 x9S*r+Z n>ljE䥧T" d
M%
ehNqd*m*K[%[LrIX xIG#-+a/T2<N U#¿:7X74.cօW-
i +/z0}D&] [jhDžHB3Y
=`ڪr䑅oؓ{ުf !])pv\deMAtD]WufGɗ4Zqpn,CE閺.0~zƌ9\V'?GKS Wՙ ?¯0ae_gGQ- '
9r+KgV=#'`pэAMW.?վWʫQq\Z= ,,[ANF** =tMKa crEOsq'(M#_J j NZ^]{IqlB D@" H$D@" HȦq?uݰ / 6-8y bnCN>ͮ:
cJ(H+AOo5"`MdlLr@.A%1LL۸ԙa"p%Z5h:]V_n8JL>ۡB__Aҁ1Xj %wl-xՕ8c18h'_b͋0;߭~WǗߊ&",m9}ǡS()o==(am8o32#݃=]k,XS
J+v|6`"z̴>a2gc'Lm
ppZTO=N|w ,WxITśvC]l+"N[R'Oɸ4a{<QqLzu]kUfG}jjܟ/Y5Iqݣoe1x3Z?ULQ}lc9cʤ34=[=$ݍ:͢ H$D@" ?@]C}E!_ z^8s#|F>u:_F [{u_Ow! q݃hV]E,#Uhm5A!ApԴ2ZUY{'gPTR A0BVT;w3
5ȽP ;'7Í||Vl+**H> ()O ds@qA *H;$`dL6|77
Nj57FU' C]e)r.a pʹasbzL"QvTzs#0e"v3^1&pu7h<}qMkahxI쉦FxzmF m.57Ԡ]]\TC:٫S8WT֠4/΄_!T.!,J+Pn+7ښQYC>}0tʵhrdԭH=uO/)cי|P٣ Ple8kG>]PVۄN4>v䢲
W|'('? DPJc nNhޙ3 X_v)n"l AVdg!a䳝vVbuPWC<MTxpt14R<(v
3OAmuil7MRqD/bGS#@MU]]PRXv[ q sE4aS ;gxp36v+N,Hvk3Qo__^f(+eڪ
4 _Ғ](#aԟܶ6=t p!]hɋD@" H$D@"! QD$aaa3j[SOWb۠T٫ {>$D",hڏ^۱H=y/i6gctCP= j1DgXDNALy<v=O? z(
%e9mwLJ k^/|CBpxǏyj<tup&bɫDd&ۮB};B#{^L
|U;ö-o 9=a
mp1abRG={Ub0fX"|@V݈/_;*{PCJ& HHP@D
" ^C J*)3{')>יݝ9sf;qT<: Aa}}Q'0didW yx$ DbNwh\ Q0!װzvd)>=N4LlW_z v}i?}^'~;ڍ"po5z2&=>Znzu| -Wq[֥rfc
z% g3$/͚b/asi#9Xw&
[.¬2q 2v o>6cxn}x{O'ɀ؎q~ rakHoޘIU )qQ8 ] CA2~]
; Ů~X'
ƥp*=x cqF:z
/~3~.(tm1
/g܌<qhҴ!Rn\ ^Sp-x݅X5Gv?E Kp+ůΟ4N>GޅX kWO >VlOE,,%h
a~vz ^}u# ƽIp/Ŧı9Λl2 ւrg>o̫ȰQE@PE@PȰh+R>KYsW_~QkD_miӅ@R
KZbrsxp~agw zDK+guu5ZKMMlY)#dߟ8LC#KMbiڍ37kRӴ'k7bkOYtfDKYKP)ڙmAn.`Тi;v 29Ys>g$i.\'iֲI8;Y{{Cvk]Т.&쩽Z-Wg$\Ӧ覽hQcЯk/~;++@/hwJ3#zjJrS:j7 y+-)<+ǵڞ3_; >}EQzzjvۘ"mj|$d\qux>}-K/_u_;p*RKy]7.mгYM=_ C9:6+vk66('E{ 4 ;h'NRo^TOZIqf+ZS;V
qҦpMnߊ֦nhVZ}<sڅ7{3 צD)EՒ A{UZl--V+PB7i:]|A{uPmZlr;=Z"ŧKDm_9,Ԣ{~ϛE
Rj;1Dvio~BߴL< /_<E]ҎVCtD_?U,-$c -.)Y;gJKiB
cn,ֲ
dj۶2shMj
Q8G6L-')RMږ˗/k,Ҭh#t
3ⴱ=kk -ݤJԛQ}jGWƐlfcڍIBkL9E@PE@PE@ ȁJ}I-K^AUcx9X"oyfJZ||w(6 ܼ\\
_bx)<e 4=~3 iI1"#Kx G~cת3#| ǫ ԙ媃jX> >H3i㱼8zk kz!FONS!;w-7 z6aCL+9uěس02og(;fÉFj]b+/bP6";Oɀ 8qh> $=u OHCHhFs R|6|mLwPظ6e/uQl~OD3KqoeKS `Qxĺoy#5VX
MSD7B| ;nZk냔,FAN ?[dhlw"Fchk D~V
.k7b.!ٳ0f @eq%m
GU
h݅fB_;},߆ôZ>S^ˈhz4iv6h/oxg Zf !S3 cl 鱧(|cR7 Ȼ[6A: {ލ صi^}c!0N0d2
vf6o ]F=,~z˚hǰ .xl`JgցpQ Ь" 2gwڊiTHu F;A׀_.8#8 Z(A}ZfF=HO
zo`xd2O :.hn<?u2:5 dMⅩ=ޣ!"BѾqbo]e\ 9(}
kx|`kZ=W!wA9E@PE@PE@HhU'\LkcGbx9xwg|6CsDmбp0#mi+4.|07DkѬUYEd%ӵsv#ȿզukf+E.- aC늓bq31
S9P炣}Y.~
a8 E`Hg||#ri0lh24hqVhڼ%wD&dl\uvdY]n5ΥHIГm0?g8,iu|}hi
+oR{Ztw HHGui9
ԱqZI&4
|dJJiy+~*7\ dmR_Fh*?s ncŊֺ> ,`oW·;{xB;I^ԍC$!:6 ]3뮭<&e &7Efma-fG{ Gb*]>u&7kg ]L
n6 D) }Vvb-4l L*7[+).vB$omcGj71hAi6mށe^gz竈nJmrb
#SWߚ?pZˑ+Zو~
٥Xf=B`O;n.^;?tW9.ZdgQ &+0ޮ>řv q!6GOF4("("'Pz2vg.,(DvaOÎ pbQ<v c61
ˏÍ!ydp|,t<\LLYКlgW|e/ ?ڑے
R2plpR:ZƨFgYf!@z PX2_^+* 1`ttMC<xnq.v,/|3f=5BDw*#g=sdID^ <tEқF
tn8 ÉB vd~p垇(#On
Ƽ-p g}p}Oߡ _YOƞ
F]ByXn lLg2
73vM,IƎ6CKF-;fANj M#p8meLesH1#ϿC&,^Rn\D5d4"N.''fP~n'9 <[Q ݐo9FZoKYю d wF/mf(ۨnh9\Ti|r>8ɚBÊ:/7:rԧw$+/Nc"}}=G'RlA:Xz=6:N߈=Cɠ yg~ ,oE[Z [":xq>^}e㱶?9{ڠx4o jCC!A3]F-zzWܤ(."("(<[W`SS1ehڨ19a͈Ds;s&`YDF3͓mŦ-[вvK #yYѰ2N4|ۙO^h{!
{ݙmpߣSCM" 7PL#ҥ<w?]D:OGϑYHZ94V6x6Q@ 05U}`@FXD33A }x[ me;Qg<0$n
hwd
KÐ-;̑~x4wp > ~jcm'Es]-G.aL tj'/Ш4D2f?4bMť-
L-3 u'ud ~+"i'A̜0L }]
nM埈!bˬg+<<}g#ԯ]A4j~"BhZTm\ O {G¦ϡ(-#G}Hp~yp4j- ݦ84B3.&͝==K&Wl+98~5L?w(lsEbm'ӐEElKh?1.c1ܼ}زq2a%r6ؔ PJF=I˚@# qgG
ۺm(ڻ}`0:)ش "Gm=x-]#w4 `ͨ@Kȅ~t¨ǧ⣹DnzC: 3>!mvm'/O#CBQE@PE@P^&WeɐB,:*)1Y7 G}ذ(\}0|P_4kڌP1Ÿa l :SzX
\@݆~hL+BM>q?4jw:' N|GNF̭h۹+ڶhHGK{p1"
=У{w{ '
3OϏHpa'£~壡|wHm:'<5
߁ڭ־)lh}_mmA bM[H7eNx9wP_O Ղ+D_06 kmع6p;ts]л
[ؽo?N:R0ަ VOQ VMZ<EuhzW4ClZ6kDӿu#27m g~`x= i4T?Mէ#|е q Fp ];N4`R 4C ꮔ q=:ݻV:Kh䚇mv܅Ȣ:wZ] m4#-Ղq+<(Bx݆4ez":-(kר5[d &ϙtKZg@4kP VB|k ڔ:iVnU/!^2<Xit͔ahD]H4 MQ^8n_^(z7B7AC(!iZ^n 4TQryt6BX Y,ۙصs7 ;T8
mu CQ'bu
ZsVti @ IDAT!ui梬JtX(;b~gX;yδD:P]Olz ~,L߂ xߋ:P[#j@/ãnE@PE@Ph0x+6 տuͦƴHqvÝ
ݱW[{14zA^ hB< 벹XeXMy X*:R~y3#4s)ӥ+ǧN
D) JLfMQ~O
مv3
UL T{q+'/7XC+2ͷ֫[цltZ;N+ɬ1M;fV _Cid˳M'bЖ5VgݬMc8w\;2<zo `MȕQ\ wVPSVseiq'N 21u("("(CdqL_iH㻦L?k*3OGgûܸ,"kb陆Wuϣκ&/dj>ę@}yU?u
GV;;٨Xwj,WH nOտSs>7Iۯg("(" Л25h٨l؈|_# 6599\#e392"7&:7&t07
zM~XFIo)/tA8\~(#DI/#*swS,MtaQ^ j9LW^M,TH[e OpHii8?KW]ZR'㰲Je,4*֕L+_g߄uU8emUœq*nL4,<eD<3Y=LrE rVe[1Qi_E@PE@PEIȇ?nU>x3ʍ 6x~Ylx?6,t\gvXN p9 z*d
W)kdiCy=<ywrJD*n7҃+UDGzwY,L)"("(+
tahT4"Rj8ҩ)Z ?CyG٨T*UWUOs7Jy4OWXt}5ɚX<s5{T.GŶo .U/yWn ܩA )"("(U5蜓|ڸ*/@ZFZnn1Ɔc_be<jXg|(xΦNJ褭h4ݕ|Fq$P]ݨ 5QQf\`WUe~Ƶ%ŅHII\ us]UT`夫Xf+ss
ngeYII<roFlve?H ܂"{>]QbogFy>].|/7r2W _ qy~E>eI<k4KmY dz͚,ofZj*` O2 Rxc^e?1 k# z
:X5D_S.տڷmMkیL_1iG*m.b<\>Uat]z
J,/aY$WzMY\*(H}2 .HYuUE@PE@P@砋Oql|RxcvcǢSU~r\TC@ d]'sMa$(dXAn&1 :ZtTUfZ1#CK
*!ٰS1_Yj <3vG_8=gna!ʅ;g b0x]\xuw<iMǦI>s@9tJDǍ锗rnK."Ƽq6/ƜLJo;1:v/)Ė ?GG.C̥
!! MsA>}} N4%|;S~=" VG6S6`h Xxޝ$ʍt],Dٌ?x氢\,56)c{] U#6 V>.S^=`⏄ F
#6ݘ4a!~7q@|ɶ!A7f]\8 vBNU[WW~'_<vyZc`׆8y3Ñ|*r#!W]>jxt1gYSgeُaW2 S^PE@PE@@:G0~ VL$Vgecy{:?E%BI1 MVmmty94M9(%YVQ[XhghF-iچۢRQ\lmh:>
Gݍ1Ĥ&tF[䤯ќF1rr(0+8884tcFCnNN~b| Oȧ aCFeuct ϢW^pRD -鮸gWxi艇 _NEf- `gC)2+aM\y.ή Ġ*GCqq1Q_@Fi8ޖ`Y/&c؆@嵒uRR$FTNQw:dY,v:~9.⁻ c&1@}Ѯ`H:_/`/g\9s {Af5^| z|:[YF7bt&x<,uWl#QF嫈AR;,uO r튎+E1|o ^{aim 7Wgcywboei CǠ91Fa /kNp=1۷q< ڤsXNN8欐ڼ8ꎊ#g/>; Yrybޒ.h͕|T)o 5S\ xťPl_n;YYpc y6K\J(}'#/efU (Ңiʷ迢=> b:RUpb Ot=s,车L?奘έϢwXw}kvT 'Q9(/VT
Yl\w:Kz}؈aFJՏ"("("'TkK]@6hּzŹ4 ))˹ BFm͏hQ<:;ZOaak:Ԅh셳7aT2}Pp;|%tmv,-aoMBq V}9Jku.Z-~H<f>1Jsht7 5 >HK3P\f=1'g_U?.º]GAl^ ͚ၠyF͖=~ Ydfq0zpwXnX " oi"
?| 2AHhG`Yt3ڰ-F/ڷ(]`ukߪ? P
O 9 C5c |BµXhD' V`c@?1G̿Cl9x !(qq[c ^q~!/8AqF0|z c@#BJ$WB 3fDH#_ 6C-O:c
e G}WE }W8s%{뗄v
}9~h}_74i
e*Ѳ}kd$S1N`kxttj[@ g wУm#a&\idQxp 8 V.A||m3ry<cMM儸,i9b8S`UӟP"[l{J]ģllzj#4~X6.ѸL> ǻd/]q\E?bĹܩv^o!:"¸ @c}XR'gĜ;0噧)ذ'9Acc#IEYN
eꨲı=al' (,[ Θ0e*$~[o}
߰0Q'Wރ1jx:vR'M&KŒ 1e |j* {p8]파gGb<~&h^kL>>n4{8{gQ'yw?)qR$3/߀w ȃ# on[]s1m#wtӦ~xbX̐c6pT "}f>Й{7cѣr"("( " ̀jyĭFVu8\['{g%aˎhy ZǑ kѥ#68ڏ{iïcI#_W|)EΝPOyWi3xmH"iͲ/M#n3|YL8> 'b 9[ǼG=Υ٫1~\,
j̬,]= <U]j<ݩ"
Â7qC bY3ۏ3^o._9r۽` {ޝѴe3ԫ [Gΰ}qEZgg VݥkI
ȸyv̛O~: *7oLŢ@7g:<l
iMvЫpg[I۞;o@o )ƑiЧ31בZEQF,x>b-kcot XړX7mSC .7DGHBAW˧1dLqNdh[굛
h /G[Z̥_G+ ֊1l<>W?) ׅ5:Y ,=jahtjx)Huj|/N{ ߎ[MU@-8n$"s0xp[p
{mnhت
Cր˾G/:|l#bP;\<Oԉ0` gR^_Eo^MK5h}Rc`ڔIq2z { mb 1MEm9l{/~D#KM yx<5?^F<w^{L{ ێ8WA<g%` q^|
JЯg7LǴyq1ft\Kepv3f3##<vHםu+ 2>z=ObΚҬ}~s}B#ڷo] çxw1xf8z97Ə#j]i`|a+1d' V%X[X}6_} o6)>B6:2ۏF^.PwQ?"("(rׯֵa_=}fpy!4 4^Z~dlixB |D<{6i3@Vu` 2^@ܑ "8bsh lE{K:
F`7x~xH 6D+ڤFl<rngՏ֩(?鷢P4 A-Шe!EKS>4}+"_yAx:$h3n}?~ԉb"ݨi =fO :"%z 7 #U.nyo([~F" Ҳ+լ
/ D9=c'SC]1yL_ysb, #v@ӶH#+bFL{g7?thW^Ell*J aBxYVK,CԱmXy?u`vm|F<zR'gE \M6O}]6cQ 7n4ə Sij?`($}8&TmlQ/SA]1gG= s hSF 0x{xj(2@ʠשC#YXa:6 >A 3/L !ybYY4zOhunWb9;:7 '
)Xl(& ][6/W}Dzaei1iÆ(lvAiga.u>yьb209>3 Nykk3s&C%iggLB(lG{}=[| >1Qqԙc|Lz`J3ex 2iEmL$V[h&MZ-.7oҒ\Y"_`4eKa zC0o0ܠA/(% )q7y AԒQxA-/(ĩH k ;p|<6Љ\5e(:>6⮜CqeQ7Eſ6tD]ԷCZcixƁ8"PsIԯ"("("PL?> ,W.!:.Wm>
C`W7R2Jhn G7ᏮCm Cc`ҥ7nA5-lغFP`xjP87.].RExcסS5 -N۾qSn;cP@ dLZB#'#Ku1ψGƌ:hۨ6 -DLrȋ[~C F>:
'.AK#ζA4>
7.ĩ /;[ѺQ2,ɣJxd Lkp laN np ßebD dZOu ;7Lb;
.B'z
vQ yh4; <L}Cpi٨Nj-]Z_U[\nKg Ǣ ]aٱ `n2K
4
,(-dIz9~y]3; IOq.D(3M*+ΎG-mh?c4CjWӯ#m^g̿3zؠ#Np0.?,_Vn5݁F2dxu)'vgCoe_)7/cMe ,XUWN/PQh-w!
PXkr̥ BD]0: _? @4PI`,B # bL=;B~
Թ+.
;#k^A[Q=w ZXs?bo@U+i`{Nr z ފ=9 #Q+ '?Fvn. ; ߷X|NKae`bg\vۋzs?݆֭I)8s|?Fzu} Cvܻ7}a% oH{4ڹ3 |U֢UE@PE@P P:ɱ<~]̞,\YѨ-YiY}v
lJ X&UnF~im8}tQ0oֺ{?x/]& \ o5clr}+ṿœC l L)#emup0^0{ zS<1sM{/=5T|df#q 7 0/aCf 'rltFw`go q "*3sM#oCִf-(6}ǚ6swMh ;$Cax;XҚBdPZ$HI~MG|@k ؈߮Gpa^l0 Yog'FoG^ҍ 2,h^OV C
;jB%quĎ7rwsF>xbKxyĖ 0yL~d8[ݥǰ ̪Un\r;g/bel"!:E4Fh|4mg Gh4x% qNh R\7bct+KgaPGK x&# `o W0[htgȊH$FgMMxAeGhB" o*HR[M4CnR 'EGmwh96 h26D̚+Ρ2Guhc4u ۼq (
kgCƹi_Sfg;d'^ħ}0kZr,u]Sg'EqJsE0'ڏOX k7Xg#h^
>
o2j覆+>k~fu8}8
=u4h 5X%?,BRue,쨛:0}y'\_ΛKr4{닗R۷写BQE@PE@P yWY
vyYi8A 1ʎ
yo(ƉX2h M9s5v+˾y{Z=fkCO) Һ1nހ.9M}C`>FC}Ɵބ&<rΒ>X 1> q mf<3n.Jxtl\];|}+4]ޝyNWp}Qk0Fdl&# q|pム04կ/,>{hnrrN ڍ""yaWq!D^B{]N
vO;y4.+CulȨmD6}W {g A3 9Xp! M%Sv6^2v\p.>117s-6lRwwȖT+)7J» c@ӕ]GNHF,;pGFhqܲSo_4O]C0n<0E ;ػy%Z~ /| 9C;uS]e]ŮຎR&fi@ 7~ 6Y s ~ ܸ7
-ޓdY#;2zDd T >](uC=S_ÑSE;9Li'ѫG/<< &QOKTz*6SFr,% =|g`45$]GqP+ȅ&lJpZ~[z#ZB[QdX܆wmC>̳Z㐔TSiKQ 6x:@'-= ;
t.M"em6[2leNnwY2 S|g їrr/'^%9NޡwW4k&.CG:Bg`=<: _ARb<ڈU߿ؔLc37L ;O r"("( !`2*UJ;n.vWi@#mܾCHa$ ]GR#9h`e@_#c(( Gzk۩zY pY-ܰ"?Gliw@Xkظ$n Qڴ
BpL!^m;0hJeNѯng<<r ܝ u"Zz4e|? ܉IŘcz(B^` >;A,֯] אڹ9<\f%Yhݺ5",Z
+D4OʹV@ Mw
fuzVz2hTcV% Noq%6BCid4mi?FX?gu)<kե%sMSydN7~8ZS턶tv]Lbf6 iqO24nf ,[ O ў !eui.NMA
uhG1U 쏦uChDSxf_9kXi7&Z ӵg$JszL3Sigq;tމBBqmթ |ݨ
ehZ/I7-ZЦ1S'TN&4*'V]tBN:~ Q͘$x7`=y@HKѪq8ux6KhWȸl |폸x VҚE;ڽ<V8l3Niw$h.5:`-:se NWZAH?)jB{AG}i@:$kph{5=]KsѼCg{L|$8Z4C?:peD8.,7-9ڵm-dgN
h߹o#}Ƞݢ#!
/ updezh١MMD
Vڡ%J͠>f!N_'GAqUm1Wqle1!Qg[ 댝1yQ ٿ ;O'Ѧz;:TvT4wKlhvGP7n-`s,g\8w
ـ
-E-mZWD }D>FoJԟxR?"("(@Dwd gEKThQB:GY*!Ja qqM~Ad#>y8X(|0,pwB,|}F㗟AdRK . cGomZ/m h/Ϣui4⟑ ڹɕE?dA#v4-6AD)jƳe iTq6'*^F
[t\/O il
RS3`ikOOOZ{KǜѨazF\FS
y<En-)p5:Kޑu2fњ\M[}~< t56 !|dYp? a1jf#\> >^sGnK<ڎ=xR-wO/: 'ei]3mS1 :xK#d|'%'#f$yxχ`ycqlye⏁Xzj'ʮшx Ms\: ۏ-
iLgg3>:6+'s./tQ^jezvQYz&xii<==PNr {wwvs)x$YwѶ n{:W[ u䤟/.무nѾ!ƜO 3z ;ȥi䧐"z (=>Gq9-%-t> ILH@Awϟ:JQJ4]gg' h)gCj>p6d3̌tz3u2S')dS{yy9z[2)+zvm_O_ozGFړhOW7zhʞ_+X<S9E@PE@PE@ R=g 64Tڇ,-٣<F eo[!X(dBgiWmKzy$ܙ~?yNlo)UEB v ` _b#i7G^05qk*q+=s Yu|N2>_MO%}t1+UaRxUmΘAS2^ɨJfv"edµR]r'^ ͙:δ. w㘴kWm) tN:̵B> \3'/*ׁh+˟i==%]U;-a̖:S(<͒)"("(5@͎
Zb69
r0oS;7PiKi5s9\iNDDp헤| sÃr4U8_yȏ?Y
TXЕ5BӢr x%O<s<v`y?nݔ^ye|G>G`DQat\A)@><rMHIJ|Y8hD2[(ez3gPA}m4ܨW023:++ꓲN
'ә-Mgם( Er-zL0Oc#> `׳./uɫ|g䳼VLuI)_g_:d$+NmyZtf+;фwlC{3퍙Ä *twN;˪O'y>([[_%4M4QMz*"("(]?Ju?OcKh<[q2'E@PE@PE@$1%>68ٙ2}]F>`N|H^PE@PE@P],Nb
QE@PE@PE?@_&("("("*oe (SQE@PE@PE@PEPb)"("("()e82E@PE@PE@PEPb)"("("()e82E@PE@PE@PE)ZiiiMU1`*(OE@PE@PE@P1k5жTⶣ("("("iPZJdUXw4OGd^#u9C.M~$J$ Kg_G:M7{;kUy0z'yY<wyϦ2Uq#2U0S]ɽiR ?uf^ݽ.S99
37MW& .=>Wu~|g)oz0Y
it&90 gz_ StUt3/iܪd2L^ _^eUUpc*c f{*uJN6 2K}U~2U^^g Te3_UU?/%&?iql*g'&L)k 2d|530OizaqtR˸Rj &uƗ5Kys 3˛[I Ug'䫩+;O<T#Ǘ2*e|y4c.'e̯ ]uz 5st5\F>^M3{&e䳼Hy)','4gI9s 2:.Ite|y2'ez6- /gy/}||!*]+ 8q6l@PP+EV "("("("P=6KJJDСCn c[P@ʂm @]E@PE@PE@PEf(zuFH_PE@PE@PE@PZa\T=+"("("(@5װոM2qgE@PE@PE@PE=߳\T,E@PE@PE@PE@0'PzVE@PE@PE@P2 J"("("("pG~G"("("("PUiUE@PE@PE@P2VE@PE@PE@P @{*"("("( P R"("("(C@WUPE@PE@PE@#@#\JXPE@PE@PE@{(᪴*"("("(wD5Mcgaa!^:<z
hsU1?GƟ_1'Y"~4Q6]R wCgE+uWyĨ~D݈ U+)cB\k?*Wu*}_=\z IW+z7Jӵf[VU)$]\n,P]p-b~.d9UPE@7W,:_TY |rkqUU2̕8kiYD Ӳ6?͔i\i3T.4#{rU|^UJOxu~︀SUͪxV%ՔrwzgYI\Nꪪ0{Xj %^FW]RNzzĿJm࿗5"("j49-H+))`VVؓ v} r u鷒q+-6. 5X !23Ҭ'T\RTĄDd~>R \Vmu?e
=et0lməSe~z+g=_&/t#1ܬt'$, [{GަL?X^
Hȣ4;Kюy&֍$Ԕl~^pVrRR =l,;~Jbxy^ٖ '逍-IΪԥ;89$u+iALId_9y}X[[;ĺd\S}FFy =T"e΄M`(R+%γ U4
Dtw;[ "
E=Jdǭ\YG #Uܯ,Z R{'WwN,k`U~&$K
<Cp GWʣ3եE@PE@5kw1J tbmACۦuI)]G g9z N8E8 5N!<6Ƒ (tY5}dzuv` N#Ί> s2WNjW0Qp N irGqUSŇq
,?XrxdzW<MY9@ltu.g%8q,3n.+xx 4ڶouBP/!;v?,虞qu uBz"_A<Soy%18 a^6 @RE|G" lG>d]boY >9ŷϒGW3;1mLS~{<h$nZX #0XG""ԃ7j ezc$#N3iD^y7] Ym. O<5NBWQ ~f},OA&HgErt GιbѺn d}"Sx;7CO ae'~.: %"oT6긬zN& FfH >y{r3]?cYfbsG+PƷ>/*ЦL{zKKh&%r~:\KHO0 q =E]pp3Lڵ~ z8&}@\.ݼѩ]Ԯ% I8 q39d7 {?b ^齓N^ WO^YذbW삈""Ez BI=93wnn sٳ3}{v$n7*_V劏y'rg3F6mBQt N7_cZ: մ$oq/{_/>?5lE<c%+xBAt}Q)Io`,1#ޞ^N]`x͉xyFFFFFF@
"{qT]{P]
ICY#d#xmJpvLz!rm@^^ZK9XB
6,>^Oϣ}B3% % R<Ŧ"\QY<tLx2ӄ;"K)r#hgPxeM)`.᪂tr*O]]Af~q{g,כ^
/?z#<jͧᇝVMB Ik!QgP+7GĀ3c>X':4qUz
Z3+73{Q^[e*<
Coͷk %O?+o㚟L e]EA^wSz6~t^,:T n*(_YpݘgY8Ueg},CO)Tx\]i7nۺE;葶'>&wuNqaǺ=x{<`k~ @ IDATUH Q)8_Q^pkfnNxàV|IJC%Q?(/G]ճ~ziF:3qc$WӞ
7B_IT3jKE*/T>$'ơYb{pOG64jplK1sDюpŗ a ҃8Ԕ ŴOOoqKٴW\7dөE߁Vz? -
ibcp\ 5j
CGf~D [ Z+ JM4I[^.(wOQ).$ o(@:lj׀/Gcۘow }:nR
zYE%KFFFFFFo@
9U<5 ݧ~*G}w!+BZбɺjd Ln%/Wq|| jh܁jD B +2 Bߩވ ` ~ Q)VM%233"+i|<
C ~\M-d JGfV6DU -˱>s2f\9LOþ GkV+#"ՑHFʫj[ *2|h7>IMCIYԶr^YV nQfTgZ]2ӡ'o=QWU-0i܋Keu
2 @*>2ltYpf(.)c9+uV-Z[җ EZZN>RQpPY8|"c rsaW $,Qj 38 @uM 1ہ|؆XG"N+
lQٻ'>QaP~9G;u^Fƛ%˱Z\ڄ/ê,hM%*\Iݍ[X PQRR ]M pz&jU(< 8,* e qKݼ؞RVTx /A5 pUv{YT0Jr
ێwMdS< pz
+ƣ %<&.xCӧ@}lb4İ><ngX@h0"0;ey"^e<R:Ȉ$ȄOoaF6Ż8|BR.yhW{ðzGalk ) -9IYQR!;] ,gjLe EAaYA~ 82*DjA"4KBAVjE*+þ݇)'$,m:4GMJLGwK.
G^e<<rWa"G0-5hު=:o&Pt|)s w
Ms(h ާ8'&i f|N/މ>1m"<lv-G y* ? ڂOfǹNG[ R{sƽ4!V.x~߆ϧF.m<ڵG
Xqֱ}{rr`XSY=w p"cбcGcՕ8"} >hޢ%IWwcw+,9m7ԇN&fYQ vLF!wE^ J ]h
{L(!p( 8) a<RˣX9<%CqLDr֥*2G!ݺv">V>yF
EWb)xؾɣ
llllll1p8Ϊ,n篳-碭X=K1k8=}(GE*o=t~}ױ友jM k3vPbwZ{^5_m )|-G5[uS{96V=϶a!, }u*3}aUHe9էHc}VY:z dhiXs1VﶜIp g0Nhdkp$^YW4r6ZfxB?멗Y??Rz΅|sMW urhq^
|+sv^:v :Y\S4~cPvW5W h Kl:<,wʒMVF> +.WlՕ[_|0*/nZՉz+6@skݺ<ll55꾲 zT ZP{6.n;[o}WRl^6t}k=* ժ6 j_ʹ:9떳? nuY,bMd=Y ?<ȿ'[Ǐ&NXn -эיˬs1=k*?-b{\xzVʁgDzuXdydu=^:m==ru0K]]e>. Z楨(mF]>?GuI8kr47xoߟg=몫'[G+۶Ywc#kLEqU{jiBk]E*= 8X/2y,M=Y3=kZɩ;|n:3Yַ-Kʚ6vu^+[?fuY >y'FY}X_M eI?dM|nuRz^^~f7]ƙl.e|XWmWYo?9\|egTf,^g9zJn
=sO<ڝM| g:ثss|lY\ xVFI FKٛOOZ爢u=4ROt J}Yv>~SZ)u HK^uL pэ֒u; [VFkc7u0X3gBZ .;}5[Цz xSVzVJy`h.eoXkw>{W۬{VO3S oTG |3 )a7A}}OZkY&R 1ciL2q쫍Y]F<V*Kr0eX|C L[Lgqύ'Wc;`ʕ7{<pP I^aW< )ǟ~G^|Oe6| ӏqٝu\4 h|[xwX| 7N"
ZyO|Waix+q1n~m/[4#&C\xgXt kEJz^ŝM gQO!S=]x_9ߌ-<Rp1x[rRc|
Xis#m_
&6ko`.WY[[~#b̨xWU>JUq I)Ŀnό~}= ջ( Ț];q}1^ yBpt<cX
~dĽ7<On 8 -س/a+M\8!cfC yBYq-,q\3Ioucw_^4֤ج6{ϐ+q*7yɧ_8cF '-W߉i3fW<|5*ȡK P:-9 ť
UWEfK˰%9q=o\oƪ_ýOE,<sر+I^ ſ܀u+n;Ao5^|s
اL"X
r}T{ W dW7aӦC*mYs_]p7ɑb?/.ᮎG`@dkdVWop^5ߔܖO81iO2>R|Kɸ &cp% ,T:ԅ:xs +,(qo (wf$ oШ.~ƃon5
#ۢHB WUեXb( % Ѷ8m ,k,':G@"ZWQ )_^Y_
A:zq>ZJس'7i3E7`PWkqŨwzD-xb์9 ]h`7\?h(6#8\ vn "!Y y8vKDSvpG* V* #`)xϐo jO/ܸ VM)2k x wuq1pH|5sw߇)gc媕O1t)X5k 6 skW? #bg>]6ue x^̦AXڗ o8,QWY響ȷ'Fŧ?Njء ?{7x#,}_~ ~^Ɗ*ޠէXZ }gϱg=v |
#x E'8{sN#So|%8_~
!lAx_FFFFFF@[_8-ș;}z/kgܳb؍±UcN|mxN1 }[PŢs9j*FК0iV O(; } O| q!^TT; ݰ ܺ )go6oy>'7O)e7JEwubJ}"hzh>.QmuܒLg
p*C7)t*r9Jr`UG',dž!0#*;D| Jw<
S?} G{ĩ?sVv)҈-xzWHgp;;GL`ո[n%ocO8뢡8zr0$z+=c) q=OX?a-qMwX>+-][+h\s( >ܓABJ?[wȭ՞܂۱G|"rvвl wY.{aбy̽Ri2>_}{z,;3;9
\p&|4Yx18o_mw|9?t9h}nK q!.Q$U"
zѸsMڢ[RXMkHѼZnv(Iԁ}(S3^%
D<F;O* _P t)sжe .y}
P ʭvnA:ؕqܐn'c u_ ~h'Xi%ATt=rh <1 Z BE"Q# NJ<NR̶é0ݸxPgt\2&[yEqb7%/)J<RH;_'0~Tq i' Gp[ C؞jEK-dY D(=# B z=~B$X{:&ًW_pL':c@2Yؿ~z{|
hQ{mk}H(A%"2S GƼQ#CZGcMkFVh D*_k~QB٥?oy?GѱM+[|f&8ԩE,˗fˉ ۙ2?H_ t Sbce*:7}#e-8a? _/ލ YMTzul[wkE-yxqR~죑 ?hCE6
2^s}
۷Aic끞jIBbC{j\E@A|>c Ϣ{(;ӤWTztHd
3O j*ۦ8zܒǵ~Wގƾ{X@i _e1K~~[ C(yWccWaǿoAK3?ם8"h''EJyT?c F6P-*_[?:c'jZi.-^zr.ԪyQĩΝ+|Z_xxA [`W!3߿;aV>Chls^*m\9n W0s;XC'lJG+WbI_ "x8Z$%(?+\VSpاg K0tBYT&cȤսOe}*roSzkvQԽRDf~QJ r-;au(gr3qͫ_H^{NVrDu,e\yd=n 6]. J@
IIC,G PY&7N
x6}Q[⡻J"[]wށ;nϨP=dVŕ**X9tA?$-}ZWQw&uG}W$4,_0?GEP\BR4zx!7LM@Tqyk1u<[TZ
J3JU;ǿ/3AZ
B}Q D9*WXh,&mܱc[m$/
=18Fy*vSى!roaߨ6 _4Up ly-DB
W%}T{vr7H5wvPF۔16*WƏa y҈T8;K?"}$!ЛWv%m0 rykVj\Q+{ $ 2*nYexGV rt`
0Y!GP_SAm,#e?~pp2a Z)LzxQ?/$&W Sp䰊ElOt3u{̏%9oX<.ΏrgI
Ucۯ1zb@lmeXdQɷ|z-?lA Cےf2WK^W ݎ^Z(,ٕ wW&x0tTK*w+'#n>(눿 +W^]~*+s
x(:bPܽ7 ;)t qTϴ\H F #4ڏy)QAZP
,8.P ߩ'>IQ$RP,^m$(WNesR͇ٞg$ gw9&
豈ڿ"Z@mצR!&.WT"^<ԃqiP?kb)jG!#ʇbS,sH>Tf븍s 'OEbϚ|-@dW(9䍲R-0ÜD3Mzu nH!Vô`ev>
8w=6Z~ݰo &B *lu nI3p9s-4u3l˪Js_vS,eY5spEA(nƫ UIq^>*M>7!ğѣE4Huei4IJr לsTnڄs*اv] "ˣjDi`op lM+/8w3_<ixQx:U.f|̥8
Ӱ8f1Zu_7ƍ96ǹ4'\M =#,Q攣Z-tܞ]F%O[ƕ|Yŭw^TtX7XǑJuKht(SҺ Ҹëa[EwFiN#z\@'s;^+ r3ʒ<xWO p{
Y0r M吇L[иZ*ҞJ` ɂqҌ1+*PZVEZʬiTQP
0gpUgS{aTDk_ZXJ=$*_rP92?VrZv-w1R9ҿ hSZԡe߶K&!꾡rā(Hz,qctYWMH1N7Yݝȫ;qx ʩLveKT_r$Vϩ ~(Ʌ
mɣģܴ'>7kW c߹h1GENvĜr%ׂ3LOكo~!t?Xa焖mQ}
&̳/Q
J݊|cόg*A%$sn2maGЈ ?WʹCȔ((i]ZM-qR!Qq=LIxOp, cm
z"ԭ3}3 Eα
: }'|/qC (FW B4cZCoYڻDSWggąg'Hp\W7ۘұ}pEMt)bKeRY1~({OzUN̤⊠q0k ?k@J~Jx*͢~"r]mX01zwL\.VbaC4~S{ r1>jۡoXnMνEjF-C`Rr V-Y1سc3/]"ӂ<9z|GbsA/CBmLeh~J c־ D766V)kD_
F6ի1)hے+Z08#e<a@k½Z:al䝈jQhyLS9s@? F!q/bĒ:LonMRɳhig/ŝ~FBUZ2c'
nw`*b-⢰g]֝T Uʣz%fͱw r?Wd⠆ĭ^ݚq>XM{m%V.p `(.
)V:{1l TJp-gL ;%ѱqZÚXk =[9*Ͼ۱]x#(PCCEl(M\^4{36.W 8th)-"[(EWeEۍ[E(XJtv۞ h> S&ĄñfՅ?'Ăv8t`s\vEwZX1w39ѢM4{W#u~!
o*%zk]
2ؑ; X(whpõ3ơxױR\~4$N8d8)2,Mi1~i+Wp9-gUb ,D)ܪl4Cm^vm.D ~iqT=e/-b~16/]Ή
+ #ߑ=3+ѭ{<B˰a^n)]UǁkqF\Vv6-g
w|SĕHDe˔ r:xWw|1ѻ;vXbR2Z~λSw}.m@ճ'jK9v.Q [9Oh^
OaO3qљZY?R4.9ZQLjr1<^7˷oAY Cr Ghޓ_h"%d-lTE>)ќ,: Q ;鳖Y:lUne2wbz' P.?
w<?Ι!:KQ< te ?B̳֮D?ٽ uI.8sϧ~9q5lc֞jc£Q pfh 5+*\GXG<{SߎHv666666, qJ{o]H MmHI/hwS6,tXvЊmHsKiR+吶W5 /5wv7
qsQ`Ֆ De=y /sC\S98Jww*ޖ?ʴI+2r[#n L'yD:MͶ7;'L[+HYvBT?TZp3~= :^h-\y.ɲq¹ Ya+}ZZ/5iZ˳ƍAW>yk"s)^o
ёd ] GʭJ HrN U4K]/'p/rX7u.XO MeiYZ KRH1 5]k =IKc+Zi5wQ"s;^ 8/Z, u![<mo6nJcR>KdZ-hgoFkUlG>E'+ eMbUYRbM{:<^7=̹b9ʚ:S>n::#6*+i <$7z7?ښ4Upђc֥O Ź+5b뗾&Gމ_/.esiϟDGV "|,-Ka;ﯶ*~+{.kuOm&ZE]\c]x+5C5?.!~R#IUR[yo:avZ؋*+jk%\kQQݨiE^s)6k_2츭f|:Z/]e[{Gcsu;ں&%Y?-s|vBϯMu4ϵAa83*5YԈ= +PUQk-nbðf͜=;ުt f(<Q'y6Jw%3ܙϘ8{m:kemzvVmq ií)=eŜrYVJgil+M֮ `#`#`#`#`#E~ o{WX Ɠ;op͇ߴ* Wdo5\]x3$W `vFv1з'U7`o0wj } )&i{=CD/ ūQ튽{Q*/~ v'< 8@cxE_И^ Fr[m tQ:q=μئ`ޢ(n={՚4&T`?ya
#c z9s 5tŶ1ؿ{;I#ot W_| $B"cPxz%tj~+^)u5o?33}r
< ~s<:
1">x ՞:N:Ƈ0Ù!~hޓNjgqq%_g@xD ȅB
W9 Z4Sg.@)vA\[E@j
k1hަ;>_ A"νi,Fsug>8gk3~ tFmM=+|o&\MARsp㬁շGFպὧ /ASz^bG,Y
G.NN 9ǵ[6pZ|=y@7|Yѝ
i_vJ'tHAԑW?~KSQHn-#њrӳ_v mi:.^^nɽL( )E@D0k Gط(:mŵM_:/j%YK=67~!Txa{_ }/IwsyC}Xl8zyn~[')-S #;G$DsNŗa}}!øΝоr
|жBjw8% 3f'BFVeSR[V$Ӫ/&>Bbk?rbo|mó E|42(TqSؼ~?WUb=Q)x^% +i0,PS/ΐ NHC w@|3kW lw0dܮ M?^L+u4R83G ~/ ^ r'E!j9v>l >ک 7. I1 ܝ!NV[x+O =='UiCO+bPhi,u7 i| /]Yzo$pE6u8~ܓ;c~~5e4p Uȕwq}Ͻ[W`wJ
+ ~.'bd`ҿ?,څ D :wAhx8c[`1)W}5hƿ<#~շGp,X"i"ȻEOETˮ0^|
~%
"69|>y@B =j;vGԪK/>ED$w
y!.~I ]᛭0w|ZOE'bЀa٥ *<ę"G &S YIP#u<3W\B$PQ\skk偠@ܹE-Up˪mAEoY 'R<^ɻQ35qyJO<++y&ļhp[ rj!QVhP%SbG]rXOL!;1'¸1Q>ƳڴN/!Vp+g5?t,RIjnå?eJ xUp$r y??YtTʙk D^\8Ҩ1f =-e2F--?uY |7PU B"y3R#BO8Dn ƫn @p:+ggbry6?)yzSA4`<ٖ 33E[ ^䵴%%yA@8q 95]|\LYU?qF~ ? ]>nJ$|y,w<|<?txRnj\aj*G<|y0? 1` g=ه9yXAE >,/ 9gR r_+|H5(+ʵ7҂R }!,aXtQuJq ލ?cޛ~]ڰ !T{4 8
6 #c%짬o3&3x&݉đ/'z'f T;rSW!^ޜu32F 5^:Nо'Y]CZbXߞ#% I[J@j rg~Kf!yɋ@00>ԚFŏ\+}n!AN8q۷m"l]|#^ ?C_hZ[r0U(" BH&"t2Jx2(Չ6o|$~=`Ûx7/bIyEZVSL&V>>EHF:I<Q.Dmd`i+Dq_Q 0e`QT Ut,B(!`7N/|J
אG{+o]1u gRzqgCh>*ܱ
/^=A
OZB)*f@LPhT/N3L= 8Oq_~ϟS*jhA_~w*ڈ4`J'K] 5 `Z_>%2NKߠ/F6C ~ɤnIysHAw兼K3@/<y)/Bk*2q$ܔ'Cdlq5\kɇ74Nq0B'/"|ϗ*b_-܅Wb!
|͔EK _cp ? y 28Q͕hwv3JA>g&.0%ԿTܩWC/3#ɿLY)7*q~l8Kh(t 4ZW'7ԏ:LQIe ԏ&d e
nz7|iZ2a025Yx~;r`qLN$oQ~13w(pj~SaM/CYB 5>y
8 yLε˗E>x4L\diBz FFFFFF XAׂUa]RC\D=ـyx woM ||M\Wz~لITs|eH L{M sr#|ů3 -C5+o&Nc?
h8,:ۅK ::. Ѥk~Tԑ(, pr%ڵ5= _(j NQ$xFtfGZw%e1<H քK]㊟k:״r LeWTF?* :X;~<& mؠ>q%QÛkYL:W?g<fF}ȳy /IB ~G^G]Mnފ|^*Xowm~: qIh~00tM3yȽ)7vMso<mҤ0W'uQF=&1$ucziWhI=O|Tr^8I `nQ
Sq:\09~*o7~'/ۺIZΣYy e{(/GXltlپ KQl>mN>{1RlVDQ=OEWA>*FoE^o;_?y?C@mAv6M +[ũ;^q翈 { ý1Em 4w3 SY?[AT]E\EW)2< dEo<.m6lllllll? Nj#`#`#`#`#`#`#`#`#`#`#`#`#pO5_BVlv"\<mj6666666666666 [AKىlllllllllllllN.~r%l/f'8
Ӧf#`#`#`#`#`#`#`#`#`#`#`#`#<Q*˲Nlpss/jgi#`#`#`#*~FnNsNȟ fU+_M+$G<'
;lirMI>^0ߍߓM27~>y7i4.<sm7K6mvUTTSNO5v*%Q]_ K]] |||pQٳ :t@ppݞniRHOOG.]sMM=S:nܸ-Z@LL N+c7))IS뱩rT%L[ΔK]v}
EUU%F>OOOEǎ 6㆗p!wn66666"pE͛#!!/*T,pUFy3jO;#43&8 7W7r=^Z;^ x&̤i,5aw``sQwwW&gԻ! )J5_(OCg3?/q]ɳӉh;&5o$@ :Q H GC?}뚧gX:ѽ>̵w
k|oh$LU662 ߆gCτ^fNtCTT?)gxm ʣ>7Nt5aWS.W?sJCCi2'cDf~!ƴqbkͽǣ)q5v<D?M蚤qp
k꾩D3qդgt#c(5
+V&gIZ| 37N7̽<^Njkܛ8U&g3Z㥕8Mgɧ)ZNj'DN!v6666LN Byռ0
r1&\ٔ_ɣ4& ?ej*?!FXO9օuW&yJs8י'Uc5#x*ԁ7D+;^R @ IDATK?tk5E˄37GH׳kƑ{ox)!%V>Skq7< ')o||+++
#嫯Gn I|ONR??D+LJJ [GNz Tx*M2JY GI'4G*cFFFF t)PKE^r//3*1y ԪV#/w͓j+Nv`ZaO*fʩ$B5AC",l[Q8 #a 'q-
;jQ +Qu9kp:_O{6J~0WӸ f*ԓ$l%Ox<xwFc&dE6 @Չr4P.g)M^TXמu8WTkk8Ngw0'zzJۈ`mᯎ~2 Sig7~҃?N8Nvgo=g*ܚw H 7A =Cc]-=X#}JIM'w56 !dڀQ5i? Ts
7yLX=/ƧUK]I Aɟ+Ь?><
ŋjV~ ocyIzǘ5_ʻMIyU\>4Du`dF1yI\Yx 4fr/a'rsb+c%Φ4|S!6666W~WAw2/#»k1qLGQOdQ$B$qE$m<VL g^"ɯo/OgYiTL8ҪGtsL3q$˲r"W-˛[W$=9{.^US]xp9';X/O+Zy Z諩BUlP.+5)#o*<¯V |W ѵ&3Ϯ(Lp UOܘLM uť^L<<)u ~Չ (8FKRu#4/AK:eU`
+BDUWg8?8M &.#1t*ܑSQ6| Ҫ(cyݠi*]BKKo
+RgJ dF pԙUݩ[O=ҟގBj\vxX'}C4|q*=Lޙp
/2f~Ql5NJZ3/ɯe K$o=2 ' )K,hrFTl'VqO!^CvTX0)۞WKaW[]^c ĩե]8Ai:=Ya !{KMoaVi煎.nZ}(ĹԗIMO 6\ Ǜ2 c#=Yw35Aۘg0LOeu&I7x)t֭`Sa7ʬKY~
_Vu-8iL#a&oyf
2e[_Z-,joūBS"
/z/zRBx)zCj6|g w-o_mlll^«F;
otш`?2>r {RPU玄m:1/+-D5V͋F3/{5w 87oiQa%XWԮ!$?yW
:`DyK$/bJ@-Z Es.gEGb&))<Er3 {8?)>} ϛfg e.?xun
@<%(V' FqY%" O7 Ve'Ce1e W^qB}(S0<
oƙGxbH1Yn ȁE0Y_BxxiQ?E^Z8{ IËt ^)SÂ1O7JTjޥ I>RNUOφDo RQؕ ^8fQPJUWuB oMWo7
T|n?1vAAlx !̜cuBUSmE)VΙ[`@,vgԓ*;wwNgrJioQ#O)A͑EE9a瘵>F=mcl,Yp#"|/e_v,xȳ~zݟU @RCuylݎJN 8o"q+Ьy+DycS0g[ zwj;f+aj&
(8
0
nwRvQ.uZ6UävkAyq>ҲrÉB}r!
Aql߹iόEj<ўƯb"CY,h%W06.+uX36^KS8k fZW_tN0=U
[GuLM;tlǎwW/`80_IF'"ѹSzɨڪrd :J QqcfQ~r
hbur%y~ua mȴ )7J w#U:x [ۑ1v3R(t_ʤLXx8r$'/(;t7!pMG%ZAR2kcQ(̓ ٹ
6ѱ'_##!2Ci^LYcVݿ@0 )އo~f+оUWĨ؝zunJw?c c%'<&e]?(+ Y1q nb" K1=CKp6T_YV
Rwnǡ<xxmNmv0/(|;;}3l#ߋ-bne^Vd5<>gM\j#`#`#`#D^k|Z`j|x_T7&|KEUQ6VΝg}G1,x˔/:(q^0R
,]~[_ hn z.8[ yQ_r3xu+xSot",B'_rp˪Y1P# Qs_'/~p̙?"ݙ
ET*9 e Mq^3 %Y:w*.CȊٚPFzl㫛B݁O?x S正_Cޗ1G~j>z&.KaB U\9b{/+.N~Y J
18 _r<ձc<+!X+ALUXҐ?y2g!'5W3x&+ĒuVmOY,
!SiT:kXJhH(> h!NeK;"Y t Wꀵ=wszvhy*^qyB|ȏ#q. _EUwK+R
cJeTQ7a*"]q|}QVIMY߿i6~q7z8WW
~WEҞ\,Ŧw~Cw-ٶA<ǪH U-'*kI_TΝ^TzkLjU'\Քf%QDH;W-ퟅPF1,$ӎ3}UDє_3^징G`mwaz7
#מť: IsUT\Lճ%wN]18I? MƤձM;&mp EY) F3J|W23Sp巢KFD?JK>eǝu^yo3iL$&ĠV=h>Ių#n|k+?͈G\5J^fxwM"ev!$R6ƃq=U?>K;cvA*_-vpGzyoSHkJ' 1y\
w[o{\7?}'|dxd\5|~DM_v{BM\v`H:U?&{/Ƽt_V=QPYj5"K%5?56TI koLE]y :OZ%PXTX_VUK?Bލ|8xxSI D eC/SICJ~o+Yn蟪T -sR__zW)UyW
;9>֣#ۗE'V _VC{a
]M%'E
yzUR7j'Me`ʻ
=<'Ӊać;\rypsGF\wøl(<y0p]jՔOX2Y, 1CKp ړg-$?q·llllK#Љp>8SP}3ܙ!gsf< %Fڃ g'e8e`/Wk-%Dhd Fj^*`{vxaYμ8S.Nz -ZɏGvm,4yY>BCD뎽{SP-ѶuKV; ;+ zDByQhgR"Qei& ̣ ?)i
V֭y{chrGEImU`J9 pCK!=^bԔ^@ܨpHMގ5 秦:ꃛ5GJ0_v
DwGXtl #(wPї%AA-Z%!*q~v%rsor>lsMz.̜@ bLĞct\ڶm :r+m_Z}pVZ!2,G9ylgHZj(ܳ?dEL TT"08ImڰFA<^ GPh|ܪqyMaj![U#R/8/^yV${ax/wbܤHb{zmk7: iyI3ut,ZU ˧rZ:EhD[&Rɥ@~ y @v~!ZA6 ڊ\/'| ø) h1WBВjضD a|N g+*,T!59eĐ0HLDt0{s,+a?8Rp)f/뱸 ^\m2;j*oj!#U "
((q=*i65+mh{۲lOei93GideOYs䨾ZG_g>9YǑ PҮ ٞ.8NnhRb̶ h՚LoP'hF.<idʅtJkxd:7pC~}WOL( Ǥ)NPL0ޔqjDru鉉-3Yq^ WJg (8tFhCG?7>'&$#PṅsNk48Io
gfv u\}# $ BqE
j&nf/| [wwlhޢ)RQ!D $vX;
: {;! J\牌# K g-(E.!|l~b?a8պpu Yr
2ɕY<<E}%^t:Ekbb rlrmddu u"~S^CwG#ΕӠ1\ל29{9? *D
!<\s<ܱC]G* FiG3Pzxq jӺq *D 840x:
Jw LF\Jn@[q&Qx!Ypqk 222p$8p";<S{w*כxaL&W<XHmܐ8CsoOE\6 OTؗ9qYϛvoLÊ97 ՜ Wv9\Oe~א+A(@LLJS̵; aG }:x+$/5Th2+c5n[xx-u; qڎlvS*kS'W
lZsEbΏ eوMHUs)Wp%4D$h*vlm[|.J e mJYD"2J?z0p.q~ms78Gp1sLa |ZJzexauk>DI{r
GE7O7;ȡDddJ[-PQ8#짧8px 6
aloa U˗ Iƾ]ۍnNHϣ弅SoV>»W<3Bi 4\ouquݔ
M6"7D<nu ϛ_kb1w'f^|xK}qF; V]z=; ~ɈڷX4 ~17]S
t4H1 * Ƅ_7ve "InQa 1q#' fYyCTw<|mWuWāFRJsf}F_GVq|7u ;~3vmi [WPMԠJy2Vdc/o7>{I 0x1w\;Pߓߛi%&[,6+<S?f9
ccƷ 6m6v2oصg;S<-Ԍȋƶ]n\vnN!5;cvշgP{zύC}9}{ ֘Ż u[?m4My sm~F{ؼcol'֭[gٳHLJ4~v7JcźƑÇ[# yX/F?0 dҥG5rUu_ğī -?-1 8urb|>'xv@Dco` 2Ȓ1{OF\ng*?oݼزi>2ؽ?طcqkN]̱)et$WѾ}_.\i6&?t~YKú@53f^rR6ų?0auvvcƠ`Q
9K68Qŏ7at"#>1Xfjظ8@|q0%وqƊیS\mw *l悟QƤX0^5",c[t#/1b4>x '"}黎[cɘ4֚,uhƮqeFߦf ,_g$' ?o+2H6cF6fo2fc(j HHH464ߠqF$mNg Pp4hiVO1Xz릿BK?wSoc]" Դ+ߝnlݼxj IƯV-JcVq l0G+Zg cp_]ȫ?CB%qUU FN0~kD
0"SG>Y06lbνC96vG 06.hj]u13orn8`p^Oa,[Ըu9ׅkg 2]ژ[o7w_s}h?ry #yӦMFd#@k1As%"Y-0>E37o| IF$ڨAfy6Ă d|h4p3uK1z6ofo,nѯ%)|1e I/Wwh*ǥ`Z$#**Xv3j`,_+\ˏ N15!co>rĿv
Ʒ V̰q6~ZĸiH+h5b~klLyfш{tL5PhK11{* Fl'fW:s_4z㥗tp2,_X]a}]G ~\fxfq~Yg˄Y ];/[`o!El{Ǝ Əܗ_ YWU{^la wP?E'`׳QYr a{%tuIf/i,,^7_[~n^!/K.e!xnd lGi8,v.çc77YE<IN '_݄ 9X|ዸbŏ6 \S/`¹gC٘zSc}4AK/#/-<= Czuɴ]x0G08q5zv6%|rѽq˘qк)oXo@aWG 44j@DɉLꈒ X5
e:Wot($`}xxͩ ^
_zEe"|p-]7n˰nF YβBܲ=
/N Nfƪ_`xNHKM1ƿkГ0D*
?O|ۄ[θbĕ5 I;7)õHx8UKҧ3Ͽ4 -M#톣I1xy@p<(˯רFE&w'{@!}^~o:S CmWSÔh O}L?Z\;b(|QpǠXkeEÕ;bcZ⤈SQG<jRlJuaUZ$?pKc| SGV8oo 7`h@@ n{#pKbX^]WKy"YZ G۟_ \+ O1چ0JD3UOi`` \{, 8_Q#m3NSID9Vꢼ8 ??EcܣS0rhW$ڌG''/÷O&f"&!m I1Q*!n*0IԗބgH4,[
(dJzUG8Ѝl)P!@rJ(w
JG-Af]9 nnİ~q`Z|8sf,r?Cy!<;m|t#nq89d1xd2I+ҳE:莺Yִobޤ;P^^|S^аAS&(E'v <ZԷħބP| C Snb#w*u83>
(<r~7oS8 )f+sX7(8݇W!?BG揯VbyEo(N&s{Ck[aW?b䄧1=t%(^~azvUU9pcZ}pKس)X\7q1$ vlHm$z4Lj['):/ڇQU3}1k쎃{7Ȼ̸q:?
/ ol? 1rb4Dm 3RЯK[JkK>7 GCOcƛϠ p!z]w?E{ >7IUIObp7>Y'e6Hġ&"0cҫ7:Ɔ Sq k|E1x0w8 }
WlS<ʾ>GmZ@J1wZ:
8v/<l SsK{Do[_33u-f;I>bQ{P?jVZ:\^ !kQM8 iUKt}7 Ģybƅjo^t6o'F ?䠌
0 kO{;:]Z)}|Yo5 Kcؼ|6SE;!=}f:pӅkky , VlK&!} oщ7{O>݉G/֔q8] Ng:vgb+`dm.2a|oR[?j :9N{SA^`e6gÀ
6 0 ?",נ(o X]˭gu(q;&4dgui-W{P /sKIp. »AxU^|\.:Q8 /&?E+/+7l CP(
\vN{^%Fcxhcۡgo᎑!Tgq:E9Q>Q< 0 >e#\-f?}nviVm̓yWUuБzFn? AQ~ <' M0v桑mt\iQ![u` ;7-;Gq/_P x)4P=,iz^Iv+>]#(:A܉bÖmXr
o٘R 1C^X{%b&Lݫj3BCZ~^) U+WD0x^P]IuAV~{>7+AX`SQ `;ū,:w^:x
2хQ<@iEљxhuJ XvsDe")č E0KoXw+'T\ gGJzn t RLX:gpX YSrIvi}Ñ HޠL>EgY\灗cPԣ:@~q%![ bS4 23\"uW>]ғz<6D1֬CSѮ#Mܘ7}<g\~CXT{~~{c5)8t8ݢi+FFPhzԬ訋]ii W n5Q Do^\מ}N
*;n_vGC B)9Ux} ĭ,fň+QdxM[Nf'Ś% m'K_ Υ'C<. GCPu@tW+sU2q1Q&Q왺Yض)Gӑc>R3rX!MOq>8N "PQk_q,=bTP7|9n T wynÁ8s o8
ɭ( &~bUgh@,];U$9F@
ر'uq-} {> OP\K.p[](?CX`>qP
/߭ {6&N
2 Cq:W QĹzL{Oa 1!qT~-Z!$ >v!R$ KՀV(^.1\t;2H`t
nw?3k. UD<D]FӎK^>=ǧaJ#OmF};5FΝ)D,U@86 aT=ILU! =3\oj $b ZU /MMPNOHntFutCٶ1Q
<xz '-ЩKWx9`RJhB\CQN{q#:^x kỲ~IgKܪ_wQ W<E]ˇc( eb0+UwK.]Т#RM JE7
Mh|fg*I7~ho4q]TUg s1Ts;bQRdžla࿉DfR%jࡊD sSҼL,]|f>McoKMڌ1 WSlPSrװq3to|ta>urQ1{da {3p"Tv'1=W"gr
Ě@srRqd3a.uy Tvs/%2̲hBpR :x6T 8Wn*b<Dvw>z~ߺs,v*7\v!~L#:r$7xV ºB0ǐy4˾K7Rߞ͡~EyL\ i 'r|@WUe8 @B®L\'865fq)+f.{18Pf敡g<sHMw3?& G )B
u.<1kelߺɱ47 Lǖ ]~mO5YSw&C]9;Tz͙]ztWajru`a *^NlOG.=*[yztZ\r`l Sx O\SZ0uR1~c7X-oQ{ =<sb[ uW=N <ᢟltɈ+F Сcx4H%Ny@3wx
%RhZGJ(^y !?q-SǒeKZ)7hȞƍ8v6yS8Q5FQ/tuXZ\K]hOQ
̽z!zcOzHk9ZSp"F[.u2̟HL
FbI %%㘘˖Z4qOѻ T9 *wCrgqU*$Ę#hP@WN"8 5ʂ\Z \}-<Vy_^
c:z:>diWc':ʉ%7qe4܅Eۿ?@U vrÆ _) ï┇B]
ؚH~s.'*n[FԘ)D>UoDG_=Uc,D# N8oC+?sIT}M ե q"AYS f&nCƭT ;͛L0jv[?恱O|V~Ů_1Tc 1^Ɲ
z} <C!"-v 3 B(1j&F] ;Q7pj̱@blnjXuvprR hobPMɴ0
N* %]3s %a/`,@`:IUuc:=3 y5r uqk6miǒ1Ç1w1IMza |x osmED! :j Dw'W !XH cNFyq6MByF]Қ q[ЊΜHL1lǂ4`aG8(s 9z Xz52 2[fhkv#X*4o&72X *
6 0`j ӛV٣_N|ҠvR9c*ہ9I֨o[O %g-`ظq M{ j<d7og*6ñ ª>X#y4FCEm[z\}p9RqkD멲{CĻ5B|LаZRB<Fob!t?'SUxA=[R)nQ3E >e ;f^7Kz߮݇ԣ' 7XH{SZ#>3^BkW 6nM
{ Qe{y .'i O\FZ46T4ks5GJ DR *u<h(cܵ}G`h0%n&؍B)牯sqBc'wP!^sFe@^07 ɭăzqXZTr?iHqh\}uXt > >(@Cgc|Ոڶ /)& ݫ7CJ!Do77U>ٷSЅ\EgJ hQQis0w\:M_&0/2PN8 '7r->9_% ѿ'
:!w݊Kɕ%E3'&WMih*mxѫGW1K; <
"UbhPWY6҇y%w;_P_
˙ II@F V72N'yf Vwo^8]x8n,-cgK
Ѷ[6cZףXF!F]{h, fLT (5G)
^ض87lpJ
ʡxd@!G
aE$ E"`H{)`5 2ʈZS+@'dIou|dg_ M<Q-Z"Usnh Ǟ#|<ApӖ ƥKT7(C
EM]0
gp! BlKII䉇234<bݞzZ Pż'
xtNYg ^_y@P)'nk DfN؟#
͞o0*w3}4&
r qɇU4C <Trb>r37tzD(FB,ĭwF +̵'a}uQC=gdP$< h Q\vi@ Jؐ?:N9`+DuB,͋SCGNȂ<
"ˈhDqP,_Y8
wλ
0.)
z5W؋O<d<z;'g# DjDz8}L[Y_|Z8YbN`:ј\PP'zH BGPV@b>,f@R2}Ұ_90( c@]iHl8S'lnDGiq`.0M{ y5 rIJE1-K;xRvW1OByxMs+@ ATٱ<C hA+z&]"\XƓn3I+xDZ$=6-2>An0=DZHIa#}8g/O`Q#&-7+dP`Dzƪ1MUr܅l$y -F 9^DeP8E謙 UR la Bc硹hw7y ŕ0Acot 3 _}>.A"2UDRwnWbA>F
@߰Y5 /~̫ܞWȥHp1;Zjp1 r(#:POFO-?)+nOka fө
<jMT±E`q'iZ\-Wg+HK۞NqM~:"M(hĻ{ӴNH7Tg >J!IJ,ܱ0\cMD-SZ$e3In
7gZjˠux9i)4ϡy=ZwG,Rdҁ q19eoQwL_\=;rqo Ӿ[xvE^Dĺe7ǧ:SG{iz9x97f
uDr܀9 ~@9zⱗЦ@7w+QG { 솑ֵqw\GY/mqEwMᾷŽ^F&4X {}z8Y˗ Œ"\vCYvvuRWd~I ;%I)39'imy`7xtU`%߂aPloNAƕ*d\uHLb0ΛT3W EaIEpwL}iLVtXƴ~|Cǽ=C͍|!ŤEDZ ^\Aenq+#GvÑUO[AK;]JqZqE,_a>E+'W fyo?z6X.z*eA+>>5I&;Nd|#y EPnN;*W< ^±Nn+IT|b
NԭGJlY&',HVp,2~I'B;ũ_akѲm('ĩ<g.^v~ڞ \|W[{aԯvr(
fP!H @ IDATaO.5FvD/Fٺw! 2$2U<'.ԕЭ)1}&Lxq{:s.6^g4^K_NuOʦ FxA}Ϙ+lOqZ$oQي"CQ$9p; c\"#,/v'uPATr3(I1?VWp4/q:s?Dbö] ʵv|M{ Uy+֢YYqϺ&>⹉Ixm7m $[9
UC$\G^9(3f7]˟yZxÑPGs$8CaXI_C"mչLs(QԄTuy@6sg,1^=z Ey/MS N. ľ;;/ǣmpn7M@i4C SDoX[iTڝ^]r+
\ӯ3 " <=y@qWG>(oי6~~tqCX) gg9r&!B A E,(J!ܨ4ڮHsϝ"{Lb~EūEsŮ A~}Wib!cEBWi?!էi-q{v`'&ĨnRH-\ɸj̳H <" v<}HĠ}n588E̥"!vzJף[C%癎=q9ؾbB9^xiTm3fPmlas zj.Z`mڴ!տ"=<r7 !R,T>TW |ڠuQJAe BfZ*!׳+J'-q
G}^ U:HMJ.e&{DHk^3ō[q!)tʣ.Nʒ!*%g+u=u+Kxއ"*g
mN8HnMLj6-qƉR3r(rrK(ٌjXpk4ύ1B\t ҹi7+ZwofSGټ,uMVvJӔW/EAqIQmƫҜ.u" GSb')&W*y7o̫DQ>yV rQױN9:{6DpPKRO
HPYy0Q ;qklbQߵ)Š[j(_RUEͧ,\xb
htɹermW]ԫ$>@]$ꄣ )V}OAɂ8 ?Cq
uX`QRr KL!wvmVr#S ̇ L+^OSUƫx;J]<!DeQhJs=×퐛|x{#娮IJ:*r2b ݼz7zH8x-ƃKN!97 oST_aIx8S>|sQy RC rqDЎJ]8h X^):-o1TDQ 8Y<\xҸ1X(7eYlx+ QB8vvSy%mP U$RT=D 3 VcymV.8 R7*(Qն9p#rkrs Km[8~'L9WH_ބ6x0WR uIrG AcՍ+
=Mj+JB/ dR!8,BI %EHvɱjͫҏ$#6
G9+ȉ&#ӴC3JpHTCslw6 o
({<HRt}XKDZ{nd*7'{d*(צ9ϐN#Gs .^G+i#MzEyT' >p.ur pD%aٻ*˖9 Ec[֕I ?x^- Fs
&Gp]U-qhо\՞nԙu8rF&[!hB)RŠ07[1stn
/mk]c !mP99W%4/"8n8BChs$cQ"vހ@
ePrЉ$*q>RRZhW ?Ι!#g;TuAxp^usO |9C/cH!7o!M Qc17Ntehlg7Rh$ʘd]#[d}(9kHE4K?^L\NT
Z=]Bż25U(dVmE `*Wtٳ,Vv\8onV\+\i%S8. _bz,}
h3aJpLQg_q | ]rw FsuQV\4mdz[7O`pumHU>9!qDo9 D~r=q xA<ÉjY4Кe7½ c'vi:RڱA5&' <C':ޖϐ%R"-=~A"e @) K4ĔCReZVzF$ J;wh#σ8& "{Psze4ԁ 6vh\ 7lG"RE{.Ƶ%۴p-S
$˫"6}alWcR VɅԇΔXp}cUe&wˆZtC=Rf k/We^cZeJ7Xd:)K5 A!WnEigz WbQUkg-y1C"-U) W>d '|(!u*pɥNb1KZhLthO͚( Dw* } .eB! LyO'",$R;%ʇu:(]^H\?YC
+!+i v㉫o ?2p"KK{ʁA$ WoݚI y|N+< #, ﬗHp.pKfWX J?r6|њxC[f}AڍpK"Ҧ Y ߥ³YR ,f[K kIbi+YILH(p Uѩ6Uof" .N= G%qlj9Ƥ](M~(xa2j Y i U?nO~R_Iج4J.sd_"JՄy5U ?/\aMJՉﰤj&>_%o1%0 Kn qOilGiS%qK_X7xx 28Sob_|~gbHp&j)+//OI
(QyR
Đj?H8d|\me s*_r<T] $L1eopX|}^'_Q9p 2 Lz Q7H|2C U =fsLzIkys0]%Y z$&?{yxOig!y R/5ħঐ'^0R߂8=y Q%E`qZ }E+a24N#L=n>iG\k*Кk"%ՈW[Æ
M!,l{s^9LgUJjuOz)sO ] 2k7ģW$jL7co-jND~/XUs1Yo;`5do!+9H{gfd'sd2b& U"3%% K <lla0w穂,.\^ d];LtDu cj'Xk_u.Y\+F(Ib*$Y8ƩUUM sS,^Kܸh+EOR $eSi5|*
7C5q(Xf t&YJ4MlaC "<:8r^ GAoY%l:lfTYTo9G/
rg3;' x
YV{ ,|YʑMa
ƫ>
8R'l6z F(0eKBU6' |wj hW6Wb!]@T
dsҹiD݇%Z5l Ӈ:K|f/VpRn?5~f?az<ʷ (f_.~Ӏ9dkT>.j'-{yT>f^ Ȃ'ɟոWHs5囄1$RvSyg73+@IKƋ8O;LW]KXK,L+˯ݧ ޤ,)G~X͜$Eϑ
SfY >6ũ]'D<1@DI3xkqoŒMu\UWj-~Wid#Y+ĩ5yC+%q)$sK~YIe'f3sбa~M#t2?-cڟd$뺈( 9y2>oe'PyB+A;T=Q2䠦Y!`"a=S*NleTìHƭE⟹Zƅb(8sO롊<z2%L8M{=[ՄWO*G1뛀"cHW˪
!`3 Rs3қ~B~(X! k[Fʴ%/ireݗ[iWYjՑyX1t]t_TcYvЯ @ҏ%0`À
6 71plEOK86Jt k?%Os} Rh>kG9ag/*?yfJ<jO _7Cj.OD0I]d-y*.+˭8&$*Z5LqwI=-s+Nco~ ƳǩI:Ԅ j3
OWgƔ/3)C6p \iXaP}M}$nm8' J҉#ڝ5UU(gZçt -\鳹&yT&к[S?kbO C .Έ>aZ>ȩ:%"0
ϪYvyQx1Jp<̺N5qL(`]+ #:g<tSq *u vrIgs<$LI~ozB"{1 .+oHsxS $ BĐWw:|QU8yBMs9[Ʒ~ .~BHU7[ҹ<ug+Oq]# !Jw[:\ǟNg]դ9X5q.7a!<mΆla࿉ eq4w0BV{#3\ =_SUw13u=~ a :+B8csqIs0hCKhf"mnDzN駆QHG?|]9Km8uϖFæoHOG$RO+˶~?#>?j[;斳vl>Jg lqjYǯ
:L:SJz
Q5LOB[?ǡu\
Usǃlq/`9ߜ&i#m^ڰ U_a+st=ǞYWke!HHz+8;JNw]g}x롤Qh?yp|i4<PiJ,}T$iCޥ~;[:]~j8ign |iy^"ߺߟm\I8BI?;h_W26mzjlaѣآE iV(L6k:-q²
GRoeq,6"f&QFcˡU%Ye"~32s/0
~Y4]/uv349vÇECqWtMDaT:j"l}||]my Tټ9\㰜Ps8ls̍2G֞3 I eN<d^sWk
. s^#7מckz Yؿs0lkąVHsxKj
:G bmӰH V|~s1sK'N8z }L`cǏ fmla&{@
C>}e)r@N6Q'rqj?u W?[ eAPn0FTƯƋ?;Sq_CҟrΕFH8
Gh" @:]|tvzg
~O8<W<kyg]|8)~~P&V3yC{7H )útĿv\-5RzbD\|H}m|z/kuԸ0k|~?}? $Ɵoz6a5'N5jW mqv8?W(5yZK
Vla ctY(DJ(6`@61B%
,6c@6P%w9 Jsj^|,\H1lC}ǥO F A2VvBîH\&MlS`a${@DJ Z$Qa\:8L#3 .j/29S6ߚwYêw h|j e6K[gR6w\vt^gãƱđ:姆[su'%IW}(^.~<ݗ X)W[ LM>fn5/,4ͯ=W?n<T80`À
6 w1p,dЂw64ɂFг??GQ`==dW᧥p-Pn9Khmmp(ENM:.u⤽.|Zc9<I"e# tqp\z˪ Zw7'A97j7Sƪxδ #eV^?xY۲al? W`z5x7*O˅۫Z.>I*;EΜ]и*V>'3+X192Y2t}uef,'QD
]x n`zsSzӰFLfzh6FsNh<XgU ړo q&~gs:\T +<I\aWsOVΎ5&?n~`r[iPL H dRܴqS+ʊ
;PjgKi-}USh<5Kxx Υ 2.\/wW.Wm5e[jm)"}%a
VrtPpC? QI#ĕzU~/c]:~MZWŕ,e#+wkc4qo^lryZ{F %8z2ޱnQg$Q_ pip~u3sf.FRw6q`qm_
6 0`m O
^l <4ZWoHUbՌ/ჶ~ 5¶0k P1B[Ba1ʝь Y%A8yDm\ 2u-dXػzã3䚍<)@$ Sޛ=̙s`U if~V t95W{(4]짪mpS߁hᆝVcޢptGcqJo wGn]4.F?ӯ~7q0 ;-Ɠ|و6Xpںh҇Y ̋#:fc 0}ƗXrMF&n֤{3^,^[x]1^|3;sp8>g #G(=RKz)˺C' a!X.Zk5/_2WtѵXgN JK¼_ BSo_4k"3Y?8,tiK.A" ֭
bgjΙ5Țir+N#& S4tvTҌS%OYWzǼ6bOaڼpqkFYp*+Qp Z4W=MSQQ E W chBE!f}&! cVD58yJ,Lś705kl㪘gc|'%tCrv,q#˚e}۴2 o*@˓-YUH#qqͼ?m/6 0`À
b uɱTZ/Ud <Zw;܄&.NUVa/2
ڪ*˱wL}%\yh((&܇X=O#zr|l;5ٗgoGjzԇ. zɷWsO#2*e#o/O~Fa%\sٔip1q(-Q}o<r%8=B}yIۺz X,|xoCSS+?vv{uQv5d ,Tiq*ϚTM'ȆM_.]N3Nˋk`Gc0ƌE K48?F+i2\3 ~^OeKqm#P_S. s#cFҹ{ 3 um %fR8(-1p)'4+ '`|~]hX =OjM^̲u2
Ѯ0; GͪI%J 9D
N9XVfDܡ\D*w!U7=w ՜/,va v۵c}jxɹvz :Ή(J?ۊ 9#A 5yBcw-ik᭾%Om<[z,3_.^c sHvFS+2U[y&4&{}m6 0`À
qyz {ƽتYMV\1MAl ޞ5lw.->p݆
B MfGg74s#'թcm(naӦ_p".nе=%v6o
'OUh N8DnF}gg3/8X͔S]4c>
0WM#:bY[VQ/ګj+ l"2B_E
G]n6k %lĺ_`̈ފ٪MʓؽcǣN}Wt!juprHvBAܘU6l
Frn)~5
;n avZgnn.2ƵH1HhɑY%ɋxɷa˾>@_Ox5rĨ'?_Nj[ ؾm+vq1q
# K_Td V~n0Qa}FbS1y~4wu@P/d0~tR]_\JN>S&czaے@ls Z
iYaߎ rpv===U(F^z 7o/fve&EH,ި0x 6 Ba/'z>M]
7֜bK%*BЫWw99`ϖH̜ ws㓀Llݴn"6:[!c
N9U%b۶ -)C/?rlYdj Mz ڶ mH8,+ƞ߶cAqpBpx't o 'Y֭ō?E]^rB)&-B2d$ c#vS 6 q87n~MK`p4%[dA4to={#ȗ,y`|plaw˵TkLU~۰7 ǓhwXqrȉUd#vź
[e9rLx77癩j}IKWVV>EN â
h=b͊㞺w#?ԲbYD\Vq ? sɢBr7a{^օT`W! uYhj7YA2 7teyXb zx\H :nGWc}T9!-} GvSp%Y ai)O_> | GL ?~}.hި s'_*ƭ{ԷKTNp&
*bT<$Dm %zZ"JR #n aV >
͛(쉧R N
[~Bs$Koq#s2Speg6i7űc:.$Mkvre#"P:jOҿCMԢ^=
]
y\n|0}1n{u&ͱz q\AFؾs/
K= Ǘ_~ n߉hP4&K֩__t¢2 J܃[w!;8-iZO2=bіXIM%PDF_p}3x4(ٌ֮A{Eb,=t?y$'FקP)ѕхݵTOm<[Uu7o><
Ϝ 4o#wT1cf> A_1q{'Ə&)*1NXh67q#+dalu (EVN1,_flٗ㳛nE܇f,˲ 8Y`@[dB:}&9NK<>< af$Kjk kAq9%٘3u.e7'pԯ1rXoD^^Oa͗ )]["E9:q zK=EL dS҂H̷eԝN8_sFe]i..
ѪxևՊmsDO&-C:%xg",u Q?kC B(],Pl
QbGTT ~l(bǂ
Q^BBH%%`;yrwwvʙwΜ9gھ$tJ ÞK!"7<g[4*W d7_t_nA a!sk/4G*'(K ȷO' (H*O4֊pfx4Cx/ pƀ p o-@%^oMCOSE6i'P%3Gk Z ]@t,7/gVvqG 4OY{9%MmWl z ;L+;Lw'N%Ŋ\|xzuÅgtDJKpK88t kk~)H3
sN[^(.B y+[&[]VѫCZ& y"ޙoi! ̙k s6F^r:. 5ކ"?o܄W4˰2MTb/oDL}AsUW]*w
q!ʼnAdI%`֥bSE8쐬^o_G? m^WkvoRҖۢ,}nSWK}5c ̓`D !/-
w? Dtmocam[F'* 6
(Pp[BBBB(!p t\cG/L|,_z~_$u;
<:#9]98F2 PswŒr3[yi0kqѮCW\<h ˰/%0wswoQrMCF)\wf>n<Nisd( l $0hU'8>t{Q
*\~w2|cR4!u(߇w{Cyxi;uŁ;CdL/0Ct!Sp ;6k/RrFƮ<$'6s"$ (㤯l4۩<w ƃܹ8Udɜ7݅EɁL5gkQ)5fttdvR_SZYcw gL *{GQe Byj9Ð Y :Wvjaid5YI&>s6":~ݱG6_}{{\N.+-jULr\rީ
4|ކ> nExD+,>R|ƻ`oG ȦU"*K
k.?O"w,}۪s$m2,s.sbZxnN 1=%u.Syo p
v歷 w6 Zw¨[ w_ζk_ Z%9YIn Q[]37]u
t}F'Fh,,,,N}%{KOa><fH'&s
hrčI?{ri(n6í~l 8Ë3[E{*9-EeKsr
Ͻ"mw Cπ?/t =;KEGPp3xs a MS]W<I \k\r"r
~J#Ƙue]xw U]y(-*BQ*9[y3}y$a~FV\Y#8c}쉤fr褽,UcSGtz u>[ 3Cr2cV`Oq{a? l}=yPxtR1+ lrkG WVRv
rx.m.+=RjX
:tҼeCz ޭxUqYyy+8Nj NLjrd 6g܂^}1WGò ɝ}vb$VWSҿ,/={|hX1jBM[?U@p|$VMk5߀ix7r6@WI ֧bsEK!Ie)dR9i;z =<ynΈ:
N0KR
Vp@!?yᙷؾm > ~#<4f<fvX4
{#RTCpa`k֬X)6!2ܘQUAy̫S4{@JPpO$JIP话M R7)㿺s*; >"%{qgzqF\{# |=o QXb|BiīCtra7<P:[b~]FyblM;g(ct]*˞ !FTTjB: N}1R
GT|U mNDy+KR]yTL#'&!4
|yQk]a-SA?5& {MQ%H) {P2qO(*7.F Crl(\*M@jTt^Ʊ"$c#3?
䊸Xs ^ķR٪ţ .Iiщ }<Drq |t⁞ 5ױg>"k KƲnN6~y`ą(h\8R}1Ϣܭ!br@VWIVӹ4<p2x[g|P>O-j9p[//,+++)Qĸ3[H߶nSycFG~=n"8FP-d˘2/dcGwΌ߅t2 -z@D Ãfk q(uڊ̂J 8w nm ~N|1o9lN]YW pgХӣ_շŰ~ɘ1U<ZѦcH\~]~ ~'?e7^y9QAm3wnފɯOǧ?-BT7m];u ?cKGކyלg?Mwk !anRF`;/I!.Uݒz#0u,fς> G@+$kpn6j(c՜4k x j>EhDT6㓩C w&ryYQŁra </771gUʪ ?<n(RFy;d &i5DNH sf Ē[B|#w'xVP..s+
(';`ܮǙxޡzm.x{_}|+xڬ9zX?T)Oҁ#+qSmƘ!8U12H#ʕc3<xgg_G?Ĩf*OH=^hNӥ~ٗ\rf6xԑ?eNIi΅{KnÀ.þuwϽ/z#@25=rƌY^T]pɈm0\k1tô7ѩ}W7#Į)' snG&!" ~1^-KPҬWpU,YmMW=p&U!ͧ< 3^{} O~L|i&l\
Hy!ƌ{
qq&qFBBBBE+QFm\Ӝ9szCiHGyu o ֮^}yňMDGWfʬNmWg#KҶlFBˡHU\VŵmCȄ|AӪ()c!=^Kl1+Fgvmǎ pĿed ڵm_fL㧦yJ_P0Z#U36!u:xBtD(gG6[S>t;/ KODJ;npYf'B)ݻw#::\?{ ^
fc~wh:ΨNO' ޢ>K;6?:vVXO/Gvܹ# -"ܕ
=yYlʙx?k ΟuEJdQBX YYY8WU='M=]i[y6HNIF c gMEhٌXs6lΝpyL-4}*yfhBo?K
rzj)@ʵgL4 %)oXX\H2UbÚ5؞A-#ѹCq~Np\IbbbFVvcn!R!%A}Ӑ1''
}r4xf!噱֭G^i;L;[ òyض;ިurEw^-vrkGZPn;wӰF5q߉JgoF./+l*Z%B*[
ڵKrn.*$Z6ۈuy6<P˾tiu߶e#I<tܙ S_ vKW{QEEE]
́.QɉZyzؕI -ãІtPGؼivs5|&uMAf uY7n-,,,NbND٪FSsgbƗo<a ߈6I%~]cxk_}Uϰo̩to-ˢ[ӆ,^۷oV`h.j tHHE usأ[ c'}~)/^z9*T(H
#֎%Y{]fj !<?A ܄H=kKJJ F|23T>G3[1O @ IDATҪdC ;> MZ״ʹ-VA< kooWp9P@yW.wU6Y.@flZ~F\UPr&}P2:ܡL2#*91g vթr@9={z~J- =
2sk1\{&VȖ!{20oH@.y: 2sӋ,uk!`!`!p
"%1sWNaQ #T`C ӦE9d+)b}V(1B_Y&=ZƸ<K Qd 7ĀF^WѨ,0h2B/N 84V>E0N]S TPPw+=#q'2z^̟}^4w
܌BFi4
[OЈOX2JYi*gk.ct۷[SAgBJh9]DJ Ҧ
H!vGd@DQz0?K31ͣAQHS#%YgQȨ>Iū0(WNrz=i؍X|<rIT2X
tc"XoRmAb{qlMbJ<u\g3*m F>X^tTx}FBoY.»dakzFq~Bw~A!:XH^_Uc w S)ĕX̚z83"t}CO)yJHKS0M
+XBBBBD3bccRߓx' #$P6N IQQ1ɏ-̄ O ߢܥbT q!A G1fO%' bh oW\\'DvLnfZ~2UE?@3b߿_hToiQ~IV6;r=䴎K@ jKwjҙ%jUbˌ(ޛG-%%E2:&%/4dX/4~d&F \&|lrD/ˇEԩzvp@ M)a&ْԋ\-[jժTUMDyiWtɒ%G˖-UyUVsPe>i>Ҵ dkrf> >͙9k8 ^o2a$''+#PƢi|\C;t֍7۫pt{M ,,,,NM;Ϗ)GcH|F;esڛX)R^1E12;&?M˞?tWN9nN|`,?:Qe ,q?up,y*!+ DqS|`sjyOE>2i$Kܥ^EuwxrQ)e(b wG ү
-,ד "ڵkΝ;+^'6
I)NLz/%p?>@xr'z KVޓ zpZSi*:Ɋ(2@*U <9ڲ88 tv?k*I̤[BBBBC%O
Jd!`!`!`!`!`!`!`!`!`!`!`!pb"tZBBBBBBBBBBBBBBx#`ǻ-,,,,,,,,,,,,e[l`!`!`!`!`!`!`!`!`!`!`!`!`!p `'@%X$XXXXXXXXXXXXXX' ~TEe[<`!`!`!`!`!`!`!`!`!`!`!`!`!p `'@%X$XXXXXXXXXXXXX :ȿ,,,,,,,,,,,,,Nu 9 ,ㅾ
ΠWUUA
Gύkt%|S]8szޜ^:)u~J\w3_ |(? ㈉9܋ݡm,i,iy;9\cƮ:Ƥ>FG Vux^3ɽ8sxj#W;^i{18rp
#:_9q | g\5Y\3 4u W{xj;Խo~tѮiYUw| k6 ,Nߛ6vu,co,åÛ69K89㽎'WӴ45V: F;4yKkOi...
ړ̴9=s4tzg/ii ZώWs:9| Ӓg G ɳ8 x?kkci4*{Û'aٙo^Μ8~ao::<{s]y~ Û^|uBɽNC~*^̴ O6{i(:ߙi0r/9sދ9WGi=ɽ8G:Jx{kL8g pAØ㊿~gOsctprNv|i?NKirg)i_Ǹnnn25Bڵkտq&F{"#VWW'*'4]RRRf|Bm#X. >'Ch~]]]Ov~R_t"neeI A vXOD p&RN>?sQɎǢI )}}'c-8
݂x:B[nRcݏ dVlٲ02-%I^Z i8"(Nd',##vB>}ǻS8rM,Y=z2x ÝB{YY-Z|@@9
/i355AAAFEE1HMX͚5S b xyysNtJ^ L( 2``$''DׅtY(I}.˗/Wy'$$PSZZŋ+9"%Rk i{ (**ʕ+* z\,MͱW}Ɇ߬,)9UeV<z벚k'6lؠB՚cqrClk ;!: (+XPNDWT^2,2ЛKRblvE)Jg{28]f*e
ڵ'VK#'Nv͛7?o cibFڿ *I *Ϣ6hIXh2hteW)22RI0s9] +9wt,IW}J+c6&5҇u!!!_ k
CIY{FeAt Nj'oh۶N]V#*t n/}ȉ$+5G*"C @\F a#Ի DN7ٍ$?Fǩ4)Tj?ޠ45Lx}
CORhdvR)e>^%C+t ^w]{%/s7%COic[q|n yJG "l
fvwBt^vyW{E9̶I
IWM;RIvB' 8Mzhz mύ'~aOKzx/**
2 mm
B(#"C
♦$?1$2Nh1;$/?]"6FA !,%Y3 i1s(MSWpP73 1?y #H' $S2s0ߔ'44=|emSp,/ h@Y$ KYdAײ;> ^dΡtY3:]817<$mWeLڕw g<sSy=ݍGWSxC^+;.
̕eTгA_ʉxZTt>)sf13cӭ#aOtB{=?:4~)=ei
4 LF% NJX7)T̶BNʃj;ufڍ"ɿtr<_c1ty{4?)ѕH>«B8Z!pA&S($2&t N?+BGOI%)H\
E_8.u0^pީ2)څj cq|5i*s ̓Zr+l 8IkW;4!FL GL?sPZM&G|3G@P4)RTL`'mu鈏!O%L\Xh10fΑi2U/C'Nzu:Үi ݔAN yWG]A|){{zo>pJa~YJ#m
q<X6x|86B8)( aiH X_%WKKYRCYr8' kZ$;s'ԩT?)gAdp;i.SMznB`* L6"KO7R2~So8s#w/C:lJk؇P?W;c[eX{amT7R1|{J?_2qc#hUi5SQ NC T_}Ӎ3k5L0h,dJ'hZTW,ׇRcƤ1?!ՍͅXV{Z ws|z=yIC7; ^Ď] 89PNPB,
4u>Τם$X ^bJǖh8lM佝># B:RpY?*ː=pvS])% ~h8!ύa N*zB*uiHڼ/f^ɫױ+d_qa ?iR'400f*;!
TxJʧZKs fU] HgPޒ-1uLʦH4
t ?rf~F$yDN^yKv"MI[s|3MT mTE5ӤFi6'ubpAS~nj>6Kcۯ7:Lc~8wi5pKʃeWj <ھE$yJcjL[::Ǵ C"6! {\[N?]}Fڞ) X:~B>ta:R}7w)yNxkr6 iz1h %TiAUvGCeMj'Av3.MTm|2 7 ^V1e`X" [_6J9CG( %8QjGӐ;N0Qy'ߝ_iՄzCΧZ͜<0R[tZFX vZ 2,T93}c.)x0anG*4tr`eYkoOW䡬^>^2* te\ca%_:D]fs4a&!M)9 O.-*Dqie'5
2#; 5dk+ gk/NZ)A<M6Џ+\*X aV+1JIB="Wը#:4wmDk ; 1aHGK%MOna 3(>{v] } Ch
IZa2m ㈿ rLTVûsۗ
\ D5@eyV.5iH}v@af>*j+閭o
BQGZV9 c'ThQ<?Z^v݃''OLF|L$Lj!NFլ1wUǂ1 0 {ex4CbB<|ܩ:#Uɋz6HIe^|o
X, ܽ ɉtSVJG`^;:&Oβ n g@mMz(, q6qrvEuI.eƌPJADf k\$
|peF+2ĤgEy(ܹ#.³ S` MJT6kώ
sa*gRgyV?-i(ڌ+Iw|/ S vajֱpS1%/ qovX 6mFi%мEKDƣc
VuI~d
b:_rNj!L\p\ 'yveYl\V`wf6<4DDF!)9Sڠ47l #11 > SI
imU6oZ}h VTT^3͜F=?N/tN̈́OL YA*Aeg!,S&<-Ux;28
ڑ'
\mH*Zeزe=#uǍx^f( 3){3%9ݒXFCY WMXx98Pªᅈl)4VefBxScha&DNշ~VT\>`n+NXF0g7Ν2g_1S :ۘ;-F WO ! Nysxc'ft7R9f(*C;)+Qm\Eߝ<(YF $eb;CJ^8 w.
{)
`?m~:azTTcRWt̢[9֍Q~?z٠KB+ i咚-Bo̙<ѷoo5 FUI>VXUѮg ti ĭ( ֮ƚuw_.<|w-^*O۰KRW DJB 2`b (Adޫ39l̪oWOv,}]~vty!)) ~>^(هY=*;A߮IjMzϐ #U{NE<]UQ]<_xqD ۙA%AEh_KHmIY픧&[n>= C
Nۄ<K/AhHSڶQҘs֭\嫷rПG
J8 ӾzwnK]LVQ.EQ+O
$&%!gUPa34d`&XH .Kl3)ʯrh_:My᥇ƢSR+5P-qfWi^f,ZJZ6AV1HNJ4u'_`}tnf?#QVߌa6xەWcq&jSyY)#Я_ zՏҋz5uxkNQX<3}U<دۖ!eW;;-69ꪰjBٜݵ u6d?–?1-ȪVb("Լ% "G#z>W;ӳb(<eK~z1\wB 2H8Fm\ VEG @_\dzEDԣW ?$:I[th-B(qҧbp2_wbܗWՠ}Хmk~"咫uÂm|h:gNj]@.Vyi^xe'=<v\<ܻ
NqaHۈǞz H<$
]\-r(2)e9UuE9ʇLF+#Z LK!<G3ȳ(j<E H_F%
-[V˯|Q=:@ y|)5'kqcd ~QkQ*U_@{F4m+>lD$*vla
}/( K6x@3pfچs+/ !4$*ei]
مcJ@ 1)/sxgaHJX#$:1}4P%}p2^3 x4KKe-W +Wo Ǘrtp/ w݄4( L0?i3nTR4f$y'#N_g;QP
<9xUCK+fo,Dg;045T1Q:G^UǙ*İ4Rע z0dxFexʧd+;W ed5ige_wG8v8IŢ[L0>!0
W^Ќ8
Hb|˘ cU^>isBtPTs5BUѱHR'WT tGe^::?L\wM@腘3qv<T)NJ"(DECҭ垬 {#6&yqϰ'(א j@ ?,!O"Jeze
K
@_3RQqhV|- ޅ'Gcv Om<r*˝6gY EP6w]M؊[oVMd?g ދ'<e鸠_7dƕ/!Ѷ^}j0#)R{ęq߅ 0T# <<~و hs»cmY SpWJ]2(rCxAH] =dnMRYyFگO'ra?Ϟz9ã&NE j@V䆝u%8J^Sugŏ<({A Y F QB %e^0Z1P|I<:'d]օxA ӳ;$(oxoHiUm%-SĘ'ѭS{T ^^L
?qMCf
gطs3h<q<oZ9c}xN!cѳkGrЕY}ROˬp͔1cWap [+뿪 %[K>i<lmЇik&ː,m@*S/
ڎR˲('<L ,+ķ <z֦ R#wž 0饗==h\u3ID(R 3Ĩd֊欽ix~F`]_@N;0:ep2UBʄQD&E 1@~R3",KBJa
Qq8D*XPM4뾯V 8ϴw|{kEO2 G@C5w? ˪ χyJ,Bg=Y$6
5M\gn
ebIE*xi_j/ &SO=]Ksh ۤԁ3u;A[pCC#K ,;PTJ6.) e<LzqM&ʊ q>^W&ޏ U5 FΞtu_)
/5f_0~~R'U+]X ԫ8z۵y
{%tv7t*/<_mΔ0*
QNWݓLc[b-icf#NCvP:J$JV( 0 yLHbr Bҏ"̓ ̝;¢qn,ˎ%\jR"rm 3c Jb# -1Fى5|WFV6o&$sD'A~L+ ˗@g"-' fyp0'S͌W#.'*je*6nKDv ђۍ cZQ'
5^ѹC[Ke4j'Cal ֠=< Pk1gк?= }5|\\q9_3 *"h {:'x*/ u?F?6`蔒 ә{ӱfjOѭY +KNvĪ c_!:w
,䧉OFLt,v \Έ.-i 0gY.D29WQu aNy4Lz{&c>8QUw +
Ա Wjpdq XQlWt7Ûqi
Vn؎m;!"ȍ<Te뛍BXDu
T`-qXz=P
G.] o`;KŸ_=:`Ǻp}Xzh
WvaX"7);qv!Z.ANۺ +ry{a%uS: vȕ-R -Yb'_$FҐ@a.<iU:J.B<z5n Q2BU3^Xd>VsfZ-6 ̶oKۊM[s3':Gj)%*<*m֭Щ}gvcTdp&Zx'&>'ۦY g{# {I^^wo.%D:ZZ2G]ذ@5sY&ycYk+iZZ jz'Z`]2,}qQ{ u쌘VFQR؝/mIz#i[a]8 [D\DBBMǔnUGTQѶ}n!Xr).fMr_(d Dz g$K6)K#H\܍
#}w&P٦`u%?)vRs&lӯΙ Ό%@˰pTdE(eG$H\^QMl*4k)m+"èр@Ʀ
y[bkՁ=Xt)ڋD^|6W`Ǯ=pF|1^JX+WEqg?RbP)xm?,LqK2|`Xz9oWQ~-\OIӂ˙ڵ6!%eـ-i;^~h˓\*eNTNr]2Ӳmҩ_HlU?4K'mNVfmބ֩oQrV+B <,HL+V}5AT* gqײR)S/|5s&jw_?Å#5Πq[YqڍUogʞ6ĶD%Z
x0MP(F~W\ЇypYfEg|s*-uBr8f̙3E\~GJ5 F'VGakJ9ۺ {J
Hߋq3mPT:wtލ/ gP-U'}f`e[ o_3t>\e箸]Z[y":!/}zɹu.1K{#<$ƅ\͗͜iY/xѕa/g8NwRJB|d(u&_ұ#=ͣЍ<FD.+cqP' Yv O _ ۧݛS ya.5z;CgԙVq%Y~JKn4肘ﾠ~\5{6p0*ż*] qFax;0/s@`c9efVq Z4c_nz£ oX9?}mL]MS)" !-бs\*a*DWxOOJ|x<UQ`պ-m
1YW陪_7 m!I\_#2d)
'^\4B{uh z L1gM"\>9*ixmݺ6m2YS9VK]f=QVJ>E$u.E}R))w'cY!|SSYm[~&q[Ef М}#$ 2@+.xD'
r5CW.PF]B&LЦObZb Hn [ 1_~qŭwp<iCIA$6F #^=ll W e,e*Y@e2@)<qǍÑ ۊ+_+RƪT[sqA6V*ѵGO{#+lH)b_|FFpٞ#C| \mEC q¦t7{2ݓNóco@8|Ny%I?$PPxp==};ǫJAB{:KB=Z`:vtJ<H[v砹|ݦ8}yZD ڈ/6.䋝iiL@gB%N1;
t"̥ A./| WF!HnJKGnnҷlR!lJgpKQ٨[}ϧNf<a/3 /Əbz z«/KoqђWk@c:GqeovKEG%TptD4"9#h
QWE4Q6h:iW4 gC8ڵ<}?%" G 5ەqoye xaG 5{cp Ba^2 qƍ}(l2hDe'\*.o<s7>LNd: .p-+ǪQOf؞:?<
_NSq|cy! 46.7z3 "c1\wEӰx" qqQs` *2n";flco}0icݱcrFE(sDd=>WZ\_(*̣%|{0r);0ȗ{01 1h؈{>?'\7a,֡i?guVؽ[<'y$Pfw'oW½e4* P JBLm,;8h?48cdP/RLq%&r2n \:~MD{fx)?}(^i6p)&MJ{1cњJ4nAI٬,^eޅM2m:]
oo ?/Ŵĺe`s bˑp.߂~W`ʽñm}ަMޝ:E?/Qs-7 R h<.ӟ"ȭ
L~oZ G$lǞmQ\Jg lWR\8pǝ=ъ ̑T8;[Q?b`/!h
w#%*| XQܜ#|2I4?|W/QIcbpoX^1/ t ^fذ*\m|LRf E $ё[h$l\ w }żŜƂ Wg )Κ~Sr4r&z
7=ϸ.r<G#qoяsళplNU%*ypFbSqؑCo~AgJ F#Ƨ|zo㪁g &L~Zd0R D7Pf%Z<Z*- E8fnۖKA4^x>ů w<[F^`je$DQ344̪]x1X9OL,||e|qϽRo|2H
߿xP9[{xjC|"zeѾ,Xӷ0vQ99#n
c12"î yŜ6V]<jlE*C+Rx8E
8`qըQ/SǹI_>D%VY'W.j Xg=0U0<T ?o_ sDU g37uO+ٽ2FKxYFDӯFfӵ]ozaݚ HR37R'SEyZ ^RF}R*u
xef aRaZ!YĜi1mʢϓ~ʿeM>^xq6 '&aѮI㧠0 r`fGWJgv-aƛ9+bٜ/0ny dmOC:bHrfa ƽ7T=WvLiʓIaAL\:%FdN#_ʖ]kO⬁Q Y=SC@\>B,xv߾[qTzC&3
nB|ʐɓpqsf1_}w'Xx< Xjy-m]ԽiLιa='~ Rf́/~|IX9x齯ѺE,MCwc^N-y&n<Gq]'q52+ K*8Ytd@Խ\DdϏ* ta){FjdX|LC_O}'v 'zs<{
t쐈;qR'vKSPq>3
9g &R^,Zxr>5^̉,.\%~ߍW3ZmX 8#yUcRRB=@spnso<_Ӂ3;t\ 9a
N'`k~G:XN\s2vмZgnuRG!#(e;sOgA Q_0d8*vsbGvpw D|(5+~P=/ T( C8Oąx ^1<2,LZ~)^| $rܯU#G/FM.y:ei^& GCKsͣ$̤J 1{`6?uCL|hQ_) {W R͡%jh\cj{*މCYRoLEgtV+Ü~Q#놲.vc#1'0i̖tФ9kуw؉Ұ7'-=6GrnGaCQFOyƫ| I8Y1=TϦ*!؋F毿+|Kq& o23NC(7"dSi NeS#(醏x
Q(2hs_^t) o%7!j@ku\Q
˱1. y;qijK?|P'#%2+ y+ [HX2· #/=;VbM"|-
ʿ(j={D[f85 |j$Կe <)k/cJ27?y 8rH*H߶ ; E";f VQ x%{Z7_l݅N{'pB.Bv1 e_p !MǓǯMcK/$ Ķ
hl$칔4vAg2ߠ 7F^>y\K @bK b{_byK¾U>w-.Q߲}r0
d궡x/͐: o =Jg;/E{hb[qv]θ 3:^$W<8ϰap(\qފ_AokTQB1+-
A|O6e#?^6K1x N7S3"P;*JuFbݧBk.WCuT 8[w*#'rg?crnl#M9Iݹ "!& 4^# zr2օF͚Q ̹3';#mew`$ mE& YN0%Jwňs텊9#CUbëf$A - i
ub(LJs3\/v"?|Kw_;-_?X,ܷ>~ }-;['?%m }8?\R4D.z @ IDAT_L,Zʥ*W[G*/`mg6]kLU]k8q>pV.]GŘk:&w
>zI֣ 薤-)a` crO ߡ[<
h ܪα
F5q4|ꃈrWӦp+QK~?. ]? K >_QEju E\x!BK@k7˥Ӣ[Ȍe0SL`bquKt |m ٸ<S SMVƫeaq3a$rUH_|Ҷ2..Vys= K ϼ>6sJaq!Y9 =z(ڳ o=2H<
ܫ;z>ĵǯN?.QV%n @+>
~Dܾ\3ɁsY
&Id0mqRtV*S
:#d h.'4NO%6+00۱'
SgLy-QUXSw,nĕh =0 % q&Lj;{Е YʲVo~]
]*, 73ù"Nob0ql*5ˑu~K{r$̻+Oo 9 }4Wl۽ۆaW#FߊU/D>YCQk/ݐGr6 >NX<w2ί ?u6r6{rU
qEVv |W[@Ѻ߿ .g 8On
Rh3dRw?0F=9Ohq8" Tf_РQk]/ށ7t\8< O@TtQ.!҃rҟ$h}@Y s$H5@+2S NJʊyL6 OZsOfNV~јt7t2-lņJdRvWC=[ՑfBeS35HO q Qxy}=5<+/ ?7~Ћ N.75 <C?ކ侸qmM4? d7dcO?Q]hEӤ[埻8:٩GF }mˀg]d(Bfnӳ;MAo-N7Pלe mp!*_4 ũ62 ! (*|1erda18u/ h
C\/sQ^u$n\Ɏj;`q+M} FLa5v\|tȤb]&np4g$ߓƙHC\TV|ܣr+6tN#54{]|&|>9"X!LAQipWqp.Iöb<>̳:v߁w^s
L4qLxca_Ys ̪~(!@IH!zURˮ}wZ+k/ 6T A,%$<3w$\G}ܙ3gΜ9sf̙уш QC-=^G.*h ESlZ L7 )WMVԹ3چa%Wӹ!{yb/L:K$M_Ň ]z I4Uƺ-H5iV,w
at4mv[qQ8w/Q$xOy+v
a4x[q%aWд0\}dtN.QiXs|K1ZW1]6kI8 3Љ;eё{ ' NM)Y5KamQӴ*(M\HE^BCb@g 58 ! UrKs/^N@#0ڐu;O *pY3PJm# ƴZ w4+J=kgy/GV8νG Wa# [.\:;e$vd7nHHzB ʩe &bFtjؖhrC\f]:ܷLF EwTt,&&s7|GS ڧL4 f%-6śoC TbwǕ4 / lBT.LbCz'M o¸с| ţ"VgaEKMvѵkg:Kچ:R chJSn:f:Qt荜
TD1vYKL1GWAaذ<<Y\ ̿:*J&˨=-=-2TF]4˞ w|#zcZw
pb
Č%ӯfr1DIZ$T;X@!&mi/ڷo :a̎!^+اQd^'Y3uA~q#:RWV<57}.ypdxc!ة
bsq9(ʯ1ubL80hV\XڐiU `1:]cM ={ &G?DΝOlU
xf Tfl6
$@ﮤbl9 ]p2(
eYV"IU4]fe.eBrj6ȍyѭapw\L)Lp0nZdH7VP`<fMД M[CN-R}:zm2JҔhi0*QԼ
^n>}ӪQᤋ'(Q5,A֭MS ܫ;]v 3LnVXzGS;y ;1h+ 0ڃGŗo>wň<2%;mؾ8-SFs ;ktsޜKlAL0~{!#SG .ok_~v֠UiK,Y(Qq_}?424L imɗ&#|CCB뮬N0d)4
߶>_cw?HM7qS⧏'φqe WK:0{o= /ӊۓ6([ oZNs.
G~|3 çp6WCw c+^zpmw$.;c*" 2X͆%X#BlbZ(HF\&g!sΡa<C?GH xޭfl{x/'LL+[nHoMeA&ܵ'Z? fdAg-Z(;G 3_3XU&zs1ǟ zȦuk
˳?AUbO)C`ZVU0r0MYװ!e݊}TҿpQ4>謶@\u=8O|# q9q- Cy#r z6;# =͋>Cpʩg---#pH$?v;HO65kŨ8:: o,Yu-Sx3VIwfx+ /
H6γˉBy&)t^oIJԱFJբ ݭ5~#tN h=fBlǞ8z07s5-f dhefxl{.?xqd4ϹLlAxص3g(xݜa7ub^.kd~qp\5 o<}f[#s DrF8Jm7ۅQ;ᴃ
L 奓&\'8`1ږ c9DjKcy.X+-AA Z<
8<ûYߒ&6S)WFo2gem( 3?: ^ Nh#v8{JHep9r2eGTzr CVi{BbXT?1wg:ѡC"@ @o=vԈ)BIYYt"]Zz<կ3V A-G-
;&∣&?~2'yV9x *\xgṭ?<ii) $ *;~#-J i
o-h ex獗;;QuDhwe%\e|7):bK RSy])w &`Q¶7bm&derMx:i <{.VGFf-#dYIr)ckd6d 2qHy"FoNomX71kpL+
y0Y) :pFnݬB.4C l/G tzE@fq )rlRQLq'߇urS;0sd78IkM$R >JWk`u]pQqh<=x!(d5g(JoҬ5-GLHMێ V,\L{j)MI G7:Hk5#Ͼe-\5c]diԩ"sOJlIZ={[z_t5nO8*egp$ (Z@PGbٓ Ngԫ'7ٹ5nk^Ɣ)GӲ$'2RiMWƩgqU[_ ]`Z ,j*SB;|ΡшUH[GY2lzqѹ$'I2:&<_ kr )!I۶ L g.Ѥd wrg>8oB^!E[Ps2.koL?g߹b
E^ B4F
xV]}Pgg駣d,,쨲fG%4G}sOumȮ1nhO3e)VfOX jiiS]V)y6:* q逓0 Εؐ
5*X
2H%^a&mvD`)&xtGS_
3Fe |]_؈g?iLC^֜8Q85]\E+&&[B r% $OAŹ@ikX6 7}3IF\q q(L;OO}VW% i`7AQ
k OOAcKr*-aaƋ`&n!*¦cc8b`#\WE MGu6%ވ?D> ;~0AOչkw 9q2Z4?UNv6\_GqX(y9lܶwE~1FMZ`đ'>Ha=ׯ O=:po&./rԩ{ M5
̵֮M k֜Ecqs{to E
-9
7rB,HrA(q+%=5ވo8UΗOwkD'_ătB'mtffpHZ#F"$m\-}z\qQ}~*1kfC-_Wz!-;b.I3y.E<kbG&MI-RL uo BrҒ
nCFqzd:jPwDp7,4=ѭW:%i⽹p%
ZCHN N9v#`Cֵ@}84-oī Ԯ9 t]L:<m"#yGRn 40빼 ^_
t)s,w v$cj f`l HIE͐g W.y|\pkC|mQ^lR}t1w3:髕F^ &Vp$
cg$4ֻ N9
N ;JѸ#Q7>.swZuv}X0o.,5 Dbَc{*I
8``2 S'G[!Oے9)JAps
h^! $tyy|M =WixEgߟwP^ƣ&,drxy ]q7-3|1m~\ъ}w MxwZOo
(˥n7a(#dgJ`mY]"tÒġ0/Bh.DcM"s`"zT31 mnd*v,h]wc]Vj3(Ӝ2&h֚}d1<?cRH7Rp2WiIf9H#8Rxù!#;ERqNRp7,p}'xik&>Tv Ɉ癱L:O`ҵODĶM?'w9QoU줵?Ay%wAtUm:"N\YZQI'{)οo^ Ibf7$.'9};ϙ Μxt@%4jZfibP-߰sJ'Д; raT6tԸ
_a{S93uVn VMGއmv<% ?_tdQU&0l8 (qRaTJFZ/6xfp|2HDlaQ\DŽDХcP<f27}My
1e< y>kׯ"М vHEŗ L݄MIy G 13OIϛ*NĿ{GTc(SC^/6F#?]lɃqvV|s1g
rҧ ]X3G^!fq8piRz T`l䓅H_({u2hx|B^ŶMsj3hN;40΅ _q!1ǛH9)9)t ki> )0UStCrNvo~ 5f9*v eXeNњMu[ PAZ(Ȕӈ9P3k8O 6L\GN^qWN{94]kŔgNOڕ]
Zhܴ ӱd :# 1PK0Wհp_)D<KF/pA1w%;p" i6 ՖҷaKRzpw)?j Zӎ I&Iަc
9Y
"os?Aھo1Ǡhm'<9CƢM([1
C1<&4VЂƈX:;q˵Г9Y^1&?g45cْϐbd^2,Z&UcК5
jAL٦PB}M+4TZ}}ͅ\ùr'ӿB.pQXp| 3Q!h)*6;=6*E Fu?ӳ;چ#-} |Xj 皡
%< ~TU y"'S0$&EVò,^"0tnu9<Z~K끝\ 8tzuma۠;elLf29% ]: c0zuxe8 mbu +^I&0ChPs'
`+&A%lPɗ2Vc L 9 RRkQS ڤSF!lSmmxʅX۩ oF?:ܺSv }2 9Im'VGo&O4'Ӽngm$I&
:lQO+sF+(چko/(nQ1p- |Sb"j%xӾ<2 n@.xmyW |tjt֍t }ضGrњ} 7Wz; U 8MԈ{ z&FkAْ#7iBQaG4[ e=sAcz
@ yY,rs1;pʲLuR
n8s8A_wwq⟷\0._2)O>t͊Ͱg-] ML\x(ϥ n!HQ>N E֭N;*ޛ|6 3 @Rb6 {xAOdLot&s4#wW/<qǵJ}t<՞ғYο_owig͘D0YLGkNw^~"{v\xu@xij!lb=~q ( p5c Y0kGqe
w=^] ㎹y ?|Tr5>23N?06o | :?/u?[/?~IsE**Ap-pa֫3
<Ľ px <zO^x4=no.d}~A( $MTyW_pX wk;BU o3y0-Jl3g.Qkg\ /=v/<#OiS~
|2wupurxgsŅ;R<Β'3PkA]mހwv;hZ >\c_{3FѪ'/~q~N ><<FБء'r=qu'xwt8XRZㅇ z: VF8;<?<Og1.E OOp)鵼/28&*hg!Y+?z 6?Swq(FC]҄;E,?Çb_qeq n<gZs@2*>`=*H#^Kg3{m7\U#^ƈqO`36y6) ʈԿS =! ؋m?' 0M]S?!M+k &zRDc?XN+vs2aiKMa[? rF
bE2}(!2YЅM?;ŀk)FRKzn<m#S1 K~y3l|&P i7 -ڡGBKhWayBчiCh{ I"(osև^8I
5v~81oOΤ:-LxQM'*=)m" R6w$͓ߌ?uW]ęc5;żP.LU5aV'kҩoY3Xԕ><
ǨfM4Oub/O-4 ļY<?nnCB4th1'݁bD!-d*PDEA>wޘbŋv ' vqq yw!Fr)nd4&6Lݢk,3MxbƋ8=-]h/;
߮v/tQV9^ Tcjf1U[ic!
Շw1h.Y?(˽Z||~4/]9 6T= ' bWYkH:k[ Yxzڕ\:s +λ~:vz <A/\$¿&
vXe!kry[CA' 0=9ĤV^i~q @*Pe(^ *'?Yy oنGpιnjLDB +Xoz^=q;#~o2|<6b{
B\.aok@D Rp/b{^ơt6f Ýnǜ\+zqwTG:
E.o^r*~*M|N<;ѡK/`: Q%+o@srI7ǻycɁb.X"k%'>ekc]*p< >tVJO4_?70kxe(8S zvO4R 2Q_R R&qRDz BWCN"?W[<W
)HRCXgRx!m۟:OROap(nk7UgL4HcK/Sj bSڴN/AzpW5
zu{ѢE4 -湼fU $\RV=dZ3~<N<@D!=di;vqU8xmބ$%mق]4 ( Њw(sG %e;w% )i4*zhФ%Wф+\+=<Kӱ=7#Owt6XW9x*6: Ζ܅Xm!3hgpk{+#Dn4%nOzj܌ jx#N[p) m"ۑV*
;,:i6WIlvQb;ϘP4iM"w*yŦ3R<t4C<GR7'klv N< 6rfV3vil,N+iUێT6ʐ 4f7k6B wHekd7&& y<cGy 9of?:KFd7wcY 0WO L5<! =I6o&I[9ik:uHd#55yt5JI\|{(n*y<,
#Cd|gV+Y
s2~-{a\nmkkhF(D~%3 ;ε)8I'ﲏ+FahŶ,
Ƽ$6.4()Fۙ l&h]F XwG>m NJKYF]³H8։7#ߑT\#xdy0xUJ&ϺDO;& )XQ%!{pLe)WՋ$ h߰!1B:U
Ro4rO:)e2{~6tԶCp
RGth3t!Ũ)Եan*eVt&?dI%F "M~(erJ2yGwrQ]-i6WlG(OxG)RZـţY#zf ɠi|j!99ʤcPa]uk҂6I(!] 7¶
mI@9Z">ߞMuN8i>֚fZ4B^yӸI37o%,2Q">!6);sgaK^iY%۰1)GKB)|+/"xл3PE6&ٰ<6L0yWaT
$c
J'cyֶ4;IqGxW47|ţ
=~Pnкu8|DQ~ia?uC6\{«<l" sE ;70pl`-*,0cڔoؔdCj0q e7C& 8hG qXKO+x:hLXrmَ}UV ܶuOjOFMx弮Ȣje (e;mΝ R~I^iKG*5W2fpG
ἥs':s$V;ӑCJ Cһvf`;etSYU (7f=Q>(91%;
-KK ACppcYhW~ԺDցts: LS_iN<႐hK2rIG/,@)픙%4cv#86hL+Z- k474hN w|RRɨPd! #eJM(9V\@(nN=&6-ۨ2e'u 9=QnS*gp 34~MS^Q'OءtJ2h;8w-xJ4&dI ͪ ]vf{iP,cGjlMAux wu*-6mњr%R5P,5Niu)ȦL`9`IYRH?6 ߤsj3RW6#%stt9݄ /3t7o˴+K/4rlcQ_
9FIS(ƶ֡eDb8Nf YGsmlаV17 Ҕ;%%> ]M}z|t*:^.Y)HZI&9zxU$<fTX a[%mSz
|p)-d]5g<@ "KLU4~epC:h I]6r 5Ky+nyCc@9Pk
8fcHU1FꋻJr]/I<d~$z S81>mNHNC٧E{-REQ $feBdh<ygZj
iG 4l6 :.9 P^~EDөL=<:1C^ 9K"S&ڜ/iѲ)L6ćemgq?߁#TVFܰ/+L,UFڴiӊLy+_tT +bM>]2:\ktV24ƪ ocNr%t]oFKq$A+X
2%6f%Q a^1lb2h'AlX\cZ)2o4)% /;;{%3!;<emp&%8F+L[79Ai4:KijݤHIRV4V[4ʼnsL^Mpkr&PIoGeGA$8`U>@;ޑY@pBnbۛ˔.
VB-|\=ycߵ
.:__9s.]V˙Ք")4
Eu|<%LGCAT~rUgM3O&y/hZu un_eeȔ̶g*Z
Zy
wK3A& < 3fU?ѭZN7Pz8>T-\aL0|Õ#8
mwJ5 +gεПWF
E#Yk:{~ l2/me%s
_F?;; t;4s CѢ3J^C 3ëz*| ~/EFh$Q?rӨ \Ʃ
INGUwC8̫p5 *)NsD͛f X#Knl>~f7Ï,WJ/%uOxQ㒛Lu.7VdA-k:UO4,X*h:y0HcejtCkxqIc5Oj#O.;!=^pll3k,$8wvWQ*.FgwÓꍵJOvq0BVXzAB g5]p,Sba9*WrcAeN:klLoHfӸqw}}Ͼ >*\\W5k 8Y[] jyCF8G`u>>)R#18 QY{"T@_cuќa\ЂmɋA"\wFx)hU3}kwmPٶ 7SgMޤ*ĠzIhbp0rʾ"]dd_u[Xf1:G{S qzcc- ԑHj:XT}͇FC8l'-wrߖ*;C^\B.Jb`f FfI!
]<c"xy/Nf~yxsYۜHo 'deRe=~/J(/X?r#xa>)\vl<IKOd@CWi92WxZpKc^Ҹou=iҪlCk0*[ozql|vj7JK=#)٥
C JQ hi $Ai5p 3YP *ޚHh52up*-Ή kOjpqk [%u]O~Gi:'X%opO
:($Sk];S*N3 O۷Ĵzf3J0ß 2Q6+c;)_:Un.C&$
v v
6׆/%ّq|#$s7%\N߫e:1<\F9wi@\(ߖ !~%Trn%0WkGCTWU%W { vr<FbU #rt;+}O[p2%Au9ʒR9rkCG
m? ]ʷ шXO ilm,
8XP9 \} 9A[ |M%J rO &Np LpT.Z1 j4+Kc`ں]{V7Lwq0k)%-z3ÍsRL4S5R7rX lDQ[-!WT[ڝ)L9F^x8`Ŋh 9opeR1ke29KɧR &JGLݽF/`;0r! ~eywp՟,
$@Mt3 ,O)W/Kgq4TY
EZem;EC9صA2/hhruNx|xҜUNSٚ8< 2Zm*wip} cu}$ 5SvAS }69xһ7G{8T2F:hjdqXJAhdYa̐,%-^ f tfJh`eX
wwe7߮ "S絕 nr_
zps g)ZˣxkTᨶXh`1틤CBNl&vz R8<
oj\Y o*xYe)+ܼNm`]%>D-YO }& ~\\c EENZ1 7d{-=DZ/ 3
#- CKƶOCZvV!xmY~V܁qpsII4
z DN 7GW {-]}p0)\j;?N- v7QPT]Eٝ+&A?~|d92<!"˥)Osz&]{[Z.]S`o=ĕgc3 ц~y woӵCmʵ?Է z ' pB{#Fu?<7K³ԝȤ!2ڢV.*X_!P-CK Jhɟ, kd]# sm@=:4 1m;b!T7GN=ِOe)v\pO{@dpM]0SnM*L8wsO}W_駉_`|g s8xpg裼cv _m:><zmdN+V_=.-<|7]!Hhﹴ|
ի^ ~D jCW}F)xO4U|x:{{W[M.ӻT 핎4{'~~|և0>ʳtٴ<\ޞ'= (}~#X:b z:u$7,o=tq#'/ڣ-SfkK2g8Sq @ IDATU1һ8M]Z=P\IYpy>iEw(? _>{kpZ?.-&|GK[ zɨy&8}}}]ǻCUb oչ>|a ̶dn(sH'O2M۽ǥ ?8 n+(,M| O̥dN%.hwuuxk }tBOWK/|~Aq>;q 7^
)Ƿ^g`w8<ŧxR8x.^J<emr!_/?7Ipry|ʿ7~:8r}tj+W- ֵ+>y G2ğ.Z6j+Od`]E ?8 WWO[9+Nm/NŵI0NjCC,۩}S@Om~!zy~
+~S?1ɪ RN}}?m]Jp}şѡ~pʥ_+,è vm(֖_u/.ٍ%:c-U/2Yu7ڻ`q[Ш.O 5c!5H(h SPUC o.{*^NU>VK+m]釯
{.p|sQZWWux*ߏmw? .=> | uU+p[]kM3(u,ܶ
"*''VW{*@+O {qd2\q*G js:*)Nf%4 {
'
_tuwQ[)<Ş T <uSų.Eyp?]7U s
_ ??|VK驾h(Οx>>8νwx}~.j3xŻ|.ރՖŹ.|瘪r3.A<#C-ф?;\U> 9 y.ʧ j嗮! O F0|W|q+ty\p},GV
<.2AU .]Z ɟR[x@-w<PˎNm O=]݅`:ZҺ<mpץ ~]9&JO+`[rKnm<ǹ`wSt^۽.뾹x}w.=w= ]&g
O0\?Z?k/~>d`ǟo߁qQe+o/ /vp
~o] ձ~dKW|{/ %ҫ'ʣrꃏ+8E_i.˪RgzjΫ?ɒ$n
˻k{&D* ۷ҺJ@wx/ w-G GL
kE?Ύ.n_,):t`
-c_81{zN~u<j'RVz?uq֟ A? D4}L(8CQ=]wھgmFŹ|z:E#9r+KW3ޞ'S}3p|||J~]pkw-XmqX/:Smwtܟ.nL'8 \Dz|c`H}iת6ߟ.WZ_ݷã<I䡜I!W;>s~;
WiR&oۗlƩ4xBK-Jp;'uYhʻoSviŗ{WO{_M\}UIZm=zNڵk6aܵ?Ww!$S!?
l
6>*_FHS@G@v=!M@.U^r3g xQO?nu5] ?8q_{+(V=JQ3L;9zxBeҟp%8 Kg'C@]))A% s#p/
Xո}= nܝGKW_]Kj 8U/zIfzj@]?Wh)ϥ wxVYy]$;\W=㭗[>CKpuz*ΔԖ|2pw_#\NYwRvEe $YOCpSpӸh__pyuQI{˳NT&j M2o ;~NR]~ <lRj;[ǽ+a?OԿ5vmgMz /lO\ I,
1o֏'%Q>mxO
?զ.7="ݟغS0z|'' G3ۏ U@?pP; o88~qqy
'7F'J zu$r fԨ<n ߏBu#M~WeQIn?u_-M.=8Sj77 .puzӄ~v~l4_ DZN܉0]>U+G \YIK[S]?:q!]e.Z
Gÿ^{kRCW_$E \mpvO-Op\8i<J\g`vyG~ Y Cloo{0 )(_p݂5sBe5# \ Gr}iRO`?=nr"⪼JLU} ;~-`Q A'R sz/+dL}sRb+ظ .^]`~\u2 '/S5R
WmW_3tnߖV-նn+^ AZ +~+Yk!_Z"DEYSҹLj".5x ?͛{%leqƯMgA9qp\u ]鯫sJol lO҆=ӻ/ piV 1KϚkΥèަpj1߅k
qm?
8jn;vr
Gy3?3'Hˊ MuXs#_?J]K6i{k e%żWuk`ϓO>yj)R6kp)@ӖnˬTʁ:OUssN4!! (A-[p]NW9'lmM '@@CG\UѶ"av#/'tt״yKjYw_p8u7q%m$o&4{&x&aP4]ޫ;sKb7y3+/iC8HeГ4P\B(/*$>c4}Z䰼y
MhBODWR^Hv((&v5H?2]C#f_s"S%
VT50mZWn6yOyxDP%
9upiE[WN]:Y++J-Ѻ0u5@]tp{{wcW\sb9^97~WRI)V&I9ګ)F1ؚٙ]֬F{% ݿ ʋazF =ݦm|.蛃t۰ Z^hָ
tZJEVh٢i*[~S3qđ";硹4'Ml+5I '݂ %4'oUZd7 Dڈ'MB1~xYe2y˨θ=t?on˕ jDM~= ͪS<@|sHz kW952,xeJzs3v` |=erexԈfx(f!>{vD 2]9; q%s"̙"%1c 3 ߒ֬~_نD%8j@3Yzg$Qа%
1s1~hOoY}u翁k puB|̛C& c}~Z[s
wq')ݺ9Kγa#q%Ies ؏wKo!<.JrY)*؉'a|\ J Tsxgݰ;\q$nĘfV/HZg sޘEiUc >T{I g{}ku}а=E_]^ /GҚ2rR17z
X=,6֕N@3cUE2q"]MqSל<$<嫶huK.uџ ^v/Yhބ^9ؑ[/GfaME Κ:ԇGXX:^z1:F
i` aO!5ַۘn In : -w_~ _jpb^k@lZ N6[A['Cf݅1ژIo;o*r+3p<?) וs3@VA/<])w`ϣz200ѿG<ۜro矄~܃{v7Eo
/=,>Y-?\c&"?k+>l:#L ϔXͷ@\i
0{+5g1't\8XyEbc":t}x*L{&'g:9x9Ɖg^)kBȲ?7w9 wB4!~A`xq_QWz/~:'9\} U0V|ѻhyryj XyzJK~x흅\j1v!hDx<>'w(zl7h laޜ9A7 pk[ MF(lH.UFW]^G =قoqxYس3`75*uT&L^A*+ՃxzOkc
)«WA݈ ܳ:s(Ė(.(Fia>+:a<u: e?y+[mLhzTZ NXפؓ Eī~~w<=_Yw'Spп >{ƜaP \"b:`C1qѻk:8].y]
zcL8÷K \Q=Aw Y{eI ^~VѯK G <cuehFE'!ܡ0R
B寥GcN< x7 o()'e8ljyW_i+2iU9>.~j5O4ۄ %8Q< :um^}Fpʅwc !q 4T6i/:(B F ve#!.Ю*="\vW`XSy!/_~Ͻ6 YnH]t'ų_.kDDCaNG~U8وƈ¦ُ3;<ܳV0 -OI%u#LQ~\ǛOf= \Y}hj&&Gʯ9@s8?_OsTQ-k gvW㸡XҕX&'[4C\T+|`qo+VZوv!<y ֏hx㵗3E_y /9`P0<xΫD,eM>feI.>^~qxw+|;_?7k2|4| q4тIRΉKG EO1y,f=膞F[o~kz B\@P .8C9'w?\ǥ ԩGp'Lޛ)<MK<V|s ـ$FEz_\|#(K'MB8yal c \oZoԬm p͵`H8Z/zs~m h<nP)F9Էxis+pn\n_y] ^EߎvF7@a GuIg@XzlT M>^{wwF ֑#m&&W"?= kcQEXSf/* G2 ڄ҄^ن`Sf ;K HV,\AGX[I& ?+X:+쎈Q]PQB Mݎ5u!ٹ
6nė+1blvhӫ+E^,D0lv
߸ B8 48+8!z|4W-GL:}$aٻKuWL=uWh'Wf~ncbP߶grl[^1\.ƒE1MR2 6/e;09i۵DaVZ yu
RR0~?/!
ntzFlxL:i0b$X/W'&$?I37<reѻ_㛕IkAa\ŚX2͚7K ?4`|2{rcɃ0zdW/,X#9q֤!9;}DD`I8Д 'Hff '>ꈟ+B|=u|{3A7LC]8
0x* 0jpR]Vs!
2~@C(N i[^+TJt||qoFp wҢ~iZ =AGXyk y N:n2 -Z5Ee1>|u$SEf#?ts!y2 <
n&xǥ<x¬m}x1| woMO ' 9MsR݁}'.yN|8)K8z@ o=˟yg|42NZۧ Fr|Nۢ ^wr
;z9&t)SOBjnS%3HlP}h 89EP5^qmcinko#݆"%3Amz I } cҼ
:Ocn#jeɲEuIYLΟ}g1.<~L5
ǣYfyu҉8-pU k]ccĉHpvq@/U/ 2.>צQ.}sq1L>Ck/;:EX??
Ӝ=L.1*Iu7 )? d= <C{7]>dq!OoNǟb%7]bT?^4
o+B9#
=E 7 dTȃ|~iLJي<^!}{{ K%8z,'aYnŴoc̠hzPhA_;WJ|o4+3_<8ѳci]{-
C[b0y d&}a^w|CGÐcqÀ,ˎW\wFҶ vnڲfonV<Y
̹a
w7 0%*7夼7opDŶBV2"M9`t@VhPYϦ/ŝg|v4*
>_W]~T~ٷUPaⴋ%~d"bjt|qp^!g֞Ks0 ;~;x+PUtZ'sk
=_}ݼoz5>X l(.]%
q2}Vg`u"GGr(ģ,@vnt6ޟIKS $thkÖn~N[VkrUL _=%Æ{W' E1jR',x
>K
ʙkקzl[&_;M]ۊ4y/aZ/< ``Բ\ƬT :7vjmAzj.<k5sbp,_# ל3q!µg`2 W#+qטؘ IX#
C {+_Oi 0x ڙR!ؑ3
G= <flv8Ry~JB* FU7nS\\Bע"xir kFܹQH[
1Ŵ oEGǢsDDPvs~8₿ch?;9B#p䮔[n.4v>VHhm=((TG.>6NfsGLaCws#GX= -m\ yuR ;2 iq8wvxq?2!<l\<0w'S;VVW4j }G#1Jlq՛6
Zx-y5OH(ToEBs}m&d 6yC~ U43fy,|
mP.Wߎ7>*09g!ł`]Mn6
Fɇ0iBlB'Ei/|˾gcXk_dL'-p?Zҳ/NCF7TP6nO&6j㇇ -3D T
BZ0eQkUR
~.1WՉB &݁>O⦌_h9Xp"屭g_=U:qW
]As'rvWS82O6LI¢Ϸ`=+0A /u%0W 3}\sF[n4hH/m( &u7^
Lpv()f$eIg)'ƉcNĈ>12n0>C 0MnQcn<J&ɺX!e+ <%5.5WN|i4;w '/نOGtź rX2
Y?CaJK4j[><Mf`4G QԴzABZMӠs;, !dVW<zv :kHO˥D&*چ`mvpGڎG qh= _Ivm@>Դu VUd/JH AD)!UWWŵݵ_{w+*]aI{oB@wʙ3;gapdOl)س+A Ģ #&CcZl tTgbj{I} 3q_`\LJȳ 3~⍛eM- yĪbo̘=YUMDٝQ^\/C|pp*Ȏ쁿\5
2b1/
e*dR ν8L T?.ށGF×@R^?}J:xb_us8ᪿ+ l;n-r<| N89wcpÏᘉI :N|ZLBӧܛg")zaż"~4lbh v)Y(nA0ljm!?XwfˌH @"T^X>Ɨ Ed[
15oۡ_| MB?S-<|=j.< /n\F zvY8*nZ k FQ8:88`0
pԔ`ѧK_ᇵ;qԐ8$njϋpdz{z )+kժ0G qjn!><jQ琚н
dS[sਾ
bmEZ k@W |k6|c}vԊ"}U]}9;pU11#u <]j[i
ޓ]k?_[?"J+*Ԭ;V
lZ v7w?8 @]uѽ8~6єǫA#1Mہk֢[1|tҠ/^@a|Wf")/" "ۈH.qʊiX5W!I$q]c9 wraT[/4'M$5t6 /\5Ա5bRyꍓ W=4^h56 ٯEw@CudL SM+Nꕾ/%+͇_0$&4KWV JVE[2n."&D&epWW Ę_0M .Y^p/|1, X}Ո;eD/Gp??<yr
NQx#7?߂c14e=]
76<*qLLWrTvsh-q8p($s#q \V3l4
y70܍{ Uto٨d$~b#g1#[зف 8y5Taܓ7HI01;*)w`L}rJ3rfVxP=>F8]ظz ҳj7GvZ yugwʋWfN6q4+w Z h?d\I*_=Jh҃oQlaǝtvMٷr/ڷW`P/koZi^>>z[|e.E+_C| ._
\&8q j)^704lP(}qGA M ZNJmͦΗ+ N)V_]6!SZP~W&gųԽ78<ѧ/g ϰ8ukcjG#<ZYrdO?ъ[գ_>ۍ 3T ouM\ QTPϏ%I=ri|,'z Est* r2@_zژjۯ 82?#_|0>z$Ox ?TM H ]s?N ]pD $1OP )ظ)+O܉;? W=ߑAm_2Q~h5@ƫ53H(;/ł&F=mYesd$_LG^#J;-RVNdPۻ[#xӏg̰bDjBCY&g^Y))1ǘxꡱ*WBk< SfAcg"[85͛YØp .>V ,7XDW oІO}RM8c)1yߓb)2||}ջЫOo_#:ި d7y?5,M6Ki:GgoA=˩'dF8\ag
Vкz WK[d i# ߨ`+oƑ#Yu,][߮_o@7- b ~ӃCj4ǒ!
P [a^(7K5k3:d]X? 7ю n|e(/+y\.7Hn\
9mA _d k;n:/*NntjOIT.i.ˋpҔ<t V)[,:);&b9xE< ^gGA|89CC Y'wp[3fJT'2> >aK߉מYw̺֚ Dx_0g1>"3i =!w5>Z~"x_ TGk;
Ae01-E
LGNG%s劳KV³0 9 )ix`'G<n3}l"Հ 2ĔԂ +L q3%MAf ,V
ȫl!,ŨSӆpֶF}LE^ ZzJ˨(3O *cWx*L8\ei5;#?BIeŒ\Z i .yaKۼ{}q,entŗD%ƥ1{@cŤmQP ZJ|% k ۲0Pܴ]51<i}yR!ߚb{R]W BǓk#D8HosnU %RV_*yRo̻1z\+y?yY)땟hVWVbYs1o0mzО|!p- ?S bSw&˩W+B/([PH#cڕSj$:nju wS̼&BeTg[ tj"獏5H T{"{90#;*ŗdϣuTg*^G-:'Gg4q^mq
Wcoế?;><@Л[Kӟ'@i].Z\s8w:e"hT4zzN(V{@,XrZ>#?\6I #8w[CGTh~=yXŏ6}6/PyP)MWsi[Z9Y12:4o&/R#*k7 ]ypIɦzcMT]XT97dd!ڟWipbГڙ rTUz g`ǦWՎ{a7<"Gj((i֑P.5VwGR?%UD8w7Od:FPNC4
ٕ£u;
nRInq"z(7zx ^s1!~]-[f<
i3@VJNu\TϏ fR"Pغ#e@eހܟVqew:V7(|Lك};Ҹw FPu 4ʨvsdb١-AIQx|OHѱn+nc PI
Dl /
ٲA [/F?7<x<0aa/{!ab_&>g 8GnxXv(B,a
P͕GI}fc_gWpHT4(?ǧ\MǮNy^#gd"%rY |0Cر5Ǜc+
0dd_h~Z
x#փb<( 6SEx
*n⑱`#Eô)azT!W xf Uy&dW$Q^9g]*E%Z.Au{ӧ&*oA_es<pv~ g?+E& ;'Y<ôJԗyw8|۽/}kY _+ā̵|On|կع;ExUmnmMX9TKgW5 |=W>7td\2}#.~l{8w<RL%ji5> O>OUa/Ɔ,<ׁ8u, el .#o;dV
O_i}鸩C7Cyi[W`Y#l97R8x>q/#F}`OPuq"ĪrQltZGgrܐ?y}+껷 m3 ̥l߄~JԙҒt2gUy >x>uX|7EO~eJ=*%ۏH;y 㔱N֭[#yn^8GҦo[~
2sPTE 'x_'4yl`: `δ*\&-aF= Uf_'=\}: hxeصm>}CuW]Kvl߆[`(Osqu,篋0T7$Sv{m;x7H 3y*aܖ>[:rNEr$mn 9KKkn=7c7bq O17 d5
D85B7Ⱥc&{LoHkڛC# +;YihAc8WڥI +n:T;͉@iUv9/s
MD%`8<Ƈ1U-0kaʸQȔhVҒ<VEF֮}]ҴB5'?x |J|d=|xO+.%"'(L/<p1F 0NP1)9vfx,-0ӱlإ "q3ߺ#ܹނ}D$$sD 9jR/e=Kفso|_[GmX4enކΠu.yO?WH/?LV| 11}5(B +f>)H9}I`n
$$ZI Uh/XzU`щ8L$gg|y";w g1k 1T ,lǠoeĢ(+ܸƇ[ w*|j55ظk:>+r|(xe sАxo7c1
9*6 Ctzd<BNF6b`_K%_WqV{℞ަoY TNMǏԿ 9
2
~Q7<ՙbz3kS㍣$˽ 9<6%ƦagJi ~H U&~[>#{b݃sb`´(oV4LG FE#ңgM)WNC7xM]\)_>ev;ᳺ*X\A 2gݿ:;?IT劋>ߗ2-/r!|?S})늵3/»w?4Zu߭`έx$Μ9I,
%%%K¿ C.m~ٰ
Bϸ0[ GX$UݛyY'`6ί1S'7Qx{ݒp LjA·{{C/~ݛ<8u
`RoGTOM= #Q(+,X@nkze^窬V s5ad,Z/+psyqSuj۱|_.Aj)%'\85gHV7aOSgBxhOd} ^: o~~^!֕u]7^ Qֈ VDB剬mႩ3Z?-Zn
xR9_\EjJ ; ;6/NJ-97ݲs
zFc⨡θHǙO|UC{3OL57|G`ާ^7~+xN_qd Di4,KŒo>Ƶg潍S{
Xe<|!|vǀ#T
s&ODt(mቢ#l=Xi1!$7 vQOobq S RkcoK7 ]?v," R# N4 ՞v ݐs9I3ϺϹqUcO=Rjmۈe6QxZ7ڌ'^ k}ߧc+OPL Ͳ
q4Wo,<߯|Lm l5)2hT X/Po{>vo`z}'VoF03N?54!r 1?)I\ @ IDAT)M 9ƫ[AR̞mȕ@ .yi)ØCnKJՋ^EMp $yG̽'P}+8~. 5q6)c ԕ\yyz'l>G (;{JpԉiŶ?Gaǎ
x7q+Kp;t"3Oys&n/y*TpJ4VŸ<f ޝ^|
xGѾJ}-PBrrrSWS|íKD^BuۗJO:FE,rf Q1a\wG.?{RDȽPҊ #j F$ˉBV^T*t><<rhEˁժc}>4Pd}]-|"RՊY/|*+X ` )@O4& Qs,.p5"h Џ W W|)4p ,-WB"BfT&80ݽ-\&f ==q:1ÃKu4T Z5O*O6l̢` Z?s r
+B@"hxFhI~JxLZ(ģ,QCR7oQ*)9
^(~4r,"\j ,gxoAaé9Ƀ0R\a8Ud"č+ڙi9 _Dd 7"[7d*$-SkI_WU
D3R)Eht6,/{_<zJC^T
jKՆNt?t={*n'fSqc3=$h`L6c6@+_
h GFQs !!vd_fNɟi);Xݓ*-OJ4#4:)Jꝯ&90 B$snv6<81_V\wF=bbPYRjDFEQp w;tsyI?*/f9w#}<8,II} qR@FN *+,3' a 8YX*-v #bò7x=Vs<eA~;<iH&\LA zpOe*h*1E=n o&U ջD&qڢ0k.ǫ6\<LWQ H*ΧQ@dyvv&x l1}
Q崺 QaD I$u 'Ƣ{۟ -_ܲB({jEu[r h~5?jH=WsɣYxtat?Ndő\Ts!r Uɏe Ԋ`!PڑI7a;{jWtdrܝGSFqU[,㏼\d U5fAdT4+P\Y>@_4L+'X:lknv.~_;צ<)=qO
mIŬ{$Tns_{ wm "i{\B:ֻ~G&-+ ϫDеXBI?JK...GOj2W4Cy]:#in %DQKTU+Ld'cuC
1L^<|/^Ab3'`ѷO NF e.Jǥ'
+<T٣&7{Y6n8X
|@ j$e }yXJ iغ-UЯF G]My[/A`CYomTVe6}tPժhٓ^r
u%] +ɛ+4*Fƀ|ԞsiTɫ̟3EO`-15P}JUև \o
5|QT~)"#N N2\ʣJPvV1f}K2#řYE%_WNQu7 TQ-l,8tR/~eH%cxBd5{qUjZ{STqnBCVŁ Aq/ |El|>ODd +j(@4<avzҩ`r)7Zd.E|
5]1끑/[uY,KZ+VNpސ&~Y> 44Ysפ !:bV6ȕn+pris#9ӋʾL𗲑_+6ޮ
Y`4'#~ÏHItU]c~D@ T&
_ۈ η
kЅNL%4v] iuo Z\넜!}є
`{ 芼85`3o;˳/}DAaGtR^pG :dzykgWR)3o=ӷuulOR;P v}.2rHpt A@WEݳwA]cCyyW@t+*;V#`Kd<}]w-sZ< ǾnD%^uZ@ sU4jg &#ߥx+q*ּU9Zp7(⸨,L O,W;B);'Zbh' t1;KutKRstb7blo
y5juXi1( N%
O*%p J,GѺI ʣ"-&r*KZ^+
Z1 (ǧXPWke&5;Cf j'%^%^)lʊ0JᇉEPnG^o蓖sEp+_F/q{jl`Snbl?ckŴoΓ9w\?E7X¾Ƅ֜ɯ6e,7¯E$x2J vvWpzr* GR6H>s҉ެNv$3?H[-[X*N#%Q>rVYtvB\'l
lS(+y .۩n-і>H\Y}A#t}(QPmy#ANY{Ő@!s5M}`Zi5_:ƷhZr/qt< :nw<;e|彨 q"Mw ( GG[{?}IKiv{<u)͓⋼6_$n+V?IzU;fn M˚EC
ۤа.+8gĦ>tVxZ.m]qŏ ۑNXX z>$_óAqT4fՁ)ˬڄS86ss/mE{KFz@6=qa(gvC7w1t4EԲ[N& 3U W\Ke t;?Mi m\>p 1efڹ( 14%n G
8 ;[ {I=tVGڬl c ]hqnjBTSہĩg*pngs[^ڊ{P7o> }@qAp~ȞϮ6KڙT*rrxUjQ{_gOCt»qgm(nLNT]3vIKe'mÍOKufQg't \ne:S:)Ev2o&SWre/߶Юvy-4|9m4VC.iuGnmܸQ1Ug:Zb)ˌ^mj[ZG X[J] }W:r9Sv?+Pw)Y^g^wG Dg=e:q,fEEV^Ç|:;~*Z
C Q6=^v2'MDc$mI/W_9KW
^a :tz^kmܶ[
TÅ$r1rJu}/e ~7 NLj|ȨG
&>v^ʽo
%Bw6v^WΧ(MͲB 7`(휣8*+
;IƂ"Ckս~ D1D(dBބ[N U~ QGwκuԤi M .Gho=FYm{-fˡst;2{
Z89KSL:K?]퉯#yh$DW[֯qMu< .Qy/eW E-hm=K X GX4]{9/Gܽre$@p}Sz̓۔xDZEWpe@-v;҆c ]g5^42` H lH|:AKWoiO3]ZVe?itUOKuVLT'λ;3`q~!BW>[jl<t},t:BΖJy!Bs5 =CS< ؉2
NU&dC H{_Z5Qi!j&ʽq C@#cTOl]BpU#]2IwUgkk͓`u:[lPS{c&i:[ %]G{ ,+jDZ_giÇ`i~23t A `0 A `p@{L `0 A `0 ;hߣD4hu]g0 A `0 A@oupEH?A `0 A `0\#Кݢ.R}VVhmNHUά<at%Lɽi+ }][tt<} 4
m˽N:jh'Η״tsK{N_[ qq%8]{Ϳ䪝= Oqںj0awE@y{ù,:Le5?;-xt = OrsϮ0:ӷl-NCt{ #WMSifkGK\ǵfU;49=}{5]UY<tv?kkyUɳ8 Oqts"9~tZWy=~y:4Z9 g9́.Z>:Nmg/
9{g*O;]VN %8sOiԃG
a:/ڎ,8+}p30Fj?ciK<;NtrQ̣(};{͋=|mO 4vu^ښ=}iH [د:
iqq]<]4Xu=~n@裏r\qA `0 A `0 9E i).w)=;;3g n
A `0 A pcꂃb
-2A `0 A `0 TQqSzv}"GK__uzg/W }/y8; &Omj+ܙ>tL 9ҵiӶ^9 O_]o-U|gÝ^Wڵ#q[c A `0 Z]AwZ#d @WB*;\|;eb^[]wqC
.#d*7^[E=Xtg;3oSC+c; L՞8Puv(3y A `0qhQ@廙?nU E:o0 A {" tY]ڳg222 f3 ] yLOOOMcc7 A `8#W6n܈
6gϞ݇[ju}Ck?M <{N͞NǑ{M%t
媝+~5?rC9iyt7cķ{{
{ ?rszWU k~j-s\sK۟i:w#WH~mů%gfN+WlCJJ
bccn7A `0 É>Ye0` R@5A# z}}=;;߆?A `0 ?
%YYq?ZB}+̾ i6;jZwLM[|{O#:B9E]M A `0tmZekE_E t O]I˾͝|Xv #K)PF8JLň)\l#60q8ݧ NfPM p Be6 A `0t
ZХZP]XIcP duuʙ[
PX<<"8 }Y|?j"K~6G
fh@HOHrkZUk]Cϣ;m>
A `0:m
v~e§;*J
F7/tCk
G :* j{Uh7Ê#ގH^^Lہe8 7
~
(. _ oxyV- sGY$.}iaON0Tc岟Sq >&TmC:O(IS喸n pkD
X C×-
WWΫx͇t]VY2vוј8a4B|QҴ4
,F3 4'~ >]p'*> fʨ/+-&6
#<=U tB` F
'C&Ty|S ),zhRgߐrg0 A `0 <Oaj<wf|8ǐYX
w
̍5X<vl,Z
")i_?Y>_"IUq|0
*9) w>D m;ϼ*h>8$
qϝaB?i4 pժ< +O??_ o/Tko 7]
&ÄoMZ tjUf(pY}([] 5Z 7Nޞ/'DD_:te&M:h.ȲVdƛoǍ&uKNV=Hêc o
»Ln3Ϝ? %|Ʉ7JN uAޓ~/e
i3Ԥh.-G=zIŗ
zx4|!|ZTLG(.Ty I;pv.CSм4y֣BM[06@06A `0 СtYe*Qޘ
>"0zsRV(zRTQBdT "#B K5U,BEeٓSHXBC)\7>)uUݽ߯ W)c(Ȫ$=Rވ=/w`(bIGVZ!^
y4iLzPP "2 @}
2v#;/ U|BCmFQI9W`b Ҩ,Gfz *)yHx$/l ğ ,`[@
fكOqa}MҳQ^Qh#2!ai(-ʀ'"E>) 9Ej$8( eE(.@(HYDDCUy12rX~-(E !ةŇ ek'+JҊ*
~
8 Tx 啬wk*PQ]@s%!ል{#J
U|煜"x""<uՕHc zE$AVNA%'\rrsd'' $y )QmOp
Eģ#02>D 9P#|DG255#n
dݗ!!$ 1*U& $5!7;5ube Ė]_A `0 @g@Czg`m DTZMSJ|
TV[B#Y(W/ |UVG8
^r!i~q_b8~':s/3M k79#pb_õgoGoU_b]jFM-
G@V ;2)+Δrx7+ 9O>$qf@OcO2c+QEgxV3ƥ1Cz#o|}Hw }ppԚt0L|,\|yK ^ g ^ƦBYԨ#G'-|Oȷ;}6.<lL ? ;aE''obF;1_ﾁE ^*LȴdAxxכι:=w6jsv3/ x[141 |M\vC8wD/8AضSϨApMWcرG\v-ڈ y= 3>,d.¨Ac== [\OF vbw>B&'_5x凑8 k˷_geUԾÏEsc' ٌ2,|a< ' O¦e_cͮ$ۮ
GDN&7m,x-dz2X=Ht'=_!&!YN~ `0 A `h ZUVѭP H_'>bkq?|~3/4 o%xUt£y B\r
*`ʬ ?j 5ܫ.y˯9s3|w| !Sjz=¼m*\kPW߂÷щAV2j| Eaa)++][}^r# ?a"v 70%">2~>{y`<t)ۉ7ߍ&qj^3p.9'#16BEԺEo?-|q}!xy\Q.-pݏp9~ ~\TdmÝ<_WC8˚l v} ^sy)[{$˒e?~p繳k
x9TqnDZMɈ$p
hOTw/U`d;xt.psxu< (p xAv g+ˆKnňu;}0w%0ykJǯw
\t=;((#z+g/?v8bTTlJui1vo>sB3g?.
5\M6st\rn=R%Wߪr_q/n}CQ%s-&
SO9gw˧`XXoaqX%+ױm'5x"~$,QpoyDbg0 A `0@t-Mpư idC
T
jpU*~NU"]z[e-n]s!c{brFznXUTs@-FW#2L;wS@g =Ǡ`.> <e0~խ˩b^0X'+__[+|esDt F F*D )̕8t q{2jш$*}dfIO֝۰z2m`T.Q3=Z, Ksac>\) ZR^ЕХX*7
"؏=bS?Xmb֬ށOCzF/XR/#zD"λ7>2ꩂ/W~hsDN 2iDN#jr9.ŠZv^{o!Z[6ס*6'2<<|ϘC⥻IP]p~̓qΉmUOᓭ(mSκ]pBPUJHzǶʤPMQz4TVX[.Jq18vH$D`{~[_Z])= ӏ?}q
3R=;6狯'p<ʑ v Gd\{_0k e$5(*UU5*-U ڍ 18n)!=P9*398S4=Lem~ A `0 @Cs))'| z ڲ||:Xq><^Oz+~a~6ՔЗ̽1IêNtܟn j"/¡veϴ8>47٨/ W=Gz[)zs3ڕ/tqJA^}U\Mu\IE\qE (}ܣLp^>OWIuk`!PC{ɕjYè2:#CWWyr~wTgpKAbqzNĊߑX Cj4B⥖j {s_Xαj.Byun֩ԋea[ՠΟ7y4 zAj/8 ݻE3O481!NQ}b/BPPUXrv "B=شQxť^8ĴĞrX*)g[/cNWÎ S7#|!o
稳pN6˽6}b)Y #x~"xJxP%cʬӱ;/
?T}7} Ao&İn A `0 n I"!f@k4&UMc%
(DQ00L;K^TRxP~oo
>˯ [ҢWEr:"!,ğZ[@bNG IB{ИwQ3&;=qAdEफ /4yza ,CFcI(6;fqjݸ:XY̕tHE
9sM/ya$FLDD2Z' EZ+f:$su߽kVDU# ظi;H8||}iJg״22yS/rv`(ZiyEa:|M` I5p f?@<j0jdL=> 4ye&VWP|/ ?<]M4PPWEC2鱕Z ?XeZdFu5"HHLF8Iʀ\ Wjf P\t f{12SwnYS>? ǜ|S3nm8"t2y FhTNܺ͛hK"I'w6ˋ@9iRC
;/8 '>s=l?s6pw /wRq`DDEc0 A `0 л z 8i?:v:'Vsd%
^ է_h|s2q%bzŪ9%eJUxq+wQ ro -^yo.6u2%dXĭ/Q+ARRktc1 xWp궍8kX ޚ!Y5
F
ʲNz )I3S(ש3 i<Ov9 ䷾
w_7+f֑XpjL:mO7<wOp y9x|IoG_/Û.Ix(mo3@r4bJɭQAc=*~>[FfC~$@\% rcO͘
R; ky6xXtN&|sUԳET;{5w _,ƵI _[@t;4֓+քLJo= 4%+T~7~ bBX=gT2_礌 Wӏ<Oxb/x{QX̳>i.>d|x
t۟ ,ņ#NCb<*zf+pM?) Ui~َ ZA'Q_,,` T
Z`@a[M
Zm0**i<Rp.ײѫg'{z`Դ/IsS A `0 A`?9R_]P VhsX2$5Ty#L: Ge:^9|0#&&3N^x Ub I44m
苘n
VGEbbh2x3+yTW( ~}{#jc@\$t^?9+~ѣF &"{y\Y=+)}=( ફ%zSż'Nԣ#JV y11?P^^"1rpb'P<ӎ>IXutY11syKCC7r$ e
<x0r[ K Ct8 !Tΐ*1ǢGBwjP5+Qu{A&L "Q|c{>} 0{.CPB7 ~$
L
~ 2{%1n
0d$f9cFń)C1x` uYLd9uM{7 ^4(&$Q㸷%E8# F8ph"=𢐾u
u=O ~!F?ŌI㨅 #GoO
<b0bhhn"jXE%l_cpq.zXX ;w"p=g6S UGepŽ S ˮ2u qODD#.+'47]t6*" 1^=?|FPBf^ < W\3ÈEc-
Å$!@b ='dAWYAwL4fff"99YZ]ֹA `0 "69*~JMݻ7jxr6 ba S=u\MP/FySWK yVKFV1RN4]MSA7GVk)p2'Zl 6!.ˍTa"_R}^TU9O
P|s5# T_KD-^k_òհln4NlDRj>
8ShD& OeK^̫mE%2]"" V~u:sl rHxM8K~r|5+*XGr» M;Q;"RO>A 2ʟԡYxtno=v |k zU"g[e|Y5wCg]KA/C5Hv t2W ,h. G3#+V+ ,uw϶-Z{g,e3EC ISgu/B: _iO+WČ3GcwRǺ:/3A `0 ? mU;@V뫫8O_q8-][o% [cn-F:9TCxdi"sqBSpʀ^
0&&o
% ^*854)CbIH[+* ѲH ,¯6+m%Q?fId^U.O˲</U.Gņ;_>jY ,iDP\-!W!1w
\M'XՋG2U
,g5
IڽKP_0LʯC:: fʒlEIK-O)8]roaR$.:
a$7R %W'u@ ǝ77dD,8v)p
t{< Es:Lbp2BVLE #!#XH~Tnϯ)=S6G $$LaLIB/묵T:nkqLA `0 Ap Ц쯟W{\}x[o% hIxbiy0 qu|4"XtN>g9?E^tt~:~Ja4}ͫ3=f&DքNwk/JQFMOOC`<hX ~\Q`Y~*ϵmOU~GY% ⯝>*w?BjEٍV'6_ -A-Ԫ-grdi %J-dG?5c->{gm״Ϛ|Plu\gm ]ﶶ.it+^ m
l=%M&A `0 A#.]j -iɿ5Z k끻%8w ,O'|5]i/_j?M_vAؙ滽j+L7-++rծ-ڊoz+?W#<zXNKuߗImVw3]K4ᮞu\'68 n?W\[pi7 A `"Цe" &ǔӨ\+ؗaeQoooo~*{l^,~2Xt>+aB7eee}>]/j"DY$-%yF_JK W[e?p;//Oa$B'FՄG)>! &zEZlU~ԕZj SWf+;m V[^kEeߩ-wn˺ -~%mYښn B_<j ^=m+g,罠J>q_A `0
60% Y U DhA:L&qN|%ifE~$L˟yqС MM#%tC7:˪n]F0'm?űGuՑ\Wmxu44}N6_rnk +G[X:#a§+j .i +M_בj^:B_,Xt&IgWN_dL&;t~*Sc0 A `)`VDzj%Z9H2miÜ@괇 Lf^r'4Wx G?t _g{ { OgWq|s l|sYiuV :~aW{ } G?pWW V\ig n0=i4E
U/RF A `0 }tڝ@V8t0{w559 j|ô_Up=̇$rJXVZĪ9xy&B\ϙgN_%iaI q:MKqtx{hZ4:qZ"4[ǙS_yRM28it8+㻊'/4 :_~u|竝j
.kOߴ3A `0 C> `e`]K:|-^`N%c Y=}s˪i!t4^W]]u:}{g簖h no>JVвDZ߷xMn<*OvFSW~^er4-ONk~0WW jtzqj0 A ` # @,:ɪ,;Hke @ IDATqsri\<V-%U[|Y4dOG4_ JV5
\_WHvl])G롭6`Oӈt:|߰6gO[&oi4 {\wv:=s l0 A `0tmЕ` Rk} oۂ²
xR'l-Ш8$&tO
j"HhBŵ=8bJK\{ fwMte5=<Y7QֳG"/iʳ$/BY;&wWRݲ܌]Hȃ;
I]_]--WDx3˸7u;rԹj NH}SmQVhn'VnxRWsz9@Zt h, ~I3O!VW:FwW}ǩy3 A `0whS@y
/)7ޏeQ]G!B-=(q566:xxzQ [pb_=U|K[@$==er <:G[ i̗ E&eV X $r)j$)hWHim#
ر\t݃&yvDs-7c ozBMB-;("TE}b, R&! @z#'7;7KPQݝr;<93cckG"la7Qfb\L}nǔO8:Xc%:<Ax.E2Lc^- *dcڭ:v rS CV&&"C@qJ12r
B@!P(
7\AֲЉp֧Y̍0T#ac%"3BBB )[[{'8vR΅?5! r3u!n^pE΅ x"χxBV\g^] i@!LEfV6J+Hy;{ (8~^DFj*Hѹ Y MPTT8q&rj'%!)%
UFx {;g [q溲al Eٖ}F`QqvDiY<ࠕtt4 Dz(B4Xt9ҸG~nJ*iPm(sԇ@@ T
h: 358cUTUQTd䓿
=PvFey1h\eP^1G7Ip b7~[xOp\AC =I.*Az8{őߍ (5mOdOD
zG 3UB!P(
B#pYK&aUh ?d;9E֧ߠkx ,]+UL ݛo~."uహu//YC 1v? |<Ǹ}l? S ):6T!ػY K³~(ωTfC" tF u ꈹw
Ei)w#1[XCoY#65I];nB;k`` =3' 晌IG7asq >~psεW۸p=O8}J?~L0 pjy8XDi@Qw'f"Ƚz w;&aoaز9gISqR DPƧa=s0tӰo o4ODL0{R9~۸
O,\ LDz0yx{>27k1هY5 'gOCaHK8'ςwXjxfhi&rw*R
B@!P(Q # N^7џ~Ͽo-FNi>{' ˈ ;ؽhTDg|xt |y} #[:{ ^:` =}X0hBLr4g`83n BUXtY6}?|# Ŀ`r]N7#A|;z4Z z\Wś1q0r ȥ?{+} ڷ=
_'1$d*\ rJCu@/2Lzt!|`F aՏ3O#NmY2"[5C,-ӞGw`÷b7t Fh
Ww1ЭGot "4ܖ~M wЫWwt 4ȹ/,:4ogOÃ& rNWxV %S,(-:ս(}_)aLٿ {DC8gcpM9vF=DB"G!P(
B@! EN:њ_Avk@q9BNޘ_'^XeGb &l;:]a?A;rD>v̝6>N 5ׂsh%B#O8Q)ݓ\b78R_@%h.T׀1n@ q}}s0aa(r86 +;I: WJ"c"A-#1f`Ox9٣'E%|~"UjED]aoC{ h }{otBAyl>2ssiDGзS*D ٍݶ݅8;oBVrV1=%!QQ/Y,X-u ʚ×,CCh:]חR[r{D;t ti@*A?>9
g!0kǹ pbC4*}ESP(
B@!P?@h'skhw@":٥҈4TI.I;{Zr.K E ([;6G'GxP|6S-Y
D~M{B@pі֥{dy,JW ŊIٿ/Sc"єlgKq!ؗގ6
7 ^nps=ϽJ
$nPN' ke$GNp m"@ ^^>/֗/xxzvw 9x@ޤ͞6 tv |!ktu٫6^nΘ" 2AXC5nW>{[oVbwBf>&/?Y͛6cW`JSC:ф>ăǞ>ўN. nM&So{ 靇_ D 8Q N(
B@!P(ƫi`NzlڀX;SN 6r (|h֪EcDV~tD[>'Ca~ q
]BtCO6D+++hq2D$c䅉1|YAV ǡOt5p"yzS<2D{#?\#M ~~"9:OCDH > InoeC;P&NdO wvq~h_ m wL<6DeX.
M[_x] <~VxiдK!tD8;E\0m& WӞw6 y2yvJ}ܧgW4 lr |X8oȿ8 /LsQڼGi;DI #yo8ӆ
)= Xpցpwq
zD٥]oT?
B@!P(
<WeAg>@4E9i+[ն}pS|=~}tm'݉K^: }nW nCDy#x_ h/uhr;I F$ NĕVVI njtb;~6ضH/uܞ<s~&Fs8_j"5D
9]Cm`XrL{ J3
q}8
"ўtZ -T? SPC.j9t ߜ[ +#̝"m} *<
3oێ
6{+wlGډA!%h: 0$xa<̾2z
`3X
8b欇Ьp jS{21v/"H j] L>49(Ki
MOǖ=}"ic d 2}
Hl=pь(~
B@!P(
u@g2=ZcV͛G>ziEp 2[Ù4TCb[uC.Qۙ6:s)DH}}ӗxfgh0ë)j߶<] / :vh ZLV ́vqCO ݺw;}XΦ]Nh,cO Y6K 6
yhѱ3ӮG}6
:MD3d?#NAtl<# "#(_ 8[+7N ¢"Z{#)_ (]Ӏ'džs18L.dqFg77 qrə#y(K/F˶a)oGM~:v < ma$$< >xمmҠ3y8}% t>ᨃHHNc*5_lZ$֥G!)5go "ZB;ζ<z)hݱ#&4 QJ8Jc.;A[m[F LO9O= 4 8r 2KжC$|_{ WX9|0 + UP(
BW$*r3%ᴼlv1lכ{
[&G1_+Jsᕥ?aܠ^5*HdÎ,l5gb[M2.q>je[ +/)H=;
_ ]ڹ-ca}y ;QSDyw/
>v{vQ%\'gKu:5tF;ɌL4lP8 A0v4&x8 _~?^]MK 3[Ν>t :/KGz>c(Ou馾c <$=qL͋ x\IF5Yy4Vn.y,$ LCP.ozX6B%d,b -
K~ 2DkPV(
B@!\ŝI&+#q2gĤEN">Q|8< `FěqF&3V%P[UP1 VLXY[ɘ df)$\-07r 'Q6yp8ϝ6XpsU8!BN}wix+?N<}czs.lJkyC62WO;Dru¬1dcTjbz <F(\1vi c M@QANc\P<˲g(ϓB<!e2(2N`O;u*B@!P(
BEt&e!*snԉEm :vz7Tцq6H4Wr Y!2`gBL:`bBR>k"D"C&$B/ɺ9F1}Y/׳=##72XW+Rk-#_zr>W+e~z[z=Z,}r`δi [uyz߳ 7\R>RKƄ幜eemg.CSAƓ,Xj!2e=r˥-+_хs\eܕ[#/G<x[
B@!P(u.Ge;\Igr-?n?-[Y>KYh<I<,Mb&&ꥴQ >t?Wr2j2oJ,A$H3;No"u)k]Uɷ &-\jO7#l^YNʹUx˼^Y_e:e^yoG>t˫LU] 42^]
B@!P(7HIfr A~~p.))Wu?vu^}#CΤ2yx&I,Za},#/T7T|>Mv%R':J~s \ԅ˰KY .X`Vz6Ljׅ%ƒ_byK_n,\M_qY>ː}%qu羒y XO^WcK9ָX.W[W[ȗcAwѳ~uW,[ PXX(I*
B@!P(n.!Jm.]жm[UI ytLd_4RXʽR^_-G @A?*øXtu/2L8Xo)c)eQz+ɗm{եZ_\.Wjk]e.|Y_|m9d Kܯ+|;w. ԏB@!P(
BA!bK jL4hUB@!!
B@!P(7HYQv1i.(U1Y?zfvfؽ" PIkmE/s="qV>_r%|גW_UwJh ƄV+ayQYDX3g(Wg97RUyi'/PA!P(
B@!p!pE z- mcϔ,òuy+_9X/f-u~yz?\>OjE&#LȲ_.q"/^e#Ȫeף
үNBn4b)s^koR&]u峌w 8p>O1McOkrJB@!P(
B/!pE.>RWW /op-u+MҪ
ˇ z#Nk%c9ol&uj)!]tX-/)FQ;mJgOGY>Se<Y汖"2j"J+-^'b(p(-z3\NYz99R?%4^ *H\5,3mFgWXW$Jή4YT',[[`役TGyY HHN41 ͓oivI7 P7
B@!P(
+BeUaCks } }7e),Oe7q [.`;ѶMx~QyQoa mÒT-cQ6 c
=D߿;b6Ue:|j v ܋ R.O'b
Dف8s<
O'TCX*;7 -B(O
N ">)Ii=t
* ݷAߞ alTqv*v~ zBz8ggH"M<
0 CEH=oe&c 8}zЫW/xVQ\c WT*nj;8M~ȐT"jn ʫ/ t
}s
i}WfIdh ۥ5 \H>m#SOD9Y1~Th?g8ҎU/:DGQf"|sp}I18x2 }
sio1yj;KdG8W?g0zҝ7b Hc(pœ
"n/[;8ρ?`J<<c
\# ?<r>1pPƼ!$˱evxউw`HߎJ~()A.1|p?һ/l4vl߉Ii+AmP[toG3}X~T;HfKmX f~<IO6P(
B@!QԴOkJ ͒tdƓ>OEz^Bime"I/z&=x<:KxS̚:.\<]yw rn"7ƢOػ%ܴKY]/?NUDE Ą1ca 7%yXWA<NGmCN D9h8k&9
iYɡಐjqt:4kz -ʹn[
_ۇj740 Yc/>CN~!r EInϺ| -۠eh#S̙_M \JGp#*+"]Qi{2Og\4FvQ~Ci7ߌ7܄"\@aiQNUOdt]`WWe(Gn6# 郿n7CgPXb: kߎ )'1~(b"|b7CV>{ĩIu[i!s\zɾץ1_6 ,|/^\[FTbp
l zjh v(<%ߊ#=GDQ;'q'w¡A<\D
ч]vԦ ^u4_)TbUX##
Uw Ml 3 ;Z9SQнqD}#T2b_ٗ&J
B@!P(
"lݴMXM}Q##7G ᢻV8
t^nM=u5y
sY]蹾3]~Q~~~O1@֔ <#GI*3(ޭ8n ύ+z $TY" *w Ȣ8 Cqk0cxjCBOaf<? s^[%XD@ѵG77OxڑEa[;@0'C Gȴ1V>By!\5
zS`w`}w&r= $~x=/iJ9/]0ok=HBsCXH=ت, ڊc;SL
aCY+Lo 3s ϧw& 3t ܃؇)w߇m%J y
8;9gcG Waױ'gx3nxXCwB~7uLL)% juQ zoFc؛U "j=%p v>gF5ѽWV
ѰA(: o o/:D1qnߟO&Pq
\6xۼ
-K^(4 h o.$axBQqԽB@!P(
BFB_'R9Dz9 7{~s.G;`H,3 nՅ '#,%8&
#cIШAoJ\ԫW:[ x!?'k^9_/R"n8LIk*alҤ 6p"$2ARz{
UDAH&G"9VR"bca"ax=ڐM]\E-\# 4Rc 47~=r牑ߑ^ܼѺNn
H㇛G |#&);Qy6o%҅ĉCOhΞ<}9~Gn3Bdttz^|P} <h
[
_iD}OsFMAbC5)P2h|x$ޞ'tRK HZFh /ƪ
$&$M5#OtعASyC' vnEi>;֮cvWǕЩFZO}I^+H4%Y7;1~QgaA>Ol=&ғ8JXYbWp~* 1/ _lA#=7"$_)4hd6uU(
B@!P܀>]ŷn'do}GlYޥV#Gy7j ˰/<)dqд=~6_dxn-D<ZVuj.A&f$5A|lѦmK*ǺU;1`<< }ɒ>G @Z> ¢H߲|C:j&B ?N58q$:5'km4,~Y] ]ӧ PN_U- T{{xD<Z A3&[VVj"8 UU5(/JA]{՛he0>2 ;ț'cۖhѲ-~ڑt]̙7K d\@H3[yp,>c=?49z-CaC-,7=&"hte<yj۵CGCDh G3
H:UWT-5ƪڣ$cl*#y|o=ɣ1v#Zwh&ФEPX߾wVyS݇h"6=$ZCD#| ߯.Cay)&?4 s 6˷P` 2;|KMɅD۰6U,Z ۅ>MO rq{ ߊ>_Es9r8 O8I=M:˳oS}f-+ ї?C)Ѯ $CʙCx0 ⷽ [1MQq%L4o
47lm8Ryd^uU(
B@!PH]@nvoʥ3`-hFC8y3oCjB
O>{|miMZbYH"k%ЅȬ3Y 8p2~s|V|aa!/=|"={1g%oe8*|s 5
Ϲ6n?a]q跍p>uYAS] B |s:qDɚɛ
4oΟgXVWW} M t9*i %z8-b'}FH "^ D#I) x-<9m +gI+Yh#0g"Ts_|C'NC\y?)݄^w</~M>:Q'4|2p '\ 0aC싘3gDKCBkF8? }UȺ
:7'Rʙ&vZzkT@xNlws'<0e3;q>! ?vWFԱ/йy'"1·pGk<~xY FNb֛ns0#Rc|a/:w V ؍p nՕN2X-<
C[Mbi#W':hbj*9xaeخ1 ~ShA3úط4'-;G1*']1o=0ޜ_l:b-is,d44%7zG"Cp]p8dbF"9w]mS]
B@!P(77AD3Hag292cdc Ŝ@%B_5d)e)ۓM뷅R|CNown |=zwhb2QAaSDđ7&+I ^\XO>zkD&}3 {,:0VEaцZ ? X =` r7
b:W:Uy
***_Zhٶ55FL(xk3L<&[zw :'{zo_LE\[,{ԡ&jg]2F V۳@p2皋Sumk䜃
Y'F?u@Sl#\g_Rr; Ն?X3)
'lGIZ& zQ54AL_Zڷj@wl< o-żg@a a$><fo^1 yp
7/ur
/` MяD RI7[ןY
Eԋl~_88q0W6.܊q[Y1Q y_j|*vF=&MB;'MȞ h4 O,GK]
B@!P(7"&Vv1nB;~X `OK]"|~Lg<68Z.&,SEb䥂ܛj$Ixq\ߏWܕyإHQAly}-м]O<;</,ͦL
TEy{xN}qw#TĥA8m''7y$ۅU哱D6]0w2^Z =;And Wt\>
$7O 3 aPS}" Oz.-7*
]kЩ i#v4й<]]H':vRʾ:яL
e8ң@a bЫgw&dl.+-]ڳ&_s,*d/|lYO O@g uHsC[YF5f٭֝v%r 莆 0Ц~Y!| sJKhկV6 ç _4CT@sَ-0ɟft]EZE-zŹ4ģ͏VR1|xsæ%xwF^T$\wӗ}!ԐJ+[Y)H^!AcD PB ή4J
!I ɑh3Fhppqc(ǯE3IDLsʾ-J?>|DL̉EʩB@!P(
E;vk
ۢqKOL +_~N-iC*o G0ޑE#DUD
PPXW[a2-y+
M?}Z$Lۢ}C&X"\a\Q:[Zߔ/EJ\#~h!>~ X3F*Yti-9%x! O-&WQ0\?Eg5Xn'YY; fnA'''8-_]?BC/>}5^~|
JR:ܵ^0<=7Mr\EFזD >oH3d2OEmw O.#4 aK!xsyx/=2-_ÓxԒ}Y !i\9*& 8B p4 )}{!.j+ G^3MƇM辝`O;/_ 澅قvJ; O*9Jj)w4큆a-O_z5N0mWڸǟ g |od ڳ G!"rfLୃ
/a]-7H*U`цej?|QYyxgэNiz}&
hcez D(&`t/zƈuߖ<Iͼ أ{Q|(5o,3~
B@!P(766nfU-?mۆ
"""Id$fU6p5db}H#b
=wֶ0řL4-||m&;o [X_'<l=@FD;qK"dǏwP34'TɄ}6sp$a4;
l_yFc튗i2 VWmѱpoDq&8Vm`WUinF[lMLgljh&&`Gk^ L 9tIt+"ZGbݱV]sgO#G FhnF'ttf{\l SPTRF 3ڷkE.v7ݦ:-mׄv"ǖuF"L
Lm ''"YA@pCtԁ,$^^US'Oѧ"{\HM<kId7M4">u6h X,йMFY.u!-QpAn P6T %X{WPLA
cp95eXxh4i=7]w]s.~ck²Mmt:1sNW`Ƥ 3SL^/K .h
cTמmsG?=8Tzk yX~i_h =ptB*y Xg:.L ^h ь`F_}J}aHmfO @%u% lذ۷MLB@!P(
Aй ̬ɵui)?/Jr5 Y!ooeee䲛pqb]vmlc#gd$N DVT:?NU7&
ՑOm0⻥/bA]o ?Ε 櫽}iWs'Eeh%jflɊ20ᮡI*/6i"BL]T 80#s:Ӄرyɘ:u6t<[$o4~Wwf_k] ˍ\'vNO ,}
}4qrjw&qhڴ<P!q%9W ęSHHƫb+0 {5_>4GK[#
B@!P(njYUh W ]K~%Yy3*aA3;VgSi'0Ly ~&q1uakNZ[NRv ;cq9GvS|-\?yi1) ޖ\G1D oM26:c'r *&-~,u^T^' km>[4
kQ~MIOI M?O< 8>{Ʊ68YiY8ͬ0qWONǟ|b.mrb'~c%Ξ
J"i~a1dƞuby66DtG|9cGZ2#oN ޚP n;%cMiFs a*Ψk^V
Nǰ C xśﾉ`/?ǿTA!P(
B@!piӦ
^[YYxnUTcشiڶm\ujB@!P(
qhA/..Mlc [gŖ0W.kI*syzF|g]zze0;|R뺊 q݊i#֣;ѱf$ֺHu/ Xe^ہbi0U#[Zt|cY,WKutD5Kuֺԅ XCeY2f]HgC%y5оW)jkm_.}ǭ?-jO 89"Nz˫!W];:)='z4Tӱ c|G,e{ʓi\
B@!P(
KG+߿ !!!HOO rss닂AFcA߹`0
"e|||dEYXvttDii)G ˼ XG r&\']| 6usY֑uurr?Y> a9g\vv6Z:qn3ú>??Vn|ƦJ`%'9VK^Ƃ1~K>>֟˾btԕu_q%˾+n XWՏnyY3g,?<d_]n, %S_fqX[ʯiʱ, . Vc B @ IDATJ}u_k+ _16 b, Hv{[X`< X6JWϾ}={G
B@!P(7 WtqgСC,ҲW&od<~qk.)R!e s]?kA*˶^ U_R>_khBSZ]ߥ-s֛%t%\NJ3#yX+߷kw#W˾bYz_IKe[]OK>K.bQg]UP(
B@!P\bAV- pVի
גjeZ^嘭|
KYU9,|?S*ސYג4;岅<UB@!P(
@,-M2vpY.gYʳ1r;QW)wg E:U&\beRynմ~۞Dz+q/EW1|5!%v'J'dKk Q b( þر\sq]m8ELk oy8GGz|_WZuYgYRzr 2j 7 XO7=9z۲+-{N~ MW 2/[JmvE<\=[]SW%<f݉GR*
B@!P(n.!C.uuY]N-uuɸ$= Y =n,Z9Oް.,輀-&h##$rXF©p=dQIhmde9X[?>ft2d EWg]36:͍}9d]jYܳ~ \)ѥD9yd;e-e48ׇg 9tz ;#˫B@!P(
BFB_j Zu% se$p 8/}G}yI!bw> x2(Ut7K"QܿDŽܙ\g%i()CVv.Th]Eak=y91TW!--
e`U#B&$^T&?& /Mi ZMYY(*AY,\g&L$F\^()7c}2ibdff@|3eZogGeyu<xs7NQ\Fk*׀:VgRZ4Ja L2^^9/失gD^vr Jlm)PQ.PbPEг'+-G\XˠcCڠ <M6-!?h0uU(
B@!Pk+]P+?3cűNl :IyؕV5SZAV]<<_ހ'O`eLzh:E3&w`x2ػ %EL{"j ޏ v #sNasp>3`{/罧 ^@Cpd"ݒ9{4 _{N&L:E4`w)(MSnߎT~YV^# . WvA3N: Ͼ6Ktb(JQJ8^^ @I33ËƘ⥞[;n=c2ʡ ocL9cP[FǔL/5UE%~^=uIjK;ok7lR,ߜƺ0ZET\9SHPS Z5?Gqi )!/= RT [OiZ
/ryh /,kǒL=a 9UNp;W7I-VՃVM|/7fUEӃ(
B@!P(nCnZ,>f{ lMA浭NنG ;P G7c` ]xqidA*JQ'G]G39GAX_ j MvGl^M"+Ϣ`$OgPcKȊx *E_ciiL zxfFY?&3:9QWr0j3Y/|6_ RKuŞ DFJ"%01[Iؽ' D56
.Cg` x)Xq"Nd
;Gh /7抦%X5Z!Q3z8PY䲵<}+UR(?ߛ=leb[9^1AfiW>^_[} WV ͚缳h=JsO.8{y䄃e p2)DŽ^AAF"]͛e {7TQB@!P(
%kЯ^q UejUz"!80h@Od&bHCp6b(tuE1܆aރW'iވ; "ѢS?о8Ԫ?7ls!`ENh& Lfj, lݴIqPjƍA&D>lP]QwXhDfZz(1o}
_9F]Эg]ll̀M<QϠC:7<Lzr>[݃* )g%͛Cgeۖ":}ܐ0`gۧĝ3Y:?CPl1xxXu c> @A22,'2$be`Jue&`Ӗ(<,84$>
噧P~C8ebۖ->
z0d0Ohb$!斡 Gث2Ξ]#F
eؾ ;@g?
Eh zv7թe{rh[ccѦklv >08ҙl} NƧQvB]1oR:vb8 B[_o$'CF@00a7K*S #GEMAv]14ęزDVq
lwyEH 1-8d ;yDe$eYounW7oxۜ7!1W'5cIn#1{ӵ hA*=;c!$ ,C̑@٩9`9pRWB@!P(
IQI&F^<d"/ibiX/ ;ű_CZ[wkӊwċm |;63j(5ii)·wuu5 S o 5[Lq8888`o-3 VMǬ?Bn)۠
"yn w˖Z? 1SK"D͜ /"|0l.+ B_Gķ6]ܹ "a>p&VY7Mw~4IPs }'Sμal1"T<`(d"d}w؛E w1LSMIXeX|9G ~_v BA!!{ ~ٲi"ITVR<8U!W" bh2"^mX<'>v¾EGav:1C!8/܃; 'zzOشB*kب
>t0F _.zM ό_T >OwD.
Ѯ}[ }=6
|HL: HlZn7<4<)6Phm ;WBc;ibrl ;d
#]KsS`˩, 4.瑐]lZ"mB68{h8rߑbh{yY)aCļ}vbpߜyI+"T Ʊ {bꤱXbǞy~R'z'i 'o!li 6 NG۶`W~ن7g \ <yB5-Ƌ o@}кfq -7}FdO<3yX۶ߠ>Aw9G!P(
B@!p @ r5?oݺU;}x7g7FQfj B5jhyF.9?5FElZx+J =VN:kڣ T:LMSyA6cvkE g{
-%9Y6JME""6j6Z\fs(xݧFuA+/V}@[hF<ߪLFk>`_sZkٙkܬym_P]C"o};DQ2v>ڦl?yvKDZ^1-N۴/\!J_;^,z0JOV|ŲW_}XB|(ZUڰ!C['ޤ+~]6e>BHC` Vj gNYEʵ_zP4y-Lsf-r=ZRܑ,&,C,~6~"-#W\zxٿ^`LJx.-.2Rsqw_,!aڙ ZuY`='E]?u 7j,t~1D#D^X3^m_Ғ<mKVP0FX$?YI'lm~u6SQUQцzhދӴ>ۯ+iJk6Ԝƽ(J[m˴r
%Uky1&-i͵QZnYQg֊|_hGLΦ䋴GR&k)T_kUF0[{mm˴ ڃWljk{ Bߵ}jG]ׯג] ăQ(
B@!P.bNDQB$̞2ܺuAM0(,E~~)o #BM" ѱlwU+=4e'c`pҝ\/TWW'@.SZWra'dxX3zɞ>d-&Kw s r!JZ]_1fULZkh 3BӮS$ Bnz
j\1GiΘ0t# Gޱgy# k+6n䆀c&ዱqAy]څDueև2*)Y1_e z.&98Y1a23#>}aL5KLV*dE INl=^ŏF?5# ?}49Éi3c.
W0fgncXhe]\#DbCHOѨY(*Sҵ~ge g<6"B/ #{e.flD *++o|0eR 6۷ݺtpro #ƄX]\֬ď|F}nDcr6z4f;z~1lѺpajTUac< (>O!$RA@QTQ*Y}6φ FBH#Ιݹws("ݙ33g~3왶>ivnTF?3Q4$'& n`~()%hQ>b 5n <q;.w4^~
B0j{LIlL""* cĢ%)Xl{vVҖfLCe98: gH3g
f_ÈХU:[ZB@! Bp#`lCYcc($Od*/Jig2PoZףy+MƁ{s
2vy.Op ]RV/<2G`gw !*O~4m&Aٝ 5֦Z8!i{+SY6eYn4GO?u4A4dP_¢J-F[
O90@}ϣpE-:{#<u8ܹU)蝹i5ol]3aG44Z k1ߏ:(r9qڠKDVID|0
^p
Ə;F'mQ( e g ))Ο7|Ȋ?M!#%=KtǐmӧJ`Dݏdh`'êiGPJÂbW|ov/#gôK\l |i51-DGK`Zu8zH0RRѯX3 ܊ѪIwjɠ?~\th Ck-ގW둞9k_ ]q"MqG\5ٶr1Ɯw ]iψ[Q7K!twu}*ӽz m:"-S9|qaИF{ |,a%"ÉK.HzFypwy
bg>? LkfuPY3I7Aei-B@! Gr^d)l}I_N}1kx}ؼW<t$&&#>. 1;mh'xaQA*/o[ln7])MD3Zoӎ´8 %-(dIJ
4h9[@n@|b~_|3dҥ4N-5U:1zدC M0{m:Ъ{ZKQC)">Z%ཧn֟OmX
/OepGƩg K[`kdZdi (O{po"M3'u[`q5UW_;ލӎ Df%٫4@W2]@D,&\;?0_{1b"Q eyoQ j mmw>BZn1bEl:VϢ ܥk;+SE.uEE :7M\˻g"ؕьq69#u|`n_e;$8aޅ7gƠ6_(\7]V~
RN_rN>'Loڳ s t쉟}[2E#-c"|ض318gEKd]}{fA6`4Z]N,B2zs}2Rם#l ז"%#ĩ|9 "!>TkZ )Vc uKi3N1pe"˥(_+K{}_'&]r!>>%
T/>eXGZLY_:¸hۆX[zwSV#N! B@ t ܣ>o<>\r-<g8f
|F'{O0`㲳.BqTdⲡxSxϙш6^Na99Hݑo ]|6<(G<#{ƐOmEFQl Z6 zrRￂ.]{G7L@xlY`nh86PWІ_~ [ѵp1~U Dxx0\hf[BA1.N?x73+[#la/щ>'mVn sghO [=r&qzEXvWl+i 7'1|2n?'uH<8Ɵwt.V~ w@x M :l !d~nǡ¾4b Qشb&hԑUԢŷ r_ j r
j+Tr`чfHGUxlذtn~
İQ{'ISFPU6yv_KtI
; iy)2
!uh{9"e x!>79/Ǎ= R^} `yt<~)B3P\9 PB3oTh2<;q
z_1! xV$BΚZ5E nCj'|+O=t-ziG y|6 ל=W!|!ѦwQ~5x1s>KH_H8Hj3g8FCB@! 8'[NchHJJB.]lX &|d痡5Y}56 ѧafl[K#^7#_LTYRbk=*[\B^OK
SÛǢmRᒻ ?P$S fBw?ΥtJ)4市vA =Y ;R#-c'/XFBR2'FMNL>$:S&њr UFcwDqi9
v ={A}θ"{u(Aۮ={s&}ʕvos-[k,މ:&n45
kGrܢ;: Lh^V:3V< 2~:է ͮ+LD}Kp<~RT^!4:ЂFGx(UauISyO4 |8WіhIq! IV VNn0j)nvZ&u 42*鶐HyI tiI (s=5C irn|W6}*Y!to% u
RRaGV6E]ѩ].c=Hݶ
Ӻ-zvi Xr-g6TeQh (BNJ+im}^hՃdA\R[DPZjJ*1 i$>%= 4 u2ztB JtBbI
WW!3k5?*} '3
Y%ud4]۹[7Öl$̉`F6+.<
< 횠}nG-}T}N@! B@>
dtm $]=_-P67;-^^´a/ގ(94;mCSi8Vܝ
MH@cqvᙏSØ3\זcqwyڹ`Oz=p8tg VN==H /ܹ>OJkyobMeg ƕ-T\ϴ<=3k4XƛN7f<_ݗ/}So1Nr.B@!pw֕
96ez MG]&
smZ95/N97y7r/VyՇq|h Xi= gVlGry̐#<2m;=ƌCnVʪ:#v,z.qЖٸ,ae5.# & ʷ mGj@z䍸@H>F\}8 Y>sLSFFj ͣdt>Mu|
izц&k;1
t^HC3Rzq\q\n$5 ԟk>Fjt:7#yӺpɗ>ڋ ŕD4/n\8?ÀaF|f GI
ظG{ q =D,zF; f2g
rV wz_B@! Bp 9sChӦaRza((`fݺ#
HхB@!p8:9%%zm,@QC;! ;w.NoMQSwj{? 5G ݈ N t.^g! xx@X}gF?=Gu#)fT.ɟş#CYl)QyA`Fгhf
℀B@! D`trkŖ-[N)^qM`큼Apfj3}(Η[nNY&9?Xӈp1b̡V)% ! B@rktCs'Ok#o͑:7i4u2y1|4Gg)g֢{,oSyfΝG9ϝ2܄ӏyդg&=k㿿Gyg5 od߁ y+#;2<6rM =5 =ԙ|s5unpsd9_}?'B@! {5%E! B@! t{]ΣbFP|B@ 蹌YJ(B@\y;U*%B@! l&
t`( i! B@! h@gOB@! B@! ffd{ΑE/DBBͽT$@! B@! xP?sѷo_9}gddAAAO푛x! B@ߵhf̴LW?V܇K:Alll*@o2! B@! ^sO8! rHJ:B@! ?^
tb=9sK}2|m~U<u2zz7aGW9479Yv䍌9 7Moq<'] Y=מ~3yG㲞N]{۹IS3Sv_$gJÝ?|-
Ǜ|S~qLM?&ONy9:e9uny{+gnM9+ JP.CMǙ[J3ڙ )<gz=ݛNNYܙwk*7%kutw;ޜ3ynx3a2#gq_z9)- 1?os[}t%&/#{ q7x;zMF{"~B@! B@! 1 b]$;! B@! G,1Џت ! B@! D@ é6D! B@! 8b ~V\! B@! 'b N!! B@! K@ #B@! B@!p8p
E! B@! Xb U/B@! B@ÉSm.B@! B@!pz)B@! B@ NR{``"/]O;[Ԧ}8_^w0:9yR>llX?߃7dG'khhp!!}kw%s؞(z4Y7z߃]-4QL! B G^ff~F32gAmF}t{3W^y{#×zqLNS_^y_oR2pgj;zcϋ{x5)=[yp;ζJQVo=Q&WB@! B p
t2\WS]rPUۀȨ4CuErsPCQ- d;ʲ"FE˸xDHO^)̑VSY T+4iH>:ݞi;C-а-=.q{ )L3Mގp(c Mz(um -;n'rG+IS'̻ 9EP##>%h}rcv Mxue9\RnaБ8kJeLZVQi9B#!.%}M8`)ȤR|n7ٟ4L dVIYQv 8,rL
FaY5m̝͓W[U]T
>9cE=t e1Nn܊ o ! B@Cyfz_ƫ
^}5"5P@/j^^+wg{/E KLn\Ү=:vh?-~YXb,]
ڐ4iXJםӁ⟅u0 Caj6l+weFh,]2Lϊ>V^^FzwXJ5q2&geӭ3[ƾ3ik>X̴mX/Xq*ktpˊ jR,m9TTnW\i'TuZ`q\FW.}L\-Y0ǵ}9/[. ]w t튮]gښ>nQ~9h؝{'CGj?-[Epx\g9˘iosxQ\mp6jQ`ioG1aV|7=ҳ=ϝ5G7|t|/Z3?y :wsz,(&fI~&<]:vZ̓wks f,XO?sm,uĝ~o]<ùMyY9
! B@oXNo4Lwgo7-[rmN<i8 0;i*}
BglG ConJ |*w_[Ѥc
5/VF浣<] %2~z_3Peu-kųNMoII]|g\-Û*k*|,G2vzŊWގīOކ[47=s~ۄ\` z_v.vYxMهFҞc9>Fr&z2dPUw^o cο GHDTBkemݩc=[ɏ*}F-5[^
Q]VZ_E%.I:qݧήb\%pg&ƾ+$Hn:sck A|R{0ٲf l
\4;$kz2x*eAϖ_^a:❇w_c}3÷pOyB@! 8 4a7 t~=B3MQW[ `$d,l۞Jy$;B#48@4Mĕ?44.! <J#3[L hTpD`˱?嵆O[nC_uòu(\+, DBbZ4e]IxghvM/x /v}]
QZ^ #5yEKlKCҍG(6)S23"d FZƋGVz*Rw Q-ѩK'DGp8PAFZb/qPե4UneLFNii-(O@ bbb:^kEuvӬ0I.ldBQZ! Ju+ 6IrQC$\9~\LvilpW"=-ZĠ([?TfhuLEC]5S#+ a1F}m
T#ʖMr -Ѻu+D5 CN 2ؐm
qr pSp VLG*Ephªk)?B
"5`b 5ʟ"d2w -Ad$`ۦ
@ъZCv.UpMGDX j`uDP> y-塄
E+*6.)qx*,܍ ;KvRڑ4#|mAQߙThּg ܝؖ9Q :u"=wn^>DCd?rwBΛ|..C TV"*S=/7>:zwiOgĈ Ѥu Ֆ`.8
I1Ćxa )?DpGK TNhKMXͮ
yhNO}%mي:?n Н&[ȯ :wEb\47=FV? mڢ]rk&`?B@! B ^\)6,Vf~_\h^jUUT55k?cYMG_Fem].C 5ozo-yono|NAє^Uo+u,I*ʇGB oyх'}rNboxO~e.-P/3Yz[uW袦EkIr2 UHsoj^Tm=ϹNjkNetVP/jeKCfD۾~ :YeT^I ԫ%sQЧL껅knV o@_Rw vzWirqTMS)R,Xuٴ%*yuǝSVtc*eU_瓮wk" ٦ڶF=2Fr,;U2-Cتn/떨l:SIqV3o ~}5GTq*V]N-~Bs{SyV-s۬37RcYy\zjdWڧ^6ES+}͂U]j]Y^v=ObTuq=uzb֯kWՕw7ҥ߫
-Tq1 *JwՠκB-- S qG^}q>SUӯ{\eӥ;Ԕs;j[ˮM5jW^ jCFN-+urVVfzx}\-TZuj6o>F;A}6k)ܙ љO}ԤoQ1%{V|8U[uJʪ+Q7^|+\0Hwʂ3qB@! B)<Ź
-٬'V'LT_z}1SpzufOK&q(V?8U
l}e7-km[/mzoKCj^~5=F z1u5]/ď.K_-^^}#5s /qCh3'?*H*?}:Nox;-S7pzwY3~M]p@ oSUA%U]6ʏ wiҵ@{"C@=:l[ uǃw?6Xşy]\~u |عjƼjŒꎫ~yYR~fHtaƌ1+
w{<I9JߩgFnJenXJﭏVׯV=uژ/V
l:U=[jcUMRwsaRi:_5 ?wīk&ݤ.<ko,y66hθ*/.ҫR5,_9?^xn5զ:O6ЍGkSNTZyZWwՍ- 2\uǥ\r" O1S@_NMǫ{ |DMZW͍U֫&]{m>xpOTv ]_Э{vOB=қj̙VW_h^ReW7sߑc7OR
jVHR.|@M{ 2~wQX
o>B}\v;~}ߩrTUvum9GR}ڝV]Vi%he_ܥr:˘T}xTBv~aǝz]DOiT{Kjkԛ:2cFbRδe \r³,ms&\|,k_3֫X~ξ\mNG I! B@MOqOMݼY?Z'fGG3j/; @ IDATnZ/=c©#Q
kgTV\JSUi| Ys'wꉫn Ͼ?-q
;fXCG4I5BDө=q
27!+^|V݄S{0n;4mT#9n
VTSNUޘz]i5GbR[ i&Ly>>AP^T2,و{^\={英Ŗ2T>{K_8r0x
o:t1|| B߉x'1jH]4rVJijfjI-ܶ.
GZ|='.MSy۴+> wcᾧW߁ރF{nD +ge3|34{8\r-F
365! XӘ}kw_ܱCe\l~JTTb:] :%`x 4"]Ѯ cέGk~l9G"aa7O] x~nr9nazAΉWqoXr@K
ZdKnAl3r Mя4'))ڳNBm[ ֯EVAM)wLjQK1x}bRV߯Yng#_^c]K#c; D9ՠ ėK AU
ţZ
~}N <74g%b;ɿ4-=G6ث2"g=mu ÑؚvM@4ꏞDƿnAϘ DǶ!tL (DTz?>Հl-f`pѸQHjuH~^P'/si:
π#קkV-|
=, s(X_72iJpp0),_8;lعWCݷ
)SЪ[,Z&m^(X_]7\:zTd.6 4# )?XL' 7PY0 9)wbܨ! i?TF'B@! <-( z䥱z(]+>cBՑKlHT |jQRLk
GOkiz`(%O:3odl4;+h/ IkŴJGiݷ֒F]%9;0^m>ׅvfWi!ؔ<wŋH:0j;wbċHRC1|`mӏfCΥZfG#cSly\vg [9(BˠZNg)O ?>pko]QC_?UV
ꍷx!q}8<Pag'*=zh4ZJƦى ndHSjkuKr< O{EXnp5WZ||lo[qU_GnrAxId</PQRLn3j
ɏF-
Yx8GChtk;>@K,wgsLwCA_ ,/>yfXz|iC> 22ZRd_oŒ#ч*־1G w6iDR<~E)EK,9 ->T4MjtX3ʗAv;S6G!zj
z :,q]Wg6:.a$ :ʭKO ^e8Нo濈q W ϝC%&Pm2H $qJh vo^7ݠSЉ:7C#rKQBńPan"'B@! l
~gץK7tp#6&Kiϲ8h0dg >q_zg^F?w,sc*
IG?ySmG};&`pԧhvGq >בq'WĀOqSPF;h<_4Ѧ-)6b+4)f 2h$z.:dȠ"cwi hSGۥҦihJ;9镝q^
ƺU+OieXփM&<QnmpwZwd>Gg[D7қѴc6ٟ1)M
U:Lך.= ##4UTK T: ~Xn2hCU-_W؊cY$Vp!Iwv:__뼘60sA^Vl>dDj@aܴitV]urpڙtEdiݷ Wr CI'Ls=t>ļ
n10_Wlm6N*VgTUw̢VT<l6S/;{oX N$nN+o Ќڠ7.לXP"S%fJ^y32ڈ0BlUe 5姣Sx,|;?G"f.piaJv.0*5t8? v_XD2}*t *NYrntG m=fYa>ĩº\ ;`]_! B@!&m>ݏ[kF=/?Y?`(;v??!rVZ,3Q楛{v=GŶ͛ɘ)@ >N֑xͭFS\\sW_Mײ:$y=Rƀ~}i(TVZAqWX7+ DX=펞i3j G;4Ǡ
q @kwfwm_M;LNTL+7fݚ,=רo>* A=Э[g=E8/^M J68FŨ>Wϋ
'^7M9g ]OFSD},#:|ܾ#zH증ۭq_T.2ӱ5%yy =}?+ l.弤>FXe kc㲑kF烀pJm>ze:>#4{f=QFSQWY9s" -?&Mc++Me!mmҲ3c>ʰbr:K'$B0k /=m_'N\mTp}ŌtN:f
dgl2#B~LUY39"eCip;,v
I ːL]~VHU纰g2M'nﳯdbݲxz 0P_\TL4Ah߹zv@;:Z'AV}2_ 3d/.|'Ly=C9( J̓6ڸ`)aex{8usnH]OÜy[{}&Y{N2][Dذ MrtΎk;g|~>K ْ,Ywqߺv-]vn۞>!ϭS#B@! ˋ㝩-?w&+3}kZ]{2ST'N;n۱~τo$noɶ
r_;WMˣ4 vHO:ZUDeK]Ȍroow w2XգMs5LPYsMwԧ*k{Ė֥eӞwǧN<xdUT^RWWG9<85ءvq*R_+h= r[Wdard> j7<^̽Q^jѮxoi
U/ڔ] CҸ=Wj]i-i+ t3ѶܿDeo].9 2\qѦn5%8;+SOMw4?UZXn;,Qdf^xRרKOp1vɮ n)%qV܋zCU -0yhOYƆ4 -b ԼVQGP}$*5v#l(WONO*UKf|?5W[5Aכr,z8~#Zy_c}G|}N(Tkyg u05zW͙0U/~xԗihOPZ?κA-zU^li"˴ ~`6FܕFwUG~ +^Ѯ \R7j}׳۬xGy2=*NQu
%>@R(W/?4.+ cƹ6Cqj4L ](9! B@M ;ybO?Z 3MZQT?T?<WPd tVmIClR yY4^f1xǐUΉ:oMSM&E=do*l{
!q ;+%V61qїo⽐irkGzlش-/
kW{%4<ԉ04o1T
$FcL9}X G:wAcoasA ޏuƜw!%5Fqqɧ!8m{ǧ`Xr
} 6;=C=.&O> jca 3:<
~#u6mފt歸uH ;r8~|,m)6oIA Mށgk$NW 5QRT~D̟i6o>2h|V~ )
캍kg|
X N1hg uk8w^^CYVqH[]'
_ ǃ4=fl߾?G'ۆC>G3!-1c2toH< # -ƴ]1j 8NqEoeLsɊ*:
7i%B5ܝ1 pSpTvZpI0caem\6R; l a6 u
J@i$ >xf,DAE'5 f!<r N}&u!qI ¯y+k%m1E+oF#
o/L߂i+{Ba{0pYC i7aYe8w[J; W CEbD= 4|W˝vqhNK(h$ڴcE<߱m=<#ҥ #]/<"Sl䎽p ȣ$YU͚ь-!"y;}> o}WD-/U/=yŪ+ )?aSO5ܞCia1dҽhcf8+aq ds!LH! B@ 6 {rp"IѮ[JSC#D)K7Oo^L˼dc
Qu47{{5Ya[Gkh=h`p٨|
上6*~!d,Y xIX:XFj֥G[љx\\e84͗x3odFOĆc#Nez*]4Mqz&M+/ocZ ϝ)_XU~V73 vU>lAF/,VZ4BO ff;r o~ OA穿\>]*Vߜ;)Ey~\T+vGIN|{x=Z,~)ch**o.Om%Wi穗SX껖X҅fvzV s|rzg^;_YQwqћ:bZ{;:S[MKoiMu /AP-?K7o3 hI%}uc!45ޕ +MUӏ\Q[{Tp3 v̈p8 /yk|>#hW`F{[ܗZj0'q۳ſnUnsn5Ի|9Mֈͪh
[לXWϪ'22Kk?3
e2
\2`
_Z ьe;=B@! : {0/ /c1
,(vm \/lLӏցl hiiTskwn-@:hޣ\%i2ysE H~Iw8rGFN=ݱ,cSx5du
}Ʌr9 B.MCauJr fHclG NONݸheW]>X5w=X'W 6t=ډfE2{w{yˋ^=P,6,Y?4jqGe {_8 YyXˏ▣&=CNڼ0G93^C"ླmAW;̕w^߲~=k.p|0p,Ɩ)
8y18{\HP3_)>!as熑, l,wg-fN<\m'B@! FS.#^fHgzy.K.:_V/5a|m33G3Rh][/0~1- 3Rgt;"c-~QwLomXW#cp7~Fۑf K4q<eLNter&.Wi',3! rrf*RKsmc4SY<9?\M9:썾Yht̫Q ]oېMܳao6_Dx=Zq#9{י©#[F>kK;L}G ,-#<F 8Y ee4S4* `v@m׳ ܓS g"x.&Ӏ~g3W9B@! @o,.WB`
[| ;| x[~T÷B@! _b/);Pc/+&!\\/dݲ#& 2r*B@! @?Dc{G 3O"r-B@! ?^7ZuCH! B@CKݵ B@! B@#GtKᅀB@! Bp! RB@! B@ @?_
/B@! 1=B@! B& ]Rx! B@! 8\~Ԅ!B@! G4~])<wy:N;qש4ǜ;? 3G06zxx^;:ύ = m=ü{;x眎gY2q kgΝX3̛?-ISƩϾd<e=M=zkv|&-}#-הӟ=L|#cƟ~NYoFLۄ =:sv39:w)c3ymd̑)xʱ)kΝs-<:3aMqLM9e8˱oLZ#ρzӁ$ Oٙr:;:ϝ2M5a M3gyvry3|4y3̜7ƾx& 9
! h! B@! BO%tu=u-h.B&`=턀Bp!W}ؾ};M;\= ף:|"' MWp
7-%Q{fS΄JG߾}]~6)B`? aVGY;v숚òd#1 - DII 6lΝ;#&&q Q0@m{dcϧa />XZ+, # w"== [nE;8V!p0Н)Qy6mr7&=B@ JlF%~R)KMDFF\fMKB@ jObǽ{8TفSڹ.y=,,LNƿ|Eĵ1NrK}@ &۰jTv:q]yhvذgqBH$r
B@!; @4QgOK1g1}0=i HM\liv "+
̃eڻJ=ɺ:~(ע ~mdlBA67ΰm_ ?E8*Y
+@#&/yqG,d=R?wڼ Պsb t}TKCc_GGvi:X73X$?b邬ׂhhqZnfdm
2 d䳁neW B@! +ex^{ΑtFּƨv1o+Yޤ/54 AZ;)0
79NM5E;"i}t('xEUy?jÒ\gǚ ol1a&msHCvs#g:,ۿiQ{ eAhNd>+DMPMF|C=akqB@! C/5͋bQN-[C!)&^MЇF%oǶuXj CHxv. K/%YX 5'R;05Ћ/} 0ٻ+`Qk쯦!'.;kk^pM^|c? {_[+C0qX7g\CBܳs=h1acv%F`٨{Z-]mk=Q`VaVFޔbzCv Q] 1m%9^?Wtڔ~ 7q#)#f=3O2|PAh|/ɗ%k@f92Fk-eڤ*G! B@!~c_^fb)cWjlK햕spcsz6 ݇/{uv-/{k /.y++c]nRPRm(l0 ,aJ;8y7i9wuvXv^f
~u!ˠf36`5PTn=m='{]rƏ>Fv<l_xglk B|1s4|6{5m܌5NrjiT 2o}96 -i֣} 쪲>ƣ쬧u.B@! _:nT)[vm(2aQ[[1M'#8V3gw[qL(] A("ҿ/GNI
z ]/˅2۲((AbN|TrX~Zsg#9!iEY^
kVa-jAd)/ː+ q i(I;kz6EEaŦ0 d:ҐU.4# a~)HU3P^\n}!9 Swπ67"[ ?/@Vؾu=1t0b/!0:#-Kq oDh>*r$]ΧQ4$tNϪhj-9
~TyMqo͏<~£iˢ Nt:B@! 8@[W 2`H Q]^<2֫ơOZp^1_~7=|Zv]6G65WJY{n
3mDmEnp>~>vc4 i*
_=
f F
GbܵBjZ /&r]o`Yxihulm. k ℀8<Xc@ }cME-Ƴ?Y ჷ"R~X5 -c0|ԱfcsP¬x?o!(&W
64]ޟsQqh X4ӱd塷<6{QC 6yiΟTA3 E߅.[':Ҁ139Jx8! B@Gm-)"#˔HE`/ƺ] '~Iy ۟ptQv: _<1؎4Z_Djx[22 [^.x)>{i ~ɗ?g
c1r@;<l\~\9 zKg`P$L8k44 ?<gh7 :{ N!~eXvI]@\DPYA$PSU5W]p_^:#e{
Gc-¾cIYa'z`eb<7?XԖ`Ԙqhӱ3ҪcC)aȠ8j t.mNJD~4~;ԇØ!]1O畑LC/Mg1~۵u>Ȧ^ԝ;1Ȭ vth~(%qLFS+0"LtVG! /sYfW~ښjtzz'Z6 wߋy_sny+xFoYѥx "NfV)!Y=r2Vˮ *kp .((ت`r_C;Hyйbr+}k얤Z; 9i/CpשǓq~l| `jۭǎ_d~(?BoN ⎝ۡbZ!wܥ0{ART R?0vr4r::ϐ% ANa SRL7}~|&戇F*uxthު5B}(efx&?x_c>bݱ>8 H z K! Bw _Ko`=bƹ^^S{!Э[w .9saێ\D?h{}]Mm-kWEC:T]-ýΝw@G^}0|p տ/Ɯw
6:nrZk 7ӑLq-E m/lT*|( }ͣ\AaQtQgKD1C4]^
p9 Gn| KVmGI~&hZKDQ ξmqVgSRW\bV7ȭX >X@aCN ȠgW %E4BmuLҳuu VUdJI`轉"mVTvUZwuW]kWN銂4!!s澓 pr9s;għtA OPL '_Rɀk+J<kjr %ރyph` `FMʯ:~-ۿ[H>e("(@;C`/*۫ RKKh7)e%(+u"( rȒSb,?cb {QCp& )WU 4"6ѫ L@ 6d"kv:%%2|̏v_k:VuַlZgo{
))Hꐈ ?Ŝ\MYVX/
Wo \0"4 yW4VH#Ż 8v(DD% [*N7:t 4ZWP &
ܳ9? CjzWHGJqv&c: %94576s$kj; ;yq
3( %};G|To'g:yEG|SE@PE@9̻;W~bKҍp-ŸAP^pL= D7. VᩗiqظsfFyNƇ"齠N"^t>x z Vx̣!-}Nn댃F?LG4YhjȯZA㎋cʟ/S7o SoGt\(.zrxdKp? x-v1Br|
,
4H}+E } < 48XPRN)i Eqr= t#!}m n,u775eHH:s%3LFx/ .AD.TO8ndd"$;
n
u f?V-jfxi1C
vtN \1+҅6*Y5)OE@PE@P:lɚ"ґ̙3ѭ[7ׯDM"rePXZNPQWPgOH
¯Wראq&]{c`%?O9]z pfc5d)N41[BDbȕq
~,ץCAC0x`_Z/HƘCF` |: tXm^QKBϡ+eHhaҁ'l;;,m# tZx|2z0=6Z.i~2mX'x»"|+**e 22ۍ++EEk <M+3}-+U_n b.8e`7KGy/( tw2,i!λ &c@;@sXHG ? QQQfi
s)"(!WtJl(
Nwj, ȦD}R<q>)lZ7+q͛7#55U!><\%++ qqqq6<yB̍h}Th {r'F <dMnKy3<5gyJטwge6&fhS?ӹ~.ü _X`'J;,& 6t%YA9T\-Z7
Vᑩ 9D4E /em"(-^.MkٴF: b1uidwT%e 掳{NtrRæn?oH}Xa-lxEV&U(-<oa<!!lI/,$
CG@Fؔks7|&WaHf$hF Tn5sμ)ńAOhMTE@PE@h4KAS(n[vTpY WS
H+QhqbZ [LSߑ3E in+Zɾ].D}"l_w
-ir *:9 ሎq6kNٶBH l kg]"CN)^aZu W σ("4
abN7{s29 N.[oyhn^ylw/PӁv:<;R(_E!==ܕ",[V E@PZ;(<++
hw reeeFuU<}?:f_I岜&4ǩڔ
D+|6_ öȟvF~{d_pXJg*s:[ ^ ʠ-hoZ54 F?9*"G:o
W\\=V(@A`ݴ盝322 $%%e/66(|by
R4Lerss:Ϣ"9+!f> &rܳΛ5?+F?OmsĊ[~TX _m5n?ꜙN; B̃ Mذ; ^O211K,1VB,NhRZTYK47.~D/b>:E@PE)4{N0tZeSl +vNFߔ2͡ݛnA|cx{ؔ (~h5܉ߡ<Nhkt ߸q ?#̠ZT^E@P=@C<E [յmآ;
܁{ڶ,=+ofp\]F9
9d3x:E-" ky &;-EYP
ţp@4j 2l^v~}vzcanXY;_?;Bk422b(=tuaa_4<v6tvnx2 n,6@|F| g'XJ_hi f'rHy_w6mгώ}f̘sE\#{?/א4|2~z^o'V~?n:t^< 7H}6qϮzcХ>ҹ'a.osntEΓp}<2 1au"(@SAA珙|LKKruǙ6PZ}<Go7%,| JoΓ2h4vN3DKsmZ;b v^Ce|7M}vyqIo &a ʳsCoo %,\jj*x(Yygyi| E] +3ݻwGzzz-iҸ; D#5F+K6W"C}4v < /qIwo,)|@e8-P-E@P t;5
8Z*"8iı}!Vt pE@PE@PvD*FvNk}>FkaIy?u"вK7xYAϝ? ZʝOXn9Cf8qݺuψtz/[UE@PE`w#*t_7oJSGieI
4 S AANM. (@su ϦCC67ה]^wq8Na"i4Vv+W7NƔ
9"Ύӧ&NhN+"("!кtlS6Kp" ,GEy<q8ɽqsq &7V) Os,:NntP%|TSULD'!)>Qkbc E`I)5/
~wnK*uJ;.7g
7TVT^҄F|wŷ$,и
<N0L蜜 wѼ'Y]X5y_и"("( ֥[heǹU g˯GNQKFjؼzR RE5w8 ;;f;O182:Q[U㮼G߷v*%#㞿 {fQhbWo.Y
LFn k kC;xLIIA\\ϛ7C AΝMф'=("(֥"GkQሌĊ ハˮ
A^!&5Ŕزa JXoVZt YUIaÐ(ܤ`[+~]y!ÐޥcmqD/Ŧנ<(
=KC0 [y4=76Z^xq A$[\"쎊<\ @JRꙙ{%^ZTv;<sį1 £~k2n5 19/SwʰA#1ƍaQQQƊγ)"("#P @ IDAT@s@[c{XPpQY(#|g#"< !jtz&/Ap۽O>sΛo38`(}6Νg,^;͜s.Kd^K' ;8hM&W 3 | g$u6W/=\[??އKV~a1{:geS]CAUl7.uIgKbf}j; +ϫ_jxի,"("(eACVtcu!JHp0**QRTA
UȔl[JGU./Fgֿ=)Qx1풏0vXo\~qOD
ei8opPS۟> _#n}\uP.?^xv"Qe[z؊U z8ЧpWP]}}RZȍT(݅2i_xT lJgg)~$e"Sk{i֢qY uJ Z"("bɎw<7`=8J
< 4 &x*MqƩ1ѣ/&OB9m2 _eG/;?`^n+k P>*X>yb mnT8Tsl7y N#"2qш!Ka:{/1r˹5Iԫ"
>VW&В
Z"!t'&&*{۳W"("Tswo`ޑ|5դ}*iwjW!apHQtOt?` w@qi%nz;tu[VZvRCkk !O$iޕ{s]βV7dyVVE@ 䝔HWo6fkr
3h
tg
%v|DZdwdII 6md6Д }nF֊~[QE@h4KAߛM# /,'%p\ʱ_MSi(wDygr^P2'û}̚ w G9^̟=ERЦsQF3cI_f
WSEQX\fxT2O.
okBV<9NPEPv :֡ǥ3Oc Cŧ&q/!m蟞ދ;۶R߽kyC7]y#Pi/mv("("bkՐ%|OQcfKtoPZy!*+GvqAey6eN?~,c =| }Sw)pOS#78 ~,ao(|pɉ3ދhCp3Vd3]3(.xξnl]6 =GEar pXb1t :<NPv^3M1~[t v =HD
;
.ؼyQEgNt,i}W("(@+Vh L?::@M
ǔ>D~==u]A 7 o9CN^B^He7YO:jNY8y
8aܯ1gBc1k/=|?j"~!q]9QIkңxmNt 6g 91~!zJ3qkӏz! \hD ?Tkji7IIIFok7%עl"yrOm:
+"("/ 4Μ9ݺuC~ecotlyXBw|4lsYrl-stܑ
sN\W[uDΊ
c5<T[Re ~=q5DM'i=KvyQ\e 8w湰4M+amY4N;Oi9noNߎs 7{ξkswtOKKCNL9^δ|F1zQ|jo b,6 SPE`/ Њ-9Ο9V]BΧI9o#کTlSf)L%Z:96cioJ4z"3'1 sig=&Lr B(@vM+aNe%ΓB~4;9a7/;nccc1h tyo<2 psQZE@PE@P*譽T+'pj QH3EY<ʠS_{c :3u<\[{DE3v%$$㬬g=;V!2aw0.ksγÍ|< 4v^x}IMi(46?
+"("^hTA;Pvxw"2îiqo+n~r'ӝub .ęp ̧.wm\H#rQv?o}|644vئ6MCyv!~v]4v)4B Z bBߘedfCK[#ǿay6$M}E@PE!UC#~Cv%Oxi%n4oӘQwHg}lt78[8,q'd:]At=8;ᵿ]e[+Zt*"0e_
\E@PEAQ]:H
XE@:=2|_E 44j݊"|w[*"(@+BA?0-2;n۶͜ašXxgpj1- -ʖ.^kV/dn̼S/p?[x*svn%e(Nn[~-eeYvn< ?2Xq[ʟb>"?ƒݲ粫V2tY^r;2ygWt<i %,KHZss57j; w |+{
z"o}4L
j(Oj&P s6˗/G^^9iBx("4@
:d2.beY98d?|i83=;.k
+˟U˾-[7h`$r.0&gٖAy >R}us9%(n;˦Nho溝-g#Uw= O~;]'c@itE"f@=)"(MEs{ =z4ҵr<b>;E@PEŏ?1cƀg \YPE-#ШA d j
Wdgktx>Ois:S <#D;m5./x/9oOx)EBO -܇#[*"(@kEQ-*tnDN\, n;-QIUXY,qޣAbWqi/s
:oj;
}oV[(";h Q}/}K5*C@9Vyu Vy:E= p
"9E#f(
MvFi֦MdiLzZ";Gf_t VCJoެ&# #Lt~H^)aC)/Y*V'
("(@ ",~ w{QR;\v':`9hL$n*
0 t-*T=fɊ^C@7y.5/Պw
o;RE@Pv@3t fs'98$Ԝ̛mN۲XtHu!8A(<┩ei,vwb4|[((:s%OҘjh4>{=42&[8b Uݦ26 <M.bH<e`~ܼ$.+myܿkNWc }[n(ŶkE@PE`F9 *;?S/
Ӧ[n)qr c9k5Ex/Z}>zL#qQ;mxzl*q7,zw3o}jGrVg_x
YN[':>[./ <ٱ}|iY ¦!کR*i@Coo`PQ<k<VkE@PE@P*
`Տ"Av_pUW Գ0R^\TBWV094x aX
C:}i&Wyi1rPY]WZ}IVHYgeKu%^TW"7'E%|^sm8y~P] s | Re[i>"Z563C~!
H 5\>o5rO\#fp[V|¥VR *Zwɮ UK -DqY5"yU0!9NMg|'C@G@
ga ƛ @nQ1^}.7H.qE@PE@PE!w%f/<: 4߮ [09o=
KR>?<>dlX8 Ӆć ,vҐ'Wfʇqٟ/Ð)r\q鹈`ދo KqDڜRRqԩgcG!3ʣY]?v؍x8w]|
<X~2> [⭗G5У[7 ~- 7^q5#1 O=(Jx%FO:S>
qa57xF[3p) 뼯 \};/*0ױ!ߋuopW`ڕx<Xp$r: NF馥x'_ \~ٕ8I'~/ქ+!6AA@A@f< Ǯh+^}qvŝ|X?/._w(OK"o[70ӶZ*"("8
Zm3hￋ~z /VoFv8 4q Obҕ ,T_n1Ұ||>v +1{]Rn]Spc
\YF<}TvʂKy xϓ1cͼp pH
#A)[tX`ŒyX 'x0H)~7;dᘣ0l N> SN;
9x۱]pσΛN;_ͧB9&:Pe=l z{cPLy{7b1g ΗNI i3ƩǎEIsd t^,85(vE0gTfMF/@GDyH_ <<{:0ն.ShOWE@P#PgZmB0|5|l+
Cρw^= ^6d:(yQ\NӮcB U45<*258'pΩGu\z x/m G<O ^CExsشKߌ_UO9S0~X]\7Do?ϣ|3 ~R덗`t4<`z 1 F37#'!vWՏA0M;N$Kx| u ĝ~:H#ĖeM)1[E i14 8hq4 1npGspGcQ9(GM:e\^G.BTL xƅ1s¥x$9A¯@F@~pcPaojIiAn|;m1wqӵi"("#d;%Y[q'C
y
UKp` 0P{x+B3ST%ź֪?Q9/<Ɛ2Ok)#OW9 ~. X
3 K~E b^f9/]ڹS;Myj%\nZ6RLų9Kא|e@D PI}^O^VZZsQ %ߙi·̱#zjZC ISD=y9)A`=><!lĥuXҒR:QS
=> _2n\}VN<|\ywPc; ψψ棧!!܊W(gD-wBauz iZǏ\Ӆn{iþQPE@PM3< wt=s?|&ݏ lY I9hm#e 5l714E{9 ?<֯+FjL1]qbl&kQI*gAofxZ;)>-gX: %YǏʊw$nT|,#Lr
mFeس7
Cd[dD$SLt:د/(t\ad
pȈjH o\ለugs((,Op<m
8]zƙ\F"AQ%tC>6,c|MU#o 7ZTE@PEJ7T: LSkHd4""+6~Gax|q|Gn:^dB^cy%)K'< ƟĘAimaO*)<|Nz#κ t+8\>8Dzh@Gt3KT^Y2g:E,w#R\rg:ٙ~cvEAaeo\ %|ֳ RvA|Rg]8Ы{*{`9O⮫E~Z4 >Zc~(݂]Ya 2ry IOit(|0kl /
Y/ű߂5b"Ȳ ?];&v_g?vztDNd7G8tGy1N
gZrǞw-BAa)nr%DA1 iචM&*"("` ]qv yk :FeKwd:1B kmBhd, w9PGc,wD
vWl |PuOǰ xٗ0Xɋ' +FL' tLTrdsð<yNQc'a'fa9+1q$96Ka跟COBNj>֒oZYQ8ӐCjcYErH:?z '4~^ G {!)d ^zeǍcw;_`颹l 7 ;cƍMz<kfuJre#;֤`W!,o-~\x8#LSy
i?<wӂqe!qTWw3a/sb }8Pyv54[^( ZZZj~[:q4vѳgo yqڻi
?vV}^<WUUUQQ2I>hc +))AFFjY@m]*"(@#ࡏ_k9s&c#KkKشP䍬Rlڲ|lٺ
g1dbrPDGtW^u>O<sfcJtHuyuIi IdzlWgEi2 )9q1(4e/Attx֗ D ۲sI5uf C$L*JE !1 f@Msk촔t:4m/CEz4 ?4n J˫*̝S_\"G 9)ȗb۶mD[w^x
<upyp;NIM5
(7m%V|<sRcU9CU2Izk_S rXp!Ə oWΞ0#ा"(4c{8c2J k:2&z'(L]t r>Tܵ;:זTNMَ!/;餱OqRTc=]d2$.r
?xFu_:;He!;auҸ4uQ=]ϘH? ~AxS,%!>Xb8 ]c$tK{}mdEIa)
]ƕ^Z."q^<CZ_\s#3sqNnF腖R<;.a) w D(5>wM/q7 "WE@PE# Rv5xv-gsAK9wYd-;̬49Ζ/S ʲ .gҘvurY{ywSs9gk
es6xD&ۙ&+ 9n-t´{@L3TE], Ƃq |Y qptd"Yhs>I3Ehy#Fv&t NRN/즵v˻MY ;+T>n:;^{ HwWE@PE# ; X Xč* >wX5Pgr%g۲l;eOWy 4Ɍ۱ͬ8ʷ [IߖS,">bu^硭w_^Bh)WE@PE@h^g CiK8VZ(DSh) NG~LU).11uˍnyo)9 E`g wݝER)"o"Ш.}}jw/ [BNnT}x`nO}v[iԶ/d o[JzE@PZteeeG (**+x|
+Ǭ':v [?F|)Üy6_.<מϲs[*?Ƕ
@XekcNN{= NtRl6 v˵;-Q;nPMM)4;#S4[)43gT^.CԞněcORvOCk[c.iܷom^^9@xj"("РOݻ9Ǔa%7J^YYQcSMTPPD˰`C>^NSTukƊ$ V <Fge[r"̋y
Ur QhY62O _.m6n;7.YvV+V3&
cX5ğb% +?,ҥKk벌|)膡^V ?'7@^n!}۬^TAoowXۣ(@!9]tBj[d8hC+e4_mҹlCy6@ᦔ
-( AiihIII1܁ "("{+oٲ- rQE#Ш?0tJKnTrE@ @h"ȳ]|Z"(@{@Qa%ܮ)4RM+qɷ}_qIg_ܾM#a7;.t撚MS_Xhŷiߦ;|1Vؾ_8ήBm~vM'@4&>kHN7M ~6iRI1MK|;.4nߦp}.4qi8v<wܦ
zϴ҄YVe0pc"S)*f]6VgӄӚf@8M fHz4ɫ5W}ttw=k"7o 7; ht; 5NŗrNKą^|JweI]LW_}ChApikXPE@hTAiߦ/|qM)+qۗ<oHM i$nZm:wŷi%γ ۗh%/Pvrh$Mu<M's
7Ћ ۗ|˗t7w4]NB9?Pa)a>>ve#QN {I RDRa[s^(B%tM2vؖ՝n5fWx*[,h%M|[.w)42uǛ.k ivq;,4^ m}!H4("",}߅I[(@0V3Rl`]ܭ,7Cm'y+ofi;ެ"YQtVE@PE@J( [ ܈?52 z"د,sәvH7fuشi]2 RX¤s*6VE@PEu!!حK>f7#Vv3{e(Fvk~۞ j(i͒o0|`/<; T tO>++ 7oF =зo_#+Js1
Ӳ
<E@PE@P=Z<Z"ceg;^X18GUodnڀ
[߀d 8 1!NG95DϞ=ѱcG{Ν;
222=,,^hE@PE@hߢ+Zv/M ~_tDvxB"p)Sp딱x녦Ybni/GFSo|
^%]c^wΛ9wwvD("("*h3
:w24#f6N-$e x)9)m?\nM( =7}e@x{kG/?22M9t&^c 'рJ3-Q("(":e>>6g7Whhb
iv'>@"[Y)'tF@h"3[xk`Qt^yH0|Ϯr а 2Uwl;n(JnZy+ROPE@PE`/#K
c,cs ذ3 {7?w!|;́L.kN;rE@hsYm58_, :#މJTUWLk"1 9܁r2l^"("(C`tY^Vm3p֭$Դ;~ PZƤ E֦q [A cZ,]dm"-X~ K,DV~Q-q;\(GN6o[QXtF *6mظ(E %۩cZid~^#Nh~;ט)@uV~:D/", :g_y %4=ȯ/=^"*o9""Tx.* Ә˨SE@PE@h4}n%?+E: w> PTʋ>CGAnM5g p 7k Qma"Dze1e^J !DP6 |k`i2<h`uQ73 N%vA<Yjl(ƟG Q۩66˹ oރԠl\38ХOY,3B9 )\u:3d8\縼.QuYR= ? w. 7_=Y LF6!vUK%kWD5sÃXFq[|]ދRVfА˰ B"("(G`:=ٺ |[ [ =qnx,/ aiɈtcBLtQ:5TQQOp|r.rv锈
U頉 ͑$y WVΩ p6IK*ޖn3~W>脲2x=Hڝ(+rAAX wSΊA|tK|} B圔\TDyAiQT8YDVZ>R#Le%((*CTl 664!""ynl жSSJE`"`t`وqcղXLlBãᗳ1Q
wD#<ݫtw<cO|HM2
n@gRR|۴ .**24r SE@PE@h 좂N<R O9s 1Qĭ!7D
vRm+۪<bڋy_~W|edmW]ӎ8[n{]{@Ei z&~
RB ۵ckޛJq51#.~zy6֫tRʫF #pEgj<DcR|1>r2 3ڪ;y<p=(HE_ܩp3, H oU VәCA$u$猲lK%T= .laIa܈>O>"8R з ~{mT{BP
9^#Ҝxw8uuf➻øR("lރFjh t, :Z8-s:;6ݤ5d<ޙl۶ 0FGG #u|̚{mPE@PE@h54qcR%:*XG&uy^o~m%(݀.Y=[ S8 'o
M=(UTELB
.a:\~9x3s<<4~9b:%W߀cFرWa2<wu~ >WgǵsrK5WY4XU<x Ǜ ~2(<: ǒ|uk.GŊ~`)߈K.xŕf~yYbso=3/~ ^z5b
Epb<(^/pLspŵwa /ߏ&7܃߳h
~.2:C,Ï <|y#\5 f)Qe
Vy܌;.rOwKLLDjjQsrrj0+4윁E@PE@PZ lA熘]Rd MFCKQ\^p~ !f#$ھ(hzvl\& Mv{Cbiz6LF>mƮ\d$ >0= = C1U <45%[11OZژ·+ŵݓp_r[yފN ;td^v
i/49Y(aQ1u`N< 4x9x ԃOA?> _<
7 _{>t '{_qxwS`tO sW6->L QG n ڿ5xyD&8i4d<y-tPZ V;xU};ŜH[ڦ(tdd$(\{I\sJE@PE@P EA|؞`eEld()^
< nb,[ S=7\5F솏^.."HGxR/D͎w-O5`D'`I/G
b n:ȇ BIv@<x2:a^* >\Cu@U[h_+|5 7
pFQ Ib=Ub>̓
j/jK)8vx,
10sji9bKC[߆U
8,G;wٴ^56^PUDtlJ<MՔηFzQE@Uyϩ S),If^rVvA}QNr:!wt㼶cE@PE@P=nQ#rn 8{ \yH Br\ 7b?Ld'릿 N_Ŕ? lxeb a9U0! S +!aض uD}́alSdQl,K 3=>ʳc5=ns:UsM> ^ o._S䰙cbLI8b~p5藞Dt$ s(wbM[ah6cǝ`ZΛǕ#(lK!
pe!@&)nE-̞AQt~/mR >JرrN9χB
>O^ [텖E@PE@PZ Zr=C {3~6,^O{v0W}iqEEf/ز'<"ю ɺ deqqغ5[,_+<l%z `O+<>8 דX>4+xޟ1阳7d%z_t{^{VuQ|hGt]ذy+V, Nϖe7boiwytg]
KWn
+nBx wO͠s*qp^
_ s[6֯_Z^d6}}Jϩ_EU?aFnK'I*< E@)sXgJKGasd<ggn+Sh+%>+(9%Ngm(Y^\8cO p^|S.
+"("<u&&herJOpl ^yYTW"("{ 3 ;;FD'ʣcBiO?]#PD~ ѣo/wM[a>ಋѣ3[L4yl2^xn*#->y% LDS:hME=k/}W n& C=Z1 ?,TY0㬫o 7߄>c Ơ~`C .?`ڨ֓3Et3qy⑲Gq &";|6uv %==M_ r$-< x f A8$:O: 1Q;N]- \~6+gm `PBdt5'r
̀Y MGvu8ιjLx s)sBR~fAx>nS#<HW] n*h6m\/` %2/WE@PE@h
Щcw8*3g[nׯ umz͛c><'Nt7MutFxyI ̭(#YIᮦufmxu5mFhAa)\b\)l!Tw'۲&u1H3k VYYM͆oa,YT_"C*!Vt9㥳+z9[MV-[P
Bj. 2ca{5MUg5wYRB f;nc91;9V3^ ރC - >_~fGgLJҍ zQ݂M3#0㩛5! zN ?mc؛qiGWV OC0=I h/ތrw0EE<ԇ?>L"iJcu/ CQ:YwE>߃&рE}4\(@-|zoҘI3.\#*7U("g @ IDATԇ@`> ;lfC5+Q'.ϔTrN3 :wA+Hxm7fDg4rstvJNn1Dk9sfɏOHuB|{) 6rqi7)iӝlI'~56\tu66FhdF#mu"0Ͽ'o Wcahz'#ѣ){b9qfPUY.j14/#(O`Fד9p8)FfHsEޅ9,ƃV{0oݚt~ݩSE@PE@h 0.wH) ?7MÒξ(vi'j0rP6'4~!/#;O#"/skUQ[Ng]"]U'i~gf 8ǜr.~3 nF%@by\r%ӬҠPdlXe@NawtRAn}">ES1} 5ݬ! v4("("*;%+hK* iCyF)oMN
7GmZNM/? !|__ MW&#`br}Priuq<;fԀtd(=;z! |>c8b1~9svS|kUYŠ5ṫpԈ,R
wca A)"("2vقڣ4 w)@"%)|Sץ!v|tb~AS9%|?k<çAG|ϰ1D \Cw8"H
& hei"("(@"
z«E`B?k&8* {'s:pҍiPGkn:u4HiwwG̴u9:c`
&y mQD:81423V+' 5؟6K[VpE@PE@PZ <Ž5I%RE` 1V{"p q!ṑp#Yܰr1n8dLQKEeV6ʋ+jq._U^Fz;k8 XI}*B]* p\U1Ҋ0DF+ %zNPE@PE"
z+)*"Qnk>3yG|,;J g~ 㮽w^10^_5mְj?'< &ɓ(
75 hRڹO}8/Ń= eHh UE@PE@سg&q{ ~nAx9شn V]RRlӛb:ﯾ8:]pd<yD$Y d`)@Dn>̃_N JS<O
^B,OÂБ7c0[F"("({U({2$n#P{_ogZ(e8-VޣCڈ۶ #/ xz_Jyޔ{p[ ` OU} 4("(@kC
t([[TS S˽a(; ^ڑ ?Y kγ! Iobp*>+pk Շ xGuIzw 홿Mxk"4 y<%E@PUUCCy"btW#{fv
qnv܊@kG 5=CQGw$l3ϩxcmEЦqvʎ]"H)"1ZV)"(MAQ=33(..6 *WWW%yQ+s9_F
D(鰶$CdqϲI[C˲4G~Vn?P[O}w l!**
qqq&]kʏEiE"`taܨ|8nE` 䠼}LZ"(@[GAe˖O>@rr$%%!?? (++37 +HHH@nn)>Y94:+ >>?f62\QQhe?`^<Ag<h.nV_J6cŘ1vF?//(̥Ɔ d/X&&&bҥFuq۹E 8;D'W@*.:(*nC } _f'E+
E@P< R9- ̙3Tқj^*-.e%l"ŚL3|
U&47D+yB>(p瀕r hIII1r"(-w UKK zInĂb/X `C=+*"bikB@H?sΝds ,ܻmfv;7gw;F%HynsW^['y( 3\=n`UdCv[2~UǛh'7ڊUD\ <;^a?w)"x ىǹ*`
z"(U R
t1Nƨ?7bf98.B+';:e+<◅<4,WF``ɝFNgv\VY喇&zUϛ.,veړSW*YiK+-_,+Wui_N2獎.yKoYf;QvYqt1yNZg̲uYY-A4 3]hwLsƅ}cg.Mb\TeqT 7\S("@)@ 32q.]'=V|OtMwu"Wx/ Oyhr8 N^ =VPl49o13Kؙ`g}=KgF 4)yB ~.Y
kix?aqt˶ϝ\RI[E@P7@w1IA!@٣iw>ӱ<KJ9կ$u[KPy2߳ܮl/qXNh6wzYS<z`B^E4pQ2 *sв48OEִ'2kCdxPXxZy(JE@PNNN#qp42Cot,wA/
qHF?Β=Q YJk=2 ƀ G鈰ώu6ÜfƝo:yv!fвM'DS;yhθQV_ZNz oye3zЈ/;Ӝq]X蝾)[_KzE}SٙU3nef^YfNzߙoƅF|0;q}9L3i%l%OҜ)O<qY'Ot&
0 ;w&ķ<5 ˕ry `9ǩLծS:cr>!=h;-!tM uv18_ERq}
< E&3n&dr _?x `aX< q% g BB7 1^E@P;
},ư] ,&7E
`:2qu|۾_2bDz8sux `83H.r.|WY_ KDdX
vƅOh%w&/:eIKe7W:ߩ ξ37i݅雲%O%.W7pȲcqIg_V0{<=qЈ/if7%,Igפ4S3gٞ<>/g ]y-W b֜7KmF^~[ 7%a
~ٯHɷؘ5 56pso͏k9S'f&b OH>t8 GN~Oqy3-f xy?{wcVhzE#y?-:u <:3 =qHͰJ)W6=Ϳ Ěm-ٜNPE@js{ar|ǃ3f⥹oU둝WTlټҋ =W_Jc'݁qzrxKx*+nHm:8,bj0]
v<5 _{3 y znAf;tK> ehtii5ǟ), @99Rۥ| 21:E@P,X-"ZoF~Q# xj Fb?YArmNҊ)6|1<0.͏o,|ϖ?n>W jR]"H[dm}1 \NqvlōMA ﻗr |8 $gf[d
>Wrx
si+阆 pFb,'ٓ&fZxYѲm74߃;¢p[PE@(;ƚ3d=x۰p?OqC4( NL~r Ό DPcgbns#l|ذ hS+-#H)3ݘsnIŮÔ+!7LfwQ%t8F:+$~s2lK: JvS8??>;f),poh,NaKJ U_PE oǜdsŪ0MFV7E@`jjشm2r
QN ڶmj(m:l t
Mײ;6
"=&O>- M"22 Wg ?V`g\C6 ֯杻 N"Vu$ c5 ı;Q(u'}T] P]j EGe9$X"֬Y)=ztCxn*|2\<nRFM$ª5됚&ڣszF;fm1zP'vQ("J2Ћ?nztl\ /wF6֮Y^>"p=4j k6BιG r2U hץ76Ed HAHH8V;#[VriGЌnJZ4` ]˾{#pP]m40,N˱y EDG3Тa +WLGDc7BNzX LD`H8ZN AKduRrKHFѫg7;Yضe;rӐvӼ=aJzmډfTטj⮓UyRE@!--;7᳟57L/&WY3d#!v=x#"AyIu F ?}<6.z Rwg翏gB&\$:@(j\yE /D6K{zؼ{c.jݍaoxL} iy@ԏdݳK; <83?مicݒw(5fQ=}'蒋qlwx?Û/ ZЍ%yɳW ރ9Qֳ%^97^!I{g$; MC>Tr.Zxw<Ɯ3^%n<
_~9 \g)"(eA- uh|ك,Ѱ~@p8y lXooxqH* ؍G~3x ^>>?{
ǦX <2g.&"88: v`/M^؟t\{Fo,cs~ 7vF2ꭴnh V; 4|>M"v"pCMHC=c
zzJ^{t>Wdf L}| ұxt{Hq C+{]ϼcIx~yjR||lt~5+bؙ=~ /g{\K E@Pd,ޝhڧ 4*6yxNvqaAA
|)_`A\#L!L l8}5A
vѵq-7gVvCV,Y⬁=B& q DFv.|BpKi?a Zu+'!3/'#8e/1 >zAyQ;ϝ >]4 ~~9) @Ҟ
qD|던zL / }_P;o 9= q"x {E=ꋱ_>-S ǻAx},f?o3㦿CIߙ :t=qp$)J3 ."E@PT :5V 4ms cյ#Zi>M u1|㮝ZXŮٹ>ÁM10_{݀=I=Îu.>dG'b_`.L?wxs&;{3kBߎpثХ]+Idžu"sx )Czbӥ1q! q W_1 H?'ӟk.\ bA'e_2en `s1gga{oCTp:ń%q9PdEoO>-EVy}̚("OA KmX;ڮD=-u622o}
l 3:A=о^lo$
0o:QHbѬ1dds5.-eڡ\\!\|3
y/k:( L̙P
Ah@ dC-cᩯv"5 adSn
S~ M@«o+ǡҶoVSys$ GS-pRW];v!'KKh]V>K^jjjʵ@[riܮ}ې,|&
ЉwH~⍨U idX("J2ЩͣNFw? ;]y)_EPd_8E "byk #jT[>s ͗ sU4 CF\ ݮ7#$q=^Sue=탚oka8lGĈ[fᝧ@ʱxjW;cbPG$oN:m)tŭS}ndzUhk}:1y.-}qql}kьsvœSF!v7͈hL+Ы['2ι+k-cA/GfTRE@#~L7a!d۫\3clMs鐴_O`ocܘwѐf[t jn D' @20kjKyVv; 76h_Ա6e{61&ryͺ̖a! tl3$i{n"#wNht+m[]^?AWסV݆y.`
bЊ2ػuD{ 7V uMѤi]?Zm'v^ :v =i>%]v3{
PUW;ME@P#`Ze@0 Z ]{>L: :" Mn; ~c9KSͮI j܋| үvD" a/UkԪ <{oBw`]סY "|(X **< J 1Ѫ91y<+V;A,:}zhԊs?e˰e63 uոsRlؼ
iw)0Bh fѹ@#FvټO>/g4
~9P("Da_!Cx= -/ޝP= iӅhz "|uZt-0 _7-U/%: pNfR2疈, $[ v0 j¤]l;&P[G{|Xٛc h83@KkԨw6BB\m4Aפ&^'\z.8w6N!jF-?1йK3l23
GWQJ.[4^'& W A-ĮOod25O <ɅF7v K?ry4nϨ9K"("P&*@|j<_ 9'"B%vFԌFKe1R8>5?Gcٛù}1p
Am{p٭1utKL8LF4]1 V]8=_DYI|tx6AvP ч !v pl[ &ɴ_<KGz/F #)M?o9nd0٣0 `@<" |n!+#Q3r.=
mFcώ-ߟO[<<
ЅNCr6k}ZE/E@P&r{ƃ
7_n2r붥Sɹ ݇x k~Ͼ7`]D=0;s
J/p ФMkc8wk|j ěs_ŘO㦱C,<
-[|ùsfb۵ƽIHxf̤ ZogaOc!q?a)Վs- YcRh6 -"3;-Zw~C6_@L/y W=!<3 ci]|-/G+F"⿷t+k=8w0,LkFu=[Ⱦ/>: x<N۸1jD3nJ/E@PE=~39AEQ&JNҝLy7
@¾8,S {=zj .;0})}/?mیᛅοZhòpe3h$<1;!}:a ##=~C/ Fc+}wB(Cf$\?\٩5v~: Dvnŗ &NK `:6:&Z(/ u.ca9Թ8; )ѩa |ae >=V\:b o,/MCξO0ӕMnƀ MG 0 _-|-z⌎,-/"*;6^GqףEᡝ4 Q멩4AВ4 j
`0[Z("J4'']{=zpLGT_bcZj/~w[3 Fv>g#)9
cO݉m[sth 9̂@: ڟ? d230܋0VU+xʐcSE.-iq~T;ljѵЮcgF6Ǯ8i'gNA֍D\#k79IKn70
h?<8m;#C 3#VUZ7Gݚ^ B:8vZ
0nܥh۬p ڠMvuh6l4h FjZ)v`ı? ti^=== D&MhY@>IQ4(")4h/^
u֥6*;w`{n KI#
D4{)ޑXj
g]u=vefaAHƟkbxnSQ;mA^`] hvN]QFRm-WDž%tXu?+-r\Qfr HKϢBмu;tبgAWff4B.tݙ_.{#3{vBlYҡ6ӐD]ڛ7fuvt0/`cׁDog+kZlݼkEKuob]!4z պ>"&;;:m7&&СC Bc_"(@ff5(ZuWv0U_V|ֽ'? НԔ+KYA"8(w</%FZj)rЍp\#U.y#8->m92@<[j
d
U?weh"(@ Wi
g! Rڡf]NaieMWO>o_AAȧ b[ g5 uGҹI㌋,/t *ꋮ: ѽ<eѯ,4BʬzWuJt/yI~κQ:w_NJu l-ugyF[ ܞy)vdޕGtL_֛]ev;ٲ|_t36y9wҚrҗ}xEz`/L/\umi ^i\PE4*g`5v.
;7xY5h"ȵ4js- SyƠ:冑(j\ Si9z4>~\8&oS(iŝg\|wbnCގo_z~E
<iJ VYv m^{>Nc/tSZѽ<e-2ʢ_Yh*SʒUUs)yyw<oWr&` -riWXȗ4)܆YqÐCmqV]:ZzpHޛz姶 pv:Ŏ/J03,\K"SF<v_ĬY}FYh)"(AT]
yaFL,Vʧw톹ඡ&9Ұ\\tʹ^F/FUK䙍 :H N
αAOV"~JȉGiq)-i啥"(#ZW˲>jVVp'0_u
!țRzKc9=^N3"WQš'ٚ("CT]f͎;AҼzFpσ QsJ.+KNaE9386D(X KyHHHsQj8E@PNKgׂޔ$~oKFge-kJW /g gi\qҐ"(@jbdtKQ"<պ2ʪ ~~~t<jKEvu,,qo24OPEέ,9r
g!}&ZE@Poj\d9[#.ЙS ϲpg}qaMp8SE@89hyrp>եp[9E@P @gc?@:uH###c`?%%źϕOb^2 b]%Sidp
N
|-,<si/|;##|^NiNҲ w?2XW9u:<[ ƄqdX>߁+uLҁPzLW1LPiq\ O<f.JY _N Swj\#`Ͱztf]Y+l43l8&F$yygw4g 0噴/y.<")IoI _h8i,w:7e 3]ΔqLɗt g'2X7_qF$%%`x14RE@(:qΆ&tc)6-ǹAbQg[h8!)# gzcrl.)yXf?R;3b>euuz|Ƅ ǹ,ﮮ'ر Logs<Ky;
< :kH'mYЗTTu
&UnUI?֥*W*'ny<::G )L ,E@P'ރޢE 4iY;8klܫSE@P Ϟ/_ gye;ثSE@P<!p sCFřIW-x;,y=@gן-Np:ES2Z [8pʫxkϦkd?-OP/Ҩ/ouOoOodz|ނ{ow$%H.aٙD87<c&EMU,I3ir47fc9e-d 3Rٙq3l69̎3FhMz]%})S҄_=L:L컣9z5'>S>SOT^:c8W *IP Uiy_Z'w:w˶g]_"OA@VPUf}]/{5\#+X UY=cW D"("pKt ipa;pWt@uMjybP]Rfq 쎦C
me[!%J!3wRSer"99 ol/$40(J̙K9Tܖ4E@PE@8T@NvI\*F SxQ.aRoQ:}X0i0wW{ϚXRg2! F[*Sj *ntL)I+t%H-AGqOeq:Ӳ SWKODe vV2&a}< ;3
Bjz""kQzuaR\F1PTb*[gaÆ
-fE@PE"PDt*xcE
3Bub9 7 ~_u[Zp^Awl};c/ټy! M=m)98p 2sWmml9]8aJKMo ǝcq0>iPqh
Z[ʱuc|l] Ri46uc9ަ|Lg~w] )"PY,n-I%_%~'w3MnB ;P4I& ǝΩD,n[Mov rgC}<JkOKީSд`{km 9 Zj] `c[b SE@PE#P~
ٶ]5 )=J㎘t*_<| |bMC] 9 ,eןG
鏫Ȭḍxؙw Sq玉ȗ4[[aǁcvyܧpWpf3e& ³Nz.eK+y-: ^ΗowN_tc.cYnhXPD@C{͇o|HfnrCh7++zr<=5 Hwoay
fb m TN<|R,6~gr\&s6.'ˢAb>D/5-vy9ɵLWg̓,O[BXK sq$!iɱm8 ］ >n
ٶʧkw|)))hDmsѠA><sukPc\mCFE@PE Pn6 IقlmSX@ݝLz1 ND!Zf[
!~V-}||C!upҳ(:]Ŏ:
t
?5 Oԡڰ~#] :6`Sgn :|VҲ2ґiu_̢_2h@:\uOؽVyiIG% ߠEz uuڨcH ).''/
?0i u T^)%i~$4ʰ;9t
PyAdt:}V~)"pJw9
$ۼW >X%cKA+=?S& o}An&\s-{7nN,]WXّ,
<;4mgWފ 7nk
2' ofZ[}o[<7wր)7"q^/}&oèscGZ+~>Y.Z'f=I4K]w^z,/=K kN/̺M |z8 : tiQuF?tQP{jP/^Uz<vҦ y=**JWE@P*@9
thfݏ ڍ/-'eX _߱Lv ]=S&OsGxHU팤x Y]['MƽW߉jadCwКZDAA|/۸|1e |h&nJ"H߶b>2Y=<|l~SKF^!̡%KWmw\\zM1vK{{4Jۿ}:_q 5g6܈o. 哋?'{eF ?aV'˟띕W} (I{sgcI1}*&~/Vlewo>}&۸ 1wǓ3F\0 VHE@85nUH˾s=Xlg%b%+cнe?y4
=,m};&[75;
ԏ{od6\ݝhLxXYO< i4s.X%gzorBr^|Ojȓ%I{CѰ~f6f=zB|hfي߷톰ef$GAWZS-?squ_LCl<=!lI,jkR1';tjc%p~%y5(78lSE@P@Vq5;6̆:GlIa~^}߸oT\ط)@<ny<<<C~M!8IZpG#fcwW^7NÙ @s[/w`ָۦ= (^ xC$'Gh{A[
Cczd }aXyu
cFt# 3'BJ>xC1$[1cdFcײf#h!?'= & 5B/=^zw =2h&g +A]ODDN[ `5(I@bn_E- AYxHHjnoi+/Cm~wȮkرTԬۖ,,Zd麖zw1w__ʪպ#dd w{nA1X0 |MhIz-_ AT5Ƽ
82yX@:+. ?fXH<`=_ $~uob[0!INj==;#/39BN-7Ҡ=8 L
O܃t%`{!,E@PE@2 [ߗ~3i]T r@Ȳh^4qЬV8
={wԃ ?Ǡ R{?/1cP##] XW
Ғ\l_?l턻"|4ä1i@aIt ꏭ۶!*+ FCKÎ5A3 -vA{"nnޅ GmX~pۍXZ6Akz| ^F19 8
c?u| L22b $RW7
غ5jP 9ɇW [MO®eoݍ}E=6Ch;Ѭ.r1",[ <+_"<eܖ
kt6tzVԠ-Raǟɨݩu[͚Qe yNIïK}4kg}VdZ'y7 w#cE_k D8X" #,>װ
$Ӗ w.Uim;":݆WQz %IDATŠ0i8oGkZObd9yVo<Y#\
2k{wnqkz}1}@wX nϘfljZRcZX5}E@P@ tİ;r
l윊ƁHON /u:"=?'
A3 }>ΧwprSԱ+w]u M=0\y 7\DDGSg% YhӹmŎGP1/m"8::wkAO*FOa7h :#2܆.z^<H &-ЭV&-]pM((Ay䧟76F4o` ;3"iv5h||hFщE AAxexg!Zq.Ԃo1Y'Y+^[ lԪQ(
hϹ hA+_"
hvׇ$,G\1٫ İ!uF: $=(0 >Krhޡ n4 Vqd<,`jS]mE6SG
Wb1aϫ0 ԋ Ef~m~|6 PKKTم>w|6h8R s0YؽeW ,%^VgPX8lHbwQcѷݖpj]:aM0\iPvRPE@8@umWaWxvgagr <bLBU4P-ԏ l?efRBwx%$o:Aoԣ)*BÇ \pmŸk1)t\ ho_x\4*
/23#~ؽn65"2g^} = ~GDt=WON~ 1N{ޛF+
ąۯGBb*հtݽcy9?ua/ޚO
:(nGq
Vwe02#O
ϱ+Ni%9DQ'=˳"9YHIrWGP@ m|
("PymϞy
i _TD
$`ȸq,k_8 S]\N= jʾCFM־p YȘ`p<h^ϞiivނG_'ixRJ8^7DWGLp\&cנi4Yu&oڿftQsGͣ
%
a4
P7WĒ wS-Mm5e ߬5
|=8cߐVtzPOEBt34("(' rYq1MMkO\,6 hdVXMk Aز<G;l*`ؐ{Mg=XQ`x5U|9=̞8쇳w^wG?7˖vG`Pvhܴ%V܊:ǡa(ɼhgKWYF\-ZY!Z
LkԺn鳞S\m+0xwZkf %Qܹ!0 ="D6z}
`,ń bi| :4:k YC9r.]5^k Ż|MPfki_"$dJ] v<25WN
vv<c(}' A膘qt=&eaܗbIAr՛P+5a=^~4٬y J!}YE6@j4=^x鶍4y#\8%bpwܓI߫z\>
Cɨ/ږNZze[.,< UhX͓Pgbwb*~Fh?4N2z^>g^Ajg#|xxLM uwLu$ ܅O
cgV㋗@BZZBCC/ dր߁ NQ("(U j][)_x1T>)% -9cCV
h^.uhaA>\ i.=
MоMs8o{Z _z߭܁={j:1N{Yp'#A୷ա/c/W, ^/{pۭqn\7xeԙ
'N@f
vϛK ϢYOh}>ɳNҭK~
\>C|:y- }=nkemXA-7NBMD@z>5l?bz ec.<!~97=e/ÎaN?~ wMjO;t}Odҕu݆\~Z:V w^n)9&3
7r%H? @ݺub̓U1*7w 3i:Ea3
8~_Tҝt%-% fÚwmQy Y|mfHp|G8k$H̍\=~:P>^y|
hGP7JKƁCAq irGSPd Bz1\zdYwgXՋ\^(!AᑨN+rDh :4֠-PH"3!0]IȈE9>!>oePɥYI/ʉA|Ɲ|?<ӓ-*+6`|9Z
L<ۨSE@P<!Pf]:CtM!5гp<jio5w Ri^zvi/ ܬ IJFhHDl/Gw3ԥDnn.~֕jG}S;-{ēiulu8ݝaXFmursKxy/ :fglQ>q)) h=a@rlG\ $9(+4i"d`ڻXicyug>4R|Z~l߿ꐩn?-:
tI_8u5YT #./dyBb$ĭFfO1kp>QnuY);kDNqDtSl9Ź!K( H85EA-E|ggwۈT$wTVQ@(rʧ("P;~t ٹ3; ܉?b1FD@ !>[@ w#DF-3whuXA.mT>^vmq9vF+aA#aT@2LJ:wP/t gן;< N y/8pv%PԪOE0_]2jg!v<sXdS<+xn AOb_629~eϞn@$mkɲ˲Lg1\}p%4qbg%D ,W%8(|ŊP!FxP>+Ju L+S]Zi("(!P.; vg^. .v';#viK:U6^Q2.J.Zȸ:,\ݡ)pKg e:[el3S0py:ҭ4Ttb &9Jlnl8rB.;ѓt
JA ^Z;V;Xne =x z 2`Q_:82]Q~;zt;i$"iC\lŞb*;[ qyć=_;fiA*;kTPE@P*@ tiHdžNLɺfYU2 0zTYin{LǗ#ӗ2i,숚as: R<7 ttzD̤}B08eSN9>eaa~`}ߞO9HTCWE@PS@ tVScj{B f>OOȕ/aN)))kSꪉ 8ɠkw]t=OsPwZ%+"ODT]n
?rd}6"YJ?'neyrF@-W|Yxe5\ ZqKE@P x5йQٻwu K xJ?|ghFɤY>I-p HrL S>]*ZԿ"N,:u)|BfƒadLǎa:k>OdioZ,\*-ƒy{VN oI˿~ N%nY]߂%ieҰο {e=+{;\dᬛUe*ovݖ2۷[m<BQ("pbIYa]hڴu'70Vѣ͆;7DlZ scB>;XiFؙk,6r 9b`Y,e$Y\\:>?ˍyZZ
c$q HNN.8\)ٙX|Ƌi(d^S<+ߛ|֟Xo|֑/o2Uiƒ;e1[sx -0o3?c&qw,Nhϊ^S>?W|yV]<|V,_~[c J~ 'YU|џ`;a/o}[a+/,|V䳮,[ s+c| DNo wϸ{/ȳbwxrXߚeU<+.'%v^߂o)9_߭S3[%߭;ο[w'XoY[p&_ 5?\iӦM )"(( FU+OB4]P"VvI'^q& /3 V(_Axp%!!+WĠAj
q:E@PE^3vV=A銀"P xgJ3#Drb>O"("("p2(@Q`vfڜmeiwBoNg<<3yazvώyK]_htE)ה$ݔa_h̓Иq3:}å/4&_i<o:xEhY;or%lI:%M|3 fWZW|el)ChϺ_ LVZ6xyh+S 塭.&KM*)qy{}Wx*BGM <јB#y=Jɠ2LOбF҅L>TU~߉+"T J5MUa43,44;}7}'3^ Ze {M) +yNߤ*_8K4_&_hDI3itY&7Z> }Y%ד|gw"y)W:lq.L $S6yY:
.⻫9
oyxNmEt1y$\o_NY\3S+SZo<RЈoƤ%ϓ/tVO!ez}O4V w "(;ei"xCs>[gNf گiLBu⎭C0W-=N
-$ y>A`t> e Ӡ"("("PI%
S'ij8LˇiPf</' G 3'>t⼃(# 82__|4y)y4ˀ"r\
+"(" tde(9Ϛdh;^.fwu-F6Ӯ :V ;'y}Urv{
ҒT"ÂZKPE@PE@8IOAE@P13Qx_ObDL2v 8 G=7/ߚEB~^6
:xAY "1)9)1 l;:qFIڇA,c=h8-X("(""t*;r}Nv݂Q
ùc&}Dd%l oou>GvT4] zh5Ln4v ^x6D>-coѪ9݁_)K ع;
|zX^ Z@Hk';aK"("(' 5OZ"D@{n
S f{{ţ/FX~ތ|Ԥ#
|llL r!:nß9O~]?akEKP}HK=t
sOE[9ӿ+E@PE@P' c-AP {{%XإoߊE 7uuFMg @&sd{ &11طs/cĠ3Q'2 MKѸfu5kw#'/aa Eph"7YwܹGI"("('݃~EF c6n» ?B`4?wOٛ={<Z?}.YkcCO'dX³<;L>grsE{7v}nKPE@PE@8 _KWN_; ߚ 7by}j'q [~Ësp%gY4toqtC^ Ҳ,< rp>(yHIIENN6
F02'_mףVx:E?}ZsE@PE@PjWZ(h3rydLs<2st֯YgШ^
~
9zOh4a5ǥHKެ 4Smz"UD]q-p:
qEFt8j6LGuqօFeZ:zHt4("("p*=rU'ԞIZx1҉ȭ[vSLEKRSSHv+B ^j.ƙV&-wrY'9%qBZZri{TT'VMWE-m7Xj
P'("p#{OX,c7##*g6s5 ͺ{ԤGKs%qG%''# b u"("(F@hU"p" Fs`` C!$$l{2x͙S9ϞQ("(",J5Х}rE /RKޫuַzEK=XT=Qj(R
t/ŎgNTSPG 1` [uRc-O:&"PUwz^"(U:wTvazUPEN;ｿSR H{>"(U'(0SE@PE@( ܇)"(eE :._ *PSE@PEtDW
Gpp0oA 3# ZgE@P!p=&{bb" tUF[Ic aӜ0;!yf1.q-+
HY .͕U4YgJ/o'x$})0{қ؉,t;}gN7&eLN7y S3l91tRS 3NCifSS3OwҺ5̰K&4eE;zO
Y0Ӌ,Nos]Y%|3E97/<"Ǭ&Ox7iǾ'zqKg|32$wGcqt,zpąNʖ8"i N7ȓ4^L,ӝθzKgwzxJD &:6zYKݽakXPEEК+"(@"S)"OEƄ?E@PE@P* W1ܔKPYPE@PE@PE@8x=T(e*"("("(#jO]("("("PP=UHPE@PE@PEtD@
kE@PE@PE@P jWG
)"("("{tyY+4v3y$lHt%O|g E'3nacX;ܥKs L s&
盎 'aSXh&7yJZlw<8iq)rf9Bg;~_w9&;}S ŗ ߵ3n-Ϥ6uH|3.4s I=I4fI+a3,aw|My):y3iعK4%PWyiiT4^g'4M^3l8Þ<3'aE3.N~Igzvfܥ =Rf=# ӗ|/ Iolᑸ%}q,S9 MY|w|fyYOxLwa9t&ϤsvkaLw6L>gؤ38F#|$3;Z)fvzs:N3ea' | ^^\^d
My|)_|u%]N|wierD;Rf *("("("dtI\SE@PE@PE@P!uڵk",, 5MPE@PE@PE@P< KŞٳ'5kf-w8ۻۖa c_
rAi*<I\GEBw3x\z^J9 @ @@|~ę<{ͿA^'<$- @ /ov[y@_e @ _q/k7 +s|d5-qxfe쯵x-ޚ{z7go\ Yk}})xĔ9};í=([rWvokM Z:2.̜|Vx-Z_kshgW>G4f+_Ͻ5fSmŶk{ 1} 99Wޏ䟝7RD#sDSr/y
zJh @ @ډJ @ @ p@O - @ 8QD| @ @@
8 @ (M١5t IENDB` httpd-2.4.64/docs/manual/images/favicon.ico 0000664 0001751 0001751 00000002076 12657415644 020440 0 ustar covener covener ( ( 9s0Nj8T#zh?\5=lR14ȿA)B,M8gUE4* <G3Upx1c&g@t httpd-2.4.64/docs/manual/images/rewrite_backreferences.png 0000664 0001751 0001751 00000110453 11741262733 023517 0 ustar covener covener PNG
IHDR rC tEXtSoftware Adobe ImageReadyqe< "iTXtXML:com.adobe.xmp <?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?> <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="Adobe XMP Core 5.0-c061 64.140949, 2010/12/07-10:57:01 "> <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> <rdf:Description rdf:about="" xmlns:xmp="http://ns.adobe.com/xap/1.0/" xmlns:xmpMM="http://ns.adobe.com/xap/1.0/mm/" xmlns:stRef="http://ns.adobe.com/xap/1.0/sType/ResourceRef#" xmp:CreatorTool="Adobe Photoshop CS5.1 Windows" xmpMM:InstanceID="xmp.iid:5967343983A611E18AFDBD2E847BD27B" xmpMM:DocumentID="xmp.did:5967343A83A611E18AFDBD2E847BD27B"> <xmpMM:DerivedFrom stRef:instanceID="xmp.iid:5967343783A611E18AFDBD2E847BD27B" stRef:documentID="xmp.did:5967343883A611E18AFDBD2E847BD27B"/> </rdf:Description> </rdf:RDF> </x:xmpmeta> <?xpacket end="r"?>#%W IDATxbtwwg ,@l8 v7n \1 4Pi4#
|/si'7#
UysP !-v :/.* ]e='Q6fdY?PpBXX< __OIuNl3 @P]WPQ cS/G-
dO^
@ ( hDԣuϺ
$"t_-e` Q]vt
d[~ PEV [}iğ R[K
X9^ *R *w4ry%36݆z+#̭ > -v.mٰp[\ :6002C¤kѕw'o2aKWzhTdo'M ˑ j' 4%pHpGFǢ _}NVBi)C#cHO@vʔt4 ns?6͗
dƅ7" FFBĿw R!ׇ&9P/=-m SA9
d2 @He`: Ql| 9ƥNքTj!Rm=# qRLŁd5ˈo?>a
~yru5_<j8:B 4P
=\ehZ}c¯ˁm)ޜ``Pr?)ß f)OTjh:å)9P_ >ܲlQݲ{5QR<`֢QQPՙ=:2>W|ob1DdF?9,̮Yqn캂h;p+lPY{j"[Ծ8cI2.Tt\- ?q2~@p gdp
U[02|9
&~j$y$ן0PJ`_`'C"m~uŎPv쿻ہlmĀ3@2)20C" )e6Ě cR$Nϙȵ6?x-~b=xPp쭳]{S_NaƼE`cnV&Bԏ <A{/`ժ`ePd$c&$*3! (j_A ʘy " T2vMq 6mZzThc n}ϰ (R- [bdK~+eK^00z0NΰXr;g7
c);He9\!.9*:!? wPP
-f[S-Xſy3FLs F{P Јێ ;Fb`ħ[[=5SÕwW@rl\D OF̆0֧z֒$mPed M
`Wad``x[0G
P >S7h% u-8<= mHA
S]yx"߮?i./hL8 ȸGPRjY_@uՆV [`4R { 8~ėsX l Ztl]l+W@#,Bb,x8@?\WO؞E
͓,|C.5s
V?霧o@K~G3?ވ9 -woZ}xnPm712
ݤf%(2a
V2>gի9@' 0lי 2X yf(E/i>!V&5mZt% 2&*"wNK!ƺ{ 3jl:|lrh^yQ(%w PaӲyUA@WЖ4X<ߞֲũ,
$'4-r%n |$xnqE[Z/@cDoK\$P@q^ [38){~e,,Xŋ|oO T=4)jgװV
<1?{
5E#EDxYpQG#,,PEc6 ~LΝ0 g}DHY J2Nf5u(Q `2wX\#L h^= jQ iSQ<i!hXaduijo͛" |}vZ4V MZTţlZ R"V@ƍmP Ci6 I~pwAR~@ȥ=V+硔hR2s`@ťZwtJ=)g<VbE=LP'2g*Åi1E6 Pp՟ 2r}E
Wpbhn"覗@rٕ ϴs@M֩7~f3,lUE >& ̽|bP+^=]q$L1Q@+00|"$
2C@O> WaziCfS͊Mu -DacE '
y
VV:'"(O ݿq (:!ȱlU`sp
'O LI w1e{,QBZQ nmU0~*Mh-͖w\b[ym%;1S<:{νNņD3ι=~9߃6d
U$
_9u
t|8\/\}_o 3 iL=
= wb>#ķ%7Yr BkRā&iߤD>;\jveRI 8Srf)<1hȏu hWjT =Rሻu ;V| 2ĕG>+U7#IiUVQ2Wϔ''.M4\zr$7Z֫5Fg8JͽtӃǭZ{ 7P 1C\&j Ǯ{ǂ"nbX4בf'S%y}YAC6epvE7/%+< ɱX*ƾyލewiq` k@+nOeVM"L&>aRE(k jM= mYY~dÜ5>>pVG۶ia:At= >1ۼ?): : &QPn`bl˾r)$Mo< wuI# :-E
,`b7̬ "l:=wg+MTir:Mnx,2~zF[
b Ƞvoe쑞nWnΫz uRQZn J.OKY]a::A{}V@RSGt`4LnxpCA%єZFmS>5a<zp]P+x
:,7> C KD"% h:rZ>CmMIDBTĤRQ
ܝNCӔ{Q~E8\eBt TA$LX'7.(]@Zڿܨ?0 A. dYH$@`QeLI 3yUx($
9W`CX۹~5k:*7"q> w}"fcQXAKpV[ YS|܅ <Q]
v-|T9Gɨr60ׯM>hY@Ph`(S$(hmv22r7*GѼN,TN|R!½dQlȓ,|))V9{?[1 ˎ#\k.Z5wE. ;z 9/6<:\Rf<B~Ga;K;*7#~dH9& 1)f: +a}=Zӷ2#`2/8t 9-wL$|^?({=5 VW [O?CTb4vHfw ߜ^&6=D i w<\<p(> '_(>_) 9u:.QvUG˦e?].>
jxe<) '9pB])eQȇ1~K튘@3,,T,>Dkr-E `Z{I2f>/X:6R0 o[ǑHpv<߂ԭO:ي& 8n 4u!YE{ NNʃ1It#^ ޘu E)'RV^
d7-4{1 7G2l~$IB9n =9*baz%G)C.?dwIYq
P}tw:wfB"W_$E gYʣQ1 "n b {>j) s-}
銁?ۛ|>QYŻӄ arXQZص8 ŵ(/ '-`5^1 %6/\&*QT?,?2 GpXyw$W!uL4bfs 1*N3=G7vңI ¿oM] jf]F= &OniIrF>#1rn Ub
PԿrGj0@>c7lt1Pym׃!Q~B[Bp@3 R RpF{3Kf33Ĭ
σð(>/ߴo0A'fŢxeH]G
ԏΪqؔ $IBCBȣ p=| >rR!Px(<?sziw20M;#öG$ 2Z8z; 5aɞwt zt\@!m1,?J6#}
OdhJ͵z& *[oxs֪*La3>kΠSXT$`꙱3}zo}q0g ̕%̻K[ 2O3 `@.5vGj'
ޕR3%KJBEJ%*-O-"$HPRh^E"*,7sg̽rozu>pܳ99s7_DCrĀ~ ^ f .kU 5 k ~с&7b d
p{
Av8 !ߢufb%]ɰU#+hm9~K>P C@] ]sV7`+7D?{XP3h|8/^%n
Bc|{ 2w v.N6 K./Ae狛%nwFzEW9G:By/GA!U}@;ip8&v)֍ =E_Fi☹d[!MF#V>y~\6VY` jY 1ͮCЏyw'ӎ+GW*PFG|KdnY(V95] И{ypS`q{!&c ژ!n8'`1\
-U&KS\ RvI_Uʸ[(rʱoM"BPX3(×EK$V-O
$ H֮#lQLHf=}zyQ 9J9AFG{"U5QW$p+V?V'Bz3{f,<p}Sט( MתTw~svcao`M*#^ӭ3-ߧ
ܾIr㌡<GΜ_ NXz &cq**Wba Q417ݠ-xE { 读E˰ 2s.g_ _p :-8B d PyyV<º{֤ Xa{-gD0 Ή2rȒ5 Si_ ]'9hkzBek]}%;س˙X(<\6yJ 8F^pb7J m4=U"sQc6X:]wiaxsZڍ{<Ъ;aADKl5 B ^B@@@ Xe
QMTd}-sD~:u~ 6Vqƀ =ڹV"
b/]V\.aLsYPJJLV`T^Qs
5UI㮦͘4iԹnLDv#BHCbljї=vԘԙ,o$ۡ_p Kͥ;r?O
P6[߷OZ[͔\#lՠ#Lֵ˻O!W#D F 6v@.Q!˵gjlBcDD7\{= k+Lh(xzsp8.7_L0rVL$)_dZ 4*zX? >0Q,hÇJ{.L)* =S~h[HhQŒc
[GU OlNd5!4Ӈ솛wj Kϕ!ܽ7';<~u1qMIH
;K-ϻ
:|79!he930w guuq:nYCj6ն039|%oF~ ~3O qǩ \8mE=E.͢->Gь5VGv-qt^oaNYm=wZMZ^4aC6gYR8RAGj$rSMYz{./;Jv3K7 :Z C^2Lۂ˷źɒ7/be|lEV"V{˅
rw2\Lh U/X،#4Ԅ @S`qӍ7
rVw ֠A]klL-B^Uhi(t,%kx/~Cof)K 74^w #6bޠp/v'u.b"rjI`29=ܳ?vJ~l!<U wߘrRVch:ly52 &5/H:R<{V& 99)q.,jCuVw
d
}Ӯ㸫[}|1^N NxܗΠj{G/^|nNoi I; 5BWo^'XCG,k1h'k9Y:~B+]@z7h
f;c4Z$%Ú}-lѝ5i5rV?~}էm5c^gCvH%ʝ6ƦrY
~LOC>wsՙ|)+t,z[xŒv#Rc:?yD>ϼI*ٵ,->!((6,wy7okk֩yW_ Sdű2Q5 +) ,7cv;ݱi]qqy*q H㆘g ZAI"" 6î=!vwHLvP!1b#}dy{4?X$&^ Ȓѐzd:_}G%Ͼ?
a j2F;tvkE]t?Jח x\j4s[x>;\,T'E2KAkN"ߺ_Eq3uK4{JD@9%9 CXE? 8%y+q r. zZI P\ٳjw%t_|(0pri`:`6ZT )Hj~myGTTQTò7Bq.p G^cٲB\hŝ ,Zu^@˽oX;C(SՃg Vb"W<HUoE%YRl6R êDm~*."x=ϙZꪻ]F} n0فLJoWD(j+yFw7 ᑿrp;WhYJ \`3#!:o(Bъ9[.FxDt|DSrj #\" Hȸ쟰HoF1d/Ümzh#ʆ5d;6@6ě{+[ȥ$e nJ`nd
U^n T۸O
sR ymG]ʹ;_un`%^ "<.TuTtjVU1|nKKZJWOln-*U
?znQDkRL@!Zl iCk$B<0}-8k~5/GE.r_,C<6GBF\}BMD($WY5
@9O+0,POq<u-nUq.rP)i&"<8 hNvp:I d5]A] 0dUͭX>/<rڦ:Mh+n A'vXFUr` <cDl/I
Y|W;^ꚍ
joSN >Bo_8{( '1e1X&`<ߟY.BEfqk_f6Iy̒5T>1wVbi׳f:ZLXG宁QfajӚDj>ϧ3| a7
Vs.HIT} ͌ll䙫`z,k;MM^z0rÉ
Y R 6FAdo;+) /48JhLϥcOjV}>9:e.\F%Ow<! }G%XطZ Uf_,\[!`B8,4e>Eʰ|E|tj.aQQ"{s Lg4m
'qDÙZS|ee
xâg]Ns8i?
HklE -/g6uQtkyIlHx|uk+Skj! 4Y__C/;ŅSڶ
hʦ==*t ֦| ށ, 46|#W|,v.V'[E,oyQx&9UZ]§4dDK-~ 4,7K+ hA!Ar s;Q}&;3ES˗Lz
6(δuCӿZ? /=s`҄VPB"{9j&|OC+kk?(F
Q{dHh?>#Z x?qӆ : - a$/Ǒ.Ks! 5@];{Òʠ('
뀫iBQHi)#GFdd%eBEd{ɈHR!]xϸv[o^|?n<g9YDK6 B /! |zzqjI
Zc݊gt Iu<wbEE.PDPϬH
8M>+*"!')H
m]wCy, 0f˧,IqH
q?],qH_54~Y~%/p7i**pf RE Mxa-HV x!`r-|<aC~\[e:uXDcĿMTYϷa[=ǚbt4yA"2K*DqR%w,(f߬C̄ xl8Tb1λү"]̷uE[:
u J 6מH9 =Đs/It1|Jw\ qR8Z>I
}m\dl,ldiiw8e5w\
m2ps
. _:hes/Şw]x?!1DZןy|
k{mju
3 #^p &n.ƎX})}Ѿ nEj&%QӸ=*R6ZOºJ V[s8nk"llum9H ¸輓O1&iFC[yig oM0r{-L1~g3
8 d8F
E
M5Yr56`[6gJfx ʀczp!ʳOrLl)WȰƧpK3Zg|yQN8}Bk ݿVo *lFEhRhW*^?Cs.wjk|\/W
l 6d: Rb3P-"n1.KⱤŃEr`MZ
u;5|RJЗ M\.nrԞk ,w n]&
q]=O|? 7R%3i@Nvz {H[) 9齬dZ)U)r6 8վ $ g|86 ݬ9 R2@ɤaᣴlKZvp-5tB) ڜsQNg]n /<ߧ>ySBB̯uڴ&aʒ//vvcH ˑJ 녳ny}y*0/z*Ny ;;ZŚAt>G S$esNЈ, c[}^ 2rȁ&/4JU^o 8)CBh."@#F J d"
}wTS5_*6Sd?}c(04-ueA 0);W9Ŧ6[i L,~'qʸG lRS?Ph_ _|q4n<
{kmk5Vv{yn7K; 9Rq} yhlTٻ ;՟?3Q_{ Dܖ (EѴ[*0oٓFԜsSBxϤ %Xm¨yO;7{ &<¸DFs DJI KUYIx !b Yg {JK^e
Do,1 ;P$q2q
Efd*7SZ*<6GkC%oL}?
qam5u6;$6T(@Į3a=3q_,|y!% lw Ku|?~ }8P'CfY d715QKXE;E\vӳϝ&~0맆=LF3@"dY*VnF;CJKq*li ˓PbB<ƨr)! `jf&_w@Q!z:=2cL\X[4i{QU68}uJ,ʚ.-B*k#
SѫˇhkѨԒXtENkgAX%>ʭ˩{ή\6*
,ɭ6;)#ls7dp ;? FI8dnɟY$1VDeN َ5n G :?؛NղRsk9`1Y-
G 赥
GcJ*j&} U%_JHg_N#]?r
;Wزɏ`
FiqY@DDBMq%qο a%dy=YB 7JC@@@ Yd
5@PRD%|DZ( EIIq7UJeg+{J{L~TZ}-Fg}5-NZe
Fg w!в|BSډlgSCÉG }?euj >vsNS OcIe,6{uГ{
'Oedl2i*J_cYS>&|ֹ' {UA8 죣k*ӋMLF؍ö9N6dvkE\E8S;}#s~2ہr"]Ei?}~.3*TwOQl>n3pt#Uhc xs8aT*`v
,V=h4eS䁝*hK<0z{6529ztjc#y~t%'r2јLш24*wJkV^˳A6J7,Ok^ueq\*v Ԕh~M%(j ~^ZQH8 _N;y ̾e}O徢 ,#E kzVT|1)[#Rkd0| A*,Q#f0Hfd46rlf#C^V1-2b1l^nE)e 0|jjd0ޖ5iZ8oM4 SvD%$ n<k@0쯯q0r_R ;
K#SWVrXX };3 CIe/jtIq}^ffq!$txw3/0)COpdlLA+'o%o}\tcg6iDh
s$eoq'0q`Ǟ,Iv;+ӱq =zt}q rNZo#dCsGԴ)MQUWDv= cȽs4m' 1)6ڋ?LoMrlr:ybۅ R ##_}͆Gof|gM_2.L?S/C͛2º9ibb^'ߎu3wqyj;`,J W>\uݸaևZ?z?j{4cNbޥW^0agw)HwLJo@!C-]u5 Fװ6kz~t»h1Zj& ґj\x`ɍ GW[.%[7^4o
MwB^))wRwBϯ:co %3mܥJ\x.
c |7>wrUkڶZ.#>o#T!_Zl?h_"b7͊r)c"%U<eMD
bWeBRA s8`\S/ôjZtajFX[4yu
DGث~u(svnk}!TWY[P̟&(]
=S[o. gWq%)/VVyzY<8kd*wGGl[E0,Q/PݲZ&ۼ. G s=c]{1sfJ|{ߙ Ͳ$- Wֲ5$q:HalV Loֆnca
,E0{d[CN^giyxT[ L{NdH fPDV64 ͂DoUalPJq@dBBB"8-)(RTJUvze:#Yؠ+m>_`7]R
Wv_u6>3tQG9m:+?w9DJg_<#(&ͭ YڿuNw` `@ Gio&QqQ"R*A:\CP6*V]t3 $@#[SF k$ܵy:Zh/5VA\}~N+xFXF e# >]XEժd=2ߍ8A1M@$sNSAp ψ]\Bz
ykZQB~Usc-pё%o@>l|bigMca'сd֖XWW=*qd⫥Z2&7n"HwzRKN:Ū4})E3~e#jٶ'* vexJ㬅6dܢ4,@m2,)NLvsN |],BM+:C>2W`F@0Z5Ǫzv% #ZK (K 7\4ib5UE(3eUguȢL
猫6KIJ܂ >lYVJ֎?E_<|c}. 1~E#.Ta"d7lTHBiauU 3SG*Zl 0վWB#gVaR<u/I&1^.jr
H<יilBX<^Iɲ82$TcbHoV.=,*t<MIFZ%l?o~RLv-?:_j+扊7"QVaJk D[?5ǷqX
G <yiEĄa#C] 3JU<&?h>P\|sS, ݯxE惡Y
dFN/!/TE%5@@@VTX.#+5~zw>4 Ę)gZu
*M8pxH *Ժ*_? q5'<. ".%FaV<l0sk N~V#)~! "]{ N)l<Vz4]~,u<Rk4C ݵz(>4k)/;Ҡ' AnXX9XNÛB*6em=hQX{#^ [RCx&vcg$EDCƧED6]HnS] 4Qw[) yc ,H
(tk+C<mn"p/yHA| ys}[T *hsoN[7pܾaLJ, &`Z{'Է]veuV۬}roy+t+~$8v> Säa Sm͈W%9 oۣ.f' /=5j0~6Az'^3a#'* NxC g}4uKzκ3gĘO=AKiIIIޑQ-O_({ +-T56Ե;d܈fAh)~@zFKJKKI:O 'QIyFAOP )bɾ ְ 5dǜ "KΦ<O8*ZOXx7rꋧͪö ;?55sGs_?|sw w\S+ nMKL,qf:F=:DLf\gӃ}pжf%' HT;%pʤaX?d
1.[:W)AKHOK @3ڨӇYc]r[$Q2Mj D8d*Dž[D{(FKYS!xET7=T΅[?x3o$ 9}OX6u(+yL z G^M@ =* Hq%" d_*)B Zx%u1wJz 9iDDBNN1E/̶[i.Y#ֵ_"x(5u5bD ɠ6no/M"BڅՏꀗ6m&˱H~i#Ty>!^Vq{&JQSߘS^~+q)U7ZFf\93olo%$O%ep W7#}"'g #Y'ѓ$҆fq707;+
T S[©U|E !tiB%B5 k )E9Q/qN&etob 9n*X|!jEBtl[/>~ Ͼ r ǖt ct,pV~Yx`QC쟔8iϔq YG)9MyyǕ7plQb.?SMKM;E{kߢU#C,.edcv1ow⣦ |ZI^lNW74UHĀ sm&](k `ot!m_k;1#7Q*4IX̤N@Aj_Ks:uÞKm=|iyUϪas<tv[bñfc֖_5F "v~PMY4aik(¬a|i2
8*VEM\^
K}C{ڃ ز[y-rR蚃w]?
dr,ds&
k l 9$ѕbJb. x=ԃqwi*
c+[ʔ0=E60Vc"*my^U
8hF8ܺ7ƪ_7WmP9du\[tKWQ5fG-BZp,۠Q;[qAcݐ EB@X)XtS>}*L ަ._?yy " U=dqWUALPiOB1U' \I|5cdU nѪoO3 I@ |.xurG
^n_XMU hlZ|n
c1{ESl|e<>e4- c@mۏ+ -L8v}/X E-FT,K ɦZiGL\ʴ88S(Jtle} 1橽yzpbzϿƗT%t?WbF{_QƦ{>^'+5
D*m~쨅lߠMIPR%.P|v]Q".Dc%+ >e.(sz'j!0!_U\ 4 l?9c J_MK<vK Y-/HI. @])Nc]JnBMRh
aWqQD)sEť㖞0,a\n@gi \)kd7#[;;}cx0;{u\X ֜{W +Vp
{ckxcNZl$1%0]pz7f 7v?=6!+8RawvL0r{)rS ZT 'Dʨlj 6w&t&F"V[7]~QGb {:8L*<֥w $c7OciJ\\#\;ѮE%fzmkp[k
sGy5
(ˊ@jR=jgN t=|"mDOu&T`WZ[b
A /Fz/tm l 1z/w6Þ*)r6ut Q ˩]+yI?K~#%ZRL殑- $q9n3# cV Jt|`'TVG nx$;Jk[孰0WXy,xpy߀ꂔمπ2z8:БL|QX?P@^t{ %K\H8"&bP\$`Z2)!01/ Esדz([ڬ?KZD3^>.zE
}rę0y¬1m| q#MZ
I]a4CG2J^;*YS2ϯNl@ #_] FbBgr Sc
w?uK 1a
I9v>p Ks5Ut0GQa|^EQYlP{P2z")`M2ENѸb|XES ZG,P}.;p셋~^/HZC^v@/
K+]gc{NaXOFP8;bA?3/)߈
}4557ݖNT\ Ťfv"$ -(@ol8 &{ly kfO
ڼ%@/d
=>[U[L1_${%{c2 +kZu禺Ғ߆\*?t,xn? ,cPjYd
5@@@@ Xi'b@"tn>f-). )qqʾc ు> ! 5 .XH_eo߲t~ ) ~BYD
_ Ljs!$/7YB>~w
C:j`3#¿ϑy
FX@"@$Q 9'@{Wcn{^J!2KlHJ!(JY
#RICiih[<n}>s3~g9=?6.. W@ @ J >K
S"k?t ?`,MfY i Bi8 &7`Y<
ZsbeC͑@ xB_W $l6bp@ P (
pM-B ~,z<b @8 ' xl-Q nhINROC>б5n3 J 肩ͦ7^K |} X O J: \ ATHr@ (
-XYzJM,J'2t- սyM2B3 .'%OTK8}~)KTC䛆t +GWu6q?2WZIF'°E@ 䤥`t! uA3 k' ]((*QG8mbse#&QAϡ*{3=-?1i;-ѡ'%?=̋#G!_ wfۈmQ=y"Ha y8o.YgHyq9圍 R ZY W^ ZlMe35=nulVRQ77Ȫ
>;3O0s
"! 4a[=&69ѷe\ e*."a"]Þ#^CC]7vDL) .c{
8$ l˿%ڗȈHf 7!Ե%
&auח\3"w4tnhIuG]`q-SC},W>oSpQ /8L04Hhe }oXl«v 5-(y;29G*䥥D( /1 Ȇ7lajS~x.Z3SSs
;fJCٛ 1;7ugT|X* X6eDwu >Wf=0.(,}w9]R禥gffeh=0,2ZJ1 C)G߾.;7V"S*P9}y9{?MWZSTɆ ,߷w-MMVXDߐ/ET| &j0Ohku fcޓ5l6-KÇ1ugDa9+
aXlեLnYSLŇq| {e.Uͩ6IQ[\WV!MHIת )u d0,#s/Uybt:B"?9
ofJ%'GM\^>+R*
&Tme-x[oҔIe}6d z",05@&q`R l4h V%:0r`,lFbȥ|ԅb?_#Uܶ?=Gݸ)+/;u
*z.ulN~O;yN :-L8cmr%VnW?2w,b
,CE͓NQP7 ` WmDauOgø1JB{q0<pGvg6|9Yր<SMtXI}*ˡLj Mo20^8Gu<.&D$Hd2D"m#>ͻƊ1eŅ &2';lˣ/s숑_D\IM\rg k/
nI
fFAne i
°)*ӃjbN ߔnHYw?@2D(Չ[ 0?E(V۔ǒ2g ߞ-, i FFrzWijP^kN 8smD,.!-l_BQ<9^6J(Iˡ<9Wն 8l&X^O q%2SJj
tN,
L)^j7'W5cL CX
+ɋ Grv}#ٿ_̎ɇCNy,K xGɧb: Q0 ((I+J_Q+&#WQ/^ /3֖F|p"\kz ^=r(D#TiqHXFR '̖ǡ;+voPyp>Ί80 4)5w'nB(~F_>{zamɔEG"N2ힽxP-՛2h?]KtQRY#5k6wni5ԜhGT`S :TqWF0ޑRP!PVb1Hkݚئ{ `1Ta(5rùpfd4WPｰNXxfk<- ub! [qu6^zՍ&qCWG^/ݾЬdʐONkVʁJٴa{֖:z)ܘ^Nއ$0ȴNDdTUbȀOZUYCVWJ!~my SJM y{:F)!mX9E2Da4bsmyY9d,6NZMN `WR֝_xo(g4W NMzk$8kɍIt+*V5ؐ|upMCKů 3 No-$ Ƨc ä6${`g^2#BCgubiLV7g=N``Bmʸ{aj2Z Gzh3~40 `TBzm$Sm4ߌg5Օe%
j%2q503=we;.= ;d m Pb
! aYb=| N)*T^WCBuMQnt}└Z ]NV DàNo:tG
" K~^:/p}7W:7OC2|2N]{b64Z *As\-g}#7[݅ϛl2l T=^S!9̚9F(/Ĥd)6C4G$
t;s
UAzfǎ0F[^s̀ L\vIAmLfH,pg ?E35JGiޜqfN4 )ܹ̄L
sr 9_y˫1^mtLUloNmqA{>X S0;1ۥ{x ]D݄֠dr5.[`6 ߃-'ܑuZlwdFH D4
pݏ*tR Я o&|ҽs:kk+hz7LaL
Hꛘ)
u[ӑ vhZrJz&&G.lzңQ_AI9jbX,nnأ[:: Z6
',@ N ?=jE<?4VSDG7XQ :J+ Dt=iܯƠ: ty#Xl..1y L* e
g^v "zD]lk|/wihh.!\;* 0t: Y;9
$a8%HjFQׂЫB}Ԥ` TTAzzr*2f$x#g9d4!Hsѕhyw&,!${Ո D8~
U@24jW7N89cSSMTMTsBz J}!N"2uw.&lON/<zɹG/tlT`sЉKg6>wi|"==
|#G0cNQV A yx撪,{@xu}WDֵ"@)
rvK.85ӱ6eJy|qO2! eف{+ _u:pĢI>p kDY}O9=뢩ؿ>v.!NW-)X<֫-6a6aub @e0V<sl?M ŗ4=ۼиyv'M^?
@ <V P P P)6" J |D9 @i ߊ{NK,0h,bWև+ӖaXH)"0Fی,F
*< ZQEEFO }Gf:['X_>-&R o2kg
vr if녖?I̛K.̜VK@*]bbFF
2VU _cū/O
/;LɌ\I),5g fR67\GZ)faZMJǯ ;l5LE6Eo0 *-6{\ʣT<a嗑{\tWSC,,bf6@Klή$Ok-]cSSS! c LWJF/<#\^Ukf¨9H`:g
`)-t!@]xŠ~"|H+>C_}ssӁF2X͊tny7OPR `f6MIUsz&ӷR]M{N7S<-k#1XzT2C9{\a>=CA>gd'g=O.m;^y(,F2R9h"WjeWd&c ׃ oK
Vi%ȜeLxX$ѐN{KOfJp34!6kuy{ `e)[e&"=OΥWTUEWG)r䆻q"b8Qxtd^E1i˝@Vi+ .a38֑ޜ _.s[bg͊O!vX;ؕu%κ\y%=:^7OV{'7HUAfAoBPΪ '8տ #%\eY2 \rW$?jnAZp.3< Lf>^^T* 7aň +y !dj*n'zÊ'AI9 oz]u}%iFe}_wFAQ73c^;Oas #+{{ŋM<'_7k]-=qZ7g.iɰ.ˣ {;2Zz6+Xqߴ5*KEwoo8@Ont[\\:|u`i/\䦈U&}Y 9 KP |iC=l_Zўק. JMM?hZ-76=v7@CCٚj,fd3ϕy過 [=u%̾W/cĺ3V: <. &CUcZ3m׆kc~ y/8.|F&5Zyٖ{% 9`3(UegnmAb N6&ٳ̟e+
M lqˌi'LGFѫOc q¢ҐS"YӚ X{]⛽)Z|*ecr^|/w({NJ`YtHW]a<IXQ㥌W 04~N
3S]=dc5my]m>V=BTS|( |[>k2[ $4}g"#mj}KEVEeu{$oB*MW_Q0-YAF m^j"8mVn02;Dx5 y[H^\ !
KIҲJ}~ͳCtlot:;b۳"eW-T Fn%8/lwR{yd*T&B4\[7 ?|o؝Or:3&nؾZ:cI|ɂkoԛ[&9DUҾݷym~0mK6\V,%v5tr} D3WZNF3}C C:|llBޔ}!q)FKw}.^9kg̊@.aO ohz )l*;)t;f０ۙ~Yܶq g_ m:11UO=뒠՛u{~C=XJs-PE۞`3.ghB p}E)>UW:̤!dKISCГ5m7JBm's<R./pGe3d:o!7>yAyA]ӧAD*$) Ĥ2 ǹ5}L'jUy&l& ֳT !sYU3 A=|qa. .:o6 "V(^_'ax c1 'w { "b #j$t ]`,٩)oA)n
zFmI,A3l;JOSH2r=J0#ڪneMlXEEe# cb/B:xD_sO$)8 ѫR
Wi~;sHfQpR ETDn<EF]IbTsN^cwS4]G%P4m'APk#2@jcbXP gxO9(tW;vPX)y M_-m]aF-9ϵ YL>aQ
=ѺH#f1ن[} ._eq,6jó,[
zS `Onauao2iP{'d?Z^Pɩ-t;e!D@_TW]\_Z:-#vy W9t6Ý$^N\fDkX ! [`ѳl89%^GB
ePhsߥM J_/pZ+*8)r*
*0nJں gAfc'@ǡ Z<Y=앳5$ґu6J0 v#-22m8C@&̏L_EY%,hLxUkNem>N1+ lq6t0ſH]9BF2[ w tkxw9(g[81@=^`O.
uAfϟ)2aA͗R(&&lUUYvS_3R=sEGy^=\|-Y
盛 hB>m<Y+Nmlf
3?=p٢Ѻٛp*}8jiDŔ8#*3lV_oB&>P'1LOI"ᕗC;V؎;-d9odط}imrebʕs9j4!C{n @'d}Y(ט*<=xoᝲ I_ {h_\9ϐ5Z1\ Ԕi
8/;Q𰍛u!@i=Kf>^┣'^ȍ]`1cY8 &VҘ S##Z(!X|6)g!t+R), NێuV\=~pfP $t[6m/*ngg0*+$Dm3 l o2 ]M _Ut
e?O@:
JW7-4 ](j dS.a_ u+"bsV6j52|A4Uu5zS)9 kD_tSrKDb`}?9s}Yip<=~4WS`0#hp]O8㈸cPߙ8]}{e4J ;~YV@[_Cs>߿2?ViH4+ʦ%_ו~m\' R8a绨0M$iuuhLdư>i u~I7Ӗ}=&/n%UŊ)(K
@I(+ʉȧHU+3X8BԖ ~GgSVh9d©}~jLf7uy]6ԗҐ5 ĠA $ 8Ğ;cȖЍ:gmY4g6qFHtKO ttiOUG)&&'RWFo(X0{mך.5jKnIӔl"jR}Zs<(̢+gݸx65G3Y Tw%#sF }O m':Jzg6 JVQ<`Ee8◔Ɣfrܶd96~{oQSϝ3)-ňkH>gci8vO ]|q}|-'ogR|u'a#m3fyjs)9l;w 'n7! K'A~RheXYey9 ~%ԥyR&g%2w۰*v0, ~'/7^qs~撪,{@4 OwZY= >D\HLLoPUYc]UdDQ+vS` "Shk880N/3
hY K-WzjeB"~3.WWAEfCТ?%vvvXPm >emz͛ZJ-,}d(tX_S _^%)z_F @c0"n!*7 < (
1eM۹ `=+_$@c1U6NX' j?BK3q- [y.chЕ)nmGp4 R^ *)۵>\@ ',"wKDчO7^54 OsF)=;p~ßsp< ?9 $,:6P l gp< FgX~UI5]VC}c_eEcj15')ͱ1iRL,5g_w$Ą^Mc.A-LL:['AY&?K>xOU@g+
{[/[ml{qg}ziYqrȇ9[l
77WDN.i
ٱk6zE_v;r=k%: >:nIhjPY, Kz z%o.
PrNKq Ίy ~f:d<J:ql= W|KݽdWXÊ{\ِ4{CR&$!/9/!oOw;Cx倢;.O=gKwn۷>On}-4@w<S4J kr hp6@"Vuܰyjw
+X/lY8Z6O$ <z½m<|u "'r+OaߑMYz Eus[gaũǾr ? ٹ^JI YOOG|6Uaϔsn{l3 |wBgy-v낞qF[ ܮ<1Ϝz_}gc%MrZ!H {W-[h|h˭yk';sg#͚<Zj
ګ7y^vlQ7K&VUx7~DZ3m!&z
A(mba Yd A3B5%ZUk8c)hк_%/RxJbJZbnL|U[wuayTA 2- hOy_./+p{c֔
:>6Jcu/fON
EmXxieC|#}MdfSߺz;3 `o~ ss^n1p>j7DUփ/^fg%, }&ܯŞ:aπ%]lcF\+b !y,$x/a_ُ3cg( q8lonc}zzB~wg] $/Fz({;z~QgD;[Y)A2ӎ}ψijcߧv]sl͚kzK=ϣg_<tu妘G lDu=Mf癖u
y]C' ]QUu]~\'Ĩbj 47.&U:5gZbb58rcbA Sl=z}J!PҵE.? ٮ Uh^iWD}fpao i%յGkoN /t8MI[ٌe|+[kvm_pVJkBg}SN)' ]~@iT\n?W 7aʉ./vAVb+*nxXN:ZݴV!HYRZGe)5]h~ߕ5.ˡPfq |7f=Fi-Bȼ/-Ĭ|r/]cv>5uy;Y L<jlDb pA/M^)#hwɢɖ{G4 R}uuxgGM
QsSԆϬ#^)uuO7n16pg}_7|sȴgn- ,2`wns;bY f`*g:͘PJ!1ATTia^sW 6S OIUz22A$F*GY
Q9鮆ӭ~no8:II`f=n:;|mt|.ڰ )UߑsB^t6}zu^H绹Vd<MݎJM=Znp:%=PWJ8W|U K40`̴z1uWjfu:%#7İN1wSm}ĵ]{}`A=vڕ y).ne*|Q^q_A:RC ](x7R"<Kt2U{ 2ܐP/o $o8RcHȹ!!h)<Aw?Вx[5C'3~yu
#ܽ,;gl= 3:.Wi0Md$5qFv;ZVsQH@4FQws[%jhb\+$g:`1 H/gk݉A G_Uh:y_XN{Ɏ\$:>j3ߏ; NpŴݿ_.i`|?Yhg9614$L *}v~k]H[ jM;S(-$mݫ' ˛'&Jt^7dPX8kW>ͩCV!^0)f7
[j
!%2g^ZZQ?CnKmw%qZ BïiX5'1a% kŲk;d]
-AŇb1 3 и,'9c
!,ⱃp
u x{ iv)_{0m~ۂO?fLꗪ̸^$YUHߩ~c|sdXCm۶[\~J"{F$xVAp?\WT_RboN(k+jX>/O<Lxqz$+
1Ҏ?x}QJDBɸ+^7 ZV^mihsѷz <pջN!#vڳ%.ﾃR : l655n~}:6̓w_ ej|aOU6w{[ 2' Aˏf㛚pgݖhݐ5?ЊΚ~ qw,u0rۍ ],;! Y6-ܪiyzWN{RvB~
8] ACxoζ D {ƻAӶe8i94e4|ޅW:k-a',Xٰ_EXӝb6n߶-qHW<\3!:4
6 iw ma'7:C2~M_ڊ]逞{ũeݷ_j ީm)7tҚh$d] # L ͳLІ!U<B~=PR}GKq:l rٯxʛu*覥6t"A(+hO8!|B4z|pRgK;zf?EϮ]Zf $gH7 Eryz۶$eT$& ^ *(xbVNs ]2'4l+ <{ ?ȩjj;4!hQ-D ?mv] U?h Y퍘 };}'-Bߦ'߿ Quk {fPVl˵gWmc}
\КIW.~R\O"x
wLۓ^U u*m0Kkz[+Mv[6E9evFpƇ Nu͉ zB@qz { (\\_xq˟CP'3\vMP#fM۾-ϗ7F3 k:YjH"{ %57ˌbye[{IicJX?BߑHdUt+YHJyoͻk)3lƅ}H|]²˻5{ 7Flh2վlL{*wGGOa Zn- aO :' *6φz^s"
lRZ𐊊<
;(l
R[Z.&/ϻ僰6Okw}9FgXt R ߝ72_=̧>uNT{=0:zR Ԍ8bf<UmĖVHd%QmIEO ׳K<nGB:
>N mKqxp쀰M2W1t-;' .*0⣊rD!9aUhQ`Ś >Ž7>qE%p"Wwo~|YK;GC v=Չ;v庳sE̝)Rmax/y.vłHbѪ##bR8ͩ"aә\f wzR=Imϓ
J /G:c8J.y AS7]ky$5k*
A/VXSD<
y!8
'ps<ɩ!K'
#x< ˼t!B!~-z[>ӝ몃zb0pȍa-E_@E^_LIP
XEMiFAа3k{+̶ {`e=h9tcF__;LQͺ{8KQ )u%a/Teۯ $(|y(ħ5y}MN+Tb;ZpYM$^EzTԛg~6inxT5N dB#o*a5 NBĨEkΝ3@ˍ]ӛ<ω
DE)̲ >=-XAi[ m_7j
Za}YT(uIoqeћ[({MSă<I=V5naA{{>jޤْuvH4ߥ7wK~fAL'IOfq7
B1C=+9sG4ȓig{fWBϯ]}
6j y]̶h
زor2z'±b=#Z&Ģ85F:#iQ=~ʣjB*CNDCt^ר:BH@гlMM|~ͫfA1)7L2^b
Y_| e;WؚP_(6eVVGf:*Kd@Q |X ;OkzL)"&X|kIﾧ@!?w2=V\ ʮRL"I)/d| s9-`9냧Z(QhB?i߾r ?4y[,{ksZ#2KsG]9yoM> ۚ2r+.) icJ#9 akdA[$TgAXB~Q2_|Ɲ
xuʉnmK;N752xM& ^weÖgJjٰ>[}$ R"iGܴQ*B+n8rkW py(+2[sni$QSW *v+ H yYft/, x4"3!sn~ӆ0S6fL}wۄ3!4mK
^S(͔95ݭ E.4lQĊK뗍רv oVZu $x/?2tki"nk~@)nD
2E%
r!6(~ KMoe!6]8ˑw:`3Ɉ"F} V}itn1ĖV/ѹJᛛMeC3KΤZZHmDA @w߅Rx< ƣL#έH $XGI<wE*?h HIL$ ^lxDf0--x(Dϩw'Д#y_߿&[/S3[s>]>YjB ӑ L%3Y}4J%R$D2Dgv[~E~ nw-p$B_}#5|wK)ǔMP D:֫{}S1IHz*sm!~rEL!"MJl!1{4E FE FF>Ә*&}Nii%P9=鼭hCm-Dn0)DrgRLZH_ wN@C8 Cfh,@@Fh&'=Wp2BPYRh=kD"a#~w 'v:Ǎ8Y1:F"цL=jj}!2һ(bR)=:Fauz<;B(Ғ<R&:kFkx:g ?Q Eo#Q *J%wNrj
aRZ[Zhd"\Dj~ o{ܴ{!Ԁo
dщd2|vdА<$Jǿ6"Bpd>m%qd!+!ۮZi j*[?%ҷ\>ty%մ*^,|, )U˧-V3]Seנ1`Y5g
6\}lf**ka L
~6Bx j/Ʉ&d'WUՓA/)DX3|g5&b]nIK3J`Id!̷4X sZ-?'^Jν{*
0?.%UY W'j m#<5\3kv9.9%DMy1;;;p#$߁@jЈkX E/e :z +YM9y\f''mJ "-31k^d^mzcErkmD>4 m>jC}*M_2'!W~p1t"a *Mlm\ A[;Ｌ$zjwlzLahgɳ"$9qfԬǛTBUNJ ~!Bȿn U(# +7 O J 4 J 4 c 9)WYQ7x
?zrskuf#L D$ 4ʱ TP)0hHK(i ~`g ̟A̎{#<-߀P O J 4 H ? )uuAN !(! &ΠRdtt( p.ѷ _8 '۲CVH IENDB` httpd-2.4.64/docs/manual/images/syntax_rewritecond.png 0000664 0001751 0001751 00000127514 11577356155 022766 0 ustar covener covener PNG
IHDR ) =h iCCPICC Profile xXy8U]_$%Hd"y sP<DJLȐ$eL$*B=]빾u]{ߺ=k{ q /lvPpƖ4Ѓ@D 419 U- u$( H@ [XB *&y8@ Lrܷm*v]T Lrھ j. uq|!N Y|7) mYZ xVd ?Z xLdf
QHoC"pn ell*X+ V R9xS.oC%xG϶=Wa°q,U'P6"NYKI]r쀞L|oj+ڪ:qݟz N 350 6fFo.fafaUe=bCg+{Ǝr,C#)ӹŕG> g4Jsu{(\A !˜PЎ<{R+Z!F<;!n/<>۔p%1=),) U!mw:wK&M¹i9 .eveB|犚KJKZd^
,?ZA
W5W=pZMD-k
m7ܪi,۔tDK]M(e>i+i~ءPQgWn'BO?m5/p d9/^Zx5:\4"0M[qS>H:q$O SϢGX̢gsv}u[_߉ i ?~d//Xy}y}qcLUd'RD`hFp Y
ظ}9wS |T(*b#"&"g^voԮed3>((*5+/J UO6F@е:~(^?BRr
kfG-[a99`v1+{{Ss )ݥе{#B@_g? |d
84<:U=͑Q'mUcbcN==_v&lx{q|2OFxjkZAzb_9,l=vn΅ /_zV [*\XtزDtWSѫ++YT)TsW^[s.Aa[}n75Miko ksO>_+u)><n>aD/c\_@ʠ3Ck^T~}uș7G*q-+;A}vbIO<F> |^x&szko 3YQ3{/5M `!!oPP\
S" #f5v1ao;cSxU7 <"R);BIG\U䧽CI6= x`NQ<BQY@QKRm:fDy] zxCw# i&Lϛ0 (OڸJ. cwu6ӎI.<.îܷyx "xyX2vE=~,GI$ 28>D:d4lLlD_(1%nqq/O%:xfloB]bVRhul*sꫴt̆s^YY/wϙPu+|)/$_60I%ґ+Wʱ++SyUTU/]VS[^
uM[jo蚾jՒw7}V6v2 r; )tI?ѽdG_oiicΙOKTr 5'` ș H@ vG LLvA ( 3CN P@xރo` a@ D1B @,R4 OI
ŏRC9bQ>O 0b41*
M kMvhqdHjӖ.ә]w0ʨXD`:L ˼ɲ laC@vDX<
>SD.Uܞܫ<7F8B`.] "ζosZRRXrqoϾ
ete +p+r*q) H* Rаtӎ&_i9l9nrѮӞޱi$ru{W<d?Jk>80E1|$)*)3 _|V*5"cj\s>9js]n,n.}p|YUڡٛ M͗ n!D'oeaa7Jc nMzM|v}y2Ӛ
FChc @A7s@XAD!"ֈ'!HҏLА{U=E+A kM8;\ 6mqhhhFU P ^ Cw!\f6t,V.{[ːm|G;= Ϗ rpdYeɵ]so!!
U
Aw]"!ƻİb [JDIUǷoCjl}geds+n(<PQ{EcMI[\HM?آU@ :Cf棖RV6zد9z:$ѸX^u[lf #S2!¼#ҢOў*W<4>q69<v1C !K+7"oh^ae2+=*ꉚ77v6EZF巒;v>\x)}p#Jıw4vSF} YX[X_[ůaF76W >3 xm A!u ŃEQP%Wh>:݃ac*0?hi|*a38\-|l[s{OH?1ٔyi;n ";أ ;x>q_qOP -inS#{$B%cf*չ Q"W ߣԔTzx=4w]!zS LXsfJ+#(+N~\qx{} 7
GDž"a'"N܋+= y4A4q%~jRSfyp2Zʥɵ7nv5495 kikPs;KROn={7ʣc~X|?5YKLl\Jn99G͢bǒRO?WLVJW&~ rUkrUdm5cۚZZ:[3B]T%j t>dam'du;<)Dxy 8@K#Tİ6CȺf!r҇0Agi1jQu8!vt{XXO$YB, u.xP[\\u~1: X<Y@9 W m%V}?[Zm2ZR76d@gK AzA,uMjZj6 [3 \iA[|?L#b05" `. (<Qc33"oϪ ! E_`w`!yԚ BW t
9 adOw@&*A8G+AR5b4 pHYs IDATx] <?!ƭF B4B颫h[evv]]jSW+鶊tE"D !rk`swf ƥ2:<9yy F #`0 >`0={N_`0=`zX-`0X{ # N9}[`N F #9`s#` F #s:%n F #: F uzK F #u:0@A ӗ% F t|`0 =/qK0 `0={N_`0=`zX-`0X{ # N9}[`N F #9`s#` F #s:%n F #: F uzK F # %''Q|z5W}zYzL15W܃y7y7_[ol<Z*'IrC ;4͜I"egd5!4aH:uvwilk5Z
@yAzpx;ieDN?3KPn]8%XDDG w &Z5kU;f>ŜLuJ3ZF䇌yr9%iv.y5ۜc[WcF2T@ ;[en\d&и {FymVo " 3].2o[r^[<,օ
"%TF6TM@LN&1WGĭ6dA\\p q|{oС Q?.!Kq#|<{xɦRi3߹!lGnA s
I27Ң+%3^}2;TCۛPU zsK2GP1>P>CaNͲ:R ι5¡ c Fq }iQ(@UGl"Q|H
.U'&jNpI 8eD:Zڂ.532BL6[0 8(T;#L$ٻYѓ7X :$};K$^*g+D-iM7h-1166&mrQUh x\~DhY@ -*Dez7S'ds2E D
pmsRokZlR0Pׂ^{"^C*t~};/O#w6, 8:]Һ4*9YR u(& 0g~23'-̴n 0r2uNZD̴̜PKK###J3OC*HDZt,q2 n>AiE 4('a3i JD|aEqdt&933!1iV !C$5ńlDsJp_-(:4(ΛT&ԛQ:s iA&D&pC%hiZӌ'Y| #rN~ b
CYBv ic FjvFHȊB Aҹd. Ֆ/& ,M8B>V#S 1DJ"' t7Mɖ=Q" (NBʫ@'ᄢP xO1 PPPy06 f݊kjIʩt:JS3_h ]|&g8עyq ^;^dRaoSH1 D *RJTM^ףtM;"sZEr>Vfz 5%E/8PD˛Í1 <
s_Pv.5^ۙP+us.w9TEzPD{QlXiG]"[J TpՒէZ:BUP
)-緉W^\D[%ۏq%&R ~}Qba-%~yHJ9P)*k)9b X_i*zZ"r z XK\'z<,%_)jzn1g7K{_tkR`x&m,;U_ Aynm=cI~W5^K/2cCBrN~l`TݶlT.4+Bo)f|O_T08/FmPz+|f-
>fXx*ra3Q16 LأQۮBBPDf}ƍ脢HO *`?wJww2N$%QlB͡uӻd htu"鶀ECr<]3 ] rӗ0CXӔoㅆvӌ)Ɉ Q6jtU ,KDZ`8"C} ?`lwxT2ki#6t^²B<7;N \6ŝ=DD>@UNnj0
G$%S .^1酤jphJz" )KQ ګw |m1[2'rqh`J uZ:;&14ҾN#\rVvcQҔ AVԹD#(|fp~蔴uWmi\shFZK*oDu<SH38u~th9M]CXShL6Ա^\8!mTh~];m)` ʐ%a-e'aMf:rdE81%Z&ȉ T xd -l˪iw<m$# ӻYt$4Ffp_/; CR7>yRx
_G u\-\u@UBF
U{v;"CzPCCSyTJHjiH9IQbR=`$Btm *S<4F6(!Vc%EɠPWUTTp Ig}Co&gI:y QͪĿE tI-\u3LYX,4xҢ8:]ºXteM0kl3Q, }vوwm⑸ )Fx/S8@!xHià{~2&z$0mI1ꏊp_k'EKG.]dĤ=<00=JЉ&Qhx0g̮Bp̰A;;J:zЗ^
w;{a8b3UxWv(=J(iM *`쟓 F%3tMj+B"ޫ&5/([JQX6K=%{ЋPџ)%摍3uth[ [ 5__Y:3y\m `4azC@}IsD_>#Q]{`l<y41x,yHt*8y9t6 U_z}*TrQ@&rr Cpu Ԭ7nBP}9 :vGddLI8 +0/~
O* ^%-pN > $
udTx;$W/gH;s~IݎKDP fCiD+HDnbN >u,#
u艅下GDo'2 %K:Ns70,sӄ7삢f Xg w_PE4*#E
7-d-\8fU"-#n?,f d_\NU)dXM14{+qʽ m W_ӝ'6C H,x{RK>46?e]Tj_ӄV?e99L''OK{*![_LH$GR7U,Q^+>J~N6lerUn'^dEƖ [3cB/+G-犔PdiNY ԇb0u]AcCLcI(|Ҋ4\©a 2XN*~+@^ v@Zc[c`(6%&2
9N1P?dΤyj ,T'3 EoTQќe
_ QF. ԇ9Up>>o]%G{dH4<2ْKi]_jWV}!tEu#JBʒ'g,妈ᅅpn=SXMC6Gx: >~m>ie"d/2\©S a4 a
&ijc\q<
O yq}.`
E.b flIN&hXx]ܿh
8iSp|mCZC{)PKdy^z caJh/L";BY 3eclؑIC3 ɂp*?p Оpab=JӁX˝۩rWfI 4|Ln-WwP"p p U
{ZG롉I6[ 7$%נ
fZ:Xi)R[9f\w1 F:Hc[r5O':`%VZ/s G_|u!<OT=u-w>0m Gd 4|:Elyy+*(LcуkjtMUCGCC,(OL\ zݜj\M&M
"UI y`.y}ֶA?Î >63Z.l0`z XN4;'ҍ,Cc 2#\4shgRFZ!㖦G|㸍Vqz+HpF #X8]b `Z!uz+HpF #XNخÂc0V`
`$% FX'`0E t:,8F #h F@b:]b `Z!uz+HpF #XNخÂc0V`
`$% FX'`0E t:,8F #h F@b:]b `Z!uz+HpF #XNخÂc0V`
`$% FX'`0E t:,8F #h F@b:]b `Z!uz+HpF #XNخÂc0V`
`$% FV)]a yӨ */P+s:_\oϡ؏a+e8a%k˛M~a$ MɚIJ1Qc z2%vNv6g9p[ei^rE$4
ik7ݵ<仺MB`lbcbд ?b (˾u'.J,I; C-vu.r١!
PuT>$,s0BctCa
*
<" 4[D_trZ~ƌ:So^X2)R@4QEg]u1HZe7 ˝(HXS
q4;ch|,КA~5tr 4RP ALjK'fT_`P g sOVØoّ{9Q iS(-y;Hb#O3 @G Y11ciVX|TKQUю u CCԽElAr >meb8%h"ɚkAR= p*eG
P2<~PHjc<PBEG|MV
lFoHVm!0m5Y2d
5Tx$۠64ף}'I g",vQ@G۱]4
T ^ !Ch&>]y y%E.xyB\JrboQdE 흥v*4!7EZ7;S9suӃvxVi ugn8NqC>[df`zAZh#BQW% YPD?w
R]ʺb~ڐwU
,ѓÓTgMxכFKIIK83Hcs#+JG'g ˠuS@n=W /Y{my t~#zVjn qjuc.G?s{7aʣ'_Q½__iBi +8 X~d*8p1k<8J eD˭:v13x8մAtjcmmC/.Rstj{
ꖆİdcNXon9@ 37K'; 5m$8ԥAwk.h&aA?i- }] PuX-vƭ{ sC,A@U zaꤸ{uhp4R9e U=8sg4$ YҬa@J}iᡳQ@un}U ]ˎ9iwbzdA}b9Hח%
#6 DW*3m$90 -]|P@
?H[}Pr2(M\E%k_V'~? p~<#)R>Re3ٝ:V ;فmN$qi!7+~H 8ư˥*nU<2 \cJM\>\\0ѠWrvΞoT[1BLt썫f\3BӇOh% ]|Bo- cxt_ uTVs R[ѕjIT Eܹ {W[vDט̚~|Xc Zq6)RWT+G CeRi3g\% <bOn!oOxTy)Xt7-ޓ\AUz7k
EE `Ҍb`D<j--uWN3Wru/toZWWz<ȭPh{gw7-rW}-őHDz U9U8d72]K:vpOa#UZAO]ὦr;s\ d:\~\ofH3[fOG4ip|?q$:E:aO|@eUrL·MQKB U
x1MV܂ lPQ$L >1Ij\ȷq%P
t]!ͤ!fwd TP,"au.]M~4 k a xսlz
f؉'.̞x U˳
/~^e(W
n&m5QQ` 7[CYuSL<Q~
bo)n@r[Q qʏA+G/R:ev3 Ċ8GH(Ϫ@SRyڵ9=sOo_hJyům,7L+Ne4_%pH`d|ӊ9_ݏۗ
tYYH$!-2EK')"m߄o ؇8|r_'"
Od]õs,EChK?(:}LD( Ԁ* +D*-._\]U3Т?1 L*î,VM7M)ISA#AmYuώt/z
DȻI`!4
C<UV Wz2T=b먱j4Wia(xEܻgl&>fPE·Csڄ 2MI SͿȈ WUpj,] QM4ڶYj: !S Te% tx&@[(O)h #D`NJ}?cfN=5£h⋘[b B4?ǯ4noF99LJz#} <4FHa\q۟sIc GB֑+ h
IDATǰ ͭCf6Fr. nfq$ġy씚 _:5 SZW X1t5ݓ
_`hٔ<)f5|Ё$fGvL^
phh[lQ* ܺJÿ)oc 3\xSoy8_Կd FP
?70V
h "ƻ]70=*0ѳ'Ќ '@cS*qx x͟5
Jg<U" d*c
nnoM &~7'9 RL8 šۊ~D5җ Uk0F ʗӂ=-t X5?ј5-⍓TAoz| .OV
/&> /3ӛ*h$)|+1P <UG{*LYSx! Q! DɅ@vFo
co@c_i0pfoyr z^ 9tg%c {Z*XQshT)BbR
J( TYgۂS8;Ow#Ms%VRB\/y_<W >5_(++<^#'V)N1/jrsoϹA
iɎ/ .ե7w uد|欉ꤾo\@P.hdC*DPxz̻7 j4Q cϬ[)si
Yu:T j^ቋyu~2]N~AL0q):s@*P}cd\Blڳ uۦY ܂o{Mf
/," 8< 7 1? 6v/ c']u#
CG{uC54sQo8"^:QFbO i!!|GL ?B
.ԫnILv`\Fy
߆eEp$nŚ0SM1#̐iGry)r'!KBm~J6LaeC,ey/HqJҪLȽOkhAdSW}~ٹHćOxF͋ǭ +n/ _Ĵe6b$r|,>XfLf'?o⩻VaqA |RP4d*bbJS@>Pu\JIa 6wѓ.Z /K 5?
Om& Ru,| bc/ 8 A6RÞAnQ^ح6`ꏵR幷䑣
D*sAޙI@
dMK}YP U%LMf 8aSS[67'I hP ")#^OvQ11k23/}t`T ;V_?<H ZҊhWXq׀9bQ cT 8 Ua a5"S5 5)LC+ܽlf`Vxpc
C3x&;ȕ+Bfn 0~ #`>``0 r< 4q UI0lU{<s9-t 8t93Y ,՞-i\ ,8}v-)>
J\퓓.Эhڷ&E gC]-P}NT(OU MKY
M@oέG
/O,gha> =CXy(-As{SoXFqhHHksD`avIҞ"|GO|=/lF bx:1P\{9כg31ɏ1aJ{sRƪ_zMJCua}oip:'feS\ONƁ۶vXkwWp|T@|nfcŨtARlTԐr aW> Wm/ o̜f,}i}6m@>o'[g
tn #EvkVm.,
8{nT3qk^VA3,Sf\st
psqDQHzFb9
l Zs ݵO &X&۔ j!0LnK~b}[[ NOwˊRX]-Lk_ʐa^Cl
;)[oN#u&CSܓ{KSD LjSl1Z{# !Égh
xCީW8^Ʈzgcgt;N@HQa _e$\]@{sphnzrql) "+}mfpR&0q.s @_a*ӗ]\W E+Ѡ~ +@YKC,~B+-<DŽ=3FKSk ~br䷝WY{
F@VNunVC7'YR`w5TJxX=?nhS=ؔ~xO-0*KZ?~x%ew5şZ=ޘ~߸sg
K]ώmDȓu GaLđT)d*|WBϽ}1Ҟ~+{2rlwW ^RIk p0414? nvF
bzrg^F ҃to?0+?Z.d"
l̗ п=9GUT%?ueuEO ?r%b_q۵ BA]Z7N_۲'JR~ |ÝJ7@&on͂C5nA9[ Jn]urNUlԆs tv/)_
meö}_P TgtwPȍInET01~V}`
:ìq(B~ɗ<C4-(Rcж/ze Qӟlw:[G֗ + hi8A:' '1F黠zp{k'~
}_h_}JXrxĽV" !: n'r yԍ`lBߑ KjAGynK"E{\2g' 8U]}sFgn:p?[H2C*xv0$ g kb6egYXY]~ w Z?iyP]Z?kV#RePj~x^rr++?lH @+OOJt.{i3!# G/ 4+yƎ1:Oqv-ZݎuBVX8>-ꫲುnK.> xtE^-u3#)!Bx3)}7o+}(U1wz?Ƿ_ : ]S[p/<Ȱ97|vH5U&.f"0 8b4=e1DEdMpt!:1(HoMṉ`cY[DzRCQp ޫuAr&6fjA.laFsǨ U`KSr+
)*~# 9.nN:sSad jf\=H<quÕA [Ч OH k]QjL>.ņiF&y& ^!HRpg;dq!Uk^ԡ$aRcgJ0}Pͷz(U`HȄ8/)F掇ٷ|CԆk@؍/33
; A: 8Ƃ5ݴ"ҏ 3g6v n#g3 OfGP g k뾍"k/%I_u6D .Dg<79b>{8{2CLU0o$En_6%d[ Q
#jUM 9Z*MfejSf 5y Ct7l%y_6rG 0$ީuSPG J
4zQGdWB~}JRenA>!"C@y3j0~K-A"4p7IQdVp?}cOW85uKbXqvi1V G:BWG)CbPE|#cá#&ZhP:8
oٰ8$~ƶxk F 1r$^"
?îNCY2%4|f'b tς#5ڒ?,3T,&- ]q/p("NzWoS ~Q:*^>)>;C*&L
a ~0$ ܹH3 lܯf[-aoW V, -GK%MCYU{FQh7QصK &:^v^Ge> RFGaώ!ME,qˢV>nؘt >[< )S+'e`J E>pX7 |3 4b<ҥ!qxW$ߋEGcU'O-\w@ɜEp4C|3Spvr Ng);[Qef ۃC(WxTœ9
wN{u
YC*v,/tn&'˂H_Ubs @* ÄczfpD^ *{`4f#Eys̃vuZJToC!C"$B^>˧~ UEn+֬A )! Ec 4Dt^?=Xʩ'8o I'CU';*A@v)yQsedu9/Rt˧,ϳ, 1b^N/AkUsJxJUf8z] 3ߘ3ވ,Pqt 10Wuq4Ѧ Tk 5E-ܩghȜJTsh& &6 珇b
z+$UPlʙ^ [۵cI/ρ|e^xC7ѐң("`,x(XX\S
Ԧ>i]L]8]>G. 8# Xa-n!%nz~x PY!ugݸ=rql%YJc=6=zx
{lq"uXXp"F #HzIXh F # , O34=|}4M%pez5nԀy(x-^r'Á47&.4CNEpk w"ICY4ASQ`YaW$?K,C&
pu >p,ZBZ&FT#
ȋ-d
kѨ ]]0N_SK\i*N<;䊀>|CeA ;>4I3 ciK Krj_umzBox}`_Ltr .t9we)l & Y:}fiCj.hq" 6gL1Nv( }7;" i~7PXߗԕSî) |.p1 eىCcp=
/&{a/r[zx)9.r{QW]Dž c#҄__ C{)F_2,&SOZuy4-u Ȫ-HYq7 DݶÂ?c[
PJQ+13:v䊀^P;>ѹU
լfm
9aҞmp'0p%_ń#'t( ccd1uR)75k
9(7# O]t6
,ԇ;TUUdBG0m߹` ?i{q^`@ͱ?Ƿ;QIJ5
} ދ {O0<j< Wa$5zD Hb: [O&
(j.KXlK. @AF[<C(NE7a27)XKMu =\\*|U1٥{bA
f[ArA>"
zϒ?FoOdmTx)
W:=/ Z{E8xn&ܣ 4ykJേ4->GPy[7#Vpߖhx:'q0 VywR[G%
kMÚw$]CLEd ) O[(LMpam^s69~=R3MԠQ| }{yt<D}
5(uۅ#kD7OC3 i2<A'͈<H7gc8 J^!%W 2wԜ$O(;ty<$Yu
`|ʠjFoq
'U@1{&y/rQ1s!M#:23ZƦnVsѓ. mV JB,& ӡI-1m3Y8 jMb/-gCS6UyEs.Ǜ,P:EX8gnNv?jHp K+<fz +kjE˰B miܫW&Oe6G/7'l$+ɢ'n~RvWy
lF;;L iɬpJ"`<a E*a=e2mցt1-CxbkaҴb+ ?m CGW ] aVSsKbBή? P4V\i}MMzӻyH+1/P<\#
}wx cz;ҝ[RBe0~X` ## $<GQ?suE:%waE
i l)9W>.z,'DFs?Bl\t
ҿ,!#I~#C"5v+D>u+^ gT]P'θri~Q?x)E5 TB<n%PuPGA E&䦐 nR2(GcG-<h,D1e;r"C7.Yz@u =TiY FW\~HU5fk[r M_m f^w ]][|'hCt鞅\hUlNj`_Ֆۮt@G4Νvx'Th0(kݬiҽ#y94} }9 zT^
&M(r"i=^YRfO83a tfMrD
[l7qm /Mz2lH ?ݠ
!31'zV) 4gˇG3b 3h
4Ϲp͏NLl/d UCz< Z7G:NBOsa%6zn #W_ |u^V!
6k@eHmp++ _I) PЛAH輬>r@02hT
]gR^ĚCk90,s0U: =5|+js-onߢL5b<( 0qZ3y0l&L":|]@c.hȰ<hͤl+Ȗ>y"f9/[qgM36</MY$<MO_M\2Q!SX:/d(B ], HWB j(&"Mme@JT3'&Yo?n!C133 _Z/D2(+d~u@ֿZqN Tc% 448ss IDAT.%^d,AQJz$m<k $|&]l{Nuu4?M +i`e+0KzkQ<6P}j<mj!`ΨG 7@[KHSw z yi"9(*f{
Cw*觵rV3rWZN Qh/%0-((- bfD%&0vգ'Z qIC8|$>Uof5ч?}ND
i%tdL7,k9Nn _k\Ha6YλFyM
7:2p oܹUDGeݑtmЌc<qٮi$̄4| T[UJN0B4+vqXn
7oJuAUAU
od<O@}
YOf d ]_)OgYbJC2WsyI W\/+)&[P t >Ҟy*6)qխ?sqN`*N3=f
JӻM 1`c^-ZΒꇳFJnn_dH)0؟_`çPbƐ!p/GI ՞?m[ Nr GؖuYt pl
?P/Zlg ژh3D0hrC0Y'SF¯;FC HIt"mb
B{1H .`AaX{g zQ+ <u9B+gh^"JCgp$c8Q%:aeQ1)6\FOh$WV}s]
h sF)s+s_R&2\tML_QV_{ȁ섴__c]&
xpe/bTsaJ,
` \'efG
D@0M*J>Ii7̐GBfi5=_g ظ k[XpQ#BlZ
wK hn`z/wwmAeYHCCxl*j0"hfW5%y
A_M~> CUf)W T&lA_SqP.!Y,-'
3@]?
P.OC㇞uWOכvpGo;Xg
*>I'_&s~O%S[O,=mZ/WuoӊA3[1kF^S8.bG$5D Y#+M̗va ``BN'Ku|Fm_[=gԗF#ygɨX& lӟeWUU}]Y[u%Uc#B t| `0@^RLL
j}T*'+ 4NUiqAzv{ae%О..3 ܸY +pr_#%l_*/Z +۷ܝY۔ AmnQ3w14d i%)0
f2hski1MfNf LP\9ugN4n7i__/ipc;wf : T oۊm1^2MOV.'\~s" #%''ׅ cbr$ z(}d-R#:Y0:=(Vi,Nj
3|~F iL4zggp-[ẹCqҕ%@۬4ܹ~ Zi bɜ?}R$Znz\-*=SV;eY´{0z?pp3 x k"U{>6 *>V+wV@,Be5g ݽmNn(T
4y+j^ލMJ)
閂wd^ܯm59}%U@ :RzAhJM&0=>j^Y/? 7]`ى#LœB ' s/tTʥ6Rzڳ旯~6H\N5 89vP'dqz7Z.3Ѐqe@/b~E G ccխ[Q#4*_qS E\8{>99\߽jy^_teö}_P Tgtw&(`ž ҵY3LjL;7oμMg1}t^POןZ$ ;HxcףU=,c PAҙ-KׇGtnWvac|N:wrT]'?dʗV-tFԟU=x E=́\ ElXз?y|]x I*vx,RURrC;ON]6HIkxnA:X+W?:*ܙV<ǟF չm PtxqɄ:,!S ƾ^sPq AI#>+LfQr3N~|x}]
9Os^v x #++m9Nr 4wV֑b
^! .vu ==O\3ud4pey"Q| f6;zx`B8X #HTFDfkZ1s*ryEma
T &%"坷#Hcf) }8ǫs`>N]ݪϱݪ:[6C_sfoa!PWS)_ i ,c;T?jt('!mhV5 X 1Ryp+#oX
WZ"'
Rg`=Tp ¿yk7+ eVp?}c}+bͧyos/S'*.Dz Z% n7w7#dWH<|c*kaK/w52W`==>
_
SBr9t`x#
a ~rl]ܑg*o翎 ߶s(N %%h̺L6Y 9מ.t
yA0_9 d"TYyrPW9Vў0~iKNVW;ΓRi[[:IuWe9|3[R { )=- orDn.vy]:KpNoc 1>6Z њ_pJxJt
ӥYz^^QɎs|\DlJ]
aw}SԱN{V>qϵSߍ3S!P>z3k73#ofn)r,ByRs
twο8H_QPS3,@ )ߝs*J\fWyxCyUt;Xw.Pqc6s< 3iCÛɚ
272ׯ?xIeKi)R'1#$ Mf%SDtud} LU+^:Z䏿'8\3mK V_Ǯ˯糫dR,C5:].~ ,x2(S |-=%X;SU 4snm
6aP<3TxSqM
:_] ܲGEɩY/?L}NJgIK|}H]kٿj! DZ x;jw <(1upPVN"ݜ-;
$-x&aj# m/EX=pFx䅞[E BmA= %EůJXJE1:]b\ RcHXd@@si!jWuzWyG 8#!<2/;CpH XKdIЕt]v`\UMhBޣ=R:]Ul nԧBW/554ԁ3kr^u?CMcUE} EZyeY誺;?l{=Cte%@&WpE/V}J$ I=ID>mag?uR hytK),$!˘ %g EO dm?W=؞K3XlfUS nSg &}L:?M X̻k?vmk"
%EO{}Miq%ɅE{Ord<~^cc TtBR Kxȫ攃ޜ:ڕaޕb"0N+#s؋zDl{y sOKï>1uXhk*0F`:Mc 8vm7lؖ] mJEH:XKzJĮLqP1]*)`.)=Cp4H>)!Mt'NNRSӰʪZg\DF ee]'#`:>R.7%k`\1AgۿrWQY:kfT%zo nUo
. LW棘:Ze)Pq
}<IIZ.O6&Zאy+| M}M:Tg@f +SNVގsgĀ0Q&))BL^InruY鱾)mR} P)݅wӌauW'4TTy*xuȤ꺔qhr;5 \ LXk1a9SMN$TȚ5rtM5HZ@֯ޢZ|ЯᦫRuwĆw*y
{TC }(6tTrl2}#c]pvGU k:
@CUvv|@bWpJx G:dŅWuL)$[[:ΜNb+e'l?um [V͍R_\B0ljZ_> J9VrR9R>?X-GQ12? GעZs(%P2T5Zz:ʌ~]CFBZ姷rbR :p:7vƝMkH թi{\nU7zO Oٲ1"Ýi?-ZT"A}C'X+û
3 >kԺ\94l0&xY1 6ۄYSsu+^rs4[Q#̡6t:xVttPNws\
mJew%`M k{ @ ¾GD"*o+j[^Zo뭷umjmW-X*ʾʾJXÖ@H9' ŅRp!sff;f;%)C \ZʒG^ssKT:#RЅmuw?;|GT[E hF ;_]Z\Y YTXaJQαQP{Srvi)wl \}U]W v+0g`]^Wü"=l+߯mnޚU)y |1gM 8(v3
].N[I$(p V8,ˠ_=оĔR|ç9c16,dux#ʛRao,6\V WeLWS]ۄưP }QCd yy 3z!y: mY ".j (iz;Mzʺ UM"Z/XR#к3Y(mvCBNy/҆|U^<ƹ_]ܓW ^*1ҍgF1?.;Vgnj2s6iC
ucS<A@<[kFwr쵇Vx NfH_ fOTՙo}v`Ĺsv9 ]? J [ɩf3[`X.aMr1C: tu%ѺΈ-bK Ί\yd©}0D:>(K+9Oi9PGweUUmyC*ۋǟD*h}{=Й"ϖmMUwnhd.c̞68Xi-W躬+WhAVx]3{./),b_
:|0LUq{P\ץJ ]`AI53D̖ki*5\8/#tƖsM 1IsʝtiG&v6ZM[ {(|n@}0BsNLx6|o+Н7'u)/n'O0|5LDBVV k p :^u;H,Rk Trt` %!6Z$?j!:_ SQXR_
kV( *i*5ݑ{dЌ=yXZ8hb߾ܺC ~qD uo~d( C%_yYi"s>=0f6䓵Pپ InXQhNS<*{4gHS;#5e: )Q:O6 :]<6b)
C:r {EQ|B" fXi0!!-B%!U |=
L+?~gƚܚ܆ŏ Ǧm ާϽ }b
/4$e /PCұKKLh+Hj/v.I
f Ux.)5OnɱJ _Uq !4Tz)RҶ"2@I7>h~BGfkAWM/=~,0 R(vzFkc7'L vD9uyЇ^eEG
rjoW?q6qFYqj'zqmX؍0q*~-m:EEX1kx9YI
P7\?*MAĚbkF.AY4=z5D:v]#FA k| ^'
jd
ͲPe]^⩮,L+cKV$o{R \7[A.ktm]BSUI؏<si}53wѨ)kz,Vq_. 7ŗ xTVl@
G-g G |LEKŪj퉍X礉E!ɎЅ
]=u VGχ+ԅO_㑪K̦Ql].V/AWc[9 }USE̹f]E _Y]
3F~N{"I|"'7yi)l9g~Kv;Gg{3-y\6 a-QX>{@wUPT(ë3tCl[Zkt {~oinעCT^
Msc:RMÁ墥Sc@VV=<Aft'%v
W:; lB9 L]xʑy-$ma}%cS
T!fAwfUiiҟ#?V (B\W XLxQ 4s8NE>`Q 1]eY~Ioֶ -;b" s} Q
<}v8|bg=|@# SH:Lt8-0\Nu)^z%axƅ2 5Ztfxy3zTpc̛k"Ye@ %U̍x;0bk $X IDAT}9Ϻv3g08s?H ?B{krD{ mmohjR-<Oe<n<zV/6SG rus Zd
+(S` PW- g =H۷=0N2Lk,so=saÑ6$yNT1{E A ;9
<'qW`W:p4PsqFE̚]/} w\D;Oܖ1`˴1\87+oz; ˿-Tw@
ǻE pvEb;>߉) O6| ?tw\fm,X7v(] i 0N7{Ӝ
ʟy mb3 X[B>OTѤjG Mfaq^ `g#c ]BwwQǰ2QÆ Nw0iR7ފ8Å Lѩ@];g`n'SHWp`_$Z'[?RY!?YUeG =[kyx;i'Zzo
w : ˙ Q넏1~X@9U'VEw@i>#߷
)}GQ*DQ6FGWƖFSk^ ӡ?)vƘ%SrSN]zf ~x0澺*t YK&.xoWZىS%*AWͻݡxn pJf/RqxX.(KA%<cvE~ރб4j +FQ߇&.o6#FX/RX4Xϒ߁¨@.E4~-|ϩTތ~ ~zlEz?7?{E'5o/rt?Z zՉfu~kBu
&Gߊy[3 RKz^W
n}[g'k m4^EHKCeڲ؇\ ݰPW8l3܃9/.4`* Ңk_< tU k>[_s }#{XAY]F& ;_bcm ѹ*H!k;M@3"6Wp^~Zd { _(8^) 0G (%k*V`Ќ^t:Qp&BSMVup_;֖7WRDFԝj ܌#gИH?qJ|$&;_q4% ~wml\7O"8lЫm>p<מulEJ}UqaP]Xs؛,1 Zo텋n.s3ƶ9;rx[F
A0 ]w@]Pwj ^\Z$}2_ q`12&hL #sD҆?rbBC6F-g~ii{!겎DW~ʂ-^)QKaH,-2 J 4b܈+t^g0w`(*DX
bZ A2?na"i7 n, VƴNY] :L&ٻ]9e7dgdsME/w8XW '[1CT
nzq: Y N?~h }:߹qC@xO `dosw<g|Ua G(}@ ngk/)t8Mode.DR\^[,梬5_9 `Ѻ r3iP_*iQ~<UBAk|~ s 2PpS6U M tz ;;J/ĉdײ8w뇅FOw\qM LuVt m)t ּv,qH&hH+t8)yUGPpQB2 z}E خǵ<(MxV~^aŲ
1AMM0t:ela$q3"A!.arQ22:@1,ho8z R`|.wfU=B.N^v]se
Ki~};Y!o b)et^ tFmQ< 'Y˝Awŋ TXX" /蟕 u*tA_B<eOCڝ+t0}>0*OɄ1P_5CVcTf MqO46{! iEM'Sজy9; Hj :(
eYأȮ"/S
i!9
;|w\']}o
pA,~9\ E6~O4gjit~)wD
}^TAS@hn1ܰB)"$1 >oI~)0dBg<z@X:L<
~`=~
W,n
a<gV rVj=8.nl~^[Br.~9o;%3hZ*t;x4U ԟA1̡2=| <Zj
4]Yǜ
HHa`d
M3?+? 2`') c:}6 -Sl'lz-M
/AA[CS~
we ߠNt^yT&2
ͻ%{ף g bf`z1NA7eQu
.$nٺy-LĎ=& e-s*TLͬܘ_E tgt%
]pցž"`@-p\Nm ˁMOgy% z绻umK15fZ3uד;tman$ZНM.LlBS,Y-AQi/Pb ><' *DT7^D#C ]twLR%8)HtGYҦis9\ m1}y&dymg W!]wޫ,_DovzӍXo71ᭃ}"a%5#
yߧZ_F@{R}܍4UHu,\`F
2/i*#7:7Ma ˈPCo3y7:gz̧|w'[g)Lm.M)tWY,W%]ih%kj\X7r˒ x`{qLкe w-6DSB Xȭ%xCM)< U
lR XLhH ẞ U z?- ++) i:R鎺d61S'Tf1?8eF[ճïlI1يy~0q{D@@wj}|w8 6 ?H*G*`<Ϗۦ *~X'WxyYKUW>|§
[NexL*''e
/,yΚ/]n\tn/!94 ps nzNzT)$3֊gk!T#7@~~}( w f;{~s;
<cm+o2_}XU]r.4=;t0^z92s.β
-yר*ewSپIڽI}@Iѝv=.Dȟql]^M V)t4uWmm=pKΗnQ=^sǯmm5 J幯aN3k||gh൰4ZCŪ0=k4 /ح_0MQ?r?4(|bb$PEU͛~ ͚OMV_ۯɉ0;ʒiz"(Y<>7QybuI\%ggPC
AݖX.=nWA;翳EO~sxγSB_7P8k! l1AtAfbB@H(XsL+~=
.N:ZުGgECw#颸ʧaWMɛwO1JVhrD;QNR2 홋{ {=<R&~8m*\Vs,^M9-ܷ!?[ 4:u?Fb<0 @؇ Wq]EȌa
[hĺ_B'F[T_*y<xM̓@mnErJKS &IeE| }= yl\G<yO2a6Aˉٙ72Q_̰QjmjLɏ6ucC2jH*>6XɓYm#Au+MOϯ+J<Qкxg-mN ud]~VJՔAȕ9l] <A_SGg
w3?X:Sb}lbI +*\q3jJc'& :]
UXq\Pqcyiԥ K3Kfc {ÿkud' jF~vzZ IE:#rsmn|9:t`8)B--!f4D*?]}=e_94&Os|ޗᯞNA>H<2>EͿL;2A 4س,YT&
` , _Tt ?ڟj!0QX=S Μ2Iϐ _ &o'0bH?XdDcK8,`u-
̃["}e~xvNr/Օ:\TG!"tf7]]
;|&kͨuj_V\rv
rJʂ* awT_V >#0 HL" yQ 7eo|9d'2ҟ ]9dӁz-"ἦԸϖM݇/(_,HDE`^liх}u0& gbI<gφ@ 5ҿ⬠>!gC g
B`X{K7`Hˇ$x44I-{^N5Fg"?mB@1_σjD"YYUq H'T
!0f)zL]1k ~)@:f4ȿ,ADQt_v&HǐN 9Ixޝ"ʮT0*ό Z#}fPE"@S|驆"YNSi+@v=h3fP(M2Ez"E qx=-b<B!XWVVn#C9\)=Uy/}$h"0IfF&*$1=g+l e =2
oB/?:P sjh/ ' G
>f r~4~0YO+ qo?E<wǂR @E;Ng"Z :me$L>ߋn+wOw^h{ZN;Ei4=5L HT֔|eX4tR
#Sg%-;sB|EJKِ/{DKA5 }o` )ՐC` X 1M:%gɧf2g3\?Ò5 ?۔iP sNoˌ6\0 O A`3P j^<e"~:' 'u?Ek d2Ӝ<XCxq5w45 hXaϚo rQSEZË\gU%<6# <D!~Cd S'R Hʼn$M1ÑVGj֧$F<e?V源V*^fb+jУ,1lL mjz4XR]%T,^x[> ah8Xe)iwwmnp +i;p
3-`9=PN rL&aꞠg3YKd4M&Ba0\H*$w= )9sV?s<]\E i7NL_>( <
2 (eH@Q<fyP#v 꽜.{B*wR#`IǃrG])puMUroomD
JՕ=$PW9:G\f03{#oFGg "#"{c 5zg]3,o\ͻz>;;үlj[nw0/w4(yS3N `*-$Lfm hAzptpH h8_3:>wz ؎3}i3f^{u<()d U<"P}f :np?4tU"Ub:#rtXh!;}tHR@`Rtx{kn &][;`~]ő7}T(~Y A/ =XsgÜ)5In8ߎ hn/ا]5` ɕyͰ k^ONLi>. v[:wY &zYr* < GpjrCͳaf/ Z& :̣a܋F.* m>$ Ay..jÊv7waIQ7/jO K#!0|/PcQ[*2I XA.
AkB3 b0e%x0U
+@0=5]_6 5T% 1@sIb< A 4uhN,I}Y)+@T N6.SUԴR8<@RCΊo0;rp [slպ="c[hA
;ݎ_B
+rByBCtnTS"ij#SGK>f0 Oj3.5(m Y ݉-$:KV tH*c* Hi?,V )"3MrlE˳'u`h;)m*ij | hE19"ԖXP ]x-dD8 um :
h|Zt+5WAQ"`C-h P@ M lE4^_GD}a~cM/%|h8xjW~ sCÈ" W`.KYh@Y]xܔ{KTE Φ`UK$U AKk``ߵAnO06G쀩T@O
$gg
S <1+> ?q.dz``#DM8OOA^\
(<%Ԃ6l A`Gst"vB1YIBI `ل\IJ-)?Ҏ{FN EKxEe 2P [bj'Z(sQ@}}SRt>ve)dj`ˢt~R[ϰO-D{i d*^Φx r9oLf_;(gC%#or:kދ$G^Qj{ 0넣1
@ĆJk渐AI0
:p!r^,TdLBZsmvLgԷWdIOe+2(f~*)Rl|E1BR@G 8JSu
clLoɾ勽x)ɢYªA)R_V;vJf 4@`RepO$.Gu#抓ܸ2rxޘ'Ux@a)/jV֒U5b0-1 {RQBtLLVL`JG{j
ĵ< AY}d4x<j˵զtZ+%w IDATOd<
,B`hjE>jv"sMq!!& l
I 5R^H*nS% n_G֨Q8,Φ>W]V|߰ O<j_'{&I
K/*DiiFoݾ8Y5.:e.@H( !)y2c9` !X
@ug~~t 3|*,S(f
ӟK.2n[{]VrB)x}/PRo_R'/_Rep q: UP4F5)Lޛ|%`}}.Rrn (9 "E3Mi|, |q _-Xu7#d/GPcGmH"
RS=snj
n|xtGwOS2pv@X[qQr L+
ώ@j]ٳG5TeW{*^bsxAEuM\x&
m=5H8}b!߷ 4kIO).;$8ʥD/Z3 (lRwhkɴ|Mv]P_.& c3SE( 2C\MU ;=oW5ބ ks:61 ]o.!)e_ҟB exw.ۄȷ.3*EG 7&8BTvzumƦkgpQ`L`o\Eu;r
{yyF8
ƽ[F$hq_ 5NC*BJRBR $T^U ]mL)Zdcg CL`]譌6e5]ebKk^RIH"&߸]-T t 9bSЄv'n., pR͡)ܴDLJF , 㒚k}b202ߺ (**?% @`RלkЁ_K6f1BO1.u
Q¥N7sfZ͠Ckryk :[ wW+]`1N%p~kޔ Jc HZTXԜrZc0R l,~(ob>Ƀe 3gٹCp}:KDZbv8x5Mw P m) Kfh;H@x&<\mZ;qbfjj(2 xtgs"0G
dRAcK]q0.{]o8 bAސ77\o>Bu&a ! Y ""u1oVf b=ck]E|>q#Bg[1vT`W7GU`Cdl(Cʔ72D[C9+?45 a)PҐ`t XPU(b$2|Xԩ]0 -?rx=rPBy S{<Q4_ۘO;@_Fީ 5o8'}G1Lt
<FG}3K *z5i%_S{ ^
v7vcaZnsѵĹRwHJ&IU+i4@k 9"X(!0MM3ԜɾxL.] ^1/?IvR67= !)P)0rrk֑s+
ǷZ@s* (^ERhC,ha?NH06,FeHf1,<3s;әEB0!x7tQ߅rd-\ʻ4̔< xO K62`͒=WQUAoOpGbbzQ9@f^B#0^Ⱦz=mJ{
[;I z8o71o
T1H}p5
xS*:<TKQ D3XAŸz@f#N8:e wo4s
Ң@[}Ҝr ;Οq s ;- 5; DP;QkgQ~AA>ytYv53~g 'n< )f_x__(L'G"0t"4[K}dp Bc!!dS+_,--bZ)u]Ѫox«A
!< pOGD @!J!*^Ĥ'P(%"![{R'S³Q{sJi~)
%z113J*v ||Syͱ5r g+mVA
]1:(!0Nv
%6%]h3ʠ/u<HTml0 '-}x]mlBR_fNg C8{Ynۣ/soyM^J&ᾗr ѠY5{:7)PRW^|i\gn㪦"k6Ŕ/$98e"L&Sx]Ye4 xgΆ< ꎮkzfp{/Zk3:n8:(E#0HGF~lѪEDNw7U# k4t
b
͋ lU%xSAl1j _ K#wxlsƑ'}
M{%R:o[gP//NqHpƞM5P҂{a<,TtN9>_q(4;GLSNrIhf`[u2ƓL̇ -%ܖR<A1+JPPqt P a!i&N'>Z%AQm~Lzw1uI]>q!
?Y5imyw45 hWPRVqeȄ堯ZE&{L'7WyikJzMg`J[Wޜ֔r[H<q
!敕U }L E(B`tm8gs4F1hoW) { B:1 זCJF1] :;uH3u @@_>{>osELXYA NSI`w@|c{Tl:Ǔ=qsAwCtyQ93k?+?)М%pcjzw&}-ޤBwj1dx͢- Ƹ`͏P7c/9 jhÿK27K t,ߟe
*Qn룜֦n_אVbWig0Dj-fgsfԳet!?/TzMiZSm|6[XZ
jw2ЫiaAF靦d5)홽F$Ի16d=y9{om5-[W U
g(՟hl7{|C&pAϣ˹_#A }5+nF?|(->SZA fiq c l[ax Ѓz$Ғ +Ӧ9MjS?)ks1ɤ;TY)&_ilb`gͩ 4\gvw=@'#7F< kcU
~keYy^ xXv^wcVt;Z+zwAti]6xją܇ )Z YW3?ub;nF$v{qkclJi\ \B
}lFR S 2Ayu56`EN00:fMGў^T=-
+fX'$iٺ<{Ac!~f~Gbpͻ`G (89/{ IڼؑŦoɢ*Q19IFaif! 8co KZݕDid|y { U-zSm ТV<46֦n # ]^tsUEJ J /KƾG )5ǮM*R3%c;S]*k7%9OĊ.>Y UZq RD(cʋiDo[/, bu R@//\R V RD\L`lu
Ʊ. \v[A.H ֳ kBR \K0ZMI U3*H't@;;SY jX8_c8U_KY5W9 o3<rYİOIs/ aԘ#DL.DfBVEnJHɔ,E͍u :3uk4e"rDFpc ÷ҊLC6u@MѮ`{c#.k 1ȹ% w"dUT[6oϪyv'cr\w(TS"B;Swf{7Kƞ. 9pF4fLг[\i}|Pms!0t:80y Ze U=kff ŇmJт^*# αcY\E4c(uסڧ`涕˂JPW'brnRHXb:)ߺwث%0[Xj. XDPu>
Sqioc3t Vguf+1k2 CvhmpuxG])Jxop8z
3aY_|7Ҡb
da\DMM"^Ys+<U x9=BQ8 "|ԉ3#>H3"m}*'j j̵tmt(v:@#mLګ:D+뺹5{ x+xۀ-Bʣ?c`
cT|/lg )!{{6:ߖz:^'d
7s~l/Ԟ$V@ \DfeHZ}mSrh#9"Lr53イ<K;Wm9c~!IΟU0(Tg,KJff. ,v·cTb >b:^K]N!ɽԨDpt`<\.S@"p&5c9 9d6fhhLSQ!?m}pWҔ)JS I 8: UtfGT:1:5L||T=y*pM6mz[k kFQi,k GR'Qؚf"$|望kNO!.
&=cL\VQʝ
!{[x=O(CF H1GR+tX +JiYt QH[uWFP>":zcD!I crB&4_}fӉkG xY?wDžo qZC%@:/9-S BWxB !@xYagd Q%! :_ "m]|2\+o MU8:&ב w웽*wǜJQ D1-{]`EMz>VEi@a;JD?z-#Je?egN zakGU.}_ !6 q((h6 xýtU9͘2bgЃ
]t2*VLtD*+_?ƃw`EEAiE`D1q4-;L'r|i|jOTh"Hۙw0ef x,Z]B;ڂK%D9F R\9KH2J&,ztxB'/{>= }oqPI B/?}V8kI|<<L*+7Op|姿\Z%J$ǪXQ! 6, -X1I$Gea└1#6 ĝB $QTK^Hz5@-PvL^QFeQ!L2 O7_`pr7c'G8H:ee@)>dk
d!4zfGČ VΥ8)FK.M{`IDE2f1gc깕ur8%cS=C)_xG|9.$P/7~j}3` qaR;~i<zmus7ob-@L
&vv%-LUts7֓g;J)Ir /"%A>=ZfJdr+s%Oe
_ghA;4 ѿ
]A6Bk4(yS3N d*x,ZO3I=̰6d;Qї P>Rܢ(E &.NO)0:DӮPN4MS$In7COr-1=Ag[_@Jb)wdc؉BniT
9a<]5oe!Ñ :u=sVX
c@{kGřueK⛻[ bDG`RtМRd 7Q'<q
*4/ ~t ,/" Rm@"(a~}e /ƌ:H^V & |46É'RC"g I =: Z:S*2.Ʉ̰u-"%ؑuwFO De%lw|OK c)@ud/ [͠Pa&_ d< V& Ë1 8gbqaJfFq6Ys&GX@L`&?]4Y]⾳DwWvS@_/3d32<8Qm&l S
+ik >13F 6 tAr%ty 1!Y$AÏFgS(P {YD D < O65VV!3$iKk`ߵXy~t1/hۚ|, :a-JO B`#0^ /N ;މ_:qwD)l{t:Qcۑ8xƼMI>ts.x@Y<p1Dxkqt=f#9
y?Lr{4ʛBvtE`my, ~hMgاYoq~ gB m,L V? B` 0t"t_Fݤ!prorO?Gl? 1RjHvѽ?9bF y|!'pe
gB->?(!T:lz9m}t] H9 M7VYOX Fj E @`R0wۚRKn܌ e<E?}{H?d(B !0L*;},B@`{ ."A IE :j!@
H
H*B !N Q B`l@:}lpERx txD c c+@ u&B !N \T B !0 > 6 t"@ @ @ W$!@HM B !06 >6" B`<@:}<PGm"A IE :j!@
H
H*B !N Q B`l@:}lpERx txD c c+@ u&B !N \T B !0 > 6 t"@ @ @ W$!@HM B !06 >6" B`<@:}<PGm"A IE :j!@
H
H*B ! ގz IENDB` httpd-2.4.64/docs/manual/images/custom_errordocs.png 0000664 0001751 0001751 00000041417 10671421551 022407 0 ustar covener covener PNG
IHDR W sRGB gAMA a cHRM z& u0 ` : pQ< >PLTE qqquuuQQ}} 0ee릦 00eeeϚ e A 4<e0 e 0 0 000 0 00 00 0000e 0e0e e0 e00e0eee ee0eeeeee0eee 0 e e0eee 0eϚ Ϛ 0e e0eeeeeϚ Ϛ0ϚeϚϚϚ 0eϚe 0 e 0 000e00e eeee 0ehR pHYs + A.IDATx흏cƑg)UJrdSwVJ3Q)e_s'&##襱.m8?fvPDP3 |8.4b
Vl0ƕqec[&M67ƕqeceN /gm:!_U_WMwZ#j\{;e } PWH$`^l%ې9 \Óŕޫ \%\
~@fM4qm4]\ 4to7K66 ^0~8I=]TlWڰjwwgJ wcްW&Y[VVg[
\*Y6^D ff Ÿ6d q@ 2~pMnȍNn9/ƍpݡλV WP RB9ۻ:θ+vX.MiRfCoY@5@ vmqE\<@>2h M/jn 4=*_:Z1cWsrE0PVܼ*.W .`ۂp6}2+h0%E[umĕ;Vm0l+Ƹ2l+B7Y0,g[]4m %q-s`?gn__U{ŰO`Oȣi|Hao`2s`[]\˔\
BTKE '3pt{R7X{v`[]\ fqU5 pp-s-< _#%V0S3q/1=xBAllZ%Gu{*EMػ/h c %;U 3PkV¸wZ*3F`lzvq/ W@Y$ i4 dV`ƕqecc\W6ƕqecsp`c[mk [u68*`Oʸ6Yqe{
]ۂ+[Mpml`v .]Ý MlC0$w'-Wi8x5QaWtܧD)<9ٸnd ք9ܠF}oGTGG8Uh`N4z+\'
gtkmt9ٯ{Ɗ
Exc`GvDž36d/[[>>zP Y
ŕڹ Ieo;RgFע~+3q:tl=n3z5N+Ck{:~~(!r@P< ̊]^_6@\5
OUØb̸4+ia~/`ebW 03\
&zUՃ5=Cɋ|M B Ҋzg͠<y:3h`7
p-ޥ]Q{@bbq}l?;h 3DѪr[{^Ό" ̉kɢV)\Ǘ@qpuaap%^ <c` (qκ[B/u-bʸ{1uõVy^C_, .eslh?[93 3=In ^!^)3,9F+lK] R\χ!Y*d*LJm%o5ͭ'sΉS̻6ڻ]ܖ jIk|Ex>KlkAk.D\1յl5ƕ llK
W6ƕ&R,*.ll_̵gubŶf¸ŅޝE*eUĵ(v52fX ;baR_fƕh}м.ҵX@:v.w6yҰD+/rp5Zd^3HVn|-76 NY\ U:[HS
s 3\76<\Y;ڗy;p3\wgfc], 6RRJOcnߤ434u:Wphݽlc#0
Q]<Z \*hGP`S.aѝhǸ.W;KB,W
9\ lo W+pQи -;W \u,Pk8"{vBdG&m-m9
>xMg&`F<dYaGl6T,=WS zf%ħG_P9U8t^
<A{ 弫A%,.6wŸBIZk
w4gҸ*M\E)\Wj2&V7U Ѳu0pm71n6]/"]\1_DJt{#ZWVkc:}KzנTUP:?M w3`
i@'3
'3tܳUq"K3^"JU<E%k$ cI̸Ů`t8tm*$Ӳuw [
,gmouJX(s*ի&I кĚMt7fk]
tFxۻjٽ1emqm@h3-lKv2
6;M"l6Vטmךl1
~.2Vr7u`Y bZi\:e[ǵiMm1l]{mbk\E<j
}<\ J>]l4]V W5O۪z,xX: 0ۭ㪻k&Ph>>B Ͳ
:
@pJj%+]J
JW_ X|'zf\V̻4(}s0Fk- vຕ5aɋ]uURveqgaު߽kGY +"S~FW#3 EXa, pLp\ 5,wMc Y*t]5m9 Wl\m^J㺌cY` <Pf PzWٻBPWXu
Fw=LK"Ij T`Uq
qA =Ћ/yO B^\ }y[A\^.a < }|fAEqM剬i"Fa.83Cͳׅ+8H͆F]i (\bq? \] cB\s-]A
v5UWVl,GGͿҸ)m*<X癸vWf k]kXaT3$զ~v]0űvۻ.W+'Y WQ
Wwwp9zǮ;F ՃY|]ƼUk
@~QNp5Yk {J
Yy9qRfnL#f@m3P ^QNjVXQbPW8)Amx
!5"Kr} %%/(H6A8 h8n BA%w :Й]ЪV<yC\8l{X7w 0U#YGDIZZiZ Y{{\(Q@qke1&zkʲ
ƕe1j+b-?,vca<\k(jvk
e1V'5le
.{5`[2 @ \v/QͻKm,|N^. yk]d1Vι8,b59< F7`4<=hw,
gi~ zғYElG'itrkd1V WZnʭ
:H:S nT93P#Y U ]u@5@2 G7#
$#b4u`[1\ !A7ձ{+]0 Z{m^l+giW_+9 =4L wOй/jQmpE~UJ%V(;cW,dFf&]i4ob\٪B9y}ǯ?ϩo
1 8[
2`NeUpYk5GQżVTU3Y 5 k,Co9+X+pDDǽQb5Ad1V:Gj >/ǾhQM
`x/| Es&8`l+ɣ ŪIT+ǻdzGGALfa@[9U#Y }l }M.
q}-So>k8xk-d1V˻
d:DGd?ǮBn`{l#\r{Xz; _L[FYDh "rQ4G5A9Y `wfhD'wf<8PywE^G9ֿdkU XfւQ$dr1AXǓ9yHlQ(?zBYaEʲls9֣Nө(/Q =+cZ,v#墦wdykacR@8B<|:kyʲl7=.uBtz= >DΥ]1
@^Dƾ#rUY,vâutMm!O9Wj N0$F E9bW` ~F?1 aѻRQ/i-k6,6A"~ECcD YHUZ,6/ⷔ̚N~:F~W \HNTM0#ʲlsuqۋ3{Z$dW̻RWrP Ecz WbY yle_Ư=
TjIfDr225v eu8k!bUvڷ^ Z'V{%n#ܤk!bU\ {%)Zt:Z#L9q bC+^ʀ8OM\Od
g'} *,`ߨhH//ޥvO|.M:T$h̲l`}U"U +|md,"`/Q TbY 9CR{ګipc_ܭ%e`9ho뜱+bKYjP`/kβ'K؉XZx+ƮS ˶lSiU ` _c%x:'ߛ c`[z*jZ*G$bY(OԦZ-{l& =g XsbyKJZ=`iR$d&`2X +g 8)cYf]0Ԁpv# |1;bY *֗IQ^B,:ؖK`GI{#Xm.'[ڷ 4/3ޗ}"W;NgGpyll:KN^] .uq,
n3@1r0,F 4sXt{YĚIq4*S0#YP{P5Aص,F^I<j6l/U}J u/!יHb)>Ud1 }06U^ \%{IsX@Pu""9$ KZY 8 /#P1P~Fwnl5I
W/la[>ud1 {5+h%
.X/EZqql
բ./$. 3$5ûp^x5{a\4fK$Ꞽ@dqkVPU@VxMyJw5!we\9 o֞HMUVm@~F*aABZ]شTʸeJ"혥ɔ4u ?գKTU]U*lM9;nH3 Gp|,XYE2u6q":K¿pH_JA ksT; We1~R7gBs`f:\}2 %ͷ&4t=؇RuB*v( a]*eQ '.,U+TRWX%] a@yן{EbpZg@u{YnKX ubiH-@Hyy[d-Po+״{^aSXJR}8|=&X1- dzͲlEYһ^jmJ`лX \w>ʲl% vK1ޥι%(šC )]ѵ &{,[9;Cw5Öߒ6z_ Uczߍ[Hm 1M@]Į+[Z~ {'N/3!渧GIZ RC5L֜+b0Bd2K:R \nDɥQJ;nl6xrSU["hCfPUD19]+bU
ZNx'Ѫn?wXBi!E"{*eK4Li[,kRJ'D?r+SF8` # n8WE/}Q4 £t4 U^_)o4 բ^g#*WҘŃH+"l50&g[:3l
wxF`e;,Q]Gʦx&?$1 e1 F48u";ЛSN&Fk@7~Oj(LӪ*#veY ȕ$P͛ /Y wu it-_OQc"X\d1]STvnc H\u ^R7rtǓn u" JQ,4o4)
/!\& R!\wd|B *Xs]bS\#D:L@>/DWR=SxDY$Mݐ`&q,He[ˎ[t|HbI\ EX] ȔXyZUz״T(B:\DĻJ*U; '5I9wZRuDG5_#cb܁wE(%A&,A0\5r Dhl6!<
2#fZV,FyZS֒
U=zh : %Q^/-aa ]Ss4"'IK:+4fWZUd1J*LRElZ d[Q1_'c$/=P=Hk~w*vU~UU.D O#'?H]V,F%Z3\=M]{ wNEiPvKvRȔEi+{ E %ۑpͳbT5b N
4l{[ S_#өl[Lށ+z(ׯהW G=s˻.Tnc-i`n^ Bp*EXw~;@)em 6$l])W:J;Ve1`@Ut:%qe|N"NixQ>
Rؕ@.Fg*Hj$uѲ\Nq]i
Ov"1_
:8~JC2UҮm3pY@"K8Y.%g+6wo( Djѷ 'o'd4/9 >'-3̉2]K0Z,F^VKe:z#HxK$1pjiX̶| :!=F@g:ѲG }ꋞnڶJ]!7@ &
t
L<- NͶX5 P:PX!bxD6LA%a).UGTeߩEI:,v]1&j ;= 4;jNC|ؕTq h0 P@:֤mD&n:x99cW`3o)$zJ^ Z= bU.'Q3n#s^@yױ:wlwEz h`Q"&Ud'rk-˩,*mV+j,[h/s{bu4v{p$]ʱN +neAURz$ AeʲlESGGTH VHi+
wh.גkc dUǰ -ĻȹɚY#9P:Q' o$Ǫw6)cF/nqZ&x9W`sqD۶P u@AiOKH*V5yՑNLӮjՒTV ,[A0דuZDQ aOcd)aQ:iv$F, {%i!JzQ$>كX
J-zI Iްi$l$X', 8@J X8 0 = H:m `VbUueY EĮo1ъm\OH0E G. *@auĭi;ج<e1¸NUL G*uEFJI].k(E^pI즎^Kʲlu0:N=) U.қD$I+ӣB |%!a!e{W`SRe} R.wtw>(E( kb Lf0IcM?w],:d 6
KJ(N/@ziH Pts$NusZsƮ `[J 5<z~,]HU<+2IwźI6ke1 t${ S7:b: }hWyסj SD2P7Yq=k[Td:gEbwͰvx@rtH/8NS; vhBo2eU氌.FS5Y R+K=urcj+0l8[NdqnԊƕ4%1ޅ </SvV<sa{`PƎFؑ80.tPk%dVGS=oRe1 f\+C
̿K@1H`+ d ڴ4փA71Iׄctގۋ"q#\ŭ*WV_Eڗ[}G5 L=éggyuv~FOrf,\$néY4~V @:KnZݥ ˥+(nL'3ӯ
^ `, :"zpK2{9{9d6 ,O:Ӳ㿘˻ŀ_#yfeK5X]Z~bW5!v 55[,q50/n+a[ AVj1vfn:8dWͅq*yGWq.a/VBN)+p13."WosBx,-ܟ6w"F9t"\ f*SWp5a\oۻlm4Yaaq
vTf;D.^ Wpۿ*{8V0iN(;[Of2rGi i1<+nQu cI
YOW͂Ukgv ]T8X,̛y5 = 渞0g5dMp[Nd-U滚 uaʲl5]Y>ޕe1]Y&ޕe1j+bɻ,[ +b(veY eXޕe1]Yvull`c[w],R3%e1VŻ`c[ص,F.O LOzo[;zB [9in"BŢ/"e1| r ݝ5ޔ4c WJ!zصUWOh
36_WυUBuøړ\wmx =h
&]o˜1a[{#W#Z"_!PJ t¢e?@v>U;rȸ'aĮn檘BZ}Bk{5_DP=<$-ۑT)ʍ8&]}1>jLde"W`B;wpSB}Mu` Us fMM Y.?pi*p萧5'Li/]o*d\*Zu` לP WKPyd1 >:{A
?ى,<n @ D B 8cXuВIpoc}̌<V2q 1Jn,ì.` "v +S!. %&l}t+ §]-ʸ` ˔X +W`weY :zW`Qʲl5 ,[-+bɻ,[+bŻ,[+b(3l5,Vص *Ů+[MbV+c6d1V$-a&
a}jwhKO,cA`KNG?F; $&4fCq }7-BCehANJPicO75pgVGMot*<B? "c2uuۭsb2yJ2س4 "XI9BKp& -e
la A[0qsaL3'$ٴ4#8 Yt!/h5 ݒ\ (3G|-0 #{/dOt
kd
x4aċy6HoٌHlH^:FeI+"ifk^ Eb$ GLV!m\Jr@
Ng !$8KTeXL O ڌLcp) lZަ&kz_ڸ-kҕkyY yh* KˌJWU '!5,\fvDrN(K`oDdVX?^dv6e9d1Rq\m 43L\ڕwkFmG* [d9<IF)s:,9bz ²{_ AsL{wZ"(i=qđN1wnI^
(t? b5,Y i ::zD
~
EAml =9"y_˸`
ejYEx#%:V}@.wLZ:F0I-ڙQAx #`hϺ'ǻ\cMt;KΧYvVV Ytit:,[e1W`weY yW`weY yW`O:l]WĮ,V/ʲl+b1- [yZAmek Y 6U]Kbw-+v,zjllw llw]+b ?GEZJ϶ke1WflĻ,[+bλ,[]+bȻ,[2,V3ʲà,Fm |,l玲%oq8$o lCamj #ͲF x -(Ƙm``2&,1 i `9٢sĮ,Q\SoAX`N&F)`qcN`2,i 7Ʈw5phy`(1A,ghU#NN/۠tFw,Fݜ֢epq; Xý-cwt27fY V0 *XFƲlk+bһ,[}+bĻgYVUe-q EuRkEYNH ůo'ikJZ"%Sp1*eCJYh(?cn:Õb}ׯܲw-%Q;EWݰ[/ba:M]g^ -U[1۸D# |@>BwLp} o7v]SY X^];"dv +aחo %Ay}#}Kq\X[YtWW%%=d_]5{ .- ~+?azkue1Pϯ^{J (ʕo^%:6qmٹޞw]Yٳ/_=¸1N?OuJD$Df} m_VR7]WCUgD,"{Eľ /?`?&.?_ !a m+Eyŵ%Yfzue1b*)_=Ȣ|In}#Yyz6ҳk+}7;,ъe/ϟ=K}lY }O>9f 0YN?|s Kvuň1F3%V9^RK" ˬ%
JWϾ.b< À =!K+Q?9ӳZ X*(pEf
dˢ9ϟ{G*>!lQ? ?ܚ~|LV\+9>$S?ݧum˸q ){W }!+}NY_*gOwӸV\ Kf|Q"8!ǩ~R5D#~A Wd^Rd!\*{N~߿ Yq۟~|JN M\"P..ު.~Gu˸ ꮯs>Wxw2u?mbcr[\1S WFi?o ^?5VM8lp%zZJc;T+*{}O3[VۻM cXEpyV|_O
\%ol^ Γ2=@zt-lqi
Q) w
Ye ?*e \*煱Zg7ۏyzE wH,e
;gVƵ2&ٲo?j^p<CԲ9ǿ\ FgxGO?8E-]1xſ{],F z,ۗŰw}'UoZcx*v\gAr7FM`\a,v=b3{cY8n>`nV0RLֻ~ )!OsG8oן21Kk#M[;>ep}K ?]tۏ>ĮX#M[WY ^;z(n^qk|~gFcg>~U䴏_EV]uU,F=g ҴsL~Uޞz)wUh<'?b*\,#$}V۳ͻ,[MRV,ۺy`[[ﺖl,zfVmb=ͽ/ކ= PLŁ\MQ9aDA2 ؊9TH;34t7& .|]w㷦!+ xֻw"Ԙ
g Ff[S
,Έy8h5gC<11bNxɁC1%xX[E[#`zGd1Ho & p6Mɘ֒QWy/T <ML/- rL=[*㷚fɜ;~ yŀtHa {RWXۃW LokrjL7c^ A9azz:uַ~mp; ܑ,c;
۷ 1D)#VWa'u=a^ٚݼSw>`HF@-Z4~ z5ŀ ^,Ÿo,Fbwl뽒`[`bq0vK,F,/`7ȪrɧElCJ#/8w]w6e1jgޘe]Ak^fUE#
>Q+J(gٚu#bX-w*}pkZ:TŵԑCS G%@
0e1
nFYR$-k435WkƎ Y
̃s7h\clTE6t!d/a}4`k^ +X:ݶ _ev3Y Wcdx"k&8Cf+q xmD
%c~ܨAÿ
J X*?/NK^*XhhqVuϡhp..Zlh"d64G^{6{BӍg pZaЮ
ݍo3۾ e1Vm末[ _Qpwu מ:rG :V9WBJt:ڦG~>8Fw]bxc:ٓ!tQKfn+ks_+Օ<rLJs*Pȹmϻ
ַ_B' zגvfwa +tn~,kb `wIwb3-1ܑ {}No3ٸdj 8/ZyR8:\bcגV8ԓ{y7w[` nz#%< XmɻMAӅ`~;R08_<f J*$>W`-yŸ9bzw_Ӱ:\-紖w"6w+Y 69kiYNfZGZLz?`tqҟ}3aT#2e1l̊v
?ZpN;":jUd1:i-u Zg.Gcur}%\zgk9֎z.Q u: }d.5Cc3n7`c z0wl*RV&bYt 3 IbW쌞decN7el$17j \Mu\ S^f5w wٜ>Ů2UX/D$:GvL,]yD:~c/ Cr =Mp2&=amo&."k'掰W0Pdx3݃5VʡIu!TüNԙ}05pu~. : 8W@:vv}!MO+lnnY Õu´F:mԌ;v<[z3Yx(qO&4Vl ŵj0*
eٔD;A; ;iw: ";6̀ȯv\@z03Ϝ[ýXdoTԒoXuj1V1NBLb,۹2lV`c\_n$vwV`c\Y 6_ [Umٸnƶf`c[i`\jguVႬZ$⼕BdۺU [csʸ1+znoom*a^Ͷ|jv&֖ 4Rn7Nn3ݻ%mڈ]w-X|ivvB * ƕŖum6f]Ǥ2Ju[ѣG
0õk2 Һ+v "\J\7%.Uؔ
T8n7W``slo6!\%];* џk[Jfâ5부Op 7D.DIvf2IJn7ݶpmZo,Ƶwkƕq
v[y'nJ0[m]Wӣn7vȜX@J*nqdfʸe9n7)%qca2^ūZs&dnBwD{W5'3lbucj
ūvNymBB+4we?36V&i M+vmvljZg%Rʸ2`@4v?AﺻMNng 2ش<knf@z]mƕq
.vV0-g^Ѿɯq9ӳ:h~Xkø1+zK &/쇭Z8ܵFƸWɶs\j`+ƶ,\&ll5[ n IENDB` httpd-2.4.64/docs/manual/images/ssl_intro_fig1.png 0000664 0001751 0001751 00000006403 10671421551 021731 0 ustar covener covener PNG
IHDR G xk sRGB gAMA a cHRM z& u0 ` : pQ< PLTE o` pHYs + TIDATx͊뺲2
4~
Sߧ
Jw\a= B.&,wv'6{ \= UrI*i==M2$L{ !G<}7F+%U-tXBhRPm@݃ /p]E)qCEg
%$ѵөRETQ\P71> FX
tmU*%_3 ̖=-Df9#_Ri˨6z=lٓ" 0{H_JiV Qm"@S-RRi }`X
;2[(Q'mN[5د b"fvnnE6rAoMy BpCdFlgJ6_CU_1XHZVԃ
kr7Ɇ
@цc4s9F *PnQ~M
1 P"剘-1#2$beb{D 9b{C0,Vh*Pmc4k s12X0m' "F[$nD\^؊wD wߕr`+*uZmJLܠ iW&zҬ֥@*UZlxSZ+-/i+SM,Jkue =<;ZL$Y.-9ѿAc}&6!ojwc cC@ن > 7PٷQm\x> 0X$b:ԍ\^1>h>f{DC{s
> 0 Bԯ|0! 0 "4߲oj261\|[R$P= z\PתJn}?4G%K!oHET%BrJ%%ҴMN2QJ/.*B$e64JK=R
;|,J6ølGho[[߭ՏWL{z@d<ߥᏏO<ٰh}C9X`N&0Dp4!6rDE b& m@ qs bF no-"[>Q-YZf1BEd &/E `{ ȌC w(Cm7x
qr 3-лi>Wo12o=0 cM &``@W E)P,gB
-(QԛMYY*JrS J!U[R"2˅àj[LBljA-D*JkRP|Ҳ!<T0J] s Q'?DUfU*2dSV90rkh<uy͗Gu)0R<%-C
~\va<%b > q &Qtm#XӰC-_~P@<%B$Z],kV
[],k4
z}4 r H-9iu;T}M+Cw=I;`dߤ5rJ1`g=JҢTrJUàRU3ZLjtVYERg P(JgC
JijlEU+YnѤuLVcjDrjBMSu } u n)-=^<-=4$-=04-=l2,-})w9iY $enҗļG
0gu~"U`n"Ɔx^ǴM1@]` 8` 9#{O>ڪKduLfOqGE,>>]tZ1<܋:qn i7guL
;y
D!oy w ;I4n@6WM%:Uu\B_GPg͕ J :mtJ뺮?l hN+R%J +Q 1N+VJ u/C:i\HVPm@7>:kTR]DyDf @5W*QeY-<
{QlM,ɋJ]xpX=LQu_L_>7l5|SgBM)>'Ԅ-o-c (Wm-Ta?mpYRetNlVU-WAmt,vBWJQUK= LJU&-εˁlURJ8r!pɹR) h E&7vIzU݊U "Zt/ӇPٳS|u'_=.5QZM kJP0(1 Joi\J*QePZRUjQlK UeWtV&M[giuz\sJ={AԸD}%C#o>^dFK3 gn <`]Ķ0 o= h [3![9|`5V3 36Ė5Pa TDh->P;M, V&Āx@bfkx@C1@ϼ%2 խ&1 D&7U lԃg7& !P*mtB8qR jBj#T$IiUe^ᮭ 3Adҥ.UIrGtUB*UfP*? V}wjtRBD 19J-^RJRJ]nhE^ߋUJE,7UT\t Hdؘhq_.D"s{ܢjwC+ǻlu\5w '= jląxZjuj %R'gN3j$-jV&z7zTz%l9Ү*UiudY[nVr n و)$ҳN5 5:jI&dI&9l~P/O z/l?vz~={Q?_|{>Uk6/~Ͽ_z@ξDO/F{yu j>͞^fן|2{_ ϯ$L2$j
^>;.U IENDB` httpd-2.4.64/docs/manual/images/mod_rewrite_fig2.png 0000664 0001751 0001751 00000002545 10671421551 022241 0 ustar covener covener PNG
IHDR } $ sRGB gAMA a cHRM z& u0 ` : pQ< PLTE `p pHYs + IDATxM<*
M/s{GAmtV~ ' ' b?=*n94@4 B ?8 p ]w)O ynlrّuϮ@Jt) g9*p| _ .7\Eb
rPUR=Qx Q=J3 {\c 4<j# f38R?Sd@ffl+
I)FaqVڻ/8. ԻG(3pbٝ=qQU9 )%;2pb@'C 1<ybb {QJLd`T\I=L1(:K)fK@v
`1s U^ty/33ȃGK("JE㖱xc
#0 Ïm; 3@ig֭5 m`ߙ]4X#N8}AN ` K?0f -?8
=?pk V?8}A =?([` 8oѓ~`~ < A 6EWOΞ xh~rjmmn`M_xS?0|
x.~W7 _{ {̮M )7k x0?pp'+A$?@_Y_ 7 Vi , ij 3k]]_
&`x,?0A X~`GA @e sXL~ i4@
7qBls{;^u4@4@4@^'µ4Ih"g. ' g@_\s\| o{ta~C5#Lv^8Jv,u]̩jXLR6]PJN^!;Ro5 RJQZaޫ0wpr\L"b
BTL,
ybs6Rk/SG$d
0 (jP5$ə;b)R7Y `
H* \J@]/Ji/dUO@2| D2OLD$Ikz 8`_ix94d IENDB` httpd-2.4.64/docs/manual/images/ssl_intro_fig1.gif 0000664 0001751 0001751 00000013152 10147723030 021704 0 ustar covener covener GIF89aG !GIF SmartSaver Ver1.1a , G I8ͻ`(dihlp,tmx|pH,Ȥrl:ШtJZجvzxL.zn|N5;{0'9%˧7#5~}!3 -ஂ &
|}"&a4qUG} 'v
)
mDB SN3"6A,Sg GѬ$t[]Ҥ1=p>%fvkVZZ`;ۈd/5;-YOlѦnٜYԗX*^韗.7>6#]ϟmoצN Z9y}=[`9*ߓ q}'*Q is[Z7tsή]vŏ<Ễ 1/YKzk~wyg^z 7 [wY:8{wb' be`Wxg[yf`f( F݉ U0
:FpJ!;HԒ" nQ8 l6h[]- Ȣdlyԓitu[:W\|V'~`Z|gnF< PS*Hq zjj{cjjB뮼묷+$$쳗±V˨ ̨mLwSZk9(I{r(ʻz2kuv-ꟄjהokSXօ[;of,av Z m㦲2b796 H32*:2}"nWԸ<KC8H7hO赜 X 2VC;Zvz݃ h^z2&6 = <th7]Mo 8t2go6Yi\uF֟^)0%JAJ8G.B}q0!<% /:ϤS9\|b#u)y$S/rlHi槯cb#٧>? z)QR"DID`6p}<4¨۠Ҷ}Cy t Xz%q@.oa =
֤24D"@&~;T&%.`X֝u*+ڝh0Ű\"8:QBdx28s.
[g8eYj\
U2ms*
)8ͅI덯&IJZj&H9Z[甆(6[` 9@R>l 9MN+-2* +FHIZH\!!q*svdrӌȀl&y/6f
D:i.wkEϷS U53~^OM(|UDu=jF9ϋq HGJҒ" =(%V
T,)\RXCtz5J?=R+)
FMJ!58E]TԞaW*U}
^*XǚկUg
Zɺմm+\UU@iMӾA{=LEJXVMl {|)+_S
e9 ⥰jֺ,fٖp|4JD;bAqkn S깯PpD&Y0' ƣqg%Q|8ܙPnrC RzwB+q[%v5sX% kS &Myu;dJܨ=5
!G%~ q,I))n[LGu8ơ'OdSeXLAdM
*0Ϻ
ZbD1<$'y`$41_\،ʖ2&H4{ ыrqأ8zrQ]ְ81ey~7d/t-I@34BP3NƓ +zα[x93҈9ZK&ۼsEq*$߸fj|ӟb!=j@78 iazCvҊ\VDij%f.kͺvq*E
Uxѭ>N]RNhf*#ʾT 4}Jgꁶ`lF pi
ځW5ތ+⛍|qK_8Q!ҫR?!} 6DpC< b?3-Hŗ_%
dF'1ҏx
`W#ЁC : W9M QQ=q8ouW;y?۱ (:8ݯԧCI-*ˣYK&;;h,%j,Xd7UWoKaL]eq=S9B>p28nnQ&lň;4>f4w B֒[ZM;< ?c.9}&
HFjd9 B+Ζv(Lg&kG6| q+j(c3'D1s5b'ZD%B-(vz}^ ru@tvOƃs|@XEGZgGԄ%PPRHPTXIx
c^O``bAql؆nxVAxL\P_sl`CWp~D {؇qBW{ȇ${#>3?v>G=I"uEqHU?"QAT^CBr1舛Uae'EB8\ys_%B]ͅHev'>v ys7dzw^}Td[E'TRrը^'8Ɖ=i H]}]o
v5Vtc(Wp y-[فِT )ly-8ȑ%DG(ib&p-/y
1kV8i P}<YY> @yn?)ATSՓETvVxuWKyMɔOVuUNiRP99ɕQXX3]5W*i,YFpjWcɊoySl)gn9APS7AOx)SlYZSguq, "ń#bh$%gydXgrshg@w O\Lgg ] Śu'ChɒID˘]8^cbkR<nBw|DzhGy6yi{dk=x?nGqb@gfeф/Eǂf[;6&2iqc}Ŵd);&|Y7225tdGf~C
:y^vJ#hw#ȶK'93%0:Ij4
h~Fk ckDN4F#jq)`M6#*:&Hd9DFlچhqxJh-:|з m=:נ{ƤYZ[ʥv6~z4]sgXBouz ;鴤:p PY
J
3YW7YI貝g[*ZIqؘYة0.>F*qԃ.i::諿zq"$yI_`y7[Uy.H3'0iHt9"Cjg4䪚txx^iuhI;Ģ!Ww1vY{v |b~5NhC J9WsmB ZǍG靊Ha9Ԉ~gE*@^J0 Xo{⭬PhB[T[ ǫṵZ5*Eص rgbGjm붎/١sK1ڷz-Zx`~{{r{+UŞw< H6Oe[:k빛{b4 ֺ{kKka{Yy;9FT:HYLu+JT` ۻ;֛ػ]K`˻|PKo5 {X`*an0U8r(G-~Y+[wJp .%v# Ț66 t!ҍ+k_r
U'\t |[~ǀ,lLvOǮDĻT ;.]|Nw4eҘwO|wh:V^JrQ#' [\c,*<6`PNJla0_Þ wT<ȧ[ɉ_ȔNȁZɳ'ʟ| _dʣ|=}Z~|_²;@hy뿦˗Hs6ʻl,HUˋSKLiy9l ,ɋ[F',D,|>| V,`+{{[3y2x}=~&=T(˙}3d@4vx ٴe{XS%ق*b% /zWzsG,oЇHs{mT&קgi
*%v * 8Ʊ4l ' Ӥ:+꣔sH P <$5r>U
jmMjoydKay% (| JEM K"@E c"hj6)o X~"H)L=
ڜLЛ{<1̀к]uʒ|MڷΕXZSE,)
ck
{Lŧ y =,8> y(_ە>h#mN1l0ˌ| ,<Yƚ\Ah+F,dYE7(d٬.\Q fCԖ8mp #%Lw$t
JٌgM5\flLz:+KApr%9ohB* D:u} 5k˴Cf:mcJJzز
zJu./ϒݏ Jp ~Ҡ&顾
` ~R؍-U9MnͿy^
+̜YQ#@\<G^4,{iZ(sޚ#.Cl|2UgD'.T&vH.o
lÙem֊k /pIjC@)E̢ ?$_&(*,.0 2?4_68:<>S:y5yUL"[%VS@@S 5.PaROS"DUD_V =phV_T>uJ&TUCPp
U@NZ:1#KDSu=E0&Xs}{Wu2#x&@XE>KjzfZ[JEdvn#vy: $,tXXDl44T4kDc
%-5=EMU]emu} &.6>FNV^fnv~V ; httpd-2.4.64/docs/manual/images/ssl_intro_fig3.gif 0000664 0001751 0001751 00000007664 10147723030 021721 0 ustar covener covener GIF89aC ̙fff !GIF SmartSaver Ver1.1a , C I8ͻ`(dihlp,tmx|pH,Ȥrl:ШtJZجvzx5zn|Nx<y2|$~ +g%f"i{gǃ) #QƘ, W߇ _,4Jxa- +OS~&*cǎA OC0ppT˄+䐠͗jҚi &&OvFKzL ң$JMXad1 =뚓R7qtT[4H.eU:jݫJ`Z 8%hF"ږ[dX$Xj~
[,7S+Xg#-7bL)qʍ:]hʾn-9fݟ'
FR^WiL_c\rP7
8VB=lyѹ^__)5!/Cq.|= =
J|`|6m F8V(dž v (bzh:'0xU2h%t<~1`)(5AD& ߒPF|!)XZ͖Yv%.Tid
yۙeY擣3pȦ*i')b8|.`)V"砈vq'@9梐V
9X)jp.|*N4* v)^JES ,0+T q>DB&l
Ùr["Nе8l2aӰbu.jڋro.p\ްoRyW\pD wYF ܱ/L)怯ɥ ؼ3qn,0ss6<Dy%4o-;A; 9n4zu_0b `e7zljƭoӝeޘ.vJQIxê.("1 nC.&VΥK9ؠ3x?:.ش#%CAS{"pUپǛ VdOp|[|OȿRoޣ~Yd~#/vƷ篾U~ȉ1I, *ACg@d@ vNɀP3(@ ALn@DF<\]D >4+ IeZ3 )WP,!+pH%ωXCEXbX\ i./
Ad.a`kƥq#HmuqvLx8-4P 3F-f ScH,ЃE)$m؎'r'AuytAK=1pg
fCI$$]cH j!d+=PeF>`/FI2 #!sTqt9#G N=(;I^Α[#M2 !-]IcN $8
7RҘlif&bvP"Ja
YC3]<(q0
1yӋ. HFDɏ9A7rk>Jړ<h BS ixRR-jaN4{0j=z\.yUQe5XV5mZWu-Y ּt+bZZaYF=.dsc5MqHVJuld ˿ֳ
΅ Xmh Z-kgbֲocV=-!E.jiܪָE!c5]V7GCu]V%7Zgj,z':+|zYN܀`wW
.҂;a ?x kz F= 5,[= 8+ً>8LqNb c֫ÄmؾCr]Lg)9R1ee xy ^ 1h&+?Ʈ'39lg:0"[x=yφ>=9ǂˣeҕ3i`ӛt (R;XĘy,izƢMDzwjoGh&sOl سu`*! Yu;i0N7kJԛ Aidݢf6Wԝ j櫋mdx6]o`z Ijr0h;_fGP{{˵|sM qyere<0坣<(+C':ܥhN/+ԣ*Q VRs(L^ϩX^<I:f'ڦ}mЈc7(ǽ6~wvjq5/T+e<x'] n-7-ä]w_5[L_I{ w~K/M3& +Lv| Cع%+
F##- Pj N\;W/5<я> 훿_:hIGoZ.LϿD<?'oFE\!
QrGkg2FȀKyRNv'*NB hy@b!eU&_(+浂҂.*024X)6xov:)9ƃ@(?8&FhHp"xzLs7PUUV7XQZ@x`x:se68i*gȆm|Hsv1hxzHMX~(z"HnO9HwqsgsmhW,r$nm(q܅8W9ah}f>S}{ 5'v&7vKU3C fxSq3'h(AȈiusQE!Q<7hHf\Uvk GOWdaP% }~;Gp
MEsy%ЎtXA4WAȊlց 5MFwe"9O**h,֨/-w0;$^Qq8BY$vfrajC҇1fIxBYӔs? Ty{XN;>ȕ]镉r`b9fGJiɖ@qRrIyuI&tykn(,~I~I{),iYm;axY Yb.?<Cz}Sz5z
x,13|1s,y%yŚ3%I)3Ƶ9ٛKh<R[˹9)ә|i)~ɝY#QɅYp詆乞a)w.6i3""i 0 Zz
ڠ :ZFsؐ ʡX$%舡b8>hO&2&:(Z Z*5tpu(h<:BZDzFzQ;jMCc<4zVz7ʤ+=
enD} (6fZ'2ƥq2J\$OrhZej8`> A҆3PJjI:z:dl wKZHWgzr60G$e`ʪԥʌ<tx֑Zk/~joI&By9ͪJjѺzzZ݊KȐʩz' ^0 AJ=5eU]=qH8$GdRdI>'QSl5Ko)|MtZfka w;.|?@<=A¾@ĿC7JKL1O-P2QS2IVWؑҞZ۟\([]] `a7cdefghibklmnopqrstuvwxyz{|}~3D ; httpd-2.4.64/docs/manual/images/bal-man-w.png 0000664 0001751 0001751 00001334171 12663316405 020575 0 ustar covener covener PNG
IHDR [ sRGB pHYs % %IR$ iTXtXML:com.adobe.xmp <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="XMP Core 5.4.0">
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
<rdf:Description rdf:about=""
xmlns:tiff="http://ns.adobe.com/tiff/1.0/">
<tiff:ResolutionUnit>2</tiff:ResolutionUnit>
<tiff:Compression>5</tiff:Compression>
<tiff:Orientation>1</tiff:Orientation>
<tiff:PhotometricInterpretation>2</tiff:PhotometricInterpretation>
</rdf:Description>
</rdf:RDF>
</x:xmpmeta>
Ү$ @ IDATx u.OΘ `AD" 0`h*'9|~~o^k%5DZ$JV %" 2H D s{5žw )U@OU\TÙ;222 f[nhq!\<(|bmvE~~c έ=X9ӈ`9<<<<<³#]O w|>RPPiqywgl
2Q76y` be1P` _ x7{Az30϶uFy bs
`O@@@@@@@@@@@{c1h58lku RݯY 6 < = rBs D- `uۢ4( <
f(yffft`xxlChIDzx}<y\ZSaI0`h]䒟e|wc. K/qJuѱ֥-sW䦢%S `Ļ2|8қ6?y\,geeE/7.<.T]%7\.HL<:;;:> lMWO Ez@Kyyy(**)SP\\|6XΐW<YKeip~!A+|丁{G˟nY j؈( g#?? ~w%J{1dom.g[\dv1dLFŠM%C:m#v{~{1\nUUM
<һ:hKH 3e
Sm%^`n +JGZn#m"<]9t$Q mmm8rHdìY`~d>?7q$z]XD` waqzD,a+,֙\\\ \x撧\8eݗӺ<^\V.9mtI&ɓ ^,NZ^Ѐ3gDM ,Vy@ vwuul0N8QwlA;ǁ?el¹L9\qvdM"SW4A@
#Y, Li R>7|?~=xI>pa,pҺpɌ'ɧwKF:pђI<N\ ,\3I~=AuuV4qT0MOӫ.]`>\~W<]s L^[ZZtRß @ xspU5kPN<a 9h*x\@GhS 3E[!B ĉֈzdtʢ8D?ٜ):q(h;wndڑL.}wLlpnYvd8ZIr4*'(' KF+[<NF ,\2,xhw ǏcŊѵV=Gj@@@@@@@@E@b<hs Jq7y`A0¹Qg7D]|9MMSha\ڤH i;<t/^ Ġ]8;KMunYz]Xr `'^?wD+Њ%ˇՓ`%+*_wi9h"̞=;r@@@@@@@@@=S sq:sN Wy2r8GKKrʢ ,_e&~슁DdOS>mÇcԩQpN'=_q9iw˩`Ĺ*+ѺpOe<].\e G\> WnYnⓕ]zѺ_4+zy0Hܱc
)x x x x x x x x x xx-: 6n@
LI+^4
I#Y)e xI$<˴tԣ`^x7'
)b%i|{0*\;X֡Oxʩ([I2D J`ڢ.ʢUݕ|_f2zrp,ϋ̙/ WY+0.:$Stt+~,;H|W)# y@@@@@@@@{^+]ɧ\r(-勆ꂑ/6 7D9<ӧO>D >Wos. w.q>qyX88$''.Â/# GY~wp0&,YNZ =M.<T2m#\x]>v2d$z\]ׅ|A>]YneNLUTTDyhlsaD]C.M(W=t9nwЭ'} Lrpů\0#JSߡ; ЙCqx%] Hŧ\4q|.匬laA>^{aA>$+o앁,kO=cM"Nɥ\02m+ v +9ч Fg2Tg.'xD`|Z'Ӫ C8}<:\s[oťw:1cF:iM릶6t]@@@@@@@@{oYA׀i.7SH9iI7s7p HGz W%dL8?( rsiXh)ߥa}2L̹]ޕ &{%Ot.\A sey2Z.^AwD}z#XQifϪBEC|݀\u?3٣سmfaɂ9 a1:/vx0}{icGK#Z:{1
yM(8D[s=ڻP9srgD?k"g ~,4|)@DP,q1\lp%uee_)ӧ%LgdWy=qQ+)\#N+GL7 ^7
Tٹ{s9]y.x x x x x x x x x.D&
z1h H9AY |9
+,_ae^hR;=/d;#,u~Jp %~sf?s18a[nr]_ӌlyr W6)vz22ows F zNX;m5>/tʛ_G Щ7ct? m 9c.29A8ͦܜYjX{6g m1'7D]OU~TuqT0ī<̇u3u]x衇p>ğP~={D0H$~_M:7(=0',]\ oW<t6q7;|\f`55XOxs@ίS.PS 0bnM\# ?Rۤ?BǗʝL[h/KKypp.e2wܧwyp0[<@K/| gL?~q\we(i^CG?p˱`F r6Vw6 8QEXl1;p]hj%/E͜* uam8jypE Cg!OukW"s9NT[kp?_%f"/7gNc? ԟ+n@FV^ 9pVXl2ط 2
ʱQQFss0szM4f~
zj}. Eei>ۉVV`eδ@,g:Χ}ZՉOƟ .n.Z^<sysswE\3]$\ug͉0 s|<x}Wh˼u wA2r s 7\E 4=p88xgMyAV](I~#N^:0C\-ljj¬YI گ6}` ɀ2U[I9p s-DV'^{e+e o xg1Γo[=Ỵ#b.Ns W<AlG1g41T:ׯ3o38ՙ~|'l)uaji l:jO̡#͵{-f`֟_u,YG
v[pyO:.YRx/va2<#j ʳ{#FJfW@+/ǿ/xØ]Gw{F,,y 0v Oͭc }l6\d4|7^NɜϋEP'+_y捻ku H
hsNf ѣ8tq9N
E<s8q"L2%ĕ F[O: 9W0LRҵ,8H̹ sNYYנ^q9i0HOfS:rd']|It7&_heKFKOkĄvF{*?-9X9
qQjhFfVNYspޏ53{ ?E/3 +_{жͿ#{sp5+aJ6u@<ljev?
XvgqG>gslw . LGQ]Xs(*/dc7*y%㛏YyS*Tg z&|P^5 ]''^ǁ=۱HXUSwa6|ף" cے)܍.B_o_ ;/GHs/|/Nx] s$ZWw }u+wr89k|%{7lGx UWWGSO=r p4Fdx@@@@@@@@ `+ g& HS
%KrX׀^dŰ)le/nq } =ݢwqIGK']K+<UVQfa m {>{L-@k=^8Yȳw32lP"hƮmj4 kG\fb(ɷoaNe%Ϝp,,7V3uހ}eSEb>֏oEMGiQMخ
3>DԙX2U<? pղ9 Bo_7jkQ;)N;_TYS| 䧡$mQC}G3rҊ5=h . v AsW'{w"?s 7zKe+Sˢ܉`Vڑ+9 NI4 O|nJFK={ױs(HWn F1^ .Dܥs
e">]W_}ud~M;S|9jWȃ 8"xVrVT&dҢP rm]:&kS1 |w[PjLT,H&w2q2mW
<h~Y|Oߏ݀f.V<~ SƇ;dۻ B?>0`rԊ3kq/mmxq#]L1 eSau(n
[_Ne^| cFY!:-e3 ۺ}#h774bph=3 \ݵԏⅧ ǖCG?uLmϙ3o`=h<s Qtg E%[u YV/)@wGѫ=o,0,:6Qy"d*rΤ&h",]4ʹ_W'<ws
U q~ras̉%K`^O/a˗/~P/+ԃ p]Npۄuѥn9 ^Bx]9qٳ.30Q4stW.Y5 rь[ Vs uu<pW_نk?itd'?b>S¼ _i,l<9|=|wWQ~iite5_M2V~qeqZ˯+gG_^O ȶge?p{?u0%X` ~U7 rsc_uϲӠlYbtl~02 g`%>#N~Xj k:fPY8EfJx4Q? X9s K&d(OOH# ~gdԀA9_S6̤<HsIs;{'
p5t镌=a[TEN} &x09}4 9}Hz踁%ҥO8X3߃&rԅM8Y[2XPʭ}=+l}fcr o*><~鼸 S
P_{umZ5 3f6N# ͵weec?yWGGP9}wktT`]6}zۛpl-:=Hȵ|gهmջf6vLns=-?MXpv$i
#G?y[a DkBA %;磎}V)[A}%WehsWɎ ;bŊ]vRn\5@=-Xk_ɗnWG x{ Iΰ
UVE,
`3@CLӑ?5W< =#跕Lnϳ[#6 1b mFoaa V7Ƴt94{|h #F[ma7yzyܕ0@̳;^ۦΏj8W[3\gF ˶@?FW,p _\M&;\Y'ߠDug?1w pX4;I=g}ȶYx~d~z&unj2Z3ԇ- mDˋǕkA:r?} x7z IΪVۣm4n*!%IĤ88X*Ťg-"Â%'VL<eUNHY`L:ѲN QߙS$M V28</ *.6mDal(1o7סg S@";6ؘ NSׇO>yKFݲ;Q$ +'G:ex,x x x x x x x x x⁴A8T ԩSתsT
&W ؈S \01y%WhK+I sn+'NK'gW⍈9+H R] ߒ=SFɱbBs|&cd/sv#9&*%m>ՕKᬻIQu_ EDzhYfb wa ]~p^:|p[ m<~ {OE }+a+| ߓe st7rחGKX288uiI.-y]ZL aJYu.>Y٥cܺx'Fu:6ضΎHo[|RkmHfx81S e&lP]H&D#|(O6mZ9l[˱c݇ ɞoAS@@@ isѕ}ݠC*F Cgt(`QpU.\e0VtV/N
u_0(OO/:,hoh}x%*+?JtreWv <6Y Pų&'.-Xg0w^a(..]IezB9x x x x x x x x x xl
8'+"
?PlgruNLdW:8&#OmMiɏ-\WF Ly2hӱǗI+,˗y-FgϞhbi>sh
\ْ y Vޓ:ܦq~QuuuQ@RWWW%8@#.qa p9:ܥy/ߎ"t8$a _4R;_!
WC
@ / ~:s ]f~ sN`E ̸pt҅/6ʎA^ӺOqx_x>Luv2|xx㥇Kå4!O˺h\ 6zD_w)x x x x x x x x x x 6>k0.R
Uw8ڸW#8y.}*$#.weOYW`"Eu)-#/]> N~7MK KFn$'#7-uv&)m2x'Q._'O
9)\2S8N|O]~$ N!O*Y>=i syz qrDO:/<ݮ 6˓JqTSuߥ=qtq\+pbٗIdK|&xj+>$_
:e Ʋڪ2s%ҹ|+wHnܕ!:NuiUWN:Op E9Qm2Ļ$+Y!d "gaJ1ǻuWN Jm+CS鍳Wr^קMFGd7^ɖ~'}T:E'i&O/݊389 ?NOC/?NO/dz2lk|= * pGhb=ހ8Oڅ!x x x x x x x=_,tǕ%ds+.ҧ?Xu>w i]z W'}:r]^Kqt&+<NxדM.'I80ҹ2\ D<NN I&¹e_uV0悳LqLE|* p>< \H+Ke` #& dIph'h˜Ʌ' ~WYl!p.§9OD8:¤Wr]˂0?CC8:wuH&8ZѐO8
'Z})Kr]..N¥˲YfJ&'Mrr8K/[|^<~.:EGp7rDz+%¥ץ TgN':N q0]\:ާsePn \X8rWr0@ओ-a</ɏ/8|28>,HʤK}gA8"0a ]n9y dz#]M!,/Ԯ8 q0SJIg>.LJ?N )+~!,/X =yRy )^.N..Fɤd`NҸ I&? q;Txě*O%#26%Kծ8D2seOwiq6|މN$#dLMKEқJp ܭKdrɎ&!>N 列e&\z$hq0W&E8' D46N..F~7qq,! \"$ەRѻ|q\},OD'қ.>88DN z $'\\
ʏ^9i\ ! i]0SJ}.o2XGEkC*'.כ卓I}.O2A(m[w c@.%uܦI<qzR&jL*w'{[I/۩d;w~=_>J$+BzvO&6_毚j+uOt~l SRжo_la2n; Dmc(<p-{'0?ح{\.t
YGfS&pϘ1IW:XJweƅLFlI'Zc=Np`p̅wa*,87q:)![>L.N:}xDqi}z\,Å7SUE\YqI+>Vr\` ' up\p\_ǷCTqFWxwst< `}8ui .t>έe# _p)y6.. n;}2\Z&W|䕬d<L,Jqdz]]Y>/勣, ..`] D#Z wiX6\_wwBїߩz s^/ʤı|1 kƙ3gmqg diQͯ5+9|<38Wݹe}_%+z@>g %<qLp!Mx+3%',<>n_S.|L%+> aYt2L.." #:ʔ<EOe72]K$ v.\e4I7&.ޅ,9A`D<ܺ+«ua.x\≣0%O/t.̯dޯ4. q,qV!4.̯|I'>x<F89q/~]8L.><.du fpNA%%%ʹHx\e.Lp<X
;!;Dž$>ގup'!m.ctx'Kd{5
\6MFdh%'8\zӥ&#k2 ~1elEN/ʤMmmmBt{>yz/V&M9߱AW˧L `_ Φh0UYY\P H|qVsss, fYՃEL wEEE 18? {-c&O g ӸυJN*/GtyҥTddMbL%gtOn"Ã}NI]qq9\zīW_\QpǹtēLv2<Ș ǯbγߥ: A?VZZ;
fūL8S ~ CB=x x x x~ۤ>z` {g {Н#3&qVWLN0s )x pa6/ %KOT׆/[דg]3IxΗ'OƎ8ttCۥz2dp1'_:.
dur? u8R4>_w8ʙ&]ӳms]w݉VNµК<nEaL68uHt_AY-p?fk)_Cp@1nI^"'%%Jm'AJHÜtqđ'ٳI Wps5ąOtwwGKE={?r"fߩ ]DX$,0z{a<;3{)#d19+ wq+e3_g. t 2qK\ QTs.+Oe8A\SUvc.n>D<gmI:Sre0_EuIW|.=a _E<n.~ĥҫ_reLT^ֵT:IKAYs
aC8h# Q9J9(j uqe0.Z /xWW(d6i,cO M$KrI˼.],\8]t/. c(7|O5vv:
v:1/Ht4z_
XD@mPjԭQ)?
:et~-r
O2o 3gN!8&N#T miixNIUM x"8O:&TUUE0ǭ|!I6H\_&^/]&Kn ?ڵw.D9_Io/߯oymu{: 3Mt$otfHUwHreM 9'1bPd[y]S {ړ|R]*33!w9X;D#|J &N4 3q\oo_8Ф`~?9 <uT*ŋ >,d)3+"_
.>!~qHu'ר{^naJ'~7uan|<vr'*rI svrӧQ]] M &>,±N)DDm" }1uT̝;7O&]l<u |&=N6
eeeQ g (:t߮ȞQ;6 :/.OF62NkƼ0Xg[n}뗯b\rYW7Np~]p7
s넻0y>@K/jw N4~Ӳщ#G };.بdJ N<zwva%Xd+s϶)6@ Ҭo 4`1JtBW\+V$
u)'3K+e^$Ǐ 㐎yՉ rFB箭 lQcX~Thg,5%,W#8җ|sv3P{Ny0BЎDi1$"Rʏ|=v
~O)=xM>9Y (;2urFً!{h_?Fз{vF
7 gabwW Օ鍃r8ػw/|9̠˗G<''9I"O:|tˑ(]@79*O&=y 544_L|łc0q|tI?q<H]/1~_ @,\T&M #~^ \јѥ+}\
且vP?dzE'<Ǽ\9mʦ 2p[fM4A\* /+wD}\K.:?*KhTW|<l?<LI\Q]9mgHҗn[_HKN3fD4d:%ågXd"=]d
ޛu2z
: `'sk[ ,P7$2"ڹJ
ȗl5ĉ435qdAH[|Z#y]\Dh\;ŋyfΜݣxm眶Pl/x ݴT0 Չ\[%Ők "Ϭz}AC5:* WwХ\@*9ͺh\ Spuh` ;v,P|nN `!=gw :]Iۨ7^{
ĕW^ܓ_pu+G}z*M#¤9s +z)`..sr<YƬȰc|UZ]ıq{H9 `[Xrrl {S;W>)=3D?v[̡z\~<㳀 (?\9b+6l-Nt $0*+'gN{!ZC6yAd`;aGxVE+g`tf5<E7 V>z_=*v 0Nd~a(B8~h2K/v!p5矏7$"1oɄσoa8oƴ< . #-s8 ?]" bA^_W9i0&j0q2x䘎cHN411!?oN
OEc\åxA ǎ\? G^pqo ' q:}yIC 2F%*+'2u;wF [ܵ{&+m,KVNV0Is{y0e D[8F uҰDZ/ō=XwmIO%[Oh+zbO8yCۨ΅UVNrn{ݲQg{8
9Oۼnd
swD!G7!LӿIQx 9x ;<8.'X7:>ٿXySSkN '8u˒6p(4<nx %H# ]/{[Nvf$}=#-SeE e0T t)a446.
/TYpư3S6֫R>y(Gx?p .\r466b$ u}Ee΄L^n Ã8v(rK*0ju2^ nGۘ 63l:a ?kVUV gcYw yم:22&vPeC轁n446مJ fPlkFK['
K0mjYt>賋C63f r7&s uM),ʩO5u^T=n3<S\&4y- ybHwZx֯c<ʐopޤ
C;eJNa< yV_$/g1z$۠_Qߦ>3fifc괩@ʹ
e`fU>/0 9cܷj|! ?S|yV{dۦʦbjYI#q6tQϸ4:'kS4ӭ4dڴa&-%V-ј.zW`{z0"{ 1qۯN 8E}m Y<gQ7n?tiɍZ>vҢvc8+m)- { ?p"E0%k6m\9:?.m+kl gQ @é+߅ C/["tK)H6́7~Q@#q , }h+|G>Pt]xwgZ9[P^#3>
ֆD R?I\S
52ԏ3
((@ٖ"<p|p3%,s51[L 㞃 ϱWRz%$ q 뛁
5/y$ ?DϾ℧,(wxҲ̃:(
Y Ǖӫ.]:۷okF ySQ 8ēLҡ:d0瘞 9וr `%9v_fN3` |?0 creHW\;la?fѤ ye ukzi.,}V:p=a?l;<F? Ff 7sM6Q0UEu_WW20.z*`uwhM'G.O2sɈEYfxhJlέ]\Eec;xOVS9aW"[c{IGͷb̄},Gwh(t";`EKS/4x1Q:,y?N'usl$OyTLt.oܖNG[)wߡ榏 d K ۨ7q1 >Gog5>מjmܴGmdxJ ;i1ضѧfh;'|
mј ܸexs+ g`xhm] x?zeحrf$xIY Z G}F=G-@;U< @ IDAT~~x?f|¬q^L;AIN}2gLLXxZIJgһ<º0N~LvS8Yo
ş=]OD@㖍8w;^>;MRĨ/Iw\kIо-x9 ;\1{zchO=6a7`?SeAӟ`ƪMd۞A [;P5: Μ>ʨ' mNX3xWp Ǵ!͘j#ηKEY 2"sqc9&8_? U_5~ȸ6K-'Ju9;!D ;Q}
/| ь#<o}[رc xLO#);ύݓgο ٬Bh N~ [J[f50d4VI>]D4n[ESlgs= 9\c B'Y ]# ؆{9p 9
7(&e8& g{u
vG~nPsUß䁸>N?+r̜Q/Vq+8HI7M
s,99cU"-mᘎ+ Mzϥqs *^ \⸐cIҰ < 珫]9,3%ܶ.,KJn$s~8#BCuʎIrVg N,T:\.gA %ḟKC><^27ۨW^#k˖-
99IT5k֬蜸1D:vsv Y\` 4XA P\&百QFtVb_oٷO^+l g%]>rsa<& , ұ,lT G'ih3{À$.N0^3I.
ˢ㓱ɷR>ľ~>G t8>L,ӟ"TN/ TP8O" C3Y ,Iyry^z@y NF; -|'IJ^\k<
,G삫ðU. `^Cv1V!gƾv>ӄ)娪|k |~DhC3Ph>{ꑕ_gWC:Pk (*+zWo}|PT`~"g4\1zvU,lgƏvX<.Z}u~ S2?+lݼ/>ꇦ3_Zƃ?|S+nlt5dC;TDqv>Ғiwil Vkʶ q,0jNG7_%2~*jb G+uSQ MЖ|ۊӐk36 &[̦)< kGɠ ɊAQ6uG` -l0g49- {fmwDwcf73` ]`(&yQmʱvkabk%p?`֮v⥝qݟ´N|߿sg!Vx /ۮ>"3As ֧[;rkga~{VصeflʹO:Z;`3Lb8YDZj[{i8Xʲ.d#|8AÕ "yD vt D%7;o{
_ڇ; T W+W/m9 E}ԮJlB~c]-Go堷>q
3{F2liI0lT`>WmQ ˶-ك0:ܡc#+=rqQ AkzNryiwwvت~n]1 ڽg۹xor~Wv ІnXD Y(+bw&̇w(87Fugʼy6l %}n~y l%1 =rpD鹋l?YU~Fk{-f TbL jwY?uu:N9?x$1[$ q3s|&cشys azlt^tM wdsͭ6VRc=v-v_0lżܞ@y?ktMy? Yp qE
y=1ͳk4 4tqlŠ.k2M<d3wijΠK{쉂%3:%fNL#(.]ql *=al/m_n]4.$ _1#:œʖH']~[qh \rmc^~At+ _L8E'@rl%DA ' Iqd+uKnXn [x^i`[>/nwaMsQEOz SY1
ii}Mt՛Xkq,@1P sQߗg`L\>ޝgcD,骍dqO/BO|pg
q6$`jKDz g}Vu}OM9nr,p}uD&˲dhD;Z/qANLrE0i+q=7}yPt] $r:7~~V@*ag
C3[UW])lW i dS6n`Ďm/L=$ֆ\t ^>L _چ|_oAT.ހ.|~pr <l˟
m%o K6=}8emk>~ h3bFvCjc^e>`vbf )^5sF4Jpm5akun9Ѭuyirϴ 4:mhC7n(/.D+8xp56DT[~x<i𥶢ԆW]-G۠AF/>TEBN څ6H{}anYV?A}/gu]š[˻,ɏ7ފKcOcgsp7$~*+6b:rn?'6?lw|ʊ`!۱jtq}#6]]#Pb>hFVIm?&_ ;Z
7_wzV'ЛY pkqqQ^gZW.ç?TY?қcAM\ٍЮ^Ol72ZvWU`3N[yr ZoQ5j^>w67vavfrpH<-,C7LFq]susbn+Tc߫ kd6>,c3k0ͨAP&g͈Sq @ea? 71kMn *57{W6.jM9Y07٤[6kKn8mi}/DMD4ۃEh<~ 'ZlƂ\Ѿ4ق1g")76qo|Gjj\{<s܅ xj[,(+ۯf } ħ1<㘳r n*t7 7n3X8[)Vb%ojdzoMl2&6>Ol>)TdG=֧{WE[}ܮ:<fd@zp^g@EIntۺ`<l6-vؽ&n,]8/{$M\&^tM>>|_3 ,ľ a])*} %?k.{:F^ =%n_
+</avhلR'elKF떃a>ș 3QR>HgD7XYcܥkW" <7k[ypMע!<g0c ڍÚ%xG,YkVǮ->|b3 Kv2W
?Yqۄ^=n% ߏT
~o7u\6U"Vξs'~N݄Qh\eα!n ) SL!?>}zr9>- h5KNpN;t
ߗ+̓Dyc9xuk#$G$ AZS.'@8f`E snyU%W~&_Q) N08yOG/Ciu2XfbYqU Rtl';o[ 0b V\0oT#.Lek%\[M~OMppKB\Md kڪTk-)^n1bS&mWۨ|<Dr|}7+?:LJF/8uZkb)\2=a9d|ma3m! 9 }wOm, +o;
fRNBWL&4ttZ\\ G8gx &f#烅KrStYyȳ͏~x o0, YXZ܍U6[2ڌ } 'maxmd<ugQ{
W@?Ƕ|{n֯} ^>t :Zp{k?YF+/me F;jёU[j[K,/طfUG,Wڪu֥xpΠ4[F[w-h [.Ai|%>Kqi
XZNaʛppb<ē]nLs n=$nێk.[[aelU~blyxy.] 'r]k
e>L 槞ĵ+k'gn =p?%xǫfaAɐ=<ZqoǥF].vj7n <Z;?9,[@rFc Uarpm0#_8p|)
m5ЩV|azn |{{R,jKgMS ȫX
^}YqχoA뉽.^ދ?I̯<-l^i-hwؖy֎SCCάKp%qbs8؊)S? y~ ܴ;_݆[if=ldcpxZp[8m'FtnYPaK۰ĞMwMQ|# ]z ʲzg_7|?}< ~K
%o 7 vv5b1e<~Uv(hWa]}h;ĵVJ]SpM /^`hm V]b Ӗⅳ{C85_1r cN,,/mAɌyt} _ u2 V/Ƀu-:s ùXd]~j48<4r'^rڂ9KLI6+6f Gĺ%WE;SQ
vO#O3fELͳ@qj˰{x V̫CwwgdıS_D]m-# ֧~d[`u+P{h/roĭ_b:EA0vO\zpKr0# ]w]4|+?Q| hx)apSlr-;oWYaXV {P`mpՄ-zcz̑8e\Im.01@=398`Or=fـc
ֿaɚ;ZeEvof=|r\[ [_AM
h?ʅkx pW1>k A `zm/*'6VT^n
;>KfZbUµ1n[ Wd L xim L r7vuk+{8Ѳ/k+>\OC=\Lkuɉ9~Ըѕ>ѳm 2 ql0^+j w#prķ]rݜM\=9qs80x$|}ّOtN\Te}cޫ 9]Nl#mpTpe 8!+Λ7/VSIK\R _=>̓uq'YC'0jtX036,I.xVڎl^5 ꦝڮO.@uק~٭G+` y_#oH 5j eT|e%ʚ(&^9xTMص{2x :skMy<:zi[er\xsg L3.29g R9u: ÃtiB^0ԓnb47Xw g*c R[f+ ]jm@c<f 4|my=ڊX| b+x{0: }
;v^1淾56M=B.It-f. u!_Vb{přŶ+VPQhGpglulLZ{ eڗ_f), 'vQۺk UvTKYո eW\eAa o m'vZj9k#Ͱ<Eѵ=0m y 4*{w~ˢ+'C(GOlNƻF\Fm?sMTsݼlsݼڪ+# O'貙ڻl,IJVC|8o*M mr_G7xq
:mmQZ^yոA ,_:߶wW5;1dhmh<ap&LSm%[O*ޑ3 u' @Qs kɶgf韊 ?=ҍW^u+ Fr
{O5ҕ豭P6̼b[ hunGpPgrkÀ},n4:ێj=NJlb%XnR2v >vkpe7?^}u8mO 9| GvoǢWSڛeKpXx26#GOlori.Y^HvdD+Z`@J`ܗ389SlmõAQf?[4
7߈SgjlZk }+g2 -GIEItew $d9'ږCG7u /`BSm3/ߩ 9ή!m; !˪~.i[E< |w jmEb6VW,žم챀ݶnd$]ׯ5^ʬ Gl<5㸽g] tޥc%͵A[\vlv:k7%(]] noksJu}8x$Kq 2c pk,^SNݤ^AI/ewQfgbvOcU`2 }dS]=3& W49 >)|r`g. pZWgVPދ
THc|i$?͘IL/F[,`Cҥ#.e?;{efΝ3yW&Q^hϘzݓd;چUKeO^u^FcAQ 8i@9PFVcUJJ١٥94蒄52$ G0O /}1MN~-^ ]b
S5#yN[ЏnŸj7 .4e~˱p~q噫: ౿reI 3) pn@fQ sRNy4m*4-lC8kMit5u `A:0ʋilϨɉ N;SC]X7 ?:R :) PN\&6
㐎~R.q`<QjUyʏi"/ݜB(G egUMC?0=1.Q>4 ,JiӴ%Ci , '<# Q&ø6?+lko_%} I{LjV.I/7qv5b [d8QvM_몸P'M<ۦxaØ/Ĕm
٦hy i )? +OF}9-,+hm|f\jl\ڬ I,3R: %RGc Oc>tC75geg
.ΰq;;iIZQ7mM;l*Ogg)ّasV.Τ(h '|hεrU
φ$`*!՟MRdTȪȃ*E.p4WwJjppH
.`XӰ^MQ9&;b|_l}wȗGt JxⷶtVB}e N @ %YxeO_,y2r@yGJ g LOft9g.<H!̒Hl7 Lζ zLۍ*9ކ}Ybc0KJN&ЬXQm?(N9:]L>¥qYyS]J2@d ,y M90al7l]V^V?QΜvcfj&ckI0zDnBí+oC65a*/@@KSLމkWFI+wB^ؙJdz0 9й]b,]AFO8 [f%y;hۂ5 \T2,Y]p 0MKl 7ַ_ٲ0+H641)I(
خ_cTb&lOHm u3zg
9i 2Iy[~Nʰ;"1otP^6jDSΒ&ϓ dg X( =qyM{kHHq$zY
r0݂l:sEJ|隟tv^Cӄ8B{C f0d5ro}5MYR?CSg$gH^6Y GK<4<Ӛ,X<[,w2Bܯ 2~!@(ϔ²Z<l4eʥ$-3O>lYl)vKKp̿|^>UɆ,?b4,::C#N,ոoפ"4ؕZc2l)zSvtFiQ #_g (L2E^{5>{$h^qGZWwx$ |`3 4hNZY8 i`8IGIV!="SeزOmMmʹџ3fxvFvt8,N2\y}Rv ߄O'yYIҰ;Vٺט#^qf9U(:Nrrtb3&<1Zof<A]h<ݿ m)O ,0 nܰ e߉e餓N2
ʦrعe749aR ;n
" ,K rp1wPpU.;tS>A9an!F 2{8ceߕ#ĞntuesMz{?ϳĀi^4 R&MPNmĄ}zdh v 2oIwď8Xj f@|Ni<U :Ċy˝\L,9[ԇtć(g.r'W,ⶉ4{wJ.Nl<( V_'pM2jls}Z50S
eL3cJk-QL,DfNn7ŎiҴk 5mƸ (o[X6O>+X:ST0B |Cm -Ʊ9u՜lfcopgKMm˻?ꕨU0Ka<L:f$$Ұr;G ؙ͟fm$0 5 L6V/k(b^tܴͬۑWɝ?}4V)j \\nٗɂKa#e C|Qn:.5rϭ
_Bۖ3{
?UrʝzLN;PꮑsοT.9oRs .ZaplYsqUVGr:;7`Hmش͜cg՚
x!mzq9fһINF*Vc\#5
`8]p.8<%j[. *'ْ2ڌ[;֙8X]'EyYuW{ 7ry-Rb>=ps .(c'- jWoݿA^_dUYӯakra i,zYһgWٹ )j6;&X 8G<nt'D"Hgl{Wy2|pOGg%3um^Cz%;l<>d,ضct&E8v35K<Zue~aw6\DݶI`zSq/ /TS s^%6ɡ̛
i"г%_d`%?;@ljl# &SJ\Aؾ=|c 8 3^TiHO5XXَ8Z˛ȏTuGpbEql} Onmq!ܫ[>stGۀ DԱ=GL:LzrQALx6ņ@ &pb2:VB:~]vXŶ
+?KI?L4upZ/B얤<.NM%[o];~SlSo4ETy/oHҡRYd X%_>wԡ7+ sޖ>I#.X܄O;r~af'"&6T;vI 圗_=d +sd8s_& "Lh{0IJ[KLd @D
'[jQ9pjލ#o⾅JY-ٶWW"0܊~V~ ڹ~qfӰ0|PQ$7n*6Rj`=sTeGŖ |rov
r2ڌLŀ> ' 095GmXi;gj+oĉrӰ<w\39ζؐ}>Iѿ{h@ sE_M~ LWݺ`7nF'|hHo܁Q QeD_swLyW!ܭ\#AU < Phئqug.v9L8Dv,3 <42,SQm>Sp"L+u>ڼ9hS_}GHqhٲefs}F-A)}NA|ɋ顡M?88<!_5 Wʇ6{X^gkfzXN8 f PpP~9's8e <[Gܨ m:r@)prlYFe<l< \z峯BX& 9hL Lwy3D?/an¤@Ę$fA\Tb1xǶԗ mǺf/gM ضxN&1ϟo&$9) ' s >[=@NPcRYfw (7aq32_:ůBn6K,n7|fg fكtK|f#KZ/hl^TLiԟ6+ ;nF_ll4 MwBBtCY>qrw?YRe7SΖ*ߟ;XIiκX.f̔ .O1c479@N8C;{ZnM؎]'2eI8(<;yR6ɳ dð߁3$Wqvr<yzȞ)$fcOVtx.yc aET'I |"O.ι>/=xRROMܝeiR VY!;kƥ2g,}w7+
}
.ۇϧ=Vٓc3|2gbytx]f@' Brp3'_:]zƭ9@ 4)m]{ӧʬߐmk{&N(C{ۭ {|0PFLpCq^ڝдtA?Λ})t_T#:[#F.`øTc2%# uVjt|+#N!/3>g|s6VϕE. ~
=Ǟ$瞶GzRc9G
N8c`KV.~S
K ͠);f̉MZ= w2qΥ y}9Rr ߖ~LH#q#5.( M>C^3SV-@<f\0V Tvw!T95Yz`e*yrtrd3_w\XZ,sJVF4˷`u,YV?[OiJn=eSd MNa/aw732U.~6&#=\\{yrwSwI&YO JN<clyf,n<x!EYp6c 6JzwQpBwӆ7X 74z ҇(z$cG5#?qqJFyyr'v Ǹ*Գ')I$n*ǟ%嬳k3\[3s36 `rHdESJ12'P&E^jҍfy nj}]w%7p̚5ˬP|_LV[Di8AԿ4o.otבmuk(
|f]]?5q&}<$agؑ ?ӄ4+ beO47oyq'"2>5Q"W\2wF<ϭ/b |B:3z Y,pKj<{<o$SPyhL<C<th_e` /kPv壍M3G XG%匝VUo6E ,7_=.OyVy |fQvDi7'W
;M St3 xQwN7iyn9Ȥa?:p|V2Տh8Q」R'b˴9iUʓ`M0VԟlP j3NX<S: M<Y&ċW7,?gqF[ĜƟV 4>m-' |G3O3ZhgU~At2L'so- `9& L;ϭ ̳0.M,״OL<Lp
;; 35L``7 VQ1
8ʵeT:ۦėFПeeq_'
ʥMJpƳR =J|fY[X4j#UplaGa<Y7wi G<6mzˤ^fU m2bVPiԏZpFyԩfK ((6ӟHpߦ "q{ @7ֳ! Op
ft
TMu
GI ̨0 VQ$WeP@{ 7+&'`0 _
?!%F?e`5|gM KJp)/4au UTx0Υ3*¸1d7l>uwH?9F? cpV'Ktv_s {Rz<[N=iхpu%bE6;+#"2+qF耊kfMH3t7Y00-A:6ce* >[ŕNO<c0Øk>KyRS|bB6/VYy⧲ s'\xJ Q''&Kؔv~kq3r,5D?If>) [ dpiƠM1sɃ J|F pbY 0m.wJOhp0+93|L-q`0㝔 e`ڕG4|?qO ` i%~1 +,S&_ 19XevFDTs2s"uFj1@Ī>Ӊu 3i]~ tr0>l+>r,8sCe;lqq0\Wy,dYU&eU " ?d0O
. A&
¹ˡPxhi >lLC]?z2h:>ӂ(2VUKiY f
hSa!O3mXONd.l\Dڔ45g*02iBX*&#Ҵ vN3 A9F,YbfNÁ';li6WW|=Ҍ2{9ҩO/gVqF3b}@JĤPɒ($~% ÏiЎ/uׯiF0}8{6v xW|1~5>Y@
M :|Gv29R7*M;土lD32
0"wnP' K5!r- |oZ'逴-Z[z)&m'b?۷ٿ3 m,+zp+9Wm"چ|X'9YUY.W:)gM;L3y\|k:*WɃ|ixng_ε#<{8`dQ;waMn.1oK:)6Xd)j.%*OE']8d4}g:N
G'W~|l9'Hƶ#xeHo+ Rb)>SXg.}\(M'NPNDtq&\nhi 8dk `zueyad <c )
y0$
e%RXƍ /甘q&`߆mرqo2e2 #GvVzǎgf8AaCNp5ˌ^%,$`bggܰ`V6?-p-~,Rg$!K,V :ajƬ`ӯEa)~;h=h9-d#xb{vQȀg' iTanE
eA8 OHA+1a|y=J" &/5ϭY0 flxs?k0iȃiC?.I6\ͤYf/0гL S6Bedzs$2;6 sN ?sq}2 ߎE=1Q0ClS0ff>Eg"@?$ de* D0f|FM6LW ceEgaH 8i/}8AВnɗ ǝrQ!7c8ch 0I ӗj3 x!KDP""& iOt@-}i$ n 4ˁS
>~9hg0zAK33-4S7Qⱬ* z!]AQޭe\<L
(\&vg}gG349)VuZ=Cl L<I,k%?Vن]JÝ!͒:d$mV1y6K6^ Ky9~` @ IDATqDdG=hWxFQZc>ˮHx/c$0!leNS'?? S)ieyׯ3џ>rBvVo#F>j|ЏE
Gc6./RdUKm
<#|O<cɥ? ]8+R7M{EyC'F(9Ȣa^0L'3#GYKyx@ 4l,`;6ۨ ] e?wr }ig8 X>Nb@O,Gŀw3Ucϐ7^
\H>:|i0>1w
A H3I?{LG 4.am Gn um\<6/56a A,|LKpq黳M'.JKj;2vwvf`4&Duèn@ZEAX9JCaʄ3zʠqHoQ/CLuۼ(+3 !GyPC okl5G9M9~ϤK0+/ǖ4'Rьl;}|80MOu_@o͌ i ȎX ; ֳG`F [0 6&CiO݆Wch~]YyLÞ[3gxZ ne{{
3{uNdUBk>Bh8mpPkJJمSVN^Q;}<-yn_Q{)[yMgw KF,;=ҟ/U _tܖZv ό17҄wDV=1r wSo<MOmy VFF='nCba FkG 0M\
ZDE\RnUpv`Gv}%/ yH7Y8` <2HC?L8e?O{*Smr0ϕJմnџT +ՙl>|V k ЙVc?a8v:mkXgVi3O&WyڶJMK0d\;Ly
N='FOyǒI c/wx Bƣq=py2՟_L/pwAkO }RF5"l
:QuR9C ωNl3: 渎wӵPܙÕ``%?ҷU0;mX & MўVbŷӤ4Gw)vUo*:wa&E0-)؉;6m2I \hzpMYP(S@$W dEK6_Z!V~߶nVM:>S6yә>s ˗gw8uDun-'</a춱QNv/n.L0>)yj5.|l|y Cfn-/lM>,FXi Cmv.1=ڏ@zLc
0\YD3c|1/n{y+ E4m?4>_Lnb[NvucÎ6_`~,'&9L);A@}~dGn٩Tat6 9, IxE?,Ҫ h=wMo?#}֕2\,k h0X 0 yX:WO{gSLPP}p!o,( }_Ҩ?mhM1&ʉ ִhnS?>tL#1 /-;,g,G ri8́9M6bJ<8)ÅTǟҷ. ݑ-#)fmYT3q z9qIFF/ dܭva7'Ithbf*MF ز#FHҶp*p3C!8RxGؙ;/jt:8PgG)j8`ď!1_H p 3xJV/r
!_{< \T *=Jמ SPV{<>,_ }DO;WۭWi~ڔ ~ ń1T֚p
SZ6&*tNĚTG>Zin3#Ъ 7&\D:K9 Tnfgx6`ϟґ~6[&zNzM~<}?d8C!"w
Q|p2/@ jEE<a /(Cݴ *W'6XYtq`.V&dZHßm4Lm;,4je^Fm>s(Oi_5\6=ynUno[a6qk f oѿ-qb(/SMVMg?k gЭϦi5̦ӑv<iOi{5[.vn][5Vm EP_ #ǒIZҨWm;,Vmdʱi4v>kX,ۦ ʥ[ Y8^ P0VA:#F ~#1qg
s"|SX2C!p |7Ix {o_AmU&(?d 6z<#`o-3v;x-Oy}$&;hˎhtUm<{G2Unƣ~*j; 3 |l`;ȃq;]eoG[e_à?DݖxA t$E#|Qp< = s[;
WƳ1n-6o;~V> kߖ_㨛a4c?a Kf, Kf c84 p?Ɩkjߦ%Wm k҇ѩ
Qm+OU;,#WiV0Ii _,'̯-> :ؼmz>kϟ:yq`)g˴yVmFW_0_4->?̏6Ou+ 0-^6a>ClZ>^lw
֏~A^Jg)o;Ƴ Ƨ=S @
Kvq?Jt kЃ/&T4rVwVguMHt`Εrй#Mp@<CsLU.6x/v#7 MQx° ƥhՉ0a~A=h"-4Lu0OVۢSzcŋ/r_=]/]{4#iH:zGǎoS #U[Ҵ_iVZuL_&hEa6/mzIg[mMXѦQAw(]͏aʋJ4 ڢ8Aێ0g_0z{Pxz)it< ndo٦-Zh 0C Oh2- tnS?mix, ڣWJG ngn~f+
9 ׁ:PET2UygxO #V?4vmO:;</nw}|l7:ӭAkOk+Li)/
S տ#` <
Sx0>a~KTGڤk&GVXPn[nC|V[ĒWz-asw[aWQo
\mvjɴC[Â -0>a~6}{2-;LXrci|ԭ4v0_iՎ%S-Jʰcl oҵqHg
ʤom[ 8Av\gG|TnP ~
ӧ2i
{i m{;:"#H^ZI~m{r?*2#*7 ǣUl><ű%8˴ ߦ9h4f X4ʐg?C!p8 C!p8l8nϽ2vҳŝ " :V7mۏ#Ciq:Bk G
<(Ӗ 0Z_,l>iOnݶL
miO Wirm_{n3Wil; mg54v<>+O˭Զy*MmcV>W=& ZƎgrb56`\ ata|OyCkhܠOmg0n
l?}&=aiڂnQð ԏa~6armi4n[r4A^ŢiFig{n?VeMC7*]&:1Dy9/ ?ea<56OeMol h\V:ߎ Oi4<ȋnGk%Hr JG6ȏJNÃ覱yƢiX˵ibѸ J{,:۶/V蔗 +#Wio{n[2m*[y*-mzUXtaӦ峆ټ5ڋ6ȟVyf y6-V^ўPF *Ew,t5v2#c{<2U MX\iL
ҷ#(<ڋCmH I6BZG{ i
@cXa!H pp J0qxQ>aq0 LƵyvDj+͛a Է=0$ 鯲l;LgwX\Kw0и/Vav,0Aa2:&mq5^ByS,dS&>\Kf x8)!"WLg5
A;,nqL y4 3 o#q;*3{<2ɣ8uɥVOڊSG= G uO{DGGU_rqx ո VЕC!p8 C! s:X e +E C!p8 C!p"_;~ȏĻ; C!p8 CXA
Џpz8 C!p8 q p8 C!p8
n~!p8 C!p8k ~xC!p8 C!8Vpc%' C!p8 C!p\#u; C!p8 +9p8 C!p8 7@?%!p8 C!p8 X C!p8 C!p q.C!p8 C!p JN8= C!p8 CF
Џww8 C!p8 c7@?Vrp8 C!p8 5n~\gKC!p8 C!p +NC!p8 C!8p:] C!p8 CXA cEC!p8 C!p8[SSSĻ; C!p8 CXA Xp8 C!p8 䂂6.C!p8 C!8VHtwX
C!p8 C!p [۬w w8 C!p8 c wNC!p8 C!8nHNHH8np8 C!p8 cX C!p8 C!p q.C!p8 C!p JN8= C!p8 CF
Џww8 C!p8 c7@?Vrp8 C!p8 5n~\gKC!^<Os!p8 C!^H;)?Jg \w4}a<Z#:7G[~az2 v$x I: l*vy =; C!o!mؽK %ztY>O7I
IoG|LLdX[# J&؉LGG@]5ѼZnQ^)g 0bj~^m+ⶩ{7 G,i6 |;p8 Gvma }h`UTJbb477IJZgɖx:@mt!~[,Bjj _Oj:ӒN9<-~Xx_kQv ;VKEe E}KTΒ I [;^շV+*[V1ɕ87Qu\F**ИV3d͕$CSSTKC3&VYْ) r8 C!/mtYolٹt|k/1E/Yobm:CGt͗ iWLRY5i7\'Y)\W:;ߦ-rY[vD%-dddJAA&cli,>q&L&K^+_/^'iС.~ގpJټyT{|oFYijwtBD|ۈ5Nrٴe6H4NssqI9\#y|YO5J}Cu-es^/O|N; Mu.^OɺF LRz߯dԐl6u;`&Q]._L)8M+6H[<ñ|ɨIgD}k {ȟ&L aϟKJJB3q,kb9 Cࣄ@:
\i`ݕsd},Y :w : fič& ng3fD!`$rr3;MxHL^cϚ"\|\zrҠ^(M+Ho
_2\JTEb<B%?]#ihSAY\!=X]~Q @&/%ٔlUӧ 7_S]s[.}?RcڎǑi1Vň-X I]O X5sIw[GY;mމTD9UҢ<:(^_)ˣM xTx!o}ۦzyq;Xo<YM25l|Nwm(Ô c4^}[ng -{%;Ƀ=-Mɘ rWH9<C!p8 '}߾ɍG4qD>/tP?¼PsS4aieF 3mC9-<p_BRz☡Lt5QR*:O0:W
K;_ eydŦ=QZMulHz~XXSrms#OVy|h#TƧ'[aKJgV-uPCx VzFŅ 秧0iAG;q߹Qټ<JF (3 3zw!8MeVͬrt?MKV`(w'ҘQֹ2Ӹ藧 vxJQ|} o;gH Ks|+_'= T01 q;;|
օOf2I:$o1ʟ2mj/k'ߤ1RlVqc7,Ir# . ӒYt.kN ļI; eGg6䟕t(@j|ɷu,%_"r}Dijdhs8 CC@t+YVplQ(
{0H ];]Gv<x> 04> WA.;.|NtF:!ts5*Sӱ-Q[nt#""m ®HQ"ٺy ;y WN'wo7Zi ,^<2~pǂЛ =;4 26i.v 7|ى(/Ɵ[T<Ԉ ѵ3n<Db# J)s!1RU-{)Cs{H:N>$>$s|N\q.~~[qoÓ%^t/-M;d?<(^*Sr@ 'bڢ[icaWnI:bczHە-9I)c Q-Ƴdv
ݭ Yzzߕ1zKUQS#cl|9<cCJǡ`4[u?4viZͣ_AZbN *gЏy3 ;P#Znomǡj?͍ $&~jC^l@PG?&J҅'IVIN92ng; C!DuN2=T5T i8dGM *CUknWR*^.x.1֣Hzt ^v4YjnjC55RUU%eeR^U-M0ltJ]%-ŗ)Sښ*پm?PnV0t vC1bfp/F BIݡjyk,g.[6m{{ @Q̩A\zT.pU :H+%T9]LZp;L_ivLJ˥9@69][n%'3_; D>p{(MuDg1]͒/ N܍ |/;ٍdo~9 q;Jn]%;錛$Dxrw=go1&# $ts W^~ͣEJYo>ɘhE:iUWIp
]r%L[30$:)ۿGҊz\srIN4V2<$)]k5#;۾ȆzjD9(E9Aƴ'₯. terR嚃Ue *aJZΈƺٶu6 :gʠKf'_qScTWre 8 QQW('w*deHaaWF$q!1W'
#;vjz_]zu
u
~y}z <L`EٽK (/S&&:$& cvf!ilgl`;AW=A [rCǍ&J&R:gK|)wveYڵXnNdt л{M|FKLT,edInvfF8'̀<&ݻHʠ?ѕ$h{z)yX6e4 Qن t<PZzOʫe0tG&TS]6Ԕ&M :T>V=3a2\aS' JAMEݺ/(ҭgo} jҲ/O%yh=d$t°ebWA';]4IftdCԠMS\"x."x+.IrP
0B{KzC!p|X=@g!hcꀉvpy<eM>iL:C.b\Ztܸ-]nwKM2Vq%@Λz~r%E *v'］P yyd.P%FbԖm1<kkm v;$ ҳ[aUQ|GIFNwJbjJt+/=!R%_\Ȉ䔱eE˴gJnf:)*~ڹLh7_xB_Rל(Tyqe9?jy<,wRثH? θF=u}l۔#|30J5ʚŗ^ Yw9Sec.s /f%/7g~F^3Ofjx](]x|Y2 m??$}z˾eꕟO]u[d1rzdp\51̏Tv㿕VzO o5߅diVG.kM9f9&tn^iJ_@^<j<8vErs _PgʢWoҥO_@iٗʅFWYqCCe~ErwȎzyw"Yi_4 ǝ";O.</ǀۯ0<72G ?irޤīۋ%slܶ[֭ry
nF\nsg3ΒoΗooÙS.B9Rb5>Tz,O.)@~rҫK3撷eo\>{$ Z
GVo˯~,\\bpKO-xj:
]/Ef ۀ䩧_Go)0QeWɴ%3pC;J5e?,[+鍲"Kn7ePtyy3ƢnJk?ѢϽMvȋ=#|A yLk.!&J45ʼnl(~I^7O.'6|8;fL2].|)J]oC6UvDЩ rʩ2q2wWiO⭟V`ԣ^oysyoȟ屮#B\} Gjzu`Vy eY/ϽĐI>@1].2> E( F,ݽU4eyeWI=DN{;DeԀ,_3/-|LtEpAo 9RYV,o?Y3oT9p8 cf Շ8$odoٺ& gB㣣7T{3 +,~ 2{uZgsboetÎHF,f罓]u=_~~ףW /*8raMaο=*-2܄
mypW
Gn ' !sh`c'y"i MqOy56_403KW秏i
FYsC7?G㴕˿#@A͗I+O(Z< ~J)Wy?V~2Jo_ߦH}=<X}B?էy싷ze$ oа~Q]=~(?oG{M
{k |^E#O{aG";=+7x)7:h]1xm/2#PS Q 4ٷ=iV{mQ>|}Q xǛ }irS!h#.j㺥/F 㘓3>m-45e{o ?U_ϼ{L<mOn
_\J7w(еO۾n7sk6/{[W 7~'oOY^h[zkZY0^;[mQrɸg]{)RN#z[<Ĵu۴ӯPGұEwYg٭kQFnHh]ߵDiZrx~Ui |g'fze;G{a%eEیgxv,i C!p8 JbHDWY.V -/3g\-W8Ww=[+ dD=y sһ?{A/UWgӳߒ',]Sŏ] CIɈ| n7g
Ukd@vo(>͖H~n 5˱+ ؊]UQ"f?#xedˆ-['^xYA5~4FMQRԵly{[KSO /oa%J'a4Q VCsWDfmZ"$ 7}7riM 0[:jd'5eXz;U VtZ"=~&o}2|XldL@'2f8Ydp-P+Z*=8ӟxg4cUU6wvL=IY? L8LYr !pBg
Y M}WIGKn ܈7hBU *#-S?%#6ÿOYΝtٲZo9(#Ldͨs/iH PVdw䯷%?tYM7>/Ϛ S
\g#H~'K-'?nf?TYb0?pt\/fY^_t j *~Xa Է7> e%d*eSv"y ' =O?/'#(®x2ُ?99olYhXE.v/\Jߦ8csM-U;d+_ M]&eYI2qO_$)έ} *2g Ŷ+?M
*%p S|I2 9`+9Ra0v[g_rM>2 Y:S_)F-kǿS1=R'(?1{vfy|SE[&cFrooIyeFFZJ4ϣ $`t?X"W CF-~[|;ʈj\ a#qځr-_ O],ЕxJ'&sEy;drU+g -[wA<jvNr1Bn үRy˶ˉljWQ^vy ?Ԩ]K8"[g ٿkMܮ2z`YtIPxDb??<<O /]7Xf=zZF<Nw._|sRԫ|c%; K!zj z$ki2}#?G_
2v
8 ؝[9
z.o~JjJU'w8 CÈ@i#_Aו |~g ?FoFlSC赧QIHO hk;7{~oʃ5ԭ:˯o6qN8y/-R%Z~g uy[vky{ۆfpǑ+*ራ4ٿ AysEWzoɼϚس߫וoR67z
yۏ j
zd}[<%oW Y2 _O=r
ܽISkynXG]mh|hfdU*7{7\62~ O }koyC^Y>oWaWПr8cЬ'>g3a"7yO'Y]h %yO=ݻ˽⍸ޚ jGⶶZ}{}!WM?}?˻xj yr g*m=wV,>v\OJYZ밳?Ao5ަ~&?ƒu˼G }[iW}($"e
<ԏ_ի`^ 3Lر}[RW/24u7]O⩤ {g ;:AN].z%ʟ933ަ}*vɎ# g}o7i4o4%-Gv)TJwzn+#o͖{MmK"rǞ<mT`ݾ>9Q \ze{z7Lk)5;wy'ڸVЗV'a}kTފ#]{#gyw=8+s|N? 1_xok~4V{ax34wqo2֫,6{ۻL>^y{ǼlΪXɮOiC?`Pc?xfy YA /g 7g_&owx]4`EFzܨjx_ ü=^!Łۼ~ &IcOy&x
ÏSs#Vg|YvoTz SǞdLθ̛hWZZܱ۳w FҊs8 C!A诠z{mY")Ɗ2^w4yNLNɗ
;`#6p\{t鑅 ˥W7m]RKrjp ."HGMɲs^zBXgYNpɫ&bS>+M
֟Wc[qVg9-O~&%7\/wae%K~8+<Ua=Lv/LLՒD|~5.U%Rp4 m9ɸH2ىª?.,; ^|", ϫ;Vvq%ɏ_}j^!eH]aUnX%SP)~g"{JTNZZ>}~ J\_
K`Jߢ<\̶_Rz)qaW>ݲqn*)V ƪ|E>9/-ߺAj 77݅p:_}֯ J&i>4|TO |vwߐ$'W6l/&Oc1YjjoNN:
5%R yR "d.PIϴl:ݒϻP>u$+Qow> r2\jKr{h?jٵcWTHXwP:84$S#\K3 Ps?~!\4٬\ݹw \
^]D/a"/%lɄC;P=.|˒T\vi2kfjŕkO (n<:8އigaokx_rz9N=x6t\hٕ
>̜\٫X-馵~K?Yb- N_}aTO~ٙΒAcLXZ&q2v2[!3;TD~}r^tI|}P6l
`ap'SX+kWlq|S.=Q))\?-7/'
ȑU-# XXW.%xOϕ7K(3/ry n~
)GӀK wnY=*X#i>d6u Rr_crєF&HrSs{kCwTX^TX-Li%T|d5v\z_rZVN"k?"k6};Bjd_.Ozc ,L"U_P ]rsdQ_%hSn f) erh|?ggݣ!p8 V2w x %6ϑ(3d@tcnNJt9 vb,?z\%R{}e}MY~{}QkE1 ltJ8 @4b 4͌7a@$ 3;)Y 3Ə$Bnnn=;ѿSTHny2W1df
[!KgW,Kӥ7O i<x9ˊoʻ;IMNϟtlPA۩3rq a<po-:dOlݲd:/?ykm)>iYk @ IDATCu/v2lߤr_$ 28h\UUa
3{/4a谓pډ-3Fvv9-Y&IrDaVn
18 uL@T^9=EIQD+}`{O $^"
H,6,QPQЧ bGDED @BH zߙݽ _ݙ9s曙eΜ3g(-_ 6<}mC! (
EF}kX'=Ĕ NpGbƊ\I!Ae'мڎpNlN'q {vd@&ADks- <P)ݣy0|i%b._YZcOPFF ,q'e~]Hs2@cUyxQrz77| yR06ƌwI|mxY[2(Fx /-
=hWTþ
3D<4솽uA\}0<mkGg^Xj|_&B 'j1V 01 MKu)I
e^1dqev0yBãﮞX( +nܼ\l_[w.THOnJ8l6H7zPˉ#{XYdž/Gu
sYBd#Ȋ
Ur"AXX4p~7 2 <S@/!'Nc͠ӻkqYzN|#cpж=;E<:!='(< ѝ3 <AYϪ?ŕWF#njCS" hV>g+!
H$I¹j4F? sV@?\$Vu#UQ!ŰLѣ} j " X]S#TZ(<xy١=.UDf~F5r` .(@vJD{)O皔K Eu1-5 z=&9ɸ
l݁y.VÉ
j_ǰO X7q0)]$,.=/}9n29I,XlWAk0rbCsxFS3itCΕpTinL ^a
Nrs6H } uLMdV? Fվ`LL.vk*;9YBf-q!hм sź;4GВE)EHþw0uK Rͤ}9Kl $`T]uu z~ظ;twJsK14; ZUD%yഒc(1%YNaA;۴𑆡$C eu'&$A, ϵx:7
u6,CK4p1쪄)>
h
sGj LZb,'/mUYQBCtu2_Ww!gg;Ds3<s]>OBq&py;4k ; %<Qbi{+bna>fkm . y|ߙPq08[瓗)3$ TcƅrbDžXrl V: =7VvƤ˱mֳ=~h4F?s k< fMW,-L\O9,ny'xZg*:/Wy붭sN4>cߌ#$ Ic_uvU)ܹYse$,HQU&$5Z%WW7-i\ڽ'%uQK9S-C8F3nw4
w?4sy!~s^x ώgvCVjx]%V'd
1hڰc'y\[7_4T_c*f[Fm5h-O^gDXII{Z9 <ޒ : +xPK
<.!`/ !: >,GUvYXE!;;li^ "dYmg dB7. 86ݟcEuwZg|.DF;fRꮍ¹/7
C)>n 4w ?|0 O%<cX Tŭ9Ǩ#7~<yfgAi$n|57
0kvFO7s#=_pS)[w#nu8R\Q>#Ky)p̅ d3\%rr[Gi5f2,huuW%ŋED7q;"Xa|+%'*^e$TI#INUb*_,˝ *1* x|̏!cԕ \a+7tq!$@.O
L+Iދg2͚`ym~uh`:[# |
镆kP(i'jÁ\5>Q6 \+| rDn$vٵñeM89|o}*Is+Db h ߙhe`:J3TTrCv}h4F+gKcP93-[%Y %w#53x Ɋ`/Қup ڴ{0K:6BLWβAU5ϜXZɽ}"֥R PE/ܝ<`Ȼ`5i'6Xtq0QZ*G 5nJ,6K# ֮ݏ´G!)$ -v5mZ'(p K0xnk#TE9 VAa'\DsG!ӈ
n@f;T"%&:a :GhR+YiHhWumuNV(,Wr$3PU{=X51oܦ f}!67O-+"n\`iAns?p ClQe]!S8VoU-e>2VxS6kߑo7#0|yM0"7)ZNV&Ey|H0 Jdž
[с/M_4.,(T4,sna@ŋ^CTGwZ\T?%D<V<+BCX[7ٹܲCX9R S{Qp0SWmTRهq_Za{pA0y-.,T%@k,9A6}<eOFj;J?}d 8" Ǐ mwmS8E.e'v*9` . DZI!Dȿ#Ҩ~#k2;Y!T[JWRVyq!\оG~iLHNN$W:85Twۖ\% [j\`E wn7E_.F@#h4YTj]kT9ؿw#سg 83~+Dt\<]AgM9G"y⧟WLA940~d'cE7`_'JGP$pTɵ L x=Xw $?0 -۩ԼJxv>LÃ*b~;xu4RO#8|`7>Cp)Pn
#b$^x [$TBKDX9ǓU6
vVU2n`p `Id2 SiM,*Y3)jʲ\MlLs8ڴH&g8rځ
gNӷf>m Ko ':^~w R&#ӞOo[w=ǬYM|l 31xd' o/^~t4"
K"m4
کλ$H?&
Ug h:[y뺋%jbKVABPZgTinn=Uws"(^һqEa⨱xϱ߇[6b c
*N BÀ [/'3J@woOLJ rxU?}g٦YwR1՛ =e c|:x{/aMfԧK&t:VID{ TUoêGx ysE0 gb {GS~lz6hkUHtaz
6=[ҙtWF|xNgqXmj~fc;zomPjVH>25KsՑގVeF-E,nÒeM(ʷSmX _r-!}]Xc]c({Co ǟ h<-#T5pUP9/f~/ d:h4F@#🁀)5K(eHAzDo v'Wg/eG^<?w,1˻g.6>^_S7J7
7e! ,1osmf ڵb#7]=y$7 ;q/7dryc: ؼ~%>'FrC a5)6w]W
4PIO)Ou?YM0\4@bd] 0 "W!$T:[6xq,>_V"4: GTڜYeZ )hv-Vڜ}syθ7Ga)[o!
Jpo,xX ){_
Q+U@ 韼2 Bt2RaϘ"P[oCHz sy:<]hת1h*ţ2[X yM-#>ʙK + ~<
!ԉX.RjbN44ZT3g.Mѥmc 5~Xظb*͢~˗u˵[L:*5>.bl]/ODe RU7
{g) +% q;6<pm{ J(K>ݸM̜x+&\A<:v֭ 9:8;Vc_$p}fg#=gLKїrrPQsʽ{c1lzm#?yNrބFf= !30>z.MvM6Pa~IN4%xρQ/¬cS?M͝y{w?]vƆcÏFa8s# ѓ'w=y Z6;
57/.:s Z5,|9*+&_.2dS3 =KwZSvn
s^~)<夜;*Uf9vp6t7[1 t/ KU6nuħK'ZlIO }[{ !4 v[ "S̙O ڣAhxyzpmM;(3jQ6"[gZ)Q^}w$+x;sfF(Q!O7)h4@[ êeƫ!7;E<DŽٟ<{l%r5Cqiicٚ-[aB1h[ZVAעGKnn/wOwW[@qF嚇1SnUԫöq7Reb;Ҷ)+)沮&Ȥsb{|6m!k QfRi,YAcGqħyFmArq .ul 8iJ}JUF- |mr{ R^X\tG [ xv8YۢOw
+v)K>?+ v~Z]x2^˶ 6^EEMR7s6`[}.8}`J{Z DN~ O}|/8ݽ~u烯2ҕ۾KlQG<-:>ېF%Eyr70(F+^JŹlo>`,4Vb]Šv
]4#/}mҳU a-
ޢڸlJ_Ԁ 7 nl|caOb(4>?d*I;mwlj h 2-0{~Xcn9u61bKl(N~ _Z߯佛mYfu=yq{Uر'[&$#=*&m;|U*پ{>
;1='mY{45nXoc s LA7f6+F 0x5/mBf*. WnQGvnie;+-<'e-5cyzWcg-\?K2lύE.rۑL>ո F@#G!p3A<@[tN
gcj/tMTɛV_+圧80 )<6 އ(ɗļ^ e9 IVq&S
r \Gs.ӫ4xwo܃n(HW
őKr
rvOGXi'F4 t<J3Sν|ʌqP2C</(.̴:4MJ|
@Zw K~_TC۫nW R)
$E?I9b C+Rm* (X<l|ץ)N$0
zit tttwcx!8}nFvcya!lR~v?FH5Ydox#B:2~FdɳbXcM%sv]ؚy')-N_ɻBA/ C],zWb퉰) Y}64 zgnipxh|ydсFT!0oxǝ?e}ƌD/j 4EilԵs%x 堞62%)>2.됈iz-훚T128>[r_ 'S
\sKk`
hSuA5Tn|2W6{U/䛒dd1`l<Kzo;tڏ&p߈AvBYΰ MR{ZεCb/0v ӳŭ.䑑^
#v{phJoMg8QtHcc*I#| ?ſA}ubӿEiO82lɣ[$t* : O"K)qӳO~{Gǜm=beyl؎zS@`v6ZV13,:h4.t{YĈ`uJ4jz2xKh [L( Çss2( q_:kFm8*xغe3MPNph8&6AMVFF9֝
hLLh)42ӱcvg"[ ۡUӐsh,#A:j*[q4=t3vѳsku@`0x& J"Dxh~{n 1Ѭy DŽd!9:",^ b"Cl8q䨽rF_`8%IJE äEg1дyKG 5 s3.FBJ̵"V}"-t6ϦWjӟ׃87VLIuMїs3s8gqMoTXƢ~3+/;w20Hξ&Q/o sstt4cblR EZFywSrQbrdߨyV\NPN)[wlF{j-q ǪzfHK['*߂
JU)aZ[a3;ɽn`If-Sɇz&_9,Ko )--%>pc\xqb<( 'Wh_s}"(@щDǰyf MCNJHl 7DQ&LGUADOm×i.U!;+~%J=aypnh 02-C/OMeMOީ'RqDȒ=݁A!FTd$|(K-Kqa yDK
ҏ? tV[s ʱg5azn ê߮Ң< 7O{<k\NT` Ǖh|"C'c -ly"yk4/?r<AB}xcR7r3OCXx 1Ӊ# `4B34;/:1eԙ~G7A\l bg-gN[NG{Lب)Z4mt 94I71oЗsN#))ɕ,ɹh8^6rc~Av0Ʃo22,P]]ZG"[ċ}tlCnٗsΤ~uaŝ$6_T"A~n6W'q*-
˥D9q3׆
if`K 1 NeDpa[Rt,T bʨ/F@#G"p^]joL0 +)cK(;GKs cb
sBY = w]4d/_()rΝ 1ḟq+Də9(I#,VDM^x*kA<.={mg8ْZJ` k+B?I\ XeݢB5bk\2h k oF{(u ?xq6͊y_2-(G_x:-Z'{$FYZ dW, V\]/ֻVs)C9oiGyph~ ~{>gY~<q
;nL|k!ywƛm%˷ˢ"Ip,YՑ)TţkݭwǸ:jQȳ#>4YoqfǼER6|K~G<uS;h4=T9?LMΟXk&Tk&4%!qsrb b2l\g]
Kĸ
܍ryQđZmehdb'WP 'm
?W XuʊL2EXv{)|y7W%p;`+^IrW IeҘTEf &HhUGu#i|rWZ<;gr$gn'#qjƸ4#v y$T(? _pY&HBS UD[ &=~+4QqgWk}EplY|\ly΅Ym(|'jbq[{~,i%
w,F뵺q5^]䩋oHOƑ%'s<Kz;`O#v[IcUYLJ6*[`m+#
)N*o:1 aZiƘ/vbf
5۲f
K#h4$.(Ke?S1kfMB i 'usR;!VOk'p~L$5]&?h4_1-!H^ 3uP[Y®%քkm݅ QyUEYzZDz]i YmkuoŻafx3tU;[;! HϺ;wi[ ߟEߪ*}V>nѶZ#X%VyO;~i|n{5U})1~8b'O+=j sd+8Cu:qExR=i
a1N ^:9HYd¡MOuŅPV_ TU.Fu:-~Pg+N;۱nR|,Lb|oR3.Gb y= pV 4'+YO3*&.V^[
J꧃F@#h4 )_YUkq4j>rGb~s1eX#糄 .8^(411زϽ TIjB~22{mjz_;>_Z;W+fpq@=x1<=x|&$s?84^FM[%E 7*a*Obgd5EUhfΉIig;;ojzd."0r/n|^sPzU|ټ3) h4
܃oéfD#Bv!77y(s+QRQx BHp0|} Ӌ= 8U#h4F-ﵹFe|A- ۚ!F@#h4s)F@#ooBL|BuF@#h4F-4Fڂ^;ߑ͓F@#h4F-_#h4F@#p^jetޤ:R#h4F@#h4 -]jF@#h4F@#~`F@#h4F@#߅h4F@#h4@@ Nh4F@#h4 -]jF@#h4F@#~`F@#h4F@#߅h4F@#h4@@ Nh4F@#h4 -]jF@#h4F@#~`F@#h4F@#߅h4F@#h4@Ϥl'frrr`LjqVUUE~i{YBX>Ol*Ι[۽,n6bO*pvv#Oy¹v=jc+p!V ǻ&yu}&mc,YJY6=EncѳӨ:ǮVݿjZWF 7f.fTǾgό+i7qX[EרX9GlF@#h4N49j%Q݃Qsmf
#b2ItV&*o?vj$ j`U7}+ߟ}W7E0GmKgVgkbtV k=WAVYd isrxmrW~[{BwJ_'u< 5 h4F@#߂ytk'2OB~Q \= ow;1T 2u~NcLn%zw.zJ QVa" /,(
>ޞR kT UœcR &V";'hZy_~[*W~[i YjYNaA>\mԓ Dh8;Vz+EX)/)GDJ =;:ˬc$VYDr'7+Ypv@Dd$<\6C+/+Ax;ׇd*EQvUy QnsEDtCT0byQcG5 («.< I.[ځ"g?jU%E()>ʒU(,,<lWI'e#7LQqGIWI gh^^|>s
ypFdd\T/#ME 1J5,|VYKY ʁ~APRәٌw B8.( *xy[; 7*@F`(7Pdu (-ɴSx **؎+z&lQd@n~!,#%߲/8+® ;p* ۵G\tp?G4F@#h4ݚldaїo +8 w :fSIk.n 5״&j )eLՃȤ ~u(3W<d$Fr\
sxho:Җgl*O O[LGhgSjU #:몛CJ7pL' CnhG<hDB+'uѰ/|TTOVoֽ(;?xt6".kkEWD - +:|4d5VԹ qc1~G11E_Lڱ~!pssEdBlԝ(yլ(<y'ײVspؑ
gW_I^K$IJo4+ԸA*(paVhdк+Lm;]{"V)VqCmyd`k@ƢwD{X.ӏs&>RK$bpڙ]sx{tl UDT
#ԩ8/?|)>t!Q]wGpz`aZՎCVKXEU6^1Ig
\;w !ߖc? y]݄!ث
^vR1 břhxSŅ,svǘoe{G EN?w¢5PUQ7߁w AD]ZYVo?~<}ph:}w
Q\'O7 GfMm
5, ҏF@#h4)[KP_{6e9~^8[M OcEطR@wSr)| ƆJc_ YݭrD+*ay/ p75FZIA*++)0
'SXqBhX~".{ l\ ۿ
M{
=loRj.K*KM!H@OQ^Iq><<<]op6NĆ*NEBqQ!*v`ܘ+m/`q9J%cD9u4*ovms?g0/T`)D_Q^ƺU¹2,g L{ii9
AaX*
F
h x M&BYI1J<G,ɌL>OK??ǔ((?^Z!' Fw
h
7/9OUeIO;"Ԏ!ǔfkR}qo >ES6
o+K ?Z2bT'- D8Rxxy۱ 6.F !l}\Q i㝙?ǀ- iw]( Jei1xTRtqe{p m \n B-d:q9&K|^|>/xX;# ^
aAֿ*j"UWwoR"- JSkoj?VT\sWs ]~-&5s *Jwz,ذe7)c/n 쳇lo#;z{{`ZAʖ[o7< 1"ܫo^'ES㤪>|n,?[a2F<p[`]Y1U -qt}-£~'V?>Cq(qiwF@#h4~(<l\5 S+{\bm:"?/ n_} e#Q##;ϿmEر~})c8kMM&ey{ QA8o3ٮ n :GIn|Px( DSJ}ih|S<a\߷E)𧻓G^A&1ڟ-Ĺ
q-0vj#_a_ s)uKbk[
!6F}(?}
?g 2ؿy=~ݰ3_%gx\ѭ F
p%9÷P î5>Ht XUb%xwTrKeZMnF*}( =M;b#1A!ɇ.2[w[oD\,0ذoo/]rg p Gza~Z6,:+`Јv˵VRlXY*oھY|56mX#:[+o"l2ԏ䷞ < N- BLKf%4@,d` o>@Ǧ
&]^ /
hXG㗭G0: RP{R¼ϾBF~)lktiY KxYލ0>lG,w?DYX+4eŞ-kxc 0n`v+bO%-%z\V.O(WFT { h
6
ACܴ$4s6zrunȭ3ڟ1cF![?nu?u 6 (
}F
,ەp[qcoQQJlXYf{COlY sE!6^[b=c{iYcNJ 0w. ,3d90V܀Vݣ#!:IvT[qf*
Mm[v.CnBl0 CFq5p6|4 )[p *F=y߶ߑh0Nra ǒc[yy5҂ew">#O^´ VbuWp 7O? = }F㖋7 N#MK4vo>--0|
H/F@#h4+yj[K4ؽ'OAy%rZWSxxqӏ/s=9 (}oLڶlҴݘ"d;7`=y4xmi{9 n QؕLWq/' ѱ]s &J w\ҳ OSqy-: 2ߴk 6(9'_ETp߽wai1~kq}! Y(/-Bj3,uC_
iҼSp=]M<1`8r*W*˰|%"H0'Sb8| }I!yv@?AMgT
Z,p.WƄ;nn7~W.now Ǝ ]_=IťY {##&L mbqr*k-fڍVcx[Tǭg ֖ggSyJ)?\zOpk0*.H(/85+~Bv-UW7 }_~fi,))@f/GsGDԃoA6s;n8z ?cйc8j pcФ`L} l
fp/s"q|?&~/<|=l;PKleعinz b#"WU('^> +qt2L7^Mq?O|JZ^٣<D5@bD%r3u욡hܦؑ1dHWlݶW巴Tzuh!ҾAcaӣm!
@f><>m DЙK8SlCy~f<~ NyIqc#W1Io <<k_ʉ_?"x
[+8^7 _i $%#pcӊXT=Ά * rR\
D&UFM&(7Ƴ=`tOAAP b ꝙT]o"ŏ4Gk @%hڼ
Z7O0J/F@#h4ԩAշś%.z0d9yo M!6,-trDI3:t'n~<tM[3E4Q6BХI$V/Y{FAXp>5me&~7lu{%'=>g . @ IDATy5 vR(A+7l#{a}(I{30=M99q \>x(
.鄉7Pto\ہh$_B:3 C\TS<Т2MOBxNtDE< _.X{wV<7h{\
30?1~h/>yhIa3-ܨV ~ƔuMF3CZe M}ѧk7| sv]
pWSRWX0.de^cc#C!]r> "{C2 UUbwj,t{ǎBDjCb]zFs1EleРfo˕FY%(asC`t<^zqB=p 5
3?X #.8)!Sjf
ٕp4v?,čm~ŕ*>3> Gѳu/u7ތtZWH8ؠ74oH3qO4n{mG $nx68~kj07kuxHb£ٕUѯU/'gM+* V䓾+Ibn %6n
2r+co.9{yInpI<t^$P m[>"2ȶGpp0f-j+>%jv+x0kR|twCT|#tm51
Ɯ/믔"0.->إyxc < *!\ { tBb풯ڬYȘ
qͺcxדE938Vy+c+=i?mL;ک:U2q+@'w+rˏUE?hRa6b8_*|WA\yj} ,3 Zݏ .܄q酌Tͅ~h4F@#_@N]*nAgsq©ԣ:|^ĔQ}}bg !#@y~zd9 5sG{Fشu7`/7(d"0
k, uCjB7Å?bbDpf,qk͗Cb0Qx&3m\1 F|3 eIyȡs9&O{4/U?12( !<th
F!GbԈ9ᦻ<
8P^\nhJ{+R 'M(0H/٫;zgh' Q1f^cvn_I[Tмcݯ4Ǟ Sa#}n_=j_~ܹvn\W~qi&HM@^Yg0w_%W}wSb{ ķH۶ %IXIJ+ĴY1W.CϫD [D^%Tw_m-"HӁ)'rIl
b:6k~o~FMHi@ҺP/?ꜫe vUU\72*[u`[\I64ۗS]݆
$Tebُ"?}RÏ=0/7G1ߌ.+ʴ~Qh+w/| +=_ D
,#Mm%LCyaER:~%Ν^ڇ9<7U¹} ;Ke,PI]d G Sb86$fe'er >JяmQXw$[lZ/A/y -@Wp;Gn`X\OĕC+Bz:g +nƽpiFvO1>; [h>$BBIWnJ~_(=h0ZVVL]>(¸)Ќ{ߓlw_.2:vtsv/ɢ
,[?Zw^gbyhiXQϒR~JC-N`PWF@#h4 $H
% B _6-> 44
C,(yPDj,W`N8Fp;ЮI*@-q2V~F2\}y\aެrJl?JP$}w ,+.;qc0$鲢4t>
1wRF> \*!eq(
3e j]o $aAL22c59mԥ v(\ј8ؙIߐ@N#
,Sa)hWc/Ҏ u1udnu1kԶOya<Hzd4xrmie꽷'S')>n6f<p"* K( B-GSoSTQ Kb<Or=SMeY)tNLy
C,O +Q
D;.mSY`Sh ++,w|\ZqjԏE=P* AMj fgg<ȏG"HG̜Am+?`r*Mڍ~%sR2$ݝf+bT֥\Iq@>i]Z)R_iO*@r\i^ģ+`(PmJ4߳e9p%Oaɍnkt '*k
ХMKwc@Vʙi+^I~S?IGa.:\94O[ivbXa<@Ss"rC MһGZw*pE tq0U<,ТaM(s9X!$i\ Y4 %|H$qE XR,T֬ Sx.*-q|>&*zlUTO `#
62hh` ;΅Yi4F@#"Pc*ja`\231ϱgA O>[7+
&C.xXK,j܈g;;Qkyo2$X PwcspgpŕDo:yӸ})'YHK9 -g("ƥ%8j-]=6n ϫڷHP|QxTڴg }x a )9/=DBbSVyC0Ji
+Ґv ̙CB= ^=Y" \ ڵ \ܐ N>z p]+0LSuGq}(<CsrC
7S;~ًpѿO7S82??d?L go;yk/Ʋվ{mJG:ϧAko&qOv]OKSRC{!'34i(jEI>N{y W<غB^Q۴"̚O
.۸+~ WT 3 ݺ!:D| `;/> xAg9I.jӇEqjzExo|2
W/]fۦc~r~J˝#E8zZыopфZFruFsqBX =A#zC%CBKۗsSh:v hh#'+<̢>_X{ \\7mՏɛ55LU~ͬп@XH$$㛴S7`ɪM8{ᙇGaEF.Z}غ$!39\7
b^|3<DL?#i8s:˗|$yi>bҢ\N.UXWTlؼIǎpL~MMph% W?jtB1N%rN9Flݹ;m
(o߲UuSUh唆 #wAٻ CGq"c00 oNoX q|V̼>\ٷ;B} 㶂?W2eiL0 z~nS_+f-tk4F@#/"`)Kk*<ѡK'4%SS ő;*xRC~A%&SplۮX~Ẇ_&G⺑sp8 .5'2=mԶ;6 3fLǺ-Uqs^˨tsC[:
0ͧAKbQ?Dƒ~ḌWsp_D&}oǣ%pl:4?W^E-w
jG-nDM_%'wLkvyih55ږި3ђD.;'T+$jqyo/̘8F䋞vmMͬA (S?@Mo'LȪġ'řn+r&9qSf u{gܼ3WlzOC6<ܧōh4V
\01_Żgb
MW\G_ã|Ж]'D6n CLv
qcEe֬W9,H8(B>SkDε> [xGdS[/[ZhZw: ?F
' @tC
stqIyA4g.6q4%&? xtx\
B/ln>S -y`T"-BЂBࠛQ ͷB.lx'v(9}xcwƲH\6&t]sWv`/'mk ]t=К^z'r B}T c%_`ךQB8,{Asxr;Al.( 502Y. A0/8s _-y`Sh0Fy/ )ݖ,|2cO7=(vlSIQ;}viXSD[ $GtFxkJ +9ax o(}d9ʣU{P g N4j `h8u:"8=5+e_G E .Bfy ~^;m鋯M{XN8ʑ]>"?e7:&~ T}Ւدb!>6 \wp m̱v. ssw?3GR&c^(<j23y7=%BpˈsO<>G%!ֈ~5Cq5xt QDE#h4FZ֭׆A)ME;._ DD)( 4j8s
U|8zrodť4W&ނ&CGo;-Pn# ?
3<8/P<$T,:4}3=)Hx{BE
DTd Gf/7]Bnxu.y&xxs| =y<ٓf-A ;[9]Έ\Py xԅyɏ1n/ XGܼB3G\VROqa \<PH) UB4ۯB2چ'Sh[@=4Ӷ]N 2N#'_0 TN\(䲎v>I /|r .M"(, t
n
tI,Y ҄]L49Zdq &bOa2[O}n]kBEo%<C
}. ::D
.sm ?lcGJ
i_~}
*Rq&XaI>' .X42ҩU͆+L _QVza?wFzo*E)wWUd{OHz
W EEĂ`[]ZW\((J ${O3#Av3w9swg9#ĢiX aڊ_\: x4ܨs@ kEym7ӑv G> Lkb#U@kx ߦb"2`,0MR塸9 w ߽=/Oݼ}I-ڪ2nr H2rʊ
z\tĮ|8t9PZZ*_;7dm25w.dKx[ i^1^tTǜB"<0b6>9H+bso /Roig^*n9牆de砙^B) 5]ںB~ j)!'GKaC+ Ko=wdU!P(
BUйWX X[>[[vu[S[[>˳ \yJ_а ̂,LiLźْ<' si ;\V
d%Em56۪}hbF`2!F64XXvJZ
YOWog,Qk> Ze(o9>fZV> ،A`1:>" ªΏ+[<s+nO_b܍wm5 !cݶ|[1Bq;>;ɂkͣճ.z VDAk%ձJ# `I |%r?,]qr.Մ\۽^UvkB@!P(
Fa{VdH4ͦ.Sw\N!ß-c4P땘'b˪701?}ŖVqUSUι,eeږ2 KyYL7br<'jZx!7=1>C`U0fc(\hKpLqvBWODw`q- s{j,idsG)g[X wv*Qb[e=^}ΙVeܖ,qIYc֔)F"^K vJ#rycʴj ˡ,i\1oO B :-sCbuYK,Ysw/4ՓjוڍەU<5Y ]& ETkճ;%9X sY.^|r\,Ro Czh +)(V ˲]vm5(-}m&Mx</{$Eje:&{K+R
B@!P(C7tA[ JWVY-#?^>H>y|[dߢ
^Җg_˺ Y.kXsZ2G>ӕmoymmo'ј4]FŋZ<zee [>3Ϳ+~JyI W}*G7
B@!P(O"
P:H˳|Ǒ$]Dj
'ɺWw[gɣr!2ʭ ő,-WL{ml=¦UQ{<Lօ>ڞdz;z vZ5Ļx[zT(
B@!P nt%Vq]a:K%>J.?l-^mp{ڒ%,e{;lJ ~4ϲKylCqVeY 4rBέ,-Ժ\-ˋLRY,g>9*-)9"[mmn>p=bsZ
Lu'R>re-Nή,# dіAI6_F7
/hGo4}ڜ}zܾCl& d^397p_NZ:ufY7/G'grϭ+˛c2qXe3`H?el_?wՆB@!P(
B6ìR0RآSc-ĤIS0wg&ʦKY)ǬѳT [>RˡJKW6fnO(A. OމΝ6ŃBȡҼEgCcE!>Ctp C>Ƒx}ͨ(B̅$
.~' ꫱oGgqTB
IxhqWw =MNJDK,l\ ƣCXO̿e! G [LqV+2$HW#P,\ <o6螝bYgUgā)TCfNB-g
=ضgE7Rh>}Luŗӹ: ٳ 6z;Lv NOnA; o שe_]y!vlـ ~> [ Y' E ~)_g2нp,VJ|O]s ;m
^\V>Xx
)N uY\Qc@x2IYl_?ՎB@!P(
Bώ@ tJW(4 -FMIO_`Chޑ!?9ʈ~,?ǜ#(-xٖ(h#ҐpO=Ww@~0&cwb Qqúu)dSMe
+EYya6z;)HjkzMwsSo KFhDWD",3BJ@r!GV"sqa:)Leb,$ogW%%46.x0 & đsićyd )7݊' 1hѳH)}9sz5k6D#bL҅X*L>z$X1kgK#{P+,"pv#fށ߆ok%xr.]9"gp,KX6bkp]ᎇ¢bδksgU~27X3; {%dm'4-;Tgc5m6|b9:d`q>9_\C@'G{ʇߠ[LTWB@!P(
B@!`@tVXi,/[>3~Co1כ2m*Lꕆس*k MOgd'' .5AHC m X߽Do0цo( L3Rs
S"{(Jqiv A]q.2J1ϱId-$j&Wbт9CCH.';r; 7,6(MD =A^.ƶݓbq7ԡ8_[n9/o 5Bq$ S'{omޥ \{0&YR}U ٍicOA~d
AVJ ~!.#\7u|\vY9ŝ:Spâ(5lQQwÁ-$hߩphy.:cxxct _`3i_4bpx!10 MبLH|dlt4V Z;g&Ͻ0n: طa<ƌoSAF8!LB>_WNa꘡D1 Mw
NGcK !+pdloYɃ`}3 C_uǥ| 7c7ιxo[k䋸9 pż
B@!P(
@+ڴ.9"8"v.u
MbxXX'7įX3p
RųXva?/MqףçWX־5뷡Z߁ijr,"r M؉Pze
tй.A?KVINH!--;wlG>>#֬i.I=F^نI18 aj$:ڶm4-(/-CAA! 2;c̯P۠?[[_y
bb2.^(X {|'.pkkI1m?rUV\Y
;Uϰ1ctՍٜYfY&V RiIx
.,SSXͩGܲL 3UulWgx:{A ~mڊ<>""
YT i9((ѭz5x߶
,? 7Nm83 ܌
ATN F-}###/ 4gJr1g$> 0j|#K'kttvʹī1ԥTZ \3PΙ>0 6Vo( ŝQ(
B@!P(m#Ц]ߒKJ;fV`l Mj{w!#`l:#RMI7c)s|)&^̀+B=@&
yp *9O}:"zXI.#kbp1gTz ?o W:KgE"Ok
7m|qGB :;[G ; p_)puaڕUpruÄsq'ّ2=M\ 'gipѷ FdO )iXZ臚a81|u
Ů~
xa|[Y',dY> RtY^>qzcbHD
w~dc|$Ɨ H*)+O]/}"|P_ͶcS"g{dh@CSSk ?Ǚ}㌽k> ]ޡ5YߘO꼱 MP8l`h>:aOyeٗǰ>@z 9z ]"hMžN4d'jT߄ڊZ zF9R ba9yz<اċV-} C~^Jgс ɤQ{SWB@!P(
B@!p5TI:5zkܽ,9yHN;nFaAqr-ƩPYK + 1{r\=t8: ޓs]^>وKB/pifSX 308 )oy߶>f"=IlD
'}KetimZ>v %+uFRZ8rȒE;t@pD9+|ߒmI!4Bhg{{DCXY҆Yﯪ(3[ 9_k4"0( 1{OObO?8L( r#l:J cAeE-$Wu>75jn]| 'DD/N،>:TbK⣺4 /Aa} h lx6vLtoc@d!;h& l]p%(v\L
d:o[rhKZ
mit ߎ%4 %S Ōmӡ; O&[Nu-yY}RyYhu{#g^dqI0UFR=xl0.4
K(X)fXKS(
B@!P(W ж.1xm_#b70QcƠVGRMc6፤d;vn{˰p/Bc9 MP߀Q}#1Edgd羇Z:Nq4ԒKqJ휕L\d2ĊsNa5T(?i t]2r 艼o`BgmYYdEl۱HCҶs'TWEG* )($A~z0_}1c\t!p- Xrp%E͍MǦTPQk:n7.ƈI7R=P7 N%<x0lZ^"_|
=_ -:_g7WxJ2εilhqOXɆ 1R-68
)ºaPFkVMGGW١ 驾EFm1)܃+teZ,ѷZe pmu}Õra4
҂<t ab&?<)oH?,( %;˛UJ*gyWD;+t̥e$B%B@!P(
B@!6uf:LBU[ v <r] 9q={vF0ӶN! ;)Y6+յbt <f2 qۖb
3JN8u9Z*tBH 砨XcZT[[Yb irZ*R\u1r2/8d
>s9%)CU-(@Yd46o-q#=3uCUP}p7ڴ :]+3`HaĪkjL,M|Zw銚;p)%!Б-+Dn5 ACCu16oXQ¡8Vƶrw}6G:=RIܔ x&/ Kρss
rsrP^];W? prO~Pݛ7kyN(,\H+6Έ <o=uMɱ܇[ѧs
EZz 8|0 m`/۾1$iŖ?@c輸KMgER~ۗH{l+ڲz_ZAǰ85 Iϝ:G^]3h㯇@uƷ8;/>J *n ͡k o|lCli(<RV]
B@!P(
@HSl"y٘1~$, ]B aWg
0.B&[&/q*lZ tKs2 o×WcHmFN3a Xr8զc8
dQ'V2
̛ͫD\=pvg_nxywŮ_A(~ Aھ}t?܄b+gjEo*
݇܆G
-cоp;'ݙNf/v'{{!8s ~
^7?v⭿Ơ[Ǟ |^ ͥ O<i\&s%ƶ ?o8'C &5@;9ˢ }_ 醙JKnLcc} *Ć //F Qh,N FO?W=I-Ɗ{ű _c;_bHFCl9oG:w -܉%=H?
~siO'KSL;x7-HKrSqw4g Z6M/ >C>N<sxl~
; .Y>i)y=ɓƂFj|,Zw}Ceq\H]^IJo8
Ğ}7މlD/[suQ(
B@!P(m"`CJmW$iim|:W\O[<}Й,>̔(I(roGs2oT5t
#)zS %(n$qG86n]YF%'!3 w9#(iL,+;ˇ)MByҝ"6_* z"G#j^
$¸oo@0)@vFmG_ڲ\Mq AT!)) ١KD Y+i'N! TW³e >qVڨ$OnFRӳh˵ NmO۰+kPRT֣W xˁɉ/ n(ƀEZN^K+Iv
707'v4Ey-
ҽi7(/ypqqM39^#/!gOMҥd?(}z"{V $Fy(\%TlD[¤噶 %rhxhȮV#/MgsSЮT$_v~ лW P$C&
(\.*)+x e$ܽ)X8,+¥K(n@xt"B_~
B@!P(
@⨫rm2e6+XWRtWsڣk╵QX3i,j:,Jh( +-LY20_Iۆ+kevr%e hˊ5v[s~[<95/Si۞-4WΏyԯB@!P(
B@!D*
:t+) k,\S[ʒu=AH?lfe0s}V-j>3o)5Ad]7|[s4}UTQӚ-ItfT\'ժO{,7L'Ί|!>.T(ʙβ=1yK]~fzEm99%ɛeϜgMpuG<<yw|c9%,3cO\ 1hKЪ B@!P(
B@!pSEՔ$JIɓj4şO.LHz8ʼj\̺?BK Z iaUTlϲ\ɶ+C1,c-sMkc"8`PRlӂLqV[V䳮n6ał *(
B@!P(~SAoKߣ$ aϔg-I,,ֲ1 Nzm(]?OB VG<wg?r!גCV,Q
B@!P(
>XWPn> ǤRfhjdԆc%$h)_Y(^Yrd}̲ٛ3.2]ok:JD^FxAf֕(tZp]zz/J+
|*Vι{pחlX<)ĝSGΊ+k(Kӵ8IeO.c嶩ƫvxq%bt5e&|/iVymҊ
*K!P(
B@!'GEJW W~ZB ;:b<R)3=[Hn?u% ͻ{@Ol9ڃTX1<I&z|uiǹFa0g>̉1 ӟ Y&o[(;Q/3y[)*h%/vdOˠCgPij_HYYvs: +ʑϲ^3y gQ/bs H>H_8~ف4Qygxy8yMZYgb .b<J wm'Fy MT_琘 p+7Tc矢 n= d+3_"3Nb}!&zOtKK^O*4:_Y%QI~
6o wd"<qZ<*J
WX
7sĕnܦ2ON܆h' ۆ.!_ JYl} Y r[zY{2X11 <ěFs;5%+; u\G7,elǙyR,
G
`lW!P(
B@!߄@t5~
nBt\"S/w @LRaVn*Y,~EAX
ItP>؉SK]]$W~3-l?Y20&|Mԓm銍Nl7Hvv:<|v'l ]\%%e&4 6)Xπ3.\T<d;\.L&I'Lgl)&;fP@jICƥ8 kyaqM74w0{
X~FP' yEU"#r w (ԝ}#<VBP_ӧOr >zӦMǾ1HJL@\b
t@+=KL@q'1Xm3e:i|e{r
܉NΣ:VbeG؋:8' ӯMbYs]Zs8굁 l:ӫFi='yĬdJ>s_dC qex02PKy t-&+Έ'}>r(7]%-_}63ZX*9QMB@!P(
B]=Fu{-<(m.0{'elET- @ IDATQh.{D荾 Ч ň
p9)bIdYHm
HN #+)xJ6:up# *'ŭp.ypqF>} @Zf#ϝE|R= t
"L<]dS,ta!VqĉwI^&b/\Dem#B1l 8UoX\:x^h BNF2.^F ĶspAFqY(ޙepiIP삁C <OWkw>YpYM;#)zi>DE~I:t LID\|H E߾Jy*Bf^9zG;2SQRLb_[t
èȱ˛ NnKGLW[ј2)"V3G#־,/^E`p:` GooD=Nھx'9As%Ɣ=8ѧ({::^pi3q:: ѩsw 9Jzɫ8:Ɨǫ[ݝ殮f :<* )@^Y:x##
{vۯ#ƏCcPS!TX}{ 8{$iabϯꊞ¥m7j zw
5!+% 1SFs#\vab f
U.{H?{ґ$59F
dNI˄_H xkŷOLJ
h,AFn
J:< 8{"нO$aٍvآ bSHcꌮk' Ĝ9gp`.K oٳQH }g玢9QC+RR돬sqw ~}(GP(
B@!#k"We%+5L@fadd7Q+51oO\ERqܶ ='lI-%YȴZ =Eؾ}<ߑ]VG6`Wg 1n l}D1֖^è[W=
ydJp_p1xuLr% \J{M
LVb4u[#)'1f ;( >ǓϾ]{㡗CNy{泍 &9O/LET~ؽ^9
XM_kĶk5t4$ðH[Yw^~
_l9
|x }8$ M ljTQ4PN <6Y/^C o
zp6N&dS/?_ɋYT@J,)Sb+r=)I*\?.<p(
N(+)UX rN2D] >x_nݏZjsNt ij==_\m# c\=~ݹ#Oϊ:{yԖW[~رoxW]o(~=yQdş߇}g.(n_S߯'܋xe8|$mxWh<s4T] ^2 ~ Xڇg`㍏ += iqHOoĎGPY]~ƒKSc{C8v!Mp>3N =W_^C d:>A,nhMyg;r!.ҢWaѣ#ޓf}?~ن`ΣO1lr= ƴyᕕ`/_^G] &%Eq[Km
>7\"z_ !97vJ\2~! +R }x&>_<}{v_V6'ç4M?"R
,۔.
B@!P(
?7d"ѶTs/Wv HtbҊ"KK=4#R{OE?jSgީ4R
cnKe-n~e-ZӚj/W=
_VGlLeZ\Bv96ݞ3G]YԼ(w~٠}$jP+tFQ֗k QZAe=iҒ.hZ}@m 6ArT\UQF.|/=6eODv~>M:ORVqNIA[W=d7֏_~HK˯`7P;m.ъt< rsAGk_Q]O&jMՅڒѬk9k1ɄAEm!کbM3jw}3FX#^ܟ6Jx6fr^+ߨmZ+ȼ(76]+I=];nW% <i
D}I3U/~cz]ByU5#sj)^kkJlR-ZiEǴ
+h,) >:->\<3 ه*ĻD{kٍڜ'NL_i?S]4C+1hOsmr M{ja64*)+=My_Mb2dg[4Tk)9mZaZZ>iqͣCKۏ zkL{QڒI:*m6R[ V`hg]KsEڒ 6ڋng߫]{ZVa%5T}'*1cPU=8mv_Ӳ
8?]{dp핏X N[2mSiYi=#=Vgؠ6uMMc[S بTWO
$z^Qw7kcZn~V][]<]xblB6hvџԯB@!P(
B|y5CC-xY @=?~3<T 7mل b =mfS[b(jDsCwNj$c#MH'r Q_UD?1Q =v %brQ|x$q VFW:[oƠ_T&ɄlP[Q@[t9uO\/$!l$G<w YQa:\mwrV1pD,ǜԙI f!_o ԩ Nں*䖦bܜ4b(s$ipd^dL˂Cm-vm+%1 ug8y^Pn[{u1mN k)qu &rjqθp %r, ]%pt t a~MkD![䜡Ř/nasV =_NZV<͓~ؐss2G4[NnBVA 2
@ѿ je.1#KqFUKo'l0r{:Ři8ddgU$lXpR{)(CuU81aѳ:i |uOLq/|=; ACX=AnZҙXrjoB1t`\ ~GsuF >J6k
/<urfٝCmЖVt 2 眇8߽
k/d~ SƎF =OGo&[?̛;=":4ħFߌD|чD1Σ 0q}O! }R?hP8 g8/@l۶
h,i\R FiG$] ^ aOGxDH(
B@!P(Zşzt
uWOxst{.nX҃Pru6<;с0j"x::^ AZ'OZhOάl FpAansY3'Ey1%'p?wsq^e'בN3<#Ƴ c T
+җ&b꒷{)^x`o͢_$Ⱥl)L kƎ($.A 1pI y#n$ ]3@ͽ?; q
>ٺ>m>zO%/ 1\W,iUĖp嶹p'nO3YDW{'Fy v<|Bܱ jq1"#2}K 77jВLВs o76^}SqG(X3ba7~yȑXp7u?SWEe2I&/0!c.F:vd$jQc?":!6Ph3ÅV܇舾8r { soEL&y|u <x{q+|1>b@AK!>b$zzҖ\3G߁K0ڑwDw[D)B,& 4 ώ><u뒾J:b Cch TҢ,Gp8M?zi%r; *?b Q !G TrTW!zn^Ӹ78_<KyB aB@!P(
Bvtq[SU2ŕ>KΝ:D
@abqUB3k`feŲ2]JV0w,:^3>H˘
U%Ɔ EǃDp4Ֆsz8vvnۿ 5=O6+`ċDrؚQ=e!ح?=zdՇ-u1/VZ
p쓹յ#3.B=YiwΙX({ 4Oι3s'qؿmfT(! L.^ 'y~:%tf/P@݃
#TSLQ8 iFnFؠk> K=uߌ>,GcbF &⁄7ŇƗSrNv31sXN<:FGǬW#%0t9f?=*q/Y [,DtA.(,;;SN FNؗVaX&@Wиt5Rji1Ss]o_ 7#cBFa-zIݐOaXglXisF
WT^a-BUE]A vBpfC-Jk v|LL 7K= {:{Y@}#^>вΐ :hF%^q4HGka^-n9L| pGqݨ0֔-|dvD#gTh83ɔ$e`A1Wo]fwv NzzO g\$au8vJa
-{F,zq(Cwa&&@UظK 0rhcB(
B@!P(Nm?vUw6nǺ G1`@(μ%zl_/[<{/+y1>9ՔQ|uRNtt JTzk˽Xu
; ʃg㓵oa갞xmO_yK?=S}.9yosV@ S pNJoӣ{N4if/:xxgp>wƚyZ #Gu*N4"[
H7y &;}])v3)s¾_S
ixl ^Ʈj*\
fyk Ʋ4,
Q&Ҵ
/ L
˘ȱ]1x\`HVMNML25ꊎ .M&[TfcGǘ^ѕ-:d6ּr;iC/~ӯxQÎ慟EfZ5fz`=M3VB[2JN㙕x b#pcV<n!E0NچWX[9݅v]ܳU&LCF ] O/_̾ 2l
$1Qtb |9b^acGз~
֝1;f85#fbH.1S3x<W=o1+m[O^%z߷xb 7LÛ?l5ӆ#7Ч76c 붙`:R_KC![<Z5u^70Оknǧk!nq^ φwdѫ=i"erV -o\9Vpio|; 4 cǸj CeӺb18Gڧ":Zfyc O-ý7Gba|8ܥYC}-*iWfΘ GĬw2&N·
: ČQ(
B@!P Ik%YI HJ͠yK YútGA|)X8ڋZ
vsQ&Β6 t qq8x_Ϯ02ڽmFܙFnBd$T",dZgY28y-d?slk!093D<; K Z~Px1rR AL;*Ƀ| )\P_NQH # Pyt&7 OW4|wGg
2_NLDu-|h7ࡹcle98q8*;ӹAt8bYCGRb dψD; ytF85
Q S'7&<B>%ŝA ү sNDJ~ mK@W↱磣 ^ObVRGgϝCU$OR<
?F!zPG[VX!)ȸr
5P`fQ{#-\U ="w^ocNzzQ(MaC}e!^y^:0>#zvBU?@NZ"8MGhl}|h D@aV?A\u#-\%QhXÉ >
BG'N$T?$FBDg@8"8#,_;OmK
, hN O х0NG=ѯO/8ы)1&9%' n#(|D} !CAV* M(EFS,qkr`^c*hF$<y&5
!ЕB_q(^#|\1hvǸcl,?B"<ꄌQPL# āLxԒOq&ߡ ')T[~9kz\%B@!P(
vt] m*[TjEJbyvZU`HZ=е˷DYӵî ZlLr{d>T۸P`aQ|՝i: Lk
c-_sez$dLYj%gQlW/iylY{y/5/\[WBqg1E-k%s+Zg\M1$poŸƲ|j%+'+^A-S\&+~KUP(
B@!7!p-Wn{IXSLZϣgʐtGJlَx&uZ#?-d>_j-S[4f~D(T1!e,CK̓;}E]Ry{
&uظb݆Hʹ/q"ėj/4ъ RrYc*xq} U=57<1!t2lmo՞HYeϺL|l0vɫwӽwr 6Ǘ;J c r^p;T"i="ԩuytB6kZԡ-ezg˾ϒe9?7.42, |峬/<x6LylW]
B@!P(vjAgGeG,?FuO(~ؖy-itYt墭%A/?JmZ|3^Eyez,W˶=Ie^#ee.n [wx4\K]%}[咇=L%F|Ob|XJW̗, Jy,l䕷We\ZhxZ 9db"I ͵2mY[TmLg2o42ߚ9Y9-xYUϗZx[fܢVRa+ud5=tvaG3Q(
B@!P]
z l
wI4 _]A-جH%Dxz V*^>_K>\K2?qlymo߁%nB@!P(
B@!@
؎۞ * U{\5ZylS#|KY,m]1^4~6wK3,ua{V4Rl{Ľ-<^l5M հB@!P(
B@!oD
:qs D#vuB0zQ)+ܝUItvp 2p3hV8eS(id=5i:QL?fifz `YsxΜOIE M>~IRam&7?l6%{g@q^&2rȓwɣ5=Pc)1< *KɨkЩs7ݛt;)- (ζ#tMl] M竅mx>4yhLtY>Phə_ cFp44ƌ*X( b<[Cs<ht __SEx S̷e HYLaxQʟ;z u4i,0seb>w"c܀맍%obr3G(dѷ[>҆ɫK&<_`9WLOB>SL^Ћm1:x q9S2 C쇐JZr|Q2B|qnDb'00KPMqYb;=QI!P(
B@!0 m
@7eG
5_oڌ 7o²%s؊7(Z QJ+tv</)=}3Tbt_AK RA??Y9`CVz.#j_ו
'% jA+~q,ۂ,-!+wv
7O9^D!JsC%|>ꏟ G\I, / U
*5շob̤x`H)ֻ rb ={x e7)7?pd8|.R`&-DeK(m&\ٖz<}xayTc(1x<i,(SX fH
/$[bpkR92 +L8\Fmr v&٤|`:Y4g^&,Y!Q]2:KRNsh4UA!X nu9~m1JZd*߄۶&|hEO-t1:Ay-xI%sQF|Y6
B@!P(
ŝ NuEs_3" s#2
;"Khrr P[[G_ #)D < GR i_Dq]D" ܱ"Jm~v gw.,eR}wt^n.ӀB
g;
!nJKEqy]= oWۑJyy"vs3m3D'aJO_ PsW ⯻;ۃcfP0xW!fe$
Mb/)qaWrLؙ0夈 )#`č[A!Xfj[nFvØ8'N9(OѓLq2E,＜l;ҘDb3^0:ۡp F1&/ShE1}ѥsgRQ|z¤ ~0UbwSg1L=U
1qqoO!-= 3:w_O =U!-3.>A ̐<63yט|* 6v8ҸS̅| 4=\PYZlbGtow;jPYg a v
'˝
":ϓvX/Q]Ql8{kΰ1 %9
ޞŋ eMpwSh^*0 M/4VSlmޙLb 107y%stA`P0|r
ՐJ|'%Ƭ9Rz yzS]O s{!8I dqC%-Ј|z'y}7
B@!P(
VK*;{xۃ_7 _Ar)f&f3cʗaQ3Z-)wpa<*?K=@
${ RĆEJG, ( (Mz! ^7?gME}yݻSΜxϝ33걡r.yxITwGCؓ CAb_Vfxp:2SF<Ƕb܄)V5u֘<n z`|Eǰb 8cߣzDM[7=^|N4Lg[WA@F%";CNMQD?ud8c+3
?n՛$"
|`Q=I6i[RbӾFSlL;t p /ذ ><p;i 1m1o=+K!27"̟]? '*NgMo4KxS%%9Xz#d.ƽ9n<`N'vaWL%_'/дU; } c= p<2]}Q fuVeտNx(=O x{+sB*Hx
Sî;k G?xAʳ4p!,~N?ġ#x{c|fA/io%UgaCDXWmGVU $\Ļ5 %7h"1زvڅW}Io O'ӌǗO Ƙ!qu19x I{[Lzxc ЯcCD D/bثϣbN Şԭ_coV ůc?r r q,p||7p PϘD/J6]xjx(>GՓ=o
`/`i|'o{*-0e[lX lB{o\;5/6xx/xU "("( 6rs5ŭ7ࡣ;cF
:[I_q>!UIIJ._RRŵꈷIZt5P$bsE]iiUR2C =^/ĊԤDៈBJrl}"3+[\:&68$bO j",!JHWk=RIOSfbզ]+
p^-YTdI h=揜dA3fĭX1{+ѓo,j!xs
Q m!q)xWKE!No?Y|JaRK 67&џ.b5!o<" %bgEIn:@,6byxhZC<}(O+e %Gkpʖ}G~#/ Y)jHH7/_NR1!/1"-9QL[<0b(Ԙ; mKY1QE]bUQ"^j Ѹb#"%"~<H W]"-*:>=F&YYūڈ//7xvbkEIalD/qj-qK$FLFТlqwV zzZq+5S&RZ4_1Ήq/vϏ!2rEbXZb9Rޕ$ Wliiby͔tqf{ݾ(X~ L_HOOϔZZ$ dkW.k "-5U p%k\ig(z +WR%EJz8ke %uP v0c"#9A{Xg
kڽ䄉S"')Zԡ 1E9tLƉ
J
ľqRvݲCE~JxvvAՈWŐj/E)(ocjnqYA 2R11B})"("(jA/
?N:ZĆ_~Č 1u0rUuù3'T4-h<؋Д1=̪okI|swq35e|.=~y<s q>4Vn 5"S`h-lۺMSk(*l+{w|ÇۣQ!ν{@ro٦x55; 6g۾i 2rqqWzܷcպTB4HRv0쓆IC!ҳpUZ$O-3Ӽ/Opek|+OhUg8|l;oV`p,iJڎ\Qbe\Kl\'ns#xjn<`ԏ6hجz@jv6C!-[hZ;D@o$9z^aH-q(̹(pwViƻS 2e(+\=i\@@ YJ!Ib$_êCu
-G x9̀Cu Bl6dև<E*?0͟>_ 5ԸX?߭z~ # / >]AE>CM{xyڡ^x~ճ\Qɥ1 zvF-{È3ǠkVVN ^PnK9<w}to'!+ hӆ hIG k2hѳxgWВ0o;$%eȼ~ޓհGnزc7
B hv}Kg w7~k Owa F)7
=8;EۺA8q`; 5sx3VE yalc 8u1 t ?B:HY|qjT_"("(=
\ mu.0ƀǺx압X=ԬFFݵ U\>rCx0 @& *Lh֥[eim3 ժYiqZΆ?@ ݻк\Q4q-zaP"wЇk0r. ob|\ܣps܃n;VG0k,ti&4vf+oXl^KqA
LTV b[ҕmG 䮜YdOrȘuDe_A9
CS]bh
e";cQZo V6JE7lO:i}bMFд>q>!NWmB{fAXb
"v@u.¢"澈7$Eiֿ =x!F;u*BQ,E1m@/i
hZNMv5)σoXM9pciwl@ ɤ- }-(8 _<>zņ5ӌBpquIT8JO+?p,u=m^d/&Jd9Ɩ{ AOaBcEpr)sڰNa J/zh\Z/o
Q?s/H؛_:x{l!D
žGDt9ފƾ3\}ص
o@>,e-Kl, U/E@PE@P5xe#'e uj$ٽW@[ȴA8K6] a ~fo>rn^{X缼KyVRRʖf ݽWm QvsqUc1d@V9O9h($#ާZmtC?Fbh@e:qnoq v-[
)g)Q3l6:rhUhigllDٓvw0 ZO 'G@-Ph3fhS> sI^ p` l#o+ؒΉdAY'gwE
<)y
^A/creo#4ѱaGQ#ɬ~6;.^FAZ33襀wm9ښtJ<lZw/EtU{8.;1i<[ۏ@k4 i,S$*)tzZir .âqy8Gqz,.[%m)xZ8*ff} 1x8Mߦ'v:Ky!#ح;\bokHB9 o-ƺx1p
l7Ԗ,]}jke )4U.1 X]ݭf7iE |HװOE@PE@P7;l ó˦A0_TrF8xkY㘯',Z*9An/ΕTX+_0mK~i_\K `,k+)J-d 9ڡQ8c&īwƕ;q!3!4 6\i/e yi1(a-'DaԯѾ ]2ϡKGNyt+k逑IUͺQO.# 6mނ %Ab7ЮX8z` eO<Alie !Émز!>w 4ʡ[xms_9 +[LL,v zI@3643\JQ(xi@։]
s4m&v? ,Ӹ>Z GPhLFdts"6KU['zoa̋nȱh䀸5[PϦʑ˗ ]6!Xxtj`2Twm]S[T`=I8+*?L
/8SFJ,'iða4fc1gn F d(
[7ÇӵK4;2Vm**CTllcWD"wH/oY "t폽k` xd&0/ qɚ+<{.luhi<ShS*-}v?^sz8O=I_T M*ԗc# 94z>2
dq4mNmj&%#\]f_}6{ > M/ll_P硗 J{ ߅NZӔ }6i
"("($
1R #" m8s G̶;5Fv >Ax>hT.c
Yb4A rScn}; >%;CQ6[fkDh6WLkv0^ BZ{L42
ѾS4GF-(FqYp\ڷC%Or5n%7@mՖ oq G é'a]C^y5h-.zPl}~79<٦>S֥pYa?F5n5\pa\w5tU9$KGÊX!Z"̸-_Gk}к#hH;Gїӿאv_V\ Kx]LNXtnP;# .ni]6ЪRI3#yxmקa#GO
mÕ& E&~ @ IDATMGri&
k^ g CR
ZmڴA 8|]{thߚv#܈w 2Nw <֧qV
F3_{jX# !m,5r/hD e6\'~G hGGYKzІuԤchrzRq8ԩCdz9ҍa:عZuALyXuujn%S֢זǾۺ[
CǛVǥN6 ԪY^EEA{qaes FU]ցx?uNxO+t;o
%*t$ -43NG5l-և yiu2
G)ݻwǾ 4mt OGˍΪw!toW5zbZ"P=6i
?OˑTߊ"("(Ͷ
JҮܴFΌcLhr]0ݵXl*cN1$rR>{{c1>?N[:
\-HGZ .(g~9`)Wh7Ol;9Yꬕ+_o]fzH lـ26[VRnw>5 KxM</o ډϜΉ}K䵥ba.[6e<G ,,t{ӋVto/i-E~A! hћaiBZaC#l8N8-tMe]%dx O9FLCPE@PE@C:?P9ܖ|H5?)e)5ښ`-NKJhY^'=x6ZrkT_U7&2˩1v"n6q=进ܿ&q܇^qcd_ZO3}/BIw^3YȨH r{=^_~l"B]/ww-E@PE@PED|7e.`ЯfJSef4IbzL9/ś~p>g,ɲ26djqgKϫ2~]l
t)+Yףl(mejiu *YlydD]YVY ]g]7K9m87_)g 2qלGlsui%d-cDYYs
,ڤѬYgXeu}urt٦oc,^ MrLsГ >MoKYz[
jJPE@PE@/]>x߅g٬w}_FRG9NǷe6mfn-Lь4] œeyۜ k9~0+=&L %,ucAcrX={=D5S("("(?j
vAWr;
w*/߮QPűP~S~B|qz f RZ\qUp!2Ky[/[> /m\͕f"("(_I:W ,ckۋv6o+ ltu3gfcMoik,tKwt7Ac 3G \Lx]qfLbztZݔhԅq[yvM<8ɼ2[ӱeHH 7 ?xЬ6kb*S)|閲hWZ<[Su0G3C.Aϯi.
o87ޤ,#=
^T0 :̓v
M'<o-
rg{ qC̴[H)B`@݊rNєx
9hڰlnbdOeJS Ha?mxƉ03 44^"xcSѰqcv'!ez(-'pe^5 ۵C\ >u0L=ӌz۲ eS͵<ڌ@-F`?4(Bk-z\ov5Oo#Q>XS>|ߜ&e<_U_VE@PE@PBsM.whjL To%Yi0c+/Se6m|կMô4v n٘0.mϤcWӰti:{:% Y' U=\:Ds UmԱ0rX'Sn`gٽy<W{Mmkp9ie$IذTA.C$t5O+(CbNs? f uo4o1`ءcO_!J {ҩCqJ.Q__ QCë8D#rs`eH .$qSVQG:ƧoƼ1qu5
ӥn9=3%Y<ft ǁ! ˾aĀnxt++ī6 f1Nta薐JK]\JI<:e49 7Pux+^~e > U]_, epMW>>38՜um,?e s vo\C0i̫p&Uik-zyǛ9 ř-[4^-(E,_IcYNGiT,WjVh("("ܓ@e+8S_~ VX1tm5 gb~A?.c騦<:^0L1ͧ<<iƝμ<rڒBo
;{{ۙU*χMp!r#Zz#@j|4&
fO 72QXTLOtV3nogc26J舲LJ]]\P\όLpvv%ݵcGlˇLёkNpsu/'9~бmd(yzʶ1O%gTy_8z Rнk{8>hT/R2h33wW'N7Bi9;tܜ-lm7 (>`ok{V| ˇf] \=T5<c܇tt^. [>ǻ0 >>你~d`Ɛ(ٻѡ-Վ[QuƲOүEF;#,:PW m![8`0hD<cAau
[W mGz£R0t
VWw>D _TJ3F dZ'H%j,.viq!yg>>eU6 <nORzq!a| =>ni )H<SSSQd7 mMF#
DS]v䙒W`/W2Y'$ V/C'a؈noMӀ :p}NtC4BuOo 8j<bgrP@gK [&Ƹ;߳XrւPcE gҽce/)Qt@`P"B:њƪ O"4npƣ,/o8pJYv}-NWWbJg =# N.4.
o6
QwQ5_@=c6քXzt/o_҉Y
jGF2{7 GIaCPE@PE@
&uQvu8SFĂŭT\ɽ oC5n &?6-o~nu0j04 ;/͢~6>2
m ,3X':'Y~S U>VoaH:PNh̟;Q zؑ옏E?|F# S>&@~c(-r&~帛d<KOvU~:~]Vn;
*G`k}ޘT%bXzIGPQ=z/*.lZ bh^7ȗm/,<PENxh0qÜ[hq2|]ɦapeL7}5{P/«oG(Iof1&
ņ |6ulp!EhP z پG?GVQ p ر;C䥝ްuW,Ƴ}{Mp4
u:G,mfZȺ.~FHOVd(&?_7Fb T.8wl>$ lEUUL`<zk,
NaY\Hc& m y x 64οǕl8a(|4a.S Z* ,Y 7:}ka;Pͥ u1Úcks%4~23.GX0\ & Ʒ %dvbڴ@
&ǣד5';#Of*X8;<3+i]|o
Bu@oÏE;b4MyZaX0 qcGc3@X~; #wmF{m }i߸3m0ܣƾm+0nܗ٨
ѨsoD^% p+*%q:M?d&^ ) a+I/hrLY%ycK(,.A1ią{1s,w9+x hv|+4N^_P L|^@%w /0dĜY3L ["n{2#a˨^KLĀ t"("("p@YMq+$zXdiQgdy>V;Z^·bɯ+ʼnSgŶU(.HzH\F |C$ed1aV'41MYRɘdYmb(C{6߬ܥ)QZ L -B{
)yVycnqj8{lx9 6S"N1oNE bߪ Q1VBXx8p&/1h d* mibvBEG^/Ƌ{~)39Dn/gω/ㆈ>)v 8$]"n&ĈΡv]쩣bhp;_JMzRTI\#mE]wŹMgk7ťO?$R\O=9ľ{SQ"6qu YEN$ENJb=ę'ωI"\(@vo 2/o5E\,zD?7PLYo?+FO_ vH\yɱPhl!rQ7߭Y~ZUP=gINBS 2ēȓgĎ5$ՇK;)7uZ|>~@Drn(μ.^J|0g)9(:@-{T|lzvs1J̘ՂĂ/G gϋL gq!H+&W G"!߾Vn/^:OhězJԵĢi7O* =!n fc?B,[N_[iDswħ%];/sDb|^q) * W2c}kE=sJa?fLjYlt .ӑbϾCjlܻYT 7 m['⁁H97E*migo<,k׆B1Ѣ#DtLNysŅ"5Ӱnf-N]',v 1g%f[$#l\!HI bPg/lEb7ē?WŭϷf.yld?Kl*qyQd䤏QMa("(" {Π9c͂? 1a4FԮ=hH{MT٧\Lq&|9 ֒~C6Y 'Ώ@f51~L4䒏Oi>NNqtű=晱h yp
Ī_-/#*NMri| y(&4T33p7$ \X@s3dRLFn軀4h m\Q?FNo$)V.Ĕ@&Qeo1ڴkws CC@[oJsr?ֺ lexT#̋oa+\B #1buFu?; Drθ~ Y՞&"T6a v2]+nmtl&sKmMiy K}/ ނ_/¢/!#5EZnXl 'r_G&kr y#xahK .Ϫn:eC lmmKmXC .,G@ o[ -]Ѷ3 2Y
y%-kktA }`O z,ssV /NCZJJJP!p m[ * X}>S
' ZWߦC麝u
~5 xph&8OwƮm[0ǵx{)},8ZN"k@Ahݴ<|w wRÐ} sﾛEDԗyFF!7P(l1ֿY@xcpvxdԺ/w[^$f" xc ͂7y=5$=u RҥHxXm^ QghF
BwspZoKG^?fZ5 ԚBK %|{܄ff#*Æ"o^HyNn@ NVa-`~=ۓDZw<59P:v4~1 /9O E4I4aؼx{p_k6?t wm<r맍(䈽}juOE@PE@PE$ 9-=\E3?nڅ C-E Z!7!A78C=ivRhm[6yѐC9عWb툊m{0^ҭ֍ќlzOwhC <Ǻ5"_2k5Ķg'Z"_ 'w<;ctIDDX0j5h.FF~1 xrf~]ԡ5x/qzJX3^+ ?_t={O]D6u\Z#gV,[ 1nr6H=lͥuPR\Aj./ ^Pj(VX N S^]XuYq>?֒ ]DauȤvqFnbEGǻb쟑HFT-=]5dzInԀ" WaoXv*z 5q~e!6itn 띆k7#vX' NT)st_<!e}{z7 cT419J3 ^iiO b4_`@]@\>
[3<Վ^P:! tigz"/GCj!;vn݄_D?~ 8
d۠nXI\M*l/B~QTP`L'cE/y494 JlzIA{*_od{H;USh sGqҺRz ¡z1i^P*=#g/^ %p1~*!~ Nڊ ՇzQ͞Ri㯾qqPxG~BZf1 ('˰i3i\]/-7Uu[9Ïc3q^<?9x愙Ԅ\ˊȳ% 6P_c`W~l@R JE@PE@PAX{ 9@3ώ#jNEl!ܞ 5˞~; _KȪxh YIj|mه>{cךڼ.)σ1| T
n-x^ˆ˯F@ Y7݀qسv+)ŴZ g!&~-Ο A5Zt2v*@1>FlE :< AVf~=>acZ; uuC:?_li7g,B1\4=y(Ɛ=mgo[No} Tv%c2/72J7jG3pztx"/k>z%=S/m2 xr,@m^zp |3 G1\B3O@7E /8Ͼ;ڔ(-%O Cj^XfIŚ3Nxz ujQ݂5)cԉD6 e s H
mΛ> @ǞE*!e8UmFK`k`]JF<+W 0 @S8;1$ 8и!TA 1(h^Kc 2x*I[lJyۆ#d'@Pg/W x7UH/mto-ά Ihy۱n49q JoMC`˚RTyӋ*$ٸ3Gj#{' `.|^%13Ğ;z Af xrc,K!?&lh/66"A+o ?̝x<sFaesW1Jc ls ?z@)_GXq mikDFr
"("((gr Knf
v'7H9"ڜio :m偾2 0/ch\:n!Rk`>
Avp66C:0vl]#MƳytfF#ڀ.8w6
/_a35~YXe?
ږ\WOڅn
rMhGk@?xFa#싯sCNd9W*=#66{?-A.ySe6 ;yyV;w @HE]54ʧvp*"ڢn#`֭[ϦM;EE?gƗز86d0!2̭<C38w(fM^ a~)Qkf4N )=+c¹ذ
UD.ק/];-:c`8 [ZL J@3ð1\~D9?A
rKץӌhȢw93ػ74 @KI< ͛ '3MF۴
y%%; }.sX:o6w
dފ&9Ă8Jܶ]}n4l ΜC'^}<y8D\\ VG/zxm$h6`KʐA*Ҹ^Oɐ U =WǮ(]gaϢz+HٰwBhL6v2CS_l\d.6fywyl :Qgqxݲy5Gy/8(:}wF {鴡]
mp@^ist6rGZbAKeN~3ūH[ &O<vhԍp]=w' LFK l@NP kCCo硓M`m 䑑t͋"=˷ 2Յ"("("p76(TAw[NOMA5 h\O:ú,r}uB
H3 ky,] 8tP|5q]mʩF`%Oժ(v ғ0ga,>>=L>(S"\kTq4FڌbX[ ً
Zj&.AHz3fǙ'wQ<5m<ܩ%rb1o<}if:`<g
EyKgذ BbF>uip4Y ?/\d5Yr]rٯ8s-M7A횡f-_R{ԉ /kj#9%
>hWП hڤ|L>ȌFbցӱXhԾ'j=ab<u O`ѱU}Z3/ K k73EC0u}-@7ʳAd≆ R$ق3'8 ի`96
M5
Lhޮ3"Bk;F2'O xpr<K E/NB"f0(<K# @oOnӜHzaq^Nk NHM<i}4)ˆo 5mJtV}}+m)8 оKWUĭ[9#9uitBjJ6|TGZt4X%C`媵|3 [AQJ6.^.{"!z :|o`ܟ
-H&hڰ BJ>fA 95>GK68$ Mh'tצרEӀſ cD gƻ2v~r8F>Y C}gB笯Τ#3Ip"xy;M[6;Зt^^9BUCh0,kޮy4l{:;jE?.|u
sxVQa/>11<~3۱7 Zt3{a㎃8 y nKNL.#)%&:l]hF+r^n4
J# 6BM,^ϜQy{4YMwCFuA tѣgQq;ZV-I')U "("(@ȣ;6e(
JhLOcQҐ C!5&h
_ei.eй|VgjWr*ì_Yvl^&m|0vA3Ғi/:ח^X\dyw6A[C\ϒӚLv^R%S+L 捱ҍ{zmh]ܥ{eBy5@I7m><3t!]^|mh]6_bvu v% | h\=im4#|
:,P{ΦsrȽ >t3# 32f k>=l T)gA.3e% % <NG9!e 0Tw>iK"LÈ 甔y浛'I\/6/
Q->x,Ίsg h9Hlj[Y ׀0~1A[re bdA t\l.M4H6gxb3Ǜ
FZsϧan+-p=\L iL". j"Cx
>FA!1璗Zg66I+q?D͉^zpEĆ[-Qح-s{q( ?x`O5vg}y<4کt_~/c$+o ߧZ9ҋڭg`j CggdfSΨT6PϱOMM'w{{xў|F:φ<LZ y<MB=
a:S>9@}%yN_3ZD /0&/E@PE@PEj$ߖלA<l8
îgt#/9yb+J:IV6Դd-^QK] ,gKð|Z./$nÉfKIٸ(+iV sp:U]db d6^iRo Ec&=O2|c5dL{9^bei9T^f9ej_^^';]߲n@rY}eU^^YX[r*~v$T 9ʕu5~Zr`qiY5g14 i2,A r²Mep E@PE@P{͟ؠ5=-˥zzY(.M= Ӭ'LgD$ 4,y[y ;<,qFbrh5d#AkH5G߹/l.z}zlN:k]]6 C31p9 NiƂl
d , :N66t\ߝscuXٰhcY\dbS|em:E٘5E0dLR"F̹b6WYGSQqX>Nk`*ש5<ͺmL2tz[[p[| L+#d2}<s_ 6Cx\r8t yz[FYZL~Ah mŲ ۥs8^Oy*$.G}+"("("pO^tlg)G3*]qSE@PE@PE?@ѱɁgT$omgͳ9յ"("("( ȿKc"QE@PE@PE%3E@PE@PE@P
g(PE@PE@PE@PMomVE@PE@PE@P,ecF)("("("o" So*"("("c ( 5J1E@PE@PE@Pۻ5ҏ[>("("("(w'`Eg;;l߫𝄪xE@PE@PE@PE@nkߞ@gƍHJJMEeU"("("("܃^JJOfo3-'ObÆ
`! UdE@PE@PE@PE@$nOGni{(R?g\٩薐Ե"("("("pt# w,u~ǜ*APE@PE@PE@P2[Tnr2I]+"("("($Ps]]
t.X_^X}>6^o?Ȓ;>,e뿗eY^-?̽W#{Qz~Uߛ~S ]([I KKPE@PE@PE@K XҕpE@PE@PE@PE@/@/L*"("("("P_WIWE@PE@PE@P2 ʤ("("("UE@PE@PE@P" ¤2)"("("(-e|tE@PE@PE@PE(0L"("("(_K@-_%]PE@PE@PE@/@/L*?⟮OPE@PE@Pk*%`eeu"z*V\%Z :} m1Nl4ae;1p? m;ᏖgTl_-Vr8SAغ7CH"-c"] u*0n]w?2KKY.eAH|tf5Ce>{s~fm0r^Iv~DJY?&%OPE@PXG۴ $p3=WP/ %y'Ys3-/Ϛ
Dw?| Sרjŝ|]cv*jW( w\TH Ōf?zƳ^!lsG-_H ^D]T4fn弄^>E@PE@ @J
%(**dvvpFHH,N 6D)n%^ɰs@8ڡ%mRɠ/Ps{zzIQcbU\-6.u1*lYކZ |;ʢ-~p<Z?Y4֭ml ^zO{u:VwgE˦ܩ \3Rn 6>4 Z:ܜB
Gs=דp3).ΨZN6a~mny nfb:`gj5$LK\uٖ\ o7Jt1! X|O}z3ҽuY%^^NT[HٹY8:!?&,QRĸ$U|aG7.x>&9-1~X2JK
pU8{ 8*蝙z}zY KPT\+kc|lxM9nWgKTx(E~aLwt)GFTPV./2t./,^,Ttr a@b| 3А`8ڗO&J4
=Su<" [kѽ] `K|&ABPE@P' 6ϐ$\>KV 1ϼ4E
Eˇ'eݽ\a-g`A tU(Dzy ! UxQ@!p*a%q,nn%= 2кm{ԭ"u1ƪъmCQn͘g-ۯ>`0t(_L;˹iZ egu|8iJS>Hxz`8۳#!VE? !hס#GT! d#V]ԩQ
VF/]_}FXO'%1OEq偺 C+]k2ԿFdhzX 2 '+>8~ b̺QqM! ֻl0#~<hCLB]<ڢǮ,O2X
!3]3/"alo?:Z *%X\Fg)IsK`<d8MLt^6<37(TB:4y\S~pgq% ]ůW,FizT3>}V`܄dY?ِ0Ca>v,܊'GI1|LWxXI&ʫ[ڲ VIg:PyGvi%5<}Yϧ}3ҷ(foט? _'J'#Y8." +3).] R ͤԉڑrϪ~{'B {]{Ǖ P]( {{ =gM;Μ9sr̜ŗɠ1K)Oe5/# ?v%n13q##⬆Zl[?.i9h;:w:' /59"uL #E]3sS4
CwjNr ?:SF{~\XuKǕw>o| >03 el2lS4܄QfU_䗼8K9 ::&qmE!^w XJ)|aUČ) Collllll132Z_Ia >KekY =@8Z A+B(Z
4arj0$ ޞ:W\ *[Ͽo;:~:#KMhu q 1ٙx-yr .Ъ|ND#K2X3-9*: ̌3sZL|s )ݣo8
ߧo.ـT)kɗ*݆I'sΧPlKZN|+
3⦸ˏjz휎PQ'6bJ9 x5ڳ _]fmȣʍ4[Re6P5 *?
ưSm1x }UR++WZ;[R;ڑ/ @ IDATAE ć|ltY9&<qƩԔdNum)znI(3/NDT`IFEj~!rVa㷻NP)CfuH)ގtxx;k`)+!q`qX^TԖxn8L#0Gj_caBZWdg1w#Uv*L@ DIy7V^? zi.Jǽ(TXj 0͙:$\;e\]%gSYqg]q>VEG/}c<j CR_q7؛D)^KyKGtr%nuJ~aAR3;nȳ37#~HJ> o1rߊ'gPgcs^ # wO µ h֫.d2jq :*K
{^ z+#bȐ!
fL9r6**ՠ]uGE=3X^{~%EfAJ%SsAPG*t]2 3NAt Ý>l}I)ݪQfY(-<|е{4z|G/G!+e,=9 9(-)砐h> AyczTf2THG Ms g%' !5 `*FDJR"2rPUS ]DP`8;ҊxӤ?f ]
Hk*&7Dv$%¿C$E( R+lYȡsq #UȢ |+FuM-Qu' v_ $S OѥbXf>^*))7#¿6RY2z!-%UuM
%!#=En]"Nq+,5" (]F!{WI v<7#n;U%;o ? *T=ry+- 4+9XLx OJz."ɇrJnv 3nDHJ*q!FCGY=*9()b wWX0ݙ&ĺ2H^Vf壼)8t[JFUD0|R҃]/tH!P0pd/Dv
ܜef wtn;!8[ WEfPQ5@ޑ7jhj@^f
V! ,#PCUztX^º !SNP.&ox ?O
kь4|qnq dFq2 ؓZ
!( pqsJnEq sUĎQ pwyY5
!OnHOBNn%Cfw"+ {D`а +J*ǒ^*אN7;B,k)V 993Tہ{д =Ĉ!iO:Xp &r 4L%Mk pxj<j8"3vNݩt\|E揸]0w+J'? > BwM`~b
>X|cG 5"[MًCpq@WkÆ V݃nIilrA]0t0t W
umu9RSRZV :x堲 2t1taÆ"4ľmq*'Rʾ{ т(SBl2<ĤXɟF"< lwyY+D@h/3%وޛag7R
F@Xٺrݍ<n:b0ߡsv
g_d[U)&c;TqMV#uٶ_M{
LeMRE#t>nIQD9)CZ \_lUYרf%XqU3MMsH`owXYZ&X+f&Xo/Hy[-ͷzWXם^<Xs>*չY*϶
j rRWzUVJd7H't[_^(Ln; xz䮿+~?[j)
"Өq*fޮ m;[XdJ-*.Xu7``|7L϶f?-|vZw `um VnzuXM*ݦC3nTtUM,'mOrRnqQ[g=vxE 3hET*|φyw?/oT)~#ǞaUU'u\kżE <a05^Ӭa<gPVYsM>wa?hq̴^~gTEk3ujW}i*u-sějbGu
Y)+YIXuywcPsVJ
:kˏOzٚ@@?i}}"ٳzuǘ#Lo{
vV8|5 YsκN;#+ؽۺi{H&k5Vwe;{`;Nj
gO}dl.+֚z+*[ x|~z쑟r+i~ߴz3 ]0b;2%V~{cS[}X^w_uٯ, zcZʚs߇Tk8y g şjt yUOc?έSoW_]`=vg߹~XaMAkT\f
wAS?]VM]k* 5G=F]du<6gϻJ-t*]}y5)ZV~^$ӏ>}eØKmqo߷uu%SЬbNh.!+6POٷpã)ҵ;7|Ssu{r~?9ouit=ם:݀p<_d&j=[Qn}J)Q{~9[\]! kzRڠ:ot[c|??[ bߕew+yXE;e;V6_ce([fF.TќYzt{X+30Q /o/ |رs'vJkf!WJ7_(Gf gjѸi:;;1
= ~My3F
-7wi̛ꟗ;eXx5sҝ-~K `W{O/X2<~?=7Bu/A۽G j/>k.ΚizEǸO3sxRX*o] RÒ5۸O^NdU txxvzԧ ̏3_?`s.=<_{x Wp Bip ۿx 7>RٺU?cɊ[f@jdGn LU{hGEHZ5ʗ+e߱n)}etĻ`}XB|ĦZʏ1uu
iW܁ӏ. w^xu\8a b-`ɦt\|b%>z}1cOս?ہ } |gCVWi{'lAqggcIJyFa wD
膏 ;_f ':#jĬasi$la=}ǻ~Cy-;Q=Ppыq-|>Zd)]B, ?/7EWs:2sS 4ܼlT BO|/"fha_i^S۠ҕ v *O5%ض UhL*~z6~x,
a#X#**/; }6g$x0EmzEsC 1T=Ll 7\1=
X.IcM %_ Otp<"%x(3ύ XTjĢW`ʫ:~{~Yx>&¬÷7PlcA
!E0B8R t^= {5}ݵAb&K߷tuf?zƍ͕.<wu><v]=(Zхrk!"#ϛZ,<qB˸kёs%m)WeUYw]Y|<s;I[~~4Ԗa??xZ%݄I 7o?y uӞe+sq??_rv
xmxopS#5+[WM,eW_ bj:ޟ9~`xfvgQ|fhCPs n{e$e!
g1j'xP͜s' "bd,fϚ=^>X&)
y`sao"GZРQA;`hO>b"{}nz~zkg] 0Շ2ibOxk0O$EIy9**x괺lw9Gǽw߅.KRm~eN2{ݰvv FDRjt+Ns\:wd#\ CP' xyy(ykyE,n*kDN5̫˳1k6Ͼ[FPkiK^Rt|y=18*=TyݥƠ RE4GXzʾxqN4O T{FV J ;oT2zLcm-߸I. ?/~
I00鬱\v=QRZJXA4u+1i
^rFW( 3]I^Jq2`5Pazط
bFuW]3ƅVmp]X<,eI7nd r(#/|~ Oerz/n$!E@H#9z=ASqѫ/ F柰5i1aD$ξDd DYY*k j<:9{1?47tpV DͰ+ ~7ՏrQ9'<F<L8+CҧYلZ-8E . qCR54 nBTjpy=X.(/T玃9K )i7, >^BQE{O@T-tyd$|q= tyJ2f뙉~N".;+ň
jϸՀMq/M Qz{ SEukCJ⹅p 23~A @w
!%!'G?L6v."%ƻޙW?B]o1e=)kzؒp#pţؿq5-[6` \p4&y.o]w W,Zw[FuPRHCSu*^k#ԩxx EM斗س
T jkeRWM$Ȟv~!fek/> u2{@UΏ[YT˶+sZ=ŧ2NPs-3 l«g}^C;nݲyUsaPV4 ]' d'+)
Q*^:E ]+> a>OI6o : \AN
~^mEg?r1bOK) _*tO$lv3mA]z a4B{^}9 1M QI̚_!#߇Y
56 }Hde{S cm 5L!62Njf7An܃(C{qP jgjo ?fj|k*
sNSAdyxu @r # eo>sxwI'ӡrjL& /5zK1&xGLf%_P)5Bq`,d
2\)璦݇MA ,V} >ԃ5#
?Eb0z遛쉵w> N9j Hر};v& 557 g8 (+9ʡ0}\|ۘ|tyTnx;] 2wvuс*7oWAF?'uyk6a :-S<t"O?
H*
4V4& _uH~J ?ɥ+9Ut<} w5{ᛝjZN\ MɘT*M%NY&AE~eض=Q S?D6*UT愃fGVq_co7 ]VV5yvahz;&K:t@ ]^ŕN2U`V!)zq'AmIB6S 7qx{f#rq ^]"+ܯXNt{B苜rY= 71Ep ݯ4\NG0 J^&[E5Q}3u]=͞`{-<9YC :ۄe
ĤW鸯u܃ϔX+*YZiSio?'KlDE(?``uxa>g _
MxrZ8I˞pu5bݢlYJ^)T)S0~hOb
$3\Q`8idoDžA~eRYfR#hl\TnIe{YJvsG
OĜNk7Z#/i (^tĹ<IFUcƴ{0XOV ^y<4m_ # Fr/> <I&NJjΧʓ R_/NsחI3
~> , gy4prт b ) qGY*8]
cЬLH@(WT<4NFkv_saqΉobLkC 1G`lqI1KLi4#7+ul~<+O |hA Wa+y;͛!~2_㧖 QîM?9@|`.8u$wؓQ t REˁ h:ڬrXʌbr"1f*5V1Ճ~_7 ;r|
E]2| {PbBm6"0j ?NK8zaB>LyJujZ~q(xˏpY㑺w- 'BיqnA4H" bVRRRB;9ѹwƁ!x۳ An1@Ve<j''X S99Z{f.reM9*}*-ΕF)V ,mQĉ/ߖ6uA˯KK}Ǖ5]oJ-8] RI |t ;o J3oh4-F-NE~UST/ _W7WFc],Tc+?MyJaU1)VRԌZ*Ҳ :Xj-Qz%554DaTL]:c Aa P:JӹE_0
.n>$.8J#4;^1C/ r.L.NƎ݉xiK!d fH#RGQi6bb*5i )w\W *y [@ i
/ ne;eq3& ajQn .`er5i| tzC
v-߁P{+,RW5
"e͘, o+/Dc4a^0h&"_uMng _ S"tsxxcϪArz *]aI]8ZeN-LG$&v.,'~}~C)#ΟM~ ql 7qɣ¾P>YUNKW X>8 ttEDpLpk+ : :|I](edǖ x\ DK.LTCB%5<4Nsqޞ:O, nuh4'QXŭ_.\O?QEq5UK@r&2bR1N8k:Cyѓ+nM|O\G h0t.6aطk3VڨmWR%Xgq*̞iɕ|MA|qbpFEFCjy
o_jَxvK\j:,4p ֙f7f!~X4ݰ OEM:l
_~/9\O oo}4e 5~-WtE[| &&&"!1,:e0BCPIGs,zy
r <ەiڏ5L]8SSx:u)TkWϫc';䀛΅Es+|;S0tD\wMʿ,(k [t=Jn[?R_عc+~;Ox\~; ][ʒuD@POE6M-E
t"][ݦxCGFu(:Rŀ42 -fmE5J6sa@Ź yɲRG@OU҃%؏"ѣOUp ,j Ry|.~iy2Dr?OO.s֑\Nܻ) ,;gLRlDɉK! `؟PH#ogg+j)~]y)6.K{`?/:h LTe߅{2?n)A? I;q ՙ5%HC
[hx$ICj!N!ʖ`.]N~A_7G P2 ذl?$"'9 [V$pA=#f USݷQKJq9YHNJþ+?y;Ow 4de{ 8~%Y+<hz9f4-س{7R=ڳSslc]k!cr0 rtB g B'*c=OXj36 blh?~!_ZTϨ<$ҢV8ϯrcKKT7 ;[PɍlH>{S]Ozf)^zT-'rQ_=!$š :v??|qi쇥9D|wДm2)fѷXu7vmYu)?9A_&:FD L" W\Iם9cLxȖ $cES w@M=N?DNA.zKWIZ&mlllll2p ӎ) bkZ)z)V;ҭ-+ZX?ߣ^4E~G;Jҧ?ߎHwe+=" hցغ>.M'(ͱY/>麜n%+U{߶9Њ,JspB(Q|98q tvS[s&Y$*چBk4 {Zvu:5u>wى;S}[ӼxpWa1V|M\"OqrzQcx2Ћ:
/**ͦ{QOBNPSf}s9d}-]m &%yϓOS]ykk-9Կ )њӽ<@u֏+Su_-'^˭ww7ݚ{9~KT}?mmتOOInmQtEG<|:I~'eY.XcxR< ?d YI|>_o]sɗVN|ۀ_<p|maߚVngc
*L~ɗ
VOUMĕIC$og]~G<}^nQ4Z0g>O
RO1-Sz,s
֪+0ѤNzMúZǥ_u_Y4YNƿkKi .Νڹ|u*YOI _K\K;l}hNM:TX?2:~F_Ϗ oS[蔬>LؖFe}qU%sF soIo]fQ?6d-+܅7q{Ŋׯ~N/]| XW;tg?h8nlVO QvS75_\ٚī<}jwo;:O_@ڕ jmImGp|Q|9>7&8v:G{N0OJ67;^ Cd(߹kmT߱ndTt xD [18Tle V߆z >
Q~<P+ {@`˃ <1|0{\B0p/
?>r8S< ]d;9yÊXM~Ֆ;< HGO(B ¹=^g f05J=~G|)VӃ- \1LN@K : :y vE+.s |ۨ%]_ $.fxm+ٙJi1G < 4)ɗp9W`wl
K hnܫ@_}aD9J G\W߉CNF:MJiJVw~C;W F>Qܯ?'5dq嶂ߋ 4n iFb&<nZ~Bx8Zd :ȞC0wٴܯY\uLwH,w1jP\4 1K{a̙7ӏ#;7ߪn߳F>1vKp ο o9߲ _7ɋ{M]i=ٳ)'^+VQ};o;0Do95UdSFq;"xp,ZXW_C]1zl/wzkqdmD Y(qziX`, ?t=nKs~~ߵBmJdd݆e]& ا.0y%s
\g
CJA m \ ѽX.K0䤡<?q6 ԇI>8㱈ߠ- Ą+GKC
t|O<y*Fն}~nU\r[F :R%^1΅^r E Cp֍Lb)O*&^v*-Q Աw 1dL?yOh @]h/ b
e<?EPknzs2r t֓"Ciї@8^H.(Os!qn<A7ͽ߃Q[VzU =C'YNxӢ=${
xt NL kS Ly`$/z3xB Wb=4,ܽU܂̷XZDb us ;5!08ݢz1#'-[rΝbftWco"D HO ξ Kېz^.sxY ]t-V| 5[/_%uHL`?ޛY:9 0oU,ߢqr_` :Tƞ9t ^e{EyMxvBqb_wHtoŌHX\j5$O8 Ǐ nEıoFFFFFF/ t:FhdG ?̋ҕU<xI? CHpxC ƙsz<‰}:3Pq} Z[+~M q(k\}r?
yMy8_LaX4zµfrb-ދ r /{ʧxv4TYmIA!-ʒLƨsu~^9X86KDf/_u*r[ Yqiu3gqmZTs hfXn S!\~*/).[5VQ/K4٫{q?r%LGSkF=Rr;O!t~j_LsW>`Z)/&&$#9JٺK<@ b>+Q~/uK>źUÓ)AUJtUNY9QTY!}p 42:lOKR.P`]QpJ>dxlC Mu5XF.s/O}x:F$vJ,+'yi@*!4=ٜ[̳<X8 B ;b턧myB#,d;#"_-N̘Eʁd$r$?9 ^Mg2ޜ|)~x8H*0 <X Շ0CƓ<H^ }̛cڬ9կ|;⤉ýs?gG_y=
GS8~Dnٙz'uJ\;
c[~Pq-9SC\CJ9@w;8seIZnT m][4/NӰmx P[
.@ GNd:QA3> /ԥ+!mlE0[$7_YB4B;! S:۶m嶝YG{{}gWcGGNyhx9ys+&5?f
0Q"`7!PkeJ" ۡPq0:-M iYb{=C9ll{H~F.I lƋ
#!Rz8#!R+w_Kcg:.#n{8A8ʉ__R$uY N[V}o_ɷ$U99mBV00_\E%O7\ՋIac_9)ܝ8 0J8fҡŕ]/ *5r'*d
cxbL"uIhx} \zJ 5[29y5)1m9<Mh#}al,\SI;2 3/2`'[YUvM,Ֆ{` En[ Ik䤄;o n7
k kZ2H]1`+c~iyL}x͋S b3%tɇ`RfE9Ո G"O{5Gy,朋D^O9yRjۓ#hk 鼵|g)rHI o z 7JtNf,<dRKJ|8;M#_I WUY)? . /ܭZ,VǟS阦PJtnO~FPKpZm5 b|-~6lGFFFFFF/QWu Hyu ȘЊs97AoљxO;fͳM r]x|0 5ƻU|<",c 眦?gLykߡ|ɳZ˭,a)
3&N[ !$.tYF{ã},td\{LJGVW}q<ɽYݵ_IYhynR1~k=)Ru6 ԴIY^MdmΣ}Gې .:yiE WNT6(ZT VRX: W;%?ԓ&'e4JXp{ 1_ "C9 JќOS ٿtZcےoOlLgoKۚp~-: kL5mKj}7w-:hn CIC [KyHE~cמp7s%N$%OLСzG<1t}86
1[j?
u܋"{8G9"?.V8m66666>cnx! c1QQ
J>dj%uk-o" mGWh .\q7F7S;'l'g4{c [A?1n+Y`" 6K#!`+GBO#s?[ASh [Ao FFFFFFFFFFFFFOEVTlllllllllllllGVS?n;1q}mllllllllllllT t˲Tallllllll~&)llll91W666666666666(GUeڱ+L ࿋> R{,
#^mmlllZ#p.{( >L[&RG)?7w^jǂRf"Lqޙm9 vܛk[ &=o*|nh|L~&e˳8G?tMy6;6*1r=i 'WqL
*<M7W;Z|̽3/'W#Tܛ0C+~7~Bw3t%_9ɳs|ygTw5-~<e0t_d^ax9mShw4 8ߛg\B[YY!C`С*Zj#`#`#`#pl#pܹ3{ ;@ EEEpx t5 z5%SWAXo۶
=zUR^2ɯSo^ЩSl~⏒M ƠA' :mo%%%ؿ?WVCkreMHLLD~~ U
m6666e L ;vT̀At =K ~$IQKyy'B?[Ϟ=U W?'H ɯ(;H?fFD9U'Dz3 ϚVe9*~8VڑJKKñ\'lmlllQty ;*,a @jc#'BdP)SbrH¿mHd*oIK d&~"<ssyzar$+?y@:m|γ- )w.=]Fՙ o;p*KpԜC y)?ۓIdQʹGOAU6/z&T&$i#)*li~rmV=yjXzme>>>||˷mMX[-LɩkHmdɗ(mU&@om_)>o=bG 0i I; @a+zR0w>R$}X%eX&mg#`#`#`#X> @ IDATD
dY^(楢ÉF,/s* 7a; sq14b`H°\ n D455r '|ɠL
0ė{E qBk傽3D~WWfxJW*{ &˴=NSh,j"n(I.#n'T5;i),L& ĂAD&X:;26ȟпAdQ2H* ,]jr;4KpL ծS%~qYGԧFEATuL,`\ZfIEa _%Qg^4Ѿ OQJ;KeERp7}C[x XXT\YsK/Ns RNrtηs"n ߑ%.J2<|4{՛_F ,eo0V?C+t
I -eHHeҖ4_3/GȳK,WUX\\9FsvО,G^ iGk ޒ53䕷 |(JbWaJ Ԝ] N "h.ѢJDd FZuN9MgLxK =+QSW/oz{5iNWςKs o$Jxٞ bxJ }}}UK=9o⠩ <=8%X&<r(*JQ#Ϫ
qA-y/uըJ[N#3S3k)CWfDQnlk =R
EFւK䂫ՈʊJsRьoV gܐ2?9]Ȅ'1<78WSUZ7Cəg34uYFgުmoIY)8|UTeWyvWڼ5Q8524q7mQ b9VTV0J奨J/<8RK{Mnh[Ҿ|4 )/)7q'.پYl݇K&\cیο7O5fmM<6Lq8_0xT=Di m_
?GNG0!ēpqFb^kxT-W=YoŦ
U5T<ǺȄR3&]6-8" / _R80Lg #loWϺ&H(mP$0ߊo! +d$fL<K3VX^)쿅ύΊ#g 29ks0 hTyr)mxDMl
:M}>}/G&rod{T8yZN}Xx{qҝKݕk[KtX|:)tIμ貖 Zl2isKkxLGC,
pgXIkL ײKcL;R&
e drP<-miM&}k!$],Ajjzt}uՈݹ
vv@(!rqfOHFÂԫ"6Dgۦ+/(Q|\3%n ynBRZ<@Ņظq#bš :v u"~Wy j WdP3BCՀAde߾r1f,HK1'-^Cs"$ޑMӒ?QdʵEf dg`Xzn߅,UTÇx{ #% Iܽi?|>|;{ =qE[輚t==ݐ /<; ? H&21y{q3Ad%auq-vY9y e⬰&L$|ˇy4IYNOrH9Nru@cA|3
L Č9weEK) zQSI≙+fb6]6")%IIH5'pX~ՀM㪫C]PO ^,H4_9I&W&T2[ᫍз:
W剅*c`:w鉞Qy7鑵;+(~vliHJLBJJ
CyU ImHHX<=Pq(ޜ[.Ɲ9:`咯s O_ĸRER'dG{i۹,̳*[^_Ml]OÇԕc HOKSyLNNe{v5T_-SƢ{f9up< &
ON0Q7-N; 䥔GKLٷ
} :B 8CT+b*<d`Æ
OLa>ŧ/0A,-uMYQbZ]< ]w!1طN9ط'/'X]Z.U L6 F1:.W7xHeI!ͺZP\p{QDf䱿7U=$puW
T&rvDZUq L9M %5o]VU 91
'$'$ qADEwoæ;{aQJdnZ~'xX$})XՒOHDQY2rGANΜEݷ/Xgdfjڂ(jվt^^7:uFMu
'/*/#6mER2dx滣4 (.|'%]SlT5?焺'
3o;0` t1^/8DXK*Ǿ|;e.e; !A~R"[qA eGYuŏf = iGSh0y/w*|,*M=e !ʻ)::Z+'j#`#`#`#p,#;VEAJS=6-s]kN@]i ,O;;/hOy `A+fd |"2+ 2Xt#R>`&Sx!ȳ7 Ϲi
J,2czrP"+2#q((2٥* Q-[6cIW%s%
"C)ydUՊ(e|LbUCf.׃^4"/i搈tnH={ 89 .gsWk' #+W9Aܹ^ Fbo8C̖-᧵5W^A喸jU̧9JPFVNL]9Cc voYn
?.#tSESf>X>Z6/Wd`i(n5i >1Al?0#>"@FW2Q+̻+e+~gs`I# ˊmV$ŹZgL=љO3&"̏ugs&:PJ)KwZ/PX4WVGJ@ʃB< Ԧ/.QʙɄ]{C%WʘN@Q<72Ņf,' {7/~$wpT TTy@ibwh8 N
L?} 'ʶ"L(kI&gWV"&ݍn?Rm~
{xJ<ÔLӃ#۴T;QloR8iSW&\w ty?e脷=bƉ*8+
ܥ Si'[nzBMEɋY<̛(ܦ?<TH'};g s qG/LAoNUlI~Y&ue}ztAi_OU>Ɛ?qDW"TY\U s5XdWuyдXbߠcxE^~>CgC\뾒,?]=e%:)Wʝ}W?T~R|30:[}Iqcwch@ ULDI"9h@9U}TrH=uKUkq^wK^j)+å*+^ |";(jԃyIREtX 5bT"h, owCϿwoOU2ɧ/K2OWp?y >}i7]pW+[걼# ~:+2K?-}[ʻLM"\CcKQw\OP'ar#
LoWޘS8y0Pdq<%RmÍw?&]A]j#F9=PK%?Jz7g/ߊE;C5LzH?-Vm""-[ǙxQYS\K~/ӆUjS-L^*llllț7 XuJS ;Ok6#P|Qe6BPAf~M\_n\
@ ='YG];z>]NW\=ы+!&)O8]54CR90(+B}ON'_Wt
D`c\2牬44yb ?a늸}+@><0|{t\ʰk&fg?Cш ф|lQ=zhC9ػ %" ȡ(." &嗗K W.RWߎ~8U6p%
ao%_ѫ_x# t *rN]!LAop 8 vE`*(.C̀եص7u.jeaՒJ9|4\z)cnf2-_EK)/}qAn=0)4#F D<W 23?WH]~+Wq BgGb M5H T6pӍwwd&GrV>xB;j&_օ!bd&]
~ wvYqyftƯ[cx/\xh=tڑ'#Sfqy%
XG<j{ d T&bj 1}X; D酬xeERt C#Fq^5*<+j{b_TJB'f Dz?~}
?c"|]Q ݵ Y4wn^
Si]; 6 ? !eJ5'@P(ӗA+J~"
ѧ WaQV7T EiQ bc;##+(.?Nѷw߀X$#2*
T2jڽO ";i9dp ~X 9pԧ0p<t
*_0P`bPU-FnI
- X+K., j,<1h0tat` {Wec0.]Ҡb &v~`(Ht#`k: '{=<~;c 5QPxq2ډd ٧S.pXRˠ%|Up1>̓@(+VIM!c
DenFif[lWc[I
»=Fds 9>t<4j#XrU F*%O_ٍ}YxaKnyJgx<VFq(W rjk~ly8#.5 ~n- Rѣ8Kqto@ A=TT p44Εu錄pFZcM}
T Sy48> ?r'BDtcMNR6;؆/?=C(ͬB2^><b\WAGI'ggJLEs)9 uJ۬a' M7hӑP}D1(tf^b UaߎH@]jBG 5IJTcY`|Pm
wy=:ܴ]7G^|(\+GCr 7R n}4"=92iѤMOcwu] y
a
QO6d)& jpJc"NN!s]n
$dt07E-G?t/N@ul\3f[ WnGA\Wa05VGJU_;AlWqQgo"kukѰ>p)O8՝8lp Duh8&Aͻj41L3mC۹5ܫʦgȓ8s\T9cP= :,I{ׯCPm.Q:7k4_8vxN'\W oqB2|j^?25rsH
ny|ɣd]&(dc6
( +wuCBBe˖T3e<sP_gSyQ=PW>m<q'si=یGvSzJ㍧SC 2B0`zoOi|G^pG{'ݫum1Ogu?]K|yE:Sf\1{c'/LPi=ܯH{c 5l]kL6FVA?4 ;nuVQ&
Mc }XwƠ[
=g,XfGD{!=VdcwS9l1m7ƲρC۷w^1OgL2Ii'
+wmu
ƲE3<yش}F .06_N[V-il|-&_Xzs eqHq`V㵧 Pq:l U}ic랃ƨ>Ի=wkc>yO?ܨuG_~⫟5&?9J=={P㛏_SeטdqDG]oq>Ν;k 2N>e, c]FTYyPoף6/UM1
54ӨmE;BVto_ _z8x줱mFO&גiZ b8CoMk"KmF,3N͒ Ʊ/Qp}9ck+W{wo4Fu1ݻW3e{1nx{ˍ<~z~},ɓƲ3械aW_g#dbWWT6P-e~.cFĩјЧeFXW> T('X53Ro<cc{76,Ό6cUYm!
Է6 g<sW"o#GQ vo=gӡWcH *}яw 0n[o<<o`;iǮ
KuFMx<|,TG=ٵ8vr
cɓMT\_㓙41V._nlj =jͷh״Wcd17Mx0csQ{-k0Z1m`<1c L8z4Rlz'muc6y;~70Vz؍Oa 9iX[`#Gc]pm{67n_CⳝgC?c' 5lÌ>][4c&M1 >flZc rwm jA.d[
3f~riF>xb㞞{
-s8eoQ88^cӞ X62 ;aa9e 3fpLOf?<eK n1bQØ9w4(o57ɘFj\_9v 3̚jԲԫ86{55?{CEq*7p
8mݻXf
O?_ cF̹^R8Ř~;qnhߌ_뚍Ə3>VejM |cՊ=7w*6( ;vTyƍ7WG1^}̜Ss^o'i d tacw_m<a(6ck:-Wt vz2~|.gtԷ'X\τ7<`4zo{McǾCjZuYHȆFlQ Kn4PH. =K:JB.^.QOu8;w߷Rg.wXj vyAk쓈9_|¸X& >|7|F/w5?eѴC7Tuį+r3 >:}GcCQ.' bٷAB<5'ӞBż`exw0wY<.NeJ@M;7υaik1[dDTA r~Y qٛߢoT o4j]{9AC/ݲK }Cjf++5Ttp ?S?)G[}vkwm8l:g G
= )]ͼIJ.MGw8Usy6ƴ:NSj!l Y ZB>N Z%`P
ҩ; m[7}R`~8 |;va#Fg䏾_;|^2
.n/3?ĐLyk-PNxR!.=]q!>~% GBSJc uFyy P,>9Y=l
Ofc; *SР<} d'E'_E[1ꎁƁhʡeCF:mاgS:] A
/;'] L)KC at\_DUT 4[ o:_,߅; ڪ^U O5Z d)da4 I4ȠDvw/
, ym*܁T-aO=-BA؏7&v
35?N{@=w8سLU7m y= mCLC߇;_y3
S{We1@95|Qm恮xmq]2JWWO Ӌ aQ7ՂNU^+}*< CD\@X * f9Y WQ JY!+!O<~Y ; G{3`a( 8X4w*ne WûhL}j 21kغ%xk fߗfC'm7Sǧɭ5!M}T54GVe((LzpPH{?h} ߚβ* *տwة4L$A> *6LԂYݳ3mD9Fj w?>2 -@N}-0GF4az͒KgPWm'WfGv\eYBPi sp& #1=#?& W|l`/SJ V=?@%)Sr+ ëh;m8\*xm|t Əh}}2t5]7>|~Zϝ,lY?y?Įe:sEEv
hPoo&=pi~ ?N{ [-`ϱx,4dk*ݣލ 1f$ӧJY=,
ERZF:89r,
2YX6ٙX=:6sϡoFk_x_/ߌ7
Ō^gAٮ\i
\7[ K/n EԅDusҹ!1{i;≗Ō% uG|h<8\c ƹ Xxb ?m
I 8r`?" lپEQo]n>}[Tp+پ#Aϖ_crﮨぜ˱t|P<'h5_v SϑR114 sowt6\`jbќw0 }lֺ=>yLz tFm)NBZY) pNĻd^<2 j,FSChΰG> D~\~etkGI~Szr`6
(o
D кS/f;h7ˑ[բQ ::ydrr6*b(`#drWc {qg7sz1 4pb: 4lގ &{*oӣMh \tJ(rs
XsМ2 Ѧ];M@ :tꄶBf zajc ?7mi.110"fgT=` ֱIZ?:}QCŕIRY JXԐ@8<e͢d Qܱu.۽; Ǒݴ=1CCd=}[TSl:>PۿGO:0x%?wzpdL%MKcaFC@Q7~]EAS}pGcK vڋ=BpT<m\~3,Dy2;+d}*<]Le[YѴI]!>i;ggCloٔj>N0)T/=) `n4Zj O .-逄&Ѯm;\s69hLn1bq' 7YWZ [LQ$ N0 ?Ov̗ AzrM9TbA298x0jD<+g2MSzG3CAONLQ6b*A6."*TtV nu=MMNUjjQ]i߾U0Uq)3 T/-θvBTX4C0e.Af0[F}-[4CP`$O`͎
T M#d.ؿu1Uoi stE,=mbTQa!xvcn '*qb})i'U')ԅ0.%aIhܴڷi#܄ٻ:t耔,M*~;{&
z[z~x:(Q -~'5x(Wg _:t. Uxjy,O
r|\ǣ/ӉT5:px&4 YMLB.r b m\T%8M 4}Fܦ-,9i}ԝĦdzTW8Gs ڶ)STݗ_F EF c#IgK;yGK 8wJ+> R&6cׁPi*?NXM:ua.ztNU\Q~Tr¶gջ Wq Qc.h6Z} nUW8p]:vD{2Q>}:}:ȆjoZy7h?6쟳
4rt?Qs$jTˮÍD; ۖӿ_#l'z{Y˶p!u" f\ڴ:4:Opb?ć&nSgA?yrDŮM#Mdd\ v&qc~ҒY\n֫_ tyoChٺ
jW-{ [N;$#%1U0Z#(0 [HZ#͚R{qleKSs !'&oG>ڍ345 #t<8;H'43phf 9"㪄*5j*s&*eykTlM}qVŠsY4jg
nI`}vd4}c@O8_Ʊ]ѧkgo'/ǃ Mh*VyUJt[Ϋ:1:s{{nzR>u횕8vb4C_KhJ!r1|9n"lQF7Lnh/f jxpu2]n 2E7gƝxW1tDm߶a_t), s)=0 HURMɍ[UƸp0Q';f0'fݭK{ڂ9⮻C,rEJ. .'3g9gځ) &$0!C1Jsj1g.-][R $P@oUUtS
)^AY4m 3У#3=uө
d49s\o b /s6~9vBGNS)m$.NRKjiא w(Tˏ6ή v~%f}3 iKY(4@F Qд}OvCv
f|eێ#v, vA0 :{{քwJdgj*~B ؘ9K(k 9un"PG~,u<ZA~ZJ*a.?$ms'Rm. %% s,9s8@'-J' N Rh6| m2ð_U}j%G2mb ~d0/9evNJOdE*j@6B3\ؗoJMS~ >b0mй)
v|wƌO_[L{QnlpSC4-MU
y4~}n-% 1w:,x ?>ܼʠIl%
"CQŴSun:J K $ta_ڈ}-
Vո % )ɜʦr[iDW&:`B.ݺ¹RY9nJ gM&UEUMHբ%" yPdJlH!s,A65U ::"S@FѪ~ NT}#iJޞ¢1xqG=^=/XfM%]Nf`ɥ!UlX;7mG`ަϱr?D4WNrAQq㑕kЮ~JIꑺQ8 ˫?E|^v'z5sf }(E;pv<wM 0jyǯ51xԙ ܴ*S#vɳ8" 92dPo `A^<01) {9^FqX(vl2F?cp0IZ eCq \:k2Gae)
xFvsPhNs$m4fY%iGH9z6 TP2m̉2 Jp&¶, rLj3We^h=^ w;\+W6KUԢ/'$Psm{w}/9ZQyͼU
$kK?1IP:^V̺$U>J<)#'!H~R3\Dn!nDu;ܦm7!IˡA+> {Xr%%OORÍ)= nӉ ǖcK6U*폍6
(`7L>g]NBe )r8QeSzlҸ!U$Q UO )psѐ!u7h]R F&ΝN'+ZT;\ GO*#R"ED '`0FISY
Xx<*J0/1% oǒHFh (G_ zęLyt*Ҙa<"SmW܁]pA~xd# =P_ZaNVyT|{"Y&=ΆeP:YRˉ -) .=9aC&t |6,s=@O)=CN7 ,ё ֳ#Uxc n.*!8%s. qߨj]CF4|yeDX$NE]ХkWWŴ+H'^$ )5i:uFu_$5g^h<wl:~jHhIɲj%Ϲeo2Tp Q32x<SmtH1TGܲ~%*S% UϏ \ajfwC!wS3X3NsܙѶ%¹Kf{JIe"٦N#'V2z\t&8 }RjhՔ ad)'^Yϑ'(b4/Lթ |jO=YE4a.<e<0;ņEx.xTNք2!M<*p!\je2sC>y$Fn6ĎeǐoO'TU&'Bvَ5%@9r4Ɗ" ͐!^ݪ?AYWq# ,_=w2_*jGJ?v(]19
hD&saI m>3 Kqep᱕N">7w mJR<r~]48d (A5+qHSYK<sH' d%43:e]NPjc\ݾMb٤sFv 7.Q^z>j&4o;jC@s3r<N`nP8z=豜LPjܐYBb9:]a5V9,(20C3
ho8tnrO q2n8U6tIṴ̈̀E"2 >L'|E'aPogn2R& gȱv(GKq7.jҪ]Wuqi:BX = ɑ|Fٙ"9HSQ mFNNgb'Cͤf-۠]xWsL i#O ?VA0~a6ʻq/ ʷ<a+TCæ8 _MOoJe q1:}㤧JgI 6r"[itj)Ttql۳U wX=hqë&.2pOܰdے~*(1ճ v(rki9Qen5L2WFG ^ե 1C/Uhȳ7+܊Y!g_y n<Zh3{* ==رp+֠<y ~ bպ!!|: Npu6GSV_R5yE_S0<j '
πWMŴQFlQMnTz.!'7Y<.GІ*$ԧ7wO#FP
ΜRiE7b4 j Fy`p'?L/__d=m34h<3gf[LVP*Ը5ygxd0MaAnT7Cb:w9)K0Y1>'N=ײʷ63}w
Wx6 ~Ƭ8:cϞl(K"UܙxgB6l_21vD~Щmc.fea^gӚ! ÷V3|? Vyn<G<\\b~ߞ's)ݼDc*Nu< }a EF_ʃW@= 8[ Jb}Ћ/m:; S,X1(iԻ)|_iW?`_^xkgU2a]kL2N.ا= SWƅLn}2T{vJ7 3r ^+&iHF,%6k^1%xeͅ*U~+<]-Ћc.0'9cF݅VjKR6ɍ> [s^֨Co0lHl.L$pfi1rۂeONOިqC$~fZ*VsÀO"*-;?Q4;*,Lz%8-bOz[blY3 /A}G3v,+3˗O{| T8Q%]a7f~4?jcwlأ^ӖTjk:ގFubu i2aڻ?XLl(u}g caЋLzZP 37z0 C MFB3Y0 Tc<⎊h'ŀy7UԔ鄧f\}soҫ/)fn
ޞ;)퇦Ă'
xcpXg A}FO$le[1K4Sad
ŝw0ԪS \R6K d@fQnxx>2?aZ&&,w?0_,$ E6i pm|LlX8S}W:myͳZ @ IDAThóسӧ jOM2j$ A݆ aO)8/[KA'غWqOxxὯ0nsqH_{ PiᲢ"/;B> AeS*GhǠ!? Zޔ$C2$$ގ?Nf֮C'R_㓟'MAX8~`νrBUѴEk|ձ #AayTwDKwU?6%V*7y }nWZ?7l7".6D"\<'frP FM0T+ 4'@2Ga&PKh%G7ʙ2*Y6r1 xUǺ$ 7vO_~5Ǝڵ .\Kds "iO x g߸?ЎDGiSRw^$QFܰ; 'ٰq8`7u*+>rArJF6܃SO" :c&$ ݧ1cUD:Eqp+ k\m^K)M,% uQivk6
(/ ')sud)<jdÆ
fg"Kpfn58ygsgAW 䨝KIq
=,.)G
KvdTγs+'WJQF` ǂ,JXbt>+)KHA~zR"O<JΜ G~F"x=S7Ǔe!)dґ_@|Ҙs<+]?9Y ./P-~){&j{#eEtN%@̅jqDdj~T$ ӖGpqhGG`N]Q" Jn/^H ;*)NjEQ* % I-ґRT YND
Op T\LF^P]4%I)=K<fp.<֫nZ<(<̑ :<^4J Ưvm E#ן|>QT/tT,&Rp WT^ 9 D >J9Oâ
.j~ȽȈH$ <=yz! xdJ*j? {wFBĔ˪MPH ]9dAXxGM !EŜC46cc٤-p>~P)TRJEEG!%[yʖ@i;\x<-IB M t䡤 rLNJjmjy]MڨB5 wFǣbuJ; 3(ʾt%dkX1ڌfY$gSzKǚHa -y̚QUvڿrKibL|/tdvytvWYE]@P uٙl;9 䮂.qQÍj<0~'N#Ǭsg %+1A-KtW:CL' )%_#gXi r<Hc.$rq.3!gJ,EA.6Й_ T#c+c8;w6 h wRe9x xW,aPfY ve6\Qᜋj$;tC 骄tڢb K"IFןG("je͠&=I#1-eQ V*VɣytO
3l{9U\y c %8˾$jժN"#Βrd F$#NiOax`zOooTpĥ z1gqcr8,x8ы<ĉ<2lW^<265x TɆ V<XjUhOkU@g* Ej|@dxX.?qɡ"~܀/i'dfw
Il|]dݜWh (>>6%GqnT>sV -#`uWƚpB
Jl v>>1c!i$<5s^8KGRӛQCgye 7: 7*PJl+nq7m2}gkq}tGmubc1]Ƙx)"ٜ_#I 뮤ep<2ٳt wjxs -e H<އzJ9w})NdrtNŲWc F 79R5:>y-r̚Fe2%3qK<V^
pRދ֩Y&}qT 4oqv 5*f"WmJگ wX8 6 j:S o
wjP>g"THZxWY *L
HD%Ù&zlѓ8Ogbb=5=(kLjDqrܙk5$>!4d.ܢ9&DO-Jƫ,i<g v /ƝGJ ~Kmi\[SbN8Or蓂k |1cnm&lmQF..]9aڙx_,DMve) |adŮL6&6p\lXI%bT|;NJU0-R0 2VHDB,.+%C&6]va?jLDy,DR.b'.##>* -7jzNG`GJ"((
b,/JCE:+u"YW$6lh YЛDS<D%Ulʔ2(ă 7@JvZ },抓< ]G Gw %ҜjTGLRM{rK9ԏod$=(I]I;EhY -4z1K7*{d;7ہėuaU;ZcJ`t[0=sA6IZ5zt'Bsi:H٤ R] R.%n VK\n=
vX^Aڶ/U+XڰG<;AB)a<KRF}/<H !ϫ= 3/゙>l
ԧGEڟ?Wşev O".yK9ĮT{2r)$_T"Z_INT;4.՟Y~]0/>1ߥ=șԲa c'_ y^DeWEO dlB:KVHSH~21H-ܳcB/ HeScU w5M9v,.RN ;Kzb!mzY[3i$>H#⩃cM'#t_6'ェԱ1v~eF !sIG/ D[Uhe1[b+͆ |M 4<9 U9LƫR{Ѹ$Rfު{K1G 7d mGԿ Eso8`,t8@9pnE @,z.}W2S&Y̳xNyVJ=2%տe7g.JJ?~.uFuH+K;cG</ 05U_Lj {%1Z2J[|9ۍ"4Vx)uqerhi[68r ~
1S*.28z5cSszszQ;Us˖e
/
ֽ"Ѵt]mQF..@zYdyмND/'Z2Qɭz"NIF?[Ǒ& AEu8Q$,t\9ʽ\W2K:b df&(z_,ebz QF
:)x^S 4fzY=KyWᨿsA ;BOC jTd,- ?&-
fN;K,M܈b+'/$ UEnw~I)0@ǩ)&Tۂ±|u*p$"gWkQ%uZ!lTT×*w\,H :OGI%4Q)UZ)f$m*;KBgK K<,AQْ^+ /Yƥ+fƔ ǂ,01DQ0d,t-Y6p8t `,yrohL'!|&M,i0:A`Ky/\d**W ~ :+'LK(n WK>kKCÖ=k8E$|Exo59#\u
҂SQ:HTYt9s4,L{\D+aF{t& ݻv@EM *[M'#a/c^"$Qhg( b8SLdg$,.yM?6ӄ5"Lr&5$yo37Wֱi) N=V~N:+Ye&ߊ1QiTY%?3y*ͱ-_uK+Os7K%K AMӧ]näijlQFdA F$2ɤSe)pJƱ~Ls#Woji$WS{Is#%miqe'ed%+i1^,̄)?"Yh<;
|D+XbiǕ ܞv\DQZ@Y.nꊋe,=S_1~cRB J& <i"zK@kr%,ndi_ Z7]ʅc1$ WXڙo̫k]?ϗEΒy] 8oftWO2N)ɡH -J^fw?K<կ{At|7 8H[yJ:keqt4}iyN:7* ZEmC5ʫaÉ5Uu^^
h )=Za_כKWU*^g:^,ˍ_ Z*O/NSj*}U6S212K.5cibo?,zG]UKPͽ8w yZ\e*&*폍6
(`?deRHWJɤ a`dY!Dd㔼4_&{-z\4߅Ю$|y
ފAE.Se,=J;iXel O
CUUCoD*W8%iK9>k=Zÿ^\< tiRF{=|4쥏˴J{pFRFΫWO145K{Sh*j" h<.X/<
̘N])ԏ[?#Xc
O sRZ}G o
4:i4W~8,seN (`6
(
3^^^ib'-̣L2"07M%\e\ĢBNae!$N{ ,/jGk Rk/gpoDhKGK\0 t
#qum,_ ^@O ۿ<% R_"lH]qe|)m qP 3e.d1B#=Zz =ٟ8K Qn ƿt_o(9[+#mOΥ#Vp
Zi2Ch~T%HH}<'L
]s"cYp{q0)/mzF[oml6mQFCk2(ܹ36lX2IWJֳķN7 fqo"
'q2yV5-坎g}-G[UEIb5ǒyYWGW^dm~-x%a,V,esD~hĺaL[7]^+u~pJU{!q%wr_ZZ8%7 *`)~4XM#Y+M 7zuz}/- u\}|5kxt
|$mix2 >7j5.j? 5W+SZYKg٨E1<|=$[Va0G]aw,Bg_]+M W_{Mk[iq5^:r]ދlQF&., e
.6+ -В i/X sr/7&mXFra2eSBXgd` 6
(`N
\w%+j_dRwu(%̾
M/އ/b2dK"^0l~_QJ _ߤO
ݍ@B_Y,4PeZUFqJ+SG[?+ 7E,:OWźC-啠gw*.xkgKjMNN_|2FYW _%Ӗ| W_k}qt9YHL\jWkX_?`DY!xe7۴jz^EHEn J$2VD%?畘?I"W 73n\
^Y
s3upS\|ŹlQFi.'/ 7RXs^ڴ}%ŒI37'R&&+s1J%ϚβHwQ`M[ 2mvfFwmgʔ.-/iwR&/1 p4f1mעViU/X!c &A~V \
r%|0Z~Wߤ͊ Ӽ
kw7WZ lxzd}n6_K|H`J[͍%c|$Bg$и\ƟԘ{Śj6p#KEQn-6
(`?e{f=ide"7e˗CRU
\NMARjrQ3$#'`OW *Sɑ7: Jwr)\z q̸*&cv%$e¥FM0GGfv ʖ+ga^ByW ʎoG-n$S)(SI;Uk5\*N88jøD(t4]$kZoecPX"j6l0oU$WR?*HUY&Yc+TeՑx\Hpq{
%!|<*WsP; nu}EFVN *T
کVt.Xl8r<Ll6 I)k
ΉbanAm=^q՚SsȑUe#itt1
$\FlB* Oxxs /:ׄ' ռ&mP,JMN@nq 4EG7wX*WK&R_(vd|PL#nrb9\і4%uE6
(`G
spu)K' Gsp6$U<Qby<A|ض'2S\nz~GƘ*fDjGjعge=LTa!4<N=:D.6&.v3O_'~<8E9Y3>={A;+W䟜\_=E nX^n_> <QĹsU +`z!+E |' x7>o\1_5E}P@?9
\INćcsbC+0l_'܋ MxI8qҹw#%v+goO=FKo~3*kl7G&2&?}Oyw Otf;_-Z[!嶳]Ф̟<`ss/'aǶmxIBV=.d.`qX UxQx7nn8NO fio_T!2Te)DZ-}5? _Ujna*#+|*V8fܠy|OJ&Rbsً*Oխ ~ qt'`ƛ7rv,Y9$t`)T{5[ŰQFlD[ $$V^F"My GԏBe!I`p<uwyz Wݛ#r%gADX|-ĩ=! b9)x'oNvV;űLe# Dt̠*{y_XB"Fyc2P4C(1o,IQE Z4"ŞFמEzf ف?zLyU%.z*3sAzvzc+v+d"u$^]ǾC`w1m..IJ-LMk\$\KL9# ^!E2!so5#8ZCz4ڟEzX'<:v*P.ALkԗT_ >o:ݷ'1v#ƿ b/q@a nA.-(uA
%cRfr4ޞtgonhqA(En \2}Ӛ-1R%\?u(fݞ2*8IdX0o6juBG_,%Ǝ-s3>KMzy͜Ldz`1[ ΠI@H]1bw+E4=L )6)~[]qO`e0= V$H9&|]W'bk6
(` )p]tL.{7-k!98V 0|e*P3Ҩ n ݱ\Ԫ 후s_J^J\IE :i@5_gðjuSҩ6Ym;@!P#` HG-ЯOwԨ"t ~t?Z8UEFA8Vv!sP$Twɝ}KV8!s)C$ro,AJ鵢םkERg0r`7S6( XIƞ;ՔGx% Cq)W@ȲĄ SP#p)߉Rhް2 (ȹ aPڣyn٩
R}ޱ2FMxߵlcO@vrAf]SXZ$"ruumi;صWm ވ@wmQ ?1kӻxzJ7lۺk.Tj⍐u!hٶ=M7
,] /MK i;?_iz ٽM:7i ~xFº2Fܪh$bʅ ً،?K`cIU5Mn2ut9;G_4;U,['GY6l(jźQѻ1quUqGţX} W/ƙ5в]g({aRY* fhV
+~)Ygwzvk'
Y_gcmH¶-Q+݈֯6 }|Kɰe8v !"%#|ѵ[7QfML'x/eb϶Mh9`YVz2oڀas(ۣS`TrrDAf6[&=2~v#
"կA1ẁ*neh~ Nub;s0sS&9,֬^\pE\?
q:t m؆TnW=Il&XE
폍6
(`g
\tQst~omL|~yӆM&LuI377<q,:wONsŽ(6% NVJ 2ѦM+&cd1ɨ>c*ݸ5^E K+v#PEHeGϒK]d&"d<0| jT471p'$=%⡱#1ɏ^l! 0 = Fp-.`#[62TtvCh5UD+Bi&^rӢ{t mޯ W:ѱزz'&nUu RVGŬsq`kzE40ρoZa#N)J]g|l< Ri tGañ [mhLŸsѮ57Tu@m
[LKxxJҽu9.t
A3UKan%n<^|Ě ۶Sl}5x}x4Em-H4' ܻ?iUFm \J'gobǾHHHDjZ2U^C4$#9j*Eg-Nm /">+b㓐-Ǽ5Րq&4hq}!bP37uv[paav*z. ~]tܩP:]v-Bn4[Q/G1+z[,1
瓩 K
GRt<=25$ + 1<2 Re&=[v +ořlQF%yyYHzծ3hЇ2 2f |jTR6nzde,ؗ\pW^خYsQCہLgZ9|v,wi_W:)fۣ3r}i0}
{,BЄ70QM|ӮW)Z3ҟn*YV Ap/IvB$",~fǠZE)Į
ˣM<KCvaT+wT^M9L^O!qgfL;SYѷs#17QgF@ 'W w5-:oLsr1o9zvl g' W@Æ-qto. Ak7 up+7~TU#q(R>|<-4FTbuzr9g^[˰1ܥW8 nG|Y &jϿºoH}:KOը#]T
H'{
-v ~?%˫O~Ӕ
rt
G{f`CF5+=7ӒnMk
1/mK@&D&F8xrzcUh}KۥʤT;c5W7v|
ǧ -qΔ0a$P%x qwZw{v;CASq6Ti1w$ Xmw:3
xǸG n
$1`y-לdΣ 'CcQϧCwaSp$4 PE*"܌ #U=y-W%і~$J]fo_ wm#ρ%v6MĎ#oE}_IM#_."vhY{FjR~(FlQ n.)|$]/{wjF3j| {WѴ@BNw݅5ڏ{qw Dϳnr In!ݭ)G/2F̳"ÕՔ{iMR E4ϫq4teݔo;ж}W\|ۍiH߸ z-Dw7n݁sO8b|*zyYxMPM FdDL4£TYPct:< s9.)DFD wZ5t%Y+mz"jpd:}X*G1{G2ܱ0E)tq߸
@GJY˷e@c^&PhH
>~ ŅEƍzcsy۸rq]<YC wHk Z!!jak!%vE/R.#`= 1amЗ3ԬpG,j_Wl ZK7OEZ/q탍M8ɻˆhݶ5tT]kwߢgYwcPcx.e:DЂx>L <aӮ<~Rw#eGN1poA Y L3h։s HM?I
<ѥjBusy%Fo <y"f):c2~P+[&^.q0R*:j+Sm|_K;g C ۨ \thW^{2z=!E
+=
x(QAk:rgup
+qLhD9^s UYǚ+ctMS.ǂ/(b?AѸ+v: ?D*H 9(Dtt woAT^":s ${ /d? ,Z||KЎMq$ ~B<oȠt'}d >LK-y96!;0 E"={hyUX{zs9}Q_ƑB axqS,e)+b*?)Sjϰ"y~]B4Mq1ݬ%NTHޒ " Wl+\ħz ey) i6 @Ȫ1n.(o
8P][xsp2zwp\ej:
*Fff6"*0;bzf2
| 5b1u|:f fMeHX 3Țc>?z~[ib}/!Bq b+X!/$o]~9D `q& 9 0?5 .Elh!vs[B < y"Z <rL:yZs 6BnG f
Y . ?YKS Ǝۿ.E}*csW#f)h&h!qӦ-<KW7#3go()/Nk?y ;Y2ӷ`f\4+0/%ۤ
N8t\|x_Y -67Crߛl,^|YZX1.zI(8
Bơ@v7^ ^GD# y rB5po¯_Ouo$˟Lz7 ?FZܜ,fSA) dn[C qժ]7`9ΫW[ljcXoFEUC,!bj;χt :&L-V9;|xm<SN^Ɗp^Br8H6Ϥ L}{A{lh̨epv 5i/_ Sf0/: < 5-䇀v ^ӘC!a߂ؤ)&}6FNpKhh{l9h v6Ee+enfb/_ⷂD$K䀆W,<qnUG YӖ
NJU+# 8^,?"l֤!8ڵ%f(2k*6A$q >FFF=^7O붚| fMĩs<í̸Ǯ-~9 0{D6f
rQ V}>
Y\Pq
&L;c)گ jU" =Q{ٝ#m '7ŸUS*iZ )kV`4Sӡ:sy^s]Uz <
x(?F|0۬I_NO5]y ?;z:6Ot,\Vĝc<1_"= ,Ə[o I1EuI{*vv;O>qíwb
' bN댘ףS*|{t|xHJ߈ߌmzs{`wg g_ .X23$&P>]V0FU.wzqݡJ~ڧЩU] 45sv٬ V=мCOz兩 #ݦX x<^,S"''chH8 WC/~77ҧߣ wh>uݼ琭)9HWCK
G[vÔ~M)c.G8||S]WL.nG 9r
- wKT!}o8pͩ o~Fx 9=`3/[o#
F=)|Bxn wO >1cvgCРFeӐ<5p+wj]W^u7n4|T<p݈EH;ϻ]N ZU#0[5k'FyA9 S/
wͺ _}z6O >
]92&q5 }?Z hnӓH
<W{NOBgc
y9>@I^xMSʇ_6N|6*w < ӗ@Mwݝh[)s6iG <
x\HX Eq- > kFƍK D.YF$4jPl=5x|?qo>tIQ\@WtĮV Y˗c݆ܝ
C$ Qoӆ[ ,w`ŀȘ*]Vmb%GqfG!66a|; |:g 4THeҕ E}Yf
իgDTpI; BO&cюo /;͛QjqR&~HöO3R]+p
E)ʎoz6~>`6my8~Jwp&,[n:j":IuK,7
"Ubg9 Kk}jƍhР1,_ C^܍֍̮YzV.b@RDDKC )QUP;@z# ۇ ޅ "!!| @QE¸Z(yxq eUY&* E l
ȫ+--_ M6DN僂mK⒒ x*m'ߓ/_MGĆjSLJލYmWMiXbҲ
P/>"G τ:ܲ/YRQv]FE$ *: ረO^K.;nڄ\P$ f#kJh1qE E,Zu5oO24|M+. ' _!T2'']56SH[ ~_CkncvZ8ͷ$mdZz+ \57Q A5Pf
dc L3k^:Q"=
WTDlŔ=ǀQG@WܻVS3{2) ι~ x*lՖonS Iޞ&,|Yq.)<=j4,Z ώg@7/G7n۶|U6~ . y|z6*~$j:._ZT>nR:hSs^0ucߏ|L0K8'AjǛ]J5 zJû>Gjp㚒bU} _ 1syˋG{fagcbc
P^ʋ?ƚW&m۷o7.UΘlHlg,C7+UBy(Bg#LyS47S<Bzkm[QJ,]wu yw4\2{6‼]x'"ׯ-
.sN+©(cʗi`_^\ڹ0lH)](^^54 <
gw;IbߚqN~R̤bjLlh<cG Ԇ&rñNJG^̦^c U7$p5Q84= !2& @ IDAT ͓jZTLi8;,X:[*Aʷ5'lb Xv|DO-Q9bb4rAznaFذ
/+N>M=N&A1q}H
6ɡ 9nEK=+ǀm |Fw)@?ԨypNiOnPH?t>U_j tk[:ǬU
E:H;Oſ.ǎG|y!bC'?JMsj^7u~۶T|R^3 }Ϻ m^
w5ɜ7lP}և/~(Rf,k..YﴱD~qUYKē zf*/Zc^SQG$*A 1bbxL6XEZF*UUyDJq\9y73ч DFWsG. ̢Σi~ӑ2.C
u,\sq?Ty(Q@;]bRz+߬
(ky_mεxU }ɒ巳,*k<^\[i%mj];7o Zli D]箋iQSޝgonN(̾) yW^6Y
l9&xqr+Ij۶٥8>(mϻucc*i^`geĉ_9:a9;we|{ ^m+>U{5jd~`۫<
qQ\4 Oi{ 6*?fḟ{nSK-±Wpݻk(/Oxm-wӽ<,X,n ;F0:;ͩqzg%%IeSQ& c1sQQ[oL3g7oXW1llʛ&*Q4Ѕepqc\Yَ#
ߍH_-뎴emŻ(QGPˈJi'C[$u(<X-<g_j싔~~ioyip`/
lvWv^^ƍ}(y`_;a)=/m9RxӴiS!<D=W {z(Q{e5Neyqh= |+Dx};G/Uێz}xҫͣG @?\xx(QG <
x(QGU
TxhY_ <
x(QG(E/ΣG>*4=w <
x(QG <
x86(a'K <
x(QG <
xS3 5ϣG <
x(QG
xO <
x(QG <
x(/g;kG <
x(QG <
c<,=
x(QG <
x(Q_N@w< <
x(QG <
x86(F?yXz(QG <
x(Q/`y <
x(QG <
x(plP "4
PXX??5``a[YˊZX[(-gU{c_a˸U^A*}s+ ;U:vsS:m_UEl(͍kJsߛW]tZY{) ʺ˙Be2Yn-+"啩p¡tܾyՍ81]O lsq6]ӽٍc˹TF9Ożjm~]{w Y³pfl^{i|6³Ϻ*\>ga}ou-/X. ݗ
CYzܸwoX+ gpӽlg]kYi:OA:mS:ަ/]Fi^s*/;myouem \՝²84|eټؼ.Nca˂| ;N
SɵoiX;m콭ǝ}_;M6W\|pmZ M/gm-oK_-\ۼ+ޖ-]W+}oZ^Kǹ콮
eyʃS:]ʊ՝jgn\:͝Ǧ?r~D6g <
x(QG <
x(Q2l~;wFVVǫˣ@Y8|F ??hDm8 w뉴ABɱjdx ߣAm:=RAđ:~eXA $ۧrHU 6]LtU8tc
Xܤ0~05AYi٘5kTRdڴCXy)O-1qy[[?\Oߟr"pZ0j(ޝVÝ&$rrr_DDAhP
"'04yeff"<<ӝf*:?6]*{orҤҰD#աɤo)
_6[^W>wYUtŕ-.g)}gʋ/4VVYw\y*oc_kuU(]OY&#l}-yh =x¶W kK÷.cN/]>##t8);^nX],^/]"S^[֖ss+^p6ʻ˓#gCi6^-<uڴz}Epl{Bi9%˺ӂt7<t]JƗfk>S Z6Ml~w oi4{_ |woOh˻>ww-ou8*guem>O";;HθR[,wq fi8 ]ş«9p~v+BY9)ſ2]8' [uJQޖ/}gl {gOigeʧ~IMME˖-ѥKU, wCy,--
HJJ2N=
n
#]ׯT&kbŊh֬!WYpXOtR?Kq<y2:uH v!O%CCĉѾ}{~=^4͌3Pre4h(!})鈋CÆ
!ϭc(OʋѨQ#IA<㑜xxp0aڵkgxpIm]Nأn^4i$tcǪ7Qy`rsiΝ
S?{a( ٬<bf k.2*
ёKXFMpBӖ(3O )n9[G.E
7on1w.^>B]&-)~4QHR@ʊ] J* vg)s5XIC
S~_)7Vr ֭[jժf7DM6VZk\5mԡqEC2Oa?dp>mm͚59T
ّ]+ZjeCD#miHD}8$O Rļfƅd vJ_}Xy-̼!cz tN
a2ĤX,<z6c-ްđ\.76 G̩ -(vt8GE H tyG2ThkKzŊ"宬8R
|U_V=6Nem;qn6]qEy3 j-Zgxy@.ހ _ 0M
W(-lYqk˔?0Jճk~.j"Qw ,X/x ,bN ^pw[Uq5]gvҴyޖtIظp5,۪?:K_m$0Ddai6 j-ݮϢp<nn^QރAu즓[FjX~أ {.U{T< >:Y-#wZ^+ӝ߯ΥCyK/`˸qDƛ"Ks˓DS]n )Ly|vTV^w5-w(cS2 ѳp4_nj֟xBW'Jܗʑ=K,(BY~ r6^6c]g[Wyl]EĢx.+-V^OS2VDd@bb"w$[~`@??
b8SPފd*G41+ySNvW^mSv,,, ٳ
Τ2n^4qםŨm}jWVT78ݟzAyHK X'Z q&"WjV">4QyO-&VvGY3NW` 80i54E/G4cDm@\T h
⥫)hdS|V;,NWŶIyl/i·<iqWі]pH`qdmwdhȴxTi #3ά[SҾ= 7O 4NVN`bI+S?=ea<S(O>g&p3Ѽ. 4(3 LND3
}nE$0}49 =Qb*<F~D 9Q{1[^- ~, MM^[h ^([Q> /+Zi%s^4.
8[<:tX;c{1lwxwB M!pԽDS]CζK89xI/maFf锃lH^
t\H#kq)\ v0p/pv7
,a+N e̤O%#sWRp8b (dy!
|' CIOiv Ogy E
M<
9>`a Kyi;֤mXڶY\98ʈ+Dо}!8_'@h0Pҙ7ROJ_}]b7
1:#0&pփ+*b+^) _7̟ζ>+(MӌBiơ {mM_P9Bz >Sy;B|Sj)V>[AS n6[cB KxMʂgqn68?MdxPcH~m$ mP 1V} ific1["ULO
FH0_ Ei1Ď YpsT?w$M3SO8H54 ] Y*ȩ xs D~nlHي TExH䝲4w h1Oh1͖SޒMc1htҕ?}JUP)2\UOԐ"bqҝONkPKo`yE0D ZAxOYu|Tčm W^N&6nG6DxI/
>h?/FD 3[룿6^Y'tU柟 b[f|I m=6lPCIx&݇j\y[P wZ hAU|aZf_Bs7B&N:әTln?!p?eR ζ Osx;sbdm
"_V_{I
&Em-IJQv6h6}|,9~%M Dl:zThh8>whlil#To fY5"شpljs@z2;_yٻi6̱ B,<+f62sL;}Eym~=2qvhpW WrEm+GR}
c*zSZ~n6o ӖJ!Hݼi ( 7-^QP[q 1z#'
#
pk\PNegC^n|쳯i ܾwBpxsKPN y V1ު3W
L7MI t yr>B}A䲍Tf'Xzm|:J[;L#z aM"6gOoBmqqQ#6NĨQO=
j!e˯ GNDZEJD28P` 2TV̚;. 1g߆W b#P9NgET}_̭\8ez?SN9 {'O c=/DV>)h/@HhjID+_]=;7cޚ vHnP
a W ̈%9a_J N~d#*UFVhB:anZ%Xl_w brׯ߳""Zj4Jߥ^=Jqtբ>r,):жM T #d$w<)A];PU TxURm3 Ю%"CѩA]\=1j"7} Vn@間C7AuUЪm[ԯS*)yEcHD Ʊl:
x |.XS/t.~}.4ST"5!8`&L0Vrq>A$iI1B@Xu}) ))V۫QʣFW.Q^cHn N @>8}z|VrǩP9]x!& )f`BԭMѕo
MO{M>Ѭ!?sݝ9f!%5-uD*TxE_M-j[mt ; BdhP! :wlM4e&#M떨 f[ 7sgMDKcNSM` ~1YZU:2M1OA&%wm[
,i±Q39u8~-j!n,]/*՟Kt.d͜)ۑܲ
n7Bu0y|붍xC`o|\ɩÇ_ÆBA B©kЄg#c?ƨ!a,ĪMjƟi#[/lxDvC{ިuO۴? cp)'q>L@.]qf #|J
6ǔ >*2z{Z|ڭk4Yj(aG,
,ZL^QL!<Σ3+ {GvM&+3c3EU#|U4ݍI#dSvY>o;"86c ``3 _l CgvYϫvd`ʚ_P Z\I߆)`ܴrIJ )>o,]4&'@]86Bvفsȱ.=m)6[mPq;ا "Bi$_b TPpLE|U 8ڵmh.Zڲ
?^n3tN62D214e5l )ͦ3Ks20t;x_^1` [6` C|[N:t4oXΥsa#QeW 0rZ/'3ovdvRC#:k*Lc0r vWc y|;v9 uiC9?wF S2( AαU"9Os1CM,CbP s&LwƸ!is`t&)3WSi A憕x+ߍŐ'.U#uIc7ǥ?GDT ԫVԋb9 |4 <c9h8l6^K -v^IP[>w:D0y0 U7ĩjU":9i xCi'?⸶0iq ~(3 ,"}/wt ;fC}з{[.<K\a?qj0lYL,[wd!v]i:CB"v쨯-8pdFvW j 3g\K8纻pW rВ4|f̝:M@fpRΈbŎ1r N8?Z6G&51g=6oGlhզ-:wդ8zdPpS7cðfkm@#нmS
cޚ+9Pw䭕{A%엁^G "%i)e wcENY9ffmج ֪u+w>ZFT3,XQE/Ǔ1]4gp;b^U*FZ;
h h*b T \Vb.QF as+^}}@9Lj4
6C_* 9A[t '|2
_ 2K} бw 4c[ vE0,3`ז~oлcs* $l>g¬>%yU ; dke Jn*4`99~v)4h5@ 4*
/F1E/a'"L "_9Sg
?N
)6;!Bcf 0l)9,i q
"@MCwˇ&Ù;Ѵn<N\zG3fHl;?ǂv )b);ئDU]7_S[Do&8^
ZIJR7s!滭'^E?/UJL:nf0eU fĩ7?M "x
ѐcu egjw{D`/4;}ʱ_-q;sG~pL[_zƠ/^| ֬[7 ^v@9#
{F?x*#: NchK ,.C:^ P6@}vS0կh"Fä1+j!b7/ᯅ )o{ 2V
æJXhAݩ_I$&~QsNRW S1n[xsL<hT6yE2l]cPyAmR}-&Lc4oߌW|$GѨb <]56 &md
v*vaЌ7=U7Dk܁_^} k#ZyACyt D'GR: Np.ԗ5|cbgӶm{ bsqո#OѾf8r}HEO Gt JRcxߋ$f3a9Q5|l$sWvt9 1mP
9C"r<d{CSgCxw\Np-26㭁zGަ IJCӨ5wj0N;M/?bU?]`g[Jض~%zr.~b=T䏹^1 G Hk͡}t aLz?%3_ T 0NDHnh SΌ-vdv|AXى'ÌM."9cＪ-&0M<Ͼ183 h@ǟmΨ^ݻrbѸ;5&> 1䓁oG|l e1[k>cSyiTc88:|mddڰcK
n.ƾjZ ?dj2Ɣx*./A^p"4>WzAsKI $4X\ewo{/#J/澧qͅ#&}$UiV1/Er\`8t+F#KWs#sscޡ@1Nj4]R7o9XA*D>}MY0A E/
$?&Dw@Bl4Xޝa[4
<1 SFӉ
j4|W8?!W{97x WO4伿k:9|3SᴮfY}X\ol?Kz&HGNKVtC՚
q
7nF:TTFܤ?fFT? g.om 53ޚ-r,č:}AG0!1؍R#y9Y AuT>L"M< vTQknp[#?̘Q+q#^"~a}1T g~NYmo[ERVk넄{^VsgCYYn#C"ѨY+tj qر-GAN`$7MkW!0*Qs 9`CaF<mڸ&NP[FND8fxǡQbml\ѵЭWd;*o4lHLd'G UgzB2>4J?ݏOuUTj&P; )w6k TJ>x 2 -EGLQZU)tC#Zvԑ1HY #FOBѳGWDgcXfz;2e|9#o dJ0g""q3qWԥ y`oB r! | s>i
NIqXb)rt$6jΝ:Om1fXlFQZ%,5
cAˎ=P76Ǝ1$7KWFۯ7w"O)3J7Й)Z4* DA|>@b4<uX0GXy &Հv nz ڶ4ٙXHa<elq ;o74SE!*]yґc+F ;P c۩4>= \4;/hL߭WXnO <u0L>'L Uk]&"c5_ ep UB 1zC]+Y֡W}`̸XvQб y';nq%7 ɍkjl}^]EWIJGAN:fOe.7I5 ֛1 I1c<m&ڍѧ/ԭa8sZݘ0gS zFz Fyj$Gq;"? ] +&Ql|HjފJ}+lZ6FMbI"bN4W
SqshLqLu 2y
'w@DZ^{"z,bXr Dgw@֪Aᚂ vMp HAt,VӴA
_:]ΚISlTHfS1s`Hݑ*h߮33p [,@кQ [M嫙?
M[CAGV,]tk j6LJ |͓fBkzd>}U r8DزFN@pL- Q܁>a4RѦC7md3gbeؕht!Yjн;w#jBzQLBTF#*Gp$^Ed" -9\͝3fb]GkԴnԸu^ξ 븳FDUBMIV܍K`ĩ fcrMcxc4*qۮ?XGF3u}~g8bݪfs~ӖR,A%^cVU|cW?ㅥ+|~\\nZ\\MM
-[4ZCY JC
vm/n*60lXmϢ7 WnBu}#rzbfر~9&RvVF =Д nT;e`;
T5]ݰK!a*ܠq O>{zq|p~ҨؔS"bEۧ"z%PP#hkp7&O 3ۻ; f)Ӣ RƴiRn9 ?M Iѭ 4V/YɜVS' @mk -)0[!h֘faQsฎԤnb,kff&z32uj|=8?㲛qyrg2nn) `*1.^%m>
~'o 5{C^BG&-b65Q6}#
3o :uЧw/T S(Ϧc Uu& ;04hvMF(zlBx| tqѡXoL2k5@0(d3,<j%mTiS͍IfQd*CC1uE>&s/x08^t߂oTb9DUFsiō0)gcH2qԽ 2 s̢< NY)A1a,ZF=\2P&'pf,O1\PG" jN͉!f7<[)ß'8'}Ҭe+ASʈɦ6ww9.!3C3<92v\'B4 ZthŸ<NWiaj~5:f DV ͞8~ e7TBz O: tB8QA#$TǒѰe[WE\J +%6
\s9D9U[2rpdglȡ_<KѼQ]~aԟC鍣b^P: iLţ/
|nTKfc¤iGG
kVƜܝaѫ[l\:o@u~R4+m \INZvU\0 3DרQYхX5
<?c9E י(57t
yV¶n!mrhe&;Е.]kl"sCy.'
?cOW ߈)0AxoPpiqWՇNS;GEo _ݓmxJmyhߡ-"9X>oĨ;u}B+v
v0Y[bb2![P$NQ+T`x hYTj6ҍ<nB\ k(|M/pE-zEKWH n|<:"82}M+[ ArR5hpǽ܈g {O <UG{Kk?O4еE`lZ/~&\Qm!>p :s= >f|ԯ&WMFL̝IG:x4Vt?mS/-/>^ _Bjr5"
=EGaH8̚:
^{ OY#m/
ŧtq:ըZhKpo݄ {]1l w
wbOr?\]: V}3-= ۶nE_ wBlͺMw cŸԮfe^;YS 7?𬩨m9e"Ю =&>ذp*|UԨ ~b0^'="}H|ގр0΅:t٪ų" /<kǦ6ex~C9pd>}ϼ/mk^ƻ?{^5V#|--;1-c9CfsNfj<_ 6i5sǐMzaw߂`9>_p
c}7/^M\8YNf[2
m[!}<<+{ӣF\{ ~w[SιB/`wd,=2 J7]e h ` S4?i+D%<ҳxD| Jѿ~|ܽ&SaiتS4w3JO!Ӫ RUz_q6-g]Y?H|ݓL2Ixؾ
-ݺyѭ]q
\;k) 9C\ô [7Iqx/Ъ JC`o`g 1M?ᩗ>ew>/e(5 N)Я Fkz80|gWS{#h#N
@|H>~3_[㱍G |LI5дq2FPfR|_
<U9#WS^"eVV/OLrkOp.Nc;4 /k@%
+ܙ[иi?DSa-ؽ=0f2R " cgHh^#駟Pso=Q= m㖭JÄhЅtzԎ6.ho,_cF\ŧ&vų狮>'Y'u>vfEY}m䇯@ M@jFHQ16vr
߲n) cz wcݏWr,rڙ=\/P"T<%Ty W}</[ Ձ bgogo=A MbשOd:y,26/ǹqf)LZp駠Ur#cĴ\l{͎ (q$s #riTA oOF=|:I5 / bMB xu͡e2C
j92~6cų-1[ooonoP^sSW<Z5}
kk@xL #&/X܅'：&)\+6}U5Fv@{w%W\ k uub6g e\D xU_, 9> -a|ٍk6,}}? kp`6.Ďճ=`OKOp5wl8jZ> |P. _AxtE_f0EJ΅? >xEHL d
kѵVQw?.bx|^m1m[4m5n*Q!ƀ.FF,' "γ%[ȏL&ޓ}oI q}gck.^钗ըKᎽ ~hW8 "=\ 'We>x\^| <ygx:mE3̕xv ןQ;m@N;>wwvlM#Kcn գ#5`ۍT\zGu6ԝ+a-k}}[Ǐ\?W<:.O jI KcϸA<|Hh-<&kደ-N?wdc; $2a岕J-_1%utIDZQ<͘yWҽ8#e2|384.Bѯ 0bQUFúnB jsZɩL7qU7^|$ c<t7ݗ[X~9Ǘ<5. "Nĕ]& 3HA
F:ESab+dy17x)~|qxP 7o{&Y+GuCWWm2 ߾Y)U6a1Ͽ~4ls;P}2;֫"Z};B #o> D4^;r\j_ݻ#${3M ~K?
WjN!nV@̧1 :C
1rc~]o?{'}9DtJ
I ߧ;TZksmpm/⏫EFT;f}˪y8E}{#9WA?b48
*b?J9<2>36`<{
i|?_Kֽu"fMrk} q.s
2
W'
pT @ IDATYx)m^Ns SƂ6O ;gC]_' /O1%e<RSwakN|c< b%se<lh~x킳 ߿ loxsR;Ű_Y<֮V8u8臛z!UH. 7}?4m;'`̟o-\9UNt|?ԏǝWī )gǖcEd'\s8B<\ x{p|xp楷 31E'O@-3Rg8XLð%z5 '`OK 'n[!2,;fjMz0yݼ ؍x^֮09.Ywh^3\4Tp0L2˟<a7/t3OaT
IPY !. ^[ceXubQ#/<}˷hs ѫgwl] }3 _
˧O2yo]x099lv@=HK˝6 WyC9rF$v";e'ϺqpR^Ъ% و@:x3?
ԎCO
q"EF|i9Z` 8?-G 5m
|, ߉goy;D&1KCE0c6zda0gi
wʸ5s1{5a B6\aw4 ]\h\^i\P6~Iqz ?=30rS7=/9 WG/ƯStG5wNã/%U-i@:(|K+Nz{0]a_Kp=sca<8o}~ ԍǏgEQ5v}bءא]>#W݂Cvs:;J2(</rtsC jw&֮c\3iX}q16XFI.h_*C3Ѹ8J(>km0g
}Ù&& >|1 ϸ1;P?R֬V;d@:5Dݏ<.VmbDnKo 7\|
Sੋ/>ӏP8oz >{$rb~8IJͱto:Ҡ7K">/
uQ\6f錵8q@lп[SLg?wܫ#
~5XUhrM
د7eyf3 >'rDÙ\-u:~ k6lQ6#4ѯk;Ԩ+ H&Lwʔǹ Q2 (~Ԕۺ'b_~1Aرi-7vaaؕ }n_<d]p.gc&+17*Gi܀14'7_D+˯~gsSM/=Dez#AczU}k$yHepOC΅_$悰?
ؚ|:z,`; f%TJ\*3 乗Lw KO>߇d|7,0]bN5r:`E?::q~jҔc1;$<
<yI#Xą)Zl,o|!>=O<"!LDUSqN ;S#Z)9u5eZ0G<¿A4iQV5.!SJq h;LW| ŀYyxK_5Ǎ|'o?rrBr^'tM6 {pwFʳfsQY$O[<Q#pdBv?EBzG
`]E3?nLTBEBEQlDE)eܹ.a{{9s9g4Q\O=>nl% ;BÝLfg<2UKHh3t4 ~k|y:[$q45 n n ~C6}<mu
M /; ܝ >"cBR):XBȧH
jK( p{Şrb= +>FgD?b꒵1瞍!C N5jhߟG
iC)%y\ g&}Ǣcf(ܵv@ХC'4 !
;wVAFv.ִ]k L_3D4M-sWADp\~%Aw<.Wa'ep"ޯWT/DJFֹ p"js{ |0;8`ԣ%e*'lK(CP*+R"4qӢtנy!&9
9 3Ko.f -94 7oyWP ?z(p7g+Vy` Bb=ZG f!,m9WVSnV!,E[1MGǦn=)Dw[ev7 s0N~qF`: <+M$$օfq$Uc{o[GͱĆ
Q;et(t㝺a&9mڢr) wMکj־')~uFfs7FD2$HkfbһcqM$8I#nQQܙ1q0Y/@f5#bpe>X|W
4b sPЀYUby4]8|*49Vb(
Mv^(7:?<EP~`Ds&ap獟U={bȑRv ;G]˾RNĚs!2`̙ txg<Ɛ4VavZ7z!p!&ukwY,uWwnB+'.q[ ޔ42˔@R0 XCq4Lz[uuOgpc0f,LG#s#3!K±7ϼG﹋qƐ8b0
W x;&pᨋNb`vZ4
f.|rһ}^C[ 3qZr@۲_"i? ~Dž"n.8ii}<[
eX(" ^B0>D;~u7'_8 p?=7K6j.C^#ɏ M^IJM]O_{F'{'QP\
S9a瘠g<gZ9o$:V v`e]BԷ04mF琭[ash wsV Qfq7=<s86;1g~ s\my&{ .Xr̙M~mֶ -"f0t-PQB_;,
6/#7,4i2Qo@8 Iےc&Urr n⎵ĭƅ NdZ =O텯^T3@ǎmQ"`VvާУCSxW M- 2nLOݛ- \ҢPF ҽw+#J9ThҴ鴼QəO"¯~Z)j>( Qa粛α:vN @^ᤌ0u;h1-Qe:: '8h yu:C$3p7WRYl*'հ N܉\ c5+n|:ǟS&ġauq / Wǟr2 8ch߽?a~@cORgGqg~)o¹xόN<]4-hi?0Qǟ%hЊu դPZEN ZȣMlZ3fƂ F ZjdEp9
k}v{|5£MpяǧP_ G 1lg ۟փ!ضq .=|dZɛ̜@F`| C!K;Wv p1"X3lF^^+Fa 7l]w7K-fciJk&oF>
\aWGnۥ9U"9k#hܲ=F7yǣ \` l;ccHSfο?)`)6|(q;zG*A |'MWD{dk324C3P<лs[FppÕ#v6
99y\]J|v9 5LS ̤Z 9<w3&5 M#i^FsxQ9dP3Wn+2hݢ!
فm'l j0%2Vt߃U qMb:w5G ;zh
f!ň&0̓ w( qy&yN <DEcH4̼Vf :@))B:QN&5Rz:PI[yK )E8A=/&CgNǪqcΗxa2m94N GnZP!V2!|Z<XNj N )M\(W*>,Y>?.ayި<wI8S+)'<+ A@XAWHrb,;o4.*a;ObehV<-ɦˣ?
83y3fia4_Z[ߚ&u'ov;ɦ t9͝"dd` &
|Mr_y +;\,Y6ĝ`۲eKQ<x aڌ 0ώlyW w9h8Jg'q VLCכف l^[w]hߵq*/]|7b#..jtײN^ .Z4ןg.1!Mʸb6Iӹ?
I uG GSSc ;`_:z+ :geEJ3r]Kl:g˄9 nL8vh(Io]h9[l&a'?d̷FYI!zU]F7piMfnxN9
y<[(R E#}Wm{G
z ZzN/Y]͎sw';,#CF3COz#ew}w |?cc8+X5dÑK̏!I~:v&x
V5%
rͷ %Km<҉~ȷdG;y7*"+{
mV:ś<dM$(k?DԤ,+ek
}Qh4DcY1Bp9uo> A=/9衠)2m#qMkߡcgXKS(x]k{]4E-NJ7YiE3^{w
iiל~^:=vFwWnީN<f9;+J95}҄:3wFSRvt%i1U! TLf0q9Ms){ sVp1Q6ݚу ` XvTt$Z2fM`b6rb9vRފ
%Z-: S
y 3hP4Nr[ErFY]Du[ASM6F H3rznHjqJ]`IĴXw9]dxH X,0y'3̫wxZ}XET3"LC !
&bge y?Z$
pZ\"o0n>'U>cs?ĢzrԄckkN"c xɴꆷǾŞ]EґO?]>ɽ'=`F'!-35#y9v4v`k+c0kdzv, [7Y3r2Xexk {a,DZì@?3ly74~P&!9)))Xb Ǝ ? A0A7z6˝8.45 AhN:1Hn4L/[.iߒWXq%ztܴKȧl |u
N竩Q\ҵ;buS,7?QHhtpCZ|bz-' $q d=Z!9s}"`)m_j W_4 e*)AuS6v;W]mඏ09eWY>JxPC;*pM@jGŢ a*ʜJa[WLۖ<cB&NQZwbtS$NMߜq]Ј+<<nSyFr|+ŬmpG#f. ^lvv |j x=Wjl?,F֚͢<3yVeq0>\W_百nHٸ&/dZ q C%ꛁWp óo5ݏӟy]I٤;}*6-[Deǝ~<߉&bR I|}BP|YfqٗcNЧ{ 45Ъb" }wPp2NCS0?S>hNͣoMجի1w NQ
[ |C<yLwwR 8NxMχ3L+DT\C ~zޛ;?7m8ޠihN<kS
ƍy H>V6u
6\斟j
}M 3|3֑|:BZLP~SƝ#y6RB@hm ĕ=jpLp2f.qpH֯Z,:vk#Ib ٺGK.niPb=
+"ȘNW1N;88i?
x
|^TuyݸK.s ϰ 6Oo7' = U;p// ryh Ҵxmmv8*j2l5
"M}աbҤ]wiP^J\vՌmZ֣ y/شy #Ul9>is|oQk# O' ڲ4XJق x.0/`y݊V5;Z]ڴ|->-}gkc gC V*Nn
~YtסC{:M,t B I˱nbL+:\<׳ţ;9l32oM vħ'bDvE)ߍa\o r,BA
1 ח?5 "nɽ{&8d::|1pXkkܓL9<cF~:tFرy-~NN>ؠƉdaFSLvd_'bF. 8Gפ@Zj)qAԄM3$^T Dɂ*}|:i";L'Ԣw?eޫ']鏽Ք6D︋kK0<K15>6P#>zt/wzC^9;LIF\NlhӼ:d#'Lgb9H߂)_+ 'v"^[&O&~5Fq,$w*uhőh=|eӄYA)Ƅb6Zа:|HC
iML}i%yP<td&î?(ticX?5͇m5iϺk}=hft '3<*ѭ`$b4~; 8VϺth&f7N1t5Km?ھ!ECBѼ+h+'h_MZ1 ]h郚^WC)NŊN.2T3.ZS
䍉 e$oj>U:k liYH*ܩFQn`{? Qa
wHlkaϙs@ ;h5ѐ <j4ݩ!ws Z͐R.}3GZ|48mJ&vYH b'&w+ge3G괅ؼ($s:Z)Sna-Ldjzԅ 3sTT/tkגG\̱&;o:%NS(0 To'o0R!g][$q& &YI`E:X6cԊkFf='E YOąמm_.tyh .EMtMkˆb^},^%v{cHf_#qV" bj hYNªA=3<4/-)7JjPּ;6cGSmOp~ 6^*ZtbfhMގml. g^<Gow:l; R@xqxHdN-dvH)ņ_ys O{ܦH^M8:jg o&rc\.8JNd \mGq~ƻ 5[ޮ
xqݣХckw~_ 0M p ֮ Ѵi>]k]/:0&z @y
ݙ^_GtbomlVM&V* | h!o- c^[WkryYðH8x4kh&spsc{5\>Z>xyW w({KDnD]~M10?JOƝqMk^y^<vӽ/tьl-UU2 IŷC10&4ꆇoʗf pRi_:QtT[1iLp>' `p8@hܦ+:wh[| bkTH4#~{q
bst '{ ny`$dYB'<~<ɻ!rx<K5kMq հY :=ѓ>?grsixw3
ؓ?=j#Ըi2λlv)M{tą'ȇnuw=Fﱟr7#Bf<+\O 0&yc1|:U&91{/3Qވy!/H^j5h;]nCϿ;;<ag\Zx1moéWݎSgI8z ̜6ﰾ_w*cZ7`:ɂn9IB} J8Ojמ<NΝν#} ^WW'6g]z/k턋3V.p\f8.e{C3\<YwuqDbk#)ָ@É=Jw{1>GжF[vѯk[ԏÿ7o l\> zy DFװSʧʓ/-$k ;&!0 c{ 9qiѣ-Wk$y{B.n p4.+t= j5hĭ,->j#=
F>i GHGk 7g|Ϻ}4CВs5I;nZ6o5֣`zr=Xs˜zf" =F_:ғynuĦyd\r2n:Ǝ]!DtW^ıϛ?%qwGP& zTWԸ </3
|ay8pt=|q#к.%^mj KPxGFyN Rw]s> z-ԣHlmzŊ+NF}͛uki }#:(DPus᱃9q.8HAH@X&`<z)1KhJ orP(v༓rq:{ {n1MѿSc`=3+ xsPQ{[on#Z2vNlw><S &z.RsY}q_0 yOn8\ x']7[q]ca kG_Y sbDh` D!,Җl&u͘DxIA>Y%L] &>)~x5kg.qH)P1#l'Z'6FL9/S+Qi O nv6 GsY+\q0z6{ <*q)<B$eK~s㪰 w {2X-aWs|l]>
݅X\iѦW
aL'zbXGiiRd9
S.DhX<sS~P7rRH}p]s/6 ])َw_ q܄iӐ>p|n'еi\ peBz*f={+ιU QO?<~uC/cr7/Tk'=g;u녶VWDg|]}0[<yA2nrPOe?ĈSCԕoN6V :C %y fwb2j7\DAq%e) %ozRn*NOIS4Y,\tݜuAT6x잛p}O/>]SOElA
zt4>*mMov cТF n _7rcYN);qI8} ]y :<BB9`mK^Y[w'^ V(ܺqm 5cv)/
heeP1-Lc 'Ԩ^|G= s(C97,w˩6$ QEC վvV9V13&/>u<b˔t N*5һW ѻcg#0Z&qm(?l~ Ca`O<ԡ76T7=`""ijxt3p#8fԛHLym?$z/6sA!GG/&=蟼Fb흄ϛ7L"ZliV, t+E@ x..gh2 `S)ͭґ_34gvb]"DzV9kTAC^EVQQ>M38MOaV rlU=Nʑ疸"BuIc*Si:0^kSx ,d*qA!Q(@Ji 2vox= hU·֏N!EdCzFXk l48U
ZiQFeZ@,s?C ^I*wT>Sm4:ju/+# < JAyfZ9f+w%2xu wSF`U<mڴqׇhJ?IP,Km) Q' PC8Ru2C4P,Z0AEf;lBL[(Ͻmټ<֠ŗ8NlP8v3G9tϝmy̡ߋ! t_sv&L3kG>8 /y]OFt\4($qCWDҔW
WfP0ֻ>n{'fҜSQU j}߲SIǓgKf`qcyHVp!YI2X|^VØF>N+z| p\\ lʰdP 7 U ̝]l<M
©G Twghiμnt9ʅ`]ʤ WlX wY_wjw<NZ%'k&3L:b
-ucv*3|3թ{7.wwr[w)~ E|(@04g4w=B5䓖){1FhHbn z y0gg=RvQ 78 mز-8+ a1q=uJ1tI<N JzS
P
B_H I=-k̝2WN~"ھjԁ9lהiW5Ct LdJ9ˣ>J/)tL#k wǥW Q:YLJaeMQ14V
xǁ)$/:wgAҧ.av 8&
z0K]"9zsȦLVƛ kraz꾈{)]UaM+:vtMA~נPE`]9 ۶>4'f ְQ#K5; cZcVf-⌙%HPꥬ]ԭ[zڔ;DᑞÉqI(k(
U |t-qV*eX'=O)$1$hvQKoJOUtR)MөCucL8+W,Rvlǎ3LF
e2XU4OdOI#mII}L xMD{F'2t@BW_ Lʌx6uxT ɦ L ;K84P/IwC#цn҅EDvn 'P~i4q(QFFT.ՇjsgX;9iM\b}H^5I_n۶W"oy>;ю$E|if<;}C
Fp ˾WV}r4 >7L^6aҙ|6jhW|zeRKz9}
ă_lVzMTDHcEWL# }Kg |䒮tހtDo{6ڊ5 ;ᮟmѲ`b?)%{:] >YA:2-eL$6** U?K
JAcݺ5% |
DEF>Ct{xϷȣeV,i'c_nFP (zX\ǫ3pfh>KDi+n=P =(cS J%M^C}h++T7!ChDucv9Ia[ sH0d5:踨P/,X5:qA]ZhW=}d<L _ Zm"WKOё@.8\ 5z}SXı,)&n`_>QG4fʱ wH.yLrlʶks9^%d8azeҩ3kQIՏfS7Ci1⩏P/H~1e ŔO*UGc [FaW
gY bZ>S 'H6Pӌa-I$MtM }1 ~6e0∮"!:#Qc,0#_Q ڵkM0tP_ѲT!i?h.ljVAЬ')N#FMv\5َ%Z)Usת՜OxQ#t³5x <)jR c@|W 5 0g*i|I08VPRS?àW;;gpH曚rH T|pWpr4S9
DC&jWUB+P $~Jc;1iB(!;QU1O n4ݬPkyf ?1[DQdmoW z
[T2.HpީJ EnwG;'^Q~#[}|oV@)}M&!>L:)M c!u^j-=Qom/
g99vM~ФЌIy' Q]DSO`:ȌLܔ<MV&j>?"N4ן7M-_z4p:QӶttׂ&Kl.S&kڲ镒 /F|m/nwjv=xv'<+b7:oBwm|:mURU 'QӒ9} `"i
NV~yS9[) n )}֔eK-T3 ?Zsg}C- i|_[25Plj"b&7wL\:663-K 7tʏ0r~E:! ` |;`Z: T7Qo#y'm<x^ibat jxKzH|>ƫh|ޠcc$|eiA69jz(^m \T)L5|xUha`>J1|)I|L|h#}(>:fi+DK?&Na?zjS ;%^v
G#MQF)v{ȝުmoH)7T8
1j<ÖFvLKYts]NеСɯ}ڗP R|-nIkL/OO讔^iׄoBy坠n7%|ƶxC:ϓDz&r
kQvt}Bhb]A瘱l[!=Y\Yi{zm1U^|it+*𥰶CB<"|̂2w^иH'ǎ #y'~%lmyE$v,lNn&O 2'<=7<0\GrJs {ui*P,[ ԻҺwy]i5[PԺR8^M 66_XKk#"1Sv,c.Wo.6WlR}W@K/J
{h*ߪpqVqSh\ ]:s8/ W&vO;ݽ ~꽋 N;8at&c1^0 {8ڤ>ytcڀ:b EKoaND3W Sh g~zXz6vO|7m`pZܬ+irgh@2k:*&I3.K;X1 s<RԶ{d9mM#*Ke<a
{N@?*
d "*G{S h\d7L,N{ ?UWWDDw|isO+?L2 &2ah`iihZ[_D7PE9t ,J1 1 BopO(J߽u>Zwvr^ zE<₃kZLD# jvx h^a
ʪ(?"Gk'/vo
&T^}p<cK#Yf?/\ _ JAq ڀ)zx25 &n :jkμD wEez|%Թ,K*2P!n)~33#8|zgA?qs&~:2yYL 2PLyzA+W4+nwx
= ɾKht靂xߕ8 %!O>lzcajɼZbvQFFpm;%ﺒ42PZV$hް,' TUҘ::uʄ6MReQT
oM=)?ZT'[\ NyBUuEOr:H>U+d0M=DQEG &Ặc?GC˷PH?>\( M]g`x*w&זپo\Zh[) LCŴ1R447tt* h~i~9t l*,(h= kB XB
<U ?.Q(G 88U=wGӂԸxwTZֽWz}_M{ lFOje!,*`8\^JrATp՟Vvk @ IDATW=MSOO3ri\|i՛68{Ǔ ]
=+W{p,C+*ɛ2<ny)Uގ$NKUO4tfk W9FTV g%ë_ ȤpIu9࠺^^xa7> ׆ eRY Îˈ}t /$^u!P7`.^)oCM
MOC-XΕ(.+gUǏosp#|J H9U3Ws82 N-ɠKFH:~]i}gQN6ڷ
RtQ0.V`LWs鯾_8:(tvk oZ^p߫z:{a7CT+8e Ӻ}ey]4
}u eDZ*V .&A+۷o7\U;iJʩɪ ˣtV$B* /\/|G)VZT_ot@@xA.呹L`ެwSmoi[y^rsrv,qέCtS;*sm7 xjJzQo[%*T̛xUQ\*~r+GBɊ;8~s|&SjAe9Р2lPl
2TyE7ݗ<XAm悃߶=Qz5j feq6|YÛF.YgS^ne.Ӱ/OG_<#: 'e̗|?v&r ;Nnq#>;.e CU <zhxG{o]+?tUqG?PZJ'y 1N`z GžhBG*V~뻋wms+}U0]^= |G 'o~Ce_ăhyoT V *W`]e0'|%\2. #~{
q
.38xaz+^Kf4ux7YT ֕7ϾwࣺWG ,p ^j|h۸qc]H:$S;5 QZ
5P/E|S~W |=/bV ~ +
pypNVWꅯ쭮JK/|hy R[
j:ԛK{} mcoʫ︶u5L"{^ /;^;>*GPWW袧R4U>>wW{zNUzAyն6 ٕeop-/W.<]D;'+)9~] 1 MM[m~CB+ᤉ<O2%{+5˟'^>>+Y^.Mux=[W J+xVi @4W~?}@i݀G?8V W~!G<> K}h 3~e:u:EpNOjh/~p hH]|/pY9XP勆
ƲN;: W %U`J/H [4U\oM Ӝ.u:͵xXu mVTJ^͙3M4A֭6 H%aVm%G͛dC8x97sjFL'gb"hp Z\4ɔƍ͂"BJrhCJ=r0hgv4N@^xXgdS!,+sb&
64 B.OM(w
ZҸL7_k֬1l0S̓CKUP Va>(`E%H?S@5vwǿ2 (ʓp+䤲vRC_媎S+SFk
N ߿ P9USx Owi
cӤ4su&x
=}S @}=) Y/ pu8U]T8z~:?oD ^]7\4:iiIr5Ll/Y< >WNOoK{>*0<S oCmgiʵQ\tp'G4ur䞎Gi+b?ۋ>eA hfvp*L"m;)ޕ\{108UIϟ^<$M'>aqwG) ?c%_&"
~?"jy%ZoG+'c6okenQTؿ.xXlBksKB}ofd<qO/LMJ*Ȭ{y6d N ~ǁuyCG]jTY ^X7o>*,U$K9AcAy؟"W3mN/
" ?cH#])oK3 m"Sמ
*dWI xL?/ͼk5_~
ϛ^)Cu<6epc!fP`{zthȲ?ZAMuW f? A4^,Jq3فň I;?F~ e04aCpe@x? @ٔsQ FVoǺ|.b}88Nmϊ Io7I,^xoK 3Z\8m鞁77MI9ҳLA߃GcIo?^4AaK@E [?1;VVΕeKk\=^GE=wګ<>oo~xoy|.r9 O>8Z [`\}? } nz^b jF#)1ܥR $eYNr` U@T_~o[rѤeC Ύd-(<il[-8tWW`e `*-顃7KQ~E ^wnZuԞ NW~ +Wpw%""
MG3 P`_0r@Y(.㽮Pvľ{̐LDDF#~=#S!bn^iV˯*NRD3_EtN+K N!eTHML(VjGyㆂfU(/QT"k FO{_aK
mN $VHjx<T9 NE߃$4LDD-Kg#*ċŅHy¢DԍFB|l`MӦ?P4?^NpݥHODhmڿ~EO1 eW*xxtl E52-Vƻ~1)^"2
#$=">e7·ܬtfd72
q1Q :zo)_oawnme+zc>9Q!yvD҄o8&Iy-*C|BD{'or*XyYfy==ɽqV/tK HIChD]$6oׯ\2t 2;ڼ;Р%HMم<:f9
m9^ \K]&ۡQ ?`TDÚ>|2SaHn
|2p\= 3S/ 5 ]@rЎ1x_Mؼ"$::!+w ѱ]e P #bL{r&g JКUúWb| >͢n,f6Eam<uwr
gb;xiL?\wNEt 6Sw˵Q<Ic_o_= f0-** '@ (+;&rH/@
Ř(L+/yk> ߄öV }(C\}l ;1ꦩ8' 1R:mkDXQn:}y4 ٗ 繁_0 3Ob.Nx
7Lg@0 kצVKq+C( ,w߄,L ~4:H0U SƎxgmffz>.8T$'p! jt;ן{e~fE}$
,?O>*[4C=FaǮLtΕ8}D_.HXS=VQƟH۶}
|+8qeP?ަsS>_pKߎ_ G'< _uioj*4o)wų> !]Ea) 9xWVmqqc@3[wυ ȲBL73n0t 6g6CyQqݷaXnf!&f❗Ĝe)䢀Sqb'ocQI}qcb:Λ~<]]Jr1xsqf
R#]
ÿ.:MbjƬ n8E:9ۑʅneKǏ9 єm m@U.'in61%|:"Cq1 7#ǼjѤ rҪ馉_/O yعq^3 ǝq1zuUU
c>ٹ~1. =? {)ڥaO5Q-\xu8VRKz
~dq J ~({Ʊ =3Dc,\u]8 ^Lǫs0;031^{c2< Z\I_K?9l
}q QlQI 2W_Uמӗ[۶K2tɋ.NvtQJ;n Q-oI(>d{G]qlOX}Nн*2*j.r%*6٩9#wQj9inP36 ^6 #ꄱ!ijI]yu\>Y g%k.+ GU:s
2W.)߷" *#`o{eR
Ɵ+NJ(!\!t0̓ WZ ࣄeWەOë:VNkB^U(m0Y-
8K2Y50mB0EREԉ@
lRƗnL
cSF>y5B8fy5t͙;YپaaBSJ~Jޭy5RcСA9x\#77&)ꈇ78s t(/ ;˾NK7&R WJZikp1x<Gݥ).BG|E5SZv9y/Jë_+G.6t 7z:sR9 wG غf 3hn'zND EF}ft:*5ꈐ`B ѬCw͋#3/CMM*q"9exf [zzu pݙÌnw +]U8qﳏw|lzvWN}7Z_
Vo [s݂ upx0]d_\d"^(>
:Bi7GiގY/Gr&WfUWi Eh\zPET71܋?E@o2pt8Gwt7'>,eR,(,f(U\:ʻ1Ǖh/ODWZ *~zq.E(+1O㌫[Sf_vFMk}IFX部Q\qQ]RHμ4 tڌG~S\p]xyh tnݓC3 T~y|LD8_7ӯFu1qc0;.?C+'eE x0D uʅb-NM,>~'Y2 .ƄG_ϑǣa%8OG O| Cn~w ڙV*- N" ~z$:4o_ГOA&pTGE:l a꾕aTvzӷ7;<mKѱ04H
ԋx FGYGŕ*|7Y<_-m'JWP9Jm &з<Z2QRQґ?̛=p0 k/Ddb{{24cpWճѽM6_c/mCpՃ^?XmND&h&MEfF& $uIƑC[`˱q''Xeub#k[bLg]s$Gjdu {&t棬bCdwq}9μ/wK0PcGIv>#huPGm NG .er*
G ?L]ڡ&ز'~GۦQX/nY??b95]ʜUXb|bn8Aܦ s, w A͚|K:} zwŔfa'+G{8jUBxkdVCTM:z];ų-ىF}K$㉋%<*mذ N? 9:D
Qr̛݈nV \4 Ez&UorE6c5t 'r_MG.8.찫c|Ԏ QcjRWQ Gw⮉kwQ ^9dga:=wV pAiz1joyLzêE~4V{
Mi74}xv}}B-^H0i 醎 #v-sW `g'i0g70`hTؼ 9prt]Ŀ8}3[u~wĩ&N
$͟?Gg^hK=NKwf/#% .tDi ؇ Q9qs q8v,&lmI݄oQBf}O~9`;\. O 5M<;Ej̔z:*BJ/-(U!l>)]PmG @ͨ~tikAx3r89 WahV. mW~ĺḾC?Ͻ vCtQO{}| DrT<q(g?n-L'A ~P-
Ĺ?R]BAMn3臲#</ 45*'w>hmͺUojhٱ.hW ߏ}9 c^5\^XIѡ0Wj5Bѥ`ߗ*@KZ,?:~avc
ל49ox F~.f p.pԩ1 qCh-44ŗ_ M<$u~ \ (ɅO~U<cnlل~{-B$?}>tt_Dժ]q7'aXna'~>`}/˃kpW |;t;0K vɷxؑUq.B͌5RV&LxMe5N9g4ikc7߉#Ƌ>AG#d iégs?MSݴ6X]Ci9e?Ts_1-úW~ƔQgZCF65 :bpv# 5ʰpO0v3 g _1S?]R21-fw]hU7;ij Ίmچ?Cɦe4EنlL`^{m)
6c.L{zBc o.̚Iٸ0 f~oq5,@\ͧ2l_ ,i~i%AMX$Į\;{g#% z5ǧ7ɋsM6mhئ
pupU69k&6rCM\Q,C =n;f&j%5EwaҔŖ\zͷ]srO ~3xtz>w8Vqį8AGn^
F% @E+Y#x~U)N uB m@ʖT.{kijSa_MxyXR6
wAbƼvY_ 9, 7+7ضv3~^T9#/
,9aէ 6oJ
}Evz
ҋA<Sw] Tw<{Mʱtߦ7nO߈?cަm\1fhwq0.p njܥx9֮\} : tmv2Ok73
Z8i>pWÔGoQ_.-MZtpH
._&!9Ҷ#Pd RgSCъ ! YyG Vb{o G |geľz(w[H_ O(NizorNK2)ߣB6OLdq">vg~ Z GX^5~>W^o |[RLZ}E\.Oꛜ˲ͻ8g4˖ձWa@/a3{dL<br球Q3? MSLƄcYؑc"dgǯrhP;?\ eްI2qѼa$<MiIvdK~ ͚L6 ˥ {+ݦ!!hڼ59E-։AQwhEhqh"ɟ 7s: 7 q!MvBʶ(vH8S÷? XI3yY*ذm45-<&!kz|8Qe?4/H64mڒ9RhV(;ljz!=إ=]-7
к1:t^bӯ?".2
+ 1;M[q -u.8y(&^ڱ
1y. }Ab(:W+.w肤F}${M΅FQn)zm N>2h0ivD\z7/i;1pDNK8yQ X1<$JŤ9p ]Õ
_d2q XEYwM˿_^MкYՔvRؚ]땀Tr[p3%E :3~L2ػ,;!$H#=QpWYmmZvZߪ.h7nA7a&@BȀeϽ%o>D|x{=w=7 ?Fs1tD
UϘ\=
df h`CaAgUcȄ&Y.
!ѳG4W}}wb"_>붣&\]A͉(<R
/n!^R* >Tq ƭU{;. W\5Vu<w A 1GӲz~LOHTQi=Wp;LrƯ7'St+xR[ ZsqJ]XϬ>) tH$SݘCa2;^'^8UpO,('@NT @VN)Ȁ [BH&N: Vۇd_g]AFz0^h54b#c({\їn' 9*O? 04U ZAA1Q=T\)5Gl
՚U0UЬQ= Ŝ$m[hg7^ƻJe;EMRtZ^ <(iLЙ=
n/Y-zUy5Jf Nj@ mnn51UG<VT: e+9WKEGa wiײN>xjzdͽUNlV~@܈'911jhZ-RkNQd6߶ ~k뽯4(6o 9?s\Zl{YFI0 <Ιso+Fr*-<NUU5S4ngHÒ9B Ɵ1
ݣ|ím\iFO] uبf>Ӫjn(d[/am!wiO^6' dm %셖:jH%Rfbq| ˭B
NGy"l▧R姌}UT }Kސ $9"Q'
pHh)P뇜"\Dť-r WuACaҠ\LJ e^{ E#~~}-")y V~9vFD?f?.fm؍CxKp7n<"p k,#u
jex qS@ͩ冯6 DUIBQ]7?xՕVRk-?8Cc4L?lɾ}BsOo3PY9H~2õ_u QUfqa-//203J BiQ0ۼ+1Tޣ(2jtXxAͭ} OXdiIrU=&_ =s8㓃իvH &8'd DACMi%]Ej~<qރfE?i8<k.z_r'꒬ΓaK
e˗Le<S-Rn }sHgA}ЭO X/TH3u(>p^FLz#nQ ]g{^hkEVU d/1]=c5-WKio?Nu*c 2) mn!b8;j[y{3tx:YĶ~RaP(UտlU$NV `',aUٌg~ Zj Ņ7ZA'8VƷKG(aƋpM Fܲ):r`KT_~z<E,
NK
O}M nR<:L~,)d&.#?@YV圠QOZ]Ⓘ#=y.<le/<{и^J{Oë\v J p.iD%'g}ᾭ0mqSNH; +~y;_ksgI}|G£3cݗ㝿 RZ'?|N-uh-)iq)xov S=/;ڕ5 ö ]Uorj8؉CPڅv
U
4C/=ԑkQUUVi*sS18NfqZHq5 >G˓woa m7U7j۪HM[k,w2.+cw_wb nF$Oդ<B#J4>^X&ѵ$=7O7Զ[tP{26h(P p8!J9Ϋ_"h5%aV(-30I?OK6Y4 0Vōqmïܗ¡}ʋ
90D
?,#s 6TyqTQќ],`kA+]-+PsQ+}cșè"qE@t;w3GC U /GY|p
O ^qW3| ~j%b&$脨%?. S&/o.jDz7??×z8Iùɍ L}((I4y @Mf}ϕZbGuJ.GkDjꑝ~>8 G|eA 5?mK&j Q]m@ۗ¾/
:rZ{ bZ )#
s bTPc٪xm8?Uǹ^x u@ž,EN+$}o0i(R,zx*d|yC#;a(砘Zҩ s \=[y6&.j1]YF}_ ?NHtC/
>a2@!/N{ mWƗ"Ho G??
soOdD/ +ž1O{at{8eNq~~ǫz'KTOG*B_H
#ۃd<*"3j[ET.?z<8iRjr+pNaa BUR\[ 緫k|F2iF9jeTqi?Jv vAAV{矋;^s-FtÀ !6*\~fp % p%S->+Srܘh_oL}N
0^qU* )s7s]LN_sP*Ү6M FnLTdV>
U-ЃH"^D {*q '4NَFB'ܕӈQ'B6)]Ncz2%jǶvR
QzwhYrϠDDc(F
sUMLƷ~ZEJ/՚0w#؋߲j|dP-]ESaGGE)h `t q iB]"'s/m{@h (ڷ
<7Xmѣ=,lTsb"[|)oYai9 H[~[̘=_ws~Z3>?m~E VRZVJ2wm)V+~<VE
pT`ۗv`݆<Hq%5<}(6.^o؈#Kせ>lk S&1nZO)pU`T#OCpǠk^ZTycK;Y~^4"·hf
r nt%%"hC쉗ohuniW_O[z"s/<+9GIxeb W>|<g畣40 Hy A9?A_Vǿ{(-+G~NrrŜxr~-?*AAQf1r\pu?
R>{6?-[<}έ^
T)@^
dbx<w"ZVQIې]R< =[s6\Jc^2[dqcv̝U^AH e Uޟh%NL 'QZX}KK
s
y Bn'tHWܻ̞݀<NGQW\??t
k&lY۷oÞ ,Yr8;c<wKyу/}q#)6 do=W
Ӷny+qOOEҸio˩=#EvTW`Gf>I)˰/# [))1 1W܅Q([yҭŤIC{1>ޛc'Wm}1apز$$߈z[n&\~ x/Xf9 '9&BC]|.~쿱P 2h+ƌ'"FlL=(L~?,ͷ<+
?q O;`,f[#v_2^ĬE0wwEv;ntT}={7m5 i'f3fesknJQ .-U/7 WL.V GE{)˿fdɝs6Zy{ko9Ux9 y0o'$pcUinKK5jJU"ۏ ߪ2[}Q#17≩x듅8y{jcU?8s1} 6oukY6mEQ9m8U<jf \!9Q
Qp$[6l+f,u =u:J,ZL5YD}E;[}vmc|7]\| nی,nQ-h[pE; wC|L
1m o\n~1qYD\A[EXmIѬ=ij<:i$
5j2%9RPxx+ճ'܋^<uh)~u#8ghjFH +mqaPsghtTNlW]RfZȲ)ܽx2r܂Ƴ ,Ad$wDŽ>x!NO[^v+<s\ dM{&٥I? Ҷc5 e3NFG!:W PΐFGGs 5H`K#j8FaDtsKǁ))TI; Qs2"s&e첡P-Z- 0<!} 4Bt>M>^ݎnAdIZ-,(8Oa]U~ 0=/x8P
UΑј~HSU<2I<mTJ1@عgXD;3c(-BY~
@ w
`'8;3c$!c턛<Q4l0xl[qFw ːo>#j5 9?GG1 {pk++X =+|F+u, lp?<gʠuYVD!=؛?KÁ l\ Caާ!;r aߚ}Ɏ5*S]+7f"mA6]?^Ye*?Sjyr6"l 7? pT#ˣqՈR} mGw§ɩ `4}~6]\\0Qƚt(Yǖ4ŭKzutCU!^F- W(K]t*tW?v+0#/
ྞ#WfەWw Mٸ]ZW<w8wNltSTH+YJ}Y]UGs239)ɥq_ FwON`ZVmDVB0h8D˙T͘H9.Q l
\6#?ӃF 6C91N _Vq\~=ߋ1Cp
#J{Z/mW\G*-C_,?G݆__Ji [XXO`kԻ dBB KWkˉmV$/oNBpE0; >|/벯iht><+8stzmw~q)Wyڼ+-FwcX ;cB0r`?Ȏh ;| 9=? ˎ
c_6&r`7 #.9'tE~fn\{ +~{`N,_Xv Ͼ*_i ϰWӝ?^ȱFXh; Gt d;fڝ'Wu~u+XeV|]+o Pa5 [a_.6 ų Cg LB;;Ε3gN6[= @ IDATԛ|7d Sޯ6P_~ 4/OJǚi9p ߙt <oco4VXw~]2\Ѵ "<g8s3%4?¸r2$t|< x⮿a%!![g8;E}aѻW<q\~d5tG? A?Ŕ)& &sĿ+WeT59a}:\1w\G`ؐʼWoOM @~ />97\37Fx|.> ĭW_r }ʘF4~Z]Y~hrjI$6;U= PS1ƍ/i`t|j2ϗ%/ڂǞ7&˅ M-g_/'_շ㖟_d{։6<~uז=sFCe7}c ;MzkK}[rrrcS]OXW)>_5iW/ _|((JCeUgˊgHXf^RP\]l|$^H 94Auex Ku@ bU\
ZH/Zo[^`вS?Ͱj\`gO.@|/gj9p?*Ii }-K'k<e6L@TV@0y=b0[?zϳC<*͗bNL;#<r%ޗy4q<ߙ+ \@xa<zH+9v4
)a
/COr&Ȣ_0ώo
K%CЊr5 2& 3+p.KC lБme,kKc/#
U!N9X$L
q|<' Y%&?1qaYbgɃ;>[! T 9tu?04Pש㞒*r+ PΚ( ə!T6`g
vd#Xɋ{nM' t ?QJ8_d`QnkqYf-
Ӆ|g6Wv8̙hZ ij%䄈R **2X Qh)ۣd*b + |GD(
/{O% "+ӌh8Bá%V;~GF p
֠j"Ny㦱*ɇ1@b T> (AMQuV]oop9k@]yl|Ԉmlt*]<=Y2.,_jOT *IhyK@BBjò%A#Gxnv="c4YSαo-.m,9&p.א_A
ض )1~!y4_՜JGD DR %Ŋb ݙ;
1
ӂ D%SqE'3|>PڑI_wr밈!G(cZa\TR2,llJ <^*X&_NzCv.~bu j {J[ P.vȖ"qtSqU
:'tA4cqz8?/y72ʊSʤc{]mp5QyR<_bk$-4*,|x-.!>
g `;e0W};DZu#=y2//O32>芊JօB
\[{>BvUQR̬ r奔N9{1=q?6VjV!i|8w1ܑos9&muRUo5 P"8$X7PV:HmbD:k Tyq <O.&u# [0P&[_iI",$e[-N={Ygi8YqZ,ZҳgO,l-Ȋ
ٓ=4J&F(;A/
y7L,V6 @|POf{`0bD>h4N}E-ޗ3WvTbͱD:'Bϗ=j=d[L}[JQKT`)vx.[ϛ v?VWwQg2@V%(WQTT.(|55tY^ -ip/NUa\U]`VT|E,?i d0 X
7{2q9'/E-Qb4) ˞K+-g\wMY&/OK%4RFRep\C ")\did@
K<8cyPsمzw
~\uV:FL@WRY YGG Cphd%znNvD 4*K^:kjO<7wΞ.끁k )I+ݱ
?璯`wR#|fW E#<& Tݯ~_ʪv2(`)nC/2$
{}99irl YѥnPuɢ :o
BUד'~{y'~t| wr==8Իʘ7oDk.3·Br
NFu.z'}5?4Utv]k87:f8p
x-8-Zضw#++K BFR8 .Hi{ Mo{MqOޝ#}]
piZ .Dds
F __^r&&=*5` `nFq~Z5"p)Z{N=wJ,oЦޕ<J9q#V»=3Щ/S]g_\!
vGgͷ:L]1lnn;OӲإuZ A@4ݲ3c̤d-PIC->k PxNс(kID$X@x<å 9Yyqԩ,nȀ
>.O
R9J<n8Z-吼IA4ƴ[BZdEţ-C=_RFq*WXm̃qoi/jpҏ8Qq<j
?CΞTKN J+]t6hWe/bPTI$ "N?s}P_z:]~P'#3;rkKԻ|
gR: O4?N>hʀ3,ElYH4", ,m$Mc>+дD4wOwͿjOʕy ut{BE" P|o>AU#$ :?I/Bf%vy?q6*LFvwQӬZmwmAk>4 {Y\ C^䯉IM|O5?|髝ıU岗C#2qh ii O&Us2a˝={'VuqG$Z1^])ڞO]<@>fZFւZ1u"ri
# ]-bhXukhò:y`c>p. 7?"HT%"!y"Vi,rzP\x;~/)[cx%5}t_WuYr侩?KV8"0 {i- 2g=7Cxk;J]* zIR tSvy!f2]IDq-!=`;:;K y dC/q( I&V(; ̄I PCOu] {ǻJ>>mL#W5 w\
KTPv/ ~cw4\k Khm5_ x85'1w*)7%IxpVڛk 7< >xrii0טֳ;^]iH'εܥ([\4s!5>&6qVNҏ;Iv{FcnZqLИkx9|
m]9$c}.yp
i8-e<<La7W hjv^=o@ӉKN&ZrhI;yD ߢ$NcVBw=u6>UH bn=ET6̽܃g0"͐-_"5bKJ >'[Ӻ4rqi \ɳݹ&,سI˅J#cl,lԱ4qI\6&ŕ[MB7>my4u5>k;YAl۶mjۇHt'aangWpΑ]uF;(# D-mÆ
2d3+uCwǃL.֭[T xy|m -1ec$
QMlj-sE{=C_>'[ʿ%i+Rfȶ5QooyOhU=<Iq-$ u?2x`e nG xwOeeeغuưl)oB@=y77oެ?8HOݚJ4$Z[. {x 5m:s
u[xAմ佖oLhZʢî]T;4hP TK s > ݞ{?"X={iKն&!<$lKWfo!>y=
˛NhԶ_w|hz~vG8{)E[_6XOgN{aS=Sqex:;X;ǩ±p<T/_86Qwmlx}*=&X&Qݏ ;U
觊 A `0 A `08&uL
A `0 A p
huVe8|,~$YGRӱNZ;=y6m7DDwT:z_{z9U|W:J Sȣ-uQh S ;%AQ iKZUqDuds5 rt||:2Lc2uy:T~C7GDǞ~<dz(||W \z[0A `0 A `0ڎ@*"ًLi} A `0 A `h?z\,6̻R:F@ %`hϻs< A `0 Ad! J(?s.ΫEwPTTjuĚ
ضL uܺ1 x=kWuo'Zh:NZ\ fW &W2_k5xo+-x1sxe4\ʇk:{Z iav?;mw.kh)ǵӐp0s-Ӹ{iN6`ӻkvӳwpI皇O髝UW{|}i] |i?MW_ݥyI j?{]<]tz8_⺣)_u<M[t=ܻ:{z s}v]鋿?yritVhӯ=5嚏p5^kϚKu|MW?itxkepMk fW 皧=x" $$D ݺVt)A `0 A `0 ' cT9oA `0 A `0 '+Vt `0Xhcє `0 ABU `O4 A `0 鋀˺ `0 A `0 ? YA礈0x۔ ?XM{? `0 AE͞={{n$'' d
i'jkk֎8
g6 A `8hU@E>}bӾM PQQa0 A `0t8ZEZ9 ;\)~`ѵfX)<qI FmLM}```О,/Eh9 `0 AT!Ъ.LbD 0v_`w5_D-"hT> Wa:PHͻ'yi@$d{t=BA蟜Ic2 ^RNy@ړNr2sX1;ٱ2 A `0,+ہ҂ݯދ
oo
}uJhTFD A0eNv0 Kp#Z:,,40D B`#
-Bu\:(l k VZф A `0 C]&|zsu 2Q D}mݍ#K<L[[,O[y723c%KƴiJdg!!GMiV-]GqY30 %^ |T.?f6@\,^9VgGhN6!:rIA?gYd&+
ط}f9z#NfX pa Cw|h uUi+sĂK8wDޢ!5y4ձgLp&Wt^vzֽ4hzMaļ'g+ <ɉ'Oۺ s?}FbYjGb@yZJ
p%OE&m.ḍA `0 A pK@')Ij r~4{u>Z,PUUa͢]
v
op>-H>UeELJMBVWE5뒂xg"ofL Su
A ' 6}= 3 D1b ' jɁ}K0)ካþRe.Y1/,GBF =z<9pT+JVօoqrq12`\K-G3~!4( hƁ
M\%8Y6 aW1h÷N夀}-RA"WX7x2,xi
9AoEP\V4dF ụ( de !ᨁo 9!hmgA`Z/i} >
[͗\khAa < ]_B۸.8NwK?dw`#vvDP.e4LH >lRϚ3A!qd2Hi8A `0 A .q~rީX"dC!~< >D] #YyY w ]BAq ]%=PQV9()h쨘NM*"ҍOEUi!I r}. c^ <g'rGR S9pA 9ZDu[R7%EpT`8Dtey(Ş8RTr!c&~yIWZ wQo@x?W}PxrC=b 8Sio /T"co ^BR%%:' !. `sP` =2D&kB,y5~NPk`C@AV sݰXK`U5) qQx{0 UQ\V_ $&@lTr Qb q
A,pVq䵢(EyGnݺRGs!aQyyFE }Q뒨²EGru(5GDdW'(DB| s<&r=RDD< 䀣fp#'ebv(.e~٨rpBR,7'@23Pʶݩ3"Մn A `0 v!.iŴ]yJƵԋ11ʄ?k*
QT\xR+ڊwf`s]S @^&-s ^|^L՟⩈(@(gglӷ=_p
_~ |
*o,YNxfֳ8kxp5Vɻ"ZQ8.ò?<ۘ܇?l"$=1P|Oz (9 F }97|5=x ) xe1}z <<ۛ YݖUU
E9;^z -|
BJ^o
'tΝ:xz1?-Y =JAvv: 7M4xmkwxybt
2`;ooY:d3!Iax~BpYx1jH^ƙK zyfL Mp]bؙWHޞ 9S}k≗C f#& Nj#*!G1GRX?$^x1C8T|O_G# ݗŘ?=lx>K? xᓍ4q |/
Ͼ 7Y6b/W "3
91'_ER'>pֈjɚ&l[A `0 AK@o' (:窮*˸3rANaj
%_~۟pyq`JۇW?}z , '"|S2K,X~FUMK-ET;qC@ <U W]TŅƦ'ƶU%fz >pp%m=Ou=bl|TW*g *F 8(DƆ]ܻ V~ί\qX߲>$:b+|+AMa&\U,GU]UKA
P+TfoNpq"a邏p8f:~sݥ0|TWa5J8u2T [A"U΄~3;/Ki0$9+}g^_]: w<R*^⤾eDd[*peq.>yο} Styg_Ꭻf71̜
`6Ws\#:ݲ|xK ߳QbOP/'OCG5V~ίO i_KYo-@.X6Ϲv\sgcסBUbop>q%3Q
h' pTWXqTy߷cS8O?^ A5x{
/0") -Se _c喝=;V,T / TxVbˎݜ<"8_qԫc0 A `0% ] >'%-EPBq +\Eܳu܅ Qݮ(FvkQo-^YTiFRx :GbHOGaKPkhckLR9S 9B)S{N8r0 5T7pHRz-%s0jIOVk+/co OGd/I+Q%\bܠxR@ߊJy.)>תŹ7U9O= .ʧ l߶E=k0>'U+1tlüeG
ݝi p> j5AseGck*onLϺj :U?' |Gx-TGLR "]`Hh >RhJ uq㼳 }ts+zu~>Zߛ 9o we-pEKo3!]g5'3QUtpy/7,:ߖ !xwm A&?OU~|;Qu{-DH?nyAC )t$w
G :I Q)ޭZ
ȡ[Ə@} {yd 8ӧ_
TzAy <-^
b#Fn5OynFlBi ҩ
P̏A `0 A p"K@ׂdxJҊd.Қ3;
eW }tFM|2B ^Qk}-
4NO|BbU Bpչ:/f'et(rZȕ(zߗ{x(+'ӲZg~<W Aj/u^*#,xxqĻSMPyߥG_յBj]Au O. Cș$uTW^`lqv_
DrK|u?y ,<ե]˪{PeZ>r@ du ՖSa /-7J ]֓@s Thu4V*OFa!c);{$rc _ *u[(o'LF _+b1S?×q£0i%51ޫ*x,Y_!BbʻF'W#:jU u gmn2V_"/l~>V)$O &s~[cW9FD>5ʫ `0 A `K@ٜ┖H%QK"OkqbiۏchK\t|L;g"Pw2J}\u ?TڲzXaQVpUr;'0hXWOiJ,kK뚎-¤XnN!/c4USñoGgl Wt5
gUny' ?U&Ӻ$2C;RQ0
Xb-F]ѧ@%LK\aIoCϤO0~Hox1Z'2_` վ'˗`ڵ4`Olہ.4MHa݆7 XBumbXv6IT~o/B:VZlݱゐyPv֙?mj T <| ƫѳ['TU(<&8p5{퀁 dSh|w*<s^] 7]}1'?vZRR2ef] rĖlgp8h-&7}3щשgOf=0 .SZ9E6 Lx$k1
]nHI ᓦ0wfb#-!V
,+t+7n";V+P5iP/-Yڠ`-.ߟFJSAcbq}7>|~
_ 8o 1f`2XٗW͢ A `0 A;!.Pqo¡%e/㊮ #(dH q.X|OZ
f K_F^- |sظ8i>UsԊhS
yCF>MGc cl x/WާP5[Ca] #6 -Q% El 6އr3V߉;2b㈲SS &V U4鲥\8« 22u>π)c`O_l3}47edJZA5~jk˸?y W.g CJQr[_,)gcg uPm%v-D.+Jm)'Ǜ" 4E;kGW~lSb _Hh)ZAZ</<&>x_-b# .Õwс#H'qx_bOq~/x |:G Ϻ]RVE;Cb䫯j ٝK1ﯗ7ǛqïoWUseTg_C3?O\l ^VyhEρ#p·-{6"h= ~ScQiĨΩݐAM~ f} HC٦&o$;E$6;E A `0 ~kh"TVV"%%E|IH|Z1_njB0zhr{wl݀m{o Rs-c˖*!aH; Ç @%9_R b@AnB1v` 'Ļ;?]=vo<3}zPN\tcİRǘbdU: ݵed AyU5;aHS1F!)>lmi9#R |dJ6UZsU^
rsO[k/+J'zMŨQKnF| 1{`-roKI*mqP黙W yN%cؑĽa
<cÆ"SZM^f-
*<0vtg{mHZ(_GKV.Ǧ}U ?vu^8q |jt
I q1a\Ŧ;)AV/>}WnOwGCD,kJYi8=qa~ذzvXD K{ \y-ӽ3[r_ Ip ˶wflض]`Tŷӣ \i sQMu9!HCk{v`Ӗ >=C
Gh ܳ
6nE*kxL^7 2swf+!5AT 52Z {^- I)A<cP͕k#CD5ҍ8dzjЅwrO@(됑SԑcѳkgZNwNa28)!ׯǴi ҷBLVA `0 ? ?J]p^-+\
6 &ˊ V
>\E5.q></qwדGt50)L(Ps͜齔<IO^ !rN@Zj>`J'| nsD[t 50od,{r/4KZ)U1 \T}n}5D'٢-fp u-a YTpoo.e
K2B`-+k=Qy{s>Kȷ<_Kp/+D旲Xe,PI
'|2LԡW=K %|SK,jȋ!xU}"h
=y.}<<Iy9 jWğWz`[K73 k [GX>iRnXyy wKxd93TX Gl .꾴AՆ{&[X'_g>3l-pF@?=pi0 A㪸ˠV;%Cҽ=LDZӐpt<ۅ,ygcXOK0,*ºS~RBī,nEdAB/,jE @FpWp(zZ0+o
n"`/BijSuTg-D`x,L WY'mah͵\|mUU"r*7uAɛ0kZ)ո uϸ:/H] j
ǟ{u"$TU=YX =I+rK|L/= #U퉗%RBLD(ʯN` _Ъ859cSF"15ᴦ& T koYվՃ}I9 ۢ) GYufype^5:A\<9"8ɄLT\BC+[a .qe *5ᴯL'[elj~_\S\g[q--UDl?tu2͋k :\
A `0
jE 낸8%~Kt\}մuSt:LC \vg+"[h u0:Lr@ide[x~u&Z<4}Ũkc9&2w:xX *rU)X7;ƲkzbNUy9y<Xצ I#l9F{/%L( i:M4
͛UaFB. GU+ x=G0ijzw"L[¶d5Jl t8%7壼,@"=qN_gٯO՞F%\3 A `0t4+ˊ ༥0W;a퉫yiJoI"8:X?Kt,Z{M˺:yiوxkg}4z%Yxc=Vgc\Y,'0>kgE0 -i\y0W皧Hb@&D`*d~5-MC_\tXVjJK{-wi鰖[5ͶiO\;}}7 A `0t+ ( $$YJ]AUnYGqϫI +ix6s թԞVYEI we_^j+}_{K^js/bDOѣG h\O0Z/jۢ .FW wzEVӗ3zgX֕*%}kuu*w5ioJUU{ښ`ʵ-֕R[^H[q\z[g NH=g0 A `H H\NN %s
"02Dq"Xp#cK<qN ;] J<^\+Lb <xPY]ʪ9 }weh[j76 ˶ԕnc] ܵMW_VW}odpݸ EץPc0 A `8
zddZAC "Zpdz`뉦io= }d53,, h:-]qd<jr~-]qk\=iWӞ4Cyt=Q[C=q^&
=T -g0 A `8.2-\jEX_}m "z"N mmD_ D]E^hk{=07WZ'욏&-Eڒs~m)=N[5ofo0>\f)'6jO9Fޚv.n:=aq#xҗnKk A `0
2Ny۟mF{㷕 N__ BCCQwFto)[RXK˫؟J籮>{=}[%NKis9MZj-w4]%N.;? ]|iqrm/o &A `0 Ad p\)Qh}+,vVµӽ* jt 4_mG8vy~M44/M봮i${ .WY\ Ow|<DW+O"6PUEz/u܋scWyXюI85-{:y lAVZUpb-y17 &d#rxrg.A `0
Zi͛SXJڏ.Cu)۳;|<ꛝ/
2DT
?Kij@WDӱZJ%/銟N+aVeTk @ IDATוWpq9J#¡a:З4ޮWøPuGpqهh ر*qE"h{J#+}:v 0MSs%LhKKr;9[DŽF-o/bbے~h6פQ`ǦU c0 A `0(8.
u,`65w1ЧOoZ
u"PQ(GQGYo{-.f[y#:%4f Y^^ߴ
)
T*ĵ<*r0# Eq1IT"+$)2
<|ʏ i!K"~ւ0?A
8sc㦜 @0xTհPӋ魄d栞5-=ԱdlϺr
55Eˏֳ =<.vè\6ەLʈHMM W}lal9/q %Fsj߲]ďA_QöVbg{d,ެwB\
A `0 65;GF^y}8pxi="csr^ :, ā| %9 G!311./|b`GvfFXt b$&R
=sH6=ߠPpV HJ I]]*xP EbRw?{^UuWzｑ i"{]y(* *OQX@((]zC =nڿ;%Fs9SY3{fIVI"#.Q9puwEiQ. uBj 3 ""Qld:u ^]Z\K# (!sFh: (X!aĻ+R_
c3 k!Eϡ6f-͑_X[gX ]
4 %._ k{Z %: JQ;|P鳧[T_?zFj:%r<._DNA1]=
owgA3p$\OF)yS98!V jx!/3Wi('nG
Zbc0ܝ Dt\H' ?ɩYSHV ΰ67FRb"r
E#-d_G[T(
B@!P( &%^Φi
&Dx`\^LVd#8;9#e7uQ@w|X;O5pp7x
prFrb?/.v@Փ:}G cqlfS>V)"'_OV7.-l mE qe ! a3PG7~GWdE8`¤!8g%hQ'&٢wl/-@H/Î=}8ph2*ez0Vt̟^"5Gԙ4fV `k##(&==ꬃ /CNZ Or
zaW\o=оK߳v/!*6 #&?۠~u/ _~vrë \Пx0GC37}5cqt}s&os |w?_~NŁ5ݛ[HS1Hn;DzϢ`Ԉ &P(
B@!D :ӚeoaͲ.Z5lSk _Swl!rm3ѯ -\1d*uj3
ޡYN4ei:MZ۠v
wn\IDxto ̂Y1{nEdbUᰳFRlO_8w="bGW>J۾PWO W?Ÿkxױxlr .+۷_fDم]@UBrZuO 0
1QX,N$,]@Թxi] 63 p| #MH/?G~xp1)_g @
<44 1rB̅S0m$y"9!f }wLo?9 ŌÜ/6AH ,i/P5fu>.b&4ԯB@!P(
B 'd㵸 NEFu!Wr4lBDv!lƳyٹԫf-Z,MlSiͮzݷG7Lb"YQLe] 6Х9w 9B t ]= .\կ |u>ǝ ?Ûqhڼ9:v L~Bъ%&}Mשn:&2Ě`^laaQaEWtϽ gf 1w8ZR|ԮBX;{cĤ'oi|;ѩE^2r/P] 4j V fevgD2z,:=ҀA~dv'n<ȵ;Rr`Z m b ߴ}>>` JF$6
ց7Z
_䔥 g ⟔m4GHp-ؔf6\lF Ѧ]se81$Si*(
B@!P(=A'>^qhܲ
*\i7V%DMLZ͛Y ]H]raXdDǔ3ZZۂH
Gbd4#JbmZkZˁ˦'Dӹc<+oW y o; /lŤ0MM̩6A}6h0wFӦ]EQaY V
}a/~P݆?hܭiv'Ƹ&`m>(G oWy/$ 5t C?c*5qDhNќO!}k/|
m GbهBȧ}ߏ'ñ "m1n@Xrz˅&D2e7W6£ ` F]B@!P(
B'D,rr ԉar8xlD|.VfD4 D:q';$iEf ڟ[h-SUY3.!9BH ѪEsxґVrF%;N t la۔6I=QN-S"6 c$֦*cٽ 㢮p6C3 +4h eÚO3h߭۳:ڼ)ǧ":2"篅 2#ߏ<̓3:"L 7? =q#PAux4h#\LDa-
s+18y(錸V]{~g ZhBSr F
6 z\=CÅ6;.Sݖmaok\4#UUt '*ؾU?
B@!P(
;wA٢\
|W `WMΚGM"մu :#r[ѱRߞBޟ6 Nv)HS6ǯ11ғb_ fK<TH {1rWDzYZ7KVD±]9$gb&Gr%R:A䍙1=<7}"1)WNߓE'999pr
3"V҂+"]!PJn ߎ"4 _y-X Y!\K<x~lm['Ѕ
݇U$Z5C H;-yAX)%S3.~ _x /==֎4P1mTsx3:]ghLzUJ~}CV-mhp5CfF/'/ N 5 ,$qSEdt6]ۄlAn+e<UP(
B@!P(0"w՚eH*C.Fg>, %MptHLrұT.v戼r 1ɰsFmw۶faP .{ZKW +w@PPm Y.I.kjJVD\LQh2*ՈHHCM:j- b((5jКdïv< M&çVm
bȫ(XQkA0.ƹQPb`x9BWبH19y0 ]=I C! M뇙K`ymag:-QOg:Z.ao7:V/a!|k!V
fE:f-~5aZ1}GE<5,uuDQ~ ֛Ʀ[|ii+WO[1tt`pE\KLF`E~t[I^.]Rȣ6N4I /Zj6H6OQ89/Y̓CvM?2u&]#yWaIV`XQ mHw %{h 0x{{;Cr(
B@!PMܑ 00PNnjf%$'+[ N Ŵ&5&`B.ⅹ)X-,Z?C: oɭܔs.ˉ0CnElgjF
b't#x p^$Yf'".SZ;_BVw&gfTw9wh̜dx^Bm4 !ݍI_kbbD<___܇l G)am8Y#)x b5߈ KĹ9`Pv~=]h:Yi0q_{F,W#p>Ј.qE]N1RiTNa@xLcuw9;<J(D5v z6t9h<r m k:JT5~It]*GB@!P(
bLRÖ"*ŤSFgelFPsr
5Y u9/OIGK/ [$8pY눵,Ztmg[/R5v/,\Y.arR.:N̈́x,^!uGxsA9 }E}`hB?>+ݜ֗ǔQC`E {6 P[@&u6*e9r}$ [<y@ҧq\O. O>q<q"p Ec\ڴl0^ݔX߾JU(
B@!PܑӺqhʏ[&e@# lzK-:
Fn2%ۺiyy#,>B-\)e1,^ʭ.!|yn 0=s*RߪJ-@M1A䒏Z3ĉq0߰l{+߅|Z*VKC
K9|ƥ1<|h(Yԅe,dW}^psHrް* 22 ף -CB*ye
]r
yeܝ2?_|Ǝe:{B@!P(
? zͮlZ ʫ!QfHrDIWK @SsaUIlG6_oWc}neHe;/9
;61N[gٲnuK=%t7yvi RḔީen#9֪Eb~7U] }%uuS,Yv39F3
B@!P(&SpBttXS͛剉([ԙ3 )"7vf ݈9p^.+#ԴigjXf9P>dz ?2˖^w+= ֓ RRRN[uJ'Y$˪T`I3>9ɶJP>5P>)~x_Uücp+}߮Xnc~/K-NcXjUP]_I|þ+c~a ?u,K_qri<ذaC:VCoxP?
B@!P(
ZM6hԨQ!b WcCW*K^Yǽ,2l[URvIDhBu_W]{)s/yӿj[ê_cMan'ݻ+&V
B@!P(
;tGGGQ+-Msl=g ìM!~OfPW(
B@!x-Agm=eACkZuve}333.
mnت0M]
RCUYj(ܘ2xqzV-/
T#Ӫ˲|y nuo( caي<H._]܍eBVoUeƥ
1L37cPx0 ocư\P!R͵8
U
==P(
B@!xX#Au CA4?kr`d`2QnZVʼ{lRKM"w2n֡J$]ξ5"֏U[WSnw]]_?)XXQ1.S;K⪎43|(g?Ğ P(
B@!#A#ȏR QXj OooY_oUH eeYHHS+{xy >Ѳ~voȀ 2^Ӈeȧ-a퐊R]F:c&*eNIJBQ1=`aZUڮY +ʰ\J7)TȪLWs%ȾiS:ǻ6g>NWTWURB1k_Jqjl1HʋUjMTW oHhCA:ƏVVR]ke5*%wT}Q~
Sy 7J ,d22;:N&OB~v/j0l!
#c7bRqOe2RHB3mD}2O. Y3,2'T&uP(
B@!ܑ
'?KaX;5h'MÝ e0q65>^ vGI>xrw"~x7ql9R>_e3c׃PU76 ޤ?,cf,kIA~+49OLlliF
sm-֒ n>|V;[+!F5iB!N 9nGdɱv{gpqt ܂x_v #BVb$~i: _ke%e(#wBƎ@ "`p[Y; {1~3Ji"R3&ڼzC?Z+NKĞ_aoPld
[GW
MB}q^HXr@ " {Of )|V<ҵ?:l$"Na柑Wj[+Qߖ#7+f^Щ
R#7`ĸ|;]@!Caghm+~?tFf֭ rs|q ɣƬmΪ} y'ILy֯'8U!&(_qb:F'kS..lJ ˺ehF!CS\͛ĉhE C+I+aD_z
>F?~uy ` YcmVɘ+է"ޫ}[Ů(1w#bbTP(
B@!P<<T|k/&"s＆ 7Iba$TsIZ jwx$їe-|$FdcbɤaϖX;?R|/7U/N2ZOD5S31d2Z3
7"yؼr"vXз[{|6sr"[0sZ8yӃ{uD9u-`<۹ Y W SGLprwaϟ(5ɘ:1$Sb߲=o_x 3l&\3b_T>F 8*[9gïfM6 ӧOG|N) Wۀ$?
1Pﾳ/$K}]o
⍲B #^zu.fk{.UËt 28AEر#'Z 4ԍex X1 2cG E
`Āp12FV.>Y,}U6O]Ĉ_ 1 ş. ?^ d9\ݵ(:6~B6%)kɈXj<>y$~ܱ <L*Rp-w ]zB gpd & _N3?A8'CZ3&N}wcc wCTXAIx >hdSɎGBϖ~HL
۹;׃+/>pUP(
B@!P<TπFcۘKBu"YuH_~ݍĴ x]:VPجx㒮Ƨ٣:w튚dM'>C GPQc{Vq}3-.\Ad NPȨ0|
? edAB
9uF`HXsXV@!0c
R@̦&> {z.܂)#ɔd9cBOj8VW[ު"Ԥ z\n-a&Y̍5a= _= ]wG|L<ݼhℭDbNb횟0xqG`xc1, }_EG"{N1pxLl [mw9'書x^g`xլQ!?V GmҨ0odgB.Z֧%&Ԧx{> ={,v'&Ԛ:^͚ܰ<Ǜ wpWc (ߊ"ɱuF;p]}ܢP-eiXӨ3v.v.{a̓55^3 ;x$-y_PFmq~* <l^3i4uDQOb=
ٿb(GehʋOЯrU'9s
cEN Ȫ($D]m|$E{)r B@!P(
Ç?N%$%:ZJkSpiX9#|0\uq=Ń[XE`ы= />"ڃغj^I9 :A7LYwqb'#=#STW"mxaIt=z* ]\ i,@R:]Y D,ִ &"/]3mR.}.)7App0^qgG[Iq13C`x8x< C;'p343$ksgħPBzY^ ػypakZmaG.liihg)y 9Ykʁ&jI]Z QFx2e @!ݓ+>[Z/ Bx <?忄{3tF״zjOqg B Uq-6VӮ-'Y9 ]1 fx1$|8pm sWanAkR2Yh =sE4QѰMXݫ(1qDH-k佈<
~F~}㢭FV2bоb͏D)qa
Yee4F5j ;d'RMiID\l<\8<;s}Sk>@ϟBvC oסF˯PSo`Wz
3ڳU(
B@!P<< 7zC1[p_pr|x9#h '
ky,2gC=umjaaxbp;xiD[ukO j }v+Mػ-ڄwWs$M5NFS1imlKİ9i ؽwtk9Lȏ <nFHz+6 _-+%_,#l"ጯ?}yEԻpCWL5db&APp $4i`UoBAq(CQn2MBrk2 "-4@OOZ_ '[DHfIqI;FPb7TRWWZk<5`,Ő =z}&̲BO&2.c&l سOA
ڐC>d/xf@о|ncD`2^ WZV\oEC8֪->5a !ZrѻZ5Ox" "!-;c]ۺ! owARH)y :XP'1 W/NJM`\za1
+<t"^bN
O"=kFUl% Ԗ G~O~=VxA
ΝŇ_ǻN'BmJX^DҽIGMƻ_mG+1j٩ظj1}c9Zz/֤Zinh;[ƵpduZJ5\w!ޙ@
~e{En
B@!P(
뿴YTn$!]A䜃o xn RQ/L@M"3 ]}6y\K# "0l[Uy3ImkW 2 } K14k6\cxXdol
hs$= %6b)[])cDbܳy?y.>x XQO'{5Gw{[P+d}qQ kl=6&Wm Hp&&غSfrr0OHgvvtr 5F|4cciY8fo-E ?
%*7wR`øu& ~nQH;7 \l{
};4֗b2KA
_"ia' ?~~W81z}"Z*iϚPck<N a
'jD{ nF%~ 1)`TL,U ~ f3:M l?$j{⛭{0OgY?C] KK͌ $F>>;' & &^~1B<9>mw LwG@?$۸!8~Lhτ)/.ո$>`@KA}Dmcg0Cԝ &
"CqlO%aպ҄.jp(苹q8{ ^8C ae|N+gO 0abK>DH]
B@!P( V \I˦A(C>A#"ƴcw EP|KSkC^4:tI$W3k<Ҷc6x mgq8d %&@@P}| ˴X#vښLF ѵy(%rM'U\'7NCCdH82x]!hڕ&s3@;>Tu^W5NB`G8 13c3K*gٟw|75-ن ~E$Q8"qԀJN
C8lW_yBgZGnahwu`BV&?f6~PFljJ,S 7o5j?N 9/U 8!\k uY65h@1*,MFиT9u;3&L)6',Ɛ1х,lecҮFX4y3|>Ic-Bz5Xq\z
ӱsf
ɍ҈.?k({
ORWI}H'\ǿ^x-^\ gŋ
jfaW7rwsGaL .㗰(FlB&ڀZ"4(YTBu z _'E+;B@!P(
ÈCF[JGVׯdžaY / 9w#/~D.,qGAGB{8/ w=)p.,*@Eg>(I
8v^Wt8'|[BWk53rgbS ҟEL|/ y|rX<ff^4,G"61$@pÓ,-Ȇ? l]2(M'W%&֪OMĄСIo-Cם6:
KtZt"kD`ݝ;`#[KǶޖ_^\̤kH?3[^G>l˾ ޭ+#/s ,lڸnOo[d*GĘPO~Y))eL,mQq} Z5BJ ϧW-GO>$,Kw }II|Ա\h_<V7mj6$;y2Mx[=w]9->^n
[N" % 1Kg+mVO)'y"Dex [șcbZwэF#KI{>; ,/ rgp9׆
OߡmP7ϰh+_,0*JLJo<]3SGfq#$=8Ɍyi4o8G!P(
B@!P"tZ+,l?6Gn+0j۽?>|`QￊA#&Ih1eٶա9>31{QQQYdFS2aߡ/aFP
~ -Aιztƴfm"lռ9)P5m X"&}j&VkHDIs~> h k^3yhWq:ǻ0WӬ,ϼ9< Cژ^H=Ϡ|3еY}|dŝg_GcޯiC3 E! ZN אe> {:zҀߡznX7 j}DVZJG%S<z56ؿv r|?
bxXDiMX:)ugpS|E!nHɕ|Tp2
O@.p', G~|l ,sZHVM]ЖXPnFLeZG2+U*SDȵfv[9bl=p#vE>8"H~ [e<FK.Cyߌ<4#KkJ˗Sv~* 1˃[܁M؝W{ GsXl'ęۓֶA ϛr8sl?l[E48ݵ[P(
B@!x#
X ikk.!!!7?Fe %+5jͿFBJ&Р^H_V3b w
4jPv&fR^Ą"%*K?R6d:[Xe<W%K ;O:
-JisሌOG`݆%r:]ďO,>7ӊiXڻMxI@^V*"cřf(DbR:ѓ("S%e>uwfjT>`HF̛6<KA^bD\ ۠V`0jp--rmd݄ QԚk q<r kV/ Nz WBra7:Kݑvy'!? E>/!T&ی%[Em鈥iY6#ڱAAaCp9X9KG9CL|k"2ȓ!LhxWfn>9"ȱ~"VKHIςBB'DTX꧌L|0 jפILS@oc ybD'lϵW
mRۭɮ<VqcI5?-ۀ^-hzU<Jr(13wѲ %:i<Kp]$8DFR,"^(yVhK%Tuvi+x: _."ү fO`r ̭[QF7xNSA!P(
B@!O!pOd~+\#6暴uar䭲V/f-FꞗHԩSGER5dmU;*Rb/dž\[ Z=Dv!]o 2ycA-1teuEMedyy!û68 +WJ.FN0q *
WȬyUe*hcBIc^+T;>
%Y8J6~#3\>eo'V=^[.cM`9}&<-*&N$]XL4h˵wrs +)©pjޘf.?nXt
} = 4vTfUB@!P(
?=k(β
?0$CZ<ӕ3$&eiA3W+{qB?P5SO<p;nh#W/vQ ow^2. h^jmڭi.
IoްY gh7sZԆ[2ي)ve:J+Wq=~" a~t7AG:¯N+aagG+n''
ymǞ eS&"E|8?e1H+3WznQgMp#קsnР#QQWD{9TZޯ iw»
Y/q6)9^<y#s,٪d9Ƃ;EZ,ߋ@q%4K^!t"Ӳ
:aƘkOɭHT7
B@!P(
;ZkժSh˗/~wάr(?xOy v9a)*V(
B@!Pwꀀ .洎XoЙl1֬Ő-l4>ʫ˖Zib.iW7绐τX*ສyYGz]U;7l+ '+>/c4MoeUo?H_3Ŝ vٿ/?KO| ~Lȼ7ɯ NǨNUJӿQ1y*:,yemWs_ b)1ԟn\26a_U}W yUk;.u|~o 2Mc [!<,'hoIձC5r
B@!P(%1{
B\ 7L:7N\3i 2|g(DI^P|&LcI ,P]92XX&LVYbUhkϙ;9Wb :]Yw&
|Ϙ1vR}
cX1fK299ل kOw#'W+K&H}zfddܫ0+&CRWRX0lG5&7- 8;BGԹl}Uu,TŒfv+ñp'Uձc_-O۽:Kb<X; =*Q~UP(
B@!P<LGMi)taɹ Lg:LC|y5LS'Žqj7dB@!P(
m-,- Ip O&+wÃi/i!C;ǃM%Y!P(
B@!#Agwqr *U".*N+ ͂nl:
V/K8MM2l8fEB4H.**B3M @ IDAT7<<ZT~C&ُ\*6z6i !*unvÍpey^q/yoy%>A)t99|_ wޗZDk;hb!zT9B@!P(
@ݰRmw7* UIyHN9}[7!Q[sC{x07\
`6&w]٠=5aM) ^w<2߭e1nQXB1 >z9:.sizc'q^'b
p5+zI)^Tp3I~5]E>GuL㼆<}Ys}]_Xy ڕkO1N!P(
B@!0 Lwh`g#}A\O l=d#8E &t|
?NA^1-EZJ2]KDVNgrPܪg&Rx\Cq)WgPvE[ ۓsg/L\pYCtdd ê\:^l.|\r)zܚ ֧ Od5crBN `1;֏/.A qSX`SZ~v.G\Ena| N!,1 [)d*_yy9/XkIް9A}{Ԗehux4J }qib҆ {sLnwan6".]FvA)G6mVPmy+ ަ$ "2qwALցF!RJtJi ;DѬ6ғE "!
B@!P(Agr %X1M|F\/ai>W)
5I8^~--% z <SD?B 2 S'i`ǁS(RV\ s@~c+}:x$7Kwߔ賘> K:#*) r P+%FuXK8z6N<s(V bl]ATre⹁Ͷ"穨C䫾>NƬ<7FV/Wf=Y_ʩ}U.ɐ ii$b iW! U V||/2֜Y8t.RZV˄Rz\q-O3v*|CyrZ&eXE:8?SX4qO=݁C'/UqުBlZwА'j-mh2)e䣔ւ9aߟBӺE szim8UӁˆ[m%/R t-ƕKnqҕTz-B*
B@!P( ~KKӘl8-T1JŰDI|>L?Ou^X-;Y!d[_ E-[Sl#7QMw/Mc"KҠ geБUD)IҮ06 5Ȣ, ?~McԀΜs_st(/$l
m"@GGřw&U}YgŠaAS4c/)-+ENV
Niɩ$iZ4 VfrcA=j5%_W*f p]QҩJ憫$\n7̮Pl u[u$w
JɚEWZ8{ܢb\ Qaڸg7r&
5M\v9)`fa ICr#S6^n;#s4m &psJ 326D$ ǜQL I>*ΐo"{@~Ih4DKӃR _j~ :0f Rj bR2OWh9S;LL+}{=ɣSS EX{B.+"j9CIKJMRR\Ϛ֎+ظq?dtkY
B@!P(
% 1_ E:Y~#b#c^H'j-bRFAm A3uYYkн5ңñt X5oBжY{и }k`´XM֘$-pܧcG:]KG^ᇐ wL6 -
_}a3FC"cG@֕sX9s .6h(Fg">8zp
oNuA5/ lP^{_l&m`p-Mz|Q:8xOb?1lHx:ZOS ;f<<_js"1s Qo 譯,wu1$a\@#$` _uBEK.s!ty1 _#` ]iւ9Mp }_sQsѺQ[cv\ttطw?v1a_a1ƢaQn
}5 'KX8x YMCD!6ϧ% .y()R?ַЈ{q^>rMDha=/Ǣ;4nÇF`E.'R۾{D$Bfu ؿeE0G8;?-Θtqb:|m 3{? 4cۑ0;y tǏ_v0f8<Ccię<I22.\H4hHx#1$
kNI _%.>bgL63mz;q&>?u
2붍i ?!,fFO ;Ь^@cL< B@!P(
CZB'3 ffOo .vGܥp̚L0yDd#c^Uv& ƀгM(O{an:MH9vKuBif? /Oʶ-x [libI4Oq>.z
co%?{e n,' 7~*[PI[ ^|f bKױlO{)#r рcD^CѸS?I ъ| 7*^0x@48">Dl,̓شz1E F-+:, ѽ?` gkEspM,x{/~.ާksb/@#l ڽ _#,&qNQDryhDVJ#aT xwe&; 5|q21 f~n2x~)I䐏6XDI7C4a,ZbAعR0h(& mbLh"}
ѣXϿCXк2 :(sH?4_MGa<1,?;` G/Z|-l<'cP8rb5/= <3c:wň/B|hebo &M@S9"b`aОpAQύ%4 ,Хw? =M}8FIY.>]:l<1hpzk:{Yc>+> BȻ,fF4P_r/L4 ]ZťKKcْX
Sо@Eۧ6^/?|$bңOanX8l .p۹~xmEmdg
,u9سcvG QH~
B@!P(IpEVСm
u6Îo8:qxښaw
ñ#l;|=Z+n|kBsѵK0qp.oVB CƵKxs_d
{i9gw?SVX
6zix8!
6L%^W?ѱ?щ<
`aZdn֢) 9
uKȭ8 ~Ə$~Yy;bLXز o~LOаÇxrB?95UtEi Lز9dUuj\+Og|hצHO .%
x%d+${OQ_,dڞlR}XuQfd\`A-Spr%+Tľmb;Ѽ7 {y~u5ԫsv`ex!Zo-2j5 sAvl݆_%)Tb Jѵ4P+'jҵeO<g=y{b '8ma NX矅'MtpGqudfݧ6.,X+.-L@Þ^ŋ>?k|%$ede V_o*ԭW ͚cOvu'b ,;m#sVۣ}uq !uBаa-k6PÆw"Ѯ \O,8y. 2ZŜIC;n oyv2 $`miܬt,x Ah,7 W{ X{hP L!W<Z}UhJ )
uƯ[1[{qY tL1Y..*n
B@!P(;A'vWZZD9噭>k{hjY9M'O LCgEu[\u: mZI&0폴"Ca:e f`>ҹ iip5 & \]aEgVNԆve/)
Ԭ\Ɗrn. j^ .%Lv~82SPhvuCeB1,eቩ}l+uXoarp1H>L} CDR^Y ^MY[Ò&"t:Z {ՔsFh]r&%sqA)=,aAkjt< ' Cb02<1 U]4YYaqS(AZv :wm!9ǕZjZ\Z?~v^
[\"xl8;;q0r
kÖH&+kzۉ
I^{N[(=ͩXW,Py<\\\*Ƃ#:40G!k&7#qgsZ] +Z&1a| ~4:j !(ai҆ȼE!MPfjO9&N5ѱQmO9nźxPHc,] :t{L{59[I2#8ۓZmhB8ѬMYIR nN^R 7mԎcǡeO''} qDQٹOՄ ٍ1Vuj"7% %~}4^ ^7OK)=h= }-f__@]
B@!P( A7h?6{+"Ny^$vZ\ sSs\hC4sRFQԚnl$z&} f a_bS@Fy$rו-B2Mh1"mEk]x3%x:<E eE`2IDjeĬ/ZVYF9:3#t
Yi]nzvvEl\ oژIN-e결O MXh S1y,*''x[eˈD[ҒjRYe&F{yGUt}@!B{ `O}E{W,k{W*Ҥ RI%;&3ޝ9sf晹뜩oj}M{xTC^/=ta bPWsK/ķ7='Vj@ͻkib <aA 27g4 !dޝQdR
*&z-sZ.J܍fbޢiL߫<\[C)mZ~隺
i1;#jj{~}[cs%t-r[6o3kt-ug7bw:i~_pӰ~wFDmlt DϾCqmwrZ+Hx0ÃV7ߏxY/[NS*(:'17᪻^ƺ}4 (Ⱥ
<MRnН ԮkҡhC[U K
bwUw O`Ǒ{hѢq=d ObFA61/V8syxY|z HNHCLKq|@Yv,
?=G
@Zzr#B@! Gmۓj jf3ѣ,xnv;].Zt= w FD+ t%یa}0`[3a-sOBdd$e>:_Y|,/"z2M ;%t7v
:vkާ_\(,Zt=Uag+EjJrcνt{ #sa%{vߦ(-8|9#۷fb-ȣ+/~mI]?y^]0b93[f{S2e%'<L3f3HLeHx<Kx#Y0>_}
̘: ʳe t
nk8k |ᇸ%X?+>݈IG֒ݚB^pσbGL}K+KewCOo%JDn^| CS: D|Tr4{WEљ,: ;͐ߦg)--]* Pd+-8
J_VPMK`ذaJg1gW3qڽPE,YC7lvyq 6nXGwg!vv,[;ase)h ϗ߈iȣ[R·u&bÚ/G[w!NLg IK'{ 6A
.O_9tOQF Gs((NFa{I" ˗U@yC1":?_߱ [EE`8$z9Hځ?Et0"7ݛr86gٰ'B@! Ne'e]w=Fد5x~&^|~ [J`P`{u
zqp hq%_/ x쑚\ ]뇨o[gM3s,M _{K6cǷ
7Sygnt0ސ+Zx
acf.TE~dѣ^/j mSpS97sAᦋ<}<D{щngnp45 6 LK.isE u yёGSl3*ue l:M~?`W͡zB! m_㎍Ku N
|g59/ȍEA#_/'xx ȉaڄ!(K7
W3CcՏ_ggaڡھϿ;SG^T/ad۪ͨ]
ó9. >;L\ ]< D yվjM-7pM-
?@C=MtS ڲ\g GG4ڟo:sЄѭf^&*boEU <c,]+ 9o%ẫn [OO3 ;uE+^|KJZ!ϫ;t 7NW'y3 2k 0Ͽ!~8 vrW^E+!ho;<:<,\J Ƿ Dwǵ3?Upٶ5#qf)5+0 N-6''"N! B@\aotHmW~b:U+u?RFV'!j!]8 mgr$xk5SQHK+n^eE̹FotY@v[O!fVVV4 A侸0e4ٺ yEh֟]~v&2vtW@+?gno w_c.h^N-@.]^O%C1]gօwkǖ..YX2:uPK=)j7XKny
_0}ChRivfs1ĝ6pJ~-{䕨]ޡ׆U/ XhOuks1stҳN+l K%mԮ5-~j97$i~ѵKDkQPj*2HIa
K蕴>-[qMf!!)>خ
]AۚVȦA!-ѢPNm-[buU=<Q<
H/Ytp @XPMi6:D. : h>'H8JC13Ct \V.u;t%e4 ҡZj-hD'?/e(Fqа.hon6Oc>4MVIZz
KѦmB;~}Z AK t[0<<:<Ϸ%'%t\R2mMm"T\)IHNF ђNqlM4 ,ذ ̕ J߿}S
I! B@D\VN1g
G3JR3ȘG$۸S e. )))S3V5ZFq ڏ?܁+uj&Ld.k (5õkƅHY['nn7ǮS}*@/7%!3s\nYT GmOyW\^m*9,a 1L@ Yleq)ƪBφ kZ/-5g~F?6cۖ] )g3}EzܲG)-7\
S?1 w! B@Sa-6Mv0Su-8MLOIuҌ8j>]-cwqɛ tSFigƃ,shfm9<
mGწ"!N3+þ{e#jX<p!u+T4 ?ѡ 8=ҔYq誸<+syX~6ӼMnk|||Tb;N
֨=wp< ܙ5oő:kG[0dci:0nfV Z\ʲ~uc Wz9:c #tW䴹e6˥p; u~? NKpdC9lY i v& w[]t Z"B@! BT ФΝY6عx*8݉wKC:gӓTHs49xBC17/ uz=k 4,o=Qv <k368i]SCDhw o tr<;nVw8>i1I3u>~uOָ:ƟqcaXC acygl#:;oy
//1/N! B@Z ܳg^(Óe?4:k~֟V<U2G_K >uG`3YYYXv-&O oooy4J^6LqU6z8 J(\F%6\3gXp$G^e>]SaZ|ZYXӰe_4c6^V}M0GYgirn~Y#iGiZW: O-ߘ©0YrZUBg'6Lp<n/<^
ӗB@! Bdhrz, $ O3tW9iKj Vp\tpQE8ucƑ֯䴼|
S W p(Vw I{?.yB@! h`,%B@! B@!phˣH! B@! ?@{y^'!B_E[k3t
2Dqy<<,;N M\g33zl ΗGg:9;B3 t~
2p8 YJ~DU|t e;ڒ3}:hd
v8:}6=J>eN]5X+yh*%@B@! B@! n#zDB@! B@lf>--
`
! B@! ݡC4nܹs'-ZVWB@! B@! O~k{zڴi@g&gee %<")B@! B@0Z߿Q Mƒ ! B@! Bhrv?)2! B@! Rڭ4ЛhU"B@! A8p>\.hlNT:6+іheOD'"#arHwGV[GI KB@! B@!p\ W\! B@! 8"b &B@! B@!p| ~|v! B@! GD@ #$BB@! B@! /1Џ/_.B@! B~DDH! B@! % +څB@! B@ 1Џ ! B@! 8@?|EB@! B@#"~DRV0`p\tgzi [)MK ՟YdOD4]c}s[Ӑa8e
o()$cB@! )MH5ZFq#9.~V}&; ,_!5z>h\U)U2rҾz~;X掵k ?4.YلM|hy3qӳ8'%ꅀB@!#B%ݭomv9JC9S+S%)
@gu:M塩?PFQ:P8Qg| JN 8 g~N#M<Ǚߤ8M! B@ sM\mM
,7Nҹ{6L~UeGqy:!<$yGy
1ApTgMiC_4h9[6: s):]ۘ.PFew:.hy2KSX2-Yk}+J.,G 2խ0㙳:IG]:
lLNaX\:Z% DEM-G n{ uQ"jX^!fyqk+Kw Eehpu6^kq=ˮetUSy{0G}z)E JIB\rZ FD8Q8N YPؾMy5fNוZZV)? .ņO:>^[7QWg ڏGxZH{k
r2ZWt
vZ Tu,=M<}8ܔ1۞pSZ y\}uˋ
q(uC=כ3`kZZ>B@!$h (69O=z?f>8|| z!<6kv<8Ԑ!36ٕİaC-/`,6C W+*</ @z^ QOcF[})kYQUK_̎;;uR-f|v5Ey39b8f%<6CǠx#i ]3e/cӥuZn&qX7d_~%+"3DAvV,Y?-Fb!{U ۳axoPRYSr]m4g& b ]~[X%.3*zݹ \} 1GcPkNebXcΤGꘂ4m=Ք7W+PhG?~677#쬎a_ee>UQzG \t(1gz Q#.ABfS7
Ml,Z@)5i=7 O˟,u[]}RaMeM&oi=O.t]tQ~DR)1{0hP <SI]m[.W
tyqbvfx;AI7jepy~C~a[W x}Wu)Ő'! B@ 4ie^\ݨw[' #:1pBgv>s4=1A;ygϪG0;|fG}JY'Y'Fr8apqC'SO1;.R@tnv&tZc3.dr@V ;BBs4/gL>G=/ ۩g7f};
NĈ1}l,2/=? ~]muS_-͔Q. aΒ x
qB3
#ú~.í]rS=R|l[f
tԽ/0 (6D#mKJnU|c+JUc7u$Dg>è}4m0ICسu
Q؍߃^]CJ~w'[i6<+ti-槳xV ȼ XV
vڢmG$?6ʓO<σe9-8>|\ 04cS":= `{`V쌏Kf c#f(3jb95=˰֖a_]6P B@! FFO(%ѿw?FEMuZ͘Fcc/* ZyW-¶qg-`YSii :0Qqf%hОq D\^ZdU?0;g& 0n + R3 BѲE3TrبH HjA>}ѥS2d+J2t= OL)cq1(*-'#؍F e3$C\,D6o GDgš0&2;[-ܿ :uPi?1?g#&: )1\: iyrer̻vF
ݓݵ _oe!*&^aT3
x5F!пĸ(3ҿ-0pwh" -
4ܾ嵢C^i
z >@mU9bC -uhN- Ċm `ZZͮ bhz2ʪ
jK`J (۱eGۧGW ѡ//u4#S;iND{AWZƆ&%"3'x 48J
-aDxh K=yHGhDO >.)Jop%vމhɽJ45u })@vAw ŕ
Q^}"QT^OCe<q{JKIFFV N4 A,Իa,T?o\+ѩJS %4<6en掊' D)kА"PWihFiYvAzײ U АNѶ ceHCAi:!DeD
%ߕaoCm (vEPՒUD~V?+ga/T) @? Z9\yS)7r
PM?Aahߪzo h
Z4kтm8sOR]^xSQY5azPv! o zR JN/Cѯgj{奤?Emvp)Gwwr]@-KkiM<'{" ~ѻo?t ډ3~/R[5R*Z
.!bԌ ;}z
e Ey8@宂ڷo U8h0B = vً*w5;-}| Jه9~BOqƈ: qB@! 7Wkm"7l~#J1b[Jc_69>sFm7mil^;۞a*ZZ= 4 nvF^yW Rww<94uyUbV] :7]^/L2n<V=_? ۟(2V̸%PQ%˷Cr_,\Ii Żmמ{d2 -IO[JN㾫q؞"l_q02QXVils4#Y'[2sDnOQjp71j(Hc-\0.o l,۸G姦W }ߔ\nZԽ8[5N{(M4? 2t=K~1+J ǘ*\6>yASg{̦cxHW]]CIri
xֳqZ2pygLhFG̭S5ȼFPk_[Z0>\HO7eʞu${b6X%RLsfyȌROgC54+9ʘޓu55Q8Y%ع|&\3H,TEo1r /9TRa1W0yM?6Vi2uJW{[TKF|˅se]~o~ J%]gZM?e|/PRq84FFnΦߐ o7ƭ7LsFlzߞ ~T/ώ3:5nF7[Xf+?|߸t\EOO-f f1Zd/X~*Q +a˶S~e/Xj z߳ɸ}ƔqzU &Gn62A5w=eD REm0hGɜ5z{m_e6GmQrcϫ>(Qv=|B@! j u?;d[N叽:ym 3s1oO6FFJ`6cM[
3^f$vh<Ƽ_ ry4~.GxQ mL%cמxF%uU |0Xz6]ddw.;O2?z:};\9B} }=tW*_fz1C[qqά?;kU w* ~^ng<o7&g916}qذ;5CɱƳ?xoذWYϾl|1gi~(mcTڳ^ N[i<y f7= 6M (^w/nӇߚ" ?)eW?4g^и;bm@,68-Dśv{ alm]=ͧ_Xf#&;fzW7rOvl#5ۦ>3f1u 7C%FJ.L#(bd?1|Xr+ϼs]FF㺑-Ts/1>b;l.I#[d8>#-Ȩ
\Ѻ6 sïS~*Tx衭<+=o/s_7JxQyϬgflKQUk<u9Pg zw~+_n,c8C.{ȤA~$9)QaYAj ?z.s)my6Ӎ i zA$c#ܣ|l$ L3m[c\:!L_T=Wy=X5Zerl @ IDAToƶۍ^)7F#%Ҩ.L6nla<~Bt[z}ڭiL3ȧs/>xӘ2ipڈ۱ήk X52c=Fzjn32mk>Y-N4>%ƣ^n F|Ju ]g7g?05eo
h<ƣj'o<ʛƓ3`YL0Yy 'N! B$@ Uxi"dEaf H^ m[R@
b`Rr ? XC ~?s0M;бA8g繏\Lb÷}@>ї}ԴQ\ _ BiInMK;7BҶJã[{øl牠nO)NtZZZ O_^pn/P^NX%ߌW9s5}hbddeۦ[LZZ֔_3۟aԉ0j [MJL<5%Q=BQQ!-onpq
/YX"LZZt:9miĄ+m16"\|x9+ ]x zu4&d͠'i^\iN" ՟7oQ5]v.ʳ wlMX T(+*FV.tq-wZwa#z9iXN~(.)D -K뇠 s?oq|- w1u9|f*ٳJטcKе} =߹;cvOs< /? w @%-oGK٩=j_?r Z2V턇K!
hsDx?\tx_ۡ ~斈ප08 04"e%G֓˯
_4
-CV^ ° gCѲ}ZsrUgbw+s&B ܅ҵ#%.5BO-]t ;- ks"Q(Ï@a*h{DDsp0Z S_IZR3k*`ϻp*H Dh@nY]/ϧ-%Wo۠d/ڲ$!`<=**&Fcߕ37 %4=~&pT5~ ߌg O0<Ldwa!=3 ťv Anz\ͥK= t@ƞ悽̛hH
Ŭ 䗃:{³Yk+7]3wõ" ۋ]K! <=h9FU!~_#g
Q7adWlX >@wmT`^|&m36y;RW^z)Οt:=!+) r9Z{Q! xGpӑw=.G?ۯ 5~?
JһKq~D؊( y#:t4cC! B_Nkelѿ;f>)~JTSճyK4wAIq`-B=UT6S6 F~`ChvB:+3ͨv깠ch8N> {D{?76;нĺ
[+www,2нG/}d|ȆdQY2<<Ͱ.{_.JԖUsP'coke;uv?u itU lhĮGJ[ ʶ ytڋ+W~/= 86، oϕ-@vrV9l?=uzuZkwmW{JlΊJn
F3lAC#:ucۑ\9^;Ɵ }m]#̛+h A';!T>4KL9PtuXE~!9 @{
h| <|H ;?S!lϒ1AZ^m
jՊcCp0tU56c|* :Q9OnV"kգthHmsєаxMpZ $&Rm[,S |t 5
^b!$ sV^-p$ 77ZzZZ*, deݑa5 -qCaÆu,8d. ?(QqC ,z p<s(p$ۣ 2 >Tr|PՕ@ xړC+E %_7}q.f^ ^x!Јۮ$ʓh|ʇ;jX̷5V[SZO=Sg j#Tm4v1gZ:7 <-He'݂ArWMyлZ^F1O@_ 7:e A$ÿ|w`D9$D=q
|.)B MК
Pcf~~<@Ao [ [É}d )ʕaͲO 6ZG ! B@&pX;Y><W#f!!* DP6
w,c'eƏ6!(03;iӺPiDA @_a!&_0L
M4C *liqh @%4e=t( fөީ:tO'ՐaQ<'FY]v-z_"۱#qSTեRt7 _:aWt(Qta $2 UcdEE`1w#FUiطs f8z)zA/Mk?A0Τ Tb_L4jg̮ lb Y6nˌ
6R%
4 '-3l#{T:1V#/ŔðGvHEفW̺ "gS^mp -vb3hi!fTV:y J֕fC+@gM?fZ\WTvJ˧@;^\ o4H[4W `ȟ]bl$2@f-ۢ^!qj+7s`Bd= Oѓ?;ޔ2mW5o N Ƃ 釟0q2e*<3矇q6ԾqЖhVKO\uf|;|i_w濁|2KLp1-{&J3iw+ᕺ&MF{.Oo"C?:<k:A *P{8 ;}M Jt="1/-ʧ6|6{s.]D
n۱ gkk烧a1z@(V/SV5G;TL~M=XEZD`WYYAJ}`H\l#tY
RU\SښG%W2}1ޝw
۵ :SxGB UPmЧ{gulUlEfbpx{{Pۤ5 T-؞]PH씣ū]()nf>ѧ*)VYaUQu{7Ŭx16HblzL˧B@! t .@.. _Οyӏ?_
t7' btqgCJ;ۄ#ZSC?墰} EbJ&džx7pnuiqg:ERG<֜IxsЫ@6gm&:;V,2 枮`cmSt=ǭw܅ko]}sƳظ7 7d[e7b ]$r/ebiyz%M ^" p%j $=sPMӄQCaMw {l )wfľX8{]5-Wns vnۊhe1Cr[i Pgh' 9wm윛Wst 3F-oO?dxozeT˾v @^0yL0HDHӆ
vAK믔Xr
`ʕt1c@Pw1 k8x)8F`(+LqQشy+b QnQصm BFn!$!|\:9^ @[B~_}U
mx0 Gۖ0PHFR,^~=DWW͊Wh8jٲkqwn ʸzz)Rf) 8^
r1}-.Z`下/R~={DXX9 -Yث=
?]phvlmn]#kWۍɕb[*p&m_-o-#?}F,@vё{i# ^txm%:e֑$SwUoe_n{S%ù C]Z@mHw]8+QE}hn#ԪJwۚB"uT|"/]JNb4[ m
{71Bɬ>t@vZ" %T%G1zHB ꦇ*& ٲKmYg`h7N0~] {$#j,m<kp<nQ̗yJCv{i>pC#u2%3s h$@ #B@!h9Gf۵ܭl6:`Ӯ>FҾ?zXVesh5kDm !}QNrqN:oUz6/nlMΘh _$YBN]|u8VPU|N4 _pDFeȕF ZWNͽ4zpvťYtq?(OfWSa{kcMA#N6(?yˮʑ\:BkULc~O?t)3NqkP\ɾb(6^<5`|7Riw0zq?w*\=mkL<} p'>C>?7x?`>QXix[>S.̗?1r .J`pm'ژY O6nUqZQi*?Rm1FaVqn:?n L0n o="3xqO|:$֦e ݜP[iy KWSyz WYWy)ƅ]0w)7K[S>݆E_ԅge1jc|dQ`³Qm|o9nU9|NdաNy!㉋)-ξHCmXJ]g>1wctxw&kdV}kϯ_yYfT$w7<>.1nyCT 2 zwͯ)!quz5mau{ VlzoWJQ[c77@nǹN
+8
G8cvvwYf la\78#e}xx,|0z1Q3Ǥp
B@! @=.:
`FR$mI3~ 4CˍjZF
3 !7- ˖.ǾD`-iYBD Qz )Xj
*]0x(YM'Bmش.*R9 F]:Z3}$?pr&<}[aDK>KaúuH-1jp=d
_;Ь)
ňc1lP}|'Hw?4 Cj)M;Ӳ1ǣ[7ELb:-tѷk'cEwrk:eѭG_Pgatq5:s|<I4|[CKlۉĤdW|o6l0:V$ g^ ߶ t8X߽2Tz :l`H 7 'cXlٰsѳ | k]TCGbP:.Ö?agT*
As:\07K),{ ~<ve˶`ƙN=شe( E6fNT*
kIݼq=" <@ DzEyt Zlٺy
0jg#B;vG}(ƍ Ftb |6~?j -6fgض hȨQ#ЂWbʹ 2/ p %8 q{a /*)EaI5Ι~9:xaUg⃕xЇKAsZ=|lf{oƎ}qhM~ǎ ?CP0 "q04?XKŌܸGNA䛱i k'eDUlRLjQcJ dc5H)Fێa=zZAxG^F2֭ tX^.C>4ɚv73W DEA7nE9^ajt
"wnν}GAϰ šfm\Yh #P38[Ҫ:
~~
TﮥYذf= #OMjhFw
b@<zW9 B`ʥXq; iCz7Θ?bX)%q
ڊB=ZG{Խ磆GM ؤLtg T̼Ll?1 CvGAV<;ЯG搞6C];mî!+f}ر#zaTNlZ
1yعj4][XZ]}.FB֕U
+?xp NDކkG4>ֳ?ƍK; jZFw^6
ޓʈ(pToۊ
t3XUX| W>9#u[zT2G! B4j3 m 'ٰ,^
.:{rIJW?i{Bަ^צh#y4ВeOp0f:QONFBV=4ICxyt29fԾVWn[f2liϼgǡ+RU ?27 ,1+}1l`_TgcO _? hZw{|VpT x1;dg9 ȶzth<0AAglZ
%0wS.>e5:N-o68ܙ^]k.^ tz -^}z<wxy"{e/뵱qH O?QI9[%D4Esڼ[;u$`=p=|&@;(a
?Y3&eq='~K婞l;'fv76
nGwŒ+cxVg=
*;ˎQ+wО '%7oi²?̡t2'M{`G! B@"ЄF:
QW# 62Ν9gԌZg'i7 g8IO `y%AAα6ʬY{J<=m{=Y71b;D?sQ=lեk[y`ctqͺϿNT P <˳ܴq≹ y0s̓{?y~h=:AO/ZQ>qR~fLN}I. ק̲/Xs|)j|myc:k+KM3z̸b2Ω1@An.j{ CywrS0?rZc6mq ~gcӷrИ<s9)gNןpA^N8_B+)IC;ѧ[0t]!]Sā> H '| \tZNh=n1~TԣZ|
! B@(MΠ5ډt kgZ[,
樏]SohhpG}V9tߞ&)t7Ei3bIPų4cW:
GN)oT":תìqeaw </[HNC
\_F'd6?KuBx`h͉YשկWT'i>|7kYqwgʯ Lokjixia>"C]cܥ]YTxۙvL}t x4FrA=Ɨ; NhQUZ-f0M4p͂btNPU̝מ$laiyt^:/Uc._atz))G0u;=ǪK%B~??;͟E?cήC U66p>XWJ}^&yB@! p$pX1|MН*T{sF995KcA@XP B@! wQ'&,3y9vݓC'l dOFf9 hy> >&I Q;=&)! B@3ϨSNH+C/GH&&l
! B@`b`B@! B@g,]gTO! B@! & . ! B@! pF@ tgTO! B@! & . ! B@! pF@ tgTO! B@! & . ! B@! pF@ tgTO! B@! &TzaB@! ߙ 8! 22?kH&B@ #%B@!p49^SSJE?NT-w&<<<P]]#&rBNIX8G]]eg1*B8h`[GكhB p*.3y^^ Ut1~GOO&n2t2k Β' ʟ2dTF*1Bh`[KOOGѷo_TTT gS= 3=B3sLsQ? 5\^^ݻwW^j
#Iϙ>z %5:ؙ~6g5Mgt;s;\ wGCcqP: ;9=wG gG^\UU^eX{dYvG֬zѤՔ~GM:51MZ 5?xZ M,Lo
#i?:.:#;;[Zhu[ӑg! Nj@BCCѪU㕾=B
:Bi'@iiZ"_22
s^#N]]*B@9&
tq' wĝxĝ(,,D˖-ѬY3_
QH̛7Of ,Q$'q<l h<GYgt_ ~\ pqMK ! 849l?' ׁlj:9a bԨQر:GUI M9]l7o Tm8 5ENN&̧-BJq$J<Ӿ1}x\
z[vcXޔ Α.wӿ m8q:MUz |3ISVJiB@O5VL\HX(>~* $cpJ222 տ7\~~~j%2yۍduJB@92ЏԗS ;m<ToFo|hvޖ` ݹ|smѦXut0vlSm!0;.rssfũᡶ4)q?~<z t]Կ'B@! a}n!P
RJ5ޞn f
[JVqxiXsi eX[;-PX OKѓЭSNJc=~y)*|cWG)G%iP^(kkkP\T / x ̓jIh=s:= .BJ.R]]캒{$0g6333A)d5Cb
uP%~齼Z+,B@ O:ڌ^u1ο䕘w뎜Y4e 06v]r m~[m)}H9T_Ye\ZN}t6{awn:? sP8'C[wR'WM5
G<
N=^Vp,6킾kq'@vԕaaajy||<ڷogUr B@4c:Iqە Uc
pLCx6GXx8}}h,+FZj*z@1.Gu K*u/VswstkoQ< v":-,F6 f| 5) r;"`V.Z = ]Zy2O/t jGsiPxR5U8_7(/FfNC劌ty@-Url"N |xٷp_c0r e[>7UNNEH.B@!&p\ t-n㡌nƣg9f:̺NԆ Duf A ]}>%L.<FQYox .j'n5muݍܴ8,]: nWڣ7# `wL69ML~)|??&z h?zyfay1?dϸ{&.|Lͫʇ_L*cw#; &M\ t}C ԭ3zC 3Grr1؛NK)ǕT irr2>8nϞ=VFߩlW! B@ OTVstܹxYn
^R;I<{.8/w@`Xon |Z, sf?.x2㶮Tp^Hڽ)H+ץ\vx摻Ҷ
O .UЇcܵ/[ GšhĦ!} rrv-8g`6Ákp[`?v "7cG~ا-bcAk~ݸN?mA{1ЪKF햺$qxYЮKl[)zkuooo 0@ K0?*J"B@+ 6kwrnv)ɈJ3es/yny-0 m[ g6,5tr<l
^[p#bʸea |mJoAwu@ۀlSNhFaH݇v۷D>)+A-pI="' T]UewAP4^P[4FAc4MM41XhbMFc X `A:{w,v9os73ι3w.r%@#_B{8=v` > p!M%sDM0@F %_IS e 555a"UVVCFo=5] C0 Ct&Ԝ LkllBȖrrr[V[jcDj0cВ$+rz=\WAd%~:MeW5P/@u ՜|
؏9BE<=hO
3eC;ZWEFC]G[ܯw 7* 97$o=db4 .,Ӣ/= }=%5
imG kȓ9?d,]*^!`!`3 8j! +,*ĊEl^{H/%u=^|^\u '`i{c
N-3E^ f6|ֺ*5ʎm"@Jj/?̛o 7NcǠr[AAXS&ω靖,jy(Ќƺ*1@:
z
ǺƊux#˥*arJ{_<\X٧Xz<Aqv C`g@rLCuVoogt7#СC뮻b̘1=z4
K~ޜ!`!`AŻ93?
Đ~PQɹ}qᒛǟ|~p5 z}9ݼ &Mn.yͨY缋1+,F}f1}pи<} oުP[Y+Ɋ䥤co>b@3 |1[(p {8g cq'` Gg ]>rGnʏ{OBJS5"*7{ U?sfb0xHBql.wuꔖ2CȂOOso0 C0 C`#uL9<hiw1WVk[[q! <83r!k wŸ%>̙3L#<>N^~?^PCϸ͍҈I-rDݱg]; KSȣ|/iB1yxx7G 48[?CR'O1`+_ zq<#(,: #;80dhO'nmK7G;
kd`Sk:퀱ӈG }uֵ
ۧʋfg4s!`!`$Yu־Lٳ1x`o
Tv2mm[zdijöI
>xKR>w"Z]{f{\dq"}o{.9R&HZ/MMn=k-J5Bur )u$_C>("##c6giB@,
+^z)v]>zk\iDѲYveʕsEEEr|Ww3oܹsʔ)GZ0 C`gDVcDOo4lyi^(.8헧9 +ڜTn|Lc9eҸ?5ν4699~ ܒ[[^)c=5a厕 EUPۃ+|ＤC yЧ^;$LC0 C0 B`4Xhu㤐?7_H2ښo3Α(Z>}YIdV32g2 86M nyZHei@E@s5K Xl ZnW-nhK_4!`!`t qNڌ=C[
XAHJro4JdD6yHirs~R4 Oԏh
텀?i {(..Fuu}cr{ift5n[wlg!`Ό@\Yd[:Uge4mHt`\ei\i4UsZ_P-ˡxwp常ޚ Ӳ50J+[F*MӰ˫4?ȣ<I.擞au<Q_ikZGK &Wi4q
HJO#](u.m0!C`РAm,']Z wo]]E7AWV4ZWt
kcGy UViw]$ZQZQ>Whz0-,2hЏ ҩEo->ˣy*/o!`t'N|Y97 E]Xh4 LIL UVGJWӤ$%k
&Q6軴qiy滼A,<|MwJI.Wza4մ*ϕ iJ5- VӔq~?[[жa4wD4+oG<.K 24 DXx\Z7 tw.aDia< V77
|o!`$" 4
}ar;<ɗ<=Ffeey4rm<' s7NS)4%?Cś*}䍵#AY*e0 |Wԙ*:Sw_[[ b:DIKYկ_?TTTx0}ǗmRgV#X[1ݕ VO Y/W~Gm-=/Dk/}A*Z_
k+wmMVa]]a}}ZR T>VG֕ u!qywF+-gUkZW^k mum+ klP`[Q/}ٕkxmm}
G>ۚ WuAۊk_/Y #`_Gk8,6m>%8i$Bg0 CHh:4Щ9oq"ɉsrI}u$"-yG'_i]Ӊ8p\]NYO?c2莤ʧݴ.Uϴ K0LO>NVukG_k[y uGtC<W=U~$ ,<a FEe ҼH<ZW&T'6,_Ji:Vʣ+,Kur3<cO^ϕ BZY۔}| 'M2Q?\SZUY i4Mi:RW>nJ49E蔏VvU'FuP,|W>y(/(`[QVbyQ>5Y7vNLӺiQ:kUҨ2T> O4W w$_ۇ}FO|GÊ8QSLS1T 7ϕtX?wܒiJrg>.Kn O(<yAxu(}?s!`@w@ w[88Yd^/'- C0 C vz-ԩS @Р7g!`$Q=>'މVb Ч=VMWnL7J^UmkHTzD ' C0 DG ٕMwLs*-TC vug'mƆCV+C0 C`{#uUȶhl+J2: Wy{{$W""\;v}nB!`!y2;_L
V7';\P&H疤3OwݰDsy,l>
ah'0 C0c UܭFd0҄0li7ۄTV lFb:>ooig+#
}=D1S0 C0 @2YoiPDTtI&O05- L= X͛܂LpV4u4Nf9g|O1 $%9G^ə8w1n($6J1 C0 C{# :Wcy-Q_?Glɴ蝹ќ&|>v^ᨯ yY}Ow.@N~62r1y'bp9Y
쓒19H 0
SǎZX
d߰hU{iol'< K?]k6cȨ16gNX1!`!`@"Z;FI1ιz3~~XZn[S\1uCpI'cڄ!8c<Zs&t%YW__ӏ;o>3 KWx8B /p9'm]t,l͠ @ IDATAtt7g%s%?9^_X,`!`!`tZg)i8h$v`fHp̟ȣg _{Lwg=u +oW}g-;}SF ;;6._< >t9> xO?2z?/Br:s=8yfL/` C` ZJ UWހ 1
Og\{ۿq~$=DDk0 C0z" l j+*~ZZrz~<3x}kM8|=3>O^a aUEfn/砶| nJwy q8=K.|>:.Eh 0dp)%;X[[M5$ GlO1SQ^^ӏBaXNJ﹘KhCI늄!`!`t- ]S@VT%$+_ǓO<yXz}</# ;-Ǿv ? Ӯ !CvgS?w }
. ػ|<ܛrL$u(86qC_4U6|,`| QWSAH pu´l} C0 C0 oȋ=.gI;r;md9ȭ9
+5{~= LΗ H&ccqĽ/ƍ拏E$7^fy :L9
5hllBR}').[V9CC[uMBFv.V9-iiBiCgqZz#'!`!`2<dRS<#z~82Z_Q}dL
Kh$˪]UEE~Q_GﾀB?0?jjԌL$7U}5|1&?̵lC ){b
^7>8G5sg?A(%N k!`!S#P:
͋>G -@FJ,*AcR*^~}ꗃ2~v{8v >
，;z
ǜ5 _}>6 ^6
'aųaG![ph*d#;/ s|֭ Pno8zR $~Wh\q
WէxY9~p饐UvD`$C0 C0 C`B ԴLuTC%\Ǟ;Cgq|.mp^2VZ#嗮ǮHi&z1=[ŷVfa#%5g </60<ܓ3yfr6 :"83ӋϑZ̾7>Xe
#/$aþGN( 2U !`!`;!IjM1͞=Ƙ1c*WSC J GGFjl[@|˓myto?9*lXr2<QԷ?AUm綾nc
ߧ/64) j\^|9ս<hj2f ?'ˑmZF,]kۦF&#}_[' ?>=JyGב6katܾ9w\9e!NOg!нHtHS2[0-Mhޫ2rP2D~ EǛs^A *?7 8X~#<r\QVZ,
8L=Q2=u8'[(aЇ-MXM1C0 C0 c{OeN98k.koϡ O[wF|]\k+CbACpHክsH,
`[m!`!`t=Q
t`w}$e+n84htwirp;Ot>Yw@e! /7woruj}] pWMF| M$n
C0 C0 :?+F ': i*ӕFJI~s@XxF+.5/W:J3[黸yܼ`9ۊVV]2| FLǥpP^0tyx<OWRꑒ֭Okzh8k~$+x"մxC^*c[ZGD2⡍Ǖ c<H<x,<.I L Xxቇ6L>ehuY0 CHT虙!lFE Fݲ4-̏VeYZ2|4d>{4-VZհ+ 0`z<<.q UxxTՒ-O twp&W:hܥѰJۊV
*Ce״0ߥp<z="W (O<ratiq'ǥp`:iaq O<Z^<<v$r8a6g!`$: mذweҼ1qu3鑞++G nq8}]%0#?(MG'v$_m. \;&(Ļ; ۺT~v P}+G?^,]}[vǸR,Eek\/|.XiҪʏU lWWoW~.ZKK VNZ^G;bC W~4ڎQwD<Ҫat6.a<.a) ,/^]:Qr<a!۞_ 7Zۜ!`!thoǏڵk&mz tjL҈,--Eaa!6m4.sssQ[[MxϧOMOҪ|A]]7!DalŕOY|&6 Ϻy5'rKb/((0 ĒP>?UEZnqA OU>ۢB>E VOX |NRԗX^V'QU}!־U_bD}m/e_/"[HvvE_p-1Dm"u!l\8x4n9}}'qI><5 x=b[^; پЕp^c ]q
v]L_`_먭WK1| ~ 0 CHd:9s<coܸq;F''tPJiWڰ$\} mgw uxAă+V`IzґeE?(?$_u~}@ʏ]mELu,Ƃj[H:kE_pHֶն ]!}A alm_~&}GZֹ mgUh\پ@]+>}`[}|C0 C Q@={6F Ç'; K,!CN U[" 9'|V.M0? xhxx%=͏ k9 w:4uT3L7C0 tŝp m/#'ID|ia~<*# *+ }pŁ+\2m A C`Z0 |VAyqi5 &WӕЪxxuk8S ӴϮ_ޛs1H]=4 /5?<jZ<0 MuDiAZ7\
nu`< Z%|Wn0 O5-OXh\ٱxi .r< C0 DG 5 op:R?R4/wyhCYZ2|44xO3M|ҪJڠ,L Uxi/(/WX+o<<.UNth4= tV]y͕C% iږ<
i B04Cp
tWE +; /a%|W/o:[0 CHD蜔,W';B UZKYؑ dlr#[kf[ޝܵH4C0 C0@T,'%8kiD+5[2Fp\ &ےb
^3ٖo!`!${]R['OikJ~l5̃,C`gG@qp;;.ݽlKkފ!`!`$* e\W]æYoRgbQ2?[WpKHxR4V#( ܚ܈MqfwQeeƿs30u[.yvڠ!Dt
kb,LFc!`!t\,ێv0]ul .ne>X~}ﭖ к}C\HJ5 Wd|A.7
sO`gʟĔ3 [Aߙ[n!`ZAoΥIhFiOA妳0W/w?Et1[rgxR$gaرا[A_f%ʪ1t`U*˰t K r%;fRk0yXv#ra(ҥˑ} hӊߖb
C0 C0 C0v2h३ޒ^b -*؉{`SE>/< q |j8?LJd뺸^|W^wjx P3\zd\ny|!>%` QQZWE w7܁u eX<^u5<C0 C0 C0 C`HzfrO?ƚ\}y80= :G\.9$4kn7!+uuM"PW內z=ZR1e ⳾{:> 0 [0fV%!Av-dN4U0 C0v i J^ _zu7N>iղe(}N:f:Gza vw\ l^ʑ])BBTW^k+>t%|V6#YaW^^ yL 9v=h!`!`!`@!^Usg~LUxm(E~Fwb{Fn nuȐy*{SSR秧g =&5ףQwգ GN1G#Cλx`v1SR|Yzhk
CCv6!`A Aw*JP\RGǗ P%Y` y25JCjK
36xkĢ5HyxkQ]_df}Cw8L?cG@vZR^WUz KWmsux C0 C0 C0 D Vi
zF]EpgOΘDnSGp Y3qeϨx `@ 4xEH)c'L ӎi'_DKj~ ?нvA2mn\pb!q>1 ]vpX!`!cH(]Mff=Axl 4f|:-`Gy!^* ޞ"}o!Mգ 2n< xzh(_%2'
au#q7cxJefǗ\gꇧ }vow/u5b!`;VXC0 C0z,I~mFu5{l <X>Fӷ%T 9zhZ`{H H"*Mjll/"##cEW<hAUUz]O4}Ab˚RXh}c 7"[Oӷ6V! oΝ;N2ֹNtIFa!`l? H7L/M&٪prqθތ0 [s 9G<zMs z o0"#ET=?5B#RkxGce!`!H-.jDD~!OFD{*K/L ku^7 ̷xGڸ0 C0 tNԘUTN0-wu(t#2@az&Zu ֣nx"=tK/&bӦM'
Y <ē0p{{4Z$Ңו;HuID"OZOS<7ZC0 @T5ZpχkYO$v]%jD[ꦲgAAx~LJQ'"l^zyRڶ[$ҶxywtMD"OZOS<7ZC0 @T=5' ygIt5
` ͍ب CJen0 CHt:4iR >ۮʕro]]]4IyZ(++|ƙ^WWq644 33;9//ϓ6t䠢KP__|lOK3uM<Qu!/Oԙ&:rg XHY 'Vkx$_3+?VV`[E l3ۛ¶
kamE|ܾQ[~ϾO[ɏtJc VE>bɾ/r]`m/Ǖ{Ѿ@ /B4nU~낋%ۓR$?
57H}Auq e,}A=8z
/ |.DjxamqGw*/ם`_`'_,m=8ҽ{
^m}({s20 C@:D?NysUz9D.8'JM40Mi2(Dߕ(B=疣q]uuQZ~P'E}! e>'ʧ<R^$H:'Hl+rzsC)*W|[S?Q_c MSJKytB :3m\U7 Vn:VOl+0+ Hm4s}ō..<WI}L'ҶrӂAn\NX>:S'WoWZ՛OZW~H] OIbҺ}Xu"ۇU iS*qiU}4.|]9*_նRL*_}3n74LGj+ bttJKutV=]0/|ەbG/( p W^}AHÞ?s!`@w@ wG 魞wd ,Y!Cx\O!`!ރSz(_ tuY&0 Cs Jp$0/U90Uq)+G< ViHE L\
*F$ I婯tʣar5_|:aʫ~4S9Sv$^/Q(E
sW;rTkyn\ê#V_i<M 0ΖrU
s[Jw
!MGyaLg24~X^GN.oq:ƕQ^'U*ssz 0&,͕ԟi^0a>R9+S1i)-]y I>ԑ.Rt4|WҸi*GuqyI tx]ya4trEݜ!`!D5#U@oxA|~O 7t
}-30ynVXHLS~,ʣ+GJiA(ϥsu ,7_WxӴ X
t6XNX<O[NOWAHxh]<`^n 4ؖ4^1du 4N_wӔNwi4-y5jZ$Hi.oX~$`9aq7H4nቇVT ] 4-y5A "_iwZ0 CeL7@}j:@4x
ts=F
鎨] wV!`!`l2йrt(udF' km
b1HTAWb]jFv
ކ!`!`$ q%jod-/f@o [ajYq5 ; [ ۆ 3 C0 Czb7eBVUYO!OwE/{tWznzWi> *Nɫr*Tz!9E JZ#sDz >]~FQ֯Y\.]Z!+- Pv
W)QT`=-nFO;|C0 CD5mnţ ; C\X+N=TL=n,'EXrO̠#d7 8eG7Pۥ?`eؕsOປPU"i*{io\<.n.TgqX~okڙ8}G$9]`@@ 8xȟ:zu EW
CHڔ`:!`@OD j4On8oc٧c+W_^/j}ջl36m.E'/ ssjkj<} P'<
i7ߨlڸeb4#MX ]M|ooR XlGj+~TD *TTע
yE^ .fb#O=9^=psS#(PWS
"U'[ojGYi)*U]z:\VჄ&L\qo{ q C0 C0 C0 @t #c ^uWŽPW > g/:4k˪S^)KqOAwcobXSهapY'ŸMb7#SO8yU7;S'Cd . \7laeɺo,QԷ!Qo| ;iP`ữ,5'6_o^[zu 5 ^]:潄vꑎƔl~98E݃וRz:f|xUl<z>y L9HuX[ pEaa}2!`!`!`@F tIVe3k17P)9ǝqL\xxsqխx+ěW,Eښ?cCY5 {Бc0ȣnX9
3pW?Z+߭{q^^Q $طKX |gg/a{G*GEԃPos1GiYmx21ܿwn9 9S ﾄ_^}Y_}F K6TbSyKqiXd%r`0rq1bC<UePY#+Bo<C0 C0 C0z.1F+c 0Uu/00
ek]
cg!Įg /+̽zղm >
3t 4w(Ҧ쉣?g} MM-exp!SdZ,t1}ׂ\<|5t_l}w< &R"$xeC :Aޗ 7 ?WEW_藓E1Vs>MHFɨ㺼s G8g} /k.ˍ%hll χ\~U Z308?M hLaE>/[= 8œ?'+fzN0!`~(-az!`@OC fo FxI{TVU9}v b ~q"Vyoq,FgΕoyN:Mb V]U>y4q3N.n;+ƨq( ~7f 9B\W#~'cxv^{9T)2knFIn
>Z v CުkВ"j(_DqM݂)-x9xBTkxeau8+ƹ^Ђ49)^[[S3]< q^! D:$AT35 C0 ClVm N<Oz_6y"~oW~ j7~Uk6}LHϝɱg3;ͷzS6?N5;=3ɝ%2p䉧a2('I]o[ZNBc}-z xq=T\?~#yHj>#ǹR: NYXb-V|b;ˉ@FZ* 5ݜ*??/Պt!JARK
7Ͻ@ޏ %_&~ |RuK^:tqMb7/-]^7 uKD* 3 C0 C0 C)lAlc
<1 \2SVg%ǝy&:7x2zU9 \<YqMK?}w'_z+_ƼbŪ/g|k; UP^?^ž#[]}m5;5b
ďw\PU߄'|
7y5Ul*-NJŋȃ`ZLz ӏ3`劥x'ԻRN}[ Oq_n M;psij/aԾzgxd]9vk:^*ǰz:?w)}d>`gc ^93/GK{qie[ C0 C0 C0z) I/ϑ/[٧KQ0l & 0;h{7bg |kn/?$*&ʟ|%Ey-<1Uʪzƌ?I~sB |!{x[q]WÍ?ʩNu]34{MET- ' yAFKWߛ
_4c 7bP: ?<|x 1Sq' ? 9c1ul^+!?33 ~o/sO,.KP9 };n˯ FCSwUNcaO{į ^-
w~W^HtZo/b B};^Jvvv[_>@IU
e7T(MXc37W\?Ҽ !` @Kٳ1x`3{WZᝒtTˉ)ɒamc Bnl?~j<]Ӟ"GK-teP^Y<1Fe[q[ؒ"x鮞䭫&Al9*Ȼ<9@ӕmڀͥHABd9oiUliп܄ -52 jz7yefe!EzTneHBQQod~u国rӳQXXTނMUl45ԣV>)!2t;KzmE*|C P#+Tɹ|g!qFd5`{^-F oΝ;N2볬ݽMC0z&e SݒJ旗ʌd1j &iri6=O_nӫH U-E$1vsP2Xm+
Zmnn8gYdk5{OIGɐnYbӑ3?.yoӿ@4/7GOrD> X4c!Н`*°^=[Z
C0 C 1@
TVC:55eU3abpGGH<^ޖ %oc՛:ue0?vh7djٮvr*]s74s گݫm$xvoi!`!`G ɘ:7즹nXi|_
-S5/RH`ܕk^]X:ˋeZ;Yؑ' <c+[ Yהw=N !0g[m]!`!`@"@>G&errҠ ]Z
iq UX亴ZJa 191Q9a~P>
`9) [gy? xhxx-eO0C6m#' 9MC?ZʏF[Fa~G|J~G! GǶ++#ZOpXyUv,: ƕ./m%_p +Co]]-l!`$"Q
t Dni͎N}/G|Vat5-̏Ve"ץ24-W:Hiɺb嶅Kϰ ]0MVyԏEVҴ0_b Y #? Z-7 mIKmn#AU]hJeJNA9aD05=^\bۑ|A50 CH4:49
unW퍜tq] ksŝgĒg獔?>&6|Mht O]X0k M> /LeP>Ӱʰ~zQdR`IX' ]<IBmam}9^]bW; [;n)}A屿^HGѱ<LqEXS& aXtzP>郺(SV+ٖ߫ҽQ#yW_ W_ ]cY'⬴gG`tҾ축ꭾ϶r+_ ls_`РA 0 CHd ,&ǏڵkaE(m&weeT7^ycq<~Nlgh`z%o켡s{R>NÔO9 2(p -q̉o9r|Gyl0 Յ>⊊
OWLٱ'Y.,|bC*
Ss3 G{+>qmEa$,mE T'>I%VAn[E ־uU״/v՟:RC ڗQ|jamtk }8s}-ei[6(m|mg_q˶bn_϶& ?8n l+[O~sO){]Ӿ@}WPV5m+.3n 6n{^#]f܆]mu!lރ'amH-k4m,}A z
g]G.4|':t(!`@A3g :ĉ7?ܘ>+aySD|:iU>iU~$xR~PG鴎a#g 8[|9JJJ1 C0 ^/{'Oɤs0 C؎tNcOiѠt}/D!"{[tF
va$]ŕxqbŊ[Wa>P}@ Vh 'ooZ |^ VcqI3N<S5-Vrn ƣe~!mO< ˧jm,H+ih=(]]? <͏&?R=0Z-Cˤn _)k7EP0Lwo|-/(qG_nyAHyEVD >J~PҪ a {V9aܜ!`!thmet11+S#ޜ|pK#'Tsߏ~yQ9`;6
j|ki_}w ]
k^t5l n +ÇĪ<-CA_]?Hq&V c<HóhU'?ۅFe˼qjDiZv|.4|D
ܾ˭<8 ^ӂK i5 c\xx|^WuիѿaۯT^ЏEl->vq !Cv(/ ]
k^|.4|Lvŋc=3k f3 C0 Vq
k5;M"mzrU|kOX^X:(/~\9䖿6cc˧AE#=JٶQӧ8)}G4ayK?EMkK#[KSh~PV0 ?R~$nv~l ,5]z7 &ӥL8 Ѱ><OUp 'Qyʊ~|F:l/Fo!@R&;J\b /h#vƏT^gD 入GGq!DuT1 w_lep//6-< .En "VFw6yh<n\~YoK7 cg,4*7 Z 0>+6 + 0s|j_1 ^ԏFi;'
WLҨ4)cG9`}V/ C0 @T;UfgЕ Wt<I%&XmuaxMDs]tn%^;Ak5bKZƯ֞>:& b\ va
i4D#$" zn/ ]{0-Q˓b-?fZ
vثs~m)E^\: txm~mqʦn}毠TG^9NqII|8gt<0l0 CNޝZUWORfNԻa8)\ ԃ'Z4@v|CNϛʊToKcI&>]S
I$KY)y$6 [zV-i^ӀQ-5_e3\W>1ӕfQ
0x*m:"x4
.t^9\aDCe3L&97j8(3>4v[A~: Wc5ʏz0-Uʖhl}{ȉ)KUݧ$OAJ%-.eǙ/z}߫7?V>LWA =_]_-+5Mϭ:u46"]бoFVx־BcU($LN -ҧӽ~Cw۵]'?w:uF!`;
3w,כp$+ u7)YY9:N,W8WVPGds746:a ƹ8'Jh @eY)k<b:ꚜ<: _'M'7QYӝe1?7ӵ BGE:o9I̐w ssd"dō^}X7)%{3,?'yl7bX2@0NOu|'kRQy >Z
)+C 2( RҶrHB[b0_iDqɢؼq| bЩbtBҫ%!KNMKoWe/e쓏Q.S;N /˞^O;0 @ IDATJ_W՛aV歮cY ~ ycݐ*RL4yP~
>o-7gaQJˑ|>0hi|7a]0tp10Ms 'G
>bR,|)r
®@ m7HK7m됙-xy}m
6C4*@V /ֲ)AվtP_xJk+qF5xc![A2nKSS 65-=y쏤^0bZ|gG6v0MV7b1Ч{㵥Cs^uuu q ?6b
hhjRrY2WV"-#]>5=j:<p{uz
;--#]' >uP<t4v9W,ѻx8F
xO5Xa\DGcfVzIexi
tl{ 6
\%zNO+^bϖ},pp m)h⏱tZ
3BD.1g!`t7@n-&rURIMx{_9x$7V?O?=l/x=BUmLU <uIS jiL8}
2Q2IV2dRʉoIeĕUL՝`z'| y
ȔW j*y>9h!CF<hk [UA<7Ȋ7dSWOYԔ BZ)["*E,; _ Ī%"&Ǥ){`iS=㒺NbK=]d~ZP/S1I&ί</\w3 n!o[&ԛm_)$ۊM+qwϓ`@BK:'\ !؎:BL<zԄ+wk-Ë~ `hnsg"{E8liHjd}R|QrQ)tՆU7fb0(id?dzI0)]^{
66䣡| ֖a;aw>3bҌ% pʹR 1VI[VD_>` Ye^< !ϦUKo/Z ^ d{_h Ґ o ~sş&'iF$KqҚpz4IX||{?Şg]8 &o~
q0? /o㏿&Ri,IT$yo?1Sㄣ8c?k*!rB~)\}2>SEc*uۭH'N=HdFA>pM~F\%ĝ}xR]d YX}|cy:Ͼt;Rq S2n :Mb` qgx?l_Ig9| _2-UV7xw+{O )ׇz|qE?7/3O;Žszxc<}ӇL= 1 Yb{4SŪވr]>[Vez9՝\ ۫E|w?F 5 ~|%;Wٷ!_}kKs[G<?w ӐJ<x]XO:F
(s5w-y&mރIOכfKZw4@*|ȣ{;y j|s7gx/c!`!0u4xky2cp' N8l _(an]ςnBuMd M&A4Ĩ@]mLꐚ!\>! |Eb0p募JVqMf;Y((,C$[Mʖo'R^Vldg7+I˕ILi0c}Ƈ pY_A~N*dUPV~5; [)S&I 22*ˑ\Ymp'Dlg סT&}ymPUQF<=C%5CV]3d"/+eg܄ bacΚ~-ÿqNFQN*eA YokeJv9QSS#E*L:s'Sqb1dقjYULo
FBb y@p_/
brRp<Y%knQ zlظ
I^wCHXtLAq*uKxoiPԕ'h/FYeǒ.z{u t˪{U
`A&i:T2-779UҲ >3+EOs۴k~i_q݆bȘ=qՕCa`dJ==,q&ߦHϔϒ+f`)cFnjc ou0)q遽=m5(O9]>LuP+Yd|C$uRRYV&[SkN R-b
II
rI>/즆:eLWAʿ<> {}'!?;[#z]q}ӯ'Q_?Mw
W=&hXnGp V.rB\;{J߯o5:+RgJb|f)Ce|pzʮtiJzwm
wĸ/IV7!'P~6j|w7W4|D^`lW}Cyjxɓω_lQ8gncn^)[ ?^/Ơ {/n~'<c+"<GWODߵUAZ<0I:m.1 㖯-y~-2<D\>vh*Fԋ.?ߒE?4E`:뾛[ Ť'GZK-^_`N:h7ᪿq ta#FL4ȵd־;mS-zXg&.q r=oIÕ ԔUx^ 7ؐ2jʵc#C
w#6lrml 2%_ 9C0 C!`z7k1]mwLp1fsٹp353>^ yQ=_ B1wpgĊ_-w>\sDsN>T =@dbSO?<?[}9
G s,?[0뼉wexwuwLUmS< e`i8q-4y8S;_ |<6^f;ԃ@f8!| u6` og^=G> 澃c&+G c
F
)ƺ% [nAq8 2F{,}z?xb<8[g
ŽrU6_o$j3<({JՌ ~~~S&=G?{_XՑC"`ݥ*n궻vwҭ֨ X- I}s$GP x 9sfΜb7qP ?-]ڿ<&i -1h0 ;a "{fΚmɄf>̬W#2) g: Mƻrg:tN"|X6 3Ӱe,Z m:瞍NmZ,5>?k6Bz6BqeuNP"p\ im` _LHԖoZg!95
[7o2ZZ,ق0?ô9ѮN> f@ 0|'X#LZ)'wӏ'agyw9睇A "4 QHoڔЙ+gy{%2~ڇB_Esfi@t%{1 f4lزkVEag;oCjx^x h8ѲU[e8h@IWbղ(Gs8Z53 pj0a'Xiw3G'@vlY>FE5W53F :SRh<sF.
rPM轾Liޮ͘x|x̜m;ĉsuO19 ;HԸsvl795z_frm#;[W!:Td ]qN}M!~BQ-!W؎]D,_ k*@\p(dN>tK)Pbq9J䄓p/W&}!>ye3؈ CNǕxq쓨L믾͓a岹ϳ#M?\sh l[21 sS@-Caa$.-%XlG8Oc>ĥA 덅֙ jKTU>^]~%Z%;4%a:t">>{Ù#NEӸHϙ j/U&Ѷa)>6A?j[a𠁸X-م?yߡSWhq##K/
,GV>v89ߍ{lh2%ٛ0}<4mg{ c?و7_} ۊ$ E{9
9#OG:"g&/ǟa͜8 SIl$-_?,AU 'hT+"""""p!
]OT+w^&u
+0a-e#xid .%y CON/_LFai1:P
O߉Ưp<7o=8%6N ;VNǔK! `V̙)kGѥy#|] 45q՞)<1N+rϣRŽE'!P
͚m~6I\ i~ 7p٘;cns ws/6,zr-WPյo>1&-O1]; ό}_k/끢 0eD{=3Ǖ dϽh(|[% sR|?k$/? qu7q9vs|&|&OFclY6_}9 ]
U|;N q&ը`_ajt Q*c}@`Y1&1O;n]O m`ŢpuѕD`Qo2/틿Ą ]Pm*6)XHtWpPx0>,)z>l+\XWp{WqX5>=KJdQxop?AZqǴ;oV9<jFBVRՐ Ic6ZA %Ol!nb8WvO>E}8cX9wnPFW>n`'M6i?7E`xS d0³i?NCQѺ^{},^4)-prF Bdi嵌_37 o?CO
4GUXjʩ0c~}
B=90D!݀+\럯"iޑX4};)>1<3VU-ЏF dG!9!..T7oYmQ
"14WŹwӸU#H GʽMsj<gOȈ݇SD-.AMv,[qim%q˸ <ϛG esk LKΕ+O!.%
#z |2q X2[|9u.t
r':I2S;r {O6^z'u}wa{{u逘Hjp897ijVz8妎`7*&
85ev>2\ѱ3KrG1)E'Ʈ?O?A| 8Om (
6Gb X+"tt2A u`@Nh "Le{ VNgcBq$ p'}f1ye& N4wi>}$mMdW KD&i8fq 79>| gjE cKЦI8g+^"""""p#p/{)amTƍ*[71yJ?##1 M+1J&+` gƽ_ҭ(]w&q+oۋp gJ̷OEjt G0imFIy)nQ e& sJh n$,\ Pz"9[;g]xJ'<r#. dV颩"G, 0ѸAʒ=# ]C{cc6Xw?qE#јƜ0'ӨR
O?j5>Y d!)&셭e{xm]ho)pO}p8DNui%G8Ϸa j+'& >ݍJ#3 sVskB!Qe=N!K.$)ݹߏۯ:[`wcT)/AtD Z ե'ܘ,Ƙ~/Nꑅ;Pm4(~M>K>U`w0mU_+#(ks+yrοVƿ kn%in#P0̉/Oe4M Icgq>mkr \`l2/
;+pP״ 0yXqz4FI- ڷZZRejĵ^R6 ։u-sFD -pԤ8j
p.U{wl b
m\5έGJ
Ɋ Vވ]R- G6O h0uS%8*ٟV,]n"0u,s~1wfOePlmcpD&qB A j{䟯2pn
8нLaW;ߣެ]?zH[ߢ7>%7?8 ̜2qx F_y6ο$6mF߀2VɷvM iE[3`zNB ѤE{v;DVi*z9j9 [n#L+<K:9kb`C6mHzoK.ǰ m0gLY[ {Â$?m(jf0? ,^Uv$eqqGJbc[ 6PQ3CP/5m7" Nʩ') ڞ~zN <S矄<(:΄f}˩ZW>=d%gz7cXƟuG ?
a4g`xc4\϶ӣ-e&Wܡ=ְI?][. +P;_5v츅c^ZY5^i"6o^-sGA4UeAtk %(#vߝJoVaw ԅ qpppp8pҼ.2tT!>q%q f#\ɕTVMSaAka\ Zdl˅p?o,Ѩ=pxT9~W *
4oR.9ڶiKh/tVp6wטVqC1SETb m$ixFF;*!TqJ-)hي:6|^cO
UsU(ݶޭ(ݍ`ִk#̝Ͻ-X6hֈkι*l#>~9L҆`Q:`K -'~=;i9,kʥ#Ukpw%bUH<2 \UlIYy6ɪ\SgcNF79IJ 35 (ErU0
:$Tg zMMiOӊ|ŠtqWrF5ud$CM{` & 5Yo(8ˉ VCu82e)-/贡 /%,`U9<"'@uZړHQi'Cq~{ia>A8 U\~Q1WCѝ[(Ξ?|{q3v1n}ʐ7l:zJ|?5VQ{ôFjQhz'x@n 4 q} Sb+;жEW)6w胦Tn`kkcgc8aN:j\p Db=1^ 腸FS\! E cjaAvbV`TfAԮشioFz!^|}1 IW/Wɕ{[o};7o£ϾYХm c,f<46Ey\VYhע,Oz@3=䇳ÿ a.<i 1}ЬE+('|-x{. I83`
{sM7vnA,9헸1`fcQ?ޭ} mZZ%8W(x#BO1$-kIx滱A*F
mFբIo'ks1*G^Mܒu2>uLX2Tt澈T&D a[5ʠm'vBvbv 3va?s?ᤦPDA99;QшOp&11a_ӧPkmg Ё%f\O9{T /8\BKp 9 itKa\!v,:aÆ
O̯86gdQ:T
0ANXѻ;v4$q5HL'G#F˭)g_<d4 QN8a_CdCQ=l$?ǫ~:AR@y (_F)1-
J
l6Ƿ:j
rPW =+,.Bh6mci#koR({ =z@z#:IFR-g=ӀvL7S` !+-j4 T_ϱmj#?7<2߯[m(t)oNTqE0-n VU)wxèx<Ҹ=:K@bDcrGQm ֘jVBij'9" M̉$&Y1i܍y_*NOO ӜA\
E ģqV|
T9t\)d&.ad×G1l'%\=ߓC7 \yfoR8#HD0Z>e=pU _7xB
F84r4 b;op2V Id/ݻc# B req8i%Ԏ*מ~RI:ʍUn=
I;qc\$x46H!DL
F"HֵSc{J%j3 T2
4U#dNzlG 7s?:uCUHk+iCvT8!SRʾV-V ? CJ<3\T3.0cveSNm\0#bLlm4Fo
@xKh,MMIM<$ NoO?~d
1fRP)?9:4@ X
fg&bi,!1UQ۞iӣ mip VSG)P㘶"zĭ;K _DD<ܧ&}OfC'ٱ^&'c 0*|w07' L9cÏl,
3hPJ8TM[>[fI0GBϔ τ6o?
arߏO fc
vFl~f < =;PKۢrvn` v96cǕ4* ru.....5~U.yd Wɧ~1qhLW?Eeg!) 7o7$cKKn2Il #`͚3:OK/Sү3s {y֤# i-p cȽCzR,E3oAV;pg&6W)\)@OѩW߆?_uY|,)ryw6B. = r6/%c^qRcPvGW+Osot@;z_JƞZh * We}IlZ4 ۗMg Itnی{Ry2 I:"Ie=ΞIWyxajcua:e _N
Ju3>?PX `]c2ˌG%FꟲT-q{.âкcO>w{ (axct;+|J̧$xвv<3v:ϻ2D5J@ӟ> b٬/NTM7/>~G[UnWW߫5. %^#:` GĭϿ̖X>D"w 74/:Ǐg
dLlaڄW9d A Sȗ[f%MgL&)OzxUn߄wxL 7;S=s tN} f?.[a_B evˇ`ޫÏ`JV*or;ڳ@V +/udVeU9q\P-؋x~UKxjؼ#m| Afe4#~DA;`J~'
E$'x4V+
0{LQX.3۸bs`9ϣؖO%}o"жko4o
0E3s:TnDzy54[\֫&+! xk v7r/<@ņq！#K`ҽ tA{ڃ{\/K<8M#bW~(eͭ3>& 6|5~(8BD :eiJZr]`&ttb5MR߈P?|Q ?Vz,ɗ
9YS FSn{xN 1עŃ[Mz1DP[4
xg1#-N 2 #f4ش~rfkgrg x*w9'G| th4MM@uu[["HIsǎh4
n<3~Ә\6'8"CG=30xp
"0M|swKq@ttZdݺuT-icw=|d6jԈ[V\pQHPTO cӖAhݾ#ڵmE>Ѳ
tE ˽ E`tH]{KV-CWҐS%B3ѭkWZmZvH Ǭ9?"W\w 8oWTxB5HF^=4Yu
iI뽭ii91Xr-"SZcHO3Am Խf c"yktn{f0[R p奰AVf:DWRсV+pN1 Ua8p٧F{XwSnڡ-UC)quu?PX^` BXp <u3M Ozs ٙGܧ+%nؽ 9~HisR Z$e+!<6zvDt|sb89 ؘWAS؉C>}e)F}**(*ELG"LW 4! @ SI\NNRܹcu,d-Z@~}ѳ[7iHd WyQI84Zb,k$'yU1ۻ;nWnYf,0_y >KM
n uAڶnIWFtMSi7Ҹw=-77c&ֱ-{$!$neu$^iQ>55!]g$R<4!\pɕhiHQհ'w沏tGGN qb>)Ƕꃫ]("xn\M4:4YIh3 =uBUˋвKo\lgw toOqܿ#F&NoHtO"[~3$6I.
njguBSslݮ:ja+z>+',<h"?=jŲ6N5Vѳk'zHw1 u@Z!pEs8XxtDf?P@n9-zz5n.y9^[erR19P|E3mEd\랅Vͱ1Ww/Gg^
u~~:vJtJtL3w+ sco١
z脰j
D\rK4
Vbڬ.Bћǽq 26otzW_~]O[ X>%%<j/Jy dXpbkZ&
'6iCb]ݧ plM>ߩM9
WNn! k:cs|Uq]RN<X=r?s DVec U/^ʀlݐ6]U1t;zoބsؼu;z 6<@P sNhb ˮ139;aը斟Q_8iMb͖F3ٿO;KC1h@?o߆G,wl;nQ9<"+O&@ 50*4p9s@cӈ\Zv_)i<Av2v57ݎ gyS8#y<`ڴXf=q, ,`Lmڙj{#/ )1pH 0<:0㳌w6kZ([MM"Mֹ<E½ KcZN7Z2L
غ*779:w=w<s&7 : ן#fL|ZNJb>`{# ֖+G+OfFg_+/5?\9:[ְu~VeM*Zn WfRS~"}rG P
O>MΐOiyڙ !WC&
)Z唾CR%?
tΗ쓔,|ȑU22TŕJmsUP[RWy
x{bbB&j:]ҭʒH[AIKU8qC#US BGUsj$mkE_ O1EbU^) DV̕)3#^&?\uJS4u4߽s C#{
*cOs_K7!56+ [HuoSKZL6!Zѥ%nE)']u=8[<2~t}iN"B/k>P{[?
v' bbbV[/? D0QX,K
ۀB!&|%W2X pmf GjjQ_ v7vvԡ h~O%Pgʫ-suΣ(]5ʵ d0U'QFm^z9Ӵˠ6!)m3IuDP2BKNe1l_ Zמp r}n$FE3N5 Of"*%Ǧ<`n`?&+H {i -Z@+i{װX xЙ.ʨd\'<b(I[xk<'՟Bذ8ff`&__G?0)SFm D5g,c 41*O PtH\\
1u+-MfLN9>m\̣Q~7zמ78}뻵ZM]=S6 + )]n͊0d;'0 i9}?M@^ $CW{^b
3A2x`%nݺL7zv@-u,PpDidIKu5ʄҼ}FS2Q8,5 ,[ $'P~4U8WR>{=6Ib cL!BQdTCwrdzRl\1L T':dJC&ȁ\# T ,LDU M%Ϧ<dT x54 %OA(MSBs#CW7G8I0Fڙ&bk/IiY{ fI7! ߟ Ӎ^i<3A%MPH* MlOVSp<-&Q˷F5驫<"lC6UV[
5F#O](oSDB )
3AM1MV*/j'NYT f}1l| ! ǫ MBsj1V
o&N<`v8?cX>Ѩ:Ă ~vP'$f8u4%r ;*F0dB2֨tYߞܜS0':` 3KCTF*\mV E#s MhزOaf EկC5 ;5bM f۾PUM C)i2138㗩ƶm_Ș XY0^4VMXԻ3^$Ԋ1td/US/$ʫIph3e1*-8W )3g% =rm ޝ<I> e"<%)8pP2fDSwNݚvKzk;,ڎz?|93,p % P L3DC,E߉*N(om-}ݨo0{SFEg_Yi_ls*)qpppp8~CKi
bY$$:?q%n#`3D5
%1I:epwOak2zgÓᕮhUW5NWp0,9=ۼ2h&H sqCen6ou:BB
_铆 Ϸ֙-* U/Zm/{
(鹿 jxZBᨶ&
YCMӔ)qM~6!_V AI nнC\ 06j^>{zqLk|kWBM:}ɹ74PDBYzZuN_0$|Ƴԅ}vk b6WUjCmC;X+?5ڭc_l~z/gӰgݞ 6> RYl|Γ' wJӌ_ 8C>l6 m˃ R\=ӄ=,X|m:u
l7 Ίij@}U;щqu ?PݛU~iaoܫ+ /5Eٱ,^ ?/OJERJSdX0:FZt6;={F816 u_5^0C-XAPNyxg
q
}SO8)LqjR@9JO̾Q' @Ѻ\}y N g cλ6M䀘~m 2Ͽr;tzӡz8w*~0p uiڪ>l[R^y}q ՠ* VT ]$Ijs;Z鋖ah.yW "~) [gTn:.....G W@?ZHB9#990bxĐ=2hT*FT HiT**2Wv
S geFŘO8;*WS1GC/zFK][fSҢr$ׅFpo] *GK0vvM ]la=nPUkL]uT Nݪ۶,>mz8mǻ gӘFaKc4Ϋm |ێwP *}ayml[P:*o ܉.MةM6&ڏ'L~
Z Kxdy9)(~֩mYAkc{\W,]7ʨTWY~ UTjD¶FA)S$
7nҥKig ?...7 @ IDAT..0~ WN]ɈX[C?6-1\Vps)A
'
Cq/f_`PWX J_[&`۰姦<e_}ӷ̟
닏7}"a!-Kӳ&G^ț MGe^yuuִ=խsX
?(Zt/pTEHѲmHuuim.,m[ *w&ML0pGG3Auvk
l'eERa8uSyd_j'~H֩spppp8 8t2
|X5̼ Zp &JVݏuRwI(Vw; n:!x/ˑ/a I\7l4o ZUd
i]X{Q~ ? pXw S)uLvKf?ҏ쑆?kSъVq| c}^$ޘ{ S \~K ]jV9ߚ#4 h,;Xm9~c^`ݡP_ԼU a{]%5
aM/Y;_*tSx^mY|/y/%trpppp8 3eT=ظy i9GHu3gnj4?M(j?bFL8
-礡;ˈpL. [{wh +kLOGlՕɣҦE
]MCCm//; 'pҫ~&3gAk T_;;>וWWW_?g{oW_mg6pz8FuS`W{i M`R@mu]V6ﰖN<l<^yվc04Ǧ7}>86M^]\\\\' ~ܲybіR4OK@kO>Wti_~qp ΆѮL!݉# Ͽ&By|/;'xT. 21 w y#'x\m_R+W~[UϿ*4gGt(w.j(`aվ{j｜Gk?~xxoZŷ,
Sc{U5(8Ǻ@Gpcidլz Cm~`9o ?)#Ż?,DR
;)?_w$y}N`#2;O\OxEmG}Q(OE2pgʗ.q0V xԟNoӴ#oO?T>iM"""""p pLx!hr ⊑GPR\b-
憴e E|3CC I(/O"ӿ%zwhj@ǺxPpx/ƥyDQhH SQV=<['Q2 #./,;z3Ee(.)#4AЄa56:;#Tr6Z~aĔITdkFBż8J奴_κf]LT i]H V7e!]ee
Zu![F{4?5_xPXXl&i\.:5]ۿM (UV<$TmذLrH@.;w,6mX ;u kZaE\sG $Huy'`[.w(۱eӆU5߶m1n& *ޖ7
(-I6D
Nlestm Tٽ{6=/ʈ]ZZZͶ;U6"jԏ
16[&3jCih"Fq_Z{6mdl Ȱqspppp= p 薥j.5@$|9{~[.~ݗ_P{dt?\<S|8 ۦaR\ǛpI1kxZ"fNz+
/MtH!8. > acú](+p 7Yb\?cKZPWje;}2 !o#COŨ3NCjBCÄyleĜz3z!:GLyffY= #$,jeE̚-[ǬٺWQY&b`|,Æc'#Q u!Zpl {ٲe-ZN+y iӦm\'c7Ǹǜkx3ѱ?ltjnڗJV睆s\Zj!cVTZ rJ4kL@ KBhTQ {g/$Hlw>wBLPEMӡ~/!TiTtJK K,A۶m :9bӱVcؚS( 9 y0G Pv{kkt63 39aEMHHB\amؼ<{wq~6&~1>[V""6#:' !\Obח
D _ &
>lw߹ X?GHM7^iaMNn@$h^Ԑ3Ј#xw~ڰKGhpwǙбKO!ch$*c99uF|(
s7og(?Qٮ9d=
:k𦻖 /Ơ3ߟ~\E+{OߋFGӪk\aL
]-#WCWYYb¬0hCjUE:>kՐj&+Mt8$ NF<[WnY;N= _ ѡՅ1ZZu:bi(Kh-c ~+Mߡ{U
KgbpV_t |uZz$w彺V~|2$Tj"#==v-D
gI7zt9ac
n0__'$D`ph9mJB<cţhB+5:MlͩmjU4N Nھi+O?܉_{ ;-egww=' mdЏٶE_zj WD¹8TMN<WG[ w>&`pi OWD#D<p;IDz;[}Cb͚5* wXEEEEE1 ;PSޠa
n?H~m3Xv9Vہ[ozÕHm-Q }9"39`m>g%<g#mv z}vl2ڵy;[61}c =nTu-+=(~R|2λL3:_FXdyv +h:$m](?ҧ i0Y'|ȕ uKGj Way ͥX˔U29 cQSiﮘvKg]m'{Rp{s<vgeڶƟ|8ϝ5; M13I&[,Y- R5z0k5+ꪛ,͇ou5'+x?E0wj
xaSw|:|;s '$vُؒ[a=; Яn!ݛ&J=WN|
kT5 s,Hux}X6\NT=S_D|`0Aغf)VnA'aؐvN,Vʐp.5m+ׅ&$IX@I,sEF8>YY0-:A ̩ؔ+`LnEmhL-1AZCZ9FXJHj 9
ږȋgKULZ;0e#p2}=U(ݳ,E}qƩ hx/M:RvEp^W|jjNH~#|ۓoGmI7 Y" =o.&N>z3{C$Ckm r V1d+ 7WY^fjyJ}(-)X(._Hǩ]@.s'2G ]fpx֮~8~湪\/݀sRun.F9L)3G1/`wQ%:ǖI$xF(Hv_;
veX2ɲB\J]W`ڜf%pռhֲ9GkȧjfK|aoC*Zlw=xٮi靖; i~a{vn>
ijڗ 4nL@NǙ83q"A15Xn)M2Jpe'biBᴢhՕtUcޤO1f5 |W9,| v墪 =HY Թ 5 *%|k +pJc_3[A.ĉ 5"}w<rÙ5y^=w"~*-ތ0OW
<vS
s 2S}y#+*4]%7S
~ v*d!EpH5;vC u]>Ჽ`Uʧp¸/:]"""""k!p 9q(CJR<ƙ_Z<!ذu@+`{ e
)<UD,{%}7 g<uxcϮlTZ =Џf%B.м=e3Xh
8QIC@eh4 G6R)wtQeBY4!gOz܉*GzGlb .@݉s'gD0v>pb#Z>jq]%J<E,AT
un@
NLMA
J*7܇{7b;5D^Ů0+
TVj]]zi"TZu-@XۉABq>
п3m]<ѣ]
JIfVtlAm1AOM8Ip&`q'ݟAHwRr8PhH$f Nn{vVK8o;NzivgۑR*ߛv1P(8a{x2"Bɳ@9>&qSAq{ vDrl1
Nd[3`j??YZ`O ڥu pnٻ
7\ćF58Qf,ہ7.գNB$6Ԩ4b}eR_T
x k^\\\\\s<߮x[+{b\8t ƾ fϙE㍱);"#cG^WSga)KCb)~X0/3# #C0cXj8O=` [bC/:_ xi(*j$ n]ڏ[ -ړ.~lق+;:8
y -AiɈ
si'w aajVsVFa$O_Ѷ_,$~"@fg Tʴ8ݾޗR q!dr2(8T+l}rUU+p @|89{#.3JF&m #qGSj yH 9ykc^[
A0ʺ_4ed_0ǃV]bU1 #J}H/Ͼ=]
*4Ue! y͘qh>"3yAgb4'8 i[g_AΚr~+Suq i.*GUxyG2 i:3u=]\\\\q{
qNlv-fO /2;v,Ѩ۔0k+{Gቛ{'Ov'.߄_~Qq
N9x+({ǽ+oߋMh18EG矡_W? L@-MԁǮy8-fa_ꀗV uĄVZY.f|=2Z@r^
U+<_ ip(,*91
a_Cr :QUЦ IXX~yd]uUQ NSE<-epgD]z8uaPc.,=]m[lHڶ-wS
GܟG*ӁmјF'QM W4: aഩ:A,vepW4NmsRvCyd6r,HDMiho",Fx>9ilj
;Ώ<* , `ʫ{ Yo!І*FJp<kRr3IٔmbqeY-,o|Ehn5VmAvtS_ 5ٟ bUS틪 x<q ϼ9 y2~}=j4M5lMn9'Cx.*546Far.....4Z͝>bLcoƙ~n`0[?\0<iWތA/52^p(ѱ/p{Us{uq۞';b&a9@cd"m,坜d> شh:p4e [vb~͘5YtLCYQ.>yi<1n;f<0Us+:"[ÕwKȷSJe]PUFo &FͪF8>[,CNs)r]h<i<
ݔzWz>p&+cL
ee֗Q{6̂pa٣кw8WNUbޔ/pbnKB+M:%{jL^Y'+ 5+]W^) /0 CG^{gdC?~'_?=Džlg dbʼnrs~-V}t}YUm<]ۖR0K;2uǟ3o~Gޅ `,ݎמ?hqN }m[9"/c(h2i^dt|h'ᄕGŘ.GHڼ
~ ҇߂^Y9HԬUwJ VA,^IW[ա\FK[>Aζt8&tq
~v>c3!Hl| ઍq ?
qK(yY0 Z6mh\ 4stZH.y J
75 ֲ*|:e zqbIèΩc j ċq]fҤ&
*">ݺzEUoVGm. IT<v?ۮ9 [ۢ0q}r!
RJGIq( ۦ% aYX>Qv
#!{5-͇Qc@.ĸq)qٵ7!j_>~u뵏p>GZ\Wp s.jYl\=j Ե}g CXq}6=GM
!5m4U\)O$CĥpE YĐ&3Z%xmJXYGiLPTn{
s:;; k|1uh"쳡nxE~Gcئ<b]âm?D5ٶ]fEt'x S>Mk,o1GKLiu3$IU DѪwsaDXTK}D0 v%߾I̽qpppp @D2o ԪUa6s{ Yo5 c{K׳9OOvB~;cxM Rkf a?_OΩsuYfa5eUi1
Kk.晼cnF"-ylV=KQ=a|-VRnjёe_riHǫɥ {h4Bj֬QxEEi!줆Bhx.bkώمrcB2I,gB4b]49ѶRՄJ +0a@:GbmܣHM#fPԼъ[7of
UfӤqeŬ=<aF+>f܅h؞AE·h넡xYr5<{W+ Q; qfCd4KoP{UE)v"acDq ޅ!1{CM_WE\ 8KՄkRWh ֟7<"3,+cb6l bl=W#T!q#3z9b('|k!kF}Q啦Z:OjBmƵIgk Sjm8{/ƺ_TJ[q av\eؖ8C!KU6 T.+99^m\^b;d̝;֭)~cl|"""""["p̬[ZW
+08 #\MWP~W'fqWZoҊS D4 a^ oHUVU3Y&4}*
5u
"Ѫm{Tx2&E ]''; t}4ԬKp ܭfՅR89uj˩c0?&?@k #5b],JJ~r6=5XqM*6<Æ<pE8yӗ /L%VUUr2#ݪׇ72Iq=4<m:O& 9Z-(&|20>QͣE 5!Ftq`y]i :CGs^x#a,j'LGliAu!a=clkHָ/}} 4[lhr \\\\\~' s_SB&1 ŵLe.-]Q׳
# s}^$rfIqcMHH$oڼKhGԅebqxXz Gzo nrՅq¤!'<PGR^m ?N9i.nP@j&ѩkokqUP@ᶃ
<DZ-C,oN#16SB!))q@HjDQ;V&I-&h{lPr8yP1Ǧ)!Eâ"E?
h9}m5ͣ1֗MK}APc{F14ʨ="1ytlt߹ ^G~2K\d0_UKI}]k+h2:fOg@=Ͽ x@]83KotG0u Uv;B"-ށ~{s =* ӮP]m/kڼ8@OIX*o ae}w<_v)qkf`%l |UCaeVϭ1=7. }#gN`LTg2K@SVuNҿ|9|@nS K}V\"rҐu2BSo+ usLQ`Z-hEMf-lw%i1cu9(FG` G 1GFYd[US7ԅ߰.l9<u1+^/lz^,g$,xc[GXUɄ9n +Hzv<89]
uDRz۶zG)LMb_s'M@f\n#jCѸqCuXTC3 . ~'3SNu겧SXSEEEEEGЏ
:3 SMaFΰVν]]`11irdk5rᣕ? KCTG/-o:~Oﺄ[O ϻ.;u5uQEwKC". =T*;#0~Pj,eǏsMqplX2+A $eq <־CAպ]<֎Ǫ6vjbeU ;j(9cCwEyŎ[5.P_tF,.L4Xjy=. ^O|:Vu}S\![$Q v╈{""""";BGk2bJ0?V7g7KDӦp>^Vsga
s o?4# 셐Uږ*WKj|dҜU㎦~?4eQ~;ؓE)莍oc1Yݘ3sۆ}kT,3 sA=пWW4`N`BZVsn6]U+}-#]4 MLb4X; DA{[ov/eYX`F{=3|sΜaѴc>n.6eC;j3z}ҏeQSog%߇#9֍mwP wX$Իaҕ(
SXE.@N/FOf 2ʼnWV0S6! X~9ȁ1]¡NQ6Ԫ'*%wU#قN"˺f,&VÔSo/DAu &L8 5v\*'[/&L@iT%
t?.)㻸 ARʳZ!8EyXR>&`pvصa%܈] I~n3݇ \ָ͉i60>Ąe7
@~ =s6QM: Pj:^hպ Z'X;lXrRaZPV^XBNǠQap$-<V,*waF~7}$wOk}I.\u;9 A!`zKkT mx2 I1Xj-.nH5UpSQUV_g_1'!;# U$ jA B? eN$90b߇#2j\'&<kG BW<D՛pMW^ Vd hz ~OCLp
-`d S) [ &@g〹iͯ$'Fv>=$Ʒ~87 |}mr]ooFh7 {w`;ƞX ٹdBЅI ǥn!FMx>O +ߥ_N5k s&{ FOHL8Pw^yK$ CPnSM,l=!bpp|K8$w"E#;>] $翛W2SHܐ`Bh-rr/\9]VqI }(Jhʦx
hkVaOjthM"]^}
o.Iå] 6=5Jr
EХF]/ɉr21GݎݡV- 8du` 3yU&ĂXTOC<V=2 [M `,VF$#'{cYF@fv.磒;]*^mA$ o
Wm^=݅yN<6ًT5P5T={53 @KA- zwhdDL9q
1eTdy?]̽xWpO▟M ;*rE~9o^'%A @x&-sW1! N)9.҉3*g C}!yk.B$,~{xWW `
^̅Q(: ]un|lj D5%`W% vӴ.tN$Iʀ-tc[D-qe%e.tq5ۦM,ǧ?8,Y0 |1Gh ~nDo>˟o{I j5UgqVGsyı&킗J&=hcIS}LבJm^Se,Ku fn\_>҂L7x^f ,`|m ߾O HnTl`Bb"s!\4wnG;.!5Ntᒗ:AhymrRw. 7 8QyhF1`~W7 ?f9.=:3yc/o> v/CQٸ+-Յ߲oek*vT[w1}hIWEhD_Q#9qᕷDžû .` _3u1x1W[> <shò]$FpEޑ-..Z?|ɛ>?8q/ 1"}8s4 <k TJJ
Q5[*Iu! r^^' Bnjڣ9E YkNķ>xٿ5~'mgL
7] ._w=
B
Ė
۱y
,Y
˱o[ qh
ȭ Ĭ jP
Y(e Z p)q!t&nOqamNɣclF,xYD^xIw!.,mI0y@\OGay_"8$7džmܻfk6!f"_{+}%ua HOgj\B UpM(R_S<'ʀYykD7B, oz2}Ϟ&KVCph8 EOqȿro^| EmV|x1 NǑۑQ}!QoE%y? P7}LOROE#&$KHDer;7qs]?;ZUi_6\* ^߂.!a4d.#C{:~;xC>+ұaf,+M됑_>}{*o"__
\0XG&wJbN
fb!q{8юIUk&u^
[QXK|:BVQwIhm7 S
鏿&f^ؾ ҏEFe֮XڱwI>Z;]wwOP5.9'5R+.pGo>J7ARia<qޏqU#( A!]i`m o>7b)}V|jn:4v@dQmqIz E$ ĄH $K{5MΧ9>wM[=)) έZj00'A `ht "`
pB;7o͗܆`х8i^
?_tꝌIpV>uɽ1h\0v05臱o
&
E$Qu*p[D@Y@b/s7c酉۪pr':HS.zDgB9AYܣ<lٲ W]~")%#x?E1:esO FɽLǖ)8P$YvJݔB(l#! VGyW[o[Ǿw$y
5z yږ&!yj{If~uV(?01^>ŻWВ=k8ᑅ˯9r u=c+~rS̑Es-?;bj<+
Y4{#ӗ`CӅ iMף |B0{1{v\7}L + q3Hqi%mU7܌ ZKնgN} : N<4/2 xnq5f9O,l| DSQUf R
x u,+gvjMh )A1q/~*Ů`p:c"z|H߇ .&J] oG{K7VCKw1NV8P-1GwP-p~
Ac'?}ɂoDLR{9x}9tQ
9a2 N6Q!^}ZUV{Q 8I, A p"! :Ceu Upty(r7ZmCS8={GBx=.rLK5l- 8lPLP$2T N
tN >O ra\
r)\dUM燨vMN?~$$-e#Bp 0zZä.<~($ ERQ] _lqT$̗
գάݝh2aNAhd`P7/>zUz
Zc1D;5b=OT(oOb3 Mljpxg ]٧o -)U u 0@Er008.:
6 |3Oڪ>Dz^߉Ucz"}LuuNf*B#H`Et&wGloTzM6ѳLRV}kFŐAwQẾThHv2,mgŨva{RG\HM]RBux{ZJ '2/(;v`hG)'T1dHH HNR4?mHw;b|ȝUIR~Qiʉ'ZM9 A%"`KftzphIgMiiY:*/¦
*zx.)*EY)G2h_YY21
907eV(
Kϩ>z b*,Os#; !8WSo1PVZ[HnQISNWESr62ꯋ
S̊]ϩņ2*quK G6nC#( - '3$Jr:䄅Śˈ
B}Teb'Ɂ<.LߟرU?G)1Z ;QZ3}JP(,M9PFgODf{@uwxa5-B"=| =l2m 5QAjDM(ce)\@_~ KP
Q%*jXcf=Wz<>S(sY1㾋n!~a(K_B wwp)I)dG9ߏ?`( ]_yj$Qr/z5 fީ7PzGTʖcA `8)I<)!>j<F{_9GdukW/=腎[ 5n,9ֱS J# 1ZrWfUxznzDeҙbh:C3h?C=Y2'g.,_4iJj}yv0ƭ'
_t
IK)<!}7R Ix"5ҫ -%ڪxbN[_-X
&H(L>+v'y) j-@<ap NU?)\DLWHp$R/MZSK":Aˇv+#8Ue) <8?Z(>_2V`E7W9+1߁7VcV4 5X @ IDAT s$]=㭇=)gKشr1> ҬEbIEƭk]Ў} +؇SU}t AoE>,uvvY99":ûWNdBBu\tr/ F!6~ͭ|cĚG,T7 :`hǿ|\̺j6/WdoKi w}m"==Mfn A pF [ ZPAԉs:\<7[wmL0
3n y+nRn @
H~~DQ[P(ڬ ӄ]HuQ|F>B'܃{WE XO :S Z ] '~rgcG ifMTVza$hQIvղ-@dvڌZ?17 Ԝɉ6\ze>[obOq/`𮜅 %47?+|j<9mSXPlnFTKm{5x5Ws tO
.[ (Pmw#y^ I20.!t렂. kJFz.Ǜ c҈~8{Oޜ8\0Gkf5d8C,l`yTL[U/:Lo; H/A8?|M-. D$ b
-]y4!кG!.U>5
$f|}&
.7D"gal],@a&}f)x+ >MEV77TAGBiRwE [BMFmX\GgtDsƟNou>~x` ,^2(t:58U%PGtL&g;KO5ٮ ܲlxn5G}װ\Ɲz$ZO~i০52 @KB-,2XAPdxߛ3ӏ!,П" 1}hUjw λ$=#.ETbs=(WS2 x=u?\8
4nפ ֏ʑ?Fxqk$ڥ=Ȱ:1z?7/?
Sv D'5$Ț!?ά5V=Gcrvs-.M2pFgXNd+|6=>mkۢ(rT"jd.D7?ĺ_ _-]$W:txG"oZFڟO J z^nE %VT 58l{9XpK)X9 ޘt- 7{~rz6O \w:Y)b%i.wXt}Pic5G;\~($[- 3L4VɻfNΝÒ
Q"x ,D&xIﾎW Ldw BXxSd zCtPu]ϯ@Ni:ܒ/ yc."+6WīCнUaP='f =b
63_}<VRIu 1_z:$* 3~6hZC phom>&u#6"I DZ$&Kw䖁lXGMA `0 06ȥ Ο? m۶U[zkSD@c^5{EΝ˗/Dž^Luf+K*njG D]*Y4&5>F[J/A.z,~j/ "iV Rb3E+7 1ȋj G\FRR)# {[pIAnn.-c[ Cyq25e\ôCREz YăxmК;&$)$ =9YI6oX{;`OJ'ߛ
:/g ne l[zs)H|Oo4 ^=39f6hɫ4t81SBsaW"..ncر*/-B
|H<#k>'V X572|ȽYC$+L G#|ͭxYl*VT]gX/ӻ|
_qx'dPB-E[KL"{P wɽ# 'X.ԟ AO\t}!߰vQުkK<]uU.TkŌ_/˵
|Y@ k"/H r?gr\QY^}vy睇իW24H[鱎`0 5RJcq u0}MWTx""s5LIPexƮ JeЃ4)zxoS0v;pZ4M
$ju'qm+qR&yVe]oYo"
V %Z+NW[ r~nOX_J㮬$HGnyao l 1
i<zuvaa
'a l֮bMuxma~nǠ"G u9~^W^. ~vV$ _Rm$];Hʉ,Y||G` =sg,dzҠ
<XqB@D)tN :b%;4ȄAyWvYYϣ br:plX /vut{҆V1q mlϼt~_飼ﺭh T0fʰ HZ(2a>N dUM$0|] NRཉ|uvIKq e$zѳX)$]/!8~Ac!2!]bN?yIGrW~?@*|J~ ЁqZ"͵A `0x_sz#'ϠQ>xlkZAggkk;=:%|7UzM;8Fq.Zs 'M
YV{oj6^{ Q4s3ū4-xU9U^n}]~{
D1rIxB/ tBpY<K8JǞ~^ǿ#r]}ty- .R )\$1y-%#21:!+E$JP%7kH\ [
u?6V;l=Ɗ:oy^<5P]2I"Xfxx'w d`!BH%lGY Iuo{C55 'w_tz֞R_q@o@5bKBؿ$HUK .>m9? gO U%٣u)*v7gm/ݗIA Ϻ[1Ɩisf0 Ӌ!&.
xQkNCѳ7l2HG*6ԀfuYYYhݚ*4 ʣ˫<u|}G%&^HgՕ~@WGrz{^{ڎO(W
ϴt<W+**טk>z>y홾k;2Hp]?6N]i o~O ;Oٯ<Wgg9 Abbz^)> Σ~,@-v:Ƴ_Nii>ےSA `0XD59(5W =oey
ɩY]>kO/j]۷K,QZ3 eoLi<u}oLymO+YH1m !ɟQmccJ> <x;wDqqUN)1Ny<ŬTc.IXq;ߔz4噺`\&N-ZT^ y{^Ny+L[ 3QQ@>}pvzQdв8ϣ=>L:>֕3N:7KIc;Ϲ?QZ'?* 2!WC/--U7Yg>GǤϊN:{|8t yo~CA<ưlBIkyjOwC8mTI``i `0 -
:k߾=t}NG@UVj!2EE
H} Qw'#eQ ؔgN4~γ,/<!ꂿ=xnJZls=cy(':ȸ4Q/gN/G{מi^1igޞ: =u]3]N+5) h\iu Ǘ/ni?znJZGKҾ'<k\s=}}ij{G'R|D:~<I3y4V7:%G m&nȕ+WId}NM0 @KAt }|<Y:퉂U:^ E>ǦgN[4 C =ts4 A8Xxc0
A pJhl~F|2== j
,,,TtD dR49%%%
U&t&Rֻ=1 QG+P9fʶ/"Og(dH, Ii/|@\RI 1S3F-yI)y%_dIE!ZTM˗|Bkk, /FbN)rd
hd/ݑ $^IHZ{]|l<J_K|c/|Si /V?ݤDKEK{K[I{ʷ "߳/xilv
QBCm%/H[h}A#Љթ O{;/x]WiCBC}Ac/|pｵ}|ݴol+o<o]hJ_XSڠ}A'n.B]p{_7/4
~7\Jm8p -[ɓ' t& AE#Р ի8 jd%FYke#A)uA "G\3"Kqeo/u"u{ʗk@d%օ/d/
=k, >Jܗ!~gE ,z&|) -ԡ1meo.>%_nȗj+{VxUcm.5\رl|^ˢ'_wmVVq*.`U L/ߵߐ|DJ5|{YNF_lk<;˺]~]X6춪/H9 G;(u5 `0 - ѩS'$%%2ȀUȈ d+A7ؔgVߔgTȗ: R~I^ XWZ"ILDi|IxGI49=K:? ' ~Af
B1 B# 1 ME@Y%A<"_LL"uɫo\iu~RγcSʢe؟q iy}iuN'G WўV7%<#}FLl
gu\}MO;xN:=>/;
)e}6mZ!.M0XF& A#p\n g
CoL?66V9C1-J{ms Bą@eff*'bi#A&WkSDX04'FA `0LDOfFֹhi8˒5ftnZHYbbb>n&͙&D` s4 A\@s[P dfLM^i2v"OVi<{>9Z:Igƞs^bޘ{,|<hŋ?o-mmJG;jzH}V [ѫ>kK~Ɵ
A97 `0 !b:k*G!artq@.DSjNeͺ\3^*6eEmds}"|ʟזc*zwG,HARn/]^K>B /5 .Dϥ
ޔϼk,=nO4SXYH ͩ/Erl )L=' XH:E@h+M}X}}q(՟Jwױڛ;A `0, A7= JEbXt!\$Bhv!/:7lG!.摙*GD!$(dܛϋyW$</ s$ I+l$!/.*dz)3:zi#4w,M;~>>{%,s 2sv FJ yOm-G$Uq'b yK\MxN˰p`.gE/s!8]vTe?VG/uzTq'9Z׳.l3wJGiS Nqi9 A `0\,-|dgBHTD+Z]YՋ /UwPCۯݏDZN15ފ(Lg\ !#n#rZy/o^V S&cÔC{6cΜan >q`2u*^+Q{+|t{=_旕 " }<y8"|1嚿b#FuPdNdH" )-іZ}5AB-ǃ[ר2(*"65uJ'2YPuV\O^`gNHs8v5udgH T} yXxWj.pj"㜔پa^z%|`9˸;ۊ XVXH_ QUVz}n~i|(I =s5ۃ)_;ւ3E1 A ` A l&dY]C`b/ Ui sS2eg :
1{Ee5IzjS{&R<?\k$%?mS1I/Qʦ_u~ z*T4r i:+%夁 ! ~48=bo7T[89 9;҅p\$O
4]..j+**9aźrW .%=)EVw[fBȹ[X[e&Lk|_UTNjV, DӊWꭈ5"GL.ȟKAF̱91s?'"a<_d >_QY% CO0eB,~ڿϿ!d];%!!2[e+_|ă|HCEXJ+7'xA5LUbibe?"%W~UI徻L M A `0L0B.OBvC"cUa!d5h:+3s!N6bŪ5-BDL }Y- {PV^ ? ݻv$!VŢ%uux- W~X rR[R!#ѯ'&adH$S~*-P<x<r= ٘?cQ;,48-phv|yd3R D|Rw 6!$NNہ+Vb}^1dPF )۷aæ-'v鍑C?*sdh~p7[ŴN >
ڷ"yzx># xrD!<Gva !z×p͒a.K_N$DD[XvIM} ~XRУWoJp( C$#v,^Dj9Aѳ[Tg`)BVq<2
Э
)6`kFMl$1 *EޥIO8j!?Rj;0$FMDUCW_V1a:r o1vD2ذ}*I1?:UF`@_ Tb
H 1EھXǶCXjoiҮc7>m2 C[H10 A Pn.,m%i
-WcW|phȜR=&;q]Ð)bd֘+ƐqX[xyn~]oWGB@βv㽯P=k>7_?)tKWo m>WtoȧҞL>'#Q;f`d{::
3Nj &9)vޥz?>2` v} w^=?/}|*mY;)|&u' ޣDBQ/!$8;>~<
Λ4YL (Oǟz ~A]bw=i8~Y~ :8rKx~K];<; ^w=2GaO ѧ _>GI=N1r ,]?.jeRA֠k -DzS-hծ#&\87u뜀6)&\>$ >| o.8o Ò+xNTH dz<ro9)a`(:O 3?[y|K3Ƙ+n:$F( `0 A 2F-lTg1Y& I8sAr. ? O9sA߮;7Ү) !=6k Ljoj'?=qWΘ LBzx[Ps3_{ZjCmfÕ;3;<P*ۂ\/04w="98LJAIX<c<k}( Xh9p͝7qdmX i\EoqO&Y5!4#{1'+= m-`b/$WS1_Ah_|xXa vn3_K, o^92@F-_`pNC\T$^YC
/>
3Vbq$; AEK/aXX|{ y(_sbucغw?W dOl5>gZ\F!y(EWo؊1}[ckbS wŅ*tnɐDZ{,HlHz.w4q2 cڲ_*}"f܂iӦ0
)߿og;/ZcPLPU A `80 n]u!b~.[F{oy- Q\L[+$Q|'|L|C$$4߿{ >IoAQwHP?L<<$3Zn !hݦ5]лk't
د# NQ孻LN,y0F䡴Q!& k *Ν{nHݹA]WRNiIdY]l>cA+FZf ?nQZ]Y O5"ckQ(S\ *< zEvֳcf)ml\30O,-!Y1p~,Sc- N/TKyUeϻvƥXZЯw չVfWq
xBw!%ȹAkͽDkϾ] Qэɣ;7bEصg \2jؕxZu3Y$V:ˑ!߷ c sAKw/ 陵{ `0 A `zis$@s-c :tM}h*BFګҠ*\z%z&%*'hŅA
0Mgě]O7T)n%f\rvFͷY7;h5,W50?THd!őDs 7 rߵںqʮ(v}t ̠
T;WmYїǤ*utF/9 NńqK7 _?n_
;m"}ɧż%н ŇZiU%YM(FW~IŤq e3nLx .pu"gК[ge4OOيow@8_JOt^~qHgxi 0N9sOlJq:Y? -䤍 nQ?ℍYI{{:̸d&
);6W ˏ>G)^}:ZAmjg$@<ir2ޓݓq1
a?#fHLTkТ`41 A p#`a LO-pCqEsjoŋwMp@7
T""2Wè"j<e& H=-נjjoYB]^l'E3+GMQ6o݀ a\3. YE")X'eBɗ}Cc1buOϹuￅ_e;*3\EEl5)!{Gz( Ot%iH:h?Xd)qkǞ7v AEr[u 뮹t0|>yk1rW-~7 |^bе};xA
tuCt@BOK(dhy++.QqhAA(+*%֒NPmieABE5PImRL?K
z :hR :Wh 4Lp>K=h@ DБx//J^BZJ,*sklg%|3+|9:#jtE]z
r
NeEXz
ʭ z A `0<Y]"<+>[&~<S,݆fjMo<st8
fQBt/钱<\}<JG\"2GSm vyCA) ?7 '#jØLEn0ZA;)5ËO=^ys]4}Ы}2
e5Zv|*;H~-ȝc~х3bܶ0^߇m &0U,[.zxxܧF
0p+
oS/~ {w0^0o^k~ =EPG&Kd}>\b;tWM
7] ]zD#GHhejU5gi}d~ -eBRAg Xh?11o}6Lߋjڶ
;_}+}
W pҥ N0chtx#|[
t_>_={~fU}r
5':
A `0Z
\XK;PrTG۶mэq- gpB:F+ָ'JiIMo)#c[1 erݵ$'..F!l@é((*Qf!aልGTX=bCE%T&$Y72ҏQ*[q.2#+7[ bL !! >tj!",XӅHd8`̜\N(poon1 XRzH;ֆX uYȢ4pijԘWTnF eEtdz.RuwGFǢUB *>?-Bi g)e"Z-$ԇRg >CۯABX al-9Yi ,i_^MȽY,# R9HIٯLݼd鑝fn ̌4B"d"#3 ށ!%wnnrI?U-I&qKO@ =˭hZ#; 85oljZV:
!
H**/Epғ{q$3q>E4_w 5YU >N ˩y'&1q.-
@)XLȻaL:aaaC<K+)OFoi䏁|KZвQ53 FFW!=^TT&}+gZs[MMMzem8˪9H %8oj5QsGZ'8&UZ^IyyOqp 8=3/[xg(]{/Ih@^V{9n]֏|zfdLLk}BFe-ޏۇy3j)ubAQ2V[P5̪gaC5~ֺzwKwԺ^ 4*z~=ģTys4'eݳBN9
K Wϸ_Vm:(,y[ q6T{y.ğxKeee1jxEje3iG6ĒԴ5++mjYL`}nlGWö>
a!l;鯲# $E,au &ҚK A2e! '>;` h 4 S1q?ŀ/X$E/BU J^("K!"-ݨp{%8 z%\î %]%yZYyWYeVTX^e:)5ў٥[H KI2% ]?!4ZoޓJQQnɱa RZ[7 i n}q&y[.jKD]/4R& G~?.!oj]tչ O]^NιW(8\SN9 )<rZNٷ]R6)U 9~8ARvAnHZg[ljϚt[Fֶ˒: -[&eT"Cbbla?r" A `hv AovMfЇԠ
1! \ў
#♷{+Erb.|!l_ ik ngj*igio>H4})A `0 ?C z&# nY 5ƥԞdv+XzXHZFF"Rf;5ڧW,e~iZ[ԉӋ `0 Cna$KALF$LY%{Ǔgi;+e\N#syƞ\]tz9֕Vɹϼur2{r$ gOkݱ~u~`18wˡ}=>?29c7;N.y"Q*ԅӘ t&boA `0 sCV?u!CЫW/5kOcL- M섨۷OΝ; M暫tEm1la:מty@'NQ'&&bҥ5$]c0 A%#`zKnlBdYWlA!d{5p*&sdمų9(rByswqfI>
羾.BX@s.3ͽ `0 0 >dL|! ^%:*r gAՙ8HST;ĤZ< 1H'} P?NsO/<|4J]\Vޜ4Q'=I;i =)sR30 A `0~4VDMʅhLupr@XD_wdu8H8ZV4:dFgvrq !kow2rDs.ېFufJz6)Պkۤ -T BBZ*Iƅp-qܦ^?L'zw"t; lܓSr]cKH1 A xdg F"`iw-S0JSȅڻM %z4=,Z킂R qeVN-=k@HQ= ĵ6ww}yx Rn#?Y[.yԪw(z X .*D O\# `0 !gRkvdUWU"7'ť,P12!^W /E4XNʟ& '.>#rӰ~+*[z@bmjR@=^WW[ޯsqXHO3M~j]j.ɕ`;*9(-Pɕ6"$PkWQQrW
2vBVځf?n捋:ya' y:yymɿ@2A `0 ?c!4{ #=]]-xw!fӯ~@_Ygh[,z*ŗ~خ#0w{u;=e-*V~ aAzh
YVUsO^鲼4yOw 144Jkv[OYY":^_I '0 Ç}*鍡cA8w+fA.3(
{uǑ=q8k}JT` 0_GJV9mjU(_ 셈@oub8 :'9gTy$vf Ωf+l0 A4"`g&k@KGlˊx7cƝW`ɼO`L%B+ˑB#ƝĨ0=3VlLA HN:`j+K%E̊wU#?7y=!ĔBi#:UQ)Ǚa6=:zEۯGETWpM?3.7_܌4,\acԩ7r(ڷoFadr lDIX >y<ZŅߢ5Ds%Iw9[5@D3W:qBt{c 8H-z>5'AO/ޞƜ A `8[0%M=NN.؝xeUϿQzyd.܄o@j-up:؟]1wzM1uV.o[҄wg5*!eΛvۑky.:!(IgￃoWmUqq%Ƀ*[pĢ
sr ַN*xMh ͥA=*?qcΰ0nfcص3x" 5< %ѡkGl^CDvaީr_WP3u~lLV rlp ^´..ݟy 9u3A `0 ? C<F9hĝ g1|
t>
}TᣕBY~<ronmw_EN1I^4;۶OAl ='7׆IX0tOG=_o=Lj4V|rl^1Sq33qرzZ[#3Psc" 3PCظm>)G`هܙp/g?bQVX*a7^
gwÓY<lK ?63
~ `0 C6;YMk v 3ˋ"|xٿdϷ-RSܴ/~xJ9 iK͚}x7rK I()w"bOqgHiOߚ|:OsW&bxʷCT >zS{#0qW;҃rqGZƭLVk @/p#(Me-Q೧?ůz 7m-I置tjIlI^甓8 rZ
.'FFA `0 #`z13Ohi
+stneJh<]# ܺo_?>Ԧq4š\DT$|ײmQYWr @ IDAT2> פoն nEQA!+0y02I *u=Nig BI 4\Ag~}5S' EL^ů` "}i1Ѷp?a.j~@˳_8j}5/y \b с5]H ͼ q?se0 ٍ!gwڝ4CBBmVt_ C?Oχ_o3FRl2mb/zZw \?!ŭD} $~(LYL.vvܬ ~p=,>\{.Tr tu<<\ 2btyGƮUxwV#Ub/s!yHtlM 'r33iNhk7A*烔܁A.b op\ޝ} -t@:[_Ȫ$T01 `0 _y my धZt '_]۪
)Tw3}g}L>ĪmpR[wAj ՙGI(8noRŶƤ+.o z f 5e+:d0%DcxO7aw?d[pɷ5fՖ3Wm+x}}2{A j?< . ~, {A혈VI[,GVN \HEȽ1:t>'MUӿ,n78K`}
b xgE sQchRK{2 A `0]
՞6͆h-f aND%{OMC"1G9@Dx}"< T}xAL x\{ K߃g;|q$уӯ#} w2m&>p2;bf>y/.|ўn }ݲ˚
)Xؐ< +x}}2ZlWWg Cd$<-.5f^MK%m;bU y\Hw@ɵħ*¦ޟK / ¼< pכ2TM dA `0 AQv rh۶-u4H}`<͌O-\y FUl}ٖ5. UtlXw>|TT("kHHHl|$ @nrƷN=%oLi:uRS~MW%# a4=m5$\xMy)0 ){w6!v#*@GXFQ1pڨR8%X\\֮; ]t ;
qi#1zK]Ni{8ty {Qke֭[@oݺAnnn.͈(ERRRЩ3hc q(z;j1q~L=׃C.=aH "..N B8o<8NK8M$! @zHXm6DЋ!Rr8C1\LGE+8'""5J' R=4ڶWO=iڔ tg[T4?n'33?pę觚lT\:$:>N3+Tx)}y8Գ(!_z0V5/ΩR B@! D@|
(cY0af
ƻsBN 73HtY e/^ק3s 511QiMMtFsd5y6b Nr6tJLJMW:m ?Z6"3_ MjB@! @p &V# i|E֦WOΣCui7*UUXX> bqhwf\.o2KB@! ~ؑ`o%`\~I|vu9s xz>v0դ]UoMX;u»uUHu1m6 (B@4
"0N'Yl\Ry*y* $KG{۶mJhkz98c[γ<D͕ 6oެ
Óc+5 ! C@zUT~x7!k ,iZ*^W| @/O9%KUqT-B@% =`aƞ.] &&Ff/W5Eg7p ^~xpl ձw39 '*B@' I$s:)hA"%&vygy]/v 3C eḻ!NE3woA4 ! xz볤 ! BFTȬʘU qʃ^y~~V:Ol$t~< ty v~x)!-pma
3
Z.B@! ~K " #`~7՜v:j2Mɞ]*OoMQu! :JIgE=Hkt ']/> hC\1[MZT4\B@! hBfWBQӟYp:5_keo韽:x}_,kc[zm*@q˙@8U<^7PDvb_]C7ɂ5ҋIPR VT?h_{P$J! hă`V:VX`(AN"i-؞
'~:kA퐚Z+q˒S^]z\W4Ҋ|r9Trzd __,"訰-pDƣY$Xh0tVcDY>!Yiv%7Gr|fe`ˎL$EF{iZ{> sς_
A]pb6? D<={Py* ! B@RؗOW</ 6 ؙeܧ^ /_:X,|3D8ihF.FdоkA
sWm"fLP?~C?>$y09^ r'mdz<(J_z[ Dٗ_SUߋ00/By% np ه1,U==Ï+yٳ$2yB@! "냺 0_oCBGFy` $lh<\N߉qٓ
dދih$Q {vZbbȀ-,MSOZ]GpI.|7 V-.ˑSC"5Auavf$G(ٌ{NqS>FGa/Sܛ ߱ǠIlaE ڃ_><u3yӿ%/z6y{zA"IB@! hTD7K
aNzQ$:aj sh>Nb\>E8#O q;FvK_;Ly
p~1q/Cg_S\.AR b]a(ܛIFu}/vnm { %quؾjz?C됝7 ]~71} hڡ[Љe겠k$0' t eAv1pO~4/MÂe4w~P̳>퐶B@!PD'}ipc+w ;hl@ȵරDg{['b7A{_)'D+ ۖ1B.|^ 6 |hGg¨ #lQ)[o~Xyu1 $Gzux앗>9{|d$ًyԅ3qn}?N91c]ݽq1 {IE$E9#3U`;h7O2."Y{H9hhy)`Цr CB@! @}^KK#F"{JKQ"!*wND3[顗1+A'bXr#$
.s2ڴHQ|οDӿaOn?qمg"μ6v7%Uɯ f!^=;x;+݆ 9) 4 4U#qBf́A"M_O<|g
F!֟9j3֜~[xᴾ<̤
I+/ B@N@zC a_(-)ưCqckMѭs;ֲM{$Ӛr#x9 '͙Ǔ{i0>:q}{VwS
_Rd,&֜69ѼH`Ƭev_S㰝fY{Bx0"\r+VGSn Mg gӮtW
fq{O Y0:
$tZ}\JB@!
"k Xi9=go%G7jtxvgХ}F4[OD!:: I[6u5Gu5`W"8CˍV[H,^Z㑜MܰCN]4 {~LsxOXǡxFb3mlw(&j{~8 ?{2%) ^яg,֤ kq! B@._!P <B7FtL#eÄAe7 7/L7 BbXq7z4 CӅ'_7b('_!ٛv{<+!KzYW3.J[[8i:{/.Nkf)qTM }%lܼ ƣcvp؞v5;m b7`-EQ ΈhD:?i6{$+B;M䌕CӁijMc˦S>>/] dFB@! @^?ܥM ǿYmc[--W vS1'_t
{vFiJ
qhaͳYcؠX.N e3dyCz3 f^۵1y|&;/5`uJ<.g Dǚ5tb,ҷhٶcu s[V P#H;]4;-5^ ͺ84S5TW# ! B@'l#P!0~t7Sb/,&^q߉l}M~K
ĂӱCTiEpEqaaIIƑc:.i?_ٳ4A
iճqӨڣ,- | yȷqs 1QLIuxl%! Bؿ:' IY$ڢ#M⼲sAHC7}]b]ؾ}; yg+~ ;xXJwr;6%$£~+VDF/Pm *Կ`@<SB@! @C& !ns`PfU͢u? seiӡqbćYq>Wo "'$$_EOeEEELcăcSʦBy<GB. >rVjtt< byC]^Q~e(Bj<2Fe* 6LدHmFh괂26;(u ! BDWdY,r8ކWDbʱǗ n{t{ =AJfQ)|u( ! B @1ir>Z?<ړb{ ,rhC=+I 8p -ι'<rn!
;3{ҥjpAA?ĵ(;sSյ_<Sk<TJ7e>T9J lYGEEaȀi B@! h,D7~մ4t,@%`qXtd&-Gmw|^ӦMc5G_ B@" =+]8{bbb?ҁ%0݆!ckYs8욀1\ B@! @
^ z
: /uXKF@@ 2nZdp
AΞu
>Ź^6Ȍ5! BHj
㻆7 ړxy
0~>85Q ! F3ԍ f4HՇSPjMɚcaaajy@lxlW! 5N@z#
<sP Qŵu)~ z(ky:<}nD:wx o)ќ{N b[b9ϒgiT! O@zXP X,Xh͚FwVUe[ {̶P6x(3Pe*:;jE # Ÿ:^r^2lg{L&y<RN! K@z@xJ֝ KK=hު
#'}, 7%.=>`h55!W\ ʐP'iMr\+{j{X'|T9mҵׅ?|, ƍ9 /X XnO?vsf{˓a%~"8doDE!ե7m>f-11qF:A{7 c}'6en_>B@! A4 &k<{k y ܳWuBBbǟTXw<(iJԕ:?IaUF'Wb
"?2;(/
8א_|fYǏ8 JnJ(MmZMRQN,^gq!) > r]>*NLm߸}گf=̹[aƝpOxg> ޯ&B@! C@zXR%* ;nGVM-u!++ عmV\]{I`ej\[(p*i\˗a+Tb!7'{^ع# vV^x-=%@Q vaXz5V^,ebch&cQDe
Ξtw&ށ'}<lX[ ܶ#7;+-WD/34W^lXk֮ WWº
go>>?BSp/`yK9!7]oaa!؋^ Ẑ-kS݈gM-*˲ߧDaٵ<:
i )!A! B@2 ȣ# !û*4<z$#<<\݉ Casד?Eϳo= |;,Yg xG<| v[^Wl'<h4!>bƜݮ 6܉k zCQm_4 7<!ym8v/e#j!) p}wcPJ4z 9I}:cA: yݷ_/#1̋N]:a?uHr"ZL1os1okO+f eUx<1-;; LLj=m7]nT
^)\m #+/-{# |7K\]{Rw[n6:Cf$! B@$ =0E:*,h
)]9s% "SwQ}Տp#qEwcc
HKN͓g Q}.c:!Żݩ?oO'ǝ0 &='l $n%8ϑЩ&Ԓ~\:ŻO] nEkuPa)ffbwX4KY珟㶷{`2:BTb fo7_>W Wy(|k\{z/as5@Y Yw"p7Z&9z 2v! Pvp\ O$/ kK;˗]Z)B"Ч@o XB B@! @@ "F
?HjUF
͖4^pڧ5fR1ڛjd˴44OG g.['
_+p1OՏ~ _ ޥ8p]D6|w[,.-\b6gEX&'zp+W[ `wV!:i0ӿ8`{uj6!!& ~ߎWc{PbݺX!KOMUc016?T_Gh iVzytfu t>jM.\p(ol1 vO! B@ ' k|ļ#`e)ZߥnQ1 0[4=s.!M;b7v0fg`֝>z{[)_Qaβ=Ȍ 1ob,^NF > M{>r|aҭ+uM\ogHrm='a֩`#נq0I×qЎzuX~Z7g /%w`˶]}ӸNi (>SEΡxжUs<ؕW9 `yCmg4Oo7Oq69 vg(ynbZc *ī{ m]! B@ /K!!
C|R4Ì5l34pJǰ9@ڙ<<a>.&
W,}ݏuƚrN(V; 5FS,A
Oh./4b-+ ASv?} 7N8IZs G]>:if5i >l/'_:iG}6 ?b<bdmv? P=ݏ; ;6QmkC>V)֬ Rct:v.Et6'ҹc =D^.G ࣺRjEuUOKmW@[mᏘގi LX+
! B@# I#bvo~OV,a*N2ػ' Klj5Iw @W w9xA= M}mSO Q(KfJ`sy<ź%7S doNnC N6ݾ
.]/~F{h'ӖOÛSYl:|<#<0v6\rYQ?ЫY
u;b|H~Gs.9?n~OcX<w" bhm4R+֚o^E($$V)ckM/IǞ m86z
5S4SQx;2f
$! B@@& =GGl;|&n^n6|mU :2,&& w: mӞYY 3d,Rʻܺ[2/n+oG\Rk67VG tfl:=ўrl~nHj }ЦY-4
I0e8O?Lhl1@?$9(kyG4]z
{cѵbD h[ hv=>2 = ƝvpmϢiiv ,)oN8ʻ٤+9>i{s⛟`ݲǓ^@4c:h }C/Es<sQFJW ְXv6v/l,B)+) B@! B XG-v-1G/hѢ:v~jVyf `N͘1M4AN osjTY,[
WW1Ji7rA~*ǛzMD_;d(G߅g?$RE Et^bCD1 w^\v9 inZ;jMѕQ*8hc8 N ~KN1ijxZ~58={vv㏏/2S$D3Mr3ymZyݒew ڵKmٳ1h iVFQ ~qy<z fIB@!P{LdkY5-C%fqZm/z
4K4JUV,G"r@~0qn*6l Št:Mfq)/$8%t6X\hM~TT:nė(qa(a^uF~a=,E 3cǽ$V! B@?^c ,ڴ& 3ƍZivĆ(o9kU j6b|EYs7y\
܆V˛JԶx?ӰuwZ lkx $U%vtcI2*!uYկהEROmX>ў)B@@' =GH;b_ s%,vA bSDU\rYS5jW}[ *j> ?p qI2RX L n.]UZU6@6cT g[% i*hh(< Oc{t-K&cKKKիۗB@!hDڈ4{ 㮚Akū:>% '~vj"""gM׳Hg;]V o7_ -s p3an 8u N^s{ks<< UpgF\ ! B9кh;k h6=Z8եM,]ox8
l
װXz'B@ Z ӕ7lؠvkfOZ d1+z F~bxρ[qP tB@!D4\X`1J. "P U{\:{"؎
Q汩1(}JCyxwC%! AH@zZ0?{6⍿$ Tc啴AIG feexB@!X@o,# @dŁ7/Y
L^!-uzS@פMbB@! 3" 4 |8;?E~k$999Q^@Cݍfpcxy|Y | ܽ녀B@!ph"Hr0V5 0 tfs}&b,%4,<0FB@! ;@ nW`۰6uAUi X{uJ >(YrP<(B@4Ao$ݘY@`U-XV@\5l}ku-܍ӟ⽡qCNO~IB@! @c' A})^a/ ղW
QG>('Y> kTUZz[
gѰssNJ`wnxm]p}}7WmP Zy[̀Y Bm* ' qp>*B@DW&"
5kJY'>[x ZĦ1lIڶtE+@K-ʢ\Su&AIJ |>0+_Ǡ}$olaA{2㹗YW]i'JJd+|T??,02|Qvu\A7Ta22ጌELdei/B@! B `%dl\|{ǐzirsfyeġ A q4NpTYЂw.U:Q8kCl{N%ס ΰ( 0q,LI<8 rMi~z@ ́.sR7Jm)a_٤bjCً^9 |Hi3n,Ϣ˖GȅB@! A3 /
#FBJzwv |}HK ~;sKa In3f'N^^4 4{\MqoVHߴ} e瓠w`Q67laTf]n4o :͓߃ٿLǼ%H@E{N0%qS@) O_ _!cL :
ǴżТ9vmXLw8
@<\oӿ%k]>ǐa_uF!ʥ ÎGRTJ
üEd[ }#"57dIv>O 1 Cz'[ZP}=ܠ
~, ο/߈ %%xq~Q )B@! B =IL<:~]J k%+͇ZrsW }A $F ' oV,[ٙx0#F@Y%_v`L8l pz1ɸOapl', eUJ Opnnt@q~^ 3ZǍ=Ec)+O<v]Eh\{a2?u ~Ewjw=v| |ӷ_;/ĈS-g?Qs:ƍ w|ErygͿi/Bqqqy=hw <}8^$Ѝ
B! B@!᠉ɇGj%gDHü.Dv+u9vge oVB1)ЬSq]0x < ;W'> |:^@!9u8a@_GX13p ⢱a?H;3 64v<T yyjÀA'Бgⴡ Uͫ۫>~M9bwGxA9W^?V]T6,.oc^;vHĖEӎ +qmO`7pl@I<z ޞ#
hu}x{$<d2Py}j!yV$SK ́=Y5 vJ! B@'l (sK 0 _~?D[JD,yp:4Ŷ5/`iztʿUϓi m
ן 1јphڦ&(.; r& 7^|ZGkAѮ7QX⁋_s@fg'q9+f`H߾8̳iZ| =zxiiZ^.))ڥS=9r99\t('2h.W12K0>Jsl
(AMz Yp,ȏZR>Jc~(qeֺE{ӹm xhg zfb+gS! B@#8jbsyy"?*<ch
BLn?
]'9mJ 6=Ͼsތm[6'nŒ-Yx㉛p
a賰c8e"./S 8
U猀ģN텆,_-݁bҹ7?58i6 Qj~|ǭb7og%3;g+pn큗hʼB.c:=R]EJ7O; :5C!aJԝV *x 5~UXɻKB@! N\aNJZ DglTYuv;/ܛM L9'lw Ӧikֱ; NE=شq ̚|p7 ?_Kh<z:LCB[awf;zлq=z4Y{h1|Yл8.ZUkר
i9wA.y
YE*ji~}i ϼ֬߈?Ṁ:#qӄKzBKP%6mS[ǯ,dglƲ<.O籫Fp8z~m@ cB! B@ ݐK EiM6 #fѴhG Fq &
.mRr|3UAia6N4 g\z-Ӯ"7
ڦgcDVX`)ޛt+Z6OAƵc~1?/ųpֵ{.:ϽbĠn;&|)8v ;pߣOa`(n8[#㱯^IC.8j-]G-j÷&Iԧ[/Ű`@x㳙ӣ=įB$#w(;?o)^N>}2*X
$Be^! B@
КAE[_~A-бcGTW+!phԌ3ФItI e 5 ^bVMHHJvS(`o۴ [ҳܤi4V%&F;܉]p,&[e ؙ͇'7CV-`/SR͛6aO^£bдi3D`g/ty6mKGjj?MgaiZєQNٓDЮ xf@Vv6"b؛twÄ^4N7!6çxϢiqz~.lڼ
%D4#Ü6o檌=4cGi<Èx9c )u^#Rqe vR0{l 4qqqjiHK@ܼyԲ^z 'i! 4A{j KqG/ZVhQoخ1 }y9`):qszѮ̑TOh]9к}'6M ۡMpcΏS圍8~@o=&Ӻoe_^D [Q: <4x@ʣѝ^]O,՜8(8^ϏbCuͱ gxbB@! j"+-x4 N*$PY(X;+ z\@y4J:h6Uyśn"f+s]#,4;]OamH: ?_s:JQ#cCf
ҹfq}}dϊ/mEkM"i{x3.'֎%Rkmc㩯k=[! N@zw_n" a yj: Ċxz:u).++KsS U<UUQqE7'TN* }~ PAOHHP<%>7&[ !B@! @Us?(P (@U`e_r~C YiO-jWKM_h{CXX`!WTTm{3"Azk F! AC@z U1T.?j͵u{skn k1g!""BÆ@W8:h 4IDAT,cn%A!
j^} 7>B+0U'GF@{OY@gA?#cȥxCCC#nM! 5I@zMҔI/_ k~
s>-7kԡztSN Ѣ\] Z}zt ǟ:?AC2t}܁vlذAsB]6{)e <pz)=B@! @?8 Ia<cǎHNNVӕу^H`VSSSSעkab ]xxz ! B@46"ۈsY,- B`@w:&i
@\\zx 8 eB@! @/G!uAlR\<uA=Ђ 'jl&6<թ:yjx P}bWmoM,u! B6 @MR~G|-?C# 9gIIIJ7zP
t^¢<++K>
! B@Tj
*?02x:t-!&i 6tn뭍~U^sY({,C' c$ ! uC@zpV
} B Z SW^E2ErT|h;s͌t;t=ِdW<v,y z5HB@! @=^ -z LñH0!{+<|: WU*UWeJmnm QVe{ t%o5O(\OuTFnuz
:o,AMVr5bTRgxYҐB@! 1 hq{&lؚψyK:ѡsWGG< y_ V{<8aHxѥHDLJ@^^^k !Ey(.":&6k,,"] q{IJ^_y}~DYj=6j pY~Zd 1CzQFm;oؿo>Is;}r'B@! B`Ag?
|1u3e*g,!$T
ku6d [7.Ì($0疗as_q'iYxwPb3./C>[W/ VkXmkq6|A YGk%z)cq!6R;b,llUNe7faaɽrJ{{t<7<=k9W.'B@! B =GGl1ڍϺ" pҴnv yy6`9мU4K';BйĶ,Jm^p
a.Æ
_h4oXw~6D,/ 5*
͚[BvlߑDt p"<( |lX 9%!{hX8SRn6m(Z $I{J
ndf#6) ۷CʽF 5^wعƜ5s{<{TGZ ʰJ tX:g\zճxQ<0^8Ms)X$! B@" 1.fbJX_ '$D; v~7 A,ݘڸO4)V|ևgedWA{wo߈Y?Vc/=$43>#/ƺU? P^x]I tڍ+
?Nz;u NE){מĭ?g;Bj@Q<pŸ·]^LSϻ|6ثP_ iۍ&^*9lxc+5>ڇ`GD sS^]\>B@! @ z V S ߉[rn;0p5`$f1 a܌{OcƢ{(%/M;psڑi).~|2
{vӂoRQOwOi 2WGF(DG9(]w+coSjg lpc֢ح5- _4o@A"! N禱/q;qL5 ]ÏG0lnZ47\{[ h
`[z:6QH}<@?0ҳ淿~-if*Njd-#I`.B@! 6F%
FNA<M+/(F-X2&LSKe7ĘC'^a4ͪ:u*hE{ E d)ً@Sۛ5kXχw .o" ?ZyZyJb,4-~m ^
A-0fPS:7ڊݙ?c\4
8nej*+оe -CYQk(=hڋ/DN)~
Fֱؕg>譫pHQF\n+i>2.-+"xKυB@$ >K@d`qpc0Yˏ݄'FU 9 r Bi{D$[_|IoO\|r*ӵEӶ#yQ>pɻr3yGyߋx1#)
Ztc56sзs[z 3ZPg!
hC:fMLb/+m<ذO<Sฮi*P ! B@@&`@Pl5L 2{PTDq
I xx0ѳ'R#86VGڄ
5[} O
nyd+]Eu:3|G6
'M%?"UbӺi^b1?[}%{j-V:v́03n F ~=5_+pDžB$FSޕmu$U' ضov րf̙q{V8fJZ! B@(YGUoe5N q a9Տ䤳1.m} %-$n*.yڼw}Ag͞w6M7%ׯgӴ4̛|)Z1#1qW> v
<LzFSco_4 FHd*{] ?Tl\| %۸!'' pչcwJ|9c1z4
_|9n~hj=ZgKKpYRŎ4Xy5 .r{K/#>9kDNY S\
! B@% =`F I,ŵCSߓnn|8Ƿ/ B߾##UGMx 4<k5A|| J,^?ms1rp:3k+Zoӭ?=f.V:;[[Q8 gͻbXh I78=6eO:[ @6ih%tL в ޛ
/vڭ.FhX1mhBxg9jtOyiateM"8uf{Y: xt>@1 g V̄XB@! GO@3 5kЁ], z;v[?mWY%$Ǟ|Q ;B Zmr.kWa cܰQ>?ڕdض[?(ƚu[фv⇏>3#Қ' ["} }A͘~˿U6iN_NӱppGSrJSUZ)3.9`-h&>UZ]){OAA'&} ,)Q/D9:G.
! AN@+ /GTdx[hZy.V{nBE/s+ܜSlHY;!g?}>ښ0i 1l vmی> 8hHln~voLM6v7sbDDFF,˚|}w,KOO;m! B@ 2Rbg0!̕4| ,u7DU8
s#
$E̪La(9BLrsݛ7O[OJB8Vr ԯ D9iS:xWv՛6Z'k |ѱqj{lUV'A[XXH{O61}&q4Ad*B@Z" JK@,ifq4~_aiJ'VC-Teet[Z:#B/ 8
Z ^[aU.:auu텇;^kGb s6g`i||ǭrm N)cc>P;ɣVy)-! B@4v"7@ ̂\Hdi 8<,^ |3Ej6Ul.Kyй@XX!Wm|AQoAa)B@& Ju&`+|M BYV.JP5Uϡ9XZ&..`E%qҬ B@! hD7Q>z+W"Q"q0ij7oV^s<<S oTTL:
Yx@uIv! B@%=;)(B@!P*1Ϣvn! B@ڈ4p{+ڥKĨWt( TgsЏ:) ڵkMdD (B@5R*. /^]j'dE-**RSYǜ EGGq]BB@!@@o Lݐ4Zkyboogp}Ңfuivk^:y*{]N < ! 2O!$pcsكΞsTExDD"#+. c[RRr\,B@O@z ca-[^ 9[N4W ٕ GVUXkf:8}, =(#D
! BހSR?~[!Y+(xm%=}][fZQ|<=!!6k Z^B@! @#
tn ᢵѴ BD>o)K
f- w1s(ene!F nVtoi=s(˃ ؘxnqPkOgj
Aj8CҤB@! 61 trXnL]d.T9;'+G(klUt{hs&ӶXFiZ-g;M<`
nL8ZT}]
.B@! + B@ .c:`/6Wle'wypgFn՚Щ@d<^|\x
~ٞʱV5n}^,$?$( Zɕ]
7pwqB@! BI!P>gTpxTRp wGؤ6$.V&tNq"&>t3"յn}LVJl\7f/؊gH's2ԯu8m
Vﲢy?7N;,ćyU`^bC{n>GOR! B@!pL K ! :<2 S}o} Sv[[Q s>ZKĹ)'!!lr~xoP6<奅yWcSVBe0h֪ " ~,k:ޛ'm
`
ڃnZ/ B@! B1zceciR6O^ijw"kRj3ևgyﱵCLluX[Ni8vw7)jGhvoJ;[H =a㟬54g ~:G9([ɱejuWsZ]ҒB@! "뇻P.؛ zs%BFjs7GGQ5 qcgrKwX R &k/8}
N]RiyY [7|$! B@@@7Q><|A8
V]yyy9C _M ;jS; $ܕN4uFi'1;Rw X7 lww nB@! BZDW dpW r . + n>/<'ظe;2wbYh.r'C\l2~e̜ ;hmgx9JsziIJ<j
=s(-u!ݠ<t|QQAyB@!
Lqo,ݫ%M^h'm vg= m}NŜ ?O?߾ ðzj 9bJWFcnA✑1 <cΜpaZdl34V7 "2%m)K]uex1U! B@ !GN5n<NxV17&5!P u&> p"vΆ֦G!9)6#YNsk{D<.^ 9BahLBmFM'Q
jǟrB,ܢwS%M(((PkbmkjBH! L)L1M"NH'ccz: 81D:`u\9+ x RlGXD nN*#22r f?+bA1σ jIB@! @P &Fc6- : /=ݨb1&u]\r ֠9@{!|~'<:;% B@! Q~{<8z/^s)n$JRцP'H PJ@RH 4R)"!DP U"!PE)A@ {]yw23g>9{#ϼ̙wg " Eֲpy8&L;ɴzŭe}+Wi~^Ncu6277O}%}9c@ @`#
A߈{I xF hm/uUUOp Ŀɓ'+X^>7: \ +Ztc--45Zb:>lwW0 l`zHx
H|ETWG.q-n 8־w[Ԡ rι[
&@ @JvÓ#ݚՌheD!o7zkf,rSj VT^OW.5^k^ON q裶踳F9%j/^ ko_okkٚj6T
mց P. t Y'ޙ*ʉa ݻwǷ-N4(:bZ52k[$ԥ+\5ήja]4 I [ˆe4]v:U2~Kڶ>k)Hurri"P\@mݑ}9c@ jM Ç'T[n5:
4DJѠ)=WW>Gyu,,tʩn{ևԪ)CU0bx]H|E1/7 뻒YOmmU'/#/_'IˬW߷Ykn
ڍ
ۍ&y[S/KFq9VZoSWji&dP$iU ߷~2J߷V^WA㻻Cվj踣V˔q} n0~*o[W:,T ?r_ѾJmZެ}JK}ik_%kqAy-vA ?|ߺBZ|?7W ڷU%k'?oJ ߷Eg}'s_
讌!۵k(@ iN2FGG;~8/-:qև>wv
xx y=I :Rl<dK y_ԉU^|V[1u ΥD:UAƊ[UWYu6h[k[C2Qy)4 nn̊mRiu""]Tϴj ^9r<+*N*NzN01ڂ+b{p_y)R]_vڶB4xg8ۚl ʟIKd|o [v*n(~O -q'_-h݊+m߷Eښ iJ}[-im-U^[Hˉ_-1o^ gB1\uҺUǢp#j ý]1jW~Ja|?sVsYi;ur-~< Ԣ@Saw4 \ ;vulJKN8a|ϟ48Liy<cdrmS^ZA4.ˊuMX=@ "~lJ;&-i<>Ǡ؞c%K-WzrߎaLV̬YˋԺ<F/\暬Or>Y>Lp}m}y>=pR <y Ԃ@tUPW14 dYqƔ?aU?mYӓxiyXE=FZpY|i ˦-KI{pyִi^h9ծ(ꪦjMuLWkuBP~qrK<i2+5ﱓ|eᴗI鴼ZǗ8/t'ˇ=-\N.1֏[mb @1Jv6X>$WY݆۫u[˃[MV_s jyoQ7*# tTfmDE @<%;Յ.ꉂ ﲪm۶ J /R_:W*U\@`x. J^ O $l 1
r̥'$_ʗ e
WMzs ^^is1׃@ @ z PWWϳ@)iPr~쌍厺 ;q ]\o۩/<D zz^^e:x럼tΜ \sYQi`@ @ @ J^A @~e:\r<(/oӾoeZŇ 7'zФJDWӣqiξ_ZC {o_yeޜ/<gG/u zNk7NxuL# P/\A=E=5w>_ }kmԞoؙ6=m>lo_jv"d[:y {.ME:zNEq4\u{^ko>m}J_ q6 P\AF+3vutlΞc;{
O{ux~ٿ}'~6zϠ }UOG/ء)ѿŚڷ;y-;9kO>)k^W[M?ƽ~xmj.Gm ԩ WtQm-~;^w^|ؾGw {~iXkeю };ʭ 8773in;}_^yN_'~Q{_g>ݸxt<J}jn~{OGwΗs8v`}
zy=H:Zm<}ޏ[o
Wtt}v_f7ngњ[lvk.r/6 z;mCwluom=6?1ۺz- v@uwuZOm닽M7lc@ @ FQ4ۉ@îN+g5?>o<jotЎ=e'yً'oyzc8Sc695-'Ҧ<ojnw'flΝ@ @ [+=&>?Ž˾.;ewz=_ w >e_rm_?o?[QG|?g7t/ڛ.gy?l Ka?sodSs0?ckGc'?QlݴRua \@StΣ`~ ;vخ]V-uR @͛uI3ϣ>v؞?4cf ζ]}uob;oѦǎSvİ]\h ^i+mͷUݛ ծ׆lm6ggm7/O={u AW/]zoo/ǰX?4@x|:pcDh "@^D` AĵO|rUQ}tQ"<ؘXwww8?q@`c @ A/D.R@'Z[[b{泳|Dp:N, +Ta 0tՌ@ @ z;#,%5]ݑꊯJ{;> ^R/߄+YVϭ,Μףi#arr'E
^ $ tyzjY; ĝ .CzvW3 P/kV/N=@_~w\/ |iOq^繒qV|-g@ @ @^r;j淅^6z"@B8\s^Z2gZ~9 ԯ ǂw h4܇-.gmP@ @~~ 5G I
~V瞳ao$@ X@ rBÑ#GlϞ=+[Ň
&@ jL] O!|ܹ*iaܴd Cy5<qZ0OZzڲO;8-vڲL8d.K .u%в|8eYy=//2+4
yazdx^fQz/4V$Ӕ߇:|^^& Ji ˒aO2
iu)ezqNJN{\-ukg-3k ǪOe|Y 둬&\ #964N:ۡ+<H˗kܞ05I˚X4'3\+xӦM#+<4 "AVv@ @ rpnSEb TR ws%WNl@ @Zkb_z @ \ |9SyƍF>Z?F[sZZܴe^mk-),C @ w2oq' S PiܟYʉ ti Ԁ T@ @ @ :@ @ @ j@ )z, G r;yS5 ŝv @
nk+ 2k`oQ@ @ @ Pzqq1gٳn馸pcAggg:::laa!Lb@ @ @ J# Sǹ:Jh2f> nnnn_b$# @ښD= PV[s.C @ @ @nov
6 ۈ @jI @ @ @ r @WK #@=$@ @ @ %@ZҬ@ @ @ :98$! P-:Ւf= A! @ @ @ j A4A @ @ @ GzI TKzY 9tspHB @ @ @ZtЫ%z@ @ @ C ^-iփ @ @ @ @ jI @ @ @ r @WK #@=$@ @ @ %@ZҬ@ @ @ :98$! P-:Ւf= A! @ @ @ j A4A @ @ @ GzI TKzY 9/夓 XRa
#%G/Y" @ @ @ 2 v1!zi=B`@ @ @ @
q<ZO7oZZZhIW TVj lnjjWMD磗5p%}ف [ꃫ/Їu IENDB` httpd-2.4.64/docs/manual/images/feather.gif 0000664 0001751 0001751 00000007110 12657415644 020416 0 ustar covener covener GIF89a F !6q$ﬓl-d*Ij( @Yo UR-䏙XR#K.y QYġ{)~:1%sۮ.c"6Դ[Zx&j$wf諷ť ]̕^+ :u' >&vgx+(d'xF/ Br'ڏ?0X,42ռ FӭN\ڂ Y2ܝ J Mo H7 O D%5q坧-3?@ <#jMv 7<[(4C좘%({K+zonlGhB03{̯ϛ_/D$pn(8|=P5ˠyw<k.S! , F qttq q f((fq͵ ((א __i$C[ 47nB/i CBB hC
.ǰ'=HE1p <B:CbJ@"h"
z2#QP i9-]!̚7oZ0ϫ{JuΎ F K6Wvq0tҥ̪^Je2 )v$pN(YxcPLH
iv
|"O6 Lb瘝 +y Y
qh#5m@:NU|>#م͘ȿ+X% fBϕM.
$EĀŁu m፧nz@ZDPQg%'gOp `)1x z `y7A q
!}"wrSae")Řch#ȣxXFF hp!]=i D<~\i Py%'P4` xnsYg $T}>YeQ&~Box [D
Hdi
vZ[rj
$ jߓn@BDZk(k *0cˢA릨jm+$ B a!>ADB4r""j@n )4 [od2cũ
}5߂+('flvL
PTW |\ ')3k:H3AK!@`15t$Pa^H!ՄS/ ]]f9:lj_
Y̵L ]x7%Mq
@7rl39sirxtTPZ!/\`1ц??dߺ ]82G+y 'dn )=/VoI /|
B3X>sŠo8 [G@jT0lW
t$on=|l@>0"q apqфՑ'Z
o8m<0,X*#Tpgy4&ԇr ! a !A:>X ` X:EWS
}$,X 7b pRu 8(AYC"2_ÝZؠBP2$y G/Ѓ(JNsc @$)OYT|%p@<!H~1| Ea hH!D-$"rEh5R L*JrS
p NE_Xy3.
'I0[{%DCBw:bs}(*%
=sh-m9\V
̛$e̬~h&~&BӶ?
*79Q2= TL_-|#J ! )ا $ t;攳?ah:<A :uk[}mwl++ `Hʓ@ ,Ikdב B!2 ڠ-@DVմtc]`ťSY[Fn ~o-lKJ ʹ Y݀r| &tSjSE-+{f4h;?J92 Ksm g e \P.6@ X 0{j͟ nj*NA
=rFmy˓)rY"n0|?lZh{?hHM] 06i bEq S+ . Vb"
/ HhS 1[WsT Y+NBuGE*.<Z%0%b y ._z ^4 1(QӼ[͙k9*RfA R?Lm}^Op @>f4y_8αZiK͙nx9=!kMvMXDKDRcIE?4 Zq\[ 浌Gn3;E|;qNecN
5肒T TvSj:O37U[']_ :`3RTw^D@дWG::q'VvEdC
(?Y,p4 <ev[ \u9b5 ȵWq?܋]K?=x: @|".CV^ V+3 dpUV }t6o,D`GD䘆zPClG,,fb~SyyyP' Ir |EFχduRpG$}.L ehl' qyyu'M~awx ;)7[&xK&eZ@w{ǂoyؕcs'P6.ap5p|^=V,zEU^Fgpv1GyPvFf69v%G D Da'Pr&=BͦzixERL/w7`G!PDb DpaBF]h|Sygdf 1ktl@{`@x- BAtoTDXfviv@oJցt /n cg&|6ru؊, i# M捌 u8Ȃq긎ug|f@Ha$R
|8ctlhaA`gY ItR|ϘlLՈH^U&) `v)I9~2z*ytBY 7|݅~yuiO ГT A
L`(zxrf9
"ivWmIEɕ^ I/C;Ury p@}Ytْr
cf>ט w }{lon xWNG,g9 "w v, |JIr5 #"-0 ~i~QSba
P$s "P-`G t p4HZX7FXYC ; httpd-2.4.64/docs/manual/images/sub.gif 0000664 0001751 0001751 00000013703 10147723030 017555 0 ustar covener covener GIF89a> RRRccc{{{ ! 1 9 J Z c s { ! 1 k ) ) R { ) 1 1 J 9 c 9 ) 9 J J B 1 s) Z c c) 1 B { 9!J R1J) Z1 c cB{ R9kJ c c skRkR RJ)cZ1911) {JJBsc kc))!BB1!!99) ) R ) R1 ! !B B J R B )! Rc c ! Js ) Rs { 1 ZZ ) JR )9 c B k Υ J ks ) 9 9 J{ ! ) 1 99 B R ZZ c B BJ Jk k s 9 1 1 ) ) ! J 9! R 9 k J 1 {Z 9 B )k B { J) s R ) k! s {J ! s B{ 1 k c Z R1 B R J9 { ! 1 B! B )J k ! ! ) 9R Z ! )B ! !J ! , > @ H*\ȰÇ#JHŋ3jȱC C Iɓ(S\9Ҁ 'NƋ-4pas4gv]KMڲ `@$pWVY KٳhRj
#?p@Q嬩Æјƫ-\PJ*S5]RhP>ty1d|^-5װcˎm (>8C. Hn]7pEsv6n؎& IqT~UN.IrD)#Ic ;uް)#&0p)}M~r w'\%-s 0ܬ@hOj߈$h(,0(/"0EQLPH!ENLEJxR(Lj"W#AY"W e|V`jƘ\*l)PH%(rdB+o>&" , ." 0X3L8`Ӎ9T
sy*ꨤjꩨ:?QD #;JQQ @h-R1@M2`cN:K1 1$Ì4d#34M.L.LcN9c2\3;<@<L@pD@X v`A `@ ^G,Wl&e| u#,b,˝X"%7K)R-_CaƬBrm" LPH !Tm) <chlۢ&tm`m9DT4@XU p
PW!-WnyF` $X]Cc7CE1cL1Jwb
)6r# z?ԓX0~7GWuD2| BOK4ȕ |@APM0NK0h'}I%1 AG uC 43AcNԆ6acw A IxB S
@* hFH* ʐA V@ 82QZ,^Nܢ݁"F!$B0Y 0Ba=W86 dh2hL 0D<(H!!UOB/h<:
G;1p%P^ZF:^`' v%#8aXډ Sx n&F D D"KD%.aR("t)rF YIE,
aB kIH7qEe9X9" zH Z2 $ l`Ḩ>OCš @6 tBC<`7aP`ߠ7ڡt4" E[xJAԥp(O
ؔ 8QZ0̀aP}82>Ԧs b8`ZXj @V> 4V#&ѢaZ@S+ҺV4x]1LjmЀF:nJ< ] '@^}
3&;'TNͬf7zD& hGK@ Sj*ҚҺmD
`@.8i *0zO{ 2
8! ]JdKZy
V 4 5IA
@Ёɣ8Kt
I<+HщW
QT08?8uL .pF @Oι
d:1~A I$
`PHt8ClC
*a7AG ܀.A ,y
8bPHE*T."Ir!A?E1pI&j *ع
π.4h{^ G5]8 5G7] C;82S `xwxD'dE`=2& Ƥ;
rC
A6.Ev!>
Jm@[h;ndc0G61t@Ƨ
<12dD=9x'$2ou3lPZ ~a ]0;
(S PJM78-x
; DN9Rz` ;x < eBhG6dX8-XN0t".I>wf0z dȏ01EjX' A*AD,AKB0ŋD5X:&u^h H
*gxGިGRxy' (<alXȠ@.a r6 EtX#<FTw؝2!
<~+b `>lneTlt!AK0, tz V-h!p R8B
LQL 0|
G
A
3u L^Xjw6
ؒ^ )DN /0=/:$-S(0, wH"$9I?S 9 -0 p%E p/-p
) H! `p
0( >i + ~J؈Ul2&&22؉Daq$=
?sT"vU,x
X5X&XZ55>pG@TOIf@@҈pP\2l 0_ ] w h"P
PPC
P9Z5,
3Ռmu]*yps_! +B
$R0 (Ւ02P# 6 h"& &p<a:0DYF@LٔN#+R9a W@XZy\AUP8 B .QhBA *"*@ b b ~_^1jY<7;`d/p-0+`:
\x
00AmQ'G.)%`ٚY7^)=0=; [w7
Ѡ
z;; `cX!Q Peyayh.`h 0\6h# 6
ِ
p|>ְ
t ` `A E 2_ Ն:$a F J ^R^P|!
pnӠ 0` $ ~{Q" J.AS+2:iya8t Po~<tbm Fb_Z =<`)(@ ` 0
GF ;jp
DmD~k@bP\BU,J gɥ]- pu;9<h*p ކnp
(
}b 1s o@l!l-_
p$&n v !4 Xg 4Xh.Q3?@Qv:
p6[& pYD
0D pgb}@&p0F%&mzohwP p ՆBdך"ZIF2 xh:p
P&`
q`
%Ơ
q
F;`oef-EDk_PpVj zh00mK3 }!aTP 9r<V _hLv/-h@ 6
q0@[jQ{)F%fx pk0TŪp'bz u
r 0
0 Qs3h@=ip
z s |d À &;a O` KRsSh0ZU^[ &2zP~е`v 0
w G'R*< 5 ( d/
sP
@Q; Jfs -`w` j],\x?!'vs$Lp|=
}`@ - -0hnQ Cq,* A
5 A
# p
~@U-]]u+#fjz Pl@! `V`; ` qD0
/% :-5A~o0K7+yE$FgSȋlx h0 #2 'V&3 p{ P
0G߁
)'
u'
˰ 0H&1Ф+QIBP>#2PKPPE9ZP"fp
p
' ` ( D- G Ɛ
qu s ` ̐ ڐ,7)4]X4j/!=0]f
*KuZN~zJ`y
zMG 9f|]q
(!p : $! J-ӱ ׂM
} %N N *0x(X)g۾"Y JE &PQ$B#P8"اLu' G G 0
˔
(
Tx Ӂ r
qb4:f/>/f pO + -=*YY q ;"Sp>x "
pN
P "- n
| T
``pP :G+Ѓ ] (0^>1505S <Pް
ᐓް\ 0
2p
@/@
=P
ِ А_~阞Y1tx``Jd0`"@ $b
P4
_|}B 4X" 55aX1CG^z S2r0%VP\3% IV6
CP0 &
`5N"Xx>L1a#(/ 83 eh 0"#nOs$ )썵Р._GȾC< 2p_Q28V.r
0W1$BB!9%no^UEh'pUj^q(#*
`$
0S0i
^j8XZ%. ?_1 ; httpd-2.4.64/docs/manual/images/index.gif 0000664 0001751 0001751 00000003004 10147723030 020064 0 ustar covener covener GIF87ad .
+ "" " a . \ __ 谰 . # 77 % mm # F & . ) , 'Q i z ** `` AN l . LL * k - ZZ . @ m . ! 22 hh " Lt 2
%% vv S
O b `
ty 33 0 pp ) M . i n- F _ cc ~~ 44 S & .. " ;; VV qq . = _ '' BB d & ` II c 9 . R f.
{ PP .
kk ! F . rr @ ! a `
* *{ ^^ X 3 i * ^. . + , d @ H*\ȰÃfఉ<ȱW`d30 W cʜ9ն ``Ͼࡲ7XjA=,%1G`lh
AQQS&f 2Kͷp7" "0bFZܿ bH/Pl`mY!KGǐ vRg`(v* /^Ҡʤw E@Ɏ ]4( BP[k" N
cc" L5e8%nr8 @
?XD kX/(8B@ A A , WdI!lP6 `5C X'N= ϰ;*5SNdJ1I`U<@C3L6AE:j\wHhł٥ Lpᢚ1 !q,_ED%D^c
Xe@7e "`sA)" @}*p]s
#.AY
mAhFbpQF}e0*qI} Q@Ĉ c`$ t 0>=GBR>
d"o&c tU6ds\
-$ Q & $813! x<r2XTSSd9H:0;Bx#
435tJ/$
t+ &NT;< A2nL7`<h
X@ ; httpd-2.4.64/docs/manual/images/rewrite_rule_flow.png 0000664 0001751 0001751 00000116605 11577356155 022571 0 ustar covener covener PNG
IHDR rK/y "iCCPICC Profile xXy8U_ !1DDI1Hc;ǜ)JHɐ")
IR4HTh "]{~gֻaYk= 9 ~A}ZvDVvIg25P6 'R4_)v]SNt=S
19ص`GL@$`K.ؒC'
=]!Xbi
q &
lN!{l_ ~
buW7*⺺R~g B@P HО c+1mG@ d j| ٬BT=2&-ڬ([ +kkJVJ@ŗ L Yׅ Ao5@Crh/qDQ}a, *3]ßxkO*& )K4XlBJMR\*c碴'{d[
WU.~U۠Oj'oaQqɐWsF qKsHja[;C cY.n| '=ۼ|vW
8CAb f +BjvԾhXţq<LfMxv I)Ωi3x2YYsF;sO18#)w
C )n*I(5/()ou1`%j%j|+j"kIWٯ~{u5
7o irmָxzWrˣҶ{N: tt>2{$ ^B~OJ r?}, #C/Âï_Ƽn
-̻/M0M9IlI)it̶/\_,~44>6GμʟWWhV其DcQ7yX y88hd
YkH1+eUzc2creT$j$]ZC$յ?aQqI%:#߭q6\S?䐵#9(9õȭGz"D ? @V*4<22E#ݑMQ1vjGG=>ޘP~"dDGIB
oZXZKzaFR)l 3zv3͞S^(W*=_T|ĪTl[9s***S/YV+^湼|uڒquHK 8{S֦۶w[>vݼW~>R'K织
] <63Wӟ:D}pӚgU/h2oī#6UFGzߔ1N?># ? ~p*kf{&ڿ ՜
O_H:@EWhL J˨4Üĺws
8Ӈ8T|%
tmk ),A!!&K]wv˘3# #0XLRTEWT8ISZsA s.>}z48o`ac$t[,-ˬlyvvo 9vhա3KufA\CDQ|_? S)?7E$ʄ
u: ;t4=^0 '6:ٓx5);9,&U.%EzjHL,|V)l79O;
䎟>KS[<ט Z W0WX_|^jR2BpyuUiu._^6j_6&n7IldhzkFs; w[4[dɶWP~)PkKңn>MCWc'wL}Xh9'@G `y4k pt)v??"09$dRP|H"1!'B yLP(:@~&H%0fFƌcll?gKu)~tdUzRE3KXFg;L<LL#t71OгıFEoُnAr 8YɥvkS /e4>AkzD<XPMpD(VXDq9pg;H48.i%%"5{Wt =r*;DyUTT5,:hzhkG䐮>_ђYj=atɾÁy,zmgOӾüjK0!$(Y8)b81:9tt&>8!tbKe r|sr}-l=PTvBo@Փ+u9Cn;]ópwJҀgCG[ݘ42e"۲դ5ZChC B@3@!D!!6#eH#҇|D!j(}%9VD <F +Rg:yx~zA`.!haFUB&7ঽwa<v VVl6n;[ˈ}lK0# @I
ʾۊ{W_E VYXHHǶBP18w-;$ vߵ&=Lɞr)
%JTUuwEY[BDe?nS3}L+iq[=+܇R Vnݗ=}8|CFtR萈Я>21=G}鏕&(x4O?)Uӓy/o$<ԻBwEBxMպkmh46)h!)o`c >#Ϧ$GH!oƱ?LGgX_ X]&VFV W~ > N'^GBSUd E風R 4+z?:ݍ8`*1?S8e\nog"} G7NLNL 6133W^fs̱=|~h-g!V%n^<y=&/ n
!*+Lo0.Jw%K*t+eux u>
ϽuUO.þPvM8 *k(ۺqK.o\z x 0 C3ć!)GܣcZމ/; u,Q,i)nZrsfipӹނڢRrۋZĪ+)u"w66:75 ommx_c+krߖOn<
W*# G |'28vrȩƙ/wV|Kn553CGͼ|ޅ?~._,Y\\2]*[%Wee˓++++9++S\z17Vք2:ioK|(DCm7d2fxQC,HNu:@ K#T1İ6C) vs `x'b EɍJ#D 6X 07klX/-! <@@Ozw|CK
[@K*+l] P/P/I^
|VxW[bչ WĈbd0r-F Had10k`TFXU!_E_`O A_ r 9 / &MO)IVE#k pHYs IDATxMo(Y=$(KBnZ5$jtF"!YDO-ʟew}yvmy|;oܙs3gi*( ( ( 8^tJ!JJJ (TR@I@I$PɹCQ$$PI%%璀B%jEB%K
=5JJ
T PPp. (TrP( ( (TR}@I@I$PɹCQ$$PI%%璀B%jEB%K
=5JJ
T PPp. (TrP( ( (TR}@I@I$PɹCQ$$PI%%璀B%jEB%K
=5JJ
T PPp. (TrP( ( (TR}@I@I$PɹCQ$$PI%%璀B%jEB%K
=5JJ
T PPp. (TrP( ( (TR} U& |ZGz/0]-p τwNÆgf}y{[K *IxiNM i/.
~bw~
oϑB%ikx;ީ5ȚG/%<ZjXiD%ܺv529 KݡPC D Ji+ l"IT%t% 6g?Y
w|H2vaݼyp>ZL` S6=YNSw?Ѵ/utJȘ1 !wf}PID4 ֱ͜ςG5-yޥk>s2OVX4tZ E0NDPnW7 8+H e7D
&M{_+qǹVyRZ/>p&^DY;?K +JJj.89JN@<%v{\+\
yJ 'J a%'B%'o 7'oժUǎ ss&{ u>+ XA֭,XRE.-|K =rMնB%[IV LCO
J*PH@JWPȭ T[7o"SHǬ"+YEnVB%7kPcGJ.`v!W]Ĭ*E
bG'+Tw8j&pB*9axIJWƎ7
-*P
E*Tr&tig#*HxI@JeRa
d*])QD(]c>*! uPE(TrFs#*QcZJV*(P3D QgQ};)?sӧ/^8eNY[[o*(=8;
[UDׯ_ϒ%/LBTTJoSO+5ܶw 篼Jjg (JS Hy$t%i Ϣd۶m
4w͛iҤ,)(n-I@Jl/Ub |`W
mܛ^xgϞL`3mڴڵso~w_V*%pڵ9sQK\S35-Tڥ?jɜ93M6'O=f]of1S2ҕl!U+S 8ӫkq_5f&OMD\c&UĦPdS:ED'_uHMɓK"kF]"B$Jt UB%4Óӵ=mtywTIIu( 8+i5>Fѽ~J>#l/䙧yn:~)DMYZ)zdɒq):ͩJ P3#=3pʐZ?#lӨfg#^^ձCQddd bϮDK ;$?@("`}$~fM1,o`Ǒ2jZe#i>=gL֡J3k;8|E҆o ^O(?5'ko-P%/ߵ*H"2} = й(;.GS#ˑD#X25}&jڙ5]Y;O~ér佳cSwSG_ԟ?ClpWpmy5yA@A%]Kb oZݢ 2as΄JƖIZ3<A?;~4ԯ36Vm9.|xǮEasB.3Xn鴰7~},nb $(J6U[Lٸ2*8w)\]h yר? -aڎ 還 kSjZR-Zؼ=?[=Eخ_ݱ%lX"
vB4aĝw4aj g7fMbf ]QH#ظZ7) N@,&97f{&%7
mشz DjgZz Gik5o^ 7w5cڷ m$mߵZ4E^ػCk84Ȝ>k4ї pdt%6++%qkA >=Iu%s)F$U6ksR8;`KsiؿK1WJsS_ 4[m2K
f69
j;+jՎ第A^fp Klߖ$R)`:WLd4֕K"߸}gرI5R^yF{)o\ o2Z|z>zHCww*\Ҧ3o9V<@ˡioc JƘS U@s &Sx%Zʋ2"o]<mƌiّ]Ci2b[1+m
CE`2r}ܹs֭ڵk+πEg7|8π33':e[tVqgZdO$3e%{^^\ g=9'n]n=Y ]ٕ)mŸ`s.U 8B ٹ键dgۣ:ᐐ%KJe2
0%aT}+e1&w;3rfe! -ui>%G._㵧)&K/غw&i
%NbU=iB%wO:u` lED$q 77%oz-
ϓM {7 r%(Js N =nl,PԹlɣEPs
sEP3%3D ͔< .r,aŶ}7k,E{nCɑ@rWv!0D];kL:4D[ͨ F}5KCl`? <qĽ˖rkua٪B
3뾞i^˞5Z Oz4w/[)̩Ԅ]MVʝ( (])b\Wʕm۶R߭[7PZfϞ-_}U`` qaÆ-7vI8qܸqAh|=NX""aaa ,"E4o\O8f9|qƩR 'q֭[AիWS ^ߕZSߡj}:ި!l£n4ϋ]BK١yQւ~s6=~:֢ipw}PŴ[tc쉁[uvCnjbY!~+
3
L<4nd*&U},VPk0wyȑGf̘QG
> #| Tҟ/^8耞(KI^z|Sl` }a~f ݻ7kOm(OXayĴ ~! EIHmҤȹ
$8G;Ӂ_ҊU-Wjy0!ʼn Y2݉ZZSGt_8bq5ٴ)sn,#{ԏ÷zOWЛ=g 8ȃU.x3[ˢ=l(<Z7:cPO&T뤵]p!G|
dх .UT
$kc-xt S"(cOz1ӽA
2|^^^W5jcB+اy2J [qѽ+iZlQ銗E?UN;(JrC-[|@I2 8 ѧo Ihن}Ҿk^Ͱrso{{XQtJUzfq (T24W\_+Q2hE3"ѧ (P5kDcPeKϴsO:HόݨPpatԧ]?pٴ,j |DIH%-[khU6cYSyҫԯ%"R8{µҤO1d PN퉡;B<=q%̪S?[-Mըc:u
V+qabnoa2%(b,!YZR/XH;3QiS?cO]FI?$;K{=E\5V8LT ߾0y}zRʈk j̮b ڑw41 ɍjZ,TRJvJ x4
5wI|kc.&Ӂ̡YyNz
u Z㏌ӮBV,eaz09Q̵}_ LQI+gJ:r\q5*">MN*i8,x*M]fڼ2+Gtf x>8Ԣ.]4mڴM66I
Tbb d'v%lLG)zNdj@# %KS \ <u!&|OKKI
_xb(d; +.:^<ZߡY-[-[#[pO,0Ut'XhH",uL^$ {Iixܗ_~O? iZA$$T J˖-ΟAŔF 7S4}O$`Y JǏ ۷/A,@* ( 8 ؍*UÙ$hQP,G?|IZJUPp2 ˗g# ظ rhA$y%
: |rJaDI% ٌ袅hgU$JgpI<+ IR<#GT6kI@$ABx PS<Eln;㜳]~|+brd\' ^ فxElCu
S -*qL5yx8$ 18D4rR%'eq _0 vspvV^f-pe;.AqKFD%ꏫ$ඨĩuֵ\XF>
EI ~o:)@?zI%֜._L $%Q;ҥK+zq0̀ P I8"8s ہ 5LH <RdЫpOTP!N}wt>=3XQbhI(I:9PJ fڑA#*JK CJR
CAWHBKDuH)%H1" G#-U*t%zȊeIث%=QpkW0̠X~2{@Ad 8Lb;ۆpA&"&qӑ6FD
HM2T -AOF H IG%ʀ/9v d"BV!U ٳu|ŋsmOQ:g]J&z?E) @%HE LigI
*H+)\*ٳQk 3&8𢳧(. qtH+ f9>&jGN@\LH TRdrC]ɚ5$CXI@n=Ϭ"f)v H!ׯ*DnJgϞUs7-
E zD2K%ޞ5u#
NMO QJ
gpl3Ёv
6X >1S^KJ@cvG96Љ-݊U,J
Q"*љ%w82:|<6i-Upv (TrR) xt&8OkHůH
Qʕ+XOݦ#J&7D֏$7D%>KIH%r+Gt]fg붝-(wCnGjq29[v̙3vYVGn+Ňm7L9?dڴiMX (Tr=v%8A
wUUHF]L3gxl
fDjԨ UϦt!*]~]VTv$JsκI,P= pCTbvFrW.*V Ěﮜ*$J lM `эm۶3f ,ZoܸDo䈾
O Η/KЬl-2UU$ ?~*Ū .
ό(Tvw$ׂGre]ҥKsM&G6CVP{X堏 `]JI1$F {ZK,yEն&#)ݜ /eF7ƽ[RC Zl(zl'7D% ~o;!E<f_f=ؤq;wp TJQDܥ qCT7SߜS
$ *:@ Zh2Ջ[/ӿ+!HHRT
jkbUS?W! iղywV,h<9/k9CxPnbINW0=W
]cۧ:Cg5$ђچz-KԒ9AN'V }A3w gVr >pKT5..7!*qkkJ(AhImCZ̮-5M>;w!*U*Ik{ҩ}JzY%]! 6-ll ijLh^0 26&13Q&yW"'Jצ"$q?oy_6 mE
0&7)p7TbT>EH.fq@0͜ԤO֭[f xF9#!&[jnt&7l'4.]<s
mI^0k0qmhhV%gB'$uLװB5]|YiLX>n:e!"$&-[6/W2˴/%ޯB 0['LWy<X~ƴ%;#hIW|}Ig
hٳrHHqwC%gf.\IF\cGԳ
ݸS,0YEYSnL$-?0[# ~6nz7o TXr^JX ŚB%jn+3 H`xч $lRV?k~\+OӦ
9`qIh.LJc)ϱT^U.!mQ в\M!M2-Xԯz_@cZte\*< I5.Xͮd
=_Y d[omڴɊK7?%H|9[:$7$T uw>[æy,Y'O +>^ .M PTѕ}^Kt(l ?O5bZLч8^RgiSJp,jתx^ XKӷGU`2X 0͝;U"VpajyKJ
$@#COEj[մzƏ 9!N<"aT-kU2MO sH>=]$Ly5iFnFdth*+ Y 2Vcxll] } 2 lf-Bҙ3g ۥtT3vqMfYkZlYfM6Η~gϞpڴi|>0O?1䯿:?7olٲ_~g:u֮]K0v~a#N,Yi`Wb|Y ,LYfͱ IDATf WT.?Ѐ! H =0֦ZҩSZ6ӽb 3 ӛo8] s.PYx͟??s~~~`
)S+WLc @ĉ/2ς_jB{{%[UVaaaj6g$3@$
0XV,KV"uD lޤʎ$1Ǐ 4iL$"E3xjݺuݺԢin۶e_fΝD(VXP@:
Fʚ5kиPOW]IE%)ӊ^[F2JPhaYL: 0]M'i_Z(Ԣ٠~U:`]~ڿV[yX m[q- 0L`T HD/y桋:tX-y
}86n8Kiz6ITWS X謴U,]Iɰ, Tv&liӦ륥eXG@480@ҐUlͅ MNg`"##3'|B%cg;ŞMPlԜ[ ⛒hѢ˗! ̒r.1EM>YCV@%JUJ WG%)@6M44iR4ixb!gΜm>'r]^#F`:bO8ͺvh=dغu+ ij9s/5jtرݻCƍKx:<B >D60sңiu!ѣa*k{S ie;4ϭ/Zg5M wd Gi٬Ԙ[ <|ɔy
*D+?k,"]IG(TܢJr&Q%X_} w˖-Ǐ߳gOٲeY
$
8044?j(S`bht z>}Pf̘^^¬ʏ 9rΜ9D ;b֭ۡCq0 'VѣGC!P
ŋMΚެAA?fp2 /vk+N&T)ty+/>+lD)2v+ab5%Z{מH^;.Gޜkrc?8ʯU@ QfM"q$ƱܬY3 1loߞ`}MΫ^|yY!N!lVQJg43W&/^^n,SP d
=~ K'+8`Jy 4a
@t@={v|(XRoP0vS@^}Uy@{1|ԨQ]%g `*&Z;s
 @%Ս&f-|IҬ rn
<gm?!-ͦS~!C:ݺg^
T+ڍ6Ñgɖ;
H`ݾLlI@ k:hE5 :c 2n$q3*DnRm*`j UF\/ĔHGIE%ȗpyaƅw>k靦B )S "C=E":j`1E1V§O<b E8G%K}H2d3$(#|ʉ-xIӎf£v0 ԘB j':yRhor`wݡU &ݏSЎqwW;|n0Xec=_TX1S2L[3AtLQϴ->cJ -x81r<ul2)q+'Dz3c3 @3z? 2i۷]F
$D
qߍ;79$i5yL!Pr\7W܃,R ڽ6Eʗ
me 4G~bo I,e*O'QU$/>+)۴i-*S9#9b XL dڃvp5T @az`!۶mLKcJqzA`FS03-Z,Y1CQzn! %+8?zX,-_ Txp=AvO3v'P Io=6qw/;MA^'zￍ&`(=tj`wmOϏ=y4̝ڤ]6ׁ 9.=6GU%`5TC'e#/4!}_]0oOyn >y霕zs*X R AMu{zX\Pmf0 66C%c0tE cas iذa[^)=$
_\MmY5{W0H7 Ou.7s/?<wO[u[ڃ]HwO *ZkW^,VW |Qy4ÌP|d ,f ڇ`qS\q9OؕG<2JΌ sE7` Ǎ7<7f9i~C8g@9b15I!I1uAO%Y#ؼI!劈ҥKY@ TO[f5RW N&>(ۇ̟ެvRi<^]
p^ o`Ȍ~Ej) 9c[ LL;sh%$jOR
I|GhrBER*U
焚
-آ]3fV`ۊ6&$vM |&J|"iZGOW;f :1^D#M_gրu u _;>Q$. <~zWKE]X2p%-Wmw(r˺c.-i/{-Z mRa'"}p,װ^:`tΝ|繋צЎ I4( :]43{NxTTid0#K%?oDj4a Ȓ!ݎ,:m#%{@j CPD8De"C?' Cej/ɫ *UVA]+NZɺ]g2;<Uyn=1pQyN|MmBjvٿа,_iƸ<WLxпOL67$ 2<T\@y*թcs_0qo#Y_3G<<XU'OgbKv6c :$V
\x+Gf
6E} %<,No ?@ڵ+nD ײ歾9`h>'JJYwlVISoqp#:ԮuτK7(vf
CV t8f7 OA_'b].JA,JhI;_6%ֵۧ*Z(I.z}vKٴ K #胻|r|аA'- w'?bqm-( q TҢ h^5Ccq>L;ӣO Oװ<HO<0jqEaYʺ-< edG/w5AOqȊm *?kruA-ip6mCɏ3lZdo꒓{YԒ[zDDjg^2}*@CXtq2ޥl@Wڹs'DH:Jy.'PPN=Oڝim:u4Xsi>\y%k5(ӷ'Obl"RD\֪yj\t~_^%L`{m 2,v|c}?9W[25YcO+IW ) X{Fj_1ulԧCG4 ^wğ{1:C_ nG1
y g74K~=>.H1
I@;7j9aȋMZPymڴM`"ݪWB%#uÉdoPE[4*]miwRѫB
wQ&wnJk[^9;W4x1cVSV9o+ &}ا7o}nge:g۠ nBԷ(Wͦm&߆5S<@-1md״-+qղ39zpvTi2_# %KR Sɳc `MDL0< * 8yfƌi g\NЕ2Хveg-?i+Ưi8}q"vQݩi;Zy>3}nr C*
'͒ҽ}6p"VO-IٖmG,ر bK9jtbQ@
6)*"Pu<Β+NHփ$Gizvh epK7l
ׯ QF#s|vB;i6Xzk7ZǨr^S]?~ʇ ߳ԙТu_c~w!KjKg$ld<?̼*BkeaӖ#@RPPk"L_X.Fwe̗FuV.dv- 28!VJܹs7iҼu%4cX`o=O IݪWZBWQ1O
Ūo~-25^ UKr|Zsͮi|B[3˱zdq71Cwp@$
$x-Wxfu` řPBx3a}Q.ZB%m8+$0\#Fx?sei
6mm6 {NSxu?\eP')ɰ_=GpIuTKredٛ9 iEF eHe
GĉJk7ey@UႫeMOr_&̑*I_@<'`uI IגØ]4NĢc~F{մ{)?cy}۟@ BK d!DpR;+J ywﯷ
JϾgs>A֬;ؾ%]Y X$`o l5v١r蕝sj\ݮ"bvz2%t
0ĐT~. .Y? /<fHvfמ9<(v:ܽr>ojG~>U~YZ mB_z Y$%%If/&;_%[R]קt%o"(LІ$zssD=z_-e>\g^]Ƥ
,+S]8 -3[=|r9@r}LƟдe~+$HeM$L\јJdUS#gK! Wy( !l cjh1BZ63)%H8[c.2yT
;9oFjknϯjE&\%. *+ LpQ|G"ϛ'Hx" ф BM_ѕn+/4 0x,~.F2x=5(U!r0 y ZA"q@R"*# tJҡP{"SKbfWI)t%n,Ҭ]F~ 3L:Tߞs8kHb)$7$`WT$8BSIԅ*3_|Rh`z|n N\3a
`3V"" wXɬ({5Ǐn<Hүf$7ؔ. 6m٦UbV@%0^T;{W.wbᑫε+EaJ4L@MF]沞]X,։g-
5p dfDQ*5mMa 峿#g*邓*ˮ$boYDfS8C綮x-E6I`ƀ&#ǯzܧ{UR&cĘm@;]]e2$rW,2h94,ٰ 5 **+L1>d9o廏C"rW$SױL1ҨQq
{U-'L>j%mWђD
<.W/02&ҕ&F A6җsml!2Nt2 + o
Ȏ1W^k&Qוf$TNW LCy a&6+sm_L}0hIA $ykRNYt%b*IK(Iq{! P6HJ"!W\jUk ^)
$Xฏ'?X;YX0
0M iZ6kbҐdXDLUt"<֨H@(JHGR9_7n,#)>Kip LT.[ĉ|#M^֭ה-)ML34a؈7OhI sXИ{ί%M:">o*:8\X+K/t wr$?EJ |z*GCX|XXgFz( 8A~Ҹ5llblL}6s'4ç3{> O* nݺ_9pY$D/C\&Do/Вt;7w z{$=§Rl>C2B1Ĵ-'?Q0"`jxH+hJ}zV__K@æ|֨\ A%W$1ʦ vYQV.]TRQIaI 犈ITX, kŊz MQ=% #*W vw҅"O+raS^'f)qY5~dU
W UHtE Iѿ6mڰP~+ϡ+Vb5TBeqke$mIthM0I`9Z
#j*zYΝy"E0K b6k+M0<L7h5a E9%Ap<˷zmVUbƤ feƀN_ьtHT$[(JXvr
bɳw^+[z= M>͛%]ˊ:sQ`dn2( `c ƚ+jW?m|D3{`uG # ܍
VpWF >ZX qK=h TB(JrJߕ5$%DھeƁXȷJzɔ&勲 ;& VU
E`| @(hИ&"٣ߚu_ ^y'mN$mW$poooP ' {g*!& nt Tdʢ݈߮ ¬Y֬YZ囎" }$l.00W /jkUBД2Xp #PI4&"hL_zrYvpզoOaKF$CŢ$WVm]}_|4<'5QIZl[`#˗ =ztr]B H#GY7Ek&A%S`bW_T.i1SJܱʭߟI6ny KȎ ;pEi 4>b)(L *_R|+nʕ+Gٳ=uZگV-}2lmoĊ'ZV$ +B AX&}Df𨸛aNL%O>k cLN@Oa@͘xLS4SpBvcgضt$vr6 qkӧO q-i* *a`$ؿ$4&HNR01 $: T 8Cך/`0dٲ? ږ# ̴$n$r1Ks$#E_'OHM4l 6H Lٚ+ٚ] xKM4UC`CADaZ1#~ݚ&篘EGآ_]0ju $q0L{\@ QP͝[{8եKWTa ǣ"nbWbڹ:ZjŶ,I*e,dnPc ؿqo_0X )0dok\QI TB b6 @!Otɜ_wyMo IDAT=GF ԙ<0kn
}I;#jOօ.'l.Pi- ] <֮]/w5Kڂ-M[?| ~ dҐFG\Y9pUL
hԭ[w0 Ob/@`rTs "'쀿SLa
0K/&{ 1G-I$2V]TK q8q+wlfvmS f L ҹ na[ '
\ҬyOH^q2# 1
zfot"fjA-/^ AAJH%,IIرްbBDnaܸ1xa&} 0E<#w/]ٱ8Ŀc8NXb [;b5YO= } :tA0Mp&4zoܹ{, hjtd`*7Lt;_jg&f+9lٲz:tرc\U01 ,*am )YHADW4o쀹#Gs3,
I҂`0~0?p࠘!tunlB3wpp0WT5Z&ѕnd꒠qΗJds]H?|}{M̙Or:SGF}ɐm P)f'>Е1ܹ3˓f$ՠ)5#]I& 6CLXD#ׅ$CÆ}ˁ ?2 훺_wڧF}0f= ݘ1~vؑe˖9 W qЀXd}
ömp0I&W$IC :΄B4 (ƃ 5x(\2~*9 .{ oo>fXO&S`2M} bJ"F%$rdȓ@!Ñ)%`#I4h#a?ᗔ!}"7v>O WYSdǬ/UP8:Ź~)#41 AD!Qג@%ׂ$ G8w:O:)r *y0)TJJQF-Yȑ#L AI0HI+DK'גPt-IyӥK$I6tJYjwcRdx`MpذamRk*( :z%6
qK! Pm:$ovJj[2RR R8DuJTn 1ڷoO BcST 5 `DѭSbH$P )pݻl#8b]({ q;˒iw|\dz`d FD2${ܺ~fӚ8~ڈl6n8+C_*nāx6ź<*x{8gFc;qD7IhI={vmmIKxxDƳ_NqpW`ryT:w ߌ￭R ˂ r _JGI"$ѣGG/o'@ns>iTtp&.^1&v
#Ft)qD@$3[Խ{G6$!
V)ׯh_ ݻN"DP)Ѣ|iEdHm[7osf. +떇$. _ o}U: u<*- 9rX].V,3$ߟdbUQ # )$q s Rxsf JLkRNVN\ |'=D|ɴcK 6Hԩ˩n
tT M4w;vl JƤPN?Nl5*U*dQuÇŃ,a"$dL{բ ؇pra;tq'`Rdȹt foKw+ڵ_~7n6m'Uq LJ7odK;PF킳dXoFفت o-KAlsuˣەԦM,\POQ3 ݻ˗//upPy ~@:uG)S tM mH>^6%N֭1)A-^ϦA Ī A+/ogHc%JCnƌQǬ<'O ᔏqF UW0xDfHBM i*w r*Hz"
ΕMpK\<F\r%`rmTb5Bkj2-ڰaÏ?%S`); ?%E^dq3H ڴi?o3vc͟Ѽ@ 01:&&FgϾVv(>[f͡CP{TѣG/BfmIĶ`"$Qoppo7BHe|δfE~!uɵQ oaj28}I㐰=jժ͚5˚5+n֬YO &$č"3-nb.v^x9r1[Xș-uS9JV+ +uּu͛< 7
tbΝ9,LZQ 1!|ʕV-Kq 7$ ٰ%E> ̞`ڌhwهw};y8 czm+3&6)U"3L
u-B׆?#F
qن.y[dI_\|eJe>Qܕ _hMgx[
];4u}}9q_}<F^Wj6K-6k긆Kg
j F\bB\,;=W}]> 09(=3HB \t)(Yr&m D^n#+C:ݛMhɻ<} d"cb ;ojq&w1" 8Γ :Ne\h>C[1UU Mۤ1U*f[a/Wј\8$W\q,kNK q駰KD3++~ Hs¨/4ͯ釿ާb{'yZ|?lpi}<[/67./73
y{/F-u[ϼGCgӎC~gȡL *{v
u UxkFˠ008=A9 Њѣ1{߿?n%rEᚄ7;NN^xs79rllnǓ.|ΠEhѢiyGwa
qtVo2-UN@k { P ?yzeuKyiܻj$=e(P=o>>1|RU>;NՎ*aɒm lx5,X>@l"w¨D±;gΜ]mٲٳ̙Ӯ]N%
e\(80חyi q;+/
E g<·@1cZ:oޕ_|Xm _xX~*5 DUXfILe^^/c%\_!F)wʭ|s.Jf9YS4fg9.Jl2?=0{ /ЍsІ_Qh Lc&X+QȻ]}_֓đ_~O߃څ,[yAtb䣿6 0 *jsF0bWhtVfk
}ʫyyu.>?WY czՠ2)])n%KOtfw3gΜ'zfq2~1cԭ[ӶJ;8ۊP LrZwnګ T]Ht(O[NgL5_f',?b ümrd/^Y 7읭i47Yp7+60]IWT9rZ!!@%!vfӒ Jϟg'M [oqd{<$nYرPBI./^02ǕQʶ ըQv2`o{eϖhKm[wGXݢjXDRW4IqG e 4 307RKVe7Sre 5fokk\ſѯHvIjnW>|7n
p* 'T\kT9'Fq;/<y2^.Co,e ~jA4a .0D@WbۧYˁ]?lzb4#)UL{(1Ly٢Cw#S'7 *՜TDFs+>GwX%`*lf7ǃ,.<\-5otOax@Cu)'T;Wpް *Mgxo|$-WvsI=g7A1 dC|RժU/LqG\[#)Tr-Չ}#tqtmӀ^zq mgtJ,+zDŊ
.T7O[Rj`.\J*Îβ3 ]I uhbI鎮,'5mtӦMs222te2*e
.^ιR!˕+/| ki
LΉM.J41o!jJW^͆"9sUV'(G2zJK:ueˡ1U6_L t8DB*)SV J`__rj n&ȗoƑntܸqx{Pr'`8?IGiIP+*d (
1CwMl\˔)SH':s5Al93U6RK.
ļ
0 .plg
YMj9PAzEЏr.S(J^
7\0K*λ%+t-$A3APM Y38+pۛ 5jԈ-zDW g`);\&a(=P%K;^h"g`\J-Q=$I`@u uUIX0%é!ӔPoݪU+>:`Ʋ{֭.]vuvtEQp `fp2al
,+YDZ
[ H*CP+WQN$gV<)%82tEip .2\֤_w/Rp*u&.]x A>};]QrfHBJؕؽayQs~>_~*gɜF b;{ܺ LL;E 1#֝RlbŊ!U#Iג\=:&`v Z]+^4h0qDqK !S{^8F0eP\~SOPEVLhIa
IǔŜ \HK>868qqVԱc*VxQr6Jk4ٔ)S=ck7n65|R9S帲W@30ửG"?B* kIF4ؿDErQHB.9c%}Ž!)X`ppp~,X`nz/_~~&[P%
C]ۘ$Q*1w\ou]+Kz๚
W\cpD**@]Ŗd*7D%wuV2m <lڳgOrbuac8?;b`rEFt, M<l/+~@I`^PYD%7v 0kVs1{kٛ&DÌ5f 'F0S=B\vV/WɉY/?61 $*@$ IbKrQHBZ.i ]wiӦYo۶$$w]j8қmv:P0 LC=fbguժ5ik H I7l <1ksHg^O1ѕ $fpM4]q40]vCADS]I$7vYJ[~T泫UŌ a@i
I, - z\QUQP7G% Aӧ^NKN緱Dҡ ~[ L1DA#tIoŷ'V^@:$GKGsq lt4' i4s 6}ٳprx#-Zئo==)w or^u A+ cZ%J6PqA[F{RzM
u*&mZ vt&dLd҄":L vԪ弭 K:m۶ j֬KR\M$q'HBhJSV*FMzV |3.{N cE ԩS]K1L'1I|Lv &oz4fiOٲhV8
4>3H(d*>s |Mٰ[5cbeON&*[,. :Χqe^kLc1ULV튒NXYdI\ϷїO}q-k(6m9nQcBJ& $!+׳+?7B8YJvȿvZ7o&SN H*"v-U@'-nяI/\g٬WEE gOdæNKcB{Cq=T+9rOZ+W= L*RqkU[9i8L/_|ly >o<
46p(DX""W5)9AB'M 70ߠuDxke97o^݊$O$zdg]IF 4"iQM ZH\SK4Yf7
$"0 D$WəJT|<BVjT,k l}_}$Yt@sn *i<|`ʐ!
Ot9Xp HUII L _t豒i7mXY|e话zW/nK4HB&.J km֜6?D}eJݸ/4`rH&$$LɓAF]>\06)iq[߯o$DFr -I$㒨d7kA%- `bR T2hB3
%TZrz[
0ln%V c6`$NhLx-fS*T) 5o<@ OXdxJ ,̀ tt)a?ZMPY=%{
-ff<%S%RB)bSk70m3 L;;3]\rB3&~ qK7hب!+## 6Y磡Hde 'H¡ <HB&.JXQn~+eN
.[d0^K'0 ,7k%X 4웦Z IDJ\%ZGAMbo{vAHo\u`'nYZ2+u9n'2dD$ y:Q_w0BW"XHBJ.JW\qt5dCxrA%&&H,$vGC$z(${;w>l0I $qdHB.JW^?d@}^);ե `b*ё /"T#OO魯PIq&q\ј,gU xDEJ$ޏ:u8 EJ<rB2q1Tbggn:6G39$<{~xTSg|ZCȋ ;H$!ODND>} *1$)vqf|Kn-"]|%D2D]2~+
n(C/ >lKϘYb? <CԴoUxaw,p3ᓗȻ0Wa'MS,= 3\KӅ)p \&8 C kdv%H@6D 'C2Q! !>8=K6$ٟfGTe`r?!.wD}G<X1g֯XBԱx˙y IDAT ugl\USz{zI%S -9&P -&mYhxYw35o:J%Ik*TzNǏ/tm%=h
fL`|_| ;gQok&j'Oh>U.ZT/yyyW"oXf?1~H*ȱE`H!ز5MWyi(l^sgN3MY]ӏ]=JQ$% TÎ#b0cL![|ĵM IiA`(M Y#O$dPZ]RjFjԚ ZhtV`|fXٗ~q%ӆN I2Anب\,7̞Q=3FK[6wP?.;p*4Y-]r-z Sjڷ=o\Iom=-5g[?ӟ\2wliK0 ҧlv}қ,״kfVm'^U ߿{p֢e+StYm7 ^%n(G&P$LӸW%Y2DXoiz-$2.-l(=w^ߓe~TZ_8ڋ)ӜxnOR$vޓƕ{3Gj=g<:IW{UHwq}ȉ; J`ٞ,YEomc}J}{ juGrzuz^yRzWY4Gv&{cHRl̻ ڮ궸^ `jZΡ*XnxG-[
01A I <DI $dJkpUZ)9Up9G}o~y'c #d72 ,/ȍaڙ }Υ>sBk*VR/ѝsg$Bwv? |D>pܲH:g`.9}'Uh}*5
.t:3bcŮU)KZC W:5I=!ɸb*"ޫ̫spmq
'xSչ붏Xh~ԩ"Ŝ}5tA Wl0 z~ѯ /M km4P)#VF Z&f
4fto HӎܻiĔTMoppCxtqA¥ cfc#V|tlT7U ybX(ٜ>}Rhճyԯ' QOt'ɮ4 pf$*B*%Fjgud״h5$`YI!G'ܨe6(eKXڦ˯Ff)^7/9KWхS ֵ5dW
xtiwnm64̨UމqTu8u}1yvC癔>szS|#þU˝Bwhe}2< B>xDˮ4숃Gz1bLc *ޙFQm|V@EXufUTH $$\ p)(AC PPEByCL&$3?zjzZCjUesD2o-ѯɞj2Q7&N_9)-c&>1W.Ev92i}Sv¶Wru[ sU!
8.Ri/F/_9ů]YVp#^rEBdTv1ohd/͉_v̊1Lic] 2//kRe_#P0{ e/NKK0gg 8cE N3ܹgrNLk"s spJ-W qΞ8y3ʕ
|18wE`4%`*~tef)tŤP w^{!w
Oee/p/QLl-2S 0g4)B os ȴR(]68{+]V=8o*[ZL+8ɗ&ȟ ,,sbd/e僯Qx_ҿ!`OxOk,@۶mׯ_//cǎaQ] q^zZ,,+]
(<~; ]JT
e[{e G=G+CX jV*|15%!CfDDAFJJJ" ݻ0o0~$ȫ^YK@d4A@D?p]Amp"l߾}ժU_!\|#j%m+9c'x 4lŝ8qB l۶jժh]۷o ,Mt)1ISpt @ !ЫWO?tx(V-q )&NؤI4M: Ջn%YC%EF jH _#L=#
_k=bu_ͭu5oo߾۴ic]A[WJt Kx+ԣI#I6Eo 9rX7k @U|ky4+VRIϑ4
Ԟ! T?(TRe )Ko!f*K}MVmQSagG:Jn&r`#֣t$jx\}R˅ 4-+5 ]CfW$gbGlУ\zI>_ O>
7 z懅
*f 0 }&R LUs
]0&D֪
t<rYmmڴwFX;>m 1_S%F34+ BI+(Aӯ`0 >4FʕgyO>$QJHY I
sJ
PHtf>1ё#ѣ+$Y aH b£ V +Aa8e[bXPH[gn#] ͑ED:s W3oz
ѣG!A)Y 88HD$r8p lq*L"`%VBWٟxѯ0W_:d(Tsg3y2f{+AO dƕ $8)II!`%Vb]#%}ң;Wn%`AahQ- kԨ& 1) ) = 7+cYKF;IѝQ$D$JkSM b=ztÆ
ԩIkBFiVRi Y>t!BF"8"#<$Q VB5k|g> *b" HG\#WX4+}F"ыUxe$ )8р52L`OqG Yf
E4Dx99]#`1V嗜3a^"=)x%H$HiC=0h7g @鿥dܞ @KXJQ._ۜ {)oX߰aCHHVA-weU1O+ K+ɫG bsc՝:uCa=-
1)& Y[FDDxTƷ굒 Ժ][oi-[fL#W6=J*U=ZV_~]ke?Ek+OVxXz :|4n Im1h%Vb NwgUYԢZVۇ zQ]?^mY [n/-34 go :t8->={GFaf%V?* :,Y /;z!KIa% f߷Y֬[|zhhf% n$ex$%jVsPo߾ ѷHF; *UHi|MJΩe!errA슏 #8HLMpEPB\" &R n:y*BfϞAd1k'rK.-/nԩr+##CB |A.i3D(GhvBcSXB.b, re1Vb'&ؒh+ 3q[$ŢAVxXpi5ZrexxuX~ g4iB7oܴiStLC0ԃVBe ~fneb0yQ,J|6 xN :Y#4k֬Ɏ1bȐ!][n 62es='=kLIIɝiCGs.aWLKYrG4a%;S ֫ی%&&~ӦMs{W
'Nl7x1ol BBlРk )c UVeӸq ǃRڵBI"%A:HI=Tܙؼ#F] LҬ9\$ %6m1}1J~AJ>j
Hks YO9z`MFL駟YB p$bοFJ!Atg%i^RtYbx"%&J뮻|i(u\`q w Fa"u# +lRA?GR` +1}j:&*z\(I
У!%Ut..R!U3Z0o{JL֓QTK7n4aYr QQQFrKĉ%\C T n"IAI`yQUZD)h"qǏ Gb=%&JT
BlR'/y,U ,hR~QT Vr aP&"z ( /..3^_ID
=LۻJJL֓hZdNQ 4J"F4 BIF]1w+ ,JI>Qj]U %Qv8hukPVb >G}CG.A-Z`cСdc J0W^yu^RPҽ
2SR1;>yT6,JT!6輟ycuj@͉ L<^^ӭk*M ZTdl19e
7`7b*+ر#::8Uc كڨ`Df27%1 =z4&kU&9>5t醌sTb+b^{i|I
AΙ3 ?ly4?yQ;#=xcq(xn֭ C];gVΪDa.KM*{ڞtDe˖lmc[
{$ ~Z7r<nTB1YuG}3̦, u
~Fv;v/ZP{f킢o}yD[/9UKW LM]RV2S ,Q|v8X(m9"W^)B#% FiX$YfM
-2yQLTК#mUȤ
m+/;oo9#8jV9s&
_:y@EbQʦ3f71Oʉ$V]$M ^DfH6&n.a~(ԑ YWnmY 9 qf+,0 `kLA 9U#%J~fkxn>kg~2wn8V,:eHC9˳K`ʰsN A}۱gG aL=J?/JJTTD<G -rB⻯18PDe[\jjjѪY?e*;ovSp ^9tKIJ~-^{7pU@S ,oo-Cȧx0$P^G yDlTqקux^W_1pطq}wN۔0yyizkS uϞ8N cݰk6LOVk}]͡,lG 7~gYqpˋg`~:16]p1+QF_paY?hr*Ca #ġVmnX pK2^ ޜ3h)pX5aÆ`CѯzqÆ~kժ'q؍+fN.0R %BIL3n]F m#Q1_QǓR>9z]ʜyM2+gib
VDӜ<y2T)XHMY"q(.
bߣ}^gEGwG_4_P_.^zG
7_rf <іq] Uh#jycܭz P 6 =C+Wft {w g<Lo©Կ;¼Zsh(pwU|'/JڻwolLԘZulhԲIo{ս3;=^us$u?G))sgIVWZn(PD qg 2%T
< {1U& P &z8)n)Qc7Rqt
W'aLrC{~0'\+ Xtެs֭cE)Xy!+1%f6bu@GCqpog584<P4lؐ2Nt4BI x\ Et*Vh<GX|\uk^dG])U/drfRq) Yjf8== {X(쭊 Nʅ|4.-[0Uzuzxƍ 6yl gv YQtrq> }HKrw3X{d
*YS`J SSB{̏ 4a +qɄrȐoL m_ 0>3 w ;><~_S/ҒѹctLݻΘ18P1Yf@mZaw(A Yߵ3nuI))ŧ$+ ]wn s˰=9HaiWozb =P3ĴX8(Ez7@f%˗DPiwө FJ$KbpIwh?.;EkV]U[@I{]K_ugM3"O)YJe9G֎i)ZM(ݓ_lӲW
O8yJv}+ϿTFzb+/S=nQkё%&KS@,,Xv{bf,A ! (tT+.VٻWQ5_Q=RL
%u_V2* `m۶ :tG_d%6JP222YG sn}<
GaM>: 54}t8k (Wι_ k" }~\L6123 _gD@J;>-9o& nra96
%"SvP|7tMYI`;ziӦmڴ ìtE!(6 5ֶ_l"lqo.2Bq^ Sn8LԙhK}[?snj/YI^?\t) uܙT=D I9~8H_G]ݟl@(;%a/|>c7$,x
[N| 8`aJidJ` xoӁ 'ѽ+
Y)Z ,Y=ڵm=c3 ~p" Q0\î+QW\uUV+:
Vk˖-#G _0;Y;<Eg[*4Js}fOUp
-{b3T3b߰?2.e 5jJ9GZVU (s: 5be P8-цk i5tG#a%$8!+8s3fdK\yjWe[M]S#wvN>_q̓3cڵcCY9
ˊD)qYɪ1v܄ 1أp*ţ7DezUy&B1_ ]Z|z( 䋠$ d^ӧZƧ
<|Ïw _߉7WNb}։ζTy|TFEVƑKʋKzQI#KzHlsK,sӤ
IDATbn@AVb*[, dZH$ QŚ=N÷S8`͘3n #9pDp3x2_;FBx(e(Lʠ r1A+ػ6[jtHQ~*rczNն )s6\J#:Z/w洢uzqvF؈>4]ewl>݉!7UYr?R,SO(i=1v9(R:#I٪CG *0 qRYuƉub. uhOwWP 9W/9 r $ m0eDҟ~#
-8ʁk]b{͝9%cziGg~pȖ·?>;~Ҷ)B]Gp!qUo< l{ u|է'Y)#N
Σ. Ӭ ,LI){)a@As
S) @0W@6!?軀Emxg lP
+JrT
d`ԡ' }` ;x'ueMlҴ(2Nl J~$___-C(:C13ܹ?Cg_8 ׳93oYg3 *k? $|Viv~uƿ:(K NZ^\Աc'-.!Y(&R|y`S&V _osQӊDOоۈX\`pH㏥/L.[9PV=~C[YXB#^ҍ EVr[=e%A"(1ʽ RFC :v7hqV %pL
W)֎T~r\Q#i"4w: ^xw<utjW1 .uܴ,*dBL0h3) .yLz%3Նdzyl8t'N:|%N69tв Zc|_G\:._ϖ
.W!L]HJb |y Y bBD3-1iY@d?%G psQ~~. GLя bUnͅIs>J2F
IINQɼf um Sf? c 0(IH?n#3ϽY2R \$%3Dzbᓶa̕+W4M4bJCg)v6EƑ)Chi8yhH]!N_Z=u-3'.RR>$%SjVfbYIlKHH u7Wvɏ ; *lX+uZ@@=Y/1(44|+k&/JN4CB`I5pˋ)4?%E)l;8(2>n & >|.ir+IGzkKB[7\uzқK{9듦:E$C-AI J^nNmڴҳ=M5p8^~NKoE$;x̝rNZusGQȸu 7ʕ+D"QJu 7rd5+yIK0lfCޛdHhWW~ h1rNsH$%f%4<kƽE_ ye!&T~[__u!-U/</]ڌ-PRJ$#AY]J4+\L)͛7'tʔ)(.>S" %19" I ^Ob(g[L/y$lZ)>VJBw);fRI2f-}G{| Y1Wdt
oe NV~۹;BpL,](.[b *iΎNFJn
0J4IrL߱<oD )w~E$aP|V~Bq +S)%n@IR~0(<1S` ӼEc;W ?JR |( TJ f%?_g1{+, yu{Y٘d٬DŽO?4}^3pMIȞ[" SiV*fя&71SN#.EbJ<s>5W}NRV%fA /bxʡ>wnє aE ߠUo8AQmPS$@ 'Eh0" 2PpcYժ\iQS8 ·~.I(Ip$W2pc<H6
hV2 a%ȢbVk]ۖ %=1 m{_Kh,"JRK%pGb$( |4+H]+ #1G$`o۵*}mx$#\|AIH8EI `ܚ\ۜ(#%& W 0{g֏w}Ӿum#g8xXknƶY}GP'$cRVkVz
(AIy]2$ӻغ? e9K螩>:^_$d#!&<FJ]LGƷ$hzljOgq Z8N 3]pվ~X^*,=Oر3|$ )JbM6-6%f%6G#P"&Wn:y$p;T
iɱ;JKtϬD
)VBJ
%b &&3#!&`oQ~ќI$<fgOBIBFJED2θ!"$jV2.r٧9ϕt9_8MAC"E&$Iه P?0"t@_4Ө4qi e1ݡ h,׆ARxIIe%c~@Gb Y ƶ )X '\mKIT
#yIL"(n A 5tv<mڙDQiF&&B$Qa%8Jbb%
Bbn}fr#Y)7&:D#P," +1|cACW %(<+Vf%ίGddI,٬$ J(rKT>Bt"DJ<jV&:-Bᐕt &ؙ JjEڣ2}`"xGM>@F\qđG!$WXt6-p
7Gm +ٙ1h,[: LFJ" KJ,jV:a7q %_YI
XO7k4+t56C)\W#0)LZ1:["YɶU 0)LZ1:["YɶU 0)LZ1:["YɶU 0)LZ1:["YɶU 0)LZ1:["YɶU 0)LZ1:["YɶU 0)LZ1:["YɶU 0)d$5,%T IENDB` httpd-2.4.64/docs/manual/images/mod_filter_new.tr.png 0000664 0001751 0001751 00000002456 11035423623 022431 0 ustar covener covener PNG
IHDR K PLTE 333,/ IDATx^1n+7 <@0x)Ҥqb2УlJ&XyZB wE?`ªn 2(ʻ
Q ^JT /_Z>(J(JR >919$Һ Gي(.p e(ڃ L@KQ@%xϋ5̟QS+xFUT4J%`G+ëD0~1QȫS\ Da*bq%ܧ;m&Pv3BŃ|"$ .۩Ɠ~8GL@Sn $Dmj@~D(~@_Ost)l_>t骝&_ lNKE@:ӳ9&U9BAB2TXA#R% )x@w&0Qs_u)Q QXD'BFr( b
7N7>V|3N`CAo2Mt1OFVTAu2_8s{Tr=T&r o~6 U1(y.U7ķSuS^F VQ9H8P
P &%wuN
4o6!$*b|CaEQ)[̦A<*%g 1"i灕JPEKtJ!" NBvL\) Dg[R7x̧
\0pQ(c*QgfQӦR|%RD/!8!N,*TMy
T;0 ;} h
UQ&5^+PMώ(pa(O+Rmgw5.S\t};k"+S%R,?jRkg"vV vV vV kgM) ֫L)J(N_ՖYmH22J0,+UPMHꗋQgS.Z÷3M)*eP. ٬.Sv%h%ba 8 pڽ)SRyMJܹUjQ$
t(T}SWJΫ5lj~:1<#JS u2%>Sq*C "XXg o=hPSФ"SQN<N`֠G-$~xJƏx/zQ13%BZ{oPw9L?"?Yeu2( IENDB` httpd-2.4.64/docs/manual/images/caching_fig1.png 0000664 0001751 0001751 00000032214 10671421551 021310 0 ustar covener covener PNG
IHDR X
PLTE %&&+++&'(555469:::789 4L(6H'>Y1;G>@B=CK4AQ,Fe3OpDDDEFHMMMNRXUUU]]]IOVIWhO^q]`eLb}ccdkkkgghimqoppssswxxIgLpSkPrOxQzLy~[xkefupXXYZ\`ycwkagfmkcou{tspx~vs{z~΄ێޔܜ֙ٞםܕڐх僳댴㊶댹킶㔹哻뜽䙾钾歼̤ͥԣ۫ҩ٢жƳʻĸȱСޯիڵͽĺ˳ҴۻѾԽٶߣ^\ pHYs H H Fk> 12IDATx
T[םQ,msŊ]`
t;۳l3IgvR==G9gPyqlg `{k7J6Sc$i(UJԵ,i8͡ı,"}}6 }> ~}[!3aY & ,& ,& ,&LXLXLXL0000a`1a`1a`1aRD+ӽJ6 inuf:| 5ײe`ͫvn$1X%u@r#ᔼJt#
Ac G]p8DYrlX3ʫ Hra-t:]0/q' n۱v݃@ӈ\]jk^a\/1|mcb{[a ȅ5b ,
ZDi NެsUk$MT
6hj@ hIۚD6j j@Ĩ4VkM~A:zj\ VuA..%tܤz\K`IW\j<V=|U47ׁmh%
^vXDi^1̹.p$ +u(`a%kJJbQAC6B&8on})0B
ͭrKU*/dt1Wv{H6%-W.hr"9-& E
ŭMuI&x 9 dt摆|6iLR ӕ ?5ǟ ɮ8&)Xk1q>ׅĵE-ѯ ?qxW X+V^ /9_W)V},|_=[ ZǿjקdsUkV fVWR{P5sWxS%xG c/< ) {o{S9L鼯Xlb *1a)& ,& ,& ,&Y#ńi,&L *00XLXLXdJ$#čl2
GCagmrmEq 춡cg
E;u!\_$a }vPoX'_p##vk/u?odnu_WbFahԏg ̚Tig`ݴ|xz@OT
_X7/xhp@Ou4" \ÀsU')|#tTR7=o?df_Z hP
F&TiO}nbϬijW{wQ=hqEOxCi F ǻ H⣏EFVQނGݼ? k
| pFcyE[O3Bp62 K7ukpOQ_i
eGWj
N`C;#9oMCLL~
=m)c pH`Ԁ*Ƣx-hin<' j̝ 4*K +⡵4zɧ{Ni6]#k С.ƊxԀ9:knOPu`)>zh7l; h)8^س' yb``<>u0=NMnr;<)ot#D 0.ㄊ}m<ԃfxWl[Z8.M 탨O(xv}]GNfr{E18Tf
`mpަ{;;w :
cƓ ?fԛA]Jah&ž;qꈢC 22G;j wP0m}Gp`#mܹcGω* MB"
, n eFp6A⊞ى}Σz3Xj~>ET8A
tA*8qRlhi>ʁ菤h
2D6<6#g>xhؼb Q45 LawSNܻ'rޔ+njZO .p
N NVOQu({ xDr멠D7OkJ{jF=(cw:yRSء
B v;SZ f
G?SGcSs1ja7MhS B M1L@Ma?yہttPʊU e]9/`$<Mt(>L9Z E
M6<E )Bذm3d=Q(^ v6Q \iJ;lj*PVIlt F~i]G8 Զ7I@`[qM~Dذ
ƅ*#5V$`##xڶàmF/[\q -KOqd b8uz&Ti~l'AjJqҥq4rK/r|͟YYQATѶkx]%>Y VwTUorm*wO~ yp6nş3sPFK &/I1t u01<SX8igVg"r4)fM(i2tti8Gś>zL$ i73pm 5̹i K :`
/ {ZJrO_84~8n z`@ Q˲p +O3zٖ]ˌs{K7b7mǻD=ŝNh>:]kgYr]O8 _ħ&
,]Mw3/E;'pS/vr0v{!( O|hNr˘ɇӹeP= dp j~Zq:Aѡד5x4 i}iO%tኻCz` 6Ht"8p EGvtEGˋRO랇8Cm9H|1OȴbOS.v҃H_>e`)%ZkPϩ'=>u}Xp'K1\LŹ T5m;xM "W N7D
6\iʙJ7jLw>PO zk4g*%6 h >9cPU6+N%r=ʜ8?b`#֞<tB)?t,cM&'lb!q@F+|tѓ )!kn'\t cW|N_aMr_*(-DG IQ0VJ2w9k@w&Mݖ]W8цT;:qo2kR #p DJ(,3 2paQfI-/AT+" `K8hfc;Z7pMU!Q_4t"J jWĜ 4 (z@J5w, }iBYH^džU@W
4+)hvFwON 'x1JWĮMǚj (b"X) J"\ 8,Q~ɹ<7/;KYRRcCvn V&9)zț Dͭۻ, cʦ\HNB+ūM>+|d4*QڗgWJ >zsdIt).Ӹ>6wdOQz6c#XcM/p {]Ww<-Bc^YOR Y lvh
AqՓbXr- 8ދc hlp *6.G*X{4)ܼǁ;M!TIoދ wUsd @|صnzrhсBGҥv0N8@B
h&
.Oc)WL"KP?+ύ a=*Tqhb0%wOBm@87\hہ ]G0_ѣxҽ'
3
V-Y[:wB_UD 6j C<v @Ø*ݩNK]c8nnR @nb#"(]X`m X*U 9;< ưo& ض λ$%Z4
Zݢ-sǮ%<b0c.`zbww= ٹyAJMCc3gi}H1J9*03(ΧV xB .HEm93uy3sBe&Dܧf ePez͵5-#K zvsq4Lf1|YKgQe$8 +~C{V`qf= g)dfF5z24bÆ`=0zcX3, (yST[Tʔ$, C7oNU7,9xc*R[ l __1B(DݬhZi.$!\2ymekǍ{> Kc
a. =YnV`RzAzZdzY0:2KCصW:Mɤ06 MJoqCi締
6*VE#\m9K^8P>4SKv !`ˮU K2VCPۧ QT`:87Џh0)듌֝@<$"iw)9J7e%zm\|ޭ6qLj`SnX*EPbw7nL~Sc]1+f|<̞9sE7XyO )b,{9ڶ}͡(y-|; 9ZSRn7 oY L =[vw}}k vfuqd6~!yWTëS[;rwcrqIqMm}ĝ
s
S3fxmn5aAWkw}oUТӶдO CfͣYw7 b'Oq/~;n]s[ΚL+k?ſwܮլOnκ;W_ ojr>ş\
< h2}Aj W:V Z澪a|:r
)Y~1o?p緿U]S߰F9U-p d(*0[|[ʴ|ܷ3xyGi $cĄe+ʾml} |Blc.s ͑u}a\t;6}
HDȬ#cEFm|4zg.Pƻ}a2m9_hE{$J
!6iy dCLx /1U7W<֍ .Ld ԕ/RfzX7\qX1B (2Z $)f1EVIFΦ~S۵/z
VZL!kNipmt3m
0J(f U@c"(wq݄Rۚ| =|PW=t71d)R VAR :=AR<`EBv݁{G;䞗XS7zڡ;9}s1 +`-pkȀJ0 bQ!={x/+o fI 7* +{s(^"
,RMiλAI <2 y8,Q"7
: o<p$D"XXZըtw
DQ]:Si7 ID6ZaVHnkI(9 ZIH70S8콥on?
B E ^PuT}Et4+Ƈz\iܣtidt ?e)4wD%X8 P
RcEB6 $¸Vl'7рƊCи$!>`A 4>¹;~$G)LN
~uyu +{4&}Kr@8cZ+c`
;`ÃeZJ¢¹\-=<[Wbpr"\l
5Lcy}ٶ ? U:Bخ0 1NM<֬Њ+=٠_brPր59fm{XZnI؎~7`˷Ae$tC6h,܊7n;"BtZX,*9X#}+b`-:Rlg20=sABk
ld|5l-;݁ Vrb +, lQȀ'{ hؕЩX(k^}tYn`y!<迋2iQoP!0TnHXx DY6 N4XaIqǿv;tGcrm~,YiujDe e
X(Eƚ?*LMHD3W]WJIgiWO^,JZp_X+O
'ְa%װf"!/e$x Ă
<@VXO3l,DXEa= ,V+$I;ﲓ+X"s+(;'tw(r; ,"`-4ؖ ~| KkסZJfLh0RM*X~ky
9qZjpΗmC0["y]Xs{{ɄԼJ'Ů,Mb
S Fm{di0f
oVFU;#aC?~>4#V2wk ɾٸZX1xˏ\X,*L"XՄd"ySmp윉ky,~,F}~S3YyO߯Z P[&DY *P{C
e-ϋ캳FT Zaʄ~<-!ɋ)6VXd߯P`ՄgjBe>J;HCJٝkY)q`jB,lW
|e >`}G
nxw:P[5U&Hvwٝu'J`,D Xc9'ZሥTLֻlY`Cl:X2oՄ7gf]:Xv0-ZWH(X~;pvMN2\r kۀJ9Sao䌧خ5˕4X´+dMCP+ jBCũw+`4+ `fR
VQ ʄ)F;8n3t(,V!,LK25`eCTEC< EbQa2? ,0pI0l5w.BŢB8gh eś´^
' ԀUBDX˻8|:M`ZaBWw7|1XTT5jo| ErAUB MDX)6]FFߎ0h]!|L8b{rM}_{TBRW8yGvcky#La{j7t1NXV~&(˫awO]
Xxñ$bQ! 0X0`}\>&])d$ȝ
Sd Y)+jW0nMnzzj=Z~ISP({uokiSKTEUe+X eݽ
hX,*4Xw\zzvz5>Zj{n,7UMT8^FX%Hj_J
FJv}r镏M`%f
u?:X1f ao<#֊BME+`DX%HkuVVֈ ̿_B5%55s?(`6KX]`FEtMb\e6\(1^TJo4mJЉ:ܰPr ԙQasUMfsC'k :f.дvwquW5um i<dWzP(:QmD"Mx^]`pK8inmNOyōOui-6ʛ3n@k{o>,a>P YzQQ65yPރEW[$rrU~cN}9 uś9MiǛcPK%0ʎ_i+ LYyyN#J"Z`<G ѱ1V
J Z[ uujW
bX17P`5Vb5:]
Wi%T vqkDٵ^[䕪qMF %bZk9-Չi,մ&_+T<J$Q`&P2z!(kA/~:)(F!xFJl ܙ"
^H`eB2b
QF:k1b` VF4V1U\}B
q^H+Fdjsj:HC<'VA}HѬ%VO kbJ'yϯaS!!㊢Q9
7Up(
@TIRq#AqX62wO~"Һ*y@S,M_U YAQz|(UCުΩ))@l늂C3/l
UJg{~AJ@cZ-r%](JAёnHS$HnMC^-륀ؔ#kjDM >BNDEՍ6~IC 4S(7j۰qk S/k. 7-jJ! %o5&I,݀ W۹{ߤ&+ bX-
V w3(XE)ڜ#z0NKvjEs f\DT)3qHWy:$uԊڂMR>u/%
˂mX59UyVX
vhA^S c)X d 0WhKuUyjЃ쀮kܲ1P55[$gUc`=N|3@mqܳ.D̨eW5 |O-B1%!i
#vmx*b`I>꣰!em~Do<$kŏ(KXRE".~I+w}me9Sfc@bR [ji 7(+AOBw:bҬX 2_E)uQF(;rVXH̉1dDcE
m
Ѣj8ǁȹ VYfug>- u+WLO;3D*LaxW`e1Bh pX J7% m|ZI ҰCo|!,ӧ_64r55rjV SVV)\%DU-JUHЪy 7m$PcYu /?RQYpR1A8h4] +Q%
/wps rXQEN Q%XzO?"ZrdޫVޢZdGTm<
,z
A% G5콥Z]`zs~,UX(`A7mJȽ
4V{/(VCi떵 n*`19mm_[},MώR2 {~D'XXy*_al% tBh`-B V.UƎmf`1 +` p_[c V?N!X$o߰B<,bny
+zS~R_G"CmИ^xl$o}3f
U? n6
ceTc`_[3+rPv*`1=`LceR5i45EhLy{Ʀf
3j
~e`1}! `;p}VX +S`͠
?&SHb룽:-Ma/3Z
>lZHuީ~<lጿ }ר
GھLFXau~S͔ܳ2 $:(g.Q;c*k{6?E){ |#JN*{Xvީ
{x
K>XG7%u
m7j,V X6~ãoK 4U~UJ
doIu0`}H+X_Wn1RcM +_!2c
ួ|S
u&]%֫ǸƨX4k=HC/w-}L1X_+D5;zZX0S`Ϙ,|k
"C{o}mD-Xl]auGhˣcy Us_[
tuj-aҢ_y+ =o4fBca_ۊEVhШUZ Ys~R
՛D|m۟~-ȴW,#JNq02+TtJ~[f# mVxn+o|܈<j#wn 6H2,}I^Af\~e,o-}~`nê+l Cv647]#ޑ974yz kk4ﳄ)~+b`g}08v h DuU:U<Qa
~jܰ?uP`E~_X+5F:B6a< *$V% +g ~ n
`
t[!jܘ79dyqEn35NYC~ߐjZla 2uȪ>'
۹a#51},RNwQ?
ǧkǑY/0sjX^gGKY
ɟ/ɛP ¾ܙtP8zmfY egbQa&5ܡx.?£BMᘽ+e+{AZ "
`Wk
Ӌk(`c{Mb 1mxSHBtylrbغh,
M/~w',a7%R V&-QXiڣ°Uw\NŢ$0X]E LŻDC<w#"~. ˞ ,0`+~|h5a[6LF kK`>i/~|hXgL\ۏ22ևDžMߠ,WHBE(זt gOA 1zQmR VZȣW&' ߭#,[
Uix{Ni,
W /#M!K7QIt+,٭!
oH( ,/>yqlUbE贃~`|V`7* XiLEak%ŏX2
_ ,vq&n?M3 X^?~v^WHXsjcg \ ,{z5֨e(5pqזJ!Vx`|9,qѹpޮx:+c`љB~[%BɄEk ˇc~H]tSm
b~i+r_Uڃ+L њzuo|=b&Yw+)\t:W ,V+L3XVΰ VƄ<Vd7tIRX +`ykX,ݐL"}+,T}\;Rx&L?XlT53z/j Z!pJn
֙J%BJX R/NMc<PRҴ,?~~^1iY3҂`;>;KRfM>>|~&k eB`͕+\YK~f?VĞ%y>W,
0Y,_bdAnXLXL
b`1aIXI@bӿN==o~"?E_ ԣ?kyyOߛ7 =?[yz>`,ӏ?}Ǐi<S3_wzݳ k){w|'8_
0a`1a`1a`1abbbńńńrbl 6RD IENDB` httpd-2.4.64/docs/manual/images/ssl_intro_fig3.png 0000664 0001751 0001751 00000005010 10671421551 021724 0 ustar covener covener PNG
IHDR C l? sRGB gAMA a cHRM z& u0 ` : pQ< PLTE̙fff Q< pHYs + PIDATxKr8 qT S57fAMKɀjulYq Q@iӦM6m?1Nor<9)TPkqPy1a;J( cm p/;w`3P,+ C! 77P ChQyuX笳puϩ X`aaB~X{YgYqk@J PrXqo%
p IPL@1(egQMEX235X PM<c4,aRP@(4|;c^qHR@D\2 UYV=fzDOFI~oP=
:&+߬xśU_/ vE r%LCCNbjHRbiV^ˬ O- CxeiQׄ;HHGw$dQAb&I#1 CAYXH@L)leͱ;ƦS oICē8Q0 iMg!Ob8%eNU %CIQJ9ág-
!SG:%+ ~" bb{G zN$mq9kݡ}i/
Y 0Kg~2=lϲÜ/X
exf&$U 9 <Z5ȴ(
$DRri2rDp%&*%#J&*{BJ:J</2ҾL
T \a0v=FrzJtQIiCMx :)(TTCCv< a%C.1vF2LeEġd❡I2OBc2(| B?F!/AɮS(뜵nYzbA 5r=ž$Z893嬳CM
%PB
BJ&fF;P>t^R,J X9*(`/(jd+` RcI=6E 6E6H~6e~D{?[!Q?ks)oaoj8}^ԱEr
P
P
P
P
P
P
5,*į. S[A| 3 ns*ҡڴ&UjQ<PTR/~>qA^PHH~'#R( +B)Be Bkw.XDS%T* GJOPe
(sJU$rTQ>V;)5N+&1OKd9lJkA6 Ioio!obZȜndFlS T?~.MefSG۵Px|u{MuXR~hSB]ze-ٔ<aSsO z?nJĪβm-JשUuM U(}p=U]6RUX
M*b*TjK:/ JHDԍ] W(J|Hue|d=xGQHQM$PjoɦΜ{)OXG_K f3PrTӌM :D,)se ޥ,("柳EdI-柳C)JYPD]g=EAonσ S:f=A OO`eR(R(R(R(R[aG5UBӳ)*ƨ$ZJOI^!IRYh
P
ʂJLq+ ;3AI=7ALq(BCr_S %~ ld
#9]0PhA,` 5p}&~6 8ަ"L&l*Lo 8AR~ Y]YUkS`MP36JR<{ ,( #Xؓ65 P`T(8
s \/=
f
5BϸEc+B)B)B)B)B)B)B6-)NܬP@1 faLT T[!3
ED!m
P _5A5&A
ZOWӱB)B)B)B)B*#v'aY4*Q(ғBϵ[P>6_B,j|W@[fDRl~m*T_~"%5
CU+&!]u (.!~61yH6E &1v-/N 6}2/ީ ~N bxwktӱ_PnwkP>?;K%u2ԭ: 6mڴiӶS [ IENDB` httpd-2.4.64/docs/manual/images/right.gif 0000664 0001751 0001751 00000000073 10147723030 020075 0 ustar covener covener GIF89a s! , lcrJ%6 ; httpd-2.4.64/docs/manual/images/ssl_intro_fig2.gif 0000664 0001751 0001751 00000005214 10147723030 021705 0 ustar covener covener GIF89a !GIF SmartSaver Ver1.1a , PI8ͻ`(dihlp,tmx|pH,Ȥrl:ШtJZجvzసE(zn|N~ϯ%SQbŮȆͺO`յذߞM^۬K\%E032ȈaD *H1#DLxLU$)Qœ2Qi䬗H) ʛXIEfB?9
Yd+8o T
Ѡ jt]uIh+ zjYwZz։ˎpFpAJ`.ݐTML| »5#C- R$o;zSKR^}Ld 364<7#1+Ā<7cܼO
s/WM;6l+j5 b|ߖ`5D`]Y}B
jIVcWa_f[ BWauM @"0ymMk~9]B8ckx\q8X@,Vgbo#EM $ Yh!SMoP$X郖f}4'|qz1yd3f)h)c~4f "$n$ru\r<K*V&jZ b9;I$l裧0Jj ***嫩:`UFk"Ϡr&3ƲjV,e\llr8':RL/yp6ک®Ǯk:9qyƘo2Vi>>p.ʣ0ŀ s8ttziݝ,s 0|15
|b<9gupnYL3^x3Y]$25N32@KFBbp"wm:퐊j}RH'J x; / z>n륔}y@7пJϤtӤ m 5ʫ $ ,WU#x
$'3%sT ol}_#>>e>g^ï|_Ni*Ck" g.̀kP πrg+ nN )gr Fp3 sac`u
Q Qh
0%7 C'>1H7E*.Xb9H/|bB15 h/@:x̣ >Q IB/L" !$'9GR̤ YFMzl%CIR<<*WJY,Y$.wO겗 &$)bs<2)b2<3Ijc̦6ŗmz&8IɈ$'6iY}v|<e@3!&SB1pg vO|~|Oj:%!!'A =4WD:7B._ĹNi;iA
撞D!c-%THg6"33;5Z;oXLA*8;КLIS; TR>'<~H\VCS UaXZִ:]UP@iV(G4|G!l;lo7?B,WZ֘fzhyњv=jYպ}l=ږnpXw=ry:W}tZ*ѽv z8x y?Mz |Kͯ~ LN<_N2'L
[3{ G
(NW0gL8αwc߸@ HNl%;P|,*[92.X^`0hNsѥ653L+˹xs>y|mc6jh}C/9Ў1;)[F3MJ_ t|Ei C6/AiTԮV1WPԛ5U4չ5gka 1ymdήEiZG{Ⱦ6iZkq{>u{~ y{} ?q
;\ [ Ᾰƕ {ȟґ!?e)OI8Ϲws5|@q˃Nt Hѓt.P ϣN?I:^9}f?Ӯ ;7._v8]m4}6{ m/m+~ތ /w{w G}<A?y77=Þc_u s{۾=-ᏻ63/_S>]헺45O.Ͽ 8Xx
8X? ; httpd-2.4.64/docs/manual/images/mod_rewrite_fig2.gif 0000664 0001751 0001751 00000004771 10147723030 022220 0 ustar covener covener GIF87a} , } ڋH扦ʶ L
ĢL*̦ JԪjܮ[ 8L.gΖ;PS89u9x'LJ`8F2)3YxHpi`zziyI#+ !W
L
iKiˑY,Sk-}z|]6=@fv`
!| ~ * ??=ïP^{i.l %gC!~*yH+@^ƠYh@R!ԈI{ D~pGćK
kZӦh=r
1RtЩΗ<<֎ &EI֡f*ZUlp@kvOf$'ݧ^9MР_j \1? AymPhxi%2砅{"uahG*زԥ1)D)GG0o}uao<%롖H_mf~=|!fZC#|q`jW0@` ("we
0hn PX{p(b+hb$" (046 :Z` c(^E BdJdG>^^eZne^~ fbIffn)%Vf
fl)gGig;g0g%*hjhLĠVy
h` 8ʉ/az)[(-kb^)D .]%e LYT:hjZ̝"\.|fNJ&1gj-XB- ~ GAʧQF3.y~I@S_>O?w"W\ V*5חnE7Wq2g/ae]&_Ce"vՙG+u7΄ǹR]}&KGl ݽv0mqtOe!GXr)>|0_o_ ln ,Tm\K5BV jt4d-vF[c5v Hbri?Fiւs/
I
*uؽ.Ynɀ? Њ0y +fۋ.L/j'BD ᠢP,aVo9 :f~~_OcwA߿E?{/ M ^=8` *00E&h"+i ?@ODpAP! _pb i8C8|G
цSDjL|`&J \DE?pA_DP5 glRAP61*s#
1\# A@6-`#vd0HB|@"C $y 4rCL&/TN,'UJ#AL% I m/he,kHDj/ `. ԥ oY "\L!B38&5ghk0,&YLn9TyN5L%c괄¹xf05LVpUis$d8)
BoL?pʳ<>UC
#<& i,Zxv9|]"*-:*QLֲBå
NK6ҙKO|KCHgGN
4]F
碌'O&MMLzNsnՎt2łu9]m:g7A
3Ԯ/ۤ e=jQs};6:UgiC28Ņ+Z pi]̅KW͆0mժnͳ6r{b{ VegSֱ3t{Ul\q삎Ekgɺ&
KE/hs{Cs
Kz^Ҥ۠:e b'`rEn*QHjbC踯X-T)ؽåNUؖpm(Hכ,$)/qHF``q7#׀_0'ˀ^p+]/\
@-i,q<ye3gɂ^!
m/"^hB:4gK/Ӛ ;OP umj:zZ5W)ֲk}jB: ciԥԀ+%Qo=*L?4=R :nQZho;tȹ@kL+ *yWZnS
qX-Uڀsue
̭\^R f<z-F/4s
O1&u@n A[ 6k߂\dNu.k6bǜ4C.!70YyEcN\_zνO{7dNU58get \g(M&`;IϭB3F`*UF~Don:%upE f.R\0%>ZM{=wO?ԗk+oKԯ ; httpd-2.4.64/docs/manual/images/left.gif 0000664 0001751 0001751 00000000074 10147723030 017713 0 ustar covener covener GIF89a @Xq! , i Lre zJ ; httpd-2.4.64/docs/manual/images/build_a_mod_2.png 0000664 0001751 0001751 00000221333 11740644603 021472 0 ustar covener covener PNG
IHDR , T- tEXtSoftware Adobe ImageReadyqe< "iTXtXML:com.adobe.xmp <?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?> <x:xmpmeta xmlns:x="adobe:ns:meta/" x:xmptk="Adobe XMP Core 5.0-c061 64.140949, 2010/12/07-10:57:01 "> <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"> <rdf:Description rdf:about="" xmlns:xmp="http://ns.adobe.com/xap/1.0/" xmlns:xmpMM="http://ns.adobe.com/xap/1.0/mm/" xmlns:stRef="http://ns.adobe.com/xap/1.0/sType/ResourceRef#" xmp:CreatorTool="Adobe Photoshop CS5.1 Windows" xmpMM:InstanceID="xmp.iid:E0CBCE737E7711E1A894F91A1B262053" xmpMM:DocumentID="xmp.did:E0CBCE747E7711E1A894F91A1B262053"> <xmpMM:DerivedFrom stRef:instanceID="xmp.iid:E0CBCE717E7711E1A894F91A1B262053" stRef:documentID="xmp.did:E0CBCE727E7711E1A894F91A1B262053"/> </rdf:Description> </rdf:RDF> </x:xmpmeta> <?xpacket end="r"?>gaC OIDATxY PSg>77/) !*R(] (L]ietԎiw]RV*XmAJQ;( @B܄ǽ$#g79/'??M AyXm547w@k::n} :;MkeuαII
4Pv.QMwH7{{K@5!6"zcO\r,'E[tLp ] MSida==A.p"j@
sUme
O.ȥ~`2?zxWu*^HSt4x bɉ?tt{e@ E@e"Ĭ rZi%[S\/ڻ͠b`#xww:999ӗ7E؉-NA
eGn(mtfP[{ #֔ߍɄL *y7 o/yFZ0Ѐnb0\tm~؈Hݾyde6wnxsXˤODtں{\W`@ @w ;@OAT 5ɯ^8δ̎QzVӧZh5|nS-HA1ؓq&F Ù\HEʤչN0J~~-[ a-yj]UvtD=!{oM.g͗`^ \^v R[[; 5E*ejhFʊM Sluz ۷/==k
7@0cǶ^*?{8kZ㉀9i6ca<bߑ9j
LܑO}LؓQD<ʻIGi u!.G 2RRVKy *d%;j|5% ps9mat*iOX 1M ʈ=
WgnZ s!k A?1G;w !g 凵c?{heGEnj ~!@0l?0F0(u'S[ef.
\"mto93,]TΦ̙]ɑ;N \d)~rZ\\Z&<Bsd4! 1l~}{Jgnνqٯ/O -))@ LxV@[qfyY\|X;%di+oyuܐݛԍ(\8ͫ 1_ORE1ɓ')s/]?<g囬{6mCApSnqe{jU7fOG ALݝ66?@
k 1]3|} Dxn4MhdqȷN</`.P ENkWC>ݘw$16 `}s71E[4p^h}YI+Ϯ|&on믡x\s#;_ȽÁ+Vo{;֊3/y՞ 6o Ma֬Y8IƆrS{j(@<朗6SJ˵/: KzmQͳVq8ކy+04g]*M4|<-*As q(m ȹ3gL*((HtDwOd? |oko8r`p1}$v-}Ft!ڵk
燇[/***//
EڶD"-}}} P
hb#mTV;ғ.Z+jG!Wt@,xL[⁵ZG۪ "(#`mŊTk;Ѣ"(P X$ $%H hyٷoϿ~'GmsvIC=ŊՐIstb;:ʣDbc.!2b {LZ?BN4DяՔhT3^ª@T(Iu-%*[NLTK2*&,yuulV:>j ] % Cl`JGi wўo 2> 07^ ?Ԉ,wBm͋q}CUe%Q;x0)cg)3n+|(w r$1;6A<zV&u|덨`e;bl ]t- JGe\<_g7'!<w zjm!f:ݚ_SSǵ0B!WL:L;%b̫en"
ts
b LK5!>=q?}~ 匷ma~c!BiO'R jDyKo kMgcpFA ,Vu,^t1{eíML!͘4<1bz:nH,?Dsq~ĕ7G<UBoY2 HT\P- c"N744|en;E3( \@/QU r=9z ;|Z>fuuT#bc䷖
WK٤S>"EI~9K5n\1_<A G#J@B} KJ:kjnD-@*?Kt# 8xֶ7#X =Nw`TntPPЩSU"Nų(n<%%Eq5EQC't
r6 e bz*\]};
ȟjNKKMs)Þlއ9Iaq'@{>j$ AT"j)T=xw 0ݼNӢ: ڌfĉb{|ϐ!a6רmk[KqlAqmB%v6J]ޟ WqaI7G?jd45B@rrZLQOrw. $KYijIr 23{#zhJ \666|U;bh ?Ʀw%YF`N .pED')+, 4 [m`=T
JqP>7(ZR0SO Eʺ29f\}E ߲U(INi}]0B76l豲43!b2Z:jzM[յRo1y7Lَd4c: 9[vy0%B<o@ݨHzWe]_ H& |[[[M!M LtF\_dw; frMKTź_ʩv .)J@yl6{?y,:A"%;%ĐllAذƭhll `ͷ 7Z0*31gnGK^<kFf5U_'XC
vvv3WTW0-YStS$3%MJjrvq G=u>p눘 .7pA
}#G0 ا9x],SP45SbbKXJKKӹ ys
*N*psqQU{ܙ;+ 蠲tTD@iRT"T斄\eiZizd"K : ìv 3w={F٨#£2ҺZqeF?|ȡAmc EiCxڎd kW^``JeZt|wk\>f@ cjj~ĆbG_1UU}
|q4kwXw Qo'h 4;ǽ* Qb3F-F2u]d ^FD0m*~N-Tt ,ȁv`1PQ a4 P""0;6@6<;" nɚ 5r5@L
21` Q`3?
`9:: 4 N%ɀF@
l٠ 0ge
c 4g8w췫Z03g槬};}J0:1ݫ_̰GxnGzM-O%Ъ/^t ~JP_/G{MwmQnT0pN_UYAa^\>Y8>zlZw Qz4
@3Kuu ۞7_-IScaQrRWhD
`'R@PSFm H$"Wk)FSmmJ<[&s < ϲeSS^Iv
kd25Oj9%e9}xg^gTvjլs3D^} +AKS&OƎ% ܡR] [B۰Rsɓ \GGG: <%C^^_yx0~-K,' _[>tjyLe! ;WN؍/9dUKȹC)BMJA${VP1 ʑ
" !f/\kq,rJd3/ ox?8j
xB
ء%\~!1!;?, ~܆}AAA1y1;|. L~ULs ä`aSm; rb$ {M
SG؛)Q?E?ψBBnƌhD 5Ys
;z։R/`0222e]PrhF/ ZP{S
HMִ_8 j@FJI3?-0 F+XPO"Jk/[{
(MsY!ݛVk,Qs[!@!TmP\W/zD$%&8^.aO ncٵKʲo}7Êt(@۲5w)㈒JR[c|N@~oUкCWl{n
JW5(sg U[|k峛Ҷ,.9.D d&r(`R .:L!DvL'"QpO2)3GY͢ⓜҮh 3Bw3B3ÇXu 8 I/[ 9Ê>/_Szs{N8MVy/{zy 墢B}#hЕ» ii C 6\Iqex2/ ?7'9Q V" !]5i[BW= lYVJ뭟Q&m:&߲}E~}m>ċ/
w4|#r|=
nfNhlJ_fIay%v ; 3D:@D*il0B 3aR'{ygLP>u'DiR\\x?n'j%khh A'~̙ ;w?WeRޭ6Dd[~HM3RpQVh[O7~ E.e-ݩhÅ_H];+-}{8m*<dm_₎ 2elYJԨY dm3`2q7 yxҔ3#
` 7<-em \YFu03}ݚIEwl/ lNk9C0->8Qk"U#yasD2gΜ2F 9Gנ7RNn y:t=I{ba㕴((6P[| ՑMKͶUvI*A! jtlX,#1JE7t?ߙ(RSw[^w?nnn̏\<<=neji--*# W q6*3ճI}W- $1֧kNDQ*t%999N8Ab)1sssY(nxs>WH_&(DT*(LZP'}=.=27=$Ɋ)\PXS[~YW WV H[<,UG#\}Sfޑ*ܬI)E7 =6ۿŪU?mPù7_6t,vٲ.4ޔ53`HPC<(N)Fމ dT
T[3Y9gd*C,c7$g,b{bDLBFy..Eyp~.%$*2PpxiK-le1*
I-WZ)ioYsd۠j
/?DD]%+ hmmŬ0a͛ﻎ!Ivvv=cU*Պ+zrm0<<<tHїG#Uj S <<< (<oػ(-|g/ebԇ"bA&>MGM4)Òb,X0c*ҋeva̼;ݥX0ܙ3ϙsϹs>~# Q~HYYXP0X/Q.뢴l:æBI
S q5쒽{Wែ*!1, {OkW?~]|o A$Ym`bb4JI~~[Oм~rY}BtlEna(?x`ecS'bd3M o p¸Gr Ư ʉy7j$K9iZ5(֘<u,-d eLdiKH^Y3
;s8w@v }&lsשG̜e<˫"3 6o0'no _ҮwY H2\4Ai)}yVM 4&yBD+ u 2Ffhhڎ>CkK%ϧbac)b:_& ,/ŧzPS,x2\fR&$z,xyI%6+s#`bB-d=F Gx< o `ףՙ$}r4fkluH=4+$Իr~j*j)F}H)}ɕnԣ+9 ~{J/Q
Ai, z\kBie WYR %FYY#jqʍ rl t C@FRN r9P[V=I!Tr8/N 03
WD6m7.V{&bqѯ?Vv<u[)(503aVJP7ŧNZ\A߷vR d^Ծ)OS{R2 q|b2ivoTP1s#I'X5lQi%x iIF/]hjvkfhKMQE5T4 h_l%G
Ϫc ؍1'-̬%R)˚JeƜ^phMraPkBKAl܆ 1frU۴{]u:r-e2]aW\`CuU}z ()$ 5W=/wO 4X?h
(>3!99[` <X+='WQ(eYu+鴤qZ1k^b7ZDr
Nwo nqQ\.5FzQV7=Io~iX"3 emikm3ҕc8O ԇe^ */)`"iQSwijm d-XUܽG ܂B y z_MKkᓙa!z&˻nm Zf;][&ㄏ/;k[?i|Y:Bb8v
8^5 -4;oA7㚭5A~:K"qsAD'JJJf(2X rCc{g--u2DE¸nm^NJ|>B̢ѩW& , 3# A 2֢S݈;Tr-|N,jL.32}
߁z T1*FS=6e@KPV*Vqwc88YxsqQĉ\x(#W +E<9gaXh} t_ 0ritB. cYiBɆu}wlib@Vu [n_Vs$\.mlѸ * h+ZPBB'xϩm h3נAuX+j9 t§֨ZBzNN\Ţ
z @ 0xS=| 16mzz6+g23DTj^6f
Lz= I0g/FC_rttKSR#j9R1Eē#n\]o?2muA{Yb^Xn+YS`O="bmכß>r3/n}GŐ˧a[v3p |w#J#gP2N>=33ٳ- [[|4%HT
.EuY1bZWFa@ ~=ä)q$]o 0a8'uxv ʾo\P(
lN.܆x3S40pZQ.Ml|ky65g? [Fir4%%E
+WM%}۷@A.\`ǨY<puQWYfK 8z@1~> ɠ #"AjgX *Xʙ
El>U /+=P*9Y;YSNiu!p-VIShyyypҥ
sGaKo=3 $Pa~Z"%j}7E BH0֔:&T. xC8)r~Ĥ7q9ٛ=V|ы];'
%+M*b &yiݬܿwq[n H < @bzO{U45~U*R <]v;v[$>|;<<0Uox# hቤ
88|d+& `r1.qJlz._ 憴[v /Rߝ VΘ}R!1Ȍ, C&1=: f9ɰ!SAq* [czPRRRhh
kfe`mC}5[z|Hml\nCX
-[H%*FuY>tC v aBa@q8JE9ʡJjj2(;_ܯn˘
(p{ظzXQRu(
~B*K وm$!D3g|𡓓é\)Gȏ_YW(ܕs+X7ͪrdq ݰ lgK Qrlo
@(@~>~irH**S_,
7es6n"ʔ
l3sY><#hJ G B^.%0<p
ևTʣ%jՃP3:usJLՏ}NEJIZu@U,-}ĀnK<NoU$dsögJ٪%YCy,*.Uۭ[B3}ݺuU\Wm dݩ5RG_MOVb#j\bʿ 2klu? q;{Y|0buT!>|ڋ;YtEK#u
BۋxM_5ܾ|rذaj oYM%eb+3v镖|!KUL:֬3mWן&i$@HVyU!7d83#v(_yFBΌQwњK.Ǐ #Ov*^_$ YY3>G>fŏ2
"ڤ݉?yiŗV)(_; <Ŏ{.{>mٲe\.wѢE)V g$І65՛~(+9)A3u <ZGŒ$4.ArͶ&Fcb6 mzkd^A=~>6'V[5KVE|)=ۜ&p&r!gΜ 7>> vb۶mkxLYX}iYƢ(w]/]#"X W^#4]CeeeǏիPm^jooͪ> |tHT^939]mc }B9^Zߙ_~G b ac9d'u'RSS/^ Bk+$Q: ( 9tةsKĢ0'..SCF/t
:b}XbIoi&uobH!!!cǎA@/_x{;90ⓥ|&S
6 WTaTFPzI `ΝP;vP?u`G|Afm}'Kj)*Rb.xqa(vfr+++G%
1ɓ'C###/_ ,R5DO Y6 8> wwI`#ފ x2A -
r9h 1 9s@䝖RjFh.qͭK+qs*V "|
eO<h(4.@NZ0J!?=̣6}Bk&XM
z@JS:Vb2S[_&l}
۴i%1Pn
0P6
((I
ᖨ!Y XS.n*!wٌLʇ n ē&M;ʵ$[[۸%v8DLtgf#=d :pbf6"GR{fW??|`Hh`J]`<
e^ =8:<yVA7UFUl[MkAJBf=ED1J}D%Z5)~}V"D" ';)F k
ݼ??;ю'W ?r Z4Jkv_aaC[3nt[P?'8խq!e:h٘mZQ <ϝI+S3yɄ3fb9cǪ=e$!e[`[eZm ӭ7F4;BQZ 3ͭyneA㲴.\x7harrr
8':AI:Jݸeyʃtܹ%x
s5Mu_b
HjAy,\' VR+i*ɥW@ !NDTRϔg]݃佸@P@AgӀebd31363;1e<c6ݭPօ| S?ُ{9)f]Kp$b]^ny
eC'2/%
՝ɛnnP,u%w'e0P;z 5¸WTe\*=pdTʰECJ9uxɐU ˑ ؾ"|ڠ wcqA+ʙcBz$jTo&dW8|rA+˹s%K =zr}b#jeUd $B~WL:
s6$a 6@ř 9{jJGoSbTej4nIL,2MǑiH0WAD5,(9gsՋR|-/^_D G--R3 R*ܐYXr)
+M8@$#P&Jgp0f|'O|)**N̈́ d*ϢN>G &sM;Л;}?x~|> o{ܹͫs&tKTA^I(\2,,v
wm} --M,Wegg6ߥ5^57o = | J0 Add$4͛%Fg^>a|%A뀋{Q ]P+ K` XP(5{(n"v,
(
Ҥsqno;3Qy鲷ev?o{XnF(Fi:rc) S3 qMXflssD \>_'*.2ݬGm =1o27YD*H^Z*+++/(il5tx\Q*O{?[{
B1V^<y͛!*
7A8fp
j5P Ģܖ A} コ-tsrgGwiGMw4n @>o < _צ
DZa۶P7B[W۷vAf@=hXB"WOΞCe_[7}ږȾyg4Aj#T3/ t@L҄ρ{y!s0i@jH&ĄaF'#_iQ2~PqY2Sl.J% E[M+(ذNF(kDT R< /q%:f\ˬ 6$iigVe]+(,P}0 oѽӦM bEx}ً;2z:rj%A*[1ȠM ]AO0Q>/VxN B";^ĪO_N&fݸf5@iF] 0mH+Ȓ6A
E/&@Hzv&b@4q*6x Po}iQoy9SB(>upf|_Pj:G~5Cd*AmyH
U!*P Q7y~g(rb;"Ņ.X,J*yΦ 4
#`(B1
Eq|@@GiǮ0+ŻMK5 {e P0{9) M>p+Ex#!cԾFZ}ȸnZ+_w
&+
<u2r'Iqέ 1qA5WFܮ M#0ٶWھ/?ɡCazY/&MZ B$ m9|㥿DJ(0u煍|Òm %
.0bn 2@)ܲ<!ьa0W. e(OQJ:#dqYERJUld U inN*u
וa-+*R٩k`|
{{ZiSU1mQWcuCQ P/ΟՇT
5捂nݝ[J ˉgE)gOKOzu l4s/{?PI^K:s)OZJ9"Hӧf}G4%0ٹ6 m5344li ϗ<mF (:3*R[[똙Br洋9Hyx ! 9w[31ˀ{z;]s4zsktw[|Ppi1am d2*%~FS0$&t;@_ fCH*JJZfU-IqNZkFd7lnt~DKL1&# Đ<|U$O }M_d}Q>]<HKOYQ"
/5wԫ KKKD)(0h I
3Hx5+X<YuQ?uˏ?tӺ(r/M`AA;[("{Z<)G{k31% V@ώ&Z^ v!/V/=u(uZٮòݵǒN,?oEԖ|瀎-ח I?zrｭmS~d[*h>r-LMkNJeIIINnnaa!QnqBPT!r\GkQ L~}]E
P$ ZXX(ַeX <wg][OխȊX?:҃לx }yyEy5 jpʦ[ߪV-
܀{d2Y>'~Sš5Siivvu9
EFZf(FMu Bßʋ
2yI^ggOXY6254455p8P#ȷ?P 43l >tK N*iu>kiܴgBjCX W(yC|Ѵ\&:$6G3{dAAۈ+g2$M''!AzVV:^Ex Y+*ڷELX<I0LYoŔlWĨ7 C1doAvn;v]N-W EȒ]OxE'M6!t}U--Czu^TܬYṀ <a0t{/G
[%LZ-}lxa @fig-ÆbEYBQT'HW"w X4zFDzBP8Ӝ15c: %<A~^DRvbkֺX:^NVf6RT `B_".ܜTa罰<e% m!S=7 \ޙw =m:
#f˟ k?9h O&,[bB
App1sBV"SЮ3+?L[ JR̍{Jl[:itF~n<V44G~\.xr9Vh;[. {< `0ڿbPc̎S}@L,tpkb Fs#ju3*dgodr׀vob?bЁRuDx KL\R'XJع_հ /P円VZ[ZBڨMUDL]U!s-]
XKǎ} "c\fJU)^=PfՃJFqL7Г(nLwL;+ʻc_# N]
0sʁ\Zс\
e6 E*,غKgP&:l!:n~+ &=X4t :cc3'\") v0V f'&^bD'[ Jz?0CT1?+5tFM@24؋n89iPxh$|##uNska`CW'Uf|(WJJJ$ɻpC(hJ⭛^t.1]WWؘf7 )Ugi/ 叉J}y!EKMJuKc6Z>|O߿' Z4// K8賄EAi}Teceeuvvc5.^$՟8ʭu ڵir C ` q"HP 4K ט+L
\d*`Q5Id
OZtȓ}P ՜hv2Q늡!?µ pZ_m5|a>}X,tС˗/o(ENdz' / 9gFoV&l|X
W_^> 0Էۂ ?WMptF S0Pu
kW1X*[PH%7nܹ311qcǎݻwCx iz])T-;G! 'gcZsR$Z=T$ G |@P 2]e1 ǿ H@&zF@!*I@$
!e %2k'+ jCk-CC"##!622oolc;O4yg`@e&\!#'}{BO76 /tY;&о}[?zh80l666fʪkI^@ZN#Ss<|OǾ^5gw7W
hʫsЈ2 ƳE>J40n\%@֥%Ȁ]U0-y
Ul ';>6*_U͊tTJj
p(((y
\}9G \P gIn!@ \+QiSҫ@jᛒ F.QI+N/oYYf.>@&JDI%E*\g/#O&K =ρ4 u@G<s9yɋboҟ,(- /<{
<8;㤟_ p?Rd/Ljdr``222~N2Çyzz>}s,ˡS*ȫ~M}yQ~k昩;* aY_WOW8@)@* rJ RrPB#AyIgn_Ä5Tn_yT` T ma֡|©FMx1jg`v]eŘ<{R YWsI*cCK<ڥ{ uc
;ؚh/K3l(bGPHdN#Oal 5phhۚ
"*Ajٌ := l*JR\&U0l7mk9Õ3IKK;<TC n<{i,RvgbnCZ{qYLc9]'6y]ҢEdI i}V> 5͛7G[Jl?hfP[x 4ituL@\@6v5uRvH]I-ySTDDe 8L Git}9d5te ok6nܸsΕ߿ !)2e
$ǏH <h$gӷ,oe֭{ !5, nͿ4{[S wh=G|Hȼ ѡĔrcFJKcE)vF\#ࠏ1&>1}^ JD&y G QGliT
f Z zQY*1#M9Gh7=G s<R/\i=`dҩ\ia|Cv[w(`P~~ ]e*N>2,&,}"P2c;2k%2x?r !&pݽ{7$7T(58zU Ry(i,1swV/zM,@=i ۞Kw)?.ڰ|~x%?yrN*qk8$']r,<}A6RE* k[,{̭sC&,;<ِǰM/G_[c'99ÍÇ4h2'^?Rꄴf!
r%3ȹr ]~Ư B\"0 ۀ<Ͷ3P峳ÆHr<q6IWwi<%+WN +ر@5_Y|o<:I/98W+/^˖-T%\o:+b+5m#Τn6J߹[ع?M\E߽/+]{:YߊVWXNhڵݟw a;wCSca̟U),1`Q 5 S_2MR@EIhJ kɆ'm
9iuSg۴ŏ P,ܑ|9 l~7Q]~Xc̰Mg-}( - f { Q';[qT =z;_tq 2ķR)I'VQBGi4y$K `T.~Q T9LӀi
$UcJLPUjR%DLϩcxc*wh/2%(3$Vb>
m[Þ]F6oNm7[}ժA>jڱ0fd
}K9wB
$<_Ɂ[ב?}kd2YZÄ-M}t5;JKMshopR:PR~Dͭr ! T-Hˍ)/0-[P{X.JO?M`_ Ai@ē e˲~
ĿH'l
҉rx
??ݻoܸ^"%'=G|d'>FOOaN= iOߜhkƂhigyۡ|FB!
E"4B:eʔ'_ׯfcc: N SXMe˖Kd<e̢*Jg<}Y3(0۶ ppgaAuhд[]]o߾ZZ; >wP}uO8-I@n
?^mu|7y})"$5F\ NXOOOBmXDʼn \0f,ػK58S@F1v^:,5ȑ#!4^ڴiZ~] __UV}E~L8NHx&%"=8|djэB UpEC!ʶMv
x7/<WcP.8Hz,
Y폻l@)=~[fK `=
@GN]hò-r.*BfݤYU U\UMBB O:\; C|\8x"Ʉ#aZYX/EXfiEv
e)(Ëtefn. jcUs^n!=w\H߶m[xx֭[G
> wxHUM@4˻d}DRBjBDGPE95Pjn Iy@5@@pY3(~A:x/֮]}}5E7_TN00z'
ⲔxO%$uɂ+D9d?!L:}\`\xZDZG
؈}ڰ(bg%u ;NB$[ca}%
CW0V y 5Pw?>33S__?>>ҥK_v0
+ܹ0y*4$'j
h 9P᪉Rh! g_6!_U8{κ
a͞F j Huj~GScw\L`LCX[4LiV*!ہ:""Cx1PT_<aX;g&v 22~]ѱ&MЈreX$1ά~TPH`h_ Q
CMjR RVa og`X[[ L:E <1ֳ$I t]chGKO2vvv/.vƏvIGOj^ ٵlȲ3V#aPFYEEVȫj[566Sxg>t{[:h &t jZ
!ov$~0Ā\u>Dz8:MrQdK=#[J|!il2j\V
`)_.9ܼ(<=
GOh(y fi4h"j Jgr1Lp Jp2ǦcFerAbo
|CtPhL='XTXcRi^^^fFN j.,y@45UHF)2
ܶ666wޭEK{l#YO2KC8[ "TǨGm,<2nNޠ M3Cc]591EaS^_~sQ@OL}E9ly hk623D+zۺwa3
*ї bP%V:5mDOO? ]۷oײQBJԀ4T.'QjJ**:+8)TBE*5AW1L *c
KBQhtB96p(kk+k (yKRQ }ö(kη]P M33&4+.ȨY[Nlk6l/5 ~lB:ou1$y{9eoH%.)j)ݯԦh5wF{^(ER ލ>r?fD~ȵFDbkBT* cv誮D *|xB 9X,ˤBGej&ڔMd9,bޞpV
=Giq ۅ.
9 ^1c.c;ǷD4͈3m7`>S'SAe 8e30z4bx'Ne[r+ݞ570f AwHDuuu$E ftv(@>M
5ލ};Jׯ^hF$w +al!I$&T
ńBnB&-`۴RlRd 3ҝRgkLDBjoN`/C",kztR|zN^:cמ'y*Z^ -<rH)-<9<xNi7.y{] 5nL+f9.˯ݮѺ0eAAJrdh8liBW^Di?G?;ҦoӔDa>ʼn516Bd~g Wvqq|g[_t
BCC#"")\}
mjjɚ".wb:2I= +{W!ࠥT}z4l|(P#BP82WNh|RuPveW.F?<fQKImM k'GhdKwTαӀ$c䒢?nw ==aDsW҄6w:֥k3N cTV>
)FK&qSS2WV"U<]WsS70n9/Zx
*\ܩ!SBvuuN,Qd(ZjU2#=m>A ./:S$ gԀEU@NEDm ~oIT-r //
<::cǎzzzռ,4VX1}/rE###ss(lOxfVzܹs]P(ў={&Mdeer[Pbaqqqdd.TxB'**ɩ]v&&&_rF(sVVVpppXX$'BOOϦM~u14;x<^||<yU(,--4F(7J34 <8n8 6&PE(
|zI#Q]&hoC' {gw Gｉ(ذn,Qcklލn^b(
Hzީ1Fo77?o{&lV6ILP6ILP6ILP6 &1I(zZK@ ֎@ J3G8L;|h&gef&EAD Up9"c,D[\.(Pt:_3_e},|0qog˱b[G4yaF*5gccI)^WQ8v5k
\ݐW!C) g>gg۶le VcaTq UݏeeiʸBdnꡈإyKj_X}QP*_ ˢquLP6zspw͔I[6[Y9i PBX=5.W(32϶N(VRu{@,swNlw_q<̩; % v43#qj5Ū"en.écG ²z(Д::&<ٱ([ЊlǻvMn%Z,I]rr@>j9; k /
7;:҇@Y^$O5l,
b/լTW9J)`Ul%bWPUN6݃.W'F/ ߘe#]Zۿ[K4H*b$b]-
;#ʈxWF KỰ%$':CrO/LVѿ'
Ah -8A?]6\ Mdr {2\X 0r.tbW0h£(0ِ8u(x*.ݴӍ$VعK҉c ߀~YO i@`~
\hKRNKRow] ml"WA=7_(
zUo/vz01EFjܭ3^L Y`fJ6*
7A$s + :SxQt?<C O!.M:Wwif]FM>wm[> C|05.<7E2Ijv] bŅƗZF@H "[/muZ8 nյsWqzr0dr3ZVYvze^Kq~ kQ@]Gwy`і, r ~h>p̜t:wj=yY8opTayU/C %(Hz vhJq+[`Cp]|{u ,B('K01B ܁D)X}{mW
|哐3(SVHYֿc'>+f2?Nd7--Q^=I$<4!^-뫎[}AY%]A[jT,.TN2J # !ߟ1
ԓ} ģg` svC\\8)n92wd :mF}j1S,>Pt*(EJKKk>E{,ɽpkp ]HA6=9R[uk6@j)4x '2 &pc=6m_?
*A K_^>:!, <=Q.VYR.t<&uR( T-z4vY=}}Ӱ lú&?8k10vɡ
$hErU[mY>Q"x0nctlWF)S7Y87A sz^rdHX= Fdy_b<\"- A #)\fonasGqabyޏ21M5<>u; #Ȗt"@ס3G"NxCd
U7ґ. <pG FNZ8_y)uI sgū=>b(^T Z}F&Eez$m.Rz$ p ڱqÞm Nr8G}D<nO3vo:o[k8bzJ3vomO Vj U8IIdb Q&K=" flt}TOirb-~Cܼ|Rzwdg7n5iҽUG0&p,dNsj9Ԧ>b/i&v |Jh>-4 bc eP9 ȥB(
/ P: ~d JYso՛-|uP
`ft
r韃'`R'=ω{Tg FWoF eF~՝N<+ O'J$bXB. DYPP{9|.ݹ0A@3bq!> GG\,.~*.u:HZslg|ڶwQ8Dݦ Vc.0877}2YrS&XJtgg\
{iE$8EQz$Ru릦e+O _ggg U:;wiJv ʊ|
)IECZ6 Wڇ625 =$TU`RU|ĉjM;[qΞK)=)V*;G.?ͪfun@[q]VǀVa6L&KIN|Od}9:Do YĻ2,#/^XUϏy |yhIVah ^]i&
~ RkRC<Ǖgcz8P=vIz ]yHa[#j|] Ru^4;1'pKK/@(27
l6LZ=
( ;E@ ;ry:Ԫ]EBiT,}*Douq hT`P\dXJʞkl;锾^ @\hǵT>;a Pi/JYc7=Y P
3/;K%ܐz|j9*vmkf\Yf6pgj &M$^pO]r3bjM} Sp黷9
)8Au}{AC%$Sef3K{LXupQN7[} $QN\۫[0o(l] l+I=qZ
% `$bbzuUNr{K :=ym]:.l۾C\H }˜ d}/zeMOpe`6]H [=zԄ OKVɐ _M嘗)97U=5y4|?wP,)!_w #:\ PH@0u K֢@ÍgH r +Q> z?}ʰIPC6=K|nD̸䬬)f# lmBPOJ0 ߷ /* qκ'ёO/?ia{DܡDž9CFQϊ;ǎuc2rĠQI5 ]ٷv鄳~@q{_F^Yv"
, b$Z9Q= vbwwqju^UTD$G7
.)+̧]{Ժ ð{Oue Ϟy0kt݃K
wlas ~{f\P* X#;MxfzNo Il(ȉs @Is 32 E"engGOtj2$? 5U&ymmm!N A
5+? obocHgdddX-Dy<ZI^ ܬQN5+O }0\
r8 &
E&e<P( a$| cj/|.L:G!@_ncqV
x ~mx߯31Q!>1rR*l]pn83(H(ggkmQ,LzYZu빸0 i7@|]r ØLI ;L~(6^,m
{/ 0QH*,J@^RSE݂:` {h}WORҳo h )5'agVޯak&w , zǧU_| udz2w7LR*:˧jT!7˔~~!5Izp_s/ dU~CG!
3.6FV(c ;tjgggX,u)XJ2Vg*W)%ԽۅsR {LnȦT{+Nf\w#7nZ
o]<YJe^҆wkE ;4 qFwv eb@^ ~`^}G&}tp%1
IQ BVm?[+rCHddS~uk_4CRomTtn.v'i'4wt` -)oыd99Zf-˶`[א5e.% E0zCXGQxSV];ok65 pre#}3wd\z>'vc
i)KBӖ$uTGgY:,[oԮ|yh=
#2`\lcڲZY+"Y}-PbS b&QEk_$A:-_gBD >ooo/vu*2.'JK*Fҳ:> `ZxV qP~+3 E!g0Z R)2PHeJWjN;
Swvl -Ȁ^hMhITߡTn#wvw WRz
NK@%S8LZ]~VmtoQ['֨lNa\PB,
չFQCͨu:c{ #y
~4*@\ b5B һ< +r`j(-`Eb (*cqPG: KZAgp\DBH_FI/P z4AUS/s0|ۖ
`OHuRƍ^SAl OfZ0:Ih+ymn~z E"~0a]0֦r2NՁ
\W%:Ibñ0l?;-I0p}AӀ2 ǥ>y T-[W~߈kȚ 4ʸC'R23<5b&@#G vvƴoW+3W>~ƭj$R =Iå=t^ 7 TZ} F!5Z,i@n䞵^)buj.$ؓ A32 :52ŋB@/22)إbXZfL. E"~ڜ=P q] ?UOy5jztJ`[[+L8lPF>ĉn~ >>?}#jgc{Y[ژ39ޫOLjղ٠b,GCf XSmY&jj mZxݝE ʱv ڷc~](#VҡQ$P(UJ^R zN'j __pxݺ#Ľs?wG'(Iu<~m>;LvhI* (Հ"JuRĄY( gYE
nAsD-PZ}c==no ԉ߿RbɃjv}CW<8ĉᷳd\0{> 6Xz6\O#Z)L
#33JY9=/?馍M6 y
?9 /V|}+Ìr333BaBR%33no >dՅkh)W꽹
z6)cc㜜ml* 7
U@L#|g ݝt~^ ;v|hQ gO Gz<ƲHaiiYI²M`J:X,~u`e=+_o R7Z*XT$ gC|> ٷocSHLR9lq)4tŎ?4kιIIw BB *ca*ott۷njS .uW/:Ϸ$5tQ(Rib#au1,݄M}M= 2e{+2*08c/Y~k4! c[u~`)`DG*KUw[;ǕY ZR*/J.[!r0 2 A-P)UQaniei@I#?vh^QȏJ
vdY(mnf@'XZM0ԇ_ѾQN"H^ -Fr, +tODWe
v+9쩨W /$[
͉Jz(l2Tgq'ޫ~ -e?os+ܢ,2la)?n^qBv' {=g]&HsI^@F,]Ǘs{nO ^'''^]'MZq''+\Uy]UɅW 9Իs\v.za?fNO97ߺdޢ* CrC} Fʨ
pʑdMdݾ ,}EI9zX("{{踸C&$$4k yԩ( ++l
? ( ?־\َڴY>>L"jt2IˎJTF\^֓,-tXmVRa[63!W$ ~_ۈ2;Jo^cbb ?~UvyVVV_\3)-a'<}RYׇ*B)yҲr=T( dm
U@*X[ |QC
V6@% iͳ$o-dcN ;fe\o:OD"hڴiM4"9WM!ˌ$Bs /$"5Z/3rBCg =Y7?+ wqرׯ >gϞaaaw=-*Ω D cBS{裏S'Tw(lP'}"(1P~_(&` 6f]_ ?%$iE @i6{ƶ
Q_9`W_e^\
E{17ۡE捺7oܧ}ͧ]^~U3 l
)H.5"%̪͙,ΠwMNYLH26DI㎯jWz(4 v (زv3>@y 9Fs;sss۵k _IޙV#D)L`u
#vzkVK;
xq]d|^q:Jfy >[ec9 :u8&^\tS)eiio^kk4Zb]tB^͕Ȳy`"rv!h&v`ab9d-E(u @/R-N5,jGs$i*)|/t"QI+NXk(&
91^Nz0:V
[4[&4ũ1`l *.hq.z/&NW,Pk G>n}yF8AKBSVCFEEt}^2+WT!(m禮Z[|wxX<Qb߮nu5aîg.s {5V&ɳ1_5|Ȉ̸HꀖAi̝>n\ш';hL7 5 'fVeo̺>>["t 4eR#]vvYϠJ kݺ1Wq J 2b7ffР[÷)
13[GW@OIieT6ú4Ap X~\O~Ҥ 'Nݦc\}[$)zw ֵO6̙\k߰&5܃jr1+;H^N>
֜9s<yVv'} Wrcn<p퇮rh{ZoX*ClX/
QR\gwV&I$5n\wP^%ūT8M9BTlW[◶5-M;е$Kyy8U!U \k)P/]w1)r"uZ_Gi! _@0^ Np.@Ҫ@ 9i<(\1j^
(Zh0a_a&%͚xR}I 1oe~szZZ.3_:99b u6iڴ)$e{ ) 8tVР)5`d Pѳb EC r EJuo@_
^>u`a pzosBƢOk}^l*K r.3ט ݺCn %z+dcA+ĄlĬ@n+(IYX1Y9
^Mf.ɾPcI; .Ĩ=O|< Aa5dԣ<T
h8{tZū{kUsoYeɓ}m[X?,>뱤;ַKj\;D~##Bqǎ gϞڵk =~ I _fܿ|vf'
ԵfR~P<WZrz <ξ<_MnnEKRȰV
vXXجY7*>#zf:25rje䍭07n̜HU*XXX 6 rh/N0aÆ
!!!۶mKMM/O/Lbi cfR{uN&x@x6 zFPZGF Abj}O9B; Kڛ
X/yftL/5@M XbţG={ٳtr`^OW 76eT9?.Lo έ{,9Ɯ<<G
pBVXWlz2#4>,?::ˏ sЦp. l4.`?IÙl:S a]xf߇6eY
n.vW9e
_z5˯u<Nxrfg?eoG+taXݺuS\\|5j\[ 8R t|tWkVw:O`eZ
ju,+
6O浕FfU(HPӮEճZKf k4Y.M 64ȖGz
}..89Va_U#f >{(dQגw(fr ^։nǺL]L'vT F+uKy_+l%,;h?0$e[eXe{xŃ{L `34 2hy+b7h6cw Ep ,XVD63kw7oLLJۺA ,dޟ}bΜ xxxƬۗ T-`Nz=`ݟ]\j?~[ܕ#ߛ:yS'uwnOXa1${Ǜ:h2#/thg?
xn s}NE0dW'}x93>;e}o@L>((hepPhwɂ^ vt Ba)߲<<}Qf5Qq u[]լziqT\xh5(< K:t4k 4vYG_(&ֵi'}7P~Ã!-g-#r o;sq;jx{)TdipDPŏ) @͒w۹څAv:y K`Fbܵnm7iGj n>ݱfev GӜm }SCn:=Ity,Nj6i4wܮ]֩S'**4Ce P:5a<wA-k,LxXHqnyt9yWrV ; c
$tsbWw/=gc$wfk':<f*GRc$ۛb q兲t⃜CK t4L G
+n
C]4-6-0ӯ\(@_/2$&>0}}ț%AQ-SPn< gԸG?7qDh,^xРAu(3Зpc2\71^ !J'V 4~a՝j? ˁ>&7#+۾q/3K>4eGO}=B
C zUyDU?E\fMNNH$2dZH83 nBއr\gn^W{P+$Q+c|P6z0C
ma.N\=g rss7ohvQzk),kK@S(2BețƳPjA 1{zVS8K\٦=dqeӳV21 Nڴi~mLIÉ Z ˬ >Q')B* j}(e2-[=f+Nvm[%Moh嵝Zx|+&n9k.VlVkAm0ftW_<\]٭W_~ wp/9^̳THߡ۱} U(+A.7ɓ':u4v/8":=}~Z
"
Ue055e@U,LK R%Ɉev^V&^=lnT + 8571QA j V1zTKʁe]ڙV1pGfc^uDYfAݻZj%i)ѿ5*M"?]HP(Rޙ @YCE:Z'/,N,˲s d&eh*5d[MzcΗƙq=Y=WmN
R 8yW ]ok=6i
[rlKu ̉ : ,_3UZ[#((_ Y>777n$ YGݺu7oܿru~SQ@y(NXQYMM>3$)քiQf6Hs-1f cٙF''HЪ4RZPȕbx
< EKN
ź8R6Lde\ٓL fIk:dM`VǷ<<ɓn.W/°>B;d$3lD\i-U4S[?qرcu}7O^PP s);p{;+? $əEq98r`^_AyGC9E nض.!B?3^I Zmʳ۴Z^.' VpnjΧ|9q`gozrrarrr 9볲 1x)oٸTo q\
|B(Ǧ+P$<oz,;=ВNd+-Gyq]YXX(.$V[@Z\r $SG/e舞~^~ 9sٳgɒ%F"9fs$ ˶յrc 'EQū@o Mb(3h5>9{^^^zJrR^Z^v
rú" p-<S!C 3~*WP s=\+<١COiM67r\Р,RP cɡ O m%`
MQt¹`.N7ѬP(d2TEdE]<W\zjh܇Xre-**l0fffP x|ƙY FvFUq\Yp85U%%U:ɣK5zZ
$c#F9sܹsoκ4J7o/_
/ûX,5k PF*Ğ$5xyz~҆U*nIU56/)&U
fUXt ;v@Yrt%f ~SNUR|U`Dzߞy+2@R쪰dA<q kLܶUi][3 YTqkOC ٺukKرcO<yĉЯ**3+[պ
"p-Vy'z?^
4G!=0eHO
|aJNj/LS$Wu `<ϣذ}yoKJb r-nCѕ+W!-_>>>~ժU5kZBx<7W_ ǥT^HGK
QWZ|mkm.y@$ueS֭k ٢ O*@O AjUKo{ b" |Ubw i<l E BЪm?X֧c,oRR1.G9mwq|}}
4s ~ elm{+/ô Ch3C~6"
x0dX3` NYW ,ھ n]㾅]m2PO2rZ
ӻ2Z |4.ސ+(g5jM05dc)
lȆ!eLIIٰaC<h=zhLLĉ6lO L٠LqQ;+ Y 0 lU<< E~;^ m^"إ 04_R'f!Ew囻
Px ؊
NU 8w0 Ws7^Hk h)
*UZzGց^o֬Y.]Ο?sΊu @ fh 8Z& >
^RFWȏ?^
=rcԞ6k?o~,iaԇjFTZ *s~aĈ =ZYyCry =`ٻw ʰ00YK+qsPQL9U1(9:x[)Fg͚m6?!55k OoI>Ihm8U<% z)'BxJi0)ug! 5Qi!)ǏkJLhof.]m~PTTԦM++cǎAbeqeF1pJSꍍ<<u"fga#Z vvcapBz:bf,!թI 5в]?c4 i9/^8"6oܤIpY1PzZ;5OMde-P KuM8=v
J|˶N%MY A;laF3-EV[~4lI62`yV%Fz8E?װa*9sț<PhTf|QY I)^yr딋6OU(G:11=(3"-9ej̚E|V'bAY,\6nh7vv\ynW-p [wX<^(0WxƌM<zG-
AL_yY7 I A1a?Oy$
nDuuNh2ߐ£ϸ 8BH"mf=UN);0N7Zz)EC;ib >|طo_6!<f IC}b9ʝy|}qAX;;W+{g () 4Q`QS<+PĦ
{G-lEE"QX͔5B}e;כx_Kj+V|yeXR\,Q8YUu9.\0r_~e&`vrle6Ua+.-;k/cuɁVVVV2aT~e 3s#Ӷ4nԑ /re,%^PEb,s65:i m&~a&$$|E)2̃qc7Vv<]k|Kxv3_k:آJRj( ! 9 j,@;u-6?i3(~]#?j
2S,h46 l3cƌ4M"WwLJE"K@.O{t~.Vׯ
}K rzڋiGL1=g kw<aM3 aI>ftx~Kyp cOX7ekkkR %/F dUc#a6 7aWKgߌ(pkV\oQ030¶ k dž~w/"ڞB
3eΌ.hٰ1h4%M0PϜ"q as t ?TfO* S<Ɋ9%Dfk}CP@h HnafW u5nGPmB oI:`~{A?oDboශ ǜ;]5$0)[+ #FuV#M=ȏ.}ΙRO,PW52z_ڶ('h"ZZ a}u|B,772oƁ̭p'nP[K߯09"pm. #
tܤyWª|"(4,h$iΝy<9@ p(\096J0^W^u _N: ^ gffb)L]V\3o٤ϯ$YrşcN^.`~r }dgQіohsĬܟhbnm5% ش+us}4,[lԩ0V?ёfRCtn5KoYEj
oZ+3D̀%2RZRcPW`qJmƺX.} ٮg.1vمaQ
,qvqcl{8myز<eda-f6
lƩoo9rU'P%l aTBlD7k{]#{T\S;Z;f*- 5. [wI
xX7Ww \k(C;rR;\#YO<}{]A]լ۹,muB,O>\ߪب :m|Z-@?U,͞ ?u@lq0 ِH$9999E;?;Ig5>c#E mE"k yLo# Z"l!10-pL\Ӽ ao b
crXp@) aH `LN V)G:sj+W~ -o>/1/'07Ɵgؿd,F$+^k4i_ښa?BQڗ(z Ro}K \z5lEUATTmM F9 ÁI^TXT(,L1 \l݂>.$x̴."&B`h+ "v}İe3C4">+q1$bHN~9IPC[YYA8:j
EqD"KolجQCCOZ_ɕř)YB)Sc ~t¾axU_*@ Z^_[y:L;,.d '\,!Rul%{X ^Ib\_ZK= \e皊[\ޠ8D"Ȥryb"@oiAVw$:=rhu,OŤVRzr,ͪ:Yqn_P3/=Pϝ6?Jw:/^t}e0'fA>ljsTĮE#۱C{~8ƺs*Y>f1 OjԾ-]G7dOZ{\\7q SԹwu}UFS cWnr|3]3| b'* >;
pM P:&4a &fe X qbs .3<#v_vTw X UM* E牦Gp4
rRZMԫ]1Ot}nxZ}硂5G@
m[~ ?mmOFZ3lY3y^2uftl3}Kvi̬Pn d{6O?qFxxm 6)d)ӷ 71mm-^TxRZFNTsMe'k 1)L Fq6 }P( hiW!1T3P6w^kUU:*`q8$3䎽ӱhwZ6s/v{р52
Ndžx9بI&Ng#j˶˺[qexZݙ/f -BG'G- c%'I֬jǯ F͒HJa`gGwAzM*̈́_LB+z%^M]8܈G!Sv^&X4\E:9:U9~ĠB5c\ڝXT9~`z`9bTSI``LdD-[ysr
tB1_C|pO!JV'mOO <X[:؊ll:Ԭ ʳ @v+5%*6e˔)S)r)?ߦ|>dҴ SmT幣`fVAMS'rT yE)~)3,Nf2t$@i6UojF98.hkkk:Nk I 2x\&il h Le<6,gra>]HG&#óC
]EO qdr>ϓ Yֶެù7><<`|B}.s/elڬf^&m} }M@CmK;߹SZz̭ :w%[%Ԃqnw6 ` &֫-p܁?vj-[ur7+~~;zo1 kc2E!9i^,tj\~w+VʤcgMpk6.X<ڃ\(yW5KG6'WĊ3?#yݎ_=0,}SlV(Sґ(6lיuߺfa:N'~5vG V6Ipe)TM;L1dƭdz <YA \ _W'UJFX˿zV=V~zZv:* b:_,{N m ZtrS:.wW~M qK@IڲB4*WPPPJg drJ.mpL08fB3ᚓ)+*\5($d̈́/'ؔVa%@Z[3P\Xy
l"p%o)ybED={L<{tƙrij
e4
^SIiUayP*ձNAcER\HAlW'+&gIJeڵZyСe
H'!ɹ|)>onnn".95U,Xחv D"uVf;g *y +R&33ҥK۷/
49Ϝ9ӯ_?PE&BC\s\F+0(%k L Ե [-ݻwO0
M~OKMٳbo.ڴiӸq\]]JKWMP1
3̙wjŋ ? "re2Yrr֭[_/\pٲe& r%~(* 7n_}<|'''zڐ &(WrB$խ[7::[
qeX{k"&)h4#F,X 7N:͍i± _ob
H'omm7A0ܹlmm+ M^q\" Ph± _= қ
4JlMbMb
uGQtv $! )z ]Io*!RDPD)J(4 ]zj !]mf""Ru͛DOQDE"(,("("("("(,("?SYI=qфv:-[Y\! J z|(odR2*8Xs wsrB5y.| Dx #j"ĉ߇e)ŖmqÑ8<\j5 E{O9
y{j5驎քZ-a k3b)ܻQe>2JK(J(B.TߓNje [A13tG|RWKl.ڻq68X Thp S(L&,d$
!pV m)VDӲW$ ľ!(< tpUGfbX(wJ>ntCQd^㾾(]lu"vԼCA <qә@3p ࠃap~O__ H,S$IC-'EEQRэwH_e89.W
V,'.vv-{D{Ոjp:C m8HpO
E=?Dڧ~'\=2=##q-=cEP?4ML7ʎ _S5*CM A1 Eq\]Ppٻ"ka~8Y-9\[Q!i42YpڪU1^ X0D( ?K CpQ1ʢ˄⣇R]Dw|? Oòsg8U SW u!<f.j!!֬,;T\NǛ3h0}B VeQ^>݂f6y^ UcQ
8IsϺ*!4E
6MW& `R/+5ge_w:NժEy ؒw{j߰pIEy@ {(:<I 9l5*[QeQ^D8(*k *oF݃Pkހz:VB~sϼsb'l)J]}6Vb>` /9s4gouO\ |"BXrLoJ rAxWn{k{ ws^ d䏟Lj1}rLW;y{Zo $DR>/sFL q^H2ԉ;Ľ)ߤoް{
Z
ҷzF?PX0 &x(In ߰aoNzm7^rYq>]^0r%p5pp N ~s sqG(p GiOXP'嘵PZY/ vZZNX^7δ6_jxH;/|74l1;oւ ;N?DB
FXeo+rʚ ȉJ( T^1>}tҲ7:Zt|fԛg 8pṩe̟Yzۥ6v1cG_^oH5=j )_pcb^"ˀ"(AAM gŅ Q2(4`Xԡ
3&c
]in D^8tly~͏YzJ~+Xyc`i,j*E+۽#N(>A^)zھGG羅vwmڷA> .?g)JpC;S_a![fq"8J:*V=Ѱ^MnӬ oz ٗc8SXD/%JEiQUahٖorr#?O
ZQFza3س f1J2;(BITcʔ[ *P !L: H$jǨ\@TEP<*[+: FZ`<<P<m1qN ^մdez<e1m_ ^L R#hJ G5p6.
l[U( ?eYeQ=k8~=]wQT .|
@ w;YCM{O ر b='9r#9mH霼\}pq+ʢ<YcY٭eKtzOĄ ɧ<8@QZj4u@O|ۻ lYgτ AEXAY'( 'L_WժIRPrOx "}?X*/kJFS!
(sѩy%{RF,Y\^˽|Uޙ1{mb('MٹwXO٣*9 I˱q80ECG^=^D!B߿so+:#5 avk[;- P[jgove )kѣ <e<{)k$oÁMsX1 J 5 3^i3"*M> W}i k^'Ϝ K̝qFt|NG'
qR.\ v aĔN}WP ,{^}$Jԕo[4k˜ob]nJxky[ϔvZ`- %y i $6 ^kpd~;hB%6 w5\?-㫷4_ :mMަy)o7Zs;\*ua8wh`Z7!`)CeQɂ 4m++ &gBAO0N 64)ܝ"|˸tl'^oy%XˍNݱy+GWa-u7.9*0F _'2w~K?-ڎ#uay!B n~tj% W鱟%]>>YS[ 3 CGsΣakOPf)[IsVxO2f,U|o._x" .bu"tՉ5 G>ISnPpP6\ݴ= }YގZd-If Yh5MKM*q CQEP &
Zrb <\& Nt
^cxgo qI7)Uf#A*@IfmiriΜ ٵ=M 3NeEnpN'vLN`8N .eޕT8l4+os͘4l1;9i70 ^"G Fp;y E1 ?\ MG%tvyP6< p
H898iEH$pa aI'PמT`@b g
pPv;P\__g%Mi ǎzE%(`{Kx0X; kxVkՠBX{i,gZy$CS&7h>̖ ^]diG|%/aLN8)7O qW\qsr55RBQԥLQ;䒽kwS*j`~r!¦c)oD"z"풽Nͪ>TKWU$sW v6N [ieQU#ԭSwU43@`lj *Z 8?4nIzk\43ViA&SKJl
g +xRfOjʢ<\(j@x.yFEFF # K %(j+9Gv<y%ՠ )0PcΑ -g` _ ^s/u8 &cdmh(D'ƠQgkyt:T*"ʢ<!;idlbj:u7V@0[
pdr\
N{V.88zOpT"f1)kIIP$1ӝy@*%
3O-WHS|}}4
AhAY R qPX I+ u݁
IX"<"@MLPN
J`h/ەHLEWTW_<*kvqkvS' ]U z*J&Ḹ2ew/.]h2~[!=PBKHU#tpɔ%!!H-b.2 ȅ &q9D\MFEdʜ6m쐷wF.@{럈
@"2r6
hԧ
m5ozr 1Y3 ~E*ź06c23J{l5,(Hj5RcB!HD#sҴE;vxGE4h*,
?0Y!n-e7ou[
y`\F{TNR2?!t<_MTN,.qԓ8cGKB}Ft0cHê.n_ei3M0E$ͻ\\wg:erftVS_r}yk)L}^oBG6fQgE)!}HhٍtVGmIHpB
@Qe4MT|P$QV)T
1n,/(.lް+v08σ t-7oQGJϦ$Iq>iTqD!g{y&'w`ˀ 3 Yj9 [=4CKڪށ& M*>|=xW_v-kL?UWq2xg0EtxSV%,`hhrcO3^5_܆b9 Adnea "1 0LJ!J!J]OCq 01
5kJd`>&B?$0@PncZ]hPjs
j~泶x B08?6`wT
4RH1` 9 V9PbdٝP
7(Pi c4&?g jS?旋G
gp׆G{5ae^;~6 aKFi ķCzk?zgͨ &$
<Del B:U15S^kt`T!Z$VMLNUo
N",/MH# WqQ)u{f q%B/~6exY 9eDMC k+%̶k6~L5ݻ_~0&o+l Pv*]a6[1L<aA48- 9Vߐ"wN͒4oI]MjgznoN\=M?}t7deg6o}Y䉚]FOܷiP^ s:,9Zٌ
`0gd΅P)1Q$(JC ε J wوi;ܣ8P*(q9#pv
,
h v| [@) N+/;
Ο9M7kXNP(܆sLYXgCD1oOmmhg07)pwn*|Fjs,`h/
u&X}R+> x} 8D*
q3 eMu
h;c(\Y 1E-dLn˱ouzc6Y9Wf͝f]M &`}qpBId2YEI.joc4^).ǎi2U8 U2TBNq5e֜˟Q'%mw
ԫ`40+i=iV؆#W~e}&eJn4%%{ v[$Dh/8S!ؽr KL^Yh1htݏm9Ag~F U74
z,ucɰ.}uM (uhb 6L6
6mC}=W]}a6gs#t kKQ_H8}qSc^?0
"-[;y#B$PU*^^^bZfY Rv2 [^
x lBA{1c6zKXu@ NH '+] a=o8Mle99YAe5jxNZJW4v{aNNٜɓG9lf"@SXH\_MpcX'0]|
*5
u%]ohwު}cG &c;%ؔu
!Ы]l@2 !V L٬ ];xB
6n8.?jm8 ~ LLƏ{~ɹ#K c!Fo\ 8bFyVoq.w`vUOȿp 3}] MP[@Mh=&}=A|Rl.(0ÿ6D| F&թβRqq
NV<Zt:b\"z?E:Y %$ .P^snԾ7
;o[h.iJCHTpn
4=#aY'Oȵ ~Q:hp gִ'r""LPAɐo2%E"V+Fӂa K I$ ٵyɜJq-"L"D!*\ wD /-$DK <rq`ń4 ҏ2j?I
j^j]% e4T>ST>~2N$Ҋrh$|,3r ȺAA))B)8 >_gXvlcXN]"<<4D"[pk!pbJ9w,7q.$n5 7=B]te
Q 4aT=BZw{\W\9Rvl܍o~hW @e_Fa
7 ի IRT6IF#k9]b&EN'J:! 2Rnt-i:&لbT.G r/okXR Dp(&t^ ?CAQQ
iUr믽$Y &5l \]=K|wǽnrk"(5*?4s+.qVFXv,ep ;nn>,8v#%Ei5W]őwfJ}2gb|\XOOqeDVQl~ 2iӮIrW\<?8xa[422j%eu;.W#s@u6<!ё 3
YT Hc=!4/Uݴh}KϜ""b+yGcW<IhW*Z H#nB*z۾8ww!m -@c6ը pwVἑjT;pw/< _bdLQ%zz!OWQȣݾwIA 8vIXnh&* WiVjHaS
cw1 Gg` -C 0viwh)^azDz}}Rj;
moV q
Gb{D#U'u:J %W_Ņwi1Rpe'G9%>o]tHA! ?5~쀠GNE}xos7w?/"W,xGÞ_2zFa >츹_5sQO+in{:7EfsQK; mhFk2iqTƯ
rû
[ CD.9~ [O?, bRI'!! (ǹulDÑGM"`@)JβjR<8!83tc7O#Fp8^xtL q_LBbqk(| e<*qkXLƄ -ӌN<J5:ɉXQ=uN٩#"LMR u
ͤn2mEy Iq9(4@jP&7..ge.*%
_90j UDq?,_8P {Cvaxj b_ͦ
߅d/r:M,I$l% $e5H݁?%2 T4 ٺ.q; )sQtC3,l! p Ǥ2aU`˦+#vn [WX)?\
d(L ,V
ڝ^+Is 45cj(< @1Ru$j cj^-ej^ 7;y=lLAؖ+pڛ5M|4\+1T3hEq3ޝQfkk0O
lMp8Mzu]zlBduƎh5mLܻaBrLIsikWGHtj}S^ȇm:nQa˶T)hoVh9W냃+(R\~,(ȿJGQM+w-(:]r; hYF| t&36oEE$j{w z`5xXh<% r{ 50KaA^z\[l^⢲lANK{#v{HW)#(Bu)g7 n v9A3*+˨֔HJբvgdAZ r#O| &
nIȿzb
IS|NβsiWlPOc4Z!}!Gkj.+i5QDPTL(@Q?wnjp wm ]KՖoڀ B[]V<uB5W W?Rȵ q:xW4fCQԤau{~Է"?bs2JӪ>}}j۶^>IԨ
Njf$("(vζ@>fFTWfXcye *eM9^O┬c1Dr۹-k9q-PZ}` jUYޙ2_bUR ޠhafݓnu䎋Sl,{I˛}*
t\s&r/[4Hm7*.xpMvٮKu U1BҶexjR ;n[+Mׯ_pݺ&("(?LqmIV2{
_}{p* 1f +ֲ18X!H#X@WG5v4a/MbAֵ#?Y3Ÿ}_-^uXg9 (:|W3. cAfN2(&UNnfP\uid|зw$v "S˄K}}}sssrR[FQ5xzgQL*Xqѵ|c*9 vt<M:HN@gYAe|0u+,sYx9l6D۬o
@ !cdR s|{E&X _zXѪUA Sϗ4 (<}ׇ&q@_MG^>3z F2aIȑ l9-%+v[ޭ[6 OQTv)NѠAcǎ]vjժb"p#I`9|XltֿY`\RK9\8\y!IvҮTXFC%BN )9;g0"Q1~B( #OS_;% 6Gd^ pRBbyɽw# E/%n:u PyPm6jԨyuEl
QDyTvW+^ɹJU
=i;@h? ;pG}B#ylֳcJ 5o`/{ HlyϟeZR1EDvK͚5 ǥKDPEPpJKKrs/(P81&JL|2U4ML/8X 9$vwP+gBs4h ػ-[)6("S~dq-θciZ/P͖GR?dx@\\>VNh8N-7ϟVQj W{N?LABᒠʊZIJNh4J 6Ayw6KRRʕ+srrDPEw/4Be6xf3 ԇ= Wn(Q]٠_X鎟p7H{>ZZ~}][1U^Bg> ;1!`p7Iz}ǩ}=X=&Vu7^p)u=<<<t:+M 7 QWJ@@@jN8+D k,6'E9%#Iz
4? rQRA]08d߁}h:F
aSe1L
tzVP(Ĕ> ?sLyy P5, EyfEj5RJ3l+ι+TJesZFF"߬8eNZ5ֽV(J֭3 "( \v'ٗ Q Pk\sʯAxMh;J )&Qf}mLc9@M! aXax T'p~pW- :u*ɈD8w4]pF4h
Nw&ZcRjʕ+ >|8::Zl9MڊS_.tz4j21 jU8s9e5w;gY%z_yͳ-&X2ܓȂc$ 0Y$ j۵ѭ[b. Ӂ )Mj jδTѴk&^߰eH-gў
w+<̛j: ,$RfhӦWl٪Ҁ 5cCCC | aaa'NPݏ凐97ŀb <!e__*/rK zZsS|ɐaowן\ݳV2 *tf2ƿ3l@7zos2-! v~=_ >G! Ϝޫ*bamJURW5aO" ާ ݇
*;VX-F|-VyT\ƟK/r[3 joصǏ]lXK pC}QFuWV/={$)gFqKsR3:KM%cƭbTE+o
S~{^
%mvv?XE^ 5,tcѫ )(}^X~{k FWtMoܴ/|ڇU{b`5&s~|:U0Njz[!msV'V K :f(c_[r frZz9t/^hPwVfȈk׆H-H^yׯ_|իk)2
0,vD2 Tf V3c8 ࣕKt,NWnwHhH7CMPyc}AJ>} "i:xBqO`cf~]z8fDXb 99- i 7(G+"|dh1WaNu}%c W)MsxԄWu!cz4@a#p'}@qI;i%ޠHlߐ >:S~L?d:㋊SSS >|A 5שSl$)jb
T+\#җgەr-
,BKS}y)e <Eq T(ʌ^{Q7~/O+G-?yR W o RwfM ^Y`}IeHnnѣG ;^VVVRR j7RCߩrĥ>ysKFćHT>Pn4eeT䠸 ;.kGeAAA=\;~SΟ?kTwKm ` ko;|[1B=i S6 Ák0?/L4j0FuMQ/J)! :J)@89
P
Ud71
o
ؽ'*%SiճWQ hp0Y8P*iN`?OyFp[ whR\R`3 %_ʻVsr͚5{7/_Jdffʕ+ ,Ĉ5kB@_xŋe3cCeJa-'
rP|a0oH?\Iei(h%9܅np̆r ep'r;_2M&
1*\cv &+ T. Т@&u.=W~ Y۲O>O.JR!Ν?~&ȐOS/5oh˚1 i2^,In1 OcF E>ueϖU۷}_vN~Q^)gt_
T8`(@pUrU5]F=TƁ:7Mkljw\&l. Qˡcl_[,d_\߽ V nW7xR^':֡|_ԸP7xLiCϷfȲ&L +ݕ
$\#p
.^ Kq=>,
hRM+ں+ ͲO7 -{_<?ѹ$$$w"KJJ ;uVHo߾
^ ~ +WPB={[WFFn«}sK|05p@4ز;N4k߬AղV5kѕIx7j,h';l&in-^5ac? P)|g?{{۞Kc Fl;:Gs7C 6 ȱB[UMy| !GjyF=FB 𔐖 /h8MʷJR Ai3) na3Uvuh3 VcO|v1cDgʿ~l}Ak۾`oʔf,mejEض%Ñi}'6`W+hSZ:aF4l N_ .Xf[F= Yc75Y+^! vխofi,%^mY^`7kU/ߩ zw ^VkjΊ[GfNX̱-~J:nڕ̖skc 9'Ɓ)I?mvD֨8o}`vg5=5̭Ĝ#ll{']s+{JT6 _L\ѹsZu
{ڍ;jQ
}/ob'g =aK<fnhÑ}_wP! r 2##!m+ 1NPeGe@!%,,,Ά }v 배ؤ$|qca |pPLYY mN}br]f nپcj8t
[Uv蚥 *?o-vTfUIxEmWT7p\ ؇^5 ӧ*]?3Z=Wd!Z]F
+ wh6%1AY· $'^rjͧ 0
V ? dh\`gMᲐ<q
Ƶt;<PvZzO `ro3q_oHY;댋0֨ݒ
O\}Q;N^BPJy.'c yҜyJ_;Kϻ [I|gեVgϦWs*mWZu R>UڐAotO^*o^%+c >@p`Y/a=Gh+"PBP@G]xşvt@<_dg5~x[0_wBL.g T.0`?}
" %8UvrŬhйM~z6zޕ|p8o-0sIrrrϞ=$Ib8qo =z4<vG\
oѢEݺu!j+gȁ'l!ڒ^KvW} 0IG>BrnKC
e mxVڨSM)5]ZR}*G\롑veOO. ,D .6Cq^,e pefOp# "xx J,zdGpS܁i_tr[ յ9:Kd ڔZz8F,~q}tԧĔ tG6`ʰ,X -7w?s[*LagbiMTΔl_tM8Y(!1hY
}cǥQ,NƏ2ݦDT59ؘ.qZ= )A䜾|=9cf <<(CNah6xmT?zo):kDKOiX 4
$j՚r62q (^ej:?XPU-mhzV;bݶhRBGA硃"4=9!r#|Oro^HKo %('`8|jj*$W\x"j
0Peԋ1 %g:}/p $j)Xr:&bSYTf?y_Oa(-W6>=Z Z !,HZ0mPQhC;Ua] \i
sc·T +$ ]< 3C`P9 ~%C.K +UXK w),N@
y]|R#ʵ&骡T.
nrRQ +ݫ <Ts N 'P@ 2Ѯ`eamJ\wyHiAz}3{͛ׯ߿[|||!XCt7?Qa |ZNP6=-ϒ) a~IkJ;yz' Ɗv}jwϸ7Na%={eqSqwX0 \ ڍ&7dmzB5p2PUOyf`j#|bKڵkwyt}͜9RrxZj5W;JvG6_H[0 AWr O
e.\~/aO sOqŋ-ZK= Kvyܹ3g(5j@^:<~ Rw̩ee^6k [YkA+X_RQt|uN
L'Vl9ժv*_P dH u͇[ )P%Di=+{/ Sh^pM#X`' '8f/LwVx11?\(xfxtω65O+e k * ~=Z}u?C[vk$}*; ~͙3hǏ 駟:tPJIII۷裏 >t
f;[ѽ2[vP ǘ3Nls %ut+o8M^mc.MKFyޏ=:Ŏr2(
'nԻN^j/ܙ'!\ʫʦQjaiao};j'J6}ŀݤY~G ^h쬥I}糽 w}4ye&ke5R4Sj "RL~-_ݱkꮛ9S/XlrթN# 9^>)} * p<Lh8p {_2%l)eksJ겾kXۄ Gij;A>Q4BAA- >`wҬQVl:(Vsμ,k߾7,f1CG]_b+C~}Y"]33^l;]xq ,e6'HiݺBj_ږnoJ vtA!3$U͞K9v&( (/ڟZUG=(q@j ФIiӦALKK;}-[7n|왯\: Zax2 K_o[7?w ;*OLﲬ^zn y?lkSko`Ӧ9Q9/-ү?%4^xV)[`XLYt| +\.QƸ}:[C~3֟؇vZeݻpLvD7 ԓfܾF~V
~(Z>n;k ոYeg_f駯5-/M RP _4뀲c~P]jn4*ʰX٣KkѡUKo˺240cnKb&/ۙCcT0a±cvSeX )|< :N/]c"Ə CᾘJr^[Yi@(wvu\iEƆL}f㼶 dn%d߯20q s&6I ^Q{dOT
x 8f)<3' d2W
d]&&:cGf|؞,Qh"?0R^iDJUƿm|p T"hT*_~RbBMͅ>"_zkwKSM'ui>}{mJ ۆO,kiY^|@f8k.iELa,8Ҝ 19ӯ$ 76vbhǭ[a[-] xB^kcq`ߵlyʲv A(em7^S絟XN .[( i! 4-|w punя><X>] ~>o _?K^G3p U?C~joRCN_V+L z+#- iuyk
*//UVF:w $SPi9vRҘ<Ӥqr'
xRӄ_g,BdpTӮc
a*T'lnw^k +KGtZIWU"Y*WUt蒟NPaTZL8 uth(,Si
r儏|D:) \bzyE&mތc$'%NX% )%J Hww੮Kܑ9[?
H݅q@SPP6&:%&< d*iU2H4,/2 4~*<iTV3*cCn2 .xhFeraZ(qXL!S:ͥV;cr!^>J9`iiU^ 2)K&
Jo܍AP/*x gFC 7$r^O0+C
(iur ` Lk z)#K)kfísl ^jŋYQƀիj^ĎRprxIS4 hbBu[;(F7m :#CK\2LkZ
8W0)N6 =e~ds=no?i蜟;ɱo}߹&igsVvīγ;!h V- efΜ<~I@|{y_>a]KW?8dy^-'O1!L[_$*D]ޙ&D>AY J X>nm0?匌;w 8pѣ}iҤIڵ2}ᩀ(OP9w<m4 mǢ -,,lK| ;Itj @hS ')0ٵy8..6UҒbgVQB,BI<ߩ l ]"iD ^=T[QzE>k{f$!BH h!Hq-N")"*X)R
-E%Xq[]{}
²9 ĖRFF**h<ITZËS_I=|wu20` y\fp>e)!a'*z16glH.uP>_
:[X?=,Ou!1bOٴ*KҢ~:-߫H7?NO,Ӛ/Q/Z >m!ywTa>v\ TGļ ̳ baH'S T:.#u.Qlu
ZCz$~YgƚLfM X)C d "D]zƍӧOϙ3'))jժ͛7:RJ=@6Bu7e(aI>LjUU&0ߕ/EH]~F 0 Nrɹ/u?i=N ӽԽk/\/{
UlJs 8eدT7 2
Glہ Ab? e3&xP߷ 6~ԦF=δ=CnCκ~w'ڌ]ܦo6l;=FoƔ/R/ uw
g/ةncHbٔ2-TM
y9vmϧdy`h#=K f{
NOO_zQ
l۶m˖-!o@y,*9F _fy9oYAj+`)C`A %^[ߋ {=L% 28ZhڭG*XQO$
c4^N:UY|dmi6>] zxC}ҊUPƺ~sw<( eZ7_ F64ȽzÎjzwe-EG-kel8i[I5z.A%[gOL~uٕ 4V
At1K#捚F8#*<J%:ZTVVmѢE_Gܹs̙; ]t: ZIeY :mFuZiyT
ˋ{3-mc3s3rl?C
.=ENMZ\MpLk5t 3' 4GcxY1 _CKRXR\IK +pTxrm^.fJ%CN3yſts]7\0g36Wp;iO*t6m_KqLpa-hN蘈`iT k.V*GY7ŊwS t}k =K
edSiu֩W!}LrR1$ar͝0HŊ(Cy9K{,Y6 uF7Գ73a_d.Q 0dtC)dǕx&@s {qo&55PsFڷoq E1 RN&)n)CX>o?3P >̳V
k4@=@ fābvS.2:2,,+H*T%WT X( aB7f<x L=̫F s*ɝ(cxh><au .jHpJWD)#(P
Kic5_xsVũ$S308M@,;O1ܛSWS!Q(>@w!&pd2=Sf~=:"X&!糌/:A"DW#}%dd+wUr巌R{]v^ DDDt֭SNj/iGYEf2bE%Mh9>_q\yy:@?-c:~Id)ݷݔM[ U
*\%(-:r6K?X誘[ l&{rRT#uyAU?zNh9b C4b7+ Ox0%S>{nrYwreB(=ڰ`Ϟ=IIIǎ -ZԨQCR=Q 8`g / d_WT֫:\.tx Rvŗ ٪~jZ K`WYmDx<٭",ۍ$EjFגJ>lXLcQŕ ezJ={c-E3_='I5U /tKU8F4F
*ϠjRyv[ >fTBw=&&ׯʶZ,E&{͊?!X%@,MxBi|g:~sH,,c
AQ ~ <$ Qh~ ek㴊*> ff<|ݻwiаa%|EE Lzd2UhݺUMK=1DCV&W(J@FbU{y (u]~8>>~ @D {*ɌG^MA!s\cBHZ@$o<R.<aMr2<^Z[@F 5Cb+?i8ET`2~%453x
>֠RB@6SΝ; 8zٶmʕ+? |Cn
XsM6rJu ^^ѽ.##ĉ?rHpppÆ
T>.Cw A{7ⰖA^$n h
}\zI i9'Cb_ꖣ'
c:Is9aN<bhkTSʋ2eff.\<>b 1bP[ 3iiiVھ};PիW 3fL*Uv߿ ۷; j^xV aRgQHg HbO=nܫP
c9z9!7ZH J |Ps&tl [,`ӧcǎ/qO^vsfs//V*<%`u$ l2S ./D~zZt,WFR܍ Hz_W k&tVRV[=咺Vaٕ{/"ΩkDv0< رHǏGGG'&&h%MNڰa8txxx6mv
l|1s. 4urz\zI0_~I/ "8YQ19z N,!m:fX
羅kn1S~ UFX,m:J +zw*Wt1kar_H՝?|9P!h&w- 4R\9gm>qjq1y&"~~E~wz\_O{$G \&<]=Sg][saե/NOԈdۦ-ဪ / zŖ{w
^Bx7 W{rh'MY gSz֭fD!Cʔ)Zz3 .,Yʕ+/:w'RG Ch,^V? zV,G_˘\>_z3>2c}k?jx
5YrauO͟4sklPj@reCm=e䢩# 驣niܬCbm9;hu@p͏Zܙ瓷Nr]'z" z"zo{ꌘvsԼI}{G"Z@Nqa =qހ7}&B!!yF_#3/<脦_
Qvü a>_E-ĭmu%˷osU:nժU~V^{3Pm
@;O0ѣ~~~Cm֬/KVRC%AUlp/S{d!eC$NarZy~9ݧZ ӹH^qhת}\;-|N,E |D4,чJ? 8avwN7]6x lxV9X3j{3+&FËɡ؏|(7xAY_ J\P~'W < xk~{!υ
LM;{ ` + NQ'zB논 dž
'''WZuرÆ
{2l ^XXxy))) :t۷VoҲ8CD%V lz7 2,獳8_
#,q{֊eR avS,"w_3q$& о L6&Ia 'Q
8L]`D Ʊ`* ;1WA bìw7 C=|aL$G] T4+nK`1ʶ wy5|ܹs/]G yk* %f͚[>xmڴxSI@l%
<Yݍ7&?+i*rˌ3 펺NZ"tavViAkD8 .\o2W^|z?Pлwʕ+7hR)7I T/<B қ8j/݂VXgϞ̘1+WH^|ሉ0`@g<^')J(& F#+K"FQrY9,˔R#iL@rD@B^0?`Cg~fEY#6ȿ\, &nw
+i(Mn"az ~Rrj9DX8{t/V50~3?h4<yr
k. ^jÇA4klРAjR(_xxǏaXv8d⸵xlڴy_ul˧UBFÞs-ݔfň=wմ4aUڦ.:y9XM[u(_
봰Jc% T
,QKa_pXUzXVQ/xleN=w}`?a쟻11hQ?XX:tJ>zһKHsA7o~]vG`d':uxɗ/_Zjpp~z!}
R]nѪ~ jVb? 큃<C@Ç'Q\BS I<꧙H>{cűC+oc
S~5 fMFD£=ɝ*%naq5=[Zr:ֽs<8Ng\{qS
r8ـ-|z
fJOc䎼+w )FRY½箜ұuƶ3_>bW[d=4Ӿqd`Q{Wƍzʕ+#G C\\ ht0z ? rcccv5&r=;) K$ Ls"ʕ(@R\
4-ޤS a"o}3^~QP8=CQ-LY;4ОPمT#oGBp
[mv+1ACwl.("mK#*t^
zn|6 :B{O\L v9 A2Y 4xzc/q5 Dp)v(p 5.MY?ճ%rAٜ:3dRA?~Ae
3`a 8ph4ݻ{5jZI#e c cufkLy9 0a>d$ iƁo 棒ydi i߯ IP" , nTJP)'<n 1t9mЂ QCd](.O< />+)+d Ͳ,LGg6N;Ţ&(ʗ
fޜ Cx<*粖O[h @pǖtAM\Rq,"8{ >
jԨQ~*W,4g}*be^-@_u< `쿤sE^5|0#< +{
Yop1 _Em 68.a!ڛE0Qa#^{g5h[3/` s 0&n` {t?C }K8">MVS+
K
rJiO> ZF'ețnt>wVlBs8K?ĈvVAJo"YJ{ݺu={zݦMaI $I|=HLD]>/;00U=9^-,[JC;YrRj/_yy]+[l]
$X*^)Ff+*0˻=AwI/#0 օFps/ |K
Ok1HT/ϳ_^Bnt쭴3LEC@?F-ވ2YV-]V !OjMO0ׯ_ߺukU_1 j5rÒ X-&/bt &9g=yVnaz?`Λ.VC8F
3疯]~4]Cw ڇ_Nj+]WoWn8=Cdmp6b?]ܫ^{zB?oӴg˵ rוo~|bvG@V\rK@.4eLą1JRȒ;JQ@`Z֤$[)_>}RSS)3 #zuRdBmiU4Gi( ]ٵ|ܬ 3n9vr L,6Zl^n];?L:vo6!HLjddݽkkpei{'W:tF"f "MqӊUt2I5i.6 ` 0[(C'4WVKRT9#fǯ!4E %Gpi-FCUk02
BUe{p
S%L`E>
cW4L.EY҉,"idc wX裙.sq0$<XE!`3T0${~%V.VH1ˇWGl}J3.!vZ+2E|#\N% xm`a{730g\Fr>.~ ̝yȉyv`YHWo;Y{zf´oG]]zE
M1v$NZ8cR1u6K}iÀGѓwxRz|_F~ Lb4EF*Y]RW0 Fa(--ˡ*ChBC+Ea*SMZe=77K&B =I he&E+qyi& ڶtJRM\F:(D2OOkY,jϹvؿv|
1;;.h>_h )W iӦ'Nx \`Yeȝ&Sa(aVϼVaxS鵳O>3饉7ؑ Nv`g'YPQ)LXv͌Tݰxd} kkk>,rVC._]<lWvשDiX4 XŢH.3;yK6~вq찥XTR 7?<VKFݹޙ#wW6`07../U+ a@2z{p\d:oCB
r1 1)o$3UH$R 1?] ЋX>@o R#hءeŧ*X~<,UXo <?ƫedv*p+*:uӐpNU*7x2*6Hz#KaqHʼn˷D Y >k J5z㱟W:%=aP 7mTmlMu<߬?QEY36Kwjʸ lXulޕphk#M±uqpιgV}cV'9gn?77ܳbK/Df6ͼH M;p^
rl!K}1(|ap7t@C"YN| #X"-9iybR6kJ@ ,_%X5u}jbLb.eNIܹZ {9U{4 Z˵1V?Cm7|Аޕ ՟?
N?vS!Uk\42r1C*nE0xXEMh$e8-q}=)oOsחc`4zc_1fWgdw$:5Bp]
np N%l`
)'+Gؿ=<JQ̜ SI V({.űc^6++d8rشAR[F&+_6weݼ~@8|r,Ua)2X?)Q֜;&[ZM5 ,tf6
2`uH9osipb^*qY]2QA~Lqne؊uP (ʾD+O`0WbE}QJI 5CAn?Np!$_ bP)2,İ,P/XEY"
Z&*y(? ?QeiR>zWH)"߫<B,
7'e!D&Ys]f ZTjCT27/ [8"(|9,|me]&u)HB U
1e2\.Go(~1 @Cu: h GtU]+m" ИFJb9^#>(# pvl,X rSH
H* zZA?K$p;L*f= ZR"HcIA Rn@E21P IwE0_"(&B!>h~}
pQa%nH$O{!7KQuv
A)otSР 軣>G`jO jyro\xN&
_˽:Z0mhqϝ
A9)nv ` ctX!Z 7ʈqF" 4,{!4)ca!I t Ϊ4{y
G J{^\mӈ!?5P{s*:o,Q<=MKtI1MaQ0b8xNE\RBn ,(#?v#z*99FAe/NNIAUJ p%KV">{!]ʵ
d źv7;SN*RL+" 6E`jo'˯엞YYW~ 1}qJSCr E#)m
hO{69- f v\ /r@bߕ}uf9/B H 7< G? : "?nscb+4t+b 2g8aڍ {d=bh8JN" QcD*PQb^V. \ߧOb^~¿I2#`;>7Sͽ'EV3V "Q($~W?a͢_. ?sNmڙE[EXtvNAum$wL7>}'K8| eZ
kn 5 ׯC#8 G fOY\b3QB(1kxS썃fP:u3*w_ ۈz0 ]mԱ>ɚiޅO=L|ʈԞ_;ܫWʛ,a E&BZI3o:Rg>tf_dݖ:Z'.2n8%2nә3;~'
u EԳ*6 ^#^ Մ1x GqaA^N e<$^*K<oවqs#EO-xv2XMZYɑPT
;x+4iW)h 9/1e Kl`fMknߙհW&$쩕*py5Yy^zoFn]/mI> R7W\zKT~\. ڌ>a%b: }W dn8E@< ;u{;io{2U|@qU˓*tgӕ ;9aā̇]yXٔm0USnkvV?Ț(
G8g<8m6))BzC63l UpQ-(CѠ PBF(N ײ^7v]>9I?=:[NO3;JjF|j (
h4͖|)Z@
a1 "pX "(7ew ԧ/
s_O߶eEw0Mfɀ;q;*?u.Y ߵKܬ1>tb'8S`i+gsӒ?0y(, DΡNj
s-}xݲ*+4j;&F2TFmod֨u:ng>'b jTIp#Ƀ(M~\_ML 7B@fHd0w6kɺs bid'WFVԛZ\<2IMiJ M~bժ"C 333Rlz(
JL&+$2>fAs>ѳi~BFcƍ!qX< D$JK$SK8C?#"Rd(K NNYCq:F}]u3(! N'`2B 8 } =&%8?rf7?! eR"f%*%J9]SKr 岺G٭pR&a?zbB*H
K aw"R;9rIHe
r8/r:v2dHjƎ +ĽJO;KU B)Opp
J
y#dRc (ل4<uހ?}3QO.eIqF)4än2X> mcq[h9 A/& Dv~*-@OmkދHxi98 ӻH| eNۣMhN }F cr>ۆZ D0LKݤIMp;GO2 m�Cjݷ_uY6b? T@̋Ia%67-SjD·K`7bwVan5_6rPɶA+֖ rQERID aB[ul6%R+m)G\ⰠF-[D0E]Lo =p&JU;)w үWflBqbřǷqڪ
U+ t&QYG\HA*CB.BPBܾ|M+(+7m^%L[N 8v`= DtnintYLKkR׳˫)ODi,m50L؋ m$fOK9TkЊ #(WMqBx#HePg%c]b\}hG Fv 1v>?~qYJ.S9dK# ;}Ł_)M~9g~q:ZN NU}v_}3mgneR"I?3PI'kGbw0N. ̻-}7udG7 SdY'1*Jrm=ȼq fI'VL:LRZnx]3!||Mco
GZ,Õ *e^Oe$e"Ct H/b;qVn'Cj=, Pn)"RNQN`2[l?R$]lE]w\gQyanVZaԏ߿Q[և %' m9uP8\F>uC iq<aqmh{ϟ&?ur֦_j
94_}yo hn M>b=&,@p_04#Ԫ/ ]$͊To_n q՟WO b[\!i2{ pjϩrhHN^ˬ#sauB"eÉVUZG[1
^|4{B7 7W s8^a=5# ^d-EM}1F'Y+:~fP
я &
zaUa$ACQE =R˥ЪCh$?K,4ҩ)oݺUHYʡG0f!NYPr('e_ɅWp"H*kHV8HY2UsRەLLLR*sdT@@@zK$B)/N<>_)M> t Ǐ?עE') R VVRvIȾKb2ݻ]p9`+VP*`ZVr@T|UQ) Lrf@;vHOO >|X,f>wkl}t@'}
$@ e7|!dX,w]|yfիGJB`ٳ'--
㈈ j5wv xQ lwu§@9sݺu0/%@R R3̀Fcvve˪WުU xFFի:~|t,JA xiv[,պo߾SN
:TOu {͚5M4iРFt,}k /h9i6 Ν $@cA<
kԨѾ}{R XPSoR o2PͧO}ad^z5`nݺ )guGR S/Psnn͛/]Tvm/ nR 5Hf l6MZQ(X7) :iv&c) @
,@ R @ @ xU IENDB` httpd-2.4.64/docs/manual/images/syntax_rewriterule.png 0000664 0001751 0001751 00000150167 11577356155 023012 0 ustar covener covener PNG
IHDR > H iCCPICC Profile xZgT]!< QC9K r "H%HA%*"$DDA@AD [SO v=44 GYi W +gx1bo ;1}2 9b{`8fGGF 6Y; C$! x.x=v1vw+bOtwA0o챃evp?2,C_0"B{=xy{
Ab;D34 i+@p!gds_@ ̋ɂP d"@lr~B,Oý"h!}^ _ۛ ڵPZ @@h `̀5p . A<Hi d|PJ%p\<` D 6@@F% AP C)PBePT݆:^hz MBs7h a* 悅`)Xր
a+CX8> ep
|ng ^Q(fB PdT(* u*EբZPQèϨU4MAKѺhk;: @CWo;C "zCb1z[ Ib*0M{e
b:X[6-`b8'S\pY\7{[xiO+w
>
#
7H R)&)~P())(ɔ9W);(_P.Ra䨌<SRP=Z"5-!pPFC!,Pc*'˩ۨ_P!Јh ɥ飙iyhUhmihONAt<tttQtt
tt^)e [ Z^113*3:01121n0q332%13u1}`1111g3722d`QcqcIaDz*z-
^vFv%vTjA $lfXNINkx
ǜK\\$@<\34܊nMox<2<<<y^x%yySx"2D'qb- %"'i69~f~-P}BVIuo *~݂+BBB)BMBS Za#"(9Y UQqQ'ѓDو k?&~[ ={ٳ(/a+!.,)&"++)OOX4tuiNKt22>%/{twaߨ \\yy
6
Z -+JJAJJ3n_X<UV5RMWُݯ?e֮~O}:4FF&FSOfATdO:OzͧM֮Ҟבщй{LOFJPﭾ~AA!y)#qCFqKIɺiY/s ,--Z,іfE dzݬYLJ1ym9(99:
:F8>pbttjtF9[9W8/ >pE%嵫k[[;{{٣œy @Ɛ uho: O/ٷя?[ c@@@AAARǃ'CTBrCBBB =T F v?+<&|$B:"3c$)4r#!V4cth@̞:qp[\aG? ӑ΄DnG;%}L6HII MIUH-L8vAHZfڗo>tb&8!%#>c*S?zSᬩ'NJ8Dz؞i9۟WO ?ybAfs
U
+>;uABE؋ m ȖҖ )/s*{\R^]QQ~emR%W$_Y"WjxZDͯڐl=~zShz
>6 l i2hjpMo1JocűeѝV6껂wmiO@w$vߏ3s.w[u<5}HQwN_c'ZOk |Jz`P{{HowpɈ3gGGǞ<zA~12W_'NӌaSVmDwF > 98sǺY9>} y{>celQb/_}?ĵTpjݏ [?V9Wה ;onm2 cXo,7usߍP `
Q~G B;
!(,BP:4;Q':n<҇@#AE?̘ì-=W9"(э/W!^a(b^o dzd oQXRRTW-E2
Z6(:zS_
V
7ɶ9dⰖ1;a_iy˒;<^H>/Ac!"\-#L#FƦe .=r35ڔԲcei%KNO<u2i39QayAgm )qg@R<QSZSU_apI2 SWVM^Tur .߸uT;Bm|ww]nOKkg#>Oy_ l * >:Liqt^ }5F fmD;) HɇYs͟N7[^x|Iue ?>\Zsչ$[`Ҁ
0jF 8b p)G5FIkN0TƢ:nQŹ#ΫHT3?(.xZVg1&{|%%I}a%
wVC~ZRIJPG5aZz|5IzQgVwy {7Te'ZDZZXg^+trvv>Xr͵{Ggk/wP'CB EH(hX8ÁGlE2%a֒S>;66z|ģ;Y'ϝJ? ~& {0*_r9Bph|ۅi%ƥeT/U2\abXPPK:M u=Ue# }c[C͝Z*\h-h˿\{IGλzF ~ 4Wof. .
/,< yeƫz_vybuS '>̜̔=4gIE/S_=c)|Bz̮a 9.Cf 0:t 냫4:MxB
ҩ21j0c`dyz-ݛCs;'ל(G@`0Hh8jRtR eRe,-ٖoVQU|T":Z[4OiФ:ɺd=#[&fTfv Vtomjlct :f99g6Ļ깱H4b _Q? H 8T"%SaPDo(hX=DiWNjMML?:-Yc'j?={,+W67|6 MJw . *1/WV]>SR+UW}jk\;T אx-f-w[
^cS{=^Gv}Ꮟ=2pghG㯦4ZWwOY
8eE R`NȔ,
`>= % 7@SpϜ 2ET ݀ + WOU? akPchj&:
]` 0y!,-Q qY!<;_ߢ0XAXWw{NB
.u#
&6v&}`HbD1&1ALGs2 %*{( )n>& }1P"XƧвpHآxc6?dFg%+ (ĩ̦¡ʿ_RMUV0vNs}` kH6:ggn&fN֎6mvNn.̮.n='||{I'
d~ 7ߒyT'i1%KZ LR-,P/d.ziK*V
W]ָpZz~]"ݾm>+qfg?y,<|Z/
Mխmv h
D z Cj
?4t jAj
`{5U
RBQh z?:<?Úa83O!||$E ¾'PQ*&3j
4Ettty R &Lhl^V 1HnX,2Z.1YB5{
|*1ÊS" "&#-3!۾| X,r*Mm >YcS$㫛צŐHi9762ivם9ttsF?~7ބh6DEE
[?7q )0""MtSӅgrnirPRlQ)kQ_VSKwmVᶱ{;<; n,?Z{B5 8h:|YWc*ot&5Ncfg ~\H2 Z&vE$Pۉ
< o< r\V]8 _PtT?킾^
XlvgG59bʍjFH CCCSKkAIwޝ1Ii9Ee̮
,O
oQ7[ d3Wdeȇ+++uՔ|55IڕzF=&2yH<lEk]mke;4: D${r" &^If >r9#^ʥcG[dgv?r~:b}I~ّWv]ϪnlyŽm^lg{oe<Pd8rk4קUMsz/8635;9~leKתomؖVxW~(nwҚZں_ȿ.8qwcvqf--ĭ[[ێg{wkg 01I{yn ȑ hSł^Fș ٷBw lcvD?X;LH[<4Bk!;4 yB/DGO!6Dii`AwGY qv,{ðo/`g,&@ ``D`dT|A0Rf H@$&
х 0 E&HCi_{$"e!h=O~ ;م%k?;FFfNfϜhyZ
VD4 HJz 蔁.Fz3ǝ΅Ī"ڝG lw
7R?[iEtwu#o[9fVBBc||#H$Yh)%A+# { pHYs IDATx] \M /m/-R$*;:SAaX"3dߗ$$}'/[alM$)di]Bʹus
sss4Q(@eA@ W^eE"@~ZJ@;OP* ԭWKJ;DTm[ן"@tP^.)E"Pnj_{ E!@zC@F}i)J uQ(U֫P* ԭWKJ;DTm[ן"@tP^.)E"Pnj_{ E!@zC@F}i)J uQ(U֫P* ԭWKJ;DTm[ן"@tP^.)E"Pnj_{ E!@zC@F}i)J uQ(U֫P* ԭWKJ;DTm[\^MiQb4llpw߭kC!!lrqq*
آqHHÀ2G^):1u1R+uDCB? OX|aWϟfʪuI{aPk ֩S־@>}/ eMI89v|UgAhJ uR
מ<ififfV^=ssFff_ߥ/_om-`ΜW3Ƶef۷eJ
|ׯߦMG11666ᦦJjOC'ӊ
9̰NƍǞD4iC$BBsPP vx2P^z
==%''o߾fm]*iԢ@UbF6iMDǏ,W>;wB?j_,!AAΙLb\I%3f͋ړ'OMNHxI̽ظrqۛZ\UWIn_N=z"/={ $#,xR32P:=JRRgy#v3gg(܈lA)xH44 ann1hOR8,ҚlH>as>SHNyW!lIuʩNN2 @z7Q?#yf|ZZi3f;{
ۼaܘwwI{ڵ(͛75
} O# "[ΐ !zzz m۶`G,hϏff<~4C_ 3f M}$6.qbiim l2NMʃ( g2Bۚs=Ellm`㛬_Ys : ]Ɗ. ┤Sʛ0 _;F`ґ2_z3""ng!j]_ HAuƕ" ile@
|_<}ʶ^sHx"M{𠟟M~ll|Ҳ_#Ghk?>+-5S pvжmh" ))q_7LMqbffm<9ybBٳgيl_Awp0!LL|C~C.4lcCw"))
hRTTThhh\\ M>1w_]Ҳ{dmmOq
N..ǎ ۲fO> 7,DK eC6` ѣG5??7jԭJ~5\yZs OHH b`t锲×/7o\ݸ]:D-3ot/>|k9̩S--f##}ȏ(Os2iRG+53yWԭWkֽ{wvK)0ٳg?o))Ɉ"{ue~Acil cGf2v-嫐GU|P!3-Y燳7+++>}JE rE^^#nJm̞S$d\s*;[+\\aa###0D+WU-2իע;ݱꓘߵS' ;NQ11PvIttxzO 6HyxxDA:5kR-M~ZZڐ^`D@~/cbڰw [[GrÇ Ql77 _RHug}42eLE /Xq{P[y}##=. 0Դڄoã͍`Tzi}gψ?<llf3F
WCu6 矉ф e|.3ُ/_\fX|;e+@U5G
+|u\Idrs-7_1_?)7a,F8;i}Khw...P`#]676ӫ>!}P~q7
_m]Iu*L{SSU7 2l(02
{:82cvtBnL{7
LI?/%We3]KWdTUCՓ.@+t^/ EG[[;ٙ<YO.cgIEE 椧ra?yY]%.0YH[Ņ |$`F-Z1$ӧ "woH=ۆ8u%MMf&$#v
f2a
^M6-&&
ۗ/g>=ڷo y
| O 1*1B>SN~^I Cu{R ]*q߲֭ kkoDVW"T @G")j+:3g Q@d?<{\=Pm0,1{ޙ>90 nk6iϪ@ d71z
c-U w=*9%1~G'ʂ YG'u 娨u$:11lC4IOZq9A{` 5d -q-AΎ [I\Aft<` 'o
,VW
z""@GI 8?&f \t4Wvss6mlW?G 7(bC|80a<k{09Ħ!l/<3q 3je%Yan͚B8=k 0 < !>5aݛ7g%"_gipeݽ
f,hʂ7uD֮ ORrB!J!q@!KKHS3$@'ɤŞ=W9(WRR.Ma)+cJ u"c U6a:xtW`ѣpB,nkdd ~L`I7X]|gn:;ހ vmn sqrs M^^[y{s!Gs7
lXI+۫8|^I+c_
5 Mx',R3yN,#`c3w7 a3ϟtxy{;;uqHc ]^}>Ǽukh5g`yZIk7˽Q Ng.
`Ĥ(
Bx/*5CT1.LZxSxx(: `+ f'E0OCquc7m0+D nؘ1k.#:(TibUiS:'RRy^~. @7\P(|C M#$s٢ t5 >̐ >qb=+OWVf ֬q>HAVӿ L p/&h+d3aY+L <x̎rcap f#Sግi܉d۴`7)E;o<iӦ7y <<6[إJ6e1Xv9AAyUX~!!]yXY9Y֬YzNlFUVڿ ;|
>i8黢ڴm{i,L22jHj졠nB_AI1UWWǤ"YWKPz N0TTSSʂT jF$`J8F{p̑
\
-lh NT$URZLJ`+OU
<¿rz GOw E|`"ݎ>=67,QD| *8?S\DfQJ, qqeH6KThl /ő /[XP2oH7hw"aIF E| @G:v+ a$ 22IҮڣP'4^> mE"@hlKPe(@yFaաmP(%FCF P( uжQ(#@z!(@yF|uh(@nĐ E<#@zy:m EP^bh E"Pn<_ 6 E"Pb[/1d E"@(P^mE"@(1ԭ2Z"@g[/W"@K -@P3ԭCFPJ u%P(աmP(%FCF P( uжQJPOOXUU Ս9=%{d)%r)١f(@{;ю2_j&-.l996U(gdd%L ={Yhb0ŽwǡҦJ_ c~lE" `1>o/SV991h`y
7rܺ=l\*>zv@s_ u_ -M(CH
"iϛz uVH3S ?KT>~x-(VT L
@
5!G}}G{ I٣ WTT oɓ'[ڎ+6ӳ5]Y, IpsFFf)3Sބ>3[Αb:500CiG'ڵ:sGrh]III&I{e
cRyo㳘eDM(;LSFVhrP%''Y 0~ta) ltg m5^ýKEj**t먕, Ku{?aɫMmꨊ&
oxqkIgҮjP72ƝմlS.wmn!<9ZAE}}߿bJ/3MWIZ8d4:? 40(ڡGP=#)ƸZpA:pn@{ 8^, :R` r7nѹ@UGΡ$>CCo:@jcon 48;EeCCh&n >'O@HS^yMZu%[ 8ЯO11i_jXljEhȡ@E 4ʕO\E !fbRIN(ll`t YY*?qsppr˭*bݻNZ|<9
L?<L<u뇁6NQUZr1av6\;W`A(>#H?,Q,QA(g|[m8LK[AzzvI(җW,A"4_Ex|/Sݼ9|\= ɡu2'ϓf3֭M2/^)^lWTFY_ HMHH̳W߆1Ryr_%ژ5}"d#!o~ ߧڧK!uع:]l㳔,f1F@!Áw
GWWZ5Qoc鑜,Y˕q%%!_Һѣi5:S+?mz6iֵSR L;uǶnsze;DDZ3GVtuy5TatW>5l<{]̌Op TZrr 9e "9Y}s_ -##&0olܢ 0ׯ_Y j֬ QRK 4:,6յK*" ]B<aQafM0`~ʹ ?
u:c߱ ϞWZhV-m:zW$xmaisSgo>^NufizYi60ry6=|ѣ5DV o&V achbIZ
ckiw {{m <<OKCy>j73̈xh6iwU2י3Ƿik/T/2EhѪٓ'_ NΟ3y5|E"5 #\RC}fWZ`)+ c4op7ۧ$'/X(&m]1c) a9G R,^իˠ
>^. YILv[mKW>S.^
nVQ zVOOwNI>Z]`N[;_k7\^lw;=!iRt P:G^[4mz
Fp"5&4_Rh {uu#7q枓'#I-)==kha!JǞuc_1=9}aTcƭXsA K}fAB+Pf'|}oڱ%?
kGGGLNk354^}DA#ٺ57]lyӧ aL֨Q#74iTW֪+ Μ .XgX &){W %K:w*;O""RyժUV ÚO>q> lhAtRVVى<I'9 |2L¹&pʏ.^ j$4:f-8и\MSAs}gڭ[;'<o^Cf3f C`cKdӨe9B9=D\"~D8fZFGaF [_3C2."
05Cں.~.66aOK_+mZ5}/ +aH5' **L0 7-p2st_߄ ))e_BOLLn.r>*Hؤ>Wt}R˗a ?۰#OoZXF#_̷ի ]_f7o8"c4ss﵉|c|Vʍ[EyqySx7~[cx:ѥ8!.<Z5妜 8O : T p'^v JnDǤp5p50!K# qg ,|W1h=ƽoNl5bTѺfX/YP\hhԷm<+GTM uǍ۶mcrqc; 1z[fV}Q Ojjj
b~)H̘9 n!= =X8`{韮Nv^8Fd#=$>y
!'m\;wQ yxOIɐHIkQP8ߵݥ;xG5**(Z5M[ywbC?+ٕ^zWHa - ێ.ք4aVԩSq4E =q0_}hǢUmdfѫ[C%=~Zj*ouij x IDATƬK!NN܂̏vv;VYԈ 2^5g{1\@𡁩ǎmM`.xsG_3甯xaɵu|]8#+Y;w3:k> }L=Z:Bf;l=16i&M@%B ʝ[/P`1;FY({bCRvUVC.$J$b
B4~/l2I\
f HD:K
o#rA:ϙV \rέ .CZy
Cɗ9 hO:u,zD`+[|-Nf5}1TDVx«+^ 0E' Pn] R
L_ f2 n8g9Sk)I}z`\-T307UD&: 0d\/iEyNNMf40hԦo."9<>VWScl_rE"U!kYd*C^v ŭhj-HODJC8«*k& ѣO9õ_l|ęG;k|g}Ďr-a
=*iDxm1).&kIdˇwtKO{vQ̂b%ܼIت@ٳgKF(V_b9%DJY^f]\fNSdu*[7*cJlҠ#H6:п/of aM&Bv(CQv L2Ǥwor:) _On(I K ߗԤ<Hlu|<J2J{qh=~
n7t;pZ[]|EY5մn/D20g~"M>.7LHyO9 3-chai9i1{fn9""bʀfxXA "^wY%IMYu<[e5=Ûr[hkRIBr*[WF#v=]xfʣn"EK8Ž[Gg4;x m\8fV.!
jՉ45oQF\\ej
`ee:e@!O6
[_y
_F-2F/+*NN>RLxSp@xU2
Z2XOMbٿ>,T1QwX 5Y_^XWK;-HeQWo! ;r8cSIi'5cmx^l]ظgǟɂEsBε1gWͳM#ǻƢ\?s38eSJϪa]Ms q;b;`mΘqlL Fj41u@Ȯ[KHv%Cl;:O Ro&&F OnfIjlGNYyŮ#:}ےB;ԭcϹ5
%Lp'_ /xJc`G5_'Ovˑ5%ӢU## oJM
q幹?OZ_r4S64~uO/.1\ggf(Z;w&
^J&S0cߠzYϬ+[< <Oa*ɉj֚6qF5%+|؍ڀf (7m1A-Pe "AkԊ=0;r?L(J 04k7'#
m]E$ څccH٢r>N ?uxi jL 7ѤTO0LU~7
fgdm!u[ Ql#
տ=;auGp?K~ =o6:ޏjIqkfwT* gYha!0`ԆlA G8;մ o-Fq"+ kd6M#;Ŭ警
ז7)+9 }6qHǔa$ 5?eoHN)UlJ?Z̞onme][Gbcc0K9pHiqHI4 z9f: 2'':gssj;j$,癊E*tba8ҚmIqi
M*"(6O0+e->>3>>]V[ <Iʦ|%*-jzzDotրnN+VcRp{RlNx% +t,pهVz.'!<#UkmDBnjlp/5\ajj#.9vc#M,.):;gA<) ;)w
; 8=f
DC)aTQ%
5=^Kw^r-xhH$:{Ճ/n(%;QH
%3fI
c
u@lmM[^<~m[4C$ NXl y+ tzpk䐫sut0U#uwo-SG 6GŮh͛TAlV\ M4ϝO,vk-ikAVQgƌ@SS#,;O \0xW1N (H^7sK1Z6NiL N wFS|-&E2.jXYP"/ÓPd{wR lw8=&Cើ#u&T YrHءɑ3-KZ2'yGETIr =$ɘ
zOn0+-.bp0uoetCt<cNSZun\~)1GFr?MKs k<0@곻&щ?h(${fi~ݻִ& 6ݳ
~ߖ; ]< ~,@Gv-j/̙svˈ%S[ PoZefytt^p ticrrs;qq\9s.%wC7_G pѭ~i "rk]~W<>n(ifP8^
W !QW I@,N.j1}]$ϣ²5[fin6H<mմ;L3[lȎaک#qĈsl̸gfX{ĺ3i>OKj
째 *3O?LH
n=vr05~-SQNZV.dlömgf!O|V_fy#^4{l?@*Jk_g`
"Z8Ƶԭ|KHP'' `B&&VLT>"$ Z˔|pKCrRմ_].Yr=yWxh4i7ix#B4 '2-<> l/@,4Qo[ȑ?n]WW3-3k&K}YBAOP WpkO?ab ŹUc6p'`?1M5l5G$b(2
]Y2yb{hF'\ LQ Bw/gϘ^}գܺ,:3)6>A+Xѫb15֬r*Fyy>Lф<pYI LҚ D0#OEpW39ɓsGXd oƪHRXFO555x9S⟬)LNu#b,;D"FsXi D"UQ$\K bP>Î<z !aGYۯ
+]y$7WAknɔ;N!_%hQ_Gȱ!Z_v3 f gW8 [5ks(0ne)ΓZTy'Ir,sVn k3{j ̸r4Z
.aU0 V
ذի\cuY2U|T<! >4 IQCqJjXHrR)6L9ee4
<|<QpF _WJ=\|u2q;Ypl3NK1Mo 76♦u{1 tGN.s#&vFt=WZ|s"WSUp3bծWOf}tB4SLbܷd4zt"LEr;[xAz"!2t* p
4S(wS6o Ln-oc5.x-Nq ڹIG3 W$R'sԯ\ }yX>w#玥` t\yY afM[`ZҲKo|*$YS'7Zx㬎F
nRW3ujurh"P8BԈ /= "PLKK{P&%8v0 ,&v D6{}qIjjnMY*vz6m܅|qW;= g:Ctަ49*]=W=="%TE ^ێK{;[2%U5O<#4f[ϟua >}q|,IBn
6bZGv?oZb̥P'#\{x6"? ?s-sh"@4cuZfۢF*"k%).5S0$."yo⭻5 6 y:XO?ycNRJ@#9s
2X6UKHQErYòա/F a +rNC% Oi,\QҒ{yȍD+g61+ Δ:[:eXW!'] )KS|;q% OI˺oc"섏QӦ8]v-Zy"6RQSC<OKQem\ |%Bd9hX8o_89pճB-Agmҥ7P3fT-v B4 ɡR_vp MAΣ6ndݜ0®քB*1nGJ+P٪eɓ18;= u%@oe3|B/;ƛGnFBv zvԎDNyk7~ *קz_`y.fdWsT55>wp
'`{]\EFsːW)ZZ c_)Y"],l<W5YUA
I+w¬]bw+EPݛC@NRv_kAAEꧧKŘTR{xL "__ɋdL>]
H+S:Z/Sx ^xt/.FR_ m}<;f\CG}9uN
zaf>%S lm]FA>#)r\PiY)1{a7fM2/)M\.p'E k7k`lk/K]q"J4&M@ gz.N6wb8~s[']Be~9Yw9?ensiZ\ۜAnt֙)oBne
{0%q
PɊ =κW^N*j㎍.KDGZrOIi*:,^(;T _1 AŴ8 ikkA {cgӰ]~[6%OON>xdHMۢ@M|O3j=lymŊGY;7ML|l%&֬pC\Gްu?L&<zRHɫ}LF[wlyYyb߱-uh
[unkzi =멭ͬ M*E /p*7wƈ`7n.CuQYa
KXݦ6uTE 8pX{/0P Ne>6!%;<fcuRq"u>}?Xj-|sMS^A%Odh@-_'+[x
ᔯi`𣕑3++G^,傥|X䱓'.E^Gačo>/Kf¼_panSiǥ9Y1&2+aWHIj?~NCwr8.I 0$9w6,M-_y bvܺ<}`1(ƈQ[mρJ
ԲxQ,Ց3IPe E{g }1P[G츸̬i՟6n<%\u=Sz.\u{J }WG Ik7bmi >ڹAޡ{FHHR7}=>|D{>?O8 4ʕ*zxv Y ˼400G ;?E?<!q^fgMR]tu'ȏ c[v!7=xks!5y!E&ݺ54umxU^4
ZN[|~ R@ 8Ta /{!9 \8#OOfW#85,C0D:[V
wKShb|J~Q+OA
žz?|w$<6e3%]L',`u1N!Oay$%r
2);'/(9 S\&I߂*+
{vx1dN
!s
mO\?nv0Ņr60>^}5wyU3+G o6$q B/_ee!x!i:"a.PgMY
:u Hpy#c"ǔ,`Y$%`Yzc)'T+tFsG< `P(\\#4ru*N,
oaa5I( ܚ"C 9c,\>A* r)qM}zWdnN(d'qz@(<{ux݁d(e8,'C[b {hUd@.-H3sm _ij4'QAxEę<vrRDZCIJک?jlڴ!Wkվ yeUu^ٟ!cKJfHr)j k֬Qx1eWa+1J8z7~PL5->לwڑũ+|$j8$i+:=d b^=~()z%DzHl
C>bY=2So##cWds aMUԏq˗z"hɓs4ܹ Xp^Nug hS7m
af-A'W!׃6l<tMeCƏnkeXmH){~3
?g.( xDHu۶`N:q7XjVV~[ϨG߽-;~.VF0|]Ψa66̳g49y.k[-]wgl:ا CVst
$
нsiO%BgA ;G\ Z[.5ԯ+${Ney۩9 zYXk`{'Q\KۤǶ}6L~
KOKA~Gy9gEb|81 #YЊ}#>ݫbJo~FRz.>y꜆9C\\]r wcρ褻\ xWlʊm$%{nI?g_}ݞK7->kKK~3K!&. ^xh v):IXҿxv!Y[TF3 82 IDAT\!l=p=Ted8u` - x ^*X0O<X|b>}{zz"fujhihijc|!ж@y1~rg]Xڒ++ҩ IJoo/s X? |"ru XIE~>AtLȐ<AY
^a,YU,~klA; |Z.04sˀG,cd|1jYu~d9M8TdRsIgsٸ;\< %ذ#xEۆ_N
u'.) ʯQn|_<!|Jjq#ǷoЛ7ݝ0xwVVV~6'Ǔ2@Z. ǴXp>qYe :"_KgšDnns}gڭ[;'<Sy;wAM''wөwtꓧFGodp?;ύ&\Yd8bqkkS]]teY= P~ / ?K/vroɶ-
27e;3oWJ4)Ii$ܛ$/KN䲟`r&FZp D {+y
őWȧ-9b.[RYSTT-R
< ߿O[ 1+es>]nB0vci|h)7=b. 6!/;P.#/NҲ
=lw۶I:^}E6mmR%V f߷Ӈ֭ឥJ
_)<gO@R#LQ i$0luNG*5L]
Lz5lb-04>6Zih ,I,qy}B\5Y'pOl>}1):Fp~9^d;'bqtfp'"K,^$:bsYMCBpYKMA{lCNO:6lNjED13P \g<}? rs54zm1 3aV.:W ry:f[g_lͶ1'}aMH 6ED$6>P_а;U1lp=W5&|&E{:W8O: Z_2 8CD.XHu4 !gfK!wHWJ` ֶsƓ
(ca ;'̞j8` 4
nsX)N `mzyڏY tm,WM:|gp1d9M Cf( 2[$! _:
[b_prfb$!j!_*P+ϠTܞ _N[G@Ų--,߸,* b9
,6<^c|5="/62r RE!cNVJvRLP'3/<h0ZJAB*(su\% #آ&ԖQDPde ѠE.U4-BX|C '@Ӹl/ v߾*D]M-5d,~ )I5"<\ dGJG 'n
5vKyɒBHr4&%)
C#bIj ZlDu8SSGDe˿rLLi念_ VJ&_o 011)_&i m\8YVKv1h@qZ
OR b< :r葜M n'cG6K `ܺswVVJ80'72Uu2[AJ.H\,
dg%uIyM530XhmW|f05):5%p3L2 q
4/v]; ,,'ƭWY+wU\djnڸvƵ31TGL4u⭈~H_Y90ukad$ E 1oj
&,D^`
z.\(M={_5մ8cl`iBRfΞ`祰?9|,O:\yhl`FZw[)^'wtVz8aDwnfi9u1ԘmG0鹴KxɓV߿|:h֥QsL]D_D}tY<0pr`)b<8WoqWW@en-
h# zX#uӼͶܗ w8~C3z.ՔV.*l/ , 9ZY0 :xQouS;G ൰;W jut=}Ⱉs6Y6,oڅSrxҕyR39Z5~X}y KQa~j
Hʣǖʹp lTFS殛ERZ 3gWx^)(
G7-24i &몠ghojg7oj-IMzf&FHc{IXn K R: omiHzv-[S ~c
K5p8 벖ZJ*wPG99v v]ίZ Pϙ2+P$#X7`x?2/cޣVQ,> G9Mju Oѿgdfv2lwP0iȺ '=Y±Exu e)jNNt\d35&yuٗ9 /8]|2.hճ'kYCúd$]%i|&bYI U,G #S?}ML^G~vlԩ+k|;S+<fnA۸ϙ2CqJQ-^\I
ɱP Ѭ%3g2[.45Maa/Cy0U*ԯ共IOseޜdXuIG3Ir ]wIyjIlPz>Ozsy \ G =v\j ~.J%x;v2(:^
cNYl$@`
gpx" ; /Hmy+_{ N\g^$+\1z^/@ϟz| (ȁ; f¥~\
WN8"3Zn8ZKSӾf#r\9{`$`].y\RtIŘ)Z ͜M>5CCOwtvw_<VMZ"u5:(O)c5(7H $ohjͳ>8, L>KVn[Ņs3o |{=_u,E[z..}oG@ב %
p~c,77o qBe2~vۖXb#urRQ Xu<ąET#.X }nĀx4tAÆtvOl. guDNr95Rvy x0yN}ز gʂ !B==f w_ Y2KP#:8k@;U oڵ5.Q̎6mJZ_XS[9RNFժ|! OzaP]^ ԜZno{z^<a'0V^;1OSg9/ / ͯ ,aBuH]QURA^ 7-cHUWGHǰ^s
p75]Gp+¡\|
{ xꡏmGf >l@Am/55ENX^#MȖ kYtӶ.Vm7iؘa-mnaV#F|!ɘ>Z}ldL;ĠgݎG];x+?tY9"XՕc$-^Y[Nv͚ϟ+lHԵ䱭Ǐm|5lM K7n k
[0OR vE!lg5F
3_з էL-a, c^X _J`.V"Q|n ;gO-]O$\bGb_y%e/+[J qxzfCIyX'`ryA~!̏P/Xt
lq&,ȥVI/>pOߡ=`|0̚idz.˓nի Ͼqj, vMy>
_t6Z crp{x V[j`lm7_nhጂ[?~څܦ"$Y|>W 59-aDEM)" y9 ߄ 1u - kqq?ge<ǃ ;M 9u?θ (gԨVnqq+22{屮k?{.] w9IF fIccٗނB]Ag6ͨ+H.Dw! n[錞<#Ο
cc,w>[gޠk>b"Ȭ.; C'&VfO6
CQ][8>@l ckgN}Qz$O_TY
/5Q`].9sX 淐V^O.6^7\ F|u)t<
U,]ħ/[ t.|N1|yRX,'Y|
f:OXr.g͛㇚ }yѡ*V:<y']X8DuF-}/UsA̴0.?.JNNV\\ Ͳc($ J;;eX9d; .{_v!1Lzvf $$ Aݻ|x3oλ |l n"/'L l"]ů6l#H'B~EzfOy|{H8I~b
Q]&RQ-5εq 2/RS\FJp6sl \).[JDͲ9 BOa.W
R}\Q#e̲~vAF|:9Sq}::R&nRoc-LD[)7n9vА9e%*;rY9Z:+g~w,9 E$s˴4 [M] xP$，= ;zaL'; L 8I.}q
*҉yP.CLSY Pcbl ޕ.,OIG߉.CJc0eD\eذoHK, zAZl[tSSS7?$'Q_{qɺ.[
E|Ha{=~DӹD~F9{[<_"~&f i:
.wsuxV
|2(H||u
쫑+JIMME.=>ƗdplxQt MUοydq [B(;=# z֣68aouij,p'C8u'|vhۭ+'y\Y/Z&U 쥛)b-2{GvU%ë &Q^okXG8: zq악4 ^vo_
վNC 坿gܦę;Yگ>j:iV|̃_cf߱s]$==G#' .fQ5o; E)@q(uau?)R?8$p1,
[eҒ$E!GeL /,f^,lJ;O<`9߃m۞Zb6 jdT 1%TEF024eŬB4?x'%xU EuBM6:Ѻumx
0?୲) $~) l1|RYn 7kA`1k'jTʧC7Փj*8L"MYy1-(+l6Y"+ Ek(M-BbNoѾYl1;khf`~
L ?~7_RUsJJ)
|zw 2x*c ڡCƕL_eU. ]. RTeU .TU:MZ4i{L[t~m
HE%/h嫼Fia<!-$UT
ý>3&w3~M $"uE:* ?R^V*i :^qwU*JK-QJ`;h ϝ<n'`i֫ze0, wנB|v=UYb
ԭ*@u
LM
@q v _Tԭ=]F[ ed>e`T8ԭ=[Vn=SY],>Q^:8R+%Ezu [/)lUZ "jQoMG@CZiO++K4j~HK**m+ɅpTOȮpͦ
Kzqn8(QG@KK=5"P5k 4H.B.Q`)E"@cEBDK7^ihSi>q/}$Y)BG느E A:Z/[+ȈѕjՔUUEF&-ڵ2c@@Y^`BCO)L&aJb@E:a XIhF
֥ ]{WE?r]*S^ S
ФAPdafև#{=P]
"ü{ R{ 93Ycw9{~;qktLBTHV =nYT}DږA q܇,u5ծmh.H|:W&!F|d[ TT?=qv
]^VxWQo$]*nP^R2`Kјi" wXg]. )aI=h+a!m{1eT5[7ب2uLBGe
/5.**pCF֖hPE"PѢ_ xx/g"-D(Due#YY923)cL-WQ[_)*++իWYGEP_u%J5+M_*KGGG$,ˋH$Ԥ_/-p415Y[C:,KBxDx٪=y3ſ999ׯʚ_Ufǻ۹>{N~7 CFw:Y)%II̥K(
? wz?{]c{OUz\qPqL%G*
EOlڞ~JkJjCkKmVUH
+9:ras͙ofߙ＊b7b'YPxg !_Ж@{oKc_3`(=<V?+a2* ޮDRdHB@QQ,J> 1߱"9 V}t:DnK#c0::6#`X;:n?qZoa[.0
x0uPfڀa _`㫽H
Ew7[-/RPU% lз1C"zU3d e0 f͕ܼq,PXߍưܹGR]*l=E߉[-[(ͭ'SA6C9,%7[pr̃ֆ.S0lգj2q^#+_9/VH_-Mʳ+ IDAT[nf5"{-ͪj Q tuZa7
ފ#HGΨCV&\i 3|r {EOii$;}RZsU KM
_=uxyIDz6`:I*!eO< D. {w YHoV'{>w6πq1_/I6kf; &6xqXw jA W-R%
$dLv0FFZYY%
$0]Tˢ=d
w:VmMh#p]JTbwh:it(2<ЍRJ#b2-Y[[wRW7voG:RJ Swo.dӻYln cS_JYgY!@(YkJjCˊ =s[<u% q6l/.$Q쬥sq}7$Ω? }>ҧ ׄ Ki x``& J)+ee 4bx Y011ю=d1Xooø$ޞF,V/L::·܄=,EfAqǡ{aRQUK^s1;Tk]ϧտ [lׯ_K^zwg7GN s |?|,Y`"6-
$h¶\6wنͺMdnB<iu9ճPeuī`
_یGcWxL+*Xm 6 4 b3_/ Ɋ
apMT.t 9qדI6ʲ?* gQ)rpGag6WG؛Vx⒕'<gWw?g59oxw76Oo)"<Kmn KdbD5B6[{/bBxyhDQ3̙#+[P\(c- *"5sV PPk.>z$N%6~hp :-Ȩ馕IOMl[)mլxIαg-_'n I [E_+fU ef
[t3Yd>'q͢s W?j5[yxxb> (H<Ek5g*Yф!y X3T5ϼYpYXV%Z/?O;O鸁"Y]Vr]$16&bYYYiQeE܇a*'=N=MUXR,(0gM/ؗy9$on8G9FmR<羶 3ܒi N>eQ^p(%CE &sRWҿ$;Ѡ"Z+\^{k?P߄^&bfEkiP+c}ìlYDEuQQ36 Tul8jw1VQV
?3?)e7127&߰̑箑 KItgN_xkk5]>0.u:6e,eڤYb5sTK94=XUTUͲ V
#W(!'Ζ y&so
8}$ . <~xgTUįQxlVϛJl>yuQ\/zk/ECV p w^PnZ VqBƑi;._{v5#гx|6IJz{{n
4rwvO{^|l+O._Rƪ5@` t.%0g)&m6ڨrRJiG٫a cǏ N a ?
{ݺݻˍ Rie%6|-? ֍iKԊay~Jg2Sf\
4Y Xۓ;idqC<91US/=OiT&bwAq% v E|s\/&2C ȇ^AZ-oY-6uFE]"(F ь&rX*ۗyg?6(<2cCRЦksr{;-?K8VB¥]m(
`}[[ sz \?guaf !_ ޫ`Sr-ɂ
Pr_SL䧛&w~+eLcr;?smhEv+(xwu!~& dyn;9f%V~=_ dev´}F Ltf x?{Y2. ?l2X& e->̯l1<]hAޯ9)7ŻƯ^J,,iXv)KV͚kO?z-o=Cs7C><aD| F̥@7Ǎh 2 jܞ=uH-rRȏvxĬ ֣qqjLe i I)I^^RcPPPT\9h^^' A!߳Gn#u,4PX2BO?r;t534 &N:{_NbbVĝ[ g \GI +ǹd , !S28Mx Y 7I2~lB35 \c{CB]s״zw dB2-_χ~QSyn,HE,>{ugaK8 '9[&9m[퐞*~ r_OB?'P{&)}},xK*.Ӷ7Z^x8Qi+ ]{0rrR! ;vr_l¬An?t :\Zx{k]I<na)JFs @ۯQTTNrG~+|4
>}ؿ a߬7]H=M7O1su? ~<g5dOr7 tqGWVVE~: t!w+~~kv- EzM6ǣlpW?j'M?`@0\"n_ 0 8L*vpٛSx"sE?4ʹ`
<0/e
|//ʦ>#96 źc'voQWcM&NH4He 3zluf;%8cٳLÄ]_^ ^ a2 l̫6 M5
D}[
_PMQGǧ@e&lJ @0a]1 ݦ7*ȃ9EVHAB iҾ 7l{W#Q6o7L߆~V:-
㽺(x$iģ+(FyvZ[&v$z4%n<Bx\frȳ<y/6
k1kst_KJ*aߔfdÀ1m4d06]Y] FrN. ^MJPjԻX%Rf ry3{Z WR cln ~@?9-fWW63yl痶&$"м6 2Y+20a/_YrMAe{\l: a}ˈ/aԃt.u dMuѝW ̢>#a)7$$J#rr{6 . ?Xw~~
L<{?9 .= CzS] D1 ;A<jAV]}=[D_% - a(< /t`$Kt<]NnvbYE?x( fW|@?KȀ4=< Ej rrQY)$KT.`_>J3`N03_NkJjD_l:hρm]M8~ ha)%*$|;BQ1be6MłA-7Cn`5ZCo~!YÆ. ٭#zmNNN- &Emշzᴶv
ʶTv#~<TmA"DqC qRMM
e YC~LL| _%O)`حP
I }}2e0L]&AJ3@m⪴djx~y˧} Ic -&'ɕ6R \e 1z
*$>U,5kl\T܌鮮i1ˁ6"=]{x_YHNxUQQhx %544 @??m`|z)o'R^1rj)ٱ#.Iwa))M8YC_~
R`t~l| }cI=;BHޜ@
{5h^ whOr;ѽd9c/8NcĊ) ˱ch{uoN~|mFinkK?7>C-̝4l!|hBmlvH'7
Ɍ aoY)H] y ŗş| "{[ kFFPW1lԒfOGrcgk
b.͏65n6f֫
VM >j5CZĤPrDq۽븩eưYQ/{M
ݿ <k
J_J:?m a+4&9r6 V3իU +]NR3d?< tb1YwK%ϟW}[[? wwWt~ Vn+:L;?:(U
݂ 犋aZ)G^;$/zR.Oͱ!|;߄\Jݳ1#` qE8k<po F_-..ngT^ktx'X ~ė̐V˸Z{y9.I_ο6&byee][,3_PtVlDI)w r +0Q,*@g@x?B.>7 t3ŗ?{mjԆT0\VK(L@-+7/MM_MM?eE2鈁 [z^VaT?Cxkܿ}eE s-U7.$>Vaw1 mg 8/aUco<B5C4VO `]jjO"E? aGKL0|$N
dss#q<ge?M^~!?o2 ޟ Ǎ
KN C M~/(㘑/!$e2mw9ak[RJ,Ž=;*Nk9z3 Do:bU2a限uޯݰW W
7Dag77ܪ7o~z%) KA?m=W lD! \F &Gi~~;_H a_OkǝBXay=`kL E>#BjpT˺Oo IDO
bmXt
ן;:g پzr#xUGs
!ãW
L~忬°;a)kpغ/s K\skhN,+Ȟ;$t<eˁCZaׂQ:Z
uyO~{'۷j@C!Ux O
uﳄtM\QOP6Ws
Eba>L!8_]^H=7Kowp{k\"aL= Q,Yk0Ydӕl I}#@~bOSh{;NfiaCAD'5ʳA!?=p3yׇj/XʣG:iim}?)11 k~}v' ^M9uDmD*C ~POˍ[s/{'AǷGQZ:fk~
Q^У4t,XۊÔi76 +V30"SVVoA4/a*mV9 9,}lYRX Lx".&ڒ5zYr<0 JJyy/(`, a/(̘ïZzPr>%Yͥ @Hzh {_=SnMeƋb57I%[ O<<jZJL*n^a>P]8b:jJ~MnI(BKk[VJ,hO :E :8P "",^}_+ hIg7nݞ!*2ΖZ ˢJo'f}H8ۺdkK6j[bQ%rr?̉>6-*ٌO6Q{OJ~)0A6Gy&1,.N0i6Z@ 4SV) mw-m<2-E #?4(]5O솠 0 2d;Aa`:*`.b& %h9a%LK@Wrhqґ͛7wd%LG uu 6nAh0o;Y #o(!hW3:|*@ >UYT jWCs8# Nlkw=C @߰O~ִc d>( > Ȭ<lf@#JʣM(1zY7B# G D g1 J1W3%|HYh"]1A82~pw#b(!A@f !fh(Oc̐ F\(=@f=D#0!
p: `>Ҹ7|!@fC" `c$ еH&Y!ЏzoeHB ! .5["|1rJ*DQB ~ -
M%B9ڲUb9+ GS=c5z[zpnRZ0 ?oö?PO6^HӍqĤ0*.#@b~'1`Utax7}:a<
81Oh%QW ψ MI8P]eC<v|DKX唒go-ũGk'P} '!EG66"Ѭ]c rn[ vn9ہk\wa283GI{i~:&▸<۬-꒔~wqtz.#{YrKe/$eG@A^_+<Dn`|ok{%@)yLC%)[%Ç`WGO0a*WH'.V0aASJZoU|ڃA²#@.$@{#{Wf2 R|= uٖA22 0'( rbW{gV.?;KJy +e0,e)X3vݙv9^*$+.v^1 t N5AThd9}!qƜW]͋
|Ӈe۸И9H~M_]A)r'D=JG:[]δߣ ^w=7ŷQ> :OwBC!F6 +O6/0K|坻l<sa&ן
;6.1* IDAT
=+ ֪'Oks NQ; wKn3
Ru*}uԤȓ wհǜu#2|}ӰO9Qx"yg⛿N.bB6@P7ݰ3gJPVI]t')hJLPS &S
P3Qm.:;b/&gԳXõ-$"du(!!hofĤF (QN< /<bu_p_j *fS vNVK ߾}ZR /xAm] d
i܇1R!eK
!+7e +*)ݴ*m YSE]S p<$۸bk#+7ߤ 6>Cm>{II@}k<pjh*utC#adY),7 XF`D0F`HS2*M>pq чTQK=|^
y5tOj% _N L 9f bK^9F@ʊ
p( C|8,}-M/5y QW ̜|.5e@^;aZ}i2Ħ?!+++$gj4IB@#TU&dܪ čzRð [q-1U 'FFOւ
VKjô 0:X%\X} n^W@DM.\{W0A *?{]JdfwI
qf|^ֿ° 褠uBb@{c|-ؽ#aaX}#p *T
;zVj⊊v`j
l45xiL0lIB4Im* Ta ʁK ?<r .+)W 8 ҘoZ4ž/)C~ҕKj.?č+/+-IՄ9$
'y%浗 +ޱI]% &&og0^xO(H@@EAu=OJF| .~&.gbTe'. hʓ>K7ZFO7W`6a`mj1 {~Hm|ㄒb{-IoߥiÂj,|~9`n/jOÍod^bS^P 66c7^C/E2qQ*d\zyf߷, [K%,x8aޞX#FM x`3AMox9su)!py|/$Wq(
!.iIh`-@ePB[II'>rӉBJD/aPbHP@e) FzPGc dOH| :qnYEWf\9tSD z{a~sIM`ya)
)qY4Y\JB[ (+f\۪`F 0K|R@#X
ȷ,JHhfAv%lG.31a5
f,v(B!(OavtvJ7h@[ #( !"9?m A:#ѥd"|d^pPAzJWAWq ]/^gg(*둈r։0&2ٰiFZ*^梆ed2^m۾cvNZ
9xbdZ/LKr}~0*f:ݽ{"Rq>dTjrZ+Z1d/Caم=?{J ٛIvWUF]i~.<* zTzY{jZG劍5dzvS 2!)
9wk-2KXnIjRPg|G[Y5mqb e?\6|(GOU 9aZ[]4.q7}yu4@)lo_WC}q K̸k`0π l19jhJ5,Z\ $|Q'
Z$DAЧl
( >6-xM DsY˿JҜRyne/`E(nM-fkEQ)%*en` T3@" XSAakW2r[
O_ʜiY TQ;`WMnbJ2Ɵ>YCנ!rl#H @(:lHN6Z R>aj6\Cdy ^keƇD$
$d Eg#Bpz];9FjJ/ Å=%dms@ \;߶ڌZFhou^e_7.
{i^Od&O^dzx`-7 []cAIG\:.~X*ZʊW>,bXcٷ+9"P_~?C; | 3hbѾjMWVVtf7< t璗/)A,tB\b1L
{*?XД@GUU|z$C|bpX.4u:'g25L|w{zF 5m l
n,ECu@
bU#IAdu @z~r UFޮq*cu? <^HJ-,YhwpSRpYe!^])*sx'1iVc*?& @:>[_ڀ1JW.~]IM//I@^
DzmЩS8,j)>+)<fǝ]:L]]YL1/ d=/Aж6oyOTQc0 [|m6ͼ"
l\n.CHc+T'镆jaL
F&{BjSY
V@P?bAO /Y A?p~^)A z!6 p(*T cעwU1ךj^RreE چ7CﴍV}X9=N2}1SOCT +(Կy[節 7Y@ήI 424CLi
p G|4~^O I7u1)]2롔HzNHcoRb
.zU
'IuCTƤ63l9FڋhN'0B,Vd0
M)t,{`oɭ=ĭVw5R`gqϻ *0N ]$g77KoyAPaWT22L|*u&N5]Trx`a& J1 _K[2K$\47mC EһVE R[4nFee^2nU6m6+ tt[ 1/{0)<<)%%(D_dlע:BS?zh+'fNb
uW}pv3F ȇ5ݐ\~ I;$Fǁr}^6_[G^G'պ?hK(yZqV}U6ۗ
oP aDibE炿&RT%IF6 >>2/Y
:E[= v6S1tCi}I|Y6B-/'ÝE!h|~0}OXXt![p@J*m6:,%% NÎPIU@AhV6̠#6T@]%Itd\6oSl2Om3P 0 #t Ӧ6XA7F~ABUKt+FFOR" ",(Jt=R@)Dz 6T$Bo]-*(*i,ߟfP+ ¬כ& s?&iSC{ J!҃v[H!* |pUjC p:m@#bLCH?_5#q`=c5ȭp=~BZ߉ uUǏRwx-+TJk|8~9՛/
ӘRyu FBI0
H``NtuSA w@]]-a~kW)4nXnr`թ+Lx? Z4PI,
a7KYܨ T/5ח %`
\KU ,L: ~;LХp;\h;,e~|.lQ@!Xv ?~6]5[ u
vyb'~z=+x5W>lpVmLORBdBJFs_;md[~$J$$(HgӁDp}- fesk;& NI BdBPK/Z˧! cOӈ??:&_s`n/殤ۗOnR!Bpat,D It;MZdn`Η?{'x/$ֺG ŃDeԸylUƾe3l9zQa镱 UTvW ?`o35v;[ Db|qkK@ HRo < ctByB^CI`/CGh1ƾvU U-Kr3 /.GKdbW u(esgz2I wo^S|zlͳ'D'<ZZQ蠣uN Mal~a@O ~rWעȣD E)ȁ{C&Y:';lf/>vmdYq,8K
Xί͆Dk *b8VG:<" dHHSј9ҦCʟ)We3vrQ%b.3R.ڻ g>ʴA w"ǜ=0 .7(5 6#5!sONjrNvvu&V]ign@ܗ< =)lNԸY[N?m$jXG@urM"IS@&bЯ?]G! \9\kkyPBãTP%% arjJf -KĀOe?˅( [7xhrfr j`2& +Hhd+)ʠ).P3#*qqzhYp=!2JXv{;F7 %L.ڕl-*' 5oN.t)]]=eMZF``8ƛY9q? O8_
Nͤ$gւEnƅAXBp`KI/8ycL: D<㝔(>Qeu
_0)65U~
u$^fW^y
w_N7ÿS ɍNJ
:XLƲ+ )a*BLn *
EnwO9췵%b9 SLgW$3.|~},'s˲^|E% krެc2[QygCƘZٛ\ZP1Cuq6
R)o^7PUY8;DC)(+x6
@g㹀/}@91F}|QRmͽ@0҇m 3Cݜ/9 me
.<\*qǝkM:g3ʤI.O8b0 d9>v ld8U
u4(At\N WVVVðN| Kg _Kqѣ}=[E{ 3i>sNsR(a18,]z%
fksj'^\
p
?ly><i)S} mpfH &)<~_ U'%xo(t8;p?ׅ9X<Y^^Ϥ%7{=
M2҇"h:|n@ܡFKdwG|Sm'0"S$UßH'E#u^3;?asniFY㲗 yEYeKO0"P! "A9a6<gt1].>$yPqeh7 9}!q-N)St22/1)/a(Nn^pO>KeXz
d~$צqk,`C+nN͍ȥq+!kƧ=&qz}kDW.¡铗uUX z=("L^Q7f;2:*ʛSfU'h V ~A,yw1mLlN&fJ4](DK0+oVoSQWQU5FeUJL<(YvnѥkoMݲj Dd wm*(tm(M ʕ^#Ň
paCQA%(0 Y[ ̗ӟ}!VlAP+`4H iA) TT ]I<';?h:q:`kvRTVĂ?2ka?|>,`. 2]M8z_?-?<B9e* [o۷ @WXt }+Q [0"} B@ 5!@|@F &FvcbrN[saɝԖ[^mcҹ煷BTqNm
NIr&,EeY{ "7/G,n,E%2"5CcFj(ρЬQW ψ MI㰺6G
:!7ʮ I"":ԸVtލҐS"f)u-4\dˍOϘ׳ ?9Wn
)/m(! i ժ,X,\l00BOo~D*+uj%d\˗vLJFo`,1$f$.
^d By>Kw 3W=?p@W:GORv״{Q&]hԅYInSg
#7w#lĀ
RIFWWPt8φ-;[S|qk - )(]a'
L%cRFDm jٞX :v-5J'ѥw
,̷^%1O`{"w/I(-`1ٚ
(2%A@houVL 99GnM,#2gWK[Hl|7a9n8Md 2Q '/Y<|خ14
@EQY9/X*Zʊb3pK7
k 98ϺʲZt|`BvJ z:,.Y7BWNM:6a4"*^X]#-CIW2=p L.a@sچG7d( 7`2V_j /$%Sϖ/gLJ0. nH'BVSώ;sV?`+B
e9JJK~ <,PaBvJ,:
Rq֚/@sc) ""B Z@s¼}%< } jD/X^@Rɫ`|nn- dy~~ή̬& 2"b $D:n!g$'>)RkMTrK%kalhS*H]Z#f! B@:άCwz~ OIDAT|frJh`:4Cm1 쿇#k7
5Fۙ}cr}0||P^A o節U.׃M7j)zU- )<Ho* q遅c2K{UK@/a(!h愁AzzP"s Su;u 8Re''h$;Cf)wNJ9U=Waw!Cb9$ jy'_{^ a0VYLX4ng%@tT`
`P% #9!Hp* aܚCXjkͨ"H bIL:zj ߔ6KC}R(S
"|pPu@Ҧk<T" 1y '{AB@Kho009 Xbzm;'1L!U}?!&wٺf灢,MLOmﭺB%w*~5̋&d?} cBQ}Y PPRl,L
!V1
lܣ'g4M#%(Za3ӸOG<͞8h\3gw1k1_]ԉ'@F)q4b&| Z.pe<¤}N [tYTP!h) hrY 0BDN(簷^
̠#6TՎ=Lo8jNQuQjMvBf7+It,t<"C TDB nDX!HfQZ.RpP@-Z;=^x=65CYzqȔ)J4'=5ZCt ڛo2pkdG{/M/ BhoGi@ mi !@Ȏ }ډ$a_F~
wh
?q1~] _,~H4PA~^g ?
5\%.#ԆT" mַ[H.}iJ}U6NU=\(\Wb?OX&\RZI_L!K*J~ud|cH2qPԈ R{09`6Xֿ&[q3`A@"H!@2f< ϫH_20LYUvYz.9;|Sd p³a
tȂZEÆP=k>~0]a AbLᷡS4A`UMnE[/JXS"uz $.ԯ/"v9FMVIbrvyT?)AtdڧY' D|\vF3=XS|M82T+K=_ .dx~
cWؼJ^GbGLH*(.͗@lDL5 J"bhN[/, 9#98Vm2,%]8jjTGMODEA[~ g<WRJL}ݭD_ LK#J秝=Y }$9S^%uc+YzIz!bWfNgV%7qq'TϜW+0O>7_.HeKړ+r9v|L-KrN o~gS]ĭ-
?,;Q} F@ |[
|K/M7 /zL%cvf"h[|#~SQSiҬfYj0,?b!g__pGE@@,E9g >Z%$M ~,UO=SYy2#bw<aVI
Xί͆Dk_g_uW2z" |M:+Ddc;0YPƭKnX,&@{ "7]4Dɝh|ru_v'G
oὡ @4@{ÜL|wq3>QVɠ,7SU17fy^UCƛRl n LԽtYP/{n?n vR\ ґ[^֎`L/t jjcl T3⥚=2'{V= <+LIiJEEKW@doHwG J\%52QX ô _ vh$mzK۹r\4dK'B ! fցr[g2=Yf;tKM)'%QP\u ͖zg }aRDt8J:WBAb^ |n=qZȷ06(k 7c1.ײ9x~+Q/>
PUǖ^ދ`8&l:q0 û(
!Fݙu:}1
?xu'[2 &Lpم HSY-edܟ9+t6= KB P+P6KpӅ%{'S2 Vf]AY B/").-=Wc09 e #mz !ڛo 8g_1l] bAX(L>+@fU Nj 'sG%0iKGK^vY| & ]xM
1v*`HChJ~052"G_,IŔ:gy_࣮V`F!'p~/dWSY<H
uy˖~#hG+ \t&w_ U
B' Oy EF `]| .Xq~BIZFVWxڮ
q7\fSA Q0M7 k.\ ڬ`jQT(ڿq:Ęq_t.]^\c+>ߘ5b+;zT'Q6[cXŴCx/Ҹ~.ј.-=d醆j_ 1YKU5}RBgލzީR(@HA ;77B&.[ʷCH0}*AY0N6`pCK{\!"uhRB .eKU."5!@HgxP@B u-MUVkCWY B":~/ fڝůӟewػ:@t@Ǖ0 ɼwe B=#>W´;@ "̺
9ȼg5+L
RnSb57XӃSWo\NhV5`"3/ D]1>JNN(!x7Y;}tܻ b/J&rkw`DFb
qC]+셒& 嬖o z`')c}` T3bb!~-k-
g`#OMcƜ\1iQ(xYظ_BIYA >'fa-O"_^BceMnB-EU/TP D@{6]30q%b M
%ME.DII_AA_/^2jk1O)bY%U$N#DH/Ѭ ҝl(6T!Ўh+ad^?[c"Eo cF6YoKͫݞ#VMnb &d?}l>/|cA.CLlUW]nl.B f:ElYR$g+!rPBL9 '*q
˾p iR
ɷ3=y@(̻7`{p>Eit;MZdnU;_\=tJnN/ />/%8 ]/y2X#xB!Bݎ֯\ oNE-DW}8
#. hbfoeZfSyԕ sƃʼn `g S 2 T&۷T\0k9tΜ}+
Ok՞O}GE+,L!|'sq42H/4;+y/LS?9, !f|}ӰO9QP/}}̯@ԒFC# <I{17G??s>B
G#>:Ew.xϑLxWzM Zh,()?&4=:wAr U_YpGׯ_=uJJKr TCc;~䟱M]7k97ΓATlM{P%:RCY QANNky*
OH%'isx8:j21R!eKJ* A Z3 u ',/'t+7??zQG!@;t:zjU*MY,%9+7Uk0~Pgt!KJ.7W`P }&I6ݩ6=u^/1/%.
T+ f洛8r ?!V7ʊ|CiK05pO+O)(qk\Y
6TN.)^Q{P_(3k{|N)plxLO B em8zz{6R}\r 7'ר{D{jY**k }U*f Xl`)z5p,^̇) (`Ho6ߎ?t))d7)PŸM`kǶUUz |Wr6[PlЩ:Y(F!ViSa 'M"w7UC9 !h وlB
C |Xu0Lz\ʡhpJ|;̅Jȉ6Sժ7č_NwQQM UH$9gَv0 > n!86KIBq:k9,OՄ9$u
%=ɣ7:⛞}ij6[ZR
ѬYL9K)q(SPmn8B])Ku E:08(Qj~{Ɍzv[SȻ Br ˯#9Ёպ?$&fku^yWcW'Jۍ> oPiѿ.DWA^K.Ò &_Z ^xDl,(I)ZFO'iܥѬ{Qxd^bS^P.9!ABqaoCHWyAT$^0`WtϻB!{6ŽR5#St$u)_NhtI-lƋ-m <zE, #IjJGtL)cTV_;É
9 ly'sw2o9BX#@R -(L[ͦk [i֭9_Y%H !qhoS;WRRpZ5AǤ-wiv. (،<0mV6ͷ:Z 8aJOh* B !j jP@k zk@ 25!@Ȭʨ B !j jP@k zk@ 25!@Ȭʨ B !j jP@k zk@ 25!@Ȭʨ B !j jP@k zk@ 25!@Ȭʨ B !j jP@k zk@ 25!@Ȭʨ B !j jP@k zk@ 25!@Ȭʨ B !j jP@k ozP B !* )+Q c7 IENDB` httpd-2.4.64/docs/manual/images/caching_fig1.tr.png 0000664 0001751 0001751 00000026304 11035423623 021734 0 ustar covener covener PNG
IHDR X
PLTE+++%&&MMMgghsssx555~u[tQzfzskY,Fe'>YomX3Opc{fy1;G(6HZφpXۂv녱噾ږ 4L~탔4694AQҽcҭͳʺ˽ɟgܤԶƕx䣽ی㩿ٯյu둷789츿㝝EFHNRX>@BѷsUUUԥ]]]ӎޔܴp{왷١ỿĢ֕ڄېwxxkke&'(Ig\SkIWhIOVO^qPrLb}Ox kkky~Lpwoppaccd҉쁯 imq]`e 333䓔 ʣ:::DDDU )IDATx^ɪ0 aλ!ĐJ`CDW3 `l$ ((k ϫZs;Ƴ˚/UilV{ɱ<=)1je%9b9+PXH 5X
-yvjsƸ{Bâ5R[>uu cy"!Gk< +\b-rYa?{U2z)RYS`~NMja(MA?ͧJ߃iH\ 6H> g_!E. @ Y,7`
)
>З.?,VNDǙ=%Yڻ ޮg8 0 E;VG(R,~<+Vp-^_!BX ,ڿºٹ6+_ҲBJ* R"mv7nZ(I+1IhHڴq'U!߫@3Q='`H24vr~g=+ Ӎ{VO{՞{. . ,A0L>n Dl1mA
h4Ym~dz},}`,U`b
;]z<9xN>4p Ь" wbDl k5Irۺ+("=VJΠ-+^~5d9,NP$+i
Λ (gt4M½'d,p%MҸ^ⲉKT 1("ݗov
P@Sc,6E&'=W~$t:cB79OIOUeMg[?~'~9di>d@D#NO<^)m^[ux)dbq]Ew5 Ƣ F 2FM
QMґX&Hoˤoa!4UdXlDR-wڌ`¸Z#CR.MVjg F ^etW- -\ lv?~7٘t 9Fe9B+of<kBK`b:b pRj<^Y2<] jNʎ BcQ2ťi]O]]ʅbG~!ig$ >$hM^Yf,k@Xn;lHoNU <hKY7 9sΎ͕@R-zrɲJIPf)*"}t dzCbE)4vyIÑ\ "DE N|
ү
;)U!.
$שRc<XOѐs̭U(6j ġUzh~tCnQ#hZ)nPY(4i2i\>*<bu#c% n)&'Wh, jp *XiEv1> .OeÑ=REV(Яݍmkl@$(o
| <U DOZ K $:4zvfa6VO^av1[ nhJ P);X U3(n *-[Ӛ<(Mp19!ơ R
icf@eLhcǧe8P-Qƪ s두ڍMe*X ,4},&DrLB{X yOhN6ҘL. 6@h XobPdd]\
/,-3b C80ECNÅO4am3!puIU4f(ˬ_Ghr! zdQSvK3{xTpH^ri;Fk6umg`5SnU9܌>M}W f\؈oo!kz+Qܛ)Tb&38g
C
ܨΧ5YͿENә| >rK>LMNtw>Mg$>36w&6Q
/ -=t3KG@d *B1ڣER(~4~otILw'S鏢=6}
iSs!;
L/0{) {9zj ,0{鐢O_A #4+~"5Grn<3|ҀE8Ȅ 0j;MC= jm*lOf'@ UbD6iU8E翞DYd"!.ށm7 'ֺRB4
"@FIUz,,g!J k ,%\ *f %/J) Ā
^m ?4
nP 5qq&fT,M,/"Q ZR=Nc,Ad1 jc<5ƠXPKO'M<> ֮.`m~8q`M
,pxY1-!B,ߛu7 SIpK
Ӝkk-WցU)Ʒ}𱊡`DWRe{1# vC=1[ SelazN ,N'
ѰG;*Qh zwb\;BY~N}wց%T+9؏ܴr7fxͺ,M! t?#% ILK*7X@V{XFG={WRtŽ7inՆ< @37 LY:X0ѼW&XlCwoU2QRyhb)EU5)צw`PY
( PV8{CX fqϕmi6dRZGuͩf1(k#ƊӵH` "l:GD1M1ڑPJӦ(H>njxSwiͳyZRgSӃYSdY"KZ:| ]N4A9uJOV$eMu0D>yF#YU?kK!; [ŧ p^R )@].:}VtF(m*Rg`Vuetڙx.Ivf2]밇"n-O2 kGX,
[ 2FyEҁZ M/hZgGdb=%`<"ezRWwLXlM(_bh~b n'{{_j-+oX:>56%~y ˋdlvgm"hw` 5djAŻ~
wݢb8 o&lS
$hŤ%,(F;`RqshPl(!{=K,:Q< ,Cv:z
|`ZҖ*
v J8gny
9K^^8hO#Xyou{}9bl$.oC!(b'ȻդBv*5Z >+ԑU]l7 _I|Ie+Iǰ @X ahÑ:s[t# 4Z4;(4
Bk5>sJ[c[9aE$/qP+`XcSCW Sw)lfPDj t+ ņ)B>(h,n˸U"P6MT8[ǰ睤9z
ٕB I*rfgYM4V8+
CN~H f%tK8n`>",T/ALmydlzyVYaCh[XS|RгMڡE}"K(+22 XS ZFy?R
q >OdO
S
ŶXe/+~WN< B5."|@cWc 7 2V)
_W+l !/
9)o'~? CX@~ >|)m y1;vh
7ޡ T0-lagOC*}^c@z0֤ѧEo&,ftl)·3;ͷ [?,T._m L v{'Jzp04sShN /"BkgiГJRqxe@":kR'l K_) ትm Iշ?{
ZSvH<}'!bXlqit mam7WDxγq.R^>bb(,z'QZ\ :6`[
s(w. :tp6/jTr6ͻ@+ߐ^AѸZ:>(`2 ׯB8_G z xiBM c6I "76@'%r-2-HCI͓A5+;R;2744W8lY}?-q8%2{X@FZgV x6{}y:*OMV$=CUcjzۨheĎc[b-2B%vbU"QH&wI)Sx dɢY2SN\3ѽskj pm߶ˑ
3`G&*ߠ0T5U}58_kr^Km]6 +Nk0k;K̬[r ss} Kxٓb!$ 2% St[ Q3<3>)ظoz Q`ϾըFw"q X :
D%]a б#$f{].z-b_J]0
G X"xRgWP ,RR% Uuv+?
76 I KŒKBc o.kRA>:[!ȻsZu P᧭} sW̰ 'Aޟcu.EY0ݭR%PwmHz`8ގ}r"1wx8or ^aG9O}lo+ kO䝼̰\ WE5Va% Y6Fart}|.B7a4gZis,t,>0Rv/o@ EfnҼ/e AGXBH\.tB mXFˍ+ 0Au2Bʱcꆹ"r!ĕ":mp\] CqYip2dZ]_V]MF Be\R}!Wx `n-oGB RB D9γ@\w:;/( Cz}!Wl7=%yǕk FZ-K(^xt, aq. UÉl`Vp<F, XXt3VUBBDF)V
б(23>h B
iM4U+9B+ `'Za/=; 2"$5se/Ѿer ` 3,huV^@%}ɇ
HwR B
б܃7_/=jx p"0xv %Nn H8ј{|; ,縑ywJQ5*<sQ:| y,wX %XXܘ}2`>4
o `h̺{.aѻ+| e r}a'xT~qI
If!Z/֍ŁI
Ij~Ұ?
I(3k.Wȼ#ĢԨ}
,BtP<ͬ ^]0 ˆuJ1
U-cz*W %S:~h
XtF쳼h i(S X
f X" :VHMḟB;Nb3hX B '}}]u,eJx.a JG2֗ V|4;#&7@c p'KW] 8QY})r+C#:7=7, [Y~
ǧ4#{\M(7]y?3Ck|xEhɤ/.+T4Myv_hS1P AMha&0
]OMZ/Χ %םIFb;!^
Iڞ<q/Ս7%SӊD*?G[ Ji55ii=9z*Ȼ7X1{k8LmBswBMzb*v`H6m[Z
a
V,UWܦXݱcs? XËsi%X
6HWw`ܲ:I,B|FiR'X5ۄPP71%s AdE6 v\T,Ti D:
s BMWȸ)'¡MhWnH!W.Wq
SS;ۄ*J ՒK
Zwƭ3lBBzT"TFH&$}SRP!X
cU,g: eҷLҏv_Ƅ
37 yȀՎWtu&m(F!B5Vu
ĥ Yt) Xر.r턆LȮX V^ O~F_]qSVر6CiKL hW#'g˾ +d9qFIND{g6q7[$$-]J.4D* /"m%SP/\6u7ިȵZUM
%)ݥ.[ۚZ&{3Rpg<j`
L⥳s` 7t qj
`IkY:
ag,XqTjHjNoـEʛ]~jX|U) KUU@}/
,nPC.Q`_!
˴t+XM4ݽ
B hL;7 coWO:,{D+
ԉكc`ΩG猇5!ӁuPHQbx WZ_78 P-y hHG?сY4_o +u䖨 H Kx ~ K"gm9eEɯ ̇BcpLى% ;įʻ^Q"c`Y _S6x]yJ2!V
(rPVʓr Y:AYW
^8)f;7`fk.RU']c4 Rp3˗Ｈq
͇cQ`)4_>2>~CW6,^g ac
ԵڃepcN)QM`ϟ^P$p)7}Y:V8"`ٚz@
^ϠS9"a _z*G, \{,*J:Q K =Xm|"`gZ-2r~cD`n;-w %!-p
7Curb49Y_ccKu+ b5LN
nsj!NBq ' ҁ1QcU zWos9V6t& t,Kb
j?"]>sԏ=Fy{Ho/\MyoaiFP\
X=,7Ehi0L&ģPxls7]<&%3RR!i5q'LwXR$J:aOtwp+~'.Bt5^bfֱw`ew[O>5'"n
Ta$籚] z,
+;Vq=zC.Bӡ[)vK: e_oX#yVN?OӍ5$kW % b VBQGI h}quɺj
K,z^l~@ cꍂk"ִn( rS+ 3W5Q`E tg2#?/~@f')57&F\xp |%P#18\M `{G=ǺB12
cI8ݹcqj^1XރGj,{xY+ 7FPm 3Vcyw t`6$ Y +b-X5AI}-ss2XyrsޥXF5.])
wVd|~(a`λ"1֜ <XjR)XBZQJS7@:XWR8< {r,Ɲށ ˣ[/נ⮌8=B!BiHAٝy a=Q ` }5f!yw@
Qf@E@O`-BD$PH
R4^(5n Za}:|SM<̗tBhsmwEF֞;
彣;{hR.v\ 롰PJS"t +uXw CQ 5#Z.,NR}YtS\|:9Hb@#D,xhAXWx3rnN >ЬB^PWXKI]\!ebaU(KO@CK2$qU$P>?W$DT,BwUV;1*I]>7PW.
=e.X4 -~i; -, Y!ƫ0u]>4̰D<
֑B!r gXEYa<_*;ߧ#NiwX1 -aL3.A٧+(CEHB*4LO йI%ِ8-L~JP2Ah7?ƞ> ^MGo|gޛ бk, U:z& R*-yģ!Ky,UAgAH5`)7士mh~{'}oLW;c>ybHD ?7{g`)dx^@u^g ߣv;Bdp|`AnH*<8Fo $U+[bc6
aQ?bm1GN75` ĿU!a/i`ez,Pmf*SӃsQ"(Pc1s䰢(b(azh:6{e!bjfwe\a-R
P= 6 n& G lX˅T[:X*r
z@]~1N.Jr8H Lْl*EkX. |No+TFu,}go R: >Xa,ْAJ;t,
TISU TX[g?)LBb:p_! <Jf\*Ej6,- Zx&G.H yl5#5
,]۟/Ξ{%˶{5`%/7Z Xz,/ 6o=-}+\qڒ^Qˏ_J
+F(By}62y']Xl5 eAY:,U;kdBCnpzjndB+T2oV<zkc,Ku, L
(б
1VbXlc&l^nz ^S J4wX[r b,XɌAW{!BZy,7'<۠,X x[V!"5XP
kC ^ynTͅX N K-ud ˻kc?X7^&X6oт鬈 ]yTt'[7X0yv*($S j*Lsn VV[u t,gYO
=JU)Ei wMSA*ęwedM\~ gY!'k>B^!|Rψ=
1ül B r;T : = `ݠ1<\e`r: O7bcnl
ͼL9cajU])Dݴ4zCf?_ln6
>VI|BBH ;N;/69_~ `u챽Nj;H8D{fjKmVXcI8x
"(4=Zc yǒjv,PXg
t,:x w @NYx.?P6m 묱 Ցǔ_c9-U~Os 1TrJ"w%#>. J]v}O?coH ?9J 8L IENDB` httpd-2.4.64/docs/manual/images/filter_arch.png 0000664 0001751 0001751 00000004553 10671421551 021275 0 ustar covener covener PNG
IHDR 9 [cc PLTE U~ IDATxOLxɖ5HiixhU`"U&C[ 岇 ,T`I0{/TBJza{qDH[Ro=*^o?d3}Yw{{߿7 !IKZҒu1.#31z45O~v/f$t}@ ]AfpjRcFwڹlF$F@5 QɊ@k%G 2=P
?= ^<̿o(C}4 }uPIu- ONk֏Ƿ7s6[ݜ݉ݥûʸ5VxiF _U 2/샹5h-nF#;О9_>:bsAv8ܖ֪d &#Y=Ş z6ֿhb }6Gխ(=z~p2Fr' d3UH^q@:-99?:nch5n7G] ƵȠ[OJ6Fu( Zp@HK
Ԥ]A E$Q(+<ۖ P *}Oi=ګq,PHR%C} K)Cۣ АeXB^d\d)
ӥKA!O˺d4~טc |?Ѹ\C$bB#64Хw~ARټv d\uTR P/!4H7( @[ӉD@
VF@6HH,- #@_9=1:RHgC .GPBw~@G&d?td (z ̱DdP}Uh"l(H[`&@9,"IVDt`i?#h̀ﰆl6^<E#Y PJ@ (%74z*a/ N1^vEAh5: )C 'eGn+{JqeI'Y$WVOqFw 5.sM"w n8/JqAPa\ ]ܸb]u7?9rAARH,W_cu < Y{2PO y fZp[P!ҧ7/"
~bI遴);R|.ϑR"G)w ]^ r'[#_)2S?b=>\q0?崙wLdS',"=Ia0AWOc' 9 ]-@m9_lӸWQY0x?*PdVP" ݥvl^)a}~^.ЂȤn6 p SlyDܕ R>boe<YN~|k!tMXZ#7VSea*/54_=k͈>?[JԉڑγPZH!Q `jeT[͈NF#_2[HCXHR=Squzgհ24f͖%<㯕QԾw/lZȔE2;R\P*Ծ=h_#<102VwTIz`mZ kc dt.{
*~#XWs Ұf^}Hnxr6(ZxoW1l d_ *brW1A}XtZLگk di"t,v RȠTw)Fg(h.'[oeZEBݮC{tᧅ?~f=F_ 4gˍBsv36p,ZŌ i6Q*f |R9 ?PcڑZcʦ@Oaׁ _7wA%&nrQ| F(d Α,
C7Wt/b3h4G/yAAIDtABj&NW5i"iE,
4
{6ϯW O ?~+ #/@Y,Q3@9,P /" `>5DȰ_eQ@ ڹH+^)_ ɿU
(sWԑze $@
"̑d{臭rA-
`T̯7
(8;7Wƴ~h.j Z&6dCGXn!ђh:GWF
B ^:O1Z]?JhѪ1ՇīXVCժzFz:I@ (%4?)03 IENDB` httpd-2.4.64/docs/manual/images/mod_rewrite_fig1.png 0000664 0001751 0001751 00000003244 10671421551 022235 0 ustar covener covener PNG
IHDR Gm sRGB gAMA a cHRM z& u0 ` : pQ< PLTE `p pHYs + IDATxj< `y&1}C_AN!2 L`; It#ԍRNZFkF-RK-RK-z(˫1ƆƼZji jlh̫-2X!"Έvh1,b P"G/ Z}GiѰՃONfJ8rhu^<'Π!bDS4.Mǻt,{ #tc#"9 "lm2nL9I`&S1r$^ uDZDl-Y.EK ,z!# `oX{bZ8֊J!gSQljY|ȩekp E6 #Q0#&1ȿfI&.@'% akOZvy^- ڪZ&kKgk? kZV|a[|U<?\f\oZr3U}kgeY VfٕVTM5<ceYcy{ rw.dNKsxqm rc}|wj]mş_V!SZE
mJƦZjZjZjZ?W||_Wjrxt2nu "7aS3`qeDD2.:Uz^_Em5\UD<7VhO[Z7SKMZ!尲Z^ġA "u5T,"M| ֿׄAp61~ YC/ Cs]O6Jxbc03- " -Ƭva"ffBnjX1YC@tj U7/F">vb%2'Fb` 1? P| I RI%RH4Nf'v!z е~) ^-} $2 E?jŀC _V" x=?8 R9 n 'pyVςp>ZjZj֟:lwg53ZjZjZjMbߨWoTVs /יQߨׅ76ơE{\bUoő)7Rz[m5z7c7,9Q5Rc۷dFձ1P86RoߨSoǎoD7-coZjZjZj5OoY/wכߣ6}]Xd;Ǹjk=]Y.|z<`-|UgXe*WsXeUl3XS[?~٢Lc~]o]37֏Һ~-֏Q:֜`Q?vQsGt]Zj=ƱZ5yLa:X;kKe,\:XL!6q3y_8v,O8hM8lM8hM)j=-ƆƼZji j̫q1ZjT箈${ IENDB` httpd-2.4.64/docs/manual/images/pixel.gif 0000664 0001751 0001751 00000000075 10147723030 020103 0 ustar covener covener GIF89a !Made with GIMP !
, L ; httpd-2.4.64/docs/manual/images/up.gif 0000664 0001751 0001751 00000000071 10147723030 017402 0 ustar covener covener GIF89a @Xq! ,
4{n ; httpd-2.4.64/docs/manual/images/home.gif 0000664 0001751 0001751 00000002671 10147723030 017716 0 ustar covener covener GIF87ad QQ = ] C
ss ` 9 zz i > 00 + 77 " E YY ^ > * E% ? , 11 E c m - E 3 ? / T $$ 3?% ^ ? ? 22
(! ? 8TT 2 ? w b }t . %% { J Nc ! ii :: / E d ? P ?
6&& \\ o , E HH cc ~n U ػ _ # P > ' ;; qq ? 6 & E 4 E& * 50 '' ]] 6 < ] dd
, & r kk ?, ?$ ?" ? 7 ? : rr @
d b h
@S c v a %M S// JJ ^ , d @ H*\ȰBa"Jhн
*LL YI氤ɓ
[|BIM pнѡCۓ'an s(C/QTaIiR2 ؤзf<< !r8d8pǬK7:T. &JE Nǐ#KL2 h2kޜYH7ˠMH8V0m0 aB; ad?sd8Rs.+_ QK ~d J 7<6 WGU *0<e ɿ@ўΡ^T x
Miҏx
+EW<c`N4܈$8mkYᖉɡ8;4_H
b bՔA' v'2" 06,㏷E9< 0V\bX5X#`hpAE%b:TeB6LPEHq*蠄B6 >A-AT:6%0P;xAE+)
7UXs5LPC"I8t eR1@" 2
Q ]<G \N@X !(SRǰ @ p>R !m{˿Āր 4
HD&9@CT&u҂ "5@
(I, Y@ ; httpd-2.4.64/docs/manual/images/mod_filter_new.gif 0000664 0001751 0001751 00000004530 10147723030 021757 0 ustar covener covener GIF87aK , K ڋH扦ʶ L
ĢL*̦ JԪjܮ N
(8HXhx)9`yyp`Iũ@jp**ʚZ1j Q j뉪{{,,[ -Lkz<[
ͼ
l^=ݠNOڎo2.?/@]|5",X'CW+Z1 ;z2ȑ$K<2ʕOֱ|Y%̙$ҼI!Ν5e!С=
ҥL:}
uϨ?Ri֭\z1+ؔbǞ,k6ڵlۺ]mǸr7ҭ7|l 8 )Q<bXGd-yVqo58kVYg5)5 ~!Wa5أfq:k3Lz+^rp-͜ 'FFzÀ)q:}~YN<8Y h_wƩ_\~x= ,qX _t7Ӑ=F[r0@#~"dTc5wV=,IvB_[iR ##Aԓ9H&
ydq=n!O"˔TN`\ iP&*D)m 2'un ʝ`~فI
eA.ʨajf4&*%ʙi<pC⏇&H.aMҩ,S骥R3-"mGZ\áiNi**
a櫦$5;bt2▱cb ضQ٩,q+AW.to7 ]B
_>2 IC s' j>-*J*hˍ;{Wk j[0l/תحZܭNuB[jӶB HԴtTSb}c,==3u m`=tBh03Ŋ#966
gh
& '? Umw|pӝ{lפn/p¶ ޚ;»;1u
&B<YRF8\[ޚx҇+?^$D~nb '6 }Zf Ob|x d(`ހƫnr[R.m~]`8LcOx#CUP#;Gg73,uA nHTY7*
EYy)+cG14 \3EvZsaFF8ob(?
[`Hj$fc HKy?Yh2,,)OTR$ d+'Wr-kxKE ܥ@ LRV f.iL4cpM%9aS61C(}\8YBhS\`ʓ[
l'&ቑrlȴ>ǽS;H
(@ pĜ;Jz 6%G:AM71X=
љȹ` * CI4ԁ?ЉnbD>e'~++5ӈ~p_UHP K=GZ0SC~a';cPM8͟ґi:O7ՔdM=F2(cݫX6s
#3:Pe3[,ԘW#*
jZYL)լ7qqZCe;;Go%mT*GFon RS.N qWi(9<pЋoM؋®mGid\ڦ.]-[ GdoqV"Z/K K^Hlj4 8y,SC=w08O +b;LBX E;SbqmC,S52&1k<( 3kyl7D.#9K~ (KyWx2M|Nfy\ a/Ṳ!ό4!j~^7yt^r=<co^y\X>* MhZL M4IGDGnF:/Жt ieˣ?Sj>9~9u^\}U/Ú\5dlkJ.
=Leڨs\xˌ9ojXJr=m.g7+f
pU!6 뮨 ywt#ۇ
k~_\5nW `)~)C i8#䐹ȃ}rۤ +?p˙\3oN\i@W9O;B0 zMb[LNTK}Tկk}\}d@ ; httpd-2.4.64/docs/conf/ 0000775 0001751 0001751 00000000000 15032766613 014510 5 ustar covener covener httpd-2.4.64/docs/conf/extra/ 0000775 0001751 0001751 00000000000 15032766613 015633 5 ustar covener covener httpd-2.4.64/docs/conf/extra/httpd-manual.conf.in 0000664 0001751 0001751 00000002537 13076415352 021511 0 ustar covener covener #
# Provide access to the documentation on your server as
# http://yourserver.example.com/manual/
# The documentation is always available at
# http://httpd.apache.org/docs/2.4/
#
# Required modules: mod_alias, mod_authz_core, mod_authz_host,
# mod_setenvif, mod_negotiation
#
AliasMatch ^/manual(?:/(?:da|de|en|es|fr|ja|ko|pt-br|ru|tr|zh-cn))?(/.*)?$ "@exp_manualdir@$1"
<Directory "@exp_manualdir@">
Options Indexes
AllowOverride None
Require all granted
<Files *.html>
SetHandler type-map
</Files>
# .tr is text/troff in mime.types!
RemoveType tr
# Traditionally, used .dk filename extension for da language
AddLanguage da .da
SetEnvIf Request_URI ^/manual/(da|de|en|es|fr|ja|ko|pt-br|ru|tr|zh-cn)/ prefer-language=$1
RedirectMatch 301 ^/manual(?:/(da|de|en|es|fr|ja|ko|pt-br|ru|tr|zh-cn)){2,}(/.*)?$ /manual/$1$2
# Reflect the greatest effort in translation (most content available),
# inferring greater attention to detail (potentially false assumption,
# counting translations presently in-sync would be more helpful.)
# Use caution counting; safest pattern is '*.xml.XX'. Recent .xml source
# document count: 266 214 110 94 82 25 22 18 4 1 1
LanguagePriority en fr ko ja tr es de zh-cn pt-br da ru
ForceLanguagePriority Prefer Fallback
</Directory>
httpd-2.4.64/docs/conf/extra/httpd-vhosts.conf.in 0000664 0001751 0001751 00000002757 11720462450 021561 0 ustar covener covener # Virtual Hosts
#
# Required modules: mod_log_config
# If you want to maintain multiple domains/hostnames on your
# machine you can setup VirtualHost containers for them. Most configurations
# use only name-based virtual hosts so the server doesn't need to worry about
# IP addresses. This is indicated by the asterisks in the directives below.
#
# Please see the documentation at
# <URL:http://httpd.apache.org/docs/2.4/vhosts/>
# for further details before you try to setup virtual hosts.
#
# You may use the command line option '-S' to verify your virtual host
# configuration.
#
# VirtualHost example:
# Almost any Apache directive may go into a VirtualHost container.
# The first VirtualHost section is used for all requests that do not
# match a ServerName or ServerAlias in any <VirtualHost> block.
#
<VirtualHost *:@@Port@@>
ServerAdmin webmaster@dummy-host.example.com
DocumentRoot "@@ServerRoot@@/docs/dummy-host.example.com"
ServerName dummy-host.example.com
ServerAlias www.dummy-host.example.com
ErrorLog "@rel_logfiledir@/dummy-host.example.com-error_log"
CustomLog "@rel_logfiledir@/dummy-host.example.com-access_log" common
</VirtualHost>
<VirtualHost *:@@Port@@>
ServerAdmin webmaster@dummy-host2.example.com
DocumentRoot "@@ServerRoot@@/docs/dummy-host2.example.com"
ServerName dummy-host2.example.com
ErrorLog "@rel_logfiledir@/dummy-host2.example.com-error_log"
CustomLog "@rel_logfiledir@/dummy-host2.example.com-access_log" common
</VirtualHost>
httpd-2.4.64/docs/conf/extra/httpd-ssl.conf.in 0000664 0001751 0001751 00000031666 13106652031 021031 0 ustar covener covener #
# This is the Apache server configuration file providing SSL support.
# It contains the configuration directives to instruct the server how to
# serve pages over an https connection. For detailed information about these
# directives see <URL:http://httpd.apache.org/docs/2.4/mod/mod_ssl.html>
#
# Do NOT simply read the instructions in here without understanding
# what they do. They're here only as hints or reminders. If you are unsure
# consult the online docs. You have been warned.
#
# Required modules: mod_log_config, mod_setenvif, mod_ssl,
# socache_shmcb_module (for default value of SSLSessionCache)
#
# Pseudo Random Number Generator (PRNG):
# Configure one or more sources to seed the PRNG of the SSL library.
# The seed data should be of good random quality.
# WARNING! On some platforms /dev/random blocks if not enough entropy
# is available. This means you then cannot use the /dev/random device
# because it would lead to very long connection times (as long as
# it requires to make more entropy available). But usually those
# platforms additionally provide a /dev/urandom device which doesn't
# block. So, if available, use this one instead. Read the mod_ssl User
# Manual for more details.
#
#SSLRandomSeed startup file:/dev/random 512
#SSLRandomSeed startup file:/dev/urandom 512
#SSLRandomSeed connect file:/dev/random 512
#SSLRandomSeed connect file:/dev/urandom 512
#
# When we also provide SSL we have to listen to the
# standard HTTP port (see above) and to the HTTPS port
#
Listen @@SSLPort@@
##
## SSL Global Context
##
## All SSL configuration in this context applies both to
## the main server and all SSL-enabled virtual hosts.
##
# SSL Cipher Suite:
# List the ciphers that the client is permitted to negotiate,
# and that httpd will negotiate as the client of a proxied server.
# See the OpenSSL documentation for a complete list of ciphers, and
# ensure these follow appropriate best practices for this deployment.
# httpd 2.2.30, 2.4.13 and later force-disable aNULL, eNULL and EXP ciphers,
# while OpenSSL disabled these by default in 0.9.8zf/1.0.0r/1.0.1m/1.0.2a.
SSLCipherSuite HIGH:MEDIUM:!MD5:!RC4:!3DES
SSLProxyCipherSuite HIGH:MEDIUM:!MD5:!RC4:!3DES
# By the end of 2016, only TLSv1.2 ciphers should remain in use.
# Older ciphers should be disallowed as soon as possible, while the
# kRSA ciphers do not offer forward secrecy. These changes inhibit
# older clients (such as IE6 SP2 or IE8 on Windows XP, or other legacy
# non-browser tooling) from successfully connecting.
#
# To restrict mod_ssl to use only TLSv1.2 ciphers, and disable
# those protocols which do not support forward secrecy, replace
# the SSLCipherSuite and SSLProxyCipherSuite directives above with
# the following two directives, as soon as practical.
# SSLCipherSuite HIGH:MEDIUM:!SSLv3:!kRSA
# SSLProxyCipherSuite HIGH:MEDIUM:!SSLv3:!kRSA
# User agents such as web browsers are not configured for the user's
# own preference of either security or performance, therefore this
# must be the prerogative of the web server administrator who manages
# cpu load versus confidentiality, so enforce the server's cipher order.
SSLHonorCipherOrder on
# SSL Protocol support:
# List the protocol versions which clients are allowed to connect with.
# Disable SSLv3 by default (cf. RFC 7525 3.1.1). TLSv1 (1.0) should be
# disabled as quickly as practical. By the end of 2016, only the TLSv1.2
# protocol or later should remain in use.
SSLProtocol all -SSLv3
SSLProxyProtocol all -SSLv3
# Pass Phrase Dialog:
# Configure the pass phrase gathering process.
# The filtering dialog program (`builtin' is an internal
# terminal dialog) has to provide the pass phrase on stdout.
SSLPassPhraseDialog builtin
# Inter-Process Session Cache:
# Configure the SSL Session Cache: First the mechanism
# to use and second the expiring timeout (in seconds).
#SSLSessionCache "dbm:@exp_runtimedir@/ssl_scache"
SSLSessionCache "shmcb:@exp_runtimedir@/ssl_scache(512000)"
SSLSessionCacheTimeout 300
# OCSP Stapling (requires OpenSSL 0.9.8h or later)
#
# This feature is disabled by default and requires at least
# the two directives SSLUseStapling and SSLStaplingCache.
# Refer to the documentation on OCSP Stapling in the SSL/TLS
# How-To for more information.
#
# Enable stapling for all SSL-enabled servers:
#SSLUseStapling On
# Define a relatively small cache for OCSP Stapling using
# the same mechanism that is used for the SSL session cache
# above. If stapling is used with more than a few certificates,
# the size may need to be increased. (AH01929 will be logged.)
#SSLStaplingCache "shmcb:@exp_runtimedir@/ssl_stapling(32768)"
# Seconds before valid OCSP responses are expired from the cache
#SSLStaplingStandardCacheTimeout 3600
# Seconds before invalid OCSP responses are expired from the cache
#SSLStaplingErrorCacheTimeout 600
##
## SSL Virtual Host Context
##
<VirtualHost _default_:@@SSLPort@@>
# General setup for the virtual host
DocumentRoot "@exp_htdocsdir@"
ServerName www.example.com:@@SSLPort@@
ServerAdmin you@example.com
ErrorLog "@exp_logfiledir@/error_log"
TransferLog "@exp_logfiledir@/access_log"
# SSL Engine Switch:
# Enable/Disable SSL for this virtual host.
SSLEngine on
# Server Certificate:
# Point SSLCertificateFile at a PEM encoded certificate. If
# the certificate is encrypted, then you will be prompted for a
# pass phrase. Note that a kill -HUP will prompt again. Keep
# in mind that if you have both an RSA and a DSA certificate you
# can configure both in parallel (to also allow the use of DSA
# ciphers, etc.)
# Some ECC cipher suites (http://www.ietf.org/rfc/rfc4492.txt)
# require an ECC certificate which can also be configured in
# parallel.
SSLCertificateFile "@exp_sysconfdir@/server.crt"
#SSLCertificateFile "@exp_sysconfdir@/server-dsa.crt"
#SSLCertificateFile "@exp_sysconfdir@/server-ecc.crt"
# Server Private Key:
# If the key is not combined with the certificate, use this
# directive to point at the key file. Keep in mind that if
# you've both a RSA and a DSA private key you can configure
# both in parallel (to also allow the use of DSA ciphers, etc.)
# ECC keys, when in use, can also be configured in parallel
SSLCertificateKeyFile "@exp_sysconfdir@/server.key"
#SSLCertificateKeyFile "@exp_sysconfdir@/server-dsa.key"
#SSLCertificateKeyFile "@exp_sysconfdir@/server-ecc.key"
# Server Certificate Chain:
# Point SSLCertificateChainFile at a file containing the
# concatenation of PEM encoded CA certificates which form the
# certificate chain for the server certificate. Alternatively
# the referenced file can be the same as SSLCertificateFile
# when the CA certificates are directly appended to the server
# certificate for convenience.
#SSLCertificateChainFile "@exp_sysconfdir@/server-ca.crt"
# Certificate Authority (CA):
# Set the CA certificate verification path where to find CA
# certificates for client authentication or alternatively one
# huge file containing all of them (file must be PEM encoded)
# Note: Inside SSLCACertificatePath you need hash symlinks
# to point to the certificate files. Use the provided
# Makefile to update the hash symlinks after changes.
#SSLCACertificatePath "@exp_sysconfdir@/ssl.crt"
#SSLCACertificateFile "@exp_sysconfdir@/ssl.crt/ca-bundle.crt"
# Certificate Revocation Lists (CRL):
# Set the CA revocation path where to find CA CRLs for client
# authentication or alternatively one huge file containing all
# of them (file must be PEM encoded).
# The CRL checking mode needs to be configured explicitly
# through SSLCARevocationCheck (defaults to "none" otherwise).
# Note: Inside SSLCARevocationPath you need hash symlinks
# to point to the certificate files. Use the provided
# Makefile to update the hash symlinks after changes.
#SSLCARevocationPath "@exp_sysconfdir@/ssl.crl"
#SSLCARevocationFile "@exp_sysconfdir@/ssl.crl/ca-bundle.crl"
#SSLCARevocationCheck chain
# Client Authentication (Type):
# Client certificate verification type and depth. Types are
# none, optional, require and optional_no_ca. Depth is a
# number which specifies how deeply to verify the certificate
# issuer chain before deciding the certificate is not valid.
#SSLVerifyClient require
#SSLVerifyDepth 10
# TLS-SRP mutual authentication:
# Enable TLS-SRP and set the path to the OpenSSL SRP verifier
# file (containing login information for SRP user accounts).
# Requires OpenSSL 1.0.1 or newer. See the mod_ssl FAQ for
# detailed instructions on creating this file. Example:
# "openssl srp -srpvfile @exp_sysconfdir@/passwd.srpv -add username"
#SSLSRPVerifierFile "@exp_sysconfdir@/passwd.srpv"
# Access Control:
# With SSLRequire you can do per-directory access control based
# on arbitrary complex boolean expressions containing server
# variable checks and other lookup directives. The syntax is a
# mixture between C and Perl. See the mod_ssl documentation
# for more details.
#<Location />
#SSLRequire ( %{SSL_CIPHER} !~ m/^(EXP|NULL)/ \
# and %{SSL_CLIENT_S_DN_O} eq "Snake Oil, Ltd." \
# and %{SSL_CLIENT_S_DN_OU} in {"Staff", "CA", "Dev"} \
# and %{TIME_WDAY} >= 1 and %{TIME_WDAY} <= 5 \
# and %{TIME_HOUR} >= 8 and %{TIME_HOUR} <= 20 ) \
# or %{REMOTE_ADDR} =~ m/^192\.76\.162\.[0-9]+$/
#</Location>
# SSL Engine Options:
# Set various options for the SSL engine.
# o FakeBasicAuth:
# Translate the client X.509 into a Basic Authorisation. This means that
# the standard Auth/DBMAuth methods can be used for access control. The
# user name is the `one line' version of the client's X.509 certificate.
# Note that no password is obtained from the user. Every entry in the user
# file needs this password: `xxj31ZMTZzkVA'.
# o ExportCertData:
# This exports two additional environment variables: SSL_CLIENT_CERT and
# SSL_SERVER_CERT. These contain the PEM-encoded certificates of the
# server (always existing) and the client (only existing when client
# authentication is used). This can be used to import the certificates
# into CGI scripts.
# o StdEnvVars:
# This exports the standard SSL/TLS related `SSL_*' environment variables.
# Per default this exportation is switched off for performance reasons,
# because the extraction step is an expensive operation and is usually
# useless for serving static content. So one usually enables the
# exportation for CGI and SSI requests only.
# o StrictRequire:
# This denies access when "SSLRequireSSL" or "SSLRequire" applied even
# under a "Satisfy any" situation, i.e. when it applies access is denied
# and no other module can change it.
# o OptRenegotiate:
# This enables optimized SSL connection renegotiation handling when SSL
# directives are used in per-directory context.
#SSLOptions +FakeBasicAuth +ExportCertData +StrictRequire
<FilesMatch "\.(cgi|shtml|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory "@exp_cgidir@">
SSLOptions +StdEnvVars
</Directory>
# SSL Protocol Adjustments:
# The safe and default but still SSL/TLS standard compliant shutdown
# approach is that mod_ssl sends the close notify alert but doesn't wait for
# the close notify alert from client. When you need a different shutdown
# approach you can use one of the following variables:
# o ssl-unclean-shutdown:
# This forces an unclean shutdown when the connection is closed, i.e. no
# SSL close notify alert is sent or allowed to be received. This violates
# the SSL/TLS standard but is needed for some brain-dead browsers. Use
# this when you receive I/O errors because of the standard approach where
# mod_ssl sends the close notify alert.
# o ssl-accurate-shutdown:
# This forces an accurate shutdown when the connection is closed, i.e. a
# SSL close notify alert is send and mod_ssl waits for the close notify
# alert of the client. This is 100% SSL/TLS standard compliant, but in
# practice often causes hanging connections with brain-dead browsers. Use
# this only for browsers where you know that their SSL implementation
# works correctly.
# Notice: Most problems of broken clients are also related to the HTTP
# keep-alive facility, so you usually additionally want to disable
# keep-alive for those clients, too. Use variable "nokeepalive" for this.
# Similarly, one has to force some clients to use HTTP/1.0 to workaround
# their broken HTTP/1.1 implementation. Use variables "downgrade-1.0" and
# "force-response-1.0" for this.
BrowserMatch "MSIE [2-5]" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
# Per-Server Logging:
# The home of a custom SSL log file. Use this when you want a
# compact non-error SSL logfile on a virtual host basis.
CustomLog "@exp_logfiledir@/ssl_request_log" \
"%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
</VirtualHost>
httpd-2.4.64/docs/conf/extra/httpd-default.conf.in 0000664 0001751 0001751 00000005576 12003240052 021644 0 ustar covener covener #
# This configuration file reflects default settings for Apache HTTP Server.
#
# You may change these, but chances are that you may not need to.
#
#
# Timeout: The number of seconds before receives and sends time out.
#
Timeout 60
#
# KeepAlive: Whether or not to allow persistent connections (more than
# one request per connection). Set to "Off" to deactivate.
#
KeepAlive On
#
# MaxKeepAliveRequests: The maximum number of requests to allow
# during a persistent connection. Set to 0 to allow an unlimited amount.
# We recommend you leave this number high, for maximum performance.
#
MaxKeepAliveRequests 100
#
# KeepAliveTimeout: Number of seconds to wait for the next request from the
# same client on the same connection.
#
KeepAliveTimeout 5
#
# UseCanonicalName: Determines how Apache constructs self-referencing
# URLs and the SERVER_NAME and SERVER_PORT variables.
# When set "Off", Apache will use the Hostname and Port supplied
# by the client. When set "On", Apache will use the value of the
# ServerName directive.
#
UseCanonicalName Off
#
# AccessFileName: The name of the file to look for in each directory
# for additional configuration directives. See also the AllowOverride
# directive.
#
AccessFileName .htaccess
#
# ServerTokens
# This directive configures what you return as the Server HTTP response
# Header. The default is 'Full' which sends information about the OS-Type
# and compiled in modules.
# Set to one of: Full | OS | Minor | Minimal | Major | Prod
# where Full conveys the most information, and Prod the least.
#
ServerTokens Full
#
# Optionally add a line containing the server version and virtual host
# name to server-generated pages (internal error documents, FTP directory
# listings, mod_status and mod_info output etc., but not CGI generated
# documents or custom error documents).
# Set to "EMail" to also include a mailto: link to the ServerAdmin.
# Set to one of: On | Off | EMail
#
ServerSignature Off
#
# HostnameLookups: Log the names of clients or just their IP addresses
# e.g., www.apache.org (on) or 204.62.129.132 (off).
# The default is off because it'd be overall better for the net if people
# had to knowingly turn this feature on, since enabling it means that
# each client request will result in AT LEAST one lookup request to the
# nameserver.
#
HostnameLookups Off
#
# Set a timeout for how long the client may take to send the request header
# and body.
# The default for the headers is header=20-40,MinRate=500, which means wait
# for the first byte of headers for 20 seconds. If some data arrives,
# increase the timeout corresponding to a data rate of 500 bytes/s, but not
# above 40 seconds.
# The default for the request body is body=20,MinRate=500, which is the same
# but has no upper limit for the timeout.
# To disable, set to header=0 body=0
#
<IfModule reqtimeout_module>
RequestReadTimeout header=20-40,MinRate=500 body=20,MinRate=500
</IfModule>
httpd-2.4.64/docs/conf/extra/httpd-dav.conf.in 0000664 0001751 0001751 00000003612 14743443462 021006 0 ustar covener covener #
# Distributed authoring and versioning (WebDAV)
#
# Required modules: mod_alias, mod_auth_digest, mod_authn_core, mod_authn_file,
# mod_authz_core, mod_authz_user, mod_dav, mod_dav_fs,
# mod_setenvif
# The following example gives DAV write access to a directory called
# "uploads" under the ServerRoot directory.
#
# The User/Group specified in httpd.conf needs to have write permissions
# on the directory where the DavLockDB is placed and on any directory where
# "Dav On" is specified.
DavLockDB "@@ServerRoot@@/var/DavLock"
Alias /uploads "@@ServerRoot@@/uploads"
<Directory "@@ServerRoot@@/uploads">
Dav On
AuthType Digest
AuthName DAV-upload
# You can use the htdigest program to create the password database:
# htdigest -c "@@ServerRoot@@/user.passwd" DAV-upload admin
AuthUserFile "@@ServerRoot@@/user.passwd"
AuthDigestProvider file
# Allow universal read-access, but writes are restricted
# to the admin user.
<RequireAny>
Require method GET POST OPTIONS
Require user admin
</RequireAny>
</Directory>
#
# The following directives disable redirects on non-GET requests for
# a directory that does not include the trailing slash. This fixes a
# problem with several clients that do not appropriately handle
# redirects for folders with DAV methods.
#
BrowserMatch "Microsoft Data Access Internet Publishing Provider" redirect-carefully
BrowserMatch "MS FrontPage" redirect-carefully
BrowserMatch "^WebDrive" redirect-carefully
BrowserMatch "^WebDAVFS/1\.[012]" redirect-carefully
BrowserMatch "^gnome-vfs/1\.0" redirect-carefully
BrowserMatch "^gvfs/1" redirect-carefully
BrowserMatch "^XML Spy" redirect-carefully
BrowserMatch "^Dreamweaver-WebDAV-SCM1" redirect-carefully
BrowserMatch " Konqueror/4" redirect-carefully
BrowserMatch " Konqueror/5" redirect-carefully
BrowserMatch " dolphin/" redirect-carefully
httpd-2.4.64/docs/conf/extra/proxy-html.conf.in 0000664 0001751 0001751 00000006131 12006245256 021224 0 ustar covener covener # Configuration example.
#
# For detailed information about these directives see
# <URL:http://httpd.apache.org/docs/2.4/mod/mod_proxy_html.html>
# and for mod_xml2enc see
# <URL:http://httpd.apache.org/docs/2.4/mod/mod_xml2enc.html>
#
# First, to load the module with its prerequisites. Note: mod_xml2enc
# is not always necessary, but without it mod_proxy_html is likely to
# mangle pages in encodings other than ASCII or Unicode (utf-8).
#
# For Unix-family systems:
# LoadFile /usr/lib/libxml2.so
# LoadModule proxy_html_module modules/mod_proxy_html.so
# LoadModule xml2enc_module modules/mod_xml2enc.so
#
# For Windows (I don't know if there's a standard path for the libraries)
# LoadFile C:/path/zlib.dll
# LoadFile C:/path/iconv.dll
# LoadFile C:/path/libxml2.dll
# LoadModule proxy_html_module modules/mod_proxy_html.so
# LoadModule xml2enc_module modules/mod_xml2enc.so
#
# All knowledge of HTML links has been removed from the mod_proxy_html
# code itself, and is instead read from httpd.conf (or included file)
# at server startup. So you MUST declare it. This will normally be
# at top level, but can also be used in a <Location>.
#
# Here's the declaration for W3C HTML 4.01 and XHTML 1.0
ProxyHTMLLinks a href
ProxyHTMLLinks area href
ProxyHTMLLinks link href
ProxyHTMLLinks img src longdesc usemap
ProxyHTMLLinks object classid codebase data usemap
ProxyHTMLLinks q cite
ProxyHTMLLinks blockquote cite
ProxyHTMLLinks ins cite
ProxyHTMLLinks del cite
ProxyHTMLLinks form action
ProxyHTMLLinks input src usemap
ProxyHTMLLinks head profile
ProxyHTMLLinks base href
ProxyHTMLLinks script src for
# To support scripting events (with ProxyHTMLExtended On),
# you'll need to declare them too.
ProxyHTMLEvents onclick ondblclick onmousedown onmouseup \
onmouseover onmousemove onmouseout onkeypress \
onkeydown onkeyup onfocus onblur onload \
onunload onsubmit onreset onselect onchange
# If you need to support legacy (pre-1998, aka "transitional") HTML or XHTML,
# you'll need to uncomment the following deprecated link attributes.
# Note that these are enabled in earlier mod_proxy_html versions
#
# ProxyHTMLLinks frame src longdesc
# ProxyHTMLLinks iframe src longdesc
# ProxyHTMLLinks body background
# ProxyHTMLLinks applet codebase
#
# If you're dealing with proprietary HTML variants,
# declare your own URL attributes here as required.
#
# ProxyHTMLLinks myelement myattr otherattr
#
###########
# EXAMPLE #
###########
#
# To define the URL /my-gateway/ as a gateway to an appserver with address
# http://some.app.intranet/ on a private network, after loading the
# modules and including this configuration file:
#
# ProxyRequests Off <-- this is an important security setting
# ProxyPass /my-gateway/ http://some.app.intranet/
# <Location /my-gateway/>
# ProxyPassReverse /
# ProxyHTMLEnable On
# ProxyHTMLURLMap http://some.app.intranet/ /my-gateway/
# ProxyHTMLURLMap / /my-gateway/
# </Location>
#
# Many (though not all) real-life setups are more complex.
#
# See the documentation at
# http://apache.webthing.com/mod_proxy_html/
# and the tutorial at
# http://www.apachetutor.org/admin/reverseproxies
httpd-2.4.64/docs/conf/extra/httpd-mpm.conf.in 0000664 0001751 0001751 00000010550 12012563134 021006 0 ustar covener covener #
# Server-Pool Management (MPM specific)
#
#
# PidFile: The file in which the server should record its process
# identification number when it starts.
#
# Note that this is the default PidFile for most MPMs.
#
<IfModule !mpm_netware_module>
PidFile "@rel_runtimedir@/httpd.pid"
</IfModule>
#
# Only one of the below sections will be relevant on your
# installed httpd. Use "apachectl -l" to find out the
# active mpm.
#
# prefork MPM
# StartServers: number of server processes to start
# MinSpareServers: minimum number of server processes which are kept spare
# MaxSpareServers: maximum number of server processes which are kept spare
# MaxRequestWorkers: maximum number of server processes allowed to start
# MaxConnectionsPerChild: maximum number of connections a server process serves
# before terminating
<IfModule mpm_prefork_module>
StartServers 5
MinSpareServers 5
MaxSpareServers 10
MaxRequestWorkers 250
MaxConnectionsPerChild 0
</IfModule>
# worker MPM
# StartServers: initial number of server processes to start
# MinSpareThreads: minimum number of worker threads which are kept spare
# MaxSpareThreads: maximum number of worker threads which are kept spare
# ThreadsPerChild: constant number of worker threads in each server process
# MaxRequestWorkers: maximum number of worker threads
# MaxConnectionsPerChild: maximum number of connections a server process serves
# before terminating
<IfModule mpm_worker_module>
StartServers 3
MinSpareThreads 75
MaxSpareThreads 250
ThreadsPerChild 25
MaxRequestWorkers 400
MaxConnectionsPerChild 0
</IfModule>
# event MPM
# StartServers: initial number of server processes to start
# MinSpareThreads: minimum number of worker threads which are kept spare
# MaxSpareThreads: maximum number of worker threads which are kept spare
# ThreadsPerChild: constant number of worker threads in each server process
# MaxRequestWorkers: maximum number of worker threads
# MaxConnectionsPerChild: maximum number of connections a server process serves
# before terminating
<IfModule mpm_event_module>
StartServers 3
MinSpareThreads 75
MaxSpareThreads 250
ThreadsPerChild 25
MaxRequestWorkers 400
MaxConnectionsPerChild 0
</IfModule>
# NetWare MPM
# ThreadStackSize: Stack size allocated for each worker thread
# StartThreads: Number of worker threads launched at server startup
# MinSpareThreads: Minimum number of idle threads, to handle request spikes
# MaxSpareThreads: Maximum number of idle threads
# MaxThreads: Maximum number of worker threads alive at the same time
# MaxConnectionsPerChild: Maximum number of connections a thread serves. It
# is recommended that the default value of 0 be set
# for this directive on NetWare. This will allow the
# thread to continue to service requests indefinitely.
<IfModule mpm_netware_module>
ThreadStackSize 65536
StartThreads 250
MinSpareThreads 25
MaxSpareThreads 250
MaxThreads 1000
MaxConnectionsPerChild 0
</IfModule>
# OS/2 MPM
# StartServers: Number of server processes to maintain
# MinSpareThreads: Minimum number of idle threads per process,
# to handle request spikes
# MaxSpareThreads: Maximum number of idle threads per process
# MaxConnectionsPerChild: Maximum number of connections per server process
<IfModule mpm_mpmt_os2_module>
StartServers 2
MinSpareThreads 5
MaxSpareThreads 10
MaxConnectionsPerChild 0
</IfModule>
# WinNT MPM
# ThreadsPerChild: constant number of worker threads in the server process
# MaxConnectionsPerChild: maximum number of connections a server process serves
<IfModule mpm_winnt_module>
ThreadsPerChild 150
MaxConnectionsPerChild 0
</IfModule>
# The maximum number of free Kbytes that every allocator is allowed
# to hold without calling free(). In threaded MPMs, every thread has its own
# allocator. When not set, or when set to zero, the threshold will be set to
# unlimited.
<IfModule !mpm_netware_module>
MaxMemFree 2048
</IfModule>
<IfModule mpm_netware_module>
MaxMemFree 100
</IfModule>
httpd-2.4.64/docs/conf/extra/httpd-userdir.conf.in 0000664 0001751 0001751 00000001266 11573244531 021706 0 ustar covener covener # Settings for user home directories
#
# Required module: mod_authz_core, mod_authz_host, mod_userdir
#
# UserDir: The name of the directory that is appended onto a user's home
# directory if a ~user request is received. Note that you must also set
# the default access control for these directories, as in the example below.
#
UserDir public_html
#
# Control access to UserDir directories. The following is an example
# for a site where these directories are restricted to read-only.
#
<Directory "/home/*/public_html">
AllowOverride FileInfo AuthConfig Limit Indexes
Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
Require method GET POST OPTIONS
</Directory>
httpd-2.4.64/docs/conf/extra/httpd-autoindex.conf.in 0000664 0001751 0001751 00000005455 11405657151 022235 0 ustar covener covener #
# Directives controlling the display of server-generated directory listings.
#
# Required modules: mod_authz_core, mod_authz_host,
# mod_autoindex, mod_alias
#
# To see the listing of a directory, the Options directive for the
# directory must include "Indexes", and the directory must not contain
# a file matching those listed in the DirectoryIndex directive.
#
#
# IndexOptions: Controls the appearance of server-generated directory
# listings.
#
IndexOptions FancyIndexing HTMLTable VersionSort
# We include the /icons/ alias for FancyIndexed directory listings. If
# you do not use FancyIndexing, you may comment this out.
#
Alias /icons/ "@exp_iconsdir@/"
<Directory "@exp_iconsdir@">
Options Indexes MultiViews
AllowOverride None
Require all granted
</Directory>
#
# AddIcon* directives tell the server which icon to show for different
# files or filename extensions. These are only displayed for
# FancyIndexed directories.
#
AddIconByEncoding (CMP,/icons/compressed.gif) x-compress x-gzip
AddIconByType (TXT,/icons/text.gif) text/*
AddIconByType (IMG,/icons/image2.gif) image/*
AddIconByType (SND,/icons/sound2.gif) audio/*
AddIconByType (VID,/icons/movie.gif) video/*
AddIcon /icons/binary.gif .bin .exe
AddIcon /icons/binhex.gif .hqx
AddIcon /icons/tar.gif .tar
AddIcon /icons/world2.gif .wrl .wrl.gz .vrml .vrm .iv
AddIcon /icons/compressed.gif .Z .z .tgz .gz .zip
AddIcon /icons/a.gif .ps .ai .eps
AddIcon /icons/layout.gif .html .shtml .htm .pdf
AddIcon /icons/text.gif .txt
AddIcon /icons/c.gif .c
AddIcon /icons/p.gif .pl .py
AddIcon /icons/f.gif .for
AddIcon /icons/dvi.gif .dvi
AddIcon /icons/uuencoded.gif .uu
AddIcon /icons/script.gif .conf .sh .shar .csh .ksh .tcl
AddIcon /icons/tex.gif .tex
AddIcon /icons/bomb.gif core
AddIcon /icons/back.gif ..
AddIcon /icons/hand.right.gif README
AddIcon /icons/folder.gif ^^DIRECTORY^^
AddIcon /icons/blank.gif ^^BLANKICON^^
#
# DefaultIcon is which icon to show for files which do not have an icon
# explicitly set.
#
DefaultIcon /icons/unknown.gif
#
# AddDescription allows you to place a short description after a file in
# server-generated indexes. These are only displayed for FancyIndexed
# directories.
# Format: AddDescription "description" filename
#
#AddDescription "GZIP compressed document" .gz
#AddDescription "tar archive" .tar
#AddDescription "GZIP compressed tar archive" .tgz
#
# ReadmeName is the name of the README file the server will look for by
# default, and append to directory listings.
#
# HeaderName is the name of a file which should be prepended to
# directory indexes.
ReadmeName README.html
HeaderName HEADER.html
#
# IndexIgnore is a set of filenames which directory indexing should ignore
# and not include in the listing. Shell-style wildcarding is permitted.
#
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
httpd-2.4.64/docs/conf/extra/httpd-info.conf.in 0000664 0001751 0001751 00000002137 11405657151 021162 0 ustar covener covener #
# Get information about the requests being processed by the server
# and the configuration of the server.
#
# Required modules: mod_authz_core, mod_authz_host,
# mod_info (for the server-info handler),
# mod_status (for the server-status handler)
#
# Allow server status reports generated by mod_status,
# with the URL of http://servername/server-status
# Change the ".example.com" to match your domain to enable.
<Location /server-status>
SetHandler server-status
Require host .example.com
Require ip 127
</Location>
#
# ExtendedStatus controls whether Apache will generate "full" status
# information (ExtendedStatus On) or just basic information (ExtendedStatus
# Off) when the "server-status" handler is called. The default is Off.
#
#ExtendedStatus On
#
# Allow remote server configuration reports, with the URL of
# http://servername/server-info (requires that mod_info.c be loaded).
# Change the ".example.com" to match your domain to enable.
#
<Location /server-info>
SetHandler server-info
Require host .example.com
Require ip 127
</Location>
httpd-2.4.64/docs/conf/extra/httpd-multilang-errordoc.conf.in 0000664 0001751 0001751 00000004220 11405657151 024033 0 ustar covener covener #
# The configuration below implements multi-language error documents through
# content-negotiation.
#
# Required modules: mod_alias, mod_authz_core, mod_authz_host,
# mod_include, mod_negotiation
#
# We use Alias to redirect any /error/HTTP_<error>.html.var response to
# our collection of by-error message multi-language collections. We use
# includes to substitute the appropriate text.
#
# You can modify the messages' appearance without changing any of the
# default HTTP_<error>.html.var files by adding the line:
#
# Alias /error/include/ "/your/include/path/"
#
# which allows you to create your own set of files by starting with the
# @exp_errordir@/include/ files and copying them to /your/include/path/,
# even on a per-VirtualHost basis. The default include files will display
# your Apache version number and your ServerAdmin email address regardless
# of the setting of ServerSignature.
Alias /error/ "@exp_errordir@/"
<Directory "@exp_errordir@">
AllowOverride None
Options IncludesNoExec
AddOutputFilter Includes html
AddHandler type-map var
Require all granted
LanguagePriority en cs de es fr it ja ko nl pl pt-br ro sv tr
ForceLanguagePriority Prefer Fallback
</Directory>
ErrorDocument 400 /error/HTTP_BAD_REQUEST.html.var
ErrorDocument 401 /error/HTTP_UNAUTHORIZED.html.var
ErrorDocument 403 /error/HTTP_FORBIDDEN.html.var
ErrorDocument 404 /error/HTTP_NOT_FOUND.html.var
ErrorDocument 405 /error/HTTP_METHOD_NOT_ALLOWED.html.var
ErrorDocument 408 /error/HTTP_REQUEST_TIME_OUT.html.var
ErrorDocument 410 /error/HTTP_GONE.html.var
ErrorDocument 411 /error/HTTP_LENGTH_REQUIRED.html.var
ErrorDocument 412 /error/HTTP_PRECONDITION_FAILED.html.var
ErrorDocument 413 /error/HTTP_REQUEST_ENTITY_TOO_LARGE.html.var
ErrorDocument 414 /error/HTTP_REQUEST_URI_TOO_LARGE.html.var
ErrorDocument 415 /error/HTTP_UNSUPPORTED_MEDIA_TYPE.html.var
ErrorDocument 500 /error/HTTP_INTERNAL_SERVER_ERROR.html.var
ErrorDocument 501 /error/HTTP_NOT_IMPLEMENTED.html.var
ErrorDocument 502 /error/HTTP_BAD_GATEWAY.html.var
ErrorDocument 503 /error/HTTP_SERVICE_UNAVAILABLE.html.var
ErrorDocument 506 /error/HTTP_VARIANT_ALSO_VARIES.html.var
httpd-2.4.64/docs/conf/extra/httpd-languages.conf.in 0000664 0001751 0001751 00000011726 10764234743 022206 0 ustar covener covener #
# Settings for hosting different languages.
#
# Required modules: mod_mime, mod_negotiation
# DefaultLanguage and AddLanguage allows you to specify the language of
# a document. You can then use content negotiation to give a browser a
# file in a language the user can understand.
#
# Specify a default language. This means that all data
# going out without a specific language tag (see below) will
# be marked with this one. You probably do NOT want to set
# this unless you are sure it is correct for all cases.
#
# * It is generally better to not mark a page as
# * being a certain language than marking it with the wrong
# * language!
#
# DefaultLanguage nl
#
# Note 1: The suffix does not have to be the same as the language
# keyword --- those with documents in Polish (whose net-standard
# language code is pl) may wish to use "AddLanguage pl .po" to
# avoid the ambiguity with the common suffix for perl scripts.
#
# Note 2: The example entries below illustrate that in some cases
# the two character 'Language' abbreviation is not identical to
# the two character 'Country' code for its country,
# E.g. 'Danmark/dk' versus 'Danish/da'.
#
# Note 3: In the case of 'ltz' we violate the RFC by using a three char
# specifier. There is 'work in progress' to fix this and get
# the reference data for rfc1766 cleaned up.
#
# Catalan (ca) - Croatian (hr) - Czech (cs) - Danish (da) - Dutch (nl)
# English (en) - Esperanto (eo) - Estonian (et) - French (fr) - German (de)
# Greek-Modern (el) - Hebrew (he) - Italian (it) - Japanese (ja)
# Korean (ko) - Luxembourgeois* (ltz) - Norwegian Nynorsk (nn)
# Norwegian (no) - Polish (pl) - Portugese (pt)
# Brazilian Portuguese (pt-BR) - Russian (ru) - Swedish (sv)
# Turkish (tr) - Simplified Chinese (zh-CN) - Spanish (es)
# Traditional Chinese (zh-TW)
#
AddLanguage ca .ca
AddLanguage cs .cz .cs
AddLanguage da .dk
AddLanguage de .de
AddLanguage el .el
AddLanguage en .en
AddLanguage eo .eo
AddLanguage es .es
AddLanguage et .et
AddLanguage fr .fr
AddLanguage he .he
AddLanguage hr .hr
AddLanguage it .it
AddLanguage ja .ja
AddLanguage ko .ko
AddLanguage ltz .ltz
AddLanguage nl .nl
AddLanguage nn .nn
AddLanguage no .no
AddLanguage pl .po
AddLanguage pt .pt
AddLanguage pt-BR .pt-br
AddLanguage ru .ru
AddLanguage sv .sv
AddLanguage tr .tr
AddLanguage zh-CN .zh-cn
AddLanguage zh-TW .zh-tw
# LanguagePriority allows you to give precedence to some languages
# in case of a tie during content negotiation.
#
# Just list the languages in decreasing order of preference. We have
# more or less alphabetized them here. You probably want to change this.
#
LanguagePriority en ca cs da de el eo es et fr he hr it ja ko ltz nl nn no pl pt pt-BR ru sv tr zh-CN zh-TW
#
# ForceLanguagePriority allows you to serve a result page rather than
# MULTIPLE CHOICES (Prefer) [in case of a tie] or NOT ACCEPTABLE (Fallback)
# [in case no accepted languages matched the available variants]
#
ForceLanguagePriority Prefer Fallback
#
# Commonly used filename extensions to character sets. You probably
# want to avoid clashes with the language extensions, unless you
# are good at carefully testing your setup after each change.
# See http://www.iana.org/assignments/character-sets for the
# official list of charset names and their respective RFCs.
#
AddCharset us-ascii.ascii .us-ascii
AddCharset ISO-8859-1 .iso8859-1 .latin1
AddCharset ISO-8859-2 .iso8859-2 .latin2 .cen
AddCharset ISO-8859-3 .iso8859-3 .latin3
AddCharset ISO-8859-4 .iso8859-4 .latin4
AddCharset ISO-8859-5 .iso8859-5 .cyr .iso-ru
AddCharset ISO-8859-6 .iso8859-6 .arb .arabic
AddCharset ISO-8859-7 .iso8859-7 .grk .greek
AddCharset ISO-8859-8 .iso8859-8 .heb .hebrew
AddCharset ISO-8859-9 .iso8859-9 .latin5 .trk
AddCharset ISO-8859-10 .iso8859-10 .latin6
AddCharset ISO-8859-13 .iso8859-13
AddCharset ISO-8859-14 .iso8859-14 .latin8
AddCharset ISO-8859-15 .iso8859-15 .latin9
AddCharset ISO-8859-16 .iso8859-16 .latin10
AddCharset ISO-2022-JP .iso2022-jp .jis
AddCharset ISO-2022-KR .iso2022-kr .kis
AddCharset ISO-2022-CN .iso2022-cn .cis
AddCharset Big5.Big5 .big5 .b5
AddCharset cn-Big5 .cn-big5
# For russian, more than one charset is used (depends on client, mostly):
AddCharset WINDOWS-1251 .cp-1251 .win-1251
AddCharset CP866 .cp866
AddCharset KOI8 .koi8
AddCharset KOI8-E .koi8-e
AddCharset KOI8-r .koi8-r .koi8-ru
AddCharset KOI8-U .koi8-u
AddCharset KOI8-ru .koi8-uk .ua
AddCharset ISO-10646-UCS-2 .ucs2
AddCharset ISO-10646-UCS-4 .ucs4
AddCharset UTF-7 .utf7
AddCharset UTF-8 .utf8
AddCharset UTF-16 .utf16
AddCharset UTF-16BE .utf16be
AddCharset UTF-16LE .utf16le
AddCharset UTF-32 .utf32
AddCharset UTF-32BE .utf32be
AddCharset UTF-32LE .utf32le
AddCharset euc-cn .euc-cn
AddCharset euc-gb .euc-gb
AddCharset euc-jp .euc-jp
AddCharset euc-kr .euc-kr
#Not sure how euc-tw got in - IANA doesn't list it???
AddCharset EUC-TW .euc-tw
AddCharset gb2312 .gb2312 .gb
AddCharset iso-10646-ucs-2 .ucs-2 .iso-10646-ucs-2
AddCharset iso-10646-ucs-4 .ucs-4 .iso-10646-ucs-4
AddCharset shift_jis .shift_jis .sjis
httpd-2.4.64/docs/conf/charset.conv 0000664 0001751 0001751 00000003345 14743443462 017037 0 ustar covener covener
# Lang-abbv Charset Language
#---------------------------------
en ISO-8859-1 English
UTF-8 utf8 UTF-8
Unicode ucs Unicode
th Cp874 Thai
ja SJIS Japanese
ko Cp949 Korean
zh Cp950 Chinese-Traditional
zh-cn GB2312 Chinese-Simplified
zh-tw Cp950 Chinese
cs ISO-8859-2 Czech
hu ISO-8859-2 Hungarian
hr ISO-8859-2 Croatian
pl ISO-8859-2 Polish
ro ISO-8859-2 Romanian
sr ISO-8859-2 Serbian
sk ISO-8859-2 Slovak
sl ISO-8859-2 Slovenian
sq ISO-8859-2 Albanian
bg ISO-8859-5 Bulgarian
be ISO-8859-5 Byelorussian
mk ISO-8859-5 Macedonian
ru ISO-8859-5 Russian
uk ISO-8859-5 Ukrainian
ca ISO-8859-1 Catalan
de ISO-8859-1 German
da ISO-8859-1 Danish
fi ISO-8859-1 Finnish
fr ISO-8859-1 French
es ISO-8859-1 Spanish
is ISO-8859-1 Icelandic
it ISO-8859-1 Italian
nl ISO-8859-1 Dutch
no ISO-8859-1 Norwegian
pt ISO-8859-1 Portuguese
sv ISO-8859-1 Swedish
af ISO-8859-1 Afrikaans
eu ISO-8859-1 Basque
fo ISO-8859-1 Faroese
gl ISO-8859-1 Galician
ga ISO-8859-1 Irish
gd ISO-8859-1 Scottish
mt ISO-8859-3 Maltese
eo ISO-8859-3 Esperanto
el ISO-8859-7 Greek
tr ISO-8859-9 Turkish
he ISO-8859-8 Hebrew
iw ISO-8859-8 Hebrew
ar ISO-8859-6 Arabic
et ISO-8859-1 Estonian
lv ISO-8859-2 Latvian
lt ISO-8859-2 Lithuanian
httpd-2.4.64/docs/conf/httpd.conf.in 0000664 0001751 0001751 00000033036 12754716707 017123 0 ustar covener covener #
# This is the main Apache HTTP server configuration file. It contains the
# configuration directives that give the server its instructions.
# See <URL:http://httpd.apache.org/docs/2.4/> for detailed information.
# In particular, see
# <URL:http://httpd.apache.org/docs/2.4/mod/directives.html>
# for a discussion of each configuration directive.
#
# Do NOT simply read the instructions in here without understanding
# what they do. They're here only as hints or reminders. If you are unsure
# consult the online docs. You have been warned.
#
# Configuration and logfile names: If the filenames you specify for many
# of the server's control files begin with "/" (or "drive:/" for Win32), the
# server will use that explicit path. If the filenames do *not* begin
# with "/", the value of ServerRoot is prepended -- so "logs/access_log"
# with ServerRoot set to "/usr/local/apache2" will be interpreted by the
# server as "/usr/local/apache2/logs/access_log", whereas "/logs/access_log"
# will be interpreted as '/logs/access_log'.
#
# ServerRoot: The top of the directory tree under which the server's
# configuration, error, and log files are kept.
#
# Do not add a slash at the end of the directory path. If you point
# ServerRoot at a non-local disk, be sure to specify a local disk on the
# Mutex directive, if file-based mutexes are used. If you wish to share the
# same ServerRoot for multiple httpd daemons, you will need to change at
# least PidFile.
#
ServerRoot "@@ServerRoot@@"
#
# Mutex: Allows you to set the mutex mechanism and mutex file directory
# for individual mutexes, or change the global defaults
#
# Uncomment and change the directory if mutexes are file-based and the default
# mutex file directory is not on a local disk or is not appropriate for some
# other reason.
#
# Mutex default:@rel_runtimedir@
#
# Listen: Allows you to bind Apache to specific IP addresses and/or
# ports, instead of the default. See also the <VirtualHost>
# directive.
#
# Change this to Listen on specific IP addresses as shown below to
# prevent Apache from glomming onto all bound IP addresses.
#
#Listen 12.34.56.78:80
Listen @@Port@@
#
# Dynamic Shared Object (DSO) Support
#
# To be able to use the functionality of a module which was built as a DSO you
# have to place corresponding `LoadModule' lines at this location so the
# directives contained in it are actually available _before_ they are used.
# Statically compiled modules (those listed by `httpd -l') do not need
# to be loaded here.
#
# Example:
# LoadModule foo_module modules/mod_foo.so
#
@@LoadModule@@
<IfModule unixd_module>
#
# If you wish httpd to run as a different user or group, you must run
# httpd as root initially and it will switch.
#
# User/Group: The name (or #number) of the user/group to run httpd as.
# It is usually good practice to create a dedicated user and group for
# running httpd, as with most system services.
#
User daemon
Group daemon
</IfModule>
# 'Main' server configuration
#
# The directives in this section set up the values used by the 'main'
# server, which responds to any requests that aren't handled by a
# <VirtualHost> definition. These values also provide defaults for
# any <VirtualHost> containers you may define later in the file.
#
# All of these directives may appear inside <VirtualHost> containers,
# in which case these default settings will be overridden for the
# virtual host being defined.
#
#
# ServerAdmin: Your address, where problems with the server should be
# e-mailed. This address appears on some server-generated pages, such
# as error documents. e.g. admin@your-domain.com
#
ServerAdmin you@example.com
#
# ServerName gives the name and port that the server uses to identify itself.
# This can often be determined automatically, but we recommend you specify
# it explicitly to prevent problems during startup.
#
# If your host doesn't have a registered DNS name, enter its IP address here.
#
#ServerName www.example.com:@@Port@@
#
# Deny access to the entirety of your server's filesystem. You must
# explicitly permit access to web content directories in other
# <Directory> blocks below.
#
<Directory />
AllowOverride none
Require all denied
</Directory>
#
# Note that from this point forward you must specifically allow
# particular features to be enabled - so if something's not working as
# you might expect, make sure that you have specifically enabled it
# below.
#
#
# DocumentRoot: The directory out of which you will serve your
# documents. By default, all requests are taken from this directory, but
# symbolic links and aliases may be used to point to other locations.
#
DocumentRoot "@exp_htdocsdir@"
<Directory "@exp_htdocsdir@">
#
# Possible values for the Options directive are "None", "All",
# or any combination of:
# Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
#
# Note that "MultiViews" must be named *explicitly* --- "Options All"
# doesn't give it to you.
#
# The Options directive is both complicated and important. Please see
# http://httpd.apache.org/docs/2.4/mod/core.html#options
# for more information.
#
Options Indexes FollowSymLinks
#
# AllowOverride controls what directives may be placed in .htaccess files.
# It can be "All", "None", or any combination of the keywords:
# AllowOverride FileInfo AuthConfig Limit
#
AllowOverride None
#
# Controls who can get stuff from this server.
#
Require all granted
</Directory>
#
# DirectoryIndex: sets the file that Apache will serve if a directory
# is requested.
#
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
#
# The following lines prevent .htaccess and .htpasswd files from being
# viewed by Web clients.
#
<Files ".ht*">
Require all denied
</Files>
#
# ErrorLog: The location of the error log file.
# If you do not specify an ErrorLog directive within a <VirtualHost>
# container, error messages relating to that virtual host will be
# logged here. If you *do* define an error logfile for a <VirtualHost>
# container, that host's errors will be logged there and not here.
#
ErrorLog "@rel_logfiledir@/error_log"
#
# LogLevel: Control the number of messages logged to the error_log.
# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
#
LogLevel warn
<IfModule log_config_module>
#
# The following directives define some format nicknames for use with
# a CustomLog directive (see below).
#
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
LogFormat "%h %l %u %t \"%r\" %>s %b" common
<IfModule logio_module>
# You need to enable mod_logio.c to use %I and %O
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %I %O" combinedio
</IfModule>
#
# The location and format of the access logfile (Common Logfile Format).
# If you do not define any access logfiles within a <VirtualHost>
# container, they will be logged here. Contrariwise, if you *do*
# define per-<VirtualHost> access logfiles, transactions will be
# logged therein and *not* in this file.
#
CustomLog "@rel_logfiledir@/access_log" common
#
# If you prefer a logfile with access, agent, and referer information
# (Combined Logfile Format) you can use the following directive.
#
#CustomLog "@rel_logfiledir@/access_log" combined
</IfModule>
<IfModule alias_module>
#
# Redirect: Allows you to tell clients about documents that used to
# exist in your server's namespace, but do not anymore. The client
# will make a new request for the document at its new location.
# Example:
# Redirect permanent /foo http://www.example.com/bar
#
# Alias: Maps web paths into filesystem paths and is used to
# access content that does not live under the DocumentRoot.
# Example:
# Alias /webpath /full/filesystem/path
#
# If you include a trailing / on /webpath then the server will
# require it to be present in the URL. You will also likely
# need to provide a <Directory> section to allow access to
# the filesystem path.
#
# ScriptAlias: This controls which directories contain server scripts.
# ScriptAliases are essentially the same as Aliases, except that
# documents in the target directory are treated as applications and
# run by the server when requested rather than as documents sent to the
# client. The same rules about trailing "/" apply to ScriptAlias
# directives as to Alias.
#
ScriptAlias /cgi-bin/ "@exp_cgidir@/"
</IfModule>
<IfModule cgid_module>
#
# ScriptSock: On threaded servers, designate the path to the UNIX
# socket used to communicate with the CGI daemon of mod_cgid.
#
#Scriptsock cgisock
</IfModule>
#
# "@exp_cgidir@" should be changed to whatever your ScriptAliased
# CGI directory exists, if you have that configured.
#
<Directory "@exp_cgidir@">
AllowOverride None
Options None
Require all granted
</Directory>
<IfModule headers_module>
#
# Avoid passing HTTP_PROXY environment to CGI's on this or any proxied
# backend servers which have lingering "httpoxy" defects.
# 'Proxy' request header is undefined by the IETF, not listed by IANA
#
RequestHeader unset Proxy early
</IfModule>
<IfModule mime_module>
#
# TypesConfig points to the file containing the list of mappings from
# filename extension to MIME-type.
#
TypesConfig @rel_sysconfdir@/mime.types
#
# AddType allows you to add to or override the MIME configuration
# file specified in TypesConfig for specific file types.
#
#AddType application/x-gzip .tgz
#
# AddEncoding allows you to have certain browsers uncompress
# information on the fly. Note: Not all browsers support this.
#
#AddEncoding x-compress .Z
#AddEncoding x-gzip .gz .tgz
#
# If the AddEncoding directives above are commented-out, then you
# probably should define those extensions to indicate media types:
#
AddType application/x-compress .Z
AddType application/x-gzip .gz .tgz
#
# AddHandler allows you to map certain file extensions to "handlers":
# actions unrelated to filetype. These can be either built into the server
# or added with the Action directive (see below)
#
# To use CGI scripts outside of ScriptAliased directories:
# (You will also need to add "ExecCGI" to the "Options" directive.)
#
#AddHandler cgi-script .cgi
# For type maps (negotiated resources):
#AddHandler type-map var
#
# Filters allow you to process content before it is sent to the client.
#
# To parse .shtml files for server-side includes (SSI):
# (You will also need to add "Includes" to the "Options" directive.)
#
#AddType text/html .shtml
#AddOutputFilter INCLUDES .shtml
</IfModule>
#
# The mod_mime_magic module allows the server to use various hints from the
# contents of the file itself to determine its type. The MIMEMagicFile
# directive tells the module where the hint definitions are located.
#
#MIMEMagicFile @rel_sysconfdir@/magic
#
# Customizable error responses come in three flavors:
# 1) plain text 2) local redirects 3) external redirects
#
# Some examples:
#ErrorDocument 500 "The server made a boo boo."
#ErrorDocument 404 /missing.html
#ErrorDocument 404 "/cgi-bin/missing_handler.pl"
#ErrorDocument 402 http://www.example.com/subscription_info.html
#
#
# MaxRanges: Maximum number of Ranges in a request before
# returning the entire resource, or one of the special
# values 'default', 'none' or 'unlimited'.
# Default setting is to accept 200 Ranges.
#MaxRanges unlimited
#
# EnableMMAP and EnableSendfile: On systems that support it,
# memory-mapping or the sendfile syscall may be used to deliver
# files. This usually improves server performance, but must
# be turned off when serving from networked-mounted
# filesystems or if support for these functions is otherwise
# broken on your system.
# Defaults: EnableMMAP On, EnableSendfile Off
#
#EnableMMAP off
#EnableSendfile on
# Supplemental configuration
#
# The configuration files in the @rel_sysconfdir@/extra/ directory can be
# included to add extra features or to modify the default configuration of
# the server, or you may simply copy their contents here and change as
# necessary.
# Server-pool management (MPM specific)
#Include @rel_sysconfdir@/extra/httpd-mpm.conf
# Multi-language error messages
#Include @rel_sysconfdir@/extra/httpd-multilang-errordoc.conf
# Fancy directory listings
#Include @rel_sysconfdir@/extra/httpd-autoindex.conf
# Language settings
#Include @rel_sysconfdir@/extra/httpd-languages.conf
# User home directories
#Include @rel_sysconfdir@/extra/httpd-userdir.conf
# Real-time info on requests and configuration
#Include @rel_sysconfdir@/extra/httpd-info.conf
# Virtual hosts
#Include @rel_sysconfdir@/extra/httpd-vhosts.conf
# Local access to the Apache HTTP Server Manual
#Include @rel_sysconfdir@/extra/httpd-manual.conf
# Distributed authoring and versioning (WebDAV)
#Include @rel_sysconfdir@/extra/httpd-dav.conf
# Various default settings
#Include @rel_sysconfdir@/extra/httpd-default.conf
# Configure mod_proxy_html to understand HTML4/XHTML1
<IfModule proxy_html_module>
Include @rel_sysconfdir@/extra/proxy-html.conf
</IfModule>
# Secure (SSL/TLS) connections
#Include @rel_sysconfdir@/extra/httpd-ssl.conf
#
# Note: The following must must be present to support
# starting without SSL on platforms with no /dev/random equivalent
# but a statically compiled-in mod_ssl.
#
<IfModule ssl_module>
SSLRandomSeed startup builtin
SSLRandomSeed connect builtin
</IfModule>
httpd-2.4.64/docs/conf/magic 0000664 0001751 0001751 00000031410 13507631724 015511 0 ustar covener covener # Magic data for mod_mime_magic Apache module (originally for file(1) command)
# The module is described in /manual/mod/mod_mime_magic.html
#
# The format is 4-5 columns:
# Column #1: byte number to begin checking from, ">" indicates continuation
# Column #2: type of data to match
# Column #3: contents of data to match
# Column #4: MIME type of result
# Column #5: MIME encoding of result (optional)
#------------------------------------------------------------------------------
# Localstuff: file(1) magic for locally observed files
# Add any locally observed files here.
#------------------------------------------------------------------------------
# end local stuff
#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
# Java
0 short 0xcafe
>2 short 0xbabe application/java
#------------------------------------------------------------------------------
# audio: file(1) magic for sound formats
#
# from Jan Nicolai Langfeldt <janl@ifi.uio.no>,
#
# Sun/NeXT audio data
0 string .snd
>12 belong 1 audio/basic
>12 belong 2 audio/basic
>12 belong 3 audio/basic
>12 belong 4 audio/basic
>12 belong 5 audio/basic
>12 belong 6 audio/basic
>12 belong 7 audio/basic
>12 belong 23 audio/x-adpcm
# DEC systems (e.g. DECstation 5000) use a variant of the Sun/NeXT format
# that uses little-endian encoding and has a different magic number
# (0x0064732E in little-endian encoding).
0 lelong 0x0064732E
>12 lelong 1 audio/x-dec-basic
>12 lelong 2 audio/x-dec-basic
>12 lelong 3 audio/x-dec-basic
>12 lelong 4 audio/x-dec-basic
>12 lelong 5 audio/x-dec-basic
>12 lelong 6 audio/x-dec-basic
>12 lelong 7 audio/x-dec-basic
# compressed (G.721 ADPCM)
>12 lelong 23 audio/x-dec-adpcm
# Bytes 0-3 of AIFF, AIFF-C, & 8SVX audio files are "FORM"
# AIFF audio data
8 string AIFF audio/x-aiff
# AIFF-C audio data
8 string AIFC audio/x-aiff
# IFF/8SVX audio data
8 string 8SVX audio/x-aiff
# Creative Labs AUDIO stuff
# Standard MIDI data
0 string MThd audio/unknown
#>9 byte >0 (format %d)
#>11 byte >1 using %d channels
# Creative Music (CMF) data
0 string CTMF audio/unknown
# SoundBlaster instrument data
0 string SBI audio/unknown
# Creative Labs voice data
0 string Creative\ Voice\ File audio/unknown
## is this next line right? it came this way...
#>19 byte 0x1A
#>23 byte >0 - version %d
#>22 byte >0 \b.%d
# [GRR 950115: is this also Creative Labs? Guessing that first line
# should be string instead of unknown-endian long...]
#0 long 0x4e54524b MultiTrack sound data
#0 string NTRK MultiTrack sound data
#>4 long x - version %ld
# Microsoft WAVE format (*.wav)
# [GRR 950115: probably all of the shorts and longs should be leshort/lelong]
# Microsoft RIFF
0 string RIFF
# - WAVE format
>8 string WAVE audio/x-wav
# MPEG audio.
0 beshort&0xfff0 0xfff0 audio/mpeg
# C64 SID Music files, from Linus Walleij <triad@df.lth.se>
0 string PSID audio/prs.sid
#------------------------------------------------------------------------------
# c-lang: file(1) magic for C programs or various scripts
#
# XPM icons (Greg Roelofs, newt@uchicago.edu)
# ideally should go into "images", but entries below would tag XPM as C source
0 string /*\ XPM image/x-xbm 7bit
# this first will upset you if you're a PL/1 shop... (are there any left?)
# in which case rm it; ascmagic will catch real C programs
# C or REXX program text
0 string /* text/plain
# C++ program text
0 string // text/plain
#------------------------------------------------------------------------------
# compress: file(1) magic for pure-compression formats (no archives)
#
# compress, gzip, pack, compact, huf, squeeze, crunch, freeze, yabba, whap, etc.
#
# Formats for various forms of compressed data
# Formats for "compress" proper have been moved into "compress.c",
# because it tries to uncompress it to figure out what's inside.
# standard unix compress
0 string \037\235 application/octet-stream x-compress
# gzip (GNU zip, not to be confused with [Info-ZIP/PKWARE] zip archiver)
0 string \037\213 application/octet-stream x-gzip
# According to gzip.h, this is the correct byte order for packed data.
0 string \037\036 application/octet-stream
#
# This magic number is byte-order-independent.
#
0 short 017437 application/octet-stream
# XXX - why *two* entries for "compacted data", one of which is
# byte-order independent, and one of which is byte-order dependent?
#
# compacted data
0 short 0x1fff application/octet-stream
0 string \377\037 application/octet-stream
# huf output
0 short 0145405 application/octet-stream
# Squeeze and Crunch...
# These numbers were gleaned from the Unix versions of the programs to
# handle these formats. Note that I can only uncrunch, not crunch, and
# I didn't have a crunched file handy, so the crunch number is untested.
# Keith Waclena <keith@cerberus.uchicago.edu>
#0 leshort 0x76FF squeezed data (CP/M, DOS)
#0 leshort 0x76FE crunched data (CP/M, DOS)
# Freeze
#0 string \037\237 Frozen file 2.1
#0 string \037\236 Frozen file 1.0 (or gzip 0.5)
# lzh?
#0 string \037\240 LZH compressed data
#------------------------------------------------------------------------------
# frame: file(1) magic for FrameMaker files
#
# This stuff came on a FrameMaker demo tape, most of which is
# copyright, but this file is "published" as witness the following:
#
0 string \<MakerFile application/x-frame
0 string \<MIFFile application/x-frame
0 string \<MakerDictionary application/x-frame
0 string \<MakerScreenFon application/x-frame
0 string \<MML application/x-frame
0 string \<Book application/x-frame
0 string \<Maker application/x-frame
#------------------------------------------------------------------------------
# html: file(1) magic for HTML (HyperText Markup Language) docs
#
# from Daniel Quinlan <quinlan@yggdrasil.com>
# and Anna Shergold <anna@inext.co.uk>
#
0 string \<!DOCTYPE\ HTML text/html
0 string \<!doctype\ html text/html
0 string \<HEAD text/html
0 string \<head text/html
0 string \<TITLE text/html
0 string \<title text/html
0 string \<html text/html
0 string \<HTML text/html
0 string \<!-- text/html
0 string \<h1 text/html
0 string \<H1 text/html
# XML eXtensible Markup Language, from Linus Walleij <triad@df.lth.se>
0 string \<?xml text/xml
#------------------------------------------------------------------------------
# images: file(1) magic for image formats (see also "c-lang" for XPM bitmaps)
#
# originally from jef@helios.ee.lbl.gov (Jef Poskanzer),
# additions by janl@ifi.uio.no as well as others. Jan also suggested
# merging several one- and two-line files into here.
#
# XXX - byte order for GIF and TIFF fields?
# [GRR: TIFF allows both byte orders; GIF is probably little-endian]
#
# [GRR: what the hell is this doing in here?]
#0 string xbtoa btoa'd file
# PBMPLUS
# PBM file
0 string P1 image/x-portable-bitmap 7bit
# PGM file
0 string P2 image/x-portable-greymap 7bit
# PPM file
0 string P3 image/x-portable-pixmap 7bit
# PBM "rawbits" file
0 string P4 image/x-portable-bitmap
# PGM "rawbits" file
0 string P5 image/x-portable-greymap
# PPM "rawbits" file
0 string P6 image/x-portable-pixmap
# NIFF (Navy Interchange File Format, a modification of TIFF)
# [GRR: this *must* go before TIFF]
0 string IIN1 image/x-niff
# TIFF and friends
# TIFF file, big-endian
0 string MM image/tiff
# TIFF file, little-endian
0 string II image/tiff
# possible GIF replacements; none yet released!
# (Greg Roelofs, newt@uchicago.edu)
#
# GRR 950115: this was mine ("Zip GIF"):
# ZIF image (GIF+deflate alpha)
0 string GIF94z image/unknown
#
# GRR 950115: this is Jeremy Wohl's Free Graphics Format (better):
# FGF image (GIF+deflate beta)
0 string FGF95a image/unknown
#
# GRR 950115: this is Thomas Boutell's Portable Bitmap Format proposal
# (best; not yet implemented):
# PBF image (deflate compression)
0 string PBF image/unknown
# GIF
0 string GIF image/gif
# JPEG images
0 beshort 0xffd8 image/jpeg
# PC bitmaps (OS/2, Windoze BMP files) (Greg Roelofs, newt@uchicago.edu)
0 string BM image/bmp
#>14 byte 12 (OS/2 1.x format)
#>14 byte 64 (OS/2 2.x format)
#>14 byte 40 (Windows 3.x format)
#0 string IC icon
#0 string PI pointer
#0 string CI color icon
#0 string CP color pointer
#0 string BA bitmap array
0 string \x89PNG image/png
0 string FWS application/x-shockwave-flash
0 string CWS application/x-shockwave-flash
#------------------------------------------------------------------------------
# lisp: file(1) magic for lisp programs
#
# various lisp types, from Daniel Quinlan (quinlan@yggdrasil.com)
0 string ;; text/plain 8bit
# Emacs 18 - this is always correct, but not very magical.
0 string \012( application/x-elc
# Emacs 19
0 string ;ELC\023\000\000\000 application/x-elc
#------------------------------------------------------------------------------
# mail.news: file(1) magic for mail and news
#
# There are tests to ascmagic.c to cope with mail and news.
0 string Relay-Version: message/rfc822 7bit
0 string #!\ rnews message/rfc822 7bit
0 string N#!\ rnews message/rfc822 7bit
0 string Forward\ to message/rfc822 7bit
0 string Pipe\ to message/rfc822 7bit
0 string Return-Path: message/rfc822 7bit
0 string Path: message/news 8bit
0 string Xref: message/news 8bit
0 string From: message/rfc822 7bit
0 string Article message/news 8bit
#------------------------------------------------------------------------------
# msword: file(1) magic for MS Word files
#
# Contributor claims:
# Reversed-engineered MS Word magic numbers
#
0 string \376\067\0\043 application/msword
0 string \333\245-\0\0\0 application/msword
# disable this one because it applies also to other
# Office/OLE documents for which msword is not correct. See PR#2608.
#0 string \320\317\021\340\241\261 application/msword
#------------------------------------------------------------------------------
# printer: file(1) magic for printer-formatted files
#
# PostScript
0 string %! application/postscript
0 string \004%! application/postscript
# Acrobat
# (due to clamen@cs.cmu.edu)
0 string %PDF- application/pdf
#------------------------------------------------------------------------------
# sc: file(1) magic for "sc" spreadsheet
#
38 string Spreadsheet application/x-sc
#------------------------------------------------------------------------------
# tex: file(1) magic for TeX files
#
# XXX - needs byte-endian stuff (big-endian and little-endian DVI?)
#
# From <conklin@talisman.kaleida.com>
# Although we may know the offset of certain text fields in TeX DVI
# and font files, we can't use them reliably because they are not
# zero terminated. [but we do anyway, christos]
0 string \367\002 application/x-dvi
#0 string \367\203 TeX generic font data
#0 string \367\131 TeX packed font data
#0 string \367\312 TeX virtual font data
#0 string This\ is\ TeX, TeX transcript text
#0 string This\ is\ METAFONT, METAFONT transcript text
# There is no way to detect TeX Font Metric (*.tfm) files without
# breaking them apart and reading the data. The following patterns
# match most *.tfm files generated by METAFONT or afm2tfm.
#2 string \000\021 TeX font metric data
#2 string \000\022 TeX font metric data
#>34 string >\0 (%s)
# Texinfo and GNU Info, from Daniel Quinlan (quinlan@yggdrasil.com)
#0 string \\input\ texinfo Texinfo source text
#0 string This\ is\ Info\ file GNU Info text
# correct TeX magic for Linux (and maybe more)
# from Peter Tobias (tobias@server.et-inf.fho-emden.de)
#
0 leshort 0x02f7 application/x-dvi
# RTF - Rich Text Format
0 string {\\rtf application/rtf
#------------------------------------------------------------------------------
# animation: file(1) magic for animation/movie formats
#
# animation formats, originally from vax@ccwf.cc.utexas.edu (VaX#n8)
# MPEG file
0 string \000\000\001\263 video/mpeg
#
# The contributor claims:
# I couldn't find a real magic number for these, however, this
# -appears- to work. Note that it might catch other files, too,
# so BE CAREFUL!
#
# Note that title and author appear in the two 20-byte chunks
# at decimal offsets 2 and 22, respectively, but they are XOR'ed with
# 255 (hex FF)! DL format SUCKS BIG ROCKS.
#
# DL file version 1 , medium format (160x100, 4 images/screen)
0 byte 1 video/unknown
0 byte 2 video/unknown
# Quicktime video, from Linus Walleij <triad@df.lth.se>
# from Apple quicktime file format documentation.
4 string moov video/quicktime
4 string mdat video/quicktime
httpd-2.4.64/docs/conf/mime.types 0000664 0001751 0001751 00000167052 14743443462 016542 0 ustar covener covener # This file maps Internet media types to unique file extension(s).
# Although created for httpd, this file is used by many software systems
# and has been placed in the public domain for unlimited redistribution.
#
# The table below contains both registered and (common) unregistered types.
# A type that has no unique extension can be ignored -- they are listed
# here to guide configurations toward known types and to make it easier to
# identify "new" types. File extensions are also commonly used to indicate
# content languages and encodings, so choose them carefully.
#
# Internet media types should be registered as described in RFC 4288.
# The registry is at <http://www.iana.org/assignments/media-types/>.
#
# MIME type (lowercased) Extensions
# ============================================ ==========
# application/1d-interleaved-parityfec
# application/3gpdash-qoe-report+xml
# application/3gpp-ims+xml
# application/a2l
# application/activemessage
# application/alto-costmap+json
# application/alto-costmapfilter+json
# application/alto-directory+json
# application/alto-endpointcost+json
# application/alto-endpointcostparams+json
# application/alto-endpointprop+json
# application/alto-endpointpropparams+json
# application/alto-error+json
# application/alto-networkmap+json
# application/alto-networkmapfilter+json
# application/aml
application/andrew-inset ez
# application/applefile
application/applixware aw
# application/atf
# application/atfx
application/atom+xml atom
application/atomcat+xml atomcat
# application/atomdeleted+xml
# application/atomicmail
application/atomsvc+xml atomsvc
# application/atxml
# application/auth-policy+xml
# application/bacnet-xdd+zip
# application/batch-smtp
# application/beep+xml
# application/calendar+json
# application/calendar+xml
# application/call-completion
# application/cals-1840
# application/cbor
# application/ccmp+xml
application/ccxml+xml ccxml
# application/cdfx+xml
application/cdmi-capability cdmia
application/cdmi-container cdmic
application/cdmi-domain cdmid
application/cdmi-object cdmio
application/cdmi-queue cdmiq
# application/cdni
# application/cea
# application/cea-2018+xml
# application/cellml+xml
# application/cfw
# application/cms
# application/cnrp+xml
# application/coap-group+json
# application/commonground
# application/conference-info+xml
# application/cpl+xml
# application/csrattrs
# application/csta+xml
# application/cstadata+xml
# application/csvm+json
application/cu-seeme cu
# application/cybercash
# application/dash+xml
# application/dashdelta
application/davmount+xml davmount
# application/dca-rft
# application/dcd
# application/dec-dx
# application/dialog-info+xml
# application/dicom
# application/dii
# application/dit
# application/dns
application/docbook+xml dbk
# application/dskpp+xml
application/dssc+der dssc
application/dssc+xml xdssc
# application/dvcs
application/ecmascript ecma
# application/edi-consent
# application/edi-x12
# application/edifact
# application/efi
# application/emergencycalldata.comment+xml
# application/emergencycalldata.deviceinfo+xml
# application/emergencycalldata.providerinfo+xml
# application/emergencycalldata.serviceinfo+xml
# application/emergencycalldata.subscriberinfo+xml
application/emma+xml emma
# application/emotionml+xml
# application/encaprtp
# application/epp+xml
application/epub+zip epub
# application/eshop
# application/example
application/exi exi
# application/fastinfoset
# application/fastsoap
# application/fdt+xml
# application/fits
application/font-tdpfr pfr
# application/framework-attributes+xml
# application/geo+json
application/gml+xml gml
application/gpx+xml gpx
application/gxf gxf
# application/gzip
# application/h224
# application/held+xml
# application/http
application/hyperstudio stk
# application/ibe-key-request+xml
# application/ibe-pkg-reply+xml
# application/ibe-pp-data
# application/iges
# application/im-iscomposing+xml
# application/index
# application/index.cmd
# application/index.obj
# application/index.response
# application/index.vnd
application/inkml+xml ink inkml
# application/iotp
application/ipfix ipfix
# application/ipp
# application/isup
# application/its+xml
application/java-archive jar
application/java-serialized-object ser
application/java-vm class
# application/javascript
# application/jose
# application/jose+json
# application/jrd+json
application/json json
# application/json-patch+json
# application/json-seq
application/jsonml+json jsonml
# application/jwk+json
# application/jwk-set+json
# application/jwt
# application/kpml-request+xml
# application/kpml-response+xml
# application/ld+json
# application/lgr+xml
# application/link-format
# application/load-control+xml
application/lost+xml lostxml
# application/lostsync+xml
# application/lxf
application/mac-binhex40 hqx
application/mac-compactpro cpt
# application/macwriteii
application/mads+xml mads
application/marc mrc
application/marcxml+xml mrcx
application/mathematica ma nb mb
application/mathml+xml mathml
# application/mathml-content+xml
# application/mathml-presentation+xml
# application/mbms-associated-procedure-description+xml
# application/mbms-deregister+xml
# application/mbms-envelope+xml
# application/mbms-msk+xml
# application/mbms-msk-response+xml
# application/mbms-protection-description+xml
# application/mbms-reception-report+xml
# application/mbms-register+xml
# application/mbms-register-response+xml
# application/mbms-schedule+xml
# application/mbms-user-service-description+xml
application/mbox mbox
# application/media-policy-dataset+xml
# application/media_control+xml
application/mediaservercontrol+xml mscml
# application/merge-patch+json
application/metalink+xml metalink
application/metalink4+xml meta4
application/mets+xml mets
# application/mf4
# application/mikey
application/mods+xml mods
# application/moss-keys
# application/moss-signature
# application/mosskey-data
# application/mosskey-request
application/mp21 m21 mp21
application/mp4 mp4s
# application/mpeg4-generic
# application/mpeg4-iod
# application/mpeg4-iod-xmt
# application/mrb-consumer+xml
# application/mrb-publish+xml
# application/msc-ivr+xml
# application/msc-mixer+xml
application/msword doc dot
application/mxf mxf
# application/nasdata
# application/news-checkgroups
# application/news-groupinfo
# application/news-transmission
# application/nlsml+xml
# application/nss
# application/ocsp-request
# application/ocsp-response
application/octet-stream bin dms lrf mar so dist distz pkg bpk dump elc deploy
application/oda oda
# application/odx
application/oebps-package+xml opf
application/ogg ogx
application/omdoc+xml omdoc
application/onenote onetoc onetoc2 onetmp onepkg
application/oxps oxps
# application/p2p-overlay+xml
# application/parityfec
application/patch-ops-error+xml xer
application/pdf pdf
# application/pdx
application/pgp-encrypted pgp
# application/pgp-keys
application/pgp-signature asc sig
application/pics-rules prf
# application/pidf+xml
# application/pidf-diff+xml
application/pkcs10 p10
# application/pkcs12
application/pkcs7-mime p7m p7c
application/pkcs7-signature p7s
application/pkcs8 p8
application/pkix-attr-cert ac
application/pkix-cert cer
application/pkix-crl crl
application/pkix-pkipath pkipath
application/pkixcmp pki
application/pls+xml pls
# application/poc-settings+xml
application/postscript ai eps ps
# application/ppsp-tracker+json
# application/problem+json
# application/problem+xml
# application/provenance+xml
# application/prs.alvestrand.titrax-sheet
application/prs.cww cww
# application/prs.hpub+zip
# application/prs.nprend
# application/prs.plucker
# application/prs.rdf-xml-crypt
# application/prs.xsf+xml
application/pskc+xml pskcxml
# application/qsig
# application/raptorfec
# application/rdap+json
application/rdf+xml rdf
application/reginfo+xml rif
application/relax-ng-compact-syntax rnc
# application/remote-printing
# application/reputon+json
application/resource-lists+xml rl
application/resource-lists-diff+xml rld
# application/rfc+xml
# application/riscos
# application/rlmi+xml
application/rls-services+xml rs
application/rpki-ghostbusters gbr
application/rpki-manifest mft
application/rpki-roa roa
# application/rpki-updown
application/rsd+xml rsd
application/rss+xml rss
application/rtf rtf
# application/rtploopback
# application/rtx
# application/samlassertion+xml
# application/samlmetadata+xml
application/sbml+xml sbml
# application/scaip+xml
# application/scim+json
application/scvp-cv-request scq
application/scvp-cv-response scs
application/scvp-vp-request spq
application/scvp-vp-response spp
application/sdp sdp
# application/sep+xml
# application/sep-exi
# application/session-info
# application/set-payment
application/set-payment-initiation setpay
# application/set-registration
application/set-registration-initiation setreg
# application/sgml
# application/sgml-open-catalog
application/shf+xml shf
# application/sieve
# application/simple-filter+xml
# application/simple-message-summary
# application/simplesymbolcontainer
# application/slate
# application/smil
application/smil+xml smi smil
# application/smpte336m
# application/soap+fastinfoset
# application/soap+xml
application/sparql-query rq
application/sparql-results+xml srx
# application/spirits-event+xml
# application/sql
application/srgs gram
application/srgs+xml grxml
application/sru+xml sru
application/ssdl+xml ssdl
application/ssml+xml ssml
# application/tamp-apex-update
# application/tamp-apex-update-confirm
# application/tamp-community-update
# application/tamp-community-update-confirm
# application/tamp-error
# application/tamp-sequence-adjust
# application/tamp-sequence-adjust-confirm
# application/tamp-status-query
# application/tamp-status-response
# application/tamp-update
# application/tamp-update-confirm
application/tei+xml tei teicorpus
application/thraud+xml tfi
# application/timestamp-query
# application/timestamp-reply
application/timestamped-data tsd
# application/ttml+xml
# application/tve-trigger
# application/ulpfec
# application/urc-grpsheet+xml
# application/urc-ressheet+xml
# application/urc-targetdesc+xml
# application/urc-uisocketdesc+xml
# application/vcard+json
# application/vcard+xml
# application/vemmi
# application/vividence.scriptfile
# application/vnd.3gpp-prose+xml
# application/vnd.3gpp-prose-pc3ch+xml
# application/vnd.3gpp.access-transfer-events+xml
# application/vnd.3gpp.bsf+xml
# application/vnd.3gpp.mid-call+xml
application/vnd.3gpp.pic-bw-large plb
application/vnd.3gpp.pic-bw-small psb
application/vnd.3gpp.pic-bw-var pvb
# application/vnd.3gpp.sms
# application/vnd.3gpp.sms+xml
# application/vnd.3gpp.srvcc-ext+xml
# application/vnd.3gpp.srvcc-info+xml
# application/vnd.3gpp.state-and-event-info+xml
# application/vnd.3gpp.ussd+xml
# application/vnd.3gpp2.bcmcsinfo+xml
# application/vnd.3gpp2.sms
application/vnd.3gpp2.tcap tcap
# application/vnd.3lightssoftware.imagescal
application/vnd.3m.post-it-notes pwn
application/vnd.accpac.simply.aso aso
application/vnd.accpac.simply.imp imp
application/vnd.acucobol acu
application/vnd.acucorp atc acutc
application/vnd.adobe.air-application-installer-package+zip air
# application/vnd.adobe.flash.movie
application/vnd.adobe.formscentral.fcdt fcdt
application/vnd.adobe.fxp fxp fxpl
# application/vnd.adobe.partial-upload
application/vnd.adobe.xdp+xml xdp
application/vnd.adobe.xfdf xfdf
# application/vnd.aether.imp
# application/vnd.ah-barcode
application/vnd.ahead.space ahead
application/vnd.airzip.filesecure.azf azf
application/vnd.airzip.filesecure.azs azs
application/vnd.amazon.ebook azw
# application/vnd.amazon.mobi8-ebook
application/vnd.americandynamics.acc acc
application/vnd.amiga.ami ami
# application/vnd.amundsen.maze+xml
application/vnd.android.package-archive apk
# application/vnd.anki
application/vnd.anser-web-certificate-issue-initiation cii
application/vnd.anser-web-funds-transfer-initiation fti
application/vnd.antix.game-component atx
# application/vnd.apache.thrift.binary
# application/vnd.apache.thrift.compact
# application/vnd.apache.thrift.json
# application/vnd.api+json
application/vnd.apple.installer+xml mpkg
application/vnd.apple.mpegurl m3u8
# application/vnd.arastra.swi
application/vnd.aristanetworks.swi swi
# application/vnd.artsquare
application/vnd.astraea-software.iota iota
application/vnd.audiograph aep
# application/vnd.autopackage
# application/vnd.avistar+xml
# application/vnd.balsamiq.bmml+xml
# application/vnd.balsamiq.bmpr
# application/vnd.bekitzur-stech+json
# application/vnd.biopax.rdf+xml
application/vnd.blueice.multipass mpm
# application/vnd.bluetooth.ep.oob
# application/vnd.bluetooth.le.oob
application/vnd.bmi bmi
application/vnd.businessobjects rep
# application/vnd.cab-jscript
# application/vnd.canon-cpdl
# application/vnd.canon-lips
# application/vnd.cendio.thinlinc.clientconf
# application/vnd.century-systems.tcp_stream
application/vnd.chemdraw+xml cdxml
# application/vnd.chess-pgn
application/vnd.chipnuts.karaoke-mmd mmd
application/vnd.cinderella cdy
# application/vnd.cirpack.isdn-ext
# application/vnd.citationstyles.style+xml
application/vnd.claymore cla
application/vnd.cloanto.rp9 rp9
application/vnd.clonk.c4group c4g c4d c4f c4p c4u
application/vnd.cluetrust.cartomobile-config c11amc
application/vnd.cluetrust.cartomobile-config-pkg c11amz
# application/vnd.coffeescript
# application/vnd.collection+json
# application/vnd.collection.doc+json
# application/vnd.collection.next+json
# application/vnd.comicbook+zip
# application/vnd.commerce-battelle
application/vnd.commonspace csp
application/vnd.contact.cmsg cdbcmsg
# application/vnd.coreos.ignition+json
application/vnd.cosmocaller cmc
application/vnd.crick.clicker clkx
application/vnd.crick.clicker.keyboard clkk
application/vnd.crick.clicker.palette clkp
application/vnd.crick.clicker.template clkt
application/vnd.crick.clicker.wordbank clkw
application/vnd.criticaltools.wbs+xml wbs
application/vnd.ctc-posml pml
# application/vnd.ctct.ws+xml
# application/vnd.cups-pdf
# application/vnd.cups-postscript
application/vnd.cups-ppd ppd
# application/vnd.cups-raster
# application/vnd.cups-raw
# application/vnd.curl
application/vnd.curl.car car
application/vnd.curl.pcurl pcurl
# application/vnd.cyan.dean.root+xml
# application/vnd.cybank
application/vnd.dart dart
application/vnd.data-vision.rdz rdz
# application/vnd.debian.binary-package
application/vnd.dece.data uvf uvvf uvd uvvd
application/vnd.dece.ttml+xml uvt uvvt
application/vnd.dece.unspecified uvx uvvx
application/vnd.dece.zip uvz uvvz
application/vnd.denovo.fcselayout-link fe_launch
# application/vnd.desmume.movie
# application/vnd.dir-bi.plate-dl-nosuffix
# application/vnd.dm.delegation+xml
application/vnd.dna dna
# application/vnd.document+json
application/vnd.dolby.mlp mlp
# application/vnd.dolby.mobile.1
# application/vnd.dolby.mobile.2
# application/vnd.doremir.scorecloud-binary-document
application/vnd.dpgraph dpg
application/vnd.dreamfactory dfac
# application/vnd.drive+json
application/vnd.ds-keypoint kpxx
# application/vnd.dtg.local
# application/vnd.dtg.local.flash
# application/vnd.dtg.local.html
application/vnd.dvb.ait ait
# application/vnd.dvb.dvbj
# application/vnd.dvb.esgcontainer
# application/vnd.dvb.ipdcdftnotifaccess
# application/vnd.dvb.ipdcesgaccess
# application/vnd.dvb.ipdcesgaccess2
# application/vnd.dvb.ipdcesgpdd
# application/vnd.dvb.ipdcroaming
# application/vnd.dvb.iptv.alfec-base
# application/vnd.dvb.iptv.alfec-enhancement
# application/vnd.dvb.notif-aggregate-root+xml
# application/vnd.dvb.notif-container+xml
# application/vnd.dvb.notif-generic+xml
# application/vnd.dvb.notif-ia-msglist+xml
# application/vnd.dvb.notif-ia-registration-request+xml
# application/vnd.dvb.notif-ia-registration-response+xml
# application/vnd.dvb.notif-init+xml
# application/vnd.dvb.pfr
application/vnd.dvb.service svc
# application/vnd.dxr
application/vnd.dynageo geo
# application/vnd.dzr
# application/vnd.easykaraoke.cdgdownload
# application/vnd.ecdis-update
application/vnd.ecowin.chart mag
# application/vnd.ecowin.filerequest
# application/vnd.ecowin.fileupdate
# application/vnd.ecowin.series
# application/vnd.ecowin.seriesrequest
# application/vnd.ecowin.seriesupdate
# application/vnd.emclient.accessrequest+xml
application/vnd.enliven nml
# application/vnd.enphase.envoy
# application/vnd.eprints.data+xml
application/vnd.epson.esf esf
application/vnd.epson.msf msf
application/vnd.epson.quickanime qam
application/vnd.epson.salt slt
application/vnd.epson.ssf ssf
# application/vnd.ericsson.quickcall
application/vnd.eszigno3+xml es3 et3
# application/vnd.etsi.aoc+xml
# application/vnd.etsi.asic-e+zip
# application/vnd.etsi.asic-s+zip
# application/vnd.etsi.cug+xml
# application/vnd.etsi.iptvcommand+xml
# application/vnd.etsi.iptvdiscovery+xml
# application/vnd.etsi.iptvprofile+xml
# application/vnd.etsi.iptvsad-bc+xml
# application/vnd.etsi.iptvsad-cod+xml
# application/vnd.etsi.iptvsad-npvr+xml
# application/vnd.etsi.iptvservice+xml
# application/vnd.etsi.iptvsync+xml
# application/vnd.etsi.iptvueprofile+xml
# application/vnd.etsi.mcid+xml
# application/vnd.etsi.mheg5
# application/vnd.etsi.overload-control-policy-dataset+xml
# application/vnd.etsi.pstn+xml
# application/vnd.etsi.sci+xml
# application/vnd.etsi.simservs+xml
# application/vnd.etsi.timestamp-token
# application/vnd.etsi.tsl+xml
# application/vnd.etsi.tsl.der
# application/vnd.eudora.data
application/vnd.ezpix-album ez2
application/vnd.ezpix-package ez3
# application/vnd.f-secure.mobile
# application/vnd.fastcopy-disk-image
application/vnd.fdf fdf
application/vnd.fdsn.mseed mseed
application/vnd.fdsn.seed seed dataless
# application/vnd.ffsns
# application/vnd.filmit.zfc
# application/vnd.fints
# application/vnd.firemonkeys.cloudcell
application/vnd.flographit gph
application/vnd.fluxtime.clip ftc
# application/vnd.font-fontforge-sfd
application/vnd.framemaker fm frame maker book
application/vnd.frogans.fnc fnc
application/vnd.frogans.ltf ltf
application/vnd.fsc.weblaunch fsc
application/vnd.fujitsu.oasys oas
application/vnd.fujitsu.oasys2 oa2
application/vnd.fujitsu.oasys3 oa3
application/vnd.fujitsu.oasysgp fg5
application/vnd.fujitsu.oasysprs bh2
# application/vnd.fujixerox.art-ex
# application/vnd.fujixerox.art4
application/vnd.fujixerox.ddd ddd
application/vnd.fujixerox.docuworks xdw
application/vnd.fujixerox.docuworks.binder xbd
# application/vnd.fujixerox.docuworks.container
# application/vnd.fujixerox.hbpl
# application/vnd.fut-misnet
application/vnd.fuzzysheet fzs
application/vnd.genomatix.tuxedo txd
# application/vnd.geo+json
# application/vnd.geocube+xml
application/vnd.geogebra.file ggb
application/vnd.geogebra.slides ggs
application/vnd.geogebra.tool ggt
application/vnd.geometry-explorer gex gre
application/vnd.geonext gxt
application/vnd.geoplan g2w
application/vnd.geospace g3w
# application/vnd.gerber
# application/vnd.globalplatform.card-content-mgt
# application/vnd.globalplatform.card-content-mgt-response
application/vnd.gmx gmx
application/vnd.google-earth.kml+xml kml
application/vnd.google-earth.kmz kmz
# application/vnd.gov.sk.e-form+xml
# application/vnd.gov.sk.e-form+zip
# application/vnd.gov.sk.xmldatacontainer+xml
application/vnd.grafeq gqf gqs
# application/vnd.gridmp
application/vnd.groove-account gac
application/vnd.groove-help ghf
application/vnd.groove-identity-message gim
application/vnd.groove-injector grv
application/vnd.groove-tool-message gtm
application/vnd.groove-tool-template tpl
application/vnd.groove-vcard vcg
# application/vnd.hal+json
application/vnd.hal+xml hal
application/vnd.handheld-entertainment+xml zmm
application/vnd.hbci hbci
# application/vnd.hcl-bireports
# application/vnd.hdt
# application/vnd.heroku+json
application/vnd.hhe.lesson-player les
application/vnd.hp-hpgl hpgl
application/vnd.hp-hpid hpid
application/vnd.hp-hps hps
application/vnd.hp-jlyt jlt
application/vnd.hp-pcl pcl
application/vnd.hp-pclxl pclxl
# application/vnd.httphone
application/vnd.hydrostatix.sof-data sfd-hdstx
# application/vnd.hyperdrive+json
# application/vnd.hzn-3d-crossword
# application/vnd.ibm.afplinedata
# application/vnd.ibm.electronic-media
application/vnd.ibm.minipay mpy
application/vnd.ibm.modcap afp listafp list3820
application/vnd.ibm.rights-management irm
application/vnd.ibm.secure-container sc
application/vnd.iccprofile icc icm
# application/vnd.ieee.1905
application/vnd.igloader igl
application/vnd.immervision-ivp ivp
application/vnd.immervision-ivu ivu
# application/vnd.ims.imsccv1p1
# application/vnd.ims.imsccv1p2
# application/vnd.ims.imsccv1p3
# application/vnd.ims.lis.v2.result+json
# application/vnd.ims.lti.v2.toolconsumerprofile+json
# application/vnd.ims.lti.v2.toolproxy+json
# application/vnd.ims.lti.v2.toolproxy.id+json
# application/vnd.ims.lti.v2.toolsettings+json
# application/vnd.ims.lti.v2.toolsettings.simple+json
# application/vnd.informedcontrol.rms+xml
# application/vnd.informix-visionary
# application/vnd.infotech.project
# application/vnd.infotech.project+xml
# application/vnd.innopath.wamp.notification
application/vnd.insors.igm igm
application/vnd.intercon.formnet xpw xpx
application/vnd.intergeo i2g
# application/vnd.intertrust.digibox
# application/vnd.intertrust.nncp
application/vnd.intu.qbo qbo
application/vnd.intu.qfx qfx
# application/vnd.iptc.g2.catalogitem+xml
# application/vnd.iptc.g2.conceptitem+xml
# application/vnd.iptc.g2.knowledgeitem+xml
# application/vnd.iptc.g2.newsitem+xml
# application/vnd.iptc.g2.newsmessage+xml
# application/vnd.iptc.g2.packageitem+xml
# application/vnd.iptc.g2.planningitem+xml
application/vnd.ipunplugged.rcprofile rcprofile
application/vnd.irepository.package+xml irp
application/vnd.is-xpr xpr
application/vnd.isac.fcs fcs
application/vnd.jam jam
# application/vnd.japannet-directory-service
# application/vnd.japannet-jpnstore-wakeup
# application/vnd.japannet-payment-wakeup
# application/vnd.japannet-registration
# application/vnd.japannet-registration-wakeup
# application/vnd.japannet-setstore-wakeup
# application/vnd.japannet-verification
# application/vnd.japannet-verification-wakeup
application/vnd.jcp.javame.midlet-rms rms
application/vnd.jisp jisp
application/vnd.joost.joda-archive joda
# application/vnd.jsk.isdn-ngn
application/vnd.kahootz ktz ktr
application/vnd.kde.karbon karbon
application/vnd.kde.kchart chrt
application/vnd.kde.kformula kfo
application/vnd.kde.kivio flw
application/vnd.kde.kontour kon
application/vnd.kde.kpresenter kpr kpt
application/vnd.kde.kspread ksp
application/vnd.kde.kword kwd kwt
application/vnd.kenameaapp htke
application/vnd.kidspiration kia
application/vnd.kinar kne knp
application/vnd.koan skp skd skt skm
application/vnd.kodak-descriptor sse
application/vnd.las.las+xml lasxml
# application/vnd.liberty-request+xml
application/vnd.llamagraphics.life-balance.desktop lbd
application/vnd.llamagraphics.life-balance.exchange+xml lbe
application/vnd.lotus-1-2-3 123
application/vnd.lotus-approach apr
application/vnd.lotus-freelance pre
application/vnd.lotus-notes nsf
application/vnd.lotus-organizer org
application/vnd.lotus-screencam scm
application/vnd.lotus-wordpro lwp
application/vnd.macports.portpkg portpkg
# application/vnd.mapbox-vector-tile
# application/vnd.marlin.drm.actiontoken+xml
# application/vnd.marlin.drm.conftoken+xml
# application/vnd.marlin.drm.license+xml
# application/vnd.marlin.drm.mdcf
# application/vnd.mason+json
# application/vnd.maxmind.maxmind-db
application/vnd.mcd mcd
application/vnd.medcalcdata mc1
application/vnd.mediastation.cdkey cdkey
# application/vnd.meridian-slingshot
application/vnd.mfer mwf
application/vnd.mfmp mfm
# application/vnd.micro+json
application/vnd.micrografx.flo flo
application/vnd.micrografx.igx igx
# application/vnd.microsoft.portable-executable
# application/vnd.miele+json
application/vnd.mif mif
# application/vnd.minisoft-hp3000-save
# application/vnd.mitsubishi.misty-guard.trustweb
application/vnd.mobius.daf daf
application/vnd.mobius.dis dis
application/vnd.mobius.mbk mbk
application/vnd.mobius.mqy mqy
application/vnd.mobius.msl msl
application/vnd.mobius.plc plc
application/vnd.mobius.txf txf
application/vnd.mophun.application mpn
application/vnd.mophun.certificate mpc
# application/vnd.motorola.flexsuite
# application/vnd.motorola.flexsuite.adsi
# application/vnd.motorola.flexsuite.fis
# application/vnd.motorola.flexsuite.gotap
# application/vnd.motorola.flexsuite.kmr
# application/vnd.motorola.flexsuite.ttc
# application/vnd.motorola.flexsuite.wem
# application/vnd.motorola.iprm
application/vnd.mozilla.xul+xml xul
# application/vnd.ms-3mfdocument
application/vnd.ms-artgalry cil
# application/vnd.ms-asf
application/vnd.ms-cab-compressed cab
# application/vnd.ms-color.iccprofile
application/vnd.ms-excel xls xlm xla xlc xlt xlw
application/vnd.ms-excel.addin.macroenabled.12 xlam
application/vnd.ms-excel.sheet.binary.macroenabled.12 xlsb
application/vnd.ms-excel.sheet.macroenabled.12 xlsm
application/vnd.ms-excel.template.macroenabled.12 xltm
application/vnd.ms-fontobject eot
application/vnd.ms-htmlhelp chm
application/vnd.ms-ims ims
application/vnd.ms-lrm lrm
# application/vnd.ms-office.activex+xml
application/vnd.ms-officetheme thmx
# application/vnd.ms-opentype
# application/vnd.ms-package.obfuscated-opentype
application/vnd.ms-pki.seccat cat
application/vnd.ms-pki.stl stl
# application/vnd.ms-playready.initiator+xml
application/vnd.ms-powerpoint ppt pps pot
application/vnd.ms-powerpoint.addin.macroenabled.12 ppam
application/vnd.ms-powerpoint.presentation.macroenabled.12 pptm
application/vnd.ms-powerpoint.slide.macroenabled.12 sldm
application/vnd.ms-powerpoint.slideshow.macroenabled.12 ppsm
application/vnd.ms-powerpoint.template.macroenabled.12 potm
# application/vnd.ms-printdevicecapabilities+xml
# application/vnd.ms-printing.printticket+xml
# application/vnd.ms-printschematicket+xml
application/vnd.ms-project mpp mpt
# application/vnd.ms-tnef
# application/vnd.ms-windows.devicepairing
# application/vnd.ms-windows.nwprinting.oob
# application/vnd.ms-windows.printerpairing
# application/vnd.ms-windows.wsd.oob
# application/vnd.ms-wmdrm.lic-chlg-req
# application/vnd.ms-wmdrm.lic-resp
# application/vnd.ms-wmdrm.meter-chlg-req
# application/vnd.ms-wmdrm.meter-resp
application/vnd.ms-word.document.macroenabled.12 docm
application/vnd.ms-word.template.macroenabled.12 dotm
application/vnd.ms-works wps wks wcm wdb
application/vnd.ms-wpl wpl
application/vnd.ms-xpsdocument xps
# application/vnd.msa-disk-image
application/vnd.mseq mseq
# application/vnd.msign
# application/vnd.multiad.creator
# application/vnd.multiad.creator.cif
# application/vnd.music-niff
application/vnd.musician mus
application/vnd.muvee.style msty
application/vnd.mynfc taglet
# application/vnd.ncd.control
# application/vnd.ncd.reference
# application/vnd.nervana
# application/vnd.netfpx
application/vnd.neurolanguage.nlu nlu
# application/vnd.nintendo.nitro.rom
# application/vnd.nintendo.snes.rom
application/vnd.nitf ntf nitf
application/vnd.noblenet-directory nnd
application/vnd.noblenet-sealer nns
application/vnd.noblenet-web nnw
# application/vnd.nokia.catalogs
# application/vnd.nokia.conml+wbxml
# application/vnd.nokia.conml+xml
# application/vnd.nokia.iptv.config+xml
# application/vnd.nokia.isds-radio-presets
# application/vnd.nokia.landmark+wbxml
# application/vnd.nokia.landmark+xml
# application/vnd.nokia.landmarkcollection+xml
# application/vnd.nokia.n-gage.ac+xml
application/vnd.nokia.n-gage.data ngdat
application/vnd.nokia.n-gage.symbian.install n-gage
# application/vnd.nokia.ncd
# application/vnd.nokia.pcd+wbxml
# application/vnd.nokia.pcd+xml
application/vnd.nokia.radio-preset rpst
application/vnd.nokia.radio-presets rpss
application/vnd.novadigm.edm edm
application/vnd.novadigm.edx edx
application/vnd.novadigm.ext ext
# application/vnd.ntt-local.content-share
# application/vnd.ntt-local.file-transfer
# application/vnd.ntt-local.ogw_remote-access
# application/vnd.ntt-local.sip-ta_remote
# application/vnd.ntt-local.sip-ta_tcp_stream
application/vnd.oasis.opendocument.chart odc
application/vnd.oasis.opendocument.chart-template otc
application/vnd.oasis.opendocument.database odb
application/vnd.oasis.opendocument.formula odf
application/vnd.oasis.opendocument.formula-template odft
application/vnd.oasis.opendocument.graphics odg
application/vnd.oasis.opendocument.graphics-template otg
application/vnd.oasis.opendocument.image odi
application/vnd.oasis.opendocument.image-template oti
application/vnd.oasis.opendocument.presentation odp
application/vnd.oasis.opendocument.presentation-template otp
application/vnd.oasis.opendocument.spreadsheet ods
application/vnd.oasis.opendocument.spreadsheet-template ots
application/vnd.oasis.opendocument.text odt
application/vnd.oasis.opendocument.text-master odm
application/vnd.oasis.opendocument.text-template ott
application/vnd.oasis.opendocument.text-web oth
# application/vnd.obn
# application/vnd.oftn.l10n+json
# application/vnd.oipf.contentaccessdownload+xml
# application/vnd.oipf.contentaccessstreaming+xml
# application/vnd.oipf.cspg-hexbinary
# application/vnd.oipf.dae.svg+xml
# application/vnd.oipf.dae.xhtml+xml
# application/vnd.oipf.mippvcontrolmessage+xml
# application/vnd.oipf.pae.gem
# application/vnd.oipf.spdiscovery+xml
# application/vnd.oipf.spdlist+xml
# application/vnd.oipf.ueprofile+xml
# application/vnd.oipf.userprofile+xml
application/vnd.olpc-sugar xo
# application/vnd.oma-scws-config
# application/vnd.oma-scws-http-request
# application/vnd.oma-scws-http-response
# application/vnd.oma.bcast.associated-procedure-parameter+xml
# application/vnd.oma.bcast.drm-trigger+xml
# application/vnd.oma.bcast.imd+xml
# application/vnd.oma.bcast.ltkm
# application/vnd.oma.bcast.notification+xml
# application/vnd.oma.bcast.provisioningtrigger
# application/vnd.oma.bcast.sgboot
# application/vnd.oma.bcast.sgdd+xml
# application/vnd.oma.bcast.sgdu
# application/vnd.oma.bcast.simple-symbol-container
# application/vnd.oma.bcast.smartcard-trigger+xml
# application/vnd.oma.bcast.sprov+xml
# application/vnd.oma.bcast.stkm
# application/vnd.oma.cab-address-book+xml
# application/vnd.oma.cab-feature-handler+xml
# application/vnd.oma.cab-pcc+xml
# application/vnd.oma.cab-subs-invite+xml
# application/vnd.oma.cab-user-prefs+xml
# application/vnd.oma.dcd
# application/vnd.oma.dcdc
application/vnd.oma.dd2+xml dd2
# application/vnd.oma.drm.risd+xml
# application/vnd.oma.group-usage-list+xml
# application/vnd.oma.lwm2m+json
# application/vnd.oma.lwm2m+tlv
# application/vnd.oma.pal+xml
# application/vnd.oma.poc.detailed-progress-report+xml
# application/vnd.oma.poc.final-report+xml
# application/vnd.oma.poc.groups+xml
# application/vnd.oma.poc.invocation-descriptor+xml
# application/vnd.oma.poc.optimized-progress-report+xml
# application/vnd.oma.push
# application/vnd.oma.scidm.messages+xml
# application/vnd.oma.xcap-directory+xml
# application/vnd.omads-email+xml
# application/vnd.omads-file+xml
# application/vnd.omads-folder+xml
# application/vnd.omaloc-supl-init
# application/vnd.onepager
# application/vnd.openblox.game+xml
# application/vnd.openblox.game-binary
# application/vnd.openeye.oeb
application/vnd.openofficeorg.extension oxt
# application/vnd.openxmlformats-officedocument.custom-properties+xml
# application/vnd.openxmlformats-officedocument.customxmlproperties+xml
# application/vnd.openxmlformats-officedocument.drawing+xml
# application/vnd.openxmlformats-officedocument.drawingml.chart+xml
# application/vnd.openxmlformats-officedocument.drawingml.chartshapes+xml
# application/vnd.openxmlformats-officedocument.drawingml.diagramcolors+xml
# application/vnd.openxmlformats-officedocument.drawingml.diagramdata+xml
# application/vnd.openxmlformats-officedocument.drawingml.diagramlayout+xml
# application/vnd.openxmlformats-officedocument.drawingml.diagramstyle+xml
# application/vnd.openxmlformats-officedocument.extended-properties+xml
# application/vnd.openxmlformats-officedocument.presentationml.commentauthors+xml
# application/vnd.openxmlformats-officedocument.presentationml.comments+xml
# application/vnd.openxmlformats-officedocument.presentationml.handoutmaster+xml
# application/vnd.openxmlformats-officedocument.presentationml.notesmaster+xml
# application/vnd.openxmlformats-officedocument.presentationml.notesslide+xml
application/vnd.openxmlformats-officedocument.presentationml.presentation pptx
# application/vnd.openxmlformats-officedocument.presentationml.presentation.main+xml
# application/vnd.openxmlformats-officedocument.presentationml.presprops+xml
application/vnd.openxmlformats-officedocument.presentationml.slide sldx
# application/vnd.openxmlformats-officedocument.presentationml.slide+xml
# application/vnd.openxmlformats-officedocument.presentationml.slidelayout+xml
# application/vnd.openxmlformats-officedocument.presentationml.slidemaster+xml
application/vnd.openxmlformats-officedocument.presentationml.slideshow ppsx
# application/vnd.openxmlformats-officedocument.presentationml.slideshow.main+xml
# application/vnd.openxmlformats-officedocument.presentationml.slideupdateinfo+xml
# application/vnd.openxmlformats-officedocument.presentationml.tablestyles+xml
# application/vnd.openxmlformats-officedocument.presentationml.tags+xml
application/vnd.openxmlformats-officedocument.presentationml.template potx
# application/vnd.openxmlformats-officedocument.presentationml.template.main+xml
# application/vnd.openxmlformats-officedocument.presentationml.viewprops+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.calcchain+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.chartsheet+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.comments+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.connections+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.dialogsheet+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.externallink+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.pivotcachedefinition+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.pivotcacherecords+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.pivottable+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.querytable+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.revisionheaders+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.revisionlog+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.sharedstrings+xml
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet xlsx
# application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.sheetmetadata+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.table+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.tablesinglecells+xml
application/vnd.openxmlformats-officedocument.spreadsheetml.template xltx
# application/vnd.openxmlformats-officedocument.spreadsheetml.template.main+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.usernames+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.volatiledependencies+xml
# application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml
# application/vnd.openxmlformats-officedocument.theme+xml
# application/vnd.openxmlformats-officedocument.themeoverride+xml
# application/vnd.openxmlformats-officedocument.vmldrawing
# application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml
application/vnd.openxmlformats-officedocument.wordprocessingml.document docx
# application/vnd.openxmlformats-officedocument.wordprocessingml.document.glossary+xml
# application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml
# application/vnd.openxmlformats-officedocument.wordprocessingml.endnotes+xml
# application/vnd.openxmlformats-officedocument.wordprocessingml.fonttable+xml
# application/vnd.openxmlformats-officedocument.wordprocessingml.footer+xml
# application/vnd.openxmlformats-officedocument.wordprocessingml.footnotes+xml
# application/vnd.openxmlformats-officedocument.wordprocessingml.numbering+xml
# application/vnd.openxmlformats-officedocument.wordprocessingml.settings+xml
# application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml
application/vnd.openxmlformats-officedocument.wordprocessingml.template dotx
# application/vnd.openxmlformats-officedocument.wordprocessingml.template.main+xml
# application/vnd.openxmlformats-officedocument.wordprocessingml.websettings+xml
# application/vnd.openxmlformats-package.core-properties+xml
# application/vnd.openxmlformats-package.digital-signature-xmlsignature+xml
# application/vnd.openxmlformats-package.relationships+xml
# application/vnd.oracle.resource+json
# application/vnd.orange.indata
# application/vnd.osa.netdeploy
application/vnd.osgeo.mapguide.package mgp
# application/vnd.osgi.bundle
application/vnd.osgi.dp dp
application/vnd.osgi.subsystem esa
# application/vnd.otps.ct-kip+xml
# application/vnd.oxli.countgraph
# application/vnd.pagerduty+json
application/vnd.palm pdb pqa oprc
# application/vnd.panoply
# application/vnd.paos.xml
application/vnd.pawaafile paw
# application/vnd.pcos
application/vnd.pg.format str
application/vnd.pg.osasli ei6
# application/vnd.piaccess.application-licence
application/vnd.picsel efif
application/vnd.pmi.widget wg
# application/vnd.poc.group-advertisement+xml
application/vnd.pocketlearn plf
application/vnd.powerbuilder6 pbd
# application/vnd.powerbuilder6-s
# application/vnd.powerbuilder7
# application/vnd.powerbuilder7-s
# application/vnd.powerbuilder75
# application/vnd.powerbuilder75-s
# application/vnd.preminet
application/vnd.previewsystems.box box
application/vnd.proteus.magazine mgz
application/vnd.publishare-delta-tree qps
application/vnd.pvi.ptid1 ptid
# application/vnd.pwg-multiplexed
# application/vnd.pwg-xhtml-print+xml
# application/vnd.qualcomm.brew-app-res
# application/vnd.quarantainenet
application/vnd.quark.quarkxpress qxd qxt qwd qwt qxl qxb
# application/vnd.quobject-quoxdocument
# application/vnd.radisys.moml+xml
# application/vnd.radisys.msml+xml
# application/vnd.radisys.msml-audit+xml
# application/vnd.radisys.msml-audit-conf+xml
# application/vnd.radisys.msml-audit-conn+xml
# application/vnd.radisys.msml-audit-dialog+xml
# application/vnd.radisys.msml-audit-stream+xml
# application/vnd.radisys.msml-conf+xml
# application/vnd.radisys.msml-dialog+xml
# application/vnd.radisys.msml-dialog-base+xml
# application/vnd.radisys.msml-dialog-fax-detect+xml
# application/vnd.radisys.msml-dialog-fax-sendrecv+xml
# application/vnd.radisys.msml-dialog-group+xml
# application/vnd.radisys.msml-dialog-speech+xml
# application/vnd.radisys.msml-dialog-transform+xml
# application/vnd.rainstor.data
# application/vnd.rapid
# application/vnd.rar
application/vnd.realvnc.bed bed
application/vnd.recordare.musicxml mxl
application/vnd.recordare.musicxml+xml musicxml
# application/vnd.renlearn.rlprint
application/vnd.rig.cryptonote cryptonote
application/vnd.rim.cod cod
application/vnd.rn-realmedia rm
application/vnd.rn-realmedia-vbr rmvb
application/vnd.route66.link66+xml link66
# application/vnd.rs-274x
# application/vnd.ruckus.download
# application/vnd.s3sms
application/vnd.sailingtracker.track st
# application/vnd.sbm.cid
# application/vnd.sbm.mid2
# application/vnd.scribus
# application/vnd.sealed.3df
# application/vnd.sealed.csf
# application/vnd.sealed.doc
# application/vnd.sealed.eml
# application/vnd.sealed.mht
# application/vnd.sealed.net
# application/vnd.sealed.ppt
# application/vnd.sealed.tiff
# application/vnd.sealed.xls
# application/vnd.sealedmedia.softseal.html
# application/vnd.sealedmedia.softseal.pdf
application/vnd.seemail see
application/vnd.sema sema
application/vnd.semd semd
application/vnd.semf semf
application/vnd.shana.informed.formdata ifm
application/vnd.shana.informed.formtemplate itp
application/vnd.shana.informed.interchange iif
application/vnd.shana.informed.package ipk
application/vnd.simtech-mindmapper twd twds
# application/vnd.siren+json
application/vnd.smaf mmf
# application/vnd.smart.notebook
application/vnd.smart.teacher teacher
# application/vnd.software602.filler.form+xml
# application/vnd.software602.filler.form-xml-zip
application/vnd.solent.sdkm+xml sdkm sdkd
application/vnd.spotfire.dxp dxp
application/vnd.spotfire.sfs sfs
# application/vnd.sss-cod
# application/vnd.sss-dtf
# application/vnd.sss-ntf
application/vnd.stardivision.calc sdc
application/vnd.stardivision.draw sda
application/vnd.stardivision.impress sdd
application/vnd.stardivision.math smf
application/vnd.stardivision.writer sdw vor
application/vnd.stardivision.writer-global sgl
application/vnd.stepmania.package smzip
application/vnd.stepmania.stepchart sm
# application/vnd.street-stream
# application/vnd.sun.wadl+xml
application/vnd.sun.xml.calc sxc
application/vnd.sun.xml.calc.template stc
application/vnd.sun.xml.draw sxd
application/vnd.sun.xml.draw.template std
application/vnd.sun.xml.impress sxi
application/vnd.sun.xml.impress.template sti
application/vnd.sun.xml.math sxm
application/vnd.sun.xml.writer sxw
application/vnd.sun.xml.writer.global sxg
application/vnd.sun.xml.writer.template stw
application/vnd.sus-calendar sus susp
application/vnd.svd svd
# application/vnd.swiftview-ics
application/vnd.symbian.install sis sisx
application/vnd.syncml+xml xsm
application/vnd.syncml.dm+wbxml bdm
application/vnd.syncml.dm+xml xdm
# application/vnd.syncml.dm.notification
# application/vnd.syncml.dmddf+wbxml
# application/vnd.syncml.dmddf+xml
# application/vnd.syncml.dmtnds+wbxml
# application/vnd.syncml.dmtnds+xml
# application/vnd.syncml.ds.notification
application/vnd.tao.intent-module-archive tao
application/vnd.tcpdump.pcap pcap cap dmp
# application/vnd.tmd.mediaflex.api+xml
# application/vnd.tml
application/vnd.tmobile-livetv tmo
application/vnd.trid.tpt tpt
application/vnd.triscape.mxs mxs
application/vnd.trueapp tra
# application/vnd.truedoc
# application/vnd.ubisoft.webplayer
application/vnd.ufdl ufd ufdl
application/vnd.uiq.theme utz
application/vnd.umajin umj
application/vnd.unity unityweb
application/vnd.uoml+xml uoml
# application/vnd.uplanet.alert
# application/vnd.uplanet.alert-wbxml
# application/vnd.uplanet.bearer-choice
# application/vnd.uplanet.bearer-choice-wbxml
# application/vnd.uplanet.cacheop
# application/vnd.uplanet.cacheop-wbxml
# application/vnd.uplanet.channel
# application/vnd.uplanet.channel-wbxml
# application/vnd.uplanet.list
# application/vnd.uplanet.list-wbxml
# application/vnd.uplanet.listcmd
# application/vnd.uplanet.listcmd-wbxml
# application/vnd.uplanet.signal
# application/vnd.uri-map
# application/vnd.valve.source.material
application/vnd.vcx vcx
# application/vnd.vd-study
# application/vnd.vectorworks
# application/vnd.vel+json
# application/vnd.verimatrix.vcas
# application/vnd.vidsoft.vidconference
application/vnd.visio vsd vst vss vsw
application/vnd.visionary vis
# application/vnd.vividence.scriptfile
application/vnd.vsf vsf
# application/vnd.wap.sic
# application/vnd.wap.slc
application/vnd.wap.wbxml wbxml
application/vnd.wap.wmlc wmlc
application/vnd.wap.wmlscriptc wmlsc
application/vnd.webturbo wtb
# application/vnd.wfa.p2p
# application/vnd.wfa.wsc
# application/vnd.windows.devicepairing
# application/vnd.wmc
# application/vnd.wmf.bootstrap
# application/vnd.wolfram.mathematica
# application/vnd.wolfram.mathematica.package
application/vnd.wolfram.player nbp
application/vnd.wordperfect wpd
application/vnd.wqd wqd
# application/vnd.wrq-hp3000-labelled
application/vnd.wt.stf stf
# application/vnd.wv.csp+wbxml
# application/vnd.wv.csp+xml
# application/vnd.wv.ssp+xml
# application/vnd.xacml+json
application/vnd.xara xar
application/vnd.xfdl xfdl
# application/vnd.xfdl.webform
# application/vnd.xmi+xml
# application/vnd.xmpie.cpkg
# application/vnd.xmpie.dpkg
# application/vnd.xmpie.plan
# application/vnd.xmpie.ppkg
# application/vnd.xmpie.xlim
application/vnd.yamaha.hv-dic hvd
application/vnd.yamaha.hv-script hvs
application/vnd.yamaha.hv-voice hvp
application/vnd.yamaha.openscoreformat osf
application/vnd.yamaha.openscoreformat.osfpvg+xml osfpvg
# application/vnd.yamaha.remote-setup
application/vnd.yamaha.smaf-audio saf
application/vnd.yamaha.smaf-phrase spf
# application/vnd.yamaha.through-ngn
# application/vnd.yamaha.tunnel-udpencap
# application/vnd.yaoweme
application/vnd.yellowriver-custom-menu cmp
application/vnd.zul zir zirz
application/vnd.zzazz.deck+xml zaz
application/voicexml+xml vxml
# application/vq-rtcpxr
application/wasm wasm
# application/watcherinfo+xml
# application/whoispp-query
# application/whoispp-response
application/widget wgt
application/winhlp hlp
# application/wita
# application/wordperfect5.1
application/wsdl+xml wsdl
application/wspolicy+xml wspolicy
application/x-7z-compressed 7z
application/x-abiword abw
application/x-ace-compressed ace
# application/x-amf
application/x-apple-diskimage dmg
application/x-authorware-bin aab x32 u32 vox
application/x-authorware-map aam
application/x-authorware-seg aas
application/x-bcpio bcpio
application/x-bittorrent torrent
application/x-blorb blb blorb
application/x-bzip bz
application/x-bzip2 bz2 boz
application/x-cbr cbr cba cbt cbz cb7
application/x-cdlink vcd
application/x-cfs-compressed cfs
application/x-chat chat
application/x-chess-pgn pgn
# application/x-compress
application/x-conference nsc
application/x-cpio cpio
application/x-csh csh
application/x-debian-package deb udeb
application/x-dgc-compressed dgc
application/x-director dir dcr dxr cst cct cxt w3d fgd swa
application/x-doom wad
application/x-dtbncx+xml ncx
application/x-dtbook+xml dtb
application/x-dtbresource+xml res
application/x-dvi dvi
application/x-envoy evy
application/x-eva eva
application/x-font-bdf bdf
# application/x-font-dos
# application/x-font-framemaker
application/x-font-ghostscript gsf
# application/x-font-libgrx
application/x-font-linux-psf psf
application/x-font-pcf pcf
application/x-font-snf snf
# application/x-font-speedo
# application/x-font-sunos-news
application/x-font-type1 pfa pfb pfm afm
# application/x-font-vfont
application/x-freearc arc
application/x-futuresplash spl
application/x-gca-compressed gca
application/x-glulx ulx
application/x-gnumeric gnumeric
application/x-gramps-xml gramps
application/x-gtar gtar
# application/x-gzip
application/x-hdf hdf
application/x-install-instructions install
application/x-iso9660-image iso
application/x-java-jnlp-file jnlp
application/x-latex latex
application/x-lzh-compressed lzh lha
application/x-mie mie
application/x-mobipocket-ebook prc mobi
application/x-ms-application application
application/x-ms-shortcut lnk
application/x-ms-wmd wmd
application/x-ms-wmz wmz
application/x-ms-xbap xbap
application/x-msaccess mdb
application/x-msbinder obd
application/x-mscardfile crd
application/x-msclip clp
application/x-msdownload exe dll com bat msi
application/x-msmediaview mvb m13 m14
application/x-msmetafile wmf wmz emf emz
application/x-msmoney mny
application/x-mspublisher pub
application/x-msschedule scd
application/x-msterminal trm
application/x-mswrite wri
application/x-netcdf nc cdf
application/x-nzb nzb
application/x-pkcs12 p12 pfx
application/x-pkcs7-certificates p7b spc
application/x-pkcs7-certreqresp p7r
application/x-rar-compressed rar
application/x-research-info-systems ris
application/x-sh sh
application/x-shar shar
application/x-shockwave-flash swf
application/x-silverlight-app xap
application/x-sql sql
application/x-stuffit sit
application/x-stuffitx sitx
application/x-subrip srt
application/x-sv4cpio sv4cpio
application/x-sv4crc sv4crc
application/x-t3vm-image t3
application/x-tads gam
application/x-tar tar
application/x-tcl tcl
application/x-tex tex
application/x-tex-tfm tfm
application/x-texinfo texinfo texi
application/x-tgif obj
application/x-ustar ustar
application/x-wais-source src
# application/x-www-form-urlencoded
application/x-x509-ca-cert der crt
application/x-xfig fig
application/x-xliff+xml xlf
application/x-xpinstall xpi
application/x-xz xz
application/x-zmachine z1 z2 z3 z4 z5 z6 z7 z8
# application/x400-bp
# application/xacml+xml
application/xaml+xml xaml
# application/xcap-att+xml
# application/xcap-caps+xml
application/xcap-diff+xml xdf
# application/xcap-el+xml
# application/xcap-error+xml
# application/xcap-ns+xml
# application/xcon-conference-info+xml
# application/xcon-conference-info-diff+xml
application/xenc+xml xenc
application/xhtml+xml xhtml xht
# application/xhtml-voice+xml
application/xml xml xsl
application/xml-dtd dtd
# application/xml-external-parsed-entity
# application/xml-patch+xml
# application/xmpp+xml
application/xop+xml xop
application/xproc+xml xpl
application/xslt+xml xslt
application/xspf+xml xspf
application/xv+xml mxml xhvml xvml xvm
application/yang yang
application/yin+xml yin
application/zip zip
# application/zlib
# audio/1d-interleaved-parityfec
# audio/32kadpcm
# audio/3gpp
# audio/3gpp2
# audio/ac3
audio/adpcm adp
# audio/amr
# audio/amr-wb
# audio/amr-wb+
# audio/aptx
# audio/asc
# audio/atrac-advanced-lossless
# audio/atrac-x
# audio/atrac3
audio/basic au snd
# audio/bv16
# audio/bv32
# audio/clearmode
# audio/cn
# audio/dat12
# audio/dls
# audio/dsr-es201108
# audio/dsr-es202050
# audio/dsr-es202211
# audio/dsr-es202212
# audio/dv
# audio/dvi4
# audio/eac3
# audio/encaprtp
# audio/evrc
# audio/evrc-qcp
# audio/evrc0
# audio/evrc1
# audio/evrcb
# audio/evrcb0
# audio/evrcb1
# audio/evrcnw
# audio/evrcnw0
# audio/evrcnw1
# audio/evrcwb
# audio/evrcwb0
# audio/evrcwb1
# audio/evs
# audio/example
# audio/fwdred
# audio/g711-0
# audio/g719
# audio/g722
# audio/g7221
# audio/g723
# audio/g726-16
# audio/g726-24
# audio/g726-32
# audio/g726-40
# audio/g728
# audio/g729
# audio/g7291
# audio/g729d
# audio/g729e
# audio/gsm
# audio/gsm-efr
# audio/gsm-hr-08
# audio/ilbc
# audio/ip-mr_v2.5
# audio/isac
# audio/l16
# audio/l20
# audio/l24
# audio/l8
# audio/lpc
audio/midi mid midi kar rmi
# audio/mobile-xmf
audio/mp4 m4a mp4a
# audio/mp4a-latm
# audio/mpa
# audio/mpa-robust
audio/mpeg mpga mp2 mp2a mp3 m2a m3a
# audio/mpeg4-generic
# audio/musepack
audio/ogg oga ogg spx opus
# audio/opus
# audio/parityfec
# audio/pcma
# audio/pcma-wb
# audio/pcmu
# audio/pcmu-wb
# audio/prs.sid
# audio/qcelp
# audio/raptorfec
# audio/red
# audio/rtp-enc-aescm128
# audio/rtp-midi
# audio/rtploopback
# audio/rtx
audio/s3m s3m
audio/silk sil
# audio/smv
# audio/smv-qcp
# audio/smv0
# audio/sp-midi
# audio/speex
# audio/t140c
# audio/t38
# audio/telephone-event
# audio/tone
# audio/uemclip
# audio/ulpfec
# audio/vdvi
# audio/vmr-wb
# audio/vnd.3gpp.iufp
# audio/vnd.4sb
# audio/vnd.audiokoz
# audio/vnd.celp
# audio/vnd.cisco.nse
# audio/vnd.cmles.radio-events
# audio/vnd.cns.anp1
# audio/vnd.cns.inf1
audio/vnd.dece.audio uva uvva
audio/vnd.digital-winds eol
# audio/vnd.dlna.adts
# audio/vnd.dolby.heaac.1
# audio/vnd.dolby.heaac.2
# audio/vnd.dolby.mlp
# audio/vnd.dolby.mps
# audio/vnd.dolby.pl2
# audio/vnd.dolby.pl2x
# audio/vnd.dolby.pl2z
# audio/vnd.dolby.pulse.1
audio/vnd.dra dra
audio/vnd.dts dts
audio/vnd.dts.hd dtshd
# audio/vnd.dvb.file
# audio/vnd.everad.plj
# audio/vnd.hns.audio
audio/vnd.lucent.voice lvp
audio/vnd.ms-playready.media.pya pya
# audio/vnd.nokia.mobile-xmf
# audio/vnd.nortel.vbk
audio/vnd.nuera.ecelp4800 ecelp4800
audio/vnd.nuera.ecelp7470 ecelp7470
audio/vnd.nuera.ecelp9600 ecelp9600
# audio/vnd.octel.sbc
# audio/vnd.qcelp
# audio/vnd.rhetorex.32kadpcm
audio/vnd.rip rip
# audio/vnd.sealedmedia.softseal.mpeg
# audio/vnd.vmx.cvsd
# audio/vorbis
# audio/vorbis-config
audio/webm weba
audio/x-aac aac
audio/x-aiff aif aiff aifc
audio/x-caf caf
audio/x-flac flac
audio/x-matroska mka
audio/x-mpegurl m3u
audio/x-ms-wax wax
audio/x-ms-wma wma
audio/x-pn-realaudio ram ra
audio/x-pn-realaudio-plugin rmp
# audio/x-tta
audio/x-wav wav
audio/xm xm
chemical/x-cdx cdx
chemical/x-cif cif
chemical/x-cmdf cmdf
chemical/x-cml cml
chemical/x-csml csml
# chemical/x-pdb
chemical/x-xyz xyz
font/collection ttc
font/otf otf
# font/sfnt
font/ttf ttf
font/woff woff
font/woff2 woff2
image/avif avif
image/bmp bmp
image/cgm cgm
# image/dicom-rle
# image/emf
# image/example
# image/fits
image/g3fax g3
image/gif gif
image/ief ief
# image/jls
# image/jp2
image/jpeg jpeg jpg jpe
# image/jpm
# image/jpx
image/jxl jxl
image/ktx ktx
# image/naplps
image/png png
image/prs.btif btif
# image/prs.pti
# image/pwg-raster
image/sgi sgi
image/svg+xml svg svgz
# image/t38
image/tiff tiff tif
# image/tiff-fx
image/vnd.adobe.photoshop psd
# image/vnd.airzip.accelerator.azv
# image/vnd.cns.inf2
image/vnd.dece.graphic uvi uvvi uvg uvvg
image/vnd.djvu djvu djv
image/vnd.dvb.subtitle sub
image/vnd.dwg dwg
image/vnd.dxf dxf
image/vnd.fastbidsheet fbs
image/vnd.fpx fpx
image/vnd.fst fst
image/vnd.fujixerox.edmics-mmr mmr
image/vnd.fujixerox.edmics-rlc rlc
# image/vnd.globalgraphics.pgb
# image/vnd.microsoft.icon
# image/vnd.mix
# image/vnd.mozilla.apng
image/vnd.ms-modi mdi
image/vnd.ms-photo wdp
image/vnd.net-fpx npx
# image/vnd.radiance
# image/vnd.sealed.png
# image/vnd.sealedmedia.softseal.gif
# image/vnd.sealedmedia.softseal.jpg
# image/vnd.svf
# image/vnd.tencent.tap
# image/vnd.valve.source.texture
image/vnd.wap.wbmp wbmp
image/vnd.xiff xif
# image/vnd.zbrush.pcx
image/webp webp
# image/wmf
image/x-3ds 3ds
image/x-cmu-raster ras
image/x-cmx cmx
image/x-freehand fh fhc fh4 fh5 fh7
image/x-icon ico
image/x-mrsid-image sid
image/x-pcx pcx
image/x-pict pic pct
image/x-portable-anymap pnm
image/x-portable-bitmap pbm
image/x-portable-graymap pgm
image/x-portable-pixmap ppm
image/x-rgb rgb
image/x-tga tga
image/x-xbitmap xbm
image/x-xpixmap xpm
image/x-xwindowdump xwd
# message/cpim
# message/delivery-status
# message/disposition-notification
# message/example
# message/external-body
# message/feedback-report
# message/global
# message/global-delivery-status
# message/global-disposition-notification
# message/global-headers
# message/http
# message/imdn+xml
# message/news
# message/partial
message/rfc822 eml mime
# message/s-http
# message/sip
# message/sipfrag
# message/tracking-status
# message/vnd.si.simp
# message/vnd.wfa.wsc
# model/example
# model/gltf+json
model/iges igs iges
model/mesh msh mesh silo
model/vnd.collada+xml dae
model/vnd.dwf dwf
# model/vnd.flatland.3dml
model/vnd.gdl gdl
# model/vnd.gs-gdl
# model/vnd.gs.gdl
model/vnd.gtw gtw
# model/vnd.moml+xml
# model/vnd.mts
# model/vnd.opengex
# model/vnd.parasolid.transmit.binary
# model/vnd.parasolid.transmit.text
# model/vnd.rosette.annotated-data-model
# model/vnd.valve.source.compiled-map
model/vnd.vtu vtu
model/vrml wrl vrml
model/x3d+binary x3db x3dbz
# model/x3d+fastinfoset
model/x3d+vrml x3dv x3dvz
model/x3d+xml x3d x3dz
# model/x3d-vrml
# multipart/alternative
# multipart/appledouble
# multipart/byteranges
# multipart/digest
# multipart/encrypted
# multipart/example
# multipart/form-data
# multipart/header-set
# multipart/mixed
# multipart/parallel
# multipart/related
# multipart/report
# multipart/signed
# multipart/voice-message
# multipart/x-mixed-replace
# text/1d-interleaved-parityfec
text/cache-manifest appcache
text/calendar ics ifb
text/css css
text/csv csv
# text/csv-schema
# text/directory
# text/dns
# text/ecmascript
# text/encaprtp
# text/enriched
# text/example
# text/fwdred
# text/grammar-ref-list
text/html html htm
text/javascript js mjs
# text/jcr-cnd
# text/markdown
# text/mizar
text/n3 n3
# text/parameters
# text/parityfec
text/plain txt text conf def list log in
# text/provenance-notation
# text/prs.fallenstein.rst
text/prs.lines.tag dsc
# text/prs.prop.logic
# text/raptorfec
# text/red
# text/rfc822-headers
text/richtext rtx
# text/rtf
# text/rtp-enc-aescm128
# text/rtploopback
# text/rtx
text/sgml sgml sgm
# text/t140
text/tab-separated-values tsv
text/troff t tr roff man me ms
text/turtle ttl
# text/ulpfec
text/uri-list uri uris urls
text/vcard vcard
# text/vnd.a
# text/vnd.abc
text/vnd.curl curl
text/vnd.curl.dcurl dcurl
text/vnd.curl.mcurl mcurl
text/vnd.curl.scurl scurl
# text/vnd.debian.copyright
# text/vnd.dmclientscript
text/vnd.dvb.subtitle sub
# text/vnd.esmertec.theme-descriptor
text/vnd.fly fly
text/vnd.fmi.flexstor flx
text/vnd.graphviz gv
text/vnd.in3d.3dml 3dml
text/vnd.in3d.spot spot
# text/vnd.iptc.newsml
# text/vnd.iptc.nitf
# text/vnd.latex-z
# text/vnd.motorola.reflex
# text/vnd.ms-mediapackage
# text/vnd.net2phone.commcenter.command
# text/vnd.radisys.msml-basic-layout
# text/vnd.si.uricatalogue
text/vnd.sun.j2me.app-descriptor jad
# text/vnd.trolltech.linguist
# text/vnd.wap.si
# text/vnd.wap.sl
text/vnd.wap.wml wml
text/vnd.wap.wmlscript wmls
text/x-asm s asm
text/x-c c cc cxx cpp h hh dic
text/x-fortran f for f77 f90
text/x-java-source java
text/x-nfo nfo
text/x-opml opml
text/x-pascal p pas
text/x-setext etx
text/x-sfv sfv
text/x-uuencode uu
text/x-vcalendar vcs
text/x-vcard vcf
# text/xml
# text/xml-external-parsed-entity
# video/1d-interleaved-parityfec
video/3gpp 3gp
# video/3gpp-tt
video/3gpp2 3g2
# video/bmpeg
# video/bt656
# video/celb
# video/dv
# video/encaprtp
# video/example
video/h261 h261
video/h263 h263
# video/h263-1998
# video/h263-2000
video/h264 h264
# video/h264-rcdo
# video/h264-svc
# video/h265
# video/iso.segment
video/jpeg jpgv
# video/jpeg2000
video/jpm jpm jpgm
video/mj2 mj2 mjp2
# video/mp1s
# video/mp2p
video/mp2t ts m2t m2ts mts
video/mp4 mp4 mp4v mpg4
# video/mp4v-es
video/mpeg mpeg mpg mpe m1v m2v
# video/mpeg4-generic
# video/mpv
# video/nv
video/ogg ogv
# video/parityfec
# video/pointer
video/quicktime qt mov
# video/raptorfec
# video/raw
# video/rtp-enc-aescm128
# video/rtploopback
# video/rtx
# video/smpte292m
# video/ulpfec
# video/vc1
# video/vnd.cctv
video/vnd.dece.hd uvh uvvh
video/vnd.dece.mobile uvm uvvm
# video/vnd.dece.mp4
video/vnd.dece.pd uvp uvvp
video/vnd.dece.sd uvs uvvs
video/vnd.dece.video uvv uvvv
# video/vnd.directv.mpeg
# video/vnd.directv.mpeg-tts
# video/vnd.dlna.mpeg-tts
video/vnd.dvb.file dvb
video/vnd.fvt fvt
# video/vnd.hns.video
# video/vnd.iptvforum.1dparityfec-1010
# video/vnd.iptvforum.1dparityfec-2005
# video/vnd.iptvforum.2dparityfec-1010
# video/vnd.iptvforum.2dparityfec-2005
# video/vnd.iptvforum.ttsavc
# video/vnd.iptvforum.ttsmpeg2
# video/vnd.motorola.video
# video/vnd.motorola.videop
video/vnd.mpegurl mxu m4u
video/vnd.ms-playready.media.pyv pyv
# video/vnd.nokia.interleaved-multimedia
# video/vnd.nokia.videovoip
# video/vnd.objectvideo
# video/vnd.radgamettools.bink
# video/vnd.radgamettools.smacker
# video/vnd.sealed.mpeg1
# video/vnd.sealed.mpeg4
# video/vnd.sealed.swf
# video/vnd.sealedmedia.softseal.mov
video/vnd.uvvu.mp4 uvu uvvu
video/vnd.vivo viv
# video/vp8
video/webm webm
video/x-f4v f4v
video/x-fli fli
video/x-flv flv
video/x-m4v m4v
video/x-matroska mkv mk3d mks
video/x-mng mng
video/x-ms-asf asf asx
video/x-ms-vob vob
video/x-ms-wm wm
video/x-ms-wmv wmv
video/x-ms-wmx wmx
video/x-ms-wvx wvx
video/x-msvideo avi
video/x-sgi-movie movie
video/x-smv smv
x-conference/x-cooltalk ice
httpd-2.4.64/docs/man/ 0000775 0001751 0001751 00000000000 15032766613 014336 5 ustar covener covener httpd-2.4.64/docs/man/tr/ 0000775 0001751 0001751 00000000000 15032766613 014763 5 ustar covener covener httpd-2.4.64/docs/man/tr/htpasswd.1 0000664 0001751 0001751 00000021203 12352211121 016655 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTPASSWD" 1 "2014-06-24" "Apache HTTP Sunucusu" "htpasswd"
.nh
.SH İSİM
htpasswd \- Temel kimlik doğrulama dosyalarını yönetir
.SH "KULLANIM"
.PP
\fBhtpasswd\fR [ -\fBc\fR ] [ -\fBi\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIbedel\fR ] [ -\fBD\fR ] [ -\fBv\fR ] \fIparola-dosyası\fR \fIkullanıcı\fR
.PP
\fBhtpasswd\fR -\fBb\fR [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIbedel\fR ] [ -\fBD\fR ] [ -\fBv\fR ] \fIparola-dosyası\fR \fIkullanıcı\fR \fIparola\fR
.PP
\fBhtpasswd\fR -\fBn\fR [ -\fBi\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIbedel\fR ] \fIkullanıcı\fR
.PP
\fBhtpasswd\fR -\fBnb\fR [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIbedel\fR ] \fIkullanıcı\fR \fIparola\fR
.SH "ÖZET"
.PP
\fBhtpasswd\fR, HTTP kullanıcılarının temel kimlik doğrulaması için kullanıcı isimlerinin ve parolalarının saklanmasında kullanılacak düz metin dosyalarını oluşturmak ve güncellemek için kullanılır\&. \fBhtpasswd\fR, güncelleme sırasında yazmak veya okumak için bir dosyaya erişemezse beklenen hiçbir işlemi yapmaz ve hata vererek çıkar\&.
.PP
Apache HTTP sunucusunun mevcut özkaynaklarının kullanımı sadece \fBhtpasswd\fR tarafından oluşturulan dosyalarda listelenmiş kullanıcılara tahsis edilebilir\&. \fBhtpasswd\fR sadece düz metin dosyalarda saklanmış kullanıcı isimlerini ve parolalarını yönetirse de, diğer veri saklama türleri için parolayı şifreleyip gösterebilir\&. Bir DBM veritabanı kullanmak isterseniz \fBdbmmanage\fR ve \fBhtdbm\fR sayfasına bakınız\&.
.PP
\fBhtpasswd\fR, parolaları şifrelemek için bcrypt, Apache'nin kendine özgü MD5 algoritması, SHA1 ya da sistemin crypt() yordamını kullanır\&. Bu bakımdan \fBhtpasswd\fR tarafından yönetilen dosyalar farklı algoritmalarla şifrelenmiş parolalar içerebilir\&.
.PP
Bu kılavuz sayfası sadece komut satırı değiştirgelerini listeler\&. Kullanıcı kimlik doğrulamasını \fBhttpd\fR'de yapılandırmak için gerekli yönergelerle ilgili ayrıntılar için Apache dağıtımının bir parçası olan ve http://httpd\&.apache\&.org/ adresinde de bulunan Apache HTTP Sunucusu Belgelerine bakınız\&.
.SH "SEÇENEKLER"
.TP
\fB-b\fR
Betik kipi; parola için istek yapmak yerine parola komut satırından verilir\&. \fBParola komut satırında görünür\fR olacağından çok dikkatli kullanmak gerekir\&. Betik kullanımı için \fB-i\fR seçeneğine bakınız\&. 2\&.4\&.4 ve sonraki sürümler içindir\&.
.TP
\fB-i\fR
Parolayı doğrulamaksızın standart girdiden okur (betik kullanımı için)\&.
.TP
\fB-c\fR
\fIparola-dosyası\fR oluşturur\&. Dosya mevcutsa, dosya silinip yeniden yazılır\&. Bu seçenek \fB-n\fR seçeneği ile birlikte kullanılamaz\&.
.TP
\fB-n\fR
Sonuçları veritabanında güncellemek yerine standart çıktıya gönderir\&. Bu seçenek, Apache'nin metin veriler içermeyen veri depolarına dahil edilebilecek parolaları üretmekte yararlıdır\&. \fIparola-dosyası\fR belirtilmediğinden, bu seçenek komut satırı sözdizimini değiştirir\&. Bu seçenek \fB-c\fR seçeneği ile birlikte kullanılamaz\&.
.TP
\fB-m\fR
Parolalar için MD5 şifrelemesi kullanılır\&. Bu 2\&.2\&.18 sürümünden beri öntanımlıdır\&.
.TP
\fB-B\fR
Parolalar için bcrypt şifrelemesi kullanılır\&. Şu an için çok güvenli kabul edilmektedir\&.
.TP
\fB-C\fR \fIbedel\fR
Bu seçenek sadece \fB-B\fR (bcrypt şifrelemesi) seçeneği ile birlikte kullanılabilir\&. Bcrypt algoritmasına hesaplama süresini belirtir (daha yüksek değerler daha güvenlidir, öntanımlı 5, geçerli değerler: 4 - 31)\&.
.TP
\fB-d\fR
Parolaları şifrelemek için crypt() kullanılır\&. \fBhtpasswd\fR tarafından tüm platformlarda destekleniyor olsa da Windows, Netware ve TPF üzerinde httpd sunucusu tarafından desteklenmez\&. Bu algoritma günümüz standartlarında \fBgüvenilmez\fR kabul edilmektedir\&. 2\&.2\&.17 sürümüne kadar öntanımlı algoritma olarak kullanılmıştı\&.
.TP
\fB-s\fR
Parolalar için SHA şifrelemesi kullanılır\&. LDAP Dizin değişim biçemini (ldif) kullanarak Netscape sunucularına/sunucularından göçü kolaylaştırır\&.Bu algoritma günümüz standartlarında \fBgüvenilmez\fR kabul edilmektedir\&.
.TP
\fB-p\fR
Düz metin parolalar kullanılır\&. \fBhtpasswd\fR tarafından tüm platformlarda destekleniyor olsa da Windows, Netware ve TPF üzerinde httpd sunucusu tarafından sadece düz metin parolalar kabul edilir\&.
.TP
\fB-D\fR
Kullanıcıyı siler\&. Kullanıcı belirtilen dosyada mevcutsa silinir\&.
.TP
-v
Parolayı doğrular\&. Verilen parolayı belitilen htpasswd dosyasında saklanan kullanıcı parolası ile karşılaştırarak doğrulama yapar\&. 2\&.4\&.5 ve sonraki sürümler içindir\&.
.TP
\fIparola-dosyası\fR
Kullanıcı ismini ve parolasını içeren dosyanın ismi\&. \fB-c\fR seçeneği verilmişse ve dosya mevcut değilse oluşturulur, dosya mevcutsa silinip yeniden oluşturulur\&.
.TP
\fIkullanıcı\fR
\fIparola-dosyası\fR'nda oluşturulacak veya güncellenecek kullanıcı ismi\&. \fIkullanıcı\fR bu dosyada mevcut değilse yeni bir girdi eklenir\&. Girdi mevcutsa parolası değiştirilir\&.
.TP
\fIparola\fR
Şifrelenip dosyada saklanacak düz metin parola\&. Sadece \fB-b\fR seçeneği ile kullanılır\&.
.SH "ÇIKIŞ DURUMU"
.PP
\fBhtpasswd\fR, kullanıcı ismi ve parolasını DBM dosyasına başarıyla eklemiş veya güncellemişse 0, dosyalara erişirken bir sorun çıkmışsa 1, komut satırında bir sözdizimi hatası varsa 2, parola etkileşimli alınmış fakat girdi ile eşleşme sağlanamamışsa 3, işlem kesintiye uğramışsa 4, bir değer çok uzunsa 5 (kullanıcı, parola, dosya ismi veya açıklama), kullanıcı ismi kuraldışı karakter içeriyorsa (Kısıtlamalar bölümüne bakınız) 6 ve dosya geçerli bir DBM parola dosyası değilse 7 değeriyle döner\&.
.SH "ÖRNEKLER"
.nf
htpasswd /usr/local/etc/apache/\&.htpasswd-users jsmith
.fi
.PP
jsmith kullanıcısı için parolayı ekler veya değiştirir\&. Parolayı vermesi için kullanıcıya parola isteği yapılır\&. Parola takviyeli Apache MD5 algoritması ile şifrelenir\&. Dosya mevcut değilse \fBhtpasswd\fR beklenen hiçbir işlemi yapmadan bir hata vererek çıkar\&.
.nf
htpasswd -c /home/doe/public_html/\&.htpasswd jane
.fi
.PP
Yeni bir dosya oluşturur ve kullanıcı jane için kaydı bir girdi olarak bu dosyaya yazar\&. Dosya mevcutsa fakat okunamıyor veya yazılamıyorsa dosyada bir değişiklik yapılmaz ve \fBhtpasswd\fR bir ileti gösterip bir hata durumu ile çıkar\&.
.nf
htpasswd -db /usr/web/\&.htpasswd-all jones Pwd4Steve
.fi
.PP
Komut satırından verilen parolayı (Pwd4Steve) crypt() algoritmasıyla şifreler ve bunu belirtilen dosyada saklar\&.
.SH "GÜVENLİK DEĞERLENDİRMELERİ"
.PP
\fBhtpasswd\fR tarafından yönetilen parola dosyalarına sunucunun URI uzayından erişilememelidir; yani dosya bir tarayıcı ile okunabilecek bir yerde bulunmamalıdır\&.
.PP
Bu program bir setuid çalıştırılabiliri olarak güvenilir olmadığından \fIsetuid yapılmamalıdır\fR\&.
.PP
Komut satırında parolanın şifrelenmemiş olarak görünmesi sebebiyle \fB-b\fR seçeneğinin kullanımından kaçınılmasını öneriyoruz\&.
.PP
crypt() algoritması kullanılırken, parolayı şekillendirmek için parolanın ilk 8 baytının kullanılacağına dikkat ediniz\&. Eğer parola 8 bayttan uzunsa kalanlar bir uyarı verilmeksizin iptal edilir\&.
.PP
SHA şifreleme biçeminde tuz kullanılmaz; yani, bir parolanın sadece bir şifreli gösterimi olabilir\&. crypt() ve MD5 biçemleri parolanın önüne rasgele üretilmiş bir tuz dizgesi eklediklerinden sözlük saldırılarına karşı daha dayanıklıdırlar\&.
.PP
SHA ve crypt() biçimleri günümüz standartlarında \fBgüvenilmez\fR kabul edilmektedir\&.
.SH "KISITLAMALAR"
.PP
Windows platformuda, \fBhtpasswd\fR ile şifrelenen parolalar 255 karakterden daha uzun olamaz\&. 255 karakterden sonrası kırpılır\&.
.PP
\fBhtpasswd\fR tarafından kullanılan MD5 algoritması Apache yazılımına özeldir; bu algoritma ile şifrelenen parolalar başka HTTP sunucularında kullanılamayabilir\&.
.PP
Kullanıcı isimleri 255 bayttan uzun olamaz ve iki nokta imi (:) içeremez\&.
httpd-2.4.64/docs/man/tr/suexec.8 0000664 0001751 0001751 00000002601 12203356434 016340 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "SUEXEC" 8 "2013-08-16" "Apache HTTP Sunucusu" "suexec"
.nh
.SH İSİM
suexec \- harici programları çalıştırmadan önce kullanıcıyı değiştirir
.SH "KULLANIM"
.PP
\fBsuexec\fR -\fBV\fR
.SH "ÖZET"
.PP
\fBsuexec\fR, CGI programlarını çalıştırmadan önce Apache HTTP Sunucusu tarafından kullanıcı değiştirmek için kullanılır\&. Bunu yapabilmek için sunucunun root tarafından çalıştırılmış olması gerekir\&. HTTP artalan süreci normalde root aidiyetinde çalışmadığından \fBsuexec\fR'in çalıştırılabilir dosyasının sahibi root olmalı, setuid biti etkin (u+s) olmalı ve dosyaya root dışında hiç kimse yazamamalıdır\&.
.PP
\fBsuexec\fR güvenlik modeli ve kavramlar hakkında bilgi edinmek için suexec belgesine (http://httpd\&.apache\&.org/docs/2\&.4/suexec\&.html) bakınız\&.
.SH "SEÇENEKLER"
.TP
\fB-V\fR
root iseniz, bu seçenek \fBsuexec\fR derleme seçeneklerini gösterir\&. Güvenlik sebebiyle tüm yapılandırma seçenekleri sadece derleme sırasında değiştirilebilir\&.
httpd-2.4.64/docs/man/tr/ab.1 0000664 0001751 0001751 00000025025 12352211121 015410 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "AB" 1 "2014-06-24" "Apache HTTP Sunucusu" "ab"
.nh
.SH İSİM
ab \- Apache HTTP sunucusu başarım ölçme aracı
.SH "KULLANIM"
.PP
\fBab\fR [ -\fBA\fR \fIyetkili-kullanıcı:parola\fR ] [ -\fBb\fR \fItampon-boyu\fR ] [ -\fBB\fR \fIyerel-adres\fR ] [ -\fBc\fR \fIbağlantı-sayısı\fR ] [ -\fBC\fR \fIçerez-ismi=değer\fR ] [ -\fBd\fR ] [ -\fBe\fR \fIcsv-dosyası\fR ] [ -\fBf\fR \fIprotokol\fR ] [ -\fBg\fR \fIgnuplot-dosyası\fR ] [ -\fBh\fR ] [ -\fBH\fR \fIözel-başlık\fR ] [ -\fBi\fR ] [ -\fBk\fR ] [ -\fBl\fR ] [ -\fBm\fR \fIHTTP-yöntemi\fR ] [ -\fBn\fR \fIistek-sayısı\fR ] [ -\fBp\fR \fIPOST-dosyası\fR ] [ -\fBP\fR \fIvekil-yetkilisi:parola\fR ] [ -\fBq\fR ] [ -\fBr\fR ] [ -\fBs\fR \fIzamanasimi\fR ] [ -\fBS\fR ] [ -\fBt\fR \fIsaniye\fR ] [ -\fBT\fR \fIiçerik-türü\fR ] [ -\fBu\fR \fIPUT-dosyası\fR ] [ -\fBv\fR \fIayrıntı-düzeyi\fR] [ -\fBV\fR ] [ -\fBw\fR ] [ -\fBx\fR \fI<table>-öznitelikleri\fR ] [ -\fBX\fR \fIvekil\fR[:\fIport\fR] ] [ -\fBy\fR \fI<tr>-öznitelikleri\fR ] [ -\fBz\fR \fI<td>-öznitelikleri\fR ] [ -\fBZ\fR \fIşifre-kümesi\fR ] [http[s]://]\fIkonakadı\fR[:\fIport\fR]/\fIdizin\fR
.SH "ÖZET"
.PP
\fBab\fR Apache Hiper Metin Aktarım Protokolü (HTTP) sunucunuzun başarımını ölçmek amacıyla kullanabileceğiniz bir kıyaslama aracıdır\&. Mevcut Apache kurulumunuzun görevini nasıl yerine getirdiği hakkında bir izlenim edinmeniz için tasarlanmıştır\&. Özellikle, Apache kurulumunuzun saniyede kaç isteği sunma yeteneğinde olduğunu gösterir\&.
.SH "SEÇENEKLER"
.TP
\fB-A\fR \fIyetkili-kullanıcı\fR:\fIparola\fR
Sunucuya TEMEL Kimlik Doğrulamada kullanılmak üzere kanıt sağlar\&. Kullanıcı adı ile parola arasına sadece : konur ve sunucunun buna ihtiyacı olup olmadığına bakılmaksızın (yani, bir "401 kimlik doğrulaması gerekli" yanıtı beklenmeden) bağlantı üzerinden base64 kodlu olarak sunucuya gönderilir\&.
.TP
\fB-b\fR \fItampon-boyu\fR
TCP gönderme/alma tamponlarının bayt cinsinden uzunluğu\&.
.TP
\fB-B\fR \fIyerel-adres\fR
Uzak bağlantılar yaparken dinlenecek adres\&.
.TP
\fB-c\fR \fIbağlantı-sayısı\fR
Aynı anda işleme sokulacak bağlantı sayısı\&. Aynı anda bir bağlantı öntanımlı değerdir\&.
.TP
\fB-C\fR \fIçerez-ismi\fR=\fIdeğer\fR
İsteğe bir Cookie: satırı ekler\&. Argüman olarak genellikle bir \fIisim=değer\fR çifti kullanılır\&. Bu çiftler birden fazla olabilir\&.
.TP
\fB-d\fR
"percentage served within XX [ms] table" iletisi gösterilmez\&. (Geriye uyumluluk için vardır)\&.
.TP
\fB-e\fR \fIcsv-dosyası\fR
Sunulan isteğin birim zamanda (milisaniye) ne kadarının (yüzde cinsinden) sunulduğunu gösteren virgül ayraçlı değerler (CSV) dosyası\&. Sonuçlar 'bobin haline' getirilmiş olduğundan doğal olarak 'gnuplot' dosyasından daha yararlıdır\&.
.TP
\fB-f\fR \fIprotokol\fR
SSL/TLS protokolü belirtilir (SSL2, SSL3, TLS1, TLS1\&.1, TLS1\&.2 veya ALL)\&. TLS1\&.1 ve TLS1\&.2 desteği 2\&.4\&.4 ve sonraki sürümler içindir\&.
.TP
\fB-g\fR \fIgnuplot-dosyası\fR
Ölçülen değerler bir 'gnuplot' veya TSV (sekme ayraçlı değerler) dosyasına yazılır\&. Bu dosya, Gnuplot, IDL, Mathematica, Igor hatta Excel tarafından veri dosyası olarak kabul edilir\&. Veri sütunlarının başlıkları dosyanın ilk satırında bulunur\&.
.TP
\fB-h\fR
Kullanım bilgisi gösterir\&.
.TP
\fB-H\fR \fIözel-başlık\fR
İsteğe fazladan başlık ekler\&. \fIözel-başlık\fR, aralarında iki nokta imi bulunan bir isim-değer çifti olarak belirtilir\&. Örnek: "Accept-Encoding: zip/zop;8bit"
.TP
\fB-i\fR
GET istekleri yerine HEAD istekleri yapılır\&.
.TP
\fB-k\fR
HTTP KeepAlive (kalıcı bağlantı) özelliğini etkinleştirir, yani tek bir oturum içinde çok sayıda isteğe hizmet sunulabilir\&. Özellik öntanımlı olarak kapalıdır\&.
.TP
\fB-l\fR
Yanıtarın uzunluğu sabit değilse hataları raporlamaz\&. Özdevinimli sayfalarda kullanışlı olabilir\&. 2\&.4\&.7 ve sonraki sürümler içindir\&.
.TP
\fB-m\fR \fIHTTP-yöntemi\fR
İstekler için özel HTTP yöntemi, belirtilir\&. 2\&.4\&.10 ve sonraki sürümler içindir\&.
.TP
\fB-n\fR \fIistek-sayısı\fR
Kıyaslama oturumu sırasında sunucuya uygulanacak istek sayısı\&. Öntanımlı olarak hiçbir başarım ölçütü sağlamayan tek bir istek yapılır\&.
.TP
\fB-p\fR \fIPOST-dosyası\fR
POST isteği ile ilgili verileri içeren dosya\&. Ayrıca \fB-T\fR seçeneğini de belirtmeyi unutmayın\&.\&.
.TP
\fB-P\fR \fIvekil-yetkilisi\fR:\fIparola\fR
Vekil sunucuya TEMEL Kimlik Doğrulamasında kullanılacak kanıtları sağlar\&. Kullanıcı adı ile parola arasına sadece : konur ve vekilin buna ihtiyacı olup olmadığına bakılmaksızın (yani, bir "407 vekilde kimlik doğrulaması gerekiyor" yanıtı beklenmeden) bağlantı üzerinden base64 kodlu olarak sunucuya gönderilir\&.
.TP
\fB-q\fR
İstek sayısı 150'den fazla olduğunda, \fBab\fR her 100 veya %10 istekte bir, standart hataya bir işlenen istek sayacı çıktılar\&. \fB-q\fR seçeneği bu çıktının üretilmemesini sağlar\&.
.TP
\fB-r\fR
Soket hata alsa bile program çıkmaz\&.
.TP
\fB-s\fR \fIzamanasimi\fR
Soket zaman aşımına uğramadan önce beklenecek azami saniye sayısı\&. 30 saniye öntanımlı süredir\&. 2\&.4\&.4 ve sonraki sürümler içindir\&.
.TP
\fB-S\fR
Ortalama ve ortanca değerler arasında bir veya iki standart sapmadan fazlası varsa ne ortalama değer ne standart sapma değeri ne de uyarı/hata iletileri gösterilir\&. Öntanımlı olarak, asgari/ortalama/azami değerler gösterilir\&. (Geriye uyumluluk)\&.
.TP
\fB-t\fR \fIsaniye\fR
Ölçümleme işleminin ne kadar süreyle uygulanacağı belirtilir\&. Dahili olarak \fB-n 50000\fR seçeneği uygulanır\&. Bunu belli bir süreye göre kıyaslama yapmak amacıyla kullanabilirsiniz\&. Öntanımlı olarak bir süre kısıtlaması yoktur\&.
.TP
\fB-T\fR \fIiçerik-türü\fR
POST/PUT verisi için kullanılacak içerik türü belirtilir\&. Örnek: application/x-www-form-urlencoded\&. Öntanımlı değer: text/plain\&.
.TP
\fB-v\fR \fIayrıntı-düzeyi\fR
Çıktının ayrıntı düzeyi belirtilir\&. 4 ve üstü ile başlıklar hakkında bilgi, 3 ve üstü ile yanıt kodları (404, 200, vb\&.), 2 ve üstü ile ise uyarı ve bilgi iletileri gösterilir\&.
.TP
-u \fIPUT-dosyası\fR
PUT verisini içeren dosya\&. Ayrıca, -T seçeneğini belirtmeyi de unutmayın\&.
.TP
\fB-V\fR
Sürüm bilgilerini gösterir ve çıkar\&.
.TP
\fB-w\fR
Sonuçları HTML tabloları olarak basar\&. Öntanımlı tablo, beyaz artalanlı ve iki sütunludur\&.
.TP
\fB-x\fR \fI<table>-öznitelikleri\fR
<table> etiketinde kullanılacak öznitelikler belirtilir\&. Belirtilen öznitelikler etiket içine <table \fIburaya\fR > biçeminde yerleştirilir\&.
.TP
\fB-X\fR \fIvekil\fR[:\fIport\fR]
İstekler için bir vekil sunucu kullanılır\&.
.TP
\fB-y\fR \fI<tr>-öznitelikleri\fR
<tr> etiketinde kullanılacak öznitelikler belirtilir\&.
.TP
\fB-z\fR \fI<td>-öznitelikleri\fR
<td> etiketinde kullanılacak öznitelikler belirtilir\&.
.TP
-Z \fIşifre-kümesi\fR
SSL/TLS şifre kümesi belirtilir (\fBopenssl\fR(1) şifrelerine bakınız)\&.
.SH "ÇIKTI"
.PP
Aşağıda \fBab\fR tarafından döndürülen değerler açıklanmıştır:
.TP
Server Software
İlk başarılı yanıtın, varsa, \fIserver\fR HTTP başlığında döndürülen değer\&. Bu başlıktaki başlangıçtan 32 ondalık değerli karaktere (genellikle boşluk veya CR/LF karakteri) kadar tüm karakterleri içerir\&.
.TP
Server Hostname
Komut satırında belirtilen DNS veya IP adresi\&.
.TP
Server Port
\fBab\fR'nin bağlandığı port\&. Komut satırında port belirtilmemişse, öntanımlı olarak http için 80, https için 443'tür\&.
.TP
SSL/TLS Protocol
İstemci le sunucu arasında uzlaşılmış protokol değerleri\&. Bu sadece SSL kullanılıyorsa çıktılanır\&.
.TP
Document Path
Komut satırı dizgesinden çözümlenen isteğin URI'si\&.
.TP
Document Length
Başarıyla döndürülen ilk belgenin bayt cinsinden uzunluğu\&. Eğer belge uzunluğu sınama sırasında değişirse yanıt bir hata içerecektir\&.
.TP
Concurrency Level
Sınama sırasında kullanılan eşzamanlı istemcilerin sayısı\&.
.TP
Time taken for tests
İlk soket bağlantısının alındığı andan son yanıtın alındığı ana kadar geçen süre\&.
.TP
Complete requests
Alınan başarılı yanıtların sayısı\&.
.TP
Failed requests
Başarısızlık olarak addedilen isteklerin sayısı\&. Sayı sıfırdan büyükse, diğer satırda, bağlanma, okuma, yanlış içerik uzunluğu, istisnalar gibi sebeplerle başarısız olmuş istekler gösterilir\&.
.TP
Write errors
Başarısız yazma hatalarının (kırık boru) sayısı\&.
.TP
Non-2xx responses
200 serisi yanıt kodları ile açıklanamayan yanıtların sayısı\&. Tüm yanıtlar 200 olursa bu alan çıktılanmaz\&.
.TP
Keep-Alive requests
Keep-Alive isteklerinde sonuçlanan bağlantı sayısı\&.
.TP
Total body sent
Sınamanın parçası olarak veri gönderimi yapılandırılmışsa, bu sınama sırasında gönderilen toplam bayt sayısıdır\&. Sınama sırasında gövde gönderilmiyorsa bu alan çıktılanmaz\&.
.TP
Total transferred
Sunucudan alınan toplam bayt sayısı\&. Bu sayı aslında hattan gönderilen bayt sayısıdır\&.
.TP
HTML transferred
Sunucudan alınan belge baytlarının sayısı\&. Bu sayı HTTP başlıklarının bayt sayısını içermez\&.
.TP
Requests per second
Saniyedeki istek sayısı\&. İstek sayısının toplam süreye oranıdır\&.
.TP
Time per request
İstek başına harcanan süre\&. İlk değer eşzamanlılık * süre * 1000 / biten formülüyle hesaplanırken ikincisi için süre * 1000 / biten formülü kullanılır\&.
.TP
Transfer rate
okunantoplam / 1024 / süre formülüyle hesaplanan aktarım hızı\&.
.SH "BÖRTÜ BÖCEK"
.PP
Duruk bildirimli sabit uzunlukta çeşitli tamponlar vardır\&. Sunucudan gelen yanıt başlıkları ve diğer harici girdiler, komut satırı argümanları ile birlikte basitçe çözümlenir, bu size can sıkıcı gelebilir\&.
.PP
HTTP/1\&.x protokolünü tamamen gerçeklemez; sadece yanıtların 'belli başlı' bazı biçimlerini kabul eder\&. Aksi takdirde, \fBstrstr\fR(3) işlevinin yoğun kullanımı nedeniyle sunucu yerine \fBab\fR'nin başarımını ölçerdiniz\&.
httpd-2.4.64/docs/man/tr/apxs.1 0000664 0001751 0001751 00000027400 12203356434 016014 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "APXS" 1 "2013-08-16" "Apache HTTP Sunucusu" "apxs"
.nh
.SH İSİM
apxs \- Apache Eklenti Aracı
.SH "KULLANIM"
.PP
\fBapxs\fR -\fBg\fR [ -\fBS\fR \fIisim=değer\fR ] -\fBn\fR \fImodüladı\fR
.PP
\fBapxs\fR -\fBq\fR [ -\fBv\fR ] [ -\fBS\fR \fIisim=değer\fR ] \fIsorgu\fR \&.\&.\&.
.PP
\fBapxs\fR -\fBc\fR [ -\fBS\fR \fIisim=değer\fR ] [ -\fBo\fR \fIdso-dosyası\fR ] [ -\fBI\fR \fIinclude-dizini\fR ] [ -\fBD\fR \fIisim=değer\fR ] [ -\fBL\fR \fIlib-dizini\fR ] [ -\fBl\fR \fIkütüphane-adı\fR ] [ -\fBWc,\fR\fIderleyici-seçenekleri\fR ] [ -\fBWl,\fR\fIilintileyici-seçenekleri\fR ] [ -\fBp\fR ] \fIdosya\fR \&.\&.\&.
.PP
\fBapxs\fR -\fBi\fR [ -\fBS\fR \fIisim=değer\fR ] [ -\fBn\fR \fImodüladı\fR ] [ -\fBa\fR ] [ -\fBA\fR ] \fIdso-dosyası\fR \&.\&.\&.
.PP
\fBapxs\fR -\fBe\fR [ -\fBS\fR \fIisim=değer\fR ] [ -\fBn\fR \fImodüladı\fR ] [ -\fBa\fR ] [ -\fBA\fR ] \fIdso-dosyası\fR \&.\&.\&.
.SH "ÖZET"
.PP
\fBapxs\fR, Apache Hiper Metin Aktarım Protokolü (HTTP) sunucusu için ek modül derleme ve kurulum aracıdır\&. Bu araç sayesinde, bir veya daha fazla kaynak veya nesne \fIdosya\fRsından bir devingen paylaşımlı nesne (DSO - "Dynamic Shared Object" kısaltması) derlemek ve bu nesneyi (modülü) Apache sunucusuna çalışma anında \fBmod_so\fR modülünün \fBLoadModule\fR yönergesi üzerinden yüklemek mümkün olmaktadır\&.
.PP
Bu eklenti mekanizmasını platformunuzda kullanmak için DSO desteğinin olması ve \fBhttpd\fR programının \fBmod_so\fR modülünü içerecek şekilde derlenmiş olması gerekir\&. Eğer bunlar mevcut değilse \fBapxs\fR aracı durumu size bildirecektir\&. Bunu aşağıdaki komutla kendiniz de sınayabilirsiniz:
.nf
$ httpd -l
.fi
.PP
\fBmod_so\fR modülü gösterilen listede yer almalıdır\&. Bu gereksinimler sağlandığı takdirde \fBapxs\fR aracı sayesinde DSO mekanizması üzerinden kendi modüllerinizi kurmak suretiyle Apache sunucunuzun işlevselliğini kolayca arttırabilirsiniz\&. Örnek bir uygulama:
.nf
$ apxs -i -a -c mod_foo\&.c
gcc -fpic -DSHARED_MODULE -I/dosya/yolu/apache/include -c mod_foo\&.c
ld -Bshareable -o mod_foo\&.so mod_foo\&.o
cp mod_foo\&.so /dosya/yolu/apache/modules/mod_foo\&.so
chmod 755 /dosya/yolu/apache/modules/mod_foo\&.so
[`foo' modülü /dosya/yolu/apache/etc/httpd\&.conf'ta etkinleştiriliyor]
$ apachectl restart
/dosya/yolu/apache/sbin/apachectl restart: httpd not running, trying to start
[Tue Mar 31 11:27:55 1998] [debug] mod_so\&.c(303): loaded module foo_module
/dosya/yolu/apache/sbin/apachectl restart: httpd started
$ _
.fi
.PP
\fIdosya\fR olarak bir C kaynak dosyası (\&.c), bir nesne dosyası (\&.o) ve hatta bir kütüphane arşivi archive (\&.a) belirtebilirsiniz\&. \fBapxs\fR aracı bu dosya uzantılarını tanıdığından C dosyalarını derleme işleminden, arşiv ve nesne dosyalarını ise doğrudan ilintileme işleminden geçirir\&. Fakat böyle önceden derlenmiş nesne dosyalarını kullanırken, devingen paylaşımlı nesne olarak kullanılmalarını sağlamak üzere konumdan bağımsız kod (PIC) üretecek şekilde derlenmiş olduklarından emin olmalısınız\&. Örneğin GCC'yi bunun için daima \fB-fpic\fR seçeneği ile kullanmalısınız\&. Diğer C derleyiciler için, \fBapxs\fR'in nesne dosyalarını derlerken kullanacağı seçenekleri öğrenmek için o derleyicilerin kılavuz sayfalarına bakınız\&.
.PP
Apache'deki DSO desteği ile ilgili daha ayrıntılı bilgi edinmek için \fBmod_so\fR belgesini okumakla yetinmeyip src/modules/standard/mod_so\&.c kaynak dosyasını da okuyunuz\&.
.SH "SEÇENEKLER"
.SS "Ortak Seçenekler"
.TP
\fB-n\fR \fImodüladı\fR
\fB-i\fR (kurulum) ve \fB-g\fR (şablon üretimi) seçenekleri için modül ismi belirtmek amacıyla kullanılır\&. Bir modül ismi belirtmek için bu seçeneği kullanın\&. \fB-g\fR seçeneği için bu gereklidir\&. \fB-i\fR seçeneği için ise araç, modül ismini kaynağın ismine bakarak veya (son çare olarak) dosya isminden tahmin etmeye çalışarak saptamaya çalışır\&.
.SS "Sorgu Seçenekleri"
.TP
\fB-q\fR \fIsorgu\fR
httpd'yi derlemekte kullanılacak değişkenler ve ortam ayarları için bir sorgu gerçekleştirir\&. When invoked without \fIsorgu\fR belirtilmeksizin çağrıldığında, bilinen değişkenleri değerleriyle birlikte basar\&. İsteğe bağlı \fB-v\fR seçeneği liste çıktısını biçemler\&. .PP Modülünüzü yükleyecek \fBhttpd\fR'yi derlemek için kullanılacak ayarları elle belirtmek için kullanılır\&. Örneğin, Apache'nin C başlık dosyalarının yerini kendi Makefile dosyalarınızın içinde şöyle belirtebilirsiniz: INC=-I`apxs -q INCLUDEDIR`
.SS "Yapılandırma Seçenekleri"
.TP
\fB-S\fR \fIisim=değer\fR
Bu seçenek yukarıda açıklanan \fBapxs\fR ayarlarını değiştirir\&.
.SS "Şablon Üretme Seçenekleri"
.TP
\fB-g\fR
\fImodüladı\fR (\fB-n\fR seçeneğine bakınız) adında bir alt dizin oluşturur ve içine iki dosya yerleştirir: Kendi modülünüzü oluşturabilmeniz için veya \fBapxs\fR mekanizmaları ile hemen oynamaya başlayabilmeniz için mod_\fImodüladı\fR\&.c adında bir modül kaynak dosyası örneği ve bu modülü derleyip kurmayı kolaylaştırmak için bir Makefile dosyası\&.
.SS "DSO Derleme Seçenekleri"
.TP
\fB-c\fR
Bu seçenek derleme yapılacağını belirtir\&. Önce belirtilen C kaynak \fIdosyalar\fRını (\&.c), nesne dosyalarını (\&.o) elde etmek için derler\&. Sonra bunları kalan nesne dosyaları (\&.o ve \&.a) ile ilintileyerek \fIdso-dosyası\fR adında bir devingen paylaşımlı nesne oluşturur\&. Eğer \fB-o\fR seçeneği ile modül ismi belirtilmemişse \fIdosyalar\fR arasındaki ilk dosyanın ismine bakarak dosya ismi tahmin edilmeye çalışılır ve mod_\fIisim\fR\&.so dosya adı bu isimden elde edilir\&.
.TP
\fB-o\fR \fIdso-dosyası\fR
Oluşturulacak devingen paylaşımlı nesnenin ismini belirtmek için kullanılır\&. Modül ismi bu seçenekle belirtilmez ve \fIdosya\fR listesinden bir isim tahmini de yapılamazsa son çare olarak mod_unknown\&.so ismi kullanılır\&.
.TP
\fB-D\fR \fIisim=değer\fR
Bu seçenek doğrudan derleme komutlarına aktarılır\&. Bu seçeneği derleme işlemine kendi tanımlarınızı belirtmek için kullanın\&.
.TP
\fB-I\fR \fIinclude-dizini\fR
Bu seçenek doğrudan derleme komutlarına aktarılır\&. Bu seçeneği derleme işleminde kullanılmak üzere kendi başlık dosyalarınızı içeren dizinleri arama yollarına eklemek için kullanın\&.
.TP
\fB-L\fR \fIlib-dizini\fR
Bu seçenek doğrudan derleme komutlarına aktarılır\&. Bu seçeneği derleme işleminde kullanılmak üzere kendi kütüphane dizinlerinizi arama yollarına eklemek için kullanın\&.
.TP
\fB-l\fR \fIkütüphane-adı\fR
Bu seçenek doğrudan derleme komutlarına aktarılır\&. Bu seçeneği derleme işleminde kullanılmak üzere kendi kütüphanelerinizi arama yollarına eklemek için kullanın\&.
.TP
\fB-Wc\fR,\fIderleyici-seçenekleri\fR
Bu seçenek libtool --mode=compile komutuna doğrudan seçenek aktarmak için kullanılır\&. Bu seçeneği yerel derleyiciniz için gereken ek seçenekleri belirtmek için kullanın\&.
.TP
\fB-Wl\fR,\fIilintileyici-seçenekleri\fR
Bu seçenek libtool --mode=link komutuna doğrudan seçenek aktarmak için kullanılır\&. Bu seçeneği yerel ilintileyiciniz için gereken ek seçenekleri belirtmek için kullanın\&.
.TP
\fB-p\fR
Bu seçenek apxs'in apr/apr-util kütüphaneleriyle ilintilenmesini sağlar\&. apr/apr-util kütüphanelerini kullanan yardımcı uygulamaları derlerken yararlıdır\&.
.SS "DSO Kurulum ve Yapılandırma Seçenekleri"
.TP
\fB-i\fR
Kurulum işlemini belirtir ve devingen olarak paylaşımlı nesneleri sunucunun \fImodules\fR dizinine kurar\&.
.TP
\fB-a\fR
İlgili LoadModule satırını Apache'nin httpd\&.conf yapılandırma dosyasına özdevinimli olarak ekleyerek veya böyle bir satır varsa bunu etkin kılarak modülü etkinleştirir\&.
.TP
\fB-A\fR
\fBLoadModule\fR yönergesini daha sonra etkinleştirmek üzere satırın başına bir diyez imi (#) yerleştirmesi dışında \fB-a\fR seçeneği ile aynıdır\&.
.TP
\fB-e\fR
Modülü kurmaya çalışmaksızın Apache'nin httpd\&.conf yapılandırma dosyasını \fB-i\fR işlemine benzer şekilde \fB-a\fR ve \fB-A\fR seçenekleri ile düzenleme işlemini belirtir\&.
.SH "ÖRNEKLER"
.PP
Apache'nin sunucu işlevselliğini genişletmek amacıyla kullanacağınız mod_foo\&.c adında bir Apache modülünüz olduğunu varsayalım\&. Öncelikle, C kaynak dosyasını, Apache sunucusuna çalışma anında yüklenmeye uygun bir paylaşımlı nesne olarak derlemeniz gerekir\&. Bunu sağlamak için şu komutları vermelisiniz:
.nf
$ apxs -c mod_foo\&.c
/dosya/yolu/libtool --mode=compile gcc \&.\&.\&. -c mod_foo\&.c
/dosya/yolu/libtool --mode=link gcc \&.\&.\&. -o mod_foo\&.la mod_foo\&.slo
$ _
.fi
.PP
Bundan sonra, Apache yapılandırmanızın bu paylaşımlı nesneyi yüklemek için bir \fBLoadModule\fR yönergesi içermesini sağlamalısınız\&. \fBapxs\fR bu adımı basitleştirmek amacıyla, paylaşımlı nesneyi sunucunun \fImodules\fR dizinine özdevinimli olarak kurmak ve httpd\&.conf dosyasını buna uygun olarak güncellemek için bir yol sağlar\&. Bu sonuç şöyle elde edilebilir:
.nf
$ apxs -i -a mod_foo\&.la
/dosya/yolu/instdso\&.sh mod_foo\&.la /path/to/apache/modules
/dosya/yolu/libtool --mode=install cp mod_foo\&.la /dosya/yolu/apache/modules
\&.\&.\&.
chmod 755 /dosya/yolu/apache/modules/mod_foo\&.so
[`foo' modülü /dosya/yolu/apache/conf/httpd\&.conf'da etkinleştiriliyor]
$ _
.fi
.PP
Yapılandıma dosyasına (eğer yoksa) şu satır eklenir:
.nf
LoadModule foo_module modules/mod_foo\&.so
.fi
.PP
Bunu öntanımlı olarak iptal etmek isterseniz \fB-A\fR seçeneğini kullanmanız gerekir:
.nf
$ apxs -i -A mod_foo\&.c
.fi
.PP
\fBapxs\fR mekanizmalarını hızlıca denemek için örnek bir Apache modül şablonunu ve bir Makefile dosyasını şöyle oluşturabilirsiniz:
.nf
$ apxs -g -n foo
Creating [DIR] foo
Creating [FILE] foo/Makefile
Creating [FILE] foo/modules\&.mk
Creating [FILE] foo/mod_foo\&.c
Creating [FILE] foo/\&.deps
$ _
.fi
.PP
Ardından bu örnek modülü bir paylaşımlı nesne olarak derleyip Apache sunucusuna yükleyebilirsiniz:
.nf
$ cd foo
$ make all reload
apxs -c mod_foo\&.c
/dosya/yolu/libtool --mode=compile gcc \&.\&.\&. -c mod_foo\&.c
/dosya/yolu/libtool --mode=link gcc \&.\&.\&. -o mod_foo\&.la mod_foo\&.slo
apxs -i -a -n "foo" mod_foo\&.la
/dosya/yolu/instdso\&.sh mod_foo\&.la /dosya/yolu/apache/modules
/dosya/yolu/libtool --mode=install cp mod_foo\&.la /dosya/yolu/apache/modules
\&.\&.\&.
chmod 755 /dosya/yolu/apache/modules/mod_foo\&.so
[`foo' modülü /dosya/yolu/apache/conf/httpd\&.conf'ta etkinleştiriliyor]
apachectl restart
/dosya/yolu/apache/sbin/apachectl restart: httpd not running, trying to start
chmod 755 /dosya/yolu/apache/modules/mod_foo\&.so
[`foo' modülü /dosya/yolu/apache/etc/httpd\&.conf'ta etkinleştiriliyor]
apachectl restart
/dosya/yolu/apache/sbin/apachectl restart: httpd not running, trying to start
[Tue Mar 31 11:27:55 1998] [debug] mod_so\&.c(303): loaded module foo_module
/dosya/yolu/apache/sbin/apachectl restart: httpd started
$ _
.fi
httpd-2.4.64/docs/man/tr/htcacheclean.8 0000664 0001751 0001751 00000014707 12133545173 017462 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTCACHECLEAN" 8 "2013-04-17" "Apache HTTP Sunucusu" "htcacheclean"
.nh
.SH İSİM
htcacheclean \- Disk arabelleğini temizler
.SH "KULLANIM"
.PP
\fBhtcacheclean\fR [ -\fBD\fR ] [ -\fBv\fR ] [ -\fBt\fR ] [ -\fBr\fR ] [ -\fBn\fR ] [ -\fBR\fR\fIboyut\fR ] -\fBp\fR\fIyol\fR [ -\fBl\fR\fIsınır\fR | -\fBL\fR\fIlimit\fR ]
.PP
\fBhtcacheclean\fR [ -\fBn\fR ] [ -\fBt\fR ] [ -\fBi\fR ] [ -\fBP\fR\fIpiddosyası\fR ] [ -\fBR\fR\fIboyut\fR ] -\fBd\fR\fIsüre\fR -\fBp\fR\fIyol\fR [ -\fBl\fR\fIsınır\fR | -\fBL\fR\fIlimit\fR ]
.PP
\fBhtcacheclean\fR [ -\fBv\fR ] [ -\fBR\fR\fIboyut\fR ] -\fBp\fR\fIyol\fR [ -\fBa\fR ] [ -\fBA\fR ]
.PP
\fBhtcacheclean\fR [ -\fBD\fR ] [ -\fBv\fR ] [ -\fBt\fR ] [ -\fBR\fR\fIboyut\fR ] -\fBp\fR\fIyol\fR \fIurl\fR
.SH "ÖZET"
.PP
\fBhtcacheclean\fR, mod_cache_disk deposunun boyutlarını belli sınırlar içinde veya kullanımdaki dosya düğümlerinin sınırları içinde tutmak için kullanılır\&. Bu araç ya elle ya da bir artalan süreci olarak çalıştırılır\&. Artalan süreci olarak çalıştırıldığında, silinecek arabellek içeriğini tespit etmek için arabellek dizinlerine belli aralıklarla bakmak dışında uykuda olur\&. Artalan sürecini temiz olarak durdurmak için TERM veya INT sinyali göndermeniz yeterlidir\&. Elle çalıştırıldığında, silinecek arabellek içeriğini tespit etmek için arabellek dizinlerine bir kereliğine bakar\&. Bir veya daha fazla URL belirtilmesi durumunda arabellekte olanlar arabellekten silinir\&.
.SH "SEÇENEKLER"
.TP
\fB-d\fR\fI süre\fR
Artalanda çalışarak \fIsüre\fR dakikada bir arabelleği temizler\&. Bu seçenek \fB-D\fR, \fB-v\fR ve \fB-r\fR seçenekleri ile birlikte kullanılamaz\&. Artalan sürecini temiz olarak sonlandırmak için SIGTERM veya SIGINT göndermek yeterlidir\&.
.TP
\fB-D\fR
Kuru kuruya çalışıp, hiçbir şeyi silmez\&. \fB-d\fR seçeneği ile birlikte kullanılamaz\&. Kuru çalıştırma sırasında \fB-t\fR seçeneği ile dizinler silinmek istenirse, statlarda silinmiş görünen dosya düğümleri silinmiş dizinler olarak hesaba katılmaz ve tahmini olarak imlenir\&.
.TP
\fB-v\fR
Çıktı daha ayrıntılı olur\&. \fB-d\fR seçeneği ile birlikte kullanılamaz\&.
.TP
\fB-r\fR
İyice temizlik yapılır\&. Bunun için Apache HTTP sunucusunun çalışmadığı varsayılır (aksi takdirde arabellek içeriği bozulabilir)\&. \fB-t\fR seçeneğinin de uygulanmasını sağlar\&. \fB-d\fR seçeneği ile birlikte kullanılamaz\&.
.TP
\fB-n\fR
Nazik olur\&. Diğer süreçlerin yararına daha yavaş çalışır\&. (a) disk G/Ç işlemlerinde gecikmeler olursa ve (b) çekirdek bu arada başka bir süreci öne çekmişse \fBhtcacheclean\fR uyumayı tercih edecektir\&.
.TP
\fB-t\fR
Tüm boş dizinleri siler\&. Öntanımlı olarak, sadece arabellek dosyaları silinirse de bazı yapılandırmalarda büyük miktarda dizin oluşturulması bu seçeneğin kullanılmasını gerektirebilir\&. Yapılandırmanız çok sayıda dizin gerektiriyorsa ve dosya düğümlerinin veya dosya ayırma tablolarının tükenmesi sözkonusu ise bu seçeneğin kullanılması önerilir\&.
.TP
\fB-p\fR\fI yol\fR
\fIyol\fR, disk arabelleğinin kök dizini olarak belirtilir\&. CacheRoot yönergesinde belirtilen dizin olmalıdır\&.
.TP
\fB-P\fR\fIpiddosyası\fR
Artalan süreci olarak çalışmada süreç kimliğinin yazılacağı dosyanın adını belirtmek için kullanılır\&.
.TP
\fB-R\fR\fIboyut\fR
Disk bloklarının boyunu denkleştirmek için yuvarlanacak üst boyutu belirtmekte kullanılır\&. Arabellek bölümünün blok boyutunu belirler\&.
.TP
\fB-l\fR\fI sınır\fR
\fIsınır\fR, disk arabelleğinin toplam boyutu olarak belirtilir\&. Değerin öntanımlı olarak bayt cinsinden belirtileceği varsayılır\&. Değerin sonuna kilobayt için K, megabayt M, bayt için B harfi konulabilir\&.
.TP
\fB-L\fR\fIlimit\fR
Disk arabellek dosyası düğümü toplamının sınırını belirlemekte kullanılır\&.
.TP
\fB-i\fR
Akıllı olup sadece disk arabelleği değiştiği zaman çalışır\&. Bu seçenek \fB-d\fR seçeneği ile birlikte belirtilmek zorundadır\&.
.TP
\fB-a\fR
O an arabellekte saklanmakta olan URL'leri listeler\&. Birden fazla aynı URL varsa yalnız biri listelenir\&.
.TP
\fB-A\fR
O an arabellekte saklanmakta olan URL'leri öznitelikleri ile listeler\&. Öznitelikler şu sırayla verilir: url, header size, body size, status, entity version, date, expiry, request time, response time, body present, head request
.SH "BELLİ BİR URL'NİN SİLİNMESİ"
.PP
\fBhtcacheclean\fR tarafından aktarılan URL'ler arabellekten silinir\&. Bir URL birden fazla mevcutsa hepsi silinir\&.
.PP
Ters vekilli bir URL silinmişse, etkin URL \fBHost\fR başlığı \fBport\fR, \fByol\fR ve \fBsorgu\fR ile oluşturulur\&. Bir sorgu dizgesi olsun olmasın, URL içinde '?' daima açıkça belirtilmelidir\&. Örneğin, \fBlocalhost\fR sunucusundaki \fB/\fR yolu silinmek istenirse silinecek URL \fBhttp://localhost:80/?\fR olurdu\&.
.SH "ARABELLEKTEKİ URL'LERİN LİSTELENMESİ"
.PP
\fBhtcacheclean\fR'e \fB-a\fR veya \fB-A\fR seçeneğinin aktarılmasıyla, arabellekteki URL'ler bulundukça her satıra bir URL gelecek biçemde listelenir\&. \fB-A\fR seçeneği URL'nin ardından arabellek içeriğini tamamını şu sırayla dökümler:
.TP
url
Öğenin URL'si\&.
.TP
header size
Bayt cinsinden başlık uzunluğu\&.
.TP
body size
Bayt cinsinden gövde uzunluğu\&.
.TP
status
Arabellekteki yanıtın durumu\&.
.TP
entity version
Öğenin silinmeksizin kaç kere doğrulandığı\&.
.TP
date
Yanıt tarihi\&.
.TP
expiry
Yanıtın zaman aşımı tarihi\&.
.TP
request time
İsteğin başlama zamanı\&.
.TP
response time
İsteğin bitiş zamanı\&.
.TP
body present
0 ise istekle birlikte gövde saklanmaz, 1 ise saklanır\&.
.TP
head request
1 ise, öğe, gövde olmaksızın arabellekli bir HEAD isteği içerir, 0 ise içermez\&.
.SH "ÇIKIŞ DURUMU"
.PP
\fBhtcacheclean\fR, tüm işlemler başarıyla yerine getirildiğinde 0, aksi takdirde 1 döndürür\&. Bir URL belirtildiğinde, bu URL arablleklenmi ve silinmişse 0, aksi takdirde 2 döndürür\&. URL'nin silinmesi sırasında bir hata oluşursa 1 döndürür\&.
httpd-2.4.64/docs/man/tr/rotatelogs.8 0000664 0001751 0001751 00000021071 12456632712 017237 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "ROTATELOGS" 8 "2015-01-18" "Apache HTTP Sunucusu" "rotatelogs"
.nh
.SH İSİM
rotatelogs \- Apache günlüklerini döndürmek için borulu günlük kayıt programı
.SH "KULLANIM"
.PP
\fBrotatelogs\fR [ -\fBl\fR ] [ -\fBL\fR \fIisim\fR ] [ -\fBp\fR \fIprogram\fR ] [ -\fBf\fR ] [ -\fBt\fR ] [ -\fBv\fR ] [ -\fBe\fR ] [ -\fBc\fR ] [ -\fBn\fR \fIdosya_sayısı\fR ] \fIdosyaismi\fR \fIsüre\fR|\fIboyut\fR(B|K|M|G) [ \fIsaat_farkı\fR ]
.SH "ÖZET"
.PP
\fBrotatelogs\fR, Apache'nin borulu günlük dosyaları özelliği ile birlikte kullanmak için tasarlanmış basit bir programdır\&. Günlük dosyasının azami boyutuna göre veya belli aralıklarla günlük dosyalarını döndürür\&.
.SH "SEÇENEKLER"
.TP
\fB-l\fR
GMT yerine yerel zamanın kullanılmasını sağlar\&.
.TP
\fB-L\fR \fIbagismi\fR
Belirtilen bağ dosyası ismine geçerli günlük dosyasından kalıcı bir bağ oluşturulur\&. tail -F bagismi gibi bir komut kullanılarak günlüğün sürekli izlenmesi için kullanılabilir\&.
.TP
\fB-p\fR \fIprogram\fR
Belirtildiği takdirde, \fBrotatelogs\fR yeni bir günlük dosyasının her açılışında belirtilen programı çalıştırır\&. Yeni açılan dosyanın ismi programa ilk argüman olarak aktarılır\&. Bu işlem bir döndürme sonrası yapılırsa eski günlük dosyası ikinci argüman olarak aktarılır\&. \fBrotatelogs\fR işlemini sürdürmek için belirtilen programın sonlanmasını beklemez, dolayısıyla sonlanma soucunda döndürülen hata kodunu günlüğe kaydetmez\&. Çalıştırılan program \fBrotatelogs\fR ile aynı stdin, stdout ve stderr'i kullanır ve ortamı da miras alır\&.
.TP
\fB-f\fR
İlk günlük giridisinin okunmasını beklemeden \fBrotatelogs\fR başlar başlamaz günlük dosyasının açılmasını sağlar\&. Çok meşgul sitelerde, sunucu başlatılıp ilk istek sunuluncaya kadar geçen zamanda günlük dosyasının yokluğu özdevinimli işlemler yapan bazı günlükleme araçlarında sorunlara yol açabilir\&. Bu seçenek bu gibi durumlarda yararlıdır\&.
.TP
\fB-t\fR
Günlük dosyasının döndürülmek yerine tepeden kırpılmasına sebep olur\&. Günlüğün \fBtail\fR gibi bir araç tarafından gerçek zamanda işlendiği ve veriyi saklamanın gerekmediği durumda kullanışlıdır\&. Dosya ismine bir sonek eklenmez, ancak biçem dizgesi '%' karakteri içeriyorsa buna uyulur\&.
.TP
\fB-v\fR
Standart hataya verilen çıktı daha ayrıntılı olur\&. Çıktı, yapılandırma çözümlemesinin sonuçlarını ve tüm dosya açma/kapama işlemlerini içerir\&.
.TP
\fB-e\fR
Günlüğü standart çıktıya basar\&. Günlüğün zincirdeki ilgili araç tarafından gerçek zamanda işlenmesi gerektiğinde kullanışlıdır\&.
.TP
\fB-c\fR
Create log file for each interval, even if empty\&.
.TP
\fB-n\fR \fIdosya_sayısı\fR
Zaman damgalarına bakılmaksızın bir dosya serisi açılır\&. Örneğin -n3 belirtilirse "logfile", "logfile\&.1", "logfile\&.2" serisi açılır ve "logfile" üzerine yazılır\&. 2\&.4\&.5 ve sonraki sürümler içindir\&.
.TP
\fIdosyaismi\fR
.PP Günlük dosyasının ismi yoluyla birlikte belirtilir\&. \fIdosyaismi\fR '%' karakterleri içeriyorsa bunlar strftime(3) biçem belirteçleri olarak ele alınır\&. Aksi takdirde, özdevinimli olarak \fI\&.nnnnnnnnnn\fR uzantısı üretilir\&. (\fB-t\fR seçeneği kullanılmadıkça) Uzantı saniye cinsindendir ve her iki durumda da bu değer, mevcut döngü diliminin başlangıcına göre hesaplanır\&. Örneğin, döndürmenin 86400 saniyede bir yapılacağı belirtilmişse, strftime(3) biçeminde oluşturulan saat, dakika ve saniye alanları, 24 saatlik sürenin başlangıcını (geceyarısı) göstermek üzere sıfırlarla doldurulur\&. .PP strftime(3) dosyaismi biçemlemesi kullanılırken, günlük dosyası biçeminin günlük dosyası döndürülürken her zaman farklı bir dosya ismi üretecek yeterlilikte parçacıklı yapıya sahip olduğundan emin olmalısınız\&. Aks takdirde döndürme işlemi yeni bir dosya başlatmak yerine hep aynı dosyanın üzerine yazar\&. Örneğin, \fIlogfile\fR için /var/log/errorlog\&.%Y-%m-%d belirtilmişse 5 mega baytta bir yeni bir günlük dosyasına başlanacaktır\&. Fakat 5 megabayta gün içinde iki kez ulaşılırsa aynı günlük dosyası üretilir ve günlük hep aynı dosyanın üzerine yazılır\&.
.TP
\fIsüre\fR
Günlük dosyasının yenisinin kaç saniyede bir açılacağı belirtilir\&. Örneğin, bu süre 3600 saniye ise günlük dosyası her saat başında yenilenir; 86400 saniye ise her geceyarısı yenilenir\&. (Bu süre zarfında günlüğe kaydedilecek bir olay gerçekleşmemişse dosya oluşturulmaz\&.)
.TP
\fIboyut\fR(B|K|M|G)
Boyuta göre döndürme için azami dosya boyutu\&. Belirtilenin bir süre değil de bir boyut değeri olarak ele alınması için değerin sonuna şu karakterlerden biri eklenmelidir: B (Bayt), K (kilobayt), M (megabayt), G (gigabayt)\&. .PP Süre ve boyut birlikte belirtilmişse boyut süreden sonra belirtilmelidir\&. Dosya yenilemesi, bunlardan hangisi daha önce aşılırsa o zaman gerçekleşir\&.
.TP
\fIsaat_farkı\fR
Koordinatlı evrensel zamana göre "dakika" farkı\&. Belirtilmezse, sıfır öntanımlıdır\&. Örneğin, -5 saatlik bir zaman diliminde bulunuyorsanız bu değer -300 olmalıdır\&. Çoğu durumda, bunun yerine \fB-l\fR seçeneğini kullanmak gerekir\&.
.SH "ÖRNEKLER"
.nf
CustomLog "|bin/rotatelogs /var/log/logfile 86400" common
.fi
.PP
nnnn, günlük kaydının başladığı sistem zamanı olmak üzere /var/log/logfile\&.nnnn dosyası oluşturulur\&. Bu zaman, daima döngü süresinin katları olacağından bunu cron betiklerinizi eşzamanlamakta kullanabilirsiniz\&. Her döngü süresinin sonunda (burada 24 saat sonra) yeni bir günlük dosyası açılır\&.
.nf
CustomLog "|bin/rotatelogs -l /var/log/logfile\&.%Y\&.%m\&.%d 86400" common
.fi
.PP
yyyy, yıl; mm, ay; dd, ayın gününü belirtmek üzere /var/log/logfile\&.yyyy\&.mm\&.dd dosyası oluşturulur\&. Her gün yerel zamanla geceyarısı yeni bir günlük dosyasına geçilecektir\&.
.nf
CustomLog "|bin/rotatelogs /var/log/logfile 5M" common
.fi
.PP
Günlük dosyası 5 megabaytlık olunca yenisinin oluşturulmasını sağlar\&.
.nf
ErrorLog "|bin/rotatelogs /var/log/errorlog\&.%Y-%m-%d-%H_%M_%S 5M"
.fi
.PP
Hata günlüğünün 5 megabaytta bir errorlog\&.YYYY-mm-dd-HH_MM_SS biçemli bir isimle oluşturulmasını sağlar\&.
.nf
CustomLog "|bin/rotatelogs -t /var/log/logfile 86400" common
.fi
.PP
/var/log/logfile dosyasını oluşturur, sunucu başlatılırken ve günde bir kere dosyanın tepesi kırpılır\&. Bu senaryoda ayrı bir sürecin (tail gibi) dosyayı gerçek zamanlı işleyeceği umulur\&.
.SH "TAŞINABİLİRLİK"
.PP
Aşağıdaki günlük dosyası biçem belirteçlerinin tüm strftime(3) gerçeklenimlerince desteklenmesi gerekir\&. Kullandığınız kütüphaneye özgü belirteçler için sisteminizdeki strftime(3) kılavuz sayfasına bakınız\&.
.Ip "\(bu \s-1%A\s0 \- tam gün ismi (yerelleştirilmiş)
.Ip "\(bu \s-1%a\s0 \- 3 harflik gün ismi (yerelleştirilmiş)
.Ip "\(bu \s-1%B\s0 \- tam ay ismi (yerelleştirilmiş)
.Ip "\(bu \s-1%b\s0 \- 3 harflik ay ismi (yerelleştirilmiş)
.Ip "\(bu \s-1%c\s0 \- tarih ve saat (yerelleştirilmiş)
.Ip "\(bu \s-1%d\s0 \- 2 haneli ay günü numarası
.Ip "\(bu \s-1%H\s0 \- 2 haneli saat (24 saatlik)
.Ip "\(bu \s-1%I\s0 \- 2 haneli saat (12 saatlik)
.Ip "\(bu \s-1%j\s0 \- 3 hanelik yıl günü numarası
.Ip "\(bu \s-1%M\s0 \- 2 haneli dakika
.Ip "\(bu \s-1%m\s0 \- 2 haneli ay
.Ip "\(bu \s-1%p\s0 \- 12 saatlik kip için öö/ös (yerelleştirilmiş)
.Ip "\(bu \s-1%S\s0 \- 2 haneli saniye
.Ip "\(bu \s-1%U\s0 \- 2 haneli yılın hafta numarası (Haftanın ilk gününün Pazar olduğu varsayımıyla)
.Ip "\(bu \s-1%W\s0 \- 2 haneli yılın hafta numarası (Haftanın ilk gününün Pazartesi olduğu varsayımıyla)
.Ip "\(bu \s-1%w\s0 \- 1 hanelik haftanın gün numarası (Haftanın ilk gününün Pazar olduğu varsayımıyla)
.Ip "\(bu \s-1%X\s0 \- saat (yerelleştirilmiş)
.Ip "\(bu \s-1%x\s0 \- tarih (yerelleştirilmiş)
.Ip "\(bu \s-1%Y\s0 \- 4 hanelik yıl
.Ip "\(bu \s-1%y\s0 \- 2 hanelik yıl
.Ip "\(bu \s-1%Z\s0 \- zaman dilimi ismi
.Ip "\(bu \s-1%%\s0 \- `%' iminin kendisi
httpd-2.4.64/docs/man/tr/fcgistarter.8 0000664 0001751 0001751 00000001736 12243525621 017371 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "FCGİSTARTER" 8 "2013-11-22" "Apache HTTP Sunucusu" "fcgistarter"
.nh
.SH İSİM
fcgistarter \- Bir FastCGI programını çalıştır
.SH "KULLANIM"
.PP
\fBfcgistarter\fR -\fBc\fR \fIkomut\fR -\fBp\fR \fIport\fR [ -\fBi\fR \fIarabirim\fR ] -\fBN\fR \fIsayı\fR
.SH "ÖZET"
.PP
.SH "BİLGİNİZE"
.PP
Şimdilik sadece Unix sistemlerinde çalışmaktadır\&.
.SH "SEÇENEKLER"
.TP
\fB-c\fR \fIkomut\fR
Çalıştırılacak FastCGI programı
.TP
\fB-p\fR \fIport\fR
Programın dinleyeceği port
.TP
\fB-i\fR \fIarabirim\fR
Programın dinleyeceği arabirim
.TP
\fB-N\fR \fIsayı\fR
Program örneklerinin sayısı
httpd-2.4.64/docs/man/tr/logresolve.1 0000664 0001751 0001751 00000002732 12133545173 017225 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "LOGRESOLVE" 1 "2013-04-17" "Apache HTTP Sunucusu" "logresolve"
.nh
.SH İSİM
logresolve \- Apache günlük dosyalarındaki IP adreslerini konak isimlerine dönüştürür
.SH "KULLANIM"
.PP
\fBlogresolve\fR [ -\fBs\fR \fIdosyaismi\fR ] [ -\fBc\fR ] < \fIgünlük_dosyası\fR > \fIyeni_günlük_dosyası\fR
.SH "ÖZET"
.PP
\fBlogresolve\fR, Apache'nin erişim günlüklerindeki IP adreslerini çözümlemek için bir ardıl işlem uygulamasıdır\&. İsim sunucunuza bindirdiği yükü en aza indirmek için \fBlogresolve\fR kendi arabelleğinde oluşturduğu eşleme tablosunu kullanır\&.
.PP
Apache günlük dosyasını standart girdisinden okur\&. IP adresleri günlük dosyası satırlarında ilk bileşen olmalı ve sonraki bileşenlerden bir boşluk ile ayrılmalıdır\&.
.SH "SEÇENEKLER"
.TP
-s \fIdosyaismi\fR
İstatistiklerin kaydedileceği dosyanın ismi belirtilir\&.
.TP
-c
\fBlogresolve\fR uygulamasının bazı DNS sorguları yapmasına sebep olur: IP adresine karşılık olan konak ismini bulduktan sonra özgün adresle karşılaştırmak için bu konak ismine karşılık gelen IP adresini sorgular\&.
httpd-2.4.64/docs/man/tr/htdigest.1 0000664 0001751 0001751 00000004261 12133545173 016656 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTDİGEST" 1 "2013-04-17" "Apache HTTP Sunucusu" "htdigest"
.nh
.SH İSİM
htdigest \- Özet kimlik doğrulama dosyalarını yönetir
.SH "KULLANIM"
.PP
\fBhtdigest\fR [ -\fBc\fR ] \fIparola-dosyası\fR \fIbölge\fR \fIkullanıcı\fR
.SH "ÖZET"
.PP
\fBhtdigest\fR, HTTP kullanıcılarının digest türü kimlik doğrulaması için kullanıcı isimlerinin ve parolalarının saklanmasında kullanılacak düz metin dosyalarını oluşturmak ve güncellemek için kullanılır\&. Apache HTTP sunucusunun mevcut özkaynaklarının kullanımı sadece \fBhtdigest\fR tarafından oluşturulan dosyalarda listelenmiş kullanıcılara tahsis edilebilir\&.
.PP
Bu kılavuz sayfası sadece komut satırı değiştirgelerini listeler\&. Kullanıcı kimlik doğrulamasını \fBhttpd\fR'de yapılandırmak için gerekli yönergelerle ilgili ayrıntılar için Apache dağıtımının bir parçası olan ve http://httpd\&.apache\&.org/ adresinde de bulunan Apache HTTP Sunucusu Belgelerine bakınız\&.
.SH "SEÇENEKLER"
.TP
\fB-c\fR
\fIparola-dosyası\fR oluşturur\&. Dosya mevcutsa, dosya silinip yeniden yazılır\&.
.TP
\fIparola-dosyası\fR
Kullanıcı ismi, parola ve bölge bilgilerini içeren dosyanın ismi\&. \fB-c\fR seçeneği verilmişse ve dosya mevcut değilse oluşturulur, dosya mevcutsa silinip yeniden oluşturulur\&.
.TP
\fIbölge\fR
Kullanıcının mensup olduğu bölge ismi\&. Daha fazla bilgi için: http://tools\&.ietf\&.org/html/rfc2617#section-3\&.2\&.1
.TP
\fIkullanıcı\fR
\fIparola-dosyası\fR'nda oluşturulacak veya güncellenecek kullanıcı ismi\&. \fIkullanıcı\fR bu dosyada mevcut değilse yeni bir girdi eklenir\&. Girdi mevcutsa parolası değiştirilir\&.
.SH "GÜVENLİK DEĞERLENDİRMELERİ"
.PP
Bu program bir setuid çalıştırılabiliri olarak güvenilir olmadığından \fIsetuid yapılmamalıdır\fR\&.
httpd-2.4.64/docs/man/tr/htdbm.1 0000664 0001751 0001751 00000022622 12133545173 016142 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTDBM" 1 "2013-04-17" "Apache HTTP Sunucusu" "htdbm"
.nh
.SH İSİM
htdbm \- DBM parola veritabanlarını yönetir
.SH "KULLANIM"
.PP
\fBhtdbm\fR [ -\fBT\fR\fIVTtürü\fR ] [ -\fBi\fR ] [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIbedel\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIparola-dosyası\fR \fIkullanıcı\fR
.PP
\fBhtdbm\fR -\fBb\fR [ -\fBT\fR\fIVTtürü\fR ] [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIbedel\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIparola-dosyası\fR \fIkullanıcı\fR \fIparola\fR
.PP
\fBhtdbm\fR -\fBn\fR [ -\fBi\fR ] [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIbedel\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIkullanıcı\fR
.PP
\fBhtdbm\fR -\fBnb\fR [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIbedel\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIkullanıcı\fR \fIparola\fR
.PP
\fBhtdbm\fR -\fBv\fR [ -\fBT\fR\fIVTtürü\fR ] [ -\fBi\fR ] [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIbedel\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIparola-dosyası\fR \fIkullanıcı\fR
.PP
\fBhtdbm\fR -\fBvb\fR [ -\fBT\fR\fIVTtürü\fR ] [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIbedel\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIparola-dosyası\fR \fIkullanıcı\fR \fIparola\fR
.PP
\fBhtdbm\fR -\fBx\fR [ -\fBT\fR\fIVTtürü\fR ] \fIparola-dosyası\fR \fIkullanıcı\fR
.PP
\fBhtdbm\fR -\fBl\fR [ -\fBT\fR\fIVTtürü\fR ]
.SH "ÖZET"
.PP
\fBhtdbm\fR, mod_authn_dbm üzerinden HTTP kullanıcılarının temel kimlik doğrulaması için kullanıcı isimlerinin ve parolalarının saklanmasında kullanılacak DBM dosyalarını yönetmek için kullanılır\&. DBM dosyaları hakkında daha ayrıntılı bilgi edinmek için \fBdbmmanage\fR sayfasına bakınız\&.
.SH "SEÇENEKLER"
.TP
\fB-b\fR
Betik kipi; parola için istek yapmak yerine parola komut satırından verilir\&. \fBParola komut satırında görünür\fR olacağından çok dikkatli kullanmak gerekir\&. Betik kullanımı için \fB-i\fR seçeneğine bakınız\&.
.TP
\fB-i\fR
Parolayı doğrulamaksızın standart girdiden okur (betik kullanımı için)\&.
.TP
\fB-c\fR
\fIparola-dosyası\fR oluşturur\&. Dosya mevcutsa, dosya silinip yeniden yazılır\&. Bu seçenek \fB-n\fR seçeneği ile birlikte kullanılamaz\&.
.TP
\fB-n\fR
Sonuçları veritabanında güncellemek yerine standart çıktıya gönderir\&. \fIparola-dosyası\fR belirtilmediğinden, bu seçenek komut satırı sözdizimini değiştirir\&. Bu seçenek \fB-c\fR seçeneği ile birlikte kullanılamaz\&.
.TP
\fB-m\fR
Parolalar için MD5 şifrelemesi kullanılır\&. Windows ve Netware için bu öntanımlıdır\&.
.TP
\fB-B\fR
Parolalar için bcrypt şifrelemesi kullanılır\&. Şu an için çok güvenli kabul edilmektedir\&.
.TP
\fB-C\fR \fIbedel\fR
Bu seçenek sadece \fB-B\fR (bcrypt şifrelemesi) seçeneği ile birlikte kullanılabilir\&. Bcrypt algoritmasına hesaplama süresini belirtir (daha yüksek değerler daha güvenlidir, öntanımlı 5, geçerli değerler: 4 - 31)\&.
.TP
\fB-d\fR
Parolaları şifrelemek için crypt() kullanılır\&. Windows, ve Netware dışında öntanımlıdır\&. \fBhtdbm\fR tarafından tüm platformlarda destekleniyor olsa da Windows ve Netware üzerinde httpd sunucusu tarafından desteklenmez\&. Bu algoritma günümüz standartlarında \fBgüvenilmez\fR kabul edilmektedir\&.
.TP
\fB-s\fR
Parolalar için SHA şifrelemesi kullanılır\&. LDAP Dizin değişim biçemini (ldif) kullanarak Netscape sunucularına/sunucularından göçü kolaylaştırır\&. Bu algoritma günümüz standartlarında \fBgüvenilmez\fR kabul edilmektedir\&.
.TP
\fB-p\fR
Düz metin parolalar kullanılır\&. \fBhtdbm\fR tarafından tüm platformlarda destekleniyor olsa da Windows, Netware ve TPF üzerinde httpd sunucusu tarafından sadece düz metin parolalar kabul edilir\&.
.TP
\fB-l\fR
Veritabanındaki kullanıcıları açıklamalarıyla birlikte standart çıktıya gönderir\&.
.TP
\fB-v\fR
Kullanıcı adını ve parolasını doğrular\&. Program belirtilen parolanın geçerli olup olmadığını belirten bir ileti basar\&. Eğer parola geçersizse program hata kodu 3 ile çıkar\&.
.TP
\fB-x\fR
Kullanıcıyı siler\&. Kullanıcı belirtilen DBM dosyasında mevcutsa silinir\&.
.TP
\fB-t\fR
Son değiştirgenin bir açıklama olarak yorumlanmasını sağlar\&. Bu seçenek kullanıldığında komut satırının sonuna fazladan bir dizge eklenebilir\&. Bu dizge, veritabanında belirtilen kullanıcının "Comment" alanında saklanır\&.
.TP
\fIparola-dosyası\fR
DBM dosyasının ismi\&. Genellikle, \&.db, \&.pag veya \&.dir eklentisi olmaksızın belirtilir\&. \fB-c\fR seçeneği ile birlikte verilmişse ve DBM dosyası mevcut değilse dosya oluşturulur, mevcutsa dosya güncellenir\&.
.TP
\fIkullanıcı\fR
\fIparola-dosyası\fR'nda oluşturulacak veya güncellenecek kullanıcı ismi\&. \fIkullanıcı\fR bu dosyada mevcut değilse yeni bir girdi eklenir\&. Girdi mevcutsa parolası değiştirilir\&.
.TP
\fIparola\fR
Şifrelenip DBM dosyasında saklanacak düz metin parola\&. Sadece \fB-b\fR seçeneği ile kullanılır\&.
.TP
\fB-T\fR \fIVTtürü\fR
DBM dosyasının türü; SDBM, GDBM, DB, veya "default" olabilir\&.
.SH "HATALAR"
.PP
Birden fazla DBM dosya biçemi vardır ve büyük bir olasılıkla da sisteminizde bu birden fazla biçemle ilgili kütüphaneler vardır\&. SDBM, NDBM, GNU'nun GDBM projesi ve Berkeley/Sleepycat DB 2/3/4 bunların başlıcalarıdır\&. Ne yazık ki, bu kütüphanelerin her birinin dosya biçimleri farklıdır\&. Bu bakımdan, \fIdosyaismi\fR dosyasında kullanılan dosya biçeminin \fBhtdbm\fR tarafından kullanılanla aynı biçemde olduğundan emin olmalısınız\&. \fBhtdbm\fR hangi tür DBM dosyasına baktığını saptayacak yeterliliğe sahip değildir\&. Yanlış biçemli bir dosya belirtirseniz hiçbir şey dönmeyebileceği gibi, başka isimde bir DBM dosyasının oluşturulması veya daha da kötüsü üzerine yazmaya çalışıyorsanız DBM dosyasının bozulması bile olasıdır\&.
.PP
Unix sistemlerinde, kullanılan DBM dosyasının biçemini öğrenmek için \fBfile\fR programı kullanılabilir\&.
.SH "ÇIKIŞ DURUMU"
.PP
\fBhtdbm\fR, kullanıcı ismi ve parolasını DBM dosyasına başarıyla eklemiş veya güncellemişse 0, dosyalara erişirken bir sorun çıkmışsa 1, komut satırında bir sözdizimi hatası varsa 2, parola etkileşimli alınmış fakat girdi ile eşleşme sağlanamamışsa 3, işlem kesintiye uğramışsa 4, bir değer çok uzunsa 5 (kullanıcı, parola, dosya ismi veya açıklama), kullanıcı ismi kuraldışı karakter içeriyorsa (Kısıtlamalar bölümüne bakınız) 6 ve dosya geçerli bir DBM parola dosyası değilse 7 değeriyle döner\&.
.SH "ÖRNEKLER"
.nf
htdbm /usr/local/etc/apache/\&.htdbm-users jsmith
.fi
.PP
jsmith kullanıcısı için parolayı ekler veya değiştirir\&. Parolayı vermesi için kullanıcıya parola isteği yapılır\&. Windows üzerinde çalıştırılırsa parola Apache MD5 algoritması ile şifrelenir, aksi takdirde sistemin crypt() yordamı kullanılır\&. Dosya mevcut değilse \fBhtdbm\fR beklenen hiçbir işlemi yapmadan bir hata vererek çıkar\&.
.nf
htdbm -c /home/doe/public_html/\&.htdbm jane
.fi
.PP
Yeni bir dosya oluşturur ve kullanıcı jane için kaydı bir girdi olarak bu dosyaya yazar\&. Dosya mevcutsa fakat okunamıyor veya yazılamıyorsa dosyada bir değişiklik yapılmaz ve \fBhtdbm\fR bir ileti gösterip bir hata durumu ile çıkar\&.
.nf
htdbm -mb /usr/web/\&.htdbm-all jones Pwd4Steve
.fi
.PP
Komut satırından verilen parolayı (Pwd4Steve) MD5 algoritmasıyla şifreler ve bunu belirtilen dosyada saklar\&.
.SH "GÜVENLİK DEĞERLENDİRMELERİ"
.PP
\fBhtdbm\fR tarafından yönetilen parola dosyalarına sunucunun URI uzayından erişilememelidir; yani dosya bir tarayıcı ile okunabilecek bir yerde bulunmamalıdır\&.
.PP
Komut satırında parolanın şifrelenmemiş olarak görünmesi sebebiyle \fB-b\fR seçeneğinin kullanımından kaçınılmasını öneriyoruz\&.
.PP
crypt() algoritması kullanılırken, parolayı şekillendirmek için parolanın ilk 8 baytının kullanılacağına dikkat ediniz\&. Eğer parola 8 bayttan uzunsa kalanlar bir uyarı verilmeksizin iptal edilir\&.
.PP
SHA şifreleme biçeminde tuz kullanılmaz; yani, bir parolanın sadece bir şifreli gösterimi olabilir\&. crypt() ve MD5 biçemleri parolanın önüne rasgele üretilmiş bir tuz dizgesi eklediklerinden sözlük saldırılarına karşı daha dayanıklıdır\&.
.PP
SHA ve crypt() biçimleri günümüz standartlarında \fBgüvenilmez\fR kabul edilmektedir\&.
.SH "KISITLAMALAR"
.PP
Windows platformunda, \fBhtdbm\fR ile şifrelenen parolalar 255 karakterden daha uzun olamaz\&. 255 karakterden sonrası kırpılır\&.
.PP
\fBhtdbm\fR tarafından kullanılan MD5 algoritması Apache yazılımına özeldir; bu algoritma ile şifrelenen parolalar başka HTTP sunucularında kullanılamayabilir\&.
.PP
Kullanıcı isimleri 255 bayttan uzun olamaz ve iki nokta imi (:) içeremez\&.
httpd-2.4.64/docs/man/tr/httpd.8 0000664 0001751 0001751 00000013200 12352211121 016150 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTTPD" 8 "2014-06-24" "Apache HTTP Sunucusu" "httpd"
.nh
.SH İSİM
httpd \- Apache Hiper Metin Aktarım Protokolü Sunucusu
.SH "KULLANIM"
.PP
\fBhttpd\fR [ -\fBd\fR \fIsunucu-kök-dizini\fR ] [ -\fBf\fR \fIyapılandırma-dosyası\fR ] [ -\fBC\fR \fIyönerge\fR ] [ -\fBc\fR \fIyönerge\fR ] [ -\fBD\fR \fIparametre\fR ] [ -\fBe\fR \fIseviye\fR ] [ -\fBE\fR \fIdosya\fR ] [ \fB-k\fR start | restart | graceful | stop | graceful-stop ] [ -\fBh\fR ] [ -\fBl\fR ] [ -\fBL\fR ] [ -\fBS\fR ] [ -\fBt\fR ] [ -\fBv\fR ] [ -\fBV\fR ] [ -\fBX\fR ] [ -\fBM\fR ] [ -\fBT\fR ]
.PP
Windows sistemlerinde, ek olarak şunlar vardır:
.PP
\fBhttpd\fR [ -\fBk\fR install | config | uninstall ] [ -\fBn\fR \fIisim\fR ] [ -\fBw\fR ]
.SH "ÖZET"
.PP
\fBhttpd\fR, Apache Hiper Metin Aktarım Protokolü (HTTP) sunucusu programıdır\&. Tek başına çalışan bir artalan süreci olarak tasarlanmıştır\&. Bu tarz kullanıldığında istekleri işleme sokmak için çocuk süreçlerden ve evrelerden oluşan bir havuz oluşturur\&.
.PP
Genelde, \fBhttpd\fR'nin doğrudan çağrılmaması gerekir\&. Unix ve benzerlerinde apachectl aracılığıyla, Windows NT, 2000 ve XP'de bir hizmet olarak, Windows 9x ve ME'de ise bir konsol uygulaması olarak çalıştırılır\&.
.SH "SEÇENEKLER"
.TP
\fB-d\fR \fIsunucu-kök-dizini\fR
\fIsunucu-kök-dizini\fR'ni ServerRoot yönergesine ilk değer olarak atar\&. Yapılandırma dosyasındaki bir ServerRoot yönergesiyle bu atama geçersiz kılınabilir\&. Bu seçenek belirtilmediği takdirde /usr/local/apache2 dizini öntanımlıdır\&.
.TP
\fB-f\fR \fIyapılandırma-dosyası\fR
Başlatma sırasında \fIyapılandırma-dosyası\fR'ndaki yönergeler kullanılır\&. Eğer \fIyapılandırma-dosyası\fR bir / ile başlamıyorsa dosyanın ServerRoot yönergesinin değerine göreli olduğu varsayılır\&. Seçenek belirtilmediği takdirde conf/httpd\&.conf öntanımlı değerdir\&.
.TP
\fB-k\fR start | restart | graceful | stop | graceful-stop
\fBhttpd\fR'yi başlatmak, durdurmak ve yeniden başlatmak için sinyal gönderir\&. Daha ayrıntılı bilgi edinmek için Apache httpd'nin Durdurulması belgesine bakınız\&.
.TP
\fB-C\fR \fIyönerge\fR
Yapılandırma \fIyönerge\fR'sini yapılandırma dosyalarını okumadan önce işleme sokar\&.
.TP
\fB-c\fR \fIyönerge\fR
Yapılandırma \fIyönerge\fR'sini yapılandırma dosyalarını okuduktan sonra işleme sokar\&.
.TP
\fB-D\fR \fIparametre\fR
Sunucu başlatılırken veya yeniden başlatılırken komutları şarta bağlı olarak işleme sokmak veya atlamak için yapılandırma dosyalarında kullanılan <IfDefine> bölümlerinde kullanılmak üzere bir yapılandırma \fIparametre\fR'si tanımlar\&. Ayrıca, -DNO_DETACH (ana sürecin çatallanmasını engellemek için), -DFOREGROUND (ana sürecin setsid() ve benzerlerinden çağrılmasını engellemek için) gibi daha az bilinen bazı başlatma parametrelerini atamakta da kullanılabilir\&.
.TP
\fB-e\fR \fIseviye\fR
Hata günlüğü seviyesi olarak LogLevel yönergesine sunucu başlatılırken \fIseviye\fR değerini atar\&. Bu seçenek, başlatma sırasındaki sorunları saptamak amacıyla hata iletilerinin ayrıntı seviyesini geçici olarak arttırmak için kullanılır\&.
.TP
\fB-E\fR \fIdosya\fR
Sunucunun başlatılması sırasında hata iletilerinin belirtilen \fIdosya\fR'ya gönderilmesini sağlar\&.
.TP
\fB-h\fR
Mevcut komut satırı seçeneklerinin kısa bir özetini çıktılar\&.
.TP
\fB-l\fR
Sunucunun içinde derlenmiş modüllerin listesini çıktılar\&. Bu liste LoadModule yönergesi kullanılarak devingen olarak yüklenen modülleri içermez\&.
.TP
\fB-L\fR
Durağan modüllerce sağlanmış yönergeleri olası değerleriyle geçerli konumlarına yerleştirerek listeler\&. Paylaşımlı modüllerce sağlanan yönergeleri listelemez\&.
.TP
\fB-M\fR
Yüklü durağan ve paylaşımlı modülleri listeler\&.
.TP
\fB-S\fR
Yapılandırma dosyasından çözümlenmiş haliyle ayarları gösterir (şu an sadece sanal konak ayarları gösterilmektedir)\&.
.TP
\fB-T\fR (2\&.3\&.8 ve sonrasında kullanılabilmektedir)
Başlatma ve yeniden başlatma sırasında belge kökü sınanmadan geçilir\&.
.TP
\fB-t\fR
Yapılandırma dosyasını sözdizimi hatalarına karşı denetler\&. Program sözdizimini denetledikten sonra sözdizimi geçerliyse 0 ile, değilse sıfırdan farklı bir değerle çıkar\&. \fB-D\fRDUMP_VHOSTS seçeneği ile birlikte kullanılmışsa ek olarak sanal konak ayrıntıları da basılır\&. \fB-D\fRDUMP_MODULES seçeneği ile ise ek olarak tüm modüller listelenir\&.
.TP
\fB-v\fR
\fBhttpd\fR sürümünü basar ve çıkar\&.
.TP
\fB-V\fR
Sürümü ve \fBhttpd\fR kurulum parametrelerini basar ve çıkar\&.
.TP
\fB-X\fR
\fBhttpd\fR hata ayıklama kipinde çalışır\&. Tek çocuk süreç başlatılır ve sunucu konsolu terketmez\&.
.PP
Aşağıdaki seçenekler sadece Windows platformunda geçerlidir:
.TP
\fB-k\fR install | config | uninstall
Parametreler bakımından sırasıyla: Apache httpd bir Windows NT hizmeti haline getirilir; başlatma seçenekleri Apache httpd hizmeti için değiştirilir; ve Apache httpd hizmeti sistemden kaldırılır\&.
.TP
\fB-n\fR \fIisim\fR
Sinyal gönderilecek Apache httpd hizmetinin \fIismi\fR\&.
.TP
\fB-w\fR
Hata durumunda konsol penceresi açık tutularak hata iletilerinin okunması sağlanır\&.
httpd-2.4.64/docs/man/tr/httxt2dbm.1 0000664 0001751 0001751 00000003452 12133545173 016764 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTTXT2DBM" 1 "2013-04-17" "Apache HTTP Sunucusu" "httxt2dbm"
.nh
.SH İSİM
httxt2dbm \- RewriteMap ile kullanmak için DBM dosyaları üretir
.SH "KULLANIM"
.PP
\fBhttxt2dbm\fR [ -\fBv\fR ] [ -\fBf\fR \fIDBM_türü\fR ] -\fBi\fR \fIkaynak_metin\fR -\fBo\fR \fIçıktı_DBM\fR
.SH "ÖZET"
.PP
\fBhttxt2dbm\fR, RewriteMap ile kullanmak için düz metin dosyalardan DBM dosyaları üretir\&.
.PP
Çıktı dosyası mevcutsa dosya kırpılmaz\&. Yeni anahtarlar eklenir, mevcutlar da güncellenir\&.
.SH "SEÇENEKLER"
.TP
\fB-v\fR
Çıktı daha ayrıntılı olur\&.
.TP
\fB-f\fR \fIDBM_türü\fR
Çıktı için kullanılacak DBM türü belirtilir\&. Belirtilmediği takdirde APR öntanımlısı kullanılır\&. Belirtilebilecek DBM türleri: GDBM dosyalar için GDBM, SDBM dosyalar için SDBM, Berkeley DB dosyalar için DB, NDBM dosyalar için NDBM, öntanımlı DBM türü için default
.TP
\fB-i\fR \fIkaynak_metin\fR
DBM dosyasının üretiminde kullanılacak girdi dosyası belirtilir\&. Bu dosya, her satırda bir kayıt bulunmak üzere her satırı şöyle biçemlenmiş olmalıdır: anahtar değer\&. Bu dosyanın biçemi ve manası ile ilgili ayrıntılar için RewriteMap yönergesinin açıklamasına bakınız\&.
.TP
\fB-o\fR \fIçıktı_DBM\fR
Çıktılanacak DBM dosyasının ismi belirtilir\&.
.SH "ÖRNEKLER"
.nf
httxt2dbm -i rewritemap\&.txt -o rewritemap\&.dbm
httxt2dbm -f SDBM -i rewritemap\&.txt -o rewritemap\&.dbm
.fi
httpd-2.4.64/docs/man/tr/dbmmanage.1 0000664 0001751 0001751 00000014256 12133545173 016763 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "DBMMANAGE" 1 "2013-04-17" "Apache HTTP Sunucusu" "dbmmanage"
.nh
.SH İSİM
dbmmanage \- DBM biçemli kullanıcı kimlik doğrulama dosyalarını yönetir
.SH "KULLANIM"
.PP
\fBdbmmanage\fR [ \fIkodlama\fR ] \fIdosyaismi\fR add|adduser|check|delete|update \fIkullanıcı\fR [ \fIşifreli_parola\fR [ \fIgrup\fR[,\fIgrup\fR\&.\&.\&.] [ \fIaçıklama\fR ] ] ]
.PP
\fBdbmmanage\fR \fIdosyaismi\fR view [ \fIkullanıcı\fR ]
.PP
\fBdbmmanage\fR \fIdosyaismi\fR import
.SH "ÖZET"
.PP
\fBdbmmanage\fR, mod_authn_dbm üzerinden HTTP kullanıcılarının temel kimlik doğrulaması için kullanıcı isimlerinin ve parolalarının saklanmasında kullanılacak DBM dosyalarını oluşturmak ve güncellemek için kullanılır\&. Apache HTTP sunucusunun mevcut özkaynaklarının kullanımı sadece \fBdbmmanage\fR tarafından oluşturulan dosyalarda listelenmiş kullanıcılara tahsis edilebilir\&. Bu program sadece, kullanıcı isimleri bir DBM dosyasında saklanmak istenirse işe yarar\&. Düz metin bir veritabanı kullanmak isterseniz \fBhtpasswd\fR sayfasına bakınız\&.
.PP
DBM parola veritabanı sağlayan diğer bir araç da \fBhtdbm\fR'dir\&.
.PP
Bu kılavuz sayfası sadece komut satırı değiştirgelerini listeler\&. Kullanıcı kimlik doğrulamasını \fBhttpd\fR'de yapılandırmak için gerekli yönergelerle ilgili ayrıntılar için Apache dağıtımının bir parçası olan ve http://httpd\&.apache\&.org/ adresinde de bulunan Apache HTTP Sunucusu Belgelerine bakınız\&.
.SH "SEÇENEKLER"
.TP
\fIdosyaismi\fR
DBM dosyasının ismi\&. Genellikle, \&.db, \&.pag veya \&.dir eklentisi olmaksızın belirtilir\&.
.TP
\fIkullanıcı\fR
İşlemleri gerçekleştirecek kullanıcı ismi\&. \fIkullanıcı\fR ismi ikinokta imi (:) içeremez\&.
.TP
\fIşifreli_parola\fR
\fBupdate\fR ve \fBadd\fR komutları için kullanılacak şifreli paroladır\&. Parolanın istenmesini sağlamak, fakat hemen ardından alanları doldurmak için bir tire imi (-) kullanabilirsiniz\&. Buna ek olarak, \fBupdate\fR komutunu kullanırken özgün parolaya dokunulmaması için bir nokta imi (\&.) kullanabilirsiniz\&.
.TP
\fIgrup\fR
Kullanıcının üyesi olduğu grup\&. Grup ismi ikinokta imi (:) içeremez\&.Kullanıcıyı bir gruba atamadan açıklama alanını doldurmak istiyorsanız bir tire imi (-) kullanabilirsiniz\&. Buna ek olarak, \fBupdate\fR komutunu kullanırken özgün gruba dokunulmaması için bir nokta imi (\&.) kullanabilirsiniz\&.
.TP
\fIaçıklama\fR
Adı ve soyadı, eposta adresi gibi kullanıcıyla ilgili bir takım bilgiler buraya yazılır\&. Sunucu bu alanı gözardı eder\&.
.SS "Kodlamalar"
.TP
\fB-d\fR
CRYPT şifrelemesi (Win32 ve Netware hariç, öntanımlı)
.TP
\fB-m\fR
MD5 şifrelemesi (Win32 ve Netware için öntanımlı)
.TP
\fB-s\fR
SHA1 şifrelemesi
.TP
\fB-p\fR
düz metin (\fIönerilmez\fR)
.SS "Komutlar"
.TP
\fBadd\fR
\fIşifreli_parola\fR'yı kullanarak \fIdosyaismi\fR dosyasına \fIkullanıcı\fR için bir girdi ekler\&. dbmmanage passwords\&.dat add rbowen foKntnEF3KSXA
.TP
\fBadduser\fR
Parola sorduktan sonra \fIdosyaismi\fR dosyasına \fIkullanıcı\fR için bir girdi ekler\&. dbmmanage passwords\&.dat adduser krietz
.TP
\fBcheck\fR
Parola sorduktan sonra belirtilen \fIkullanıcı\fR, \fIdosyaismi\fR dosyasında var mı diye bakar; varsa belirtilen parolayı kullanıcınınkiyle eşleştirmeye çalışır\&. dbmmanage passwords\&.dat check rbowen
.TP
\fBdelete\fR
\fIdosyaismi\fR dosyasından \fIkullanıcı\fR girdisini siler\&. dbmmanage passwords\&.dat delete rbowen
.TP
\fBimport\fR
Standart girdiden \fIkullanıcı\fR:\fIparola\fR satırlarını (her satırda bir tane) okur ve bunları \fIdosyaismi\fR dosyasına ekler\&. Parola şifrelenmiş olmalıdır\&.
.TP
\fBupdate\fR
Belirtilen \fIkullanıcı\fR'nın \fIdosyaismi\fR dosyasında mevcut olması dışında \fBadduser\fR komutu gibidir\&. dbmmanage passwords\&.dat update rbowen
.TP
\fBview\fR
Sadece, DBM dosyasının içeriğini gösterir\&. Bir \fIkullanıcı\fR belirtirseniz sadece o kaydı gösterir\&. dbmmanage passwords\&.dat view
.SH "HATALAR"
.PP
Birden fazla DBM dosya biçemi vardır ve büyük bir olasılıkla da sisteminizde bu birden fazla biçemle ilgili kütüphaneler vardır\&. SDBM, NDBM, GNU'nun GDBM projesi ve Berkeley DB 2 bunların başlıcalarıdır\&. Ne yazık ki, bu kütüphanelerin her birinin dosya biçimleri farklıdır\&. Bu bakımdan, \fIdosyaismi\fR dosyasında kullanılan dosya biçeminin \fBdbmmanage\fR tarafından kullanılanla aynı biçemde olduğundan emin olmalısınız\&. \fBdbmmanage\fR hangi tür DBM dosyasına baktığını saptayacak yeterliliğe sahip değildir\&. Yanlış biçemli bir dosya belirtirseniz hiçbir şey dönmeyebileceği gibi, başka isimde bir DBM dosyasının oluşturulması veya daha da kötüsü üzerine yazmaya çalışıyorsanız DBM dosyasının bozulması bile olasıdır\&.
.PP
\fBdbmmanage\fR programının başlangıcında @AnyDBM::ISA dizisi olarak tanımlanmış DBM biçem tercihlerinin bir listesi vardır\&. Berkeley DB 2 biçemini tercih ettiğimizden \fBdbmmanage\fR sistem kütüphanelerini şu sıraya göre arar: Berkeley DB 2, NDBM, GDBM ve SDBM\&. \fBdbmmanage\fR DBM dosyası hareketleri için bu sıralamaya göre bulduğu ilk kütüphaneyi kullanacaktır\&. Sıralama Perl'deki dbmopen() çağrısının kullandığından faklı olduğu gibi Perl'deki standart @AnyDBM::ISA sıralamasından da oldukça farklıdır\&. Bu bakımdan, DBM dosyalarınızı yönetmek için Perl ile yazılmış başka araçlar kullanıyorsanız, onların da bu tercih sırasını izlemesini sağlamalısınız\&. Benzer şekilde, bu dosyalara erişmek için diğer dillerde (C gibi) yazılmış programlar kullanıyorsanız bunlar için de aynı durum geçerlidir\&.
.PP
Unix sistemlerinde, kullanılan DBM dosyasının biçemini öğrenmek için \fBfile\fR programı kullanılabilir\&.
httpd-2.4.64/docs/man/tr/apachectl.8 0000664 0001751 0001751 00000011771 12133545173 017002 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "APACHECTL" 8 "2013-04-17" "Apache HTTP Sunucusu" "apachectl"
.nh
.SH İSİM
apachectl \- Apache HTTP Sunucusu Denetim Arayüzü
.SH "KULLANIM"
.PP
\fBapachectl\fR önyüz kipinde çalıştığında \fBhttpd\fR programının bütün komut satırı argümanlarını kabul edebilir\&.
.PP
\fBapachectl\fR [ \fIhttpd-argümanları\fR ]
.PP
SysV başlatma betiği kipinde ise, \fBapachectl\fR aşağıda tanımlanan basit, tek sözcüklük komutları kabul eder\&.
.PP
\fBapachectl\fR \fIkomut\fR
.SH "ÖZET"
.PP
\fBapachectl\fR Apache Hiper Metin Aktarım Protokolü (HTTP) sunucusu için bir denetim aracıdır\&. Sistem yöneticisinin Apache \fBhttpd\fR artalan sürecini denetimi altında tutabilmesine yardımcı olmak amacıyla tasarlanmıştır\&.
.PP
\fBapachectl\fR iki kipte işleyebilir\&. İlkinde, \fBhttpd\fR komutu için basit bir önyüz gibi davranarak, gerekli ortam değişkenlerini atar ve belirtilen komut satırı seçenekleriyle \fBhttpd\fR sürecini başlatır\&. İkinci kipte ise, \fBapachectl\fR bir SysV başlatma betiği olarak \fBstart\fR, \fBrestart\fR, \fBstop\fR gibi tek sözcüklük basit argümanlar alır ve bunları uygun sinyallere dönüştürerek \fBhttpd\fR'ye gönderir\&.
.PP
Eğer Apache kurulumunuzda standart dışı dosya yolları kullanmışsanız, \fBhttpd\fR programına uygun yolları atamak için \fBapachectl\fR betiğini elden geçirmelisiniz\&. Bu arada gerek gördüğünüz \fBhttpd\fR komut satırı argümanlarını da belirtebilirsiniz\&. Ayrıntılar için betik içindeki açıklamalara bakınız\&.
.PP
\fBapachectl\fR betiği başarı durumunda 0 çıkış değeri ile döner\&. Bir hata durumunda ise sıfırdan farklı bir değerle döner\&. Daha fazla bilgi için betik içindeki açıklamalara bakınız\&.
.SH "SEÇENEKLER"
.PP
Burada sadece SysV başlatma betiğine özgü seçeneklere yer verilmiştir\&. Diğer argümanlar için \fBhttpd\fR kılavuz sayfasına bakınız\&.
.TP
\fBstart\fR
Apache \fBhttpd\fR artalan sürecini başlatır\&. Zaten çalışmaktaysa bir hata verir\&. \fBapachectl -k start\fR komutuna eşdeğerdir\&.
.TP
\fBstop\fR
Apache \fBhttpd\fR artalan sürecini durdurur\&. \fBapachectl -k stop\fR komutuna eşdeğerdir\&.
.TP
\fBrestart\fR
Apache \fBhttpd\fR artalan sürecini yeniden başlatır; çalışmıyorsa çalıştırılır\&. Artalan sürecinin ölü olmadığından emin olmak için yeniden başlatmadan önce \fBconfigtest\fR seçeneği verilmiş gibi yapılandırma dosyaları sınanır\&. \fBapachectl -k restart\fR komutuna eşdeğerdir\&.
.TP
\fBfullstatus\fR
\fBmod_status\fR üzerinden tam bir durum raporu gösterir\&. Bunun çalışması için sunucuda \fBmod_status\fR etkinleştirilmiş olmalı ve sisteminizde \fBlynx\fR gibi bir metin kipi HTTP tarayıcı kurulu olmalıdır\&. Durum raporuna erişmek için kullanılacak adres betik içinde STATUSURL değişkenine atanabilir\&.
.TP
\fBstatus\fR
Özet halinde bir durum raporu gösterir\&. O an sunulmakta olan isteklerin gösterilmemesi dışında \fBfullstatus\fR seçeneği gibidir\&.
.TP
\fBgraceful\fR
Apache \fBhttpd\fR artalan sürecini \fInazikçe\fR yeniden başlatır; çalışmıyorsa çalıştırılır\&. O an hizmet sunmakta olan çocuk süreçleri hemen durdurmaması dışında normal yeniden başlatma gibidir\&. Bir yan etki olarak eski günlük dosyaları hemen kapatılmaz\&. Yani, günlük dosyalarını döndüren bir betik kullanıyorsanız yenilerini başlatmadan önce eski dosyaların tamamen kapandığından emin olmak için belli bir süre beklemeniz gerekecektir\&. Artalan sürecinin ölü olmadığından emin olmak için yeniden başlatmadan önce \fBconfigtest\fR seçeneği verilmiş gibi yapılandırma dosyaları sınanır\&. \fBapachectl -k graceful\fR komutuna eşdeğerdir\&.
.TP
\fBgraceful-stop\fR
Apache \fBhttpd\fR artalan sürecini \fInazikçe\fR durdurur\&. O an hizmet sunmakta olan çocuk süreçleri hemen durdurmaması dışında normal durdurma gibidir\&. Bir yan etki olarak eski günlük dosyaları hemen kapatılmaz\&. \fBapachectl -k graceful-stop\fR komutuna eşdeğerdir\&.
.TP
\fBconfigtest\fR
Yapılandırma dosyasında sözdizimi denetimi yapılmasını sağlar\&. Yapılandırma dosyaları çözümlenir ve bir sorun yoksa bir Syntax Ok raporu verilir fakat, bir hata varsa o hataya ilişkin ayrıntılı bilgi verilir\&. \fBapachectl -t\fR komutuna eşdeğerdir\&.
.PP
Aşağıdaki seçenek eski sürümlerde kullanılmaktaydı, fakat artık kullanılmamaktadır\&.
.TP
startssl
\fBhttpd\fR programını SSL destekli başlatmak için, yapılandırma dosyanızı ilgili yönergeleri içermesi için elden geçirmeli ve normal \fBapachectl start\fR komutunu kullanmalısınız\&.
httpd-2.4.64/docs/man/rotatelogs.8 0000664 0001751 0001751 00000023547 14401204253 016607 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "ROTATELOGS" 8 "2023-03-05" "Apache HTTP Server" "rotatelogs"
.SH NAME
rotatelogs \- Piped logging program to rotate Apache logs
.SH "SYNOPSIS"
.PP
\fB\fBrotatelogs\fR [ -\fBl\fR ] [ -\fBL\fR \fIlinkname\fR ] [ -\fBp\fR \fIprogram\fR ] [ -\fBf\fR ] [ -\fBD\fR ] [ -\fBt\fR ] [ -\fBv\fR ] [ -\fBe\fR ] [ -\fBc\fR ] [ -\fBn\fR \fInumber-of-files\fR ] \fIlogfile\fR \fIrotationtime\fR|\fIfilesize\fR(B|K|M|G) [ \fIoffset\fR ]\fR
.SH "SUMMARY"
.PP
\fBrotatelogs\fR is a simple program for use in conjunction with Apache's piped logfile feature\&. It supports rotation based on a time interval or maximum size of the log\&.
.SH "OPTIONS"
.TP
\fB-l\fR
Causes the use of local time rather than GMT as the base for the interval or for \fBstrftime(3)\fR formatting with size-based rotation\&.
.TP
\fB-L\fR \fIlinkname\fR
.PP Causes a hard link to be made from the current logfile to the specified link name\&. This can be used to watch the log continuously across rotations using a command like \fBtail -F linkname\fR\&. .PP If the linkname is not an absolute path, it is relative to \fBrotatelogs\fR' working directory, which is the ServerRoot when \fBrotatelogs\fR is run by the server\&.
.TP
\fB-p\fR \fIprogram\fR
If given, \fBrotatelogs\fR will execute the specified program every time a new log file is opened\&. The filename of the newly opened file is passed as the first argument to the program\&. If executing after a rotation, the old log file is passed as the second argument\&. \fBrotatelogs\fR does not wait for the specified program to terminate before continuing to operate, and will not log any error code returned on termination\&. The spawned program uses the same stdin, stdout, and stderr as rotatelogs itself, and also inherits the environment\&.
.TP
\fB-f\fR
Causes the logfile to be opened immediately, as soon as \fBrotatelogs\fR starts, instead of waiting for the first logfile entry to be read (for non-busy sites, there may be a substantial delay between when the server is started and when the first request is handled, meaning that the associated logfile does not "exist" until then, which causes problems from some automated logging tools)
.TP
\fB-D\fR
Creates the parent directories of the path that the log file will be placed in if they do not already exist\&. This allows \fBstrftime(3)\fR formatting to be used in the path and not just the filename\&.
.TP
\fB-t\fR
Causes the logfile to be truncated instead of rotated\&. This is useful when a log is processed in real time by a command like tail, and there is no need for archived data\&. No suffix will be added to the filename, however format strings containing '%' characters will be respected\&.
.TP
\fB-T\fR
Causes all but the initial logfile to be truncated when opened\&. This is useful when the format string contains something that will loop around, such as the day of the month\&. Available in 2\&.4\&.56 and later\&.
.TP
\fB-v\fR
Produce verbose output on STDERR\&. The output contains the result of the configuration parsing, and all file open and close actions\&.
.TP
\fB-e\fR
Echo logs through to stdout\&. Useful when logs need to be further processed in real time by a further tool in the chain\&.
.TP
\fB-c\fR
Create log file for each interval, even if empty\&.
.TP
\fB-n \fInumber-of-files\fR\fR
Use a circular list of filenames without timestamps\&. This option overwrites log files at startup and during rotation\&. With -n 3, the series of log files opened would be "logfile", "logfile\&.1", "logfile\&.2", then overwriting "logfile"\&. When this program first opens "logfile", the file will only be truncated if \fB-t\fR is also provided\&. Every subsequent rotation will always begin with truncation of the target file\&. For size based rotation without \fB-t\fR and existing log files in place, this option may result in unintuitive behavior such as initial log entries being sent to "logfile\&.1", and entries in "logfile\&.1" not being preserved even if later "logfile\&.n" have not yet been used\&. Available in 2\&.4\&.5 and later\&.
.TP
\fB\fIlogfile\fR\fR
.PP The path plus basename of the logfile\&. If \fIlogfile\fR includes any '%' characters, it is treated as a format string for \fBstrftime(3)\fR\&. Otherwise, the suffix \fI\&.nnnnnnnnnn\fR is automatically added and is the time in seconds (unless the -t option is used)\&. Both formats compute the start time from the beginning of the current period\&. For example, if a rotation time of 86400 is specified, the hour, minute, and second fields created from the \fBstrftime(3)\fR format will all be zero, referring to the beginning of the current 24-hour period (midnight)\&. .PP When using \fBstrftime(3)\fR filename formatting, be sure the log file format has enough granularity to produce a different file name each time the logs are rotated\&. Otherwise rotation will overwrite the same file instead of starting a new one\&. For example, if \fIlogfile\fR was \fB/var/log/errorlog\&.%Y-%m-%d\fR with log rotation at 5 megabytes, but 5 megabytes was reached twice in the same day, the same log file name would be produced and log rotation would keep writing to the same file\&. .PP If the logfile is not an absolute path, it is relative to \fBrotatelogs\fR' working directory, which is the ServerRoot when \fBrotatelogs\fR is run by the server\&.
.TP
\fB\fIrotationtime\fR\fR
The time between log file rotations in seconds\&. The rotation occurs at the beginning of this interval\&. For example, if the rotation time is 3600, the log file will be rotated at the beginning of every hour; if the rotation time is 86400, the log file will be rotated every night at midnight\&. (If no data is logged during an interval, no file will be created\&.)
.TP
\fB\fIfilesize\fR(B|K|M|G)\fR
The maximum file size in followed by exactly one of the letters \fBB\fR (Bytes), \fBK\fR (KBytes), \fBM\fR (MBytes) or \fBG\fR (GBytes)\&. .PP When time and size are specified, the size must be given after the time\&. Rotation will occur whenever either time or size limits are reached\&.
.TP
\fB\fIoffset\fR\fR
The number of minutes offset from UTC\&. If omitted, zero is assumed and UTC is used\&. For example, to use local time in the zone UTC -5 hours, specify a value of \fB-300\fR for this argument\&. In most cases, \fB-l\fR should be used instead of specifying an offset\&.
.SH "EXAMPLES"
.nf
CustomLog "|bin/rotatelogs /var/log/logfile 86400" common
.fi
.PP
This creates the files /var/log/logfile\&.nnnn where nnnn is the system time at which the log nominally starts (this time will always be a multiple of the rotation time, so you can synchronize cron scripts with it)\&. At the end of each rotation time (here after 24 hours) a new log is started\&.
.nf
CustomLog "|bin/rotatelogs -l /var/log/logfile\&.%Y\&.%m\&.%d 86400" common
.fi
.PP
This creates the files /var/log/logfile\&.yyyy\&.mm\&.dd where yyyy is the year, mm is the month, and dd is the day of the month\&. Logging will switch to a new file every day at midnight, local time\&.
.nf
CustomLog "|bin/rotatelogs /var/log/logfile 5M" common
.fi
.PP
This configuration will rotate the logfile whenever it reaches a size of 5 megabytes\&.
.nf
ErrorLog "|bin/rotatelogs /var/log/errorlog\&.%Y-%m-%d-%H_%M_%S 5M"
.fi
.PP
This configuration will rotate the error logfile whenever it reaches a size of 5 megabytes, and the suffix to the logfile name will be created of the form \fBerrorlog\&.YYYY-mm-dd-HH_MM_SS\fR\&.
.nf
CustomLog "|bin/rotatelogs -t /var/log/logfile 86400" common
.fi
.PP
This creates the file \fB/var/log/logfile\fR, truncating the file at startup and then truncating the file once per day\&. It is expected in this scenario that a separate process (such as tail) would process the file in real time\&.
.nf
CustomLog "|bin/rotatelogs -T /var/log/logfile\&.%d 86400" common
.fi
.PP
If the server is started (or restarted) on the first of the month, this appends to \fB/var/log/logfile\&.01\fR\&. When a log entry is written on the second of the month, \fB/var/log/logfile\&.02\fR is truncated and new entries will be added to the top\&. This example keeps approximately 1 months worth of logs without external maintenance\&.
.SH "PORTABILITY"
.PP
The following logfile format string substitutions should be supported by all \fBstrftime(3)\fR implementations, see the \fBstrftime(3)\fR man page for library-specific extensions\&.
.Ip "\(bu \s-1\fB%A\fR\s0 \- full weekday name (localized)
.Ip "\(bu \s-1\fB%a\fR\s0 \- 3-character weekday name (localized)
.Ip "\(bu \s-1\fB%B\fR\s0 \- full month name (localized)
.Ip "\(bu \s-1\fB%b\fR\s0 \- 3-character month name (localized)
.Ip "\(bu \s-1\fB%c\fR\s0 \- date and time (localized)
.Ip "\(bu \s-1\fB%d\fR\s0 \- 2-digit day of month
.Ip "\(bu \s-1\fB%H\fR\s0 \- 2-digit hour (24 hour clock)
.Ip "\(bu \s-1\fB%I\fR\s0 \- 2-digit hour (12 hour clock)
.Ip "\(bu \s-1\fB%j\fR\s0 \- 3-digit day of year
.Ip "\(bu \s-1\fB%M\fR\s0 \- 2-digit minute
.Ip "\(bu \s-1\fB%m\fR\s0 \- 2-digit month
.Ip "\(bu \s-1\fB%p\fR\s0 \- am/pm of 12 hour clock (localized)
.Ip "\(bu \s-1\fB%S\fR\s0 \- 2-digit second
.Ip "\(bu \s-1\fB%U\fR\s0 \- 2-digit week of year (Sunday first day of week)
.Ip "\(bu \s-1\fB%W\fR\s0 \- 2-digit week of year (Monday first day of week)
.Ip "\(bu \s-1\fB%w\fR\s0 \- 1-digit weekday (Sunday first day of week)
.Ip "\(bu \s-1\fB%X\fR\s0 \- time (localized)
.Ip "\(bu \s-1\fB%x\fR\s0 \- date (localized)
.Ip "\(bu \s-1\fB%Y\fR\s0 \- 4-digit year
.Ip "\(bu \s-1\fB%y\fR\s0 \- 2-digit year
.Ip "\(bu \s-1\fB%Z\fR\s0 \- time zone name
.Ip "\(bu \s-1\fB%%\fR\s0 \- literal `%'
httpd-2.4.64/docs/man/ab.1 0000664 0001751 0001751 00000024464 13357447342 015017 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "AB" 1 "2018-10-10" "Apache HTTP Server" "ab"
.SH NAME
ab \- Apache HTTP server benchmarking tool
.SH "SYNOPSIS"
.PP
\fB\fBab\fR [ -\fBA\fR \fIauth-username\fR:\fIpassword\fR ] [ -\fBb\fR \fIwindowsize\fR ] [ -\fBB\fR \fIlocal-address\fR ] [ -\fBc\fR \fIconcurrency\fR ] [ -\fBC\fR \fIcookie-name\fR=\fIvalue\fR ] [ -\fBd\fR ] [ -\fBe\fR \fIcsv-file\fR ] [ -\fBE\fR \fIclient-certificate file\fR ] [ -\fBf\fR \fIprotocol\fR ] [ -\fBg\fR \fIgnuplot-file\fR ] [ -\fBh\fR ] [ -\fBH\fR \fIcustom-header\fR ] [ -\fBi\fR ] [ -\fBk\fR ] [ -\fBl\fR ] [ -\fBm\fR \fIHTTP-method\fR ] [ -\fBn\fR \fIrequests\fR ] [ -\fBp\fR \fIPOST-file\fR ] [ -\fBP\fR \fIproxy-auth-username\fR:\fIpassword\fR ] [ -\fBq\fR ] [ -\fBr\fR ] [ -\fBs\fR \fItimeout\fR ] [ -\fBS\fR ] [ -\fBt\fR \fItimelimit\fR ] [ -\fBT\fR \fIcontent-type\fR ] [ -\fBu\fR \fIPUT-file\fR ] [ -\fBv\fR \fIverbosity\fR] [ -\fBV\fR ] [ -\fBw\fR ] [ -\fBx\fR \fI<table>-attributes\fR ] [ -\fBX\fR \fIproxy\fR[:\fIport\fR] ] [ -\fBy\fR \fI<tr>-attributes\fR ] [ -\fBz\fR \fI<td>-attributes\fR ] [ -\fBZ\fR \fIciphersuite\fR ] [http[s]://]\fIhostname\fR[:\fIport\fR]/\fIpath\fR\fR
.SH "SUMMARY"
.PP
\fBab\fR is a tool for benchmarking your Apache Hypertext Transfer Protocol (HTTP) server\&. It is designed to give you an impression of how your current Apache installation performs\&. This especially shows you how many requests per second your Apache installation is capable of serving\&.
.SH "OPTIONS"
.TP
\fB-A \fIauth-username\fR:\fIpassword\fR\fR
Supply BASIC Authentication credentials to the server\&. The username and password are separated by a single \fB:\fR and sent on the wire base64 encoded\&. The string is sent regardless of whether the server needs it (\fIi\&.e\&.\fR, has sent an 401 authentication needed)\&.
.TP
\fB-b \fIwindowsize\fR\fR
Size of TCP send/receive buffer, in bytes\&.
.TP
\fB-B \fIlocal-address\fR\fR
Address to bind to when making outgoing connections\&.
.TP
\fB-c \fIconcurrency\fR\fR
Number of multiple requests to perform at a time\&. Default is one request at a time\&.
.TP
\fB-C \fIcookie-name\fR=\fIvalue\fR\fR
Add a \fBCookie:\fR line to the request\&. The argument is typically in the form of a \fB\fIname\fR=\fIvalue\fR\fR pair\&. This field is repeatable\&.
.TP
\fB-d\fR
Do not display the "percentage served within XX [ms] table"\&. (legacy support)\&.
.TP
\fB-e \fIcsv-file\fR\fR
Write a Comma separated value (CSV) file which contains for each percentage (from 1% to 100%) the time (in milliseconds) it took to serve that percentage of the requests\&. This is usually more useful than the 'gnuplot' file; as the results are already 'binned'\&.
.TP
\fB-E \fIclient-certificate-file\fR\fR
When connecting to an SSL website, use the provided client certificate in PEM format to authenticate with the server\&. The file is expected to contain the client certificate, followed by intermediate certificates, followed by the private key\&. Available in 2\&.4\&.36 and later\&.
.TP
\fB-f \fIprotocol\fR\fR
Specify SSL/TLS protocol (SSL2, SSL3, TLS1, TLS1\&.1, TLS1\&.2, or ALL)\&. TLS1\&.1 and TLS1\&.2 support available in 2\&.4\&.4 and later\&.
.TP
\fB-g \fIgnuplot-file\fR\fR
Write all measured values out as a 'gnuplot' or TSV (Tab separate values) file\&. This file can easily be imported into packages like Gnuplot, IDL, Mathematica, Igor or even Excel\&. The labels are on the first line of the file\&.
.TP
\fB-h\fR
Display usage information\&.
.TP
\fB-H \fIcustom-header\fR\fR
Append extra headers to the request\&. The argument is typically in the form of a valid header line, containing a colon-separated field-value pair (\fIi\&.e\&.\fR, \fB"Accept-Encoding: zip/zop;8bit"\fR)\&.
.TP
\fB-i\fR
Do \fBHEAD\fR requests instead of \fBGET\fR\&.
.TP
\fB-k\fR
Enable the HTTP KeepAlive feature, \fIi\&.e\&.\fR, perform multiple requests within one HTTP session\&. Default is no KeepAlive\&.
.TP
\fB-l\fR
Do not report errors if the length of the responses is not constant\&. This can be useful for dynamic pages\&. Available in 2\&.4\&.7 and later\&.
.TP
\fB-m \fIHTTP-method\fR\fR
Custom HTTP method for the requests\&. Available in 2\&.4\&.10 and later\&.
.TP
\fB-n \fIrequests\fR\fR
Number of requests to perform for the benchmarking session\&. The default is to just perform a single request which usually leads to non-representative benchmarking results\&.
.TP
\fB-p \fIPOST-file\fR\fR
File containing data to POST\&. Remember to also set \fB-T\fR\&.
.TP
\fB-P \fIproxy-auth-username\fR:\fIpassword\fR\fR
Supply BASIC Authentication credentials to a proxy en-route\&. The username and password are separated by a single \fB:\fR and sent on the wire base64 encoded\&. The string is sent regardless of whether the proxy needs it (\fIi\&.e\&.\fR, has sent an 407 proxy authentication needed)\&.
.TP
\fB-q\fR
When processing more than 150 requests, \fBab\fR outputs a progress count on \fBstderr\fR every 10% or 100 requests or so\&. The \fB-q\fR flag will suppress these messages\&.
.TP
\fB-r\fR
Don't exit on socket receive errors\&.
.TP
\fB-s \fItimeout\fR\fR
Maximum number of seconds to wait before the socket times out\&. Default is 30 seconds\&. Available in 2\&.4\&.4 and later\&.
.TP
\fB-S\fR
Do not display the median and standard deviation values, nor display the warning/error messages when the average and median are more than one or two times the standard deviation apart\&. And default to the min/avg/max values\&. (legacy support)\&.
.TP
\fB-t \fItimelimit\fR\fR
Maximum number of seconds to spend for benchmarking\&. This implies a \fB-n 50000\fR internally\&. Use this to benchmark the server within a fixed total amount of time\&. Per default there is no timelimit\&.
.TP
\fB-T \fIcontent-type\fR\fR
Content-type header to use for POST/PUT data, eg\&. \fBapplication/x-www-form-urlencoded\fR\&. Default is \fBtext/plain\fR\&.
.TP
\fB-u \fIPUT-file\fR\fR
File containing data to PUT\&. Remember to also set \fB-T\fR\&.
.TP
\fB-v \fIverbosity\fR\fR
Set verbosity level - \fB4\fR and above prints information on headers, \fB3\fR and above prints response codes (404, 200, etc\&.), \fB2\fR and above prints warnings and info\&.
.TP
\fB-V\fR
Display version number and exit\&.
.TP
\fB-w\fR
Print out results in HTML tables\&. Default table is two columns wide, with a white background\&.
.TP
\fB-x \fI<table>-attributes\fR\fR
String to use as attributes for \fB<table>\fR\&. Attributes are inserted \fB<table \fIhere\fR >\fR\&.
.TP
\fB-X \fIproxy\fR[:\fIport\fR]\fR
Use a proxy server for the requests\&.
.TP
\fB-y \fI<tr>-attributes\fR\fR
String to use as attributes for \fB<tr>\fR\&.
.TP
\fB-z \fI<td>-attributes\fR\fR
String to use as attributes for \fB<td>\fR\&.
.TP
\fB-Z \fIciphersuite\fR\fR
Specify SSL/TLS cipher suite (See openssl ciphers)
.SH "OUTPUT"
.PP
The following list describes the values returned by \fBab\fR:
.TP
Server Software
The value, if any, returned in the \fIserver\fR HTTP header of the first successful response\&. This includes all characters in the header from beginning to the point a character with decimal value of 32 (most notably: a space or CR/LF) is detected\&.
.TP
Server Hostname
The DNS or IP address given on the command line
.TP
Server Port
The port to which ab is connecting\&. If no port is given on the command line, this will default to 80 for http and 443 for https\&.
.TP
SSL/TLS Protocol
The protocol parameters negotiated between the client and server\&. This will only be printed if SSL is used\&.
.TP
Document Path
The request URI parsed from the command line string\&.
.TP
Document Length
This is the size in bytes of the first successfully returned document\&. If the document length changes during testing, the response is considered an error\&.
.TP
Concurrency Level
The number of concurrent clients used during the test
.TP
Time taken for tests
This is the time taken from the moment the first socket connection is created to the moment the last response is received
.TP
Complete requests
The number of successful responses received
.TP
Failed requests
The number of requests that were considered a failure\&. If the number is greater than zero, another line will be printed showing the number of requests that failed due to connecting, reading, incorrect content length, or exceptions\&.
.TP
Write errors
The number of errors that failed during write (broken pipe)\&.
.TP
Non-2xx responses
The number of responses that were not in the 200 series of response codes\&. If all responses were 200, this field is not printed\&.
.TP
Keep-Alive requests
The number of connections that resulted in Keep-Alive requests
.TP
Total body sent
If configured to send data as part of the test, this is the total number of bytes sent during the tests\&. This field is omitted if the test did not include a body to send\&.
.TP
Total transferred
The total number of bytes received from the server\&. This number is essentially the number of bytes sent over the wire\&.
.TP
HTML transferred
The total number of document bytes received from the server\&. This number excludes bytes received in HTTP headers
.TP
Requests per second
This is the number of requests per second\&. This value is the result of dividing the number of requests by the total time taken
.TP
Time per request
The average time spent per request\&. The first value is calculated with the formula \fBconcurrency * timetaken * 1000 / done\fR while the second value is calculated with the formula \fBtimetaken * 1000 / done\fR
.TP
Transfer rate
The rate of transfer as calculated by the formula \fBtotalread / 1024 / timetaken\fR
.SH "BUGS"
.PP
There are various statically declared buffers of fixed length\&. Combined with the lazy parsing of the command line arguments, the response headers from the server and other external inputs, this might bite you\&.
.PP
It does not implement HTTP/1\&.x fully; only accepts some 'expected' forms of responses\&. The rather heavy use of \fBstrstr(3)\fR shows up top in profile, which might indicate a performance problem; \fIi\&.e\&.\fR, you would measure the \fBab\fR performance rather than the server's\&.
httpd-2.4.64/docs/man/dbmmanage.1 0000664 0001751 0001751 00000013176 14571614732 016344 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "DBMMANAGE" 1 "2018-07-06" "Apache HTTP Server" "dbmmanage"
.SH NAME
dbmmanage \- Manage user authentication files in DBM format
.SH "SYNOPSIS"
.PP
\fB\fBdbmmanage\fR [ \fIencoding\fR ] \fIfilename\fR add|adduser|check|delete|update \fIusername\fR [ \fIencpasswd\fR [ \fIgroup\fR[,\fIgroup\fR\&.\&.\&.] [ \fIcomment\fR ] ] ]\fR
.PP
\fB\fBdbmmanage\fR \fIfilename\fR view [ \fIusername\fR ]\fR
.PP
\fB\fBdbmmanage\fR \fIfilename\fR import\fR
.SH "SUMMARY"
.PP
\fBdbmmanage\fR is used to create and update the DBM format files used to store usernames and password for basic authentication of HTTP users via mod_authn_dbm\&. Resources available from the Apache HTTP server can be restricted to just the users listed in the files created by \fBdbmmanage\fR\&. This program can only be used when the usernames are stored in a DBM file\&. To use a flat-file database see htpasswd\&.
.PP
Another tool to maintain a DBM password database is htdbm\&.
.PP
This manual page only lists the command line arguments\&. For details of the directives necessary to configure user authentication in httpd see the httpd manual, which is part of the Apache distribution or can be found at http://httpd\&.apache\&.org/\&.
.SH "OPTIONS"
.TP
\fB\fIfilename\fR\fR
The filename of the DBM format file\&. Usually without the extension \fB\&.db\fR, \fB\&.pag\fR, or \fB\&.dir\fR\&.
.TP
\fB\fIusername\fR\fR
The user for which the operations are performed\&. The \fIusername\fR may not contain a colon (\fB:\fR)\&.
.TP
\fB\fIencpasswd\fR\fR
This is the already hashed password to use for the \fBupdate\fR and \fBadd\fR commands\&. You may use a hyphen (\fB-\fR) if you want to get prompted for the password, but fill in the fields afterwards\&. Additionally when using the \fBupdate\fR command, a period (\fB\&.\fR) keeps the original password untouched\&.
.TP
\fB\fIgroup\fR\fR
A group, which the user is member of\&. A groupname may not contain a colon (\fB:\fR)\&. You may use a hyphen (\fB-\fR) if you don't want to assign the user to a group, but fill in the comment field\&. Additionally when using the \fBupdate\fR command, a period (\fB\&.\fR) keeps the original groups untouched\&.
.TP
\fB\fIcomment\fR\fR
This is the place for your opaque comments about the user, like realname, mailaddress or such things\&. The server will ignore this field\&.
.SS "Encodings"
.TP
\fB-d\fR
crypt hashing (default, except on Win32, Netware)
.TP
\fB-m\fR
MD5 hashing (default on Win32, Netware)
.TP
\fB-s\fR
SHA1 hashing
.TP
\fB-p\fR
plaintext (\fInot recommended\fR)
.SS "Commands"
.TP
\fBadd\fR
Adds an entry for \fIusername\fR to \fIfilename\fR using the hashed password \fIencpasswd\fR\&. dbmmanage passwords\&.dat add rbowen foKntnEF3KSXA
.TP
\fBadduser\fR
Asks for a password and then adds an entry for \fIusername\fR to \fIfilename\fR\&. dbmmanage passwords\&.dat adduser krietz
.TP
\fBcheck\fR
Asks for a password and then checks if \fIusername\fR is in \fIfilename\fR and if it's password matches the specified one\&. dbmmanage passwords\&.dat check rbowen
.TP
\fBdelete\fR
Deletes the \fIusername\fR entry from \fIfilename\fR\&. dbmmanage passwords\&.dat delete rbowen
.TP
\fBimport\fR
Reads \fB\fIusername\fR:\fIpassword\fR\fR entries (one per line) from \fBSTDIN\fR and adds them to \fIfilename\fR\&. The passwords already have to be crypted\&.
.TP
\fBupdate\fR
Same as the \fBadduser\fR command, except that it makes sure \fIusername\fR already exists in \fIfilename\fR\&. dbmmanage passwords\&.dat update rbowen
.TP
\fBview\fR
Just displays the contents of the DBM file\&. If you specify a \fIusername\fR, it displays the particular record only\&. dbmmanage passwords\&.dat view
.SH "BUGS"
.PP
One should be aware that there are a number of different DBM file formats in existence, and with all likelihood, libraries for more than one format may exist on your system\&. The three primary examples are SDBM, NDBM, the GNU project's GDBM, and Berkeley DB 2\&. Unfortunately, all these libraries use different file formats, and you must make sure that the file format used by \fIfilename\fR is the same format that \fBdbmmanage\fR expects to see\&. \fBdbmmanage\fR currently has no way of determining what type of DBM file it is looking at\&. If used against the wrong format, will simply return nothing, or may create a different DBM file with a different name, or at worst, it may corrupt the DBM file if you were attempting to write to it\&.
.PP
\fBdbmmanage\fR has a list of DBM format preferences, defined by the \fB@AnyDBM::ISA\fR array near the beginning of the program\&. Since we prefer the Berkeley DB 2 file format, the order in which \fBdbmmanage\fR will look for system libraries is Berkeley DB 2, then NDBM, then GDBM and then SDBM\&. The first library found will be the library \fBdbmmanage\fR will attempt to use for all DBM file transactions\&. This ordering is slightly different than the standard \fB@AnyDBM::ISA\fR ordering in Perl, as well as the ordering used by the simple \fBdbmopen()\fR call in Perl, so if you use any other utilities to manage your DBM files, they must also follow this preference ordering\&. Similar care must be taken if using programs in other languages, like C, to access these files\&.
.PP
One can usually use the \fBfile\fR program supplied with most Unix systems to see what format a DBM file is in\&.
httpd-2.4.64/docs/man/htcacheclean.8 0000664 0001751 0001751 00000014514 13523273316 017032 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTCACHECLEAN" 8 "2019-08-09" "Apache HTTP Server" "htcacheclean"
.SH NAME
htcacheclean \- Clean up the disk cache
.SH "SYNOPSIS"
.PP
\fB\fBhtcacheclean\fR [ -\fBD\fR ] [ -\fBv\fR ] [ -\fBt\fR ] [ -\fBr\fR ] [ -\fBn\fR ] [ -\fBR\fR\fIround\fR ] -\fBp\fR\fIpath\fR [ -\fBl\fR\fIlimit\fR ] [ -\fBL\fR\fIlimit\fR ]\fR
.PP
\fB\fBhtcacheclean\fR [ -\fBn\fR ] [ -\fBt\fR ] [ -\fBi\fR ] [ -\fBP\fR\fIpidfile\fR ] [ -\fBR\fR\fIround\fR ] -\fBd\fR\fIinterval\fR -\fBp\fR\fIpath\fR [ -\fBl\fR\fIlimit\fR ] [ -\fBL\fR\fIlimit\fR ]\fR
.PP
\fB\fBhtcacheclean\fR [ -\fBv\fR ] [ -\fBR\fR\fIround\fR ] -\fBp\fR\fIpath\fR [ -\fBa\fR ] [ -\fBA\fR ]\fR
.PP
\fB\fBhtcacheclean\fR [ -\fBD\fR ] [ -\fBv\fR ] [ -\fBt\fR ] [ -\fBR\fR\fIround\fR ] -\fBp\fR\fIpath\fR \fIurl\fR\fR
.SH "SUMMARY"
.PP
\fBhtcacheclean\fR is used to keep the size of mod_cache_disk's storage within a given size limit, or limit on inodes in use\&. This tool can run either manually or in daemon mode\&. When running in daemon mode, it sleeps in the background and checks the cache directory at regular intervals for cached content to be removed\&. You can stop the daemon cleanly by sending it a TERM or INT signal\&. When run manually, a once off check of the cache directory is made for cached content to be removed\&. If one or more URLs are specified, each URL will be deleted from the cache, if present\&.
.SH "OPTIONS"
.TP
\fB-d\fIinterval\fR\fR
Daemonize and repeat cache cleaning every \fIinterval\fR minutes\&. This option is mutually exclusive with the \fB-D\fR, \fB-v\fR and \fB-r\fR options\&. To shutdown the daemon cleanly, just send it a \fBSIGTERM\fR or \fBSIGINT\fR\&.
.TP
\fB-D\fR
Do a dry run and don't delete anything\&. This option is mutually exclusive with the \fB-d\fR option\&. When doing a dry run and deleting directories with \fB-t\fR, the inodes reported deleted in the stats cannot take into account the directories deleted, and will be marked as an estimate\&.
.TP
\fB-v\fR
Be verbose and print statistics\&. This option is mutually exclusive with the \fB-d\fR option\&.
.TP
\fB-r\fR
Clean thoroughly\&. This assumes that the Apache web server is not running (otherwise you may get garbage in the cache)\&. This option is mutually exclusive with the \fB-d\fR option and implies the \fB-t\fR option\&.
.TP
\fB-n\fR
Be nice\&. This causes slower processing in favour of other processes\&. \fBhtcacheclean\fR will sleep from time to time so that (a) the disk IO will be delayed and (b) the kernel can schedule other processes in the meantime\&.
.TP
\fB-t\fR
Delete all empty directories\&. By default only cache files are removed, however with some configurations the large number of directories created may require attention\&. If your configuration requires a very large number of directories, to the point that inode or file allocation table exhaustion may become an issue, use of this option is advised\&.
.TP
\fB-p\fIpath\fR\fR
Specify \fIpath\fR as the root directory of the disk cache\&. This should be the same value as specified with the CacheRoot directive\&.
.TP
\fB-P\fIpidfile\fR\fR
Specify \fIpidfile\fR as the name of the file to write the process ID to when daemonized\&.
.TP
\fB-R\fIround\fR\fR
Specify \fIround\fR as the amount to round sizes up to, to compensate for disk block sizes\&. Set to the block size of the cache partition\&.
.TP
\fB-l\fIlimit\fR\fR
Specify \fIlimit\fR as the total disk cache size limit\&. The value is expressed in bytes by default (or attaching \fBB\fR to the number)\&. Attach \fBK\fR for Kbytes, \fBM\fR for MBytes or \fBG\fR for Gbytes\&.
.TP
\fB-L\fIlimit\fR\fR
Specify \fIlimit\fR as the total disk cache inode limit\&. \fBK\fR, \fBM\fR or \fBG\fR suffix can also be used\&.
.TP
\fB-i\fR
Be intelligent and run only when there was a modification of the disk cache\&. This option is only possible together with the \fB-d\fR option\&.
.TP
\fB-a\fR
List the URLs currently stored in the cache\&. Variants of the same URL will be listed once for each variant\&.
.TP
\fB-A\fR
List the URLs currently stored in the cache, along with their attributes in the following order: url, header size, body size, status, entity version, date, expiry, request time, response time, body present, head request\&.
.SH "DELETING A SPECIFIC URL"
.PP
If \fBhtcacheclean\fR is passed one or more URLs, each URL will be deleted from the cache\&. If multiple variants of an URL exists, all variants would be deleted\&.
.PP
When a reverse proxied URL is to be deleted, the effective URL is constructed from the \fBHost\fR header, the \fBport\fR, the \fBpath\fR and the \fBquery\fR\&. Note the '?' in the URL must always be specified explicitly, whether a query string is present or not\&. For example, an attempt to delete the path \fB/\fR from the server \fBlocalhost\fR, the URL to delete would be \fBhttp://localhost:80/?\fR\&.
.SH "LISTING URLS IN THE CACHE"
.PP
By passing the \fB-a\fR or \fB-A\fR options to \fBhtcacheclean\fR, the URLs within the cache will be listed as they are found, one URL per line\&. The \fB-A\fR option dumps the full cache entry after the URL, with fields in the following order:
.TP
url
The URL of the entry\&.
.TP
header size
The size of the header in bytes\&.
.TP
body size
The size of the body in bytes\&.
.TP
status
Status of the cached response\&.
.TP
entity version
The number of times this entry has been revalidated without being deleted\&.
.TP
date
Date of the response\&.
.TP
expiry
Expiry date of the response\&.
.TP
request time
Time of the start of the request\&.
.TP
response time
Time of the end of the request\&.
.TP
body present
If 0, no body is stored with this request, 1 otherwise\&.
.TP
head request
If 1, the entry contains a cached HEAD request with no body, 0 otherwise\&.
.SH "EXIT STATUS"
.PP
\fBhtcacheclean\fR returns a zero status ("true") if all operations were successful, \fB1\fR otherwise\&. If an URL is specified, and the URL was cached and successfully removed, \fB0\fR is returned, \fB2\fR otherwise\&. If an error occurred during URL removal, \fB1\fR is returned\&.
httpd-2.4.64/docs/man/htdbm.1 0000664 0001751 0001751 00000021763 14603014256 015517 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTDBM" 1 "2024-04-02" "Apache HTTP Server" "htdbm"
.SH NAME
htdbm \- Manipulate DBM password databases
.SH "SYNOPSIS"
.PP
\fB\fBhtdbm\fR [ -\fBT\fR\fIDBTYPE\fR ] [ -\fBi\fR ] [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIcost\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIfilename\fR \fIusername\fR\fR
.PP
\fB\fBhtdbm\fR -\fBb\fR [ -\fBT\fR\fIDBTYPE\fR ] [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIcost\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIfilename\fR \fIusername\fR \fIpassword\fR\fR
.PP
\fB\fBhtdbm\fR -\fBn\fR [ -\fBi\fR ] [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIcost\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIusername\fR\fR
.PP
\fB\fBhtdbm\fR -\fBnb\fR [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIcost\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIusername\fR \fIpassword\fR\fR
.PP
\fB\fBhtdbm\fR -\fBv\fR [ -\fBT\fR\fIDBTYPE\fR ] [ -\fBi\fR ] [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIcost\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIfilename\fR \fIusername\fR\fR
.PP
\fB\fBhtdbm\fR -\fBvb\fR [ -\fBT\fR\fIDBTYPE\fR ] [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBC\fR \fIcost\fR ] [ -\fBt\fR ] [ -\fBv\fR ] \fIfilename\fR \fIusername\fR \fIpassword\fR\fR
.PP
\fB\fBhtdbm\fR -\fBx\fR [ -\fBT\fR\fIDBTYPE\fR ] \fIfilename\fR \fIusername\fR\fR
.PP
\fB\fBhtdbm\fR -\fBl\fR [ -\fBT\fR\fIDBTYPE\fR ] \fR
.SH "SUMMARY"
.PP
\fBhtdbm\fR is used to manipulate the DBM format files used to store usernames and password for basic authentication of HTTP users via mod_authn_dbm\&. See the dbmmanage documentation for more information about these DBM files\&.
.SH "OPTIONS"
.TP
\fB-b\fR
Use batch mode; \fIi\&.e\&.\fR, get the password from the command line rather than prompting for it\&. This option should be used with extreme care, since \fBthe password is clearly visible\fR on the command line\&. For script use see the \fB-i\fR option\&.
.TP
\fB-i\fR
Read the password from stdin without verification (for script usage)\&.
.TP
\fB-c\fR
Create the \fIpasswdfile\fR\&. If \fIpasswdfile\fR already exists, it is rewritten and truncated\&. This option cannot be combined with the \fB-n\fR option\&.
.TP
\fB-n\fR
Display the results on standard output rather than updating a database\&. This option changes the syntax of the command line, since the \fIpasswdfile\fR argument (usually the first one) is omitted\&. It cannot be combined with the \fB-c\fR option\&.
.TP
\fB-m\fR
Use MD5 hashing for passwords\&. On Windows and Netware, this is the default\&.
.TP
\fB-B\fR
Use bcrypt hashing for passwords\&. This is currently considered to be very secure\&.
.TP
\fB-C\fR
This flag is only allowed in combination with \fB-B\fR (bcrypt hashing)\&. It sets the computing time used for the bcrypt algorithm (higher is more secure but slower, default: 5, valid: 4 to 31)\&.
.TP
\fB-d\fR
Use \fBcrypt()\fR hashing for passwords\&. The default on all platforms but Windows and Netware\&. Though possibly supported by \fBhtdbm\fR on all platforms, it is not supported by the httpd server on Windows and Netware\&. This algorithm is \fBinsecure\fR by today's standards\&.
.TP
\fB-s\fR
Use SHA hashing for passwords\&. Facilitates migration from/to Netscape servers using the LDAP Directory Interchange Format (ldif)\&. This algorithm is \fBinsecure\fR by today's standards\&.
.TP
\fB-p\fR
Use plaintext passwords\&. Though \fBhtdbm\fR will support creation on all platforms, the httpd daemon will only accept plain text passwords on Windows and Netware\&.
.TP
\fB-l\fR
Print each of the usernames and comments from the database on stdout\&.
.TP
\fB-v\fR
Verify the username and password\&. The program will print a message indicating whether the supplied password is valid\&. If the password is invalid, the program exits with error code 3\&.
.TP
\fB-x\fR
Delete user\&. If the username exists in the specified DBM file, it will be deleted\&.
.TP
\fB-t\fR
Interpret the final parameter as a comment\&. When this option is specified, an additional string can be appended to the command line; this string will be stored in the "Comment" field of the database, associated with the specified username\&.
.TP
\fB\fIfilename\fR\fR
The filename of the DBM format file\&. Usually without the extension \fB\&.db\fR, \fB\&.pag\fR, or \fB\&.dir\fR\&. If \fB-c\fR is given, the DBM file is created if it does not already exist, or updated if it does exist\&.
.TP
\fB\fIusername\fR\fR
The username to create or update in \fIpasswdfile\fR\&. If \fIusername\fR does not exist in this file, an entry is added\&. If it does exist, the password is changed\&.
.TP
\fB\fIpassword\fR\fR
The plaintext password to be hashed and stored in the DBM file\&. Used only with the \fB-b\fR flag\&.
.TP
\fB-T\fIDBTYPE\fR\fR
Type of DBM file (SDBM, GDBM, DB, or "default")\&.
.SH "BUGS"
.PP
One should be aware that there are a number of different DBM file formats in existence, and with all likelihood, libraries for more than one format may exist on your system\&. The three primary examples are SDBM, NDBM, GNU GDBM, and Berkeley/Sleepycat DB 2/3/4\&. Unfortunately, all these libraries use different file formats, and you must make sure that the file format used by \fIfilename\fR is the same format that \fBhtdbm\fR expects to see\&. \fBhtdbm\fR currently has no way of determining what type of DBM file it is looking at\&. If used against the wrong format, will simply return nothing, or may create a different DBM file with a different name, or at worst, it may corrupt the DBM file if you were attempting to write to it\&.
.PP
One can usually use the \fBfile\fR program supplied with most Unix systems to see what format a DBM file is in\&.
.SH "EXIT STATUS"
.PP
\fBhtdbm\fR returns a zero status ("true") if the username and password have been successfully added or updated in the DBM File\&. \fBhtdbm\fR returns \fB1\fR if it encounters some problem accessing files, \fB2\fR if there was a syntax problem with the command line, \fB3\fR if the password was entered interactively and the verification entry didn't match, \fB4\fR if its operation was interrupted, \fB5\fR if a value is too long (username, filename, password, or final computed record), \fB6\fR if the username contains illegal characters (see the Restrictions section), and \fB7\fR if the file is not a valid DBM password file\&.
.SH "EXAMPLES"
.nf
htdbm /usr/local/etc/apache/\&.htdbm-users jsmith
.fi
.PP
Adds or modifies the password for user \fBjsmith\fR\&. The user is prompted for the password\&. If executed on a Windows system, the password will be hashed using the modified Apache MD5 algorithm; otherwise, the system's \fBcrypt()\fR routine will be used\&. If the file does not exist, \fBhtdbm\fR will do nothing except return an error\&.
.nf
htdbm -c /home/doe/public_html/\&.htdbm jane
.fi
.PP
Creates a new file and stores a record in it for user \fBjane\fR\&. The user is prompted for the password\&. If the file exists and cannot be read, or cannot be written, it is not altered and \fBhtdbm\fR will display a message and return an error status\&.
.nf
htdbm -mb /usr/web/\&.htdbm-all jones Pwd4Steve
.fi
.PP
Encrypts the password from the command line (\fBPwd4Steve\fR) using the MD5 algorithm, and stores it in the specified file\&.
.SH "SECURITY CONSIDERATIONS"
.PP
Web password files such as those managed by \fBhtdbm\fR should \fInot\fR be within the Web server's URI space -- that is, they should not be fetchable with a browser\&.
.PP
The use of the \fB-b\fR option is discouraged, since when it is used the plaintext password appears on the command line\&.
.PP
When using the \fBcrypt()\fR algorithm, note that only the first 8 characters of the password are used to form the password\&. If the supplied password is longer, the extra characters will be silently discarded\&.
.PP
The SHA hashing option does not use salting: for a given password, there is only one hashed representation\&. The \fBcrypt()\fR and MD5 formats permute the representation by prepending a random salt string, to make dictionary attacks against the passwords more difficult\&.
.PP
The SHA and \fBcrypt()\fR formats are insecure by today's standards\&.
.SH "RESTRICTIONS"
.PP
On the Windows platform, passwords hashed with \fBhtdbm\fR are limited to no more than \fB255\fR characters in length\&. Longer passwords will be truncated to 255 characters\&.
.PP
The MD5 algorithm used by \fBhtdbm\fR is specific to the Apache software; passwords hashed using it will not be usable with other Web servers\&.
.PP
Usernames are limited to \fB255\fR bytes and may not include the character \fB:\fR\&.
httpd-2.4.64/docs/man/fcgistarter.8 0000664 0001751 0001751 00000001714 13617567463 016760 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "FCGISTARTER" 8 "2020-02-08" "Apache HTTP Server" "fcgistarter"
.SH NAME
fcgistarter \- Start a FastCGI program
.SH "SYNOPSIS"
.PP
\fB\fBfcgistarter\fR -\fBc\fR \fIcommand\fR -\fBp\fR \fIport\fR [ -\fBi\fR \fIinterface\fR ] -\fBN\fR \fInum\fR \fR
.SH "SUMMARY"
.PP
.SH "NOTE"
.PP
Currently only works on Unix systems\&.
.SH "OPTIONS"
.TP
\fB-c \fIcommand\fR\fR
Absolute path of the FastCGI program
.TP
\fB-p \fIport\fR\fR
Port which the program will listen on
.TP
\fB-i \fIinterface\fR\fR
Interface which the program will listen on
.TP
\fB-N \fInum\fR\fR
Number of instances of the program
httpd-2.4.64/docs/man/apachectl.8 0000664 0001751 0001751 00000010556 13317625777 016373 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "APACHECTL" 8 "2018-07-06" "Apache HTTP Server" "apachectl"
.SH NAME
apachectl \- Apache HTTP Server Control Interface
.SH "SYNOPSIS"
.PP
When acting in pass-through mode, \fBapachectl\fR can take all the arguments available for the httpd binary\&.
.PP
\fB\fBapachectl\fR [ \fIhttpd-argument\fR ]\fR
.PP
When acting in SysV init mode, \fBapachectl\fR takes simple, one-word commands, defined below\&.
.PP
\fB\fBapachectl\fR \fIcommand\fR\fR
.SH "SUMMARY"
.PP
\fBapachectl\fR is a front end to the Apache HyperText Transfer Protocol (HTTP) server\&. It is designed to help the administrator control the functioning of the Apache httpd daemon\&.
.PP
The \fBapachectl\fR script can operate in two modes\&. First, it can act as a simple front-end to the httpd command that simply sets any necessary environment variables and then invokes httpd, passing through any command line arguments\&. Second, \fBapachectl\fR can act as a SysV init script, taking simple one-word arguments like \fBstart\fR, \fBrestart\fR, and \fBstop\fR, and translating them into appropriate signals to httpd\&.
.PP
If your Apache installation uses non-standard paths, you will need to edit the \fBapachectl\fR script to set the appropriate paths to the httpd binary\&. You can also specify any necessary httpd command line arguments\&. See the comments in the script for details\&.
.PP
The \fBapachectl\fR script returns a 0 exit value on success, and >0 if an error occurs\&. For more details, view the comments in the script\&.
.SH "OPTIONS"
.PP
Only the SysV init-style options are defined here\&. Other arguments are defined on the httpd manual page\&.
.TP
\fBstart\fR
Start the Apache httpd daemon\&. Gives an error if it is already running\&. This is equivalent to \fBapachectl -k start\fR\&.
.TP
\fBstop\fR
Stops the Apache httpd daemon\&. This is equivalent to \fBapachectl -k stop\fR\&.
.TP
\fBrestart\fR
Restarts the Apache httpd daemon\&. If the daemon is not running, it is started\&. This command automatically checks the configuration files as in \fBconfigtest\fR before initiating the restart to make sure the daemon doesn't die\&. This is equivalent to \fBapachectl -k restart\fR\&.
.TP
\fBfullstatus\fR
Displays a full status report from mod_status\&. For this to work, you need to have mod_status enabled on your server and a text-based browser such as \fBlynx\fR available on your system\&. The URL used to access the status report can be set by editing the \fBSTATUSURL\fR variable in the script\&.
.TP
\fBstatus\fR
Displays a brief status report\&. Similar to the \fBfullstatus\fR option, except that the list of requests currently being served is omitted\&.
.TP
\fBgraceful\fR
Gracefully restarts the Apache httpd daemon\&. If the daemon is not running, it is started\&. This differs from a normal restart in that currently open connections are not aborted\&. A side effect is that old log files will not be closed immediately\&. This means that if used in a log rotation script, a substantial delay may be necessary to ensure that the old log files are closed before processing them\&. This command automatically checks the configuration files as in \fBconfigtest\fR before initiating the restart to make sure Apache doesn't die\&. This is equivalent to \fBapachectl -k graceful\fR\&.
.TP
\fBgraceful-stop\fR
Gracefully stops the Apache httpd daemon\&. This differs from a normal stop in that currently open connections are not aborted\&. A side effect is that old log files will not be closed immediately\&. This is equivalent to \fBapachectl -k graceful-stop\fR\&.
.TP
\fBconfigtest\fR
Run a configuration file syntax test\&. It parses the configuration files and either reports \fBSyntax Ok\fR or detailed information about the particular syntax error\&. This is equivalent to \fBapachectl -t\fR\&.
.PP
The following option was available in earlier versions but has been removed\&.
.TP
\fBstartssl\fR
To start httpd with SSL support, you should edit your configuration file to include the relevant directives and then use the normal \fBapachectl start\fR\&.
httpd-2.4.64/docs/man/logresolve.1 0000664 0001751 0001751 00000002635 13317625777 016620 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "LOGRESOLVE" 1 "2018-07-06" "Apache HTTP Server" "logresolve"
.SH NAME
logresolve \- Resolve IP-addresses to hostnames in Apache log files
.SH "SYNOPSIS"
.PP
\fB\fBlogresolve\fR [ -\fBs\fR \fIfilename\fR ] [ -\fBc\fR ] < \fIaccess_log\fR > \fIaccess_log\&.new\fR\fR
.SH "SUMMARY"
.PP
\fBlogresolve\fR is a post-processing program to resolve IP-addresses in Apache's access logfiles\&. To minimize impact on your nameserver, logresolve has its very own internal hash-table cache\&. This means that each IP number will only be looked up the first time it is found in the log file\&.
.PP
Takes an Apache log file on standard input\&. The IP addresses must be the first thing on each line and must be separated from the remainder of the line by a space\&.
.SH "OPTIONS"
.TP
\fB-s \fIfilename\fR\fR
Specifies a filename to record statistics\&.
.TP
\fB-c\fR
This causes \fBlogresolve\fR to apply some DNS checks: after finding the hostname from the IP address, it looks up the IP addresses for the hostname and checks that one of these matches the original address\&.
httpd-2.4.64/docs/man/httpd.8 0000664 0001751 0001751 00000011471 13317625777 015567 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTTPD" 8 "2018-07-06" "Apache HTTP Server" "httpd"
.SH NAME
httpd \- Apache Hypertext Transfer Protocol Server
.SH "SYNOPSIS"
.PP
\fB\fBhttpd\fR [ -\fBd\fR \fIserverroot\fR ] [ -\fBf\fR \fIconfig\fR ] [ -\fBC\fR \fIdirective\fR ] [ -\fBc\fR \fIdirective\fR ] [ -\fBD\fR \fIparameter\fR ] [ -\fBe\fR \fIlevel\fR ] [ -\fBE\fR \fIfile\fR ] [ \fB-k\fR start|restart|graceful|stop|graceful-stop ] [ -\fBh\fR ] [ -\fBl\fR ] [ -\fBL\fR ] [ -\fBS\fR ] [ -\fBt\fR ] [ -\fBv\fR ] [ -\fBV\fR ] [ -\fBX\fR ] [ -\fBM\fR ] [ -\fBT\fR ] \fR
.PP
On Windows systems, the following additional arguments are available:
.PP
\fB\fBhttpd\fR [ -\fBk\fR install|config|uninstall ] [ -\fBn\fR \fIname\fR ] [ -\fBw\fR ]\fR
.SH "SUMMARY"
.PP
\fBhttpd\fR is the Apache HyperText Transfer Protocol (HTTP) server program\&. It is designed to be run as a standalone daemon process\&. When used like this it will create a pool of child processes or threads to handle requests\&.
.PP
In general, \fBhttpd\fR should not be invoked directly, but rather should be invoked via apachectl on Unix-based systems or as a service on Windows NT, 2000 and XP and as a console application on Windows 9x and ME\&.
.SH "OPTIONS"
.TP
\fB-d \fIserverroot\fR\fR
Set the initial value for the ServerRoot directive to \fIserverroot\fR\&. This can be overridden by the ServerRoot directive in the configuration file\&. The default is \fB/usr/local/apache2\fR\&.
.TP
\fB-f \fIconfig\fR\fR
Uses the directives in the file \fIconfig\fR on startup\&. If \fIconfig\fR does not begin with a /, then it is taken to be a path relative to the ServerRoot\&. The default is \fBconf/httpd\&.conf\fR\&.
.TP
\fB-k \fBstart|restart|graceful|stop|graceful-stop\fR\fR
Signals \fBhttpd\fR to start, restart, or stop\&. See Stopping Apache httpd for more information\&.
.TP
\fB-C \fIdirective\fR\fR
Process the configuration \fIdirective\fR before reading config files\&.
.TP
\fB-c \fIdirective\fR\fR
Process the configuration \fIdirective\fR after reading config files\&.
.TP
\fB-D \fIparameter\fR\fR
Sets a configuration \fIparameter \fRwhich can be used with <IfDefine> sections in the configuration files to conditionally skip or process commands at server startup and restart\&. Also can be used to set certain less-common startup parameters including \fB-DNO_DETACH\fR (prevent the parent from forking) and \fB-DFOREGROUND\fR (prevent the parent from calling \fBsetsid()\fR et al)\&.
.TP
\fB-e \fIlevel\fR\fR
Sets the LogLevel to \fIlevel\fR during server startup\&. This is useful for temporarily increasing the verbosity of the error messages to find problems during startup\&.
.TP
\fB-E \fIfile\fR\fR
Send error messages during server startup to \fIfile\fR\&.
.TP
\fB-h\fR
Output a short summary of available command line options\&.
.TP
\fB-l\fR
Output a list of modules compiled into the server\&. This will \fBnot\fR list dynamically loaded modules included using the LoadModule directive\&.
.TP
\fB-L\fR
Output a list of directives provided by static modules, together with expected arguments and places where the directive is valid\&. Directives provided by shared modules are not listed\&.
.TP
\fB-M\fR
Dump a list of loaded Static and Shared Modules\&.
.TP
\fB-S\fR
Show the settings as parsed from the config file (currently only shows the virtualhost settings)\&.
.TP
\fB-T\fR (Available in 2\&.3\&.8 and later)
Skip document root check at startup/restart\&.
.TP
\fB-t\fR
Run syntax tests for configuration files only\&. The program immediately exits after these syntax parsing tests with either a return code of 0 (Syntax OK) or return code not equal to 0 (Syntax Error)\&. If -D \fIDUMP\fR_\fIVHOSTS \fRis also set, details of the virtual host configuration will be printed\&. If -D \fIDUMP\fR_\fIMODULES \fR is set, all loaded modules will be printed\&.
.TP
\fB-v\fR
Print the version of \fBhttpd\fR, and then exit\&.
.TP
\fB-V\fR
Print the version and build parameters of \fBhttpd\fR, and then exit\&.
.TP
\fB-X\fR
Run httpd in debug mode\&. Only one worker will be started and the server will not detach from the console\&.
.PP
The following arguments are available only on the Windows platform:
.TP
\fB-k install|config|uninstall\fR
Install Apache httpd as a Windows NT service; change startup options for the Apache httpd service; and uninstall the Apache httpd service\&.
.TP
\fB-n \fIname\fR\fR
The \fIname\fR of the Apache httpd service to signal\&.
.TP
\fB-w\fR
Keep the console window open on error so that the error message can be read\&.
httpd-2.4.64/docs/man/htdigest.1 0000664 0001751 0001751 00000003636 13317625777 016254 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTDIGEST" 1 "2018-07-06" "Apache HTTP Server" "htdigest"
.SH NAME
htdigest \- manage user files for digest authentication
.SH "SYNOPSIS"
.PP
\fB\fBhtdigest\fR [ -\fBc\fR ] \fIpasswdfile\fR \fIrealm\fR \fIusername\fR\fR
.SH "SUMMARY"
.PP
\fBhtdigest\fR is used to create and update the flat-files used to store usernames, realm and password for digest authentication of HTTP users\&. Resources available from the Apache HTTP server can be restricted to just the users listed in the files created by \fBhtdigest\fR\&.
.PP
This manual page only lists the command line arguments\&. For details of the directives necessary to configure digest authentication in httpd see the Apache manual, which is part of the Apache distribution or can be found at http://httpd\&.apache\&.org/\&.
.SH "OPTIONS"
.TP
\fB-c\fR
Create the \fIpasswdfile\fR\&. If \fIpasswdfile\fR already exists, it is deleted first\&.
.TP
\fB\fIpasswdfile\fR\fR
Name of the file to contain the username, realm and password\&. If \fB-c\fR is given, this file is created if it does not already exist, or deleted and recreated if it does exist\&.
.TP
\fB\fIrealm\fR\fR
The realm name to which the user name belongs\&. See http://tools\&.ietf\&.org/html/rfc2617#section-3\&.2\&.1 for more details\&.
.TP
\fB\fIusername\fR\fR
The user name to create or update in \fIpasswdfile\fR\&. If \fIusername\fR does not exist is this file, an entry is added\&. If it does exist, the password is changed\&.
.SH "SECURITY CONSIDERATIONS"
.PP
This program is not safe as a setuid executable\&. Do \fInot\fR make it setuid\&.
httpd-2.4.64/docs/man/htpasswd.1 0000664 0001751 0001751 00000022615 14603014256 016253 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTPASSWD" 1 "2024-04-02" "Apache HTTP Server" "htpasswd"
.SH NAME
htpasswd \- Manage user files for basic authentication
.SH "SYNOPSIS"
.PP
\fB\fBhtpasswd\fR [ -\fBc\fR ] [ -\fBi\fR ] [ -\fBm\fR | -\fBB\fR | -\fB2\fR | -\fB5\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBr\fR \fIrounds\fR ] [ -\fBC\fR \fIcost\fR ] [ -\fBD\fR ] [ -\fBv\fR ] \fIpasswdfile\fR \fIusername\fR\fR
.PP
\fB\fBhtpasswd\fR -\fBb\fR [ -\fBc\fR ] [ -\fBm\fR | -\fBB\fR | -\fB2\fR | -\fB5\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBr\fR \fIrounds\fR ] [ -\fBC\fR \fIcost\fR ] [ -\fBD\fR ] [ -\fBv\fR ] \fIpasswdfile\fR \fIusername\fR \fIpassword\fR\fR
.PP
\fB\fBhtpasswd\fR -\fBn\fR [ -\fBi\fR ] [ -\fBm\fR | -\fBB\fR | -\fB2\fR | -\fB5\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBr\fR \fIrounds\fR ] [ -\fBC\fR \fIcost\fR ] \fIusername\fR\fR
.PP
\fB\fBhtpasswd\fR -\fBnb\fR [ -\fBm\fR | -\fBB\fR | -\fB2\fR | -\fB5\fR | -\fBd\fR | -\fBs\fR | -\fBp\fR ] [ -\fBr\fR \fIrounds\fR ] [ -\fBC\fR \fIcost\fR ] \fIusername\fR \fIpassword\fR\fR
.SH "SUMMARY"
.PP
\fBhtpasswd\fR is used to create and update the flat-files used to store usernames and password for basic authentication of HTTP users\&. If \fBhtpasswd\fR cannot access a file, such as not being able to write to the output file or not being able to read the file in order to update it, it returns an error status and makes no changes\&.
.PP
Resources available from the Apache HTTP server can be restricted to just the users listed in the files created by \fBhtpasswd\fR\&. This program can only manage usernames and passwords stored in a flat-file\&. It can hash and display password information for use in other types of data stores, though\&. To use a DBM database see dbmmanage or htdbm\&.
.PP
\fBhtpasswd\fR hashes passwords using either bcrypt, a version of MD5 modified for Apache, SHA-1, or the system's \fBcrypt()\fR routine\&. SHA-2-based hashes (SHA-256 and SHA-512) are supported for \fBcrypt()\fR\&. Files managed by \fBhtpasswd\fR may contain a mixture of different encoding types of passwords; some user records may have bcrypt or MD5-hashed passwords while others in the same file may have passwords hashed with \fBcrypt()\fR\&.
.PP
This manual page only lists the command line arguments\&. For details of the directives necessary to configure user authentication in httpd see the Apache manual, which is part of the Apache distribution or can be found at http://httpd\&.apache\&.org/\&.
.SH "OPTIONS"
.TP
\fB-b\fR
Use batch mode; \fIi\&.e\&.\fR, get the password from the command line rather than prompting for it\&. This option should be used with extreme care, since \fBthe password is clearly visible\fR on the command line\&. For script use see the \fB-i\fR option\&. Available in 2\&.4\&.4 and later\&.
.TP
\fB-i\fR
Read the password from stdin without verification (for script usage)\&.
.TP
\fB-c\fR
Create the \fIpasswdfile\fR\&. If \fIpasswdfile\fR already exists, it is rewritten and truncated\&. This option cannot be combined with the \fB-n\fR option\&.
.TP
\fB-n\fR
Display the results on standard output rather than updating a file\&. This is useful for generating password records acceptable to Apache for inclusion in non-text data stores\&. This option changes the syntax of the command line, since the \fIpasswdfile\fR argument (usually the first one) is omitted\&. It cannot be combined with the \fB-c\fR option\&.
.TP
\fB-m\fR
Use MD5 hashing for passwords\&. This is the default (since version 2\&.2\&.18)\&.
.TP
\fB-2\fR
Use SHA-256 \fBcrypt()\fR based hashes for passwords\&. This is supported on most Unix platforms\&.
.TP
\fB-5\fR
Use SHA-512 \fBcrypt()\fR based hashes for passwords\&. This is supported on most Unix platforms\&.
.TP
\fB-B\fR
Use bcrypt hashing for passwords\&. This is currently considered to be very secure\&.
.TP
\fB-C\fR
This flag is only allowed in combination with \fB-B\fR (bcrypt hashing)\&. It sets the computing time used for the bcrypt algorithm (higher is more secure but slower, default: 5, valid: 4 to 17)\&.
.TP
\fB-r\fR
This flag is only allowed in combination with \fB-2\fR or \fB-5\fR\&. It sets the number of hash rounds used for the SHA-2 algorithms (higher is more secure but slower; the default is 5,000)\&.
.TP
\fB-d\fR
Use \fBcrypt()\fR hashing for passwords\&. This is not supported by the httpd server on Windows and Netware\&. This algorithm limits the password length to 8 characters\&. This algorithm is \fBinsecure\fR by today's standards\&. It used to be the default algorithm until version 2\&.2\&.17\&.
.TP
\fB-s\fR
Use SHA-1 (160-bit) hashing for passwords\&. Facilitates migration from/to Netscape servers using the LDAP Directory Interchange Format (ldif)\&. This algorithm is \fBinsecure\fR by today's standards\&.
.TP
\fB-p\fR
Use plaintext passwords\&. Though \fBhtpasswd\fR will support creation on all platforms, the httpd daemon will only accept plain text passwords on Windows and Netware\&.
.TP
\fB-D\fR
Delete user\&. If the username exists in the specified htpasswd file, it will be deleted\&.
.TP
\fB-v\fR
Verify password\&. Verify that the given password matches the password of the user stored in the specified htpasswd file\&. Available in 2\&.4\&.5 and later\&.
.TP
\fB\fIpasswdfile\fR\fR
Name of the file to contain the user name and password\&. If \fB-c\fR is given, this file is created if it does not already exist, or rewritten and truncated if it does exist\&.
.TP
\fB\fIusername\fR\fR
The username to create or update in \fIpasswdfile\fR\&. If \fIusername\fR does not exist in this file, an entry is added\&. If it does exist, the password is changed\&.
.TP
\fB\fIpassword\fR\fR
The plaintext password to be hashed and stored in the file\&. Only used with the \fB-b\fR flag\&.
.SH "EXIT STATUS"
.PP
\fBhtpasswd\fR returns a zero status ("true") if the username and password have been successfully added or updated in the \fIpasswdfile\fR\&. \fBhtpasswd\fR returns \fB1\fR if it encounters some problem accessing files, \fB2\fR if there was a syntax problem with the command line, \fB3\fR if the password was entered interactively and the verification entry didn't match, \fB4\fR if its operation was interrupted, \fB5\fR if a value is too long (username, filename, password, or final computed record), \fB6\fR if the username contains illegal characters (see the Restrictions section), and \fB7\fR if the file is not a valid password file\&.
.SH "EXAMPLES"
.nf
htpasswd /usr/local/etc/apache/\&.htpasswd-users jsmith
.fi
.PP
Adds or modifies the password for user \fBjsmith\fR\&. The user is prompted for the password\&. The password will be hashed using the modified Apache MD5 algorithm\&. If the file does not exist, \fBhtpasswd\fR will do nothing except return an error\&.
.nf
htpasswd -c /home/doe/public_html/\&.htpasswd jane
.fi
.PP
Creates a new file and stores a record in it for user \fBjane\fR\&. The user is prompted for the password\&. If the file exists and cannot be read, or cannot be written, it is not altered and \fBhtpasswd\fR will display a message and return an error status\&.
.nf
htpasswd -db /usr/web/\&.htpasswd-all jones Pwd4Steve
.fi
.PP
Encrypts the password from the command line (\fBPwd4Steve\fR) using the \fBcrypt()\fR algorithm, and stores it in the specified file\&.
.SH "SECURITY CONSIDERATIONS"
.PP
Web password files such as those managed by \fBhtpasswd\fR should \fInot\fR be within the Web server's URI space -- that is, they should not be fetchable with a browser\&.
.PP
This program is not safe as a setuid executable\&. Do \fInot\fR make it setuid\&.
.PP
The use of the \fB-b\fR option is discouraged, since when it is used the plaintext password appears on the command line\&.
.PP
When using the \fBcrypt()\fR algorithm, note that only the first 8 characters of the password are used to form the password\&. If the supplied password is longer, the extra characters will be silently discarded\&.
.PP
The SHA-1 hashing format does not use salting: for a given password, there is only one hashed representation\&. The \fBcrypt()\fR and MD5 formats permute the representation by prepending a random salt string, to make dictionary attacks against the passwords more difficult\&.
.PP
The SHA-1 and \fBcrypt()\fR formats are insecure by today's standards\&.
.PP
The SHA-2-based \fBcrypt()\fR formats (SHA-256 and SHA-512) are supported on most modern Unix systems, and follow the specification at https://www\&.akkadia\&.org/drepper/SHA-crypt\&.txt\&.
.SH "RESTRICTIONS"
.PP
On the Windows platform, passwords hashed with \fBhtpasswd\fR are limited to no more than \fB255\fR characters in length\&. Longer passwords will be truncated to 255 characters\&.
.PP
The MD5 algorithm used by \fBhtpasswd\fR is specific to the Apache software; passwords hashed using it will not be usable with other Web servers\&.
.PP
Usernames are limited to \fB255\fR bytes and may not include the character \fB:\fR\&.
.PP
The cost of computing a bcrypt password hash value increases with the number of rounds specified by the \fB-C\fR option\&. The \fBapr-util\fR library enforces a maximum number of rounds of 17 in version \fB1\&.6\&.0\fR and later\&.
httpd-2.4.64/docs/man/httxt2dbm.1 0000664 0001751 0001751 00000003267 13563002277 016344 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTTXT2DBM" 1 "2019-11-13" "Apache HTTP Server" "httxt2dbm"
.SH NAME
httxt2dbm \- Generate dbm files for use with RewriteMap
.SH "SYNOPSIS"
.PP
\fB\fBhttxt2dbm\fR [ -\fBv\fR ] [ -\fBf\fR \fIDBM_TYPE\fR ] -\fBi\fR \fISOURCE_TXT\fR -\fBo\fR \fIOUTPUT_DBM\fR \fR
.SH "SUMMARY"
.PP
\fBhttxt2dbm\fR is used to generate dbm files from text input, for use in RewriteMap with the \fBdbm\fR map type\&.
.PP
If the output file already exists, it will not be truncated\&. New keys will be added and existing keys will be updated\&.
.SH "OPTIONS"
.TP
\fB-v\fR
More verbose output
.TP
\fB-f \fIDBM_TYPE\fR\fR
Specify the DBM type to be used for the output\&. If not specified, will use the APR Default\&. Available types are: \fBGDBM\fR for GDBM files, \fBSDBM\fR for SDBM files, \fBDB\fR for berkeley DB files, \fBNDBM\fR for NDBM files, \fBdefault\fR for the default DBM type\&.
.TP
\fB-i \fISOURCE_TXT\fR\fR
Input file from which the dbm is to be created\&. The file should be formatted with one record per line, of the form: \fBkey value\fR\&. See the documentation for RewriteMap for further details of this file's format and meaning\&.
.TP
\fB-o \fIOUTPUT_DBM\fR\fR
Name of the output dbm files\&.
.SH "EXAMPLES"
.nf
httxt2dbm -i rewritemap\&.txt -o rewritemap\&.dbm
httxt2dbm -f SDBM -i rewritemap\&.txt -o rewritemap\&.dbm
.fi
httpd-2.4.64/docs/man/apxs.1 0000664 0001751 0001751 00000024644 13317625777 015416 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "APXS" 1 "2018-07-06" "Apache HTTP Server" "apxs"
.SH NAME
apxs \- APache eXtenSion tool
.SH "SYNOPSIS"
.PP
\fB\fBapxs\fR -\fBg\fR [ -\fBS\fR \fIname\fR=\fIvalue\fR ] -\fBn\fR \fImodname\fR\fR
.PP
\fB\fBapxs\fR -\fBq\fR [ -\fBv\fR ] [ -\fBS\fR \fIname\fR=\fIvalue\fR ] \fIquery\fR \&.\&.\&.\fR
.PP
\fB\fBapxs\fR -\fBc\fR [ -\fBS\fR \fIname\fR=\fIvalue\fR ] [ -\fBo\fR \fIdsofile\fR ] [ -\fBI\fR \fIincdir\fR ] [ -\fBD\fR \fIname\fR=\fIvalue\fR ] [ -\fBL\fR \fIlibdir\fR ] [ -\fBl\fR \fIlibname\fR ] [ -\fBWc,\fR\fIcompiler-flags\fR ] [ -\fBWl,\fR\fIlinker-flags\fR ] \fIfiles\fR \&.\&.\&.\fR
.PP
\fB\fBapxs\fR -\fBi\fR [ -\fBS\fR \fIname\fR=\fIvalue\fR ] [ -\fBn\fR \fImodname\fR ] [ -\fBa\fR ] [ -\fBA\fR ] \fIdso-file\fR \&.\&.\&.\fR
.PP
\fB\fBapxs\fR -\fBe\fR [ -\fBS\fR \fIname\fR=\fIvalue\fR ] [ -\fBn\fR \fImodname\fR ] [ -\fBa\fR ] [ -\fBA\fR ] \fIdso-file\fR \&.\&.\&.\fR
.SH "SUMMARY"
.PP
\fBapxs\fR is a tool for building and installing extension modules for the Apache HyperText Transfer Protocol (HTTP) server\&. This is achieved by building a dynamic shared object (DSO) from one or more source or object \fIfiles\fR which then can be loaded into the Apache server under runtime via the LoadModule directive from mod_so\&.
.PP
So to use this extension mechanism your platform has to support the DSO feature and your Apache httpd binary has to be built with the mod_so module\&. The \fBapxs\fR tool automatically complains if this is not the case\&. You can check this yourself by manually running the command
.nf
$ httpd -l
.fi
.PP
The module mod_so should be part of the displayed list\&. If these requirements are fulfilled you can easily extend your Apache server's functionality by installing your own modules with the DSO mechanism by the help of this \fBapxs\fR tool:
.nf
$ apxs -i -a -c mod_foo\&.c
gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo\&.c
ld -Bshareable -o mod_foo\&.so mod_foo\&.o
cp mod_foo\&.so /path/to/apache/modules/mod_foo\&.so
chmod 755 /path/to/apache/modules/mod_foo\&.so
[activating module `foo' in /path/to/apache/etc/httpd\&.conf]
$ apachectl restart
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start
[Tue Mar 31 11:27:55 1998] [debug] mod_so\&.c(303): loaded module foo_module
/path/to/apache/sbin/apachectl restart: httpd started
$ _
.fi
.PP
The arguments \fIfiles\fR can be any C source file (\&.c), a object file (\&.o) or even a library archive (\&.a)\&. The \fBapxs\fR tool automatically recognizes these extensions and automatically used the C source files for compilation while just using the object and archive files for the linking phase\&. But when using such pre-compiled objects make sure they are compiled for position independent code (PIC) to be able to use them for a dynamically loaded shared object\&. For instance with GCC you always just have to use \fB-fpic\fR\&. For other C compilers consult its manual page or at watch for the flags \fBapxs\fR uses to compile the object files\&.
.PP
For more details about DSO support in Apache read the documentation of mod_so or perhaps even read the \fBsrc/modules/standard/mod_so\&.c\fR source file\&.
.SH "OPTIONS"
.SS "Common Options"
.TP
\fB-n \fImodname\fR\fR
This explicitly sets the module name for the \fB-i\fR (install) and \fB-g\fR (template generation) option\&. Use this to explicitly specify the module name\&. For option \fB-g\fR this is required, for option \fB-i\fR the \fBapxs\fR tool tries to determine the name from the source or (as a fallback) at least by guessing it from the filename\&.
.SS "Query Options"
.TP
\fB-q\fR
Performs a query for variables and environment settings used to build \fBhttpd\fR\&. When invoked without \fIquery\fR parameters, it prints all known variables and their values\&. The optional \fB-v\fR parameter formats the list output\&. .PP Use this to manually determine settings used to build the \fBhttpd\fR that will load your module\&. For instance use INC=-I`apxs -q INCLUDEDIR` .PP inside your own Makefiles if you need manual access to Apache's C header files\&.
.SS "Configuration Options"
.TP
\fB-S \fIname\fR=\fIvalue\fR\fR
This option changes the apxs settings described above\&.
.SS "Template Generation Options"
.TP
\fB-g\fR
This generates a subdirectory \fIname\fR (see option \fB-n\fR) and there two files: A sample module source file named \fBmod_\fIname\fR\&.c\fR which can be used as a template for creating your own modules or as a quick start for playing with the apxs mechanism\&. And a corresponding \fBMakefile\fR for even easier build and installing of this module\&.
.SS "DSO Compilation Options"
.TP
\fB-c\fR
This indicates the compilation operation\&. It first compiles the C source files (\&.c) of \fIfiles\fR into corresponding object files (\&.o) and then builds a dynamically shared object in \fIdsofile\fR by linking these object files plus the remaining object files (\&.o and \&.a) of \fIfiles\fR\&. If no \fB-o\fR option is specified the output file is guessed from the first filename in \fIfiles\fR and thus usually defaults to \fBmod_\fIname\fR\&.so\fR\&.
.TP
\fB-o \fIdsofile\fR\fR
Explicitly specifies the filename of the created dynamically shared object\&. If not specified and the name cannot be guessed from the \fIfiles\fR list, the fallback name \fBmod_unknown\&.so\fR is used\&.
.TP
\fB-D \fIname\fR=\fIvalue\fR\fR
This option is directly passed through to the compilation command(s)\&. Use this to add your own defines to the build process\&.
.TP
\fB-I \fIincdir\fR\fR
This option is directly passed through to the compilation command(s)\&. Use this to add your own include directories to search to the build process\&.
.TP
\fB-L \fIlibdir\fR\fR
This option is directly passed through to the linker command\&. Use this to add your own library directories to search to the build process\&.
.TP
\fB-l \fIlibname\fR\fR
This option is directly passed through to the linker command\&. Use this to add your own libraries to search to the build process\&.
.TP
\fB-Wc,\fIcompiler-flags\fR\fR
This option passes \fIcompiler-flags\fR as additional flags to the \fBlibtool --mode=compile\fR command\&. Use this to add local compiler-specific options\&.
.TP
\fB-Wl,\fIlinker-flags\fR\fR
This option passes \fIlinker-flags\fR as additional flags to the \fBlibtool --mode=link\fR command\&. Use this to add local linker-specific options\&.
.TP
\fB-p\fR
This option causes apxs to link against the apr/apr-util libraries\&. This is useful when compiling helper programs that use the apr/apr-util libraries\&.
.SS "DSO Installation and Configuration Options"
.TP
\fB-i\fR
This indicates the installation operation and installs one or more dynamically shared objects into the server's \fImodules\fR directory\&.
.TP
\fB-a\fR
This activates the module by automatically adding a corresponding LoadModule line to Apache's \fBhttpd\&.conf\fR configuration file, or by enabling it if it already exists\&.
.TP
\fB-A\fR
Same as option \fB-a\fR but the created LoadModule directive is prefixed with a hash sign (\fB#\fR), \fIi\&.e\&.\fR, the module is just prepared for later activation but initially disabled\&.
.TP
\fB-e\fR
This indicates the editing operation, which can be used with the \fB-a\fR and \fB-A\fR options similarly to the \fB-i\fR operation to edit Apache's \fBhttpd\&.conf\fR configuration file without attempting to install the module\&.
.SH "EXAMPLES"
.PP
Assume you have an Apache module named \fBmod_foo\&.c\fR available which should extend Apache's server functionality\&. To accomplish this you first have to compile the C source into a shared object suitable for loading into the Apache server under runtime via the following command:
.nf
$ apxs -c mod_foo\&.c
/path/to/libtool --mode=compile gcc \&.\&.\&. -c mod_foo\&.c
/path/to/libtool --mode=link gcc \&.\&.\&. -o mod_foo\&.la mod_foo\&.slo
$ _
.fi
.PP
Then you have to update the Apache configuration by making sure a LoadModule directive is present to load this shared object\&. To simplify this step \fBapxs\fR provides an automatic way to install the shared object in its "modules" directory and updating the \fBhttpd\&.conf\fR file accordingly\&. This can be achieved by running:
.nf
$ apxs -i -a mod_foo\&.la
/path/to/instdso\&.sh mod_foo\&.la /path/to/apache/modules
/path/to/libtool --mode=install cp mod_foo\&.la /path/to/apache/modules
\&.\&.\&.
chmod 755 /path/to/apache/modules/mod_foo\&.so
[activating module `foo' in /path/to/apache/conf/httpd\&.conf]
$ _
.fi
.PP
This way a line named
.nf
LoadModule foo_module modules/mod_foo\&.so
.fi
.PP
is added to the configuration file if still not present\&. If you want to have this disabled per default use the \fB-A\fR option, \fIi\&.e\&.\fR
.nf
$ apxs -i -A mod_foo\&.c
.fi
.PP
For a quick test of the apxs mechanism you can create a sample Apache module template plus a corresponding Makefile via:
.nf
$ apxs -g -n foo
Creating [DIR] foo
Creating [FILE] foo/Makefile
Creating [FILE] foo/modules\&.mk
Creating [FILE] foo/mod_foo\&.c
Creating [FILE] foo/\&.deps
$ _
.fi
.PP
Then you can immediately compile this sample module into a shared object and load it into the Apache server:
.nf
$ cd foo
$ make all reload
apxs -c mod_foo\&.c
/path/to/libtool --mode=compile gcc \&.\&.\&. -c mod_foo\&.c
/path/to/libtool --mode=link gcc \&.\&.\&. -o mod_foo\&.la mod_foo\&.slo
apxs -i -a -n "foo" mod_foo\&.la
/path/to/instdso\&.sh mod_foo\&.la /path/to/apache/modules
/path/to/libtool --mode=install cp mod_foo\&.la /path/to/apache/modules
\&.\&.\&.
chmod 755 /path/to/apache/modules/mod_foo\&.so
[activating module `foo' in /path/to/apache/conf/httpd\&.conf]
apachectl restart
/path/to/apache/sbin/apachectl restart: httpd not running, trying to start
[Tue Mar 31 11:27:55 1998] [debug] mod_so\&.c(303): loaded module foo_module
/path/to/apache/sbin/apachectl restart: httpd started
$ _
.fi
httpd-2.4.64/docs/man/suexec.8 0000664 0001751 0001751 00000002434 13317625777 015737 0 ustar covener covener .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "SUEXEC" 8 "2018-07-06" "Apache HTTP Server" "suexec"
.SH NAME
suexec \- Switch user before executing external programs
.SH "SYNOPSIS"
.PP
\fB\fBsuexec\fR -\fBV\fR\fR
.SH "SUMMARY"
.PP
\fBsuexec\fR is used by the Apache HTTP Server to switch to another user before executing CGI programs\&. In order to achieve this, it must run as \fBroot\fR\&. Since the HTTP daemon normally doesn't run as \fBroot\fR, the \fBsuexec\fR executable needs the setuid bit set and must be owned by \fBroot\fR\&. It should never be writable for any other person than \fBroot\fR\&.
.PP
For further information about the concepts and the security model of suexec please refer to the suexec documentation (http://httpd\&.apache\&.org/docs/2\&.4/suexec\&.html)\&.
.SH "OPTIONS"
.TP
\fB-V\fR
If you are \fBroot\fR, this option displays the compile options of \fBsuexec\fR\&. For security reasons all configuration options are changeable only at compile time\&.
httpd-2.4.64/docs/server-status/ 0000775 0001751 0001751 00000000000 15032766613 016412 5 ustar covener covener httpd-2.4.64/docs/server-status/feather.png 0000664 0001751 0001751 00000004765 13103401117 020530 0 ustar covener covener PNG
IHDR % @ pHYs tIME,(I|#P tEXtComment Created with GIMPW oIDATh{pUk $bPZA gt)iU( u j@ / G<40` r9{s%P7 3{{}kO r8st`~tN{gunwF\9 &W-T# ۜbFc;7 |= _Mӝ/" @DI`ϴkj Կ_qDu)P/.!>*)9Ǯ}Pm_3!ma 8DFD&]> iI CT55P[`ט.w#;H`A|@)P7(T*6<sDmxdO, VN,z؞ZyXKsD-\ .Pۇwpm-ۂ /4w(5S[Gt #EA< ۮUZ{Q@fVTks}QG {Ƌ0C9*>Ai#UH|EΗS|s9& I-e4c c@Q}\3s}@I7r{\o#B0i`1>Ӫ˘LVAV= Yx<#1&~NւϿY1UЪkoꉿ/mXV /y.-!gtւϿ: 1S EmYȡHSDQ{StKUvijgWtow:i@%OYy743 :2KP*F<W?ZW<#Cn H胮$GKuaWXuuψm<,$+> ϊ'ģ.J̜PV[LZKXΗudž
P7HTިV/
"a "^S
F\;5e_#:æ@s0A%Dda2(梼mj jiƵ.^Ʋ
ZW%ڰقN*3êb|t#)umR`&1)Wuw%*s3o?L7b0$ 3 Mdz}GϢԀz?&XCT Ł %~+O`fDSFw|7$cv 8 =bH㐻P.ʊ-1DAf Ogm18A)C)IZ\.ٻy!gk.NJT ӏml
s%&qSnaܠ<ݽS[ =ly8 Dg8 š
^!js
Tnw7S̵1, XI5
2z&7kFSigG &8JGFފe!Lx] P >Pd *BOUOTe&1
a `\,8̌0*H {qƙo6C0ՈC{XtÛsJ` Y;_{?j@jAݽU'W;K&Li*- 8 ܰ R.*ɳA&@R)/|wӰY2R0ţsmoq O 5Eq+X蕯Ѧx'>
qf?oy;:cP'-3 ]^I=w4h=@/D5+X+saF馊_Њ6 8Yrn ^dqZ_|߹ΤCphs2 vjͭqW n<1c& 4~V
~@ƴ^41۞ȝ=yVNyJxݘ,K 3r[o`Qk4s0n۬Sn7aˌ5Nd0i d:hbG: t%2Gi"iiuZN<y{ LKP01 1 #V= 2sI* '0U~"?؉7ЉF ^HQj:Ll#[f.yeȂ$"'K֙FgrC}JgЉ pBG mÝOK̝;}T:F;C 6(
'/R `HPtflyX &QoġL+01w\8nZvrُ]=1sNNq@< ?{9uyUS ֓r L=n-^VxWNWΘy?L6ߧvgIE :>/{;o?jP%Es!: Y p==Q oӎc]'Y"H`?rޣ/bX&ΜvCk +oy
rݫ9Z IENDB` httpd-2.4.64/docs/server-status/README.md 0000664 0001751 0001751 00000003043 13103401117 017647 0 ustar covener covener server-status
=============
`mod_lua` version of the Apache httpd's mod_status using dynamic charts
## What does it do? ##
This script is an extended version of the known mod_status statistics page for httpd.
It uses the simple Quokka Chart API to visualize many of the elements that are sometimes hard
to properly diagnose using plain text information.
Take a look at https://www.apache.org/server-status to see how it works.
## Requirements ##
* Apache httpd 2.4.6 or higher
* mod_lua (with either Lua 5.1, 5.2 or LuaJIT)
* mod_status loaded (for enabling traffic statistics)
## Installing ##
First, install mod_lua (you can enable this during configure time with --enable-lua)
### Installing as a handler:
To install it as a handler, add the following to your httpd.conf in the appropriate VirtualHost:
LuaMapHandler ^/server-status$ /path/to/server-status.lua
### Installing as a web app:
To install as a plain web-app, enable .lua scripts to be handled by mod_lua, by adding the following
to your appropriate VirtualHost configuration:
AddHandler lua-script .lua
Then just put the `.lua` script somewhere in your document root and visit the page.
## Configuring
There are a few options inside the Lua script that can be set to `true` or `false`:
- `show_warning`: Whether or not to show a notice that this page is there on purpose.
- `redact_ips`: Whether or not to replace the last few bits of every IP with 'x.x'
- `show_modules`: Whether to show the list of loaded modules or not
- `show_threads`: Whether to show thread details or not.
httpd-2.4.64/docs/server-status/server-status.lua 0000664 0001751 0001751 00000240652 14037275021 021745 0 ustar covener covener --[[
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you 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.
]]
--[[ mod_lua implementation of the server-status page ]]
local ssversion = "0.11" -- version of this script
local redact_ips = true -- whether to replace the last two bits of every IP with 'x.x'
local warning_banner = [[
<div style="float: left; color: #222; margin-bottom: 8px; margin-top: 24px; text-align: center; width: 200px; font-size: 0.7rem; border: 1px dashed #333; background: #F8C940;">
<h3 style="margin: 4px; font-size: 1rem;">Don't be alarmed - this page is here for a reason!</h3>
<p style="font-weight: bolder; font-size: 0.8rem;">This is an example server status page for the Apache HTTP Server. Nothing on this server is secret, no URL tokens, no sensitive passwords. Everything served from here is static data.</p>
</div>
]]
local show_warning = true -- whether to display the above warning/notice on the page
local show_modules = false -- Whether to list loaded modules or not
local show_threads = true -- whether to list thread information or not
-- pre-declare some variables defined at the bottom of this script:
local status_js, status_css, quokka_js
-- quick and dirty JSON conversion
local function quickJSON(input)
if type(input) == "table" then
local t = 'array'
for k, v in pairs(input) do
if type(k) ~= "number" then
t = 'hash'
break
end
end
if t == 'hash' then
local out = ""
local tbl = {}
for k, v in pairs(input) do
local kv = ([["%s": %s]]):format(k, quickJSON(v))
table.insert(tbl, kv)
end
return "{" .. table.concat(tbl, ", ") .. "}"
else
local tbl = {}
for k, v in pairs(input) do
table.insert(tbl, quickJSON(v))
end
return "[" .. table.concat(tbl, ", ") .. "]"
end
elseif type(input) == "string" then
return ([["%s"]]):format(input:gsub('"', '\\"'):gsub("[\r\n\t]", " "))
elseif type(input) == "number" then
return tostring(input)
elseif type(input) == "boolean" then
return (input and "true" or "false")
else
return "null"
end
end
-- Module information callback
local function modInfo(r, modname)
if modname then
r:puts [[
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<style>
]]
r:puts (status_css)
r:puts [[
</style>
<title>Module information</title>
</head>
<body>
]]
r:puts( ("<h3>Details for module %s</h3>\n"):format(r:escape_html(modname)) )
-- Queries the server for information about a module
local mod = r.module_info(modname)
if mod then
for k, v in pairs(mod.commands) do
-- print out all directives accepted by this module
r:puts( ("<b>%s:</b> %s<br>\n"):format(r:escape_html(k), v))
end
end
-- HTML tail
r:puts[[
</body>
</html>
]]
end
end
-- Function for generating server stats
function getServerState(r, verbose)
local state = {}
state.mpm = {
type = "prefork", -- default to prefork until told otherwise
threadsPerChild = 1,
threaded = false,
maxServers = r.mpm_query(12),
activeServers = 0
}
if r.mpm_query(14) == 1 then
state.mpm.type = "event" -- this is event mpm
elseif r.mpm_query(3) >= 1 then
state.mpm.type = "worker" -- it's not event, but it's threaded, we'll assume worker mpm (could be motorz??)
elseif r.mpm_query(2) == 1 then
state.mpm.type = "winnt" -- it's threaded, but not worker nor event, so it's probably winnt
end
if state.mpm.type ~= "prefork" then
state.mpm.threaded = true -- it's threaded
state.mpm.threadsPerChild = r.mpm_query(6) -- get threads per child proc
end
state.processes = {} -- list of child procs
state.connections = { -- overall connection info
idle = 0,
active = 0
}
-- overall server stats
state.server = {
connections = 0,
bytes = 0,
built = r.server_built,
localtime = os.time(),
uptime = os.time() - r.started,
version = r.banner,
host = r.server_name,
modules = nil,
extended = show_threads, -- whether extended status is available or not
}
-- if show_modules is true, add list of modules to the JSON
if show_modules then
state.server.modules = {}
for k, module in pairs(r:loaded_modules()) do
table.insert(state.server.modules, module)
end
end
-- Fetch process/thread data
for i=0,state.mpm.maxServers-1,1 do
local server = r.scoreboard_process(r, i);
if server then
local s = {
active = false,
pid = nil,
bytes = 0,
stime = 0,
utime = 0,
connections = 0,
}
local tstates = {}
if server.pid then
state.connections.idle = state.connections.idle + (server.keepalive or 0)
s.connections = 0
if server.pid > 0 then
state.mpm.activeServers = state.mpm.activeServers + 1
s.active = true
s.pid = server.pid
end
for j = 0, state.mpm.threadsPerChild-1, 1 do
local worker = r.scoreboard_worker(r, i, j)
if worker then
s.stime = s.stime + (worker.stimes or 0);
s.utime = s.utime + (worker.utimes or 0);
if verbose and show_threads then
s.threads = s.threads or {}
table.insert(s.threads, {
bytes = worker.bytes_served,
thread = ("0x%x"):format(worker.tid),
client = redact_ips and (worker.client or "???"):gsub("[a-f0-9]+[.:]+[a-f0-9]+$", "x.x") or worker.client or "???",
cost = ((worker.utimes or 0) + (worker.stimes or 0)),
count = worker.access_count,
vhost = worker.vhost:gsub(":%d+", ""),
request = worker.request,
last_used = math.floor(worker.last_used/1000000)
})
end
state.server.connections = state.server.connections + worker.access_count
s.bytes = s.bytes + worker.bytes_served
s.connections = s.connections + worker.access_count
if server.pid > 0 then
tstates[worker.status] = (tstates[worker.status] or 0) + 1
end
end
end
end
s.workerStates = {
keepalive = (server.keepalive > 0) and server.keepalive or tstates[5] or 0,
closing = tstates[8] or 0,
idle = tstates[2] or 0,
writing = tstates[4] or 0,
reading = tstates[3] or 0,
graceful = tstates[9] or 0
}
table.insert(state.processes, s)
state.server.bytes = state.server.bytes + s.bytes
state.connections.active = state.connections.active + (tstates[8] or 0) + (tstates[4] or 0) + (tstates[3] or 0)
end
end
return state
end
-- Handler function
function handle(r)
-- Parse GET data, if any, and set content type
local GET = r:parseargs()
if GET['module'] then
modInfo(r, GET['module'])
return apache2.OK
end
-- If we only need the stats feed, compact it and hand it over
if GET['view'] and GET['view'] == "json" then
local state = getServerState(r, GET['extended'] == 'true')
r.content_type = "application/json"
r:puts(quickJSON(state))
return apache2.OK
end
if not GET['resource'] then
local state = getServerState(r, show_threads)
-- Print out the HTML for the front page
r.content_type = "text/html"
r:puts ( ([=[
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<!-- Stylesheet -->
<link href="?resource=css" rel="stylesheet">
<!-- JavaScript-->
<script type="text/javascript" src="?resource=js"></script>
<title>Server status for %s</title>
</head>
<body onload="refreshCharts(false);">
<div class="wrapper" id="wrapper">
<div class="navbarLeft">
<img align='absmiddle' src='?resource=feather' width="15" height="30"/>
Apache HTTPd
</div>
<div class="navbarRight">Status for %s on %s</div>
<div style="clear: both;"></div>
<div class="serverinfo" id="leftpane">
<ul id="menubar">
<li>
<a class="btn active" id="dashboard_button" href="javascript:void(showPanel('dashboard'));">Dashboard</a>
</li>
<li>
<a class="btn" id="misc_button" href="javascript:void(showPanel('misc'));">Server Info</a>
</li>
<li>
<a class="btn" id="threads_button" style="display: none;" href="javascript:void(showPanel('threads'));">Show thread information</a>
</li>
<li>
<a class="btn" id="modules_button" style="display: none;" href="javascript:void(showPanel('modules'));">Show loaded modules</a>
</li>
</ul>
<!-- warning --> %s <!-- /warning -->
</div>
<!-- dashboard -->
<div class="charts" id="dashboard_panel">
<div class="infobox_wrapper" style="clear: both; width: 100%%;">
<div class="infobox_title">Quick Stats</div>
<div class="infobox" id="general_stats">
</div>
</div>
<div class="infobox_wrapper" style="width: 100%%;">
<div class="infobox_title">Charts</div>
<div class="infobox">
<!--Div that will hold the pie chart-->
<canvas id="actions_div" width="1400" height="400" class="canvas_wide"></canvas>
<canvas id="status_div" width=580" height="400" class="canvas_narrow"></canvas>
<canvas id="traffic_div" width="1400" height="400" class="canvas_wide"></canvas>
<canvas id="idle_div" width="580" height="400" class="canvas_narrow"></canvas>
<canvas id="connection_div" width="1400" height="400" class="canvas_wide"></canvas>
<canvas id="cpu_div" width="580" height="400" class="canvas_narrow"></canvas>
<div style="clear: both"></div>
</div>
</div>
</div>
<!-- misc server info -->
<div class="charts" id="misc_panel" style="display: none;">
<div class="infobox_wrapper" style="clear: both; width: 100%%;">
<div class="infobox_title">General server information</div>
<div class="infobox" style='padding: 16px; width: calc(100%% - 32px);' id="server_breakdown">
</div>
</div>
</div>
<!-- thread info -->
<div class="charts" id="threads_panel" style="display: none;">
<div class="infobox_wrapper" style="clear: both; width: 100%%;">
<div class="infobox_title">Thread breakdown</div>
<div class="infobox" style='padding: 16px; width: calc(100%% - 32px);' id="threads_breakdown">
</div>
</div>
</div>
<!-- module info -->
<div class="charts" id="modules_panel" style="display: none;">
<div class="infobox_wrapper" style="clear: both; width: 100%%;">
<div class="infobox_title">Modules loaded</div>
<div class="infobox" style='padding: 16px; width: calc(100%% - 32px);' id="modules_breakdown">
blabla
</div>
</div>
</div>
</div>
]=]):format(
r.server_name,
r.banner,
r.server_name,
show_warning and warning_banner or ""
) );
-- HTML tail
r:puts[[
</body>
</html>
]]
else
-- Resource documents (CSS, JS, PNG)
if GET['resource'] == 'js' then
r.content_type = "application/javascript"
r:puts(quokka_js)
r:puts(status_js)
elseif GET['resource'] == 'css' then
r.content_type = "text/css"
r:puts(status_css)
elseif GET['resource'] == 'feather' then
r.content_type = "image/png"
r:write(r:base64_decode('iVBORw0KGgoAAAANSUhEUgAAACUAAABACAYAAACdp77qAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH4QEWECwoSXwjUAAAABl0RVh0Q29tbWVudABDcmVhdGVkIHdpdGggR0lNUFeBDhcAAAlvSURBVGje7Zl7cFXVFcZ/a50bHhIRAQWpICSEgGKEUKAUgqKDWsBBHBFndKzYKdAWlWkDAlUEkfIogyAUxfqqdYqP1scg2mq1QLCiIC8LhEeCPDQwoWAgBHLvOXv1j3PvJQRQAjfgH90zmXvu3nv2/u73fWutvU/gHLX9C3IBOLCgc9MDz+S+dGB+l6B0Tu7re2d1bgawd0bn5Fw5F4D+uyCXJsNXs//pzi1U5SMg25zgYkYQY4s76ro3H7/2m8R8PRegmgxfTenTnS8R1SIgG0AERAQR2kma/gFgz7Rrah/UvwdfnpCucUR1KVAvLo4hFj4qiNDz6yk56c3Hrqt9UG3aXxbaw/gz0CHebcBhANE4RKW+RrwW50S+yyavtF0P5T7nH6IfxxCVAWlJCUOmVDXsqzVQW+/PAWDXmC53I9wXO0hgQRh8QClQN7G7KKAEiFTWKqiINuTL/Nzmzsk8c4qL4vkV5kRtjXhkiRKYTyyosCBWTix6gIP+odieWgG1eVi30EtzlhNEvfctkItcAC5QjpTI24d3cP2hbRYt24KW7yCtogQvup80d5SSFpO+KN817pray1NbR3Sbqx4jRUE8ANuunlWKWntRQOy4+Wb201bT17xUa8lz833d+4vKG+JRR9Qg/HvGi8gwEUPU4jkqPgZBy2mrI1XXSKl8G+/60UXOl6nmU8fFwPmCxeQFAumf+O58xQWCc4L5ijkmAKzLz0ktqPW39ghliOk0i+nVzhfMBxdjrQukmfn6gxCQ4Pxj4IJA9vlRferw9O5cM3N96kCt+Uk3ct76hPUDe1xvASNCMIKLaWAxPreAvs4H8wXzBRfTquCey5i96sDevdHj1kyJp1b3657uqbdBlFaSyD0ehepZiXj0EQE8IzEW5ibbD35O1oLPv6q+3lkxVdCqF2tv6om/L21YEJVWxxgAF7PnnS95LhaXLaYhg/HxwGd01oLPv9o6ousJ654xUx+37UXPbctZntHrAo3IoUhT57wGRMQDUXtTlXT16EtVdrzEs/tnh5dX9N10b3c6vPhp6kAlTwJZee8BN+Ph6jQzxOMI6h7ROjJL1FCpKhmIx0Y8rqtXP1qa+fyqk1eEswG0PCPvDkNuFgAf9cvwvQa2SOrog64SJBKyg4GYodjbR0t1YRC1uletWHXKdc+IqaVt8vA8GoAsBbokKz4c8RoFz4onw8SjLkrMnPkSUN8CVltMWksailjOl4e/2XXHhg2pAwVQkJE3SFTeqFYvloryDSIDxWGYCRruIl7SU38N6kaH9Fz5qTvV2jWOvmUZvcNfIzqr+pjDppjJQHPgMEElRGRhMrUo5qK8+G2Aagxqaca19C5exrKM3sMNWlcl2rDZgk6oKoIzw6qKYnz648KCxf/pdCMpA3Vt8VKWtO6djsgUA5yBmWAmBzEpFqFXdXeYJebZKudzM8CesrJvP4/V2EyeN8zgYjCEJBMfCfIzi98Fqh9NgM8Cx7O9txeUfZyZR8+igtSAej/jJpRYuqFDwFQAw8WBua0gvSV+KxAST2Bmu0TEU5VGwHcCqpF8Nxb/AyStY4B2C9A4HA+H7gY9YkjjkLtQLhfKiqAtMfaA/0RBZt7pHadPZ9Litv3pv20xvsk4EUHjsikOQ/IV7ylJWtoQXPIuhdm7ecXLBtTEIaedpxZn9WsuTkpUDMzF049txmyeCnMlDiZx0VPMGW6rwGHn3KDrthfsPN29vlO+11vdEuYg5z1sooTSeTgUH53hRGc4BJfsFwzFoQpetiH7agLotOQbvHMRsxoNVMNudxY3sRgBtlPMtTGR+s4szg4IHsdYE4BJNQ3w0zJ66ybaN8BrGIS3RgJTnGmhE69ngEcgHiaKk/g4SoBHgBRGrd6Kf2X2IaVMAQR4XRWrHxaNUCDMPlBkvAAqQhBPAxr3Vdz4T91U/K6r8WX2uya8mjG4rsENAWHUCYpguxH2gFwsOMyMMCrBiZdIDHtx+saZFPtvle/lNkMw1YhDe1jczAGK73Sow5tzzOBKYAlZBRfKO69f8Xu7P7xqQGpB3b39VQInVzu0rksmTN1pKi0c2jiIgwzwsOSzEhibBxS98/iizAHcsOEdUi6fE++2KrkHzP6kovnJs0GyBiaizspA+gPcUvQOKZcvfHfTsI9ZMveUG1IRoO2rMJewt8Wjc8RtxW8WvZlx6xkfs08ANbZF/nHfK6XeD4+SFljola8C0aaGprl46Cc+DXFm3D+46G+vvJZ5O4OK3zpjUCctM4+3ze+LBR+CXZqmXkk9dzRo6Mo9wc0RoYtAL5FE+TUEK4xY5d0rtXNhRummil+W/cXOFNCKNh31OKbym8VZcm4dXmQRGslxCBVaX3wU37n5zqSXQ3CJaHMy+q6ihR12asvmza30nrMBlLRx9Z7JV4zikR2zmdxu9DwxrhWhY/jWJpjfyB00xX4FVgq8fkDS58a0XoM0/IfF7Iox257InZn5gOQXPXlWwE55Snis3ZjOgiwDSxcMM3IFW4WgDm+XYFEPawQ0EXOFmN0wbtusr1PxbuKU0Tdhy4w1TmSTieKQzwLx+gQa0TD0aQlkOmhi8Nrho0c6Hah0JdMyR6XmnWn1jvyMhyJpaXVaTt08eXsgskyQrghLnOlQFTAxxAwxyh3MFyNWt/4FPR7fMnNJKgCNHPngpScwVX60IhCzluPbP7zYiTfQiUYdXomptkiWFVGcajqio0xs6SNbZi55ZciClLAkIrkngLrwokvEx9aZ6UZncplDyn3TSmfS0InGDKIOqXDIQt/k0ke3/P6DCW1/w52vDk8FS8ydO/vvxxl9VPajEQ86RoQ7wZaJ0UOgsQkHwDYolAD+7wonL6+t/1KMHPlg90i1UHRmbJy+edJYgNEdJo5R828DvcSht0wrnLQwMXdc1jimbp1aG7h2nHLk19mPXZ7f/rEXkgGQPTGPc9ROmRLM006B6PtxQMzcPLEgP3viOQF10uR5/1VTEBgL8taTG8YXco7bCUw90OMZ5m74LQFeVnj7/Z604VdOv/IXV86Yeb72P6mnTL0RvvA236d2Z8dJRQCjOs0+L/t71Tuubz9qUCXR3UWlnxSs2HMhsPGcgzqhIJdZ+R0Vh4/eE3+TcP49lZM9tFEMt2/TjpdjXdv+/LzZJ8nU1Vn3IkgGsBZg5bY/ct6j74utL2JYJtjOnHZDz2ugHZ8SjKYYK9ZveeH7kwpy2t2r/L+dvP0P/Tla8usTzhIAAAAASUVORK5CYII='))
end
end
return apache2.OK;
end
------------------------------------
-- JavaScript and CSS definitions --
------------------------------------
-- Set up some JavaScripts:
status_js = [==[
Number.prototype.pad = function(size) {
var str = String(this);
while (str.length < size) {
str = "0" + str;
}
return str;
}
function getAsync(theUrl, xstate, callback) {
var xmlHttp = null;
if (window.XMLHttpRequest) {
xmlHttp = new XMLHttpRequest();
} else {
xmlhttp = new ActiveXObject("Microsoft.XMLHTTP");
}
xmlHttp.open("GET", theUrl, true);
xmlHttp.send(null);
xmlHttp.onreadystatechange = function(state) {
if (xmlHttp.readyState == 4 && xmlHttp.status == 200) {
if (callback) {
callback(JSON.parse(xmlHttp.responseText));
}
}
}
}
var actionCache = [];
var connectionCache = [];
var trafficCache = [];
var processes = {};
var lastBytes = 0;
var lastConnections = 0;
var negativeBytes = 0; // cache for proc reloads, which skews traffic
var updateSpeed = 5; // How fast do charts update?
var maxRecords = 24; // How many records to show per chart
var cpumax = 1000000; // random cpu max(?)
function refreshCharts(json, state) {
if (json && json.processes) {
// general server info box
var gs = document.getElementById('server_breakdown');
gs.innerHTML = "";
gs.innerHTML += "<b>Server version: </b>" + json.server.version + "<br/>";
gs.innerHTML += "<b>Server built: </b>" + json.server.built + "<br/>";
gs.innerHTML += "<b>Server MPM: </b>" + json.mpm.type + " <span id='mpminfo'></span><br/>";
// Get a timestamp
var now = new Date();
var ts = now.getHours().pad(2) + ":" + now.getMinutes().pad(2) + ":" + now.getSeconds().pad(2);
var utime = 0;
var stime = 0;
// Construct state based on proc details
var state = {
timestamp: ts,
closing: 0,
idle: 0,
writing: 0,
reading: 0,
keepalive: 0,
graceful: 0
}
for (var i in json.processes) {
var proc = json.processes[i];
if (proc.pid) {
state.closing += proc.workerStates.closing||0;
state.idle += proc.workerStates.idle||0;
state.writing += proc.workerStates.writing||0;
state.reading += proc.workerStates.reading||0;
state.keepalive += proc.workerStates.keepalive||0;
state.graceful += proc.workerStates.graceful||0;
utime += proc.utime;
stime += proc.stime;
}
}
// Push action state entry into action cache with timestamp
// Shift if more than 10 entries in cache
actionCache.push(state);
if (actionCache.length > maxRecords) {
actionCache.shift();
}
// construct array for QuokkaLines
var arr = [];
for (var i in actionCache) {
var el = actionCache[i];
if (json.mpm.type == 'event') {
arr.push([el.timestamp, el.closing, el.idle, el.writing, el.reading, el.graceful]);
} else {
arr.push([el.timestamp, el.keepalive, el.closing, el.idle, el.writing, el.reading, el.graceful]);
}
}
var states = ['Keepalive', 'Closing', 'Idle', 'Writing', 'Reading', 'Graceful']
if (json.mpm.type == 'event') {
states.shift();
if (document.getElementById('mpminfo')) {
document.getElementById('mpminfo').innerHTML = "(" + fn(parseInt(json.connections.idle)) + " connections in idle keepalive)";
}
}
// Draw action chart
quokkaLines("actions_div", states, arr, { lastsum: true, hires: true, nosum: true, stack: true, curve: true, title: "Thread states" } );
// Get traffic, figure out how much it was this time (0 if just started!)
var bytesThisTurn = 0;
var connectionsThisTurn = 0;
for (var i in json.processes) {
var proc = json.processes[i];
var pid = proc.pid
// if we haven't seen this proc before, ignore its bytes first time
if (!processes[pid]) {
processes[pid] = {
bytes: proc.bytes,
connections: proc.connections,
}
} else {
bytesThisTurn += proc.bytes - processes[pid].bytes;
if (pid) {
x = proc.connections - processes[pid].connections;
connectionsThisTurn += (x > 0) ? x : 0;
}
processes[pid].bytes = proc.bytes;
processes[pid].connections = proc.connections;
}
}
if (lastBytes == 0 ) {
bytesThisTurn = 0;
}
lastBytes = 1;
// Push a new element into cache, prune cache
var el = {
timestamp: ts,
bytes: bytesThisTurn/updateSpeed
};
trafficCache.push(el);
if (trafficCache.length > maxRecords) {
trafficCache.shift();
}
// construct array for QuokkaLines
arr = [];
for (var i in trafficCache) {
var el = trafficCache[i];
arr.push([el.timestamp, el.bytes]);
}
// Draw action chart
quokkaLines("traffic_div", ['Traffic'], arr, { traffic: true, hires: true, nosum: true, stack: true, curve: true, title: "Traffic per second" } );
// Get connections per second
// Push a new element into cache, prune cache
var el = {
timestamp: ts,
connections: (connectionsThisTurn+1)/updateSpeed
};
connectionCache.push(el);
if (connectionCache.length > maxRecords) {
connectionCache.shift();
}
// construct array for QuokkaLines
arr = [];
for (var i in connectionCache) {
var el = connectionCache[i];
arr.push([el.timestamp, el.connections]);
}
// Draw connection chart
quokkaLines("connection_div", ['Connections/sec'], arr, { traffic: false, hires: true, nosum: true, stack: true, curve: true, title: "Connections per second" } );
// Thread info
quokkaCircle("status_div", [
{ title: 'Active', value: (json.mpm.threadsPerChild*json.mpm.activeServers)},
{ title: 'Reserve', value: (json.mpm.threadsPerChild*(json.mpm.activeServers-json.mpm.maxServers))}
],
{ title: "Worker pool", hires: true});
// Idle vs active connections
var idlecons = json.connections.idle;
var activecons = json.connections.active;
quokkaCircle("idle_div", [
{ title: 'Idle', value: idlecons},
{ title: 'Active', value: activecons},
],
{ hires: true, title: "Idle vs active connections"});
// CPU info
while ( (stime+utime) > cpumax ) {
cpumax = cpumax * 2;
}
quokkaCircle("cpu_div", [
{ title: 'Idle', value: (cpumax - stime - utime) / (cpumax/100)},
{ title: 'System', value: stime/(cpumax/100)},
{ title: 'User', value: utime/(cpumax/100)}
],
{ hires: true, title: "CPU usage", pct: true});
// General stats infobox
var gstats = document.getElementById('general_stats');
gstats.innerHTML = ''; // wipe the box
// Days since restart
var u_f = Math.floor(json.server.uptime/8640.0) / 10;
var u_d = Math.floor(json.server.uptime/86400);
var u_h = Math.floor((json.server.uptime%86400)/3600);
var u_m = Math.floor((json.server.uptime%3600)/60);
var u_s = Math.floor(json.server.uptime %60);
var str = u_d + " day" + (u_d != 1 ? "s, " : ", ") + u_h + " hour" + (u_h != 1 ? "s, " : ", ") + u_m + " minute" + (u_m != 1 ? "s" : "");
var ubox = document.createElement('div');
ubox.setAttribute("class", "statsbox");
ubox.innerHTML = "<span style='font-size: 2rem;'>" + u_f + " days</span><br/><i>since last (re)start.</i><br/><small>" + str;
gstats.appendChild(ubox);
// Bytes transferred in total
var MB = fnmb(json.server.bytes);
var KB = (json.server.bytes > 0) ? fnmb(json.server.bytes/json.server.connections) : 0;
var KBs = fnmb(json.server.bytes/json.server.uptime);
var mbbox = document.createElement('div');
mbbox.setAttribute("class", "statsbox");
mbbox.innerHTML = "<span style='font-size: 2rem;'>" + MB + "</span><br/><i>transferred in total.</i><br/><small>" + KBs + "/sec, " + KB + "/request";
gstats.appendChild(mbbox);
// connections in total
var cons = fn(json.server.connections);
var cps = Math.floor(json.server.connections/json.server.uptime*100)/100;
var conbox = document.createElement('div');
conbox.setAttribute("class", "statsbox");
conbox.innerHTML = "<span style='font-size: 2rem;'>" + cons + " conns</span><br/><i>since server started.</i><br/><small>" + cps + " requests per second";
gstats.appendChild(conbox);
// threads working
var tpc = json.mpm.threadsPerChild;
var activeThreads = fn(json.mpm.activeServers * json.mpm.threadsPerChild);
var maxThreads = json.mpm.maxServers * json.mpm.threadsPerChild;
var tbox = document.createElement('div');
tbox.setAttribute("class", "statsbox");
tbox.innerHTML = "<span style='font-size: 2rem;'>" + activeThreads + " threads</span><br/><i>currently at work (" + json.mpm.activeServers + "x" + tpc+" threads).</i><br/><small>" + maxThreads + " (" + json.mpm.maxServers + "x"+tpc+") threads allowed.";
gstats.appendChild(tbox);
window.setTimeout(waitTwo, updateSpeed*1000);
// resize pane
document.getElementById('leftpane').style.height = document.getElementById('wrapper').getBoundingClientRect().height + "px";
// Do we have extended info and module lists??
if (json.server.extended) document.getElementById('threads_button').style.display = 'block';
if (json.server.modules && json.server.modules.length > 0) {
var panel = document.getElementById('modules_breakdown');
var list = "<ul>";
for (var i in json.server.modules) {
var mod = json.server.modules[i];
list += "<li>" + mod + "</li>";
}
list += "</ul>";
panel.innerHTML = list;
document.getElementById('modules_button').style.display = 'block';
}
} else if (json === false) {
waitTwo();
}
}
function refreshThreads(json, state) {
var box = document.getElementById('threads_breakdown');
box.innerHTML = "";
for (var i in json.processes) {
var proc = json.processes[i];
var phtml = '<div style="color: #DDF">';
if (!proc.active) phtml = '<div title="this process is inactive" style="color: #999;">';
phtml += "<h3>Process " + i + ":</h3>";
phtml += "<b>PID:</b> " + (proc.pid||"None (not active)") + "<br/>";
if (proc.threads && proc.active) {
phtml += "<table style='width: 800px; color: #000;'><tr><th>Thread ID</th><th>Access count</th><th>Bytes served</th><th>Last Used</th><th>Last client</th><th>Last request</th></tr>";
for (var j in proc.threads) {
var thread = proc.threads[j];
thread.request = (thread.request||"(Unknown)").replace(/[<>]+/g, "");
phtml += "<tr><td>"+thread.thread+"</td><td>"+thread.count+"</td><td>"+thread.bytes+"</td><td>"+thread.last_used+"</td><td>"+thread.client+"</td><td>"+thread.request+"</td></tr>";
}
phtml += "</table>";
} else {
phtml += "<p>No thread information available</p>";
}
phtml += "</div>";
box.innerHTML += phtml;
}
}
function waitTwo() {
getAsync(location.href + "?view=json&rnd=" + Math.random(), null, refreshCharts)
}
function showPanel(what) {
var items = ['dashboard','misc','threads','modules'];
for (var i in items) {
var item = items[i];
var btn = document.getElementById(item+'_button');
var panel = document.getElementById(item+'_panel');
if (item == what) {
btn.setAttribute("class", "btn active");
panel.style.display = 'block';
} else {
btn.setAttribute("class", "btn");
panel.style.display = 'none';
}
}
// special constructors
if (what == 'threads') {
getAsync(location.href + "?view=json&extended=true&rnd=" + Math.random(), null, refreshThreads)
}
}
function fn(num) {
num = num + "";
num = num.replace(/(\d)(\d{9})$/, '$1,$2');
num = num.replace(/(\d)(\d{6})$/, '$1,$2');
num = num.replace(/(\d)(\d{3})$/, '$1,$2');
return num;
}
function fnmb(num) {
var add = "bytes";
var dec = "";
var mul = 1;
if (num > 1024) { add = "KB"; mul= 1024; }
if (num > (1024*1024)) { add = "MB"; mul= 1024*1024; }
if (num > (1024*1024*1024)) { add = "GB"; mul= 1024*1024*1024; }
if (num > (1024*1024*1024*1024)) { add = "TB"; mul= 1024*1024*1024*1024; }
num = num / mul;
if (add != "bytes") {
dec = "." + Math.floor( (num - Math.floor(num)) * 100 );
}
return ( fn(Math.floor(num)) + dec + " " + add );
}
function sort(a,b){
last_col = -1;
var sort_reverse = false;
var sortWay = a.getAttribute("sort_" + b);
if (sortWay && sortWay == "forward") {
a.setAttribute("sort_" + b, "reverse");
sort_reverse = true;
}
else {
a.setAttribute("sort_" + b, "forward");
}
var c,d,e,f,g,h,i;
c=a.rows.length;
if(c<1){ return; }
d=a.rows[1].cells.length;
e=1;
var j=new Array(c);
f=0;
for(h=e;h<c;h++){
var k=new Array(d);
for(i=0;i<d;i++){
cell_text="";
cell_text=a.rows[h].cells[i].textContent;
if(cell_text===undefined){cell_text=a.rows[h].cells[i].innerText;}
k[i]=cell_text;
}
j[f++]=k;
}
var l=false;
var m,n;
if(b!=lastcol) lastseq="A";
else{
if(lastseq=="A") lastseq="D";
lastseq="A";
}
g=c-1;
for(h=0;h<g;h++){
l=false;
for(i=0;i<g-1;i++){
m=j[i];
n=j[i+1];
if(lastseq=="A"){
var gt = (m[b]>n[b]) ? true : false;
var lt = (m[b]<n[b]) ? true : false;
if (n[b].match(/^(\d+)$/)) { gt = parseInt(m[b], 10) > parseInt(n[b], 10) ? true : false; lt = parseInt(m[b], 10) < parseInt(n[b], 10) ? true : false; }
if (sort_reverse) {gt = (!gt); lt = (!lt);}
if(gt){
j[i+1]=m;
j[i]=n;
l=true;
}
}
else{
if(lt){
j[i+1]=m;
j[i]=n;
l=true;
}
}
}
if(l===false){
break;
}
}
f=e;
for(h=0;h<g;h++){
m=j[h];
for(i=0;i<d;i++){
if(a.rows[f].cells[i].innerText!==undefined){
a.rows[f].cells[i].innerText=m[i];
}
else{
a.rows[f].cells[i].textContent=m[i];
}
}
f++;
}
lastcol=b;
}
var CPUmax = 1000000;
var showing = false;
function showDetails() {
for (i=1; i < 1000; i++) {
var obj = document.getElementById("srv_" + i);
if (obj) {
if (showing) { obj.style.display = "none"; }
else { obj.style.display = "block"; }
}
}
var link = document.getElementById("show_link");
showing = (!showing);
if (showing) { link.innerHTML = "Hide thread information"; }
else { link.innerHTML = "Show thread information"; }
}
var showing_modules = false;
function show_modules() {
var obj = document.getElementById("modules");
if (obj) {
if (showing_modules) { obj.style.display = "none"; }
else { obj.style.display = "block"; }
}
var link = document.getElementById("show_modules_link");
showing_modules = (!showing_modules);
if (showing_modules) { link.innerHTML = "Hide loaded modules"; }
else { link.innerHTML = "Show loaded modules"; }
}
]==]
quokka_js = [==[
/*
*
* 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.
*/
// Traffic shaper
function quokka_fnmb(num) {
var add = "b";
var dec = "";
var mul = 1;
if (num > 1024) { add = "KB"; mul= 1024; }
if (num > (1024*1024)) { add = "MB"; mul= 1024*1024; }
if (num > (1024*1024*1024)) { add = "GB"; mul= 1024*1024*1024; }
if (num > (1024*1024*1024*1024)) { add = "TB"; mul= 1024*1024*1024*1024; }
num = num / mul;
if (add != "b" && num < 10) {
dec = "." + Math.floor( (num - Math.floor(num)) * 100 );
}
return ( Math.floor(num) + dec + " " + add );
}
// Hue, Saturation and Lightness to Red, Green and Blue:
function quokka_internal_hsl2rgb (h,s,l)
{
var min, sv, switcher, fract, vsf;
h = h % 1;
if (s > 1) s = 1;
if (l > 1) l = 1;
var v = (l <= 0.5) ? (l * (1 + s)) : (l + s - l * s);
if (v === 0)
return { r: 0, g: 0, b: 0 };
min = 2 * l - v;
sv = (v - min) / v;
var sh = (6 * h) % 6;
switcher = Math.floor(sh);
fract = sh - switcher;
vsf = v * sv * fract;
switch (switcher)
{
case 0: return { r: v, g: min + vsf, b: min };
case 1: return { r: v - vsf, g: v, b: min };
case 2: return { r: min, g: v, b: min + vsf };
case 3: return { r: min, g: v - vsf, b: v };
case 4: return { r: min + vsf, g: min, b: v };
case 5: return { r: v, g: min, b: v - vsf };
}
return {r:0, g:0, b: 0};
}
// RGB to Hex conversion
function quokka_internal_rgb2hex(r, g, b) {
return "#" + ((1 << 24) + (Math.floor(r) << 16) + (Math.floor(g) << 8) + Math.floor(b)).toString(16).slice(1);
}
// Generate color list used for charts
var colors = [];
var rgbs = []
var numColorRows = 6;
var numColorColumns = 20;
for (var x=0;x<numColorRows;x++) {
for (var y=0;y<numColorColumns;y++) {
var rnd = [[148, 221, 119], [0, 203, 171], [51, 167, 215] , [35, 160, 253], [218, 54, 188], [16, 171, 246], [110, 68, 206], [21, 49, 248], [142, 104, 210]][y]
var color = quokka_internal_hsl2rgb(y > 8 ? (Math.random()) : (rnd[0]/255), y > 8 ? (0.75+(y*0.05)) : (rnd[1]/255), y > 8 ? (0.42 + (y*0.05*(x/numColorRows))) : (0.1 + rnd[2]/512));
// Light (primary) color:
var hex = quokka_internal_rgb2hex(color.r*255, color.g*255, color.b*255);
// Darker variant for gradients:
var dhex = quokka_internal_rgb2hex(color.r*131, color.g*131, color.b*131);
// Medium variant for legends:
var mhex = quokka_internal_rgb2hex(color.r*200, color.g*200, color.b*200);
colors.push([hex, dhex, color, mhex]);
}
}
/* Function for drawing pie diagrams
* Example usage:
* quokkaCircle("canvasName", [ { title: 'ups', value: 30}, { title: 'downs', value: 70} ] );
*/
function quokkaCircle(id, tags, opts) {
// Get Canvas object and context
var canvas = document.getElementById(id);
var ctx=canvas.getContext("2d");
// Calculate the total value of the pie
var total = 0;
var k;
for (k in tags) {
tags[k].value = Math.abs(tags[k].value);
total += tags[k].value;
}
// Draw the empty pie
var begin = 0;
var stop = 0;
var radius = (canvas.height*0.75)/2;
ctx.clearRect(0, 0, canvas.width, canvas.height);
ctx.beginPath();
ctx.shadowBlur = 6;
ctx.shadowOffsetX = 6;
ctx.shadowOffsetY = 6;
ctx.shadowColor = "#555";
ctx.lineWidth = (opts && opts.hires) ? 6 : 2;
ctx.strokeStyle = "#222";
ctx.arc((canvas.width-140)/2,canvas.height/2,radius, 0, Math.PI * 2);
ctx.closePath();
ctx.stroke();
ctx.fill();
ctx.shadowBlur = 0;
ctx.shadowOffsetY = 0;
ctx.shadowOffsetX = 0;
// Draw a title if set:
if (opts && opts.title) {
ctx.font= (opts && opts.hires) ? "28px Sans-Serif" : "15px Sans-Serif";
ctx.fillStyle = "#000000";
ctx.textAlign = "center";
ctx.fillText(opts.title,(canvas.width-140)/2, (opts && opts.hires) ? 30:15);
ctx.textAlign = "left";
}
ctx.beginPath();
var posY = 50;
var left = 120 + ((canvas.width-140)/2) + ((opts && opts.hires) ? 40 : 25)
for (k in tags) {
var val = tags[k].value;
stop = stop + (2 * Math.PI * (val / total));
// Make a pizza slice
ctx.beginPath();
ctx.lineCap = 'round';
ctx.arc((canvas.width-140)/2,canvas.height/2,radius,begin,stop);
ctx.lineTo((canvas.width-140)/2,canvas.height/2);
ctx.closePath();
ctx.lineWidth = 0;
ctx.stroke();
// Add color gradient
var grd=ctx.createLinearGradient(0,canvas.height*0.2,0,canvas.height);
grd.addColorStop(0,colors[k % colors.length][1]);
grd.addColorStop(1,colors[k % colors.length][0]);
ctx.fillStyle = grd;
ctx.fill();
begin = stop;
// Make color legend
ctx.fillRect(left, posY-((opts && opts.hires) ? 15 : 10), (opts && opts.hires) ? 14 : 7, (opts && opts.hires) ? 14 : 7);
// Add legend text
ctx.shadowColor = "rgba(0,0,0,0)"
ctx.font= (opts && opts.hires) ? "22px Sans-Serif" : "12px Sans-Serif";
ctx.fillStyle = "#000";
ctx.fillText(tags[k].title + " (" + Math.floor(val) + (opts && opts.pct ? "%" : "") + ")",left+20,posY);
posY += (opts && opts.hires) ? 28 : 14;
}
}
/* Function for drawing line charts
* Example usage:
* quokkaLines("myCanvas", ['Line a', 'Line b', 'Line c'], [ [x1,a1,b1,c1], [x2,a2,b2,c2], [x3,a3,b3,c3] ], { stacked: true, curve: false, title: "Some title" } );
*/
function quokkaLines(id, titles, values, options, sums) {
var canvas = document.getElementById(id);
var ctx=canvas.getContext("2d");
// clear the canvas first
ctx.clearRect(0, 0, canvas.width, canvas.height);
ctx.lineWidth = 0.25;
ctx.strokeStyle = "#000000";
var lwidth = 300;
var lheight = 75;
wspace = (options && options.hires) ? 110 : 55;
var rectwidth = canvas.width - lwidth - wspace;
var stack = options ? options.stack : false;
var curve = options ? options.curve : false;
var title = options ? options.title : null;
var spots = options ? options.points : false;
var noX = options ? options.nox : false;
var verts = options ? options.verts : true;
if (noX) {
lheight = 0;
}
// calc rectwidth if titles are large
var nlwidth = 0
for (var k in titles) {
ctx.font= (options && options.hires) ? "24px Sans-Serif" : "12px Sans-Serif";
ctx.fillStyle = "#00000";
var x = parseInt(k)
if (!noX) {
x = x + 1;
}
var sum = 0
for (var y in values) {
sum += values[y][x]
}
var t = titles[k] + (!options.nosum ? " (" + ((sums && sums[k]) ? sums[k] : sum.toFixed(0)) + ")" : "");
var w = ctx.measureText(t).width + 48;
if (w > lwidth && w > nlwidth) {
nlwidth = w
}
if (nlwidth > 0) {
rectwidth -= nlwidth - lwidth
lwidth = nlwidth
}
}
// Draw a border
ctx.lineWidth = 0.5;
ctx.strokeRect((wspace*0.75), 30, rectwidth, canvas.height - lheight - 40);
// Draw a title if set:
if (title != null) {
ctx.font= (options && options.hires) ? "24px Sans-Serif" : "15px Sans-Serif";
ctx.fillStyle = "#00000";
ctx.textAlign = "center";
ctx.fillText(title,rectwidth/2, 20);
}
// Draw legend
ctx.textAlign = "left";
var posY = 50;
for (var k in titles) {
var x = parseInt(k)
if (!noX) {
x = x + 1;
}
var sum = 0
for (var y in values) {
sum += values[y][x]
}
var title = titles[k] + (!options.nosum ? (" (" + ((sums && sums[k]) ? sums[k] : sum.toFixed(0)) + ")") : "");
if (options && options.lastsum) {
title = titles[k] + " (" + values[values.length-1][x].toFixed(0) + ")";
}
ctx.fillStyle = colors[k % colors.length][3];
ctx.fillRect(wspace + rectwidth + 75 , posY-((options && options.hires) ? 18:9), (options && options.hires) ? 20:10, (options && options.hires) ?20:10);
// Add legend text
ctx.font= (options && options.hires) ? "24px Sans-Serif" : "14px Sans-Serif";
ctx.fillStyle = "#00000";
ctx.fillText(title,canvas.width - lwidth + ((options && options.hires) ? 100:60), posY);
posY += (options && options.hires) ? 30:15;
}
// Find max and min
var max = null;
var min = 0;
var stacked = null;
for (x in values) {
var s = 0;
for (y in values[x]) {
if (y > 0 || noX) {
s += values[x][y];
if (max === null || max < values[x][y]) {
max = values[x][y];
}
if (min === null || min > values[x][y]) {
min = values[x][y];
}
}
}
if (stacked === null || stacked < s) {
stacked = s;
}
}
if (min == max) max++;
if (stack) {
min = 0;
max = stacked;
}
// Set number of lines to draw and each step
var numLines = 5;
var step = (max-min) / (numLines+1);
// Prettify the max value so steps aren't ugly numbers
if (step %1 != 0) {
step = (Math.round(step+0.5));
max = step * (numLines+1);
}
// Draw horizontal lines
for (x = -1; x <= numLines; x++) {
ctx.beginPath();
var y = 30 + (((canvas.height-40-lheight) / (numLines+1)) * (x+1));
ctx.moveTo(wspace*0.75, y);
ctx.lineTo(wspace*0.75 + rectwidth, y);
ctx.lineWidth = 0.25;
ctx.stroke();
// Add values
ctx.font= (options && options.hires) ? "20px Sans-Serif" : "12px Sans-Serif";
ctx.fillStyle = "#000000";
var val = Math.round( ((max-min) - (step*(x+1))) );
if (options && options.traffic) {
val = quokka_fnmb(val);
}
ctx.textAlign = "left";
ctx.fillText( val,canvas.width - lwidth - 20, y+8);
ctx.textAlign = "right";
ctx.fillText( val,wspace-32, y+8);
ctx.closePath();
}
// Draw vertical lines
var sx = 1
var numLines = values.length-1;
var step = (canvas.width - lwidth - wspace*0.75) / values.length;
while (step < 24) {
step *= 2
sx *= 2
}
if (verts) {
ctx.beginPath();
for (var x = 1; x < values.length; x++) {
if (x % sx == 0) {
var y = (wspace*0.75) + (step * (x/sx));
ctx.moveTo(y, 30);
ctx.lineTo(y, canvas.height - 10 - lheight);
ctx.lineWidth = 0.25;
ctx.stroke();
}
}
ctx.closePath();
}
// Some pre-calculations of steps
var step = (rectwidth) / (values.length > 1 ? values.length-1:1);
// Draw X values if noX isn't set:
if (noX != true) {
ctx.beginPath();
for (var i = 0; i < values.length; i++) {
zz = 1
var x = (wspace*0.75) + ((step) * i);
var y = canvas.height - lheight + 5;
if (i % sx == 0) {
ctx.translate(x, y);
ctx.moveTo(0,0);
ctx.lineTo(0,-15);
ctx.stroke();
ctx.rotate(45*Math.PI/180);
ctx.textAlign = "left";
var val = values[i][0];
if (val.constructor.toString().match("Date()")) {
val = val.toDateString();
}
ctx.fillText(val.toString(), 0, 0);
ctx.rotate(-45*Math.PI/180);
ctx.translate(-x,-y);
}
}
ctx.closePath();
}
// Draw each line
var stacks = [];
var pstacks = [];
for (k in values) { if (k > 0) { stacks[k] = 0; pstacks[k] = canvas.height - 40 - lheight; }}
for (k in titles) {
var maxY = 0, minY = 99999;
ctx.beginPath();
var color = colors[k % colors.length][0];
var f = parseInt(k) + 1;
if (noX) {
f = parseInt(k);
}
var value = values[0][f];
var step = rectwidth / numLines;
var x = (wspace*0.75);
var y = (canvas.height - 10 - lheight) - (((value-min) / (max-min)) * (canvas.height - 40 - lheight));
var py = y;
if (stack) {
stacks[0] = stacks[0] ? stacks[0] : 0
y -= stacks[0];
pstacks[0] = stacks[0];
stacks[0] += (((value-min) / (max-min)) * (canvas.height - 40 - lheight));
}
// Draw line
ctx.moveTo(x, y);
var pvalY = y;
var pvalX = x;
for (var i in values) {
if (i > 0) {
x = (wspace*0.75) + (step*i);
var f = parseInt(k) + 1;
if (noX == true) {
f = parseInt(k);
}
value = values[i][f];
y = (canvas.height - 10 - lheight) - (((value-min) / (max-min)) * (canvas.height - 40 - lheight));
if (stack) {
y -= stacks[i];
pstacks[i] = stacks[i];
stacks[i] += (((value-min) / (max-min)) * (canvas.height - 40- lheight));
}
if (y > maxY) maxY = y;
if (y < minY) minY = y;
// Draw curved lines??
/* We'll do: (x1,y1)-----(x1.5,y1)
* |
* (x1.5,y2)-----(x2,y2)
* with a quadratic beizer thingy
*/
if (curve) {
ctx.bezierCurveTo((pvalX + x) / 2, pvalY, (pvalX + x) / 2, y, x, y);
pvalX = x;
pvalY = y;
}
// Nope, just draw straight lines
else {
ctx.lineTo(x, y);
}
if (spots) {
ctx.fillStyle = color;
ctx.translate(x-2, y-2);
ctx.rotate(-45*Math.PI/180);
ctx.fillRect(-2,1,4,4);
ctx.rotate(45*Math.PI/180);
ctx.translate(-x+2, -y+2);
}
}
}
ctx.lineWidth = 4;
ctx.strokeStyle = color;
ctx.stroke();
if (minY == maxY) maxY++;
// Draw stack area
if (stack) {
ctx.globalAlpha = 0.65;
for (i in values) {
if (i > 0) {
var f = parseInt(k) + 1;
if (noX == true) {
f = parseInt(k);
}
x = (wspace*0.75) + (step*i);
value = values[i][f];
y = (canvas.height - 10 - lheight) - (((value-min) / (max-min)) * (canvas.height - 40 - lheight));
y -= stacks[i];
}
}
var pvalY = y;
var pvalX = x;
if (y > maxY) maxY = y;
if (y < minY) minY = y;
for (i in values) {
var l = values.length - i - 1;
x = (wspace*0.75) + (step*l);
y = canvas.height - 10 - lheight - pstacks[l];
if (y > maxY) maxY = y;
if (y < minY) minY = y;
if (curve) {
ctx.bezierCurveTo((pvalX + x) / 2, pvalY, (pvalX + x) / 2, y, x, y);
pvalX = x;
pvalY = y;
}
else {
ctx.lineTo(x, y);
}
}
ctx.lineTo((wspace*0.75), py - pstacks[0]);
ctx.lineWidth = 0;
var grad = ctx.createLinearGradient(0, minY, 0, maxY);
grad.addColorStop(0.25, colors[k % colors.length][0])
grad.addColorStop(1, colors[k % colors.length][1])
ctx.strokeStyle = colors[k % colors.length][0];
ctx.fillStyle = grad;
ctx.fill();
ctx.fillStyle = "#000"
ctx.strokeStyle = "#000"
ctx.globalAlpha = 1;
}
ctx.closePath();
}
// draw feather
base_image = new Image();
base_image.src = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAAEACAYAAAB7+X6nAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACJQAAAiUBweyXgQAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAACAASURBVHic7Z13vBXF2ce/z+65hUuxYUNEuFyaF0EEwRaDPRobKsYSW0w0auwKWBKPFUEs0ddujJpEDWo0aiyxYBcEgqKXJsJFEQuitFvP2XneP07b0+utnN/nA/fs7MyzszO/eZ5nnpndFYrocNC7q7s1SMNvUY40qsNQa3NVvkGZbYw+02Ndl6fEW9OciSxp6coWUVg03Fd5hqreoipboaAKqAT/Bv6pUmtUzt78kqX/TSevSIAOgrX39Nmi1PI8BhwORHe4ESJkCP9Vo/xlM2m6QC5Z2ZBMbpEAHQAbHqiqttU8h1IVTozq8BgCmMh5VX3H+Dlyy0nL1iWSXSRAO0f9fVV7gvkPsEXUibgRL7EawEUGmec4Zr9EJLBa/haKyBUN9/ffD8yrxHY+BIauxCcRmyyA6AjLtp7TO6vKYsUUCdBOUX9f5TGq+jLQPVkeCf4nCciQAGPXNzI5oYwi2hc23tv/dEv0IcBOmTGdGTBucyCoomI4dLNJS18NiShqgHaGjfdWnizwF9J1fhrEaYfAUBcVHvj2lmFdQ/mKBGhHqLuv6ghB/kqm/eLq3IT2Pwoaytun3DScG0otEqCdYMO9VWNRnQ6UQHBqlwHE/SN6tCeH6oV6/8gSKBKgXaDu7srdbfR5oDw/SRr5mUo7CDv8tOang6BIgDZH4wOVA7HkRU3h7adEgtGeoMND08FwolgyHsCT00WLKAjqH6zq7fj1TWCbvARJ5I9ClCJInl+OUA34iEW0AfTu6m71dsO7qOyaKp9Iut5Eg9M+SRcWJmaqaDlmUNEEtAHUi1VvNf49XednAAM0EWUIogkTmgYmChb5LWt0kQBtgLptK6cBR+UpRoF1QHki7z+pahd1O4cjiwRoZdTdV3WmIBfnK0dgAa41grDjl+lUMJC3d17RpiKyw8b7+h0kKk+Q1exLEnhqMhMYQjBmkKxcXIqGJQKgsLZIgFbChrsHDLEsXgEqsi0bQ4D/AdsCPaMzEWP+JcEvV0rAEviLJqAV8NXF1Vs2fCc3omyep6gvAr4+fRKedTt8ZBQW7lkkQAtDx2OXlvr+bpoY529gXk4yAmHhDcBHKCOT5YvfB0BSfyCYZIoEaGF8XzngJoVDARpX2yZHMUZV7wCOy7xITPwgRjsE4RQJ0IL4dsKgIxW5PHSshpH+OvkoWzmCTBVLTiWl00e2u4RAij5Ai+H7y4cMQPQxYtq+cY10RclGEzxv0EqUnTLJnGQfQLK8RQK0BL66uHcXx3L+CWwWe06NVDdvsD7IUNRSFZkpcHymy8MxVwv8SU6GjcXFoBZAaVnFvaqMSHa+6UfZobQHPlKr9AYR/RPKw4WqlwAqkRmjwrdFDVBgfDNx4HmqnJYmW7+mn6z3U+ZQuUBVLiHbPQJZ7BISdFWRAAXENxMGjsZwa2gFLhWa18lglPqEJ1X/ArodMCo6ubC7hASWFQlQIHx1cfWWOPJPVMrCT+WEiJCYDNs1rrFnJkhfatk8gvDHwtQsyS4hARUWFwlQAKgXy8b/hCp9CTyJE/6nMU/quOGrY7ga1rqSmsSyfm2M9X9Aac4VSrVLSDHGx0qnQf6njnxWdAILgFU/DbpchIPB1ccanIoFvS4NnolSz8pWjT9Yb3TZxhwAICJXqjFHAMPzrZOq1pkm62vjkzW+Rmk2zZSpw1ao9AF6A1tt+1P3T4sEyBOrLhg8UpXrFA2stiXYmiGQlAj+ehmjDt+JzceIvI/qe6mupyqBXUKKUSOrjY/VpknWOc3i8zdLifrpoYbtCSwWDUwuiP/JA3N9RQLkgdUTBnVvbuBJoJTgKg1uIgT/JiSCashT79bwnfV2t16+PxjDSwoGP98ZR9aroc7x0ag+mo0fNX6rBIduGLbUwIpg6F/WUJgJxU2heaGpjruBKgTX6I8QgVBSIiKE1uRV8TXx8PoVpaersiMB259zx2YOKRIgH6z8/aDjUTkldBzu3PDoT6DyQ0QI/hVAVR7H0oVqeALJw/HLDurxBOIQxV3BOaD2t4P62R7rY6AHouH4uzvyEk4LnwsSITo6s9o2zbuY0pLHgf1jzrUkZm83ZcloKD4YkjXUO9YjlvUPlB6RbdYSfhoX11O5UVNAE5wWmqi0c9Qu/SVG9o87l3Y3eO4QlRdCv4smIEt8tfLba0Vkz7AaT2D7wwM4pe3nSUv97xiPvTC0QcftF0TJLrRGMPw79LNoArLAl2cO2VfhTZHgo9spVX6QErFqPRCF+8H2+apNecktoKfGnHPldz3KVTgi1Gw3ZcnQ0EFRA2SIFSftsgXG+RuCHRn9kQ6KHuWBBA33pkb1naLnaknJEFU9JaoMLgdRcbFBw4985esnKPKY+7hIgAyhHv9DwShaJC2kuENE0IDzD9FEQII+QsBhfLrBcp6vwPMJRiQmJoC7WEA2uPdxJYwoZg7HUedxd0KRABlgxak7/1rhmLCDFmX7XUQIdZuLCODuI/mh2Wf/obycKxQGRc6F/YIASaJkE/6RNrScHi/2nrp0pTuhSIA0+PKEQb0clT8HuyicHj/vj6h8NxHc837gDyW200MME4MZo2ICRJXOMLQcqz1SEEGE/4tNK04D08DxlDyIYcvA8m5gyodrmTdutc8QnBZKJC3Qc//a8f6F0xHuVZXyqDLBpeOoqWSS6WX8NRNMLxNOIfXzbW5e8kZsalEDpMCyk4aeqY4eFvtoVqa2XyVIAtF14jfnf332kFNQDkjgF7hkB+XkEVpONIVUlTslATWKBEiCz08e1hu/My3c0GEbTEa2P5oz8scusKHBYUpI50ap/BS2P9vQcpgIrjqJxXoP8mii+yyagARQEPGZh1Rlc1yqPCq6F2UGQipfoiOBgc0hc/tsWHBPo1hXAduF1Xisyk6k8mOvqUQiirGmJ86MROpjVB7ZeuriDYnutRgISoBlx1afp5YEHCZ3IAZwv2cneQAomA+MKntZJfZqcBYglCUNDrnKh66TSHZ0XYCgvLj4QCSvT7EG9Lp14YpE91rUADFYNH5YP4PcHLWfL2oUSnAUxqYTM/oF1Lq7398WzBI101DKwg6ikfjRG6dZXBrBJTu5ExivPYJ5H03W+VDUAFFQL9ayT3aZocK+uEaqJBiFMSM9ZvQD8C0lJUPE+EYg+mZCbREsn2j0Jh79SfImkhk4dhxjDdnxzoWfJ7vnogZwYen/drnIKPtqjA2NtsHEjNrEtl/g0r51Azag3B7vF7j/ScbTy4RaIcUU0ihPpOp8KBIgjIXjhg8EbojqgBARTAoihJd+XURQ3t3pHzVP1JbV/FaV4THnwrLjzUAMEQzJiZDejKhHrSnp7rtoAggo+88P3+U1hODuXBI5U8EfaZxAMFiMwSn73CppXIIE3wHoluM2G7FyotI0gRlIqfLdPfp077sXjU9370UNACw5bNiZqBwQpfKTRt9cTmCiEarc3//Jz+aIp/FPqmyTcJSaaI2Q0AlMFFHMfArpWOr8KZN73+Q1wLIjh27r91kLVQJv3IqM/tROYJRGIJz+k1PaPNAypZvZUINometcQs0SNdLTTi8zm0KqcF+fexeek8n9b/IawNcsd6qyRba2X+Nsv6CqVw96YskPluEOVcqS2f5oJzBz25/hFLLOOFyX6f1v0hpg4cHDDxf0hWQ2GGJHv8anRf5+WlUyeMQXLPi5qLyRUE6M7U8+vYy3/YmnkPHaQy25bqf7F1yTaRtsshrgk4OHdRXlzsjolTS2n8QbO0P/0MuofkoxckfCMG0C258wtBxl++Onl6m0h6h+X+FzpmXTDpvsYlCpXyar0A8hauUNIOGCS7CcuP4Prbyp8sqgFz7771IZdiroLgQe3QosDCnuDT1BrohrYUkj6UQGd7g8rtc6hssHMsZuSjFY12/9cE3CmH8ybJImoGb/4aMt+ACwUzteyVW+K81xjI4wXc3i0iZrIRaV0bJinMmkJsZlHpKo/DRTyJrVJV1GjHpgri+bttjkTMCMsWM9YuR+NWIXYuVNDH8d8tKnn5Y22ucClfEqO6LKU5mYhCo/lRmJrreqI+dn2/mwCWqA+fsMv8Rjy61A4kBK6G8iRy04ml1pdeq3BzqbN68vabC+QNgmxapc6uml67oSrFPi8sSMfgWRv/V9rObUrBoiiE1KA8wbMmaAs8bzezU057fyFk6bNvi1eatK6q0JqGzjPpdwNTHV9DJquhejEZJoj6ATuB5jJubaJpuUBvjfoFH/QTjM09W8a1eYnwE5234RvtPyxgG2r6Lc4HyB0D2jhzoKZPtD5dXi/Mq/18Rt9swUm4wGmDdo1FEoh6Hg32hXYmiOC6RkYfvV0asGP794g1FzDUr3qBBtFrafbG1/dJ0/XbFy6/vyaZdNQgN80HvPLmVdfJ8BlaGRY3c179gVum/mQZeotfgF3zpbDN++9McdgUUIpfna/iSh5VTaw6/oXv3/WTM7m7aIxSahAcrKnYkYqXSPUqfe7o+hKdGCS9xsIOQnRHbdXLLfW2/5Ra0bUSmN8gtytP2JQsvJwseqYGBKvp0Pm4AGmFM5sg9YC4GKWBttdeGdkm7OvuG0sFftzke07UfeHPL2vAMWHTB0mGLPQ7ASzhRcMt2ysggtJ9Ueqiy0u2/crd8jtY05NksYm0AkUP6MBr7SoUqkcxBMA4O1gkaR4Ns4lfine4IIljXG5hIANfYUJKBBw3KVcG9qWCBR28lDUgP9GqhMomcDwzIUJPohUZ+onlaIzodObgJm9xt1ECpHRyW61a1hG3+dPSvTlTdR/jl0xrxPFu434ueq8otMNnbGOZMZTC9TTSFVrYv6/yt/1R9CpyVATXV1qSB3Jc0QbFxTL0Mw1CfzwEO2H8Xx++3rANTRaxP4BcmJkGhWkXBzRxrbjz424F/z7ylkO3VaAjQ0VFyiwSdwU0GVbXz19uw4JzB+182jwz6cu6hm32H7q/LzNDtyooiQTWg5afgYPqSx8axCt1OnJMAHvffcQVWugkgbp4JTJ0NVpS7ugc5Ix/gcy3NjILN1TWynZf1AZ6plZU1EBPm4udEcPuDlpU0FbSg6KQFKPM4toN3caamIIMJWzkZrjtv2R+/ZkweHvTd72YI9RhyoKvtmYvs1B9ufZAo5w24sGVv9as2PBW8oOiEBZvcbNRrRE5KdT0YEf6PsooaNsdE3VWk0+CcDGMEbZ/tTESFL2x+3KQXu8Xd1ftH/9bnrQvWcM3Jk3FdI8kGnmwYq1rTIjCq58g+dCU+9hS2dBustu4sZG7WBQ/Tu4bPmr/x0zPCD1bB39HQtzZO9ESGuKWDM4+DBcjGbUlYb9JwhL81/JpRv3phdB9iOfS0W04HnMmmLTNCpCDBrp9HjBH4WSYnMn5PBfcY0yTC7jA1qBWL7ImykyZkayGh5w2VCnea6TrjTg3P6QEwhpiYKad4LYFD5u+W3Lx381twfAOaPGLGnipwjPk5E1CNSkvd3h93oNJHAGWPHerqtqJ9P4Ju6KZDaJbQ9+pbd1YwFUJEbdp0394+f7L7bL0R5uUUf6kBfN7ZMqH79k3mfDt1tmPFYR6DmFIRBLjkLh//vfzunvr/s0Gk0QLcV9b9XGJKe0am1guOXEZZjrRVLpcRXejuAGLzhEkF17o4URkY/rtEfE1EMnovVHoq87zRb9/nX4UHk3I+HjjzEEXbERGyKBDWGIs9n0BRZoVMQ4L1Be3fXZt/VEN2tqcmQlAibOY3yttWF16prPvxx/q6jDlNjxsS9JiZEBI2M9HjbjzHIahH9AcNGNdKEQdWRElW6Gb90x5FhCH+LeAhuc+GWK1hiwm/4LBQ6BQFKm5qvQCTu9epxHZIQ8UQwfrbv2lR2ZyDVuQYVV1w+qvA6g3yLQx1Kszrix6FUjXQ1PtkKpSewLcK2hEyC22SE/mow3h8e6a6aRYiwYpd58xJ9YygvdHgCfNB7zx3AuTBVnqyJoHrv4MXvb5g7ePQh6jd+Vd5WQB3K8Ut3VXpi6Engw5DJp2Xi/hMazpp8uzggxBMBQAyPSgJ1lS86PAFKPM5NChWZ9HKGRPhOms0DAKZJrzNNMjpl7lQnQ+Y/yu5HrexlRAQU9VtEveK1UOjQBJjVb/RwVX4dlZgnEUSYOmrV3Pq5fUcfYmB0ukGXGakIB4qiVH7wRBQRQs5iWK4AvD7qszlfpLtELujQBBDVW0ASRzNzI8IPXbpUPADgCFdJ7NksAkvpMkY6PYYIIRmuWYNY+ud0YnNFhyXAzH5jDlbVgyAzNZwJEUCmVNe8tXF23z3GgvlZfM7MA0s5ESGREwhLd1049+V04nJFhyWAqIYfgc6o0dNn+qFrRZf7AFT0qhynkFlcLjpjQidQQUTvFLL63HxW6JCLQTP7jjkKGBObnmyhJ5NMqtxSXfPWxjl99xgDemBGsqLCf1ldLmnGmO3ia+wuvoczKZ4rOhwBFCyBa9PkyZwIgYw/dOtacQ+AEXNV1rJagggGMHrb8Pnz6zIplis6HAFm991jPDC8kI2uhjuqa97aOLPfmGHA4bnLyrxOGdRrnaX+gm7/SoQORYDpjLcVvSY6Ne9GX18qzXcDWKoTY1Zrk8pKjfR1SidLVG8fUfvx2iSnC4YORYC+fb86haSrfUIuWkGEu0bUfrx2dp/dK1GOT5gpAzmFrBPwrc9j355WfAHQYQgwZ+TIEoP+MbNYaMaNXm/bvj8DqCWXITGzooIRIas6IXDhHktnrc9IbJ7oMARw1ti/ASohGzuautEFfXC3pfNWz+w3Zlvg9KQZsyBC3uZB5eGRy2dPTyumQOgQBJjRd2y5IlclOpdHo/t8UnJ7UMhFCl1ynUIWsE6LSxsaL0h/hcKhQxCgXBp/B+yYKk8Ojf7E3ss/WDGzakwPQcMvVcxhClmoOjVg9MTh37XstC8W7Z4AL1UdWoZhQhrnPIwMG10t29wCII6eTYIl3YxVemGI4IjKSbuvmDMv3eUKjXZPgC38P52B0BtAkXSztDBSN7q+uPsXcz77vOrQMlG5KD9ZmWdKkqVZ0ZNG1X5UsJ2+2aBdE2A6421VuTS24/MlgmUCr1Ff4//xJIVeeUzXcsrkylKPyLjRrej0xaJdE6D3Tit/pSJVoeOCEEF5b/cvZ74fWGeRS+JzthoRalV1792XzXoJYO5Oewz5qGr36nRiC412SwAFUZHLAr9Td3w2RMDWKQAf9t3zEESHJs/YYkQwIPc0l5YMG107++N3++yzxUd9x0x2LPN47dK+i9LWv8BotwR4r3KfXyoyIpuOz4AIC0cv++glAEvNpa260BPItERh7Ojls86z6kzJrH6jryq3m79AdJJgXXM8Tzlpq1NgtFsCiOqk0O9sOz4ZEUT0ZgHzUd/dd0U4MJK/hYmgrAS90Gp2RliOMbP7jn7U43G+FrhBYQvg1d2Xzyz4nv9M0C43hLxXuc8+atg7dOz6nHJOx8G0r+wtnSdYDkatSxL1pYbzpkLmm0GA5cBTIroQtQ4wpXI1sHVMxnpVMvq4Q0ugXRLAGLks+smbvDo+9PPWUXPn+mZWjemNn6RPDwfKh8qmQnoiANtCIIYhkiSfyDVjamctT3mpFkS7MwHv77hXf+DwkBrPV/UH035s6NrlLwD4uECRkkzqUoAVv4pUsgRm1C7v0yqrfsnQ7gjgWPaFitjutFyJEH7sUuTe/Wre2vjeoL27I/wuUZlUaIkVP+A7UefktnD83GhXBJhZNaaHipwG8Z3oTsv0OJjms23nPgCryZxpsDbPN5ZQAIexCdHjR62Y+01GF25BtCsCNDhdzlKkR74d7yaPoI/vsXTWSgVLkfMzlZEOeRBBRfS3o5fPfifji7Ug2g0BpjPeRvmDO61AGuAOgA/77nkkUJmt+UiHLImgilw8evnsv2ckvBXQbmYBW/ddfQSwUyIPPudZgPDGPsvf/ziYdlFQI2QkI1laMmQwc3CA8/aonXV/WmGtiHZDAEXOgdQdkPWxkdsB3u23z3BV/Xk2MlLlSX0fobJRaFDllD1WfPRMXIE2RrsgwBs77t8f9EDIrAMyPF7ysxXvvhxMuDBbGZnmSQYXEZYgevwetR99krZQG6Bd+ADi0XMVsZLM4bM+DqbdLmDeqfrZ1oqcmKOMjMokgQKP1HftMnLM8kDnv99/r23SFWpttDkBPui9Zxej1umh4wJN/35saOjyNwD8nAOU5+hA5kqEj0X053vUzjpjG1Y3z+o3evzMnca8ZjkmZQSyLdDmBGjwdDkB2LIQHR8+Vu455Lv/1tVUV5cq8vs8tEi29ahR5AzHtg9RlR1m9h3z8Ia6bl+qynSE/R3HfjrnhmohtLkPYLDOgoI6f82C3gPwff3Wx1uY7bORkeN1GxV5B8MqLM63HPMX4gfX2/t89f6qLJqmVdCmBHi98oCBatgDCur8Pb7vine/ARDVC1rC+UtwXA4c7O7yuDwiT2TcMK2INiWAMdaZod+F0gAqgcDPm33221vR3fNZQcy1HgnSfFaz+VeGzdKqaDMfYMbYsR5Fwu/3KZAP8Pb+y2d8AiAWF+YiI8frppShIv8d8/VHa9K1SVugzQjQtLzsEKBXQTtAuQtgRtXY3qqMa0XnL52Mf2bYLK2ONiOAIqcXuAO+7tFz/fMAxmedTfBBz9bUAElIuVFLpU32/GeCNiHAK70P2VJEj4DCdQDKvaPmzvXNGTmyBOE3Be3EDI+T5Hlyn8Xvb8ikXdoCbeIEmhLrWFEtg4I5YU1qyUMAa9dsfizQK1dHLpcyqeqO8JdM26Ut0DYmQCN78gox8gzWkwcuf+O74MnzcpHRQhpg0T617xf8/b6FRKtrgP/0PWw70J8XcuRZlrkb4M0++1U7IvvkIiOXMmllKA9m3jJtg7bQAMera89fAUbezAOXvTEbwG95Mt7xU0jnL4mMZstj2s3Gj2RoCwL8CgrXAUatuwBeqjq0B8rJbaH6E8pQeX7vLz74PrMmaTu0KgGe63/UjorsWcAO+N6UWM8A2H7ndBXploOMXK6bVoZlt9z7fQuJVvUBbMc5kdDmuAL4AAbr3sOWvhz6mOJZuchoER9AmbPPsvfey7BZ2hSt7QQeV8AO8NmO8wDAy31+cYCi1TnIyIuAyequIrdm0SZtilYzAc/sdMz2iowKHeerggX918FfvRZYXrU4NxcZ7uOCOX/Kyu5bbWh3e/+SodUIUGo1Hw6Bj6QVogMM1r0A/93xoF7AEQX24LM6jkm7Y9Tcub7MWqXt0WomQFWOUOK3ZUNOanvhobUvvwPgs0vOErSk4HP4LI5daRsc234oq4ZpY7SKBpjee3wXRQ6Awow8I9a9Ajqd8baonpmLjEKo/gQyHjpo2evh7/x2BLSKBvCU+g9QIxVQkJFXj8PfASr61f9SVXrnIKMgzl+MjAb8dBjnL4TWMQEm8gr2fDtAVR4/4ssXfwqeODsXGe7jXMokkmFh7tp/5YyvM2qPdoRWMQGCHlwoFSyq90EgqAQc0pbOnythY6OnfFpmrdG+0OIa4Nkdj+6vSL8CqeDZh3/5n7kAtt/8TkXstnT+wjKEaYctfXl1lk3TLtDiGsDYVviRr3w1AHAvBPYTIvqbTMq0pAYIpq3xeUra9C0f+aDlfQDlQJXkT+UmSktyvFaa+SfAxtruhyvskEGZFtUAwYObD1v6cqu8278l0KIawIvXAsZCQTTAI0eseqE+kB6I+2dQpqU1QG1XX93dmbVG+0SLaoChlZ/upkZ6QgFGnglsrnih8og+xsjBOckoRD1cxyJ64V4rP2zIrlXaF1pUA6iRg8K/8xt5M47+8t8LABy1zgLiNpRke5yP1ggev3rw8tfa5OWOhUTLEgD5eYGcv/sh6PwpZxSiE3Mp4zpuciy7Vb/s0VJoMQIE7f8eoeM8OmBNqaf5OYB1yzc7QpFeBRi9+WqAa3+57KUlmbZFe0aLEWDnyppqYLN8O0BEHwlt+lCR32VSJpPjPGTMKu/beEs2bdGe0XImQEm49Ss6S/oG9zklDwM8U3VMb0WSRhSzPc5V9VvGnLnfW2/5s2qLdowWI4BRa0/IswOU947/8qkFADicTgGcPzeylqFy5S++fLUmi2Zo92hJJ3CvfEeesawHA+kIyukFst+5lRH5z2ErXuqwEb9kaBECPLrDqVsBAyCvkbeuvKnpaYBndxq3nyL9c5ARd5wjeb5sbi49TcAVAuwcaJFAkFNij1JEII/Ai/CPUOTPiHVmTjISHOdQpkksPfaYr59tl8/354sW0QAbSroO90nJEshdA4jRhwCe7Xv05oqMy0VGATSAqsjvfrnspTnZtkFHQYsQwKg1dL3VY10ezt+c41Y8Mw+gWUtPBrpkLSPJcTZlVOSaI5e/8LfcW6L9o4WcQKn2iWf3ZilZmEsHYEUeqhTR3xSi47OVIehfj1r+/PU53X4HQsEJ4MVrKQwBWG9vVh9Kz6ID6prt0icBpvcdv6siu7nlt4oGEHnmm622P5tNAAUnQEXlj/1BuijgxxrZQOnCbDpAkX/+euk/1gMYtaJ2/LaSBpj+3Zbbnnj23Ac6zN7+fFBwAnjEHqqEPGlhg92jAbLoAA286eOlqkPLgBMK5fxlIkPQJzfvu/bkTaXzoQUIYCzCnz9VwBF7tyarbEGGnbTwpBVPfAiw3t9jHEJP9/mW1ACC3vFx7YiTO1OYNxO0RByg2tWoAKyT7mZr1hCbnuD4gZAQRU4N/c5jDh/V4Uny+BDOG7f8uQeh3b7Mq8VQcA2gyNCg9g+PMCPW0Ear/DNXnkQjsdnnK/kbwBM7ntBLiez6KYQGSJLnR1H9xTHLn233r3JpKaQlwE0DLx2cqbDgHoABGhpbLiKss7qlVsGqz5/29WNrANQjJwN2Th585qr/Axtn5DErnn0z0/vrjEhLABV7+8kDL5t+U9UVW6fL22Pguu0VyoI75ggRQQVUrKFNVtknkLST/ho+VjklRw8+6bErzQGm/LjVlmPHHim3iwAADrJJREFU1T5Xm+g+pg28tGe6e+0sSEuAqxZPnQGyTizfZzcNvPToVHn94ukb+q2EVk4CakCBdXaP0iSd9G2vfqv+C/BY5SmjgF3c5wvo/C0T1X3H1z49KZmnf0fVhed6fH470bnOiIx8gKZm3+UgfsF6dvLAy+/39vWWJ8pnjO4UaezQvD5CBIMMabRKP4ntJIP1SMj7th3ntEKq/iB8wJ10Zfj4FU9/kKju0xlv3z7ggvvBdL9o+Z+/y6RdOgMyIoC39o61oH8I+uJnlZXWv3dz5cQ+sflE2Cn02x0LiBzDBqtHWSRPoJM8+B8FmF49vtRgFfolkm+L0V1/VTv9wuNrntqY6P7u6XPOFl9Xbf8sah2y1r+hQ7zcqVDIeBZwxZJpz6L6dKAjdaR6zKzJgy8d6c5jwm//jiCWCI7I4AYpm+fqpA9Oqn1iEUDzxtJfIvQshAYAPlWVY06sfXJseFdRAtxeddGejaWlcxU5QtVM8tY+0phpm3QGZDUN9JTK+cBaAIXt1Fgzbh5w6b6RHLp1oK8TjdwIEdZ5ulcAqggqEefPEfv0Ajh/i4xYp1m1ZsSJK558Ntm93Fl1ftltVRfeqPAuSD9g5sVf3NluX+veUsiKABNqbvlWkRtcjd7diPXSzQMn7gOAWNuFbX5MLCCEwHlrUL1dPg9oMGo9DfBw1RlbC3poIE/WGkBV5A1VOdZT6x968vLHH0v2VW4FubXqkvE+7BpFrlSwFZow1lkSclc2IWQdCfSVVNxV4qs/B+gf7ICuDubZG/pfspsqW4MggIbaUggeh5o3UGqjdOtRrs1Pn7HikbUAtt85SZGSQJHMoniKrEZ50hJzz0nLA2YkGbxjvZ5uq9YefquKF3Q4GiXHe+my2z/Nti06A7ImgLfG23z9oAmTRHnK1T09xfY8AbodRLz+kPsXGlbhTWIKjlC1xurqfr3baRl2/Ocq8jzw77LlTR8kG+khTBl04SBL7TP4ev2pirV9uHbBSxiVt3daurLT7PPPFpI+SzwU5MZBEz9CdVQiIRKjSaMNQPj428Ze3Xb0vuX1P9rv1GGq8klMeZ8iqxX53of9sVjyjlViXj1z8cNJP73m7eWt6NplY6URxqjoPhbsDTog8c0qoKtK/LrbpjTti0VOi0ECer3oZEGeAVCXanf/iozeULkonfCo9y2vH+Anu/vhJWre9Vmech92D0c8WzpYWwvaC+gF7AqcLoqZPPDyVaDuDqsX2AplB9i4mXGRLKkmCvzfgOpxm3LnQ44aAAJa4IZBkz4GHSauxGgFHrpIvEYQYw2dtHRKjXes1+P5puFLlO1jNETS8pE8GnPsTkpUj3AGn2CNu/zzaf9JfoebBnJeDRRQFW4HV7QvagoYQQIPfu6kpVNqAOxVTQcrbB8qG+ruVOUj10wQcQwnJaoHKOJDOKXY+QHktRy8ub/uiaCdBiKdoCEiSHRnhuf1oq6dtvprd9kwESQXIkg8EaIJWSeiR09YctsmN99PhrwIcMHSu5oUHgF358SOyLjO9Pn8+gTAlEETuqtwVOK1g4Rlib6WOy1+8SkiB0TkKyPsN2HJbS/lc8+dDXlvCFHLeixV6DeOCKKveL+Y9j1Ao9jHABWpyiUhUTBPsogjuIkA8obf59v9iiW3zs73fjsb8iaAd+FNnyGyIN0aQKRj7Ij6N6FPvCQvF1U2CREgWcSRDWCdP3HJLQddFfT2vX0v2jyf++1sKMiWMEWeCvxK6ngR7NB1FXVNLwLcOOTK7RH2z7CcKw0XEeLnB2EiKM8bx6m+YsnU/wvFIG8aePlh5VZZj0Lcc2dBYTaFiryiqtdAeI7tmnNHYgGK9eQlK29vAPDDCep63j82chCJKSQ6G7psMFWjcs4FJl75+S1vuKs4ecCE36M6eNKyKUUfwIWCEGBVxeq5vep61gFdFQ33UHgNAEK/wurfKL+WUDxW44I0cURwHyUMMYsswJEbrvz85ifdizo3DrlsKI411aC7lzpaTRFRyDkQFItrBl/xBsj+EaHRRABq/7R4cqWAequv2FkdCb9pI0rJa2xaID1RRYPXmSMqN/mXlP/bi9d4R3orrLrGIeI4e4nIUQL7A4LIr65aPGV6Ie61M6FgzwUo9jzB7B/4DYE2D55TBZFHw+uBjnWykiRULIEUjSJCvEkJljMgW4owzTOo4bbrmbg5Gxs2FwDLilwbHri62PkJkZQA51edX7aZZ4tTEYyjvucmL5qc+gUJyhcqyWy1qO23QupfFE4KnE+cP0KeWCLEmRQLqDShMsH0KMdQrHcdT/n5FJEQ6UyAXDn46j+JyFUCM0HewTLveUo8M70fe9e6M/5p8JWHgLwSLTzce+9du/CmnwFcNeSqfS3l7UQXTx7zJ7TilKDCKWP+c0p8HDhp2ZQO9RmX1kQ6E6A3Lbrh2qsHX/2pijwK+jOM4G9yuHrI1etRvgLWCrKFotsEi8SPVo18Q9eCE2PduGSriIG0AEIOo8YRIfHMQZH3Sks5ctLim4udnwIZxQFuWHTDv8AMBV6EcAP3UJFqhL1VdGeFnqGuCc3Pg53X1Fyi0wHOGnlWiaoclzJsS5oIX0wwyG02QtcV+Ic2lR90xac3/5Rle2xyyHoWcEW19zgxzq0CUdvCk3j+oOa56xffNA7g6uqrf4GRl935oiuRTM0nXlIOFHFTgA0icsGfFt30SFY3tQkj60jg5Brv0z9UfFelwimKhF+eFI7cScCTD41OseTJcGEjJ8bmc+eNaIQUEb6o6xHWCAgv2pa1S7Hzs0NO08CydWWWVWavMmqeV6QB9GexkbugF7/Bqih5AcDb11vejHN0XD4IzAsgydQvWTAofPa/BuO9ftHkD3O5l00dWRFg4uA/7mKLda4iJzrGbAapQ7iC/Ns711sP0FTOYYL0SBnqTRkDiDIPP4E8Jap3exffOD+beygiGhkRYMLQ64dY6tyIcrRRlUAHJvLkYwM2gXX/AJwTI6WSje7AuSREWA76GvCiZZe86q3xNmd1p0UkREoCXNz7ti4lPdZPFONMUgg80xf8AFRk/SXmOQDCawA/rK747jUAb7W3W5PRw6Li98H/E0T46hRWgsxHmC+WzjdGP7lx4Y0rCnC/RcQgKQEuH+o9XMyGu0D6BrttlQUzjPKBWLLIZzxf2Gb9j1MXT90wYdCE7pZWbC0WFyHm/KD6f/qB4CPYjWqOAqkA62XgNohMAiwx6oj+oLa9xvfjujW3B1cLi2gdxBHAO9JbUV9v36HGnKbwsiBTcKwZUxf/cXEyIVMXT90AbJg0+JoBIY3gIBH1r3JCQC3ooSLyyuQF3jtb4maKyB5RBJi483XVGxq5DPhYPLrjtPne7zMVdOlAb08sDXwkUuWrLgt5L3xSZJkKjqC2ordOHOL9eMpC7zuFuokickfYBztr5P0l3ZpWb3fbZ1d/lYugSTt7f6/BL3uKcMvNNd4J7vMTqq/dT1SfAbYQdMGPXb7Z9YFN6H187RXhQNADc8/25dr5AAZODP124PHY81NrrplhYR0KbFRk583re52X67WKKBwKsiFkwiBvL2z5CrAUXXTLAu+QZHkvG+I90BZeBtb+1GX7Xg/MPbuoBdoQhXlPoC0nKlgKiEjc6Hdj2kLv68BNCj23qv/moFR5i2h5FIQARjkhpEz8jqZ96qbLNlwvyCy/RMxGEW2DvAlw+dDr+2PJyOAiz+zbFnnTflDR+5bX7xf9jYjsnu/1i8gPeRPAqJyowcm/imvunwa31ngXqPJislfOFdE6KIAJ0BOCS7jGeCSrjZeNzXpdk6e0e/51KCJX5DULuHiX63YRI/MBFN68veaPBxSmWkW0FvLTAI51QujxLStq5a+IjoL8ngsQjgdQaG5yPEnfyVdE+0XOGuDi6htGK1IVXNF/9e5FV3bKDyt2duSsAVQY7zpIGfwpov0idwJgHRP8VeexS18oVIWKaF3kZAL+MPSGUQqVgSN5Ydr8y+sKWakiWg85EcASz3gIbwUvPnTZgZGTCVA1xwZDCBs93cteSZe/iPaLrDXAecOm7qZIfwBFX7z9w0uKe/g6MLLWAKJmPBJ8LYvydAvUqYhWRNYEUBgHIEJ9ueUpqv8OjqxMwLnVU3cFGRTcxf9i0fvv+MhOA4geF358Q0KvhiuiIyM7J1Dk2GDot74i8JBHER0cGRPgnKG3DFMYDGCwXiqq/86BjE2ACseFnvpDKar/ToKMNYARjgss/Uu9pRXFt212EmREgLNHTNtZYEjwrRyv3FNzXsIvcBbR8ZCRCVAjx4Z+W2hR/XciZKQBfMY/zsGg0FjSpayo/jsR0mqAk4bcsJMfZ1dLBQvz8l2zLlvfGhUronWQlgDGco5RVbFEELGL6r+TIS0BmnDG2SiWSlNJg7/4pa1OhpQEGDfMu43j+PZSVWzklelLryuq/06GlASo9zUeaQu2JYqR4tJvZ0RKAvjFf4xBsFR9HkuK6r8TIikB9h40obtffftZCJbom69+Oq344uVOiKQEMNJwuF+l3BJBoPjUTydFUgL4xYwTBUvFlCDPt2alimg9JHw6uKrq/LJudtNqC6u7JfLBnEX37t3aFSuidZBQA5RRf7Bf6W6JYhXVf6dGQgI4thmHgqiiYhfVfydGgsWg8TbKEQCq+tmiRQ+mfedPER0XcQQYXNVtH6AnAMK/WrtCRbQu4jWAJUeGftqqRfvfyRFPANUjgr9qaz5/5JPWrU4RrY0oAuxcdVo1woDg4bNEf82tiE6IKAIYS46KnCiq/00BMSZAQup/9YIldR+0em2KaHWECTC032+3BUYDILwITzltVakiWg9hAvhL/EeGjkWl+M6fTQQuExCe/jUZ4fU2qU0RrQ4LYGSvsyoQ9gdQeGPx4oc3tG21imgtWAD13fyHoFQAUFT/mxQsAMWE1L86ar3YhvUpopVhwXgb5JcAKG8vXfrQyjauUxGtCGvQoIo9gK0BI1jXtHWFimhdWBZyFIGP+k5c+Plfih9z3MTgUZVtVfSwxUseKb7xaxPE/wNdTWzU9o0tSgAAAABJRU5ErkJggg==';
base_image.onload = function(){
ctx.globalAlpha = 0.15
ctx.drawImage(base_image, (canvas.width/2) - 64 - (lwidth/2), (canvas.height/2) - 128);
ctx.globalAlpha = 1
}
}
/* Function for drawing line charts
* Example usage:
* quokkaLines("myCanvas", ['Line a', 'Line b', 'Line c'], [ [x1,a1,b1,c1], [x2,a2,b2,c2], [x3,a3,b3,c3] ], { stacked: true, curve: false, title: "Some title" } );
*/
function quokkaBars(id, titles, values, options) {
var canvas = document.getElementById(id);
var ctx=canvas.getContext("2d");
// clear the canvas first
ctx.clearRect(0, 0, canvas.width, canvas.height);
var lwidth = 150;
var lheight = 75;
var stack = options ? options.stack : false;
var astack = options ? options.astack : false;
var curve = options ? options.curve : false;
var title = options ? options.title : null;
var noX = options ? options.nox : false;
var verts = options ? options.verts : true;
if (noX) {
lheight = 0;
}
// Draw a border
ctx.lineWidth = 0.5;
ctx.strokeRect(25, 30, canvas.width - lwidth - 40, canvas.height - lheight - 40);
// Draw a title if set:
if (title != null) {
ctx.font="15px Arial";
ctx.fillStyle = "#000";
ctx.textAlign = "center";
ctx.fillText(title,(canvas.width-lwidth)/2, 15);
}
// Draw legend
ctx.textAlign = "left";
var posY = 50;
for (var k in titles) {
var x = parseInt(k)
if (!noX) {
x = x + 1;
}
var title = titles[k];
if (title && title.length > 0) {
ctx.fillStyle = colors[k % colors.length][0];
ctx.fillRect(canvas.width - lwidth + 20, posY-10, 10, 10);
// Add legend text
ctx.font="12px Arial";
ctx.fillStyle = "#000";
ctx.fillText(title,canvas.width - lwidth + 40, posY);
posY += 15;
}
}
// Find max and min
var max = null;
var min = 0;
var stacked = null;
for (x in values) {
var s = 0;
for (y in values[x]) {
if (y > 0 || noX) {
s += values[x][y];
if (max == null || max < values[x][y]) {
max = values[x][y];
}
if (min == null || min > values[x][y]) {
min = values[x][y];
}
}
}
if (stacked == null || stacked < s) {
stacked = s;
}
}
if (min == max) {
max++;
}
if (stack) {
min = 0;
max = stacked;
}
// Set number of lines to draw and each step
var numLines = 5;
var step = (max-min) / (numLines+1);
// Prettify the max value so steps aren't ugly numbers
if (step %1 != 0) {
step = (Math.round(step+0.5));
max = step * (numLines+1);
}
// Draw horizontal lines
for (x = numLines; x >= 0; x--) {
var y = 30 + (((canvas.height-40-lheight) / (numLines+1)) * (x+1));
ctx.moveTo(25, y);
ctx.lineTo(canvas.width - lwidth - 15, y);
ctx.lineWidth = 0.25;
ctx.stroke();
// Add values
ctx.font="10px Arial";
ctx.fillStyle = "#000";
ctx.textAlign = "right";
ctx.fillText( Math.round( ((max-min) - (step*(x+1))) * 100 ) / 100,canvas.width - lwidth + 12, y-4);
ctx.fillText( Math.round( ((max-min) - (step*(x+1))) * 100 ) / 100,20, y-4);
}
// Draw vertical lines
var sx = 1
var numLines = values.length-1;
var step = (canvas.width - lwidth - 40) / values.length;
while (step < 24) {
step *= 2
sx *= 2
}
if (verts) {
ctx.beginPath();
for (var x = 1; x < values.length; x++) {
if (x % sx == 0) {
var y = 35 + (step * (x/sx));
ctx.moveTo(y, 30);
ctx.lineTo(y, canvas.height - 10 - lheight);
ctx.lineWidth = 0.25;
ctx.stroke();
}
}
}
// Some pre-calculations of steps
var step = (canvas.width - lwidth - 48) / values.length;
var smallstep = (step / titles.length) - 2;
// Draw X values if noX isn't set:
if (noX != true) {
ctx.beginPath();
for (var i = 0; i < values.length; i++) {
smallstep = (step / (values[i].length-1)) - 2;
zz = 1
var x = 35 + ((step) * i);
var y = canvas.height - lheight + 5;
if (i % sx == 0) {
ctx.translate(x, y);
ctx.moveTo(0,0);
ctx.lineTo(0,-15);
ctx.stroke();
ctx.rotate(45*Math.PI/180);
ctx.textAlign = "left";
var val = values[i][0];
if (val.constructor.toString().match("Date()")) {
val = val.toDateString();
}
ctx.fillText(val.toString(), 0, 0);
ctx.rotate(-45*Math.PI/180);
ctx.translate(-x,-y);
}
}
}
// Draw each line
var stacks = [];
var pstacks = [];
for (k in values) {
smallstep = (step / (values[k].length)) - 2;
stacks[k] = 0;
pstacks[k] = canvas.height - 40 - lheight;
var beginX = 0;
for (i in values[k]) {
if (i > 0 || noX) {
var z = parseInt(i);
var zz = z;
if (!noX) {
z = parseInt(i) + 1;
zz = z - 2;
if (z > values[k].length) {
break;
}
}
var value = values[k][i];
var title = titles[i];
var color = colors[zz % colors.length][1];
var fcolor = colors[zz % colors.length][2];
if (values[k][2] && values[k][2].toString().match(/^#.+$/)) {
color = values[k][2]
fcolor = values[k][2]
smallstep = (step / (values[k].length-2)) - 2;
}
var x = ((step) * k) + ((smallstep+2) * zz) + 5;
var y = canvas.height - 10 - lheight;
var mdiff = (max-min);
mdiff = (mdiff == 0) ? 1 : mdiff;
var height = ((canvas.height - 40 - lheight) / (mdiff)) * value * -1;
var width = smallstep - 2;
if (width <= 1) {
width = 1
}
if (stack) {
width = step - 10;
y -= stacks[k];
stacks[k] -= height;
x = (step * k) + 4;
if (astack) {
y = canvas.height - 10 - lheight;
}
}
// Draw bar
ctx.beginPath();
ctx.lineWidth = 2;
ctx.strokeStyle = color;
ctx.strokeRect(27 + x, y, width, height);
var alpha = 0.75
if (fcolor.r) {
ctx.fillStyle = 'rgba('+ [parseInt(fcolor.r*255),parseInt(fcolor.g*255),parseInt(fcolor.b*255),alpha].join(",") + ')';
} else {
ctx.fillStyle = fcolor;
}
ctx.fillRect(27 + x, y, width, height);
}
}
}
}
]==]
status_css = [[
html {
font-size: 14px;
position: relative;
background: #272B30;
}
body {
background-color: #272B30;
color: #000;
margin: 0 auto;
min-height: 100%;
font-family: Arial, Helvetica, sans-serif;
font-weight: normal;
}
.navbarLeft {
background: linear-gradient(to bottom, #F8A900 0%,#D88900 100%);
width: 200px;
height: 30px;
padding-top: 2px;
font-size: 1.35rem;
color: #FFF;
border-bottom: 2px solid #000;
float: left;
text-align: center;
}
.navbarRight {
background: linear-gradient(to bottom, #EFEFEF 0%,#EEE 100%);
width: calc(100% - 240px);
height: 28px;
color: #333;
border-bottom: 2px solid #000;
float: left;
font-size: 1.3rem;
padding-top: 4px;
text-align: left;
padding-left: 40px;
}
.wrapper {
width: 100%;
float: left;
background: #33363F;
min-height: calc(100% - 80px);
position: relative;
}
.serverinfo {
float: left;
width: 200px;
height: calc(100% - 34px);
background: #293D4C;
}
.skey {
background: rgba(30,30,30,0.3);
color: #C6E7FF;
font-weight: bold;
padding: 2px;
}
.sval {
padding: 2px;
background: rgba(30,30,30,0.3);
color: #FFF;
font-size: 0.8rem;
border-bottom: 1px solid rgba(200,200,200,0.2);
}
.charts {
padding: 0px;
width: calc(100% - 220px);
max-width: 1000px;
min-height: 100%;
margin: 0px auto;
position: relative;
float: left;
margin-left: 20px;
}
pre, code {
font-family: "Courier New", Courier, monospace;
}
strong {
font-weight: bold;
}
q, em, var {
font-style: italic;
}
/* h1 */
/* ====================== */
h1 {
padding: 0.2em;
margin: 0;
border: 1px solid #405871;
background-color: inherit;
color: #036;
text-decoration: none;
font-size: 22px;
font-weight: bold;
}
/* h2 */
/* ====================== */
h2 {
padding: 0.2em 0 0.2em 0.7em;
margin: 0 0 0.5em 0;
text-decoration: none;
font-size: 18px;
font-weight: bold;
text-align: center;
}
#modules {
margin-top:20px;
display:none;
width:400px;
}
.servers {
width: 1244px;
background: #EEE;
}
tr:nth-child(odd) {
background: #F6F6F6;
}
tr:nth-child(even) {
background: #EBEBEB;
}
td {
padding: 2px;
}
table {
border: 1px solid #333;
padding: 0px;
margin: 5px;
min-width: 360px;
background: #999;
font-size: 0.8rem;
}
canvas {
background: #FFF;
margin: 3px;
text-align: center;
padding: 2px;
border-radius: 10px;
border: 1px solid #999;
}
.canvas_wide {
position: relative;
width: 65%;
}
.canvas_narrow {
position: relative;
width: 27%;
}
a {
color: #FFA;
}
.statsbox {
border-radius: 3px;
background: #3C3E47;
min-width: 150px;
height: 60px;
float: left;
margin: 15px;
padding: 10px;
}
.btn {
background: linear-gradient(to bottom, #72ca72 0%,#55bf55 100%);
border-radius: 5px;
color: #FFF;
text-decoration: none;
padding-top: 6px;
padding-bottom: 6px;
padding-left: 3px;
padding-right: 3px;
font-weight: bold;
text-shadow: 1px 1px rgba(0,0,0,0.4);
margin: 12px;
float: left;
clear: none;
}
.infobox_wrapper {
float: left;
min-width: 200px;
margin: 10px;
}
.infobox_title {
border-top-left-radius: 4px;
border-top-right-radius: 4px;
background: #FAB227;
color: #FFF;
border: 2px solid #FAB227;
border-bottom: none;
font-weight: bold;
text-align: center;
width: 100%;
}
.infobox {
background: #222222;
border: 2px solid #FAB227;
border-top: none;
color: #EFEFEF;
border-bottom-left-radius: 4px;
border-bottom-right-radius: 4px;
float: left;
width: 100%;
}
.serverinfo ul {
margin: 0px;
padding: 0px;
margin-top: 20px;
list-style: none;
}
.serverinfo ul li .btn {
width: calc(100% - 8px);
margin: 0px;
border: 0px;
border-radius: 0px;
padding: 0px;
padding-top: 8px;
padding-left: 8px;
height: 24px;
background: rgba(0,0,0,0.2);
border-bottom: 1px solid rgba(100,100,100,0.3);
}
.serverinfo ul li:nth-child(1) {
border-top: 1px solid rgba(100,100,100,0.3);
}
.serverinfo ul li .btn.active {
background: rgba(30,30,50,0.2);
border-left: 4px solid #27FAB2;
padding-left: 4px;
color: #FFE;
}
.serverinfo ul li .btn:hover {
background: rgba(50,50,50,0.15);
border-left: 4px solid #FAB227;
padding-left: 4px;
color: #FFE;
}
]]
httpd-2.4.64/docs/error/ 0000775 0001751 0001751 00000000000 15032766613 014714 5 ustar covener covener httpd-2.4.64/docs/error/include/ 0000775 0001751 0001751 00000000000 15032766613 016337 5 ustar covener covener httpd-2.4.64/docs/error/include/bottom.html 0000664 0001751 0001751 00000000421 10653711064 020520 0 ustar covener covener </p>
<p>
<!--#include virtual="../contact.html.var" -->
</p>
<h2>Error <!--#echo encoding="none" var="REDIRECT_STATUS" --></h2>
<address>
<a href="/"><!--#echo var="SERVER_NAME" --></a><br />
<span><!--#echo var="SERVER_SOFTWARE" --></span>
</address>
</body>
</html>
httpd-2.4.64/docs/error/include/top.html 0000664 0001751 0001751 00000001477 11644657163 020044 0 ustar covener covener <!--#if expr="-z v('CONTENT_LANGUAGE')"
--><!--#set var="CONTENT_LANGUAGE" value="en"
--><!--#endif
--><?xml version="1.0" encoding="UTF-8"?>
<!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="<!--#echo var="CONTENT_LANGUAGE" -->" xml:lang="<!--#echo var="CONTENT_LANGUAGE" -->">
<head>
<title><!--#echo encoding="none" var="TITLE" --></title>
<link rev="made" href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->" />
<style type="text/css"><!--/*--><![CDATA[/*><!--*/
body { color: #000000; background-color: #FFFFFF; }
a:link { color: #0000CC; }
p, address {margin-left: 3em;}
span {font-size: smaller;}
/*]]>*/--></style>
</head>
<body>
<h1><!--#echo encoding="none" var="TITLE" --></h1>
<p>
httpd-2.4.64/docs/error/include/spacer.html 0000664 0001751 0001751 00000000011 10147723030 020456 0 ustar covener covener </p>
<p>
httpd-2.4.64/docs/error/contact.html.var 0000664 0001751 0001751 00000012737 14016700775 020034 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
Pokud si myslíte, že toto je chyba serveru, kontaktujte, prosím,
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">webmastera</a>.
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
Sofern Sie dies für eine Fehlfunktion des Servers halten,
informieren Sie bitte den
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">Webmaster</a>
hierüber.
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
If you think this is a server error, please contact
the <a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">webmaster</a>.
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
Si usted cree que esto es un error del servidor, por favor comuníqueselo al
<a href="mailto:<!--#echo encoding="none" var="SERVER_ADMIN" -->">administrador
del portal</a>.
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
Si vous pensez qu'il s'agit d'une erreur du serveur, veuillez contacter le
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">webmestre</a>.
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
Má cheapann tú gur earráid fhreastalaí í seo,
téigh i dteagmháil leis an
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">
stiúrthóir gréasáin</a>, le do thoil.
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
Se pensi che questo sia un errore del server, per favore contatta il
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">webmaster</a>.
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
サーバーの障害と思われる場合は、<a
href="mailto:<!--#echo encoding="none" var="SERVER_ADMIN" -->"
>ウェブ管理者</a>までご連絡ください。
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
만약 이것이 서버 오류라고 생각되면,
<a href="mailto:<!--#echo encoding="none" var="SERVER_ADMIN" -->">웹 관리자</a>에게 연락하시기 바랍니다.
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
Indien u van oordeel bent dat deze server in fout is, gelieve
de <a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">webmaster</a> te contacteren.
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
Om du tror dette skyldes en serverfeil, venligst kontakt
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">webansvarlig</a>.
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
Jeśli myślisz, że jest to błąd tego serwera, skontaktuj się z
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">administratorem</a>.
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
Se você acredita ter encontrado um problema no servidor,
por favor entre em contato com o
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">webmaster</a>.
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
Se considera que o servidor está errado, por favor contacte o
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">webmaster</a>.
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
Va rugam sa il contactati pe
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">webmaster</a>
in cazul in care credeti ca aceasta este o eroare a serverului.
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
Если Вы считаете, что это ошибка сервера, пожалуйста, сообщите об этом
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">веб-мастеру</a>.
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
Ако мислите да је ово грешка сервера, молимо обавестите
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">вебмастера</a>.
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
Om du tror att detta beror på ett serverfel, vänligen kontakta
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">webbansvarig</a>.
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
Bunun bir sunucu hatası olduğunu düşünüyorsanız, lütfen
<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">site
yöneticisi</a> ile iletişime geçin.
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
如果您认为这是一个服务器错误，请联系<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">网站管理员</a>。
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
如果您認為這是一個伺服器錯誤，請聯繫<a href="mailto:<!--#echo encoding="url" var="SERVER_ADMIN" -->">網站管理員</a>。
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_GONE.html.var 0000664 0001751 0001751 00000040273 13317763731 017770 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Zdroj již není dále dostupný!"
--><!--#include virtual="include/top.html" -->
Požadované URL již není na tomto serveru k dispozici, ani není k dispozici
žádná adresa k přesměrování.
<!--#if expr="-n v('HTTP_REFERER')" -->
Informujte, prosím, autora
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">odkazující
stránky</a>, že odkaz je zastaralý.
<!--#else -->
Pokud jste následovali odkaz z cizí stránky, kontaktujte, prosím,
jejího autora.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Objekt nicht mehr verfügbar!"
--><!--#include virtual="include/top.html" -->
Der angeforderte URL existiert auf dem Server nicht mehr
und wurde dauerhaft entfernt.
Eine Weiterleitungsadresse ist nicht verfügbar.
<!--#if expr="-n v('HTTP_REFERER')" -->
Bitte informieren Sie den Autor der
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">verweisenden
Seite</a>, dass der Link nicht mehr aktuell ist.
<!--#else -->
Falls Sie einem Link von einer anderen Seite gefolgt sind,
informieren Sie bitte den Autor dieser Seite hierüber.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Resource is no longer available!"
--><!--#include virtual="include/top.html" -->
The requested URL is no longer available on this server and there is no
forwarding address.
<!--#if expr="-n v('HTTP_REFERER')" -->
Please inform the author of the
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">referring
page</a> that the link is outdated.
<!--#else -->
If you followed a link from a foreign page, please contact the
author of this page.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡El recurso ya no está disponible!" -->
<!--#include virtual="include/top.html" -->
La URL solicitada ya no está disponible en este servidor y
no existe una dirección a la cual remitirle.
<!--#if expr="-n v('HTTP_REFERER')" -->
Por favor, comunique al autor de la
<a href="<!--#echo encoding="url" var="HTTP_REFERER"-->">página
que le ha remitido</a> que la URL está obsoleta.
<!--#else -->
Si usted ha seguido un enlace de una página externa,
por favor contacte con el autor de esa página.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Cette ressource n'existe plus!"
--><!--#include virtual="include/top.html" -->
L'URL demandée n'est plus accessible sur ce serveur et il
n'y a pas d'adresse de redirection.
<!--#if expr="-n v('HTTP_REFERER')" -->
Nous vous prions d'informer l'auteur de
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">la
page en question</a> que la référence n'est plus valable.
<!--#else -->
Si vous avez suivi une référence issue d'une page autre,
veuillez contacter l'auteur de cette page.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Acmhainn imithe!"
--><!--#include virtual="include/top.html" -->
Níl an URL iarraithe ar fáil ar an fhreastalaí seo
a thuilleadh, agus níl aon seoladh nua ann dó.
<!--#if expr="-n v('HTTP_REFERER')" -->
Cur in úil do úadar an
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">leathanach
thagarthach</a> go bhfuil an nasc as-dáta, le do thoil.
<!--#else -->
Má leanfá nasc ó leathanach iasachta, téigh i
dteaghmháil le úadar an leathanach sin, le do thoil.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="La risorsa non è più disponibile!"
--><!--#include virtual="include/top.html" -->
L'URL richiesto non è più disponibile su questo server
e non esistono indirizzi verso i quali sia possibile inoltrare
la richiesta.
<!--#if expr="-n v('HTTP_REFERER')" -->
Per favore, informa l'autore della
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">pagina
di provenienza</a> che il link non è più valido.
<!--#else -->
Se sei arrivato da una pagina esterna, informa l'autore della
pagina di provenienza che il link non è più valido.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Resource is no longer available!"
--><!--#include virtual="include/top.html" -->
要求された URL は既に本サーバでは利用できませんし、
移動先もわかりません。
<!--#if expr="-n v('HTTP_REFERER')" -->
<a href="<!--#echo encoding="url" var="HTTP_REFERER"-->"
>参照元ページ</a>の著者に、
リンクが古くなっていることをご連絡ください。
<!--#else -->
他のページからのリンクを辿ってきた場合は、
そのページの著者にご連絡ください。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="객체가 없어졌음!"
--><!--#include virtual="include/top.html" -->
요청한 URL은 더 이상 이 서버에 남아있지 않으며,
그 객체가 옮겨진 다른 URL 역시 남아있지 않습니다.
<!--#if expr="-n v('HTTP_REFERER')" -->
<a href="<!--#echo encoding="url" var="HTTP_REFERER"-->">이전
페이지</a>의 만든이에게 주소가 잘못되었다고 알려주시기 바랍니다.
<!--#else -->
다른 페이지의 링크를 따라오셨다면, 그 페이지의 만든이에게 연락을 하시기
바랍니다.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Dit object is niet langer beschikbaar!"
--><!--#include virtual="include/top.html" -->
De gevraagde URL is niet langer beschikbaar op deze server en er is geen
doorverwijsadres.
<!--#if expr="-n v('HTTP_REFERER')" -->
Gelieve aan de auteur van
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">deze pagina</a>
te melden dat deze link niet langer actueel is.
<!--#else -->
Indien u deze link hebt gekregen van een andere pagina, gelieve
de auteur van deze pagina te contacteren.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Ressursen er ikke lenger tilgjengelig!"
--><!--#include virtual="include/top.html" -->
Den ønskede adressen er ikke lenger tilgjengelig hos denne
serveren og det finnes ingen adresse for videresending.
<!--#if expr="-n v('HTTP_REFERER')" -->
Venligst informer forfatteren bak
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">den
aktuelle siden</a> om at lenken er utdatert.
<!--#else -->
Om du fulgte en lenke fra en ekstern side, venligst kontakt
forfatteren bak den siden.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Zasób usunięty!"
--><!--#include virtual="include/top.html" -->
Poszukiwany zasób nie jest już dostępny na tym serwerze i nie
podano nowego adresu zasobu.
<!--#if expr="-n v('HTTP_REFERER')" -->
Prosimy poinformować autora
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">referującej
strony</a> o nieaktualnym linku.
<!--#else -->
Jeśli podążyłeś za linkiem z innej strony, skontaktuj się z jej
autorem.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Recurso não disponível!"
--><!--#include virtual="include/top.html" -->
A URL solicitada não está disponível neste servidor
e não existe um endereço alternativo.
<!--#if expr="-n v('HTTP_REFERER')" -->
Por favor informe o autor da
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">página
referida</a> que a URL está desatualizada.
<!--#else -->
Se você seguiu um "link" de uma página externa, por favor
entre em contato com o autor desta página e o informe sobre a
mudança do "link".
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Recurso não disponível!"
--><!--#include virtual="include/top.html" -->
O URL desejado já não está disponível
neste servidor e não existe endereço alternativo.
<!--#if expr="-n v('HTTP_REFERER')" -->
Por favor informe o autor da
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">página
originária</a> que a hiperligação está
desactualizada.
<!--#else -->
Se chegou aqui a partir de uma hiperligação externa,
por favor contacte o autor dessa página.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Resursa nu mai este disponibila!"
--><!--#include virtual="include/top.html" -->
URL-ul cerut nu mai este disponibil pe acest server si nu
exista o adresa de inaintare.
<!--#if expr="-n v('HTTP_REFERER')" -->
Va rugam informati autorul
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">paginii
referite</a> ca link-ul nu mai este de actualitate.
<!--#else -->
Va rugam contactati autorul acestei pagini daca ati urmat
un link dintr-o pagina externa.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Документ удалён!"
--><!--#include virtual="include/top.html" -->
Документ удалён, и адрес перенаправления отсутствует.
<!--#if expr="-n v('HTTP_REFERER')" -->
Пожалуйста, сообщите автору
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">страницы</a>,
ссылающейся на документ, что ссылка устарела.
<!--#else -->
Если Вы обратились к документу по ссылке с другой страницы, пожалуйста,
сообщите её автору об ошибке.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Ресурс није више доступан!"
--><!--#include virtual="include/top.html" -->
Захтевани УРЛ није више доступан на овом серверу и нема
адресе на коју бисте могли бити прослеђени.
<!--#if expr="-n v('HTTP_REFERER')" -->
Молимо обавестите аутора
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">исходишне
странице</a> да је веза застарела.
<!--#else -->
Ако сте пратили везу са спољне странице, молимо обавестите
аутора те странице.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Resursen inte längre tillgänglig!"
--><!--#include virtual="include/top.html" -->
Den önskade adressen är inte längre tillgänglig hos
denna server och det finns inte någon adress för vidarebefodran.
<!--#if expr="-n v('HTTP_REFERER')" -->
Vänligen informera författaren bakom
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">den aktuella
sidan</a> att länken är inaktuell.
<!--#else -->
Om du följde en länk från en extern sida, vänligen
kontakta författaren av den sidan.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Özkaynak artık mevcut değil!"
--><!--#include virtual="include/top.html" -->
Talep ettiğiniz URL artık kullanılabilir değil
ve herhangi bir yönlendirme de mevcut değil.
<!--#if expr="-n v('HTTP_REFERER')" -->
Lütfen
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">istenen sayfanın</a>
yazarına, bu bağlantının güncel olmadığını bildirin.
<!--#else -->
Başka bir sunucudaki bir bağlantıyı izleyerek buraya geldiyseniz,
lütfen sözkonusu sayfanın yazarına bağlantının güncel olmadığını bildirin.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="资源不再可用！"
--><!--#include virtual="include/top.html" -->
您请求的 URL 在此服务器上不再可用，且没有设置转发的地址。
<!--#if expr="-n v('HTTP_REFERER')" -->
请通知<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">来源页面</a>的作者，该链接已过期。
<!--#else -->
如果您从外部页面的一个链接访问，请联系该页面的作者。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="資源不再可用！"
--><!--#include virtual="include/top.html" -->
您請求的 URL 在此伺服器上不再可用，且沒有設置轉發的位址。
<!--#if expr="-n v('HTTP_REFERER')" -->
請通知<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">來源頁面</a>的作者，該連結已過期。
<!--#else -->
如果您從外部頁面的一個連結訪問，請聯繫此頁面的作者。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_FORBIDDEN.html.var 0000664 0001751 0001751 00000034247 13317763731 020540 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Přístup odmítnut!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Nemáte právo pro přístup do požadovaného adresáře. Buď neexistuje žádný
dokument s obsahem (tzv. index), nebo je adresář chráněn proti čtení.
<!--#else -->
Nemáte právo pro přístup k požadovanému objektu.
Buď je chráněn proti čtení, nebo není serverem čitelný.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Zugriff verweigert!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Der Zugriff auf das angeforderte Verzeichnis ist nicht möglich.
Entweder ist kein Index-Dokument vorhanden oder das Verzeichnis
ist zugriffsgeschützt.
<!--#else -->
Der Zugriff auf das angeforderte Objekt ist nicht möglich.
Entweder kann es vom Server nicht gelesen werden oder es
ist zugriffsgeschützt.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Access forbidden!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
You don't have permission to access the requested directory.
There is either no index document or the directory is read-protected.
<!--#else -->
You don't have permission to access the requested object.
It is either read-protected or not readable by the server.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡Acceso prohibido!" -->
<!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Usted no tiene permiso para acceder al directorio solicitado.
No existe un documento índice, o el directorio está
protegido contra lectura.
<!--#else -->
Usted no tiene permiso para acceder al objeto solicitado.
El objeto está protegido contra lectura o
el servidor no puede leerlo.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Accès interdit!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Vous n'avez pas le droit d'accéder au répertoire
demandé. Soit il n'y a pas de document index soit le répertoire
est protégé.
<!--#else -->
Vous n'avez pas le droit d'accéder à l'objet
demandé. Soit celui-ci est protégé, soit il ne peut
être lu par le serveur.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Rochtain neamh-cheadaithe!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Níl cead agat rochtain a dhéanamh ar an comhadlann faoi
iarratais. Is féidir nach bhfuil aon doiciméad
innéacs, nó go bhfuil cosaint ar lémh an comhadlann.
<!--#else -->
Níl cead agat rochtain a dhéanamh ar an aidhm faoi iarratais.
Is féidir go bhfuil cosaint ar lé air, nó go bhfuil
sé doléite don freastalaí.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Accesso negato!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Non disponi dei permessi necessari per accedere alla
directory richiesta oppure non esiste il documento indice.
<!--#else -->
Non disponi dei permessi necessari per accedere all'oggetto
richiesto, oppure l'oggetto non può essere letto dal server.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Access forbidden!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
要求されたディレクトリへのアクセス権限がありません。
インデックスドキュメントが存在しないか、
ディレクトリの読み込みが許可されていません。
<!--#else -->
要求されたオブジェクトへのアクセス権がありません。
読み込みが許可されていないか、
サーバが読み込みに失敗したかでしょう。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="접근이 거부됨!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
요청한 디렉토리에 접근할 수 있는 권한이 없습니다.
디렉토리에 첫 페이지가 없거나 아니면 읽기 보호가 되어 있습니다.
<!--#else -->
요청한 객체에 접근할 수 있는 권한이 없습니다.
읽기 보호가 되어 있거나 웹서버가 읽을 수 없도록 되어 있습니다.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Toegang verboden!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
U hebt niet de toestemming om toegang te krijgen tot de gevraagde map.
Er is of wel geen index document of de map is beveiligd tegen lezen.
<!--#else -->
U hebt niet de toestemming om toegang te krijgen tot de gevraagde map.
Die is ofwel beveiligd tegen lezen of onleesbaar door de server.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Adgang forbudt!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Du har ikke tilstrekkelige rettigheter for å få tilgang til den
ønskede katalogen. Det eksisterer ikke et indeksdokument, eller
katalogen er lesebeskyttet.
<!--#else -->
Du har ikke tilstrekkelige rettigheter for å få adgang til det
ønskede dokumentet. Objektet er lesebeskyttet, eller ikke lesbart
for serveren.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Zabroniony dostęp!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Nie masz prawa dostępu do żądanego katalogu. W katalogu nie
ma indeksu lub katalog jest zabezpieczony przed odczytem.
<!--#else -->
Nie masz dostępu do żądanego obiektu. Jest on zabezpieczony
przed odczytem lub nie może być odczytany przez serwer.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Acesso Proibido!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Você não tem permissão para acessar o
diretório requisitado.
Pode não existir o arquivo de índice ou
o diretório pode estar protegido contra leitura.
<!--#else -->
Você não tem permissão para acessar o
objeto requisitado. Ele pode estar protegido contra leitura ou
não ser legível pelo servidor.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Acesso proibido!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Não tem permissão para aceder ao directório
que deseja. Ou não existe o documento de índice
ou o directório está protegido contra leitura.
<!--#else -->
Não tem permissão para aceder ao objecto
que deseja. Este está protegido contra leitura ou
o servidor não o consegue ler.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Accesul interzis!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Nu aveti permisiunea sa accesati directorul cerut.
Nu este nici un document index sau directorul este protejat la citire.
<!--#else -->
Nu aveti permisiunea sa accesati obiectul cerut.
Este protejat la citire sau nu poate fi citit de server.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Доступ запрещён!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
У Вас нет прав доступа к этой директории.
Отсутствует индексный файл, или директория недоступна для чтения.
<!--#else -->
У Вас нет прав доступа к этому объекту.
Файл недоступен для чтения, или сервер не может его прочитать.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Забрањен приступ!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Немате дозволу да приступите захтеваном директоријуму.
Могуће је да нема индексног документа, или да је директоријум заштићен од читања.
<!--#else -->
Немате дозволу да приступите захтеваном објекту.
Могуће је да је заштићен од читања, или да га сервер не може прочитати.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Åtkomst förbjuden!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Du har inte tillräckliga rättigheter för att få
tillgång till den önskade katalogen. Det existerar inget
indexdokument eller så är katalogen lässkyddad.
<!--#else -->
Du har inte tillräckliga rättigheter för att få
tillgång till det önskade objektet. Objektet är
lässkyddat eller inte läsbart för servern.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Erişim engellendi!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
Talep ettiğiniz dizine erişim izniniz yok.
Ya dizin içerik dosyası yok, ya da dizin okumaya karşı korumalı.
<!--#else -->
Talep ettiğiniz dizine erişim izniniz yok.
Dizin, ya okumaya karşı korumalı
ya da sunucu tarafından okunamıyor.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="禁止访问！"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
您无权访问所请求的目录。
这是由于没有主页或该目录不允许被读取导致的。
<!--#else -->
您无权访问所请求的对象。
它可能不允许被读取或无法被服务器读取。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="禁止訪問！"
--><!--#include virtual="include/top.html" -->
<!--#if expr="v('REDIRECT_URL') =~ m:/$:" -->
您無權訪問所請求的目錄。
這是由於沒有主頁或該目錄不允許被讀取導致的。
<!--#else -->
您無權訪問所請求的物件。
它可能不允許被讀取或無法被伺服器讀取。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_METHOD_NOT_ALLOWED.html.var 0000664 0001751 0001751 00000020264 13317763731 022105 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Metoda nepovolena!"
--><!--#include virtual="include/top.html" -->
Metoda <!--#echo var="REDIRECT_REQUEST_METHOD" -->
není pro požadované URL povolena.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Methode nicht erlaubt!"
--><!--#include virtual="include/top.html" -->
Die <!--#echo var="REDIRECT_REQUEST_METHOD" -->-Methode
ist für den angeforderten URL nicht erlaubt.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Method not allowed!"
--><!--#include virtual="include/top.html" -->
The <!--#echo var="REDIRECT_REQUEST_METHOD" -->
method is not allowed for the requested URL.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡Método no permitido!" -->
<!--#include virtual="include/top.html" -->
No se permite el método <!--#echo var="REDIRECT_REQUEST_METHOD" -->
para la URL solicitada.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Méthode interdite!"
--><!--#include virtual="include/top.html" -->
La méthode <!--#echo var="REDIRECT_REQUEST_METHOD" -->
n'est pas utilisable pour l'URL demandée.
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Modh neamhcheadaithe!"
--><!--#include virtual="include/top.html" -->
Níl cead an modh
<!--#echo var="REDIRECT_REQUEST_METHOD" -->
a úasáid leis an URL iarraithe.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Metodo non consentito!"
--><!--#include virtual="include/top.html" -->
Il metodo <!--#echo var="REDIRECT_REQUEST_METHOD" -->
non è consentito per l'URL richiesto.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Method not allowed!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD"-->
メソッドは、要求された URL に対しては許可されていません。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="허용되지 않는 요청 방식!"
--><!--#include virtual="include/top.html" -->
<!--#echo encoding="none" var="REDIRECT_REQUEST_METHOD"--> 방식은
요청한 URL에 사용할 수 없습니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Type methode niet toegelaten!"
--><!--#include virtual="include/top.html" -->
Het <!--#echo var="REDIRECT_REQUEST_METHOD" -->
type methode is niet toegelaten voor de gevraagde URL.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Metoden er ikke tillatt!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD" --> metoden er ikke
tillatt for den forespurte adressen.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Niedozwolona metoda!"
--><!--#include virtual="include/top.html" -->
Metoda <!--#echo var="REDIRECT_REQUEST_METHOD" -->
jest niedozwolona dla podanego URL-a.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Método não permitido!"
--><!--#include virtual="include/top.html" -->
O método <!--#echo var="REDIRECT_REQUEST_METHOD" -->
não é permitido para a URL requisitada.
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Método não permitido!"
--><!--#include virtual="include/top.html" -->
O método <!--#echo var="REDIRECT_REQUEST_METHOD" --> não
é permitido para o URL pedido.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Metoda nepermisa!"
--><!--#include virtual="include/top.html" -->
Metoda <!--#echo var="REDIRECT_REQUEST_METHOD" -->
nu este permisa pentru URL-ul cerut.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Метод не поддерживается!"
--><!--#include virtual="include/top.html" -->
Метод <!--#echo var="REDIRECT_REQUEST_METHOD" -->
нельзя применить к запрашиваемому ресурсу.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Метод није дозвољен!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD" -->
метод није дозвољен за захтевани УРЛ.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Metoden inte tillåten!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD" -->
metoden är inte tillåten för den förfrågade
adressen.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Yönteme izin verilmedi!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD" -->
yöntemi istediğiniz URL için kullanılamaz.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="请求的方法不允许！"
--><!--#include virtual="include/top.html" -->
在请求的 URL 上不允许使用
<!--#echo var="REDIRECT_REQUEST_METHOD" --> 方法。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="請求的方法不允許！"
--><!--#include virtual="include/top.html" -->
在請求的 URL 上不允許使用
<!--#echo var="REDIRECT_REQUEST_METHOD" --> 方法。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_REQUEST_ENTITY_TOO_LARGE.html.var 0000664 0001751 0001751 00000022721 13317763731 023115 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Požadovaná entita je příliš velká!"
--><!--#include virtual="include/top.html" -->
Metoda <!--#echo var="REDIRECT_REQUEST_METHOD" -->
nedovoluje přenos dat nebo objem dat
přesahuje kapacitní limit.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Übergebene Daten zu groß!"
--><!--#include virtual="include/top.html" -->
Die bei der Anfrage übermittelten Daten sind für
die <!--#echo var="REDIRECT_REQUEST_METHOD" -->-Methode
nicht erlaubt oder die Datenmenge hat das Maximum überschritten.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Request entity too large!"
--><!--#include virtual="include/top.html" -->
The <!--#echo var="REDIRECT_REQUEST_METHOD" -->
method does not allow the data transmitted, or the data volume
exceeds the capacity limit.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡La entidad solicitada es demasiado grande!" -->
<!--#include virtual="include/top.html" -->
El método <!--#echo var="REDIRECT_REQUEST_METHOD"-->
no permite transmitir la información, o el
volumen de la información excede los límites
de capacidad del mismo.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Volume de la demande trop grand!"
--><!--#include virtual="include/top.html" -->
La méthode <!--#echo var="REDIRECT_REQUEST_METHOD" -->
n'autorise pas le transfert de ces données ou bien le volume
des données excède la limite de capacité.
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Iarratais ar aonán rómhór!"
--><!--#include virtual="include/top.html" -->
Ní ligeann an modh <!--#echo var="REDIRECT_REQUEST_METHOD" --> an
tarchur sonraíocht tríd, nó tá an méid
sonraíocht breis ar an teoireann cumas.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Richiesta troppo grande!"
--><!--#include virtual="include/top.html" -->
Il metodo <!--#echo var="REDIRECT_REQUEST_METHOD" -->
non consente di trasferire dati, oppure la quantità di dati
richiesti è eccessiva.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Request entity too large!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD"-->
メソッドがデータの送信を許可していないか、
データ量が許容量を超えています。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="너무 긴 요청!"
--><!--#include virtual="include/top.html" -->
<!--#echo encoding="none" var="REDIRECT_REQUEST_METHOD"--> 방식의
요청으로는 내용을 보낼 수 없거나, 또는 보내온 내용이 그 방식에서 허용하는
최대 길이를 넘었습니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Volume van gevraagde entiteit te groot!"
--><!--#include virtual="include/top.html" -->
Het <!--#echo var="REDIRECT_REQUEST_METHOD" --> type methode laat niet toe
data te versturen of het datavolume is groter dan maximaal toegelaten.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="For stor enhet i forspørsel!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD" --> metoden tillater ikke
de sendte data eller så overskrider datamengenden
kapasitetsbegrensningen.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Żądany obiekt zbyt duży!"
--><!--#include virtual="include/top.html" -->
Metoda <!--#echo var="REDIRECT_REQUEST_METHOD" -->
nie zezwala na typ przesyłanych danych lub rozmiar danych przekracza
ustalony limit.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Volume da dados muito grande!"
--><!--#include virtual="include/top.html" -->
O método <!--#echo var="REDIRECT_REQUEST_METHOD" -->
não permite a transmissão dos dados,
ou o volume de dados excede a capacidade limite.
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Volume de dados demasiado grande!"
--><!--#include virtual="include/top.html" -->
O método <!--#echo var="REDIRECT_REQUEST_METHOD" -->
não permite todos os dados que foram transmitidos,
ou o volume de dados excede o limite da capacidade.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Entitate ceruta prea mare!"
--><!--#include virtual="include/top.html" -->
Metoda <!--#echo var="REDIRECT_REQUEST_METHOD" -->
nu permite transmiterea datelor, sau volumul de date
depaseste limita capacitatii.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Размер запроса слишком велик!"
--><!--#include virtual="include/top.html" -->
Тип передаваеиых данных запрещён методом <!--#echo var="REDIRECT_REQUEST_METHOD" -->,
или размера тела запроса слишком велик.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Request entity too large!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD" -->
метод не дозвољава пренос ових података, или количина података
премашује ограничења могућности.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="För stor enhet vid förfrågan!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD" --> metoden tillåter
inte den skickade datan eller så överskrider datavolymen
kapacitetsnivån.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="İstenen öğe çok büyük!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD" --> yöntemi ya veri aktarımına
izin vermiyor ya da veri hacmi işlenemeyecek kadar büyük.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="请求体过大！"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD" --> 方法不允许传输数据，或数据量超过容量限制。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="請求體過大！"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD" --> 方法不允許傳輸資料，或資料量超過容量限制。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_BAD_REQUEST.html.var 0000664 0001751 0001751 00000020165 13317763731 021034 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Chybný požadavek!"
--><!--#include virtual="include/top.html" -->
Váš prohlížeč (nebo proxy server) vyslal požadavek,
kterému tento server nerozuměl.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Fehlerhafte Anfrage!"
--><!--#include virtual="include/top.html" -->
Ihr Browser (oder Proxy) hat eine ungültige Anfrage
gesendet, die vom Server nicht beantwortet werden kann.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Bad request!"
--><!--#include virtual="include/top.html" -->
Your browser (or proxy) sent a request that
this server could not understand.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡Petición errónea!" -->
<!--#include virtual="include/top.html" -->
Su navegador (o 'proxy') ha enviado una petición
que el servidor no ha podido entender.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Demande incorrecte!"
--><!--#include virtual="include/top.html" -->
Votre navigateur (ou votre proxy) a envoyé
une demande que ce serveur n'a pas comprise.
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Iarratas mícheart!"
--><!--#include virtual="include/top.html" -->
Seol do chuid brabhsálaí (nó
seachfhreastalaí) freagairt nárbh fhéidir leis an
fhreastalaí seo a thuisceant.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Richiesta incomprensibile!"
--><!--#include virtual="include/top.html" -->
Il tuo browser (o il proxy) ha inviato a
questo server una richiesta incomprensibile.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Bad request!"
--><!--#include virtual="include/top.html" -->
お使いのブラウザ (またはプロクシ)
が、サーバの理解できないリクエストを送信しました。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="잘못된 요청!"
--><!--#include virtual="include/top.html" -->
브라우저 또는 프록시가
이 서버가 처리할 수 없는 잘못된 요청을 보냈습니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Slechte vraag!"
--><!--#include virtual="include/top.html" -->
Uw browser (of proxy) stuurde een vraag die
deze server niet kon begrijpen.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Ugyldig spørring!"
--><!--#include virtual="include/top.html" -->
Din nettleser eller proxy sendte en forespørsel
som denne serveren ikke kunne forstå.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Nieprawidłowe żądanie!"
--><!--#include virtual="include/top.html" -->
Twoja przeglądarka (lub serwer pośredniczący) wysłał żądanie,
którego ten serwer nie potrafi obsłużyć.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Requisição Inválida!"
--><!--#include virtual="include/top.html" -->
Seu "browser" (ou o servidor proxy) enviou uma
requisição inválida ao servidor.
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Pedido incorrecto!"
--><!--#include virtual="include/top.html" -->
O seu <i>browser</i> ou <i>proxy</i> enviou
um pedido que este servidor não compreendeu.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Cerere incomprensibila!"
--><!--#include virtual="include/top.html" -->
Browserul (sau proxy-ul) dumneavoastra a trimis
serverului o cerere ce nu poate fi procesata.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Неверный запрос!"
--><!--#include virtual="include/top.html" -->
Запрос, посланный Вашим браузером (или прокси-сервером),
содержит ошибку и не может быть обработан.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Лош захтев!"
--><!--#include virtual="include/top.html" -->
Ваш читач (или посреднички сервер) послао је захтев који
овај сервер није могао да разуме.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Felaktig förfrågan!"
--><!--#include virtual="include/top.html" -->
Din webbläsare eller proxy skickade en förfrågan
som denna server inte kunde förstå.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Hatalı istek!"
--><!--#include virtual="include/top.html" -->
Tarayıcınız (veya vekil sunucunuz) bu sunucunun
anlayamadığı bir istekte bulundu.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="无效请求！"
--><!--#include virtual="include/top.html" -->
您的浏览器（或代理）发送了一个服务器无法解析的请求。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="請求錯誤！"
--><!--#include virtual="include/top.html" -->
您的瀏覽器（或代理）發送了一個伺服器無法解析的請求。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_LENGTH_REQUIRED.html.var 0000664 0001751 0001751 00000022317 13317763731 021520 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Chybná hlavička Content-Length!"
--><!--#include virtual="include/top.html" -->
Požadavek metodou <!--#echo var="REDIRECT_REQUEST_METHOD" -->
vyžaduje korektní hlavičku <code>Content-Length</code>.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Content-Length-Angabe fehlerhaft!"
--><!--#include virtual="include/top.html" -->
Die Anfrage kann nicht beantwortet werden.
Bei Verwendung der <!--#echo var="REDIRECT_REQUEST_METHOD" -->-Methode
muß ein korrekter <code>Content-Length</code>-Header
angegeben werden.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Bad Content-Length!"
--><!--#include virtual="include/top.html" -->
A request with the <!--#echo var="REDIRECT_REQUEST_METHOD" -->
method requires a valid <code>Content-Length</code> header.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡Error en la longitud del contenido!" -->
<!--#include virtual="include/top.html" -->
Una petición con el método <!--#echo
var="REDIRECT_REQUEST_METHOD" --> requiere que el encabezado
<code>Content-Length</code> sea válido.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Longueur du contenu illégal!"
--><!--#include virtual="include/top.html" -->
Une requête utilisant la méthode <!--#echo
var="REDIRECT_REQUEST_METHOD" --> nécessite un en-tête
<code>Content-Length</code> (indiquant la longueur) valable.
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Content-Length mícheart!"
--><!--#include virtual="include/top.html" -->
Is gá go mbhéadh ceanntáisc
<code>Content-Length</code>
bhailí do iarratais faoin modh
<!--#echo var="REDIRECT_REQUEST_METHOD" -->.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Campo Content-Length non valido!"
--><!--#include virtual="include/top.html" -->
Una richiesta con il metodo
<!--#echo var="REDIRECT_REQUEST_METHOD" -->
richiede che venga specificato un header <code>Content-Length</code>
valido.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Bad Content-Length!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD"-->
メソッドのリクエストでは、
正しい <code>Content-Length</code> ヘッダが必要になります。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="잘못된 Content-Length!"
--><!--#include virtual="include/top.html" -->
<!--#echo encoding="none" var="REDIRECT_REQUEST_METHOD"--> 방식을 쓰는
요청은 올바른 <code>Content-Length</code> 헤더도 함께 보내야만 합니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Ongeldige lengte inhoud!"
--><!--#include virtual="include/top.html" -->
Een vraag met het <!--#echo var="REDIRECT_REQUEST_METHOD" -->
type methode heeft een correcte <code>Content-Length</code> lijn nodig.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Feil Content-Length!"
--><!--#include virtual="include/top.html" -->
En forespørsel med <!--#echo var="REDIRECT_REQUEST_METHOD" -->
metoden krever en korrekt <code>Content-Length</code> header.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Błędne Content-Length!"
--><!--#include virtual="include/top.html" -->
Żądanie <!--#echo var="REDIRECT_REQUEST_METHOD" -->
wymaga poprawnego nagłówka <code>Content-Length</code>.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Content-Length Inválido!"
--><!--#include virtual="include/top.html" -->
Uma requisição
do método <!--#echo var="REDIRECT_REQUEST_METHOD"-->
requer um cabeçalho <code>Content-Length</code> válido.
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Content-Length incorrecto!"
--><!--#include virtual="include/top.html" -->
Um pedido com o método <!--#echo var="REDIRECT_REQUEST_METHOD" -->
necessita de um cabeçalho <code>Content-Length</code> válido.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Content-Length invalid!"
--><!--#include virtual="include/top.html" -->
O cerere cu metoda <!--#echo var="REDIRECT_REQUEST_METHOD" -->
necesita un header <code>Content-Length</code> valid.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Неверная длина Content-Length!"
--><!--#include virtual="include/top.html" -->
Запрос с помощью метода <!--#echo var="REDIRECT_REQUEST_METHOD" -->
должен иметь правильное значение длины в поле <code>Content-Length</code>.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Лоше Content-Length заглавље!"
--><!--#include virtual="include/top.html" -->
Захтев са <!--#echo var="REDIRECT_REQUEST_METHOD" -->
методом мора имати исправно <code>Content-Length</code>
(дужина садржаја) заглавље.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Felaktig Content-Length!"
--><!--#include virtual="include/top.html" -->
En förfrågan med <!--#echo var="REDIRECT_REQUEST_METHOD" -->
metoden kräver ett korrekt <code>Content-Length</code> huvud.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Hatalı Content-Length başlığı!"
--><!--#include virtual="include/top.html" -->
<!--#echo var="REDIRECT_REQUEST_METHOD" --> yöntemini kullanan bir istek
geçerli bir <code>Content-Length</code> (içerik uzunluğu) başlığı gerektirir.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="错误的 Content-Length！"
--><!--#include virtual="include/top.html" -->
对 <!--#echo var="REDIRECT_REQUEST_METHOD" --> 方法的请求必须带有有效的
<code>Content-Length</code> 头字段。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="錯誤的 Content-Length！"
--><!--#include virtual="include/top.html" -->
對 <!--#echo var="REDIRECT_REQUEST_METHOD" --> 方法的請求必須帶有有效的
<code>Content-Length</code> 頭欄位。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_PRECONDITION_FAILED.html.var 0000664 0001751 0001751 00000017551 13317763731 022144 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Vstupní podmínka selhala!"
--><!--#include virtual="include/top.html" -->
Vstupní podmínka pro požadavek o zadané URL nesplnila pozitivní
vyhodnocení.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Vorbedingung verfehlt!"
--><!--#include virtual="include/top.html" -->
Die für den Abruf der angeforderten URL notwendige
Vorbedingung wurde nicht erfüllt.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Precondition failed!"
--><!--#include virtual="include/top.html" -->
The precondition on the request for the URL failed positive evaluation.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡Fallo en la pre-condicióon!" -->
<!--#include virtual="include/top.html" -->
No se ha evaluado positivamente la pre-condición
de la petición para la URL.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Précondition négative!"
--><!--#include virtual="include/top.html" -->
La précondition pour l'URL demandé a été
évaluée négativement.
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Theip ar réamhchoinníoll!"
--><!--#include virtual="include/top.html" -->
Theip meastóireacht an réamhchoinníoll
don iarratais den URL.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Criteri di precondizione non soddisfatti!"
--><!--#include virtual="include/top.html" -->
I criteri di precondizione per consentire l'invio dell'URL
richiesto non sono stati soddisfatti.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Precondition failed!"
--><!--#include virtual="include/top.html" -->
指定された URL へのリクエストにおける事前条件が満たされませんでした。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="주어진 조건 실패!"
--><!--#include virtual="include/top.html" -->
미리 주어진 조건이 만족되지 않아서 URL 요청을 처리할 수 없습니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Startvoorwaarde niet voldaan!"
--><!--#include virtual="include/top.html" -->
Een startvoorwaarde werd niet voldaan bij verwerking van de vraag naar de URL.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Nødvendig forutsetning ikke oppfyllt!"
--><!--#include virtual="include/top.html" -->
Den nødvendige forutsetningen for forespørselen passerte ikke
vurderingen med positivt resultat.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Niespełniony warunek!"
--><!--#include virtual="include/top.html" -->
Warunek wstępny dla URL-a nie został spełniony.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Falha de precondição!"
--><!--#include virtual="include/top.html" -->
A condição necessária para a
requisição da URL foi avaliada como falsa.
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Pré-condição falhou!"
--><!--#include virtual="include/top.html" -->
A condição necessária ao pedido do URL
foi avaliada com resultado negativo.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Precondition failed!"
--><!--#include virtual="include/top.html" -->
Preconditionarea pentru cererea URL-ului nu a fost evaluata pozitiv.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Условие ложно!"
--><!--#include virtual="include/top.html" -->
Условие в запросе к данному ресурсу не было выполнено.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Предуслов није испуњен!"
--><!--#include virtual="include/top.html" -->
Предуслов за захтев УРЛ-а није испуњен.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Nödvändig förutsättning misslyckades!"
--><!--#include virtual="include/top.html" -->
Den nödvändiga förutsättningen för
adressförfrågan passerade inte utvärderingen
med acceptabelt resultat.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Önkoşul sağlanamadı!"
--><!--#include virtual="include/top.html" -->
URL talebinin önkoşulu olumlanamadı.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="先决条件不成立！"
--><!--#include virtual="include/top.html" -->
对该 URL 发送的请求，包含的先决条件不成立。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="先決條件不成立！"
--><!--#include virtual="include/top.html" -->
對該 URL 發送的請求，包含的先決條件不成立。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_SERVICE_UNAVAILABLE.html.var 0000664 0001751 0001751 00000023153 13317763731 022141 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Služba není dostupná!"
--><!--#include virtual="include/top.html" -->
Server dočasně nemůže zpracovat Váš požadavek
kvůli údržbě nebo kapacitním problémům.
Zkuste to, prosím, později.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Zugriff nicht möglich!"
--><!--#include virtual="include/top.html" -->
Der Server ist derzeit nicht in der Lage die Anfrage
zu bearbeiten. Entweder ist der Server derzeit überlastet
oder wegen Wartungsarbeiten nicht verfügbar.
Bitte versuchen Sie es später wieder.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Service unavailable!"
--><!--#include virtual="include/top.html" -->
The server is temporarily unable to service your
request due to maintenance downtime or capacity
problems. Please try again later.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡Servicio no disponible!" -->
<!--#include virtual="include/top.html" -->
El servidor no puede procesar su solicitud en este momento
debido a tareas de mantenimiento o a problemas de capacidad.
Por favor, inténtelo de nuevo más tarde.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Service inaccessible!"
--><!--#include virtual="include/top.html" -->
En raison de travaux de maintenance ou de problèmes
de capacité le serveur n'est pas en mesure de répondre
à votre requête pour l'instant. Veuillez réessayer
plus tard.
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Seirbhís doúsáidte!"
--><!--#include virtual="include/top.html" -->
Níl an freastalaí seo in ann do chuid
iarratais a líonadh ag an am seo, toisc
cóthábháil nó fhaidhbeanna cumas.
Déan iarracht eile níos déanaí, le do thoil.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Servizio non disponibile!"
--><!--#include virtual="include/top.html" -->
Il server in questo momento non è in grado di
soddisfare la richiesta per motivi di manutenzione
o di sovraccarico del sistema.
Per favore, riprova più tardi.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Service unavailable!"
--><!--#include virtual="include/top.html" -->
メンテナンスで停止中か、サーバの処理能力の問題のため、
現在リクエストに応じることができません。
後ほど再度お試し下さい。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="서비스 일시중지!"
--><!--#include virtual="include/top.html" -->
관리 작업이나 용량 문제로 서버가 잠시동안 요청을 처리할 수 없습니다.
나중에 다시 시도해주시기 바랍니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Dienst niet beschikbaar!"
--><!--#include virtual="include/top.html" -->
De server kan tijdelijk uw vraag niet verwerken
door onderhoud of problemen met de capaciteit van de server.
Gelieve later nog eens opnieuw te proberen.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Tjenesten er ikke tilgjengelig!"
--><!--#include virtual="include/top.html" -->
Serveren er midlertidig ikke i stand til å utføre din
forespørsel. Vennligst prøv igjen senere.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Serwis niedostępny!"
--><!--#include virtual="include/top.html" -->
Serwer nie może zrealizować twojego żądania
ze względu na konserwację lub zbyt duże obciążenie.
Prosimy spróbować później.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Serviço indisponível!"
--><!--#include virtual="include/top.html" -->
O servidor está temporariamente fora de serviço
para manutanção ou devido a problemas de capacidade.
Por favor tente acessar mais tarde.
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Serviço indisponível!"
--><!--#include virtual="include/top.html" -->
O servidor está temporáriamente incapaz de servir
o seu pedido devido a uma interrupção para
manutenção ou problemas de capacidade. Por favor
tente de novo mais tarde.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Serviciu indisponibil!"
--><!--#include virtual="include/top.html" -->
Serverul nu poate, temporar, sa raspunda cererii
dumneavoastra datorita intretinerii acestuia sau a
unor probleme de capacitate. Va rugam incercati mai tarziu.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Сервис недоступен!"
--><!--#include virtual="include/top.html" -->
Сервер временно не имеет возможности обработать Ваш запрос
по техническим причинам. Пожалуйста, повторите позже.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Услуга је недоступна!"
--><!--#include virtual="include/top.html" -->
Сервер тренутно није у могућности да услужи ваш
захтев пошто је затворен због одржавања или има недовољан
капацитет. Молимо покушајте поново касније.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Tjänsten ej tillgänglig!"
--><!--#include virtual="include/top.html" -->
Servern är för tillfället oförmögen att
utföra din förfrågan på grund av underhåll
eller kapacitetsbegränsningar. Vänligen försök
igen senare.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Hizmet sunulamıyor!"
--><!--#include virtual="include/top.html" -->
Sunucu, bakım gerektiren çeşitli sorunlardan ötürü,
bir süreliğine taleplerinize yanıt veremiyor.
Lütfen daha sonra tekrar deneyin.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="服务不可用！"
--><!--#include virtual="include/top.html" -->
由于服务器维护或负载问题，服务器暂时无法处理您的请求。请稍后重试。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="服務不可用！"
--><!--#include virtual="include/top.html" -->
由於伺服器維護或負載問題，伺服器暫時無法處理您的請求。請稍後重試。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/README 0000664 0001751 0001751 00000004333 13317763731 015601 0 ustar covener covener
Multi Language Custom Error Documents
-------------------------------------
The 'error' directory contains HTTP error messages in multiple languages.
If the preferred language of a client is available it is selected
automatically via the MultiViews feature. This feature is enabled
by default via the Options, Language and ErrorDocument directives.
You may configure the design and markup of the documents by modifying
the HTML files in the directory 'error/include'.
Supported Languages:
+-----------------------+------------------------------------------+
| Language | Contributed by |
+-----------------------+------------------------------------------+
| Brazilian (pt-br) | Ricardo Leite |
| Chinese (zh-cn/zh-tw) | CodeingBoy & popcorner |
| Czech (cs) | Marcel Kolaja |
| Dutch (nl) | Peter Van Biesen |
| English (en) | Lars Eilebrecht |
| French (fr) | Cecile de Crecy |
| German (de) | Lars Eilebrecht |
| Italian (it) | Luigi Rosa |
| Japanese (ja) | TAKAHASHI Makoto |
| Korean (ko) | Jaeho Shin |
| Norwegian Bokmål (nb) | Tom Fredrik Klaussen |
| Polish (pl) | Tomasz Kepczynski |
| Romanian (ro) | Andrei Besleaga |
| Russian (ru) | Alexander Gaganashvili |
| Serbian (sr) | Nikola Smolenski |
| Spanish (es) | Karla Quintero |
| Swedish (sv) | Thomas Sjögren |
| Turkish (tr) | Emre Sokullu & Nilgün Belma Bugüner |
| Irish (ga) | Noirin Shirley |
+-----------------------+------------------------------------------+
(Please see http://httpd.apache.org/docs-project/ if you would
like to contribute the pages in an additional language.)
httpd-2.4.64/docs/error/HTTP_BAD_GATEWAY.html.var 0000664 0001751 0001751 00000026512 13317763731 021007 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Chybná brána!"
--><!--#include virtual="include/top.html" -->
Proxy server obdržel od nadřazeného
serveru chybnou odpověď.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Fehlerhaftes Gateway!"
--><!--#include virtual="include/top.html"-->
Der Proxy-Server erhielt eine fehlerhafte Antwort
eines übergeordneten Servers oder Proxies.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Bad Gateway!"
--><!--#include virtual="include/top.html" -->
The proxy server received an invalid
response from an upstream server.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡Puerta de enlace errónea!" -->
<!--#include virtual="include/top.html" -->
El servidor 'proxy' ha recibido; información
no válida del servidor de origen.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Gateway incorrecte!"
--><!--#include virtual="include/top.html" -->
Le serveur proxy a reçu une réponse
incorrecte de la part d'un serveur supérieur.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="CONTENT_LANGUAGE" value="ga"
--><!--#set var="TITLE" value="Geata míceart!"
--><!--#include virtual="include/top.html" -->
Fuair an seachfhreastalaí freagairt neamhbhailí
ó freastalaí thuasthrutha.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Gateway errato!"
--><!--#include virtual="include/top.html" -->
Il server proxy ha ricevuto una risposta
non valida dal server precedente.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Bad Gateway!"
--><!--#include virtual="include/top.html" -->
プロクシサーバは上流サーバから不正な応答を受信しました。
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="잘못된 게이트웨이!"
--><!--#include virtual="include/top.html" -->
프록시 서버가 더 윗쪽의 서버로부터 잘못된 응답을 받았습니다.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Verkeerde Gateway!"
--><!--#include virtual="include/top.html" -->
De proxy server heeft een ongeldig
antwoord ontvangen van een gecontacteerde server.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Ugyldig Gateway!"
--><!--#include virtual="include/top.html" -->
Proxyserveren mottok et ugyldig svar fra
en oppstrøms server.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Nieprawidłowa brama!"
--><!--#include virtual="include/top.html" -->
Serwer otrzymał nieprawidłową odpowiedź
od kolejnego serwera.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Gateway inválido!"
--><!--#include virtual="include/top.html" -->
O servidor proxy recebeu uma resposta
inválida do servidor destino.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Gateway inválida!"
--><!--#include virtual="include/top.html" -->
O servidor de <i>proxy</i> recebeu uma resposta
inválida de um outro servidor externo a ele.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Gateway invalid!"
--><!--#include virtual="include/top.html" -->
Serverul proxy a primit un raspuns invalid
de la serverul precedent.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Неверный шлюз!"
--><!--#include virtual="include/top.html" -->
Прокси-сервер получил недопустимый ответ от
вышестоящего сервера.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Лош пролаз!"
--><!--#include virtual="include/top.html" -->
Посреднички сервер је примио неисправан
одговор од следећег сервера у низу.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Felaktig Gateway!"
--><!--#include virtual="include/top.html" -->
Proxyservern mottog ett felaktigt svar från
en tidigare server.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Hatalı Ağ Geçidi!"
--><!--#include virtual="include/top.html" -->
Vekil sunucu üstbirim sunucudan
anlamsız bir yanıt aldı.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="错误的网关！"
--><!--#include virtual="include/top.html" -->
代理服务器从上游服务器收到了无效的响应。
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="閘道器錯誤！"
--><!--#include virtual="include/top.html" -->
代理伺服器從上遊伺服器收到了無效的響應。
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
<!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_INTERNAL_SERVER_ERROR.html.var 0000664 0001751 0001751 00000040774 13317763731 022521 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Chyba serveru!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Nastala vnitřní chyba a server nebyl schopen
dokončit Váš požadavek.
<!--#include virtual="include/spacer.html" -->
Chybová zpráva
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Nastala vnitřní chyba a server nebyl schopen
dokončit Váš požadavek. Buď je server
přetížen, nebo došlo k chybě v CGI skriptu.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Serverfehler!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Die Anfrage kann nicht beantwortet werden, da im Server
ein interner Fehler aufgetreten ist.
<!--#include virtual="include/spacer.html" -->
Fehlermeldung:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Die Anfrage kann nicht beantwortet werden, da im Server
ein interner Fehler aufgetreten ist.
Der Server ist entweder überlastet oder ein Fehler in
einem CGI-Skript ist aufgetreten.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Server error!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
The server encountered an internal error and was
unable to complete your request.
<!--#include virtual="include/spacer.html" -->
Error message:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
The server encountered an internal error and was
unable to complete your request. Either the server is
overloaded or there was an error in a CGI script.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡Error del servidor!" -->
<!--#include virtual="include/top.html" -->
Se ha producido un error interno en el servidor y no
se ha podido completar su solicitud.
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
Mensaje de error:<br />
<!--#echo var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Se ha producido un error interno en el servidor y no se
ha podido completar su solicitud. O el servidor está
sobrecargado o ha habido un fallo en la ejecución de
un programa CGI.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Erreur du serveur!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Le serveur a été victime d'une erreur interne et n'a pas
été capable de faire aboutir votre requête.
<!--#include virtual="include/spacer.html" -->
Message d'erreur:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Le serveur a été victime d'une erreur interne et n'a pas
été capable de faire aboutir votre requête.
Soit le server est surchargé soit il s'agit d'une erreur dans
le script CGI.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Earráid fhreastalaí!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Thit an freastalaí ar earráid inmheánach
agus theip air do chuid iarratais a comhlíonadh.
<!--#include virtual="include/spacer.html" -->
Teachtaireacht earráide:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Thit an freastalaí ar earráid inmheánach
agus theip air do chuid iarratais a comhlíonadh.
Is féidir go bhfuil an freastalaí
rólóaidithe, nó go raibh earráid
i script CGI éigin.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Errore del server!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Il server ha generato un errore interno e non è
in grado di soddisfare la richiesta.
<!--#include virtual="include/spacer.html" -->
Messaggio di errore:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Il server ha generato un errore interno e non è
in grado di soddisfare la richiesta. Il server potrebbe
essere sovraccarico oppure si è verificato un
errore in uno script CGI.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Server error!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
サーバ内部で障害が発生し、
リクエストに応えることができませんでした。
<!--#include virtual="include/spacer.html" -->
Error message:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
サーバ内部で障害が発生し、
リクエストに応えることができませんでした。
サーバが過負荷であるか、
CGI スクリプトにエラーがあります。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="서버 오류!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
서버에 내부 오류가 발생하여 요청을 끝까지 처리하지 못했습니다.
<!--#include virtual="include/spacer.html" -->
오류 내용:
<br /><!--#echo var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
서버에 내부 오류가 생겨 요청을 끝까지 처리하지 못했습니다.
서버에 과부하가 걸렸거나 아니면 CGI 프로그램에 오류가 있었습니다.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Server fout!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
<!--#include virtual="include/spacer.html" -->
Foutbericht:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
De server kreeg een interne fout en kon
uw vraag niet beantwoorden. De server is overbelast
of er was een fout in een CGI script.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Serverfeil!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Det inntraff en intern feil hos serveren, og det var ikke mulig å
gjennomføre din forespørsel.
<!--#include virtual="include/spacer.html" -->
Feilmelding:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Det inntraff en intern feil hos serveren, og det var ikke mulig å
gjennomføre din forespørsel. Serveren er enten overbelastet, eller
CGI-skriptet inneholder feil.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Błąd serwera!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Serwer napotkał błąd wewnętrzny i nie jest w stanie
zrealizować twojego żądania.
<!--#include virtual="include/spacer.html" -->
Informacja o błędzie:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Serwer napotkał błąd wewnętrzny i nie jest w stanie
zrealizować twojego żądania. Serwer jest przeciążony lub
napotkał na błąd w skrypcie CGI.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Erro interno do Servidor!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
O servidor encontrou um erro interno e não pode
completar sua requisição.
<!--#include virtual="include/spacer.html" -->
Mensagem de Erro:
<br /><!--#echo var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
O servidor encontrou um erro interno e não
foi possível completar sua requisição.
O servidor está sobrecarregado ou existe um
erro em um script CGI.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Erro interno do servidor!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
O servidor encontrou um erro interno e não pode completar
o seu pedido.
<!--#include virtual="include/spacer.html" -->
Mensagem de erro:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
O servidor encontrou um erro interno e não pode completar
o seu pedido. Ou o servidor está sobrecarregado, ou ocorreu
um erro num <i>script</i> CGI.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Eroare server!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Serverul a intalnit o eroare interna si nu a
putut rezolva cererea dumneavoastra.
<!--#include virtual="include/spacer.html" -->
Mesajul de eroare :
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Serverul a intalnit o eroare interna si nu a
putut rezolva cererea dumneavoastra. Serverul este
supraincarcat sau a fost o eroare intr-un script CGI.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Ошибка сервера!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Произошла внутренняя ошибка сервера, в результате которой
серверу не удалось завершить обработку Вашего запроса.
<!--#include virtual="include/spacer.html" -->
Error message:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Произошла внутренняя ошибка сервера, в результате которой
серверу не удалось завершить обработку Вашего запроса.
Сервер перегружен, или в CGI-скрипте обнаружена ошибка.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Грешка сервера!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Сервер је имао унутрашњу грешку и није био
у могућности да испуни ваш захтев.
<!--#include virtual="include/spacer.html" -->
Порука о грешци:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Сервер је имао унутрашњу грешку и није био
у могућности да испуни ваш захтев. Могуће је да је сервер
преоптерећен, или да се десила грешка у CGI скрипти.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Serverfel!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Servern råkade ut för ett internt fel och det var inte möjligt
att slutföra din begäran.
<!--#include virtual="include/spacer.html" -->
Felmeddelande:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Servern råkade ut för ett internt fel och det var inte möjligt
att slutföra din begäran. Servern är antingen överbelastad
eller så innehåller CGI-skriptet fel.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Sunucu hatası!"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
Sunucuda içsel bir hata oluştuğundan sunucu isteğinizi yerine getiremiyor.
<!--#include virtual="include/spacer.html" -->
Hata iletisi:
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
Sunucuda içsel bir hata oluştuğundan sunucu isteğinizi yerine getiremiyor.
Ya sunucu aşırı yüklü ya da CGI betiğinde bir hata oluştu.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="服务器错误！"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
服务器发生了内部错误，无法处理您的请求。
<!--#include virtual="include/spacer.html" -->
错误信息：
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
服务器发生了内部错误，无法处理您的请求。原因可能是服务器过载或在 CGI 脚本中出错。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="伺服器错误！"
--><!--#include virtual="include/top.html" -->
<!--#if expr="-n v('REDIRECT_ERROR_NOTES')" -->
伺服器發生了內部錯誤，無法處理您的請求。
<!--#include virtual="include/spacer.html" -->
錯誤資訊：
<br /><!--#echo encoding="none" var="REDIRECT_ERROR_NOTES" -->
<!--#else -->
伺服器發生了內部錯誤，無法處理您的請求。原因可能是伺服器超載或在 CGI 腳本中出錯。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_NOT_IMPLEMENTED.html.var 0000664 0001751 0001751 00000017265 13317763731 021530 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Nelze zpracovat požadavek!"
--><!--#include virtual="include/top.html" -->
Server nepodporuje akci požadovanou prohlížečem.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Anfrage nicht ausführbar!"
--><!--#include virtual="include/top.html" -->
Die vom Browser angeforderte Aktion wird vom Server
nicht unterstützt.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Cannot process request!"
--><!--#include virtual="include/top.html" -->
The server does not support the action requested by the browser.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡No se puede procesar la petición!" -->
<!--#include virtual="include/top.html" -->
El servidor no soporta la acción
solicitada por el navegador.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="La requête ne peut être effectuée!"
--><!--#include virtual="include/top.html" -->
Le serveur n'est pas en mesure d'effectuer l'action
demandée par le navigateur.
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Iarratais dophróiseáilte!"
--><!--#include virtual="include/top.html" -->
Níl tacaíocht ag an fhreastalaí don gníomh
atá á iarraidh ag an mbrabhsálaí.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="La richiesta non può essere soddisfatta!"
--><!--#include virtual="include/top.html" -->
Il server non supporta il tipo di azione richiesta dal browser.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Cannot process request!"
--><!--#include virtual="include/top.html" -->
ブラウザの要求したアクションは、サポートしていません。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="요청 처리 실패!"
--><!--#include virtual="include/top.html" -->
브라우저가 보낸 요청을 이 서버가 지원하지 않습니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Kan vraag niet verwerken!"
--><!--#include virtual="include/top.html" -->
De server ondersteunt de actie, gevraagd door de browser, niet.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Kan ikke behandle forspørsel!"
--><!--#include virtual="include/top.html" -->
Serveren støtter ikke den handlingen som ønskes utført av
nettleseren.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Żądanie nieobsługiwane!"
--><!--#include virtual="include/top.html" -->
Ten serwer nie obsługuje żądania przesłanego przez przeglądarkę.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="A requisição não pode ser processada!"
--><!--#include virtual="include/top.html" -->
O servidor não suporta a ação requisitada pelo
seu "browser".
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Não posso processar o pedido!"
--><!--#include virtual="include/top.html" -->
O servidor não suporta a acção pedida pelo
<i>browser</i>.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Cererea nu poate fi procesata!"
--><!--#include virtual="include/top.html" -->
Serverul nu suporta actiunea ceruta de browser.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Запрос не может быть обработан!"
--><!--#include virtual="include/top.html" -->
Сервер не поддерживает возможностей, необходимых для обработки запроса.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Не могу да обрадим захтев!"
--><!--#include virtual="include/top.html" -->
Сервер не подржава акцију коју је читач захтевао.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Kan ikke utf!"
--><!--#include virtual="include/top.html" -->
Servern stödjer inte den handling som önskades
av webbläsaren.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="İstek yerine getirilemiyor!"
--><!--#include virtual="include/top.html" -->
Sunucu, tarayıcı tarafından istenen eylemi desteklemiyor.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="无法执行请求！"
--><!--#include virtual="include/top.html" -->
服务器不支持浏览器请求的动作。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="無法執行請求！"
--><!--#include virtual="include/top.html" -->
伺服器不支援瀏覽器請求的動作。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_REQUEST_URI_TOO_LARGE.html.var 0000664 0001751 0001751 00000021232 13317763731 022534 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Požadované URI je příliš velké!"
--><!--#include virtual="include/top.html" -->
Délka požadovaného URL přesahuje kapacitní limit tohoto
serveru. Požadavek nemůže být zpracován.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Übergebener URI zu groß!"
--><!--#include virtual="include/top.html" -->
Der bei der Anfrage übermittelte URI überschreitet
die maximale Länge.
Die Anfrage kann nicht ausgeführt werden.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Submitted URI too large!"
--><!--#include virtual="include/top.html" -->
The length of the requested URL exceeds the capacity limit for
this server. The request cannot be processed.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡El URI enviado es demasiado largo!" -->
<!--#include virtual="include/top.html" -->
La longitud de la URL solicitada excede el límite de
capacidad para este servidor. No se puede procesar la solicitud.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="L'URI demandee est trop longue!"
--><!--#include virtual="include/top.html" -->
La longueur de l'URL demandée excède la limite de
capacitè pour ce serveur. Nous ne pouvons donner suite
à votre requête.
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="URI rómhór cuirthe isteach!"
--><!--#include virtual="include/top.html" -->
Tá faid an URL iarraithe breis ar an teorainn cumas don
freastalaí seo. Ní féidir an iarratas a
phróiseáil.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="URI troppo lungo!"
--><!--#include virtual="include/top.html" -->
La lunghezza dell'indirizzo (URL) trasmesso supera il
limite massimo imposto da questo server.
La richiesta non può essere soddisfatta.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Submitted URI too large!"
--><!--#include virtual="include/top.html" -->
リクエストの URL の長さが、扱える長さを超えています。
リクエストの処理を続けられません。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="너무 긴 URI!"
--><!--#include virtual="include/top.html" -->
요청한 URL이 너무 길어서 이 서버가 처리할 수 없습니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Aangeboden URI te groot!"
--><!--#include virtual="include/top.html" -->
De lengte van de aangeboden URL overschreidt het maximum
voor deze server. De vraag kan niet verwerkt worden.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Forespurt URI for stor!"
--><!--#include virtual="include/top.html" -->
Lengden på adressen som etterspurtes overskrider
kapasitetsgrensen for denne serveren. Forespørselen kan
ikke prosesseres.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Zbyt długie URI!"
--><!--#include virtual="include/top.html" -->
Długość żądanego URL-a przekracza limit ustanowiony dla tego
serwera. Żądanie nie może zostać zrealizowane.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="URL excede limite!"
--><!--#include virtual="include/top.html" -->
O tamanho do endereço (URL) excede a capacidade limite
desse servidor. A requisição não pode ser
processada.
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="URI demasiado grande!"
--><!--#include virtual="include/top.html" -->
O tamanho do URL pedido excede o limite da capacidade deste
servidor. O pedido não pode ser processado.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="URL-ul submis este prea mare!"
--><!--#include virtual="include/top.html" -->
Lungimea URL-ului cerut depaseste limita capacitatii pentru
acest server. Cererea nu poate fi procesata.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="URI слишком длинный!"
--><!--#include virtual="include/top.html" -->
Длина запрашиваемого URL превышает максимально допустимую
сервером. Запрос не может быть обработан.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Послати УРИ је превелик!"
--><!--#include virtual="include/top.html" -->
Дужина захтеваног УРЛ-а премашује ограничења могућности
овог сервера. Захтев не може бити обрађен.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Efterfrågad URI för stor!"
--><!--#include virtual="include/top.html" -->
Längden på adressen som efterfrågas överskrider
kapacitetsgränsen för denna server. Förfrågan kan
inte verkställas.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Gönderilen URI çok büyük!"
--><!--#include virtual="include/top.html" -->
Talep edilen URI'nin uzunluğu, sunucunun sınırlarını
aştığından istek yerine getirilemiyor.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="提交的 URI 过长！"
--><!--#include virtual="include/top.html" -->
请求 URL 的长度超出了服务器的长度限制。该请求无法处理。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="提交的 URI 過長！"
--><!--#include virtual="include/top.html" -->
請求 URL 的長度超出了伺服器的長度限制。該請求無法處理。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_VARIANT_ALSO_VARIES.html.var 0000664 0001751 0001751 00000021104 13317763731 022223 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Varianta má sama více variant!"
--><!--#include virtual="include/top.html" -->
Varianta požadované entity má sama více variant. Přístup není možný.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Variante ebenfalls veränderlich!"
--><!--#include virtual="include/top.html" -->
Ein Zugriff auf das angeforderte Objekt bzw. einer
Variante dieses Objektes ist nicht möglich, da es ebenfalls
ein variables Objekt darstellt.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Variant also varies!"
--><!--#include virtual="include/top.html" -->
A variant for the requested entity
is itself a negotiable resource.
Access not possible.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="La variante también varia!" -->
<!--#include virtual="include/top.html" -->
Una variante de la entidad solicitada es por si misma
un recurso negociable.
No es posible tener acceso a la entidad.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="La variante varie elle-même!"
--><!--#include virtual="include/top.html" -->
Une variante pour l'entité demandée
est elle-même une ressource négociable.
L'accès est impossible.
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Athraitheach intráchta!"
--><!--#include virtual="include/top.html" -->
Is é ceann de na athraithaí
don aonán iarraithe acmhainn
intráchta féin.
Rochtain dodhéanta.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="La versione variante varia essa stessa!"
--><!--#include virtual="include/top.html" -->
Non è possibile accedere all'entità
richiesta perché è essa stessa
una risorsa negoziabile.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Variant also varies!"
--><!--#include virtual="include/top.html" -->
リクエストされたものの variant
はそれ自体もまた、ネゴシエーション可能なリソースです。
アクセスできませんでした。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="형태를 결정할 수 없음!"
--><!--#include virtual="include/top.html" -->
요청한 객체의 형태 또한 여러 형태를 가지고 있어서
접근이 불가능합니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Variant varieert ook!"
--><!--#include virtual="include/top.html" -->
Een variant van het gevraagde object
is op zich ook een te onderhandelen variant.
Toegang is niet mogelijk.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Variant varierer også!"
--><!--#include virtual="include/top.html" -->
En variant av den forespurte enheten er i seg selv en forhandelbar
ressurs. Tilgang ikke mulig.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Wariant jest wariantowy!"
--><!--#include virtual="include/top.html" -->
Wariant żądanego zasobu jest również zasobem negocjowalnym.
Dostęp jest niemożliwy.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Variante auto-negociável!"
--><!--#include virtual="include/top.html" -->
Uma variante da entidade de requisição
é por si mesma um recurso negociável.
Acesso não é possível.
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Variante também varia!"
--><!--#include virtual="include/top.html" -->
A variante relativa à entidade pedida é ela mesma
um recurso negociável. Não é possível
ter acesso.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Varianta deasemenea variaza!"
--><!--#include virtual="include/top.html" -->
O varianta pentru entitatea ceruta
este ea insasi o resursa negociabila.
Accesul nu este posibil.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Вариант также варьируется!"
--><!--#include virtual="include/top.html" -->
Вариант запрашиваемого объекта - и сам ресурс непостоянный.
Доступ к объекту невозможен.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Варијанта такође варира!"
--><!--#include virtual="include/top.html" -->
Варијанта захтеваног ентитета
је и сама ресурс који постоји у више варијанти.
Приступ није могућ.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Variant also varies!"
--><!--#include virtual="include/top.html" -->
En variant av den förfrågade enheten är i
sig själv en giltig resurs. Åtkomst är inte
möjlig.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Gösterim çeşitleri de çeşitli!"
--><!--#include virtual="include/top.html" -->
İstenen gösterim çeşidinin kendisi zaten kendi içinde uzlaşımlı.
Erişim mümkün değil.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="变元是可变的！"
--><!--#include virtual="include/top.html" -->
请求实体的一个变元自身是一个可被协商的资源。无法访问。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="變元是可變的！"
--><!--#include virtual="include/top.html" -->
請求實體的一個變元自身是一個可被協商的資源。無法訪問。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_NOT_FOUND.html.var 0000664 0001751 0001751 00000040744 13317763731 020636 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Objekt nenalezen!"
--><!--#include virtual="include/top.html" -->
Požadované URL nebylo na tomto serveru nalezeno.
<!--#if expr="-n v('HTTP_REFERER')" -->
Zdá se, že odkaz na
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">odkazující
stránce</a> je chybný nebo zastaralý. Informujte, prosím, autora
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">této stránky</a>
o chybě.
<!--#else -->
Pokud jste zadal(a) URL ručně, zkontrolujte, prosím,
zda jste zadal(a) URL správně, a zkuste to znovu.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Objekt nicht gefunden!"
--><!--#include virtual="include/top.html" -->
Der angeforderte URL konnte auf dem Server nicht gefunden werden.
<!--#if expr="-n v('HTTP_REFERER')" -->
Der Link auf der
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">verweisenden
Seite</a> scheint falsch oder nicht mehr aktuell zu sein.
Bitte informieren Sie den Autor
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">dieser Seite</a>
über den Fehler.
<!--#else -->
Sofern Sie den URL manuell eingegeben haben,
überprüfen Sie bitte die Schreibweise und versuchen Sie es erneut.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Object not found!"
--><!--#include virtual="include/top.html" -->
The requested URL was not found on this server.
<!--#if expr="-n v('HTTP_REFERER')" -->
The link on the
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">referring
page</a> seems to be wrong or outdated. Please inform the author of
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">that page</a>
about the error.
<!--#else -->
If you entered the URL manually please check your
spelling and try again.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡Objeto no localizado!" -->
<!--#include virtual="include/top.html" -->
No se ha localizado la URL solicitada en este servidor.
<!--#if expr="-n v('HTTP_REFERER')" -->
La URL de la <a href="<!--#echo encoding="url"
var="HTTP_REFERER"-->">página que le ha remitido</a>
parece ser errónea o estar obsoleta. Por favor, informe del error
al autor de <a href="<!--#echo encoding="url" var="HTTP_REFERER"-->">esa
página</a>.
<!--#else -->
Si usted ha introducido la URL manualmente, por favor revise su
ortografía e inténtelo de nuevo.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Objet non trouvé!"
--><!--#include virtual="include/top.html" -->
L'URL demandée n'a pas pu être trouvée sur ce serveur.
<!--#if expr="-n v('HTTP_REFERER')" -->
La référence sur
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">la page
citée</a>
semble être erronée ou perimée. Nous vous prions
d'informer l'auteur de
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">cette page</a>
de cette erreur.
<!--#else -->
Si vous avez tapé l'URL à la main, veuillez vérifier
l'orthographe et réessayer.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Aidhm ar iarraidh!"
--><!--#include virtual="include/top.html" -->
Níor aimsigh an URL iarraithe ar an fhreastalaí seo.
<!--#if expr="-n v('HTTP_REFERER')" -->
Is cosúil go bhfuil an nasc ar an
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">leathanach
thagarthach</a> mícheart nó as dáta.
Cur in iúl d'úadar
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->"
>an leathanach sin</a> go bhfuil earráid ann, le do thoil.
<!--#else -->
Má chuir tú isteach an URL tú féin, deimhnigh
go bhfuil sé litrithe i gceart agat, agus déan iarracht eile
le do thoil.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Oggetto non trovato!"
--><!--#include virtual="include/top.html" -->
L'URL richiesto non esiste su questo server.
<!--#if expr="-n v('HTTP_REFERER')" -->
Il link della
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">pagina da cui
sei arrivato</a> potrebbe essere errato o non essere più valido.
Per favore, informa dell'errore l'autore della
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">pagina</a>.
<!--#else -->
Se hai scritto l'URL a mano, per favore controlla che
non ci siano errori.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Object not found!"
--><!--#include virtual="include/top.html" -->
要求された URL は本サーバでは見つかりませんでした。
<!--#if expr="-n v('HTTP_REFERER')" -->
<a href="<!--#echo encoding="url" var="HTTP_REFERER"-->">
参照元ページ</a>のリンクが間違っているか、古くなってしまっているようです。
<a href="<!--#echo encoding="url" var="HTTP_REFERER"-->"
>ページ</a>の著者にこのエラーをお知らせ下さい。
<!--#else -->
もし手入力で URL を入力した場合は、綴りを確認して再度お試し下さい。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="객체 없음!"
--><!--#include virtual="include/top.html" -->
요청한 URL을 이 서버에서 찾을 수 없습니다.
<!--#if expr="-n v('HTTP_REFERER')" -->
<a href="<!--#echo encoding="url" var="HTTP_REFERER"-->">이전
페이지</a>에 있는 링크가 잘못되었거나 오래되어 없어진 것 같습니다.
<a href="<!--#echo encoding="url" var="HTTP_REFERER"-->">그 페이지</a>를
만든이에게 이 사실을 알려주시기 바랍니다.
<!--#else -->
URL을 직접 입력하셨다면 바르게 입력하셨는지 확인하시고 다시 시도하시기
바랍니다.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Object niet gevonden!"
--><!--#include virtual="include/top.html" -->
De gevraagde URL was niet gevonden op deze server.
<!--#if expr="-n v('HTTP_REFERER')" -->
De link op
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">deze pagina
pagina</a> is verkeerd of achterhaald. Gelieve de auteur van
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">die pagina</a>
in te lichten over deze fout.
<!--#else -->
Indien u de URL manueel hebt ingevuld, gelieve uw
spelling te controleren en probeer opnieuw.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Objektet ble ikke funnet!"
--><!--#include virtual="include/top.html" -->
Den etterspurte adressen finnes ikke på denne serveren.
<!--#if expr="-n v('HTTP_REFERER')" -->
Lenken på den
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">forrige siden</a>
ser ut til å være feil eller utdatert. Venligst informer forfatteren av
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">siden</a>
om feilen.
<!--#else -->
Om du skrev inn adressen manuelt, vennligst kontroller stavingen og
forsøk igjen.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Nie znaleziono obiektu!"
--><!--#include virtual="include/top.html" -->
Nie znaleziono żądanego URL-a na tym serwerze.
<!--#if expr="-n v('HTTP_REFERER')" -->
Odnośnik na
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">referującej stronie
</a> wydaje się być nieprawidłowy lub nieaktualny. Poinformuj autora
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">tej strony</a>
o problemie.
<!--#else -->
Jeśli wpisałeś URL-a ręcznie, sprawdź, czy się nie pomyliłeś.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Objeto não encontrado!"
--><!--#include virtual="include/top.html" -->
A URL requisitada não foi encontrada neste servidor.
<!--#if expr="-n v('HTTP_REFERER')" -->
O link na
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">página
referida</a> parece estar com algum erro ou desatualizado. Por favor informe o
autor <a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">desta
página</a> sobre o erro.
<!--#else -->
Se você digitou o endereço (URL) manualmente,
por favor verifique novamente a sintaxe do endereço.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Método não permitido!"
--><!--#include virtual="include/top.html" -->
O método <!--#echo var="REDIRECT_REQUEST_METHOD" --> não
é permitido para o URL pedido.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Obiectul nu a fost gasit!"
--><!--#include virtual="include/top.html" -->
URL-ul cerut nu a fost gasit pe acest server.
<!--#if expr="-n v('HTTP_REFERER')" -->
Link-ul de pe
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">pagina
de unde ati venit</a> pare a fi gresit sau invechit. Va rugam informati autorul
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">acestei pagini</a>
despre eroare.
<!--#else -->
Daca ati introdus URL-ul manual, va rugam verificati
corectitudinea si incercati din nou.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Объект не найден!"
--><!--#include virtual="include/top.html" -->
Запрашиваемый ресурс не найден.
<!--#if expr="-n v('HTTP_REFERER')" -->
Ссылка на
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">странице
</a> неверна или устарела. Пожалуйста, сообщите автору
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">этой страницы</a>
об ошибке.
<!--#else -->
Если Вы ввели адрес данного ресурса вручную, пожалуйста, удостовертесь,
что в написании адреса нет ошибок.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Објекат није пронађен!"
--><!--#include virtual="include/top.html" -->
Захтевани УРЛ није пронађен на овом серверу.
<!--#if expr="-n v('HTTP_REFERER')" -->
Изгледа да је веза на
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">исходишној
страници</a> погрешна или застарела. Молимо обавестите аутора
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">те странице</a>
о грешци.
<!--#else -->
Уколико сте УРЛ унели ручно, молимо проверите могуће
грешке и пробајте поново.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Objektet hittas ej!"
--><!--#include virtual="include/top.html" -->
Den efterfrågade adressen hittades inte på denna server.
<!--#if expr="-n v('HTTP_REFERER')" -->
Länken på den
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">tidigare sidan</a>
verkar vara felaktig eller inaktuell. Vänligen informera författaren av
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">sidan</a>
om felet.
<!--#else -->
Om du skrev in adressen manuellt så kontrollera din stavning och
försök igen.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Nesne mevcut değil!"
--><!--#include virtual="include/top.html" -->
Talep ettiğiniz URL, sunucu üzerinde bulunmuyor.
<!--#if expr="-n v('HTTP_REFERER')" -->
<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">İstek yapılan sayfa</a>
üzerindeki bağlantı güncel değil. Lütfen <a href="<!--#echo encoding="url"
var="HTTP_REFERER" -->">sayfa</a> yazarını hata hakkında bilgilendirin.
<!--#else -->
URL'yi elle girdiyseniz, yazdıklarınızı gözden geçirip yeniden deneyin.
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="找不到对象！"
--><!--#include virtual="include/top.html" -->
您请求的 URL 在该服务器上未找到。
<!--#if expr="-n v('HTTP_REFERER')" -->
您的<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">来源页面</a>上的链接可能出错或过期。
请将错误通知给<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">该页面</a>的作者。
<!--#else -->
如果您是手动输入的 URL ，请检查拼写并重试。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="找不到物件！"
--><!--#include virtual="include/top.html" -->
您請求的 URL 在該伺服器上未找到。
<!--#if expr="-n v('HTTP_REFERER')" -->
您的<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">來源頁面</a>上的連結可能出錯或過期。
請將錯誤通知給<a href="<!--#echo encoding="url" var="HTTP_REFERER" -->">該來源頁面</a>的作者。
<!--#else -->
如果您是手動輸入的 URL ，請檢查拼寫並重試。
<!--#endif -->
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_REQUEST_TIME_OUT.html.var 0000664 0001751 0001751 00000021124 13317763731 021727 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Vypršel časový limit požadavku!"
--><!--#include virtual="include/top.html" -->
Server uzavřel síťové spojení, protože prohlížeč
nedokončil požadavek ve stanoveném čase.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Zeitlimit überschritten!"
--><!--#include virtual="include/top.html" -->
Der Server konnte nicht mehr länger auf die Beendigung
der Browseranfrage warten; die Netzwerkverbindung wurde
vom Server geschlossen.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Request time-out!"
--><!--#include virtual="include/top.html" -->
The server closed the network connection because the browser
didn't finish the request within the specified time.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡Tiempo de espera excedido!" -->
<!--#include virtual="include/top.html" -->
El servidor ha cerrado la conexión de red
debido a que el navegador no ha finalizado la solicitud
dentro del tiempo permitido.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Requête trop longue !"
--><!--#include virtual="include/top.html" -->
Le serveur a fermé la connection car le navigateur n'a pas
fini la requête dans le temps spécifié.
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Am don iarratais istigh!"
--><!--#include virtual="include/top.html" -->
Dún an freastalaí an nasc líonra,
mar níor chríochnaidh an brabhsálaí
leis an iarratais, taobh istigh den am sonraithe.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Time-out della richiesta!"
--><!--#include virtual="include/top.html" -->
Il server ha chiuso la connessione in quanto è stato
superato il limite di tempo entro il quale il browser avrebbe
dovuto eseguire la richiesta.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Request time-out!"
--><!--#include virtual="include/top.html" -->
ブラウザが指定時間以内にリクエストを完了しなかったので、
サーバは接続を切りました。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="요청 시간 초과!"
--><!--#include virtual="include/top.html" -->
브라우저가 너무 오랫동안 요청을 끝내지 않아서 서버가 네트워크 연결을
강제로 끊었습니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Tijdlimiet overschreden!"
--><!--#include virtual="include/top.html" -->
De server heeft de netwerkverbinding gesloten omdat de browser
de vraag niet heeft beëindigd binnen een gestelde tijd.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Tidsgrense overskredet!"
--><!--#include virtual="include/top.html" -->
Serveren stengte forbindelsen fordi nettleseren ikke avsluttet
forespørselen innen tidsgrensen.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Przedawnione żądanie!"
--><!--#include virtual="include/top.html" -->
Serwer zamknął połączenie sieciowe, ponieważ przeglądarka
nie zakończyła operacji w przewidywanym czasie.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Tempo excedido!"
--><!--#include virtual="include/top.html" -->
O servidor encerrou a conexão porque o "browser"
não finalizou a requisição dentro
do tempo limite.
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Tempo excedido!"
--><!--#include virtual="include/top.html" -->
O servidor interrompeu a ligação de rede porque o
<i>browser</i> não terminou o pedido dentro do tempo limite.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Time-out al cererii!"
--><!--#include virtual="include/top.html" -->
Serverul a terminat conexiunea cu browserul pentru ca acesta
nu a terminat cererea in limita timpului specificat.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Истекло время ожидания!"
--><!--#include virtual="include/top.html" -->
Сервер закрыл соединение из-за истечения времени,
отведённого браузеру на выполнение запроса.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Захтеву је истекло време!"
--><!--#include virtual="include/top.html" -->
Сервер је прекинуо везу са мрежом јер читач
није завршио захтев за дозвољено време.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Request time-out!"
--><!--#include virtual="include/top.html" -->
Servern stängde förbindelsen därför att
webbläsaren inte avslutade förfrågan inom
förbestämd tid.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="İstekte zaman aşımı!"
--><!--#include virtual="include/top.html" -->
Tarayıcı isteği zamanında tamamlayamadığından sunucu ağ bağlantısını kapattı.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="请求超时！"
--><!--#include virtual="include/top.html" -->
由于浏览器未在指定时间内完成请求，服务器关闭了网络连接。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="請求超時！"
--><!--#include virtual="include/top.html" -->
由於瀏覽器未在指定時間內完成請求，伺服器關閉了網路連接。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_UNSUPPORTED_MEDIA_TYPE.html.var 0000664 0001751 0001751 00000017231 13317763731 022626 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Nepodporovaný typ prostředku!"
--><!--#include virtual="include/top.html" -->
Server nepodporuje typ prostředku (media) přeneseného v požadavku.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Nicht unterstütztes Format!"
--><!--#include virtual="include/top.html" -->
Das bei der Anfrage übermittelte Format (Media Type)
wird vom Server nicht unterstützt.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Unsupported media type!"
--><!--#include virtual="include/top.html" -->
The server does not support the media type transmitted in the request.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡El tipo de medio no está soportado!" -->
<!--#include virtual="include/top.html" -->
El servidor no soporta el tipo
de medio transmitido en la solicitud.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Type de média invalide!"
--><!--#include virtual="include/top.html" -->
Le serveur ne supporte pas le type de média utilisé
dans votre requête.
<!--#include virtual="include/bottom.html"-->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Cineáil meán gan tachaíocht!"
--><!--#include virtual="include/top.html" -->
Ní tachaíonn an fhreastalaí an cineáil
meán a sheoladh san iarratais.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Tipo di dato non supportato!"
--><!--#include virtual="include/top.html" -->
Il server non è in grado di gestire il
tipo del formato dei dati trasmesso nella richiesta.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Unsupported media type!"
--><!--#include virtual="include/top.html" -->
リクエストで指定されたメディアタイプはサポートされていません。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="지원하지 않는 미디어 형식!"
--><!--#include virtual="include/top.html" -->
요청으로 보내온 미디어 형식을 이 서버가 지원하지 않습니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Niet ondersteund formaat!"
--><!--#include virtual="include/top.html" -->
De server ondersteunt het gevraagde formaat ( media type ) niet.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Mediatypen støttes ikke!"
--><!--#include virtual="include/top.html" -->
Serveren støtter ikke den mediatypen som ble forespurt.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Nieobsługiwany typ danych!"
--><!--#include virtual="include/top.html" -->
Serwer nie zna typu danych przesłanych w żądaniu.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Tipo de media não suportado!"
--><!--#include virtual="include/top.html" -->
O servidor não suporta o tipo de mídia
transmitida nesta requisição.
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Media não suportado!"
--><!--#include virtual="include/top.html" -->
O servidor não suporta o <i>media type</i> transmitido no pedido.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Tip de date nesuportate!"
--><!--#include virtual="include/top.html" -->
Serverul nu suporta tipul de date trimise in cerere.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Неподдерживаемый тип данных!"
--><!--#include virtual="include/top.html" -->
Сервер не поддерживает работу с указанным типом данных.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Неподржана врста медија!"
--><!--#include virtual="include/top.html" -->
Сервер не подржава врсту медија пренесену у захтеву.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Mediatypen stöds ej!"
--><!--#include virtual="include/top.html" -->
Servern stödjer inte den mediatyp som skickats i förfrågan.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Desteklenmeyen ortam türü!"
--><!--#include virtual="include/top.html" -->
Sunucu, istekte belirtilen ortam türünü desteklemiyor.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="不支持的媒体类型！"
--><!--#include virtual="include/top.html" -->
服务器不支持请求中传输的媒体类型。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="不支持的媒體型式！"
--><!--#include virtual="include/top.html" -->
伺服器不支持請求中傳輸的媒體型式。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/error/HTTP_UNAUTHORIZED.html.var 0000664 0001751 0001751 00000040656 13317763731 021166 0 ustar covener covener Content-language: cs
Content-type: text/html; charset=UTF-8
Body:----------cs--
<!--#set var="CONTENT_LANGUAGE" value="cs"
--><!--#set var="TITLE" value="Požadována autentizace!"
--><!--#include virtual="include/top.html" -->
Server nemohl ověřit, že jste autorizován(a) k přístupu
k URL "<!--#echo encoding="url" var="REDIRECT_URL" -->".
Buď jste dodal(a) neplatné pověření (např. chybné heslo) nebo Váš
prohlížeč neumí dodat požadované ověření.
<!--#include virtual="include/spacer.html" -->
V případě, že smíte požadovat tento dokument, zkontrolujte, prosím,
Vaši uživatelskou identifikaci a heslo a zkuste to znovu.
<!--#include virtual="include/bottom.html" -->
----------cs--
Content-language: de
Content-type: text/html; charset=UTF-8
Body:----------de--
<!--#set var="CONTENT_LANGUAGE" value="de"
--><!--#set var="TITLE" value="Authentisierung fehlgeschlagen!"
--><!--#include virtual="include/top.html" -->
Der Server konnte nicht verifizieren, ob Sie autorisiert sind,
auf den URL "<!--#echo encoding="url" var="REDIRECT_URL"-->" zuzugreifen.
Entweder wurden falsche Referenzen (z.B. ein falsches Passwort)
angegeben oder ihr Browser versteht nicht, wie die geforderten
Referenzen zu übermitteln sind.
<!--#include virtual="include/spacer.html" -->
Sofern Sie für den Zugriff berechtigt sind, überprüfen
Sie bitte die eingegebene User-ID und das Passwort und versuchen Sie
es erneut.
<!--#include virtual="include/bottom.html" -->
----------de--
Content-language: en
Content-type: text/html; charset=UTF-8
Body:----------en--
<!--#set var="TITLE" value="Authentication required!"
--><!--#include virtual="include/top.html" -->
This server could not verify that you are authorized to access
the URL "<!--#echo encoding="url" var="REDIRECT_URL" -->".
You either supplied the wrong credentials (e.g., bad password), or your
browser doesn't understand how to supply the credentials required.
<!--#include virtual="include/spacer.html" -->
In case you are allowed to request the document, please
check your user-id and password and try again.
<!--#include virtual="include/bottom.html" -->
----------en--
Content-language: es
Content-type: text/html
Body:----------es--
<!--#set var="TITLE" value="¡Autentificación requerida!" -->
<!--#include virtual="include/top.html" -->
El servidor no puede certificar que usted esté autorizado
para acceder a la URL "<!--#echo encoding="url" var="REDIRECT_URL" -->".
Ha podido suministrar información incorrecta (ej.
contraseña no válida) o el navegador no sabe
cómo suministrar la información requerida.
<!--#include virtual="include/spacer.html" -->
En caso de que usted tenga permiso para acceder al documento,
por favor verifique su nombre de usuario y contraseña y
vuélvalo a intentar.
<!--#include virtual="include/bottom.html" -->
----------es--
Content-language: fr
Content-type: text/html; charset=UTF-8
Body:----------fr--
<!--#set var="CONTENT_LANGUAGE" value="fr"
--><!--#set var="TITLE" value="Autorisation requise!"
--><!--#include virtual="include/top.html" -->
Ce server n'a pas été en mesure de vérifier que
vous êtes autorisé à accéder à cette
URL "<!--#echo encoding="url" var="REDIRECT_URL" -->".
Vous avez ou bien fourni des coordonnées erronées
(p.ex. mot de passe inexact) ou bien votre navigateur ne parvient
pas à fournir les données exactes.
<!--#include virtual="include/spacer.html" -->
Si vous êtes autorisé à requérir le document,
veuillez vérifier votre nom d'utilisateur et votre mot de passe
et réessayer.
<!--#include virtual="include/bottom.html" -->
----------fr--
Content-language: ga
Content-type: text/html; charset=UTF-8
Body:----------ga--
<!--#set var="TITLE" value="Is gá fíordheimhniú!"
--><!--#include virtual="include/top.html" -->
Níorbh fhéidir leis an freastalaí a dheimhniú
go bhfuil an údaráis agat rochtain a dheanamh ar an URL
"<!--#echo encoding="url" var="REDIRECT_URL" -->". Is féidir go
soláthair tú faisnéis mícheart (m.s.,
pasfhocail mícheart), nó nach dtuigeann do chuid
brabhsálaí conas an faisnéis is gá a
soláthair i gceart.
<!--#include virtual="include/spacer.html" -->
Más é gur ceart go mbhéadh cead agat iarratais a
dheanamh don doiciméid, deimhnigh go bhfuil do chuid ainm
úsáideora agus pasfhocal i gceart, agus dean iarracht eile,
le do thoil.
<!--#include virtual="include/bottom.html" -->
----------ga--
Content-language: it
Content-type: text/html; charset=UTF-8
Body:----------it--
<!--#set var="CONTENT_LANGUAGE" value="it"
--><!--#set var="TITLE" value="Autorizzazione necessaria!"
--><!--#include virtual="include/top.html" -->
Questo server non può verificare l'autorizzazione
all'accesso a "<!--#echo encoding="url" var="REDIRECT_URL" -->".
Questo errore potrebbe essere causato da credenziali errate
(nome utente o password errata) oppure da un browser che non
riesce a comunicare il nome utente e la password in modo corretto.
<!--#include virtual="include/spacer.html" -->
Nel caso in cui ritieni di aver diritto ad accedere al documento,
controlla il nome utente e la password forniti e riprova.
<!--#include virtual="include/bottom.html" -->
----------it--
Content-language: ja
Content-type: text/html; charset=UTF-8
Body:----------ja--
<!--#set var="CONTENT_LANGUAGE" value="ja"
--><!--#set var="TITLE" value="Authentication required!"
--><!--#include virtual="include/top.html" -->
URL "<!--#echo encoding="url" var="REDIRECT_URL" -->"
へのアクセス権限があることを確認できませんでした。
間違った資格情報 (例えば、誤ったパスワード) を入力したか、
ブラウザが必要な資格情報を送信する方法を理解していないかです。
<!--#include virtual="include/spacer.html" -->
ドキュメントを要求できる筈である場合は、
ユーザ ID とパスワードを再確認して下さい。
<!--#include virtual="include/bottom.html" -->
----------ja--
Content-language: ko
Content-type: text/html; charset=UTF-8
Body:----------ko--
<!--#set var="CONTENT_LANGUAGE" value="ko"
--><!--#set var="TITLE" value="인증 필요!"
--><!--#include virtual="include/top.html" -->
이 서버가 "<!--#echo encoding="url" var="REDIRECT_URL" -->" URL을
접근할 수 있는 권한이 있는지 확인하지 못했습니다.
잘못된 인증 정보(가령, 잘못된 암호)를 보냈거나 아니면
사용하시는 브라우저가 필요한 인증 정보를 어떻게 보내는지 모르는 것입니다.
<!--#include virtual="include/spacer.html" -->
이 문서를 사용할 수 있도록 허가를 받았는데도 이런다면,
사용자 ID와 암호를 확인하시고 다시 시도하시기 바랍니다.
<!--#include virtual="include/bottom.html" -->
----------ko--
Content-language: nl
Content-type: text/html; charset=UTF-8
Body:----------nl--
<!--#set var="CONTENT_LANGUAGE" value="nl"
--><!--#set var="TITLE" value="Authenticatie nodig!"
--><!--#include virtual="include/top.html" -->
De server kon niet controleren of u gemachtigd bent om toegang te krijgen
tot de URL "<!--#echo encoding="url" var="REDIRECT_URL" -->".
U hebt zich onvoldoende geauthenticeerd ( vb : verkeerd paswoord ), of
uw browser is niet in staat de nodige authentificatiegegevens door te geven.
<!--#include virtual="include/spacer.html" -->
Indien u toch gemachtigd bent toegang te krijgen tot het document,
controleer uw gebruikersnaam en paswoord en probeer opnieuw.
<!--#include virtual="include/bottom.html" -->
----------nl--
Content-language: nb
Content-type: text/html; charset=UTF-8
Body:----------nb--
<!--#set var="CONTENT_LANGUAGE" value="nb"
--><!--#set var="TITLE" value="Autentisering kreves!"
--><!--#include virtual="include/top.html" -->
Serveren kunne ikke verifisere at du har tillatelse til å besøke
adressen "<!--#echo encoding="url" var="REDIRECT_URL" -->". Enten
oppga du feil opplysninger (f.eks. feil passord) eller så støtter
ikke din nettleser dette autentiseringsystemet.
<!--#include virtual="include/spacer.html" -->
Om du har tillatelse til å besøke siden, vennligst kontroler ditt
brukernavn og passord og forsøk igjen.
<!--#include virtual="include/bottom.html" -->
----------nb--
Content-language: pl
Content-type: text/html; charset=UTF-8
Body:----------pl--
<!--#set var="CONTENT_LANGUAGE" value="pl"
--><!--#set var="TITLE" value="Wymagana autoryzacja!"
--><!--#include virtual="include/top.html" -->
Serwer nie może zweryfikować, że masz uprawnienia dostępu do
URL-a "<!--#echo encoding="url" var="REDIRECT_URL" -->".
Nie podałeś prawidłowych danych autoryzacyjnych (np. hasła)
lub twoja przeglądarka nie potrafi ich przesłać.
<!--#include virtual="include/spacer.html" -->
Jeśli masz prawo dostępu do żądanego dokumentu, sprawdź
podaną nazwę użytkownika i hasło.
<!--#include virtual="include/bottom.html" -->
----------pl--
Content-language: pt-br
Content-type: text/html; charset=UTF-8
Body:-------pt-br--
<!--#set var="CONTENT_LANGUAGE" value="pt-br"
--><!--#set var="TITLE" value="Autenticação Requerida!"
--><!--#include virtual="include/top.html" -->
Este servidor não pode autorizar o seu acesso à URL
"<!--#echo encoding="url" var="REDIRECT_URL" -->".
Você deve ter fornecido dados incorretos (ex. senha errada), ou o seu
"browser" não fornece as credenciais necessárias.
<!--#include virtual="include/spacer.html" -->
No caso de você realmente possuir permissão para este documento,
por favor checar seu login e sua senha e tentar novamente.
<!--#include virtual="include/bottom.html" -->
-------pt-br--
Content-language: pt
Content-type: text/html; charset=ISO-8859-1
Body:----------pt--
<!--#set var="TITLE" value="Autenticação exigida!"
--><!--#include virtual="include/top.html" -->
Este servidor não conseguiu validar a sua autoridade para aceder
ao URL "<!--#echo encoding="url" var="REDIRECT_URL" -->".
Ou forneceu as credenciais erradas (e.g.: senha incorrecta)
ou o seu <i>browser</i> não sabe como fornecer as credenciais
necessárias.
<!--#include virtual="include/spacer.html" -->
Caso lhe seja permitido aceder ao documento, por favor verifique o
seu nome de utilizador e senha e tente de novo.
<!--#include virtual="include/bottom.html" -->
----------pt--
Content-language: ro
Content-type: text/html; charset=UTF-8
Body:----------ro--
<!--#set var="CONTENT_LANGUAGE" value="ro"
--><!--#set var="TITLE" value="Autentificare necesara!"
--><!--#include virtual="include/top.html" -->
Acest server nu a putut verifica daca sunteti autorizat sa accesati
URL-ul "<!--#echo encoding="url" var="REDIRECT_URL" -->".
Ati furnizat parametrii de acreditare gresiti (ex: parola gresita), sau browserul
dumneavoastra nu poate furniza aceste detalii de acreditare.
<!--#include virtual="include/spacer.html" -->
In cazul in care nu va este permis sa cereti un document, va rugam
sa va verificati numele de utilizator si parola si sa incercati din nou.
<!--#include virtual="include/bottom.html" -->
----------ro--
Content-language: ru
Content-type: text/html; charset=UTF-8
Body:----------ru--
<!--#set var="TITLE" value="Необходима аутентификация!"
--><!--#include virtual="include/top.html" -->
Сервер не смог проверить данные аутентификации
на доступ к "<!--#echo encoding="url" var="REDIRECT_URL" -->".
Вы предоставили неверные учётные данные (например: пароль), или Ваш
браузер не знает, как их предоставить.
<!--#include virtual="include/spacer.html" -->
Если Вам разрешено запрашивать данный документ, пожалуйста,
проверьте свои учётные данные и повторите запрос.
<!--#include virtual="include/bottom.html" -->
----------ru--
Content-language: sr
Content-type: text/html; charset=UTF-8
Body:----------sr--
<!--#set var="CONTENT_LANGUAGE" value="sr"
--><!--#set var="TITLE" value="Обавезна аутентификација!"
--><!--#include virtual="include/top.html" -->
Овај сервер није могао да потврди да сте овлашћени да приступите
УРЛ-у "<!--#echo encoding="url" var="REDIRECT_URL" -->".
Могуће је или да сте навели погрешне личне податке (нпр. нетачну лозинку), или да
ваш читач не разуме како да пошаље захтеване личне податке.
<!--#include virtual="include/spacer.html" -->
Уколико вам је дозвољено да преузимате документ, молимо да
проверите своје корисничко име и лозинку и пробате поново.
<!--#include virtual="include/bottom.html" -->
----------sr--
Content-language: sv
Content-type: text/html; charset=UTF-8
Body:----------sv--
<!--#set var="CONTENT_LANGUAGE" value="sv"
--><!--#set var="TITLE" value="Autentisering krävs!"
--><!--#include virtual="include/top.html" -->
Servern kunde inte verifiera att du har tillåtelse att besöka
adressen "<!--#echo encoding="url" var="REDIRECT_URL" -->".
Antingen angav du felaktiga uppgifter (ex. fel lösenord) eller så
stödjer inte din webbläsare detta autentiseringssätt.
<!--#include virtual="include/spacer.html" -->
Om du har tillåtelse att besöka sidan, vänligen kontrollera ditt
användarnamn samt lösenord och försök igen.
<!--#include virtual="include/bottom.html" -->
----------sv--
Content-language: tr
Content-type: text/html; charset=UTF-8
Body:----------tr--
<!--#set var="CONTENT_LANGUAGE" value="tr"
--><!--#set var="TITLE" value="Kimlik doğrulama gerekli!"
--><!--#include virtual="include/top.html" -->
Sunucu "<!--#echo encoding="url" var="REDIRECT_URL" -->" adresine erişim
izninizi doğrulayamadı. Ya sağladığınız kanıtlar yanlış (yanlış parola gibi)
ya da tarayıcınız bu kanıtların nasıl sağlanacağını bilmiyor.
<!--#include virtual="include/spacer.html" -->
Eğer erişim izniniz olduğuna eminseniz, lütfen kullanıcı adınızı
ve parolanızı gözden geçirip yeniden deneyin.
<!--#include virtual="include/bottom.html" -->
----------tr--
Content-language: zh-cn
Content-type: text/html; charset=UTF-8
Body:----------zh-cn--
<!--#set var="CONTENT_LANGUAGE" value="zh-cn"
--><!--#set var="TITLE" value="需要认证！"
--><!--#include virtual="include/top.html" -->
此服务器无法验证您是否有权访问 URL "<!--#echo encoding="url" var="REDIRECT_URL" -->"。
原因可能是您提供了错误的凭据（例如，错误的密码），或您的浏览器不知道如何提供所需的凭据。
<!--#include virtual="include/spacer.html" -->
如果您有权访问该文档，请检查您的用户名和密码并重试。
<!--#include virtual="include/bottom.html" -->
----------zh-cn--
Content-language: zh-tw
Content-type: text/html; charset=UTF-8
Body:----------zh-tw--
<!--#set var="CONTENT_LANGUAGE" value="zh-tw"
--><!--#set var="TITLE" value="需要認證！"
--><!--#include virtual="include/top.html" -->
此伺服器無法驗證您是否有權訪問 URL "<!--#echo encoding="url" var="REDIRECT_URL" -->"。
原因可能是您提供了錯誤的憑據（例如，錯誤的密碼），或您的瀏覽器不知道如何提供所需的憑據。
<!--#include virtual="include/spacer.html" -->
如果您有權訪問該文檔，請檢查您的使用者名和密碼並重試。
<!--#include virtual="include/bottom.html" -->
----------zh-tw--
httpd-2.4.64/docs/icons/ 0000775 0001751 0001751 00000000000 15032766613 014676 5 ustar covener covener httpd-2.4.64/docs/icons/pie7.png 0000664 0001751 0001751 00000000423 10671421551 016240 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H HIDAT[u̡0W"R*h" *1`Vn ȯMG-YigIU+C?6a]3E! VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/movie.png 0000664 0001751 0001751 00000000420 10671421551 016510 0 ustar covener covener PNG
IHDR 2o5 PLTE̙fff333 A tRNS 0J bKGD H 9IDAT[cHDA$50K)t63-ؘ-
,
f*2P P
A e4 U VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/tar.png 0000664 0001751 0001751 00000000405 10671421551 016162 0 ustar covener covener PNG
IHDR 2o5 PLTEVVU777 ١@ YIDAT[m
NAX?S$/s2A U"e+FD9 | g L*Po`n_UOjl LtEXtcomment This icon is in the public domain. 1995 Kevin Hughes, kevinh@eit.comy' IENDB` httpd-2.4.64/docs/icons/back.png 0000664 0001751 0001751 00000000464 10671421551 016301 0 ustar covener covener PNG
IHDR 2o5 PLTEfff333 tRNS 0J bKGD H `IDAT[E 0EQW .R^(qUڗD# .~ Ӑ
TE6\ECI?M
J[[8y-{>dŘO.&l VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/binary.png 0000664 0001751 0001751 00000000466 10671421551 016667 0 ustar covener covener PNG
IHDR 2o5 PLTE̙333 tRNS 0J bKGD H bIDAT[u 0 D @&} v *Qdq BU
#7vAqL2Sk-D2
ex v_p u; 5ٓʘ|!v VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/script.png 0000664 0001751 0001751 00000000442 10671421551 016701 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H QIDAT[ 1l!\ _yQy b 3c!**1dӲ'+ޯ{$[/<=Ү< VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/folder.open.png 0000664 0001751 0001751 00000000514 10671421551 017610 0 ustar covener covener PNG
IHDR d PLTE̙f3333 n tRNS
A bKGD H tIDATWϽ `W8'#:*GHyT<lvHY_fF솼\ zyK ( 6Y:s*dMOJp Q>8p VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/sound1.png 0000664 0001751 0001751 00000000513 10664777241 016621 0 ustar covener covener PNG
IHDR 2o5 PLTE33̙f 333 / tRNS
A bKGD H pIDAT En@u="zOo$b4G 7Vѳ!-ځ>0l ,Ap2a<}Q)סVU쮡ftU'fX VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/image1.gif 0000664 0001751 0001751 00000000422 10147723030 016512 0 ustar covener covener GIF89a 3ff̙f 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , mpI)5W$:BGZ/ M Pxs`d^z@Al6/4ifԮ3:m5WrmsX]nzT@CC5* ; httpd-2.4.64/docs/icons/icon.sheet.png 0000664 0001751 0001751 00000021472 10664777241 017456 0 ustar covener covener PNG
IHDR d `PLTE̙3ff33̙3f3f fffffff3f UUU333 3 f f3 3f B tRNS KF bKGD H "IDATx흍b6I-%{,sy@I &y'm B1` U S/1@A/X@YE;}~}fvsi u}slp '(HN %ة?1#w+4~]:0[X)ڭ]&;:M 9ﭗKC[lyX;y;< k-RnMHǏk@v)?wKT:{«&ְl!;'OekR fvw24`RTwL
zN4)* .e6^<$<!x ZV4%sRJt˿Gqiovn
vyv~굙l4ḧ́I)FҗӃ& `IWv0U~2+YXD 0 ` # n` 3FZlh ryom̖ :Q7\*+"r;6,ɭ|p`| r.*c&n1܂j/`uٹw, L$TGT
p`Yn{_lTUՇ3 I `X̀Si +`Sr `v}?|>~>~5KM\^j;7 6
Fx|BdN_֯yn (jVo߶(w
]
BjD/W;.N]*pQ4XAK$ W`7#]6W
e7
/ O}L ח ̿DL`>j _cus3ѳw-j *+7~fP{{Tq)5sEh${);֢ٹ|?δu,(̢>} 7B)&|Ǥ}
ŧO9!)U{~XE~&
1AJi +7'<=c<~c_< ` # ` # F 0 F 0;s1Ttr2.-|ٹ}ͪ,5G"2z.n
xhwr % -C048z
#|#kZrs}W e78([H Z0/\L7 qDb2Lڪl5s-gd~5+4{;oIZcy[%[
pAiVx`b
8=:`ОPBOq~;{Y}U' B6Q0/,
GM=6,|fc'
Io +YXD 0 ` # qx`v ,5owg1cuCaW(Q63viӱ"!" |+ >w9 ލK%o/R*^?m:Ϯ/?~ i~hXM[Fw¢\Mw@Hn(lJ?_\_d%cսhnՋ :W vw3 `F2xZ n&F́n_}Zojw+3< Wv{E?vb]?0_ap { .\ qB?Eh!q8`U{- ػǧf|5)9XZ>&l:sj k.L%GָGSIH_o)'pa_IRoSjebh$Hsg$\ATaܫZ L&+vk>MN]WUW60*떒 Y8#nXGovQpG?CY.${\i?3oQUQʛ4+_K_<W<ArGcy?%W(G~p{/.?)8V!_G)C3KJսszp&6eǪ [0 F 0 ` F 0 ` # ` # q,`{~DZs{GN| W1M
f;`4#b F1;7gb^Qpj)ck ?g⋚i!W&i8.AR.Ͽ:`:w hVk~u']mrkAD9j8n 0'72d kjv'u_x% ^ˍ 6@2w_wnV
bk!31/t^6 s}+mݕ hLr]G)[ט]8es9]dTTv{?}#_H~
i=W{@J +YXB 0 ` # QKO=<pa=x'"L{{Q8 \{x,/n =T5['gxR'-t ]cgZ
AR^ V"(>bN|[S)
7ƻb wa3Y6}c8Y "e d/5R?>7)a d
\!F$|*= 0-sEIwm[ |Lᥚo{"/3 pՓ 'Yr nH vzL'{o2²I=*{d pV /L
}|t[ \NC"+-[hM@X2\#}o^ xqj&`;\+olsU6߇Tp=Oj& BvN{A7
1xk1.XuTKY9|c</*qUpL/րUY>/<sx LR^Y%;DžyiHsyzL/ aCM e5 ` # F 0 # F 0 F 0 0ˋPe* 8vDk\f ()EڤW{IY~ţQiY4لDQ`f/@nҶF=f;4ѝyϓf%~ n=#7>yʧrdiP<UlLڋI]>I ZUYa܈ōڍ=8R G 1`n wyЦ\ܨp+7u 7ƹWryÎ 7bvZu &+x+V'ríIGUI[ Ua./ޯ;$ Q1_`'\6~tX[^ 'k_܉3^Tߴ SZtvb2M;}/Iw -ܞs_|!iJb% K F 0 ` AٸCЮd9F vX1EZ >sq۞5` 0p 8 #*
x*9!` pa 1k"
0m(Cyzy * SD%EO`o+bw$`,1A
Rp#g;oSRlH!N> |?X5Jp'^ԣwo ,0ݡz=sjڡpU5K4%@]E3Q!0ݞ^۷q9 0%@= XyLl *ol#c$ܷ,yoMRƔ`ۈXؘܐN|
%ޢ 10
_dW{Oxx<R܁g;0l?xzqp
nkN֛t7jq|~q=agB: G4Xe)q#&MJ?c=db ?D+Y
`НhusҺՒnjZp PSlqN'zsD B/~l 0 ` # ` # F 0 # F 0bG 5# 1`g0i۲ۛ_(dcg{ns&}$֨
sM1KqX|n
>7 nxge";ąY_V0oN
GjڜPbSRUk\Z
Ӓ3-LwF|Icv]O)Gy䲚[y.mKfB9d/B9`"5쮦
^x{ +Ī`˫`Zm#`OG%;6u|/1-- +x {*ߍ|s #/e f{4Y|/M'A훚R4g-ۿs9WQ9 )J* ` # 53jBӮjov+ gUVKGfv3{}pmv; C
Dy>0\)kۏa+B(iK W˯KJ݅ ؗwp s`V'
M\]~p-ʕ wX jJ ݮp/H XX!$y 7% `nK _ܾAQZ [Ā}.vSom\.?7o*A ؈ )x1WGp!MܪeRJw B\ٗhv|] n͡Lj6`B
p]߮R76vĐ\ `BGB
/vJxF_gKb-rOΎGX:=>h `$|1g$k3o %EUR{L%++%o}Wzu1
.t"~ݠ*С`
S=&)*a]<< 慎*XaCsnr,o
V|\Xץ:,tp5KE:3jBӮ
]xC\Msܟڃ ` # F 0 # F 0 F 0 x4`{G7giWg+
~2# ";6WxYi54 ^)o5 -\M%73rM [ي9tl-w2q^~.ÈKGr+%^XyL}n[n]y)WZC&tD[E[Eg gi[@g#
\Y#3>ϖ4}b2<_'k\C 9-Fc\da F 0 oA )`Cp!SDuA n0?9`p`CP$r%A'\a e{p1rs܅\?-M}A_E \R1 u 0wu
v17Ź~?Ɛ 6f u
@;6,>iYu``d ~>}X1|WD+ 6>0,z ؔLrJVQŜ~%ܲ+Y9:r}\Ztn܅Cu&1Wif?p>r #J 0 # F 0 F 0 ` 0 ` #鴦?yS/hW O7wo.]X *r{ZO ."aVXxOlhx 491T ;y2*IYU0/t}|V֮WYB0Ԑ Q۲BFBW yW`
Dh'b!(l70ħl}
h>c)8uWIh՛ ~]o0ef ¿c3TA2͈q?:wAi$bO# ̓6_y7}#]>J # F 0qo]_Agw5~M}vf־(rŰwoꕾVXҷn T﵍JntOo+ &
ߴ{$='Ĵ,U[ wx[""||mjyW*[l<|Ep D]|-VNBлD
ЧSޒzmX\᠂%JfiBr[R;chW SXX*iB
$ *Tl*8 J'J$KVeoaM;
c /Ud(K.U
1`ed9co(fKtt| k e77%]/ц
j86(`
[!`w6peM9$FmuHv6`V } `l倷5;? {oQjFn_|jWfdp ` # F 0 F 0 ` F 0 `D LອB) A>oI?^1̡a':I0^y_ce \M&$_}n^9O4O Ls"=4 /ަ+ BomJ$l^)Tktw7Q/ ́=qLcGs8Sj;6Yq%8#1XA.WGr\F
- lBMc^<ߠ /;|w~m1gGSOn|G*ӜM=|\Rӎ
$H; ;!&O da F 0 o+gw&>˯vULsI"K X8V;85.?):2 `ŶG;9 ~Vv4ΚB 0^H 9V`31<q.qOnv QK
x{_ռ^.5) Bgy2īoZ*X9gv{VP^.~ͫ?Vը[;7rcGsiɳQl`?;N ~յ`ӭƙ6r#gs Xl`ߘoܴvL `v
7̥} @W=
^:mK [x6QoHHb's :+ <߿%W;qރ=sCYE@]$]<K6)+XGynȭ`͜duPrsiԦ_Mdol;yU'-^9Ll4I `x<Kdj'd)+xChc2?4q̢w%
xEQ aR|e x}n / Whi`X -qk
x+#, Q\~|2c't ̇o<)\~8B 0 ` # ` # F 0 # F 0 `Zuqd~y/UK+F-,4. N'EG
H" `
i%<y:0z^A紒ep4~^R08Lm+<%j-`/[^ QFgQZP<]fo?T&WH<"l-Ox8|
7*F*8<-L yfѴ`d2(ݍj6w&__^ރ?{7WQ&>sכOW z؋ P nbH[z; ]G +Y F 0 # F 0a܅͙,t .ܡ]Ͷ^O%X`qJ WE ` ?R a!26Dt]Ox 0{3](,un-ھ
owbd><EA]`A]N
p[ Kf;v،$ o ^cqxd >?ќ4P3֗owv/3NR#4R*LtP{&ǵG~>??O#; 15s
6 0 o
r
l4i`;\[ _|>o% ,IDB,xe}V |Yė
Xo7a5<V | k43vO |V9o*i Kĺ"wpy/ \u0ɪ{ۢ ܅2ºvb96) j`JC]9]vU9pm< Tͱ ߳,U#~6T1Ækwm i-Zh]q'-q{ `B>Чr q3: `q7"P7? VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/forward.gif 0000664 0001751 0001751 00000000333 10147723030 017014 0 ustar covener covener GIF89a fff333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , N\DԅAiQyNS/EH`m+}Cdq03
U O)lwk%ˊ3 ; httpd-2.4.64/docs/icons/c.png 0000664 0001751 0001751 00000000453 10671421551 015621 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H ZIDAT[
@@V@ PDgKSu3 'R\bYIQ/Inznt ٞƈ]\(_ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/a.png 0000664 0001751 0001751 00000000462 10671421551 015617 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H aIDAT[E ! DKtXRX"Mu233hq.]sni=Qx7mb R~ uhK'j:F`)u~~ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/generic.gif 0000664 0001751 0001751 00000000335 10147723030 016766 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , P80 @#i;U"(1RDmL K:K
|9㑨 e,Q)vL/q+ym% ; httpd-2.4.64/docs/icons/text.gif 0000664 0001751 0001751 00000000345 10147723030 016337 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , X80 @#i;U"qDR'
n Jn( <:{PټVEnY2~Oڍ ; httpd-2.4.64/docs/icons/burst.gif 0000664 0001751 0001751 00000000353 10147723030 016511 0 ustar covener covener GIF89a 3f fff333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , ^(0ʩ lll7\'4kuB5'P cRHS6LA| م ٪3 ; httpd-2.4.64/docs/icons/sphere1.png 0000664 0001751 0001751 00000000533 10671421551 016745 0 ustar covener covener PNG
IHDR 2o5 PLTE33̙f 333 IĄ tRNS @* bKGD H |IDAT[u1
0 @ \
8:P2JQrlKS a[ɐy
mU&0(
R);'&\ %! ŘxjyA=g/Wm33/ lq VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/unknown.png 0000664 0001751 0001751 00000000463 10671421551 017077 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H bIDAT[m
\
a `!hzBj)!xŘ^騔z5n'2[{ fߔ2.F,biz;Yӈ :F^U.+ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/hand.up.png 0000664 0001751 0001751 00000000460 10671421551 016732 0 ustar covener covener PNG
IHDR 2o5 PLTE̙f3 $( tRNS
A bKGD H ^IDAT[ 0Ьp$.`?S5~կǡmִ/x\Vt+mPIsA-Þ^ɘ!ÛxȩƊlS87V x VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/sound2.gif 0000664 0001751 0001751 00000000335 10147723030 016564 0 ustar covener covener GIF89a ̙fff333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , PH-tYC$!zP(
WɝE zU[4J쯀1T/g O9T7A3n}7 њaʌp^$ ; httpd-2.4.64/docs/icons/small/ 0000775 0001751 0001751 00000000000 15032766613 016006 5 ustar covener covener httpd-2.4.64/docs/icons/small/compressed.gif 0000664 0001751 0001751 00000000200 10147723030 020615 0 ustar covener covener GIF89a kkkZZkJ ! , E8 .)bԮ9&^)B|U}JAt #D #-v
x$zQa@]E ; httpd-2.4.64/docs/icons/small/image2.gif 0000664 0001751 0001751 00000000212 10147723030 017620 0 ustar covener covener GIF89a RR {! {RRZ ! , Oܾ@Z
uQB
wFQ N- X"ʡGt@ if[hzL ; httpd-2.4.64/docs/icons/small/comp1.gif 0000664 0001751 0001751 00000000202 10147723030 017472 0 ustar covener covener GIF89a )!Zcc9s ! , G(0@%xf GTTj)pP3 C@,1qT:Ђ4KQK`G8 ` ; httpd-2.4.64/docs/icons/small/comp2.gif 0000664 0001751 0001751 00000000203 10147723030 017474 0 ustar covener covener GIF89a RZZs ! , HH06Q-o`9VtaEACZ
0pċeR:IR4:0Epx\L ; httpd-2.4.64/docs/icons/small/sound.gif 0000664 0001751 0001751 00000000202 10147723030 017603 0 ustar covener covener GIF89a sss֜ 9JJ ! , G(p1[;D
` W@ DPo v ͗cz7a ,F`
AQX ; httpd-2.4.64/docs/icons/small/ps.gif 0000664 0001751 0001751 00000000270 10147723030 017102 0 ustar covener covener GIF89a 999kkk ! ! by Martin.Kraemer@Mch.SNI.De , 999kkk ExG 0 HH-F`M)TY?8-W@$v)kFKc zE ; httpd-2.4.64/docs/icons/small/movie.gif 0000664 0001751 0001751 00000000206 10147723030 017576 0 ustar covener covener GIF89a 999kkk ! , KHL/I# ;^i "D
(RX$رx&У^GY)
i+NW
J ; httpd-2.4.64/docs/icons/small/tar.gif 0000664 0001751 0001751 00000000204 10147723030 017243 0 ustar covener covener GIF89a 999kkk ! , IHܾ@k1
Zw^QU3 2;/3
Sq G)6Îv*6x<- ; httpd-2.4.64/docs/icons/small/burst.gif 0000664 0001751 0001751 00000000200 10147723030 017610 0 ustar covener covener GIF89a )!ZJ9JJR ! , E0¢Dh0CR,)oUa Kׂ2lQ[fL,)* +t P)G ; httpd-2.4.64/docs/icons/small/folder2.png 0000664 0001751 0001751 00000000264 10664777241 020060 0 ustar covener covener PNG
IHDR R PLTEkcs9!sJƭsk 9rar tRNS @f bKGDaf} =IDATc` 08 &..Ά &B`G À4 :3\4 IENDB` httpd-2.4.64/docs/icons/small/generic2.png 0000664 0001751 0001751 00000000263 10664777241 020220 0 ustar covener covener PNG
IHDR R PLTEkkkZZkJ :A tRNS @* bKGDa 9IDATc06R6cWcaÀŕ `2 PQ(``a(&((hl &en IENDB` httpd-2.4.64/docs/icons/small/generic3.png 0000664 0001751 0001751 00000000253 10664777241 020220 0 ustar covener covener PNG
IHDR R PLTEkkkZZkJ ! tRNS 0J bKGDo 3IDATc% `1` a(@*0
L6L. IENDB` httpd-2.4.64/docs/icons/small/sound2.png 0000664 0001751 0001751 00000000253 10664777241 017733 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 VIDATe !m
EQAjAx8ˠ}!ZU`;τ #,w W G"uY
wj#k IENDB` httpd-2.4.64/docs/icons/small/doc.png 0000664 0001751 0001751 00000000336 10664777241 017270 0 ustar covener covener PNG
IHDR 7 bKGD ̿ gIDAT(ϝ
!Di˚lek
A8w!s C(0 =} z & ZeZ= <f. zu;aAZSMv] $tEXtcomment by Martin.Kraemer@Mch.SNI.Deh# IENDB` httpd-2.4.64/docs/icons/small/rainbow.png 0000664 0001751 0001751 00000004573 10664777241 020173 0 ustar covener covener PNG
IHDR / e PLTE pp ( (( 0 H H HH X X X X hh ( xx h h @ @ @@ 8 8 8 `` ` ` P PP P 8 0 0 0 p px x IDATXí[G0 BEr((ժXRT$Z4
|gvwfw{cwo5HHKKg hʷ.T&F}髠ר/iPj:JmAuC-(6 P@[R41=:ht5: *,ϡ^#Hd5 ] JT4zx>00p Br\j 4W*q%:jXn,˷Q^'PS,{zjhhH4$eT ht<L&_5O?kG z@:ABp511'jԺ:
]W 0k˛5geyt 4<`f)ex9D^ `% fsd`P3F%`4. Lxup9"/S dq0.
fyyq`ʷyw^C^ b%Q
yq(`&% yqeDB 1&EĤa/
&"`h`B . sQ 0 C`~\N.y 0
fsvƵ )`:^JEsi<^ ^] 0 /
Flme`. L a`K'ø 0{ 0W40˚Fhi3p e8N } ^)
0G[ GC G HqeiA$ō@t\ѱHaHH
qk\l -Q U8dxY//L,f H eHHI/M_(_d @*X{QP !0:V188_^6E ū/:\9<HRBq #]`8yDqd nxbByqDp{b%_8t1 /Gy#]wn#/"n_yDEQ)
AE/L(* 摪9Qw"h`G_87BG2}̣I?2]<rK"ȣMݽc(/ xS%Buw։#w_D My#/*}ȣIh^Twl %_4/_ZDݝ8B/wŜF/rN(x9 ;w.vP%<A= ]_9S_4{KAs/
/_EIb9G`lr~jG'Gb i=2e/ K_l);//Uv
h5ĹṆVCą닳RnN^ | +p>:/2r6" Q_w9^rA Vݶ>vGO_Rlĩ)[>*zEnT`
9
/岳r>Jx[> #/v </_ }dɣѳ}"#/!sQbq
L+u{ͣy Y.wͣRD ]kT>/w}D}λ/CK(D>r#xOHw_vun}tTu ŽGkGEbÁ#wCHwλ{}/x}Tﻣ aN|W IENDB` httpd-2.4.64/docs/icons/small/binhex.png 0000664 0001751 0001751 00000000262 10664777241 017776 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 ]IDATu
Y+3e c
AB٢ŕVFQ2I g ynH>'$ 6 8jdOEXxeYr IENDB` httpd-2.4.64/docs/icons/small/image2.png 0000664 0001751 0001751 00000000313 10664777241 017662 0 ustar covener covener PNG
IHDR R PLTERR {! {RRZ v' tRNS 0J bKGDa SIDATcb000 0Pe0 `F@z !n fC.`X
c0 i ` IENDB` httpd-2.4.64/docs/icons/small/key.png 0000664 0001751 0001751 00000000322 10664777241 017306 0 ustar covener covener PNG
IHDR 7 bKGD ̿ [IDAT(c` G8 ?tѕ+ A z9m (
!4H48)p$cS L+R
l I R F7Ǜ $tEXtcomment by Martin.Kraemer@Mch.SNI.Deh# IENDB` httpd-2.4.64/docs/icons/small/comp2.png 0000664 0001751 0001751 00000000327 10664777241 017543 0 ustar covener covener PNG
IHDR R PLTERZZs k tRNS S bKGDa \IDATcp, P9DII%UR
3R40#Xؠ0
kcP(C0U6J E@;EAj\A . ⦔S IENDB` httpd-2.4.64/docs/icons/small/compressed.png 0000664 0001751 0001751 00000000324 10664777241 020664 0 ustar covener covener PNG
IHDR R PLTEkkkZZkJ :A tRNS @* bKGDa ZIDATc0ccC(ÀA`2! F !ld ,` f00 bs
[ W+ IENDB` httpd-2.4.64/docs/icons/small/generic.png 0000664 0001751 0001751 00000000225 10664777241 020134 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 @IDATc8` `py\9.K @@6)p'. .Ӡx1 IENDB` httpd-2.4.64/docs/icons/small/broken.png 0000664 0001751 0001751 00000000270 10664777241 020000 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 cIDAT]
!PkWH@
bpp27MO)8`Qaj $P
^]\)
͒g?[NĻA:Gcwa IENDB` httpd-2.4.64/docs/icons/small/folder.png 0000664 0001751 0001751 00000000304 10664777241 017771 0 ustar covener covener PNG
IHDR R PLTEޭܮ}WK;+% ~ M tRNS
A bKGDaf} KIDATmƱ
@P
(ְ Q`pG \%RV}aٙXa`b~#Xg(, IENDB` httpd-2.4.64/docs/icons/small/comp1.png 0000664 0001751 0001751 00000000330 10664777241 017534 0 ustar covener covener PNG
IHDR R PLTE)!Zcc9s )9J tRNS
A bKGDa _IDATcP, 0IPPptq*3҂ 4BCHM
MuRbH CUP(' 2_(RRXn NJ 2;s IENDB` httpd-2.4.64/docs/icons/small/sound.png 0000664 0001751 0001751 00000000305 10664777241 017647 0 ustar covener covener PNG
IHDR R PLTEsss֜ 9JJ V; tRNS
A bKGDa LIDATcPd
bb3*+1(
(1200be()A兌`JJbj`@a*ì@
ޗ IENDB` httpd-2.4.64/docs/icons/small/transfer.png 0000664 0001751 0001751 00000000323 10664777241 020343 0 ustar covener covener PNG
IHDR R PLTEkkkZZk &M^ tRNS @* bKGDa YIDATc0ccC(ÀA`2! F$a c`H1LC]\BP0 2DR Cab1D9 F ZK{0 IENDB` httpd-2.4.64/docs/icons/small/movie.png 0000664 0001751 0001751 00000000237 10664777241 017642 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 JIDATc8 @!z ,!,`
d %b0 b /=Pl _f IENDB` httpd-2.4.64/docs/icons/small/patch.png 0000664 0001751 0001751 00000000323 10664777241 017616 0 ustar covener covener PNG
IHDR : tRNS v8 bKGD ̿ NIDATӅ
CQՙg@xI tQ[̋(%'@2q43&/ބT`B $tEXtcomment by Martin.Kraemer@Mch.SNI.Deh# IENDB` httpd-2.4.64/docs/icons/small/tar.png 0000664 0001751 0001751 00000000255 10664777241 017311 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 XIDATӅ0Ee&o*ՒqF 3X:@< ؿp4#)E]2
wk;-=3Xf T*y>BHv IENDB` httpd-2.4.64/docs/icons/small/ps.png 0000664 0001751 0001751 00000000331 10664777241 017140 0 ustar covener covener PNG
IHDR 7 bKGD ̿ bIDAT(ϝ CY3cHk?xr|U
2( 0 p ;]6UNHS
@tI;@?I$a [u !k~ $tEXtcomment by Martin.Kraemer@Mch.SNI.Deh# IENDB` httpd-2.4.64/docs/icons/small/burst.png 0000664 0001751 0001751 00000000322 10664777241 017655 0 ustar covener covener PNG
IHDR R PLTE)!ZJ9JJR ϽQ tRNS @f bKGDaf} [IDATc`X\ Q CPRR6662p1JAC0Tk `p2@ $P0#QbK( =
1M IENDB` httpd-2.4.64/docs/icons/small/forward.png 0000664 0001751 0001751 00000000256 10664777241 020170 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 YIDAT]Q
@1UMRQS[c(*JM BS0T8U,D24q@5w
ˉ6sݥ]?Z-3̩ IENDB` httpd-2.4.64/docs/icons/small/index.png 0000664 0001751 0001751 00000000341 10664777241 017626 0 ustar covener covener PNG
IHDR R PLTE!!!ZZZ9B9 v3k tRNS S bKGDa fIDAT5A@0A9 }|46K-&A! `?b y#$@ua4kX[uƁhqbJŴ*$
IENDB` httpd-2.4.64/docs/icons/small/back.png 0000664 0001751 0001751 00000000265 10664777241 017424 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 `IDATӍ
PVapd(F+ ՞J( z "x+l@;=( @fS E*5 oѯ] IENDB` httpd-2.4.64/docs/icons/small/binary.png 0000664 0001751 0001751 00000000254 10664777241 020006 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 WIDATӍ
0ՙ
C1k0*t
K 1 X2`D
nGQ lx@u lPA'/}{Nm IENDB` httpd-2.4.64/docs/icons/small/unknown.png 0000664 0001751 0001751 00000000254 10664777241 020221 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 WIDATӅ Pr&Va(&AS z|q9eԠ6
*pK1p? %b 7E&A~ JǬ0 IENDB` httpd-2.4.64/docs/icons/small/image.png 0000664 0001751 0001751 00000000305 10664777241 017601 0 ustar covener covener PNG
IHDR R PLTEkkkZZc19 I. tRNS @* bKGDa KIDATc0aZ eCPFXa a( LPF1# f(C h@Ab 6 IENDB` httpd-2.4.64/docs/icons/small/blank.png 0000664 0001751 0001751 00000000144 10664777241 017607 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 IDATc8F
!
X IENDB` httpd-2.4.64/docs/icons/small/text.png 0000664 0001751 0001751 00000000243 10664777241 017504 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 NIDATӥQ
e& SP}0v;6Z.Bqu5Ewbna BO݅7OQ)8,!LI|: پ
IENDB` httpd-2.4.64/docs/icons/small/folder2.gif 0000664 0001751 0001751 00000000172 10653705265 020032 0 ustar covener covener GIF89a kcs9!sJƭsk ! , ?0J9U;A0`YY($yZ i@6Xn
cs,@XX+1 ; httpd-2.4.64/docs/icons/small/folder.gif 0000664 0001751 0001751 00000000204 10653705207 017740 0 ustar covener covener GIF89a ޭܮ}WK;+% ! , I(bΔ1Ѐ2v$GQAy6#v"_dE輞
t`$eP 8 ] n$ ; httpd-2.4.64/docs/icons/small/blank.gif 0000664 0001751 0001751 00000000067 10147723030 017553 0 ustar covener covener GIF89a ! , ڋ> ; httpd-2.4.64/docs/icons/small/uu.png 0000664 0001751 0001751 00000000246 10664777241 017154 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 QIDATӅ
0@ՙX52P_d ڀ! [ |V3 @t)WFSO'~ IENDB` httpd-2.4.64/docs/icons/small/binary.gif 0000664 0001751 0001751 00000000206 10147723030 017743 0 ustar covener covener GIF89a 999kkk ! , KHܾ@k1J'\WDlaDF!o pS``ŷ )7B<;BC",Y ; httpd-2.4.64/docs/icons/small/uu.gif 0000664 0001751 0001751 00000000175 10147723030 017115 0 ustar covener covener GIF89a 999kkk ! , BHܾ@k1J'\WDla4 p-pA/.|sX{ň<$&j(]R%ve- ; httpd-2.4.64/docs/icons/small/continued.png 0000664 0001751 0001751 00000000243 10664777241 020510 0 ustar covener covener PNG
IHDR : tRNS bKGD #2 NIDATӭA@ & *
bdlߗl op'dlM"[ٗO{lXV8Ta
91 T-Zk~'[&iWh IENDB` httpd-2.4.64/docs/icons/small/image.gif 0000664 0001751 0001751 00000000176 10147723030 017547 0 ustar covener covener GIF89a kkkZZc19 ! , C8<'
s(!xal o#LJ
0m@{іTzTp.˅@ ; httpd-2.4.64/docs/icons/small/continued.gif 0000664 0001751 0001751 00000000162 10147723030 020450 0 ustar covener covener GIF89a 999kkk ! , 7H0IY+5
E ]
ibp-HǓTi:G ; httpd-2.4.64/docs/icons/small/generic3.gif 0000664 0001751 0001751 00000000161 10147723030 020156 0 ustar covener covener GIF89a kkkZZkJ ! , 6!0BvqK'ADJ0"q4p' `l:g ; httpd-2.4.64/docs/icons/small/text.gif 0000664 0001751 0001751 00000000200 10147723030 017435 0 ustar covener covener GIF89a 999kkk ! , EHܾ@k1J'\WDLAjxFlPme , Z *oJI,No!α$zE ; httpd-2.4.64/docs/icons/small/generic2.gif 0000664 0001751 0001751 00000000177 10147723030 020164 0 ustar covener covener GIF89a kkkZZkJ ! , D8*ORTY
qwA#9a@QՓv.ېh- aGHV0l ; httpd-2.4.64/docs/icons/small/sound2.gif 0000664 0001751 0001751 00000000167 10147723030 017677 0 ustar covener covener GIF89a 999kkk ! , <8L/ Μ`I_(4%1E R(ǑF ; httpd-2.4.64/docs/icons/small/binhex.gif 0000664 0001751 0001751 00000000203 10147723030 017731 0 ustar covener covener GIF89a 999kkk ! , HHܾ@k19FVQu$2S%+<tl&|
OɆQ&qVLl#m p8H ; httpd-2.4.64/docs/icons/small/generic.gif 0000664 0001751 0001751 00000000164 10147723030 020076 0 ustar covener covener GIF89a 999kkk ! , 9Hܾ@k1J'\WDla *BrF}ΜN! 'Qc+ P(k ; httpd-2.4.64/docs/icons/small/doc.gif 0000664 0001751 0001751 00000000277 10147723030 017234 0 ustar covener covener GIF89a 999kkk ! ! by Martin.Kraemer@Mch.SNI.De , 999kkk LxG) HYdmWM]6e)ҺVt4+@ D#!d t ,>kLK
! #(E ; httpd-2.4.64/docs/icons/small/rainbow.gif 0000664 0001751 0001751 00000007343 10147723030 020131 0 ustar covener covener GIF87a/ pp ( (( 0 H H HH X X X X hh ( xx h h @ @ @@ 8 8 8 `` ` ` P PP P 8 0 0 0 p px x , / CCaaQ; ; oKKAAccc#L$ww000^^P:pHH...hh)VV*** {{|2UU kk''T sssn`A
5YhC>"CbfhqcG =I=R8fM'8yI&:QY",`6XٺW
b@lYjU+- x;7e[lL0 tXx)&"`CM :`ټgyB mtW XZk(bPC[
Znoq9@@9$sǘ>u%h½"Ȅ'CFy@+Yލ{7
+P>)|ٿ / 8HTDH#DZ&Ad'2( +` ,.P/ S182@4\
tӍ7|3Α|#C:<cӏ?
$A\$C
=$QDQFqQH$I
RKG$LxڄCN8PD%ADXP` SQM UW]ZuUXcUZiŖ[pt݅^{eC`f !X Yd]ugKiڲi![lofpr1\tRWum xGy {7| _ `#Nn2h!#
wPJ,%X-ˋ0
3&S8#M
Vc6AnHcNK;PIe>WP@[e>@MDfb4j~tntRqιRuMN٧NS MTBU\Q ĥbdjhV
n%*p^ kbيkUFYf;,k ,1`n[ m!msun@n ڝ xw@(nP'}o+& OR_0hXJ N
,Ӳ- Ɋ1#G;5`#
H5 tIkp<~6%c ( %.ii_jHF2)MW il-SLdO~r[PuB nvcT U6HjR}\bN-R ]b*eUr`d1Wsd&9ЉnXLHdN5Zl\hN72r-mN9E<q];:%A=^|U _ _T )(`{$־LXa LA?~+- Q@fLGhY5f5St3x hFxpAi'LB=PXֶyk*9P6<DO|:(
)J[%BZ߾"M
pB '8.e@T5WrS c ]WL 8Gќ.uc]dnZպ]q[^<`yZ%L^{^}< JBZX,I#,400 x,Q3 hR0g|RϮ*YIY pLe45q
]óDm:ӟV#&)wkTޚJm\b8!-r!1/vrd 4GR]usь>ҖڡIֲغ&ZҪ og[?U$tH!\BwTb2^}G|(1TR}J&<0Ѳ~ ֺKB_Ȇ1W d˘=<06 :.A
F
A@,aVrQ9PNtIvC D=b?E(C)5AZ,+WLhQq0iEz+
)
Rq5j
u5iw{z D&2id (oI$z:gԞPW@#)ծF}x% \VSUD#ṟo2" /7$I$`{ ¦-ıbHdNĝpf&;{BNF
wUB*[J p8QT::fn>ir+,JM,gv]nY$yFծwz'9
]@)߂US2d/DH+^Er%0-|ᔥ k̜YpHMR1%Wh.&8Q8NXISyY8-$=}us4"eY剮}-B,p^mظ1̮{4ȍ ;ǔ hо;=F;e(ԧK{叧wC$TR>-)f\2PXW63V,\/ofAvdJdoqĖ ᴶ
NoY@F':t'8pnF6>1DTDsDUo
ue
%[)8Z[]*39+rphp
FpW:ww,Zzg!;W-DHe -%<#7.I)i<6=Ii=s/Z_sJ K!d?`L`?/}k$~w5
Y@63]WKX;DX0m7bkXFNvcqNkNmR6YAF6fSd{ZA6dU7DP]YxW[XE8Ey U9)fiF9nFu]4xzzg7U;a;3hS<G<h&WT<eIG=_U|T>%j r>ɗ>^t7`BV!HW1(V,W$23RL(3~+kxæ~džl3'&gb4ڶm(X9Y nEDrPo(EQxSof[f pdyWp!5\#łR\8szgwSz WHq$rQ^w{ir/PiAs/X \s ]>4` #Kdtk11N1Ha%c2Ƅ@ɔū~WGu#v4v(6+vXXrjcnpw9&dyWn{w@xq32PbxMPeeQE_F'H gF#z"gt6wG2z:hS^Fg{ XM南_2w ` jd_0|0ftr`}aǏ{ 72~W@i73M~c'%el)mmpw59Vd0an Y}'nrs(HPD*UYowoɁ1)(eƛbkƓ+XRkp(]g4qq" AqD(DrD" +ǍZs5i ; httpd-2.4.64/docs/icons/small/key.gif 0000664 0001751 0001751 00000000273 10147723030 017253 0 ustar covener covener GIF89a 999kkk ! ! by Martin.Kraemer@Mch.SNI.De , 999kkk HxGY5k?v-Ga l(U?y;a
%C`0ȂM
Z2H ; httpd-2.4.64/docs/icons/small/broken.gif 0000664 0001751 0001751 00000000213 10147723030 017735 0 ustar covener covener GIF89a 999kkk ! , PHܾ@k1J'\WDla *BrF
2 . ? 0(5< Ylr\N:7:}T$ ; httpd-2.4.64/docs/icons/small/transfer.gif 0000664 0001751 0001751 00000000174 10147723030 020307 0 ustar covener covener GIF89a kkkZZk ! , A8 .)bԮ9&^)B@ZETDN5@Ff(oP%̉yi
T+H ; httpd-2.4.64/docs/icons/small/patch.gif 0000664 0001751 0001751 00000000266 10147723030 017564 0 ustar covener covener GIF89a 999kkk ! ! by Martin.Kraemer@Mch.SNI.De , 999kkk Ch6%2c 85Uh@
A¶:
!]jRS&
; httpd-2.4.64/docs/icons/small/back.gif 0000664 0001751 0001751 00000000201 10147723030 017352 0 ustar covener covener GIF89a !!!111ZZZ ! , FX
I`LV tf]Qn(iàZD,00ZLa"* ѰEq3J`p# ; httpd-2.4.64/docs/icons/small/unknown.gif 0000664 0001751 0001751 00000000203 10147723030 020153 0 ustar covener covener GIF89a 999kkk ! , HHܾ@k1J'\WDla6:TLu! ݩC +BJe(sgiNP)H ; httpd-2.4.64/docs/icons/small/forward.gif 0000664 0001751 0001751 00000000175 10147723030 020130 0 ustar covener covener GIF89a 999kkk ! , B8+ XVDe$ʼnCE8 Xu_HG"QqI
. r$ ; httpd-2.4.64/docs/icons/small/index.gif 0000664 0001751 0001751 00000000221 10147723030 017563 0 ustar covener covener GIF89a !!!ZZZ9B9 ! , VHܾ@Z@`G EqxHpkB`Db3rBgX< hT @)Xۂ-Ҹn <H ; httpd-2.4.64/docs/icons/generic.red.png 0000664 0001751 0001751 00000000433 10671421551 017562 0 ustar covener covener PNG
IHDR 2o5 PLTEfff 333 0С tRNS @* bKGD H BIDAT[cpgccc'% PA0L( aiiiP LTI Dw 3A1 )a VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/image3.png 0000664 0001751 0001751 00000000522 10671421551 016541 0 ustar covener covener PNG
IHDR 2o5 PLTE33f 333 3 3f {D tRNS
A bKGD H qIDAT[M1 . ѵW`r4NLasbvcu2^Z*ӗ4 [P4hh&N)V&5Q [)㡤t7u
s]IڝNOb4.45( VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/continued.png 0000664 0001751 0001751 00000000450 10671421551 017364 0 ustar covener covener PNG
IHDR 2o5 PLTEfff333 tRNS 0J bKGD H TIDATα
CQ
,A ] WLoK; ,NbΨr%i.֊.0 |)N<@C9 VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/alert.black.png 0000664 0001751 0001751 00000000445 10671421551 017562 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H TIDAT[m
0 Nn!JDvx!Hd_̬*'"}0BEzdD$M c_kGl'\ < /- VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/binhex.png 0000664 0001751 0001751 00000000477 10671421551 016662 0 ustar covener covener PNG
IHDR 2o5 PLTEfff333 tRNS 0J bKGD H kIDAT[e DEp+*MBqS"GFB 6^ԛ 8bRL"7h ۶rYa3b-8O! hc1 VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/right.png 0000664 0001751 0001751 00000000376 10671421551 016520 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H 3IDAT[c( & T0L T0LD"""Zd-{e+8: VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/generic.png 0000664 0001751 0001751 00000000423 10671421551 017010 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H BIDAT[A
@ EZ WBk@7Es$I
w0S33w˱]>jj e T9w~\ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/link.png 0000664 0001751 0001751 00000000472 10671421551 016335 0 ustar covener covener PNG
IHDR 2o5 PLTE33f 333 \ tRNS
A bKGD H bIDAT[M Z{Vp lAGpb|O gIi< J)Z$p !<- tmZ26 -f#~~ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/p.png 0000664 0001751 0001751 00000000452 10671421551 015635 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H YIDAT[
@@V@ P3)A<_'+$ifJJh)EI1&Uj<]>Sn_{ˊ>ie)A VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/pie8.png 0000664 0001751 0001751 00000000403 10671421551 016237 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H 8IDAT[cd*j)\je(CتUBT($$UBB́ 2 6}(+ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/blank.png 0000664 0001751 0001751 00000000327 10671421551 016466 0 ustar covener covener PNG
IHDR .E PLTEsQ tRNS 0J bKGD H IDAT c Yi*pl VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/up.gif 0000664 0001751 0001751 00000000244 10147723030 015775 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , #MZ= XbI ,LvP ; httpd-2.4.64/docs/icons/binary.gif 0000664 0001751 0001751 00000000366 10147723030 016642 0 ustar covener covener GIF89a ̙333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , iH0@$Y
]! q^ k굮jAvQh)n%Ӗ *ԂZU)9!_8s; JI;CS ; httpd-2.4.64/docs/icons/sphere1.gif 0000664 0001751 0001751 00000000435 10147723030 016722 0 ustar covener covener GIF89a 33̙f 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , xpI8:@ AjtnEC w-T2VTʬWh5awE_=}L~$y{~VSz_qwm?|H5j& ; httpd-2.4.64/docs/icons/README.html 0000664 0001751 0001751 00000106331 10664776532 016534 0 ustar covener covener <html>
<head>
<style>
a { text-decoration: none; }
img.whiteico { padding: 4px; background: white; vertical-align: middle; }
img.blackico { padding: 4px; background: black; vertical-align: middle; }
</style>
</head>
<body>
<h1>Public Domain Icons</h1>
<p>These icons were originally made for Mosaic for X and have been
included in the NCSA httpd and Apache server distributions in the
past. They are in the public domain and may be freely included in any
application. The originals were done by Kevin Hughes (kevinh@kevcom.com).
Andy Polyakov tuned the icon colors and added few new images.</p>
<p>If you'd like to contribute additions to this set, contact the httpd
documentation project <a href="http://httpd.apache.org/docs-project/"
>http://httpd.apache.org/docs-project/</a>.</p>
<p>Almost all of these icons are 20x22 pixels in size. There are
alternative icons in the "small" directory that are 16x16 in size,
provided by Mike Brown (mike@hyperreal.org).</p>
<h2>Suggested Uses</h2>
<p>The following are a few suggestions, to serve as a starting point for ideas.
Please feel free to tweak and rename the icons as you like.</p>
<table>
<tr>
<td width="25%">
<a href="a.gif"><img class="blackico" src="a.gif"
/><img class="whiteico" src="a.gif" /> a.gif</a>
<br /><a href="a.png"><img class="blackico" src="a.png"
/><img class="whiteico" src="a.png" /> a.png</a></td>
</tr>
<tr><td colspan="4">This might be used to represent PostScript or text layout
languages.</td>
</tr>
<tr>
<td width="25%">
<a href="alert.black.gif"><img class="blackico" src="alert.black.gif"
/><img class="whiteico" src="alert.black.gif" /> alert.black.gif</a>
<br /><a href="alert.black.png"><img class="blackico" src="alert.black.png"
/><img class="whiteico" src="alert.black.png" /> alert.black.png</a></td>
<td width="25%">
<a href="alert.red.gif"><img class="blackico" src="alert.red.gif"
/><img class="whiteico" src="alert.red.gif" /> alert.red.gif</a>
<br /><a href="alert.red.png"><img class="blackico" src="alert.red.png"
/><img class="whiteico" src="alert.red.png" /> alert.red.png</a></td>
</tr>
<tr><td colspan="4">These can be used to highlight any important items,
such as a README file in a directory.</td>
</tr>
<tr>
<td width="25%">
<a href="back.gif"><img class="blackico" src="back.gif"
/><img class="whiteico" src="back.gif" /> back.gif</a>
<br /><a href="back.png"><img class="blackico" src="back.png"
/><img class="whiteico" src="back.png" /> back.png</a></td>
<td width="25%">
<a href="forward.gif"><img class="blackico" src="forward.gif"
/><img class="whiteico" src="forward.gif" /> forward.gif</a>
<br /><a href="forward.png"><img class="blackico" src="forward.png"
/><img class="whiteico" src="forward.png" /> forward.png</a></td>
<td width="25%">
<a href="small/back.gif"><img class="blackico" src="small/back.gif"
/><img class="whiteico" src="small/back.gif" /> small.gif</a>
<br /><a href="small/back.png"><img class="blackico" src="small/back.png"
/><img class="whiteico" src="small/back.png" /> small/back.png</a></td>
<td width="25%">
<a href="small/forward.gif"><img class="blackico" src="small/forward.gif"
/><img class="whiteico" src="small/forward.gif" /> small/forward.gif</a>
<br /><a href="small/forward.png"><img class="blackico" src="small/forward.png"
/><img class="whiteico" src="small/forward.png" /> small/forward.png</a></td>
</tr>
<tr><td colspan="4">These can be used as links to go to previous and next
areas.</td>
</tr>
<tr>
<td width="25%">
<a href="ball.gray.gif"><img class="blackico" src="ball.gray.gif"
/><img class="whiteico" src="ball.gray.gif" /> ball.gray.gif</a>
<br /><a href="ball.gray.png"><img class="blackico" src="ball.gray.png"
/><img class="whiteico" src="ball.gray.png" /> ball.gray.png</a></td>
<td width="25%">
<a href="ball.red.gif"><img class="blackico" src="ball.red.gif"
/><img class="whiteico" src="ball.red.gif" /> ball.red.gif</a>
<br /><a href="ball.red.png"><img class="blackico" src="ball.red.png"
/><img class="whiteico" src="ball.red.png" /> ball.red.png</a></td>
</tr>
<tr><td colspan="4">These might be used as bullets.</td>
</tr>
<tr>
<td width="25%">
<a href="binary.gif"><img class="blackico" src="binary.gif"
/><img class="whiteico" src="binary.gif" /> binary.gif</a>
<br /><a href="binary.png"><img class="blackico" src="binary.png"
/><img class="whiteico" src="binary.png" /> binary.png</a></td>
<td width="25%">
<a href="small/binary.gif"><img class="blackico" src="small/binary.gif"
/><img class="whiteico" src="small/binary.gif" /> small/binary.gif</a>
<br /><a href="small/binary.png"><img class="blackico" src="small/binary.png"
/><img class="whiteico" src="small/binary.png" /> small/binary.png</a></td>
</tr>
<tr><td colspan="4">This can be used to represent binary files.</td>
</tr>
<tr>
<td width="25%">
<a href="binhex.gif"><img class="blackico" src="binhex.gif"
/><img class="whiteico" src="binhex.gif" /> binhex.gif</a>
<br /><a href="binhex.png"><img class="blackico" src="binhex.png"
/><img class="whiteico" src="binhex.png" /> binhex.png</a></td>
<td width="25%">
<a href="small/binhex.gif"><img class="blackico" src="small/binhex.gif"
/><img class="whiteico" src="small/binhex.gif" /> small/binhex.gif</a>
<br /><a href="small/binhex.png"><img class="blackico" src="small/binhex.png"
/><img class="whiteico" src="small/binhex.png" /> small/binhex.png</a></td>
</tr>
<tr><td colspan="4">This can represent BinHex-encoded data.</td>
</tr>
<tr>
<td width="25%">
<a href="blank.gif"><img class="blackico" src="blank.gif"
/><img class="whiteico" src="blank.gif" /> blank.gif</a>
<br /><a href="blank.png"><img class="blackico" src="blank.png"
/><img class="whiteico" src="blank.png" /> blank.png</a></td>
<td width="25%">
<a href="small/blank.gif"><img class="blackico" src="small/blank.gif"
/><img class="whiteico" src="small/blank.gif" /> small/blank.gif</a>
<br /><a href="small/blank.png"><img class="blackico" src="small/blank.png"
/><img class="whiteico" src="small/blank.png" /> small/blank.png</a></td>
</tr>
<tr><td colspan="4">This can be used as a placeholder or a spacing
element.</td>
</tr>
<tr>
<td width="25%">
<a href="bomb.gif"><img class="blackico" src="bomb.gif"
/><img class="whiteico" src="bomb.gif" /> bomb.gif</a>
<br /><a href="bomb.png"><img class="blackico" src="bomb.png"
/><img class="whiteico" src="bomb.png" /> bomb.png</a></td>
</tr>
<tr><td colspan="4">This can be used to represent core files.</td>
</tr>
<tr>
<td width="25%">
<a href="box1.gif"><img class="blackico" src="box1.gif"
/><img class="whiteico" src="box1.gif" /> box1.gif</a>
<br /><a href="box1.png"><img class="blackico" src="box1.png"
/><img class="whiteico" src="box1.png" /> box1.png</a></td>
<td width="25%">
<a href="box2.gif"><img class="blackico" src="box2.gif"
/><img class="whiteico" src="box2.gif" /> box2.gif</a>
<br /><a href="box2.png"><img class="blackico" src="box2.png"
/><img class="whiteico" src="box2.png" /> box2.png</a></td>
</tr>
<tr><td colspan="4">These icons can be used to represent generic 3D
applications and related files.</td>
</tr>
<tr>
<td width="25%">
<a href="broken.gif"><img class="blackico" src="broken.gif"
/><img class="whiteico" src="broken.gif" /> broken.gif</a>
<br /><a href="broken.png"><img class="blackico" src="broken.png"
/><img class="whiteico" src="broken.png" /> broken.png</a></td>
<td width="25%">
<a href="small/broken.gif"><img class="blackico" src="small/broken.gif"
/><img class="whiteico" src="small/broken.gif" /> small/broken.gif</a>
<br /><a href="small/broken.png"><img class="blackico" src="small/broken.png"
/><img class="whiteico" src="small/broken.png" /> small/broken.png</a></td>
</tr>
<tr><td colspan="4">This can represent corrupted data.</td>
</tr>
<tr>
<td width="25%">
<a href="burst.gif"><img class="blackico" src="burst.gif"
/><img class="whiteico" src="burst.gif" /> burst.gif</a>
<br /><a href="burst.png"><img class="blackico" src="burst.png"
/><img class="whiteico" src="burst.png" /> burst.png</a></td>
<td width="25%">
<a href="small/burst.gif"><img class="blackico" src="small/burst.gif"
/><img class="whiteico" src="small/burst.gif" /> small/burst.gif</a>
<br /><a href="small/burst.png"><img class="blackico" src="small/burst.png"
/><img class="whiteico" src="small/burst.png" /> small/burst.png</a></td>
</tr>
<tr><td colspan="4">This can call attention to new and important items.</td>
</tr>
<tr>
<td width="25%">
<a href="c.gif"><img class="blackico" src="c.gif"
/><img class="whiteico" src="c.gif" /> c.gif</a>
<br /><a href="c.png"><img class="blackico" src="c.png"
/><img class="whiteico" src="c.png" /> c.png</a></td>
</tr>
<tr><td colspan="4">This might represent C source code.</td>
</tr>
<tr>
<td width="25%">
<a href="comp.blue.gif"><img class="blackico" src="comp.blue.gif"
/><img class="whiteico" src="comp.blue.gif" /> comp.blue.gif</a>
<br /><a href="comp.blue.png"><img class="blackico" src="comp.blue.png"
/><img class="whiteico" src="comp.blue.png" /> comp.blue.png</a></td>
<td width="25%">
<a href="comp.gray.gif"><img class="blackico" src="comp.gray.gif"
/><img class="whiteico" src="comp.gray.gif" /> comp.gray.gif</a>
<br /><a href="comp.gray.png"><img class="blackico" src="comp.gray.png"
/><img class="whiteico" src="comp.gray.png" /> comp.gray.png</a></td>
<td width="25%">
<a href="small/comp1.gif"><img class="blackico" src="small/comp1.gif"
/><img class="whiteico" src="small/comp1.gif" /> small/comp1.gif</a>
<br /><a href="small/comp1.png"><img class="blackico" src="small/comp1.png"
/><img class="whiteico" src="small/comp1.png" /> small/comp1.png</a></td>
<td width="25%">
<a href="small/comp2.gif"><img class="blackico" src="small/comp2.gif"
/><img class="whiteico" src="small/comp2.gif" /> small/comp2.gif</a>
<br /><a href="small/comp2.png"><img class="blackico" src="small/comp2.png"
/><img class="whiteico" src="small/comp2.png" /> small/comp2.png</a></td>
</tr>
<tr><td colspan="4">These little computer icons can stand for telnet or FTP
sessions.</td>
</tr>
<tr>
<td width="25%">
<a href="compressed.gif"><img class="blackico" src="compressed.gif"
/><img class="whiteico" src="compressed.gif" /> compressed.gif</a>
<br /><a href="compressed.png"><img class="blackico" src="compressed.png"
/><img class="whiteico" src="compressed.png" /> compressed.png</a></td>
<td width="25%">
<a href="small/compressed.gif"><img class="blackico" src="small/compressed.gif"
/><img class="whiteico" src="small/compressed.gif" /> small/compressed.gif</a>
<br /><a href="small/compressed.png"><img class="blackico" src="small/compressed.png"
/><img class="whiteico" src="small/compressed.png" /> small/compressed.png</a></td>
</tr>
<tr><td colspan="4">This may represent compressed data.</td>
</tr>
<tr>
<td width="25%">
<a href="continued.gif"><img class="blackico" src="continued.gif"
/><img class="whiteico" src="continued.gif" /> continued.gif</a>
<br /><a href="continued.png"><img class="blackico" src="continued.png"
/><img class="whiteico" src="continued.png" /> continued.png</a></td>
<td width="25%">
<a href="small/continued.gif"><img class="blackico" src="small/continued.gif"
/><img class="whiteico" src="small/continued.gif" /> small/continued.gif</a>
<br /><a href="small/continued.png"><img class="blackico" src="small/continued.png"
/><img class="whiteico" src="small/continued.png" /> small/continued.png</a></td>
</tr>
<tr><td colspan="4">This can be a link to a continued listing of a
directory.</td>
</tr>
<tr>
<td width="25%">
<a href="down.gif"><img class="blackico" src="down.gif"
/><img class="whiteico" src="down.gif" /> down.gif</a>
<br /><a href="down.png"><img class="blackico" src="down.png"
/><img class="whiteico" src="down.png" /> down.png</a></td>
<td width="25%">
<a href="up.gif"><img class="blackico" src="up.gif"
/><img class="whiteico" src="up.gif" /> up.gif</a>
<br /><a href="up.png"><img class="blackico" src="up.png"
/><img class="whiteico" src="up.png" /> up.png</a></td>
<td width="25%">
<a href="left.gif"><img class="blackico" src="left.gif"
/><img class="whiteico" src="left.gif" /> left.gif</a>
<br /><a href="left.png"><img class="blackico" src="left.png"
/><img class="whiteico" src="left.png" /> left.png</a></td>
<td width="25%">
<a href="right.gif"><img class="blackico" src="right.gif"
/><img class="whiteico" src="right.gif" /> right.gif</a>
<br /><a href="right.png"><img class="blackico" src="right.png"
/><img class="whiteico" src="right.png" /> right.png</a></td>
</tr>
<tr><td colspan="4">These can be used to scroll up, down, left and right in a
listing or may be used to denote items in an outline.</td>
</tr>
<tr>
<td width="25%">
<a href="dir.gif"><img class="blackico" src="dir.gif"
/><img class="whiteico" src="dir.gif" /> dir.gif</a>
<br /><a href="dir.png"><img class="blackico" src="dir.png"
/><img class="whiteico" src="dir.png" /> dir.png</a></td>
</tr>
<tr><td colspan="4">Identical to folder.gif (.png) below.</td>
</tr>
<tr>
<td width="25%">
<a href="diskimg.gif"><img class="blackico" src="diskimg.gif"
/><img class="whiteico" src="diskimg.gif" /> diskimg.gif</a>
<br /><a href="diskimg.png"><img class="blackico" src="diskimg.png"
/><img class="whiteico" src="diskimg.png" /> diskimg.png</a></td>
</tr>
<tr><td colspan="4">This can represent floppy disk storage.</td>
</tr>
<tr>
<td width="25%">
<a href="small/doc.gif"><img class="blackico" src="small/doc.gif"
/><img class="whiteico" src="small/doc.gif" /> small/doc.gif</a>
<br /><a href="small/doc.png"><img class="blackico" src="small/doc.png"
/><img class="whiteico" src="small/doc.png" /> small/doc.png</a></td>
</tr>
<tr><td colspan="4">This can represent document files.</td>
</tr>
<tr>
<td width="25%">
<a href="dvi.gif"><img class="blackico" src="dvi.gif"
/><img class="whiteico" src="dvi.gif" /> dvi.gif</a>
<br /><a href="dvi.png"><img class="blackico" src="dvi.png"
/><img class="whiteico" src="dvi.png" /> dvi.png</a></td>
</tr>
<tr><td colspan="4">This can represent DVI files.</td>
</tr>
<tr>
<td width="25%">
<a href="f.gif"><img class="blackico" src="f.gif"
/><img class="whiteico" src="f.gif" /> f.gif</a>
<br /><a href="f.png"><img class="blackico" src="f.png"
/><img class="whiteico" src="f.png" /> f.png</a></td>
</tr>
<tr><td colspan="4">This might represent FORTRAN or Forth source code.</td>
</tr>
<tr>
<td width="25%">
<a href="folder.gif"><img class="blackico" src="folder.gif"
/><img class="whiteico" src="folder.gif" /> folder.gif</a>
<br /><a href="folder.png"><img class="blackico" src="folder.png"
/><img class="whiteico" src="folder.png" /> folder.png</a></td>
<td width="25%">
<a href="folder.open.gif"><img class="blackico" src="folder.open.gif"
/><img class="whiteico" src="folder.open.gif" /> folder.open.gif</a>
<br /><a href="folder.open.png"><img class="blackico" src="folder.open.png"
/><img class="whiteico" src="folder.open.png" /> folder.open.png</a></td>
<td width="25%">
<a href="folder.sec.gif"><img class="blackico" src="folder.sec.gif"
/><img class="whiteico" src="folder.sec.gif" /> folder.sec.gif</a>
<br /><a href="folder.sec.png"><img class="blackico" src="folder.sec.png"
/><img class="whiteico" src="folder.sec.png" /> folder.sec.png</a></td>
</tr>
<tr>
<td width="25%">
<a href="small/folder.gif"><img class="blackico" src="small/folder.gif"
/><img class="whiteico" src="small/folder.gif" /> small/folder.gif</a>
<br /><a href="small/folder.png"><img class="blackico" src="small/folder.png"
/><img class="whiteico" src="small/folder.png" /> small/folder.png</a></td>
<td width="25%">
<a href="small/folder2.gif"><img class="blackico" src="small/folder2.gif"
/><img class="whiteico" src="small/folder2.gif" /> small/folder2.gif</a>
<br /><a href="small/folder2.png"><img class="blackico" src="small/folder2.png"
/><img class="whiteico" src="small/folder2.png" /> small/folder2.png</a></td>
</tr>
<tr><td colspan="4">The folder can represent directories. There is also a
version that can represent secure directories or directories that cannot
be viewed.</td>
</tr>
<tr>
<td width="25%">
<a href="generic.gif"><img class="blackico" src="generic.gif"
/><img class="whiteico" src="generic.gif" /> generic.gif</a>
<br /><a href="generic.png"><img class="blackico" src="generic.png"
/><img class="whiteico" src="generic.png" /> generic.png</a></td>
<td width="25%">
<a href="generic.sec.gif"><img class="blackico" src="generic.sec.gif"
/><img class="whiteico" src="generic.sec.gif" /> generic.sec.gif</a>
<br /><a href="generic.sec.png"><img class="blackico" src="generic.sec.png"
/><img class="whiteico" src="generic.sec.png" /> generic.sec.png</a></td>
<td width="25%">
<a href="generic.red.gif"><img class="blackico" src="generic.red.gif"
/><img class="whiteico" src="generic.red.gif" /> generic.red.gif</a>
<br /><a href="generic.red.png"><img class="blackico" src="generic.red.png"
/><img class="whiteico" src="generic.red.png" /> generic.red.png</a></td>
</tr>
<tr>
<td width="25%">
<a href="small/generic.gif"><img class="blackico" src="small/generic.gif"
/><img class="whiteico" src="small/generic.gif" /> small/generic.gif</a>
<br /><a href="small/generic.png"><img class="blackico" src="small/generic.png"
/><img class="whiteico" src="small/generic.png" /> small/generic.png</a></td>
<td width="25%">
<a href="small/generic2.gif"><img class="blackico" src="small/generic2.gif"
/><img class="whiteico" src="small/generic2.gif" /> small/generic2.gif</a>
<br /><a href="small/generic2.png"><img class="blackico" src="small/generic2.png"
/><img class="whiteico" src="small/generic2.png" /> small/generic2.png</a></td>
<td width="25%">
<a href="small/generic3.gif"><img class="blackico" src="small/generic3.gif"
/><img class="whiteico" src="small/generic3.gif" /> small/generic3.gif</a>
<br /><a href="small/generic3.png"><img class="blackico" src="small/generic3.png"
/><img class="whiteico" src="small/generic3.png" /> small/generic3.png</a></td>
</tr>
<tr><td colspan="4">These can represent generic files, secure files, and
important files, respectively.</td>
</tr>
<tr>
<td width="25%">
<a href="hand.right.gif"><img class="blackico" src="hand.right.gif"
/><img class="whiteico" src="hand.right.gif" /> hand.right.gif</a>
<br /><a href="hand.right.png"><img class="blackico" src="hand.right.png"
/><img class="whiteico" src="hand.right.png" /> hand.right.png</a></td>
<td width="25%">
<a href="hand.up.gif"><img class="blackico" src="hand.up.gif"
/><img class="whiteico" src="hand.up.gif" /> hand.up.gif</a>
<br /><a href="hand.up.png"><img class="blackico" src="hand.up.png"
/><img class="whiteico" src="hand.up.png" /> hand.up.png</a></td>
</tr>
<tr><td colspan="4">These can point out important items (pun intended).</td>
</tr>
<tr>
<td width="25%">
<a href="image1.gif"><img class="blackico" src="image1.gif"
/><img class="whiteico" src="image1.gif" /> image1.gif</a>
<br /><a href="image1.png"><img class="blackico" src="image1.png"
/><img class="whiteico" src="image1.png" /> image1.png</a></td>
<td width="25%">
<a href="image2.gif"><img class="blackico" src="image2.gif"
/><img class="whiteico" src="image2.gif" /> image2.gif</a>
<br /><a href="image2.png"><img class="blackico" src="image2.png"
/><img class="whiteico" src="image2.png" /> image2.png</a></td>
<td width="25%">
<a href="image3.gif"><img class="blackico" src="image3.gif"
/><img class="whiteico" src="image3.gif" /> image3.gif</a>
<br /><a href="image3.png"><img class="blackico" src="image3.png"
/><img class="whiteico" src="image3.png" /> image3.png</a></td>
</tr>
<tr>
<td width="25%">
<a href="small/image.gif"><img class="blackico" src="small/image.gif"
/><img class="whiteico" src="small/image.gif" /> small/image.gif</a>
<br /><a href="small/image.png"><img class="blackico" src="small/image.png"
/><img class="whiteico" src="small/image.png" /> small/image.png</a></td>
<td width="25%">
<a href="small/image2.gif"><img class="blackico" src="small/image2.gif"
/><img class="whiteico" src="small/image2.gif" /> small/image2.gif</a>
<br /><a href="small/image2.png"><img class="blackico" src="small/image2.png"
/><img class="whiteico" src="small/image2.png" /> small/image2.png</a></td>
</tr>
<tr><td colspan="4">These can represent image formats of various types.</td>
</tr>
<tr>
<td width="25%">
<a href="index.gif"><img class="blackico" src="index.gif"
/><img class="whiteico" src="index.gif" /> index.gif</a>
<br /><a href="index.png"><img class="blackico" src="index.png"
/><img class="whiteico" src="index.png" /> index.png</a></td>
<td width="25%">
<a href="small/index.gif"><img class="blackico" src="small/index.gif"
/><img class="whiteico" src="small/index.gif" /> small/index.gif</a>
<br /><a href="small/index.png"><img class="blackico" src="small/index.png"
/><img class="whiteico" src="small/index.png" /> small/index.png</a></td>
</tr>
<tr><td colspan="4">This might represent a WAIS index or search facility.</td>
</tr>
<tr>
<td width="25%">
<a href="small/key.gif"><img class="blackico" src="small/key.gif"
/><img class="whiteico" src="small/key.gif" /> small/key.gif</a>
<br /><a href="small/key.png"><img class="blackico" src="small/key.png"
/><img class="whiteico" src="small/key.png" /> small/key.png</a></td>
</tr>
<tr><td colspan="4">This might represent a locked file.</td>
</tr>
<tr>
<td width="25%">
<a href="layout.gif"><img class="blackico" src="layout.gif"
/><img class="whiteico" src="layout.gif" /> layout.gif</a>
<br /><a href="layout.png"><img class="blackico" src="layout.png"
/><img class="whiteico" src="layout.png" /> layout.png</a></td>
</tr>
<tr><td colspan="4">This might represent files and formats that contain
graphics as well as text layout, such as HTML and PDF files.</td>
</tr>
<tr>
<td width="25%">
<a href="link.gif"><img class="blackico" src="link.gif"
/><img class="whiteico" src="link.gif" /> link.gif</a>
<br /><a href="link.png"><img class="blackico" src="link.png"
/><img class="whiteico" src="link.png" /> link.png</a></td>
</tr>
<tr><td colspan="4">This might represent files that are symbolic links.</td>
</tr>
<tr>
<td width="25%">
<a href="movie.gif"><img class="blackico" src="movie.gif"
/><img class="whiteico" src="movie.gif" /> movie.gif</a>
<br /><a href="movie.png"><img class="blackico" src="movie.png"
/><img class="whiteico" src="movie.png" /> movie.png</a></td>
<td width="25%">
<a href="small/movie.gif"><img class="blackico" src="small/movie.gif"
/><img class="whiteico" src="small/movie.gif" /> small/movie.gif</a>
<br /><a href="small/movie.png"><img class="blackico" src="small/movie.png"
/><img class="whiteico" src="small/movie.png" /> small/movie.png</a></td>
</tr>
<tr><td colspan="4">This can represent various movie formats.</td>
</tr>
<tr>
<td width="25%">
<a href="p.gif"><img class="blackico" src="p.gif"
/><img class="whiteico" src="p.gif" /> p.gif</a>
<br /><a href="p.png"><img class="blackico" src="p.png"
/><img class="whiteico" src="p.png" /> p.png</a></td>
</tr>
<tr><td colspan="4">This may stand for Perl or Python source code.</td>
</tr>
<tr>
<td width="25%">
<a href="pie0.gif"><img class="blackico" src="pie0.gif"
/><img class="whiteico" src="pie0.gif" /> pie0.gif</a>
<br /><a href="pie1.png"><img class="blackico" src="pie0.png"
/><img class="whiteico" src="pie0.png" /> pie0.png</a></td>
<td width="25%">
<a href="pie1.gif"><img class="blackico" src="pie1.gif"
/><img class="whiteico" src="pie1.gif" /> pie1.gif</a>
<br /><a href="pie1.png"><img class="blackico" src="pie1.png"
/><img class="whiteico" src="pie1.png" /> pie1.png</a></td>
<td width="25%">
<a href="pie2.gif"><img class="blackico" src="pie2.gif"
/><img class="whiteico" src="pie2.gif" /> pie2.gif</a>
<br /><a href="pie2.png"><img class="blackico" src="pie2.png"
/><img class="whiteico" src="pie2.png" /> pie2.png</a></td>
<td width="25%">
<a href="pie3.gif"><img class="blackico" src="pie3.gif"
/><img class="whiteico" src="pie3.gif" /> pie3.gif</a>
<br /><a href="pie3.png"><img class="blackico" src="pie3.png"
/><img class="whiteico" src="pie3.png" /> pie3.png</a></td>
</tr><tr>
<td width="25%">
<a href="pie4.gif"><img class="blackico" src="pie4.gif"
/><img class="whiteico" src="pie4.gif" /> pie4.gif</a>
<br /><a href="pie4.png"><img class="blackico" src="pie4.png"
/><img class="whiteico" src="pie4.png" /> pie4.png</a></td>
<td width="25%">
<a href="pie5.gif"><img class="blackico" src="pie5.gif"
/><img class="whiteico" src="pie5.gif" /> pie5.gif</a>
<br /><a href="pie5.png"><img class="blackico" src="pie5.png"
/><img class="whiteico" src="pie5.png" /> pie5.png</a></td>
<td width="25%">
<a href="pie6.gif"><img class="blackico" src="pie6.gif"
/><img class="whiteico" src="pie6.gif" /> pie6.gif</a>
<br /><a href="pie6.png"><img class="blackico" src="pie6.png"
/><img class="whiteico" src="pie6.png" /> pie6.png</a></td>
<td width="25%">
<a href="pie7.gif"><img class="blackico" src="pie7.gif"
/><img class="whiteico" src="pie7.gif" /> pie7.gif</a>
<br /><a href="pie7.png"><img class="blackico" src="pie7.png"
/><img class="whiteico" src="pie7.png" /> pie7.png</a></td>
</tr><tr>
<td width="25%">
<a href="pie8.gif"><img class="blackico" src="pie8.gif"
/><img class="whiteico" src="pie8.gif" /> pie8.gif</a>
<br /><a href="pie8.png"><img class="blackico" src="pie8.png"
/><img class="whiteico" src="pie8.png" /> pie8.png</a></td>
</tr>
<tr><td colspan="4">These icons can be used in applications where a list of
documents is returned from a search. The little pie chart images
can denote how relevant the documents may be to your search query.</td>
</tr>
<tr>
<td width="25%">
<a href="patch.gif"><img class="blackico" src="patch.gif"
/><img class="whiteico" src="patch.gif" /> patch.gif</a>
<br /><a href="patch.png"><img class="blackico" src="patch.png"
/><img class="whiteico" src="patch.png" /> patch.png</a></td>
<td width="25%">
<a href="small/patch.gif"><img class="blackico" src="small/patch.gif"
/><img class="whiteico" src="small/patch.gif" /> small/patch.gif</a>
<br /><a href="small/patch.png"><img class="blackico" src="small/patch.png"
/><img class="whiteico" src="small/patch.png" /> small/patch.png</a></td>
</tr>
<tr><td colspan="4">This may stand for patches and diff files.</td>
</tr>
<tr>
<td width="25%">
<a href="portal.gif"><img class="blackico" src="portal.gif"
/><img class="whiteico" src="portal.gif" /> portal.gif</a>
<br /><a href="portal.png"><img class="blackico" src="portal.png"
/><img class="whiteico" src="portal.png" /> portal.png</a></td>
</tr>
<tr><td colspan="4">This might be a link to an online service or a 3D
world.</td>
</tr>
<tr>
<td width="25%">
<a href="pdf.gif"><img class="blackico" src="pdf.gif"
/><img class="whiteico" src="pdf.gif" /> pdf.gif</a>
<br /><a href="pdf.png"><img class="blackico" src="pdf.png"
/><img class="whiteico" src="pdf.png" /> pdf.png</a></td>
<td width="25%">
<a href="ps.gif"><img class="blackico" src="ps.gif"
/><img class="whiteico" src="ps.gif" /> ps.gif</a>
<br /><a href="ps.png"><img class="blackico" src="ps.png"
/><img class="whiteico" src="ps.png" /> ps.png</a></td>
<td width="25%">
<a href="quill.gif"><img class="blackico" src="quill.gif"
/><img class="whiteico" src="quill.gif" /> quill.gif</a>
<br /><a href="quill.png"><img class="blackico" src="quill.png"
/><img class="whiteico" src="quill.png" /> quill.png</a></td>
<td width="25%">
<a href="small/ps.gif"><img class="blackico" src="small/ps.gif"
/><img class="whiteico" src="small/ps.gif" /> small/ps.gif</a>
<br /><a href="small/ps.png"><img class="blackico" src="small/ps.png"
/><img class="whiteico" src="small/ps.png" /> small/ps.png</a></td>
</tr>
<tr><td colspan="4">These may represent PDF and PostScript files.</td>
</tr>
<tr>
<td width="25%">
<a href="screw1.gif"><img class="blackico" src="screw1.gif"
/><img class="whiteico" src="screw1.gif" /> screw1.gif</a>
<br /><a href="screw1.png"><img class="blackico" src="screw1.png"
/><img class="whiteico" src="screw1.png" /> screw1.png</a></td>
<td width="25%">
<a href="screw2.gif"><img class="blackico" src="screw2.gif"
/><img class="whiteico" src="screw2.gif" /> screw2.gif</a>
<br /><a href="screw2.png"><img class="blackico" src="screw2.png"
/><img class="whiteico" src="screw2.png" /> screw2.png</a></td>
</tr>
<tr><td colspan="4">These may represent CAD or engineering data and
formats.</td>
</tr>
<tr>
<td width="25%">
<a href="script.gif"><img class="blackico" src="script.gif"
/><img class="whiteico" src="script.gif" /> script.gif</a>
<br /><a href="script.png"><img class="blackico" src="script.png"
/><img class="whiteico" src="script.png" /> script.png</a></td>
</tr>
<tr><td colspan="4">This can represent any of various interpreted languages,
such as Perl, python, TCL, and shell scripts, as well as server configuration
files.</td>
</tr>
<tr>
<td width="25%">
<a href="sound1.gif"><img class="blackico" src="sound1.gif"
/><img class="whiteico" src="sound1.gif" /> sound1.gif</a>
<br /><a href="sound1.png"><img class="blackico" src="sound1.png"
/><img class="whiteico" src="sound1.png" /> sound1.png</a></td>
<td width="25%">
<a href="sound2.gif"><img class="blackico" src="sound2.gif"
/><img class="whiteico" src="sound2.gif" /> sound2.gif</a>
<br /><a href="sound2.png"><img class="blackico" src="sound2.png"
/><img class="whiteico" src="sound2.png" /> sound2.png</a></td>
<td width="25%">
<a href="small/sound.gif"><img class="blackico" src="small/sound.gif"
/><img class="whiteico" src="small/sound.gif" /> small/sound.gif</a>
<br /><a href="small/sound.png"><img class="blackico" src="small/sound.png"
/><img class="whiteico" src="small/sound.png" /> small/sound.png</a></td>
<td width="25%">
<a href="small/sound2.gif"><img class="blackico" src="small/sound2.gif"
/><img class="whiteico" src="small/sound2.gif" /> small/sound2.gif</a>
<br /><a href="small/sound2.png"><img class="blackico" src="small/sound2.png"
/><img class="whiteico" src="small/sound2.png" /> small/sound2.png</a></td>
</tr>
<tr><td colspan="4">These can represent sound files.</td>
</tr>
<tr>
<td width="25%">
<a href="sphere1.gif"><img class="blackico" src="sphere1.gif"
/><img class="whiteico" src="sphere1.gif" /> sphere1.gif</a>
<br /><a href="sphere1.png"><img class="blackico" src="sphere1.png"
/><img class="whiteico" src="sphere1.png" /> sphere1.png</a></td>
<td width="25%">
<a href="sphere2.gif"><img class="blackico" src="sphere2.gif"
/><img class="whiteico" src="sphere2.gif" /> sphere2.gif</a>
<br /><a href="sphere2.png"><img class="blackico" src="sphere2.png"
/><img class="whiteico" src="sphere2.png" /> sphere2.png</a></td>
</tr>
<tr><td colspan="4">These can represent 3D worlds or rendering applications and
formats.</td>
</tr>
<tr>
<td width="25%">
<a href="tar.gif"><img class="blackico" src="tar.gif"
/><img class="whiteico" src="tar.gif" /> tar.gif</a>
<br /><a href="tar.png"><img class="blackico" src="tar.png"
/><img class="whiteico" src="tar.png" /> tar.png</a></td>
<td width="25%">
<a href="small/tar.gif"><img class="blackico" src="small/tar.gif"
/><img class="whiteico" src="small/tar.gif" /> small/tar.gif</a>
<br /><a href="small/tar.png"><img class="blackico" src="small/tar.png"
/><img class="whiteico" src="small/tar.png" /> small/tar.png</a></td>
</tr>
<tr><td colspan="4">This can represent TAR archive files.</td>
</tr>
<tr>
<td width="25%">
<a href="tex.gif"><img class="blackico" src="tex.gif"
/><img class="whiteico" src="tex.gif" /> tex.gif</a>
<br /><a href="tex.png"><img class="blackico" src="tex.png"
/><img class="whiteico" src="tex.png" /> tex.png</a></td>
</tr>
<tr><td colspan="4">This can represent TeX files.</td>
</tr>
<tr>
<td width="25%">
<a href="text.gif"><img class="blackico" src="text.gif"
/><img class="whiteico" src="text.gif" /> text.gif</a>
<br /><a href="text.png"><img class="blackico" src="text.png"
/><img class="whiteico" src="text.png" /> text.png</a></td>
<td width="25%">
<a href="small/text.gif"><img class="blackico" src="small/text.gif"
/><img class="whiteico" src="small/text.gif" /> small/text.gif</a>
<br /><a href="small/text.png"><img class="blackico" src="small/text.png"
/><img class="whiteico" src="small/text.png" /> small/text.png</a></td>
</tr>
<tr><td colspan="4">This can represent generic (plain) text files.</td>
</tr>
<tr>
<td width="25%">
<a href="transfer.gif"><img class="blackico" src="transfer.gif"
/><img class="whiteico" src="transfer.gif" /> transfer.gif</a>
<br /><a href="transfer.png"><img class="blackico" src="transfer.png"
/><img class="whiteico" src="transfer.png" /> transfer.png</a></td>
<td width="25%">
<a href="small/transfer.gif"><img class="blackico" src="small/transfer.gif"
/><img class="whiteico" src="small/transfer.gif" /> small/transfer.gif</a>
<br /><a href="small/transfer.png"><img class="blackico" src="small/transfer.png"
/><img class="whiteico" src="small/transfer.png" /> small/transfer.png</a></td>
</tr>
<tr><td colspan="4">This can represent FTP transfers or uploads/downloads.</td>
</tr>
<tr>
<td width="25%">
<a href="unknown.gif"><img class="blackico" src="unknown.gif"
/><img class="whiteico" src="unknown.gif" /> unknown.gif</a>
<br /><a href="unknown.png"><img class="blackico" src="unknown.png"
/><img class="whiteico" src="unknown.png" /> unknown.png</a></td>
<td width="25%">
<a href="small/unknown.gif"><img class="blackico" src="small/unknown.gif"
/><img class="whiteico" src="small/unknown.gif" /> small/unknown.gif</a>
<br /><a href="small/unknown.png"><img class="blackico" src="small/unknown.png"
/><img class="whiteico" src="small/unknown.png" /> small/unknown.png</a></td>
</tr>
<tr><td colspan="4">This may represent a file of an unknown type.</td>
</tr>
<tr>
<td width="25%">
<a href="uu.gif"><img class="blackico" src="uu.gif"
/><img class="whiteico" src="uu.gif" /> uu.gif</a>
<br /><a href="uu.png"><img class="blackico" src="uu.png"
/><img class="whiteico" src="uu.png" /> uu.png</a></td>
<td width="25%">
<a href="uuencoded.gif"><img class="blackico" src="uuencoded.gif"
/><img class="whiteico" src="uuencoded.gif" /> uuencoded.gif</a>
<br /><a href="uuencoded.png"><img class="blackico" src="uuencoded.png"
/><img class="whiteico" src="uuencoded.png" /> uuencoded.png</a></td>
<td width="25%">
<a href="small/uu.gif"><img class="blackico" src="small/uu.gif"
/><img class="whiteico" src="small/uu.gif" /> small/uu.gif</a>
<br /><a href="small/uu.png"><img class="blackico" src="small/uu.png"
/><img class="whiteico" src="small/uu.png" /> small/uu.png</a></td>
</tr>
<tr><td colspan="4">This can stand for uuencoded data.</td>
</tr>
<tr>
<td width="25%">
<a href="world1.gif"><img class="blackico" src="world1.gif"
/><img class="whiteico" src="world1.gif" /> world1.gif</a>
<br /><a href="world1.png"><img class="blackico" src="world1.png"
/><img class="whiteico" src="world1.png" /> world1.png</a></td>
<td width="25%">
<a href="world2.gif"><img class="blackico" src="world2.gif"
/><img class="whiteico" src="world2.gif" /> world2.gif</a>
<br /><a href="world2.png"><img class="blackico" src="world2.png"
/><img class="whiteico" src="world2.png" /> world2.png</a></td>
</tr>
<tr><td colspan="4">These can represent 3D worlds or other 3D formats.</td>
</tr>
</table>
</body>
</html>
httpd-2.4.64/docs/icons/apache_pb.gif 0000664 0001751 0001751 00000010557 12141202160 017253 0 ustar covener covener GIF89a ҔTmG ?ktDӲ444hHHGNGZ6RI{Pp[on{{{ eeewNRR
~uWͲYV%l M'L*G;ͨpQ fՕe=hS]]]*71HJ''(](>;ӻȓlZ7w[21>Ej+`'Dפ
V5jAV1Kzn 4
Hfm7ۋ{NF(.d!_(S K<F?WY 7 XVVV{ x1kgyZ]`E RD `Y<"Jǿg
$Ax(aopq
8X:*OfY ɹƿ0HII?9?ƿHѕSf*rC< ~rf4x1]03K Nr1jiSj 7:U3 :]3X"\3._@@>X_cky u3w~O>Z U<d1l bov W,. ɄТk0P[`\WYiu|qBb¦OOOрr>T?b/X\Ǘ )ǰ GϜh.LկҴZhŻ~P! , H*\ȰÂ(I ŋ% ;)0QH6s˗0 @f81s.@cAȸB"1Cu4:E8bfʕf 2kW> zb (XЧQQ`x$*)И]s&h x.HY4V@;4.(t{ <z+مKm_@1\2A(V bWE"_Gc2i $\^>p]jF6^rq
PX0&E M͐@M4 . 4Ib]p@E3д1tL3 P ^Lqa3 J2?68VT!
3@WG B"9`XaB+&RBB &B0\s$M\H^ p1^?H
(rUMsϏP~`@|ӢA@#MF6A 5#4iE烊} ( @>sH|Kf/ T!H -=!Kh3i4MU?^D1r=P]Ա ÎX 0yJybdd xn|@}NW3@"; M] @30@ &`*J#0 h cC
y4Ā ` 1Z.^@D1ഡV <[lyy4t%A1G:̑6W<`(<PJz#V ]B'4 NUm?bYHTz 4 G)|m?Pͤ 1y.E ã8[_Px"'^r4ɠ՛,A35ی 3*l"h``ThfA"` &+ &R!2A3*"B ] ?a9O UEhWVu{h HK3"2 o (҅ 9Wʾ |+H>@$f6 2dF0
&0 ȥT4.H djB'C;Ͱ إ%.,H8H&D%# 4ChlERFM1>q& Mѡ,҅ `6tpaNAF< th x 4 N8hFQ=1!yAf]@ b9ua A8 S rzޓyt 3GA:xR A Oǐ@a{ @P)Y=uqB A\c2@C.yя?Q0X
l tO 1 y
B*дF(
pCjmt]8&ծ.dAPqc>%
6" ,jrCԧ[ 0#[&xC+Rg[Ѓ40
( - ,ڮ 4V Ah? $
:)&ʸ5>( * 㨑h*i*Mn ~qLò [! 7u%hB1!=
L(*41ȁfAfu@6*,c@ԙ @
`2
k7"QZ-2$IPP x1߈ =0 Q\Fk$|db8eP2 a@X Pl0"@c (0Y@.w +Bp2gp/4D# p! UЀg[da ZPAAB
_ '-i$DI[LB)@ߘ 7 D! O ^Y-rZn*pTM4I5g8١`@j[& 2 N gf4Fȷ}/A!ZV|@(nG)P+I^` &Cj Z@ D
$ \t AI; lflߡn>nnp9 Ql*d[%nv; =|` R4t D
QU-CF 0 lB;x_M*,§ | TBo` b; \|5'F0l $DXq8{D
[H 2$X z" "
"ЀT85`$0 O N/Πca k6l Tk@Jpjlφ 35:Gm~s1E <m1gHFn
*,@oʗ2Pd.@ ppi&
T&i` &l@%rL $jru@32~g q3
b J
e XP
e5Xz
1?gFg E7/qֈ18XhpWp>9 G5@VPPr%`&6& w wQ>SkrcPV ͐
qD P eez&zA6mw ~(dvmPz6{ E af hooXbP p
`J Ko^ @Ic%_@04e } VkTk@HD O@P @
6sAs:YsBy~Pp8%(GzzPg hXh !ȏ:! ` o L MbMn
P
Dx@`%ndr V@e&WT .Il_@ |`A9AGn7 '{S)InP×h\yo_
)f!\e
` b4V
I4jV &Y N JP yk
75lis6@Yz GXt ||f!&xuu]uuB 9H ' ]
PN40
y0
N0M5p $ lF
t@TZVjsП6uFG
`6z@ f !S<I0[pnnėWoo}:2M0=C)t@ bo
x
.p K:Ő 7<l@ȥ #MitH궬V)ou_9US3pEP>cɨC]`.@C06 ` @ =3)cIR8YsYvj0nem^zOI*0hʬiJ w
oz|}J8at ڭ9>`
&ۭEa)DGY
04k L 4;*@
>K
Pg0CkoFC `Q7uUtfZ`Y
Z0d[fk ; httpd-2.4.64/docs/icons/svg.png 0000664 0001751 0001751 00000001762 11141176336 016203 0 ustar covener covener PNG
IHDR L4 .PLTE33***+++,,,---333 ; tRNS @f bKGD H pHYs PIDATc`E Ps֮\x>L(m֯YtYz[7]b'vCDYׯ]t9&VEYXhzX$|yMjjd @MMey@ jRSQ >IE4/3):,"8ebG[c(KJBdh DR%E06$"PS^", ll*-a
auqgń0[B҄#BZMt!|An6\Lx~f^/7{[SN&5`|3 0*)@}ݜ,MZU!( t lh d IENDB` httpd-2.4.64/docs/icons/ball.red.png 0000664 0001751 0001751 00000000441 10671421551 017057 0 ustar covener covener PNG
IHDR 2o5 PLTE33f ֹu tRNS @* bKGD H KIDATc0R0P0Ȩ
a
2
C*.P+g:B!.0s]C1m# R,ʘ* VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/world2.png 0000664 0001751 0001751 00000000553 10671421551 016611 0 ustar covener covener PNG
IHDR 2o5 PLTE̙ 3 f3 tRNS 0J bKGD H IDAT[]
PZȅ w&m ;I6Cs%'Cxyy@4 PwFnpq:zTjO95xL/!\1Wk ZCRbnĨ_"ZV~oa,4l VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/README 0000664 0001751 0001751 00000011764 10664776532 015576 0 ustar covener covener Public Domain Icons
These icons were originally made for Mosaic for X and have been
included in the NCSA httpd and Apache server distributions in the
past. They are in the public domain and may be freely included in any
application. The originals were done by Kevin Hughes (kevinh@kevcom.com).
Andy Polyakov tuned the icon colors and added a few new images.
If you'd like to contribute additions to this set, contact the httpd
documentation project <http://httpd.apache.org/docs-project/>.
Almost all of these icons are 20x22 pixels in size. There are
alternative icons in the "small" directory that are 16x16 in size,
provided by Mike Brown (mike@hyperreal.org).
Suggested Uses
The following are a few suggestions, to serve as a starting point for ideas.
Please feel free to tweak and rename the icons as you like.
a.gif
This might be used to represent PostScript or text layout
languages.
alert.black.gif, alert.red.gif
These can be used to highlight any important items, such as a
README file in a directory.
back.gif, forward.gif
These can be used as links to go to previous and next areas.
ball.gray.gif, ball.red.gif
These might be used as bullets.
binary.gif
This can be used to represent binary files.
binhex.gif
This can represent BinHex-encoded data.
blank.gif
This can be used as a placeholder or a spacing element.
bomb.gif
This can be used to represent core files.
box1.gif, box2.gif
These icons can be used to represent generic 3D applications and
related files.
broken.gif
This can represent corrupted data.
burst.gif
This can call attention to new and important items.
c.gif
This might represent C source code.
comp.blue.gif, comp.gray.gif
These little computer icons can stand for telnet or FTP
sessions.
compressed.gif
This may represent compressed data.
continued.gif
This can be a link to a continued listing of a directory.
down.gif, up.gif, left.gif, right.gif
These can be used to scroll up, down, left and right in a
listing or may be used to denote items in an outline.
dir.gif
Identical to folder.gif below.
diskimg.gif
This can represent floppy disk storage.
dvi.gif
This can represent DVI files.
f.gif
This might represent FORTRAN or Forth source code.
folder.gif, folder.open.gif, folder.sec.gif
The folder can represent directories. There is also a version
that can represent secure directories or directories that cannot
be viewed.
generic.gif, generic.sec.gif, generic.red.gif
These can represent generic files, secure files, and important
files, respectively.
hand.right.gif, hand.up.gif
These can point out important items (pun intended).
image1.gif, image2.gif, image3.gif
These can represent image formats of various types.
index.gif
This might represent a WAIS index or search facility.
layout.gif
This might represent files and formats that contain graphics as
well as text layout, such as HTML and PDF files.
link.gif
This might represent files that are symbolic links.
movie.gif
This can represent various movie formats.
p.gif
This may stand for Perl or Python source code.
pie0.gif ... pie8.gif
These icons can be used in applications where a list of
documents is returned from a search. The little pie chart images
can denote how relevant the documents may be to your search
query.
patch.gif
This may stand for patches and diff files.
portal.gif
This might be a link to an online service or a 3D world.
pdf.gif, ps.gif, quill.gif
These may represent PDF and PostScript files.
screw1.gif, screw2.gif
These may represent CAD or engineering data and formats.
script.gif
This can represent any of various interpreted languages, such as
Perl, python, TCL, and shell scripts, as well as server
configuration files.
sound1.gif, sound2.gif
These can represent sound files.
sphere1.gif, sphere2.gif
These can represent 3D worlds or rendering applications and
formats.
tar.gif
This can represent TAR archive files.
tex.gif
This can represent TeX files.
text.gif
This can represent generic (plain) text files.
transfer.gif
This can represent FTP transfers or uploads/downloads.
unknown.gif
This may represent a file of an unknown type.
uu.gif, uuencoded.gif
This can stand for uuencoded data.
world1.gif, world2.gif
These can represent 3D worlds or other 3D formats.
httpd-2.4.64/docs/icons/quill.png 0000664 0001751 0001751 00000000511 10664777241 016534 0 ustar covener covener PNG
IHDR 2o5 PLTEfff3333 tRNS 0J bKGD H oIDATE; ᩠;&^ `h}$*&q/!o!"xgOJs
r EiAt)- 7 kʘb3m+(\7| OT^HL+$e9 VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/binhex.gif 0000664 0001751 0001751 00000000366 10147723030 016633 0 ustar covener covener GIF89a fff333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , iH0@$YjU^+`Qߛ<[@`((&hLb.]|@ s;"".Ͷ<ҝh,DC6;M ; httpd-2.4.64/docs/icons/dvi.gif 0000664 0001751 0001751 00000000356 10147723030 016137 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , a80 @#IjU(R'10:"(;Hhã4\6eOPʂW}es4<rk$ȞW~_ÈW ; httpd-2.4.64/docs/icons/apache_pb2.gif 0000664 0001751 0001751 00000010212 12141202160 017321 0 ustar covener covener GIF89a h.mUontNLLLMt @uTUU_U̫R'Y|||4B6Rjjj[ʅinJZ~˔WZZ"orsqR: d qP2 .8l(7#Fŕ\2nXƩV(D985=6'?gV4ssszEwE###1ؘUס
W&Rqi$5$WsƺWO7D Ju%_n շXCGĮ >ľڹ+.HDgC>!Jf:ŹwG}ZL V-bQk&Lؙp]AET.ei^AK>RM^`a S0YG[\LFD37 ^K2š8W: ~V@H֡\Nק°1E}GUe?<Ol4Q 0IOVڼ.Odrz4Zanu. LBBA4 9q^C<U? #
W,ڪGu{meԴCt>fJl(a]@BNVYV1h-N-LqNMaeE,,,{EO! , HuXe#J!2Ǐ C )
{m]!O<>iMbi kȳѣHv&( TٲqICc]%%(ADǪ]a{8`C7>;(TCĚҞ [_ *Iz4b @ą
}
֛Ϡ4 fxTj!֤-x vp띒 R7[:e ѠR ]OAB4 3
``iDC%!h=5PT'
=?|wr$(6W
CUi=L 'PxDF!
p AbO?D>SOTLSNnAG~TB 4!
r-]t^d⠄jMA
W(P01UdO>L2Yt[a , I$
h0BMI eBЀ?.0eFfS-
1!TydtJ@ s=4(
pY] P %
*n@AeU =0ULr/q hj@K3
UkKVLbF.4 j
t@LLd<Pź
4?/"*p!=HcOv= A!B@LPD( fWS <' p gZ\$wB 9$ܕ&22zxم4) xk@ :PL6av`%-ΈU d[SMTET٣ 0!H El-JW l3`ABRŘV LwY̯ 493^<P+?)0]\!Tb%}Q5We=Ega TE6.p=LI ' : Z%l:iT8: }]O - qV6i''&FTq i AQr$J? K:J ǐ
A$ 8 Dw/
p@X&(#` U rp`0Q.z0tf=Q) =PTC#|"9[ E p p/`R,A-c-H]*+A"61 `?3L2[(*B @x\1gx_K<D௯BX (Ƞ* HB;&: YB4G* >8P:$!
KQ3l"
RR˃DKhSN Tj1vlB>xO&08N #fp8NB(1` I`LI2$`D%gB -pM$$=[CG jA:B7V (@>P>
UPA DR . 8!Į́k lQ}eaU+mq !\CH!W4e&$)L1&b"p\7 $ pXؽ qox'RyAxX PG-;
.hslA F]: 9/xs ( Gr``DD0~q
D;8&:4X@2@
PGHL
w /L*Wi\=֓
W08@-'-86yh0
eCYʩ!Q
1fa$ I" hʦ pc${@җ1BN @"RuR7D d&Sgme,w$وMe |2h5`d';ѦsF0V>'` Z a3H <k8` &(A/<҉eD,: >B [ :͈ԁA
:DȪj& r p 8Gx#XRЎZ,\*f rN<H`x@3*g 4 3@ bp H@B4&}F`(D' B!+q عnq >{ U#rRxo"ځUP@-Z
z5K|a X9 =)3:2`5 _C-8 ppnHpc=aAڣ{i{ގ' 82 v2#O]*`
ϸB*@Oa w0C aA:`lJT3:`pHw?zQ s^b?'j` q%b0 (bcMЃ> 5 c5``@pcQF~RGkV8
!PAf%PtP 03 @3 3PK䆦b04wN' ` *TЇ 0KK/bЈgQ{'
! -VGiHPiM$Q~M~x~^WhS@ڐ
:
jIP$Z C{D6Հ\%Ca_ 0
_ Ka` ((Pn
n(&o!}b }Eiv icHH?v]N@r!wdUq j4DDq` @(mp@P*pC yCp5N0
9 &?a&b
d'iP ˰v!}+pX @}}b(d$0x1 EVxdTV9s ..
o>
)
z@4PyA
d @OxH P|QٚfvUo!\bYayhP 0 !PP ]qqPVeP
)l@"P; .@I
FP
@20tp0n2@0n p
)
p
qxP&(f'!}^GccL8pCsٜHkYX(U UG ] zWЗD#F
PoP
@
qDϠ
YD8iv(Fi* w'!w9iQc *d77!G'je)jHU]AD ]PY|!g 0QyPJjZM0H je p:3$@7pN]R|W
a
@ʺڬ
; httpd-2.4.64/docs/icons/apache_pb.png 0000664 0001751 0001751 00000022733 12033030440 017271 0 ustar covener covener PNG
IHDR 2`C sBIT|d pHYs + +#W tEXtSoftware www.inkscape.org< IDATxw|U?II!@(
qU *E\U].s{Ϻ*͵(*.WdEJMf&۷ dy^"sS9;<9B)υ'x"t^ H+77wj7|G gÆ
7 /Z.s|Gc
Gߋ\ N>=lϞ{L 租~l맢Jpr˅$e?n#BLgS`Yop W)h0cƌ333MMM-[\tud%3o|W !l]G0 BBn'uK/z8uvjuKﾹtʔ%D3h~RZ?˗AcqE~;y&M/7x#.8qbŪU. <[ZZZ1cƌC?|> ̛7Ҋo 8z֬Y3~~ o鍊nr=WN:uϸqz^~ pr;&Lpdܹ/=se z衉;f̘ybbL@&WZǏ hɒ% `
/V\wu_ ϻp_V\tE/Bk a#klll}'{֯_eM Fg,1#Xaz$5z6n
/&nij&>J
>ٹE"..ίRB L$ [ q_xGrrr+СCxy1999SlkllVrdEEEkhh999{WL6m:Cmnrݹƍ:oXccbY]YY"d+V x45NR^^~O8 6?kٗ_~СCcd2MMg6ɱy rwvvjժ`eeo??innUQQ1n w_# b
M$ O$<C;1Q9QA2BHdX.a%ߥRRR1;ȓY.թgLlީza
{[^{볊n"` kmO8feeǘڅ<cΜ9Zꫯ~y 9rdƍ& O>p8
gϞ]%Z3όioo5L|ii;v츧:g=>˗O(((h)// kOԫ[u뭷~7ק:ukx ѣ{7oȑ#cd2-[sOln=| ܸxkl6p :tE]~aaaC0d/۸q#v'@JJs|FwAż% }i A 7BxRZ푴\;zIX~5P'=\24!"OgciQkDwd(5fk"" M+HTۢ{4qʋḲ *Y0X{W Z._yw6nܘ/fj_ mN8;;y½{niiO8q[fff) 7n+V͜93 "}W7@8 VQJՕvbg}o?y_| z? 8NRNL$ ɓ' F}l~3 عsgCkkdo7o^_Z]]=rv}}}h'NzF_s |>@}I]t۞Z]n~Rl]q]P"֯$vF>~99% KˢxzAX]$s8FyjSEoX z̙3kk ,PH : %N4i攔n|RJp`0|<Y & <o X,&Fh4j5LjpF՞) ѨxƱcV3 CѨr{ @&Ed`!?aߵɓ'hWb15ʕ+Ѩ0)`N|]wizzYOɓ'
`^SSӆgRi$ o[,((`Ag5E/9fR PQO '.1u~VQiK`H11 T*C^O3!BB),,<l hmmIIIo-Zԕrp(y >>>:qĝ-Eь 55u|b,{RUP ##}G79պz" D"g20>/~ L h4 xG)**jE
l#Ӆ~0CҲ7peee
6H{a].פ^zipȳ>q3"6 G!Hx5>%B"ha뉢˔aRKN
f?l"Y*|E͇t٬}ovٕW^USSs dgg `XRJ;'==n-۷o?ѣG l6oʔ) ѣݻiW]uf2 7t^{TeYYٌs
tvm3oܜ}}}ׯݼysYUUg20wyw}?tP60f};vLLL M4iÙ
#SnLl0x|ׯǎ ;"
MvHIB0
ڨYba ~%&r{ٵTgIBQ3C6:$.
d FKD/SIl]ORMp<}"W 0f̘ۺu3f } ;vL7eʔ <3_eΝݲe BNyK.s0 cǎ?㇎Ϛ5k <#5eee>?l6͙3g;s
̴i566vuuse] v.̙3w>ǾF>B%f>)5mL%qOtvu(,&#qtۥÇI@@ t)2x]Lϒxx%$maXƇVG\'BEyF;LIhv/b4ii\gٟŬ21bPt~kwYSŎuvvtt.5 =~ {;
A־;N?xqkk h_<#5 p/|O=Ԟ}jժ[[[KbtO< ?:;;s333$'' >|:FK/}p]˗/?l6iMM N7vط~ߜ<q#eeeŋ-Z9xz3ko[T8fljv nK՛R,[6F~5FˣGlU Y(4VNU<fdش~ #UAfB;C0HTHi[%c{ cbhJ-.GH5IR Behe.cqZN.mWj]Vs+VT;_߽W^yŤ뭻wo<ܶ|˖-u>5K{p\j%|=KpJa +ђ kkS ;3|fEU:CE/5}@&Cʊ+f8I
7,Mߩđ^$4ЯADk";DέF ),9* KOfr=RD#K1|lK8Ĉ8dԨg UXCTR SvJ4;Vm"WϹoCM_4`Ŋ7Yf˲[~7_N{5Ӗآnԙ-DRł?ˀy9Y]idY.^JXk.J Yqi#(6ג}ޱRFy t!3 l6enϬC̯Gjv/uJ3j=4_b]ToLrMGUrZ /= SIgɤ,Lp9I <m:Uee݂"kRˊr2|b(79ݵ}?E
/;;{N}k0 se١*
[m]\'[o]nef:5@vYE!EY>b8"C%ԠiW.s;xEX:檤͎FV$ ]"12QN* t]<x3##3 C6SbaZG9tq,W tD )0=
bkx´=]T%%z Sj>$51=\ $ՍZt ⛇[~QDž J<
Co }~Ϣxs@R4]ڷ/dөJD "rR BqD'DY+ *a@.CVjo ;5hFLNH`e,vrhc %^
YIzM]I`'j(IB?P+ 1МaRSLޮLla )De Rvkbg_Ot,^rcg( .pW^́_ $EъB?fL<1ev
g[:L?u(!@/:Dg$5 {h97- W4 f q LD | $ X @5@}-C7'XG},%+A1oPj*C>A3Z>C q
I L&+E_xꠚ#DJI dC0xZ 2"+AN;ШgP(}g%1BÕI+&y* 2I!C11J, n3hW<z0ە3$. >MF ۓTN1A舡KI
#kiΨ eK[3 N1{( tnV&] -li,E ǮCZ_
q0NcLx
'
(=z MsO#-8xf p H >+j%^A ŀtdOKLHrE !Pax ؆{D肔ǎ deU(_@ڒו_= cFJ F&0UOD]@64,xJZNNRȦa J.xiζvVjEjLdT*3QcؑrTz#SIX 㔡UԶfP~ΏE2?
m*EF-$*X5gi7귤OMQQ6,Ø1ww6P }<xj1A:gg m ŋ)No0c2 u#Ni r|R;|%$% w zi @ p PFG's7&IFj ML{GM&g:Hi+zS(hH_2Bd|Z/ l8g$
D0<zp CI=EU3Dج"$y/D9MNv e c0,R$p\c!E\ j^U.I(ҠΞ BY0 n15 =bȞ"?T~\_1
YlI3FpQjJ[ '/7Cm3X0P^men T^ٻ=AZLp Ft@ Yt=Eǹ` \~* ^@O+Gi* sOL3 f J hBZ2 nY}1R{')A6 AO8&m )0 8{BG"j PPPp$I 9+;vDkJe/mx$ e5 ?!hD όF Kh|T,
ȺҺ]ƴ$FNxStb&L+eYFj !H :Iu M@4"D,
o4p&F GLfrv d${W&K k2r asr#V[\P1kI31DKN";k.Ou3?{y]{vϦ$E70g]Xp \: ;l@/Ck !B O[
#wL9 Y 9}Ic@vq( 4H(=q`cҙRWW7e[$IZ.Mݕ%Eds'^8$9ۂؖ 1c`GnJfɥؒmغe.FPdU$]T MB,W&?$ɽz)!&v0a+pd'7 Ea/L*. |$$I ^* j#Vnu2
w#$zQ!Sؓ3PeFjC|8^-hȘ$>и lJf|4pOFY2hj^~Cv(mz%p 'ZJ`y0 [KXOP`gF؎bq"kJ AA/ȳn>w)}7Nz
hg,COz04 b#9[d=6TPېN6 iHϡ]@ ~"wRJs}.d- Qq,٣uQ!s[XQ4LV(JUQe
DY R!I>eRFX!1T|":%Ԥ(nFb8h4SR1HE6QX e" ȃ0T^ P&SOR7Qq<R@, vh,L5Ri<+-*%#cMhwxųHQ&1̎XtB')I]h,]nS ! r(`Z n%TsZn3 : ;\` 6 ]L!d6Hr O]<! K tЅjE4 Bp> O ;T?h0 yyy@cc b2t3܁q[nrC;[b 8@e[CQeJ4}ļ=NVeNAuNhy2qrC=dҾ @( ~ .;צ_ݘZ8jty,yf}1|:6bT-bR ?$ae'$cR%MĔ:%U]W"TY/ C=AԴ#u 5 ժ8IS)b5'Kq?
snVY{+%L C ,; :w$E [Bpx-ŐC~ΆCRc CA`n8 ) G H@VO ] d, ؗ՞OG{r+!výmDCeFլkYT<4g*u2{IZ)\~I1 %Mwq$G>|M>OU1+@S'
L<MT5=y /}!*(*DҴ 0TZ2< 4'RԂQ9`BEr17mc]"o[1?8FWd,*)ɥ_ݱ#C-Ip%>à* x ?\@E_
#f(+w
\`yc1C ,n_o p=pCA'aad~Оp& !*违C]kPx>8vQ 0 FJ4@b^!Wb燃
*gi<m]H|xü&2+#>P7'1#8v61B l 9m4 f=ݪ?NbL)& >$7)+;Z05 LIDATߤe19j7ē((tZN
]JP=<[}BLX#Y:c}+cAVw
n%hpyԠcܪL &9s 8S=+fF1$B
P
S'e@t O]!H: `p P }v!t@!Ab%=g0'0Cű d` Z 0 qB^EVnIioäƤzsxIY t2974vĨtPDjoTpQW e:5ti"W %f
=C5 RP f jQm8FM5$Ш n-9ϙR(:Fg$ f!yT#-Hzd!;gzaWsss ?"V
N]?WR,CgY3`ah<@o]rD m^6L' a }j@42ˎ`SA :1?Ah4Z*IRZ
J+ LJB[ xfZ6MIUa_[c
).5bNM'Re4q
^8x>pm{JT1:=V_n=_%MH64{iicJs>FUUxnWVOJfī='9)CM 鶱*5W$8$I
1 ى $x7
ܾ3 0`zr_nj ;HD%gv Yj, ;'' 8sAA,
)`8맔.$$I0$ Ra B6B(^Q=ad}2DsLmAOOZ$3
_DE
vR@
pFi77 @ |5uB* tSJSB215b
/ `) %tSaa wK 0{Z;Ϧn$P<1DQ
\wAK
o 8?0DxOS|a@z I_
4q =A EIQ*E1R/I ! KSJtB$I}w1O)
HG)M" rA8J e]Xl'4N̜" 9 %9mp:R?~-m rN (vmavkϭ/ |d0'0
b6<V) : 0 S
tVW
Ƒ 2RQARr?<(
yz ?ż
IENDB` httpd-2.4.64/docs/icons/apache_pb2.png 0000664 0001751 0001751 00000024241 12033030440 017347 0 ustar covener covener PNG
IHDR % } sBIT|d pHYs + +#W tEXtSoftware www.inkscape.org< tEXtTitle Powered By: Apache 2.4 *tEXtAuthor Daniel Gruno [humbedooh@apache.org]% tEXtCreation Time October 2nd, 2012٣ IDATxy|T?Ͻw%Lɾ
(kŵ.EZZ[k|AETp/ 6} 6 Am~教9<99%~,<sqmmm1&GDDt~hݾ/n_߿?U_r hn ㎪ B!4 @' fC>Sp+woԢݻkm)|_9yoڴ?}CʢA N pHj㇈ Š( .#Ƙ}X x 3Z$uҔE\y _|ִ&ӦM 뮻&?G3<st笫 'qy@ .˒,a>o p "[pmf^:Wcr&̎ϼeٲEL) g*fbG<s\jU֨Q UWWO=!;o2eΜƉ']o.l߾]po
|n{ 7to
o 瞋;wW͘1ӟgu]ǂUV8cƌϳ;`Ŋf̘ynnnرc+.5+WL;v1_|999&M>6A%??2//r
<pOAAA)Sߍ~:w%ŏ<ߥ1`*c[c z< W 2g|뭷f-# YeDX"45d~TL\ rԹd6.moxH5md*b\_zY`m Ƙ4/Z(j*' Hzӻccc}EEE^7? MjhhȱBJJd N).. kٶ\ۺu;w,LMM6L;v츬9?::zC=Q\\<1lIII L0AXzu̇ ~aeeeѣ$Ilٲ_xᅅӧO??lݺ
HJJ2y#u'˲f,//;ldϴRSS/pGEEyM&#ms4wgJKD< f
siii{ {챮M6Ң<
,#O s Mb0t_"ʤT* ') J h>j3 6/6)˿Q.}1/}.xAZtJ˲kg͚cr.O6mc=tc(**W_EFF l p8 cƎ [jׯ_ <tttܸgϞB̛7ow{`jjj,/~n$%%}cǎ***k}1<OL,++ .\sŦl=Sr]t w}C(|ߔ
&@kk$ HMMW$pYc= J ==.O?䓇_~eڵk p
7ȱ =Dg}#k:BK 99?0B
4r hW3t}AH_ݚuS-5I_ (W_ j<gΜO͛i })ʻZZZUUUϗ^{mJmmml~jnwvyy%555mf^$IPՁk> # l+77w{ｷ . < %IBSSSFp -Zظq .;[Gk4 ; |v֭E ^
222>ݵk]]] cood HII||q
n=s
c(܉7S(>7lؠ < /d7}P[Qw7h9,4:"F=
fΈp J4ZTWW6٧Ɍt߸P]R;||VVe'p_>}|UWfٲemڴEI$^ j "##[t:6\y_edd4766ZZ[[t:yZm0*fR4}t7@ @L h4Iq'YP(d `0<bt
1NȺzG
D J Y5 0{GT]] wkkkcLH>D4 W p:^! FD (7'-I yްaCM@ pukke
KoNUxQι26ڤ`aesr"C ǣ9^BJ3ag
8bJOA8i
xX.x W;;Zi}}}) PZZZhRl.E1#_dff ڞ~ bbb ln j ̙i lw5Tի U*\.jjj8?"'F]]h ~? Je ,Z(o~Y^^~gEE I}ٲe #<, ,!j pclA/ F>)KKK-X`W_=ĴvZ{n/#..LRj@Pg,fIJX-JvT0,[2@I~ԆD;)Pc|݂+ao*ŮvZTxo41
,C0k֬𦦦i ?99y lo \cǎѣGox<"ݻSz 7>T^^K/_nݶ@ zG Z855}XRRrܹs_(zQz·~̢ceeem۶|cJKKG\$2l9s\~С U|B~]wlݺ5 O ?
+- c!| k00# Q & c쌯1oTUUUe˖,?2 FDbuy++GCɮ]gzD^}'{Fw;{Y{Y5lfv){S>y1T}[gޛ`Jm5*OmS)B]yO"sk
wM9c X wq I:N&N15k ظq
ҥKo9 f6>4N v{j\}Ϙfഓ&Mj;!_dɝ^ LRɷ~J
ޏ>5T]~"ѣGZ*}p &`iii 7n4/Ͽ3^ <6̫xG4ye
c g8gΜ%%:>Hddv- Q&
U/g'@zB 瘞 L"ˣCSBBxW 4s*6?ryp*ecz]
=!\%F.E]֧G ={{n7g0 `ҥ={z:up YK/ձcĨjOFFƮ˗ &`04> |WXtZz}q<!_n˗/ _õN{7c4뒓_'IRhVXqZ @A||֗c N ՟a`۟Nw %KF?U)wuuvwaaF:[7N~tɭrEO) n; VTx f hBX)+d c. <EɃ >l 6'$>%vC";\($ dP!Sp*B@'CIF!9h}o,3_ ?z7Ƽ;s:nW^y˳'=y~*/GpJRsD<gmrXﱎ^<gnUD!c%mS"9GX:xYv@U3. DUQ:&3A1Hor$#7cAhʫrOf>4"f sP3;8 z8R" TsjHvs@emGcYo߮~{JKKu(b֬Yo|Wwz?3N N%|WfVfV
.x!wTfG㾒d-OuATeś4U{*-"|RXmoZ (y5³ "RSGyIMx ua#FfH
~ NI}9V9DRM2G@ d(>dn9SQUve}>ii+nNq}/gW;~'3
djwJJ1cƼCt,8R16hyB<5ʪZ;dRu ^`JSopެp9R22IǷy$olBX]W5/IM:
CV}Bi\qcq!yaETL Ə6!<2pA F9"=AT
n"
+凟IrIb ˩v:POlr}A*ѻ}a!njZ۩`/Jr
~"6O`o^/;JD!
(XA!-F 8REARnwuMSfϘkw].2(z1(~t$KQ " B[08f )z.6!
^ ;N %J+K& $d`Qj4rj4,Sۍ[I3YUI~6r!T$㛂PkH\EZ-mznr]x#zNa*$ v17iaڱ'aG7s8/ T<l/!r79Tz4} ?#hRnK}00/w)&`0% t
0P0ZBFA˕ n B, ; ^W 4T (J cz7 {I- z#Qf([=ueN
. g4
F Ic%gdd<P[_R<V\[ϵe!",)E_烁$@>,vUj֤H5 ]u4 k6J
v= <*3&$94Lo!F+SOKcBo;̍mr<+YFZ=*N+X$TkCr9˨wI7 7[3Jv$t`3j%. U$[4?ٙk:4ƪ1{3 wp%; %Y0CZg ɯ<u64< }+ŬWp, .0hYH ` 0wS
>/.bh\Y ~=#d%== =5u; YWn|m [J&c[D$1YFdc@ʂ <)%K#t[y qOf^evX[w 8~F~s23R "bzF:uؼ@JT ʢzBQ#sWkEj$vd !.cu♔1\|h'$'ϓJ &s c3J
|\$䬋ViKFuyBUvs 0m~./I AV ɻ ~\=Y/礌uO-Nd0! ,u ` ( htsߐ233+ == ݟ;bϕ}vir(SHjp)Z, Z NQr$pehxQ#URC{R+OI [-xպfG3;> "DkXD0Q
z,)a/qi=zr"*c|c 02qyL9ֻlJXߓ|]XXK2fӉ_ɦ6Rt2rH t\sF5_m}&++kۺZB/ozsR9`-U9! Q' <- J n5Cx'#6X@ޗ)sWWAO=uʛ7h0* ~ ߯<c>Wlt³y[lD[_ iiiN Q RƮn8Ыlsy+J(
hS[V .(K~>A-;|3(@d#jM{s/) ɍ>-MMF*,(
:¹Heh4𑂁e*#DZ"GYF lRi@q
$q6Y(5$)%w[Ca m8J+*3_9?Iya ]a[6<TA!63\ + yf,aB ÷>F+0M r iS>9EPA ӝ }#`[ι@ f ɞ3*OU Wн>tg zvxfhy}(#;ddd<SSS%qbJhtVٽ{< 1>UU c `dmr<d5 t1"ՂDQnQQAȉ =$j
6ZJS IT!1A"edPx1_;cG(R _Aȴ^j #>>*BRZPH"zRĢnxۖL\JVi9~fQ!^oHk q ۸?eyS;pO ` y|MT0S6T? 6@8i h`@+!|'-ۏ+aaw# ] {ʜ 燽 [sX ncN^?܁3C&}{1
V z+脼7^G^+5{ڼ 6> G$kWJn!hcJo
]r#!7:1SVj07$uA\˄H?wJ܁x#.j
pRM(6U1mJ$̵+u`EᛨDxnTcLr($쯌)A7>x}5"H4`Qs4,>.1p:Y
Eqm@Ū0-3tY S<=ˮ,uLmGxqu0w3@78K{y/ 6ijU;b* `ܩR شƬX)=9?u i `s 6k|t[dK>dT|O#o۷` ;ҟ pm+ wqoWY~ T 8vOoĐksYq_g䉵!5^ w+C$F<B/H!dx>B ^4q)vuK+م鍄05y'i=\I57OVۂ &%e<܊3vfXP ~X(2h#R> |i]nlsp<7Ղl0hPY8<qdHNLbjR gpﰾ\<3ۀ1=8ñ<2 ,#0`#gПV^#r @O`0`O<`+=S !Z;$VC<`O2& Fp*"1p=E;]Q 뗪3+PSNYuHR%3˨Xډ> H2!κc"(-Ff'ej1 IDATډҭV@E)'xdƲ: GU |_2Ivɗr\t *t{sz'[ps>Ą1AaOZF^)x;yL^`(4q 鑲8ɏzWmpsV5:&5?Sk,!I iw0a*) 2s1|5\" ߝc `Ezb@;1Km`/#ɩ
eASCƟv]Xw\`qv48['I˰r9)`-1/Q}OOsZ,3[8kP+{*ߡ`P)n\ \ 4h Ĩ2JE
tz$VgF^TAMshRRx_ 6n'/CjS+1N!I7B[f49qȣd:|M / 6mX3rܱRQcrbѱG]r{ߙ:4 `z߿ v/e2?Q8>m9ˆ! wT
h^G+#@*n<ؓ}'Z b/khKJBf6k# Q 9=O$ITWWObM + "< m$v9 :`hh\@Tȣj1AʭA
̽Ï'j$#_熽Z2wюxPƀ,,PFGb awg2k
7A'2k& iY6^6 `̡>A+Bt(Rb0,^WT
Ft2:ON~Z?33s'aBS*)EQ錂YV F y +{ F a`uCf X \-sAsBR>B30
Ħ4 Z ?E ،u yӐ SS8W?84RLT(d4Fq,.)7T ,1cq1s8ͪҮ .yv]m
/{5_T\Na>91 IޯTvHN'ű}z K>믉GrY6as"9
blg^ LfeǜƤj7vKBqŕ t$$5 c
qNz ٰa#܈%#Co krq6C 4 ?e p!iP f p; \%O8߿ٳx] е*-O/#sjkkS}>KPnw^q\,F& e9q1"eYfD$ma+XvIwt2|.LjJneohqTWӳܮF^&K]o0 Hb%Y c x 舨 @,E*ꝤS+70]6c(f#w
>z[#zzP+Fg h%H_ !,[~H
_2O3r{] |wŏm]/pԤʲT*@ v܀r w c^"JeY8.
1v1#"c^Ƙ<1=EQ)OZZZ TVVJ6Dt%jZߟQ @< yaI&v'
*NL#id4dMۍ௧gb z )_{; J ߃!cniд "OB F10Nb^ `N *p48{xxH#:-փGKcI&.pu(RTl IENDB` httpd-2.4.64/docs/icons/tex.png 0000664 0001751 0001751 00000000466 10671421551 016203 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H eIDAT[m
N
db # 4-e 6"jjD r^ASH< +SǠb+؆.\{m[v{W۵' )c VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/hand.right.png 0000664 0001751 0001751 00000000467 10671421551 017432 0 ustar covener covener PNG
IHDR 2o5 PLTE̙f3 $( tRNS
A bKGD H eIDAT
C1Y7 X~aXiR$TWȟLrڶ IZ6p`5$-(նXIVcl\
W|cײ /PO M VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/right.gif 0000664 0001751 0001751 00000000254 10147723030 016467 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , + ⚀QMZy}ReHjf^lt=ݸ^ ; httpd-2.4.64/docs/icons/box1.png 0000664 0001751 0001751 00000000505 10664777241 016262 0 ustar covener covener PNG
IHDR 2o5 PLTE̙333 3 f3 tRNS 0J bKGD H kIDATuΡ
0Ӗ&
ve!{^7 ×)ӄ%~9;gF dW[NXscS8
Sıl/Bl`) SZ$fA VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/sphere2.png 0000664 0001751 0001751 00000000523 10664777241 016761 0 ustar covener covener PNG
IHDR 2o5 PLTE33f 333 tRNS @* bKGD H wIDATU1
0 @ѸO t( %PPMG$p2"1͠cK;yMvZ˲N<uz垸Bp'$C\ [Q'{ z-C VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/apache_pb.svg 0000664 0001751 0001751 00001010327 12033572341 017314 0 ustar covener covener <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Created with Inkscape (http://www.inkscape.org/) -->
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
version="1.1"
width="587.63806"
height="68.379463"
id="svg15391"
inkscape:version="0.48.3.1 r9886"
sodipodi:docname="apache_pb.svg"
inkscape:export-filename="/home/daniel/Pictures/apache_pb22.png"
inkscape:export-xdpi="40.103409"
inkscape:export-ydpi="40.103409">
<sodipodi:namedview
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1"
objecttolerance="10"
gridtolerance="10"
guidetolerance="10"
inkscape:pageopacity="0"
inkscape:pageshadow="2"
inkscape:window-width="1855"
inkscape:window-height="1056"
id="namedview1253"
showgrid="false"
inkscape:zoom="1"
inkscape:cx="293.81903"
inkscape:cy="34.189732"
inkscape:window-x="65"
inkscape:window-y="24"
inkscape:window-maximized="1"
inkscape:current-layer="text5115" />
<title
id="title4227">Powered By: Apache 2.4</title>
<defs
id="defs15393">
<linearGradient
id="linearGradient4225">
<stop
id="stop4227"
style="stop-color:#0400ff;stop-opacity:1"
offset="0" />
<stop
id="stop5005"
style="stop-color:#9d00ff;stop-opacity:1"
offset="0.125" />
<stop
id="stop5003"
style="stop-color:#ff0086;stop-opacity:1"
offset="0.25" />
<stop
id="stop5001"
style="stop-color:#ff005d;stop-opacity:1"
offset="0.5" />
<stop
id="stop4229"
style="stop-color:#ffa600;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3510.3682"
y1="4186.3037"
x2="-3520.3882"
y2="4153.2837"
id="linearGradient23811"
xlink:href="#AIgd1-0"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,-2022.5977,2980.6621)" />
<linearGradient
x1="-3510.3682"
y1="4186.3037"
x2="-3520.3882"
y2="4153.2837"
id="AIgd1-0"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,-2022.5977,2980.6621)">
<stop
id="stop170-2"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop172-11"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop174-6"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop176-4"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop178-9"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop180-5"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop182-5"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop184-2"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3788.0986"
y1="-3507.6162"
x2="-3789.1638"
y2="-3479.4058"
id="AIgd2-1"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop193-9"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop195-2"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop197-0"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop199-9"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop201-4"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop203-2"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop205-9"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop207-8"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3817.4316"
y1="-3498.7192"
x2="-3818.3076"
y2="-3475.5176"
id="linearGradient3725-0"
xlink:href="#AIgd3-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3817.4316"
y1="-3498.7192"
x2="-3818.3076"
y2="-3475.5176"
id="AIgd3-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop214-9"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop216-7"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop218-5"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop220-40"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop222-49"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop224-2"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop226-3"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop228-7"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3806.9058"
y1="-3505.3105"
x2="-3807.8401"
y2="-3480.5605"
id="AIgd4-46"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop235-8"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop237-7"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop239-22"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop241-79"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop243-8"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop245-9"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop247-2"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop249-9"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3817.4316"
y1="-3498.7192"
x2="-3818.3076"
y2="-3475.5176"
id="linearGradient3727-1"
xlink:href="#AIgd3-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3817.4316"
y1="-3498.7192"
x2="-3818.3076"
y2="-3475.5176"
id="linearGradient9145"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9147"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9149"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9151"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9153"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9155"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9157"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9159"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9161"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3825.4375"
y1="-3503.8936"
x2="-3826.3342"
y2="-3480.1453"
id="AIgd6-5"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop258-8"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop260-5"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop262-7"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop264-9"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop266-5"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop268-0"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop270-7"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop272-7"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3817.4316"
y1="-3498.7192"
x2="-3818.3076"
y2="-3475.5176"
id="linearGradient3729-7"
xlink:href="#AIgd3-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3817.4316"
y1="-3498.7192"
x2="-3818.3076"
y2="-3475.5176"
id="linearGradient9173"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9175"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9177"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9179"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9181"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9183"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9185"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9187"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9189"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3841.6636"
y1="-3502.4297"
x2="-3842.4236"
y2="-3482.3"
id="AIgd8-4"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop281-10"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop283-9"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop285-0"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop287-4"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop289-4"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop291-7"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop293-9"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop295-2"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3817.4316"
y1="-3498.7192"
x2="-3818.3076"
y2="-3475.5176"
id="linearGradient3731-8"
xlink:href="#AIgd3-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3817.4316"
y1="-3498.7192"
x2="-3818.3076"
y2="-3475.5176"
id="linearGradient9201"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9203"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9205"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9207"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9209"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9211"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9213"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9215"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9217"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient3733-6"
xlink:href="#AIgd10-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="AIgd10-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop304-0"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop306-3"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop308-6"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop310-0"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop312-49"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop314-9"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3878.0732"
y1="-3508.4204"
x2="-3874.5449"
y2="-3484.9487"
id="linearGradient3735-5"
xlink:href="#AIgd11-4"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3878.0732"
y1="-3508.4204"
x2="-3874.5449"
y2="-3484.9487"
id="AIgd11-4"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop321-9"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop323-3"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop325-3"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop327-8"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop329-8"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop331-3"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient3737-7"
xlink:href="#AIgd10-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient9236"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9238"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop9240"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop9242"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop9244"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop9246"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop9248"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3878.0732"
y1="-3508.4204"
x2="-3874.5449"
y2="-3484.9487"
id="linearGradient3739-5"
xlink:href="#AIgd11-4"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3878.0732"
y1="-3508.4204"
x2="-3874.5449"
y2="-3484.9487"
id="linearGradient9251"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9253"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop9255"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop9257"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop9259"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop9261"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop9263"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient3741-3"
xlink:href="#AIgd10-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient9266"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9268"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop9270"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop9272"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop9274"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop9276"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop9278"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient3743-2"
xlink:href="#AIgd10-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient9281"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9283"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop9285"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop9287"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop9289"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop9291"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop9293"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3892.5645"
y1="-3497.0415"
x2="-3892.7126"
y2="-3490.0823"
id="AIgd16-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop346-5"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop348-3"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop350-9"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop352-1"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop354-7"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop356-90"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient3745-0"
xlink:href="#AIgd10-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient9303"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9305"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop9307"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop9309"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop9311"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop9313"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop9315"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3747-7"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop365-7"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop367-9"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop369-4"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop371-5"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop373-0"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop375-96"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop377-1"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop379-6"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3818.3081"
y1="-3506.1616"
x2="-3836.2568"
y2="-3532.4282"
id="linearGradient3749-2"
xlink:href="#AIgd19-1"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3818.3081"
y1="-3506.1616"
x2="-3836.2568"
y2="-3532.4282"
id="AIgd19-1"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop386-9"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop388-6"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop390-1"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop392-0"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop394-1"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop396-9"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop398-5"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop400-4"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3751-1"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient9338"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9340"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9342"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9344"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9346"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9348"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9350"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9352"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9354"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3818.3081"
y1="-3506.1616"
x2="-3836.2568"
y2="-3532.4282"
id="linearGradient3753-4"
xlink:href="#AIgd19-1"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3818.3081"
y1="-3506.1616"
x2="-3836.2568"
y2="-3532.4282"
id="linearGradient9357"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9359"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9361"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9363"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9365"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9367"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9369"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9371"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9373"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3755-9"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient9376"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9378"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9380"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9382"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9384"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9386"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9388"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9390"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9392"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3818.3081"
y1="-3506.1616"
x2="-3836.2568"
y2="-3532.4282"
id="linearGradient3757-6"
xlink:href="#AIgd19-1"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3818.3081"
y1="-3506.1616"
x2="-3836.2568"
y2="-3532.4282"
id="linearGradient9395"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9397"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9399"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9401"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9403"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9405"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9407"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9409"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9411"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3759-6"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient9414"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9416"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9418"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9420"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9422"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9424"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9426"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9428"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9430"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient3761-1"
xlink:href="#AIgd10-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient9433"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9435"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop9437"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop9439"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop9441"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop9443"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop9445"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3878.0732"
y1="-3508.4204"
x2="-3874.5449"
y2="-3484.9487"
id="linearGradient3763-3"
xlink:href="#AIgd11-4"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3878.0732"
y1="-3508.4204"
x2="-3874.5449"
y2="-3484.9487"
id="linearGradient9448"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9450"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop9452"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop9454"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop9456"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop9458"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop9460"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3878.0732"
y1="-3508.4204"
x2="-3874.5449"
y2="-3484.9487"
id="linearGradient3765-7"
xlink:href="#AIgd11-4"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3878.0732"
y1="-3508.4204"
x2="-3874.5449"
y2="-3484.9487"
id="linearGradient9463"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9465"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop9467"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop9469"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop9471"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop9473"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop9475"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3878.0732"
y1="-3508.4204"
x2="-3874.5449"
y2="-3484.9487"
id="linearGradient3767-3"
xlink:href="#AIgd11-4"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3878.0732"
y1="-3508.4204"
x2="-3874.5449"
y2="-3484.9487"
id="linearGradient9478"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9480"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop9482"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop9484"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop9486"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop9488"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop9490"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient3769-5"
xlink:href="#AIgd10-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient9493"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9495"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop9497"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop9499"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop9501"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop9503"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop9505"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient3771-6"
xlink:href="#AIgd10-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient9508"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9510"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop9512"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop9514"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop9516"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop9518"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop9520"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3644.5117"
y1="-3531.5527"
x2="-3636.6318"
y2="-3508.3506"
id="linearGradient3773-4"
xlink:href="#AIgd31-2"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3644.5117"
y1="-3531.5527"
x2="-3636.6318"
y2="-3508.3506"
id="AIgd31-2"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop429-7"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop431-9"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop433-09"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop435-0"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop437-61"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop439-8"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop441-92"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop443-8"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop445-5"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop447-5"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3644.5117"
y1="-3531.5527"
x2="-3636.6318"
y2="-3508.3506"
id="linearGradient3775-0"
xlink:href="#AIgd31-2"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3644.5117"
y1="-3531.5527"
x2="-3636.6318"
y2="-3508.3506"
id="linearGradient9535"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9537"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9539"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9541"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9543"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9545"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9547"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9549"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9551"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9553"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9555"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3644.5117"
y1="-3531.5527"
x2="-3636.6318"
y2="-3508.3506"
id="linearGradient3777-8"
xlink:href="#AIgd31-2"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3644.5117"
y1="-3531.5527"
x2="-3636.6318"
y2="-3508.3506"
id="linearGradient9558"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9560"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9562"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9564"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9566"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9568"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9570"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9572"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9574"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9576"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9578"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3644.5117"
y1="-3531.5527"
x2="-3636.6318"
y2="-3508.3506"
id="linearGradient3779-4"
xlink:href="#AIgd31-2"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3644.5117"
y1="-3531.5527"
x2="-3636.6318"
y2="-3508.3506"
id="linearGradient9581"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9583"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9585"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9587"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9589"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9591"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9593"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9595"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9597"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9599"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9601"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3738.23"
y1="-3453.355"
x2="-3733.0664"
y2="-3424.071"
id="AIgd35-5"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop460-37"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop462-2"
style="stop-color:#6f1182;stop-opacity:1"
offset="0.0752" />
<stop
id="stop464-4"
style="stop-color:#831380;stop-opacity:1"
offset="0.1935" />
<stop
id="stop466-3"
style="stop-color:#a3157b;stop-opacity:1"
offset="0.33989999" />
<stop
id="stop468-0"
style="stop-color:#d11975;stop-opacity:1"
offset="0.50880003" />
<stop
id="stop470-7"
style="stop-color:#f21b71;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop472-9"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient3781-9"
xlink:href="#AIgd36-3"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="AIgd36-3"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop479-4"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop481-5"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop483-7"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop485-9"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop487-2"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop489-8"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop491-9"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop493-4"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop495-0"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop497-7"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient3783-5"
xlink:href="#AIgd36-3"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient9624"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9626"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9628"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9630"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9632"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9634"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9636"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9638"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9640"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9642"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9644"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient3785-9"
xlink:href="#AIgd38-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="AIgd38-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop506-9"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop508-9"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop510-3"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop512-4"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop514-9"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop516-2"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop518-16"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop520-7"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop522-88"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop524-1"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient3787-4"
xlink:href="#AIgd36-3"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient9659"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9661"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9663"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9665"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9667"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9669"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9671"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9673"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9675"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9677"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9679"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient3789-0"
xlink:href="#AIgd38-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient9682"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9684"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9686"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9688"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9690"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9692"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9694"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9696"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9698"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9700"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9702"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3711.1768"
y1="-3514.0366"
x2="-3709.7402"
y2="-3493.4663"
id="AIgd41-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop535-3"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop537-9"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop539-4"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop541-9"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop543-61"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop545-0"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop547-1"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop549-0"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop551-9"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop553-5"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3718.4951"
y1="-3510.1016"
x2="-3716.7441"
y2="-3482.9595"
id="linearGradient3791-0"
xlink:href="#AIgd42-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3718.4951"
y1="-3510.1016"
x2="-3716.7441"
y2="-3482.9595"
id="AIgd42-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop560-0"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop562-1"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop564-5"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop566-1"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop568-0"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop570-9"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop572-5"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop574-9"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop576-3"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop578-6"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3718.4951"
y1="-3510.1016"
x2="-3716.7441"
y2="-3482.9595"
id="linearGradient3793-6"
xlink:href="#AIgd42-7"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3718.4951"
y1="-3510.1016"
x2="-3716.7441"
y2="-3482.9595"
id="linearGradient9728"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9730"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9732"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9734"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9736"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9738"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9740"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9742"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9744"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9746"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9748"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient3795-0"
xlink:href="#AIgd38-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient9751"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9753"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9755"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9757"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9759"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9761"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9763"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9765"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9767"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9769"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9771"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient3797-7"
xlink:href="#AIgd38-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient9774"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9776"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9778"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9780"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9782"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9784"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9786"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9788"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9790"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9792"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9794"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient3799-6"
xlink:href="#AIgd36-3"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient9797"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9799"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9801"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9803"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9805"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9807"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9809"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9811"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9813"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9815"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9817"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient3801-3"
xlink:href="#AIgd38-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient9820"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9822"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9824"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9826"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9828"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9830"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9832"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9834"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9836"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9838"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9840"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient3803-1"
xlink:href="#AIgd36-3"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient9843"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9845"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9847"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9849"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9851"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9853"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9855"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9857"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9859"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9861"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9863"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient3805-7"
xlink:href="#AIgd38-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient9866"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9868"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9870"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9872"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9874"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9876"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9878"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9880"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9882"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9884"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9886"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient3807-4"
xlink:href="#AIgd36-3"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient9889"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9891"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop9893"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop9895"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop9897"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop9899"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop9901"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop9903"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop9905"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop9907"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9909"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3809-6"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient9912"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9914"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9916"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9918"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9920"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9922"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9924"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9926"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9928"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient3811-8"
xlink:href="#AIgd52-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="AIgd52-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop603-7"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop605-7"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop607-0"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop609-8"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop611-8"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop613-2"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop615-9"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop617-5"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3813-4"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient9941"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9943"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9945"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9947"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9949"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9951"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9953"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9955"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9957"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient3815-6"
xlink:href="#AIgd52-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient9960"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9962"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9964"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9966"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9968"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9970"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9972"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9974"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9976"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3817-7"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient9979"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop9981"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop9983"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop9985"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop9987"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop9989"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop9991"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop9993"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop9995"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient3819-6"
xlink:href="#AIgd52-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient9998"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10000"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10002"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10004"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10006"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10008"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10010"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10012"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10014"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3821-4"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient10017"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10019"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10021"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10023"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10025"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10027"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10029"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10031"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10033"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3823-8"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient10036"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10038"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10040"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10042"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10044"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10046"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10048"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10050"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10052"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient3825-6"
xlink:href="#AIgd52-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient10055"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10057"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10059"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10061"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10063"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10065"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10067"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10069"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10071"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3827-5"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient10074"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10076"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10078"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10080"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10082"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10084"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10086"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10088"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10090"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient3829-3"
xlink:href="#AIgd52-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient10093"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10095"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10097"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10099"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10101"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10103"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10105"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10107"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10109"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3831-8"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient10112"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10114"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10116"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10118"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10120"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10122"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10124"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10126"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10128"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient3833-8"
xlink:href="#AIgd52-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient10131"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10133"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10135"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10137"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10139"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10141"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10143"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10145"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10147"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3835-2"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient10150"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10152"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10154"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10156"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10158"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10160"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10162"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10164"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10166"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient3837-4"
xlink:href="#AIgd52-8"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient10169"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10171"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10173"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10175"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10177"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10179"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10181"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10183"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10185"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3839-0"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient10188"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10190"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10192"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10194"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10196"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10198"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10200"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10202"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10204"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3841-9"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient10207"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10209"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10211"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10213"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10215"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10217"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10219"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10221"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10223"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient3843-2"
xlink:href="#AIgd18-9"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient10226"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10228"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10230"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10232"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10234"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10236"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10238"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10240"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10242"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3772.377"
y1="-3509.7163"
x2="-3797.2949"
y2="-3537.6816"
id="linearGradient3845-3"
xlink:href="#AIgd69-2"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3772.377"
y1="-3509.7163"
x2="-3797.2949"
y2="-3537.6816"
id="AIgd69-2"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop656-1"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop658-8"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop660-0"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop662-0"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop664-67"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop666-7"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop668-8"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop670-57"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3772.377"
y1="-3509.7163"
x2="-3797.2949"
y2="-3537.6816"
id="linearGradient3847-2"
xlink:href="#AIgd69-2"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)" />
<linearGradient
x1="-3772.377"
y1="-3509.7163"
x2="-3797.2949"
y2="-3537.6816"
id="linearGradient10255"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop10257"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop10259"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop10261"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop10263"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop10265"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop10267"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop10269"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop10271"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3498.5225"
y1="4158.0396"
x2="-3482.3647"
y2="4209.6001"
id="linearGradient23809"
xlink:href="#AIgd71-2"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,-1982.8965,3021.3838)" />
<linearGradient
x1="-3498.5225"
y1="4158.0396"
x2="-3482.3647"
y2="4209.6001"
id="AIgd71-2"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,-1982.8965,3021.3838)">
<stop
id="stop679-7"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop681-3"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop683-9"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop685-3"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop687-9"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop689-9"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop691-1"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop693-4"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop695-2"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop697-1"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient3849-2"
xlink:href="#AIgd72-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)" />
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="AIgd72-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop704-5"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop706-47"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop708-0"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop710-8"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop712-9"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop714-1"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop716-8"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop718-1"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop720-1"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop722-6"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient3851-9"
xlink:href="#AIgd72-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)" />
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient10298"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop10300"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop10302"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop10304"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop10306"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop10308"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop10310"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop10312"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop10314"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop10316"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop10318"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient3853-0"
xlink:href="#AIgd72-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)" />
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient10321"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop10323"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop10325"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop10327"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop10329"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop10331"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop10333"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop10335"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop10337"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop10339"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop10341"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient3855-7"
xlink:href="#AIgd72-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)" />
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient10344"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop10346"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop10348"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop10350"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop10352"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop10354"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop10356"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop10358"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop10360"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop10362"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop10364"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient3857-6"
xlink:href="#AIgd72-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)" />
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient10367"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop10369"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop10371"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop10373"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop10375"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop10377"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop10379"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop10381"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop10383"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop10385"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop10387"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient3859-9"
xlink:href="#AIgd72-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)" />
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient10390"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop10392"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop10394"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop10396"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop10398"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop10400"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop10402"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop10404"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop10406"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop10408"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop10410"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient3861-9"
xlink:href="#AIgd72-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)" />
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient10413"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop10415"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop10417"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop10419"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop10421"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop10423"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop10425"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop10427"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop10429"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop10431"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop10433"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient3863-3"
xlink:href="#AIgd72-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)" />
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient10436"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop10438"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop10440"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop10442"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop10444"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop10446"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop10448"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop10450"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop10452"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop10454"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop10456"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient3865-3"
xlink:href="#AIgd72-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)" />
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient10459"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop10461"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop10463"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop10465"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop10467"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop10469"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop10471"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop10473"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop10475"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop10477"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop10479"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient3867-6"
xlink:href="#AIgd72-6"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)" />
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient10482"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop10484"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop10486"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop10488"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop10490"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop10492"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop10494"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop10496"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop10498"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop10500"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop10502"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
<linearGradient
x1="224.25386"
y1="107.27033"
x2="583.86816"
y2="107.27033"
id="linearGradient4231"
xlink:href="#linearGradient4225"
gradientUnits="userSpaceOnUse" />
</defs>
<metadata
id="metadata15396">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title>Powered By: Apache 2.4</dc:title>
<dc:date>October 2nd, 2012</dc:date>
<dc:creator>
<cc:Agent>
<dc:title>Daniel Gruno [humbedooh@apache.org]</dc:title>
</cc:Agent>
</dc:creator>
<dc:rights>
<cc:Agent>
<dc:title>Copyright 2012, Apache Software Foundation</dc:title>
</cc:Agent>
</dc:rights>
<dc:publisher>
<cc:Agent>
<dc:title>Apache Software Foun</dc:title>
</cc:Agent>
</dc:publisher>
</cc:Work>
</rdf:RDF>
</metadata>
<g
transform="translate(-11.473237,-21.469327)"
id="layer1">
<g
transform="matrix(-1.2697137,0,0,1.2697137,225.64827,25.009594)"
id="Feather_x0020_shadow-3">
<path
d="m 0.281,44.304 c 13.561,-1.867 63.613,-4.392 85.943,-8.05 17.961,-2.937 35.502,-8.285 52.242,-13.9 4.328,-1.453 11.991,-4.434 16.896,-7.07 3.104,-2.373 10.571,-5.889 12.606,-9.222 -32.45,15.407 -45.513,19.649 -83.582,27.354 -15.436,3.169 -71.617,7.72 -84.105,10.888 z"
id="path4-8"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.59560001;stroke-miterlimit:4" />
<path
d="m 48.301,50.277 1.454,0.498 1.418,0.119 1.417,-0.23 1.417,-0.574 1.379,-0.766 1.38,-0.994 1.305,-1.145 1.301,-1.227 1.228,-1.26 1.149,-1.266 1.111,-1.225 1.035,-1.148 0.958,-0.957 0.881,-0.763 0.766,-0.499 0.689,-0.228 -0.576,0.036 -0.611,0.038 -0.689,0.077 -0.688,0.074 -0.69,0.078 -0.689,0.076 -0.689,0.038 -0.612,0.076 -0.957,0.88 -0.921,0.841 -0.805,0.842 -0.729,0.844 -0.727,0.801 -0.688,0.805 -0.652,0.764 -0.691,0.729 -0.688,0.727 -0.729,0.65 -0.767,0.65 -0.882,0.611 -0.919,0.576 -1.034,0.535 -1.149,0.496 -1.302,0.42 z"
id="path6-8"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 43.551,50.082 1.688,0.271 1.569,0.037 1.455,-0.15 1.377,-0.344 1.265,-0.535 1.151,-0.652 1.148,-0.766 1.034,-0.879 1.035,-0.918 0.957,-0.994 0.959,-1.072 0.921,-1.033 0.956,-1.033 0.96,-1.033 0.958,-0.955 0.995,-0.881 -0.381,0.037 h -0.423 l -0.384,0.039 -0.419,0.037 -0.424,0.037 -0.421,0.078 -0.42,0.035 -0.42,0.041 -0.421,0.037 -0.461,0.037 -0.422,0.078 -0.459,0.037 -0.459,0.037 -0.46,0.037 h -0.46 l -0.459,0.039 -0.347,0.535 -0.42,0.652 -0.537,0.764 -0.575,0.805 -0.69,0.881 -0.729,0.879 -0.766,0.918 -0.805,0.879 -0.844,0.844 -0.84,0.805 -0.885,0.727 -0.842,0.611 -0.844,0.496 -0.843,0.346 -0.804,0.189 h -0.768 z"
id="path8-7"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 40.411,50.119 0.958,0.115 0.919,0.076 0.881,-0.037 0.881,-0.152 0.882,-0.189 0.843,-0.344 0.841,-0.422 0.883,-0.574 0.882,-0.65 0.882,-0.764 0.882,-0.92 0.919,-0.994 0.958,-1.188 0.997,-1.301 1.034,-1.416 1.074,-1.607 -0.651,-0.002 -0.613,0.039 -0.614,0.076 -0.612,0.076 -0.611,0.078 -0.613,0.072 h -0.688 -0.727 l -0.616,0.613 -0.573,0.65 -0.576,0.613 -0.574,0.688 -0.575,0.65 -0.535,0.689 -0.576,0.648 -0.539,0.691 -0.572,0.65 -0.574,0.65 -0.612,0.65 -0.582,0.617 -0.65,0.572 -0.652,0.574 -0.65,0.574 -0.729,0.498 z"
id="path10-2"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 37.081,49.96 0.728,0.387 0.802,0.154 0.807,-0.117 0.842,-0.342 0.844,-0.5 0.881,-0.689 0.88,-0.764 0.884,-0.916 0.841,-0.959 0.884,-0.992 0.804,-0.998 0.805,-0.957 0.768,-0.957 0.729,-0.84 0.689,-0.729 0.614,-0.613 -4.099,0.382 -0.462,0.611 -0.498,0.611 -0.458,0.615 -0.459,0.609 -0.46,0.613 -0.5,0.613 -0.461,0.611 -0.497,0.613 -0.537,0.572 -0.537,0.611 -0.536,0.578 -0.613,0.57 -0.612,0.574 -0.653,0.576 -0.688,0.537 -0.728,0.531 z"
id="path12-8"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 30.302,49.076 1.188,0.768 1.109,0.5 1.11,0.23 h 1.074 l 1.033,-0.191 0.995,-0.342 0.955,-0.539 0.96,-0.686 0.919,-0.842 0.923,-0.881 0.84,-1.037 0.884,-1.031 0.843,-1.109 0.844,-1.146 0.805,-1.148 0.805,-1.111 -0.689,0.114 -0.536,0.037 -0.384,0.037 -0.345,0.039 -0.343,0.039 h -0.346 l -0.499,0.037 -0.651,0.037 -0.729,1.033 -0.727,0.955 -0.729,0.922 -0.805,0.803 -0.767,0.727 -0.767,0.689 -0.804,0.611 -0.768,0.537 -0.766,0.457 -0.768,0.422 -0.727,0.305 -0.689,0.27 -0.689,0.229 -0.614,0.152 -0.612,0.076 -0.537,0.037 z"
id="path14-0"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 26.74,48.843 1.228,0.152 1.186,0.08 1.149,-0.078 1.109,-0.15 1.036,-0.227 1.033,-0.346 0.958,-0.422 0.92,-0.535 0.92,-0.572 0.844,-0.65 0.843,-0.727 0.803,-0.805 0.766,-0.842 0.73,-0.918 0.729,-0.959 0.689,-0.994 -0.767,0.039 -0.844,0.074 -0.802,0.076 -0.806,0.039 -0.69,0.076 -0.574,0.035 -0.42,0.041 -0.191,0.037 -0.076,0.078 -0.191,0.191 -0.308,0.305 -0.382,0.385 -0.422,0.459 -0.536,0.537 -0.577,0.572 -0.648,0.615 -0.731,0.607 -0.764,0.65 -0.768,0.615 -0.843,0.611 -0.88,0.572 -0.881,0.535 -0.921,0.461 -0.921,0.381 z"
id="path16-8"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 22.031,49.109 1.033,0.191 0.998,0.076 1.033,-0.113 1.034,-0.191 1.034,-0.342 0.994,-0.422 0.996,-0.498 0.998,-0.611 0.919,-0.648 0.918,-0.689 0.881,-0.727 0.845,-0.766 0.806,-0.803 0.766,-0.766 0.69,-0.768 0.651,-0.766 h -0.461 l -0.574,0.041 -0.611,0.035 H 34.33 l -0.613,0.074 -0.613,0.041 -0.496,0.039 -0.423,0.074 v 0.078 l -0.154,0.189 -0.381,0.346 -0.537,0.42 -0.653,0.537 -0.764,0.613 -0.845,0.652 -0.882,0.648 -0.92,0.686 -0.918,0.691 -0.881,0.65 -0.846,0.574 -0.766,0.535 -0.689,0.422 -0.537,0.305 -0.382,0.191 z"
id="path18-0"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 16.822,49.066 0.612,0.613 0.806,0.266 0.996,0.002 1.11,-0.266 1.227,-0.461 1.262,-0.646 1.341,-0.768 1.305,-0.84 1.302,-0.92 1.227,-0.916 1.147,-0.879 0.999,-0.844 0.881,-0.688 0.65,-0.574 0.423,-0.381 0.192,-0.154 -0.498,0.039 -0.538,0.035 -0.574,0.037 -0.572,0.041 -0.614,0.072 -0.614,0.039 -0.611,0.041 -0.652,0.037 -0.688,0.42 -0.688,0.422 -0.693,0.455 -0.649,0.426 -0.689,0.455 -0.653,0.498 -0.688,0.459 -0.653,0.459 -0.69,0.496 -0.65,0.461 -0.688,0.459 -0.651,0.459 -0.688,0.42 -0.691,0.422 -0.651,0.42 -0.69,0.383 z"
id="path20-7"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 12.993,49.14 0.652,0.229 0.649,0.115 0.65,0.037 0.653,-0.109 0.65,-0.195 0.689,-0.264 0.727,-0.383 0.768,-0.461 0.843,-0.535 0.881,-0.611 0.959,-0.688 1.072,-0.729 1.187,-0.803 1.265,-0.881 1.379,-0.918 1.534,-0.957 -0.653,0.039 -0.727,0.039 h -0.65 l -0.65,0.037 -0.574,0.037 -0.459,0.039 -0.307,0.039 -0.116,0.035 -0.077,0.115 -0.229,0.23 -0.346,0.307 -0.458,0.42 -0.574,0.496 -0.654,0.58 -0.689,0.57 -0.805,0.613 -0.805,0.611 -0.843,0.613 -0.843,0.533 -0.882,0.537 -0.842,0.457 -0.842,0.383 -0.805,0.268 -0.729,0.154 z"
id="path22-7"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 10.198,48.716 0.879,0.344 0.958,0.152 0.998,-0.072 1.033,-0.268 1.072,-0.383 1.033,-0.498 1.074,-0.607 0.996,-0.691 0.958,-0.688 0.92,-0.729 0.843,-0.688 0.728,-0.691 0.653,-0.572 0.495,-0.498 0.383,-0.342 0.232,-0.232 -0.613,0.039 -0.577,0.039 -0.571,0.037 -0.575,0.074 -0.535,0.041 -0.577,0.037 -0.61,0.074 -0.613,0.039 -0.459,0.42 -0.501,0.42 -0.458,0.422 -0.499,0.459 -0.498,0.498 -0.497,0.459 -0.536,0.459 -0.538,0.459 -0.536,0.422 -0.534,0.422 -0.577,0.381 -0.534,0.342 -0.614,0.309 -0.574,0.266 -0.613,0.193 -0.613,0.152 z"
id="path24-6"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 6.831,47.642 0.765,0.535 0.763,0.346 0.767,0.154 0.767,0.039 0.768,-0.152 0.766,-0.232 0.766,-0.342 0.765,-0.459 0.729,-0.498 0.766,-0.611 0.729,-0.613 0.729,-0.65 0.727,-0.648 0.69,-0.689 0.689,-0.65 0.69,-0.615 -0.422,0.041 -0.46,0.076 -0.497,0.037 -0.535,0.039 -0.575,0.074 -0.612,0.039 -0.652,0.074 -0.612,0.037 -0.192,0.461 -0.267,0.459 -0.271,0.422 -0.346,0.422 -0.381,0.383 -0.424,0.383 -0.42,0.381 -0.496,0.307 -0.5,0.307 -0.537,0.268 -0.573,0.268 -0.576,0.191 -0.612,0.154 -0.61,0.15 -0.657,0.073 -0.649,0.039 z"
id="path26-3"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 3.803,47.066 0.652,0.266 0.69,0.193 0.726,0.115 0.806,0.002 0.767,-0.039 0.842,-0.115 0.805,-0.229 0.803,-0.229 0.768,-0.344 0.729,-0.383 0.65,-0.422 0.614,-0.494 0.536,-0.539 0.46,-0.572 0.345,-0.65 0.23,-0.652 -0.46,0.039 -0.46,0.037 -0.497,0.076 -0.5,0.039 -0.495,0.037 -0.537,0.037 -0.574,0.039 -0.652,0.037 L 9.78,43.699 9.473,44.084 9.167,44.428 8.861,44.735 8.554,45.04 8.206,45.269 7.863,45.539 7.516,45.768 7.135,45.959 6.713,46.15 6.292,46.339 5.833,46.493 5.371,46.645 4.876,46.797 4.339,46.912 3.8,47.066 z"
id="path28-6"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 2.233,46.529 0.23,0.229 0.347,0.152 0.42,0.078 H 3.69 L 4.226,46.951 4.8,46.837 5.413,46.644 6.025,46.455 6.638,46.185 7.252,45.878 7.864,45.536 8.401,45.151 8.938,44.731 9.396,44.272 9.741,43.813 10.048,43.315 9.705,43.356 9.397,43.393 9.014,43.43 8.67,43.468 8.326,43.507 8.02,43.544 H 7.752 7.483 v 0.152 l -0.343,0.305 -0.576,0.422 -0.767,0.498 -0.917,0.496 -0.922,0.5 -0.919,0.381 -0.806,0.23 z"
id="path30-2"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 1.124,45.455 0.078,0.535 0.192,0.344 0.305,0.156 0.42,0.076 0.499,-0.076 0.574,-0.191 0.573,-0.229 0.614,-0.307 0.613,-0.346 0.574,-0.381 0.575,-0.381 0.461,-0.346 0.42,-0.307 0.307,-0.23 0.191,-0.152 0.038,-0.076 -2.986,0.342 -0.229,0.152 -0.384,0.192 -0.458,0.23 -0.5,0.229 -0.535,0.27 -0.497,0.189 -0.461,0.191 -0.384,0.115 z"
id="path32-8"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="M 4.573,43.886 3.922,43.925 3.348,43.964 2.812,44 l -0.498,0.037 -0.46,0.041 -0.497,0.035 -0.498,0.078 -0.577,0.113 0.117,0.729 0.343,0.346 H 1.279 L 1.968,45.19 2.657,44.842 3.386,44.461 4.037,44.115 4.573,43.886 z"
id="path34-7"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 4.459,43.505 -0.653,0.113 -0.573,0.076 -0.497,0.113 -0.5,0.076 -0.458,0.113 -0.459,0.115 -0.538,0.119 -0.574,0.152 -0.038,-0.844 0.345,-0.535 0.537,-0.193 0.727,-0.033 0.766,0.15 0.766,0.193 0.651,0.23 0.499,0.154 z"
id="path36-7"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 44.298,27.949 1.684,-0.651 1.611,-0.419 1.491,-0.113 1.417,0.076 1.379,0.309 1.262,0.459 1.227,0.652 1.187,0.729 1.149,0.845 1.11,0.919 1.106,0.959 1.074,0.996 1.071,0.957 1.07,0.921 1.073,0.882 1.109,0.807 -0.384,0.073 -0.421,0.038 -0.421,0.039 -0.383,0.076 -0.423,0.039 -0.421,0.038 -0.459,0.036 -0.421,0.039 -0.422,0.035 -0.461,0.041 -0.458,0.076 -0.422,0.037 -0.461,0.04 -0.457,0.074 -0.498,0.037 -0.461,0.077 -0.382,-0.534 -0.495,-0.653 -0.576,-0.766 -0.688,-0.768 -0.727,-0.843 -0.805,-0.843 -0.879,-0.844 -0.881,-0.806 -0.959,-0.766 -0.953,-0.688 -0.957,-0.615 -0.997,-0.497 -0.957,-0.385 -0.958,-0.23 -0.956,-0.039 -0.88,0.152 z"
id="path38-6"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 41.423,28.597 0.96,-0.345 0.92,-0.227 0.878,-0.152 0.923,-0.077 0.878,0.077 0.919,0.192 0.88,0.268 0.919,0.423 0.956,0.537 0.959,0.691 0.995,0.803 1.033,0.96 1.108,1.11 1.11,1.266 1.186,1.418 1.264,1.57 -0.69,0.039 -0.611,0.072 -0.576,0.039 -0.534,0.076 -0.537,0.076 -0.573,0.076 -0.653,0.113 -0.765,0.117 -0.689,-0.574 -0.65,-0.613 -0.689,-0.653 -0.612,-0.653 -0.649,-0.649 -0.649,-0.65 -0.613,-0.653 -0.651,-0.651 -0.651,-0.612 -0.688,-0.574 -0.651,-0.576 -0.688,-0.574 -0.727,-0.498 -0.767,-0.423 -0.766,-0.421 -0.805,-0.347 z"
id="path40-2"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 38.207,29.438 0.727,-0.611 0.808,-0.307 0.88,-0.074 0.879,0.191 0.958,0.383 0.956,0.538 0.995,0.688 0.996,0.805 0.996,0.881 0.993,0.921 0.956,0.921 0.92,0.958 0.841,0.88 0.84,0.805 0.729,0.691 0.69,0.574 -4.176,0.496 L 47.659,37.565 47.123,36.95 46.625,36.337 46.092,35.726 45.555,35.113 45.021,34.462 44.448,33.848 43.913,33.272 43.3,32.698 42.688,32.125 42.036,31.587 41.348,31.089 40.62,30.592 39.854,30.169 39.05,29.786 38.207,29.44 z"
id="path42-8"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 31.926,32.113 1.148,-1.111 1.111,-0.802 1.073,-0.534 1.072,-0.307 1.072,-0.037 1.034,0.154 1.033,0.385 0.996,0.498 0.994,0.689 0.955,0.804 0.996,0.921 0.919,0.996 0.957,1.035 0.917,1.111 0.918,1.111 0.919,1.11 -0.729,0.04 -0.611,0.035 -0.498,0.039 -0.461,0.076 -0.458,0.076 -0.499,0.075 -0.571,0.078 -0.692,0.112 -0.803,-1.034 -0.766,-0.919 -0.803,-0.844 -0.766,-0.728 -0.802,-0.612 -0.766,-0.538 -0.728,-0.461 -0.768,-0.382 -0.728,-0.309 -0.688,-0.229 -0.728,-0.192 -0.689,-0.152 -0.648,-0.08 -0.653,-0.074 h -0.649 l -0.612,-0.002 z"
id="path44-5"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 27.442,33.145 1.267,-0.461 1.187,-0.344 1.187,-0.189 1.109,-0.077 1.111,0.001 1.071,0.155 1.035,0.231 0.996,0.347 0.995,0.419 0.919,0.537 0.957,0.613 0.878,0.689 0.882,0.768 0.84,0.842 0.806,0.922 0.803,0.996 -0.803,0.115 -0.919,0.111 -0.921,0.115 -0.921,0.115 -0.842,0.113 -0.649,0.078 -0.499,0.037 -0.191,-0.002 -0.075,-0.075 -0.192,-0.153 -0.269,-0.268 -0.343,-0.346 -0.423,-0.42 -0.495,-0.424 -0.575,-0.496 -0.65,-0.538 -0.728,-0.499 -0.765,-0.536 -0.844,-0.5 -0.918,-0.495 -0.92,-0.424 -0.993,-0.383 -1.034,-0.348 -1.073,-0.229 z"
id="path46-1"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 21.775,33.828 1.034,-0.418 1.035,-0.307 1.108,-0.115 1.073,10e-4 1.111,0.118 1.108,0.229 1.072,0.346 1.111,0.422 1.033,0.498 1.033,0.537 0.995,0.651 0.994,0.651 0.882,0.693 0.881,0.727 0.802,0.728 0.726,0.729 -0.495,0.037 -0.612,0.076 -0.689,0.075 -0.728,0.077 -0.729,0.075 -0.652,0.076 -0.573,0.037 h -0.422 l -10e-4,-0.077 -0.191,-0.191 -0.38,-0.268 -0.574,-0.385 -0.689,-0.42 -0.805,-0.5 -0.919,-0.537 -0.956,-0.533 -0.955,-0.54 -0.996,-0.538 -0.998,-0.496 -0.916,-0.457 -0.846,-0.387 -0.762,-0.307 -0.616,-0.193 -0.495,-0.115 z"
id="path48-1"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 16.413,34.936 0.537,-0.842 0.805,-0.498 0.996,-0.188 h 1.147 l 1.264,0.268 1.379,0.422 1.455,0.576 1.415,0.651 1.455,0.729 1.339,0.766 1.265,0.73 1.149,0.727 0.954,0.615 0.729,0.459 0.496,0.342 0.23,0.117 -0.537,0.116 -0.61,0.077 -0.653,0.073 -0.689,0.038 -0.727,0.078 -0.729,0.074 -0.688,0.115 -0.689,0.115 -0.729,-0.345 -0.688,-0.348 -0.729,-0.381 -0.688,-0.385 -0.69,-0.346 -0.688,-0.383 -0.728,-0.384 -0.688,-0.382 -0.689,-0.35 L 20.701,36.81 19.972,36.467 19.284,36.16 18.595,35.812 17.868,35.507 17.141,35.196 16.412,34.93 z"
id="path50-8"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 9.558,36.768 0.844,-0.611 0.956,-0.346 0.996,-0.149 1.07,10e-4 1.113,0.189 1.148,0.348 1.11,0.421 1.108,0.5 1.035,0.574 1.032,0.575 0.919,0.614 0.804,0.536 0.727,0.499 0.574,0.459 0.42,0.307 0.229,0.193 -0.612,0.074 -0.574,0.076 -0.495,0.076 -0.501,0.037 -0.536,0.037 -0.496,0.076 -0.576,0.076 -0.61,0.074 L 18.706,41.062 18.17,40.714 17.596,40.295 17.022,39.912 16.411,39.49 15.798,39.069 15.186,38.646 14.574,38.263 13.96,37.879 13.313,37.571 12.661,37.266 12.048,37.034 11.4,36.845 10.785,36.728 H 10.17 l -0.612,0.037 z"
id="path52-31"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 12.084,35.661 0.653,-0.423 0.688,-0.305 0.652,-0.154 0.688,-0.074 0.689,0.037 0.728,0.152 0.807,0.27 0.838,0.308 0.921,0.423 0.959,0.459 1.07,0.576 1.147,0.614 1.265,0.65 1.378,0.692 1.49,0.765 1.648,0.768 -0.613,0.039 -0.689,0.074 -0.688,0.078 -0.691,0.111 -0.614,0.079 -0.457,0.078 -0.346,0.035 -0.153,-0.035 -0.075,-0.078 -0.27,-0.191 -0.345,-0.308 -0.459,-0.344 -0.573,-0.422 -0.689,-0.459 -0.729,-0.5 -0.803,-0.499 -0.879,-0.498 -0.882,-0.497 -0.955,-0.425 -0.957,-0.384 -0.958,-0.303 -0.957,-0.196 -0.92,-0.111 -0.919,-10e-4 z"
id="path54-9"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 6.491,38.719 0.691,-0.766 0.726,-0.574 0.729,-0.382 0.766,-0.229 0.767,-0.037 0.804,0.076 0.844,0.192 0.804,0.271 0.84,0.422 0.805,0.42 0.842,0.536 0.843,0.539 0.843,0.536 0.803,0.574 0.805,0.578 0.803,0.496 -0.459,0.076 -0.498,0.039 -0.574,0.115 -0.613,0.072 -0.649,0.08 -0.69,0.072 -0.65,0.078 -0.653,0.076 -0.229,-0.498 -0.269,-0.422 -0.305,-0.422 -0.384,-0.382 -0.383,-0.344 -0.419,-0.27 -0.5,-0.271 L 11.434,39.141 10.898,38.95 10.326,38.796 9.75,38.682 9.138,38.603 8.488,38.566 7.836,38.567 7.186,38.64 6.497,38.718 z"
id="path56-2"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 1.778,41.242 0.193,-0.307 0.306,-0.268 0.422,-0.227 0.459,-0.155 0.536,-0.114 0.612,-0.036 0.613,0.001 0.689,0.037 0.65,0.114 0.689,0.155 0.652,0.229 0.61,0.27 0.576,0.307 0.534,0.383 0.422,0.422 0.381,0.461 L 9.779,42.59 9.36,42.666 8.94,42.742 8.517,42.816 8.135,42.853 7.827,42.894 H 7.6 7.522 L 7.369,42.816 6.988,42.586 6.336,42.279 5.57,41.937 4.689,41.628 3.694,41.358 2.737,41.204 1.778,41.241 z"
id="path58-85"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 0.858,42.81 -0.036,-0.609 0.152,-0.461 0.271,-0.307 0.42,-0.191 0.497,-0.078 0.575,0.041 0.613,0.076 0.688,0.154 0.65,0.23 0.65,0.23 0.613,0.23 0.535,0.23 0.46,0.23 0.383,0.154 0.191,0.152 0.078,0.037 L 4.533,43.461 4.263,43.348 3.843,43.231 3.384,43.079 2.85,42.927 2.314,42.812 1.779,42.738 1.28,42.736 0.858,42.81 z"
id="path60-7"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 3.389,40.248 0.612,-0.498 0.651,-0.383 0.729,-0.342 0.805,-0.231 0.806,-0.153 0.803,-0.11 0.844,10e-4 0.841,0.072 0.804,0.156 0.804,0.27 0.729,0.307 0.689,0.383 0.649,0.461 0.536,0.535 0.421,0.613 0.344,0.689 -0.499,0.039 -0.457,0.078 -0.5,0.035 -0.536,0.076 -0.535,0.078 -0.574,0.037 -0.612,0.115 -0.65,0.072 L 9.862,42.208 9.591,41.9 9.284,41.632 8.941,41.362 8.558,41.132 8.137,40.902 7.715,40.71 7.256,40.558 6.797,40.404 6.3,40.289 5.84,40.213 5.341,40.173 4.844,40.136 4.348,40.135 3.849,40.173 3.389,40.248 z"
id="path62-6"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 139.729,21.932 0.077,0.117 0.192,0.307 0.267,0.497 0.344,0.613 0.386,0.727 0.382,0.806 0.346,0.92 0.303,0.918 0.228,0.959 0.079,0.92 -0.041,0.918 -0.192,0.842 -0.422,0.768 -0.651,0.687 -0.919,0.535 -1.189,0.384 0.193,-0.578 0.117,-0.611 0.113,-0.611 0.076,-0.689 0.039,-0.689 v -0.726 l -0.037,-0.69 -0.037,-0.729 -0.076,-0.729 -0.074,-0.725 -0.116,-0.69 -0.152,-0.651 -0.113,-0.651 -0.154,-0.575 -0.188,-0.574 -0.155,-0.498 0.191,-0.075 0.154,-0.04 0.19,-0.076 0.156,-0.036 0.153,-0.077 0.15,-0.039 0.191,-0.078 0.19,-0.076 z"
id="path64-3"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 138.429,22.468 0.534,2.108 0.382,1.914 0.189,1.646 0.037,1.455 -0.077,1.264 -0.23,1.072 -0.307,0.92 -0.347,0.764 -0.46,0.613 -0.497,0.496 -0.498,0.347 -0.495,0.267 -0.54,0.191 -0.459,0.076 -0.42,0.037 h -0.384 l 0.229,-0.613 0.229,-0.612 0.192,-0.688 0.154,-0.689 0.152,-0.767 0.118,-0.764 0.116,-0.767 0.075,-0.803 0.041,-0.806 10e-4,-0.843 -0.041,-0.804 -0.073,-0.843 -0.114,-0.804 -0.155,-0.843 -0.188,-0.766 -0.229,-0.805 0.457,-0.154 0.463,-0.152 0.422,-0.152 0.418,-0.115 0.348,-0.113 0.381,-0.115 0.306,-0.076 0.27,-0.077 z"
id="path66-49"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 135.325,23.424 0.231,0.765 0.227,0.959 0.155,1.073 0.072,1.186 0.041,1.303 -0.002,1.301 -0.116,1.301 -0.192,1.267 -0.271,1.187 -0.345,1.109 -0.499,0.957 -0.572,0.766 -0.731,0.574 -0.84,0.304 -0.96,0.04 -1.108,-0.307 0.422,-0.691 0.421,-0.727 0.347,-0.766 0.307,-0.727 0.229,-0.803 0.231,-0.768 0.152,-0.805 0.154,-0.805 0.077,-0.804 0.038,-0.841 v -0.805 l -0.073,-0.842 -0.076,-0.842 -0.152,-0.806 -0.152,-0.845 -0.229,-0.803 0.383,-0.152 0.458,-0.152 0.461,-0.153 0.46,-0.153 0.46,-0.151 0.382,-0.153 0.346,-0.117 0.267,-0.074 z"
id="path68-3"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 125.586,39.307 1.036,0.08 0.997,-0.154 0.879,-0.381 0.805,-0.535 0.766,-0.73 0.652,-0.879 0.536,-0.994 0.499,-1.109 0.384,-1.188 0.309,-1.266 0.192,-1.3 0.078,-1.302 0.001,-1.301 -0.114,-1.303 -0.229,-1.265 -0.343,-1.188 -0.422,0.152 -0.425,0.154 -0.456,0.114 -0.463,0.152 -0.458,0.154 -0.497,0.153 -0.46,0.152 -0.497,0.152 v 0.804 l -0.001,0.879 -0.04,0.999 -0.039,1.033 -0.039,1.033 -0.038,1.072 -0.116,1.11 -0.113,1.032 -0.156,1.035 -0.152,0.957 -0.233,0.919 -0.268,0.806 -0.308,0.687 -0.384,0.577 -0.421,0.419 -0.461,0.267 z"
id="path70-4"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 128.317,25.715 -0.384,0.153 -0.383,0.114 -0.343,0.115 -0.386,0.077 -0.382,0.114 -0.347,0.113 -0.384,0.116 -0.38,0.153 -0.077,0.766 -0.041,0.84 -0.039,0.92 -0.038,0.958 -10e-4,0.958 -0.001,1.031 -0.04,1.037 -0.039,0.994 -0.076,0.997 -0.115,0.994 -0.193,0.919 -0.191,0.844 -0.305,0.802 -0.346,0.727 -0.422,0.616 -0.536,0.496 1.108,-0.267 0.919,-0.383 0.767,-0.533 0.651,-0.614 0.537,-0.729 0.423,-0.839 0.306,-0.919 0.232,-0.959 0.156,-1.072 0.112,-1.11 0.039,-1.15 0.042,-1.225 0.037,-1.225 0.039,-1.264 0.001,-1.264 0.078,-1.303 z"
id="path72-7"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 118.156,42.058 1.531,-0.074 1.304,-0.305 1.07,-0.496 0.882,-0.652 0.689,-0.841 0.502,-0.958 0.419,-1.071 0.27,-1.188 0.154,-1.226 0.114,-1.261 0.041,-1.305 10e-4,-1.262 0.001,-1.305 0.001,-1.223 0.076,-1.15 0.078,-1.071 -0.421,0.114 -0.383,0.113 -0.343,0.117 -0.387,0.113 -0.382,0.113 -0.343,0.115 -0.384,0.077 -0.423,0.114 0.039,0.113 0.075,0.269 0.078,0.423 0.114,0.537 0.074,0.688 0.078,0.768 0.039,0.881 -0.04,0.996 -0.114,1.035 -0.195,1.145 -0.347,1.189 -0.42,1.225 -0.614,1.265 -0.766,1.339 -0.921,1.3 -1.15,1.338 z"
id="path74-3"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 112.945,43.703 1.035,0.191 1.035,-0.074 0.995,-0.346 0.996,-0.537 0.956,-0.725 0.92,-0.881 0.844,-1.07 0.769,-1.188 0.649,-1.265 0.576,-1.378 0.462,-1.456 0.309,-1.489 0.192,-1.496 0.041,-1.531 -0.152,-1.454 -0.308,-1.456 -3.638,1.146 0.037,0.613 0.037,0.729 -0.038,0.801 -0.08,0.92 -0.112,0.958 -0.192,1.034 -0.192,1.072 -0.308,1.109 -0.347,1.109 -0.421,1.073 -0.461,1.071 -0.575,1.035 -0.612,0.996 -0.729,0.918 -0.805,0.842 -0.883,0.727 z"
id="path76-2"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 118.702,28.619 -0.573,0.189 -0.729,0.192 -0.807,0.268 -0.84,0.229 -0.806,0.27 -0.804,0.227 -0.689,0.191 -0.537,0.115 -0.076,0.881 -0.042,0.955 -0.075,0.959 -0.038,0.995 -0.117,0.995 -0.077,1.037 -0.115,0.994 -0.153,0.996 -0.19,0.956 -0.232,0.921 -0.309,0.916 -0.344,0.842 -0.422,0.807 -0.498,0.688 -0.536,0.65 -0.65,0.576 0.766,0.115 0.803,-0.039 0.804,-0.189 0.805,-0.344 0.804,-0.5 0.807,-0.611 0.768,-0.764 0.766,-0.957 0.689,-1.035 0.611,-1.227 0.578,-1.339 0.495,-1.528 0.388,-1.65 0.307,-1.758 0.194,-1.955 0.077,-2.066 z"
id="path78-4"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 104.021,45.226 1.725,0.08 1.455,-0.154 1.265,-0.418 0.998,-0.652 0.841,-0.803 0.691,-0.957 0.497,-1.072 0.386,-1.224 0.308,-1.225 0.19,-1.343 0.116,-1.3 0.117,-1.302 0.038,-1.303 0.078,-1.188 0.075,-1.11 0.117,-0.995 -0.535,0.114 -0.463,0.115 -0.419,0.153 -0.418,0.112 -0.463,0.117 -0.422,0.111 -0.496,0.154 -0.576,0.151 -0.116,1.038 -0.112,0.992 -0.116,0.996 -0.156,0.955 -0.116,0.961 -0.153,0.918 -0.189,0.879 -0.194,0.881 -0.269,0.844 -0.308,0.841 -0.382,0.805 -0.422,0.805 -0.536,0.801 -0.576,0.768 -0.691,0.729 -0.77,0.727 z"
id="path80-1"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 99.389,46.066 1.532,0.078 1.34,-0.193 1.188,-0.418 1.036,-0.65 0.88,-0.805 0.766,-0.957 0.615,-1.107 0.537,-1.188 0.458,-1.226 0.347,-1.3 0.269,-1.266 0.194,-1.299 0.19,-1.226 0.116,-1.15 0.116,-1.073 0.079,-0.919 -0.539,0.117 -0.459,0.112 -0.42,0.115 -0.423,0.077 -0.38,0.113 -0.425,0.074 -0.495,0.152 -0.576,0.115 -0.192,1.496 -0.229,1.417 -0.27,1.301 -0.269,1.226 -0.31,1.109 -0.345,1.071 -0.383,0.918 -0.384,0.883 -0.383,0.803 -0.425,0.727 -0.459,0.613 -0.422,0.574 -0.459,0.535 -0.461,0.42 -0.498,0.383 -0.459,0.346 z"
id="path82-7"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 95.021,46.636 1.457,0.078 1.302,-0.189 1.151,-0.424 1.071,-0.611 0.881,-0.801 0.805,-0.92 0.69,-1.072 0.614,-1.145 0.535,-1.189 0.422,-1.263 0.347,-1.264 0.308,-1.262 0.271,-1.188 0.192,-1.149 0.152,-1.031 0.155,-0.922 -0.459,0.076 -0.46,0.116 -0.462,0.114 -0.459,0.115 -0.462,0.115 -0.458,0.112 -0.46,0.114 -0.497,0.117 -0.038,0.725 -0.116,0.805 -0.153,0.843 -0.269,0.918 -0.27,0.995 -0.382,0.957 -0.385,1.033 -0.422,0.998 -0.499,0.996 -0.537,0.957 -0.534,0.879 -0.577,0.84 -0.574,0.807 -0.614,0.689 -0.649,0.572 -0.617,0.459 z"
id="path84-2"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 90.237,47.513 1.49,0.193 1.38,-0.191 1.264,-0.496 1.15,-0.766 1.073,-0.955 0.921,-1.148 0.84,-1.301 0.77,-1.34 0.613,-1.416 0.537,-1.381 0.46,-1.302 0.384,-1.262 0.23,-1.074 0.192,-0.88 0.114,-0.65 0.001,-0.381 -0.573,0.111 -0.537,0.115 -0.535,0.152 -0.536,0.115 -0.536,0.152 -0.5,0.113 -0.497,0.115 -0.499,0.078 -0.191,0.651 -0.19,0.765 -0.229,0.879 -0.271,0.996 -0.308,1.035 -0.343,1.071 -0.384,1.069 -0.424,1.115 -0.461,1.07 -0.497,0.994 -0.537,0.959 -0.574,0.842 -0.653,0.725 -0.65,0.574 -0.728,0.422 -0.765,0.229 z"
id="path86-3"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 86.752,47.32 1.377,0.307 1.223,0.002 1.113,-0.268 1.034,-0.535 0.882,-0.729 0.805,-0.881 0.727,-1.068 0.652,-1.15 0.539,-1.225 0.498,-1.262 0.384,-1.264 0.385,-1.227 0.307,-1.147 0.231,-1.035 0.23,-0.918 0.189,-0.727 -0.419,0.076 -0.423,0.038 -0.38,0.075 -0.347,0.076 -0.384,0.076 -0.346,0.078 -0.305,0.074 -0.345,0.041 -0.118,0.879 -0.189,0.919 -0.232,0.917 -0.228,0.883 -0.309,0.918 -0.347,0.881 -0.382,0.843 -0.461,0.842 -0.46,0.842 -0.537,0.805 -0.615,0.764 -0.61,0.689 -0.729,0.689 -0.727,0.611 -0.806,0.574 -0.879,0.535 z"
id="path88-7"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 82.385,48.005 1.147,0.002 1.112,-0.115 1.07,-0.268 1.037,-0.383 0.956,-0.533 0.959,-0.65 0.842,-0.764 0.841,-0.842 0.73,-0.959 0.69,-1.033 0.614,-1.15 0.573,-1.185 0.461,-1.264 0.385,-1.34 0.347,-1.379 0.23,-1.414 -0.498,0.113 -0.499,0.076 -0.536,0.115 -0.496,0.074 -0.497,0.078 -0.459,0.112 -0.5,0.077 -0.459,0.115 -0.231,0.805 -0.191,0.842 -0.231,0.805 -0.194,0.803 -0.23,0.804 -0.228,0.803 -0.307,0.766 -0.346,0.805 -0.42,0.766 -0.463,0.803 -0.576,0.766 -0.688,0.766 -0.768,0.729 -0.918,0.766 -1.073,0.766 -1.188,0.725 z"
id="path90-2"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 76.18,48.728 1.495,0.117 1.454,-0.076 1.34,-0.229 1.266,-0.383 1.187,-0.496 1.112,-0.65 1.033,-0.768 0.918,-0.916 0.844,-0.955 0.767,-1.074 0.693,-1.148 0.573,-1.221 0.496,-1.304 0.425,-1.34 0.307,-1.377 0.233,-1.381 -0.423,0.076 -0.46,0.117 -0.456,0.074 -0.461,0.075 -0.459,0.078 -0.5,0.114 -0.497,0.076 -0.5,0.115 -0.152,0.955 -0.23,0.957 -0.31,0.96 -0.383,0.917 -0.457,0.917 -0.502,0.918 -0.574,0.883 -0.648,0.842 -0.691,0.844 -0.767,0.762 -0.808,0.727 -0.879,0.689 -0.921,0.611 -0.995,0.576 -0.997,0.496 -1.072,0.42 z"
id="path92-0"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 72.772,49.107 1.264,-0.074 1.226,-0.189 1.228,-0.307 1.186,-0.457 1.112,-0.537 1.109,-0.648 1.034,-0.729 0.958,-0.842 0.881,-0.916 0.843,-0.994 0.73,-1.076 0.65,-1.109 0.536,-1.183 0.46,-1.226 0.348,-1.267 0.229,-1.299 -0.419,0.074 -0.385,0.037 -0.346,0.039 -0.343,0.039 -0.346,0.037 -0.382,0.077 -0.458,0.075 -0.539,0.075 -0.537,1.112 -0.459,1.031 -0.46,0.997 -0.422,0.918 -0.46,0.881 -0.424,0.805 -0.461,0.764 -0.498,0.727 -0.537,0.729 -0.613,0.65 -0.688,0.689 -0.765,0.611 -0.884,0.65 -0.996,0.611 -1.108,0.613 -1.265,0.609 z"
id="path94-54"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 66.645,49.488 1.877,0.076 1.763,-0.072 1.57,-0.268 1.455,-0.422 1.34,-0.572 1.187,-0.691 1.113,-0.801 0.993,-0.92 0.921,-0.992 0.844,-1.072 0.729,-1.109 0.688,-1.189 0.652,-1.184 0.577,-1.187 0.538,-1.227 0.496,-1.187 -0.343,0.036 -0.461,0.078 -0.573,0.076 -0.575,0.076 -0.613,0.115 -0.537,0.076 -0.456,0.076 -0.347,0.035 -0.46,1.074 -0.499,1.074 -0.577,0.994 -0.573,0.955 -0.652,0.881 -0.688,0.879 -0.729,0.805 -0.804,0.807 -0.804,0.727 -0.885,0.688 -0.917,0.688 -0.96,0.613 -0.995,0.572 -1.072,0.535 -1.072,0.496 -1.149,0.461 z"
id="path96-1"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 63.006,50.019 1.034,-0.037 1.071,-0.152 1.15,-0.268 1.186,-0.42 1.188,-0.494 1.189,-0.613 1.188,-0.727 1.187,-0.803 1.149,-0.918 1.111,-0.957 1.035,-1.07 0.999,-1.15 0.879,-1.188 0.804,-1.261 0.691,-1.34 0.576,-1.38 -0.575,0.079 -0.575,0.074 -0.611,0.037 -0.612,0.077 -0.536,0.037 -0.461,0.077 -0.382,0.076 -0.192,0.115 -0.69,0.535 -0.689,0.575 -0.729,0.688 -0.729,0.688 -0.727,0.765 -0.767,0.803 -0.767,0.844 -0.768,0.844 -0.766,0.879 -0.804,0.842 -0.805,0.842 -0.845,0.84 -0.842,0.844 -0.845,0.762 -0.842,0.768 -0.882,0.688 z"
id="path98-0"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 57.415,50.015 0.997,0.654 1.032,0.268 1.034,0.002 1.073,-0.268 1.071,-0.537 1.073,-0.729 1.111,-0.916 1.11,-1.033 1.112,-1.188 1.148,-1.225 1.189,-1.301 1.188,-1.299 1.188,-1.264 1.226,-1.263 1.228,-1.148 1.226,-1.031 h -0.425 l -0.494,0.074 -0.576,0.038 -0.573,0.116 -0.614,0.076 -0.612,0.113 -0.572,0.115 -0.5,0.075 -0.956,0.88 -0.957,0.88 -0.923,0.918 -0.919,0.92 -0.881,0.916 -0.883,0.92 -0.88,0.92 -0.845,0.84 -0.844,0.84 -0.842,0.768 -0.805,0.688 -0.804,0.613 -0.805,0.535 -0.767,0.459 -0.766,0.344 -0.767,0.229 z"
id="path100-7"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 53.086,50.511 1.572,0.002 1.492,-0.152 1.342,-0.385 1.304,-0.494 1.187,-0.613 1.109,-0.766 1.075,-0.84 0.995,-0.92 0.997,-0.994 0.956,-1.033 0.921,-1.035 0.959,-1.07 0.959,-1.07 0.994,-1.034 1.035,-0.957 1.072,-0.918 -0.382,0.04 -0.458,0.037 -0.577,0.074 -0.572,0.041 -0.577,0.073 -0.459,0.038 -0.382,0.041 -0.229,-10e-4 -0.651,0.151 -0.651,0.306 -0.649,0.423 -0.692,0.573 -0.689,0.686 -0.729,0.805 -0.766,0.844 -0.769,0.916 -0.88,0.957 -0.883,0.955 -0.997,0.996 -1.032,0.959 -1.111,0.955 -1.188,0.881 -1.264,0.801 -1.381,0.729 z"
id="path102-4"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 138.314,18.982 v -0.153 l 0.04,-0.42 0.038,-0.649 0.04,-0.807 0.039,-0.957 -0.037,-1.033 -0.038,-1.072 -0.111,-1.111 -0.229,-1.033 -0.309,-0.996 -0.38,-0.882 -0.572,-0.728 -0.654,-0.537 -0.843,-0.307 -1.034,-0.039 -1.186,0.306 0.385,0.384 0.343,0.459 0.345,0.574 0.306,0.613 0.305,0.689 0.27,0.689 0.264,0.767 0.271,0.804 0.228,0.767 0.19,0.806 0.194,0.803 0.188,0.766 0.155,0.768 0.152,0.727 0.114,0.65 0.113,0.613 0.19,-0.037 0.154,-0.037 0.189,-0.078 0.155,-0.037 0.151,-0.079 0.155,-0.075 0.192,-0.037 0.226,-0.078 z"
id="path104-1"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 136.9,19.558 -0.497,-2.489 -0.535,-2.108 -0.535,-1.801 -0.532,-1.492 -0.539,-1.188 -0.534,-0.958 -0.533,-0.689 -0.499,-0.497 -0.536,-0.347 -0.458,-0.153 -0.502,-0.039 -0.42,0.078 -0.419,0.152 -0.382,0.191 -0.348,0.229 -0.306,0.23 0.536,0.497 0.533,0.573 0.462,0.538 0.494,0.611 0.424,0.615 0.422,0.648 0.382,0.652 0.344,0.691 0.344,0.727 0.306,0.766 0.307,0.768 0.268,0.805 0.227,0.842 0.23,0.842 0.227,0.882 0.194,0.919 0.457,-0.077 0.345,-0.036 0.232,-0.077 0.153,-0.077 0.151,-0.037 0.156,-0.076 0.153,-0.039 0.229,-0.075 z"
id="path106-0"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 134.984,20.283 -0.113,-0.918 -0.194,-1.035 -0.305,-1.15 -0.379,-1.226 -0.5,-1.264 -0.571,-1.227 -0.611,-1.187 -0.688,-1.111 -0.729,-0.996 -0.765,-0.843 -0.803,-0.65 -0.842,-0.425 -0.881,-0.151 -0.882,0.152 -0.842,0.499 -0.882,0.878 0.688,0.498 0.65,0.576 0.613,0.574 0.574,0.576 0.574,0.611 0.496,0.689 0.459,0.691 0.42,0.688 0.423,0.769 0.343,0.767 0.345,0.805 0.267,0.842 0.267,0.879 0.193,0.92 0.189,0.959 0.155,0.994 0.416,-0.114 0.461,-0.152 0.499,-0.153 0.498,-0.191 0.461,-0.189 0.421,-0.154 0.344,-0.151 0.23,-0.077 z"
id="path108-60"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 120.057,10.239 0.919,-0.612 0.92,-0.344 0.957,-0.115 0.919,0.115 0.958,0.307 0.919,0.5 0.882,0.689 0.843,0.805 0.762,0.919 0.766,1.073 0.65,1.188 0.572,1.226 0.496,1.305 0.384,1.376 0.306,1.38 0.151,1.416 -0.461,0.114 -0.459,0.116 -0.46,0.15 -0.46,0.154 -0.497,0.191 -0.499,0.113 -0.457,0.154 -0.498,0.075 -0.346,-0.88 -0.305,-0.959 -0.383,-0.957 -0.348,-0.957 -0.379,-0.996 -0.419,-0.998 -0.423,-0.956 -0.421,-0.918 -0.456,-0.884 -0.499,-0.805 -0.533,-0.766 -0.539,-0.651 -0.609,-0.575 -0.615,-0.459 -0.648,-0.346 -0.69,-0.19 z"
id="path110-4"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 115.844,11.383 1.455,-0.648 1.302,-0.344 1.149,-0.038 1.034,0.193 0.919,0.421 0.806,0.65 0.724,0.807 0.65,0.957 0.575,1.072 0.495,1.188 0.5,1.229 0.457,1.225 0.457,1.264 0.421,1.264 0.459,1.188 0.497,1.111 -0.421,0.037 -0.384,0.115 -0.383,0.113 -0.385,0.152 -0.381,0.118 -0.384,0.151 -0.421,0.114 -0.422,0.074 -0.038,-0.151 -0.038,-0.383 -0.114,-0.498 -0.114,-0.689 -0.189,-0.803 -0.27,-0.92 -0.306,-0.996 -0.42,-1.034 -0.494,-1.034 -0.574,-1.035 -0.728,-1.035 -0.803,-0.958 -0.96,-0.918 -1.07,-0.767 -1.228,-0.691 -1.375,-0.5 z"
id="path112-4"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 110.406,12.185 0.882,-0.651 0.997,-0.42 1.069,-0.153 1.072,0.04 1.149,0.229 1.148,0.461 1.108,0.615 1.111,0.768 1.07,0.956 0.997,1.075 0.878,1.225 0.805,1.342 0.687,1.416 0.537,1.533 0.342,1.57 0.19,1.687 -3.945,1.029 -0.228,-0.649 -0.307,-0.77 -0.306,-0.803 -0.382,-0.881 -0.461,-0.92 -0.457,-0.956 -0.537,-0.961 -0.573,-0.956 -0.652,-0.957 -0.725,-0.92 -0.766,-0.842 -0.803,-0.808 -0.878,-0.728 -0.959,-0.613 -0.996,-0.537 -1.07,-0.421 z"
id="path114-5"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 120.542,25.02 -0.572,0.115 -0.727,0.152 -0.729,0.23 -0.808,0.229 -0.764,0.267 -0.729,0.191 -0.649,0.189 -0.536,0.152 -0.382,-0.957 -0.421,-0.995 -0.422,-0.996 -0.42,-1.036 -0.421,-1.032 -0.458,-0.997 -0.498,-0.995 -0.497,-0.997 -0.533,-0.918 -0.573,-0.845 -0.614,-0.804 -0.651,-0.727 -0.65,-0.652 -0.728,-0.537 -0.804,-0.423 -0.804,-0.306 0.692,-0.459 0.764,-0.344 0.806,-0.23 0.88,-0.075 0.918,0.076 0.959,0.231 0.957,0.383 0.992,0.576 0.999,0.728 0.993,0.92 0.995,1.149 0.954,1.304 0.919,1.532 0.917,1.723 0.843,1.992 0.802,2.184 z"
id="path116-1"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 101.328,14.973 1.571,-0.841 1.415,-0.498 1.304,-0.114 1.187,0.193 1.032,0.458 0.996,0.691 0.841,0.883 0.805,1.073 0.688,1.188 0.649,1.265 0.573,1.341 0.534,1.34 0.536,1.302 0.498,1.265 0.458,1.148 0.456,1.035 -0.534,0.076 -0.459,0.112 -0.422,0.079 -0.422,0.114 -0.421,0.114 -0.459,0.115 -0.498,0.076 -0.572,0.112 -0.5,-1.033 -0.458,-1.036 -0.46,-0.994 -0.458,-0.958 -0.459,-0.958 -0.495,-0.88 -0.5,-0.881 -0.495,-0.806 -0.575,-0.807 -0.61,-0.727 -0.612,-0.688 -0.688,-0.652 -0.769,-0.615 -0.801,-0.536 -0.92,-0.498 -0.956,-0.46 z"
id="path118-2"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 96.577,16.348 1.419,-0.765 1.339,-0.383 1.265,-0.075 1.225,0.191 1.111,0.461 1.069,0.689 0.996,0.844 0.921,0.998 0.841,1.149 0.802,1.187 0.726,1.227 0.652,1.264 0.611,1.266 0.537,1.148 0.455,1.111 0.423,0.957 -0.574,0.113 -0.5,0.115 -0.46,0.113 -0.421,0.076 -0.458,0.115 -0.461,0.115 -0.536,0.076 -0.613,0.115 -0.688,-1.533 -0.688,-1.417 -0.646,-1.302 -0.651,-1.188 -0.614,-1.071 -0.573,-0.961 -0.61,-0.84 -0.574,-0.807 -0.612,-0.651 -0.613,-0.575 -0.611,-0.498 -0.65,-0.421 -0.653,-0.308 -0.685,-0.269 -0.731,-0.155 -0.765,-0.113 z"
id="path120-8"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 92.977,17.379 1.378,-0.65 1.307,-0.308 1.222,0.001 1.19,0.233 1.07,0.458 1.033,0.654 0.956,0.844 0.92,0.957 0.802,1.072 0.766,1.148 0.726,1.188 0.613,1.188 0.609,1.189 0.5,1.15 0.456,1.033 0.421,0.959 -0.459,0.113 -0.42,0.113 -0.424,0.076 -0.383,0.116 -0.421,0.077 -0.42,0.075 -0.462,0.113 -0.496,0.077 -0.231,-0.765 -0.342,-0.845 -0.42,-0.842 -0.497,-0.919 -0.535,-0.919 -0.651,-0.921 -0.649,-0.92 -0.728,-0.92 -0.765,-0.841 -0.805,-0.846 -0.803,-0.766 -0.804,-0.652 -0.843,-0.613 -0.805,-0.498 -0.802,-0.383 -0.806,-0.23 z"
id="path122-5"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 88.648,18.484 1.417,-0.762 1.38,-0.345 1.379,0.039 1.301,0.385 1.264,0.612 1.226,0.879 1.149,1.038 1.069,1.147 0.995,1.229 0.881,1.264 0.8,1.227 0.65,1.187 0.536,1.036 0.422,0.879 0.23,0.652 0.113,0.383 -0.574,0.115 -0.498,0.113 -0.498,0.115 -0.5,0.115 -0.496,0.115 -0.459,0.074 -0.499,0.077 -0.497,0.076 -0.344,-0.651 -0.384,-0.804 -0.458,-0.882 -0.537,-0.921 -0.571,-1.033 -0.614,-1.034 -0.646,-0.997 -0.691,-1.034 -0.727,-0.959 -0.767,-0.88 -0.802,-0.804 -0.803,-0.652 -0.844,-0.537 -0.844,-0.345 -0.878,-0.152 -0.882,0.035 z"
id="path124-1"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 85.508,19.709 1.266,-0.842 1.224,-0.459 1.149,-0.113 1.149,0.19 1.071,0.461 1.033,0.692 0.958,0.842 0.915,1.035 0.844,1.113 0.805,1.184 0.727,1.229 0.687,1.225 0.574,1.15 0.535,1.073 0.421,0.918 0.383,0.766 -0.46,0.077 -0.382,0.114 -0.344,0.115 -0.308,0.113 -0.347,0.114 -0.305,0.115 -0.307,0.079 -0.343,0.073 -0.344,-0.955 -0.421,-0.958 -0.422,-0.921 -0.46,-0.918 -0.537,-0.919 -0.531,-0.844 -0.613,-0.844 -0.65,-0.805 -0.689,-0.767 -0.764,-0.688 -0.765,-0.614 -0.844,-0.574 -0.919,-0.5 -0.919,-0.421 -0.996,-0.308 -1.071,-0.229 z"
id="path126-1"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 81.523,20.625 1.113,-0.422 1.109,-0.266 1.148,-0.077 1.074,0.078 1.109,0.231 1.032,0.345 1.034,0.536 1.034,0.652 0.956,0.768 0.918,0.92 0.881,0.996 0.842,1.112 0.802,1.226 0.689,1.34 0.688,1.418 0.571,1.491 -0.498,0.077 -0.495,0.076 -0.501,0.115 -0.497,0.153 -0.496,0.115 -0.498,0.153 -0.497,0.115 -0.5,0.074 -0.343,-0.842 -0.343,-0.882 -0.347,-0.843 -0.342,-0.883 -0.422,-0.842 -0.419,-0.805 -0.501,-0.842 -0.534,-0.767 -0.649,-0.729 -0.688,-0.728 -0.805,-0.652 -0.88,-0.613 -0.996,-0.537 -1.11,-0.498 -1.261,-0.424 -1.381,-0.344 z"
id="path128-2"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 75.855,21.961 1.455,-0.609 1.457,-0.385 1.34,-0.189 1.34,-0.037 1.265,0.191 1.226,0.346 1.147,0.498 1.111,0.652 0.992,0.805 0.994,0.919 0.884,1.036 0.84,1.15 0.764,1.264 0.652,1.34 0.611,1.381 0.535,1.491 -0.459,0.077 -0.46,0.076 -0.536,0.078 -0.501,0.074 -0.533,0.078 -0.538,0.074 -0.535,0.076 -0.535,0.076 -0.269,-1.072 -0.383,-0.994 -0.42,-0.996 L 86.766,28.402 86.191,27.521 85.54,26.678 84.852,25.873 84.086,25.144 83.244,24.455 82.328,23.881 81.369,23.342 80.374,22.883 79.303,22.537 78.19,22.23 77.044,22.039 75.856,21.961 z"
id="path130-0"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 73.062,22.265 1.302,-0.19 1.262,-0.113 1.262,0.038 1.228,0.154 1.224,0.307 1.15,0.385 1.109,0.498 1.073,0.613 0.995,0.729 0.954,0.844 0.844,0.919 0.803,1.034 0.688,1.15 0.611,1.226 0.499,1.341 0.38,1.419 -0.46,0.035 -0.383,0.038 -0.382,0.077 -0.384,0.077 -0.384,0.074 -0.382,0.078 -0.46,0.114 -0.496,0.076 -0.651,-1.111 -0.613,-1.073 -0.532,-0.958 -0.5,-0.956 -0.535,-0.844 -0.498,-0.804 -0.497,-0.767 -0.572,-0.69 -0.612,-0.651 -0.688,-0.575 -0.768,-0.535 -0.842,-0.498 -0.995,-0.425 -1.071,-0.383 -1.264,-0.346 -1.415,-0.308 z"
id="path132-6"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 66.973,23.064 1.914,-0.457 1.8,-0.268 1.646,-0.075 1.531,0.154 1.417,0.307 1.302,0.461 1.187,0.573 1.074,0.77 1.03,0.842 0.917,0.96 0.844,1.034 0.802,1.112 0.728,1.147 0.688,1.227 0.612,1.226 0.611,1.265 -0.307,0.037 -0.42,0.037 -0.459,0.115 -0.501,0.076 -0.496,0.115 -0.462,0.114 -0.419,0.036 -0.346,0.039 -0.571,-1.148 -0.613,-1.035 -0.689,-0.996 -0.726,-0.918 -0.766,-0.883 -0.805,-0.806 -0.878,-0.725 -0.919,-0.69 -0.956,-0.616 -0.996,-0.573 -1.034,-0.498 -1.07,-0.498 -1.111,-0.423 -1.147,-0.383 -1.189,-0.346 -1.222,-0.309 z"
id="path134-6"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 63.335,23.443 1.068,-0.189 1.113,-0.037 1.225,0.038 1.263,0.192 1.267,0.271 1.3,0.384 1.303,0.497 1.302,0.614 1.3,0.729 1.224,0.845 1.186,0.92 1.147,1.035 1.035,1.149 0.956,1.225 0.841,1.342 0.728,1.455 -0.537,0.039 -0.533,0.076 -0.538,0.115 -0.536,0.113 -0.459,0.113 -0.385,0.117 -0.306,0.036 -0.19,-0.037 -0.769,-0.46 -0.763,-0.537 -0.804,-0.613 -0.843,-0.689 -0.843,-0.729 -0.878,-0.768 -0.92,-0.768 -0.916,-0.802 -0.959,-0.806 -0.956,-0.807 -0.995,-0.803 -0.996,-0.729 -1.033,-0.729 -0.995,-0.652 -1.071,-0.613 -1.031,-0.537 z"
id="path136-6"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 58.237,24.895 0.958,-0.955 1.034,-0.572 1.074,-0.23 1.109,0.077 1.148,0.308 1.225,0.575 1.227,0.769 1.3,0.879 1.301,1.074 1.341,1.11 1.34,1.19 1.34,1.188 1.377,1.188 1.377,1.112 1.376,1.035 1.381,0.92 -0.421,0.074 -0.499,0.037 -0.612,0.041 -0.613,0.037 -0.648,0.037 h -0.653 -0.574 l -0.497,-0.002 -1.034,-0.766 -0.993,-0.804 -0.996,-0.808 -0.918,-0.842 -0.919,-0.805 -0.883,-0.807 -0.878,-0.805 -0.88,-0.767 -0.919,-0.688 -0.879,-0.651 -0.92,-0.575 -0.956,-0.5 -0.996,-0.422 -1.034,-0.345 -1.073,-0.192 -1.11,-0.117 z"
id="path138-7"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="m 54.408,25.352 1.61,-0.381 1.493,-0.152 1.415,0.076 1.343,0.271 1.262,0.461 1.226,0.575 1.186,0.729 1.148,0.805 1.11,0.919 1.109,0.922 1.071,0.995 1.111,0.996 1.109,0.958 1.107,0.959 1.188,0.843 1.185,0.807 -0.38,0.037 -0.498,0.075 -0.576,0.078 -0.576,0.036 -0.572,0.079 -0.5,0.072 -0.38,0.041 L 70.368,35.59 69.68,35.588 68.99,35.399 68.263,35.051 67.497,34.555 66.731,33.941 65.888,33.213 65.009,32.406 64.09,31.562 63.131,30.681 62.1,29.763 60.991,28.881 59.843,28.037 58.581,27.229 57.279,26.501 55.9,25.85 54.406,25.35 z"
id="path140-3"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<path
d="M 49.583,26.689 51,25.885 52.495,25.543 h 1.455 l 1.49,0.309 1.495,0.576 1.494,0.804 1.454,0.96 1.415,1.034 1.339,1.149 1.302,1.15 1.263,1.075 1.148,0.993 1.033,0.844 0.956,0.65 0.843,0.385 0.726,0.116 -0.61,0.077 -0.653,0.113 -0.727,0.113 -0.765,0.117 -0.767,0.074 -0.767,0.115 -0.728,0.038 -0.652,0.037 -1.07,-0.806 L 62.211,34.7 61.332,33.933 60.492,33.205 59.725,32.475 59,31.752 58.233,31.061 57.507,30.41 56.778,29.798 55.974,29.222 55.133,28.685 54.214,28.189 53.218,27.728 52.147,27.345 50.921,26.997 49.581,26.69 z"
id="path142-1"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4" />
<g
id="g144-1"
style="fill:#d9d9d9;fill-rule:nonzero;stroke:#d9d9d9;stroke-width:0.25400001;stroke-miterlimit:4">
<path
d="m 142.345,10.982 0.191,-0.383 0.153,-0.42 0.152,-0.423 0.113,-0.421 0.117,-0.459 0.115,-0.496 0.077,-0.459 0.042,-0.5 0.036,-0.459 0.035,-0.498 0.001,-0.499 -0.035,-0.46 -0.036,-0.459 -0.08,-0.457 -0.112,-0.461 -0.114,-0.42 0.611,0.804 0.459,0.882 0.345,0.842 0.189,0.88 0.076,0.919 v 0.92 l -0.116,0.918 -0.194,0.92 -0.228,0.918 -0.31,0.883 -0.343,0.879 -0.343,0.88 -0.385,0.843 -0.347,0.842 -0.346,0.765 -0.343,0.767 0.074,-0.152 0.037,-0.269 0.042,-0.266 v -0.345 l 0.037,-0.424 v -0.421 -0.46 l 0.001,-0.496 0.038,-0.499 V 13.74 l 0.039,-0.534 0.04,-0.498 0.038,-0.461 0.078,-0.461 0.075,-0.42 0.116,-0.383 z"
id="path146-3" />
<path
d="m 154.014,26.885 -0.729,-0.422 -0.729,-0.462 -0.687,-0.421 -0.688,-0.422 -0.65,-0.383 -0.651,-0.422 -0.616,-0.385 -0.609,-0.42 -0.655,-0.383 -0.607,-0.384 -0.614,-0.422 -0.652,-0.382 -0.611,-0.386 -0.654,-0.342 -0.686,-0.386 -0.689,-0.382 0.61,0.61 0.613,0.616 0.613,0.611 0.612,0.576 0.65,0.611 0.651,0.536 0.65,0.539 0.688,0.497 0.651,0.461 0.689,0.383 0.651,0.346 0.688,0.269 0.688,0.229 0.688,0.115 0.691,0.037 0.691,-0.035 z"
id="path148-33" />
<path
d="m 148.317,11.561 -0.536,0.308 -0.5,0.345 -0.495,0.345 -0.461,0.344 -0.46,0.343 -0.419,0.383 -0.424,0.421 -0.423,0.383 -0.384,0.422 -0.384,0.422 -0.382,0.421 -0.345,0.457 -0.383,0.422 -0.346,0.459 -0.344,0.459 -0.346,0.459 0.153,-0.496 0.192,-0.499 0.191,-0.537 0.229,-0.534 0.231,-0.536 0.265,-0.499 0.31,-0.498 0.346,-0.495 0.382,-0.46 0.461,-0.381 0.498,-0.385 0.537,-0.344 0.612,-0.269 0.652,-0.229 0.765,-0.152 0.805,-0.076 z"
id="path150-8" />
<path
d="m 142.614,6.961 -0.153,0.767 -0.114,0.767 -0.154,0.766 -0.116,0.689 -0.077,0.726 -0.114,0.689 -0.079,0.689 -0.115,0.689 -0.075,0.688 -0.117,0.689 -0.074,0.651 -0.118,0.689 -0.116,0.689 -0.115,0.689 -0.15,0.689 -0.157,0.727 -0.076,-0.842 -0.113,-0.805 -0.077,-0.843 -0.076,-0.841 -0.037,-0.807 -0.038,-0.805 0.039,-0.805 0.039,-0.764 0.076,-0.767 0.116,-0.688 0.194,-0.689 0.229,-0.651 0.269,-0.573 0.384,-0.537 0.422,-0.46 0.497,-0.421 z"
id="path152-9" />
<path
d="m 146.714,5.703 0.692,0.648 0.416,0.729 0.189,0.766 0.04,0.805 -0.153,0.804 -0.307,0.843 -0.424,0.844 -0.498,0.841 -0.575,0.804 -0.611,0.805 -0.653,0.764 -0.65,0.689 -0.614,0.689 -0.534,0.572 -0.463,0.539 -0.383,0.418 0.077,-1.147 0.154,-0.995 0.191,-0.844 0.307,-0.764 0.306,-0.65 0.386,-0.574 0.382,-0.535 0.424,-0.501 0.383,-0.496 0.424,-0.495 0.382,-0.538 0.307,-0.613 0.307,-0.688 0.23,-0.766 0.194,-0.919 0.075,-1.032 z"
id="path154-4" />
<path
d="m 141.803,17.951 v -0.805 l -0.039,-0.765 -0.034,-0.765 -0.04,-0.768 -0.036,-0.729 -0.077,-0.727 -0.076,-0.727 -0.073,-0.691 -0.117,-0.688 -0.114,-0.728 -0.189,-0.689 -0.152,-0.689 -0.193,-0.689 -0.268,-0.689 -0.229,-0.689 -0.306,-0.689 1.111,1.073 0.918,1.034 0.649,0.959 0.457,0.92 0.309,0.879 0.151,0.805 0.037,0.806 -0.077,0.727 -0.195,0.689 -0.187,0.651 -0.27,0.613 -0.271,0.533 -0.23,0.537 -0.229,0.459 -0.152,0.459 -0.078,0.383 z"
id="path156-1" />
<path
d="m 153.022,20.603 -0.613,0.114 -0.614,0.116 -0.611,0.075 -0.613,0.075 -0.609,0.038 -0.616,0.037 h -0.613 -0.575 l -0.612,-0.039 h -0.574 l -0.613,-0.077 -0.573,-0.038 -0.613,-0.04 -0.575,-0.075 -0.612,-0.079 -0.574,-0.075 0.498,0.229 0.498,0.192 0.535,0.231 0.537,0.19 0.574,0.193 0.576,0.151 0.61,0.156 0.61,0.076 0.612,0.039 h 0.651 l 0.651,-0.039 0.654,-0.15 0.651,-0.191 0.651,-0.27 0.648,-0.381 0.654,-0.46 z"
id="path158-6" />
<path
d="m 149.457,23.702 0.461,0.078 0.419,0.075 0.461,0.115 0.457,0.115 0.463,0.194 0.456,0.151 0.421,0.191 0.46,0.23 0.421,0.23 0.421,0.267 0.383,0.271 0.386,0.268 0.343,0.307 0.308,0.307 0.304,0.307 0.27,0.344 -0.269,-0.917 -0.422,-0.808 -0.494,-0.688 -0.615,-0.651 -0.688,-0.536 -0.768,-0.5 -0.84,-0.421 -0.882,-0.347 -0.919,-0.306 -0.919,-0.307 -0.955,-0.231 -0.958,-0.23 -0.957,-0.193 -0.919,-0.189 -0.843,-0.154 -0.842,-0.192 0.42,0.153 0.574,0.306 0.69,0.463 0.841,0.497 0.843,0.535 0.879,0.499 0.842,0.46 0.768,0.308 z"
id="path160-9" />
<path
d="m 151.214,30.559 0.345,-0.881 0.117,-0.844 -0.116,-0.842 -0.307,-0.766 -0.457,-0.729 -0.612,-0.727 -0.728,-0.69 -0.804,-0.614 -0.843,-0.613 -0.879,-0.536 -0.919,-0.538 -0.884,-0.459 -0.801,-0.42 -0.767,-0.387 -0.651,-0.344 -0.496,-0.309 0.532,1.113 0.538,0.919 0.573,0.728 0.536,0.652 0.574,0.498 0.574,0.459 0.574,0.346 0.574,0.346 0.571,0.346 0.577,0.382 0.572,0.384 0.536,0.46 0.537,0.573 0.535,0.691 0.497,0.806 0.498,0.995 z"
id="path162-2" />
<path
d="m 141.569,21.129 0.422,0.652 0.42,0.652 0.421,0.65 0.38,0.613 0.346,0.613 0.345,0.649 0.346,0.614 0.305,0.613 0.304,0.652 0.268,0.65 0.271,0.613 0.229,0.65 0.19,0.689 0.192,0.65 0.152,0.689 0.152,0.73 0.384,-1.455 0.191,-1.265 0.041,-1.149 -0.115,-0.994 -0.229,-0.844 -0.346,-0.766 -0.42,-0.652 -0.458,-0.537 -0.538,-0.499 -0.535,-0.421 -0.573,-0.346 -0.537,-0.306 -0.496,-0.306 -0.46,-0.268 -0.342,-0.307 -0.31,-0.271 z"
id="path164-8" />
</g>
</g>
<g
transform="matrix(-1.2697137,0,0,1.2697137,225.07184,26.323784)"
id="Layer_x0020_1-5">
<defs
id="defs167-2">
<linearGradient
x1="-3510.3682"
y1="4186.3037"
x2="-3520.3882"
y2="4153.2837"
id="linearGradient20285"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,-2022.5977,2980.6621)">
<stop
id="stop20287"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop20289"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop20291"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop20293"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop20295"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop20297"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop20299"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20301"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<g
id="g186-3"
style="fill:url(#linearGradient23811);fill-rule:nonzero;stroke:#000000;stroke-width:0.25400001;stroke-miterlimit:4">
<path
d="m 0.241,40.672 c 13.561,-1.867 63.613,-4.393 85.943,-8.051 17.961,-2.937 35.502,-8.285 52.242,-13.9 4.328,-1.453 11.991,-4.434 16.896,-7.07 3.104,-2.373 10.571,-5.889 12.606,-9.222 C 135.478,17.836 122.415,22.078 84.346,29.783 68.91,32.952 12.729,37.504 0.241,40.672 z"
id="path188-1"
style="fill:#000000;stroke-width:0.59560001" />
<defs
id="defs190-94">
<linearGradient
x1="-3788.0986"
y1="-3507.6162"
x2="-3789.1638"
y2="-3479.4058"
id="linearGradient20306"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20308"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop20310"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop20312"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop20314"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop20316"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop20318"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop20320"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20322"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 48.261,46.645 1.454,0.498 1.418,0.118 1.417,-0.229 1.417,-0.574 1.379,-0.766 1.38,-0.994 1.305,-1.146 1.301,-1.226 1.228,-1.26 1.149,-1.267 1.111,-1.224 1.035,-1.148 0.958,-0.957 0.881,-0.763 0.767,-0.501 0.689,-0.228 -0.576,0.036 -0.611,0.038 -0.689,0.077 -0.688,0.074 -0.69,0.078 -0.689,0.076 -0.689,0.038 -0.612,0.076 -0.957,0.88 -0.921,0.842 -0.805,0.842 -0.729,0.844 -0.727,0.801 -0.688,0.805 -0.652,0.764 -0.691,0.729 -0.688,0.727 -0.729,0.65 -0.767,0.65 -0.882,0.61 -0.919,0.576 -1.034,0.535 -1.149,0.496 -1.302,0.421 z"
id="path209-3"
style="fill:url(#AIgd2-1)" />
<defs
id="defs211-9">
<linearGradient
x1="-3817.4316"
y1="-3498.7192"
x2="-3818.3076"
y2="-3475.5176"
id="linearGradient20326"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20328"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop20330"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop20332"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop20334"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop20336"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop20338"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop20340"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20342"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 43.511,46.45 1.688,0.271 1.569,0.038 1.455,-0.15 1.377,-0.345 1.265,-0.534 1.151,-0.652 1.148,-0.766 1.034,-0.879 1.035,-0.918 0.957,-0.995 0.959,-1.072 0.921,-1.032 0.956,-1.033 0.96,-1.033 0.958,-0.955 0.995,-0.881 -0.381,0.037 h -0.423 l -0.384,0.039 -0.419,0.037 -0.424,0.037 -0.421,0.078 -0.42,0.035 -0.42,0.041 -0.421,0.037 -0.461,0.037 -0.422,0.078 -0.459,0.037 -0.459,0.037 -0.46,0.037 h -0.46 l -0.459,0.039 -0.347,0.535 -0.42,0.651 -0.537,0.765 -0.575,0.805 -0.69,0.881 -0.729,0.879 -0.766,0.918 -0.805,0.879 -0.844,0.844 -0.84,0.805 -0.885,0.726 -0.842,0.612 -0.844,0.496 -0.843,0.346 -0.804,0.189 h -0.768 z"
id="path230-2"
style="fill:url(#linearGradient3725-0)" />
<defs
id="defs232-7">
<linearGradient
x1="-3806.9058"
y1="-3505.3105"
x2="-3807.8401"
y2="-3480.5605"
id="linearGradient20346"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20348"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop20350"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop20352"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop20354"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop20356"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop20358"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop20360"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20362"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 40.371,46.487 0.958,0.115 0.919,0.076 0.881,-0.037 0.881,-0.152 0.882,-0.19 0.843,-0.344 0.841,-0.421 0.883,-0.574 0.882,-0.65 0.882,-0.764 0.882,-0.921 0.919,-0.993 0.958,-1.188 0.997,-1.3 1.034,-1.416 1.074,-1.607 -0.651,-0.002 -0.613,0.039 -0.614,0.076 -0.612,0.076 -0.611,0.078 -0.613,0.072 h -0.688 -0.727 l -0.616,0.612 -0.573,0.65 -0.576,0.614 -0.574,0.688 -0.575,0.65 -0.535,0.689 -0.576,0.648 -0.539,0.691 -0.572,0.65 -0.574,0.65 -0.612,0.65 -0.577,0.613 -0.65,0.572 -0.652,0.574 -0.65,0.573 -0.729,0.499 z"
id="path251-04"
style="fill:url(#AIgd4-46)" />
<path
d="m 37.041,46.329 0.728,0.387 0.802,0.153 0.807,-0.116 0.842,-0.342 0.844,-0.5 0.881,-0.689 0.88,-0.764 0.884,-0.917 0.841,-0.958 0.884,-0.993 0.804,-0.997 0.805,-0.957 0.768,-0.957 0.729,-0.84 0.689,-0.729 0.614,-0.613 -4.099,0.382 -0.462,0.612 -0.498,0.61 -0.458,0.616 -0.459,0.608 -0.46,0.614 -0.5,0.612 -0.461,0.612 -0.497,0.612 -0.537,0.573 -0.537,0.611 -0.536,0.578 -0.613,0.57 -0.612,0.574 -0.653,0.576 -0.688,0.536 -0.728,0.532 z"
id="path253-7"
style="fill:url(#linearGradient3727-1)" />
<defs
id="defs255-8">
<linearGradient
x1="-3825.4375"
y1="-3503.8936"
x2="-3826.3342"
y2="-3480.1453"
id="linearGradient20367"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20369"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop20371"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop20373"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop20375"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop20377"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop20379"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop20381"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20383"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 30.262,45.444 1.188,0.767 1.109,0.5 1.11,0.231 h 1.074 l 1.033,-0.191 0.995,-0.343 0.955,-0.538 0.96,-0.687 0.919,-0.841 0.923,-0.881 0.84,-1.037 0.884,-1.031 0.843,-1.109 0.844,-1.146 0.805,-1.148 0.805,-1.111 -0.688,0.115 -0.536,0.037 -0.384,0.037 -0.345,0.039 -0.343,0.039 -0.346,-10e-4 -0.499,0.037 -0.651,0.037 -0.729,1.034 -0.727,0.955 -0.729,0.921 -0.805,0.804 -0.767,0.727 -0.767,0.689 -0.804,0.611 -0.768,0.536 -0.766,0.458 -0.768,0.421 -0.727,0.306 -0.689,0.269 -0.689,0.229 -0.614,0.152 -0.612,0.075 -0.537,0.038 z"
id="path274-0"
style="fill:url(#AIgd6-5)" />
<path
d="m 26.7,45.21 1.228,0.153 1.186,0.08 1.149,-0.078 1.109,-0.151 1.036,-0.227 1.033,-0.345 0.958,-0.422 0.92,-0.535 0.92,-0.572 0.844,-0.651 0.843,-0.727 0.803,-0.804 0.766,-0.842 0.73,-0.918 0.729,-0.959 0.689,-0.994 -0.767,0.039 -0.844,0.074 -0.802,0.076 -0.806,0.038 -0.69,0.077 -0.574,0.035 -0.421,0.039 -0.191,0.037 -0.076,0.078 -0.191,0.19 -0.308,0.306 -0.382,0.385 -0.422,0.459 -0.536,0.536 -0.577,0.573 -0.648,0.614 -0.731,0.608 -0.764,0.65 -0.768,0.615 -0.843,0.611 -0.88,0.572 -0.881,0.535 -0.921,0.46 -0.92,0.385 z"
id="path276-6"
style="fill:url(#linearGradient3729-7)" />
<defs
id="defs278-5">
<linearGradient
x1="-3841.6636"
y1="-3502.4297"
x2="-3842.4236"
y2="-3482.3"
id="linearGradient20388"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20390"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop20392"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop20394"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop20396"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop20398"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop20400"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop20402"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20404"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 21.991,45.476 1.033,0.192 0.998,0.076 1.033,-0.113 1.034,-0.191 1.034,-0.342 0.994,-0.423 0.996,-0.497 0.998,-0.611 0.919,-0.648 0.918,-0.69 0.881,-0.726 0.845,-0.766 0.806,-0.804 0.766,-0.765 0.69,-0.768 0.651,-0.766 h -0.461 l -0.574,0.04 -0.611,0.036 H 34.29 l -0.613,0.073 -0.613,0.041 -0.496,0.039 -0.423,0.075 v 0.077 l -0.154,0.189 -0.381,0.347 -0.537,0.42 -0.652,0.535 -0.764,0.613 -0.845,0.652 -0.882,0.647 -0.92,0.687 -0.918,0.691 -0.881,0.65 -0.846,0.574 -0.765,0.539 -0.69,0.421 -0.537,0.305 -0.382,0.191 z"
id="path297-5"
style="fill:url(#AIgd8-4)" />
<path
d="m 16.782,45.434 0.612,0.612 0.806,0.267 0.996,10e-4 1.11,-0.266 1.227,-0.46 1.262,-0.646 1.341,-0.768 1.305,-0.841 1.302,-0.919 1.227,-0.916 1.147,-0.879 0.999,-0.844 0.881,-0.688 0.65,-0.574 0.423,-0.381 0.192,-0.154 -0.498,0.038 -0.538,0.036 -0.574,0.037 -0.572,0.041 -0.614,0.072 -0.614,0.039 -0.611,0.04 -0.652,0.038 -0.688,0.419 -0.688,0.422 -0.693,0.456 -0.649,0.425 -0.689,0.456 -0.653,0.498 -0.688,0.459 -0.653,0.459 -0.69,0.496 -0.65,0.461 -0.688,0.459 -0.651,0.458 -0.688,0.421 -0.691,0.422 -0.651,0.419 -0.69,0.384 z"
id="path299-7"
style="fill:url(#linearGradient3731-8)" />
<defs
id="defs301-6">
<linearGradient
x1="-3872.1543"
y1="-3503.9727"
x2="-3872.3848"
y2="-3493.1567"
id="linearGradient20409"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20411"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop20413"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop20415"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop20417"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop20419"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop20421"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 12.953,45.507 0.652,0.229 0.649,0.115 0.65,0.037 0.653,-0.11 0.65,-0.194 0.689,-0.265 0.727,-0.383 0.768,-0.46 0.843,-0.535 0.881,-0.612 0.959,-0.688 1.072,-0.728 1.187,-0.803 1.265,-0.881 1.379,-0.918 1.534,-0.957 -0.653,0.039 -0.727,0.039 -0.65,-0.001 -0.65,0.038 -0.574,0.037 -0.459,0.038 -0.307,0.039 -0.116,0.036 -0.077,0.115 -0.229,0.23 -0.346,0.307 -0.458,0.42 -0.575,0.499 -0.653,0.577 -0.689,0.571 -0.805,0.613 -0.805,0.611 -0.843,0.612 -0.843,0.534 -0.882,0.537 -0.842,0.457 -0.842,0.383 -0.805,0.267 -0.729,0.154 z"
id="path316-0"
style="fill:url(#linearGradient3733-6)" />
<defs
id="defs318-0">
<linearGradient
x1="-3878.0732"
y1="-3508.4204"
x2="-3874.5449"
y2="-3484.9487"
id="linearGradient20425"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20427"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop20429"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop20431"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop20433"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop20435"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop20437"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 10.158,45.084 0.879,0.344 0.958,0.152 0.998,-0.072 1.033,-0.268 1.072,-0.383 1.033,-0.498 1.074,-0.608 0.996,-0.69 0.958,-0.688 0.92,-0.728 0.843,-0.688 0.728,-0.691 0.653,-0.572 0.495,-0.499 0.383,-0.341 0.232,-0.232 -0.613,0.038 -0.577,0.04 -0.571,0.037 -0.575,0.074 -0.535,0.041 -0.577,0.037 -0.61,0.074 -0.613,0.038 -0.459,0.421 -0.501,0.42 -0.458,0.421 -0.499,0.46 -0.498,0.498 -0.497,0.459 -0.536,0.459 -0.538,0.458 -0.536,0.423 -0.534,0.421 -0.577,0.381 -0.534,0.343 -0.614,0.309 -0.574,0.266 -0.613,0.193 -0.613,0.152 z"
id="path333-2"
style="fill:url(#linearGradient3735-5)" />
<path
d="m 6.791,44.01 0.765,0.535 0.763,0.345 0.767,0.154 0.767,0.039 0.768,-0.151 0.766,-0.232 0.766,-0.343 0.765,-0.458 0.729,-0.498 0.766,-0.611 0.729,-0.613 0.729,-0.65 0.727,-0.648 0.69,-0.69 0.689,-0.649 0.69,-0.615 -0.422,0.041 -0.46,0.076 -0.497,0.037 -0.535,0.039 -0.575,0.074 -0.612,0.039 -0.652,0.074 -0.612,0.037 -0.192,0.461 -0.27,0.457 -0.271,0.422 -0.346,0.422 -0.381,0.383 -0.424,0.383 -0.42,0.381 -0.496,0.306 -0.5,0.308 -0.537,0.268 -0.573,0.268 -0.576,0.189 -0.612,0.154 -0.61,0.15 -0.654,0.077 -0.649,0.039 z"
id="path335-9"
style="fill:url(#linearGradient3737-7)" />
<path
d="m 3.763,43.434 0.652,0.266 0.69,0.193 0.726,0.115 0.806,10e-4 0.767,-0.038 0.842,-0.115 0.805,-0.229 0.803,-0.229 0.768,-0.344 0.729,-0.384 0.65,-0.421 0.614,-0.495 0.536,-0.538 0.46,-0.572 0.345,-0.651 0.23,-0.652 -0.46,0.04 -0.46,0.037 -0.497,0.076 -0.5,0.038 -0.495,0.038 -0.537,0.037 -0.574,0.039 -0.652,0.036 -0.271,0.385 -0.307,0.384 -0.306,0.345 -0.306,0.306 -0.307,0.306 -0.348,0.229 -0.343,0.27 -0.347,0.229 -0.381,0.191 -0.422,0.19 -0.421,0.19 -0.456,0.153 -0.462,0.152 -0.495,0.152 -0.537,0.116 -0.539,0.154 z"
id="path337-9"
style="fill:url(#linearGradient3739-5)" />
<path
d="m 2.193,42.896 0.23,0.229 0.347,0.152 0.42,0.078 H 3.65 L 4.186,43.317 4.759,43.205 5.372,43.012 5.984,42.823 6.597,42.553 7.211,42.246 7.823,41.904 8.36,41.519 8.897,41.099 9.355,40.64 9.7,40.18 10.007,39.682 9.664,39.723 9.356,39.76 8.973,39.798 8.63,39.836 8.286,39.875 7.979,39.911 7.711,39.912 7.442,39.911 v 0.153 L 7.1,40.37 6.524,40.792 5.757,41.29 4.84,41.786 3.918,42.285 2.999,42.666 2.193,42.896 z"
id="path339-60"
style="fill:url(#linearGradient3741-3)" />
<path
d="m 1.084,41.822 0.078,0.536 0.192,0.344 0.305,0.155 0.42,0.076 0.499,-0.075 0.574,-0.192 0.573,-0.229 0.614,-0.306 0.613,-0.346 0.574,-0.381 0.575,-0.381 0.461,-0.347 0.42,-0.307 0.307,-0.229 0.191,-0.152 0.038,-0.076 -2.986,0.341 -0.229,0.152 -0.386,0.192 -0.458,0.23 -0.5,0.229 -0.535,0.269 -0.497,0.189 -0.461,0.192 -0.384,0.114 z"
id="path341-7"
style="fill:url(#linearGradient3743-2)" />
<defs
id="defs343-5">
<linearGradient
x1="-3892.5645"
y1="-3497.0415"
x2="-3892.7126"
y2="-3490.0823"
id="linearGradient20445"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20447"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="0" />
<stop
id="stop20449"
style="stop-color:#f5d65d;stop-opacity:1"
offset="0.186" />
<stop
id="stop20451"
style="stop-color:#f4c35b;stop-opacity:1"
offset="0.38249999" />
<stop
id="stop20453"
style="stop-color:#f4bc5a;stop-opacity:1"
offset="0.51980001" />
<stop
id="stop20455"
style="stop-color:#f5da5d;stop-opacity:1"
offset="0.7809" />
<stop
id="stop20457"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 4.533,40.253 -0.651,0.039 -0.574,0.039 -0.536,0.036 -0.498,0.037 -0.46,0.04 -0.497,0.036 -0.498,0.077 -0.577,0.114 0.117,0.729 0.343,0.345 0.537,0.001 0.689,-0.19 0.689,-0.347 0.729,-0.382 0.651,-0.345 0.536,-0.229 z"
id="path358-4"
style="fill:url(#AIgd16-9)" />
<path
d="m 4.419,39.874 -0.653,0.112 -0.573,0.076 -0.497,0.114 -0.5,0.075 -0.458,0.114 -0.459,0.115 -0.537,0.116 -0.575,0.154 -0.038,-0.844 0.345,-0.536 0.537,-0.192 0.727,-0.034 0.766,0.151 0.766,0.193 0.651,0.23 0.499,0.154 z"
id="path360-5"
style="fill:url(#linearGradient3745-0)" />
<defs
id="defs362-2">
<linearGradient
x1="-3716.793"
y1="-3522.1724"
x2="-3726.813"
y2="-3555.1924"
id="linearGradient20462"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20464"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop20466"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop20468"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop20470"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop20472"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop20474"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop20476"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20478"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 44.258,24.317 1.684,-0.651 1.611,-0.419 1.491,-0.113 1.417,0.076 1.379,0.309 1.262,0.459 1.227,0.652 1.187,0.729 1.149,0.845 1.11,0.919 1.106,0.959 1.074,0.996 1.071,0.957 1.07,0.921 1.073,0.882 1.109,0.807 -0.384,0.073 -0.421,0.038 -0.421,0.039 -0.383,0.076 -0.423,0.039 -0.421,0.038 -0.459,0.036 -0.421,0.039 -0.422,0.035 -0.461,0.041 -0.458,0.076 -0.422,0.037 -0.461,0.04 -0.457,0.074 -0.498,0.037 -0.461,0.077 -0.382,-0.534 -0.495,-0.653 -0.576,-0.766 -0.688,-0.768 -0.727,-0.843 -0.805,-0.843 -0.879,-0.844 -0.881,-0.806 -0.959,-0.766 -0.953,-0.688 -0.957,-0.615 -0.997,-0.497 -0.957,-0.385 -0.958,-0.23 -0.956,-0.039 -0.88,0.152 z"
id="path381-8"
style="fill:url(#linearGradient3747-7)" />
<defs
id="defs383-8">
<linearGradient
x1="-3818.3081"
y1="-3506.1616"
x2="-3836.2568"
y2="-3532.4282"
id="linearGradient20482"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20484"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop20486"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop20488"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop20490"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop20492"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop20494"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop20496"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20498"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 41.383,24.964 0.96,-0.345 0.92,-0.227 0.878,-0.152 0.923,-0.077 0.878,0.077 0.919,0.192 0.88,0.268 0.919,0.423 0.956,0.537 0.959,0.691 0.995,0.803 1.033,0.96 1.108,1.11 1.11,1.266 1.186,1.418 1.264,1.57 -0.69,0.039 -0.611,0.072 -0.576,0.039 -0.534,0.076 -0.537,0.076 -0.573,0.076 -0.653,0.113 -0.765,0.117 -0.689,-0.574 -0.65,-0.613 -0.689,-0.653 -0.612,-0.653 -0.649,-0.649 -0.649,-0.65 L 47.781,29.641 47.13,28.99 46.479,28.378 45.791,27.804 45.14,27.228 44.452,26.654 43.725,26.156 42.958,25.733 42.192,25.312 41.387,24.965 z"
id="path402-5"
style="fill:url(#linearGradient3749-2)" />
<path
d="m 38.167,25.805 0.727,-0.611 0.808,-0.307 0.88,-0.074 0.879,0.191 0.958,0.383 0.956,0.538 0.995,0.688 0.996,0.805 0.996,0.881 0.993,0.921 0.956,0.921 0.92,0.958 0.841,0.88 0.84,0.805 0.729,0.691 0.69,0.574 -4.176,0.496 L 47.619,33.932 47.083,33.317 46.585,32.704 46.052,32.093 45.515,31.48 44.981,30.829 44.408,30.215 43.873,29.639 43.26,29.065 42.648,28.492 41.996,27.954 41.308,27.456 40.58,26.959 39.814,26.536 39.01,26.153 38.167,25.807 z"
id="path404-7"
style="fill:url(#linearGradient3751-1)" />
<path
d="m 31.886,28.481 1.148,-1.111 1.111,-0.802 1.073,-0.534 1.072,-0.307 1.072,-0.037 1.034,0.154 1.033,0.385 0.996,0.498 0.994,0.689 0.955,0.804 0.996,0.921 0.919,0.996 0.957,1.035 0.917,1.111 0.918,1.111 0.919,1.11 -0.729,0.04 -0.611,0.035 -0.498,0.039 -0.461,0.076 -0.458,0.076 -0.499,0.075 -0.571,0.078 -0.692,0.112 -0.803,-1.034 -0.766,-0.919 -0.803,-0.844 -0.766,-0.728 -0.802,-0.612 -0.766,-0.538 -0.728,-0.461 -0.768,-0.382 -0.728,-0.309 -0.688,-0.229 -0.728,-0.192 -0.689,-0.152 -0.648,-0.08 -0.653,-0.074 h -0.649 l -0.612,-0.002 z"
id="path406-5"
style="fill:url(#linearGradient3753-4)" />
<path
d="m 27.402,29.512 1.267,-0.461 1.187,-0.344 1.187,-0.189 1.109,-0.077 1.111,0.001 1.071,0.155 1.035,0.231 0.996,0.347 0.995,0.419 0.919,0.537 0.957,0.613 0.878,0.689 0.882,0.768 0.84,0.842 0.806,0.922 0.803,0.996 -0.803,0.115 -0.919,0.111 -0.921,0.115 -0.921,0.115 -0.842,0.113 -0.649,0.08 -0.499,0.037 L 37.7,35.645 37.625,35.57 37.433,35.417 37.164,35.149 36.821,34.803 36.398,34.383 35.903,33.959 35.328,33.463 34.678,32.925 33.95,32.426 33.185,31.89 32.341,31.39 31.423,30.895 30.503,30.471 29.51,30.088 28.476,29.74 27.403,29.511 z"
id="path408-9"
style="fill:url(#linearGradient3755-9)" />
<path
d="m 21.735,30.196 1.034,-0.418 1.035,-0.307 1.108,-0.115 1.073,10e-4 1.111,0.118 1.108,0.229 1.072,0.346 1.111,0.422 1.033,0.498 1.033,0.537 0.995,0.651 0.994,0.651 0.882,0.693 0.881,0.727 0.802,0.728 0.726,0.729 -0.495,0.037 -0.612,0.076 -0.689,0.075 -0.728,0.077 -0.729,0.075 -0.652,0.076 -0.573,0.037 h -0.422 l -10e-4,-0.077 -0.191,-0.191 -0.38,-0.268 -0.574,-0.385 -0.689,-0.42 -0.805,-0.5 -0.919,-0.537 -0.956,-0.533 -0.955,-0.54 L 26.367,32.15 25.369,31.654 24.453,31.197 23.607,30.81 22.845,30.503 22.229,30.31 21.734,30.195 z"
id="path410-6"
style="fill:url(#linearGradient3757-6)" />
<path
d="m 16.373,31.303 0.537,-0.842 0.805,-0.498 0.996,-0.188 h 1.147 l 1.264,0.268 1.379,0.422 1.455,0.576 1.415,0.651 1.455,0.729 1.339,0.766 1.265,0.73 1.149,0.727 0.954,0.615 0.729,0.459 0.496,0.342 0.23,0.117 -0.537,0.116 -0.61,0.077 -0.653,0.073 -0.689,0.038 -0.727,0.078 -0.729,0.074 -0.688,0.115 -0.689,0.115 -0.729,-0.346 -0.688,-0.348 -0.729,-0.381 -0.688,-0.385 -0.69,-0.346 -0.688,-0.383 -0.728,-0.384 -0.688,-0.382 -0.689,-0.35 -0.688,-0.382 -0.729,-0.343 -0.688,-0.307 -0.689,-0.348 -0.727,-0.305 -0.727,-0.311 -0.729,-0.266 z"
id="path412-9"
style="fill:url(#linearGradient3759-6)" />
<path
d="m 9.518,33.135 0.844,-0.611 0.956,-0.346 0.996,-0.149 1.07,10e-4 1.113,0.189 1.148,0.348 1.11,0.421 1.108,0.5 1.035,0.574 1.032,0.575 0.919,0.614 0.804,0.536 0.727,0.499 0.574,0.46 0.42,0.306 0.229,0.193 -0.612,0.074 -0.574,0.077 -0.495,0.076 -0.501,0.037 -0.536,0.037 -0.496,0.076 -0.576,0.078 -0.61,0.074 L 18.666,37.432 18.13,37.084 17.556,36.664 16.982,36.281 16.37,35.86 15.757,35.439 15.145,35.016 14.533,34.633 13.919,34.249 13.272,33.941 12.62,33.636 12.007,33.404 11.359,33.215 10.744,33.098 H 10.13 l -0.612,0.037 z"
id="path414-6"
style="fill:url(#linearGradient3761-1)" />
<path
d="m 12.044,32.029 0.653,-0.423 0.688,-0.305 0.652,-0.154 0.688,-0.074 0.689,0.037 0.728,0.152 0.807,0.27 0.838,0.308 0.921,0.423 0.959,0.459 1.07,0.576 1.147,0.614 1.265,0.65 1.378,0.692 1.49,0.765 1.648,0.768 -0.613,0.04 -0.689,0.073 -0.688,0.078 -0.691,0.112 -0.613,0.078 -0.457,0.078 -0.346,0.035 -0.153,-0.035 -0.075,-0.079 -0.27,-0.19 -0.345,-0.309 -0.459,-0.344 -0.573,-0.422 -0.689,-0.459 -0.729,-0.5 -0.803,-0.499 -0.879,-0.498 -0.882,-0.497 -0.955,-0.425 -0.957,-0.384 -0.959,-0.304 -0.957,-0.196 -0.92,-0.111 -0.919,-0.001 z"
id="path416-8"
style="fill:url(#linearGradient3763-3)" />
<path
d="m 6.451,35.086 0.691,-0.766 0.726,-0.574 0.729,-0.382 0.766,-0.229 0.767,-0.037 0.804,0.076 0.844,0.192 0.804,0.271 0.84,0.422 0.805,0.42 0.842,0.536 0.843,0.539 0.843,0.536 0.803,0.574 0.805,0.578 0.803,0.496 -0.459,0.076 -0.498,0.038 -0.574,0.116 -0.613,0.072 -0.649,0.079 -0.69,0.073 -0.65,0.078 -0.653,0.075 -0.229,-0.497 -0.269,-0.422 -0.305,-0.422 -0.384,-0.383 -0.383,-0.344 -0.419,-0.27 -0.5,-0.271 -0.497,-0.229 -0.536,-0.191 -0.572,-0.154 -0.58,-0.112 -0.612,-0.079 -0.65,-0.037 -0.652,0.001 -0.65,0.073 -0.689,0.078 z"
id="path418-35"
style="fill:url(#linearGradient3765-7)" />
<path
d="m 1.738,37.609 0.193,-0.306 0.306,-0.268 0.422,-0.228 0.459,-0.154 0.536,-0.114 0.612,-0.036 0.613,10e-4 0.689,0.037 0.65,0.114 0.689,0.155 0.652,0.229 0.61,0.269 0.576,0.308 0.534,0.383 0.422,0.422 0.381,0.461 L 9.739,38.958 9.32,39.034 8.9,39.11 8.477,39.184 8.095,39.221 7.787,39.262 H 7.56 7.482 L 7.329,39.184 6.948,38.954 6.296,38.647 5.53,38.304 4.649,37.995 3.654,37.726 2.697,37.572 1.738,37.608 z"
id="path420-6"
style="fill:url(#linearGradient3767-3)" />
<path
d="m 0.818,39.178 -0.036,-0.609 0.152,-0.461 0.271,-0.307 0.42,-0.191 0.497,-0.078 0.575,0.041 0.613,0.076 0.688,0.154 0.65,0.229 0.65,0.231 0.613,0.23 0.535,0.23 0.46,0.23 0.383,0.154 0.191,0.152 0.078,0.036 L 4.493,39.828 4.223,39.716 3.803,39.599 3.344,39.446 2.81,39.294 2.274,39.179 1.739,39.105 1.24,39.104 0.818,39.178 z"
id="path422-5"
style="fill:url(#linearGradient3769-5)" />
<path
d="m 3.349,36.616 0.612,-0.498 0.651,-0.383 0.729,-0.342 0.805,-0.231 0.806,-0.153 0.803,-0.11 0.844,10e-4 0.841,0.072 0.804,0.156 0.804,0.27 0.729,0.307 0.689,0.383 0.649,0.461 0.536,0.535 0.421,0.613 0.344,0.689 -0.499,0.039 -0.457,0.077 -0.5,0.036 -0.536,0.076 -0.535,0.078 -0.574,0.037 L 10.7,38.844 10.05,38.916 9.819,38.575 9.551,38.267 9.244,38 8.901,37.73 8.519,37.5 8.098,37.27 7.675,37.078 7.216,36.927 6.757,36.773 6.26,36.657 5.8,36.581 5.301,36.541 4.804,36.504 4.308,36.503 3.809,36.541 3.349,36.616 z"
id="path424-3"
style="fill:url(#linearGradient3771-6)" />
<defs
id="defs426-3">
<linearGradient
x1="-3644.5117"
y1="-3531.5527"
x2="-3636.6318"
y2="-3508.3506"
id="linearGradient20513"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20515"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop20517"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop20519"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop20521"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop20523"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop20525"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop20527"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop20529"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop20531"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20533"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 139.689,18.299 0.077,0.117 0.192,0.307 0.267,0.497 0.344,0.613 0.386,0.727 0.382,0.806 0.346,0.92 0.303,0.918 0.228,0.959 0.079,0.92 -0.042,0.917 -0.192,0.842 -0.422,0.768 -0.651,0.687 -0.919,0.535 -1.189,0.384 0.193,-0.578 0.117,-0.611 0.113,-0.611 0.076,-0.689 0.039,-0.689 V 25.31 l -0.037,-0.69 -0.037,-0.729 -0.076,-0.729 -0.074,-0.725 -0.116,-0.69 -0.152,-0.651 -0.113,-0.651 -0.154,-0.575 -0.188,-0.574 -0.155,-0.498 0.191,-0.075 0.154,-0.04 0.19,-0.076 0.156,-0.036 0.153,-0.077 0.15,-0.039 0.191,-0.078 0.19,-0.076 z"
id="path449-2"
style="fill:url(#linearGradient3773-4)" />
<path
d="m 138.389,18.835 0.534,2.108 0.382,1.914 0.189,1.646 0.037,1.455 -0.077,1.264 -0.23,1.072 -0.307,0.92 -0.347,0.764 -0.46,0.613 -0.497,0.496 -0.498,0.347 -0.495,0.267 -0.54,0.191 -0.459,0.076 -0.42,0.037 h -0.384 l 0.229,-0.613 0.229,-0.612 0.192,-0.688 0.154,-0.689 0.152,-0.767 0.118,-0.764 0.116,-0.767 0.075,-0.803 0.041,-0.806 0.001,-0.843 -0.041,-0.804 -0.073,-0.843 -0.114,-0.804 -0.155,-0.843 -0.188,-0.766 -0.229,-0.805 0.457,-0.154 0.463,-0.152 0.422,-0.152 0.418,-0.115 0.348,-0.113 0.381,-0.115 0.306,-0.076 0.27,-0.077 z"
id="path451-0"
style="fill:url(#linearGradient3775-0)" />
<path
d="m 135.285,19.792 0.231,0.765 0.227,0.959 0.155,1.073 0.072,1.186 0.041,1.303 -0.002,1.301 -0.116,1.301 -0.192,1.267 -0.271,1.187 -0.345,1.109 -0.499,0.957 -0.572,0.766 -0.731,0.574 -0.84,0.304 -0.96,0.04 -1.108,-0.307 0.422,-0.691 0.421,-0.727 0.347,-0.766 0.307,-0.727 0.229,-0.803 0.231,-0.768 0.152,-0.805 0.154,-0.805 0.077,-0.804 0.038,-0.841 v -0.805 l -0.073,-0.842 -0.076,-0.842 -0.152,-0.806 -0.152,-0.845 -0.229,-0.803 0.383,-0.152 0.458,-0.152 0.461,-0.153 0.46,-0.153 0.46,-0.151 0.382,-0.153 0.346,-0.117 0.267,-0.074 z"
id="path453-2"
style="fill:url(#linearGradient3777-8)" />
<path
d="m 125.546,35.674 1.036,0.08 0.997,-0.154 0.879,-0.381 0.805,-0.535 0.766,-0.73 0.652,-0.879 0.536,-0.994 0.499,-1.109 0.384,-1.188 0.309,-1.266 0.192,-1.3 0.078,-1.302 0.001,-1.301 -0.114,-1.303 -0.229,-1.265 -0.343,-1.188 -0.422,0.152 -0.425,0.154 -0.456,0.114 -0.463,0.152 -0.458,0.154 -0.497,0.153 -0.46,0.152 -0.497,0.152 v 0.804 l -0.001,0.879 -0.04,0.999 -0.039,1.033 -0.039,1.033 -0.038,1.072 -0.116,1.11 -0.113,1.032 -0.156,1.035 -0.154,0.961 -0.233,0.919 -0.268,0.806 -0.308,0.687 -0.384,0.577 -0.421,0.419 -0.461,0.267 z"
id="path455-3"
style="fill:url(#linearGradient3779-4)" />
<defs
id="defs457-2">
<linearGradient
x1="-3738.23"
y1="-3453.355"
x2="-3733.0664"
y2="-3424.071"
id="linearGradient20540"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop20542"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop20544"
style="stop-color:#6f1182;stop-opacity:1"
offset="0.0752" />
<stop
id="stop20546"
style="stop-color:#831380;stop-opacity:1"
offset="0.1935" />
<stop
id="stop20548"
style="stop-color:#a3157b;stop-opacity:1"
offset="0.33989999" />
<stop
id="stop20550"
style="stop-color:#d11975;stop-opacity:1"
offset="0.50880003" />
<stop
id="stop20552"
style="stop-color:#f21b71;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20554"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 128.277,22.083 -0.384,0.153 -0.383,0.114 -0.343,0.115 -0.386,0.077 -0.382,0.114 -0.347,0.113 -0.384,0.116 -0.38,0.153 -0.077,0.766 -0.041,0.84 -0.039,0.92 -0.038,0.958 -0.001,0.958 -0.001,1.031 -0.04,1.037 -0.039,0.994 -0.076,0.997 -0.115,0.994 -0.193,0.919 -0.191,0.844 -0.305,0.802 -0.346,0.727 -0.422,0.616 -0.536,0.496 1.108,-0.268 0.919,-0.383 0.767,-0.533 0.651,-0.614 0.537,-0.729 0.423,-0.839 0.306,-0.919 0.232,-0.959 0.156,-1.072 0.112,-1.11 0.039,-1.15 0.042,-1.225 0.037,-1.225 0.039,-1.264 0.001,-1.264 0.078,-1.303 z"
id="path474-4"
style="fill:url(#AIgd35-5)" />
<defs
id="defs476-2">
<linearGradient
x1="-3716.3066"
y1="-3509.6641"
x2="-3713.6802"
y2="-3491.7153"
id="linearGradient20558"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20560"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop20562"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop20564"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop20566"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop20568"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop20570"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop20572"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop20574"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop20576"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20578"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 118.116,38.426 1.531,-0.074 1.304,-0.305 1.07,-0.497 0.882,-0.651 0.689,-0.842 0.502,-0.958 0.419,-1.071 0.27,-1.188 0.154,-1.226 0.114,-1.261 0.041,-1.305 0.001,-1.262 10e-4,-1.305 0.001,-1.223 0.076,-1.15 0.078,-1.071 -0.421,0.114 -0.383,0.113 -0.343,0.117 -0.387,0.113 -0.382,0.113 -0.343,0.115 -0.384,0.077 -0.423,0.114 0.039,0.113 0.075,0.269 0.078,0.423 0.114,0.537 0.074,0.688 0.078,0.768 0.039,0.881 -0.04,0.996 -0.114,1.035 -0.195,1.145 -0.347,1.189 -0.42,1.225 -0.614,1.265 -0.766,1.339 -0.921,1.3 -1.15,1.339 z"
id="path499-3"
style="fill:url(#linearGradient3781-9)" />
<path
d="m 112.905,40.07 1.035,0.191 1.035,-0.073 0.995,-0.346 0.996,-0.537 0.956,-0.725 0.92,-0.881 0.844,-1.07 0.769,-1.188 0.649,-1.265 0.576,-1.378 0.462,-1.456 0.309,-1.489 0.192,-1.496 0.041,-1.531 -0.152,-1.454 -0.308,-1.456 -3.638,1.146 0.037,0.613 0.037,0.729 -0.038,0.801 -0.08,0.92 -0.112,0.958 -0.192,1.034 -0.192,1.072 -0.308,1.109 -0.347,1.109 -0.421,1.073 -0.461,1.071 -0.575,1.035 -0.612,0.995 -0.729,0.919 -0.805,0.841 -0.883,0.727 z"
id="path501-0"
style="fill:url(#linearGradient3783-5)" />
<defs
id="defs503-4">
<linearGradient
x1="-3716.5049"
y1="-3512.9565"
x2="-3712.3662"
y2="-3473.3286"
id="linearGradient20583"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20585"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop20587"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop20589"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop20591"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop20593"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop20595"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop20597"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop20599"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop20601"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20603"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 118.662,24.987 -0.573,0.189 -0.729,0.191 -0.807,0.268 -0.84,0.229 -0.806,0.27 -0.804,0.227 -0.689,0.191 -0.537,0.115 -0.076,0.881 -0.042,0.955 -0.075,0.959 -0.038,0.995 -0.117,0.995 -0.077,1.037 -0.115,0.994 -0.153,0.996 -0.19,0.956 -0.232,0.921 -0.309,0.916 -0.344,0.842 -0.422,0.807 -0.498,0.688 -0.536,0.65 -0.65,0.576 0.766,0.114 0.803,-0.038 0.804,-0.19 0.805,-0.343 0.804,-0.5 0.807,-0.612 0.768,-0.763 0.766,-0.958 0.689,-1.034 0.611,-1.227 0.578,-1.339 0.495,-1.528 0.388,-1.65 0.307,-1.758 0.194,-1.955 0.077,-2.066 z"
id="path526-0"
style="fill:url(#linearGradient3785-9)" />
<path
d="m 103.98,41.593 1.725,0.081 1.455,-0.154 1.265,-0.418 0.998,-0.653 0.841,-0.802 0.691,-0.958 0.497,-1.072 0.386,-1.224 0.308,-1.225 0.19,-1.343 0.116,-1.3 0.117,-1.302 0.038,-1.303 0.078,-1.188 0.075,-1.11 0.117,-0.995 -0.535,0.114 -0.463,0.115 -0.419,0.153 -0.418,0.112 -0.463,0.117 -0.422,0.111 -0.496,0.154 -0.576,0.151 -0.116,1.038 -0.112,0.992 -0.116,0.996 -0.156,0.955 -0.116,0.961 -0.153,0.918 -0.189,0.879 -0.194,0.881 -0.269,0.844 -0.308,0.841 -0.382,0.805 -0.422,0.806 -0.536,0.801 -0.576,0.767 -0.689,0.728 -0.77,0.726 z"
id="path528-8"
style="fill:url(#linearGradient3787-4)" />
<path
d="m 99.349,42.433 1.532,0.078 1.34,-0.192 1.188,-0.418 1.036,-0.65 0.88,-0.805 0.766,-0.957 0.615,-1.107 0.537,-1.188 0.458,-1.227 0.347,-1.3 0.269,-1.266 0.194,-1.299 0.19,-1.226 0.116,-1.15 0.116,-1.073 0.079,-0.919 -0.539,0.117 -0.459,0.112 -0.42,0.115 -0.423,0.077 -0.38,0.113 -0.425,0.074 -0.495,0.152 -0.576,0.115 -0.192,1.496 -0.229,1.417 -0.27,1.301 -0.269,1.226 -0.31,1.109 -0.345,1.071 -0.383,0.919 -0.384,0.883 -0.383,0.803 -0.425,0.727 -0.459,0.613 -0.422,0.573 -0.459,0.536 -0.461,0.42 -0.498,0.383 -0.459,0.345 z"
id="path530-0"
style="fill:url(#linearGradient3789-0)" />
<defs
id="defs532-82">
<linearGradient
x1="-3711.1768"
y1="-3514.0366"
x2="-3709.7402"
y2="-3493.4663"
id="linearGradient20609"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20611"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop20613"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop20615"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop20617"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop20619"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop20621"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop20623"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop20625"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop20627"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20629"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 94.98,43.004 1.457,0.078 1.302,-0.189 1.151,-0.424 1.071,-0.611 0.881,-0.802 0.805,-0.919 0.69,-1.072 0.614,-1.146 0.535,-1.189 0.422,-1.263 0.347,-1.264 0.308,-1.262 0.271,-1.188 0.192,-1.149 0.152,-1.031 0.155,-0.922 -0.459,0.076 -0.46,0.116 -0.462,0.114 -0.459,0.115 -0.462,0.115 -0.458,0.112 -0.46,0.114 -0.497,0.117 -0.038,0.725 -0.116,0.805 -0.153,0.843 -0.269,0.918 -0.27,0.995 -0.382,0.957 -0.385,1.033 -0.422,0.998 -0.499,0.996 -0.537,0.957 -0.534,0.879 -0.577,0.84 -0.574,0.806 -0.614,0.69 -0.649,0.572 -0.617,0.459 z"
id="path555-8"
style="fill:url(#AIgd41-9)" />
<defs
id="defs557-8">
<linearGradient
x1="-3718.4951"
y1="-3510.1016"
x2="-3716.7441"
y2="-3482.9595"
id="linearGradient20633"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20635"
style="stop-color:#681083;stop-opacity:1"
offset="0" />
<stop
id="stop20637"
style="stop-color:#681083;stop-opacity:1"
offset="0.0006" />
<stop
id="stop20639"
style="stop-color:#8d0f6d;stop-opacity:1"
offset="0.072" />
<stop
id="stop20641"
style="stop-color:#ad0d5a;stop-opacity:1"
offset="0.1459" />
<stop
id="stop20643"
style="stop-color:#c80a4a;stop-opacity:1"
offset="0.2229" />
<stop
id="stop20645"
style="stop-color:#de083e;stop-opacity:1"
offset="0.30410001" />
<stop
id="stop20647"
style="stop-color:#ed0335;stop-opacity:1"
offset="0.39129999" />
<stop
id="stop20649"
style="stop-color:#f60030;stop-opacity:1"
offset="0.48840001" />
<stop
id="stop20651"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20653"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 90.197,43.881 1.49,0.193 1.38,-0.191 1.264,-0.496 1.15,-0.766 1.073,-0.955 0.921,-1.148 0.84,-1.301 0.77,-1.341 0.613,-1.415 0.537,-1.381 0.46,-1.302 0.384,-1.262 0.23,-1.074 0.192,-0.88 0.114,-0.65 0.001,-0.381 -0.573,0.111 -0.537,0.115 -0.535,0.152 -0.536,0.115 -0.536,0.152 -0.5,0.113 -0.497,0.115 -0.499,0.078 -0.191,0.651 -0.19,0.765 -0.229,0.879 -0.271,0.996 -0.308,1.035 -0.343,1.071 -0.384,1.069 -0.424,1.114 -0.461,1.07 -0.497,0.995 -0.537,0.959 -0.574,0.842 -0.653,0.725 -0.65,0.574 -0.728,0.422 -0.765,0.229 z"
id="path580-8"
style="fill:url(#linearGradient3791-0)" />
<path
d="m 86.712,43.688 1.377,0.307 1.223,0.001 1.113,-0.267 1.034,-0.535 0.882,-0.729 0.805,-0.881 0.727,-1.068 0.652,-1.15 0.539,-1.226 0.498,-1.261 0.384,-1.265 0.385,-1.227 0.307,-1.147 0.231,-1.035 0.23,-0.918 0.189,-0.727 -0.419,0.076 -0.423,0.038 -0.38,0.075 -0.347,0.076 -0.384,0.076 -0.346,0.078 -0.305,0.074 -0.345,0.041 -0.118,0.879 -0.189,0.919 -0.232,0.917 -0.228,0.883 -0.309,0.918 -0.347,0.881 -0.382,0.844 -0.461,0.842 -0.46,0.842 -0.537,0.804 -0.615,0.765 -0.61,0.688 -0.729,0.69 -0.727,0.611 -0.806,0.574 -0.879,0.535 z"
id="path582-5"
style="fill:url(#linearGradient3793-6)" />
<path
d="m 82.345,44.374 1.147,0.002 1.112,-0.115 1.07,-0.268 1.037,-0.384 0.956,-0.533 0.959,-0.65 0.842,-0.763 0.841,-0.842 0.73,-0.96 0.69,-1.032 0.614,-1.15 0.573,-1.186 0.461,-1.264 0.385,-1.34 0.347,-1.379 0.23,-1.414 -0.498,0.113 -0.499,0.076 -0.536,0.115 -0.496,0.074 -0.497,0.078 -0.459,0.112 -0.5,0.077 -0.459,0.115 -0.231,0.805 -0.191,0.842 -0.231,0.805 -0.194,0.803 -0.23,0.804 -0.228,0.804 -0.307,0.766 -0.346,0.804 -0.42,0.767 -0.463,0.803 -0.576,0.766 -0.688,0.766 -0.768,0.729 -0.918,0.765 -1.073,0.766 -1.188,0.726 z"
id="path584-3"
style="fill:url(#linearGradient3795-0)" />
<path
d="m 76.14,45.095 1.495,0.118 1.454,-0.076 1.34,-0.229 1.266,-0.382 1.187,-0.497 1.112,-0.649 1.033,-0.768 0.918,-0.917 0.844,-0.955 0.767,-1.073 0.693,-1.148 0.573,-1.222 0.496,-1.304 0.425,-1.34 0.307,-1.377 0.233,-1.381 -0.423,0.076 -0.46,0.117 -0.456,0.074 -0.461,0.075 -0.459,0.078 -0.5,0.114 -0.497,0.076 -0.5,0.115 -0.152,0.955 -0.23,0.957 -0.31,0.96 -0.383,0.917 -0.457,0.918 -0.502,0.918 -0.574,0.882 -0.648,0.843 -0.691,0.844 -0.767,0.762 -0.808,0.727 -0.879,0.689 -0.921,0.611 -0.995,0.575 -0.997,0.497 -1.072,0.419 z"
id="path586-93"
style="fill:url(#linearGradient3797-7)" />
<path
d="m 72.732,45.475 1.264,-0.075 1.226,-0.189 1.228,-0.306 1.186,-0.458 1.112,-0.536 1.109,-0.648 1.034,-0.729 0.958,-0.842 0.881,-0.917 0.843,-0.993 0.73,-1.076 0.65,-1.109 0.536,-1.184 0.46,-1.226 0.348,-1.267 0.229,-1.299 -0.419,0.074 -0.385,0.037 -0.346,0.039 -0.343,0.039 -0.346,0.037 -0.382,0.077 -0.456,0.076 -0.539,0.075 -0.537,1.112 -0.459,1.031 -0.46,0.997 -0.422,0.919 -0.46,0.881 -0.424,0.805 -0.461,0.764 -0.498,0.727 -0.537,0.729 -0.613,0.649 -0.688,0.69 -0.765,0.611 -0.884,0.65 -0.996,0.611 -1.108,0.612 -1.265,0.61 z"
id="path588-2"
style="fill:url(#linearGradient3799-6)" />
<path
d="m 66.604,45.855 1.877,0.077 1.763,-0.073 1.57,-0.267 1.455,-0.422 1.34,-0.572 1.187,-0.691 1.113,-0.801 0.993,-0.92 0.921,-0.993 0.844,-1.072 0.729,-1.109 0.688,-1.189 0.652,-1.184 0.577,-1.187 0.538,-1.227 0.496,-1.187 -0.343,0.036 -0.461,0.078 -0.573,0.076 -0.575,0.076 -0.613,0.115 -0.537,0.076 -0.456,0.076 -0.347,0.035 -0.46,1.074 -0.499,1.074 -0.577,0.994 -0.573,0.955 -0.652,0.881 -0.688,0.879 -0.729,0.804 -0.804,0.807 -0.804,0.727 -0.885,0.688 -0.917,0.688 -0.96,0.613 -0.995,0.572 -1.072,0.535 -1.072,0.496 -1.149,0.46 z"
id="path590-7"
style="fill:url(#linearGradient3801-3)" />
<path
d="M 62.966,46.387 64,46.35 l 1.071,-0.152 1.15,-0.269 1.186,-0.419 1.188,-0.495 1.189,-0.613 1.188,-0.726 1.187,-0.803 1.149,-0.918 1.111,-0.957 1.035,-1.07 0.999,-1.15 0.879,-1.188 0.804,-1.262 0.691,-1.34 0.576,-1.38 -0.575,0.079 -0.575,0.074 -0.611,0.037 -0.612,0.077 -0.536,0.037 -0.461,0.077 -0.382,0.076 -0.192,0.115 -0.69,0.535 -0.689,0.575 -0.729,0.688 -0.729,0.688 -0.727,0.766 -0.767,0.802 -0.767,0.844 -0.768,0.845 -0.766,0.879 -0.804,0.842 -0.805,0.842 -0.845,0.84 -0.842,0.843 -0.845,0.763 -0.838,0.768 -0.882,0.688 z"
id="path592-3"
style="fill:url(#linearGradient3803-1)" />
<path
d="m 57.375,46.383 0.997,0.654 1.032,0.268 1.034,10e-4 1.073,-0.268 1.071,-0.536 1.073,-0.729 1.111,-0.916 1.11,-1.033 1.112,-1.188 1.148,-1.225 1.189,-1.301 1.188,-1.299 1.188,-1.264 1.226,-1.264 1.228,-1.148 1.226,-1.031 h -0.425 l -0.494,0.074 -0.576,0.038 -0.573,0.116 -0.613,0.079 -0.612,0.113 -0.572,0.115 -0.5,0.075 -0.956,0.88 -0.957,0.88 -0.923,0.919 -0.919,0.919 -0.881,0.916 -0.883,0.921 -0.88,0.92 -0.845,0.84 -0.844,0.84 -0.842,0.768 -0.805,0.688 -0.804,0.613 -0.805,0.535 -0.767,0.459 -0.766,0.343 -0.767,0.229 z"
id="path594-7"
style="fill:url(#linearGradient3805-7)" />
<path
d="m 53.046,46.879 1.572,0.001 1.492,-0.151 1.342,-0.385 1.304,-0.494 1.187,-0.614 1.109,-0.765 1.075,-0.84 0.995,-0.92 0.997,-0.994 0.956,-1.033 0.921,-1.035 0.959,-1.07 0.959,-1.07 0.994,-1.034 1.035,-0.957 1.072,-0.918 -0.382,0.04 -0.458,0.037 -0.577,0.074 -0.572,0.041 -0.577,0.073 -0.459,0.038 -0.382,0.041 -0.229,-0.001 -0.651,0.151 -0.652,0.306 -0.649,0.423 -0.692,0.573 -0.689,0.687 -0.729,0.805 -0.766,0.844 -0.769,0.915 -0.88,0.958 -0.883,0.955 -0.997,0.996 -1.032,0.959 -1.111,0.955 -1.188,0.88 -1.264,0.802 -1.381,0.729 z"
id="path596-4"
style="fill:url(#linearGradient3807-4)" />
<path
d="m 138.274,15.35 v -0.153 l 0.04,-0.42 0.038,-0.649 0.04,-0.807 0.039,-0.957 -0.037,-1.033 -0.038,-1.072 -0.111,-1.111 -0.229,-1.033 -0.309,-0.996 -0.38,-0.882 -0.572,-0.728 -0.654,-0.537 -0.843,-0.307 -1.034,-0.039 -1.186,0.306 0.385,0.384 0.343,0.459 0.345,0.574 0.306,0.613 0.305,0.689 0.27,0.689 0.264,0.767 0.271,0.804 0.228,0.767 0.19,0.806 0.194,0.803 0.188,0.766 0.155,0.768 0.152,0.727 0.114,0.65 0.113,0.613 0.19,-0.037 0.154,-0.037 0.189,-0.078 0.155,-0.037 0.151,-0.079 0.155,-0.075 0.192,-0.037 0.226,-0.078 z"
id="path598-9"
style="fill:url(#linearGradient3809-6)" />
<defs
id="defs600-4">
<linearGradient
x1="-3690.9155"
y1="-3526.2993"
x2="-3702.7354"
y2="-3558.2568"
id="linearGradient20666"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20668"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop20670"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop20672"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop20674"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop20676"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop20678"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop20680"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20682"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 136.86,15.925 -0.497,-2.489 -0.535,-2.108 -0.535,-1.801 -0.532,-1.492 -0.539,-1.188 -0.534,-0.958 -0.533,-0.689 -0.499,-0.497 -0.536,-0.347 -0.458,-0.153 -0.502,-0.039 -0.42,0.078 -0.419,0.152 -0.382,0.191 -0.348,0.229 -0.306,0.23 0.536,0.497 0.533,0.573 0.462,0.538 0.494,0.611 0.424,0.615 0.422,0.648 0.382,0.652 0.344,0.691 0.344,0.727 0.306,0.766 0.307,0.768 0.268,0.805 0.227,0.842 0.23,0.842 0.227,0.882 0.194,0.919 0.457,-0.077 0.345,-0.036 0.232,-0.077 0.153,-0.077 0.151,-0.037 0.156,-0.076 0.153,-0.04 0.229,-0.075 z"
id="path619-8"
style="fill:url(#linearGradient3811-8)" />
<path
d="m 134.944,16.651 -0.113,-0.918 -0.194,-1.035 -0.305,-1.15 -0.379,-1.226 -0.5,-1.264 -0.571,-1.227 -0.611,-1.187 -0.688,-1.111 -0.729,-0.996 -0.765,-0.843 -0.803,-0.65 -0.842,-0.425 -0.881,-0.152 -0.882,0.152 -0.842,0.499 -0.882,0.878 0.688,0.498 0.65,0.576 0.613,0.574 0.574,0.576 0.574,0.611 0.496,0.689 0.459,0.691 0.42,0.688 0.423,0.769 0.343,0.767 0.345,0.805 0.267,0.842 0.267,0.879 0.193,0.92 0.189,0.959 0.155,0.994 0.416,-0.114 0.461,-0.152 0.499,-0.153 0.498,-0.191 0.461,-0.189 0.421,-0.154 0.344,-0.151 0.23,-0.077 z"
id="path621-2"
style="fill:url(#linearGradient3813-4)" />
<path
d="m 120.017,6.607 0.919,-0.612 0.92,-0.344 0.957,-0.115 0.919,0.115 0.958,0.307 0.919,0.5 0.882,0.689 0.843,0.805 0.762,0.919 0.766,1.073 0.65,1.188 0.572,1.226 0.496,1.305 0.384,1.376 0.306,1.38 0.151,1.416 -0.46,0.115 -0.459,0.116 -0.46,0.15 -0.46,0.154 -0.497,0.191 -0.499,0.113 -0.457,0.154 -0.498,0.075 -0.346,-0.88 -0.305,-0.959 -0.383,-0.957 -0.348,-0.957 -0.379,-0.996 -0.419,-0.998 -0.423,-0.956 -0.421,-0.918 -0.456,-0.884 -0.499,-0.805 -0.533,-0.766 -0.539,-0.651 -0.609,-0.575 -0.615,-0.459 -0.648,-0.346 -0.69,-0.19 z"
id="path623-7"
style="fill:url(#linearGradient3815-6)" />
<path
d="m 115.804,7.75 1.455,-0.648 1.302,-0.344 1.149,-0.038 1.034,0.193 0.919,0.421 0.806,0.65 0.724,0.807 0.65,0.957 0.575,1.072 0.495,1.188 0.5,1.229 0.457,1.225 0.457,1.264 0.421,1.264 0.459,1.188 0.497,1.111 -0.421,0.037 -0.384,0.115 -0.383,0.113 -0.385,0.152 -0.381,0.118 -0.384,0.151 -0.421,0.114 -0.422,0.074 -0.038,-0.151 -0.038,-0.383 -0.114,-0.498 -0.114,-0.689 -0.189,-0.803 -0.27,-0.92 -0.306,-0.996 -0.42,-1.034 -0.494,-1.034 -0.574,-1.035 -0.728,-1.035 -0.803,-0.958 -0.96,-0.918 -1.07,-0.767 -1.228,-0.691 -1.375,-0.5 z"
id="path625-04"
style="fill:url(#linearGradient3817-7)" />
<path
d="m 110.366,8.552 0.882,-0.651 0.997,-0.42 1.069,-0.153 1.072,0.04 1.149,0.229 1.148,0.461 1.108,0.615 1.111,0.768 1.07,0.956 0.997,1.075 0.878,1.225 0.805,1.342 0.687,1.416 0.537,1.533 0.342,1.57 0.19,1.687 -3.945,1.029 -0.228,-0.649 -0.307,-0.77 -0.306,-0.803 -0.382,-0.881 -0.461,-0.92 -0.457,-0.956 -0.537,-0.961 -0.573,-0.956 -0.652,-0.957 -0.725,-0.92 -0.766,-0.842 -0.803,-0.808 -0.878,-0.728 -0.959,-0.613 -0.996,-0.537 -1.07,-0.421 z"
id="path627-0"
style="fill:url(#linearGradient3819-6)" />
<path
d="m 120.502,21.387 -0.572,0.115 -0.727,0.152 -0.729,0.23 -0.808,0.229 -0.764,0.267 -0.729,0.191 -0.649,0.189 -0.536,0.152 -0.382,-0.957 -0.421,-0.995 -0.422,-0.996 -0.42,-1.036 -0.421,-1.032 -0.458,-0.997 -0.498,-0.995 -0.497,-0.997 -0.533,-0.918 -0.573,-0.845 -0.614,-0.804 -0.651,-0.727 -0.65,-0.652 -0.728,-0.537 -0.804,-0.423 -0.804,-0.306 0.692,-0.459 0.764,-0.344 0.806,-0.23 0.88,-0.075 0.918,0.076 0.959,0.231 0.957,0.383 0.992,0.576 0.999,0.728 0.993,0.92 0.995,1.149 0.954,1.304 0.919,1.532 0.917,1.723 0.843,1.992 0.802,2.184 z"
id="path629-5"
style="fill:url(#linearGradient3821-4)" />
<path
d="m 101.288,11.34 1.571,-0.841 1.415,-0.498 1.304,-0.114 1.187,0.193 1.032,0.458 0.996,0.691 0.841,0.883 0.805,1.073 0.688,1.188 0.649,1.265 0.573,1.341 0.534,1.34 0.536,1.302 0.498,1.265 0.458,1.148 0.456,1.035 -0.534,0.076 -0.459,0.112 -0.422,0.079 -0.422,0.114 -0.421,0.114 -0.459,0.115 -0.498,0.076 -0.572,0.112 -0.5,-1.033 -0.458,-1.036 -0.46,-0.994 -0.458,-0.958 -0.459,-0.958 -0.495,-0.88 -0.5,-0.881 -0.495,-0.806 -0.575,-0.807 -0.61,-0.727 -0.612,-0.688 -0.688,-0.652 -0.769,-0.615 -0.801,-0.536 -0.92,-0.498 -0.956,-0.46 z"
id="path631-0"
style="fill:url(#linearGradient3823-8)" />
<path
d="m 96.537,12.715 1.419,-0.765 1.339,-0.383 1.265,-0.075 1.225,0.191 1.111,0.461 1.069,0.689 0.996,0.844 0.921,0.998 0.841,1.149 0.802,1.187 0.726,1.227 0.652,1.264 0.611,1.266 0.537,1.148 0.455,1.111 0.423,0.957 -0.574,0.113 -0.5,0.115 -0.46,0.113 -0.421,0.076 -0.458,0.115 -0.461,0.115 -0.536,0.076 -0.613,0.115 -0.688,-1.533 -0.688,-1.417 -0.646,-1.302 -0.651,-1.188 -0.614,-1.071 -0.573,-0.961 -0.61,-0.84 -0.574,-0.807 -0.612,-0.651 -0.613,-0.575 -0.611,-0.498 -0.65,-0.421 -0.653,-0.308 -0.685,-0.269 -0.731,-0.155 -0.765,-0.113 z"
id="path633-4"
style="fill:url(#linearGradient3825-6)" />
<path
d="m 92.937,13.747 1.378,-0.65 1.307,-0.308 1.222,10e-4 1.19,0.233 1.07,0.458 1.033,0.654 0.956,0.844 0.92,0.957 0.802,1.072 0.766,1.148 0.726,1.188 0.613,1.188 0.609,1.189 0.5,1.15 0.456,1.033 0.421,0.959 -0.459,0.113 -0.42,0.113 -0.424,0.076 -0.383,0.116 -0.421,0.077 -0.42,0.075 -0.462,0.113 -0.496,0.077 -0.231,-0.765 -0.342,-0.845 -0.42,-0.842 -0.497,-0.919 -0.535,-0.919 -0.651,-0.921 -0.649,-0.92 -0.728,-0.92 -0.765,-0.841 -0.805,-0.846 -0.803,-0.766 -0.804,-0.652 -0.843,-0.613 -0.805,-0.498 -0.802,-0.383 -0.806,-0.23 z"
id="path635-8"
style="fill:url(#linearGradient3827-5)" />
<path
d="m 88.608,14.852 1.417,-0.762 1.38,-0.345 1.379,0.039 1.301,0.385 1.264,0.612 1.226,0.879 1.149,1.038 1.069,1.147 0.995,1.229 0.881,1.264 0.8,1.227 0.65,1.187 0.536,1.036 0.422,0.879 0.23,0.652 0.113,0.383 -0.574,0.115 -0.498,0.113 -0.498,0.115 -0.5,0.115 -0.496,0.115 -0.459,0.074 -0.499,0.077 -0.497,0.076 -0.344,-0.651 -0.384,-0.804 -0.458,-0.882 -0.537,-0.921 -0.571,-1.033 -0.614,-1.034 -0.646,-0.997 -0.691,-1.034 -0.727,-0.959 -0.767,-0.881 -0.802,-0.804 -0.803,-0.652 -0.844,-0.537 -0.844,-0.345 -0.878,-0.152 -0.882,0.035 z"
id="path637-3"
style="fill:url(#linearGradient3829-3)" />
<path
d="m 85.468,16.077 1.266,-0.842 1.224,-0.459 1.149,-0.113 1.149,0.19 1.071,0.461 1.033,0.692 0.958,0.842 0.915,1.035 0.844,1.113 0.805,1.184 0.727,1.229 0.687,1.225 0.574,1.15 0.535,1.073 0.421,0.918 0.383,0.766 -0.46,0.077 -0.382,0.114 -0.344,0.115 -0.308,0.113 -0.347,0.114 -0.305,0.115 -0.308,0.078 -0.343,0.073 -0.344,-0.955 -0.421,-0.958 -0.422,-0.921 -0.46,-0.918 -0.537,-0.919 -0.531,-0.844 -0.613,-0.844 -0.65,-0.805 -0.689,-0.767 -0.764,-0.688 -0.765,-0.614 -0.844,-0.574 -0.919,-0.5 -0.919,-0.421 -0.996,-0.308 -1.071,-0.229 z"
id="path639-0"
style="fill:url(#linearGradient3831-8)" />
<path
d="m 81.483,16.993 1.113,-0.422 1.109,-0.266 1.148,-0.077 1.074,0.078 1.109,0.231 1.032,0.345 1.034,0.536 1.034,0.652 0.956,0.768 0.918,0.92 0.881,0.996 0.842,1.112 0.802,1.226 0.689,1.34 0.688,1.418 0.571,1.491 -0.498,0.077 -0.495,0.076 -0.501,0.115 -0.497,0.153 -0.496,0.115 -0.498,0.153 -0.497,0.115 -0.5,0.074 -0.343,-0.842 -0.343,-0.882 -0.347,-0.843 -0.342,-0.883 -0.422,-0.842 -0.419,-0.805 -0.501,-0.842 -0.534,-0.767 -0.649,-0.729 -0.688,-0.728 -0.805,-0.652 -0.88,-0.613 -0.996,-0.537 -1.11,-0.498 -1.261,-0.424 -1.381,-0.344 z"
id="path641-1"
style="fill:url(#linearGradient3833-8)" />
<path
d="m 75.815,18.329 1.455,-0.609 1.457,-0.385 1.34,-0.189 1.34,-0.037 1.265,0.191 1.226,0.346 1.147,0.498 1.111,0.652 0.992,0.805 0.994,0.919 0.884,1.036 0.84,1.15 0.764,1.264 0.652,1.34 0.611,1.381 0.535,1.491 -0.459,0.077 -0.46,0.076 -0.536,0.078 -0.501,0.074 -0.533,0.078 -0.538,0.074 -0.535,0.076 -0.535,0.076 -0.269,-1.072 -0.383,-0.994 -0.42,-0.996 L 86.726,24.77 86.151,23.889 85.5,23.046 84.812,22.241 84.046,21.512 83.204,20.823 82.288,20.249 81.329,19.71 80.334,19.251 79.263,18.905 78.151,18.598 77.005,18.407 75.817,18.329 z"
id="path643-3"
style="fill:url(#linearGradient3835-2)" />
<path
d="m 73.021,18.632 1.302,-0.19 1.262,-0.113 1.263,0.039 1.228,0.154 1.224,0.307 1.15,0.385 1.109,0.498 1.073,0.613 0.995,0.729 0.954,0.844 0.844,0.919 0.803,1.034 0.688,1.149 0.611,1.226 0.499,1.341 0.38,1.419 -0.46,0.035 -0.383,0.038 -0.382,0.077 -0.384,0.077 -0.384,0.074 -0.382,0.078 -0.46,0.114 -0.496,0.076 -0.651,-1.111 -0.613,-1.073 -0.532,-0.958 -0.5,-0.956 -0.535,-0.844 -0.498,-0.804 -0.497,-0.767 -0.572,-0.69 L 80.065,21.701 79.377,21.126 78.609,20.591 77.767,20.093 76.772,19.668 75.7,19.286 74.436,18.94 73.021,18.632 z"
id="path645-0"
style="fill:url(#linearGradient3837-4)" />
<path
d="m 66.933,19.432 1.914,-0.457 1.8,-0.268 1.646,-0.075 1.531,0.154 1.417,0.307 1.302,0.461 1.187,0.573 1.074,0.77 1.03,0.842 0.917,0.96 0.844,1.034 0.802,1.112 0.728,1.147 0.688,1.227 0.612,1.226 0.611,1.265 -0.307,0.037 -0.42,0.037 -0.459,0.115 -0.501,0.076 -0.496,0.115 -0.462,0.114 -0.419,0.036 -0.346,0.039 -0.571,-1.148 -0.613,-1.035 -0.689,-0.996 -0.726,-0.918 -0.766,-0.883 -0.805,-0.806 -0.879,-0.726 -0.919,-0.69 -0.956,-0.616 -0.996,-0.573 -1.034,-0.498 -1.07,-0.498 -1.111,-0.423 -1.147,-0.383 -1.189,-0.346 -1.222,-0.309 z"
id="path647-9"
style="fill:url(#linearGradient3839-0)" />
<path
d="m 63.295,19.811 1.068,-0.189 1.113,-0.037 1.225,0.038 1.263,0.192 1.267,0.271 1.3,0.384 1.303,0.497 1.302,0.614 1.3,0.729 1.224,0.845 1.186,0.92 1.147,1.035 1.035,1.149 0.956,1.225 0.841,1.342 0.728,1.455 -0.537,0.039 -0.533,0.076 -0.538,0.115 -0.536,0.113 -0.459,0.113 -0.385,0.117 -0.306,0.036 -0.19,-0.037 -0.769,-0.46 -0.763,-0.537 -0.804,-0.613 -0.843,-0.689 -0.843,-0.729 -0.878,-0.768 -0.92,-0.768 -0.916,-0.802 -0.959,-0.806 -0.956,-0.807 -0.995,-0.803 -0.996,-0.729 -1.033,-0.729 -0.995,-0.652 -1.071,-0.613 -1.031,-0.537 z"
id="path649-5"
style="fill:url(#linearGradient3841-9)" />
<path
d="m 58.197,21.262 0.958,-0.955 1.034,-0.572 1.074,-0.23 1.109,0.077 1.148,0.308 1.225,0.575 1.227,0.769 1.3,0.879 1.301,1.074 1.341,1.11 1.34,1.19 1.34,1.188 1.377,1.188 1.377,1.112 1.376,1.035 1.381,0.92 -0.421,0.074 -0.499,0.037 -0.612,0.041 -0.613,0.037 -0.648,0.037 h -0.653 -0.574 l -0.497,-0.002 -1.034,-0.766 -0.993,-0.804 -0.996,-0.808 -0.918,-0.842 -0.919,-0.805 -0.883,-0.807 -0.878,-0.805 -0.88,-0.767 -0.919,-0.688 -0.879,-0.651 -0.92,-0.575 -0.956,-0.5 L 61.417,21.914 60.383,21.569 59.31,21.377 58.2,21.26 z"
id="path651-8"
style="fill:url(#linearGradient3843-2)" />
<defs
id="defs653-7">
<linearGradient
x1="-3772.377"
y1="-3509.7163"
x2="-3797.2949"
y2="-3537.6816"
id="linearGradient20702"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2070.8274,1900.0875)">
<stop
id="stop20704"
style="stop-color:#4f0c81;stop-opacity:1"
offset="0" />
<stop
id="stop20706"
style="stop-color:#690c73;stop-opacity:1"
offset="0.0701" />
<stop
id="stop20708"
style="stop-color:#9a0a5b;stop-opacity:1"
offset="0.20900001" />
<stop
id="stop20710"
style="stop-color:#c20748;stop-opacity:1"
offset="0.33680001" />
<stop
id="stop20712"
style="stop-color:#e0053a;stop-opacity:1"
offset="0.45120001" />
<stop
id="stop20714"
style="stop-color:#f20032;stop-opacity:1"
offset="0.54809999" />
<stop
id="stop20716"
style="stop-color:#fa002f;stop-opacity:1"
offset="0.61580002" />
<stop
id="stop20718"
style="stop-color:#f7ee5f;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 54.368,21.719 1.61,-0.381 1.493,-0.152 1.415,0.076 1.343,0.271 1.262,0.461 1.226,0.575 1.186,0.729 1.148,0.805 1.11,0.919 1.109,0.922 1.071,0.995 1.111,0.996 1.109,0.958 1.107,0.959 1.188,0.843 1.185,0.807 -0.38,0.037 -0.498,0.075 -0.576,0.078 -0.576,0.036 -0.572,0.079 -0.5,0.072 -0.38,0.041 -0.231,0.037 L 69.64,31.955 68.95,31.766 68.223,31.418 67.457,30.922 66.691,30.308 65.848,29.58 64.969,28.773 64.05,27.929 63.091,27.048 62.06,26.13 60.951,25.248 59.803,24.404 58.541,23.596 57.239,22.868 55.86,22.217 l -1.494,-0.5 z"
id="path672-5"
style="fill:url(#linearGradient3845-3)" />
<path
d="m 49.543,23.057 1.417,-0.805 1.495,-0.342 h 1.455 l 1.49,0.309 1.495,0.576 1.494,0.804 1.454,0.96 1.415,1.034 1.339,1.149 1.302,1.15 1.263,1.075 1.148,0.993 1.033,0.844 0.956,0.65 0.843,0.385 0.726,0.116 -0.61,0.077 -0.653,0.113 -0.727,0.113 -0.765,0.117 -0.767,0.074 -0.767,0.115 -0.728,0.038 -0.651,0.04 -1.07,-0.806 -0.958,-0.766 -0.879,-0.767 -0.84,-0.728 -0.767,-0.73 -0.726,-0.725 -0.767,-0.691 -0.726,-0.651 -0.729,-0.612 -0.804,-0.576 -0.841,-0.537 -0.919,-0.496 -0.996,-0.461 -1.071,-0.383 -1.226,-0.348 -1.34,-0.307 z"
id="path674-5"
style="fill:url(#linearGradient3847-2)" />
<defs
id="defs676-3">
<linearGradient
x1="-3498.5225"
y1="4158.0396"
x2="-3482.3647"
y2="4209.6001"
id="linearGradient20723"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,-1982.8965,3021.3838)">
<stop
id="stop20725"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop20727"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop20729"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop20731"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop20733"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop20735"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop20737"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop20739"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop20741"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop20743"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<g
id="g699-6"
style="fill:url(#linearGradient23809)">
<defs
id="defs701-07">
<linearGradient
x1="-3704.9473"
y1="-3493.9082"
x2="-3688.7896"
y2="-3442.3477"
id="linearGradient20747"
gradientUnits="userSpaceOnUse"
gradientTransform="matrix(0.5318,4e-4,-4e-4,0.5318,2110.5286,1859.3658)">
<stop
id="stop20749"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="0" />
<stop
id="stop20751"
style="stop-color:#c9d9de;stop-opacity:1"
offset="0.0849" />
<stop
id="stop20753"
style="stop-color:#a5b8c2;stop-opacity:1"
offset="0.2184" />
<stop
id="stop20755"
style="stop-color:#728896;stop-opacity:1"
offset="0.3836" />
<stop
id="stop20757"
style="stop-color:#405766;stop-opacity:1"
offset="0.55369997" />
<stop
id="stop20759"
style="stop-color:#667d8b;stop-opacity:1"
offset="0.64170003" />
<stop
id="stop20761"
style="stop-color:#92a7b1;stop-opacity:1"
offset="0.74199998" />
<stop
id="stop20763"
style="stop-color:#b7c8d0;stop-opacity:1"
offset="0.83740002" />
<stop
id="stop20765"
style="stop-color:#cfdfe4;stop-opacity:1"
offset="0.92570001" />
<stop
id="stop20767"
style="stop-color:#d8e7eb;stop-opacity:1"
offset="1" />
</linearGradient>
</defs>
<path
d="m 142.305,7.35 0.191,-0.383 0.153,-0.42 0.152,-0.423 0.113,-0.421 0.117,-0.459 0.115,-0.496 0.077,-0.459 0.042,-0.5 0.036,-0.459 0.035,-0.498 10e-4,-0.499 -0.035,-0.46 -0.036,-0.459 -0.08,-0.457 -0.112,-0.461 -0.114,-0.42 0.611,0.804 0.459,0.882 0.345,0.842 0.189,0.88 0.076,0.919 v 0.92 l -0.116,0.918 -0.194,0.92 -0.228,0.918 -0.31,0.883 -0.343,0.879 -0.343,0.88 -0.385,0.843 -0.347,0.842 -0.346,0.765 -0.343,0.767 0.074,-0.152 0.037,-0.269 0.042,-0.266 v -0.345 l 0.037,-0.424 V 12.06 11.6 l 0.001,-0.496 0.038,-0.499 v -0.498 l 0.039,-0.534 0.04,-0.498 0.038,-0.461 0.078,-0.461 0.075,-0.42 0.116,-0.383 z"
id="path724-5"
style="fill:url(#linearGradient3849-2)" />
<path
d="m 153.974,23.252 -0.729,-0.422 -0.729,-0.462 -0.687,-0.421 -0.688,-0.422 -0.65,-0.383 -0.651,-0.422 -0.616,-0.385 -0.609,-0.42 -0.653,-0.384 -0.607,-0.384 -0.614,-0.422 -0.652,-0.382 -0.611,-0.386 -0.654,-0.342 -0.686,-0.386 -0.689,-0.382 0.61,0.61 0.613,0.616 0.613,0.611 0.612,0.576 0.65,0.611 0.651,0.536 0.65,0.539 0.688,0.497 0.651,0.461 0.689,0.383 0.651,0.346 0.688,0.269 0.688,0.229 0.688,0.115 0.691,0.037 0.691,-0.035 z"
id="path726-3"
style="fill:url(#linearGradient3851-9)" />
<path
d="m 148.277,7.928 -0.536,0.308 -0.5,0.345 -0.495,0.345 -0.461,0.344 -0.46,0.343 -0.419,0.383 -0.424,0.421 -0.423,0.383 -0.384,0.422 -0.384,0.422 -0.382,0.421 -0.345,0.457 -0.383,0.422 -0.346,0.459 -0.344,0.459 -0.346,0.459 0.153,-0.496 0.192,-0.499 0.191,-0.537 0.229,-0.534 0.231,-0.536 0.265,-0.499 0.31,-0.498 0.346,-0.495 0.382,-0.46 0.461,-0.381 0.498,-0.385 0.537,-0.344 0.612,-0.269 0.652,-0.229 0.765,-0.152 0.805,-0.076 z"
id="path728-70"
style="fill:url(#linearGradient3853-0)" />
<path
d="m 142.574,3.329 -0.153,0.767 -0.114,0.767 -0.154,0.766 -0.116,0.689 -0.076,0.727 -0.114,0.689 -0.079,0.689 -0.115,0.689 -0.077,0.688 -0.117,0.689 -0.074,0.651 -0.118,0.689 -0.116,0.689 -0.115,0.689 -0.15,0.689 -0.157,0.727 -0.076,-0.842 -0.113,-0.805 -0.077,-0.843 -0.076,-0.841 -0.037,-0.807 -0.038,-0.805 0.039,-0.805 0.039,-0.764 0.076,-0.767 0.116,-0.688 0.194,-0.689 0.229,-0.651 0.269,-0.573 0.384,-0.537 0.422,-0.46 0.497,-0.421 z"
id="path730-4"
style="fill:url(#linearGradient3855-7)" />
<path
d="m 146.674,2.071 0.692,0.648 0.416,0.729 0.189,0.766 0.04,0.805 -0.153,0.804 -0.307,0.843 -0.424,0.844 -0.498,0.841 -0.575,0.804 -0.611,0.805 -0.653,0.764 -0.65,0.689 -0.614,0.689 -0.534,0.572 -0.463,0.539 -0.383,0.418 0.077,-1.147 0.154,-0.995 0.191,-0.844 0.307,-0.764 0.306,-0.65 0.386,-0.574 0.382,-0.535 0.424,-0.501 0.383,-0.496 0.424,-0.495 0.382,-0.538 0.307,-0.613 0.307,-0.688 0.23,-0.766 0.194,-0.919 0.075,-1.032 z"
id="path732-1"
style="fill:url(#linearGradient3857-6)" />
<path
d="m 141.763,14.319 v -0.805 l -0.039,-0.765 -0.034,-0.765 -0.04,-0.768 -0.036,-0.729 -0.077,-0.727 -0.076,-0.727 -0.073,-0.691 -0.117,-0.688 -0.114,-0.728 -0.189,-0.689 -0.152,-0.689 -0.196,-0.688 -0.268,-0.689 -0.229,-0.689 -0.306,-0.689 1.111,1.073 0.918,1.034 0.649,0.959 0.457,0.92 0.309,0.879 0.151,0.805 0.037,0.806 -0.077,0.727 -0.195,0.689 -0.187,0.651 -0.27,0.613 -0.271,0.533 -0.23,0.537 -0.229,0.459 -0.152,0.459 -0.078,0.383 z"
id="path734-0"
style="fill:url(#linearGradient3859-9)" />
<path
d="m 152.982,16.97 -0.613,0.114 -0.614,0.116 -0.611,0.075 -0.613,0.075 -0.609,0.038 -0.616,0.037 h -0.613 -0.575 l -0.612,-0.039 h -0.574 l -0.613,-0.077 -0.573,-0.038 -0.613,-0.04 -0.575,-0.075 -0.612,-0.079 -0.574,-0.075 0.498,0.229 0.498,0.192 0.535,0.231 0.537,0.19 0.574,0.193 0.576,0.151 0.61,0.156 0.61,0.076 0.612,0.039 h 0.651 l 0.651,-0.039 0.654,-0.15 0.651,-0.191 0.651,-0.27 0.648,-0.381 0.654,-0.46 z"
id="path736-8"
style="fill:url(#linearGradient3861-9)" />
<path
d="m 149.417,20.07 0.461,0.078 0.419,0.075 0.461,0.115 0.457,0.115 0.463,0.194 0.456,0.151 0.421,0.191 0.46,0.23 0.421,0.23 0.421,0.267 0.383,0.271 0.386,0.268 0.343,0.307 0.308,0.307 0.304,0.307 0.27,0.344 -0.269,-0.917 -0.422,-0.808 -0.494,-0.688 -0.615,-0.651 -0.688,-0.536 -0.768,-0.5 -0.841,-0.42 -0.882,-0.347 -0.919,-0.306 -0.919,-0.307 -0.955,-0.231 -0.958,-0.23 -0.957,-0.193 -0.919,-0.189 -0.843,-0.154 -0.842,-0.192 0.42,0.153 0.574,0.306 0.69,0.463 0.841,0.497 0.843,0.535 0.879,0.499 0.842,0.46 0.768,0.308 z"
id="path738-8"
style="fill:url(#linearGradient3863-3)" />
<path
d="m 151.174,26.926 0.345,-0.881 0.117,-0.844 -0.116,-0.842 -0.307,-0.766 -0.457,-0.729 -0.612,-0.727 -0.728,-0.69 -0.804,-0.614 -0.843,-0.613 -0.879,-0.536 -0.919,-0.538 -0.884,-0.459 -0.801,-0.42 -0.767,-0.387 -0.651,-0.344 -0.496,-0.309 0.532,1.113 0.538,0.919 0.573,0.728 0.536,0.652 0.574,0.498 0.574,0.459 0.574,0.346 0.574,0.346 0.571,0.346 0.577,0.382 0.572,0.384 0.536,0.46 0.537,0.573 0.535,0.691 0.497,0.806 0.498,0.995 z"
id="path740-2"
style="fill:url(#linearGradient3865-3)" />
<path
d="m 141.529,17.497 0.422,0.652 0.42,0.652 0.421,0.65 0.38,0.613 0.346,0.613 0.345,0.649 0.346,0.614 0.305,0.613 0.304,0.652 0.268,0.65 0.271,0.613 0.229,0.65 0.19,0.689 0.192,0.65 0.152,0.689 0.152,0.73 0.384,-1.455 0.191,-1.265 0.041,-1.149 -0.115,-0.994 -0.229,-0.844 -0.346,-0.766 -0.42,-0.652 -0.458,-0.537 -0.538,-0.499 -0.535,-0.421 -0.573,-0.346 -0.537,-0.306 -0.496,-0.306 -0.46,-0.268 -0.342,-0.307 -0.31,-0.271 z"
id="path742-5"
style="fill:url(#linearGradient3867-6)" />
</g>
</g>
</g>
<g
transform="matrix(1.0394175,0,0,0.96207735,-22.857143,-470.71429)"
id="text17899"
style="font-size:32.17870712px;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:#b7b7b7;stroke-width:0.5;stroke-miterlimit:4;stroke-opacity:1;font-family:FreeSans;-inkscape-font-specification:FreeSans Bold">
<g
transform="scale(0.96207732,1.0394175)"
id="text5115"
style="font-size:32.71201324px;font-weight:normal;fill:#000000;stroke:#b7b7b7;font-family:Droid Sans;-inkscape-font-specification:Droid Sans">
<text
xml:space="preserve"
style="font-size:36.87817764px;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;text-align:end;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:end;fill:#000000;fill-opacity:1;stroke:none;font-family:Droid Sans;-inkscape-font-specification:Droid Sans Bold"
x="571.70752"
y="564.02405"
id="text4246"
sodipodi:linespacing="125%"
transform="scale(1.0846523,0.92195444)"><tspan
sodipodi:role="line"
id="tspan4248"
x="571.70752"
y="564.02405">Powered by httpd 2.4</tspan></text>
</g>
</g>
<g
transform="matrix(1.2427237,0,0,0.80468409,-22.857143,-470.71429)"
id="text17903"
style="font-size:49.70895004px;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#9c00ff;fill-opacity:1;stroke:none;font-family:Syncopate;-inkscape-font-specification:Syncopate Bold">
<g
transform="scale(0.99478937,1.0052379)"
id="text4222"
style="font-size:54.75603485px;font-weight:normal;fill:#000000;font-family:Droid Sans;-inkscape-font-specification:Droid Sans">
<path
d="m 240.06634,684.67398 -20.48004,0 -3.44899,6.95145 -11.06884,0 19.22343,-36.73574 11.06884,0 19.22344,36.73574 -11.06885,0 -3.44899,-6.95145 m -16.92411,-7.16534 13.42165,0 -6.68409,-13.52859 -6.73756,13.52859"
id="path4227"
style="font-weight:bold;fill:#2e00ff;fill-opacity:1;font-family:Syncopate;-inkscape-font-specification:Syncopate Bold" />
<path
d="m 301.88077,667.42903 c -5e-5,1.83592 -0.26741,3.52922 -0.80209,5.07991 -0.53477,1.5329 -1.39925,2.86081 -2.59343,3.98372 -1.17644,1.10511 -2.70932,1.96959 -4.59865,2.59342 -1.8894,0.62386 -4.18873,0.93579 -6.89797,0.93577 l -16.46959,0 0,11.60358 -9.91919,0 0,-36.73574 26.38878,0 c 2.70924,4e-5 5.00857,0.31196 6.89797,0.93577 1.88933,0.60606 3.42221,1.47053 4.59865,2.59343 1.19418,1.10513 2.05866,2.42412 2.59343,3.95698 0.53468,1.53291 0.80204,3.2173 0.80209,5.05316 m -10.02613,0.16042 c -4e-5,-0.85554 -0.12481,-1.58633 -0.37431,-2.19238 -0.23175,-0.62382 -0.62388,-1.13181 -1.1764,-1.52397 -0.55258,-0.3921 -1.27446,-0.67729 -2.16564,-0.85556 -0.89124,-0.19604 -1.98743,-0.29407 -3.28857,-0.2941 l -14.33068,0 0,9.46466 14.33068,0 c 1.30114,2e-5 2.39733,-0.0713 3.28857,-0.21389 0.89118,-0.16039 1.61306,-0.41885 2.16564,-0.77535 0.55252,-0.37429 0.94465,-0.85554 1.1764,-1.44376 0.2495,-0.58818 0.37427,-1.31006 0.37431,-2.16565"
id="path4229"
style="font-weight:bold;fill:#cb00c6;fill-opacity:1;font-family:Syncopate;-inkscape-font-specification:Syncopate Bold" />
<path
d="m 337.81442,684.67398 -20.48004,0 -3.44899,6.95145 -11.06885,0 19.22343,-36.73574 11.06885,0 19.22343,36.73574 -11.06884,0 -3.44899,-6.95145 m -16.92411,-7.16534 13.42165,0 -6.68409,-13.52859 -6.73756,13.52859"
id="path4231"
style="font-weight:bold;fill:#ff007e;fill-opacity:1;font-family:Syncopate;-inkscape-font-specification:Syncopate Bold" />
<path
d="m 398.29204,689.11221 c -1.28339,0.53473 -2.57565,1.01598 -3.87677,1.44376 -1.30121,0.42779 -2.64694,0.79318 -4.03719,1.09619 -1.39033,0.32084 -2.86083,0.56147 -4.4115,0.72188 -1.53291,0.16042 -3.18165,0.24063 -4.94622,0.24063 -3.74312,0 -7.1921,-0.40104 -10.34697,-1.20313 -3.13708,-0.80209 -5.84636,-2.00523 -8.12785,-3.60941 -2.26368,-1.622 -4.02828,-3.63614 -5.29379,-6.04241 -1.26553,-2.42409 -1.89829,-5.24922 -1.89828,-8.47543 -1e-5,-3.22616 0.63275,-6.04239 1.89828,-8.44868 1.26551,-2.42407 3.03011,-4.4382 5.29379,-6.04241 2.28149,-1.62198 4.99077,-2.83402 8.12785,-3.63615 3.15487,-0.80205 6.60385,-1.2031 10.34697,-1.20313 1.76457,3e-5 3.41331,0.0802 4.94622,0.24062 1.55067,0.16046 3.02117,0.40109 4.4115,0.72189 1.39025,0.30304 2.73598,0.66844 4.03719,1.09619 1.30112,0.42781 2.59338,0.90907 3.87677,1.44376 l 0,8.92994 c -1.01603,-0.55253 -2.08548,-1.09617 -3.20837,-1.63092 -1.12296,-0.55252 -2.36175,-1.04269 -3.71635,-1.4705 -1.35468,-0.44558 -2.843,-0.80206 -4.46497,-1.06945 -1.62203,-0.28516 -3.44902,-0.42775 -5.48095,-0.42778 -3.11926,3e-5 -5.71269,0.32086 -7.78027,0.9625 -2.04981,0.64171 -3.68964,1.49727 -4.91949,2.56669 -1.22989,1.06948 -2.09436,2.29935 -2.59343,3.68962 -0.49909,1.37249 -0.74863,2.79842 -0.74861,4.27781 -2e-5,0.98035 0.10693,1.95177 0.32083,2.91427 0.21388,0.94469 0.57036,1.84482 1.06946,2.70037 0.49906,0.83775 1.14964,1.6131 1.95175,2.32606 0.80207,0.71298 1.80023,1.32791 2.99447,1.84481 1.1942,0.51691 2.58449,0.92686 4.17087,1.22987 1.60415,0.28519 3.44896,0.42779 5.53442,0.42778 2.03193,10e-6 3.85892,-0.12476 5.48095,-0.37431 1.62197,-0.26735 3.11029,-0.61493 4.46497,-1.04272 1.3546,-0.42777 2.59339,-0.90902 3.71635,-1.44376 1.12289,-0.55254 2.19234,-1.114 3.20837,-1.68439 l 0,8.92994"
id="path4233"
style="font-weight:bold;fill:#ff1452;fill-opacity:1;font-family:Syncopate;-inkscape-font-specification:Syncopate Bold" />
<path
d="m 442.7011,691.62543 0,-15.31993 -25.23911,0 0,15.31993 -9.91918,0 0,-36.73574 9.91918,0 0,13.36817 25.23911,0 0,-13.36817 9.91919,0 0,36.73574 -9.91919,0"
id="path4235"
style="font-weight:bold;fill:#ff572c;fill-opacity:1;font-family:Syncopate;-inkscape-font-specification:Syncopate Bold" />
<path
d="m 462.56483,691.62543 0,-36.73574 37.19026,0 0,7.83375 -27.00371,0 0,6.06915 25.61342,0 0,7.83375 -25.61342,0 0,7.16534 27.37802,0 0,7.83375 -37.56457,0"
id="path4237"
style="font-weight:bold;fill:#ff940a;fill-opacity:1;font-family:Syncopate;-inkscape-font-specification:Syncopate Bold" />
</g>
</g>
</g>
</svg>
httpd-2.4.64/docs/icons/odf6odb.png 0000664 0001751 0001751 00000002027 11141176336 016722 0 ustar covener covener PNG
IHDR L4 UPLTE&&&'''('''((((()))33333\\]\]]^^ 0 tRNS @f bKGD H pHYs NIDATc`G P~mް}LaE n
kϟe?2KϘe!q4ׂ: u+pMgCnKpC Hp,qj^ Y))X]^ \x,~6NVyS' W DBgMlkgdNli/N 7Uʧ'Fɻ@[k
rSbBm
9!~n҂8@ w{kyC`QNjBT(?.D($r#&D0%6"PO[]"A `{ IENDB` httpd-2.4.64/docs/icons/odf6otf.png 0000664 0001751 0001751 00000002072 11141176336 016746 0 ustar covener covener PNG
IHDR L4 jPLTE!!!&&&'''(((33344455533\\]\]]^^ [A tRNS @f bKGD H pHYs \IDATc`E zھyUKgNppkm~El`: ]a, D0֎\+e٤{ up8͑eش~
%$!59V(s(kenޠ4eBO[sMe9DpŋfNjk.ρ\6wΌI`heB͙9eb7dMKFBDp)m,Y Qz;[k+DYDR }M5"BaA~ f O`kcMq~0@p-D,-?ć"KM"Xjenl dE Am4 box7 IENDB` httpd-2.4.64/docs/icons/odf6odc.png 0000664 0001751 0001751 00000001750 11141176336 016725 0 ustar covener covener PNG
IHDR L4 .PLTE33333\\]\]]^^ rU tRNS @f bKGD H pHYs FIDATc`D Ps!kW.[<q&Lq66&Vg1Nꅊ2nf[!٘cR[]e3IM AY͚( L8 ,833gMEI^V2Lp^զ̤` mU%E) >^d`wG`PM9H,N(]"$TZ ,(d,LNr҇ %
iCs<̅T B .ƆjJ
x!d vq07PQ2 p10 R눳e IENDB` httpd-2.4.64/docs/icons/odf6odp.png 0000664 0001751 0001751 00000001722 11141176336 016741 0 ustar covener covener PNG
IHDR L4 .PLTE33333\\]\]]^^ rU tRNS @f bKGD H pHYs 0IDATc`D Ps!kW.[<q&Lq66&Vg1Nꅊ2nf[!٘cR[]e3IM AY͚( L8 ,833gMEI^V2Lp^զ̤` mU%E) >`wG`P@J sS⣂| !BH*!yi>6\d$*T2_[kcC]5%`P0J`x8D A
00 i0P"7 IENDB` httpd-2.4.64/docs/icons/odf6odt.png 0000664 0001751 0001751 00000001727 11141176336 016752 0 ustar covener covener PNG
IHDR L4 .PLTE33333\\]\]]^^ rU tRNS @f bKGD H pHYs 5IDATc`D Ps!kW.[<q&Lq66&Vg1Nꅊ2nf[!٘cR[]e3IM AY͚( L8 ,833gMEI^V2Lp^զ̤` mU%E) >`wG`26C3bݝm-M!@x`2K!!m`nFrTX
D0U(Bl!+@#}] ̍Ud .@1
8D A
00 MOɟf IENDB` httpd-2.4.64/docs/icons/odf6odf.png 0000664 0001751 0001751 00000002027 11141176336 016726 0 ustar covener covener PNG
IHDR L4 XPLTE&&&'''(((33333\\]\]]^^ tRNS @f bKGD H pHYs KIDATc`A PrIoٸe9L%NVkW,
e9
K̜ e*i 9,;,1 uOQ`CV5+HMW F9VbZ[j ,v+xW[SME!Lp9't6Ԕd$B͟6b\r|Dp ]̢̱I}]5"iQ^ EB̂Q ֖¼TA&~owg[`cMIanZ %D0#%^"X T hbECܩL wsujPp p10( a & IENDB` httpd-2.4.64/docs/icons/index.png 0000664 0001751 0001751 00000000514 10671421551 016504 0 ustar covener covener PNG
IHDR 2o5 PLTEf333 VRL tRNS 0J bKGD H xIDAT[U
azACC ` @DJi4hǝ A"(;'Y.mj䙹*NGszWt⛑R>>??A 2; VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/compressed.png 0000664 0001751 0001751 00000002124 10664777241 017554 0 ustar covener covener PNG
IHDR L4 PLTEf3 ̙f3 f3 ffffff3f 3333f333 f 3 f3 ̙f3 ̙̙̙̙f̙3̙ ffffff3f 3333f333 f 3 ̙f3 ̙̙f3 ̙f3 ff̙ffff3f 33̙33f333 ̙ f 3 ffffff3f fff̙fff3f ffffff3f fffffffffff3ff f3f3f3f3ff33f3 f f f f ff 3f 3333f333 333̙3f333 3333f333 3f3f3f3ff3f33f 33333333f33333 3 3 3 3 f3 33 f 3 ̙ f 3 f 3 f f f ff f3 f 3 3 3 3f 33 3 f 3 w U D " w U D " w U D " ݻwwwUUUDDD""" %tRNS ?BO bKGD H oIDATm DQ
#56BƠH=f ѕi&"&E V|4p:U qP68x*DQ4FVd g"">7ІF:.
i 5; VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/pie2.gif 0000664 0001751 0001751 00000000306 10147723030 016207 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , E4X q(fHi.2^7rA,@(# e:Q)##Q ; httpd-2.4.64/docs/icons/world1.gif 0000664 0001751 0001751 00000000344 10147723030 016562 0 ustar covener covener GIF89a 3 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , c:훚ؚ[4L Ee fXGj*A(3|9L#"$Yv۰rSWv$,mtj)VoB ǃP ; httpd-2.4.64/docs/icons/folder.open.gif 0000664 0001751 0001751 00000000362 10147723030 017565 0 ustar covener covener GIF89a ̙f3333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , e(0Im&|`'g뺰#so uaJ:|ZQzuf=W
p/sFmC9*:5 ; httpd-2.4.64/docs/icons/xml.png 0000664 0001751 0001751 00000002035 11141176336 016176 0 ustar covener covener PNG
IHDR L4 RPLTE33---.-....///0/0/0/000333 tRNS @f bKGD H pHYs WIDATc@ Pq{vnݴ~5R(ǑCvغqe fBE9ݹmˆ>"ʱ{֍VX6DŽ(-^xI `ܼaeN @57UqXuI:Za͚9IE4/=)"`IJlu,qQYJ%EcB!zY@bY)B^>ʂ촄(F>W`s,TNFrL #-DHY<!*"XY&,`cn,NIff䶷652ŢB\ m,M t ɱAn@1s:D
00 n = IENDB` httpd-2.4.64/docs/icons/odf6oti.png 0000664 0001751 0001751 00000002123 11141176336 016746 0 ustar covener covener PNG
IHDR L4 PLTE!!!+++,,,,,----33344455533\\]\]]^^ F*6 tRNS @f bKGD H pHYs ZIDATc`C& v e >gW/r سcբ|`K `Cb(D /=9DمB @vn^*.4e"D [t-#.<`ĩQSkьl=;8Μ ܺejEsgLn(nZlS'5UAW/]4w֔dsg fOԧάR, 1}B*lIx DpJ+r<t\4/DOU8;-1&2D
"T al4Avʢܴ /7gK
` 20 sv^ŴeE IENDB` httpd-2.4.64/docs/icons/odf6ott.png 0000664 0001751 0001751 00000001776 11141176336 016776 0 ustar covener covener PNG
IHDR L4 FPLTE!!!33344455533\\]\]]^^ tRNS @f bKGD H pHYs DIDATc`B t݉[7[|y3)rrȭ^xi\`
Ed Dp;'ܚsY uKMd櫯`]x[oO;/3O1Dp, qV*n<%llb -
UO3h*HNΝ5qBO[C]eanZR\$Dpڄގ?`<2@
r3SbBܜl @ 27yy `eiAzr\X!DH>U>
l BsR"C|] - 5!)~@1S
D 0 `23S3 IENDB` httpd-2.4.64/docs/icons/odf6odm.png 0000664 0001751 0001751 00000002044 11141176336 016734 0 ustar covener covener PNG
IHDR L4 [PLTE---..../////33333\\]\]]^^ 3 tRNS @f bKGD H pHYs UIDATc`E PzC{vlݴuLQe.6NMV.e=rΚeŦy,Ǣ{ uYLUdC6N+JO Ml2$'rXpjiv6v"ಥsLc`NM.^0}N1|!&h;XDr ۚjr!;[j3 muELqaA>vҢt& o^F +`MyQfjB #1D$/=)&<GAP " wSR4ՆG9ٚjAYQ 8 b\
$ IENDB` httpd-2.4.64/docs/icons/odf6otg.png 0000664 0001751 0001751 00000002122 11141176336 016743 0 ustar covener covener PNG
IHDR L4 PLTE!!!***+**+++++,,,,,,----33344455533\\]\]]^^ Yz tRNS @f bKGD H pHYs _IDATcDF ys%' ܷk֍kT/۵m*\` < [}
2D ]z|ոU&C@o\¥8 "xgMڼ ϒk3]ţ`^F:<&v57A7oZulyΦbKϟ9C0"r3&q4I'BΛ=mR/t8[Nzb Dp)z٪ D!Ӧu6K秋FC'5KxC{:2S
Y<\ bl)Bb6#`d$Fy8YC9Q 'H
00 atL IENDB` httpd-2.4.64/docs/icons/odf6otp.png 0000664 0001751 0001751 00000001771 11141176336 016765 0 ustar covener covener PNG
IHDR L4 FPLTE!!!33344455533\\]\]]^^ tRNS @f bKGD H pHYs ?IDATc`B t݉[7[|y3)rrȭ^xi\`
Ed Dp;'ܚsY uKMd櫯`]x[oO;/3O1Dp, qV*n<%llb -
UO3h*HNΝ5qBO[C]eanZR\$Dpڄގ?`|<xB{k+ sb#] H*m U9 !~nJ$"@/;+c}]`|JM`JlD
D 0 Ja&! IENDB` httpd-2.4.64/docs/icons/odf6odi.png 0000664 0001751 0001751 00000002053 11141176336 016730 0 ustar covener covener PNG
IHDR L4 mPLTE+++,,,,,----33333\\]\]]^^ z
tRNS @f bKGD H pHYs JIDATc`E Pzޱu LiM.6N [ֳ._e=*kV.5"zMmeYgN eM۸n:+pm^Z}4u PeSZ!&;[6*Ml Yx=uΞTY\4{ľ溊0̩{@bŹLa]mMRL"LL>:If &a& u/`G4 X_ #DIE<;-.2ǝ"XTdn
,QGԄ0_ g[K3c} +7
:`` fO IENDB` httpd-2.4.64/docs/icons/odf6otc.png 0000664 0001751 0001751 00000002020 11141176336 016734 0 ustar covener covener PNG
IHDR L4 FPLTE!!!33344455533\\]\]]^^ tRNS @f bKGD H pHYs VIDATc`B t݉[7[|y3)rrȭ^xi\`
Ed Dp;'ܚsY uKMd櫯`]x[oO;/3O1Dp, qV*n<%llb -
UO3h*HNΝ5qBO[C]eanZR\$Dp|oGk}UY|VBL DO$- " o,IOw6WfȻ@ rZ - a>."Ԅ@/;+c}]`<2ЄF8Xi@P HA
00 *c=Wg IENDB` httpd-2.4.64/docs/icons/odf6oth.png 0000664 0001751 0001751 00000002046 11141176336 016751 0 ustar covener covener PNG
IHDR L4 XPLTE!!!33344455533\\]\]]^^wwxxyxyyzz{{ l.B9 tRNS @f bKGD H pHYs ZIDATc`B t黷oٸv%%ǎsrl\r9`j Ej8Dp/'ʦ$YęE uLgimn`]r IBʬ
dY'wv42@gcejk-+..[:wΖҼ4ӧMik//HΙ6/-)*"8eb_'H 0ިr>VxVn_/`gGcMY1P0* "PYVl.L "XQ `ij GE{9ڙCCb@1]-
` 20 Si IENDB` httpd-2.4.64/docs/icons/odf6odg.png 0000664 0001751 0001751 00000002060 11141176336 016724 0 ustar covener covener PNG
IHDR L4 mPLTE***+**+++++,,,,,,----33333\\]\]]^^ aar tRNS @f bKGD H pHYs OIDATc@ Pqޱc LiM^N [s,_8 *kVp,5"qSme9fN H۸n:pn^Zk4u PTZ!);[6*rqrMl YxRuΞ.^\4{ľ)
V0̩{:%EXc!ښ$X3RY} =-ul9)1B,~^.
q VfW`SmE>p\d %D$W562(͉"XԄ0_ g[K3c}
:`` n fj, IENDB` httpd-2.4.64/docs/icons/odf6ods.png 0000664 0001751 0001751 00000001713 11141176336 016744 0 ustar covener covener PNG
IHDR L4 .PLTE33333\\]\]]^^ rU tRNS @f bKGD H pHYs )IDATc`D Ps!kW.[<q&Lq66&Vg1Nꅊ2nf[!٘cR[]e3IM AY͚( L8 ,833gMEI^V2Lp^զ̤` mU%E) >`wG`26 89
CQTCҒ# m,!(*U B .BƆjB
x2 oG sc=
E9)q #;
`` lM<Ap IENDB` httpd-2.4.64/docs/icons/odf6ots.png 0000664 0001751 0001751 00000001762 11141176336 016770 0 ustar covener covener PNG
IHDR L4 FPLTE!!!33344455533\\]\]]^^ tRNS @f bKGD H pHYs 8IDATc`B t݉[7[|y3)rrȭ^xi\`
Ed Dp;'ܚsY uKMd櫯`]x[oO;/3O1Dp, qV*n<%llb -
UO3h*HNΝ5qBO[C]eanZR\$Dpڄގ?`<27V'Fɻ@QT@ rRC< - (*
!E Q vV ؈@?WkSC=mu
` 20ȣ P]n' IENDB` httpd-2.4.64/docs/icons/pie0.png 0000664 0001751 0001751 00000000403 10671421551 016227 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H 8IDAT[cd*H60p21002D000L @R'bL Hso( VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/pie6.png 0000664 0001751 0001751 00000000421 10671421551 016235 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H FIDAT[u̡
0E76$%:BE*̑' &&EZJr +vxcT.BwZ/ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/ps.png 0000664 0001751 0001751 00000000457 10671421551 016025 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H ^IDAT[
Eї0@`"vޯ#!D*.D$ԏ%`'IO]/8-h$d̓2^ 7\';
1W VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/layout.png 0000664 0001751 0001751 00000000503 10671421551 016710 0 ustar covener covener PNG
IHDR 2o5 PLTE333f3f333 _ tRNS @* bKGD H dIDAT[c(bccc `gG0ALvv0S0-( d%pTTTi@fGGc2 ih NxQ84c w,/A- VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/uuencoded.png 0000664 0001751 0001751 00000000450 10671421551 017347 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H WIDAT[ ! u @L_cLU@D4wC'<D}۶mt 兏Z5o},p՞ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/f.png 0000664 0001751 0001751 00000000450 10671421551 015621 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H WIDAT[α
W^1@ ϔ7HeU7$zRŌd ,sNit_L_Q#<RmG_ʒ)M VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/dvi.png 0000664 0001751 0001751 00000000461 10671421551 016160 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H `IDAT[ Уq dz&ҖR}=SD4UE#4Fn YGd1;lLI}jc55?'w9ÊD VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/box2.png 0000664 0001751 0001751 00000000520 10664777241 016260 0 ustar covener covener PNG
IHDR 2o5 PLTE̙333 3 f3 tRNS 0J bKGD H vIDATE1
0D)[Rh+VAHxDr}7&1zL5ؾVf͘NSg J)e.Ȭ$qc]y:;664C
L<ʩ(sFұRD&%=ɩ/c,$0
J VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/box1.gif 0000664 0001751 0001751 00000000373 10147723030 016225 0 ustar covener covener GIF89a ̙333 3 f3 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , n0#;D\iS1cuqk' @׆iXp~%0BC Պ9m1M:/<>n'W[2LL
; httpd-2.4.64/docs/icons/diskimg.gif 0000664 0001751 0001751 00000000247 10147723030 017003 0 ustar covener covener GIF89a 333 ! , @lh!)3(3
ViR^(,:h,*_ݶ/CdC>E9Ԓ_4%*ZmU`" nz0>'dϪ8`Wb.-|j*t* ; httpd-2.4.64/docs/icons/comp.blue.png 0000664 0001751 0001751 00000000512 10664777241 017273 0 ustar covener covener PNG
IHDR 2o5 PLTEffff333 f B{ tRNS 0J bKGD H pIDATu=
0 E:wЮ.]W^&A!T *P)h* Z'ˇK*3 Kl<}{MGki9Q|X+6ī
rC+'0 VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/left.png 0000664 0001751 0001751 00000000401 10671421551 016322 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H 6IDAT[c8
&00&*&d$ Q dd-0{3,^A VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/transfer.png 0000664 0001751 0001751 00000000516 10671421551 017223 0 ustar covener covener PNG
IHDR 2o5 PLTE33f 333 \ tRNS
A bKGD H vIDAT[M @E G~^` /S@鿄, 1ouvDZ~!!<ϛA^s1K 9+ (K6P)C!kZM 2 rS>qǣ:"W> h\ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/pie5.png 0000664 0001751 0001751 00000000425 10671421551 016240 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H JIDAT[u̱
@ Q/)S#S-}lhly狨H"|쏴 ;L[ 'aD+ e VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/screw2.png 0000664 0001751 0001751 00000000515 10671421551 016603 0 ustar covener covener PNG
IHDR 2o5 PLTE̙333 tRNS 0J bKGD H yIDAT[E1 a+pmv$̎WOdһ#D?BXc1,lhz .RY,R3Vؕ/P&0$;]?y Í_=gO& !ij VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/bomb.png 0000664 0001751 0001751 00000000567 10671421551 016324 0 ustar covener covener PNG
IHDR 2o5 !PLTE3̻fffUUU333 ٖ) tRNS
A bKGD H IDAT[Eα
0/!$
xT@c!X #(B*#dnJE|gĚ{ c\ںJLDT=`f؆ki
%q;TV~ND>cR!*H+C$g/2-Z䓞5x9A0SU VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/pie3.png 0000664 0001751 0001751 00000000424 10671421551 016235 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H IIDAT[cd*H6h ecZ$B L@2Ak*P/ N K $m VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/folder.png 0000664 0001751 0001751 00000000447 10671421551 016655 0 ustar covener covener PNG
IHDR 2o5 PLTE̙f3333 tRNS
A bKGD H RIDAT[cPP 0U 1ECCALC (j @pD®TWUc0qeP
q%Pp ~ yM VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/alert.red.png 0000664 0001751 0001751 00000000472 10671421551 017260 0 ustar covener covener PNG
IHDR 2o5 PLTE33f 333 tRNS @* bKGD H ^IDAT[m̻ @EыȘ[´`.l.,̖0O033K
2H*QHKι+ lu?BggmRVk !#B ' VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/image2.png 0000664 0001751 0001751 00000000563 10671421551 016545 0 ustar covener covener PNG
IHDR 2o5 $PLTE33̙ffff 333 3 3f ̷Y tRNS
A bKGD H IDAT[E;
@Wji
Us.b"`la6G8ՁKǔ1+ѭ4@{?3PMsOcM"-EW-[y}ȯϤ<L]?4,,I+kL障P?Y:Kr VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/pdf.png 0000664 0001751 0001751 00000000460 10671421551 016146 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H _IDAT[m EGu Pgj)n5 -%#LvPxcʙ/(׀a ƴӉw-|1ւBOn;HEK2l VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/patch.png 0000664 0001751 0001751 00000000466 10671421551 016502 0 ustar covener covener PNG
IHDR 2o5 PLTEfff 333 + tRNS
A bKGD H ^IDAT[α
0 DC8H+D` )%
=zraU7XȓacVk}ifX("@D4.;s^T<L?{#KH M*@|6 VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/down.png 0000664 0001751 0001751 00000000400 10671421551 016336 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H 5IDAT1 , $pP3ʋ0숣-v<+<g VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/comp.gray.png 0000664 0001751 0001751 00000000476 10671421551 017303 0 ustar covener covener PNG
IHDR 2o5 PLTEf333 VRL tRNS 0J bKGD H jIDAT[uQ
ay A#v]@_mZ1ظtiNBq O"ُ-ʋĵ3Xxh\P̀[n%U]Uz1J'.#!Ht VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/pie1.png 0000664 0001751 0001751 00000000427 10671421551 016236 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H LIDAT[cd*H6h ecZ0D2LeH``P
` Sd N K (N VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/uu.gif 0000664 0001751 0001751 00000000354 10147723030 016004 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , _80 @#)0bAfhQ#Go@W5k((vxH<Ħ8:i:NUo 1k^^;. |qy ; httpd-2.4.64/docs/icons/portal.png 0000664 0001751 0001751 00000000477 10664777241 016722 0 ustar covener covener PNG
IHDR 2o5 PLTE3̙3333 | tRNS
A bKGD H dIDATu1
L $WzZ,UВ7@: (-#" ʹ9 /TkU oJm(<~}g82~Yh%Do6gb VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/pie4.gif 0000664 0001751 0001751 00000000301 10147723030 016204 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , @4X q(fHi.2^7]r LI䒩D1rROI0
; httpd-2.4.64/docs/icons/screw2.gif 0000664 0001751 0001751 00000000407 10147723030 016557 0 ustar covener covener GIF89a ̙333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , zH0@$i;U"@TAW6,Aa@,N>H<JZ "gS7{i 3)bNvF;)\IW
c
#} 9/o@6(sUD3kk ; httpd-2.4.64/docs/icons/dir.png 0000664 0001751 0001751 00000000447 10671421551 016160 0 ustar covener covener PNG
IHDR 2o5 PLTE̙f3333 tRNS
A bKGD H RIDAT[cPP 0U 1ECCALC (j @pD®TWUc0qeP
q%Pp ~ yM VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/world1.png 0000664 0001751 0001751 00000000514 10664777241 016621 0 ustar covener covener PNG
IHDR /T PLTE 3 , tRNS 0J bKGD H ~IDATcWdݪ '825Z!kVEJJ UM
:4V3<XѱH6Rfxġ D`ZšPj-C
]
S\[ hZ` ?-=3 VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/diskimg.png 0000664 0001751 0001751 00000000327 10664777241 017042 0 ustar covener covener PNG
IHDR 2o5 PLTE 333 pW* tRNS @f bKGDa `IDAT}1
0 !+tv."iBhk%VHXǍ>&s.BqG$d@ e=K ^ -h$Vz03, IENDB` httpd-2.4.64/docs/icons/pie6.gif 0000664 0001751 0001751 00000000272 10147723030 016215 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , 94X q(fHi.2.TE%a<"0
; httpd-2.4.64/docs/icons/burst.png 0000664 0001751 0001751 00000000525 10671421551 016536 0 ustar covener covener PNG
IHDR 2o5 PLTE3f fff333 jgx tRNS
A bKGD H }IDAT[u ! д `À%lL%f\o#~HEiEpvofHܿfkVVjf`+
N*wM
r&s#=[Y^Z^/0x 7$zUV4 VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/text.png 0000664 0001751 0001751 00000000440 10671421551 016357 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H OIDAT[ȱ
S` d@)E } ZvmeKGDj3f*t(VF)Ē "`_ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/tex.gif 0000664 0001751 0001751 00000000373 10147723030 016154 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , n80 @#i)! Ega5ny*u_;
` yx$$QD
RRE'Ԗp38Zn׀x#~/}i{eGF:oZ ; httpd-2.4.64/docs/icons/up.png 0000664 0001751 0001751 00000000377 10671421551 016030 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H 4IDAT[10 0 < BhT} KmhJ
dot=C VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/screw1.png 0000664 0001751 0001751 00000000510 10671421551 016575 0 ustar covener covener PNG
IHDR 2o5 PLTE̙333 tRNS 0J bKGD H tIDAT[U1 Dh URXʯ^!o0j܃F;2;; Ac$(Z>̂ͬyj]Lg1S%|; k(`uBd <Y7 {3 VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/image1.png 0000664 0001751 0001751 00000000505 10671421551 016540 0 ustar covener covener PNG
IHDR 2o5 PLTE3ff̙f 333 GH tRNS @* bKGD H fIDAT[}+@ X YY!8C@Wc#ǯL$\GJ=7XxEDdO@ `/
AqXZ1+r1d VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/sound2.png 0000664 0001751 0001751 00000000473 10671421551 016613 0 ustar covener covener PNG
IHDR 2o5 PLTE̙fff333 A tRNS 0J bKGD H dIDAT[M1
0@NP#Ĥ*u! BY; 0.RD Ta
~
½%2_ ug؛}e1J ')V6R VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/broken.png 0000664 0001751 0001751 00000000500 10671421551 016650 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H oIDAT[M P] p7Cb#Q\$Qk3m꼘! braŋi,أGPc q6,K&ESOfb+x?PǔU VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/pie4.png 0000664 0001751 0001751 00000000402 10671421551 016232 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H 7IDAT[cd*H6h ecZ$B 'bL )'Gꊡ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/ball.gray.png 0000664 0001751 0001751 00000000452 10671421551 017251 0 ustar covener covener PNG
IHDR 2o5 PLTE̻fffUUU333 j tRNS 0J bKGD H JIDAT[cR3g.n)La3sXD%tK2*N At۠L& A h VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/pie2.png 0000664 0001751 0001751 00000000420 10671421551 016230 0 ustar covener covener PNG
IHDR /T PLTE tRNS 0J bKGD H EIDAT[cd*H6h ecZ$B d`P@r* c`` 2a)| 1O!11! VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/generic.sec.png 0000664 0001751 0001751 00000000447 10671421551 017567 0 ustar covener covener PNG
IHDR 2o5 PLTE33f 333 \ tRNS
A bKGD H OIDAT[c
t
RRRb`t`eE0LV( aiiiP&ɀd;3XPH4# VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/forward.png 0000664 0001751 0001751 00000000464 10671421551 017045 0 ustar covener covener PNG
IHDR 2o5 PLTEfff333 tRNS 0J bKGD H `IDAT[E 0 DQ76&2ٲOO !@䐞VV ]sW#d߅'m;wuswB
YL37?`Q'8fL VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/uu.png 0000664 0001751 0001751 00000000450 10671421551 016025 0 ustar covener covener PNG
IHDR 2o5 PLTE333 U3 tRNS 0J bKGD H WIDAT[ ! u @L_cLU@D4wC'<D}۶mt 兏Z5o},p՞ VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/hand.right.gif 0000664 0001751 0001751 00000000331 10147723030 017374 0 ustar covener covener GIF89a ̙f3 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , L(0I ;W'b%b0l)8tXi{sVc(t[ (lVShJ ; httpd-2.4.64/docs/icons/blank.gif 0000664 0001751 0001751 00000000224 10147723030 016436 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , ڋI ; httpd-2.4.64/docs/icons/broken.gif 0000664 0001751 0001751 00000000367 10147723030 016637 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , j80 @#i;U"(1RDmL K:K
|hJ$Y '.fľ'wV@ٛ6*[uiR7
=</7? ; httpd-2.4.64/docs/icons/link.gif 0000664 0001751 0001751 00000000371 10147723030 016307 0 ustar covener covener GIF89a 33f 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , lXP@%i;U"QRFmL
K:KDz _sDV@T N6#m a^k +Ǻ}NzBD=</7? ; httpd-2.4.64/docs/icons/layout.gif 0000664 0001751 0001751 00000000424 10147723030 016666 0 ustar covener covener GIF89a 333f3f333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , oIx Gvm^IYq$l4aL r@kW HPh6=(Aa9(UBo\5& 2Wv-/s8GM/;xpukt}{[RQ?pH ; httpd-2.4.64/docs/icons/image2.gif 0000664 0001751 0001751 00000000465 10147723030 016522 0 ustar covener covener GIF89a 33̙ffff 333 3 3f !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , IX Gvm^IYv*:A,6 k-Ő6KX5 T%8kV b4j i e,|y7W /+fz%~ w
%PO@IR ; httpd-2.4.64/docs/icons/comp.gray.gif 0000664 0001751 0001751 00000000366 10147723030 017255 0 ustar covener covener GIF89a f333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , i0XaH 7+a˺ٌ`aH ϧ 0A@Zдj`kV1-ϊ`0+?P]۷\ y5i']\ ; httpd-2.4.64/docs/icons/transfer.gif 0000664 0001751 0001751 00000000362 10147723030 017176 0 ustar covener covener GIF89a 33f 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , e(*ս0 -2J]}JXq뒝!|C>_@9BUCI`3"tJ]Fة♥Ox,~!-O軻1it-)44 ; httpd-2.4.64/docs/icons/bomb.gif 0000664 0001751 0001751 00000000464 10147723030 016274 0 ustar covener covener GIF89a 3̻fffUUU333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , 0IX$Ivm^I
v$}ئIvDpH
%r[@-45 oJ V1z=b@X `8o,@ۅ y_,UIJgh ABxCJepf% UTBLW ; httpd-2.4.64/docs/icons/sound1.gif 0000664 0001751 0001751 00000000370 10147723030 016562 0 ustar covener covener GIF89a 33̙f 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , k(06B aUq h~
rwi4[AHkwṄ
O48fqz*** oԜCT:3M*6$>}J{v,{ ; httpd-2.4.64/docs/icons/generic.sec.gif 0000664 0001751 0001751 00000000371 10147723030 017537 0 ustar covener covener GIF89a 33f 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , lXZAIE=|e ]C([cz`ڬFb BXB %w"ƧuYmQw;`nXf6ޭ
I#J:BC ; httpd-2.4.64/docs/icons/patch.gif 0000664 0001751 0001751 00000000373 10147723030 016453 0 ustar covener covener GIF89a fff 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , nXP@%i;U"QRFmL
K@(~ B@\Z|t:}"JP@ -z⊗/,%bf< ;j:#j=</7? ; httpd-2.4.64/docs/icons/pdf.gif 0000664 0001751 0001751 00000000371 10147723030 016123 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , l80 @#IjU hV&L wU'eH{h$$DeYS%l(L?.E&zEdU-~]GF8ZZ ; httpd-2.4.64/docs/icons/f.gif 0000664 0001751 0001751 00000000354 10147723030 015600 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , _80 @#i;U"QDĩ+:|7<
@C `ScV|(*Mvأ.93KD[ŷ5*<q ; httpd-2.4.64/docs/icons/down.gif 0000664 0001751 0001751 00000000243 10147723030 016317 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , "4g{|"|(eULP ; httpd-2.4.64/docs/icons/unknown.gif 0000664 0001751 0001751 00000000365 10147723030 017054 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , h80 @#i;a"Qyʵ.J 70֧#$
@*,K|'"-K<%$`[˓j%<? $8@A ; httpd-2.4.64/docs/icons/p.gif 0000664 0001751 0001751 00000000355 10147723030 015613 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , `80 @#i;GUE%M + P@:aQ*!-DYV(szd ;/9hFu,Wü^x ; httpd-2.4.64/docs/icons/pie3.gif 0000664 0001751 0001751 00000000277 10147723030 016217 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , >4X q(fHi.2^7W6w-2: Q ; httpd-2.4.64/docs/icons/a.gif 0000664 0001751 0001751 00000000366 10147723030 015576 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , i80 @#i;U"(|<ڮ:W!UJ:<<>,;IkX݂
{ mhڭuO[?>28V ; httpd-2.4.64/docs/icons/dir.gif 0000664 0001751 0001751 00000000341 10147723030 016125 0 ustar covener covener GIF89a ̙f3333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , T(0IYE}d)@zjC,+ W<
IEqg<N"4IRaVVxl<&z#,L; ; httpd-2.4.64/docs/icons/pie1.gif 0000664 0001751 0001751 00000000306 10147723030 016206 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , E4X qfhBRG=gR{݂DpH۱|6)srTQ ; httpd-2.4.64/docs/icons/folder.gif 0000664 0001751 0001751 00000000341 10147723030 016622 0 ustar covener covener GIF89a ̙f3333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , T(0IYE}d)@zjC,+ W<
IEqg<N"4IRaVVxl<&z#,L; ; httpd-2.4.64/docs/icons/sphere2.gif 0000664 0001751 0001751 00000000410 10147723030 016714 0 ustar covener covener GIF89a 33f 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , {hp@&i;U"aRGm ru|O!@ |<hOI#6PiRv8>c*{G rp,@G|F {Bxyj:63#JH=/7@ ; httpd-2.4.64/docs/icons/c.gif 0000664 0001751 0001751 00000000362 10147723030 015574 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , e80 @#i;UEqeM#Wk `( t
(Q!uA!Jq9hRZ-fN0\ pt@7l+ ; httpd-2.4.64/docs/icons/tar.gif 0000664 0001751 0001751 00000000333 10147723030 016136 0 ustar covener covener GIF89a VVU777 !DThis icon is in the public domain. 1995 Kevin Hughes, kevinh@eit.com , `(0y;A|ș,#ж !FZ)Fb!FqN=
94ydԙ];䌛Uz<^L=u{4҄TM ; httpd-2.4.64/docs/icons/ps.gif 0000664 0001751 0001751 00000000364 10147723030 015776 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , g80 @#IjU hV&L wU'eH{ ;eAJ^X*zլrYDb8^7\( 7> F85 ; httpd-2.4.64/docs/icons/hand.up.gif 0000664 0001751 0001751 00000000337 10147723030 016711 0 ustar covener covener GIF89a ̙f3 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , R(0
B#cTH\m4Q꒑#Ź Էl#m_q )"O1 `lB)uƒxO ; httpd-2.4.64/docs/icons/screw1.gif 0000664 0001751 0001751 00000000402 10147723030 016551 0 ustar covener covener GIF89a ̙333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , u0BlhaB( ]@JTK/9?[\A@3$V( ؉rR!v`Uʩ3u|iVf*{ ǧ O~}(vp_?7 O ; httpd-2.4.64/docs/icons/portal.gif 0000664 0001751 0001751 00000000376 10147723030 016660 0 ustar covener covener GIF89a 3̙3333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , qhP@&i;U"rAeᾇ'eGy
npx|7B@x `H y %$\N\[
^2֦=[- oGzp7FF2|: ; httpd-2.4.64/docs/icons/left.gif 0000664 0001751 0001751 00000000254 10147723030 016304 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , + IXAo}N(JdDjh:)!yt]~ md ; httpd-2.4.64/docs/icons/pie5.gif 0000664 0001751 0001751 00000000275 10147723030 016217 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , <4X q(fHi.2^7r f<
-(t1 F ; httpd-2.4.64/docs/icons/folder.sec.png 0000664 0001751 0001751 00000000471 10664777241 017437 0 ustar covener covener PNG
IHDR 2o5 PLTE̙33f3f 333 SV< tRNS @* bKGD H ]IDATc0r 0HI,1TJ@L'%Uq EE
\Lt* D d1
n eiiiIJie ' ,<6 VtEXtcomment This art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995v IENDB` httpd-2.4.64/docs/icons/compressed.gif 0000664 0001751 0001751 00000002016 10147723030 017514 0 ustar covener covener GIF89a f3 ̙f3 f3 ffffff3f 3333f333 f 3 f3 ̙f3 ̙̙̙̙f̙3̙ ffffff3f 3333f333 f 3 ̙f3 ̙̙f3 ̙f3 ff̙ffff3f 33̙33f333 ̙ f 3 ffffff3f fff̙fff3f ffffff3f fffffffffff3ff f3f3f3f3ff33f3 f f f f ff 3f 3333f333 333̙3f333 3333f333 3f3f3f3ff3f33f 33333333f33333 3 3 3 3 f3 33 f 3 ̙ f 3 f 3 f f f ff f3 f 3 3 3 3f 33 3 f 3 w U D " w U D " w U D " ݻwwwUUUDDD""" !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! $ , I$`d CV
#lСĄ+Z(0cC 'NJI\G VbZi/aƤ@75ICϟF983O@lh%QV9L4jϩ^:
3؞K*gZ-mv}(ԧҔ%+2K$ ; httpd-2.4.64/docs/icons/quill.gif 0000664 0001751 0001751 00000000413 10147723030 016475 0 ustar covener covener GIF89a fff3333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , ~h0@&i;WGxp]BqHR/ !:,Cb V%H@ @d)6<1EY!~˺A = v,ipg Zp[ys" ; httpd-2.4.64/docs/icons/icon.sheet.gif 0000664 0001751 0001751 00000027311 10147723030 017414 0 ustar covener covener GIF89a ̙3ff33̙3f3f fffffff3f UUU333 3 f f3 3f !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , !dihlp,tmx|pH,Ȥrl:ШtJ6
ֹuu
_SX gyfpy.E]-:}vǾvk3dW@Ey$t^l|*j=z?(D8naZ{Lr`p~[rujpxµkeǙշlq͍¼~WѲ6{KУgʬS烙AyƐCs n"HFP-x#Cf(O_ ȥ1&"хhJ(62g J XC<iwu+s+Z^W mV<BtQ%᪪M;c @-{I7Z:CEF
(委3
d:~5-F2DbjK1
bڻalNLneNVN̵
T = .'ez|G3Dѫ_Ͼ˟OϿ (h& 6F(VhU nD ja bh" $D ~0X 4h#0Xc >xdM$M $L8ɣ?N Df7 9X% _}UfJXl"ᦚpxNPRbV|Y9mJ'rH8A>[(*a%=RڨT¨櫴fZ+}
)_U`[Ȗ" ʾ0'+-m2Ot"w A
nZImh7NEµ/ tꩿ|,P 0 L܂<
1
1o/ ~| 2<\F @˝_\@Q»-ˬ 30|&Z2jt bց%IonmQ_Lj,RK10(-wobymcل DvwuƆ`O 0Q۹n
]qt8xϮVC 9r{4ͺ/ӥw$gF촓8ƹ[OH??F\zң ^ɓ#}B!1Q:P_5Ip!͏Z NvQw` (,-jQ5lxw@E Xڋ4Psk &Є:ݝBU.T "
ز
QV@lEFIT"zg5)>[Y: 2ЊS|v0:S}A$gd`(GI Л %AQ#&Y.ND%MLke[z4IMF"xA!Ax"E Y̥.w^ 0IbL2f:Ќ4IjZ̦6nz 8IrL:v<Iz̧>@fu`X&&ӜJD3QdS"ꚇT/|e0j~ԡcюJQ:Y6 -2w((iT
t0O$@o5(q <X85HQbSoe; GS1K[S+m+H`u.Q `ڔլ+} R'}gW(c#XUDQ D֠j_.uOLQfJL^ĭ\YU2zeC*ܞԸdgU;6ue
iSԴ6n\Qu .`0ӭ3F16V+4yYXKXɅ{e7oH7/2
ާ'L
[ΰ7{ GL⍱hH:1~L rcɘJg̤ ݸ1 yM;2c%K蜑 )?2D̨ Nz/:IEiNTf6@5%ߌte,/.{nPlnW\(iLj#-Cy
34 -9kW,$pzFH&KTsȵkӳbK5fѴ 5xd^u]d etEVۺ4m8cn {P66IYjr 0b
o7n{f5de|6ϝnuBVTn n`fUy6AL=X45ЩDs 4qs n5x ' >BD1k ?y>ӛ=%_g#vN: Hft!ndUq75θ[;N:C])p[ y0@R t٪Gx}\/U^~YQ6纎E}z$`/6b9ɮz?[ҟ7~QOj=\ؿ<
{MmGc w+W(тML{z w/s#iCB&ss~Xc30kW*'wgV9EJp{p.C-ַ}1G=GkQĀivd0}`90{|sjJ/&xzAm3HJh5*W# "rIXFZ%\4: x'yVȄetUrisg"u]8Z7m( JtJz86mIx@z(c9J $}bKfKxDB`x+/"%8Xx؊8Xx؋8XxȘzOZpABPCYyF]8^sEdR$(Y-Qݘ/e CTU:gEVU xvST4%^
Muz7Ca6UU0 xK5c5T\ @Xe]5[ZZ0Z[ PV_e[uG Y!E 5,p 7)4)\-QHEQ=|>>'+]ۅ\t9V͵·XtZ\QuvRxQÕbv} Y#I_uU_[U鑱 qSV<P^K9fy]5Ә ^襚18h|)CaQ)
2`.% ؉9Yy虞깞.b#rb%NBvh@FY(|e[dNhKdFgeXfEu p
ꠝ6BuV &C Z,xQ6'?
Dv32 p8zV(3p#!JN^&{ckEAJ
3`ГP NZ6Tr?dضp\mHH#'vFY Lhn-wHp)n334X>fZZx_zEN<bHMpf ڨ 76ov.gQw"$W17s<u ` 2d50{owʨ:Q
,!F-!3-:zFd
Gڪ:QMzL3js*s.#=gdqDJz G r.i3?UX5;z+ Brj%
aS-jcxe`j2: 724GkW;Y0+-C +?Pz3:Z؉ ;9A-%ˉ\'+! <=ȂϚ:p
5D}I+: j v03+R+T4 F6p)ʵ`>~
m+8t{@Ȅ'w*+oȴwUK`lh4B]7s)}Kh[q[8[b*Z1|kiS6[%K
{Q汙< $wЉX6/ӋˋStJ_dʞ껾۾;[{ۿ <\|
XbYڈP T#5_@`vu#L TK(É Ux8 U P; Zw%UA >ii3 I\]Y
ŝyMl&U&HSUW5U1U0Ĥ~LY ^XX}嘉_|ls\SuY[TSlW@Tr%#E:ZUSuaɛ3YWjip ŕ,LU3 Y5ˀ\Y- ZA&E_9`Y\ʣUlʀ(̿%ּQ˘<ɽ|\9lZ z,P)]ERϾyƮyW y]\К1
- A=ϓPy_1\7CA = L7XK;* ,,0XjT3m䘝 @ B=D]F}HJ4bN?P?Y""/cGYK ` b=0Kߴa͜!a]m_-vMedhdn%reZv}s {
ءp F h"q}}ؽc،M:f ʲv"B؞
iϒӵ/ZLeُ'"J?0
{
jfiڵگMzҵMZC@
]nJ=-ܑG`Z`þb\ 6g=/0ꨃڬ=K;-oܓۈDSd -{ͬFݤJ42
nP* =-;[l3Z9 PذfBB^ bG=]+LN~EPGФ6^{qhCn{QNik>Em>B*CWMTkR_1&9n -1p~_8+X|Tƣ$1Qr[MK}h>GKZV jjqqCGN^mwJN >25^w2>cNuN.~Q=v{ΤJp7~~gM "#>. KX>9 .'^EZ>g9f ӻ$ !o~>!M35$RxDQx"IZ-Ã{u nJJ-"j
HLnp r?t_vxz|~ ?_?T& Ol} ;~ˤ__LPLë8(Ǡo?0L`Sk&i _xT)ė9WOuE)Fu~b<T*}ɽ ǬpPiH;u_Dn)e `lHngY(i3Mpr-(X7S*N
CRVg96Z3Ee⯰xMzs.%ؒܖ \ ]`"YUإb !%()YJפf*li*#\ .+[UV] rY,k4Pwxx/9wz::pf<=3>? H~2+!Ĉ'Rh"ƌ7r#Ȑ"G,i$ʔ*Wl%̘2gҬi&Μ:w'РB-j(R42mӨKJuJӤN6Ÿ+
fX ڴjVxV-\n,ݵvy^ 敋/}x"庒1C|#pn8pԪS83dˏ qtq=C 0o
]x 7 O`,}+ N/4ΙF| u gi7Ak$ l L`` *`yIȠDh]H!G;ه~ =BVB`X
>h`vbq t_(l
k:xGa圉 UVe 8NV hUfFRיe)kJ"l_lb^] Yo|z~-`t-
ۙi2m ʙ )W1Yy@R|bŧZ=٩z#> H"Ydw
g^XV-e
{aZ b$P
jj0X",(: }
3 VĂ6b71DuڨM"2 '| Dm \.
_9u2K r&2#l)>mվLyGP5_
"]r~cpjX${,$^L7tɡ.u^]_~{7ن*uGoM HCuJo4
j@z(]n >dK7+T\`K36zŷ;*G<ovV~=߳)Wo*_sO+'
{֮ 垿?gN2E q[g>9b $){
,
%^O<' Z|&$
?"FpnK@^q?B
#,J_|D%2w%[=HacX.,Qǘ9ұv# =~# )A<$"E2|$$#)IR$&3Mr$(C)Q<%*SU|%,c)YҲ%.s]Σr,0<(Ld &=90Nf)A0!%fCY x2ٸs$ǜɋkP FRqh'49uȆ7 j&m,>abBh0+рb,E K f(
qƀt;
Dl2Ja1OWjy3OoX
Wl q*Rk
1s:}jKͫ5 T|bU?*Tzu /]NSjղU rnJM4H[W ݫ%jf3e,8 {3?)늪գ,f%:ꂫ QT]-@Zc(}mkLN
]̒ڀ d4.KQzc!B&wеn;{]^r.x+=/zӫ}x ~_ǼI}L6ca<#6p} /8Qta
WQ8cq^f߉q7̥xr-V
t`jCe\
%6͐}Ci{ oMdyA7Fk99Y fAft`(J0OWr\ *@].< ||L a7βf4SyonH~3IqӏB-jQ33cYh:;ZV-MFO_9s6oggԢթ6}MҸX?|=Tq;Vfyw m]zݘ'iZƯl|{pVnu[{𦓼k=k &uLln;ߐ8 pt[nw?r:^1lQ 9~ncҦaPoO*7 sqXO fG rj9
n螓Ni<]W:< i4V 7qǙۓvY/%=3;Tt ]#V8n>)a< 599˕\jo+hx?xLIyӃ ~=c/Ӿ=s=/?>3>/Sֿ>{>ufq4ijO[_#D6'4gˋڢ|na? %W ]C`WZ]h=FAVD 4* -^fr'(d}
j}$l` z Im
&^ a`90J%V Q Jidݠ#!DS
Ug[9oQ.\a!U[i>PZ
&I%<!a AY9bi!a"i asa% bW9OAb/,b l!`hYkYU'm6:PV-b)>dkAB3" "f)Ve9!- u} 0.r V82ġHveV4Ɩ0:D袐}#88#99#::#; Xȗ[c;] >M#>nA飁Ouc<`d@@$? (
~ՆT%mؒWEBEjBVaFCjLȈMc) dFfPbCd%t-JE]xUXT&eP^KfVLƢKS ^VǍ^Ul @aDYy\qxWVM ȉ uȑq
`XR =eW^$fX`F ,։ Snf^%c6fH=KkO%ff
]
R Y]^h~Hf4^jz[Fl
$Aɩ٦ln m^ږpEޜmga8tb x5EکduJe$\i):őzN[%y6 z 9geB'J&!{',Iy6x j*VxgrܣEXP%%70`0 ~YhO ]tB
]vZgUKцr~gdKhI(gTϓy}2|أ( f~.%P5\b hzFhti{iZRfgޱ)qc\֩橌z\̚ھEs9 ⩉br(ih rzjYX@^ H`SjB(䅆F~#6>+FN+V^+fn+v~++++r!c z`;_&a o]!WC+1j1
]`Ńz2_0C&D8C@̉El2N. A.ઘBbi;~_J#
^l V̺+ʶ j`ϊ,-2&,aT/l2"~dl"Z?b8I-2]-ZyҲlqTVb Vm8
Vm#pJ}-,JC$86m2mU .6 nB`!V"b]IQ9mIS-J"2- ᚠN4OY6b!,>3/nV .-&g--6fTBkjC. BRb/rop9o..J :#I\I5INc/zQo1j,/ 0 p|a)<WTY?d ٧M#ГU0WFADvedPdۤ) ?X W
@jCvw(yY0pƃW a q qSk
IJdHN:$ȅԴ s1 :
@tc> Oުu!!grfÙ0 1W81? r {=2|\ K~&ejL +i X1p26 xrI
¦,fo>9dg,ђL r.n~bJ0 & m@++kZ15s3;+XJ:&GB6r%sjVxlv 3 3&ހ)DHt<F>>6 YY/#JuO$tꀙA#+燎^=t $EM>MPFs4?@(yl@Bt8s3"ТtntNkFwt~*&I7'T7Xks %5gU/U7&[DN
<
^Ku4W#]@tH@8u-ک(ڵ}XdE˨Pgs?w JP
u"4bb\t64\w6 ?65`(%6&+_̳s
dч
uBS1\cP}.7$)v*3T6r~WG`oQ.@t{puV;Zp@ (/
z{p]+p^綗yetE8)a6~?*kĵjKvkojur%vv[WeCK8 j ]8pgT餆x[x}P:"Oˌs xbCQx{7ڋ**Ҳ&!9)"O9W_9go9w9999yoբ84// N :aDV
*:% gbj.[,;}lтll V"vaUW%lz
m6N- "{v
!֖m+,!~: !䲕 _m?nn&n(($._-Sa#Kz){.8::'a:z6<TQýb1=Qo5\҂"V/n:
zW;켲|O4Zם3O<B9<=}*YŎCpZCFkǰ䧆?;O1#h kBQkhSZc 3q=BJK
aQګ=밽z۳w~=
?= Ŋ du rݽ "0C 䣓K>[>-y~}oF`g$A~۽~; ,1R5C[Es]5<_?`=d ' Y_GU>?Npkcw?KQ ?LEa扦V /L2zJ \*W|: ( xLM{T _{:| ][D1w6$$E%uv6I zGZJ*SRXt85 {{uV j\ [s{dH *9V|p Wl:=
(+qG"u'q`4}AV&By+7!ƌp8G~IJ* FMfj´3g:rwR_ț:gD)2 ^L 12 J,58DxܖψZ? Ti(,ɑ*@cߖ+*cׯ` /Jk l܈f28i_XY!ߙeBϟ7ЭiZ(ny kTRA?3W1;8
Wؽ̋ Jy WV; K#){wś?>ۻ?B ; httpd-2.4.64/docs/icons/alert.red.gif 0000664 0001751 0001751 00000000367 10147723030 017237 0 ustar covener covener GIF89a 33f 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , jhp@&i;WdB{^HaظjpnHP*V MW':Z+nek]G%1h~gNmg)c
P7AK ; httpd-2.4.64/docs/icons/pie7.gif 0000664 0001751 0001751 00000000271 10147723030 016215 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , 84X qxpzȶHBjx~<2~ ( ; httpd-2.4.64/docs/icons/movie.gif 0000664 0001751 0001751 00000000363 10147723030 016472 0 ustar covener covener GIF89a ̙fff333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , fh4%^; 1 .ch ^n^j&o\dh: `A3< "f|[zqU 6#xڣ֩" ; httpd-2.4.64/docs/icons/generic.red.gif 0000664 0001751 0001751 00000000334 10147723030 017536 0 ustar covener covener GIF89a fff 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , OHpA%7yB#)VKxn6쮞OL e<,1gJTc/ &cAfz
L ; httpd-2.4.64/docs/icons/continued.gif 0000664 0001751 0001751 00000000326 10147723030 017342 0 ustar covener covener GIF89a fff333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , I0IؕvJ!` ɉ *$;;ߧ0ȣi+
!pLH%8RjvAj3xL.+ ; httpd-2.4.64/docs/icons/ball.gray.gif 0000664 0001751 0001751 00000000351 10147723030 017223 0 ustar covener covener GIF89a ̻fffUUU333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , D0I8ͻI| a#WBa iV H|&"9
_NgI % &*T&xx, ; httpd-2.4.64/docs/icons/comp.blue.gif 0000664 0001751 0001751 00000000373 10147723030 017240 0 ustar covener covener GIF89a ffff333 f !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , n0x aX 7ka˺ٌ`QaH ϧ08IaaYW[UJWkVQ=`8 A. ϸyz.ri'ED ; httpd-2.4.64/docs/icons/script.gif 0000664 0001751 0001751 00000000362 10147723030 016656 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , e80 @#i;U"U0MTq;`( T(9LR{lz5
^j,Fp5
P;~3 C7sc ; httpd-2.4.64/docs/icons/world2.gif 0000664 0001751 0001751 00000000405 10147723030 016561 0 ustar covener covener GIF89a ̙ 3 f3 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , x&"8( 1bXWdׅ.zx7AiڰOaN 2:&|]C 0 wTr>xYq8Fn{=~q_K<4L#~x= ; httpd-2.4.64/docs/icons/box2.gif 0000664 0001751 0001751 00000000414 10147723030 016222 0 ustar covener covener GIF89a ̙333 3 f3 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , H0@$i;U"a ,14``H~`x8(|F˦U^
SDs(e]+m<=O~qzZ,d|=|`c{
KD1; ; httpd-2.4.64/docs/icons/image3.gif 0000664 0001751 0001751 00000000436 10147723030 016521 0 ustar covener covener GIF89a 33f 333 3 3f !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , yIXEvm^IYv*:vD,*DI/NnK 0ARFʤ#UAեr0dv* xZ0{fv*}stJQP>HS ; httpd-2.4.64/docs/icons/alert.black.gif 0000664 0001751 0001751 00000000362 10147723030 017534 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , e80 @#i;W$֕xB.Qת5e>PHQfaQv5Aݒ\̴2`Iutz08<< ; httpd-2.4.64/docs/icons/uuencoded.gif 0000664 0001751 0001751 00000000354 10147723030 017326 0 ustar covener covener GIF89a 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , _80 @#)0bAfhQ#Go@W5k((vxH<Ħ8:i:NUo 1k^^;. |qy ; httpd-2.4.64/docs/icons/folder.sec.gif 0000664 0001751 0001751 00000000363 10147723030 017377 0 ustar covener covener GIF89a ̙33f3f 333 !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , f80Iٹ
P A ;pD ,3.CpLd7E0hsJYS4Fk~n^4o|~f?Z+~ ; httpd-2.4.64/docs/icons/pie0.gif 0000664 0001751 0001751 00000000274 10147723030 016211 0 ustar covener covener GIF89a !NThis art is in the public domain. Kevin Hughes, kevinh@eit.com, September 1995 ! , ;4Xַ